@vtex/faststore 0.0.6 → 0.0.8

package/dist/sdk/data/page-reactive-data-root.js.map

@@ -1 +1 @@
-{"version":3,"file":"page-reactive-data-root.js","names":[],"sources":["../../../src/sdk/data/page-reactive-data-root.tsx"],"sourcesContent":["'use client';\n\nimport type { ErrorLike, OperationVariables, ReactiveVar, TypedDocumentNode } from '@apollo/client';\nimport { useApolloClient, useQuery } from '@apollo/client/react';\nimport { type DocumentNode, Kind, type OperationDefinitionNode } from 'graphql';\nimport { createContext, type ReactNode, useCallback, useEffect, useMemo, useRef, useSyncExternalStore } from 'react';\n\n// Reactive vars resolvable by name from a Server Component. Functions cannot cross the\n// Server→Client boundary in RSC, so the compiler emits string keys and this component resolves\n// them at runtime. New reactive vars must be registered here to be addressable from generated\n// pages. Currently empty: cart context travels on the transport, so no cart entry is needed\n// (docs/storefront-core/reference-cart.md § Cart context).\nconst REACTIVE_VAR_REGISTRY: Record<string, ReactiveVar<unknown>> = {};\n\n/**\n * Compile-time-stable map keyed by the operation's variable names. Each value is either an Apollo\n * reactive variable (`makeVar`) or the string name of one registered in REACTIVE_VAR_REGISTRY —\n * Server Components must pass strings because functions cannot cross the RSC boundary. Vars that\n * have not yet resolved should hold `null`; the runtime treats both `null` and `undefined` as\n * \"not yet ready\" and keeps `useQuery` skipped.\n */\nexport type ClientVariablesMap<TVars> = Partial<{\n  [K in keyof TVars]: ReactiveVar<TVars[K] | null> | string;\n}>;\n\nfunction resolveReactiveVar(value: ReactiveVar<unknown> | string): ReactiveVar<unknown> | undefined {\n  if (typeof value === 'function') return value;\n  const resolved = REACTIVE_VAR_REGISTRY[value];\n  if (!resolved) {\n    throw new Error(\n      `PageReactiveDataRoot: clientVariables entry \"${value}\" is not registered. Add it to REACTIVE_VAR_REGISTRY in page-reactive-data-root.tsx.`,\n    );\n  }\n  return resolved;\n}\n\nexport type PageReactiveDataRootProps<TData, TVars extends OperationVariables> = Readonly<{\n  /** The composed PAGE_QUERY operation document. */\n  query: TypedDocumentNode<TData, TVars>;\n  /** Variables the server used when calling fetchPageData. Only used to seed the client cache. */\n  serverVariables?: TVars;\n  /** Server-rendered PAGE_QUERY result. When present and shape-matched, seeded into the cache once. */\n  initialData?: TData | null;\n  /** Reactive vars whose current values are merged into operation variables at render time. */\n  clientVariables?: ClientVariablesMap<TVars>;\n  children: ReactNode;\n}>;\n\nexport type ReactiveRootContextValue<TData = unknown> = Readonly<{\n  /** Current root query data exposed to descendant `ReactiveDataProvider`s. */\n  rootQueryData: TData | undefined;\n  /** Whether the underlying useQuery is currently in flight. */\n  loading: boolean;\n  /** False when at least one required variable has not been provided yet. */\n  hasAllRequiredVariables: boolean;\n  /**\n   * Error from the underlying useQuery. With non-null root fields (e.g. `cart: Cart!`), a failed\n   * fetch nulls the whole operation's `data` — descendants need this to tell \"fetch failed\" apart\n   * from \"entity is legitimately absent\" (docs/storefront-core/reference-free-particle-model.md § Read side — data).\n   */\n  error: ErrorLike | undefined;\n  /**\n   * True only under a real `PageReactiveDataRoot`. Every other field above is ambiguous between\n   * \"no root at all\" and \"a root with nothing to give right now\" — `rootQueryData: undefined` and\n   * `loading: false` describe both the context default and a root whose query is skipped for want\n   * of a reactive variable. `useReactiveEntity` needs that distinction to tell a placeholder slice\n   * apart from the only slice there is.\n   *\n   * Required, not optional, and deliberately so. This flag is the whole of what arms the gate in\n   * `useReactiveEntity`, so a provider that omits it disarms the gate silently — measured: a value\n   * that `satisfies ReactiveRootContextValue` without it reproduces the corrupting payload byte for\n   * byte on an otherwise-fixed tree, and no test fails. `ReactiveRootContext` is public surface via\n   * `sdk/data/index.ts`, so that provider need not live in this repo. Making it required moves that\n   * failure to compile time.\n   *\n   * A hand-built context value stands in for a root's *output*, not for the reactive runtime, so it\n   * declares `false` and its subtree keeps gating on nothing.\n   */\n  hasRoot: boolean;\n}>;\n\nexport const ReactiveRootContext = createContext<ReactiveRootContextValue>({\n  rootQueryData: undefined,\n  loading: false,\n  hasAllRequiredVariables: false,\n  error: undefined,\n  hasRoot: false,\n});\n\nfunction getOperationDefinition(query: DocumentNode): OperationDefinitionNode | undefined {\n  for (const definition of query.definitions) {\n    if (definition.kind === Kind.OPERATION_DEFINITION) return definition;\n  }\n  return undefined;\n}\n\nfunction getRequiredVariableNames(query: DocumentNode): string[] {\n  const op = getOperationDefinition(query);\n  if (!op?.variableDefinitions) return [];\n  const required: string[] = [];\n  for (const def of op.variableDefinitions) {\n    if (def.type.kind === Kind.NON_NULL_TYPE && def.defaultValue === undefined) {\n      required.push(def.variable.name.value);\n    }\n  }\n  return required;\n}\n\nfunction getTopLevelFieldNames(query: DocumentNode): Set<string> {\n  const op = getOperationDefinition(query);\n  const names = new Set<string>();\n  if (!op) return names;\n  for (const sel of op.selectionSet.selections) {\n    if (sel.kind === Kind.FIELD) {\n      names.add((sel.alias ?? sel.name).value);\n    }\n  }\n  return names;\n}\n\nfunction shapeMatches(query: DocumentNode, data: unknown): boolean {\n  if (data == null || typeof data !== 'object') return false;\n  const expected = getTopLevelFieldNames(query);\n  if (expected.size === 0) return false;\n  const actual = data as Record<string, unknown>;\n  // Require AT LEAST ONE top-level field name to be present in `data`. The operation's full\n  // top-level shape may include fields the server did not return; partial seeds still help. A total\n  // miss (no overlap at all) signals a shape mismatch and we skip the seed.\n  for (const key of expected) {\n    if (key in actual) return true;\n  }\n  return false;\n}\n\n/**\n * Reads the current values of every reactive var in `clientVariables` into a plain object via a\n * single `useSyncExternalStore` call (no hooks-in-loop). Apollo's `ReactiveVar.onNextChange` fires\n * once per registration, so the subscriber re-attaches after each notification to stay listening.\n */\nfunction useClientVariableValues<TVars>(clientVariables: ClientVariablesMap<TVars> | undefined): Partial<TVars> {\n  // Keep the latest map identity reachable from inside subscribe()/getSnapshot() without forcing\n  // useSyncExternalStore to tear down the underlying subscription.\n  const varsRef = useRef(clientVariables);\n  // react-doctor-disable-next-line no-ref-current-in-render -- keeps the latest map reachable from the stable subscribe()/getSnapshot() callbacks below\n  varsRef.current = clientVariables;\n\n  const subscribe = useCallback((notify: () => void): (() => void) => {\n    const cv = varsRef.current;\n    if (!cv) return () => {};\n\n    const activeUnsubs: Array<() => void> = [];\n    let cancelled = false;\n\n    const attach = (rv: ReactiveVar<unknown>): void => {\n      if (cancelled) return;\n      const unsub = rv.onNextChange(() => {\n        notify();\n        // onNextChange fires only once — re-attach to keep listening for subsequent changes.\n        attach(rv);\n      });\n      activeUnsubs.push(unsub);\n    };\n\n    for (const rv of Object.values(cv)) {\n      if (rv === undefined || rv === null) continue;\n      const resolved = resolveReactiveVar(rv as ReactiveVar<unknown> | string);\n      if (resolved) attach(resolved);\n    }\n\n    return () => {\n      cancelled = true;\n      for (const u of activeUnsubs) u();\n    };\n  }, []);\n\n  const lastSnapshotRef = useRef<{ json: string; value: Record<string, unknown> } | null>(null);\n\n  const getSnapshot = (): string => {\n    const cv = varsRef.current;\n    const snap: Record<string, unknown> = {};\n    if (cv) {\n      for (const [key, reactiveVar] of Object.entries(cv)) {\n        if (reactiveVar === undefined || reactiveVar === null) continue;\n        const resolved = resolveReactiveVar(reactiveVar as ReactiveVar<unknown> | string);\n        if (!resolved) continue;\n        const value = resolved();\n        if (value !== null && value !== undefined) snap[key] = value;\n      }\n    }\n    const json = JSON.stringify(snap);\n    // useSyncExternalStore expects a stable snapshot reference until the value changes (Object.is\n    // identity check) — return the cached `json` whenever the contents are unchanged.\n    if (lastSnapshotRef.current && lastSnapshotRef.current.json === json) {\n      return lastSnapshotRef.current.json;\n    }\n    lastSnapshotRef.current = { json, value: snap };\n    return json;\n  };\n\n  useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n\n  return (lastSnapshotRef.current?.value ?? {}) as Partial<TVars>;\n}\n\nexport function PageReactiveDataRoot<TData = unknown, TVars extends OperationVariables = OperationVariables>(\n  props: PageReactiveDataRootProps<TData, TVars>,\n): ReactNode {\n  const { query, serverVariables, initialData, clientVariables, children } = props;\n  const client = useApolloClient();\n  const seededRef = useRef(false);\n\n  const clientValues = useClientVariableValues<TVars>(clientVariables);\n  const mergedVariables = { ...(serverVariables ?? ({} as TVars)), ...clientValues } as TVars;\n\n  const requiredNames = getRequiredVariableNames(query);\n  const mergedRecord = mergedVariables as Record<string, unknown>;\n  const hasAllRequiredVariables = requiredNames.every((name) => {\n    const v = mergedRecord[name];\n    return v !== null && v !== undefined;\n  });\n\n  // Ref- and shape-guarded one-time cache seed from server props. We use `useEffect` (not\n  // `useLayoutEffect`) to avoid the SSR-pass warning emitted by React 19 — the resulting \"first\n  // render shows fallbackData, second render shows cache slice\" behaviour is acceptable because\n  // initialData is the same value `ReactiveDataProvider` falls back to anyway.\n  useEffect(() => {\n    if (seededRef.current) return;\n    if (!serverVariables || initialData == null) return;\n    if (!shapeMatches(query, initialData)) return;\n    client.cache.writeQuery({ query, variables: serverVariables, data: initialData });\n    seededRef.current = true;\n  }, [client, query, serverVariables, initialData]);\n\n  const { data, loading, error } = useQuery(query, {\n    variables: mergedVariables,\n    fetchPolicy: 'cache-first',\n    skip: !hasAllRequiredVariables,\n  });\n\n  const contextValue: ReactiveRootContextValue<TData> = useMemo(\n    () => ({\n      rootQueryData: (data ?? undefined) as TData | undefined,\n      loading,\n      hasAllRequiredVariables,\n      error,\n      hasRoot: true,\n    }),\n    [data, loading, hasAllRequiredVariables, error],\n  );\n\n  return (\n    <ReactiveRootContext.Provider value={contextValue as ReactiveRootContextValue}>\n      {children}\n    </ReactiveRootContext.Provider>\n  );\n}\n"],"mappings":";;;;;;AAYA,MAAM,wBAA8D,CAAC;AAarE,SAAS,mBAAmB,OAAwE;CAClG,IAAI,OAAO,UAAU,YAAY,OAAO;CACxC,MAAM,WAAW,sBAAsB;CACvC,IAAI,CAAC,UACH,MAAM,IAAI,MACR,gDAAgD,MAAM,qFACxD;CAEF,OAAO;AACT;AA+CA,MAAa,sBAAsB,cAAwC;CACzE,eAAe,KAAA;CACf,SAAS;CACT,yBAAyB;CACzB,OAAO,KAAA;CACP,SAAS;AACX,CAAC;AAED,SAAS,uBAAuB,OAA0D;CACxF,KAAK,MAAM,cAAc,MAAM,aAC7B,IAAI,WAAW,SAAS,KAAK,sBAAsB,OAAO;AAG9D;AAEA,SAAS,yBAAyB,OAA+B;CAC/D,MAAM,KAAK,uBAAuB,KAAK;CACvC,IAAI,CAAC,IAAI,qBAAqB,OAAO,CAAC;CACtC,MAAM,WAAqB,CAAC;CAC5B,KAAK,MAAM,OAAO,GAAG,qBACnB,IAAI,IAAI,KAAK,SAAS,KAAK,iBAAiB,IAAI,iBAAiB,KAAA,GAC/D,SAAS,KAAK,IAAI,SAAS,KAAK,KAAK;CAGzC,OAAO;AACT;AAEA,SAAS,sBAAsB,OAAkC;CAC/D,MAAM,KAAK,uBAAuB,KAAK;CACvC,MAAM,wBAAQ,IAAI,IAAY;CAC9B,IAAI,CAAC,IAAI,OAAO;CAChB,KAAK,MAAM,OAAO,GAAG,aAAa,YAChC,IAAI,IAAI,SAAS,KAAK,OACpB,MAAM,KAAK,IAAI,SAAS,IAAI,KAAA,CAAM,KAAK;CAG3C,OAAO;AACT;AAEA,SAAS,aAAa,OAAqB,MAAwB;CACjE,IAAI,QAAQ,QAAQ,OAAO,SAAS,UAAU,OAAO;CACrD,MAAM,WAAW,sBAAsB,KAAK;CAC5C,IAAI,SAAS,SAAS,GAAG,OAAO;CAChC,MAAM,SAAS;CAIf,KAAK,MAAM,OAAO,UAChB,IAAI,OAAO,QAAQ,OAAO;CAE5B,OAAO;AACT;;;;;;AAOA,SAAS,wBAA+B,iBAAwE;CAG9G,MAAM,UAAU,OAAO,eAAe;CAEtC,QAAQ,UAAU;CAElB,MAAM,YAAY,aAAa,WAAqC;EAClE,MAAM,KAAK,QAAQ;EACnB,IAAI,CAAC,IAAI,aAAa,CAAC;EAEvB,MAAM,eAAkC,CAAC;EACzC,IAAI,YAAY;EAEhB,MAAM,UAAU,OAAmC;GACjD,IAAI,WAAW;GACf,MAAM,QAAQ,GAAG,mBAAmB;IAClC,OAAO;IAEP,OAAO,EAAE;GACX,CAAC;GACD,aAAa,KAAK,KAAK;EACzB;EAEA,KAAK,MAAM,MAAM,OAAO,OAAO,EAAE,GAAG;GAClC,IAAI,OAAO,KAAA,KAAa,OAAO,MAAM;GACrC,MAAM,WAAW,mBAAmB,EAAmC;GACvE,IAAI,UAAU,OAAO,QAAQ;EAC/B;EAEA,aAAa;GACX,YAAY;GACZ,KAAK,MAAM,KAAK,cAAc,EAAE;EAClC;CACF,GAAG,CAAC,CAAC;CAEL,MAAM,kBAAkB,OAAgE,IAAI;CAE5F,MAAM,oBAA4B;EAChC,MAAM,KAAK,QAAQ;EACnB,MAAM,OAAgC,CAAC;EACvC,IAAI,IACF,KAAK,MAAM,CAAC,KAAK,gBAAgB,OAAO,QAAQ,EAAE,GAAG;GACnD,IAAI,gBAAgB,KAAA,KAAa,gBAAgB,MAAM;GACvD,MAAM,WAAW,mBAAmB,WAA4C;GAChF,IAAI,CAAC,UAAU;GACf,MAAM,QAAQ,SAAS;GACvB,IAAI,UAAU,QAAQ,UAAU,KAAA,GAAW,KAAK,OAAO;EACzD;EAEF,MAAM,OAAO,KAAK,UAAU,IAAI;EAGhC,IAAI,gBAAgB,WAAW,gBAAgB,QAAQ,SAAS,MAC9D,OAAO,gBAAgB,QAAQ;EAEjC,gBAAgB,UAAU;GAAE;GAAM,OAAO;EAAK;EAC9C,OAAO;CACT;CAEA,qBAAqB,WAAW,aAAa,WAAW;CAExD,OAAQ,gBAAgB,SAAS,SAAS,CAAC;AAC7C;AAEA,SAAgB,qBACd,OACW;CACX,MAAM,EAAE,OAAO,iBAAiB,aAAa,iBAAiB,aAAa;CAC3E,MAAM,SAAS,gBAAgB;CAC/B,MAAM,YAAY,OAAO,KAAK;CAE9B,MAAM,eAAe,wBAA+B,eAAe;CACnE,MAAM,kBAAkB;EAAE,GAAI,mBAAoB,CAAC;EAAc,GAAG;CAAa;CAEjF,MAAM,gBAAgB,yBAAyB,KAAK;CACpD,MAAM,eAAe;CACrB,MAAM,0BAA0B,cAAc,OAAO,SAAS;EAC5D,MAAM,IAAI,aAAa;EACvB,OAAO,MAAM,QAAQ,MAAM,KAAA;CAC7B,CAAC;CAMD,gBAAgB;EACd,IAAI,UAAU,SAAS;EACvB,IAAI,CAAC,mBAAmB,eAAe,MAAM;EAC7C,IAAI,CAAC,aAAa,OAAO,WAAW,GAAG;EACvC,OAAO,MAAM,WAAW;GAAE;GAAO,WAAW;GAAiB,MAAM;EAAY,CAAC;EAChF,UAAU,UAAU;CACtB,GAAG;EAAC;EAAQ;EAAO;EAAiB;CAAW,CAAC;CAEhD,MAAM,EAAE,MAAM,SAAS,UAAU,SAAS,OAAO;EAC/C,WAAW;EACX,aAAa;EACb,MAAM,CAAC;CACT,CAAC;CAED,MAAM,eAAgD,eAC7C;EACL,eAAgB,QAAQ,KAAA;EACxB;EACA;EACA;EACA,SAAS;CACX,IACA;EAAC;EAAM;EAAS;EAAyB;CAAK,CAChD;CAEA,OACE,oBAAC,oBAAoB,UAArB;EAA8B,OAAO;EAClC;CAC2B,CAAA;AAElC"}
+{"version":3,"file":"page-reactive-data-root.js","names":[],"sources":["../../../src/sdk/data/page-reactive-data-root.tsx"],"sourcesContent":["'use client';\n\nimport type {\n  ErrorLike,\n  OperationVariables,\n  ReactiveVar,\n  TypedDocumentNode,\n  WatchQueryFetchPolicy,\n} from '@apollo/client';\nimport { useApolloClient, useQuery } from '@apollo/client/react';\nimport { canonicalStringify } from '@apollo/client/utilities';\nimport { type DocumentNode, Kind, type OperationDefinitionNode } from 'graphql';\nimport {\n  createContext,\n  type ReactNode,\n  useCallback,\n  useEffect,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useState,\n  useSyncExternalStore,\n} from 'react';\nimport { loggableErrorName } from '../../utils/loggable-error-name.js';\nimport { getFailedFields } from './failed-fields.js';\n\n// Reactive vars resolvable by name from a Server Component. Functions cannot cross the\n// Server→Client boundary in RSC, so the compiler emits string keys and this component resolves\n// them at runtime. New reactive vars must be registered here to be addressable from generated\n// pages. Currently empty: cart context travels on the transport, so no cart entry is needed\n// (docs/storefront-core/reference-cart.md § Cart context).\nconst REACTIVE_VAR_REGISTRY: Record<string, ReactiveVar<unknown>> = {};\n\n/**\n * Compile-time-stable map keyed by the operation's variable names. Each value is either an Apollo\n * reactive variable (`makeVar`) or the string name of one registered in REACTIVE_VAR_REGISTRY —\n * Server Components must pass strings because functions cannot cross the RSC boundary. Vars that\n * have not yet resolved should hold `null`; the runtime treats both `null` and `undefined` as\n * \"not yet ready\" and keeps `useQuery` skipped.\n */\nexport type ClientVariablesMap<TVars> = Partial<{\n  [K in keyof TVars]: ReactiveVar<TVars[K] | null> | string;\n}>;\n\nfunction resolveReactiveVar(value: ReactiveVar<unknown> | string): ReactiveVar<unknown> | undefined {\n  if (typeof value === 'function') return value;\n  const resolved = REACTIVE_VAR_REGISTRY[value];\n  if (!resolved) {\n    throw new Error(\n      `PageReactiveDataRoot: clientVariables entry \"${value}\" is not registered. Add it to REACTIVE_VAR_REGISTRY in page-reactive-data-root.tsx.`,\n    );\n  }\n  return resolved;\n}\n\nexport type PageReactiveDataRootProps<TData, TVars extends OperationVariables> = Readonly<{\n  /** The composed PAGE_QUERY operation document. */\n  query: TypedDocumentNode<TData, TVars>;\n  /** Variables the server used when calling fetchPageData. Only used to seed the client cache. */\n  serverVariables?: TVars;\n  /** Server-rendered PAGE_QUERY result. When present and shape-matched, seeded into the cache once. */\n  initialData?: TData | null;\n  /**\n   * Root fields that failed on the server. Non-empty: `initialData` is not seeded and the first read\n   * for these `serverVariables` is `network-only`. Read on mount and when `serverVariables` change;\n   * a change to `failedFields` alone, with the same variables, sends nothing.\n   */\n  failedFields?: readonly string[];\n  /** Reactive vars whose current values are merged into operation variables at render time. */\n  clientVariables?: ClientVariablesMap<TVars>;\n  children: ReactNode;\n}>;\n\nexport type ReactiveRootContextValue<TData = unknown> = Readonly<{\n  /** Current root query data exposed to descendant `ReactiveDataProvider`s. */\n  rootQueryData: TData | undefined;\n  /** Whether the underlying useQuery is currently in flight. */\n  loading: boolean;\n  /** False when at least one required variable has not been provided yet. */\n  hasAllRequiredVariables: boolean;\n  /**\n   * Error from the underlying useQuery. With non-null root fields (e.g. `cart: Cart!`), a failed\n   * fetch nulls the whole operation's `data` — descendants need this to tell \"fetch failed\" apart\n   * from \"entity is legitimately absent\" (docs/storefront-core/reference-free-particle-model.md § Read side — data).\n   * A nullable root field that failed on the server reaches here too: the root skips the seed and\n   * asks again, and this carries the browser's error beside the partial data.\n   */\n  error: ErrorLike | undefined;\n  /**\n   * True only under a real `PageReactiveDataRoot`. Every other field above is ambiguous between\n   * \"no root at all\" and \"a root with nothing to give right now\" — `rootQueryData: undefined` and\n   * `loading: false` describe both the context default and a root whose query is skipped for want\n   * of a reactive variable. `useReactiveEntity` needs that distinction to tell a placeholder slice\n   * apart from the only slice there is.\n   *\n   * Required, not optional, and deliberately so. This flag is the whole of what arms the gate in\n   * `useReactiveEntity`, so a provider that omits it disarms the gate silently — measured: a value\n   * that `satisfies ReactiveRootContextValue` without it reproduces the corrupting payload byte for\n   * byte on an otherwise-fixed tree, and no test fails. `ReactiveRootContext` ships through the\n   * package's `./internal/client` entry, so that provider need not live in this repo. Making it\n   * required moves that failure to compile time.\n   *\n   * A hand-built context value stands in for a root's *output*, not for the reactive runtime, so it\n   * declares `false` and its subtree keeps gating on nothing.\n   */\n  hasRoot: boolean;\n  /**\n   * Re-runs the page query against the network with the root's current variables, the ones its\n   * latest render passed to `useQuery`, so a caller that changes a reactive variable calls it from an\n   * effect, not in the same handler. Sends nothing unless the root's last committed render had every\n   * required variable, nor after the root unmounted. Never rejects: a failure of the read arrives on\n   * `rootQueryData`, `loading`, and `error`, as it does on a first load, a cancelled refetch is\n   * silent, and any other failure is logged by its name and swallowed.\n   *\n   * Optional, unlike `hasRoot`: a provider that omits it only loses the in-place retry, where a\n   * provider that omits `hasRoot` corrupts what `useReactiveEntity` builds. `PageReactiveDataRoot`\n   * always sets it, but a provider built outside this repo may not, and a caller then falls back to\n   * reloading the page.\n   */\n  refetch?: () => Promise<void>;\n}>;\n\nexport const ReactiveRootContext = createContext<ReactiveRootContextValue>({\n  rootQueryData: undefined,\n  loading: false,\n  hasAllRequiredVariables: false,\n  error: undefined,\n  hasRoot: false,\n});\n\nfunction getOperationDefinition(query: DocumentNode): OperationDefinitionNode | undefined {\n  for (const definition of query.definitions) {\n    if (definition.kind === Kind.OPERATION_DEFINITION) return definition;\n  }\n  return undefined;\n}\n\nfunction getRequiredVariableNames(query: DocumentNode): string[] {\n  const op = getOperationDefinition(query);\n  if (!op?.variableDefinitions) return [];\n  const required: string[] = [];\n  for (const def of op.variableDefinitions) {\n    if (def.type.kind === Kind.NON_NULL_TYPE && def.defaultValue === undefined) {\n      required.push(def.variable.name.value);\n    }\n  }\n  return required;\n}\n\nfunction getTopLevelFieldNames(query: DocumentNode): Set<string> {\n  const op = getOperationDefinition(query);\n  const names = new Set<string>();\n  if (!op) return names;\n  for (const sel of op.selectionSet.selections) {\n    if (sel.kind === Kind.FIELD) {\n      names.add((sel.alias ?? sel.name).value);\n    }\n  }\n  return names;\n}\n\nfunction stillShowsFailure(data: unknown, error: ErrorLike): boolean {\n  return data == null || getFailedFields(data, error).length > 0;\n}\n\nfunction withEntry(\n  errors: ReadonlyMap<string, ErrorLike>,\n  key: string,\n  error: ErrorLike | undefined,\n): ReadonlyMap<string, ErrorLike> {\n  if (errors.get(key) === error) return errors;\n  const next = new Map(errors);\n  if (error) next.set(key, error);\n  else next.delete(key);\n  return next;\n}\n\nfunction shapeMatches(query: DocumentNode, data: unknown): boolean {\n  if (data == null || typeof data !== 'object') return false;\n  const expected = getTopLevelFieldNames(query);\n  if (expected.size === 0) return false;\n  const actual = data as Record<string, unknown>;\n  // Require AT LEAST ONE top-level field name to be present in `data`. The operation's full\n  // top-level shape may include fields the server did not return; partial seeds still help. A total\n  // miss (no overlap at all) signals a shape mismatch and we skip the seed.\n  for (const key of expected) {\n    if (key in actual) return true;\n  }\n  return false;\n}\n\n/**\n * Reads the current values of every reactive var in `clientVariables` into a plain object via a\n * single `useSyncExternalStore` call (no hooks-in-loop). Apollo's `ReactiveVar.onNextChange` fires\n * once per registration, so the subscriber re-attaches after each notification to stay listening.\n */\nfunction useClientVariableValues<TVars>(clientVariables: ClientVariablesMap<TVars> | undefined): Partial<TVars> {\n  // Keep the latest map identity reachable from inside subscribe()/getSnapshot() without forcing\n  // useSyncExternalStore to tear down the underlying subscription.\n  const varsRef = useRef(clientVariables);\n  // react-doctor-disable-next-line no-ref-current-in-render -- keeps the latest map reachable from the stable subscribe()/getSnapshot() callbacks below\n  varsRef.current = clientVariables;\n\n  const subscribe = useCallback((notify: () => void): (() => void) => {\n    const cv = varsRef.current;\n    if (!cv) return () => {};\n\n    const activeUnsubs: Array<() => void> = [];\n    let cancelled = false;\n\n    const attach = (rv: ReactiveVar<unknown>): void => {\n      if (cancelled) return;\n      const unsub = rv.onNextChange(() => {\n        notify();\n        // onNextChange fires only once — re-attach to keep listening for subsequent changes.\n        attach(rv);\n      });\n      activeUnsubs.push(unsub);\n    };\n\n    for (const rv of Object.values(cv)) {\n      if (rv === undefined || rv === null) continue;\n      const resolved = resolveReactiveVar(rv as ReactiveVar<unknown> | string);\n      if (resolved) attach(resolved);\n    }\n\n    return () => {\n      cancelled = true;\n      for (const u of activeUnsubs) u();\n    };\n  }, []);\n\n  const lastSnapshotRef = useRef<{ json: string; value: Record<string, unknown> } | null>(null);\n\n  const getSnapshot = (): string => {\n    const cv = varsRef.current;\n    const snap: Record<string, unknown> = {};\n    if (cv) {\n      for (const [key, reactiveVar] of Object.entries(cv)) {\n        if (reactiveVar === undefined || reactiveVar === null) continue;\n        const resolved = resolveReactiveVar(reactiveVar as ReactiveVar<unknown> | string);\n        if (!resolved) continue;\n        const value = resolved();\n        if (value !== null && value !== undefined) snap[key] = value;\n      }\n    }\n    const json = JSON.stringify(snap);\n    // useSyncExternalStore expects a stable snapshot reference until the value changes (Object.is\n    // identity check) — return the cached `json` whenever the contents are unchanged.\n    if (lastSnapshotRef.current && lastSnapshotRef.current.json === json) {\n      return lastSnapshotRef.current.json;\n    }\n    lastSnapshotRef.current = { json, value: snap };\n    return json;\n  };\n\n  useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n\n  return (lastSnapshotRef.current?.value ?? {}) as Partial<TVars>;\n}\n\n/**\n * Apollo rejects a refetch that ends with no value, as when the root unmounts mid-flight, with a\n * `DOMException` named `AbortError`, or a plain `Error` of that name where there is no `DOMException`.\n * A property check, since a `DOMException` is not always an `Error` instance (jsdom). The read is\n * guarded because a `.name` getter can throw, and `refetch` must not reject.\n */\nfunction isAbort(failure: unknown): boolean {\n  if (typeof failure !== 'object' || failure === null) return false;\n  try {\n    return (failure as { name?: unknown }).name === 'AbortError';\n  } catch {\n    return false;\n  }\n}\n\nexport function PageReactiveDataRoot<TData = unknown, TVars extends OperationVariables = OperationVariables>({\n  query,\n  serverVariables,\n  initialData,\n  failedFields,\n  clientVariables,\n  children,\n}: PageReactiveDataRootProps<TData, TVars>): ReactNode {\n  const client = useApolloClient();\n  const seededKeysRef = useRef(new Set<string>());\n  const hasFailedFields = failedFields != null && failedFields.length > 0;\n  const serverVariablesKey = canonicalStringify(serverVariables ?? null);\n\n  const clientValues = useClientVariableValues<TVars>(clientVariables);\n  const mergedVariables = { ...(serverVariables ?? ({} as TVars)), ...clientValues } as TVars;\n\n  const requiredNames = getRequiredVariableNames(query);\n  const mergedRecord = mergedVariables as Record<string, unknown>;\n  const hasAllRequiredVariables = requiredNames.every((name) => {\n    const v = mergedRecord[name];\n    return v !== null && v !== undefined;\n  });\n\n  // Ref- and shape-guarded cache seed from server props, once per set of server variables. A passive\n  // effect is enough: the resulting \"first render shows fallbackData, second render shows cache\n  // slice\" behaviour is acceptable because initialData is the same value `ReactiveDataProvider`\n  // falls back to anyway.\n  //\n  // A result with failed root fields is never seeded: the seed would store each failed field's\n  // `null` without its error, and the cache-first read would then report the failure as an absence.\n  // Keying on the variables lets a healthy render replace the `null` an earlier failed read left.\n  useEffect(() => {\n    if (seededKeysRef.current.has(serverVariablesKey)) return;\n    if (hasFailedFields) return;\n    if (!serverVariables || initialData == null) return;\n    if (!shapeMatches(query, initialData)) return;\n    client.cache.writeQuery({ query, variables: serverVariables, data: initialData });\n    seededKeysRef.current.add(serverVariablesKey);\n  }, [client, query, serverVariables, serverVariablesKey, initialData, hasFailedFields]);\n\n  // `network-only` on a failed field: the client cache outlives the page, and Apollo caches a result\n  // with errors under `errorPolicy: 'all'`, so an earlier failed request would otherwise answer a\n  // revisit from the cache with no error. `errorPolicy` is pinned so the partial data survives\n  // beside the error whatever the client's defaults.\n  //\n  // `useQuery` re-sends `fetchPolicy` on every render, and on a variables change Apollo lets a\n  // `nextFetchPolicy` function overrule it. The function sends one network read per set of server\n  // variables with failed fields, so a client-variable change reads the cache as on a healthy page.\n  const networkReadKeysRef = useRef(new Set<string>());\n  const nextFetchPolicy = useCallback(\n    (\n      _current: WatchQueryFetchPolicy,\n      { reason }: { reason: 'after-fetch' | 'variables-changed' },\n    ): WatchQueryFetchPolicy => {\n      if (!hasFailedFields) return 'cache-first';\n      if (reason === 'variables-changed' && !networkReadKeysRef.current.has(serverVariablesKey)) return 'network-only';\n      networkReadKeysRef.current.add(serverVariablesKey);\n      return 'cache-first';\n    },\n    [hasFailedFields, serverVariablesKey],\n  );\n\n  const {\n    data,\n    loading,\n    error,\n    refetch: refetchQuery,\n  } = useQuery(query, {\n    variables: mergedVariables,\n    fetchPolicy: hasFailedFields ? 'network-only' : 'cache-first',\n    nextFetchPolicy,\n    errorPolicy: 'all',\n    skip: !hasAllRequiredVariables,\n  });\n\n  // Apollo never caches errors: a cache write that re-delivers the result drops `error` and leaves\n  // the failed field's `null`. The root keeps the last network error per set of variables while the\n  // data still shows that failure; a new request for those variables, or a write that heals the\n  // field, drops it.\n  const variablesKey = canonicalStringify(mergedVariables);\n  const [networkErrors, setNetworkErrors] = useState<ReadonlyMap<string, ErrorLike>>(() => new Map());\n  const storedError = networkErrors.get(variablesKey);\n  const storedErrorApplies = storedError !== undefined && !loading && stillShowsFailure(data, storedError);\n  useEffect(() => {\n    if (error) {\n      setNetworkErrors((errors) => withEntry(errors, variablesKey, error));\n    } else if (loading || (storedError !== undefined && !storedErrorApplies)) {\n      setNetworkErrors((errors) => withEntry(errors, variablesKey, undefined));\n    }\n  }, [error, loading, variablesKey, storedError, storedErrorApplies]);\n  const rootError = error ?? (storedErrorApplies ? storedError : undefined);\n\n  // Apollo binds `refetch` once per ObservableQuery, so it changes when the query document or the\n  // client changes. The published one reads the latest through this ref, so its identity holds across\n  // those swaps. The ref is written once a render commits, never during one: a render React abandons\n  // must not leak its readiness or handle into a caller. It is written in a layout effect so it is\n  // set before any descendant's passive effect calls `refetch`. It is null once the root unmounted,\n  // because refetching then would revive a torn-down ObservableQuery that nothing is left to stop.\n  const latestRef = useRef<{ refetchQuery: typeof refetchQuery; hasAllRequiredVariables: boolean } | null>(null);\n  useLayoutEffect(() => {\n    latestRef.current = { refetchQuery, hasAllRequiredVariables };\n  });\n  useLayoutEffect(\n    () => () => {\n      latestRef.current = null;\n    },\n    [],\n  );\n\n  const refetch = useCallback(async (): Promise<void> => {\n    const latest = latestRef.current;\n    if (!latest?.hasAllRequiredVariables) return;\n    try {\n      await latest.refetchQuery();\n    } catch (error_) {\n      // Under the pinned `errorPolicy: 'all'` a failed read resolves and reaches descendants through\n      // `error`. A cancelled refetch rejects and needs no report. Any other failure (a local-state\n      // error, an Apollo invariant) never reaches `error`, so it is logged by name: no caller handles\n      // a rejection.\n      if (!isAbort(error_)) console.error('[PageReactiveDataRoot] refetch failed', loggableErrorName(error_));\n    }\n  }, []);\n\n  const contextValue: ReactiveRootContextValue<TData> = useMemo(\n    () => ({\n      rootQueryData: (data ?? undefined) as TData | undefined,\n      loading,\n      hasAllRequiredVariables,\n      error: rootError,\n      hasRoot: true,\n      refetch,\n    }),\n    [data, loading, hasAllRequiredVariables, rootError, refetch],\n  );\n\n  return (\n    <ReactiveRootContext.Provider value={contextValue as ReactiveRootContextValue}>\n      {children}\n    </ReactiveRootContext.Provider>\n  );\n}\n"],"mappings":"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"}

