@acmekit/caching 2.13.1

package/dist/services/cache-module.js

@@ -0,0 +1,204 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const modules_sdk_1 = require("@acmekit/framework/modules-sdk");
+const utils_1 = require("@acmekit/framework/utils");
+const _types_1 = require("../types");
+const ONE_HOUR_IN_SECOND = 60 * 60;
+class CachingModuleService {
+    constructor(container, moduleDeclaration) {
+        this.moduleDeclaration = moduleDeclaration;
+        this.ongoingRequests = new Map();
+        this.__hooks = {
+            onApplicationStart: async () => {
+                this.onApplicationStart();
+            },
+            onApplicationShutdown: async () => {
+                this.onApplicationShutdown();
+            },
+            onApplicationPrepareShutdown: async () => {
+                this.onApplicationPrepareShutdown();
+            },
+        };
+        this.container = container;
+        this.providerService = container.cacheProviderService;
+        this.defaultProviderId = container[_types_1.CachingDefaultProvider];
+        this.strategyCtr = container.strategy;
+        this.strategy = new this.strategyCtr(this.container, this);
+        const moduleOptions = "options" in moduleDeclaration
+            ? moduleDeclaration.options
+            : moduleDeclaration;
+        this.ttl = moduleOptions.ttl ?? ONE_HOUR_IN_SECOND;
+        this.logger = container.logger ?? console;
+    }
+    onApplicationStart() {
+        const loadedSchema = modules_sdk_1.AcmeKitModule.getAllJoinerConfigs()
+            .map((joinerConfig) => joinerConfig?.schema ?? "")
+            .join("\n");
+        const defaultAcmeKitSchema = `
+    scalar DateTime
+    scalar JSON
+    directive @enumValue(value: String) on ENUM_VALUE
+  `;
+        const { schema: cleanedSchema } = utils_1.GraphQLUtils.cleanGraphQLSchema(defaultAcmeKitSchema + loadedSchema);
+        const mergedSchema = utils_1.GraphQLUtils.mergeTypeDefs(cleanedSchema);
+        const schema = utils_1.GraphQLUtils.makeExecutableSchema({
+            typeDefs: mergedSchema,
+        });
+        this.strategy.onApplicationStart?.(schema, modules_sdk_1.AcmeKitModule.getAllJoinerConfigs());
+    }
+    onApplicationShutdown() {
+        this.strategy.onApplicationShutdown?.();
+    }
+    onApplicationPrepareShutdown() {
+        this.strategy.onApplicationPrepareShutdown?.();
+    }
+    static normalizeProviders(providers) {
+        const providers_ = Array.isArray(providers) ? providers : [providers];
+        return providers_.map((provider) => {
+            return typeof provider === "string" ? { id: provider } : provider;
+        });
+    }
+    getRequestKey(key, tags, providers) {
+        const keyPart = key || "";
+        const tagsPart = tags?.sort().join(",") || "";
+        const providersPart = providers?.join(",") || this.defaultProviderId;
+        return `${keyPart}|${tagsPart}|${providersPart}`;
+    }
+    getClearRequestKey(key, tags, providers) {
+        const keyPart = key || "";
+        const tagsPart = tags?.sort().join(",") || "";
+        const providersPart = providers?.join(",") || this.defaultProviderId;
+        return `clear:${keyPart}|${tagsPart}|${providersPart}`;
+    }
+    async get(options) {
+        if (CachingModuleService.traceGet) {
+            return await CachingModuleService.traceGet(() => this.get_(options), options.key ?? "", options.tags ?? []);
+        }
+        return await this.get_(options);
+    }
+    async get_({ key, tags, providers, }) {
+        if (!key && !tags) {
+            throw new utils_1.AcmeKitError(utils_1.AcmeKitError.Types.INVALID_ARGUMENT, "Either key or tags must be provided");
+        }
+        const requestKey = this.getRequestKey(key, tags, providers);
+        const existingRequest = this.ongoingRequests.get(requestKey);
+        if (existingRequest) {
+            return await existingRequest;
+        }
+        const requestPromise = this.performCacheGet(key, tags, providers);
+        this.ongoingRequests.set(requestKey, requestPromise);
+        try {
+            const result = await requestPromise;
+            return result;
+        }
+        finally {
+            // Clean up the completed request
+            this.ongoingRequests.delete(requestKey);
+        }
+    }
+    async performCacheGet(key, tags, providers) {
+        const providersToCheck = providers ?? [this.defaultProviderId];
+        for (const providerId of providersToCheck) {
+            try {
+                const provider_ = this.providerService.retrieveProvider(providerId);
+                const result = await provider_.get({ key, tags });
+                if (result != null) {
+                    return result;
+                }
+            }
+            catch (error) {
+                this.logger.warn(`Cache provider ${providerId} failed: ${error.message}\n${error.stack}`);
+                continue;
+            }
+        }
+        return null;
+    }
+    async set(options) {
+        if (CachingModuleService.traceSet) {
+            return await CachingModuleService.traceSet(() => this.set_(options), options.key, options.tags ?? [], options.options ?? {});
+        }
+        return await this.set_(options);
+    }
+    async set_({ key, data, ttl, tags, providers, options, }) {
+        if (!key) {
+            throw new utils_1.AcmeKitError(utils_1.AcmeKitError.Types.INVALID_ARGUMENT, "[CachingModuleService] Key must be provided");
+        }
+        const key_ = key;
+        const tags_ = tags ?? (await this.strategy.computeTags(data));
+        let providers_ = [
+            this.defaultProviderId,
+        ];
+        providers_ = CachingModuleService.normalizeProviders(providers ?? providers_);
+        const providerIds = providers_.map((p) => p.id);
+        const requestKey = this.getRequestKey(key_, tags_, providerIds);
+        const existingRequest = this.ongoingRequests.get(requestKey);
+        if (existingRequest) {
+            return await existingRequest;
+        }
+        const requestPromise = this.performCacheSet(key_, tags_, data, ttl, providers_, options);
+        this.ongoingRequests.set(requestKey, requestPromise);
+        try {
+            await requestPromise;
+        }
+        finally {
+            // Clean up the completed request
+            this.ongoingRequests.delete(requestKey);
+        }
+    }
+    async performCacheSet(key, tags, data, ttl, providers, options) {
+        for (const providerOptions of providers || []) {
+            const ttl_ = providerOptions.ttl ?? ttl ?? this.ttl;
+            const provider = this.providerService.retrieveProvider(providerOptions.id);
+            void provider.set({
+                key,
+                tags,
+                data,
+                ttl: ttl_,
+                options,
+            });
+        }
+    }
+    async clear(options) {
+        if (CachingModuleService.traceClear) {
+            return await CachingModuleService.traceClear(() => this.clear_(options), options.key ?? "", options.tags ?? [], options.options ?? {});
+        }
+        return await this.clear_(options);
+    }
+    async clear_({ key, tags, options, providers, }) {
+        if (!key && !tags) {
+            throw new utils_1.AcmeKitError(utils_1.AcmeKitError.Types.INVALID_ARGUMENT, "Either key or tags must be provided");
+        }
+        const requestKey = this.getClearRequestKey(key, tags, providers);
+        const existingRequest = this.ongoingRequests.get(requestKey);
+        if (existingRequest) {
+            return await existingRequest;
+        }
+        const requestPromise = this.performCacheClear(key, tags, options, providers);
+        this.ongoingRequests.set(requestKey, requestPromise);
+        try {
+            await requestPromise;
+        }
+        finally {
+            // Clean up the completed request
+            this.ongoingRequests.delete(requestKey);
+        }
+    }
+    async performCacheClear(key, tags, options, providers) {
+        let providerIds_ = [this.defaultProviderId];
+        if (providers) {
+            providerIds_ = Array.isArray(providers) ? providers : [providers];
+        }
+        for (const providerId of providerIds_) {
+            const provider = this.providerService.retrieveProvider(providerId);
+            void provider.clear({ key, tags, options });
+        }
+    }
+    async computeKey(input) {
+        return await this.strategy.computeKey(input);
+    }
+    async computeTags(input, options) {
+        return await this.strategy.computeTags(input, options);
+    }
+}
+exports.default = CachingModuleService;
+//# sourceMappingURL=cache-module.js.map

