@asteby/storefront-react 0.23.0 → 0.24.0

package/dist/fiscal.d.cts

@@ -2,8 +2,8 @@ import * as react from 'react';
 import { ReactNode, RefObject } from 'react';
 import { F as FieldErrors, a as CheckoutFieldClassNames } from './fields-vnMUi2HB.cjs';
 import { Region, RegionFiscalId, RegionFiscalEntry, InvoiceRequest, FiscalDocumentEvidence, IdentityDocumentSpec, InvoicingCapabilities, FiscalIdentity, InvoiceSummary } from '@asteby/storefront';
-import { f as FiscalReadError, d as FiscalFieldValues, c as FiscalFieldName, F as FiscalActionData, b as FiscalExtractionSummary } from './types-CZ3PleG6.cjs';
-export { a as FiscalErrorCode, e as FiscalIntent } from './types-CZ3PleG6.cjs';
+import { f as FiscalReadError, d as FiscalFieldValues, c as FiscalFieldName, F as FiscalActionData, g as FiscalReason, b as FiscalExtractionSummary } from './types-Cgx_65eM.cjs';
+export { a as FiscalErrorCode, e as FiscalIntent } from './types-Cgx_65eM.cjs';
 import { IdentityExtraction } from '@asteby/storefront/fiscal-document';
 
 /** Texts of the fiscal components. Spanish (es-MX) by default, English with `en*`, any locale with `messages`. */
