keyv 4.5.4 → 5.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2017-2021 Luke Childs
+Copyright (c) 2021-2022 Jared Wray
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,8 +1,4 @@
-<h1 align="center">
-	<img width="250" src="https://jaredwray.com/images/keyv.svg" alt="keyv">
-	<br>
-	<br>
-</h1>
+[<img width="100" align="right" src="https://jaredwray.com/images/keyv-symbol.svg" alt="keyv">](https://github.com/jaredwra/keyv)
 
 > Simple key-value storage with support for multiple backends
 
@@ -45,24 +41,49 @@ npm install --save @keyv/sqlite
 npm install --save @keyv/postgres
 npm install --save @keyv/mysql
 npm install --save @keyv/etcd
+npm install --save @keyv/memcache
 ```
 
-Create a new Keyv instance, passing your connection string if applicable. Keyv will automatically load the correct storage adapter.
+First, create a new Keyv instance. 
 
 ```js
-const Keyv = require('keyv');
+import Keyv from 'keyv';
+```
 
-// One of the following
-const keyv = new Keyv();
-const keyv = new Keyv('redis://user:pass@localhost:6379');
-const keyv = new Keyv('mongodb://user:pass@localhost:27017/dbname');
-const keyv = new Keyv('sqlite://path/to/database.sqlite');
-const keyv = new Keyv('postgresql://user:pass@localhost:5432/dbname');
-const keyv = new Keyv('mysql://user:pass@localhost:3306/dbname');
-const keyv = new Keyv('etcd://localhost:2379');
+Once you have created your Keyv instance you can use it as a simple key-value store with `in-memory` by default. To use a storage adapter, create an instance of the adapter and pass it to the Keyv constructor. Here are some examples:
+
+```js
+// redis
+import KeyvRedis from '@keyv/redis';
+
+const keyv = new Keyv(new KeyvRedis('redis://user:pass@localhost:6379'));
+```
+
+You can also pass in a storage adapter with other options such as `ttl` and `namespace` (example using `sqlite`):
+
+```js
+//sqlite
+import KeyvSqlite from '@keyv/sqlite';
+
+const keyvSqlite = new KeyvSqlite('sqlite://path/to/database.sqlite');
+const keyv = new Keyv({ store: keyvSqlite, ttl: 5000, namespace: 'cache' });
+```
 
+To handle an event you can do the following:
+
+```js
 // Handle DB connection errors
 keyv.on('error', err => console.log('Connection Error', err));
+```
+
+Now lets do an end-to-end example using `Keyv` and the `Redis` storage adapter:
+
+```js
+import Keyv from 'keyv';
+import KeyvRedis from '@keyv/redis';
+
+const keyvRedis = new KeyvRedis('redis://user:pass@localhost:6379');
+const keyv = new Keyv({ store: keyvRedis });
 
 await keyv.set('foo', 'expires in 1 second', 1000); // true
 await keyv.set('foo', 'never expires'); // true
@@ -71,13 +92,15 @@ await keyv.delete('foo'); // true
 await keyv.clear(); // undefined
 ```
 
+It's is just that simple! Keyv is designed to be simple and easy to use.
+
 ### Namespaces
 
 You can namespace your Keyv instance to avoid key collisions and allow you to clear only a certain namespace while using the same database.
 
 ```js
-const users = new Keyv('redis://user:pass@localhost:6379', { namespace: 'users' });
-const cache = new Keyv('redis://user:pass@localhost:6379', { namespace: 'cache' });
+const users = new Keyv(new KeyvRedis('redis://user:pass@localhost:6379'), { namespace: 'users' });
+const cache = new Keyv(new KeyvRedis('redis://user:pass@localhost:6379'), { namespace: 'cache' });
 
 await users.set('foo', 'users'); // true
 await cache.set('foo', 'cache'); // true
@@ -88,9 +111,70 @@ await users.get('foo'); // undefined
 await cache.get('foo'); // 'cache'
 ```
 
+### Events
+
+Keyv is a custom `EventEmitter` and will emit an `'error'` event if there is an error. In addition it will emit a `clear` and `disconnect` event when the corresponding methods are called.
+
+```js
+const keyv = new Keyv();
+const handleConnectionError = err => console.log('Connection Error', err);
+const handleClear = () => console.log('Cache Cleared');
+const handleDisconnect = () => console.log('Disconnected');
+
+keyv.on('error', handleConnectionError);
+keyv.on('clear', handleClear);
+keyv.on('disconnect', handleDisconnect);
+```
+
+### Hooks
+
+Keyv supports hooks for `get`, `set`, and `delete` methods. Hooks are useful for logging, debugging, and other custom functionality. Here is a list of all the hooks:
+
+```
+PRE_GET
+POST_GET
+PRE_GET_MANY
+POST_GET_MANY
+PRE_SET
+POST_SET
+PRE_DELETE
+POST_DELETE
+```
+
+You can access this by importing `KeyvHooks` from the main Keyv package.
+
+```js
+import Keyv, { KeyvHooks } from 'keyv';
+```
+
+```js
+//PRE_SET hook
+const keyv = new Keyv();
+keyv.hooks.addListener(KeyvHooks.PRE_SET, (key, value) => console.log(`Setting key ${key} to ${value}`));
+
+//POST_SET hook
+const keyv = new Keyv();
+keyv.hooks.addListener(KeyvHooks.POST_SET, (key, value) => console.log(`Set key ${key} to ${value}`));
+```
+
+In these examples you can also manipulate the value before it is set. For example, you could add a prefix to all keys.
+
+```js
+const keyv = new Keyv();
+keyv.hooks.addListener(KeyvHooks.PRE_SET, (key, value) => {
+  console.log(`Setting key ${key} to ${value}`);
+  key = `prefix-${key}`;
+});
+```
+
+Now this key will have prefix- added to it before it is set.
+
+In `PRE_DELETE` and `POST_DELETE` hooks, the value could be a single item or an `Array`. This is based on the fact that `delete` can accept a single key or an `Array` of keys.
+
+
 ### Custom Serializers
 
-Keyv uses [`json-buffer`](https://github.com/dominictarr/json-buffer) for data serialization to ensure consistency across different backends.
+Keyv uses [`buffer`](https://nodejs.org/api/buffer.html) for data serialization to ensure consistency across different backends.
 
 You can optionally provide your own serialization functions to support extra data types or to serialize to something other than JSON.
 
@@ -119,8 +203,8 @@ Memcache | [@keyv/memcache](https://github.com/jaredwray/keyv/tree/master/packag
 You can also use third-party storage adapters or build your own. Keyv will wrap these storage adapters in TTL functionality and handle complex types internally.
 
 ```js
-const Keyv = require('keyv');
-const myAdapter = require('./my-storage-adapter');
+import Keyv from 'keyv';
+import myAdapter from 'my-adapter';
 
 const keyv = new Keyv({ store: myAdapter });
 ```
@@ -134,8 +218,8 @@ new Keyv({ store: new Map() });
 For example, [`quick-lru`](https://github.com/sindresorhus/quick-lru) is a completely unrelated module that implements the Map API.
 
 ```js
-const Keyv = require('keyv');
-const QuickLRU = require('quick-lru');
+import Keyv from 'keyv';
+import QuickLRU from 'quick-lru';
 
 const lru = new QuickLRU({ maxSize: 1000 });
 const keyv = new Keyv({ store: lru });
@@ -177,7 +261,7 @@ class AwesomeModule {
 Now it can be consumed like this:
 
 ```js
-const AwesomeModule = require('awesome-module');
+import AwesomeModule from 'awesome-module';
 
 // Caches stuff in memory by default
 const awesomeModule = new AwesomeModule();
@@ -194,8 +278,8 @@ const awesomeModule = new AwesomeModule({ cache: some3rdPartyStore });
 Keyv supports `gzip` and `brotli` compression. To enable compression, pass the `compress` option to the constructor.
 
 ```js
-const KeyvGzip = require('@keyv/compress-gzip');
-const Keyv = require('keyv');
+import Keyv from 'keyv';
+import KeyvGzip from '@keyv/compress-gzip';
 
 const keyvGzip = new KeyvGzip();
 const keyv = new Keyv({ compression: KeyvGzip });
@@ -219,23 +303,23 @@ interface CompressionAdapter {
 In addition to the interface, you can test it with our compression test suite using @keyv/test-suite:
 
 ```js
-const {keyvCompresstionTests} = require('@keyv/test-suite');
-const KeyvGzip = require('@keyv/compress-gzip');
+import { keyvCompresstionTests } from '@keyv/test-suite';
+import KeyvGzip from '@keyv/compress-gzip';
 
 keyvCompresstionTests(test, new KeyvGzip());
 ```
 
 ## API
 
-### new Keyv([uri], [options])
+### new Keyv([storage-adapter], [options]) or new Keyv([options])
 
 Returns a new Keyv instance.
 
 The Keyv instance is also an `EventEmitter` that will emit an `'error'` event if the storage adapter connection fails.
 
-### uri
+### storage-adapter
 
-Type: `String`<br>
+Type: `KeyvStorageAdapter`<br />
 Default: `undefined`
 
 The connection string URI.
@@ -250,53 +334,46 @@ The options object is also passed through to the storage adapter. Check your sto
 
 #### options.namespace
 
-Type: `String`<br>
+Type: `String`<br />
 Default: `'keyv'`
 
 Namespace for the current instance.
 
 #### options.ttl
 
-Type: `Number`<br>
+Type: `Number`<br />
 Default: `undefined`
 
 Default TTL. Can be overridden by specififying a TTL on `.set()`.
 
 #### options.compression
 
-Type: `@keyv/compress-<compression_package_name>`<br>
+Type: `@keyv/compress-<compression_package_name>`<br />
 Default: `undefined`
 
 Compression package to use. See [Compression](#compression) for more details.
 
 #### options.serialize
 
-Type: `Function`<br>
+Type: `Function`<br />
 Default: `JSONB.stringify`
 
 A custom serialization function.
 
 #### options.deserialize
 
-Type: `Function`<br>
+Type: `Function`<br />
 Default: `JSONB.parse`
 
 A custom deserialization function.
 
 #### options.store
 
-Type: `Storage adapter instance`<br>
+Type: `Storage adapter instance`<br />
 Default: `new Map()`
 
 The storage adapter instance to be used by Keyv.
 
-#### options.adapter
-
-Type: `String`<br>
-Default: `undefined`
-
-Specify an adapter to use. e.g `'redis'` or `'mongodb'`.
-
 ### Instance
 
 Keys must always be strings. Values can be of any type.
@@ -315,7 +392,7 @@ Returns a promise which resolves to the retrieved value.
 
 ##### options.raw
 
-Type: `Boolean`<br>
+Type: `Boolean`<br />
 Default: `false`
 
 If set to true the raw DB object Keyv stores internally will be returned instead of just the value.
@@ -349,81 +426,12 @@ for await (const [key, value] of this.keyv.iterator()) {
 
 # How to Contribute
 
-In this section of the documentation we will cover:
-
-1) How to set up this repository locally
-2) How to get started with running commands
-3) How to contribute changes using Pull Requests
-
-## Dependencies
-
-This package requires the following dependencies to run:
-
-1) [Yarn V1](https://yarnpkg.com/getting-started/install)
-3) [Docker](https://docs.docker.com/get-docker/)
-
-## Setting up your workspace
-
-To contribute to this repository, start by setting up this project locally:
-
-1) Fork this repository into your Git account
-2) Clone the forked repository to your local directory using `git clone`
-3) Install any of the above missing dependencies
-
-## Launching the project
-
-Once the project is installed locally, you are ready to start up its services:
-
-1) Ensure that your Docker service is running.
-2) From the root directory of your project, run the `yarn` command in the command prompt to install yarn.
-3) Run the `yarn bootstrap` command to  install any necessary dependencies.
-4) Run `yarn test:services:start` to start up this project's Docker container. The container will launch all services within your workspace.
-
-## Available Commands
-
-Once the project is running, you can execute a variety of commands. The root workspace and each subpackage contain a `package.json` file with a  `scripts` field listing all the commands that can be executed from that directory. This project also supports native `yarn`, and `docker` commands.
-
-Here, we'll cover the primary commands that can be executed from the root directory. Unless otherwise noted, these commands can also be executed from a subpackage. If executed from a subpackage, they will only affect that subpackage, rather than the entire workspace.
-
-### `yarn`
-
-The `yarn` command installs yarn in the workspace.
-
-### `yarn bootstrap`
-
-The `yarn bootstrap` command installs all dependencies in the workspace.
-
-### `yarn test:services:start`
-
-The `yarn test:services:start` command starts up the project's Docker container, launching all services in the workspace. This command must be executed from the root directory.
-
-### `yarn test:services:stop`
-
-The `yarn test:services:stop` command brings down the project's Docker container, halting all services. This command must be executed from the root directory.
-
-### `yarn test`
-
-The `yarn test` command runs all tests in the workspace.
-
-### `yarn clean`
-
-The `yarn clean` command removes yarn and all dependencies installed by yarn. After executing this command, you must repeat the steps in *Setting up your workspace* to rebuild your workspace.
-
-## Contributing Changes
-
-Now that you've set up your workspace, you're ready to contribute changes to the `keyv` repository.
-
-1) Make any changes that you would like to contribute in your local workspace.
-2) After making these changes, ensure that the project's tests still pass by executing the `yarn test` command in the root directory.
-3) Commit your changes and push them to your forked repository.
-4) Navigate to the original `keyv` repository and go the *Pull Requests* tab.
-5) Click the *New pull request* button, and open a pull request for the branch in your repository that contains your changes.
-6) Once your pull request is created, ensure that all checks have passed and that your branch has no conflicts with the base branch. If there are any issues, resolve these changes in your local repository, and then commit and push them to git.
-7) Similarly, respond to any reviewer comments or requests for changes by making edits to your local repository and pushing them to Git.
-8) Once the pull request has been reviewed, those with write access to the branch will be able to merge your changes into the `keyv` repository.
+We welcome contributions to Keyv! 🎉 Here are some guides to get you started with contributing:
 
