@zappie/sdk 0.1.3 → 0.1.5

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": "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",
   "names": []
 }

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-BctSrEhO.js';
-import { M as Money, a as Menu, B as Branch } from './models-Dj-VkdU1.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.3" : "0.0.0-development";
+var VERSION = true ? "0.1.5" : "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-BctSrEhO.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-BctSrEhO.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-Dj-VkdU1.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-Dj-VkdU1.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.3" : "0.0.0-development";
+var VERSION = true ? "0.1.5" : "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

@@ -0,0 +1,39 @@
+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 = {
+    googleAnalytics?: {
+        measurementId: string;
+    };
+    metaPixel?: {
+        pixelId: string;
+    };
+};
+/** A backend that supplies public tracking IDs without loading scripts. */
+type IntegrationsTransport = {
+    getIntegrations(ctx: RequestCtx): Promise<Integrations>;
+};
+/** Credentials and optional connection settings for the integrations read. */
+type IntegrationsOptions = {
+    key: string;
+    baseUrl?: string;
+    version?: string;
+    fetch?: typeof fetch;
+    transport?: IntegrationsTransport;
+};
+/**
+ * Create a client that reads public tracking IDs. It never loads tracking scripts.
+ * Import this entry when your app needs the IDs, then apply your consent policy.
+ */
+declare function createIntegrations(options: IntegrationsOptions): {
+    /** Read enabled integrations. An absent integration has no public ID to use. */
+    get(read?: {
+        signal?: AbortSignal;
+    }): Promise<Integrations>;
+};
+/** The integrations read returned by createIntegrations. */
+type IntegrationsClient = ReturnType<typeof createIntegrations>;
+
+export { type Integrations, type IntegrationsClient, type IntegrationsOptions, type IntegrationsTransport, createIntegrations };

package/dist/integrations/index.js

@@ -0,0 +1,78 @@
+// src/integrations/index.ts
+import { requestWithRetry } from "../internal/customer-http.js";
+import {
+  API_VERSION,
+  RestTransport,
+  validateConfig,
+  ZappieError
+} from "../places/sdk.js";
+function createIntegrations(options) {
+  validateConfig({ store: "integrations", key: options.key });
+  const base = new RestTransport(options).baseUrl;
+  return {
+    /** Read enabled integrations. An absent integration has no public ID to use. */
+    async get(read = {}) {
+      const ctx = {
+        key: options.key,
+        version: options.version ?? API_VERSION,
+        ...read
+      };
+      if (options.transport) {
+        return options.transport.getIntegrations(ctx);
+      }
+      const response = await requestWithRetry(
+        options.fetch ?? ((input, init) => globalThis.fetch(input, init)),
+        `${base}/store/integrations`,
+        {
+          redirect: "manual",
+          headers: {
+            Authorization: `Bearer ${ctx.key}`,
+            "Zappie-Version": ctx.version
+          },
+          ...read
+        },
+        "Could not read storefront integrations"
+      );
+      if (!response.ok) {
+        throw new ZappieError(
+          "server_error",
+          "Could not read storefront integrations",
+          { status: response.status }
+        );
+      }
+      const value = await response.json();
+      const record = (value2) => {
+        if (!value2 || typeof value2 !== "object" || Array.isArray(value2)) {
+          throw new ZappieError(
+            "server_error",
+            "Invalid storefront integrations"
+          );
+        }
+        return value2;
+      };
+      const raw = record(value);
+      const id = (value2, key) => {
+        const result = record(value2)[key];
+        if (typeof result !== "string" || !result) {
+          throw new ZappieError(
+            "server_error",
+            "Invalid storefront integration ID"
+          );
+        }
+        return result;
+      };
+      return {
+        ...raw.google_analytics != null ? {
+          googleAnalytics: {
+            measurementId: id(raw.google_analytics, "measurement_id")
+          }
+        } : {},
+        ...raw.meta_pixel != null ? { metaPixel: { pixelId: id(raw.meta_pixel, "pixel_id") } } : {}
+      };
+    }
+  };
+}
+export {
+  createIntegrations
+};
+//# sourceMappingURL=index.js.map

