@asteby/storefront 0.10.0 → 0.11.0

package/dist/mock.js

@@ -1,6 +1,949 @@
 import { resolveAvailability } from './chunk-HBSB7XS2.js';
 import { isValidPoint, rankByDistance } from './chunk-45R47HYO.js';
 
+// src/mock/region-mx.seed.ts
+var SEED_MX_CSF = {
+  "kind": "MX:csf",
+  "country_code": "MX",
+  "label": "Constancia de situaci\xF3n fiscal",
+  "help": "Es el PDF que te da el SAT con tu RFC, tu nombre o raz\xF3n social, tu r\xE9gimen y tu c\xF3digo postal fiscal. Lo leemos en tu dispositivo para llenar tus datos de facturaci\xF3n.",
+  "obtain_url": "https://www.sat.gob.mx/portal/public/tramites/constancia-de-situacion-fiscal",
+  "accept": [
+    "application/pdf"
+  ],
+  "max_bytes": 5242880,
+  "max_pages": 6,
+  "engine": "rules@1",
+  "rules": {
+    "version": 1,
+    "normalize": [
+      "nbsp",
+      "collapse_ws"
+    ],
+    "labels": [
+      "RFC",
+      "CURP",
+      "Nombre \\(s\\)",
+      "Nombre",
+      "Primer Apellido",
+      "Segundo Apellido",
+      "Denominaci[\xF3o]n\\s*/\\s*Raz[\xF3o]n Social",
+      "R[\xE9e]gimen de capital",
+      "Nombre Comercial",
+      "Fecha (?:de )?inicio de operaciones",
+      "Fecha de constituci[\xF3o]n",
+      "Estatus en el padr[\xF3o]n",
+      "Fecha de [\xFAu]ltimo cambio de estado",
+      "Datos del domicilio registrado",
+      "C[\xF3o]digo Postal",
+      "Tipo de Vialidad",
+      "Nombre de Vialidad",
+      "N[\xFAu]mero Exterior",
+      "N[\xFAu]mero Interior",
+      "Nombre de la Colonia",
+      "Nombre de la Localidad",
+      "Nombre del Municipio o Demarcaci[\xF3o]n Territorial",
+      "Nombre de la Entidad Federativa",
+      "Entre Calle",
+      "Y Calle",
+      "Actividades Econ[\xF3o]micas",
+      "Reg[\xEDi]menes",
+      "Obligaciones",
+      "Correo Electr[\xF3o]nico"
+    ],
+    "qr_canonical": "https://siat.sat.gob.mx/app/qr/faces/pages/mobile/validadorqr.jsf?D1=10&D2=1&D3={document_id}_{tax_id}",
+    "fields": [
+      {
+        "key": "tax_id",
+        "required": true,
+        "strategies": [
+          {
+            "strategy": "labeled_lines",
+            "label": "RFC",
+            "upper": true,
+            "capture": {
+              "pattern": "(?:^|[^A-Z0-9\xD1&])([A-Z\xD1&]{3,4}[0-9]{6}[A-Z0-9]{3})(?:[^A-Z0-9\xD1&]|$)",
+              "flags": "i",
+              "group": 1
+            }
+          },
+          {
+            "strategy": "regex",
+            "pattern": "(?:^|[^A-Z0-9\xD1&])([A-Z\xD1&]{3,4}[0-9]{6}[A-Z0-9]{3})(?:[^A-Z0-9\xD1&]|$)",
+            "flags": "i",
+            "group": 1,
+            "upper": true
+          },
+          {
+            "strategy": "qr_param",
+            "param": "D3",
+            "split": "_",
+            "parts": 2,
+            "match": "^[A-Z\xD1&]{3,4}[0-9]{6}[A-Z0-9]{3}$"
+          },
+          {
+            "strategy": "qr_param",
+            "scan": "(?:D3)?([0-9]{11})[^A-Z0-9\xD1&]{0,3}([A-Z\xD1&]{3,4}[0-9]{6}[A-Z0-9]{3})(?:[^A-Z0-9]|$)",
+            "flags": "i",
+            "group": 2
+          }
+        ]
+      },
+      {
+        "key": "legal_name",
+        "required": true,
+        "strategies": [
+          {
+            "strategy": "labeled_lines",
+            "label": "Denominaci[\xF3o]n\\s*/\\s*Raz[\xF3o]n Social"
+          },
+          {
+            "strategy": "concat_labeled",
+            "labels": [
+              "Nombre \\(s\\)",
+              "Primer Apellido",
+              "Segundo Apellido"
+            ],
+            "separator": " "
+          }
+        ]
+      },
+      {
+        "key": "postal_code",
+        "required": true,
+        "strategies": [
+          {
+            "strategy": "labeled_lines",
+            "label": "C[\xF3o]digo Postal",
+            "capture": {
+              "pattern": "\\b([0-9]{5})\\b",
+              "group": 1
+            }
+          }
+        ]
+      },
+      {
+        "key": "tax_regime",
+        "required": true,
+        "multiple": true,
+        "strategies": [
+          {
+            "strategy": "catalog_phrases",
+            "catalog": "fiscal_regime",
+            "start": "Reg[\xEDi]menes\\s*:?",
+            "end": "Obligaciones\\s*:"
+          }
+        ]
+      },
+      {
+        "key": "document_id",
+        "strategies": [
+          {
+            "strategy": "regex",
+            "pattern": "id\\s*CIF\\s*:?\\s*([0-9]{6,})",
+            "flags": "i",
+            "group": 1
+          },
+          {
+            "strategy": "qr_param",
+            "param": "D3",
+            "split": "_",
+            "parts": 2,
+            "match": "^[0-9]+$"
+          },
+          {
+            "strategy": "qr_param",
+            "scan": "(?:D3)?([0-9]{11})[^A-Z0-9\xD1&]{0,3}([A-Z\xD1&]{3,4}[0-9]{6}[A-Z0-9]{3})(?:[^A-Z0-9]|$)",
+            "flags": "i",
+            "group": 1
+          }
+        ]
+      },
+      {
+        "key": "issued_on",
+        "strategies": [
+          {
+            "strategy": "date",
+            "order": "dmy",
+            "pattern": "Fecha\\s+de\\s+Emisi[\xF3o]n\\s*:?[^0-9]*?([0-9]{1,2})\\s+DE\\s+([A-Za-z\xC1\xC9\xCD\xD3\xDA\xD1\xE1\xE9\xED\xF3\xFA\xF1]+)\\s+DE\\s+([0-9]{4})",
+            "flags": "i",
+            "months": [
+              "enero",
+              "febrero",
+              "marzo",
+              "abril",
+              "mayo",
+              "junio",
+              "julio",
+              "agosto",
+              "septiembre",
+              "octubre",
+              "noviembre",
+              "diciembre"
+            ]
+          }
+        ]
+      }
+    ]
+  },
+  "verify_kind": "qr_validator",
+  "freshness_days": 90,
+  "discard_fields": [
+    "curp",
+    "street",
+    "exterior_number",
+    "neighborhood",
+    "activities"
+  ]
+};
+var SEED_MX_REGIMES = [
+  {
+    "code": "601",
+    "label": "General de Ley Personas Morales",
+    "person_types": [
+      "company"
+    ],
+    "match_phrases": [
+      "general de ley personas morales"
+    ]
+  },
+  {
+    "code": "603",
+    "label": "Personas Morales con Fines no Lucrativos",
+    "person_types": [
+      "company"
+    ],
+    "match_phrases": [
+      "fines no lucrativos"
+    ]
+  },
+  {
+    "code": "605",
+    "label": "Sueldos y Salarios e Ingresos Asimilados a Salarios",
+    "person_types": [
+      "individual"
+    ],
+    "match_phrases": [
+      "sueldos y salarios"
+    ]
+  },
+  {
+    "code": "606",
+    "label": "Arrendamiento",
+    "person_types": [
+      "individual"
+    ],
+    "match_phrases": [
+      "arrendamiento"
+    ]
+  },
+  {
+    "code": "607",
+    "label": "R\xE9gimen de Enajenaci\xF3n o Adquisici\xF3n de Bienes",
+    "person_types": [
+      "individual"
+    ],
+    "match_phrases": [
+      "enajenacion o adquisicion de bienes"
+    ]
+  },
+  {
+    "code": "608",
+    "label": "Dem\xE1s ingresos",
+    "person_types": [
+      "individual"
+    ],
+    "match_phrases": [
+      "demas ingresos"
+    ]
+  },
+  {
+    "code": "610",
+    "label": "Residentes en el Extranjero sin Establecimiento Permanente en M\xE9xico",
+    "person_types": [
+      "individual",
+      "company"
+    ],
+    "match_phrases": [
+      "residentes en el extranjero"
+    ]
+  },
+  {
+    "code": "611",
+    "label": "Ingresos por Dividendos (socios y accionistas)",
+    "person_types": [
+      "individual"
+    ],
+    "match_phrases": [
+      "dividendos"
+    ]
+  },
+  {
+    "code": "612",
+    "label": "Personas F\xEDsicas con Actividades Empresariales y Profesionales",
+    "person_types": [
+      "individual"
+    ],
+    "match_phrases": [
+      "actividades empresariales y profesionales"
+    ]
+  },
+  {
+    "code": "614",
+    "label": "Ingresos por intereses",
+    "person_types": [
+      "individual"
+    ],
+    "match_phrases": [
+      "ingresos por intereses"
+    ]
+  },
+  {
+    "code": "615",
+    "label": "R\xE9gimen de los ingresos por obtenci\xF3n de premios",
+    "person_types": [
+      "individual"
+    ],
+    "match_phrases": [
+      "premios"
+    ]
+  },
+  {
+    "code": "616",
+    "label": "Sin obligaciones fiscales",
+    "person_types": [
+      "individual"
+    ],
+    "match_phrases": [
+      "sin obligaciones fiscales"
+    ]
+  },
+  {
+    "code": "620",
+    "label": "Sociedades Cooperativas de Producci\xF3n que optan por diferir sus ingresos",
+    "person_types": [
+      "company"
+    ],
+    "match_phrases": [
+      "sociedades cooperativas de produccion"
+    ]
+  },
+  {
+    "code": "621",
+    "label": "Incorporaci\xF3n Fiscal",
+    "person_types": [
+      "individual"
+    ],
+    "match_phrases": [
+      "incorporacion fiscal"
+    ]
+  },
+  {
+    "code": "622",
+    "label": "Actividades Agr\xEDcolas, Ganaderas, Silv\xEDcolas y Pesqueras",
+    "person_types": [
+      "company"
+    ],
+    "match_phrases": [
+      "actividades agricolas"
+    ]
+  },
+  {
+    "code": "623",
+    "label": "Opcional para Grupos de Sociedades",
+    "person_types": [
+      "company"
+    ],
+    "match_phrases": [
+      "opcional para grupos de sociedades"
+    ]
+  },
+  {
+    "code": "624",
+    "label": "Coordinados",
+    "person_types": [
+      "company"
+    ],
+    "match_phrases": [
+      "coordinados"
+    ]
+  },
+  {
+    "code": "625",
+    "label": "R\xE9gimen de las Actividades Empresariales con ingresos a trav\xE9s de Plataformas Tecnol\xF3gicas",
+    "person_types": [
+      "individual"
+    ],
+    "match_phrases": [
+      "plataformas tecnologicas"
+    ]
+  },
+  {
+    "code": "626",
+    "label": "R\xE9gimen Simplificado de Confianza",
+    "person_types": [
+      "individual",
+      "company"
+    ],
+    "match_phrases": [
+      "simplificado de confianza"
+    ]
+  }
+];
+var SEED_MX_INVOICE_USES = [
+  {
+    "code": "G01",
+    "label": "Adquisici\xF3n de mercanc\xEDas",
+    "person_types": [
+      "individual",
+      "company"
+    ],
+    "allowed_regimes": [
+      "601",
+      "603",
+      "606",
+      "612",
+      "620",
+      "621",
+      "622",
+      "623",
+      "624",
+      "625",
+      "626"
+    ]
+  },
+  {
+    "code": "G03",
+    "label": "Gastos en general",
+    "person_types": [
+      "individual",
+      "company"
+    ],
+    "allowed_regimes": [
+      "601",
+      "603",
+      "606",
+      "612",
+      "620",
+      "621",
+      "622",
+      "623",
+      "624",
+      "625",
+      "626"
+    ]
+  },
+  {
+    "code": "I01",
+    "label": "Construcciones",
+    "person_types": [
+      "individual",
+      "company"
+    ],
+    "allowed_regimes": [
+      "601",
+      "603",
+      "606",
+      "612",
+      "620",
+      "621",
+      "622",
+      "623",
+      "624",
+      "625",
+      "626"
+    ]
+  },
+  {
+    "code": "I02",
+    "label": "Mobiliario y equipo de oficina por inversiones",
+    "person_types": [
+      "individual",
+      "company"
+    ],
+    "allowed_regimes": [
+      "601",
+      "603",
+      "606",
+      "612",
+      "620",
+      "621",
+      "622",
+      "623",
+      "624",
+      "625",
+      "626"
+    ]
+  },
+  {
+    "code": "I03",
+    "label": "Equipo de transporte",
+    "person_types": [
+      "individual",
+      "company"
+    ],
+    "allowed_regimes": [
+      "601",
+      "603",
+      "606",
+      "612",
+      "620",
+      "621",
+      "622",
+      "623",
+      "624",
+      "625",
+      "626"
+    ]
+  },
+  {
+    "code": "I04",
+    "label": "Equipo de c\xF3mputo y accesorios",
+    "person_types": [
+      "individual",
+      "company"
+    ],
+    "allowed_regimes": [
+      "601",
+      "603",
+      "606",
+      "612",
+      "620",
+      "621",
+      "622",
+      "623",
+      "624",
+      "625",
+      "626"
+    ]
+  },
+  {
+    "code": "I05",
+    "label": "Dados, troqueles, moldes, matrices y herramental",
+    "person_types": [
+      "individual",
+      "company"
+    ],
+    "allowed_regimes": [
+      "601",
+      "603",
+      "606",
+      "612",
+      "620",
+      "621",
+      "622",
+      "623",
+      "624",
+      "625",
+      "626"
+    ]
+  },
+  {
+    "code": "I06",
+    "label": "Comunicaciones telef\xF3nicas",
+    "person_types": [
+      "individual",
+      "company"
+    ],
+    "allowed_regimes": [
+      "601",
+      "603",
+      "606",
+      "612",
+      "620",
+      "621",
+      "622",
+      "623",
+      "624",
+      "625",
+      "626"
+    ]
+  },
+  {
+    "code": "I07",
+    "label": "Comunicaciones satelitales",
+    "person_types": [
+      "individual",
+      "company"
+    ],
+    "allowed_regimes": [
+      "601",
+      "603",
+      "606",
+      "612",
+      "620",
+      "621",
+      "622",
+      "623",
+      "624",
+      "625",
+      "626"
+    ]
+  },
+  {
+    "code": "I08",
+    "label": "Otra maquinaria y equipo",
+    "person_types": [
+      "individual",
+      "company"
+    ],
+    "allowed_regimes": [
+      "601",
+      "603",
+      "606",
+      "612",
+      "620",
+      "621",
+      "622",
+      "623",
+      "624",
+      "625",
+      "626"
+    ]
+  },
+  {
+    "code": "D01",
+    "label": "Honorarios m\xE9dicos, dentales y gastos hospitalarios",
+    "person_types": [
+      "individual"
+    ],
+    "allowed_regimes": [
+      "605",
+      "606",
+      "607",
+      "608",
+      "611",
+      "612",
+      "614",
+      "615",
+      "625"
+    ]
+  },
+  {
+    "code": "D02",
+    "label": "Gastos m\xE9dicos por incapacidad o discapacidad",
+    "person_types": [
+      "individual"
+    ],
+    "allowed_regimes": [
+      "605",
+      "606",
+      "607",
+      "608",
+      "611",
+      "612",
+      "614",
+      "615",
+      "625"
+    ]
+  },
+  {
+    "code": "D03",
+    "label": "Gastos funerales",
+    "person_types": [
+      "individual"
+    ],
+    "allowed_regimes": [
+      "605",
+      "606",
+      "607",
+      "608",
+      "611",
+      "612",
+      "614",
+      "615",
+      "625"
+    ]
+  },
+  {
+    "code": "D04",
+    "label": "Donativos",
+    "person_types": [
+      "individual"
+    ],
+    "allowed_regimes": [
+      "605",
+      "606",
+      "607",
+      "608",
+      "611",
+      "612",
+      "614",
+      "615",
+      "625"
+    ]
+  },
+  {
+    "code": "D05",
+    "label": "Intereses reales efectivamente pagados por cr\xE9ditos hipotecarios (casa habitaci\xF3n)",
+    "person_types": [
+      "individual"
+    ],
+    "allowed_regimes": [
+      "605",
+      "606",
+      "607",
+      "608",
+      "611",
+      "612",
+      "614",
+      "615",
+      "625"
+    ]
+  },
+  {
+    "code": "D06",
+    "label": "Aportaciones voluntarias al SAR",
+    "person_types": [
+      "individual"
+    ],
+    "allowed_regimes": [
+      "605",
+      "606",
+      "607",
+      "608",
+      "611",
+      "612",
+      "614",
+      "615",
+      "625"
+    ]
+  },
+  {
+    "code": "D07",
+    "label": "Primas por seguros de gastos m\xE9dicos",
+    "person_types": [
+      "individual"
+    ],
+    "allowed_regimes": [
+      "605",
+      "606",
+      "607",
+      "608",
+      "611",
+      "612",
+      "614",
+      "615",
+      "625"
+    ]
+  },
+  {
+    "code": "D08",
+    "label": "Gastos de transportaci\xF3n escolar obligatoria",
+    "person_types": [
+      "individual"
+    ],
+    "allowed_regimes": [
+      "605",
+      "606",
+      "607",
+      "608",
+      "611",
+      "612",
+      "614",
+      "615",
+      "625"
+    ]
+  },
+  {
+    "code": "D09",
+    "label": "Dep\xF3sitos en cuentas para el ahorro, primas que tengan como base planes de pensiones",
+    "person_types": [
+      "individual"
+    ],
+    "allowed_regimes": [
+      "605",
+      "606",
+      "607",
+      "608",
+      "611",
+      "612",
+      "614",
+      "615",
+      "625"
+    ]
+  },
+  {
+    "code": "D10",
+    "label": "Pagos por servicios educativos (colegiaturas)",
+    "person_types": [
+      "individual"
+    ],
+    "allowed_regimes": [
+      "605",
+      "606",
+      "607",
+      "608",
+      "611",
+      "612",
+      "614",
+      "615",
+      "625"
+    ]
+  },
+  {
+    "code": "S01",
+    "label": "Sin efectos fiscales",
+    "person_types": [
+      "individual",
+      "company"
+    ],
+    "allowed_regimes": [
+      "601",
+      "603",
+      "605",
+      "606",
+      "607",
+      "608",
+      "610",
+      "611",
+      "612",
+      "614",
+      "615",
+      "616",
+      "620",
+      "621",
+      "622",
+      "623",
+      "624",
+      "625",
+      "626"
+    ]
+  }
+];
+var SEED_MX_PAYMENT_METHODS = [
+  {
+    "code": "card",
+    "label": "Tarjeta de cr\xE9dito o d\xE9bito",
+    "description": "Visa, Mastercard y American Express. Pago seguro procesado por tu pasarela.",
+    "kind": "card",
+    "flow": "inline",
+    "providers": [
+      "mercadopago",
+      "stripe"
+    ],
+    "installments": null,
+    "min_amount": null,
+    "max_amount": null,
+    "icon": "CreditCard",
+    "fiscal_payment_form": "04,28"
+  },
+  {
+    "code": "mercadopago",
+    "label": "Mercado Pago",
+    "description": "Paga con tu cuenta de Mercado Pago: saldo, tarjetas guardadas o meses.",
+    "kind": "wallet",
+    "flow": "redirect",
+    "providers": [
+      "mercadopago"
+    ],
+    "installments": null,
+    "min_amount": null,
+    "max_amount": null,
+    "icon": "Wallet",
+    "fiscal_payment_form": "06,04,28"
+  },
+  {
+    "code": "oxxo",
+    "label": "Efectivo en OXXO",
+    "description": "Recibe una referencia y paga en cualquier tienda OXXO. Confirmamos tu pedido cuando se acredita el pago.",
+    "kind": "cash_voucher",
+    "flow": "voucher",
+    "providers": [
+      "mercadopago",
+      "stripe"
+    ],
+    "installments": null,
+    "min_amount": null,
+    "max_amount": null,
+    "expires_hours": 72,
+    "icon": "Store",
+    "fiscal_payment_form": "01"
+  },
+  {
+    "code": "spei",
+    "label": "Transferencia SPEI",
+    "description": "Paga desde la app de tu banco con una CLABE \xFAnica para tu pedido; se confirma en minutos.",
+    "kind": "bank_transfer",
+    "flow": "instructions",
+    "providers": [
+      "mercadopago",
+      "stripe"
+    ],
+    "installments": null,
+    "min_amount": null,
+    "max_amount": null,
+    "expires_hours": 24,
+    "icon": "Landmark",
+    "fiscal_payment_form": "03"
+  }
+];
+var SEED_MX_FISCAL_ID_PATTERN = "^[A-Z\xD1&]{3,4}[0-9]{2}(0[1-9]|1[0-2])(0[1-9]|[12][0-9]|3[01])[A-Z0-9]{2}[0-9A]$";
+var SEED_MX_GENERIC_IDS = ["XAXX010101000", "XEXX010101000"];
+
+// src/mock/region.ts
+var MOCK_IDENTITY_DOCUMENT_MX_CSF = SEED_MX_CSF;
+var MOCK_CSF_RULES = SEED_MX_CSF.rules;
+var MOCK_FISCAL_ID_MX = {
+  kind: "mx_rfc",
+  label: "RFC",
+  pattern: SEED_MX_FISCAL_ID_PATTERN,
+  generic_ids: SEED_MX_GENERIC_IDS,
+  regimes: SEED_MX_REGIMES,
+  invoice_uses: SEED_MX_INVOICE_USES,
+  documents: [SEED_MX_CSF]
+};
+var MOCK_REGION_MX = {
+  country_code: "MX",
+  name: "M\xE9xico",
+  locale: { default: "es-MX", available: ["es-MX", "en-US"], current: "es-MX" },
+  timezone: "America/Mexico_City",
+  currency: { code: "MXN", symbol: "$", symbol_position: "before", minor_units: 2 },
+  formats: { date: "dd/MM/yyyy", measurement: "metric" },
+  tax: { prices_include_tax: true, label: "IVA", price_label: "IVA incluido", show_breakdown: true, default_category: "standard", categories: ["standard"] },
+  address: { postal_code: { pattern: "^[0-9]{5}$", example: "06600" } },
+  fiscal_id: MOCK_FISCAL_ID_MX,
+  payment_methods: SEED_MX_PAYMENT_METHODS
+};
+function mockPersonType(taxId) {
+  if (taxId.length === 13) return "individual";
+  if (taxId.length === 12) return "company";
+  return null;
+}
+function validateInvoiceRequest(region, input, prefix = "invoice") {
+  const text = (...v) => v.map((x) => typeof x === "string" ? x.trim() : "").find(Boolean) ?? "";
+  const fid = region?.fiscal_id;
+  const taxId = text(input.tax_id, input.rfc).toUpperCase();
+  const name = text(input.legal_name, input.razon_social);
+  const regime = text(input.tax_regime, input.regimen);
+  const use = text(input.use, input.uso_cfdi);
+  const postal = text(input.postal_code, input.cp);
+  const bad = (field, message) => ({ field: `${prefix}.${field}`, message });
+  if (!taxId) return bad("tax_id", "The tax id is required");
+  if (fid?.pattern && !fid.generic_ids.includes(taxId) && !new RegExp(fid.pattern).test(taxId)) return bad("tax_id", `Not a valid ${fid.kind}`);
+  if (!name) return bad("legal_name", "The legal name is required");
+  if (!regime) return bad("tax_regime", "The tax regime is required");
+  const entry = fid?.regimes.find((r) => r.code === regime);
+  if (fid && !entry) return bad("tax_regime", `Unknown tax regime ${regime}`);
+  const person = fid?.generic_ids.includes(taxId) ? null : mockPersonType(taxId);
+  if (entry && person && entry.person_types.length > 0 && !entry.person_types.includes(person)) {
+    return bad("tax_regime", `The regime ${regime} does not apply to this ${fid.kind}`);
+  }
+  const postalPattern = region?.address?.postal_code?.pattern;
+  if (!postal || postalPattern && !new RegExp(postalPattern).test(postal)) return bad("postal_code", "Not a valid postal code");
+  if (!use) return bad("use", "The invoice use is required");
+  const useEntry = fid?.invoice_uses.find((u) => u.code === use);
+  if (fid && !useEntry) return bad("use", `Unknown invoice use ${use}`);
+  if (useEntry?.allowed_regimes && useEntry.allowed_regimes.length > 0 && !useEntry.allowed_regimes.includes(regime)) {
+    return bad("use", `The regime ${regime} does not admit the use ${use}`);
+  }
+  return null;
+}
+function maskTaxId(taxId) {
+  const v = taxId.trim();
+  return v.length <= 4 ? "*".repeat(v.length) : `${v.slice(0, 2)}${"*".repeat(v.length - 5)}${v.slice(-3)}`;
+}
+
 // src/mock/seed.ts
 var MOCK_IMAGE_URL = (seed, width = 800, height = 800) => `https://picsum.photos/seed/${encodeURIComponent(seed)}/${width}/${height}`;
 var MOCK_CURRENCY = "MXN";
