@pvh-afl/core 1.0.0

package/dist/integrations/shopify-theme/shopify-theme.service.js

@@ -0,0 +1,155 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ShopifyThemeService = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const config_service_1 = require("../../config/config.service");
+const cache_service_1 = require("../../cache/cache.service");
+const logger_1 = require("../../common/logger");
+/**
+ * Shopify Theme Service
+ *
+ * Fetches content from Shopify theme assets (JSON files).
+ * Used for CMS-like content stored in theme files.
+ */
+let ShopifyThemeService = class ShopifyThemeService {
+    configService;
+    cacheService;
+    constructor(configService, cacheService) {
+        this.configService = configService;
+        this.cacheService = cacheService;
+    }
+    /**
+     * Fetch a JSON asset from the Shopify theme.
+     */
+    async getThemeAsset(brand, assetKey) {
+        const cacheKey = `${brand}:theme:${assetKey}`;
+        // Check cache first
+        const cached = await this.cacheService.get(cacheKey);
+        if (cached && !cached.isStale) {
+            return cached.data;
+        }
+        const adminToken = this.configService.getShopifyAdminToken(brand);
+        const themeId = this.configService.getShopifyThemeId(brand);
+        const storeDomain = this.configService.getShopifyStoreDomain(brand);
+        if (!adminToken || !themeId || !storeDomain) {
+            logger_1.logger.warn('Shopify theme config missing', { brand, assetKey });
+            return cached?.data ?? null;
+        }
+        const url = `https://${storeDomain}/admin/api/2024-01/themes/${themeId}/assets.json?asset[key]=${encodeURIComponent(assetKey)}`;
+        try {
+            const response = await fetch(url, {
+                headers: {
+                    'X-Shopify-Access-Token': adminToken,
+                    'Content-Type': 'application/json',
+                },
+            });
+            if (!response.ok) {
+                logger_1.logger.error('Failed to fetch theme asset', {
+                    brand,
+                    assetKey,
+                    status: response.status,
+                });
+                return cached?.data ?? null;
+            }
+            const data = (await response.json());
+            const assetValue = data.asset?.value;
+            if (!assetValue) {
+                logger_1.logger.warn('Theme asset empty', { brand, assetKey });
+                return cached?.data ?? null;
+            }
+            const parsed = JSON.parse(assetValue);
+            // Cache the result
+            const { defaultTTL, staleTTL } = this.configService.getCacheTTL(brand);
+            await this.cacheService.set(cacheKey, parsed, defaultTTL, staleTTL);
+            // If we had stale data, trigger background refresh
+            if (cached?.isStale) {
+                logger_1.logger.info('Theme asset refreshed', { brand, assetKey });
+            }
+            return parsed;
+        }
+        catch (error) {
+            logger_1.logger.error('Theme asset fetch error', {
+                brand,
+                assetKey,
+                error: error instanceof Error ? error.message : 'Unknown',
+            });
+            return cached?.data ?? null;
+        }
+    }
+    /**
+     * Invalidate cached theme asset.
+     */
+    async invalidateAsset(brand, assetKey) {
+        const cacheKey = `${brand}:theme:${assetKey}`;
+        await this.cacheService.delete(cacheKey);
+        logger_1.logger.info('Theme asset cache invalidated', { brand, assetKey });
+    }
+    /**
+     * Invalidate all theme assets for a brand.
+     */
+    async invalidateAllAssets(brand) {
+        const pattern = `${brand}:theme:*`;
+        const count = await this.cacheService.deletePattern(pattern);
+        logger_1.logger.info('All theme assets invalidated', { brand, count });
+        return count;
+    }
+    /**
+     * Build cache key for theme content.
+     */
+    buildCacheKey(brand, path) {
+        return `${brand}:theme:${path}`;
+    }
+    /**
+     * Fetch a theme file directly without caching.
+     * Used by services that handle their own caching logic.
+     */
+    async fetchThemeFile(brand, path) {
+        const adminToken = this.configService.getShopifyAdminToken(brand);
+        const themeId = this.configService.getShopifyThemeId(brand);
+        const storeDomain = this.configService.getShopifyStoreDomain(brand);
+        if (!adminToken || !themeId || !storeDomain) {
+            logger_1.logger.warn('Shopify theme config missing', { brand, path });
+            return null;
+        }
+        const url = `https://${storeDomain}/admin/api/2024-01/themes/${themeId}/assets.json?asset[key]=${encodeURIComponent(path)}`;
+        try {
+            const response = await fetch(url, {
+                headers: {
+                    'X-Shopify-Access-Token': adminToken,
+                    'Content-Type': 'application/json',
+                },
+            });
+            if (!response.ok) {
+                logger_1.logger.error('Failed to fetch theme file', {
+                    brand,
+                    path,
+                    status: response.status,
+                });
+                return null;
+            }
+            const data = (await response.json());
+            const assetValue = data.asset?.value;
+            if (!assetValue) {
+                logger_1.logger.warn('Theme file empty', { brand, path });
+                return null;
+            }
+            return JSON.parse(assetValue);
+        }
+        catch (error) {
+            logger_1.logger.error('Theme file fetch error', {
+                brand,
+                path,
+                error: error instanceof Error ? error.message : 'Unknown',
+            });
+            return null;
+        }
+    }
+};
+exports.ShopifyThemeService = ShopifyThemeService;
+exports.ShopifyThemeService = ShopifyThemeService = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__metadata("design:paramtypes", [config_service_1.ConfigService,
+        cache_service_1.CacheService])
+], ShopifyThemeService);
+//# sourceMappingURL=shopify-theme.service.js.map