package/dist/services/cache-module.js.map

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

package/dist/services/cache-provider.d.ts

@@ -0,0 +1,13 @@
+import { Constructor, ICachingProviderService, Logger } from "@acmekit/framework/types";
+type InjectedDependencies = {
+    [key: `cp_${string}`]: ICachingProviderService;
+    logger?: Logger;
+};
+export default class CacheProviderService {
+    #private;
+    constructor(container: InjectedDependencies);
+    static getRegistrationIdentifier(providerClass: Constructor<ICachingProviderService>): string;
+    retrieveProvider(providerId: string): ICachingProviderService;
+}
+export {};
+//# sourceMappingURL=cache-provider.d.ts.map

package/dist/services/cache-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-provider.d.ts","sourceRoot":"","sources":["../../src/services/cache-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,uBAAuB,EACvB,MAAM,EACP,MAAM,0BAA0B,CAAA;AAIjC,KAAK,oBAAoB,GAAG;IAC1B,CAAC,GAAG,EAAE,MAAM,MAAM,EAAE,GAAG,uBAAuB,CAAA;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,CAAC,OAAO,OAAO,oBAAoB;;gBAI3B,SAAS,EAAE,oBAAoB;IAO3C,MAAM,CAAC,yBAAyB,CAC9B,aAAa,EAAE,WAAW,CAAC,uBAAuB,CAAC;IAW9C,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,uBAAuB;CAuBrE"}

