包名 @sfmc-bds/sdk。本文是用法导读；完整签名见 SDK 类型参考（pnpm run docs -- api / npm run docs -- api）。
| 抽屉 | 导入 | 导读 |
|---|---|---|
| runtime | @sfmc-bds/sdk/sapi/runtime |
runtime |
| db | @sfmc-bds/sdk/sapi/db |
db |
| config | @sfmc-bds/sdk/sapi/config |
config |
| service | @sfmc-bds/sdk/sapi/service |
service |
import { ModuleRegistry } from "@sfmc-bds/sdk/module-loader";模块作者以 Watch / 真机联调 为主；本地可做 typecheck、lint 与 manifest 静态检查。见 开发指南 · 测试。
模块业务一般不直接 import：
| 路径 | 用途 |
|---|---|
@sfmc-bds/sdk/module-loader |
ModuleRegistry、ConfigManager |
@sfmc-bds/sdk/module-loader/install |
installHostBootstrap（仅 BP 启动） |
@sfmc-bds/sdk/sapi/host |
平台 host 适配 |
@sfmc-bds/sdk/contracts |
catalog / lock 类型 |
@sfmc-bds/sdk/node/config |
Node 侧读 configs |
@sfmc-bds/sdk/node/sdk |
Node 服务能力 |
@sfmc-bds/sdk/logs |
日志 |
- 只走 SDK / 对方 typed client，不直连 db-server
- 不手写 SQL；用
WhereExpr - 不 import 其它模块源码；跨模块用 service / client
- 业务类型放在模块包内；
contracts仅平台 catalog/lock