sf-plugin-cms 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jörn Berkefeld
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,277 @@
+# sf-plugin-cms
+
+Salesforce CLI commands for inspecting Marketing Cloud CMS resources, experimentally exporting a workspace, and safely planning or applying a create-only workspace import through Connect REST API calls. The plugin does not update, overwrite, publish, unpublish, or broadly delete existing CMS content.
+
+## Installation and getting started
+
+### Prerequisites
+
+- Node.js 20 through 24 (`>=20 <25`).
+- The base Salesforce `sf` CLI.
+- A Salesforce org with access to the CMS resources you want to read.
+
+A common cross-platform way to install or update Salesforce CLI is with npm:
+
+```sh
+npm install --global @salesforce/cli
+sf --version
+```
+
+Salesforce also provides platform-specific installers if you prefer not to manage the CLI with npm.
+
+### Authenticate an org
+
+Open the browser login flow and assign an alias that you can reuse in CMS commands:
+
+```sh
+sf org login web --alias my-org
+sf org display --target-org my-org
+```
+
+For a sandbox or org that uses a custom login host, add `--instance-url <login-url>` to `sf org login web`.
+
+### Install the plugin
+
+The normal installation command for a published Salesforce CLI plugin will be:
+
+```sh
+sf plugins install sf-plugin-cms
+```
+
+This package is not currently documented as published to npm, so do not expect that command to work yet. For the current source-checkout workflow, run these commands from the repository's `sf-plugin-cms` directory:
+
+```sh
+npm install --no-workspaces
+npm run compile
+sf plugins link .
+```
+
+Linked ESM plugins use the compiled files. Run `npm run compile` again after source changes, or keep `npm run compile -- --watch` running while developing.
+
+Confirm that the plugin loads without making an org request:
+
+```sh
+sf cms info
+```
+
+## Command reference
+
+All org-backed commands require `--target-org <username-or-alias>` (short form `-o`). They use API version `67.0` by default; pass `--api-version <version>` only when you need to override it. Add `--json` for machine-readable Salesforce CLI output. Without `--json`, list commands print compact tables and get commands print formatted JSON records.
+
+### `sf cms info`
+
+Checks that the plugin entrypoint loads. This is the safest first command because it does not contact an org.
+
+```sh
+sf cms info
+```
+
+### `sf cms list workspace`
+
+Lists one bounded page of CMS workspaces. Use `--name-fragment` to filter workspace names, and use `--page` with `--page-size` to request a specific page.
+
+```sh
+sf cms list workspace --target-org my-org
+sf cms list workspace --target-org my-org --name-fragment Marketing
+sf cms list workspace --target-org my-org --page 0 --page-size 25 --json
+```
+
+Key flags:
+
+- `--name-fragment <text>`: return workspaces whose names contain the value.
+- `--page <number>`: zero-based page number; the first page is `0`.
+- `--page-size <number>`: maximum number of items requested for that page; must be at least `1`.
+
+The command requests only the selected page; it does not automatically follow subsequent pages.
+
+### `sf cms get workspace`
+
+Retrieves one workspace by its CMS content-space ID.
+
+```sh
+sf cms get workspace --target-org my-org --workspace-id 0Zu...
+sf cms get workspace --target-org my-org --workspace-id 0Zu... --json
+```
+
+Required selector: `--workspace-id <id>`.
+
+### `sf cms list channel`
+
+Lists one bounded page of channels assigned to a specific workspace.
+
+```sh
+sf cms list channel --target-org my-org --workspace-id 0Zu...
+sf cms list channel --target-org my-org --workspace-id 0Zu... --page 0 --page-size 25
+```
+
+Key flags:
+
+- `--workspace-id <id>`: required CMS workspace content-space ID.
+- `--page <number>`: zero-based page number.
+- `--page-size <number>`: maximum number of channels requested; must be at least `1`.
+
+The command requests only the selected page; it does not automatically follow subsequent pages.
+
+### `sf cms get channel`
+
+Retrieves one CMS channel by its identifier.
+
+```sh
+sf cms get channel --target-org my-org --channel-id 0ap...
+sf cms get channel --target-org my-org --channel-id 0ap... --json
+```
+
+Required selector: `--channel-id <id>`.
+
+### `sf cms get content`
+
+Retrieves a CMS content document by content key or ID. Optional selectors are passed directly to the CMS content request when you need a particular language or version.
+
+```sh
+sf cms get content --target-org my-org --content-key-or-id news-banner
+sf cms get content --target-org my-org --content-key-or-id news-banner --language en-US
+sf cms get content --target-org my-org --content-key-or-id news-banner --content-version 3 --variant-version 2 --version 1 --json
+```
+
+Key flags:
+
+- `--content-key-or-id <value>`: required content key or content identifier.
+- `--content-version <value>`: select a content version.
+- `--language <value>`: select a content language.
+- `--variant-version <value>`: select a variant version.
+- `--version <value>`: select a document version.
+
+The selector values are strings and are optional except for `--content-key-or-id`. Use only the selectors required by the content record you want.
+
+### `sf cms get variant`
+
+Retrieves one CMS content variant by its identifier.
+
+```sh
+sf cms get variant --target-org my-org --variant-id 0aV...
+sf cms get variant --target-org my-org --variant-id 0aV... --json
+```
+
+Required selector: `--variant-id <id>`.
+
+### `sf cms export workspace`
+
+Runs an experimental, read-only, best-effort export of the variants currently observed for one CMS workspace. The destination must not already exist. This output is not a complete or guaranteed backup.
+
+```sh
+sf cms export workspace --target-org my-org --workspace-id 0Zu... --output-dir ./cms-export
+sf cms export workspace --target-org my-org --workspace-id 0Zu... --output-dir ./cms-export --json
+```
+
+Required flags:
+
+- `--workspace-id <id>`: CMS workspace content-space ID. The command validates that the returned workspace ID exactly matches this value before export begins.
+- `--output-dir <path>`: new destination directory for `manifest.json` and the exported `items/*.json` files. There is no overwrite option.
+
+Every service warning is emitted to stderr. Human output reports the destination and exported-versus-expected counts; `--json` suppresses that human summary and returns one clean structured result.
+
+Export layout:
+
+```text
+cms-export/
+├── manifest.json
+└── items/
+    └── <variant-id>.json
+```
+
+`manifest.json` records the source workspace, search provenance, counts, warnings, rejected IDs, failed IDs, and the exact item-file mapping. Each item file contains one observed variant representation. Treat the package as best-effort evidence from that run, not as a guaranteed backup.
+
+### `sf cms import workspace`
+
+Plans or applies a create-only import from an export package. Dry-run is the default: the command validates the complete local package before authenticating, resolves the destination org and workspace, requires an exact workspace ID plus nonempty `defaultLanguage` and `rootFolderId`, and checks every planned content key for conflicts without sending mutations.
+
+Safe dry run:
+
+```sh
+sf cms import workspace --target-org my-org --workspace-id 0Zu... --source-dir ./cms-export
+sf cms import workspace --target-org my-org --workspace-id 0Zu... --source-dir ./cms-export --json
+```
+
+Explicit apply:
+
+```sh
+sf cms import workspace --target-org my-org --workspace-id 0Zu... --source-dir ./cms-export --apply --report-dir ./cms-import-report
+```
+
+Required flags:
+
+- `--target-org <username-or-alias>`: explicit destination org; no implicit target is accepted.
+- `--workspace-id <id>`: exact destination CMS workspace content-space ID.
+- `--source-dir <path>`: existing export package containing `manifest.json` and exactly the mapped `items/*.json` files.
+
+Safety flags:
+
+- `--apply`: opt in to mutations. Without it, the command only validates and preflights.
+- `--report-dir <path>`: required with `--apply`; the destination must not exist. There is no overwrite mode.
+- `--allow-partial`: accept a package whose manifest records omissions or incomplete coverage. Without this flag, partial exports are rejected.
+
+A successful apply writes:
+
+```text
+cms-import-report/
+└── workspace-import-run.json
+```
+
+The run report binds the run ID to the destination org ID, destination workspace ID, canonical source directory, and source-manifest SHA-256. Before each parent or child mutation it atomically records a `pending` operation containing the exact content key, language, operation kind, destination identity, deterministic request identity, and SHA-256. A response is then recorded as `succeeded` with returned IDs, or a thrown mutation is recorded as `failed` when report storage remains available. Immediate created-parent records remain available for recovery. The run itself is marked `applying`, `completed`, `failed`, or `ownership-uncertain`.
+
+Filesystem report replacement is atomic, but the remote mutation and local report update are not a single atomic transaction. If a mutation returns successfully and its result cannot be durably written, the command raises a distinct ownership-uncertain error and keeps that operation `pending`; the report must not be interpreted as proving that no remote object was created. An existing report directory is never reused, so unresolved operations cannot be treated as resumable progress.
+
+Import limitations and conflicts:
+
+- Import is create-only. Any existing destination content key aborts the entire preflight before mutation; there is no overwrite, update, merge, checkpoint/resume, or cleanup command.
+- Every content group must contain exactly one variant matching the destination workspace's `defaultLanguage`. There is no primary-language fallback.
+- Child variants are created sequentially after their primary parent. There is no concurrency.
+- Media-specific migration is not supported.
+- The command does not publish or unpublish content; newly created records are expected to remain draft/unpublished.
+- `--allow-partial` accepts known source omissions but does not make the missing records recoverable.
+
+Recovery guidance:
+
+1. Preserve `workspace-import-run.json` if an apply fails; it is the authoritative local journal for that run.
+2. Reconcile every unresolved `pending` operation first, using its exact destination org/workspace, content key, language, operation kind, and request hash. A pending entry means the mutation may have happened even when no returned ID is recorded.
+3. Inspect and verify each `succeeded` operation and immediate created-parent record in the exact destination org and workspace before taking action.
+4. Remove only records proven to belong to that run, beginning with recorded variants. Do not infer IDs or delete by broad search, workspace, title, or content-key pattern.
+5. If ownership or deletion is uncertain, stop and record the leftovers for manual review. Never modify workspace/channel configuration or publish content as recovery.
+6. This journal is not a resume mechanism. After reconciliation, correct the source or destination conflict, choose a new nonexisting report directory, and run dry-run again before any new apply attempt.
+
+In JSON mode the command returns exactly one structured command result. Human plan lines are suppressed; warnings and failures remain structured Salesforce CLI output, and transport errors redact authorization, cookies, tokens, and signed URL parameters.
+
+## Common flags and output
+
+- `--target-org <username-or-alias>` / `-o <username-or-alias>` selects the authenticated org. There is no implicit default for org-backed CMS commands.
+- `--api-version <version>` overrides the default CMS request API version, currently `67.0`.
+- `--json` returns the command result in Salesforce CLI JSON mode for scripts and automation.
+- `--page` is zero-based, and `--page-size` controls only the requested page size. Run another command with the next page number to continue paging.
+
+Use `sf <command> --help` to inspect the installed command's current flags, for example:
+
+```sh
+sf cms get content --help
+```
+
+## Development
+
+```sh
+npm install --no-workspaces
+npm run lint
+npm run build
+npm run intake:check
+npm test
+```
+
+## Contributor notes: experimental workspace export
+
+The experimental export uses the v67 `GET /connect/cms/items/search` operation. The API description requires a non-wildcard `queryTerm`; runtime probing found that `queryTerm=*` returned workspace inventories of 6 and 115 variants, including Draft, Published, and Revised records. This behavior is undocumented and must be retested rather than treated as a stable listing contract.
+
+String-array query values such as `contentSpaceOrFolderIds` and `languages` are serialized as repeated keys. Pagination reconstructs each request from the original filters instead of trusting `nextPageUri`, which was observed to remain present after an empty page. Delivery responses do not prove workspace ownership and exclude drafts. SOQL omitted a known record that remained readable through Connect REST, and CMS `9Pu` folders exposed no child-enumeration operation, so none of those alternatives establishes a complete inventory.
+
+Current shipped export guards are deliberately narrow: one explicit workspace whose lookup ID must match exactly; zero-based paging with `pageSize=250`; at most 1,000 pages and no more than two pages beyond the advertised-count calculation; stop when the advertised count is reached, a page is empty, or a nonempty page adds no new IDs; deduplicate repeated variant IDs; verify `managedContentSpaceId` in search rows and `contentSpace.id` in variant details; record ownership rejections and detail failures; refuse an existing destination; write stable JSON to a temporary sibling directory; remove staging after failure; and rename staging only after all output is written. The command emits all recorded warnings, prints only a compact human summary outside JSON mode, and returns one structured result in JSON mode.
+
+For every API-version upgrade, recheck the operation path and required parameters, wildcard behavior, repeated-key serialization, inventory counts and statuses, empty-page/`nextPageUri` behavior, both ownership fields, draft visibility, delivery coverage, SOQL parity, folder enumeration, duplicate-page handling, and all stop conditions before retaining export support.
+
+Do not market this experimental output as a complete or guaranteed backup. Counts, statuses, and undocumented wildcard behavior can change, and a successful run proves only what that run observed and wrote.

