@decaf-ts/integrations 0.10.8 → 0.11.0

package/lib/cjs/loader/families.cjs

@@ -1,13 +1,32 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GraphNodeObjectLoader = exports.AngularComponentObjectLoader = exports.EnvironmentObjectLoader = exports.ControllerObjectLoader = exports.ServiceObjectLoader = exports.RepositoryObjectLoader = exports.AdapterObjectLoader = exports.ModelObjectLoader = void 0;
+exports.AngularComponentObjectLoader = exports.EnvironmentObjectLoader = exports.ControllerObjectLoader = exports.ServiceObjectLoader = exports.RepositoryObjectLoader = exports.AdapterObjectLoader = exports.ModelObjectLoader = void 0;
+exports.assertConstructor = assertConstructor;
+const db_decorators_1 = require("@decaf-ts/db-decorators");
 const ObjectLoader_js_1 = require("./ObjectLoader.cjs");
+/**
+ * @summary Assert a loaded export is a constructor.
+ * @description Concrete class loaders (models, services, Nest controllers) only
+ * make sense for constructor exports. Throwing a decaf {@link ValidationError}
+ * keeps the failure inside the decaf error hierarchy instead of a raw `Error`.
+ */
+function assertConstructor(value, family, source, exportName) {
+    if (typeof value !== "function") {
+        throw new db_decorators_1.ValidationError(`Loaded ${family} export "${exportName}" from "${source}" is not a constructor.`);
+    }
+    return value;
+}
+/**
+ * Concrete model loader. Resolves a model constructor from a module source and
+ * runs the shared hook pipeline before returning it.
+ */
 class ModelObjectLoader extends ObjectLoader_js_1.ObjectLoader {
     constructor(options = {}) {
         super({ ...options, family: "model" });
     }
     async loadModel(source, exportName = this.defaultExportName, options = {}) {
-        return this.loadExport(source, exportName, options);
+        const value = await this.loadExport(source, exportName, options);
+        return assertConstructor(value, this.family, this.normalizeSource(source), exportName);
     }
 }
 exports.ModelObjectLoader = ModelObjectLoader;
@@ -29,12 +48,17 @@ class RepositoryObjectLoader extends ObjectLoader_js_1.ObjectLoader {
     }
 }
 exports.RepositoryObjectLoader = RepositoryObjectLoader;
+/**
+ * Concrete service loader. Resolves a service constructor from a module source and
+ * runs the shared hook pipeline before returning it.
+ */
 class ServiceObjectLoader extends ObjectLoader_js_1.ObjectLoader {
     constructor(options = {}) {
         super({ ...options, family: "service" });
     }
     async loadService(source, exportName = this.defaultExportName, options = {}) {
-        return this.loadExport(source, exportName, options);
+        const value = await this.loadExport(source, exportName, options);
+        return assertConstructor(value, this.family, this.normalizeSource(source), exportName);
     }
 }
 exports.ServiceObjectLoader = ServiceObjectLoader;
@@ -65,14 +89,5 @@ class AngularComponentObjectLoader extends ObjectLoader_js_1.ObjectLoader {
     }
 }
 exports.AngularComponentObjectLoader = AngularComponentObjectLoader;
-class GraphNodeObjectLoader extends ObjectLoader_js_1.ObjectLoader {
-    constructor(options = {}) {
-        super({ ...options, family: "node" });
-    }
-    async loadNode(source, exportName = this.defaultExportName, options = {}) {
-        return this.loadExport(source, exportName, options);
-    }
-}
-exports.GraphNodeObjectLoader = GraphNodeObjectLoader;
 //# sourceMappingURL=families.js.map
 //# sourceMappingURL=families.cjs.map

