@adtrackify/at-service-common 4.0.1 → 4.0.2

package/dist/esm/services/acuity-api-service.js

@@ -1,70 +1,70 @@
-import { AcuityClient } from '../clients/third-party/acuity-client';
-import { Logger } from '../helpers';
-export class AcuityApiService {
-    acuityClient;
-    constructor(acuityKeyId, acuitySecret) {
-        this.acuityClient = new AcuityClient(acuityKeyId, acuitySecret);
-    }
-    getAcuityContactsByMd5 = async (pixelId, identityId, md5Hash, contactAcquisitionIntegration) => {
-        try {
-            const md5ContactsResponse = await this.acuityClient.getContactsByMd5(md5Hash);
-            if (md5ContactsResponse.status !== 200) {
-                Logger.error('Failed to get acuity contacts by md5', {
-                    pixelId,
-                    identityId,
-                    md5Hash,
-                    contactAcquisitionIntegration,
-                    md5ContactsResponse,
-                });
-                return null;
-            }
-            return md5ContactsResponse.data;
-        }
-        catch (error) {
-            Logger.error('Failed to get acuity contacts by md5', { error });
-            return null;
-        }
-    };
-    getAcuityContactsByEmail = async (pixelId, identityId, email, contactAcquisitionIntegration) => {
-        try {
-            const emailContactsResponse = await this.acuityClient.getContactsByEmail(email);
-            if (emailContactsResponse.status !== 200) {
-                Logger.error('Failed to get acuity contacts by email', {
-                    pixelId,
-                    identityId,
-                    contactAcquisitionIntegration,
-                    emailContactsResponse,
-                });
-                return null;
-            }
-            return emailContactsResponse.data;
-        }
-        catch (error) {
-            Logger.error('Failed to get acuity contacts by email', { error, pixelId, identityId });
-            return null;
-        }
-    };
-    getAcuityContactsByMd5Batch = async (pixelId, identityId, md5Hashes, contactAcquisitionIntegration) => {
-        try {
-            const result = {};
-            for (const md5Hash of md5Hashes) {
-                const md5ContactsResponse = await this.acuityClient.getContactsByMd5(md5Hash);
-                if (md5ContactsResponse.status === 200 && md5ContactsResponse.data?.identities) {
-                    result[md5Hash] = md5ContactsResponse.data.identities;
-                }
-            }
-            return result;
-        }
-        catch (error) {
-            Logger.error('Failed to get acuity contacts by md5 batch', {
-                error,
-                pixelId,
-                identityId,
-                md5HashesCount: md5Hashes.length,
-                contactAcquisitionIntegration,
-            });
-            return null;
-        }
-    };
-}
+import { AcuityClient } from '../clients/third-party/acuity-client';
+import { Logger } from '../helpers';
+export class AcuityApiService {
+    acuityClient;
+    constructor(acuityKeyId, acuitySecret) {
+        this.acuityClient = new AcuityClient(acuityKeyId, acuitySecret);
+    }
+    getAcuityContactsByMd5 = async (pixelId, identityId, md5Hash, contactAcquisitionIntegration) => {
+        try {
+            const md5ContactsResponse = await this.acuityClient.getContactsByMd5(md5Hash);
+            if (md5ContactsResponse.status !== 200) {
+                Logger.error('Failed to get acuity contacts by md5', {
+                    pixelId,
+                    identityId,
+                    md5Hash,
+                    contactAcquisitionIntegration,
+                    md5ContactsResponse,
+                });
+                return null;
+            }
+            return md5ContactsResponse.data;
+        }
+        catch (error) {
+            Logger.error('Failed to get acuity contacts by md5', { error });
+            return null;
+        }
+    };
+    getAcuityContactsByEmail = async (pixelId, identityId, email, contactAcquisitionIntegration) => {
+        try {
+            const emailContactsResponse = await this.acuityClient.getContactsByEmail(email);
+            if (emailContactsResponse.status !== 200) {
+                Logger.error('Failed to get acuity contacts by email', {
+                    pixelId,
+                    identityId,
+                    contactAcquisitionIntegration,
+                    emailContactsResponse,
+                });
+                return null;
+            }
+            return emailContactsResponse.data;
+        }
+        catch (error) {
+            Logger.error('Failed to get acuity contacts by email', { error, pixelId, identityId });
+            return null;
+        }
+    };
+    getAcuityContactsByMd5Batch = async (pixelId, identityId, md5Hashes, contactAcquisitionIntegration) => {
+        try {
+            const result = {};
+            for (const md5Hash of md5Hashes) {
+                const md5ContactsResponse = await this.acuityClient.getContactsByMd5(md5Hash);
+                if (md5ContactsResponse.status === 200 && md5ContactsResponse.data?.identities) {
+                    result[md5Hash] = md5ContactsResponse.data.identities;
+                }
+            }
+            return result;
+        }
+        catch (error) {
+            Logger.error('Failed to get acuity contacts by md5 batch', {
+                error,
+                pixelId,
+                identityId,
+                md5HashesCount: md5Hashes.length,
+                contactAcquisitionIntegration,
+            });
+            return null;
+        }
+    };
+}
 //# sourceMappingURL=acuity-api-service.js.map