package/dist/integrations/shopify-theme/shopify-theme.service.js.map

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

package/dist/queue/index.d.ts

@@ -0,0 +1,3 @@
+export { QueueModule } from './queue.module';
+export { QueueService, QueueItem } from './queue.service';
+//# sourceMappingURL=index.d.ts.map

package/dist/queue/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/queue/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/queue/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QueueService = exports.QueueModule = void 0;
+var queue_module_1 = require("./queue.module");
+Object.defineProperty(exports, "QueueModule", { enumerable: true, get: function () { return queue_module_1.QueueModule; } });
+var queue_service_1 = require("./queue.service");
+Object.defineProperty(exports, "QueueService", { enumerable: true, get: function () { return queue_service_1.QueueService; } });
+//# sourceMappingURL=index.js.map

package/dist/queue/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/queue/index.ts"],"names":[],"mappings":";;;AAAA,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AACpB,iDAA0D;AAAjD,6GAAA,YAAY,OAAA"}

package/dist/queue/queue.module.d.ts

@@ -0,0 +1,3 @@
+export declare class QueueModule {
+}
+//# sourceMappingURL=queue.module.d.ts.map

package/dist/queue/queue.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.module.d.ts","sourceRoot":"","sources":["../../src/queue/queue.module.ts"],"names":[],"mappings":"AAGA,qBAKa,WAAW;CAAG"}

package/dist/queue/queue.module.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QueueModule = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const queue_service_1 = require("./queue.service");
+let QueueModule = class QueueModule {
+};
+exports.QueueModule = QueueModule;
+exports.QueueModule = QueueModule = tslib_1.__decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({
+        providers: [queue_service_1.QueueService],
+        exports: [queue_service_1.QueueService],
+    })
+], QueueModule);
+//# sourceMappingURL=queue.module.js.map

package/dist/queue/queue.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.module.js","sourceRoot":"","sources":["../../src/queue/queue.module.ts"],"names":[],"mappings":";;;;AAAA,2CAAgD;AAChD,mDAA+C;AAOxC,IAAM,WAAW,GAAjB,MAAM,WAAW;CAAG,CAAA;AAAd,kCAAW;sBAAX,WAAW;IALvB,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC;QACN,SAAS,EAAE,CAAC,4BAAY,CAAC;QACzB,OAAO,EAAE,CAAC,4BAAY,CAAC;KACxB,CAAC;GACW,WAAW,CAAG"}

package/dist/queue/queue.service.d.ts

@@ -0,0 +1,20 @@
+import { OnModuleInit, OnModuleDestroy } from '@nestjs/common';
+import { ConfigService } from '../config/config.service';
+export interface QueueItem<T = Record<string, unknown>> {
+    id: string;
+    payload: T;
+    createdAt: string;
+}
+export declare class QueueService implements OnModuleInit, OnModuleDestroy {
+    private readonly configService;
+    private redis;
+    private readonly defaultQueue;
+    constructor(configService: ConfigService);
+    onModuleInit(): void;
+    onModuleDestroy(): Promise<void>;
+    push<T = Record<string, unknown>>(payload: T, queueName?: string): Promise<string | null>;
+    pop<T = Record<string, unknown>>(queueName?: string): Promise<QueueItem<T> | null>;
+    length(queueName?: string): Promise<number>;
+    scanQueues(pattern: string): Promise<string[]>;
+}
+//# sourceMappingURL=queue.service.d.ts.map

