@zyno-io/ts-server-foundation 26.712.36

package/dist/src/helpers/io/stream.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResourceTracker = exports.PipeError = void 0;
+exports.safePipe = safePipe;
+exports.withResourceCleanup = withResourceCleanup;
+const promises_1 = require("node:fs/promises");
+let _PipeErrorMetadata_1;
+class PipeError extends Error {
+    cause;
+    side;
+    constructor(cause, side) {
+        super(cause.message);
+        this.cause = cause;
+        this.side = side;
+        this.name = 'PipeError';
+    }
+    static __tsfType = _PipeErrorMetadata_1 = ({ kind: 16, name: "PipeError", typeName: "PipeError", classType: () => PipeError, properties: [], methods: [], hasConstructor: true, constructorParameters: [{ name: "cause", type: { kind: 16, typeName: "Error", classType: () => (typeof Error !== "undefined" ? Error : (typeof exports !== "undefined" ? exports.Error : undefined)) }, optional: false, default: false }, { name: "side", type: { kind: 12, types: [{ kind: 10, literal: "input" }, { kind: 10, literal: "output" }] }, optional: false, default: false }] });
+}
+exports.PipeError = PipeError;
+_PipeErrorMetadata_1.classType = PipeError;
+PipeError.__tsfType = _PipeErrorMetadata_1;
+function safePipe(input, output) {
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const fail = (error, side) => {
+            if (settled)
+                return;
+            settled = true;
+            if (side === 'input' && !output.destroyed)
+                output.destroy();
+            if (side === 'output' && !input.destroyed)
+                input.destroy();
+            reject(new PipeError(error, side));
+        };
+        const finish = () => {
+            if (settled)
+                return;
+            settled = true;
+            resolve();
+        };
+        input.on('close', () => {
+            if (!input.readableEnded)
+                fail(new Error('Input stream aborted'), 'input');
+        });
+        input.on('error', error => fail(error, 'input'));
+        output.on('close', () => {
+            if (!output.writableEnded)
+                fail(new Error('Output stream aborted'), 'output');
+        });
+        output.on('error', error => fail(error, 'output'));
+        output.on('finish', finish);
+        input.pipe(output);
+    });
+}
+let _ResourceTrackerMetadata_1;
+class ResourceTracker {
+    files = [];
+    streams = [];
+    failure;
+    addStream(stream) {
+        stream.on('error', error => {
+            this.failure ??= error;
+        });
+        this.streams.push(stream);
+    }
+    addFile(file) {
+        this.files.push(file);
+    }
+    getFailure() {
+        return this.failure;
+    }
+    async cleanup() {
+        await Promise.all(this.files.map(file => (0, promises_1.unlink)(file).catch(() => { })));
+        for (const stream of this.streams) {
+            if (!stream.destroyed)
+                stream.destroy();
+        }
+    }
+    static __tsfType = _ResourceTrackerMetadata_1 = ({ kind: 16, name: "ResourceTracker", typeName: "ResourceTracker", classType: () => ResourceTracker, properties: [{ name: "files", type: { kind: 14, type: { kind: 6 } }, optional: false }, { name: "streams", type: { kind: 14, type: { kind: 12, types: [(() => { const __tsf_module = (() => {
+                                try {
+                                    return typeof require !== "undefined" ? require("node:stream") : undefined;
+                                }
+                                catch {
+                                    return undefined;
+                                }
+                            })(); const __tsf_alias = __tsf_module && __tsf_module.__tsfTypeAliases && __tsf_module.__tsfTypeAliases["Readable"]; return __tsf_alias ? Object.assign({}, __tsf_alias, { typeName: "Readable" }) : { kind: 16, typeName: "Readable", classType: () => (__tsf_module ? __tsf_module["Readable"] : undefined) }; })(), (() => { const __tsf_module = (() => {
+                                try {
+                                    return typeof require !== "undefined" ? require("node:stream") : undefined;
+                                }
+                                catch {
+                                    return undefined;
+                                }
+                            })(); const __tsf_alias = __tsf_module && __tsf_module.__tsfTypeAliases && __tsf_module.__tsfTypeAliases["Writable"]; return __tsf_alias ? Object.assign({}, __tsf_alias, { typeName: "Writable" }) : { kind: 16, typeName: "Writable", classType: () => (__tsf_module ? __tsf_module["Writable"] : undefined) }; })()] } }, optional: false }], methods: [{ name: "addStream", parameters: [{ name: "stream", type: { kind: 12, types: [(() => { const __tsf_module = (() => {
+                                    try {
+                                        return typeof require !== "undefined" ? require("node:stream") : undefined;
+                                    }
+                                    catch {
+                                        return undefined;
+                                    }
+                                })(); const __tsf_alias = __tsf_module && __tsf_module.__tsfTypeAliases && __tsf_module.__tsfTypeAliases["Readable"]; return __tsf_alias ? Object.assign({}, __tsf_alias, { typeName: "Readable" }) : { kind: 16, typeName: "Readable", classType: () => (__tsf_module ? __tsf_module["Readable"] : undefined) }; })(), (() => { const __tsf_module = (() => {
+                                    try {
+                                        return typeof require !== "undefined" ? require("node:stream") : undefined;
+                                    }
+                                    catch {
+                                        return undefined;
+                                    }
+                                })(); const __tsf_alias = __tsf_module && __tsf_module.__tsfTypeAliases && __tsf_module.__tsfTypeAliases["Writable"]; return __tsf_alias ? Object.assign({}, __tsf_alias, { typeName: "Writable" }) : { kind: 16, typeName: "Writable", classType: () => (__tsf_module ? __tsf_module["Writable"] : undefined) }; })()] }, optional: false, default: false }], returnType: { kind: 3 } }, { name: "addFile", parameters: [{ name: "file", type: { kind: 6 }, optional: false, default: false }], returnType: { kind: 3 } }, { name: "getFailure", parameters: [], returnType: { kind: 2 } }, { name: "cleanup", parameters: [], returnType: { kind: 22, type: { kind: 3 } } }], hasConstructor: false, constructorParameters: [] });
+}
+exports.ResourceTracker = ResourceTracker;
+_ResourceTrackerMetadata_1.classType = ResourceTracker;
+ResourceTracker.__tsfType = _ResourceTrackerMetadata_1;
+function withResourceCleanup(fn, onError) {
+    const tracker = new ResourceTracker();
+    return (async () => {
+        try {
+            const result = await fn(tracker);
+            const failure = tracker.getFailure();
+            if (failure !== undefined)
+                throw failure;
+            return result;
+        }
+        catch (error) {
+            onError?.(error);
+            throw error;
+        }
+        finally {
+            await tracker.cleanup();
+        }
+    })();
+}
+//# sourceMappingURL=stream.js.map