package/dist/sdk/data/variables-from-content.d.ts

@@ -0,0 +1,43 @@
+//#region src/sdk/data/variables-from-content.d.ts
+/**
+ * One element-scoped variable a component's fragment reads from its content slice (config-sourced
+ * fragment variables RFC). The compiler derives one of these per variable from the catalog entry:
+ * nothing here is authored.
+ */
+export type ContentVariableField = {
+  /** The fragment's variable name, unprefixed (`orderBy`). */
+  variable: string;
+  /** The content-model field that feeds it (`sort`), the binding's `from` or the variable name. */
+  field: string;
+  /** The content model's word: a required field never falls to a prop. */
+  required?: boolean;
+  /** The schema prop's `default`: the developer's value when the field is empty. */
+  default?: unknown;
+  /** The binding's `values` table: the field's value is a key into it. */
+  values?: Record<string, unknown>;
+};
+/** The per-component binding spec the page module emits (`<Alias>ContentVariables`). */
+export type ContentVariablesSpec = {
+  fields: readonly ContentVariableField[];
+};
+export type VariablesFromContentOptions = {
+  /**
+   * The element prefix of a page-query instance: every key becomes `<prefix>_<variable>` and
+   * `<prefix>_skip` carries the skip flag. Absent for a lazy query, whose names are unprefixed
+   * and whose element is already omitted by its content boundary.
+   */
+  prefix?: string;
+  /** The element's own literal props for content fields: they outrank the schema defaults. */
+  props?: Record<string, unknown>;
+};
+/**
+ * Builds the variables object of one fragment instance from the element's content slice at
+ * request time. The content value wins per field; an empty optional field takes the element prop,
+ * then the schema default, and is omitted when neither exists so an input-object field it sits in
+ * relaxes. An absent slice (the content runtime omitted the element) or an empty `required` field
+ * raises the skip flag, and the defaults are still emitted so a non-null variable of a skipped
+ * field is coerced. A `values` table maps a string key; an unknown key omits the variable.
+ */
+export declare function variablesFromContent(spec: ContentVariablesSpec, slice: unknown, { prefix, props }?: VariablesFromContentOptions): Record<string, unknown>;
+//#endregion
+//# sourceMappingURL=variables-from-content.d.ts.map

