@asteby/storefront 0.11.1 → 0.12.0

package/dist/mockup.d.cts

@@ -1,4 +1,4 @@
-import { aE as Product, aK as ProductVariant } from './types-bsdlAumU.cjs';
+import { aE as Product, aK as ProductVariant } from './types-BQ3S6VjF.cjs';
 import './geo.cjs';
 
 /**

package/dist/mockup.d.ts

@@ -1,4 +1,4 @@
-import { aE as Product, aK as ProductVariant } from './types-B1E3GySa.js';
+import { aE as Product, aK as ProductVariant } from './types-C_rsJRCl.js';
 import './geo.js';
 
 /**

package/dist/node.cjs

@@ -47,7 +47,7 @@ function maskToken(token) {
 }
 
 // src/node.ts
-var SDK_VERSION = true ? "0.11.1" : "dev";
+var SDK_VERSION = true ? "0.12.0" : "dev";
 function createFileTokenSource(file, options = {}) {
   const ttl = options.ttlMs ?? 3e4;
   const now = options.now ?? Date.now;

package/dist/node.js

@@ -11,7 +11,7 @@ function maskToken(token) {
 }
 
 // src/node.ts
-var SDK_VERSION = true ? "0.11.1" : "dev";
+var SDK_VERSION = true ? "0.12.0" : "dev";
 function createFileTokenSource(file, options = {}) {
   const ttl = options.ttlMs ?? 3e4;
   const now = options.now ?? Date.now;

package/dist/{types-bsdlAumU.d.cts → types-BQ3S6VjF.d.cts}

@@ -418,6 +418,10 @@ type InvoiceRequest = {
     regimen?: string;
     uso_cfdi?: string;
     cp?: string;
+    /** Alias of `postal_code`, already in production use by some storefronts. */
+    zip?: string;
+    /** Alias of `use`, already in production use by some storefronts. */
+    cfdi_use?: string;
     /** Alias of `use`. */
     invoice_use?: string;
     /** Also save the data to the buyer's account (needs a session). */
@@ -662,6 +666,16 @@ type StorefrontErrorBody = {
         field?: string;
         details?: unknown;
         required_scopes?: string[];
+        /** Payment failures only: `true` = repeating the request can succeed; `false` = not until someone fixes something. */
+        retryable?: boolean;
+        /** Seconds to wait before retrying (`too_many_attempts`, `payment_in_progress`). */
+        retry_after?: number;
+        /** A cart write refused because the cart already became a checkout that can still be paid. */
+        checkout_id?: string;
+        /** The cart's current cost, sent with `price_mismatch`. */
+        cost?: unknown;
+        /** The same message in English, when the server provides it. */
+        message_en?: string;
     };
 };
 type RestockSubscriptionInput = {
@@ -746,7 +760,9 @@ type PaymentAction = {
     voucher?: PaymentVoucher | null;
     redirect_url?: string | null;
 };
-type PaymentAttemptStatus = 'paid' | 'pending' | 'requires_action' | 'failed' | 'expired' | 'cancelled';
+type PaymentAttemptStatus = 'paid' | 'pending' | 'requires_action' | 'failed' | 'expired' | 'cancelled'
+/** Only from the shop's status route: there is no payment session in this browser (cookie gone). It is NOT a result. */
+ | 'none';
 /** What the buyer should do next after a rejection (stable enum from the cart). */
 type PaymentNextStep = 'retry' | 'fix_card_data' | 'use_other_card' | 'pay_cash' | 'contact_issuer' | 'check_email' | 'rebuild_cart';
 /** `POST /storefront/checkouts/:id/payment`. The amount is the server's; the browser only brings `provider_data`. */
@@ -781,6 +797,8 @@ type PaymentAttemptResult = {
         n: number;
     };
     attempts_left?: number;
+    /** Only with `payment.status: 'none'`: the shop still has the buyer's cart, so repeating the SAME attempt can proceed. */
+    recoverable?: boolean;
 };
 /** `GET /storefront/checkouts/:id/payment-config`: what to mount for an embedded checkout. */
 type PaymentConfig = {

package/dist/{types-B1E3GySa.d.ts → types-C_rsJRCl.d.ts}

@@ -418,6 +418,10 @@ type InvoiceRequest = {
     regimen?: string;
     uso_cfdi?: string;
     cp?: string;
+    /** Alias of `postal_code`, already in production use by some storefronts. */
+    zip?: string;
+    /** Alias of `use`, already in production use by some storefronts. */
+    cfdi_use?: string;
     /** Alias of `use`. */
     invoice_use?: string;
     /** Also save the data to the buyer's account (needs a session). */
@@ -662,6 +666,16 @@ type StorefrontErrorBody = {
         field?: string;
         details?: unknown;
         required_scopes?: string[];
+        /** Payment failures only: `true` = repeating the request can succeed; `false` = not until someone fixes something. */
+        retryable?: boolean;
+        /** Seconds to wait before retrying (`too_many_attempts`, `payment_in_progress`). */
+        retry_after?: number;
+        /** A cart write refused because the cart already became a checkout that can still be paid. */
+        checkout_id?: string;
+        /** The cart's current cost, sent with `price_mismatch`. */
+        cost?: unknown;
+        /** The same message in English, when the server provides it. */
+        message_en?: string;
     };
 };
 type RestockSubscriptionInput = {
@@ -746,7 +760,9 @@ type PaymentAction = {
     voucher?: PaymentVoucher | null;
     redirect_url?: string | null;
 };
-type PaymentAttemptStatus = 'paid' | 'pending' | 'requires_action' | 'failed' | 'expired' | 'cancelled';
+type PaymentAttemptStatus = 'paid' | 'pending' | 'requires_action' | 'failed' | 'expired' | 'cancelled'
+/** Only from the shop's status route: there is no payment session in this browser (cookie gone). It is NOT a result. */
+ | 'none';
 /** What the buyer should do next after a rejection (stable enum from the cart). */
 type PaymentNextStep = 'retry' | 'fix_card_data' | 'use_other_card' | 'pay_cash' | 'contact_issuer' | 'check_email' | 'rebuild_cart';
 /** `POST /storefront/checkouts/:id/payment`. The amount is the server's; the browser only brings `provider_data`. */
@@ -781,6 +797,8 @@ type PaymentAttemptResult = {
         n: number;
     };
     attempts_left?: number;
+    /** Only with `payment.status: 'none'`: the shop still has the buyer's cart, so repeating the SAME attempt can proceed. */
+    recoverable?: boolean;
 };
 /** `GET /storefront/checkouts/:id/payment-config`: what to mount for an embedded checkout. */
 type PaymentConfig = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asteby/storefront",
-  "version": "0.11.1",
+  "version": "0.12.0",
   "description": "Typed client for the Storefront API v1 (catalog, cart, checkout, customer, content) using only global fetch — Node 20+, edge runtimes and browsers — plus an in-memory mock of the whole contract and, in `@asteby/storefront/fiscal-document`, a country-agnostic engine that reads a buyer's fiscal document (PDF) in the browser or Node.",
   "license": "Apache-2.0",
   "repository": {