@asteby/storefront 0.10.0 → 0.11.0

package/dist/mock.d.cts

@@ -1,4 +1,4 @@
-import { aI as Shop, ao as Product, w as Collection, aP as Theme, a6 as Page, $ as Menu, b as Article, C as Cart, A as Address, y as Customer, a4 as Order, a9 as PaymentAttemptResult, z as CustomerCapabilities, av as PromotionAnnouncement, aH as ShippingRate, af as PaymentMethod } from './types-DdLzlxw4.cjs';
+import { $ as IdentityRulesV1, aS as RegionFiscalId, Z as IdentityDocumentSpec, aQ as Region, b0 as Shop, aE as Product, x as Collection, b7 as Theme, am as Page, af as Menu, b as Article, C as Cart, A as Address, a5 as InvoiceRequest, z as Customer, ak as Order, ap as PaymentAttemptResult, a7 as InvoiceStage, B as CustomerCapabilities, aL as PromotionAnnouncement, a$ as ShippingRate, av as PaymentMethod } from './types-C-Ley-Mt.cjs';
 import './geo.cjs';
 
 /**
@@ -16,6 +16,17 @@ declare const MOCK_POSTAL_CENTROIDS: Record<string, {
     lng: number;
 }>;
 
+/**
+ * Region fixture of the mock: Mexico exactly as `GET /storefront/region` publishes it (see `region-mx.seed.ts`),
+ * identity document `MX:csf` included, so a storefront can be built and tested without a server. It lives here,
+ * and only here: the real data belongs to the region package, and the engine in `fiscal-document` knows no country.
+ */
+
+declare const MOCK_IDENTITY_DOCUMENT_MX_CSF: IdentityDocumentSpec;
+declare const MOCK_CSF_RULES: IdentityRulesV1;
+declare const MOCK_FISCAL_ID_MX: RegionFiscalId;
+declare const MOCK_REGION_MX: Region;
+
 /**
  * In-memory implementation of the whole Storefront API v1 contract, exposed
  * as a `fetch` function. Use it to develop and test storefronts without OPS:
@@ -37,6 +48,13 @@ type MockStorefrontOptions = {
      * create the account straight away (`201`).
      */
     customerCapabilities?: Partial<CustomerCapabilities>;
+    /**
+     * Scopes the mock's `sk_`/`pk_` tokens do NOT have (e.g. `['customer:write']`), to rehearse an under-provisioned
+     * store. Routes needing one answer `403 insufficient_scope` with `required_scopes`; `GET /_token` lists them in
+     * `missing_scopes`; and `customer/capabilities` reports `password: false`, `unavailable_reason: 'missing_scope'`
+     * when `customer:write` is among them. Implies scope enforcement.
+     */
+    missingScopes?: string[];
     /** Failed password logins per email before `429 rate_limited` (default 5; a success or a reset clears the count). */
     maxLoginAttempts?: number;
     /** Discount codes → percentage off the subtotal (default `{ BIENVENIDA10: 10 }`). */
