@adtrackify/at-service-common 3.2.26 → 3.2.27

package/dist/cjs/clients/third-party/exchange-rate-api-client.d.ts

@@ -0,0 +1,17 @@
+import { ApiResponse } from '../../types/api-response';
+export interface GetCurrencyExchangeRateResponse {
+    result: string;
+    documentation?: string;
+    terms_of_use?: string;
+    time_last_update_unix: number;
+    time_last_update_utc: string;
+    time_next_update_unix: number;
+    time_next_update_utc: string;
+    base_code: string;
+    conversion_rates: Record<string, number>;
+}
+export declare class ExchangeRateApiClient {
+    private EXCHANGE_RATE_API_KEY;
+    constructor(exchangeRateApiKey: string);
+    getCurrencyExchangeRate: (currency: string) => Promise<ApiResponse<GetCurrencyExchangeRateResponse>>;
+}

package/dist/cjs/clients/third-party/exchange-rate-api-client.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExchangeRateApiClient = void 0;
+const generic_1 = require("../generic");
+const EXCHANGE_RATE_API_URL = 'https://v6.exchangerate-api.com/v6';
+const client = (0, generic_1.axiosHttpService)({
+    baseURL: EXCHANGE_RATE_API_URL
+});
+class ExchangeRateApiClient {
+    EXCHANGE_RATE_API_KEY;
+    constructor(exchangeRateApiKey) {
+        this.EXCHANGE_RATE_API_KEY = exchangeRateApiKey;
+    }
+    getCurrencyExchangeRate = async (currency) => {
+        const response = await client.get(`/${this.EXCHANGE_RATE_API_KEY}/latest/${currency}`);
+        return response;
+    };
+}
+exports.ExchangeRateApiClient = ExchangeRateApiClient;
+//# sourceMappingURL=exchange-rate-api-client.js.map

package/dist/cjs/clients/third-party/exchange-rate-api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exchange-rate-api-client.js","sourceRoot":"","sources":["../../../../src/clients/third-party/exchange-rate-api-client.ts"],"names":[],"mappings":";;;AAAA,wCAA8C;AAe9C,MAAM,qBAAqB,GAAG,oCAAoC,CAAC;AACnE,MAAM,MAAM,GAAG,IAAA,0BAAgB,EAAC;IAC9B,OAAO,EAAE,qBAAqB;CAC/B,CAAC,CAAC;AAEH,MAAa,qBAAqB;IACxB,qBAAqB,CAAS;IAEtC,YAAY,kBAA0B;QACpC,IAAI,CAAC,qBAAqB,GAAG,kBAAkB,CAAC;IAClD,CAAC;IAEM,uBAAuB,GAAG,KAAK,EAAE,QAAgB,EAAyD,EAAE;QACjH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,qBAAqB,WAAW,QAAQ,EAAE,CAAC,CAAC;QACvF,OAAO,QAAwD,CAAC;IAClE,CAAC,CAAA;CACF;AAXD,sDAWC"}

package/dist/cjs/services/currency-exchange-rate-lookup-service.d.ts

@@ -0,0 +1,11 @@
+import { CurrencyExchangeRateRecord } from './db/currency-exchange-rates-db-service';
+export declare class CurrencyExchangeRateLookupService {
+    private TABLE_NAME;
+    private TABLE_KEY;
+    private EXCHANGE_RATE_API_KEY;
+    private TTL_IN_DAYS;
+    private currencyExchangeRatesDbService;
+    private exchangeRateApiClient;
+    constructor(tableName: string, tableKey: string, exchangeRateApiKey: string, ttlInDays?: number);
+    lookupCurrencyExchangeRate: (currency: string) => Promise<CurrencyExchangeRateRecord | null>;
+}

