@pvh-afl/core 1.0.0

package/dist/integrations/commerce/commerce.types.d.ts

@@ -0,0 +1,301 @@
+/**
+ * Commerce Integration Types
+ *
+ * Defines the interface for commerce platforms (Shopify, BigCommerce, etc.)
+ * All commerce providers must implement ICommerceService.
+ */
+import { IntegrationResponse } from '../integration.types';
+export interface CommerceImage {
+    url: string;
+    altText: string | null;
+    width: number;
+    height: number;
+}
+export interface CommerceMoney {
+    amount: string;
+    currencyCode: string;
+}
+export interface CommercePriceRange {
+    minVariantPrice: CommerceMoney;
+    maxVariantPrice: CommerceMoney;
+}
+export interface CommercePageInfo {
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+    startCursor: string | null;
+    endCursor: string | null;
+}
+export interface CommerceConnection<T> {
+    edges: Array<{
+        node: T;
+        cursor: string;
+    }>;
+    pageInfo: CommercePageInfo;
+}
+export interface CommerceProductOption {
+    id: string;
+    name: string;
+    values: string[];
+}
+export interface CommerceProductVariant {
+    id: string;
+    title: string;
+    availableForSale: boolean;
+    price: CommerceMoney;
+    compareAtPrice: CommerceMoney | null;
+    selectedOptions: Array<{
+        name: string;
+        value: string;
+    }>;
+    image: CommerceImage | null;
+}
+export interface CommerceProduct {
+    id: string;
+    handle: string;
+    title: string;
+    description: string;
+    descriptionHtml: string;
+    images: {
+        edges: Array<{
+            node: CommerceImage;
+        }>;
+    };
+    options: CommerceProductOption[];
+    variants: {
+        edges: Array<{
+            node: CommerceProductVariant;
+        }>;
+    };
+    priceRange: CommercePriceRange;
+    featuredImage: CommerceImage | null;
+    tags: string[];
+    vendor: string;
+    productType: string;
+}
+export interface CommerceProductRef {
+    handle: string;
+}
+export interface CommerceCollection {
+    id: string;
+    handle: string;
+    title: string;
+    description: string;
+    image: CommerceImage | null;
+    productRefs?: {
+        edges: Array<{
+            node: CommerceProductRef;
+        }>;
+    };
+}
+export interface CommercePage {
+    id: string;
+    handle: string;
+    title: string;
+    body: string;
+    bodySummary: string;
+}
+export interface CommerceMenuItem {
+    id: string;
+    title: string;
+    url: string;
+    items: CommerceMenuItem[];
+}
+export interface CommerceMenu {
+    id: string;
+    handle: string;
+    title: string;
+    items: CommerceMenuItem[];
+}
+export interface CommerceCartLine {
+    id: string;
+    quantity: number;
+    merchandise: {
+        id: string;
+        title: string;
+        selectedOptions: Array<{
+            name: string;
+            value: string;
+        }>;
+        product: {
+            id: string;
+            title: string;
+            handle: string;
+            options: Array<{
+                id: string;
+                name: string;
+                values: string[];
+            }>;
+        };
+        image: CommerceImage | null;
+        price: CommerceMoney;
+    };
+    cost: {
+        totalAmount: CommerceMoney;
+    };
+    discountAllocations?: CommerceDiscountAllocation[];
+}
+export interface CommerceCart {
+    id: string;
+    checkoutUrl: string;
+    totalQuantity: number;
+    lines: {
+        edges: Array<{
+            node: CommerceCartLine;
+        }>;
+    };
+    cost: {
+        subtotalAmount: CommerceMoney;
+        totalAmount: CommerceMoney;
+        totalTaxAmount: CommerceMoney | null;
+    };
+    discountCodes: CommerceDiscountCode[];
+    discountAllocations: CommerceDiscountAllocation[];
+    buyerIdentity: CommerceBuyerIdentity | null;
+    note: string | null;
+    attributes: CommerceCartAttribute[];
+    appliedGiftCards: CommerceAppliedGiftCard[];
+    deliveryGroups: {
+        edges: Array<{
+            node: CommerceDeliveryGroup;
+        }>;
+    };
+}
+export interface ProductsParams {
+    first?: number;
+    after?: string;
+}
+export interface CollectionsParams {
+    first?: number;
+}
+export interface CartLineInput {
+    merchandiseId: string;
+    quantity: number;
+}
+export interface CartLineUpdateInput {
+    id: string;
+    quantity: number;
+}
+export interface CommerceDiscountCode {
+    code: string;
+    applicable: boolean;
+}
+export interface CommerceDiscountAllocation {
+    discountedAmount: CommerceMoney;
+    title?: string;
+    code?: string;
+}
+export interface CommerceCartAttribute {
+    key: string;
+    value: string | null;
+}
+export interface CartAttributeInput {
+    key: string;
+    value: string;
+}
+export interface CommerceAppliedGiftCard {
+    id: string;
+    lastCharacters: string;
+    amountUsed: CommerceMoney;
+    balance: CommerceMoney;
+}
+export interface CommerceDeliveryOption {
+    code: string | null;
+    deliveryMethodType: string;
+    description: string | null;
+    estimatedCost: CommerceMoney;
+    handle: string;
+    title: string;
+}
+export interface CommerceDeliveryGroup {
+    id: string;
+    deliveryAddress: CommerceMailingAddress | null;
+    deliveryOptions: CommerceDeliveryOption[];
+    selectedDeliveryOption: CommerceDeliveryOption | null;
+}
+export interface CommerceMailingAddress {
+    address1: string | null;
+    address2: string | null;
+    city: string | null;
+    company: string | null;
+    country: string | null;
+    countryCodeV2: string | null;
+    firstName: string | null;
+    lastName: string | null;
+    phone: string | null;
+    province: string | null;
+    provinceCode: string | null;
+    zip: string | null;
+}
+export interface CommerceCustomer {
+    id: string;
+    email: string | null;
+    firstName: string | null;
+    lastName: string | null;
+    phone: string | null;
+    displayName: string;
+}
+export interface CommerceDeliveryAddressPreference extends CommerceMailingAddress {
+    __typename?: string;
+}
+export interface CommerceBuyerIdentity {
+    email: string | null;
+    phone: string | null;
+    customer: CommerceCustomer | null;
+    countryCode: string | null;
+    deliveryAddressPreferences: CommerceDeliveryAddressPreference[];
+}
+export interface CartBuyerIdentityInput {
+    email?: string;
+    phone?: string;
+    countryCode?: string;
+    customerAccessToken?: string;
+    deliveryAddressPreferences?: Array<{
+        deliveryAddress: {
+            address1?: string;
+            address2?: string;
+            city?: string;
+            company?: string;
+            country?: string;
+            firstName?: string;
+            lastName?: string;
+            phone?: string;
+            province?: string;
+            zip?: string;
+        };
+    }>;
+}
+export interface CommerceProductRecommendation {
+    id: string;
+    handle: string;
+    title: string;
+    vendor: string;
+    productType: string;
+    featuredImage: CommerceImage | null;
+    priceRange: CommercePriceRange;
+}
+/**
+ * Commerce Service Interface
+ *
+ * All commerce providers (Shopify, BigCommerce, etc.) must implement this interface.
+ */
+export interface ICommerceService {
+    getProducts(params?: ProductsParams): Promise<IntegrationResponse<CommerceConnection<CommerceProduct>>>;
+    getProductById(id: string): Promise<IntegrationResponse<CommerceProduct | null>>;
+    getProductByHandle(handle: string): Promise<IntegrationResponse<CommerceProduct | null>>;
+    getProductRecommendations(productId: string, count?: number): Promise<IntegrationResponse<CommerceProductRecommendation[]>>;
+    getCollections(params?: CollectionsParams): Promise<IntegrationResponse<CommerceConnection<CommerceCollection>>>;
+    getCollectionByHandle(handle: string, productsFirst?: number): Promise<IntegrationResponse<CommerceCollection | null>>;
+    getMenu(handle: string): Promise<IntegrationResponse<CommerceMenu | null>>;
+    getPage(handle: string): Promise<IntegrationResponse<CommercePage | null>>;
+    createCart(): Promise<IntegrationResponse<CommerceCart>>;
+    getCart(cartId: string): Promise<IntegrationResponse<CommerceCart | null>>;
+    addToCart(cartId: string, lines: CartLineInput[]): Promise<IntegrationResponse<CommerceCart>>;
+    updateCartLines(cartId: string, lines: CartLineUpdateInput[]): Promise<IntegrationResponse<CommerceCart>>;
+    removeCartLines(cartId: string, lineIds: string[]): Promise<IntegrationResponse<CommerceCart>>;
+    updateCartDiscountCodes(cartId: string, discountCodes: string[]): Promise<IntegrationResponse<CommerceCart>>;
+    updateCartBuyerIdentity(cartId: string, buyerIdentity: CartBuyerIdentityInput): Promise<IntegrationResponse<CommerceCart>>;
+    updateCartNote(cartId: string, note: string): Promise<IntegrationResponse<CommerceCart>>;
+    updateCartAttributes(cartId: string, attributes: CartAttributeInput[]): Promise<IntegrationResponse<CommerceCart>>;
+    updateCartGiftCardCodes(cartId: string, giftCardCodes: string[]): Promise<IntegrationResponse<CommerceCart>>;
+}
+//# sourceMappingURL=commerce.types.d.ts.map

