@vtex/faststore 0.0.8 → 0.0.11

package/dist/sdk/i18n/format-error-code.js

@@ -0,0 +1,23 @@
+import { logMessageEvent } from "./message-formatter.js";
+import { ownValue } from "../../utils/own-value.js";
+//#region src/sdk/i18n/format-error-code.ts
+/**
+* Words an upstream error from the component's own `$content`: the message field `fields` names for its
+* `code`, or `fallbackField` for a code the map does not know (a newer server, or a code minted outside
+* the map). The error's own `message` is an English diagnostic, so it is never shown; an unknown code
+* logs `message.unknown-code` with the content type's id instead.
+*/
+function formatErrorCode(contentType, fields, error, format, fallbackField) {
+	const field = error.code == null ? void 0 : ownValue(fields, error.code);
+	if (field !== void 0) return format(field);
+	logMessageEvent("message.unknown-code", {
+		contentTypeId: contentType.id,
+		code: error.code ?? null,
+		field: fallbackField
+	});
+	return format(fallbackField);
+}
+//#endregion
+export { formatErrorCode };
+
+//# sourceMappingURL=format-error-code.js.map

package/dist/sdk/i18n/format-error-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-error-code.js","names":[],"sources":["../../../src/sdk/i18n/format-error-code.ts"],"sourcesContent":["import type { ContentTypeDefinition } from '@vtex/fs-core';\nimport { ownValue } from '../../utils/own-value.js';\nimport { logMessageEvent } from './message-formatter.js';\n\n/**\n * Words an upstream error from the component's own `$content`: the message field `fields` names for its\n * `code`, or `fallbackField` for a code the map does not know (a newer server, or a code minted outside\n * the map). The error's own `message` is an English diagnostic, so it is never shown; an unknown code\n * logs `message.unknown-code` with the content type's id instead.\n */\nexport function formatErrorCode<F extends string>(\n  contentType: Pick<ContentTypeDefinition, 'id'>,\n  fields: Readonly<Record<string, F>>,\n  error: { code?: string | null },\n  format: (field: F) => string,\n  fallbackField: NoInfer<F>,\n): string {\n  const field = error.code == null ? undefined : ownValue(fields, error.code);\n  if (field !== undefined) return format(field);\n  logMessageEvent('message.unknown-code', {\n    contentTypeId: contentType.id,\n    code: error.code ?? null,\n    field: fallbackField,\n  });\n  return format(fallbackField);\n}\n"],"mappings":";;;;;;;;;AAUA,SAAgB,gBACd,aACA,QACA,OACA,QACA,eACQ;CACR,MAAM,QAAQ,MAAM,QAAQ,OAAO,KAAA,IAAY,SAAS,QAAQ,MAAM,IAAI;CAC1E,IAAI,UAAU,KAAA,GAAW,OAAO,OAAO,KAAK;CAC5C,gBAAgB,wBAAwB;EACtC,eAAe,YAAY;EAC3B,MAAM,MAAM,QAAQ;EACpB,OAAO;CACT,CAAC;CACD,OAAO,OAAO,aAAa;AAC7B"}

package/dist/sdk/i18n/message-formatter.d.ts

@@ -0,0 +1,22 @@
+import { ContentTypeDefinition, ContentValue, MessageArguments, MessageFieldName, MessageTagName } from "../../core/dist/define-content-type.js";
+import "../../core/dist/index.js";
+import { ReactNode } from "react";
+//#region src/sdk/i18n/message-formatter.d.ts
+type MessageProperty<T extends ContentTypeDefinition, K> = K extends keyof T['schema']['properties'] ? T['schema']['properties'][K] : never;
+/** Optional when the message declares no arguments, required otherwise. */
+type ArgumentsParameter<P> = MessageArguments<P> extends Record<string, never> ? [args?: MessageArguments<P>] : [args: MessageArguments<P>];
+/** Formats the message fields of one component's `$content`, typed by their message contract. */
+export type MessageFormatter<T extends ContentTypeDefinition> = {
+  format<K extends MessageFieldName<T>>(field: K, ...args: ArgumentsParameter<MessageProperty<T, K>>): string;
+  rich<K extends MessageFieldName<T>>(field: K, args: MessageArguments<MessageProperty<T, K>>, tags: Record<MessageTagName<MessageProperty<T, K>>, (chunks: ReactNode[]) => ReactNode>): ReactNode;
+};
+/**
+ * The message formatter for a content type and its `$content`, in `locale`. Pure and side-neutral, so a
+ * Server Component formats without React context. Both methods are total: a missing message renders
+ * `''` and an invalid one renders the authored string, each logging an error (an optional message,
+ * `messageOptional`, renders `''` unwritten without logging). Without a locale (a
+ * Server Component rendered with no compiler-injected `$locale`) every message is invalid.
+ */
+export declare function createMessageFormatter<T extends ContentTypeDefinition>(locale: string | undefined, contentType: T, content: ContentValue<T> | undefined): MessageFormatter<T>;
+//#endregion
+//# sourceMappingURL=message-formatter.d.ts.map

package/dist/sdk/i18n/message-formatter.js