@@ -136,6 +136,17 @@ type FiscalMessages = {
         windowBody: string;
         unavailableTitle: string;
         unavailableBody: string;
+        /** The server says the store has no invoicing active (`capabilities.invoicing.available: false`). */
+        notEnabledTitle: string;
+        notEnabledBody: string;
+        /** The server does not say (older server) or could not be asked: never claims the store does not invoice. */
+        unknownTitle: string;
+        unknownBody: string;
+        unreachableBody: string;
+        /** Invoicing in test mode (sandbox): invoices have no fiscal validity. */
+        sandbox: string;
+        /** `{days}`: how long after the purchase an invoice can be requested. */
+        windowNote: string;
         cancelledTitle: string;
         cancelledBody: string;
         /** `reason_code` -> cause for the buyer. `default` when unknown. */
@@ -357,14 +368,28 @@ type InvoiceToggleProps = {
 };
 declare function InvoiceToggle(props: InvoiceToggleProps): react.JSX.Element | null;
 
-type InvoiceCardState = 'not_requested' | 'awaiting_payment' | 'processing' | 'issued' | 'needs_data' | 'needs_review' | 'window_closed' | 'unavailable' | 'cancelled';
-/** Which of the card's states an invoice is in. `available: false` (the store does not invoice) wins over everything. */
-declare function invoiceCardState(invoice: InvoiceSummary | null | undefined, available?: boolean): InvoiceCardState;
+type InvoiceCardState = 'not_requested' | 'awaiting_payment' | 'processing' | 'issued' | 'needs_data' | 'needs_review' | 'window_closed' | 'unavailable' | 'not_enabled' | 'unknown' | 'unreachable' | 'cancelled';
+/**
+ * Which of the card's states an invoice is in.
+ *
+ * `available` / `reason` come from `loadFiscalContext`. Only a server that SAYS the store does not invoice
+ * (`reason` `off` / `no_region`) wins over the order: `not_enabled`. When the server says nothing (`unknown`, an older
+ * server), could not be asked (`unreachable`) or the caller gave no `reason`, the order's own summary still decides
+ * (an order that `can_request`, is being issued or already has its invoice is shown as such) and, with nothing to show,
+ * the card is neutral: it never claims that the store does not issue invoices.
+ */
+declare function invoiceCardState(invoice: InvoiceSummary | null | undefined, available?: boolean, reason?: FiscalReason): InvoiceCardState;
 type InvoiceStatusCardClassNames = Partial<Record<'root' | 'title' | 'body' | 'actions' | 'primary' | 'secondary' | 'link' | 'meta', string>>;
 type InvoiceStatusCardProps = {
     invoice?: InvoiceSummary | null;
-    /** `capabilities.invoicing.available`. `false`: "Invoice not available". */
+    /** `loadFiscalContext(...).available`. `false` alone is read as "unknown": see `availability`. */
     available?: boolean;
+    /** `loadFiscalContext(...).reason`: why it is (not) available. Lets the card say the true thing (not active / unknown / could not check). */
+    availability?: FiscalReason;
+    /** Invoicing is in test mode (sandbox): shows a badge saying invoices have no fiscal validity. */
+    testMode?: boolean;
+    /** `capabilities.invoicing.window_days`: shown next to the request button. */
+    windowDays?: number;
     /** The buyer taps "Request invoice". Shown when `invoice.can_request !== false`. Without it, `requestHref` is a link. */
     onRequest?: () => void;
     requestHref?: string;

package/dist/fiscal.d.ts

@@ -2,8 +2,8 @@ import * as react from 'react';
 import { ReactNode, RefObject } from 'react';
 import { F as FieldErrors, a as CheckoutFieldClassNames } from './fields-vnMUi2HB.js';
 import { Region, RegionFiscalId, RegionFiscalEntry, InvoiceRequest, FiscalDocumentEvidence, IdentityDocumentSpec, InvoicingCapabilities, FiscalIdentity, InvoiceSummary } from '@asteby/storefront';
-import { f as FiscalReadError, d as FiscalFieldValues, c as FiscalFieldName, F as FiscalActionData, b as FiscalExtractionSummary } from './types-CZ3PleG6.js';
-export { a as FiscalErrorCode, e as FiscalIntent } from './types-CZ3PleG6.js';
+import { f as FiscalReadError, d as FiscalFieldValues, c as FiscalFieldName, F as FiscalActionData, g as FiscalReason, b as FiscalExtractionSummary } from './types-Cgx_65eM.js';
+export { a as FiscalErrorCode, e as FiscalIntent } from './types-Cgx_65eM.js';
 import { IdentityExtraction } from '@asteby/storefront/fiscal-document';
 
 /** Texts of the fiscal components. Spanish (es-MX) by default, English with `en*`, any locale with `messages`. */
@@ -136,6 +136,17 @@ type FiscalMessages = {
         windowBody: string;
         unavailableTitle: string;
         unavailableBody: string;
+        /** The server says the store has no invoicing active (`capabilities.invoicing.available: false`). */
+        notEnabledTitle: string;
+        notEnabledBody: string;
+        /** The server does not say (older server) or could not be asked: never claims the store does not invoice. */
+        unknownTitle: string;
+        unknownBody: string;
+        unreachableBody: string;
+        /** Invoicing in test mode (sandbox): invoices have no fiscal validity. */
+        sandbox: string;
+        /** `{days}`: how long after the purchase an invoice can be requested. */
+        windowNote: string;
         cancelledTitle: string;
         cancelledBody: string;
         /** `reason_code` -> cause for the buyer. `default` when unknown. */
@@ -357,14 +368,28 @@ type InvoiceToggleProps = {
 };
 declare function InvoiceToggle(props: InvoiceToggleProps): react.JSX.Element | null;
 
-type InvoiceCardState = 'not_requested' | 'awaiting_payment' | 'processing' | 'issued' | 'needs_data' | 'needs_review' | 'window_closed' | 'unavailable' | 'cancelled';
-/** Which of the card's states an invoice is in. `available: false` (the store does not invoice) wins over everything. */
-declare function invoiceCardState(invoice: InvoiceSummary | null | undefined, available?: boolean): InvoiceCardState;
+type InvoiceCardState = 'not_requested' | 'awaiting_payment' | 'processing' | 'issued' | 'needs_data' | 'needs_review' | 'window_closed' | 'unavailable' | 'not_enabled' | 'unknown' | 'unreachable' | 'cancelled';
+/**
+ * Which of the card's states an invoice is in.
+ *
+ * `available` / `reason` come from `loadFiscalContext`. Only a server that SAYS the store does not invoice
+ * (`reason` `off` / `no_region`) wins over the order: `not_enabled`. When the server says nothing (`unknown`, an older
+ * server), could not be asked (`unreachable`) or the caller gave no `reason`, the order's own summary still decides
+ * (an order that `can_request`, is being issued or already has its invoice is shown as such) and, with nothing to show,
+ * the card is neutral: it never claims that the store does not issue invoices.
+ */
+declare function invoiceCardState(invoice: InvoiceSummary | null | undefined, available?: boolean, reason?: FiscalReason): InvoiceCardState;
 type InvoiceStatusCardClassNames = Partial<Record<'root' | 'title' | 'body' | 'actions' | 'primary' | 'secondary' | 'link' | 'meta', string>>;
 type InvoiceStatusCardProps = {
     invoice?: InvoiceSummary | null;
-    /** `capabilities.invoicing.available`. `false`: "Invoice not available". */
+    /** `loadFiscalContext(...).available`. `false` alone is read as "unknown": see `availability`. */
     available?: boolean;
+    /** `loadFiscalContext(...).reason`: why it is (not) available. Lets the card say the true thing (not active / unknown / could not check). */
+    availability?: FiscalReason;
+    /** Invoicing is in test mode (sandbox): shows a badge saying invoices have no fiscal validity. */
+    testMode?: boolean;
+    /** `capabilities.invoicing.window_days`: shown next to the request button. */
+    windowDays?: number;
     /** The buyer taps "Request invoice". Shown when `invoice.can_request !== false`. Without it, `requestHref` is a link. */
     onRequest?: () => void;
     requestHref?: string;

package/dist/fiscal.js

@@ -1,8 +1,8 @@
 import { personTypeResolver, validateFiscalValues, regimesFor, usesFor, normalizeTaxId, entryLabel, suggestInvoiceUse, summarizeExtraction, toInvoiceRequest, maskTaxId } from './chunk-D5L7UZIA.js';
 export { entryLabel, maskTaxId, normalizeTaxId, personTypeByLength, personTypeFromPatterns, personTypeResolver, postalCodeProblem, regimesFor, suggestInvoiceUse, summarizeExtraction, taxIdProblem, toInvoiceRequest, usesFor, validateFiscalValues } from './chunk-D5L7UZIA.js';
 import { useModalDialog } from './chunk-ZBH7JYU4.js';
-import { fiscalMessages, fill } from './chunk-VE7WQPMY.js';
-export { fiscalMessages } from './chunk-VE7WQPMY.js';
+import { fiscalMessages, fill } from './chunk-5XYQLOE3.js';
+export { fiscalMessages } from './chunk-5XYQLOE3.js';
 import { CheckoutField, ErrorSummary } from './chunk-DFGLCIEG.js';
 import { useResolvedLocale } from './chunk-T52H5HL3.js';
 import './chunk-DQBL2DFJ.js';
@@ -988,8 +988,7 @@ function labelOf(list, code, locale) {
   const e = list?.find((x) => x.code === code);
   return e ? `${e.code} \xB7 ${entryLabel(e, locale)}` : code;
 }
-function invoiceCardState(invoice, available = true) {
-  if (!available) return "unavailable";
+function orderState(invoice) {
   if (!invoice) return "not_requested";
   const stage = invoice.stage ?? "";
   const blocked = invoice.blocked_reason ?? "";
@@ -1004,11 +1003,18 @@ function invoiceCardState(invoice, available = true) {
   if (invoice.can_request === false && blocked) return "unavailable";
   return "not_requested";
 }
+function invoiceCardState(invoice, available = true, reason) {
+  if (available) return orderState(invoice);
+  if (reason === "off" || reason === "no_region") return "not_enabled";
+  const own = orderState(invoice);
+  if (invoice && (own !== "not_requested" || invoice.can_request === true || invoice.action === "request")) return own;
+  return reason === "unreachable" ? "unreachable" : "unknown";
+}
 function InvoiceStatusCard(props) {
-  const { invoice, available = true, onRequest, requestHref, onCorrect, correctHref, onRefresh, refreshMs = 1e4, refreshForMs = 6e4, contact, messages, classNames: cx = {}, headingLevel = 3 } = props;
+  const { invoice, available = true, availability, testMode, windowDays, onRequest, requestHref, onCorrect, correctHref, onRefresh, refreshMs = 1e4, refreshForMs = 6e4, contact, messages, classNames: cx = {}, headingLevel = 3 } = props;
   const locale = useResolvedLocale(props.locale);
   const m = fiscalMessages(locale, messages).status;
-  const state = invoiceCardState(invoice, available);
+  const state = invoiceCardState(invoice, available, availability);
   const titleId = `sf-invoice-card-${useId().replace(/:/g, "")}`;
   const [tired, setTired] = useState(false);
   const refresh = useRef(onRefresh);
@@ -1041,7 +1047,10 @@ function InvoiceStatusCard(props) {
   switch (state) {
     case "not_requested": {
       title = m.title;
-      body = /* @__PURE__ */ jsx("p", { className: cx.body, children: m.requestHelp });
+      body = /* @__PURE__ */ jsxs(Fragment, { children: [
+        /* @__PURE__ */ jsx("p", { className: cx.body, children: m.requestHelp }),
+        windowDays && windowDays > 0 ? /* @__PURE__ */ jsx("p", { className: cx.meta, "data-sf-invoice-window": true, children: fill(m.windowNote, { days: windowDays }) }) : null
+      ] });
       const can = invoice?.can_request !== false;
       if (can && (onRequest || requestHref)) {
         actions = onRequest ? /* @__PURE__ */ jsx("button", { type: "button", className: cx.primary, onClick: onRequest, "data-sf-invoice-request": true, children: m.request }) : /* @__PURE__ */ jsx("a", { href: requestHref, className: cx.primary, "data-sf-invoice-request": true, children: m.request });
@@ -1099,6 +1108,18 @@ function InvoiceStatusCard(props) {
       title = m.cancelledTitle;
       body = /* @__PURE__ */ jsx("p", { className: cx.body, children: m.cancelledBody });
       break;
+    case "not_enabled":
+    case "unknown":
+    case "unreachable": {
+      title = state === "not_enabled" ? m.notEnabledTitle : m.unknownTitle;
+      body = /* @__PURE__ */ jsx("p", { className: cx.body, children: state === "not_enabled" ? m.notEnabledBody : state === "unreachable" ? m.unreachableBody : m.unknownBody });
+      const mail = contact?.url ?? (contact?.email ? `mailto:${contact.email}` : null);
+      actions = /* @__PURE__ */ jsxs(Fragment, { children: [
+        state === "unreachable" && onRefresh ? /* @__PURE__ */ jsx("button", { type: "button", className: cx.secondary, onClick: manualRefresh, "data-sf-invoice-refresh": true, children: m.refresh }) : null,
+        mail ? /* @__PURE__ */ jsx("a", { href: mail, className: cx.secondary, "data-sf-invoice-contact": true, children: m.contact }) : null
+      ] });
+      break;
+    }
     default:
       title = m.unavailableTitle;
       body = /* @__PURE__ */ jsx("p", { className: cx.body, children: m.unavailableBody });
@@ -1110,6 +1131,7 @@ function InvoiceStatusCard(props) {
       title
     ] }),
     /* @__PURE__ */ jsx("div", { "aria-live": live || state === "issued" ? "polite" : void 0, "data-sf-invoice-live": true, children: body }),
+    testMode ? /* @__PURE__ */ jsx("p", { className: cx.meta, "data-sf-invoice-sandbox": true, children: m.sandbox }) : null,
     actions ? /* @__PURE__ */ jsx("div", { className: cx.actions, "data-sf-invoice-actions": true, children: actions }) : null
   ] });
 }
@@ -1122,6 +1144,9 @@ var ICON = {
   needs_review: "\u25D0",
   window_closed: "\u2013",
   unavailable: "\u2013",
+  not_enabled: "\u2013",
+  unknown: "?",
+  unreachable: "?",
   cancelled: "\xD7"
 };