@sdg.la/wishlist-stack-sdk 0.10.0 → 0.11.0

package/AUTH_EXAMPLE.md

@@ -0,0 +1,209 @@
+# Getting a customer access token (Shopify Liquid storefront)
+
+Authenticated SDK endpoints require a `customerAccessToken`. In a Liquid theme, you typically run client-side JavaScript (theme asset or inline script) to perform the OAuth 2.0 + PKCE flow and pass the resulting `access_token` into `createWishlistStackClient({ customerAccessToken })`.
+
+**Official Shopify documentation:**
+
+- [Getting started with the Customer Account API](https://shopify.dev/docs/storefronts/headless/building-with-the-customer-account-api/getting-started) — setup, credentials, OAuth overview
+- [Customer Account API reference (OAuth)](https://shopify.dev/docs/api/customer/latest) — authorize/token endpoints, PKCE, `prompt=none` silent auth
+
+> **Example only.** This snippet is adapted from Shopify's documentation for illustration. It is not maintained or supported by this SDK. Your theme, Customer Account API settings, and Shopify session behavior may differ — mileage may vary. For Hydrogen storefronts, use [`@sdg.la/wishlist-stack-hydrogen`](../hydrogen/README.md) instead.
+
+## Flow
+
+1. Handle OAuth callback — exchange `code` for tokens
+2. Refresh existing tokens when possible
+3. Otherwise redirect with `prompt=none` for silent auth (requires an existing Shopify login session)
+
+## Prerequisites
+
+- Store ID and client ID from Customer Account API settings in Shopify admin
+- Redirect URI registered in admin (must match `redirectUri` in the script)
+- Customer logged in via the account link for silent auth to succeed
+
+## Example
+
+```js
+(async function () {
+  const storeId = "YOUR_STORE_ID";
+  const clientId = ""; // Client id from headless environment
+  const redirectUri = window.location.origin;
+
+  function generateRandomCode() {
+    const array = new Uint8Array(32);
+    crypto.getRandomValues(array);
+    return String.fromCharCode.apply(null, Array.from(array));
+  }
+
+  function base64UrlEncode(str) {
+    const base64 = btoa(str);
+    return base64.replace(/\+/g, "-").replace(/\//g, "_").replace(/=/g, "");
+  }
+
+  function convertBufferToString(hash) {
+    const uintArray = new Uint8Array(hash);
+    const numberArray = Array.from(uintArray);
+    return String.fromCharCode(...numberArray);
+  }
+
+  async function generateCodeVerifier() {
+    const rando = generateRandomCode();
+    return base64UrlEncode(rando);
+  }
+
+  async function generateCodeChallenge(codeVerifier) {
+    const digestOp = await crypto.subtle.digest(
+      { name: "SHA-256" },
+      new TextEncoder().encode(codeVerifier),
+    );
+    const hash = convertBufferToString(digestOp);
+    return base64UrlEncode(hash);
+  }
+
+  async function generateState() {
+    const timestamp = Date.now().toString();
+    const randomString = Math.random().toString(36).substring(2);
+    return timestamp + randomString;
+  }
+
+  async function generateNonce(length) {
+    const characters =
+      "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+    let nonce = "";
+    for (let i = 0; i < length; i++) {
+      const randomIndex = Math.floor(Math.random() * characters.length);
+      nonce += characters.charAt(randomIndex);
+    }
+    return nonce;
+  }
+
+  // ── Step 1: Check for authorization code in URL (callback handler) ──
+
+  const urlParams = new URLSearchParams(window.location.search);
+  const code = urlParams.get("code");
+
+  if (code) {
+    console.log("Authorization code found, exchanging for tokens...");
+
+    const codeVerifier = localStorage.getItem("code-verifier");
+    if (!codeVerifier) {
+      console.error("No code-verifier found in localStorage. Cannot exchange code.");
+      return;
+    }
+
+    // Clean up URL
+    urlParams.delete("code");
+    urlParams.delete("state");
+    const newUrl = `${window.location.pathname}${urlParams.toString() ? `?${urlParams.toString()}` : ""}${window.location.hash}`;
+    window.history.replaceState({}, "", newUrl);
+    localStorage.removeItem("code-verifier");
+
+    // Exchange code for tokens
+    const body = new URLSearchParams();
+    body.append("grant_type", "authorization_code");
+    body.append("client_id", clientId);
+    body.append("redirect_uri", redirectUri);
+    body.append("code", code);
+    body.append("code_verifier", codeVerifier);
+
+    try {
+      const response = await fetch(
+        `https://shopify.com/authentication/${storeId}/oauth/token`,
+        {
+          method: "POST",
+          headers: { "content-type": "application/x-www-form-urlencoded" },
+          body,
+        },
+      );
+      const data = await response.json();
+
+      if (!data.access_token) {
+        console.error("Token exchange failed:", data);
+        return;
+      }
+
+      const { access_token, expires_in, id_token, refresh_token } = data;
+      localStorage.setItem(
+        "customer-access-data",
+        JSON.stringify({ access_token, expires_in, id_token, refresh_token }),
+      );
+      console.log("Access token obtained successfully!");
+      console.log("Access Token:", access_token);
+
+      return;
+    } catch (error) {
+      console.error("Error exchanging code for tokens:", error);
+      return;
+    }
+  }
+
+  // ── Step 2: Check for existing tokens and try refresh ──
+
+  const existingData = localStorage.getItem("customer-access-data");
+  if (existingData) {
+    const parsed = JSON.parse(existingData);
+    if (parsed.refresh_token) {
+      console.log("Found existing refresh token, attempting refresh...");
+
+      const body = new URLSearchParams();
+      body.append("grant_type", "refresh_token");
+      body.append("client_id", clientId);
+      body.append("refresh_token", parsed.refresh_token);
+
+      try {
+        const response = await fetch(
+          `https://shopify.com/authentication/${storeId}/oauth/token`,
+          {
+            method: "POST",
+            headers: { "content-type": "application/x-www-form-urlencoded" },
+            body,
+          },
+        );
+        const data = await response.json();
+
+        if (data.access_token) {
+          localStorage.setItem(
+            "customer-access-data",
+            JSON.stringify({
+              access_token: data.access_token,
+              expires_in: data.expires_in,
+              id_token: data.id_token || parsed.id_token,
+              refresh_token: data.refresh_token,
+            }),
+          );
+          console.log("Token refreshed successfully!");
+          console.log("Access Token:", data.access_token);
+          return;
+        }
+      } catch (error) {
+        console.warn("Refresh failed, will attempt silent auth:", error);
+      }
+    }
+  }
+
+  const state = await generateState();
+  const nonce = await generateNonce(16);
+  const verifier = await generateCodeVerifier();
+  const challenge = await generateCodeChallenge(verifier);
+  localStorage.setItem("code-verifier", verifier);
+
+  const authUrl = new URL(
+    `https://shopify.com/authentication/${storeId}/oauth/authorize`,
+  );
+  authUrl.searchParams.append("scope", "openid email customer-account-api:full");
+  authUrl.searchParams.append("client_id", clientId);
+  authUrl.searchParams.append("response_type", "code");
+  authUrl.searchParams.append("redirect_uri", redirectUri);
+  authUrl.searchParams.append("state", state);
+  authUrl.searchParams.append("nonce", nonce);
+  authUrl.searchParams.append("code_challenge", challenge);
+  authUrl.searchParams.append("code_challenge_method", "S256");
+  authUrl.searchParams.append("prompt", "none"); // Silent auth - no login UI
+
+  console.log("Redirecting for silent auth...");
+  console.log("If you see a login_required error in the URL after redirect,");
+  console.log("it means no Shopify session exists - log in via the account link first.");
+
+  window.location.href = authUrl.toString();
+})();
+```

package/README.md

@@ -14,6 +14,8 @@ TypeScript/JavaScript SDK for the Wishlist Stack API.
 - [Usage](#usage)
   - [Server / Node.js / Workers](#server--nodejs--workers)
   - [Browser](#browser)
+  - [Raw HTML (script module)](#raw-html-script-module)
+  - [Shopify Liquid authentication](#shopify-liquid-authentication)
   - [Class API](#class-api)
 - [Error Handling](#error-handling)
 - [Pagination](#pagination)
@@ -102,6 +104,35 @@ const { lists } = await client.lists.getAll();
 
 > **Note:** If you use a strict Content Security Policy (CSP), you must allow your API domain in `connect-src`.
 
+### Raw HTML (script module)
+
+You can load the SDK in plain HTML without a bundler by using a `<script type="module">` tag and importing from a CDN:
+
+```html
+<script type="module">
+  import { createWishlistStackClient } from "https://cdn.jsdelivr.net/npm/@sdg.la/wishlist-stack-sdk@0.10.1/+esm";
+
+  window.wishlistClient = createWishlistStackClient({
+    apiKey: "YOUR_MERCHANT_API_KEY",
+    customerAccessToken: "...",
+  });
+
+  // Example usage:
+  await window.wishlistClient.groups.getAll();
+  await window.wishlistClient.lists.getAll();
+</script>
+```
+
+Pin the version in the CDN URL (as shown above) so updates do not break your integration unexpectedly.
+
+> **Note:** With a strict CSP, allow `https://cdn.jsdelivr.net` in `script-src` (for the module import) and your API domain in `connect-src`.
+
+### Shopify Liquid authentication
+
+Authenticated SDK calls require a customer access token. For Liquid themes, obtain one via Shopify's Customer Account API OAuth flow in the browser.
+
+See [AUTH_EXAMPLE.md](./AUTH_EXAMPLE.md) for an example-only reference implementation adapted from Shopify's docs.
+
 ### Class API
 
 If you prefer a class-based API, use `WishlistStackSDK`:
@@ -154,6 +185,9 @@ Endpoints that return lists support pagination via query parameters:
 // Paginate groups
 await client.groups.getAll({ page: 2, pageSize: 10 });
 
+// Include lists + hydrated items on groups.getAll
+await client.groups.getAll({ includeLists: true });
+
 // Paginate lists within a group
 await client.groups.getById('group-id', { page: 1, pageSize: 25 });
 
@@ -185,11 +219,16 @@ await client.lists.getById('list-id', { page: 1, pageSize: 25 });
 Fetch all groups for the authenticated customer.
 
 - **Endpoint:** `GET /api/groups`
-- **Parameters:** `query?` — `{ page?: number; pageSize?: number, query?: string }`
+- **Parameters:** `query?` — `{ page?: number; pageSize?: number; query?: string; includeLists?: boolean | 1 | "1" }`
 - **Returns:** `Promise<GetGroupsResponse>`
 
+Pass `includeLists: true` (sent as `includeLists=1`) to embed every list under each group with fully hydrated items — useful for loading projects/boards in one call instead of per-group `getById` fan-out. Without it, `lists` is an empty array and only `featuredItems` are populated.
+
 ```ts
 const { groups, pagination } = await client.groups.getAll({ page: 1, pageSize: 10, query: 'holiday' });
+
+// Include lists + hydrated items
+const { groups: withLists } = await client.groups.getAll({ includeLists: true });
 ```
 
 <details>