package/dist/services/cache-provider.js

@@ -0,0 +1,53 @@
+"use strict";
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _CacheProviderService_container, _CacheProviderService_logger;
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("@acmekit/framework/utils");
+const types_1 = require("../types");
+class CacheProviderService {
+    constructor(container) {
+        _CacheProviderService_container.set(this, void 0);
+        _CacheProviderService_logger.set(this, void 0);
+        __classPrivateFieldSet(this, _CacheProviderService_container, container, "f");
+        __classPrivateFieldSet(this, _CacheProviderService_logger, container["logger"]
+            ? container.logger
+            : console, "f");
+    }
+    static getRegistrationIdentifier(providerClass) {
+        if (!providerClass.identifier) {
+            throw new utils_1.AcmeKitError(utils_1.AcmeKitError.Types.INVALID_ARGUMENT, `Trying to register a caching provider without an identifier.`);
+        }
+        return `${providerClass.identifier}`;
+    }
+    retrieveProvider(providerId) {
+        try {
+            return __classPrivateFieldGet(this, _CacheProviderService_container, "f")[`${types_1.CachingProviderRegistrationPrefix}${providerId}`];
+        }
+        catch (err) {
+            if (err.name === "AwilixResolutionError") {
+                const errMessage = `
+ Unable to retrieve the caching provider with id: ${providerId}
+Please make sure that the provider is registered in the container and it is configured correctly in your project configuration file.`;
+                // Log full error for debugging
+                __classPrivateFieldGet(this, _CacheProviderService_logger, "f").error(`AwilixResolutionError: ${err.message}`, err);
+                throw new Error(errMessage);
+            }
+            const errMessage = `Unable to retrieve the caching provider with id: ${providerId}, the following error occurred: ${err.message}`;
+            __classPrivateFieldGet(this, _CacheProviderService_logger, "f").error(errMessage);
+            throw new Error(errMessage);
+        }
+    }
+}
+_CacheProviderService_container = new WeakMap(), _CacheProviderService_logger = new WeakMap();
+exports.default = CacheProviderService;
+//# sourceMappingURL=cache-provider.js.map

package/dist/services/cache-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-provider.js","sourceRoot":"","sources":["../../src/services/cache-provider.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAKA,oDAAuD;AACvD,oCAA4D;AAO5D,MAAqB,oBAAoB;IAIvC,YAAY,SAA+B;QAH3C,kDAAgC;QAChC,+CAAe;QAGb,uBAAA,IAAI,mCAAc,SAAS,MAAA,CAAA;QAC3B,uBAAA,IAAI,gCAAW,SAAS,CAAC,QAAQ,CAAC;YAChC,CAAC,CAAC,SAAS,CAAC,MAAM;YAClB,CAAC,CAAE,OAA6B,MAAA,CAAA;IACpC,CAAC;IAED,MAAM,CAAC,yBAAyB,CAC9B,aAAmD;QAEnD,IAAI,CAAE,aAAqB,CAAC,UAAU,EAAE,CAAC;YACvC,MAAM,IAAI,oBAAY,CACpB,oBAAY,CAAC,KAAK,CAAC,gBAAgB,EACnC,8DAA8D,CAC/D,CAAA;QACH,CAAC;QACD,OAAO,GAAI,aAAqB,CAAC,UAAU,EAAE,CAAA;IAC/C,CAAC;IAEM,gBAAgB,CAAC,UAAkB;QACxC,IAAI,CAAC;YACH,OAAO,uBAAA,IAAI,uCAAW,CACpB,GAAG,yCAAiC,GAAG,UAAU,EAAE,CACpD,CAAA;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,CAAC,IAAI,KAAK,uBAAuB,EAAE,CAAC;gBACzC,MAAM,UAAU,GAAG;oDACyB,UAAU;qIACuE,CAAA;gBAE7H,+BAA+B;gBAC/B,uBAAA,IAAI,oCAAQ,CAAC,KAAK,CAAC,0BAA0B,GAAG,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,CAAA;gBAEhE,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,CAAA;YAC7B,CAAC;YAED,MAAM,UAAU,GAAG,oDAAoD,UAAU,mCAAmC,GAAG,CAAC,OAAO,EAAE,CAAA;YACjI,uBAAA,IAAI,oCAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;YAE9B,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,CAAA;QAC7B,CAAC;IACH,CAAC;CACF;;kBA9CoB,oBAAoB"}

