@zappie/sdk 0.1.6 → 0.1.8

package/dist/transport/rest.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/transport/rest.ts"],
-  "sourcesContent": ["import type { QuoteRequest, WireQuote } from \"../cart/types\";\nimport type { MenuFulfilment } from \"../client\";\nimport { ZappieError, wireError } from \"../errors\";\nimport { delay, throwIfAborted } from \"../internal/abort\";\nimport { payloadKey } from \"../internal/digest\";\nimport { money } from \"../money\";\nimport {\n  hours,\n  isBoolean,\n  isString,\n  list,\n  mapItem,\n  mapMenu,\n  mapMoney,\n  mapSeo,\n  opt,\n  record,\n  text,\n} from \"./mappers\";\nimport type { SelectedMenuRequest } from \"./selected-menu\";\nimport type {\n  MenuResponse,\n  MenuVersion,\n  RequestCtx,\n  SearchRequest,\n  Transport,\n} from \"./types\";\n/** The longest Retry-After the SDK waits out before surfacing the error instead. */\nconst MAX_RETRY_WAIT_MS = 5_000;\nconst wireFulfilment = (value: MenuFulfilment) =>\n  value === \"dineIn\" ? \"dine_in\" : value;\n/** REST connection options. A custom fetch can provide tracing or mock responses. */\nexport type RestTransportOptions = { baseUrl?: string; fetch?: typeof fetch };\n/** REST read adapter for the versioned storefront API. */\nexport class RestTransport implements Transport {\n  readonly baseUrl: string;\n  private fetcher: typeof fetch;\n  constructor(opts: RestTransportOptions = {}) {\n    const url = new URL(opts.baseUrl ?? \"https://api.zappie.ai/storefront/v1\");\n    if (\n      url.username ||\n      url.password ||\n      url.search ||\n      url.hash ||\n      (url.protocol !== \"https:\" &&\n        !(\n          url.protocol === \"http:\" &&\n          [\"localhost\", \"127.0.0.1\", \"[::1]\"].includes(url.hostname)\n        ))\n    ) {\n      throw new ZappieError(\n        \"invalid_request\",\n        \"REST baseUrl requires HTTPS, or HTTP on localhost\",\n      );\n    }\n    this.baseUrl = url.href.replace(/\\/$/, \"\");\n    // Called as this.fetcher(), a stored global fetch would run with the\n    // transport as `this`, which Workers refuses (\"Illegal invocation\").\n    this.fetcher =\n      opts.fetch ?? ((input, init) => globalThis.fetch(input, init));\n  }\n  private async request(\n    path: string,\n    ctx: RequestCtx,\n    etag?: string,\n    body?: QuoteRequest,\n  ): Promise<Response> {\n    if (typeof window !== \"undefined\" && ctx.key.startsWith(\"sk_\")) {\n      throw new ZappieError(\n        \"invalid_request\",\n        \"Secret keys cannot be sent from a browser\",\n      );\n    }\n    for (let attempt = 0; ; attempt++) {\n      throwIfAborted(ctx.signal);\n      let response: Response;\n      try {\n        response = await this.fetcher(this.baseUrl + path, {\n          method: body ? \"POST\" : \"GET\",\n          ...(body ? { body: JSON.stringify(body) } : {}),\n          // Workers reject redirect: \"error\"; a redirect is still refused below\n          // as a non-OK response (a 3xx, or opaqueredirect in browsers).\n          redirect: \"manual\",\n          headers: {\n            ...(body ? { \"Content-Type\": \"application/json\" } : {}),\n            ...(ctx.idempotencyKey\n              ? { \"Idempotency-Key\": ctx.idempotencyKey }\n              : {}),\n            Authorization: `Bearer ${ctx.key}`,\n            \"Zappie-Version\": ctx.version,\n            ...(etag ? { \"If-None-Match\": etag } : {}),\n          },\n          ...(ctx.signal ? { signal: ctx.signal } : {}),\n        });\n      } catch (error) {\n        throwIfAborted(ctx.signal);\n        if (attempt >= 2) {\n          throw new ZappieError(\n            \"network_error\",\n            \"Could not reach the storefront service\",\n            { cause: error },\n          );\n        }\n        await delay(100 * 2 ** attempt + Math.random() * 100, ctx.signal);\n        continue;\n      }\n      if (response.ok || response.status === 304) {\n        return response;\n      }\n      const retry = response.headers.get(\"Retry-After\");\n      const seconds = retry !== null ? Number(retry) : NaN;\n      const wait =\n        retry !== null\n          ? Number.isFinite(seconds)\n            ? Math.max(0, seconds * 1000)\n            : Math.max(0, Date.parse(retry) - Date.now())\n          : NaN;\n      // A longer wait than this is the caller's decision, not a silently stalled read.\n      const tooLong = Number.isFinite(wait) && wait > MAX_RETRY_WAIT_MS;\n      if (\n        attempt < 2 &&\n        !tooLong &&\n        (response.status === 429 || response.status >= 500)\n      ) {\n        await response.body?.cancel();\n        await delay(\n          Number.isFinite(wait)\n            ? wait\n            : 100 * 2 ** attempt + Math.random() * 100,\n          ctx.signal,\n        );\n        continue;\n      }\n      const errorBody = await response.json().catch(() => ({}));\n      throw wireError(\n        errorBody,\n        response.status,\n        response.headers.get(\"Zappie-Request-Id\") ?? undefined,\n      );\n    }\n  }\n  private async json(response: Response): Promise<unknown> {\n    try {\n      return await response.json();\n    } catch (cause) {\n      if (cause instanceof Error && cause.name === \"AbortError\") {\n        throw cause;\n      }\n      throw new ZappieError(\n        \"server_error\",\n        \"The storefront service returned invalid JSON\",\n        { status: response.status, cause },\n      );\n    }\n  }\n  async quote(ctx: RequestCtx, body: QuoteRequest): Promise<WireQuote> {\n    body = (await import(\"./quote-body\")).quoteBody(body);\n    const request = {\n      ...ctx,\n      idempotencyKey:\n        ctx.idempotencyKey ?? (await payloadKey(JSON.stringify(body))),\n    };\n    const raw = await this.json(\n      await this.request(\"/quote\", request, undefined, body),\n    );\n    // The cart's quote client validates and maps the response.\n    return raw as WireQuote;\n  }\n  async getStore(ctx: RequestCtx) {\n    const mapper = import(\"./store\").catch((cause) => {\n      throw new ZappieError(\n        \"server_error\",\n        \"Could not load the storefront store mapper\",\n        { cause },\n      );\n    });\n    const response = this.request(\"/store\", ctx).then((value) =>\n      this.json(value),\n    );\n    const [{ mapStore }, raw] = await Promise.all([mapper, response]);\n    return mapStore(\n      raw,\n      record,\n      text,\n      list,\n      hours,\n      mapMoney,\n      money,\n      opt,\n      isString,\n      isBoolean,\n      mapSeo,\n    );\n  }\n  async getMenu(\n    ctx: RequestCtx & {\n      branchId: string;\n      ifNoneMatch?: string;\n      metadataOnly?: boolean;\n      fulfilment?: MenuFulfilment;\n    },\n  ): Promise<MenuResponse> {\n    let cursor: string | undefined;\n    const seen = new Set<string>();\n    let output: ReturnType<typeof mapMenu> | undefined;\n    let etag: string | undefined;\n    do {\n      const query = new URLSearchParams({\n        branch: ctx.branchId,\n        ...(ctx.fulfilment\n          ? { fulfilment: wireFulfilment(ctx.fulfilment) }\n          : {}),\n        ...(ctx.metadataOnly ? { metadata_only: \"true\" } : {}),\n        ...(cursor ? { cursor } : {}),\n      });\n      const response = await this.request(\n        `/menus?${query}`,\n        ctx,\n        cursor ? undefined : ctx.ifNoneMatch,\n      );\n      if (response.status === 304) {\n        if (cursor) {\n          throw new ZappieError(\n            \"server_error\",\n            \"Unexpected 304 on a continuation page\",\n          );\n        }\n        return {\n          notModified: true,\n          ...(response.headers.get(\"ETag\")\n            ? { etag: response.headers.get(\"ETag\")! }\n            : {}),\n        };\n      }\n      const raw = record(await this.json(response));\n      const page = mapMenu(raw, ctx.branchId);\n      if (ctx.metadataOnly) {\n        if (Object.keys(page.items).length || raw.next_cursor) {\n          throw new ZappieError(\"server_error\", \"Invalid metadata response\");\n        }\n        return { menu: { ...page, completeness: \"partial\" } };\n      }\n      if (!output) {\n        output = page;\n        etag = response.headers.get(\"ETag\") ?? undefined;\n      } else {\n        if (page.version !== output.version) {\n          throw new ZappieError(\n            \"server_error\",\n            \"Menu changed while fetching pages; retry the read\",\n          );\n        }\n        Object.assign(output.items, page.items);\n        for (const category of page.categories) {\n          const existing = output.categories.find((c) => c.id === category.id);\n          if (existing) {\n            existing.itemIds = [\n              ...new Set([...existing.itemIds, ...category.itemIds]),\n            ];\n          } else {\n            output.categories.push(category);\n          }\n        }\n        for (const section of page.menus ?? []) {\n          const existing = output.menus?.find((m) => m.id === section.id);\n          if (existing) {\n            existing.categoryIds = [\n              ...new Set([...existing.categoryIds, ...section.categoryIds]),\n            ];\n          } else {\n            output.menus?.push(section);\n          }\n        }\n      }\n      cursor =\n        typeof raw.next_cursor === \"string\" && raw.next_cursor\n          ? raw.next_cursor\n          : undefined;\n      if (cursor) {\n        if (seen.has(cursor)) {\n          throw new ZappieError(\n            \"server_error\",\n            \"Repeated menu pagination cursor\",\n          );\n        }\n        seen.add(cursor);\n      }\n    } while (cursor);\n    if (output.menus && output.menus.length > 1) {\n      output.id = `branch:${ctx.branchId}`;\n      output.name = \"Catalogue\";\n      delete output.schedule;\n    }\n    for (const category of output.categories) {\n      for (const id of category.itemIds) {\n        if (!Object.prototype.hasOwnProperty.call(output.items, id)) {\n          throw new ZappieError(\n            \"server_error\",\n            \"Category refers to a missing item\",\n          );\n        }\n      }\n    }\n    if (Object.keys(output.items).length > 2000) {\n      console.warn(\"Zappie menu contains more than 2,000 items\");\n    }\n    return { menu: output, ...(etag ? { etag } : {}) };\n  }\n  async getSelectedMenu(ctx: SelectedMenuRequest) {\n    return (await import(\"./selected-menu\")).selectedMenu(\n      ctx,\n      (path) => this.request(path, ctx, ctx.ifNoneMatch),\n      (response) => this.json(response),\n      mapMenu,\n      () => new ZappieError(\"server_error\", \"Invalid selected menu\"),\n    );\n  }\n  async search(ctx: SearchRequest) {\n    return (await import(\"./search\")).searchPage(\n      ctx,\n      async (path) => this.json(await this.request(path, ctx)),\n      mapMenu,\n      () => new ZappieError(\"server_error\", \"Invalid search page\"),\n    );\n  }\n  async getCategoryPage(\n    ctx: RequestCtx & {\n      branchId: string;\n      menuId: string;\n      categoryId: string;\n      cursor?: string;\n    },\n  ) {\n    const query = new URLSearchParams({\n      branch: ctx.branchId,\n      ...(ctx.cursor ? { cursor: ctx.cursor } : {}),\n    });\n    const raw = await this.json(\n      await this.request(\n        `/menus/${encodeURIComponent(ctx.menuId)}/categories/${encodeURIComponent(ctx.categoryId)}/items?${query}`,\n        ctx,\n      ),\n    );\n    // Loaded on first use: only progressive catalogues read pages.\n    return (await import(\"./category-page\")).categoryPage(\n      record(raw),\n      ctx,\n      mapMenu,\n      () => new ZappieError(\"server_error\", \"Invalid category page\"),\n    );\n  }\n  async getMenuVersion(\n    ctx: RequestCtx & { branchId: string; fulfilment?: MenuFulfilment },\n  ): Promise<MenuVersion> {\n    const value = record(\n      await this.json(\n        await this.request(\n          `/menus/version?${new URLSearchParams({\n            branch: ctx.branchId,\n            ...(ctx.fulfilment\n              ? { fulfilment: wireFulfilment(ctx.fulfilment) }\n              : {}),\n          })}`,\n          ctx,\n        ),\n      ),\n    );\n    if (\n      typeof value.menu_version !== \"string\" ||\n      typeof value.availability_hash !== \"string\"\n    ) {\n      throw new ZappieError(\"server_error\", \"Invalid menu version response\");\n    }\n    return {\n      version: value.menu_version,\n      availabilityHash: value.availability_hash,\n    };\n  }\n  async getItem(ctx: RequestCtx & { branchId: string; itemId: string }) {\n    const item = mapItem(\n      await this.json(\n        await this.request(\n          `/items/${encodeURIComponent(ctx.itemId)}?${new URLSearchParams({ branch: ctx.branchId })}`,\n          ctx,\n        ),\n      ),\n    );\n    if (item.id !== ctx.itemId) {\n      throw new ZappieError(\n        \"server_error\",\n        \"Item response identity does not match the request\",\n      );\n    }\n    return item;\n  }\n}\n"],
-  "mappings": ";AAEA,SAAS,aAAa,iBAAiB;AACvC,SAAS,OAAO,sBAAsB;AACtC,SAAS,kBAAkB;AAC3B,SAAS,aAAa;AACtB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAUP,IAAM,oBAAoB;AAC1B,IAAM,iBAAiB,CAAC,UACtB,UAAU,WAAW,YAAY;AAI5B,IAAM,gBAAN,MAAyC;AAAA,EAG9C,YAAY,OAA6B,CAAC,GAAG;AAC3C,UAAM,MAAM,IAAI,IAAI,KAAK,WAAW,qCAAqC;AACzE,QACE,IAAI,YACJ,IAAI,YACJ,IAAI,UACJ,IAAI,QACH,IAAI,aAAa,YAChB,EACE,IAAI,aAAa,WACjB,CAAC,aAAa,aAAa,OAAO,EAAE,SAAS,IAAI,QAAQ,IAE7D;AACA,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,MACF;AAAA,IACF;AACA,SAAK,UAAU,IAAI,KAAK,QAAQ,OAAO,EAAE;AAGzC,SAAK,UACH,KAAK,UAAU,CAAC,OAAO,SAAS,WAAW,MAAM,OAAO,IAAI;AAAA,EAChE;AAAA,EACA,MAAc,QACZ,MACA,KACA,MACA,MACmB;AACnB,QAAI,OAAO,WAAW,eAAe,IAAI,IAAI,WAAW,KAAK,GAAG;AAC9D,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,MACF;AAAA,IACF;AACA,aAAS,UAAU,KAAK,WAAW;AACjC,qBAAe,IAAI,MAAM;AACzB,UAAI;AACJ,UAAI;AACF,mBAAW,MAAM,KAAK,QAAQ,KAAK,UAAU,MAAM;AAAA,UACjD,QAAQ,OAAO,SAAS;AAAA,UACxB,GAAI,OAAO,EAAE,MAAM,KAAK,UAAU,IAAI,EAAE,IAAI,CAAC;AAAA;AAAA;AAAA,UAG7C,UAAU;AAAA,UACV,SAAS;AAAA,YACP,GAAI,OAAO,EAAE,gBAAgB,mBAAmB,IAAI,CAAC;AAAA,YACrD,GAAI,IAAI,iBACJ,EAAE,mBAAmB,IAAI,eAAe,IACxC,CAAC;AAAA,YACL,eAAe,UAAU,IAAI,GAAG;AAAA,YAChC,kBAAkB,IAAI;AAAA,YACtB,GAAI,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAC;AAAA,UAC1C;AAAA,UACA,GAAI,IAAI,SAAS,EAAE,QAAQ,IAAI,OAAO,IAAI,CAAC;AAAA,QAC7C,CAAC;AAAA,MACH,SAAS,OAAO;AACd,uBAAe,IAAI,MAAM;AACzB,YAAI,WAAW,GAAG;AAChB,gBAAM,IAAI;AAAA,YACR;AAAA,YACA;AAAA,YACA,EAAE,OAAO,MAAM;AAAA,UACjB;AAAA,QACF;AACA,cAAM,MAAM,MAAM,KAAK,UAAU,KAAK,OAAO,IAAI,KAAK,IAAI,MAAM;AAChE;AAAA,MACF;AACA,UAAI,SAAS,MAAM,SAAS,WAAW,KAAK;AAC1C,eAAO;AAAA,MACT;AACA,YAAM,QAAQ,SAAS,QAAQ,IAAI,aAAa;AAChD,YAAM,UAAU,UAAU,OAAO,OAAO,KAAK,IAAI;AACjD,YAAM,OACJ,UAAU,OACN,OAAO,SAAS,OAAO,IACrB,KAAK,IAAI,GAAG,UAAU,GAAI,IAC1B,KAAK,IAAI,GAAG,KAAK,MAAM,KAAK,IAAI,KAAK,IAAI,CAAC,IAC5C;AAEN,YAAM,UAAU,OAAO,SAAS,IAAI,KAAK,OAAO;AAChD,UACE,UAAU,KACV,CAAC,YACA,SAAS,WAAW,OAAO,SAAS,UAAU,MAC/C;AACA,cAAM,SAAS,MAAM,OAAO;AAC5B,cAAM;AAAA,UACJ,OAAO,SAAS,IAAI,IAChB,OACA,MAAM,KAAK,UAAU,KAAK,OAAO,IAAI;AAAA,UACzC,IAAI;AAAA,QACN;AACA;AAAA,MACF;AACA,YAAM,YAAY,MAAM,SAAS,KAAK,EAAE,MAAM,OAAO,CAAC,EAAE;AACxD,YAAM;AAAA,QACJ;AAAA,QACA,SAAS;AAAA,QACT,SAAS,QAAQ,IAAI,mBAAmB,KAAK;AAAA,MAC/C;AAAA,IACF;AAAA,EACF;AAAA,EACA,MAAc,KAAK,UAAsC;AACvD,QAAI;AACF,aAAO,MAAM,SAAS,KAAK;AAAA,IAC7B,SAAS,OAAO;AACd,UAAI,iBAAiB,SAAS,MAAM,SAAS,cAAc;AACzD,cAAM;AAAA,MACR;AACA,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,QACA,EAAE,QAAQ,SAAS,QAAQ,MAAM;AAAA,MACnC;AAAA,IACF;AAAA,EACF;AAAA,EACA,MAAM,MAAM,KAAiB,MAAwC;AACnE,YAAQ,MAAM,OAAO,iBAAc,GAAG,UAAU,IAAI;AACpD,UAAM,UAAU;AAAA,MACd,GAAG;AAAA,MACH,gBACE,IAAI,kBAAmB,MAAM,WAAW,KAAK,UAAU,IAAI,CAAC;AAAA,IAChE;AACA,UAAM,MAAM,MAAM,KAAK;AAAA,MACrB,MAAM,KAAK,QAAQ,UAAU,SAAS,QAAW,IAAI;AAAA,IACvD;AAEA,WAAO;AAAA,EACT;AAAA,EACA,MAAM,SAAS,KAAiB;AAC9B,UAAM,SAAS,OAAO,YAAS,EAAE,MAAM,CAAC,UAAU;AAChD,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,QACA,EAAE,MAAM;AAAA,MACV;AAAA,IACF,CAAC;AACD,UAAM,WAAW,KAAK,QAAQ,UAAU,GAAG,EAAE;AAAA,MAAK,CAAC,UACjD,KAAK,KAAK,KAAK;AAAA,IACjB;AACA,UAAM,CAAC,EAAE,SAAS,GAAG,GAAG,IAAI,MAAM,QAAQ,IAAI,CAAC,QAAQ,QAAQ,CAAC;AAChE,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA,EACA,MAAM,QACJ,KAMuB;AACvB,QAAI;AACJ,UAAM,OAAO,oBAAI,IAAY;AAC7B,QAAI;AACJ,QAAI;AACJ,OAAG;AACD,YAAM,QAAQ,IAAI,gBAAgB;AAAA,QAChC,QAAQ,IAAI;AAAA,QACZ,GAAI,IAAI,aACJ,EAAE,YAAY,eAAe,IAAI,UAAU,EAAE,IAC7C,CAAC;AAAA,QACL,GAAI,IAAI,eAAe,EAAE,eAAe,OAAO,IAAI,CAAC;AAAA,QACpD,GAAI,SAAS,EAAE,OAAO,IAAI,CAAC;AAAA,MAC7B,CAAC;AACD,YAAM,WAAW,MAAM,KAAK;AAAA,QAC1B,UAAU,KAAK;AAAA,QACf;AAAA,QACA,SAAS,SAAY,IAAI;AAAA,MAC3B;AACA,UAAI,SAAS,WAAW,KAAK;AAC3B,YAAI,QAAQ;AACV,gBAAM,IAAI;AAAA,YACR;AAAA,YACA;AAAA,UACF;AAAA,QACF;AACA,eAAO;AAAA,UACL,aAAa;AAAA,UACb,GAAI,SAAS,QAAQ,IAAI,MAAM,IAC3B,EAAE,MAAM,SAAS,QAAQ,IAAI,MAAM,EAAG,IACtC,CAAC;AAAA,QACP;AAAA,MACF;AACA,YAAM,MAAM,OAAO,MAAM,KAAK,KAAK,QAAQ,CAAC;AAC5C,YAAM,OAAO,QAAQ,KAAK,IAAI,QAAQ;AACtC,UAAI,IAAI,cAAc;AACpB,YAAI,OAAO,KAAK,KAAK,KAAK,EAAE,UAAU,IAAI,aAAa;AACrD,gBAAM,IAAI,YAAY,gBAAgB,2BAA2B;AAAA,QACnE;AACA,eAAO,EAAE,MAAM,EAAE,GAAG,MAAM,cAAc,UAAU,EAAE;AAAA,MACtD;AACA,UAAI,CAAC,QAAQ;AACX,iBAAS;AACT,eAAO,SAAS,QAAQ,IAAI,MAAM,KAAK;AAAA,MACzC,OAAO;AACL,YAAI,KAAK,YAAY,OAAO,SAAS;AACnC,gBAAM,IAAI;AAAA,YACR;AAAA,YACA;AAAA,UACF;AAAA,QACF;AACA,eAAO,OAAO,OAAO,OAAO,KAAK,KAAK;AACtC,mBAAW,YAAY,KAAK,YAAY;AACtC,gBAAM,WAAW,OAAO,WAAW,KAAK,CAAC,MAAM,EAAE,OAAO,SAAS,EAAE;AACnE,cAAI,UAAU;AACZ,qBAAS,UAAU;AAAA,cACjB,GAAG,oBAAI,IAAI,CAAC,GAAG,SAAS,SAAS,GAAG,SAAS,OAAO,CAAC;AAAA,YACvD;AAAA,UACF,OAAO;AACL,mBAAO,WAAW,KAAK,QAAQ;AAAA,UACjC;AAAA,QACF;AACA,mBAAW,WAAW,KAAK,SAAS,CAAC,GAAG;AACtC,gBAAM,WAAW,OAAO,OAAO,KAAK,CAAC,MAAM,EAAE,OAAO,QAAQ,EAAE;AAC9D,cAAI,UAAU;AACZ,qBAAS,cAAc;AAAA,cACrB,GAAG,oBAAI,IAAI,CAAC,GAAG,SAAS,aAAa,GAAG,QAAQ,WAAW,CAAC;AAAA,YAC9D;AAAA,UACF,OAAO;AACL,mBAAO,OAAO,KAAK,OAAO;AAAA,UAC5B;AAAA,QACF;AAAA,MACF;AACA,eACE,OAAO,IAAI,gBAAgB,YAAY,IAAI,cACvC,IAAI,cACJ;AACN,UAAI,QAAQ;AACV,YAAI,KAAK,IAAI,MAAM,GAAG;AACpB,gBAAM,IAAI;AAAA,YACR;AAAA,YACA;AAAA,UACF;AAAA,QACF;AACA,aAAK,IAAI,MAAM;AAAA,MACjB;AAAA,IACF,SAAS;AACT,QAAI,OAAO,SAAS,OAAO,MAAM,SAAS,GAAG;AAC3C,aAAO,KAAK,UAAU,IAAI,QAAQ;AAClC,aAAO,OAAO;AACd,aAAO,OAAO;AAAA,IAChB;AACA,eAAW,YAAY,OAAO,YAAY;AACxC,iBAAW,MAAM,SAAS,SAAS;AACjC,YAAI,CAAC,OAAO,UAAU,eAAe,KAAK,OAAO,OAAO,EAAE,GAAG;AAC3D,gBAAM,IAAI;AAAA,YACR;AAAA,YACA;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AACA,QAAI,OAAO,KAAK,OAAO,KAAK,EAAE,SAAS,KAAM;AAC3C,cAAQ,KAAK,4CAA4C;AAAA,IAC3D;AACA,WAAO,EAAE,MAAM,QAAQ,GAAI,OAAO,EAAE,KAAK,IAAI,CAAC,EAAG;AAAA,EACnD;AAAA,EACA,MAAM,gBAAgB,KAA0B;AAC9C,YAAQ,MAAM,OAAO,oBAAiB,GAAG;AAAA,MACvC;AAAA,MACA,CAAC,SAAS,KAAK,QAAQ,MAAM,KAAK,IAAI,WAAW;AAAA,MACjD,CAAC,aAAa,KAAK,KAAK,QAAQ;AAAA,MAChC;AAAA,MACA,MAAM,IAAI,YAAY,gBAAgB,uBAAuB;AAAA,IAC/D;AAAA,EACF;AAAA,EACA,MAAM,OAAO,KAAoB;AAC/B,YAAQ,MAAM,OAAO,aAAU,GAAG;AAAA,MAChC;AAAA,MACA,OAAO,SAAS,KAAK,KAAK,MAAM,KAAK,QAAQ,MAAM,GAAG,CAAC;AAAA,MACvD;AAAA,MACA,MAAM,IAAI,YAAY,gBAAgB,qBAAqB;AAAA,IAC7D;AAAA,EACF;AAAA,EACA,MAAM,gBACJ,KAMA;AACA,UAAM,QAAQ,IAAI,gBAAgB;AAAA,MAChC,QAAQ,IAAI;AAAA,MACZ,GAAI,IAAI,SAAS,EAAE,QAAQ,IAAI,OAAO,IAAI,CAAC;AAAA,IAC7C,CAAC;AACD,UAAM,MAAM,MAAM,KAAK;AAAA,MACrB,MAAM,KAAK;AAAA,QACT,UAAU,mBAAmB,IAAI,MAAM,CAAC,eAAe,mBAAmB,IAAI,UAAU,CAAC,UAAU,KAAK;AAAA,QACxG;AAAA,MACF;AAAA,IACF;AAEA,YAAQ,MAAM,OAAO,oBAAiB,GAAG;AAAA,MACvC,OAAO,GAAG;AAAA,MACV;AAAA,MACA;AAAA,MACA,MAAM,IAAI,YAAY,gBAAgB,uBAAuB;AAAA,IAC/D;AAAA,EACF;AAAA,EACA,MAAM,eACJ,KACsB;AACtB,UAAM,QAAQ;AAAA,MACZ,MAAM,KAAK;AAAA,QACT,MAAM,KAAK;AAAA,UACT,kBAAkB,IAAI,gBAAgB;AAAA,YACpC,QAAQ,IAAI;AAAA,YACZ,GAAI,IAAI,aACJ,EAAE,YAAY,eAAe,IAAI,UAAU,EAAE,IAC7C,CAAC;AAAA,UACP,CAAC,CAAC;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AACA,QACE,OAAO,MAAM,iBAAiB,YAC9B,OAAO,MAAM,sBAAsB,UACnC;AACA,YAAM,IAAI,YAAY,gBAAgB,+BAA+B;AAAA,IACvE;AACA,WAAO;AAAA,MACL,SAAS,MAAM;AAAA,MACf,kBAAkB,MAAM;AAAA,IAC1B;AAAA,EACF;AAAA,EACA,MAAM,QAAQ,KAAwD;AACpE,UAAM,OAAO;AAAA,MACX,MAAM,KAAK;AAAA,QACT,MAAM,KAAK;AAAA,UACT,UAAU,mBAAmB,IAAI,MAAM,CAAC,IAAI,IAAI,gBAAgB,EAAE,QAAQ,IAAI,SAAS,CAAC,CAAC;AAAA,UACzF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AACA,QAAI,KAAK,OAAO,IAAI,QAAQ;AAC1B,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,MACF;AAAA,IACF;AACA,WAAO;AAAA,EACT;AACF;",
+  "sourcesContent": ["import type { QuoteRequest, WireQuote } from \"../cart/types\";\nimport type { MenuFulfilment } from \"../client\";\nimport { ZappieError, wireError } from \"../errors\";\nimport { delay, throwIfAborted } from \"../internal/abort\";\nimport { payloadKey } from \"../internal/digest\";\nimport { money } from \"../money\";\nimport {\n  hours,\n  isBoolean,\n  isString,\n  list,\n  mapItem,\n  mapMenu,\n  mapMoney,\n  mapSeo,\n  opt,\n  record,\n  text,\n} from \"./mappers\";\nimport type { SelectedMenuRequest } from \"./selected-menu\";\nimport type {\n  MenuResponse,\n  MenuVersion,\n  RequestCtx,\n  SearchRequest,\n  Transport,\n} from \"./types\";\n/** The longest Retry-After the SDK waits out before surfacing the error instead. */\nconst MAX_RETRY_WAIT_MS = 5_000;\nconst wireFulfilment = (value: MenuFulfilment) =>\n  value === \"dineIn\" ? \"dine_in\" : value;\nconst presentationError = () =>\n  new ZappieError(\"server_error\", \"Invalid storefront presentation\");\n/** REST connection options. A custom fetch can provide tracing or mock responses. */\nexport type RestTransportOptions = { baseUrl?: string; fetch?: typeof fetch };\n/** REST read adapter for the versioned storefront API. */\nexport class RestTransport implements Transport {\n  readonly baseUrl: string;\n  private fetcher: typeof fetch;\n  constructor(opts: RestTransportOptions = {}) {\n    const url = new URL(opts.baseUrl ?? \"https://api.zappie.ai/storefront/v1\");\n    if (\n      url.username ||\n      url.password ||\n      url.search ||\n      url.hash ||\n      (url.protocol !== \"https:\" &&\n        !(\n          url.protocol === \"http:\" &&\n          [\"localhost\", \"127.0.0.1\", \"[::1]\"].includes(url.hostname)\n        ))\n    ) {\n      throw new ZappieError(\n        \"invalid_request\",\n        \"REST baseUrl requires HTTPS, or HTTP on localhost\",\n      );\n    }\n    this.baseUrl = url.href.replace(/\\/$/, \"\");\n    // Called as this.fetcher(), a stored global fetch would run with the\n    // transport as `this`, which Workers refuses (\"Illegal invocation\").\n    this.fetcher =\n      opts.fetch ?? ((input, init) => globalThis.fetch(input, init));\n  }\n  private async request(\n    path: string,\n    ctx: RequestCtx,\n    etag?: string,\n    body?: QuoteRequest,\n  ): Promise<Response> {\n    if (typeof window !== \"undefined\" && ctx.key.startsWith(\"sk_\")) {\n      throw new ZappieError(\n        \"invalid_request\",\n        \"Secret keys cannot be sent from a browser\",\n      );\n    }\n    for (let attempt = 0; ; attempt++) {\n      throwIfAborted(ctx.signal);\n      let response: Response;\n      try {\n        response = await this.fetcher(this.baseUrl + path, {\n          method: body ? \"POST\" : \"GET\",\n          ...(body ? { body: JSON.stringify(body) } : {}),\n          // Workers reject redirect: \"error\"; a redirect is still refused below\n          // as a non-OK response (a 3xx, or opaqueredirect in browsers).\n          redirect: \"manual\",\n          headers: {\n            ...(body ? { \"Content-Type\": \"application/json\" } : {}),\n            ...(ctx.idempotencyKey\n              ? { \"Idempotency-Key\": ctx.idempotencyKey }\n              : {}),\n            Authorization: `Bearer ${ctx.key}`,\n            \"Zappie-Version\": ctx.version,\n            ...(etag ? { \"If-None-Match\": etag } : {}),\n          },\n          ...(ctx.signal ? { signal: ctx.signal } : {}),\n        });\n      } catch (error) {\n        throwIfAborted(ctx.signal);\n        if (attempt >= 2) {\n          throw new ZappieError(\n            \"network_error\",\n            \"Could not reach the storefront service\",\n            { cause: error },\n          );\n        }\n        await delay(100 * 2 ** attempt + Math.random() * 100, ctx.signal);\n        continue;\n      }\n      if (response.ok || response.status === 304) {\n        return response;\n      }\n      const retry = response.headers.get(\"Retry-After\");\n      const seconds = retry !== null ? Number(retry) : NaN;\n      const wait =\n        retry !== null\n          ? Number.isFinite(seconds)\n            ? Math.max(0, seconds * 1000)\n            : Math.max(0, Date.parse(retry) - Date.now())\n          : NaN;\n      // A longer wait than this is the caller's decision, not a silently stalled read.\n      const tooLong = Number.isFinite(wait) && wait > MAX_RETRY_WAIT_MS;\n      if (\n        attempt < 2 &&\n        !tooLong &&\n        (response.status === 429 || response.status >= 500)\n      ) {\n        await response.body?.cancel();\n        await delay(\n          Number.isFinite(wait)\n            ? wait\n            : 100 * 2 ** attempt + Math.random() * 100,\n          ctx.signal,\n        );\n        continue;\n      }\n      const errorBody = await response.json().catch(() => ({}));\n      throw wireError(\n        errorBody,\n        response.status,\n        response.headers.get(\"Zappie-Request-Id\") ?? undefined,\n      );\n    }\n  }\n  private async json(response: Response): Promise<unknown> {\n    try {\n      return await response.json();\n    } catch (cause) {\n      if (cause instanceof Error && cause.name === \"AbortError\") {\n        throw cause;\n      }\n      throw new ZappieError(\n        \"server_error\",\n        \"The storefront service returned invalid JSON\",\n        { status: response.status, cause },\n      );\n    }\n  }\n  async quote(ctx: RequestCtx, body: QuoteRequest): Promise<WireQuote> {\n    body = (await import(\"./quote-body\")).quoteBody(body);\n    const request = {\n      ...ctx,\n      idempotencyKey:\n        ctx.idempotencyKey ?? (await payloadKey(JSON.stringify(body))),\n    };\n    const raw = await this.json(\n      await this.request(\"/quote\", request, undefined, body),\n    );\n    // The cart's quote client validates and maps the response.\n    return raw as WireQuote;\n  }\n  async getStore(ctx: RequestCtx) {\n    const mapper = import(\"./store\").catch((cause) => {\n      throw new ZappieError(\n        \"server_error\",\n        \"Could not load the storefront store mapper\",\n        { cause },\n      );\n    });\n    const presentation = import(\"./presentation\");\n    const response = this.request(\"/store\", ctx).then((value) =>\n      this.json(value),\n    );\n    const [{ mapStore }, { presentStore }, raw] = await Promise.all([\n      mapper,\n      presentation,\n      response,\n    ]);\n    const store = mapStore(\n      raw,\n      record,\n      text,\n      list,\n      hours,\n      mapMoney,\n      money,\n      opt,\n      isString,\n      isBoolean,\n      mapSeo,\n    );\n    return presentStore(store, raw, presentationError);\n  }\n  async getMenu(\n    ctx: RequestCtx & {\n      branchId: string;\n      ifNoneMatch?: string;\n      metadataOnly?: boolean;\n      fulfilment?: MenuFulfilment;\n    },\n  ): Promise<MenuResponse> {\n    const presentation = import(\"./presentation\");\n    let cursor: string | undefined;\n    const seen = new Set<string>();\n    let output: ReturnType<typeof mapMenu> | undefined;\n    let etag: string | undefined;\n    do {\n      const query = new URLSearchParams({\n        branch: ctx.branchId,\n        ...(ctx.fulfilment\n          ? { fulfilment: wireFulfilment(ctx.fulfilment) }\n          : {}),\n        ...(ctx.metadataOnly ? { metadata_only: \"true\" } : {}),\n        ...(cursor ? { cursor } : {}),\n      });\n      const response = await this.request(\n        `/menus?${query}`,\n        ctx,\n        cursor ? undefined : ctx.ifNoneMatch,\n      );\n      if (response.status === 304) {\n        if (cursor) {\n          throw new ZappieError(\n            \"server_error\",\n            \"Unexpected 304 on a continuation page\",\n          );\n        }\n        return {\n          notModified: true,\n          ...(response.headers.get(\"ETag\")\n            ? { etag: response.headers.get(\"ETag\")! }\n            : {}),\n        };\n      }\n      const raw = record(await this.json(response));\n      const page = (await presentation).presentMenu(\n        mapMenu(raw, ctx.branchId),\n        raw,\n        presentationError,\n      );\n      if (ctx.metadataOnly) {\n        if (Object.keys(page.items).length || raw.next_cursor) {\n          throw new ZappieError(\"server_error\", \"Invalid metadata response\");\n        }\n        return { menu: { ...page, completeness: \"partial\" } };\n      }\n      if (!output) {\n        output = page;\n        etag = response.headers.get(\"ETag\") ?? undefined;\n      } else {\n        if (page.version !== output.version) {\n          throw new ZappieError(\n            \"server_error\",\n            \"Menu changed while fetching pages; retry the read\",\n          );\n        }\n        Object.assign(output.items, page.items);\n        for (const category of page.categories) {\n          const existing = output.categories.find((c) => c.id === category.id);\n          if (existing) {\n            existing.itemIds = [\n              ...new Set([...existing.itemIds, ...category.itemIds]),\n            ];\n          } else {\n            output.categories.push(category);\n          }\n        }\n        for (const section of page.menus ?? []) {\n          const existing = output.menus?.find((m) => m.id === section.id);\n          if (existing) {\n            existing.categoryIds = [\n              ...new Set([...existing.categoryIds, ...section.categoryIds]),\n            ];\n          } else {\n            output.menus?.push(section);\n          }\n        }\n      }\n      cursor =\n        typeof raw.next_cursor === \"string\" && raw.next_cursor\n          ? raw.next_cursor\n          : undefined;\n      if (cursor) {\n        if (seen.has(cursor)) {\n          throw new ZappieError(\n            \"server_error\",\n            \"Repeated menu pagination cursor\",\n          );\n        }\n        seen.add(cursor);\n      }\n    } while (cursor);\n    if (output.menus && output.menus.length > 1) {\n      output.id = `branch:${ctx.branchId}`;\n      output.name = \"Catalogue\";\n      delete output.schedule;\n    }\n    for (const category of output.categories) {\n      for (const id of category.itemIds) {\n        if (!Object.prototype.hasOwnProperty.call(output.items, id)) {\n          throw new ZappieError(\n            \"server_error\",\n            \"Category refers to a missing item\",\n          );\n        }\n      }\n    }\n    if (Object.keys(output.items).length > 2000) {\n      console.warn(\"Zappie menu contains more than 2,000 items\");\n    }\n    return { menu: output, ...(etag ? { etag } : {}) };\n  }\n  async getSelectedMenu(ctx: SelectedMenuRequest) {\n    return (await import(\"./selected-menu\")).selectedMenu(\n      ctx,\n      (path) => this.request(path, ctx, ctx.ifNoneMatch),\n      (response) => this.json(response),\n      mapMenu,\n      () => new ZappieError(\"server_error\", \"Invalid selected menu\"),\n    );\n  }\n  async search(ctx: SearchRequest) {\n    return (await import(\"./search\")).searchPage(\n      ctx,\n      async (path) => this.json(await this.request(path, ctx)),\n      mapMenu,\n      () => new ZappieError(\"server_error\", \"Invalid search page\"),\n    );\n  }\n  async getCategoryPage(\n    ctx: RequestCtx & {\n      branchId: string;\n      menuId: string;\n      categoryId: string;\n      cursor?: string;\n    },\n  ) {\n    const query = new URLSearchParams({\n      branch: ctx.branchId,\n      ...(ctx.cursor ? { cursor: ctx.cursor } : {}),\n    });\n    const raw = await this.json(\n      await this.request(\n        `/menus/${encodeURIComponent(ctx.menuId)}/categories/${encodeURIComponent(ctx.categoryId)}/items?${query}`,\n        ctx,\n      ),\n    );\n    // Loaded on first use: only progressive catalogues read pages.\n    return (await import(\"./category-page\")).categoryPage(\n      record(raw),\n      ctx,\n      mapMenu,\n      () => new ZappieError(\"server_error\", \"Invalid category page\"),\n    );\n  }\n  async getMenuVersion(\n    ctx: RequestCtx & { branchId: string; fulfilment?: MenuFulfilment },\n  ): Promise<MenuVersion> {\n    const value = record(\n      await this.json(\n        await this.request(\n          `/menus/version?${new URLSearchParams({\n            branch: ctx.branchId,\n            ...(ctx.fulfilment\n              ? { fulfilment: wireFulfilment(ctx.fulfilment) }\n              : {}),\n          })}`,\n          ctx,\n        ),\n      ),\n    );\n    if (\n      typeof value.menu_version !== \"string\" ||\n      typeof value.availability_hash !== \"string\"\n    ) {\n      throw new ZappieError(\"server_error\", \"Invalid menu version response\");\n    }\n    return {\n      version: value.menu_version,\n      availabilityHash: value.availability_hash,\n    };\n  }\n  async getItem(ctx: RequestCtx & { branchId: string; itemId: string }) {\n    const item = mapItem(\n      await this.json(\n        await this.request(\n          `/items/${encodeURIComponent(ctx.itemId)}?${new URLSearchParams({ branch: ctx.branchId })}`,\n          ctx,\n        ),\n      ),\n    );\n    if (item.id !== ctx.itemId) {\n      throw new ZappieError(\n        \"server_error\",\n        \"Item response identity does not match the request\",\n      );\n    }\n    return item;\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/transport/search.d.ts

@@ -1,6 +1,6 @@
-import { a as Menu } from '../models-Rg5kQUkv.js';
-import { j as SearchRequest, k as SearchPage } from '../client-Bm2cCYea.js';
-import '../types-CuDvfW9g.js';
+import { a as Menu } from '../models-D__QbqEd.js';
+import { j as SearchRequest, k as SearchPage } from '../client-DzUauU-b.js';
+import '../types-gQXU2gEA.js';
 
 /** Loaded only when search is used; request authentication/retries stay in REST. */
 declare function searchPage(ctx: SearchRequest, read: (path: string) => Promise<unknown>, mapMenu: (value: unknown, branchId: string) => Menu, invalid: () => Error): Promise<SearchPage>;

package/dist/transport/search.js

@@ -1,5 +1,6 @@
 // src/transport/search.ts
 async function searchPage(ctx, read, mapMenu, invalid) {
+  const presentation = import("./presentation.js");
   ctx.signal?.throwIfAborted();
   const query = new URLSearchParams({
     branch: ctx.branchId,
@@ -13,7 +14,11 @@ async function searchPage(ctx, read, mapMenu, invalid) {
     throw invalid();
   }
   const cursor = raw.next_cursor;
-  const menu = mapMenu(raw, ctx.branchId);
+  const menu = (await presentation).presentMenu(
+    mapMenu(raw, ctx.branchId),
+    raw,
+    invalid
+  );
   if (Object.keys(menu.items).length > 25 || cursor != null && (typeof cursor !== "string" || !cursor || cursor === ctx.cursor) || Object.keys(menu.items).some(
     (id) => !menu.categories.some((category) => category.itemIds.includes(id))
   ) || menu.categories.some(

package/dist/transport/search.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/transport/search.ts"],
-  "sourcesContent": ["import type { Menu } from \"../models\";\nimport type { SearchPage, SearchRequest } from \"./types\";\n\n/** Loaded only when search is used; request authentication/retries stay in REST. */\nexport async function searchPage(\n  ctx: SearchRequest,\n  read: (path: string) => Promise<unknown>,\n  mapMenu: (value: unknown, branchId: string) => Menu,\n  invalid: () => Error,\n): Promise<SearchPage> {\n  ctx.signal?.throwIfAborted();\n  const query = new URLSearchParams({\n    branch: ctx.branchId,\n    query: ctx.query.trim(),\n    limit: \"25\",\n    ...(ctx.cursor ? { cursor: ctx.cursor } : {}),\n  });\n  const raw = await read(`/items/search?${query}`);\n  ctx.signal?.throwIfAborted();\n  if (!raw || typeof raw !== \"object\" || Array.isArray(raw)) {\n    throw invalid();\n  }\n  const cursor = (raw as Record<string, unknown>).next_cursor;\n  const menu = mapMenu(raw, ctx.branchId);\n  if (\n    Object.keys(menu.items).length > 25 ||\n    (cursor != null &&\n      (typeof cursor !== \"string\" || !cursor || cursor === ctx.cursor)) ||\n    Object.keys(menu.items).some(\n      (id) =>\n        !menu.categories.some((category) => category.itemIds.includes(id)),\n    ) ||\n    menu.categories.some(\n      (category) =>\n        !menu.menus?.some((source) => source.categoryIds.includes(category.id)),\n    )\n  ) {\n    throw invalid();\n  }\n  return {\n    menu: { ...menu, completeness: \"partial\" },\n    ...(typeof cursor === \"string\" ? { nextCursor: cursor } : {}),\n  };\n}\n"],
-  "mappings": ";AAIA,eAAsB,WACpB,KACA,MACA,SACA,SACqB;AACrB,MAAI,QAAQ,eAAe;AAC3B,QAAM,QAAQ,IAAI,gBAAgB;AAAA,IAChC,QAAQ,IAAI;AAAA,IACZ,OAAO,IAAI,MAAM,KAAK;AAAA,IACtB,OAAO;AAAA,IACP,GAAI,IAAI,SAAS,EAAE,QAAQ,IAAI,OAAO,IAAI,CAAC;AAAA,EAC7C,CAAC;AACD,QAAM,MAAM,MAAM,KAAK,iBAAiB,KAAK,EAAE;AAC/C,MAAI,QAAQ,eAAe;AAC3B,MAAI,CAAC,OAAO,OAAO,QAAQ,YAAY,MAAM,QAAQ,GAAG,GAAG;AACzD,UAAM,QAAQ;AAAA,EAChB;AACA,QAAM,SAAU,IAAgC;AAChD,QAAM,OAAO,QAAQ,KAAK,IAAI,QAAQ;AACtC,MACE,OAAO,KAAK,KAAK,KAAK,EAAE,SAAS,MAChC,UAAU,SACR,OAAO,WAAW,YAAY,CAAC,UAAU,WAAW,IAAI,WAC3D,OAAO,KAAK,KAAK,KAAK,EAAE;AAAA,IACtB,CAAC,OACC,CAAC,KAAK,WAAW,KAAK,CAAC,aAAa,SAAS,QAAQ,SAAS,EAAE,CAAC;AAAA,EACrE,KACA,KAAK,WAAW;AAAA,IACd,CAAC,aACC,CAAC,KAAK,OAAO,KAAK,CAAC,WAAW,OAAO,YAAY,SAAS,SAAS,EAAE,CAAC;AAAA,EAC1E,GACA;AACA,UAAM,QAAQ;AAAA,EAChB;AACA,SAAO;AAAA,IACL,MAAM,EAAE,GAAG,MAAM,cAAc,UAAU;AAAA,IACzC,GAAI,OAAO,WAAW,WAAW,EAAE,YAAY,OAAO,IAAI,CAAC;AAAA,EAC7D;AACF;",
+  "sourcesContent": ["import type { Menu } from \"../models\";\nimport type { SearchPage, SearchRequest } from \"./types\";\n\n/** Loaded only when search is used; request authentication/retries stay in REST. */\nexport async function searchPage(\n  ctx: SearchRequest,\n  read: (path: string) => Promise<unknown>,\n  mapMenu: (value: unknown, branchId: string) => Menu,\n  invalid: () => Error,\n): Promise<SearchPage> {\n  const presentation = import(\"./presentation\");\n  ctx.signal?.throwIfAborted();\n  const query = new URLSearchParams({\n    branch: ctx.branchId,\n    query: ctx.query.trim(),\n    limit: \"25\",\n    ...(ctx.cursor ? { cursor: ctx.cursor } : {}),\n  });\n  const raw = await read(`/items/search?${query}`);\n  ctx.signal?.throwIfAborted();\n  if (!raw || typeof raw !== \"object\" || Array.isArray(raw)) {\n    throw invalid();\n  }\n  const cursor = (raw as Record<string, unknown>).next_cursor;\n  const menu = (await presentation).presentMenu(\n    mapMenu(raw, ctx.branchId),\n    raw,\n    invalid,\n  );\n  if (\n    Object.keys(menu.items).length > 25 ||\n    (cursor != null &&\n      (typeof cursor !== \"string\" || !cursor || cursor === ctx.cursor)) ||\n    Object.keys(menu.items).some(\n      (id) =>\n        !menu.categories.some((category) => category.itemIds.includes(id)),\n    ) ||\n    menu.categories.some(\n      (category) =>\n        !menu.menus?.some((source) => source.categoryIds.includes(category.id)),\n    )\n  ) {\n    throw invalid();\n  }\n  return {\n    menu: { ...menu, completeness: \"partial\" },\n    ...(typeof cursor === \"string\" ? { nextCursor: cursor } : {}),\n  };\n}\n"],
+  "mappings": ";AAIA,eAAsB,WACpB,KACA,MACA,SACA,SACqB;AACrB,QAAM,eAAe,OAAO,mBAAgB;AAC5C,MAAI,QAAQ,eAAe;AAC3B,QAAM,QAAQ,IAAI,gBAAgB;AAAA,IAChC,QAAQ,IAAI;AAAA,IACZ,OAAO,IAAI,MAAM,KAAK;AAAA,IACtB,OAAO;AAAA,IACP,GAAI,IAAI,SAAS,EAAE,QAAQ,IAAI,OAAO,IAAI,CAAC;AAAA,EAC7C,CAAC;AACD,QAAM,MAAM,MAAM,KAAK,iBAAiB,KAAK,EAAE;AAC/C,MAAI,QAAQ,eAAe;AAC3B,MAAI,CAAC,OAAO,OAAO,QAAQ,YAAY,MAAM,QAAQ,GAAG,GAAG;AACzD,UAAM,QAAQ;AAAA,EAChB;AACA,QAAM,SAAU,IAAgC;AAChD,QAAM,QAAQ,MAAM,cAAc;AAAA,IAChC,QAAQ,KAAK,IAAI,QAAQ;AAAA,IACzB;AAAA,IACA;AAAA,EACF;AACA,MACE,OAAO,KAAK,KAAK,KAAK,EAAE,SAAS,MAChC,UAAU,SACR,OAAO,WAAW,YAAY,CAAC,UAAU,WAAW,IAAI,WAC3D,OAAO,KAAK,KAAK,KAAK,EAAE;AAAA,IACtB,CAAC,OACC,CAAC,KAAK,WAAW,KAAK,CAAC,aAAa,SAAS,QAAQ,SAAS,EAAE,CAAC;AAAA,EACrE,KACA,KAAK,WAAW;AAAA,IACd,CAAC,aACC,CAAC,KAAK,OAAO,KAAK,CAAC,WAAW,OAAO,YAAY,SAAS,SAAS,EAAE,CAAC;AAAA,EAC1E,GACA;AACA,UAAM,QAAQ;AAAA,EAChB;AACA,SAAO;AAAA,IACL,MAAM,EAAE,GAAG,MAAM,cAAc,UAAU;AAAA,IACzC,GAAI,OAAO,WAAW,WAAW,EAAE,YAAY,OAAO,IAAI,CAAC;AAAA,EAC7D;AACF;",
   "names": []
 }

package/dist/transport/selected-menu.d.ts

@@ -1,3 +1,3 @@
-export { z as SelectedMenu, h as SelectedMenuRequest, i as SelectedMenuResponse, B as SelectedMenuTransport, D as createSelectedMenuReader, F as selectedMenu, G as selectedMenuKey } from '../client-Bm2cCYea.js';
-import '../models-Rg5kQUkv.js';
-import '../types-CuDvfW9g.js';
+export { z as SelectedMenu, h as SelectedMenuRequest, i as SelectedMenuResponse, B as SelectedMenuTransport, D as createSelectedMenuReader, F as selectedMenu, G as selectedMenuKey } from '../client-DzUauU-b.js';
+import '../models-D__QbqEd.js';
+import '../types-gQXU2gEA.js';

package/dist/transport/selected-menu.js

@@ -1,5 +1,6 @@
 // src/transport/selected-menu.ts
 async function selectedMenu(ctx, request, json, mapMenu, invalid) {
+  const presentation = import("./presentation.js");
   const record = (value) => {
     if (!value || typeof value !== "object" || Array.isArray(value)) {
       throw invalid();
@@ -22,8 +23,12 @@ async function selectedMenu(ctx, request, json, mapMenu, invalid) {
   }
   const raw = record(await json(response));
   const coverage = record(raw.coverage);
-  const menu = mapMenu(raw, ctx.branchId);
-  if (raw.next_cursor || coverage.complete !== true || !Array.isArray(coverage.menuIds) || coverage.menuIds.length !== 1 || coverage.menuIds[0] !== ctx.menuId || menu.menus?.length !== 1 || menu.menus[0]?.id !== ctx.menuId) {
+  const menu = (await presentation).presentMenu(
+    mapMenu(raw, ctx.branchId),
+    raw,
+    invalid
+  );
+  if (raw.next_cursor || coverage.complete !== true || !Array.isArray(coverage.menu_ids) || coverage.menu_ids.length !== 1 || coverage.menu_ids[0] !== ctx.menuId || menu.menus?.length !== 1 || menu.menus[0]?.id !== ctx.menuId) {
     throw invalid();
   }
   return {

package/dist/transport/selected-menu.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/transport/selected-menu.ts"],
-  "sourcesContent": ["import type { Zappie } from \"../client\";\nimport type { Menu } from \"../models\";\nimport type { CatalogueScope } from \"../persist/catalogue\";\nimport type { RequestCtx } from \"./types\";\n\n/** Complete for the named source, never complete for the branch. */\nexport type SelectedMenu = {\n  menu: Menu & { completeness: \"partial\" };\n  coverage: { menuIds: [string]; complete: true };\n};\n/**\n * A source menu with its ETag, or an unchanged response carrying the matching ETag.\n */\nexport type SelectedMenuResponse =\n  (SelectedMenu & { etag: string }) | { notModified: true; etag: string };\n/**\n * A branch-scoped source-menu request with order context and an optional conditional ETag.\n */\nexport type SelectedMenuRequest = RequestCtx & {\n  branchId: string;\n  menuId: string;\n  orderContext: CatalogueScope[\"orderContext\"];\n  ifNoneMatch?: string;\n};\n/**\n * A transport that reads one complete source menu without claiming branch-wide coverage.\n */\nexport type SelectedMenuTransport = {\n  getSelectedMenu(request: SelectedMenuRequest): Promise<SelectedMenuResponse>;\n};\n/** Dependencies are passed by REST to avoid splitting core shared chunks. */\nexport async function selectedMenu(\n  ctx: SelectedMenuRequest,\n  request: (path: string) => Promise<Response>,\n  json: (response: Response) => Promise<unknown>,\n  mapMenu: (value: unknown, branchId: string) => Menu,\n  invalid: () => Error,\n): Promise<SelectedMenuResponse> {\n  // Checked here rather than passed in: every argument REST passes costs the\n  // core bytes, and the core has none to spare.\n  const record = (value: unknown) => {\n    if (!value || typeof value !== \"object\" || Array.isArray(value)) {\n      throw invalid();\n    }\n    return value as Record<string, unknown>;\n  };\n  const query = new URLSearchParams({\n    branch: ctx.branchId,\n    fulfilment: ctx.orderContext === \"dineIn\" ? \"dine_in\" : ctx.orderContext,\n  });\n  const response = await request(\n    `/menus/${encodeURIComponent(ctx.menuId)}?${query}`,\n  );\n  const etag = response.headers.get(\"ETag\");\n  if (!etag) {\n    throw invalid();\n  }\n  if (response.status === 304) {\n    return { notModified: true, etag };\n  }\n  const raw = record(await json(response));\n  const coverage = record(raw.coverage);\n  const menu = mapMenu(raw, ctx.branchId);\n  if (\n    raw.next_cursor ||\n    coverage.complete !== true ||\n    !Array.isArray(coverage.menuIds) ||\n    coverage.menuIds.length !== 1 ||\n    coverage.menuIds[0] !== ctx.menuId ||\n    menu.menus?.length !== 1 ||\n    menu.menus[0]?.id !== ctx.menuId\n  ) {\n    throw invalid();\n  }\n  return {\n    menu: { ...menu, completeness: \"partial\" },\n    coverage: { menuIds: [ctx.menuId], complete: true },\n    etag,\n  };\n}\n/**\n * Build a versioned cache key for a source menu within a store, branch and order context.\n */\nexport function selectedMenuKey(scope: CatalogueScope) {\n  return JSON.stringify([\n    \"selected-menu:v1\",\n    scope.store,\n    scope.branchId,\n    scope.orderContext,\n    scope.menuId,\n  ]);\n}\n/** Dedicated lazy resource: deliberately does not call menu.hydrate(). */\nexport function createSelectedMenuReader(client: Zappie) {\n  const transport = client._internal.transport;\n  return {\n    async read(\n      scope: CatalogueScope,\n      options: { signal?: AbortSignal; ifNoneMatch?: string } = {},\n    ) {\n      if (!transport.getSelectedMenu) {\n        throw new Error(\"Transport does not support selected menus\");\n      }\n      const response = await transport.getSelectedMenu({\n        key: client.config.key,\n        version: client.config.version,\n        branchId: scope.branchId,\n        menuId: scope.menuId,\n        orderContext: scope.orderContext,\n        ...options,\n      });\n      options.signal?.throwIfAborted();\n      if (!(\"notModified\" in response)) {\n        if (\n          response.menu.branchId !== scope.branchId ||\n          response.coverage.menuIds.length !== 1 ||\n          response.coverage.menuIds[0] !== scope.menuId\n        ) {\n          throw new Error(\"Selected menu belongs to another scope\");\n        }\n        const key = selectedMenuKey(scope);\n        const previous =\n          client._internal.cache.snapshot<SelectedMenuResponse>(key).value;\n        if (JSON.stringify(previous) !== JSON.stringify(response)) {\n          client._internal.cache.set(key, response, response.etag);\n        }\n      }\n      return response;\n    },\n  };\n}\n"],
-  "mappings": ";AA+BA,eAAsB,aACpB,KACA,SACA,MACA,SACA,SAC+B;AAG/B,QAAM,SAAS,CAAC,UAAmB;AACjC,QAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,GAAG;AAC/D,YAAM,QAAQ;AAAA,IAChB;AACA,WAAO;AAAA,EACT;AACA,QAAM,QAAQ,IAAI,gBAAgB;AAAA,IAChC,QAAQ,IAAI;AAAA,IACZ,YAAY,IAAI,iBAAiB,WAAW,YAAY,IAAI;AAAA,EAC9D,CAAC;AACD,QAAM,WAAW,MAAM;AAAA,IACrB,UAAU,mBAAmB,IAAI,MAAM,CAAC,IAAI,KAAK;AAAA,EACnD;AACA,QAAM,OAAO,SAAS,QAAQ,IAAI,MAAM;AACxC,MAAI,CAAC,MAAM;AACT,UAAM,QAAQ;AAAA,EAChB;AACA,MAAI,SAAS,WAAW,KAAK;AAC3B,WAAO,EAAE,aAAa,MAAM,KAAK;AAAA,EACnC;AACA,QAAM,MAAM,OAAO,MAAM,KAAK,QAAQ,CAAC;AACvC,QAAM,WAAW,OAAO,IAAI,QAAQ;AACpC,QAAM,OAAO,QAAQ,KAAK,IAAI,QAAQ;AACtC,MACE,IAAI,eACJ,SAAS,aAAa,QACtB,CAAC,MAAM,QAAQ,SAAS,OAAO,KAC/B,SAAS,QAAQ,WAAW,KAC5B,SAAS,QAAQ,CAAC,MAAM,IAAI,UAC5B,KAAK,OAAO,WAAW,KACvB,KAAK,MAAM,CAAC,GAAG,OAAO,IAAI,QAC1B;AACA,UAAM,QAAQ;AAAA,EAChB;AACA,SAAO;AAAA,IACL,MAAM,EAAE,GAAG,MAAM,cAAc,UAAU;AAAA,IACzC,UAAU,EAAE,SAAS,CAAC,IAAI,MAAM,GAAG,UAAU,KAAK;AAAA,IAClD;AAAA,EACF;AACF;AAIO,SAAS,gBAAgB,OAAuB;AACrD,SAAO,KAAK,UAAU;AAAA,IACpB;AAAA,IACA,MAAM;AAAA,IACN,MAAM;AAAA,IACN,MAAM;AAAA,IACN,MAAM;AAAA,EACR,CAAC;AACH;AAEO,SAAS,yBAAyB,QAAgB;AACvD,QAAM,YAAY,OAAO,UAAU;AACnC,SAAO;AAAA,IACL,MAAM,KACJ,OACA,UAA0D,CAAC,GAC3D;AACA,UAAI,CAAC,UAAU,iBAAiB;AAC9B,cAAM,IAAI,MAAM,2CAA2C;AAAA,MAC7D;AACA,YAAM,WAAW,MAAM,UAAU,gBAAgB;AAAA,QAC/C,KAAK,OAAO,OAAO;AAAA,QACnB,SAAS,OAAO,OAAO;AAAA,QACvB,UAAU,MAAM;AAAA,QAChB,QAAQ,MAAM;AAAA,QACd,cAAc,MAAM;AAAA,QACpB,GAAG;AAAA,MACL,CAAC;AACD,cAAQ,QAAQ,eAAe;AAC/B,UAAI,EAAE,iBAAiB,WAAW;AAChC,YACE,SAAS,KAAK,aAAa,MAAM,YACjC,SAAS,SAAS,QAAQ,WAAW,KACrC,SAAS,SAAS,QAAQ,CAAC,MAAM,MAAM,QACvC;AACA,gBAAM,IAAI,MAAM,wCAAwC;AAAA,QAC1D;AACA,cAAM,MAAM,gBAAgB,KAAK;AACjC,cAAM,WACJ,OAAO,UAAU,MAAM,SAA+B,GAAG,EAAE;AAC7D,YAAI,KAAK,UAAU,QAAQ,MAAM,KAAK,UAAU,QAAQ,GAAG;AACzD,iBAAO,UAAU,MAAM,IAAI,KAAK,UAAU,SAAS,IAAI;AAAA,QACzD;AAAA,MACF;AACA,aAAO;AAAA,IACT;AAAA,EACF;AACF;",
+  "sourcesContent": ["import type { Zappie } from \"../client\";\nimport type { Menu } from \"../models\";\nimport type { CatalogueScope } from \"../persist/catalogue\";\nimport type { RequestCtx } from \"./types\";\n\n/** Complete for the named source, never complete for the branch. */\nexport type SelectedMenu = {\n  menu: Menu & { completeness: \"partial\" };\n  coverage: { menuIds: [string]; complete: true };\n};\n/**\n * A source menu with its ETag, or an unchanged response carrying the matching ETag.\n */\nexport type SelectedMenuResponse =\n  (SelectedMenu & { etag: string }) | { notModified: true; etag: string };\n/**\n * A branch-scoped source-menu request with order context and an optional conditional ETag.\n */\nexport type SelectedMenuRequest = RequestCtx & {\n  branchId: string;\n  menuId: string;\n  orderContext: CatalogueScope[\"orderContext\"];\n  ifNoneMatch?: string;\n};\n/**\n * A transport that reads one complete source menu without claiming branch-wide coverage.\n */\nexport type SelectedMenuTransport = {\n  getSelectedMenu(request: SelectedMenuRequest): Promise<SelectedMenuResponse>;\n};\n/** Dependencies are passed by REST to avoid splitting core shared chunks. */\nexport async function selectedMenu(\n  ctx: SelectedMenuRequest,\n  request: (path: string) => Promise<Response>,\n  json: (response: Response) => Promise<unknown>,\n  mapMenu: (value: unknown, branchId: string) => Menu,\n  invalid: () => Error,\n): Promise<SelectedMenuResponse> {\n  const presentation = import(\"./presentation\");\n  // Checked here rather than passed in: every argument REST passes costs the\n  // core bytes, and the core has none to spare.\n  const record = (value: unknown) => {\n    if (!value || typeof value !== \"object\" || Array.isArray(value)) {\n      throw invalid();\n    }\n    return value as Record<string, unknown>;\n  };\n  const query = new URLSearchParams({\n    branch: ctx.branchId,\n    fulfilment: ctx.orderContext === \"dineIn\" ? \"dine_in\" : ctx.orderContext,\n  });\n  const response = await request(\n    `/menus/${encodeURIComponent(ctx.menuId)}?${query}`,\n  );\n  const etag = response.headers.get(\"ETag\");\n  if (!etag) {\n    throw invalid();\n  }\n  if (response.status === 304) {\n    return { notModified: true, etag };\n  }\n  const raw = record(await json(response));\n  const coverage = record(raw.coverage);\n  const menu = (await presentation).presentMenu(\n    mapMenu(raw, ctx.branchId),\n    raw,\n    invalid,\n  );\n  if (\n    raw.next_cursor ||\n    coverage.complete !== true ||\n    !Array.isArray(coverage.menu_ids) ||\n    coverage.menu_ids.length !== 1 ||\n    coverage.menu_ids[0] !== ctx.menuId ||\n    menu.menus?.length !== 1 ||\n    menu.menus[0]?.id !== ctx.menuId\n  ) {\n    throw invalid();\n  }\n  return {\n    menu: { ...menu, completeness: \"partial\" },\n    coverage: { menuIds: [ctx.menuId], complete: true },\n    etag,\n  };\n}\n/**\n * Build a versioned cache key for a source menu within a store, branch and order context.\n */\nexport function selectedMenuKey(scope: CatalogueScope) {\n  return JSON.stringify([\n    \"selected-menu:v1\",\n    scope.store,\n    scope.branchId,\n    scope.orderContext,\n    scope.menuId,\n  ]);\n}\n/** Dedicated lazy resource: deliberately does not call menu.hydrate(). */\nexport function createSelectedMenuReader(client: Zappie) {\n  const transport = client._internal.transport;\n  return {\n    async read(\n      scope: CatalogueScope,\n      options: { signal?: AbortSignal; ifNoneMatch?: string } = {},\n    ) {\n      if (!transport.getSelectedMenu) {\n        throw new Error(\"Transport does not support selected menus\");\n      }\n      const response = await transport.getSelectedMenu({\n        key: client.config.key,\n        version: client.config.version,\n        branchId: scope.branchId,\n        menuId: scope.menuId,\n        orderContext: scope.orderContext,\n        ...options,\n      });\n      options.signal?.throwIfAborted();\n      if (!(\"notModified\" in response)) {\n        if (\n          response.menu.branchId !== scope.branchId ||\n          response.coverage.menuIds.length !== 1 ||\n          response.coverage.menuIds[0] !== scope.menuId\n        ) {\n          throw new Error(\"Selected menu belongs to another scope\");\n        }\n        const key = selectedMenuKey(scope);\n        const previous =\n          client._internal.cache.snapshot<SelectedMenuResponse>(key).value;\n        if (JSON.stringify(previous) !== JSON.stringify(response)) {\n          client._internal.cache.set(key, response, response.etag);\n        }\n      }\n      return response;\n    },\n  };\n}\n"],
+  "mappings": ";AA+BA,eAAsB,aACpB,KACA,SACA,MACA,SACA,SAC+B;AAC/B,QAAM,eAAe,OAAO,mBAAgB;AAG5C,QAAM,SAAS,CAAC,UAAmB;AACjC,QAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,GAAG;AAC/D,YAAM,QAAQ;AAAA,IAChB;AACA,WAAO;AAAA,EACT;AACA,QAAM,QAAQ,IAAI,gBAAgB;AAAA,IAChC,QAAQ,IAAI;AAAA,IACZ,YAAY,IAAI,iBAAiB,WAAW,YAAY,IAAI;AAAA,EAC9D,CAAC;AACD,QAAM,WAAW,MAAM;AAAA,IACrB,UAAU,mBAAmB,IAAI,MAAM,CAAC,IAAI,KAAK;AAAA,EACnD;AACA,QAAM,OAAO,SAAS,QAAQ,IAAI,MAAM;AACxC,MAAI,CAAC,MAAM;AACT,UAAM,QAAQ;AAAA,EAChB;AACA,MAAI,SAAS,WAAW,KAAK;AAC3B,WAAO,EAAE,aAAa,MAAM,KAAK;AAAA,EACnC;AACA,QAAM,MAAM,OAAO,MAAM,KAAK,QAAQ,CAAC;AACvC,QAAM,WAAW,OAAO,IAAI,QAAQ;AACpC,QAAM,QAAQ,MAAM,cAAc;AAAA,IAChC,QAAQ,KAAK,IAAI,QAAQ;AAAA,IACzB;AAAA,IACA;AAAA,EACF;AACA,MACE,IAAI,eACJ,SAAS,aAAa,QACtB,CAAC,MAAM,QAAQ,SAAS,QAAQ,KAChC,SAAS,SAAS,WAAW,KAC7B,SAAS,SAAS,CAAC,MAAM,IAAI,UAC7B,KAAK,OAAO,WAAW,KACvB,KAAK,MAAM,CAAC,GAAG,OAAO,IAAI,QAC1B;AACA,UAAM,QAAQ;AAAA,EAChB;AACA,SAAO;AAAA,IACL,MAAM,EAAE,GAAG,MAAM,cAAc,UAAU;AAAA,IACzC,UAAU,EAAE,SAAS,CAAC,IAAI,MAAM,GAAG,UAAU,KAAK;AAAA,IAClD;AAAA,EACF;AACF;AAIO,SAAS,gBAAgB,OAAuB;AACrD,SAAO,KAAK,UAAU;AAAA,IACpB;AAAA,IACA,MAAM;AAAA,IACN,MAAM;AAAA,IACN,MAAM;AAAA,IACN,MAAM;AAAA,EACR,CAAC;AACH;AAEO,SAAS,yBAAyB,QAAgB;AACvD,QAAM,YAAY,OAAO,UAAU;AACnC,SAAO;AAAA,IACL,MAAM,KACJ,OACA,UAA0D,CAAC,GAC3D;AACA,UAAI,CAAC,UAAU,iBAAiB;AAC9B,cAAM,IAAI,MAAM,2CAA2C;AAAA,MAC7D;AACA,YAAM,WAAW,MAAM,UAAU,gBAAgB;AAAA,QAC/C,KAAK,OAAO,OAAO;AAAA,QACnB,SAAS,OAAO,OAAO;AAAA,QACvB,UAAU,MAAM;AAAA,QAChB,QAAQ,MAAM;AAAA,QACd,cAAc,MAAM;AAAA,QACpB,GAAG;AAAA,MACL,CAAC;AACD,cAAQ,QAAQ,eAAe;AAC/B,UAAI,EAAE,iBAAiB,WAAW;AAChC,YACE,SAAS,KAAK,aAAa,MAAM,YACjC,SAAS,SAAS,QAAQ,WAAW,KACrC,SAAS,SAAS,QAAQ,CAAC,MAAM,MAAM,QACvC;AACA,gBAAM,IAAI,MAAM,wCAAwC;AAAA,QAC1D;AACA,cAAM,MAAM,gBAAgB,KAAK;AACjC,cAAM,WACJ,OAAO,UAAU,MAAM,SAA+B,GAAG,EAAE;AAC7D,YAAI,KAAK,UAAU,QAAQ,MAAM,KAAK,UAAU,QAAQ,GAAG;AACzD,iBAAO,UAAU,MAAM,IAAI,KAAK,UAAU,SAAS,IAAI;AAAA,QACzD;AAAA,MACF;AACA,aAAO;AAAA,IACT;AAAA,EACF;AACF;",
   "names": []
 }

package/dist/transport/store.d.ts

@@ -1,10 +1,9 @@
-import { i as OpeningTime, M as Money, d as Currency, S as Store } from '../models-Rg5kQUkv.js';
+import { i as OpeningTime, M as Money, d as Currency, S as Store } from '../models-D__QbqEd.js';
 
 type Guard<T> = (value: unknown) => value is T;
 type Optional = <K extends string, T>(key: K, value: unknown, is: Guard<T>) => {
     [P in K]?: T;
 };
-/** Core parsing helpers are passed in, in this order, so this lazy entry has no runtime import. */
 declare function mapStore(value: unknown, record: (value: unknown) => Record<string, unknown>, text: (value: unknown) => string, list: (value: unknown) => unknown[], hours: (value: unknown) => OpeningTime[], mapMoney: (value: unknown) => Money, money: (amountMinor: number, currency: Currency) => Money, opt: Optional, isString: Guard<string>, isBoolean: Guard<boolean>, mapSeo: (value: unknown) => NonNullable<Store["seo"]>): Store;
 
 export { mapStore };

package/dist/transport/store.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/transport/store.ts"],
-  "sourcesContent": ["import type { Branch, Fulfilment, OpeningTime, Store } from \"../models\";\nimport type { Currency, Money } from \"../money\";\n\ntype Guard<T> = (value: unknown) => value is T;\ntype Optional = <K extends string, T>(\n  key: K,\n  value: unknown,\n  is: Guard<T>,\n) => { [P in K]?: T };\n\n/** Core parsing helpers are passed in, in this order, so this lazy entry has no runtime import. */\nexport function mapStore(\n  value: unknown,\n  record: (value: unknown) => Record<string, unknown>,\n  text: (value: unknown) => string,\n  list: (value: unknown) => unknown[],\n  hours: (value: unknown) => OpeningTime[],\n  mapMoney: (value: unknown) => Money,\n  money: (amountMinor: number, currency: Currency) => Money,\n  opt: Optional,\n  isString: Guard<string>,\n  isBoolean: Guard<boolean>,\n  mapSeo: (value: unknown) => NonNullable<Store[\"seo\"]>,\n): Store {\n  const coordinates = (input: unknown) => {\n    const coordinates = record(input ?? {});\n    return typeof coordinates.lat === \"number\" &&\n      typeof coordinates.lng === \"number\"\n      ? { lat: coordinates.lat, lng: coordinates.lng }\n      : undefined;\n  };\n  const fulfilment = (input: unknown): Fulfilment => {\n    const value = record(input);\n    return {\n      pickup: value.pickup === true,\n      delivery: value.delivery === true,\n      dineIn: value.dine_in === true,\n      scheduling: value.scheduled === true,\n    };\n  };\n  const source = record(value);\n  const brand = record(source.brand ?? {});\n  const branches: Branch[] = list(source.branches).map((raw) => {\n    const branch = record(raw);\n    const pickup = record(branch.pickup_address ?? {});\n    const pickupCoordinates = coordinates(pickup.coordinates);\n    const pickupAddress = {\n      ...opt(\"placeId\", pickup.place_id, isString),\n      ...(pickupCoordinates ? { coordinates: pickupCoordinates } : {}),\n    };\n    const address =\n      typeof branch.address === \"string\"\n        ? branch.address\n        : branch.address\n          ? text(record(branch.address).line1).trim()\n          : undefined;\n    const addressFields =\n      branch.address && typeof branch.address === \"object\"\n        ? record(branch.address)\n        : {};\n    const branchCoordinates = coordinates(addressFields);\n    return {\n      ...(branch.currency !== undefined\n        ? { currency: money(0, text(branch.currency) as Currency).currency }\n        : {}),\n      ...opt(\"country\", addressFields.country, isString),\n      ...(branch.delivery_regions !== undefined\n        ? {\n            deliveryRegions: list(branch.delivery_regions).map((raw) => {\n              const region = record(raw);\n              return {\n                id: text(region.id),\n                name: text(region.name),\n                fee: mapMoney(region.fee),\n              };\n            }),\n          }\n        : {}),\n      id: text(branch.id),\n      slug: text(branch.slug ?? branch.id),\n      name: text(branch.name),\n      openingTimes: hours(branch.hours),\n      isOpen: branch.is_open === true,\n      fulfilment: fulfilment(branch.fulfilment),\n      ...(address !== undefined ? { address } : {}),\n      ...(isString(branch.phone) ? { phone: branch.phone.trim() } : {}),\n      ...opt(\"timezone\", branch.timezone, isString),\n      ...(branchCoordinates ? { coordinates: branchCoordinates } : {}),\n      ...opt(\"closedUntil\", branch.closed_until, isString),\n      ...opt(\"nextChangeAt\", branch.next_change_at, isString),\n      ...opt(\"isDefault\", branch.is_default, isBoolean),\n      ...(Object.keys(pickupAddress).length > 0 ? { pickupAddress } : {}),\n      ...(branch.social_links !== undefined\n        ? {\n            socialLinks: list(branch.social_links).flatMap((rawLink) => {\n              const link = record(rawLink);\n              // Templates render these as links; only http(s) URLs are kept.\n              try {\n                const url = new URL(text(link.url));\n                return isString(link.type) &&\n                  (url.protocol === \"https:\" || url.protocol === \"http:\")\n                  ? [{ type: link.type, url: url.href }]\n                  : [];\n              } catch {\n                return [];\n              }\n            }),\n          }\n        : {}),\n      ...(branch.minimum_order\n        ? { minimumOrder: mapMoney(branch.minimum_order) }\n        : {}),\n      ...(branch.special_hours\n        ? {\n            specialHours: list(branch.special_hours).map((rawHours) => {\n              const special = record(rawHours);\n              return {\n                date: text(special.date),\n                closed: special.closed === true,\n                ...opt(\"opens\", special.open, isString),\n                ...opt(\"closes\", special.close, isString),\n              };\n            }),\n          }\n        : {}),\n    };\n  });\n  const allowed = [\n    \"card\",\n    \"bank_transfer\",\n    \"wallet\",\n    \"zap\",\n    \"apple_pay\",\n    \"google_pay\",\n  ];\n  const paymentMethods = list(source.payment_methods)\n    .map(text)\n    .filter((method) => {\n      if (allowed.includes(method)) {\n        return true;\n      }\n      console.warn(\n        `Zappie payment method \"${method}\" is newer than this SDK and was skipped`,\n      );\n      return false;\n    });\n  const aggregate = {\n    pickup: false,\n    delivery: false,\n    dineIn: false,\n    scheduling: false,\n  };\n  for (const branch of branches) {\n    for (const key of Object.keys(aggregate) as (keyof Fulfilment)[]) {\n      aggregate[key] ||= branch.fulfilment[key];\n    }\n  }\n  const templateSettings = record(source.template_settings ?? {}) as Record<\n    string,\n    string | number | boolean\n  >;\n  return {\n    ...(source.seo != null ? { seo: mapSeo(source.seo) } : {}),\n    id: text(source.id),\n    slug: text(source.slug),\n    name: text(source.name),\n    currency: money(0, text(source.currency) as Currency).currency,\n    timezone: text(source.timezone),\n    ...opt(\"description\", source.description, isString),\n    ...(source.template_settings !== undefined ? { templateSettings } : {}),\n    brand: {\n      ...opt(\"logoUrl\", brand.logo_url, isString),\n      ...opt(\"coverImageUrl\", brand.cover_image_url, isString),\n    },\n    fulfilment: source.fulfilment ? fulfilment(source.fulfilment) : aggregate,\n    paymentMethods: paymentMethods as Store[\"paymentMethods\"],\n    branches,\n  };\n}\n"],
+  "sourcesContent": ["import type { Branch, Fulfilment, OpeningTime, Store } from \"../models\";\nimport type { Currency, Money } from \"../money\";\n\ntype Guard<T> = (value: unknown) => value is T;\ntype Optional = <K extends string, T>(\n  key: K,\n  value: unknown,\n  is: Guard<T>,\n) => { [P in K]?: T };\n\n// Core parsing helpers are shared with the transport mapper.\nexport function mapStore(\n  value: unknown,\n  record: (value: unknown) => Record<string, unknown>,\n  text: (value: unknown) => string,\n  list: (value: unknown) => unknown[],\n  hours: (value: unknown) => OpeningTime[],\n  mapMoney: (value: unknown) => Money,\n  money: (amountMinor: number, currency: Currency) => Money,\n  opt: Optional,\n  isString: Guard<string>,\n  isBoolean: Guard<boolean>,\n  mapSeo: (value: unknown) => NonNullable<Store[\"seo\"]>,\n): Store {\n  const coordinates = (input: unknown) => {\n    const coordinates = record(input ?? {});\n    return typeof coordinates.lat === \"number\" &&\n      typeof coordinates.lng === \"number\"\n      ? { lat: coordinates.lat, lng: coordinates.lng }\n      : undefined;\n  };\n  const fulfilment = (input: unknown): Fulfilment => {\n    const value = record(input);\n    return {\n      pickup: value.pickup === true,\n      delivery: value.delivery === true,\n      dineIn: value.dine_in === true,\n      scheduling: value.scheduled === true,\n    };\n  };\n  const source = record(value);\n  const brand = record(source.brand ?? {});\n  const branches: Branch[] = list(source.branches).map((raw) => {\n    const branch = record(raw);\n    const pickup = record(branch.pickup_address ?? {});\n    const pickupCoordinates = coordinates(pickup.coordinates);\n    const pickupAddress = {\n      ...opt(\"placeId\", pickup.place_id, isString),\n      ...(pickupCoordinates ? { coordinates: pickupCoordinates } : {}),\n    };\n    const address =\n      typeof branch.address === \"string\"\n        ? branch.address\n        : branch.address\n          ? text(record(branch.address).line1).trim()\n          : undefined;\n    const addressFields =\n      branch.address && typeof branch.address === \"object\"\n        ? record(branch.address)\n        : {};\n    const branchCoordinates = coordinates(addressFields);\n    return {\n      ...(branch.currency !== undefined\n        ? { currency: money(0, text(branch.currency) as Currency).currency }\n        : {}),\n      ...opt(\"country\", addressFields.country, isString),\n      ...(branch.delivery_regions !== undefined\n        ? {\n            deliveryRegions: list(branch.delivery_regions).map((raw) => {\n              const region = record(raw);\n              return {\n                id: text(region.id),\n                name: text(region.name),\n                fee: mapMoney(region.fee),\n              };\n            }),\n          }\n        : {}),\n      id: text(branch.id),\n      slug: text(branch.slug ?? branch.id),\n      name: text(branch.name),\n      openingTimes: hours(branch.hours),\n      isOpen: branch.is_open === true,\n      fulfilment: fulfilment(branch.fulfilment),\n      ...(address !== undefined ? { address } : {}),\n      ...(isString(branch.phone) ? { phone: branch.phone.trim() } : {}),\n      ...opt(\"timezone\", branch.timezone, isString),\n      ...(branchCoordinates ? { coordinates: branchCoordinates } : {}),\n      ...opt(\"closedUntil\", branch.closed_until, isString),\n      ...opt(\"nextChangeAt\", branch.next_change_at, isString),\n      ...opt(\"isDefault\", branch.is_default, isBoolean),\n      ...(Object.keys(pickupAddress).length > 0 ? { pickupAddress } : {}),\n      ...(branch.social_links !== undefined\n        ? {\n            socialLinks: list(branch.social_links).flatMap((rawLink) => {\n              const link = record(rawLink);\n              // Templates render these as links; only http(s) URLs are kept.\n              try {\n                const url = new URL(text(link.url));\n                return isString(link.type) &&\n                  (url.protocol === \"https:\" || url.protocol === \"http:\")\n                  ? [{ type: link.type, url: url.href }]\n                  : [];\n              } catch {\n                return [];\n              }\n            }),\n          }\n        : {}),\n      ...(branch.minimum_order\n        ? { minimumOrder: mapMoney(branch.minimum_order) }\n        : {}),\n      ...(branch.special_hours\n        ? {\n            specialHours: list(branch.special_hours).map((rawHours) => {\n              const special = record(rawHours);\n              return {\n                date: text(special.date),\n                closed: special.closed === true,\n                ...opt(\"opens\", special.open, isString),\n                ...opt(\"closes\", special.close, isString),\n              };\n            }),\n          }\n        : {}),\n    };\n  });\n  const allowed = [\n    \"card\",\n    \"bank_transfer\",\n    \"wallet\",\n    \"zap\",\n    \"apple_pay\",\n    \"google_pay\",\n  ];\n  const paymentMethods = list(source.payment_methods)\n    .map(text)\n    .filter((method) => {\n      if (allowed.includes(method)) {\n        return true;\n      }\n      console.warn(\n        `Zappie payment method \"${method}\" is newer than this SDK and was skipped`,\n      );\n      return false;\n    });\n  const aggregate = {\n    pickup: false,\n    delivery: false,\n    dineIn: false,\n    scheduling: false,\n  };\n  for (const branch of branches) {\n    for (const key of Object.keys(aggregate) as (keyof Fulfilment)[]) {\n      aggregate[key] ||= branch.fulfilment[key];\n    }\n  }\n  const templateSettings = record(source.template_settings ?? {}) as Record<\n    string,\n    string | number | boolean\n  >;\n  return {\n    ...(source.seo != null ? { seo: mapSeo(source.seo) } : {}),\n    id: text(source.id),\n    slug: text(source.slug),\n    name: text(source.name),\n    currency: money(0, text(source.currency) as Currency).currency,\n    timezone: text(source.timezone),\n    ...opt(\"description\", source.description, isString),\n    ...(source.template_settings !== undefined ? { templateSettings } : {}),\n    brand: {\n      ...opt(\"logoUrl\", brand.logo_url, isString),\n      ...opt(\"coverImageUrl\", brand.cover_image_url, isString),\n    },\n    fulfilment: source.fulfilment ? fulfilment(source.fulfilment) : aggregate,\n    paymentMethods: paymentMethods as Store[\"paymentMethods\"],\n    branches,\n  };\n}\n"],
   "mappings": "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",
   "names": ["coordinates", "value", "raw"]
 }

package/dist/{types-CuDvfW9g.d.ts → types-gQXU2gEA.d.ts}

@@ -1,4 +1,4 @@
-import { d as Currency, M as Money, I as Item } from './models-Rg5kQUkv.js';
+import { d as Currency, M as Money, I as Item } from './models-D__QbqEd.js';
 
 /**
  * An item selection you submit to the cart, with optional quantity, choices, inputs and source menu.
@@ -142,6 +142,8 @@ type Quote = {
         label: string;
         amount: Money;
     }[];
+    /** The sum of `fees`, so you can show one fees line. Zero when there are none. Delivery is not included. */
+    feesTotal: Money;
     delivery?: Money;
     discounts: {
         code: string;

package/dist/url/index.d.ts

@@ -23,7 +23,7 @@ declare const STOREFRONT_V1_QUERY_PARAMETERS: readonly ["ref", "utm_source", "pa
 /**
  * Recognized storefront query keys, including the v1 keys and checkout return and session keys.
  */
-declare const STOREFRONT_QUERY_PARAMETERS: readonly ["ref", "utm_source", "payment_id", "context", "prefetch", "business_tag", "pay_point_id", "dine_in_order_id", "no_context", "payment_context_id", "ws", "preview", "device", "auto_scroll", "pickup", "branch_closed", "order_id", "modal_id", "lightbox", "menu_id", "payment_method", "beacon_id", "menu_group_id", "category_id", "menu_layout", "can_schedule", "refresh", "success", "grant", "portal", "can_download_receipt", "auth_modal_id", "experimental_otp", "branch", "business", "env", "switched_branch", "from", "template", "catalog_rendering", "catalogue_search", "catalogue_categories", "return", "session"];
+declare const STOREFRONT_QUERY_PARAMETERS: readonly ["ref", "utm_source", "payment_id", "context", "prefetch", "business_tag", "pay_point_id", "dine_in_order_id", "no_context", "payment_context_id", "ws", "preview", "device", "auto_scroll", "pickup", "branch_closed", "order_id", "modal_id", "lightbox", "menu_id", "payment_method", "beacon_id", "menu_group_id", "category_id", "menu_layout", "can_schedule", "refresh", "success", "grant", "portal", "can_download_receipt", "auth_modal_id", "experimental_otp", "branch", "business", "env", "switched_branch", "from", "template", "catalog_rendering", "catalogue_search", "catalogue_categories", "menu", "return", "session"];
 /**
  * Readonly query parameter names and string values carried by storefront page state.
  */
@@ -150,6 +150,9 @@ declare const parseStorefrontUrl: (input: StorefrontUrlInput, options?: Storefro
  * Find the canonical v2 URL for a recognized storefront route.
  * Compares normalized paths and sorted query parameters to avoid unnecessary redirects.
  *
+ * Callers choose the HTTP status when serving the redirect.
+ * Zappie templates use temporary redirects (302) for now.
+ *
  * @returns A redirect target, or null for v1, an unknown route, a parse/build failure or an equivalent URL.
  */
 declare const storefrontRedirect: (input: StorefrontUrlInput, options?: StorefrontUrlOptions) => string | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zappie/sdk",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Typed, framework-agnostic client for Zappie menus, carts, checkout, auth and events.",
   "type": "module",
   "sideEffects": false,
@@ -61,6 +61,10 @@
       "types": "./dist/visits/index.d.ts",
       "import": "./dist/visits/index.js"
     },
+    "./pricing": {
+      "types": "./dist/pricing/index.d.ts",
+      "import": "./dist/pricing/index.js"
+    },
     "./template": {
       "types": "./dist/template/index.d.ts",
       "import": "./dist/template/index.js"
@@ -109,7 +113,7 @@
     "url": "https://github.com/zappie/storefront/issues"
   },
   "scripts": {
-    "build": "tsup && tsup --config tsup.checkout.config.ts && tsup --config tsup.customer.config.ts && tsup --config tsup.places.config.ts && tsup --config tsup.url.config.ts && tsup --config tsup.visits.config.ts && tsup --config tsup.site-config.config.ts && tsup --config tsup.template.config.ts && node ../../scripts/release-packages/build-modules.mjs",
+    "build": "tsup && tsup --config tsup.checkout.config.ts && tsup --config tsup.customer.config.ts && tsup --config tsup.places.config.ts && tsup --config tsup.url.config.ts && tsup --config tsup.visits.config.ts && tsup --config tsup.pricing.config.ts && tsup --config tsup.site-config.config.ts && tsup --config tsup.template.config.ts && node ../../scripts/release-packages/build-modules.mjs",
     "test": "vitest run --root ../.. packages/sdk/test",
     "size": "node ../../scripts/release-packages/size-sdk.mjs && size-limit"
   }