@@ -73,6 +91,11 @@ type MockStorefrontOptions = {
     shippingRates?: ShippingRate[];
     /** Methods served by `payment-methods` (default one builtin `mock`). */
     paymentMethods?: PaymentMethod[];
+    /**
+     * What `GET /storefront/region` serves (default `MOCK_REGION_MX`, with its `MX:csf` identity document). `null`: the
+     * organization has no region, the route answers `404` and invoice requests are not validated against a region.
+     */
+    region?: Region | null;
 };
 type CartRecord = {
     id: string;
@@ -86,6 +109,9 @@ type CartRecord = {
     shipping_address: Address | null;
     delivery: Cart['delivery'];
     note: string | null;
+    /** Invoice asked for (`PUT /carts/:id/invoice`). */
+    invoice: InvoiceRequest | null;
+    checkedOut: boolean;
     updated_at: string;
 };
 type MockState = {
@@ -127,6 +153,11 @@ type MockState = {
     }>;
     /** `contact|sku` of accepted "notify me" subscriptions. */
     restock: Set<string>;
+    /** Invoice requested per order id. */
+    invoices: Map<string, {
+        stage: InvoiceStage;
+        request: InvoiceRequest;
+    }>;
     seq: number;
 };
 declare function createMockStorefront(options?: MockStorefrontOptions): {
@@ -141,4 +172,4 @@ declare function createMockStorefront(options?: MockStorefrontOptions): {
 };
 type MockStorefront = ReturnType<typeof createMockStorefront>;
 
-export { MOCK_CURRENCY, MOCK_CUSTOMER_EMAIL, MOCK_IMAGE_URL, MOCK_POSTAL_CENTROIDS, type MockImageUrl, type MockState, type MockStorefront, type MockStorefrontOptions, createMockStorefront };
+export { MOCK_CSF_RULES, MOCK_CURRENCY, MOCK_CUSTOMER_EMAIL, MOCK_FISCAL_ID_MX, MOCK_IDENTITY_DOCUMENT_MX_CSF, MOCK_IMAGE_URL, MOCK_POSTAL_CENTROIDS, MOCK_REGION_MX, type MockImageUrl, type MockState, type MockStorefront, type MockStorefrontOptions, createMockStorefront };

package/dist/mock.d.ts

@@ -1,4 +1,4 @@
-import { aI as Shop, ao as Product, w as Collection, aP as Theme, a6 as Page, $ as Menu, b as Article, C as Cart, A as Address, y as Customer, a4 as Order, a9 as PaymentAttemptResult, z as CustomerCapabilities, av as PromotionAnnouncement, aH as ShippingRate, af as PaymentMethod } from './types-COSwo4ND.js';
+import { $ as IdentityRulesV1, aS as RegionFiscalId, Z as IdentityDocumentSpec, aQ as Region, b0 as Shop, aE as Product, x as Collection, b7 as Theme, am as Page, af as Menu, b as Article, C as Cart, A as Address, a5 as InvoiceRequest, z as Customer, ak as Order, ap as PaymentAttemptResult, a7 as InvoiceStage, B as CustomerCapabilities, aL as PromotionAnnouncement, a$ as ShippingRate, av as PaymentMethod } from './types-D7UJxrba.js';
 import './geo.js';
 
 /**
@@ -16,6 +16,17 @@ declare const MOCK_POSTAL_CENTROIDS: Record<string, {
     lng: number;
 }>;
 
+/**
+ * Region fixture of the mock: Mexico exactly as `GET /storefront/region` publishes it (see `region-mx.seed.ts`),
+ * identity document `MX:csf` included, so a storefront can be built and tested without a server. It lives here,
+ * and only here: the real data belongs to the region package, and the engine in `fiscal-document` knows no country.
+ */
+
+declare const MOCK_IDENTITY_DOCUMENT_MX_CSF: IdentityDocumentSpec;
+declare const MOCK_CSF_RULES: IdentityRulesV1;
+declare const MOCK_FISCAL_ID_MX: RegionFiscalId;
+declare const MOCK_REGION_MX: Region;
+
 /**
  * In-memory implementation of the whole Storefront API v1 contract, exposed
  * as a `fetch` function. Use it to develop and test storefronts without OPS:
@@ -37,6 +48,13 @@ type MockStorefrontOptions = {
      * create the account straight away (`201`).
      */
     customerCapabilities?: Partial<CustomerCapabilities>;
+    /**
+     * Scopes the mock's `sk_`/`pk_` tokens do NOT have (e.g. `['customer:write']`), to rehearse an under-provisioned
+     * store. Routes needing one answer `403 insufficient_scope` with `required_scopes`; `GET /_token` lists them in
+     * `missing_scopes`; and `customer/capabilities` reports `password: false`, `unavailable_reason: 'missing_scope'`
+     * when `customer:write` is among them. Implies scope enforcement.
+     */
+    missingScopes?: string[];
     /** Failed password logins per email before `429 rate_limited` (default 5; a success or a reset clears the count). */
     maxLoginAttempts?: number;
     /** Discount codes → percentage off the subtotal (default `{ BIENVENIDA10: 10 }`). */
@@ -73,6 +91,11 @@ type MockStorefrontOptions = {
     shippingRates?: ShippingRate[];
     /** Methods served by `payment-methods` (default one builtin `mock`). */
     paymentMethods?: PaymentMethod[];
+    /**
+     * What `GET /storefront/region` serves (default `MOCK_REGION_MX`, with its `MX:csf` identity document). `null`: the
+     * organization has no region, the route answers `404` and invoice requests are not validated against a region.
+     */
+    region?: Region | null;
 };
 type CartRecord = {
     id: string;
@@ -86,6 +109,9 @@ type CartRecord = {
     shipping_address: Address | null;
     delivery: Cart['delivery'];
     note: string | null;
+    /** Invoice asked for (`PUT /carts/:id/invoice`). */
+    invoice: InvoiceRequest | null;
+    checkedOut: boolean;
     updated_at: string;
 };
 type MockState = {
@@ -127,6 +153,11 @@ type MockState = {
     }>;
     /** `contact|sku` of accepted "notify me" subscriptions. */
     restock: Set<string>;
+    /** Invoice requested per order id. */
+    invoices: Map<string, {
+        stage: InvoiceStage;
+        request: InvoiceRequest;
+    }>;
     seq: number;
 };
 declare function createMockStorefront(options?: MockStorefrontOptions): {
@@ -141,4 +172,4 @@ declare function createMockStorefront(options?: MockStorefrontOptions): {
 };
 type MockStorefront = ReturnType<typeof createMockStorefront>;
 
-export { MOCK_CURRENCY, MOCK_CUSTOMER_EMAIL, MOCK_IMAGE_URL, MOCK_POSTAL_CENTROIDS, type MockImageUrl, type MockState, type MockStorefront, type MockStorefrontOptions, createMockStorefront };
+export { MOCK_CSF_RULES, MOCK_CURRENCY, MOCK_CUSTOMER_EMAIL, MOCK_FISCAL_ID_MX, MOCK_IDENTITY_DOCUMENT_MX_CSF, MOCK_IMAGE_URL, MOCK_POSTAL_CENTROIDS, MOCK_REGION_MX, type MockImageUrl, type MockState, type MockStorefront, type MockStorefrontOptions, createMockStorefront };