@@ -339,17 +1282,19 @@ function buildCustomers() {
 
 // src/mock/index.ts
 var HttpError = class extends Error {
-  constructor(status, code, message, field, details) {
+  constructor(status, code, message, field, details, requiredScopes) {
     super(message);
     this.status = status;
     this.code = code;
     this.field = field;
     this.details = details;
+    this.requiredScopes = requiredScopes;
   }
   status;
   code;
   field;
   details;
+  requiredScopes;
 };
 var PUBLIC_CACHE = "public, max-age=60, stale-while-revalidate=600";
 var PRIVATE_CACHE = "private, no-store";
@@ -399,8 +1344,24 @@ function createMockStorefront(options = {}) {
     password: true,
     email_verification: true,
     otp_channels: ["email"],
+    invoicing: {
+      available: true,
+      countries: ["MX"],
+      checkout: "optional",
+      post_purchase: true,
+      window_days: 30,
+      identity_documents: ["MX:csf"],
+      online_verify: false
+    },
     ...options.customerCapabilities
   };
+  const missingScopes = options.missingScopes ?? [];
+  if (missingScopes.includes("customer:write")) {
+    capabilities.password = false;
+    capabilities.unavailable_reason = "missing_scope";
+    capabilities.missing_scopes = ["customer:write"];
+  }
+  const region = options.region === void 0 ? MOCK_REGION_MX : options.region;
   const maxLoginAttempts = options.maxLoginAttempts ?? 5;
   const MIN_PASSWORD = 10;
   const MAX_PASSWORD = 128;
@@ -444,6 +1405,7 @@ function createMockStorefront(options = {}) {
       checkouts: /* @__PURE__ */ new Map(),
       payments: /* @__PURE__ */ new Map(),
       restock: /* @__PURE__ */ new Set(),
+      invoices: /* @__PURE__ */ new Map(),
       seq: 0
     };
   }
@@ -706,9 +1668,39 @@ function createMockStorefront(options = {}) {
         tax_included: true
       },
       note: cart.note,
+      invoice: cart.invoice ? cartInvoiceOf(cart.invoice) : null,
       updated_at: cart.updated_at
     };
   }
