@thorprovider/adapters 5.0.0 → 5.0.2

package/src/providers/shopify/queries.ts

@@ -0,0 +1,324 @@
+/**
+ * @thorprovider/adapters — Shopify Provider
+ * GraphQL query definitions for Storefront API
+ */
+
+export const PRODUCT_FRAGMENT = `
+  fragment ProductFields on Product {
+    id
+    title
+    handle
+    description
+    descriptionHtml
+    vendor
+    productType
+    tags
+    availableForSale
+    createdAt
+    updatedAt
+    seo {
+      title
+      description
+    }
+    featuredImage {
+      url
+      altText
+      width
+      height
+    }
+    images(first: 10) {
+      edges {
+        node {
+          url
+          altText
+          width
+          height
+        }
+      }
+    }
+    priceRange {
+      minVariantPrice {
+        amount
+        currencyCode
+      }
+      maxVariantPrice {
+        amount
+        currencyCode
+      }
+    }
+    options {
+      id
+      name
+      values
+    }
+    variants(first: 100) {
+      edges {
+        node {
+          id
+          title
+          availableForSale
+          price {
+            amount
+            currencyCode
+          }
+          compareAtPrice {
+            amount
+            currencyCode
+          }
+          selectedOptions {
+            name
+            value
+          }
+          image {
+            url
+            altText
+            width
+            height
+          }
+        }
+      }
+    }
+  }
+`;
+
+export const GET_PRODUCT_BY_HANDLE = `
+  query GetProductByHandle($handle: String!) {
+    product(handle: $handle) {
+      ...ProductFields
+    }
+  }
+  ${PRODUCT_FRAGMENT}
+`;
+
+export const GET_PRODUCTS = `
+  query GetProducts($first: Int!, $query: String, $sortKey: ProductSortKeys, $reverse: Boolean, $after: String) {
+    products(first: $first, query: $query, sortKey: $sortKey, reverse: $reverse, after: $after) {
+      edges {
+        node {
+          ...ProductFields
+        }
+        cursor
+      }
+      pageInfo {
+        hasNextPage
+        hasPreviousPage
+      }
+    }
+  }
+  ${PRODUCT_FRAGMENT}
+`;
+
+export const GET_PRODUCT_RECOMMENDATIONS = `
+  query GetProductRecommendations($productId: ID!) {
+    productRecommendations(productId: $productId) {
+      ...ProductFields
+    }
+  }
+  ${PRODUCT_FRAGMENT}
+`;
+
+export const COLLECTION_FRAGMENT = `
+  fragment CollectionFields on Collection {
+    id
+    title
+    handle
+    description
+    image {
+      url
+      altText
+      width
+      height
+    }
+    seo {
+      title
+      description
+    }
+    updatedAt
+  }
+`;
+
+export const GET_COLLECTION_BY_HANDLE = `
+  query GetCollectionByHandle($handle: String!) {
+    collection(handle: $handle) {
+      ...CollectionFields
+    }
+  }
+  ${COLLECTION_FRAGMENT}
+`;
+
+export const GET_COLLECTIONS = `
+  query GetCollections($first: Int!) {
+    collections(first: $first) {
+      edges {
+        node {
+          ...CollectionFields
+        }
+      }
+    }
+  }
+  ${COLLECTION_FRAGMENT}
+`;
+
+export const GET_COLLECTION_PRODUCTS = `
+  query GetCollectionProducts($handle: String!, $first: Int!, $sortKey: ProductCollectionSortKeys, $reverse: Boolean, $after: String) {
+    collection(handle: $handle) {
+      products(first: $first, sortKey: $sortKey, reverse: $reverse, after: $after) {
+        edges {
+          node {
+            ...ProductFields
+          }
+          cursor
+        }
+        pageInfo {
+          hasNextPage
+        }
+      }
+    }
+  }
+  ${PRODUCT_FRAGMENT}
+`;
+
+export const CART_FRAGMENT = `
+  fragment CartFields on Cart {
+    id
+    checkoutUrl
+    totalQuantity
+    cost {
+      subtotalAmount {
+        amount
+        currencyCode
+      }
+      totalAmount {
+        amount
+        currencyCode
+      }
+      totalTaxAmount {
+        amount
+        currencyCode
+      }
+    }
+    lines(first: 100) {
+      edges {
+        node {
+          id
+          quantity
+          cost {
+            totalAmount {
+              amount
+              currencyCode
+            }
+          }
+          merchandise {
+            ... on ProductVariant {
+              id
+              title
+              selectedOptions {
+                name
+                value
+              }
+              product {
+                id
+                handle
+                title
+                featuredImage {
+                  url
+                  altText
+                  width
+                  height
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+`;
+
+export const GET_CART = `
+  query GetCart($cartId: ID!) {
+    cart(id: $cartId) {
+      ...CartFields
+    }
+  }
+  ${CART_FRAGMENT}
+`;
+
+export const GET_CUSTOMER = `
+  query GetCustomer {
+    customer {
+      id
+      firstName
+      lastName
+      email
+      phone
+      defaultAddress {
+        id
+        address1
+        address2
+        city
+        province
+        country
+        zip
+        phone
+        firstName
+        lastName
+      }
+      addresses(first: 20) {
+        edges {
+          node {
+            id
+            address1
+            address2
+            city
+            province
+            country
+            zip
+            phone
+            firstName
+            lastName
+          }
+        }
+      }
+      orders(first: 50) {
+        edges {
+          node {
+            id
+            orderNumber
+            processedAt
+            financialStatus
+            fulfillmentStatus
+            totalPrice {
+              amount
+              currencyCode
+            }
+            lineItems(first: 50) {
+              edges {
+                node {
+                  title
+                  quantity
+                  variant {
+                    id
+                    title
+                    price {
+                      amount
+                      currencyCode
+                    }
+                    image {
+                      url
+                      altText
+                    }
+                    product {
+                      id
+                      handle
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+`;

