@zappie/sdk 0.1.4 → 0.1.6

package/dist/client-Bm2cCYea.d.ts

@@ -0,0 +1,400 @@
+import { a as Menu, C as CategoryPage, S as Store, I as Item, M as Money, F as Formatters } from './models-Rg5kQUkv.js';
+import { Q as QuoteRequest, g as WireQuote, i as CartIssueCode, d as CartModule, b as CartLineInput } from './types-CuDvfW9g.js';
+
+/**
+ * The store, branch, order context and source menu that identify a saved catalogue.
+ */
+type CatalogueScope = {
+    store: string;
+    branchId: string;
+    orderContext: "delivery" | "pickup" | "dineIn";
+    menuId: string;
+};
+/** The saved coverage. A complete source menu still covers only part of the branch. */
+type SavedCatalogue = {
+    scope: CatalogueScope;
+    menu: Menu;
+    coverage: {
+        menuIds: string[];
+        complete: boolean;
+    };
+    pages: {
+        categoryId: string;
+        cursor?: string;
+        page: CategoryPage;
+    }[];
+    etag: string;
+    savedAt: number;
+    /**
+     * The host's catalogue revision when saved. An unchanged revision means the
+     * saved copy is current and needs no background refresh.
+     */
+    revision?: string;
+};
+/**
+ * Default saved-catalogue lifetime in milliseconds: 24 hours.
+ */
+declare const CATALOGUE_MAX_AGE_MS: number;
+/**
+ * Default per-store catalogue storage budget in serialized bytes: 16 MiB.
+ */
+declare const CATALOGUE_MAX_BYTES: number;
+/**
+ * Build a versioned JSON storage key from the store, branch, order context and menu ID.
+ */
+declare function catalogueKey(scope: CatalogueScope): string;
+/** Opt-in browser persistence. Storage failures never escape into shopper UI. */
+declare function createCatalogueStorage(store: string, options?: {
+    maxAgeMs?: number;
+    maxBytes?: number;
+}): {
+    read(scope: CatalogueScope): Promise<SavedCatalogue | undefined>;
+    save(value: SavedCatalogue): void;
+};
+/** Digest excludes transport versions: publication follows shopper-visible content. */
+declare function catalogueDigest(menu: Menu): Promise<string>;
+/** A saved source menu that stays separate from the complete branch catalogue. */
+declare function createSavedCatalogue(client: Zappie, scope: CatalogueScope): {
+    restore(): Promise<SavedCatalogue | undefined>;
+    /** Save in the background and return whether the content changed. */
+    publish(value: SavedCatalogue): Promise<boolean>;
+};
+
+/** Complete for the named source, never complete for the branch. */
+type SelectedMenu = {
+    menu: Menu & {
+        completeness: "partial";
+    };
+    coverage: {
+        menuIds: [string];
+        complete: true;
+    };
+};
+/**
+ * A source menu with its ETag, or an unchanged response carrying the matching ETag.
+ */
+type SelectedMenuResponse = (SelectedMenu & {
+    etag: string;
+}) | {
+    notModified: true;
+    etag: string;
+};
+/**
+ * A branch-scoped source-menu request with order context and an optional conditional ETag.
+ */
+type SelectedMenuRequest = RequestCtx & {
+    branchId: string;
+    menuId: string;
+    orderContext: CatalogueScope["orderContext"];
+    ifNoneMatch?: string;
+};
+/**
+ * A transport that reads one complete source menu without claiming branch-wide coverage.
+ */
+type SelectedMenuTransport = {
+    getSelectedMenu(request: SelectedMenuRequest): Promise<SelectedMenuResponse>;
+};
+/** Dependencies are passed by REST to avoid splitting core shared chunks. */
+declare function selectedMenu(ctx: SelectedMenuRequest, request: (path: string) => Promise<Response>, json: (response: Response) => Promise<unknown>, mapMenu: (value: unknown, branchId: string) => Menu, invalid: () => Error): Promise<SelectedMenuResponse>;
+/**
+ * Build a versioned cache key for a source menu within a store, branch and order context.
+ */
+declare function selectedMenuKey(scope: CatalogueScope): string;
+/** Dedicated lazy resource: deliberately does not call menu.hydrate(). */
+declare function createSelectedMenuReader(client: Zappie): {
+    read(scope: CatalogueScope, options?: {
+        signal?: AbortSignal;
+        ifNoneMatch?: string;
+    }): Promise<SelectedMenuResponse>;
+};
+
+/** Per-request credentials and cancellation. Never shared across clients. */
+type RequestCtx = {
+    key: string;
+    version: string;
+    signal?: AbortSignal;
+    idempotencyKey?: string;
+};
+/** Full menu response or a conditional-cache hit. */
+type MenuResponse = {
+    menu: Menu;
+    etag?: string;
+} | {
+    notModified: true;
+    etag?: string;
+};
+/** Opaque content and availability versions. */
+type MenuVersion = {
+    version: string;
+    availabilityHash: string;
+};
+/** Replaceable read-only backend for the storefront SDK. */
+interface Transport {
+    getSelectedMenu?(ctx: SelectedMenuRequest): Promise<SelectedMenuResponse>;
+    search?(ctx: SearchRequest): Promise<SearchPage>;
+    quote(ctx: RequestCtx, body: QuoteRequest): Promise<WireQuote>;
+    getStore(ctx: RequestCtx): Promise<Store>;
+    getMenu(ctx: RequestCtx & {
+        branchId: string;
+        ifNoneMatch?: string;
+        metadataOnly?: boolean;
+        fulfilment?: MenuFulfilment | undefined;
+    }): Promise<MenuResponse>;
+    getCategoryPage?(ctx: RequestCtx & {
+        branchId: string;
+        menuId: string;
+        categoryId: string;
+        cursor?: string;
+    }): Promise<CategoryPage>;
+    getMenuVersion(ctx: RequestCtx & {
+        branchId: string;
+        fulfilment?: MenuFulfilment | undefined;
+    }): Promise<MenuVersion>;
+    getItem(ctx: RequestCtx & {
+        branchId: string;
+        itemId: string;
+    }): Promise<Item>;
+}
+/** Bounded search across eligible source menus in the current order context. */
+type SearchRequest = RequestCtx & {
+    branchId: string;
+    query: string;
+    cursor?: string;
+};
+/** Matching items with their source menus and categories. This is a partial catalogue. */
+type SearchPage = {
+    menu: Menu;
+    nextCursor?: string;
+};
+
+/** Release-pinned REST contract version, independent of the package version. */
+declare const API_VERSION = "2026-10-01";
+/** A storage adapter you can supply to save carts. */
+interface StorageLike {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+    /** Provide length and key to let the SDK remove expired carts for this store. */
+    readonly length?: number;
+    key?(index: number): string | null;
+}
+/** Settings for your storefront client. Each client keeps its own credentials and caches. */
+type ZappieConfig = {
+    store: string;
+    key: string;
+    branch?: string;
+    transport?: Transport;
+    baseUrl?: string;
+    version?: string;
+    fetch?: typeof fetch;
+    /** Route cart quotes through the same-origin customer channel when set. */
+    customerBase?: string;
+    storage?: StorageLike;
+    telemetry?: boolean;
+    cart?: {
+        ttl?: number;
+        storageScope?: string;
+    };
+};
+declare function validateConfig(config: ZappieConfig, secret?: boolean): "test" | "live";
+
+/** Stable public error codes. */
+type ZappieErrorCode = "network_error" | "timeout" | "rate_limited" | "unauthorized" | "forbidden_origin" | "not_found" | "store_not_found" | "branch_not_found" | "item_not_found" | "cart_invalid" | "invalid_request" | "version_unsupported" | "server_error";
+/** Context attached to an SDK failure. */
+type ErrorDetails = {
+    status?: number;
+    param?: string;
+    docUrl?: string;
+    requestId?: string;
+    retryable?: boolean;
+    cause?: unknown;
+};
+/** An SDK error you can handle by its stable code. */
+declare class ZappieError extends Error {
+    readonly code: ZappieErrorCode;
+    readonly status?: number;
+    readonly param?: string;
+    readonly docUrl: string;
+    readonly requestId?: string;
+    readonly retryable: boolean;
+    constructor(code: ZappieErrorCode, message: string, details?: ErrorDetails);
+}
+/** Check whether a thrown value is a ZappieError. */
+declare function isZappieError(error: unknown): error is ZappieError;
+
+type CacheEntry<T> = {
+    value?: T;
+    fetchedAt: number;
+    etag?: string;
+    error?: ZappieError;
+    failedAt?: number;
+    loading: boolean;
+};
+type Loaded<T> = {
+    value: T;
+    etag?: string;
+    onStored?: () => void;
+};
+/** Client-local SWR storage. Subscribers receive stable snapshots until an entry changes. */
+declare class Cache {
+    private onError;
+    private entries;
+    private listeners;
+    private flights;
+    constructor(onError: (error: ZappieError) => void);
+    snapshot<T>(key: string): CacheEntry<T>;
+    subscribe: (fn: () => void) => () => void;
+    private notify;
+    set<T>(key: string, value: T, etag?: string): void;
+    stale(key: string): boolean;
+    get<T>(key: string, loader: (signal: AbortSignal, entry: CacheEntry<T>) => Promise<Loaded<T>>, signal?: AbortSignal): Promise<T>;
+}
+
+/** Events currently emitted by the read-only SDK. */
+type ZappieEvents = {
+    search: {
+        query: string;
+        resultCount: number;
+    };
+    warning: {
+        message: string;
+    };
+    cart_expired: {
+        branchId: string;
+    };
+    add_to_cart: {
+        itemId: string;
+        quantity: number;
+        value: Money;
+    };
+    remove_from_cart: {
+        itemId: string;
+        quantity: number;
+        value: Money;
+    };
+    update_cart_line: {
+        lineId: string;
+        itemId: string;
+        quantity: number;
+    };
+    view_cart: Record<string, never>;
+    cart_issue: {
+        code: CartIssueCode;
+    };
+    quote_failed: {
+        code: string;
+    };
+    "menu:updated": {
+        branchId: string;
+        version: string;
+    };
+    error: {
+        error: ZappieError;
+    };
+};
+
+/** A catalogue fulfilment mode accepted by menu reads. */
+type MenuFulfilment = "delivery" | "pickup" | "dineIn";
+/** Optional branch selection and cancellation for resource reads. */
+type ReadOptions = {
+    branch?: string;
+    signal?: AbortSignal;
+};
+/** Optional branch and fulfilment selection for catalogue reads. */
+type MenuReadOptions = ReadOptions & {
+    fulfilment?: MenuFulfilment;
+};
+/** Read-only store resource. */
+interface StoreResource {
+    get(opts?: {
+        signal?: AbortSignal;
+    }): Promise<Store>;
+    peek(): Store | undefined;
+}
+/** Read-only branch catalogue and item resources. */
+interface MenuResource {
+    search(query: string, opts?: ReadOptions & {
+        cursor?: string;
+    }): Promise<SearchPage>;
+    get(opts?: MenuReadOptions & {
+        metadataOnly?: boolean;
+    }): Promise<Menu>;
+    page(menuId: string, categoryId: string, opts?: ReadOptions & {
+        cursor?: string;
+    }): Promise<CategoryPage>;
+    peek(branch?: string): Menu | undefined;
+    version(opts?: MenuReadOptions): Promise<MenuVersion>;
+    item(id: string, opts?: ReadOptions): Promise<Item>;
+    hydrate(menu: Menu): void;
+}
+/** A storefront client and its isolated resource state. */
+type Zappie = ReturnType<typeof buildClient>;
+declare function buildClient(input: ZappieConfig, secret?: boolean): Readonly<{
+    cart: Readonly<CartModule>;
+    config: Readonly<{
+        version: string;
+        telemetry: boolean;
+        store: string;
+        key: string;
+        branch?: string;
+        transport?: Transport;
+        baseUrl?: string;
+        fetch?: typeof fetch;
+        customerBase?: string;
+        storage?: StorageLike;
+        cart?: {
+            ttl?: number;
+            storageScope?: string;
+        };
+    }>;
+    mode: "test" | "live";
+    store: StoreResource;
+    menu: MenuResource;
+    format: Formatters;
+    on: <E extends keyof ZappieEvents>(event: E, fn: (payload: ZappieEvents[E]) => void) => () => void;
+    _internal: {
+        cartCatalogue: () => Menu | undefined;
+        setLegacyReader: (reader: NonNullable<((read: (key: string) => string | null) => CartLineInput[]) | undefined>) => void;
+        transport: Transport;
+        cache: Cache;
+        emit: <E extends keyof ZappieEvents>(event: E, payload: ZappieEvents[E]) => void;
+        menuKey: (requested?: string) => string;
+        hydrateStore: (value: Store) => void;
+    };
+}>;
+/** Create a client with your publishable key. Requests start when you read a resource. */
+declare function createZappie(config: ZappieConfig): Readonly<{
+    cart: Readonly<CartModule>;
+    config: Readonly<{
+        version: string;
+        telemetry: boolean;
+        store: string;
+        key: string;
+        branch?: string;
+        transport?: Transport;
+        baseUrl?: string;
+        fetch?: typeof fetch;
+        customerBase?: string;
+        storage?: StorageLike;
+        cart?: {
+            ttl?: number;
+            storageScope?: string;
+        };
+    }>;
+    mode: "test" | "live";
+    store: StoreResource;
+    menu: MenuResource;
+    format: Formatters;
+    on: <E extends keyof ZappieEvents>(event: E, fn: (payload: ZappieEvents[E]) => void) => () => void;
+    _internal: {
+        cartCatalogue: () => Menu | undefined;
+        setLegacyReader: (reader: NonNullable<((read: (key: string) => string | null) => CartLineInput[]) | undefined>) => void;
+        transport: Transport;
+        cache: Cache;
+        emit: <E extends keyof ZappieEvents>(event: E, payload: ZappieEvents[E]) => void;
+        menuKey: (requested?: string) => string;
+        hydrateStore: (value: Store) => void;
+    };
+}>;
+
+export { API_VERSION as A, type SelectedMenuTransport as B, Cache as C, createSelectedMenuReader as D, type ErrorDetails as E, selectedMenu as F, selectedMenuKey as G, type MenuResource as M, type RequestCtx as R, type StorageLike as S, type Transport as T, type Zappie as Z, ZappieError as a, type ZappieConfig as b, type StoreResource as c, type ZappieEvents as d, type ZappieErrorCode as e, type MenuFulfilment as f, type MenuResponse as g, type SelectedMenuRequest as h, type SelectedMenuResponse as i, type SearchRequest as j, type SearchPage as k, type MenuVersion as l, type MenuReadOptions as m, type ReadOptions as n, createZappie as o, isZappieError as p, CATALOGUE_MAX_AGE_MS as q, CATALOGUE_MAX_BYTES as r, type CatalogueScope as s, type SavedCatalogue as t, catalogueDigest as u, validateConfig as v, catalogueKey as w, createCatalogueStorage as x, createSavedCatalogue as y, type SelectedMenu as z };

