@vtex/faststore 0.0.7 → 0.0.10

package/dist/docs/sign-in-redirect.md

@@ -1,7 +1,7 @@
 # SignInRedirect
 
 **Category:** identity
-**Purpose:** The whole of the `/login` route — hands the document over to the account's platform login, carrying the shopper's way back.
+**Purpose:** The whole of the sign-in page — hands the document over to the account's platform login, carrying the shopper's way back.
 
 ---
 
@@ -13,7 +13,7 @@ The image is the source of truth for layout, and this component is not in any la
 
 ## When to use
 
-- On the `/login` page, as its only element, when the store's account lives on the VTEX platform's login rather than on the storefront.
+- On the sign-in page (`{ standard: 'sign-in' }`), as its only element, when the store's account lives on the VTEX platform's login rather than on the storefront.
 
 ## When NOT to use
 
@@ -32,7 +32,7 @@ The image is the source of truth for layout, and this component is not in any la
 SignInRedirect
 ```
 
-It requires no `SessionRoot` and declares no context: it reads nothing of the shopper's. `/login` deliberately sits outside the account layout, so a shopper who is already signed in still makes the hop.
+It requires no `SessionRoot` and declares no context: it reads nothing of the shopper's. The sign-in page deliberately sits outside the account layout, so a shopper who is already signed in still makes the hop.
 
 ## Components
 
@@ -40,7 +40,7 @@ It requires no `SessionRoot` and declares no context: it reads nothing of the sh
 
 | Prop | Type | Default | Notes |
 |------|------|---------|-------|
-| `platformLoginUrl` | string | — | The account's platform login. An absolute URL (`https://account.example.net/api/io/login`) or a site-relative path (`/api/io/login`). The storefront's own `/login` is refused, whichever way it is spelled. Required in practice: with no usable value the component renders nothing. |
+| `platformLoginUrl` | string | — | The account's platform login. An absolute URL (`https://account.example.net/api/io/login`) or a site-relative path (`/api/io/login`). The storefront's own sign-in page is refused, whichever way it is spelled. Required in practice: with no usable value the component renders nothing. |
 | `loadingLabel` | string | — | Text shown while the handover is pending. Absent renders the element with no text. |
 
 ### SignInRedirectLoading
@@ -57,7 +57,7 @@ Content model (`sign-in-redirect`) fields, edited in the CMS:
 
 **Only the return parameter crosses.** The component reads exactly one parameter from the incoming URL, `returnUrl`, and composes the destination from the authored address. Every other parameter on the incoming URL is dropped rather than forwarded into an auth URL; every parameter already on the authored address survives, because the destination is built from it.
 
-**The return is revalidated on arrival, not trusted.** `/login` is reachable by a hand-crafted link, so the value is treated as shopper-supplied whoever produced it. A return that leaves the site, is protocol-relative, or points back at `/login` itself is dropped — never rewritten into a working one — and a bounded warning names the reason. Refusing a self-referential return is what keeps a shopper who just authenticated from being handed to the platform a second time.
+**The return is revalidated on arrival, not trusted.** `returnUrl` is a logical path, without the binding's base path, and this component prefixes it before the handover, so a shopper on `/pt-BR` returns to `/pt-BR/pvt/profile`. The sign-in page is reachable by a hand-crafted link, so the value is treated as shopper-supplied whoever produced it. A return that leaves the site, is protocol-relative, or points back at the sign-in page itself is dropped — never rewritten into a working one — and a bounded warning names the reason. Refusing a self-referential return is what keeps a shopper who just authenticated from being handed to the platform a second time.
 
 **The return's form follows the address's origin.** A path alone cannot say which origin it belongs to, and the store author is the one who decides whether the receiver shares the storefront's. A same-origin address gets the site-relative path exactly as it arrived; a cross-origin one would resolve that path against its own domain, so the value is absolutized first — always against the storefront's origin, never the address's.
 
@@ -92,7 +92,7 @@ Bound to a CMS entry, the element authors no `loadingLabel` at all — the entry
 - **Expecting it to skip the hop for a signed-in shopper.** It reads no session by design, so every visitor is handed over.
 - **Authoring `$content` in the schema.** `$content` is compiler-injected from the page's content entry; naming it in `props` fails the build.
 - **Authoring `returnUrl` on `platformLoginUrl`.** The shopper's return overwrites it; author the address's other parameters instead.
-- **Pointing `platformLoginUrl` at the storefront's own `/login`.** That is this route handed to itself, which would reload the page forever; the address is refused instead. Another host's `/login` is the platform's page and is fine.
+- **Pointing `platformLoginUrl` at the storefront's own sign-in page.** That is this page handed to itself, which would reload the page forever; the address is refused instead. Another host's `/login` is the platform's page and is fine.
 - **Selecting it from a screenshot.** It has no visual identity — a sign-in screen in an image is the platform's page, not this one.
 
 ---