package/src/providers/shopify/shopify.ts

@@ -0,0 +1,7 @@
+/**
+ * @thorprovider/adapters — Shopify Provider exports
+ */
+
+export { ShopifyProvider } from './index';
+export type { ShopifyProviderConfig } from './index';
+export * from './transforms';

package/src/providers/shopify/transforms.ts

@@ -0,0 +1,275 @@
+/**
+ * @thorprovider/adapters — Shopify Provider
+ * Transform functions: Shopify GraphQL 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(shopifyMoney: { amount: string; currencyCode: string } | null | undefined): Money {
+  return {
+    amount: shopifyMoney?.amount ?? '0.00',
+    currencyCode: shopifyMoney?.currencyCode?.toUpperCase() ?? 'USD',
+  };
+}
+
+function transformImage(shopifyImage: { url: string; altText?: string | null; width?: number; height?: number } | null | undefined): Image {
+  return {
+    url: shopifyImage?.url ?? '',
+    altText: shopifyImage?.altText ?? '',
+    width: shopifyImage?.width ?? 800,
+    height: shopifyImage?.height ?? 800,
+  };
+}
+
+// ============================================
+// Product Transforms
+// ============================================
+
+function transformVariant(raw: any): ProductVariant {
+  return {
+    id: raw.id,
+    title: raw.title ?? '',
+    availableForSale: raw.availableForSale ?? true,
+    price: transformMoney(raw.price),
+    compareAtPrice: raw.compareAtPrice ? transformMoney(raw.compareAtPrice) : undefined,
+    selectedOptions: (raw.selectedOptions ?? []).map((opt: any) => ({
+      name: opt.name,
+      value: opt.value,
+    })),
+    image: raw.image ? transformImage(raw.image) : undefined,
+  };
+}
+
+function transformOption(raw: any): ProductOption {
+  return {
+    id: raw.id,
+    name: raw.name,
+    values: raw.values ?? [],
+  };
+}
+
+export function transformProduct(raw: any): Product {
+  const images = (raw.images?.edges ?? []).map((edge: any) => transformImage(edge.node));
+  const variants = (raw.variants?.edges ?? []).map((edge: any) => transformVariant(edge.node));
+
+  return {
+    id: raw.id,
+    handle: raw.handle,
+    title: raw.title,
+    description: raw.description ?? '',
+    descriptionHtml: raw.descriptionHtml ?? '',
+    availableForSale: raw.availableForSale ?? true,
+    featuredImage: raw.featuredImage ? transformImage(raw.featuredImage) : (images[0] ?? { url: '', altText: '', width: 800, height: 800 }),
+    images,
+    options: (raw.options ?? []).map(transformOption),
+    variants,
+    priceRange: {
+      minVariantPrice: transformMoney(raw.priceRange?.minVariantPrice),
+      maxVariantPrice: transformMoney(raw.priceRange?.maxVariantPrice),
+    },
+    seo: {
+      title: raw.seo?.title ?? raw.title ?? '',
+      description: raw.seo?.description ?? raw.description ?? '',
+    },
+    tags: raw.tags ?? [],
+    createdAt: raw.createdAt ?? new Date().toISOString(),
+    updatedAt: raw.updatedAt ?? new Date().toISOString(),
+    vendor: raw.vendor,
+    productType: raw.productType,
+  };
+}
+
+// ============================================
+// Collection Transforms
+// ============================================
+
+export function transformCollection(raw: any): Collection {
+  return {
+    id: raw.id ?? '',
+    handle: raw.handle,
+    title: raw.title,
+    description: raw.description ?? '',
+    seo: {
+      title: raw.seo?.title ?? raw.title ?? '',
+      description: raw.seo?.description ?? raw.description ?? '',
+    },
+    updatedAt: raw.updatedAt ?? new Date().toISOString(),
+    path: `/collections/${raw.handle}`,
+  };
+}
+
+// ============================================
+// Cart Transforms
+// ============================================
+
+function transformCartItem(raw: any): CartItem {
+  const merchandise = raw.merchandise ?? {};
+  const product = merchandise.product ?? {};
+
+  return {
+    id: raw.id,
+    quantity: raw.quantity ?? 1,
+    cost: {
+      totalAmount: transformMoney(raw.cost?.totalAmount),
+    },
+    merchandise: {
+      id: merchandise.id ?? '',
+      title: merchandise.title ?? '',
+      selectedOptions: (merchandise.selectedOptions ?? []).map((opt: any) => ({
+        name: opt.name,
+        value: opt.value,
+      })),
+      product: {
+        id: product.id ?? '',
+        handle: product.handle ?? '',
+        title: product.title ?? '',
+        featuredImage: product.featuredImage
+          ? transformImage(product.featuredImage)
+          : { url: '', altText: '', width: 800, height: 800 },
+      },
+    },
+  };
+}
+
+export function transformCart(raw: any): Cart {
+  const lines = (raw.lines?.edges ?? []).map((edge: any) => transformCartItem(edge.node));
+
+  return {
+    id: raw.id,
+    checkoutUrl: raw.checkoutUrl ?? '',
+    totalQuantity: raw.totalQuantity ?? 0,
+    cost: {
+      subtotalAmount: transformMoney(raw.cost?.subtotalAmount),
+      totalAmount: transformMoney(raw.cost?.totalAmount),
+      totalTaxAmount: raw.cost?.totalTaxAmount ? transformMoney(raw.cost.totalTaxAmount) : undefined,
+    },
+    lines,
+  };
+}
+
+// ============================================
+// Customer Transforms
+// ============================================
+
+export function transformAddress(raw: any): Address {
+  return {
+    id: raw.id ?? '',
+    firstName: raw.firstName ?? '',
+    lastName: raw.lastName ?? '',
+    address1: raw.address1 ?? '',
+    address2: raw.address2 ?? '',
+    city: raw.city ?? '',
+    province: raw.province ?? '',
+    countryCode: raw.country ?? raw.countryCodeV2 ?? '',
+    postalCode: raw.zip ?? '',
+    phone: raw.phone ?? '',
+    company: raw.company ?? '',
+  };
+}
+
+export function transformCustomer(raw: any): Customer {
+  return {
+    id: raw.id ?? '',
+    email: raw.email ?? '',
+    firstName: raw.firstName ?? '',
+    lastName: raw.lastName ?? '',
+    phone: raw.phone ?? '',
+    hasAccount: true,
+  };
+}
+
+export function transformCustomerAddresses(raw: any): Address[] {
+  const edges = raw.addresses?.edges ?? [];
+  return edges.map((edge: any) => transformAddress(edge.node));
+}
+
+// ============================================
+// Order Transforms
+// ============================================
+
+function mapFinancialStatus(status: string | null | undefined): PaymentStatus {
+  switch (status?.toUpperCase()) {
+    case 'PAID': return 'paid';
+    case 'PENDING': return 'pending';
+    case 'AUTHORIZED': return 'authorized';
+    case 'REFUNDED': return 'refunded';
+    case 'PARTIALLY_REFUNDED': return 'partially_refunded';
+    default: return 'pending';
+  }
+}
+
+function mapFulfillmentStatus(status: string | null | undefined): FulfillmentStatus {
+  switch (status?.toUpperCase()) {
+    case 'FULFILLED': return 'fulfilled';
+    case 'PARTIAL': return 'partially_fulfilled';
+    case 'UNFULFILLED': return 'unfulfilled';
+    default: return 'unfulfilled';
+  }
+}
+
+function deriveOrderStatus(financial: string | null, fulfillment: string | null): OrderStatus {
+  if (financial?.toUpperCase() === 'VOIDED') return 'cancelled';
+  if (financial?.toUpperCase() === 'REFUNDED') return 'refunded';
+  if (fulfillment?.toUpperCase() === 'FULFILLED') return 'completed';
+  if (financial?.toUpperCase() === 'PAID') return 'processing';
+  return 'pending';
+}
+
+function transformOrderItem(raw: any): OrderItem {
+  const variant = raw.variant ?? {};
+  const product = variant.product ?? {};
+
+  return {
+    id: variant.id ?? raw.title ?? '',
+    title: raw.title ?? '',
+    variantTitle: variant.title ?? '',
+    quantity: raw.quantity ?? 1,
+    price: transformMoney(variant.price),
+    total: {
+      amount: ((parseFloat(variant.price?.amount ?? '0')) * (raw.quantity ?? 1)).toFixed(2),
+      currencyCode: variant.price?.currencyCode ?? 'USD',
+    },
+    productId: product.id,
+    variantId: variant.id,
+  };
+}
+
+export function transformOrder(raw: any): Order {
+  const items = (raw.lineItems?.edges ?? []).map((edge: any) => transformOrderItem(edge.node));
+
+  return {
+    id: raw.id ?? '',
+    orderNumber: raw.orderNumber?.toString() ?? '',
+    email: raw.email ?? '',
+    status: deriveOrderStatus(raw.financialStatus, raw.fulfillmentStatus),
+    paymentStatus: mapFinancialStatus(raw.financialStatus),
+    fulfillmentStatus: mapFulfillmentStatus(raw.fulfillmentStatus),
+    items,
+    total: transformMoney(raw.totalPrice),
+    subtotal: transformMoney(raw.subtotalPrice ?? raw.totalPrice),
+    tax: { amount: '0.00', currencyCode: raw.totalPrice?.currencyCode ?? 'USD' },
+    shipping: { amount: '0.00', currencyCode: raw.totalPrice?.currencyCode ?? 'USD' },
+    createdAt: raw.processedAt ?? new Date().toISOString(),
+    updatedAt: raw.processedAt ?? new Date().toISOString(),
+  };
+}