@stigg/node-server-sdk 4.9.0 → 4.11.0

package/dist/services/LegacyEventPayloadMapper.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildUsageUpdatedV1Payload = exports.mapEntitlementsUpdatedV2ToV1 = void 0;
+const lodash_1 = require("lodash");
+function toEpochMs(date) {
+    if ((0, lodash_1.isNil)(date)) {
+        return null;
+    }
+    if (typeof date === 'number') {
+        return date;
+    }
+    return new Date(date).getTime();
+}
+function toIsoString(date) {
+    if ((0, lodash_1.isNil)(date)) {
+        return null;
+    }
+    if (typeof date === 'string') {
+        return date;
+    }
+    return new Date(date).toISOString();
+}
+/**
+ * Maps V2 entitlements payload to V1 format for backward compatibility.
+ * Filters out credit entitlements (only keeps feature entitlements).
+ */
+function mapEntitlementsUpdatedV2ToV1(v2Payload) {
+    // Filter out credit entitlements (only keep feature entitlements)
+    const featureEntitlements = v2Payload.entitlements.filter((e) => e.__typename === 'FeatureEntitlement');
+    // Map FeatureEntitlement to legacy Entitlement type
+    const legacyEntitlements = featureEntitlements.map((fe) => (Object.assign(Object.assign({}, (0, lodash_1.omit)(fe, '__typename')), { __typename: 'Entitlement', customerId: null, resourceId: null, requestedUsage: null, requestedValues: null, nextResetDate: fe.usagePeriodEnd })));
+    return {
+        __typename: 'EntitlementsUpdated',
+        customerId: v2Payload.customerId,
+        resourceId: v2Payload.resourceId,
+        accessDeniedReason: v2Payload.accessDeniedReason,
+        entitlements: legacyEntitlements,
+    };
+}
+exports.mapEntitlementsUpdatedV2ToV1 = mapEntitlementsUpdatedV2ToV1;
+/**
+ * Builds V1 usage updated payload from a cached feature entitlement.
+ * Returns null if the entitlement is not a feature entitlement.
+ */
+function buildUsageUpdatedV1Payload(customerId, resourceId, cachedEntitlement) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p;
+    const { calculatedEntitlement, usageData } = cachedEntitlement;
+    const feature = calculatedEntitlement.feature;
+    const usage = {
+        __typename: 'UsageMeasurementUpdated',
+        customerId,
+        resourceId: resourceId !== null && resourceId !== void 0 ? resourceId : null,
+        featureId: feature.id,
+        currentUsage: usageData.currentUsage,
+        usagePeriodStart: toEpochMs(usageData.usagePeriodStart),
+        usagePeriodEnd: toEpochMs(usageData.usagePeriodEnd),
+        nextResetDate: toEpochMs(usageData.usagePeriodEnd),
+    };
+    const mappedFeature = feature
+        ? {
+            __typename: 'EntitlementFeature',
+            refId: feature.id,
+            displayName: feature.displayName,
+            featureType: feature.featureType,
+            meterType: (_a = feature.meterType) !== null && _a !== void 0 ? _a : null,
+            featureUnits: (_b = feature.units) !== null && _b !== void 0 ? _b : null,
+            featureUnitsPlural: (_c = feature.unitsPlural) !== null && _c !== void 0 ? _c : null,
+            description: (_d = feature.description) !== null && _d !== void 0 ? _d : '',
+            unitTransformation: (_e = feature.unitTransformation) !== null && _e !== void 0 ? _e : null,
+        }
+        : null;
+    const entitlement = {
+        __typename: 'Entitlement',
+        isGranted: !calculatedEntitlement.accessDeniedReason,
+        accessDeniedReason: (_f = calculatedEntitlement.accessDeniedReason) !== null && _f !== void 0 ? _f : null,
+        customerId: null,
+        resourceId: null,
+        usageLimit: (_g = calculatedEntitlement.usageLimit) !== null && _g !== void 0 ? _g : null,
+        hasUnlimitedUsage: calculatedEntitlement.hasUnlimitedUsage,
+        hasSoftLimit: (_h = calculatedEntitlement.hasSoftLimit) !== null && _h !== void 0 ? _h : null,
+        currentUsage: (_j = usageData.currentUsage) !== null && _j !== void 0 ? _j : null,
+        requestedUsage: null,
+        requestedValues: null,
+        enumValues: (_k = calculatedEntitlement.enumValues) !== null && _k !== void 0 ? _k : null,
+        entitlementUpdatedAt: toIsoString(calculatedEntitlement.entitlementUpdatedAt),
+        usageUpdatedAt: toIsoString(usageData.updatedAt),
+        usagePeriodAnchor: toIsoString(calculatedEntitlement.usagePeriodAnchor),
+        usagePeriodStart: toIsoString(usageData.usagePeriodStart),
+        usagePeriodEnd: toIsoString(usageData.usagePeriodEnd),
+        nextResetDate: toIsoString(usageData.usagePeriodEnd),
+        resetPeriod: (_l = calculatedEntitlement.resetPeriod) !== null && _l !== void 0 ? _l : null,
+        validUntil: (_m = calculatedEntitlement.validUntil) !== null && _m !== void 0 ? _m : null,
+        resetPeriodConfiguration: (_o = calculatedEntitlement.resetPeriodConfiguration) !== null && _o !== void 0 ? _o : null,
+        feature: mappedFeature,
+        creditRate: (_p = calculatedEntitlement.creditRate) !== null && _p !== void 0 ? _p : null,
+    };
+    return {
+        __typename: 'UsageUpdated',
+        usage,
+        entitlement,
+    };
+}
+exports.buildUsageUpdatedV1Payload = buildUsageUpdatedV1Payload;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiTGVnYWN5RXZlbnRQYXlsb2FkTWFwcGVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3NlcnZpY2VzL0xlZ2FjeUV2ZW50UGF5bG9hZE1hcHBlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFRQSxtQ0FBcUM7QUFNckMsU0FBUyxTQUFTLENBQUMsSUFBK0M7SUFDaEUsSUFBSSxJQUFBLGNBQUssRUFBQyxJQUFJLENBQUMsRUFBRTtRQUNmLE9BQU8sSUFBSSxDQUFDO0tBQ2I7SUFDRCxJQUFJLE9BQU8sSUFBSSxLQUFLLFFBQVEsRUFBRTtRQUM1QixPQUFPLElBQUksQ0FBQztLQUNiO0lBQ0QsT0FBTyxJQUFJLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQyxPQUFPLEVBQUUsQ0FBQztBQUNsQyxDQUFDO0FBRUQsU0FBUyxXQUFXLENBQUMsSUFBK0M7SUFDbEUsSUFBSSxJQUFBLGNBQUssRUFBQyxJQUFJLENBQUMsRUFBRTtRQUNmLE9BQU8sSUFBSSxDQUFDO0tBQ2I7SUFDRCxJQUFJLE9BQU8sSUFBSSxLQUFLLFFBQVEsRUFBRTtRQUM1QixPQUFPLElBQUksQ0FBQztLQUNiO0lBQ0QsT0FBTyxJQUFJLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQyxXQUFXLEVBQUUsQ0FBQztBQUN0QyxDQUFDO0FBRUQ7OztHQUdHO0FBQ0gsU0FBZ0IsNEJBQTRCLENBQzFDLFNBQXVDO0lBRXZDLGtFQUFrRTtJQUNsRSxNQUFNLG1CQUFtQixHQUFHLFNBQVMsQ0FBQyxZQUFZLENBQUMsTUFBTSxDQUN2RCxDQUFDLENBQUMsRUFBMEUsRUFBRSxDQUM1RSxDQUFDLENBQUMsVUFBVSxLQUFLLG9CQUFvQixDQUN4QyxDQUFDO0lBRUYsb0RBQW9EO0lBQ3BELE1BQU0sa0JBQWtCLEdBQStELG1CQUFtQixDQUFDLEdBQUcsQ0FDNUcsQ0FBQyxFQUFFLEVBQUUsRUFBRSxDQUFDLGlDQUNILElBQUEsYUFBSSxFQUFDLEVBQUUsRUFBRSxZQUFZLENB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

