platform-types 1.10.680 → 1.10.682

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/store.d.ts

@@ -892,6 +892,13 @@ declare global {
          *   value refetches `GET /store` to see those.
          */
         publicStorefront?: PublicStorefront | null;
+        /**
+         * Server-built public contact on web GET /store and customer STORE frames.
+         * Absent means an older API; an empty object means no validated public
+         * targets. Private fields are omitted. Before design adoption, only the
+         * email/phone pair explicitly consented by config.publicContact is used.
+         */
+        publicContact?: StorefrontPublicContact;
         /** Read-only legacy editor seed, available only to the entitled tenant ADMIN. */
         storefrontEditorBaseline?: StorefrontEditorBaseline;
         photoURL: string;

package/dist/storefrontDesign.d.ts

@@ -12,6 +12,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;
@@ -229,6 +230,30 @@ declare global {
             value: StorefrontDesignContactValues[K];
         };
     };
+    /** Public overrides only. Missing, private, empty and invalid fields are omitted by the server. */
+    interface StorefrontPublicContact {
+        email?: string;
+        /** Explicit +E.164 (8–15 digits); the server never guesses a country code. */
+        phone?: {
+            number: string;
+            url: `tel:${string}`;
+        };
+        /** Same E.164 number, with a digits-only wa.me path and no platform fallback. */
+        whatsapp?: {
+            number: string;
+            url: `https://wa.me/${string}`;
+        };
+        /** Plain display text; renderers must escape markup. Independent of fiscal/legal identity. */
+        address?: string;
+        /** Rows may repeat days or overlap to represent split shifts; overnight hours use separate rows. */
+        hours?: StorefrontContactHours;
+        /** At most one account per kind (six kinds), with an approved HTTPS destination. */
+        socials?: StorefrontContactSocial[];
+    }
+    /** Published design projection; contact values contain normalized destinations without author visibility wrappers. */
+    type StorefrontDesignPublic = Omit<StorefrontDesignV1, 'contact'> & {
+        contact: StorefrontPublicContact;
+    };
     interface StorefrontDesignV1 {
         schemaVersion: 1;
         templateId: 'standard';
@@ -249,7 +274,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_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';
@@ -280,6 +305,7 @@ declare global {
     }
     type StorefrontDesignSaveInput = StorefrontDesignRevisionInput & {
         document: StorefrontDesignV1;
+        resolvedMappingConflictPaths?: string[];
     };
     type StorefrontDesignRestoreInput = StorefrontDesignRevisionInput & {
         publicationId: string;
@@ -289,12 +315,41 @@ 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 {
         targetId: string;
@@ -354,7 +409,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.680",
+	"version": "1.10.682",
 	"description": "Shared wire and entity contracts for the platform.",
 	"type": "module",
 	"main": "dist/index.js",