package/dist/integrations/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/integrations/index.ts"],
+  "sourcesContent": ["import { requestWithRetry } from \"../internal/customer-http\";\nimport {\n  API_VERSION,\n  RestTransport,\n  validateConfig,\n  ZappieError,\n} from \"../places/sdk\";\nimport type { RequestCtx } from \"../transport/types\";\n\n/** Public tracking IDs. Your app decides when consent allows it to load scripts. */\nexport type Integrations = {\n  googleAnalytics?: { measurementId: string };\n  metaPixel?: { pixelId: string };\n};\n\n/** A backend that supplies public tracking IDs without loading scripts. */\nexport type IntegrationsTransport = {\n  getIntegrations(ctx: RequestCtx): Promise<Integrations>;\n};\n\n/** Credentials and optional connection settings for the integrations read. */\nexport type IntegrationsOptions = {\n  key: string;\n  baseUrl?: string;\n  version?: string;\n  fetch?: typeof fetch;\n  transport?: IntegrationsTransport;\n};\n\n/**\n * Create a client that reads public tracking IDs. It never loads tracking scripts.\n * Import this entry when your app needs the IDs, then apply your consent policy.\n */\nexport function createIntegrations(options: IntegrationsOptions) {\n  validateConfig({ store: \"integrations\", key: options.key });\n  const base = new RestTransport(options).baseUrl;\n  return {\n    /** Read enabled integrations. An absent integration has no public ID to use. */\n    async get(read: { signal?: AbortSignal } = {}): Promise<Integrations> {\n      const ctx = {\n        key: options.key,\n        version: options.version ?? API_VERSION,\n        ...read,\n      };\n      if (options.transport) {\n        return options.transport.getIntegrations(ctx);\n      }\n      const response = await requestWithRetry(\n        options.fetch ?? ((input, init) => globalThis.fetch(input, init)),\n        `${base}/store/integrations`,\n        {\n          redirect: \"manual\",\n          headers: {\n            Authorization: `Bearer ${ctx.key}`,\n            \"Zappie-Version\": ctx.version,\n          },\n          ...read,\n        },\n        \"Could not read storefront integrations\",\n      );\n      if (!response.ok) {\n        throw new ZappieError(\n          \"server_error\",\n          \"Could not read storefront integrations\",\n          { status: response.status },\n        );\n      }\n      const value: unknown = await response.json();\n      const record = (value: unknown): Record<string, unknown> => {\n        if (!value || typeof value !== \"object\" || Array.isArray(value)) {\n          throw new ZappieError(\n            \"server_error\",\n            \"Invalid storefront integrations\",\n          );\n        }\n        return value as Record<string, unknown>;\n      };\n      const raw = record(value);\n      const id = (value: unknown, key: string): string => {\n        const result = record(value)[key];\n        if (typeof result !== \"string\" || !result) {\n          throw new ZappieError(\n            \"server_error\",\n            \"Invalid storefront integration ID\",\n          );\n        }\n        return result;\n      };\n      return {\n        ...(raw.google_analytics != null\n          ? {\n              googleAnalytics: {\n                measurementId: id(raw.google_analytics, \"measurement_id\"),\n              },\n            }\n          : {}),\n        ...(raw.meta_pixel != null\n          ? { metaPixel: { pixelId: id(raw.meta_pixel, \"pixel_id\") } }\n          : {}),\n      };\n    },\n  };\n}\n\n/** The integrations read returned by createIntegrations. */\nexport type IntegrationsClient = ReturnType<typeof createIntegrations>;\n"],
+  "mappings": ";AAAA,SAAS,wBAAwB;AACjC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AA2BA,SAAS,mBAAmB,SAA8B;AAC/D,iBAAe,EAAE,OAAO,gBAAgB,KAAK,QAAQ,IAAI,CAAC;AAC1D,QAAM,OAAO,IAAI,cAAc,OAAO,EAAE;AACxC,SAAO;AAAA;AAAA,IAEL,MAAM,IAAI,OAAiC,CAAC,GAA0B;AACpE,YAAM,MAAM;AAAA,QACV,KAAK,QAAQ;AAAA,QACb,SAAS,QAAQ,WAAW;AAAA,QAC5B,GAAG;AAAA,MACL;AACA,UAAI,QAAQ,WAAW;AACrB,eAAO,QAAQ,UAAU,gBAAgB,GAAG;AAAA,MAC9C;AACA,YAAM,WAAW,MAAM;AAAA,QACrB,QAAQ,UAAU,CAAC,OAAO,SAAS,WAAW,MAAM,OAAO,IAAI;AAAA,QAC/D,GAAG,IAAI;AAAA,QACP;AAAA,UACE,UAAU;AAAA,UACV,SAAS;AAAA,YACP,eAAe,UAAU,IAAI,GAAG;AAAA,YAChC,kBAAkB,IAAI;AAAA,UACxB;AAAA,UACA,GAAG;AAAA,QACL;AAAA,QACA;AAAA,MACF;AACA,UAAI,CAAC,SAAS,IAAI;AAChB,cAAM,IAAI;AAAA,UACR;AAAA,UACA;AAAA,UACA,EAAE,QAAQ,SAAS,OAAO;AAAA,QAC5B;AAAA,MACF;AACA,YAAM,QAAiB,MAAM,SAAS,KAAK;AAC3C,YAAM,SAAS,CAACA,WAA4C;AAC1D,YAAI,CAACA,UAAS,OAAOA,WAAU,YAAY,MAAM,QAAQA,MAAK,GAAG;AAC/D,gBAAM,IAAI;AAAA,YACR;AAAA,YACA;AAAA,UACF;AAAA,QACF;AACA,eAAOA;AAAA,MACT;AACA,YAAM,MAAM,OAAO,KAAK;AACxB,YAAM,KAAK,CAACA,QAAgB,QAAwB;AAClD,cAAM,SAAS,OAAOA,MAAK,EAAE,GAAG;AAChC,YAAI,OAAO,WAAW,YAAY,CAAC,QAAQ;AACzC,gBAAM,IAAI;AAAA,YACR;AAAA,YACA;AAAA,UACF;AAAA,QACF;AACA,eAAO;AAAA,MACT;AACA,aAAO;AAAA,QACL,GAAI,IAAI,oBAAoB,OACxB;AAAA,UACE,iBAAiB;AAAA,YACf,eAAe,GAAG,IAAI,kBAAkB,gBAAgB;AAAA,UAC1D;AAAA,QACF,IACA,CAAC;AAAA,QACL,GAAI,IAAI,cAAc,OAClB,EAAE,WAAW,EAAE,SAAS,GAAG,IAAI,YAAY,UAAU,EAAE,EAAE,IACzD,CAAC;AAAA,MACP;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": ["value"]
+}