package/dist/cjs/services/currency-exchange-rate-lookup-service.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CurrencyExchangeRateLookupService = void 0;
+const luxon_1 = require("luxon");
+const helpers_1 = require("../helpers");
+const currency_exchange_rates_db_service_1 = require("./db/currency-exchange-rates-db-service");
+const exchange_rate_api_client_1 = require("../clients/third-party/exchange-rate-api-client");
+class CurrencyExchangeRateLookupService {
+    TABLE_NAME;
+    TABLE_KEY;
+    EXCHANGE_RATE_API_KEY;
+    TTL_IN_DAYS;
+    currencyExchangeRatesDbService;
+    exchangeRateApiClient;
+    constructor(tableName, tableKey, exchangeRateApiKey, ttlInDays) {
+        this.TABLE_NAME = tableName;
+        this.TABLE_KEY = tableKey;
+        this.EXCHANGE_RATE_API_KEY = exchangeRateApiKey;
+        this.TTL_IN_DAYS = ttlInDays || 7;
+        this.currencyExchangeRatesDbService = new currency_exchange_rates_db_service_1.CurrencyExchangeRatesDbService(this.TABLE_NAME, this.TABLE_KEY);
+        this.exchangeRateApiClient = new exchange_rate_api_client_1.ExchangeRateApiClient(this.EXCHANGE_RATE_API_KEY);
+    }
+    lookupCurrencyExchangeRate = async (currency) => {
+        try {
+            const record = await this.currencyExchangeRatesDbService.getCurrencyExchangeRate(currency);
+            if (record && record?.expiresAt && record.expiresAt < luxon_1.DateTime.utc().toSeconds()) {
+                helpers_1.Logger.debug('Currency exchange rate record found in db cache', { currency, record, expiresAt: record.expiresAt, currentEpoch: luxon_1.DateTime.utc().toSeconds() });
+                return record;
+            }
+            const response = await this.exchangeRateApiClient.getCurrencyExchangeRate(currency);
+            if (response.status !== 200 || response?.data?.result !== 'success' || !response?.data) {
+                helpers_1.Logger.error('Failed to lookup currency exchange rate', { response });
+                return null;
+            }
+            const exchangeRateResponse = response.data;
+            const currencyRates = exchangeRateResponse?.conversion_rates;
+            const providerLastUpdatedAtEpoch = exchangeRateResponse?.time_last_update_unix;
+            const providerNextUpdateAtEpoch = exchangeRateResponse?.time_next_update_unix;
+            const currencyExchangeRateRecord = this.currencyExchangeRatesDbService.buildCurrencyExchangeRateRecord(currency, currencyRates, this.TTL_IN_DAYS, 'exchangerate-api', providerLastUpdatedAtEpoch, providerNextUpdateAtEpoch);
+            await this.currencyExchangeRatesDbService.putCurrencyExchangeRate(currencyExchangeRateRecord);
+            helpers_1.Logger.debug('Currency exchange rate record put in db cache', { currency, currencyExchangeRateRecord, expiresAt: currencyExchangeRateRecord.expiresAt, currentEpoch: luxon_1.DateTime.utc().toSeconds() });
+            return currencyExchangeRateRecord ?? null;
+        }
+        catch (error) {
+            helpers_1.Logger.error('Failed to lookup currency exchange rate', { error, currency, tableName: this.TABLE_NAME, tableKey: this.TABLE_KEY, exchangeRateApiKey: this.EXCHANGE_RATE_API_KEY });
+            return null;
+        }
+    };
+}
+exports.CurrencyExchangeRateLookupService = CurrencyExchangeRateLookupService;
+//# sourceMappingURL=currency-exchange-rate-lookup-service.js.map

package/dist/cjs/services/currency-exchange-rate-lookup-service.js.map

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

package/dist/cjs/services/db/currency-exchange-rates-db-service.d.ts

