@thorprovider/adapters 4.3.0 → 5.0.0

package/src/providers/magento/transforms.ts

@@ -1,249 +0,0 @@
-/**
- * Adobe Commerce (Magento) Transform Functions
- * Converts Magento GraphQL / REST API responses to @thorprovider/types
- *
- * Magento returns price as { regularPrice: { amount: { value, currency } } }
- * Images have url + label directly.
- */
-
-import type { Product, ProductVariant, ProductOption, Image, Collection, Cart, CartItem, Order, OrderItem, Customer, Address, Money } from '@thorprovider/types';
-
-// ============================================
-// Money / Price Helpers
-// ============================================
-
-function toMoney(value: number | undefined, currencyCode: string): Money {
-  return { amount: (value ?? 0).toFixed(2), currencyCode };
-}
-
-function extractPrice(priceRange: any, currencyCode: string): { min: Money; max: Money } {
-  const minPrice = priceRange?.minimum_price?.regular_price?.value ?? priceRange?.minimum_price?.final_price?.value ?? 0;
-  const maxPrice = priceRange?.maximum_price?.regular_price?.value ?? priceRange?.maximum_price?.final_price?.value ?? minPrice;
-  const currency = priceRange?.minimum_price?.regular_price?.currency ?? currencyCode;
-  return {
-    min: toMoney(minPrice, currency),
-    max: toMoney(maxPrice, currency),
-  };
-}
-
-// ============================================
-// Product Transforms
-// ============================================
-
-export function transformProduct(data: any, currencyCode: string = 'USD'): Product {
-  const id = String(data.id ?? data.uid ?? '');
-  const { min, max } = extractPrice(data.price_range, currencyCode);
-
-  // Images
-  const images: Image[] = (data.media_gallery ?? data.media_gallery_entries ?? []).map((img: any) => ({
-    url: img.url ?? (img.file ? `${img.file}` : ''),
-    altText: img.label ?? data.name ?? '',
-    width: undefined,
-    height: undefined,
-  }));
-
-  // Small image fallback
-  if (images.length === 0 && data.small_image?.url) {
-    images.push({ url: data.small_image.url, altText: data.small_image.label ?? data.name ?? '' });
-  }
-  if (images.length === 0 && data.image?.url) {
-    images.push({ url: data.image.url, altText: data.image.label ?? data.name ?? '' });
-  }
-
-  // Variants from configurable_options / variants
-  const variants: ProductVariant[] = [];
-  if (data.variants && Array.isArray(data.variants)) {
-    for (const v of data.variants) {
-      const product = v.product ?? {};
-      const vPrice = product.price_range?.minimum_price?.final_price ?? {};
-      variants.push({
-        id: String(product.id ?? product.uid ?? product.sku ?? ''),
-        title: product.name ?? product.sku ?? '',
-        availableForSale: product.stock_status === 'IN_STOCK',
-        price: toMoney(vPrice.value ?? min.amount, vPrice.currency ?? currencyCode),
-        compareAtPrice: undefined,
-        selectedOptions: (v.attributes ?? []).map((attr: any) => ({
-          name: attr.label ?? '',
-          value: attr.value_index != null ? String(attr.value_index) : '',
-        })),
-      });
-    }
-  }
-
-  // Default variant if simple product
-  if (variants.length === 0) {
-    variants.push({
-      id: data.sku ?? id,
-      title: data.name ?? '',
-      availableForSale: data.stock_status === 'IN_STOCK',
-      price: min,
-      compareAtPrice: undefined,
-      selectedOptions: [],
-    });
-  }
-
-  // Options
-  const options: ProductOption[] = (data.configurable_options ?? []).map((opt: any) => ({
-    id: String(opt.attribute_id ?? opt.attribute_code ?? ''),
-    name: opt.label ?? opt.attribute_code ?? '',
-    values: (opt.values ?? []).map((v: any) => v.label ?? v.store_label ?? String(v.value_index ?? '')),
-  }));
-
-  return {
-    id,
-    handle: data.url_key ?? data.sku ?? id,
-    title: data.name ?? '',
-    description: data.short_description?.html ?? data.description?.html ?? '',
-    descriptionHtml: data.description?.html ?? '',
-    availableForSale: data.stock_status === 'IN_STOCK',
-    priceRange: { minVariantPrice: min, maxVariantPrice: max },
-    variants,
-    options,
-    images,
-    featuredImage: images[0] ?? { url: '', altText: data.name ?? '' },
-    tags: [],
-    seo: {
-      title: data.meta_title ?? data.name ?? '',
-      description: data.meta_description ?? '',
-    },
-    updatedAt: data.updated_at ?? new Date().toISOString(),
-    createdAt: data.created_at ?? new Date().toISOString(),
-  };
-}
-
-// ============================================
-// Collection Transforms (Magento Categories)
-// ============================================
-
-export function transformCollection(data: any): Collection {
-  return {
-    id: String(data.id ?? data.uid ?? ''),
-    handle: data.url_key ?? data.url_path ?? String(data.id ?? data.uid ?? ''),
-    title: data.name ?? '',
-    description: data.description ?? '',
-    seo: {
-      title: data.meta_title ?? data.name ?? '',
-      description: data.meta_description ?? '',
-    },
-    updatedAt: data.updated_at ?? new Date().toISOString(),
-    path: `/collections/${data.url_key ?? data.url_path ?? data.id}`,
-  };
-}
-
-// ============================================
-// Cart Transforms (Magento Cart / Quote)
-// ============================================
-
-export function transformCart(data: any, currencyCode: string = 'USD'): Cart {
-  const items: CartItem[] = (data.items ?? []).map((item: any): CartItem => {
-    const product = item.product ?? {};
-    const priceVal = item.prices?.price?.value ?? product.price_range?.minimum_price?.final_price?.value ?? 0;
-    const totalVal = item.prices?.row_total?.value ?? priceVal * (item.quantity ?? 1);
-
-    return {
-      id: String(item.id ?? item.uid ?? ''),
-      quantity: item.quantity ?? 1,
-      cost: {
-        totalAmount: toMoney(totalVal, item.prices?.price?.currency ?? currencyCode),
-      },
-      merchandise: {
-        id: String(product.sku ?? item.id ?? ''),
-        title: product.name ?? item.product?.name ?? '',
-        selectedOptions: (item.configurable_options ?? []).map((opt: any) => ({
-          name: opt.option_label ?? '',
-          value: opt.value_label ?? '',
-        })),
-        product: {
-          id: String(product.id ?? product.uid ?? ''),
-          handle: product.url_key ?? '',
-          title: product.name ?? '',
-          featuredImage: {
-            url: product.small_image?.url ?? product.thumbnail?.url ?? '',
-            altText: product.name ?? '',
-          },
-        },
-      },
-    };
-  });
-
-  const totalVal = data.prices?.grand_total?.value ?? 0;
-  const subtotalVal = data.prices?.subtotal_excluding_tax?.value ?? data.prices?.subtotal_including_tax?.value ?? totalVal;
-  const taxVal = (data.prices?.applied_taxes ?? []).reduce((sum: number, t: any) => sum + (t.amount?.value ?? 0), 0);
-
-  return {
-    id: String(data.id ?? ''),
-    checkoutUrl: '',
-    totalQuantity: items.reduce((sum, i) => sum + i.quantity, 0),
-    cost: {
-      subtotalAmount: toMoney(subtotalVal, data.prices?.grand_total?.currency ?? currencyCode),
-      totalAmount: toMoney(totalVal, data.prices?.grand_total?.currency ?? currencyCode),
-      totalTaxAmount: toMoney(taxVal, currencyCode),
-    },
-    lines: items,
-  };
-}
-
-// ============================================
-// Customer Transforms
-// ============================================
-
-export function transformCustomer(data: any): Customer {
-  return {
-    id: String(data.id ?? ''),
-    email: data.email ?? '',
-    firstName: data.firstname ?? data.first_name ?? '',
-    lastName: data.lastname ?? data.last_name ?? '',
-    phone: data.phone ?? '',
-    hasAccount: true,
-  };
-}
-
-function transformAddress(addr: any): Address {
-  return {
-    id: String(addr.id ?? ''),
-    firstName: addr.firstname ?? '',
-    lastName: addr.lastname ?? '',
-    company: addr.company ?? '',
-    address1: Array.isArray(addr.street) ? addr.street[0] ?? '' : addr.street ?? '',
-    address2: Array.isArray(addr.street) ? addr.street[1] ?? '' : '',
-    city: addr.city ?? '',
-    province: addr.region?.region ?? '',
-    postalCode: addr.postcode ?? '',
-    countryCode: addr.country_code ?? addr.country_id ?? '',
-    phone: addr.telephone ?? '',
-  };
-}
-
-// ============================================
-// Order Transforms
-// ============================================
-
-export function transformOrder(data: any, currencyCode: string = 'USD'): Order {
-  const items: OrderItem[] = (data.items ?? []).map((item: any) => ({
-    id: String(item.id ?? ''),
-    title: item.product_name ?? '',
-    quantity: item.quantity_ordered ?? item.quantity ?? 1,
-    price: toMoney(item.product_sale_price?.value ?? item.price ?? 0, currencyCode),
-    total: toMoney((item.product_sale_price?.value ?? item.price ?? 0) * (item.quantity_ordered ?? item.quantity ?? 1), currencyCode),
-    sku: item.product_sku ?? item.sku,
-    productId: String(item.product_id ?? ''),
-  }));
-
-  return {
-    id: String(data.id ?? data.order_number ?? ''),
-    orderNumber: data.order_number ?? data.number ?? String(data.id ?? ''),
-    email: data.email ?? '',
-    status: (data.status === 'complete' ? 'completed' : data.status === 'canceled' ? 'cancelled' : data.status === 'closed' ? 'refunded' : 'pending') as any,
-    paymentStatus: (data.payment_status === 'paid' ? 'paid' : 'pending') as any,
-    fulfillmentStatus: (data.shipment_status === 'shipped' ? 'fulfilled' : 'unfulfilled') as any,
-    items,
-    total: toMoney(data.total?.grand_total?.value ?? data.grand_total ?? 0, currencyCode),
-    subtotal: toMoney(data.total?.subtotal?.value ?? data.subtotal ?? 0, currencyCode),
-    tax: toMoney(data.total?.total_tax?.value ?? data.tax_amount ?? 0, currencyCode),
-    shipping: toMoney(data.total?.total_shipping?.value ?? data.shipping_amount ?? 0, currencyCode),
-    shippingAddress: data.shipping_address ? transformAddress(data.shipping_address) : undefined,
-    billingAddress: data.billing_address ? transformAddress(data.billing_address) : undefined,
-    createdAt: data.order_date ?? data.created_at ?? new Date().toISOString(),
-    updatedAt: data.updated_at ?? data.order_date ?? new Date().toISOString(),
-  };
-}