package/lib/commands/cms/command-base.d.ts

@@ -0,0 +1,16 @@
+import { Org } from '@salesforce/core';
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import type { CmsPage, CmsRecord } from '../../services/read.js';
+export declare const targetOrgFlag: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+export declare const apiVersionFlag: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+export declare const pageFlag: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+export declare const pageSizeFlag: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+export declare abstract class CmsCommand<T> extends SfCommand<T> {
+    protected getConnection(targetOrg: string, apiVersion: string): Promise<ReturnType<Org['getConnection']>>;
+    protected getOrgContext(targetOrg: string, apiVersion: string): Promise<{
+        connection: ReturnType<Org['getConnection']>;
+        orgId: string;
+    }>;
+    protected showPage(title: string, page: CmsPage): void;
+    protected showRecord(record: CmsRecord): void;
+}

package/lib/commands/cms/command-base.js

@@ -0,0 +1,42 @@
+import { Org } from '@salesforce/core';
+import { Flags, SfCommand } from '@salesforce/sf-plugins-core';
+export const targetOrgFlag = Flags.string({
+    char: 'o',
+    required: true,
+    summary: 'Username or alias of the target Salesforce org.',
+});
+export const apiVersionFlag = Flags.orgApiVersion({
+    default: '67.0',
+    summary: 'Salesforce API version used for CMS requests.',
+});
+export const pageFlag = Flags.integer({ min: 0, summary: 'Zero-based page number.' });
+export const pageSizeFlag = Flags.integer({ min: 1, summary: 'Maximum items requested per page.' });
+export class CmsCommand extends SfCommand {
+    async getConnection(targetOrg, apiVersion) {
+        const context = await this.getOrgContext(targetOrg, apiVersion);
+        return context.connection;
+    }
+    async getOrgContext(targetOrg, apiVersion) {
+        const org = await Org.create({ aliasOrUsername: targetOrg });
+        return { connection: org.getConnection(apiVersion), orgId: org.getOrgId() };
+    }
+    showPage(title, page) {
+        this.table({
+            data: page.items.map((item) => ({
+                id: stringValue(item, 'id'),
+                name: stringValue(item, 'name') || stringValue(item, 'title'),
+                type: stringValue(item, 'type'),
+            })),
+            title,
+        });
+    }
+    showRecord(record) {
+        if (!this.jsonEnabled())
+            this.styledJSON(record);
+    }
+}
+function stringValue(record, key) {
+    const value = record[key];
+    return typeof value === 'string' ? value : '';
+}
+//# sourceMappingURL=command-base.js.map