@@ -118,7 +118,7 @@ That element carries both hooks: `data-fs-sign-in-redirect` is the component's i
 }
 ```
 
-A spinner beside the text is a decoration the component does not render. Draw it from the element itself, once per store, as the `SignInRedirect` base swatch in `global.json → styles`. `before:block` is what makes the pseudo-element take a width and height — an inline one ignores both:
+A spinner beside the text is a decoration the component does not render. Draw it from the element itself, once per store, as the `SignInRedirect` base swatch in `foundation.json → styles`. `before:block` is what makes the pseudo-element take a width and height — an inline one ignores both:
 
 ```json
 {

package/dist/docs/toast.md

@@ -21,23 +21,23 @@
 
 ## Composition
 
-`Toast` is not authored as a static PageSchema tree the way most components are. Only the **stack scaffolding** is mounted once, near the layout root:
+`Toast` is not authored as a per-toast PageSchema tree. The stack is mounted once in the layout schema, near the root. A `ToastViewport` with no children renders every toast itself; to control the markup, put a `ToastList` inside it with the per-toast card as a template:
 
 ```
 ToastProvider
 └── ToastPortal
     └── ToastViewport
+        └── ToastList            ← repeats its children once per queued toast
+            └── ToastRoot        ← the template; reads its toast from ToastList
+                ├── ToastTitle                (optional — auto-renders toast.title with no children)
+                ├── ToastDescription          (optional — auto-renders toast.description with no children)
+                ├── ToastAction (optional)    ← reversible action, e.g. "Undo"
+                └── ToastClose (optional)
 ```
 
-Every `ToastRoot` inside `ToastViewport` is rendered **imperatively** by mapping over `useToast().toasts` — it does not appear as a `children` entry in any page schema. A typical per-toast render tree (authored in application code, not in a schema):
+A `ToastViewport` with no children renders one default toast per entry of `useToast().toasts` (see below), so a page schema never lists a toast. Passing children takes control of the markup, and `ToastList` is the schema-composable way to do it: it renders its template once per queued toast and `ToastRoot` reads each toast from it. In application code you can instead map over `useToast().toasts` and pass `toast` to `ToastRoot` yourself.
 
-```
-ToastRoot                    ← one per queued toast, keyed by toast.id
-├── ToastTitle                (optional — auto-renders toast.title with no children)
-├── ToastDescription          (optional — auto-renders toast.description with no children)
-├── ToastAction (optional)    ← reversible action, e.g. "Undo"
-└── ToastClose (optional)
-```
+The message text is not in the schema. It comes from whoever calls `add()` at runtime. With no children, `ToastList` renders `ToastRoot > ToastTitle + ToastDescription` for each toast; a `ToastViewport` containing a `ToastList` counts as having children, so the default toasts do not render alongside it.
 
 `Icon` (existing particle) may be composed as a plain sibling of `ToastTitle`/`ToastDescription` inside `ToastRoot` — there is no dedicated status-icon sub-component. Wrap it in a plain `<span data-fs-toast-icon-container="">` at the call site for a tinted background; `ToastRoot` does not inject this wrapper itself, since it renders `children` verbatim. Style both hooks off `data-fs-toast-root-type`.
 
@@ -61,15 +61,25 @@ Renders `ToastViewport` into `document.body`. No props, context-only.
 
 The fixed-position stack container. Renders a `<div>` — style it directly.
 
-No props beyond standard `className`/HTML attributes.
+- **No children:** renders one default toast per active toast, in queue order: `ToastRoot` > `ToastTitle` + `ToastDescription` + `ToastAction` + `ToastClose`. Each part renders nothing when the toast has no matching text or `actionProps`, so a reversible toast shows its action between the text and the close button. The close button is named from the message catalog (`fs/toast.dismiss`); its `×` glyph is hidden from assistive technology. The default toast has no status icon and adds no `data-fs-*` hook beyond the existing ones.
+- **With children:** renders exactly those children and no default toast. `null`, `false` and `undefined` count as no children.
+- **Region name:** every viewport gets `aria-label` from the message catalog (`fs/toast.region`, "Notifications") unless you pass your own `aria-label`.
+
+No props beyond standard `className`/HTML attributes. It reads the message catalog, so it needs an intl provider ancestor (a generated app's root layout provides one).
+
+### ToastList
+
+Renders its `children` once for each queued toast, in the order of `useToast().toasts`, each inside a per-toast context that `ToastRoot` reads. With no children it renders `ToastRoot > ToastTitle + ToastDescription`. It renders no element of its own, so it adds no `data-fs-*` hook and takes no `style`. Without a `ToastProvider` ancestor it renders nothing. Place it as the direct child of `ToastViewport`.
+
+No props beyond `children`.
 
 ### ToastRoot
 
-One instance per active toast.
+One instance per active toast. Place it inside `ToastList` as the template, or render it yourself with an explicit `toast`. With neither, it renders nothing.
 
 | Prop | Type | Default | Notes |
 |------|------|---------|-------|
-| `toast` | `ToastObject` | — | Required. One entry from `useToast().toasts`. |
+| `toast` | `ToastObject` | toast from the enclosing `ToastList` | One entry from `useToast().toasts`. Wins over the list's toast when both exist. |
 | `swipeDirection` | `'up' \| 'down' \| 'left' \| 'right'` or an array of those | `['down', 'right']` | Directions the shopper can swipe to dismiss. |
 
 ### ToastTitle / ToastDescription
@@ -97,7 +107,18 @@ function SaveProfileButton() {
 }
 ```
 
-`useToast()` is Base UI's `useToastManager()` re-exported under the FastStore name — `toasts`, `add`, `close`, `update`, and `promise` all behave exactly as documented at [base-ui.com/react/components/toast](https://base-ui.com/react/components/toast).
+Under a provider-optional caller, such as a component that renders in layouts with or without a provider, use `useOptionalToast()`. It returns the same value as `useToast()`, or `null` when no `ToastProvider` is mounted, and never throws:
+
+```tsx
+import { useOptionalToast } from '@vtex/faststore/components';
+
+function RemoveButton() {
+  const toast = useOptionalToast();
+  return <button onClick={() => toast?.add({ title: 'Item removed' })}>Remove</button>;
+}
+```
+
+`useToast()` is Base UI's `useToastManager()` re-exported under the FastStore name, and it still throws without a provider. `toasts`, `add`, `close`, `update`, and `promise` all behave exactly as documented at [base-ui.com/react/components/toast](https://base-ui.com/react/components/toast).
 
 ---
 
@@ -106,6 +127,7 @@ function SaveProfileButton() {
 | Component | What you style | Plausible classes |
 |---|---|---|
 | `ToastViewport` | Positions the stack on the screen | `fixed bottom-4 right-4 flex flex-col gap-2 w-[320px]` |
+| `ToastList` | Nothing. It renders no element | — |
 | `ToastRoot` | The toast card's surface; key off `data-fs-toast-root-type` for status color | `rounded-lg px-4 py-3 shadow-lg data-[fs-toast-root-type=error]:bg-red-50` |
 | `ToastTitle` | Toast heading typography | `text-sm font-semibold` |
 | `ToastDescription` | Toast body typography | `text-sm text-gray-600` |

package/dist/index.d.ts

@@ -4,12 +4,16 @@ import { JsonValue, StorefrontContext } from "./core/dist/schema/generated/schem
 import { ContentArraySchema, ContentNestedObjectShape, ContentObjectPropertySchema, ContentObjectSchema, ContentPropertySchema, ContentPropertyType, ContentScalarSchema, ContentScalarType, ContentTypeDefinition, ContentValue, defineContentType } from "./core/dist/define-content-type.js";
 import { ComponentDefinition, EditorMetadata, FetchStrategy, PropSchema, PropSchemaField, PropType, VariableBinding, VariableBindings, defineComponent } from "./core/dist/define-component.js";
 import "./core/dist/index.js";
+import { PageRef, ResolveHrefReason, ResolveHrefResult, RouteIdentity, RouteKind, RouteMap, RouteMapEntry, StandardName } from "./sdk/navigation/types.js";
 import { CartUserError } from "./sdk/cart/operations.js";
 import { AddItemPayload, CartActions, CartCouponPayload, CartLinePayload, CartLinesPayload, CartQuantityPayload } from "./sdk/cart/use-cart-actions.js";
 import { ClientPreferenceKey, ClientProfileUserError, CustomerProfileUserError } from "./sdk/identity/operations.js";
 import { ClientPreferencesUpdatePayload, ClientProfileUpdatePayload, CustomerProfileUpdatePayload, IdentityActions } from "./sdk/identity/use-identity-actions.js";
+import { LocaleActions } from "./sdk/locale/use-locale-actions.js";
+import { OrderCancelOrder, OrderCancelUserError } from "./sdk/orders/order-operations.js";
+import { OrderActions, OrderCancelInput, OrderCancelResult } from "./sdk/orders/use-order-actions.js";
 import { PaymentBillingAddressUpdateInput, PaymentMethodSelectInput, PaymentMoney, PaymentUserError } from "./sdk/payment/operations.js";
-import { PaymentGatewayCard, PaymentGatewayNewCard, PaymentGatewaySavedCard, PaymentGatewayTransaction, SendPaymentsRequest } from "./sdk/payment/gateway.js";
+import { PaymentGatewayCard, PaymentGatewayNewCard, PaymentGatewayResult, PaymentGatewaySavedCard, PaymentGatewayTransaction, SendPaymentsRequest } from "./sdk/payment/gateway.js";
 import { PaymentActions, PaymentGatewayCallbackResult, PaymentStartTransactionResult } from "./sdk/payment/use-payment-actions.js";
 import { RegionUserError } from "./sdk/region/region-operations.js";
 import { RegionActions } from "./sdk/region/use-region-actions.js";
@@ -19,4 +23,5 @@ import { ShippingOptionSelectUserError } from "./sdk/shipping/option-select-oper
 import { ShippingAddressInput, ShippingAddressUpdateErrorEntity } from "./sdk/shipping/shipping-operations.js";
 import { ShippingActions } from "./sdk/shipping/use-shipping-actions.js";
 import { ComponentActions } from "./sdk/actions/types.js";
-export { type ActionSelector, type AddItemPayload, type CartActions, type CartCouponPayload, type CartLinePayload, type CartLinesPayload, type CartQuantityPayload, type CartUserError, type ClientPreferenceKey, type ClientPreferencesUpdatePayload, type ClientProfileUpdatePayload, type ClientProfileUserError, type ComponentActions, type ComponentDefinition, type ContentArraySchema, type ContentNestedObjectShape, type ContentObjectPropertySchema, type ContentObjectSchema, type ContentPropertySchema, type ContentPropertyType, type ContentScalarSchema, type ContentScalarType, type ContentTypeDefinition, type ContentValue, type CustomerProfileUpdatePayload, type CustomerProfileUserError, type EditorMetadata, type FetchStrategy, type IdentityActions, type JsonValue, type MockActions, type PaymentActions, type PaymentBillingAddressUpdateInput, type PaymentGatewayCallbackResult, type PaymentGatewayCard, type PaymentGatewayNewCard, type PaymentGatewaySavedCard, type PaymentGatewayTransaction, type PaymentMethodSelectInput, type PaymentMoney, type PaymentStartTransactionResult, type PaymentUserError, type PropSchema, type PropSchemaField, type PropType, type RegionActions, type RegionUserError, type SendPaymentsRequest, type SessionAccessCodeRequestResult, type SessionActions, type SessionPasswordLoginPayload, type SessionRequestAccessCodePayload, type SessionUserError, type SessionValidateAccessCodePayload, type ShippingActions, type ShippingAddressInput, type ShippingAddressUpdateErrorEntity, type ShippingOptionSelectUserError, type StorefrontContext, type VariableBinding, type VariableBindings, defineComponent, defineContentType, mockAction };
+import { resolveStorefrontHref } from "./sdk/navigation/resolve-storefront-href.js";
+export { type ActionSelector, type AddItemPayload, type CartActions, type CartCouponPayload, type CartLinePayload, type CartLinesPayload, type CartQuantityPayload, type CartUserError, type ClientPreferenceKey, type ClientPreferencesUpdatePayload, type ClientProfileUpdatePayload, type ClientProfileUserError, type ComponentActions, type ComponentDefinition, type ContentArraySchema, type ContentNestedObjectShape, type ContentObjectPropertySchema, type ContentObjectSchema, type ContentPropertySchema, type ContentPropertyType, type ContentScalarSchema, type ContentScalarType, type ContentTypeDefinition, type ContentValue, type CustomerProfileUpdatePayload, type CustomerProfileUserError, type EditorMetadata, type FetchStrategy, type IdentityActions, type JsonValue, type LocaleActions, type MockActions, type OrderActions, type OrderCancelInput, type OrderCancelOrder, type OrderCancelResult, type OrderCancelUserError, type PageRef, type PaymentActions, type PaymentBillingAddressUpdateInput, type PaymentGatewayCallbackResult, type PaymentGatewayCard, type PaymentGatewayNewCard, type PaymentGatewayResult, type PaymentGatewaySavedCard, type PaymentGatewayTransaction, type PaymentMethodSelectInput, type PaymentMoney, type PaymentStartTransactionResult, type PaymentUserError, type PropSchema, type PropSchemaField, type PropType, type RegionActions, type RegionUserError, type ResolveHrefReason, type ResolveHrefResult, type RouteIdentity, type RouteKind, type RouteMap, type RouteMapEntry, type SendPaymentsRequest, type SessionAccessCodeRequestResult, type SessionActions, type SessionPasswordLoginPayload, type SessionRequestAccessCodePayload, type SessionUserError, type SessionValidateAccessCodePayload, type ShippingActions, type ShippingAddressInput, type ShippingAddressUpdateErrorEntity, type ShippingOptionSelectUserError, type StandardName, type StorefrontContext, type VariableBinding, type VariableBindings, defineComponent, defineContentType, mockAction, resolveStorefrontHref };

package/dist/index.js

@@ -2,4 +2,5 @@ import { mockAction } from "./core/dist/actions/mock-action.js";
 import { defineComponent } from "./core/dist/define-component.js";
 import { defineContentType } from "./core/dist/define-content-type.js";
 import "./core/dist/index.js";
-export { defineComponent, defineContentType, mockAction };
+import { resolveStorefrontHref } from "./sdk/navigation/resolve-storefront-href.js";
+export { defineComponent, defineContentType, mockAction, resolveStorefrontHref };

package/dist/internal/client.d.ts

@@ -1,11 +1,15 @@
 import { MessageId, Messages } from "../sdk/i18n/locales.js";
 import "../sdk/i18n/client.js";
 import { gql } from "../sdk/graphql-tag.js";
+import { AddressActionProvider, AddressActionProviderProps } from "../sdk/actions/address-action-provider.js";
 import { AnalyticsActionProvider, AnalyticsActionProviderProps } from "../sdk/actions/analytics-action-provider.js";
 import { CartActionProvider, CartActionProviderProps } from "../sdk/actions/cart-action-provider.js";
 import { IdentityActionProvider, IdentityActionProviderProps } from "../sdk/actions/identity-action-provider.js";
+import { LocaleActionProvider, LocaleActionProviderProps } from "../sdk/actions/locale-action-provider.js";
+import { OrderActionProvider, OrderActionProviderProps } from "../sdk/actions/order-action-provider.js";
 import { PaymentActionProvider, PaymentActionProviderProps } from "../sdk/actions/payment-action-provider.js";
 import { RegionActionProvider, RegionActionProviderProps } from "../sdk/actions/region-action-provider.js";
+import { SavedCardActionProvider, SavedCardActionProviderProps } from "../sdk/actions/saved-card-action-provider.js";
 import { SessionActionProvider, SessionActionProviderProps } from "../sdk/actions/session-action-provider.js";
 import { ShippingActionProvider, ShippingActionProviderProps } from "../sdk/actions/shipping-action-provider.js";
 import "../sdk/actions/index.js";
@@ -19,8 +23,12 @@ import { ClientVariablesMap, PageReactiveDataRoot, PageReactiveDataRootProps, Re
 import { ReactiveDataProvider, ReactiveDataProviderProps } from "../sdk/data/reactive-data-provider.js";
 import { ReactiveListItemDataProvider, ReactiveListItemDataProviderProps } from "../sdk/data/reactive-list-item-data-provider.js";
 import "../sdk/data/index.js";
+import { BindingSwitchProvider, BindingSwitchProviderProps } from "../sdk/locale/binding-switch-provider.js";
+import { RouteMapProvider, RouteMapProviderProps, ToLogicalPath } from "../sdk/navigation/route-map-provider.js";
+import { reportNotFoundRequest } from "../sdk/navigation/not-found-log.js";
+import { RouteIdentityProvider, RouteIdentityProviderProps } from "../sdk/navigation/route-identity-provider.js";
 import { StorefrontProvider, StorefrontProviderProps } from "../sdk/provider/storefront-provider.js";
 import "../sdk/provider/index.js";
 import { cartCouponErrorsVar, cartLastAddVar, cartUserErrorsVar, miniCartOpenVar, orderFormIdVar } from "../sdk/state/cart.js";
 import { SelectedVariant, publishedVariantIdFor, selectedVariantVar } from "../sdk/state/variant-selector.js";
-export { AnalyticsActionProvider, type AnalyticsActionProviderProps, CartActionProvider, type CartActionProviderProps, type ClientVariablesMap, DataOverrideContext, HotDataProvider, type HotDataProviderProps, IdentityActionProvider, type IdentityActionProviderProps, type ListItemRef, ListItemRefContext, type MessageId, type Messages, MultipleReactiveDataProvider, type MultipleReactiveDataProviderEntity, type MultipleReactiveDataProviderProps, PageReactiveDataRoot, type PageReactiveDataRootProps, PaymentActionProvider, type PaymentActionProviderProps, ReactiveDataProvider, type ReactiveDataProviderProps, ReactiveListItemDataProvider, type ReactiveListItemDataProviderProps, ReactiveRootContext, type ReactiveRootContextValue, RegionActionProvider, type RegionActionProviderProps, type SelectedVariant, SessionActionProvider, type SessionActionProviderProps, ShippingActionProvider, type ShippingActionProviderProps, StorefrontProvider, type StorefrontProviderProps, buildOptimisticDecrease, buildOptimisticIncrease, buildOptimisticRemove, buildStorefrontContextHeaders, cartCouponErrorsVar, cartLastAddVar, cartUserErrorsVar, gql, miniCartOpenVar, orderFormIdVar, publishedVariantIdFor, selectedVariantVar, useDataOverride, useListItemRef };
+export { AddressActionProvider, type AddressActionProviderProps, AnalyticsActionProvider, type AnalyticsActionProviderProps, BindingSwitchProvider, type BindingSwitchProviderProps, CartActionProvider, type CartActionProviderProps, type ClientVariablesMap, DataOverrideContext, HotDataProvider, type HotDataProviderProps, IdentityActionProvider, type IdentityActionProviderProps, type ListItemRef, ListItemRefContext, LocaleActionProvider, type LocaleActionProviderProps, type MessageId, type Messages, MultipleReactiveDataProvider, type MultipleReactiveDataProviderEntity, type MultipleReactiveDataProviderProps, OrderActionProvider, type OrderActionProviderProps, PageReactiveDataRoot, type PageReactiveDataRootProps, PaymentActionProvider, type PaymentActionProviderProps, ReactiveDataProvider, type ReactiveDataProviderProps, ReactiveListItemDataProvider, type ReactiveListItemDataProviderProps, ReactiveRootContext, type ReactiveRootContextValue, RegionActionProvider, type RegionActionProviderProps, RouteIdentityProvider, type RouteIdentityProviderProps, RouteMapProvider, type RouteMapProviderProps, SavedCardActionProvider, type SavedCardActionProviderProps, type SelectedVariant, SessionActionProvider, type SessionActionProviderProps, ShippingActionProvider, type ShippingActionProviderProps, StorefrontProvider, type StorefrontProviderProps, type ToLogicalPath, buildOptimisticDecrease, buildOptimisticIncrease, buildOptimisticRemove, buildStorefrontContextHeaders, cartCouponErrorsVar, cartLastAddVar, cartUserErrorsVar, gql, miniCartOpenVar, orderFormIdVar, publishedVariantIdFor, reportNotFoundRequest, selectedVariantVar, useDataOverride, useListItemRef };

package/dist/internal/client.js

@@ -1,16 +1,23 @@
 import { gql } from "../sdk/graphql-tag.js";
+import { RouteMapProvider } from "../sdk/navigation/route-map-provider.js";
+import { RouteIdentityProvider } from "../sdk/navigation/route-identity-provider.js";
 import { DataOverrideContext, useDataOverride } from "../sdk/data/data-override-context.js";
+import { ListItemRefContext, useListItemRef } from "../sdk/data/list-item-ref-context.js";
 import { PageReactiveDataRoot, ReactiveRootContext } from "../sdk/data/page-reactive-data-root.js";
 import { HotDataProvider } from "../sdk/data/hot-data-provider.js";
 import { publishedVariantIdFor, selectedVariantVar } from "../sdk/state/variant-selector.js";
 import { cartCouponErrorsVar, cartLastAddVar, cartUserErrorsVar, miniCartOpenVar, orderFormIdVar } from "../sdk/state/cart.js";
 import { buildOptimisticDecrease, buildOptimisticIncrease, buildOptimisticRemove } from "../sdk/cart/optimistic.js";
-import { ListItemRefContext, useListItemRef } from "../sdk/data/list-item-ref-context.js";
+import { AddressActionProvider } from "../sdk/actions/address-action-provider.js";
 import { AnalyticsActionProvider } from "../sdk/actions/analytics-action-provider.js";
 import { CartActionProvider } from "../sdk/actions/cart-action-provider.js";
 import { IdentityActionProvider } from "../sdk/actions/identity-action-provider.js";
+import { BindingSwitchProvider } from "../sdk/locale/binding-switch-provider.js";
+import { LocaleActionProvider } from "../sdk/actions/locale-action-provider.js";
+import { OrderActionProvider } from "../sdk/actions/order-action-provider.js";
 import { PaymentActionProvider } from "../sdk/actions/payment-action-provider.js";
 import { RegionActionProvider } from "../sdk/actions/region-action-provider.js";
+import { SavedCardActionProvider } from "../sdk/actions/saved-card-action-provider.js";
 import { SessionActionProvider } from "../sdk/actions/session-action-provider.js";
 import { ShippingActionProvider } from "../sdk/actions/shipping-action-provider.js";
 import "../sdk/actions/index.js";
@@ -19,7 +26,8 @@ import { MultipleReactiveDataProvider } from "../sdk/data/multiple-reactive-data
 import { ReactiveDataProvider } from "../sdk/data/reactive-data-provider.js";
 import { ReactiveListItemDataProvider } from "../sdk/data/reactive-list-item-data-provider.js";
 import "../sdk/data/index.js";
+import { reportNotFoundRequest } from "../sdk/navigation/not-found-log.js";
 import { StorefrontProvider } from "../sdk/provider/storefront-provider.js";
 import "../sdk/provider/index.js";
 import "../sdk/state/index.js";
-export { AnalyticsActionProvider, CartActionProvider, DataOverrideContext, HotDataProvider, IdentityActionProvider, ListItemRefContext, MultipleReactiveDataProvider, PageReactiveDataRoot, PaymentActionProvider, ReactiveDataProvider, ReactiveListItemDataProvider, ReactiveRootContext, RegionActionProvider, SessionActionProvider, ShippingActionProvider, StorefrontProvider, buildOptimisticDecrease, buildOptimisticIncrease, buildOptimisticRemove, buildStorefrontContextHeaders, cartCouponErrorsVar, cartLastAddVar, cartUserErrorsVar, gql, miniCartOpenVar, orderFormIdVar, publishedVariantIdFor, selectedVariantVar, useDataOverride, useListItemRef };
+export { AddressActionProvider, AnalyticsActionProvider, BindingSwitchProvider, CartActionProvider, DataOverrideContext, HotDataProvider, IdentityActionProvider, ListItemRefContext, LocaleActionProvider, MultipleReactiveDataProvider, OrderActionProvider, PageReactiveDataRoot, PaymentActionProvider, ReactiveDataProvider, ReactiveListItemDataProvider, ReactiveRootContext, RegionActionProvider, RouteIdentityProvider, RouteMapProvider, SavedCardActionProvider, SessionActionProvider, ShippingActionProvider, StorefrontProvider, buildOptimisticDecrease, buildOptimisticIncrease, buildOptimisticRemove, buildStorefrontContextHeaders, cartCouponErrorsVar, cartLastAddVar, cartUserErrorsVar, gql, miniCartOpenVar, orderFormIdVar, publishedVariantIdFor, reportNotFoundRequest, selectedVariantVar, useDataOverride, useListItemRef };

package/dist/internal/server.d.ts

@@ -1,10 +1,16 @@
+import { resolveStorefrontHref } from "../sdk/navigation/resolve-storefront-href.js";
 import { buildStorefrontContextHeaders } from "../sdk/context/headers.js";
+import { AlternateBinding, BuildPageAlternatesOptions, CATALOG_ROUTE_ALTERNATES_QUERY, PageAlternates, RouteParams, RouteVariant, buildPageAlternates, catalogClusterPaths, routeLogicalPath } from "../sdk/seo/page-alternates.js";
+import { BindingSwitchRequest, BindingSwitchResult, ResolveBindingSwitchOptions, resolveBindingSwitch } from "../sdk/navigation/binding-switch.js";
+import { customerOrdersFilter } from "../matter/order-list/customer-orders-filter.js";
 import { CreateClientOptions, createClient } from "../sdk/client/create-client.js";
 import { FetchPageDataOptions, FetchPageDataResult, fetchPageData } from "../sdk/client/fetch-page-data.js";
 import { PreloadQueryRegistry, RegisterPreloadQueryOptions, registerPreloadQuery } from "../sdk/client/register-preload-query.js";
 import { ContentVariableField, ContentVariablesSpec, VariablesFromContentOptions, variablesFromContent } from "../sdk/data/variables-from-content.js";
 import { getIntl, loadMessages } from "../sdk/i18n/server.js";
+import { decodeRouteParams } from "../sdk/navigation/decode-route-params.js";
+import { permanentRedirectToStorefrontPage, redirectToStorefrontPage } from "../sdk/navigation/redirect.js";
 import { ServerSessionRead, readServerSession } from "../sdk/session/read-server-session.js";
-import { resolveSignInHref } from "../utils/safe-href.js";
+import { signInTarget } from "../utils/safe-href.js";
 import { PreloadQueryProps } from "@apollo/client-integration-nextjs";
-export { type ContentVariableField, type ContentVariablesSpec, type CreateClientOptions, type FetchPageDataOptions, type FetchPageDataResult, type PreloadQueryProps, type PreloadQueryRegistry, type RegisterPreloadQueryOptions, type ServerSessionRead, type VariablesFromContentOptions, buildStorefrontContextHeaders, createClient, fetchPageData, getIntl, loadMessages, readServerSession, registerPreloadQuery, resolveSignInHref, variablesFromContent };
+export { type AlternateBinding, type BindingSwitchRequest, type BindingSwitchResult, type BuildPageAlternatesOptions, CATALOG_ROUTE_ALTERNATES_QUERY, type ContentVariableField, type ContentVariablesSpec, type CreateClientOptions, type FetchPageDataOptions, type FetchPageDataResult, type PageAlternates, type PreloadQueryProps, type PreloadQueryRegistry, type RegisterPreloadQueryOptions, type ResolveBindingSwitchOptions, type RouteParams, type RouteVariant, type ServerSessionRead, type VariablesFromContentOptions, buildPageAlternates, buildStorefrontContextHeaders, catalogClusterPaths, createClient, customerOrdersFilter, decodeRouteParams, fetchPageData, getIntl, loadMessages, permanentRedirectToStorefrontPage, readServerSession, redirectToStorefrontPage, registerPreloadQuery, resolveBindingSwitch, resolveStorefrontHref, routeLogicalPath, signInTarget, variablesFromContent };

package/dist/internal/server.js

@@ -1,9 +1,15 @@
-import { resolveSignInHref } from "../utils/safe-href.js";
+import { signInTarget } from "../utils/safe-href.js";
+import { resolveStorefrontHref } from "../sdk/navigation/resolve-storefront-href.js";
 import { buildStorefrontContextHeaders } from "../sdk/context/headers.js";
+import { customerOrdersFilter } from "../matter/order-list/customer-orders-filter.js";
 import { createClient } from "../sdk/client/create-client.js";
 import { fetchPageData } from "../sdk/client/fetch-page-data.js";
 import { registerPreloadQuery } from "../sdk/client/register-preload-query.js";
 import { variablesFromContent } from "../sdk/data/variables-from-content.js";
 import { getIntl, loadMessages } from "../sdk/i18n/server.js";
+import { CATALOG_ROUTE_ALTERNATES_QUERY, buildPageAlternates, catalogClusterPaths, routeLogicalPath } from "../sdk/seo/page-alternates.js";
+import { decodeRouteParams } from "../sdk/navigation/decode-route-params.js";
+import { resolveBindingSwitch } from "../sdk/navigation/binding-switch.js";
+import { permanentRedirectToStorefrontPage, redirectToStorefrontPage } from "../sdk/navigation/redirect.js";
 import { readServerSession } from "../sdk/session/read-server-session.js";
-export { buildStorefrontContextHeaders, createClient, fetchPageData, getIntl, loadMessages, readServerSession, registerPreloadQuery, resolveSignInHref, variablesFromContent };
+export { CATALOG_ROUTE_ALTERNATES_QUERY, buildPageAlternates, buildStorefrontContextHeaders, catalogClusterPaths, createClient, customerOrdersFilter, decodeRouteParams, fetchPageData, getIntl, loadMessages, permanentRedirectToStorefrontPage, readServerSession, redirectToStorefrontPage, registerPreloadQuery, resolveBindingSwitch, resolveStorefrontHref, routeLogicalPath, signInTarget, variablesFromContent };

package/dist/matter/account-access-gate/account-access-gate.d.ts

@@ -1,6 +1,7 @@
 import { ContentValue } from "../../core/dist/define-content-type.js";
 import { ComponentDefinition } from "../../core/dist/define-component.js";
 import "../../core/dist/index.js";
+import { PageRef } from "../../sdk/navigation/types.js";
 import { ComponentPropsWithRef, ReactNode } from "react";
 //#region src/matter/account-access-gate/account-access-gate.d.ts
 export declare const AccountAccessGateContent: {
@@ -62,7 +63,7 @@ export type AccountAccessGateNoticeProps = Omit<ComponentPropsWithRef<'output'>,
   /** The message for this reason. Nothing renders in its place when unauthored. */
   message?: string;
   /** Where the link out leads, built by the gate from the page the shopper is on. */
-  signInHref: string;
+  signInHref: PageRef | string;
   /** Label of the link out. No label, no link. */
   signInLabel?: string;
 };

package/dist/matter/account-access-gate/account-access-gate.js

@@ -2,14 +2,15 @@
 import { defineComponent } from "../../core/dist/define-component.js";
 import { defineContentType } from "../../core/dist/define-content-type.js";
 import "../../core/dist/index.js";
+import { signInTarget } from "../../utils/safe-href.js";
+import { useStorefrontNavigation } from "../../sdk/navigation/use-storefront-navigation.js";
+import { useStorefrontRoute } from "../../sdk/navigation/use-storefront-route.js";
 import { useSession } from "../session/session.js";
-import { resolveSignInHref } from "../../utils/safe-href.js";
 import { NavigationLink } from "../../particles/navigation-link/navigation-link.js";
 import { useSessionRevalidation } from "../../sdk/session/use-session-revalidation.js";
 import { useSignOutIntent, withdrawSignOutIntent } from "./sign-out-intent.js";
 import { useEffect, useRef, useState } from "react";
-import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import { usePathname, useRouter } from "next/navigation";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 import { flushSync } from "react-dom";
 //#region src/matter/account-access-gate/account-access-gate.tsx
 const AccountAccessGateContent = defineContentType({
@@ -71,7 +72,7 @@ const AccountAccessGateDefinition = defineComponent({
 			label: "Sign-in Link Label"
 		}
 	},
-	guideline: "The account's single access decision: place it once in the account layout, wrapping the body, and every page that declares that layout inherits it — never restate it per section. It renders its children only for a logged-in shopper; it shows a composed loading look while the session resolves, replaces the current history entry with the sign-in destination for a visitor who arrived signed out (identified counts as signed out), tells a shopper whose session ended mid-visit rather than bouncing them, and stands down while AccountMenuSignOut navigates. It redirects at most once per visit: a shopper who comes back from sign-in still signed out gets a message and a link rather than a second hop. Must be inside SessionRoot, which the same layout hosts. Never place the /login route under it — the gate redirects there, and a gated /login would redirect to itself."
+	guideline: "The account's single access decision: place it once in the account layout, wrapping the body, and every page that declares that layout inherits it — never restate it per section. It renders its children only for a logged-in shopper; it shows a composed loading look while the session resolves, replaces the current history entry with the sign-in destination for a visitor who arrived signed out (identified counts as signed out), tells a shopper whose session ended mid-visit rather than bouncing them, and stands down while AccountMenuSignOut navigates. It redirects at most once per visit: a shopper who comes back from sign-in still signed out gets a message and a link rather than a second hop. Must be inside SessionRoot, which the same layout hosts. Never place the sign-in page under it — the gate redirects there, and a gated sign-in page would redirect to itself."
 });
 /** The one automatic hop the gate has already spent, surviving the full document load out to the
 *  platform and back, and no further than this tab. */
@@ -79,19 +80,15 @@ const SIGN_IN_ATTEMPT_KEY = "fs::account-access-gate::sign-in-attempt";
 function AccountAccessGate({ loadingLabel, expiredMessage, signInIncompleteMessage, signInLabel, $content, children }) {
 	const { state, loading } = useSession();
 	const signingOut = useSignOutIntent();
-	const pathname = usePathname();
-	const router = useRouter();
+	const { path, search } = useStorefrontRoute();
+	const { hrefFor, replace } = useStorefrontNavigation();
 	const revalidate = useSessionRevalidation();
 	const [wasSignedIn, setWasSignedIn] = useState(false);
 	const [unconfirmed, setUnconfirmed] = useState(false);
 	const [revalidating, setRevalidating] = useState(false);
 	const restoreGeneration = useRef(0);
 	const [hopSpent, setHopSpent] = useState(null);
-	const [search, setSearch] = useState(null);
-	useEffect(() => {
-		setSearch(globalThis.location.search);
-	});
-	const returnPath = pathname === null ? null : `${pathname}${search ?? ""}`;
+	const returnPath = `${path}${search ?? ""}`;
 	const outcome = resolveOutcome({
 		signingOut,
 		unconfirmed,
@@ -118,10 +115,15 @@ function AccountAccessGate({ loadingLabel, expiredMessage, signInIncompleteMessa
 					setHopSpent(true);
 					return;
 				}
-				const destination = resolveSignInHref(returnPath);
+				const target = signInTarget(returnPath);
+				const destination = hrefFor(target);
+				if (destination === null) {
+					setHopSpent(true);
+					return;
+				}
 				recordSignInAttempt(destination);
 				setHopSpent(false);
-				router.replace(destination);
+				replace(target);
 				return;
 			}
 			case "stand-down":
@@ -133,7 +135,8 @@ function AccountAccessGate({ loadingLabel, expiredMessage, signInIncompleteMessa
 		hopSpent,
 		search,
 		returnPath,
-		router
+		hrefFor,
+		replace
 	]);
 	useEffect(() => {
 		function handlePageHide(event) {
@@ -181,13 +184,13 @@ function AccountAccessGate({ loadingLabel, expiredMessage, signInIncompleteMessa
 			"data-fs-account-access-gate": "",
 			children: entryLoadingLabel
 		});
-		case "account": return /* @__PURE__ */ jsx(Fragment, { children });
+		case "account": return /* @__PURE__ */ jsx(Fragment$1, { children });
 		case "expired":
 		case "sign-in-incomplete": return /* @__PURE__ */ jsx(AccountAccessGateNotice, {
 			"data-fs-account-access-gate": "",
 			reason: outcome === "expired" ? "expired" : "sign-in-incomplete",
 			message: outcome === "expired" ? entryExpiredMessage : entryIncompleteMessage,
-			signInHref: resolveSignInHref(returnPath),
+			signInHref: signInTarget(returnPath),
 			signInLabel: entrySignInLabel
 		});
 		default: return assertUnreachable(outcome);

package/dist/matter/account-access-gate/account-access-gate.js.map

@@ -1 +1 @@
-{"version":3,"file":"account-access-gate.js","names":[],"sources":["../../../src/matter/account-access-gate/account-access-gate.tsx"],"sourcesContent":["'use client';\n\nimport { type ContentValue, defineComponent, defineContentType } from '@vtex/fs-core';\nimport { usePathname, useRouter } from 'next/navigation';\nimport { type ComponentPropsWithRef, type ReactNode, useEffect, useRef, useState } from 'react';\nimport { flushSync } from 'react-dom';\nimport { NavigationLink } from '../../particles/navigation-link/navigation-link.js';\nimport { useSessionRevalidation } from '../../sdk/session/use-session-revalidation.js';\nimport { resolveSignInHref } from '../../utils/safe-href.js';\nimport { type SessionState, useSession } from '../session/session.js';\nimport { useSignOutIntent, withdrawSignOutIntent } from './sign-out-intent.js';\n\n// Nothing is required, following the shipped identity components: an entry may author any subset, and\n// a slice missing a required property is shape-invalid, which drops the whole element rather than the\n// one field.\nexport const AccountAccessGateContent = defineContentType({\n  id: 'account-access-gate',\n  title: 'Account Access Gate',\n  description: 'What the shopper is told while the account resolves and when it will not open for them.',\n  schema: {\n    type: 'object',\n    additionalProperties: false,\n    properties: {\n      loadingLabel: { type: 'string', minLength: 1, title: 'Loading announcement' },\n      expiredMessage: { type: 'string', minLength: 1, title: 'Session ended message' },\n      signInIncompleteMessage: { type: 'string', minLength: 1, title: 'Sign-in did not complete message' },\n      signInLabel: { type: 'string', minLength: 1, title: 'Sign-in link label' },\n    },\n  },\n});\n\n/** Why the account will not open, as a bounded value: a style target and the choice of message. */\nexport type AccountAccessGateNoticeReason = 'expired' | 'sign-in-incomplete';\n\n/** Props for {@link AccountAccessGate}. It renders a different element per outcome and forwards no\n *  element props of its own; each rendered part carries its own. */\nexport type AccountAccessGateProps = {\n  /** Text announced while the session resolves. */\n  loadingLabel?: string;\n  /** What a shopper whose session ended mid-visit is told. */\n  expiredMessage?: string;\n  /** What a shopper who came back from sign-in still signed out is told. */\n  signInIncompleteMessage?: string;\n  /** Label of the link out of either notice. Without it no link renders — a focusable link a screen\n   *  reader announces as its bare URL is worse than no control at all. */\n  signInLabel?: string;\n  /** Merchant-authored fields, sliced from the layout content entry; win over the props field by field\n   *  when present. Absent in a non-CMS store — the props are the fallback. */\n  $content?: ContentValue<typeof AccountAccessGateContent>;\n  /** The account. Rendered only for a signed-in shopper. */\n  children?: ReactNode;\n};\n\n/** Props for {@link AccountAccessGateLoading}. Extends native `<output>` attributes. */\nexport type AccountAccessGateLoadingProps = ComponentPropsWithRef<'output'>;\n\n/** Props for {@link AccountAccessGateNotice}. Extends native `<output>` attributes. */\nexport type AccountAccessGateNoticeProps = Omit<ComponentPropsWithRef<'output'>, 'children'> & {\n  reason: AccountAccessGateNoticeReason;\n  /** The message for this reason. Nothing renders in its place when unauthored. */\n  message?: string;\n  /** Where the link out leads, built by the gate from the page the shopper is on. */\n  signInHref: string;\n  /** Label of the link out. No label, no link. */\n  signInLabel?: string;\n};\n\nexport const AccountAccessGateDefinition = defineComponent<AccountAccessGateProps>({\n  name: 'AccountAccessGate',\n  importPath: '@vtex/faststore/components',\n  component: AccountAccessGate,\n  content: AccountAccessGateContent,\n  editor: { label: 'Account Access Gate', category: 'identity' },\n  requiresContext: 'session',\n  schema: {\n    // Mirrored from the content model on purpose, as every content-bearing component in the library\n    // does: the entry wins when published, and this is what a store without a CMS authors.\n    loadingLabel: { type: 'string', label: 'Loading Announcement' },\n    expiredMessage: { type: 'string', label: 'Session Ended Message' },\n    signInIncompleteMessage: { type: 'string', label: 'Sign-in Did Not Complete Message' },\n    signInLabel: { type: 'string', label: 'Sign-in Link Label' },\n  },\n  guideline:\n    \"The account's single access decision: place it once in the account layout, wrapping the body, and every page that declares that layout inherits it — never restate it per section. It renders its children only for a logged-in shopper; it shows a composed loading look while the session resolves, replaces the current history entry with the sign-in destination for a visitor who arrived signed out (identified counts as signed out), tells a shopper whose session ended mid-visit rather than bouncing them, and stands down while AccountMenuSignOut navigates. It redirects at most once per visit: a shopper who comes back from sign-in still signed out gets a message and a link rather than a second hop. Must be inside SessionRoot, which the same layout hosts. Never place the /login route under it — the gate redirects there, and a gated /login would redirect to itself.\",\n});\n\n/** The one automatic hop the gate has already spent, surviving the full document load out to the\n *  platform and back, and no further than this tab. */\nconst SIGN_IN_ATTEMPT_KEY = 'fs::account-access-gate::sign-in-attempt';\n\n/**\n * What the gate renders, in precedence order. `signing-in` covers both the frame that decides whether\n * the hop is still available and the frame after the replace is issued: they render the same nothing,\n * and only the effect tells them apart.\n */\ntype AccountAccessGateOutcome = 'stand-down' | 'expired' | 'loading' | 'account' | 'sign-in-incomplete' | 'signing-in';\n\nexport function AccountAccessGate({\n  loadingLabel,\n  expiredMessage,\n  signInIncompleteMessage,\n  signInLabel,\n  $content,\n  children,\n}: Readonly<AccountAccessGateProps>) {\n  const { state, loading } = useSession();\n  const signingOut = useSignOutIntent();\n  const pathname = usePathname();\n  const router = useRouter();\n  const revalidate = useSessionRevalidation();\n\n  // Whether this gate has ever resolved to a signed-in shopper. It is what separates a session that\n  // ended from a visitor who arrived signed out — the tri-state spells both `anonymous`.\n  const [wasSignedIn, setWasSignedIn] = useState(false);\n  // A revalidation that could not answer. It outranks `loading` because the discard that preceded it\n  // is what leaves the session unresolved, so nothing else is coming to end that wait.\n  const [unconfirmed, setUnconfirmed] = useState(false);\n  // A re-read in flight. The gate withholds the account for itself rather than waiting to be told:\n  // discarding the cached session leaves the data layer unresolved, but it reaches the gate only once\n  // the watched query has re-read, and the account must be gone in the frame the restore arrives.\n  const [revalidating, setRevalidating] = useState(false);\n  // Which re-read the gate is still listening to. Two restores in a row put two answers in flight, and\n  // the older one may land last.\n  const restoreGeneration = useRef(0);\n  // `null` until the arrival path has read the record. Read from an effect rather than from the render\n  // body: session storage does not exist on the server, and a value that appeared between the server\n  // pass and hydration would change what renders underneath it.\n  const [hopSpent, setHopSpent] = useState<boolean | null>(null);\n  // `null` until the document has been read, for the same two reasons, and read from the document\n  // rather than through `useSearchParams()`, which would require a `Suspense` boundary the generator\n  // does not emit on a prerendered route — the reason `SignInRedirect` gives for reading it this way.\n  const [search, setSearch] = useState<string | null>(null);\n\n  // Deliberately on every commit rather than on mount: `usePathname()` re-renders the gate when the\n  // path changes but says nothing about the query, and a shopper who pages through their orders\n  // changes only the query. Setting the same string is a bail-out, so this does not loop.\n  useEffect(() => {\n    setSearch(globalThis.location.search);\n  });\n\n  // Where the shopper comes back to. `usePathname()` yields the path alone, so a gate that stopped\n  // there would return someone reading `/pvt/orders?page=2` to the first page of it.\n  const returnPath = pathname === null ? null : `${pathname}${search ?? ''}`;\n\n  const outcome = resolveOutcome({ signingOut, unconfirmed, revalidating, loading, state, wasSignedIn, hopSpent });\n\n  useEffect(() => {\n    switch (outcome) {\n      case 'account':\n        setWasSignedIn(true);\n        setUnconfirmed(false);\n        clearSignInAttempt();\n        return;\n      case 'expired':\n      case 'sign-in-incomplete':\n        // Every outcome that is not the hop returns it: a shopper who signs in, browses, and comes\n        // back later arrives fresh rather than carrying a spent attempt from an earlier one.\n        clearSignInAttempt();\n        return;\n      case 'signing-in': {\n        // One more frame before deciding, until the document has been read: a hop recorded against the\n        // bare path is the one the shopper comes back to, and there is no second chance at it.\n        if (hopSpent !== null || search === null) {\n          return;\n        }\n        if (readSignInAttempt() !== null) {\n          setHopSpent(true);\n          return;\n        }\n        const destination = resolveSignInHref(returnPath);\n        recordSignInAttempt(destination);\n        setHopSpent(false);\n        // Replace rather than push: back from the platform's login should reach the page the shopper\n        // came from, not the account that threw them at it.\n        // react-doctor-disable-next-line nextjs-no-client-side-redirect -- the session resolves on the client, so the server has nothing to decide with\n        router.replace(destination);\n        return;\n      }\n      case 'stand-down':\n      case 'loading':\n        return;\n      default:\n        assertUnreachable(outcome);\n    }\n  }, [outcome, hopSpent, search, returnPath, router]);\n\n  useEffect(() => {\n    function handlePageHide(event: PageTransitionEvent): void {\n      if (!event.persisted) {\n        return;\n      }\n      // What the browser freezes is the DOM, and a restore puts that same DOM back before any script\n      // runs. Standing the account down on the way out rather than on the way back is what keeps the\n      // restored document from showing it in the frames before `pageshow` can decide again.\n      flushSync(() => {\n        setRevalidating(true);\n      });\n    }\n\n    function handlePageShow(event: PageTransitionEvent): void {\n      // An ordinary load re-decides by mounting. Only a restore resumes a heap that already holds an\n      // answer, and `persisted` is the browser's own word for it.\n      if (!event.persisted) {\n        return;\n      }\n      const generation = restoreGeneration.current + 1;\n      restoreGeneration.current = generation;\n      // The navigation this authorized has already happened; a restored document holding it would\n      // stand down forever. Withdrawn before the re-read so the gate is deciding again by the time\n      // the answer lands.\n      withdrawSignOutIntent();\n      setUnconfirmed(false);\n      setRevalidating(true);\n      void revalidate().then((result) => {\n        // A later restore has already asked the same question, and its answer is the one that counts.\n        // This one describes a session the gate has since discarded a second time.\n        if (generation !== restoreGeneration.current) {\n          return;\n        }\n        setRevalidating(false);\n        switch (result) {\n          case 'failed':\n            setUnconfirmed(true);\n            return;\n          case 'revalidated':\n          case 'unavailable':\n            // Nothing left to distrust: either the session was re-read, or there was no cached\n            // session to discard in the first place and the one in the tree came from a prop.\n            return;\n          default:\n            assertUnreachable(result);\n        }\n      });\n    }\n\n    globalThis.addEventListener('pagehide', handlePageHide);\n    globalThis.addEventListener('pageshow', handlePageShow);\n    return () => {\n      globalThis.removeEventListener('pagehide', handlePageHide);\n      globalThis.removeEventListener('pageshow', handlePageShow);\n    };\n  }, [revalidate]);\n\n  // The intent authorizes one transition and this gate is its only reader, so it must not survive the\n  // gate. A sign-out that navigates client-side takes the account layout down without reloading the\n  // document, and nothing else would ever take the flag back: the next account page the shopper opens\n  // would mount into a standing intent and render nothing at all, with no error to explain it.\n  useEffect(() => withdrawSignOutIntent, []);\n\n  // Blank entry fields fall through, so clearing one in the Admin reads as unauthored.\n  const entryLoadingLabel = $content?.loadingLabel?.trim() ? $content.loadingLabel : loadingLabel;\n  const entryExpiredMessage = $content?.expiredMessage?.trim() ? $content.expiredMessage : expiredMessage;\n  const entryIncompleteMessage = $content?.signInIncompleteMessage?.trim()\n    ? $content.signInIncompleteMessage\n    : signInIncompleteMessage;\n  const entrySignInLabel = $content?.signInLabel?.trim() ? $content.signInLabel : signInLabel;\n\n  switch (outcome) {\n    case 'stand-down':\n    case 'signing-in':\n      return null;\n    case 'loading':\n      return (\n        // The part carries its own hook; the component's identity travels from here, which is how a\n        // store targets it by name the way every other component is targeted.\n        <AccountAccessGateLoading data-fs-account-access-gate=\"\">{entryLoadingLabel}</AccountAccessGateLoading>\n      );\n    case 'account':\n      return <>{children}</>;\n    case 'expired':\n    case 'sign-in-incomplete':\n      return (\n        <AccountAccessGateNotice\n          data-fs-account-access-gate=\"\"\n          reason={outcome === 'expired' ? 'expired' : 'sign-in-incomplete'}\n          message={outcome === 'expired' ? entryExpiredMessage : entryIncompleteMessage}\n          signInHref={resolveSignInHref(returnPath)}\n          signInLabel={entrySignInLabel}\n        />\n      );\n    default:\n      return assertUnreachable(outcome);\n  }\n}\n\n/**\n * The whole decision, as one ordered read of the gate's inputs.\n *\n * `signingOut` outranks everything, including a session still reading `loggedIn`: the sign-out records\n * its intent before it awaits the mutation, and the frame between the payload landing and the document\n * load starting is exactly the one this ordering protects.\n *\n * `loading` outranks the tri-state for the reason `AccountEntryPoint` gives: an unresolved session\n * reports `anonymous`, so reading the state first would bounce a shopper who is signed in. A re-read\n * in flight reads as the same wait: the session it is checking is one the gate has stopped believing.\n */\nfunction resolveOutcome({\n  signingOut,\n  unconfirmed,\n  revalidating,\n  loading,\n  state,\n  wasSignedIn,\n  hopSpent,\n}: {\n  signingOut: boolean;\n  unconfirmed: boolean;\n  revalidating: boolean;\n  loading: boolean;\n  state: SessionState;\n  wasSignedIn: boolean;\n  hopSpent: boolean | null;\n}): AccountAccessGateOutcome {\n  if (signingOut) {\n    return 'stand-down';\n  }\n  // A re-read that could not answer says nothing about how the shopper got here, so the notice keeps\n  // the history the gate already has. Telling someone who never reached the account that their session\n  // ended names an event that never happened; the incomplete sign-in is the one they actually had.\n  if (unconfirmed) {\n    return wasSignedIn ? 'expired' : 'sign-in-incomplete';\n  }\n  if (revalidating || loading) {\n    return 'loading';\n  }\n  if (state === 'loggedIn') {\n    return 'account';\n  }\n  if (wasSignedIn) {\n    return 'expired';\n  }\n  return hopSpent === true ? 'sign-in-incomplete' : 'signing-in';\n}\n\nfunction assertUnreachable(outcome: never): never {\n  throw new Error(`[AccountAccessGate] unhandled outcome: ${String(outcome)}`);\n}\n\n/**\n * The look of a session that has not answered yet. A real part with its own hook rather than an ad hoc\n * spinner, so a store can style it and a story can render it.\n */\nexport function AccountAccessGateLoading({ className, children, ...props }: AccountAccessGateLoadingProps) {\n  return (\n    <output {...props} aria-live=\"polite\" className={className} data-fs-account-access-gate-loading=\"\">\n      {children}\n    </output>\n  );\n}\n\n/**\n * What renders in the account's place when it will not open: the message for this reason, and a link\n * the shopper may take back into sign-in.\n *\n * The link is the whole of the escape from a sign-in loop. The gate stops redirecting after one\n * automatic hop, so the next attempt is a click rather than a bounce — and a shopper who keeps landing\n * here at least lands on a page that says so.\n */\nexport function AccountAccessGateNotice({\n  reason,\n  message,\n  signInHref,\n  signInLabel,\n  className,\n  ...props\n}: AccountAccessGateNoticeProps) {\n  return (\n    <output\n      {...props}\n      aria-live=\"polite\"\n      className={className}\n      data-fs-account-access-gate-notice=\"\"\n      data-fs-account-access-gate-notice-reason={reason}\n    >\n      {message ? <span data-fs-account-access-gate-notice-message=\"\">{message}</span> : null}\n      {signInLabel?.trim() ? (\n        <NavigationLink\n          href={signInHref}\n          // The destination is a trampoline that redirects on mount, so the default prefetch would\n          // fire that GET from a page the shopper may never leave.\n          prefetch={false}\n          data-fs-account-access-gate-notice-action=\"\"\n        >\n          {signInLabel}\n        </NavigationLink>\n      ) : null}\n    </output>\n  );\n}\n\n/**\n * Session storage, guarded at every access. A browser that refuses it — a shopper blocking site data —\n * throws rather than returning null, and a gate that cannot read its own record still has a shopper to\n * get to sign-in. A refusal therefore reads as \"no record\", which spends the hop; the cost is that the\n * loop protection is absent in that browser, which is the lesser of the two failures.\n */\nfunction readSignInAttempt(): string | null {\n  try {\n    return globalThis.sessionStorage.getItem(SIGN_IN_ATTEMPT_KEY);\n  } catch {\n    return null;\n  }\n}\n\nfunction recordSignInAttempt(destination: string): void {\n  try {\n    globalThis.sessionStorage.setItem(SIGN_IN_ATTEMPT_KEY, destination);\n  } catch {\n    // Nothing to fall back to: the record is the only thing that outlives the hop.\n  }\n}\n\nfunction clearSignInAttempt(): void {\n  try {\n    globalThis.sessionStorage.removeItem(SIGN_IN_ATTEMPT_KEY);\n  } catch {\n    // Nothing was written either, so there is nothing to undo.\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"account-access-gate.js","names":[],"sources":["../../../src/matter/account-access-gate/account-access-gate.tsx"],"sourcesContent":["'use client';\n\nimport { type ContentValue, defineComponent, defineContentType } from '@vtex/fs-core';\nimport { type ComponentPropsWithRef, type ReactNode, useEffect, useRef, useState } from 'react';\nimport { flushSync } from 'react-dom';\nimport { NavigationLink } from '../../particles/navigation-link/navigation-link.js';\nimport type { PageRef } from '../../sdk/navigation/types.js';\nimport { useStorefrontNavigation } from '../../sdk/navigation/use-storefront-navigation.js';\nimport { useStorefrontRoute } from '../../sdk/navigation/use-storefront-route.js';\nimport { useSessionRevalidation } from '../../sdk/session/use-session-revalidation.js';\nimport { signInTarget } from '../../utils/safe-href.js';\nimport { type SessionState, useSession } from '../session/session.js';\nimport { useSignOutIntent, withdrawSignOutIntent } from './sign-out-intent.js';\n\n// Nothing is required, following the shipped identity components: an entry may author any subset, and\n// a slice missing a required property is shape-invalid, which drops the whole element rather than the\n// one field.\nexport const AccountAccessGateContent = defineContentType({\n  id: 'account-access-gate',\n  title: 'Account Access Gate',\n  description: 'What the shopper is told while the account resolves and when it will not open for them.',\n  schema: {\n    type: 'object',\n    additionalProperties: false,\n    properties: {\n      loadingLabel: { type: 'string', minLength: 1, title: 'Loading announcement' },\n      expiredMessage: { type: 'string', minLength: 1, title: 'Session ended message' },\n      signInIncompleteMessage: { type: 'string', minLength: 1, title: 'Sign-in did not complete message' },\n      signInLabel: { type: 'string', minLength: 1, title: 'Sign-in link label' },\n    },\n  },\n});\n\n/** Why the account will not open, as a bounded value: a style target and the choice of message. */\nexport type AccountAccessGateNoticeReason = 'expired' | 'sign-in-incomplete';\n\n/** Props for {@link AccountAccessGate}. It renders a different element per outcome and forwards no\n *  element props of its own; each rendered part carries its own. */\nexport type AccountAccessGateProps = {\n  /** Text announced while the session resolves. */\n  loadingLabel?: string;\n  /** What a shopper whose session ended mid-visit is told. */\n  expiredMessage?: string;\n  /** What a shopper who came back from sign-in still signed out is told. */\n  signInIncompleteMessage?: string;\n  /** Label of the link out of either notice. Without it no link renders — a focusable link a screen\n   *  reader announces as its bare URL is worse than no control at all. */\n  signInLabel?: string;\n  /** Merchant-authored fields, sliced from the layout content entry; win over the props field by field\n   *  when present. Absent in a non-CMS store — the props are the fallback. */\n  $content?: ContentValue<typeof AccountAccessGateContent>;\n  /** The account. Rendered only for a signed-in shopper. */\n  children?: ReactNode;\n};\n\n/** Props for {@link AccountAccessGateLoading}. Extends native `<output>` attributes. */\nexport type AccountAccessGateLoadingProps = ComponentPropsWithRef<'output'>;\n\n/** Props for {@link AccountAccessGateNotice}. Extends native `<output>` attributes. */\nexport type AccountAccessGateNoticeProps = Omit<ComponentPropsWithRef<'output'>, 'children'> & {\n  reason: AccountAccessGateNoticeReason;\n  /** The message for this reason. Nothing renders in its place when unauthored. */\n  message?: string;\n  /** Where the link out leads, built by the gate from the page the shopper is on. */\n  signInHref: PageRef | string;\n  /** Label of the link out. No label, no link. */\n  signInLabel?: string;\n};\n\nexport const AccountAccessGateDefinition = defineComponent<AccountAccessGateProps>({\n  name: 'AccountAccessGate',\n  importPath: '@vtex/faststore/components',\n  component: AccountAccessGate,\n  content: AccountAccessGateContent,\n  editor: { label: 'Account Access Gate', category: 'identity' },\n  requiresContext: 'session',\n  schema: {\n    // Mirrored from the content model on purpose, as every content-bearing component in the library\n    // does: the entry wins when published, and this is what a store without a CMS authors.\n    loadingLabel: { type: 'string', label: 'Loading Announcement' },\n    expiredMessage: { type: 'string', label: 'Session Ended Message' },\n    signInIncompleteMessage: { type: 'string', label: 'Sign-in Did Not Complete Message' },\n    signInLabel: { type: 'string', label: 'Sign-in Link Label' },\n  },\n  guideline:\n    \"The account's single access decision: place it once in the account layout, wrapping the body, and every page that declares that layout inherits it — never restate it per section. It renders its children only for a logged-in shopper; it shows a composed loading look while the session resolves, replaces the current history entry with the sign-in destination for a visitor who arrived signed out (identified counts as signed out), tells a shopper whose session ended mid-visit rather than bouncing them, and stands down while AccountMenuSignOut navigates. It redirects at most once per visit: a shopper who comes back from sign-in still signed out gets a message and a link rather than a second hop. Must be inside SessionRoot, which the same layout hosts. Never place the sign-in page under it — the gate redirects there, and a gated sign-in page would redirect to itself.\",\n});\n\n/** The one automatic hop the gate has already spent, surviving the full document load out to the\n *  platform and back, and no further than this tab. */\nconst SIGN_IN_ATTEMPT_KEY = 'fs::account-access-gate::sign-in-attempt';\n\n/**\n * What the gate renders, in precedence order. `signing-in` covers both the frame that decides whether\n * the hop is still available and the frame after the replace is issued: they render the same nothing,\n * and only the effect tells them apart.\n */\ntype AccountAccessGateOutcome = 'stand-down' | 'expired' | 'loading' | 'account' | 'sign-in-incomplete' | 'signing-in';\n\nexport function AccountAccessGate({\n  loadingLabel,\n  expiredMessage,\n  signInIncompleteMessage,\n  signInLabel,\n  $content,\n  children,\n}: Readonly<AccountAccessGateProps>) {\n  const { state, loading } = useSession();\n  const signingOut = useSignOutIntent();\n  // `search` is `null` on the server and during hydration, and re-read on every render of the gate:\n  // a shopper who pages through their orders changes only the query.\n  const { path, search } = useStorefrontRoute();\n  const { hrefFor, replace } = useStorefrontNavigation();\n  const revalidate = useSessionRevalidation();\n\n  // Whether this gate has ever resolved to a signed-in shopper. It is what separates a session that\n  // ended from a visitor who arrived signed out — the tri-state spells both `anonymous`.\n  const [wasSignedIn, setWasSignedIn] = useState(false);\n  // A revalidation that could not answer. It outranks `loading` because the discard that preceded it\n  // is what leaves the session unresolved, so nothing else is coming to end that wait.\n  const [unconfirmed, setUnconfirmed] = useState(false);\n  // A re-read in flight. The gate withholds the account for itself rather than waiting to be told:\n  // discarding the cached session leaves the data layer unresolved, but it reaches the gate only once\n  // the watched query has re-read, and the account must be gone in the frame the restore arrives.\n  const [revalidating, setRevalidating] = useState(false);\n  // Which re-read the gate is still listening to. Two restores in a row put two answers in flight, and\n  // the older one may land last.\n  const restoreGeneration = useRef(0);\n  // `null` until the arrival path has read the record. Read from an effect rather than from the render\n  // body: session storage does not exist on the server, and a value that appeared between the server\n  // pass and hydration would change what renders underneath it.\n  const [hopSpent, setHopSpent] = useState<boolean | null>(null);\n\n  // Where the shopper comes back to: the logical path, which the sign-in route prefixes on the way back.\n  // The path alone would return someone reading `/pvt/orders?page=2` to the first page of it.\n  const returnPath = `${path}${search ?? ''}`;\n\n  const outcome = resolveOutcome({ signingOut, unconfirmed, revalidating, loading, state, wasSignedIn, hopSpent });\n\n  useEffect(() => {\n    switch (outcome) {\n      case 'account':\n        setWasSignedIn(true);\n        setUnconfirmed(false);\n        clearSignInAttempt();\n        return;\n      case 'expired':\n      case 'sign-in-incomplete':\n        // Every outcome that is not the hop returns it: a shopper who signs in, browses, and comes\n        // back later arrives fresh rather than carrying a spent attempt from an earlier one.\n        clearSignInAttempt();\n        return;\n      case 'signing-in': {\n        // One more frame before deciding, until the document has been read: a hop recorded against the\n        // bare path is the one the shopper comes back to, and there is no second chance at it.\n        if (hopSpent !== null || search === null) {\n          return;\n        }\n        if (readSignInAttempt() !== null) {\n          setHopSpent(true);\n          return;\n        }\n        const target = signInTarget(returnPath);\n        // The record is the resolved href, but the navigation takes the target: `replace` adds the\n        // binding's base path, and handing it the href would add it twice.\n        const destination = hrefFor(target);\n        // A store with no sign-in page has nowhere to send the shopper. `hrefFor` already logged it;\n        // the notice is what keeps the page from staying blank.\n        if (destination === null) {\n          setHopSpent(true);\n          return;\n        }\n        recordSignInAttempt(destination);\n        setHopSpent(false);\n        // Replace rather than push: back from the platform's login should reach the page the shopper\n        // came from, not the account that threw them at it.\n        // react-doctor-disable-next-line nextjs-no-client-side-redirect -- the session resolves on the client, so the server has nothing to decide with\n        replace(target);\n        return;\n      }\n      case 'stand-down':\n      case 'loading':\n        return;\n      default:\n        assertUnreachable(outcome);\n    }\n  }, [outcome, hopSpent, search, returnPath, hrefFor, replace]);\n\n  useEffect(() => {\n    function handlePageHide(event: PageTransitionEvent): void {\n      if (!event.persisted) {\n        return;\n      }\n      // What the browser freezes is the DOM, and a restore puts that same DOM back before any script\n      // runs. Standing the account down on the way out rather than on the way back is what keeps the\n      // restored document from showing it in the frames before `pageshow` can decide again.\n      flushSync(() => {\n        setRevalidating(true);\n      });\n    }\n\n    function handlePageShow(event: PageTransitionEvent): void {\n      // An ordinary load re-decides by mounting. Only a restore resumes a heap that already holds an\n      // answer, and `persisted` is the browser's own word for it.\n      if (!event.persisted) {\n        return;\n      }\n      const generation = restoreGeneration.current + 1;\n      restoreGeneration.current = generation;\n      // The navigation this authorized has already happened; a restored document holding it would\n      // stand down forever. Withdrawn before the re-read so the gate is deciding again by the time\n      // the answer lands.\n      withdrawSignOutIntent();\n      setUnconfirmed(false);\n      setRevalidating(true);\n      void revalidate().then((result) => {\n        // A later restore has already asked the same question, and its answer is the one that counts.\n        // This one describes a session the gate has since discarded a second time.\n        if (generation !== restoreGeneration.current) {\n          return;\n        }\n        setRevalidating(false);\n        switch (result) {\n          case 'failed':\n            setUnconfirmed(true);\n            return;\n          case 'revalidated':\n          case 'unavailable':\n            // Nothing left to distrust: either the session was re-read, or there was no cached\n            // session to discard in the first place and the one in the tree came from a prop.\n            return;\n          default:\n            assertUnreachable(result);\n        }\n      });\n    }\n\n    globalThis.addEventListener('pagehide', handlePageHide);\n    globalThis.addEventListener('pageshow', handlePageShow);\n    return () => {\n      globalThis.removeEventListener('pagehide', handlePageHide);\n      globalThis.removeEventListener('pageshow', handlePageShow);\n    };\n  }, [revalidate]);\n\n  // The intent authorizes one transition and this gate is its only reader, so it must not survive the\n  // gate. A sign-out that navigates client-side takes the account layout down without reloading the\n  // document, and nothing else would ever take the flag back: the next account page the shopper opens\n  // would mount into a standing intent and render nothing at all, with no error to explain it.\n  useEffect(() => withdrawSignOutIntent, []);\n\n  // Blank entry fields fall through, so clearing one in the Admin reads as unauthored.\n  const entryLoadingLabel = $content?.loadingLabel?.trim() ? $content.loadingLabel : loadingLabel;\n  const entryExpiredMessage = $content?.expiredMessage?.trim() ? $content.expiredMessage : expiredMessage;\n  const entryIncompleteMessage = $content?.signInIncompleteMessage?.trim()\n    ? $content.signInIncompleteMessage\n    : signInIncompleteMessage;\n  const entrySignInLabel = $content?.signInLabel?.trim() ? $content.signInLabel : signInLabel;\n\n  switch (outcome) {\n    case 'stand-down':\n    case 'signing-in':\n      return null;\n    case 'loading':\n      return (\n        // The part carries its own hook; the component's identity travels from here, which is how a\n        // store targets it by name the way every other component is targeted.\n        <AccountAccessGateLoading data-fs-account-access-gate=\"\">{entryLoadingLabel}</AccountAccessGateLoading>\n      );\n    case 'account':\n      return <>{children}</>;\n    case 'expired':\n    case 'sign-in-incomplete':\n      return (\n        <AccountAccessGateNotice\n          data-fs-account-access-gate=\"\"\n          reason={outcome === 'expired' ? 'expired' : 'sign-in-incomplete'}\n          message={outcome === 'expired' ? entryExpiredMessage : entryIncompleteMessage}\n          signInHref={signInTarget(returnPath)}\n          signInLabel={entrySignInLabel}\n        />\n      );\n    default:\n      return assertUnreachable(outcome);\n  }\n}\n\n/**\n * The whole decision, as one ordered read of the gate's inputs.\n *\n * `signingOut` outranks everything, including a session still reading `loggedIn`: the sign-out records\n * its intent before it awaits the mutation, and the frame between the payload landing and the document\n * load starting is exactly the one this ordering protects.\n *\n * `loading` outranks the tri-state for the reason `AccountEntryPoint` gives: an unresolved session\n * reports `anonymous`, so reading the state first would bounce a shopper who is signed in. A re-read\n * in flight reads as the same wait: the session it is checking is one the gate has stopped believing.\n */\nfunction resolveOutcome({\n  signingOut,\n  unconfirmed,\n  revalidating,\n  loading,\n  state,\n  wasSignedIn,\n  hopSpent,\n}: {\n  signingOut: boolean;\n  unconfirmed: boolean;\n  revalidating: boolean;\n  loading: boolean;\n  state: SessionState;\n  wasSignedIn: boolean;\n  hopSpent: boolean | null;\n}): AccountAccessGateOutcome {\n  if (signingOut) {\n    return 'stand-down';\n  }\n  // A re-read that could not answer says nothing about how the shopper got here, so the notice keeps\n  // the history the gate already has. Telling someone who never reached the account that their session\n  // ended names an event that never happened; the incomplete sign-in is the one they actually had.\n  if (unconfirmed) {\n    return wasSignedIn ? 'expired' : 'sign-in-incomplete';\n  }\n  if (revalidating || loading) {\n    return 'loading';\n  }\n  if (state === 'loggedIn') {\n    return 'account';\n  }\n  if (wasSignedIn) {\n    return 'expired';\n  }\n  return hopSpent === true ? 'sign-in-incomplete' : 'signing-in';\n}\n\nfunction assertUnreachable(outcome: never): never {\n  throw new Error(`[AccountAccessGate] unhandled outcome: ${String(outcome)}`);\n}\n\n/**\n * The look of a session that has not answered yet. A real part with its own hook rather than an ad hoc\n * spinner, so a store can style it and a story can render it.\n */\nexport function AccountAccessGateLoading({ className, children, ...props }: AccountAccessGateLoadingProps) {\n  return (\n    <output {...props} aria-live=\"polite\" className={className} data-fs-account-access-gate-loading=\"\">\n      {children}\n    </output>\n  );\n}\n\n/**\n * What renders in the account's place when it will not open: the message for this reason, and a link\n * the shopper may take back into sign-in.\n *\n * The link is the whole of the escape from a sign-in loop. The gate stops redirecting after one\n * automatic hop, so the next attempt is a click rather than a bounce — and a shopper who keeps landing\n * here at least lands on a page that says so.\n */\nexport function AccountAccessGateNotice({\n  reason,\n  message,\n  signInHref,\n  signInLabel,\n  className,\n  ...props\n}: AccountAccessGateNoticeProps) {\n  return (\n    <output\n      {...props}\n      aria-live=\"polite\"\n      className={className}\n      data-fs-account-access-gate-notice=\"\"\n      data-fs-account-access-gate-notice-reason={reason}\n    >\n      {message ? <span data-fs-account-access-gate-notice-message=\"\">{message}</span> : null}\n      {signInLabel?.trim() ? (\n        <NavigationLink\n          href={signInHref}\n          // The destination is a trampoline that redirects on mount, so the default prefetch would\n          // fire that GET from a page the shopper may never leave.\n          prefetch={false}\n          data-fs-account-access-gate-notice-action=\"\"\n        >\n          {signInLabel}\n        </NavigationLink>\n      ) : null}\n    </output>\n  );\n}\n\n/**\n * Session storage, guarded at every access. A browser that refuses it — a shopper blocking site data —\n * throws rather than returning null, and a gate that cannot read its own record still has a shopper to\n * get to sign-in. A refusal therefore reads as \"no record\", which spends the hop; the cost is that the\n * loop protection is absent in that browser, which is the lesser of the two failures.\n */\nfunction readSignInAttempt(): string | null {\n  try {\n    return globalThis.sessionStorage.getItem(SIGN_IN_ATTEMPT_KEY);\n  } catch {\n    return null;\n  }\n}\n\nfunction recordSignInAttempt(destination: string): void {\n  try {\n    globalThis.sessionStorage.setItem(SIGN_IN_ATTEMPT_KEY, destination);\n  } catch {\n    // Nothing to fall back to: the record is the only thing that outlives the hop.\n  }\n}\n\nfunction clearSignInAttempt(): void {\n  try {\n    globalThis.sessionStorage.removeItem(SIGN_IN_ATTEMPT_KEY);\n  } catch {\n    // Nothing was written either, so there is nothing to undo.\n  }\n}\n"],"mappings":"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"}