@@ -0,0 +1,140 @@
+import { Children, Fragment, createElement } from "react";
+import { TYPE, createNumberElement } from "@formatjs/icu-messageformat-parser";
+import { FormatError, IntlMessageFormat } from "intl-messageformat";
+//#region src/sdk/i18n/message-formatter.ts
+/**
+* The message formatter for a content type and its `$content`, in `locale`. Pure and side-neutral, so a
+* Server Component formats without React context. Both methods are total: a missing message renders
+* `''` and an invalid one renders the authored string, each logging an error (an optional message,
+* `messageOptional`, renders `''` unwritten without logging). Without a locale (a
+* Server Component rendered with no compiler-injected `$locale`) every message is invalid.
+*/
+function createMessageFormatter(locale, contentType, content) {
+	function resolve(field, values) {
+		const message = content?.[field];
+		const fields = {
+			contentTypeId: contentType.id,
+			field,
+			locale
+		};
+		if (typeof message !== "string" || message.trim() === "") {
+			if (!isOptionalMessage(contentType, field)) logMessageEvent("message.missing", {
+				...fields,
+				reason: typeof message === "string" ? "blank" : "absent"
+			});
+			return "";
+		}
+		if (!locale) {
+			logMessageEvent("message.invalid", {
+				...fields,
+				reason: "missing-locale"
+			});
+			return message;
+		}
+		try {
+			return formatIcu(locale, message, values);
+		} catch (error) {
+			logMessageEvent("message.invalid", {
+				...fields,
+				reason: invalidReason(error)
+			});
+			return message;
+		}
+	}
+	return {
+		format(field, ...[args]) {
+			return joinText(resolve(field, withoutPrototype(args)));
+		},
+		rich(field, args, tags) {
+			const values = withoutPrototype(args);
+			for (const [name, tag] of Object.entries(tags)) values[name] = (chunks) => tag(Children.toArray(chunks));
+			const result = resolve(field, values);
+			if (typeof result === "string") return result;
+			return createElement(Fragment, null, ...Array.isArray(result) ? result : [result]);
+		}
+	};
+}
+/**
+* `intl-messageformat` renders a plain argument as `String(value)`, and a name can be both a plural
+* selector and a plain argument in one message. So a plain argument holding a number is rewritten to
+* a `number` element, which formats with `Intl.NumberFormat` in `locale`, and selectors stay raw.
+*/
+function formatIcu(locale, message, values) {
+	return compiledMessage(locale, message, Object.keys(values).filter((name) => typeof values[name] === "number")).format(values);
+}
+/**
+* Parsing dominates a format call, and the same authored message renders on every row and every
+* render, so the compiled message is kept per locale and set of number arguments. Authored
+* copy is finite; the cap only guards against unbounded templates.
+*/
+const COMPILED_MESSAGES = /* @__PURE__ */ new Map();
+const COMPILED_MESSAGES_LIMIT = 1e3;
+function compiledMessage(locale, message, numberArguments) {
+	const key = [
+		locale,
+		numberArguments.join(","),
+		message
+	].join("\0");
+	const cached = COMPILED_MESSAGES.get(key);
+	if (cached) return cached;
+	const parsed = new IntlMessageFormat(message, locale);
+	const compiled = numberArguments.length === 0 ? parsed : new IntlMessageFormat(localizeNumberArguments(parsed.getAst(), new Set(numberArguments)), locale);
+	if (COMPILED_MESSAGES.size >= COMPILED_MESSAGES_LIMIT) COMPILED_MESSAGES.clear();
+	COMPILED_MESSAGES.set(key, compiled);
+	return compiled;
+}
+/**
+* The argument values in an object with no prototype, so a message argument named after an
+* `Object.prototype` member (`{toString}`, `{constructor}`) is a missing value, not an inherited one.
+*/
+function withoutPrototype(values) {
+	return Object.assign(Object.create(null), values);
+}
+/** Whether the content type declares `field` a message a store may leave unwritten. */
+function isOptionalMessage(contentType, field) {
+	return contentType.schema.properties[field]?.messageOptional === true;
+}
+/** Without tag functions every part is a string, and `intl-messageformat` joins them into one. */
+function joinText(result) {
+	return Array.isArray(result) ? result.join("") : result;
+}
+function localizeNumberArguments(elements, numberArguments) {
+	return elements.map((element) => {
+		switch (element.type) {
+			case TYPE.argument: return numberArguments.has(element.value) ? createNumberElement(element.value) : element;
+			case TYPE.plural:
+			case TYPE.select: return {
+				...element,
+				options: Object.fromEntries(Object.entries(element.options).map(([key, option]) => [key, {
+					...option,
+					value: localizeNumberArguments(option.value, numberArguments)
+				}]))
+			};
+			case TYPE.tag: return {
+				...element,
+				children: localizeNumberArguments(element.children, numberArguments)
+			};
+			default: return element;
+		}
+	});
+}
+/**
+* A code or kind name, never an error message: `InvalidValueError`'s message embeds the argument
+* value, which can carry shopper data.
+*/
+function invalidReason(error) {
+	if (error instanceof FormatError) return error.code;
+	if (error instanceof SyntaxError) return error.message;
+	return error instanceof Error ? error.name : "unknown";
+}
+/** One log line in every environment. Never the message text or an argument value. */
+function logMessageEvent(event, fields) {
+	console.error("[message]", {
+		...fields,
+		event
+	});
+}
+//#endregion
+export { createMessageFormatter, logMessageEvent };
+
+//# sourceMappingURL=message-formatter.js.map

