@vtex/faststore 0.0.1

package/dist/graphql.js

@@ -0,0 +1,3 @@
+import { defineSubgraph } from "./graphql/define-subgraph.js";
+import { gql } from "./graphql/gql.js";
+export { defineSubgraph, gql };

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+import { ActionSelector } from "./core/dist/actions/registry.js";
+import { MockActions, mockAction } from "./core/dist/actions/mock-action.js";
+import { JsonValue, StorefrontContext } from "./core/dist/schema/generated/schema.js";
+import { ContentArraySchema, ContentNestedObjectShape, ContentObjectPropertySchema, ContentObjectSchema, ContentPropertySchema, ContentPropertyType, ContentScalarSchema, ContentScalarType, ContentTypeDefinition, ContentValue, defineContentType } from "./core/dist/define-content-type.js";
+import { ComponentDefinition, EditorMetadata, FetchStrategy, PropSchema, PropSchemaField, PropType, defineComponent } from "./core/dist/define-component.js";
+import "./core/dist/index.js";
+import { CartUserError } from "./sdk/cart/operations.js";
+import { AddItemPayload, CartActions, CartCouponPayload, CartLinePayload, CartLinesPayload, CartQuantityPayload } from "./sdk/cart/use-cart-actions.js";
+import { ClientPreferenceKey, ClientProfileUserError, CustomerProfileUserError } from "./sdk/identity/operations.js";
+import { ClientPreferencesUpdatePayload, ClientProfileUpdatePayload, CustomerProfileUpdatePayload, IdentityActions } from "./sdk/identity/use-identity-actions.js";
+import { RegionUserError } from "./sdk/region/region-operations.js";
+import { RegionActions } from "./sdk/region/use-region-actions.js";
+import { SessionAccessCodeRequestResult, SessionPasswordLoginPayload, SessionRequestAccessCodePayload, SessionUserError, SessionValidateAccessCodePayload } from "./sdk/session/auth-operations.js";
+import { SessionActions } from "./sdk/session/use-session-actions.js";
+import { ShippingOptionSelectUserError } from "./sdk/shipping/option-select-operations.js";
+import { ShippingAddressInput, ShippingAddressUpdateErrorEntity } from "./sdk/shipping/shipping-operations.js";
+import { ShippingActions } from "./sdk/shipping/use-shipping-actions.js";
+import { ComponentActions } from "./sdk/actions/types.js";
+export { type ActionSelector, type AddItemPayload, type CartActions, type CartCouponPayload, type CartLinePayload, type CartLinesPayload, type CartQuantityPayload, type CartUserError, type ClientPreferenceKey, type ClientPreferencesUpdatePayload, type ClientProfileUpdatePayload, type ClientProfileUserError, type ComponentActions, type ComponentDefinition, type ContentArraySchema, type ContentNestedObjectShape, type ContentObjectPropertySchema, type ContentObjectSchema, type ContentPropertySchema, type ContentPropertyType, type ContentScalarSchema, type ContentScalarType, type ContentTypeDefinition, type ContentValue, type CustomerProfileUpdatePayload, type CustomerProfileUserError, type EditorMetadata, type FetchStrategy, type IdentityActions, type JsonValue, type MockActions, type PropSchema, type PropSchemaField, type PropType, type RegionActions, type RegionUserError, type SessionAccessCodeRequestResult, type SessionActions, type SessionPasswordLoginPayload, type SessionRequestAccessCodePayload, type SessionUserError, type SessionValidateAccessCodePayload, type ShippingActions, type ShippingAddressInput, type ShippingAddressUpdateErrorEntity, type ShippingOptionSelectUserError, type StorefrontContext, defineComponent, defineContentType, mockAction };

package/dist/index.js

@@ -0,0 +1,5 @@
+import { mockAction } from "./core/dist/actions/mock-action.js";
+import { defineComponent } from "./core/dist/define-component.js";
+import { defineContentType } from "./core/dist/define-content-type.js";
+import "./core/dist/index.js";
+export { defineComponent, defineContentType, mockAction };

package/dist/internal/client.d.ts