-If you need more information on the steps to create a pull request, you can find a detailed walkthrough in the [Github documentation](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request-from-a-fork)
+* [Contributing](https://github.com/jaredwray/keyv/blob/main/CONTRIBUTING.md) - Learn about how to contribute to Keyv
+* [Code of Conduct](https://github.com/jaredwray/keyv/blob/main/CODE_OF_CONDUCT.md) - Learn about the Keyv Code of Conduct
+* [How to Contribute](https://github.com/jaredwray/keyv/blob/main/README.md) - How do develop in the Keyv mono repo! 
 
-## License
+# License
 
-MIT © Jared Wray
+[MIT © Jared Wray](LICENSE)

package/dist/cjs/event-manager.d.ts

@@ -0,0 +1,16 @@
+type EventListener = (...arguments_: any[]) => void;
+declare class EventManager {
+    _eventListeners: Map<string, EventListener[]>;
+    _maxListeners: number;
+    constructor();
+    maxListeners(): number;
+    addListener(event: string, listener: EventListener): void;
+    on(event: string, listener: EventListener): void;
+    removeListener(event: string, listener: EventListener): void;
+    off(event: string, listener: EventListener): void;
+    emit(event: string, ...arguments_: any[]): void;
+    listeners(event: string): EventListener[];
+    removeAllListeners(event?: string): void;
+    setMaxListeners(n: number): void;
+}
+export default EventManager;

package/dist/cjs/event-manager.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class EventManager {
+    _eventListeners;
+    _maxListeners;
+    constructor() {
+        this._eventListeners = new Map();
+        this._maxListeners = 100; // Default maximum number of listeners
+    }
+    maxListeners() {
+        return this._maxListeners;
+    }
+    // Add an event listener
+    addListener(event, listener) {
+        this.on(event, listener);
+    }
+    on(event, listener) {
+        if (!this._eventListeners.has(event)) {
+            this._eventListeners.set(event, []);
+        }
+        const listeners = this._eventListeners.get(event);
+        if (listeners) {
+            if (listeners.length >= this._maxListeners) {
+                console.warn(`MaxListenersExceededWarning: Possible event memory leak detected. ${listeners.length + 1} ${event} listeners added. Use setMaxListeners() to increase limit.`);
+            }
+            listeners.push(listener);
+        }
+    }
+    // Remove an event listener
+    removeListener(event, listener) {
+        this.off(event, listener);
+    }
+    off(event, listener) {
+        const listeners = this._eventListeners.get(event) ?? [];
+        const index = listeners.indexOf(listener);
+        if (index > -1) {
+            listeners.splice(index, 1);
+        }
+        if (listeners.length === 0) {
+            this._eventListeners.delete(event);
+        }
+    }
+    // Emit an event
+    emit(event, ...arguments_) {
+        const listeners = this._eventListeners.get(event);
+        if (listeners && listeners.length > 0) {
+            for (const listener of listeners) {
+                listener(...arguments_);
+            }
+        }
+        else if (event === 'error') {
+            // If it's an 'error' event with no listeners, throw the error.
+            if (arguments_[0] instanceof Error) {
+                throw arguments_[0]; // Throws the error object if the first arg is an error
+            }
+            else {
+                const error = new CustomError(arguments_[0]);
+                error.context = arguments_[0];
+                throw error;
+            }
+        }
+    }
+    // Get all listeners for a specific event
+    listeners(event) {
+        return this._eventListeners.get(event) ?? [];
+    }
+    // Remove all listeners for a specific event
+    removeAllListeners(event) {
+        if (event) {
+            this._eventListeners.delete(event);
+        }
+        else {
+            this._eventListeners.clear();
+        }
+    }
+    // Set the maximum number of listeners for a single event
+    setMaxListeners(n) {
+        this._maxListeners = n;
+    }
+}
+class CustomError extends Error {
+    context;
+    constructor(message, context) {
+        super(message);
+        this.context = context;
+        // Maintains proper stack trace for where our error was thrown (only available on V8)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, CustomError);
+        }
+        this.name = this.constructor.name;
+    }
+}
+exports.default = EventManager;
+module.exports = EventManager;
+//# sourceMappingURL=event-manager.js.map

package/dist/cjs/event-manager.js.map

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

package/dist/cjs/hooks-manager.d.ts

@@ -0,0 +1,11 @@
+import EventManager from './event-manager.js';
+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;

package/dist/cjs/hooks-manager.js

@@ -0,0 +1,55 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const event_manager_js_1 = __importDefault(require("./event-manager.js"));
+class HooksManager extends event_manager_js_1.default {
+    _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);
+        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);
+    }
+}
+exports.default = HooksManager;
+module.exports = HooksManager;
+//# sourceMappingURL=hooks-manager.js.map

