@zyno-io/ts-server-foundation 26.712.36

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

@@ -0,0 +1,446 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.__tsfTypeAliases = exports.MutexAcquisitionError = void 0;
+exports.withMutex = withMutex;
+exports.registerMutexObserver = registerMutexObserver;
+exports.withMutexes = withMutexes;
+exports.flattenMutexKey = flattenMutexKey;
+exports.resetMutexRedisConnection = resetMutexRedisConnection;
+const node_crypto_1 = require("node:crypto");
+const resolver_1 = require("../../app/resolver");
+const date_1 = require("../utils/date");
+const redis_1 = require("./redis");
+const DefaultMutexOptions = {
+    retryCount: 30,
+    retryDelay: 1000,
+    renewInterval: 1000
+};
+const localMutexes = new Map();
+let defaultRedisConnection;
+const mutexObservers = new Set();
+const ACQUIRE_SCRIPT = `
+if redis.call("exists", KEYS[1]) == 1 then
+    return 0
+end
+redis.call("set", KEYS[1], ARGV[1], "px", ARGV[2])
+return 1
+`;
+const RENEW_SCRIPT = `
+if redis.call("get", KEYS[1]) ~= ARGV[1] then
+    return 0
+end
+redis.call("pexpire", KEYS[1], ARGV[2])
+return 1
+`;
+const RELEASE_SCRIPT = `
+if redis.call("get", KEYS[1]) ~= ARGV[1] then
+    return 0
+end
+redis.call("del", KEYS[1])
+return 1
+`;
+let _MutexAcquisitionErrorMetadata_1;
+class MutexAcquisitionError extends Error {
+    constructor(message = 'Failed to acquire mutex within timeout') {
+        super(message);
+        this.name = 'MutexAcquisitionError';
+    }
+    static __tsfType = _MutexAcquisitionErrorMetadata_1 = ({ kind: 16, name: "MutexAcquisitionError", typeName: "MutexAcquisitionError", classType: () => MutexAcquisitionError, properties: [], methods: [], hasConstructor: true, constructorParameters: [{ name: "message", type: { kind: 2 }, optional: true, default: true }] });
+}
+exports.MutexAcquisitionError = MutexAcquisitionError;
+_MutexAcquisitionErrorMetadata_1.classType = MutexAcquisitionError;
+MutexAcquisitionError.__tsfType = _MutexAcquisitionErrorMetadata_1;
+async function withMutex(options) {
+    const resolved = { ...DefaultMutexOptions, ...options };
+    const key = flattenMutexKey(resolved.key);
+    const mode = resolved.mode ?? getConfiguredMutexMode();
+    if (mode === 'redis')
+        return redisMutexExec(key, resolved);
+    return localMutexExec(key, resolved);
+}
+function registerMutexObserver(observer) {
+    mutexObservers.add(observer);
+    return () => mutexObservers.delete(observer);
+}
+function withMutexes(options) {
+    return withMutexesInternal({ ...options, keys: orderMutexKeys(options.keys) }, 0, false, []);
+}
+function withMutexesInternal(options, index, didAnyWait, contexts) {
+    const currentKey = options.keys[index];
+    const parentContext = createCompositeMutexContext(contexts, options.signal);
+    parentContext.assertNotAborted();
+    if (currentKey === undefined)
+        return options.fn(didAnyWait, parentContext);
+    return withMutex({
+        ...options,
+        key: currentKey,
+        signal: parentContext.signal,
+        fn: (didWait, context) => {
+            return withMutexesInternal(options, index + 1, didAnyWait || didWait, [...contexts, context]);
+        }
+    });
+}
+function flattenMutexKey(key) {
+    if (Array.isArray(key))
+        return key.map(part => flattenMutexKey(part)).join(':');
+    if (key === null)
+        return 'null';
+    if (typeof key === 'object') {
+        if ('name' in key && typeof key.name === 'string')
+            return key.name;
+        const constructorName = key.constructor?.name;
+        if (constructorName && constructorName !== 'Object')
+            return constructorName;
+        const jsonKey = JSON.stringify(key);
+        const objectKey = jsonKey && jsonKey !== '{}' ? jsonKey : String(key);
+        return (0, node_crypto_1.createHash)('md5').update(objectKey).digest('hex');
+    }
+    return String(key);
+}
+async function localMutexExec(key, options) {
+    const observationId = (0, node_crypto_1.randomUUID)();
+    const startedAt = Date.now();
+    const deadline = Date.now() + options.retryCount * options.retryDelay;
+    let didWait = false;
+    let acquired = false;
+    notifyMutexObservers({
+        id: observationId,
+        key,
+        mode: 'local',
+        type: 'pending',
+        startedAt,
+        at: startedAt
+    });
+    try {
+        while (localMutexes.has(key)) {
+            throwIfSignalAborted(options.signal, key);
+            didWait = true;
+            const current = localMutexes.get(key);
+            const remaining = deadline - Date.now();
+            if (remaining <= 0)
+                throw new MutexAcquisitionError();
+            await Promise.race([current.catch(() => { }), sleepOrAbort(Math.min(options.retryDelay, remaining), options.signal, key)]);
+        }
+        throwIfSignalAborted(options.signal, key);
+    }
+    catch (error) {
+        notifyMutexObservers({
+            id: observationId,
+            key,
+            mode: 'local',
+            type: 'failed',
+            startedAt,
+            at: Date.now(),
+            waited: didWait,
+            error
+        });
+        throw error;
+    }
+    let release;
+    const lock = new Promise(resolve => {
+        release = resolve;
+    });
+    localMutexes.set(key, lock);
+    acquired = true;
+    notifyMutexObservers({
+        id: observationId,
+        key,
+        mode: 'local',
+        type: 'acquired',
+        startedAt,
+        at: Date.now(),
+        waited: didWait
+    });
+    try {
+        const context = createMutexContext(key, undefined, new AbortController(), options.signal);
+        context.assertNotAborted();
+        return await options.fn(didWait, context);
+    }
+    catch (error) {
+        notifyMutexObservers({
+            id: observationId,
+            key,
+            mode: 'local',
+            type: 'error',
+            startedAt,
+            at: Date.now(),
+            waited: didWait,
+            error
+        });
+        throw error;
+    }
+    finally {
+        if (localMutexes.get(key) === lock) {
+            localMutexes.delete(key);
+            release();
+        }
+        if (acquired)
+            notifyMutexObservers({
+                id: observationId,
+                key,
+                mode: 'local',
+                type: 'released',
+                startedAt,
+                at: Date.now(),
+                waited: didWait
+            });
+    }
+}
+async function redisMutexExec(key, options) {
+    const observationId = (0, node_crypto_1.randomUUID)();
+    const startedAt = Date.now();
+    const lockId = (0, node_crypto_1.randomUUID)();
+    const { client, prefix } = (options.redis ?? getDefaultRedisConnection)();
+    const redisKey = `${prefix}:${key}`;
+    const lockTtl = options.renewInterval * 3;
+    const maxAttempts = Math.max(1, options.retryCount);
+    let acquired = false;
+    notifyMutexObservers({
+        id: observationId,
+        key: redisKey,
+        mode: 'redis',
+        type: 'pending',
+        startedAt,
+        at: startedAt
+    });
+    try {
+        for (let attempts = 1; attempts <= maxAttempts; attempts++) {
+            throwIfSignalAborted(options.signal, redisKey);
+            if (Number(await evalRedisScript(client, ACQUIRE_SCRIPT, redisKey, lockId, lockTtl)) === 1) {
+                acquired = true;
+                notifyMutexObservers({
+                    id: observationId,
+                    key: redisKey,
+                    mode: 'redis',
+                    type: 'acquired',
+                    startedAt,
+                    at: Date.now(),
+                    waited: attempts > 1
+                });
+                const result = await runWithRedisLock(client, redisKey, lockId, lockTtl, options.renewInterval, context => options.fn(attempts > 1, context), options.signal);
+                notifyMutexObservers({
+                    id: observationId,
+                    key: redisKey,
+                    mode: 'redis',
+                    type: 'released',
+                    startedAt,
+                    at: Date.now(),
+                    waited: attempts > 1
+                });
+                return result;
+            }
+            if (attempts < maxAttempts) {
+                await sleepOrAbort(options.retryDelay, options.signal, redisKey);
+            }
+        }
+        throw new MutexAcquisitionError();
+    }
+    catch (error) {
+        notifyMutexObservers({
+            id: observationId,
+            key: redisKey,
+            mode: 'redis',
+            type: acquired ? 'error' : 'failed',
+            startedAt,
+            at: Date.now(),
+            error
+        });
+        throw error;
+    }
+}
+async function runWithRedisLock(client, key, lockId, lockTtl, renewInterval, fn, parentSignal) {
+    throwIfSignalAborted(parentSignal, key);
+    const abortController = new AbortController();
+    let rejectRenewal;
+    const renewalFailure = new Promise((_, reject) => {
+        rejectRenewal = reject;
+    });
+    const context = createMutexContext(key, lockId, abortController);
+    let lockFailed = false;
+    let interval;
+    const failLock = (error) => {
+        if (lockFailed)
+            return;
+        lockFailed = true;
+        if (interval)
+            clearInterval(interval);
+        rejectRenewal(error);
+        abortController.abort(error);
+    };
+    const abortFromParent = () => failLock(getAbortError(parentSignal, key));
+    parentSignal?.addEventListener('abort', abortFromParent, { once: true });
+    interval = setInterval(() => {
+        evalRedisScript(client, RENEW_SCRIPT, key, lockId, lockTtl)
+            .then(result => {
+            if (Number(result) !== 1)
+                failLock(new MutexAcquisitionError(`Key missing or value mismatch for ${key}`));
+        })
+            .catch(error => failLock(new MutexAcquisitionError(`Failed to renew mutex ${key} ${lockId}: ${String(error)}`)));
+    }, Math.max(1, Math.floor(renewInterval / 2)));
+    const callback = Promise.resolve().then(() => {
+        context.assertNotAborted();
+        return fn(context);
+    });
+    let lockError;
+    let result;
+    let errorToThrow;
+    try {
+        result = await Promise.race([
+            callback,
+            renewalFailure.catch(error => {
+                lockError = error;
+                throw error;
+            })
+        ]);
+    }
+    catch (error) {
+        if (lockError !== undefined)
+            await callback.catch(() => { });
+        errorToThrow = error;
+    }
+    finally {
+        parentSignal?.removeEventListener('abort', abortFromParent);
+        if (interval)
+            clearInterval(interval);
+        const releaseResult = await evalRedisScript(client, RELEASE_SCRIPT, key, lockId).catch(error => {
+            console.warn(`Failed to release mutex ${key} ${lockId}`, error);
+            return undefined;
+        });
+        if (releaseResult !== undefined && Number(releaseResult) !== 1 && !lockFailed && errorToThrow === undefined) {
+            errorToThrow = new MutexAcquisitionError(`Failed to release mutex ${key} ${lockId}: key missing or value mismatch`);
+        }
+    }
+    if (errorToThrow !== undefined)
+        throw errorToThrow;
+    return result;
+}
+function createMutexContext(key, lockId, abortController = new AbortController(), parentSignal) {
+    if (parentSignal?.aborted)
+        abortController.abort(parentSignal.reason);
+    else
+        parentSignal?.addEventListener('abort', () => abortController.abort(parentSignal.reason), {
+            once: true
+        });
+    return {
+        key,
+        lockId,
+        signal: abortController.signal,
+        assertNotAborted() {
+            if (!abortController.signal.aborted)
+                return;
+            const reason = abortController.signal.reason;
+            throw reason instanceof Error ? reason : new MutexAcquisitionError(`Mutex ${key} was aborted`);
+        }
+    };
+}
+function createCompositeMutexContext(contexts, parentSignal) {
+    if (contexts.length === 0)
+        return createMutexContext('', undefined, new AbortController(), parentSignal);
+    if (contexts.length === 1 && !parentSignal)
+        return contexts[0];
+    const abortController = new AbortController();
+    for (const context of contexts) {
+        if (context.signal.aborted) {
+            abortCompositeMutexContext(abortController, context);
+            break;
+        }
+        context.signal.addEventListener('abort', () => abortCompositeMutexContext(abortController, context), { once: true });
+    }
+    if (parentSignal?.aborted)
+        abortController.abort(parentSignal.reason);
+    else
+        parentSignal?.addEventListener('abort', () => abortController.abort(parentSignal.reason), {
+            once: true
+        });
+    return {
+        key: contexts.map(context => context.key).join(','),
+        signal: abortController.signal,
+        assertNotAborted() {
+            for (const context of contexts)
+                context.assertNotAborted();
+            throwIfSignalAborted(parentSignal, contexts.map(context => context.key).join(','));
+            if (!abortController.signal.aborted)
+                return;
+            const reason = abortController.signal.reason;
+            throw reason instanceof Error ? reason : new MutexAcquisitionError('Mutex group was aborted');
+        }
+    };
+}
+function abortCompositeMutexContext(abortController, context) {
+    if (abortController.signal.aborted)
+        return;
+    abortController.abort(context.signal.reason);
+}
+function orderMutexKeys(keys) {
+    const seen = new Set();
+    return [...keys]
+        .map(key => ({ key, flattened: flattenMutexKey(key) }))
+        .sort((a, b) => a.flattened.localeCompare(b.flattened))
+        .filter(({ flattened }) => {
+        if (seen.has(flattened))
+            return false;
+        seen.add(flattened);
+        return true;
+    })
+        .map(({ key }) => key);
+}
+function evalRedisScript(client, script, key, ...args) {
+    return Promise.resolve().then(() => client.eval(script, 1, key, ...args));
+}
+function sleepOrAbort(ms, signal, key) {
+    if (!signal)
+        return (0, date_1.sleepMs)(ms);
+    return new Promise((resolve, reject) => {
+        if (signal.aborted) {
+            reject(getAbortError(signal, key));
+            return;
+        }
+        const cleanup = () => signal.removeEventListener('abort', handleAbort);
+        const timeout = setTimeout(() => {
+            cleanup();
+            resolve();
+        }, ms);
+        const handleAbort = () => {
+            clearTimeout(timeout);
+            cleanup();
+            reject(getAbortError(signal, key));
+        };
+        signal.addEventListener('abort', handleAbort, { once: true });
+    });
+}
+function throwIfSignalAborted(signal, key) {
+    if (!signal?.aborted)
+        return;
+    throw getAbortError(signal, key);
+}
+function getAbortError(signal, key) {
+    const reason = signal?.reason;
+    return reason instanceof Error ? reason : new MutexAcquisitionError(`Mutex ${key} was aborted`);
+}
+function getDefaultRedisConnection() {
+    defaultRedisConnection ??= (0, redis_1.createRedis)('MUTEX');
+    return defaultRedisConnection;
+}
+function resetMutexRedisConnection() {
+    defaultRedisConnection = undefined;
+}
+function notifyMutexObservers(entry) {
+    for (const observer of mutexObservers) {
+        try {
+            observer(entry);
+        }
+        catch {
+            // Observers must never affect mutex behavior.
+        }
+    }
+}
+function getConfiguredMutexMode() {
+    try {
+        return (0, resolver_1.getAppConfig)().MUTEX_MODE ?? 'local';
+    }
+    catch {
+        return 'local';
+    }
+}
+exports.__tsfTypeAliases = ({ "MutexContext": { kind: 18, typeName: "MutexContext", types: [{ kind: 20, name: "key", type: { kind: 6 }, optional: false }, { kind: 20, name: "lockId", type: { kind: 12, types: [{ kind: 6 }, { kind: 4 }] }, optional: true }, { kind: 20, name: "signal", type: { kind: 16, typeName: "AbortSignal", classType: () => (typeof AbortSignal !== "undefined" ? AbortSignal : (typeof exports !== "undefined" ? exports.AbortSignal : undefined)) }, optional: false }] }, "MutexKey": { kind: 1, typeName: "MutexKey" }, "MutexObservation": { kind: 18, typeName: "MutexObservation", types: [{ kind: 20, name: "id", type: { kind: 6 }, optional: false }, { kind: 20, name: "key", type: { kind: 6 }, optional: false }, { kind: 20, name: "mode", type: { kind: 12, types: [{ kind: 10, literal: "local" }, { kind: 10, literal: "redis" }] }, optional: false }, { kind: 20, name: "type", type: { kind: 12, types: [{ kind: 10, literal: "pending" }, { kind: 10, literal: "acquired" }, { kind: 10, literal: "released" }, { kind: 10, literal: "error" }, { kind: 10, literal: "failed" }] }, optional: false }, { kind: 20, name: "startedAt", type: { kind: 7 }, optional: false }, { kind: 20, name: "at", type: { kind: 7 }, optional: false }, { kind: 20, name: "waited", type: { kind: 12, types: [{ kind: 8 }, { kind: 4 }] }, optional: true }, { kind: 20, name: "error", type: { kind: 12, types: [{ kind: 2 }, { kind: 4 }] }, optional: true }] }, "MutexObserver": { kind: 2, typeName: "(entry: MutexObservation) => void", typeName: "MutexObserver" }, "MutexOptions": { kind: 18, typeName: "MutexOptions", types: [{ kind: 20, name: "key", type: { kind: 12, types: [{ kind: 1, typeName: "MutexKey" }, { kind: 14, type: { kind: 1, typeName: "MutexKey" } }] }, optional: false }, { kind: 20, name: "fn", type: { kind: 2, typeName: "MutexFn", typeArguments: [{ kind: 2, typeName: "T" }] }, optional: false }, { kind: 20, name: "retryCount", type: { kind: 12, types: [{ kind: 7 }, { kind: 4 }] }, optional: true }, { kind: 20, name: "retryDelay", type: { kind: 12, types: [{ kind: 7 }, { kind: 4 }] }, optional: true }, { kind: 20, name: "renewInterval", type: { kind: 12, types: [{ kind: 7 }, { kind: 4 }] }, optional: true }, { kind: 20, name: "mode", type: { kind: 12, types: [{ kind: 12, types: [{ kind: 10, literal: "local" }, { kind: 10, literal: "redis" }] }, { kind: 4 }] }, optional: true }, { kind: 20, name: "redis", type: { kind: 12, types: [{ kind: 2, typeName: "() => RedisConnection<RedisMutexClient>", typeName: "RedisMutexProvider" }, { kind: 4 }] }, optional: true }, { kind: 20, name: "signal", type: { kind: 12, types: [{ kind: 16, typeName: "AbortSignal", classType: () => (typeof AbortSignal !== "undefined" ? AbortSignal : (typeof exports !== "undefined" ? exports.AbortSignal : undefined)) }, { kind: 4 }] }, optional: true }] }, "RedisMutexClient": { kind: 18, typeName: "RedisMutexClient", types: [] }, "RedisMutexProvider": { kind: 2, typeName: "() => RedisConnection<RedisMutexClient>", typeName: "RedisMutexProvider" } });
+//# sourceMappingURL=mutex.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mutex.js","sourceRoot":"","sources":["../../../../src/helpers/redis/mutex.ts"],"names":[],"mappings":";;;;;;;;AAAA,6CAAqD;AAErD,iDAAkD;AAClD,wCAAwC;AACxC,mCAA4D;AAyC5D,MAAM,mBAAmB,GAAG;IACxB,UAAU,EAAE,EAAE;IACd,UAAU,EAAE,IAAI;IAChB,aAAa,EAAE,IAAI;CACtB,CAAC;AAEF,MAAM,YAAY,GAAG,IAAI,GAAG,EAAyB,CAAC;AACtD,IAAI,sBAAqE,CAAC;AAC1E,MAAM,cAAc,GAAG,IAAI,GAAG,EAAiB,CAAC;AAEhD,MAAM,cAAc,GAAG;;;;;;CAMtB,CAAC;AACF,MAAM,YAAY,GAAG;;;;;;CAMpB,CAAC;AACF,MAAM,cAAc,GAAG;;;;;;CAMtB,CAAC;;AAEF,2BAAmC,SAAQ,KAAK;IAC5C,YAAY,OAAO,GAAG,wCAAwC;QAC1D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACxC,CAAC;;CACJ;;;;AAEM,KAAK,oBAAuB,OAAwB;IACvD,MAAM,QAAQ,GAAG,EAAE,GAAG,mBAAmB,EAAE,GAAG,OAAO,EAAE,CAAC;IACxD,MAAM,GAAG,GAAG,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,IAAI,sBAAsB,EAAE,CAAC;IAEvD,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,cAAc,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAE3D,OAAO,cAAc,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AACzC,CAAC;AAED,+BAAsC,QAAuB;IACzD,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC7B,OAAO,GAAG,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACjD,CAAC;AAED,qBAA+B,OAA+E;IAC1G,OAAO,mBAAmB,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;AACjG,CAAC;AAED,SAAS,mBAAmB,CACxB,OAA+E,EAC/E,KAAa,EACb,UAAmB,EACnB,QAAwB;IAExB,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,aAAa,GAAG,2BAA2B,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5E,aAAa,CAAC,gBAAgB,EAAE,CAAC;IACjC,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IAE3E,OAAO,SAAS,CAAC;QACb,GAAG,OAAO;QACV,GAAG,EAAE,UAAU;QACf,MAAM,EAAE,aAAa,CAAC,MAAM;QAC5B,EAAE,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;YACrB,OAAO,mBAAmB,CAAC,OAAO,EAAE,KAAK,GAAG,CAAC,EAAE,UAAU,IAAI,OAAO,EAAE,CAAC,GAAG,QAAQ,EAAE,OAAQ,CAAC,CAAC,CAAC;QACnG,CAAC;KACJ,CAAC,CAAC;AACP,CAAC;AAED,yBAAgC,GAA0B;IACtD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChF,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAEhC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC1B,IAAI,MAAM,IAAI,GAAG,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,GAAG,CAAC,IAAI,CAAC;QACnE,MAAM,eAAe,GAAG,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC;QAC9C,IAAI,eAAe,IAAI,eAAe,KAAK,QAAQ;YAAE,OAAO,eAAe,CAAC;QAE5E,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACpC,MAAM,SAAS,GAAG,OAAO,IAAI,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACtE,OAAO,IAAA,wBAAU,EAAC,KAAK,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC;AAED,KAAK,UAAU,cAAc,CACzB,GAAW,EACX,OAAgH;IAEhH,MAAM,aAAa,GAAG,IAAA,wBAAU,GAAE,CAAC;IACnC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACtE,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,oBAAoB,CAAC;QACjB,EAAE,EAAE,aAAa;QACjB,GAAG;QACH,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,SAAS;QACf,SAAS;QACT,EAAE,EAAE,SAAS;KAChB,CAAC,CAAC;IAEH,IAAI,CAAC;QACD,OAAO,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,oBAAoB,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YAC1C,OAAO,GAAG,IAAI,CAAC;YACf,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;YACvC,MAAM,SAAS,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACxC,IAAI,SAAS,IAAI,CAAC;gBAAE,MAAM,IAAI,qBAAqB,EAAE,CAAC;YACtD,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,EAAE,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;QAC9H,CAAC;QACD,oBAAoB,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,oBAAoB,CAAC;YACjB,EAAE,EAAE,aAAa;YACjB,GAAG;YACH,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,QAAQ;YACd,SAAS;YACT,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;YACd,MAAM,EAAE,OAAO;YACf,KAAK;SACR,CAAC,CAAC;QACH,MAAM,KAAK,CAAC;IAChB,CAAC;IAED,IAAI,OAAoB,CAAC;IACzB,MAAM,IAAI,GAAG,IAAI,OAAO,CAAO,OAAO,CAAC,EAAE;QACrC,OAAO,GAAG,OAAO,CAAC;IACtB,CAAC,CAAC,CAAC;IACH,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC5B,QAAQ,GAAG,IAAI,CAAC;IAChB,oBAAoB,CAAC;QACjB,EAAE,EAAE,aAAa;QACjB,GAAG;QACH,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,UAAU;QAChB,SAAS;QACT,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;QACd,MAAM,EAAE,OAAO;KAClB,CAAC,CAAC;IAEH,IAAI,CAAC;QACD,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,eAAe,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC1F,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC3B,OAAO,MAAM,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,oBAAoB,CAAC;YACjB,EAAE,EAAE,aAAa;YACjB,GAAG;YACH,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,OAAO;YACb,SAAS;YACT,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;YACd,MAAM,EAAE,OAAO;YACf,KAAK;SACR,CAAC,CAAC;QACH,MAAM,KAAK,CAAC;IAChB,CAAC;YAAS,CAAC;QACP,IAAI,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;YACjC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,OAAO,EAAE,CAAC;QACd,CAAC;QACD,IAAI,QAAQ;YACR,oBAAoB,CAAC;gBACjB,EAAE,EAAE,aAAa;gBACjB,GAAG;gBACH,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,UAAU;gBAChB,SAAS;gBACT,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;gBACd,MAAM,EAAE,OAAO;aAClB,CAAC,CAAC;IACX,CAAC;AACL,CAAC;AAED,KAAK,UAAU,cAAc,CACzB,GAAW,EACX,OAAgH;IAEhH,MAAM,aAAa,GAAG,IAAA,wBAAU,GAAE,CAAC;IACnC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,IAAA,wBAAU,GAAE,CAAC;IAC5B,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,yBAAyB,CAAC,EAAE,CAAC;IAC1E,MAAM,QAAQ,GAAG,GAAG,MAAM,IAAI,GAAG,EAAE,CAAC;IACpC,MAAM,OAAO,GAAG,OAAO,CAAC,aAAa,GAAG,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IACpD,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,oBAAoB,CAAC;QACjB,EAAE,EAAE,aAAa;QACjB,GAAG,EAAE,QAAQ;QACb,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,SAAS;QACf,SAAS;QACT,EAAE,EAAE,SAAS;KAChB,CAAC,CAAC;IAEH,IAAI,CAAC;QACD,KAAK,IAAI,QAAQ,GAAG,CAAC,EAAE,QAAQ,IAAI,WAAW,EAAE,QAAQ,EAAE,EAAE,CAAC;YACzD,oBAAoB,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAC/C,IAAI,MAAM,CAAC,MAAM,eAAe,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzF,QAAQ,GAAG,IAAI,CAAC;gBAChB,oBAAoB,CAAC;oBACjB,EAAE,EAAE,aAAa;oBACjB,GAAG,EAAE,QAAQ;oBACb,IAAI,EAAE,OAAO;oBACb,IAAI,EAAE,UAAU;oBAChB,SAAS;oBACT,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;oBACd,MAAM,EAAE,QAAQ,GAAG,CAAC;iBACvB,CAAC,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,gBAAgB,CACjC,MAAM,EACN,QAAQ,EACR,MAAM,EACN,OAAO,EACP,OAAO,CAAC,aAAa,EACrB,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,GAAG,CAAC,EAAE,OAAO,CAAC,EAC5C,OAAO,CAAC,MAAM,CACjB,CAAC;gBACF,oBAAoB,CAAC;oBACjB,EAAE,EAAE,aAAa;oBACjB,GAAG,EAAE,QAAQ;oBACb,IAAI,EAAE,OAAO;oBACb,IAAI,EAAE,UAAU;oBAChB,SAAS;oBACT,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;oBACd,MAAM,EAAE,QAAQ,GAAG,CAAC;iBACvB,CAAC,CAAC;gBACH,OAAO,MAAM,CAAC;YAClB,CAAC;YAED,IAAI,QAAQ,GAAG,WAAW,EAAE,CAAC;gBACzB,MAAM,YAAY,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YACrE,CAAC;QACL,CAAC;QAED,MAAM,IAAI,qBAAqB,EAAE,CAAC;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,oBAAoB,CAAC;YACjB,EAAE,EAAE,aAAa;YACjB,GAAG,EAAE,QAAQ;YACb,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ;YACnC,SAAS;YACT,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;YACd,KAAK;SACR,CAAC,CAAC;QACH,MAAM,KAAK,CAAC;IAChB,CAAC;AACL,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC3B,MAAwB,EACxB,GAAW,EACX,MAAc,EACd,OAAe,EACf,aAAqB,EACrB,EAAyC,EACzC,YAA0B;IAE1B,oBAAoB,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;IACxC,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;IAC9C,IAAI,aAAwC,CAAC;IAC7C,MAAM,cAAc,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QACpD,aAAa,GAAG,MAAM,CAAC;IAC3B,CAAC,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC;IACjE,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,IAAI,QAAoC,CAAC;IACzC,MAAM,QAAQ,GAAG,CAAC,KAAY,EAAE,EAAE;QAC9B,IAAI,UAAU;YAAE,OAAO;QACvB,UAAU,GAAG,IAAI,CAAC;QAClB,IAAI,QAAQ;YAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;QACtC,aAAa,CAAC,KAAK,CAAC,CAAC;QACrB,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC,CAAC;IACF,MAAM,eAAe,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC,CAAC;IACzE,YAAY,EAAE,gBAAgB,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAEzE,QAAQ,GAAG,WAAW,CAClB,GAAG,EAAE;QACD,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC;aACtD,IAAI,CAAC,MAAM,CAAC,EAAE;YACX,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;gBAAE,QAAQ,CAAC,IAAI,qBAAqB,CAAC,qCAAqC,GAAG,EAAE,CAAC,CAAC,CAAC;QAC9G,CAAC,CAAC;aACD,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,qBAAqB,CAAC,yBAAyB,GAAG,IAAI,MAAM,KAAK,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACzH,CAAC,EACD,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,CAC7C,CAAC;IAEF,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;QACzC,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC3B,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;IACH,IAAI,SAAkB,CAAC;IACvB,IAAI,MAAqB,CAAC;IAC1B,IAAI,YAAqB,CAAC;IAC1B,IAAI,CAAC;QACD,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;YACxB,QAAQ;YACR,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;gBACzB,SAAS,GAAG,KAAK,CAAC;gBAClB,MAAM,KAAK,CAAC;YAChB,CAAC,CAAC;SACL,CAAC,CAAC;IACP,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,IAAI,SAAS,KAAK,SAAS;YAAE,MAAM,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC5D,YAAY,GAAG,KAAK,CAAC;IACzB,CAAC;YAAS,CAAC;QACP,YAAY,EAAE,mBAAmB,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QAC5D,IAAI,QAAQ;YAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;QACtC,MAAM,aAAa,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;YAC3F,OAAO,CAAC,IAAI,CAAC,2BAA2B,GAAG,IAAI,MAAM,EAAE,EAAE,KAAK,CAAC,CAAC;YAChE,OAAO,SAAS,CAAC;QACrB,CAAC,CAAC,CAAC;QACH,IAAI,aAAa,KAAK,SAAS,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC1G,YAAY,GAAG,IAAI,qBAAqB,CAAC,2BAA2B,GAAG,IAAI,MAAM,iCAAiC,CAAC,CAAC;QACxH,CAAC;IACL,CAAC;IAED,IAAI,YAAY,KAAK,SAAS;QAAE,MAAM,YAAY,CAAC;IACnD,OAAO,MAAW,CAAC;AACvB,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAW,EAAE,MAAe,EAAE,eAAe,GAAG,IAAI,eAAe,EAAE,EAAE,YAA0B;IACzH,IAAI,YAAY,EAAE,OAAO;QAAE,eAAe,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;;QAElE,YAAY,EAAE,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE;YACtF,IAAI,EAAE,IAAI;SACb,CAAC,CAAC;IAEP,OAAO;QACH,GAAG;QACH,MAAM;QACN,MAAM,EAAE,eAAe,CAAC,MAAM;QAC9B,gBAAgB;YACZ,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO;gBAAE,OAAO;YAC5C,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC;YAC7C,MAAM,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,qBAAqB,CAAC,SAAS,GAAG,cAAc,CAAC,CAAC;QACnG,CAAC;KACJ,CAAC;AACN,CAAC;AAED,SAAS,2BAA2B,CAAC,QAAwB,EAAE,YAA0B;IACrF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,kBAAkB,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,eAAe,EAAE,EAAE,YAAY,CAAC,CAAC;IACzG,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,YAAY;QAAE,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC;IAE/D,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;IAC9C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC7B,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACzB,0BAA0B,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM;QACV,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,0BAA0B,CAAC,eAAe,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACzH,CAAC;IACD,IAAI,YAAY,EAAE,OAAO;QAAE,eAAe,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;;QAElE,YAAY,EAAE,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE;YACtF,IAAI,EAAE,IAAI;SACb,CAAC,CAAC;IAEP,OAAO;QACH,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QACnD,MAAM,EAAE,eAAe,CAAC,MAAM;QAC9B,gBAAgB;YACZ,KAAK,MAAM,OAAO,IAAI,QAAQ;gBAAE,OAAO,CAAC,gBAAgB,EAAE,CAAC;YAC3D,oBAAoB,CAAC,YAAY,EAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YACnF,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO;gBAAE,OAAO;YAC5C,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC;YAC7C,MAAM,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,qBAAqB,CAAC,yBAAyB,CAAC,CAAC;QAClG,CAAC;KACJ,CAAC;AACN,CAAC;AAED,SAAS,0BAA0B,CAAC,eAAgC,EAAE,OAAqB;IACvF,IAAI,eAAe,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO;IAC3C,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,cAAc,CAAC,IAAyC;IAC7D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,OAAO,CAAC,GAAG,IAAI,CAAC;SACX,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;SACtD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;SACtD,MAAM,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE;QACtB,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC;YAAE,OAAO,KAAK,CAAC;QACtC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC;IAChB,CAAC,CAAC;SACD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,eAAe,CAAC,MAAwB,EAAE,MAAc,EAAE,GAAW,EAAE,GAAG,IAA4B;IAC3G,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,YAAY,CAAC,EAAU,EAAE,MAA+B,EAAE,GAAW;IAC1E,IAAI,CAAC,MAAM;QAAE,OAAO,IAAA,cAAO,EAAC,EAAE,CAAC,CAAC;IAChC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACnC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;YACnC,OAAO;QACX,CAAC;QAED,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QACvE,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,CAAC;QACd,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,MAAM,WAAW,GAAG,GAAG,EAAE;YACrB,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,OAAO,EAAE,CAAC;YACV,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;QACvC,CAAC,CAAC;QACF,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;AACP,CAAC;AAED,SAAS,oBAAoB,CAAC,MAA+B,EAAE,GAAW;IACtE,IAAI,CAAC,MAAM,EAAE,OAAO;QAAE,OAAO;IAC7B,MAAM,aAAa,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,aAAa,CAAC,MAA+B,EAAE,GAAW;IAC/D,MAAM,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC;IAC9B,OAAO,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,qBAAqB,CAAC,SAAS,GAAG,cAAc,CAAC,CAAC;AACpG,CAAC;AAED,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,SAAS,oBAAoB,CAAC,KAAuB;IACjD,KAAK,MAAM,QAAQ,IAAI,cAAc,EAAE,CAAC;QACpC,IAAI,CAAC;YACD,QAAQ,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;QAAC,MAAM,CAAC;YACL,8CAA8C;QAClD,CAAC;IACL,CAAC;AACL,CAAC;AAED,SAAS,sBAAsB;IAC3B,IAAI,CAAC;QACD,OAAO,IAAA,uBAAY,GAAE,CAAC,UAAU,IAAI,OAAO,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,OAAO,CAAC;IACnB,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,12 @@
+import Redis, { type RedisOptions } from 'ioredis';
+export interface RedisConnection<TClient = Redis> {
+    client: TClient;
+    prefix: string;
+}
+export declare function createRedisOptions(configPrefix?: string): {
+    options: RedisOptions;
+    prefix: string;
+};
+export declare function createRedis(configPrefix?: string): RedisConnection;
+export declare function disconnectAllRedis(): Promise<void>;
+//# sourceMappingURL=redis.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../../../src/helpers/redis/redis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAKnD,MAAM,WAAW,eAAe,CAAC,OAAO,GAAG,KAAK;IAC5C,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,kBAAkB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG;IACvD,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAClB,CAwCA;AAID,wBAAgB,WAAW,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,eAAe,CAMlE;AAED,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAIxD"}

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

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.__tsfTypeAliases = void 0;
+exports.createRedisOptions = createRedisOptions;
+exports.createRedis = createRedis;
+exports.disconnectAllRedis = disconnectAllRedis;
+const tslib_1 = require("tslib");
+const ioredis_1 = tslib_1.__importDefault(require("ioredis"));
+const resolver_1 = require("../../app/resolver");
+const package_1 = require("../io/package");
+function createRedisOptions(configPrefix) {
+    const config = { ...(0, resolver_1.getAppConfig)() };
+    if (configPrefix) {
+        for (const key of Object.keys(config)) {
+            if (key.startsWith(`${configPrefix}_REDIS_`)) {
+                if (config[key] === undefined)
+                    continue;
+                config[key.substring(configPrefix.length + 1)] = config[key];
+            }
+        }
+    }
+    const prefix = String(config.REDIS_PREFIX ?? (0, package_1.getPackageName)() ?? 'app');
+    if (config.REDIS_SENTINEL_HOST) {
+        return {
+            prefix,
+            options: {
+                sentinels: [
+                    {
+                        host: String(config.REDIS_SENTINEL_HOST),
+                        port: Number(config.REDIS_SENTINEL_PORT ?? 26379)
+                    }
+                ],
+                name: config.REDIS_SENTINEL_NAME ? String(config.REDIS_SENTINEL_NAME) : undefined
+            }
+        };
+    }
+    if (config.REDIS_HOST) {
+        return {
+            prefix,
+            options: {
+                host: String(config.REDIS_HOST),
+                port: Number(config.REDIS_PORT ?? 6379)
+            }
+        };
+    }
+    throw new Error('REDIS_HOST or REDIS_SENTINEL_HOST must be configured');
+}
+const allClients = new Set();
+function createRedis(configPrefix) {
+    const { options, prefix } = createRedisOptions(configPrefix);
+    const client = new ioredis_1.default(options);
+    allClients.add(client);
+    client.on('end', () => allClients.delete(client));
+    return { client, prefix };
+}
+async function disconnectAllRedis() {
+    const clients = [...allClients];
+    allClients.clear();
+    await Promise.all(clients.map(client => client.quit().catch(() => { })));
+}
+exports.__tsfTypeAliases = ({ "RedisConnection": { kind: 18, typeName: "RedisConnection", types: [{ kind: 20, name: "client", type: { kind: 16, typeName: "TClient", classType: () => (typeof TClient !== "undefined" ? TClient : (typeof exports !== "undefined" ? exports.TClient : undefined)) }, optional: false }, { kind: 20, name: "prefix", type: { kind: 6 }, optional: false }] } });
+//# sourceMappingURL=redis.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redis.js","sourceRoot":"","sources":["../../../../src/helpers/redis/redis.ts"],"names":[],"mappings":";;;;;;;AAAA,8DAAmD;AAEnD,iDAAkD;AAClD,2CAA+C;AAO/C,4BAAmC,YAAqB;IAIpD,MAAM,MAAM,GAAG,EAAE,GAAG,IAAA,uBAAY,GAAE,EAA6B,CAAC;IAEhE,IAAI,YAAY,EAAE,CAAC;QACf,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACpC,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,YAAY,SAAS,CAAC,EAAE,CAAC;gBAC3C,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS;oBAAE,SAAS;gBACxC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,CAAC;QACL,CAAC;IACL,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,IAAI,IAAA,wBAAc,GAAE,IAAI,KAAK,CAAC,CAAC;IAExE,IAAI,MAAM,CAAC,mBAAmB,EAAE,CAAC;QAC7B,OAAO;YACH,MAAM;YACN,OAAO,EAAE;gBACL,SAAS,EAAE;oBACP;wBACI,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC;wBACxC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,mBAAmB,IAAI,KAAK,CAAC;qBACpD;iBACJ;gBACD,IAAI,EAAE,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,SAAS;aACpF;SACJ,CAAC;IACN,CAAC;IAED,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACpB,OAAO;YACH,MAAM;YACN,OAAO,EAAE;gBACL,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC;gBAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,IAAI,IAAI,CAAC;aAC1C;SACJ,CAAC;IACN,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,GAAG,IAAI,GAAG,EAAS,CAAC;AAEpC,qBAA4B,YAAqB;IAC7C,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,IAAI,iBAAK,CAAC,OAAO,CAAC,CAAC;IAClC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAClD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC9B,CAAC;AAEM,KAAK;IACR,MAAM,OAAO,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC;IAChC,UAAU,CAAC,KAAK,EAAE,CAAC;IACnB,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5E,CAAC"}

