@atomic-solutions/woocommerce-api-client 0.1.0

package/dist/utils/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/errors/classes/BaseError.ts","../../src/errors/classes/WooCommerceDataValidationError.ts","../../src/http/handleApiResponse.ts","../../src/utils/calculatePagination.ts","../../src/utils/getPaginationMeta.ts","../../src/http/handlePaginatedApiResponse.ts","../../src/logging/logger.ts","../../src/utils/initializeCartSession.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Base error class for all package errors\n *\n * Generic over:\n * - TOptions: The options type for this error class\n * - TReportable: The reportable data structure for error tracking\n */\nimport type { BaseErrorOptions, BaseReportableData } from './types';\n\nexport class BaseError<\n  TOptions extends BaseErrorOptions = BaseErrorOptions,\n  TReportable extends BaseReportableData = BaseReportableData,\n> extends Error {\n  constructor(public readonly options: TOptions) {\n    super(options.message);\n\n    // Maintain proper prototype chain\n    Object.setPrototypeOf(this, new.target.prototype);\n\n    // Set error name\n    this.name = this.constructor.name;\n\n    // Capture stack trace (excluding constructor call)\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, this.constructor);\n    }\n\n    // If there's a cause with a stack, preserve it\n    if (this.options.cause instanceof Error && this.options.cause.stack) {\n      this.stack = `${this.stack}\\nCaused by: ${this.options.cause.stack}`;\n    }\n  }\n\n  /**\n   * Get reportable data for error tracking/logging\n   * Subclasses should override this to add their own reportable fields\n   */\n  getReportableData(): TReportable {\n    const { code, operation, userMessage, retryable } = this.options;\n    return {\n      code,\n      operation,\n      userMessage,\n      retryable,\n    } as TReportable;\n  }\n\n  /**\n   * Custom JSON serialization\n   * Makes the error properly serializable for logging/reporting\n   */\n  toJSON(): Record<string, unknown> {\n    return {\n      ...this.getReportableData(),\n      name: this.name,\n      message: this.message,\n      stack: this.stack,\n    } as unknown as Record<string, unknown>;\n  }\n}\n","/**\n * WooCommerce validation error class\n * Thrown when API response validation fails\n */\n\nimport type { ZodError } from 'zod';\n\nimport { BaseError } from './BaseError';\nimport type {\n  BaseErrorOptions,\n  ValidationReportableData,\n  WooCommerceDataValidationErrorOptions,\n} from './types';\n\n/**\n * Internal options type that combines user options with computed fields\n */\ninterface WooCommerceDataValidationErrorInternalOptions extends BaseErrorOptions {\n  url?: string;\n  zodError?: ZodError;\n  value?: unknown;\n  fieldErrors?: Record<string, string[]>;\n}\n\n/**\n * WooCommerce validation error\n *\n * Thrown when API response validation fails using Zod schemas\n */\nexport class WooCommerceDataValidationError extends BaseError<\n  WooCommerceDataValidationErrorInternalOptions,\n  ValidationReportableData\n> {\n  constructor(options: WooCommerceDataValidationErrorOptions) {\n    // Extract field errors from Zod error if provided\n    const fieldErrors = options.zodError\n      ? WooCommerceDataValidationError.extractFieldErrorsFromZod(options.zodError)\n      : undefined;\n\n    super({\n      code: 'validation_error',\n      message: options.message,\n      operation: options.operation,\n      userMessage: options.userMessage || 'Received unexpected data from WooCommerce',\n      retryable: false,\n      cause: options.cause,\n      url: options.url,\n      zodError: options.zodError,\n      value: options.value,\n      fieldErrors,\n    });\n  }\n\n  // Convenient getters for validation-specific fields (no duplication)\n  get url(): string | undefined {\n    return this.options.url;\n  }\n\n  get zodError(): ZodError | undefined {\n    return this.options.zodError;\n  }\n\n  get invalidValue(): unknown | undefined {\n    return this.options.value;\n  }\n\n  get fieldErrors(): Record<string, string[]> | undefined {\n    return this.options.fieldErrors;\n  }\n\n  /**\n   * Get reportable data for error tracking/logging\n   * Includes validation-specific fields\n   */\n  override getReportableData(): ValidationReportableData {\n    return {\n      code: this.options.code,\n      operation: this.options.operation,\n      userMessage: this.options.userMessage,\n      retryable: false,\n      fieldErrors: this.options.fieldErrors,\n      url: this.options.url,\n    };\n  }\n\n  /**\n   * Extract field errors from Zod error\n   */\n  private static extractFieldErrorsFromZod(\n    zodError: ZodError\n  ): Record<string, string[]> | undefined {\n    if (!zodError?.errors) {\n      return undefined;\n    }\n\n    const fieldErrors: Record<string, string[]> = {};\n\n    for (const issue of zodError.errors) {\n      const path = issue.path.join('.');\n      if (!fieldErrors[path]) {\n        fieldErrors[path] = [];\n      }\n      fieldErrors[path].push(issue.message);\n    }\n\n    return fieldErrors;\n  }\n\n  /**\n   * Get all error messages as a flat array\n   */\n  getMessages(): string[] {\n    if (!this.fieldErrors) {\n      return [this.message];\n    }\n\n    const messages: string[] = [];\n    for (const fieldMessages of Object.values(this.fieldErrors)) {\n      messages.push(...fieldMessages);\n    }\n\n    return messages;\n  }\n\n  /**\n   * Check if a specific field has errors\n   */\n  hasFieldError(field: string): boolean {\n    return this.fieldErrors ? field in this.fieldErrors : false;\n  }\n\n  /**\n   * Get error messages for a specific field\n   */\n  getFieldError(field: string): string[] | undefined {\n    return this.fieldErrors?.[field];\n  }\n}\n","/**\n * Response validation utilities\n */\n\nimport type { AxiosResponse } from 'axios';\nimport type { ZodError, ZodSchema } from 'zod';\n\nimport { WooCommerceDataValidationError } from '@/errors';\n\n/**\n * Validation mode for API responses\n * - 'strict': Throw error on validation failure (default)\n * - 'warn': Log warning and continue on validation failure\n */\nexport type ValidationMode = 'strict' | 'warn';\n\n/**\n * Options for response handling\n */\nexport interface ResponseOptions {\n  /** Validation mode */\n  validationMode?: ValidationMode;\n\n  /** Error reporter for validation errors */\n  errorReporter?: (error: Error) => void;\n\n  /** Optional validation error handler (called before errorReporter) */\n  onValidationError?: (error: Error) => void;\n}\n\n/**\n * Handle and validate API response\n *\n * @param response - Axios response\n * @param schema - Zod schema for validation\n * @param options - Response handling options\n * @returns Validated data\n * @throws ValidationError if validation fails in strict mode\n */\nexport const handleApiResponse = <T>(\n  response: AxiosResponse,\n  schema: ZodSchema<T>,\n  options?: ResponseOptions\n): T => {\n  const validationMode = options?.validationMode ?? 'strict';\n\n  // Warn mode - use safeParse and continue on validation failure\n  if (validationMode === 'warn') {\n    const result = schema.safeParse(response.data);\n\n    if (!result.success) {\n      const validationError = new WooCommerceDataValidationError({\n        message: `WooCommerce API response validation failed for ${response.config.url || 'unknown endpoint'}`,\n        url: response.config.url,\n        zodError: result.error,\n        value: response.data,\n        userMessage: 'Received unexpected data from WooCommerce',\n      });\n\n      // Call optional validation error handler\n      options?.onValidationError?.(validationError);\n\n      // Report to error tracker (if provided)\n      options?.errorReporter?.(validationError);\n\n      // Log warning to console in warn mode\n      console.warn('[woocommerce-utils] Validation warning:', validationError.message);\n\n      // Return raw data to allow app to continue\n      return response.data as T;\n    }\n\n    return result.data;\n  }\n\n  // Strict mode - throw on validation failure\n  try {\n    return schema.parse(response.data);\n  } catch (error) {\n    if (error && typeof error === 'object' && 'issues' in error) {\n      const validationError = new WooCommerceDataValidationError({\n        message: `WooCommerce API response validation failed for ${response.config.url || 'unknown endpoint'}`,\n        url: response.config.url,\n        zodError: error as ZodError,\n        value: response.data,\n        userMessage: 'Received unexpected data from WooCommerce',\n      });\n\n      // Call optional validation error handler\n      options?.onValidationError?.(validationError);\n\n      // Report to error tracker (if provided)\n      options?.errorReporter?.(validationError);\n\n      throw validationError;\n    }\n    throw error;\n  }\n};\n\n/**\n * Check if error is a Zod validation error\n */\nexport const isZodError = (error: unknown): error is ZodError => {\n  return error instanceof Error && error.name === 'ZodError';\n};\n","/**\n * Calculate pagination navigation\n */\n\nexport interface Pagination {\n  page: number;\n  perPage: number;\n  total: number;\n  totalPages: number;\n  hasNextPage: boolean;\n  hasPrevPage: boolean;\n  nextPage: number | null;\n  prevPage: number | null;\n}\n\nexport interface CalculatePaginationInput {\n  page: number;\n  perPage: number;\n  total: number;\n  totalPages: number;\n}\n\n/**\n * Calculate pagination navigation from WooCommerce pagination metadata\n *\n * @param input - Current pagination state\n * @returns Full pagination object with navigation helpers\n */\nexport const calculatePagination = (input: CalculatePaginationInput): Pagination => {\n  const { page, perPage, total, totalPages } = input;\n\n  const hasNextPage = page < totalPages;\n  const hasPrevPage = page > 1;\n\n  return {\n    page,\n    perPage,\n    total,\n    totalPages,\n    hasNextPage,\n    hasPrevPage,\n    nextPage: hasNextPage ? page + 1 : null,\n    prevPage: hasPrevPage ? page - 1 : null,\n  };\n};\n","/**\n * Extract pagination metadata from WooCommerce response headers\n */\n\nimport type { AxiosResponse } from 'axios';\n\nexport interface PaginationMeta {\n  total: number;\n  totalPages: number;\n}\n\nexport const getPaginationMeta = (headers: AxiosResponse['headers']): PaginationMeta => {\n  // Handle undefined/null headers\n  if (!headers) {\n    return {\n      total: 0,\n      totalPages: 0,\n    };\n  }\n\n  const wpTotal = headers['x-wp-total'];\n  const wpTotalPages = headers['x-wp-totalpages'];\n\n  if (!wpTotal || !wpTotalPages) {\n    return {\n      total: 0,\n      totalPages: 0,\n    };\n  }\n\n  const total = parseInt(wpTotal, 10);\n  const totalPages = parseInt(wpTotalPages, 10);\n\n  return {\n    total,\n    totalPages,\n  };\n};\n","/**\n * Pagination utilities for WooCommerce API responses\n */\n\nimport type { AxiosResponse } from 'axios';\nimport type { ZodError, ZodSchema } from 'zod';\n\nimport { WooCommerceDataValidationError } from '../errors';\nimport { calculatePagination, type Pagination } from '../utils/calculatePagination';\nimport { getPaginationMeta } from '../utils/getPaginationMeta';\nimport type { ResponseOptions } from './handleApiResponse';\n\n/**\n * Paginated response wrapper\n */\nexport interface PaginatedResponse<T> {\n  data: T[];\n  pagination: Pagination;\n}\n\n/**\n * Handle paginated API response\n *\n * @param response - Axios response\n * @param schema - Zod schema for validating array items\n * @param params - Request parameters (page, per_page)\n * @param options - Response handling options\n * @returns Paginated response with validated data\n * @throws ValidationError if validation fails in strict mode\n */\nexport const handlePaginatedApiResponse = <T>(\n  response: AxiosResponse,\n  schema: ZodSchema<T[]>,\n  params: { page?: number; per_page?: number } = {},\n  options?: ResponseOptions\n): PaginatedResponse<T> => {\n  const validationMode = options?.validationMode ?? 'strict';\n  let data: T[];\n\n  // Warn mode - use safeParse and continue on validation failure\n  if (validationMode === 'warn') {\n    const result = schema.safeParse(response.data);\n\n    if (!result.success) {\n      const validationError = new WooCommerceDataValidationError({\n        message: `WooCommerce API response validation failed for ${response.config.url || 'unknown endpoint'}`,\n        url: response.config.url,\n        zodError: result.error,\n        value: response.data,\n        userMessage: 'Received unexpected data from WooCommerce',\n      });\n\n      // Call optional validation error handler\n      options?.onValidationError?.(validationError);\n\n      // Report to error tracker (if provided)\n      options?.errorReporter?.(validationError);\n\n      // Log warning to console in warn mode\n      console.warn('[woocommerce-utils] Validation warning:', validationError.message);\n\n      // Return raw data as array (best effort)\n      data = Array.isArray(response.data) ? response.data : [];\n    } else {\n      data = result.data;\n    }\n  } else {\n    // Strict mode - throw on validation failure\n    try {\n      data = schema.parse(response.data);\n    } catch (error) {\n      if (error && typeof error === 'object' && 'issues' in error) {\n        const validationError = new WooCommerceDataValidationError({\n          message: `WooCommerce API response validation failed for ${response.config.url || 'unknown endpoint'}`,\n          url: response.config.url,\n          zodError: error as ZodError,\n          value: response.data,\n          userMessage: 'Received unexpected data from WooCommerce',\n        });\n\n        // Call optional validation error handler\n        options?.onValidationError?.(validationError);\n\n        // Report to error tracker (if provided)\n        options?.errorReporter?.(validationError);\n\n        throw validationError;\n      }\n      throw error;\n    }\n  }\n\n  const { total, totalPages } = getPaginationMeta(response.headers);\n  const page = params.page || 1;\n  const perPage = params.per_page || 10;\n\n  const pagination = calculatePagination({\n    page,\n    perPage,\n    total,\n    totalPages,\n  });\n\n  return {\n    data,\n    pagination,\n  };\n};\n","/**\n * Debug logger for WooCommerce utils\n */\n\nconst DEBUG_PREFIX = '[woocommerce-utils]';\n\n/**\n * Check if debug mode is enabled\n */\nexport const isDebugEnabled = (): boolean => {\n  if (typeof process !== 'undefined' && process.env) {\n    return process.env.DEBUG === 'true' || process.env.DEBUG === '1';\n  }\n  return false;\n};\n\n/**\n * Log debug message (only if DEBUG is enabled)\n */\nexport const debug = (...args: unknown[]): void => {\n  if (isDebugEnabled()) {\n    console.log(DEBUG_PREFIX, ...args);\n  }\n};\n\n/**\n * Log warning message\n */\nexport const warn = (...args: unknown[]): void => {\n  console.warn(DEBUG_PREFIX, ...args);\n};\n\n/**\n * Log error message\n */\nexport const error = (...args: unknown[]): void => {\n  console.error(DEBUG_PREFIX, ...args);\n};\n","/**\n * Cart session initialization utility\n */\n\nimport type { AxiosInstance } from 'axios';\n\nimport type { CartHeadersAdapter } from '../client/types';\nimport { debug } from '../logging/logger';\n\n/**\n * Initialize cart session by fetching cart and saving headers\n *\n * This is called when nonce errors occur to get a fresh nonce/cart-token\n *\n * @param client - Axios instance\n * @param cartHeaders - Cart headers adapter\n */\nexport const initializeCartSession = async (\n  client: AxiosInstance,\n  cartHeaders: CartHeadersAdapter\n): Promise<void> => {\n  try {\n    debug('session', 'Initializing cart session');\n\n    // Make GET request to cart endpoint\n    const response = await client.get('/wc/store/v1/cart');\n\n    // Extract headers\n    const nonce = response.headers['nonce'] || response.headers['Nonce'];\n    const cartToken = response.headers['cart-token'] || response.headers['Cart-Token'];\n\n    // Save headers\n    if (nonce || cartToken) {\n      await cartHeaders.save({\n        nonce: nonce || undefined,\n        cartToken: cartToken || undefined,\n      });\n\n      debug('session', 'Cart session initialized', {\n        hasNonce: !!nonce,\n        hasCartToken: !!cartToken,\n      });\n    }\n  } catch (error) {\n    debug('session', 'Failed to initialize cart session', error);\n    throw error;\n  }\n};\n"]}

package/package.json

@@ -0,0 +1,117 @@
+{
+  "name": "@atomic-solutions/woocommerce-api-client",
+  "version": "0.1.0",
+  "description": "Type-safe WooCommerce API client (framework-agnostic)",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "import": "./dist/client/index.mjs",
+      "require": "./dist/client/index.js"
+    },
+    "./schemas": {
+      "types": "./dist/schemas/index.d.ts",
+      "import": "./dist/schemas/index.mjs",
+      "require": "./dist/schemas/index.js"
+    },
+    "./schemas/store-api": {
+      "types": "./dist/schemas/store-api/index.d.ts",
+      "import": "./dist/schemas/store-api/index.mjs",
+      "require": "./dist/schemas/store-api/index.js"
+    },
+    "./schemas/admin-api": {
+      "types": "./dist/schemas/admin-api/index.d.ts",
+      "import": "./dist/schemas/admin-api/index.mjs",
+      "require": "./dist/schemas/admin-api/index.js"
+    },
+    "./http": {
+      "types": "./dist/http/index.d.ts",
+      "import": "./dist/http/index.mjs",
+      "require": "./dist/http/index.js"
+    },
+    "./utils": {
+      "types": "./dist/utils/index.d.ts",
+      "import": "./dist/utils/index.mjs",
+      "require": "./dist/utils/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "woocommerce",
+    "ecommerce",
+    "store-api",
+    "admin-api",
+    "typescript",
+    "axios",
+    "client"
+  ],
+  "author": "Atomic Solutions",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/atomic-solutions/wordpress-woocommerce-monorepo",
+    "directory": "packages/woocommerce-utils"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "axios": ">=1.7.0",
+    "zod": ">=3.0.0"
+  },
+  "devDependencies": {
+    "@eslint/compat": "^1.3.2",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.35.0",
+    "@tanstack/react-query": "^5.59.19",
+    "@testing-library/react": "^14.0.0",
+    "@types/jsdom": "^27.0.0",
+    "@types/node": "^24.10.1",
+    "@types/react": "^18.0.0",
+    "@types/react-dom": "^18.0.0",
+    "@vitest/coverage-v8": "^2.0.0",
+    "axios": "^1.7.7",
+    "axios-mock-adapter": "^2.1.0",
+    "eslint": "^9.35.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "jsdom": "^27.2.0",
+    "nodemon": "^3.1.11",
+    "prettier": "^3.0.0",
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0",
+    "release-it": "^19.0.6",
+    "tsup": "^8.0.0",
+    "typescript": "^5.9.0",
+    "vitest": "^2.0.0",
+    "zod": "^3.23.0"
+  },
+  "sideEffects": false,
+  "dependencies": {
+    "@typescript-eslint/eslint-plugin": "^8.47.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "dev:yalc": "nodemon --watch src --ext ts --exec 'tsup && yalc push'",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "clean": "rm -rf dist"
+  }
+}