@@ -0,0 +1,24 @@
+import { MessageId, Messages } from "../sdk/i18n/locales.js";
+import "../sdk/i18n/client.js";
+import { gql } from "../sdk/graphql-tag.js";
+import { CartActionProvider, CartActionProviderProps } from "../sdk/actions/cart-action-provider.js";
+import { IdentityActionProvider, IdentityActionProviderProps } from "../sdk/actions/identity-action-provider.js";
+import { RegionActionProvider, RegionActionProviderProps } from "../sdk/actions/region-action-provider.js";
+import { SessionActionProvider, SessionActionProviderProps } from "../sdk/actions/session-action-provider.js";
+import { ShippingActionProvider, ShippingActionProviderProps } from "../sdk/actions/shipping-action-provider.js";
+import "../sdk/actions/index.js";
+import { buildOptimisticDecrease, buildOptimisticIncrease, buildOptimisticRemove } from "../sdk/cart/optimistic.js";
+import { buildStorefrontContextHeaders } from "../sdk/context/headers.js";
+import { DataOverrideContext, useDataOverride } from "../sdk/data/data-override-context.js";
+import { HotDataProvider, HotDataProviderProps } from "../sdk/data/hot-data-provider.js";
+import { ListItemRef, ListItemRefContext, useListItemRef } from "../sdk/data/list-item-ref-context.js";
+import { MultipleReactiveDataProvider, MultipleReactiveDataProviderEntity, MultipleReactiveDataProviderProps } from "../sdk/data/multiple-reactive-data-provider.js";
+import { ClientVariablesMap, PageReactiveDataRoot, PageReactiveDataRootProps, ReactiveRootContext, ReactiveRootContextValue } from "../sdk/data/page-reactive-data-root.js";
+import { ReactiveDataProvider, ReactiveDataProviderProps } from "../sdk/data/reactive-data-provider.js";
+import { ReactiveListItemDataProvider, ReactiveListItemDataProviderProps } from "../sdk/data/reactive-list-item-data-provider.js";
+import "../sdk/data/index.js";
+import { StorefrontProvider, StorefrontProviderProps } from "../sdk/provider/storefront-provider.js";
+import "../sdk/provider/index.js";
+import { cartCouponErrorsVar, cartLastAddVar, cartUserErrorsVar, miniCartOpenVar, orderFormIdVar } from "../sdk/state/cart.js";
+import { SelectedVariant, publishedVariantIdFor, selectedVariantVar } from "../sdk/state/variant-selector.js";
+export { CartActionProvider, type CartActionProviderProps, type ClientVariablesMap, DataOverrideContext, HotDataProvider, type HotDataProviderProps, IdentityActionProvider, type IdentityActionProviderProps, type ListItemRef, ListItemRefContext, type MessageId, type Messages, MultipleReactiveDataProvider, type MultipleReactiveDataProviderEntity, type MultipleReactiveDataProviderProps, PageReactiveDataRoot, type PageReactiveDataRootProps, ReactiveDataProvider, type ReactiveDataProviderProps, ReactiveListItemDataProvider, type ReactiveListItemDataProviderProps, ReactiveRootContext, type ReactiveRootContextValue, RegionActionProvider, type RegionActionProviderProps, type SelectedVariant, SessionActionProvider, type SessionActionProviderProps, ShippingActionProvider, type ShippingActionProviderProps, StorefrontProvider, type StorefrontProviderProps, buildOptimisticDecrease, buildOptimisticIncrease, buildOptimisticRemove, buildStorefrontContextHeaders, cartCouponErrorsVar, cartLastAddVar, cartUserErrorsVar, gql, miniCartOpenVar, orderFormIdVar, publishedVariantIdFor, selectedVariantVar, useDataOverride, useListItemRef };

package/dist/internal/client.js