package/dist/queue/queue.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.service.d.ts","sourceRoot":"","sources":["../../src/queue/queue.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE3E,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGzD,MAAM,WAAW,SAAS,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACpD,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBACa,YAAa,YAAW,YAAY,EAAE,eAAe;IAIpD,OAAO,CAAC,QAAQ,CAAC,aAAa;IAH1C,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;gBAErB,aAAa,EAAE,aAAa;IAEzD,YAAY;IAoBN,eAAe;IAMf,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,OAAO,EAAE,CAAC,EACV,SAAS,SAAoB,GAC5B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAyBnB,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,SAAS,SAAoB,GAC5B,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAiBzB,MAAM,CAAC,SAAS,SAAoB,GAAG,OAAO,CAAC,MAAM,CAAC;IActD,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CA4BrD"}

package/dist/queue/queue.service.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QueueService = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const ioredis_1 = require("ioredis");
+const config_service_1 = require("../config/config.service");
+const logger_1 = require("../common/logger");
+let QueueService = class QueueService {
+    configService;
+    redis = null;
+    defaultQueue = 'webhook:generic';
+    constructor(configService) {
+        this.configService = configService;
+    }
+    onModuleInit() {
+        const redisUrl = this.configService.getRedisUrl();
+        try {
+            this.redis = new ioredis_1.Redis(redisUrl);
+            this.redis.on('connect', () => {
+                logger_1.logger.info('Queue Redis connected');
+            });
+            this.redis.on('error', (err) => {
+                logger_1.logger.error('Queue Redis error', { error: err.message });
+            });
+        }
+        catch (error) {
+            logger_1.logger.warn('Queue Redis not available', {
+                error: error instanceof Error ? error.message : 'Unknown',
+            });
+        }
+    }
+    async onModuleDestroy() {
+        if (this.redis) {
+            await this.redis.quit();
+        }
+    }
+    async push(payload, queueName = this.defaultQueue) {
+        if (!this.redis) {
+            logger_1.logger.warn('Queue not available, payload not queued');
+            return null;
+        }
+        const item = {
+            id: `${Date.now()}-${Math.random().toString(36).slice(2, 9)}`,
+            payload,
+            createdAt: new Date().toISOString(),
+        };
+        try {
+            await this.redis.lpush(queueName, JSON.stringify(item));
+            logger_1.logger.info('Payload pushed to queue', { queueName, id: item.id, payload });
+            return item.id;
+        }
+        catch (error) {
+            logger_1.logger.error('Failed to push to queue', {
+                queueName,
+                error: error instanceof Error ? error.message : 'Unknown',
+            });
+            return null;
+        }
+    }
+    async pop(queueName = this.defaultQueue) {
+        if (!this.redis)
+            return null;
+        try {
+            const raw = await this.redis.rpop(queueName);
+            if (!raw)
+                return null;
+            return JSON.parse(raw);
+        }
+        catch (error) {
+            logger_1.logger.error('Failed to pop from queue', {
+                queueName,
+                error: error instanceof Error ? error.message : 'Unknown',
+            });
+            return null;
+        }
+    }
+    async length(queueName = this.defaultQueue) {
+        if (!this.redis)
+            return 0;
+        try {
+            return await this.redis.llen(queueName);
+        }
+        catch (error) {
+            logger_1.logger.error('Failed to get queue length', {
+                queueName,
+                error: error instanceof Error ? error.message : 'Unknown',
+            });
+            return 0;
+        }
+    }
+    async scanQueues(pattern) {
+        if (!this.redis)
+            return [];
+        try {
+            const keys = [];
+            let cursor = '0';
+            do {
+                const [nextCursor, matchedKeys] = await this.redis.scan(cursor, 'MATCH', pattern, 'COUNT', 100);
+                cursor = nextCursor;
+                keys.push(...matchedKeys);
+            } while (cursor !== '0');
+            return keys;
+        }
+        catch (error) {
+            logger_1.logger.error('Failed to scan queues', {
+                pattern,
+                error: error instanceof Error ? error.message : 'Unknown',
+            });
+            return [];
+        }
+    }
+};
+exports.QueueService = QueueService;
+exports.QueueService = QueueService = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__metadata("design:paramtypes", [config_service_1.ConfigService])
+], QueueService);
+//# sourceMappingURL=queue.service.js.map

package/dist/queue/queue.service.js.map

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

