platform-types 1.10.745 → 1.10.747

package/dist/cjs/store.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.STORE_PATCH_ERROR_CODES = exports.STORE_MODULE_ERROR_CODES = exports.isStoreModuleOn = exports.isStoreModuleKey = exports.STORE_MODULE_KEYS = exports.CUSTOM_DOMAIN_ROW_LIMIT = exports.CUSTOM_DOMAIN_SLOT_LIMIT = void 0;
+exports.STORE_PATCH_ERROR_CODES = exports.STORE_MODULE_ERROR_CODES = exports.isStoreModuleOn = exports.isStoreModuleKey = exports.STORE_MODULE_KEYS = exports.STORE_ONBOARDING_REVIEW_AREAS = exports.CUSTOM_DOMAIN_ROW_LIMIT = exports.CUSTOM_DOMAIN_SLOT_LIMIT = void 0;
 /**
  * How many custom-domain rows a store may hold that count: one active domain
  * and one spare, so a replacement can be verified and provisioned before the
@@ -18,6 +18,11 @@ exports.CUSTOM_DOMAIN_SLOT_LIMIT = 2;
  * `409 DOMAIN_ROW_LIMIT` with this value as `limit`.
  */
 exports.CUSTOM_DOMAIN_ROW_LIMIT = 10;
+/**
+ * Every `StoreOnboardingReviewArea` — the ONE list. `PATCH /store` validates
+ * `config.onboarding.reviewed` against it, so an area is added in one place.
+ */
+exports.STORE_ONBOARDING_REVIEW_AREAS = ['payments', 'delivery', 'pricing'];
 /**
  * Every `StoreModuleKey`, in catalogue order — the ONE list. The type is derived
  * from it, so the `PATCH /store` validator and every client enumerate exactly

package/dist/platform.d.ts

@@ -449,7 +449,13 @@ export interface TenantHealthEnvelope {
         certBand: CertBand | null;
     };
     integrations: {
-        /** Presence and expiry ONLY — never the OAuth tokens. */
+        /**
+         * Presence and expiry ONLY — never the OAuth tokens. Read from the nested
+         * `integrations.mercadopago` leaf only, never the legacy flat blob.
+         * `connected` means linked: a `userId` is present and the automatic
+         * revocation has not stamped `disconnectedAt`. It stays `true` after
+         * `oauthExpiresAt` passes — that epoch is what grades a lapsing grant.
+         */
         mercadopago: {
             connected: boolean;
             oauthExpiresAt: number | null;

package/dist/store.d.ts

@@ -1,6 +1,8 @@
 import type { ArgentineProvince } from './provinces.ts';
 import type { StorefrontLiveSettingKey } from './storefrontDesignRegistry.ts';
 declare global {
+    /** A seeded setup area the admin confirmed in the onboarding checklist — one of `STORE_ONBOARDING_REVIEW_AREAS`. */
+    type StoreOnboardingReviewArea = (typeof STORE_ONBOARDING_REVIEW_AREAS)[number];
     /**
      * One tenant-authored Cmd-K palette entry (`store.palette.custom[]`).
      *
@@ -872,11 +874,15 @@ declare global {
             /**
              * Guided-setup onboarding progress (ADR-0020). First-login is derived
              * FE-side (absent, or neither `completed` nor `skipped` ⇒ show wizard).
+             * `reviewed` lists the seeded setup areas the admin confirmed with «Ya
+             * lo revisé»; absent ⇒ none reviewed. The block is replaced wholesale on
+             * `PATCH /store`, so a writer must carry `reviewed` forward.
              */
             onboarding?: {
                 step: number;
                 completed: boolean;
                 skipped: boolean;
+                reviewed?: StoreOnboardingReviewArea[];
             };
             /**
              * Store-level configuration for GENERATED internal barcodes (products that
@@ -1288,7 +1294,9 @@ declare global {
         liveMode?: boolean;
         /** @deprecated Never populated: the OAuth callback drops the token response's `public_key` and no other writer exists (sanitizers deliberately treat it as non-secret, but nothing writes it). */
         publicKey?: string;
+        /** @deprecated Never populated: no writer stamps it. Derive the connection from `userId`, `disconnectedAt` and `expiresAt`. */
         status?: MercadopagoConnectionStatus;
+        /** unix ms; set by the automatic revocation, which keeps `userId`. The tenant disconnect removes the whole leaf instead. */
         disconnectedAt?: number;
         lastTokenRefreshAt?: number;
         tokenRefreshFailures?: number;
@@ -2107,6 +2115,11 @@ export declare const CUSTOM_DOMAIN_SLOT_LIMIT = 2;
  * `409 DOMAIN_ROW_LIMIT` with this value as `limit`.
  */
 export declare const CUSTOM_DOMAIN_ROW_LIMIT = 10;
+/**
+ * Every `StoreOnboardingReviewArea` — the ONE list. `PATCH /store` validates
+ * `config.onboarding.reviewed` against it, so an area is added in one place.
+ */
+export declare const STORE_ONBOARDING_REVIEW_AREAS: readonly ["payments", "delivery", "pricing"];
 /**
  * Every `StoreModuleKey`, in catalogue order — the ONE list. The type is derived
  * from it, so the `PATCH /store` validator and every client enumerate exactly

package/dist/store.js

@@ -15,6 +15,11 @@ export const CUSTOM_DOMAIN_SLOT_LIMIT = 2;
  * `409 DOMAIN_ROW_LIMIT` with this value as `limit`.
  */
 export const CUSTOM_DOMAIN_ROW_LIMIT = 10;
+/**
+ * Every `StoreOnboardingReviewArea` — the ONE list. `PATCH /store` validates
+ * `config.onboarding.reviewed` against it, so an area is added in one place.
+ */
+export const STORE_ONBOARDING_REVIEW_AREAS = ['payments', 'delivery', 'pricing'];
 /**
  * Every `StoreModuleKey`, in catalogue order — the ONE list. The type is derived
  * from it, so the `PATCH /store` validator and every client enumerate exactly

package/package.json

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