package/dist/src/helpers/io/stream.js.map

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

package/dist/src/helpers/redis/broadcast.d.ts

@@ -0,0 +1,15 @@
+import type { ReceiveType } from '../../reflection';
+interface BroadcastLogger {
+    error(...messages: unknown[]): void;
+}
+export declare function createBroadcastChannel<T>(eventName: string, _type?: ReceiveType<T>): {
+    subscribe: (fn: (data: T) => void) => void;
+    publish: (data: T) => void;
+};
+interface IDistributedMethodOptions {
+    name: string;
+    logger?: () => BroadcastLogger;
+}
+export declare function createDistributedMethod<T>(options: IDistributedMethodOptions, fn: (data: T) => Promise<void>, type?: ReceiveType<T>): (data: T) => Promise<void>;
+export {};
+//# sourceMappingURL=broadcast.d.ts.map

package/dist/src/helpers/redis/broadcast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcast.d.ts","sourceRoot":"","sources":["../../../../src/helpers/redis/broadcast.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAOpD,UAAU,eAAe;IACrB,KAAK,CAAC,GAAG,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CACvC;AAsDD,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC;IAI3E,SAAS,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI;IAQjC,OAAO,SAAS,CAAC;EAIxB;AAED,UAAU,yBAAyB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,eAAe,CAAC;CAClC;AACD,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,OAAO,EAAE,yBAAyB,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,UAgBlH,CAAC,mBAIlB"}

