sf-plugin-cms 0.1.0

package/lib/services/read.js

@@ -0,0 +1,73 @@
+import { getSelectedOperation, requestJson, } from '../transport/json-request.js';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function optionalInteger(record, key) {
+    const value = record[key];
+    return typeof value === 'number' && Number.isInteger(value) ? value : undefined;
+}
+function readItems(data) {
+    if (Array.isArray(data))
+        return data.filter(isRecord);
+    if (!isRecord(data))
+        return [];
+    for (const key of ['items', 'spaces', 'contentSpaces', 'channels']) {
+        const value = data[key];
+        if (Array.isArray(value))
+            return value.filter(isRecord);
+    }
+    const spaceChannels = data.spaceChannels;
+    if (Array.isArray(spaceChannels)) {
+        return spaceChannels
+            .filter(isRecord)
+            .map((item) => item.channelSummary)
+            .filter(isRecord);
+    }
+    return [];
+}
+function toPage(data) {
+    const record = isRecord(data) ? data : {};
+    const result = { items: readItems(data) };
+    const page = optionalInteger(record, 'currentPage') ?? optionalInteger(record, 'page');
+    const pageSize = optionalInteger(record, 'pageSize');
+    const total = optionalInteger(record, 'total') ??
+        optionalInteger(record, 'totalCount') ??
+        optionalInteger(record, 'totalItems') ??
+        optionalInteger(record, 'totalSpaceChannels');
+    if (page !== undefined)
+        result.page = page;
+    if (pageSize !== undefined)
+        result.pageSize = pageSize;
+    if (total !== undefined)
+        result.total = total;
+    return result;
+}
+async function list(connection, operationKey, path, query, options) {
+    const response = await requestJson(connection, getSelectedOperation(operationKey), { path, query }, options);
+    return toPage(response.data);
+}
+async function get(connection, operationKey, path, query = {}, options = {}) {
+    const response = await requestJson(connection, getSelectedOperation(operationKey), { path, query }, options);
+    if (!isRecord(response.data))
+        throw new TypeError(`Unexpected ${operationKey} response shape`);
+    return response.data;
+}
+export function listWorkspaces(connection, query = {}, options = {}) {
+    return list(connection, 'workspace.list', {}, query, options);
+}
+export function getWorkspace(connection, contentSpaceId, options = {}) {
+    return get(connection, 'workspace.get', { contentSpaceId }, {}, options);
+}
+export function listWorkspaceChannels(connection, contentSpaceId, query = {}, options = {}) {
+    return list(connection, 'workspace.channel.list', { contentSpaceId }, query, options);
+}
+export function getChannel(connection, channelId, options = {}) {
+    return get(connection, 'channel.get', { channelId }, {}, options);
+}
+export function getContent(connection, contentKeyOrId, query = {}, options = {}) {
+    return get(connection, 'content.get', { contentKeyOrId }, query, options);
+}
+export function getVariant(connection, variantId, options = {}) {
+    return get(connection, 'variant.get', { variantId }, {}, options);
+}
+//# sourceMappingURL=read.js.map

package/lib/services/read.js.map

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

package/lib/services/write.d.ts

@@ -0,0 +1,27 @@
+import type { Connection } from '@salesforce/core';
+import { type EmptyMutationSuccess, type JsonMutationBody } from '../transport/json-mutation.js';
+import { type JsonRequestOptions } from '../transport/json-request.js';
+import type { CmsRecord } from './read.js';
+type RequestConnection = Pick<Connection, 'request'>;
+export type CreateContentInput = JsonMutationBody & {
+    apiName?: string;
+    contentBody: Readonly<Record<string, unknown>>;
+    contentKey?: string;
+    contentSpaceOrFolderId: string;
+    contentType: string;
+    externalId?: string;
+    externalSource?: Readonly<Record<string, unknown>>;
+    title: string;
+    urlName?: string;
+};
+export type CreateVariantInput = JsonMutationBody & {
+    contentBody: Readonly<Record<string, unknown>>;
+    language: string;
+    managedContentKeyOrId: string;
+    title?: string;
+    urlName?: string;
+};
+export declare function createContent(connection: RequestConnection, body: CreateContentInput, options?: JsonRequestOptions): Promise<CmsRecord>;
+export declare function createVariant(connection: RequestConnection, body: CreateVariantInput, options?: JsonRequestOptions): Promise<CmsRecord>;
+export declare function deleteVariant(connection: RequestConnection, variantId: string, options?: JsonRequestOptions): Promise<EmptyMutationSuccess>;
+export {};

