sf-plugin-cms 0.2.0 → 0.3.0

package/lib/commands/cms/import/workspace.js

@@ -1,17 +1,24 @@
 import { Flags } from '@salesforce/sf-plugins-core';
+import { assertWorkspaceImportResult, WORKSPACE_IMPORT_CONTRACT, } from '../../../contracts/workspace-import.js';
+import { assertCmsEnvelope, sanitizeDiagnostics, } from '../../../contracts/shared.js';
 import { executeWorkspaceImport, loadWorkspaceExport, } from '../../../services/import-workspace.js';
 import { assertWorkspaceSelector, resolveWorkspace } from '../../../services/resolve-workspace.js';
-import { apiVersionFlag, CmsCommand, targetOrgFlag } from '../command-base.js';
+import { apiVersionFlag, CmsCommand, targetOrgFlag } from '../../../command-base.js';
 export default class ImportWorkspace extends CmsCommand {
     static summary = 'Safely plan or apply a create-only import into a CMS workspace.';
     static description = 'Validates the source workspace export locally before any org request, selects one destination workspace by exact ID or exact case-sensitive name, checks every content key for conflicts, and defaults to a non-mutating dry run. Pass --apply with a new --report-dir to create content.';
     static examples = [
         '<%= config.bin %> cms import workspace --target-org my-org --workspace-name "Destination" --source-dir ./cms/Source',
-        '<%= config.bin %> cms import workspace --target-org my-org --workspace-id 0Zu... --source-dir ./cms/Source --apply --report-dir ./cms-import-report',
+        '<%= config.bin %> cms import workspace --target-org my-org --workspace-id 0Zu... --source-dir ./cms/Source --apply --report-dir ./cms-import-report --contract-version 1 --json',
     ];
     static flags = {
         'target-org': targetOrgFlag,
         'api-version': apiVersionFlag,
+        'contract-version': Flags.integer({
+            default: 1,
+            min: 1,
+            summary: 'Machine contract major version (supported: 1).',
+        }),
         'workspace-id': Flags.string({ summary: 'Exact destination CMS workspace ID.' }),
         'workspace-name': Flags.string({ summary: 'Exact case-sensitive destination workspace name.' }),
         'source-dir': Flags.directory({
@@ -35,49 +42,128 @@ export default class ImportWorkspace extends CmsCommand {
     };
     async run() {
         const { flags } = await this.parse(ImportWorkspace);
+        const requestedVersion = flags['contract-version'] ?? 1;
+        if (requestedVersion !== 1) {
+            return this.finish(envelope('blocked', flags['api-version'], 'unresolved-org', null, [
+                {
+                    code: 'UNSUPPORTED_CONTRACT_VERSION',
+                    message: `Contract major ${requestedVersion} is unsupported; supported major is 1.`,
+                    retryable: false,
+                },
+            ]));
+        }
         if (flags.apply && flags['report-dir'] === undefined) {
-            throw new Error('--report-dir is required when --apply is set.');
+            return this.finish(envelope('blocked', flags['api-version'], 'unresolved-org', null, [
+                {
+                    code: 'REPORT_DIRECTORY_REQUIRED',
+                    message: '--report-dir is required when --apply is set.',
+                    retryable: false,
+                },
+            ]));
+        }
+        let source;
+        try {
+            source = await loadWorkspaceExport(flags['source-dir'], {
+                allowPartial: flags['allow-partial'],
+            });
+            assertWorkspaceSelector({
+                workspaceId: flags['workspace-id'],
+                workspaceName: flags['workspace-name'],
+            });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            const packageVersionFailure = /manifest contract\/version is unsupported|schemaVersion\/mode is unsupported/u.test(message);
+            return this.finish(envelope('blocked', flags['api-version'], 'unresolved-org', null, [
+                {
+                    code: packageVersionFailure
+                        ? 'UNSUPPORTED_PACKAGE_VERSION'
+                        : 'PACKAGE_VALIDATION_FAILED',
+                    message,
+                    retryable: false,
+                },
+            ]));
         }
-        // Reject malformed, unsafe, or disallowed partial packages before contacting the org.
-        await loadWorkspaceExport(flags['source-dir'], { allowPartial: flags['allow-partial'] });
-        const selector = {
-            workspaceId: flags['workspace-id'],
-            workspaceName: flags['workspace-name'],
-        };
-        assertWorkspaceSelector(selector);
         const { connection, orgId } = await this.getOrgContext(flags['target-org'], flags['api-version']);
-        const selected = await resolveWorkspace(connection, selector);
-        const result = await executeWorkspaceImport({
-            allowPartial: flags['allow-partial'],
-            connection,
-            destinationOrgId: orgId,
-            destinationWorkspace: selected.workspace,
-            dryRun: !flags.apply,
-            reportDirectory: flags['report-dir'],
-            sourceDirectory: flags['source-dir'],
-            workspaceId: selected.id,
-        });
-        if (!this.jsonEnabled())
-            this.showPlan(result);
+        try {
+            const selected = await resolveWorkspace(connection, {
+                workspaceId: flags['workspace-id'],
+                workspaceName: flags['workspace-name'],
+            });
+            const execution = await executeWorkspaceImport({
+                allowPartial: flags['allow-partial'],
+                connection,
+                destinationOrgId: orgId,
+                destinationWorkspace: selected.workspace,
+                dryRun: !flags.apply,
+                loadedSource: source,
+                reportDirectory: flags['report-dir'],
+                sourceDirectory: flags['source-dir'],
+                workspaceId: selected.id,
+            });
+            const status = source.isPartial ? 'partial' : 'success';
+            const result = envelope(status, flags['api-version'], orgId, execution.contractResult, []);
+            if (!this.jsonEnabled())
+                this.showPlan(execution, result);
+            return this.finish(result);
+        }
+        catch (error) {
+            return this.finish(envelope('failed', flags['api-version'], orgId, null, [
+                {
+                    code: 'IMPORT_FAILED',
+                    message: error instanceof Error ? error.message : String(error),
+                    retryable: false,
+                },
+            ]));
+        }
+    }
+    finish(result) {
+        assertCmsEnvelope(result, assertWorkspaceImportResult);
+        if (result.status === 'success')
+            process.exitCode = 0;
+        else if (result.status === 'partial')
+            process.exitCode = 2;
+        else
+            process.exitCode = 1;
         return result;
     }
-    showPlan(result) {
-        const primaryCount = result.plan.groups.length;
-        const variantCount = result.plan.groups.reduce((count, group) => count + group.variants.length, 0);
-        this.log(`Mode: ${result.dryRun ? 'dry-run (no mutations)' : 'apply (create-only)'}`);
-        this.log(`Destination workspace: ${result.plan.destinationWorkspaceId}`);
-        this.log(`Destination root folder: ${result.plan.rootFolderId}`);
+    showPlan(execution, envelopeResult) {
+        const primaryCount = execution.plan.groups.length;
+        const variantCount = execution.plan.groups.reduce((count, group) => count + group.variants.length, 0);
+        this.log(`Status: ${envelopeResult.status}`);
+        this.log(`Mode: ${execution.dryRun ? 'dry-run (no mutations)' : 'apply (create-only)'}`);
+        this.log(`Destination workspace: ${execution.plan.destinationWorkspaceId}`);
+        this.log(`Destination root folder: ${execution.plan.rootFolderId}`);
         this.log(`Planned new content: ${primaryCount} parent(s), ${variantCount} child variant(s)`);
-        for (const group of result.plan.groups) {
-            const childLanguages = group.variants.map(({ language }) => language).join(', ') || 'none';
-            this.log(`- ${group.contentKey}: primary ${group.primary.language}; child languages ${childLanguages}`);
-        }
-        if (result.dryRun) {
+        this.log(`Resolved mappings: ${execution.contractResult.mappings.length}`);
+        this.log(`Explicit unresolved/unsupported references: ${execution.contractResult.references.length}`);
+        if (execution.dryRun) {
             this.log('No content was created. Re-run with --apply and a new --report-dir to mutate.');
         }
         else {
-            this.log(`Run report: ${result.reportFile ?? ''}`);
+            this.log(`Run report: ${execution.reportFile ?? ''}`);
         }
     }
 }
+function envelope(status, apiVersion, orgId, result, errors) {
+    return {
+        contract: WORKSPACE_IMPORT_CONTRACT,
+        contractVersion: '1.0.0',
+        status,
+        metadata: {
+            operation: 'workspace.import',
+            plugin: { name: 'sf-plugin-cms', version: '0.3.0' },
+            apiVersion,
+        },
+        diagnostics: { warnings: [], errors: sanitizeDiagnostics(errors, 'diagnostics.errors') },
+        provenance: {
+            producer: 'sf-plugin-cms',
+            sourceOrgId: orgId,
+            pluginVersion: '0.3.0',
+            command: 'sf cms import workspace',
+            generatedAt: new Date().toISOString(),
+        },
+        result,
+    };
+}
 //# sourceMappingURL=workspace.js.map

package/lib/commands/cms/import/workspace.js.map

@@ -1 +1 @@
-{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../../../src/commands/cms/import/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACpD,OAAO,EACL,sBAAsB,EACtB,mBAAmB,GAEpB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AACnG,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAE/E,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,UAAiC;IACrE,MAAM,CAAU,OAAO,GAC5B,iEAAiE,CAAC;IAC7D,MAAM,CAAU,WAAW,GAChC,2RAA2R,CAAC;IACvR,MAAM,CAAU,QAAQ,GAAG;QAChC,qHAAqH;QACrH,qJAAqJ;KACtJ,CAAC;IACK,MAAM,CAAU,KAAK,GAAG;QAC7B,YAAY,EAAE,aAAa;QAC3B,aAAa,EAAE,cAAc;QAC7B,cAAc,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC;QAChF,gBAAgB,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,kDAAkD,EAAE,CAAC;QAC/F,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC;YAC5B,MAAM,EAAE,IAAI;YACZ,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,8DAA8D;SACxE,CAAC;QACF,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;YACnB,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,2EAA2E;SACrF,CAAC;QACF,eAAe,EAAE,KAAK,CAAC,OAAO,CAAC;YAC7B,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,2EAA2E;SACrF,CAAC;QACF,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC;YAC5B,SAAS,EAAE,CAAC,OAAO,CAAC;YACpB,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,0DAA0D;SACpE,CAAC;KACH,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QACpD,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,YAAY,CAAC,KAAK,SAAS,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACnE,CAAC;QAED,sFAAsF;QACtF,MAAM,mBAAmB,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,EAAE,YAAY,EAAE,KAAK,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;QACzF,MAAM,QAAQ,GAAG;YACf,WAAW,EAAE,KAAK,CAAC,cAAc,CAAC;YAClC,aAAa,EAAE,KAAK,CAAC,gBAAgB,CAAC;SACvC,CAAC;QACF,uBAAuB,CAAC,QAAQ,CAAC,CAAC;QAElC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,aAAa,CACpD,KAAK,CAAC,YAAY,CAAC,EACnB,KAAK,CAAC,aAAa,CAAC,CACrB,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC;YAC1C,YAAY,EAAE,KAAK,CAAC,eAAe,CAAC;YACpC,UAAU;YACV,gBAAgB,EAAE,KAAK;YACvB,oBAAoB,EAAE,QAAQ,CAAC,SAAS;YACxC,MAAM,EAAE,CAAC,KAAK,CAAC,KAAK;YACpB,eAAe,EAAE,KAAK,CAAC,YAAY,CAAC;YACpC,eAAe,EAAE,KAAK,CAAC,YAAY,CAAC;YACpC,WAAW,EAAE,QAAQ,CAAC,EAAE;SACzB,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;YAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC/C,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,QAAQ,CAAC,MAA6B;QAC5C,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;QAC/C,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAC5C,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,EAC/C,CAAC,CACF,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,qBAAqB,EAAE,CAAC,CAAC;QACtF,IAAI,CAAC,GAAG,CAAC,0BAA0B,MAAM,CAAC,IAAI,CAAC,sBAAsB,EAAE,CAAC,CAAC;QACzE,IAAI,CAAC,GAAG,CAAC,4BAA4B,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QACjE,IAAI,CAAC,GAAG,CAAC,wBAAwB,YAAY,eAAe,YAAY,mBAAmB,CAAC,CAAC;QAC7F,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACvC,MAAM,cAAc,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC;YAC3F,IAAI,CAAC,GAAG,CACN,KAAK,KAAK,CAAC,UAAU,aAAa,KAAK,CAAC,OAAO,CAAC,QAAQ,qBAAqB,cAAc,EAAE,CAC9F,CAAC;QACJ,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,IAAI,CAAC,GAAG,CAAC,+EAA+E,CAAC,CAAC;QAC5F,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC,CAAC;QACrD,CAAC;IACH,CAAC"}
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../../../src/commands/cms/import/workspace.ts"],"names":[],"mappings":"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"}

package/lib/commands/cms/info.d.ts

@@ -1,12 +1,13 @@
-import { SfCommand } from '@salesforce/sf-plugins-core';
-export type InfoResult = {
-    name: string;
-    status: 'scaffold';
-};
-/** Reports that the CMS plugin scaffold is installed. */
-export default class Info extends SfCommand<InfoResult> {
-    static readonly summary = "Show CMS plugin scaffold information.";
-    static readonly description = "Confirms that the sf-plugin-cms command entrypoint can be loaded without making org calls.";
+import { type CmsInfoResult } from '../../contracts/info.js';
+import { type CmsEnvelope } from '../../contracts/shared.js';
+import { CmsCommand } from '../../command-base.js';
+/** Reports the offline CMS CLI contract and capability envelope. */
+export default class Info extends CmsCommand<CmsEnvelope<CmsInfoResult>> {
+    static readonly summary = "Show offline CMS contract and capability information.";
+    static readonly description = "Reports the versioned CLI JSON contracts, package compatibility, tested API baseline, and truthfully evidenced CMS capabilities without contacting an org.";
     static readonly examples: string[];
-    run(): Promise<InfoResult>;
+    static readonly flags: {
+        'contract-version': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<CmsEnvelope<CmsInfoResult>>;
 }

package/lib/commands/cms/info.js

@@ -1,13 +1,128 @@
-import { SfCommand } from '@salesforce/sf-plugins-core';
-/** Reports that the CMS plugin scaffold is installed. */
-export default class Info extends SfCommand {
-    static summary = 'Show CMS plugin scaffold information.';
-    static description = 'Confirms that the sf-plugin-cms command entrypoint can be loaded without making org calls.';
-    static examples = ['<%= config.bin %> cms info'];
+import { Flags } from '@salesforce/sf-plugins-core';
+import { assertCmsInfoResult, CMS_INFO_CONTRACT, } from '../../contracts/info.js';
+import { assertCmsEnvelope } from '../../contracts/shared.js';
+import { CmsCommand } from '../../command-base.js';
+const PLUGIN_VERSION = '0.3.0';
+/** Reports the offline CMS CLI contract and capability envelope. */
+export default class Info extends CmsCommand {
+    static summary = 'Show offline CMS contract and capability information.';
+    static description = 'Reports the versioned CLI JSON contracts, package compatibility, tested API baseline, and truthfully evidenced CMS capabilities without contacting an org.';
+    static examples = [
+        '<%= config.bin %> cms info',
+        '<%= config.bin %> cms info --json',
+        '<%= config.bin %> cms info --contract-version 1 --json',
+    ];
+    static flags = {
+        'contract-version': Flags.integer({
+            default: 1,
+            min: 1,
+            summary: 'Machine contract major version (supported: 1).',
+        }),
+    };
     async run() {
-        const result = { name: 'sf-plugin-cms', status: 'scaffold' };
-        this.logJson(result);
+        const { flags } = await this.parse(Info);
+        const requestedVersion = flags['contract-version'] ?? 1;
+        const result = requestedVersion === 1 ? successEnvelope() : blockedEnvelope(requestedVersion);
+        assertCmsEnvelope(result, assertCmsInfoResult);
+        if (!this.jsonEnabled())
+            this.styledJSON(result);
+        process.exitCode = result.status === 'success' ? 0 : 1;
         return result;
     }
 }
+function successEnvelope() {
+    return {
+        contract: CMS_INFO_CONTRACT,
+        contractVersion: '1.0.0',
+        status: 'success',
+        metadata: {
+            operation: 'cms.info',
+            plugin: { name: 'sf-plugin-cms', version: PLUGIN_VERSION },
+            apiVersion: null,
+        },
+        diagnostics: { warnings: [], errors: [] },
+        provenance: {
+            producer: 'sf-plugin-cms',
+            sourceOrgId: 'offline',
+            pluginVersion: PLUGIN_VERSION,
+            command: 'sf cms info',
+            generatedAt: new Date().toISOString(),
+        },
+        result: {
+            plugin: { name: 'sf-plugin-cms', version: PLUGIN_VERSION },
+            api: { defaultVersion: '67.0', testedVersions: ['67.0'] },
+            contracts: {
+                commandResults: {
+                    info: ['1.0.0'],
+                    workspaceExportSet: ['1.0.0'],
+                    workspaceImport: ['1.0.0'],
+                },
+                packageManifests: { workspaceExport: ['1.0.0'] },
+                embeddedResults: {
+                    externalReferenceCorrelations: ['sf-cms-external-reference-correlations@1'],
+                },
+                compatibility: {
+                    'workspaceExportSet@1': { workspaceExportManifestMajors: [1] },
+                    'workspaceImport@1': { workspaceExportManifestMajors: [1] },
+                },
+            },
+            capabilities: [
+                {
+                    id: 'workspace.export.bulk',
+                    state: 'implemented',
+                    transport: 'cli-json',
+                    contract: 'sf-cms-workspace-export-set@1',
+                },
+                {
+                    id: 'workspace.export.dependency-closure',
+                    state: 'unavailable',
+                    transport: 'cli-json',
+                    contract: 'unavailable',
+                },
+                {
+                    id: 'workspace.export.external-reference-correlation',
+                    state: 'experimental',
+                    transport: 'cli-json',
+                    contract: 'sf-cms-external-reference-correlations@1',
+                },
+                {
+                    id: 'workspace.import.mapping',
+                    state: 'experimental',
+                    transport: 'cli-json',
+                    contract: 'sf-cms-workspace-import@1',
+                },
+            ],
+        },
+    };
+}
+function blockedEnvelope(requestedVersion) {
+    return {
+        contract: CMS_INFO_CONTRACT,
+        contractVersion: '1.0.0',
+        status: 'blocked',
+        metadata: {
+            operation: 'cms.info',
+            plugin: { name: 'sf-plugin-cms', version: PLUGIN_VERSION },
+            apiVersion: null,
+        },
+        diagnostics: {
+            warnings: [],
+            errors: [
+                {
+                    code: 'UNSUPPORTED_CONTRACT_VERSION',
+                    message: `Contract major ${requestedVersion} is unsupported; supported major is 1.`,
+                    retryable: false,
+                },
+            ],
+        },
+        provenance: {
+            producer: 'sf-plugin-cms',
+            sourceOrgId: 'offline',
+            pluginVersion: PLUGIN_VERSION,
+            command: 'sf cms info',
+            generatedAt: new Date().toISOString(),
+        },
+        result: null,
+    };
+}
 //# sourceMappingURL=info.js.map

package/lib/commands/cms/info.js.map

@@ -1 +1 @@
-{"version":3,"file":"info.js","sourceRoot":"","sources":["../../../src/commands/cms/info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAOxD,yDAAyD;AACzD,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,SAAqB;IAC9C,MAAM,CAAU,OAAO,GAAG,uCAAuC,CAAC;IAClE,MAAM,CAAU,WAAW,GAChC,4FAA4F,CAAC;IACxF,MAAM,CAAU,QAAQ,GAAG,CAAC,4BAA4B,CAAC,CAAC;IAE1D,KAAK,CAAC,GAAG;QACd,MAAM,MAAM,GAAe,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QACzE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACrB,OAAO,MAAM,CAAC;IAChB,CAAC"}
+{"version":3,"file":"info.js","sourceRoot":"","sources":["../../../src/commands/cms/info.ts"],"names":[],"mappings":"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"}

package/lib/commands/cms/list/channel.d.ts

@@ -1,5 +1,5 @@
 import { type CmsPage } from '../../../services/read.js';
-import { CmsCommand } from '../command-base.js';
+import { CmsCommand } from '../../../command-base.js';
 export default class ListChannel extends CmsCommand<CmsPage> {
     static readonly summary = "List channels assigned to a CMS workspace.";
     static readonly description = "Retrieves one page of channels for an explicit workspace.";

package/lib/commands/cms/list/channel.js

@@ -1,6 +1,6 @@
 import { Flags } from '@salesforce/sf-plugins-core';
 import { listWorkspaceChannels } from '../../../services/read.js';
-import { apiVersionFlag, CmsCommand, pageFlag, pageSizeFlag, targetOrgFlag, } from '../command-base.js';
+import { apiVersionFlag, CmsCommand, pageFlag, pageSizeFlag, targetOrgFlag, } from '../../../command-base.js';
 export default class ListChannel extends CmsCommand {
     static summary = 'List channels assigned to a CMS workspace.';
     static description = 'Retrieves one page of channels for an explicit workspace.';

package/lib/commands/cms/list/channel.js.map

@@ -1 +1 @@
-{"version":3,"file":"channel.js","sourceRoot":"","sources":["../../../../src/commands/cms/list/channel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAgB,MAAM,2BAA2B,CAAC;AAChF,OAAO,EACL,cAAc,EACd,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,aAAa,GACd,MAAM,oBAAoB,CAAC;AAE5B,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,UAAmB;IACnD,MAAM,CAAU,OAAO,GAAG,4CAA4C,CAAC;IACvE,MAAM,CAAU,WAAW,GAAG,2DAA2D,CAAC;IAC1F,MAAM,CAAU,QAAQ,GAAG;QAChC,8EAA8E;KAC/E,CAAC;IACK,MAAM,CAAU,KAAK,GAAG;QAC7B,YAAY,EAAE,aAAa;QAC3B,aAAa,EAAE,cAAc;QAC7B,cAAc,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;QAC5F,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,YAAY;KAC1B,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAChD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;QACvF,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,UAAU,EAAE,KAAK,CAAC,cAAc,CAAC,EAAE;YAC5E,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC;SAC7B,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QACtC,OAAO,MAAM,CAAC;IAChB,CAAC"}
+{"version":3,"file":"channel.js","sourceRoot":"","sources":["../../../../src/commands/cms/list/channel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAgB,MAAM,2BAA2B,CAAC;AAChF,OAAO,EACL,cAAc,EACd,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,aAAa,GACd,MAAM,0BAA0B,CAAC;AAElC,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,UAAmB;IACnD,MAAM,CAAU,OAAO,GAAG,4CAA4C,CAAC;IACvE,MAAM,CAAU,WAAW,GAAG,2DAA2D,CAAC;IAC1F,MAAM,CAAU,QAAQ,GAAG;QAChC,8EAA8E;KAC/E,CAAC;IACK,MAAM,CAAU,KAAK,GAAG;QAC7B,YAAY,EAAE,aAAa;QAC3B,aAAa,EAAE,cAAc;QAC7B,cAAc,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;QAC5F,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,YAAY;KAC1B,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAChD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;QACvF,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,UAAU,EAAE,KAAK,CAAC,cAAc,CAAC,EAAE;YAC5E,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC;SAC7B,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QACtC,OAAO,MAAM,CAAC;IAChB,CAAC"}

package/lib/commands/cms/list/workspace.d.ts

@@ -1,5 +1,5 @@
 import { type CmsPage } from '../../../services/read.js';
-import { CmsCommand } from '../command-base.js';
+import { CmsCommand } from '../../../command-base.js';
 export default class ListWorkspace extends CmsCommand<CmsPage> {
     static readonly summary = "List Marketing Cloud CMS workspaces.";
     static readonly description = "Lists one bounded page of CMS workspaces through the authenticated Salesforce connection.";

package/lib/commands/cms/list/workspace.js

@@ -1,6 +1,6 @@
 import { Flags } from '@salesforce/sf-plugins-core';
 import { listWorkspaces } from '../../../services/read.js';
-import { apiVersionFlag, CmsCommand, pageFlag, pageSizeFlag, targetOrgFlag, } from '../command-base.js';
+import { apiVersionFlag, CmsCommand, pageFlag, pageSizeFlag, targetOrgFlag, } from '../../../command-base.js';
 export default class ListWorkspace extends CmsCommand {
     static summary = 'List Marketing Cloud CMS workspaces.';
     static description = 'Lists one bounded page of CMS workspaces through the authenticated Salesforce connection.';

package/lib/commands/cms/list/workspace.js.map

@@ -1 +1 @@
-{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../../../src/commands/cms/list/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACpD,OAAO,EAAE,cAAc,EAAgB,MAAM,2BAA2B,CAAC;AACzE,OAAO,EACL,cAAc,EACd,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,aAAa,GACd,MAAM,oBAAoB,CAAC;AAE5B,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,UAAmB;IACrD,MAAM,CAAU,OAAO,GAAG,sCAAsC,CAAC;IACjE,MAAM,CAAU,WAAW,GAChC,2FAA2F,CAAC;IACvF,MAAM,CAAU,QAAQ,GAAG,CAAC,0DAA0D,CAAC,CAAC;IACxF,MAAM,CAAU,KAAK,GAAG;QAC7B,YAAY,EAAE,aAAa;QAC3B,aAAa,EAAE,cAAc;QAC7B,eAAe,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,mDAAmD,EAAE,CAAC;QAC/F,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,YAAY;KAC1B,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAClD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;QACvF,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,UAAU,EAAE;YAC9C,YAAY,EAAE,KAAK,CAAC,eAAe,CAAC;YACpC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC;SAC7B,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;QACxC,OAAO,MAAM,CAAC;IAChB,CAAC"}
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../../../src/commands/cms/list/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACpD,OAAO,EAAE,cAAc,EAAgB,MAAM,2BAA2B,CAAC;AACzE,OAAO,EACL,cAAc,EACd,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,aAAa,GACd,MAAM,0BAA0B,CAAC;AAElC,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,UAAmB;IACrD,MAAM,CAAU,OAAO,GAAG,sCAAsC,CAAC;IACjE,MAAM,CAAU,WAAW,GAChC,2FAA2F,CAAC;IACvF,MAAM,CAAU,QAAQ,GAAG,CAAC,0DAA0D,CAAC,CAAC;IACxF,MAAM,CAAU,KAAK,GAAG;QAC7B,YAAY,EAAE,aAAa;QAC3B,aAAa,EAAE,cAAc;QAC7B,eAAe,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,mDAAmD,EAAE,CAAC;QAC/F,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,YAAY;KAC1B,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAClD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;QACvF,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,UAAU,EAAE;YAC9C,YAAY,EAAE,KAAK,CAAC,eAAe,CAAC;YACpC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC;SAC7B,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;QACxC,OAAO,MAAM,CAAC;IAChB,CAAC"}

package/lib/contracts/info.d.ts

@@ -0,0 +1,43 @@
+import { EXTERNAL_REFERENCE_CORRELATIONS_CONTRACT } from './workspace-export.js';
+export declare const CMS_INFO_CONTRACT: "sf-cms-info";
+export declare const CMS_CAPABILITY_STATES: readonly ["implemented", "experimental", "unavailable"];
+export declare const CMS_CAPABILITY_TRANSPORT: "cli-json";
+export type CmsCapability = {
+    id: 'workspace.export.bulk' | 'workspace.export.dependency-closure' | 'workspace.export.external-reference-correlation' | 'workspace.import.mapping';
+    state: (typeof CMS_CAPABILITY_STATES)[number];
+    transport: typeof CMS_CAPABILITY_TRANSPORT;
+    contract: 'unavailable' | 'sf-cms-workspace-export-set@1' | typeof EXTERNAL_REFERENCE_CORRELATIONS_CONTRACT | 'sf-cms-workspace-import@1';
+};
+export type CmsInfoResult = {
+    plugin: {
+        name: 'sf-plugin-cms';
+        version: string;
+    };
+    api: {
+        defaultVersion: '67.0';
+        testedVersions: ['67.0'];
+    };
+    contracts: {
+        commandResults: {
+            info: ['1.0.0'];
+            workspaceExportSet: ['1.0.0'];
+            workspaceImport: ['1.0.0'];
+        };
+        packageManifests: {
+            workspaceExport: ['1.0.0'];
+        };
+        embeddedResults: {
+            externalReferenceCorrelations: [typeof EXTERNAL_REFERENCE_CORRELATIONS_CONTRACT];
+        };
+        compatibility: {
+            'workspaceExportSet@1': {
+                workspaceExportManifestMajors: [1];
+            };
+            'workspaceImport@1': {
+                workspaceExportManifestMajors: [1];
+            };
+        };
+    };
+    capabilities: CmsCapability[];
+};
+export declare function assertCmsInfoResult(value: unknown): asserts value is CmsInfoResult;

package/lib/contracts/info.js

@@ -0,0 +1,69 @@
+import { assertExactKeys, assertIdentifier, assertNonemptyString } from './shared.js';
+import { EXTERNAL_REFERENCE_CORRELATIONS_CONTRACT } from './workspace-export.js';
+export const CMS_INFO_CONTRACT = 'sf-cms-info';
+export const CMS_CAPABILITY_STATES = ['implemented', 'experimental', 'unavailable'];
+export const CMS_CAPABILITY_TRANSPORT = 'cli-json';
+export function assertCmsInfoResult(value) {
+    assertExactKeys(value, ['plugin', 'api', 'contracts', 'capabilities'], 'result');
+    assertExactKeys(value.plugin, ['name', 'version'], 'result.plugin');
+    if (value.plugin.name !== 'sf-plugin-cms')
+        throw new TypeError('result.plugin.name is invalid');
+    assertNonemptyString(value.plugin.version, 'result.plugin.version');
+    assertExactKeys(value.api, ['defaultVersion', 'testedVersions'], 'result.api');
+    if (value.api.defaultVersion !== '67.0' || !isExactArray(value.api.testedVersions, ['67.0'])) {
+        throw new TypeError('result.api is invalid');
+    }
+    assertExactKeys(value.contracts, ['commandResults', 'packageManifests', 'embeddedResults', 'compatibility'], 'result.contracts');
+    assertExactKeys(value.contracts.commandResults, ['info', 'workspaceExportSet', 'workspaceImport'], 'result.contracts.commandResults');
+    for (const key of ['info', 'workspaceExportSet', 'workspaceImport']) {
+        if (!isExactArray(value.contracts.commandResults[key], ['1.0.0'])) {
+            throw new TypeError(`result.contracts.commandResults.${key} is invalid`);
+        }
+    }
+    assertExactKeys(value.contracts.packageManifests, ['workspaceExport'], 'result.contracts.packageManifests');
+    if (!isExactArray(value.contracts.packageManifests.workspaceExport, ['1.0.0'])) {
+        throw new TypeError('result.contracts.packageManifests.workspaceExport is invalid');
+    }
+    assertExactKeys(value.contracts.embeddedResults, ['externalReferenceCorrelations'], 'result.contracts.embeddedResults');
+    if (!isExactArray(value.contracts.embeddedResults.externalReferenceCorrelations, [
+        EXTERNAL_REFERENCE_CORRELATIONS_CONTRACT,
+    ])) {
+        throw new TypeError('result.contracts.embeddedResults.externalReferenceCorrelations is invalid');
+    }
+    assertExactKeys(value.contracts.compatibility, ['workspaceExportSet@1', 'workspaceImport@1'], 'result.contracts.compatibility');
+    for (const key of ['workspaceExportSet@1', 'workspaceImport@1']) {
+        assertExactKeys(value.contracts.compatibility[key], ['workspaceExportManifestMajors'], `result.contracts.compatibility.${key}`);
+        if (!isExactArray(value.contracts.compatibility[key].workspaceExportManifestMajors, [1])) {
+            throw new TypeError(`result.contracts.compatibility.${key} is invalid`);
+        }
+    }
+    if (!Array.isArray(value.capabilities))
+        throw new TypeError('result.capabilities must be an array');
+    const seen = new Set();
+    for (const [index, capability] of value.capabilities.entries()) {
+        const label = `result.capabilities[${index}]`;
+        assertExactKeys(capability, ['id', 'state', 'transport', 'contract'], label);
+        assertIdentifier(capability.id, `${label}.id`);
+        if (seen.has(capability.id))
+            throw new TypeError(`duplicate capability: ${capability.id}`);
+        seen.add(capability.id);
+        if (!CMS_CAPABILITY_STATES.includes(capability.state)) {
+            throw new TypeError(`${label}.state is invalid`);
+        }
+        if (capability.transport !== CMS_CAPABILITY_TRANSPORT)
+            throw new TypeError(`${label}.transport is invalid`);
+        const expectedContracts = new Map([
+            ['workspace.export.bulk', 'sf-cms-workspace-export-set@1'],
+            ['workspace.export.dependency-closure', 'unavailable'],
+            ['workspace.export.external-reference-correlation', EXTERNAL_REFERENCE_CORRELATIONS_CONTRACT],
+            ['workspace.import.mapping', 'sf-cms-workspace-import@1'],
+        ]);
+        if (capability.contract !== expectedContracts.get(capability.id)) {
+            throw new TypeError(`${label}.contract does not match its capability ID`);
+        }
+    }
+}
+function isExactArray(value, expected) {
+    return Array.isArray(value) && JSON.stringify(value) === JSON.stringify(expected);
+}
+//# sourceMappingURL=info.js.map

package/lib/contracts/info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"info.js","sourceRoot":"","sources":["../../src/contracts/info.ts"],"names":[],"mappings":"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"}