@atomic-solutions/woocommerce-api-client 0.4.0 → 0.5.1

package/dist/index.js

@@ -1,13 +1,20 @@
 'use strict';
 
 var axios = require('axios');
+var errors = require('@atomic-solutions/errors');
 var zod = require('zod');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
 var axios__default = /*#__PURE__*/_interopDefault(axios);
 
-// src/client/createClient.ts
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), member.set(obj, value), value);
 
 // src/errors/classes/BaseError.ts
 var BaseError = class extends Error {
@@ -53,6 +60,7 @@ Caused by: ${this.options.cause.stack}`;
 
 // src/errors/mapping/mapWooCommerceCode.ts
 var mapWooCommerceCode = (apiCode) => {
+  if (!apiCode) return "unknown_error";
   const directMatches = {
     woocommerce_rest_cart_empty: "cart_empty",
     woocommerce_rest_cart_coupon_error: "invalid_coupon",
@@ -136,8 +144,16 @@ var WOOCOMMERCE_ERROR_METADATA = {
   }
 };
 
+// src/errors/classes/http-error.ts
+var redactPath = (url) => url.replace(/^[a-z][a-z0-9+.-]*:\/\/[^/]+/i, "").replace(/[?#].*$/, "").split("/").map((segment) => /^(\d+|[0-9a-f]{16,}|[0-9a-f-]{36})$/i.test(segment) ? ":id" : segment).join("/");
+var classifyHttpStatus = (status) => ({
+  domain: status === void 0 ? "network" : status === 401 || status === 403 ? "auth" : "integration",
+  severity: status !== void 0 && status < 500 ? "warning" : "error"
+});
+
 // src/errors/classes/WooCommerceApiError.ts
-var WooCommerceApiError = class extends BaseError {
+var _options;
+var WooCommerceApiError = class extends errors.BaseError {
   constructor(options) {
     const metadata = WOOCOMMERCE_ERROR_METADATA[options.code] ?? {
       operation: "woocommerce_api_request",
@@ -149,7 +165,30 @@ var WooCommerceApiError = class extends BaseError {
       userMessage: options.userMessage || metadata.userMessage,
       retryable: options.retryable ?? metadata.retryable
     };
-    super(enrichedOptions);
+    const status = enrichedOptions.statusCode;
+    const { domain, severity } = classifyHttpStatus(status);
+    super({
+      domain,
+      severity,
+      operation: enrichedOptions.operation,
+      message: enrichedOptions.message,
+      code: enrichedOptions.code,
+      retryable: enrichedOptions.retryable,
+      userMessage: enrichedOptions.userMessage,
+      cause: enrichedOptions.cause,
+      fingerprint: [domain, enrichedOptions.code, String(status ?? "network")],
+      extras: {
+        originalCode: enrichedOptions.originalCode,
+        statusCode: status,
+        path: redactPath(enrichedOptions.url),
+        method: enrichedOptions.method
+      }
+    });
+    __privateAdd(this, _options);
+    __privateSet(this, _options, enrichedOptions);
+  }
+  get options() {
+    return __privateGet(this, _options);
   }
   // Convenient getters for frequently accessed fields (no duplication)
   get wooCode() {
@@ -176,24 +215,8 @@ var WooCommerceApiError = class extends BaseError {
   get data() {
     return this.options.data;
   }
-  /**
-   * Get reportable data for error tracking/logging
-   * Includes HTTP context and WooCommerce-specific fields
-   */
-  getReportableData() {
-    return {
-      code: this.options.code,
-      operation: this.options.operation,
-      userMessage: this.options.userMessage,
-      retryable: this.options.retryable,
-      statusCode: this.options.statusCode,
-      url: this.options.url,
-      method: this.options.method,
-      wooCode: this.options.code,
-      originalCode: this.options.originalCode
-    };
-  }
 };
+_options = new WeakMap();
 
 // src/errors/classes/WooCommerceDataValidationError.ts
 var WooCommerceDataValidationError = class _WooCommerceDataValidationError extends BaseError {
@@ -284,34 +307,34 @@ var WooCommerceDataValidationError = class _WooCommerceDataValidationError exten
 };
 
 // src/http/handleApiResponse.ts
-var handleApiResponse = (response, schema, options) => {
+var handleApiData = (data, schema, options, url) => {
   const validationMode = options?.validationMode ?? "strict";
   if (validationMode === "warn") {
-    const result = schema.safeParse(response.data);
+    const result = schema.safeParse(data);
     if (!result.success) {
       const validationError = new WooCommerceDataValidationError({
-        message: `WooCommerce API response validation failed for ${response.config.url || "unknown endpoint"}`,
-        url: response.config.url,
+        message: `WooCommerce API response validation failed for ${url || "unknown endpoint"}`,
+        url,
         zodError: result.error,
-        value: response.data,
+        value: data,
         userMessage: "Received unexpected data from WooCommerce"
       });
       options?.onValidationError?.(validationError);
       options?.errorReporter?.(validationError);
       console.warn("[woocommerce-utils] Validation warning:", validationError.message);
-      return response.data;
+      return data;
     }
     return result.data;
   }
   try {
-    return schema.parse(response.data);
+    return schema.parse(data);
   } catch (error2) {
     if (error2 && typeof error2 === "object" && "issues" in error2) {
       const validationError = new WooCommerceDataValidationError({
-        message: `WooCommerce API response validation failed for ${response.config.url || "unknown endpoint"}`,
-        url: response.config.url,
+        message: `WooCommerce API response validation failed for ${url || "unknown endpoint"}`,
+        url,
         zodError: error2,
-        value: response.data,
+        value: data,
         userMessage: "Received unexpected data from WooCommerce"
       });
       options?.onValidationError?.(validationError);
@@ -321,6 +344,7 @@ var handleApiResponse = (response, schema, options) => {
     throw error2;
   }
 };
+var handleApiResponse = (response, schema, options) => handleApiData(response.data, schema, options, response.config.url);
 
 // src/utils/calculatePagination.ts
 var calculatePagination = (input) => {
@@ -435,6 +459,12 @@ var error = (...args) => {
   console.error(DEBUG_PREFIX, ...args);
 };
 
+// src/http/storeRoutes.ts
+var CART_ROUTE = /\/wc\/store\/(v\d+\/)?(cart|checkout|batch)/;
+var BATCH_ROUTE = /\/wc\/store\/(v\d+\/)?batch/;
+var isCartRoute = (url) => !!url && CART_ROUTE.test(url);
+var isBatchRoute = (url) => !!url && BATCH_ROUTE.test(url);
+
 // src/http/interceptors/request.ts
 var requiresAuth = (url) => {
   if (!url) return false;
@@ -448,30 +478,26 @@ var requiresAuth = (url) => {
   ];
   return authEndpoints.some((endpoint) => url.includes(endpoint));
 };
-var requiresCartAuth = (url) => {
-  if (!url) return false;
-  return /\/wc\/store\/(v\d+\/)?cart/.test(url) || /\/wc\/store\/(v\d+\/)?checkout/.test(url);
-};
 var setupRequestInterceptor = (axiosInstance, config, client) => {
   axiosInstance.interceptors.request.use(
     async (requestConfig) => {
       const url = requestConfig.url;
       if (config.jwtToken) {
         const token = await config.jwtToken.get();
-        if (token && (requiresAuth(url) || requiresCartAuth(url))) {
+        if (token && (requiresAuth(url) || isCartRoute(url))) {
           requestConfig.headers.Authorization = `Bearer ${token}`;
           if (config.debug) {
             debug("Injected JWT token for", url);
           }
         }
       }
-      if (requiresCartAuth(url)) {
+      if (isCartRoute(url)) {
         const headers = await config.cartHeaders.get();
         const isAuthenticated = !!await config.jwtToken?.get();
         if (headers.nonce) {
           requestConfig.headers.Nonce = headers.nonce;
         }
-        if (headers.cartToken && !isAuthenticated) {
+        if (headers.cartToken && (!isAuthenticated || isBatchRoute(url))) {
           requestConfig.headers["Cart-Token"] = headers.cartToken;
         }
         requestConfig.headers["Cache-Control"] = "no-cache, no-store, must-revalidate";
@@ -500,16 +526,19 @@ var setupRequestInterceptor = (axiosInstance, config, client) => {
     }
   );
 };
-
-// src/http/interceptors/response.ts
-var isCartResponse = (url) => {
-  if (!url) return false;
-  return /\/wc\/store\/(v\d+\/)?cart/.test(url) || /\/wc\/store\/(v\d+\/)?checkout/.test(url);
+var NONCE_ERROR_CODES = ["woocommerce_rest_missing_nonce", "woocommerce_rest_invalid_nonce"];
+var isNonceRejectedBatch = (data) => {
+  const responses = data?.responses;
+  if (!Array.isArray(responses) || responses.length === 0) return false;
+  return responses.every((response) => {
+    const code = response?.body?.code;
+    return typeof code === "string" && NONCE_ERROR_CODES.includes(code);
+  });
 };
 var setupResponseInterceptor = (axiosInstance, config, client) => {
   axiosInstance.interceptors.response.use(
     async (response) => {
-      if (isCartResponse(response.config.url)) {
+      if (isCartRoute(response.config.url)) {
         const nonce = response.headers["nonce"] || response.headers["Nonce"];
         const cartToken = response.headers["cart-token"] || response.headers["Cart-Token"];
         if (nonce || cartToken) {
@@ -529,6 +558,15 @@ var setupResponseInterceptor = (axiosInstance, config, client) => {
           }
         }
       }
+      if (isBatchRoute(response.config.url) && isNonceRejectedBatch(response.data)) {
+        throw new axios.AxiosError(
+          "Batch rejected for a nonce error",
+          axios.AxiosError.ERR_BAD_REQUEST,
+          response.config,
+          response.request,
+          { ...response, status: 401, data: { code: "woocommerce_rest_missing_nonce" } }
+        );
+      }
       if (config.debug) {
         debug("Response:", response.config.url, response.status);
       }
@@ -571,12 +609,15 @@ var setupErrorInterceptor = (axiosInstance, config, client) => {
   axiosInstance.interceptors.response.use(
     (response) => response,
     async (axiosError) => {
-      const status = axiosError.response?.status || 500;
+      if (axios.isCancel(axiosError)) {
+        return Promise.reject(axiosError);
+      }
+      const status = axiosError.response?.status;
       const errorData = axiosError.response?.data;
+      const isNetworkError = axios.isAxiosError(axiosError) && !axiosError.response;
       const apiCode = errorData?.code || "unknown_error";
       const wpMessage = errorData?.message || axiosError.message || "Unknown error";
-      const errorCode = mapWooCommerceCode(apiCode);
-      const errorMetadata = WOOCOMMERCE_ERROR_METADATA[errorCode];
+      const errorCode = isNetworkError ? "network_error" : mapWooCommerceCode(apiCode);
       const wcError = new WooCommerceApiError({
         message: wpMessage,
         statusCode: status,
@@ -584,9 +625,6 @@ var setupErrorInterceptor = (axiosInstance, config, client) => {
         // Transformed app-level code
         originalCode: apiCode,
         // Original WooCommerce API code
-        retryable: errorMetadata.retryable,
-        userMessage: errorMetadata.userMessage,
-        operation: errorMetadata.operation,
         url: axiosError.config?.url || "",
         method: axiosError.config?.method?.toUpperCase() || "GET",
         requestBody: axiosError.config?.data,
@@ -1026,6 +1064,18 @@ var addToCartInputSchema = zod.z.object({
     })
   ).optional()
 });
+var addItemsInputSchema = zod.z.object({
+  items: zod.z.array(addToCartInputSchema).min(1)
+});
+var batchResponseSchema = zod.z.object({
+  responses: zod.z.array(
+    zod.z.object({
+      status: zod.z.number(),
+      body: zod.z.unknown(),
+      headers: zod.z.record(zod.z.string(), zod.z.unknown()).optional()
+    })
+  )
+});
 var updateCartItemInputSchema = zod.z.object({
   key: zod.z.string(),
   quantity: zod.z.number().int().positive()
@@ -1369,6 +1419,8 @@ var storeProductsSearchParamsSchema = zod.z.object({
   search: zod.z.string().optional(),
   /** Exact slug match */
   slug: zod.z.string().optional(),
+  /** Exact SKU match */
+  sku: zod.z.string().optional(),
   // Date filtering
   /** Filter products published after this date */
   after: zod.z.string().datetime().optional(),
@@ -1383,6 +1435,8 @@ var storeProductsSearchParamsSchema = zod.z.object({
   include: zod.z.array(zod.z.number()).optional(),
   /** Exclude specific product IDs */
   exclude: zod.z.array(zod.z.number()).optional(),
+  /** Return products related to this product ID */
+  related: zod.z.number().optional(),
   // Parent/Child
   /** Filter by parent product IDs */
   parent: zod.z.array(zod.z.number()).optional(),
@@ -1482,6 +1536,19 @@ zod.z.object({
 var ORDER_ATTRIBUTION_NAMESPACE = "woocommerce/order-attribution";
 
 // src/api/cart.ts
+var BATCH_MAX_REQUESTS = 25;
+var chunk = (list, size) => Array.from(
+  { length: Math.ceil(list.length / size) },
+  (_, index) => list.slice(index * size, index * size + size)
+);
+var isAccepted = (status) => status >= 200 && status < 300;
+var bodyError = (body) => {
+  const data = body;
+  return {
+    code: typeof data?.code === "string" ? data.code : void 0,
+    message: typeof data?.message === "string" ? data.message : void 0
+  };
+};
 var createCartAPI = (client, endpoints, options) => ({
   get: async () => {
     const response = await client.get(endpoints.cart);
@@ -1491,6 +1558,48 @@ var createCartAPI = (client, endpoints, options) => ({
     const response = await client.post(endpoints.addItem, input);
     return handleApiResponse(response, cartSchema, options);
   },
+  addItems: async ({ items }) => {
+    const responses = [];
+    let chunkFailed = false;
+    for (const batch of chunk(items, BATCH_MAX_REQUESTS)) {
+      try {
+        const response = await client.post(endpoints.batch, {
+          requests: batch.map((item) => ({
+            method: "POST",
+            path: endpoints.addItem,
+            body: item
+          }))
+        });
+        responses.push(...handleApiResponse(response, batchResponseSchema, options).responses);
+      } catch (error2) {
+        if (responses.length === 0) throw error2;
+        chunkFailed = true;
+        break;
+      }
+    }
+    const results = items.map((item, index) => {
+      const entry = responses[index];
+      const { code, message } = bodyError(entry?.body);
+      return {
+        item,
+        status: entry?.status ?? 500,
+        ...code ? { code } : {},
+        ...message ? { message } : {}
+      };
+    });
+    const lastAccepted = [...responses].reverse().find((entry) => isAccepted(entry.status));
+    const batchCart = lastAccepted ? handleApiData(lastAccepted.body, cartSchema, options, endpoints.batch) : void 0;
+    let cart = chunkFailed ? void 0 : batchCart;
+    if (!cart) {
+      try {
+        cart = handleApiResponse(await client.get(endpoints.cart), cartSchema, options);
+      } catch (error2) {
+        if (!batchCart) throw error2;
+        cart = batchCart;
+      }
+    }
+    return { cart, results };
+  },
   updateItem: async (input) => {
     const response = await client.post(endpoints.updateItem, input);
     return handleApiResponse(response, cartSchema, options);
@@ -1580,6 +1689,8 @@ var createEndpoints = (version = "legacy") => {
     removeCoupon: `${prefix}/cart/remove-coupon`,
     updateCustomer: `${prefix}/cart/update-customer`,
     selectShippingRate: `${prefix}/cart/select-shipping-rate`,
+    // Batch
+    batch: `${prefix}/batch`,
     // Checkout
     checkout: `${prefix}/checkout`,
     // Orders
@@ -2168,6 +2279,7 @@ var schemas = {
 
 exports.WooCommerceApiError = WooCommerceApiError;
 exports.WooCommerceDataValidationError = WooCommerceDataValidationError;
+exports.addItemsInputSchema = addItemsInputSchema;
 exports.addToCartInputSchema = addToCartInputSchema;
 exports.addressSchema = addressSchema;
 exports.adminCategoryFilterSchema = categoryFilterSchema;
@@ -2178,6 +2290,7 @@ exports.adminOrderSchema = orderSchema;
 exports.adminProductCategorySchema = productCategorySchema2;
 exports.adminProductFilterSchema = productFilterSchema;
 exports.adminProductSchema = productSchema2;
+exports.batchResponseSchema = batchResponseSchema;
 exports.billingAddressSchema = billingAddressSchemaMandatory;
 exports.cartItemImageSchema = cartItemImageSchema;
 exports.cartSchema = cartSchema;
@@ -2195,6 +2308,7 @@ exports.getAppEnumRaw = getAppEnumRaw;
 exports.getAppEnumZod = getAppEnumZod;
 exports.makeAddressFormSchema = makeAddressFormSchema;
 exports.makeBillingAddressFormSchema = makeBillingAddressFormSchema;
+exports.mapWooCommerceCode = mapWooCommerceCode;
 exports.paginationMetaSchema = paginationMetaSchema;
 exports.paginationParamsSchema = paginationParamsSchema;
 exports.paymentMethodFilterSchema = paymentMethodFilterSchema;