package/dist/src/helpers/redis/broadcast.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.__tsfTypeAliases = void 0;
+exports.createBroadcastChannel = createBroadcastChannel;
+exports.createDistributedMethod = createDistributedMethod;
+const node_os_1 = require("node:os");
+const resolver_1 = require("../../app/resolver");
+const logger_1 = require("../../services/logger");
+const redis_1 = require("./redis");
+let sharedBroadcastChannel;
+function getSharedBroadcastChannel() {
+    sharedBroadcastChannel ??= createSharedBroadcastChannel();
+    return sharedBroadcastChannel;
+}
+function createSharedBroadcastChannel() {
+    const logger = (0, resolver_1.r)(logger_1.Logger).scoped('Broadcast');
+    const { prefix, client: publishClient } = (0, redis_1.createRedis)('BROADCAST');
+    const { client: subscribeClient } = (0, redis_1.createRedis)('BROADCAST');
+    const channel = `${prefix}:broadcast`;
+    const localInstanceKey = `${(0, node_os_1.hostname)()}/${process.pid}`;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const listeners = new Map();
+    subscribeClient.subscribe(channel);
+    subscribeClient.on('message', (_, message) => {
+        try {
+            const { instanceKey, eventName, data } = JSON.parse(message);
+            if (instanceKey === localInstanceKey)
+                return;
+            const listenersForEvent = listeners.get(eventName);
+            if (!listenersForEvent)
+                return;
+            for (const listener of listenersForEvent) {
+                try {
+                    listener(data);
+                }
+                catch (err) {
+                    logger.error(`Failed to handle broadcast message`, err, { eventName });
+                }
+            }
+        }
+        catch (err) {
+            logger.error('Failed to parse broadcast message', err, message);
+        }
+    });
+    return {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        subscribe: (eventName, fn) => {
+            const listenersForEvent = listeners.get(eventName) ?? new Set();
+            listenersForEvent.add(fn);
+            listeners.set(eventName, listenersForEvent);
+        },
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        publish: (eventName, data) => {
+            publishClient.publish(channel, JSON.stringify({ instanceKey: localInstanceKey, eventName, data }));
+        }
+    };
+}
+function createBroadcastChannel(eventName, _type) {
+    const channel = getSharedBroadcastChannel();
+    return {
+        subscribe: (fn) => {
+            channel.subscribe(eventName, data => {
+                // todo: figure out type validation
+                // assert<T>(data, undefined, type);
+                fn(data);
+            });
+        },
+        publish: (data) => {
+            channel.publish(eventName, data);
+        }
+    };
+}
+function createDistributedMethod(options, fn, type) {
+    const getLogger = options.logger ?? (() => (0, resolver_1.r)(logger_1.Logger).scoped(`Distributed:${options.name}`));
+    const channel = createBroadcastChannel(options.name, type);
+    const wrappedFn = async (data) => {
+        try {
+            await fn(data);
+        }
+        catch (err) {
+            getLogger().error(`Error executing ${options.name} distributed method`, err);
+        }
+    };
+    // invoke locally when remotely requested
+    channel.subscribe(wrappedFn);
+    // publish & invoke locally when locally executed
+    return (data) => {
+        channel.publish(data);
+        return wrappedFn(data);
+    };
+}
+exports.__tsfTypeAliases = ({ "BroadcastLogger": { kind: 18, typeName: "BroadcastLogger", types: [] }, "IDistributedMethodOptions": { kind: 18, typeName: "IDistributedMethodOptions", types: [{ kind: 20, name: "name", type: { kind: 6 }, optional: false }, { kind: 20, name: "logger", type: { kind: 12, types: [{ kind: 2, typeName: "() => BroadcastLogger" }, { kind: 4 }] }, optional: true }] } });
+//# sourceMappingURL=broadcast.js.map