package/dist/src/helpers/security/crypto.d.ts

@@ -0,0 +1,31 @@
+export declare function randomBytes(length: number, shouldReturnHex?: false): Promise<Buffer>;
+export declare function randomBytes(length: number, shouldReturnHex: true): Promise<string>;
+export declare function randomBytesSync(length: number, shouldReturnHex?: false): Buffer;
+export declare function randomBytesSync(length: number, shouldReturnHex: true): string;
+export declare const PrintableCharacters: string;
+export declare const AlphanumericCharacters = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
+export declare const UpperCaseAlphanumericCharacters = "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
+export declare const NumericCharacters = "0123456789";
+export declare function randomString(length: number, source?: string): Promise<string>;
+export declare function randomStringSync(length: number, source?: string): string;
+export interface CryptoOptions {
+    secret?: string;
+    ivLength?: number;
+}
+export declare class Crypto {
+    private static instance?;
+    static encrypt(data: string): string;
+    static encrypt(data: Buffer): Buffer;
+    static decrypt(data: string): string;
+    static decrypt(data: Buffer): Buffer;
+    static reset(): void;
+    private static getInstance;
+    private readonly key;
+    private readonly ivLength;
+    constructor(options?: CryptoOptions);
+    encrypt(data: string): string;
+    encrypt(data: Buffer): Buffer;
+    decrypt(data: string): string;
+    decrypt(data: Buffer): Buffer;
+}
+//# sourceMappingURL=crypto.d.ts.map

package/dist/src/helpers/security/crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../../../../src/helpers/security/crypto.ts"],"names":[],"mappings":"AAOA,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AACtF,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAMpF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;AACjF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,IAAI,GAAG,MAAM,CAAC;AAM/E,eAAO,MAAM,mBAAmB,QAA2F,CAAC;AAC5H,eAAO,MAAM,sBAAsB,mEAAmE,CAAC;AACvG,eAAO,MAAM,+BAA+B,yCAAyC,CAAC;AACtF,eAAO,MAAM,iBAAiB,eAAe,CAAC;AAE9C,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,SAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CAEnG;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,SAAyB,GAAG,MAAM,CAExF;AAED,MAAM,WAAW,aAAa;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,MAAM;IACf,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAS;IAEjC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACrC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAKrC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACrC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAKrC,MAAM,CAAC,KAAK,IAAI,IAAI,CAEnB;IAED,OAAO,CAAC,MAAM,CAAC,WAAW;IAK1B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC,YAAY,OAAO,GAAE,aAAkB,EAItC;IAED,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAW9B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CAajC"}