package/lib/services/write.js

@@ -0,0 +1,21 @@
+import { requestEmptyMutation, requestJsonMutation, } from '../transport/json-mutation.js';
+import { getSelectedOperation } from '../transport/json-request.js';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+async function create(connection, operationKey, body, options) {
+    const response = await requestJsonMutation(connection, getSelectedOperation(operationKey), body, {}, options);
+    if (!isRecord(response.data))
+        throw new TypeError(`Unexpected ${operationKey} response shape`);
+    return response.data;
+}
+export function createContent(connection, body, options = {}) {
+    return create(connection, 'content.create', body, options);
+}
+export function createVariant(connection, body, options = {}) {
+    return create(connection, 'variant.create', body, options);
+}
+export function deleteVariant(connection, variantId, options = {}) {
+    return requestEmptyMutation(connection, getSelectedOperation('variant.delete'), { path: { variantId } }, options);
+}
+//# sourceMappingURL=write.js.map

package/lib/services/write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../../src/services/write.ts"],"names":[],"mappings":"AACA,OAAO,EACL,oBAAoB,EACpB,mBAAmB,GAGpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,oBAAoB,EAA2B,MAAM,8BAA8B,CAAC;AAyB7F,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,KAAK,UAAU,MAAM,CACnB,UAA6B,EAC7B,YAAiD,EACjD,IAA6C,EAC7C,OAA2B;IAE3B,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CACxC,UAAU,EACV,oBAAoB,CAAC,YAAY,CAAC,EAClC,IAAI,EACJ,EAAE,EACF,OAAO,CACR,CAAC;IACF,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,cAAc,YAAY,iBAAiB,CAAC,CAAC;IAC/F,OAAO,QAAQ,CAAC,IAAI,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,UAA6B,EAC7B,IAAwB,EACxB,UAA8B,EAAE;IAEhC,OAAO,MAAM,CAAC,UAAU,EAAE,gBAAgB,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,UAA6B,EAC7B,IAAwB,EACxB,UAA8B,EAAE;IAEhC,OAAO,MAAM,CAAC,UAAU,EAAE,gBAAgB,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,UAA6B,EAC7B,SAAiB,EACjB,UAA8B,EAAE;IAEhC,OAAO,oBAAoB,CACzB,UAAU,EACV,oBAAoB,CAAC,gBAAgB,CAAC,EACtC,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,EAAE,EACvB,OAAO,CACR,CAAC;AACJ,CAAC"}

package/lib/transport/json-mutation.d.ts

@@ -0,0 +1,15 @@
+import type { Connection } from '@salesforce/core';
+import type { SelectedOperation } from '../generated/operations.js';
+import { type JsonRequestOptions, type JsonRequestValues } from './json-request.js';
+export type JsonMutationBody = Readonly<Record<string, unknown>>;
+export type JsonMutationSuccess<T> = {
+    data: T;
+    operationKey: SelectedOperation['localKey'];
+};
+export type EmptyMutationSuccess = {
+    operationKey: SelectedOperation['localKey'];
+};
+type RequestConnection = Pick<Connection, 'request'> & Partial<Pick<Connection, 'accessToken' | 'instanceUrl' | 'version'>>;
+export declare function requestJsonMutation<T>(connection: RequestConnection, operation: SelectedOperation, body: JsonMutationBody, values?: JsonRequestValues, options?: JsonRequestOptions): Promise<JsonMutationSuccess<T>>;
+export declare function requestEmptyMutation(connection: RequestConnection, operation: SelectedOperation, values?: JsonRequestValues, options?: JsonRequestOptions): Promise<EmptyMutationSuccess>;
+export {};

package/lib/transport/json-mutation.js