package/dist/esm/services/cache/generic-cached-object.d.ts

@@ -1,5 +1,5 @@
-export interface GenericCachedObject {
-    expiresAt?: number;
-    cachedAt?: string;
-    cachedAtEpoch?: number;
-}
+export interface GenericCachedObject {
+    expiresAt?: number;
+    cachedAt?: string;
+    cachedAtEpoch?: number;
+}

package/dist/esm/services/cache/generic-cached-object.js

@@ -1,2 +1,2 @@
-export {};
+export {};
 //# sourceMappingURL=generic-cached-object.js.map

package/dist/esm/services/cache/index.d.ts

@@ -1 +1 @@
-export * from './product-cache-service.js';
+export * from './product-cache-service.js';

package/dist/esm/services/cache/index.js

@@ -1,2 +1,2 @@
-export * from './product-cache-service.js';
+export * from './product-cache-service.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/services/cache/product-cache-service.d.ts

@@ -1,21 +1,21 @@
-import { type InternalProduct } from '@adtrackify/at-tracking-event-types';
-import { GenericCachedObject } from './generic-cached-object';
-export interface ProductCache extends GenericCachedObject {
-    productCompressed: string;
-    fullSha256?: string;
-    noInventorySha256?: string;
-    cachedAtEpoch?: number;
-    expiresAt?: number;
-}
-export declare const getProductCacheKey: (pixelId: string, productId: string) => string;
-export declare class ProductCacheService {
-    private genericCacheService;
-    private redisCacheTtlInSeconds;
-    constructor(cacheLambdaFunctionArn: string, redisCacheTtlInSeconds: number);
-    getCacheKey: (pixelId: string, productId: string) => string;
-    getProductFromCache: (pixelId: string, productId: string) => Promise<InternalProduct | undefined>;
-    getProductCache: (pixelId: string, productId: string) => Promise<ProductCache | undefined>;
-    putProductInCache: (pixelId: string, productId: string, product: InternalProduct, ttlInSeconds?: number) => Promise<void>;
-    deleteProductFromCache: (pixelId: string, productId: string) => Promise<void>;
-    private isProductCacheStale;
-}
+import { type InternalProduct } from '@adtrackify/at-tracking-event-types';
+import { GenericCachedObject } from './generic-cached-object';
+export interface ProductCache extends GenericCachedObject {
+    productCompressed: string;
+    fullSha256?: string;
+    noInventorySha256?: string;
+    cachedAtEpoch?: number;
+    expiresAt?: number;
+}
+export declare const getProductCacheKey: (pixelId: string, productId: string) => string;
+export declare class ProductCacheService {
+    private genericCacheService;
+    private redisCacheTtlInSeconds;
+    constructor(cacheLambdaFunctionArn: string, redisCacheTtlInSeconds: number);
+    getCacheKey: (pixelId: string, productId: string) => string;
+    getProductFromCache: (pixelId: string, productId: string) => Promise<InternalProduct | undefined>;
+    getProductCache: (pixelId: string, productId: string) => Promise<ProductCache | undefined>;
+    putProductInCache: (pixelId: string, productId: string, product: InternalProduct, ttlInSeconds?: number) => Promise<void>;
+    deleteProductFromCache: (pixelId: string, productId: string) => Promise<void>;
+    private isProductCacheStale;
+}

package/dist/esm/services/cache/product-cache-service.js