@@ -0,0 +1,23 @@
+import { gql } from "../sdk/graphql-tag.js";
+import { DataOverrideContext, useDataOverride } from "../sdk/data/data-override-context.js";
+import { HotDataProvider } from "../sdk/data/hot-data-provider.js";
+import { publishedVariantIdFor, selectedVariantVar } from "../sdk/state/variant-selector.js";
+import { cartCouponErrorsVar, cartLastAddVar, cartUserErrorsVar, miniCartOpenVar, orderFormIdVar } from "../sdk/state/cart.js";
+import { buildOptimisticDecrease, buildOptimisticIncrease, buildOptimisticRemove } from "../sdk/cart/optimistic.js";
+import { ListItemRefContext, useListItemRef } from "../sdk/data/list-item-ref-context.js";
+import { PageReactiveDataRoot, ReactiveRootContext } from "../sdk/data/page-reactive-data-root.js";
+import { CartActionProvider } from "../sdk/actions/cart-action-provider.js";
+import { IdentityActionProvider } from "../sdk/actions/identity-action-provider.js";
+import { RegionActionProvider } from "../sdk/actions/region-action-provider.js";
+import { SessionActionProvider } from "../sdk/actions/session-action-provider.js";
+import { ShippingActionProvider } from "../sdk/actions/shipping-action-provider.js";
+import "../sdk/actions/index.js";
+import { buildStorefrontContextHeaders } from "../sdk/context/headers.js";
+import { MultipleReactiveDataProvider } from "../sdk/data/multiple-reactive-data-provider.js";
+import { ReactiveDataProvider } from "../sdk/data/reactive-data-provider.js";
+import { ReactiveListItemDataProvider } from "../sdk/data/reactive-list-item-data-provider.js";
+import "../sdk/data/index.js";
+import { StorefrontProvider } from "../sdk/provider/storefront-provider.js";
+import "../sdk/provider/index.js";
+import "../sdk/state/index.js";
+export { CartActionProvider, DataOverrideContext, HotDataProvider, IdentityActionProvider, ListItemRefContext, MultipleReactiveDataProvider, PageReactiveDataRoot, ReactiveDataProvider, ReactiveListItemDataProvider, ReactiveRootContext, RegionActionProvider, SessionActionProvider, ShippingActionProvider, StorefrontProvider, buildOptimisticDecrease, buildOptimisticIncrease, buildOptimisticRemove, buildStorefrontContextHeaders, cartCouponErrorsVar, cartLastAddVar, cartUserErrorsVar, gql, miniCartOpenVar, orderFormIdVar, publishedVariantIdFor, selectedVariantVar, useDataOverride, useListItemRef };

package/dist/internal/content.d.ts

@@ -0,0 +1,2 @@
+import { ContentEntryBoundaryProps, ContentEntryResult, ContentRuntime, ContentRuntimeConfig, ContentSlices, ReadContentSlicesArgs, createContentRuntime } from "../sdk/content/create-content-runtime.js";
+export { type ContentEntryBoundaryProps, type ContentEntryResult, type ContentRuntime, type ContentRuntimeConfig, type ContentSlices, type ReadContentSlicesArgs, createContentRuntime };

package/dist/internal/content.js

@@ -0,0 +1,2 @@
+import { createContentRuntime } from "../sdk/content/create-content-runtime.js";
+export { createContentRuntime };

package/dist/internal/server.d.ts

@@ -0,0 +1,7 @@
+import { buildStorefrontContextHeaders } from "../sdk/context/headers.js";
+import { CreateClientOptions, createClient } from "../sdk/client/create-client.js";
+import { FetchPageDataOptions, FetchPageDataResult, fetchPageData } from "../sdk/client/fetch-page-data.js";
+import { PreloadQueryRegistry, RegisterPreloadQueryOptions, registerPreloadQuery } from "../sdk/client/register-preload-query.js";
+import { getIntl, loadMessages } from "../sdk/i18n/server.js";
+import { PreloadQueryProps } from "@apollo/client-integration-nextjs";
+export { type CreateClientOptions, type FetchPageDataOptions, type FetchPageDataResult, type PreloadQueryProps, type PreloadQueryRegistry, type RegisterPreloadQueryOptions, buildStorefrontContextHeaders, createClient, fetchPageData, getIntl, loadMessages, registerPreloadQuery };

package/dist/internal/server.js

@@ -0,0 +1,6 @@
+import { buildStorefrontContextHeaders } from "../sdk/context/headers.js";
+import { createClient } from "../sdk/client/create-client.js";
+import { fetchPageData } from "../sdk/client/fetch-page-data.js";
+import { registerPreloadQuery } from "../sdk/client/register-preload-query.js";
+import { getIntl, loadMessages } from "../sdk/i18n/server.js";
+export { buildStorefrontContextHeaders, createClient, fetchPageData, getIntl, loadMessages, registerPreloadQuery };

package/dist/matter/access-code-sign-in/access-code-sign-in.d.ts