@@ -0,0 +1,81 @@
+import { Connection as JsforceConnection } from '@jsforce/jsforce-node';
+import { buildOperationUrl, CmsRequestError, } from './json-request.js';
+import { redactSecrets } from './redact-secrets.js';
+const DEFAULT_TIMEOUT_MS = 30_000;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function errorStatus(error) {
+    if (!isRecord(error))
+        return undefined;
+    for (const key of ['statusCode', 'status']) {
+        const value = error[key];
+        if (typeof value === 'number' && Number.isInteger(value))
+            return value;
+    }
+    return undefined;
+}
+function safeErrorMessage(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return redactSecrets(message || 'CMS request failed');
+}
+function withoutRefreshReplay(connection) {
+    return connection.accessToken && connection.instanceUrl
+        ? new JsforceConnection({
+            accessToken: connection.accessToken,
+            instanceUrl: connection.instanceUrl,
+            version: connection.version,
+        })
+        : connection;
+}
+function validateMutationOperation(operation, hasBody) {
+    if (operation.method !== 'POST' && operation.method !== 'DELETE') {
+        throw new CmsRequestError(operation.localKey, `Unsupported mutation method: ${operation.method}`);
+    }
+    const requestBodyMediaTypes = operation.requestBodyMediaTypes;
+    if (hasBody && !requestBodyMediaTypes.includes('application/json')) {
+        throw new CmsRequestError(operation.localKey, 'Mutation operation does not accept application/json');
+    }
+    if (!hasBody && operation.requestBodyPresent) {
+        throw new CmsRequestError(operation.localKey, 'Mutation operation requires a request body');
+    }
+}
+async function sendMutation(connection, operation, values, body, options) {
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+        throw new CmsRequestError(operation.localKey, 'Request timeout must be a positive number');
+    }
+    if (options.signal?.aborted) {
+        throw new CmsRequestError(operation.localKey, 'CMS request cancelled');
+    }
+    validateMutationOperation(operation, body !== undefined);
+    const request = withoutRefreshReplay(connection).request({
+        method: operation.method,
+        url: buildOperationUrl(operation, values),
+        headers: { 'content-type': 'application/json' },
+        ...(body === undefined ? {} : { body: JSON.stringify(body) }),
+    }, { retry: { maxRetries: 0 }, timeout: timeoutMs });
+    const cancel = () => {
+        request.stream().destroy(new Error('CMS request cancelled'));
+    };
+    options.signal?.addEventListener('abort', cancel, { once: true });
+    try {
+        return await request;
+    }
+    catch (error) {
+        const message = options.signal?.aborted ? 'CMS request cancelled' : safeErrorMessage(error);
+        throw new CmsRequestError(operation.localKey, message, errorStatus(error));
+    }
+    finally {
+        options.signal?.removeEventListener('abort', cancel);
+    }
+}
+export async function requestJsonMutation(connection, operation, body, values = {}, options = {}) {
+    const data = await sendMutation(connection, operation, values, body, options);
+    return { data, operationKey: operation.localKey };
+}
+export async function requestEmptyMutation(connection, operation, values = {}, options = {}) {
+    await sendMutation(connection, operation, values, undefined, options);
+    return { operationKey: operation.localKey };
+}
+//# sourceMappingURL=json-mutation.js.map

package/lib/transport/json-mutation.js.map

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

package/lib/transport/json-request.d.ts

@@ -0,0 +1,26 @@
+import type { Connection } from '@salesforce/core';
+import { type SelectedOperation } from '../generated/operations.js';
+export type OperationParameterValues = Readonly<Record<string, boolean | number | readonly string[] | string | undefined>>;
+export type JsonRequestValues = {
+    path?: OperationParameterValues;
+    query?: OperationParameterValues;
+};
+export type JsonRequestOptions = {
+    signal?: AbortSignal;
+    timeoutMs?: number;
+};
+export type JsonSuccess<T> = {
+    data: T;
+    operationKey: SelectedOperation['localKey'];
+    status: number;
+};
+type RequestConnection = Pick<Connection, 'request'>;
+export declare class CmsRequestError extends Error {
+    readonly operationKey: SelectedOperation['localKey'];
+    readonly status?: number;
+    constructor(operationKey: SelectedOperation['localKey'], message: string, status?: number);
+}
+export declare function buildOperationUrl(operation: SelectedOperation, values?: JsonRequestValues): string;
+export declare function requestJson<T>(connection: RequestConnection, operation: SelectedOperation, values?: JsonRequestValues, options?: JsonRequestOptions): Promise<JsonSuccess<T>>;
+export declare function getSelectedOperation(operationKey: SelectedOperation['localKey']): SelectedOperation;
+export {};

