mongodb-runner 4.10.0 → 5.2.0

package/README.md

@@ -1,253 +1,68 @@
-# mongodb-runner [![][npm_img]][npm_url] [![][travis_img]][travis_url] [![][appveyor_img]][appveyor_url]
+# mongodb-runner
 
-> Easily install and run MongoDB to test your code against it.
+Helper for spinning up MongoDB servers and clusters for testing.
 
-## Table of Contents
+## Example usage
 
-- [Introduction](#introduction)
-- [How to play with MongoDB](#how-to-play-with-mongodb)
-- [Debugging](#debugging)
-- [Configuration](#configuration)
-- [CLI Usage](#cli)
-- [TravisCI Integration](#travisci)
-- [Mocha Integration](#mocha)
+> Note: Version 5 of mongodb-runner is a full re-write. Many things work
+> differently in version 5 and above.
 
-
-## Introduction
-
-This is a tool I wrote for a node app using MongoDB that I was working on. I wanted other contributors to have the database, MongoDB, just work without any extra steps once they cloned the repo and installed app dependencies.  
-
-Then I wanted to be able to test using different versions and configurations of mongo. This tool allowed me to test new releases and configurations of mongo before changing anything in our app servers on AWS.
-
-:warning: For experiments only: Please do not use this tool in production or for anything that considers data storage to be 100% emphemeral. 
-
-## How to play with MongoDB
-
-```javascript
-npm install -g mongodb-runner;
-mongodb-runner start; # downloads mongodb and starts locally
-mongo; # Shell opens connected to mongodb://localhost:27017
+```bash
+$ npx mongodb-runner start -t sharded
+$ npx mongodb-runner start -t replset -- --port 27017
+$ npx mongodb-runner start -t replset -- --setParameter allowDiskUseByDefault=true
+$ npx mongodb-runner stop --all
+$ npx mongodb-runner exec -t standalone -- sh -c 'mongosh $MONGODB_URI'
+$ npx mongodb-runner exec -t standalone -- --setParameter allowDiskUseByDefault=true -- sh -c 'mongosh $MONGODB_URI'
 ```
 
-## Debugging
-
-`mongodb-runner` uses the [`debug`](https://npm.im/debug) module so if something isn't working correctly, set the `DEBUG` environment variable to `DEBUG=mongodb-*` for lots of helpful messages.
-
-## Configuration
-
-### version
-
-The latest stable version of MongoDB will automatically be downloaded and installed by default when `start` is run. 
-<!-- TODO: lucas: Merge version-manager info on stable|unstable|semver. --> 
-
-[Default: `stable`]
-
-### port
-
-The port MongoDB will be accessible locally on. 
-
-[Default: `27017`]
-
-### dbpath
-
-The base path for data storage. [Default: `~/.mongodb/data/standalone`]
-
-### logpath
-
-The base directory for data to be stored. [Default: `~/.mongodb/logs/standalone.log`]
-
-### topology
-
-One of standalone, replicaset, or cluster [Default: `standalone`].
-
-### replicaset options
-
-> only applicable when [`topology`](#topology) is `replicaset`
-
-#### arbiters
-
-The number of arbiter processes to start [Default: `0`].
-
-#### passives
-
-The number of passive processes to start [Default: `1`].
-
-#### secondaries
-
-How many secondary instances to start [Default: `2`].
-
-### cluster options 
-
-> only applicable when [`topology`](#topology) is `cluster`
-
-#### shards
-
-Number of shards in the cluster [Default: `2`].
-
-#### routers
-
-Number of router processes to start [Default: `2`].
-
-#### configs
-
-Number of config server processes to start [Default: `1`].
-
-#### routerPort
-
-Port number to start incrementing from when starting routers [Default `50000`].
-
-#### shardPort
-
-Port number to start incrementing from when starting shard members [Default `31000`].
-
-#### configPort
-
-Port number to start incrementing from when starting config servers [Default `35000`].
-
-### Using Environment Variables
-
-| Option | Environment Variable |
-| :--- | :--- |
-|[`version`](#version) | MONGODB_VERSION         |
-|[`port`](#port) | MONGODB_PORT         |
-|[`topology`](#topology) | MONGODB_TOPOLOGY     |
-|[`arbiters`](#arbiters) | MONGODB_ARBITERS     |
-|[`secondaries`](#secondaries) | MONGODB_SECONDARIES  |
-|[`passives`](#passives) | MONGODB_PASSIVES     |
-|[`shards`](#shards) | MONGODB_SHARDS       |
-|[`routers`](#routers) | MONGODB_ROUTERS      |
-|[`configs`](#configs) | MONGODB_CONFIGS      |
-|[`shards_port`](#shards_port) | MONGODB_SHARDS_PORT  |
-|[`configs_port`](#configs_port) | MONGODB_CONFIGS_PORT |
-|[`arbiters`](#arbiters) | MONGODB_ARBITERS     |
-|[`secondaries`](#secondaries) | MONGODB_SECONDARIES  |
-|[`passives`](#passives) | MONGODB_PASSIVES     |
-
-## CLI
+## Options
 
 ```
-Usage: mongodb-runner <start|stop> [options]
+mongodb-runner <command>
 
-Start/stop mongodb for testing.
+Commands:
+  mongodb-runner start  Start a MongoDB instance
+  mongodb-runner stop   Stop a MongoDB instance
+  mongodb-runner ls     List currently running MongoDB instances
+  mongodb-runner exec   Run a process with a MongoDB instance (as MONGODB_URI
+                        env var)
 
 Options:
-  --topology=<topology>         One of standalone, replicaset, or cluster [Default: `standalone`].
-  --pidpath=<pidpath>           Where to put pid files [Default: `~/.mongodb/pids`].
-  --bin=<path>                  Path to mongod|mongos binary [Default: `which mongod|mongos`].
-
-Options depending on `--topology`:
-  --topology=standalone
-    --name=<name>                 The replSet name [Default: `my-standalone`].
-    --port=<port>                 Port to start mongod on [Default: `27017`].
-    --dbpath=<dbpath>             Where to put the data [Default: `~/.mongodb/data/[standalone]`]
-    --logpath=<logpath>           [Default: `~/.mongodb/#{name}.log`]
-
-  --topology=replicaset
-    --name=<name>                 The replSet name [Default: `my-replicaset`].
-    --port=<port>                 The starting port to use for mongod instances [Default: `31000`].
-    --dbpath=<dbpath>             [Default: `~/.mongodb/data/#{name}-#{instance_id}`]
-    --logpath=<logpath>           [Default: `~/.mongodb/#{name}.log/#{instance_id}.log`]
-    --arbiters=<n>                How many arbiters to start [Default: `0`].
-    --passives=<n>                How many passive instances to start [Default: `1`].
-    --secondaries=<n>             How many secondary instances to start [Default: `2`]. Maps to `secondaries` option.
-
-  --topology=cluster
-    --shards=<n>                  Number of shards in the cluster [Default: `2`].
-    --routers=<n>                 Number of router instances [Default: `2`].
-    --configs=<n>                 Number of config servers [Default: `1`].
-    --routerPort=<port>           Port number to start incrementing from when starting routers [Default `50000`].
-    --port=<port>                 Port number to start incrementing from when starting shard members [Default `31000`].
-    --configPort=<port>           Port number to start incrementing from when starting shard members [Default `35000`].
-
-Environment Variables:
-  MONGODB_VERSION      What version of MongoDB should be installed and available [Default: `stable`]
-  MONGODB_TOPOLOGY     See `--topology`
-  MONGODB_PORT         See `--port`
-  MONGODB_TOPOLOGY     See `topology`
-  MONGODB_ARBITERS     See `arbiters`
-  MONGODB_SECONDARIES  See `secondaries`
-  MONGODB_PASSIVES     See `passives`
-  MONGODB_SHARDS       See `--shards`
-  MONGODB_ROUTERS      See `--routers`
-  MONGODB_CONFIGS      See `--configs`
-  MONGODB_SHARDS_PORT  See `--shardPort`
-  MONGODB_CONFIGS_PORT See `--configPort`
-  MONGODB_ARBITERS     See `--arbiters`
-  MONGODB_SECONDARIES  See `--secondaries`
-  MONGODB_PASSIVES     See `--passives`
+  -t, --topology     Select a topology type
+           [choices: "standalone", "replset", "sharded"] [default: "standalone"]
+      --arbiters     number of arbiter nodes for each replica set       [number]
+      --secondaries  number of secondaries for each replica set         [number]
+      --shards       number of shards for sharded clusters              [number]
+      --version      MongoDB server version to use                      [string]
+      --logDir       Directory to store server log files in             [string]
+      --binDir       Directory containing mongod/mongos binaries        [string]
+      --tmpDir       Directory for temporary files    [string] [default: "/tmp"]
+      --runnerDir    Directory for storing cluster metadata
+                           [string] [default: "/home/addaleax/.mongodb/runner2"]
+      --docker       Docker image name to run server instances under    [string]
+      --id           ID to save the cluster metadata under              [string]
+      --all          for `stop`: stop all clusters                     [boolean]
+      --debug        Enable debug output                               [boolean]
+      --help         Show help                                         [boolean]
 ```
 
-## TravisCI
+## Programmatic use
 
-Modify your `package.json` to start and stop MongoDB before and after your tests
-automatically when you run `npm test`:
-
-```json
-{
-  "scripts": {
-    "pretest": "mongodb-runner start",
-    "test": "mocha",
-    "posttest": "mongodb-runner stop"
-  }
-}
-```
-
-Update your `.travis.yml` to run your tests against the full version + topology matrix:
-
-```yaml
-language: node_js
-cache:
-  directories:
-    - node_modules
-env:
-  - MONGODB_VERSION=^3.6.0 MONGODB_TOPOLOGY=standalone
-  - MONGODB_VERSION=stable MONGODB_TOPOLOGY=standalone
-  - MONGODB_VERSION=unstable MONGODB_TOPOLOGY=standalone
-  - MONGODB_VERSION=^3.6.0 MONGODB_TOPOLOGY=replicaset
-  - MONGODB_VERSION=stable MONGODB_TOPOLOGY=replicaset
-  - MONGODB_VERSION=unstable MONGODB_TOPOLOGY=replicaset
-  - MONGODB_VERSION=^3.6.0 MONGODB_TOPOLOGY=cluster
-  - MONGODB_VERSION=stable MONGODB_TOPOLOGY=cluster
-  - MONGODB_VERSION=unstable MONGODB_TOPOLOGY=cluster
 ```
+import { MongoCluster } from 'mongodb-runner';
 
-And :tada: Now you're fully covered for all of those all of those edge cases the full
-version + topology matrix can present!
-
-### Mocha
-
-Mocha before/after hooks make writing tests for code that depends on MongoDB insanely simple:
-
-```javascript
-describe('my app', function() {
-  before(require('mongodb-runner/mocha/before'));
-  after(require('mongodb-runner/mocha/after'));
-  it('should connect', function(done) {
-    require('mongodb').connect('mongodb://localhost:27017/', done);
-  });
+const cluster = await MongoCluster.start({
+  topology: 'standalone'
 });
-```
-
-Global hooks are also supported. Add the following to a new file called `test/mongodb.js`:
-
-```javascript
-before(require('mongodb-runner/mocha/before'));
-after(require('mongodb-runner/mocha/after'));
-```
 
-And then just require it:
-
-```
-mocha --require test/mongodb.js test/*.test.js
+try {
+  console.log(cluster.connectionString);
+} finally {
+  await cluster.close();
+}
 ```
 
 ## License
 
 Apache 2.0
-
-[travis_img]: https://img.shields.io/travis/mongodb-js/runner.svg?style=flat-square
-[travis_url]: https://travis-ci.org/mongodb-js/runner
-[npm_img]: https://img.shields.io/npm/v/mongodb-runner.svg
-[npm_url]: https://www.npmjs.org/package/mongodb-runner
-[appveyor_img]: https://ci.appveyor.com/api/projects/status/w3guhkp628hwwpjg?svg=true
-[appveyor_url]: https://ci.appveyor.com/project/imlucas/runner

package/bin/runner.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+'use strict';
+require('../dist/cli.js');

package/dist/.esm-wrapper.mjs

@@ -0,0 +1,5 @@
+import mod from "./index.js";
+
+export default mod;
+export const MongoCluster = mod.MongoCluster;
+export const MongoServer = mod.MongoServer;

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,180 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const yargs_1 = __importDefault(require("yargs"));
+const mongocluster_1 = require("./mongocluster");
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const fs_1 = require("fs");
+const mongodb_1 = require("mongodb");
+const child_process_1 = require("child_process");
+const debug_1 = __importDefault(require("debug"));
+const events_1 = require("events");
+(async function () {
+    var _a;
+    const defaultRunnerDir = path_1.default.join(os_1.default.homedir(), '.mongodb', 'runner2');
+    const argv = await yargs_1.default
+        .version(false)
+        .scriptName('mongodb-runner')
+        .option('topology', {
+        alias: 't',
+        choices: ['standalone', 'replset', 'sharded'],
+        default: 'standalone',
+        describe: 'Select a topology type',
+    })
+        .option('arbiters', {
+        type: 'number',
+        describe: 'number of arbiter nodes for each replica set',
+    })
+        .option('secondaries', {
+        type: 'number',
+        describe: 'number of secondaries for each replica set',
+    })
+        .option('shards', {
+        type: 'number',
+        describe: 'number of shards for sharded clusters',
+    })
+        .option('version', {
+        type: 'string',
+        describe: 'MongoDB server version to use',
+    })
+        .option('logDir', {
+        type: 'string',
+        describe: 'Directory to store server log files in',
+    })
+        .option('binDir', {
+        type: 'string',
+        describe: 'Directory containing mongod/mongos binaries',
+    })
+        .option('tmpDir', {
+        type: 'string',
+        default: os_1.default.tmpdir(),
+        describe: 'Directory for temporary files',
+    })
+        .option('runnerDir', {
+        type: 'string',
+        default: defaultRunnerDir,
+        describe: 'Directory for storing cluster metadata',
+    })
+        .option('docker', {
+        type: 'string',
+        describe: 'Docker image name to run server instances under',
+    })
+        .option('id', {
+        type: 'string',
+        describe: 'ID to save the cluster metadata under',
+    })
+        .option('all', {
+        type: 'boolean',
+        describe: 'for `stop`: stop all clusters',
+    })
+        .option('debug', { type: 'boolean', describe: 'Enable debug output' })
+        .command('start', 'Start a MongoDB instance')
+        .command('stop', 'Stop a MongoDB instance')
+        .command('ls', 'List currently running MongoDB instances')
+        .command('exec', 'Run a process with a MongoDB instance (as MONGODB_URI env var)')
+        .demandCommand(1, 'A command needs to be provided')
+        .help().argv;
+    const [command, ...args] = argv._.map(String);
+    if (argv.debug) {
+        debug_1.default.enable('mongodb-runner');
+    }
+    async function start() {
+        const id = argv.id || new mongodb_1.BSON.UUID().toHexString();
+        if (!/^[a-zA-Z0-9_-]+$/.test(id)) {
+            throw new Error(`ID '${id}' contains non-alphanumeric characters`);
+        }
+        await fs_1.promises.mkdir(argv.runnerDir, { recursive: true });
+        const cluster = await mongocluster_1.MongoCluster.start({
+            ...argv,
+            args,
+        });
+        const serialized = await cluster.serialize();
+        const { connectionString } = cluster;
+        await fs_1.promises.writeFile(path_1.default.join(argv.runnerDir, `m-${id}.json`), JSON.stringify({ id, serialized, connectionString }));
+        console.log(`Server started and running at ${connectionString}`);
+        console.log('Run the following command to stop the instance:');
+        console.log(`${argv.$0} stop --id=${id}` +
+            (argv.runnerDir !== defaultRunnerDir
+                ? `--runnerDir=${argv.runnerDir}`
+                : ''));
+        cluster.unref();
+    }
+    async function* instances() {
+        for await (const { name } of await fs_1.promises.opendir(argv.runnerDir)) {
+            if (name.startsWith('m-') && name.endsWith('.json')) {
+                try {
+                    const filepath = path_1.default.join(argv.runnerDir, name);
+                    const stored = JSON.parse(await fs_1.promises.readFile(filepath, 'utf8'));
+                    yield { ...stored, filepath };
+                }
+                catch (_a) {
+                }
+            }
+        }
+    }
+    async function stop() {
+        if (!argv.id && !argv.all) {
+            throw new Error('Need --id or --all to know which server to stop');
+        }
+        const toStop = [];
+        for await (const instance of instances()) {
+            if (instance.id === argv.id || argv.all)
+                toStop.push(instance);
+        }
+        await Promise.all(toStop.map(async ({ id, filepath, serialized, connectionString }) => {
+            await (await mongocluster_1.MongoCluster.deserialize(serialized)).close();
+            await fs_1.promises.rm(filepath);
+            console.log(`Stopped cluster '${id}' (was running at '${connectionString}')`);
+        }));
+    }
+    async function ls() {
+        for await (const { id, connectionString } of instances()) {
+            console.log(`${id}: ${connectionString}`);
+        }
+    }
+    async function exec() {
+        let mongodArgs;
+        let execArgs;
+        const doubleDashIndex = args.indexOf('--');
+        if (doubleDashIndex !== -1) {
+            mongodArgs = args.slice(0, doubleDashIndex);
+            execArgs = args.slice(doubleDashIndex + 1);
+        }
+        else {
+            mongodArgs = [];
+            execArgs = args;
+        }
+        const cluster = await mongocluster_1.MongoCluster.start({
+            ...argv,
+            args: mongodArgs,
+        });
+        try {
+            const [prog, ...progArgs] = execArgs;
+            const child = (0, child_process_1.spawn)(prog, progArgs, {
+                stdio: 'inherit',
+                env: {
+                    ...process.env,
+                    MONGODB_URI: cluster.connectionString,
+                    MONGODB_URL: cluster.connectionString,
+                    MONGODB_HOSTPORT: cluster.hostport,
+                },
+            });
+            [process.exitCode] = await (0, events_1.once)(child, 'exit');
+        }
+        finally {
+            await cluster.close();
+        }
+    }
+    async function unknown() {
+        throw new Error(`Unknown command: ${command}. See '${argv.$0} --help' for more information.`);
+    }
+    await ((_a = { start, stop, exec, ls }[command]) !== null && _a !== void 0 ? _a : unknown)();
+})().catch((err) => {
+    process.nextTick(() => {
+        throw err;
+    });
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { MongoServer, MongoServerOptions } from './mongoserver';
+export { MongoCluster, MongoClusterOptions } from './mongocluster';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEhE,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoCluster = exports.MongoServer = void 0;
+var mongoserver_1 = require("./mongoserver");
+Object.defineProperty(exports, "MongoServer", { enumerable: true, get: function () { return mongoserver_1.MongoServer; } });
+var mongocluster_1 = require("./mongocluster");
+Object.defineProperty(exports, "MongoCluster", { enumerable: true, get: function () { return mongocluster_1.MongoCluster; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,6CAAgE;AAAvD,0GAAA,WAAW,OAAA;AAEpB,+CAAmE;AAA1D,4GAAA,YAAY,OAAA"}

package/dist/mongocluster.d.ts

@@ -0,0 +1,30 @@
+import type { MongoServerOptions } from './mongoserver';
+import type { DownloadOptions } from '@mongodb-js/mongodb-downloader';
+import { MongoClient } from 'mongodb';
+export interface MongoClusterOptions extends Pick<MongoServerOptions, 'logDir' | 'tmpDir' | 'args' | 'binDir' | 'docker'> {
+    topology: 'standalone' | 'replset' | 'sharded';
+    arbiters?: number;
+    secondaries?: number;
+    shards?: number;
+    version?: string;
+    downloadOptions?: DownloadOptions;
+}
+export declare class MongoCluster {
+    private topology;
+    private replSetName?;
+    private servers;
+    private shards;
+    private constructor();
+    serialize(): unknown;
+    static deserialize(serialized: any): Promise<MongoCluster>;
+    get hostport(): string;
+    get connectionString(): string;
+    get serverVersion(): string;
+    get serverVariant(): 'enterprise' | 'community';
+    static start({ ...options }: MongoClusterOptions): Promise<MongoCluster>;
+    close(): Promise<void>;
+    withClient<Fn extends (client: MongoClient) => any>(fn: Fn): Promise<ReturnType<Fn>>;
+    ref(): void;
+    unref(): void;
+}
+//# sourceMappingURL=mongocluster.d.ts.map

package/dist/mongocluster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongocluster.d.ts","sourceRoot":"","sources":["../src/mongocluster.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEtE,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGtC,MAAM,WAAW,mBACf,SAAQ,IAAI,CACV,kBAAkB,EAClB,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CACnD;IACD,QAAQ,EAAE,YAAY,GAAG,SAAS,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAiD;IACjE,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,MAAM,CAAsB;IAEpC,OAAO;IAIP,SAAS,IAAI,OAAO;WASP,WAAW,CAAC,UAAU,EAAE,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC;IAahE,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,gBAAgB,IAAI,MAAM,CAI7B;IAED,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,IAAI,aAAa,IAAI,YAAY,GAAG,WAAW,CAE9C;WAEY,KAAK,CAAC,EACjB,GAAG,OAAO,EACX,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC;IAyIxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQtB,UAAU,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,WAAW,KAAK,GAAG,EACtD,EAAE,EAAE,EAAE,GACL,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAS1B,GAAG,IAAI,IAAI;IAIX,KAAK,IAAI,IAAI;CAGd"}