@@ -0,0 +1,21 @@
+export type CurrencyRates = Record<string, number>;
+export interface CurrencyExchangeRateRecord {
+    currency: string;
+    rates: CurrencyRates;
+    expiresAt: number;
+    cachedAt: string;
+    cachedAtEpoch: number;
+    provider?: string;
+    providerLastUpdatedAtEpoch?: number;
+    providerNextUpdateAtEpoch?: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export declare class CurrencyExchangeRatesDbService {
+    TABLE_NAME: string;
+    TABLE_KEY: string;
+    constructor(tableName: string, tableKey: string);
+    getCurrencyExchangeRate: (currencyCode: string) => Promise<CurrencyExchangeRateRecord | null>;
+    buildCurrencyExchangeRateRecord: (currency: string, rates: CurrencyRates, ttlInDays: number, provider?: string, providerLastUpdatedAtEpoch?: number, providerNextUpdateAtEpoch?: number) => CurrencyExchangeRateRecord;
+    putCurrencyExchangeRate: (record: CurrencyExchangeRateRecord) => Promise<CurrencyExchangeRateRecord>;
+}

package/dist/cjs/services/db/currency-exchange-rates-db-service.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CurrencyExchangeRatesDbService = void 0;
+const luxon_1 = require("luxon");
+const clients_1 = require("../../clients");
+const dates_1 = require("../../libs/dates");
+class CurrencyExchangeRatesDbService {
+    TABLE_NAME;
+    TABLE_KEY;
+    constructor(tableName, tableKey) {
+        this.TABLE_NAME = tableName;
+        this.TABLE_KEY = tableKey;
+    }
+    getCurrencyExchangeRate = async (currencyCode) => {
+        const record = await clients_1.DynamoDbClient.safeGet(this.TABLE_NAME, this.TABLE_KEY, currencyCode);
+        return record ?? null;
+    };
+    buildCurrencyExchangeRateRecord = (currency, rates, ttlInDays, provider, providerLastUpdatedAtEpoch, providerNextUpdateAtEpoch) => {
+        const expiresAt = luxon_1.DateTime.utc().plus({ days: ttlInDays }).toSeconds();
+        const currentTimestamp = (0, dates_1.getCurrentTimestamp)();
+        return {
+            currency,
+            rates,
+            expiresAt,
+            cachedAt: currentTimestamp,
+            cachedAtEpoch: luxon_1.DateTime.utc().toSeconds(),
+            createdAt: currentTimestamp,
+            updatedAt: currentTimestamp,
+            provider,
+            providerLastUpdatedAtEpoch,
+            providerNextUpdateAtEpoch,
+        };
+    };
+    putCurrencyExchangeRate = async (record) => {
+        await clients_1.DynamoDbClient.safePut(this.TABLE_NAME, record);
+        return record;
+    };
+}
+exports.CurrencyExchangeRatesDbService = CurrencyExchangeRatesDbService;
+//# sourceMappingURL=currency-exchange-rates-db-service.js.map

package/dist/cjs/services/db/currency-exchange-rates-db-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency-exchange-rates-db-service.js","sourceRoot":"","sources":["../../../../src/services/db/currency-exchange-rates-db-service.ts"],"names":[],"mappings":";;;AAAA,iCAAiC;AACjC,2CAA+C;AAC/C,4CAAuD;AAgBvD,MAAa,8BAA8B;IAClC,UAAU,CAAS;IACnB,SAAS,CAAS;IAEzB,YAAY,SAAiB,EAAE,QAAgB;QAC7C,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAEM,uBAAuB,GAAG,KAAK,EAAE,YAAoB,EAA8C,EAAE;QAC1G,MAAM,MAAM,GAAG,MAAM,wBAAc,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QAC3F,OAAQ,MAAqC,IAAI,IAAI,CAAC;IACxD,CAAC,CAAA;IAEM,+BAA+B,GAAG,CAAC,QAAgB,EAAE,KAAoB,EAAE,SAAiB,EAAE,QAAiB,EAAE,0BAAmC,EAAE,yBAAkC,EAA8B,EAAE;QAC7N,MAAM,SAAS,GAAG,gBAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC;QACvE,MAAM,gBAAgB,GAAG,IAAA,2BAAmB,GAAE,CAAC;QAC/C,OAAO;YACL,QAAQ;YACR,KAAK;YACL,SAAS;YACT,QAAQ,EAAE,gBAAgB;YAC1B,aAAa,EAAE,gBAAQ,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE;YACzC,SAAS,EAAE,gBAAgB;YAC3B,SAAS,EAAE,gBAAgB;YAC3B,QAAQ;YACR,0BAA0B;YAC1B,yBAAyB;SAC1B,CAAC;IACJ,CAAC,CAAA;IAEM,uBAAuB,GAAG,KAAK,EAAE,MAAkC,EAAuC,EAAE;QACjH,MAAM,wBAAc,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACtD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAA;CACF;AAnCD,wEAmCC"}

package/dist/cjs/services/db/index.d.ts

@@ -6,3 +6,4 @@ export * from './tracking-events-db-service.js';
 export * from './shopify-products-cache-db-service.js';
 export * from './shopify-app-installs-db-service.js';
 export * from './identity-cache-db-service.js';
+export * from './currency-exchange-rates-db-service.js';

package/dist/cjs/services/db/index.js

@@ -22,4 +22,5 @@ __exportStar(require("./tracking-events-db-service.js"), exports);
 __exportStar(require("./shopify-products-cache-db-service.js"), exports);
 __exportStar(require("./shopify-app-installs-db-service.js"), exports);
 __exportStar(require("./identity-cache-db-service.js"), exports);
+__exportStar(require("./currency-exchange-rates-db-service.js"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/services/db/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/services/db/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+DAA6C;AAC7C,6DAA2C;AAC3C,uEAAqD;AACrD,qEAAmD;AACnD,kEAAgD;AAChD,yEAAuD;AACvD,uEAAqD;AACrD,iEAA+C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/services/db/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+DAA6C;AAC7C,6DAA2C;AAC3C,uEAAqD;AACrD,qEAAmD;AACnD,kEAAgD;AAChD,yEAAuD;AACvD,uEAAqD;AACrD,iEAA+C;AAC/C,0EAAwD"}

package/dist/cjs/services/index.d.ts

@@ -1,6 +1,7 @@
 export * from './eventbridge-integration-service.js';
 export * from './ipdata-lookup-service.js';
 export * from './generic-cache-service.js';
+export * from './currency-exchange-rate-lookup-service.js';
 export * from './db';
 export * from './shopify';
 export * from './cache';

package/dist/cjs/services/index.js

@@ -17,6 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./eventbridge-integration-service.js"), exports);
 __exportStar(require("./ipdata-lookup-service.js"), exports);
 __exportStar(require("./generic-cache-service.js"), exports);
+__exportStar(require("./currency-exchange-rate-lookup-service.js"), exports);
 __exportStar(require("./db"), exports);
 __exportStar(require("./shopify"), exports);
 __exportStar(require("./cache"), exports);

package/dist/cjs/services/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uEAAqD;AACrD,6DAA2C;AAC3C,6DAA2C;AAC3C,uCAAqB;AACrB,4CAA0B;AAC1B,0CAAwB;AACxB,2CAAyB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uEAAqD;AACrD,6DAA2C;AAC3C,6DAA2C;AAC3C,6EAA2D;AAC3D,uCAAqB;AACrB,4CAA0B;AAC1B,0CAAwB;AACxB,2CAAyB"}

package/dist/esm/clients/third-party/exchange-rate-api-client.d.ts

@@ -0,0 +1,17 @@
+import { ApiResponse } from '../../types/api-response';
+export interface GetCurrencyExchangeRateResponse {
+    result: string;
+    documentation?: string;
+    terms_of_use?: string;
+    time_last_update_unix: number;
+    time_last_update_utc: string;
+    time_next_update_unix: number;
+    time_next_update_utc: string;
+    base_code: string;
+    conversion_rates: Record<string, number>;
+}
+export declare class ExchangeRateApiClient {
+    private EXCHANGE_RATE_API_KEY;
+    constructor(exchangeRateApiKey: string);
+    getCurrencyExchangeRate: (currency: string) => Promise<ApiResponse<GetCurrencyExchangeRateResponse>>;
+}

package/dist/esm/clients/third-party/exchange-rate-api-client.js

@@ -0,0 +1,16 @@
+import { axiosHttpService } from '../generic';
+const EXCHANGE_RATE_API_URL = 'https://v6.exchangerate-api.com/v6';
+const client = axiosHttpService({
+    baseURL: EXCHANGE_RATE_API_URL
+});
+export class ExchangeRateApiClient {
+    EXCHANGE_RATE_API_KEY;
+    constructor(exchangeRateApiKey) {
+        this.EXCHANGE_RATE_API_KEY = exchangeRateApiKey;
+    }
+    getCurrencyExchangeRate = async (currency) => {
+        const response = await client.get(`/${this.EXCHANGE_RATE_API_KEY}/latest/${currency}`);
+        return response;
+    };
+}
+//# sourceMappingURL=exchange-rate-api-client.js.map

package/dist/esm/clients/third-party/exchange-rate-api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exchange-rate-api-client.js","sourceRoot":"","sources":["../../../../src/clients/third-party/exchange-rate-api-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAe9C,MAAM,qBAAqB,GAAG,oCAAoC,CAAC;AACnE,MAAM,MAAM,GAAG,gBAAgB,CAAC;IAC9B,OAAO,EAAE,qBAAqB;CAC/B,CAAC,CAAC;AAEH,MAAM,OAAO,qBAAqB;IACxB,qBAAqB,CAAS;IAEtC,YAAY,kBAA0B;QACpC,IAAI,CAAC,qBAAqB,GAAG,kBAAkB,CAAC;IAClD,CAAC;IAEM,uBAAuB,GAAG,KAAK,EAAE,QAAgB,EAAyD,EAAE;QACjH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,qBAAqB,WAAW,QAAQ,EAAE,CAAC,CAAC;QACvF,OAAO,QAAwD,CAAC;IAClE,CAAC,CAAA;CACF"}

package/dist/esm/services/currency-exchange-rate-lookup-service.d.ts

@@ -0,0 +1,11 @@
+import { CurrencyExchangeRateRecord } from './db/currency-exchange-rates-db-service';
+export declare class CurrencyExchangeRateLookupService {
+    private TABLE_NAME;
+    private TABLE_KEY;
+    private EXCHANGE_RATE_API_KEY;
+    private TTL_IN_DAYS;
+    private currencyExchangeRatesDbService;
+    private exchangeRateApiClient;
+    constructor(tableName: string, tableKey: string, exchangeRateApiKey: string, ttlInDays?: number);
+    lookupCurrencyExchangeRate: (currency: string) => Promise<CurrencyExchangeRateRecord | null>;
+}

package/dist/esm/services/currency-exchange-rate-lookup-service.js

@@ -0,0 +1,47 @@
+import { DateTime } from 'luxon';
+import { Logger } from '../helpers';
+import { CurrencyExchangeRatesDbService } from './db/currency-exchange-rates-db-service';
+import { ExchangeRateApiClient } from '../clients/third-party/exchange-rate-api-client';
+export class CurrencyExchangeRateLookupService {
+    TABLE_NAME;
+    TABLE_KEY;
+    EXCHANGE_RATE_API_KEY;
+    TTL_IN_DAYS;
+    currencyExchangeRatesDbService;
+    exchangeRateApiClient;
+    constructor(tableName, tableKey, exchangeRateApiKey, ttlInDays) {
+        this.TABLE_NAME = tableName;
+        this.TABLE_KEY = tableKey;
+        this.EXCHANGE_RATE_API_KEY = exchangeRateApiKey;
+        this.TTL_IN_DAYS = ttlInDays || 7;
+        this.currencyExchangeRatesDbService = new CurrencyExchangeRatesDbService(this.TABLE_NAME, this.TABLE_KEY);
+        this.exchangeRateApiClient = new ExchangeRateApiClient(this.EXCHANGE_RATE_API_KEY);
+    }
+    lookupCurrencyExchangeRate = async (currency) => {
+        try {
+            const record = await this.currencyExchangeRatesDbService.getCurrencyExchangeRate(currency);
+            if (record && record?.expiresAt && record.expiresAt < DateTime.utc().toSeconds()) {
+                Logger.debug('Currency exchange rate record found in db cache', { currency, record, expiresAt: record.expiresAt, currentEpoch: DateTime.utc().toSeconds() });
+                return record;
+            }
+            const response = await this.exchangeRateApiClient.getCurrencyExchangeRate(currency);
+            if (response.status !== 200 || response?.data?.result !== 'success' || !response?.data) {
+                Logger.error('Failed to lookup currency exchange rate', { response });
+                return null;
+            }
+            const exchangeRateResponse = response.data;
+            const currencyRates = exchangeRateResponse?.conversion_rates;
+            const providerLastUpdatedAtEpoch = exchangeRateResponse?.time_last_update_unix;
+            const providerNextUpdateAtEpoch = exchangeRateResponse?.time_next_update_unix;
+            const currencyExchangeRateRecord = this.currencyExchangeRatesDbService.buildCurrencyExchangeRateRecord(currency, currencyRates, this.TTL_IN_DAYS, 'exchangerate-api', providerLastUpdatedAtEpoch, providerNextUpdateAtEpoch);
+            await this.currencyExchangeRatesDbService.putCurrencyExchangeRate(currencyExchangeRateRecord);
+            Logger.debug('Currency exchange rate record put in db cache', { currency, currencyExchangeRateRecord, expiresAt: currencyExchangeRateRecord.expiresAt, currentEpoch: DateTime.utc().toSeconds() });
+            return currencyExchangeRateRecord ?? null;
+        }
+        catch (error) {
+            Logger.error('Failed to lookup currency exchange rate', { error, currency, tableName: this.TABLE_NAME, tableKey: this.TABLE_KEY, exchangeRateApiKey: this.EXCHANGE_RATE_API_KEY });
+            return null;
+        }
+    };
+}
+//# sourceMappingURL=currency-exchange-rate-lookup-service.js.map

package/dist/esm/services/currency-exchange-rate-lookup-service.js.map

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

package/dist/esm/services/db/currency-exchange-rates-db-service.d.ts

@@ -0,0 +1,21 @@
+export type CurrencyRates = Record<string, number>;
+export interface CurrencyExchangeRateRecord {
+    currency: string;
+    rates: CurrencyRates;
+    expiresAt: number;
+    cachedAt: string;
+    cachedAtEpoch: number;
+    provider?: string;
+    providerLastUpdatedAtEpoch?: number;
+    providerNextUpdateAtEpoch?: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export declare class CurrencyExchangeRatesDbService {
+    TABLE_NAME: string;
+    TABLE_KEY: string;
+    constructor(tableName: string, tableKey: string);
+    getCurrencyExchangeRate: (currencyCode: string) => Promise<CurrencyExchangeRateRecord | null>;
+    buildCurrencyExchangeRateRecord: (currency: string, rates: CurrencyRates, ttlInDays: number, provider?: string, providerLastUpdatedAtEpoch?: number, providerNextUpdateAtEpoch?: number) => CurrencyExchangeRateRecord;
+    putCurrencyExchangeRate: (record: CurrencyExchangeRateRecord) => Promise<CurrencyExchangeRateRecord>;
+}

package/dist/esm/services/db/currency-exchange-rates-db-service.js

@@ -0,0 +1,36 @@
+import { DateTime } from 'luxon';
+import { DynamoDbClient } from '../../clients';
+import { getCurrentTimestamp } from '../../libs/dates';
+export class CurrencyExchangeRatesDbService {
+    TABLE_NAME;
+    TABLE_KEY;
+    constructor(tableName, tableKey) {
+        this.TABLE_NAME = tableName;
+        this.TABLE_KEY = tableKey;
+    }
+    getCurrencyExchangeRate = async (currencyCode) => {
+        const record = await DynamoDbClient.safeGet(this.TABLE_NAME, this.TABLE_KEY, currencyCode);
+        return record ?? null;
+    };
+    buildCurrencyExchangeRateRecord = (currency, rates, ttlInDays, provider, providerLastUpdatedAtEpoch, providerNextUpdateAtEpoch) => {
+        const expiresAt = DateTime.utc().plus({ days: ttlInDays }).toSeconds();
+        const currentTimestamp = getCurrentTimestamp();
+        return {
+            currency,
+            rates,
+            expiresAt,
+            cachedAt: currentTimestamp,
+            cachedAtEpoch: DateTime.utc().toSeconds(),
+            createdAt: currentTimestamp,
+            updatedAt: currentTimestamp,
+            provider,
+            providerLastUpdatedAtEpoch,
+            providerNextUpdateAtEpoch,
+        };
+    };
+    putCurrencyExchangeRate = async (record) => {
+        await DynamoDbClient.safePut(this.TABLE_NAME, record);
+        return record;
+    };
+}
+//# sourceMappingURL=currency-exchange-rates-db-service.js.map

package/dist/esm/services/db/currency-exchange-rates-db-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"currency-exchange-rates-db-service.js","sourceRoot":"","sources":["../../../../src/services/db/currency-exchange-rates-db-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAgBvD,MAAM,OAAO,8BAA8B;IAClC,UAAU,CAAS;IACnB,SAAS,CAAS;IAEzB,YAAY,SAAiB,EAAE,QAAgB;QAC7C,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC5B,CAAC;IAEM,uBAAuB,GAAG,KAAK,EAAE,YAAoB,EAA8C,EAAE;QAC1G,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QAC3F,OAAQ,MAAqC,IAAI,IAAI,CAAC;IACxD,CAAC,CAAA;IAEM,+BAA+B,GAAG,CAAC,QAAgB,EAAE,KAAoB,EAAE,SAAiB,EAAE,QAAiB,EAAE,0BAAmC,EAAE,yBAAkC,EAA8B,EAAE;QAC7N,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC;QACvE,MAAM,gBAAgB,GAAG,mBAAmB,EAAE,CAAC;QAC/C,OAAO;YACL,QAAQ;YACR,KAAK;YACL,SAAS;YACT,QAAQ,EAAE,gBAAgB;YAC1B,aAAa,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE;YACzC,SAAS,EAAE,gBAAgB;YAC3B,SAAS,EAAE,gBAAgB;YAC3B,QAAQ;YACR,0BAA0B;YAC1B,yBAAyB;SAC1B,CAAC;IACJ,CAAC,CAAA;IAEM,uBAAuB,GAAG,KAAK,EAAE,MAAkC,EAAuC,EAAE;QACjH,MAAM,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACtD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAA;CACF"}

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

@@ -6,3 +6,4 @@ export * from './tracking-events-db-service.js';
 export * from './shopify-products-cache-db-service.js';
 export * from './shopify-app-installs-db-service.js';
 export * from './identity-cache-db-service.js';
+export * from './currency-exchange-rates-db-service.js';

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

@@ -6,4 +6,5 @@ export * from './tracking-events-db-service.js';
 export * from './shopify-products-cache-db-service.js';
 export * from './shopify-app-installs-db-service.js';
 export * from './identity-cache-db-service.js';
+export * from './currency-exchange-rates-db-service.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/services/db/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/services/db/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sCAAsC,CAAC;AACrD,cAAc,oCAAoC,CAAC;AACnD,cAAc,iCAAiC,CAAC;AAChD,cAAc,wCAAwC,CAAC;AACvD,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/services/db/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sCAAsC,CAAC;AACrD,cAAc,oCAAoC,CAAC;AACnD,cAAc,iCAAiC,CAAC;AAChD,cAAc,wCAAwC,CAAC;AACvD,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yCAAyC,CAAC"}

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

@@ -1,6 +1,7 @@
 export * from './eventbridge-integration-service.js';
 export * from './ipdata-lookup-service.js';
 export * from './generic-cache-service.js';
+export * from './currency-exchange-rate-lookup-service.js';
 export * from './db';
 export * from './shopify';
 export * from './cache';

package/dist/esm/services/index.js

@@ -1,6 +1,7 @@
 export * from './eventbridge-integration-service.js';
 export * from './ipdata-lookup-service.js';
 export * from './generic-cache-service.js';
+export * from './currency-exchange-rate-lookup-service.js';
 export * from './db';
 export * from './shopify';
 export * from './cache';

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,sCAAsC,CAAC;AACrD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,MAAM,CAAC;AACrB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,sCAAsC,CAAC;AACrD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4CAA4C,CAAC;AAC3D,cAAc,MAAM,CAAC;AACrB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adtrackify/at-service-common",
-  "version": "3.2.26",
+  "version": "3.2.27",
   "description": "",
   "files": [
     "dist/*"