@sfmc-bds/cli 0.1.0 → 0.2.0-beta.0

package/dist/pack-lifecycle.d.ts

@@ -0,0 +1,95 @@
+/**
+ * pack-lifecycle.ts — 行为包/资源包装载生命周期
+ *
+ * 职责:
+ *   - 计算本机 desired deploy-catalog(启用模块 + fingerprint)
+ *   - 与世界 BP 内 sfmc-deploy-catalog.json 比对
+ *   - 不一致则整包 build + deploy + 写世界清单 + Script API permission
+ *   - 启动前 ensurePacksReady;日志一律走 source=`pack`
+ */
+import { type CliResult } from "./cli-result.js";
+export declare const BP_NAME = "sfmc-modules";
+export declare const RP_NAME = "sfmc-modules-rp";
+export declare const DEPLOY_CATALOG_NAME = "sfmc-deploy-catalog.json";
+export declare const DEFAULT_PACK_VERSION: [number, number, number];
+export declare function buildRoot(): string;
+export declare function bpSrc(): string;
+export declare function bpOut(): string;
+export declare function rpOut(): string;
+export interface DeployCatalogModule {
+    logicalId: string;
+    enabled: boolean;
+    version: string;
+    fingerprint: string;
+    hasResourcePack: boolean;
+}
+export interface DeployCatalog {
+    schemaVersion: 1;
+    bpUuid: string;
+    rpUuid: string | null;
+    bpVersion: [number, number, number];
+    rpVersion: [number, number, number] | null;
+    bpModuleUuid?: string;
+    rpModuleUuid?: string;
+    generatedAt: number;
+    modules: Record<string, DeployCatalogModule>;
+}
+export interface PackEnsureResult {
+    rebuilt: boolean;
+    skipped: boolean;
+    catalog: DeployCatalog;
+    bdsRoot: string;
+    levelName: string;
+    summary: string;
+}
+/** 读 BDS 路径与 level-name（level 权威：pack-manager-lib.readLevelNameSync，DIP） */
+export declare function resolveBdsContext(): {
+    bdsRoot: string;
+    levelName: string;
+};
+export declare function deployedBpDir(bdsRoot: string, levelName: string): string;
+export declare function deployedRpDir(bdsRoot: string, levelName: string): string;
+export declare function deployedCatalogPath(bdsRoot: string, levelName: string): string;
+/**
+ * 枚举本机 packages,返回 folderId → 元数据。
+ * 仅含有 sapi/src/index.ts 的模块会进入 BP bundle 候选。
+ */
+export declare function scanLocalModules(): Promise<Array<{
+    folderId: string;
+    logicalId: string;
+    version: string;
+    enabled: boolean;
+    hasSapi: boolean;
+    hasResourcePack: boolean;
+    fingerprint: string;
+    entryPath: string | null;
+}>>;
+/** 从本机状态 + 已有 UUID 合成 desired catalog。
+ * UUID 优先:deployed catalog → 本地 build manifest → 新建随机。
+ */
+export declare function computeDesiredCatalog(opts?: {
+    bpUuid?: string;
+    rpUuid?: string | null;
+    bpVersion?: [number, number, number];
+    rpVersion?: [number, number, number] | null;
+    bpModuleUuid?: string;
+    rpModuleUuid?: string;
+}): Promise<DeployCatalog>;
+export declare function readDeployedCatalog(bdsRoot: string, levelName: string): DeployCatalog | null;
+/** 比较键:模块集合 + enabled/version/fingerprint/hasRP + bp/rp uuid */
+export declare function catalogsEqual(a: DeployCatalog, b: DeployCatalog): boolean;
+/** esbuild 聚合启用模块 → assemble BP + RP(若有) */
+export declare function buildPacks(desired?: DeployCatalog): Promise<DeployCatalog>;
+/** 部署到世界 + enable 清单 + Script API permission */
+export declare function deployPacks(catalog: DeployCatalog): Promise<void>;
+export declare function formatPackLoadInfo(catalog: DeployCatalog, rebuilt: boolean): string;
+/**
+ * BDS 启动前闸门:catalog 不一致则整包重编部署;失败抛错,禁止启动。
+ */
+export declare function ensurePacksReady(): Promise<PackEnsureResult>;
+export declare function cmdPackBuild(_args: string[]): Promise<CliResult>;
+export declare function cmdPackDeploy(_args: string[]): Promise<CliResult>;
+export declare function cmdPackStatus(_args: string[]): Promise<string>;
+export declare function cmdPackList(_args: string[]): Promise<string>;
+export declare function cmdPackEnableDisable(action: "enable" | "disable", args: string[]): Promise<string>;
+//# sourceMappingURL=pack-lifecycle.d.ts.map

package/dist/pack-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-lifecycle.d.ts","sourceRoot":"","sources":["../src/pack-lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgBH,OAAO,EAAwB,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAqBvE,eAAO,MAAM,OAAO,iBAAiB,CAAC;AACtC,eAAO,MAAM,OAAO,oBAAoB,CAAC;AACzC,eAAO,MAAM,mBAAmB,6BAA6B,CAAC;AAC9D,eAAO,MAAM,oBAAoB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAa,CAAC;AAyCxE,wBAAgB,SAAS,IAAI,MAAM,CAGlC;AACD,wBAAgB,KAAK,IAAI,MAAM,CAE9B;AACD,wBAAgB,KAAK,IAAI,MAAM,CAE9B;AACD,wBAAgB,KAAK,IAAI,MAAM,CAE9B;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,CAAC,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AA0BD,4EAA4E;AAC5E,wBAAgB,iBAAiB,IAAI;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAO1E;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE9E;AA6BD;;;GAGG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAC/C,KAAK,CAAC;IACJ,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC,CACH,CA8DA;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,CAAC,EAAE;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,aAAa,CAAC,CAyCzB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAQ5F;AAED,gEAAgE;AAChE,wBAAgB,aAAa,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,aAAa,GAAG,OAAO,CAwBzE;AAOD,4CAA4C;AAC5C,wBAAsB,UAAU,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CA2FhF;AAED,gDAAgD;AAChD,wBAAsB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAiGvE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAmBnF;AAoBD;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CA+DlE;AAID,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAQtE;AAED,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAevE;AAED,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAiCpE;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAwBlE;AAED,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA0BxG"}