@@ -205,6 +244,7 @@ const { groups, pagination } = await client.groups.getAll({ page: 1, pageSize: 1
       "position": 1,
       "shared": false,
       "listCount": 2,
+      "lists": [],
       "createdAt": "2025-01-10T08:00:00.000Z",
       "updatedAt": "2025-01-18T12:00:00.000Z",
       "featuredItems": [
@@ -231,6 +271,75 @@ const { groups, pagination } = await client.groups.getAll({ page: 1, pageSize: 1
 
 </details>
 
+<details>
+<summary>Example response with <code>includeLists: true</code></summary>
+
+```json
+{
+  "groups": [
+    {
+      "id": "cml8drad90001js09weonjojg",
+      "name": "Holiday Lists",
+      "description": "All my holiday wishlists",
+      "position": 1,
+      "shared": false,
+      "listCount": 1,
+      "lists": [
+        {
+          "id": "cml8drg8x0003js093j4ua6p8",
+          "name": "Gift Ideas",
+          "description": "Birthday gift ideas",
+          "position": 1,
+          "shared": false,
+          "itemCount": 1,
+          "items": [
+            {
+              "id": "item_1",
+              "quantity": 1,
+              "position": 1,
+              "userNote": null,
+              "product": {
+                "id": "gid://shopify/Product/1",
+                "title": "Example Product",
+                "description": "",
+                "availableForSale": true,
+                "handle": "example-product",
+                "productType": null,
+                "category": null,
+                "tags": [],
+                "onlineStoreUrl": null,
+                "metafields": [],
+                "vendor": null,
+                "variant": {
+                  "id": "46932429275374",
+                  "title": "Default",
+                  "price": { "amount": "10.00", "currencyCode": "USD" },
+                  "availableForSale": true,
+                  "currentlyNotInStock": false,
+                  "selectedOptions": [],
+                  "metafields": []
+                }
+              }
+            }
+          ]
+        }
+      ],
+      "featuredItems": [],
+      "createdAt": "2025-01-10T08:00:00.000Z",
+      "updatedAt": "2025-01-18T12:00:00.000Z"
+    }
+  ],
+  "pagination": {
+    "page": 1,
+    "pageSize": 10,
+    "totalCount": 1,
+    "totalPages": 1
+  }
+}
+```
+
+</details>
+
 ---
 
 #### `groups.getById(groupId, query?)`
@@ -383,6 +492,38 @@ await client.groups.remove('group-id');
 
 ---
 
+#### `groups.duplicate(groupId)`
+
+Duplicate a group in a single call, including all of its lists and items. The copy is named `Copy of {original name}` and is not shared.
+
+- **Endpoint:** `POST /api/groups/{groupId}/duplicate`
+- **Parameters:** `groupId` — `string`
+- **Returns:** `Promise<DuplicateGroupResponse>`
+
+```ts
+const copy = await client.groups.duplicate('group-id');
+```
+
+<details>
+<summary>Example response</summary>
+
+```json
+{
+  "id": "cmlbe49qk0001ju094x1ya9co",
+  "name": "Copy of Holiday Lists",
+  "description": "All my holiday wishlists",
+  "position": 2,
+  "shared": false,
+  "listCount": 2,
+  "createdAt": "2025-01-22T09:15:00.000Z",
+  "updatedAt": "2025-01-22T09:15:00.000Z"
+}
+```
+
+</details>
+
+---
+
 #### `groups.reorder(groupId, body)`
 
 Reorder lists within a group.
@@ -685,6 +826,38 @@ await client.lists.remove('list-id');
 
 ---
 
+#### `lists.duplicate(listId)`
+
+Duplicate a list in a single call, including all of its items. The copy stays in the same group (if any), is named `Copy of {original name}`, and is not shared.
+
+- **Endpoint:** `POST /api/lists/{listId}/duplicate`
+- **Parameters:** `listId` — `string`
+- **Returns:** `Promise<DuplicateListResponse>`
+
+```ts
+const copy = await client.lists.duplicate('list-id');
+```
+
+<details>
+<summary>Example response</summary>
+
+```json
+{
+  "id": "cml8drg8x0003js093j4ua6p8",
+  "name": "Copy of Gift Ideas",
+  "description": "Birthday gift ideas",
+  "position": 2,
+  "shared": false,
+  "itemCount": 3,
+  "createdAt": "2025-01-22T09:15:00.000Z",
+  "updatedAt": "2025-01-22T09:15:00.000Z"
+}
+```
+
+</details>
+
+---
+
 #### `lists.addItems(listId, body)`
 
 Add one or more items to a list.
@@ -962,23 +1135,28 @@ import type {
   GetGroupsResponse,
   GetGroupResponse,
   GroupSummary,
+  GroupSummaryList,
   GroupDetail,
   GroupDetailList,
+  GroupMutationResponse,
   CreateGroupBody,
   UpdateGroupBody,
   ReorderGroupBody,
+  DuplicateGroupResponse,
 
   // Lists
   GetListsResponse,
   GetListResponse,
   ListSummary,
   ListDetail,
+  ListMutationResponse,
   CreateListBody,
   UpdateListBody,
   AddItemsToListBody,
   UpdateListItemBody,
   ReorderListItemsBody,
   ReorderListItemsResponse,
+  DuplicateListResponse,
 
   // Shared
   GetSharedListResponse,
@@ -1030,10 +1208,22 @@ type GroupSummary = {
   position: number;
   shared: boolean;
   listCount: number;
+  /** Empty unless `includeLists` was requested on `groups.getAll()`. */
+  lists: GroupSummaryList[];
   featuredItems: FeaturedItem[];
   createdAt: string;
   updatedAt: string;
 };
+
+type GroupSummaryList = {
+  id: string;
+  name: string;
+  description: string | null;
+  position: number;
+  shared: boolean;
+  itemCount: number;
+  items: HydratedWishlistItem[];
+};
 ```
 
 </details>

package/dist/index.cjs

@@ -177,6 +177,16 @@ function createListsResource(request) {
       path: `/api/lists/${encodeURIComponent(listId)}`,
       auth: "authenticated"
     }),
+    /**
+     * Duplicate a list (including all items) in a single call.
+     * The copy stays in the same group (if any), is named `Copy of {original name}`,
+     * and is not shared.
+     */
+    duplicate: (listId) => request({
+      method: "POST",
+      path: `/api/lists/${encodeURIComponent(listId)}/duplicate`,
+      auth: "authenticated"
+    }),
     /** Add one or more items to a list. */
     addItems: (listId, body) => request({
       method: "POST",
@@ -230,6 +240,14 @@ function createListsResource(request) {
 }
 
 // src/resources/groups/index.ts
+function normalizeGetGroupsQuery(query) {
+  if (!query) return void 0;
+  const { includeLists, ...rest } = query;
+  if (includeLists) {
+    return { ...rest, includeLists: 1 };
+  }
+  return Object.keys(rest).length > 0 ? rest : void 0;
+}
 function createGroupsResource(request) {
   return {
     /** Fetch groups for the authenticated customer. */
@@ -237,7 +255,7 @@ function createGroupsResource(request) {
       method: "GET",
       path: "/api/groups",
       auth: "authenticated",
-      query
+      query: normalizeGetGroupsQuery(query)
     }),
     /** Fetch group details by id. */
     getById: (groupId, query) => request({
@@ -266,6 +284,15 @@ function createGroupsResource(request) {
       path: `/api/groups/${encodeURIComponent(groupId)}`,
       auth: "authenticated"
     }),
+    /**
+     * Duplicate a group (including all lists and items) in a single call.
+     * The copy is named `Copy of {original name}` and is not shared.
+     */
+    duplicate: (groupId) => request({
+      method: "POST",
+      path: `/api/groups/${encodeURIComponent(groupId)}/duplicate`,
+      auth: "authenticated"
+    }),
     /** Reorder a group (spec uses listIds payload). */
     reorder: (groupId, body) => request({
       method: "POST",

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/constants.ts","../src/client/query.ts","../src/client/errors.ts","../src/client/request.ts","../src/resources/lists/index.ts","../src/resources/groups/index.ts","../src/resources/shared/index.ts","../src/client/createWishlistStackClient.ts","../src/WishlistStackClient.ts","../src/types/pagination.ts","../src/types/query-options.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["export const MAX_PAGINATION_SIZE = 25 as const;\nexport const BASE_URL = \"https://wishlist.devteam.run\" as const;\n\n","export type QueryValue =\n  | string\n  | number\n  | boolean\n  | null\n  | undefined\n  | Array<string | number | boolean | null | undefined>;\n\nexport type Query = Record<string, QueryValue>;\n\nexport function toQueryString(query?: Query): string {\n  if (!query) return \"\";\n\n  const params = new URLSearchParams();\n  for (const [key, value] of Object.entries(query)) {\n    if (value === undefined || value === null) continue;\n    if (Array.isArray(value)) {\n      for (const v of value) {\n        if (v === undefined || v === null) continue;\n        params.append(key, String(v));\n      }\n      continue;\n    }\n    params.set(key, String(value));\n  }\n\n  const qs = params.toString();\n  return qs ? `?${qs}` : \"\";\n}\n\n","export type WishlistStackApiErrorDetails<TBody = unknown> = {\n  status: number;\n  url: string;\n  method: string;\n  requestId?: string;\n  body?: TBody;\n};\n\ntype ApiErrorItemLike = { message?: unknown; field?: unknown };\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction isApiErrorItemLike(value: unknown): value is ApiErrorItemLike {\n  return isRecord(value) && \"message\" in value;\n}\n\nfunction extractApiErrors(body: unknown): Array<{ message: string; field?: string }> | undefined {\n  if (!isRecord(body)) return undefined;\n  const errors = body.errors;\n  if (!Array.isArray(errors)) return undefined;\n  const out: Array<{ message: string; field?: string }> = [];\n  for (const e of errors) {\n    if (!isApiErrorItemLike(e)) continue;\n    const msg = typeof e.message === \"string\" ? e.message : undefined;\n    if (!msg) continue;\n    const field = typeof (e as any).field === \"string\" ? (e as any).field : undefined;\n    out.push(field ? { message: msg, field } : { message: msg });\n  }\n  return out.length ? out : undefined;\n}\n\nexport class WishlistStackApiError<TBody = unknown> extends Error {\n  readonly name = \"WishlistStackApiError\";\n  readonly status: number;\n  readonly url: string;\n  readonly method: string;\n  readonly requestId?: string;\n  readonly body?: TBody;\n\n  constructor(message: string, details: WishlistStackApiErrorDetails<TBody>) {\n    super(message);\n    this.status = details.status;\n    this.url = details.url;\n    this.method = details.method;\n    this.requestId = details.requestId;\n    this.body = details.body;\n  }\n\n  /**\n   * Best-effort extraction of API error items from the response body.\n   * Useful for UI/logging without needing to know the exact response shape.\n   */\n  get apiErrors(): Array<{ message: string; field?: string }> | undefined {\n    return extractApiErrors(this.body);\n  }\n\n  /**\n   * Convenience: extracted error messages (if present).\n   */\n  get apiErrorMessages(): string[] | undefined {\n    const errs = this.apiErrors;\n    return errs?.map((e) => e.message);\n  }\n}\n\n/**\n * Bundler-safe type guard (prefer this over `instanceof WishlistStackApiError`).\n */\nexport function isWishlistStackApiError(value: unknown): value is WishlistStackApiError<unknown> {\n  if (!isRecord(value)) return false;\n  return (\n    (value as any).name === \"WishlistStackApiError\" &&\n    typeof (value as any).status === \"number\" &&\n    typeof (value as any).url === \"string\" &&\n    typeof (value as any).method === \"string\"\n  );\n}\n\n","import { toQueryString, type Query } from \"./query\";\nimport { WishlistStackApiError } from \"./errors\";\nimport type { ApiErrorResponse } from \"../types/common\";\n\nexport type FetchLike = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;\n\nexport type AuthMode = \"authenticated\" | \"merchant\";\n\nexport type RequestContext = {\n  baseUrl: string;\n  apiKey: string;\n  customerAccessToken?: string;\n  fetch: FetchLike;\n};\n\nexport type RequestArgs<TBody> = {\n  method: \"GET\" | \"POST\" | \"PATCH\" | \"DELETE\";\n  path: string;\n  auth: AuthMode;\n  query?: Query;\n  body?: TBody;\n  headers?: Record<string, string>;\n  signal?: AbortSignal;\n  timeoutMs?: number;\n};\n\nasync function safeParseJson(res: Response): Promise<unknown | undefined> {\n  const contentType = res.headers.get(\"content-type\") ?? \"\";\n  if (!contentType.toLowerCase().includes(\"application/json\")) return undefined;\n  try {\n    return await res.json();\n  } catch {\n    return undefined;\n  }\n}\n\nexport function createRequest(ctx: RequestContext) {\n  return async function request<TResponse = unknown, TBody = unknown>(\n    args: RequestArgs<TBody>,\n  ): Promise<TResponse> {\n    const url = `${ctx.baseUrl}${args.path}${toQueryString(args.query)}`;\n\n    const headers: Record<string, string> = {\n      \"X-Wishlist-Stack-Api-Key\": ctx.apiKey,\n      ...(args.headers ?? {}),\n    };\n\n    if (args.auth === \"authenticated\") {\n      const token = ctx.customerAccessToken;\n      // If token is missing, still perform the request and let the API return the appropriate\n      // error response (which we will surface as a WishlistStackApiError based on the HTTP response).\n      if (token) headers[\"X-Shopify-Customer-Access-Token\"] = token;\n    }\n\n    let body: BodyInit | undefined;\n    if (args.body !== undefined) {\n      // Only JSON bodies are supported for this SDK.\n      headers[\"content-type\"] ??= \"application/json\";\n      body = JSON.stringify(args.body);\n    }\n\n    const controller = args.timeoutMs ? new AbortController() : undefined;\n    const timeout =\n      args.timeoutMs && controller\n        ? setTimeout(() => controller.abort(), args.timeoutMs)\n        : undefined;\n\n    const signal = args.signal\n      ? args.signal\n      : controller\n        ? controller.signal\n        : undefined;\n\n    const res = await ctx.fetch(url, {\n      method: args.method,\n      headers,\n      body,\n      signal,\n    });\n\n    if (timeout) clearTimeout(timeout);\n\n    if (!res.ok) {\n      const errBody = (await safeParseJson(res)) as ApiErrorResponse | unknown;\n      const requestId =\n        res.headers.get(\"fly-request-id\") ??\n        res.headers.get(\"x-request-id\") ??\n        undefined;\n      throw new WishlistStackApiError<ApiErrorResponse | unknown>(`Wishlist Stack API request failed (${res.status})`, {\n        status: res.status,\n        url,\n        method: args.method,\n        requestId,\n        body: errBody,\n      });\n    }\n\n    if (res.status === 204) return undefined as TResponse;\n\n    const parsed = await safeParseJson(res);\n    // If server didn't return JSON, return the raw text as unknown.\n    if (parsed === undefined) {\n      const text = await res.text().catch(() => \"\");\n      return text as unknown as TResponse;\n    }\n\n    return parsed as TResponse;\n  };\n}\n\n","import type { RequestArgs } from \"../../client/request\";\nimport type { PaginatedQuery } from \"../../types/query-options\";\nimport type {\n  AddItemsToListBody,\n  CreateListBody,\n  ReorderListItemsBody,\n  UpdateListBody,\n  UpdateListItemBody,\n} from \"../../types/requests/lists\";\nimport type {\n  AddItemsToListResponse,\n  CreateListResponse,\n  GetListResponse,\n  GetListsResponse,\n  MarkListSharedResponse,\n  RemoveItemFromListResponse,\n  RemoveListResponse,\n  ReorderListItemsResponse,\n  RevokeListSharedResponse,\n  UpdateListDetailsResponse,\n  UpdateListItemResponse,\n} from \"../../types/responses/lists\";\n\ntype RequestFn = <TResponse = unknown, TBody = unknown>(\n  args: RequestArgs<TBody>,\n) => Promise<TResponse>;\n\nexport type GetListsQuery = PaginatedQuery;\nexport type GetListQuery = Omit<PaginatedQuery, \"query\">;\n\nexport function createListsResource(request: RequestFn) {\n  return {\n    /** Returns all lists for the authenticated customer under the current merchant. */\n    getAll: (query?: GetListsQuery) =>\n      request<GetListsResponse>({\n        method: \"GET\",\n        path: \"/api/lists\",\n        auth: \"authenticated\",\n        query,\n      }),\n\n    /** Fetch list details by id. */\n    getById: (listId: string, query?: GetListQuery) =>\n      request<GetListResponse>({\n        method: \"GET\",\n        path: `/api/lists/${encodeURIComponent(listId)}`,\n        auth: \"authenticated\",\n        query,\n      }),\n\n    /** Create a new list. */\n    create: (body: CreateListBody) =>\n      request<CreateListResponse, CreateListBody>({\n        method: \"POST\",\n        path: \"/api/lists\",\n        auth: \"authenticated\",\n        body,\n      }),\n\n    /** Update list name/description. */\n    update: (listId: string, body: UpdateListBody) =>\n      request<UpdateListDetailsResponse, UpdateListBody>({\n        method: \"PATCH\",\n        path: `/api/lists/${encodeURIComponent(listId)}`,\n        auth: \"authenticated\",\n        body,\n      }),\n\n    /** Remove a list. */\n    remove: (listId: string) =>\n      request<RemoveListResponse>({\n        method: \"DELETE\",\n        path: `/api/lists/${encodeURIComponent(listId)}`,\n        auth: \"authenticated\",\n      }),\n\n    /** Add one or more items to a list. */\n    addItems: (listId: string, body: AddItemsToListBody) =>\n      request<AddItemsToListResponse, AddItemsToListBody>({\n        method: \"POST\",\n        path: `/api/lists/${encodeURIComponent(listId)}/add`,\n        auth: \"authenticated\",\n        body,\n      }),\n\n    /** Update an item on a list. */\n    updateItem: (listId: string, itemId: string, body: UpdateListItemBody) =>\n      request<UpdateListItemResponse, UpdateListItemBody>({\n        method: \"PATCH\",\n        path: `/api/lists/${encodeURIComponent(listId)}/items/${encodeURIComponent(itemId)}`,\n        auth: \"authenticated\",\n        body,\n      }),\n\n    /** Remove an item from a list. */\n    removeItem: (listId: string, itemId: string) =>\n      request<RemoveItemFromListResponse>({\n        method: \"DELETE\",\n        path: `/api/lists/${encodeURIComponent(listId)}/items/${encodeURIComponent(itemId)}`,\n        auth: \"authenticated\",\n      }),\n\n    /** Reorder all items in a list. */\n    reorderItems: (listId: string, body: ReorderListItemsBody) =>\n      request<ReorderListItemsResponse, ReorderListItemsBody>({\n        method: \"POST\",\n        path: `/api/lists/${encodeURIComponent(listId)}/reorder`,\n        auth: \"authenticated\",\n        body,\n      }),\n\n    /** Mark list as shared (public read-only). */\n    share: (listId: string) =>\n      request<MarkListSharedResponse>({\n        method: \"POST\",\n        path: `/api/lists/${encodeURIComponent(listId)}/share`,\n        auth: \"authenticated\",\n      }),\n\n    /** Revoke list sharing. */\n    unshare: (listId: string) =>\n      request<RevokeListSharedResponse>({\n        method: \"DELETE\",\n        path: `/api/lists/${encodeURIComponent(listId)}/share`,\n        auth: \"authenticated\",\n      }),\n\n    /**\n     * Legacy endpoint kept in the OpenAPI spec (`/api/wishlists/{id}/add`).\n     * Prefer `addItems(listId, body)` unless your server only supports the legacy route.\n     */\n    addItemsLegacy: (id: string, body: AddItemsToListBody) =>\n      request<AddItemsToListResponse, AddItemsToListBody>({\n        method: \"POST\",\n        path: `/api/wishlists/${encodeURIComponent(id)}/add`,\n        auth: \"authenticated\",\n        body,\n      }),\n  };\n}\n\n","import type { RequestArgs } from \"../../client/request\";\nimport type { CreateGroupBody, ReorderGroupBody, UpdateGroupBody } from \"../../types/requests/groups\";\nimport type { PaginatedQuery } from \"../../types/query-options\";\nimport type {\n  CreateGroupResponse,\n  GetGroupResponse,\n  GetGroupsResponse,\n  MarkGroupSharedResponse,\n  RemoveGroupResponse,\n  ReorderGroupResponse,\n  RevokeGroupSharedResponse,\n  UpdateGroupDetailsResponse,\n} from \"../../types/responses/groups\";\n\ntype RequestFn = <TResponse = unknown, TBody = unknown>(\n  args: RequestArgs<TBody>,\n) => Promise<TResponse>;\n\nexport type GetGroupsQuery = PaginatedQuery;\nexport type GetGroupQuery = PaginatedQuery;\n\nexport function createGroupsResource(request: RequestFn) {\n  return {\n    /** Fetch groups for the authenticated customer. */\n    getAll: (query?: GetGroupsQuery) =>\n      request<GetGroupsResponse>({\n        method: \"GET\",\n        path: \"/api/groups\",\n        auth: \"authenticated\",\n        query,\n      }),\n\n    /** Fetch group details by id. */\n    getById: (groupId: string, query?: GetGroupQuery) =>\n      request<GetGroupResponse>({\n        method: \"GET\",\n        path: `/api/groups/${encodeURIComponent(groupId)}`,\n        auth: \"authenticated\",\n        query,\n      }),\n\n    /** Create a new group. */\n    create: (body: CreateGroupBody) =>\n      request<CreateGroupResponse, CreateGroupBody>({\n        method: \"POST\",\n        path: \"/api/groups\",\n        auth: \"authenticated\",\n        body,\n      }),\n\n    /** Update group name/description. */\n    update: (groupId: string, body: UpdateGroupBody) =>\n      request<UpdateGroupDetailsResponse, UpdateGroupBody>({\n        method: \"PATCH\",\n        path: `/api/groups/${encodeURIComponent(groupId)}`,\n        auth: \"authenticated\",\n        body,\n      }),\n\n    /** Remove a group. */\n    remove: (groupId: string) =>\n      request<RemoveGroupResponse>({\n        method: \"DELETE\",\n        path: `/api/groups/${encodeURIComponent(groupId)}`,\n        auth: \"authenticated\",\n      }),\n\n    /** Reorder a group (spec uses listIds payload). */\n    reorder: (groupId: string, body: ReorderGroupBody) =>\n      request<ReorderGroupResponse, ReorderGroupBody>({\n        method: \"POST\",\n        path: `/api/groups/${encodeURIComponent(groupId)}/reorder`,\n        auth: \"authenticated\",\n        body,\n      }),\n\n    /** Mark group as shared (public read-only). */\n    share: (groupId: string) =>\n      request<MarkGroupSharedResponse>({\n        method: \"POST\",\n        path: `/api/groups/${encodeURIComponent(groupId)}/share`,\n        auth: \"authenticated\",\n      }),\n\n    /** Revoke group sharing. */\n    unshare: (groupId: string) =>\n      request<RevokeGroupSharedResponse>({\n        method: \"DELETE\",\n        path: `/api/groups/${encodeURIComponent(groupId)}/share`,\n        auth: \"authenticated\",\n      }),\n  };\n}\n\n","import type { RequestArgs } from \"../../client/request\";\nimport type { GetSharedGroupResponse, GetSharedListResponse } from \"../../types/responses/shared\";\n\ntype RequestFn = <TResponse = unknown, TBody = unknown>(\n  args: RequestArgs<TBody>,\n) => Promise<TResponse>;\n\nexport function createSharedResource(request: RequestFn) {\n  return {\n    /** Public read-only view of a shared list. Requires only merchant apiKey. */\n    getSharedList: (listId: string) =>\n      request<GetSharedListResponse>({\n        method: \"GET\",\n        path: `/api/shared/list/${encodeURIComponent(listId)}`,\n        auth: \"merchant\",\n      }),\n\n    /** Public read-only view of a shared group. Requires only merchant apiKey. */\n    getSharedGroup: (groupId: string) =>\n      request<GetSharedGroupResponse>({\n        method: \"GET\",\n        path: `/api/shared/group/${encodeURIComponent(groupId)}`,\n        auth: \"merchant\",\n      }),\n  };\n}\n\n","import { BASE_URL } from \"../constants\";\nimport { createRequest, type FetchLike } from \"./request\";\nimport { createListsResource } from \"../resources/lists\";\nimport { createGroupsResource } from \"../resources/groups\";\nimport { createSharedResource } from \"../resources/shared\";\n\nexport type CreateWishlistStackClientOptions = {\n  baseUrl?: string;\n  apiKey: string;\n  customerAccessToken?: string;\n  fetch?: FetchLike;\n};\n\nexport type WishlistStackClient = {\n  lists: ReturnType<typeof createListsResource>;\n  groups: ReturnType<typeof createGroupsResource>;\n  shared: ReturnType<typeof createSharedResource>;\n};\n\nexport function createWishlistStackClient(opts: CreateWishlistStackClientOptions): WishlistStackClient {\n  if (!opts.apiKey) {\n    throw new Error(\n      \"merchant api key is required. Pass it to createWishlistStackClient({ apiKey })\",\n    );\n  }\n\n  // Cloudflare Workers (and some other runtimes) can throw \"Illegal invocation\" if you\n  // capture `globalThis.fetch` and call it later without the correct `this` binding.\n  // So: default to a wrapper that calls `globalThis.fetch(...)` directly.\n  const fetchImpl: FetchLike | undefined =\n    opts.fetch ??\n    (typeof globalThis.fetch === \"function\"\n      ? ((input, init) => globalThis.fetch(input, init)) // keep correct invocation context\n      : undefined);\n\n  if (!fetchImpl) {\n    throw new Error(\n      \"No fetch implementation found. Provide one via createWishlistStackClient({ fetch }) or use Node 18+ / modern browsers.\",\n    );\n  }\n\n  const request = createRequest({\n    baseUrl: opts.baseUrl ?? BASE_URL,\n    apiKey: opts.apiKey,\n    customerAccessToken: opts.customerAccessToken,\n    fetch: fetchImpl,\n  });\n\n  return {\n    lists: createListsResource(request),\n    groups: createGroupsResource(request),\n    shared: createSharedResource(request),\n  };\n}\n","import { createWishlistStackClient, type CreateWishlistStackClientOptions, type WishlistStackClient as IWishlistStackClient } from \"./client/createWishlistStackClient\";\n\n/**\n * Class wrapper around `createWishlistStackClient()` for users who prefer `new`.\n * Exposes `lists`, `groups`, and `shared` resources.\n */\nexport class WishlistStackClient implements IWishlistStackClient {\n  readonly lists: IWishlistStackClient[\"lists\"];\n  readonly groups: IWishlistStackClient[\"groups\"];\n  readonly shared: IWishlistStackClient[\"shared\"];\n\n  constructor(opts: CreateWishlistStackClientOptions) {\n    const client = createWishlistStackClient(opts);\n    this.lists = client.lists;\n    this.groups = client.groups;\n    this.shared = client.shared;\n  }\n\n  /** Back-compat alias: `client.groups.getAll()` */\n  getGroups() {\n    return this.groups.getAll();\n  }\n\n  /** Back-compat alias: `client.groups.getById(groupId)` */\n  getGroupById(groupId: string) {\n    return this.groups.getById(groupId);\n  }\n\n  /** Back-compat alias: `client.lists.getAll()` */\n  getLists() {\n    return this.lists.getAll();\n  }\n}\n","import { MAX_PAGINATION_SIZE } from \"../constants\";\n\nexport type PaginationParams = {\n  page?: number;\n  pageSize?: number;\n  query?: string;\n};\n\nexport const DEFAULT_PAGE = 1 as const;\nexport const DEFAULT_PAGE_SIZE = MAX_PAGINATION_SIZE;\n\n","import type { Query } from \"../client/query\";\nimport type { PaginationParams } from \"./pagination\";\n\n/**\n * Shared query option building blocks for list/group endpoints.\n *\n * Keep this extendable: as we add filters/sorts, we can add additional helpers/types here\n * and reuse them across endpoints without duplicating logic.\n */\nexport type PaginatedQuery<TExtra extends Query = Query> = PaginationParams & TExtra;\n\n/**\n * Merge a base query with pagination parameters.\n * (Useful when an endpoint also gains filter/sort params over time.)\n */\nexport function withPagination<TExtra extends Query>(\n  query?: TExtra,\n  pagination?: PaginationParams,\n): PaginatedQuery<TExtra> | undefined {\n  if (!query && !pagination) return undefined;\n  return { ...(query ?? {}), ...(pagination ?? {}) } as PaginatedQuery<TExtra>;\n}\n\n"]}
+{"version":3,"sources":["../src/constants.ts","../src/client/query.ts","../src/client/errors.ts","../src/client/request.ts","../src/resources/lists/index.ts","../src/resources/groups/index.ts","../src/resources/shared/index.ts","../src/client/createWishlistStackClient.ts","../src/WishlistStackClient.ts","../src/types/pagination.ts","../src/types/query-options.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["export const MAX_PAGINATION_SIZE = 25 as const;\nexport const BASE_URL = \"https://wishlist.devteam.run\" as const;\n\n","export type QueryValue =\n  | string\n  | number\n  | boolean\n  | null\n  | undefined\n  | Array<string | number | boolean | null | undefined>;\n\nexport type Query = Record<string, QueryValue>;\n\nexport function toQueryString(query?: Query): string {\n  if (!query) return \"\";\n\n  const params = new URLSearchParams();\n  for (const [key, value] of Object.entries(query)) {\n    if (value === undefined || value === null) continue;\n    if (Array.isArray(value)) {\n      for (const v of value) {\n        if (v === undefined || v === null) continue;\n        params.append(key, String(v));\n      }\n      continue;\n    }\n    params.set(key, String(value));\n  }\n\n  const qs = params.toString();\n  return qs ? `?${qs}` : \"\";\n}\n\n","export type WishlistStackApiErrorDetails<TBody = unknown> = {\n  status: number;\n  url: string;\n  method: string;\n  requestId?: string;\n  body?: TBody;\n};\n\ntype ApiErrorItemLike = { message?: unknown; field?: unknown };\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction isApiErrorItemLike(value: unknown): value is ApiErrorItemLike {\n  return isRecord(value) && \"message\" in value;\n}\n\nfunction extractApiErrors(body: unknown): Array<{ message: string; field?: string }> | undefined {\n  if (!isRecord(body)) return undefined;\n  const errors = body.errors;\n  if (!Array.isArray(errors)) return undefined;\n  const out: Array<{ message: string; field?: string }> = [];\n  for (const e of errors) {\n    if (!isApiErrorItemLike(e)) continue;\n    const msg = typeof e.message === \"string\" ? e.message : undefined;\n    if (!msg) continue;\n    const field = typeof (e as any).field === \"string\" ? (e as any).field : undefined;\n    out.push(field ? { message: msg, field } : { message: msg });\n  }\n  return out.length ? out : undefined;\n}\n\nexport class WishlistStackApiError<TBody = unknown> extends Error {\n  readonly name = \"WishlistStackApiError\";\n  readonly status: number;\n  readonly url: string;\n  readonly method: string;\n  readonly requestId?: string;\n  readonly body?: TBody;\n\n  constructor(message: string, details: WishlistStackApiErrorDetails<TBody>) {\n    super(message);\n    this.status = details.status;\n    this.url = details.url;\n    this.method = details.method;\n    this.requestId = details.requestId;\n    this.body = details.body;\n  }\n\n  /**\n   * Best-effort extraction of API error items from the response body.\n   * Useful for UI/logging without needing to know the exact response shape.\n   */\n  get apiErrors(): Array<{ message: string; field?: string }> | undefined {\n    return extractApiErrors(this.body);\n  }\n\n  /**\n   * Convenience: extracted error messages (if present).\n   */\n  get apiErrorMessages(): string[] | undefined {\n    const errs = this.apiErrors;\n    return errs?.map((e) => e.message);\n  }\n}\n\n/**\n * Bundler-safe type guard (prefer this over `instanceof WishlistStackApiError`).\n */\nexport function isWishlistStackApiError(value: unknown): value is WishlistStackApiError<unknown> {\n  if (!isRecord(value)) return false;\n  return (\n    (value as any).name === \"WishlistStackApiError\" &&\n    typeof (value as any).status === \"number\" &&\n    typeof (value as any).url === \"string\" &&\n    typeof (value as any).method === \"string\"\n  );\n}\n\n","import { toQueryString, type Query } from \"./query\";\nimport { WishlistStackApiError } from \"./errors\";\nimport type { ApiErrorResponse } from \"../types/common\";\n\nexport type FetchLike = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;\n\nexport type AuthMode = \"authenticated\" | \"merchant\";\n\nexport type RequestContext = {\n  baseUrl: string;\n  apiKey: string;\n  customerAccessToken?: string;\n  fetch: FetchLike;\n};\n\nexport type RequestArgs<TBody> = {\n  method: \"GET\" | \"POST\" | \"PATCH\" | \"DELETE\";\n  path: string;\n  auth: AuthMode;\n  query?: Query;\n  body?: TBody;\n  headers?: Record<string, string>;\n  signal?: AbortSignal;\n  timeoutMs?: number;\n};\n\nasync function safeParseJson(res: Response): Promise<unknown | undefined> {\n  const contentType = res.headers.get(\"content-type\") ?? \"\";\n  if (!contentType.toLowerCase().includes(\"application/json\")) return undefined;\n  try {\n    return await res.json();\n  } catch {\n    return undefined;\n  }\n}\n\nexport function createRequest(ctx: RequestContext) {\n  return async function request<TResponse = unknown, TBody = unknown>(\n    args: RequestArgs<TBody>,\n  ): Promise<TResponse> {\n    const url = `${ctx.baseUrl}${args.path}${toQueryString(args.query)}`;\n\n    const headers: Record<string, string> = {\n      \"X-Wishlist-Stack-Api-Key\": ctx.apiKey,\n      ...(args.headers ?? {}),\n    };\n\n    if (args.auth === \"authenticated\") {\n      const token = ctx.customerAccessToken;\n      // If token is missing, still perform the request and let the API return the appropriate\n      // error response (which we will surface as a WishlistStackApiError based on the HTTP response).\n      if (token) headers[\"X-Shopify-Customer-Access-Token\"] = token;\n    }\n\n    let body: BodyInit | undefined;\n    if (args.body !== undefined) {\n      // Only JSON bodies are supported for this SDK.\n      headers[\"content-type\"] ??= \"application/json\";\n      body = JSON.stringify(args.body);\n    }\n\n    const controller = args.timeoutMs ? new AbortController() : undefined;\n    const timeout =\n      args.timeoutMs && controller\n        ? setTimeout(() => controller.abort(), args.timeoutMs)\n        : undefined;\n\n    const signal = args.signal\n      ? args.signal\n      : controller\n        ? controller.signal\n        : undefined;\n\n    const res = await ctx.fetch(url, {\n      method: args.method,\n      headers,\n      body,\n      signal,\n    });\n\n    if (timeout) clearTimeout(timeout);\n\n    if (!res.ok) {\n      const errBody = (await safeParseJson(res)) as ApiErrorResponse | unknown;\n      const requestId =\n        res.headers.get(\"fly-request-id\") ??\n        res.headers.get(\"x-request-id\") ??\n        undefined;\n      throw new WishlistStackApiError<ApiErrorResponse | unknown>(`Wishlist Stack API request failed (${res.status})`, {\n        status: res.status,\n        url,\n        method: args.method,\n        requestId,\n        body: errBody,\n      });\n    }\n\n    if (res.status === 204) return undefined as TResponse;\n\n    const parsed = await safeParseJson(res);\n    // If server didn't return JSON, return the raw text as unknown.\n    if (parsed === undefined) {\n      const text = await res.text().catch(() => \"\");\n      return text as unknown as TResponse;\n    }\n\n    return parsed as TResponse;\n  };\n}\n\n","import type { RequestArgs } from \"../../client/request\";\nimport type { PaginatedQuery } from \"../../types/query-options\";\nimport type {\n  AddItemsToListBody,\n  CreateListBody,\n  ReorderListItemsBody,\n  UpdateListBody,\n  UpdateListItemBody,\n} from \"../../types/requests/lists\";\nimport type {\n  AddItemsToListResponse,\n  CreateListResponse,\n  DuplicateListResponse,\n  GetListResponse,\n  GetListsResponse,\n  MarkListSharedResponse,\n  RemoveItemFromListResponse,\n  RemoveListResponse,\n  ReorderListItemsResponse,\n  RevokeListSharedResponse,\n  UpdateListDetailsResponse,\n  UpdateListItemResponse,\n} from \"../../types/responses/lists\";\n\ntype RequestFn = <TResponse = unknown, TBody = unknown>(\n  args: RequestArgs<TBody>,\n) => Promise<TResponse>;\n\nexport type GetListsQuery = PaginatedQuery;\nexport type GetListQuery = Omit<PaginatedQuery, \"query\">;\n\nexport function createListsResource(request: RequestFn) {\n  return {\n    /** Returns all lists for the authenticated customer under the current merchant. */\n    getAll: (query?: GetListsQuery) =>\n      request<GetListsResponse>({\n        method: \"GET\",\n        path: \"/api/lists\",\n        auth: \"authenticated\",\n        query,\n      }),\n\n    /** Fetch list details by id. */\n    getById: (listId: string, query?: GetListQuery) =>\n      request<GetListResponse>({\n        method: \"GET\",\n        path: `/api/lists/${encodeURIComponent(listId)}`,\n        auth: \"authenticated\",\n        query,\n      }),\n\n    /** Create a new list. */\n    create: (body: CreateListBody) =>\n      request<CreateListResponse, CreateListBody>({\n        method: \"POST\",\n        path: \"/api/lists\",\n        auth: \"authenticated\",\n        body,\n      }),\n\n    /** Update list name/description. */\n    update: (listId: string, body: UpdateListBody) =>\n      request<UpdateListDetailsResponse, UpdateListBody>({\n        method: \"PATCH\",\n        path: `/api/lists/${encodeURIComponent(listId)}`,\n        auth: \"authenticated\",\n        body,\n      }),\n\n    /** Remove a list. */\n    remove: (listId: string) =>\n      request<RemoveListResponse>({\n        method: \"DELETE\",\n        path: `/api/lists/${encodeURIComponent(listId)}`,\n        auth: \"authenticated\",\n      }),\n\n    /**\n     * Duplicate a list (including all items) in a single call.\n     * The copy stays in the same group (if any), is named `Copy of {original name}`,\n     * and is not shared.\n     */\n    duplicate: (listId: string) =>\n      request<DuplicateListResponse>({\n        method: \"POST\",\n        path: `/api/lists/${encodeURIComponent(listId)}/duplicate`,\n        auth: \"authenticated\",\n      }),\n\n    /** Add one or more items to a list. */\n    addItems: (listId: string, body: AddItemsToListBody) =>\n      request<AddItemsToListResponse, AddItemsToListBody>({\n        method: \"POST\",\n        path: `/api/lists/${encodeURIComponent(listId)}/add`,\n        auth: \"authenticated\",\n        body,\n      }),\n\n    /** Update an item on a list. */\n    updateItem: (listId: string, itemId: string, body: UpdateListItemBody) =>\n      request<UpdateListItemResponse, UpdateListItemBody>({\n        method: \"PATCH\",\n        path: `/api/lists/${encodeURIComponent(listId)}/items/${encodeURIComponent(itemId)}`,\n        auth: \"authenticated\",\n        body,\n      }),\n\n    /** Remove an item from a list. */\n    removeItem: (listId: string, itemId: string) =>\n      request<RemoveItemFromListResponse>({\n        method: \"DELETE\",\n        path: `/api/lists/${encodeURIComponent(listId)}/items/${encodeURIComponent(itemId)}`,\n        auth: \"authenticated\",\n      }),\n\n    /** Reorder all items in a list. */\n    reorderItems: (listId: string, body: ReorderListItemsBody) =>\n      request<ReorderListItemsResponse, ReorderListItemsBody>({\n        method: \"POST\",\n        path: `/api/lists/${encodeURIComponent(listId)}/reorder`,\n        auth: \"authenticated\",\n        body,\n      }),\n\n    /** Mark list as shared (public read-only). */\n    share: (listId: string) =>\n      request<MarkListSharedResponse>({\n        method: \"POST\",\n        path: `/api/lists/${encodeURIComponent(listId)}/share`,\n        auth: \"authenticated\",\n      }),\n\n    /** Revoke list sharing. */\n    unshare: (listId: string) =>\n      request<RevokeListSharedResponse>({\n        method: \"DELETE\",\n        path: `/api/lists/${encodeURIComponent(listId)}/share`,\n        auth: \"authenticated\",\n      }),\n\n    /**\n     * Legacy endpoint kept in the OpenAPI spec (`/api/wishlists/{id}/add`).\n     * Prefer `addItems(listId, body)` unless your server only supports the legacy route.\n     */\n    addItemsLegacy: (id: string, body: AddItemsToListBody) =>\n      request<AddItemsToListResponse, AddItemsToListBody>({\n        method: \"POST\",\n        path: `/api/wishlists/${encodeURIComponent(id)}/add`,\n        auth: \"authenticated\",\n        body,\n      }),\n  };\n}\n\n","import type { RequestArgs } from \"../../client/request\";\nimport type { CreateGroupBody, ReorderGroupBody, UpdateGroupBody } from \"../../types/requests/groups\";\nimport type { PaginatedQuery } from \"../../types/query-options\";\nimport type {\n  CreateGroupResponse,\n  DuplicateGroupResponse,\n  GetGroupResponse,\n  GetGroupsResponse,\n  MarkGroupSharedResponse,\n  RemoveGroupResponse,\n  ReorderGroupResponse,\n  RevokeGroupSharedResponse,\n  UpdateGroupDetailsResponse,\n} from \"../../types/responses/groups\";\n\ntype RequestFn = <TResponse = unknown, TBody = unknown>(\n  args: RequestArgs<TBody>,\n) => Promise<TResponse>;\n\nexport type GetGroupsQuery = PaginatedQuery<{\n  /**\n   * When truthy (`true`, `1`, or `\"1\"`), each group includes its full `lists`\n   * array with hydrated items. Sent to the API as `includeLists=1`.\n   */\n  includeLists?: boolean | 1 | \"1\";\n}>;\nexport type GetGroupQuery = PaginatedQuery;\n\nfunction normalizeGetGroupsQuery(query?: GetGroupsQuery): GetGroupsQuery | undefined {\n  if (!query) return undefined;\n  const { includeLists, ...rest } = query;\n  if (includeLists) {\n    return { ...rest, includeLists: 1 };\n  }\n  return Object.keys(rest).length > 0 ? rest : undefined;\n}\n\nexport function createGroupsResource(request: RequestFn) {\n  return {\n    /** Fetch groups for the authenticated customer. */\n    getAll: (query?: GetGroupsQuery) =>\n      request<GetGroupsResponse>({\n        method: \"GET\",\n        path: \"/api/groups\",\n        auth: \"authenticated\",\n        query: normalizeGetGroupsQuery(query),\n      }),\n\n    /** Fetch group details by id. */\n    getById: (groupId: string, query?: GetGroupQuery) =>\n      request<GetGroupResponse>({\n        method: \"GET\",\n        path: `/api/groups/${encodeURIComponent(groupId)}`,\n        auth: \"authenticated\",\n        query,\n      }),\n\n    /** Create a new group. */\n    create: (body: CreateGroupBody) =>\n      request<CreateGroupResponse, CreateGroupBody>({\n        method: \"POST\",\n        path: \"/api/groups\",\n        auth: \"authenticated\",\n        body,\n      }),\n\n    /** Update group name/description. */\n    update: (groupId: string, body: UpdateGroupBody) =>\n      request<UpdateGroupDetailsResponse, UpdateGroupBody>({\n        method: \"PATCH\",\n        path: `/api/groups/${encodeURIComponent(groupId)}`,\n        auth: \"authenticated\",\n        body,\n      }),\n\n    /** Remove a group. */\n    remove: (groupId: string) =>\n      request<RemoveGroupResponse>({\n        method: \"DELETE\",\n        path: `/api/groups/${encodeURIComponent(groupId)}`,\n        auth: \"authenticated\",\n      }),\n\n    /**\n     * Duplicate a group (including all lists and items) in a single call.\n     * The copy is named `Copy of {original name}` and is not shared.\n     */\n    duplicate: (groupId: string) =>\n      request<DuplicateGroupResponse>({\n        method: \"POST\",\n        path: `/api/groups/${encodeURIComponent(groupId)}/duplicate`,\n        auth: \"authenticated\",\n      }),\n\n    /** Reorder a group (spec uses listIds payload). */\n    reorder: (groupId: string, body: ReorderGroupBody) =>\n      request<ReorderGroupResponse, ReorderGroupBody>({\n        method: \"POST\",\n        path: `/api/groups/${encodeURIComponent(groupId)}/reorder`,\n        auth: \"authenticated\",\n        body,\n      }),\n\n    /** Mark group as shared (public read-only). */\n    share: (groupId: string) =>\n      request<MarkGroupSharedResponse>({\n        method: \"POST\",\n        path: `/api/groups/${encodeURIComponent(groupId)}/share`,\n        auth: \"authenticated\",\n      }),\n\n    /** Revoke group sharing. */\n    unshare: (groupId: string) =>\n      request<RevokeGroupSharedResponse>({\n        method: \"DELETE\",\n        path: `/api/groups/${encodeURIComponent(groupId)}/share`,\n        auth: \"authenticated\",\n      }),\n  };\n}\n","import type { RequestArgs } from \"../../client/request\";\nimport type { GetSharedGroupResponse, GetSharedListResponse } from \"../../types/responses/shared\";\n\ntype RequestFn = <TResponse = unknown, TBody = unknown>(\n  args: RequestArgs<TBody>,\n) => Promise<TResponse>;\n\nexport function createSharedResource(request: RequestFn) {\n  return {\n    /** Public read-only view of a shared list. Requires only merchant apiKey. */\n    getSharedList: (listId: string) =>\n      request<GetSharedListResponse>({\n        method: \"GET\",\n        path: `/api/shared/list/${encodeURIComponent(listId)}`,\n        auth: \"merchant\",\n      }),\n\n    /** Public read-only view of a shared group. Requires only merchant apiKey. */\n    getSharedGroup: (groupId: string) =>\n      request<GetSharedGroupResponse>({\n        method: \"GET\",\n        path: `/api/shared/group/${encodeURIComponent(groupId)}`,\n        auth: \"merchant\",\n      }),\n  };\n}\n\n","import { BASE_URL } from \"../constants\";\nimport { createRequest, type FetchLike } from \"./request\";\nimport { createListsResource } from \"../resources/lists\";\nimport { createGroupsResource } from \"../resources/groups\";\nimport { createSharedResource } from \"../resources/shared\";\n\nexport type CreateWishlistStackClientOptions = {\n  baseUrl?: string;\n  apiKey: string;\n  customerAccessToken?: string;\n  fetch?: FetchLike;\n};\n\nexport type WishlistStackClient = {\n  lists: ReturnType<typeof createListsResource>;\n  groups: ReturnType<typeof createGroupsResource>;\n  shared: ReturnType<typeof createSharedResource>;\n};\n\nexport function createWishlistStackClient(opts: CreateWishlistStackClientOptions): WishlistStackClient {\n  if (!opts.apiKey) {\n    throw new Error(\n      \"merchant api key is required. Pass it to createWishlistStackClient({ apiKey })\",\n    );\n  }\n\n  // Cloudflare Workers (and some other runtimes) can throw \"Illegal invocation\" if you\n  // capture `globalThis.fetch` and call it later without the correct `this` binding.\n  // So: default to a wrapper that calls `globalThis.fetch(...)` directly.\n  const fetchImpl: FetchLike | undefined =\n    opts.fetch ??\n    (typeof globalThis.fetch === \"function\"\n      ? ((input, init) => globalThis.fetch(input, init)) // keep correct invocation context\n      : undefined);\n\n  if (!fetchImpl) {\n    throw new Error(\n      \"No fetch implementation found. Provide one via createWishlistStackClient({ fetch }) or use Node 18+ / modern browsers.\",\n    );\n  }\n\n  const request = createRequest({\n    baseUrl: opts.baseUrl ?? BASE_URL,\n    apiKey: opts.apiKey,\n    customerAccessToken: opts.customerAccessToken,\n    fetch: fetchImpl,\n  });\n\n  return {\n    lists: createListsResource(request),\n    groups: createGroupsResource(request),\n    shared: createSharedResource(request),\n  };\n}\n","import { createWishlistStackClient, type CreateWishlistStackClientOptions, type WishlistStackClient as IWishlistStackClient } from \"./client/createWishlistStackClient\";\n\n/**\n * Class wrapper around `createWishlistStackClient()` for users who prefer `new`.\n * Exposes `lists`, `groups`, and `shared` resources.\n */\nexport class WishlistStackClient implements IWishlistStackClient {\n  readonly lists: IWishlistStackClient[\"lists\"];\n  readonly groups: IWishlistStackClient[\"groups\"];\n  readonly shared: IWishlistStackClient[\"shared\"];\n\n  constructor(opts: CreateWishlistStackClientOptions) {\n    const client = createWishlistStackClient(opts);\n    this.lists = client.lists;\n    this.groups = client.groups;\n    this.shared = client.shared;\n  }\n\n  /** Back-compat alias: `client.groups.getAll()` */\n  getGroups() {\n    return this.groups.getAll();\n  }\n\n  /** Back-compat alias: `client.groups.getById(groupId)` */\n  getGroupById(groupId: string) {\n    return this.groups.getById(groupId);\n  }\n\n  /** Back-compat alias: `client.lists.getAll()` */\n  getLists() {\n    return this.lists.getAll();\n  }\n}\n","import { MAX_PAGINATION_SIZE } from \"../constants\";\n\nexport type PaginationParams = {\n  page?: number;\n  pageSize?: number;\n  query?: string;\n};\n\nexport const DEFAULT_PAGE = 1 as const;\nexport const DEFAULT_PAGE_SIZE = MAX_PAGINATION_SIZE;\n\n","import type { Query } from \"../client/query\";\nimport type { PaginationParams } from \"./pagination\";\n\n/**\n * Shared query option building blocks for list/group endpoints.\n *\n * Keep this extendable: as we add filters/sorts, we can add additional helpers/types here\n * and reuse them across endpoints without duplicating logic.\n */\nexport type PaginatedQuery<TExtra extends Query = Query> = PaginationParams & TExtra;\n\n/**\n * Merge a base query with pagination parameters.\n * (Useful when an endpoint also gains filter/sort params over time.)\n */\nexport function withPagination<TExtra extends Query>(\n  query?: TExtra,\n  pagination?: PaginationParams,\n): PaginatedQuery<TExtra> | undefined {\n  if (!query && !pagination) return undefined;\n  return { ...(query ?? {}), ...(pagination ?? {}) } as PaginatedQuery<TExtra>;\n}\n\n"]}

package/dist/index.d.cts

@@ -154,8 +154,10 @@ type GetListsResponse = {
 };
 /** GET `/api/lists/:listId` */
 type GetListResponse = ListDetail;
-type CreateListResponse = unknown;
-type UpdateListDetailsResponse = unknown;
+type ListMutationResponse = Omit<ListSummary, "featuredProducts">;
+type CreateListResponse = ListMutationResponse;
+type DuplicateListResponse = ListMutationResponse;
+type UpdateListDetailsResponse = ListMutationResponse;
 type RemoveListResponse = OkResponse;
 type AddItemsToListResponse = unknown;
 type UpdateListItemResponse = unknown;
@@ -166,8 +168,8 @@ type ReorderListItemsResponse = {
         position: number;
     }>;
 };
-type MarkListSharedResponse = unknown;
-type RevokeListSharedResponse = unknown;
+type MarkListSharedResponse = ListMutationResponse;
+type RevokeListSharedResponse = ListMutationResponse;
 
 type RequestFn$2 = <TResponse = unknown, TBody = unknown>(args: RequestArgs<TBody>) => Promise<TResponse>;
 type GetListsQuery = PaginatedQuery;
@@ -178,11 +180,17 @@ declare function createListsResource(request: RequestFn$2): {
     /** Fetch list details by id. */
     getById: (listId: string, query?: GetListQuery) => Promise<ListDetail>;
     /** Create a new list. */
-    create: (body: CreateListBody) => Promise<unknown>;
+    create: (body: CreateListBody) => Promise<ListMutationResponse>;
     /** Update list name/description. */
-    update: (listId: string, body: UpdateListBody) => Promise<unknown>;
+    update: (listId: string, body: UpdateListBody) => Promise<ListMutationResponse>;
     /** Remove a list. */
     remove: (listId: string) => Promise<OkResponse>;
+    /**
+     * Duplicate a list (including all items) in a single call.
+     * The copy stays in the same group (if any), is named `Copy of {original name}`,
+     * and is not shared.
+     */
+    duplicate: (listId: string) => Promise<ListMutationResponse>;
     /** Add one or more items to a list. */
     addItems: (listId: string, body: AddItemsToListBody) => Promise<unknown>;
     /** Update an item on a list. */
@@ -192,9 +200,9 @@ declare function createListsResource(request: RequestFn$2): {
     /** Reorder all items in a list. */
     reorderItems: (listId: string, body: ReorderListItemsBody) => Promise<ReorderListItemsResponse>;
     /** Mark list as shared (public read-only). */
-    share: (listId: string) => Promise<unknown>;
+    share: (listId: string) => Promise<ListMutationResponse>;
     /** Revoke list sharing. */
-    unshare: (listId: string) => Promise<unknown>;
+    unshare: (listId: string) => Promise<ListMutationResponse>;
     /**
      * Legacy endpoint kept in the OpenAPI spec (`/api/wishlists/{id}/add`).
      * Prefer `addItems(listId, body)` unless your server only supports the legacy route.
@@ -214,6 +222,19 @@ type ReorderGroupBody = {
     listIds?: string[];
 };
 
+/**
+ * List embedded on a group when `includeLists=1` is passed to `groups.getAll()`.
+ * Items are fully hydrated (same shape as `lists.getById`).
+ */
+type GroupSummaryList = {
+    id: string;
+    name: string;
+    description: string | null;
+    position: number;
+    shared: boolean;
+    itemCount: number;
+    items: HydratedWishlistItem[];
+};
 type GroupSummary = {
     id: string;
     name: string;
@@ -221,6 +242,8 @@ type GroupSummary = {
     position: number;
     shared: boolean;
     listCount: number;
+    /** Empty unless `includeLists=1` was requested. */
+    lists: GroupSummaryList[];
     featuredItems: FeaturedItem[];
     createdAt: string;
     updatedAt: string;
@@ -252,16 +275,33 @@ type GroupDetail = {
     lists: GroupDetailList[];
     pagination: Pagination;
 };
+type GroupMutationResponse = {
+    id: string;
+    name: string;
+    description: string | null;
+    position: number;
+    shared: boolean;
+    listCount: number;
+    createdAt: string;
+    updatedAt: string;
+};
 type GetGroupResponse = GroupDetail;
-type CreateGroupResponse = unknown;
-type UpdateGroupDetailsResponse = unknown;
+type CreateGroupResponse = GroupMutationResponse;
+type DuplicateGroupResponse = GroupMutationResponse;
+type UpdateGroupDetailsResponse = GroupMutationResponse;
 type RemoveGroupResponse = OkResponse;
 type ReorderGroupResponse = unknown;
-type MarkGroupSharedResponse = unknown;
-type RevokeGroupSharedResponse = unknown;
+type MarkGroupSharedResponse = GroupMutationResponse;
+type RevokeGroupSharedResponse = GroupMutationResponse;
 
 type RequestFn$1 = <TResponse = unknown, TBody = unknown>(args: RequestArgs<TBody>) => Promise<TResponse>;
-type GetGroupsQuery = PaginatedQuery;
+type GetGroupsQuery = PaginatedQuery<{
+    /**
+     * When truthy (`true`, `1`, or `"1"`), each group includes its full `lists`
+     * array with hydrated items. Sent to the API as `includeLists=1`.
+     */
+    includeLists?: boolean | 1 | "1";
+}>;
 type GetGroupQuery = PaginatedQuery;
 declare function createGroupsResource(request: RequestFn$1): {
     /** Fetch groups for the authenticated customer. */
@@ -269,17 +309,22 @@ declare function createGroupsResource(request: RequestFn$1): {
     /** Fetch group details by id. */
     getById: (groupId: string, query?: GetGroupQuery) => Promise<GroupDetail>;
     /** Create a new group. */
-    create: (body: CreateGroupBody) => Promise<unknown>;
+    create: (body: CreateGroupBody) => Promise<GroupMutationResponse>;
     /** Update group name/description. */
-    update: (groupId: string, body: UpdateGroupBody) => Promise<unknown>;
+    update: (groupId: string, body: UpdateGroupBody) => Promise<GroupMutationResponse>;
     /** Remove a group. */
     remove: (groupId: string) => Promise<OkResponse>;
+    /**
+     * Duplicate a group (including all lists and items) in a single call.
+     * The copy is named `Copy of {original name}` and is not shared.
+     */
+    duplicate: (groupId: string) => Promise<GroupMutationResponse>;
     /** Reorder a group (spec uses listIds payload). */
     reorder: (groupId: string, body: ReorderGroupBody) => Promise<unknown>;
     /** Mark group as shared (public read-only). */
-    share: (groupId: string) => Promise<unknown>;
+    share: (groupId: string) => Promise<GroupMutationResponse>;
     /** Revoke group sharing. */
-    unshare: (groupId: string) => Promise<unknown>;
+    unshare: (groupId: string) => Promise<GroupMutationResponse>;
 };
 
 type RequestFn = <TResponse = unknown, TBody = unknown>(args: RequestArgs<TBody>) => Promise<TResponse>;
@@ -365,4 +410,4 @@ declare class WishlistStackApiError<TBody = unknown> extends Error {
  */
 declare function isWishlistStackApiError(value: unknown): value is WishlistStackApiError<unknown>;
 
-export { type AddItemsToListBody, type AddItemsToListResponse, type ApiErrorItem, type ApiErrorResponse, type CreateGroupBody, type CreateGroupResponse, type CreateListBody, type CreateListResponse, type CreateWishlistStackClientOptions, DEFAULT_PAGE, DEFAULT_PAGE_SIZE, type FeaturedItem, type GetGroupResponse, type GetGroupsResponse, type GetListResponse, type GetListsResponse, type GetSharedGroupResponse, type GetSharedListResponse, type GroupDetail, type GroupDetailList, type GroupSummary, type HydratedProduct, type HydratedVariant, type HydratedWishlistItem, type Id, type Image, type ListDetail, type ListSummary, type MarkGroupSharedResponse, type MarkListSharedResponse, type Metafield, type Money, type OkResponse, type PaginatedQuery, type Pagination, type PaginationParams, type RemoveGroupResponse, type RemoveItemFromListResponse, type RemoveListResponse, type ReorderGroupBody, type ReorderGroupResponse, type ReorderListItemsBody, type ReorderListItemsResponse, type RevokeGroupSharedResponse, type RevokeListSharedResponse, type SelectedOption, type UpdateGroupBody, type UpdateGroupDetailsResponse, type UpdateListBody, type UpdateListDetailsResponse, type UpdateListItemBody, type UpdateListItemResponse, WishlistStackApiError, type WishlistStackClient$1 as WishlistStackClient, WishlistStackClient as WishlistStackSDK, createWishlistStackClient, isWishlistStackApiError, withPagination };
+export { type AddItemsToListBody, type AddItemsToListResponse, type ApiErrorItem, type ApiErrorResponse, type CreateGroupBody, type CreateGroupResponse, type CreateListBody, type CreateListResponse, type CreateWishlistStackClientOptions, DEFAULT_PAGE, DEFAULT_PAGE_SIZE, type DuplicateGroupResponse, type DuplicateListResponse, type FeaturedItem, type GetGroupResponse, type GetGroupsResponse, type GetListResponse, type GetListsResponse, type GetSharedGroupResponse, type GetSharedListResponse, type GroupDetail, type GroupDetailList, type GroupMutationResponse, type GroupSummary, type GroupSummaryList, type HydratedProduct, type HydratedVariant, type HydratedWishlistItem, type Id, type Image, type ListDetail, type ListMutationResponse, type ListSummary, type MarkGroupSharedResponse, type MarkListSharedResponse, type Metafield, type Money, type OkResponse, type PaginatedQuery, type Pagination, type PaginationParams, type RemoveGroupResponse, type RemoveItemFromListResponse, type RemoveListResponse, type ReorderGroupBody, type ReorderGroupResponse, type ReorderListItemsBody, type ReorderListItemsResponse, type RevokeGroupSharedResponse, type RevokeListSharedResponse, type SelectedOption, type UpdateGroupBody, type UpdateGroupDetailsResponse, type UpdateListBody, type UpdateListDetailsResponse, type UpdateListItemBody, type UpdateListItemResponse, WishlistStackApiError, type WishlistStackClient$1 as WishlistStackClient, WishlistStackClient as WishlistStackSDK, createWishlistStackClient, isWishlistStackApiError, withPagination };

package/dist/index.d.ts

@@ -154,8 +154,10 @@ type GetListsResponse = {
 };
 /** GET `/api/lists/:listId` */
 type GetListResponse = ListDetail;
-type CreateListResponse = unknown;
-type UpdateListDetailsResponse = unknown;
+type ListMutationResponse = Omit<ListSummary, "featuredProducts">;
+type CreateListResponse = ListMutationResponse;
+type DuplicateListResponse = ListMutationResponse;
+type UpdateListDetailsResponse = ListMutationResponse;
 type RemoveListResponse = OkResponse;
 type AddItemsToListResponse = unknown;
 type UpdateListItemResponse = unknown;
@@ -166,8 +168,8 @@ type ReorderListItemsResponse = {
         position: number;
     }>;
 };
-type MarkListSharedResponse = unknown;
-type RevokeListSharedResponse = unknown;
+type MarkListSharedResponse = ListMutationResponse;
+type RevokeListSharedResponse = ListMutationResponse;
 
 type RequestFn$2 = <TResponse = unknown, TBody = unknown>(args: RequestArgs<TBody>) => Promise<TResponse>;
 type GetListsQuery = PaginatedQuery;
@@ -178,11 +180,17 @@ declare function createListsResource(request: RequestFn$2): {
     /** Fetch list details by id. */
     getById: (listId: string, query?: GetListQuery) => Promise<ListDetail>;
     /** Create a new list. */
-    create: (body: CreateListBody) => Promise<unknown>;
+    create: (body: CreateListBody) => Promise<ListMutationResponse>;
     /** Update list name/description. */
-    update: (listId: string, body: UpdateListBody) => Promise<unknown>;
+    update: (listId: string, body: UpdateListBody) => Promise<ListMutationResponse>;
     /** Remove a list. */
     remove: (listId: string) => Promise<OkResponse>;
+    /**
+     * Duplicate a list (including all items) in a single call.
+     * The copy stays in the same group (if any), is named `Copy of {original name}`,
+     * and is not shared.
+     */
+    duplicate: (listId: string) => Promise<ListMutationResponse>;
     /** Add one or more items to a list. */
     addItems: (listId: string, body: AddItemsToListBody) => Promise<unknown>;
     /** Update an item on a list. */
@@ -192,9 +200,9 @@ declare function createListsResource(request: RequestFn$2): {
     /** Reorder all items in a list. */
     reorderItems: (listId: string, body: ReorderListItemsBody) => Promise<ReorderListItemsResponse>;
     /** Mark list as shared (public read-only). */
-    share: (listId: string) => Promise<unknown>;
+    share: (listId: string) => Promise<ListMutationResponse>;
     /** Revoke list sharing. */
-    unshare: (listId: string) => Promise<unknown>;
+    unshare: (listId: string) => Promise<ListMutationResponse>;
     /**
      * Legacy endpoint kept in the OpenAPI spec (`/api/wishlists/{id}/add`).
      * Prefer `addItems(listId, body)` unless your server only supports the legacy route.
@@ -214,6 +222,19 @@ type ReorderGroupBody = {
     listIds?: string[];
 };
 
+/**
+ * List embedded on a group when `includeLists=1` is passed to `groups.getAll()`.
+ * Items are fully hydrated (same shape as `lists.getById`).
+ */
+type GroupSummaryList = {
+    id: string;
+    name: string;
+    description: string | null;
+    position: number;
+    shared: boolean;
+    itemCount: number;
+    items: HydratedWishlistItem[];
+};
 type GroupSummary = {
     id: string;
     name: string;
@@ -221,6 +242,8 @@ type GroupSummary = {
     position: number;
     shared: boolean;
     listCount: number;
+    /** Empty unless `includeLists=1` was requested. */
+    lists: GroupSummaryList[];
     featuredItems: FeaturedItem[];
     createdAt: string;
     updatedAt: string;
@@ -252,16 +275,33 @@ type GroupDetail = {
     lists: GroupDetailList[];
     pagination: Pagination;
 };
+type GroupMutationResponse = {
+    id: string;
+    name: string;
+    description: string | null;
+    position: number;
+    shared: boolean;
+    listCount: number;
+    createdAt: string;
+    updatedAt: string;
+};
 type GetGroupResponse = GroupDetail;
-type CreateGroupResponse = unknown;
-type UpdateGroupDetailsResponse = unknown;
+type CreateGroupResponse = GroupMutationResponse;
+type DuplicateGroupResponse = GroupMutationResponse;
+type UpdateGroupDetailsResponse = GroupMutationResponse;
 type RemoveGroupResponse = OkResponse;
 type ReorderGroupResponse = unknown;
-type MarkGroupSharedResponse = unknown;
-type RevokeGroupSharedResponse = unknown;
+type MarkGroupSharedResponse = GroupMutationResponse;
+type RevokeGroupSharedResponse = GroupMutationResponse;
 
 type RequestFn$1 = <TResponse = unknown, TBody = unknown>(args: RequestArgs<TBody>) => Promise<TResponse>;
-type GetGroupsQuery = PaginatedQuery;
+type GetGroupsQuery = PaginatedQuery<{
+    /**
+     * When truthy (`true`, `1`, or `"1"`), each group includes its full `lists`
+     * array with hydrated items. Sent to the API as `includeLists=1`.
+     */
+    includeLists?: boolean | 1 | "1";
+}>;
 type GetGroupQuery = PaginatedQuery;
 declare function createGroupsResource(request: RequestFn$1): {
     /** Fetch groups for the authenticated customer. */
@@ -269,17 +309,22 @@ declare function createGroupsResource(request: RequestFn$1): {
     /** Fetch group details by id. */
     getById: (groupId: string, query?: GetGroupQuery) => Promise<GroupDetail>;
     /** Create a new group. */
-    create: (body: CreateGroupBody) => Promise<unknown>;
+    create: (body: CreateGroupBody) => Promise<GroupMutationResponse>;
     /** Update group name/description. */
-    update: (groupId: string, body: UpdateGroupBody) => Promise<unknown>;
+    update: (groupId: string, body: UpdateGroupBody) => Promise<GroupMutationResponse>;
     /** Remove a group. */
     remove: (groupId: string) => Promise<OkResponse>;
+    /**
+     * Duplicate a group (including all lists and items) in a single call.
+     * The copy is named `Copy of {original name}` and is not shared.
+     */
+    duplicate: (groupId: string) => Promise<GroupMutationResponse>;
     /** Reorder a group (spec uses listIds payload). */
     reorder: (groupId: string, body: ReorderGroupBody) => Promise<unknown>;
     /** Mark group as shared (public read-only). */
-    share: (groupId: string) => Promise<unknown>;
+    share: (groupId: string) => Promise<GroupMutationResponse>;
     /** Revoke group sharing. */
-    unshare: (groupId: string) => Promise<unknown>;
+    unshare: (groupId: string) => Promise<GroupMutationResponse>;
 };
 
 type RequestFn = <TResponse = unknown, TBody = unknown>(args: RequestArgs<TBody>) => Promise<TResponse>;
@@ -365,4 +410,4 @@ declare class WishlistStackApiError<TBody = unknown> extends Error {
  */
 declare function isWishlistStackApiError(value: unknown): value is WishlistStackApiError<unknown>;
 
-export { type AddItemsToListBody, type AddItemsToListResponse, type ApiErrorItem, type ApiErrorResponse, type CreateGroupBody, type CreateGroupResponse, type CreateListBody, type CreateListResponse, type CreateWishlistStackClientOptions, DEFAULT_PAGE, DEFAULT_PAGE_SIZE, type FeaturedItem, type GetGroupResponse, type GetGroupsResponse, type GetListResponse, type GetListsResponse, type GetSharedGroupResponse, type GetSharedListResponse, type GroupDetail, type GroupDetailList, type GroupSummary, type HydratedProduct, type HydratedVariant, type HydratedWishlistItem, type Id, type Image, type ListDetail, type ListSummary, type MarkGroupSharedResponse, type MarkListSharedResponse, type Metafield, type Money, type OkResponse, type PaginatedQuery, type Pagination, type PaginationParams, type RemoveGroupResponse, type RemoveItemFromListResponse, type RemoveListResponse, type ReorderGroupBody, type ReorderGroupResponse, type ReorderListItemsBody, type ReorderListItemsResponse, type RevokeGroupSharedResponse, type RevokeListSharedResponse, type SelectedOption, type UpdateGroupBody, type UpdateGroupDetailsResponse, type UpdateListBody, type UpdateListDetailsResponse, type UpdateListItemBody, type UpdateListItemResponse, WishlistStackApiError, type WishlistStackClient$1 as WishlistStackClient, WishlistStackClient as WishlistStackSDK, createWishlistStackClient, isWishlistStackApiError, withPagination };
+export { type AddItemsToListBody, type AddItemsToListResponse, type ApiErrorItem, type ApiErrorResponse, type CreateGroupBody, type CreateGroupResponse, type CreateListBody, type CreateListResponse, type CreateWishlistStackClientOptions, DEFAULT_PAGE, DEFAULT_PAGE_SIZE, type DuplicateGroupResponse, type DuplicateListResponse, type FeaturedItem, type GetGroupResponse, type GetGroupsResponse, type GetListResponse, type GetListsResponse, type GetSharedGroupResponse, type GetSharedListResponse, type GroupDetail, type GroupDetailList, type GroupMutationResponse, type GroupSummary, type GroupSummaryList, type HydratedProduct, type HydratedVariant, type HydratedWishlistItem, type Id, type Image, type ListDetail, type ListMutationResponse, type ListSummary, type MarkGroupSharedResponse, type MarkListSharedResponse, type Metafield, type Money, type OkResponse, type PaginatedQuery, type Pagination, type PaginationParams, type RemoveGroupResponse, type RemoveItemFromListResponse, type RemoveListResponse, type ReorderGroupBody, type ReorderGroupResponse, type ReorderListItemsBody, type ReorderListItemsResponse, type RevokeGroupSharedResponse, type RevokeListSharedResponse, type SelectedOption, type UpdateGroupBody, type UpdateGroupDetailsResponse, type UpdateListBody, type UpdateListDetailsResponse, type UpdateListItemBody, type UpdateListItemResponse, WishlistStackApiError, type WishlistStackClient$1 as WishlistStackClient, WishlistStackClient as WishlistStackSDK, createWishlistStackClient, isWishlistStackApiError, withPagination };

package/dist/index.js

@@ -175,6 +175,16 @@ function createListsResource(request) {
       path: `/api/lists/${encodeURIComponent(listId)}`,
       auth: "authenticated"
     }),
+    /**
+     * Duplicate a list (including all items) in a single call.
+     * The copy stays in the same group (if any), is named `Copy of {original name}`,
+     * and is not shared.
+     */
+    duplicate: (listId) => request({
+      method: "POST",
+      path: `/api/lists/${encodeURIComponent(listId)}/duplicate`,
+      auth: "authenticated"
+    }),
     /** Add one or more items to a list. */
     addItems: (listId, body) => request({
       method: "POST",
@@ -228,6 +238,14 @@ function createListsResource(request) {
 }
 
 // src/resources/groups/index.ts
+function normalizeGetGroupsQuery(query) {
+  if (!query) return void 0;
+  const { includeLists, ...rest } = query;
+  if (includeLists) {
+    return { ...rest, includeLists: 1 };
+  }
+  return Object.keys(rest).length > 0 ? rest : void 0;
+}
 function createGroupsResource(request) {
   return {
     /** Fetch groups for the authenticated customer. */
@@ -235,7 +253,7 @@ function createGroupsResource(request) {
       method: "GET",
       path: "/api/groups",
       auth: "authenticated",
-      query
+      query: normalizeGetGroupsQuery(query)
     }),
     /** Fetch group details by id. */
     getById: (groupId, query) => request({
@@ -264,6 +282,15 @@ function createGroupsResource(request) {
       path: `/api/groups/${encodeURIComponent(groupId)}`,
       auth: "authenticated"
     }),
+    /**
+     * Duplicate a group (including all lists and items) in a single call.
+     * The copy is named `Copy of {original name}` and is not shared.
+     */
+    duplicate: (groupId) => request({
+      method: "POST",
+      path: `/api/groups/${encodeURIComponent(groupId)}/duplicate`,
+      auth: "authenticated"
+    }),
     /** Reorder a group (spec uses listIds payload). */
     reorder: (groupId, body) => request({
       method: "POST",

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/constants.ts","../src/client/query.ts","../src/client/errors.ts","../src/client/request.ts","../src/resources/lists/index.ts","../src/resources/groups/index.ts","../src/resources/shared/index.ts","../src/client/createWishlistStackClient.ts","../src/WishlistStackClient.ts","../src/types/pagination.ts","../src/types/query-options.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["export const MAX_PAGINATION_SIZE = 25 as const;\nexport const BASE_URL = \"https://wishlist.devteam.run\" as const;\n\n","export type QueryValue =\n  | string\n  | number\n  | boolean\n  | null\n  | undefined\n  | Array<string | number | boolean | null | undefined>;\n\nexport type Query = Record<string, QueryValue>;\n\nexport function toQueryString(query?: Query): string {\n  if (!query) return \"\";\n\n  const params = new URLSearchParams();\n  for (const [key, value] of Object.entries(query)) {\n    if (value === undefined || value === null) continue;\n    if (Array.isArray(value)) {\n      for (const v of value) {\n        if (v === undefined || v === null) continue;\n        params.append(key, String(v));\n      }\n      continue;\n    }\n    params.set(key, String(value));\n  }\n\n  const qs = params.toString();\n  return qs ? `?${qs}` : \"\";\n}\n\n","export type WishlistStackApiErrorDetails<TBody = unknown> = {\n  status: number;\n  url: string;\n  method: string;\n  requestId?: string;\n  body?: TBody;\n};\n\ntype ApiErrorItemLike = { message?: unknown; field?: unknown };\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction isApiErrorItemLike(value: unknown): value is ApiErrorItemLike {\n  return isRecord(value) && \"message\" in value;\n}\n\nfunction extractApiErrors(body: unknown): Array<{ message: string; field?: string }> | undefined {\n  if (!isRecord(body)) return undefined;\n  const errors = body.errors;\n  if (!Array.isArray(errors)) return undefined;\n  const out: Array<{ message: string; field?: string }> = [];\n  for (const e of errors) {\n    if (!isApiErrorItemLike(e)) continue;\n    const msg = typeof e.message === \"string\" ? e.message : undefined;\n    if (!msg) continue;\n    const field = typeof (e as any).field === \"string\" ? (e as any).field : undefined;\n    out.push(field ? { message: msg, field } : { message: msg });\n  }\n  return out.length ? out : undefined;\n}\n\nexport class WishlistStackApiError<TBody = unknown> extends Error {\n  readonly name = \"WishlistStackApiError\";\n  readonly status: number;\n  readonly url: string;\n  readonly method: string;\n  readonly requestId?: string;\n  readonly body?: TBody;\n\n  constructor(message: string, details: WishlistStackApiErrorDetails<TBody>) {\n    super(message);\n    this.status = details.status;\n    this.url = details.url;\n    this.method = details.method;\n    this.requestId = details.requestId;\n    this.body = details.body;\n  }\n\n  /**\n   * Best-effort extraction of API error items from the response body.\n   * Useful for UI/logging without needing to know the exact response shape.\n   */\n  get apiErrors(): Array<{ message: string; field?: string }> | undefined {\n    return extractApiErrors(this.body);\n  }\n\n  /**\n   * Convenience: extracted error messages (if present).\n   */\n  get apiErrorMessages(): string[] | undefined {\n    const errs = this.apiErrors;\n    return errs?.map((e) => e.message);\n  }\n}\n\n/**\n * Bundler-safe type guard (prefer this over `instanceof WishlistStackApiError`).\n */\nexport function isWishlistStackApiError(value: unknown): value is WishlistStackApiError<unknown> {\n  if (!isRecord(value)) return false;\n  return (\n    (value as any).name === \"WishlistStackApiError\" &&\n    typeof (value as any).status === \"number\" &&\n    typeof (value as any).url === \"string\" &&\n    typeof (value as any).method === \"string\"\n  );\n}\n\n","import { toQueryString, type Query } from \"./query\";\nimport { WishlistStackApiError } from \"./errors\";\nimport type { ApiErrorResponse } from \"../types/common\";\n\nexport type FetchLike = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;\n\nexport type AuthMode = \"authenticated\" | \"merchant\";\n\nexport type RequestContext = {\n  baseUrl: string;\n  apiKey: string;\n  customerAccessToken?: string;\n  fetch: FetchLike;\n};\n\nexport type RequestArgs<TBody> = {\n  method: \"GET\" | \"POST\" | \"PATCH\" | \"DELETE\";\n  path: string;\n  auth: AuthMode;\n  query?: Query;\n  body?: TBody;\n  headers?: Record<string, string>;\n  signal?: AbortSignal;\n  timeoutMs?: number;\n};\n\nasync function safeParseJson(res: Response): Promise<unknown | undefined> {\n  const contentType = res.headers.get(\"content-type\") ?? \"\";\n  if (!contentType.toLowerCase().includes(\"application/json\")) return undefined;\n  try {\n    return await res.json();\n  } catch {\n    return undefined;\n  }\n}\n\nexport function createRequest(ctx: RequestContext) {\n  return async function request<TResponse = unknown, TBody = unknown>(\n    args: RequestArgs<TBody>,\n  ): Promise<TResponse> {\n    const url = `${ctx.baseUrl}${args.path}${toQueryString(args.query)}`;\n\n    const headers: Record<string, string> = {\n      \"X-Wishlist-Stack-Api-Key\": ctx.apiKey,\n      ...(args.headers ?? {}),\n    };\n\n    if (args.auth === \"authenticated\") {\n      const token = ctx.customerAccessToken;\n      // If token is missing, still perform the request and let the API return the appropriate\n      // error response (which we will surface as a WishlistStackApiError based on the HTTP response).\n      if (token) headers[\"X-Shopify-Customer-Access-Token\"] = token;\n    }\n\n    let body: BodyInit | undefined;\n    if (args.body !== undefined) {\n      // Only JSON bodies are supported for this SDK.\n      headers[\"content-type\"] ??= \"application/json\";\n      body = JSON.stringify(args.body);\n    }\n\n    const controller = args.timeoutMs ? new AbortController() : undefined;\n    const timeout =\n      args.timeoutMs && controller\n        ? setTimeout(() => controller.abort(), args.timeoutMs)\n        : undefined;\n\n    const signal = args.signal\n      ? args.signal\n      : controller\n        ? controller.signal\n        : undefined;\n\n    const res = await ctx.fetch(url, {\n      method: args.method,\n      headers,\n      body,\n      signal,\n    });\n\n    if (timeout) clearTimeout(timeout);\n\n    if (!res.ok) {\n      const errBody = (await safeParseJson(res)) as ApiErrorResponse | unknown;\n      const requestId =\n        res.headers.get(\"fly-request-id\") ??\n        res.headers.get(\"x-request-id\") ??\n        undefined;\n      throw new WishlistStackApiError<ApiErrorResponse | unknown>(`Wishlist Stack API request failed (${res.status})`, {\n        status: res.status,\n        url,\n        method: args.method,\n        requestId,\n        body: errBody,\n      });\n    }\n\n    if (res.status === 204) return undefined as TResponse;\n\n    const parsed = await safeParseJson(res);\n    // If server didn't return JSON, return the raw text as unknown.\n    if (parsed === undefined) {\n      const text = await res.text().catch(() => \"\");\n      return text as unknown as TResponse;\n    }\n\n    return parsed as TResponse;\n  };\n}\n\n","import type { RequestArgs } from \"../../client/request\";\nimport type { PaginatedQuery } from \"../../types/query-options\";\nimport type {\n  AddItemsToListBody,\n  CreateListBody,\n  ReorderListItemsBody,\n  UpdateListBody,\n  UpdateListItemBody,\n} from \"../../types/requests/lists\";\nimport type {\n  AddItemsToListResponse,\n  CreateListResponse,\n  GetListResponse,\n  GetListsResponse,\n  MarkListSharedResponse,\n  RemoveItemFromListResponse,\n  RemoveListResponse,\n  ReorderListItemsResponse,\n  RevokeListSharedResponse,\n  UpdateListDetailsResponse,\n  UpdateListItemResponse,\n} from \"../../types/responses/lists\";\n\ntype RequestFn = <TResponse = unknown, TBody = unknown>(\n  args: RequestArgs<TBody>,\n) => Promise<TResponse>;\n\nexport type GetListsQuery = PaginatedQuery;\nexport type GetListQuery = Omit<PaginatedQuery, \"query\">;\n\nexport function createListsResource(request: RequestFn) {\n  return {\n    /** Returns all lists for the authenticated customer under the current merchant. */\n    getAll: (query?: GetListsQuery) =>\n      request<GetListsResponse>({\n        method: \"GET\",\n        path: \"/api/lists\",\n        auth: \"authenticated\",\n        query,\n      }),\n\n    /** Fetch list details by id. */\n    getById: (listId: string, query?: GetListQuery) =>\n      request<GetListResponse>({\n        method: \"GET\",\n        path: `/api/lists/${encodeURIComponent(listId)}`,\n        auth: \"authenticated\",\n        query,\n      }),\n\n    /** Create a new list. */\n    create: (body: CreateListBody) =>\n      request<CreateListResponse, CreateListBody>({\n        method: \"POST\",\n        path: \"/api/lists\",\n        auth: \"authenticated\",\n        body,\n      }),\n\n    /** Update list name/description. */\n    update: (listId: string, body: UpdateListBody) =>\n      request<UpdateListDetailsResponse, UpdateListBody>({\n        method: \"PATCH\",\n        path: `/api/lists/${encodeURIComponent(listId)}`,\n        auth: \"authenticated\",\n        body,\n      }),\n\n    /** Remove a list. */\n    remove: (listId: string) =>\n      request<RemoveListResponse>({\n        method: \"DELETE\",\n        path: `/api/lists/${encodeURIComponent(listId)}`,\n        auth: \"authenticated\",\n      }),\n\n    /** Add one or more items to a list. */\n    addItems: (listId: string, body: AddItemsToListBody) =>\n      request<AddItemsToListResponse, AddItemsToListBody>({\n        method: \"POST\",\n        path: `/api/lists/${encodeURIComponent(listId)}/add`,\n        auth: \"authenticated\",\n        body,\n      }),\n\n    /** Update an item on a list. */\n    updateItem: (listId: string, itemId: string, body: UpdateListItemBody) =>\n      request<UpdateListItemResponse, UpdateListItemBody>({\n        method: \"PATCH\",\n        path: `/api/lists/${encodeURIComponent(listId)}/items/${encodeURIComponent(itemId)}`,\n        auth: \"authenticated\",\n        body,\n      }),\n\n    /** Remove an item from a list. */\n    removeItem: (listId: string, itemId: string) =>\n      request<RemoveItemFromListResponse>({\n        method: \"DELETE\",\n        path: `/api/lists/${encodeURIComponent(listId)}/items/${encodeURIComponent(itemId)}`,\n        auth: \"authenticated\",\n      }),\n\n    /** Reorder all items in a list. */\n    reorderItems: (listId: string, body: ReorderListItemsBody) =>\n      request<ReorderListItemsResponse, ReorderListItemsBody>({\n        method: \"POST\",\n        path: `/api/lists/${encodeURIComponent(listId)}/reorder`,\n        auth: \"authenticated\",\n        body,\n      }),\n\n    /** Mark list as shared (public read-only). */\n    share: (listId: string) =>\n      request<MarkListSharedResponse>({\n        method: \"POST\",\n        path: `/api/lists/${encodeURIComponent(listId)}/share`,\n        auth: \"authenticated\",\n      }),\n\n    /** Revoke list sharing. */\n    unshare: (listId: string) =>\n      request<RevokeListSharedResponse>({\n        method: \"DELETE\",\n        path: `/api/lists/${encodeURIComponent(listId)}/share`,\n        auth: \"authenticated\",\n      }),\n\n    /**\n     * Legacy endpoint kept in the OpenAPI spec (`/api/wishlists/{id}/add`).\n     * Prefer `addItems(listId, body)` unless your server only supports the legacy route.\n     */\n    addItemsLegacy: (id: string, body: AddItemsToListBody) =>\n      request<AddItemsToListResponse, AddItemsToListBody>({\n        method: \"POST\",\n        path: `/api/wishlists/${encodeURIComponent(id)}/add`,\n        auth: \"authenticated\",\n        body,\n      }),\n  };\n}\n\n","import type { RequestArgs } from \"../../client/request\";\nimport type { CreateGroupBody, ReorderGroupBody, UpdateGroupBody } from \"../../types/requests/groups\";\nimport type { PaginatedQuery } from \"../../types/query-options\";\nimport type {\n  CreateGroupResponse,\n  GetGroupResponse,\n  GetGroupsResponse,\n  MarkGroupSharedResponse,\n  RemoveGroupResponse,\n  ReorderGroupResponse,\n  RevokeGroupSharedResponse,\n  UpdateGroupDetailsResponse,\n} from \"../../types/responses/groups\";\n\ntype RequestFn = <TResponse = unknown, TBody = unknown>(\n  args: RequestArgs<TBody>,\n) => Promise<TResponse>;\n\nexport type GetGroupsQuery = PaginatedQuery;\nexport type GetGroupQuery = PaginatedQuery;\n\nexport function createGroupsResource(request: RequestFn) {\n  return {\n    /** Fetch groups for the authenticated customer. */\n    getAll: (query?: GetGroupsQuery) =>\n      request<GetGroupsResponse>({\n        method: \"GET\",\n        path: \"/api/groups\",\n        auth: \"authenticated\",\n        query,\n      }),\n\n    /** Fetch group details by id. */\n    getById: (groupId: string, query?: GetGroupQuery) =>\n      request<GetGroupResponse>({\n        method: \"GET\",\n        path: `/api/groups/${encodeURIComponent(groupId)}`,\n        auth: \"authenticated\",\n        query,\n      }),\n\n    /** Create a new group. */\n    create: (body: CreateGroupBody) =>\n      request<CreateGroupResponse, CreateGroupBody>({\n        method: \"POST\",\n        path: \"/api/groups\",\n        auth: \"authenticated\",\n        body,\n      }),\n\n    /** Update group name/description. */\n    update: (groupId: string, body: UpdateGroupBody) =>\n      request<UpdateGroupDetailsResponse, UpdateGroupBody>({\n        method: \"PATCH\",\n        path: `/api/groups/${encodeURIComponent(groupId)}`,\n        auth: \"authenticated\",\n        body,\n      }),\n\n    /** Remove a group. */\n    remove: (groupId: string) =>\n      request<RemoveGroupResponse>({\n        method: \"DELETE\",\n        path: `/api/groups/${encodeURIComponent(groupId)}`,\n        auth: \"authenticated\",\n      }),\n\n    /** Reorder a group (spec uses listIds payload). */\n    reorder: (groupId: string, body: ReorderGroupBody) =>\n      request<ReorderGroupResponse, ReorderGroupBody>({\n        method: \"POST\",\n        path: `/api/groups/${encodeURIComponent(groupId)}/reorder`,\n        auth: \"authenticated\",\n        body,\n      }),\n\n    /** Mark group as shared (public read-only). */\n    share: (groupId: string) =>\n      request<MarkGroupSharedResponse>({\n        method: \"POST\",\n        path: `/api/groups/${encodeURIComponent(groupId)}/share`,\n        auth: \"authenticated\",\n      }),\n\n    /** Revoke group sharing. */\n    unshare: (groupId: string) =>\n      request<RevokeGroupSharedResponse>({\n        method: \"DELETE\",\n        path: `/api/groups/${encodeURIComponent(groupId)}/share`,\n        auth: \"authenticated\",\n      }),\n  };\n}\n\n","import type { RequestArgs } from \"../../client/request\";\nimport type { GetSharedGroupResponse, GetSharedListResponse } from \"../../types/responses/shared\";\n\ntype RequestFn = <TResponse = unknown, TBody = unknown>(\n  args: RequestArgs<TBody>,\n) => Promise<TResponse>;\n\nexport function createSharedResource(request: RequestFn) {\n  return {\n    /** Public read-only view of a shared list. Requires only merchant apiKey. */\n    getSharedList: (listId: string) =>\n      request<GetSharedListResponse>({\n        method: \"GET\",\n        path: `/api/shared/list/${encodeURIComponent(listId)}`,\n        auth: \"merchant\",\n      }),\n\n    /** Public read-only view of a shared group. Requires only merchant apiKey. */\n    getSharedGroup: (groupId: string) =>\n      request<GetSharedGroupResponse>({\n        method: \"GET\",\n        path: `/api/shared/group/${encodeURIComponent(groupId)}`,\n        auth: \"merchant\",\n      }),\n  };\n}\n\n","import { BASE_URL } from \"../constants\";\nimport { createRequest, type FetchLike } from \"./request\";\nimport { createListsResource } from \"../resources/lists\";\nimport { createGroupsResource } from \"../resources/groups\";\nimport { createSharedResource } from \"../resources/shared\";\n\nexport type CreateWishlistStackClientOptions = {\n  baseUrl?: string;\n  apiKey: string;\n  customerAccessToken?: string;\n  fetch?: FetchLike;\n};\n\nexport type WishlistStackClient = {\n  lists: ReturnType<typeof createListsResource>;\n  groups: ReturnType<typeof createGroupsResource>;\n  shared: ReturnType<typeof createSharedResource>;\n};\n\nexport function createWishlistStackClient(opts: CreateWishlistStackClientOptions): WishlistStackClient {\n  if (!opts.apiKey) {\n    throw new Error(\n      \"merchant api key is required. Pass it to createWishlistStackClient({ apiKey })\",\n    );\n  }\n\n  // Cloudflare Workers (and some other runtimes) can throw \"Illegal invocation\" if you\n  // capture `globalThis.fetch` and call it later without the correct `this` binding.\n  // So: default to a wrapper that calls `globalThis.fetch(...)` directly.\n  const fetchImpl: FetchLike | undefined =\n    opts.fetch ??\n    (typeof globalThis.fetch === \"function\"\n      ? ((input, init) => globalThis.fetch(input, init)) // keep correct invocation context\n      : undefined);\n\n  if (!fetchImpl) {\n    throw new Error(\n      \"No fetch implementation found. Provide one via createWishlistStackClient({ fetch }) or use Node 18+ / modern browsers.\",\n    );\n  }\n\n  const request = createRequest({\n    baseUrl: opts.baseUrl ?? BASE_URL,\n    apiKey: opts.apiKey,\n    customerAccessToken: opts.customerAccessToken,\n    fetch: fetchImpl,\n  });\n\n  return {\n    lists: createListsResource(request),\n    groups: createGroupsResource(request),\n    shared: createSharedResource(request),\n  };\n}\n","import { createWishlistStackClient, type CreateWishlistStackClientOptions, type WishlistStackClient as IWishlistStackClient } from \"./client/createWishlistStackClient\";\n\n/**\n * Class wrapper around `createWishlistStackClient()` for users who prefer `new`.\n * Exposes `lists`, `groups`, and `shared` resources.\n */\nexport class WishlistStackClient implements IWishlistStackClient {\n  readonly lists: IWishlistStackClient[\"lists\"];\n  readonly groups: IWishlistStackClient[\"groups\"];\n  readonly shared: IWishlistStackClient[\"shared\"];\n\n  constructor(opts: CreateWishlistStackClientOptions) {\n    const client = createWishlistStackClient(opts);\n    this.lists = client.lists;\n    this.groups = client.groups;\n    this.shared = client.shared;\n  }\n\n  /** Back-compat alias: `client.groups.getAll()` */\n  getGroups() {\n    return this.groups.getAll();\n  }\n\n  /** Back-compat alias: `client.groups.getById(groupId)` */\n  getGroupById(groupId: string) {\n    return this.groups.getById(groupId);\n  }\n\n  /** Back-compat alias: `client.lists.getAll()` */\n  getLists() {\n    return this.lists.getAll();\n  }\n}\n","import { MAX_PAGINATION_SIZE } from \"../constants\";\n\nexport type PaginationParams = {\n  page?: number;\n  pageSize?: number;\n  query?: string;\n};\n\nexport const DEFAULT_PAGE = 1 as const;\nexport const DEFAULT_PAGE_SIZE = MAX_PAGINATION_SIZE;\n\n","import type { Query } from \"../client/query\";\nimport type { PaginationParams } from \"./pagination\";\n\n/**\n * Shared query option building blocks for list/group endpoints.\n *\n * Keep this extendable: as we add filters/sorts, we can add additional helpers/types here\n * and reuse them across endpoints without duplicating logic.\n */\nexport type PaginatedQuery<TExtra extends Query = Query> = PaginationParams & TExtra;\n\n/**\n * Merge a base query with pagination parameters.\n * (Useful when an endpoint also gains filter/sort params over time.)\n */\nexport function withPagination<TExtra extends Query>(\n  query?: TExtra,\n  pagination?: PaginationParams,\n): PaginatedQuery<TExtra> | undefined {\n  if (!query && !pagination) return undefined;\n  return { ...(query ?? {}), ...(pagination ?? {}) } as PaginatedQuery<TExtra>;\n}\n\n"]}
+{"version":3,"sources":["../src/constants.ts","../src/client/query.ts","../src/client/errors.ts","../src/client/request.ts","../src/resources/lists/index.ts","../src/resources/groups/index.ts","../src/resources/shared/index.ts","../src/client/createWishlistStackClient.ts","../src/WishlistStackClient.ts","../src/types/pagination.ts","../src/types/query-options.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["export const MAX_PAGINATION_SIZE = 25 as const;\nexport const BASE_URL = \"https://wishlist.devteam.run\" as const;\n\n","export type QueryValue =\n  | string\n  | number\n  | boolean\n  | null\n  | undefined\n  | Array<string | number | boolean | null | undefined>;\n\nexport type Query = Record<string, QueryValue>;\n\nexport function toQueryString(query?: Query): string {\n  if (!query) return \"\";\n\n  const params = new URLSearchParams();\n  for (const [key, value] of Object.entries(query)) {\n    if (value === undefined || value === null) continue;\n    if (Array.isArray(value)) {\n      for (const v of value) {\n        if (v === undefined || v === null) continue;\n        params.append(key, String(v));\n      }\n      continue;\n    }\n    params.set(key, String(value));\n  }\n\n  const qs = params.toString();\n  return qs ? `?${qs}` : \"\";\n}\n\n","export type WishlistStackApiErrorDetails<TBody = unknown> = {\n  status: number;\n  url: string;\n  method: string;\n  requestId?: string;\n  body?: TBody;\n};\n\ntype ApiErrorItemLike = { message?: unknown; field?: unknown };\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction isApiErrorItemLike(value: unknown): value is ApiErrorItemLike {\n  return isRecord(value) && \"message\" in value;\n}\n\nfunction extractApiErrors(body: unknown): Array<{ message: string; field?: string }> | undefined {\n  if (!isRecord(body)) return undefined;\n  const errors = body.errors;\n  if (!Array.isArray(errors)) return undefined;\n  const out: Array<{ message: string; field?: string }> = [];\n  for (const e of errors) {\n    if (!isApiErrorItemLike(e)) continue;\n    const msg = typeof e.message === \"string\" ? e.message : undefined;\n    if (!msg) continue;\n    const field = typeof (e as any).field === \"string\" ? (e as any).field : undefined;\n    out.push(field ? { message: msg, field } : { message: msg });\n  }\n  return out.length ? out : undefined;\n}\n\nexport class WishlistStackApiError<TBody = unknown> extends Error {\n  readonly name = \"WishlistStackApiError\";\n  readonly status: number;\n  readonly url: string;\n  readonly method: string;\n  readonly requestId?: string;\n  readonly body?: TBody;\n\n  constructor(message: string, details: WishlistStackApiErrorDetails<TBody>) {\n    super(message);\n    this.status = details.status;\n    this.url = details.url;\n    this.method = details.method;\n    this.requestId = details.requestId;\n    this.body = details.body;\n  }\n\n  /**\n   * Best-effort extraction of API error items from the response body.\n   * Useful for UI/logging without needing to know the exact response shape.\n   */\n  get apiErrors(): Array<{ message: string; field?: string }> | undefined {\n    return extractApiErrors(this.body);\n  }\n\n  /**\n   * Convenience: extracted error messages (if present).\n   */\n  get apiErrorMessages(): string[] | undefined {\n    const errs = this.apiErrors;\n    return errs?.map((e) => e.message);\n  }\n}\n\n/**\n * Bundler-safe type guard (prefer this over `instanceof WishlistStackApiError`).\n */\nexport function isWishlistStackApiError(value: unknown): value is WishlistStackApiError<unknown> {\n  if (!isRecord(value)) return false;\n  return (\n    (value as any).name === \"WishlistStackApiError\" &&\n    typeof (value as any).status === \"number\" &&\n    typeof (value as any).url === \"string\" &&\n    typeof (value as any).method === \"string\"\n  );\n}\n\n","import { toQueryString, type Query } from \"./query\";\nimport { WishlistStackApiError } from \"./errors\";\nimport type { ApiErrorResponse } from \"../types/common\";\n\nexport type FetchLike = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;\n\nexport type AuthMode = \"authenticated\" | \"merchant\";\n\nexport type RequestContext = {\n  baseUrl: string;\n  apiKey: string;\n  customerAccessToken?: string;\n  fetch: FetchLike;\n};\n\nexport type RequestArgs<TBody> = {\n  method: \"GET\" | \"POST\" | \"PATCH\" | \"DELETE\";\n  path: string;\n  auth: AuthMode;\n  query?: Query;\n  body?: TBody;\n  headers?: Record<string, string>;\n  signal?: AbortSignal;\n  timeoutMs?: number;\n};\n\nasync function safeParseJson(res: Response): Promise<unknown | undefined> {\n  const contentType = res.headers.get(\"content-type\") ?? \"\";\n  if (!contentType.toLowerCase().includes(\"application/json\")) return undefined;\n  try {\n    return await res.json();\n  } catch {\n    return undefined;\n  }\n}\n\nexport function createRequest(ctx: RequestContext) {\n  return async function request<TResponse = unknown, TBody = unknown>(\n    args: RequestArgs<TBody>,\n  ): Promise<TResponse> {\n    const url = `${ctx.baseUrl}${args.path}${toQueryString(args.query)}`;\n\n    const headers: Record<string, string> = {\n      \"X-Wishlist-Stack-Api-Key\": ctx.apiKey,\n      ...(args.headers ?? {}),\n    };\n\n    if (args.auth === \"authenticated\") {\n      const token = ctx.customerAccessToken;\n      // If token is missing, still perform the request and let the API return the appropriate\n      // error response (which we will surface as a WishlistStackApiError based on the HTTP response).\n      if (token) headers[\"X-Shopify-Customer-Access-Token\"] = token;\n    }\n\n    let body: BodyInit | undefined;\n    if (args.body !== undefined) {\n      // Only JSON bodies are supported for this SDK.\n      headers[\"content-type\"] ??= \"application/json\";\n      body = JSON.stringify(args.body);\n    }\n\n    const controller = args.timeoutMs ? new AbortController() : undefined;\n    const timeout =\n      args.timeoutMs && controller\n        ? setTimeout(() => controller.abort(), args.timeoutMs)\n        : undefined;\n\n    const signal = args.signal\n      ? args.signal\n      : controller\n        ? controller.signal\n        : undefined;\n\n    const res = await ctx.fetch(url, {\n      method: args.method,\n      headers,\n      body,\n      signal,\n    });\n\n    if (timeout) clearTimeout(timeout);\n\n    if (!res.ok) {\n      const errBody = (await safeParseJson(res)) as ApiErrorResponse | unknown;\n      const requestId =\n        res.headers.get(\"fly-request-id\") ??\n        res.headers.get(\"x-request-id\") ??\n        undefined;\n      throw new WishlistStackApiError<ApiErrorResponse | unknown>(`Wishlist Stack API request failed (${res.status})`, {\n        status: res.status,\n        url,\n        method: args.method,\n        requestId,\n        body: errBody,\n      });\n    }\n\n    if (res.status === 204) return undefined as TResponse;\n\n    const parsed = await safeParseJson(res);\n    // If server didn't return JSON, return the raw text as unknown.\n    if (parsed === undefined) {\n      const text = await res.text().catch(() => \"\");\n      return text as unknown as TResponse;\n    }\n\n    return parsed as TResponse;\n  };\n}\n\n","import type { RequestArgs } from \"../../client/request\";\nimport type { PaginatedQuery } from \"../../types/query-options\";\nimport type {\n  AddItemsToListBody,\n  CreateListBody,\n  ReorderListItemsBody,\n  UpdateListBody,\n  UpdateListItemBody,\n} from \"../../types/requests/lists\";\nimport type {\n  AddItemsToListResponse,\n  CreateListResponse,\n  DuplicateListResponse,\n  GetListResponse,\n  GetListsResponse,\n  MarkListSharedResponse,\n  RemoveItemFromListResponse,\n  RemoveListResponse,\n  ReorderListItemsResponse,\n  RevokeListSharedResponse,\n  UpdateListDetailsResponse,\n  UpdateListItemResponse,\n} from \"../../types/responses/lists\";\n\ntype RequestFn = <TResponse = unknown, TBody = unknown>(\n  args: RequestArgs<TBody>,\n) => Promise<TResponse>;\n\nexport type GetListsQuery = PaginatedQuery;\nexport type GetListQuery = Omit<PaginatedQuery, \"query\">;\n\nexport function createListsResource(request: RequestFn) {\n  return {\n    /** Returns all lists for the authenticated customer under the current merchant. */\n    getAll: (query?: GetListsQuery) =>\n      request<GetListsResponse>({\n        method: \"GET\",\n        path: \"/api/lists\",\n        auth: \"authenticated\",\n        query,\n      }),\n\n    /** Fetch list details by id. */\n    getById: (listId: string, query?: GetListQuery) =>\n      request<GetListResponse>({\n        method: \"GET\",\n        path: `/api/lists/${encodeURIComponent(listId)}`,\n        auth: \"authenticated\",\n        query,\n      }),\n\n    /** Create a new list. */\n    create: (body: CreateListBody) =>\n      request<CreateListResponse, CreateListBody>({\n        method: \"POST\",\n        path: \"/api/lists\",\n        auth: \"authenticated\",\n        body,\n      }),\n\n    /** Update list name/description. */\n    update: (listId: string, body: UpdateListBody) =>\n      request<UpdateListDetailsResponse, UpdateListBody>({\n        method: \"PATCH\",\n        path: `/api/lists/${encodeURIComponent(listId)}`,\n        auth: \"authenticated\",\n        body,\n      }),\n\n    /** Remove a list. */\n    remove: (listId: string) =>\n      request<RemoveListResponse>({\n        method: \"DELETE\",\n        path: `/api/lists/${encodeURIComponent(listId)}`,\n        auth: \"authenticated\",\n      }),\n\n    /**\n     * Duplicate a list (including all items) in a single call.\n     * The copy stays in the same group (if any), is named `Copy of {original name}`,\n     * and is not shared.\n     */\n    duplicate: (listId: string) =>\n      request<DuplicateListResponse>({\n        method: \"POST\",\n        path: `/api/lists/${encodeURIComponent(listId)}/duplicate`,\n        auth: \"authenticated\",\n      }),\n\n    /** Add one or more items to a list. */\n    addItems: (listId: string, body: AddItemsToListBody) =>\n      request<AddItemsToListResponse, AddItemsToListBody>({\n        method: \"POST\",\n        path: `/api/lists/${encodeURIComponent(listId)}/add`,\n        auth: \"authenticated\",\n        body,\n      }),\n\n    /** Update an item on a list. */\n    updateItem: (listId: string, itemId: string, body: UpdateListItemBody) =>\n      request<UpdateListItemResponse, UpdateListItemBody>({\n        method: \"PATCH\",\n        path: `/api/lists/${encodeURIComponent(listId)}/items/${encodeURIComponent(itemId)}`,\n        auth: \"authenticated\",\n        body,\n      }),\n\n    /** Remove an item from a list. */\n    removeItem: (listId: string, itemId: string) =>\n      request<RemoveItemFromListResponse>({\n        method: \"DELETE\",\n        path: `/api/lists/${encodeURIComponent(listId)}/items/${encodeURIComponent(itemId)}`,\n        auth: \"authenticated\",\n      }),\n\n    /** Reorder all items in a list. */\n    reorderItems: (listId: string, body: ReorderListItemsBody) =>\n      request<ReorderListItemsResponse, ReorderListItemsBody>({\n        method: \"POST\",\n        path: `/api/lists/${encodeURIComponent(listId)}/reorder`,\n        auth: \"authenticated\",\n        body,\n      }),\n\n    /** Mark list as shared (public read-only). */\n    share: (listId: string) =>\n      request<MarkListSharedResponse>({\n        method: \"POST\",\n        path: `/api/lists/${encodeURIComponent(listId)}/share`,\n        auth: \"authenticated\",\n      }),\n\n    /** Revoke list sharing. */\n    unshare: (listId: string) =>\n      request<RevokeListSharedResponse>({\n        method: \"DELETE\",\n        path: `/api/lists/${encodeURIComponent(listId)}/share`,\n        auth: \"authenticated\",\n      }),\n\n    /**\n     * Legacy endpoint kept in the OpenAPI spec (`/api/wishlists/{id}/add`).\n     * Prefer `addItems(listId, body)` unless your server only supports the legacy route.\n     */\n    addItemsLegacy: (id: string, body: AddItemsToListBody) =>\n      request<AddItemsToListResponse, AddItemsToListBody>({\n        method: \"POST\",\n        path: `/api/wishlists/${encodeURIComponent(id)}/add`,\n        auth: \"authenticated\",\n        body,\n      }),\n  };\n}\n\n","import type { RequestArgs } from \"../../client/request\";\nimport type { CreateGroupBody, ReorderGroupBody, UpdateGroupBody } from \"../../types/requests/groups\";\nimport type { PaginatedQuery } from \"../../types/query-options\";\nimport type {\n  CreateGroupResponse,\n  DuplicateGroupResponse,\n  GetGroupResponse,\n  GetGroupsResponse,\n  MarkGroupSharedResponse,\n  RemoveGroupResponse,\n  ReorderGroupResponse,\n  RevokeGroupSharedResponse,\n  UpdateGroupDetailsResponse,\n} from \"../../types/responses/groups\";\n\ntype RequestFn = <TResponse = unknown, TBody = unknown>(\n  args: RequestArgs<TBody>,\n) => Promise<TResponse>;\n\nexport type GetGroupsQuery = PaginatedQuery<{\n  /**\n   * When truthy (`true`, `1`, or `\"1\"`), each group includes its full `lists`\n   * array with hydrated items. Sent to the API as `includeLists=1`.\n   */\n  includeLists?: boolean | 1 | \"1\";\n}>;\nexport type GetGroupQuery = PaginatedQuery;\n\nfunction normalizeGetGroupsQuery(query?: GetGroupsQuery): GetGroupsQuery | undefined {\n  if (!query) return undefined;\n  const { includeLists, ...rest } = query;\n  if (includeLists) {\n    return { ...rest, includeLists: 1 };\n  }\n  return Object.keys(rest).length > 0 ? rest : undefined;\n}\n\nexport function createGroupsResource(request: RequestFn) {\n  return {\n    /** Fetch groups for the authenticated customer. */\n    getAll: (query?: GetGroupsQuery) =>\n      request<GetGroupsResponse>({\n        method: \"GET\",\n        path: \"/api/groups\",\n        auth: \"authenticated\",\n        query: normalizeGetGroupsQuery(query),\n      }),\n\n    /** Fetch group details by id. */\n    getById: (groupId: string, query?: GetGroupQuery) =>\n      request<GetGroupResponse>({\n        method: \"GET\",\n        path: `/api/groups/${encodeURIComponent(groupId)}`,\n        auth: \"authenticated\",\n        query,\n      }),\n\n    /** Create a new group. */\n    create: (body: CreateGroupBody) =>\n      request<CreateGroupResponse, CreateGroupBody>({\n        method: \"POST\",\n        path: \"/api/groups\",\n        auth: \"authenticated\",\n        body,\n      }),\n\n    /** Update group name/description. */\n    update: (groupId: string, body: UpdateGroupBody) =>\n      request<UpdateGroupDetailsResponse, UpdateGroupBody>({\n        method: \"PATCH\",\n        path: `/api/groups/${encodeURIComponent(groupId)}`,\n        auth: \"authenticated\",\n        body,\n      }),\n\n    /** Remove a group. */\n    remove: (groupId: string) =>\n      request<RemoveGroupResponse>({\n        method: \"DELETE\",\n        path: `/api/groups/${encodeURIComponent(groupId)}`,\n        auth: \"authenticated\",\n      }),\n\n    /**\n     * Duplicate a group (including all lists and items) in a single call.\n     * The copy is named `Copy of {original name}` and is not shared.\n     */\n    duplicate: (groupId: string) =>\n      request<DuplicateGroupResponse>({\n        method: \"POST\",\n        path: `/api/groups/${encodeURIComponent(groupId)}/duplicate`,\n        auth: \"authenticated\",\n      }),\n\n    /** Reorder a group (spec uses listIds payload). */\n    reorder: (groupId: string, body: ReorderGroupBody) =>\n      request<ReorderGroupResponse, ReorderGroupBody>({\n        method: \"POST\",\n        path: `/api/groups/${encodeURIComponent(groupId)}/reorder`,\n        auth: \"authenticated\",\n        body,\n      }),\n\n    /** Mark group as shared (public read-only). */\n    share: (groupId: string) =>\n      request<MarkGroupSharedResponse>({\n        method: \"POST\",\n        path: `/api/groups/${encodeURIComponent(groupId)}/share`,\n        auth: \"authenticated\",\n      }),\n\n    /** Revoke group sharing. */\n    unshare: (groupId: string) =>\n      request<RevokeGroupSharedResponse>({\n        method: \"DELETE\",\n        path: `/api/groups/${encodeURIComponent(groupId)}/share`,\n        auth: \"authenticated\",\n      }),\n  };\n}\n","import type { RequestArgs } from \"../../client/request\";\nimport type { GetSharedGroupResponse, GetSharedListResponse } from \"../../types/responses/shared\";\n\ntype RequestFn = <TResponse = unknown, TBody = unknown>(\n  args: RequestArgs<TBody>,\n) => Promise<TResponse>;\n\nexport function createSharedResource(request: RequestFn) {\n  return {\n    /** Public read-only view of a shared list. Requires only merchant apiKey. */\n    getSharedList: (listId: string) =>\n      request<GetSharedListResponse>({\n        method: \"GET\",\n        path: `/api/shared/list/${encodeURIComponent(listId)}`,\n        auth: \"merchant\",\n      }),\n\n    /** Public read-only view of a shared group. Requires only merchant apiKey. */\n    getSharedGroup: (groupId: string) =>\n      request<GetSharedGroupResponse>({\n        method: \"GET\",\n        path: `/api/shared/group/${encodeURIComponent(groupId)}`,\n        auth: \"merchant\",\n      }),\n  };\n}\n\n","import { BASE_URL } from \"../constants\";\nimport { createRequest, type FetchLike } from \"./request\";\nimport { createListsResource } from \"../resources/lists\";\nimport { createGroupsResource } from \"../resources/groups\";\nimport { createSharedResource } from \"../resources/shared\";\n\nexport type CreateWishlistStackClientOptions = {\n  baseUrl?: string;\n  apiKey: string;\n  customerAccessToken?: string;\n  fetch?: FetchLike;\n};\n\nexport type WishlistStackClient = {\n  lists: ReturnType<typeof createListsResource>;\n  groups: ReturnType<typeof createGroupsResource>;\n  shared: ReturnType<typeof createSharedResource>;\n};\n\nexport function createWishlistStackClient(opts: CreateWishlistStackClientOptions): WishlistStackClient {\n  if (!opts.apiKey) {\n    throw new Error(\n      \"merchant api key is required. Pass it to createWishlistStackClient({ apiKey })\",\n    );\n  }\n\n  // Cloudflare Workers (and some other runtimes) can throw \"Illegal invocation\" if you\n  // capture `globalThis.fetch` and call it later without the correct `this` binding.\n  // So: default to a wrapper that calls `globalThis.fetch(...)` directly.\n  const fetchImpl: FetchLike | undefined =\n    opts.fetch ??\n    (typeof globalThis.fetch === \"function\"\n      ? ((input, init) => globalThis.fetch(input, init)) // keep correct invocation context\n      : undefined);\n\n  if (!fetchImpl) {\n    throw new Error(\n      \"No fetch implementation found. Provide one via createWishlistStackClient({ fetch }) or use Node 18+ / modern browsers.\",\n    );\n  }\n\n  const request = createRequest({\n    baseUrl: opts.baseUrl ?? BASE_URL,\n    apiKey: opts.apiKey,\n    customerAccessToken: opts.customerAccessToken,\n    fetch: fetchImpl,\n  });\n\n  return {\n    lists: createListsResource(request),\n    groups: createGroupsResource(request),\n    shared: createSharedResource(request),\n  };\n}\n","import { createWishlistStackClient, type CreateWishlistStackClientOptions, type WishlistStackClient as IWishlistStackClient } from \"./client/createWishlistStackClient\";\n\n/**\n * Class wrapper around `createWishlistStackClient()` for users who prefer `new`.\n * Exposes `lists`, `groups`, and `shared` resources.\n */\nexport class WishlistStackClient implements IWishlistStackClient {\n  readonly lists: IWishlistStackClient[\"lists\"];\n  readonly groups: IWishlistStackClient[\"groups\"];\n  readonly shared: IWishlistStackClient[\"shared\"];\n\n  constructor(opts: CreateWishlistStackClientOptions) {\n    const client = createWishlistStackClient(opts);\n    this.lists = client.lists;\n    this.groups = client.groups;\n    this.shared = client.shared;\n  }\n\n  /** Back-compat alias: `client.groups.getAll()` */\n  getGroups() {\n    return this.groups.getAll();\n  }\n\n  /** Back-compat alias: `client.groups.getById(groupId)` */\n  getGroupById(groupId: string) {\n    return this.groups.getById(groupId);\n  }\n\n  /** Back-compat alias: `client.lists.getAll()` */\n  getLists() {\n    return this.lists.getAll();\n  }\n}\n","import { MAX_PAGINATION_SIZE } from \"../constants\";\n\nexport type PaginationParams = {\n  page?: number;\n  pageSize?: number;\n  query?: string;\n};\n\nexport const DEFAULT_PAGE = 1 as const;\nexport const DEFAULT_PAGE_SIZE = MAX_PAGINATION_SIZE;\n\n","import type { Query } from \"../client/query\";\nimport type { PaginationParams } from \"./pagination\";\n\n/**\n * Shared query option building blocks for list/group endpoints.\n *\n * Keep this extendable: as we add filters/sorts, we can add additional helpers/types here\n * and reuse them across endpoints without duplicating logic.\n */\nexport type PaginatedQuery<TExtra extends Query = Query> = PaginationParams & TExtra;\n\n/**\n * Merge a base query with pagination parameters.\n * (Useful when an endpoint also gains filter/sort params over time.)\n */\nexport function withPagination<TExtra extends Query>(\n  query?: TExtra,\n  pagination?: PaginationParams,\n): PaginatedQuery<TExtra> | undefined {\n  if (!query && !pagination) return undefined;\n  return { ...(query ?? {}), ...(pagination ?? {}) } as PaginatedQuery<TExtra>;\n}\n\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sdg.la/wishlist-stack-sdk",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "TypeScript SDK for the Wishlist Stack API",
   "repository": {
     "type": "git",
@@ -19,7 +19,8 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "AUTH_EXAMPLE.md"
   ],
   "sideEffects": false,
   "scripts": {