@@ -1,69 +1,69 @@
-import { DateTime } from 'luxon';
-import { GenericCacheService } from '../generic-cache-service.js';
-import { compressJSON, decompressJSON } from '../../libs/index.js';
-import crypto from 'crypto';
-const DEFAULT_TTL_IN_SECONDS = 7 * 24 * 3600;
-export const getProductCacheKey = (pixelId, productId) => {
-    return `internal:product:${pixelId}_${productId}`;
-};
-export class ProductCacheService {
-    genericCacheService;
-    redisCacheTtlInSeconds;
-    constructor(cacheLambdaFunctionArn, redisCacheTtlInSeconds) {
-        this.genericCacheService = new GenericCacheService(cacheLambdaFunctionArn);
-        this.redisCacheTtlInSeconds = redisCacheTtlInSeconds || DEFAULT_TTL_IN_SECONDS;
-    }
-    getCacheKey = (pixelId, productId) => {
-        return getProductCacheKey(pixelId, productId);
-    };
-    getProductFromCache = async (pixelId, productId) => {
-        const cachedData = await this.getProductCache(pixelId, productId);
-        if (cachedData && !this.isProductCacheStale(cachedData)) {
-            const product = decompressJSON(cachedData.productCompressed);
-            return product;
-        }
-        return undefined;
-    };
-    getProductCache = async (pixelId, productId) => {
-        const cacheKey = this.getCacheKey(pixelId, productId);
-        const cachedData = await this.genericCacheService.getCachedData(cacheKey);
-        return cachedData;
-    };
-    putProductInCache = async (pixelId, productId, product, ttlInSeconds) => {
-        const cacheKey = this.getCacheKey(pixelId, productId);
-        const ttl = ttlInSeconds || this.redisCacheTtlInSeconds;
-        const expiresAt = DateTime.utc().plus({ seconds: ttl }).toSeconds();
-        const cachedAtEpoch = DateTime.utc().toSeconds();
-        const fullSha256 = crypto.createHash('sha256').update(JSON.stringify(product)).digest('hex');
-        const noInventoryProduct = {
-            ...product,
-            totalInventory: undefined,
-            variants: product?.variants?.map((variant) => ({
-                ...variant,
-                inventoryQuantity: undefined,
-                inventoryItem: undefined,
-            })),
-        };
-        const noInventorySha256 = crypto.createHash('sha256').update(JSON.stringify(noInventoryProduct)).digest('hex');
-        const productCompressed = compressJSON(product);
-        const productCache = {
-            productCompressed,
-            fullSha256,
-            noInventorySha256,
-            cachedAtEpoch,
-            expiresAt,
-        };
-        await this.genericCacheService.putCachedData(cacheKey, productCache, ttl);
-    };
-    deleteProductFromCache = async (pixelId, productId) => {
-        const cacheKey = this.getCacheKey(pixelId, productId);
-        await this.genericCacheService.deleteCachedData(cacheKey);
-    };
-    isProductCacheStale = (cachedData) => {
-        if (cachedData?.expiresAt && cachedData.expiresAt < DateTime.utc().toSeconds()) {
-            return true;
-        }
-        return false;
-    };
-}
+import { DateTime } from 'luxon';
+import { GenericCacheService } from '../generic-cache-service.js';
+import { compressJSON, decompressJSON } from '../../libs/index.js';
+import crypto from 'crypto';
+const DEFAULT_TTL_IN_SECONDS = 7 * 24 * 3600;
+export const getProductCacheKey = (pixelId, productId) => {
+    return `internal:product:${pixelId}_${productId}`;
+};
+export class ProductCacheService {
+    genericCacheService;
+    redisCacheTtlInSeconds;
+    constructor(cacheLambdaFunctionArn, redisCacheTtlInSeconds) {
+        this.genericCacheService = new GenericCacheService(cacheLambdaFunctionArn);
+        this.redisCacheTtlInSeconds = redisCacheTtlInSeconds || DEFAULT_TTL_IN_SECONDS;
+    }
+    getCacheKey = (pixelId, productId) => {
+        return getProductCacheKey(pixelId, productId);
+    };
+    getProductFromCache = async (pixelId, productId) => {
+        const cachedData = await this.getProductCache(pixelId, productId);
+        if (cachedData && !this.isProductCacheStale(cachedData)) {
+            const product = decompressJSON(cachedData.productCompressed);
+            return product;
+        }
+        return undefined;
+    };
+    getProductCache = async (pixelId, productId) => {
+        const cacheKey = this.getCacheKey(pixelId, productId);
+        const cachedData = await this.genericCacheService.getCachedData(cacheKey);
+        return cachedData;
+    };
+    putProductInCache = async (pixelId, productId, product, ttlInSeconds) => {
+        const cacheKey = this.getCacheKey(pixelId, productId);
+        const ttl = ttlInSeconds || this.redisCacheTtlInSeconds;
+        const expiresAt = DateTime.utc().plus({ seconds: ttl }).toSeconds();
+        const cachedAtEpoch = DateTime.utc().toSeconds();
+        const fullSha256 = crypto.createHash('sha256').update(JSON.stringify(product)).digest('hex');
+        const noInventoryProduct = {
+            ...product,
+            totalInventory: undefined,
+            variants: product?.variants?.map((variant) => ({
+                ...variant,
+                inventoryQuantity: undefined,
+                inventoryItem: undefined,
+            })),
+        };
+        const noInventorySha256 = crypto.createHash('sha256').update(JSON.stringify(noInventoryProduct)).digest('hex');
+        const productCompressed = compressJSON(product);
+        const productCache = {
+            productCompressed,
+            fullSha256,
+            noInventorySha256,
+            cachedAtEpoch,
+            expiresAt,
+        };
+        await this.genericCacheService.putCachedData(cacheKey, productCache, ttl);
+    };
+    deleteProductFromCache = async (pixelId, productId) => {
+        const cacheKey = this.getCacheKey(pixelId, productId);
+        await this.genericCacheService.deleteCachedData(cacheKey);
+    };
+    isProductCacheStale = (cachedData) => {
+        if (cachedData?.expiresAt && cachedData.expiresAt < DateTime.utc().toSeconds()) {
+            return true;
+        }
+        return false;
+    };
+}
 //# sourceMappingURL=product-cache-service.js.map

