platform-types 1.10.795 → 1.10.797

package/dist/cjs/paymentAttempt.js

@@ -19,7 +19,7 @@
  * no operator write can carry it back onto the order.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PAYMENT_HOLD_MINUTES_DEFAULT = exports.PAYMENT_HOLD_MINUTES_MAX = exports.PAYMENT_HOLD_MINUTES_MIN = exports.PAYMENT_ATTEMPT_RESOLUTION_CAUSES = exports.ORDER_NOT_PAYABLE_REASONS = exports.PAYMENT_ATTEMPT_RESOLUTION_REASON_MAX = exports.PAYMENT_ATTEMPT_RESOLUTION_OUTCOMES = exports.PAYMENT_ATTEMPT_ERROR_CODES = exports.PAYMENT_ATTEMPT_STATES = void 0;
+exports.PAYMENT_HOLD_MINUTES_DEFAULT = exports.PAYMENT_HOLD_MINUTES_MAX = exports.PAYMENT_HOLD_MINUTES_MIN = exports.PAYMENT_ATTEMPT_RESOLUTION_CAUSES = exports.ORDER_NOT_PAYABLE_REASONS = exports.PAYMENT_ATTEMPT_RESOLUTION_REASON_MAX = exports.PAYMENT_ATTEMPT_RESOLUTION_OUTCOMES = exports.GUEST_PAYMENT_ERROR_CODES = exports.PAYMENT_ATTEMPT_ERROR_CODES = exports.PAYMENT_ATTEMPT_STATES = void 0;
 /** Every {@link PaymentAttemptState}, in lifecycle order. */
 exports.PAYMENT_ATTEMPT_STATES = [
     'created',
@@ -71,6 +71,20 @@ exports.PAYMENT_ATTEMPT_ERROR_CODES = [
     'PAYMENT_ATTEMPT_NOT_IN_RESOLUTION',
     'PAYMENT_ATTEMPT_CHANGED',
 ];
+/**
+ * The refusal the guest payment start (`POST /payments/attempts/guest`) answers
+ * itself, beside every {@link PAYMENT_ATTEMPT_ERROR_CODES} entry it shares with
+ * the signed-in start.
+ *
+ * - `GUEST_PAYMENT_GRANT_INVALID` · 401 — every reason the grant cannot be
+ *   honoured: missing, tampered, another version (a guest STATUS token
+ *   included), expired (7 days after it was issued), minted for another order
+ *   or another store, presented on another store's host, or naming an order
+ *   that is not — or is no longer — an unattached guest order (attached to an
+ *   account, its buyer then pays signed in). One identical body, so the grant is
+ *   never an oracle.
+ */
+exports.GUEST_PAYMENT_ERROR_CODES = ['GUEST_PAYMENT_GRANT_INVALID'];
 /**
  * Every `outcome` of {@link ResolvePaymentAttemptRequest}:
  *

package/dist/order.d.ts

@@ -2494,6 +2494,24 @@ declare global {
         expectedCartId: string;
         expectedCartVersion: number;
     }
+    /**
+     * `data` of a successful Web `POST /orders/guest`: the placed order, as the
+     * signed-in checkout answers it (the storefront reads `orderId`), plus the
+     * guest's payment grant.
+     */
+    interface StorefrontGuestOrderCreateResponse extends Partial<Order> {
+        orderId: string;
+        /**
+         * The guest payment grant (`gp1.…`) for THIS order, valid 7 days: the
+         * credential `POST /payments/attempts/guest` takes
+         * ({@link StartGuestPaymentAttemptRequest}). Present only when the order
+         * can be paid online when the answer is built (its payment method row
+         * declares `storefront: 'mp-checkout-pro'`, pesos, something to charge) and
+         * the grant could be minted; absent otherwise. A replay of the checkout
+         * answers a freshly minted one. Keep it in memory or the URL fragment only.
+         */
+        paymentGrant?: string;
+    }
     interface ZebraTag {
         orderId: string;
         fullName: string;

package/dist/paymentAttempt.d.ts

@@ -57,6 +57,8 @@ declare global {
     type PaymentAttemptState = (typeof PAYMENT_ATTEMPT_STATES)[number];
     /** One of {@link PAYMENT_ATTEMPT_ERROR_CODES}. */
     type PaymentAttemptErrorCode = (typeof PAYMENT_ATTEMPT_ERROR_CODES)[number];
+    /** One of {@link GUEST_PAYMENT_ERROR_CODES}. */
+    type GuestPaymentErrorCode = (typeof GUEST_PAYMENT_ERROR_CODES)[number];
     /** One of {@link ORDER_NOT_PAYABLE_REASONS}. */
     type OrderNotPayableReason = (typeof ORDER_NOT_PAYABLE_REASONS)[number];
     /** One of {@link PAYMENT_ATTEMPT_RESOLUTION_CAUSES}. */
@@ -71,6 +73,22 @@ declare global {
     interface StartPaymentAttemptRequest {
         orderId: string;
     }
+    /**
+     * Web `POST /payments/attempts/guest` body: a buyer with NO account starts
+     * (or gets back the live) payment attempt of one guest order. Answers
+     * {@link StartPaymentAttemptResponse}, with every {@link PAYMENT_ATTEMPT_ERROR_CODES}
+     * refusal the signed-in start answers, plus {@link GUEST_PAYMENT_ERROR_CODES}.
+     */
+    interface StartGuestPaymentAttemptRequest {
+        orderId: string;
+        /**
+         * The guest payment grant (`gp1.…`) the guest checkout answered
+         * (`StorefrontGuestOrderCreateResponse.paymentGrant`) or the order email's
+         * "Pagar" link carried in its `#pagar=` fragment. A bearer credential:
+         * never put it in a URL a server or Mercado Pago sees, nor in `back_urls`.
+         */
+        paymentGrant: string;
+    }
     /** `data` of a successful start. A repeat start while the attempt is live answers the same `attemptId`. */
     interface StartPaymentAttemptResponse {
         attemptId: string;
@@ -237,6 +255,20 @@ export declare const PAYMENT_ATTEMPT_STATES: readonly ["created", "pending", "ap
  *   written; `data` is {@link PaymentAttemptChangedData}.
  */
 export declare const PAYMENT_ATTEMPT_ERROR_CODES: readonly ["PAYMENT_PROVIDER_NOT_CONNECTED", "PAYMENT_PROVIDER_TOKEN_EXPIRED", "ORDER_NOT_PAYABLE", "PAYMENT_ATTEMPT_EXPIRED", "PAYMENT_METHOD_UNAVAILABLE", "MP_PREFERENCE_CREATE_FAILED", "PAYMENT_ATTEMPT_NOT_FOUND", "PAYMENT_ATTEMPT_NOT_IN_RESOLUTION", "PAYMENT_ATTEMPT_CHANGED"];
+/**
+ * The refusal the guest payment start (`POST /payments/attempts/guest`) answers
+ * itself, beside every {@link PAYMENT_ATTEMPT_ERROR_CODES} entry it shares with
+ * the signed-in start.
+ *
+ * - `GUEST_PAYMENT_GRANT_INVALID` · 401 — every reason the grant cannot be
+ *   honoured: missing, tampered, another version (a guest STATUS token
+ *   included), expired (7 days after it was issued), minted for another order
+ *   or another store, presented on another store's host, or naming an order
+ *   that is not — or is no longer — an unattached guest order (attached to an
+ *   account, its buyer then pays signed in). One identical body, so the grant is
+ *   never an oracle.
+ */
+export declare const GUEST_PAYMENT_ERROR_CODES: readonly ["GUEST_PAYMENT_GRANT_INVALID"];
 /**
  * Every `outcome` of {@link ResolvePaymentAttemptRequest}:
  *

package/dist/paymentAttempt.js

@@ -68,6 +68,20 @@ export const PAYMENT_ATTEMPT_ERROR_CODES = [
     'PAYMENT_ATTEMPT_NOT_IN_RESOLUTION',
     'PAYMENT_ATTEMPT_CHANGED',
 ];
+/**
+ * The refusal the guest payment start (`POST /payments/attempts/guest`) answers
+ * itself, beside every {@link PAYMENT_ATTEMPT_ERROR_CODES} entry it shares with
+ * the signed-in start.
+ *
+ * - `GUEST_PAYMENT_GRANT_INVALID` · 401 — every reason the grant cannot be
+ *   honoured: missing, tampered, another version (a guest STATUS token
+ *   included), expired (7 days after it was issued), minted for another order
+ *   or another store, presented on another store's host, or naming an order
+ *   that is not — or is no longer — an unattached guest order (attached to an
+ *   account, its buyer then pays signed in). One identical body, so the grant is
+ *   never an oracle.
+ */
+export const GUEST_PAYMENT_ERROR_CODES = ['GUEST_PAYMENT_GRANT_INVALID'];
 /**
  * Every `outcome` of {@link ResolvePaymentAttemptRequest}:
  *

package/dist/product.d.ts

@@ -30,7 +30,8 @@ declare global {
         unitRevision: number;
     }
     type ProductUnitsInput = Omit<ProductUnits, 'unitRevision'>;
-    type PublicProductUnits = Pick<ProductUnits, 'baseUnit' | 'purchaseUnit' | 'packLabel'>;
+    /** The display declaration plus the purchase-unit factor; `unitRevision` stays server-only. */
+    type PublicProductUnits = Pick<ProductUnits, 'baseUnit' | 'purchaseUnit' | 'packLabel' | 'baseUnitsPerPurchaseUnit'>;
     type PublicProduct = Omit<Partial<Product>, 'units' | 'unitRevisionGeneration'> & {
         units?: PublicProductUnits | null;
     };

package/dist/store.d.ts

@@ -528,6 +528,52 @@ declare global {
         /** Unix ms — when the retired label's redirect ends (its reservation end). */
         redirectUntil?: number;
     }
+    /** An identity or withdrawal fact {@link StorePublicLegal} could not resolve; the storefront warns or degrades on it. */
+    type StorePublicLegalMissing = 'razonSocial' | 'fiscalAddress' | 'email' | 'phone' | 'withdrawalChannel';
+    /**
+     * The consumer-law facts a storefront renders: the merchant identity disclosure, the
+     * Botón de Arrepentimiento and the privacy-text variants. Built by the api at read time
+     * from the STORE row, never stored or writable, and never inferred from a price list's
+     * `audienceClass` — every caller of one store sees the same block.
+     */
+    interface StorePublicLegal {
+        identity: {
+            /** `integrations.afip.razonSocial` trimmed, else `Store.name` (the invoice emisor rule). */
+            legalName: string;
+            /** `Store.cuit`, as the frame's own `cuit`. */
+            cuit?: string;
+            /**
+             * The invoice's fiscal domicile composition of the `integrations.afip` address leaves
+             * once they are complete (`address`, `postalCode`, `province`; `city` optional), else
+             * `Store.address` with `missing` naming `fiscalAddress` — a partial domicile is never
+             * published. Never the public contact's `address`.
+             */
+            fiscalAddress?: string;
+            /** Only the frame's own `publicContact` targets: absent when the shop publishes none. */
+            email?: string;
+            phone?: StorefrontPublicContact['phone'];
+            whatsapp?: StorefrontPublicContact['whatsapp'];
+        };
+        /**
+         * Always sent: its presence means "render the withdrawal button". `channels` are the
+         * public contact's targets, never prefilled links — the request text is the storefront's;
+         * empty when the shop publishes neither, and `missing` then names `withdrawalChannel`.
+         */
+        withdrawal: {
+            channels: {
+                email?: string;
+                whatsapp?: StorefrontPublicContact['whatsapp'];
+            };
+            hours?: StorefrontContactHours;
+        };
+        privacy: {
+            /** The same verdict as `ecommerce.config.guestCheckoutAvailable`. */
+            guestPurchase: boolean;
+            /** `['mercadopago']` while any `paymentMethods` row is `storefront: 'mp-checkout-pro'`, whatever its audience rule; else `[]`. */
+            onlinePayment: Array<'mercadopago'>;
+        };
+        missing: StorePublicLegalMissing[];
+    }
     interface Store {
         /** Optional operational mail preferences; absent sales-digest/email means enabled. */
         notificationPreferences?: Partial<Record<'sales-digest', Partial<Record<NotificationPreferenceChannel, boolean>>>>;
@@ -1156,6 +1202,13 @@ declare global {
          * email/phone pair explicitly consented by config.publicContact is used.
          */
         publicContact?: StorefrontPublicContact;
+        /**
+         * Server-built consumer-law block: sent on every `200` of web `GET /store` and on the
+         * storefront preview's store frame, the same for a guest and a customer. Read-time,
+         * never stored or writable. NOT on customer STORE frames: a storefront rehydrates it by
+         * refetching web `GET /store`, as it does on socket reconnect.
+         */
+        legal?: StorePublicLegal;
         /** Read-only legacy editor seed, available only to the entitled tenant ADMIN. */
         storefrontEditorBaseline?: StorefrontEditorBaseline;
         /** Public aggregate from the immutable publication and live platform layers. */

package/package.json

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