package/dist/sdk/data/variables-from-content.js

@@ -0,0 +1,57 @@
+import { isEmptyContentValue } from "./empty-content-value.js";
+//#region src/sdk/data/variables-from-content.ts
+/**
+* Builds the variables object of one fragment instance from the element's content slice at
+* request time. The content value wins per field; an empty optional field takes the element prop,
+* then the schema default, and is omitted when neither exists so an input-object field it sits in
+* relaxes. An absent slice (the content runtime omitted the element) or an empty `required` field
+* raises the skip flag, and the defaults are still emitted so a non-null variable of a skipped
+* field is coerced. A `values` table maps a string key; an unknown key omits the variable.
+*/
+function variablesFromContent(spec, slice, { prefix, props } = {}) {
+	const content = isRecord(slice) ? slice : void 0;
+	let skip = content === void 0;
+	const variables = {};
+	const key = (name) => prefix === void 0 ? name : `${prefix}_${name}`;
+	for (const field of spec.fields) {
+		const resolved = resolveField(field, content, props);
+		skip ||= resolved.skip;
+		const value = bindValue(field, resolved.value);
+		if (value !== void 0) variables[key(field.variable)] = value;
+	}
+	if (prefix !== void 0) variables[`${prefix}_skip`] = skip;
+	return variables;
+}
+/**
+* The content value, else the element prop, else the schema default. An empty `required` field
+* raises the skip flag and emits only the schema default, never the prop.
+*/
+function resolveField(field, content, props) {
+	const fromContent = content?.[field.field];
+	if (!isEmptyContentValue(fromContent)) return {
+		value: fromContent,
+		skip: false
+	};
+	if (field.required) return {
+		value: field.default,
+		skip: true
+	};
+	const fromProp = props?.[field.field];
+	return {
+		value: isEmptyContentValue(fromProp) ? field.default : fromProp,
+		skip: false
+	};
+}
+/** The variable's value for a resolved field: `undefined` omits it (empty, or an unknown `values` key). */
+function bindValue(field, value) {
+	if (isEmptyContentValue(value)) return void 0;
+	if (field.values === void 0) return value;
+	return typeof value === "string" && Object.hasOwn(field.values, value) ? field.values[value] : void 0;
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//#endregion
+export { variablesFromContent };
+
+//# sourceMappingURL=variables-from-content.js.map

package/dist/sdk/data/variables-from-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"variables-from-content.js","names":[],"sources":["../../../src/sdk/data/variables-from-content.ts"],"sourcesContent":["import { isEmptyContentValue } from './empty-content-value.js';\n\n/**\n * One element-scoped variable a component's fragment reads from its content slice (config-sourced\n * fragment variables RFC). The compiler derives one of these per variable from the catalog entry:\n * nothing here is authored.\n */\nexport type ContentVariableField = {\n  /** The fragment's variable name, unprefixed (`orderBy`). */\n  variable: string;\n  /** The content-model field that feeds it (`sort`), the binding's `from` or the variable name. */\n  field: string;\n  /** The content model's word: a required field never falls to a prop. */\n  required?: boolean;\n  /** The schema prop's `default`: the developer's value when the field is empty. */\n  default?: unknown;\n  /** The binding's `values` table: the field's value is a key into it. */\n  values?: Record<string, unknown>;\n};\n\n/** The per-component binding spec the page module emits (`<Alias>ContentVariables`). */\nexport type ContentVariablesSpec = {\n  fields: readonly ContentVariableField[];\n};\n\nexport type VariablesFromContentOptions = {\n  /**\n   * The element prefix of a page-query instance: every key becomes `<prefix>_<variable>` and\n   * `<prefix>_skip` carries the skip flag. Absent for a lazy query, whose names are unprefixed\n   * and whose element is already omitted by its content boundary.\n   */\n  prefix?: string;\n  /** The element's own literal props for content fields: they outrank the schema defaults. */\n  props?: Record<string, unknown>;\n};\n\n/**\n * Builds the variables object of one fragment instance from the element's content slice at\n * request time. The content value wins per field; an empty optional field takes the element prop,\n * then the schema default, and is omitted when neither exists so an input-object field it sits in\n * relaxes. An absent slice (the content runtime omitted the element) or an empty `required` field\n * raises the skip flag, and the defaults are still emitted so a non-null variable of a skipped\n * field is coerced. A `values` table maps a string key; an unknown key omits the variable.\n */\nexport function variablesFromContent(\n  spec: ContentVariablesSpec,\n  slice: unknown,\n  { prefix, props }: VariablesFromContentOptions = {},\n): Record<string, unknown> {\n  const content = isRecord(slice) ? slice : undefined;\n  let skip = content === undefined;\n  const variables: Record<string, unknown> = {};\n  const key = (name: string) => (prefix === undefined ? name : `${prefix}_${name}`);\n\n  for (const field of spec.fields) {\n    const resolved = resolveField(field, content, props);\n    skip ||= resolved.skip;\n    const value = bindValue(field, resolved.value);\n    if (value !== undefined) variables[key(field.variable)] = value;\n  }\n\n  if (prefix !== undefined) variables[`${prefix}_skip`] = skip;\n  return variables;\n}\n\ntype ResolvedField = { value: unknown; skip: boolean };\n\n/**\n * The content value, else the element prop, else the schema default. An empty `required` field\n * raises the skip flag and emits only the schema default, never the prop.\n */\nfunction resolveField(\n  field: ContentVariableField,\n  content: Record<string, unknown> | undefined,\n  props: Record<string, unknown> | undefined,\n): ResolvedField {\n  const fromContent = content?.[field.field];\n  if (!isEmptyContentValue(fromContent)) return { value: fromContent, skip: false };\n  if (field.required) return { value: field.default, skip: true };\n  const fromProp = props?.[field.field];\n  return { value: isEmptyContentValue(fromProp) ? field.default : fromProp, skip: false };\n}\n\n/** The variable's value for a resolved field: `undefined` omits it (empty, or an unknown `values` key). */\nfunction bindValue(field: ContentVariableField, value: unknown): unknown {\n  if (isEmptyContentValue(value)) return undefined;\n  if (field.values === undefined) return value;\n  return typeof value === 'string' && Object.hasOwn(field.values, value) ? field.values[value] : undefined;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n"],"mappings":";;;;;;;;;;AA4CA,SAAgB,qBACd,MACA,OACA,EAAE,QAAQ,UAAuC,CAAC,GACzB;CACzB,MAAM,UAAU,SAAS,KAAK,IAAI,QAAQ,KAAA;CAC1C,IAAI,OAAO,YAAY,KAAA;CACvB,MAAM,YAAqC,CAAC;CAC5C,MAAM,OAAO,SAAkB,WAAW,KAAA,IAAY,OAAO,GAAG,OAAO,GAAG;CAE1E,KAAK,MAAM,SAAS,KAAK,QAAQ;EAC/B,MAAM,WAAW,aAAa,OAAO,SAAS,KAAK;EACnD,SAAS,SAAS;EAClB,MAAM,QAAQ,UAAU,OAAO,SAAS,KAAK;EAC7C,IAAI,UAAU,KAAA,GAAW,UAAU,IAAI,MAAM,QAAQ,KAAK;CAC5D;CAEA,IAAI,WAAW,KAAA,GAAW,UAAU,GAAG,OAAO,UAAU;CACxD,OAAO;AACT;;;;;AAQA,SAAS,aACP,OACA,SACA,OACe;CACf,MAAM,cAAc,UAAU,MAAM;CACpC,IAAI,CAAC,oBAAoB,WAAW,GAAG,OAAO;EAAE,OAAO;EAAa,MAAM;CAAM;CAChF,IAAI,MAAM,UAAU,OAAO;EAAE,OAAO,MAAM;EAAS,MAAM;CAAK;CAC9D,MAAM,WAAW,QAAQ,MAAM;CAC/B,OAAO;EAAE,OAAO,oBAAoB,QAAQ,IAAI,MAAM,UAAU;EAAU,MAAM;CAAM;AACxF;;AAGA,SAAS,UAAU,OAA6B,OAAyB;CACvE,IAAI,oBAAoB,KAAK,GAAG,OAAO,KAAA;CACvC,IAAI,MAAM,WAAW,KAAA,GAAW,OAAO;CACvC,OAAO,OAAO,UAAU,YAAY,OAAO,OAAO,MAAM,QAAQ,KAAK,IAAI,MAAM,OAAO,SAAS,KAAA;AACjG;AAEA,SAAS,SAAS,OAAkD;CAClE,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E"}

