sf-plugin-cms 0.4.0 → 0.5.0

package/lib/services/landing-page.js

@@ -0,0 +1,117 @@
+import { assertLandingPageTemplateItem, planLandingPageTemplateCopies, validateLandingPageTemplatePrerequisites, } from './landing-page-template.js';
+const LANDING_PAGE_TYPE = 'sfdc_cms__landingPage';
+const TEMPLATE_TYPE = 'sfdc_cms__landingPageTemplate';
+function record(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function exactKeys(value, required, optional, label) {
+    const keys = Object.keys(value);
+    if (required.some((key) => !keys.includes(key)) ||
+        keys.some((key) => !required.includes(key) && !optional.includes(key))) {
+        throw new TypeError(`${label} contains unsupported or missing fields`);
+    }
+}
+/**
+ * Validate the exact captured landing-page authoring shape.
+ * @param {WorkspaceImportItem} item - Captured workspace item to validate.
+ * @returns {object} Extracted image and Data Graph prerequisites.
+ */
+export function assertLandingPageItem(item) {
+    if (item.contentType !== LANDING_PAGE_TYPE) {
+        throw new TypeError(`Landing-page profile requires exact content type ${LANDING_PAGE_TYPE}`);
+    }
+    const inspect = (value) => {
+        if (Array.isArray(value)) {
+            for (const child of value)
+                inspect(child);
+            return;
+        }
+        if (!record(value))
+            return;
+        if (record(value.source) &&
+            value.source.type === 'imageReference' &&
+            (!record(value.source.ref) ||
+                Object.keys(value.source.ref).length !== 1 ||
+                typeof value.source.ref.contentKey !== 'string' ||
+                typeof value.url !== 'string' ||
+                !value.url.startsWith(`/cms/media/${value.source.ref.contentKey}`))) {
+            throw new TypeError('Landing-page image URL must match its exact image content key');
+        }
+        for (const child of Object.values(value))
+            inspect(child);
+    };
+    inspect(item.contentBody);
+    return assertLandingPageTemplateItem({ ...item, contentType: TEMPLATE_TYPE });
+}
+function rows(value) {
+    if (!Array.isArray(value) || value.length === 0 || value.some((row) => !record(row))) {
+        throw new TypeError('Landing-page mappings must be a nonempty array of objects');
+    }
+    return value;
+}
+/**
+ * Plan exact type-qualified landing-page creates using only evidenced image references.
+ * @param {LoadedWorkspaceExport} source - Verified source workspace package.
+ * @param {unknown} input - User-supplied landing-page mapping JSON.
+ * @returns {PlannedLandingPageCopies} Validated create proposal.
+ */
+export function planLandingPageCopies(source, input) {
+    const transformedRows = rows(input).map((row, index) => {
+        exactKeys(row, ['source', 'target', 'imageDependencies', 'dataGraphs'], [], `Landing-page mapping ${index}`);
+        if (!record(row.source)) {
+            throw new TypeError(`Landing-page mapping ${index}.source must be an object`);
+        }
+        exactKeys(row.source, ['family', 'type', 'apiName'], [], `Landing-page mapping ${index}.source`);
+        if (row.source.family !== 'cms' || row.source.type !== 'landingPage') {
+            throw new TypeError(`Landing-page mapping ${index}.source must select cms/landingPage`);
+        }
+        if (!Array.isArray(row.imageDependencies)) {
+            throw new TypeError(`Landing-page mapping ${index}.imageDependencies must be an array`);
+        }
+        const cmsDependencies = row.imageDependencies.map((dependency, dependencyIndex) => {
+            if (!record(dependency)) {
+                throw new TypeError(`Landing-page image dependency ${dependencyIndex} must be an object`);
+            }
+            exactKeys(dependency, ['sourceContentKey', 'targetApiName'], ['targetTitle'], `Landing-page image dependency ${dependencyIndex}`);
+            return { ...dependency, sourceType: 'image' };
+        });
+        return {
+            source: { ...row.source, type: 'landingPageTemplate' },
+            target: row.target,
+            cmsDependencies,
+            dataGraphs: row.dataGraphs,
+        };
+    });
+    const transformedSource = {
+        ...source,
+        items: source.items.map((item) => item.contentType === LANDING_PAGE_TYPE ? { ...item, contentType: TEMPLATE_TYPE } : item),
+    };
+    const planned = planLandingPageTemplateCopies(transformedSource, transformedRows);
+    const items = planned.items.map((item) => ({ ...item, contentType: LANDING_PAGE_TYPE }));
+    for (const item of items)
+        assertLandingPageItem(item);
+    return {
+        ...planned,
+        items,
+        cmsPrerequisites: planned.cmsPrerequisites,
+    };
+}
+/**
+ * Resolve exact typed images, validate Data Graph identities, and rewrite evidenced references.
+ * @param {RequestConnection} connection - Destination org connection.
+ * @param {string} workspaceId - Exact destination workspace ID.
+ * @param {PlannedLandingPageCopies} proposal - Landing-page proposal to validate.
+ * @param {JsonRequestOptions} options - Optional request metadata and signal.
+ * @returns {Promise<void>} Resolves after every prerequisite is validated and rewritten.
+ */
+export async function validateLandingPagePrerequisites(connection, workspaceId, proposal, options = {}) {
+    const templateProposal = {
+        ...proposal,
+        items: proposal.items.map((item) => ({ ...item, contentType: TEMPLATE_TYPE })),
+    };
+    await validateLandingPageTemplatePrerequisites(connection, workspaceId, templateProposal, options);
+    for (const [index, item] of templateProposal.items.entries()) {
+        proposal.items[index] = { ...item, contentType: LANDING_PAGE_TYPE };
+    }
+}
+//# sourceMappingURL=landing-page.js.map

package/lib/services/landing-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"landing-page.js","sourceRoot":"","sources":["../../src/services/landing-page.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,EAC7B,wCAAwC,GAGzC,MAAM,4BAA4B,CAAC;AAEpC,MAAM,iBAAiB,GAAG,uBAAuB,CAAC;AAClD,MAAM,aAAa,GAAG,+BAA+B,CAAC;AAkBtD,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,SAAS,CAChB,KAA8B,EAC9B,QAA2B,EAC3B,QAA2B,EAC3B,KAAa;IAEb,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,IACE,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EACtE,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,yCAAyC,CAAC,CAAC;IACzE,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAyB;IAI7D,IAAI,IAAI,CAAC,WAAW,KAAK,iBAAiB,EAAE,CAAC;QAC3C,MAAM,IAAI,SAAS,CAAC,oDAAoD,iBAAiB,EAAE,CAAC,CAAC;IAC/F,CAAC;IACD,MAAM,OAAO,GAAG,CAAC,KAAc,EAAQ,EAAE;QACvC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,KAAK,MAAM,KAAK,IAAI,KAAK;gBAAE,OAAO,CAAC,KAAK,CAAC,CAAC;YAC1C,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;YAAE,OAAO;QAC3B,IACE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;YACpB,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,gBAAgB;YACtC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC;gBACxB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC;gBAC1C,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,KAAK,QAAQ;gBAC/C,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ;gBAC7B,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,cAAc,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,EACrE,CAAC;YACD,MAAM,IAAI,SAAS,CAAC,+DAA+D,CAAC,CAAC;QACvF,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;YAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3D,CAAC,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC1B,OAAO,6BAA6B,CAAC,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC,CAAC;AAChF,CAAC;AAED,SAAS,IAAI,CAAC,KAAc;IAC1B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QACrF,MAAM,IAAI,SAAS,CAAC,2DAA2D,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,KAAkC,CAAC;AAC5C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAA6B,EAC7B,KAAc;IAEd,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QACrD,SAAS,CACP,GAAG,EACH,CAAC,QAAQ,EAAE,QAAQ,EAAE,mBAAmB,EAAE,YAAY,CAAC,EACvD,EAAE,EACF,wBAAwB,KAAK,EAAE,CAChC,CAAC;QACF,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,SAAS,CAAC,wBAAwB,KAAK,2BAA2B,CAAC,CAAC;QAChF,CAAC;QACD,SAAS,CACP,GAAG,CAAC,MAAM,EACV,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAC7B,EAAE,EACF,wBAAwB,KAAK,SAAS,CACvC,CAAC;QACF,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,KAAK,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YACrE,MAAM,IAAI,SAAS,CAAC,wBAAwB,KAAK,qCAAqC,CAAC,CAAC;QAC1F,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,SAAS,CAAC,wBAAwB,KAAK,qCAAqC,CAAC,CAAC;QAC1F,CAAC;QACD,MAAM,eAAe,GAAG,GAAG,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,eAAe,EAAE,EAAE;YAChF,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;gBACxB,MAAM,IAAI,SAAS,CAAC,iCAAiC,eAAe,oBAAoB,CAAC,CAAC;YAC5F,CAAC;YACD,SAAS,CACP,UAAU,EACV,CAAC,kBAAkB,EAAE,eAAe,CAAC,EACrC,CAAC,aAAa,CAAC,EACf,iCAAiC,eAAe,EAAE,CACnD,CAAC;YACF,OAAO,EAAE,GAAG,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;QAChD,CAAC,CAAC,CAAC;QACH,OAAO;YACL,MAAM,EAAE,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,qBAAqB,EAAE;YACtD,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,eAAe;YACf,UAAU,EAAE,GAAG,CAAC,UAAU;SAC3B,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,MAAM,iBAAiB,GAA0B;QAC/C,GAAG,MAAM;QACT,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAC/B,IAAI,CAAC,WAAW,KAAK,iBAAiB,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,IAAI,CACxF;KACF,CAAC;IACF,MAAM,OAAO,GAAG,6BAA6B,CAAC,iBAAiB,EAAE,eAAe,CAAC,CAAC;IAClF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC;IACzF,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACtD,OAAO;QACL,GAAG,OAAO;QACV,KAAK;QACL,gBAAgB,EAAE,OAAO,CAAC,gBAAkD;KAC7E,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,gCAAgC,CACpD,UAA6B,EAC7B,WAAmB,EACnB,QAAkC,EAClC,UAA8B,EAAE;IAEhC,MAAM,gBAAgB,GAAqC;QACzD,GAAG,QAAQ;QACX,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC,CAAC;KAC/E,CAAC;IACF,MAAM,wCAAwC,CAC5C,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,OAAO,CACR,CAAC;IACF,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,gBAAgB,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QAC5D,QAAQ,CAAC,KAA+B,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjG,CAAC;AACH,CAAC"}

package/lib/services/web-fragment.d.ts

@@ -0,0 +1,41 @@
+import type { Connection } from '@salesforce/core';
+import type { LoadedWorkspaceExport, WorkspaceImportItem } from './import-workspace.js';
+import type { PlannedImportIdentities } from './import-identities.js';
+type QueryConnection = {
+    readonly query?: Connection['query'];
+};
+export type WebFragmentDataGraphPrerequisite = {
+    readonly sourceDeveloperName: string;
+    readonly sourceDataSpace: string;
+    readonly targetDeveloperName: string;
+    readonly targetDataSpace: string;
+    readonly resolution: 'preserved' | 'explicit-map';
+    validationStatus?: 'pending' | 'passed' | 'failed';
+};
+export type PlannedWebFragmentCopies = PlannedImportIdentities & {
+    readonly dataGraphs: readonly WebFragmentDataGraphPrerequisite[];
+};
+/**
+ * Validate the evidenced landing-page content-block shape.
+ * @param {WorkspaceImportItem} item - Integrity-verified web-fragment item.
+ * @returns {{developerName: string, dataSpace: string}[]} Exact named Data Graph prerequisites.
+ */
+export declare function assertWebFragmentItem(item: WorkspaceImportItem): readonly {
+    developerName: string;
+    dataSpace: string;
+}[];
+/**
+ * Plan one or many exact type-qualified web-fragment creates.
+ * @param {LoadedWorkspaceExport} source - Integrity-verified workspace package.
+ * @param {unknown} input - Explicit source, target, and Data Graph map rows.
+ * @returns {PlannedWebFragmentCopies} Selected creates and exact prerequisite evidence.
+ */
+export declare function planWebFragmentCopies(source: LoadedWorkspaceExport, input: unknown): PlannedWebFragmentCopies;
+/**
+ * Prove each exact target Data Graph developer-name/data-space pair exists uniquely.
+ * @param {QueryConnection} connection - Destination org query transport.
+ * @param {readonly WebFragmentDataGraphPrerequisite[]} prerequisites - Exact target prerequisites.
+ * @returns {Promise<void>} Fulfilled only when every prerequisite resolves exactly once.
+ */
+export declare function validateDataGraphPrerequisites(connection: QueryConnection, prerequisites: readonly WebFragmentDataGraphPrerequisite[]): Promise<void>;
+export {};

package/lib/services/web-fragment.js

@@ -0,0 +1,245 @@
+import { isDeepStrictEqual } from 'node:util';
+const WEB_FRAGMENT_TYPE = 'sfdc_cms__webFragment';
+const DATA_GRAPH_PROVIDER = 'sfdc_cms__dataGraphDataProvider';
+const BODY_KEYS = [
+    'lightning:backgroundImage',
+    'lightning:brandSource',
+    'lightning:dataProviders',
+    'lightning:expressions',
+    'sfdc_cms:block',
+    'sfdc_cms:title',
+    'sfdc_cms:variants',
+];
+const BACKGROUND_IMAGE = { position: 'center center', repeat: 'no-repeat', size: 'cover' };
+function record(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function exactKeys(value, expected, label) {
+    if (Object.keys(value).toSorted().join('\0') !== [...expected].toSorted().join('\0')) {
+        throw new TypeError(`${label} must contain exactly ${expected.join(', ')}`);
+    }
+}
+function nonempty(value, label) {
+    if (typeof value !== 'string' || value.trim().length === 0) {
+        throw new TypeError(`${label} must be a nonempty string`);
+    }
+}
+function identifier(value, label) {
+    nonempty(value, label);
+    if (!/^[A-Za-z][A-Za-z\d_]*$/u.test(value)) {
+        throw new TypeError(`${label} must be an exact developer/API name`);
+    }
+}
+function dataSpace(value, label) {
+    nonempty(value, label);
+    if (!/^[A-Za-z][A-Za-z\d_]*$/u.test(value)) {
+        throw new TypeError(`${label} must be an exact data-space developer name`);
+    }
+}
+function assertBlock(value) {
+    if (!record(value))
+        throw new TypeError('Web fragment sfdc_cms:block must be an object');
+    if (value.definition !== 'sfdc_cms/rootContentBlock' || value.type !== 'block') {
+        throw new TypeError('Web fragment root block definition/type is unsupported');
+    }
+    nonempty(value.id, 'Web fragment root block id');
+    if (!Array.isArray(value.children))
+        throw new TypeError('Web fragment root children must be an array');
+}
+function provider(value, label) {
+    if (!record(value))
+        throw new TypeError(`${label} must be an object`);
+    exactKeys(value, ['attributes', 'definition', 'sfdcExpressionKey'], label);
+    if (value.definition !== DATA_GRAPH_PROVIDER || value.sfdcExpressionKey !== '$dataGraph') {
+        throw new TypeError(`${label} must use the exact Data Graph provider definition`);
+    }
+    if (!record(value.attributes))
+        throw new TypeError(`${label}.attributes must be an object`);
+    exactKeys(value.attributes, ['dataGraphApiName', 'dataspace'], `${label}.attributes`);
+    identifier(value.attributes.dataGraphApiName, `${label}.attributes.dataGraphApiName`);
+    dataSpace(value.attributes.dataspace, `${label}.attributes.dataspace`);
+    return {
+        developerName: value.attributes.dataGraphApiName,
+        dataSpace: value.attributes.dataspace,
+    };
+}
+/**
+ * Validate the evidenced landing-page content-block shape.
+ * @param {WorkspaceImportItem} item - Integrity-verified web-fragment item.
+ * @returns {{developerName: string, dataSpace: string}[]} Exact named Data Graph prerequisites.
+ */
+export function assertWebFragmentItem(item) {
+    if (item.contentType !== WEB_FRAGMENT_TYPE) {
+        throw new TypeError(`Web fragment profile requires exact content type ${WEB_FRAGMENT_TYPE}`);
+    }
+    identifier(item.apiName, 'Web fragment apiName');
+    nonempty(item.title, 'Web fragment title');
+    exactKeys(item.contentBody, BODY_KEYS, 'Web fragment contentBody');
+    if (item.contentBody['sfdc_cms:title'] !== item.title) {
+        throw new TypeError('Web fragment body title must match the top-level title');
+    }
+    if (!isDeepStrictEqual(item.contentBody['lightning:brandSource'], {
+        defaultBrandOption: 'sfdcBrand',
+    })) {
+        throw new TypeError('Web fragment brand source must match the evidenced Salesforce-brand profile');
+    }
+    if (!isDeepStrictEqual(item.contentBody['lightning:backgroundImage'], BACKGROUND_IMAGE)) {
+        throw new TypeError('Web fragment background image must match the evidenced profile');
+    }
+    if (!Array.isArray(item.contentBody['lightning:expressions'])) {
+        throw new TypeError('Web fragment lightning:expressions must be an array');
+    }
+    if (!Array.isArray(item.contentBody['sfdc_cms:variants'])) {
+        throw new TypeError('Web fragment sfdc_cms:variants must be an array');
+    }
+    assertBlock(item.contentBody['sfdc_cms:block']);
+    const providers = item.contentBody['lightning:dataProviders'];
+    if (!Array.isArray(providers) || providers.length === 0) {
+        throw new TypeError('Web fragment requires at least one exact named Data Graph provider');
+    }
+    const prerequisites = providers.map((value, index) => provider(value, `Data Graph provider ${index}`));
+    const identities = new Set(prerequisites.map(({ developerName, dataSpace: space }) => `${developerName}\0${space}`));
+    if (identities.size !== prerequisites.length) {
+        throw new TypeError('Web fragment Data Graph providers must be unique');
+    }
+    return prerequisites;
+}
+function mappingRows(value) {
+    if (!Array.isArray(value) || value.length === 0 || value.some((row) => !record(row))) {
+        throw new TypeError('Web fragment mappings must be a nonempty array of objects');
+    }
+    return value;
+}
+/**
+ * Plan one or many exact type-qualified web-fragment creates.
+ * @param {LoadedWorkspaceExport} source - Integrity-verified workspace package.
+ * @param {unknown} input - Explicit source, target, and Data Graph map rows.
+ * @returns {PlannedWebFragmentCopies} Selected creates and exact prerequisite evidence.
+ */
+export function planWebFragmentCopies(source, input) {
+    if (!source.integrity.verified)
+        throw new TypeError('Source integrity must be verified first');
+    const sourceKeys = new Set(source.items.map((item) => item.contentKey));
+    const sourceNames = new Set(source.items.flatMap((item) => (item.apiName === undefined ? [] : [item.apiName])));
+    const targetKeys = new Set();
+    const targetNames = new Set();
+    const selected = new Set();
+    const items = [];
+    const dataGraphs = [];
+    for (const [index, row] of mappingRows(input).entries()) {
+        exactKeys(row, ['source', 'target', 'dataGraphs'], `Web fragment mapping ${index}`);
+        if (!record(row.source))
+            throw new TypeError(`Web fragment mapping ${index}.source must be an object`);
+        exactKeys(row.source, ['family', 'type', 'apiName'], `Web fragment mapping ${index}.source`);
+        if (row.source.family !== 'cms' || row.source.type !== 'webFragment') {
+            throw new TypeError(`Web fragment mapping ${index}.source must select cms/webFragment`);
+        }
+        identifier(row.source.apiName, `Web fragment mapping ${index}.source.apiName`);
+        const sourceApiName = row.source.apiName;
+        if (selected.has(sourceApiName))
+            throw new TypeError(`Duplicate web fragment selection: ${sourceApiName}`);
+        const matches = source.items.filter((item) => item.contentType === WEB_FRAGMENT_TYPE && item.apiName === sourceApiName);
+        if (matches.length !== 1) {
+            throw new TypeError(`Typed source API name must match exactly one web fragment: ${sourceApiName}`);
+        }
+        const item = matches[0];
+        const sourcePrerequisites = assertWebFragmentItem(item);
+        if (!record(row.target))
+            throw new TypeError(`Web fragment mapping ${index}.target must be an object`);
+        exactKeys(row.target, ['contentKey', 'apiName'], `Web fragment mapping ${index}.target`);
+        identifier(row.target.contentKey, `Web fragment mapping ${index}.target.contentKey`);
+        identifier(row.target.apiName, `Web fragment mapping ${index}.target.apiName`);
+        const contentKey = row.target.contentKey;
+        const apiName = row.target.apiName;
+        if (sourceKeys.has(contentKey) || targetKeys.has(contentKey)) {
+            throw new TypeError('Target web fragment content keys must be fresh and unique');
+        }
+        if (sourceNames.has(apiName) || targetNames.has(apiName)) {
+            throw new TypeError('Target web fragment API names must be fresh and unique');
+        }
+        if (!Array.isArray(row.dataGraphs) || row.dataGraphs.length !== sourcePrerequisites.length) {
+            throw new TypeError('Each source Data Graph prerequisite requires exactly one mapping row');
+        }
+        const mapped = new Map();
+        for (const [graphIndex, raw] of row.dataGraphs.entries()) {
+            if (!record(raw))
+                throw new TypeError(`Web fragment mapping ${index}.dataGraphs[${graphIndex}] must be an object`);
+            exactKeys(raw, ['sourceDeveloperName', 'sourceDataSpace', 'targetDeveloperName', 'targetDataSpace'], `Web fragment mapping ${index}.dataGraphs[${graphIndex}]`);
+            identifier(raw.sourceDeveloperName, 'sourceDeveloperName');
+            dataSpace(raw.sourceDataSpace, 'sourceDataSpace');
+            identifier(raw.targetDeveloperName, 'targetDeveloperName');
+            dataSpace(raw.targetDataSpace, 'targetDataSpace');
+            const key = `${raw.sourceDeveloperName}\0${raw.sourceDataSpace}`;
+            if (mapped.has(key))
+                throw new TypeError('Duplicate Data Graph source mapping');
+            mapped.set(key, {
+                sourceDeveloperName: raw.sourceDeveloperName,
+                sourceDataSpace: raw.sourceDataSpace,
+                targetDeveloperName: raw.targetDeveloperName,
+                targetDataSpace: raw.targetDataSpace,
+                resolution: raw.sourceDeveloperName === raw.targetDeveloperName &&
+                    raw.sourceDataSpace === raw.targetDataSpace
+                    ? 'preserved'
+                    : 'explicit-map',
+                validationStatus: 'pending',
+            });
+        }
+        for (const prerequisite of sourcePrerequisites) {
+            if (!mapped.has(`${prerequisite.developerName}\0${prerequisite.dataSpace}`)) {
+                throw new TypeError(`Missing exact Data Graph mapping for ${prerequisite.developerName}/${prerequisite.dataSpace}`);
+            }
+        }
+        const providers = item.contentBody['lightning:dataProviders'].map((value) => {
+            const identity = provider(value, 'Data Graph provider');
+            const target = mapped.get(`${identity.developerName}\0${identity.dataSpace}`);
+            return {
+                ...value,
+                attributes: {
+                    dataGraphApiName: target.targetDeveloperName,
+                    dataspace: target.targetDataSpace,
+                },
+            };
+        });
+        selected.add(sourceApiName);
+        targetKeys.add(contentKey);
+        targetNames.add(apiName);
+        dataGraphs.push(...mapped.values());
+        items.push({
+            ...item,
+            apiName,
+            contentKey,
+            contentBody: { ...item.contentBody, 'lightning:dataProviders': providers },
+        });
+    }
+    return {
+        items: items.toSorted((left, right) => left.apiName.localeCompare(right.apiName)),
+        targetContentKeys: [...targetKeys].toSorted(),
+        dataGraphs: dataGraphs.toSorted((left, right) => `${left.targetDeveloperName}\0${left.targetDataSpace}`.localeCompare(`${right.targetDeveloperName}\0${right.targetDataSpace}`)),
+    };
+}
+function soqlString(value) {
+    return `'${value.replaceAll('\\', '\\\\').replaceAll("'", String.raw `\'`)}'`;
+}
+/**
+ * Prove each exact target Data Graph developer-name/data-space pair exists uniquely.
+ * @param {QueryConnection} connection - Destination org query transport.
+ * @param {readonly WebFragmentDataGraphPrerequisite[]} prerequisites - Exact target prerequisites.
+ * @returns {Promise<void>} Fulfilled only when every prerequisite resolves exactly once.
+ */
+export async function validateDataGraphPrerequisites(connection, prerequisites) {
+    if (connection.query === undefined) {
+        throw new TypeError('Destination Data Graph prerequisites cannot be queried');
+    }
+    const unique = new Map(prerequisites.map((value) => [`${value.targetDeveloperName}\0${value.targetDataSpace}`, value]));
+    for (const prerequisite of unique.values()) {
+        const result = await connection.query(`SELECT DeveloperName, DataSpaceDevName FROM DataGraph WHERE DeveloperName = ${soqlString(prerequisite.targetDeveloperName)} AND DataSpaceDevName = ${soqlString(prerequisite.targetDataSpace)}`);
+        const matches = result.records.filter((record) => record.DeveloperName === prerequisite.targetDeveloperName &&
+            record.DataSpaceDevName === prerequisite.targetDataSpace);
+        if (result.totalSize !== 1 || result.records.length !== 1 || matches.length !== 1) {
+            prerequisite.validationStatus = 'failed';
+            throw new TypeError(`Data Graph prerequisite must resolve exactly once: ${prerequisite.targetDeveloperName}/${prerequisite.targetDataSpace}`);
+        }
+        prerequisite.validationStatus = 'passed';
+    }
+}
+//# sourceMappingURL=web-fragment.js.map

package/lib/services/web-fragment.js.map

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

package/lib/transport/experimental-media.d.ts

@@ -0,0 +1,30 @@
+import type { FileHandle } from 'node:fs/promises';
+export declare const EXPERIMENTAL_MEDIA_POLICY: {
+    readonly approvedRedirectSuffix: "file.force.com";
+    readonly maxRedirects: 3;
+    readonly perImageBytes: number;
+    readonly totalBytes: number;
+};
+export type ExperimentalMediaDownload = {
+    readonly bytes: number;
+    readonly contentLength?: number;
+    readonly md5: string;
+    readonly mimeType: string;
+    readonly sha256: string;
+};
+type ExperimentalMediaFileHandle = Pick<FileHandle, 'close' | 'write'>;
+export type ExperimentalMediaDownloadOptions = {
+    readonly accessToken: string;
+    readonly expectedMd5: string;
+    readonly expectedMimeType: string;
+    readonly expectedSize: number;
+    readonly fetch?: typeof fetch;
+    readonly instanceUrl: string;
+    readonly maxBytes?: number;
+    readonly openFile?: (file: string) => Promise<ExperimentalMediaFileHandle>;
+    readonly outputFile: string;
+    readonly unlinkFile?: (file: string) => Promise<void>;
+};
+export declare function isApprovedSalesforceMediaUrl(value: string | URL): boolean;
+export declare function downloadExperimentalCmsMedia(source: URL, options: ExperimentalMediaDownloadOptions): Promise<ExperimentalMediaDownload>;
+export {};