@pvh-afl/core 1.1.1 → 1.1.3

package/dist/integrations/loyalty/capillary-coupon.service.js

@@ -14,6 +14,7 @@ const capillary_types_1 = require("./capillary.types");
 let CapillaryCouponService = class CapillaryCouponService {
     authService;
     API_TIMEOUT = 5000;
+    COUPON_PAGE_SIZE = 100;
     constructor(authService) {
         this.authService = authService;
     }
@@ -21,58 +22,166 @@ let CapillaryCouponService = class CapillaryCouponService {
         const config = this.authService.getCapillaryConfig(brand);
         const token = await this.authService.getValidAccessToken(brand);
         const url = new URL(`${config.baseUrl}/v1.1/coupon/isredeemable`);
-        url.searchParams.set('mobile', mobile);
-        url.searchParams.set('code', couponCode);
-        url.searchParams.set('details', 'extended');
-        logger_1.logger.info('Validating Capillary coupon', { brand, couponCode, mobile: mobile.slice(-4) });
+        url.searchParams.set("mobile", mobile);
+        url.searchParams.set("code", couponCode);
+        url.searchParams.set("details", "extended");
+        logger_1.logger.info("Validating Capillary coupon", {
+            brand,
+            couponCode,
+            mobile: mobile.slice(-4),
+        });
         try {
             const response = await this.fetchWithTimeout(url.toString(), {
-                method: 'GET',
+                method: "GET",
                 headers: this.getHeaders(token, config),
             });
             if (!response.ok) {
                 const errorText = await response.text();
-                logger_1.logger.error('Capillary IsRedeemable API error', { brand, status: response.status, error: errorText });
+                logger_1.logger.error("Capillary IsRedeemable API error", {
+                    brand,
+                    status: response.status,
+                    error: errorText,
+                });
                 return {
                     valid: false,
                     couponCode,
-                    errorCode: 'API_ERROR',
+                    errorCode: "API_ERROR",
                     errorMessage: `Capillary API error: ${response.status}`,
                 };
             }
             const data = (await response.json());
-            return this.parseValidationResponse(data, couponCode, config.returnPolicyDays);
+            const result = this.parseValidationResponse(data, couponCode);
+            // Fetch coupon details to get valid_from
+            const couponDetails = await this.getCouponDetails(brand, couponCode);
+            // If error 709 (coupon not yet active), provide helpful message with valid_from
+            if (result.errorCode === "709" && couponDetails?.validFrom) {
+                const validFromDate = new Date(couponDetails.validFrom);
+                const formattedDate = validFromDate.toLocaleDateString("en-IN", {
+                    year: "numeric",
+                    month: "long",
+                    day: "numeric",
+                });
+                logger_1.logger.info("Coupon not yet active", {
+                    brand,
+                    couponCode,
+                    validFrom: couponDetails.validFrom,
+                });
+                return {
+                    ...result,
+                    validFrom: couponDetails.validFrom,
+                    errorCode: capillary_types_1.COUPON_NOT_YET_ACTIVE_ERROR.errorCode,
+                    errorMessage: capillary_types_1.COUPON_NOT_YET_ACTIVE_ERROR.errorMessage(formattedDate),
+                };
+            }
+            // If valid, check if coupon is not yet active based on valid_from
+            if (result.valid && couponDetails?.validFrom) {
+                const validFromDate = new Date(couponDetails.validFrom);
+                const now = new Date();
+                if (now < validFromDate) {
+                    const formattedDate = validFromDate.toLocaleDateString("en-IN", {
+                        year: "numeric",
+                        month: "long",
+                        day: "numeric",
+                    });
+                    logger_1.logger.info("Coupon valid_from is in future", {
+                        brand,
+                        couponCode,
+                        validFrom: couponDetails.validFrom,
+                        now: now.toISOString(),
+                    });
+                    return {
+                        valid: false,
+                        couponCode,
+                        validFrom: couponDetails.validFrom,
+                        errorCode: capillary_types_1.COUPON_NOT_YET_ACTIVE_ERROR.errorCode,
+                        errorMessage: capillary_types_1.COUPON_NOT_YET_ACTIVE_ERROR.errorMessage(formattedDate),
+                    };
+                }
+            }
+            // Include validFrom in successful response
+            return {
+                ...result,
+                validFrom: couponDetails?.validFrom,
+            };
         }
         catch (error) {
-            logger_1.logger.error('Capillary coupon validation failed', {
+            logger_1.logger.error("Capillary coupon validation failed", {
                 brand,
                 couponCode,
-                error: error instanceof Error ? error.message : 'Unknown',
+                error: error instanceof Error ? error.message : "Unknown",
             });
             return {
                 valid: false,
                 couponCode,
-                errorCode: 'VALIDATION_FAILED',
-                errorMessage: error instanceof Error ? error.message : 'Coupon validation failed',
+                errorCode: "VALIDATION_FAILED",
+                errorMessage: error instanceof Error ? error.message : "Coupon validation failed",
+            };
+        }
+    }
+    /**
+     * Get coupon details from Capillary /v1.1/coupon/get API.
+     * This is used to fetch the valid_from date which is not available in isredeemable API.
+     */
+    async getCouponDetails(brand, couponCode) {
+        const config = this.authService.getCapillaryConfig(brand);
+        const token = await this.authService.getValidAccessToken(brand);
+        const url = new URL(`${config.baseUrl}/v1.1/coupon/get`);
+        url.searchParams.set("code", couponCode);
+        logger_1.logger.info("Fetching Capillary coupon details", { brand, couponCode });
+        try {
+            const response = await this.fetchWithTimeout(url.toString(), {
+                method: "GET",
+                headers: this.getHeaders(token, config),
+            });
+            if (!response.ok) {
+                logger_1.logger.warn("Failed to fetch coupon details", {
+                    brand,
+                    couponCode,
+                    status: response.status,
+                });
+                return null;
+            }
+            const data = (await response.json());
+            const coupon = data.response?.coupons?.coupon?.[0];
+            if (!coupon) {
+                logger_1.logger.warn("No coupon found in response", { brand, couponCode });
+                return null;
+            }
+            return {
+                validFrom: coupon.valid_from,
+                validTill: coupon.valid_till,
+                issuedOn: coupon.issued_on,
+                seriesId: coupon.series_id,
+                value: coupon.value,
             };
         }
+        catch (error) {
+            logger_1.logger.error("Error fetching coupon details", {
+                brand,
+                couponCode,
+                error: error instanceof Error ? error.message : "Unknown",
+            });
+            return null;
+        }
     }
     async createTransaction(brand, request) {
         const config = this.authService.getCapillaryConfig(brand);
         const token = await this.authService.getValidAccessToken(brand);
         const url = new URL(`${config.baseUrl}/v2/transactions`);
-        url.searchParams.set('source', 'INSTORE');
-        url.searchParams.set('identifierName', 'mobile');
-        url.searchParams.set('identifierValue', request.mobile);
+        url.searchParams.set("source", "INSTORE");
+        url.searchParams.set("identifierName", "mobile");
+        url.searchParams.set("identifierValue", request.mobile);
         const body = {
             billAmount: request.billAmount,
             billNumber: request.billNumber,
             billingDate: request.billingDate,
-            type: request.type ?? 'REGULAR',
+            type: request.type ?? "REGULAR",
             ...(request.returnType && { returnType: request.returnType }),
             ...(request.redemptionIds?.length && {
                 redemptions: {
-                    couponRedemptions: request.redemptionIds.map((id) => ({ redemptionId: id })),
+                    couponRedemptions: request.redemptionIds.map((id) => ({
+                        redemptionId: id,
+                    })),
                 },
             }),
             lineItemsV2: request.lineItems.map((item) => ({
@@ -81,24 +190,28 @@ let CapillaryCouponService = class CapillaryCouponService {
                 rate: item.rate,
                 amount: item.amount,
                 description: item.description,
-                type: item.type ?? 'REGULAR',
+                type: item.type ?? "REGULAR",
             })),
             paymentModes: request.paymentModes,
         };
-        logger_1.logger.info('Creating Capillary transaction', {
+        logger_1.logger.info("Creating Capillary transaction", {
             brand,
             billNumber: request.billNumber,
-            type: request.type ?? 'REGULAR',
+            type: request.type ?? "REGULAR",
         });
         try {
             const response = await this.fetchWithTimeout(url.toString(), {
-                method: 'POST',
+                method: "POST",
                 headers: this.getHeaders(token, config),
                 body: JSON.stringify(body),
             });
             if (!response.ok) {
                 const errorText = await response.text();
-                logger_1.logger.error('Capillary Transaction API error', { brand, status: response.status, error: errorText });
+                logger_1.logger.error("Capillary Transaction API error", {
+                    brand,
+                    status: response.status,
+                    error: errorText,
+                });
                 return {
                     transactionId: 0,
                     billNumber: request.billNumber,
@@ -113,10 +226,10 @@ let CapillaryCouponService = class CapillaryCouponService {
                     transactionId: 0,
                     billNumber: request.billNumber,
                     errorCode: 500,
-                    errorMessage: 'No transaction in response',
+                    errorMessage: "No transaction in response",
                 };
             }
-            logger_1.logger.info('Capillary transaction created', {
+            logger_1.logger.info("Capillary transaction created", {
                 brand,
                 billNumber: request.billNumber,
                 transactionId: txn.id,
@@ -128,16 +241,18 @@ let CapillaryCouponService = class CapillaryCouponService {
             };
         }
         catch (error) {
-            logger_1.logger.error('Capillary transaction creation failed', {
+            logger_1.logger.error("Capillary transaction creation failed", {
                 brand,
                 billNumber: request.billNumber,
-                error: error instanceof Error ? error.message : 'Unknown',
+                error: error instanceof Error ? error.message : "Unknown",
             });
             return {
                 transactionId: 0,
                 billNumber: request.billNumber,
                 errorCode: 500,
-                errorMessage: error instanceof Error ? error.message : 'Transaction creation failed',
+                errorMessage: error instanceof Error
+                    ? error.message
+                    : "Transaction creation failed",
             };
         }
     }
@@ -150,21 +265,27 @@ let CapillaryCouponService = class CapillaryCouponService {
         const token = await this.authService.getValidAccessToken(brand);
         // Use mobile param directly - identifierName/identifierValue returns 400 error
         const url = new URL(`${config.baseUrl}/v2/customers/coupons`);
-        url.searchParams.set('mobile', mobile);
-        logger_1.logger.info('Getting coupons by transaction', { brand, transactionNumber });
+        url.searchParams.set("mobile", mobile);
+        logger_1.logger.info("Getting coupons by transaction", { brand, transactionNumber });
         try {
             const response = await this.fetchWithTimeout(url.toString(), {
-                method: 'GET',
+                method: "GET",
                 headers: this.getHeaders(token, config),
             });
             if (!response.ok) {
-                logger_1.logger.error('Capillary Get Coupons API error', { brand, status: response.status });
+                logger_1.logger.error("Capillary Get Coupons API error", {
+                    brand,
+                    status: response.status,
+                });
                 return [];
             }
             const data = (await response.json());
             // Check for API-level errors
             if (data.errors && data.errors.length > 0) {
-                logger_1.logger.error('Capillary API returned errors', { brand, errors: data.errors });
+                logger_1.logger.error("Capillary API returned errors", {
+                    brand,
+                    errors: data.errors,
+                });
                 return [];
             }
             // v2 response format: entity.customers[0].coupons[]
@@ -173,8 +294,10 @@ let CapillaryCouponService = class CapillaryCouponService {
                 couponCode: c.code,
                 seriesId: c.seriesId,
                 redemptionId: c.redemptions?.[0]?.id,
-                status: (c.redemptionCount > 0 ? 'REDEEMED' : 'ACTIVE'),
-                issuedAt: c.createdDate ?? '',
+                status: (c.redemptionCount > 0
+                    ? "REDEEMED"
+                    : "ACTIVE"),
+                issuedAt: c.createdDate ?? "",
                 validTill: c.validTill,
                 discountType: c.discountType,
                 discountValue: c.discountValue,
@@ -182,10 +305,10 @@ let CapillaryCouponService = class CapillaryCouponService {
             }));
         }
         catch (error) {
-            logger_1.logger.error('Failed to get coupons by transaction', {
+            logger_1.logger.error("Failed to get coupons by transaction", {
                 brand,
                 transactionNumber,
-                error: error instanceof Error ? error.message : 'Unknown',
+                error: error instanceof Error ? error.message : "Unknown",
             });
             return [];
         }
@@ -198,16 +321,20 @@ let CapillaryCouponService = class CapillaryCouponService {
         const token = await this.authService.getValidAccessToken(brand);
         const url = `${config.baseUrl}/v2/coupon/reactivate`;
         const body = { redemptionIds };
-        logger_1.logger.info('Reactivating coupons', { brand, redemptionIds });
+        logger_1.logger.info("Reactivating coupons", { brand, redemptionIds });
         try {
             const response = await this.fetchWithTimeout(url, {
-                method: 'POST',
+                method: "POST",
                 headers: this.getHeaders(token, config),
                 body: JSON.stringify(body),
             });
             if (!response.ok) {
                 const errorText = await response.text();
-                logger_1.logger.error('Capillary Reactivate API error', { brand, status: response.status, error: errorText });
+                logger_1.logger.error("Capillary Reactivate API error", {
+                    brand,
+                    status: response.status,
+                    error: errorText,
+                });
                 return {
                     success: false,
                     reactivatedCount: 0,
@@ -217,23 +344,23 @@ let CapillaryCouponService = class CapillaryCouponService {
             }
             const data = (await response.json());
             const success = data.response?.status?.success ?? false;
-            logger_1.logger.info('Coupons reactivated', { brand, redemptionIds, success });
+            logger_1.logger.info("Coupons reactivated", { brand, redemptionIds, success });
             return {
                 success,
                 reactivatedCount: success ? redemptionIds.length : 0,
             };
         }
         catch (error) {
-            logger_1.logger.error('Coupon reactivation failed', {
+            logger_1.logger.error("Coupon reactivation failed", {
                 brand,
                 redemptionIds,
-                error: error instanceof Error ? error.message : 'Unknown',
+                error: error instanceof Error ? error.message : "Unknown",
             });
             return {
                 success: false,
                 reactivatedCount: 0,
                 errorCode: 500,
-                errorMessage: error instanceof Error ? error.message : 'Reactivation failed',
+                errorMessage: error instanceof Error ? error.message : "Reactivation failed",
             };
         }
     }
@@ -245,16 +372,20 @@ let CapillaryCouponService = class CapillaryCouponService {
         const token = await this.authService.getValidAccessToken(brand);
         const url = `${config.baseUrl}/v2/coupon/revoke`;
         const body = { couponCodes };
-        logger_1.logger.info('Revoking coupons', { brand, couponCodes });
+        logger_1.logger.info("Revoking coupons", { brand, couponCodes });
         try {
             const response = await this.fetchWithTimeout(url, {
-                method: 'POST',
+                method: "POST",
                 headers: this.getHeaders(token, config),
                 body: JSON.stringify(body),
             });
             if (!response.ok) {
                 const errorText = await response.text();
-                logger_1.logger.error('Capillary Revoke API error', { brand, status: response.status, error: errorText });
+                logger_1.logger.error("Capillary Revoke API error", {
+                    brand,
+                    status: response.status,
+                    error: errorText,
+                });
                 return {
                     success: false,
                     revokedCount: 0,
@@ -264,23 +395,23 @@ let CapillaryCouponService = class CapillaryCouponService {
             }
             const data = (await response.json());
             const success = data.response?.status?.success ?? false;
-            logger_1.logger.info('Coupons revoked', { brand, couponCodes, success });
+            logger_1.logger.info("Coupons revoked", { brand, couponCodes, success });
             return {
                 success,
                 revokedCount: success ? couponCodes.length : 0,
             };
         }
         catch (error) {
-            logger_1.logger.error('Coupon revocation failed', {
+            logger_1.logger.error("Coupon revocation failed", {
                 brand,
                 couponCodes,
-                error: error instanceof Error ? error.message : 'Unknown',
+                error: error instanceof Error ? error.message : "Unknown",
             });
             return {
                 success: false,
                 revokedCount: 0,
                 errorCode: 500,
-                errorMessage: error instanceof Error ? error.message : 'Revocation failed',
+                errorMessage: error instanceof Error ? error.message : "Revocation failed",
             };
         }
     }
@@ -292,26 +423,34 @@ let CapillaryCouponService = class CapillaryCouponService {
         const config = this.authService.getCapillaryConfig(brand);
         const token = await this.authService.getValidAccessToken(brand);
         const url = `${config.baseUrl}/v2/transactions/getByBillNumber/${encodeURIComponent(billNumber)}`;
-        logger_1.logger.info('Getting transaction ID by bill number', { brand, billNumber });
+        logger_1.logger.info("Getting transaction ID by bill number", { brand, billNumber });
         try {
             const response = await this.fetchWithTimeout(url, {
-                method: 'GET',
+                method: "GET",
                 headers: this.getHeaders(token, config),
             });
             if (!response.ok) {
-                logger_1.logger.error('Capillary GetByBillNumber API error', { brand, billNumber, status: response.status });
+                logger_1.logger.error("Capillary GetByBillNumber API error", {
+                    brand,
+                    billNumber,
+                    status: response.status,
+                });
                 return null;
             }
             const data = (await response.json());
             const transactionId = data.response?.transactions?.transaction?.[0]?.id ?? null;
-            logger_1.logger.info('Transaction ID retrieved', { brand, billNumber, transactionId });
+            logger_1.logger.info("Transaction ID retrieved", {
+                brand,
+                billNumber,
+                transactionId,
+            });
             return transactionId;
         }
         catch (error) {
-            logger_1.logger.error('Failed to get transaction ID by bill number', {
+            logger_1.logger.error("Failed to get transaction ID by bill number", {
                 brand,
                 billNumber,
-                error: error instanceof Error ? error.message : 'Unknown',
+                error: error instanceof Error ? error.message : "Unknown",
             });
             return null;
         }
@@ -327,21 +466,31 @@ let CapillaryCouponService = class CapillaryCouponService {
         const token = await this.authService.getValidAccessToken(brand);
         // Use mobile param directly - identifierName/identifierValue returns 400 error
         const url = new URL(`${config.baseUrl}/v2/customers/coupons`);
-        url.searchParams.set('mobile', mobile);
-        logger_1.logger.info('Getting coupons earned on transaction', { brand, mobile: mobile.slice(-4), transactionId });
+        url.searchParams.set("mobile", mobile);
+        logger_1.logger.info("Getting coupons earned on transaction", {
+            brand,
+            mobile: mobile.slice(-4),
+            transactionId,
+        });
         try {
             const response = await this.fetchWithTimeout(url.toString(), {
-                method: 'GET',
+                method: "GET",
                 headers: this.getHeaders(token, config),
             });
             if (!response.ok) {
-                logger_1.logger.error('Capillary Get Coupons API error', { brand, status: response.status });
+                logger_1.logger.error("Capillary Get Coupons API error", {
+                    brand,
+                    status: response.status,
+                });
                 return [];
             }
             const data = (await response.json());
             // Check for API-level errors
             if (data.errors && data.errors.length > 0) {
-                logger_1.logger.error('Capillary API returned errors', { brand, errors: data.errors });
+                logger_1.logger.error("Capillary API returned errors", {
+                    brand,
+                    errors: data.errors,
+                });
                 return [];
             }
             // v2 response format: entity.customers[0].coupons[]
@@ -354,7 +503,7 @@ let CapillaryCouponService = class CapillaryCouponService {
                 couponCode: c.code,
                 seriesId: c.seriesId,
             }));
-            logger_1.logger.info('Coupons earned on transaction retrieved', {
+            logger_1.logger.info("Coupons earned on transaction retrieved", {
                 brand,
                 transactionId,
                 couponCount: earnedCoupons.length,
@@ -362,10 +511,10 @@ let CapillaryCouponService = class CapillaryCouponService {
             return earnedCoupons;
         }
         catch (error) {
-            logger_1.logger.error('Failed to get coupons earned on transaction', {
+            logger_1.logger.error("Failed to get coupons earned on transaction", {
                 brand,
                 transactionId,
-                error: error instanceof Error ? error.message : 'Unknown',
+                error: error instanceof Error ? error.message : "Unknown",
             });
             return [];
         }
@@ -381,21 +530,31 @@ let CapillaryCouponService = class CapillaryCouponService {
         const token = await this.authService.getValidAccessToken(brand);
         // Use mobile param directly - identifierName/identifierValue returns 400 error
         const url = new URL(`${config.baseUrl}/v2/customers/coupons`);
-        url.searchParams.set('mobile', mobile);
-        logger_1.logger.info('Getting redemption ID for transaction', { brand, mobile: mobile.slice(-4), transactionNumber });
+        url.searchParams.set("mobile", mobile);
+        logger_1.logger.info("Getting redemption ID for transaction", {
+            brand,
+            mobile: mobile.slice(-4),
+            transactionNumber,
+        });
         try {
             const response = await this.fetchWithTimeout(url.toString(), {
-                method: 'GET',
+                method: "GET",
                 headers: this.getHeaders(token, config),
             });
             if (!response.ok) {
-                logger_1.logger.error('Capillary Get Coupons API error', { brand, status: response.status });
+                logger_1.logger.error("Capillary Get Coupons API error", {
+                    brand,
+                    status: response.status,
+                });
                 return null;
             }
             const data = (await response.json());
             // Check for API-level errors
             if (data.errors && data.errors.length > 0) {
-                logger_1.logger.error('Capillary API returned errors', { brand, errors: data.errors });
+                logger_1.logger.error("Capillary API returned errors", {
+                    brand,
+                    errors: data.errors,
+                });
                 return null;
             }
             // v2 response format: entity.customers[0].coupons[]
@@ -406,7 +565,7 @@ let CapillaryCouponService = class CapillaryCouponService {
                     // Check if any redemption matches this transaction number
                     for (const redemption of coupon.redemptions) {
                         if (redemption.transactionNumber === transactionNumber) {
-                            logger_1.logger.info('Redemption ID found for transaction', {
+                            logger_1.logger.info("Redemption ID found for transaction", {
                                 brand,
                                 transactionNumber,
                                 redemptionId: redemption.id,
@@ -417,67 +576,159 @@ let CapillaryCouponService = class CapillaryCouponService {
                     }
                 }
             }
-            logger_1.logger.info('No redemption ID found for transaction', { brand, transactionNumber });
+            logger_1.logger.info("No redemption ID found for transaction", {
+                brand,
+                transactionNumber,
+            });
             return null;
         }
         catch (error) {
-            logger_1.logger.error('Failed to get redemption ID for transaction', {
+            logger_1.logger.error("Failed to get redemption ID for transaction", {
                 brand,
                 transactionNumber,
-                error: error instanceof Error ? error.message : 'Unknown',
+                error: error instanceof Error ? error.message : "Unknown",
             });
             return null;
         }
     }
-    parseValidationResponse(data, originalCode, returnPolicyDays) {
+    /**
+     * List a customer's coupons by mobile number.
+     *
+     * Only CouponState.ACTIVE is implemented. REDEEMABLE and BOTH return empty lists with a message.
+     *
+     * Uses v2/customers/coupons API with mobile param (not identifierName/identifierValue)
+     */
+    async getCustomerCoupons(brand, mobile, state) {
+        switch (state) {
+            case capillary_types_1.CouponState.ACTIVE:
+                return this.getActiveCoupons(brand, mobile);
+            case capillary_types_1.CouponState.REDEEMABLE:
+            case capillary_types_1.CouponState.BOTH:
+                logger_1.logger.info("Coupon state not implemented yet", { brand, state });
+                return {
+                    coupons: [],
+                    message: `Coupon state ${state} is not supported yet. Only ACTIVE is available.`,
+                };
+            default:
+                logger_1.logger.warn("Unknown coupon state requested", { brand, state });
+                return {
+                    coupons: [],
+                    message: `Unknown coupon state: ${state}`,
+                };
+        }
+    }
+    /**
+     * Fetch every coupon Capillary reports as ACTIVE for this mobile number.
+     *
+     * The listing endpoint is paginated. `pagination.total` reflects the page
+     * rather than the full result set, so it cannot be used to know when to stop.
+     * Paging continues until a page comes back shorter than the requested limit.
+     */
+    async getActiveCoupons(brand, mobile) {
+        const config = this.authService.getCapillaryConfig(brand);
+        const token = await this.authService.getValidAccessToken(brand);
+        logger_1.logger.info("Getting active coupons for customer", { brand, mobile });
+        const coupons = [];
+        let offset = 0;
+        while (true) {
+            // Use mobile param directly - identifierName/identifierValue returns 400 error
+            const url = new URL(`${config.baseUrl}/v2/customers/coupons`);
+            url.searchParams.set("mobile", mobile);
+            url.searchParams.set("status", capillary_types_1.CAPILLARY_STATUS_ACTIVE);
+            url.searchParams.set("limit", this.COUPON_PAGE_SIZE.toString());
+            url.searchParams.set("offset", offset.toString());
+            const response = await this.fetchWithTimeout(url.toString(), {
+                method: "GET",
+                headers: this.getHeaders(token, config),
+            });
+            if (!response.ok) {
+                logger_1.logger.error("Capillary Get Coupons API error", {
+                    brand,
+                    status: response.status,
+                    offset,
+                });
+                throw new Error(`Capillary coupon listing failed with status ${response.status}`);
+            }
+            const data = (await response.json());
+            // Capillary answers 200 even when the lookup failed, so the body decides.
+            if (data.errors && data.errors.length > 0) {
+                // An unregistered mobile is not a failure, it is an empty result. It
+                // only ever comes back on the first page, because the customer either
+                // exists or does not.
+                const notFound = data.errors.some((e) => e.code === capillary_types_1.CAPILLARY_ERROR_CODES.CUSTOMER_NOT_FOUND);
+                if (notFound) {
+                    logger_1.logger.info("No Capillary customer for mobile", { brand, mobile });
+                    return { coupons: [], message: capillary_types_1.CUSTOMER_NOT_FOUND_MESSAGE };
+                }
+                // Anything else is a real failure and must surface, so an outage is
+                // never flattened into an empty coupon list.
+                logger_1.logger.error("Capillary API returned errors", {
+                    brand,
+                    errors: data.errors,
+                });
+                throw new Error(data.errors[0]?.message ?? "Capillary coupon listing failed");
+            }
+            // The v2 listing nests coupons under the matched customer. We look up by a
+            // single mobile number, so Capillary returns at most one customer, and the
+            // coupons live at entity.customers[0].coupons.
+            const customer = data.entity?.customers?.[0];
+            const pageCoupons = customer?.coupons ?? [];
+            coupons.push(...pageCoupons.map((c) => ({
+                code: c.code,
+                seriesId: c.seriesId,
+                description: c.description,
+                validTill: c.validTill,
+                validTillDateTime: c.validTillDateTime,
+                discountType: c.discountType,
+                discountValue: c.discountValue,
+                discountUpto: c.discountUpto,
+                redemptionsLeft: c.redemptionsLeft,
+                issuedOn: c.createdDate,
+            })));
+            // A short page means there is nothing left to fetch
+            if (pageCoupons.length < this.COUPON_PAGE_SIZE) {
+                break;
+            }
+            offset += this.COUPON_PAGE_SIZE;
+        }
+        logger_1.logger.info("Active coupons retrieved", {
+            brand,
+            mobile,
+            couponCount: coupons.length,
+        });
+        return {
+            coupons,
+            message: coupons.length > 0
+                ? `${coupons.length} active coupon(s) found`
+                : "No active coupons found for this customer",
+        };
+    }
+    parseValidationResponse(data, originalCode) {
         const coupon = data.response?.coupons?.redeemable;
         if (!coupon) {
             return {
                 valid: false,
                 couponCode: originalCode,
-                errorCode: 'NOT_FOUND',
-                errorMessage: 'Coupon not found',
+                errorCode: "NOT_FOUND",
+                errorMessage: "Coupon not found",
             };
         }
-        const isRedeemable = coupon.is_redeemable === 'true';
+        const isRedeemable = coupon.is_redeemable === "true";
         if (!isRedeemable) {
             const itemStatus = coupon.item_status;
             return {
                 valid: false,
                 couponCode: originalCode,
-                errorCode: itemStatus?.code?.toString() ?? 'INVALID',
-                errorMessage: itemStatus?.message ?? 'Coupon is not redeemable',
+                errorCode: itemStatus?.code?.toString() ?? "INVALID",
+                errorMessage: itemStatus?.message ?? "Coupon is not redeemable",
             };
         }
-        // Check cool-off period
-        const createdDate = coupon.series_info?.created;
-        if (createdDate) {
-            const issuedAt = new Date(createdDate);
-            const usableFromDate = new Date(issuedAt);
-            usableFromDate.setDate(usableFromDate.getDate() + returnPolicyDays);
-            const now = new Date();
-            if (now < usableFromDate) {
-                const formattedDate = usableFromDate.toLocaleDateString('en-IN', {
-                    year: 'numeric',
-                    month: 'long',
-                    day: 'numeric',
-                });
-                return {
-                    valid: false,
-                    couponCode: originalCode,
-                    issuedAt: createdDate,
-                    usableFromDate: usableFromDate.toISOString(),
-                    errorCode: capillary_types_1.COUPON_COOLOFF_ERROR.errorCode,
-                    errorMessage: capillary_types_1.COUPON_COOLOFF_ERROR.errorMessage(formattedDate),
-                };
-            }
-        }
         const seriesInfo = coupon.series_info;
         return {
             valid: true,
             couponCode: originalCode,
-            discountType: (seriesInfo?.discount_type ?? 'ABS'),
-            discountValue: seriesInfo?.discount_value ?? parseFloat(coupon.coupon_value ?? '0'),
+            discountType: (seriesInfo?.discount_type ?? "ABS"),
+            discountValue: seriesInfo?.discount_value ?? parseFloat(coupon.coupon_value ?? "0"),
             discountUpto: seriesInfo?.discount_upto,
             minBillAmount: seriesInfo?.min_bill_amount,
             validTill: seriesInfo?.valid_till_date,
@@ -488,10 +739,10 @@ let CapillaryCouponService = class CapillaryCouponService {
     }
     getHeaders(token, config) {
         return {
-            'Content-Type': 'application/json',
-            'X-CAP-API-OAUTH-TOKEN': token,
-            'X-CAP-API-ATTRIBUTION-ENTITY-TYPE': 'TILL',
-            'X-CAP-API-ATTRIBUTION-ENTITY-CODE': config.tillId,
+            "Content-Type": "application/json",
+            "X-CAP-API-OAUTH-TOKEN": token,
+            "X-CAP-API-ATTRIBUTION-ENTITY-TYPE": "TILL",
+            "X-CAP-API-ATTRIBUTION-ENTITY-CODE": config.tillId,
         };
     }
     async fetchWithTimeout(url, options) {