package/dist/sdk/i18n/message-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-formatter.js","names":[],"sources":["../../../src/sdk/i18n/message-formatter.ts"],"sourcesContent":["import { createNumberElement, type MessageFormatElement, TYPE } from '@formatjs/icu-messageformat-parser';\nimport type {\n  ContentTypeDefinition,\n  ContentValue,\n  MessageArguments,\n  MessageFieldName,\n  MessageTagName,\n} from '@vtex/fs-core';\nimport { FormatError, type FormatXMLElementFn, IntlMessageFormat, type PrimitiveType } from 'intl-messageformat';\nimport { Children, createElement, Fragment, type ReactNode } from 'react';\n\ntype MessageProperty<T extends ContentTypeDefinition, K> = K extends keyof T['schema']['properties']\n  ? T['schema']['properties'][K]\n  : never;\n\n/** Optional when the message declares no arguments, required otherwise. */\ntype ArgumentsParameter<P> =\n  MessageArguments<P> extends Record<string, never> ? [args?: MessageArguments<P>] : [args: MessageArguments<P>];\n\n/** `R` is what a tag renders: `ReactNode` for rich messages, `string` when there are no tags. */\ntype MessageValues<R = ReactNode> = Record<string, PrimitiveType | R | FormatXMLElementFn<R>>;\n\ntype FormatResult<R> = string | R | (string | R)[];\n\ntype MessageEvent = 'message.missing' | 'message.invalid' | 'message.unknown-code';\n\n/** Formats the message fields of one component's `$content`, typed by their message contract. */\nexport type MessageFormatter<T extends ContentTypeDefinition> = {\n  format<K extends MessageFieldName<T>>(field: K, ...args: ArgumentsParameter<MessageProperty<T, K>>): string;\n  rich<K extends MessageFieldName<T>>(\n    field: K,\n    args: MessageArguments<MessageProperty<T, K>>,\n    tags: Record<MessageTagName<MessageProperty<T, K>>, (chunks: ReactNode[]) => ReactNode>,\n  ): ReactNode;\n};\n\n/**\n * The message formatter for a content type and its `$content`, in `locale`. Pure and side-neutral, so a\n * Server Component formats without React context. Both methods are total: a missing message renders\n * `''` and an invalid one renders the authored string, each logging an error (an optional message,\n * `messageOptional`, renders `''` unwritten without logging). Without a locale (a\n * Server Component rendered with no compiler-injected `$locale`) every message is invalid.\n */\nexport function createMessageFormatter<T extends ContentTypeDefinition>(\n  locale: string | undefined,\n  contentType: T,\n  content: ContentValue<T> | undefined,\n): MessageFormatter<T> {\n  function resolve<R>(field: string, values: MessageValues<R>): FormatResult<R> {\n    const message = (content as Record<string, unknown> | undefined)?.[field];\n    const fields = { contentTypeId: contentType.id, field, locale };\n    if (typeof message !== 'string' || message.trim() === '') {\n      if (!isOptionalMessage(contentType, field)) {\n        logMessageEvent('message.missing', { ...fields, reason: typeof message === 'string' ? 'blank' : 'absent' });\n      }\n      return '';\n    }\n    if (!locale) {\n      logMessageEvent('message.invalid', { ...fields, reason: 'missing-locale' });\n      return message;\n    }\n    try {\n      return formatIcu(locale, message, values);\n    } catch (error) {\n      logMessageEvent('message.invalid', { ...fields, reason: invalidReason(error) });\n      return message;\n    }\n  }\n\n  return {\n    format(field, ...[args]) {\n      return joinText(resolve<string>(field, withoutPrototype(args)));\n    },\n    rich(field, args, tags) {\n      const values: MessageValues = withoutPrototype(args);\n      for (const [name, tag] of Object.entries<(chunks: ReactNode[]) => ReactNode>(tags)) {\n        values[name] = (chunks: ReactNode[]) => tag(Children.toArray(chunks));\n      }\n      const result = resolve<ReactNode>(field, values);\n      if (typeof result === 'string') {\n        return result;\n      }\n      // Positional children, so React asks for no keys.\n      return createElement(Fragment, null, ...(Array.isArray(result) ? result : [result]));\n    },\n  };\n}\n\n/**\n * `intl-messageformat` renders a plain argument as `String(value)`, and a name can be both a plural\n * selector and a plain argument in one message. So a plain argument holding a number is rewritten to\n * a `number` element, which formats with `Intl.NumberFormat` in `locale`, and selectors stay raw.\n */\nfunction formatIcu<R>(locale: string, message: string, values: MessageValues<R>): FormatResult<R> {\n  const numberArguments = Object.keys(values).filter((name) => typeof values[name] === 'number');\n  return compiledMessage(locale, message, numberArguments).format<R>(values);\n}\n\n/**\n * Parsing dominates a format call, and the same authored message renders on every row and every\n * render, so the compiled message is kept per locale and set of number arguments. Authored\n * copy is finite; the cap only guards against unbounded templates.\n */\nconst COMPILED_MESSAGES = new Map<string, IntlMessageFormat>();\nconst COMPILED_MESSAGES_LIMIT = 1000;\n\nfunction compiledMessage(locale: string, message: string, numberArguments: readonly string[]): IntlMessageFormat {\n  const key = [locale, numberArguments.join(','), message].join('\\u0000');\n  const cached = COMPILED_MESSAGES.get(key);\n  if (cached) return cached;\n  const parsed = new IntlMessageFormat(message, locale);\n  const compiled =\n    numberArguments.length === 0\n      ? parsed\n      : new IntlMessageFormat(localizeNumberArguments(parsed.getAst(), new Set(numberArguments)), locale);\n  if (COMPILED_MESSAGES.size >= COMPILED_MESSAGES_LIMIT) COMPILED_MESSAGES.clear();\n  COMPILED_MESSAGES.set(key, compiled);\n  return compiled;\n}\n\n/**\n * The argument values in an object with no prototype, so a message argument named after an\n * `Object.prototype` member (`{toString}`, `{constructor}`) is a missing value, not an inherited one.\n */\nfunction withoutPrototype<V>(values: Readonly<Record<string, V>> | undefined): Record<string, V> {\n  return Object.assign(Object.create(null), values);\n}\n\n/** Whether the content type declares `field` a message a store may leave unwritten. */\nfunction isOptionalMessage(contentType: ContentTypeDefinition, field: string): boolean {\n  const property = (contentType.schema.properties as Record<string, { messageOptional?: boolean } | undefined>)[field];\n  return property?.messageOptional === true;\n}\n\n/** Without tag functions every part is a string, and `intl-messageformat` joins them into one. */\nfunction joinText(result: FormatResult<string>): string {\n  return Array.isArray(result) ? result.join('') : result;\n}\n\nfunction localizeNumberArguments(\n  elements: MessageFormatElement[],\n  numberArguments: ReadonlySet<string>,\n): MessageFormatElement[] {\n  return elements.map((element) => {\n    switch (element.type) {\n      case TYPE.argument:\n        return numberArguments.has(element.value) ? createNumberElement(element.value) : element;\n      case TYPE.plural:\n      case TYPE.select:\n        return {\n          ...element,\n          options: Object.fromEntries(\n            Object.entries(element.options).map(([key, option]) => [\n              key,\n              { ...option, value: localizeNumberArguments(option.value, numberArguments) },\n            ]),\n          ),\n        };\n      case TYPE.tag:\n        return { ...element, children: localizeNumberArguments(element.children, numberArguments) };\n      default:\n        return element;\n    }\n  });\n}\n\n/**\n * A code or kind name, never an error message: `InvalidValueError`'s message embeds the argument\n * value, which can carry shopper data.\n */\nfunction invalidReason(error: unknown): string {\n  if (error instanceof FormatError) return error.code;\n  // The parser throws a `SyntaxError` whose message is its `ErrorKind` name.\n  if (error instanceof SyntaxError) return error.message;\n  return error instanceof Error ? error.name : 'unknown';\n}\n\n/** One log line in every environment. Never the message text or an argument value. */\nexport function logMessageEvent(event: MessageEvent, fields: Record<string, unknown>): void {\n  // `event` spreads last so a `fields` key of the same name cannot displace the discriminator.\n  console.error('[message]', { ...fields, event });\n}\n"],"mappings":"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"}

package/dist/sdk/i18n/use-message-formatter.d.ts

@@ -0,0 +1,8 @@
+import { ContentTypeDefinition, ContentValue } from "../../core/dist/define-content-type.js";
+import "../../core/dist/index.js";
+import { MessageFormatter } from "./message-formatter.js";
+//#region src/sdk/i18n/use-message-formatter.d.ts
+/** The message formatter for a Client Component, in the locale `StorefrontProvider` published. */
+export declare function useMessageFormatter<T extends ContentTypeDefinition>(contentType: T, content: ContentValue<T> | undefined): MessageFormatter<T>;
+//#endregion
+//# sourceMappingURL=use-message-formatter.d.ts.map

package/dist/sdk/i18n/use-message-formatter.js

@@ -0,0 +1,18 @@
+"use client";
+import { useStorefrontContext } from "../context/storefront-context.js";
+import { createMessageFormatter } from "./message-formatter.js";
+import { useMemo } from "react";
+//#region src/sdk/i18n/use-message-formatter.ts
+/** The message formatter for a Client Component, in the locale `StorefrontProvider` published. */
+function useMessageFormatter(contentType, content) {
+	const { locale } = useStorefrontContext();
+	return useMemo(() => createMessageFormatter(locale, contentType, content), [
+		locale,
+		contentType,
+		content
+	]);
+}
+//#endregion
+export { useMessageFormatter };
+
+//# sourceMappingURL=use-message-formatter.js.map

package/dist/sdk/i18n/use-message-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-message-formatter.js","names":[],"sources":["../../../src/sdk/i18n/use-message-formatter.ts"],"sourcesContent":["'use client';\n\nimport type { ContentTypeDefinition, ContentValue } from '@vtex/fs-core';\nimport { useMemo } from 'react';\nimport { useStorefrontContext } from '../context/storefront-context.js';\nimport { createMessageFormatter, type MessageFormatter } from './message-formatter.js';\n\n/** The message formatter for a Client Component, in the locale `StorefrontProvider` published. */\nexport function useMessageFormatter<T extends ContentTypeDefinition>(\n  contentType: T,\n  content: ContentValue<T> | undefined,\n): MessageFormatter<T> {\n  const { locale } = useStorefrontContext();\n  return useMemo(() => createMessageFormatter(locale, contentType, content), [locale, contentType, content]);\n}\n"],"mappings":";;;;;;AAQA,SAAgB,oBACd,aACA,SACqB;CACrB,MAAM,EAAE,WAAW,qBAAqB;CACxC,OAAO,cAAc,uBAAuB,QAAQ,aAAa,OAAO,GAAG;EAAC;EAAQ;EAAa;CAAO,CAAC;AAC3G"}

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

@@ -1 +1 @@
-{"version":3,"file":"use-identity-actions.js","names":[],"sources":["../../../src/sdk/identity/use-identity-actions.ts"],"sourcesContent":["'use client';\n\nimport { CombinedGraphQLErrors } from '@apollo/client/errors';\nimport { useMutation } from '@apollo/client/react';\nimport { defineActions } from '@vtex/fs-core';\nimport { useCallback, useMemo } from 'react';\nimport { loggableErrorName } from '../../utils/loggable-error-name.js';\nimport {\n  CLIENT_PREFERENCES_UPDATE,\n  CLIENT_PROFILE_UPDATE,\n  type ClientPreferenceKey,\n  type ClientProfileUserError,\n  CUSTOMER_PROFILE_UPDATE,\n  type CustomerProfileUpdateInput,\n  type CustomerProfileUserError,\n} from './operations.js';\n\n/**\n * The `identity` action namespace — the context-free owner of the shopper-profile,\n * consent-preference, and persistent-profile writes\n * (specs/fspg-859-email-field.md, specs/consent-opt-in-component.md,\n * docs/storefront-core/reference-free-particle-model.md § Write side — actions,\n * docs/storefront-core/adr-0010-actions-own-the-write-side.md).\n *\n * It mirrors `useCartActions`: a component anywhere in the tree dispatches the write through the\n * compiler-injected `$actions.identity.*` prop, and the handler calls the corresponding mutation.\n * Every write is **async / pessimistic** (Decision 1): the caller awaits the persisted result. Each\n * call returns its `userErrors` (empty on success) so the caller can surface server-side failures\n * inline; the returned entity self-updates the normalized cache and every reactive subscriber.\n *\n * The first two writes target the cart's sibling identity entities; `customerProfileUpdate` targets\n * the shopper's account profile, which needs no cart at all.\n */\n\n/**\n * Payload for the profile write. Callers persist only the fields they own; other fields are\n * untouched. The payload is passed through to `ClientProfileUpdateInput` unmapped, so this type\n * mirrors that input verbatim — a stacked field only needs a field to already exist here to reach\n * the wire.\n */\nexport type ClientProfileUpdatePayload = Readonly<{\n  email?: string;\n  firstName?: string;\n  lastName?: string;\n  phone?: string;\n  document?: string;\n}>;\n\n/** Payload for the preferences write — one opt-in flag; the other flag is left untouched. */\nexport type ClientPreferencesUpdatePayload = Readonly<Partial<Record<ClientPreferenceKey, boolean>>>;\n\n/**\n * Payload for the persistent-profile write. Mirrors `CustomerProfileUpdateInput` verbatim and is\n * forwarded unmapped, so an omitted field stays untouched upstream and an empty string erases.\n */\nexport type CustomerProfileUpdatePayload = CustomerProfileUpdateInput;\n\nexport type IdentityActions = Readonly<{\n  /**\n   * Persist the provided profile fields (partial) to the active cart's `clientProfileData`.\n   * Async — awaits the mutation before resolving. Returns the resulting `userErrors` (empty on\n   * success).\n   */\n  clientProfileUpdate: (payload: ClientProfileUpdatePayload) => Promise<readonly ClientProfileUserError[]>;\n  /**\n   * Persist the provided consent opt-in flag(s) (partial) to the shopper's `ClientPreferences`\n   * entity (order-form-backed). Async — awaits the mutation before resolving. Writes ONLY the\n   * requested field. Returns the resulting `userErrors` (empty on success).\n   */\n  clientPreferencesUpdate: (payload: ClientPreferencesUpdatePayload) => Promise<readonly ClientProfileUserError[]>;\n  /**\n   * Persist the provided profile fields (partial) to the shopper's persistent, cart-independent\n   * account profile. Async — awaits the mutation before resolving. Sends exactly the fields it is\n   * given: an omitted field is left untouched, an empty string erases. Returns the resulting\n   * `userErrors` (empty on success).\n   */\n  customerProfileUpdate: (payload: CustomerProfileUpdatePayload) => Promise<readonly CustomerProfileUserError[]>;\n}>;\n\nconst NETWORK_PROFILE_ERROR: ClientProfileUserError = {\n  code: 'NETWORK_ERROR',\n  message: 'Unable to save your details. Please try again.',\n};\n\nconst NETWORK_PREFERENCE_ERROR: ClientProfileUserError = {\n  code: 'NETWORK_ERROR',\n  message: 'Unable to save your preference. Please try again.',\n};\n\nconst NETWORK_CUSTOMER_PROFILE_ERROR: CustomerProfileUserError = {\n  code: 'NETWORK_ERROR',\n  message: 'Unable to save your profile. Please try again.',\n};\n\nconst UNAUTHORIZED_CUSTOMER_PROFILE_ERROR: CustomerProfileUserError = {\n  code: 'UNAUTHORIZED',\n  message: 'Your session has expired. Please sign in again.',\n};\n\n/**\n * The profile write answers an anonymous or expired session with a top-level `UNAUTHORIZED`, never\n * a `userError` (the read answers an anonymous one with a null profile instead). Collapsing it into\n * `NETWORK_ERROR` would offer a retry that cannot succeed, so it gets its own code and the caller can\n * send the shopper back to sign-in.\n */\nfunction toCustomerProfileError(error: unknown): CustomerProfileUserError {\n  if (CombinedGraphQLErrors.is(error)) {\n    const unauthorized = error.errors.some(({ extensions }) => extensions?.code === 'UNAUTHORIZED');\n    if (unauthorized) return UNAUTHORIZED_CUSTOMER_PROFILE_ERROR;\n  }\n  return NETWORK_CUSTOMER_PROFILE_ERROR;\n}\n\n/**\n * The `identity` namespace hook. Registered with the first-party action registry via `identityActions`\n * below; the compiler-emitted `IdentityActionProvider` calls it and threads the narrowed methods into\n * each consumer's `$actions.identity`.\n */\nexport function useIdentityActions(): IdentityActions {\n  const [profileMutation] = useMutation(CLIENT_PROFILE_UPDATE);\n  const [preferencesMutation] = useMutation(CLIENT_PREFERENCES_UPDATE);\n  const [customerProfileMutation] = useMutation(CUSTOMER_PROFILE_UPDATE);\n\n  const clientProfileUpdate = useCallback<IdentityActions['clientProfileUpdate']>(\n    async (payload) => {\n      try {\n        const result = await profileMutation({ variables: { input: payload } });\n        return result.data?.clientProfileUpdate?.userErrors ?? [];\n      } catch (error) {\n        // Log only the error name — the message can echo the submitted email (PII).\n        console.error('[identity.clientProfileUpdate] clientProfileUpdate failed', loggableErrorName(error));\n        return [NETWORK_PROFILE_ERROR];\n      }\n    },\n    [profileMutation],\n  );\n\n  const clientPreferencesUpdate = useCallback<IdentityActions['clientPreferencesUpdate']>(\n    async (payload) => {\n      try {\n        const result = await preferencesMutation({ variables: { input: payload } });\n        return result.data?.clientPreferencesUpdate?.userErrors ?? [];\n      } catch (error) {\n        // Log only the error name — mirrors the profile write's PII-safe logging.\n        console.error('[identity.clientPreferencesUpdate] clientPreferencesUpdate failed', loggableErrorName(error));\n        return [NETWORK_PREFERENCE_ERROR];\n      }\n    },\n    [preferencesMutation],\n  );\n\n  const customerProfileUpdate = useCallback<IdentityActions['customerProfileUpdate']>(\n    async (payload) => {\n      try {\n        // Forwarded unmapped: an empty string is an explicit erase and must survive to the wire.\n        const result = await customerProfileMutation({ variables: { input: payload } });\n        return result.data?.customerProfileUpdate?.userErrors ?? [];\n      } catch (error) {\n        // Log only the error name — the message can echo a submitted profile value (PII).\n        console.error('[identity.customerProfileUpdate] customerProfileUpdate failed', loggableErrorName(error));\n        return [toCustomerProfileError(error)];\n      }\n    },\n    [customerProfileMutation],\n  );\n\n  return useMemo(\n    () => ({ clientProfileUpdate, clientPreferencesUpdate, customerProfileUpdate }),\n    [clientProfileUpdate, clientPreferencesUpdate, customerProfileUpdate],\n  );\n}\n\n/**\n * Declares the `identity` action namespace — the single source of truth for its method/payload\n * metadata, runtime provider, and `use` hook (mirrors `cartActions`). The native catalog builder\n * (`scripts/build-catalog.mjs`) statically reads this call to emit `actions.json`; at runtime\n * `IdentityActionProvider` calls `useIdentityActions` directly.\n */\nexport const identityActions = defineActions({\n  namespace: 'identity',\n  description:\n    'Mutation-backed writes against the shopper identity entities (client profile, consent preferences, account profile).',\n  provider: { name: 'IdentityActionProvider', importPath: '@vtex/faststore/internal/client' },\n  methods: {\n    clientProfileUpdate: {\n      description:\n        'Persist profile fields (partial) to the active cart (async strategy). Sending email flips Session.isIdentified.',\n      payload: [\n        { name: 'email', type: 'string', optional: true },\n        { name: 'firstName', type: 'string', optional: true },\n        { name: 'lastName', type: 'string', optional: true },\n        { name: 'phone', type: 'string', optional: true },\n        { name: 'document', type: 'string', optional: true },\n      ],\n    },\n    clientPreferencesUpdate: {\n      description:\n        'Persist consent opt-in flags (partial) to the active cart (async strategy). Writes only the provided flag(s).',\n      payload: [\n        { name: 'optinNewsLetter', type: 'boolean', optional: true },\n        { name: 'savePersonalData', type: 'boolean', optional: true },\n      ],\n    },\n    customerProfileUpdate: {\n      description:\n        'Persist profile fields (partial) to the persistent account profile, not the cart (async strategy). Omitted fields are untouched; an empty string erases.',\n      payload: [\n        { name: 'firstName', type: 'string', optional: true },\n        { name: 'lastName', type: 'string', optional: true },\n        { name: 'homePhone', type: 'string', optional: true },\n        { name: 'mobilePhone', type: 'string', optional: true },\n        { name: 'document', type: 'string', optional: true },\n        { name: 'documentType', type: 'string', optional: true },\n        { name: 'birthDate', type: 'string', optional: true },\n        { name: 'gender', type: 'string', optional: true },\n      ],\n    },\n  },\n  use: useIdentityActions,\n});\n"],"mappings":";;;;;;;;;AA+EA,MAAM,wBAAgD;CACpD,MAAM;CACN,SAAS;AACX;AAEA,MAAM,2BAAmD;CACvD,MAAM;CACN,SAAS;AACX;AAEA,MAAM,iCAA2D;CAC/D,MAAM;CACN,SAAS;AACX;AAEA,MAAM,sCAAgE;CACpE,MAAM;CACN,SAAS;AACX;;;;;;;AAQA,SAAS,uBAAuB,OAA0C;CACxE,IAAI,sBAAsB,GAAG,KAAK,GACX;MAAA,MAAM,OAAO,MAAM,EAAE,iBAAiB,YAAY,SAAS,cACjE,GAAG,OAAO;CAAA;CAE3B,OAAO;AACT;;;;;;AAOA,SAAgB,qBAAsC;CACpD,MAAM,CAAC,mBAAmB,YAAY,qBAAqB;CAC3D,MAAM,CAAC,uBAAuB,YAAY,yBAAyB;CACnE,MAAM,CAAC,2BAA2B,YAAY,uBAAuB;CAErE,MAAM,sBAAsB,YAC1B,OAAO,YAAY;EACjB,IAAI;GAEF,QAAO,MADc,gBAAgB,EAAE,WAAW,EAAE,OAAO,QAAQ,EAAE,CAAC,EAAA,CACxD,MAAM,qBAAqB,cAAc,CAAC;EAC1D,SAAS,OAAO;GAEd,QAAQ,MAAM,6DAA6D,kBAAkB,KAAK,CAAC;GACnG,OAAO,CAAC,qBAAqB;EAC/B;CACF,GACA,CAAC,eAAe,CAClB;CAEA,MAAM,0BAA0B,YAC9B,OAAO,YAAY;EACjB,IAAI;GAEF,QAAO,MADc,oBAAoB,EAAE,WAAW,EAAE,OAAO,QAAQ,EAAE,CAAC,EAAA,CAC5D,MAAM,yBAAyB,cAAc,CAAC;EAC9D,SAAS,OAAO;GAEd,QAAQ,MAAM,qEAAqE,kBAAkB,KAAK,CAAC;GAC3G,OAAO,CAAC,wBAAwB;EAClC;CACF,GACA,CAAC,mBAAmB,CACtB;CAEA,MAAM,wBAAwB,YAC5B,OAAO,YAAY;EACjB,IAAI;GAGF,QAAO,MADc,wBAAwB,EAAE,WAAW,EAAE,OAAO,QAAQ,EAAE,CAAC,EAAA,CAChE,MAAM,uBAAuB,cAAc,CAAC;EAC5D,SAAS,OAAO;GAEd,QAAQ,MAAM,iEAAiE,kBAAkB,KAAK,CAAC;GACvG,OAAO,CAAC,uBAAuB,KAAK,CAAC;EACvC;CACF,GACA,CAAC,uBAAuB,CAC1B;CAEA,OAAO,eACE;EAAE;EAAqB;EAAyB;CAAsB,IAC7E;EAAC;EAAqB;EAAyB;CAAqB,CACtE;AACF;AAQ+B,cAAc;CAC3C,WAAW;CACX,aACE;CACF,UAAU;EAAE,MAAM;EAA0B,YAAY;CAAkC;CAC1F,SAAS;EACP,qBAAqB;GACnB,aACE;GACF,SAAS;IACP;KAAE,MAAM;KAAS,MAAM;KAAU,UAAU;IAAK;IAChD;KAAE,MAAM;KAAa,MAAM;KAAU,UAAU;IAAK;IACpD;KAAE,MAAM;KAAY,MAAM;KAAU,UAAU;IAAK;IACnD;KAAE,MAAM;KAAS,MAAM;KAAU,UAAU;IAAK;IAChD;KAAE,MAAM;KAAY,MAAM;KAAU,UAAU;IAAK;GACrD;EACF;EACA,yBAAyB;GACvB,aACE;GACF,SAAS,CACP;IAAE,MAAM;IAAmB,MAAM;IAAW,UAAU;GAAK,GAC3D;IAAE,MAAM;IAAoB,MAAM;IAAW,UAAU;GAAK,CAC9D;EACF;EACA,uBAAuB;GACrB,aACE;GACF,SAAS;IACP;KAAE,MAAM;KAAa,MAAM;KAAU,UAAU;IAAK;IACpD;KAAE,MAAM;KAAY,MAAM;KAAU,UAAU;IAAK;IACnD;KAAE,MAAM;KAAa,MAAM;KAAU,UAAU;IAAK;IACpD;KAAE,MAAM;KAAe,MAAM;KAAU,UAAU;IAAK;IACtD;KAAE,MAAM;KAAY,MAAM;KAAU,UAAU;IAAK;IACnD;KAAE,MAAM;KAAgB,MAAM;KAAU,UAAU;IAAK;IACvD;KAAE,MAAM;KAAa,MAAM;KAAU,UAAU;IAAK;IACpD;KAAE,MAAM;KAAU,MAAM;KAAU,UAAU;IAAK;GACnD;EACF;CACF;CACA,KAAK;AACP,CAAC"}
+{"version":3,"file":"use-identity-actions.js","names":[],"sources":["../../../src/sdk/identity/use-identity-actions.ts"],"sourcesContent":["'use client';\n\nimport { CombinedGraphQLErrors } from '@apollo/client/errors';\nimport { useMutation } from '@apollo/client/react';\nimport { defineActions } from '@vtex/fs-core';\nimport { useCallback, useMemo } from 'react';\nimport { loggableErrorName } from '../../utils/loggable-error-name.js';\nimport {\n  CLIENT_PREFERENCES_UPDATE,\n  CLIENT_PROFILE_UPDATE,\n  type ClientPreferenceKey,\n  type ClientProfileUserError,\n  CUSTOMER_PROFILE_UPDATE,\n  type CustomerProfileUpdateInput,\n  type CustomerProfileUserError,\n} from './operations.js';\n\n/**\n * The `identity` action namespace — the context-free owner of the shopper-profile,\n * consent-preference, and persistent-profile writes\n * (specs/fspg-859-email-field.md, specs/consent-opt-in-component.md,\n * docs/storefront-core/reference-free-particle-model.md § Write side — actions,\n * docs/storefront-core/adr-0010-actions-own-the-write-side.md).\n *\n * It mirrors `useCartActions`: a component anywhere in the tree dispatches the write through the\n * compiler-injected `$actions.identity.*` prop, and the handler calls the corresponding mutation.\n * Every write is **async / pessimistic** (Decision 1): the caller awaits the persisted result. Each\n * call returns its `userErrors` (empty on success) so the caller can surface server-side failures\n * inline; the returned entity self-updates the normalized cache and every reactive subscriber.\n *\n * The first two writes target the cart's sibling identity entities; `customerProfileUpdate` targets\n * the shopper's account profile, which needs no cart at all.\n */\n\n/**\n * Payload for the profile write. Callers persist only the fields they own; other fields are\n * untouched. The payload is passed through to `ClientProfileUpdateInput` unmapped, so this type\n * mirrors that input verbatim — a stacked field only needs a field to already exist here to reach\n * the wire.\n */\nexport type ClientProfileUpdatePayload = Readonly<{\n  email?: string;\n  firstName?: string;\n  lastName?: string;\n  phone?: string;\n  document?: string;\n}>;\n\n/** Payload for the preferences write — one opt-in flag; the other flag is left untouched. */\nexport type ClientPreferencesUpdatePayload = Readonly<Partial<Record<ClientPreferenceKey, boolean>>>;\n\n/**\n * Payload for the persistent-profile write. Mirrors `CustomerProfileUpdateInput` verbatim and is\n * forwarded unmapped, so an omitted field stays untouched upstream and an empty string erases.\n */\nexport type CustomerProfileUpdatePayload = CustomerProfileUpdateInput;\n\nexport type IdentityActions = Readonly<{\n  /**\n   * Persist the provided profile fields (partial) to the active cart's `clientProfileData`.\n   * Async — awaits the mutation before resolving. Returns the resulting `userErrors` (empty on\n   * success).\n   */\n  clientProfileUpdate: (payload: ClientProfileUpdatePayload) => Promise<readonly ClientProfileUserError[]>;\n  /**\n   * Persist the provided consent opt-in flag(s) (partial) to the shopper's `ClientPreferences`\n   * entity (order-form-backed). Async — awaits the mutation before resolving. Writes ONLY the\n   * requested field. Returns the resulting `userErrors` (empty on success).\n   */\n  clientPreferencesUpdate: (payload: ClientPreferencesUpdatePayload) => Promise<readonly ClientProfileUserError[]>;\n  /**\n   * Persist the provided profile fields (partial) to the shopper's persistent, cart-independent\n   * account profile. Async — awaits the mutation before resolving. Sends exactly the fields it is\n   * given: an omitted field is left untouched, an empty string erases. Returns the resulting\n   * `userErrors` (empty on success).\n   */\n  customerProfileUpdate: (payload: CustomerProfileUpdatePayload) => Promise<readonly CustomerProfileUserError[]>;\n}>;\n\n// A diagnostic message: components word this code from their own `$content`.\nconst NETWORK_PROFILE_ERROR: ClientProfileUserError = {\n  code: 'NETWORK_ERROR',\n  message: 'Unable to save your details. Please try again.',\n};\n\n// A diagnostic message: components word this code from their own `$content`.\nconst NETWORK_PREFERENCE_ERROR: ClientProfileUserError = {\n  code: 'NETWORK_ERROR',\n  message: 'Unable to save your preference. Please try again.',\n};\n\n// A diagnostic message: components word this code from their own `$content`.\nconst NETWORK_CUSTOMER_PROFILE_ERROR: CustomerProfileUserError = {\n  code: 'NETWORK_ERROR',\n  message: 'Unable to save your profile. Please try again.',\n};\n\n// A diagnostic message: components word this code from their own `$content`.\nconst UNAUTHORIZED_CUSTOMER_PROFILE_ERROR: CustomerProfileUserError = {\n  code: 'UNAUTHORIZED',\n  message: 'Your session has expired. Please sign in again.',\n};\n\n/**\n * The profile write answers an anonymous or expired session with a top-level `UNAUTHORIZED`, never\n * a `userError` (the read answers an anonymous one with a null profile instead). Collapsing it into\n * `NETWORK_ERROR` would offer a retry that cannot succeed, so it gets its own code and the caller can\n * send the shopper back to sign-in.\n */\nfunction toCustomerProfileError(error: unknown): CustomerProfileUserError {\n  if (CombinedGraphQLErrors.is(error)) {\n    const unauthorized = error.errors.some(({ extensions }) => extensions?.code === 'UNAUTHORIZED');\n    if (unauthorized) return UNAUTHORIZED_CUSTOMER_PROFILE_ERROR;\n  }\n  return NETWORK_CUSTOMER_PROFILE_ERROR;\n}\n\n/**\n * The `identity` namespace hook. Registered with the first-party action registry via `identityActions`\n * below; the compiler-emitted `IdentityActionProvider` calls it and threads the narrowed methods into\n * each consumer's `$actions.identity`.\n */\nexport function useIdentityActions(): IdentityActions {\n  const [profileMutation] = useMutation(CLIENT_PROFILE_UPDATE);\n  const [preferencesMutation] = useMutation(CLIENT_PREFERENCES_UPDATE);\n  const [customerProfileMutation] = useMutation(CUSTOMER_PROFILE_UPDATE);\n\n  const clientProfileUpdate = useCallback<IdentityActions['clientProfileUpdate']>(\n    async (payload) => {\n      try {\n        const result = await profileMutation({ variables: { input: payload } });\n        return result.data?.clientProfileUpdate?.userErrors ?? [];\n      } catch (error) {\n        // Log only the error name — the message can echo the submitted email (PII).\n        console.error('[identity.clientProfileUpdate] clientProfileUpdate failed', loggableErrorName(error));\n        return [NETWORK_PROFILE_ERROR];\n      }\n    },\n    [profileMutation],\n  );\n\n  const clientPreferencesUpdate = useCallback<IdentityActions['clientPreferencesUpdate']>(\n    async (payload) => {\n      try {\n        const result = await preferencesMutation({ variables: { input: payload } });\n        return result.data?.clientPreferencesUpdate?.userErrors ?? [];\n      } catch (error) {\n        // Log only the error name — mirrors the profile write's PII-safe logging.\n        console.error('[identity.clientPreferencesUpdate] clientPreferencesUpdate failed', loggableErrorName(error));\n        return [NETWORK_PREFERENCE_ERROR];\n      }\n    },\n    [preferencesMutation],\n  );\n\n  const customerProfileUpdate = useCallback<IdentityActions['customerProfileUpdate']>(\n    async (payload) => {\n      try {\n        // Forwarded unmapped: an empty string is an explicit erase and must survive to the wire.\n        const result = await customerProfileMutation({ variables: { input: payload } });\n        return result.data?.customerProfileUpdate?.userErrors ?? [];\n      } catch (error) {\n        // Log only the error name — the message can echo a submitted profile value (PII).\n        console.error('[identity.customerProfileUpdate] customerProfileUpdate failed', loggableErrorName(error));\n        return [toCustomerProfileError(error)];\n      }\n    },\n    [customerProfileMutation],\n  );\n\n  return useMemo(\n    () => ({ clientProfileUpdate, clientPreferencesUpdate, customerProfileUpdate }),\n    [clientProfileUpdate, clientPreferencesUpdate, customerProfileUpdate],\n  );\n}\n\n/**\n * Declares the `identity` action namespace — the single source of truth for its method/payload\n * metadata, runtime provider, and `use` hook (mirrors `cartActions`). The native catalog builder\n * (`scripts/build-catalog.mjs`) statically reads this call to emit `actions.json`; at runtime\n * `IdentityActionProvider` calls `useIdentityActions` directly.\n */\nexport const identityActions = defineActions({\n  namespace: 'identity',\n  description:\n    'Mutation-backed writes against the shopper identity entities (client profile, consent preferences, account profile).',\n  provider: { name: 'IdentityActionProvider', importPath: '@vtex/faststore/internal/client' },\n  methods: {\n    clientProfileUpdate: {\n      description:\n        'Persist profile fields (partial) to the active cart (async strategy). Sending email flips Session.isIdentified.',\n      payload: [\n        { name: 'email', type: 'string', optional: true },\n        { name: 'firstName', type: 'string', optional: true },\n        { name: 'lastName', type: 'string', optional: true },\n        { name: 'phone', type: 'string', optional: true },\n        { name: 'document', type: 'string', optional: true },\n      ],\n    },\n    clientPreferencesUpdate: {\n      description:\n        'Persist consent opt-in flags (partial) to the active cart (async strategy). Writes only the provided flag(s).',\n      payload: [\n        { name: 'optinNewsLetter', type: 'boolean', optional: true },\n        { name: 'savePersonalData', type: 'boolean', optional: true },\n      ],\n    },\n    customerProfileUpdate: {\n      description:\n        'Persist profile fields (partial) to the persistent account profile, not the cart (async strategy). Omitted fields are untouched; an empty string erases.',\n      payload: [\n        { name: 'firstName', type: 'string', optional: true },\n        { name: 'lastName', type: 'string', optional: true },\n        { name: 'homePhone', type: 'string', optional: true },\n        { name: 'mobilePhone', type: 'string', optional: true },\n        { name: 'document', type: 'string', optional: true },\n        { name: 'documentType', type: 'string', optional: true },\n        { name: 'birthDate', type: 'string', optional: true },\n        { name: 'gender', type: 'string', optional: true },\n      ],\n    },\n  },\n  use: useIdentityActions,\n});\n"],"mappings":"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"}

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