platform-types 1.10.681 → 1.10.683

package/dist/cjs/storefrontDesign.js

@@ -16,6 +16,7 @@ exports.STOREFRONT_DESIGN_LIMITS = {
     faqs: 20,
     benefits: 8,
     historyEntries: 20,
+    selectedSourceIds: 50,
     documentBytes: 256 * 1024,
     heading: 120,
     label: 80,

package/dist/storefrontDesign.d.ts

@@ -1,3 +1,4 @@
+import type { StorefrontThemeWarning } from './storefrontTheme.ts';
 export declare const STOREFRONT_DESIGN_LIMITS: {
     readonly customPages: 20;
     readonly sectionsPerPage: 10;
@@ -12,6 +13,7 @@ export declare const STOREFRONT_DESIGN_LIMITS: {
     readonly faqs: 20;
     readonly benefits: 8;
     readonly historyEntries: 20;
+    readonly selectedSourceIds: 50;
     readonly documentBytes: number;
     readonly heading: 120;
     readonly label: 80;
@@ -273,7 +275,7 @@ declare global {
         path: string;
         code: StorefrontDesignFieldErrorCode;
     }
-    type StorefrontDesignErrorCode = 'STOREFRONT_DESIGN_INVALID' | 'STOREFRONT_SCHEMA_UNSUPPORTED' | 'STOREFRONT_REVISION_CONFLICT' | 'STOREFRONT_REQUEST_EXPIRED' | 'IDEMPOTENCY_CONFLICT' | 'STOREFRONT_EDITOR_REQUIRED' | 'STOREFRONT_ASSET_NOT_READY' | 'STOREFRONT_PREVIEW_EXPIRED' | 'STOREFRONT_PREVIEW_REVOKED' | 'STOREFRONT_PREVIEW_FORBIDDEN';
+    type StorefrontDesignErrorCode = 'STOREFRONT_DESIGN_INVALID' | 'STOREFRONT_SCHEMA_UNSUPPORTED' | 'STOREFRONT_REVISION_CONFLICT' | 'STOREFRONT_DRAFT_NOT_INITIALIZED' | 'STOREFRONT_REQUEST_EXPIRED' | 'STOREFRONT_PUBLICATION_NOT_FOUND' | 'STOREFRONT_OPERATION_NOT_FOUND' | 'STOREFRONT_DRAFT_UNAVAILABLE' | 'IDEMPOTENCY_CONFLICT' | 'STOREFRONT_EDITOR_REQUIRED' | 'STOREFRONT_ASSET_NOT_READY' | 'STOREFRONT_PREVIEW_EXPIRED' | 'STOREFRONT_PREVIEW_REVOKED' | 'STOREFRONT_PREVIEW_FORBIDDEN';
     interface StorefrontDesignMappingConflict {
         path: string;
         code: 'LEGACY_MULTIPLE_PRODUCT_FEEDS' | 'LEGACY_UNMAPPED_CONTENT';
@@ -304,6 +306,7 @@ declare global {
     }
     type StorefrontDesignSaveInput = StorefrontDesignRevisionInput & {
         document: StorefrontDesignV1;
+        resolvedMappingConflictPaths?: string[];
     };
     type StorefrontDesignRestoreInput = StorefrontDesignRevisionInput & {
         publicationId: string;
@@ -313,19 +316,56 @@ declare global {
     interface StorefrontDesignPreviewInput {
         draftRevision: string;
     }
+    interface StorefrontDesignBaselineResult {
+        draftRevision: null;
+        publishedRevision: null;
+        document: StorefrontDesignV1;
+        dirty: false;
+        mappingConflicts: StorefrontDesignMappingConflict[];
+        legacySourceRevision: string;
+    }
+    interface StorefrontDesignHistoryEntry {
+        publicationId: string;
+        committedRevision: string;
+        /**
+         * The publishing tenant ADMIN's authorizer user id (`USR…`), the same id a
+         * store user list carries — resolve it to a name there. Never an email,
+         * display name or system sentinel: the store-level `LEGACY_LOGO` actor exists
+         * only on private media receipts and never reaches history.
+         */
+        actor: string;
+        committedAt: string;
+    }
+    interface StorefrontDesignHistoryQuery {
+        limit?: number;
+        cursor?: string;
+    }
+    interface StorefrontDesignHistoryPage {
+        items: StorefrontDesignHistoryEntry[];
+        cursor?: string;
+    }
     interface StorefrontDesignDraftResult {
         draftRevision: string;
         publishedRevision: string | null;
         document: StorefrontDesignV1;
         dirty: boolean;
         mappingConflicts: StorefrontDesignMappingConflict[];
+        legacySourceRevision: string;
     }
     interface StorefrontDesignDeliveryTarget {
+        /**
+         * Opaque per-target key, stable for one publication (`platform`, `customDomain-1`, …).
+         * Never a provider or CDN id; clients may only compare it, never parse it.
+         */
         targetId: string;
         state: 'pending' | 'retrying' | 'completed' | 'notProvisioned';
-        providerOperationId?: string;
     }
+    type StorefrontDesignPublishOperationResult = StorefrontDesignPublishResult;
+    type StorefrontDesignPublishOperationResponse = StorefrontDesignPublishResponse;
     interface StorefrontDesignPublishResult {
+        changeSummary: {
+            contrastAdjustments: StorefrontThemeWarning[];
+        };
         publicationId: string;
         committedRevision: string;
         draftRevision: string;
@@ -378,7 +418,11 @@ declare global {
     };
     type StorefrontDesignDraftResponse = {
         message: string;
-        data: StorefrontDesignDraftResult;
+        data: StorefrontDesignDraftResult | StorefrontDesignBaselineResult;
+    } | StorefrontDesignFailure;
+    type StorefrontDesignHistoryResponse = {
+        message: string;
+        data: StorefrontDesignHistoryPage;
     } | StorefrontDesignFailure;
     type StorefrontDesignPublishResponse = {
         message: string;

package/dist/storefrontDesign.js

@@ -12,6 +12,7 @@ export const STOREFRONT_DESIGN_LIMITS = {
     faqs: 20,
     benefits: 8,
     historyEntries: 20,
+    selectedSourceIds: 50,
     documentBytes: 256 * 1024,
     heading: 120,
     label: 80,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "platform-types",
-	"version": "1.10.681",
+	"version": "1.10.683",
 	"description": "Shared wire and entity contracts for the platform.",
 	"type": "module",
 	"main": "dist/index.js",