@umxr/bagsy 0.0.0-stage → 0.2.0

package/dist/chunk-QV3JPND6.js

@@ -0,0 +1,375 @@
+// ../core/src/ids.ts
+function toGid(resource, ref) {
+  const value = String(ref).trim();
+  const prefix = `gid://shopify/${resource}/`;
+  if (value.startsWith(prefix)) {
+    const id = value.slice(prefix.length);
+    if (/^\d+$/.test(id)) return value;
+  } else if (/^\d+$/.test(value)) {
+    return `${prefix}${value}`;
+  }
+  throw new TypeError(`Expected a numeric ID or ${prefix}<id>, received "${value}"`);
+}
+var productGid = (ref) => toGid("Product", ref);
+var variantGid = (ref) => toGid("ProductVariant", ref);
+var customerGid = (ref) => toGid("Customer", ref);
+
+// ../core/src/operations.ts
+var MAX_LOOKUP = 100;
+var listPath = (listId) => `/lists/${encodeURIComponent(listId)}`;
+var itemPath = (listId, itemId) => `${listPath(listId)}/items/${encodeURIComponent(itemId)}`;
+var listLists = async (t) => (await t.request("GET", "/lists")).data;
+var getList = (t, listId = "default", { includeItems = false } = {}) => t.request("GET", listPath(listId), { query: { include: includeItems ? "items" : void 0 } });
+var createList = (t, name) => t.request("POST", "/lists", { body: { name } });
+var renameList = (t, listId, name) => t.request("PATCH", listPath(listId), { body: { name } });
+var deleteList = async (t, listId) => {
+  await t.request("DELETE", listPath(listId));
+};
+var shareList = async (t, listId = "default", { rotate = false } = {}) => (await t.request("POST", `${listPath(listId)}/share`, { query: { rotate: rotate ? "true" : void 0 } })).shareToken;
+var unshareList = async (t, listId = "default") => {
+  await t.request("DELETE", `${listPath(listId)}/share`);
+};
+var itemBody = (product, variantId, extra = {}) => ({
+  productId: productGid(product),
+  ...variantId !== void 0 && { variantId: variantGid(variantId) },
+  ...extra.quantity !== void 0 && { quantity: extra.quantity },
+  ...extra.note !== void 0 && { note: extra.note }
+});
+var listItems = (t, listId = "default", page = {}) => t.request("GET", `${listPath(listId)}/items`, { query: { ...page } });
+async function* iterateItems(t, listId = "default", { limit = 100 } = {}) {
+  let after;
+  do {
+    const page = await listItems(t, listId, { limit, after });
+    yield* page.data;
+    after = page.pageInfo.hasNextPage ? page.pageInfo.endCursor ?? void 0 : void 0;
+  } while (after);
+}
+var addItem = (t, product, { listId = "default", variantId, quantity, note } = {}) => t.request("POST", `${listPath(listId)}/items`, { body: itemBody(product, variantId, { quantity, note }) });
+var removeProduct = async (t, product, { listId = "default", variantId } = {}) => {
+  await t.request("DELETE", `${listPath(listId)}/items`, {
+    query: { productId: productGid(product), variantId: variantId === void 0 ? void 0 : variantGid(variantId) }
+  });
+};
+async function toggleItem(t, product, { listId = "default", variantId } = {}) {
+  const { status } = await t.send("POST", `${listPath(listId)}/items`, { body: itemBody(product, variantId) });
+  if (status === 201) return { saved: true };
+  await removeProduct(t, product, { listId, variantId });
+  return { saved: false };
+}
+var updateItem = (t, itemId, patch, { listId = "default" } = {}) => {
+  const body = {
+    ...patch.quantity !== void 0 && { quantity: patch.quantity },
+    ...patch.note !== void 0 && { note: patch.note },
+    ...patch.variantId !== void 0 && { variantId: patch.variantId === null ? null : variantGid(patch.variantId) }
+  };
+  return t.request("PATCH", itemPath(listId, itemId), { body });
+};
+var removeItem = async (t, itemId, { listId = "default" } = {}) => {
+  await t.request("DELETE", itemPath(listId, itemId));
+};
+async function lookupSaved(t, products) {
+  const ids = [...new Set([...products].map(productGid))];
+  const chunks = [];
+  for (let i = 0; i < ids.length; i += MAX_LOOKUP) chunks.push(ids.slice(i, i + MAX_LOOKUP));
+  const pages = await Promise.all(
+    chunks.map((productIds) => t.request("GET", "/saved", { query: { productIds } }))
+  );
+  const byProduct = {};
+  for (const id of ids) byProduct[id] = [];
+  for (const page of pages) Object.assign(byProduct, page.data);
+  return {
+    byProduct,
+    get: (product) => byProduct[productGid(product)] ?? [],
+    has(product, variant) {
+      const entries = byProduct[productGid(product)] ?? [];
+      if (variant === void 0) return entries.length > 0;
+      const gid = variantGid(variant);
+      return entries.some((entry) => entry.variantId === gid || entry.variantId == null);
+    }
+  };
+}
+function mergeVisitor(t, visitorId = t.options.visitorId) {
+  if (!visitorId) throw new TypeError("identity.merge: no visitorId to merge.");
+  if (t.options.mode === "server" && t.options.customerId === void 0) {
+    throw new TypeError("identity.merge: set `customerId` (e.g. via bagsy.as({ customerId })) first.");
+  }
+  return t.request("POST", "/identity/merge", { body: { visitorId } });
+}
+var getSharedList = (t, shareToken, page = {}) => t.request("GET", `/shared/${encodeURIComponent(shareToken)}`, { query: { ...page } });
+async function topProducts(t, query = {}) {
+  if (t.options.mode !== "server") {
+    throw new Error("bagsy.insights.topProducts() needs a server key; call it from your server.");
+  }
+  const since = query.since instanceof Date ? query.since.toISOString() : query.since;
+  return (await t.request("GET", "/insights/top-products", { query: { since, limit: query.limit } })).data;
+}
+
+// ../core/src/errors.ts
+var BagsyError = class extends Error {
+  name = "BagsyError";
+  status;
+  code;
+  problem;
+  constructor(status, problem) {
+    const parsed = isProblem(problem) ? problem : void 0;
+    super(parsed?.detail ?? parsed?.title ?? `Bagsy request failed with status ${status}`);
+    this.status = status;
+    this.code = parsed?.code ?? "unexpected_response";
+    this.problem = parsed;
+  }
+};
+function isProblem(value) {
+  return typeof value === "object" && value !== null && typeof value.code === "string" && typeof value.status === "number";
+}
+
+// ../core/src/transport.ts
+function createTransport(options) {
+  if (options.mode === "server") {
+    if (!options.apiKey) throw new TypeError("createBagsy: `apiKey` is required in server mode.");
+    const browser = globalThis;
+    if (browser.window !== void 0 && browser.document !== void 0) {
+      throw new Error(
+        "createBagsy: server mode exposes your secret key and must not run in a browser. Use mode: 'proxy' in themes, or call Bagsy from your Hydrogen loaders and actions."
+      );
+    }
+  }
+  const baseUrl = (options.baseUrl ?? (options.mode === "proxy" ? `${(options.proxyPath ?? "/apps/bagsy").replace(/\/$/, "")}/v1` : "https://api.bagsy.dev/v1")).replace(/\/$/, "");
+  const headers = { Accept: "application/json" };
+  if (options.visitorId) headers["Bagsy-Visitor-Id"] = options.visitorId;
+  if (options.mode === "server") {
+    headers.Authorization = `Bearer ${options.apiKey}`;
+    if (options.customerId !== void 0) headers["Bagsy-Customer-Id"] = customerGid(options.customerId);
+  }
+  async function send(method, path, { query = {}, body } = {}) {
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(query)) {
+      if (value !== void 0) params.set(key, Array.isArray(value) ? value.join(",") : String(value));
+    }
+    if (options.mode === "proxy" && options.visitorId) params.set("visitor_id", options.visitorId);
+    const search = params.toString();
+    const response = await (options.fetch ?? fetch)(`${baseUrl}${path}${search ? `?${search}` : ""}`, {
+      method,
+      headers: body === void 0 ? headers : { ...headers, "Content-Type": "application/json" },
+      ...body !== void 0 && { body: JSON.stringify(body) }
+    });
+    const text = await response.text();
+    let data;
+    try {
+      data = text ? JSON.parse(text) : void 0;
+    } catch {
+      data = text;
+    }
+    if (!response.ok) throw new BagsyError(response.status, data);
+    return { status: response.status, data };
+  }
+  return {
+    options,
+    send,
+    request: async (method, path, init) => (await send(method, path, init)).data
+  };
+}
+
+// ../core/src/account.ts
+function createAccountTransport({
+  sessionToken,
+  baseUrl = "https://api.bagsy.dev/account/v1",
+  fetch: fetchImpl,
+  ...rest
+}) {
+  return createTransport({
+    ...rest,
+    mode: "account",
+    sessionToken,
+    baseUrl,
+    // Session tokens last five minutes and Shopify caches them, so ask every time.
+    fetch: async (input, init) => {
+      const headers = new Headers(init?.headers);
+      headers.set("Authorization", `Bearer ${await sessionToken()}`);
+      return (fetchImpl ?? fetch)(input, { ...init, headers });
+    }
+  });
+}
+
+// ../core/src/relay.ts
+function createRelayTransport(options) {
+  const endpoint = options.endpoint ?? "/api/bagsy";
+  async function send(method, path, { query = {}, body } = {}) {
+    const params = {};
+    for (const [key, value] of Object.entries(query)) {
+      if (value !== void 0) params[key] = Array.isArray(value) ? value.join(",") : String(value);
+    }
+    const call = { method, path, ...Object.keys(params).length && { query: params }, ...body !== void 0 && { body } };
+    const response = await (options.fetch ?? fetch)(endpoint, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", Accept: "application/json" },
+      // Same-origin fetches send the session cookie by default.
+      body: JSON.stringify(call)
+    });
+    let payload;
+    try {
+      payload = await response.json();
+    } catch {
+      payload = void 0;
+    }
+    if (!response.ok || !isRelayResponse(payload)) {
+      throw new BagsyError(response.ok ? 502 : response.status, payload);
+    }
+    if (payload.status >= 400) throw new BagsyError(payload.status, payload.data);
+    return payload;
+  }
+  return {
+    options,
+    send,
+    request: async (method, path, init) => (await send(method, path, init)).data
+  };
+}
+function isRelayResponse(value) {
+  return typeof value === "object" && value !== null && typeof value.status === "number";
+}
+
+// ../core/src/client.ts
+function createBagsy(options) {
+  if (options.mode === "relay") return createRelayClient(options);
+  const t = options.mode === "account" ? createAccountTransport(options) : createTransport(options);
+  return clientFor(t, (owner) => {
+    if (options.mode === "account") {
+      throw new TypeError("bagsy.as: in customer accounts the session token identifies the customer.");
+    }
+    if (options.mode === "proxy") {
+      if (owner.customerId !== void 0) {
+        throw new TypeError("bagsy.as: on the app proxy the customer comes from Shopify; pass only `visitorId`.");
+      }
+      return createBagsy({ ...options, visitorId: owner.visitorId ?? options.visitorId });
+    }
+    return createBagsy({ ...options, ...owner });
+  });
+}
+function createRelayClient(options = {}) {
+  return clientFor(createRelayTransport({ ...options, mode: "relay" }), () => {
+    throw new TypeError("bagsy.as: through a relay, your server's session identifies the shopper.");
+  });
+}
+function clientFor(t, as) {
+  const items = {
+    list: (listId, page) => listItems(t, listId, page),
+    /** Every item in a list, fetched page by page. */
+    iterate: (listId, opts) => iterateItems(t, listId, opts),
+    /** Save a product. Saving it again returns the existing item. */
+    add: (product, opts) => addItem(t, product, opts),
+    /** Save if unsaved, unsave if saved. Built for heart buttons. */
+    toggle: (product, opts) => toggleItem(t, product, opts),
+    update: (itemId, patch, opts) => updateItem(t, itemId, patch, opts),
+    remove: (itemId, opts) => removeItem(t, itemId, opts),
+    /** Unsave by product, without knowing the item id. No-op if not saved. */
+    removeProduct: (product, opts) => removeProduct(t, product, opts)
+  };
+  return {
+    lists: {
+      /** The owner's lists, default first. */
+      list: () => listLists(t),
+      get: (listId, opts) => getList(t, listId, opts),
+      create: (name) => createList(t, name),
+      rename: (listId, name) => renameList(t, listId, name),
+      delete: (listId) => deleteList(t, listId),
+      /** The list's share token, created on first share. `rotate: true` issues a new one. */
+      share: (listId, opts) => shareList(t, listId, opts),
+      unshare: (listId) => unshareList(t, listId)
+    },
+    items,
+    /**
+     * Saved state for a set of products across all of the owner's lists.
+     * Accepts any number of products; batches of 100 are fetched in parallel.
+     */
+    saved: (products) => lookupSaved(t, products),
+    identity: {
+      /** Fold a guest's lists into the logged-in customer's. Safe to retry. */
+      merge: (visitorId) => mergeVisitor(t, visitorId)
+    },
+    shared: {
+      /** Public, read-only view of a shared list. */
+      get: (shareToken, page) => getSharedList(t, shareToken, page)
+    },
+    insights: {
+      /** Most-saved products. Server key only. */
+      topProducts: (query) => topProducts(t, query)
+    },
+    /**
+     * A copy of this client acting for a specific shopper. In Hydrogen, call
+     * once per request with the customer from your Customer Account session.
+     */
+    as
+  };
+}
+
+// ../core/src/visitor.ts
+var STORAGE_KEY = "bagsy:visitor-id";
+var memoryFallback;
+function getVisitorId(storage = safeLocalStorage()) {
+  try {
+    const existing = storage?.getItem(STORAGE_KEY);
+    if (existing) return existing;
+  } catch {
+  }
+  const id = memoryFallback ?? crypto.randomUUID();
+  memoryFallback = id;
+  try {
+    storage?.setItem(STORAGE_KEY, id);
+  } catch {
+  }
+  return id;
+}
+function peekVisitorId(storage = safeLocalStorage()) {
+  try {
+    return storage?.getItem(STORAGE_KEY) ?? memoryFallback;
+  } catch {
+    return memoryFallback;
+  }
+}
+function clearVisitorId(storage = safeLocalStorage()) {
+  memoryFallback = void 0;
+  try {
+    storage?.removeItem(STORAGE_KEY);
+  } catch {
+  }
+}
+function safeLocalStorage() {
+  try {
+    return globalThis.localStorage;
+  } catch {
+    return void 0;
+  }
+}
+
+export {
+  productGid,
+  variantGid,
+  customerGid,
+  listLists,
+  getList,
+  createList,
+  renameList,
+  deleteList,
+  shareList,
+  unshareList,
+  listItems,
+  iterateItems,
+  addItem,
+  removeProduct,
+  toggleItem,
+  updateItem,
+  removeItem,
+  lookupSaved,
+  mergeVisitor,
+  getSharedList,
+  topProducts,
+  BagsyError,
+  createTransport,
+  createAccountTransport,
+  createRelayTransport,
+  createBagsy,
+  createRelayClient,
+  getVisitorId,
+  peekVisitorId,
+  clearVisitorId
+};
+//# sourceMappingURL=chunk-QV3JPND6.js.map

