@zappie/sdk 0.1.0 → 0.1.2

package/dist/client.js

@@ -0,0 +1,253 @@
+// src/client.ts
+import { createCart } from "./cart/index.js";
+import { createWorkingSet } from "./cart/working-set.js";
+import { API_VERSION, validateConfig } from "./config.js";
+import { ZappieError } from "./errors.js";
+import { Cache } from "./internal/cache.js";
+import { createEmitter } from "./internal/emitter.js";
+import { format } from "./money.js";
+import { RestTransport } from "./transport/rest.js";
+function buildClient(input, secret = false) {
+  const mode = validateConfig(input, secret);
+  const config = Object.freeze({
+    ...input,
+    version: input.version ?? API_VERSION,
+    telemetry: input.telemetry ?? true
+  });
+  const transport = input.transport ?? new RestTransport({
+    ...input.baseUrl ? { baseUrl: input.baseUrl } : {},
+    ...input.fetch ? { fetch: input.fetch } : {}
+  });
+  const events = createEmitter();
+  const cache = new Cache((error) => events.emit("error", { error }));
+  const ctx = (signal) => ({
+    key: config.key,
+    version: config.version,
+    ...signal ? { signal } : {}
+  });
+  const store = {
+    get: (opts = {}) => cache.get(
+      "store",
+      async (signal) => ({ value: await transport.getStore(ctx(signal)) }),
+      opts.signal
+    ),
+    peek: () => cache.snapshot("store").value
+  };
+  const resolveBranch = (value, requested) => {
+    const selected = requested ?? config.branch;
+    const branch = selected ? value.branches.find((b) => b.id === selected || b.slug === selected) : value.branches.find((b) => b.isDefault) ?? value.branches[0];
+    if (!branch) {
+      throw new ZappieError(
+        "branch_not_found",
+        "No matching storefront branch",
+        { param: "branch" }
+      );
+    }
+    return branch;
+  };
+  let hydratedBranch;
+  const branchKey = (requested) => {
+    const value = store.peek();
+    if (value) {
+      return resolveBranch(value, requested).id;
+    }
+    const selected = requested ?? config.branch;
+    if (hydratedBranch && (selected === void 0 || selected === config.branch || selected === hydratedBranch)) {
+      return hydratedBranch;
+    }
+    return selected ?? "default";
+  };
+  const menuKey = (requested) => `menu:${branchKey(requested)}`;
+  const menu = {
+    async search(query, opts = {}) {
+      if (!transport.search) {
+        throw new ZappieError(
+          "invalid_request",
+          "Transport does not support search"
+        );
+      }
+      const branch = resolveBranch(await store.get(opts), opts.branch);
+      return transport.search({
+        ...ctx(opts.signal),
+        branchId: branch.id,
+        query,
+        ...opts.cursor ? { cursor: opts.cursor } : {}
+      });
+    },
+    async get(opts = {}) {
+      const branch = resolveBranch(await store.get(opts), opts.branch);
+      return cache.get(
+        `menu:${branch.id}${opts.metadataOnly ? ":partial" : ""}`,
+        async (signal, entry) => {
+          const response = await transport.getMenu({
+            ...ctx(signal),
+            branchId: branch.id,
+            ...opts.metadataOnly ? { metadataOnly: true } : {},
+            ...entry.etag ? { ifNoneMatch: entry.etag } : {}
+          });
+          if ("notModified" in response) {
+            if (!entry.value) {
+              throw new ZappieError(
+                "server_error",
+                "Received 304 without a cached menu"
+              );
+            }
+            return {
+              value: entry.value,
+              ...response.etag ?? entry.etag ? { etag: response.etag ?? entry.etag } : {}
+            };
+          }
+          if (!opts.metadataOnly && response.menu.completeness === "partial") {
+            throw new ZappieError(
+              "server_error",
+              "Partial catalogue cannot satisfy a complete read"
+            );
+          }
+          if (response.menu.branchId !== branch.id) {
+            throw new ZappieError(
+              "server_error",
+              "Menu belongs to a different branch"
+            );
+          }
+          return {
+            value: response.menu,
+            etag: response.etag ?? response.menu.version,
+            onStored: () => {
+              if (entry.value && entry.value.version !== response.menu.version) {
+                events.emit("menu:updated", {
+                  branchId: branch.id,
+                  version: response.menu.version
+                });
+              }
+            }
+          };
+        },
+        opts.signal
+      );
+    },
+    peek: (branch) => cache.snapshot(menuKey(branch)).value ?? cache.snapshot(`${menuKey(branch)}:partial`).value,
+    async page(menuId, categoryId, opts = {}) {
+      if (!transport.getCategoryPage) {
+        throw new ZappieError(
+          "invalid_request",
+          "Transport does not support category pages"
+        );
+      }
+      const branch = resolveBranch(await store.get(opts), opts.branch);
+      return transport.getCategoryPage({
+        ...ctx(opts.signal),
+        branchId: branch.id,
+        menuId,
+        categoryId,
+        ...opts.cursor ? { cursor: opts.cursor } : {}
+      });
+    },
+    async version(opts = {}) {
+      const branch = resolveBranch(await store.get(opts), opts.branch);
+      return transport.getMenuVersion({
+        ...ctx(opts.signal),
+        branchId: branch.id
+      });
+    },
+    async item(id, opts = {}) {
+      const branch = resolveBranch(await store.get(opts), opts.branch);
+      if (!menu.peek(branch.id) || menu.peek(branch.id)?.completeness === "partial") {
+        await menu.get({ ...opts, metadataOnly: true });
+      }
+      return readItem(id, branch.id, false, opts.signal);
+    },
+    hydrate(value) {
+      hydratedBranch ?? (hydratedBranch = value.branchId);
+      const previous = cache.snapshot(`menu:${value.branchId}`).value;
+      cache.set(
+        `menu:${value.branchId}${value.completeness === "partial" ? ":partial" : ""}`,
+        value,
+        value.version
+      );
+      if (previous && previous.version !== value.version) {
+        events.emit("menu:updated", {
+          branchId: value.branchId,
+          version: value.version
+        });
+      }
+    }
+  };
+  const itemValues = /* @__PURE__ */ new Map();
+  const peekItem = (id, branch) => itemValues.get(`${branch}:${id}`);
+  const readItem = async (id, branch, fresh = false, signal) => {
+    const complete = cache.snapshot(`menu:${branch}`).value;
+    if (!fresh && complete && Object.hasOwn(complete.items, id)) {
+      return complete.items[id];
+    }
+    const load = (requestSignal = signal) => transport.getItem({
+      ...ctx(requestSignal),
+      branchId: branch,
+      itemId: id
+    });
+    try {
+      const value = fresh ? await load() : await cache.get(
+        `item:${branch}:${id}`,
+        async (requestSignal) => ({ value: await load(requestSignal) }),
+        signal
+      );
+      if (fresh) {
+        cache.set(`item:${branch}:${id}`, value);
+      }
+      itemValues.set(`${branch}:${id}`, value);
+      return value;
+    } catch (error) {
+      if (error.code === "item_not_found") {
+        itemValues.delete(`${branch}:${id}`);
+        cache.set(`item:${branch}:${id}`, void 0);
+      }
+      throw error;
+    }
+  };
+  const workingSet = createWorkingSet({
+    menu,
+    store,
+    transport,
+    context: ctx,
+    peekItem,
+    readItem
+  });
+  const { cart, setLegacyReader, cartCatalogue } = createCart({
+    workingSet,
+    config,
+    menu,
+    store,
+    transport,
+    context: ctx,
+    events
+  });
+  return Object.freeze({
+    cart,
+    config,
+    mode,
+    store,
+    menu,
+    format,
+    on: events.on,
+    _internal: {
+      cartCatalogue,
+      setLegacyReader,
+      transport,
+      cache,
+      emit: events.emit,
+      menuKey,
+      hydrateStore: (value) => cache.set("store", value)
+    }
+  });
+}
+function createZappie(config) {
+  const client = buildClient(config);
+  if (client.mode === "test" && typeof window !== "undefined") {
+    void import("./debug.js").then(({ installDebug }) => installDebug(client));
+  }
+  return client;
+}
+export {
+  buildClient,
+  createZappie
+};
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/config/index.js

