@thorprovider/adapters 4.2.1 → 5.0.0

package/src/providers/bigcommerce/transforms.ts

@@ -1,227 +0,0 @@
-/**
- * @thorprovider/adapters — BigCommerce Provider
- * Transform functions: BigCommerce REST API → @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: number | string | null | undefined, currencyCode: string = 'USD'): Money {
-  const numAmount = typeof amount === 'string' ? parseFloat(amount) : (amount ?? 0);
-  return {
-    amount: numAmount.toFixed(2),
-    currencyCode: currencyCode.toUpperCase(),
-  };
-}
-
-function transformImage(url: string, alt: string = ''): Image {
-  return { url, altText: alt, width: 800, height: 800 };
-}
-
-// ============================================
-// Product Transforms
-// ============================================
-
-export function transformProduct(raw: any, currencyCode: string = 'USD'): Product {
-  const images: Image[] = (raw.images ?? []).map((img: any) =>
-    transformImage(img.url_standard ?? img.url_thumbnail ?? '', img.description ?? ''),
-  );
-
-  const variants: ProductVariant[] = (raw.variants ?? []).map((v: any) => ({
-    id: String(v.id),
-    title: v.option_display_name ?? `Variant ${v.id}`,
-    availableForSale: (v.purchasing_disabled !== true),
-    price: transformMoney(v.price ?? raw.price, currencyCode),
-    compareAtPrice: v.sale_price ? transformMoney(v.sale_price, currencyCode) : undefined,
-    selectedOptions: (v.option_values ?? []).map((ov: any) => ({
-      name: ov.option_display_name ?? '',
-      value: ov.label ?? '',
-    })),
-  }));
-
-  const options: ProductOption[] = (raw.options ?? []).map((opt: any) => ({
-    id: String(opt.id),
-    name: opt.display_name ?? '',
-    values: (opt.option_values ?? []).map((val: any) => val.label ?? ''),
-  }));
-
-  const price = raw.price ?? raw.calculated_price?.as_entered ?? 0;
-
-  return {
-    id: String(raw.id),
-    handle: raw.custom_url?.url?.replace(/^\//, '').replace(/\/$/, '') ?? String(raw.id),
-    title: raw.name ?? '',
-    description: raw.plain_text_description ?? raw.description ?? '',
-    descriptionHtml: raw.description ?? '',
-    availableForSale: raw.availability === 'available' || raw.is_visible !== false,
-    featuredImage: images[0] ?? { url: '', altText: '', width: 800, height: 800 },
-    images,
-    options,
-    variants,
-    priceRange: {
-      minVariantPrice: transformMoney(price, currencyCode),
-      maxVariantPrice: transformMoney(price, currencyCode),
-    },
-    seo: {
-      title: raw.page_title ?? raw.name ?? '',
-      description: raw.meta_description ?? '',
-    },
-    tags: [],
-    createdAt: raw.date_created ?? new Date().toISOString(),
-    updatedAt: raw.date_modified ?? new Date().toISOString(),
-  };
-}
-
-// ============================================
-// Collection Transforms (BigCommerce "Categories" or "Brands")
-// ============================================
-
-export function transformCollection(raw: any): Collection {
-  return {
-    id: String(raw.id ?? ''),
-    handle: raw.custom_url?.url?.replace(/^\//, '').replace(/\/$/, '') ?? String(raw.id),
-    title: raw.name ?? '',
-    description: raw.description ?? '',
-    seo: {
-      title: raw.page_title ?? raw.name ?? '',
-      description: raw.meta_description ?? '',
-    },
-    updatedAt: raw.date_modified ?? new Date().toISOString(),
-    path: `/collections/${raw.custom_url?.url?.replace(/^\//, '').replace(/\/$/, '') ?? raw.id}`,
-  };
-}
-
-// ============================================
-// Cart Transforms
-// ============================================
-
-export function transformCart(raw: any, currencyCode: string = 'USD'): Cart {
-  const lineItems = Object.values(raw.line_items ?? {}).flat() as any[];
-
-  const lines: CartItem[] = lineItems.map((item: any) => ({
-    id: item.id,
-    quantity: item.quantity ?? 1,
-    cost: {
-      totalAmount: transformMoney(item.extended_sale_price ?? item.sale_price ?? 0, currencyCode),
-    },
-    merchandise: {
-      id: String(item.variant_id ?? item.product_id),
-      title: item.name ?? '',
-      selectedOptions: (item.options ?? []).map((opt: any) => ({
-        name: opt.name ?? '',
-        value: opt.value ?? '',
-      })),
-      product: {
-        id: String(item.product_id),
-        handle: String(item.product_id),
-        title: item.name ?? '',
-        featuredImage: item.image_url
-          ? transformImage(item.image_url)
-          : { url: '', altText: '', width: 800, height: 800 },
-      },
-    },
-  }));
-
-  return {
-    id: raw.id,
-    checkoutUrl: raw.redirect_urls?.checkout_url ?? '',
-    totalQuantity: lines.reduce((sum, l) => sum + l.quantity, 0),
-    cost: {
-      subtotalAmount: transformMoney(raw.base_amount ?? 0, currencyCode),
-      totalAmount: transformMoney(raw.cart_amount ?? 0, 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.phone ?? '',
-    hasAccount: true,
-  };
-}
-
-export function transformAddress(raw: any): Address {
-  return {
-    id: String(raw.id ?? ''),
-    firstName: raw.first_name ?? '',
-    lastName: raw.last_name ?? '',
-    address1: raw.address1 ?? '',
-    address2: raw.address2 ?? '',
-    city: raw.city ?? '',
-    province: raw.state_or_province ?? '',
-    countryCode: raw.country_code ?? '',
-    postalCode: raw.postal_code ?? '',
-    phone: raw.phone ?? '',
-    company: raw.company ?? '',
-  };
-}
-
-// ============================================
-// Order Transforms
-// ============================================
-
-export function transformOrder(raw: any, currencyCode: string = 'USD'): Order {
-  const items: OrderItem[] = (raw.products ?? []).map((p: any) => ({
-    id: String(p.id),
-    title: p.name ?? '',
-    variantTitle: p.sku ?? '',
-    quantity: p.quantity ?? 1,
-    price: transformMoney(p.base_price ?? 0, currencyCode),
-    total: transformMoney(p.base_total ?? 0, currencyCode),
-    productId: String(p.product_id),
-  }));
-
-  const statusMap: Record<string, OrderStatus> = {
-    'Incomplete': 'pending',
-    'Pending': 'pending',
-    'Shipped': 'completed',
-    'Partially Shipped': 'processing',
-    'Refunded': 'refunded',
-    'Cancelled': 'cancelled',
-    'Completed': 'completed',
-  };
-
-  return {
-    id: String(raw.id),
-    orderNumber: String(raw.id),
-    email: raw.billing_address?.email ?? '',
-    status: statusMap[raw.status] ?? 'pending',
-    paymentStatus: raw.payment_status === 'paid' ? 'paid' : 'pending',
-    fulfillmentStatus: raw.status === 'Shipped' ? 'fulfilled' : 'unfulfilled',
-    items,
-    total: transformMoney(raw.total_inc_tax ?? 0, currencyCode),
-    subtotal: transformMoney(raw.subtotal_inc_tax ?? 0, currencyCode),
-    tax: transformMoney(raw.total_tax ?? 0, currencyCode),
-    shipping: transformMoney(raw.shipping_cost_inc_tax ?? 0, currencyCode),
-    createdAt: raw.date_created ?? new Date().toISOString(),
-    updatedAt: raw.date_modified ?? new Date().toISOString(),
-  };
-}

package/src/providers/magento/index.ts

@@ -1,387 +0,0 @@
-/**
- * @thorprovider/adapters — Magento (Adobe Commerce) Provider
- * Implements CommerceProvider for Magento 2 GraphQL + REST APIs
- *
- * Uses GraphQL Storefront for read operations (products, categories, cart).
- * REST API for customer/order operations requiring auth tokens.
- * PaaS-first approach (not Adobe IMS/SaaS).
- */
-
-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 { MAGENTO_CAPABILITIES } from '../../types/capabilities.types';
-import { createLogger } from '../../core/logger';
-import { ProviderAPIError } from '../../core/errors';
-import { transformProduct, transformCart, transformCollection, transformOrder, transformCustomer } from './transforms';
-import {
-  GET_PRODUCTS,
-  GET_PRODUCT_BY_URL_KEY,
-  GET_CATEGORIES,
-  GET_CATEGORY_BY_URL_KEY,
-  GET_CATEGORY_PRODUCTS,
-  GET_CART,
-  CREATE_EMPTY_CART,
-  ADD_TO_CART,
-  REMOVE_FROM_CART,
-  UPDATE_CART_ITEMS,
-  APPLY_COUPON,
-  REMOVE_COUPON,
-  GET_CUSTOMER,
-  GET_CUSTOMER_ORDERS,
-} from './queries';
-
-/**
- * Magento provider configuration
- */
-export interface MagentoProviderConfig extends ProviderConfig {
-  /** Magento base URL (e.g., 'https://mymagento.com') */
-  baseUrl: string;
-  /** Store code for multi-tenant (default: 'default') */
-  storeCode?: string;
-  /** Customer bearer token (for authenticated operations) */
-  customerToken?: string;
-  /** Integration access token (for admin-level operations) */
-  accessToken?: string;
-  /** Default currency code (default: 'USD') */
-  currencyCode?: string;
-}
-
-export class MagentoProvider implements CommerceProvider {
-  readonly name = 'magento';
-  readonly version = '1.0.0';
-  readonly capabilities: BackendCapabilities = MAGENTO_CAPABILITIES;
-
-  private logger: ReturnType<typeof createLogger>;
-  private baseUrl: string;
-  private storeCode: string;
-  private currencyCode: string;
-  private graphqlEndpoint: string;
-  private customerToken?: string;
-  private accessToken?: string;
-
-  constructor(config: MagentoProviderConfig) {
-    this.logger = createLogger('MagentoProvider', config.debug);
-    this.baseUrl = config.baseUrl.replace(/\/$/, '');
-    this.storeCode = config.storeCode ?? 'default';
-    this.currencyCode = config.currencyCode ?? 'USD';
-    this.graphqlEndpoint = `${this.baseUrl}/graphql`;
-    this.customerToken = config.customerToken;
-    this.accessToken = config.accessToken;
-
-    this.logger.info('Initializing Magento Provider', {
-      baseUrl: this.baseUrl,
-      storeCode: this.storeCode,
-    });
-  }
-
-  private async graphql<T = any>(query: string, variables?: Record<string, any>): Promise<T> {
-    const headers: Record<string, string> = {
-      'Content-Type': 'application/json',
-      'Store': this.storeCode,
-    };
-
-    if (this.customerToken) {
-      headers['Authorization'] = `Bearer ${this.customerToken}`;
-    }
-
-    const response = await fetch(this.graphqlEndpoint, {
-      method: 'POST',
-      headers,
-      body: JSON.stringify({ query, variables }),
-    });
-
-    if (!response.ok) {
-      throw new ProviderAPIError(
-        `Magento GraphQL error: ${response.status}`,
-        'MAGENTO_API_ERROR',
-        response.status,
-      );
-    }
-
-    const json = await response.json() as { data?: T; errors?: Array<{ message: string }> };
-
-    if (json.errors?.length) {
-      const message = json.errors.map((e) => e.message).join('; ');
-      throw new ProviderAPIError(`Magento GraphQL error: ${message}`, 'MAGENTO_GRAPHQL_ERROR');
-    }
-
-    return json.data as T;
-  }
-
-  // ============================================
-  // Product Operations (GraphQL)
-  // ============================================
-
-  async getProduct(handle: string): Promise<Product | undefined> {
-    try {
-      const data = await this.graphql<{ products: { items: any[] } }>(GET_PRODUCT_BY_URL_KEY, { urlKey: handle });
-      return data.products.items[0] ? transformProduct(data.products.items[0], this.currencyCode) : undefined;
-    } catch {
-      return undefined;
-    }
-  }
-
-  async getProducts(options?: GetProductsOptions): Promise<Product[]> {
-    const variables: Record<string, any> = {
-      pageSize: options?.first ?? 20,
-      currentPage: 1,
-    };
-
-    if (options?.query) variables.search = options.query;
-    if (options?.sortKey) {
-      const sortMap: Record<string, Record<string, string>> = {
-        'price-asc': { price: 'ASC' },
-        'price-desc': { price: 'DESC' },
-        'title-asc': { name: 'ASC' },
-        'title-desc': { name: 'DESC' },
-        'created-desc': { created_at: 'DESC' },
-        'relevance': { relevance: 'DESC' },
-      };
-      variables.sort = sortMap[options.sortKey] ?? { relevance: 'DESC' };
-    }
-
-    const data = await this.graphql<{ products: { items: any[] } }>(GET_PRODUCTS, variables);
-    return (data.products?.items ?? []).map((p) => transformProduct(p, this.currencyCode));
-  }
-
-  async getProductRecommendations(_productId: string): Promise<Product[]> {
-    return [];
-  }
-
-  // ============================================
-  // Collection/Category Operations (GraphQL)
-  // ============================================
-
-  async getCollection(handle: string): Promise<Collection | undefined> {
-    try {
-      const data = await this.graphql<{ categories: { items: any[] } }>(GET_CATEGORY_BY_URL_KEY, { urlKey: handle });
-      return data.categories.items[0] ? transformCollection(data.categories.items[0]) : undefined;
-    } catch {
-      return undefined;
-    }
-  }
-
-  async getCollections(options?: GetCollectionsOptions): Promise<Collection[]> {
-    const data = await this.graphql<{ categories: { items: any[] } }>(GET_CATEGORIES, {
-      pageSize: options?.limit ?? 50,
-    });
-    return (data.categories?.items ?? []).map(transformCollection);
-  }
-
-  async getCollectionProducts(handle: string, options?: CollectionProductsOptions): Promise<Product[]> {
-    const data = await this.graphql<{ products: { items: any[] } }>(GET_CATEGORY_PRODUCTS, {
-      urlKey: handle,
-      pageSize: options?.first ?? 20,
-    });
-    return (data.products?.items ?? []).map((p) => transformProduct(p, this.currencyCode));
-  }
-
-  async getCategory(handle: string): Promise<ProductCategory | undefined> {
-    return this.getCollection(handle) 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 (GraphQL)
-  // ============================================
-
-  async createCart(): Promise<Cart> {
-    const data = await this.graphql<{ createEmptyCart: string }>(CREATE_EMPTY_CART);
-    const cartId = data.createEmptyCart;
-    const cartData = await this.graphql<{ cart: any }>(GET_CART, { cartId });
-    return transformCart(cartData.cart ?? { id: cartId, items: [], prices: {} }, this.currencyCode);
-  }
-
-  async getCart(cartId: string): Promise<Cart | undefined> {
-    try {
-      const data = await this.graphql<{ cart: any }>(GET_CART, { cartId });
-      return data.cart ? transformCart(data.cart, this.currencyCode) : undefined;
-    } catch {
-      return undefined;
-    }
-  }
-
-  async addToCart(cartId: string, lines: CartLineInput[]): Promise<Cart> {
-    const cartItems = lines.map((l) => ({
-      sku: l.merchandiseId,
-      quantity: l.quantity,
-    }));
-
-    const data = await this.graphql<{ addProductsToCart: { cart: any; user_errors: any[] } }>(ADD_TO_CART, {
-      cartId,
-      cartItems,
-    });
-
-    if (data.addProductsToCart.user_errors?.length) {
-      throw new ProviderAPIError(
-        `Add to cart failed: ${data.addProductsToCart.user_errors.map((e: any) => e.message).join('; ')}`,
-        'MAGENTO_CART_ERROR',
-      );
-    }
-
-    return transformCart(data.addProductsToCart.cart, this.currencyCode);
-  }
-
-  async removeFromCart(cartId: string, lineIds: string[]): Promise<Cart> {
-    let cart: any;
-    for (const itemUid of lineIds) {
-      const data = await this.graphql<{ removeItemFromCart: { cart: any } }>(REMOVE_FROM_CART, {
-        cartId,
-        cartItemUid: itemUid,
-      });
-      cart = data.removeItemFromCart.cart;
-    }
-    return transformCart(cart ?? { id: cartId, items: [], prices: {} }, this.currencyCode);
-  }
-
-  async updateCart(cartId: string, lines: CartLineUpdate[]): Promise<Cart> {
-    const cartItems = lines.map((l) => ({
-      cart_item_uid: l.id,
-      quantity: l.quantity,
-    }));
-
-    const data = await this.graphql<{ updateCartItems: { cart: any } }>(UPDATE_CART_ITEMS, {
-      cartId,
-      cartItems,
-    });
-
-    return transformCart(data.updateCartItems.cart, this.currencyCode);
-  }
-
-  // ============================================
-  // Checkout Operations
-  // ============================================
-
-  async completeCheckout(_cartId: string): Promise<Order> {
-    throw new ProviderAPIError(
-      'Magento checkout requires multi-step process (set addresses, shipping, payment, place order). Use the Magento checkout flow.',
-      'MAGENTO_CHECKOUT_MULTI_STEP',
-    );
-  }
-
-  async getShippingMethods(_cartId: string): Promise<ShippingMethod[]> {
-    return [];
-  }
-
-  async getRegionCountries(): Promise<import('@thorprovider/types').Country[]> {
-    return [];
-  }
-
-  async addShippingMethod(_cartId: string, _methodId: string): Promise<Cart> {
-    throw new ProviderAPIError(
-      'Magento shipping selection requires set-shipping-methods mutation.',
-      'MAGENTO_CHECKOUT_MULTI_STEP',
-    );
-  }
-
-  async initiatePaymentSession(_cartId: string, _providerId: string): Promise<void> {
-    // Magento handles payment via set-payment-method mutation
-  }
-
-  async applyDiscountCode(cartId: string, code: string): Promise<Cart> {
-    const data = await this.graphql<{ applyCouponToCart: { cart: any } }>(APPLY_COUPON, {
-      cartId,
-      couponCode: code,
-    });
-    return transformCart(data.applyCouponToCart.cart, this.currencyCode);
-  }
-
-  async removeDiscountCode(cartId: string, _code: string): Promise<Cart> {
-    const data = await this.graphql<{ removeCouponFromCart: { cart: any } }>(REMOVE_COUPON, {
-      cartId,
-    });
-    return transformCart(data.removeCouponFromCart.cart, this.currencyCode);
-  }
-
-  // ============================================
-  // Customer & Orders (GraphQL — requires customerToken)
-  // ============================================
-
-  async getOrders(_options: GetOrdersOptions): Promise<Order[]> {
-    if (!this.customerToken) return [];
-    try {
-      const data = await this.graphql<{ customer: { orders: { items: any[] } } }>(GET_CUSTOMER_ORDERS, {
-        pageSize: 20,
-        currentPage: 1,
-      });
-      return (data.customer?.orders?.items ?? []).map((o) => transformOrder(o, this.currencyCode));
-    } catch {
-      return [];
-    }
-  }
-
-  async getPaymentMethods(_options: PaymentMethodsOptions): Promise<PaymentMethod[]> {
-    return [];
-  }
-
-  // ============================================
-  // Inventory
-  // ============================================
-
-  async getStockLocations(): Promise<StockLocation[]> { return []; }
-  async checkInventoryLevels(): Promise<InventoryLevel[]> { return []; }
-  async validateCartStock(): Promise<StockValidation> { return { allAvailable: true, unavailableItems: [] }; }
-  async getFulfillmentOptions(): Promise<FulfillmentOption[]> { return []; }
-
-  // ============================================
-  // Admin Operations
-  // ============================================
-
-  async cancelOrder(_orderId: string): Promise<Order> {
-    throw new ProviderAPIError('Order cancellation requires Magento Admin API.', 'MAGENTO_ADMIN_REQUIRED');
-  }
-  async createFulfillment(_orderId: string): Promise<void> {
-    throw new ProviderAPIError('Fulfillment requires Magento Admin API.', 'MAGENTO_ADMIN_REQUIRED');
-  }
-  async createRefund(_orderId: string): Promise<void> {
-    throw new ProviderAPIError('Refunds require Magento Admin API.', 'MAGENTO_ADMIN_REQUIRED');
-  }
-  async getAdminOrders(): Promise<{ orders: Order[]; count: number }> { return { orders: [], count: 0 }; }
-
-  // ============================================
-  // Storefront / Multi-Tenant
-  // ============================================
-
-  async getStorefrontContext(): Promise<StorefrontContext> {
-    return {
-      id: this.storeCode,
-      name: `Magento ${this.storeCode}`,
-      platformType: 'magento',
-      requiresProductScoping: true,
-      currencyCode: this.currencyCode,
-    };
-  }
-
-  isStorefrontRequired(): boolean { return true; }
-}

package/src/providers/magento/magento.ts

@@ -1,5 +0,0 @@
-/**
- * Magento (Adobe Commerce) Provider — barrel exports
- */
-export { MagentoProvider } from './index';
-export type { MagentoProviderConfig } from './index';