package/dist/src/helpers/redis/broadcast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcast.js","sourceRoot":"","sources":["../../../../src/helpers/redis/broadcast.ts"],"names":[],"mappings":";;;;;AACA,qCAAmC;AAEnC,iDAAuC;AACvC,kDAA+C;AAC/C,mCAAsC;AAMtC,IAAI,sBAAmF,CAAC;AAExF,SAAS,yBAAyB;IAC9B,sBAAsB,KAAK,4BAA4B,EAAE,CAAC;IAC1D,OAAO,sBAAsB,CAAC;AAClC,CAAC;AAED,SAAS,4BAA4B;IACjC,MAAM,MAAM,GAAG,IAAA,YAAC,EAAC,eAAM,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC7C,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,IAAA,mBAAW,EAAC,WAAW,CAAC,CAAC;IACnE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,IAAA,mBAAW,EAAC,WAAW,CAAC,CAAC;IAE7D,MAAM,OAAO,GAAG,GAAG,MAAM,YAAY,CAAC;IACtC,MAAM,gBAAgB,GAAG,GAAG,IAAA,kBAAQ,GAAE,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAExD,8DAA8D;IAC9D,MAAM,SAAS,GAAG,IAAI,GAAG,EAAuC,CAAC;IAEjE,eAAe,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACnC,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE;QACzC,IAAI,CAAC;YACD,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC7D,IAAI,WAAW,KAAK,gBAAgB;gBAAE,OAAO;YAC7C,MAAM,iBAAiB,GAAG,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACnD,IAAI,CAAC,iBAAiB;gBAAE,OAAO;YAC/B,KAAK,MAAM,QAAQ,IAAI,iBAAiB,EAAE,CAAC;gBACvC,IAAI,CAAC;oBACD,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACnB,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACX,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;gBAC3E,CAAC;YACL,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QACpE,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO;QACH,8DAA8D;QAC9D,SAAS,EAAE,CAAC,SAAiB,EAAE,EAAuB,EAAE,EAAE;YACtD,MAAM,iBAAiB,GAAG,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;YAChE,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC1B,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;QAChD,CAAC;QAED,8DAA8D;QAC9D,OAAO,EAAE,CAAC,SAAiB,EAAE,IAAS,EAAE,EAAE;YACtC,aAAa,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,gBAAgB,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACvG,CAAC;KACJ,CAAC;AACN,CAAC;AAED,gCAA0C,SAAiB,EAAE,KAAsB;IAC/E,MAAM,OAAO,GAAG,yBAAyB,EAAE,CAAC;IAE5C,OAAO;QACH,SAAS,EAAE,CAAC,EAAqB,EAAE,EAAE;YACjC,OAAO,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE;gBAChC,mCAAmC;gBACnC,oCAAoC;gBACpC,EAAE,CAAC,IAAI,CAAC,CAAC;YACb,CAAC,CAAC,CAAC;QACP,CAAC;QAED,OAAO,EAAE,CAAC,IAAO,EAAE,EAAE;YACjB,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACrC,CAAC;KACJ,CAAC;AACN,CAAC;AAMD,iCAA2C,OAAkC,EAAE,EAA8B,EAAE,IAAqB;IAChI,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,IAAA,YAAC,EAAC,eAAM,CAAC,CAAC,MAAM,CAAC,eAAe,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC5F,MAAM,OAAO,GAAG,sBAAsB,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAE3D,MAAM,SAAS,GAAG,KAAK,EAAE,IAAO,EAAE,EAAE;QAChC,IAAI,CAAC;YACD,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,SAAS,EAAE,CAAC,KAAK,CAAC,mBAAmB,OAAO,CAAC,IAAI,qBAAqB,EAAE,GAAG,CAAC,CAAC;QACjF,CAAC;IACL,CAAC,CAAC;IAEF,yCAAyC;IACzC,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IAE7B,iDAAiD;IACjD,OAAO,CAAC,IAAO,EAAE,EAAE;QACf,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACtB,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC,CAAC;AACN,CAAC"}

package/dist/src/helpers/redis/cache.d.ts

@@ -0,0 +1,20 @@
+import { type RedisConnection } from './redis';
+export interface CacheRedisClient {
+    get(key: string): Promise<string | null> | string | null;
+    set(key: string, value: string, mode: 'EX', ttl: number): Promise<unknown> | unknown;
+}
+export type CacheRedisProvider = () => RedisConnection<CacheRedisClient>;
+export declare function resetCacheRedisConnection(): void;
+export declare class Cache {
+    private readonly getRedis;
+    constructor(getRedis?: CacheRedisProvider);
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, ttl?: number): Promise<void>;
+    getObj<T>(key: string): Promise<T | null>;
+    setObj<T>(key: string, value: T, ttl?: number): Promise<void>;
+    static get(key: string): Promise<string | null>;
+    static set(key: string, value: string, ttl?: number): Promise<void>;
+    static getObj<T>(key: string): Promise<T | null>;
+    static setObj<T>(key: string, value: T, ttl?: number): Promise<void>;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/src/helpers/redis/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../../src/helpers/redis/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;AAE5D,MAAM,WAAW,gBAAgB;IAC7B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;IACzD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CACxF;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,eAAe,CAAC,gBAAgB,CAAC,CAAC;AASzE,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAED,qBAAa,KAAK;IACF,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAArC,YAA6B,QAAQ,GAAE,kBAA8C,EAAI;IAEnF,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAG7C;IAEK,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,SAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAG7D;IAEK,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAG9C;IAEK,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,SAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;IAED,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAE9C;IAED,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,SAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;IAED,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAE/C;IAED,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,SAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/D;CACJ"}