@@ -0,0 +1,111 @@
+import { ComponentDefinition } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { ComponentActions } from "../../sdk/actions/types.js";
+import { ComponentPropsWithRef } from "react";
+//#region src/matter/access-code-sign-in/access-code-sign-in.d.ts
+/** Colocated fragment slice forwarded by the reactive runtime — `null` until both fields resolve. */
+export type AccessCodeSignInSlice = {
+  clientProfile: {
+    email: string | null;
+  } | null;
+  sessionAuthProviders: {
+    accessKeyAuthentication: boolean;
+  } | null;
+};
+export type AccessCodeSignInStep = 'request' | 'validate';
+export type AccessCodeSignInContextValue = Readonly<{
+  /** The shopper's locally-typed draft email — never written to the cart; only ever an argument to
+   * requestAccessCode/validateAccessCode. Pre-fills from `clientProfile.email` when known, but a
+   * shopper edit is never persisted anywhere by this family. */
+  email: string;
+  /** Updates the draft email; marks it as shopper-touched so pre-fill no longer overwrites it. */
+  setEmail: (email: string) => void;
+  step: AccessCodeSignInStep;
+  /** Opaque token round-tripped from requestAccessCode into validateAccessCode. */
+  authenticationToken: string | null;
+  /** Called by AccessCodeRequestControl on a successful requestAccessCode. */
+  startValidation: (authenticationToken: string) => void;
+}>;
+export type AccessCodeSignInRootProps = ComponentPropsWithRef<'div'> & {
+  $data?: AccessCodeSignInSlice | null;
+};
+export type AccessCodeEmailControlProps = ComponentPropsWithRef<'div'> & {
+  label?: string;
+  placeholder?: string;
+  invalidEmailMessage?: string;
+};
+export type AccessCodeRequestControlProps = ComponentPropsWithRef<'div'> & {
+  label?: string;
+  pendingLabel?: string;
+  sendLimitMessage?: string;
+  blockedMessage?: string;
+  networkErrorMessage?: string;
+  onRequested?: (authenticationToken: string) => void;
+  $actions?: ComponentActions;
+};
+export type AccessCodeValidateControlProps = ComponentPropsWithRef<'div'> & {
+  label?: string;
+  placeholder?: string;
+  submitLabel?: string;
+  codeLength?: number;
+  invalidCodeMessage?: string;
+  blockedMessage?: string;
+  missingAuthContextMessage?: string;
+  networkErrorMessage?: string;
+  onValidated?: () => void;
+  $actions?: ComponentActions;
+};
+export declare const AccessCodeSignInRootDefinition: ComponentDefinition<AccessCodeSignInRootProps>;
+export declare const AccessCodeEmailControlDefinition: ComponentDefinition<AccessCodeEmailControlProps>;
+export declare const AccessCodeRequestControlDefinition: ComponentDefinition<AccessCodeRequestControlProps>;
+export declare const AccessCodeValidateControlDefinition: ComponentDefinition<AccessCodeValidateControlProps>;
+/**
+ * Data-owning root of the access-code sign-in flow. Self-gates on two signals:
+ * `useSession().state !== 'loggedIn'` (available from anonymous through identified; hides once
+ * signed in) and `sessionAuthProviders.accessKeyAuthentication === true`. An unresolved fragment
+ * read (`$data` still `null`) is treated as "provider not enabled" — the flow stays hidden rather
+ * than flashing. Owns the `step`/`authenticationToken` stepper plus a locally-typed draft `email`
+ * as local state, broadcasting all of it through context to its children. The draft email pre-fills
+ * from `clientProfile.email` once (for an already-identified shopper) but a shopper edit is never
+ * persisted anywhere by this family — it is purely the requestAccessCode/validateAccessCode
+ * argument; the server sets clientProfileData.email as a side effect of a successful validate.
+ * Reacts automatically once `useSession()` flips to `loggedIn` — no manual unmount call anywhere in
+ * this family.
+ */
+export declare function AccessCodeSignInRoot({ $data: $dataProp, className, children, ...props }: AccessCodeSignInRootProps): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * The draft email input for the access-code flow. Renders only at the request step. Bound to the
+ * Root's local `email`/`setEmail` — never a fragment, never a mutation of its own; typing here
+ * never touches the cart. Format validation is `EmailField`'s own blur-triggered check (never
+ * per-keystroke); `invalidEmailMessage` is only its fallback text, mirroring how
+ * `EmailIdentificationControl` defers to the same particle for the same reason.
+ */
+export declare function AccessCodeEmailControl({ label, placeholder, invalidEmailMessage, className, ...props }: AccessCodeEmailControlProps): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * Renders only while the Root's stepper is at `step === 'request'`. Reads the draft email from
+ * context and dispatches `$actions.session.requestAccessCode({ email })` once it is a valid,
+ * non-empty address (no account-existence pre-check beyond that format gate). On a result with a
+ * non-null token and no `userErrors`, advances the Root's stepper. Every `userErrors` entry renders
+ * inline via a host-supplied, per-code message; the step never changes on error, so the shopper can
+ * retry or abandon the method and continue as a guest.
+ */
+export declare function AccessCodeRequestControl({ label, pendingLabel, sendLimitMessage, blockedMessage, networkErrorMessage, onRequested, $actions, className, ...props }: AccessCodeRequestControlProps): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * Renders only while the Root's stepper is at `step === 'validate'`. Composes `AccessCodeField` for
+ * the code value and a submit control, disabled below `codeLength` (a UX courtesy, never a
+ * validity claim). Dispatches `$actions.session.validateAccessCode` with the email and
+ * `authenticationToken` read from context. On a non-empty `userErrors` result, sets the field's
+ * `invalid`/`errorMessage` from a host-supplied per-code message and retains the code/token so the
+ * shopper can retry without re-requesting. On success it calls the optional `onValidated` and renders
+ * no local "success" UI — `useSession()` flipping to `loggedIn` is what makes the whole Root
+ * disappear.
+ */
+export declare function AccessCodeValidateControl({ label, placeholder, submitLabel, codeLength, invalidCodeMessage, blockedMessage, missingAuthContextMessage, networkErrorMessage, onValidated, $actions, className, ...props }: AccessCodeValidateControlProps): import("react/jsx-runtime").JSX.Element | null;
+export declare const AccessCodeSignIn: {
+  Root: typeof AccessCodeSignInRoot;
+  Email: typeof AccessCodeEmailControl;
+  Request: typeof AccessCodeRequestControl;
+  Validate: typeof AccessCodeValidateControl;
+};
+//#endregion
+//# sourceMappingURL=access-code-sign-in.d.ts.map