@@ -1 +1,13 @@
-var l={jsKbGz:200,cssKbGz:50,lcpMs:2500},f=["react","react-dom","react-router","@react-router/*","@zappie/*","tailwindcss","@tailwindcss/*","clsx","tailwind-merge","class-variance-authority","lucide-react","date-fns","embla-carousel-react","framer-motion/motion","zod","@radix-ui/*","sonner","vaul"];var u=e=>typeof e=="object"&&e!==null&&!Array.isArray(e);function v(e,n){let o=Array.from({length:n.length+1},(s,t)=>t);for(let s=1;s<=e.length;s+=1){let t=[s];for(let i=1;i<=n.length;i+=1)t[i]=Math.min((t[i-1]??0)+1,(o[i]??0)+1,(o[i-1]??0)+(e[s-1]===n[i-1]?0:1));o=t;}return o[n.length]??1/0}function g(e,n,o,s){for(let t of Object.keys(e)){if(n.includes(t))continue;let i=n.map(a=>({candidate:a,score:v(t,a)})).sort((a,x)=>a.score-x.score)[0],r=i&&i.score<=2?i.candidate:void 0;s({path:o?`${o}.${t}`:t,code:"unknown_key",message:r?`Unknown field "${t}". Rename it to "${r}".`:`Unknown field "${t}". Remove it from the configuration.`,severity:"error"});}}var p=e=>typeof e=="string"&&e.trim().length>0,m=e=>e.length<=214&&/^(?:@[a-z0-9][a-z0-9._~-]*\/[a-z0-9][a-z0-9._~-]*|[a-z0-9][a-z0-9._~-]*)$/.test(e),y=e=>f.some(n=>n.endsWith("/*")?e.startsWith(n.slice(0,-1)):e===n);function h(e){let o=e.startsWith("*.")?e.slice(2):e;return !o.includes(".")||/^\d+(?:\.\d+){3}$/.test(o)||o.length>253||o.includes("..")?false:o.split(".").every(s=>s.length>0&&s.length<=63&&/^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/i.test(s))}function d(e,n,o,s,t){if(e!==void 0){if(!u(e)){s({path:n,code:"invalid_type",message:`Expected an object. Set ${n} to an object or remove it.`,severity:"error"});return}g(e,o,n,s),t(e);}}function b(e,n,o){d(e,"budgets",["jsKbGz","cssKbGz","lcpMs","override"],n,s=>{d(s.override,"budgets.override",["reason"],n,t=>{(typeof t.reason!="string"||!t.reason.trim())&&o("budgets.override.reason","invalid_format","Expected a non-blank reason. Explain why the default budget must be raised.");});for(let t of ["jsKbGz","cssKbGz","lcpMs"]){let i=s[t];if(i!==void 0){if(typeof i!="number"||!Number.isFinite(i)||i<=0)o(`budgets.${t}`,"invalid_type",`Expected a positive finite number. Set budgets.${t} to a number greater than zero.`);else if(i>l[t]){let r=`The ${t} budget exceeds the ${l[t]} default.`;s.override===void 0?o(`budgets.${t}`,"budget_override",`${r} Add budgets.override.reason to explain the increase.`):n({path:`budgets.${t}`,code:"budget_override",message:`${r} Lower it to the default when the exception is no longer needed.`,severity:"warning"});}}}});}function w(e,n,o){d(e,"analytics",["forward"],n,s=>{d(s.forward,"analytics.forward",["ga4","metaPixel"],n,t=>{t.ga4!==void 0&&(typeof t.ga4!="string"||!/^G-[A-Z0-9]+$/.test(t.ga4))&&o("analytics.forward.ga4","invalid_format","Expected a GA4 measurement id beginning with G-. Use a value such as G-XXXXXXXXXX."),t.metaPixel!==void 0&&(typeof t.metaPixel!="string"||!/^\d+$/.test(t.metaPixel))&&o("analytics.forward.metaPixel","invalid_format","Expected a numeric Meta Pixel id. Use digits only.");});});}var k=["store","branches","theme","prerender","menu","packages","outbound","budgets","analytics"];function _(e){let n=[],o=t=>n.push(t),s=(t,i,r)=>o({path:t,code:i,message:r,severity:"error"});return u(e)?(g(e,k,"",o),E(e.store,"store",s),A(e.theme,s),c(e.branches,"branches",s,{nonempty:true,unique:true,slug:true}),C(e.prerender,s),d(e.menu,"menu",["hiddenCategories"],o,t=>{c(t.hiddenCategories,"menu.hiddenCategories",s);}),d(e.packages,"packages",["allow"],o,t=>{c(t.allow,"packages.allow",s)?.forEach((r,a)=>{y(r)?o({path:`packages.allow[${a}]`,code:"redundant_allowlist",message:`${r} is already globally allowed. Remove it from packages.allow.`,severity:"warning"}):m(r)||s(`packages.allow[${a}]`,"invalid_format","Expected a lowercase npm package name. Use a package name such as lucide-react or @scope/name.");});}),d(e.outbound,"outbound",["allow"],o,t=>{c(t.allow,"outbound.allow",s)?.forEach((r,a)=>{h(r)||s(`outbound.allow[${a}]`,"invalid_format","Expected a hostname or leading *. subdomain pattern without a scheme, path, port or IP. Use a value such as api.example.com.");});}),b(e.budgets,o,s),w(e.analytics,o,s),{valid:!n.some(t=>t.severity==="error"),issues:n}):{valid:false,issues:[{path:"$",code:"invalid_type",message:"Expected a configuration object. Export an object from zappie.config.ts.",severity:"error"}]}}function E(e,n,o){p(e)||o(n,e===void 0?"missing_required":"invalid_type",`Expected a non-empty storefront slug. Set ${n} to the slug used by createZappie().`);}function A(e,n){typeof e!="string"?n("theme",e===void 0?"missing_required":"invalid_type","Expected a relative .json path. Set theme to a value such as ./theme.json."):(!/\.json$/.test(e)||/^(?:[a-z][a-z\d+.-]*:|\/|\\)/i.test(e)||e.includes("\\"))&&n("theme","invalid_format","Expected a relative .json path. Use a value such as ./theme.json.");}function c(e,n,o,s={}){if(e!==void 0){if(!Array.isArray(e)||e.some(t=>typeof t!="string")){o(n,"invalid_type",`Expected an array of strings. Set ${n} to string values.`);return}return s.nonempty&&e.length===0&&o(n,"invalid_format",`Expected at least one value. Add a value to ${n} or remove the field.`),e.forEach((t,i)=>{s.slug&&!p(t)&&o(`${n}[${i}]`,"invalid_format","Expected a non-empty branch slug. Remove the empty value or use a branch slug.");}),s.unique&&new Set(e).size!==e.length&&o(n,"duplicate",`Expected unique values. Remove duplicates from ${n}.`),e}}function C(e,n){c(e,"prerender",n,{unique:true})?.forEach((s,t)=>{s.startsWith("/")||n(`prerender[${t}]`,"invalid_format","Expected a route starting with /. Prefix the route with /.");});}function P(e){return e}export{l as DEFAULT_BUDGETS,f as GLOBAL_PACKAGE_ALLOWLIST,P as defineConfig,_ as validateConfig};
+// src/site-config/index.ts
+import { DEFAULT_BUDGETS, GLOBAL_PACKAGE_ALLOWLIST } from "../site-config/types.js";
+import { validateConfig } from "../site-config/validate.js";
+function defineConfig(config) {
+  return config;
+}
+export {
+  DEFAULT_BUDGETS,
+  GLOBAL_PACKAGE_ALLOWLIST,
+  defineConfig,
+  validateConfig
+};
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/site-config/index.ts"],
+  "sourcesContent": ["import type { ZappieSiteConfig } from \"./types\";\n\n/**\n * Return your site configuration unchanged with TypeScript checking.\n * Use validateConfig to check values at runtime.\n *\n * @example\n * ```ts\n * export default defineConfig({ store: \"my-store\", theme: \"./theme.json\" });\n * ```\n */\nexport function defineConfig(config: ZappieSiteConfig): ZappieSiteConfig {\n  return config;\n}\n\nexport { DEFAULT_BUDGETS, GLOBAL_PACKAGE_ALLOWLIST } from \"./types\";\nexport type { ConfigIssue, ConfigValidation, ZappieSiteConfig } from \"./types\";\nexport { validateConfig } from \"./validate\";\n"],
+  "mappings": ";AAeA,SAAS,iBAAiB,gCAAgC;AAE1D,SAAS,sBAAsB;AANxB,SAAS,aAAa,QAA4C;AACvE,SAAO;AACT;",
+  "names": []
+}