package/dist/services/index.d.ts

@@ -0,0 +1,3 @@
+export { default as CachingModuleService } from "./cache-module";
+export { default as CachingProviderService } from "./cache-provider";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAChE,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/services/index.js

@@ -0,0 +1,11 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CachingProviderService = exports.CachingModuleService = void 0;
+var cache_module_1 = require("./cache-module");
+Object.defineProperty(exports, "CachingModuleService", { enumerable: true, get: function () { return __importDefault(cache_module_1).default; } });
+var cache_provider_1 = require("./cache-provider");
+Object.defineProperty(exports, "CachingProviderService", { enumerable: true, get: function () { return __importDefault(cache_provider_1).default; } });
+//# sourceMappingURL=index.js.map

package/dist/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":";;;;;;AAAA,+CAAgE;AAAvD,qIAAA,OAAO,OAAwB;AACxC,mDAAoE;AAA3D,yIAAA,OAAO,OAA0B"}

package/dist/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["../src/index.ts","../src/loaders/hash.ts","../src/loaders/providers.ts","../src/providers/memory-cache.ts","../src/services/cache-module.ts","../src/services/cache-provider.ts","../src/services/index.ts","../src/types/index.ts","../src/utils/parser.ts","../src/utils/strategy.ts","../src/utils/__tests__/parser.test.ts"],"version":"5.9.3"}

package/dist/types/index.d.ts

