@12-apps/payments-frontend 3.7.0 → 3.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@12-apps/payments-frontend",
-  "version": "3.7.0",
+  "version": "3.9.0",
   "type": "module",
   "description": "Browser half of the vendor-agnostic payments platform: plug-and-play MUI components for the per-provider settings page (credential form from each provider's schema, masked hints, verify/enable) and the checkout page (PIX QR + polling, card tokenization, hosted-checkout redirect), plus the headless hooks and fetch clients they build on. Talks only to the host's payments HTTP surface — never to a provider directly. Microfrontend-ready: no app coupling, host injects theme and auth.",
   "exports": {
@@ -17,7 +17,7 @@
     "storybook:build": "storybook build"
   },
   "dependencies": {
-    "@12-apps/payments-backend": "^4.15.0",
+    "@12-apps/payments-backend": "^4.17.0",
     "react-qr-code": "^2.2.0"
   },
   "peerDependencies": {

package/src/components/checkout/pt-BR.ts

@@ -1,8 +1,4 @@
-import type {
-  CheckoutViewCopy,
-  PaymentsUnavailableCopy,
-  PaymentStatusCopy,
-} from "./view-copy";
+import type { CheckoutViewCopy, PaymentStatusCopy } from "./view-copy";
 
 /**
  * The pt-BR pack — the exact sentences these views compiled in until 6.0.0,
@@ -10,15 +6,6 @@ import type {
  * what exempts this file from the copy-portability gate: Portuguese may ship,
  * it may not be silent.
  */
-export const PT_BR_PAYMENTS_UNAVAILABLE_COPY: PaymentsUnavailableCopy = {
-  title: "Pagamento online indisponível",
-  body: "Esta loja não recebe pagamentos pelo site. Combine o pagamento diretamente com a loja para concluir seu pedido.",
-  remedyTitle: "Pagamento com o garçom",
-  remedyBody: "Esta loja não recebe pagamentos pelo site. Chame o garçom para fechar a conta na mesa.",
-  callAction: "Chamar garçom",
-  callingAction: "Chamando...",
-};
-
 export const PT_BR_PAYMENT_STATUS_COPY: PaymentStatusCopy = {
   paid: {
     heading: "Pedido confirmado",

package/src/components/checkout/view-copy.ts

@@ -2,30 +2,26 @@
  * Every string the legacy checkout views render — required props, with NO
  * defaults, deliberately (the payments extraction's own doctrine, FUT-760):
  * a default in the origin host's language reads as finished to the next host
- * right up until a buyer sees it. These three views proved the point — the
- * flows factory's copy port existed, was REQUIRED, declared
+ * right up until a buyer sees it. These views proved the point — the flows
+ * factory's copy port existed, was REQUIRED, declared
  * `unavailableWithRemedyTitle` and `emptyCartAction`, and the views simply
  * never read it, so a host that dutifully passed copy still rendered another
  * product's voice.
  *
+ * The store-cannot-charge screen is NOT here any more. It shipped as a second
+ * component beside the factory's own — same two branches, but with the origin
+ * host's dining room welded into its API (`waiterAvailable`, `onCallWaiter`, a
+ * `checkout-call-waiter` test id) and a copy shape whose field names asked
+ * every adopter to name a waiter. The factory's screen says the same two
+ * things through `CheckoutAvailability.remedy` — a `{ label, onSelect }` the
+ * host fills with whatever its own remedy is — so the twin was deleted rather
+ * than renamed.
+ *
  * A pt-BR host imports {@link PT_BR_CHECKOUT_VIEW_COPY} from `./pt-BR` (the
  * package root re-exports it) and passes it by hand — one reviewable line,
  * never a silence.
  */
 
-/** The screen shown when the store cannot take money online. */
-export interface PaymentsUnavailableCopy {
-  /** No remedy: the store simply does not charge online. */
-  title: string;
-  body: string;
-  /** A remedy exists (the origin host: the waiter; a clinic: the front desk). */
-  remedyTitle: string;
-  remedyBody: string;
-  /** The remedy button, idle and in flight. */
-  callAction: string;
-  callingAction: string;
-}
-
 /** The stepper's three labels, in flow order. */
 export interface CheckoutStepperCopy {
   dados: string;

package/src/index.ts

@@ -84,19 +84,21 @@ export {
   type VaultedCardDisplay,
 } from './components/checkout/transport';
 export { type CheckoutHostPorts } from './components/checkout/use-checkout-controller';
-export { PaymentsUnavailable } from './components/checkout/payments-unavailable';
+// No `PaymentsUnavailable` here. The store-cannot-charge screen ships once, as
+// `createPaymentFlows().screens.PaymentsUnavailable`, which asks the host for a
+// `CheckoutAvailability.remedy` — `{ label, onSelect }`, filled with whatever
+// that host's remedy actually is. The component this line used to export was a
+// second copy of the same screen with the origin host's dining room in its API.
 export type {
   CheckoutStepperCopy,
   CheckoutViewCopy,
   DadosStepCopy,
   EmptyCartCopy,
   PaymentStatusCopy,
-  PaymentsUnavailableCopy,
   StatusOutcomeCopy,
 } from './components/checkout/view-copy';
 export {
   PT_BR_CHECKOUT_VIEW_COPY,
-  PT_BR_PAYMENTS_UNAVAILABLE_COPY,
   PT_BR_PAYMENT_STATUS_COPY,
 } from './components/checkout/pt-BR';
 export { fetchCheckoutConfig } from './components/checkout/client';

package/src/components/checkout/payments-unavailable.tsx

@@ -1,88 +0,0 @@
-/**
- * What a shopper sees when the store cannot take money online.
- *
- * A store with no active payment provider used to render the full payment step
- * — PIX and Cartão side by side — and only fail at order creation, with a
- * "tente novamente em instantes" that no amount of retrying could fix. The
- * store is not momentarily busy; it simply does not charge online.
- *
- * The remedy depends on how the store operates, so the two cases are answered
- * differently rather than with one vague apology:
- *
- *   waiter reachable — someone is there to take payment: offer the waiter.
- *   not reachable    — nobody is; say plainly that this store does not charge
- *                      online, so the shopper stops waiting for a payment screen.
- *
- * "Reachable" is a property of THIS shopper, not of the store: a mesas
- * restaurant also serves the balcão, and a shopper with no mesa has no comanda
- * for a waiter to close. Offering them the waiter sent them to a comanda screen
- * whose own mesa gate bounced them straight back to the menu — a dead end
- * dressed up as the remedy. So the caller decides, from the shopper's mesa.
- */
-import { Box } from "@mui/material";
-import type { JSX } from "react";
-
-import { useCheckoutComponents } from "./ui";
-import type { PaymentsUnavailableCopy } from "./view-copy";
-
-interface PaymentsUnavailableProps {
-  /**
-   * Every sentence this screen can say — the HOST's words (see
-   * `./view-copy`). Until 6.0.0 the two remedies and the button were compiled
-   * in, in one application's Portuguese, and a host that dutifully passed the
-   * flows copy port still got them.
-   */
-  copy: PaymentsUnavailableCopy;
-  /**
-   * Whether THIS shopper can settle with a waiter — mesas on AND a mesa of
-   * their own. Decides which remedy is offered.
-   */
-  waiterAvailable: boolean;
-  /** Called when the shopper asks for a waiter. Omitted ⇒ no button. */
-  onCallWaiter?: () => void;
-  /** True while the waiter request is in flight. */
-  calling?: boolean;
-}
-
-export function PaymentsUnavailable({
-  copy,
-  waiterAvailable,
-  onCallWaiter,
-  calling = false,
-}: PaymentsUnavailableProps): JSX.Element {
-  const { Alert, Button } = useCheckoutComponents();
-  if (!waiterAvailable) {
-    return (
-      <Box sx={{ display: "flex", flexDirection: "column", gap: 2 }} data-testid="checkout-payments-disabled">
-        <Alert
-          variant="info"
-          title={copy.title}
-          description={copy.body}
-          showIcon
-        />
-      </Box>
-    );
-  }
-
-  return (
-    <Box sx={{ display: "flex", flexDirection: "column", gap: 2 }} data-testid="checkout-call-waiter">
-      <Alert
-        variant="info"
-        title={copy.remedyTitle}
-        description={copy.remedyBody}
-        showIcon
-      />
-      {onCallWaiter ? (
-        <Button
-          variant="solid"
-          size="lg"
-          disabled={calling}
-          onClick={onCallWaiter}
-          dataTestId="checkout-call-waiter-button"
-        >
-          {calling ? copy.callingAction : copy.callAction}
-        </Button>
-      ) : null}
-    </Box>
-  );
-}