package/dist/internal.d.ts

@@ -1,6 +1,6 @@
-import { b as CartFulfilment, W as WireFulfilment } from './client-BctSrEhO.js';
-export { v as validateConfig } from './client-BctSrEhO.js';
-import './models-Dj-VkdU1.js';
+import { c as CartFulfilment, W as WireFulfilment } from './types-CuDvfW9g.js';
+export { v as validateConfig } from './client-Bm2cCYea.js';
+import './models-Rg5kQUkv.js';
 
 /**
  * Convert a cart fulfilment selection to the API field names used by quotes and checkout.

package/dist/{models-Dj-VkdU1.d.ts → models-Rg5kQUkv.d.ts}

@@ -47,6 +47,16 @@ type SpecialHours = {
 };
 /** Branch details, opening hours and fulfilment options. */
 type Branch = {
+    /** Currency used for this branch's prices. */
+    currency?: Currency;
+    /** Country code for the branch address. */
+    country?: string;
+    /** Delivery regions and their quoted base fees. */
+    deliveryRegions?: {
+        id: string;
+        name: string;
+        fee: Money;
+    }[];
     id: string;
     slug: string;
     name: string;
@@ -79,6 +89,18 @@ type Branch = {
 };
 /** Public storefront identity and branch directory. */
 type Store = {
+    /** Search and sharing settings. Absent when the store has no site settings. */
+    seo?: {
+        titlePattern: string;
+        description: string;
+        shareImageUrl: string;
+        searchConsoleToken: string;
+        hidden: boolean;
+        redirects: {
+            from: string;
+            to: string;
+        }[];
+    };
     id: string;
     slug: string;
     name: string;
@@ -105,6 +127,8 @@ type MenuSchedule = {
 };
 /** A source menu retained when the branch exposes several menus. */
 type MenuSection = {
+    /** Fulfilment modes returned for this source menu. */
+    fulfilment?: string[];
     /** Placement count before you load items. Omitted when unknown. */
     placementCount?: number;
     paginated?: boolean;
@@ -146,6 +170,8 @@ type Variant = {
 };
 /** Item details and choices, with at least one exact variant. */
 type Item = {
+    /** Fulfilment modes returned for this item. */
+    fulfilment?: string[];
     /** Exact source placements returned by targeted item reads. */
     placements?: {
         menuId: string;

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-BctSrEhO.js';
-import '../models-Dj-VkdU1.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';

package/dist/react/index.d.ts

@@ -1,8 +1,9 @@
 export { VERSION } from '../index.js';
-import { I as Item, a as Menu, S as Store, M as Money } from '../models-Dj-VkdU1.js';
-import { c as ZappieError, Z as Zappie, d as CartModule, e as CartLine, b as CartFulfilment, f as CartState, g as CartIssue } from '../client-BctSrEhO.js';
+import { I as Item, a as Menu, S as Store, M as Money } from '../models-Rg5kQUkv.js';
+import { a as ZappieError, Z as Zappie } from '../client-Bm2cCYea.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
+import { d as CartModule, C as CartLine, c as CartFulfilment, e as CartState, f as CartIssue } from '../types-CuDvfW9g.js';
 
 /** Subscribe to storefront identity and branch-directory data. */
 declare function useStore(): {

package/dist/server/index.d.ts

@@ -1,6 +1,7 @@
-import { a as Menu, F as Formatters, S as Store } from '../models-Dj-VkdU1.js';
-import { c as ZappieError, h as ZappieConfig, d as CartModule, T as Transport, S as StorageLike, i as StoreResource, M as MenuResource, j as ZappieEvents, C as CartLineInput, k as Cache } from '../client-BctSrEhO.js';
+import { a as Menu, F as Formatters, S as Store } from '../models-Rg5kQUkv.js';
+import { a as ZappieError, b as ZappieConfig, T as Transport, S as StorageLike, c as StoreResource, M as MenuResource, d as ZappieEvents, C as Cache } from '../client-Bm2cCYea.js';
 export { VERSION } from '../index.js';
+import { d as CartModule, b as CartLineInput } from '../types-CuDvfW9g.js';
 
 /**
  * A URL string, URL object or Request you can parse as a storefront route.
@@ -210,6 +211,7 @@ declare function createZappieServer({ secretKey, ...config }: ZappieServerConfig
         transport?: Transport;
         baseUrl?: string;
         fetch?: typeof fetch;
+        customerBase?: string;
         storage?: StorageLike;
         cart?: {
             ttl?: number;

package/dist/testing/index.d.ts

@@ -1,6 +1,7 @@
-import { T as Transport, l as ZappieErrorCode, d as CartModule, S as StorageLike, i as StoreResource, M as MenuResource, j as ZappieEvents, C as CartLineInput, k as Cache } from '../client-BctSrEhO.js';
-import { S as Store, a as Menu, F as Formatters } from '../models-Dj-VkdU1.js';
+import { T as Transport, e as ZappieErrorCode, S as StorageLike, c as StoreResource, M as MenuResource, d as ZappieEvents, C as Cache } from '../client-Bm2cCYea.js';
+import { S as Store, a as Menu, F as Formatters } from '../models-Rg5kQUkv.js';
 export { VERSION } from '../index.js';
+import { d as CartModule, b as CartLineInput } from '../types-CuDvfW9g.js';
 
 /** Store and branch menus supplied to the deterministic mock transport. */
 type MockFixtures = {
@@ -24,6 +25,7 @@ declare function createMockZappie(input: MockFixtures, opts?: MockOptions): Read
         transport?: Transport;
         baseUrl?: string;
         fetch?: typeof fetch;
+        customerBase?: string;
         storage?: StorageLike;
         cart?: {
             ttl?: number;

package/dist/transport/category-page.d.ts

@@ -1,4 +1,4 @@
-import { a as Menu, C as CategoryPage } from '../models-Dj-VkdU1.js';
+import { a as Menu, C as CategoryPage } from '../models-Rg5kQUkv.js';
 
 /**
  * Validates and maps one category page. Only progressive catalogues read

package/dist/transport/mappers.js

@@ -248,6 +248,7 @@ function mapItem(value) {
     variants,
     optionGroups,
     tags: list(v.tags ?? []).map(text),
+    ...v.fulfilment !== void 0 ? { fulfilment: list(v.fulfilment).map(text) } : {},
     ...opt("stockLabel", v.stock_label, isString),
     ...v.promo !== void 0 ? { promo: mapPromo(v.promo) } : {},
     ...opt("description", v.description, isString),
@@ -288,6 +289,7 @@ function mapMenu(value, branchId) {
       id: text(m.id),
       name: text(m.name),
       categoryIds,
+      ...m.fulfilment !== void 0 ? { fulfilment: list(m.fulfilment).map(text) } : {},
       ...m.placement_count !== void 0 ? { placementCount: m.placement_count } : {},
       ...opt("paginated", m.paginated, isBoolean),
       ...s ? { schedule: s } : {},
@@ -321,6 +323,23 @@ function mapMenu(value, branchId) {
     ...menus.length === 1 && menus[0].schedule ? { schedule: menus[0].schedule } : {}
   };
 }
+function mapSeo(value) {
+  const seo = record(value);
+  if (typeof seo.hidden !== "boolean") {
+    throw new ZappieError("server_error", "Invalid store search visibility");
+  }
+  return {
+    titlePattern: text(seo.title_pattern),
+    description: text(seo.description),
+    shareImageUrl: text(seo.share_image_url),
+    searchConsoleToken: text(seo.search_console_token),
+    hidden: seo.hidden,
+    redirects: list(seo.redirects).map((raw) => {
+      const redirect = record(raw);
+      return { from: text(redirect.from), to: text(redirect.to) };
+    })
+  };
+}
 export {
   hours,
   isBoolean,
@@ -329,6 +348,7 @@ export {
   mapItem,
   mapMenu,
   mapMoney,
+  mapSeo,
   opt,
   record,
   text