package/dist/esm/services/cost/cost-calculation-types.d.ts

@@ -0,0 +1,69 @@
+import { type GlobalProductOverrideConfig, type OrderCostConfig, type GatewayCostConfig, type ShippingCostConfig, COST_CATEGORY } from '@adtrackify/at-tracking-event-types';
+export interface CostConfigsBundle {
+    globalProductOverride: GlobalProductOverrideConfig | null;
+    order: OrderCostConfig | null;
+    gateway: GatewayCostConfig | null;
+    shipping: ShippingCostConfig | null;
+}
+export type CostConfigsByPixelId = Record<string, CostConfigsBundle>;
+export interface OrderFilterContext {
+    tags: string[];
+    sourceName?: string;
+    paymentGateways: string[];
+    shippingTitles: string[];
+    shipCountryCode?: string;
+}
+export interface LineItemFilterContext {
+    vendor?: string;
+    productType?: string;
+    tags: string[];
+    category?: string;
+    productId: string;
+    variantId: string;
+}
+export interface LineItemCostContext {
+    lineItemId: string;
+    quantity: number;
+    refundedQuantity: number;
+    filterContext: LineItemFilterContext;
+    variantHandlingFee?: number;
+}
+export interface OrderCostContext {
+    orderCreatedAt: string;
+    totalPrice: number;
+    grossSalePrice: number;
+    netSalePrice: number;
+    totalProductCost: number;
+    totalShipping: number;
+    totalWeight: number;
+    totalQuantity: number;
+    hasRefund: boolean;
+    orderFilterContext: OrderFilterContext;
+    lineItems: LineItemCostContext[];
+}
+export interface LineItemCalculatedCosts {
+    totalLineItemHandlingCost: number;
+    totalLineItemOtherCost: number;
+}
+export interface OrderCostResult {
+    orderLevelHandlingCost: number;
+    lineItemLevelHandlingCost: number;
+    totalHandlingCost: number;
+    orderLevelOtherCost: number;
+    lineItemLevelOtherCost: number;
+    totalOtherCost: number;
+    totalGatewayCost: number;
+    totalShippingCost: number;
+    lineItemCosts: Record<string, LineItemCalculatedCosts>;
+    categoryCosts: CategoryCostResult;
+}
+export interface CategoryCostResult {
+    totalOtherCogs: number;
+    otherFulfillmentCost: number;
+    otherTransactionCost: number;
+    marketingCost: number;
+    agencyFeesCost: number;
+    opexCost: number;
+    totalOtherCost: number;
+}
+export declare function normalizeCategory(category: string | undefined): COST_CATEGORY;

package/dist/esm/services/cost/cost-calculation-types.js

