@vtex/faststore 0.0.8 → 0.0.10

package/dist/sdk/i18n/messages/en-US.js

@@ -64,6 +64,7 @@ var en_US_default = {
 	"fs/address.field.town": "Town",
 	"fs/address.placeholder.postal-code": "Example: {example}",
 	"fs/address.placeholder.street": "Address line 1",
+	"fs/card.ending-in": "ending in {lastDigits}",
 	"fs/form.clear": "Clear",
 	"fs/form.reset": "Reset",
 	"fs/form.submit": "Continue",
@@ -143,6 +144,24 @@ var en_US_default = {
 	"fs/region.error.network": "Unable to set your region. Please try again.",
 	"fs/region.error.unserved-postal-code": "We do not deliver to this postal code yet.",
 	"fs/route.not-found": "Page not found",
+	"fs/saved-cards.empty": "You have no saved cards yet.",
+	"fs/saved-cards.expired": "Expired",
+	"fs/saved-cards.expired-no-date": "Expired",
+	"fs/saved-cards.expires": "Expires",
+	"fs/saved-cards.heading": "Saved cards",
+	"fs/saved-cards.load-failed": "We couldn't load your saved cards. Please try again later.",
+	"fs/saved-cards.loading": "Loading your saved cards…",
+	"fs/saved-cards.remove.cancel": "Cancel",
+	"fs/saved-cards.remove.confirm": "Remove card",
+	"fs/saved-cards.remove.description": "It will no longer be offered when you pay. This can't be undone.",
+	"fs/saved-cards.remove.failed": "We couldn't remove the card. Please try again.",
+	"fs/saved-cards.remove.pending": "Removing…",
+	"fs/saved-cards.remove.success": "The card was removed.",
+	"fs/saved-cards.remove.title": "Remove this card?",
+	"fs/saved-cards.remove.trigger": "Remove",
+	"fs/saved-cards.session-expired": "Your session has expired.",
+	"fs/saved-cards.sign-in": "Sign in again",
+	"fs/saved-cards.unusable": "This card can't be used",
 	"fs/shipping.calculating": "Calculating…",
 	"fs/shipping.calculation-failed": "Unable to calculate shipping. Try again.",
 	"fs/shipping.estimate.in-business-days": "in {days, plural, one {# business day} other {# business days}}",

package/dist/sdk/i18n/messages/en-US.json

@@ -63,6 +63,7 @@
   "fs/address.field.town": "Town",
   "fs/address.placeholder.postal-code": "Example: {example}",
   "fs/address.placeholder.street": "Address line 1",
+  "fs/card.ending-in": "ending in {lastDigits}",
   "fs/form.clear": "Clear",
   "fs/form.reset": "Reset",
   "fs/form.submit": "Continue",
@@ -142,6 +143,24 @@
   "fs/region.error.network": "Unable to set your region. Please try again.",
   "fs/region.error.unserved-postal-code": "We do not deliver to this postal code yet.",
   "fs/route.not-found": "Page not found",
+  "fs/saved-cards.empty": "You have no saved cards yet.",
+  "fs/saved-cards.expired": "Expired",
+  "fs/saved-cards.expired-no-date": "Expired",
+  "fs/saved-cards.expires": "Expires",
+  "fs/saved-cards.heading": "Saved cards",
+  "fs/saved-cards.load-failed": "We couldn't load your saved cards. Please try again later.",
+  "fs/saved-cards.loading": "Loading your saved cards…",
+  "fs/saved-cards.remove.cancel": "Cancel",
+  "fs/saved-cards.remove.confirm": "Remove card",
+  "fs/saved-cards.remove.description": "It will no longer be offered when you pay. This can't be undone.",
+  "fs/saved-cards.remove.failed": "We couldn't remove the card. Please try again.",
+  "fs/saved-cards.remove.pending": "Removing…",
+  "fs/saved-cards.remove.success": "The card was removed.",
+  "fs/saved-cards.remove.title": "Remove this card?",
+  "fs/saved-cards.remove.trigger": "Remove",
+  "fs/saved-cards.session-expired": "Your session has expired.",
+  "fs/saved-cards.sign-in": "Sign in again",
+  "fs/saved-cards.unusable": "This card can't be used",
   "fs/shipping.calculating": "Calculating…",
   "fs/shipping.calculation-failed": "Unable to calculate shipping. Try again.",
   "fs/shipping.estimate.in-business-days": "in {days, plural, one {# business day} other {# business days}}",

package/dist/sdk/i18n/messages/en-US.json.d.ts

@@ -64,6 +64,7 @@ declare const _exports: {
   "fs/address.field.town": string;
   "fs/address.placeholder.postal-code": string;
   "fs/address.placeholder.street": string;
+  "fs/card.ending-in": string;
   "fs/form.clear": string;
   "fs/form.reset": string;
   "fs/form.submit": string;
@@ -143,6 +144,24 @@ declare const _exports: {
   "fs/region.error.network": string;
   "fs/region.error.unserved-postal-code": string;
   "fs/route.not-found": string;
+  "fs/saved-cards.empty": string;
+  "fs/saved-cards.expired": string;
+  "fs/saved-cards.expired-no-date": string;
+  "fs/saved-cards.expires": string;
+  "fs/saved-cards.heading": string;
+  "fs/saved-cards.load-failed": string;
+  "fs/saved-cards.loading": string;
+  "fs/saved-cards.remove.cancel": string;
+  "fs/saved-cards.remove.confirm": string;
+  "fs/saved-cards.remove.description": string;
+  "fs/saved-cards.remove.failed": string;
+  "fs/saved-cards.remove.pending": string;
+  "fs/saved-cards.remove.success": string;
+  "fs/saved-cards.remove.title": string;
+  "fs/saved-cards.remove.trigger": string;
+  "fs/saved-cards.session-expired": string;
+  "fs/saved-cards.sign-in": string;
+  "fs/saved-cards.unusable": string;
   "fs/shipping.calculating": string;
   "fs/shipping.calculation-failed": string;
   "fs/shipping.estimate.in-business-days": string;

package/dist/sdk/i18n/messages/es-ES.js

@@ -64,6 +64,7 @@ var es_ES_default = {
 	"fs/address.field.town": "Pueblo / ciudad",
 	"fs/address.placeholder.postal-code": "Ejemplo: {example}",
 	"fs/address.placeholder.street": "Dirección línea 1",
+	"fs/card.ending-in": "terminada en {lastDigits}",
 	"fs/form.clear": "Limpiar",
 	"fs/form.reset": "Restablecer",
 	"fs/form.submit": "Continuar",
@@ -143,6 +144,24 @@ var es_ES_default = {
 	"fs/region.error.network": "No se pudo definir tu región. Inténtalo de nuevo.",
 	"fs/region.error.unserved-postal-code": "Todavía no hacemos entregas en este código postal.",
 	"fs/route.not-found": "Página no encontrada",
+	"fs/saved-cards.empty": "Aún no tienes tarjetas guardadas.",
+	"fs/saved-cards.expired": "Venció el",
+	"fs/saved-cards.expired-no-date": "Vencida",
+	"fs/saved-cards.expires": "Vence el",
+	"fs/saved-cards.heading": "Tarjetas guardadas",
+	"fs/saved-cards.load-failed": "No pudimos cargar tus tarjetas guardadas. Inténtalo de nuevo más tarde.",
+	"fs/saved-cards.loading": "Cargando tus tarjetas guardadas…",
+	"fs/saved-cards.remove.cancel": "Cancelar",
+	"fs/saved-cards.remove.confirm": "Eliminar tarjeta",
+	"fs/saved-cards.remove.description": "Ya no se ofrecerá al pagar. Esta acción no se puede deshacer.",
+	"fs/saved-cards.remove.failed": "No pudimos eliminar la tarjeta. Inténtalo de nuevo.",
+	"fs/saved-cards.remove.pending": "Eliminando…",
+	"fs/saved-cards.remove.success": "La tarjeta fue eliminada.",
+	"fs/saved-cards.remove.title": "¿Eliminar esta tarjeta?",
+	"fs/saved-cards.remove.trigger": "Eliminar",
+	"fs/saved-cards.session-expired": "Tu sesión ha caducado.",
+	"fs/saved-cards.sign-in": "Iniciar sesión de nuevo",
+	"fs/saved-cards.unusable": "Esta tarjeta no se puede usar",
 	"fs/shipping.calculating": "Calculando…",
 	"fs/shipping.calculation-failed": "No se pudo calcular el envío. Inténtalo de nuevo.",
 	"fs/shipping.estimate.in-business-days": "en {days, plural, one {# día hábil} other {# días hábiles}}",

package/dist/sdk/i18n/messages/es-ES.json

@@ -63,6 +63,7 @@
   "fs/address.field.town": "Pueblo / ciudad",
   "fs/address.placeholder.postal-code": "Ejemplo: {example}",
   "fs/address.placeholder.street": "Dirección línea 1",
+  "fs/card.ending-in": "terminada en {lastDigits}",
   "fs/form.clear": "Limpiar",
   "fs/form.reset": "Restablecer",
   "fs/form.submit": "Continuar",
@@ -142,6 +143,24 @@
   "fs/region.error.network": "No se pudo definir tu región. Inténtalo de nuevo.",
   "fs/region.error.unserved-postal-code": "Todavía no hacemos entregas en este código postal.",
   "fs/route.not-found": "Página no encontrada",
+  "fs/saved-cards.empty": "Aún no tienes tarjetas guardadas.",
+  "fs/saved-cards.expired": "Venció el",
+  "fs/saved-cards.expired-no-date": "Vencida",
+  "fs/saved-cards.expires": "Vence el",
+  "fs/saved-cards.heading": "Tarjetas guardadas",
+  "fs/saved-cards.load-failed": "No pudimos cargar tus tarjetas guardadas. Inténtalo de nuevo más tarde.",
+  "fs/saved-cards.loading": "Cargando tus tarjetas guardadas…",
+  "fs/saved-cards.remove.cancel": "Cancelar",
+  "fs/saved-cards.remove.confirm": "Eliminar tarjeta",
+  "fs/saved-cards.remove.description": "Ya no se ofrecerá al pagar. Esta acción no se puede deshacer.",
+  "fs/saved-cards.remove.failed": "No pudimos eliminar la tarjeta. Inténtalo de nuevo.",
+  "fs/saved-cards.remove.pending": "Eliminando…",
+  "fs/saved-cards.remove.success": "La tarjeta fue eliminada.",
+  "fs/saved-cards.remove.title": "¿Eliminar esta tarjeta?",
+  "fs/saved-cards.remove.trigger": "Eliminar",
+  "fs/saved-cards.session-expired": "Tu sesión ha caducado.",
+  "fs/saved-cards.sign-in": "Iniciar sesión de nuevo",
+  "fs/saved-cards.unusable": "Esta tarjeta no se puede usar",
   "fs/shipping.calculating": "Calculando…",
   "fs/shipping.calculation-failed": "No se pudo calcular el envío. Inténtalo de nuevo.",
   "fs/shipping.estimate.in-business-days": "en {days, plural, one {# día hábil} other {# días hábiles}}",

package/dist/sdk/i18n/messages/pt-BR.js

@@ -64,6 +64,7 @@ var pt_BR_default = {
 	"fs/address.field.town": "Cidade",
 	"fs/address.placeholder.postal-code": "Exemplo: {example}",
 	"fs/address.placeholder.street": "Endereço",
+	"fs/card.ending-in": "final {lastDigits}",
 	"fs/form.clear": "Limpar",
 	"fs/form.reset": "Redefinir",
 	"fs/form.submit": "Continuar",
@@ -143,6 +144,24 @@ var pt_BR_default = {
 	"fs/region.error.network": "Não foi possível definir sua região. Tente novamente.",
 	"fs/region.error.unserved-postal-code": "Ainda não entregamos neste CEP.",
 	"fs/route.not-found": "Página não encontrada",
+	"fs/saved-cards.empty": "Você ainda não tem cartões salvos.",
+	"fs/saved-cards.expired": "Venceu em",
+	"fs/saved-cards.expired-no-date": "Vencido",
+	"fs/saved-cards.expires": "Vence em",
+	"fs/saved-cards.heading": "Cartões salvos",
+	"fs/saved-cards.load-failed": "Não foi possível carregar seus cartões salvos. Tente novamente mais tarde.",
+	"fs/saved-cards.loading": "Carregando seus cartões salvos…",
+	"fs/saved-cards.remove.cancel": "Cancelar",
+	"fs/saved-cards.remove.confirm": "Remover cartão",
+	"fs/saved-cards.remove.description": "Ele não será mais oferecido no pagamento. Essa ação não pode ser desfeita.",
+	"fs/saved-cards.remove.failed": "Não foi possível remover o cartão. Tente novamente.",
+	"fs/saved-cards.remove.pending": "Removendo…",
+	"fs/saved-cards.remove.success": "O cartão foi removido.",
+	"fs/saved-cards.remove.title": "Remover este cartão?",
+	"fs/saved-cards.remove.trigger": "Remover",
+	"fs/saved-cards.session-expired": "Sua sessão expirou.",
+	"fs/saved-cards.sign-in": "Entrar novamente",
+	"fs/saved-cards.unusable": "Este cartão não pode ser usado",
 	"fs/shipping.calculating": "Calculando…",
 	"fs/shipping.calculation-failed": "Não foi possível calcular o frete. Tente novamente.",
 	"fs/shipping.estimate.in-business-days": "em {days, plural, one {# dia útil} other {# dias úteis}}",

package/dist/sdk/i18n/messages/pt-BR.json

@@ -63,6 +63,7 @@
   "fs/address.field.town": "Cidade",
   "fs/address.placeholder.postal-code": "Exemplo: {example}",
   "fs/address.placeholder.street": "Endereço",
+  "fs/card.ending-in": "final {lastDigits}",
   "fs/form.clear": "Limpar",
   "fs/form.reset": "Redefinir",
   "fs/form.submit": "Continuar",
@@ -142,6 +143,24 @@
   "fs/region.error.network": "Não foi possível definir sua região. Tente novamente.",
   "fs/region.error.unserved-postal-code": "Ainda não entregamos neste CEP.",
   "fs/route.not-found": "Página não encontrada",
+  "fs/saved-cards.empty": "Você ainda não tem cartões salvos.",
+  "fs/saved-cards.expired": "Venceu em",
+  "fs/saved-cards.expired-no-date": "Vencido",
+  "fs/saved-cards.expires": "Vence em",
+  "fs/saved-cards.heading": "Cartões salvos",
+  "fs/saved-cards.load-failed": "Não foi possível carregar seus cartões salvos. Tente novamente mais tarde.",
+  "fs/saved-cards.loading": "Carregando seus cartões salvos…",
+  "fs/saved-cards.remove.cancel": "Cancelar",
+  "fs/saved-cards.remove.confirm": "Remover cartão",
+  "fs/saved-cards.remove.description": "Ele não será mais oferecido no pagamento. Essa ação não pode ser desfeita.",
+  "fs/saved-cards.remove.failed": "Não foi possível remover o cartão. Tente novamente.",
+  "fs/saved-cards.remove.pending": "Removendo…",
+  "fs/saved-cards.remove.success": "O cartão foi removido.",
+  "fs/saved-cards.remove.title": "Remover este cartão?",
+  "fs/saved-cards.remove.trigger": "Remover",
+  "fs/saved-cards.session-expired": "Sua sessão expirou.",
+  "fs/saved-cards.sign-in": "Entrar novamente",
+  "fs/saved-cards.unusable": "Este cartão não pode ser usado",
   "fs/shipping.calculating": "Calculando…",
   "fs/shipping.calculation-failed": "Não foi possível calcular o frete. Tente novamente.",
   "fs/shipping.estimate.in-business-days": "em {days, plural, one {# dia útil} other {# dias úteis}}",

package/dist/sdk/i18n/provider.js

@@ -7,7 +7,7 @@ import { IntlProvider } from "react-intl";
 * Mounted by `StorefrontProvider`, never by a store.
 *
 * The record arrives already resolved: the server merged the locale's catalog over the fallback
-* chain `global.json` declares, so SSR and hydration read the same bytes and only one locale reaches
+* chain the store's foundation declares, so SSR and hydration read the same bytes and only one locale reaches
 * the browser.
 *
 * The tag is normalized for the same reason `getIntl` normalizes it: when no catalog ships for the

package/dist/sdk/i18n/provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider.js","names":[],"sources":["../../../src/sdk/i18n/provider.tsx"],"sourcesContent":["'use client';\n\nimport type { ReactNode } from 'react';\nimport { IntlProvider } from 'react-intl';\nimport { asIntlMessages, DEFAULT_LOCALE, type Messages, normalizeLocale, onIntlError } from './locales.js';\n\nexport type MessageProviderProps = Readonly<{\n  locale: string;\n  messages: Messages;\n  children: ReactNode;\n}>;\n\n/**\n * Mounted by `StorefrontProvider`, never by a store.\n *\n * The record arrives already resolved: the server merged the locale's catalog over the fallback\n * chain `global.json` declares, so SSR and hydration read the same bytes and only one locale reaches\n * the browser.\n *\n * The tag is normalized for the same reason `getIntl` normalizes it: when no catalog ships for the\n * declared locale the strings rendered are the source catalog's, and plural categories have to be\n * selected under the language those strings are written in. Without it a Server Component and a\n * Client Component could pluralize the same English string under different rules.\n */\nexport function MessageProvider({ locale, messages, children }: MessageProviderProps) {\n  return (\n    <IntlProvider\n      locale={normalizeLocale(locale) ?? DEFAULT_LOCALE}\n      defaultLocale={DEFAULT_LOCALE}\n      messages={asIntlMessages(messages)}\n      onError={onIntlError}\n    >\n      {children}\n    </IntlProvider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAwBA,SAAgB,gBAAgB,EAAE,QAAQ,UAAU,YAAkC;CACpF,OACE,oBAAC,cAAD;EACE,QAAQ,gBAAgB,MAAM,KAAA;EAC9B,eAAe;EACf,UAAU,eAAe,QAAQ;EACjC,SAAS;EAER;CACW,CAAA;AAElB"}
+{"version":3,"file":"provider.js","names":[],"sources":["../../../src/sdk/i18n/provider.tsx"],"sourcesContent":["'use client';\n\nimport type { ReactNode } from 'react';\nimport { IntlProvider } from 'react-intl';\nimport { asIntlMessages, DEFAULT_LOCALE, type Messages, normalizeLocale, onIntlError } from './locales.js';\n\nexport type MessageProviderProps = Readonly<{\n  locale: string;\n  messages: Messages;\n  children: ReactNode;\n}>;\n\n/**\n * Mounted by `StorefrontProvider`, never by a store.\n *\n * The record arrives already resolved: the server merged the locale's catalog over the fallback\n * chain the store's foundation declares, so SSR and hydration read the same bytes and only one locale reaches\n * the browser.\n *\n * The tag is normalized for the same reason `getIntl` normalizes it: when no catalog ships for the\n * declared locale the strings rendered are the source catalog's, and plural categories have to be\n * selected under the language those strings are written in. Without it a Server Component and a\n * Client Component could pluralize the same English string under different rules.\n */\nexport function MessageProvider({ locale, messages, children }: MessageProviderProps) {\n  return (\n    <IntlProvider\n      locale={normalizeLocale(locale) ?? DEFAULT_LOCALE}\n      defaultLocale={DEFAULT_LOCALE}\n      messages={asIntlMessages(messages)}\n      onError={onIntlError}\n    >\n      {children}\n    </IntlProvider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAwBA,SAAgB,gBAAgB,EAAE,QAAQ,UAAU,YAAkC;CACpF,OACE,oBAAC,cAAD;EACE,QAAQ,gBAAgB,MAAM,KAAA;EAC9B,eAAe;EACf,UAAU,eAAe,QAAQ;EACjC,SAAS;EAER;CACW,CAAA;AAElB"}

package/dist/sdk/locale/binding-switch-provider.d.ts

@@ -0,0 +1,13 @@
+import { BindingSwitchRequest, BindingSwitchResult } from "../navigation/binding-switch.js";
+import { ReactNode } from "react";
+//#region src/sdk/locale/binding-switch-provider.d.ts
+export type SwitchBinding = (request: BindingSwitchRequest) => Promise<BindingSwitchResult>;
+export type BindingSwitchProviderProps = Readonly<{
+  /** The app's `switchBinding` server action. The package cannot import the generated binding table. */
+  switchBinding: SwitchBinding;
+  children: ReactNode;
+}>;
+/** Hands the generated app's `switchBinding` server action to `locale.set`. */
+export declare function BindingSwitchProvider({ switchBinding, children }: BindingSwitchProviderProps): import("react/jsx-runtime").JSX.Element;
+//#endregion
+//# sourceMappingURL=binding-switch-provider.d.ts.map

package/dist/sdk/locale/binding-switch-provider.js

@@ -0,0 +1,20 @@
+"use client";
+import { createContext, useContext } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/sdk/locale/binding-switch-provider.tsx
+const Context = createContext(null);
+/** Hands the generated app's `switchBinding` server action to `locale.set`. */
+function BindingSwitchProvider({ switchBinding, children }) {
+	return /* @__PURE__ */ jsx(Context.Provider, {
+		value: switchBinding,
+		children
+	});
+}
+/** The provided server action, or `null` outside a `BindingSwitchProvider`. */
+function useSwitchBinding() {
+	return useContext(Context);
+}
+//#endregion
+export { BindingSwitchProvider, useSwitchBinding };
+
+//# sourceMappingURL=binding-switch-provider.js.map

package/dist/sdk/locale/binding-switch-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-switch-provider.js","names":[],"sources":["../../../src/sdk/locale/binding-switch-provider.tsx"],"sourcesContent":["'use client';\n\nimport { createContext, type ReactNode, useContext } from 'react';\nimport type { BindingSwitchRequest, BindingSwitchResult } from '../navigation/binding-switch.js';\n\nexport type SwitchBinding = (request: BindingSwitchRequest) => Promise<BindingSwitchResult>;\n\nexport type BindingSwitchProviderProps = Readonly<{\n  /** The app's `switchBinding` server action. The package cannot import the generated binding table. */\n  switchBinding: SwitchBinding;\n  children: ReactNode;\n}>;\n\nconst Context = createContext<SwitchBinding | null>(null);\n\n/** Hands the generated app's `switchBinding` server action to `locale.set`. */\nexport function BindingSwitchProvider({ switchBinding, children }: BindingSwitchProviderProps) {\n  return <Context.Provider value={switchBinding}>{children}</Context.Provider>;\n}\n\n/** The provided server action, or `null` outside a `BindingSwitchProvider`. */\nexport function useSwitchBinding(): SwitchBinding | null {\n  return useContext(Context);\n}\n"],"mappings":";;;;AAaA,MAAM,UAAU,cAAoC,IAAI;;AAGxD,SAAgB,sBAAsB,EAAE,eAAe,YAAwC;CAC7F,OAAO,oBAAC,QAAQ,UAAT;EAAkB,OAAO;EAAgB;CAA2B,CAAA;AAC7E;;AAGA,SAAgB,mBAAyC;CACvD,OAAO,WAAW,OAAO;AAC3B"}

package/dist/sdk/locale/use-locale-actions.d.ts

@@ -0,0 +1,16 @@
+import "../../core/dist/index.js";
+//#region src/sdk/locale/use-locale-actions.d.ts
+/**
+ * The `locale` action namespace. `set` switches the whole binding (locale, currency, sales channel):
+ * the app's server action decides the equivalent URL, or the no-equivalent fallback, and the browser
+ * goes there with a document navigation. `set` always resolves, never navigates on an error, and
+ * resolves `true` only when it started the navigation.
+ */
+export type LocaleActions = Readonly<{
+  /** Switches to the binding `bindingId` names. `true` once the navigation starts; `false` after logging. */
+  set: (payload: {
+    bindingId: string;
+  }) => Promise<boolean>;
+}>;
+//#endregion
+//# sourceMappingURL=use-locale-actions.d.ts.map

package/dist/sdk/locale/use-locale-actions.js

@@ -0,0 +1,70 @@
+"use client";
+import { defineActions } from "../../core/dist/actions/registry.js";
+import "../../core/dist/index.js";
+import { useStorefrontContext } from "../context/storefront-context.js";
+import { useStorefrontRoute } from "../navigation/use-storefront-route.js";
+import { loggableErrorName } from "../../utils/loggable-error-name.js";
+import { useSwitchBinding } from "./binding-switch-provider.js";
+import { useCallback, useMemo } from "react";
+//#region src/sdk/locale/use-locale-actions.ts
+/**
+* The `locale` namespace hook. Reads the route at call time: `search` and `hash` come from
+* `location`, because `useStorefrontRoute().search` is `null` during hydration. The page name is
+* not sent: a layout has none, and the server derives the page from the path and params.
+*/
+function useLocaleActions() {
+	const switchBinding = useSwitchBinding();
+	const { params, path } = useStorefrontRoute();
+	const { bindingId: currentBindingId } = useStorefrontContext();
+	const set = useCallback(async ({ bindingId }) => {
+		if (!switchBinding) {
+			console.error("[locale.set] no BindingSwitchProvider");
+			return false;
+		}
+		try {
+			const { url } = await switchBinding({
+				bindingId,
+				currentBindingId,
+				params,
+				path,
+				search: globalThis.location.search,
+				hash: globalThis.location.hash
+			});
+			if (url === null) {
+				console.error("[locale.set] no URL for the binding");
+				return false;
+			}
+			globalThis.location.assign(url);
+			return true;
+		} catch (error) {
+			console.error("[locale.set] switchBinding failed", loggableErrorName(error));
+			return false;
+		}
+	}, [
+		switchBinding,
+		currentBindingId,
+		params,
+		path
+	]);
+	return useMemo(() => ({ set }), [set]);
+}
+defineActions({
+	namespace: "locale",
+	description: "Switches the whole binding (locale, currency, sales channel) by a document navigation to the equivalent URL, or to the destination home with a notice.",
+	provider: {
+		name: "LocaleActionProvider",
+		importPath: "@vtex/faststore/internal/client"
+	},
+	methods: { set: {
+		description: "Switch to another binding: navigates to the equivalent URL of the current page, or to the destination home with fs_notice=no-equivalent.",
+		payload: [{
+			name: "bindingId",
+			type: "string"
+		}]
+	} },
+	use: useLocaleActions
+});
+//#endregion
+export { useLocaleActions };
+
+//# sourceMappingURL=use-locale-actions.js.map

package/dist/sdk/locale/use-locale-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-locale-actions.js","names":[],"sources":["../../../src/sdk/locale/use-locale-actions.ts"],"sourcesContent":["'use client';\n\nimport { defineActions } from '@vtex/fs-core';\nimport { useCallback, useMemo } from 'react';\nimport { loggableErrorName } from '../../utils/loggable-error-name.js';\nimport { useStorefrontContext } from '../context/storefront-context.js';\nimport { useStorefrontRoute } from '../navigation/use-storefront-route.js';\nimport { useSwitchBinding } from './binding-switch-provider.js';\n\n/**\n * The `locale` action namespace. `set` switches the whole binding (locale, currency, sales channel):\n * the app's server action decides the equivalent URL, or the no-equivalent fallback, and the browser\n * goes there with a document navigation. `set` always resolves, never navigates on an error, and\n * resolves `true` only when it started the navigation.\n */\nexport type LocaleActions = Readonly<{\n  /** Switches to the binding `bindingId` names. `true` once the navigation starts; `false` after logging. */\n  set: (payload: { bindingId: string }) => Promise<boolean>;\n}>;\n\n/**\n * The `locale` namespace hook. Reads the route at call time: `search` and `hash` come from\n * `location`, because `useStorefrontRoute().search` is `null` during hydration. The page name is\n * not sent: a layout has none, and the server derives the page from the path and params.\n */\nexport function useLocaleActions(): LocaleActions {\n  const switchBinding = useSwitchBinding();\n  const { params, path } = useStorefrontRoute();\n  const { bindingId: currentBindingId } = useStorefrontContext();\n\n  const set = useCallback<LocaleActions['set']>(\n    async ({ bindingId }) => {\n      if (!switchBinding) {\n        console.error('[locale.set] no BindingSwitchProvider');\n        return false;\n      }\n      try {\n        const { url } = await switchBinding({\n          bindingId,\n          currentBindingId,\n          params,\n          path,\n          search: globalThis.location.search,\n          hash: globalThis.location.hash,\n        });\n        if (url === null) {\n          console.error('[locale.set] no URL for the binding');\n          return false;\n        }\n        globalThis.location.assign(url);\n        return true;\n      } catch (error) {\n        console.error('[locale.set] switchBinding failed', loggableErrorName(error));\n        return false;\n      }\n    },\n    [switchBinding, currentBindingId, params, path],\n  );\n\n  return useMemo(() => ({ set }), [set]);\n}\n\n/**\n * Declares the `locale` action namespace. The native catalog builder reads this call to emit\n * `actions.json`; at runtime `LocaleActionProvider` calls `useLocaleActions` directly.\n */\nexport const localeActions = defineActions({\n  namespace: 'locale',\n  description:\n    'Switches the whole binding (locale, currency, sales channel) by a document navigation to the equivalent URL, or to the destination home with a notice.',\n  provider: { name: 'LocaleActionProvider', importPath: '@vtex/faststore/internal/client' },\n  methods: {\n    set: {\n      description:\n        'Switch to another binding: navigates to the equivalent URL of the current page, or to the destination home with fs_notice=no-equivalent.',\n      payload: [{ name: 'bindingId', type: 'string' }],\n    },\n  },\n  use: useLocaleActions,\n});\n"],"mappings":";;;;;;;;;;;;;;AAyBA,SAAgB,mBAAkC;CAChD,MAAM,gBAAgB,iBAAiB;CACvC,MAAM,EAAE,QAAQ,SAAS,mBAAmB;CAC5C,MAAM,EAAE,WAAW,qBAAqB,qBAAqB;CAE7D,MAAM,MAAM,YACV,OAAO,EAAE,gBAAgB;EACvB,IAAI,CAAC,eAAe;GAClB,QAAQ,MAAM,uCAAuC;GACrD,OAAO;EACT;EACA,IAAI;GACF,MAAM,EAAE,QAAQ,MAAM,cAAc;IAClC;IACA;IACA;IACA;IACA,QAAQ,WAAW,SAAS;IAC5B,MAAM,WAAW,SAAS;GAC5B,CAAC;GACD,IAAI,QAAQ,MAAM;IAChB,QAAQ,MAAM,qCAAqC;IACnD,OAAO;GACT;GACA,WAAW,SAAS,OAAO,GAAG;GAC9B,OAAO;EACT,SAAS,OAAO;GACd,QAAQ,MAAM,qCAAqC,kBAAkB,KAAK,CAAC;GAC3E,OAAO;EACT;CACF,GACA;EAAC;EAAe;EAAkB;EAAQ;CAAI,CAChD;CAEA,OAAO,eAAe,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC;AACvC;AAM6B,cAAc;CACzC,WAAW;CACX,aACE;CACF,UAAU;EAAE,MAAM;EAAwB,YAAY;CAAkC;CACxF,SAAS,EACP,KAAK;EACH,aACE;EACF,SAAS,CAAC;GAAE,MAAM;GAAa,MAAM;EAAS,CAAC;CACjD,EACF;CACA,KAAK;AACP,CAAC"}

package/dist/sdk/navigation/binding-switch.d.ts

@@ -0,0 +1,39 @@
+import { RouteMap } from "./types.js";
+import { AlternateBinding } from "../seo/page-alternates.js";
+import { ApolloClient } from "@apollo/client";
+//#region src/sdk/navigation/binding-switch.d.ts
+export type BindingSwitchRequest = {
+  /** Destination binding id. */
+  bindingId: string;
+  /** The binding the shopper is on. */
+  currentBindingId: string;
+  params: Record<string, string | string[]>;
+  /** Decoded logical path of the current page. */
+  path: string;
+  /** `location.search`: `''` or `'?…'`. */
+  search: string;
+  /** `location.hash`: `''` or `'#…'`. */
+  hash: string;
+};
+export type BindingSwitchResult = {
+  url: string | null;
+};
+export type ResolveBindingSwitchOptions = {
+  request: BindingSwitchRequest;
+  knownBindingId: (candidate: string | null | undefined) => string | null;
+  bindings: readonly AlternateBinding[];
+  routeMap: RouteMap;
+  buildUrl: (bindingId: string, logicalPath: string) => string;
+  clientFor: (bindingId: string) => ApolloClient;
+};
+/**
+ * The equivalent URL of the current page in the destination binding, or the destination's home with
+ * `fs_notice=no-equivalent` when none exists or the lookup fails. The page is the one route-map
+ * entry whose href in the current binding equals the logical path; none or several take the
+ * fallback. Every URL is built by `buildUrl` from an id `knownBindingId` accepted; an undeclared
+ * destination resolves `{ url: null }`. The request comes off the wire, so each field is read as
+ * unchecked. Never throws for an expected outcome, writes no cookie, and reads no request header.
+ */
+export declare function resolveBindingSwitch({ request, knownBindingId, bindings, routeMap, buildUrl, clientFor }: ResolveBindingSwitchOptions): Promise<BindingSwitchResult>;
+//#endregion
+//# sourceMappingURL=binding-switch.d.ts.map

package/dist/sdk/navigation/binding-switch.js

@@ -0,0 +1,129 @@
+import { resolveStorefrontHref } from "./resolve-storefront-href.js";
+import { CATALOG_ROUTE_ALTERNATES_QUERY, catalogClusterPaths, encodePath } from "../seo/page-alternates.js";
+import { decodeRouteParams } from "./decode-route-params.js";
+//#region src/sdk/navigation/binding-switch.ts
+/** Bounds the `catalogRoute` lookup: a slow API takes the no-equivalent fallback instead of stalling the switch. */
+const BINDING_SWITCH_LOOKUP_TIMEOUT_MS = 3e3;
+const CATALOG_STANDARDS = /* @__PURE__ */ new Set([
+	"product",
+	"category",
+	"brand",
+	"collection"
+]);
+const NO_EQUIVALENT_QUERY = "?fs_notice=no-equivalent";
+/**
+* The equivalent URL of the current page in the destination binding, or the destination's home with
+* `fs_notice=no-equivalent` when none exists or the lookup fails. The page is the one route-map
+* entry whose href in the current binding equals the logical path; none or several take the
+* fallback. Every URL is built by `buildUrl` from an id `knownBindingId` accepted; an undeclared
+* destination resolves `{ url: null }`. The request comes off the wire, so each field is read as
+* unchecked. Never throws for an expected outcome, writes no cookie, and reads no request header.
+*/
+async function resolveBindingSwitch({ request, knownBindingId, bindings, routeMap, buildUrl, clientFor }) {
+	const destination = knownBindingId(stringOr(request.bindingId, null));
+	if (destination === null) {
+		console.error("[locale.set] unknown binding");
+		return { url: null };
+	}
+	const fallback = { url: `${buildUrl(destination, "/")}${NO_EQUIVALENT_QUERY}` };
+	const path = stringOr(request.path, "");
+	const params = decodeRouteParams(paramsOf(request.params));
+	const page = pageMatchingPath(routeMap, stringOr(request.currentBindingId, ""), path, params);
+	const entry = page === void 0 ? void 0 : ownEntry(routeMap, page);
+	if (page === void 0 || entry === void 0) return fallback;
+	if (entry.bindings !== void 0 && !entry.bindings.includes(destination)) return fallback;
+	const tail = `${searchOf(request.search)}${hashOf(request.hash)}`;
+	if (entry.standard !== void 0 && CATALOG_STANDARDS.has(entry.standard)) {
+		const current = knownBindingId(stringOr(request.currentBindingId, null));
+		if (current === null || path === "" || path === "/") return fallback;
+		const paths = await catalogClusterPaths(bindings, async () => {
+			const { data, error } = await clientFor(current).query({
+				query: CATALOG_ROUTE_ALTERNATES_QUERY,
+				variables: { path },
+				errorPolicy: "all",
+				fetchPolicy: "no-cache",
+				context: { fetchOptions: { signal: AbortSignal.timeout(BINDING_SWITCH_LOOKUP_TIMEOUT_MS) } }
+			});
+			return {
+				data,
+				error
+			};
+		});
+		const variantPath = paths && Object.hasOwn(paths, destination) ? paths[destination] : void 0;
+		if (variantPath === void 0) return fallback;
+		return { url: `${buildUrl(destination, encodePath(variantPath))}${tail}` };
+	}
+	const { href } = resolveStorefrontHref({
+		bindingId: destination,
+		basePath: "/"
+	}, routeMap, {
+		page,
+		params
+	});
+	if (href === null) return fallback;
+	return { url: `${buildUrl(destination, href)}${tail}` };
+}
+function stringOr(value, empty) {
+	return typeof value === "string" ? value : empty;
+}
+function paramsOf(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value) ? value : {};
+}
+/**
+* The single page whose href in the current binding is this logical path. A miss and a tie are both
+* no page: the switch falls back instead of guessing. An entry that cannot be resolved (a missing
+* param, a binding it does not serve) is skipped.
+*/
+function pageMatchingPath(routeMap, bindingId, path, params) {
+	const matches = [];
+	for (const name of Object.keys(routeMap)) {
+		const { href } = resolveStorefrontHref({
+			bindingId,
+			basePath: "/"
+		}, routeMap, {
+			page: name,
+			params
+		});
+		if (href === null || !sameDecodedPath(href, path)) continue;
+		matches.push(name);
+	}
+	return matches.length === 1 ? matches[0] : void 0;
+}
+/**
+* `resolveStorefrontHref` percent-encodes params, so the href is decoded once. The request path is
+* compared as it arrived first, so a decoded slug like `100%-off` or `%41` is not decoded again; an
+* encoded path still matches through its decoded form.
+*/
+function sameDecodedPath(href, path) {
+	const decodedHref = decodeOrNull(href);
+	if (decodedHref === null) return false;
+	return decodedHref === path || decodedHref === decodeOrNull(path);
+}
+function decodeOrNull(text) {
+	try {
+		return decodeURIComponent(text);
+	} catch {
+		return null;
+	}
+}
+function ownEntry(routeMap, page) {
+	return Object.hasOwn(routeMap, page) ? routeMap[page] : void 0;
+}
+/** Kept verbatim when it is only a query: a leading `?`, no `#`, and no control character. */
+function searchOf(search) {
+	const text = stringOr(search, "");
+	if (text.length < 2 || !text.startsWith("?")) return "";
+	for (const char of text) {
+		const code = char.codePointAt(0) ?? 0;
+		if (char === "#" || code < 32 || code === 127) return "";
+	}
+	return text;
+}
+function hashOf(hash) {
+	const text = stringOr(hash, "");
+	return text.startsWith("#") && text.length > 1 ? text : "";
+}
+//#endregion
+export { resolveBindingSwitch };
+
+//# sourceMappingURL=binding-switch.js.map

package/dist/sdk/navigation/binding-switch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-switch.js","names":[],"sources":["../../../src/sdk/navigation/binding-switch.ts"],"sourcesContent":["import type { ApolloClient } from '@apollo/client';\nimport {\n  type AlternateBinding,\n  CATALOG_ROUTE_ALTERNATES_QUERY,\n  catalogClusterPaths,\n  encodePath,\n} from '../seo/page-alternates.js';\nimport { decodeRouteParams } from './decode-route-params.js';\nimport { resolveStorefrontHref } from './resolve-storefront-href.js';\nimport type { RouteMap, RouteMapEntry, StandardName } from './types.js';\n\n/** Bounds the `catalogRoute` lookup: a slow API takes the no-equivalent fallback instead of stalling the switch. */\nconst BINDING_SWITCH_LOOKUP_TIMEOUT_MS = 3_000;\n\nconst CATALOG_STANDARDS: ReadonlySet<StandardName> = new Set(['product', 'category', 'brand', 'collection']);\n\nconst NO_EQUIVALENT_QUERY = '?fs_notice=no-equivalent';\n\nexport type BindingSwitchRequest = {\n  /** Destination binding id. */\n  bindingId: string;\n  /** The binding the shopper is on. */\n  currentBindingId: string;\n  params: Record<string, string | string[]>;\n  /** Decoded logical path of the current page. */\n  path: string;\n  /** `location.search`: `''` or `'?…'`. */\n  search: string;\n  /** `location.hash`: `''` or `'#…'`. */\n  hash: string;\n};\n\nexport type BindingSwitchResult = { url: string | null };\n\nexport type ResolveBindingSwitchOptions = {\n  request: BindingSwitchRequest;\n  knownBindingId: (candidate: string | null | undefined) => string | null;\n  bindings: readonly AlternateBinding[];\n  routeMap: RouteMap;\n  buildUrl: (bindingId: string, logicalPath: string) => string;\n  clientFor: (bindingId: string) => ApolloClient;\n};\n\n/**\n * The equivalent URL of the current page in the destination binding, or the destination's home with\n * `fs_notice=no-equivalent` when none exists or the lookup fails. The page is the one route-map\n * entry whose href in the current binding equals the logical path; none or several take the\n * fallback. Every URL is built by `buildUrl` from an id `knownBindingId` accepted; an undeclared\n * destination resolves `{ url: null }`. The request comes off the wire, so each field is read as\n * unchecked. Never throws for an expected outcome, writes no cookie, and reads no request header.\n */\nexport async function resolveBindingSwitch({\n  request,\n  knownBindingId,\n  bindings,\n  routeMap,\n  buildUrl,\n  clientFor,\n}: ResolveBindingSwitchOptions): Promise<BindingSwitchResult> {\n  const destination = knownBindingId(stringOr(request.bindingId, null));\n  if (destination === null) {\n    console.error('[locale.set] unknown binding');\n    return { url: null };\n  }\n\n  const fallback = { url: `${buildUrl(destination, '/')}${NO_EQUIVALENT_QUERY}` };\n  const path = stringOr(request.path, '');\n  // `useParams()` hands the segments over percent-encoded; the route map fills patterns with decoded values.\n  const params = decodeRouteParams(paramsOf(request.params));\n  const page = pageMatchingPath(routeMap, stringOr(request.currentBindingId, ''), path, params);\n  const entry = page === undefined ? undefined : ownEntry(routeMap, page);\n  if (page === undefined || entry === undefined) return fallback;\n  if (entry.bindings !== undefined && !entry.bindings.includes(destination)) return fallback;\n\n  const tail = `${searchOf(request.search)}${hashOf(request.hash)}`;\n\n  if (entry.standard !== undefined && CATALOG_STANDARDS.has(entry.standard)) {\n    const current = knownBindingId(stringOr(request.currentBindingId, null));\n    if (current === null || path === '' || path === '/') return fallback;\n\n    const paths = await catalogClusterPaths(bindings, async () => {\n      const { data, error } = await clientFor(current).query({\n        query: CATALOG_ROUTE_ALTERNATES_QUERY,\n        variables: { path },\n        errorPolicy: 'all',\n        fetchPolicy: 'no-cache',\n        context: { fetchOptions: { signal: AbortSignal.timeout(BINDING_SWITCH_LOOKUP_TIMEOUT_MS) } },\n      });\n      return { data, error };\n    });\n    const variantPath = paths && Object.hasOwn(paths, destination) ? paths[destination] : undefined;\n    if (variantPath === undefined) return fallback;\n    return { url: `${buildUrl(destination, encodePath(variantPath))}${tail}` };\n  }\n\n  const { href } = resolveStorefrontHref({ bindingId: destination, basePath: '/' }, routeMap, { page, params });\n  if (href === null) return fallback;\n  return { url: `${buildUrl(destination, href)}${tail}` };\n}\n\nfunction stringOr<T extends string | null>(value: unknown, empty: T): string | T {\n  return typeof value === 'string' ? value : empty;\n}\n\nfunction paramsOf(value: unknown): BindingSwitchRequest['params'] {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n    ? (value as BindingSwitchRequest['params'])\n    : {};\n}\n\n/**\n * The single page whose href in the current binding is this logical path. A miss and a tie are both\n * no page: the switch falls back instead of guessing. An entry that cannot be resolved (a missing\n * param, a binding it does not serve) is skipped.\n */\nfunction pageMatchingPath(\n  routeMap: RouteMap,\n  bindingId: string,\n  path: string,\n  params: BindingSwitchRequest['params'],\n): string | undefined {\n  const matches: string[] = [];\n  for (const name of Object.keys(routeMap)) {\n    const { href } = resolveStorefrontHref({ bindingId, basePath: '/' }, routeMap, { page: name, params });\n    if (href === null || !sameDecodedPath(href, path)) continue;\n    matches.push(name);\n  }\n  return matches.length === 1 ? matches[0] : undefined;\n}\n\n/**\n * `resolveStorefrontHref` percent-encodes params, so the href is decoded once. The request path is\n * compared as it arrived first, so a decoded slug like `100%-off` or `%41` is not decoded again; an\n * encoded path still matches through its decoded form.\n */\nfunction sameDecodedPath(href: string, path: string): boolean {\n  const decodedHref = decodeOrNull(href);\n  if (decodedHref === null) return false;\n  return decodedHref === path || decodedHref === decodeOrNull(path);\n}\n\nfunction decodeOrNull(text: string): string | null {\n  try {\n    return decodeURIComponent(text);\n  } catch {\n    return null;\n  }\n}\n\nfunction ownEntry(routeMap: RouteMap, page: string): RouteMapEntry | undefined {\n  return Object.hasOwn(routeMap, page) ? routeMap[page] : undefined;\n}\n\n/** Kept verbatim when it is only a query: a leading `?`, no `#`, and no control character. */\nfunction searchOf(search: unknown): string {\n  const text = stringOr(search, '');\n  if (text.length < 2 || !text.startsWith('?')) return '';\n  for (const char of text) {\n    const code = char.codePointAt(0) ?? 0;\n    if (char === '#' || code < 0x20 || code === 0x7f) return '';\n  }\n  return text;\n}\n\nfunction hashOf(hash: unknown): string {\n  const text = stringOr(hash, '');\n  return text.startsWith('#') && text.length > 1 ? text : '';\n}\n"],"mappings":"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"}

package/dist/sdk/navigation/decode-route-params.d.ts

@@ -0,0 +1,11 @@
+//#region src/sdk/navigation/decode-route-params.d.ts
+type RouteParamValue = string | string[] | undefined;
+/**
+ * The route params a generated page receives, decoded: Next hands over a dynamic segment
+ * percent-encoded, so an id ending in `=` arrives as `%3D`. A value with a malformed sequence is kept
+ * as received, so a request can never turn into an exception. A list (catch-all) is decoded segment
+ * by segment, and the keys are unchanged.
+ */
+export declare function decodeRouteParams<T extends Record<string, RouteParamValue>>(params: T): T;
+//#endregion
+//# sourceMappingURL=decode-route-params.d.ts.map

package/dist/sdk/navigation/decode-route-params.js

@@ -0,0 +1,32 @@
+//#region src/sdk/navigation/decode-route-params.ts
+function decodeSegment(segment) {
+	try {
+		return decodeURIComponent(segment);
+	} catch {
+		return segment;
+	}
+}
+function decodeValue(value) {
+	if (value === void 0) return void 0;
+	return Array.isArray(value) ? value.map(decodeSegment) : decodeSegment(value);
+}
+/**
+* The route params a generated page receives, decoded: Next hands over a dynamic segment
+* percent-encoded, so an id ending in `=` arrives as `%3D`. A value with a malformed sequence is kept
+* as received, so a request can never turn into an exception. A list (catch-all) is decoded segment
+* by segment, and the keys are unchanged.
+*/
+function decodeRouteParams(params) {
+	const decoded = {};
+	for (const [key, value] of Object.entries(params)) Object.defineProperty(decoded, key, {
+		value: decodeValue(value),
+		enumerable: true,
+		writable: true,
+		configurable: true
+	});
+	return decoded;
+}
+//#endregion
+export { decodeRouteParams };
+
+//# sourceMappingURL=decode-route-params.js.map