@atomic-solutions/woocommerce-api-client 0.1.0

package/dist/client/index.mjs

@@ -0,0 +1,1455 @@
+import axios, { isAxiosError } from 'axios';
+import { z } from 'zod';
+
+// src/client/createClient.ts
+
+// src/errors/classes/BaseError.ts
+var BaseError = class extends Error {
+  constructor(options) {
+    super(options.message);
+    this.options = options;
+    Object.setPrototypeOf(this, new.target.prototype);
+    this.name = this.constructor.name;
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, this.constructor);
+    }
+    if (this.options.cause instanceof Error && this.options.cause.stack) {
+      this.stack = `${this.stack}
+Caused by: ${this.options.cause.stack}`;
+    }
+  }
+  /**
+   * Get reportable data for error tracking/logging
+   * Subclasses should override this to add their own reportable fields
+   */
+  getReportableData() {
+    const { code, operation, userMessage, retryable } = this.options;
+    return {
+      code,
+      operation,
+      userMessage,
+      retryable
+    };
+  }
+  /**
+   * Custom JSON serialization
+   * Makes the error properly serializable for logging/reporting
+   */
+  toJSON() {
+    return {
+      ...this.getReportableData(),
+      name: this.name,
+      message: this.message,
+      stack: this.stack
+    };
+  }
+};
+
+// src/errors/mapping/mapWooCommerceCode.ts
+var mapWooCommerceCode = (apiCode) => {
+  const directMatches = {
+    woocommerce_rest_cart_empty: "cart_empty",
+    woocommerce_rest_cart_coupon_error: "invalid_coupon",
+    woocommerce_rest_missing_nonce: "missing_nonce",
+    woocommerce_rest_invalid_nonce: "invalid_nonce",
+    rest_invalid_param: "invalid_params",
+    woocommerce_rest_product_invalid_id: "product_not_found",
+    woocommerce_rest_product_out_of_stock: "out_of_stock",
+    woocommerce_rest_product_not_enough_stock: "insufficient_stock",
+    woocommerce_rest_checkout_invalid_payment_method: "invalid_payment_method"
+  };
+  if (directMatches[apiCode]) {
+    return directMatches[apiCode];
+  }
+  if (apiCode.includes("nonce")) return "invalid_nonce";
+  if (apiCode.includes("coupon")) return "invalid_coupon";
+  if (apiCode.includes("stock")) return "insufficient_stock";
+  if (apiCode.includes("checkout")) return "checkout_error";
+  if (apiCode.includes("payment")) return "invalid_payment_method";
+  return "unknown_error";
+};
+
+// src/errors/mapping/constants.ts
+var WOOCOMMERCE_ERROR_METADATA = {
+  cart_empty: {
+    operation: "get_cart",
+    retryable: false,
+    userMessage: "Your cart is empty"
+  },
+  invalid_coupon: {
+    operation: "apply_coupon",
+    retryable: false,
+    userMessage: "Invalid coupon code"
+  },
+  missing_nonce: {
+    operation: "cart_request",
+    retryable: true
+    // Auto-retry with new nonce
+  },
+  invalid_nonce: {
+    operation: "cart_request",
+    retryable: true
+    // Auto-retry with new nonce
+  },
+  invalid_params: {
+    operation: "api_request",
+    retryable: false,
+    userMessage: "Invalid request parameters"
+  },
+  product_not_found: {
+    operation: "get_product",
+    retryable: false,
+    userMessage: "Product not found"
+  },
+  out_of_stock: {
+    operation: "add_to_cart",
+    retryable: false,
+    userMessage: "This product is out of stock"
+  },
+  insufficient_stock: {
+    operation: "add_to_cart",
+    retryable: false,
+    userMessage: "Not enough stock available"
+  },
+  invalid_payment_method: {
+    operation: "process_checkout",
+    retryable: false,
+    userMessage: "Invalid payment method"
+  },
+  checkout_error: {
+    operation: "process_checkout",
+    retryable: false
+  },
+  network_error: {
+    operation: "network_request",
+    retryable: true
+  },
+  unknown_error: {
+    operation: "unknown",
+    retryable: false
+  }
+};
+
+// src/errors/classes/WooCommerceApiError.ts
+var WooCommerceApiError = class extends BaseError {
+  constructor(options) {
+    const metadata = WOOCOMMERCE_ERROR_METADATA[options.code] ?? {
+      operation: "woocommerce_api_request",
+      retryable: false
+    };
+    const enrichedOptions = {
+      ...options,
+      operation: options.operation || metadata.operation,
+      userMessage: options.userMessage || metadata.userMessage,
+      retryable: options.retryable ?? metadata.retryable
+    };
+    super(enrichedOptions);
+  }
+  // Convenient getters for frequently accessed fields (no duplication)
+  get wooCode() {
+    return this.options.code;
+  }
+  get originalCode() {
+    return this.options.originalCode;
+  }
+  get statusCode() {
+    return this.options.statusCode;
+  }
+  get url() {
+    return this.options.url;
+  }
+  get method() {
+    return this.options.method;
+  }
+  get requestBody() {
+    return this.options.requestBody;
+  }
+  get responseBody() {
+    return this.options.responseBody;
+  }
+  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
+    };
+  }
+};
+
+// src/errors/classes/WooCommerceDataValidationError.ts
+var WooCommerceDataValidationError = class _WooCommerceDataValidationError extends BaseError {
+  constructor(options) {
+    const fieldErrors = options.zodError ? _WooCommerceDataValidationError.extractFieldErrorsFromZod(options.zodError) : void 0;
+    super({
+      code: "validation_error",
+      message: options.message,
+      operation: options.operation,
+      userMessage: options.userMessage || "Received unexpected data from WooCommerce",
+      retryable: false,
+      cause: options.cause,
+      url: options.url,
+      zodError: options.zodError,
+      value: options.value,
+      fieldErrors
+    });
+  }
+  // Convenient getters for validation-specific fields (no duplication)
+  get url() {
+    return this.options.url;
+  }
+  get zodError() {
+    return this.options.zodError;
+  }
+  get invalidValue() {
+    return this.options.value;
+  }
+  get fieldErrors() {
+    return this.options.fieldErrors;
+  }
+  /**
+   * Get reportable data for error tracking/logging
+   * Includes validation-specific fields
+   */
+  getReportableData() {
+    return {
+      code: this.options.code,
+      operation: this.options.operation,
+      userMessage: this.options.userMessage,
+      retryable: false,
+      fieldErrors: this.options.fieldErrors,
+      url: this.options.url
+    };
+  }
+  /**
+   * Extract field errors from Zod error
+   */
+  static extractFieldErrorsFromZod(zodError) {
+    if (!zodError?.errors) {
+      return void 0;
+    }
+    const fieldErrors = {};
+    for (const issue of zodError.errors) {
+      const path = issue.path.join(".");
+      if (!fieldErrors[path]) {
+        fieldErrors[path] = [];
+      }
+      fieldErrors[path].push(issue.message);
+    }
+    return fieldErrors;
+  }
+  /**
+   * Get all error messages as a flat array
+   */
+  getMessages() {
+    if (!this.fieldErrors) {
+      return [this.message];
+    }
+    const messages = [];
+    for (const fieldMessages of Object.values(this.fieldErrors)) {
+      messages.push(...fieldMessages);
+    }
+    return messages;
+  }
+  /**
+   * Check if a specific field has errors
+   */
+  hasFieldError(field) {
+    return this.fieldErrors ? field in this.fieldErrors : false;
+  }
+  /**
+   * Get error messages for a specific field
+   */
+  getFieldError(field) {
+    return this.fieldErrors?.[field];
+  }
+};
+
+// src/http/handleApiResponse.ts
+var handleApiResponse = (response, schema, options) => {
+  const validationMode = options?.validationMode ?? "strict";
+  if (validationMode === "warn") {
+    const result = schema.safeParse(response.data);
+    if (!result.success) {
+      const validationError = new WooCommerceDataValidationError({
+        message: `WooCommerce API response validation failed for ${response.config.url || "unknown endpoint"}`,
+        url: response.config.url,
+        zodError: result.error,
+        value: response.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 result.data;
+  }
+  try {
+    return schema.parse(response.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,
+        zodError: error2,
+        value: response.data,
+        userMessage: "Received unexpected data from WooCommerce"
+      });
+      options?.onValidationError?.(validationError);
+      options?.errorReporter?.(validationError);
+      throw validationError;
+    }
+    throw error2;
+  }
+};
+
+// src/utils/calculatePagination.ts
+var calculatePagination = (input) => {
+  const { page, perPage, total, totalPages } = input;
+  const hasNextPage = page < totalPages;
+  const hasPrevPage = page > 1;
+  return {
+    page,
+    perPage,
+    total,
+    totalPages,
+    hasNextPage,
+    hasPrevPage,
+    nextPage: hasNextPage ? page + 1 : null,
+    prevPage: hasPrevPage ? page - 1 : null
+  };
+};
+
+// src/utils/getPaginationMeta.ts
+var getPaginationMeta = (headers) => {
+  if (!headers) {
+    return {
+      total: 0,
+      totalPages: 0
+    };
+  }
+  const wpTotal = headers["x-wp-total"];
+  const wpTotalPages = headers["x-wp-totalpages"];
+  if (!wpTotal || !wpTotalPages) {
+    return {
+      total: 0,
+      totalPages: 0
+    };
+  }
+  const total = parseInt(wpTotal, 10);
+  const totalPages = parseInt(wpTotalPages, 10);
+  return {
+    total,
+    totalPages
+  };
+};
+
+// src/http/handlePaginatedApiResponse.ts
+var handlePaginatedApiResponse = (response, schema, params = {}, options) => {
+  const validationMode = options?.validationMode ?? "strict";
+  let data;
+  if (validationMode === "warn") {
+    const result = schema.safeParse(response.data);
+    if (!result.success) {
+      const validationError = new WooCommerceDataValidationError({
+        message: `WooCommerce API response validation failed for ${response.config.url || "unknown endpoint"}`,
+        url: response.config.url,
+        zodError: result.error,
+        value: response.data,
+        userMessage: "Received unexpected data from WooCommerce"
+      });
+      options?.onValidationError?.(validationError);
+      options?.errorReporter?.(validationError);
+      console.warn("[woocommerce-utils] Validation warning:", validationError.message);
+      data = Array.isArray(response.data) ? response.data : [];
+    } else {
+      data = result.data;
+    }
+  } else {
+    try {
+      data = schema.parse(response.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,
+          zodError: error2,
+          value: response.data,
+          userMessage: "Received unexpected data from WooCommerce"
+        });
+        options?.onValidationError?.(validationError);
+        options?.errorReporter?.(validationError);
+        throw validationError;
+      }
+      throw error2;
+    }
+  }
+  const { total, totalPages } = getPaginationMeta(response.headers);
+  const page = params.page || 1;
+  const perPage = params.per_page || 10;
+  const pagination = calculatePagination({
+    page,
+    perPage,
+    total,
+    totalPages
+  });
+  return {
+    data,
+    pagination
+  };
+};
+
+// src/logging/logger.ts
+var DEBUG_PREFIX = "[woocommerce-utils]";
+var isDebugEnabled = () => {
+  if (typeof process !== "undefined" && process.env) {
+    return process.env.DEBUG === "true" || process.env.DEBUG === "1";
+  }
+  return false;
+};
+var debug = (...args) => {
+  if (isDebugEnabled()) {
+    console.log(DEBUG_PREFIX, ...args);
+  }
+};
+var error = (...args) => {
+  console.error(DEBUG_PREFIX, ...args);
+};
+
+// src/http/interceptors/request.ts
+var requiresAuth = (url) => {
+  if (!url) return false;
+  const authEndpoints = ["/jwt-auth/", "/customers/me", "/wp/v2/users/me"];
+  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 (requiresAuth(url) && config.jwtToken) {
+        const token = await config.jwtToken.get();
+        if (token) {
+          requestConfig.headers.Authorization = `Bearer ${token}`;
+          if (config.debug) {
+            debug("Injected JWT token for", url);
+          }
+        }
+      }
+      if (requiresCartAuth(url)) {
+        const headers = await config.cartHeaders.get();
+        if (headers.nonce) {
+          requestConfig.headers.Nonce = headers.nonce;
+        }
+        if (headers.cartToken) {
+          requestConfig.headers["Cart-Token"] = headers.cartToken;
+        }
+        requestConfig.headers["Cache-Control"] = "no-cache, no-store, must-revalidate";
+        requestConfig.headers.Pragma = "no-cache";
+        requestConfig.headers.Expires = "0";
+        if (config.debug) {
+          debug("Injected cart headers for", url, {
+            hasNonce: !!headers.nonce,
+            hasCartToken: !!headers.cartToken
+          });
+        }
+      }
+      if (config.debug) {
+        debug(
+          `${requestConfig.method?.toUpperCase()} ${requestConfig.url}`,
+          requestConfig.params || requestConfig.data
+        );
+      }
+      if (config.onRequest) {
+        return config.onRequest(requestConfig, client);
+      }
+      return requestConfig;
+    },
+    (error2) => {
+      return Promise.reject(error2);
+    }
+  );
+};
+
+// 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 setupResponseInterceptor = (axiosInstance, config, client) => {
+  axiosInstance.interceptors.response.use(
+    async (response) => {
+      if (isCartResponse(response.config.url)) {
+        const nonce = response.headers["nonce"] || response.headers["Nonce"];
+        const cartToken = response.headers["cart-token"] || response.headers["Cart-Token"];
+        if (nonce || cartToken) {
+          await config.cartHeaders.save({
+            nonce: nonce || void 0,
+            cartToken: cartToken || void 0
+          });
+          if (config.debug) {
+            debug(
+              "Saved updated cart headers:",
+              response.config.url,
+              "nonce:",
+              !!nonce,
+              "cartToken:",
+              !!cartToken
+            );
+          }
+        }
+      }
+      if (config.debug) {
+        debug("Response:", response.config.url, response.status);
+      }
+      if (config.onResponse) {
+        return config.onResponse(response, client);
+      }
+      return response;
+    },
+    (error2) => {
+      return Promise.reject(error2);
+    }
+  );
+};
+
+// src/utils/initializeCartSession.ts
+var initializeCartSession = async (client, cartHeaders) => {
+  try {
+    debug("session", "Initializing cart session");
+    const response = await client.get("/wc/store/v1/cart");
+    const nonce = response.headers["nonce"] || response.headers["Nonce"];
+    const cartToken = response.headers["cart-token"] || response.headers["Cart-Token"];
+    if (nonce || cartToken) {
+      await cartHeaders.save({
+        nonce: nonce || void 0,
+        cartToken: cartToken || void 0
+      });
+      debug("session", "Cart session initialized", {
+        hasNonce: !!nonce,
+        hasCartToken: !!cartToken
+      });
+    }
+  } catch (error2) {
+    debug("session", "Failed to initialize cart session", error2);
+    throw error2;
+  }
+};
+
+// src/http/interceptors/error.ts
+var setupErrorInterceptor = (axiosInstance, config, client) => {
+  axiosInstance.interceptors.response.use(
+    (response) => response,
+    async (axiosError) => {
+      const status = axiosError.response?.status || 500;
+      const errorData = axiosError.response?.data;
+      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 wcError = new WooCommerceApiError({
+        message: wpMessage,
+        statusCode: status,
+        code: errorCode,
+        // 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,
+        responseBody: errorData,
+        data: errorData?.data,
+        cause: axiosError
+      });
+      if (config.debug) {
+        debug("WooCommerce error:", apiCode, status, wpMessage);
+        error(wcError);
+      }
+      if ((status === 401 || status === 403) && config.onAuthError && isAxiosError(axiosError) && !axiosError.config?._retry) {
+        if (config.debug) {
+          debug("Auth error detected, calling onAuthError handler");
+        }
+        try {
+          const shouldRetry = await config.onAuthError(wcError, client);
+          if (shouldRetry) {
+            if (config.debug) {
+              debug("Retrying request after auth error");
+            }
+            axiosError.config._retry = true;
+            return axiosInstance.request(axiosError.config);
+          }
+        } catch (authErrorHandlerError) {
+          if (config.debug) {
+            debug("onAuthError handler threw error", authErrorHandlerError);
+          }
+        }
+      }
+      if (config.onError) {
+        config.onError(wcError, client);
+      }
+      const isNonceError = errorCode === "missing_nonce" || errorCode === "invalid_nonce";
+      if (isNonceError && isAxiosError(axiosError) && !axiosError.config?._retry) {
+        if (config.debug) {
+          debug("Nonce error detected, retrying with new session");
+        }
+        try {
+          await initializeCartSession(axiosInstance, config.cartHeaders);
+          axiosError.config._retry = true;
+          return axiosInstance.request(axiosError.config);
+        } catch (_retryError) {
+          config.errorReporter?.report(wcError);
+          return Promise.reject(wcError);
+        }
+      }
+      config.errorReporter?.report(wcError);
+      return Promise.reject(wcError);
+    }
+  );
+};
+var addressSchema = z.object({
+  /** First name */
+  first_name: z.string().min(1, "First name is required"),
+  /** Last name */
+  last_name: z.string().min(1, "Last name is required"),
+  /** Company name (optional) */
+  company: z.string(),
+  /** Address line 1 */
+  address_1: z.string().min(1, "Address is required"),
+  /** Address line 2 (optional) */
+  address_2: z.string(),
+  /** City */
+  city: z.string().min(1, "City is required"),
+  /** State/Province/Region */
+  state: z.string(),
+  /** Postal code */
+  postcode: z.string().min(1, "Postal code is required"),
+  /** Country code (ISO 3166-1 alpha-2) */
+  country: z.string(),
+  /** Phone number */
+  phone: z.string().min(1, "Phone number is required")
+});
+var addressSchemaNonMandatory = z.object({
+  /** First name */
+  first_name: z.string(),
+  /** Last name */
+  last_name: z.string(),
+  /** Company name (optional) */
+  company: z.string(),
+  /** Address line 1 */
+  address_1: z.string(),
+  /** Address line 2 (optional) */
+  address_2: z.string(),
+  /** City */
+  city: z.string(),
+  /** State/Province/Region */
+  state: z.string(),
+  /** Postal code */
+  postcode: z.string(),
+  /** Country code (ISO 3166-1 alpha-2) */
+  country: z.string(),
+  /** Phone number */
+  phone: z.string()
+});
+var billingAddressSchemaMandatory = addressSchema.extend({
+  /** Email address (required for billing) */
+  email: z.string().email("Valid email is required")
+});
+var billingAddressSchemaNonMandatory = addressSchemaNonMandatory.extend({
+  /** Email address (can be null for guest carts) */
+  email: z.string().nullable()
+});
+var moneySchema = z.object({
+  /** Currency code (e.g., 'USD', 'EUR', 'BAM') */
+  currency_code: z.string(),
+  /** Currency symbol (e.g., '$', '€', 'KM') */
+  currency_symbol: z.string(),
+  /** Number of decimal places (e.g., 2 for dollars/euros) */
+  currency_minor_unit: z.number(),
+  /** Decimal separator character (e.g., '.', ',') */
+  currency_decimal_separator: z.string(),
+  /** Thousands separator character (e.g., ',', '.') */
+  currency_thousand_separator: z.string(),
+  /** Currency symbol prefix (empty if symbol is suffix) */
+  currency_prefix: z.string(),
+  /** Currency symbol suffix (empty if symbol is prefix) */
+  currency_suffix: z.string()
+});
+var productImageSchema = z.object({
+  /** Alternative text for the image */
+  alt: z.string(),
+  /** Image unique identifier */
+  id: z.number(),
+  /** Image filename */
+  name: z.string(),
+  /** Available image sizes in JSON format */
+  sizes: z.string(),
+  /** Full-size image URL */
+  src: z.string().url(),
+  /** Srcset attribute for responsive images */
+  srcset: z.string(),
+  /** Thumbnail image URL */
+  thumbnail: z.string().url()
+});
+var cartItemImageSchema = z.object({
+  /** Image ID */
+  id: z.number(),
+  /** Full image URL */
+  src: z.string(),
+  /** Thumbnail URL */
+  thumbnail: z.string(),
+  /** Responsive image srcset */
+  srcset: z.string(),
+  /** Responsive image sizes */
+  sizes: z.string(),
+  /** Image name */
+  name: z.string(),
+  /** Image alt text */
+  alt: z.string()
+});
+var pricesSchema = z.object({
+  /** Current active price (sale price if on sale, otherwise regular) */
+  price: z.string(),
+  /** Regular price (before any discounts) */
+  regular_price: z.string(),
+  /** Sale price (empty string if not on sale) */
+  sale_price: z.string(),
+  /** Price range for variable products (null for simple products) */
+  price_range: z.object({
+    min_amount: z.string(),
+    max_amount: z.string()
+  }).nullable(),
+  /** Raw price data without formatting */
+  raw_prices: z.object({
+    /** Decimal precision */
+    precision: z.number(),
+    /** Raw price value */
+    price: z.string(),
+    /** Raw regular price value */
+    regular_price: z.string(),
+    /** Raw sale price value */
+    sale_price: z.string()
+  }).optional()
+}).merge(moneySchema);
+
+// src/schemas/store-api/cart-item.schema.ts
+var itemTotalsSchema = z.object({
+  /** Subtotal before taxes */
+  line_subtotal: z.string(),
+  /** Tax amount on subtotal */
+  line_subtotal_tax: z.string(),
+  /** Total after discounts, before taxes */
+  line_total: z.string(),
+  /** Tax amount on total */
+  line_total_tax: z.string()
+}).merge(moneySchema);
+var cartItemSchema = z.object({
+  /** Unique cart item key (use this for update/remove operations) */
+  key: z.string(),
+  /** Product ID */
+  id: z.number(),
+  /** Quantity of this item in cart */
+  quantity: z.number(),
+  /** Quantity limits for this product */
+  quantity_limits: z.object({
+    /** Minimum quantity allowed */
+    minimum: z.number(),
+    /** Maximum quantity allowed */
+    maximum: z.number(),
+    /** Quantity must be multiple of this value */
+    multiple_of: z.number(),
+    /** Whether quantity can be changed */
+    editable: z.boolean()
+  }),
+  /** Product name */
+  name: z.string(),
+  /** Short product description */
+  short_description: z.string(),
+  /** Full product description */
+  description: z.string(),
+  /** Product SKU */
+  sku: z.string(),
+  /** Remaining stock count if low (null if not low or unlimited) */
+  low_stock_remaining: z.number().nullable(),
+  /** Whether backorders are allowed */
+  backorders_allowed: z.boolean(),
+  /** Whether to show backorder badge */
+  show_backorder_badge: z.boolean(),
+  /** Whether product can only be purchased individually */
+  sold_individually: z.boolean(),
+  /** Product permalink URL */
+  permalink: z.string(),
+  /** Product images */
+  images: z.array(cartItemImageSchema),
+  /** Variation attributes (for variable products) */
+  variation: z.array(
+    z.object({
+      /** Attribute name (e.g., 'Color', 'Size') */
+      attribute: z.string(),
+      /** Selected value (e.g., 'Red', 'Large') */
+      value: z.string()
+    })
+  ),
+  /** Additional item data/metadata */
+  item_data: z.array(
+    z.object({
+      key: z.string(),
+      value: z.string()
+    })
+  ),
+  /** Product pricing information */
+  prices: pricesSchema,
+  /** Line item totals */
+  totals: itemTotalsSchema,
+  /** Catalog visibility setting */
+  catalog_visibility: z.string(),
+  /** Product type */
+  type: z.enum(["simple", "variable", "grouped", "external"]),
+  /** Extension data from plugins */
+  extensions: z.record(z.string(), z.unknown())
+});
+var cartTotalsSchema = z.object({
+  /** Total of all cart items (before discounts and taxes) */
+  total_items: z.string(),
+  /** Tax on cart items */
+  total_items_tax: z.string(),
+  /** Total fees */
+  total_fees: z.string(),
+  /** Tax on fees */
+  total_fees_tax: z.string(),
+  /** Total discount amount from coupons */
+  total_discount: z.string(),
+  /** Tax on discounts */
+  total_discount_tax: z.string(),
+  /** Shipping cost (null if not calculated yet) */
+  total_shipping: z.string().nullable(),
+  /** Shipping tax (null if not calculated yet) */
+  total_shipping_tax: z.string().nullable(),
+  /** Final total price (includes all taxes and fees) */
+  total_price: z.string(),
+  /** Total tax amount */
+  total_tax: z.string(),
+  /** Tax breakdown by rate */
+  tax_lines: z.array(
+    z.object({
+      /** Tax rate name */
+      name: z.string(),
+      /** Tax amount */
+      price: z.string(),
+      /** Tax rate percentage */
+      rate: z.string()
+    })
+  )
+}).merge(moneySchema);
+var cartCouponSchema = z.object({
+  /** Coupon code */
+  code: z.string(),
+  /** Discount totals for this coupon */
+  totals: z.object({
+    /** Total discount amount (before tax) */
+    total_discount: z.string(),
+    /** Tax amount on discount */
+    total_discount_tax: z.string()
+  }).merge(moneySchema)
+});
+var shippingRateSchema = z.object({
+  /** Unique rate identifier (format: instance_id:method_id) */
+  rate_id: z.string(),
+  /** Shipping method name */
+  name: z.string(),
+  /** Shipping method description */
+  description: z.string(),
+  /** Estimated delivery time */
+  delivery_time: z.string(),
+  /** Shipping cost */
+  price: z.string(),
+  /** Shipping instance ID */
+  instance_id: z.number(),
+  /** Shipping method ID */
+  method_id: z.string(),
+  /** Additional metadata for this shipping method */
+  meta_data: z.array(
+    z.object({
+      key: z.string(),
+      value: z.string()
+    })
+  ),
+  /** Whether this rate is currently selected */
+  selected: z.boolean(),
+  /** Currency code for the price */
+  currency_code: z.string(),
+  /** Currency symbol for the price */
+  currency_symbol: z.string()
+});
+var shippingPackageSchema = z.object({
+  /** Package identifier (0-indexed) */
+  package_id: z.number(),
+  /** Package name/label */
+  name: z.string(),
+  /** Shipping destination address */
+  destination: z.object({
+    address_1: z.string(),
+    address_2: z.string().optional(),
+    city: z.string(),
+    state: z.string(),
+    postcode: z.string(),
+    country: z.string()
+  }),
+  /** Items included in this package */
+  items: z.array(
+    z.object({
+      /** Cart item key */
+      key: z.string(),
+      /** Product name */
+      name: z.string(),
+      /** Quantity in package */
+      quantity: z.number()
+    })
+  ),
+  /** Available shipping rates for this package */
+  shipping_rates: z.array(shippingRateSchema)
+});
+
+// src/schemas/store-api/cart.ts
+var cartSchema = z.object({
+  items: z.array(cartItemSchema),
+  items_count: z.number(),
+  items_weight: z.number(),
+  needs_payment: z.boolean(),
+  needs_shipping: z.boolean(),
+  payment_methods: z.array(z.enum(["cod", "monri"])),
+  payment_requirements: z.array(z.string()),
+  has_calculated_shipping: z.boolean(),
+  shipping_address: addressSchemaNonMandatory,
+  billing_address: billingAddressSchemaNonMandatory,
+  shipping_rates: z.array(shippingPackageSchema),
+  coupons: z.array(cartCouponSchema),
+  totals: cartTotalsSchema,
+  errors: z.array(
+    z.object({
+      code: z.string(),
+      message: z.string()
+    })
+  ),
+  extensions: z.record(z.string(), z.unknown()).optional(),
+  cross_sells: z.array(z.unknown()),
+  fees: z.array(z.unknown())
+});
+z.object({
+  id: z.number(),
+  quantity: z.number().int().positive(),
+  variation: z.array(
+    z.object({
+      attribute: z.string(),
+      value: z.string()
+    })
+  ).optional()
+});
+z.object({
+  key: z.string(),
+  quantity: z.number().int().positive()
+});
+z.object({
+  key: z.string()
+});
+z.object({
+  code: z.string().min(1)
+});
+z.object({
+  billing_address: billingAddressSchemaMandatory.partial(),
+  shipping_address: addressSchema.partial()
+}).partial();
+z.object({
+  package_id: z.union([z.number(), z.string()]).default(0),
+  rate_id: z.string()
+});
+var orderItemImageSchema = z.object({
+  /** Image ID */
+  id: z.number(),
+  /** Full image URL */
+  src: z.string().url(),
+  /** Thumbnail URL */
+  thumbnail: z.string().url(),
+  /** Responsive image srcset */
+  srcset: z.string(),
+  /** Responsive image sizes attribute */
+  sizes: z.string(),
+  /** Image name */
+  name: z.string(),
+  /** Image alt text */
+  alt: z.string()
+});
+var orderItemPricesSchema = z.object({
+  /** Formatted price (current price) */
+  price: z.string(),
+  /** Formatted regular price */
+  regular_price: z.string(),
+  /** Formatted sale price */
+  sale_price: z.string(),
+  /** Price range (null for simple products) */
+  price_range: z.null(),
+  /** Currency code (e.g., 'USD', 'EUR') */
+  currency_code: z.string(),
+  /** Currency symbol (e.g., '$', '€') */
+  currency_symbol: z.string(),
+  /** Number of decimal places for currency */
+  currency_minor_unit: z.number(),
+  /** Decimal separator (e.g., '.', ',') */
+  currency_decimal_separator: z.string(),
+  /** Thousand separator (e.g., ',', '.') */
+  currency_thousand_separator: z.string(),
+  /** Currency prefix (e.g., '$') */
+  currency_prefix: z.string(),
+  /** Currency suffix (e.g., 'USD') */
+  currency_suffix: z.string(),
+  /** Raw price values for calculations */
+  raw_prices: z.object({
+    /** Precision for price calculations */
+    precision: z.number(),
+    /** Raw price (in minor units) */
+    price: z.string(),
+    /** Raw regular price (in minor units) */
+    regular_price: z.string(),
+    /** Raw sale price (in minor units) */
+    sale_price: z.string()
+  })
+});
+var orderItemTotalsSchema = z.object({
+  /** Line subtotal (before discounts) */
+  line_subtotal: z.string(),
+  /** Line subtotal tax */
+  line_subtotal_tax: z.string(),
+  /** Line total (after discounts) */
+  line_total: z.string(),
+  /** Line total tax */
+  line_total_tax: z.string(),
+  /** Currency code */
+  currency_code: z.string(),
+  /** Currency symbol */
+  currency_symbol: z.string(),
+  /** Currency minor unit */
+  currency_minor_unit: z.number(),
+  /** Decimal separator */
+  currency_decimal_separator: z.string(),
+  /** Thousand separator */
+  currency_thousand_separator: z.string(),
+  /** Currency prefix */
+  currency_prefix: z.string(),
+  /** Currency suffix */
+  currency_suffix: z.string()
+});
+var quantityLimitsSchema = z.object({
+  /** Minimum quantity allowed */
+  minimum: z.number(),
+  /** Maximum quantity allowed */
+  maximum: z.number(),
+  /** Quantity must be multiple of this value */
+  multiple_of: z.number(),
+  /** Whether quantity is editable */
+  editable: z.boolean()
+});
+var orderItemSchema = z.object({
+  /** Unique cart/order item key */
+  key: z.string(),
+  /** Product ID */
+  id: z.number(),
+  /** Quantity ordered */
+  quantity: z.number(),
+  /** Quantity limits for this product */
+  quantity_limits: quantityLimitsSchema,
+  /** Product name */
+  name: z.string(),
+  /** Short description */
+  short_description: z.string(),
+  /** Full description */
+  description: z.string(),
+  /** Product SKU */
+  sku: z.string(),
+  /** Low stock warning (null if not low) */
+  low_stock_remaining: z.null(),
+  /** Whether backorders are allowed */
+  backorders_allowed: z.boolean(),
+  /** Whether to show backorder badge */
+  show_backorder_badge: z.boolean(),
+  /** Whether product can only be purchased individually */
+  sold_individually: z.boolean(),
+  /** Product permalink URL */
+  permalink: z.string().url(),
+  /** Product images */
+  images: z.array(orderItemImageSchema),
+  /** Variation attributes (empty for simple products) */
+  variation: z.array(z.unknown()),
+  /** Custom item data/metadata */
+  item_data: z.array(z.unknown()),
+  /** Price information */
+  prices: orderItemPricesSchema,
+  /** Totals for this line item */
+  totals: orderItemTotalsSchema,
+  /** Catalog visibility setting */
+  catalog_visibility: z.string()
+});
+var orderTotalsSchema = z.object({
+  /** Subtotal (before discounts and fees) */
+  subtotal: z.string(),
+  /** Total discount amount */
+  total_discount: z.string(),
+  /** Total shipping cost */
+  total_shipping: z.string(),
+  /** Total fees */
+  total_fees: z.string(),
+  /** Total tax */
+  total_tax: z.string(),
+  /** Total refund amount */
+  total_refund: z.string(),
+  /** Final total price */
+  total_price: z.string(),
+  /** Total items cost (subtotal after item-level discounts) */
+  total_items: z.string(),
+  /** Tax on items */
+  total_items_tax: z.string(),
+  /** Tax on fees */
+  total_fees_tax: z.string(),
+  /** Tax on discounts */
+  total_discount_tax: z.string(),
+  /** Tax on shipping */
+  total_shipping_tax: z.string(),
+  /** Tax line items breakdown */
+  tax_lines: z.array(z.unknown()),
+  /** Currency code (e.g., 'USD', 'EUR', 'BAM') */
+  currency_code: z.string(),
+  /** Currency symbol (e.g., '$', '€', 'KM') */
+  currency_symbol: z.string(),
+  /** Number of decimal places for currency */
+  currency_minor_unit: z.number(),
+  /** Decimal separator (e.g., '.', ',') */
+  currency_decimal_separator: z.string(),
+  /** Thousand separator (e.g., ',', '.') */
+  currency_thousand_separator: z.string(),
+  /** Currency prefix (e.g., '$') */
+  currency_prefix: z.string(),
+  /** Currency suffix (e.g., 'USD') */
+  currency_suffix: z.string()
+});
+
+// src/schemas/store-api/order.schema.ts
+var orderStatusEnum = z.enum([
+  "pending",
+  // Order received, awaiting payment
+  "processing",
+  // Payment received, order is being processed
+  "on-hold",
+  // Order on hold, awaiting confirmation
+  "completed",
+  // Order fulfilled and complete
+  "cancelled",
+  // Order cancelled by customer or admin
+  "refunded",
+  // Order refunded
+  "failed"
+  // Payment failed or order declined
+]);
+var storeApiOrderSchema = z.object({
+  /** Order ID */
+  id: z.number(),
+  /** Order status */
+  status: orderStatusEnum,
+  /** Order line items (products purchased) */
+  items: z.array(orderItemSchema),
+  /** Applied coupons */
+  coupons: z.array(z.unknown()),
+  /** Order fees */
+  fees: z.array(z.unknown()),
+  /** Order totals breakdown */
+  totals: orderTotalsSchema,
+  /** Shipping address */
+  shipping_address: addressSchema,
+  /** Billing address (includes email) */
+  billing_address: billingAddressSchemaMandatory,
+  /** Whether order still needs payment */
+  needs_payment: z.boolean(),
+  /** Whether order needs shipping */
+  needs_shipping: z.boolean(),
+  /** Payment method requirements */
+  payment_requirements: z.array(z.string()),
+  /** Order errors (if any) */
+  errors: z.array(z.unknown()),
+  /** Payment method (optional - returned from checkout) */
+  payment_method: z.string().optional(),
+  /** Payment method title (optional - returned from checkout) */
+  payment_method_title: z.string().optional()
+});
+var checkoutSchema = z.object({
+  order_id: z.number(),
+  status: z.string(),
+  order_key: z.string(),
+  customer_note: z.string(),
+  customer_id: z.number(),
+  billing_address: billingAddressSchemaNonMandatory,
+  shipping_address: addressSchemaNonMandatory,
+  payment_method: z.string(),
+  payment_result: z.object({
+    payment_status: z.string(),
+    payment_details: z.array(z.unknown()),
+    redirect_url: z.string()
+  })
+});
+z.object({
+  payment_method: z.string(),
+  payment_data: z.array(
+    z.object({
+      key: z.string(),
+      value: z.union([z.string(), z.boolean()])
+    })
+  ).optional(),
+  billing_address: billingAddressSchemaMandatory.optional(),
+  shipping_address: addressSchema.optional(),
+  customer_note: z.string().optional(),
+  create_account: z.boolean().optional(),
+  extensions: z.record(z.string(), z.unknown()).optional()
+});
+var addToCartSchema = z.object({
+  /** Description for add to cart action */
+  description: z.string(),
+  /** Maximum quantity that can be added */
+  maximum: z.number(),
+  /** Minimum quantity that can be added */
+  minimum: z.number(),
+  /** Quantity must be a multiple of this number */
+  multiple_of: z.number(),
+  /** Text for add to cart button */
+  text: z.string(),
+  /** URL for add to cart action */
+  url: z.string()
+});
+var embeddedCategorySchema = z.object({
+  /** Category unique identifier */
+  id: z.number(),
+  /** Category display name */
+  name: z.string(),
+  /** URL-friendly category identifier */
+  slug: z.string(),
+  /** Link to category page */
+  link: z.string(),
+  /** Parent category ID (0 for root categories) - optional in embedded */
+  parent: z.number().optional(),
+  /** Category description - optional in embedded */
+  description: z.string().optional(),
+  /** Display type - optional in embedded */
+  display: z.string().optional(),
+  /** Category image - optional in embedded */
+  image: productImageSchema.nullable().optional(),
+  /** Menu order for sorting - optional in embedded */
+  menu_order: z.number().optional(),
+  /** Number of products in this category - optional in embedded */
+  count: z.number().optional()
+});
+var productCategorySchema = z.object({
+  /** Category unique identifier */
+  id: z.number(),
+  /** Category display name */
+  name: z.string(),
+  /** URL-friendly category identifier */
+  slug: z.string(),
+  /** Parent category ID (0 for root categories) */
+  parent: z.number(),
+  /** Category description */
+  description: z.string(),
+  /** Category image */
+  image: productImageSchema.nullable(),
+  /** Menu order for sorting */
+  menu_order: z.number().optional(),
+  /** Number of products in this category */
+  count: z.number()
+});
+
+// src/schemas/store-api/products.ts
+var productSchema = z.object({
+  id: z.number(),
+  name: z.string(),
+  slug: z.string(),
+  type: z.string(),
+  variation: z.string(),
+  permalink: z.string().url(),
+  sku: z.string(),
+  short_description: z.string(),
+  description: z.string(),
+  is_purchasable: z.boolean(),
+  is_in_stock: z.boolean(),
+  is_on_backorder: z.boolean(),
+  low_stock_remaining: z.number().nullable(),
+  sold_individually: z.boolean(),
+  add_to_cart: addToCartSchema,
+  has_options: z.boolean(),
+  on_sale: z.boolean(),
+  parent: z.number(),
+  attributes: z.array(z.unknown()),
+  categories: z.array(embeddedCategorySchema),
+  tags: z.array(z.unknown()),
+  images: z.array(productImageSchema),
+  variations: z.array(z.unknown()),
+  price_html: z.string(),
+  prices: pricesSchema,
+  average_rating: z.string(),
+  review_count: z.number(),
+  extensions: z.record(z.string(), z.unknown())
+});
+
+// src/api/cart.ts
+var createCartAPI = (client, endpoints, options) => ({
+  get: async () => {
+    const response = await client.get(endpoints.cart);
+    return handleApiResponse(response, cartSchema, options);
+  },
+  addItem: async (input) => {
+    const response = await client.post(endpoints.addItem, input);
+    return handleApiResponse(response, cartSchema, options);
+  },
+  updateItem: async (input) => {
+    const response = await client.post(endpoints.updateItem, input);
+    return handleApiResponse(response, cartSchema, options);
+  },
+  removeItem: async (input) => {
+    const response = await client.post(endpoints.removeItem, input);
+    return handleApiResponse(response, cartSchema, options);
+  },
+  applyCoupon: async (input) => {
+    const response = await client.post(endpoints.applyCoupon, input);
+    return handleApiResponse(response, cartSchema, options);
+  },
+  removeCoupon: async (input) => {
+    const response = await client.post(endpoints.removeCoupon, input);
+    return handleApiResponse(response, cartSchema, options);
+  },
+  updateCustomer: async (input) => {
+    const response = await client.post(endpoints.updateCustomer, input);
+    return handleApiResponse(response, cartSchema, options);
+  },
+  selectShippingRate: async (input) => {
+    const response = await client.post(endpoints.selectShippingRate, input);
+    return handleApiResponse(response, cartSchema, options);
+  }
+});
+
+// src/api/checkout.ts
+var createCheckoutAPI = (client, endpoints, options) => ({
+  get: async () => {
+    const response = await client.get(endpoints.checkout);
+    return handleApiResponse(response, checkoutSchema, options);
+  },
+  process: async (input) => {
+    const response = await client.post(endpoints.checkout, input);
+    return handleApiResponse(response, checkoutSchema, options);
+  }
+});
+
+// src/api/orders.ts
+var createOrdersAPI = (client, endpoints, options) => ({
+  /**
+   * Get a single order by ID
+   * Uses Store API - supports guest lookup with billing_email + key
+   */
+  get: async (input) => {
+    const { id, billing_email, key } = input;
+    const params = billing_email && key ? { billing_email, key } : void 0;
+    const response = await client.get(`${endpoints.order}/${id}`, { params });
+    return handleApiResponse(response, storeApiOrderSchema, options);
+  }
+});
+var createProductsAPI = (client, endpoints, options) => ({
+  list: async (params) => {
+    const response = await client.get(endpoints.products, { params });
+    return handlePaginatedApiResponse(response, z.array(productSchema), params, options);
+  },
+  get: async (id) => {
+    const response = await client.get(`${endpoints.products}/${id}`);
+    return handleApiResponse(response, productSchema, options);
+  },
+  categories: async () => {
+    const response = await client.get(endpoints.categories);
+    return handleApiResponse(response, z.array(productCategorySchema), options);
+  }
+});
+
+// src/constants/endpoints.ts
+var createEndpoints = (version = "legacy") => {
+  const prefix = version === "v1" ? "/wc/store/v1" : "/wc/store";
+  return {
+    // Products
+    products: `${prefix}/products`,
+    categories: `${prefix}/products/categories`,
+    // Cart
+    cart: `${prefix}/cart`,
+    addItem: `${prefix}/cart/add-item`,
+    updateItem: `${prefix}/cart/update-item`,
+    removeItem: `${prefix}/cart/remove-item`,
+    applyCoupon: `${prefix}/cart/apply-coupon`,
+    removeCoupon: `${prefix}/cart/remove-coupon`,
+    updateCustomer: `${prefix}/cart/update-customer`,
+    selectShippingRate: `${prefix}/cart/select-shipping-rate`,
+    // Checkout
+    checkout: `${prefix}/checkout`,
+    // Orders
+    order: `${prefix}/order`
+  };
+};
+
+// src/client/createClient.ts
+var DEFAULT_ERROR_REPORTER = {
+  report: (error2) => {
+    console.error("[woocommerce-utils]", error2);
+  }
+};
+var createClient = (config) => {
+  const fullConfig = {
+    ...config,
+    errorReporter: config.errorReporter ?? DEFAULT_ERROR_REPORTER
+  };
+  const axiosInstance = axios.create({
+    baseURL: fullConfig.baseURL,
+    timeout: fullConfig.timeout || 3e4,
+    headers: {
+      "Content-Type": "application/json",
+      ...fullConfig.headers
+    }
+  });
+  const endpoints = createEndpoints(fullConfig.storeApiVersion ?? "legacy");
+  const responseOptions = {
+    validationMode: fullConfig.validationMode,
+    errorReporter: fullConfig.errorReporter?.report,
+    onValidationError: fullConfig.onValidationError
+  };
+  const client = {
+    config: fullConfig,
+    axios: axiosInstance,
+    products: createProductsAPI(axiosInstance, endpoints, responseOptions),
+    cart: createCartAPI(axiosInstance, endpoints, responseOptions),
+    checkout: createCheckoutAPI(axiosInstance, endpoints, responseOptions),
+    orders: createOrdersAPI(axiosInstance, endpoints, responseOptions)
+  };
+  setupRequestInterceptor(axiosInstance, fullConfig, client);
+  setupResponseInterceptor(axiosInstance, fullConfig, client);
+  setupErrorInterceptor(axiosInstance, fullConfig, client);
+  return client;
+};
+
+export { createClient };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map