package/dist/services/cache/cacheService.d.ts

@@ -1,15 +1,12 @@
-import CachedEntitlement from './cachedEntitlement';
-import { OptionalPromise } from '../../types';
+import { CachedEntitlement, EntitlementQuery, EntitlementType, EntitlementsMap, UsageData } from './entities';
+import { Maybe, OptionalPromise } from '../../types';
 import { EntitlementResponse, EntitlementsResponse } from '../entitlementsService.utils';
 import { AccessDeniedReason } from '../../models';
-export type UpdateFeatureUsagePayload = {
+export type UpdateUsagePayload<T extends EntitlementType = EntitlementType> = {
     customerId: string;
-    featureId: string;
-    currentUsage: number;
-    timestamp: Date;
-    resourceId: string | undefined;
-    usagePeriodStart?: number;
-    usagePeriodEnd?: number;
+    resourceId: Maybe<string>;
+    entitlementReference: EntitlementQuery<T>;
+    usage: UsageData;
 };
 export type UpdateCreditBalancePayload = {
     timestamp: Date;
@@ -24,8 +21,8 @@ export type UpdateCreditBalancePayload = {
 export interface CacheService {
     waitForInitialization(): Promise<void>;
     clearCache(): OptionalPromise<void>;
-    setCustomer(customerId: string, customerEntitlements: Map<string, CachedEntitlement>, accessDeniedReason: AccessDeniedReason | null, resourceId: string | undefined, entitlementsTimestamp: number, usageTimestamp: Map<string, number>): void | Promise<void>;
-    updateFeatureUsage(payload: UpdateFeatureUsagePayload): OptionalPromise<boolean>;
+    setCustomer(customerId: string, customerEntitlements: EntitlementsMap, accessDeniedReason: AccessDeniedReason | null, resourceId: string | undefined, entitlementsTimestamp: number): void | Promise<void>;
+    updateUsage<T extends EntitlementType>(payload: UpdateUsagePayload<T>): OptionalPromise<CachedEntitlement<T> | null>;
     getCustomerEntitlements(customerId: string, resourceId: string | undefined): OptionalPromise<EntitlementsResponse>;
-    getCustomerEntitlement(featureId: string, customerId: string, resourceId: string | undefined): OptionalPromise<EntitlementResponse>;
+    getCustomerEntitlement<T extends EntitlementType>(query: EntitlementQuery<T>, customerId: string, resourceId: string | undefined): OptionalPromise<EntitlementResponse<T>>;
 }

package/dist/services/cache/entities/cachedEntitlement.d.ts

@@ -0,0 +1,17 @@
+import { EntitlementType } from '@stigg/api-client-js/src/generated/sdk';
+import { CalculatedCreditEntitlement, CalculatedEntitlement, CalculatedFeatureEntitlement } from './calculatedEntitlement';
+import { UsageData } from './usageData';
+/** internal helper type - maps EntitlementType to the corresponding CalculatedEntitlement type */
+type CalculatedEntitlementByType<T extends EntitlementType> = T extends EntitlementType.Feature ? CalculatedFeatureEntitlement : T extends EntitlementType.Credit ? CalculatedCreditEntitlement : CalculatedEntitlement;
+export declare class CachedEntitlement<T extends EntitlementType = EntitlementType> {
+    readonly calculatedEntitlement: CalculatedEntitlementByType<T>;
+    readonly usageData: UsageData;
+    constructor(calculatedEntitlement: CalculatedEntitlementByType<T>, usageData: UsageData);
+}
+/** Type guard to check if a cached entitlement is a feature entitlement */
+export declare function isFeatureEntitlement(entitlement: CachedEntitlement): entitlement is CachedEntitlement<EntitlementType.Feature>;
+/** Type guard to check if a cached entitlement is a metered feature entitlement */
+export declare function isMeteredFeatureEntitlement(entitlement: CachedEntitlement): entitlement is CachedEntitlement<EntitlementType.Feature>;
+/** Type guard to check if a cached entitlement is a credit entitlement */
+export declare function isCreditEntitlement(entitlement: CachedEntitlement): entitlement is CachedEntitlement<EntitlementType.Credit>;
+export {};

package/dist/services/cache/entities/cachedEntitlement.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isCreditEntitlement = exports.isMeteredFeatureEntitlement = exports.isFeatureEntitlement = exports.CachedEntitlement = void 0;
+const sdk_1 = require("@stigg/api-client-js/src/generated/sdk");
+const featureTypes_1 = require("../../../utils/featureTypes");
+class CachedEntitlement {
+    constructor(calculatedEntitlement, usageData) {
+        this.calculatedEntitlement = calculatedEntitlement;
+        this.usageData = usageData;
+    }
+}
+exports.CachedEntitlement = CachedEntitlement;
+/** Type guard to check if a cached entitlement is a feature entitlement */
+function isFeatureEntitlement(entitlement) {
+    return entitlement.calculatedEntitlement.type === sdk_1.EntitlementType.Feature;
+}
+exports.isFeatureEntitlement = isFeatureEntitlement;
+/** Type guard to check if a cached entitlement is a metered feature entitlement */
+function isMeteredFeatureEntitlement(entitlement) {
+    return isFeatureEntitlement(entitlement) && (0, featureTypes_1.isMetered)(entitlement.calculatedEntitlement.feature);
+}
+exports.isMeteredFeatureEntitlement = isMeteredFeatureEntitlement;
+/** Type guard to check if a cached entitlement is a credit entitlement */
+function isCreditEntitlement(entitlement) {
+    return entitlement.calculatedEntitlement.type === sdk_1.EntitlementType.Credit;
+}
+exports.isCreditEntitlement = isCreditEntitlement;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2FjaGVkRW50aXRsZW1lbnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvc2VydmljZXMvY2FjaGUvZW50aXRpZXMvY2FjaGVkRW50aXRsZW1lbnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQUEsZ0VBQXlFO0FBT3pFLDhEQUF3RDtBQVN4RCxNQUFhLGlCQUFpQjtJQUk1QixZQUFZLHFCQUFxRCxFQUFFLFNBQW9CO1FBQ3JGLElBQUksQ0FBQyxxQkFBcUIsR0FBRyxxQkFBcUIsQ0FBQztRQUNuRCxJQUFJLENBQUMsU0FBUyxHQUFHLFNBQVMsQ0FBQztJQUM3QixDQUFDO0NBQ0Y7QUFSRCw4Q0FRQztBQUVELDJFQUEyRTtBQUMzRSxTQUFnQixvQkFBb0IsQ0FDbEMsV0FBOEI7SUFFOUIsT0FBTyxXQUFXLENBQUMscUJBQXFCLENBQUMsSUFBSSxLQUFLLHFCQUFlLENBQUMsT0FBTyxDQUFDO0FBQzVFLENBQUM7QUFKRCxvREFJQztBQUVELG1GQUFtRjtBQUNuRixTQUFnQiwyQkFBMkIsQ0FDekMsV0FBOEI7SUFFOUIsT0FBTyxvQkFBb0IsQ0FBQyxXQUFXLENBQUMsSUFBSSxJQUFBLHdCQUFTLEVBQUMsV0FBVyxDQUFDLHFCQUFxQixDQUFDLE9BQU8sQ0FBQyxDQUFDO0FBQ25HLENBQUM7QUFKRCxrRUFJQztBQUVELDBFQUEwRTtBQUMxRSxTQUFnQixtQkFBbUIsQ0FDakMsV0FBOEI7SUFFOUIsT0FBTyxXQUFXLENBQUMscUJBQXFCLENBQUMsSUFBSSxLQUFLLHFCQUFlLENBQUMsTUFBTSxDQUFDO0FBQzNFLENBQUM7QUFKRCxrREFJQyJ9

package/dist/services/cache/entities/calculatedEntitlement.d.ts

@@ -0,0 +1,33 @@
+import { AccessDeniedReason, EntitlementFeature, EntitlementResetPeriod } from '../../../models';
+import { EntitlementType, ResetPeriodConfigurationFragment } from '@stigg/api-client-js/src/generated/sdk';
+import { Maybe } from '../../../types';
+interface BaseCalculatedEntitlement {
+    type: EntitlementType;
+    accessDeniedReason?: AccessDeniedReason;
+    validUntil?: number;
+    entitlementUpdatedAt: Maybe<number>;
+}
+export interface CalculatedFeatureEntitlement extends BaseCalculatedEntitlement {
+    type: EntitlementType.Feature;
+    feature: EntitlementFeature;
+    usageLimit: Maybe<number | null>;
+    enumValues: Maybe<string[]>;
+    hasUnlimitedUsage: boolean;
+    hasSoftLimit: boolean;
+    usagePeriodAnchor: Maybe<number>;
+    resetPeriod: Maybe<EntitlementResetPeriod | null>;
+    resetPeriodConfiguration?: ResetPeriodConfigurationFragment | null;
+    creditRate: Maybe<{
+        amount: number;
+        currencyId: string;
+    }>;
+}
+export interface CalculatedCreditEntitlement extends BaseCalculatedEntitlement {
+    type: EntitlementType.Credit;
+    currency: {
+        currencyId: string;
+    };
+    usageLimit: number;
+}
+export type CalculatedEntitlement = CalculatedFeatureEntitlement | CalculatedCreditEntitlement;
+export {};

package/dist/services/cache/entities/calculatedEntitlement.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2FsY3VsYXRlZEVudGl0bGVtZW50LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL3NlcnZpY2VzL2NhY2hlL2VudGl0aWVzL2NhbGN1bGF0ZWRFbnRpdGxlbWVudC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIn0=

package/dist/services/cache/entities/entitlementQuery.d.ts

@@ -0,0 +1,8 @@
+import { EntitlementType } from '@stigg/api-client-js/src/generated/sdk';
+/** Query to look up an entitlement by type and id */
+export type EntitlementQuery<T extends EntitlementType = EntitlementType> = {
+    /** The entitlement type */
+    type: T;
+    /** The unique identifier of the entitlement type */
+    id: string;
+};

package/dist/services/cache/entities/entitlementQuery.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZW50aXRsZW1lbnRRdWVyeS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9zZXJ2aWNlcy9jYWNoZS9lbnRpdGllcy9lbnRpdGxlbWVudFF1ZXJ5LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiIifQ==

package/dist/services/cache/entities/entitlementsMap.d.ts

@@ -0,0 +1,22 @@
+import { CachedEntitlement } from './cachedEntitlement';
+import { EntitlementType } from '@stigg/api-client-js/src/generated/sdk';
+import { EntitlementQuery } from './entitlementQuery';
+import { UsageData } from './usageData';
+/**
+ * Type-safe wrapper around Map<string, CachedEntitlement> that encapsulates key building.
+ * Prevents errors from manual string key lookups.
+ */
+export declare class EntitlementsMap {
+    private readonly map;
+    constructor(entries?: Iterable<CachedEntitlement>);
+    private buildKey;
+    private getKeyFromEntitlement;
+    get<T extends EntitlementType>(query: EntitlementQuery<T>): CachedEntitlement<T> | undefined;
+    set(entitlement: CachedEntitlement): this;
+    get size(): number;
+    values(): CachedEntitlement[];
+    /** Updates usage data for an entitlement. Returns the updated entitlement or null if not found. */
+    updateUsage<T extends EntitlementType>(entitlementReference: EntitlementQuery<T>, usageData: UsageData): CachedEntitlement<T> | null;
+    toJSON(): Record<string, CachedEntitlement>;
+    static fromJSON(obj: Record<string, unknown>): EntitlementsMap;
+}

package/dist/services/cache/entities/entitlementsMap.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntitlementsMap = void 0;
+const cachedEntitlement_1 = require("./cachedEntitlement");
+const sdk_1 = require("@stigg/api-client-js/src/generated/sdk");
+/**
+ * Type-safe wrapper around Map<string, CachedEntitlement> that encapsulates key building.
+ * Prevents errors from manual string key lookups.
+ */
+class EntitlementsMap {
+    constructor(entries) {
+        this.map = new Map();
+        if (entries) {
+            for (const entitlement of entries) {
+                this.set(entitlement);
+            }
+        }
+    }
+    // Feature entitlements use raw ID for backward compatibility with existing cache data
+    // Credit entitlements use prefix since they're new and need to be distinguishable
+    buildKey(query) {
+        if (query.type === sdk_1.EntitlementType.Feature) {
+            return query.id;
+        }
+        return `${query.type}:${query.id}`;
+    }
+    getKeyFromEntitlement(entitlement) {
+        const { type } = entitlement.calculatedEntitlement;
+        switch (type) {
+            case sdk_1.EntitlementType.Feature:
+                return this.buildKey({
+                    type,
+                    id: entitlement.calculatedEntitlement.feature.id,
+                });
+            case sdk_1.EntitlementType.Credit:
+                return this.buildKey({
+                    type,
+                    id: entitlement.calculatedEntitlement.currency.currencyId,
+                });
+            default:
+                return '';
+        }
+    }
+    get(query) {
+        return this.map.get(this.buildKey(query));
+    }
+    set(entitlement) {
+        const key = this.getKeyFromEntitlement(entitlement);
+        this.map.set(key, entitlement);
+        return this;
+    }
+    get size() {
+        return this.map.size;
+    }
+    values() {
+        return Array.from(this.map.values());
+    }
+    /** Updates usage data for an entitlement. Returns the updated entitlement or null if not found. */
+    updateUsage(entitlementReference, usageData) {
+        const existingEntitlement = this.get(entitlementReference);
+        if (!existingEntitlement) {
+            return null;
+        }
+        const updatedEntitlement = new cachedEntitlement_1.CachedEntitlement(existingEntitlement.calculatedEntitlement, usageData);
+        this.set(updatedEntitlement);
+        return updatedEntitlement;
+    }
+    // For serialization (Redis)
+    toJSON() {
+        return Object.fromEntries(this.map);
+    }
+    // For deserialization (Redis)
+    static fromJSON(obj) {
+        const map = new EntitlementsMap();
+        for (const [key, value] of Object.entries(obj)) {
+            map.map.set(key, value);
+        }
+        return map;
+    }
+}
+exports.EntitlementsMap = EntitlementsMap;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZW50aXRsZW1lbnRzTWFwLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL3NlcnZpY2VzL2NhY2hlL2VudGl0aWVzL2VudGl0bGVtZW50c01hcC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQSwyREFBd0Q7QUFDeEQsZ0VBQXlFO0FBSXpFOzs7R0FHRztBQUNILE1BQWEsZUFBZTtJQUcxQixZQUFZLE9BQXFDO1FBQy9DLElBQUksQ0FBQyxHQUFHLEdBQUcsSUFBSSxHQUFHLEVBQUUsQ0FBQztRQUNyQixJQUFJLE9BQU8sRUFBRTtZQUNYLEtBQUssTUFBTSxXQUFXLElBQUksT0FBTyxFQUFFO2dCQUNqQyxJQUFJLENBQUMsR0FBRyxDQUFDLFdBQVcsQ0FBQyxDQUFDO2FBQ3ZCO1NBQ0Y7SUFDSCxDQUFDO0lBRUQsc0ZBQXNGO0lBQ3RGLGtGQUFrRjtJQUMxRSxRQUFRLENBQUMsS0FBdUI7UUFDdEMsSUFBSSxLQUFLLENBQUMsSUFBSSxLQUFLLHFCQUFlLENBQUMsT0FBTyxFQUFFO1lBQzFDLE9BQU8sS0FBSyxDQUFDLEVBQUUsQ0FBQztTQUNqQjtRQUNELE9BQU8sR0FBRyxLQUFLLENBQUMsSUFBSSxJQUFJLEtBQUssQ0FBQyxFQUFFLEVBQUUsQ0FBQztJQUNyQyxDQUFDO0lBRU8scUJBQXFCLENBQUMsV0FBOEI7UUFDMUQsTUFBTSxFQUFFLElBQUksRUFBRSxHQUFHLFdBQVcsQ0FBQyxxQkFBcUIsQ0FBQztRQUNuRCxRQUFRLElBQUksRUFBRTtZQUNaLEtBQUsscUJBQWUsQ0FBQyxPQUFPO2dCQUMxQixPQUFPLElBQUksQ0FBQyxRQUFRLENBQUM7b0JBQ25CLElBQUk7b0JBQ0osRUFBRSxFQUFFLFdBQVcsQ0FBQyxxQkFBcUIsQ0FBQyxPQUFPLENBQUMsRUFBRTtpQkFDakQsQ0FBQyxDQUFDO1lBQ0wsS0FBSyxxQkFBZSxDQUFDLE1BQU07Z0JBQ3pCLE9BQU8sSUFBSSxDQUFDLFFBQVEsQ0FBQztvQkFDbkIsSUFBSTtvQkFDSixFQUFFLEVBQUUsV0FBVyxDQUFDLHFCQUFxQixDQUFDLFFBQVEsQ0FBQyxVQUFVO2lCQUMxRCxDQUFDLENBQUM7WUFDTDtnQkFDRSxPQUFPLEVBQUUsQ0FBQztTQUNiO0lBQ0gsQ0FBQztJQUVELEdBQUcsQ0FBNEIsS0FBMEI7UUFDdkQsT0FBTyxJQUFJLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxJQUFJLENBQUMsUUFBUSxDQUFDLEtBQUssQ0FBQyxDQUFxQyxDQUFDO0lBQ2hGLENBQUM7SUFFRCxHQUFHLENBQUMsV0FBOEI7UUFDaEMsTUFBTSxHQUFHLEdBQUcsSUFBSSxDQUFDLHFCQUFxQixDQUFDLFdBQVcsQ0FBQyxDQUFDO1FBQ3BELElBQUksQ0FBQyxHQUFHLENBQUMsR0FBRyxDQUFDLEdBQUcsRUFBRSxXQUFXLENBQUMsQ0FBQztRQUMvQixPQUFPLElBQUksQ0FBQztJQUNkLENBQUM7SUFFRCxJQUFJLElBQUk7UUFDTixPQUFPLElBQUksQ0FBQyxHQUFHLENBQUMsSUFBSSxDQUFDO0lBQ3ZCLENBQUM7SUFFRCxNQUFNO1FBQ0osT0FBTyxLQUFLLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsTUFBTSxFQUFFLENBQUMsQ0FBQztJQUN2QyxDQUFDO0lBRUQsbUdBQW1HO0lBQ25HLFdBQVcsQ0FDVCxvQkFBeUMsRUFDekMsU0FBb0I7UUFFcEIsTUFBTSxtQkFBbUIsR0FBRyxJQUFJLENBQUMsR0FBRyxDQUFDLG9CQUFvQixDQUFDLENBQUM7UUFDM0QsSUFBSSxDQUFDLG1CQUFtQixFQUFFO1lBQ3hCLE9BQU8sSUFBSSxDQUFDO1NBQ2I7UUFFRCxNQUFNLGtCQUFrQixHQUFHLElBQUkscUNBQWlCLENBQUMsbUJBQW1CLENBQUMscUJBQXFCLEVBQUUsU0FBUyxDQUFDLENBQUM7UUFDdkcsSUFBSSxDQUFDLEdBQUcsQ0FBQyxrQkFBa0IsQ0FBQyxDQUFDO1FBQzdCLE9BQU8sa0JBQWtCLENBQUM7SUFDNUIsQ0FBQztJQUVELDRCQUE0QjtJQUM1QixNQUFNO1FBQ0osT0FBTyxNQUFNLENBQUMsV0FBVyxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsQ0FBQztJQUN0QyxDQUFDO0lBRUQsOEJBQThCO0lBQzlCLE1BQU0sQ0FBQyxRQUFRLENBQUMsR0FBNEI7UUFDMUMsTUFBTSxHQUFHLEdBQUcsSUFBSSxlQUFlLEVBQUUsQ0FBQztRQUNsQyxLQUFLLE1BQU0sQ0FBQyxHQUFHLEVBQUUsS0FBSyxDQUFDLElBQUksTUFBTSxDQUFDLE9BQU8sQ0FBQyxHQUFHLENBQUMsRUFBRTtZQUM5QyxHQUFHLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxHQUFHLEVBQUUsS0FBMEIsQ0FBQyxDQUFDO1NBQzlDO1FBQ0QsT0FBTyxHQUFHLENBQUM7SUFDYixDQUFDO0NBQ0Y7QUFyRkQsMENBcUZDIn0=

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

@@ -0,0 +1,6 @@
+export { EntitlementType } from '@stigg/api-client-js/src/generated/sdk';
+export { EntitlementQuery } from './entitlementQuery';
+export { CalculatedEntitlement, CalculatedFeatureEntitlement, CalculatedCreditEntitlement, } from './calculatedEntitlement';
+export { UsageData } from './usageData';
+export { CachedEntitlement, isFeatureEntitlement, isMeteredFeatureEntitlement, isCreditEntitlement, } from './cachedEntitlement';
+export { EntitlementsMap } from './entitlementsMap';

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

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntitlementsMap = exports.isCreditEntitlement = exports.isMeteredFeatureEntitlement = exports.isFeatureEntitlement = exports.CachedEntitlement = exports.EntitlementType = void 0;
+var sdk_1 = require("@stigg/api-client-js/src/generated/sdk");
+Object.defineProperty(exports, "EntitlementType", { enumerable: true, get: function () { return sdk_1.EntitlementType; } });
+var cachedEntitlement_1 = require("./cachedEntitlement");
+Object.defineProperty(exports, "CachedEntitlement", { enumerable: true, get: function () { return cachedEntitlement_1.CachedEntitlement; } });
+Object.defineProperty(exports, "isFeatureEntitlement", { enumerable: true, get: function () { return cachedEntitlement_1.isFeatureEntitlement; } });
+Object.defineProperty(exports, "isMeteredFeatureEntitlement", { enumerable: true, get: function () { return cachedEntitlement_1.isMeteredFeatureEntitlement; } });
+Object.defineProperty(exports, "isCreditEntitlement", { enumerable: true, get: function () { return cachedEntitlement_1.isCreditEntitlement; } });
+var entitlementsMap_1 = require("./entitlementsMap");
+Object.defineProperty(exports, "EntitlementsMap", { enumerable: true, get: function () { return entitlementsMap_1.EntitlementsMap; } });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvc2VydmljZXMvY2FjaGUvZW50aXRpZXMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQUEsOERBQXlFO0FBQWhFLHNHQUFBLGVBQWUsT0FBQTtBQVF4Qix5REFLNkI7QUFKM0Isc0hBQUEsaUJBQWlCLE9BQUE7QUFDakIseUhBQUEsb0JBQW9CLE9BQUE7QUFDcEIsZ0lBQUEsMkJBQTJCLE9BQUE7QUFDM0Isd0hBQUEsbUJBQW1CLE9BQUE7QUFFckIscURBQW9EO0FBQTNDLGtIQUFBLGVBQWUsT0FBQSJ9

package/dist/services/cache/entities/usageData.d.ts

@@ -0,0 +1,7 @@
+import { Maybe } from '../../../types';
+export interface UsageData {
+    currentUsage: number;
+    usagePeriodStart: Maybe<number>;
+    usagePeriodEnd: Maybe<number>;
+    updatedAt: number;
+}

package/dist/services/cache/entities/usageData.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXNhZ2VEYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL3NlcnZpY2VzL2NhY2hlL2VudGl0aWVzL3VzYWdlRGF0YS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIn0=

package/dist/services/cache/inMemoryCacheService.d.ts

@@ -1,11 +1,11 @@
-import { CacheService, UpdateCreditBalancePayload, UpdateFeatureUsagePayload } from './cacheService';
-import CachedEntitlement from './cachedEntitlement';
+import { CacheService, UpdateCreditBalancePayload, UpdateUsagePayload } from './cacheService';
+import { CachedEntitlement, EntitlementQuery, EntitlementType, EntitlementsMap } from './entities';
 import { EntitlementResponse, EntitlementsResponse } from '../entitlementsService.utils';
 import { CacheInstrumentation } from '../cacheInstrumentation';
 import { AccessDeniedReason } from '../../models';
 export declare function getApproxSizeBytes(obj: any): number;
 export type CachedCustomerEntitlements = {
-    entitlements: Map<string, CachedEntitlement>;
+    entitlements: EntitlementsMap;
     accessDeniedReason: AccessDeniedReason | null;
 };
 export declare class InMemoryCacheService implements CacheService {
@@ -14,10 +14,10 @@ export declare class InMemoryCacheService implements CacheService {
     constructor(maxSizeBytes: number, instrumentation: CacheInstrumentation);
     waitForInitialization(): Promise<void>;
     clearCache: () => void;
-    setCustomer(customerId: string, customerEntitlements: Map<string, CachedEntitlement>, accessDeniedReason: AccessDeniedReason | null, resourceId: string | undefined): void;
+    setCustomer(customerId: string, customerEntitlements: EntitlementsMap, accessDeniedReason: AccessDeniedReason | null, resourceId: string | undefined): void;
     clearCustomer(customerId: string, resourceId: string | undefined): void;
     getCustomerEntitlements(customerId: string, resourceId: string | undefined): EntitlementsResponse;
-    updateFeatureUsage({ customerId, featureId, currentUsage, resourceId, usagePeriodStart, usagePeriodEnd, }: UpdateFeatureUsagePayload): boolean | Promise<boolean>;
-    getCustomerEntitlement(featureId: string, customerId: string, resourceId: string | undefined): EntitlementResponse;
+    updateUsage<T extends EntitlementType>({ customerId, resourceId, entitlementReference, usage, }: UpdateUsagePayload<T>): CachedEntitlement<T> | null;
+    getCustomerEntitlement<T extends EntitlementType>(query: EntitlementQuery<T>, customerId: string, resourceId: string | undefined): EntitlementResponse<T>;
     updateEntitlementsBasedOnCreditBalanceUpdate({ customerId, resourceId, currencyId, currentBalance, validUntil, }: UpdateCreditBalancePayload): void;
 }

package/dist/services/cache/inMemoryCacheService.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InMemoryCacheService = exports.getApproxSizeBytes = void 0;
+const entities_1 = require("./entities");
 const cacheKeysHelpers_1 = require("../../utils/cacheKeysHelpers");
 const lru_cache_1 = require("lru-cache");
 const entitlementsService_utils_1 = require("../entitlementsService.utils");
@@ -47,25 +48,18 @@ class InMemoryCacheService {
             return entitlementsService_utils_1.entitlementsResponseMapper.cacheMiss();
         }
     }
-    updateFeatureUsage({ customerId, featureId, currentUsage, resourceId, usagePeriodStart, usagePeriodEnd, }) {
+    updateUsage({ customerId, resourceId, entitlementReference, usage, }) {
         var _a;
         const cachedCustomerKey = (0, cacheKeysHelpers_1.buildCachedCustomerKey)(customerId, resourceId);
         const customerEntitlements = (_a = this.entitlements.get(cachedCustomerKey)) === null || _a === void 0 ? void 0 : _a.entitlements;
-        const existingFeatureEntitlement = customerEntitlements === null || customerEntitlements === void 0 ? void 0 : customerEntitlements.get(featureId);
-        if (!customerEntitlements || !existingFeatureEntitlement) {
-            // do nothing in this case, we've never checked this for customer entitlements yet
-            return false;
+        if (!customerEntitlements) {
+            return null;
         }
-        const { featureUsage: existingFeatureUsage, calculatedEntitlement } = existingFeatureEntitlement;
-        customerEntitlements.set(featureId, {
-            calculatedEntitlement,
-            featureUsage: Object.assign(Object.assign({}, existingFeatureUsage), { currentUsage, usagePeriodStart, usagePeriodEnd }),
-        });
-        return true;
+        return customerEntitlements.updateUsage(entitlementReference, usage);
     }
-    getCustomerEntitlement(featureId, customerId, resourceId) {
+    getCustomerEntitlement(query, customerId, resourceId) {
         const { entitlements, accessDeniedReason, cacheMiss, globalCustomerMissing } = this.getCustomerEntitlements(customerId, resourceId);
-        const entitlement = !cacheMiss ? (entitlements === null || entitlements === void 0 ? void 0 : entitlements.get(featureId)) || null : null;
+        const entitlement = !cacheMiss ? (entitlements === null || entitlements === void 0 ? void 0 : entitlements.get(query)) || null : null;
         return { cacheMiss, accessDeniedReason, entitlement, globalCustomerMissing };
     }
     updateEntitlementsBasedOnCreditBalanceUpdate({ customerId, resourceId, currencyId, currentBalance, validUntil, }) {
@@ -77,29 +71,26 @@ class InMemoryCacheService {
         }
         const isExceeded = currentBalance <= 0;
         // Update entitlements that have credit rates matching this currency
-        customerEntitlements.forEach((cachedEntitlement, featureId) => {
-            var _a;
-            const { calculatedEntitlement, featureUsage } = cachedEntitlement;
-            const entitlementCurrencyId = (_a = calculatedEntitlement.creditRate) === null || _a === void 0 ? void 0 : _a.currencyId;
-            if (entitlementCurrencyId === currencyId) {
-                const updatedCalculatedEntitlement = Object.assign(Object.assign({}, calculatedEntitlement), { validUntil });
-                if (isExceeded) {
-                    if (!calculatedEntitlement.accessDeniedReason) {
-                        updatedCalculatedEntitlement.accessDeniedReason = models_1.AccessDeniedReason.InsufficientCredits;
-                    }
+        customerEntitlements
+            .values()
+            .filter(entities_1.isFeatureEntitlement)
+            .filter((entitlement) => { var _a; return ((_a = entitlement.calculatedEntitlement.creditRate) === null || _a === void 0 ? void 0 : _a.currencyId) === currencyId; })
+            .forEach((entitlement) => {
+            const { calculatedEntitlement, usageData } = entitlement;
+            const updatedCalculatedEntitlement = Object.assign(Object.assign({}, calculatedEntitlement), { validUntil });
+            if (isExceeded) {
+                if (!calculatedEntitlement.accessDeniedReason) {
+                    updatedCalculatedEntitlement.accessDeniedReason = models_1.AccessDeniedReason.InsufficientCredits;
                 }
-                else {
-                    if (calculatedEntitlement.accessDeniedReason === models_1.AccessDeniedReason.InsufficientCredits) {
-                        updatedCalculatedEntitlement.accessDeniedReason = undefined;
-                    }
+            }
+            else {
+                if (calculatedEntitlement.accessDeniedReason === models_1.AccessDeniedReason.InsufficientCredits) {
+                    updatedCalculatedEntitlement.accessDeniedReason = undefined;
                 }
-                customerEntitlements.set(featureId, {
-                    calculatedEntitlement: updatedCalculatedEntitlement,
-                    featureUsage,
-                });
             }
+            customerEntitlements.set(new entities_1.CachedEntitlement(updatedCalculatedEntitlement, usageData));
         });
     }
 }
 exports.InMemoryCacheService = InMemoryCacheService;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5NZW1vcnlDYWNoZVNlcnZpY2UuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvc2VydmljZXMvY2FjaGUvaW5NZW1vcnlDYWNoZVNlcnZpY2UudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBRUEsbUVBQXNFO0FBQ3RFLHlDQUFxQztBQUNyQyw0RUFBcUg7QUFFckgseUNBQWtEO0FBRWxELE1BQU0sV0FBVyxHQUFHLElBQUksV0FBVyxFQUFFLENBQUM7QUFFdEMsU0FBZ0Isa0JBQWtCLENBQUMsR0FBUTtJQUN6QyxPQUFPLFdBQVcsQ0FBQyxNQUFNLENBQUMsT0FBTyxHQUFHLEtBQUssUUFBUSxDQUFDLENBQUMsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQyxTQUFTLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQyxNQUFNLENBQUM7QUFDeEYsQ0FBQztBQUZELGdEQUVDO0FBT0QsTUFBYSxvQkFBb0I7SUFHL0IsWUFBWSxZQUFvQixFQUFtQixlQUFxQztRQUFyQyxvQkFBZSxHQUFmLGVBQWUsQ0FBc0I7UUFZeEYsZUFBVSxHQUFHLEdBQUcsRUFBRTtZQUNoQixJQUFJLENBQUMsWUFBWSxDQUFDLEtBQUssRUFBRSxDQUFDO1FBQzVCLENBQUMsQ0FBQztRQWJBLE1BQU0sT0FBTyxHQUFHLFlBQVksQ0FBQztRQUM3QixJQUFJLENBQUMsWUFBWSxHQUFHLElBQUksb0JBQVEsQ0FBcUM7WUFDbkUsT0FBTztZQUNQLGVBQWUsRUFBRSxDQUFDLEtBQUssRUFBRSxFQUFFLENBQUMsa0JBQWtCLENBQUMsS0FBSyxDQUFDO1NBQ3RELENBQUMsQ0FBQztJQUNMLENBQUM7SUFFRCxxQkFBcUI7UUFDbkIsT0FBTyxPQUFPLENBQUMsT0FBTyxFQUFFLENBQUM7SUFDM0IsQ0FBQztJQU1ELFdBQVcsQ0FDVCxVQUFrQixFQUNsQixvQkFBb0QsRUFDcEQsa0JBQTZDLEVBQzdDLFVBQThCO1FBRTlCLE1BQU0saUJBQWlCLEdB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
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5NZW1vcnlDYWNoZVNlcnZpY2UuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvc2VydmljZXMvY2FjaGUvaW5NZW1vcnlDYWNoZVNlcnZpY2UudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQ0EseUNBTW9CO0FBQ3BCLG1FQUFzRTtBQUN0RSx5Q0FBcUM7QUFDckMsNEVBQXFIO0FBRXJILHlDQUFrRDtBQUVsRCxNQUFNLFdBQVcsR0FBRyxJQUFJLFdBQVcsRUFBRSxDQUFDO0FBRXRDLFNBQWdCLGtCQUFrQixDQUFDLEdBQVE7SUFDekMsT0FBTyxXQUFXLENBQUMsTUFBTSxDQUFDLE9BQU8sR0FBRyxLQUFLLFFBQVEsQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQyxJQUFJLENBQUMsU0FBUyxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsTUFBTSxDQUFDO0FBQ3hGLENBQUM7QUFGRCxnREFFQztBQU9ELE1BQWEsb0JBQW9CO0lBRy9CLFlBQVksWUFBb0IsRUFBbUIsZUFBcUM7UUFBckMsb0JBQWUsR0FBZixlQUFlLENBQXNCO1FBWXhGLGVBQVUsR0FBRyxHQUFHLEVBQUU7WUFDaEIsSUFBSSxDQUFDLFlBQVksQ0FBQyxLQUFLLEVBQUUsQ0FBQztRQUM1QixDQUFDLENBQUM7UUFiQSxNQUFNLE9BQU8sR0FBRyxZQUFZLENBQUM7UUFDN0IsSUFBSSxDQUFDLFlBQVksR0FBRyxJQUFJLG9CQUFRLENBQXFDO1lBQ25FLE9BQU87WUFDUCxlQUFlLEVBQUUsQ0FBQyxLQUFLLEVBQUUsRUFBRSxDQUFDLGtCQUFrQixDQUFDLEtBQUssQ0FBQztTQUN0RCxDQUFDLENBQUM7SUFDTCxDQUFDO0lBRUQscUJBQXFCO1FBQ25CLE9BQU8sT0FBTyxDQUFDLE9BQU8sRUFBRSxDQUFDO0lBQzNCLENBQUM7SUFNRCxXQUFXLENBQ1QsVUFBa0IsRUFDbEIsb0JBQXFDLEVBQ3JDLGtCQUE2QyxFQUM3QyxVQUE4QjtRQUU5QixN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

package/dist/services/cache/redisCacheService.d.ts

@@ -1,5 +1,5 @@
-import { CacheService, UpdateFeatureUsagePayload } from './cacheService';
-import CachedEntitlement from './cachedEntitlement';
+import { CacheService, UpdateUsagePayload } from './cacheService';
+import { CachedEntitlement, EntitlementType, EntitlementQuery, EntitlementsMap } from './entities';
 import { LoggerService } from '../loggerService';
 import { ClientConfiguration } from '../../configuration';
 import { RedisSingleExecutionService } from './RedisSingleExecutionService';
@@ -22,9 +22,9 @@ export declare class RedisCacheService implements CacheService {
      */
     waitForInitialization(): Promise<void>;
     isClientConnected(): boolean;
-    updateFeatureUsage(params: UpdateFeatureUsagePayload): Promise<boolean>;
+    updateUsage<T extends EntitlementType>({ customerId, resourceId, entitlementReference, usage, }: UpdateUsagePayload<T>): Promise<CachedEntitlement<T> | null>;
     private getFeatureUsageItemToUpdate;
-    setCustomer(customerId: string, customerEntitlements: Map<string, CachedEntitlement>, accessDeniedReason: AccessDeniedReason | null, resourceId: string | undefined, entitlementsTimestamp: number, featureIdToUsageTimestamp: Map<string, number>): Promise<void>;
+    setCustomer(customerId: string, customerEntitlements: EntitlementsMap, accessDeniedReason: AccessDeniedReason | null, resourceId: string | undefined, entitlementsTimestamp: number): Promise<void>;
     private extractFeatureUsagesToUpdate;
     getCustomerEntitlementsWithoutUsage(customerId: string, resourceId: string | undefined): Promise<EntitlementsResponse>;
     private isGlobalCustomerMissingInCache;
@@ -35,7 +35,18 @@ export declare class RedisCacheService implements CacheService {
     private getKeysLatestTimestamp;
     private parseTimestamp;
     cleanup(): Promise<void>;
-    getCustomerEntitlement(featureId: string, customerId: string, resourceId: string | undefined): Promise<EntitlementResponse>;
+    getCustomerEntitlement<T extends EntitlementType>(query: EntitlementQuery<T>, customerId: string, resourceId: string | undefined): Promise<EntitlementResponse<T>>;
     private mergeEntitlementWithUsage;
+    /**
+     * Migrates old cache format to new format.
+     * Handles: featureUsage→usageData rename, adds type discriminator, moves fields,
+     * adds updatedAt, adds displayName fallback, nextResetDate→usagePeriodEnd.
+     */
+    private migrateOldCacheFormat;
+    /**
+     * Migrates old usage data format.
+     * Handles backward compatibility for old items that have nextResetDate instead of usagePeriodEnd.
+     */
+    private migrateUsageData;
     private executeSafely;
 }