@pvh-afl/core 1.0.0

package/dist/integrations/commerce/shopify.service.js

@@ -0,0 +1,735 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ShopifyCommerceService = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const base_integration_service_1 = require("../base-integration.service");
+const logger_1 = require("../../common/logger");
+// GraphQL Queries
+const PRODUCTS_QUERY = `
+  query Products($first: Int!, $after: String) {
+    products(first: $first, after: $after) {
+      edges {
+        node {
+          id
+          handle
+          title
+          description
+          descriptionHtml
+          vendor
+          productType
+          tags
+          featuredImage { url altText width height }
+          images(first: 30) {
+            edges { node { url altText width height } }
+          }
+          variants(first: 100) {
+            edges {
+              node {
+                id
+                title
+                availableForSale
+                price { amount currencyCode }
+                compareAtPrice { amount currencyCode }
+                selectedOptions { name value }
+                image { url altText width height }
+              }
+            }
+          }
+          priceRange {
+            minVariantPrice { amount currencyCode }
+            maxVariantPrice { amount currencyCode }
+          }
+        }
+        cursor
+      }
+      pageInfo {
+        hasNextPage
+        hasPreviousPage
+        startCursor
+        endCursor
+      }
+    }
+  }
+`;
+const PRODUCT_BY_ID_QUERY = `
+  query ProductById($id: ID!) {
+    product(id: $id) {
+      id
+      handle
+      title
+      description
+      descriptionHtml
+      vendor
+      productType
+      tags
+      featuredImage { url altText width height }
+      images(first: 30) {
+        edges { node { url altText width height } }
+      }
+      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 }
+          }
+        }
+      }
+      priceRange {
+        minVariantPrice { amount currencyCode }
+        maxVariantPrice { amount currencyCode }
+      }
+    }
+  }
+`;
+const PRODUCT_BY_HANDLE_QUERY = `
+  query ProductByHandle($handle: String!) {
+    productByHandle(handle: $handle) {
+      id
+      handle
+      title
+      description
+      descriptionHtml
+      vendor
+      productType
+      tags
+      featuredImage { url altText width height }
+      images(first: 30) {
+        edges { node { url altText width height } }
+      }
+      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 }
+          }
+        }
+      }
+      priceRange {
+        minVariantPrice { amount currencyCode }
+        maxVariantPrice { amount currencyCode }
+      }
+    }
+  }
+`;
+const PRODUCT_RECOMMENDATIONS_QUERY = `
+  query ProductRecommendations($productId: ID!, $intent: ProductRecommendationIntent!) {
+    productRecommendations(productId: $productId, intent: $intent) {
+      id
+      handle
+      title
+      vendor
+      productType
+      featuredImage { url altText width height }
+      priceRange {
+        minVariantPrice { amount currencyCode }
+        maxVariantPrice { amount currencyCode }
+      }
+    }
+  }
+`;
+const COLLECTIONS_QUERY = `
+  query Collections($first: Int!) {
+    collections(first: $first) {
+      edges {
+        node {
+          id
+          handle
+          title
+          description
+          image { url altText width height }
+        }
+        cursor
+      }
+      pageInfo {
+        hasNextPage
+        hasPreviousPage
+        startCursor
+        endCursor
+      }
+    }
+  }
+`;
+const COLLECTION_BY_HANDLE_QUERY = `
+  query CollectionByHandle($handle: String!, $productsFirst: Int!) {
+    collection(handle: $handle) {
+      id
+      handle
+      title
+      description
+      image { url altText width height }
+      products(first: $productsFirst) {
+        edges {
+          node {
+            handle
+          }
+        }
+      }
+    }
+  }
+`;
+const MENU_QUERY = `
+  query Menu($handle: String!) {
+    menu(handle: $handle) {
+      id
+      handle
+      title
+      items {
+        id
+        title
+        url
+        items {
+          id
+          title
+          url
+        }
+      }
+    }
+  }
+`;
+const PAGE_BY_HANDLE_QUERY = `
+  query PageByHandle($handle: String!) {
+    page(handle: $handle) {
+      id
+      handle
+      title
+      body
+      bodySummary
+    }
+  }
+`;
+// Reusable cart fields fragment
+const CART_FIELDS = `
+  id
+  checkoutUrl
+  totalQuantity
+  lines(first: 100) {
+    edges {
+      node {
+        id
+        quantity
+        merchandise {
+          ... on ProductVariant {
+            id
+            title
+            selectedOptions { name value }
+            product { id title handle options { id name values } }
+            image { url altText width height }
+            price { amount currencyCode }
+          }
+        }
+        cost { totalAmount { amount currencyCode } }
+        discountAllocations {
+          discountedAmount { amount currencyCode }
+          ... on CartAutomaticDiscountAllocation {
+            title
+          }
+          ... on CartCodeDiscountAllocation {
+            code
+          }
+        }
+      }
+    }
+  }
+  cost {
+    subtotalAmount { amount currencyCode }
+    totalAmount { amount currencyCode }
+    totalTaxAmount { amount currencyCode }
+  }
+  discountCodes {
+    code
+    applicable
+  }
+  discountAllocations {
+    discountedAmount { amount currencyCode }
+  }
+  buyerIdentity {
+    email
+    phone
+    countryCode
+    customer {
+      id
+      email
+      firstName
+      lastName
+      phone
+      displayName
+    }
+    deliveryAddressPreferences {
+      __typename
+      ... on MailingAddress {
+        address1
+        address2
+        city
+        company
+        country
+        countryCodeV2
+        firstName
+        lastName
+        phone
+        province
+        provinceCode
+        zip
+      }
+    }
+  }
+  note
+  attributes {
+    key
+    value
+  }
+  appliedGiftCards {
+    id
+    lastCharacters
+    amountUsed { amount currencyCode }
+    balance { amount currencyCode }
+  }
+  deliveryGroups(first: 10) {
+    edges {
+      node {
+        id
+        deliveryAddress {
+          address1
+          address2
+          city
+          company
+          country
+          countryCodeV2
+          firstName
+          lastName
+          phone
+          province
+          provinceCode
+          zip
+        }
+        deliveryOptions {
+          code
+          deliveryMethodType
+          description
+          estimatedCost { amount currencyCode }
+          handle
+          title
+        }
+        selectedDeliveryOption {
+          code
+          deliveryMethodType
+          description
+          estimatedCost { amount currencyCode }
+          handle
+          title
+        }
+      }
+    }
+  }
+`;
+const CART_CREATE_MUTATION = `
+  mutation CartCreate {
+    cartCreate {
+      cart {
+        ${CART_FIELDS}
+      }
+    }
+  }
+`;
+const CART_LINES_ADD_MUTATION = `
+  mutation CartLinesAdd($cartId: ID!, $lines: [CartLineInput!]!) {
+    cartLinesAdd(cartId: $cartId, lines: $lines) {
+      cart {
+        ${CART_FIELDS}
+      }
+    }
+  }
+`;
+const CART_QUERY = `
+  query Cart($id: ID!) {
+    cart(id: $id) {
+      ${CART_FIELDS}
+    }
+  }
+`;
+const CART_LINES_UPDATE_MUTATION = `
+  mutation CartLinesUpdate($cartId: ID!, $lines: [CartLineUpdateInput!]!) {
+    cartLinesUpdate(cartId: $cartId, lines: $lines) {
+      cart {
+        ${CART_FIELDS}
+      }
+      userErrors {
+        field
+        message
+      }
+    }
+  }
+`;
+const CART_LINES_REMOVE_MUTATION = `
+  mutation CartLinesRemove($cartId: ID!, $lineIds: [ID!]!) {
+    cartLinesRemove(cartId: $cartId, lineIds: $lineIds) {
+      cart {
+        ${CART_FIELDS}
+      }
+      userErrors {
+        field
+        message
+      }
+    }
+  }
+`;
+const CART_DISCOUNT_CODES_UPDATE_MUTATION = `
+  mutation CartDiscountCodesUpdate($cartId: ID!, $discountCodes: [String!]!) {
+    cartDiscountCodesUpdate(cartId: $cartId, discountCodes: $discountCodes) {
+      cart {
+        ${CART_FIELDS}
+      }
+      userErrors {
+        field
+        message
+      }
+    }
+  }
+`;
+const CART_BUYER_IDENTITY_UPDATE_MUTATION = `
+  mutation CartBuyerIdentityUpdate($cartId: ID!, $buyerIdentity: CartBuyerIdentityInput!) {
+    cartBuyerIdentityUpdate(cartId: $cartId, buyerIdentity: $buyerIdentity) {
+      cart {
+        ${CART_FIELDS}
+      }
+      userErrors {
+        field
+        message
+      }
+    }
+  }
+`;
+const CART_NOTE_UPDATE_MUTATION = `
+  mutation CartNoteUpdate($cartId: ID!, $note: String!) {
+    cartNoteUpdate(cartId: $cartId, note: $note) {
+      cart {
+        ${CART_FIELDS}
+      }
+      userErrors {
+        field
+        message
+      }
+    }
+  }
+`;
+const CART_ATTRIBUTES_UPDATE_MUTATION = `
+  mutation CartAttributesUpdate($cartId: ID!, $attributes: [AttributeInput!]!) {
+    cartAttributesUpdate(cartId: $cartId, attributes: $attributes) {
+      cart {
+        ${CART_FIELDS}
+      }
+      userErrors {
+        field
+        message
+      }
+    }
+  }
+`;
+const CART_GIFT_CARD_CODES_UPDATE_MUTATION = `
+  mutation CartGiftCardCodesUpdate($cartId: ID!, $giftCardCodes: [String!]!) {
+    cartGiftCardCodesUpdate(cartId: $cartId, giftCardCodes: $giftCardCodes) {
+      cart {
+        ${CART_FIELDS}
+      }
+      userErrors {
+        field
+        message
+      }
+    }
+  }
+`;
+/**
+ * Shopify Commerce Service
+ *
+ * Implementation of ICommerceService using Shopify Storefront API.
+ * Extends BaseIntegrationService to get retry logic, error normalization, and health checks.
+ */
+let ShopifyCommerceService = class ShopifyCommerceService extends base_integration_service_1.BaseIntegrationService {
+    name = "shopify-commerce";
+    /**
+     * Execute a GraphQL query against Shopify Storefront API
+     */
+    async graphqlQuery(query, variables = {}) {
+        const response = await this.request("POST", "", { query, variables });
+        if (!response.success) {
+            return response;
+        }
+        // Check for GraphQL-level errors
+        if (response.data?.errors?.length) {
+            logger_1.logger.error("Shopify GraphQL errors", {
+                brand: this.brand,
+                errors: response.data.errors,
+            });
+            return {
+                success: false,
+                error: {
+                    code: "GRAPHQL_ERROR",
+                    message: response.data.errors[0]?.message ?? "GraphQL query failed",
+                    details: response.data.errors,
+                },
+            };
+        }
+        return {
+            success: true,
+            data: response.data?.data,
+        };
+    }
+    // Products
+    async getProducts(params = {}) {
+        const response = await this.graphqlQuery(PRODUCTS_QUERY, { first: params.first ?? 20, after: params.after });
+        if (!response.success || !response.data) {
+            return { success: false, error: response.error };
+        }
+        return { success: true, data: response.data.products };
+    }
+    async getProductById(id) {
+        const response = await this.graphqlQuery(PRODUCT_BY_ID_QUERY, { id });
+        if (!response.success || !response.data) {
+            return { success: false, error: response.error };
+        }
+        return { success: true, data: response.data.product };
+    }
+    async getProductByHandle(handle) {
+        const response = await this.graphqlQuery(PRODUCT_BY_HANDLE_QUERY, { handle });
+        if (!response.success || !response.data) {
+            return { success: false, error: response.error };
+        }
+        return { success: true, data: response.data.productByHandle };
+    }
+    // Product Recommendations
+    async getProductRecommendations(productId, count = 5) {
+        const response = await this.graphqlQuery(PRODUCT_RECOMMENDATIONS_QUERY, { productId, intent: "RELATED" });
+        if (!response.success || !response.data) {
+            return { success: false, error: response.error };
+        }
+        const recommendations = response.data.productRecommendations || [];
+        return { success: true, data: recommendations.slice(0, count) };
+    }
+    // Collections
+    async getCollections(params = {}) {
+        const response = await this.graphqlQuery(COLLECTIONS_QUERY, { first: params.first ?? 20 });
+        if (!response.success || !response.data) {
+            return { success: false, error: response.error };
+        }
+        return { success: true, data: response.data.collections };
+    }
+    async getCollectionByHandle(handle, productsFirst = 20) {
+        const response = await this.graphqlQuery(COLLECTION_BY_HANDLE_QUERY, { handle, productsFirst });
+        if (!response.success || !response.data) {
+            return { success: false, error: response.error };
+        }
+        if (!response.data.collection) {
+            return { success: true, data: null };
+        }
+        const collection = {
+            id: response.data.collection.id,
+            handle: response.data.collection.handle,
+            title: response.data.collection.title,
+            description: response.data.collection.description,
+            image: response.data.collection.image,
+            productRefs: response.data.collection.products
+                ? { edges: response.data.collection.products.edges }
+                : undefined,
+        };
+        return { success: true, data: collection };
+    }
+    // CMS
+    async getMenu(handle) {
+        const response = await this.graphqlQuery(MENU_QUERY, { handle });
+        if (!response.success || !response.data) {
+            return { success: false, error: response.error };
+        }
+        return { success: true, data: response.data.menu };
+    }
+    async getPage(handle) {
+        const response = await this.graphqlQuery(PAGE_BY_HANDLE_QUERY, { handle });
+        if (!response.success || !response.data) {
+            return { success: false, error: response.error };
+        }
+        return { success: true, data: response.data.page };
+    }
+    // Cart
+    async createCart() {
+        const response = await this.graphqlQuery(CART_CREATE_MUTATION);
+        if (!response.success || !response.data) {
+            return { success: false, error: response.error };
+        }
+        return { success: true, data: response.data.cartCreate.cart };
+    }
+    async getCart(cartId) {
+        const response = await this.graphqlQuery(CART_QUERY, { id: cartId });
+        if (!response.success || !response.data) {
+            return { success: false, error: response.error };
+        }
+        return { success: true, data: response.data.cart };
+    }
+    async addToCart(cartId, lines) {
+        const response = await this.graphqlQuery(CART_LINES_ADD_MUTATION, { cartId, lines });
+        if (!response.success || !response.data) {
+            return { success: false, error: response.error };
+        }
+        return { success: true, data: response.data.cartLinesAdd.cart };
+    }
+    async updateCartLines(cartId, lines) {
+        const response = await this.graphqlQuery(CART_LINES_UPDATE_MUTATION, { cartId, lines });
+        if (!response.success || !response.data) {
+            return { success: false, error: response.error };
+        }
+        if (response.data.cartLinesUpdate.userErrors?.length) {
+            const error = response.data.cartLinesUpdate.userErrors[0];
+            return {
+                success: false,
+                error: {
+                    code: "CART_LINES_UPDATE_ERROR",
+                    message: error?.message ?? "Failed to update cart lines",
+                    details: response.data.cartLinesUpdate.userErrors,
+                },
+            };
+        }
+        return { success: true, data: response.data.cartLinesUpdate.cart };
+    }
+    async removeCartLines(cartId, lineIds) {
+        const response = await this.graphqlQuery(CART_LINES_REMOVE_MUTATION, { cartId, lineIds });
+        if (!response.success || !response.data) {
+            return { success: false, error: response.error };
+        }
+        if (response.data.cartLinesRemove.userErrors?.length) {
+            const error = response.data.cartLinesRemove.userErrors[0];
+            return {
+                success: false,
+                error: {
+                    code: "CART_LINES_REMOVE_ERROR",
+                    message: error?.message ?? "Failed to remove cart lines",
+                    details: response.data.cartLinesRemove.userErrors,
+                },
+            };
+        }
+        return { success: true, data: response.data.cartLinesRemove.cart };
+    }
+    async updateCartDiscountCodes(cartId, discountCodes) {
+        const response = await this.graphqlQuery(CART_DISCOUNT_CODES_UPDATE_MUTATION, { cartId, discountCodes });
+        if (!response.success || !response.data) {
+            return { success: false, error: response.error };
+        }
+        if (response.data.cartDiscountCodesUpdate.userErrors?.length) {
+            const error = response.data.cartDiscountCodesUpdate.userErrors[0];
+            return {
+                success: false,
+                error: {
+                    code: "CART_DISCOUNT_CODES_UPDATE_ERROR",
+                    message: error?.message ?? "Failed to update discount codes",
+                    details: response.data.cartDiscountCodesUpdate.userErrors,
+                },
+            };
+        }
+        return { success: true, data: response.data.cartDiscountCodesUpdate.cart };
+    }
+    async updateCartBuyerIdentity(cartId, buyerIdentity) {
+        const response = await this.graphqlQuery(CART_BUYER_IDENTITY_UPDATE_MUTATION, { cartId, buyerIdentity });
+        if (!response.success || !response.data) {
+            return { success: false, error: response.error };
+        }
+        if (response.data.cartBuyerIdentityUpdate.userErrors?.length) {
+            const error = response.data.cartBuyerIdentityUpdate.userErrors[0];
+            return {
+                success: false,
+                error: {
+                    code: "CART_BUYER_IDENTITY_UPDATE_ERROR",
+                    message: error?.message ?? "Failed to update buyer identity",
+                    details: response.data.cartBuyerIdentityUpdate.userErrors,
+                },
+            };
+        }
+        return { success: true, data: response.data.cartBuyerIdentityUpdate.cart };
+    }
+    async updateCartNote(cartId, note) {
+        const response = await this.graphqlQuery(CART_NOTE_UPDATE_MUTATION, { cartId, note });
+        if (!response.success || !response.data) {
+            return { success: false, error: response.error };
+        }
+        if (response.data.cartNoteUpdate.userErrors?.length) {
+            const error = response.data.cartNoteUpdate.userErrors[0];
+            return {
+                success: false,
+                error: {
+                    code: "CART_NOTE_UPDATE_ERROR",
+                    message: error?.message ?? "Failed to update cart note",
+                    details: response.data.cartNoteUpdate.userErrors,
+                },
+            };
+        }
+        return { success: true, data: response.data.cartNoteUpdate.cart };
+    }
+    async updateCartAttributes(cartId, attributes) {
+        const response = await this.graphqlQuery(CART_ATTRIBUTES_UPDATE_MUTATION, { cartId, attributes });
+        if (!response.success || !response.data) {
+            return { success: false, error: response.error };
+        }
+        if (response.data.cartAttributesUpdate.userErrors?.length) {
+            const error = response.data.cartAttributesUpdate.userErrors[0];
+            return {
+                success: false,
+                error: {
+                    code: "CART_ATTRIBUTES_UPDATE_ERROR",
+                    message: error?.message ?? "Failed to update cart attributes",
+                    details: response.data.cartAttributesUpdate.userErrors,
+                },
+            };
+        }
+        return { success: true, data: response.data.cartAttributesUpdate.cart };
+    }
+    async updateCartGiftCardCodes(cartId, giftCardCodes) {
+        const response = await this.graphqlQuery(CART_GIFT_CARD_CODES_UPDATE_MUTATION, { cartId, giftCardCodes });
+        if (!response.success || !response.data) {
+            return { success: false, error: response.error };
+        }
+        if (response.data.cartGiftCardCodesUpdate.userErrors?.length) {
+            const error = response.data.cartGiftCardCodesUpdate.userErrors[0];
+            return {
+                success: false,
+                error: {
+                    code: "CART_GIFT_CARD_CODES_UPDATE_ERROR",
+                    message: error?.message ?? "Failed to update gift card codes",
+                    details: response.data.cartGiftCardCodesUpdate.userErrors,
+                },
+            };
+        }
+        return { success: true, data: response.data.cartGiftCardCodesUpdate.cart };
+    }
+    /**
+     * Health check for Shopify API
+     */
+    async healthCheck() {
+        const response = await this.graphqlQuery("{ shop { name } }");
+        return {
+            name: this.name,
+            healthy: response.success,
+            error: response.error?.message,
+        };
+    }
+};
+exports.ShopifyCommerceService = ShopifyCommerceService;
+exports.ShopifyCommerceService = ShopifyCommerceService = tslib_1.__decorate([
+    (0, common_1.Injectable)()
+], ShopifyCommerceService);
+//# sourceMappingURL=shopify.service.js.map