inray 0.0.2 → 0.0.3

package/dist/caching/src/keyValue/generic-store.d.ts

@@ -0,0 +1,243 @@
+/**
+ * Original library: keyv (v5.6.0)
+ * - Copyright (c) 2017-2021 Luke Childs
+ * - Copyright (c) 2021-2022 Jared Wray
+ *
+ * Modified and integrated in "Inray":
+ * - Evgeniy Bushin
+ */
+/***/
+import EventManager from './event-manager.ts';
+import { Keyv, type KeyvEntry, type KeyvStoreAdapter, type StoredData } from './index.ts';
+/**
+ * Configuration options for KeyvGenericStore.
+ */
+export type KeyvGenericStoreOptions = {
+    /**
+     * The namespace to use for keys. Can be a static string or a function that returns a string.
+     * When set, all keys will be prefixed with the namespace followed by the key separator.
+     */
+    namespace?: string | (() => string);
+    /**
+     * The separator used between namespace and key. Defaults to "::".
+     */
+    keySeparator?: string;
+};
+/**
+ * Interface for a Map-like store that can be used with KeyvGenericStore.
+ * This allows any object implementing these methods to be used as the underlying storage.
+ * Compatible with Map, QuickLRU, lru.min, and other LRU cache implementations.
+ */
+export type KeyvMapType = {
+    /** Retrieves a value by key */
+    get: (key: string) => any;
+    /** Sets a value with a key. Additional parameters (like TTL) vary by implementation. */
+    set: (key: string, value: any, ...args: any[]) => any;
+    /** Deletes a key from the store */
+    delete: (key: string) => boolean;
+    /** Clears all entries from the store */
+    clear: () => void;
+    /** Checks if a key exists in the store */
+    has: (key: string) => boolean;
+};
+/**
+ * Represents a cache item with its key, value, and optional TTL.
+ */
+export type CacheItem = {
+    /** The cache key */
+    key: string;
+    /** The cached value */
+    value: any;
+    /** Time-to-live in milliseconds */
+    ttl?: number;
+};
+/**
+ * Represents how an item is stored internally in the cache.
+ */
+export type CacheItemStore = {
+    /** The cache key */
+    key: string;
+    /** The cached value */
+    value: any;
+    /** Unix timestamp (in milliseconds) when the item expires */
+    expires?: number;
+};
+/**
+ * Data structure returned when parsing a prefixed key.
+ */
+export type KeyPrefixData = {
+    /** The namespace extracted from the key, if present */
+    namespace?: string;
+    /** The key without the namespace prefix */
+    key: string;
+};
+/**
+ * A generic in-memory store adapter for Keyv that wraps any Map-like object.
+ *
+ * This class provides a unified interface for using various Map-like stores
+ * with Keyv, handling namespace prefixing, TTL-based expiration, and batch operations.
+ *
+ * @example
+ * ```typescript
+ * // Using with a standard Map
+ * const store = new KeyvGenericStore(new Map(), { namespace: 'cache' });
+ *
+ * // Using with a custom store
+ * const customStore = new KeyvGenericStore(myCustomMapLikeStore, {
+ *   namespace: () => `tenant-${getTenantId()}`,
+ *   keySeparator: ':'
+ * });
+ * ```
+ */
+export declare class KeyvGenericStore extends EventManager implements KeyvStoreAdapter {
+    private readonly _options?;
+    private _store;
+    private _namespace?;
+    private _keySeparator;
+    /**
+     * Creates a new KeyvGenericStore instance.
+     * @param store - The underlying Map or Map-like object to use for storage
+     * @param options - Configuration options for the store
+     */
+    constructor(store: KeyvMapType, options?: KeyvGenericStoreOptions);
+    /**
+     * Gets the underlying store instance.
+     */
+    get store(): KeyvMapType;
+    /**
+     * Sets the underlying store instance.
+     */
+    set store(store: KeyvMapType);
+    /**
+     * Gets the current key separator used between namespace and key.
+     */
+    get keySeparator(): string;
+    /**
+     * Sets the key separator used between namespace and key.
+     */
+    set keySeparator(separator: string);
+    /**
+     * Gets the options passed to the constructor.
+     */
+    get opts(): KeyvGenericStoreOptions | undefined;
+    /**
+     * Gets the current namespace value (resolved if it's a function).
+     */
+    get namespace(): string | undefined;
+    /**
+     * Sets the namespace to a static string value.
+     */
+    set namespace(namespace: string | undefined);
+    /**
+     * Gets the current namespace, resolving it if it's a function.
+     * @returns The resolved namespace string, or undefined if not set
+     */
+    getNamespace(): string | undefined;
+    /**
+     * Sets the namespace to a static string or a function that returns a string.
+     * Using a function allows for dynamic namespaces (e.g., per-tenant).
+     * @param namespace - The namespace string, function, or undefined to clear
+     */
+    setNamespace(namespace: string | (() => string) | undefined): void;
+    /**
+     * Creates a prefixed key by combining the namespace and key with the separator.
+     * @param key - The base key
+     * @param namespace - Optional namespace to prefix the key with
+     * @returns The prefixed key if namespace is provided, otherwise the original key
+     */
+    getKeyPrefix(key: string, namespace?: string): string;
+    /**
+     * Parses a prefixed key to extract the namespace and original key.
+     * @param key - The prefixed key to parse
+     * @returns An object containing the namespace (if present) and the original key
+     */
+    getKeyPrefixData(key: string): {
+        namespace: string;
+        key: string;
+    } | {
+        key: string;
+        namespace?: undefined;
+    };
+    /**
+     * Retrieves a value from the store by key.
+     * Automatically handles namespace prefixing and TTL expiration.
+     * @param key - The key to retrieve
+     * @returns The stored data, or undefined if not found or expired
+     */
+    get<T>(key: string): Promise<StoredData<T> | undefined>;
+    /**
+     * Stores a value in the store with an optional TTL.
+     * @param key - The key to store the value under
+     * @param value - The value to store
+     * @param ttl - Optional time-to-live in milliseconds
+     * @returns Always returns true indicating success
+     */
+    set(key: string, value: any, ttl?: number): Promise<boolean>;
+    /**
+     * Stores multiple entries in the store at once.
+     * @param entries - Array of entries containing key, value, and optional TTL
+     */
+    setMany(entries: KeyvEntry[]): Promise<void>;
+    /**
+     * Deletes a value from the store by key.
+     * @param key - The key to delete
+     * @returns True if the key was deleted, false otherwise
+     */
+    delete(key: string): Promise<boolean>;
+    /**
+     * Clears all entries from the store.
+     * Note: This clears the entire underlying store, not just the current namespace.
+     */
+    clear(): Promise<void>;
+    /**
+     * Checks if a key exists in the store and is not expired.
+     * @param key - The key to check
+     * @returns True if the key exists and is not expired, false otherwise
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * Retrieves multiple values from the store by their keys.
+     * @param keys - Array of keys to retrieve
+     * @returns Array of stored data in the same order as the input keys
+     */
+    getMany<T>(keys: string[]): Promise<Array<StoredData<T | undefined>>>;
+    /**
+     * Deletes multiple keys from the store at once.
+     * @param keys - Array of keys to delete
+     * @returns True if all deletions succeeded, false if an error occurred
+     */
+    deleteMany(keys: string[]): Promise<boolean>;
+    /**
+     * Creates an async iterator for iterating over store entries.
+     * If the underlying store does not support iteration, returns an empty generator.
+     * @param namespace - Optional namespace to filter entries by
+     * @returns {AsyncGenerator<Array<string | Awaited<Value> | undefined>, void>} An async generator yielding [key, value] pairs
+     */
+    iterator<Value>(namespace?: string): AsyncGenerator<Array<string | Awaited<Value> | undefined>, void>;
+}
+/**
+ * Creates a Keyv instance with a generic store optimized for in-memory storage.
+ *
+ * This factory function configures Keyv to bypass serialization/deserialization
+ * and key prefixing, resulting in faster performance for in-memory use cases
+ * where data doesn't need to be persisted or transmitted.
+ *
+ * @param store - The underlying Map or Map-like object to use for storage
+ * @param options - Configuration options for the generic store
+ * @returns A configured Keyv instance with optimized settings for in-memory storage
+ *
+ * @example
+ * ```typescript
+ * // Create a simple in-memory cache
+ * const cache = createKeyv(new Map());
+ * await cache.set('user:1', { name: 'John' });
+ *
+ * // Create with namespace for multi-tenant scenarios
+ * const tenantCache = createKeyv(new Map(), {
+ *   namespace: 'tenant-123',
+ *   keySeparator: ':'
+ * });
+ * ```
+ */
+export declare function createKeyv(store: KeyvMapType, options?: KeyvGenericStoreOptions): Keyv<any>;
+//# sourceMappingURL=generic-store.d.ts.map