package/dist/chunk-QV3JPND6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../core/src/ids.ts","../../core/src/operations.ts","../../core/src/errors.ts","../../core/src/transport.ts","../../core/src/account.ts","../../core/src/relay.ts","../../core/src/client.ts","../../core/src/visitor.ts"],"sourcesContent":["/**\n * Shopify IDs arrive in two shapes: numeric (Liquid's `product.id`) and GIDs\n * (Storefront and Customer Account APIs). Bagsy accepts either and always\n * sends GIDs on the wire.\n */\nexport type ProductRef = string | number;\nexport type VariantRef = string | number;\nexport type CustomerRef = string | number;\n\ntype Resource = 'Product' | 'ProductVariant' | 'Customer';\n\nfunction toGid(resource: Resource, ref: string | number): string {\n  const value = String(ref).trim();\n  const prefix = `gid://shopify/${resource}/`;\n  if (value.startsWith(prefix)) {\n    const id = value.slice(prefix.length);\n    if (/^\\d+$/.test(id)) return value;\n  } else if (/^\\d+$/.test(value)) {\n    return `${prefix}${value}`;\n  }\n  throw new TypeError(`Expected a numeric ID or ${prefix}<id>, received \"${value}\"`);\n}\n\nexport const productGid = (ref: ProductRef) => toGid('Product', ref);\nexport const variantGid = (ref: VariantRef) => toGid('ProductVariant', ref);\nexport const customerGid = (ref: CustomerRef) => toGid('Customer', ref);\n","// Every API call as a standalone function over a Transport. `createBagsy()`\n// groups these into a client; import them directly when bundle size matters\n// (bundlers drop the ones you don't use).\nimport { productGid, variantGid, type ProductRef, type VariantRef } from './ids.js';\nimport type { Transport } from './transport.js';\nimport type {\n  Item,\n  ItemOptions,\n  ItemPage,\n  List,\n  ListRef,\n  MergeResult,\n  PageOptions,\n  SavedEntry,\n  SavedLookup,\n  Schemas,\n  SharedList,\n  TopProduct,\n} from './types.js';\n\nconst MAX_LOOKUP = 100;\nconst listPath = (listId: ListRef) => `/lists/${encodeURIComponent(listId)}`;\nconst itemPath = (listId: ListRef, itemId: string) => `${listPath(listId)}/items/${encodeURIComponent(itemId)}`;\n\n// Lists ------------------------------------------------------------------\n\n/** The owner's lists, default first. */\nexport const listLists = async (t: Transport): Promise<List[]> =>\n  (await t.request<{ data: List[] }>('GET', '/lists')).data;\n\nexport const getList = (t: Transport, listId: ListRef = 'default', { includeItems = false } = {}): Promise<List> =>\n  t.request('GET', listPath(listId), { query: { include: includeItems ? 'items' : undefined } });\n\nexport const createList = (t: Transport, name: string): Promise<List> =>\n  t.request('POST', '/lists', { body: { name } satisfies Schemas['ListCreate'] });\n\nexport const renameList = (t: Transport, listId: ListRef, name: string): Promise<List> =>\n  t.request('PATCH', listPath(listId), { body: { name } satisfies Schemas['ListUpdate'] });\n\nexport const deleteList = async (t: Transport, listId: ListRef): Promise<void> => {\n  await t.request('DELETE', listPath(listId));\n};\n\n/**\n * The list's share token, creating it on first share. Stable across calls, so\n * links already sent keep working; `rotate: true` issues a new one.\n */\nexport const shareList = async (\n  t: Transport,\n  listId: ListRef = 'default',\n  { rotate = false }: { rotate?: boolean } = {},\n): Promise<string> =>\n  (await t.request<{ shareToken: string }>('POST', `${listPath(listId)}/share`, { query: { rotate: rotate ? 'true' : undefined } }))\n    .shareToken;\n\nexport const unshareList = async (t: Transport, listId: ListRef = 'default'): Promise<void> => {\n  await t.request('DELETE', `${listPath(listId)}/share`);\n};\n\n// Items ------------------------------------------------------------------\n\nconst itemBody = (product: ProductRef, variantId?: VariantRef, extra: { quantity?: number; note?: string } = {}) =>\n  ({\n    productId: productGid(product),\n    ...(variantId !== undefined && { variantId: variantGid(variantId) }),\n    ...(extra.quantity !== undefined && { quantity: extra.quantity }),\n    ...(extra.note !== undefined && { note: extra.note }),\n  }) satisfies Schemas['ItemCreate'];\n\nexport const listItems = (t: Transport, listId: ListRef = 'default', page: PageOptions = {}): Promise<ItemPage> =>\n  t.request('GET', `${listPath(listId)}/items`, { query: { ...page } });\n\n/** Every item in a list, fetched page by page. */\nexport async function* iterateItems(\n  t: Transport,\n  listId: ListRef = 'default',\n  { limit = 100 }: { limit?: number } = {},\n): AsyncGenerator<Item> {\n  let after: string | undefined;\n  do {\n    const page = await listItems(t, listId, { limit, after });\n    yield* page.data;\n    after = page.pageInfo.hasNextPage ? (page.pageInfo.endCursor ?? undefined) : undefined;\n  } while (after);\n}\n\n/** Save a product. Saving it again returns the existing item. */\nexport const addItem = (\n  t: Transport,\n  product: ProductRef,\n  { listId = 'default', variantId, quantity, note }: ItemOptions & { quantity?: number; note?: string } = {},\n): Promise<Item> => t.request('POST', `${listPath(listId)}/items`, { body: itemBody(product, variantId, { quantity, note }) });\n\n/** Unsave by product, without knowing the item id. No-op if not saved. */\nexport const removeProduct = async (\n  t: Transport,\n  product: ProductRef,\n  { listId = 'default', variantId }: ItemOptions = {},\n): Promise<void> => {\n  await t.request('DELETE', `${listPath(listId)}/items`, {\n    query: { productId: productGid(product), variantId: variantId === undefined ? undefined : variantGid(variantId) },\n  });\n};\n\n/** Save if unsaved, unsave if saved. Built for heart buttons. */\nexport async function toggleItem(\n  t: Transport,\n  product: ProductRef,\n  { listId = 'default', variantId }: ItemOptions = {},\n): Promise<{ saved: boolean }> {\n  const { status } = await t.send('POST', `${listPath(listId)}/items`, { body: itemBody(product, variantId) });\n  // 201 = newly saved. 200 = it was already saved, so this tap unsaves it.\n  if (status === 201) return { saved: true };\n  await removeProduct(t, product, { listId, variantId });\n  return { saved: false };\n}\n\nexport const updateItem = (\n  t: Transport,\n  itemId: string,\n  patch: { variantId?: VariantRef | null; quantity?: number; note?: string | null },\n  { listId = 'default' }: { listId?: ListRef } = {},\n): Promise<Item> => {\n  const body: Schemas['ItemUpdate'] = {\n    ...(patch.quantity !== undefined && { quantity: patch.quantity }),\n    ...(patch.note !== undefined && { note: patch.note }),\n    ...(patch.variantId !== undefined && { variantId: patch.variantId === null ? null : variantGid(patch.variantId) }),\n  };\n  return t.request('PATCH', itemPath(listId, itemId), { body });\n};\n\nexport const removeItem = async (t: Transport, itemId: string, { listId = 'default' }: { listId?: ListRef } = {}) => {\n  await t.request('DELETE', itemPath(listId, itemId));\n};\n\n// Lookup -----------------------------------------------------------------\n\n/**\n * Saved state for a set of products across all of the owner's lists.\n * Accepts any number of products; batches of 100 are fetched in parallel.\n */\nexport async function lookupSaved(t: Transport, products: Iterable<ProductRef>): Promise<SavedLookup> {\n  const ids = [...new Set([...products].map(productGid))];\n  const chunks: string[][] = [];\n  for (let i = 0; i < ids.length; i += MAX_LOOKUP) chunks.push(ids.slice(i, i + MAX_LOOKUP));\n\n  const pages = await Promise.all(\n    chunks.map((productIds) => t.request<{ data: Record<string, SavedEntry[]> }>('GET', '/saved', { query: { productIds } })),\n  );\n  const byProduct: Record<string, SavedEntry[]> = {};\n  for (const id of ids) byProduct[id] = [];\n  for (const page of pages) Object.assign(byProduct, page.data);\n\n  return {\n    byProduct,\n    get: (product) => byProduct[productGid(product)] ?? [],\n    has(product, variant) {\n      const entries = byProduct[productGid(product)] ?? [];\n      if (variant === undefined) return entries.length > 0;\n      const gid = variantGid(variant);\n      return entries.some((entry) => entry.variantId === gid || entry.variantId == null);\n    },\n  };\n}\n\n// Identity, sharing, insights ------------------------------------------\n\n/**\n * Fold a guest's lists into the logged-in customer's. Call once after\n * login; safe to retry. Defaults to the transport's `visitorId`.\n */\nexport function mergeVisitor(t: Transport, visitorId: string | undefined = t.options.visitorId): Promise<MergeResult> {\n  if (!visitorId) throw new TypeError('identity.merge: no visitorId to merge.');\n  if (t.options.mode === 'server' && t.options.customerId === undefined) {\n    throw new TypeError('identity.merge: set `customerId` (e.g. via bagsy.as({ customerId })) first.');\n  }\n  return t.request('POST', '/identity/merge', { body: { visitorId } });\n}\n\n/** Public, read-only view of a shared list. */\nexport const getSharedList = (t: Transport, shareToken: string, page: PageOptions = {}): Promise<SharedList> =>\n  t.request('GET', `/shared/${encodeURIComponent(shareToken)}`, { query: { ...page } });\n\n/** Most-saved products. Server key only. */\nexport async function topProducts(\n  t: Transport,\n  query: { since?: Date | string; limit?: number } = {},\n): Promise<TopProduct[]> {\n  if (t.options.mode !== 'server') {\n    throw new Error('bagsy.insights.topProducts() needs a server key; call it from your server.');\n  }\n  const since = query.since instanceof Date ? query.since.toISOString() : query.since;\n  return (await t.request<{ data: TopProduct[] }>('GET', '/insights/top-products', { query: { since, limit: query.limit } }))\n    .data;\n}\n","import type { components } from './generated/schema.js';\n\nexport type Problem = components['schemas']['Problem'];\nexport type BagsyErrorCode = Problem['code'] | 'unexpected_response';\n\n/** Thrown for any non-2xx response. Switch on `code`, never on `message`. */\nexport class BagsyError extends Error {\n  readonly name = 'BagsyError';\n  readonly status: number;\n  readonly code: BagsyErrorCode;\n  readonly problem?: Problem;\n\n  constructor(status: number, problem: unknown) {\n    const parsed = isProblem(problem) ? problem : undefined;\n    super(parsed?.detail ?? parsed?.title ?? `Bagsy request failed with status ${status}`);\n    this.status = status;\n    this.code = parsed?.code ?? 'unexpected_response';\n    this.problem = parsed;\n  }\n}\n\nfunction isProblem(value: unknown): value is Problem {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    typeof (value as Problem).code === 'string' &&\n    typeof (value as Problem).status === 'number'\n  );\n}\n","import { BagsyError } from './errors.js';\nimport { customerGid } from './ids.js';\nimport type { BagsyOptions, RelayOptions, RequestOptions } from './types.js';\n\n/** How operations reach the API: base URL, identity headers and fetch. */\nexport interface Transport {\n  readonly options: BagsyOptions;\n  send<T>(method: string, path: string, init?: RequestOptions): Promise<{ status: number; data: T }>;\n  request<T>(method: string, path: string, init?: RequestOptions): Promise<T>;\n}\n\n/** Proxy, server and account modes. Relay mode has its own: `createRelayTransport()`. */\nexport function createTransport(options: Exclude<BagsyOptions, RelayOptions>): Transport {\n  if (options.mode === 'server') {\n    if (!options.apiKey) throw new TypeError('createBagsy: `apiKey` is required in server mode.');\n    const browser = globalThis as { window?: unknown; document?: unknown };\n    if (browser.window !== undefined && browser.document !== undefined) {\n      throw new Error(\n        'createBagsy: server mode exposes your secret key and must not run in a browser. ' +\n          \"Use mode: 'proxy' in themes, or call Bagsy from your Hydrogen loaders and actions.\",\n      );\n    }\n  }\n\n  const baseUrl = (\n    options.baseUrl ??\n    (options.mode === 'proxy' ? `${(options.proxyPath ?? '/apps/bagsy').replace(/\\/$/, '')}/v1` : 'https://api.bagsy.dev/v1')\n  ).replace(/\\/$/, '');\n\n  const headers: Record<string, string> = { Accept: 'application/json' };\n  if (options.visitorId) headers['Bagsy-Visitor-Id'] = options.visitorId;\n  if (options.mode === 'server') {\n    headers.Authorization = `Bearer ${options.apiKey}`;\n    if (options.customerId !== undefined) headers['Bagsy-Customer-Id'] = customerGid(options.customerId);\n  }\n\n  /** One request. Query arrays are comma-joined; undefined values are dropped. */\n  async function send<T>(method: string, path: string, { query = {}, body }: RequestOptions = {}) {\n    const params = new URLSearchParams();\n    for (const [key, value] of Object.entries(query)) {\n      if (value !== undefined) params.set(key, Array.isArray(value) ? value.join(',') : String(value));\n    }\n    // Shopify's app proxy only guarantees query parameters reach the app (and\n    // signs them), so the visitor travels there too.\n    if (options.mode === 'proxy' && options.visitorId) params.set('visitor_id', options.visitorId);\n\n    const search = params.toString();\n    const response = await (options.fetch ?? fetch)(`${baseUrl}${path}${search ? `?${search}` : ''}`, {\n      method,\n      headers: body === undefined ? headers : { ...headers, 'Content-Type': 'application/json' },\n      ...(body !== undefined && { body: JSON.stringify(body) }),\n    });\n    const text = await response.text();\n    let data: unknown;\n    try {\n      data = text ? JSON.parse(text) : undefined;\n    } catch {\n      data = text;\n    }\n    if (!response.ok) throw new BagsyError(response.status, data);\n    return { status: response.status, data: data as T };\n  }\n\n  return {\n    options,\n    send,\n    request: async (method, path, init) => (await send(method, path, init)).data as never,\n  };\n}\n","import { createTransport, type Transport } from './transport.js';\nimport type { AccountOptions } from './types.js';\n\n/**\n * Transport for customer account UI extensions: every request carries a\n * current Shopify session token. Kept separate from createTransport so\n * storefront bundles that never use it don't pay for it.\n */\nexport function createAccountTransport({\n  sessionToken,\n  baseUrl = 'https://api.bagsy.dev/account/v1',\n  fetch: fetchImpl,\n  ...rest\n}: AccountOptions): Transport {\n  return createTransport({\n    ...rest,\n    mode: 'account',\n    sessionToken,\n    baseUrl,\n    // Session tokens last five minutes and Shopify caches them, so ask every time.\n    fetch: async (input, init) => {\n      const headers = new Headers(init?.headers);\n      headers.set('Authorization', `Bearer ${await sessionToken()}`);\n      return (fetchImpl ?? fetch)(input, { ...init, headers });\n    },\n  });\n}\n","import { BagsyError } from './errors.js';\nimport type { Transport } from './transport.js';\nimport type { RelayOptions, RequestOptions } from './types.js';\n\n/** One Bagsy API call, as the browser sends it to your server's relay endpoint. */\nexport interface RelayRequest {\n  method: string;\n  /** API path below `/v1`, e.g. `/lists/default/items`. */\n  path: string;\n  query?: Record<string, string>;\n  body?: unknown;\n}\n\n/** The API's answer, passed back unchanged so errors keep their status and problem. */\nexport interface RelayResponse<T = unknown> {\n  status: number;\n  data: T;\n}\n\n/**\n * Transport for browsers on headless storefronts (Hydrogen and other React\n * apps). Each call goes to one endpoint on your own server, which adds the\n * secret key and the shopper's identity from its session, then calls Bagsy.\n * The browser never holds a key, a customer id or a guest id.\n */\nexport function createRelayTransport(options: RelayOptions): Transport {\n  const endpoint = options.endpoint ?? '/api/bagsy';\n\n  async function send<T>(method: string, path: string, { query = {}, body }: RequestOptions = {}) {\n    const params: Record<string, string> = {};\n    for (const [key, value] of Object.entries(query)) {\n      if (value !== undefined) params[key] = Array.isArray(value) ? value.join(',') : String(value);\n    }\n    const call: RelayRequest = { method, path, ...(Object.keys(params).length && { query: params }), ...(body !== undefined && { body }) };\n\n    const response = await (options.fetch ?? fetch)(endpoint, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json', Accept: 'application/json' },\n      // Same-origin fetches send the session cookie by default.\n      body: JSON.stringify(call),\n    });\n    let payload: unknown;\n    try {\n      payload = await response.json();\n    } catch {\n      payload = undefined;\n    }\n    if (!response.ok || !isRelayResponse(payload)) {\n      // The relay itself failed (not wired up, crashed, or rejected the call).\n      throw new BagsyError(response.ok ? 502 : response.status, payload);\n    }\n    if (payload.status >= 400) throw new BagsyError(payload.status, payload.data);\n    return payload as RelayResponse<T>;\n  }\n\n  return {\n    options,\n    send,\n    request: async (method, path, init) => (await send(method, path, init)).data as never,\n  };\n}\n\nfunction isRelayResponse(value: unknown): value is RelayResponse {\n  return typeof value === 'object' && value !== null && typeof (value as RelayResponse).status === 'number';\n}\n","import * as op from './operations.js';\nimport { createAccountTransport } from './account.js';\nimport { createRelayTransport } from './relay.js';\nimport { createTransport } from './transport.js';\nimport type { Transport } from './transport.js';\nimport type { BagsyOptions, ItemOptions, ListRef, Owner, PageOptions, RelayOptions } from './types.js';\nimport type { ProductRef, VariantRef } from './ids.js';\n\n/**\n * The Bagsy client. Every method is a thin wrapper over a standalone function\n * in `operations` — use those directly if you want only what you import.\n */\nexport function createBagsy(options: BagsyOptions): Bagsy {\n  if (options.mode === 'relay') return createRelayClient(options);\n  const t = options.mode === 'account' ? createAccountTransport(options) : createTransport(options);\n  return clientFor(t, (owner) => {\n    if (options.mode === 'account') {\n      throw new TypeError('bagsy.as: in customer accounts the session token identifies the customer.');\n    }\n    if (options.mode === 'proxy') {\n      if (owner.customerId !== undefined) {\n        throw new TypeError('bagsy.as: on the app proxy the customer comes from Shopify; pass only `visitorId`.');\n      }\n      return createBagsy({ ...options, visitorId: owner.visitorId ?? options.visitorId });\n    }\n    return createBagsy({ ...options, ...owner });\n  });\n}\n\n/**\n * A client for browsers on headless storefronts, calling your server's relay\n * endpoint. Same API as `createBagsy({ mode: 'relay' })`, without bundling the\n * other transports.\n */\nexport function createRelayClient(options: Omit<RelayOptions, 'mode'> = {}): Bagsy {\n  return clientFor(createRelayTransport({ ...options, mode: 'relay' }), () => {\n    throw new TypeError(\"bagsy.as: through a relay, your server's session identifies the shopper.\");\n  });\n}\n\nfunction clientFor(t: Transport, as: (owner: Owner) => Bagsy) {\n\n  const items = {\n    list: (listId?: ListRef, page?: PageOptions) => op.listItems(t, listId, page),\n    /** Every item in a list, fetched page by page. */\n    iterate: (listId?: ListRef, opts?: { limit?: number }) => op.iterateItems(t, listId, opts),\n    /** Save a product. Saving it again returns the existing item. */\n    add: (product: ProductRef, opts?: ItemOptions & { quantity?: number; note?: string }) => op.addItem(t, product, opts),\n    /** Save if unsaved, unsave if saved. Built for heart buttons. */\n    toggle: (product: ProductRef, opts?: ItemOptions) => op.toggleItem(t, product, opts),\n    update: (\n      itemId: string,\n      patch: { variantId?: VariantRef | null; quantity?: number; note?: string | null },\n      opts?: { listId?: ListRef },\n    ) => op.updateItem(t, itemId, patch, opts),\n    remove: (itemId: string, opts?: { listId?: ListRef }) => op.removeItem(t, itemId, opts),\n    /** Unsave by product, without knowing the item id. No-op if not saved. */\n    removeProduct: (product: ProductRef, opts?: ItemOptions) => op.removeProduct(t, product, opts),\n  };\n\n  return {\n    lists: {\n      /** The owner's lists, default first. */\n      list: () => op.listLists(t),\n      get: (listId?: ListRef, opts?: { includeItems?: boolean }) => op.getList(t, listId, opts),\n      create: (name: string) => op.createList(t, name),\n      rename: (listId: ListRef, name: string) => op.renameList(t, listId, name),\n      delete: (listId: ListRef) => op.deleteList(t, listId),\n      /** The list's share token, created on first share. `rotate: true` issues a new one. */\n      share: (listId?: ListRef, opts?: { rotate?: boolean }) => op.shareList(t, listId, opts),\n      unshare: (listId?: ListRef) => op.unshareList(t, listId),\n    },\n    items,\n    /**\n     * Saved state for a set of products across all of the owner's lists.\n     * Accepts any number of products; batches of 100 are fetched in parallel.\n     */\n    saved: (products: Iterable<ProductRef>) => op.lookupSaved(t, products),\n    identity: {\n      /** Fold a guest's lists into the logged-in customer's. Safe to retry. */\n      merge: (visitorId?: string) => op.mergeVisitor(t, visitorId),\n    },\n    shared: {\n      /** Public, read-only view of a shared list. */\n      get: (shareToken: string, page?: PageOptions) => op.getSharedList(t, shareToken, page),\n    },\n    insights: {\n      /** Most-saved products. Server key only. */\n      topProducts: (query?: { since?: Date | string; limit?: number }) => op.topProducts(t, query),\n    },\n\n    /**\n     * A copy of this client acting for a specific shopper. In Hydrogen, call\n     * once per request with the customer from your Customer Account session.\n     */\n    as,\n  };\n}\n\nexport type Bagsy = ReturnType<typeof clientFor>;\n","const STORAGE_KEY = 'bagsy:visitor-id';\n\n/** The slice of Web Storage this module uses; `localStorage` satisfies it. */\nexport interface VisitorStorage {\n  getItem(key: string): string | null;\n  setItem(key: string, value: string): void;\n  removeItem(key: string): void;\n}\n\nlet memoryFallback: string | undefined;\n\n/**\n * Returns this browser's guest identity, creating it on first call.\n *\n * Persisted in localStorage. Falls back to an in-memory ID (for the page's\n * lifetime) when storage is blocked, e.g. in private windows or iframes.\n */\nexport function getVisitorId(storage: Pick<VisitorStorage, 'getItem' | 'setItem'> | undefined = safeLocalStorage()): string {\n  try {\n    const existing = storage?.getItem(STORAGE_KEY);\n    if (existing) return existing;\n  } catch {\n    // Storage unreadable; fall through to a fresh ID.\n  }\n\n  const id = memoryFallback ?? crypto.randomUUID();\n  memoryFallback = id;\n  try {\n    storage?.setItem(STORAGE_KEY, id);\n  } catch {\n    // Storage unwritable; the in-memory ID still works for this page.\n  }\n  return id;\n}\n\n/** The guest identity if one exists, without creating it. Use to decide whether to merge on login. */\nexport function peekVisitorId(storage: Pick<VisitorStorage, 'getItem'> | undefined = safeLocalStorage()): string | undefined {\n  try {\n    return storage?.getItem(STORAGE_KEY) ?? memoryFallback;\n  } catch {\n    return memoryFallback;\n  }\n}\n\n/** Forget the guest identity, e.g. after a successful merge on login. */\nexport function clearVisitorId(storage: Pick<VisitorStorage, 'removeItem'> | undefined = safeLocalStorage()): void {\n  memoryFallback = undefined;\n  try {\n    storage?.removeItem(STORAGE_KEY);\n  } catch {\n    // Nothing to clear.\n  }\n}\n\nfunction safeLocalStorage(): VisitorStorage | undefined {\n  try {\n    // Read via globalThis so this compiles without the DOM lib (Workers, Node).\n    return (globalThis as { localStorage?: VisitorStorage }).localStorage;\n  } catch {\n    return undefined;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/client-CXCgpFGa.d.ts

