sf-plugin-cms 0.3.0 → 0.4.0

package/lib/services/import-identities.d.ts

@@ -0,0 +1,33 @@
+import type { LoadedWorkspaceExport, WorkspaceImportItem } from './import-workspace.js';
+/**
+ * Build the bounded native raw-HTML copy profile without allocating a content key.
+ * @param {LoadedWorkspaceExport} source - Integrity-checked original export.
+ * @param {unknown} input - Explicit parent/language selection and fresh names.
+ * @param {ReadonlySet<string>} literalHtmlVariantIds - Reconstructed sidecar variants, never GET-decode their literal HTML.
+ * @returns {PlannedImportIdentities} Detached selected native copies.
+ */
+export declare function planNativeCopies(source: LoadedWorkspaceExport, input: unknown, literalHtmlVariantIds?: ReadonlySet<string>): PlannedImportIdentities;
+/**
+ * Decode the single entity layer used by native GET, leaving literal HTML untouched.
+ * @param {string} value - Native rawHtml string.
+ * @returns {string} Literal HTML with at most one GET encoding layer removed.
+ */
+export declare function decodeNativeHtml(value: string): string;
+export declare function safeNativeRawHtml(value: string): boolean;
+export type CreateIdentityMapping = {
+    readonly sourceContentKey: string;
+    readonly contentKey: string;
+    readonly apiName: string;
+    readonly urlNames: Readonly<Record<string, string>>;
+};
+export type PlannedImportIdentities = {
+    readonly items: readonly WorkspaceImportItem[];
+    readonly targetContentKeys: readonly string[];
+};
+/**
+ * Build a detached identity proposal, not an executable or destination-validated import plan.
+ * @param {LoadedWorkspaceExport} source - Export already loaded through raw-byte integrity validation.
+ * @param {unknown} input - Complete explicit CREATE mappings for every selected parent and language.
+ * @returns {PlannedImportIdentities} Detached items requiring destination absence checks before mutation.
+ */
+export declare function planImportIdentities(source: LoadedWorkspaceExport, input: unknown): PlannedImportIdentities;

package/lib/services/import-identities.js