package/dist/theme/header-content.service.d.ts

@@ -0,0 +1,142 @@
+import { CacheService } from '../cache/cache.service';
+import { ConfigService } from '../config/config.service';
+import { ShopifyThemeService } from '../integrations/shopify-theme';
+interface ParsedHeaderGroup {
+    sections: Record<string, {
+        type: string;
+        blocks?: Record<string, {
+            type: string;
+            settings?: Record<string, unknown>;
+        }>;
+        block_order?: string[];
+        settings?: Record<string, unknown>;
+    }>;
+    order: string[];
+}
+interface PromoCardData {
+    title: string;
+    link: string;
+    image?: {
+        url: string;
+        altText: string | null;
+        width: number;
+        height: number;
+    };
+}
+interface MegaMenuPromoData {
+    categoryTitle?: string;
+    cards: PromoCardData[];
+}
+interface MegaMenuData {
+    promos: MegaMenuPromoData[];
+}
+export interface CuratedMenuItem {
+    title: string;
+    url: string;
+    type: string;
+    resourceId: string | null;
+    sections?: string[];
+    megaMenu?: MegaMenuData;
+    items?: CuratedMenuItem[];
+}
+export interface CuratedHeaderContent {
+    headerSettings: Record<string, unknown>;
+    menu: {
+        handle: string;
+        items: CuratedMenuItem[];
+    };
+}
+export interface HeaderError {
+    code: string;
+    message: string;
+}
+export interface HeaderContentResult {
+    success: boolean;
+    data?: CuratedHeaderContent;
+    error?: HeaderError;
+    isStale: boolean;
+    triggeredRefresh: boolean;
+}
+export declare class HeaderContentService {
+    private readonly cacheService;
+    private readonly configService;
+    private readonly shopifyThemeService;
+    private refreshInProgress;
+    constructor(cacheService: CacheService, configService: ConfigService, shopifyThemeService: ShopifyThemeService);
+    /**
+     * Build cache key for header content.
+     * Pattern: ${brand}:header:${menuHandle}
+     */
+    buildCacheKey(brand: string, menuHandle: string): string;
+    /**
+     * Get header content with stale-while-revalidate semantics.
+     * Returns cached data immediately, triggers background refresh if stale.
+     * On cache miss, fetches on-demand (synchronously).
+     */
+    getHeaderContent(brand: string, menuHandle?: string): Promise<HeaderContentResult>;
+    /**
+     * Fetch header-group.json from Shopify and process header content.
+     * Used for both cache miss and background refresh.
+     */
+    private fetchHeaderContentFresh;
+    /**
+     * Background refresh with deduplication.
+     * Prevents concurrent refreshes for the same cache key.
+     */
+    private refreshHeaderInBackground;
+    /**
+     * Fetch menu items and metaobject, process, and cache the header content.
+     * Fails entirely if any API call fails - no partial caching.
+     */
+    fetchAndCacheHeaderContent(brand: string, rawHeaderGroup: ParsedHeaderGroup): Promise<CuratedHeaderContent | null>;
+    /**
+     * Fetch menu items from Storefront API
+     */
+    private fetchMenu;
+    /**
+     * Fetch menu metaobject from Storefront API
+     */
+    private fetchMenuMetaobject;
+    /**
+     * Parse section mappings from metaobject JSON field
+     */
+    private parseSectionMappings;
+    /**
+     * Process and merge header content
+     */
+    private processHeaderContent;
+    /**
+     * Recursively curate menu items and attach section mappings and mega menus
+     */
+    private curateMenuItems;
+    /**
+     * Curate a single menu item (without mega menu logic)
+     */
+    private curateMenuItem;
+    /**
+     * Extract handle from URL path
+     */
+    private extractHandleFromUrl;
+    /**
+     * Extract mega menu configuration from header-group.json blocks.
+     */
+    private extractMegaMenuConfig;
+    /**
+     * Fetch a single promo metaobject from Storefront API
+     */
+    private fetchPromoMetaobject;
+    /**
+     * Parse promo metaobject response into MegaMenuPromoData
+     */
+    private parsePromoMetaobject;
+    /**
+     * Parse a promo card from metaobject fields
+     */
+    private parsePromoCard;
+    /**
+     * Fetch all promo metaobjects in parallel
+     */
+    private fetchAllPromos;
+}
+export {};
+//# sourceMappingURL=header-content.service.d.ts.map

package/dist/theme/header-content.service.d.ts.map

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