package/dist/config.js

@@ -0,0 +1,28 @@
+// src/config.ts
+import { ZappieError } from "./errors.js";
+var API_VERSION = "2026-10-01";
+function validateConfig(config, secret = false) {
+  if (!config.store?.trim()) {
+    throw new ZappieError("invalid_request", "A storefront slug is required");
+  }
+  if (secret && typeof window !== "undefined") {
+    throw new ZappieError(
+      "invalid_request",
+      "Secret keys cannot be used in a browser"
+    );
+  }
+  const pattern = secret ? /^sk_(test|live)_.+$/ : /^pk_(test|live)_.+$/;
+  const match = pattern.exec(config.key);
+  if (!match) {
+    throw new ZappieError(
+      "invalid_request",
+      secret ? "A secret sk_test_ or sk_live_ key is required" : "Use a publishable pk_test_ or pk_live_ key; secret keys are never accepted by createZappie"
+    );
+  }
+  return match[1];
+}
+export {
+  API_VERSION,
+  validateConfig
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +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;",
+  "names": []
+}

package/dist/customer/client.js

@@ -0,0 +1,149 @@
+// src/customer/client.ts
+import { apiError, requestWithRetry } from "../internal/customer-http.js";
+import { CustomerError } from "./error.js";
+import { currentPath, safeReturnTo, signIn, signOut } from "./navigation.js";
+import { createCustomerRequest } from "./request.js";
+import { watchOrder } from "./watch-order.js";
+var DEFAULT_CUSTOMER_BASE = "/_zappie/api";
+var DEFAULT_SESSION_PATH = "/_zappie/session";
+function same(left, right) {
+  return left?.id === right?.id && left?.given_name === right?.given_name && left?.phone_masked === right?.phone_masked;
+}
+function createCustomer(options = {}) {
+  const base = (options.customerBase ?? DEFAULT_CUSTOMER_BASE).replace(
+    /\/+$/,
+    ""
+  );
+  const sessionPath = options.sessionPath ?? DEFAULT_SESSION_PATH;
+  const fetcher = options.fetch ?? globalThis.fetch;
+  let customer = options.initialCustomer ?? null;
+  let state = options.initialCustomer === void 0 ? "unknown" : customer ? "authenticated" : "anonymous";
+  const listeners = /* @__PURE__ */ new Set();
+  const update = (next, nextState) => {
+    if (state === nextState && same(customer, next)) {
+      return;
+    }
+    state = nextState;
+    customer = next;
+    globalThis.__zappieEmit?.("auth:changed", { state, customer });
+    for (const listener of listeners) {
+      listener(state, customer);
+    }
+  };
+  const request = createCustomerRequest(base, fetcher, () => {
+    update(null, "anonymous");
+  });
+  const readOrder = (id, signal) => request(`/me/orders/${encodeURIComponent(id)}`, {
+    method: "GET",
+    ...signal ? { signal } : {}
+  });
+  let pending;
+  const check = async () => {
+    const response = await requestWithRetry(
+      fetcher,
+      sessionPath,
+      { method: "GET", cache: "no-store" },
+      "Could not check the customer session"
+    );
+    if (!response.ok) {
+      const value = await apiError(
+        response,
+        `The session service answered ${response.status}`
+      );
+      throw new CustomerError(
+        response.status,
+        value.apiCode,
+        value.message,
+        value.param,
+        value.issues
+      );
+    }
+    const body = await response.json();
+    const next = body.customer ?? null;
+    update(next, next ? "authenticated" : "anonymous");
+    return next;
+  };
+  const refresh = () => {
+    pending ?? (pending = check().finally(() => {
+      pending = void 0;
+    }));
+    return pending;
+  };
+  const recheck = () => {
+    if (typeof document === "undefined" || document.visibilityState === "visible") {
+      void refresh().catch(() => void 0);
+    }
+  };
+  if (typeof document !== "undefined") {
+    document.addEventListener("visibilitychange", recheck);
+  }
+  if (typeof window !== "undefined") {
+    window.addEventListener("pageshow", recheck);
+  }
+  return {
+    get state() {
+      return state;
+    },
+    get customer() {
+      return customer;
+    },
+    session: refresh,
+    /** Stops the visibility and back/forward-cache re-checks and drops listeners. */
+    dispose() {
+      if (typeof document !== "undefined") {
+        document.removeEventListener("visibilitychange", recheck);
+      }
+      if (typeof window !== "undefined") {
+        window.removeEventListener("pageshow", recheck);
+      }
+      listeners.clear();
+    },
+    onChange(listener) {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    },
+    signIn(returnTo) {
+      signIn(safeReturnTo(returnTo ?? currentPath()));
+    },
+    signOut() {
+      signOut("/_zappie/logout");
+    },
+    profile: () => request("/me", { method: "GET" }),
+    async addresses() {
+      const result = await request(
+        "/me/addresses",
+        { method: "GET" }
+      );
+      return result.addresses;
+    },
+    addAddress: (body) => request("/me/addresses", {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    }),
+    removeAddress: (id) => request(`/me/addresses/${encodeURIComponent(id)}`, {
+      method: "DELETE"
+    }),
+    orders(options2 = {}) {
+      const query = new URLSearchParams();
+      if (options2.limit !== void 0) {
+        query.set("limit", String(options2.limit));
+      }
+      if (options2.cursor !== void 0) {
+        query.set("cursor", options2.cursor);
+      }
+      const suffix = query.size > 0 ? `?${query}` : "";
+      return request(`/me/orders${suffix}`, { method: "GET" });
+    },
+    order: (id) => readOrder(id),
+    watchOrder(id, watchOptions) {
+      return watchOrder(base, id, readOrder, watchOptions);
+    }
+  };
+}
+export {
+  createCustomer
+};
+//# sourceMappingURL=client.js.map

