@thorprovider/adapters 3.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(),
+  };
+}