+  function cartInvoiceOf(inv) {
+    const taxId = typeof inv.tax_id === "string" ? inv.tax_id : typeof inv.rfc === "string" ? inv.rfc : "";
+    const name = typeof inv.legal_name === "string" ? inv.legal_name : typeof inv.razon_social === "string" ? inv.razon_social : null;
+    return {
+      requested: true,
+      tax_id_masked: taxId ? maskTaxId(taxId) : null,
+      legal_name: name,
+      country_code: inv.country_code ?? region?.country_code ?? null,
+      document_kind: inv.document?.kind ?? null
+    };
+  }
+  function parseInvoice(raw, prefix = "invoice") {
+    if (raw === null || raw === void 0) return null;
+    if (typeof raw !== "object" || Array.isArray(raw)) throw new HttpError(400, "validation", "invoice must be an object", prefix);
+    const inv = raw;
+    if (inv.requested === false) return null;
+    const problem = validateInvoiceRequest(region, inv, prefix);
+    if (problem) throw new HttpError(422, "invalid_state", problem.message, problem.field);
+    return inv;
+  }
+  const orderInvoice = (order) => {
+    const entry = state.invoices.get(order.id);
+    const paid = order.status !== "pending_payment";
+    if (entry) {
+      const stage = entry.stage === "awaiting_payment" && paid ? "queued" : entry.stage;
+      return { stage, requested: true, status: stage === "issued" ? "issued" : "requested", action: stage === "awaiting_payment" ? "wait" : "none", can_request: false, url: null, xml_url: null };
+    }
+    return paid ? { status: "not_requested", stage: "not_requested", requested: false, action: "request", can_request: true, blocked_reason: null } : { status: "not_requested", stage: "not_requested", requested: false, action: "none", can_request: false, blocked_reason: "awaiting_payment" };
+  };
   function requireCustomer(headers) {
     const token = headers.get("x-customer-token");
     const id = token ? state.sessions.get(token) : void 0;
@@ -781,6 +1773,10 @@ function createMockStorefront(options = {}) {
     return value;
   };
   route("GET", "/shop", "catalog:read", () => ({ body: state.shop, cache: "public" }));
+  route("GET", "/region", "catalog:read", () => {
+    if (!region) throw new HttpError(404, "not_found", "No region configured");
+    return { body: region, cache: "public" };
+  });
   route("GET", "/products", "catalog:read", ({ search }) => ({ body: listProducts(search), cache: "public" }));
   route("GET", "/products/:handle", "catalog:read", ({ params }) => ({
     body: requireNode(state.products.find((p) => p.handle === params[0]), `Product ${params[0]}`),
@@ -837,6 +1833,8 @@ function createMockStorefront(options = {}) {
       shipping_address: null,
       delivery: { method: null, rate_id: null, branch_id: null },
       note: null,
+      invoice: null,
+      checkedOut: false,
       updated_at: now()
     };
     if (body.lines !== void 0) addLines(cart, validateLines(body.lines));
@@ -933,6 +1931,13 @@ function createMockStorefront(options = {}) {
     cart.updated_at = now();
     return { body: renderCart(cart), cache: "private" };
   });
+  route("PUT", "/carts/:id/invoice", "cart:write", ({ params, body }) => {
+    const cart = getCartRecord(params[0]);
+    if (cart.checkedOut) throw new HttpError(409, "already_checked_out", "The cart is already an order");
+    cart.invoice = parseInvoice(body);
+    cart.updated_at = now();
+    return { body: renderCart(cart), cache: "private" };
+  });
   route("PUT", "/carts/:id/note", "cart:write", ({ params, body }) => {
     const cart = getCartRecord(params[0]);
     const raw = body.note;
@@ -983,6 +1988,7 @@ function createMockStorefront(options = {}) {
     }
     if (typeof body.payment_method !== "string" || !body.payment_method) throw new HttpError(400, "validation", "payment_method is required", "payment_method");
     if (typeof body.return_url !== "string" || !body.return_url) throw new HttpError(400, "validation", "return_url is required", "return_url");
+    const invoice = body.invoice !== void 0 ? parseInvoice(body.invoice) : record.invoice;
     checkStock(record.lines.map((l, i) => ({ variant: findVariant(l.variant_id).variant, quantity: l.quantity, lineId: l.id, field: `lines[${i}].quantity` })));
     for (const l of record.lines) {
       const v = findVariant(l.variant_id).variant;
@@ -1027,6 +2033,8 @@ function createMockStorefront(options = {}) {
       }
     };
     state.checkouts.set(checkoutId, result);
+    record.checkedOut = true;
+    if (invoice) state.invoices.set(orderId, { stage: "awaiting_payment", request: invoice });
     if (key) state.idempotency.set(`${params[0]}:${key}`, { status: 201, body: result });
     return { status: 201, body: result, cache: "private" };
   });
@@ -1120,6 +2128,8 @@ function createMockStorefront(options = {}) {
     } else {
       payment = { provider: "mock", status: "paid" };
       found.checkout.status = "paid";
+      const order = state.orders.find((o) => o.id === found.checkout.external_order_id);
+      if (order) order.status = "paid";
     }
     payment.outcome = payment.status === "paid" ? "approved" : payment.status === "failed" ? "rejected" : payment.action?.type === "challenge" ? "challenge" : "pending";
     const result = { attempt: { n: st.attempts }, payment, checkout: found.checkout, attempts_left: attemptsLeft };
@@ -1239,8 +2249,38 @@ function createMockStorefront(options = {}) {
     state.loginFailures.delete(email);
     return { status: 204 };
   });
-  route("GET", "/customer", "customer:read", ({ headers }) => ({ body: requireCustomer(headers), cache: "private" }));
-  const stripOrder = ({ customer_id: _c, ...o }) => o;
+  const publicCustomer = (c) => {
+    if (!c.fiscal?.document) return c;
+    const { sha256: _sha, ...document } = c.fiscal.document;
+    return { ...c, fiscal: { ...c.fiscal, document } };
+  };
+  route("GET", "/customer", "customer:read", ({ headers }) => ({ body: publicCustomer(requireCustomer(headers)), cache: "private" }));
+  route("PATCH", "/customer", "customer:write", ({ headers, body }) => {
+    const c = requireCustomer(headers);
+    const text = (v) => typeof v === "string" && v.trim() ? v.trim() : null;
+    if ("first_name" in body) c.first_name = text(body.first_name);
+    if ("last_name" in body) c.last_name = text(body.last_name);
+    if ("phone" in body) c.phone = text(body.phone);
+    if ("fiscal" in body) {
+      if (body.fiscal === null) c.fiscal = null;
+      else {
+        const fiscal = parseInvoice({ ...body.fiscal, requested: true }, "fiscal");
+        const fid = {
+          country_code: String(fiscal.country_code ?? region?.country_code ?? ""),
+          tax_id: String(fiscal.tax_id ?? fiscal.rfc).toUpperCase(),
+          legal_name: String(fiscal.legal_name ?? fiscal.razon_social),
+          tax_regime: String(fiscal.tax_regime ?? fiscal.regimen),
+          postal_code: String(fiscal.postal_code ?? fiscal.cp),
+          invoice_use: String(fiscal.use ?? fiscal.uso_cfdi ?? "") || null,
+          document: fiscal.document ?? null,
+          verification: { status: "reviewed", checked_at: now() }
+        };
+        c.fiscal = fid;
+      }
+    }
+    return { body: publicCustomer(c), cache: "private" };
+  });
+  const stripOrder = ({ customer_id: _c, ...o }) => ({ ...o, invoice: orderInvoice(o) });
   route("GET", "/customer/orders", "orders:read", ({ headers, search }) => {
     const c = requireCustomer(headers);
     const orders = state.orders.filter((o) => o.customer_id === c.id).sort((a, b) => b.created_at.localeCompare(a.created_at)).map(stripOrder);
@@ -1256,9 +2296,16 @@ function createMockStorefront(options = {}) {
     if (!Array.isArray(body.lines) || body.lines.length === 0) throw new HttpError(400, "validation", "lines are required", "lines");
     return { status: 201, body: { id: nextId("ret"), order_id: order.id, status: "requested" }, cache: "private" };
   });
-  route("POST", "/customer/orders/:id/invoice", "customer:write", ({ headers, params }) => {
-    findOrder(headers, params[0]);
-    return { status: 202, body: { status: "requested", url: null }, cache: "private" };
+  route("POST", "/customer/orders/:id/invoice", "customer:write", ({ headers, params, body }) => {
+    const order = findOrder(headers, params[0]);
+    const existing = state.invoices.get(order.id);
+    if (existing && existing.stage !== "awaiting_payment") {
+      return { status: existing.stage === "issued" ? 200 : 202, body: { status: existing.stage === "issued" ? "issued" : "requested", url: null, stage: existing.stage, invoice: orderInvoice(order) }, cache: "private" };
+    }
+    const request = parseInvoice({ ...body, requested: true }, "invoice");
+    if (order.status === "pending_payment") throw new HttpError(409, "awaiting_payment", "The order is not paid yet");
+    state.invoices.set(order.id, { stage: "queued", request });
+    return { status: 202, body: { status: "requested", url: null, stage: "queued", invoice: orderInvoice(order) }, cache: "private" };
   });
   route("GET", "/customer/addresses", "customer:read", ({ headers }) => {
     const c = requireCustomer(headers);
@@ -1313,9 +2360,11 @@ function createMockStorefront(options = {}) {
   }));
   function scopesFor(token) {
     if (!token) return null;
-    if (token.startsWith("pk_")) return /* @__PURE__ */ new Set(["catalog:read", "content:read", "cart:write"]);
-    if (token.startsWith("sk_")) return /* @__PURE__ */ new Set(["catalog:read", "content:read", "cart:write", "checkout:write", "customer:read", "customer:write", "orders:read"]);
-    return null;
+    let all;
+    if (token.startsWith("pk_")) all = ["catalog:read", "content:read", "cart:write"];
+    else if (token.startsWith("sk_")) all = ["catalog:read", "content:read", "cart:write", "checkout:write", "customer:read", "customer:write", "orders:read"];
+    else return null;
+    return new Set(all.filter((sc) => !missingScopes.includes(sc)));
   }
   function json(status, body, headers = {}) {
     return new Response(status === 204 || body === void 0 ? null : JSON.stringify(body), {
@@ -1326,12 +2375,18 @@ function createMockStorefront(options = {}) {
   function errorResponse(err) {
     return json(
       err.status,
-      { error: { code: err.code, message: err.message, ...err.field ? { field: err.field } : {}, ...err.details !== void 0 ? { details: err.details } : {} } },
+      { error: { code: err.code, message: err.message, ...err.field ? { field: err.field } : {}, ...err.details !== void 0 ? { details: err.details } : {}, ...err.requiredScopes ? { required_scopes: err.requiredScopes } : {} } },
       { "Cache-Control": PRIVATE_CACHE }
     );
   }
   async function handle(request) {
     const url = new URL(request.url);
+    if (/\/_token\/?$/.test(url.pathname)) {
+      const tok = request.headers.get("authorization")?.match(/^Bearer\s+(.+)$/i)?.[1] ?? null;
+      const granted = scopesFor(tok);
+      if (!tok || !granted) return errorResponse(new HttpError(401, "unauthorized", "Missing or invalid storefront token"));
+      return json(200, { kind: tok.startsWith("pk_") ? "publishable" : "secret", environment: "sandbox", scopes: [...granted], missing_scopes: missingScopes, connection_id: "conn_mock", expires_at: null }, { "Cache-Control": PRIVATE_CACHE });
+    }
     const idx = url.pathname.indexOf("/storefront/");
     if (idx < 0) return errorResponse(new HttpError(404, "not_found", `No route for ${url.pathname}`));
     const path = url.pathname.slice(idx + "/storefront".length).replace(/\/+$/, "") || "/";
@@ -1344,7 +2399,9 @@ function createMockStorefront(options = {}) {
     const token = auth?.match(/^Bearer\s+(.+)$/i)?.[1] ?? null;
     const scopes = scopesFor(token);
     if (!scopes) return errorResponse(new HttpError(401, "unauthorized", "Missing or invalid storefront token"));
-    if (enforceScopes && !scopes.has(r.scope)) return errorResponse(new HttpError(403, "forbidden", `Token lacks scope ${r.scope}`));
+    if ((enforceScopes || missingScopes.length > 0) && !scopes.has(r.scope)) {
+      return errorResponse(new HttpError(403, "insufficient_scope", `Token lacks scope ${r.scope}`, void 0, void 0, [r.scope]));
+    }
     let body = {};
     if (method !== "GET" && method !== "DELETE") {
       const text = await request.text();
@@ -1399,6 +2456,6 @@ function createMockStorefront(options = {}) {
   };
 }
 
-export { MOCK_CURRENCY, MOCK_CUSTOMER_EMAIL, MOCK_IMAGE_URL, MOCK_POSTAL_CENTROIDS, 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, createMockStorefront };
 //# sourceMappingURL=mock.js.map
 //# sourceMappingURL=mock.js.map