@fc3/mmcadi 0.1.19 → 0.1.22

package/dist/test/unit/lib/logger/logger.js

@@ -0,0 +1,194 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = require("node:test");
+const node_assert_1 = require("node:assert");
+const log_capturer_1 = __importDefault(require("./../../../../src/lib/log-capturer/index.js"));
+const environment_1 = require("./../../../../src/lib/environment/index.js");
+const environment_mocker_1 = __importDefault(require("./../../../../src/lib/environment-mocker/index.js"));
+const logger_1 = __importStar(require("./../../../../src/lib/logger/index.js"));
+function buildMockReporter() {
+    return {
+        notify(_key, _parameters) {
+            // Noop.
+        }
+    };
+}
+(0, node_test_1.describe)('.info()', () => {
+    (0, node_test_1.it)('logs to stdout with no coloration', () => {
+        const output = log_capturer_1.default.capture(() => {
+            new logger_1.default().info('Some message');
+        });
+        const expected_regex = /^\[[0-9]+\] Some message\n$/;
+        (0, node_assert_1.match)(output, expected_regex);
+    });
+});
+(0, node_test_1.describe)('.warn()', () => {
+    (0, node_test_1.it)('logs to stdout with expected coloration', () => {
+        const output = log_capturer_1.default.capture(() => {
+            new logger_1.default().warn('Some message');
+        });
+        const expected_regex = /^\x1b\[33m\[[0-9]+\] Some message\u001b\[39;49m\n$/;
+        (0, node_assert_1.match)(output, expected_regex);
+    });
+});
+(0, node_test_1.describe)('.error()', () => {
+    (0, node_test_1.it)('logs to stdout with expected coloration', () => {
+        const output = log_capturer_1.default.capture(() => {
+            new logger_1.default().error('Some message');
+        });
+        const expected_regex = /^\x1b\[31m\[[0-9]+\] Some message\x1b\[39;49m\n$/;
+        (0, node_assert_1.match)(output, expected_regex);
+    });
+});
+(0, node_test_1.describe)('.success()', () => {
+    (0, node_test_1.it)('logs to stdout with expected coloration', () => {
+        const output = log_capturer_1.default.capture(() => {
+            new logger_1.default().success('Some message');
+        });
+        const expected_regex = /^\x1b\[32m\[[0-9]+\] Some message\x1b\[39;49m\n$/;
+        (0, node_assert_1.match)(output, expected_regex);
+    });
+});
+(0, node_test_1.describe)('.writeMessage()', () => {
+    (0, node_test_1.it)('logs to stdout with expected coloration', () => {
+        const output = log_capturer_1.default.capture(() => {
+            new logger_1.default().success('Some message');
+        });
+        const expected_regex = /^\x1b\[32m\[[0-9]+\] Some message\x1b\[39;49m\n$/;
+        (0, node_assert_1.match)(output, expected_regex);
+    });
+    (0, node_test_1.it)('trims surrounding whitespace from messages', () => {
+        const output = log_capturer_1.default.capture(() => {
+            new logger_1.default().success(`
+				Some message
+			`);
+        });
+        const expected_regex = /^\x1b\[32m\[[0-9]+\] Some message\x1b\[39;49m\n$/;
+        (0, node_assert_1.match)(output, expected_regex);
+    });
+    (0, node_test_1.it)('includes unique id when present', () => {
+        const logger = new logger_1.default().setUniqueId('abcd1234');
+        const output = log_capturer_1.default.capture(() => {
+            logger.success('Some message');
+        });
+        const expected_regex = /^\x1b\[32m\[[0-9]+\] \[abcd1234\] Some message\x1b\[39;49m\n$/;
+        (0, node_assert_1.match)(output, expected_regex);
+    });
+    (0, node_test_1.it)('includes remote address when present', () => {
+        const logger = new logger_1.default().setRemoteAddress('192.168.1.123');
+        const output = log_capturer_1.default.capture(() => {
+            logger.success('Some message');
+        });
+        const expected_regex = /^\x1b\[32m\[[0-9]+\] \[192\.168\.1\.123\] Some message\x1b\[39;49m\n$/;
+        (0, node_assert_1.match)(output, expected_regex);
+    });
+    (0, node_test_1.it)('includes unique id when both unique id and remote address are present', () => {
+        const logger = new logger_1.default()
+            .setUniqueId('abcd1234')
+            .setRemoteAddress('192.168.1.123');
+        const output = log_capturer_1.default.capture(() => {
+            logger.success('Some message');
+        });
+        const expected_regex = /^\x1b\[32m\[[0-9]+\] \[abcd1234] Some message\x1b\[39;49m\n$/;
+        (0, node_assert_1.match)(output, expected_regex);
+    });
+    // Temporarily marking these as skipped. The reason these were logging as
+    // JSON was in order to feed them to auto-indexing platforms like Splunk.
+    // But we're not using any of those right now, so I just disabled the JSON
+    // style formatting in staging/production; the messages in prod look the
+    // same as they do in dev. At least for now.
+    node_test_1.it.skip('logs expected metadata in production', () => {
+        const unique_id = 'abcd1234';
+        const remote_address = '192.168.0.11';
+        const output = log_capturer_1.default.capture(() => {
+            environment_mocker_1.default.mock(environment_1.EnvironmentType.PRODUCTION, () => {
+                const logger = new logger_1.default()
+                    .setUniqueId(unique_id)
+                    .setRemoteAddress(remote_address)
+                    .setOrigin('saffron.gg');
+                logger.writeMessage('This is a test message', logger_1.LogLevel.INFO);
+            });
+        });
+        const message = JSON.parse(output.trim());
+        (0, node_assert_1.strictEqual)(message.body, 'This is a test message');
+        (0, node_assert_1.strictEqual)(message.unique_id, unique_id);
+        (0, node_assert_1.strictEqual)(message.remote_address, remote_address);
+        (0, node_assert_1.strictEqual)(message.log_level, logger_1.LogLevel.INFO);
+        (0, node_assert_1.strictEqual)(message.origin, 'saffron.gg');
+    });
+    node_test_1.it.skip('logs expected metadata in staging', () => {
+        const unique_id = 'abcd1234';
+        const remote_address = '192.168.0.11';
+        const output = log_capturer_1.default.capture(() => {
+            environment_mocker_1.default.mock(environment_1.EnvironmentType.STAGING, () => {
+                const logger = new logger_1.default()
+                    .setUniqueId(unique_id)
+                    .setRemoteAddress(remote_address)
+                    .setOrigin('saffron.gg');
+                logger.writeMessage('This is a test message', logger_1.LogLevel.INFO);
+            });
+        });
+        const message = JSON.parse(output.trim());
+        (0, node_assert_1.strictEqual)(message.body, 'This is a test message');
+        (0, node_assert_1.strictEqual)(message.unique_id, unique_id);
+        (0, node_assert_1.strictEqual)(message.remote_address, remote_address);
+        (0, node_assert_1.strictEqual)(message.log_level, logger_1.LogLevel.INFO);
+        (0, node_assert_1.strictEqual)(message.origin, 'saffron.gg');
+    });
+});
+(0, node_test_1.describe)('.setErrorReporter()', () => {
+    (0, node_test_1.it)('sets memoized error reporter instance', () => {
+        const reporter = buildMockReporter();
+        logger_1.default.setErrorReporter(reporter);
+        (0, node_assert_1.strictEqual)(logger_1.default.getErrorReporter(), reporter);
+        logger_1.default.setErrorReporter(undefined);
+    });
+});
+(0, node_test_1.describe)('.hasErrorReporter()', () => {
+    (0, node_test_1.it)('returns true when error reporter has been set', () => {
+        const reporter = buildMockReporter();
+        logger_1.default.setErrorReporter(reporter);
+        (0, node_assert_1.strictEqual)(logger_1.default.hasErrorReporter(), true);
+        logger_1.default.setErrorReporter(undefined);
+    });
+    (0, node_test_1.it)('returns false when error reporter has not been set', () => {
+        (0, node_assert_1.strictEqual)(logger_1.default.hasErrorReporter(), false);
+    });
+});
+//# sourceMappingURL=logger.js.map

package/dist/test/unit/lib/logger/logger.js.map

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

package/dist/test/unit/lib/operation/operation.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/unit/lib/operation/operation.js

@@ -0,0 +1,128 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = require("node:test");
+const node_assert_1 = __importDefault(require("node:assert"));
+const log_capturer_1 = __importDefault(require("./../../../../src/lib/log-capturer/index.js"));
+const operation_1 = __importDefault(require("./../../../../src/lib/operation/index.js"));
+const test_1 = require("./../../../../src/lib/test/index.js");
+(0, node_test_1.describe)('Operation', () => {
+    class MockOperation extends operation_1.default {
+        constructor(value, request_context) {
+            super(request_context);
+            this.value = value;
+        }
+        privilegedGetExecutionContext() {
+            return this.getExecutionContext();
+        }
+        privilegedGetSession() {
+            return this.getSession();
+        }
+        privilegedHasSession() {
+            return this.hasSession();
+        }
+        async performInternal() {
+            if (this.value) {
+                return this.value;
+            }
+            else {
+                throw new Error('Something strange happened');
+            }
+        }
+        logRunning() {
+            this.getLogger().info(`
+				Started!
+			`);
+        }
+        logSuccess(result) {
+            this.getLogger().success(`
+				Success! (${result})
+			`);
+        }
+        logFailure(error) {
+            this.getLogger().error(`
+				Failure! (${error.message})
+			`);
+        }
+    }
+    (0, node_test_1.it)('logs expected start message', async () => {
+        const operation = new MockOperation(true);
+        const output = await log_capturer_1.default.captureAsync(() => {
+            return operation.perform();
+        });
+        node_assert_1.default.match(output, /Started!/);
+    });
+    (0, node_test_1.it)('logs expected success message', async () => {
+        const operation = new MockOperation(true);
+        const output = await log_capturer_1.default.captureAsync(() => {
+            return operation.perform();
+        });
+        node_assert_1.default.match(output, /Success! \(true\)/);
+    });
+    (0, node_test_1.it)('logs expected failure message', async () => {
+        const operation = new MockOperation(false);
+        const output = await log_capturer_1.default.captureAsync(async () => {
+            try {
+                await operation.perform();
+            }
+            catch (error) {
+                const cast_error = error;
+                node_assert_1.default.strictEqual(cast_error.message, 'Something strange happened');
+            }
+        });
+        node_assert_1.default.match(output, /Failure! \(Something strange happened\)/);
+    });
+    (0, node_test_1.describe)('passing request context to constructor', () => {
+        const request_context = (0, test_1.buildExecutionContext)();
+        (0, node_test_1.it)('sets expected request context', () => {
+            const operation = new MockOperation(true, request_context);
+            const actual_request_context = operation.privilegedGetExecutionContext();
+            node_assert_1.default.strictEqual(actual_request_context, request_context);
+        });
+    });
+    (0, node_test_1.describe)('.getSession()', () => {
+        (0, node_test_1.it)('throws error if no request context is set', () => {
+            const operation = new MockOperation(true);
+            node_assert_1.default.throws(() => {
+                operation.privilegedGetSession();
+            }, /Tried to read request context, but it was not set/);
+        });
+        (0, node_test_1.it)('returns expected session instance', () => {
+            const session = {
+                id: 'abcd1234',
+                account_id: 'xxx',
+                username: 'xxx'
+            };
+            const request_context = (0, test_1.buildExecutionContext)();
+            request_context.setSession(session);
+            const operation = new MockOperation(true, request_context);
+            const actual_session = operation.privilegedGetSession();
+            node_assert_1.default.strictEqual(actual_session, session);
+        });
+    });
+    (0, node_test_1.describe)('.hasSession()', () => {
+        (0, node_test_1.it)('returns false if no request context is set', () => {
+            const operation = new MockOperation(true);
+            node_assert_1.default.strictEqual(operation.privilegedHasSession(), false);
+        });
+        (0, node_test_1.it)('returns false if request context has no session', () => {
+            const request_context = (0, test_1.buildExecutionContext)();
+            const operation = new MockOperation(true, request_context);
+            node_assert_1.default.strictEqual(operation.privilegedHasSession(), false);
+        });
+        (0, node_test_1.it)('returns true if request context has session', () => {
+            const session = {
+                id: 'abcd1234',
+                account_id: 'xxx',
+                username: 'xxx'
+            };
+            const request_context = (0, test_1.buildExecutionContext)();
+            request_context.setSession(session);
+            const operation = new MockOperation(true, request_context);
+            node_assert_1.default.strictEqual(operation.privilegedHasSession(), true);
+        });
+    });
+});
+//# sourceMappingURL=operation.js.map

package/dist/test/unit/lib/operation/operation.js.map

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

package/dist/test/unit/lib/promise-wrapper/promise-wrapper.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/unit/lib/promise-wrapper/promise-wrapper.js

@@ -0,0 +1,41 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = require("node:test");
+const node_assert_1 = require("node:assert");
+const promise_wrapper_1 = __importDefault(require("./../../../../src/lib/promise-wrapper/index.js"));
+(0, node_test_1.describe)('PromiseWrapper', () => {
+    (0, node_test_1.describe)('.getPromise()', () => {
+        (0, node_test_1.it)('returns the same promise when called multiple times', () => {
+            const promise_wrapper = new promise_wrapper_1.default();
+            const first_promise = promise_wrapper.getPromise();
+            const second_promise = promise_wrapper.getPromise();
+            (0, node_assert_1.strictEqual)(first_promise, second_promise);
+        });
+    });
+    (0, node_test_1.describe)('.resolve()', () => {
+        (0, node_test_1.it)('fulfills inner promise', async () => {
+            const promise_wrapper = new promise_wrapper_1.default();
+            promise_wrapper.getPromise().then((result) => {
+                (0, node_assert_1.strictEqual)(result, 'gandalf');
+            });
+            promise_wrapper.resolve('gandalf');
+            await promise_wrapper.getPromise();
+        });
+    });
+    (0, node_test_1.describe)('.reject()', () => {
+        (0, node_test_1.it)('rejects inner promise', async () => {
+            const promise_wrapper = new promise_wrapper_1.default();
+            const test_wrapper = new promise_wrapper_1.default();
+            promise_wrapper.getPromise().catch((error) => {
+                (0, node_assert_1.strictEqual)(error.message, 'some error');
+                test_wrapper.resolve();
+            });
+            promise_wrapper.reject(new Error('some error'));
+            await test_wrapper.getPromise();
+        });
+    });
+});
+//# sourceMappingURL=promise-wrapper.js.map

package/dist/test/unit/lib/promise-wrapper/promise-wrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promise-wrapper.js","sourceRoot":"","sources":["../../../../../test/unit/lib/promise-wrapper/promise-wrapper.ts"],"names":[],"mappings":";;;;;AAAA,yCAAuC;AACvC,6CAAwC;AAExC,0EAAiD;AAEjD,IAAA,oBAAQ,EAAC,gBAAgB,EAAE,GAAG,EAAE;IAC/B,IAAA,oBAAQ,EAAC,eAAe,EAAE,GAAG,EAAE;QAC9B,IAAA,cAAE,EAAC,qDAAqD,EAAE,GAAG,EAAE;YAC9D,MAAM,eAAe,GAAG,IAAI,yBAAc,EAAU,CAAC;YACrD,MAAM,aAAa,GAAG,eAAe,CAAC,UAAU,EAAE,CAAC;YACnD,MAAM,cAAc,GAAG,eAAe,CAAC,UAAU,EAAE,CAAC;YAEpD,IAAA,yBAAW,EAAC,aAAa,EAAE,cAAc,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAA,oBAAQ,EAAC,YAAY,EAAE,GAAG,EAAE;QAC3B,IAAA,cAAE,EAAC,wBAAwB,EAAE,KAAK,IAAI,EAAE;YACvC,MAAM,eAAe,GAAG,IAAI,yBAAc,EAAU,CAAC;YAErD,eAAe,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;gBAC5C,IAAA,yBAAW,EAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YAChC,CAAC,CAAC,CAAC;YAEH,eAAe,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAEnC,MAAM,eAAe,CAAC,UAAU,EAAE,CAAC;QACpC,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAA,oBAAQ,EAAC,WAAW,EAAE,GAAG,EAAE;QAC1B,IAAA,cAAE,EAAC,uBAAuB,EAAE,KAAK,IAAI,EAAE;YACtC,MAAM,eAAe,GAAG,IAAI,yBAAc,EAAU,CAAC;YACrD,MAAM,YAAY,GAAG,IAAI,yBAAc,EAAQ,CAAC;YAEhD,eAAe,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;gBAC5C,IAAA,yBAAW,EAAC,KAAK,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;gBACzC,YAAY,CAAC,OAAO,EAAE,CAAC;YACxB,CAAC,CAAC,CAAC;YAEH,eAAe,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;YAEhD,MAAM,YAAY,CAAC,UAAU,EAAE,CAAC;QACjC,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/test/unit/lib/string/create-slug.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/unit/lib/string/create-slug.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = require("node:test");
+const node_assert_1 = require("node:assert");
+const string_1 = require("./../../../../src/lib/string/index.js");
+(0, node_test_1.describe)('createSlug()', () => {
+    (0, node_test_1.describe)('when given a string containing an emoji', () => {
+        (0, node_test_1.it)('produces the expected output', () => {
+            const input = '🗡️ sword of damocles';
+            const output = (0, string_1.createSlug)(input);
+            (0, node_assert_1.strictEqual)(output, 'sword-of-damocles');
+        });
+    });
+});
+//# sourceMappingURL=create-slug.js.map

package/dist/test/unit/lib/string/create-slug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-slug.js","sourceRoot":"","sources":["../../../../../test/unit/lib/string/create-slug.ts"],"names":[],"mappings":";;AAAA,yCAAuC;AACvC,6CAAwC;AAExC,uCAAsC;AAEtC,IAAA,oBAAQ,EAAC,cAAc,EAAE,GAAG,EAAE;IAC7B,IAAA,oBAAQ,EAAC,yCAAyC,EAAE,GAAG,EAAE;QACxD,IAAA,cAAE,EAAC,8BAA8B,EAAE,GAAG,EAAE;YACvC,MAAM,KAAK,GAAG,uBAAuB,CAAC;YACtC,MAAM,MAAM,GAAG,IAAA,mBAAU,EAAC,KAAK,CAAC,CAAC;YAEjC,IAAA,yBAAW,EAAC,MAAM,EAAG,mBAAmB,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/test/unit/lib/time/utility/sleep.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/unit/lib/time/utility/sleep.js

@@ -0,0 +1,20 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = require("node:test");
+const node_assert_1 = __importDefault(require("node:assert"));
+const time_1 = require("./../../../../../src/lib/time/index.js");
+(0, node_test_1.describe)('sleep()', () => {
+    (0, node_test_1.it)('returns a promise that resolves after the specified interval', async () => {
+        const start = Date.now();
+        const duration = 50;
+        await (0, time_1.sleep)(duration);
+        const end = Date.now();
+        const delta = end - start;
+        // Give it 5ms or so of wiggle room to prevent test flakiness.
+        (0, node_assert_1.default)(delta >= duration - 5, 'sleep() waits the specified duration');
+    });
+});
+//# sourceMappingURL=sleep.js.map

package/dist/test/unit/lib/time/utility/sleep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.js","sourceRoot":"","sources":["../../../../../../test/unit/lib/time/utility/sleep.ts"],"names":[],"mappings":";;;;;AAAA,yCAAuC;AACvC,8DAAiC;AAEjC,mCAA+B;AAE/B,IAAA,oBAAQ,EAAC,SAAS,EAAE,GAAG,EAAE;IACxB,IAAA,cAAE,EAAC,8DAA8D,EAAE,KAAK,IAAI,EAAE;QAC7E,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,EAAE,CAAC;QAEpB,MAAM,IAAA,YAAK,EAAC,QAAQ,CAAC,CAAC;QAEtB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,GAAG,GAAG,KAAK,CAAC;QAE1B,8DAA8D;QAC9D,IAAA,qBAAM,EAAC,KAAK,IAAI,QAAQ,GAAG,CAAC,EAAE,sCAAsC,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC"}