package/lib/transport/json-request.js

@@ -0,0 +1,135 @@
+import { SELECTED_OPERATIONS } from '../generated/operations.js';
+import { redactSecrets } from './redact-secrets.js';
+const DEFAULT_TIMEOUT_MS = 30_000;
+export class CmsRequestError extends Error {
+    operationKey;
+    status;
+    constructor(operationKey, message, status) {
+        super(message);
+        this.name = 'CmsRequestError';
+        this.operationKey = operationKey;
+        this.status = status;
+    }
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function errorStatus(error) {
+    if (!isRecord(error))
+        return undefined;
+    for (const key of ['statusCode', 'status']) {
+        const value = error[key];
+        if (typeof value === 'number' && Number.isInteger(value))
+            return value;
+    }
+    if (error.errorCode === 'NOT_FOUND' || error.name === 'NOT_FOUND')
+        return 404;
+    if (isRecord(error.data) && error.data.errorCode === 'NOT_FOUND')
+        return 404;
+    return undefined;
+}
+function safeErrorMessage(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return redactSecrets(message || 'CMS request failed');
+}
+function assertValueType(operation, name, type, value) {
+    const valid = (type === 'string' && typeof value === 'string') ||
+        (type === 'boolean' && typeof value === 'boolean') ||
+        (type === 'integer' && typeof value === 'number' && Number.isInteger(value)) ||
+        (type === 'string-array' &&
+            Array.isArray(value) &&
+            value.length > 0 &&
+            value.every((item) => typeof item === 'string'));
+    if (!valid) {
+        throw new CmsRequestError(operation.localKey, `Invalid ${type} parameter: ${name}`);
+    }
+}
+function validateKnownParameters(operation, location, values) {
+    const known = new Set(operation.parameters
+        .filter((parameter) => parameter.location === location)
+        .map((parameter) => parameter.name));
+    for (const name of Object.keys(values)) {
+        if (!known.has(name)) {
+            throw new CmsRequestError(operation.localKey, `Unknown ${location} parameter: ${name}`);
+        }
+    }
+}
+export function buildOperationUrl(operation, values = {}) {
+    const pathValues = values.path ?? {};
+    const queryValues = values.query ?? {};
+    validateKnownParameters(operation, 'path', pathValues);
+    validateKnownParameters(operation, 'query', queryValues);
+    const parameters = operation.parameters;
+    let requestPath = operation.path;
+    for (const parameter of parameters.filter(({ location }) => location === 'path')) {
+        const value = pathValues[parameter.name];
+        if (value === undefined) {
+            throw new CmsRequestError(operation.localKey, `Missing required path parameter: ${parameter.name}`);
+        }
+        assertValueType(operation, parameter.name, parameter.type, value);
+        if (typeof value === 'string' && value.length === 0) {
+            throw new CmsRequestError(operation.localKey, `Empty path parameter: ${parameter.name}`);
+        }
+        requestPath = requestPath.replace(`{${parameter.name}}`, encodeURIComponent(String(value)));
+    }
+    const search = new URLSearchParams();
+    const queryParameters = parameters
+        .filter(({ location }) => location === 'query')
+        .toSorted((left, right) => left.name.localeCompare(right.name));
+    for (const parameter of queryParameters) {
+        const value = queryValues[parameter.name];
+        if (value === undefined) {
+            if (parameter.required) {
+                throw new CmsRequestError(operation.localKey, `Missing required query parameter: ${parameter.name}`);
+            }
+            continue;
+        }
+        assertValueType(operation, parameter.name, parameter.type, value);
+        if (parameter.type === 'string-array') {
+            for (const item of value)
+                search.append(parameter.name, item);
+        }
+        else {
+            search.set(parameter.name, String(value));
+        }
+    }
+    const query = search.toString();
+    return query.length > 0 ? `${requestPath}?${query}` : requestPath;
+}
+function successStatus(operation) {
+    const status = operation.responses.find(({ status: value }) => /^2\d\d$/u.test(value))?.status;
+    return status === undefined ? 200 : Number(status);
+}
+export async function requestJson(connection, operation, values = {}, options = {}) {
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+        throw new CmsRequestError(operation.localKey, 'Request timeout must be a positive number');
+    }
+    if (options.signal?.aborted) {
+        throw new CmsRequestError(operation.localKey, 'CMS request cancelled');
+    }
+    const url = buildOperationUrl(operation, values);
+    const request = connection.request({ method: operation.method, url }, { timeout: timeoutMs });
+    const cancel = () => {
+        request.stream().destroy(new Error('CMS request cancelled'));
+    };
+    options.signal?.addEventListener('abort', cancel, { once: true });
+    try {
+        const data = await request;
+        return { data, operationKey: operation.localKey, status: successStatus(operation) };
+    }
+    catch (error) {
+        const message = options.signal?.aborted ? 'CMS request cancelled' : safeErrorMessage(error);
+        throw new CmsRequestError(operation.localKey, message, errorStatus(error));
+    }
+    finally {
+        options.signal?.removeEventListener('abort', cancel);
+    }
+}
+export function getSelectedOperation(operationKey) {
+    const operation = SELECTED_OPERATIONS.find(({ localKey }) => localKey === operationKey);
+    if (!operation)
+        throw new CmsRequestError(operationKey, `Unknown operation: ${operationKey}`);
+    return operation;
+}
+//# sourceMappingURL=json-request.js.map

