@thorprovider/adapters 5.0.0 → 5.0.2

package/src/providers/magento/transforms.ts

@@ -0,0 +1,249 @@
+/**
+ * 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/medusa/auth.test.ts

@@ -1,45 +1,46 @@
 /**
- * @fileoverview Tests for MedusaAuthProvider.linkCustomerToChannel
- *
- * Uses msw to intercept fetch, a minimal Medusa SDK stub, and a custom
- * storage stub to inject a pre-set JWT token.
+ * @fileoverview Tests for MedusaAuthProvider
  */
 
-import { describe, expect, it } from 'vitest'
-import { http, HttpResponse } from 'msw'
-import { server } from '../stelorder/client.test-helpers'
+import { describe, expect, it, vi } from 'vitest'
+import Medusa from '@medusajs/js-sdk'
 import { MedusaAuthProvider } from './auth'
 
 const BASE = 'https://medusa.example.com'
-const PUB_KEY = 'pk_test_123'
-const TOKEN = 'jwt-bearer-token'
 
-// ---------------------------------------------------------------------------
-// Minimal SDK stub — we only test the linkCustomerToChannel raw-fetch path,
-// so the SDK itself does not need to do anything.
-// ---------------------------------------------------------------------------
-
-function makeSdkStub(): any {
+function makeSdkStub() {
   return {
-    auth: {},
-    store: { customer: {} },
-  } as any
+    auth: {
+      login: vi.fn(),
+      logout: vi.fn(),
+      register: vi.fn(),
+      resetPassword: vi.fn(),
+      updateProvider: vi.fn(),
+    },
+    store: {
+      customer: {
+        retrieve: vi.fn(),
+        create: vi.fn(),
+        listAddress: vi.fn(),
+        createAddress: vi.fn(),
+        updateAddress: vi.fn(),
+        deleteAddress: vi.fn(),
+        update: vi.fn(),
+      },
+    },
+  } as unknown as Medusa
 }
 
-// ---------------------------------------------------------------------------
-// Custom storage stub — provides a pre-set token to the auth provider
-// ---------------------------------------------------------------------------
-
 function makeStorageWithToken(token: string | null) {
   let stored: string | null = token
   return {
-    getItem: (_key: string) => Promise.resolve(stored),
+    getItem: () => Promise.resolve(stored),
     setItem: (_key: string, value: string) => { stored = value; return Promise.resolve() },
-    removeItem: (_key: string) => { stored = null; return Promise.resolve() },
+    removeItem: () => { stored = null; return Promise.resolve() },
   }
 }
 