package/lib/commands/cms/command-base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-base.js","sourceRoot":"","sources":["../../../src/commands/cms/command-base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAG/D,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,GAAG;IACT,QAAQ,EAAE,IAAI;IACd,OAAO,EAAE,iDAAiD;CAC3D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC,aAAa,CAAC;IAChD,OAAO,EAAE,MAAM;IACf,OAAO,EAAE,+CAA+C;CACzD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,yBAAyB,EAAE,CAAC,CAAC;AACtF,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC,CAAC;AAEpG,MAAM,OAAgB,UAAc,SAAQ,SAAY;IAC5C,KAAK,CAAC,aAAa,CAC3B,SAAiB,EACjB,UAAkB;QAElB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QAChE,OAAO,OAAO,CAAC,UAAU,CAAC;IAC5B,CAAC;IAES,KAAK,CAAC,aAAa,CAC3B,SAAiB,EACjB,UAAkB;QAElB,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC,CAAC;QAC7D,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC;IAC9E,CAAC;IAES,QAAQ,CAAC,KAAa,EAAE,IAAa;QAC7C,IAAI,CAAC,KAAK,CAAC;YACT,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC9B,EAAE,EAAE,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC;gBAC3B,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC;gBAC7D,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC;aAChC,CAAC,CAAC;YACH,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAES,UAAU,CAAC,MAAiB;QACpC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;YAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACnD,CAAC;CACF;AAED,SAAS,WAAW,CAAC,MAAiB,EAAE,GAAW;IACjD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAChD,CAAC"}

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