package/lib/transport/json-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-request.js","sourceRoot":"","sources":["../../src/transport/json-request.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAA0B,MAAM,4BAA4B,CAAC;AACzF,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAkCpD,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxB,YAAY,CAAgC;IAC5C,MAAM,CAAU;IAEhC,YACE,YAA2C,EAC3C,OAAe,EACf,MAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACvC,KAAK,MAAM,GAAG,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;IACzE,CAAC;IACD,IAAI,KAAK,CAAC,SAAS,KAAK,WAAW,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW;QAAE,OAAO,GAAG,CAAC;IAC9E,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,KAAK,WAAW;QAAE,OAAO,GAAG,CAAC;IAC7E,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,aAAa,CAAC,OAAO,IAAI,oBAAoB,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,eAAe,CACtB,SAA4B,EAC5B,IAAY,EACZ,IAAuD,EACvD,KAAc;IAEd,MAAM,KAAK,GACT,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;QAChD,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,SAAS,CAAC;QAClD,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC5E,CAAC,IAAI,KAAK,cAAc;YACtB,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YACpB,KAAK,CAAC,MAAM,GAAG,CAAC;YAChB,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC;IACrD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,eAAe,CAAC,SAAS,CAAC,QAAQ,EAAE,WAAW,IAAI,eAAe,IAAI,EAAE,CAAC,CAAC;IACtF,CAAC;AACH,CAAC;AAED,SAAS,uBAAuB,CAC9B,SAA4B,EAC5B,QAA0B,EAC1B,MAAgC;IAEhC,MAAM,KAAK,GAAG,IAAI,GAAG,CACnB,SAAS,CAAC,UAAU;SACjB,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,KAAK,QAAQ,CAAC;SACtD,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CACtC,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACvC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,eAAe,CAAC,SAAS,CAAC,QAAQ,EAAE,WAAW,QAAQ,eAAe,IAAI,EAAE,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,SAA4B,EAC5B,SAA4B,EAAE;IAE9B,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;IACrC,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IACvC,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IACvD,uBAAuB,CAAC,SAAS,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IAEzD,MAAM,UAAU,GAAG,SAAS,CAAC,UAAyC,CAAC;IACvE,IAAI,WAAW,GAAW,SAAS,CAAC,IAAI,CAAC;IACzC,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,QAAQ,KAAK,MAAM,CAAC,EAAE,CAAC;QACjF,MAAM,KAAK,GAAG,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,eAAe,CACvB,SAAS,CAAC,QAAQ,EAClB,oCAAoC,SAAS,CAAC,IAAI,EAAE,CACrD,CAAC;QACJ,CAAC;QACD,eAAe,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAClE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,eAAe,CAAC,SAAS,CAAC,QAAQ,EAAE,yBAAyB,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3F,CAAC;QACD,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC,IAAI,GAAG,EAAE,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9F,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IACrC,MAAM,eAAe,GAAG,UAAU;SAC/B,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,QAAQ,KAAK,OAAO,CAAC;SAC9C,QAAQ,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAClE,KAAK,MAAM,SAAS,IAAI,eAAe,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;gBACvB,MAAM,IAAI,eAAe,CACvB,SAAS,CAAC,QAAQ,EAClB,qCAAqC,SAAS,CAAC,IAAI,EAAE,CACtD,CAAC;YACJ,CAAC;YACD,SAAS;QACX,CAAC;QACD,eAAe,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAClE,IAAI,SAAS,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YACtC,KAAK,MAAM,IAAI,IAAI,KAA0B;gBAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACrF,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAChC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;AACpE,CAAC;AAED,SAAS,aAAa,CAAC,SAA4B;IACjD,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC;IAC/F,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,UAA6B,EAC7B,SAA4B,EAC5B,SAA4B,EAAE,EAC9B,UAA8B,EAAE;IAEhC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,kBAAkB,CAAC;IAC1D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,eAAe,CAAC,SAAS,CAAC,QAAQ,EAAE,2CAA2C,CAAC,CAAC;IAC7F,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,eAAe,CAAC,SAAS,CAAC,QAAQ,EAAE,uBAAuB,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,GAAG,GAAG,iBAAiB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAChC,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,EACjC,EAAE,OAAO,EAAE,SAAS,EAAE,CACH,CAAC;IACtB,MAAM,MAAM,GAAG,GAAS,EAAE;QACxB,OAAO,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAAC;IAC/D,CAAC,CAAC;IACF,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAElE,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC;QAC3B,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC;IACtF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC5F,MAAM,IAAI,eAAe,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7E,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACvD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,YAA2C;IAE3C,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,QAAQ,KAAK,YAAY,CAAC,CAAC;IACxF,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,eAAe,CAAC,YAAY,EAAE,sBAAsB,YAAY,EAAE,CAAC,CAAC;IAC9F,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/lib/transport/redact-secrets.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Redacts credential-shaped values from transport diagnostics without replacing ordinary prose.
+ * @param {string} message - Diagnostic text that may contain request credentials.
+ * @returns {string} The diagnostic text with recognized secret values replaced.
+ */
+export declare function redactSecrets(message: string): string;

