@pvh-afl/core 1.1.6 → 1.1.8

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

@@ -4,54 +4,99 @@ 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.
+ * Uses GraphQL Admin API for discount operations with tags support.
+ *
+ * Migration from REST to GraphQL (2024):
+ * - REST: price_rules + discount_codes endpoints
+ * - GraphQL: discountCodeBasic mutations with tags support
+ *
+ * All Capillary-synced discounts are tagged with "CAPILLARY" for easy identification.
  */
 export declare class ShopifyAdminService {
     private readonly configService;
-    private readonly API_VERSION;
+    private readonly GRAPHQL_API_VERSION;
+    private readonly CAPILLARY_TAG;
     constructor(configService: ConfigService);
     /**
      * Create a Shopify discount code from a validated Capillary coupon.
      *
-     * New behavior (no CAP_ prefix):
+     * Behavior:
      * - Uses original Capillary code directly (e.g., "SUMMER20")
-     * - If code exists: adds customer to prerequisite_customer_ids array
-     * - If code doesn't exist: creates with customer in prerequisite_customer_ids
-     * - Uses once_per_customer: true for per-customer usage limit
+     * - If code exists: updates properties from Capillary and adds customer to eligibility
+     * - If code doesn't exist: creates with customer-specific eligibility
+     * - Tags discount with "CAPILLARY" for identification
+     * - Uses appliesOncePerCustomer: true for per-customer usage limit
      */
     createDiscountFromCapillaryCoupon(brand: string, capillaryValidation: CouponValidationResult, shopifyCustomerId: string): Promise<ShopifyDiscountResult>;
     /**
-     * Add a customer to an existing price rule's prerequisite_customer_ids.
+     * Create a new discount via GraphQL Admin API.
+     */
+    private createDiscountViaGraphQL;
+    /**
+     * Update an existing discount with fresh Capillary data and add customer.
+     * This resolves the stale data issue by always syncing latest properties.
+     */
+    private updateDiscountWithCapillaryData;
+    /**
+     * Build discount value object based on Capillary discount type.
+     */
+    private buildDiscountValue;
+    /**
+     * Add a customer to an existing discount's eligibility.
      * Used when multiple customers share the same Capillary coupon code.
+     *
+     * @deprecated Use updateDiscountWithCapillaryData instead which also updates properties
      */
     addCustomerToPriceRule(brand: string, priceRuleId: string, shopifyCustomerId: string): Promise<{
         success: boolean;
         error?: string;
     }>;
     /**
-     * Extract numeric customer ID from Shopify GID or return as-is if already numeric.
+     * Add a customer to an existing discount's eligibility.
+     */
+    addCustomerToDiscount(brand: string, discountId: string, shopifyCustomerId: string): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * Format customer ID as Shopify GID.
+     */
+    private formatCustomerGid;
+    /**
+     * Extract numeric ID from Shopify GID or return as-is if already numeric.
+     *
+     * @deprecated Use formatCustomerGid instead for GID format
      */
     private extractNumericCustomerId;
-    private createPriceRule;
-    private createDiscountCode;
+    /**
+     * Lookup discount code by code string.
+     * Returns discount ID if found, null otherwise.
+     */
     private getDiscountCodeByCode;
-    private findPriceRuleByTitle;
-    private findDiscountCodeByCode;
     private getAdminConfig;
+    /**
+     * Execute a GraphQL query/mutation against Shopify Admin API.
+     */
+    private executeGraphQL;
     getWebhookSecret(brand: string): string;
     /**
-     * Reactivate a Shopify discount code by resetting its usage count.
+     * Reactivate a Shopify discount code by extending its end date and usage limit.
      * Used when a redeemed coupon needs to be returned to the user (refund/cancellation).
      */
     reactivateDiscountCode(brand: string, discountCode: string): Promise<DiscountCodeReactivateResult>;
     /**
-     * Disable or delete a Shopify discount code.
+     * Disable/delete a Shopify discount code.
      * Used when an earned coupon needs to be revoked (refund/cancellation).
      */
     disableDiscountCode(brand: string, discountCode: string): Promise<DiscountCodeDisableResult>;
+    /**
+     * Get active Shopify discount codes filtered by tag.
+     * Returns discounts with code, title, discount type/value, validity dates, and tags.
+     */
+    getDiscountsByTag(brand: string, tag: string, limit?: number): Promise<ShopifyDiscount[]>;
     /**
      * Sync a used Capillary coupon to Shopify for refund tracking.
-     * Creates a price rule and discount code marked as already used.
+     * Creates a discount code marked as already used (ended).
      * This is needed when GoKwik applies a coupon that doesn't exist in Shopify.
      *
      * Uses original code directly (no prefix).
@@ -62,12 +107,14 @@ export declare class ShopifyAdminService {
      * Returns a date 30 days from now if the current end date has passed.
      */
     private getExtendedEndDate;
-    private getHeaders;
 }
 export interface ShopifyDiscountResult {
     success: boolean;
     discountCode: string;
+    discountId?: string;
+    /** @deprecated Use discountId instead */
     priceRuleId?: string;
+    /** @deprecated Use discountId instead */
     discountCodeId?: string;
     alreadyExists?: boolean;
     error?: string;
@@ -83,4 +130,17 @@ export interface DiscountCodeDisableResult {
     deleted?: boolean;
     error?: string;
 }
+export interface ShopifyDiscount {
+    id: string;
+    code: string;
+    title: string;
+    discountType: 'ABS' | 'PERC';
+    discountValue: number;
+    discountUpto?: number;
+    minOrderValue?: number;
+    startsAt: string;
+    endsAt?: string;
+    usageLimit?: number;
+    tags: string[];
+}
 //# sourceMappingURL=shopify-admin.service.d.ts.map

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

@@ -1 +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;IAGlB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAF1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;gBAEZ,aAAa,EAAE,aAAa;IAEzD;;;;;;;;OAQG;IACG,iCAAiC,CACrC,KAAK,EAAE,MAAM,EACb,mBAAmB,EAAE,sBAAsB,EAC3C,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,qBAAqB,CAAC;IAkGjC;;;OAGG;IACG,sBAAsB,CAC1B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAsGhD;;OAEG;IACH,OAAO,CAAC,wBAAwB;YAQlB,eAAe;YA6Df,kBAAkB;YAmDlB,qBAAqB;YAiCrB,oBAAoB;YA2BpB,sBAAsB;IA4BpC,OAAO,CAAC,cAAc;IAetB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAKvC;;;OAGG;IACG,sBAAsB,CAC1B,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,4BAA4B,CAAC;IA4FxC;;;OAGG;IACG,mBAAmB,CACvB,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,yBAAyB,CAAC;IA2ErC;;;;;;OAMG;IACG,uBAAuB,CAC3B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,KAAK,GAAG,MAAM,EAC5B,aAAa,EAAE,MAAM,EACrB,iBAAiB,EAAE,MAAM,EACzB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,qBAAqB,CAAC;IAsEjC;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAgB1B,OAAO,CAAC,UAAU;CAMnB;AAwBD,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;AAED,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"shopify-admin.service.d.ts","sourceRoot":"","sources":["../../../src/integrations/commerce/shopify-admin.service.ts"],"names":[],"mappings":"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"}