package/dist/src/helpers/redis/cache.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.__tsfTypeAliases = exports.Cache = void 0;
+exports.resetCacheRedisConnection = resetCacheRedisConnection;
+const redis_1 = require("./redis");
+let defaultRedisConnection;
+function getDefaultRedisConnection() {
+    defaultRedisConnection ??= (0, redis_1.createRedis)('CACHE');
+    return defaultRedisConnection;
+}
+function resetCacheRedisConnection() {
+    defaultRedisConnection = undefined;
+}
+let _CacheMetadata_1;
+class Cache {
+    getRedis;
+    constructor(getRedis = getDefaultRedisConnection) {
+        this.getRedis = getRedis;
+    }
+    async get(key) {
+        const { client, prefix } = this.getRedis();
+        return client.get(cacheKey(prefix, key));
+    }
+    async set(key, value, ttl = 60) {
+        const { client, prefix } = this.getRedis();
+        await client.set(cacheKey(prefix, key), value, 'EX', ttl);
+    }
+    async getObj(key) {
+        const value = await this.get(key);
+        return value ? JSON.parse(value) : null;
+    }
+    async setObj(key, value, ttl = 60) {
+        await this.set(key, JSON.stringify(value), ttl);
+    }
+    static get(key) {
+        return defaultCache.get(key);
+    }
+    static set(key, value, ttl = 60) {
+        return defaultCache.set(key, value, ttl);
+    }
+    static getObj(key) {
+        return defaultCache.getObj(key);
+    }
+    static setObj(key, value, ttl = 60) {
+        return defaultCache.setObj(key, value, ttl);
+    }
+    static __tsfType = _CacheMetadata_1 = ({ kind: 16, name: "Cache", typeName: "Cache", classType: () => Cache, properties: [], methods: [{ name: "get", parameters: [{ name: "key", type: { kind: 6 }, optional: false, default: false }], returnType: { kind: 22, type: { kind: 12, types: [{ kind: 6 }, { kind: 5 }] } } }, { name: "set", parameters: [{ name: "key", type: { kind: 6 }, optional: false, default: false }, { name: "value", type: { kind: 6 }, optional: false, default: false }, { name: "ttl", type: { kind: 2 }, optional: true, default: true }], returnType: { kind: 22, type: { kind: 3 } } }, { name: "getObj", parameters: [{ name: "key", type: { kind: 6 }, optional: false, default: false }], returnType: { kind: 22, type: { kind: 12, types: [{ kind: 2, typeName: "T" }, { kind: 5 }] } } }, { name: "setObj", parameters: [{ name: "key", type: { kind: 6 }, optional: false, default: false }, { name: "value", type: { kind: 2, typeName: "T" }, optional: false, default: false }, { name: "ttl", type: { kind: 2 }, optional: true, default: true }], returnType: { kind: 22, type: { kind: 3 } } }], hasConstructor: true, constructorParameters: [{ name: "getRedis", type: { kind: 2, typeName: "() => RedisConnection<CacheRedisClient>", typeName: "CacheRedisProvider" }, optional: true, default: true }] });
+}
+exports.Cache = Cache;
+_CacheMetadata_1.classType = Cache;
+Cache.__tsfType = _CacheMetadata_1;
+function cacheKey(prefix, key) {
+    return `${prefix}:cache:${key}`;
+}
+const defaultCache = new Cache(getDefaultRedisConnection);
+exports.__tsfTypeAliases = ({ "CacheRedisClient": { kind: 18, typeName: "CacheRedisClient", types: [] }, "CacheRedisProvider": { kind: 2, typeName: "() => RedisConnection<CacheRedisClient>", typeName: "CacheRedisProvider" } });
+//# sourceMappingURL=cache.js.map