package/lib/transport/redact-secrets.js

@@ -0,0 +1,31 @@
+const REDACTED = '[REDACTED]';
+const AUTHORIZATION_HEADERS = '(?:authorization|proxy-authorization)';
+const COOKIE_HEADERS = '(?:cookie|set-cookie)';
+const QUERY_KEYS = [
+    'access_token',
+    'id_token',
+    'refresh_token',
+    'signature',
+    'sig',
+    'token',
+    'x-amz-credential',
+    'x-amz-security-token',
+    'x-amz-signature',
+    'se',
+    'sp',
+    'sr',
+    'sv',
+].join('|');
+/**
+ * Redacts credential-shaped values from transport diagnostics without replacing ordinary prose.
+ * @param {string} message - Diagnostic text that may contain request credentials.
+ * @returns {string} The diagnostic text with recognized secret values replaced.
+ */
+export function redactSecrets(message) {
+    return message
+        .replaceAll(new RegExp(String.raw `(${AUTHORIZATION_HEADERS}\s*[:=]\s*)(?:(?:bearer|basic)\s+)?[^\s,;]+`, 'giu'), `$1${REDACTED}`)
+        .replaceAll(new RegExp(String.raw `(${COOKIE_HEADERS}\s*[:=]\s*)[^\r\n]+`, 'giu'), `$1${REDACTED}`)
+        .replaceAll(/(bearer\s+)[a-z\d._~+/=-]+/giu, `$1${REDACTED}`)
+        .replaceAll(new RegExp(String.raw `([?&](?:${QUERY_KEYS})=)[^&#\s]+`, 'giu'), `$1${REDACTED}`);
+}
+//# sourceMappingURL=redact-secrets.js.map

