@thorprovider/adapters 4.3.0 → 5.0.0

package/src/providers/woocommerce/index.ts

@@ -1,310 +0,0 @@
-/**
- * @thorprovider/adapters — WooCommerce Provider
- * Implements CommerceProvider for WooCommerce Store API + REST API v3
- *
- * Store API: Unauthenticated, cookie-based sessions — products, cart, checkout
- * REST API v3: Authenticated via Application Passwords — customers, orders
- */
-
-import type {
-  Product,
-  GetProductsOptions,
-  Cart,
-  CartLineInput,
-  CartLineUpdate,
-  Collection,
-  CollectionProductsOptions,
-  GetCollectionsOptions,
-  ProductCategory,
-  GetCategoriesOptions,
-  Order,
-  GetOrdersOptions,
-  Customer,
-  Address,
-  PaymentMethod,
-  PaymentMethodsOptions,
-  ShippingMethod,
-  StockLocation,
-  InventoryLevel,
-  StockValidation,
-  FulfillmentOption,
-  StorefrontContext,
-  BackendCapabilities,
-} from '@thorprovider/types';
-import type { CommerceProvider, ProviderConfig } from '../../types/provider';
-import { WOOCOMMERCE_CAPABILITIES } from '../../types/capabilities.types';
-import { createLogger } from '../../core/logger';
-import { ProviderAPIError } from '../../core/errors';
-import { transformProduct, transformCart, transformCollection, transformOrder } from './transforms';
-
-/**
- * WooCommerce provider configuration
- */
-export interface WooCommerceProviderConfig extends ProviderConfig {
-  /** WordPress site URL (e.g., 'https://mystore.com') */
-  url: string;
-  /** WooCommerce REST API consumer key (for authenticated operations) */
-  consumerKey?: string;
-  /** WooCommerce REST API consumer secret (for authenticated operations) */
-  consumerSecret?: string;
-  /** Default currency code (default: 'USD') */
-  currencyCode?: string;
-}
-
-export class WooCommerceProvider implements CommerceProvider {
-  readonly name = 'woocommerce';
-  readonly version = '1.0.0';
-  readonly capabilities: BackendCapabilities = WOOCOMMERCE_CAPABILITIES;
-
-  private logger: ReturnType<typeof createLogger>;
-  private baseUrl: string;
-  private storeApiBase: string;
-  private restApiBase: string;
-  private currencyCode: string;
-  private authHeader?: string;
-
-  constructor(config: WooCommerceProviderConfig) {
-    this.logger = createLogger('WooCommerceProvider', config.debug);
-    this.baseUrl = config.url.replace(/\/$/, '');
-    this.storeApiBase = `${this.baseUrl}/wp-json/wc/store/v1`;
-    this.restApiBase = `${this.baseUrl}/wp-json/wc/v3`;
-    this.currencyCode = config.currencyCode ?? 'USD';
-
-    if (config.consumerKey && config.consumerSecret) {
-      this.authHeader = 'Basic ' + btoa(`${config.consumerKey}:${config.consumerSecret}`);
-    }
-
-    this.logger.info('Initializing WooCommerce Provider', { baseUrl: this.baseUrl });
-  }
-
-  private async storeApiFetch<T = any>(path: string, init?: RequestInit): Promise<T> {
-    const response = await fetch(`${this.storeApiBase}${path}`, {
-      ...init,
-      headers: { 'Content-Type': 'application/json', ...init?.headers },
-    });
-    if (!response.ok) {
-      throw new ProviderAPIError(`WooCommerce Store API error: ${response.status}`, 'WOOCOMMERCE_API_ERROR', response.status);
-    }
-    return response.json() as Promise<T>;
-  }
-
-  private async restApiFetch<T = any>(path: string, init?: RequestInit): Promise<T> {
-    if (!this.authHeader) {
-      throw new ProviderAPIError('WooCommerce REST API requires consumer key/secret.', 'WOOCOMMERCE_AUTH_REQUIRED');
-    }
-    const response = await fetch(`${this.restApiBase}${path}`, {
-      ...init,
-      headers: { 'Content-Type': 'application/json', 'Authorization': this.authHeader, ...init?.headers },
-    });
-    if (!response.ok) {
-      throw new ProviderAPIError(`WooCommerce REST API error: ${response.status}`, 'WOOCOMMERCE_API_ERROR', response.status);
-    }
-    return response.json() as Promise<T>;
-  }
-
-  // ============================================
-  // Product Operations (Store API)
-  // ============================================
-
-  async getProduct(handle: string): Promise<Product | undefined> {
-    try {
-      const products = await this.storeApiFetch<any[]>(`/products?slug=${encodeURIComponent(handle)}`);
-      return products[0] ? transformProduct(products[0], this.currencyCode) : undefined;
-    } catch {
-      return undefined;
-    }
-  }
-
-  async getProducts(options?: GetProductsOptions): Promise<Product[]> {
-    let path = `/products?per_page=${options?.first ?? 20}`;
-    if (options?.query) path += `&search=${encodeURIComponent(options.query)}`;
-    if (options?.sortKey) {
-      const [orderby, order] = options.sortKey.includes('-desc')
-        ? [options.sortKey.replace('-desc', ''), 'desc']
-        : [options.sortKey.replace('-asc', ''), 'asc'];
-      path += `&orderby=${orderby}&order=${order}`;
-    }
-    const products = await this.storeApiFetch<any[]>(path);
-    return products.map((p) => transformProduct(p, this.currencyCode));
-  }
-
-  async getProductRecommendations(_productId: string): Promise<Product[]> {
-    return [];
-  }
-
-  // ============================================
-  // Collection/Category Operations (Store API)
-  // ============================================
-
-  async getCollection(handle: string): Promise<Collection | undefined> {
-    try {
-      const cats = await this.storeApiFetch<any[]>(`/products/categories?slug=${encodeURIComponent(handle)}`);
-      return cats[0] ? transformCollection(cats[0]) : undefined;
-    } catch {
-      return undefined;
-    }
-  }
-
-  async getCollections(options?: GetCollectionsOptions): Promise<Collection[]> {
-    const cats = await this.storeApiFetch<any[]>(`/products/categories?per_page=${options?.limit ?? 50}`);
-    return cats.map(transformCollection);
-  }
-
-  async getCollectionProducts(handle: string, options?: CollectionProductsOptions): Promise<Product[]> {
-    const products = await this.storeApiFetch<any[]>(
-      `/products?category=${encodeURIComponent(handle)}&per_page=${options?.first ?? 20}`,
-    );
-    return products.map((p) => transformProduct(p, this.currencyCode));
-  }
-
-  async getCategory(idOrHandle: string): Promise<ProductCategory | undefined> {
-    return this.getCollection(idOrHandle) as any;
-  }
-
-  async getCategories(options?: GetCategoriesOptions): Promise<ProductCategory[]> {
-    return this.getCollections(options) as any;
-  }
-
-  async getCategoryProducts(handle: string, options?: CollectionProductsOptions): Promise<Product[]> {
-    return this.getCollectionProducts(handle, options);
-  }
-
-  // ============================================
-  // Cart Operations (Store API)
-  // ============================================
-
-  async createCart(): Promise<Cart> {
-    const cart = await this.storeApiFetch<any>('/cart');
-    return transformCart(cart, this.currencyCode);
-  }
-
-  async getCart(_cartId: string): Promise<Cart | undefined> {
-    try {
-      const cart = await this.storeApiFetch<any>('/cart');
-      return transformCart(cart, this.currencyCode);
-    } catch {
-      return undefined;
-    }
-  }
-
-  async addToCart(_cartId: string, lines: CartLineInput[]): Promise<Cart> {
-    for (const line of lines) {
-      await this.storeApiFetch('/cart/add-item', {
-        method: 'POST',
-        body: JSON.stringify({ id: parseInt(line.merchandiseId, 10), quantity: line.quantity }),
-      });
-    }
-    const cart = await this.storeApiFetch<any>('/cart');
-    return transformCart(cart, this.currencyCode);
-  }
-
-  async removeFromCart(_cartId: string, lineIds: string[]): Promise<Cart> {
-    for (const key of lineIds) {
-      await this.storeApiFetch('/cart/remove-item', {
-        method: 'POST',
-        body: JSON.stringify({ key }),
-      });
-    }
-    const cart = await this.storeApiFetch<any>('/cart');
-    return transformCart(cart, this.currencyCode);
-  }
-
-  async updateCart(_cartId: string, lines: CartLineUpdate[]): Promise<Cart> {
-    for (const line of lines) {
-      await this.storeApiFetch('/cart/update-item', {
-        method: 'POST',
-        body: JSON.stringify({ key: line.id, quantity: line.quantity }),
-      });
-    }
-    const cart = await this.storeApiFetch<any>('/cart');
-    return transformCart(cart, this.currencyCode);
-  }
-
-  // ============================================
-  // Checkout Operations (Store API)
-  // ============================================
-
-  async completeCheckout(_cartId: string): Promise<Order> {
-    const result = await this.storeApiFetch<any>('/checkout', { method: 'POST', body: JSON.stringify({}) });
-    return transformOrder(result, this.currencyCode);
-  }
-
-  async getShippingMethods(_cartId: string): Promise<ShippingMethod[]> {
-    return [];
-  }
-
-  async getRegionCountries(): Promise<import('@thorprovider/types').Country[]> {
-    return [];
-  }
-
-  async addShippingMethod(_cartId: string, methodId: string): Promise<Cart> {
-    await this.storeApiFetch('/cart/select-shipping-rate', {
-      method: 'POST',
-      body: JSON.stringify({ rate_id: methodId }),
-    });
-    const cart = await this.storeApiFetch<any>('/cart');
-    return transformCart(cart, this.currencyCode);
-  }
-
-  async initiatePaymentSession(_cartId: string, _providerId: string): Promise<void> {
-    // WooCommerce handles payment during checkout POST
-  }
-
-  async applyDiscountCode(_cartId: string, code: string): Promise<Cart> {
-    await this.storeApiFetch('/cart/apply-coupon', {
-      method: 'POST',
-      body: JSON.stringify({ code }),
-    });
-    const cart = await this.storeApiFetch<any>('/cart');
-    return transformCart(cart, this.currencyCode);
-  }
-
-  async removeDiscountCode(_cartId: string, code: string): Promise<Cart> {
-    await this.storeApiFetch('/cart/remove-coupon', {
-      method: 'POST',
-      body: JSON.stringify({ code }),
-    });
-    const cart = await this.storeApiFetch<any>('/cart');
-    return transformCart(cart, this.currencyCode);
-  }
-
-  // ============================================
-  // Customer, Order, Payment, Inventory, Admin
-  // ============================================
-
-  async getOrders(_options: GetOrdersOptions): Promise<Order[]> {
-    return [];
-  }
-
-  async getPaymentMethods(_options: PaymentMethodsOptions): Promise<PaymentMethod[]> {
-    return [];
-  }
-
-  async getStockLocations(): Promise<StockLocation[]> { return []; }
-  async checkInventoryLevels(): Promise<InventoryLevel[]> { return []; }
-  async validateCartStock(): Promise<StockValidation> { return { allAvailable: true, unavailableItems: [] }; }
-  async getFulfillmentOptions(): Promise<FulfillmentOption[]> { return []; }
-
-  async cancelOrder(_orderId: string): Promise<Order> {
-    throw new ProviderAPIError('Order cancellation requires WooCommerce REST API v3.', 'WOOCOMMERCE_AUTH_REQUIRED');
-  }
-  async createFulfillment(_orderId: string): Promise<void> {
-    throw new ProviderAPIError('Fulfillment requires WooCommerce REST API v3.', 'WOOCOMMERCE_AUTH_REQUIRED');
-  }
-  async createRefund(_orderId: string): Promise<void> {
-    throw new ProviderAPIError('Refunds require WooCommerce REST API v3.', 'WOOCOMMERCE_AUTH_REQUIRED');
-  }
-  async getAdminOrders(): Promise<{ orders: Order[]; count: number }> { return { orders: [], count: 0 }; }
-
-  async getStorefrontContext(): Promise<StorefrontContext> {
-    return {
-      id: this.baseUrl,
-      name: `WooCommerce ${this.baseUrl}`,
-      platformType: 'woocommerce',
-      requiresProductScoping: false,
-      currencyCode: this.currencyCode,
-    };
-  }
-
-  isStorefrontRequired(): boolean { return false; }
-}