package/dist/sdk/generated/fragment-types.js

@@ -8,6 +8,8 @@ const possibleTypes = {
 		"ClientPreferences",
 		"ClientProfile",
 		"Collection",
+		"CustomerAddress",
+		"CustomerOrder",
 		"Customization",
 		"Order",
 		"Payment",

package/dist/sdk/generated/fragment-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"fragment-types.js","names":[],"sources":["../../../src/sdk/generated/fragment-types.ts"],"sourcesContent":["// @generated — DO NOT EDIT. Run `pnpm codegen` to regenerate.\nexport type PossibleTypes = Record<string, string[]>;\nexport const possibleTypes: PossibleTypes = {\n  Media: [\n    'Image',\n    'Video'\n  ],\n  Node: [\n    'Brand',\n    'Cart',\n    'Category',\n    'ClientPreferences',\n    'ClientProfile',\n    'Collection',\n    'Customization',\n    'Order',\n    'Payment',\n    'Product',\n    'SalesChannel',\n    'Seller',\n    'Session',\n    'Shipping',\n    'Variant'\n  ]\n};\n"],"mappings":";AAEA,MAAa,gBAA+B;CAC1C,OAAO,CACL,SACA,OACF;CACA,MAAM;EACJ;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;AACF"}
+{"version":3,"file":"fragment-types.js","names":[],"sources":["../../../src/sdk/generated/fragment-types.ts"],"sourcesContent":["// @generated — DO NOT EDIT. Run `pnpm codegen` to regenerate.\nexport type PossibleTypes = Record<string, string[]>;\nexport const possibleTypes: PossibleTypes = {\n  Media: [\n    'Image',\n    'Video'\n  ],\n  Node: [\n    'Brand',\n    'Cart',\n    'Category',\n    'ClientPreferences',\n    'ClientProfile',\n    'Collection',\n    'CustomerAddress',\n    'CustomerOrder',\n    'Customization',\n    'Order',\n    'Payment',\n    'Product',\n    'SalesChannel',\n    'Seller',\n    'Session',\n    'Shipping',\n    'Variant'\n  ]\n};\n"],"mappings":";AAEA,MAAa,gBAA+B;CAC1C,OAAO,CACL,SACA,OACF;CACA,MAAM;EACJ;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;AACF"}