package/dist/customer/client.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/customer/client.ts"],
+  "sourcesContent": ["import { apiError, requestWithRetry } from \"../internal/customer-http\";\nimport { CustomerError } from \"./error\";\nimport { currentPath, safeReturnTo, signIn, signOut } from \"./navigation\";\nimport { createCustomerRequest } from \"./request\";\nimport type {\n  AuthState,\n  CreateAddress,\n  CustomerClientOptions,\n  CustomerListener,\n  CustomerOrder,\n  CustomerProfile,\n  OrdersPage,\n  SavedAddress,\n  SessionCustomer,\n  WatchOrderOptions,\n} from \"./types\";\nimport { watchOrder } from \"./watch-order\";\n\nconst DEFAULT_CUSTOMER_BASE = \"/_zappie/api\";\nconst DEFAULT_SESSION_PATH = \"/_zappie/session\";\n\nfunction same(\n  left: SessionCustomer | null,\n  right: SessionCustomer | null,\n): boolean {\n  return (\n    left?.id === right?.id &&\n    left?.given_name === right?.given_name &&\n    left?.phone_masked === right?.phone_masked\n  );\n}\n\n/**\n * Create a client for customer sessions, saved addresses and orders.\n * Browser visibility and pageshow events refresh the session. Call dispose when you stop using the client.\n *\n * @param options - Endpoint overrides, fetch implementation and optional initial customer.\n * @returns A customer client with session subscriptions and sign-in and sign-out navigation.\n */\nexport function createCustomer(options: CustomerClientOptions = {}) {\n  const base = (options.customerBase ?? DEFAULT_CUSTOMER_BASE).replace(\n    /\\/+$/,\n    \"\",\n  );\n  const sessionPath = options.sessionPath ?? DEFAULT_SESSION_PATH;\n  const fetcher = options.fetch ?? globalThis.fetch;\n  let customer = options.initialCustomer ?? null;\n  let state: AuthState =\n    options.initialCustomer === undefined\n      ? \"unknown\"\n      : customer\n        ? \"authenticated\"\n        : \"anonymous\";\n  const listeners = new Set<CustomerListener>();\n  const update = (next: SessionCustomer | null, nextState: AuthState) => {\n    if (state === nextState && same(customer, next)) {\n      return;\n    }\n    state = nextState;\n    customer = next;\n    globalThis.__zappieEmit?.(\"auth:changed\", { state, customer });\n    for (const listener of listeners) {\n      listener(state, customer);\n    }\n  };\n  const request = createCustomerRequest(base, fetcher, () => {\n    update(null, \"anonymous\");\n  });\n  const readOrder = (id: string, signal?: AbortSignal) =>\n    request<CustomerOrder>(`/me/orders/${encodeURIComponent(id)}`, {\n      method: \"GET\",\n      ...(signal ? { signal } : {}),\n    });\n  let pending: Promise<SessionCustomer | null> | undefined;\n  const check = async (): Promise<SessionCustomer | null> => {\n    const response = await requestWithRetry(\n      fetcher,\n      sessionPath,\n      { method: \"GET\", cache: \"no-store\" },\n      \"Could not check the customer session\",\n    );\n    if (!response.ok) {\n      const value = await apiError(\n        response,\n        `The session service answered ${response.status}`,\n      );\n      throw new CustomerError(\n        response.status,\n        value.apiCode,\n        value.message,\n        value.param,\n        value.issues,\n      );\n    }\n    const body = (await response.json()) as {\n      customer?: SessionCustomer | null;\n    };\n    const next = body.customer ?? null;\n    update(next, next ? \"authenticated\" : \"anonymous\");\n    return next;\n  };\n  // Overlapping checks share one request, so a slower stale answer can't land last.\n  const refresh = (): Promise<SessionCustomer | null> => {\n    pending ??= check().finally(() => {\n      pending = undefined;\n    });\n    return pending;\n  };\n  const recheck = () => {\n    if (\n      typeof document === \"undefined\" ||\n      document.visibilityState === \"visible\"\n    ) {\n      void refresh().catch(() => undefined);\n    }\n  };\n  if (typeof document !== \"undefined\") {\n    document.addEventListener(\"visibilitychange\", recheck);\n  }\n  if (typeof window !== \"undefined\") {\n    window.addEventListener(\"pageshow\", recheck);\n  }\n  return {\n    get state() {\n      return state;\n    },\n    get customer() {\n      return customer;\n    },\n    session: refresh,\n    /** Stops the visibility and back/forward-cache re-checks and drops listeners. */\n    dispose() {\n      if (typeof document !== \"undefined\") {\n        document.removeEventListener(\"visibilitychange\", recheck);\n      }\n      if (typeof window !== \"undefined\") {\n        window.removeEventListener(\"pageshow\", recheck);\n      }\n      listeners.clear();\n    },\n    onChange(listener: CustomerListener) {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n    signIn(returnTo?: string) {\n      signIn(safeReturnTo(returnTo ?? currentPath()));\n    },\n    signOut() {\n      signOut(\"/_zappie/logout\");\n    },\n    profile: () => request<CustomerProfile>(\"/me\", { method: \"GET\" }),\n    async addresses() {\n      const result = await request<{ addresses: SavedAddress[] }>(\n        \"/me/addresses\",\n        { method: \"GET\" },\n      );\n      return result.addresses;\n    },\n    addAddress: (body: CreateAddress) =>\n      request<SavedAddress>(\"/me/addresses\", {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\" },\n        body: JSON.stringify(body),\n      }),\n    removeAddress: (id: string) =>\n      request<void>(`/me/addresses/${encodeURIComponent(id)}`, {\n        method: \"DELETE\",\n      }),\n    orders(options: { cursor?: string; limit?: number } = {}) {\n      const query = new URLSearchParams();\n      if (options.limit !== undefined) {\n        query.set(\"limit\", String(options.limit));\n      }\n      if (options.cursor !== undefined) {\n        query.set(\"cursor\", options.cursor);\n      }\n      const suffix = query.size > 0 ? `?${query}` : \"\";\n      return request<OrdersPage>(`/me/orders${suffix}`, { method: \"GET\" });\n    },\n    order: (id: string) => readOrder(id),\n    watchOrder(id: string, watchOptions: WatchOrderOptions) {\n      return watchOrder(base, id, readOrder, watchOptions);\n    },\n  };\n}\n\n/**\n * The session, profile, address and order operations returned by createCustomer.\n */\nexport type CustomerClient = ReturnType<typeof createCustomer>;\n"],
+  "mappings": "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",
+  "names": ["options"]
+}