package/lib/transport/redact-secrets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact-secrets.js","sourceRoot":"","sources":["../../src/transport/redact-secrets.ts"],"names":[],"mappings":"AAAA,MAAM,QAAQ,GAAG,YAAY,CAAC;AAE9B,MAAM,qBAAqB,GAAG,uCAAuC,CAAC;AACtE,MAAM,cAAc,GAAG,uBAAuB,CAAC;AAC/C,MAAM,UAAU,GAAG;IACjB,cAAc;IACd,UAAU;IACV,eAAe;IACf,WAAW;IACX,KAAK;IACL,OAAO;IACP,kBAAkB;IAClB,sBAAsB;IACtB,iBAAiB;IACjB,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;CACL,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO,OAAO;SACX,UAAU,CACT,IAAI,MAAM,CACR,MAAM,CAAC,GAAG,CAAA,IAAI,qBAAqB,6CAA6C,EAChF,KAAK,CACN,EACD,KAAK,QAAQ,EAAE,CAChB;SACA,UAAU,CACT,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAA,IAAI,cAAc,qBAAqB,EAAE,KAAK,CAAC,EACpE,KAAK,QAAQ,EAAE,CAChB;SACA,UAAU,CAAC,+BAA+B,EAAE,KAAK,QAAQ,EAAE,CAAC;SAC5D,UAAU,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAA,WAAW,UAAU,aAAa,EAAE,KAAK,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC,CAAC;AAClG,CAAC"}

package/messages/cms.export.workspace.md

@@ -0,0 +1,29 @@
+# summary
+
+Experimentally export a CMS workspace using a read-only, best-effort process.
+
+# 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.
+
+# examples
+
+- Export the variants observed for one workspace into a new directory:
+
+  <%= config.bin %> <%= command.id %> --target-org my-org --workspace-id 0Zu... --output-dir ./cms-export
+
+# flags.target-org.summary
+
+Username or alias of the target Salesforce org.
+
+# flags.api-version.summary
+
+Salesforce API version used for CMS requests.
+
+# flags.workspace-id.summary
+
+CMS workspace content-space ID.
+
+# flags.output-dir.summary
+
+New directory to receive the experimental best-effort export.

package/messages/cms.get.channel.md

@@ -0,0 +1,25 @@
+# summary
+
+Get a CMS channel.
+
+# description
+
+Retrieves a channel by its identifier.
+
+# examples
+
+- Get a channel:
+
+  <%= config.bin %> <%= command.id %> --target-org my-org --channel-id 0ap...
+
+# flags.target-org.summary
+
+Username or alias of the target Salesforce org.
+
+# flags.api-version.summary
+
+Salesforce API version used for CMS requests.
+
+# flags.channel-id.summary
+
+CMS channel identifier.

package/messages/cms.get.content.md

@@ -0,0 +1,41 @@
+# summary
+
+Get CMS content.
+
+# description
+
+Retrieves content by its key or identifier.
+
+# examples
+
+- Get content:
+
+  <%= config.bin %> <%= command.id %> --target-org my-org --content-key-or-id news-banner
+
+# flags.target-org.summary
+
+Username or alias of the target Salesforce org.
+
+# flags.api-version.summary
+
+Salesforce API version used for CMS requests.
+
+# flags.content-key-or-id.summary
+
+CMS content key or identifier.
+
+# flags.content-version.summary
+
+Content version selector.
+
+# flags.language.summary
+
+Content language selector.
+
+# flags.variant-version.summary
+
+Variant version selector.
+
+# flags.version.summary
+
+Document version selector.

package/messages/cms.get.variant.md

@@ -0,0 +1,25 @@
+# summary
+
+Get a CMS content variant.
+
+# description
+
+Retrieves a content variant by its identifier.
+
+# examples
+
+- Get a variant:
+
+  <%= config.bin %> <%= command.id %> --target-org my-org --variant-id 0aV...
+
+# flags.target-org.summary
+
+Username or alias of the target Salesforce org.
+
+# flags.api-version.summary
+
+Salesforce API version used for CMS requests.
+
+# flags.variant-id.summary
+
+CMS content variant identifier.

package/messages/cms.get.workspace.md

@@ -0,0 +1,25 @@
+# summary
+
+Get a Marketing Cloud CMS workspace.
+
+# description
+
+Retrieves one CMS workspace by its content-space ID.
+
+# examples
+
+- Get a workspace:
+
+  <%= config.bin %> <%= command.id %> --target-org my-org --workspace-id 0Zu...
+
+# flags.target-org.summary
+
+Username or alias of the target Salesforce org.
+
+# flags.api-version.summary
+
+Salesforce API version used for CMS requests.
+
+# flags.workspace-id.summary
+
+CMS workspace content-space ID.