package/dist/client.js

@@ -77,11 +77,12 @@ function buildClient(input, secret = false) {
     async get(opts = {}) {
       const branch = resolveBranch(await store.get(opts), opts.branch);
       return cache.get(
-        `menu:${branch.id}${opts.metadataOnly ? ":partial" : ""}`,
+        `${menuKey(branch.id)}${opts.fulfilment ? `:${opts.fulfilment}` : ""}${opts.metadataOnly ? ":partial" : ""}`,
         async (signal, entry) => {
           const response = await transport.getMenu({
             ...ctx(signal),
             branchId: branch.id,
+            fulfilment: opts.fulfilment,
             ...opts.metadataOnly ? { metadataOnly: true } : {},
             ...entry.etag ? { ifNoneMatch: entry.etag } : {}
           });
@@ -146,7 +147,8 @@ function buildClient(input, secret = false) {
       const branch = resolveBranch(await store.get(opts), opts.branch);
       return transport.getMenuVersion({
         ...ctx(opts.signal),
-        branchId: branch.id
+        branchId: branch.id,
+        fulfilment: opts.fulfilment
       });
     },
     async item(id, opts = {}) {

package/dist/client.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/client.ts"],
-  "sourcesContent": ["import { createCart } from \"./cart\";\nimport { createWorkingSet } from \"./cart/working-set\";\nimport type { ZappieConfig } from \"./config\";\nimport { API_VERSION, validateConfig } from \"./config\";\nimport { ZappieError } from \"./errors\";\nimport { Cache } from \"./internal/cache\";\nimport type { ZappieEvents } from \"./internal/emitter\";\nimport { createEmitter } from \"./internal/emitter\";\nimport type { Branch, CategoryPage, Item, Menu, Store } from \"./models\";\nimport { format } from \"./money\";\nimport { RestTransport } from \"./transport/rest\";\nimport type { MenuVersion, SearchPage } from \"./transport/types\";\n/** Optional branch selection and cancellation for resource reads. */\nexport type ReadOptions = { branch?: string; signal?: AbortSignal };\n/** Read-only store resource. */\nexport interface StoreResource {\n  get(opts?: { signal?: AbortSignal }): Promise<Store>;\n  peek(): Store | undefined;\n}\n/** Read-only branch catalogue and item resources. */\nexport interface MenuResource {\n  search(\n    query: string,\n    opts?: ReadOptions & { cursor?: string },\n  ): Promise<SearchPage>;\n  get(opts?: ReadOptions & { metadataOnly?: boolean }): Promise<Menu>;\n  page(\n    menuId: string,\n    categoryId: string,\n    opts?: ReadOptions & { cursor?: string },\n  ): Promise<CategoryPage>;\n  peek(branch?: string): Menu | undefined;\n  version(opts?: ReadOptions): Promise<MenuVersion>;\n  item(id: string, opts?: ReadOptions): Promise<Item>;\n  hydrate(menu: Menu): void;\n}\n/** A storefront client and its isolated resource state. */\nexport type Zappie = ReturnType<typeof buildClient>;\nexport function buildClient(input: ZappieConfig, secret = false) {\n  const mode = validateConfig(input, secret);\n  const config = Object.freeze({\n    ...input,\n    version: input.version ?? API_VERSION,\n    telemetry: input.telemetry ?? true,\n  });\n  const transport =\n    input.transport ??\n    new RestTransport({\n      ...(input.baseUrl ? { baseUrl: input.baseUrl } : {}),\n      ...(input.fetch ? { fetch: input.fetch } : {}),\n    });\n  const events = createEmitter();\n  const cache = new Cache((error) => events.emit(\"error\", { error }));\n  const ctx = (signal?: AbortSignal) => ({\n    key: config.key,\n    version: config.version,\n    ...(signal ? { signal } : {}),\n  });\n  const store: StoreResource = {\n    get: (opts = {}) =>\n      cache.get(\n        \"store\",\n        async (signal) => ({ value: await transport.getStore(ctx(signal)) }),\n        opts.signal,\n      ),\n    peek: () => cache.snapshot<Store>(\"store\").value,\n  };\n  const resolveBranch = (value: Store, requested?: string): Branch => {\n    const selected = requested ?? config.branch;\n    const branch = selected\n      ? value.branches.find((b) => b.id === selected || b.slug === selected)\n      : (value.branches.find((b) => b.isDefault) ?? value.branches[0]);\n    if (!branch) {\n      throw new ZappieError(\n        \"branch_not_found\",\n        \"No matching storefront branch\",\n        { param: \"branch\" },\n      );\n    }\n    return branch;\n  };\n  let hydratedBranch: string | undefined;\n  const branchKey = (requested?: string) => {\n    const value = store.peek();\n    if (value) {\n      return resolveBranch(value, requested).id;\n    }\n    // A slug can't be resolved without the store. A hydrated menu is the configured\n    // branch's, so a read for that branch (by slug or id) uses it rather than missing.\n    const selected = requested ?? config.branch;\n    if (\n      hydratedBranch &&\n      (selected === undefined ||\n        selected === config.branch ||\n        selected === hydratedBranch)\n    ) {\n      return hydratedBranch;\n    }\n    return selected ?? \"default\";\n  };\n  const menuKey = (requested?: string) => `menu:${branchKey(requested)}`;\n  const menu: MenuResource = {\n    async search(query, opts = {}) {\n      if (!transport.search) {\n        throw new ZappieError(\n          \"invalid_request\",\n          \"Transport does not support search\",\n        );\n      }\n      const branch = resolveBranch(await store.get(opts), opts.branch);\n      return transport.search({\n        ...ctx(opts.signal),\n        branchId: branch.id,\n        query,\n        ...(opts.cursor ? { cursor: opts.cursor } : {}),\n      });\n    },\n    async get(opts = {}) {\n      const branch = resolveBranch(await store.get(opts), opts.branch);\n      return cache.get<Menu>(\n        `menu:${branch.id}${opts.metadataOnly ? \":partial\" : \"\"}`,\n        async (signal, entry) => {\n          const response = await transport.getMenu({\n            ...ctx(signal),\n            branchId: branch.id,\n            ...(opts.metadataOnly ? { metadataOnly: true } : {}),\n            ...(entry.etag ? { ifNoneMatch: entry.etag } : {}),\n          });\n          if (\"notModified\" in response) {\n            if (!entry.value) {\n              throw new ZappieError(\n                \"server_error\",\n                \"Received 304 without a cached menu\",\n              );\n            }\n            return {\n              value: entry.value,\n              ...((response.etag ?? entry.etag)\n                ? { etag: response.etag ?? entry.etag }\n                : {}),\n            };\n          }\n          if (!opts.metadataOnly && response.menu.completeness === \"partial\") {\n            throw new ZappieError(\n              \"server_error\",\n              \"Partial catalogue cannot satisfy a complete read\",\n            );\n          }\n          if (response.menu.branchId !== branch.id) {\n            throw new ZappieError(\n              \"server_error\",\n              \"Menu belongs to a different branch\",\n            );\n          }\n          return {\n            value: response.menu,\n            etag: response.etag ?? response.menu.version,\n            onStored: () => {\n              if (\n                entry.value &&\n                entry.value.version !== response.menu.version\n              ) {\n                events.emit(\"menu:updated\", {\n                  branchId: branch.id,\n                  version: response.menu.version,\n                });\n              }\n            },\n          };\n        },\n        opts.signal,\n      );\n    },\n    peek: (branch) =>\n      cache.snapshot<Menu>(menuKey(branch)).value ??\n      cache.snapshot<Menu>(`${menuKey(branch)}:partial`).value,\n    async page(menuId, categoryId, opts = {}) {\n      if (!transport.getCategoryPage) {\n        throw new ZappieError(\n          \"invalid_request\",\n          \"Transport does not support category pages\",\n        );\n      }\n      const branch = resolveBranch(await store.get(opts), opts.branch);\n      return transport.getCategoryPage({\n        ...ctx(opts.signal),\n        branchId: branch.id,\n        menuId,\n        categoryId,\n        ...(opts.cursor ? { cursor: opts.cursor } : {}),\n      });\n    },\n    async version(opts = {}) {\n      const branch = resolveBranch(await store.get(opts), opts.branch);\n      return transport.getMenuVersion({\n        ...ctx(opts.signal),\n        branchId: branch.id,\n      });\n    },\n    async item(id, opts = {}) {\n      const branch = resolveBranch(await store.get(opts), opts.branch);\n      if (\n        !menu.peek(branch.id) ||\n        menu.peek(branch.id)?.completeness === \"partial\"\n      ) {\n        await menu.get({ ...opts, metadataOnly: true });\n      }\n      return readItem(id, branch.id, false, opts.signal);\n    },\n    hydrate(value) {\n      hydratedBranch ??= value.branchId;\n      const previous = cache.snapshot<Menu>(`menu:${value.branchId}`).value;\n      cache.set(\n        `menu:${value.branchId}${value.completeness === \"partial\" ? \":partial\" : \"\"}`,\n        value,\n        value.version,\n      );\n      if (previous && previous.version !== value.version) {\n        events.emit(\"menu:updated\", {\n          branchId: value.branchId,\n          version: value.version,\n        });\n      }\n    },\n  };\n  const itemValues = new Map<string, Item>();\n  const peekItem = (id: string, branch: string) =>\n    itemValues.get(`${branch}:${id}`);\n  const readItem = async (\n    id: string,\n    branch: string,\n    fresh = false,\n    signal?: AbortSignal,\n  ) => {\n    const complete = cache.snapshot<Menu>(`menu:${branch}`).value;\n    if (!fresh && complete && Object.hasOwn(complete.items, id)) {\n      return complete.items[id]!;\n    }\n    const load = (requestSignal = signal) =>\n      transport.getItem({\n        ...ctx(requestSignal),\n        branchId: branch,\n        itemId: id,\n      });\n    try {\n      const value = fresh\n        ? await load()\n        : await cache.get(\n            `item:${branch}:${id}`,\n            async (requestSignal) => ({ value: await load(requestSignal) }),\n            signal,\n          );\n      if (fresh) {\n        cache.set(`item:${branch}:${id}`, value);\n      }\n      itemValues.set(`${branch}:${id}`, value);\n      return value;\n    } catch (error) {\n      if ((error as { code?: string }).code === \"item_not_found\") {\n        itemValues.delete(`${branch}:${id}`);\n        cache.set(`item:${branch}:${id}`, undefined);\n      }\n      throw error;\n    }\n  };\n  const workingSet = createWorkingSet({\n    menu,\n    store,\n    transport,\n    context: ctx,\n    peekItem,\n    readItem,\n  });\n  const { cart, setLegacyReader, cartCatalogue } = createCart({\n    workingSet,\n    config,\n    menu,\n    store,\n    transport,\n    context: ctx,\n    events,\n  });\n  return Object.freeze({\n    cart,\n    config,\n    mode,\n    store,\n    menu,\n    format,\n    on: events.on,\n    _internal: {\n      cartCatalogue,\n      setLegacyReader,\n      transport,\n      cache,\n      emit: events.emit,\n      menuKey,\n      hydrateStore: (value: Store) => cache.set(\"store\", value),\n    },\n  });\n}\n/** Create a client with your publishable key. Requests start when you read a resource. */\nexport function createZappie(config: ZappieConfig) {\n  const client = buildClient(config);\n  if (client.mode === \"test\" && typeof window !== \"undefined\") {\n    void import(\"./debug\").then(({ installDebug }) => installDebug(client));\n  }\n  return client;\n}\nexport type { ZappieEvents };\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { createCart } from \"./cart\";\nimport { createWorkingSet } from \"./cart/working-set\";\nimport type { ZappieConfig } from \"./config\";\nimport { API_VERSION, validateConfig } from \"./config\";\nimport { ZappieError } from \"./errors\";\nimport { Cache } from \"./internal/cache\";\nimport type { ZappieEvents } from \"./internal/emitter\";\nimport { createEmitter } from \"./internal/emitter\";\nimport type { Branch, CategoryPage, Item, Menu, Store } from \"./models\";\nimport { format } from \"./money\";\nimport { RestTransport } from \"./transport/rest\";\nimport type { MenuVersion, SearchPage } from \"./transport/types\";\n/** A catalogue fulfilment mode accepted by menu reads. */\nexport type MenuFulfilment = \"delivery\" | \"pickup\" | \"dineIn\";\n/** Optional branch selection and cancellation for resource reads. */\nexport type ReadOptions = { branch?: string; signal?: AbortSignal };\n/** Optional branch and fulfilment selection for catalogue reads. */\nexport type MenuReadOptions = ReadOptions & { fulfilment?: MenuFulfilment };\n/** Read-only store resource. */\nexport interface StoreResource {\n  get(opts?: { signal?: AbortSignal }): Promise<Store>;\n  peek(): Store | undefined;\n}\n/** Read-only branch catalogue and item resources. */\nexport interface MenuResource {\n  search(\n    query: string,\n    opts?: ReadOptions & { cursor?: string },\n  ): Promise<SearchPage>;\n  get(opts?: MenuReadOptions & { metadataOnly?: boolean }): Promise<Menu>;\n  page(\n    menuId: string,\n    categoryId: string,\n    opts?: ReadOptions & { cursor?: string },\n  ): Promise<CategoryPage>;\n  peek(branch?: string): Menu | undefined;\n  version(opts?: MenuReadOptions): Promise<MenuVersion>;\n  item(id: string, opts?: ReadOptions): Promise<Item>;\n  hydrate(menu: Menu): void;\n}\n/** A storefront client and its isolated resource state. */\nexport type Zappie = ReturnType<typeof buildClient>;\nexport function buildClient(input: ZappieConfig, secret = false) {\n  const mode = validateConfig(input, secret);\n  const config = Object.freeze({\n    ...input,\n    version: input.version ?? API_VERSION,\n    telemetry: input.telemetry ?? true,\n  });\n  const transport =\n    input.transport ??\n    new RestTransport({\n      ...(input.baseUrl ? { baseUrl: input.baseUrl } : {}),\n      ...(input.fetch ? { fetch: input.fetch } : {}),\n    });\n  const events = createEmitter();\n  const cache = new Cache((error) => events.emit(\"error\", { error }));\n  const ctx = (signal?: AbortSignal) => ({\n    key: config.key,\n    version: config.version,\n    ...(signal ? { signal } : {}),\n  });\n  const store: StoreResource = {\n    get: (opts = {}) =>\n      cache.get(\n        \"store\",\n        async (signal) => ({ value: await transport.getStore(ctx(signal)) }),\n        opts.signal,\n      ),\n    peek: () => cache.snapshot<Store>(\"store\").value,\n  };\n  const resolveBranch = (value: Store, requested?: string): Branch => {\n    const selected = requested ?? config.branch;\n    const branch = selected\n      ? value.branches.find((b) => b.id === selected || b.slug === selected)\n      : (value.branches.find((b) => b.isDefault) ?? value.branches[0]);\n    if (!branch) {\n      throw new ZappieError(\n        \"branch_not_found\",\n        \"No matching storefront branch\",\n        { param: \"branch\" },\n      );\n    }\n    return branch;\n  };\n  let hydratedBranch: string | undefined;\n  const branchKey = (requested?: string) => {\n    const value = store.peek();\n    if (value) {\n      return resolveBranch(value, requested).id;\n    }\n    // A slug can't be resolved without the store. A hydrated menu is the configured\n    // branch's, so a read for that branch (by slug or id) uses it rather than missing.\n    const selected = requested ?? config.branch;\n    if (\n      hydratedBranch &&\n      (selected === undefined ||\n        selected === config.branch ||\n        selected === hydratedBranch)\n    ) {\n      return hydratedBranch;\n    }\n    return selected ?? \"default\";\n  };\n  const menuKey = (requested?: string) => `menu:${branchKey(requested)}`;\n  const menu: MenuResource = {\n    async search(query, opts = {}) {\n      if (!transport.search) {\n        throw new ZappieError(\n          \"invalid_request\",\n          \"Transport does not support search\",\n        );\n      }\n      const branch = resolveBranch(await store.get(opts), opts.branch);\n      return transport.search({\n        ...ctx(opts.signal),\n        branchId: branch.id,\n        query,\n        ...(opts.cursor ? { cursor: opts.cursor } : {}),\n      });\n    },\n    async get(opts = {}) {\n      const branch = resolveBranch(await store.get(opts), opts.branch);\n      return cache.get<Menu>(\n        `${menuKey(branch.id)}${opts.fulfilment ? `:${opts.fulfilment}` : \"\"}${opts.metadataOnly ? \":partial\" : \"\"}`,\n        async (signal, entry) => {\n          const response = await transport.getMenu({\n            ...ctx(signal),\n            branchId: branch.id,\n            fulfilment: opts.fulfilment,\n            ...(opts.metadataOnly ? { metadataOnly: true } : {}),\n            ...(entry.etag ? { ifNoneMatch: entry.etag } : {}),\n          });\n          if (\"notModified\" in response) {\n            if (!entry.value) {\n              throw new ZappieError(\n                \"server_error\",\n                \"Received 304 without a cached menu\",\n              );\n            }\n            return {\n              value: entry.value,\n              ...((response.etag ?? entry.etag)\n                ? { etag: response.etag ?? entry.etag }\n                : {}),\n            };\n          }\n          if (!opts.metadataOnly && response.menu.completeness === \"partial\") {\n            throw new ZappieError(\n              \"server_error\",\n              \"Partial catalogue cannot satisfy a complete read\",\n            );\n          }\n          if (response.menu.branchId !== branch.id) {\n            throw new ZappieError(\n              \"server_error\",\n              \"Menu belongs to a different branch\",\n            );\n          }\n          return {\n            value: response.menu,\n            etag: response.etag ?? response.menu.version,\n            onStored: () => {\n              if (\n                entry.value &&\n                entry.value.version !== response.menu.version\n              ) {\n                events.emit(\"menu:updated\", {\n                  branchId: branch.id,\n                  version: response.menu.version,\n                });\n              }\n            },\n          };\n        },\n        opts.signal,\n      );\n    },\n    peek: (branch) =>\n      cache.snapshot<Menu>(menuKey(branch)).value ??\n      cache.snapshot<Menu>(`${menuKey(branch)}:partial`).value,\n    async page(menuId, categoryId, opts = {}) {\n      if (!transport.getCategoryPage) {\n        throw new ZappieError(\n          \"invalid_request\",\n          \"Transport does not support category pages\",\n        );\n      }\n      const branch = resolveBranch(await store.get(opts), opts.branch);\n      return transport.getCategoryPage({\n        ...ctx(opts.signal),\n        branchId: branch.id,\n        menuId,\n        categoryId,\n        ...(opts.cursor ? { cursor: opts.cursor } : {}),\n      });\n    },\n    async version(opts = {}) {\n      const branch = resolveBranch(await store.get(opts), opts.branch);\n      return transport.getMenuVersion({\n        ...ctx(opts.signal),\n        branchId: branch.id,\n        fulfilment: opts.fulfilment,\n      });\n    },\n    async item(id, opts = {}) {\n      const branch = resolveBranch(await store.get(opts), opts.branch);\n      if (\n        !menu.peek(branch.id) ||\n        menu.peek(branch.id)?.completeness === \"partial\"\n      ) {\n        await menu.get({ ...opts, metadataOnly: true });\n      }\n      return readItem(id, branch.id, false, opts.signal);\n    },\n    hydrate(value) {\n      hydratedBranch ??= value.branchId;\n      const previous = cache.snapshot<Menu>(`menu:${value.branchId}`).value;\n      cache.set(\n        `menu:${value.branchId}${value.completeness === \"partial\" ? \":partial\" : \"\"}`,\n        value,\n        value.version,\n      );\n      if (previous && previous.version !== value.version) {\n        events.emit(\"menu:updated\", {\n          branchId: value.branchId,\n          version: value.version,\n        });\n      }\n    },\n  };\n  const itemValues = new Map<string, Item>();\n  const peekItem = (id: string, branch: string) =>\n    itemValues.get(`${branch}:${id}`);\n  const readItem = async (\n    id: string,\n    branch: string,\n    fresh = false,\n    signal?: AbortSignal,\n  ) => {\n    const complete = cache.snapshot<Menu>(`menu:${branch}`).value;\n    if (!fresh && complete && Object.hasOwn(complete.items, id)) {\n      return complete.items[id]!;\n    }\n    const load = (requestSignal = signal) =>\n      transport.getItem({\n        ...ctx(requestSignal),\n        branchId: branch,\n        itemId: id,\n      });\n    try {\n      const value = fresh\n        ? await load()\n        : await cache.get(\n            `item:${branch}:${id}`,\n            async (requestSignal) => ({ value: await load(requestSignal) }),\n            signal,\n          );\n      if (fresh) {\n        cache.set(`item:${branch}:${id}`, value);\n      }\n      itemValues.set(`${branch}:${id}`, value);\n      return value;\n    } catch (error) {\n      if ((error as { code?: string }).code === \"item_not_found\") {\n        itemValues.delete(`${branch}:${id}`);\n        cache.set(`item:${branch}:${id}`, undefined);\n      }\n      throw error;\n    }\n  };\n  const workingSet = createWorkingSet({\n    menu,\n    store,\n    transport,\n    context: ctx,\n    peekItem,\n    readItem,\n  });\n  const { cart, setLegacyReader, cartCatalogue } = createCart({\n    workingSet,\n    config,\n    menu,\n    store,\n    transport,\n    context: ctx,\n    events,\n  });\n  return Object.freeze({\n    cart,\n    config,\n    mode,\n    store,\n    menu,\n    format,\n    on: events.on,\n    _internal: {\n      cartCatalogue,\n      setLegacyReader,\n      transport,\n      cache,\n      emit: events.emit,\n      menuKey,\n      hydrateStore: (value: Store) => cache.set(\"store\", value),\n    },\n  });\n}\n/** Create a client with your publishable key. Requests start when you read a resource. */\nexport function createZappie(config: ZappieConfig) {\n  const client = buildClient(config);\n  if (client.mode === \"test\" && typeof window !== \"undefined\") {\n    void import(\"./debug\").then(({ installDebug }) => installDebug(client));\n  }\n  return client;\n}\nexport type { ZappieEvents };\n"],
+  "mappings": ";AAAA,SAAS,kBAAkB;AAC3B,SAAS,wBAAwB;AAEjC,SAAS,aAAa,sBAAsB;AAC5C,SAAS,mBAAmB;AAC5B,SAAS,aAAa;AAEtB,SAAS,qBAAqB;AAE9B,SAAS,cAAc;AACvB,SAAS,qBAAqB;AAgCvB,SAAS,YAAY,OAAqB,SAAS,OAAO;AAC/D,QAAM,OAAO,eAAe,OAAO,MAAM;AACzC,QAAM,SAAS,OAAO,OAAO;AAAA,IAC3B,GAAG;AAAA,IACH,SAAS,MAAM,WAAW;AAAA,IAC1B,WAAW,MAAM,aAAa;AAAA,EAChC,CAAC;AACD,QAAM,YACJ,MAAM,aACN,IAAI,cAAc;AAAA,IAChB,GAAI,MAAM,UAAU,EAAE,SAAS,MAAM,QAAQ,IAAI,CAAC;AAAA,IAClD,GAAI,MAAM,QAAQ,EAAE,OAAO,MAAM,MAAM,IAAI,CAAC;AAAA,EAC9C,CAAC;AACH,QAAM,SAAS,cAAc;AAC7B,QAAM,QAAQ,IAAI,MAAM,CAAC,UAAU,OAAO,KAAK,SAAS,EAAE,MAAM,CAAC,CAAC;AAClE,QAAM,MAAM,CAAC,YAA0B;AAAA,IACrC,KAAK,OAAO;AAAA,IACZ,SAAS,OAAO;AAAA,IAChB,GAAI,SAAS,EAAE,OAAO,IAAI,CAAC;AAAA,EAC7B;AACA,QAAM,QAAuB;AAAA,IAC3B,KAAK,CAAC,OAAO,CAAC,MACZ,MAAM;AAAA,MACJ;AAAA,MACA,OAAO,YAAY,EAAE,OAAO,MAAM,UAAU,SAAS,IAAI,MAAM,CAAC,EAAE;AAAA,MAClE,KAAK;AAAA,IACP;AAAA,IACF,MAAM,MAAM,MAAM,SAAgB,OAAO,EAAE;AAAA,EAC7C;AACA,QAAM,gBAAgB,CAAC,OAAc,cAA+B;AAClE,UAAM,WAAW,aAAa,OAAO;AACrC,UAAM,SAAS,WACX,MAAM,SAAS,KAAK,CAAC,MAAM,EAAE,OAAO,YAAY,EAAE,SAAS,QAAQ,IAClE,MAAM,SAAS,KAAK,CAAC,MAAM,EAAE,SAAS,KAAK,MAAM,SAAS,CAAC;AAChE,QAAI,CAAC,QAAQ;AACX,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,QACA,EAAE,OAAO,SAAS;AAAA,MACpB;AAAA,IACF;AACA,WAAO;AAAA,EACT;AACA,MAAI;AACJ,QAAM,YAAY,CAAC,cAAuB;AACxC,UAAM,QAAQ,MAAM,KAAK;AACzB,QAAI,OAAO;AACT,aAAO,cAAc,OAAO,SAAS,EAAE;AAAA,IACzC;AAGA,UAAM,WAAW,aAAa,OAAO;AACrC,QACE,mBACC,aAAa,UACZ,aAAa,OAAO,UACpB,aAAa,iBACf;AACA,aAAO;AAAA,IACT;AACA,WAAO,YAAY;AAAA,EACrB;AACA,QAAM,UAAU,CAAC,cAAuB,QAAQ,UAAU,SAAS,CAAC;AACpE,QAAM,OAAqB;AAAA,IACzB,MAAM,OAAO,OAAO,OAAO,CAAC,GAAG;AAC7B,UAAI,CAAC,UAAU,QAAQ;AACrB,cAAM,IAAI;AAAA,UACR;AAAA,UACA;AAAA,QACF;AAAA,MACF;AACA,YAAM,SAAS,cAAc,MAAM,MAAM,IAAI,IAAI,GAAG,KAAK,MAAM;AAC/D,aAAO,UAAU,OAAO;AAAA,QACtB,GAAG,IAAI,KAAK,MAAM;AAAA,QAClB,UAAU,OAAO;AAAA,QACjB;AAAA,QACA,GAAI,KAAK,SAAS,EAAE,QAAQ,KAAK,OAAO,IAAI,CAAC;AAAA,MAC/C,CAAC;AAAA,IACH;AAAA,IACA,MAAM,IAAI,OAAO,CAAC,GAAG;AACnB,YAAM,SAAS,cAAc,MAAM,MAAM,IAAI,IAAI,GAAG,KAAK,MAAM;AAC/D,aAAO,MAAM;AAAA,QACX,GAAG,QAAQ,OAAO,EAAE,CAAC,GAAG,KAAK,aAAa,IAAI,KAAK,UAAU,KAAK,EAAE,GAAG,KAAK,eAAe,aAAa,EAAE;AAAA,QAC1G,OAAO,QAAQ,UAAU;AACvB,gBAAM,WAAW,MAAM,UAAU,QAAQ;AAAA,YACvC,GAAG,IAAI,MAAM;AAAA,YACb,UAAU,OAAO;AAAA,YACjB,YAAY,KAAK;AAAA,YACjB,GAAI,KAAK,eAAe,EAAE,cAAc,KAAK,IAAI,CAAC;AAAA,YAClD,GAAI,MAAM,OAAO,EAAE,aAAa,MAAM,KAAK,IAAI,CAAC;AAAA,UAClD,CAAC;AACD,cAAI,iBAAiB,UAAU;AAC7B,gBAAI,CAAC,MAAM,OAAO;AAChB,oBAAM,IAAI;AAAA,gBACR;AAAA,gBACA;AAAA,cACF;AAAA,YACF;AACA,mBAAO;AAAA,cACL,OAAO,MAAM;AAAA,cACb,GAAK,SAAS,QAAQ,MAAM,OACxB,EAAE,MAAM,SAAS,QAAQ,MAAM,KAAK,IACpC,CAAC;AAAA,YACP;AAAA,UACF;AACA,cAAI,CAAC,KAAK,gBAAgB,SAAS,KAAK,iBAAiB,WAAW;AAClE,kBAAM,IAAI;AAAA,cACR;AAAA,cACA;AAAA,YACF;AAAA,UACF;AACA,cAAI,SAAS,KAAK,aAAa,OAAO,IAAI;AACxC,kBAAM,IAAI;AAAA,cACR;AAAA,cACA;AAAA,YACF;AAAA,UACF;AACA,iBAAO;AAAA,YACL,OAAO,SAAS;AAAA,YAChB,MAAM,SAAS,QAAQ,SAAS,KAAK;AAAA,YACrC,UAAU,MAAM;AACd,kBACE,MAAM,SACN,MAAM,MAAM,YAAY,SAAS,KAAK,SACtC;AACA,uBAAO,KAAK,gBAAgB;AAAA,kBAC1B,UAAU,OAAO;AAAA,kBACjB,SAAS,SAAS,KAAK;AAAA,gBACzB,CAAC;AAAA,cACH;AAAA,YACF;AAAA,UACF;AAAA,QACF;AAAA,QACA,KAAK;AAAA,MACP;AAAA,IACF;AAAA,IACA,MAAM,CAAC,WACL,MAAM,SAAe,QAAQ,MAAM,CAAC,EAAE,SACtC,MAAM,SAAe,GAAG,QAAQ,MAAM,CAAC,UAAU,EAAE;AAAA,IACrD,MAAM,KAAK,QAAQ,YAAY,OAAO,CAAC,GAAG;AACxC,UAAI,CAAC,UAAU,iBAAiB;AAC9B,cAAM,IAAI;AAAA,UACR;AAAA,UACA;AAAA,QACF;AAAA,MACF;AACA,YAAM,SAAS,cAAc,MAAM,MAAM,IAAI,IAAI,GAAG,KAAK,MAAM;AAC/D,aAAO,UAAU,gBAAgB;AAAA,QAC/B,GAAG,IAAI,KAAK,MAAM;AAAA,QAClB,UAAU,OAAO;AAAA,QACjB;AAAA,QACA;AAAA,QACA,GAAI,KAAK,SAAS,EAAE,QAAQ,KAAK,OAAO,IAAI,CAAC;AAAA,MAC/C,CAAC;AAAA,IACH;AAAA,IACA,MAAM,QAAQ,OAAO,CAAC,GAAG;AACvB,YAAM,SAAS,cAAc,MAAM,MAAM,IAAI,IAAI,GAAG,KAAK,MAAM;AAC/D,aAAO,UAAU,eAAe;AAAA,QAC9B,GAAG,IAAI,KAAK,MAAM;AAAA,QAClB,UAAU,OAAO;AAAA,QACjB,YAAY,KAAK;AAAA,MACnB,CAAC;AAAA,IACH;AAAA,IACA,MAAM,KAAK,IAAI,OAAO,CAAC,GAAG;AACxB,YAAM,SAAS,cAAc,MAAM,MAAM,IAAI,IAAI,GAAG,KAAK,MAAM;AAC/D,UACE,CAAC,KAAK,KAAK,OAAO,EAAE,KACpB,KAAK,KAAK,OAAO,EAAE,GAAG,iBAAiB,WACvC;AACA,cAAM,KAAK,IAAI,EAAE,GAAG,MAAM,cAAc,KAAK,CAAC;AAAA,MAChD;AACA,aAAO,SAAS,IAAI,OAAO,IAAI,OAAO,KAAK,MAAM;AAAA,IACnD;AAAA,IACA,QAAQ,OAAO;AACb,0CAAmB,MAAM;AACzB,YAAM,WAAW,MAAM,SAAe,QAAQ,MAAM,QAAQ,EAAE,EAAE;AAChE,YAAM;AAAA,QACJ,QAAQ,MAAM,QAAQ,GAAG,MAAM,iBAAiB,YAAY,aAAa,EAAE;AAAA,QAC3E;AAAA,QACA,MAAM;AAAA,MACR;AACA,UAAI,YAAY,SAAS,YAAY,MAAM,SAAS;AAClD,eAAO,KAAK,gBAAgB;AAAA,UAC1B,UAAU,MAAM;AAAA,UAChB,SAAS,MAAM;AAAA,QACjB,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AACA,QAAM,aAAa,oBAAI,IAAkB;AACzC,QAAM,WAAW,CAAC,IAAY,WAC5B,WAAW,IAAI,GAAG,MAAM,IAAI,EAAE,EAAE;AAClC,QAAM,WAAW,OACf,IACA,QACA,QAAQ,OACR,WACG;AACH,UAAM,WAAW,MAAM,SAAe,QAAQ,MAAM,EAAE,EAAE;AACxD,QAAI,CAAC,SAAS,YAAY,OAAO,OAAO,SAAS,OAAO,EAAE,GAAG;AAC3D,aAAO,SAAS,MAAM,EAAE;AAAA,IAC1B;AACA,UAAM,OAAO,CAAC,gBAAgB,WAC5B,UAAU,QAAQ;AAAA,MAChB,GAAG,IAAI,aAAa;AAAA,MACpB,UAAU;AAAA,MACV,QAAQ;AAAA,IACV,CAAC;AACH,QAAI;AACF,YAAM,QAAQ,QACV,MAAM,KAAK,IACX,MAAM,MAAM;AAAA,QACV,QAAQ,MAAM,IAAI,EAAE;AAAA,QACpB,OAAO,mBAAmB,EAAE,OAAO,MAAM,KAAK,aAAa,EAAE;AAAA,QAC7D;AAAA,MACF;AACJ,UAAI,OAAO;AACT,cAAM,IAAI,QAAQ,MAAM,IAAI,EAAE,IAAI,KAAK;AAAA,MACzC;AACA,iBAAW,IAAI,GAAG,MAAM,IAAI,EAAE,IAAI,KAAK;AACvC,aAAO;AAAA,IACT,SAAS,OAAO;AACd,UAAK,MAA4B,SAAS,kBAAkB;AAC1D,mBAAW,OAAO,GAAG,MAAM,IAAI,EAAE,EAAE;AACnC,cAAM,IAAI,QAAQ,MAAM,IAAI,EAAE,IAAI,MAAS;AAAA,MAC7C;AACA,YAAM;AAAA,IACR;AAAA,EACF;AACA,QAAM,aAAa,iBAAiB;AAAA,IAClC;AAAA,IACA;AAAA,IACA;AAAA,IACA,SAAS;AAAA,IACT;AAAA,IACA;AAAA,EACF,CAAC;AACD,QAAM,EAAE,MAAM,iBAAiB,cAAc,IAAI,WAAW;AAAA,IAC1D;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,SAAS;AAAA,IACT;AAAA,EACF,CAAC;AACD,SAAO,OAAO,OAAO;AAAA,IACnB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,IAAI,OAAO;AAAA,IACX,WAAW;AAAA,MACT;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,MAAM,OAAO;AAAA,MACb;AAAA,MACA,cAAc,CAAC,UAAiB,MAAM,IAAI,SAAS,KAAK;AAAA,IAC1D;AAAA,EACF,CAAC;AACH;AAEO,SAAS,aAAa,QAAsB;AACjD,QAAM,SAAS,YAAY,MAAM;AACjC,MAAI,OAAO,SAAS,UAAU,OAAO,WAAW,aAAa;AAC3D,SAAK,OAAO,YAAS,EAAE,KAAK,CAAC,EAAE,aAAa,MAAM,aAAa,MAAM,CAAC;AAAA,EACxE;AACA,SAAO;AACT;",
   "names": []
 }

package/dist/config/index.d.ts

@@ -36,6 +36,17 @@ type ZappieSiteConfig = {
             reason: string;
         };
     };
+    /** Records explained exceptions to storefront readiness checks. */
+    readiness?: {
+        /** Lets this site skip the initial route discovery requirement. */
+        routeDiscovery?: {
+            /** Explains why this site does not use initial route discovery. */
+            optOut: {
+                /** States the constraint that prevents initial route discovery. */
+                reason: string;
+            };
+        };
+    };
     analytics?: {
         forward?: {
             ga4?: string;

package/dist/config.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/config.ts"],
-  "sourcesContent": ["import { ZappieError } from \"./errors\";\nimport type { Transport } from \"./transport/types\";\n/** Release-pinned REST contract version, independent of the package version. */\nexport const API_VERSION = \"2026-10-01\";\n/** A storage adapter you can supply to save carts. */\nexport interface StorageLike {\n  getItem(key: string): string | null;\n  setItem(key: string, value: string): void;\n  removeItem(key: string): void;\n  /** Provide length and key to let the SDK remove expired carts for this store. */\n  readonly length?: number;\n  key?(index: number): string | null;\n}\n/** Settings for your storefront client. Each client keeps its own credentials and caches. */\nexport type ZappieConfig = {\n  store: string;\n  key: string;\n  branch?: string;\n  transport?: Transport;\n  baseUrl?: string;\n  version?: string;\n  fetch?: typeof fetch;\n  storage?: StorageLike;\n  telemetry?: boolean;\n  cart?: { ttl?: number; storageScope?: string };\n};\nexport function validateConfig(config: ZappieConfig, secret = false) {\n  if (!config.store?.trim()) {\n    throw new ZappieError(\"invalid_request\", \"A storefront slug is required\");\n  }\n  if (secret && typeof window !== \"undefined\") {\n    throw new ZappieError(\n      \"invalid_request\",\n      \"Secret keys cannot be used in a browser\",\n    );\n  }\n  const pattern = secret ? /^sk_(test|live)_.+$/ : /^pk_(test|live)_.+$/;\n  const match = pattern.exec(config.key);\n  if (!match) {\n    throw new ZappieError(\n      \"invalid_request\",\n      secret\n        ? \"A secret sk_test_ or sk_live_ key is required\"\n        : \"Use a publishable pk_test_ or pk_live_ key; secret keys are never accepted by createZappie\",\n    );\n  }\n  return match[1] as \"test\" | \"live\";\n}\n"],
-  "mappings": ";AAAA,SAAS,mBAAmB;AAGrB,IAAM,cAAc;AAuBpB,SAAS,eAAe,QAAsB,SAAS,OAAO;AACnE,MAAI,CAAC,OAAO,OAAO,KAAK,GAAG;AACzB,UAAM,IAAI,YAAY,mBAAmB,+BAA+B;AAAA,EAC1E;AACA,MAAI,UAAU,OAAO,WAAW,aAAa;AAC3C,UAAM,IAAI;AAAA,MACR;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACA,QAAM,UAAU,SAAS,wBAAwB;AACjD,QAAM,QAAQ,QAAQ,KAAK,OAAO,GAAG;AACrC,MAAI,CAAC,OAAO;AACV,UAAM,IAAI;AAAA,MACR;AAAA,MACA,SACI,kDACA;AAAA,IACN;AAAA,EACF;AACA,SAAO,MAAM,CAAC;AAChB;",
+  "sourcesContent": ["import { ZappieError } from \"./errors\";\nimport type { Transport } from \"./transport/types\";\n/** Release-pinned REST contract version, independent of the package version. */\nexport const API_VERSION = \"2026-10-01\";\n/** A storage adapter you can supply to save carts. */\nexport interface StorageLike {\n  getItem(key: string): string | null;\n  setItem(key: string, value: string): void;\n  removeItem(key: string): void;\n  /** Provide length and key to let the SDK remove expired carts for this store. */\n  readonly length?: number;\n  key?(index: number): string | null;\n}\n/** Settings for your storefront client. Each client keeps its own credentials and caches. */\nexport type ZappieConfig = {\n  store: string;\n  key: string;\n  branch?: string;\n  transport?: Transport;\n  baseUrl?: string;\n  version?: string;\n  fetch?: typeof fetch;\n  /** Route cart quotes through the same-origin customer channel when set. */\n  customerBase?: string;\n  storage?: StorageLike;\n  telemetry?: boolean;\n  cart?: { ttl?: number; storageScope?: string };\n};\nexport function validateConfig(config: ZappieConfig, secret = false) {\n  if (!config.store?.trim()) {\n    throw new ZappieError(\"invalid_request\", \"A storefront slug is required\");\n  }\n  if (secret && typeof window !== \"undefined\") {\n    throw new ZappieError(\n      \"invalid_request\",\n      \"Secret keys cannot be used in a browser\",\n    );\n  }\n  const pattern = secret ? /^sk_(test|live)_.+$/ : /^pk_(test|live)_.+$/;\n  const match = pattern.exec(config.key);\n  if (!match) {\n    throw new ZappieError(\n      \"invalid_request\",\n      secret\n        ? \"A secret sk_test_ or sk_live_ key is required\"\n        : \"Use a publishable pk_test_ or pk_live_ key; secret keys are never accepted by createZappie\",\n    );\n  }\n  return match[1] as \"test\" | \"live\";\n}\n"],
+  "mappings": ";AAAA,SAAS,mBAAmB;AAGrB,IAAM,cAAc;AAyBpB,SAAS,eAAe,QAAsB,SAAS,OAAO;AACnE,MAAI,CAAC,OAAO,OAAO,KAAK,GAAG;AACzB,UAAM,IAAI,YAAY,mBAAmB,+BAA+B;AAAA,EAC1E;AACA,MAAI,UAAU,OAAO,WAAW,aAAa;AAC3C,UAAM,IAAI;AAAA,MACR;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACA,QAAM,UAAU,SAAS,wBAAwB;AACjD,QAAM,QAAQ,QAAQ,KAAK,OAAO,GAAG;AACrC,MAAI,CAAC,OAAO;AACV,UAAM,IAAI;AAAA,MACR;AAAA,MACA,SACI,kDACA;AAAA,IACN;AAAA,EACF;AACA,SAAO,MAAM,CAAC;AAChB;",
   "names": []
 }

package/dist/debug.d.ts

@@ -1,5 +1,6 @@
-import { C as CartLineInput, Z as Zappie, a as Quote } from './client-RFcLoZ04.js';
+import { b as CartLineInput, a as Quote } from './types-CuDvfW9g.js';
 import { M as Money, a as Menu, B as Branch } from './models-Rg5kQUkv.js';
+import { Z as Zappie } from './client-Bm2cCYea.js';
 
 type StoredLine = CartLineInput & {
     id: string;

package/dist/debug.js

@@ -1,5 +1,5 @@
 // src/debug.ts
-var VERSION = true ? "0.1.4" : "0.0.0-development";
+var VERSION = true ? "0.1.6" : "0.0.0-development";
 function installDebug(client) {
   if (typeof window === "undefined" || client.mode !== "test") {
     return;

package/dist/index.d.ts

@@ -1,7 +1,9 @@
-import { T as Transport, R as RequestCtx, Q as QuoteRequest, m as WireQuote, n as MenuResponse, o as SelectedMenuRequest, p as SelectedMenuResponse, q as SearchRequest, r as SearchPage, s as MenuVersion, c as ZappieError, g as CartIssue, C as CartLineInput, e as CartLine } from './client-RFcLoZ04.js';
-export { A as API_VERSION, t as CartFix, b as CartFulfilment, u as CartIssueCode, d as CartModule, w as CartSnapshot, f as CartState, x as CartSyncAdapter, y as CartSyncDocument, D as DeliveryAddress, E as ErrorDetails, M as MenuResource, a as Quote, z as ReadOptions, S as StorageLike, i as StoreResource, B as WireFix, W as WireFulfilment, F as WireIssue, G as WireLine, H as WireMoney, Z as Zappie, h as ZappieClientOptions, h as ZappieConfig, l as ZappieErrorCode, j as ZappieEvents, I as createZappie, J as isZappieError } from './client-RFcLoZ04.js';
+import { T as Transport, R as RequestCtx, f as MenuFulfilment, g as MenuResponse, h as SelectedMenuRequest, i as SelectedMenuResponse, j as SearchRequest, k as SearchPage, l as MenuVersion, a as ZappieError } from './client-Bm2cCYea.js';
+export { A as API_VERSION, E as ErrorDetails, m as MenuReadOptions, M as MenuResource, n as ReadOptions, S as StorageLike, c as StoreResource, Z as Zappie, b as ZappieClientOptions, b as ZappieConfig, e as ZappieErrorCode, d as ZappieEvents, o as createZappie, p as isZappieError } from './client-Bm2cCYea.js';
 import { S as Store, C as CategoryPage, I as Item, O as OptionGroup, M as Money, a as Menu, B as Branch } from './models-Rg5kQUkv.js';
 export { b as Category, c as Choice, d as Currency, F as Formatters, e as Fulfilment, f as MenuSchedule, g as MenuSection, h as MoneyFormatOptions, i as OpeningTime, j as OptionCondition, P as PaymentMethodKind, k as SpecialHours, V as Variant, l as format, m as money } from './models-Rg5kQUkv.js';
+import { Q as QuoteRequest, g as WireQuote, f as CartIssue, b as CartLineInput, C as CartLine } from './types-CuDvfW9g.js';
+export { h as CartFix, c as CartFulfilment, i as CartIssueCode, d as CartModule, j as CartSnapshot, e as CartState, k as CartSyncAdapter, l as CartSyncDocument, D as DeliveryAddress, a as Quote, m as WireFix, W as WireFulfilment, n as WireIssue, o as WireLine, p as WireMoney } from './types-CuDvfW9g.js';
 
 /** REST connection options. A custom fetch can provide tracing or mock responses. */
 type RestTransportOptions = {
@@ -21,6 +23,7 @@ declare class RestTransport implements Transport {
         branchId: string;
         ifNoneMatch?: string;
         metadataOnly?: boolean;
+        fulfilment?: MenuFulfilment;
     }): Promise<MenuResponse>;
     getSelectedMenu(ctx: SelectedMenuRequest): Promise<SelectedMenuResponse>;
     search(ctx: SearchRequest): Promise<SearchPage>;
@@ -32,6 +35,7 @@ declare class RestTransport implements Transport {
     }): Promise<CategoryPage>;
     getMenuVersion(ctx: RequestCtx & {
         branchId: string;
+        fulfilment?: MenuFulfilment;
     }): Promise<MenuVersion>;
     getItem(ctx: RequestCtx & {
         branchId: string;
@@ -81,4 +85,4 @@ declare function validateLine(item: Item | undefined, raw: CartLineInput, ctx: {
 /** The installed @zappie/sdk version. */
 declare const VERSION: string;
 
-export { Branch, CartIssue, CartLine, CartLineInput, CategoryPage, Item, Menu, MenuResponse, MenuVersion, Money, OptionGroup, QuoteRequest, RequestCtx, RestTransport, type RestTransportOptions, SearchPage, SearchRequest, Store, Transport, VERSION, WireQuote, ZappieCartError, ZappieError, estimateUnitPrice, previewItem, resolveSourceMenu, validateLine };
+export { Branch, CartIssue, CartLine, CartLineInput, CategoryPage, Item, Menu, MenuFulfilment, MenuResponse, MenuVersion, Money, OptionGroup, QuoteRequest, RequestCtx, RestTransport, type RestTransportOptions, SearchPage, SearchRequest, Store, Transport, VERSION, WireQuote, ZappieCartError, ZappieError, estimateUnitPrice, previewItem, resolveSourceMenu, validateLine };

package/dist/index.js

@@ -10,7 +10,7 @@ import { previewItem } from "./cart/preview.js";
 import { estimateUnitPrice } from "./cart/price.js";
 import { resolveSourceMenu } from "./cart/source-menu.js";
 import { validateLine } from "./cart/validate.js";
-var VERSION = true ? "0.1.4" : "0.0.0-development";
+var VERSION = true ? "0.1.6" : "0.0.0-development";
 export {
   API_VERSION,
   RestTransport,

package/dist/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/index.ts"],
-  "sourcesContent": ["// tsup replaces __ZAPPIE_SDK_VERSION__ with package.json's version. Source run\n// without a build, as in a plain Node script, gets the development label.\n// Kept inline, not in a shared module, so the core chunks don't split differently.\ndeclare const __ZAPPIE_SDK_VERSION__: string | undefined;\n\n/** The installed @zappie/sdk version. */\nexport const VERSION: string =\n  typeof __ZAPPIE_SDK_VERSION__ === \"string\"\n    ? __ZAPPIE_SDK_VERSION__\n    : \"0.0.0-development\";\nexport { createZappie } from \"./client\";\nexport type {\n  MenuResource,\n  ReadOptions,\n  StoreResource,\n  Zappie,\n  ZappieEvents,\n} from \"./client\";\nexport { API_VERSION } from \"./config\";\nexport type {\n  StorageLike,\n  ZappieConfig as ZappieClientOptions,\n  ZappieConfig,\n} from \"./config\";\nexport { ZappieError, isZappieError } from \"./errors\";\nexport type { ErrorDetails, ZappieErrorCode } from \"./errors\";\nexport * from \"./models\";\nexport { format, money } from \"./money\";\nexport type { Currency, Formatters, Money, MoneyFormatOptions } from \"./money\";\nexport { RestTransport } from \"./transport/rest\";\nexport type { RestTransportOptions } from \"./transport/rest\";\nexport type {\n  MenuResponse,\n  MenuVersion,\n  RequestCtx,\n  SearchPage,\n  SearchRequest,\n  Transport,\n} from \"./transport/types\";\n\nexport { ZappieCartError } from \"./cart/errors\";\nexport { previewItem } from \"./cart/preview\";\nexport { estimateUnitPrice } from \"./cart/price\";\nexport { resolveSourceMenu } from \"./cart/source-menu\";\nexport type * from \"./cart/types\";\nexport { validateLine } from \"./cart/validate\";\n"],
-  "mappings": ";AAUA,SAAS,oBAAoB;AAQ7B,SAAS,mBAAmB;AAM5B,SAAS,aAAa,qBAAqB;AAE3C,cAAc;AACd,SAAS,QAAQ,aAAa;AAE9B,SAAS,qBAAqB;AAW9B,SAAS,uBAAuB;AAChC,SAAS,mBAAmB;AAC5B,SAAS,yBAAyB;AAClC,SAAS,yBAAyB;AAElC,SAAS,oBAAoB;AAvCtB,IAAM,UACX,OACI,UACA;",
+  "sourcesContent": ["// tsup replaces __ZAPPIE_SDK_VERSION__ with package.json's version. Source run\n// without a build, as in a plain Node script, gets the development label.\n// Kept inline, not in a shared module, so the core chunks don't split differently.\ndeclare const __ZAPPIE_SDK_VERSION__: string | undefined;\n\n/** The installed @zappie/sdk version. */\nexport const VERSION: string =\n  typeof __ZAPPIE_SDK_VERSION__ === \"string\"\n    ? __ZAPPIE_SDK_VERSION__\n    : \"0.0.0-development\";\nexport { createZappie } from \"./client\";\nexport type {\n  MenuFulfilment,\n  MenuReadOptions,\n  MenuResource,\n  ReadOptions,\n  StoreResource,\n  Zappie,\n  ZappieEvents,\n} from \"./client\";\nexport { API_VERSION } from \"./config\";\nexport type {\n  StorageLike,\n  ZappieConfig as ZappieClientOptions,\n  ZappieConfig,\n} from \"./config\";\nexport { ZappieError, isZappieError } from \"./errors\";\nexport type { ErrorDetails, ZappieErrorCode } from \"./errors\";\nexport * from \"./models\";\nexport { format, money } from \"./money\";\nexport type { Currency, Formatters, Money, MoneyFormatOptions } from \"./money\";\nexport { RestTransport } from \"./transport/rest\";\nexport type { RestTransportOptions } from \"./transport/rest\";\nexport type {\n  MenuResponse,\n  MenuVersion,\n  RequestCtx,\n  SearchPage,\n  SearchRequest,\n  Transport,\n} from \"./transport/types\";\n\nexport { ZappieCartError } from \"./cart/errors\";\nexport { previewItem } from \"./cart/preview\";\nexport { estimateUnitPrice } from \"./cart/price\";\nexport { resolveSourceMenu } from \"./cart/source-menu\";\nexport type * from \"./cart/types\";\nexport { validateLine } from \"./cart/validate\";\n"],
+  "mappings": ";AAUA,SAAS,oBAAoB;AAU7B,SAAS,mBAAmB;AAM5B,SAAS,aAAa,qBAAqB;AAE3C,cAAc;AACd,SAAS,QAAQ,aAAa;AAE9B,SAAS,qBAAqB;AAW9B,SAAS,uBAAuB;AAChC,SAAS,mBAAmB;AAC5B,SAAS,yBAAyB;AAClC,SAAS,yBAAyB;AAElC,SAAS,oBAAoB;AAzCtB,IAAM,UACX,OACI,UACA;",
   "names": []
 }

package/dist/integrations/index.d.ts

@@ -1,5 +1,6 @@
-import { R as RequestCtx } from '../client-RFcLoZ04.js';
+import { R as RequestCtx } from '../client-Bm2cCYea.js';
 import '../models-Rg5kQUkv.js';
+import '../types-CuDvfW9g.js';
 
 /** Public tracking IDs. Your app decides when consent allows it to load scripts. */
 type Integrations = {

package/dist/internal.d.ts

@@ -1,5 +1,5 @@
-import { b as CartFulfilment, W as WireFulfilment } from './client-RFcLoZ04.js';
-export { v as validateConfig } from './client-RFcLoZ04.js';
+import { c as CartFulfilment, W as WireFulfilment } from './types-CuDvfW9g.js';
+export { v as validateConfig } from './client-Bm2cCYea.js';
 import './models-Rg5kQUkv.js';
 
 /**

package/dist/persist/catalogue.d.ts

@@ -1,2 +1,3 @@
-export { K as CATALOGUE_MAX_AGE_MS, L as CATALOGUE_MAX_BYTES, N as CatalogueScope, O as SavedCatalogue, P as catalogueDigest, U as catalogueKey, V as createCatalogueStorage, X as createSavedCatalogue } from '../client-RFcLoZ04.js';
+export { q as CATALOGUE_MAX_AGE_MS, r as CATALOGUE_MAX_BYTES, s as CatalogueScope, t as SavedCatalogue, u as catalogueDigest, w as catalogueKey, x as createCatalogueStorage, y as createSavedCatalogue } from '../client-Bm2cCYea.js';
 import '../models-Rg5kQUkv.js';
+import '../types-CuDvfW9g.js';