@@ -0,0 +1,287 @@
+/**
+ * Build the bounded native raw-HTML copy profile without allocating a content key.
+ * @param {LoadedWorkspaceExport} source - Integrity-checked original export.
+ * @param {unknown} input - Explicit parent/language selection and fresh names.
+ * @param {ReadonlySet<string>} literalHtmlVariantIds - Reconstructed sidecar variants, never GET-decode their literal HTML.
+ * @returns {PlannedImportIdentities} Detached selected native copies.
+ */
+export function planNativeCopies(source, input, literalHtmlVariantIds = new Set()) {
+    if (!Array.isArray(input) || input.length === 0)
+        throw new TypeError('Native copy mappings must be a nonempty array');
+    const selected = [];
+    const apiNames = new Set(source.items.map((item) => item.apiName));
+    const urls = new Set(source.items.flatMap((item) => [item.urlName, item.contentBody['sfdc_cms:urlName']]));
+    const parents = new Set();
+    for (const row of input) {
+        if (!record(row))
+            throw new TypeError('Native copy mapping must be an object');
+        exactKeys(row, ['sourceContentKey', 'language', 'apiName', 'urlName'], 'Native copy mapping');
+        for (const key of ['sourceContentKey', 'language', 'apiName'])
+            identity(row[key], key);
+        if (typeof row.urlName !== 'string' || !/^[a-z0-9-]+$/u.test(row.urlName))
+            throw new TypeError('Native URL name must use lowercase letters, digits or hyphens');
+        const matches = source.items.filter((item) => item.contentKey === row.sourceContentKey && item.language === row.language);
+        if (matches.length !== 1 || parents.has(row.sourceContentKey))
+            throw new TypeError('Select exactly one language per distinct native parent');
+        const item = matches[0];
+        if (apiNames.has(row.apiName) || urls.has(row.urlName))
+            throw new TypeError('Native API and URL names must be fresh relative to the source and this run');
+        assertNativeBody(item);
+        parents.add(item.contentKey);
+        apiNames.add(row.apiName);
+        urls.add(row.urlName);
+        selected.push({
+            ...item,
+            apiName: row.apiName,
+            urlName: row.urlName,
+            contentBody: {
+                ...item.contentBody,
+                rawHtml: literalHtmlVariantIds.has(item.id)
+                    ? item.contentBody.rawHtml
+                    : decodeNativeHtml(item.contentBody.rawHtml),
+                ...(item.contentType === 'sfdc_cms__email' ? { 'sfdc_cms:urlName': row.urlName } : {}),
+            },
+        });
+    }
+    return { items: selected, targetContentKeys: [] };
+}
+/**
+ * Decode the single entity layer used by native GET, leaving literal HTML untouched.
+ * @param {string} value - Native rawHtml string.
+ * @returns {string} Literal HTML with at most one GET encoding layer removed.
+ */
+export function decodeNativeHtml(value) {
+    // Native GET encodes the complete HTML document once; do not decode literal HTML text.
+    if (value.includes('<') || !value.includes('&lt;'))
+        return value;
+    return value
+        .replaceAll('&lt;', '<')
+        .replaceAll('&gt;', '>')
+        .replaceAll('&quot;', '"')
+        .replaceAll('&#39;', "'")
+        .replaceAll('&amp;', '&');
+}
+function assertNativeBody(item) {
+    if (!['sfdc_cms__email', 'sfdc_cms__emailTemplate'].includes(item.contentType))
+        throw new TypeError('Native copy supports only raw-HTML email/template content');
+    if (item.externalId != null || item.externalSource != null)
+        throw new TypeError('External provider content is unsupported');
+    const strings = new Set([
+        'sfdc_cms:title',
+        'sfdc_cms:description',
+        'subjectLine',
+        'preheader',
+        'messagePurpose',
+        'rawHtml',
+        'textContent',
+        'backgroundColor',
+    ]);
+    if (item.contentType === 'sfdc_cms__email')
+        strings.add('sfdc_cms:urlName');
+    const emptyArrays = new Set([
+        'lightning:dataProviders',
+        'lightning:expressions',
+        'sfdc_cms:attachments',
+        'sfdc_cms:variants',
+    ]);
+    for (const required of ['sfdc_cms:title', 'subjectLine', 'messagePurpose', 'rawHtml']) {
+        if (typeof item.contentBody[required] !== 'string' || !item.contentBody[required])
+            throw new TypeError(`Native body requires ${required}`);
+    }
+    for (const [key, value] of Object.entries(item.contentBody)) {
+        if (strings.has(key) &&
+            typeof value === 'string' &&
+            // Temporary through Phase 7: retain the scanner, but bypass it for opaque rawHtml.
+            (key === 'rawHtml' ? TEMPORARILY_BYPASS_RAW_HTML_SCANNER : safeNativeMetadata(value)))
+            continue;
+        if (emptyArrays.has(key) && Array.isArray(value) && value.length === 0)
+            continue;
+        if (key === 'lightning:backgroundImage' &&
+            record(value) &&
+            Object.keys(value).length === 3 &&
+            value.repeat === 'no-repeat' &&
+            value.position === 'center center' &&
+            value.size === 'cover')
+            continue;
+        if (key === 'lightning:brandSource' &&
+            item.contentType === 'sfdc_cms__email' &&
+            record(value) &&
+            Object.keys(value).length === 1 &&
+            value.defaultBrandOption === 'sfdcBrand')
+            continue;
+        throw new TypeError(`Unsupported native body field or unresolved reference/media: ${key}`);
+    }
+}
+const TEMPORARILY_BYPASS_RAW_HTML_SCANNER = true;
+const NATIVE_DANGER = /\{\{|\{!|%%|\$brand|(?:<)\s*(?:img|script|iframe|video|audio|source|object|embed|link|svg)\b|\b(?:src|srcset)\s*=|url\s*\(|cms:\/\/|\/cms\//iu;
+function safeNativeMetadata(value) {
+    return !/&(?:#|[a-z])/iu.test(value) && !NATIVE_DANGER.test(value);
+}
+// This is a security inspection vocabulary, not a general HTML entity decoder; list aliases that can compose denied markers.
+const INSPECTABLE_ENTITY = /&(?:(?:amp|lt|gt|quot|apos|colon|sol|lbrace|rbrace|lcub|rcub|percnt|dollar|lpar|rpar|equals|tab|newline);?(?![\da-z=])|#39;?(?!\d)|#x[\da-f]+;?(?![\da-f])|#\d+;?(?!\d))/giu;
+export function safeNativeRawHtml(value) {
+    let inspected = value;
+    for (let pass = 0; pass < 3; pass += 1) {
+        if (NATIVE_DANGER.test(inspected))
+            return false;
+        const normalized = inspected.replaceAll(INSPECTABLE_ENTITY, (entity) => decodeInspectionEntity(entity));
+        if (normalized === inspected)
+            return true;
+        inspected = normalized;
+    }
+    INSPECTABLE_ENTITY.lastIndex = 0;
+    return !NATIVE_DANGER.test(inspected) && !INSPECTABLE_ENTITY.test(inspected);
+}
+function decodeInspectionEntity(entity) {
+    const normalized = entity.toLowerCase();
+    const terminated = normalized.endsWith(';');
+    const bare = terminated ? normalized.slice(0, -1) : normalized;
+    if (bare === '&amp')
+        return '&';
+    if (bare === '&lt')
+        return '<';
+    if (bare === '&gt')
+        return '>';
+    if (bare === '&quot')
+        return '"';
+    if (bare === '&apos' || bare === '&#39')
+        return "'";
+    const named = new Map([
+        ['&colon', ':'],
+        ['&sol', '/'],
+        ['&lbrace', '{'],
+        ['&rbrace', '}'],
+        ['&lcub', '{'],
+        ['&rcub', '}'],
+        ['&percnt', '%'],
+        ['&dollar', '$'],
+        ['&lpar', '('],
+        ['&rpar', ')'],
+        ['&equals', '='],
+        ['&tab', '\t'],
+        ['&newline', '\n'],
+    ]).get(bare);
+    if (named !== undefined)
+        return named;
+    const numeric = bare.startsWith('&#x')
+        ? Number.parseInt(bare.slice(3), 16)
+        : Number.parseInt(bare.slice(2), 10);
+    return Number.isFinite(numeric) && numeric >= 0 && numeric <= 1_114_111
+        ? String.fromCodePoint(numeric)
+        : entity;
+}
+function record(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function exactKeys(value, keys, label) {
+    if (Object.keys(value).toSorted().join('\0') !== [...keys].toSorted().join('\0')) {
+        throw new TypeError(`${label} must contain exactly ${keys.join(', ')}`);
+    }
+}
+function identity(value, label) {
+    if (typeof value !== 'string' || !/^[A-Za-z0-9_-]+$/u.test(value)) {
+        throw new TypeError(`${label} must be a nonempty identifier without whitespace or separators`);
+    }
+}
+function rewriteReferences(value, keys) {
+    if (Array.isArray(value))
+        return value.map((child) => rewriteReferences(child, keys));
+    if (!record(value))
+        return value;
+    if ('ref' in value) {
+        // Only the documented ImageContentReference shape proves this field is a CMS key.
+        if (value.type !== 'imageReference' || !record(value.ref)) {
+            throw new TypeError('Unsupported or ambiguous content reference; explicit transport required');
+        }
+        exactKeys(value.ref, ['contentKey'], 'Image reference');
+        const key = value.ref.contentKey;
+        if (typeof key !== 'string' || !keys.has(key)) {
+            throw new TypeError('Image reference has no selected source identity mapping');
+        }
+        return Object.fromEntries(Object.entries(value).map(([name, child]) => [
+            name,
+            name === 'ref' ? { contentKey: keys.get(key) } : rewriteReferences(child, keys),
+        ]));
+    }
+    return Object.fromEntries(Object.entries(value).map(([name, child]) => [name, rewriteReferences(child, keys)]));
+}
+/**
+ * Build a detached identity proposal, not an executable or destination-validated import plan.
+ * @param {LoadedWorkspaceExport} source - Export already loaded through raw-byte integrity validation.
+ * @param {unknown} input - Complete explicit CREATE mappings for every selected parent and language.
+ * @returns {PlannedImportIdentities} Detached items requiring destination absence checks before mutation.
+ */
+export function planImportIdentities(source, input) {
+    if (!source.integrity.verified)
+        throw new TypeError('Source integrity must be verified first');
+    if (!Array.isArray(input))
+        throw new TypeError('Identity mappings must be an array');
+    const sourceKeys = new Set(source.items.map((item) => item.contentKey));
+    const sourceApiNames = new Set(source.items.map((item) => item.apiName));
+    const sourceUrls = new Set(source.items.flatMap((item) => [item.urlName, item.contentBody['sfdc_cms:urlName']]));
+    const mappings = new Map();
+    const targets = new Set();
+    const apiNames = new Set();
+    const urls = new Set();
+    for (const row of input) {
+        if (!record(row))
+            throw new TypeError('Identity mapping must be an object');
+        exactKeys(row, ['sourceContentKey', 'contentKey', 'apiName', 'urlNames'], 'Identity mapping');
+        for (const name of ['sourceContentKey', 'contentKey', 'apiName'])
+            identity(row[name], name);
+        const { sourceContentKey, contentKey, apiName } = row;
+        if (!sourceKeys.has(sourceContentKey) || mappings.has(sourceContentKey)) {
+            throw new TypeError('Identity mapping has an unknown or duplicate source content key');
+        }
+        if (sourceKeys.has(contentKey) || targets.has(contentKey)) {
+            throw new TypeError('Target content keys must be fresh and unique');
+        }
+        if (sourceApiNames.has(apiName) || apiNames.has(apiName)) {
+            throw new TypeError('Target API names must be fresh and unique');
+        }
+        const variants = source.items.filter((item) => item.contentKey === sourceContentKey);
+        if (new Set(variants.map((item) => item.contentType)).size !== 1) {
+            throw new TypeError('Parent variants have conflicting content types');
+        }
+        if (!record(row.urlNames))
+            throw new TypeError('urlNames must be an object');
+        exactKeys(row.urlNames, variants.map((item) => item.language), 'urlNames');
+        for (const url of Object.values(row.urlNames)) {
+            if (typeof url !== 'string' || !/^[a-z0-9-]+$/u.test(url)) {
+                throw new TypeError('Target URL names must contain lowercase letters, digits or hyphens');
+            }
+            if (sourceUrls.has(url) || urls.has(url)) {
+                throw new TypeError('Target URL names must be fresh and unique');
+            }
+            urls.add(url);
+        }
+        mappings.set(sourceContentKey, row);
+        targets.add(contentKey);
+        apiNames.add(apiName);
+    }
+    if (mappings.size !== sourceKeys.size)
+        throw new TypeError('Every selected parent needs a mapping');
+    const replacements = new Map([...mappings].map(([key, mapping]) => [key, mapping.contentKey]));
+    const imageKeys = new Map(source.items
+        .filter((item) => item.contentType === 'sfdc_cms__image')
+        .map((item) => [item.contentKey, replacements.get(item.contentKey)]));
+    const items = source.items.map((item) => {
+        const mapping = mappings.get(item.contentKey);
+        const contentBody = rewriteReferences(item.contentBody, imageKeys);
+        const urlName = mapping.urlNames[item.language];
+        // Email CMS metadata lives inside the body; never replace matching strings elsewhere.
+        if (item.contentType === 'sfdc_cms__email' ||
+            (item.contentType === 'sfdc_cms__emailTemplate' && 'sfdc_cms:urlName' in contentBody)) {
+            contentBody['sfdc_cms:urlName'] = urlName;
+        }
+        return {
+            ...item,
+            apiName: mapping.apiName,
+            contentKey: mapping.contentKey,
+            urlName,
+            contentBody,
+        };
+    });
+    return { items, targetContentKeys: [...targets].toSorted() };
+}
+//# sourceMappingURL=import-identities.js.map

package/lib/services/import-identities.js.map

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

package/lib/services/import-workspace.d.ts

@@ -1,7 +1,10 @@
 import type { Connection } from '@salesforce/core';
+import type { CmsDiagnostic } from '../contracts/shared.js';
 import type { JsonRequestOptions } from '../transport/json-request.js';
+import { type AtomicPublishOptions, type CleanupOptions } from './atomic-publish.js';
 import { type WorkspaceExportManifest } from '../contracts/workspace-export.js';
 import type { WorkspaceImportResult as WorkspaceImportContractResult } from '../contracts/workspace-import.js';
+import { type EditableHtmlEvidence } from './editable-raw-html-import.js';
 type RequestConnection = Pick<Connection, 'request'>;
 type JsonObject = {
     readonly [key: string]: JsonValue;
@@ -65,12 +68,14 @@ export type WorkspaceImportOperation = {
     error?: string;
     result?: {
         readonly contentId?: string;
+        readonly contentKey?: string;
         readonly primaryVariantId?: string;
         readonly variantId?: string;
     };
     state: 'pending' | 'succeeded' | 'failed';
 };
 export type WorkspaceImportRunReport = {
+    readonly editableSource?: EditableHtmlEvidence;
     readonly createdParents: CreatedParentRecord[];
     readonly destinationOrgId: string;
     readonly destinationWorkspaceId: string;
@@ -94,7 +99,10 @@ export type ExecuteWorkspaceImportOptions = {
     readonly destinationOrgId: string;
     readonly destinationWorkspace: unknown;
     readonly dryRun?: boolean;
+    readonly editableDirectory?: string;
     readonly loadedSource?: LoadedWorkspaceExport;
+    readonly identityMappings?: unknown;
+    readonly nativeCopyMappings?: unknown;
     readonly reportDirectory?: string;
     readonly reportPersistence?: WorkspaceImportReportPersistence;
     readonly requestOptions?: JsonRequestOptions;
@@ -102,15 +110,46 @@ export type ExecuteWorkspaceImportOptions = {
     readonly workspaceId: string;
 };
 export type WorkspaceImportExecutionResult = {
+    readonly diagnostics: CmsDiagnostic[];
     readonly contractResult: WorkspaceImportContractResult;
     readonly dryRun: boolean;
     readonly plan: WorkspaceImportPlan;
     readonly report?: WorkspaceImportRunReport;
     readonly reportFile?: string;
 };
+/**
+ * Read a regular file while detecting observed replacement or modification.
+ * @param {string} file - Absolute file path.
+ * @param {string} label - Error context.
+ * @returns {Promise<Buffer>} Original file bytes.
+ */
+export declare function readStableRegularFile(file: string, label: string): Promise<Buffer>;
+/**
+ * Enumerate regular package files without following symlinks.
+ * @param {string} directory - Directory to inspect.
+ * @param {string} packageRoot - Root for relative paths.
+ * @returns {Promise<string[]>} Sorted portable relative filenames.
+ */
+export declare function enumeratePackageFiles(directory: string, packageRoot: string): Promise<string[]>;
 export declare function loadWorkspaceExport(sourceDirectory: string, options?: {
     readonly allowPartial?: boolean;
 }): Promise<LoadedWorkspaceExport>;
 export declare function planWorkspaceImport(source: LoadedWorkspaceExport, workspace: unknown, expectedWorkspaceId: string): WorkspaceImportPlan;
+type AtomicRewriteOptions = AtomicPublishOptions & CleanupOptions;
+export declare function rewriteAtomic(file: string, value: unknown, options?: AtomicRewriteOptions): Promise<void>;
+/**
+ * Reconstruct editable HTML before native validation, retaining all original identity inventory.
+ * @param {LoadedWorkspaceExport} source - Complete verified original package.
+ * @param {unknown} mappings - Native copy selections and fresh identities.
+ * @param {string} editableDirectory - Optional verified HTML companion.
+ * @returns {Promise<object>} Native proposal and optional all-companion evidence.
+ */
+export declare function planNativeWorkspaceImport(source: LoadedWorkspaceExport, mappings: unknown, editableDirectory?: string): Promise<{
+    proposal: import("./import-identities.js").PlannedImportIdentities;
+    editableSource?: undefined;
+} | {
+    proposal: import("./import-identities.js").PlannedImportIdentities;
+    editableSource: EditableHtmlEvidence;
+}>;
 export declare function executeWorkspaceImport(options: ExecuteWorkspaceImportOptions): Promise<WorkspaceImportExecutionResult>;
 export {};