package/dist/integrations/commerce/commerce.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commerce.types.d.ts","sourceRoot":"","sources":["../../../src/integrations/commerce/commerce.types.ts"],"names":[],"mappings":"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"}

package/dist/integrations/commerce/commerce.types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Commerce Integration Types
+ *
+ * Defines the interface for commerce platforms (Shopify, BigCommerce, etc.)
+ * All commerce providers must implement ICommerceService.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=commerce.types.js.map

package/dist/integrations/commerce/commerce.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commerce.types.js","sourceRoot":"","sources":["../../../src/integrations/commerce/commerce.types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/integrations/commerce/index.d.ts

@@ -0,0 +1,4 @@
+export * from './commerce.types';
+export * from './shopify.service';
+export * from './shopify-admin.service';
+//# sourceMappingURL=index.d.ts.map

package/dist/integrations/commerce/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/integrations/commerce/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC"}

package/dist/integrations/commerce/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./commerce.types"), exports);
+tslib_1.__exportStar(require("./shopify.service"), exports);
+tslib_1.__exportStar(require("./shopify-admin.service"), exports);
+//# sourceMappingURL=index.js.map

package/dist/integrations/commerce/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/integrations/commerce/index.ts"],"names":[],"mappings":";;;AAAA,2DAAiC;AACjC,4DAAkC;AAClC,kEAAwC"}