package/src/providers/woocommerce/transforms.ts

@@ -1,254 +0,0 @@
-/**
- * @thorprovider/adapters — WooCommerce Provider
- * Transform functions: WooCommerce Store API responses → @thorprovider/types
- */
-
-import type {
-  Product,
-  ProductVariant,
-  ProductOption,
-  Cart,
-  CartItem,
-  Collection,
-  Money,
-  Image,
-  Order,
-  OrderItem,
-  OrderStatus,
-  PaymentStatus,
-  FulfillmentStatus,
-  Customer,
-  Address,
-} from '@thorprovider/types';
-
-// ============================================
-// Money & Image Transforms
-// ============================================
-
-function transformMoney(amount: string | number | null | undefined, currencyCode: string = 'USD'): Money {
-  const numAmount = typeof amount === 'string' ? parseFloat(amount) : (amount ?? 0);
-  return {
-    amount: isNaN(numAmount) ? '0.00' : numAmount.toFixed(2),
-    currencyCode: currencyCode.toUpperCase(),
-  };
-}
-
-function transformImage(url: string, alt: string = ''): Image {
-  return { url, altText: alt, width: 800, height: 800 };
-}
-
-// ============================================
-// Product Transforms (Store API format)
-// ============================================
-
-export function transformProduct(raw: any, currencyCode: string = 'USD'): Product {
-  const images: Image[] = (raw.images ?? []).map((img: any) =>
-    transformImage(img.src ?? '', img.alt ?? img.name ?? ''),
-  );
-
-  const variants: ProductVariant[] = (raw.variations ?? []).map((v: any) => ({
-    id: String(v.id),
-    title: v.name ?? '',
-    availableForSale: v.in_stock !== false,
-    price: transformMoney(v.prices?.price ?? v.price, currencyCode),
-    compareAtPrice: v.prices?.regular_price
-      ? transformMoney(v.prices.regular_price, currencyCode)
-      : undefined,
-    selectedOptions: (v.attributes ?? []).map((attr: any) => ({
-      name: attr.name ?? '',
-      value: attr.value ?? '',
-    })),
-  }));
-
-  const options: ProductOption[] = (raw.attributes ?? [])
-    .filter((attr: any) => attr.variation === true || attr.has_options === true)
-    .map((attr: any) => ({
-      id: String(attr.id),
-      name: attr.name ?? '',
-      values: (attr.terms ?? attr.options ?? []).map((t: any) =>
-        typeof t === 'string' ? t : (t.name ?? t.value ?? ''),
-      ),
-    }));
-
-  // WooCommerce Store API prices are in minor units (cents)
-  const priceMinor = raw.prices?.price ?? '0';
-  const priceDecimalPlaces = raw.prices?.currency_minor_unit ?? 2;
-  const priceMajor = (parseInt(priceMinor, 10) / Math.pow(10, priceDecimalPlaces));
-
-  return {
-    id: String(raw.id),
-    handle: raw.slug ?? String(raw.id),
-    title: raw.name ?? '',
-    description: raw.short_description ?? raw.description ?? '',
-    descriptionHtml: raw.description ?? '',
-    availableForSale: raw.is_purchasable !== false && raw.is_in_stock !== false,
-    featuredImage: images[0] ?? { url: '', altText: '', width: 800, height: 800 },
-    images,
-    options,
-    variants,
-    priceRange: {
-      minVariantPrice: transformMoney(priceMajor, currencyCode),
-      maxVariantPrice: transformMoney(priceMajor, currencyCode),
-    },
-    seo: {
-      title: raw.name ?? '',
-      description: raw.short_description?.replace(/<[^>]*>/g, '') ?? '',
-    },
-    tags: [],
-    createdAt: raw.date_created ?? new Date().toISOString(),
-    updatedAt: raw.date_modified ?? new Date().toISOString(),
-  };
-}
-
-// ============================================
-// Collection Transforms (WooCom categories)
-// ============================================
-
-export function transformCollection(raw: any): Collection {
-  return {
-    id: String(raw.id ?? ''),
-    handle: raw.slug ?? String(raw.id),
-    title: raw.name ?? '',
-    description: raw.description ?? '',
-    seo: {
-      title: raw.name ?? '',
-      description: raw.description?.replace(/<[^>]*>/g, '') ?? '',
-    },
-    updatedAt: new Date().toISOString(),
-    path: `/collections/${raw.slug ?? raw.id}`,
-  };
-}
-
-// ============================================
-// Cart Transforms (Store API cart format)
-// ============================================
-
-export function transformCart(raw: any, currencyCode: string = 'USD'): Cart {
-  const lines: CartItem[] = (raw.items ?? []).map((item: any) => {
-    const minorUnit = item.prices?.currency_minor_unit ?? 2;
-    const divisor = Math.pow(10, minorUnit);
-    const lineTotal = (parseInt(item.totals?.line_total ?? '0', 10)) / divisor;
-
-    return {
-      id: item.key ?? String(item.id),
-      quantity: item.quantity ?? 1,
-      cost: {
-        totalAmount: transformMoney(lineTotal, currencyCode),
-      },
-      merchandise: {
-        id: String(item.id),
-        title: item.name ?? '',
-        selectedOptions: (item.variation ?? []).map((v: any) => ({
-          name: v.attribute ?? '',
-          value: v.value ?? '',
-        })),
-        product: {
-          id: String(item.id),
-          handle: item.slug ?? String(item.id),
-          title: item.name ?? '',
-          featuredImage: item.images?.[0]
-            ? transformImage(item.images[0].src, item.images[0].alt ?? '')
-            : { url: '', altText: '', width: 800, height: 800 },
-        },
-      },
-    };
-  });
-
-  const minorUnit = raw.totals?.currency_minor_unit ?? 2;
-  const divisor = Math.pow(10, minorUnit);
-  const subtotal = (parseInt(raw.totals?.total_items ?? '0', 10)) / divisor;
-  const total = (parseInt(raw.totals?.total_price ?? '0', 10)) / divisor;
-
-  return {
-    id: raw.cart_key ?? undefined,
-    checkoutUrl: '',  // WooCommerce handles checkout via its own /checkout page
-    totalQuantity: raw.items_count ?? lines.reduce((sum, l) => sum + l.quantity, 0),
-    cost: {
-      subtotalAmount: transformMoney(subtotal, currencyCode),
-      totalAmount: transformMoney(total, currencyCode),
-    },
-    lines,
-  };
-}
-
-// ============================================
-// Customer Transforms
-// ============================================
-
-export function transformCustomer(raw: any): Customer {
-  return {
-    id: String(raw.id),
-    email: raw.email ?? '',
-    firstName: raw.first_name ?? '',
-    lastName: raw.last_name ?? '',
-    phone: raw.billing?.phone ?? '',
-    hasAccount: true,
-  };
-}
-
-function transformWooAddress(raw: any): Address {
-  return {
-    id: undefined,
-    firstName: raw.first_name ?? '',
-    lastName: raw.last_name ?? '',
-    address1: raw.address_1 ?? '',
-    address2: raw.address_2 ?? '',
-    city: raw.city ?? '',
-    province: raw.state ?? '',
-    countryCode: raw.country ?? '',
-    postalCode: raw.postcode ?? '',
-    phone: raw.phone ?? '',
-    company: raw.company ?? '',
-  };
-}
-
-// ============================================
-// Order Transforms
-// ============================================
-
-export function transformOrder(raw: any, currencyCode: string = 'USD'): Order {
-  const items: OrderItem[] = (raw.line_items ?? []).map((item: any) => ({
-    id: String(item.id),
-    title: item.name ?? '',
-    quantity: item.quantity ?? 1,
-    price: transformMoney(item.price ?? 0, currencyCode),
-    total: transformMoney(item.total ?? 0, currencyCode),
-    productId: String(item.product_id),
-    variantId: item.variation_id ? String(item.variation_id) : undefined,
-  }));
-
-  const statusMap: Record<string, OrderStatus> = {
-    pending: 'pending',
-    processing: 'processing',
-    'on-hold': 'pending',
-    completed: 'completed',
-    cancelled: 'cancelled',
-    refunded: 'refunded',
-    failed: 'cancelled',
-  };
-
-  const paymentMap: Record<string, PaymentStatus> = {
-    pending: 'pending',
-    processing: 'authorized',
-    completed: 'paid',
-    refunded: 'refunded',
-  };
-
-  return {
-    id: String(raw.id),
-    orderNumber: String(raw.number ?? raw.id),
-    email: raw.billing?.email ?? '',
-    status: statusMap[raw.status] ?? 'pending',
-    paymentStatus: paymentMap[raw.status] ?? 'pending',
-    fulfillmentStatus: raw.status === 'completed' ? 'fulfilled' : 'unfulfilled',
-    items,
-    total: transformMoney(raw.total ?? 0, currencyCode),
-    subtotal: transformMoney(raw.subtotal ?? 0, currencyCode),
-    tax: transformMoney(raw.total_tax ?? 0, currencyCode),
-    shipping: transformMoney(raw.shipping_total ?? 0, currencyCode),
-    shippingAddress: raw.shipping ? transformWooAddress(raw.shipping) : undefined,
-    billingAddress: raw.billing ? transformWooAddress(raw.billing) : undefined,
-    createdAt: raw.date_created ?? new Date().toISOString(),
-    updatedAt: raw.date_modified ?? new Date().toISOString(),
-  };
-}

package/src/providers/woocommerce/woocommerce.ts

@@ -1,5 +0,0 @@
-/**
- * WooCommerce Provider — barrel exports
- */
-export { WooCommerceProvider } from './index';
-export type { WooCommerceProviderConfig } from './index';