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

package/dist/index.mjs

@@ -1,7 +1,14 @@
-import axios, { AxiosError, isAxiosError } from 'axios';
+import axios, { AxiosError, isCancel, isAxiosError } from 'axios';
+import { BaseError as BaseError$1 } from '@atomic-solutions/errors';
 import { z } from 'zod';
 
-// 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 {
@@ -131,8 +138,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 BaseError$1 {
   constructor(options) {
     const metadata = WOOCOMMERCE_ERROR_METADATA[options.code] ?? {
       operation: "woocommerce_api_request",
@@ -144,7 +159,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() {
@@ -171,24 +209,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 {
@@ -581,12 +603,15 @@ var setupErrorInterceptor = (axiosInstance, config, client) => {
   axiosInstance.interceptors.response.use(
     (response) => response,
     async (axiosError) => {
-      const status = axiosError.response?.status || 500;
+      if (isCancel(axiosError)) {
+        return Promise.reject(axiosError);
+      }
+      const status = axiosError.response?.status;
       const errorData = axiosError.response?.data;
+      const isNetworkError = 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,
@@ -594,9 +619,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,
@@ -1290,11 +1312,13 @@ var checkoutSchema = z.object({
   billing_address: billingAddressSchemaNonMandatory,
   shipping_address: addressSchemaNonMandatory,
   payment_method: z.string(),
+  // Null until an order is placed.
+  // GET /checkout returns null here, so the schema must accept it.
   payment_result: z.object({
     payment_status: z.string(),
     payment_details: z.array(z.unknown()),
     redirect_url: z.string()
-  })
+  }).nullable()
 });
 var checkoutInputSchema = z.object({
   payment_method: z.string(),
@@ -1497,6 +1521,14 @@ var productSchema = z.object({
   review_count: z.number(),
   extensions: z.record(z.string(), z.unknown())
 });
+var productTagSchema = z.object({
+  /** Tag unique identifier */
+  id: z.number(),
+  /** Tag display name, e.g. "Vichy decembar 2025" */
+  name: z.string(),
+  /** URL-friendly tag identifier */
+  slug: z.string()
+});
 z.object({
   /** Attribution source type (e.g., 'mobile_app', 'organic', 'referral') */
   source_type: z.string(),
@@ -1642,6 +1674,14 @@ var createProductsAPI = (client, endpoints, options) => ({
   categories: async () => {
     const response = await client.get(endpoints.categories);
     return handleApiResponse(response, z.array(productCategorySchema), options);
+  },
+  // Tags, e.g. GET /products/tags?include=996,683.
+  // The Store API wants include as a comma list, so join the ids.
+  tags: async (params) => {
+    const response = await client.get(endpoints.tags, {
+      params: { include: params?.include?.join(",") }
+    });
+    return handleApiResponse(response, z.array(productTagSchema), options);
   }
 });
 
@@ -1652,6 +1692,8 @@ var createEndpoints = (version = "legacy") => {
     // Products
     products: `${prefix}/products`,
     categories: `${prefix}/products/categories`,
+    // Product tags, e.g. to turn a tag id into its name
+    tags: `${prefix}/products/tags`,
     // Cart
     cart: `${prefix}/cart`,
     addItem: `${prefix}/cart/add-item`,