-function makeAuthConfig(token: string | null = TOKEN) {
+function makeAuthConfig(token: string | null = 'jwt-bearer-token') {
   return {
     method: 'jwt' as const,
     storage: 'memory' as const,
@@ -47,91 +48,92 @@ function makeAuthConfig(token: string | null = TOKEN) {
   }
 }
 
-function makeProvider(token: string | null = TOKEN) {
-  return new MedusaAuthProvider(makeSdkStub(), makeAuthConfig(token), false, BASE, PUB_KEY)
+function makeProvider(token: string | null = 'jwt-bearer-token') {
+  return new MedusaAuthProvider(makeSdkStub(), makeAuthConfig(token), false)
 }
 
-// ---------------------------------------------------------------------------
-// Tests
-// ---------------------------------------------------------------------------
-
-describe('MedusaAuthProvider.linkCustomerToChannel', () => {
-  it('POST /store/thor/customers/me/channels with Authorization header when token present', async () => {
-    server.use(
-      http.post(`${BASE}/store/thor/customers/me/channels`, ({ request }) => {
-        expect(request.headers.get('x-publishable-api-key')).toBe(PUB_KEY)
-        expect(request.headers.get('Authorization')).toBe(`Bearer ${TOKEN}`)
-        return HttpResponse.json({ linked: true })
-      }),
-    )
-
-    const result = await makeProvider().linkCustomerToChannel()
-    expect(result.linked).toBe(true)
-  })
+describe('MedusaAuthProvider', () => {
+  it('stores jwt token and returns customer on login', async () => {
+    const sdk = makeSdkStub()
+    sdk.auth.login = vi.fn().mockResolvedValue('jwt-bearer-token')
+    sdk.store.customer.retrieve = vi.fn().mockResolvedValue({ customer: { id: 'cus_1', email: 'test@example.com' } })
 
-  it('POST without Authorization header when no token in storage', async () => {
-    server.use(
-      http.post(`${BASE}/store/thor/customers/me/channels`, ({ request }) => {
-        expect(request.headers.get('Authorization')).toBeNull()
-        expect(request.headers.get('x-publishable-api-key')).toBe(PUB_KEY)
-        return HttpResponse.json({ linked: true })
-      }),
-    )
-
-    const result = await makeProvider(null).linkCustomerToChannel()
-    expect(result.linked).toBe(true)
-  })
+    const provider = new MedusaAuthProvider(sdk, makeAuthConfig('jwt-bearer-token'), false)
 
-  it('returns { linked: true, reason: "already_linked" } on duplicate link', async () => {
-    server.use(
-      http.post(`${BASE}/store/thor/customers/me/channels`, () =>
-        HttpResponse.json({ linked: true, reason: 'already_linked' }),
-      ),
-    )
+    const result = await provider.login({ email: 'test@example.com', password: 'secret' })
 
-    const result = await makeProvider().linkCustomerToChannel()
-    expect(result.linked).toBe(true)
-    expect(result.reason).toBe('already_linked')
+    expect(result.token).toBe('jwt-bearer-token')
+    expect(result.customer?.email).toBe('test@example.com')
+    expect(sdk.auth.login).toHaveBeenCalledWith('customer', 'emailpass', {
+      email: 'test@example.com',
+      password: 'secret',
+    })
   })
 
-  it('throws ProviderAPIError with NOT_AUTHENTICATED on 401', async () => {
-    server.use(
-      http.post(`${BASE}/store/thor/customers/me/channels`, () =>
-        HttpResponse.json({ message: 'Unauthorized' }, { status: 401 }),
-      ),
-    )
+  it('throws ProviderAPIError with login code on auth failure', async () => {
+    const sdk = makeSdkStub()
+    sdk.auth.login = vi.fn().mockRejectedValue(new Error('bad credentials'))
 
-    await expect(makeProvider().linkCustomerToChannel()).rejects.toMatchObject({
+    const provider = new MedusaAuthProvider(sdk, makeAuthConfig(), false)
+
+    await expect(provider.login({ email: 'test@example.com', password: 'secret' })).rejects.toMatchObject({
       name: 'ProviderAPIError',
-      provider: 'NOT_AUTHENTICATED',
-      status: 401,
+      code: 'PROVIDER_API_ERROR',
+      provider: 'LOGIN_FAILED',
+      message: 'Authentication failed: bad credentials',
     })
   })
 
-  it('throws ProviderAPIError with CHANNEL_RESOLUTION_FAILED on 400', async () => {
-    server.use(
-      http.post(`${BASE}/store/thor/customers/me/channels`, () =>
-        HttpResponse.json({ message: 'No sales channel found for publishable key' }, { status: 400 }),
-      ),
-    )
+  it('returns requiresAction when login requires verification (v2.16.0)', async () => {
+    const sdk = makeSdkStub()
+    sdk.auth.login = vi.fn().mockResolvedValue({ verification_required: true, token: 'verify-token' })
 
-    await expect(makeProvider().linkCustomerToChannel()).rejects.toMatchObject({
-      name: 'ProviderAPIError',
-      provider: 'CHANNEL_RESOLUTION_FAILED',
-      status: 400,
+    const provider = new MedusaAuthProvider(sdk, makeAuthConfig(), false)
+    const result = await provider.login({ email: 'test@example.com', password: 'secret' })
+
+    expect(result.requiresAction).toBe(true)
+    expect(result.token).toBe('verify-token')
+  })
+
+  it('stores jwt token and returns customer on register (v2.16.0)', async () => {
+    const sdk = makeSdkStub()
+    sdk.auth.register = vi.fn().mockResolvedValue(undefined)
+    sdk.auth.login = vi.fn().mockResolvedValue('jwt-bearer-token')
+    sdk.store.customer.create = vi.fn().mockResolvedValue({
+      customer: { id: 'cus_1', email: 'test@example.com', first_name: 'Test', last_name: 'User' },
+    })
+    sdk.store.customer.retrieve = vi.fn().mockResolvedValue({
+      customer: { id: 'cus_1', email: 'test@example.com', first_name: 'Test', last_name: 'User' },
+    })
+
+    const provider = new MedusaAuthProvider(sdk, makeAuthConfig('jwt-bearer-token'), false)
+
+    const result = await provider.register({
+      email: 'test@example.com',
+      password: 'secret',
+      first_name: 'Test',
+      last_name: 'User',
     })
+
+    expect(sdk.auth.register).toHaveBeenCalledWith('customer', 'emailpass', {
+      email: 'test@example.com',
+      password: 'secret',
+    })
+    expect(sdk.auth.login).toHaveBeenCalledWith('customer', 'emailpass', {
+      email: 'test@example.com',
+      password: 'secret',
+    })
+    expect(result.token).toBe('jwt-bearer-token')
+    expect(result.customer?.email).toBe('test@example.com')
   })
 
-  it('throws ProviderAPIError with LINK_CHANNEL_FAILED on unexpected status', async () => {
-    server.use(
-      http.post(`${BASE}/store/thor/customers/me/channels`, () =>
-        HttpResponse.json({ message: 'Service unavailable' }, { status: 503 }),
-      ),
-    )
+  it('requires email when resetting password', async () => {
+    const provider = makeProvider()
 
-    await expect(makeProvider().linkCustomerToChannel()).rejects.toMatchObject({
+    await expect(provider.resetPassword('token', 'new-password')).rejects.toMatchObject({
       name: 'ProviderAPIError',
-      provider: 'LINK_CHANNEL_FAILED',
+      provider: 'MEDUSA_AUTH_PROVIDER',
+      status: 400,
     })
   })
 })