@asteby/storefront 0.9.0 → 0.11.0

package/dist/mock.d.cts

@@ -1,4 +1,4 @@
-import { aB as Shop, ah as Product, w as Collection, aI as Theme, $ as Page, U as Menu, b as Article, C as Cart, A as Address, y as Customer, Z as Order, a2 as PaymentAttemptResult, ao as PromotionAnnouncement, aA as ShippingRate, a8 as PaymentMethod } from './types-CSMuPSQA.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:
@@ -31,6 +42,21 @@ type MockStorefrontOptions = {
     imageUrl?: MockImageUrl;
     /** OTP code accepted by `/customer/session` (default `000000`). */
     otpCode?: string;
+    /**
+     * What `GET /customer/capabilities` reports (default `{ password: true, email_verification: true, otp_channels: ['email'] }`).
+     * `password: false` makes register / login / password routes answer `403`; `email_verification: false` makes `register`
+     * 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 }`). */
     discountCodes?: Record<string, number>;
     /** Flat shipping rate (default 149). Free from `shop.policies.free_shipping_min`. */
@@ -65,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;
@@ -78,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 = {
@@ -96,6 +130,16 @@ type MockState = {
         customer_id: string | null;
     })[];
     otps: Map<string, string>;
+    /** Email → password (plain text: it is a mock). The seed customer starts without one. */
+    passwords: Map<string, string>;
+    /** Registrations waiting for their code, by email. */
+    pendingRegistrations: Map<string, {
+        password: string;
+        first_name: string | null;
+        last_name: string | null;
+    }>;
+    /** Consecutive failed password logins by email. */
+    loginFailures: Map<string, number>;
     sessions: Map<string, string>;
     idempotency: Map<string, {
         status: number;
@@ -109,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): {
@@ -123,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 { aB as Shop, ah as Product, w as Collection, aI as Theme, $ as Page, U as Menu, b as Article, C as Cart, A as Address, y as Customer, Z as Order, a2 as PaymentAttemptResult, ao as PromotionAnnouncement, aA as ShippingRate, a8 as PaymentMethod } from './types-iGGZ9EiC.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:
@@ -31,6 +42,21 @@ type MockStorefrontOptions = {
     imageUrl?: MockImageUrl;
     /** OTP code accepted by `/customer/session` (default `000000`). */
     otpCode?: string;
+    /**
+     * What `GET /customer/capabilities` reports (default `{ password: true, email_verification: true, otp_channels: ['email'] }`).
+     * `password: false` makes register / login / password routes answer `403`; `email_verification: false` makes `register`
+     * 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 }`). */
     discountCodes?: Record<string, number>;
     /** Flat shipping rate (default 149). Free from `shop.policies.free_shipping_min`. */
@@ -65,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;
@@ -78,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 = {
@@ -96,6 +130,16 @@ type MockState = {
         customer_id: string | null;
     })[];
     otps: Map<string, string>;
+    /** Email → password (plain text: it is a mock). The seed customer starts without one. */
+    passwords: Map<string, string>;
+    /** Registrations waiting for their code, by email. */
+    pendingRegistrations: Map<string, {
+        password: string;
+        first_name: string | null;
+        last_name: string | null;
+    }>;
+    /** Consecutive failed password logins by email. */
+    loginFailures: Map<string, number>;
     sessions: Map<string, string>;
     idempotency: Map<string, {
         status: number;
@@ -109,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): {
@@ -123,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 };