package/dist/sdk/generated/gql.js

@@ -1,4 +1,4 @@
-import { AccountSessionRevalidateDocument, BuyButtonDataFragmentDoc, CartCouponApplyDocument, CartCouponRemoveDocument, CartDataFragmentDoc, CartDiscountLinesDataFragmentDoc, CartFragmentFragmentDoc, CartItemAddDocument, CartItemCompositionsDataFragmentDoc, CartItemCustomizationsDataFragmentDoc, CartItemDiscountsDataFragmentDoc, CartItemFragmentFragmentDoc, CartItemQuantityDataFragmentDoc, CartItemQuantityDecreaseDocument, CartItemQuantityIncreaseDocument, CartItemRemoveDocument, CartItemRootDataFragmentDoc, CartItemSellerInfoDataFragmentDoc, CartItemVariationsDataFragmentDoc, CartItemsRemoveDocument, CartMarkdownDataFragmentDoc, CartShippingSimulationDocument, CartTotalizerDataFragmentDoc, CartValidateDocument, MoneyFragmentFragmentDoc, PricingDataFragmentDoc, ProductGalleryDataFragmentDoc, ProductInformationDataFragmentDoc, RegionDataFragmentDoc, RegionFragmentFragmentDoc, SessionDataFragmentDoc, SessionFragmentFragmentDoc, ShippingAddressUpdateDocument, ShippingSimulationDocument, VariantBuyButtonDataFragmentDoc, VariantBuyButtonQueryDocument, VariantGalleryDataFragmentDoc, VariantGalleryQueryDocument, VariantPricingDataFragmentDoc, VariantPricingQueryDocument, VariantSelectorDataFragmentDoc } from "./graphql.js";
+import { AccountSessionRevalidateDocument, AddressByPostalCodeDocument, BuyButtonDataFragmentDoc, CartCouponApplyDocument, CartCouponRemoveDocument, CartDataFragmentDoc, CartDiscountLinesDataFragmentDoc, CartFragmentFragmentDoc, CartItemAddDocument, CartItemCompositionsDataFragmentDoc, CartItemCustomizationsDataFragmentDoc, CartItemDiscountsDataFragmentDoc, CartItemFragmentFragmentDoc, CartItemQuantityDataFragmentDoc, CartItemQuantityDecreaseDocument, CartItemQuantityIncreaseDocument, CartItemRemoveDocument, CartItemRootDataFragmentDoc, CartItemSellerInfoDataFragmentDoc, CartItemVariationsDataFragmentDoc, CartItemsRemoveDocument, CartMarkdownDataFragmentDoc, CartShippingSimulationDocument, CartTotalizerDataFragmentDoc, CartValidateDocument, CatalogRouteAlternatesDocument, MoneyFragmentFragmentDoc, PricingDataFragmentDoc, ProductGalleryDataFragmentDoc, ProductInformationDataFragmentDoc, RegionDataFragmentDoc, RegionFragmentFragmentDoc, ServerSessionReadDocument, SessionDataFragmentDoc, SessionFragmentFragmentDoc, ShippingAddressUpdateDocument, ShippingSimulationDocument, VariantBuyButtonDataFragmentDoc, VariantBuyButtonQueryDocument, VariantGalleryDataFragmentDoc, VariantGalleryQueryDocument, VariantPricingDataFragmentDoc, VariantPricingQueryDocument, VariantSelectorDataFragmentDoc } from "./graphql.js";
 //#region src/sdk/generated/gql.ts
 const documents = {
 	"\n  fragment BuyButtonData on Query {\n    productBySlug(slug: $slug) {\n      id\n      title\n      slug\n      images(first: 1) {\n        edges {\n          node {\n            url\n            altText\n          }\n        }\n      }\n      variants(first: 1) {\n        edges {\n          node {\n            id\n            sku\n            availableForSale\n            sellers {\n              id\n              isDefault\n              offer {\n                price { amount currencyCode }\n                listPrice { amount currencyCode }\n              }\n            }\n          }\n        }\n      }\n    }\n  }\n": BuyButtonDataFragmentDoc,
@@ -25,6 +25,7 @@ const documents = {
 	"\n  fragment RegionData on Query {\n    region {\n      ...RegionFragment\n    }\n  }\n": RegionDataFragmentDoc,
 	"\n  fragment SessionData on Query {\n    session {\n      ...SessionFragment\n    }\n  }\n": SessionDataFragmentDoc,
 	"\n  fragment VariantSelectorData on Query {\n    productBySlug(slug: $slug) {\n      __typename\n      id\n      options {\n        name\n        values\n      }\n      variants(first: 50) {\n        edges {\n          node {\n            __typename\n            id\n            name\n            sku\n            availableForSale\n            selectedOptions {\n              name\n              value\n            }\n            images(first: 1) {\n              edges {\n                node {\n                  url\n                  altText\n                }\n              }\n            }\n          }\n        }\n      }\n    }\n  }\n": VariantSelectorDataFragmentDoc,
+	"\n  query AddressByPostalCode($country: String!, $postalCode: String!) {\n    addressByPostalCode(country: $country, postalCode: $postalCode) {\n      city\n      state\n      street\n      neighborhood\n    }\n  }\n": AddressByPostalCodeDocument,
 	"\n  fragment MoneyFragment on Money {\n    __typename\n    amount\n    currencyCode\n  }\n": MoneyFragmentFragmentDoc,
 	"\n  fragment CartItemFragment on CartItem {\n    __typename\n    id\n    quantity\n    price {\n      ...MoneyFragment\n    }\n    listPrice {\n      ...MoneyFragment\n    }\n    sellingPrice {\n      ...MoneyFragment\n    }\n    gift\n    ownTotal {\n      ...MoneyFragment\n    }\n    total {\n      ...MoneyFragment\n    }\n    variant {\n      __typename\n      variantId\n      sku\n      name\n      image {\n        url\n        altText\n      }\n      availability\n    }\n    product {\n      __typename\n      productId\n      title\n      detailUrl\n      categories {\n        categoryId\n        name\n      }\n      brand {\n        brandId\n        name\n      }\n    }\n  }\n": CartItemFragmentFragmentDoc,
 	"\n  fragment CartFragment on Cart {\n    __typename\n    id\n    items {\n      ...CartItemFragment\n    }\n    totalizers {\n      __typename\n      id\n      name\n      value {\n        ...MoneyFragment\n      }\n    }\n    total {\n      ...MoneyFragment\n    }\n    messages {\n      __typename\n      code\n      text\n      status\n    }\n    appliedCoupons {\n      code\n      isUnmatchedCondition\n    }\n  }\n": CartFragmentFragmentDoc,
@@ -37,7 +38,9 @@ const documents = {
 	"\n  mutation CartCouponRemove($input: CartCouponRemoveInput!) {\n    cartCouponRemove(input: $input) {\n      __typename\n      cart {\n        ...CartFragment\n      }\n      userErrors {\n        code\n        message\n      }\n    }\n  }\n": CartCouponRemoveDocument,
 	"\n  mutation CartValidate {\n    cartValidate {\n      __typename\n      cart {\n        ...CartFragment\n      }\n      userErrors {\n        code\n        message\n      }\n    }\n  }\n": CartValidateDocument,
 	"\n  fragment RegionFragment on Region {\n    __typename\n    id\n    postalCode\n    city\n  }\n": RegionFragmentFragmentDoc,
+	"\n  query CatalogRouteAlternates($path: String!) {\n    catalogRoute(input: { path: $path }) {\n      variants {\n        locale\n        path\n      }\n    }\n  }\n": CatalogRouteAlternatesDocument,
 	"\n  fragment SessionFragment on Session {\n    __typename\n    id\n    loggedIn\n    canEditData\n    isIdentified\n  }\n": SessionFragmentFragmentDoc,
+	"\n  query ServerSessionRead {\n    session {\n      ...SessionFragment\n    }\n  }\n": ServerSessionReadDocument,
 	"\n  query AccountSessionRevalidate {\n    session {\n      ...SessionFragment\n    }\n  }\n": AccountSessionRevalidateDocument,
 	"\n  query CartShippingSimulation($input: CartShippingSimulateInput!) {\n    cartShippingSimulation(input: $input) {\n      shippingOptions {\n        id\n        name\n        channel\n        shippingEstimate {\n          value\n          unit\n        }\n        price {\n          amount\n          currencyCode\n        }\n        listPrice {\n          amount\n          currencyCode\n        }\n      }\n      userErrors {\n        code\n        message\n      }\n    }\n  }\n": CartShippingSimulationDocument,
 	"\n  query ShippingSimulation($input: ShippingSimulateInput!) {\n    shippingSimulation(input: $input) {\n      shippingOptions {\n        id\n        name\n        channel\n        shippingEstimate {\n          value\n          unit\n        }\n        price {\n          amount\n          currencyCode\n        }\n        listPrice {\n          amount\n          currencyCode\n        }\n      }\n      userErrors {\n        code\n        message\n      }\n    }\n  }\n": ShippingSimulationDocument,