@atomic-solutions/woocommerce-api-client 0.3.1 → 0.5.0

package/dist/index.js

@@ -53,6 +53,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",
@@ -284,34 +285,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 +322,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 +437,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 +456,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 +504,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 +536,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);
       }
@@ -1026,6 +1042,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 +1397,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 +1413,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 +1514,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 +1536,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 +1667,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 +2257,7 @@ var schemas = {
 
 exports.WooCommerceApiError = WooCommerceApiError;
 exports.WooCommerceDataValidationError = WooCommerceDataValidationError;
+exports.addItemsInputSchema = addItemsInputSchema;
 exports.addToCartInputSchema = addToCartInputSchema;
 exports.addressSchema = addressSchema;
 exports.adminCategoryFilterSchema = categoryFilterSchema;
@@ -2178,6 +2268,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 +2286,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;