package/lib/cjs/loader/families.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"loader/families.cjs","sourceRoot":"","sources":["loader/families.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"loader/families.cjs","sourceRoot":"","sources":["loader/families.js"],"names":[],"mappings":"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"}

package/lib/cjs/loader/index.cjs

@@ -24,5 +24,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./types.cjs"), exports);
 __exportStar(require("./ObjectLoader.cjs"), exports);
 __exportStar(require("./families.cjs"), exports);
+__exportStar(require("./assets.cjs"), exports);
+__exportStar(require("./nest.cjs"), exports);
+__exportStar(require("./config.cjs"), exports);
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.cjs.map

package/lib/cjs/loader/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"loader/index.cjs","sourceRoot":"","sources":["loader/index.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;GAMG;AACH,6CAA2B;AAC3B,oDAAkC;AAClC,gDAA8B;AAC9B,iCAAiC"}
+{"version":3,"file":"loader/index.cjs","sourceRoot":"","sources":["loader/index.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;GAMG;AACH,6CAA2B;AAC3B,oDAAkC;AAClC,gDAA8B;AAC9B,8CAA4B;AAC5B,4CAA0B;AAC1B,8CAA4B;AAC5B,iCAAiC"}

package/lib/cjs/loader/nest.cjs

@@ -0,0 +1,331 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NestRouteObjectLoader = exports.NestControllerObjectLoader = exports.NEST_MODULE_IMPORTS = exports.NEST_MODULE_CONTROLLERS = exports.NEST_CONTROLLER_WATERMARK = exports.NEST_METHOD_METADATA = exports.NEST_PATH_METADATA = void 0;
+exports.loadNestCommon = loadNestCommon;
+const core_1 = require("@decaf-ts/core");
+const db_decorators_1 = require("@decaf-ts/db-decorators");
+const ObjectLoader_js_1 = require("./ObjectLoader.cjs");
+/**
+ * @module integrations/loader/nest
+ * @summary Lazy NestJS loaders.
+ * @description Resolves NestJS controller classes and their route definitions
+ * from dynamically loaded modules. `@nestjs/common` and `reflect-metadata` are
+ * optional at runtime: both are dynamically imported/checked and the loaders
+ * degrade with a decaf {@link UnsupportedError} when they are unavailable.
+ *
+ * ## Tree-shaking
+ * The NestJS runtime is imported through a non-literal specifier so bundlers keep
+ * it as a runtime import and never inline it into the loader chunk. Nest
+ * applications already keep `@nestjs/common` in their entry graph, so the loader
+ * does not need a static reference of its own.
+ */
+/**
+ * Stable NestJS metadata keys. Declared as literals so this module never
+ * hard-depends on `@nestjs/common/constants` (a CommonJS-only subpath).
+ */
+exports.NEST_PATH_METADATA = "path";
+exports.NEST_METHOD_METADATA = "method";
+exports.NEST_CONTROLLER_WATERMARK = "__controller__";
+exports.NEST_MODULE_CONTROLLERS = "controllers";
+exports.NEST_MODULE_IMPORTS = "imports";
+const NEST_COMMON_SPECIFIER = "@nestjs/common";
+const HTTP_METHOD_NAMES = {
+    0: "GET",
+    1: "POST",
+    2: "PUT",
+    3: "DELETE",
+    4: "PATCH",
+    5: "ALL",
+    6: "OPTIONS",
+    7: "HEAD",
+    8: "SEARCH",
+    9: "PROPFIND",
+    10: "PROPPATCH",
+    11: "MKCOL",
+    12: "COPY",
+    13: "MOVE",
+    14: "LOCK",
+    15: "UNLOCK",
+    16: "QUERY",
+};
+let nestCommonPromise;
+/**
+ * @summary Lazily resolve the NestJS runtime.
+ * @description Uses a non-literal dynamic import so bundlers do not inline or
+ * drop `@nestjs/common`. Throws a decaf {@link UnsupportedError} when the
+ * package cannot be resolved.
+ */
+async function loadNestCommon() {
+    if (!nestCommonPromise) {
+        nestCommonPromise = Promise.resolve(`${NEST_COMMON_SPECIFIER}`).then(s => __importStar(require(s))).then((module) => {
+            const resolved = module;
+            if (typeof resolved.Controller !== "function") {
+                throw new core_1.UnsupportedError(`NestJS integration is not available: "${NEST_COMMON_SPECIFIER}" does not expose the expected exports.`);
+            }
+            return resolved;
+        })
+            .catch((error) => {
+            nestCommonPromise = undefined;
+            if (error instanceof core_1.UnsupportedError)
+                throw error;
+            throw new core_1.UnsupportedError(`NestJS integration is not available: "${NEST_COMMON_SPECIFIER}" could not be resolved. ` +
+                `Install @nestjs/common and reflect-metadata to use the Nest loaders. ` +
+                `Cause: ${error?.message ?? String(error)}`);
+        });
+    }
+    return nestCommonPromise;
+}
+function metadataReader() {
+    const reflect = Reflect;
+    if (typeof reflect.getMetadata !== "function") {
+        throw new core_1.UnsupportedError("NestJS metadata is not available: reflect-metadata must be loaded before using the Nest loaders.");
+    }
+    return reflect;
+}
+function methodNameFor(method) {
+    return HTTP_METHOD_NAMES[method] ?? `METHOD_${method}`;
+}
+function normalizeSegment(segment) {
+    return segment.replace(/^\/+|\/+$/g, "");
+}
+function joinRoutePaths(controllerPath, routePath) {
+    const segments = [controllerPath, routePath]
+        .filter((value) => typeof value === "string")
+        .map(normalizeSegment)
+        .filter(Boolean);
+    return `/${segments.join("/")}`;
+}
+/**
+ * @summary Resolve NestJS controller classes from dynamically loaded modules.
+ * @description Extends the generic controller family with NestJS metadata
+ * awareness. Requires `@nestjs/common` and `reflect-metadata` at runtime.
+ */
+class NestControllerObjectLoader extends ObjectLoader_js_1.ObjectLoader {
+    constructor(options = {}) {
+        super({ ...options, family: "controller" });
+    }
+    async loadController(source, exportName = this.defaultExportName, options = {}) {
+        await loadNestCommon();
+        const value = await this.loadExport(source, exportName, options);
+        return this.assertController(value, this.normalizeSource(source), exportName);
+    }
+    /**
+     * @summary Load every controller exported by a module.
+     */
+    async loadControllers(source, options = {}) {
+        await loadNestCommon();
+        const module = await this.loadModule(source);
+        const controllers = this.collectControllers(module, options.recursive);
+        const context = this.createContext(this.normalizeSource(source), "*", module, "afterResolve", {
+            ...this.metadata,
+            ...(options.metadata ?? {}),
+            controllerCount: controllers.length,
+        });
+        return this.runHooks(controllers, context, options);
+    }
+    /**
+     * @summary Scan a NestJS module (or namespace) for controller classes.
+     * @description Synchronous metadata scan. Requires `reflect-metadata` but not
+     * `@nestjs/common`; call {@link loadNestCommon} first when the module must be
+     * imported.
+     */
+    collectControllers(value, recursive = true) {
+        const result = [];
+        const seen = new Set();
+        this.scanControllers(value, result, seen, recursive);
+        return result;
+    }
+    isController(value) {
+        if (typeof value !== "function")
+            return false;
+        const reader = metadataReader();
+        return (reader.getMetadata(exports.NEST_CONTROLLER_WATERMARK, value) === true ||
+            typeof reader.getMetadata(exports.NEST_PATH_METADATA, value) !== "undefined");
+    }
+    getControllerPath(controller) {
+        const value = metadataReader().getMetadata(exports.NEST_PATH_METADATA, controller);
+        return typeof value === "string" ? value : undefined;
+    }
+    assertController(value, source, exportName) {
+        if (!this.isController(value)) {
+            throw new db_decorators_1.ValidationError(`Loaded controller export "${exportName}" from "${source}" is not a NestJS controller.`);
+        }
+        return value;
+    }
+    scanControllers(value, result, seen, recursive) {
+        if (value === null || typeof value !== "object") {
+            if (this.isController(value) && !result.includes(value)) {
+                result.push(value);
+            }
+            return;
+        }
+        if (seen.has(value))
+            return;
+        seen.add(value);
+        const record = value;
+        const controllers = record[exports.NEST_MODULE_CONTROLLERS];
+        if (Array.isArray(controllers)) {
+            for (const controller of controllers) {
+                if (this.isController(controller) &&
+                    !result.includes(controller)) {
+                    result.push(controller);
+                }
+            }
+        }
+        if (recursive) {
+            const imports = record[exports.NEST_MODULE_IMPORTS];
+            if (Array.isArray(imports)) {
+                for (const imported of imports) {
+                    if (imported &&
+                        typeof imported.then === "function") {
+                        continue;
+                    }
+                    this.scanControllers(imported, result, seen, recursive);
+                }
+            }
+        }
+        for (const key of Object.keys(record)) {
+            const candidate = record[key];
+            if (this.isController(candidate) && !result.includes(candidate)) {
+                result.push(candidate);
+            }
+        }
+    }
+}
+exports.NestControllerObjectLoader = NestControllerObjectLoader;
+/**
+ * @summary Resolve route definitions from dynamically loaded NestJS modules.
+ */
+class NestRouteObjectLoader extends ObjectLoader_js_1.ObjectLoader {
+    constructor(options = {}) {
+        super({ ...options, family: "route" });
+    }
+    /**
+     * @summary Load every route declared by a controller exported from a module.
+     */
+    async loadControllerRoutes(source, exportName = this.defaultExportName, options = {}) {
+        await loadNestCommon();
+        const value = await this.loadExport(source, exportName, options);
+        const controller = this.assertController(value, this.normalizeSource(source), exportName);
+        const routes = this.getRoutes(controller);
+        const context = this.createContext(this.normalizeSource(source), exportName, {}, "afterResolve", {
+            ...this.metadata,
+            ...(options.metadata ?? {}),
+            routeCount: routes.length,
+        });
+        return this.runHooks(routes, context, options);
+    }
+    /**
+     * @summary Load every route declared by every controller in a module.
+     */
+    async loadRoutes(source, options = {}) {
+        await loadNestCommon();
+        const module = await this.loadModule(source);
+        const controllerLoader = new NestControllerObjectLoader({
+            hooks: this.hooks,
+            beforeResolveHooks: this.beforeResolveHooks,
+        });
+        const controllers = controllerLoader.collectControllers(module);
+        const routes = [];
+        for (const controller of controllers) {
+            routes.push(...this.getRoutes(controller));
+        }
+        const context = this.createContext(this.normalizeSource(source), "*", module, "afterResolve", {
+            ...this.metadata,
+            ...(options.metadata ?? {}),
+            routeCount: routes.length,
+        });
+        return this.runHooks(routes, context, options);
+    }
+    /**
+     * @summary Extract route definitions from a controller class.
+     * @description Synchronous metadata scan. Requires `reflect-metadata`.
+     */
+    getRoutes(controller, controllerPath) {
+        const reader = metadataReader();
+        const resolvedControllerPath = controllerPath ?? this.getControllerPath(controller);
+        const prototype = controller.prototype;
+        const keys = [
+            ...Object.getOwnPropertyNames(prototype),
+            ...Object.getOwnPropertySymbols(prototype),
+        ];
+        const routes = [];
+        for (const propertyKey of keys) {
+            if (propertyKey === "constructor")
+                continue;
+            const handler = prototype[propertyKey];
+            if (typeof handler !== "function")
+                continue;
+            const method = reader.getMetadata(exports.NEST_METHOD_METADATA, handler);
+            if (typeof method !== "number")
+                continue;
+            const routePath = reader.getMetadata(exports.NEST_PATH_METADATA, handler);
+            const path = typeof routePath === "string" ? routePath : "";
+            routes.push({
+                controller,
+                controllerName: controller.name,
+                controllerPath: resolvedControllerPath || undefined,
+                propertyKey,
+                handler: handler,
+                method,
+                methodName: methodNameFor(method),
+                path,
+                fullPath: joinRoutePaths(resolvedControllerPath, path),
+            });
+        }
+        return routes;
+    }
+    isController(value) {
+        if (typeof value !== "function")
+            return false;
+        const reader = metadataReader();
+        return (reader.getMetadata(exports.NEST_CONTROLLER_WATERMARK, value) === true ||
+            typeof reader.getMetadata(exports.NEST_PATH_METADATA, value) !== "undefined");
+    }
+    getControllerPath(controller) {
+        const value = metadataReader().getMetadata(exports.NEST_PATH_METADATA, controller);
+        return typeof value === "string" ? value : undefined;
+    }
+    assertController(value, source, exportName) {
+        if (!this.isController(value)) {
+            throw new db_decorators_1.ValidationError(`Loaded controller export "${exportName}" from "${source}" is not a NestJS controller.`);
+        }
+        return value;
+    }
+}
+exports.NestRouteObjectLoader = NestRouteObjectLoader;
+//# sourceMappingURL=nest.js.map
+//# sourceMappingURL=nest.cjs.map

package/lib/cjs/loader/nest.cjs.map

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

package/lib/cjs/redis/RedisContextLock.cjs

@@ -0,0 +1,185 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisContextLock = void 0;
+const core_1 = require("@decaf-ts/core");
+const db_decorators_1 = require("@decaf-ts/db-decorators");
+const redis_1 = require("redis");
+/**
+ * @description Redis-native transaction lock for the Redis adapter
+ * @summary Backs `@transactional()` with a dedicated Redis connection carrying a
+ * native `MULTI` command queue plus an in-memory read cache. Every CRUD write
+ * performed under an active transaction is queued on the native `MULTI` object and
+ * mirrored into the read cache, so the transaction observes its own writes
+ * (read-your-writes) while remaining invisible to every other connection until
+ * {@link RedisContextLock.commit} issues `WATCH` and `EXEC`. If a watched table
+ * changed concurrently, `EXEC` aborts and the transaction raises a
+ * `ConflictError` instead of silently overwriting the concurrent write.
+ *
+ * A dedicated connection is required: `WATCH` is per-connection state on the
+ * node-redis client, so a `WATCH` issued on the shared, multiplexed adapter
+ * client would be cleared or replaced by any concurrent adapter operation (and a
+ * concurrent write to a watched key would abort an unrelated transaction).
+ * @class RedisContextLock
+ * @category Redis
+ */
+class RedisContextLock extends core_1.ContextLock {
+    constructor() {
+        super(...arguments);
+        this.readCache = new Map();
+    }
+    /**
+     * @description Whether a Redis transaction is currently open
+     * @return {boolean} True while a transaction is active
+     */
+    get active() {
+        return !!this.txClient;
+    }
+    /**
+     * @description Returns the buffered entry for a record, when present
+     * @param {string} table - The table (model) name
+     * @param {string} id - The record id
+     * @return {{found: boolean, value?: RedisBufferedValue}} The buffered entry state
+     */
+    getRecord(table, id) {
+        const entries = this.readCache.get(table);
+        if (!entries || !entries.has(id))
+            return { found: false };
+        return { found: true, value: entries.get(id) };
+    }
+    /**
+     * @description Queues a serialized record on the native transaction and buffers it for reads
+     * @param {string} table - The table (model) name
+     * @param {string} id - The record id
+     * @param {string} value - The serialized record
+     * @return {void}
+     */
+    setRecord(table, id, value) {
+        let entries = this.readCache.get(table);
+        if (!entries) {
+            entries = new Map();
+            this.readCache.set(table, entries);
+        }
+        entries.set(id, value);
+        if (!this.multi)
+            return;
+        const key = this.adapter.recordKey(table);
+        if (value === null)
+            this.multi.hDel(key, id);
+        else
+            this.multi.hSet(key, id, value);
+    }
+    /**
+     * @description Queues a record deletion on the native transaction and buffers it
+     * @param {string} table - The table (model) name
+     * @param {string} id - The record id
+     * @return {void}
+     */
+    deleteRecord(table, id) {
+        this.setRecord(table, id, null);
+    }
+    /**
+     * @description Returns the buffered writes for a table, when any exist
+     * @param {string} table - The table (model) name
+     * @return {Map<string, RedisBufferedValue> | undefined} The buffered entries
+     */
+    tableEntries(table) {
+        return this.readCache.get(table);
+    }
+    /**
+     * @description Starts the transaction, opening a dedicated connection and native queue
+     * @summary Delegates to the base implementation so `maxConcurrentTransactions`
+     * continues to gate concurrency, then opens a dedicated connection and its native
+     * `MULTI` command queue.
+     * @param {Context<any>} context - The context the transaction is starting under
+     * @return {Promise<void>} A promise that resolves once the transaction is open
+     */
+    async begin(context) {
+        await super.begin(context);
+        try {
+            const client = this.adapter.client.duplicate();
+            await client.connect();
+            this.txClient = client;
+            this.multi = this.txClient.multi();
+        }
+        catch (e) {
+            await super.rollback(e, context);
+            throw e;
+        }
+    }
+    /**
+     * @description Flushes the queued writes atomically and ends the transaction
+     * @summary `WATCH`es every touched table on the dedicated connection, then runs
+     * the native `MULTI` queue with `EXEC`. If a watched table changed concurrently,
+     * `EXEC` aborts with a `WatchError` and the transaction raises a
+     * `ConflictError`. On success (or conflict) the dedicated connection is released
+     * and the concurrency permit returned.
+     * @param {Context<any>} context - The context the transaction ran under
+     * @return {Promise<void>} A promise that resolves once the transaction ends
+     */
+    async commit(context) {
+        if (!this.txClient || !this.multi) {
+            await super.commit(context);
+            return;
+        }
+        const watched = [...this.readCache.keys()].map((table) => this.adapter.recordKey(table));
+        try {
+            if (watched.length)
+                await this.txClient.watch(watched);
+            await this.multi.exec();
+        }
+        catch (e) {
+            if (e instanceof redis_1.WatchError)
+                throw new db_decorators_1.ConflictError("Redis transaction aborted: a watched record changed concurrently");
+            throw e;
+        }
+        finally {
+            await this.releaseTx();
+            await super.commit(context);
+        }
+    }
+    /**
+     * @description Discards the queued writes and ends the transaction
+     * @param {Error} err - The error that triggered the rollback
+     * @param {Context<any>} context - The context the transaction ran under
+     * @return {Promise<void>} A promise that resolves once the transaction ends
+     */
+    async rollback(err, context) {
+        await this.releaseTx();
+        await super.rollback(err, context);
+    }
+    /**
+     * @description Releases the dedicated transaction connection and clears state
+     * @summary Unwatches and closes the dedicated connection, then clears the native
+     * queue and read cache so queued writes are never applied after rollback or after
+     * an already flushed commit.
+     * @return {Promise<void>} A promise that resolves once the connection is released
+     */
+    async releaseTx() {
+        const client = this.txClient;
+        this.txClient = undefined;
+        this.multi = undefined;
+        this.readCache.clear();
+        if (!client)
+            return;
+        try {
+            await client.unwatch();
+        }
+        catch {
+            // the connection may already be gone; nothing left to unwatch
+        }
+        try {
+            await client.quit();
+        }
+        catch {
+            try {
+                client.destroy();
+            }
+            catch {
+                // connection already closed
+            }
+        }
+    }
+}
+exports.RedisContextLock = RedisContextLock;
+//# sourceMappingURL=RedisContextLock.js.map
+//# sourceMappingURL=RedisContextLock.cjs.map

package/lib/cjs/redis/RedisContextLock.cjs.map

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