package/dist/customer/error.js

@@ -0,0 +1,20 @@
+// src/customer/error.ts
+import { stableErrorCode } from "../internal/customer-http.js";
+import { ZappieError } from "./sdk.js";
+var CustomerError = class extends ZappieError {
+  constructor(status, apiCode, message, param, issues) {
+    super(stableErrorCode(status), message, {
+      status,
+      retryable: status === 429 || status >= 500,
+      ...param !== void 0 ? { param } : {}
+    });
+    this.apiCode = apiCode;
+    if (issues !== void 0) {
+      this.issues = issues;
+    }
+  }
+};
+export {
+  CustomerError
+};
+//# sourceMappingURL=error.js.map

package/dist/customer/error.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/customer/error.ts"],
+  "sourcesContent": ["import { stableErrorCode } from \"../internal/customer-http\";\nimport { ZappieError } from \"./sdk\";\n\n/**\n * A customer API failure with its HTTP status, API code and optional validation issues.\n * Statuses 429 and 5xx are marked retryable.\n */\nexport class CustomerError extends ZappieError {\n  readonly issues?: unknown;\n\n  constructor(\n    status: number,\n    readonly apiCode: string,\n    message: string,\n    param?: string,\n    issues?: unknown,\n  ) {\n    super(stableErrorCode(status), message, {\n      status,\n      retryable: status === 429 || status >= 500,\n      ...(param !== undefined ? { param } : {}),\n    });\n    if (issues !== undefined) {\n      this.issues = issues;\n    }\n  }\n}\n"],
+  "mappings": ";AAAA,SAAS,uBAAuB;AAChC,SAAS,mBAAmB;AAMrB,IAAM,gBAAN,cAA4B,YAAY;AAAA,EAG7C,YACE,QACS,SACT,SACA,OACA,QACA;AACA,UAAM,gBAAgB,MAAM,GAAG,SAAS;AAAA,MACtC;AAAA,MACA,WAAW,WAAW,OAAO,UAAU;AAAA,MACvC,GAAI,UAAU,SAAY,EAAE,MAAM,IAAI,CAAC;AAAA,IACzC,CAAC;AATQ;AAUT,QAAI,WAAW,QAAW;AACxB,WAAK,SAAS;AAAA,IAChB;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/customer/index.js