@@ -0,0 +1,14 @@
+import { type ExportWorkspaceResult } from '../../../services/export-workspace.js';
+import { CmsCommand } from '../command-base.js';
+export default class ExportWorkspace extends CmsCommand<ExportWorkspaceResult> {
+    static readonly summary = "Experimentally export a CMS workspace using a read-only, best-effort process.";
+    static readonly description = "Reads a Marketing Cloud CMS workspace and writes the variants observed by an experimental, best-effort search. This is not a complete or guaranteed backup and does not mutate org data.";
+    static readonly examples: string[];
+    static readonly flags: {
+        'target-org': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'api-version': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'workspace-id': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'output-dir': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<ExportWorkspaceResult>;
+}

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

@@ -0,0 +1,42 @@
+import { Flags } from '@salesforce/sf-plugins-core';
+import { exportWorkspace, } from '../../../services/export-workspace.js';
+import { getWorkspace } from '../../../services/read.js';
+import { apiVersionFlag, CmsCommand, targetOrgFlag } from '../command-base.js';
+export default class ExportWorkspace extends CmsCommand {
+    static summary = 'Experimentally export a CMS workspace using a read-only, best-effort process.';
+    static description = 'Reads a Marketing Cloud CMS workspace and writes the variants observed by an experimental, best-effort search. This is not a complete or guaranteed backup and does not mutate org data.';
+    static examples = [
+        '<%= config.bin %> cms export workspace --target-org my-org --workspace-id 0Zu... --output-dir ./cms-export',
+    ];
+    static flags = {
+        'target-org': targetOrgFlag,
+        'api-version': apiVersionFlag,
+        'workspace-id': Flags.string({ required: true, summary: 'CMS workspace content-space ID.' }),
+        'output-dir': Flags.directory({
+            exists: false,
+            required: true,
+            summary: 'New directory to receive the experimental best-effort export.',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(ExportWorkspace);
+        const connection = await this.getConnection(flags['target-org'], flags['api-version']);
+        const workspace = await getWorkspace(connection, flags['workspace-id']);
+        if (workspace.id !== flags['workspace-id']) {
+            throw new Error(`Workspace validation returned ID ${String(workspace.id)} instead of requested ID ${flags['workspace-id']}.`);
+        }
+        const result = await exportWorkspace(connection, flags['workspace-id'], flags['output-dir']);
+        for (const warning of result.manifest.warnings)
+            this.warn(formatWarning(warning));
+        if (!this.jsonEnabled()) {
+            this.log(`Destination: ${result.destination}`);
+            this.log(`Exported variants: ${result.manifest.exportedCount}/${result.manifest.expectedCount} expected`);
+        }
+        return result;
+    }
+}
+function formatWarning(warning) {
+    const variantIds = warning.variantIds?.length ? ` (${warning.variantIds.join(', ')})` : '';
+    return `[${warning.code}] ${warning.message}${variantIds}`;
+}
+//# sourceMappingURL=workspace.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../../../src/commands/cms/export/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACpD,OAAO,EACL,eAAe,GAGhB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,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,+EAA+E,CAAC;IAC3E,MAAM,CAAU,WAAW,GAChC,0LAA0L,CAAC;IACtL,MAAM,CAAU,QAAQ,GAAG;QAChC,4GAA4G;KAC7G,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,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC;YAC5B,MAAM,EAAE,KAAK;YACb,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,+DAA+D;SACzE,CAAC;KACH,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QACpD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;QACvF,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC;QACxE,IAAI,SAAS,CAAC,EAAE,KAAK,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CACb,oCAAoC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,4BAA4B,KAAK,CAAC,cAAc,CAAC,GAAG,CAC7G,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC,cAAc,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;QAC7F,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ;YAAE,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;QAElF,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,IAAI,CAAC,GAAG,CAAC,gBAAgB,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;YAC/C,IAAI,CAAC,GAAG,CACN,sBAAsB,MAAM,CAAC,QAAQ,CAAC,aAAa,IAAI,MAAM,CAAC,QAAQ,CAAC,aAAa,WAAW,CAChG,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;;AAGH,SAAS,aAAa,CAAC,OAA+B;IACpD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3F,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,GAAG,UAAU,EAAE,CAAC;AAC7D,CAAC"}

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

@@ -0,0 +1,13 @@
+import { type CmsRecord } from '../../../services/read.js';
+import { CmsCommand } from '../command-base.js';
+export default class GetChannel extends CmsCommand<CmsRecord> {
+    static readonly summary = "Get a CMS channel.";
+    static readonly description = "Retrieves a channel by its identifier.";
+    static readonly examples: string[];
+    static readonly flags: {
+        'target-org': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'api-version': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'channel-id': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<CmsRecord>;
+}

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

@@ -0,0 +1,23 @@
+import { Flags } from '@salesforce/sf-plugins-core';
+import { getChannel } from '../../../services/read.js';
+import { apiVersionFlag, CmsCommand, targetOrgFlag } from '../command-base.js';
+export default class GetChannel extends CmsCommand {
+    static summary = 'Get a CMS channel.';
+    static description = 'Retrieves a channel by its identifier.';
+    static examples = [
+        '<%= config.bin %> cms get channel --target-org my-org --channel-id 0ap...',
+    ];
+    static flags = {
+        'target-org': targetOrgFlag,
+        'api-version': apiVersionFlag,
+        'channel-id': Flags.string({ required: true, summary: 'CMS channel identifier.' }),
+    };
+    async run() {
+        const { flags } = await this.parse(GetChannel);
+        const connection = await this.getConnection(flags['target-org'], flags['api-version']);
+        const result = await getChannel(connection, flags['channel-id']);
+        this.showRecord(result);
+        return result;
+    }
+}
+//# sourceMappingURL=channel.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"channel.js","sourceRoot":"","sources":["../../../../src/commands/cms/get/channel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACpD,OAAO,EAAE,UAAU,EAAkB,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAE/E,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,UAAqB;IACpD,MAAM,CAAU,OAAO,GAAG,oBAAoB,CAAC;IAC/C,MAAM,CAAU,WAAW,GAAG,wCAAwC,CAAC;IACvE,MAAM,CAAU,QAAQ,GAAG;QAChC,2EAA2E;KAC5E,CAAC;IACK,MAAM,CAAU,KAAK,GAAG;QAC7B,YAAY,EAAE,aAAa;QAC3B,aAAa,EAAE,cAAc;QAC7B,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,yBAAyB,EAAE,CAAC;KACnF,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;QACvF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;QACjE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACxB,OAAO,MAAM,CAAC;IAChB,CAAC"}

package/lib/commands/cms/get/content.d.ts

@@ -0,0 +1,17 @@
+import { type CmsRecord } from '../../../services/read.js';
+import { CmsCommand } from '../command-base.js';
+export default class GetContent extends CmsCommand<CmsRecord> {
+    static readonly summary = "Get CMS content.";
+    static readonly description = "Retrieves content by its key or identifier.";
+    static readonly examples: string[];
+    static readonly flags: {
+        'target-org': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'api-version': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'content-key-or-id': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'content-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        language: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'variant-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        version: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<CmsRecord>;
+}

package/lib/commands/cms/get/content.js

@@ -0,0 +1,35 @@
+import { Flags } from '@salesforce/sf-plugins-core';
+import { getContent } from '../../../services/read.js';
+import { apiVersionFlag, CmsCommand, targetOrgFlag } from '../command-base.js';
+export default class GetContent extends CmsCommand {
+    static summary = 'Get CMS content.';
+    static description = 'Retrieves content by its key or identifier.';
+    static examples = [
+        '<%= config.bin %> cms get content --target-org my-org --content-key-or-id news-banner',
+    ];
+    static flags = {
+        'target-org': targetOrgFlag,
+        'api-version': apiVersionFlag,
+        'content-key-or-id': Flags.string({
+            required: true,
+            summary: 'CMS content key or identifier.',
+        }),
+        'content-version': Flags.string({ summary: 'Content version selector.' }),
+        language: Flags.string({ summary: 'Content language selector.' }),
+        'variant-version': Flags.string({ summary: 'Variant version selector.' }),
+        version: Flags.string({ summary: 'Document version selector.' }),
+    };
+    async run() {
+        const { flags } = await this.parse(GetContent);
+        const connection = await this.getConnection(flags['target-org'], flags['api-version']);
+        const result = await getContent(connection, flags['content-key-or-id'], {
+            contentVersion: flags['content-version'],
+            language: flags.language,
+            variantVersion: flags['variant-version'],
+            version: flags.version,
+        });
+        this.showRecord(result);
+        return result;
+    }
+}
+//# sourceMappingURL=content.js.map

package/lib/commands/cms/get/content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../../../../src/commands/cms/get/content.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACpD,OAAO,EAAE,UAAU,EAAkB,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAE/E,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,UAAqB;IACpD,MAAM,CAAU,OAAO,GAAG,kBAAkB,CAAC;IAC7C,MAAM,CAAU,WAAW,GAAG,6CAA6C,CAAC;IAC5E,MAAM,CAAU,QAAQ,GAAG;QAChC,uFAAuF;KACxF,CAAC;IACK,MAAM,CAAU,KAAK,GAAG;QAC7B,YAAY,EAAE,aAAa;QAC3B,aAAa,EAAE,cAAc;QAC7B,mBAAmB,EAAE,KAAK,CAAC,MAAM,CAAC;YAChC,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,gCAAgC;SAC1C,CAAC;QACF,iBAAiB,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAAC;QACzE,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAAC;QACjE,iBAAiB,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAAC;QACzE,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAAC;KACjE,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;QACvF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,KAAK,CAAC,mBAAmB,CAAC,EAAE;YACtE,cAAc,EAAE,KAAK,CAAC,iBAAiB,CAAC;YACxC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,cAAc,EAAE,KAAK,CAAC,iBAAiB,CAAC;YACxC,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACxB,OAAO,MAAM,CAAC;IAChB,CAAC"}

package/lib/commands/cms/get/variant.d.ts

@@ -0,0 +1,13 @@
+import { type CmsRecord } from '../../../services/read.js';
+import { CmsCommand } from '../command-base.js';
+export default class GetVariant extends CmsCommand<CmsRecord> {
+    static readonly summary = "Get a CMS content variant.";
+    static readonly description = "Retrieves a content variant by its identifier.";
+    static readonly examples: string[];
+    static readonly flags: {
+        'target-org': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'api-version': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'variant-id': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<CmsRecord>;
+}

package/lib/commands/cms/get/variant.js

@@ -0,0 +1,23 @@
+import { Flags } from '@salesforce/sf-plugins-core';
+import { getVariant } from '../../../services/read.js';
+import { apiVersionFlag, CmsCommand, targetOrgFlag } from '../command-base.js';
+export default class GetVariant extends CmsCommand {
+    static summary = 'Get a CMS content variant.';
+    static description = 'Retrieves a content variant by its identifier.';
+    static examples = [
+        '<%= config.bin %> cms get variant --target-org my-org --variant-id 0ap...',
+    ];
+    static flags = {
+        'target-org': targetOrgFlag,
+        'api-version': apiVersionFlag,
+        'variant-id': Flags.string({ required: true, summary: 'CMS content variant identifier.' }),
+    };
+    async run() {
+        const { flags } = await this.parse(GetVariant);
+        const connection = await this.getConnection(flags['target-org'], flags['api-version']);
+        const result = await getVariant(connection, flags['variant-id']);
+        this.showRecord(result);
+        return result;
+    }
+}
+//# sourceMappingURL=variant.js.map

package/lib/commands/cms/get/variant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"variant.js","sourceRoot":"","sources":["../../../../src/commands/cms/get/variant.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACpD,OAAO,EAAE,UAAU,EAAkB,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAE/E,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,UAAqB;IACpD,MAAM,CAAU,OAAO,GAAG,4BAA4B,CAAC;IACvD,MAAM,CAAU,WAAW,GAAG,gDAAgD,CAAC;IAC/E,MAAM,CAAU,QAAQ,GAAG;QAChC,2EAA2E;KAC5E,CAAC;IACK,MAAM,CAAU,KAAK,GAAG;QAC7B,YAAY,EAAE,aAAa;QAC3B,aAAa,EAAE,cAAc;QAC7B,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;KAC3F,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;QACvF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;QACjE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACxB,OAAO,MAAM,CAAC;IAChB,CAAC"}

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

@@ -0,0 +1,13 @@
+import { type CmsRecord } from '../../../services/read.js';
+import { CmsCommand } from '../command-base.js';
+export default class GetWorkspace extends CmsCommand<CmsRecord> {
+    static readonly summary = "Get a Marketing Cloud CMS workspace.";
+    static readonly description = "Retrieves one CMS workspace by its content-space ID.";
+    static readonly examples: string[];
+    static readonly flags: {
+        'target-org': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'api-version': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'workspace-id': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<CmsRecord>;
+}

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

@@ -0,0 +1,23 @@
+import { Flags } from '@salesforce/sf-plugins-core';
+import { getWorkspace } from '../../../services/read.js';
+import { apiVersionFlag, CmsCommand, targetOrgFlag } from '../command-base.js';
+export default class GetWorkspace extends CmsCommand {
+    static summary = 'Get a Marketing Cloud CMS workspace.';
+    static description = 'Retrieves one CMS workspace by its content-space ID.';
+    static examples = [
+        '<%= config.bin %> cms get workspace --target-org my-org --workspace-id 0Zu...',
+    ];
+    static flags = {
+        'target-org': targetOrgFlag,
+        'api-version': apiVersionFlag,
+        'workspace-id': Flags.string({ required: true, summary: 'CMS workspace content-space ID.' }),
+    };
+    async run() {
+        const { flags } = await this.parse(GetWorkspace);
+        const connection = await this.getConnection(flags['target-org'], flags['api-version']);
+        const result = await getWorkspace(connection, flags['workspace-id']);
+        this.showRecord(result);
+        return result;
+    }
+}
+//# sourceMappingURL=workspace.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../../../src/commands/cms/get/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACpD,OAAO,EAAE,YAAY,EAAkB,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAE/E,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,UAAqB;IACtD,MAAM,CAAU,OAAO,GAAG,sCAAsC,CAAC;IACjE,MAAM,CAAU,WAAW,GAAG,sDAAsD,CAAC;IACrF,MAAM,CAAU,QAAQ,GAAG;QAChC,+EAA+E;KAChF,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;KAC7F,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACjD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;QACvF,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC;QACrE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACxB,OAAO,MAAM,CAAC;IAChB,CAAC"}