package/dist/src/helpers/redis/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../../src/helpers/redis/cache.ts"],"names":[],"mappings":";;;;AAAA,mCAA4D;AAS5D,IAAI,sBAAqE,CAAC;AAE1E,SAAS,yBAAyB;IAC9B,sBAAsB,KAAK,IAAA,mBAAW,EAAC,OAAO,CAAsC,CAAC;IACrF,OAAO,sBAAsB,CAAC;AAClC,CAAC;AAED;IACI,sBAAsB,GAAG,SAAS,CAAC;AACvC,CAAC;;AAED;IACiC,QAAQ;IAArC,YAA6B,QAAQ,GAAuB,yBAAyB;wBAAxD,QAAQ;IAAmD,CAAC;IAEzF,KAAK,CAAC,GAAG,CAAC,GAAW;QACjB,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC3C,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAa,EAAE,GAAG,GAAG,EAAE;QAC1C,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC3C,MAAM,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,MAAM,CAAI,GAAW;QACvB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,OAAO,KAAK,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,MAAM,CAAI,GAAW,EAAE,KAAQ,EAAE,GAAG,GAAG,EAAE;QAC3C,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,CAAC,GAAG,CAAC,GAAW;QAClB,OAAO,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,CAAC,GAAG,CAAC,GAAW,EAAE,KAAa,EAAE,GAAG,GAAG,EAAE;QAC3C,OAAO,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,CAAC,MAAM,CAAI,GAAW;QACxB,OAAO,YAAY,CAAC,MAAM,CAAI,GAAG,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,CAAC,MAAM,CAAI,GAAW,EAAE,KAAQ,EAAE,GAAG,GAAG,EAAE;QAC5C,OAAO,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;IAChD,CAAC;;CACJ;;;;AAED,SAAS,QAAQ,CAAC,MAAc,EAAE,GAAW;IACzC,OAAO,GAAG,MAAM,UAAU,GAAG,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,YAAY,GAAG,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC"}

package/dist/src/helpers/redis/mutex.d.ts

@@ -0,0 +1,45 @@
+import { type RedisConnection } from './redis';
+export type MutexKey = any;
+export interface MutexContext {
+    key: string;
+    lockId?: string;
+    signal: AbortSignal;
+    assertNotAborted(): void;
+}
+export type MutexFn<R = unknown> = (didWait: boolean, context?: MutexContext) => Promise<R>;
+export interface MutexOptions<T> {
+    key: MutexKey | MutexKey[];
+    fn: MutexFn<T>;
+    retryCount?: number;
+    retryDelay?: number;
+    renewInterval?: number;
+    mode?: 'local' | 'redis';
+    redis?: RedisMutexProvider;
+    signal?: AbortSignal;
+}
+export interface RedisMutexClient {
+    eval(script: string, numberOfKeys: 1, key: string, ...args: Array<string | number>): Promise<unknown> | unknown;
+}
+export type RedisMutexProvider = () => RedisConnection<RedisMutexClient>;
+export interface MutexObservation {
+    id: string;
+    key: string;
+    mode: 'local' | 'redis';
+    type: 'pending' | 'acquired' | 'released' | 'error' | 'failed';
+    startedAt: number;
+    at: number;
+    waited?: boolean;
+    error?: unknown;
+}
+export type MutexObserver = (entry: MutexObservation) => void;
+export declare class MutexAcquisitionError extends Error {
+    constructor(message?: string);
+}
+export declare function withMutex<T>(options: MutexOptions<T>): Promise<T>;
+export declare function registerMutexObserver(observer: MutexObserver): () => void;
+export declare function withMutexes<T>(options: Omit<MutexOptions<T>, 'key'> & {
+    keys: Array<MutexOptions<T>['key']>;
+}): Promise<T>;
+export declare function flattenMutexKey(key: MutexKey | MutexKey[]): string;
+export declare function resetMutexRedisConnection(): void;
+//# sourceMappingURL=mutex.d.ts.map

package/dist/src/helpers/redis/mutex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutex.d.ts","sourceRoot":"","sources":["../../../../src/helpers/redis/mutex.ts"],"names":[],"mappings":"AAIA,OAAO,EAAe,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;AAE5D,MAAM,MAAM,QAAQ,GAAG,GAAG,CAAC;AAC3B,MAAM,WAAW,YAAY;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,CAAC;IACpB,gBAAgB,IAAI,IAAI,CAAC;CAC5B;AACD,MAAM,MAAM,OAAO,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAE5F,MAAM,WAAW,YAAY,CAAC,CAAC;IAC3B,GAAG,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAAC;IAC3B,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,MAAM,CAAC,EAAE,WAAW,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC7B,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CACnH;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,eAAe,CAAC,gBAAgB,CAAC,CAAC;AAEzE,MAAM,WAAW,gBAAgB;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACxB,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAkC9D,qBAAa,qBAAsB,SAAQ,KAAK;IAC5C,YAAY,OAAO,SAA2C,EAG7D;CACJ;AAED,wBAAsB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAQvE;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,IAAI,CAGzE;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG;IAAE,IAAI,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAA;CAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAE1H;AAuBD,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,GAAG,QAAQ,EAAE,GAAG,MAAM,CAelE;AAgWD,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}