package/dist/cjs/hooks-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-manager.js","sourceRoot":"","sources":["../../src/hooks-manager.ts"],"names":[],"mappings":";;;;;AAAA,0EAA8C;AAI9C,MAAM,YAAa,SAAQ,0BAAY;IACtC,aAAa,CAA6B;IAE1C;QACC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,aAAa,GAAG,IAAI,GAAG,EAAE,CAAC;IAChC,CAAC;IAED,+CAA+C;IAC/C,UAAU,CAAC,KAAa,EAAE,OAAoB;QAC7C,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpD,IAAI,aAAa,EAAE,CAAC;YACnB,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;aAAM,CAAC;YACP,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;QAC1C,CAAC;IACF,CAAC;IAED,2DAA2D;IAC3D,aAAa,CAAC,KAAa,EAAE,OAAoB;QAChD,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpD,IAAI,aAAa,EAAE,CAAC;YACnB,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC7C,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;gBAClB,aAAa,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAChC,CAAC;QACF,CAAC;IACF,CAAC;IAED,gEAAgE;IAChE,OAAO,CAAC,KAAa,EAAE,IAAS;QAC/B,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpD,IAAI,aAAa,EAAE,CAAC;YACnB,KAAK,MAAM,OAAO,IAAI,aAAa,EAAE,CAAC;gBACrC,IAAI,CAAC;oBACJ,OAAO,CAAC,IAAI,CAAC,CAAC;gBACf,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBAChB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,KAAK,CAAC,oCAAoC,KAAK,MAAc,KAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBACxG,CAAC;YACF,CAAC;QACF,CAAC;IACF,CAAC;IAED,oDAAoD;IACpD,IAAI,QAAQ;QACX,2EAA2E;QAC3E,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACpC,CAAC;CACD;AAED,kBAAe,YAAY,CAAC;AAC5B,MAAM,CAAC,OAAO,GAAG,YAAY,CAAC"}