@01.software/sdk 0.67.0 → 0.69.0

package/dist/index.js

@@ -1,6 +1,3 @@
-// src/core/collection/http-client.ts
-import { stringify } from "qs-esm";
-
 // src/core/errors.ts
 var SDK_ERROR_BRAND = /* @__PURE__ */ Symbol.for("@01.software/sdk/SDKError");
 var SDK_ERROR_TYPE_BRAND = /* @__PURE__ */ Symbol.for("@01.software/sdk/SDKError.type");
@@ -114,6 +111,7 @@ var COMMERCE_ERROR_CODES = [
   "admission_metadata_invalid",
   "admission_metadata_required",
   "capacity_exceeded",
+  "admission_required",
   "occurrence_lock_unavailable",
   "occurrence_not_open",
   "admission_type_capacity_exceeded",
@@ -132,6 +130,8 @@ var COMMERCE_ERROR_CODES = [
   "variant_inactive",
   "variant_product_mismatch",
   "product_not_public",
+  "product_not_eligible",
+  "purchase_limit_exceeded",
   "market_not_found",
   "market_shipping_currency_unsupported",
   "missing_market_rate",
@@ -1004,288 +1004,6 @@ function stockSnapshotSearchParams(params) {
   return `variantIds=${params.variantIds.map(encodeURIComponent).join(",")}`;
 }
 
-// src/core/collection/http-client.ts
-function validateWhere(where) {
-  if (where === void 0) return false;
-  let hasNull = false;
-  function visit(value, depth, key) {
-    if (depth > 10) {
-      throw createValidationError(
-        "Collection where must not exceed nesting depth 10."
-      );
-    }
-    if (value === null && (key === "equals" || key === "not_equals")) {
-      hasNull = true;
-      return;
-    }
-    if (value == null) {
-      throw createValidationError(
-        "Collection where must not contain null or undefined values."
-      );
-    }
-    if (Array.isArray(value)) {
-      if (value.length === 0) {
-        throw createValidationError(
-          "Collection where must not contain empty arrays, including and/or."
-        );
-      }
-      if (value.length > 1e3) {
-        throw createValidationError(
-          "Collection where arrays must not contain more than 1000 elements."
-        );
-      }
-      for (const item of value) visit(item, depth + 1);
-    } else if (typeof value === "object" && !(value instanceof Date)) {
-      const values = Object.entries(value);
-      if (values.length === 0) {
-        throw createValidationError(
-          "Collection where must not contain empty condition objects."
-        );
-      }
-      for (const [key2, item] of values) visit(item, depth + 1, key2);
-    }
-  }
-  visit(where, 0);
-  return hasNull;
-}
-var HttpClient = class {
-  constructor(publishableKey, secretKey, getCustomerToken, onUnauthorized, onRequestId, apiUrl) {
-    this.publishableKey = requirePublishableKeyForSecret(
-      "CollectionClient",
-      publishableKey,
-      secretKey
-    );
-    this.secretKey = secretKey;
-    this.getCustomerToken = getCustomerToken;
-    this.onUnauthorized = onUnauthorized;
-    this.onRequestId = onRequestId;
-    this.apiUrl = apiUrl;
-  }
-  get defaultOptions() {
-    const opts = {
-      apiUrl: this.apiUrl,
-      publishableKey: this.publishableKey,
-      secretKey: this.secretKey
-    };
-    const token = this.getCustomerToken?.();
-    if (token) {
-      opts.customerToken = token;
-      if (this.onUnauthorized) {
-        opts.onUnauthorized = this.onUnauthorized;
-      }
-    }
-    return opts;
-  }
-  async fetchWithTracking(url, opts) {
-    try {
-      const response = await httpFetch(url, opts);
-      this.onRequestId?.(response.headers.get("x-request-id") ?? null);
-      return response;
-    } catch (err) {
-      const id = err instanceof SDKError ? err.requestId ?? null : null;
-      this.onRequestId?.(id);
-      throw err;
-    }
-  }
-  buildUrl(endpoint, options) {
-    if (!options) return endpoint;
-    const { fallbackLocale, ...rest } = options;
-    const queryOptions = fallbackLocale === void 0 ? rest : {
-      ...rest,
-      "fallback-locale": fallbackLocale === false ? "none" : fallbackLocale
-    };
-    const encodedOptions = validateWhere(queryOptions.where) ? { ...queryOptions, where: JSON.stringify(queryOptions.where) } : queryOptions;
-    const queryString = stringify(encodedOptions, { addQueryPrefix: true });
-    return queryString ? `${endpoint}${queryString}` : endpoint;
-  }
-  assertJsonResponse(response) {
-    const contentType = response.headers.get("content-type");
-    if (!contentType?.includes("application/json")) {
-      throw createApiError("Response is not in JSON format.", response.status, {
-        contentType
-      });
-    }
-  }
-  /**
-   * Parse Payload CMS find response (list query)
-   * Returns native Payload response structure
-   */
-  async parseFindResponse(response) {
-    const contentType = response.headers.get("content-type");
-    try {
-      this.assertJsonResponse(response);
-      const jsonData = await response.json();
-      if (jsonData.docs === void 0) {
-        throw createApiError("Invalid find response.", response.status, {
-          jsonData
-        });
-      }
-      return {
-        docs: jsonData.docs,
-        totalDocs: jsonData.totalDocs ?? 0,
-        limit: jsonData.limit || 20,
-        totalPages: jsonData.totalPages ?? 0,
-        page: jsonData.page || 1,
-        pagingCounter: jsonData.pagingCounter || 1,
-        hasPrevPage: jsonData.hasPrevPage ?? false,
-        hasNextPage: jsonData.hasNextPage ?? false,
-        prevPage: jsonData.prevPage ?? null,
-        nextPage: jsonData.nextPage ?? null
-      };
-    } catch (error) {
-      if (error instanceof SDKError) throw error;
-      throw createApiError("Failed to parse response.", response.status, {
-        contentType,
-        error: error instanceof Error ? error.message : error
-      });
-    }
-  }
-  /**
-   * Parse Payload CMS mutation response (create/update)
-   * Returns native Payload response structure
-   */
-  async parseMutationResponse(response) {
-    const contentType = response.headers.get("content-type");
-    try {
-      this.assertJsonResponse(response);
-      const jsonData = await response.json();
-      if (jsonData.doc === void 0) {
-        throw createApiError("Invalid mutation response.", response.status, {
-          jsonData
-        });
-      }
-      return {
-        message: jsonData.message || "",
-        doc: jsonData.doc,
-        errors: jsonData.errors
-      };
-    } catch (error) {
-      if (error instanceof SDKError) throw error;
-      throw createApiError("Failed to parse response.", response.status, {
-        contentType,
-        error: error instanceof Error ? error.message : error
-      });
-    }
-  }
-  /**
-   * Parse Payload CMS document response (findById/delete)
-   * Returns document directly without wrapper
-   */
-  async parseDocumentResponse(response) {
-    const contentType = response.headers.get("content-type");
-    try {
-      this.assertJsonResponse(response);
-      const jsonData = await response.json();
-      return jsonData;
-    } catch (error) {
-      if (error instanceof SDKError) throw error;
-      throw createApiError("Failed to parse response.", response.status, {
-        contentType,
-        error: error instanceof Error ? error.message : error
-      });
-    }
-  }
-};
-
-// src/utils/types.ts
-function resolveRelation(ref) {
-  if (typeof ref === "string" || typeof ref === "number" || ref === null || ref === void 0)
-    return null;
-  return ref;
-}
-
-// src/core/collection/query-builder.ts
-var PUBLIC_READ_DEPTH_ERROR = "Publishable collection reads require depth: 0. Use a shaped commerce endpoint or server client for populated data.";
-var PUBLIC_READ_JOINS_ERROR = "Publishable collection reads require joins: false. Use a shaped commerce endpoint or server client for joined data.";
-var PUBLIC_READ_POPULATE_ERROR = "Publishable collection reads do not support populate. Use a shaped commerce endpoint or server client for populated data.";
-function withDefaultPublicReadOptions(options) {
-  const rawOptions = options;
-  if (rawOptions?.depth !== void 0 && rawOptions.depth !== 0) {
-    throw createValidationError(PUBLIC_READ_DEPTH_ERROR);
-  }
-  if (rawOptions?.joins !== void 0 && rawOptions.joins !== false) {
-    throw createValidationError(PUBLIC_READ_JOINS_ERROR);
-  }
-  if (rawOptions?.populate !== void 0) {
-    throw createValidationError(PUBLIC_READ_POPULATE_ERROR);
-  }
-  return {
-    ...options,
-    depth: options?.depth ?? 0,
-    joins: options?.joins ?? false
-  };
-}
-var ReadOnlyCollectionQueryBuilder = class {
-  constructor(api, collection) {
-    this.api = api;
-    this.collection = collection;
-  }
-  async find(options) {
-    return this.api.requestFind(
-      `/api/${String(this.collection)}`,
-      withDefaultPublicReadOptions(options)
-    );
-  }
-  async findById(id, options) {
-    return this.api.requestFindById(
-      `/api/${String(this.collection)}/${String(id)}`,
-      withDefaultPublicReadOptions(options)
-    );
-  }
-  async count(options) {
-    return this.api.requestCount(
-      `/api/${String(this.collection)}/count`,
-      withDefaultPublicReadOptions(options)
-    );
-  }
-};
-
-// src/core/collection/collection-client.ts
-var ReadOnlyCollectionClient = class extends HttpClient {
-  from(collection) {
-    return new ReadOnlyCollectionQueryBuilder(this, collection);
-  }
-  async requestFind(endpoint, options) {
-    const url = this.buildUrl(endpoint, options);
-    const response = await this.fetchWithTracking(url, {
-      ...this.defaultOptions,
-      method: "GET"
-    });
-    return this.parseFindResponse(response);
-  }
-  async requestFindEndpoint(endpoint, data) {
-    const response = await this.fetchWithTracking(endpoint, {
-      ...this.defaultOptions,
-      method: "POST",
-      body: data ? JSON.stringify(data) : void 0
-    });
-    return this.parseFindResponse(response);
-  }
-  async requestFindEndpointGet(endpoint) {
-    const response = await this.fetchWithTracking(endpoint, {
-      ...this.defaultOptions,
-      method: "GET"
-    });
-    return this.parseFindResponse(response);
-  }
-  async requestFindById(endpoint, options) {
-    const url = this.buildUrl(endpoint, options);
-    const response = await this.fetchWithTracking(url, {
-      ...this.defaultOptions,
-      method: "GET"
-    });
-    return this.parseDocumentResponse(response);
-  }
-  async requestCount(endpoint, options) {
-    const url = this.buildUrl(endpoint, options);
-    const response = await this.fetchWithTracking(url, {
-      ...this.defaultOptions,
-      method: "GET"
-    });
-    return this.parseDocumentResponse(response);
-  }
-};
-
 // src/core/api/parse-response.ts
 async function parseApiResponse(response, endpoint, options = {}) {
   if (response.status === 204 || response.headers.get("content-length") === "0") {
@@ -1547,6 +1265,14 @@ var EXTERNAL_CUSTOMER_LINK_ENDPOINT_OPERATIONS = {
     "/external-links/clear-previous-state"
   )
 };
+var BENEFIT_VOUCHER_ENDPOINT_OPERATIONS = {
+  issue: operation("customers", "post", "/benefit-vouchers/issue"),
+  get: operation("customers", "post", "/benefit-vouchers/get"),
+  list: operation("customers", "post", "/benefit-vouchers/list"),
+  redeem: operation("customers", "post", "/benefit-vouchers/redeem"),
+  void: operation("customers", "post", "/benefit-vouchers/void"),
+  listMine: operation("customers", "get", "/me/benefit-vouchers")
+};
 var CUSTOMER_GROUP_ENDPOINT_OPERATIONS = {
   members: operation("customer-groups", "get", "/:id/members"),
   grant: operation("customer-groups", "post", "/:id/members/grant"),
@@ -1788,58 +1514,425 @@ var CustomerScopedTransport = class {
       options.publishableKey,
       options.secretKey
     );
-    this.secretKey = options.secretKey;
-    this.apiUrl = options.apiUrl;
-    this.customerToken = options.customerToken;
-    this.onUnauthorized = options.onUnauthorized;
-    this.onRequestId = options.onRequestId;
+    this.secretKey = options.secretKey;
+    this.apiUrl = options.apiUrl;
+    this.customerToken = options.customerToken;
+    this.onUnauthorized = options.onUnauthorized;
+    this.onRequestId = options.onRequestId;
+  }
+  async request(endpoint, options) {
+    const token = typeof this.customerToken === "function" ? this.customerToken() : this.customerToken;
+    try {
+      const response = await httpFetch(endpoint, {
+        method: options.method,
+        apiUrl: this.apiUrl,
+        publishableKey: this.publishableKey,
+        secretKey: this.secretKey,
+        customerToken: token ?? void 0,
+        ...token && this.onUnauthorized && { onUnauthorized: this.onUnauthorized },
+        ...options.body !== void 0 && {
+          body: JSON.stringify(options.body)
+        },
+        ...options.headers && { headers: options.headers },
+        ...options.errorFamily && { errorFamily: options.errorFamily }
+      });
+      this.onRequestId?.(response.headers.get("x-request-id") ?? null);
+      return parseApiResponse(response, endpoint, {
+        errorFamily: options.errorFamily
+      });
+    } catch (err) {
+      const id = err instanceof SDKError ? err.requestId ?? null : null;
+      this.onRequestId?.(id);
+      throw err;
+    }
+  }
+};
+var CustomerScopedApi = class {
+  constructor(apiName, options) {
+    this.transport = new CustomerScopedTransport(apiName, options);
+  }
+  requestEndpoint(endpoint, body, options) {
+    return this.transport.request(resolveOperationPath(endpoint, options), {
+      method: resolveOperationMethod(endpoint),
+      body,
+      headers: options?.headers,
+      errorFamily: resolveOperationErrorFamily(endpoint)
+    });
+  }
+};
+var RawCustomerScopedApi = class {
+  constructor(apiName, options) {
+    this.transport = new CustomerScopedTransport(apiName, options);
+  }
+  request(endpoint, options) {
+    return this.transport.request(endpoint, options);
+  }
+};
+
+// src/core/api/benefit-voucher-types.ts
+var BENEFIT_VOUCHER_VOID_REASONS = [
+  "issued_in_error",
+  "benefit_revoked",
+  "customer_request",
+  "other"
+];
+function invalidBenefitVoucherResponse() {
+  throw createApiError("Invalid benefit voucher response", 200);
+}
+function object(value, keys) {
+  if (!value || typeof value !== "object" || Array.isArray(value) || Object.keys(value).length !== keys.length || keys.some((key) => !(key in value)))
+    invalidBenefitVoucherResponse();
+  return value;
+}
+var uuid = (v) => typeof v === "string" && (/^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(
+  v
+) || v === "00000000-0000-0000-0000-000000000000" || v.toLowerCase() === "ffffffff-ffff-ffff-ffff-ffffffffffff");
+var time = (v) => typeof v === "string" && /^\d{4}-\d{2}-\d{2}T/.test(v) && Number.isFinite(Date.parse(v)) && new Date(Date.parse(v)).toISOString() === v;
+var actor = (v) => typeof v === "string" && /^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/.test(v);
+function parseBenefitVoucher(value, mine = false) {
+  const v = object(value, [
+    "id",
+    "name",
+    "description",
+    "state",
+    "issuedAt",
+    "expiresAt",
+    ...mine ? ["closedAt"] : ["customerId", "definitionId", "source", "closed"]
+  ]);
+  if (!uuid(v.id) || typeof v.name !== "string" || !v.name.length || v.name.length > 120 || v.description !== null && (typeof v.description !== "string" || v.description.length > 1e3) || !["issued", "redeemed", "expired", "voided"].includes(v.state) || !time(v.issuedAt) || !time(v.expiresAt))
+    invalidBenefitVoucherResponse();
+  if (mine) {
+    if (v.closedAt !== null && !time(v.closedAt))
+      invalidBenefitVoucherResponse();
+  } else {
+    if (!uuid(v.customerId) || !uuid(v.definitionId))
+      invalidBenefitVoucherResponse();
+    const source = object(v.source, ["namespace", "ref"]);
+    if (typeof source.namespace !== "string" || !/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/.test(source.namespace) || typeof source.ref !== "string" || !source.ref.length || source.ref.length > 256)
+      invalidBenefitVoucherResponse();
+    if (v.closed !== null) {
+      const closed = object(v.closed, [
+        "at",
+        "channel",
+        "actor",
+        "actorRef",
+        "voidReason"
+      ]);
+      const principal = object(closed.actor, ["type", "id"]);
+      if (!time(closed.at) || !uuid(principal.id) || !["server", "console"].includes(closed.channel) || !["server_credential", "operator"].includes(principal.type) || closed.actorRef !== null && !actor(closed.actorRef) || closed.voidReason !== null && !BENEFIT_VOUCHER_VOID_REASONS.includes(closed.voidReason))
+        invalidBenefitVoucherResponse();
+    }
+  }
+  return value;
+}
+function parseBenefitVoucherList(value, mine = false) {
+  const v = object(value, ["vouchers", "nextCursor", "evaluatedAt"]);
+  if (!Array.isArray(v.vouchers) || v.vouchers.length > 100 || !time(v.evaluatedAt) || v.nextCursor !== null && (typeof v.nextCursor !== "string" || !v.nextCursor.length || v.nextCursor.length > 2048))
+    invalidBenefitVoucherResponse();
+  for (const row of v.vouchers) {
+    if (mine) parseBenefitVoucher(row, true);
+    else parseBenefitVoucher(row);
+  }
+  return value;
+}
+
+// src/core/api/customer-benefit-vouchers-api.ts
+var CustomerBenefitVouchersApi = class extends CustomerScopedApi {
+  async listMine(params = {}) {
+    const query = new URLSearchParams();
+    for (const [key, value] of Object.entries(params))
+      if (value !== void 0) query.set(key, String(value));
+    return parseBenefitVoucherList(
+      await this.requestEndpoint(
+        BENEFIT_VOUCHER_ENDPOINT_OPERATIONS.listMine,
+        void 0,
+        { query }
+      ),
+      true
+    );
+  }
+};
+
+// src/core/collection/http-client.ts
+import { stringify } from "qs-esm";
+function validateWhere(where) {
+  if (where === void 0) return false;
+  let hasNull = false;
+  function visit(value, depth, key) {
+    if (depth > 10) {
+      throw createValidationError(
+        "Collection where must not exceed nesting depth 10."
+      );
+    }
+    if (value === null && (key === "equals" || key === "not_equals")) {
+      hasNull = true;
+      return;
+    }
+    if (value == null) {
+      throw createValidationError(
+        "Collection where must not contain null or undefined values."
+      );
+    }
+    if (Array.isArray(value)) {
+      if (value.length === 0) {
+        throw createValidationError(
+          "Collection where must not contain empty arrays, including and/or."
+        );
+      }
+      if (value.length > 1e3) {
+        throw createValidationError(
+          "Collection where arrays must not contain more than 1000 elements."
+        );
+      }
+      for (const item of value) visit(item, depth + 1);
+    } else if (typeof value === "object" && !(value instanceof Date)) {
+      const values = Object.entries(value);
+      if (values.length === 0) {
+        throw createValidationError(
+          "Collection where must not contain empty condition objects."
+        );
+      }
+      for (const [key2, item] of values) visit(item, depth + 1, key2);
+    }
+  }
+  visit(where, 0);
+  return hasNull;
+}
+var HttpClient = class {
+  constructor(publishableKey, secretKey, getCustomerToken, onUnauthorized, onRequestId, apiUrl) {
+    this.publishableKey = requirePublishableKeyForSecret(
+      "CollectionClient",
+      publishableKey,
+      secretKey
+    );
+    this.secretKey = secretKey;
+    this.getCustomerToken = getCustomerToken;
+    this.onUnauthorized = onUnauthorized;
+    this.onRequestId = onRequestId;
+    this.apiUrl = apiUrl;
   }
-  async request(endpoint, options) {
-    const token = typeof this.customerToken === "function" ? this.customerToken() : this.customerToken;
+  get defaultOptions() {
+    const opts = {
+      apiUrl: this.apiUrl,
+      publishableKey: this.publishableKey,
+      secretKey: this.secretKey
+    };
+    const token = this.getCustomerToken?.();
+    if (token) {
+      opts.customerToken = token;
+      if (this.onUnauthorized) {
+        opts.onUnauthorized = this.onUnauthorized;
+      }
+    }
+    return opts;
+  }
+  async fetchWithTracking(url, opts) {
     try {
-      const response = await httpFetch(endpoint, {
-        method: options.method,
-        apiUrl: this.apiUrl,
-        publishableKey: this.publishableKey,
-        secretKey: this.secretKey,
-        customerToken: token ?? void 0,
-        ...token && this.onUnauthorized && { onUnauthorized: this.onUnauthorized },
-        ...options.body !== void 0 && {
-          body: JSON.stringify(options.body)
-        },
-        ...options.headers && { headers: options.headers },
-        ...options.errorFamily && { errorFamily: options.errorFamily }
-      });
+      const response = await httpFetch(url, opts);
       this.onRequestId?.(response.headers.get("x-request-id") ?? null);
-      return parseApiResponse(response, endpoint, {
-        errorFamily: options.errorFamily
-      });
+      return response;
     } catch (err) {
       const id = err instanceof SDKError ? err.requestId ?? null : null;
       this.onRequestId?.(id);
       throw err;
     }
   }
+  buildUrl(endpoint, options) {
+    if (!options) return endpoint;
+    const { fallbackLocale, ...rest } = options;
+    const queryOptions = fallbackLocale === void 0 ? rest : {
+      ...rest,
+      "fallback-locale": fallbackLocale === false ? "none" : fallbackLocale
+    };
+    const encodedOptions = validateWhere(queryOptions.where) ? { ...queryOptions, where: JSON.stringify(queryOptions.where) } : queryOptions;
+    const queryString = stringify(encodedOptions, { addQueryPrefix: true });
+    return queryString ? `${endpoint}${queryString}` : endpoint;
+  }
+  assertJsonResponse(response) {
+    const contentType = response.headers.get("content-type");
+    if (!contentType?.includes("application/json")) {
+      throw createApiError("Response is not in JSON format.", response.status, {
+        contentType
+      });
+    }
+  }
+  /**
+   * Parse Payload CMS find response (list query)
+   * Returns native Payload response structure
+   */
+  async parseFindResponse(response) {
+    const contentType = response.headers.get("content-type");
+    try {
+      this.assertJsonResponse(response);
+      const jsonData = await response.json();
+      if (jsonData.docs === void 0) {
+        throw createApiError("Invalid find response.", response.status, {
+          jsonData
+        });
+      }
+      return {
+        docs: jsonData.docs,
+        totalDocs: jsonData.totalDocs ?? 0,
+        limit: jsonData.limit || 20,
+        totalPages: jsonData.totalPages ?? 0,
+        page: jsonData.page || 1,
+        pagingCounter: jsonData.pagingCounter || 1,
+        hasPrevPage: jsonData.hasPrevPage ?? false,
+        hasNextPage: jsonData.hasNextPage ?? false,
+        prevPage: jsonData.prevPage ?? null,
+        nextPage: jsonData.nextPage ?? null
+      };
+    } catch (error) {
+      if (error instanceof SDKError) throw error;
+      throw createApiError("Failed to parse response.", response.status, {
+        contentType,
+        error: error instanceof Error ? error.message : error
+      });
+    }
+  }
+  /**
+   * Parse Payload CMS mutation response (create/update)
+   * Returns native Payload response structure
+   */
+  async parseMutationResponse(response) {
+    const contentType = response.headers.get("content-type");
+    try {
+      this.assertJsonResponse(response);
+      const jsonData = await response.json();
+      if (jsonData.doc === void 0) {
+        throw createApiError("Invalid mutation response.", response.status, {
+          jsonData
+        });
+      }
+      return {
+        message: jsonData.message || "",
+        doc: jsonData.doc,
+        errors: jsonData.errors
+      };
+    } catch (error) {
+      if (error instanceof SDKError) throw error;
+      throw createApiError("Failed to parse response.", response.status, {
+        contentType,
+        error: error instanceof Error ? error.message : error
+      });
+    }
+  }
+  /**
+   * Parse Payload CMS document response (findById/delete)
+   * Returns document directly without wrapper
+   */
+  async parseDocumentResponse(response) {
+    const contentType = response.headers.get("content-type");
+    try {
+      this.assertJsonResponse(response);
+      const jsonData = await response.json();
+      return jsonData;
+    } catch (error) {
+      if (error instanceof SDKError) throw error;
+      throw createApiError("Failed to parse response.", response.status, {
+        contentType,
+        error: error instanceof Error ? error.message : error
+      });
+    }
+  }
 };
-var CustomerScopedApi = class {
-  constructor(apiName, options) {
-    this.transport = new CustomerScopedTransport(apiName, options);
+
+// src/utils/types.ts
+function resolveRelation(ref) {
+  if (typeof ref === "string" || typeof ref === "number" || ref === null || ref === void 0)
+    return null;
+  return ref;
+}
+
+// src/core/collection/query-builder.ts
+var PUBLIC_READ_DEPTH_ERROR = "Publishable collection reads require depth: 0. Use a shaped commerce endpoint or server client for populated data.";
+var PUBLIC_READ_JOINS_ERROR = "Publishable collection reads require joins: false. Use a shaped commerce endpoint or server client for joined data.";
+var PUBLIC_READ_POPULATE_ERROR = "Publishable collection reads do not support populate. Use a shaped commerce endpoint or server client for populated data.";
+function withDefaultPublicReadOptions(options) {
+  const rawOptions = options;
+  if (rawOptions?.depth !== void 0 && rawOptions.depth !== 0) {
+    throw createValidationError(PUBLIC_READ_DEPTH_ERROR);
   }
-  requestEndpoint(endpoint, body, options) {
-    return this.transport.request(resolveOperationPath(endpoint, options), {
-      method: resolveOperationMethod(endpoint),
-      body,
-      headers: options?.headers,
-      errorFamily: resolveOperationErrorFamily(endpoint)
-    });
+  if (rawOptions?.joins !== void 0 && rawOptions.joins !== false) {
+    throw createValidationError(PUBLIC_READ_JOINS_ERROR);
+  }
+  if (rawOptions?.populate !== void 0) {
+    throw createValidationError(PUBLIC_READ_POPULATE_ERROR);
+  }
+  return {
+    ...options,
+    depth: options?.depth ?? 0,
+    joins: options?.joins ?? false
+  };
+}
+var ReadOnlyCollectionQueryBuilder = class {
+  constructor(api, collection) {
+    this.api = api;
+    this.collection = collection;
+  }
+  async find(options) {
+    return this.api.requestFind(
+      `/api/${String(this.collection)}`,
+      withDefaultPublicReadOptions(options)
+    );
+  }
+  async findById(id, options) {
+    return this.api.requestFindById(
+      `/api/${String(this.collection)}/${String(id)}`,
+      withDefaultPublicReadOptions(options)
+    );
+  }
+  async count(options) {
+    return this.api.requestCount(
+      `/api/${String(this.collection)}/count`,
+      withDefaultPublicReadOptions(options)
+    );
   }
 };
-var RawCustomerScopedApi = class {
-  constructor(apiName, options) {
-    this.transport = new CustomerScopedTransport(apiName, options);
+
+// src/core/collection/collection-client.ts
+var ReadOnlyCollectionClient = class extends HttpClient {
+  from(collection) {
+    return new ReadOnlyCollectionQueryBuilder(this, collection);
   }
-  request(endpoint, options) {
-    return this.transport.request(endpoint, options);
+  async requestFind(endpoint, options) {
+    const url = this.buildUrl(endpoint, options);
+    const response = await this.fetchWithTracking(url, {
+      ...this.defaultOptions,
+      method: "GET"
+    });
+    return this.parseFindResponse(response);
+  }
+  async requestFindEndpoint(endpoint, data) {
+    const response = await this.fetchWithTracking(endpoint, {
+      ...this.defaultOptions,
+      method: "POST",
+      body: data ? JSON.stringify(data) : void 0
+    });
+    return this.parseFindResponse(response);
+  }
+  async requestFindEndpointGet(endpoint) {
+    const response = await this.fetchWithTracking(endpoint, {
+      ...this.defaultOptions,
+      method: "GET"
+    });
+    return this.parseFindResponse(response);
+  }
+  async requestFindById(endpoint, options) {
+    const url = this.buildUrl(endpoint, options);
+    const response = await this.fetchWithTracking(url, {
+      ...this.defaultOptions,
+      method: "GET"
+    });
+    return this.parseDocumentResponse(response);
+  }
+  async requestCount(endpoint, options) {
+    const url = this.buildUrl(endpoint, options);
+    const response = await this.fetchWithTracking(url, {
+      ...this.defaultOptions,
+      method: "GET"
+    });
+    return this.parseDocumentResponse(response);
   }
 };
 
@@ -7170,6 +7263,16 @@ var Client = class _Client {
     this.markets = new MarketDiscovery(
       (options2) => this.collections.from("markets").find(options2)
     );
+    this.benefitVouchers = new CustomerBenefitVouchersApi(
+      "CustomerBenefitVouchersApi",
+      {
+        publishableKey: this.config.publishableKey,
+        apiUrl: this.config.apiUrl,
+        customerToken: () => this.customer.auth.getToken(),
+        onUnauthorized,
+        onRequestId
+      }
+    );
     const membershipApi = new BrowserMembershipApi("MembershipApi", {
       publishableKey: this.config.publishableKey,
       apiUrl: this.config.apiUrl,
@@ -7549,6 +7652,7 @@ function createTypedWebhookHandler(collection, handler) {
 
 // src/core/collection/const.ts
 var INTERNAL_COLLECTIONS = [
+  "benefit-voucher-definitions",
   "users",
   "payload-kv",
   "payload-locked-documents",