@@ -0,0 +1,16 @@
+import { COST_CATEGORY, } from '@adtrackify/at-tracking-event-types';
+export function normalizeCategory(category) {
+    if (!category || typeof category !== 'string')
+        return COST_CATEGORY.OTHER;
+    const normalized = category.toLowerCase();
+    switch (normalized) {
+        case 'payment_fees':
+            return COST_CATEGORY.TRANSACTION;
+        case 'packaging':
+            return COST_CATEGORY.FULFILLMENT;
+    }
+    const enumValues = Object.values(COST_CATEGORY);
+    const matched = enumValues.find((v) => v.toLowerCase() === normalized);
+    return matched ?? COST_CATEGORY.OTHER;
+}
+//# sourceMappingURL=cost-calculation-types.js.map

package/dist/esm/services/cost/cost-calculation-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-calculation-types.js","sourceRoot":"","sources":["../../../../src/services/cost/cost-calculation-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,aAAa,GACd,MAAM,qCAAqC,CAAC;AAoF7C,MAAM,UAAU,iBAAiB,CAAC,QAA4B;IAC5D,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,aAAa,CAAC,KAAK,CAAC;IAE1E,MAAM,UAAU,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IAE1C,QAAQ,UAAU,EAAE;QAClB,KAAK,cAAc;YACjB,OAAO,aAAa,CAAC,WAAW,CAAC;QACnC,KAAK,WAAW;YACd,OAAO,aAAa,CAAC,WAAW,CAAC;KACpC;IAED,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,UAAU,CAAC,CAAC;IACvE,OAAO,OAAO,IAAI,aAAa,CAAC,KAAK,CAAC;AACxC,CAAC"}

package/dist/esm/services/cost/cost-calculator-service.d.ts

@@ -0,0 +1,24 @@
+import { WEIGHT_UNIT, type OrderCostEntry, type ShippingProfile, type WeightInterval, type QuantityInterval } from '@adtrackify/at-tracking-event-types';
+import { type CostConfigsBundle, type OrderCostContext, type OrderCostResult, type LineItemCalculatedCosts, type LineItemCostContext, type OrderFilterContext, type CategoryCostResult } from './cost-calculation-types.js';
+import { type ExchangeRatesMap } from './cost-currency-service.js';
+export declare const CostCalculatorService: {
+    isDateInRange: (orderDate: string, effectiveFrom?: string, effectiveTo?: string) => boolean;
+    findMatchingWeightTierAmount: (tiers: WeightInterval[] | undefined, weightGrams: number, weightUnit: WEIGHT_UNIT | undefined) => number;
+    findQuantityTierAmount: (tiers: QuantityInterval[] | undefined, quantity: number) => number;
+    calculateHandlingCost: (configs: CostConfigsBundle, lineItems: LineItemCostContext[], lineItemCosts: Record<string, LineItemCalculatedCosts>, orderCurrency: string, exchangeRatesMap: ExchangeRatesMap) => number;
+    calculateGatewayCost: (configs: CostConfigsBundle, orderGateways: string[], totalPrice: number, orderCreatedAt: string, orderCurrency: string, exchangeRatesMap: ExchangeRatesMap) => number;
+    findMatchingShippingProfile: (profiles: ShippingProfile[] | undefined, shipCountryCode: string | undefined, orderCreatedAt: string, orderFilterContext?: OrderFilterContext) => ShippingProfile | null;
+    calculateShippingCost: (configs: CostConfigsBundle, shopifyShippingAmount: number, shipCountryCode: string | undefined, totalWeightGrams: number, orderCreatedAt: string, orderCurrency: string, exchangeRatesMap: ExchangeRatesMap, orderFilterContext?: OrderFilterContext) => number;
+    calculateOtherCostEntry: (entry: OrderCostEntry, context: OrderCostContext, lineItemCosts: Record<string, LineItemCalculatedCosts>, orderCurrency: string, exchangeRatesMap: ExchangeRatesMap) => {
+        orderLevel: number;
+        lineItemLevel: number;
+    };
+    calculateOtherCost: (configs: CostConfigsBundle, context: OrderCostContext, lineItemCosts: Record<string, LineItemCalculatedCosts>, orderCurrency: string, exchangeRatesMap: ExchangeRatesMap) => {
+        orderLevel: number;
+        lineItemLevel: number;
+        total: number;
+        categoryCosts: CategoryCostResult;
+    };
+    calculateLineItemHandlingCosts: (lineItems: LineItemCostContext[]) => Record<string, number>;
+    calculateOrderCosts: (configs: CostConfigsBundle | null, context: OrderCostContext, orderCurrency: string, exchangeRatesMap: ExchangeRatesMap) => OrderCostResult;
+};