package/src/providers/shopify/auth.ts

@@ -1,408 +0,0 @@
-import type {
-  Address,
-  AuthConfig,
-  AuthProvider,
-  AuthResponse,
-  CreateAddressData,
-  Customer,
-  LoginCredentials,
-  RegisterData,
-  UpdateCustomerData,
-} from '@thorprovider/types';
-import { createLogger } from '../../core/logger';
-import { ProviderAPIError, extractErrorMessage } from '../../core/errors';
-import { AuthStorage } from '../../lib/auth-storage';
-import {
-  CUSTOMER_ACCESS_TOKEN_CREATE,
-  CUSTOMER_ACCESS_TOKEN_DELETE,
-  CUSTOMER_ADDRESS_CREATE,
-  CUSTOMER_ADDRESS_DELETE,
-  CUSTOMER_ADDRESS_UPDATE,
-  CUSTOMER_CREATE,
-  CUSTOMER_RECOVER,
-  CUSTOMER_RESET,
-  CUSTOMER_UPDATE,
-} from './mutations';
-import { GET_CUSTOMER } from './queries';
-import { transformAddress, transformCustomer, transformCustomerAddresses } from './transforms';
-
-type ShopifyGraphqlRequester = <T = any>(gql: string, variables?: Record<string, unknown>) => Promise<T>;
-
-interface ShopifyCustomerToken {
-  accessToken: string;
-  expiresAt?: string;
-}
-
-interface ShopifyAuthDependencies {
-  query: ShopifyGraphqlRequester;
-  authConfig: AuthConfig;
-  debug?: boolean;
-}
-
-export class ShopifyAuthProvider implements AuthProvider {
-  private readonly logger;
-  private readonly storage: AuthStorage;
-
-  constructor(private readonly deps: ShopifyAuthDependencies) {
-    this.logger = createLogger('ShopifyAuthProvider', deps.debug);
-    this.storage = new AuthStorage(deps.authConfig, 'thor:shopify:auth');
-  }
-
-  private async readToken(): Promise<ShopifyCustomerToken | null> {
-    const token = await this.storage.getJson<ShopifyCustomerToken>('customer-access-token');
-    if (!token?.accessToken) {
-      return null;
-    }
-
-    if (token.expiresAt && new Date(token.expiresAt).getTime() <= Date.now()) {
-      await this.storage.remove('customer-access-token');
-      return null;
-    }
-
-    return token;
-  }
-
-  async getStoredToken(): Promise<ShopifyCustomerToken | null> {
-    return this.readToken();
-  }
-
-  private async writeToken(token: ShopifyCustomerToken | null): Promise<void> {
-    if (!token) {
-      await this.storage.remove('customer-access-token');
-      return;
-    }
-
-    await this.storage.setJson('customer-access-token', token);
-  }
-
-  private async requireToken(): Promise<ShopifyCustomerToken> {
-    const token = await this.readToken();
-    if (!token) {
-      throw new ProviderAPIError('Shopify customer access token is required.', 'shopify', 401);
-    }
-    return token;
-  }
-
-  private async fetchCurrentCustomer(): Promise<any | null> {
-    const token = await this.readToken();
-    if (!token) {
-      return null;
-    }
-
-    try {
-      const data = await this.deps.query<{ customer: any }>(GET_CUSTOMER, {
-        customerAccessToken: token.accessToken,
-      });
-
-      return data.customer ?? null;
-    } catch (error) {
-      await this.writeToken(null);
-      this.logger.warn('Failed to fetch current Shopify customer', extractErrorMessage(error));
-      return null;
-    }
-  }
-
-  async login(credentials: LoginCredentials): Promise<AuthResponse> {
-    try {
-      const data = await this.deps.query<{
-        customerAccessTokenCreate: {
-          customerAccessToken?: ShopifyCustomerToken;
-          customerUserErrors?: Array<{ message: string }>;
-        };
-      }>(CUSTOMER_ACCESS_TOKEN_CREATE, {
-        input: {
-          email: credentials.email,
-          password: credentials.password,
-        },
-      });
-
-      const result = data.customerAccessTokenCreate;
-      if (result.customerUserErrors?.length || !result.customerAccessToken?.accessToken) {
-        throw new ProviderAPIError(
-          result.customerUserErrors?.map((entry) => entry.message).join('; ') || 'Shopify login failed.',
-          'shopify',
-          400,
-        );
-      }
-
-      await this.writeToken(result.customerAccessToken);
-      const customer = await this.getCurrentCustomer();
-
-      return {
-        token: result.customerAccessToken.accessToken,
-        customer: customer ?? undefined,
-      };
-    } catch (error) {
-      throw new ProviderAPIError(`Shopify login failed: ${extractErrorMessage(error)}`, 'shopify', 400);
-    }
-  }
-
-  async register(data: RegisterData): Promise<AuthResponse> {
-    try {
-      const createResult = await this.deps.query<{
-        customerCreate: {
-          customer?: any;
-          customerUserErrors?: Array<{ message: string }>;
-        };
-      }>(CUSTOMER_CREATE, {
-        input: {
-          firstName: data.first_name,
-          lastName: data.last_name,
-          email: data.email,
-          phone: data.phone,
-          password: data.password,
-        },
-      });
-
-      const result = createResult.customerCreate;
-      if (result.customerUserErrors?.length) {
-        throw new ProviderAPIError(
-          result.customerUserErrors.map((entry) => entry.message).join('; '),
-          'shopify',
-          400,
-        );
-      }
-
-      return this.login({ email: data.email, password: data.password });
-    } catch (error) {
-      throw new ProviderAPIError(`Shopify registration failed: ${extractErrorMessage(error)}`, 'shopify', 400);
-    }
-  }
-
-  async logout(): Promise<void> {
-    try {
-      const token = await this.readToken();
-      if (token?.accessToken) {
-        await this.deps.query(CUSTOMER_ACCESS_TOKEN_DELETE, {
-          customerAccessToken: token.accessToken,
-        });
-      }
-    } catch (error) {
-      this.logger.warn('Shopify logout returned an error', extractErrorMessage(error));
-    } finally {
-      await this.writeToken(null);
-    }
-  }
-
-  async requestPasswordReset(email: string): Promise<void> {
-    try {
-      const data = await this.deps.query<{
-        customerRecover: {
-          customerUserErrors?: Array<{ message: string }>;
-        };
-      }>(CUSTOMER_RECOVER, { email });
-
-      if (data.customerRecover.customerUserErrors?.length) {
-        throw new ProviderAPIError(
-          data.customerRecover.customerUserErrors.map((entry) => entry.message).join('; '),
-          'shopify',
-          400,
-        );
-      }
-    } catch (error) {
-      throw new ProviderAPIError(`Shopify password reset request failed: ${extractErrorMessage(error)}`, 'shopify', 400);
-    }
-  }
-
-  async resetPassword(token: string, password: string, metadata?: Record<string, unknown>): Promise<void> {
-    const customerId = typeof metadata?.customerId === 'string' ? metadata.customerId : null;
-    if (!customerId) {
-      throw new ProviderAPIError('Shopify password reset requires metadata.customerId.', 'shopify', 400);
-    }
-
-    try {
-      const data = await this.deps.query<{
-        customerReset: {
-          customerAccessToken?: ShopifyCustomerToken;
-          customerUserErrors?: Array<{ message: string }>;
-        };
-      }>(CUSTOMER_RESET, {
-        id: customerId,
-        input: {
-          resetToken: token,
-          password,
-        },
-      });
-
-      if (data.customerReset.customerUserErrors?.length) {
-        throw new ProviderAPIError(
-          data.customerReset.customerUserErrors.map((entry) => entry.message).join('; '),
-          'shopify',
-          400,
-        );
-      }
-
-      if (data.customerReset.customerAccessToken?.accessToken) {
-        await this.writeToken(data.customerReset.customerAccessToken);
-      }
-    } catch (error) {
-      throw new ProviderAPIError(`Shopify password reset failed: ${extractErrorMessage(error)}`, 'shopify', 400);
-    }
-  }
-
-  async getCurrentCustomer(): Promise<Customer | null> {
-    const customer = await this.fetchCurrentCustomer();
-    return customer ? transformCustomer(customer) : null;
-  }
-
-  async updateCustomer(data: UpdateCustomerData): Promise<Customer> {
-    const token = await this.requireToken();
-
-    try {
-      const payload: Record<string, unknown> = {};
-      if (data.first_name !== undefined) payload.firstName = data.first_name;
-      if (data.last_name !== undefined) payload.lastName = data.last_name;
-      if (data.email !== undefined) payload.email = data.email;
-      if (data.phone !== undefined && data.phone !== null) payload.phone = data.phone;
-      if (data.password !== undefined) payload.password = data.password;
-
-      const response = await this.deps.query<{
-        customerUpdate: {
-          customer?: any;
-          customerAccessToken?: ShopifyCustomerToken;
-          customerUserErrors?: Array<{ message: string }>;
-        };
-      }>(CUSTOMER_UPDATE, {
-        customerAccessToken: token.accessToken,
-        customer: payload,
-      });
-
-      const result = response.customerUpdate;
-      if (result.customerUserErrors?.length || !result.customer) {
-        throw new ProviderAPIError(
-          result.customerUserErrors?.map((entry) => entry.message).join('; ') || 'Shopify customer update failed.',
-          'shopify',
-          400,
-        );
-      }
-
-      if (result.customerAccessToken?.accessToken) {
-        await this.writeToken(result.customerAccessToken);
-      }
-
-      return transformCustomer(result.customer);
-    } catch (error) {
-      throw new ProviderAPIError(`Shopify update customer failed: ${extractErrorMessage(error)}`, 'shopify', 400);
-    }
-  }
-
-  async isAuthenticated(): Promise<boolean> {
-    return (await this.getCurrentCustomer()) !== null;
-  }
-
-  getAuthToken(): string | null {
-    return null;
-  }
-
-  async getAddresses(): Promise<Address[]> {
-    const customer = await this.fetchCurrentCustomer();
-    return customer ? transformCustomerAddresses(customer) : [];
-  }
-
-  private toMailingAddressInput(data: Partial<CreateAddressData>): Record<string, unknown> {
-    return {
-      firstName: data.firstName,
-      lastName: data.lastName,
-      company: data.company,
-      address1: data.address1,
-      address2: data.address2,
-      city: data.city,
-      province: data.province,
-      country: data.countryCode,
-      zip: data.postalCode,
-      phone: data.phone,
-    };
-  }
-
-  async createAddress(data: CreateAddressData): Promise<Address> {
-    const token = await this.requireToken();
-
-    try {
-      const response = await this.deps.query<{
-        customerAddressCreate: {
-          customerAddress?: any;
-          customerUserErrors?: Array<{ message: string }>;
-        };
-      }>(CUSTOMER_ADDRESS_CREATE, {
-        customerAccessToken: token.accessToken,
-        address: this.toMailingAddressInput(data),
-      });
-
-      if (response.customerAddressCreate.customerUserErrors?.length || !response.customerAddressCreate.customerAddress) {
-        throw new ProviderAPIError(
-          response.customerAddressCreate.customerUserErrors?.map((entry) => entry.message).join('; ') || 'Shopify address create failed.',
-          'shopify',
-          400,
-        );
-      }
-
-      return transformAddress(response.customerAddressCreate.customerAddress);
-    } catch (error) {
-      throw new ProviderAPIError(`Shopify create address failed: ${extractErrorMessage(error)}`, 'shopify', 400);
-    }
-  }
-
-  async updateAddress(addressId: string, data: Partial<CreateAddressData>): Promise<Address> {
-    const token = await this.requireToken();
-
-    try {
-      const response = await this.deps.query<{
-        customerAddressUpdate: {
-          customerAddress?: any;
-          customerUserErrors?: Array<{ message: string }>;
-        };
-      }>(CUSTOMER_ADDRESS_UPDATE, {
-        customerAccessToken: token.accessToken,
-        id: addressId,
-        address: this.toMailingAddressInput(data),
-      });
-
-      if (response.customerAddressUpdate.customerUserErrors?.length || !response.customerAddressUpdate.customerAddress) {
-        throw new ProviderAPIError(
-          response.customerAddressUpdate.customerUserErrors?.map((entry) => entry.message).join('; ') || 'Shopify address update failed.',
-          'shopify',
-          400,
-        );
-      }
-
-      return transformAddress(response.customerAddressUpdate.customerAddress);
-    } catch (error) {
-      throw new ProviderAPIError(`Shopify update address failed: ${extractErrorMessage(error)}`, 'shopify', 400);
-    }
-  }
-
-  async deleteAddress(addressId: string): Promise<void> {
-    const token = await this.requireToken();
-
-    try {
-      const response = await this.deps.query<{
-        customerAddressDelete: {
-          customerUserErrors?: Array<{ message: string }>;
-        };
-      }>(CUSTOMER_ADDRESS_DELETE, {
-        customerAccessToken: token.accessToken,
-        id: addressId,
-      });
-
-      if (response.customerAddressDelete.customerUserErrors?.length) {
-        throw new ProviderAPIError(
-          response.customerAddressDelete.customerUserErrors.map((entry) => entry.message).join('; '),
-          'shopify',
-          400,
-        );
-      }
-    } catch (error) {
-      throw new ProviderAPIError(`Shopify delete address failed: ${extractErrorMessage(error)}`, 'shopify', 400);
-    }
-  }
-
-  async deleteCustomerAccount(): Promise<void> {
-    throw new ProviderAPIError('Shopify customer self-service deletion requires Admin API and is not supported.', 'shopify', 501);
-  }
-
-  async linkCustomerToChannel(): Promise<{ linked: boolean; reason?: string }> {
-    // Shopify does not have the concept of Thor sales channels.
-    // Return a no-op response so multi-tenant flows don't break when running against Shopify.
-    return { linked: false, reason: 'not_applicable' };
-  }
-}