package/dist/matter/access-code-sign-in/access-code-sign-in.js

@@ -0,0 +1,387 @@
+"use client";
+import { defineComponent } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { AccessCodeField } from "../../particles/access-code-field/access-code-field.js";
+import { EmailField, isValidEmail } from "../../particles/email-field/email-field.js";
+import { useDataOverride } from "../../sdk/data/data-override-context.js";
+import { useSession } from "../session/session.js";
+import { createContext, useCallback, useContext, useEffect, useMemo, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/matter/access-code-sign-in/access-code-sign-in.tsx
+const fragment = `
+  fragment AccessCodeSignInData on Query {
+    clientProfile {
+      __typename
+      id
+      email
+    }
+    sessionAuthProviders {
+      accessKeyAuthentication
+    }
+  }
+`;
+const ACCESS_CODE_SIGN_IN_CONTEXT_UNSET = Symbol("AccessCodeSignInContextUnset");
+const AccessCodeSignInContext = createContext(ACCESS_CODE_SIGN_IN_CONTEXT_UNSET);
+/**
+* Read the stepper state (email, step, authenticationToken) from the nearest `AccessCodeSignInRoot`.
+* Throws when called outside that subtree — a misplaced control is a composition bug that should
+* surface immediately, mirroring `useShippingSimulator()`/`useSession()`.
+*/
+function useAccessCodeSignIn() {
+	const ctx = useContext(AccessCodeSignInContext);
+	if (ctx === ACCESS_CODE_SIGN_IN_CONTEXT_UNSET) throw new Error("AccessCodeSignIn components must be used inside AccessCodeSignInRoot.");
+	return ctx;
+}
+function requestErrorMessage(error, props) {
+	switch (error.code) {
+		case "ACCESS_CODE_SEND_LIMIT": return props.sendLimitMessage ?? error.message;
+		case "BLOCKED": return props.blockedMessage ?? error.message;
+		case "NETWORK_ERROR": return props.networkErrorMessage ?? error.message;
+		default: return error.message;
+	}
+}
+function validateErrorMessage(error, props) {
+	switch (error.code) {
+		case "INVALID_ACCESS_CODE": return props.invalidCodeMessage ?? error.message;
+		case "BLOCKED": return props.blockedMessage ?? error.message;
+		case "MISSING_AUTH_CONTEXT": return props.missingAuthContextMessage ?? error.message;
+		case "NETWORK_ERROR": return props.networkErrorMessage ?? error.message;
+		default: return error.message;
+	}
+}
+const AccessCodeSignInRootDefinition = defineComponent({
+	name: "AccessCodeSignInRoot",
+	importPath: "@vtex/faststore/components",
+	component: AccessCodeSignInRoot,
+	fragment,
+	fetchStrategy: "reactive",
+	requiresContext: "session",
+	editor: {
+		label: "Access Code Sign-In",
+		category: "identity"
+	},
+	schema: {},
+	guideline: "Self-gating root of the anonymous-or-identified, email + access-code sign-in: renders nothing once loggedIn or when the account disables accessKeyAuthentication, but is available from the anonymous state onward. Owns a locally-typed draft email (never written to the cart) and the request/validate stepper. Must be inside SessionRoot. See access-code-sign-in.md."
+});
+const AccessCodeEmailControlDefinition = defineComponent({
+	name: "AccessCodeEmailControl",
+	importPath: "@vtex/faststore/components",
+	component: AccessCodeEmailControl,
+	editor: {
+		label: "Access Code Email",
+		category: "identity"
+	},
+	schema: {
+		label: {
+			type: "string",
+			label: "Label"
+		},
+		placeholder: {
+			type: "string",
+			label: "Placeholder"
+		},
+		invalidEmailMessage: {
+			type: "string",
+			label: "Invalid email message"
+		}
+	},
+	guideline: "The draft email input for the access-code flow: visible only at the request step, pre-fills from clientProfile.email when known but never persists an edit anywhere — it is purely the argument requestAccessCode/validateAccessCode dispatch with. Must be inside AccessCodeSignInRoot. See access-code-sign-in.md."
+});
+const AccessCodeRequestControlDefinition = defineComponent({
+	name: "AccessCodeRequestControl",
+	importPath: "@vtex/faststore/components",
+	component: AccessCodeRequestControl,
+	actions: { session: ["requestAccessCode"] },
+	editor: {
+		label: "Access Code Request",
+		category: "identity"
+	},
+	schema: {
+		label: {
+			type: "string",
+			label: "Label"
+		},
+		sendLimitMessage: {
+			type: "string",
+			label: "Send-limit message"
+		},
+		blockedMessage: {
+			type: "string",
+			label: "Blocked message"
+		},
+		networkErrorMessage: {
+			type: "string",
+			label: "Network error message"
+		}
+	},
+	guideline: "Send-code step: disabled until the Root-owned draft email is a valid, non-empty address; dispatches $actions.session.requestAccessCode with it and advances the stepper on success. Failures render inline, never as a blocking error. Must be inside AccessCodeSignInRoot. See access-code-sign-in.md."
+});
+const AccessCodeValidateControlDefinition = defineComponent({
+	name: "AccessCodeValidateControl",
+	importPath: "@vtex/faststore/components",
+	component: AccessCodeValidateControl,
+	actions: { session: ["validateAccessCode"] },
+	editor: {
+		label: "Access Code Validate",
+		category: "identity"
+	},
+	schema: {
+		label: {
+			type: "string",
+			label: "Label"
+		},
+		placeholder: {
+			type: "string",
+			label: "Placeholder"
+		},
+		submitLabel: {
+			type: "string",
+			label: "Submit label"
+		},
+		codeLength: {
+			type: "number",
+			default: 6,
+			label: "Code length"
+		},
+		invalidCodeMessage: {
+			type: "string",
+			label: "Invalid code message"
+		},
+		blockedMessage: {
+			type: "string",
+			label: "Blocked message"
+		},
+		networkErrorMessage: {
+			type: "string",
+			label: "Network error message"
+		}
+	},
+	guideline: "Code-entry step: composes AccessCodeField and dispatches $actions.session.validateAccessCode with the Root-owned email and authenticationToken; a successful validate flips the session reactively and hides the Root. Must be inside AccessCodeSignInRoot. See access-code-sign-in.md."
+});
+/**
+* Data-owning root of the access-code sign-in flow. Self-gates on two signals:
+* `useSession().state !== 'loggedIn'` (available from anonymous through identified; hides once
+* signed in) and `sessionAuthProviders.accessKeyAuthentication === true`. An unresolved fragment
+* read (`$data` still `null`) is treated as "provider not enabled" — the flow stays hidden rather
+* than flashing. Owns the `step`/`authenticationToken` stepper plus a locally-typed draft `email`
+* as local state, broadcasting all of it through context to its children. The draft email pre-fills
+* from `clientProfile.email` once (for an already-identified shopper) but a shopper edit is never
+* persisted anywhere by this family — it is purely the requestAccessCode/validateAccessCode
+* argument; the server sets clientProfileData.email as a side effect of a successful validate.
+* Reacts automatically once `useSession()` flips to `loggedIn` — no manual unmount call anywhere in
+* this family.
+*/
+function AccessCodeSignInRoot({ $data: $dataProp, className, children, ...props }) {
+	const $data = useDataOverride($dataProp);
+	const { state } = useSession();
+	const [step, setStep] = useState("request");
+	const [authenticationToken, setAuthenticationToken] = useState(null);
+	const startValidation = useCallback((token) => {
+		setAuthenticationToken(token);
+		setStep("validate");
+	}, []);
+	const savedEmail = $data?.clientProfile?.email ?? "";
+	const [email, setEmailState] = useState("");
+	const [touched, setTouched] = useState(false);
+	useEffect(() => {
+		if (step === "request" && !touched) setEmailState(savedEmail);
+	}, [
+		savedEmail,
+		touched,
+		step
+	]);
+	const setEmail = useCallback((next) => {
+		setTouched(true);
+		setEmailState(next);
+	}, []);
+	const providerEnabled = $data?.sessionAuthProviders?.accessKeyAuthentication ?? false;
+	const contextValue = useMemo(() => ({
+		email,
+		setEmail,
+		step,
+		authenticationToken,
+		startValidation
+	}), [
+		email,
+		setEmail,
+		step,
+		authenticationToken,
+		startValidation
+	]);
+	if (!(state !== "loggedIn" && providerEnabled)) return null;
+	return /* @__PURE__ */ jsx(AccessCodeSignInContext, {
+		value: contextValue,
+		children: /* @__PURE__ */ jsx("div", {
+			...props,
+			className,
+			"data-fs-access-code-sign-in-root": "",
+			children
+		})
+	});
+}
+/**
+* The draft email input for the access-code flow. Renders only at the request step. Bound to the
+* Root's local `email`/`setEmail` — never a fragment, never a mutation of its own; typing here
+* never touches the cart. Format validation is `EmailField`'s own blur-triggered check (never
+* per-keystroke); `invalidEmailMessage` is only its fallback text, mirroring how
+* `EmailIdentificationControl` defers to the same particle for the same reason.
+*/
+function AccessCodeEmailControl({ label, placeholder, invalidEmailMessage, className, ...props }) {
+	const { step, email, setEmail } = useAccessCodeSignIn();
+	if (step !== "request") return null;
+	return /* @__PURE__ */ jsx("div", {
+		...props,
+		className,
+		"data-fs-access-code-email-control": "",
+		children: /* @__PURE__ */ jsx(EmailField, {
+			label,
+			placeholder,
+			value: email,
+			onValueChange: setEmail,
+			errorMessage: invalidEmailMessage
+		})
+	});
+}
+/**
+* Renders only while the Root's stepper is at `step === 'request'`. Reads the draft email from
+* context and dispatches `$actions.session.requestAccessCode({ email })` once it is a valid,
+* non-empty address (no account-existence pre-check beyond that format gate). On a result with a
+* non-null token and no `userErrors`, advances the Root's stepper. Every `userErrors` entry renders
+* inline via a host-supplied, per-code message; the step never changes on error, so the shopper can
+* retry or abandon the method and continue as a guest.
+*/
+function AccessCodeRequestControl({ label, pendingLabel, sendLimitMessage, blockedMessage, networkErrorMessage, onRequested, $actions, className, ...props }) {
+	const { step, email, startValidation } = useAccessCodeSignIn();
+	const [pending, setPending] = useState(false);
+	const [error, setError] = useState(null);
+	if (step !== "request") return null;
+	const canSubmit = !pending && isValidEmail(email);
+	async function handleClick() {
+		if (!canSubmit) return;
+		setPending(true);
+		setError(null);
+		try {
+			const result = await $actions?.session?.requestAccessCode?.({ email }) ?? {
+				authenticationToken: null,
+				userErrors: []
+			};
+			if (result.authenticationToken && result.userErrors.length === 0) {
+				startValidation(result.authenticationToken);
+				onRequested?.(result.authenticationToken);
+				return;
+			}
+			const [firstError] = result.userErrors;
+			if (firstError) setError(firstError);
+		} finally {
+			setPending(false);
+		}
+	}
+	const message = error ? requestErrorMessage(error, {
+		sendLimitMessage,
+		blockedMessage,
+		networkErrorMessage
+	}) : null;
+	return /* @__PURE__ */ jsxs("div", {
+		...props,
+		className,
+		"data-fs-access-code-request-control": "",
+		...pending ? { "data-fs-access-code-request-pending": "" } : {},
+		children: [/* @__PURE__ */ jsx("button", {
+			type: "button",
+			onClick: handleClick,
+			disabled: !canSubmit,
+			"aria-busy": pending || void 0,
+			"data-fs-access-code-request-submit": "",
+			"data-fs-button": "",
+			children: pending ? pendingLabel ?? label : label
+		}), message ? /* @__PURE__ */ jsx("div", {
+			role: "alert",
+			"data-fs-access-code-request-error": "",
+			children: message
+		}) : null]
+	});
+}
+/**
+* Renders only while the Root's stepper is at `step === 'validate'`. Composes `AccessCodeField` for
+* the code value and a submit control, disabled below `codeLength` (a UX courtesy, never a
+* validity claim). Dispatches `$actions.session.validateAccessCode` with the email and
+* `authenticationToken` read from context. On a non-empty `userErrors` result, sets the field's
+* `invalid`/`errorMessage` from a host-supplied per-code message and retains the code/token so the
+* shopper can retry without re-requesting. On success it calls the optional `onValidated` and renders
+* no local "success" UI — `useSession()` flipping to `loggedIn` is what makes the whole Root
+* disappear.
+*/
+function AccessCodeValidateControl({ label, placeholder, submitLabel, codeLength = 6, invalidCodeMessage, blockedMessage, missingAuthContextMessage, networkErrorMessage, onValidated, $actions, className, ...props }) {
+	const { step, email, authenticationToken } = useAccessCodeSignIn();
+	const [code, setCode] = useState("");
+	const [pending, setPending] = useState(false);
+	const [error, setError] = useState(null);
+	if (step !== "validate") return null;
+	const canSubmit = !pending && code.length >= codeLength && authenticationToken != null;
+	async function handleSubmit(event) {
+		event.preventDefault();
+		if (!canSubmit || authenticationToken == null) return;
+		setPending(true);
+		setError(null);
+		try {
+			const [firstError] = await $actions?.session?.validateAccessCode?.({
+				email,
+				accessCode: code,
+				authenticationToken
+			}) ?? [];
+			if (firstError) {
+				setError(firstError);
+				return;
+			}
+		} finally {
+			setPending(false);
+		}
+		onValidated?.();
+	}
+	function handleCodeChange(next) {
+		setCode(next);
+		if (error) setError(null);
+	}
+	const errorMessage = error ? validateErrorMessage(error, {
+		invalidCodeMessage,
+		blockedMessage,
+		missingAuthContextMessage,
+		networkErrorMessage
+	}) : void 0;
+	return /* @__PURE__ */ jsx("div", {
+		...props,
+		className,
+		"data-fs-access-code-validate-control": "",
+		...pending ? { "data-fs-access-code-validate-pending": "" } : {},
+		children: /* @__PURE__ */ jsxs("form", {
+			onSubmit: handleSubmit,
+			children: [/* @__PURE__ */ jsx(AccessCodeField, {
+				label,
+				placeholder,
+				value: code,
+				maxLength: codeLength,
+				onValueChange: handleCodeChange,
+				disabled: pending,
+				invalid: error != null,
+				errorMessage
+			}), /* @__PURE__ */ jsx("button", {
+				type: "submit",
+				disabled: !canSubmit,
+				"aria-busy": pending || void 0,
+				"data-fs-access-code-validate-submit": "",
+				"data-fs-button": "",
+				children: submitLabel
+			})]
+		})
+	});
+}
+const AccessCodeSignIn = {
+	Root: AccessCodeSignInRoot,
+	Email: AccessCodeEmailControl,
+	Request: AccessCodeRequestControl,
+	Validate: AccessCodeValidateControl
+};
+//#endregion
+export { AccessCodeEmailControl, AccessCodeEmailControlDefinition, AccessCodeRequestControl, AccessCodeRequestControlDefinition, AccessCodeSignIn, AccessCodeSignInRoot, AccessCodeSignInRootDefinition, AccessCodeValidateControl, AccessCodeValidateControlDefinition };
+
+//# sourceMappingURL=access-code-sign-in.js.map