@@ -0,0 +1,82 @@
+import type { Constructor, ICachingStrategy, IEventBusModuleService, Logger, ModuleProviderExports, ModuleServiceInitializeOptions } from "@acmekit/framework/types";
+import { Modules } from "@acmekit/framework/utils";
+import { default as CacheProviderService } from "../services/cache-provider";
+export declare const CachingDefaultProvider = "default_provider";
+export declare const CachingIdentifiersRegistrationName = "caching_providers_identifier";
+export declare const CachingProviderRegistrationPrefix = "lp_";
+export type InjectedDependencies = {
+    cacheProviderService: CacheProviderService;
+    hasher: (data: string) => string;
+    logger?: Logger;
+    strategy: Constructor<ICachingStrategy>;
+    [CachingDefaultProvider]: string;
+    [Modules.EVENT_BUS]: IEventBusModuleService;
+};
+export interface MemoryCacheModuleOptions {
+    /**
+     * TTL in seconds
+     */
+    ttl?: number;
+    /**
+     * Maximum number of keys to store (see node-cache documentation)
+     */
+    maxKeys?: number;
+    /**
+     * Check period for expired keys in seconds (see node-cache documentation)
+     */
+    checkPeriod?: number;
+    /**
+     * Use clones for cached data (see node-cache documentation)
+     */
+    useClones?: boolean;
+    /**
+     * Maximum size of the cache in bytes (default 300MB).
+     * It is an approximation, if a new entry will make the limit exceeded, the entry will be cached
+     * but not the following ones
+     */
+    maxSize?: number;
+}
+export type CachingModuleOptions = Partial<ModuleServiceInitializeOptions> & {
+    /**
+     * The strategy to be used. Default to the inbuilt default strategy.
+     */
+    /**
+     * Time to keep data in cache (in seconds)
+     */
+    ttl?: number;
+    /**
+     * Enable and configure the built in memory cache
+     * @private
+     */
+    in_memory?: MemoryCacheModuleOptions & {
+        enable?: boolean;
+    };
+    /**
+     * Providers to be registered
+     */
+    providers?: {
+        /**
+         * The module provider to be registered
+         */
+        resolve: string | ModuleProviderExports;
+        /**
+         * If the provider is the default
+         */
+        is_default?: boolean;
+        /**
+         * The id of the provider
+         */
+        id: string;
+        /**
+         * key value pair of the configuration to be passed to the provider constructor
+         */
+        options?: Record<string, unknown>;
+    }[];
+};
+declare module "@acmekit/types" {
+    interface ModuleOptions {
+        "@acmekit/caching": CachingModuleOptions;
+        "@acmekit/acmekit/caching": CachingModuleOptions;
+    }
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,sBAAsB,EACtB,MAAM,EACN,qBAAqB,EACrB,8BAA8B,EAC/B,MAAM,0BAA0B,CAAA;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AAClD,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAE5E,eAAO,MAAM,sBAAsB,qBAAqB,CAAA;AACxD,eAAO,MAAM,kCAAkC,iCAAiC,CAAA;AAEhF,eAAO,MAAM,iCAAiC,QAAQ,CAAA;AAEtD,MAAM,MAAM,oBAAoB,GAAG;IACjC,oBAAoB,EAAE,oBAAoB,CAAA;IAC1C,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IAChC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,WAAW,CAAC,gBAAgB,CAAC,CAAA;IACvC,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAChC,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,sBAAsB,CAAA;CAC5C,CAAA;AAED,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,8BAA8B,CAAC,GAAG;IAC3E;;OAEG;IAEH;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IAEZ;;;OAGG;IACH,SAAS,CAAC,EAAE,wBAAwB,GAAG;QACrC,MAAM,CAAC,EAAE,OAAO,CAAA;KACjB,CAAA;IAED;;OAEG;IACH,SAAS,CAAC,EAAE;QACV;;WAEG;QACH,OAAO,EAAE,MAAM,GAAG,qBAAqB,CAAA;QACvC;;WAEG;QACH,UAAU,CAAC,EAAE,OAAO,CAAA;QACpB;;WAEG;QACH,EAAE,EAAE,MAAM,CAAA;QACV;;WAEG;QACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAClC,EAAE,CAAA;CACJ,CAAA;AAED,OAAO,QAAQ,gBAAgB,CAAC;IAC9B,UAAU,aAAa;QACrB,kBAAkB,EAAE,oBAAoB,CAAA;QACxC,0BAA0B,EAAE,oBAAoB,CAAA;KACjD;CACF"}

package/dist/types/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CachingProviderRegistrationPrefix = exports.CachingIdentifiersRegistrationName = exports.CachingDefaultProvider = void 0;
+const utils_1 = require("@acmekit/framework/utils");
+exports.CachingDefaultProvider = "default_provider";
+exports.CachingIdentifiersRegistrationName = "caching_providers_identifier";
+exports.CachingProviderRegistrationPrefix = "lp_";
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;AAQA,oDAAkD;AAGrC,QAAA,sBAAsB,GAAG,kBAAkB,CAAA;AAC3C,QAAA,kCAAkC,GAAG,8BAA8B,CAAA;AAEnE,QAAA,iCAAiC,GAAG,KAAK,CAAA"}

package/dist/utils/parser.d.ts

@@ -0,0 +1,44 @@
+import { ModuleJoinerConfig } from "@acmekit/framework/types";
+import { GraphQLSchema } from "graphql";
+export interface EntityReference {
+    type: string;
+    id: string | number;
+    field?: string;
+    isInArray?: boolean;
+}
+export interface InvalidationEvent {
+    entityType: string;
+    entityId: string | number;
+    relatedEntities: EntityReference[];
+    cacheKeys: string[];
+}
+export declare class CacheInvalidationParser {
+    private typeMap;
+    private idPrefixToEntityName;
+    constructor(schema: GraphQLSchema, joinerConfigs: ModuleJoinerConfig[]);
+    /**
+     * Parse an object to identify entities and their relationships
+     */
+    parseObjectForEntities(obj: any, parentType?: string, isInArray?: boolean): EntityReference[];
+    /**
+     * Detect entity type based on object structure and GraphQL type map
+     */
+    private detectEntityType;
+    /**
+     * Check if object structure matches GraphQL type fields
+     */
+    private objectMatchesType;
+    /**
+     * Get the expected type for a relationship field
+     */
+    private getRelationshipType;
+    /**
+     * Build invalidation events based on parsed entities
+     */
+    buildInvalidationEvents(entities: EntityReference[], operation?: "created" | "updated" | "deleted"): InvalidationEvent[];
+    /**
+     * Build list of cache keys that should be invalidated
+     */
+    private buildAffectedCacheKeys;
+}
+//# sourceMappingURL=parser.d.ts.map

package/dist/utils/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/utils/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAE7D,OAAO,EAEL,aAAa,EAId,MAAM,SAAS,CAAA;AAEhB,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;IACzB,eAAe,EAAE,eAAe,EAAE,CAAA;IAClC,SAAS,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,qBAAa,uBAAuB;IAClC,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,oBAAoB,CAAwB;gBAExC,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,kBAAkB,EAAE;IAwBtE;;OAEG;IACH,sBAAsB,CACpB,GAAG,EAAE,GAAG,EACR,UAAU,CAAC,EAAE,MAAM,EACnB,SAAS,GAAE,OAAe,GACzB,eAAe,EAAE;IA6CpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAyBxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAczB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAmC3B;;OAEG;IACH,uBAAuB,CACrB,QAAQ,EAAE,eAAe,EAAE,EAC3B,SAAS,GAAE,SAAS,GAAG,SAAS,GAAG,SAAqB,GACvD,iBAAiB,EAAE;IA6BtB;;OAEG;IACH,OAAO,CAAC,sBAAsB;CAgB/B"}

package/dist/utils/parser.js

@@ -0,0 +1,161 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheInvalidationParser = void 0;
+const utils_1 = require("@acmekit/framework/utils");
+const graphql_1 = require("graphql");
+class CacheInvalidationParser {
+    constructor(schema, joinerConfigs) {
+        this.typeMap = new Map();
+        // Build type map for quick lookups
+        const schemaTypeMap = schema.getTypeMap();
+        Object.keys(schemaTypeMap).forEach((typeName) => {
+            const type = schemaTypeMap[typeName];
+            if ((0, graphql_1.isObjectType)(type) && !typeName.startsWith("__")) {
+                this.typeMap.set(typeName, type);
+            }
+        });
+        this.idPrefixToEntityName = joinerConfigs.reduce((acc, joinerConfig) => {
+            if (joinerConfig.idPrefixToEntityName) {
+                Object.entries(joinerConfig.idPrefixToEntityName).forEach(([idPrefix, entityName]) => {
+                    acc[idPrefix] = entityName;
+                });
+            }
+            return acc;
+        }, {});
+    }
+    /**
+     * Parse an object to identify entities and their relationships
+     */
+    parseObjectForEntities(obj, parentType, isInArray = false) {
+        const entities = [];
+        if (!obj || typeof obj !== "object") {
+            return entities;
+        }
+        // Check if this object matches any known GraphQL types
+        const detectedType = this.detectEntityType(obj, parentType);
+        if (detectedType && obj.id) {
+            entities.push({
+                type: detectedType,
+                id: obj.id,
+                isInArray,
+            });
+        }
+        // Recursively parse nested objects and arrays
+        Object.keys(obj).forEach((key) => {
+            const value = obj[key];
+            if (Array.isArray(value)) {
+                value.forEach((item) => {
+                    entities.push(...this.parseObjectForEntities(item, this.getRelationshipType(detectedType, key), true));
+                });
+            }
+            else if ((0, utils_1.isObject)(value)) {
+                entities.push(...this.parseObjectForEntities(value, this.getRelationshipType(detectedType, key), false));
+            }
+        });
+        return entities;
+    }
+    /**
+     * Detect entity type based on object structure and GraphQL type map
+     */
+    detectEntityType(obj, suggestedType) {
+        if (obj.id) {
+            const idParts = obj.id.split("_");
+            if (idParts.length > 1 && this.idPrefixToEntityName[idParts[0]]) {
+                return this.idPrefixToEntityName[idParts[0]];
+            }
+        }
+        if (suggestedType && this.typeMap.has(suggestedType)) {
+            const type = this.typeMap.get(suggestedType);
+            if (this.objectMatchesType(obj, type)) {
+                return suggestedType;
+            }
+        }
+        // Try to match against all known types
+        for (const [typeName, type] of this.typeMap) {
+            if (this.objectMatchesType(obj, type)) {
+                return typeName;
+            }
+        }
+        return null;
+    }
+    /**
+     * Check if object structure matches GraphQL type fields
+     */
+    objectMatchesType(obj, type) {
+        const fields = type.getFields();
+        const objKeys = Object.keys(obj);
+        // Must have id field for entities
+        if (!obj.id || !fields.id) {
+            return false;
+        }
+        // Check if at least 50% of non-null object fields match type fields
+        const matchingFields = objKeys.filter((key) => fields[key]).length;
+        return matchingFields >= Math.max(1, objKeys.length * 0.5);
+    }
+    /**
+     * Get the expected type for a relationship field
+     */
+    getRelationshipType(parentType, fieldName) {
+        if (!parentType || !this.typeMap.has(parentType)) {
+            return undefined;
+        }
+        const type = this.typeMap.get(parentType);
+        const field = type.getFields()[fieldName];
+        if (!field) {
+            return undefined;
+        }
+        let fieldType = field.type;
+        // Unwrap NonNull and List wrappers
+        if ((0, graphql_1.isNonNullType)(fieldType)) {
+            fieldType = fieldType.ofType;
+        }
+        if ((0, graphql_1.isListType)(fieldType)) {
+            fieldType = fieldType.ofType;
+        }
+        if ((0, graphql_1.isNonNullType)(fieldType)) {
+            fieldType = fieldType.ofType;
+        }
+        if ((0, graphql_1.isObjectType)(fieldType)) {
+            return fieldType.name;
+        }
+        return undefined;
+    }
+    /**
+     * Build invalidation events based on parsed entities
+     */
+    buildInvalidationEvents(entities, operation = "updated") {
+        const events = [];
+        const processedEntities = new Set();
+        entities.forEach((entity) => {
+            const entityKey = `${entity.type}:${entity.id}`;
+            if (processedEntities.has(entityKey)) {
+                return;
+            }
+            processedEntities.add(entityKey);
+            const relatedEntities = entities.filter((e) => e.type !== entity.type || e.id !== entity.id);
+            const affectedKeys = this.buildAffectedCacheKeys(entity, operation);
+            events.push({
+                entityType: entity.type,
+                entityId: entity.id,
+                relatedEntities,
+                cacheKeys: affectedKeys,
+            });
+        });
+        return events;
+    }
+    /**
+     * Build list of cache keys that should be invalidated
+     */
+    buildAffectedCacheKeys(entity, operation = "updated") {
+        const keys = new Set();
+        keys.add(`${entity.type}:${entity.id}`);
+        // Add list key only if entity was found in an array context or if an event of type created or
+        // deleted is triggered
+        if (entity.isInArray || ["created", "deleted"].includes(operation)) {
+            keys.add(`${entity.type}:list:*`);
+        }
+        return Array.from(keys);
+    }
+}
+exports.CacheInvalidationParser = CacheInvalidationParser;
+//# sourceMappingURL=parser.js.map

package/dist/utils/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/utils/parser.ts"],"names":[],"mappings":";;;AACA,oDAAmD;AACnD,qCAMgB;AAgBhB,MAAa,uBAAuB;IAIlC,YAAY,MAAqB,EAAE,aAAmC;QACpE,IAAI,CAAC,OAAO,GAAG,IAAI,GAAG,EAAE,CAAA;QAExB,mCAAmC;QACnC,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,EAAE,CAAA;QACzC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;YAC9C,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAA;YACpC,IAAI,IAAA,sBAAY,EAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;YAClC,CAAC;QACH,CAAC,CAAC,CAAA;QAEF,IAAI,CAAC,oBAAoB,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,YAAY,EAAE,EAAE;YACrE,IAAI,YAAY,CAAC,oBAAoB,EAAE,CAAC;gBACtC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,oBAAoB,CAAC,CAAC,OAAO,CACvD,CAAC,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,EAAE;oBACzB,GAAG,CAAC,QAAQ,CAAC,GAAG,UAAU,CAAA;gBAC5B,CAAC,CACF,CAAA;YACH,CAAC;YACD,OAAO,GAAG,CAAA;QACZ,CAAC,EAAE,EAA4B,CAAC,CAAA;IAClC,CAAC;IAED;;OAEG;IACH,sBAAsB,CACpB,GAAQ,EACR,UAAmB,EACnB,YAAqB,KAAK;QAE1B,MAAM,QAAQ,GAAsB,EAAE,CAAA;QAEtC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YACpC,OAAO,QAAQ,CAAA;QACjB,CAAC;QAED,uDAAuD;QACvD,MAAM,YAAY,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,EAAE,UAAU,CAAC,CAAA;QAC3D,IAAI,YAAY,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;YAC3B,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,YAAY;gBAClB,EAAE,EAAE,GAAG,CAAC,EAAE;gBACV,SAAS;aACV,CAAC,CAAA;QACJ,CAAC;QAED,8CAA8C;QAC9C,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YAC/B,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAA;YAEtB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;oBACrB,QAAQ,CAAC,IAAI,CACX,GAAG,IAAI,CAAC,sBAAsB,CAC5B,IAAI,EACJ,IAAI,CAAC,mBAAmB,CAAC,YAAY,EAAE,GAAG,CAAC,EAC3C,IAAI,CACL,CACF,CAAA;gBACH,CAAC,CAAC,CAAA;YACJ,CAAC;iBAAM,IAAI,IAAA,gBAAQ,EAAC,KAAK,CAAC,EAAE,CAAC;gBAC3B,QAAQ,CAAC,IAAI,CACX,GAAG,IAAI,CAAC,sBAAsB,CAC5B,KAAK,EACL,IAAI,CAAC,mBAAmB,CAAC,YAAY,EAAE,GAAG,CAAC,EAC3C,KAAK,CACN,CACF,CAAA;YACH,CAAC;QACH,CAAC,CAAC,CAAA;QAEF,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,GAAQ,EAAE,aAAsB;QACvD,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;YACX,MAAM,OAAO,GAAG,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;YACjC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChE,OAAO,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;YAC9C,CAAC;QACH,CAAC;QAED,IAAI,aAAa,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;YACrD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAE,CAAA;YAC7C,IAAI,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC;gBACtC,OAAO,aAAa,CAAA;YACtB,CAAC;QACH,CAAC;QAED,uCAAuC;QACvC,KAAK,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC5C,IAAI,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC;gBACtC,OAAO,QAAQ,CAAA;YACjB,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;OAEG;IACK,iBAAiB,CAAC,GAAQ,EAAE,IAAuB;QACzD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAA;QAC/B,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAEhC,kCAAkC;QAClC,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YAC1B,OAAO,KAAK,CAAA;QACd,CAAC;QAED,oEAAoE;QACpE,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAA;QAClE,OAAO,cAAc,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAA;IAC5D,CAAC;IAED;;OAEG;IACK,mBAAmB,CACzB,UAAyB,EACzB,SAAiB;QAEjB,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YACjD,OAAO,SAAS,CAAA;QAClB,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAE,CAAA;QAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC,SAAS,CAAC,CAAA;QAEzC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,SAAS,CAAA;QAClB,CAAC;QAED,IAAI,SAAS,GAAG,KAAK,CAAC,IAAI,CAAA;QAE1B,mCAAmC;QACnC,IAAI,IAAA,uBAAa,EAAC,SAAS,CAAC,EAAE,CAAC;YAC7B,SAAS,GAAG,SAAS,CAAC,MAAM,CAAA;QAC9B,CAAC;QACD,IAAI,IAAA,oBAAU,EAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,SAAS,GAAG,SAAS,CAAC,MAAM,CAAA;QAC9B,CAAC;QACD,IAAI,IAAA,uBAAa,EAAC,SAAS,CAAC,EAAE,CAAC;YAC7B,SAAS,GAAG,SAAS,CAAC,MAAM,CAAA;QAC9B,CAAC;QAED,IAAI,IAAA,sBAAY,EAAC,SAAS,CAAC,EAAE,CAAC;YAC5B,OAAO,SAAS,CAAC,IAAI,CAAA;QACvB,CAAC;QAED,OAAO,SAAS,CAAA;IAClB,CAAC;IAED;;OAEG;IACH,uBAAuB,CACrB,QAA2B,EAC3B,YAA+C,SAAS;QAExD,MAAM,MAAM,GAAwB,EAAE,CAAA;QACtC,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAU,CAAA;QAE3C,QAAQ,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;YAC1B,MAAM,SAAS,GAAG,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,EAAE,EAAE,CAAA;YAE/C,IAAI,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBACrC,OAAM;YACR,CAAC;YACD,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;YAEhC,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CACrC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,CACpD,CAAA;YAED,MAAM,YAAY,GAAG,IAAI,CAAC,sBAAsB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;YAEnE,MAAM,CAAC,IAAI,CAAC;gBACV,UAAU,EAAE,MAAM,CAAC,IAAI;gBACvB,QAAQ,EAAE,MAAM,CAAC,EAAE;gBACnB,eAAe;gBACf,SAAS,EAAE,YAAY;aACxB,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;QAEF,OAAO,MAAM,CAAA;IACf,CAAC;IAED;;OAEG;IACK,sBAAsB,CAC5B,MAAuB,EACvB,YAA+C,SAAS;QAExD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;QAE9B,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC,CAAA;QAEvC,8FAA8F;QAC9F,uBAAuB;QACvB,IAAI,MAAM,CAAC,SAAS,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACnE,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,SAAS,CAAC,CAAA;QACnC,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;CACF;AAzND,0DAyNC"}