package/dist/integrations/commerce/shopify-admin.service.d.ts

@@ -0,0 +1,35 @@
+import { ConfigService } from '../../config/config.service';
+import { CouponValidationResult } from '../loyalty/capillary.types';
+/**
+ * Shopify Admin API Service
+ *
+ * Handles Shopify Admin API operations for discount code management.
+ * Uses REST Admin API for price rules and discount codes.
+ */
+export declare class ShopifyAdminService {
+    private readonly configService;
+    private readonly API_VERSION;
+    private readonly COUPON_PREFIX;
+    constructor(configService: ConfigService);
+    /**
+     * Create a Shopify discount code from a validated Capillary coupon.
+     */
+    createDiscountFromCapillaryCoupon(brand: string, capillaryValidation: CouponValidationResult, shopifyCustomerId: string): Promise<ShopifyDiscountResult>;
+    private createPriceRule;
+    private createDiscountCode;
+    private getDiscountCodeByCode;
+    private findPriceRuleByTitle;
+    private findDiscountCodeByCode;
+    private getAdminConfig;
+    getWebhookSecret(brand: string): string;
+    private getHeaders;
+}
+export interface ShopifyDiscountResult {
+    success: boolean;
+    discountCode: string;
+    priceRuleId?: string;
+    discountCodeId?: string;
+    alreadyExists?: boolean;
+    error?: string;
+}
+//# sourceMappingURL=shopify-admin.service.d.ts.map

package/dist/integrations/commerce/shopify-admin.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shopify-admin.service.d.ts","sourceRoot":"","sources":["../../../src/integrations/commerce/shopify-admin.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAEpE;;;;;GAKG;AACH,qBACa,mBAAmB;IAIlB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAH1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;gBAEX,aAAa,EAAE,aAAa;IAEzD;;OAEG;IACG,iCAAiC,CACrC,KAAK,EAAE,MAAM,EACb,mBAAmB,EAAE,sBAAsB,EAC3C,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,qBAAqB,CAAC;YA0EnB,eAAe;YA4Df,kBAAkB;YAmDlB,qBAAqB;YAiCrB,oBAAoB;YA2BpB,sBAAsB;IA4BpC,OAAO,CAAC,cAAc;IAetB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAKvC,OAAO,CAAC,UAAU;CAMnB;AAuBD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

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

