@01.software/sdk 0.21.0 → 0.23.0

package/dist/index.cjs

@@ -49,9 +49,14 @@ __export(src_exports, {
   ProductApi: () => ProductApi,
   QueryHooks: () => QueryHooks,
   RateLimitError: () => RateLimitError,
+  ReadOnlyCollectionClient: () => ReadOnlyCollectionClient,
   RealtimeConnection: () => RealtimeConnection,
   SDKError: () => SDKError,
+  SERVER_COLLECTIONS: () => SERVER_COLLECTIONS,
+  SERVER_ONLY_COLLECTIONS: () => SERVER_ONLY_COLLECTIONS,
   ServerClient: () => ServerClient,
+  ServerCollectionClient: () => ServerCollectionClient,
+  ServerCollectionQueryBuilder: () => ServerCollectionQueryBuilder,
   ServerCommerceClient: () => ServerCommerceClient,
   ServiceUnavailableError: () => ServiceUnavailableError,
   ShippingApi: () => ShippingApi,
@@ -177,6 +182,46 @@ function resolveMetaImage(ref) {
 }
 
 // src/core/collection/query-builder.ts
+var ReadOnlyCollectionQueryBuilder = class {
+  constructor(api, collection) {
+    this.api = api;
+    this.collection = collection;
+  }
+  async find(options) {
+    return this.api.requestFind(
+      `/api/${String(this.collection)}`,
+      options
+    );
+  }
+  async findById(id, options) {
+    return this.api.requestFindById(
+      `/api/${String(this.collection)}/${String(id)}`,
+      options
+    );
+  }
+  async count(options) {
+    return this.api.requestCount(
+      `/api/${String(this.collection)}/count`,
+      options
+    );
+  }
+  async findMetadata(options, metadataOptions) {
+    const { docs } = await this.find({ ...options, limit: 1, depth: 1 });
+    const doc = docs[0];
+    if (!doc) return null;
+    return generateMetadata(
+      extractSeo(doc),
+      metadataOptions
+    );
+  }
+  async findMetadataById(id, metadataOptions) {
+    const doc = await this.findById(id, { depth: 1 });
+    return generateMetadata(
+      extractSeo(doc),
+      metadataOptions
+    );
+  }
+};
 var CollectionQueryBuilder = class {
   constructor(api, collection) {
     this.api = api;
@@ -308,6 +353,8 @@ var CollectionQueryBuilder = class {
     );
   }
 };
+var ServerCollectionQueryBuilder = class extends CollectionQueryBuilder {
+};
 
 // src/core/collection/http-client.ts
 var import_qs_esm = require("qs-esm");
@@ -350,8 +397,8 @@ var NetworkError = class extends SDKError {
   }
 };
 var ValidationError = class extends SDKError {
-  constructor(message, details, userMessage, suggestion) {
-    super("VALIDATION_ERROR", message, 400, details, userMessage, suggestion);
+  constructor(message, details, userMessage, suggestion, status = 400) {
+    super("VALIDATION_ERROR", message, status, details, userMessage, suggestion);
     this.name = "ValidationError";
   }
 };
@@ -480,7 +527,7 @@ function isRateLimitError(error) {
   return error instanceof RateLimitError;
 }
 var createNetworkError = (message, status, details, userMessage, suggestion) => new NetworkError(message, status, details, userMessage, suggestion);
-var createValidationError = (message, details, userMessage, suggestion) => new ValidationError(message, details, userMessage, suggestion);
+var createValidationError = (message, details, userMessage, suggestion, status) => new ValidationError(message, details, userMessage, suggestion, status);
 var createApiError = (message, status, details, userMessage, suggestion) => new ApiError(message, status, details, userMessage, suggestion);
 var createConfigError = (message, details, userMessage, suggestion) => new ConfigError(message, details, userMessage, suggestion);
 var createTimeoutError = (message, details, userMessage, suggestion) => new TimeoutError(message, details, userMessage, suggestion);
@@ -491,6 +538,16 @@ var createNotFoundError = (message, details, userMessage, suggestion, requestId)
 var createConflictError = (message, details, userMessage, suggestion, requestId) => new ConflictError(message, details, userMessage, suggestion, requestId);
 var createRateLimitError = (message, retryAfter, details, userMessage, suggestion, requestId) => new RateLimitError(message, retryAfter, details, userMessage, suggestion, requestId);
 
+// src/core/internal/utils/credentials.ts
+function requirePublishableKeyForSecret(apiName, publishableKey, secretKey) {
+  if (secretKey && !publishableKey) {
+    throw createConfigError(
+      `publishableKey is required for ${apiName} when secretKey is used. It is sent as X-Publishable-Key for tenant routing, rate limiting, and quota enforcement.`
+    );
+  }
+  return publishableKey ?? "";
+}
+
 // src/core/client/types.ts
 function resolveApiUrl() {
   if (typeof process !== "undefined" && process.env) {
@@ -505,7 +562,7 @@ function resolveApiUrl() {
 // src/core/internal/utils/http.ts
 var DEFAULT_TIMEOUT = 3e4;
 var DEFAULT_RETRYABLE_STATUSES = [408, 429, 500, 502, 503, 504];
-var NON_RETRYABLE_STATUSES = [400, 401, 403, 404, 422];
+var NON_RETRYABLE_STATUSES = [400, 401, 403, 404, 409, 422];
 var SAFE_METHODS = ["GET", "HEAD", "OPTIONS"];
 function debugLog(debug, type, message, data) {
   if (!debug) return;
@@ -588,6 +645,80 @@ function attachRequestId(err, id) {
   if (id) err.requestId = id;
   return err;
 }
+function createHttpStatusError(status, parsed, details, requestId) {
+  const errorDetails = {
+    ...details,
+    ...parsed.errors && { errors: parsed.errors },
+    ...parsed.body && { body: parsed.body }
+  };
+  const suggestion = getErrorSuggestion(status);
+  if (status === 400 || status === 422) {
+    return attachRequestId(
+      createValidationError(
+        parsed.errorMessage,
+        errorDetails,
+        parsed.userMessage,
+        suggestion,
+        status
+      ),
+      requestId
+    );
+  }
+  if (status === 401) {
+    return attachRequestId(
+      createAuthError(
+        parsed.errorMessage,
+        errorDetails,
+        parsed.userMessage,
+        suggestion
+      ),
+      requestId
+    );
+  }
+  if (status === 403) {
+    return attachRequestId(
+      createPermissionError(
+        parsed.errorMessage,
+        errorDetails,
+        parsed.userMessage,
+        suggestion
+      ),
+      requestId
+    );
+  }
+  if (status === 404) {
+    return attachRequestId(
+      createNotFoundError(
+        parsed.errorMessage,
+        errorDetails,
+        parsed.userMessage,
+        suggestion
+      ),
+      requestId
+    );
+  }
+  if (status === 409) {
+    return attachRequestId(
+      createConflictError(
+        parsed.errorMessage,
+        errorDetails,
+        parsed.userMessage,
+        suggestion
+      ),
+      requestId
+    );
+  }
+  return attachRequestId(
+    createNetworkError(
+      parsed.errorMessage,
+      status,
+      errorDetails,
+      parsed.userMessage,
+      suggestion
+    ),
+    requestId
+  );
+}
 async function httpFetch(url, options) {
   const {
     publishableKey,
@@ -692,14 +823,10 @@ async function httpFetch(url, options) {
           attempt: attempt + 1
         };
         if (NON_RETRYABLE_STATUSES.includes(response.status)) {
-          throw attachRequestId(
-            createNetworkError(
-              parsed.errorMessage,
-              response.status,
-              { ...details, ...parsed.errors && { errors: parsed.errors } },
-              parsed.userMessage,
-              getErrorSuggestion(response.status)
-            ),
+          throw createHttpStatusError(
+            response.status,
+            parsed,
+            details,
             requestId
           );
         }
@@ -789,7 +916,11 @@ async function httpFetch(url, options) {
 // src/core/collection/http-client.ts
 var HttpClient = class {
   constructor(publishableKey, secretKey, getCustomerToken, onUnauthorized, onRequestId) {
-    this.publishableKey = publishableKey;
+    this.publishableKey = requirePublishableKeyForSecret(
+      "CollectionClient",
+      publishableKey,
+      secretKey
+    );
     this.secretKey = secretKey;
     this.getCustomerToken = getCustomerToken;
     this.onUnauthorized = onUnauthorized;
@@ -1062,6 +1193,40 @@ var CollectionClient = class extends HttpClient {
     return this.parseMutationResponse(response);
   }
 };
+var ServerCollectionClient = class extends CollectionClient {
+  from(collection) {
+    return new ServerCollectionQueryBuilder(this, collection);
+  }
+};
+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 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/collection/const.ts
 var INTERNAL_COLLECTIONS = [
@@ -1084,6 +1249,7 @@ var INTERNAL_COLLECTIONS = [
   "api-keys",
   "personal-access-tokens",
   "tenant-entitlements",
+  "direct-upload-sessions",
   "webhook-events",
   "webhook-deliveries",
   "audit-logs",
@@ -1113,8 +1279,8 @@ var COLLECTIONS = [
   "transactions",
   "customers",
   "customer-profiles",
+  "customer-profile-lists",
   "customer-addresses",
-  "customer-groups",
   "carts",
   "cart-items",
   "discounts",
@@ -1170,6 +1336,11 @@ var COLLECTIONS = [
   "event-occurrences",
   "event-tags"
 ];
+var SERVER_ONLY_COLLECTIONS = ["customer-groups"];
+var SERVER_COLLECTIONS = [
+  ...COLLECTIONS,
+  ...SERVER_ONLY_COLLECTIONS
+];
 
 // src/core/api/parse-response.ts
 async function parseApiResponse(response, endpoint) {
@@ -1220,7 +1391,11 @@ async function parseApiResponse(response, endpoint) {
 // src/core/community/community-client.ts
 var CommunityClient = class {
   constructor(options) {
-    this.publishableKey = options.publishableKey ?? "";
+    this.publishableKey = requirePublishableKeyForSecret(
+      "CommunityClient",
+      options.publishableKey,
+      options.secretKey
+    );
     this.secretKey = options.secretKey;
     this.customerToken = options.customerToken;
     this.onUnauthorized = options.onUnauthorized;
@@ -1390,7 +1565,11 @@ var BaseApi = class {
     if (!options.secretKey) {
       throw createConfigError(`secretKey is required for ${apiName}.`);
     }
-    this.publishableKey = options.publishableKey ?? "";
+    this.publishableKey = requirePublishableKeyForSecret(
+      apiName,
+      options.publishableKey,
+      options.secretKey
+    );
     this.secretKey = options.secretKey;
     this.onRequestId = options.onRequestId;
   }
@@ -1684,7 +1863,11 @@ var CartApi = class {
         "Either secretKey or customerToken is required for CartApi."
       );
     }
-    this.publishableKey = options.publishableKey ?? "";
+    this.publishableKey = requirePublishableKeyForSecret(
+      "CartApi",
+      options.publishableKey,
+      options.secretKey
+    );
     this.secretKey = options.secretKey;
     this.customerToken = options.customerToken;
     this.onUnauthorized = options.onUnauthorized;
@@ -1880,8 +2063,13 @@ var OrderApi = class extends BaseApi {
 // src/core/commerce/server-commerce-client.ts
 var ServerCommerceClient = class {
   constructor(options) {
+    const publishableKey = requirePublishableKeyForSecret(
+      "ServerCommerceClient",
+      options.publishableKey,
+      options.secretKey
+    );
     const serverOptions = {
-      publishableKey: options.publishableKey,
+      publishableKey,
       secretKey: options.secretKey,
       onRequestId: options.onRequestId
     };
@@ -2482,7 +2670,14 @@ var Client = class {
       onUnauthorized,
       onRequestId
     });
-    this.collections = new CollectionClient(
+    const collectionClient = new CollectionClient(
+      this.config.publishableKey,
+      void 0,
+      () => this.customer.auth.getToken(),
+      onUnauthorized,
+      onRequestId
+    );
+    this.collections = new ReadOnlyCollectionClient(
       this.config.publishableKey,
       void 0,
       () => this.customer.auth.getToken(),
@@ -2491,7 +2686,7 @@ var Client = class {
     );
     this.query = new QueryHooks(
       this.queryClient,
-      this.collections,
+      collectionClient,
       this.customer.auth
     );
   }
@@ -2546,7 +2741,7 @@ var ServerClient = class {
         unbanCustomer: moderationApi.unbanCustomer.bind(moderationApi)
       }
     });
-    this.collections = new CollectionClient(
+    this.collections = new ServerCollectionClient(
       this.config.publishableKey,
       this.config.secretKey,
       void 0,
@@ -2868,12 +3063,24 @@ function getVariantPrimaryImage(variant) {
   if (!variant) return null;
   return extractEntityId(variant.thumbnail) ?? getFirstMediaId(variant.images);
 }
+function getFirstAvailableVariantPrimaryImage(variants) {
+  const orderedVariants = [...variants].sort(compareVariantOrder);
+  for (const variant of orderedVariants) {
+    if (!isVariantAvailableForSale(variant)) continue;
+    const image = getVariantPrimaryImage(variant);
+    if (image != null) return image;
+  }
+  return null;
+}
 function normalizeOptionValue(value, fallbackOptionId) {
   return {
     id: String(value.id),
     optionId: getRelationID(value.option) ?? fallbackOptionId,
     label: value.value || value.slug || String(value.id),
     slug: value.slug ?? null,
+    swatchColor: value.swatchColor ?? null,
+    thumbnail: value.thumbnail ?? null,
+    images: value.images ?? null,
     order: value._order ?? value["_product-option-values_values_order"] ?? ""
   };
 }
@@ -2902,7 +3109,10 @@ function buildProductOptionMatrix({
     const valuesById = /* @__PURE__ */ new Map();
     for (const rawValue of option.values?.docs ?? []) {
       if (!isProductOptionValueDoc(rawValue)) continue;
-      const normalizedValue = normalizeOptionValue(rawValue, String(option.id));
+      const normalizedValue = normalizeOptionValue(
+        rawValue,
+        String(option.id)
+      );
       valuesById.set(normalizedValue.id, normalizedValue);
     }
     return {
@@ -2914,7 +3124,9 @@ function buildProductOptionMatrix({
       )
     };
   }).sort((left, right) => compareOrder(left.order, right.order));
-  const optionById = new Map(normalizedOptions.map((option) => [option.id, option]));
+  const optionById = new Map(
+    normalizedOptions.map((option) => [option.id, option])
+  );
   const valueById = /* @__PURE__ */ new Map();
   const valueToOptionId = /* @__PURE__ */ new Map();
   for (const option of normalizedOptions) {
@@ -2993,10 +3205,12 @@ function compareVariantOrder(a, b) {
 function isVariantAvailableForSale(variant) {
   if (variant.isActive === false) return false;
   if (variant.isUnlimited) return true;
-  return (variant.stock ?? 0) > 0;
+  return (variant.stock ?? 0) - (variant.reservedStock ?? 0) > 0;
 }
 function getMinMax(values) {
-  const numbers = values.filter((value) => typeof value === "number");
+  const numbers = values.filter(
+    (value) => typeof value === "number"
+  );
   if (numbers.length === 0) {
     return { min: null, max: null };
   }
@@ -3007,7 +3221,9 @@ function getMinMax(values) {
 }
 function buildProductListingProjection(product, variants) {
   const orderedVariants = [...variants].sort(compareVariantOrder);
-  const activeVariants = orderedVariants.filter((variant) => variant.isActive !== false);
+  const activeVariants = orderedVariants.filter(
+    (variant) => variant.isActive !== false
+  );
   const availableVariants = activeVariants.filter(isVariantAvailableForSale);
   const selectionHintVariant = availableVariants[0] ?? activeVariants[0] ?? null;
   const { min: minPrice, max: maxPrice } = getMinMax(
@@ -3046,7 +3262,9 @@ function buildProductListingGroupsByOption(args) {
       return [];
     }
     const listingBase = buildProductListingProjection(void 0, variants);
+    const optionValuePrimaryImage = extractEntityId(value.thumbnail) ?? getFirstMediaId(value.images);
     const productFallbackImage = extractEntityId(args.product?.thumbnail) ?? getFirstMediaId(args.product?.images);
+    const groupPrimaryImage = getFirstAvailableVariantPrimaryImage(variants) ?? optionValuePrimaryImage ?? productFallbackImage;
     return [
       {
         optionId: primaryOption.id,
@@ -3054,12 +3272,15 @@ function buildProductListingGroupsByOption(args) {
         optionValueId: value.id,
         optionValueLabel: value.label,
         optionValueSlug: value.slug,
+        optionValueSwatchColor: value.swatchColor ?? null,
+        optionValueThumbnail: value.thumbnail ?? null,
+        optionValueImages: value.images ?? null,
         variantIds: variants.map((variant) => String(variant.id)),
         variantCount: variants.length,
         variants,
         listing: {
           ...listingBase,
-          primaryImage: listingBase.primaryImage ?? productFallbackImage
+          primaryImage: groupPrimaryImage
         }
       }
     ];