@@ -0,0 +1,169 @@
+import { T as Transport, O as Owner, c as components, L as ListRef, P as PageOptions, a as ProductRef, I as ItemOptions, V as VariantRef, S as SavedLookup, B as BagsyOptions, R as RelayOptions } from './transport-Chh09xIP.js';
+
+/**
+ * The Bagsy client. Every method is a thin wrapper over a standalone function
+ * in `operations` — use those directly if you want only what you import.
+ */
+declare function createBagsy(options: BagsyOptions): Bagsy;
+/**
+ * A client for browsers on headless storefronts, calling your server's relay
+ * endpoint. Same API as `createBagsy({ mode: 'relay' })`, without bundling the
+ * other transports.
+ */
+declare function createRelayClient(options?: Omit<RelayOptions, 'mode'>): Bagsy;
+declare function clientFor(t: Transport, as: (owner: Owner) => Bagsy): {
+    lists: {
+        /** The owner's lists, default first. */
+        list: () => Promise<{
+            id: string;
+            name: string;
+            isDefault: boolean;
+            visibility: "private" | "shared";
+            itemCount: number;
+            shareToken?: string | null;
+            createdAt: string;
+            updatedAt: string;
+            items?: components["schemas"]["ItemPage"];
+        }[]>;
+        get: (listId?: ListRef, opts?: {
+            includeItems?: boolean;
+        }) => Promise<{
+            id: string;
+            name: string;
+            isDefault: boolean;
+            visibility: "private" | "shared";
+            itemCount: number;
+            shareToken?: string | null;
+            createdAt: string;
+            updatedAt: string;
+            items?: components["schemas"]["ItemPage"];
+        }>;
+        create: (name: string) => Promise<{
+            id: string;
+            name: string;
+            isDefault: boolean;
+            visibility: "private" | "shared";
+            itemCount: number;
+            shareToken?: string | null;
+            createdAt: string;
+            updatedAt: string;
+            items?: components["schemas"]["ItemPage"];
+        }>;
+        rename: (listId: ListRef, name: string) => Promise<{
+            id: string;
+            name: string;
+            isDefault: boolean;
+            visibility: "private" | "shared";
+            itemCount: number;
+            shareToken?: string | null;
+            createdAt: string;
+            updatedAt: string;
+            items?: components["schemas"]["ItemPage"];
+        }>;
+        delete: (listId: ListRef) => Promise<void>;
+        /** The list's share token, created on first share. `rotate: true` issues a new one. */
+        share: (listId?: ListRef, opts?: {
+            rotate?: boolean;
+        }) => Promise<string>;
+        unshare: (listId?: ListRef) => Promise<void>;
+    };
+    items: {
+        list: (listId?: ListRef, page?: PageOptions) => Promise<{
+            data: components["schemas"]["Item"][];
+            pageInfo: {
+                hasNextPage: boolean;
+                endCursor?: string | null;
+            };
+        }>;
+        /** Every item in a list, fetched page by page. */
+        iterate: (listId?: ListRef, opts?: {
+            limit?: number;
+        }) => AsyncGenerator<{
+            id: string;
+            listId: string;
+            productId: components["schemas"]["ProductGid"];
+            variantId?: components["schemas"]["VariantGid"] | null;
+            quantity: number;
+            note?: string | null;
+            addedAt: string;
+        }, any, any>;
+        /** Save a product. Saving it again returns the existing item. */
+        add: (product: ProductRef, opts?: ItemOptions & {
+            quantity?: number;
+            note?: string;
+        }) => Promise<{
+            id: string;
+            listId: string;
+            productId: components["schemas"]["ProductGid"];
+            variantId?: components["schemas"]["VariantGid"] | null;
+            quantity: number;
+            note?: string | null;
+            addedAt: string;
+        }>;
+        /** Save if unsaved, unsave if saved. Built for heart buttons. */
+        toggle: (product: ProductRef, opts?: ItemOptions) => Promise<{
+            saved: boolean;
+        }>;
+        update: (itemId: string, patch: {
+            variantId?: VariantRef | null;
+            quantity?: number;
+            note?: string | null;
+        }, opts?: {
+            listId?: ListRef;
+        }) => Promise<{
+            id: string;
+            listId: string;
+            productId: components["schemas"]["ProductGid"];
+            variantId?: components["schemas"]["VariantGid"] | null;
+            quantity: number;
+            note?: string | null;
+            addedAt: string;
+        }>;
+        remove: (itemId: string, opts?: {
+            listId?: ListRef;
+        }) => Promise<void>;
+        /** Unsave by product, without knowing the item id. No-op if not saved. */
+        removeProduct: (product: ProductRef, opts?: ItemOptions) => Promise<void>;
+    };
+    /**
+     * Saved state for a set of products across all of the owner's lists.
+     * Accepts any number of products; batches of 100 are fetched in parallel.
+     */
+    saved: (products: Iterable<ProductRef>) => Promise<SavedLookup>;
+    identity: {
+        /** Fold a guest's lists into the logged-in customer's. Safe to retry. */
+        merge: (visitorId?: string) => Promise<{
+            mergedItems: number;
+            lists: components["schemas"]["List"][];
+        }>;
+    };
+    shared: {
+        /** Public, read-only view of a shared list. */
+        get: (shareToken: string, page?: PageOptions) => Promise<{
+            list: {
+                name: string;
+                itemCount: number;
+            };
+            items: components["schemas"]["ItemPage"];
+        }>;
+    };
+    insights: {
+        /** Most-saved products. Server key only. */
+        topProducts: (query?: {
+            since?: Date | string;
+            limit?: number;
+        }) => Promise<{
+            productId: components["schemas"]["ProductGid"];
+            saves: number;
+        }[]>;
+    };
+    /**
+     * A copy of this client acting for a specific shopper. In Hydrogen, call
+     * once per request with the customer from your Customer Account session.
+     */
+    as: (owner: Owner) => Bagsy;
+};
+type Bagsy = ReturnType<typeof clientFor>;
+
+export { createRelayClient as a, createBagsy as c };
+export type { Bagsy as B };