@@ -1,3 +1,8 @@
-import {ZappieError}from'@zappie/sdk';function O(e){return e===400||e===422?"invalid_request":e===401?"unauthorized":e===404?"not_found":e===429?"rate_limited":"server_error"}async function w(e,r){let s=await e.json().catch(()=>({})),a=s&&typeof s=="object"?s:{},n="error"in a&&a.error&&typeof a.error=="object"?a.error:{};return {apiCode:"code"in n&&typeof n.code=="string"?n.code:"server_error",message:"message"in n&&typeof n.message=="string"?n.message:r,..."param"in n&&typeof n.param=="string"?{param:n.param}:{},..."issues"in n?{issues:n.issues}:{}}}function E(e,r){return r?.throwIfAborted(),new Promise((s,a)=>{let o=setTimeout(()=>{r?.removeEventListener("abort",i),s();},e),i=()=>{clearTimeout(o),r?.removeEventListener("abort",i),a(r?.reason??new DOMException("Aborted","AbortError"));};r?.addEventListener("abort",i,{once:true});})}async function v(e,r,s,a){for(let n=0;n<2;n++)try{return await e(r,{...s,credentials:"same-origin",headers:{Accept:"application/json",...s.headers}})}catch(o){if(s.signal?.aborted)throw s.signal.reason??o;if(n===1)throw new ZappieError("network_error",a,{cause:o,retryable:true});await E(400,s.signal??void 0);}throw new ZappieError("network_error",a,{retryable:true})}var p=class extends ZappieError{constructor(s,a,n,o,i){super(O(s),n,{status:s,retryable:s===429||s>=500,...o!==void 0?{param:o}:{}});this.apiCode=a;i!==void 0&&(this.issues=i);}};function T(e){return !e||!e.startsWith("/")||e.startsWith("//")||e.startsWith("/\\")?"/":e}function A(){return typeof location>"u"?"/":location.pathname+location.search}function _(e){if(typeof document>"u")return;let r=document.createElement("a");r.href=`/_zappie/login?return=${encodeURIComponent(e)}`,r.target="_top",r.click();}function x(e){if(typeof document>"u")return;let r=document.createElement("form");r.method="POST",r.action=e,r.target="_top",r.hidden=true,document.body.appendChild(r),r.submit(),r.remove();}function R(e,r,s){return async(a,n={})=>{let o=await v(r,e+a,n,"Could not reach the customer service");if(o.status===401&&s(),!o.ok){let i=await w(o,`The customer service answered ${o.status}`);throw new p(o.status,i.apiCode,i.message,i.param,i.issues)}if(o.status!==204)return await o.json()}}var L=new Set(["completed","cancelled","rejected"]);function P(e,r,s,a){let n=new AbortController,o=a.pollMs??15e3,i,l=0,c=false,m=()=>{c||(c=true,i?.close(),n.abort(),a.signal?.removeEventListener("abort",m));},h=u=>{a.onOrder(u),L.has(u.status)&&m();},y=async()=>{for(;!c;){try{h(await s(r,n.signal));}catch(u){if(u instanceof p&&u.status!==void 0&&u.status>=400&&u.status<500){m();return}}c||await E(o,n.signal).catch(()=>{});}},g=()=>{if(c||typeof EventSource>"u"){y();return}i=new EventSource(`${e}/me/orders/${encodeURIComponent(r)}/events`),i.addEventListener("status",u=>{l=0;let t;try{t=JSON.parse(u.data);}catch{return}h(t);}),i.onerror=()=>{i?.close(),l++,l>=2?y():g();};};return a.signal?.addEventListener("abort",m,{once:true}),a.signal?.aborted?m():g(),m}var k="/_zappie/api",q="/_zappie/session";function I(e,r){return e?.id===r?.id&&e?.given_name===r?.given_name&&e?.phone_masked===r?.phone_masked}function W(e={}){let r=(e.customerBase??k).replace(/\/+$/,""),s=e.sessionPath??q,a=e.fetch??globalThis.fetch,n=e.initialCustomer??null,o=e.initialCustomer===void 0?"unknown":n?"authenticated":"anonymous",i=new Set,l=(t,d)=>{if(!(o===d&&I(n,t))){o=d,n=t,globalThis.__zappieEmit?.("auth:changed",{state:o,customer:n});for(let f of i)f(o,n);}},c=R(r,a,()=>{l(null,"anonymous");}),m=(t,d)=>c(`/me/orders/${encodeURIComponent(t)}`,{method:"GET",...d?{signal:d}:{}}),h,y=async()=>{let t=await v(a,s,{method:"GET",cache:"no-store"},"Could not check the customer session");if(!t.ok){let C=await w(t,`The session service answered ${t.status}`);throw new p(t.status,C.apiCode,C.message,C.param,C.issues)}let f=(await t.json()).customer??null;return l(f,f?"authenticated":"anonymous"),f},g=()=>(h??(h=y().finally(()=>{h=void 0;})),h),u=()=>{(typeof document>"u"||document.visibilityState==="visible")&&g().catch(()=>{});};return typeof document<"u"&&document.addEventListener("visibilitychange",u),typeof window<"u"&&window.addEventListener("pageshow",u),{get state(){return o},get customer(){return n},session:g,dispose(){typeof document<"u"&&document.removeEventListener("visibilitychange",u),typeof window<"u"&&window.removeEventListener("pageshow",u),i.clear();},onChange(t){return i.add(t),()=>{i.delete(t);}},signIn(t){_(T(t??A()));},signOut(){x("/_zappie/logout");},profile:()=>c("/me",{method:"GET"}),async addresses(){return (await c("/me/addresses",{method:"GET"})).addresses},addAddress:t=>c("/me/addresses",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(t)}),removeAddress:t=>c(`/me/addresses/${encodeURIComponent(t)}`,{method:"DELETE"}),orders(t={}){let d=new URLSearchParams;t.limit!==void 0&&d.set("limit",String(t.limit)),t.cursor!==void 0&&d.set("cursor",t.cursor);let f=d.size>0?`?${d}`:"";return c(`/me/orders${f}`,{method:"GET"})},order:t=>m(t),watchOrder(t,d){return P(r,t,m,d)}}}
-export{p as CustomerError,W as createCustomer};//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map
+// src/customer/index.ts
+import { createCustomer } from "./client.js";
+import { CustomerError } from "./error.js";
+export {
+  CustomerError,
+  createCustomer
+};
+//# sourceMappingURL=index.js.map