@@ -0,0 +1,269 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ShopifyAdminService = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const config_service_1 = require("../../config/config.service");
+const logger_1 = require("../../common/logger");
+/**
+ * Shopify Admin API Service
+ *
+ * Handles Shopify Admin API operations for discount code management.
+ * Uses REST Admin API for price rules and discount codes.
+ */
+let ShopifyAdminService = class ShopifyAdminService {
+    configService;
+    API_VERSION = '2024-01';
+    COUPON_PREFIX = 'CAP_';
+    constructor(configService) {
+        this.configService = configService;
+    }
+    /**
+     * Create a Shopify discount code from a validated Capillary coupon.
+     */
+    async createDiscountFromCapillaryCoupon(brand, capillaryValidation, shopifyCustomerId) {
+        const config = this.getAdminConfig(brand);
+        const originalCode = capillaryValidation.couponCode.startsWith(this.COUPON_PREFIX)
+            ? capillaryValidation.couponCode
+            : this.COUPON_PREFIX + capillaryValidation.couponCode;
+        const shopifyCode = `${originalCode}_${shopifyCustomerId}`;
+        const existing = await this.getDiscountCodeByCode(brand, shopifyCode);
+        if (existing) {
+            logger_1.logger.info('Shopify discount code already exists', { brand, shopifyCode });
+            return {
+                success: true,
+                discountCode: shopifyCode,
+                priceRuleId: existing.priceRuleId,
+                discountCodeId: existing.discountCodeId,
+                alreadyExists: true,
+            };
+        }
+        const isValidShopifyGid = shopifyCustomerId.startsWith('gid://shopify/Customer/');
+        const priceRuleConfig = {
+            title: shopifyCode,
+            valueType: capillaryValidation.discountType === 'PERC' ? 'percentage' : 'fixed_amount',
+            value: capillaryValidation.discountType === 'PERC'
+                ? -capillaryValidation.discountValue
+                : -capillaryValidation.discountValue,
+            usageLimit: 1,
+            startsAt: new Date().toISOString(),
+            endsAt: capillaryValidation.validTill,
+            allocationMethod: 'across',
+            targetType: 'line_item',
+            targetSelection: 'all',
+            customerSelection: isValidShopifyGid ? 'prerequisite' : 'all',
+            ...(isValidShopifyGid && { prerequisiteCustomerIds: [shopifyCustomerId] }),
+        };
+        const priceRule = await this.createPriceRule(brand, priceRuleConfig);
+        if (!priceRule.success) {
+            return {
+                success: false,
+                discountCode: shopifyCode,
+                error: priceRule.error,
+            };
+        }
+        const discountCode = await this.createDiscountCode(brand, priceRule.priceRuleId, shopifyCode);
+        if (!discountCode.success) {
+            return {
+                success: false,
+                discountCode: shopifyCode,
+                priceRuleId: priceRule.priceRuleId,
+                error: discountCode.error,
+            };
+        }
+        logger_1.logger.info('Shopify discount code created', {
+            brand,
+            shopifyCode,
+            priceRuleId: priceRule.priceRuleId,
+            discountCodeId: discountCode.discountCodeId,
+        });
+        return {
+            success: true,
+            discountCode: shopifyCode,
+            priceRuleId: priceRule.priceRuleId,
+            discountCodeId: discountCode.discountCodeId,
+        };
+    }
+    async createPriceRule(brand, params) {
+        const config = this.getAdminConfig(brand);
+        const url = `${config.baseUrl}/price_rules.json`;
+        const body = {
+            price_rule: {
+                title: params.title,
+                target_type: params.targetType,
+                target_selection: params.targetSelection,
+                allocation_method: params.allocationMethod,
+                value_type: params.valueType,
+                value: params.value.toString(),
+                customer_selection: params.customerSelection,
+                prerequisite_customer_ids: params.prerequisiteCustomerIds,
+                usage_limit: params.usageLimit,
+                starts_at: params.startsAt,
+                ends_at: params.endsAt,
+            },
+        };
+        try {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: this.getHeaders(config),
+                body: JSON.stringify(body),
+            });
+            if (!response.ok) {
+                const errorData = (await response.json());
+                const errorMsg = errorData.errors
+                    ? JSON.stringify(errorData.errors)
+                    : `HTTP ${response.status}`;
+                if (response.status === 422 && errorMsg.includes('title')) {
+                    logger_1.logger.warn('Price rule naming collision, looking up existing', { brand, title: params.title });
+                    const existing = await this.findPriceRuleByTitle(brand, params.title);
+                    if (existing) {
+                        return { success: true, priceRuleId: existing };
+                    }
+                }
+                logger_1.logger.error('Failed to create Shopify price rule', { brand, error: errorMsg });
+                return { success: false, error: errorMsg };
+            }
+            const data = (await response.json());
+            return {
+                success: true,
+                priceRuleId: data.price_rule.id.toString(),
+            };
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : 'Unknown error';
+            logger_1.logger.error('Shopify price rule creation failed', { brand, error: errorMsg });
+            return { success: false, error: errorMsg };
+        }
+    }
+    async createDiscountCode(brand, priceRuleId, code) {
+        const config = this.getAdminConfig(brand);
+        const url = `${config.baseUrl}/price_rules/${priceRuleId}/discount_codes.json`;
+        const body = {
+            discount_code: {
+                code,
+            },
+        };
+        try {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: this.getHeaders(config),
+                body: JSON.stringify(body),
+            });
+            if (!response.ok) {
+                const errorData = (await response.json());
+                const errorMsg = errorData.errors
+                    ? JSON.stringify(errorData.errors)
+                    : `HTTP ${response.status}`;
+                if (response.status === 422 && errorMsg.includes('code')) {
+                    logger_1.logger.warn('Discount code already exists', { brand, code, priceRuleId });
+                    const existing = await this.findDiscountCodeByCode(brand, priceRuleId, code);
+                    if (existing) {
+                        return { success: true, discountCodeId: existing };
+                    }
+                }
+                logger_1.logger.error('Failed to create Shopify discount code', { brand, error: errorMsg });
+                return { success: false, error: errorMsg };
+            }
+            const data = (await response.json());
+            return {
+                success: true,
+                discountCodeId: data.discount_code.id.toString(),
+            };
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : 'Unknown error';
+            logger_1.logger.error('Shopify discount code creation failed', { brand, error: errorMsg });
+            return { success: false, error: errorMsg };
+        }
+    }
+    async getDiscountCodeByCode(brand, code) {
+        const config = this.getAdminConfig(brand);
+        const url = `${config.baseUrl}/discount_codes/lookup.json?code=${encodeURIComponent(code)}`;
+        try {
+            const response = await fetch(url, {
+                method: 'GET',
+                headers: this.getHeaders(config),
+            });
+            if (!response.ok) {
+                return null;
+            }
+            const data = (await response.json());
+            if (data.discount_code) {
+                return {
+                    priceRuleId: data.discount_code.price_rule_id.toString(),
+                    discountCodeId: data.discount_code.id.toString(),
+                };
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+    async findPriceRuleByTitle(brand, title) {
+        const config = this.getAdminConfig(brand);
+        const url = `${config.baseUrl}/price_rules.json?limit=250`;
+        try {
+            const response = await fetch(url, {
+                method: 'GET',
+                headers: this.getHeaders(config),
+            });
+            if (!response.ok) {
+                return null;
+            }
+            const data = (await response.json());
+            const rule = data.price_rules?.find((r) => r.title === title);
+            return rule ? rule.id.toString() : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    async findDiscountCodeByCode(brand, priceRuleId, code) {
+        const config = this.getAdminConfig(brand);
+        const url = `${config.baseUrl}/price_rules/${priceRuleId}/discount_codes.json`;
+        try {
+            const response = await fetch(url, {
+                method: 'GET',
+                headers: this.getHeaders(config),
+            });
+            if (!response.ok) {
+                return null;
+            }
+            const data = (await response.json());
+            const dc = data.discount_codes?.find((d) => d.code === code);
+            return dc ? dc.id.toString() : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    getAdminConfig(brand) {
+        const brandConfig = this.configService.getBrand(brand);
+        const adminConfig = brandConfig?.integrations?.commerceAdmin;
+        if (!adminConfig) {
+            throw new Error(`Shopify Admin API not configured for brand: ${brand}`);
+        }
+        return {
+            baseUrl: `${adminConfig.baseUrl}`,
+            apiKey: adminConfig.apiKey,
+            webhookSecret: adminConfig.options?.webhookSecret,
+        };
+    }
+    getWebhookSecret(brand) {
+        const config = this.getAdminConfig(brand);
+        return config.webhookSecret;
+    }
+    getHeaders(config) {
+        return {
+            'Content-Type': 'application/json',
+            'X-Shopify-Access-Token': config.apiKey,
+        };
+    }
+};
+exports.ShopifyAdminService = ShopifyAdminService;
+exports.ShopifyAdminService = ShopifyAdminService = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__metadata("design:paramtypes", [config_service_1.ConfigService])
+], ShopifyAdminService);
+//# sourceMappingURL=shopify-admin.service.js.map