package/dist/caching/src/keyValue/generic-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-store.d.ts","sourceRoot":"","sources":["../../../../src/caching/src/keyValue/generic-store.ts"],"names":[],"mappings":"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"}

package/dist/caching/src/keyValue/generic-store.js

@@ -0,0 +1,295 @@
+/**
+ * Original library: keyv (v5.6.0)
+ * - Copyright (c) 2017-2021 Luke Childs
+ * - Copyright (c) 2021-2022 Jared Wray
+ *
+ * Modified and integrated in "Inray":
+ * - Evgeniy Bushin
+ */
+/***/
+import EventManager from "./event-manager.js";
+import { Keyv } from "./index.js";
+/**
+ * A generic in-memory store adapter for Keyv that wraps any Map-like object.
+ *
+ * This class provides a unified interface for using various Map-like stores
+ * with Keyv, handling namespace prefixing, TTL-based expiration, and batch operations.
+ *
+ * @example
+ * ```typescript
+ * // Using with a standard Map
+ * const store = new KeyvGenericStore(new Map(), { namespace: 'cache' });
+ *
+ * // Using with a custom store
+ * const customStore = new KeyvGenericStore(myCustomMapLikeStore, {
+ *   namespace: () => `tenant-${getTenantId()}`,
+ *   keySeparator: ':'
+ * });
+ * ```
+ */
+export class KeyvGenericStore extends EventManager {
+    _options;
+    _store;
+    _namespace;
+    _keySeparator = '::';
+    /**
+     * Creates a new KeyvGenericStore instance.
+     * @param store - The underlying Map or Map-like object to use for storage
+     * @param options - Configuration options for the store
+     */
+    constructor(store, options) {
+        super();
+        this._store = store;
+        this._options = options;
+        if (options?.keySeparator) {
+            this._keySeparator = options.keySeparator;
+        }
+        if (options?.namespace) {
+            this._namespace = options?.namespace;
+        }
+    }
+    /**
+     * Gets the underlying store instance.
+     */
+    get store() {
+        return this._store;
+    }
+    /**
+     * Sets the underlying store instance.
+     */
+    set store(store) {
+        this._store = store;
+    }
+    /**
+     * Gets the current key separator used between namespace and key.
+     */
+    get keySeparator() {
+        return this._keySeparator;
+    }
+    /**
+     * Sets the key separator used between namespace and key.
+     */
+    set keySeparator(separator) {
+        this._keySeparator = separator;
+    }
+    /**
+     * Gets the options passed to the constructor.
+     */
+    get opts() {
+        return this._options;
+    }
+    /**
+     * Gets the current namespace value (resolved if it's a function).
+     */
+    get namespace() {
+        return this.getNamespace();
+    }
+    /**
+     * Sets the namespace to a static string value.
+     */
+    set namespace(namespace) {
+        this._namespace = namespace;
+    }
+    /**
+     * Gets the current namespace, resolving it if it's a function.
+     * @returns The resolved namespace string, or undefined if not set
+     */
+    getNamespace() {
+        if (typeof this._namespace === 'function') {
+            return this._namespace();
+        }
+        return this._namespace;
+    }
+    /**
+     * Sets the namespace to a static string or a function that returns a string.
+     * Using a function allows for dynamic namespaces (e.g., per-tenant).
+     * @param namespace - The namespace string, function, or undefined to clear
+     */
+    setNamespace(namespace) {
+        this._namespace = namespace;
+    }
+    /**
+     * Creates a prefixed key by combining the namespace and key with the separator.
+     * @param key - The base key
+     * @param namespace - Optional namespace to prefix the key with
+     * @returns The prefixed key if namespace is provided, otherwise the original key
+     */
+    getKeyPrefix(key, namespace) {
+        if (namespace) {
+            return `${namespace}${this._keySeparator}${key}`;
+        }
+        return key;
+    }
+    /**
+     * Parses a prefixed key to extract the namespace and original key.
+     * @param key - The prefixed key to parse
+     * @returns An object containing the namespace (if present) and the original key
+     */
+    getKeyPrefixData(key) {
+        if (key.includes(this._keySeparator)) {
+            const [namespace, ...rest] = key.split(this._keySeparator);
+            return { namespace, key: rest.join(this._keySeparator) };
+        }
+        return { key };
+    }
+    /**
+     * Retrieves a value from the store by key.
+     * Automatically handles namespace prefixing and TTL expiration.
+     * @param key - The key to retrieve
+     * @returns The stored data, or undefined if not found or expired
+     */
+    async get(key) {
+        const keyPrefix = this.getKeyPrefix(key, this.getNamespace());
+        const data = this._store.get(keyPrefix);
+        if (!data) {
+            return undefined;
+        }
+        // Check if it is expired
+        if (data.expires && Date.now() > data.expires) {
+            this._store.delete(keyPrefix);
+            return undefined;
+        }
+        return data;
+    }
+    /**
+     * Stores a value in the store with an optional TTL.
+     * @param key - The key to store the value under
+     * @param value - The value to store
+     * @param ttl - Optional time-to-live in milliseconds
+     * @returns Always returns true indicating success
+     */
+    async set(key, value, ttl) {
+        const keyPrefix = this.getKeyPrefix(key, this.getNamespace());
+        const data = { value, expires: ttl ? Date.now() + ttl : undefined };
+        this._store.set(keyPrefix, data, ttl);
+        return true;
+    }
+    /**
+     * Stores multiple entries in the store at once.
+     * @param entries - Array of entries containing key, value, and optional TTL
+     */
+    async setMany(entries) {
+        const results = [];
+        for (const entry of entries) {
+            const result = await this.set(entry.key, entry.value, entry.ttl);
+            results.push(result);
+        }
+    }
+    /**
+     * Deletes a value from the store by key.
+     * @param key - The key to delete
+     * @returns True if the key was deleted, false otherwise
+     */
+    async delete(key) {
+        const keyPrefix = this.getKeyPrefix(key, this.getNamespace());
+        return this._store.delete(keyPrefix);
+    }
+    /**
+     * Clears all entries from the store.
+     * Note: This clears the entire underlying store, not just the current namespace.
+     */
+    async clear() {
+        this._store.clear();
+    }
+    /**
+     * Checks if a key exists in the store and is not expired.
+     * @param key - The key to check
+     * @returns True if the key exists and is not expired, false otherwise
+     */
+    async has(key) {
+        const value = await this.get(key);
+        return Boolean(value);
+    }
+    /**
+     * Retrieves multiple values from the store by their keys.
+     * @param keys - Array of keys to retrieve
+     * @returns Array of stored data in the same order as the input keys
+     */
+    async getMany(keys) {
+        const values = [];
+        for (const key of keys) {
+            const value = await this.get(key);
+            values.push(value);
+        }
+        return values;
+    }
+    /**
+     * Deletes multiple keys from the store at once.
+     * @param keys - Array of keys to delete
+     * @returns True if all deletions succeeded, false if an error occurred
+     */
+    async deleteMany(keys) {
+        try {
+            for (const key of keys) {
+                const keyPrefix = this.getKeyPrefix(key, this.getNamespace());
+                this._store.delete(keyPrefix);
+            }
+        }
+        catch (error) {
+            this.emit('error', error);
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Creates an async iterator for iterating over store entries.
+     * If the underlying store does not support iteration, returns an empty generator.
+     * @param namespace - Optional namespace to filter entries by
+     * @returns {AsyncGenerator<Array<string | Awaited<Value> | undefined>, void>} An async generator yielding [key, value] pairs
+     */
+    async *iterator(namespace) {
+        // Check if store supports iteration
+        if (typeof this._store.entries !== 'function') {
+            return;
+        }
+        const iterator = this._store.entries();
+        for (const [key, data] of iterator) {
+            // Filter by namespace if provided
+            if (namespace) {
+                if (!key.startsWith(`${namespace}${this._keySeparator}`)) {
+                    continue;
+                }
+            }
+            // Check expiration
+            if (data?.expires && Date.now() > data.expires) {
+                this._store.delete(key);
+                continue;
+            }
+            // Extract the key without namespace prefix
+            const keyWithoutPrefix = namespace ? key.slice(namespace.length + this._keySeparator.length) : key;
+            yield [keyWithoutPrefix, data?.value];
+        }
+    }
+}
+/**
+ * Creates a Keyv instance with a generic store optimized for in-memory storage.
+ *
+ * This factory function configures Keyv to bypass serialization/deserialization
+ * and key prefixing, resulting in faster performance for in-memory use cases
+ * where data doesn't need to be persisted or transmitted.
+ *
+ * @param store - The underlying Map or Map-like object to use for storage
+ * @param options - Configuration options for the generic store
+ * @returns A configured Keyv instance with optimized settings for in-memory storage
+ *
+ * @example
+ * ```typescript
+ * // Create a simple in-memory cache
+ * const cache = createKeyv(new Map());
+ * await cache.set('user:1', { name: 'John' });
+ *
+ * // Create with namespace for multi-tenant scenarios
+ * const tenantCache = createKeyv(new Map(), {
+ *   namespace: 'tenant-123',
+ *   keySeparator: ':'
+ * });
+ * ```
+ */
+export function createKeyv(store, options) {
+    const genericStore = new KeyvGenericStore(store, options);
+    const keyv = new Keyv({ store: genericStore, useKeyPrefix: false });
+    keyv.serialize = undefined;
+    keyv.deserialize = undefined;
+    return keyv;
+}
+//# sourceMappingURL=generic-store.js.map

package/dist/caching/src/keyValue/generic-store.js.map

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

package/dist/caching/src/keyValue/hooks-manager.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Original library: keyv (v5.6.0)
+ * - Copyright (c) 2017-2021 Luke Childs
+ * - Copyright (c) 2021-2022 Jared Wray
+ *
+ * Modified and integrated in "Inray":
+ * - Evgeniy Bushin
+ */
+/***/
+import EventManager from './event-manager.ts';
+type HookHandler = (...arguments_: any[]) => void;
+declare class HooksManager extends EventManager {
+    _hookHandlers: Map<string, HookHandler[]>;
+    constructor();
+    addHandler(event: string, handler: HookHandler): void;
+    removeHandler(event: string, handler: HookHandler): void;
+    trigger(event: string, data: any): void;
+    get handlers(): Map<string, HookHandler[]>;
+}
+export default HooksManager;
+//# sourceMappingURL=hooks-manager.d.ts.map

package/dist/caching/src/keyValue/hooks-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-manager.d.ts","sourceRoot":"","sources":["../../../../src/caching/src/keyValue/hooks-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,KAAK;AAEL,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAE9C,KAAK,WAAW,GAAG,CAAC,GAAG,UAAU,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;AAElD,cAAM,YAAa,SAAQ,YAAY;IACrC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;;IAQ1C,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW;IAU9C,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW;IAYjD,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG;IAchC,IAAI,QAAQ,+BAGX;CACF;AAED,eAAe,YAAY,CAAC"}

package/dist/caching/src/keyValue/hooks-manager.js

@@ -0,0 +1,59 @@
+/**
+ * Original library: keyv (v5.6.0)
+ * - Copyright (c) 2017-2021 Luke Childs
+ * - Copyright (c) 2021-2022 Jared Wray
+ *
+ * Modified and integrated in "Inray":
+ * - Evgeniy Bushin
+ */
+/***/
+import EventManager from "./event-manager.js";
+class HooksManager extends EventManager {
+    _hookHandlers;
+    constructor() {
+        super();
+        this._hookHandlers = new Map();
+    }
+    // Adds a handler function for a specific event
+    addHandler(event, handler) {
+        const eventHandlers = this._hookHandlers.get(event);
+        if (eventHandlers) {
+            eventHandlers.push(handler);
+        }
+        else {
+            this._hookHandlers.set(event, [handler]);
+        }
+    }
+    // Removes a specific handler function for a specific event
+    removeHandler(event, handler) {
+        const eventHandlers = this._hookHandlers.get(event);
+        /* v8 ignore next -- @preserve */
+        if (eventHandlers) {
+            const index = eventHandlers.indexOf(handler);
+            if (index !== -1) {
+                eventHandlers.splice(index, 1);
+            }
+        }
+    }
+    // Triggers all handlers for a specific event with provided data
+    trigger(event, data) {
+        const eventHandlers = this._hookHandlers.get(event);
+        if (eventHandlers) {
+            for (const handler of eventHandlers) {
+                try {
+                    handler(data);
+                }
+                catch (error) {
+                    this.emit('error', new Error(`Error in hook handler for event "${event}": ${error.message}`));
+                }
+            }
+        }
+    }
+    // Provides read-only access to the current handlers
+    get handlers() {
+        // Creating a new map to prevent external modifications to the original map
+        return new Map(this._hookHandlers);
+    }
+}
+export default HooksManager;
+//# sourceMappingURL=hooks-manager.js.map

package/dist/caching/src/keyValue/hooks-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-manager.js","sourceRoot":"","sources":["../../../../src/caching/src/keyValue/hooks-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,KAAK;AAEL,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAI9C,MAAM,YAAa,SAAQ,YAAY;IACrC,aAAa,CAA6B;IAE1C;QACE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,aAAa,GAAG,IAAI,GAAG,EAAE,CAAC;IACjC,CAAC;IAED,+CAA+C;IAC/C,UAAU,CAAC,KAAa,EAAE,OAAoB;QAC5C,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpD,IAAI,aAAa,EAAE,CAAC;YAClB,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,2DAA2D;IAC3D,aAAa,CAAC,KAAa,EAAE,OAAoB;QAC/C,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpD,iCAAiC;QACjC,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC7C,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;gBACjB,aAAa,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;IACH,CAAC;IAED,gEAAgE;IAChE,OAAO,CAAC,KAAa,EAAE,IAAS;QAC9B,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpD,IAAI,aAAa,EAAE,CAAC;YAClB,KAAK,MAAM,OAAO,IAAI,aAAa,EAAE,CAAC;gBACpC,IAAI,CAAC;oBACH,OAAO,CAAC,IAAI,CAAC,CAAC;gBAChB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,KAAK,CAAC,oCAAoC,KAAK,MAAO,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBAC3G,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,oDAAoD;IACpD,IAAI,QAAQ;QACV,2EAA2E;QAC3E,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACrC,CAAC;CACF;AAED,eAAe,YAAY,CAAC"}