@aws-cdk/toolkit-lib 0.1.0

package/lib/api/io/private/logger.js

@@ -0,0 +1,211 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withAction = withAction;
+exports.withoutColor = withoutColor;
+exports.withoutEmojis = withoutEmojis;
+exports.withTrimmedWhitespace = withTrimmedWhitespace;
+exports.asSdkLogger = asSdkLogger;
+exports.asLogger = asLogger;
+const util = require("node:util");
+const messages_1 = require("./messages");
+const aws_cdk_1 = require("../../aws-cdk");
+/**
+ * An IoHost wrapper that adds the given action to an actionless message before
+ * sending the message to the given IoHost
+ */
+function withAction(ioHost, action) {
+    return {
+        notify: async (msg) => {
+            await ioHost.notify({
+                ...msg,
+                action,
+            });
+        },
+        requestResponse: async (msg) => {
+            return ioHost.requestResponse({
+                ...msg,
+                action,
+            });
+        },
+    };
+}
+/**
+ * An IoHost wrapper that strips out ANSI colors and styles from the message before
+ * sending the message to the given IoHost
+ */
+function withoutColor(ioHost) {
+    return {
+        notify: async (msg) => {
+            await ioHost.notify({
+                ...msg,
+                message: stripColor(msg.message),
+            });
+        },
+        requestResponse: async (msg) => {
+            return ioHost.requestResponse({
+                ...msg,
+                message: stripColor(msg.message),
+            });
+        },
+    };
+}
+function stripColor(msg) {
+    return msg.replace(/[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]/g, '');
+}
+/**
+ * An IoHost wrapper that strips out emojis from the message before
+ * sending the message to the given IoHost
+ */
+function withoutEmojis(ioHost) {
+    return {
+        notify: async (msg) => {
+            await ioHost.notify({
+                ...msg,
+                message: stripEmojis(msg.message),
+            });
+        },
+        requestResponse: async (msg) => {
+            return ioHost.requestResponse({
+                ...msg,
+                message: stripEmojis(msg.message),
+            });
+        },
+    };
+}
+function stripEmojis(msg) {
+    // https://www.unicode.org/reports/tr51/#def_emoji_presentation
+    return msg.replace(/\p{Emoji_Presentation}/gu, '');
+}
+/**
+ * An IoHost wrapper that trims whitespace at the beginning and end of messages.
+ * This is required, since after removing emojis and ANSI colors,
+ * we might end up with floating whitespace at either end.
+ */
+function withTrimmedWhitespace(ioHost) {
+    return {
+        notify: async (msg) => {
+            await ioHost.notify({
+                ...msg,
+                message: msg.message.trim(),
+            });
+        },
+        requestResponse: async (msg) => {
+            return ioHost.requestResponse({
+                ...msg,
+                message: msg.message.trim(),
+            });
+        },
+    };
+}
+// @todo these cannot be awaited WTF
+function asSdkLogger(ioHost, action) {
+    return new class {
+        // This is too much detail for our logs
+        trace(..._content) {
+        }
+        debug(..._content) {
+        }
+        /**
+         * Info is called mostly (exclusively?) for successful API calls
+         *
+         * Payload:
+         *
+         * (Note the input contains entire CFN templates, for example)
+         *
+         * ```
+         * {
+         *   clientName: 'S3Client',
+         *   commandName: 'GetBucketLocationCommand',
+         *   input: {
+         *     Bucket: '.....',
+         *     ExpectedBucketOwner: undefined
+         *   },
+         *   output: { LocationConstraint: 'eu-central-1' },
+         *   metadata: {
+         *     httpStatusCode: 200,
+         *     requestId: '....',
+         *     extendedRequestId: '...',
+         *     cfId: undefined,
+         *     attempts: 1,
+         *     totalRetryDelay: 0
+         *   }
+         * }
+         * ```
+         */
+        info(...content) {
+            void ioHost.notify({
+                action,
+                ...(0, messages_1.trace)(`[sdk info] ${(0, aws_cdk_1.formatSdkLoggerContent)(content)}`),
+                data: {
+                    sdkLevel: 'info',
+                    content,
+                },
+            });
+        }
+        warn(...content) {
+            void ioHost.notify({
+                action,
+                ...(0, messages_1.trace)(`[sdk warn] ${(0, aws_cdk_1.formatSdkLoggerContent)(content)}`),
+                data: {
+                    sdkLevel: 'warn',
+                    content,
+                },
+            });
+        }
+        /**
+         * Error is called mostly (exclusively?) for failing API calls
+         *
+         * Payload (input would be the entire API call arguments).
+         *
+         * ```
+         * {
+         *   clientName: 'STSClient',
+         *   commandName: 'GetCallerIdentityCommand',
+         *   input: {},
+         *   error: AggregateError [ECONNREFUSED]:
+         *       at internalConnectMultiple (node:net:1121:18)
+         *       at afterConnectMultiple (node:net:1688:7) {
+         *     code: 'ECONNREFUSED',
+         *     '$metadata': { attempts: 3, totalRetryDelay: 600 },
+         *     [errors]: [ [Error], [Error] ]
+         *   },
+         *   metadata: { attempts: 3, totalRetryDelay: 600 }
+         * }
+         * ```
+         */
+        error(...content) {
+            void ioHost.notify({
+                action,
+                ...(0, messages_1.trace)(`[sdk error] ${(0, aws_cdk_1.formatSdkLoggerContent)(content)}`),
+                data: {
+                    sdkLevel: 'error',
+                    content,
+                },
+            });
+        }
+    };
+}
+/**
+ * Turn an ActionAwareIoHost into a logger that is compatible with older code, but doesn't support data
+ */
+function asLogger(ioHost, category) {
+    const code = (level) => (0, messages_1.defaultMessageCode)(level, category);
+    return {
+        trace: async (msg, ...args) => {
+            await ioHost.notify((0, messages_1.trace)(util.format(msg, args), code('trace')));
+        },
+        debug: async (msg, ...args) => {
+            await ioHost.notify((0, messages_1.debug)(util.format(msg, args), code('debug')));
+        },
+        info: async (msg, ...args) => {
+            await ioHost.notify((0, messages_1.info)(util.format(msg, args), code('info')));
+        },
+        warn: async (msg, ...args) => {
+            await ioHost.notify((0, messages_1.warn)(util.format(msg, args), code('warn')));
+        },
+        error: async (msg, ...args) => {
+            await ioHost.notify((0, messages_1.error)(util.format(msg, args), code('error')));
+        },
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9nZ2VyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsibG9nZ2VyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBYUEsZ0NBZUM7QUFNRCxvQ0FlQztBQVVELHNDQWVDO0FBWUQsc0RBZUM7QUFHRCxrQ0F5RkM7QUFLRCw0QkFvQkM7QUExTkQsa0NBQWtDO0FBR2xDLHlDQUFpRjtBQUdqRiwyQ0FBdUQ7QUFHdkQ7OztHQUdHO0FBQ0gsU0FBZ0IsVUFBVSxDQUFDLE1BQWUsRUFBRSxNQUFxQjtJQUMvRCxPQUFPO1FBQ0wsTUFBTSxFQUFFLEtBQUssRUFBSyxHQUFpQyxFQUFFLEVBQUU7WUFDckQsTUFBTSxNQUFNLENBQUMsTUFBTSxDQUFDO2dCQUNsQixHQUFHLEdBQUc7Z0JBQ04sTUFBTTthQUNQLENBQUMsQ0FBQztRQUNMLENBQUM7UUFDRCxlQUFlLEVBQUUsS0FBSyxFQUFRLEdBQW9DLEVBQUUsRUFBRTtZQUNwRSxPQUFPLE1BQU0sQ0FBQyxlQUFlLENBQUM7Z0JBQzVCLEdBQUcsR0FBRztnQkFDTixNQUFNO2FBQ1AsQ0FBQyxDQUFDO1FBQ0wsQ0FBQztLQUNGLENBQUM7QUFDSixDQUFDO0FBRUQ7OztHQUdHO0FBQ0gsU0FBZ0IsWUFBWSxDQUFDLE1BQWU7SUFDMUMsT0FBTztRQUNMLE1BQU0sRUFBRSxLQUFLLEVBQUssR0FBaUIsRUFBRSxFQUFFO1lBQ3JDLE1BQU0sTUFBTSxDQUFDLE1BQU0sQ0FBQztnQkFDbEIsR0FBRyxHQUFHO2dCQUNOLE9BQU8sRUFBRSxVQUFVLENBQUMsR0FBRyxDQUFDLE9BQU8sQ0FBQzthQUNqQyxDQUFDLENBQUM7UUFDTCxDQUFDO1FBQ0QsZUFBZSxFQUFFLEtBQUssRUFBUSxHQUFvQixFQUFFLEVBQUU7WUFDcEQsT0FBTyxNQUFNLENBQUMsZUFBZSxDQUFDO2dCQUM1QixHQUFHLEdBQUc7Z0JBQ04sT0FBTyxFQUFFLFVBQVUsQ0FBQyxHQUFHLENBQUMsT0FBTyxDQUFDO2FBQ2pDLENBQUMsQ0FBQztRQUNM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LENBQUMsTUFBTSxDQUFDLElBQUEsZUFBSSxFQUFDLElBQUksQ0FBQyxNQUFNLENBQUMsR0FBRyxFQUFFLElBQUksQ0FBQyxFQUFFLElBQUksQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDLENBQUM7UUFDbEUsQ0FBQztRQUNELEtBQUssRUFBRSxLQUFLLEVBQUUsR0FBVyxFQUFFLEdBQUcsSUFBVyxFQUFFLEVBQUU7WUFDM0MsTUFBTSxNQUFNLENBQUMsTUFBTSxDQUFDLElBQUEsZ0JBQUssRUFBQyxJQUFJLENBQUMsTUFBTSxDQUFDLEdBQUcsRUFBRSxJQUFJLENBQUMsRUFBRSxJQUFJLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQyxDQUFDO1FBQ3BFLENBQUM7S0FDRixDQUFDO0FBQ0osQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCAqIGFzIHV0aWwgZnJvbSAnbm9kZTp1dGlsJztcbmltcG9ydCB0eXBlIHsgTG9nZ2VyIH0gZnJvbSAnQHNtaXRoeS90eXBlcyc7XG5pbXBvcnQgdHlwZSB7IElvTWVzc2FnZSwgSW9NZXNzYWdlTGV2ZWwsIElvUmVxdWVzdCB9IGZyb20gJy4uL2lvLW1lc3NhZ2UnO1xuaW1wb3J0IHsgZGVidWcsIGVycm9yLCBpbmZvLCBkZWZhdWx0TWVzc2FnZUNvZGUsIHRyYWNlLCB3YXJuIH0gZnJvbSAnLi9tZXNzYWdlcyc7XG5pbXBvcnQgdHlwZSB7IEFjdGlvbkF3YXJlSW9Ib3N0LCBJb01lc3NhZ2VDb2RlQ2F0ZWdvcnkgfSBmcm9tICcuL3R5cGVzJztcbmltcG9ydCB0eXBlIHsgVG9vbGtpdEFjdGlvbiB9IGZyb20gJy4uLy4uLy4uL3Rvb2xraXQnO1xuaW1wb3J0IHsgZm9ybWF0U2RrTG9nZ2VyQ29udGVudCB9IGZyb20gJy4uLy4uL2F3cy1jZGsnO1xuaW1wb3J0IHR5cGUgeyBJSW9Ib3N0IH0gZnJvbSAnLi4vaW8taG9zdCc7XG5cbi8qKlxuICogQW4gSW9Ib3N0IHdyYXBwZXIgdGhhdCBhZGRzIHRoZSBnaXZlbiBhY3Rpb24gdG8gYW4gYWN0aW9ubGVzcyBtZXNzYWdlIGJlZm9yZVxuICogc2VuZGluZyB0aGUgbWVzc2FnZSB0byB0aGUgZ2l2ZW4gSW9Ib3N0XG4gKi9cbmV4cG9ydCBmdW5jdGlvbiB3aXRoQWN0aW9uKGlvSG9zdDogSUlvSG9zdCwgYWN0aW9uOiBUb29sa2l0QWN0aW9uKSB7XG4gIHJldHVybiB7XG4gICAgbm90aWZ5OiBhc3luYyA8VD4obXNnOiBPbWl0PElvTWVzc2FnZTxUPiwgJ2FjdGlvbic+KSA9PiB7XG4gICAgICBhd2FpdCBpb0hvc3Qubm90aWZ5KHtcbiAgICAgICAgLi4ubXNnLFxuICAgICAgICBhY3Rpb24sXG4gICAgICB9KTtcbiAgICB9LFxuICAgIHJlcXVlc3RSZXNwb25zZTogYXN5bmMgPFQsIFU+KG1zZzogT21pdDxJb1JlcXVlc3Q8VCwgVT4sICdhY3Rpb24nPikgPT4ge1xuICAgICAgcmV0dXJuIGlvSG9zdC5yZXF1ZXN0UmVzcG9uc2Uoe1xuICAgICAgICAuLi5tc2csXG4gICAgICAgIGFjdGlvbixcbiAgICAgIH0pO1xuICAgIH0sXG4gIH07XG59XG5cbi8qKlxuICogQW4gSW9Ib3N0IHdyYXBwZXIgdGhhdCBzdHJpcHMgb3V0IEFOU0kgY29sb3JzIGFuZCBzdHlsZXMgZnJvbSB0aGUgbWVzc2FnZSBiZWZvcmVcbiAqIHNlbmRpbmcgdGhlIG1lc3NhZ2UgdG8gdGhlIGdpdmVuIElvSG9zdFxuICovXG5leHBvcnQgZnVuY3Rpb24gd2l0aG91dENvbG9yKGlvSG9zdDogSUlvSG9zdCk6IElJb0hvc3Qge1xuICByZXR1cm4ge1xuICAgIG5vdGlmeTogYXN5bmMgPFQ+KG1zZzogSW9NZXNzYWdlPFQ+KSA9PiB7XG4gICAgICBhd2FpdCBpb0hvc3Qubm90aWZ5KHtcbiAgICAgICAgLi4ubXNnLFxuICAgICAgICBtZXNzYWdlOiBzdHJpcENvbG9yKG1zZy5tZXNzYWdlKSxcbiAgICAgIH0pO1xuICAgIH0sXG4gICAgcmVxdWVzdFJlc3BvbnNlOiBhc3luYyA8VCwgVT4obXNnOiBJb1JlcXVlc3Q8VCwgVT4pID0+IHtcbiAgICAgIHJldHVybiBpb0hvc3QucmVxdWVzdFJlc3BvbnNlKHtcbiAgICAgICAgLi4ubXNnLFxuICAgICAgICBtZXNzYWdlOiBzdHJpcENvbG9yKG1zZy5tZXNzYWdlKSxcbiAgICAgIH0pO1xuICAgIH0sXG4gIH07XG59XG5cbmZ1bmN0aW9uIHN0cmlwQ29sb3IobXNnOiBzdHJpbmcpOiBzdHJpbmcge1xuICByZXR1cm4gbXNnLnJlcGxhY2UoL1tcXHUwMDFiXFx1MDA5Yl1bWygpIzs/XSooPzpbMC05XXsxLDR9KD86O1swLTldezAsNH0pKik/WzAtOUEtT1JaY2YtbnFyeT0+PF0vZywgJycpO1xufVxuXG4vKipcbiAqIEFuIElvSG9zdCB3cmFwcGVyIHRoYXQgc3RyaXBzIG91dCBlbW9qaXMgZnJvbSB0aGUgbWVzc2FnZSBiZWZvcmVcbiAqIHNlbmRpbmcgdGhlIG1lc3NhZ2UgdG8gdGhlIGdpdmVuIElvSG9zdFxuICovXG5leHBvcnQgZnVuY3Rpb24gd2l0aG91dEVtb2ppcyhpb0hvc3Q6IElJb0hvc3QpOiBJSW9Ib3N0IHtcbiAgcmV0dXJuIHtcbiAgICBub3RpZnk6IGFzeW5jIDxUPihtc2c6IElvTWVzc2FnZTxUPikgPT4ge1xuICAgICAgYXdhaXQgaW9Ib3N0Lm5vdGlmeSh7XG4gICAgICAgIC4uLm1zZyxcbiAgICAgICAgbWVzc2FnZTogc3RyaXBFbW9qaXMobXNnLm1lc3NhZ2UpLFxuICAgICAgfSk7XG4gICAgfSxcbiAgICByZXF1ZXN0UmVzcG9uc2U6IGFzeW5jIDxULCBVPihtc2c6IElvUmVxdWVzdDxULCBVPikgPT4ge1xuICAgICAgcmV0dXJuIGlvSG9zdC5yZXF1ZXN0UmVzcG9uc2Uoe1xuICAgICAgICAuLi5tc2csXG4gICAgICAgIG1lc3NhZ2U6IHN0cmlwRW1vamlzKG1zZy5tZXNzYWdlKSxcbiAgICAgIH0pO1xuICAgIH0sXG4gIH07XG59XG5cbmZ1bmN0aW9uIHN0cmlwRW1vamlzKG1zZzogc3RyaW5nKTogc3RyaW5nIHtcbiAgLy8gaHR0cHM6Ly93d3cudW5pY29kZS5vcmcvcmVwb3J0cy90cjUxLyNkZWZfZW1vamlfcHJlc2VudGF0aW9uXG4gIHJldHVybiBtc2cucmVwbGFjZSgvXFxwe0Vtb2ppX1ByZXNlbnRhdGlvbn0vZ3UsICcnKTtcbn1cblxuLyoqXG4gKiBBbiBJb0hvc3Qgd3JhcHBlciB0aGF0IHRyaW1zIHdoaXRlc3BhY2UgYXQgdGhlIGJlZ2lubmluZyBhbmQgZW5kIG9mIG1lc3NhZ2VzLlxuICogVGhpcyBpcyByZXF1aXJlZCwgc2luY2UgYWZ0ZXIgcmVtb3ZpbmcgZW1vamlzIGFuZCBBTlNJIGNvbG9ycyxcbiAqIHdlIG1pZ2h0IGVuZCB1cCB3aXRoIGZsb2F0aW5nIHdoaXRlc3BhY2UgYXQgZWl0aGVyIGVuZC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHdpdGhUcmltbWVkV2hpdGVzcGFjZShpb0hvc3Q6IElJb0hvc3QpOiBJSW9Ib3N0IHtcbiAgcmV0dXJuIHtcbiAgICBub3RpZnk6IGFzeW5jIDxUPihtc2c6IElvTWVzc2FnZTxUPikgPT4ge1xuICAgICAgYXdhaXQgaW9Ib3N0Lm5vdGlmeSh7XG4gICAgICAgIC4uLm1zZyxcbiAgICAgICAgbWVzc2FnZTogbXNnLm1lc3NhZ2UudHJpbSgpLFxuICAgICAgfSk7XG4gICAgfSxcbiAgICByZXF1ZXN0UmVzcG9uc2U6IGFzeW5jIDxULCBVPihtc2c6IElvUmVxdWVzdDxULCBVPikgPT4ge1xuICAgICAgcmV0dXJuIGlvSG9zdC5yZXF1ZXN0UmVzcG9uc2Uoe1xuICAgICAgICAuLi5tc2csXG4gICAgICAgIG1lc3NhZ2U6IG1zZy5tZXNzYWdlLnRyaW0oKSxcbiAgICAgIH0pO1xuICAgIH0sXG4gIH07XG59XG5cbi8vIEB0b2RvIHRoZXNlIGNhbm5vdCBiZSBhd2FpdGVkIFdURlxuZXhwb3J0IGZ1bmN0aW9uIGFzU2RrTG9nZ2VyKGlvSG9zdDogSUlvSG9zdCwgYWN0aW9uOiBUb29sa2l0QWN0aW9uKTogTG9nZ2VyIHtcbiAgcmV0dXJuIG5ldyBjbGFzcyBpbXBsZW1lbnRzIExvZ2dlciB7XG4gICAgLy8gVGhpcyBpcyB0b28gbXVjaCBkZXRhaWwgZm9yIG91ciBsb2dzXG4gICAgcHVibGljIHRyYWNlKC4uLl9jb250ZW50OiBhbnlbXSkge1xuICAgIH1cbiAgICBwdWJsaWMgZGVidWcoLi4uX2NvbnRlbnQ6IGFueVtdKSB7XG4gICAgfVxuXG4gICAgLyoqXG4gICAgICogSW5mbyBpcyBjYWxsZWQgbW9zdGx5IChleGNsdXNpdmVseT8pIGZvciBzdWNjZXNzZnVsIEFQSSBjYWxsc1xuICAgICAqXG4gICAgICogUGF5bG9hZDpcbiAgICAgKlxuICAgICAqIChOb3RlIHRoZSBpbnB1dCBjb250YWlucyBlbnRpcmUgQ0ZOIHRlbXBsYXRlcywgZm9yIGV4YW1wbGUpXG4gICAgICpcbiAgICAgKiBgYGBcbiAgICAgKiB7XG4gICAgICogICBjbGllbnROYW1lOiAnUzNDbGllbnQnLFxuICAgICAqICAgY29tbWFuZE5hbWU6ICdHZXRCdWNrZXRMb2NhdGlvbkNvbW1hbmQnLFxuICAgICAqICAgaW5wdXQ6IHtcbiAgICAgKiAgICAgQnVja2V0OiAnLi4uLi4nLFxuICAgICAqICAgICBFeHBlY3RlZEJ1Y2tldE93bmVyOiB1bmRlZmluZWRcbiAgICAgKiAgIH0sXG4gICAgICogICBvdXRwdXQ6IHsgTG9jYXRpb25Db25zdHJhaW50OiAnZXUtY2VudHJhbC0xJyB9LFxuICAgICAqICAgbWV0YWRhdGE6IHtcbiAgICAgKiAgICAgaHR0cFN0YXR1c0NvZGU6IDIwMCxcbiAgICAgKiAgICAgcmVxdWVzdElkOiAnLi4uLicsXG4gICAgICogICAgIGV4dGVuZGVkUmVxdWVzdElkOiAnLi4uJyxcbiAgICAgKiAgICAgY2ZJZDogdW5kZWZpbmVkLFxuICAgICAqICAgICBhdHRlbXB0czogMSxcbiAgICAgKiAgICAgdG90YWxSZXRyeURlbGF5OiAwXG4gICAgICogICB9XG4gICAgICogfVxuICAgICAqIGBgYFxuICAgICAqL1xuICAgIHB1YmxpYyBpbmZvKC4uLmNvbnRlbnQ6IGFueVtdKSB7XG4gICAgICB2b2lkIGlvSG9zdC5ub3RpZnkoe1xuICAgICAgICBhY3Rpb24sXG4gICAgICAgIC4uLnRyYWNlKGBbc2RrIGluZm9dICR7Zm9ybWF0U2RrTG9nZ2VyQ29udGVudChjb250ZW50KX1gKSxcbiAgICAgICAgZGF0YToge1xuICAgICAgICAgIHNka0xldmVsOiAnaW5mbycsXG4gICAgICAgICAgY29udGVudCxcbiAgICAgICAgfSxcbiAgICAgIH0pO1xuICAgIH1cblxuICAgIHB1YmxpYyB3YXJuKC4uLmNvbnRlbnQ6IGFueVtdKSB7XG4gICAgICB2b2lkIGlvSG9zdC5ub3RpZnkoe1xuICAgICAgICBhY3Rpb24sXG4gICAgICAgIC4uLnRyYWNlKGBbc2RrIHdhcm5dICR7Zm9ybWF0U2RrTG9nZ2VyQ29udGVudChjb250ZW50KX1gKSxcbiAgICAgICAgZGF0YToge1xuICAgICAgICAgIHNka0xldmVsOiAnd2FybicsXG4gICAgICAgICAgY29udGVudCxcbiAgICAgICAgfSxcbiAgICAgIH0pO1xuICAgIH1cblxuICAgIC8qKlxuICAgICAqIEVycm9yIGlzIGNhbGxlZCBtb3N0bHkgKGV4Y2x1c2l2ZWx5PykgZm9yIGZhaWxpbmcgQVBJIGNhbGxzXG4gICAgICpcbiAgICAgKiBQYXlsb2FkIChpbnB1dCB3b3VsZCBiZSB0aGUgZW50aXJlIEFQSSBjYWxsIGFyZ3VtZW50cykuXG4gICAgICpcbiAgICAgKiBgYGBcbiAgICAgKiB7XG4gICAgICogICBjbGllbnROYW1lOiAnU1RTQ2xpZW50JyxcbiAgICAgKiAgIGNvbW1hbmROYW1lOiAnR2V0Q2FsbGVySWRlbnRpdHlDb21tYW5kJyxcbiAgICAgKiAgIGlucHV0OiB7fSxcbiAgICAgKiAgIGVycm9yOiBBZ2dyZWdhdGVFcnJvciBbRUNPTk5SRUZVU0VEXTpcbiAgICAgKiAgICAgICBhdCBpbnRlcm5hbENvbm5lY3RNdWx0aXBsZSAobm9kZTpuZXQ6MTEyMToxOClcbiAgICAgKiAgICAgICBhdCBhZnRlckNvbm5lY3RNdWx0aXBsZSAobm9kZTpuZXQ6MTY4ODo3KSB7XG4gICAgICogICAgIGNvZGU6ICdFQ09OTlJFRlVTRUQnLFxuICAgICAqICAgICAnJG1ldGFkYXRhJzogeyBhdHRlbXB0czogMywgdG90YWxSZXRyeURlbGF5OiA2MDAgfSxcbiAgICAgKiAgICAgW2Vycm9yc106IFsgW0Vycm9yXSwgW0Vycm9yXSBdXG4gICAgICogICB9LFxuICAgICAqICAgbWV0YWRhdGE6IHsgYXR0ZW1wdHM6IDMsIHRvdGFsUmV0cnlEZWxheTogNjAwIH1cbiAgICAgKiB9XG4gICAgICogYGBgXG4gICAgICovXG4gICAgcHVibGljIGVycm9yKC4uLmNvbnRlbnQ6IGFueVtdKSB7XG4gICAgICB2b2lkIGlvSG9zdC5ub3RpZnkoe1xuICAgICAgICBhY3Rpb24sXG4gICAgICAgIC4uLnRyYWNlKGBbc2RrIGVycm9yXSAke2Zvcm1hdFNka0xvZ2dlckNvbnRlbnQoY29udGVudCl9YCksXG4gICAgICAgIGRhdGE6IHtcbiAgICAgICAgICBzZGtMZXZlbDogJ2Vycm9yJyxcbiAgICAgICAgICBjb250ZW50LFxuICAgICAgICB9LFxuICAgICAgfSk7XG4gICAgfVxuICB9O1xufVxuXG4vKipcbiAqIFR1cm4gYW4gQWN0aW9uQXdhcmVJb0hvc3QgaW50byBhIGxvZ2dlciB0aGF0IGlzIGNvbXBhdGlibGUgd2l0aCBvbGRlciBjb2RlLCBidXQgZG9lc24ndCBzdXBwb3J0IGRhdGFcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGFzTG9nZ2VyKGlvSG9zdDogQWN0aW9uQXdhcmVJb0hvc3QsIGNhdGVnb3J5PzogSW9NZXNzYWdlQ29kZUNhdGVnb3J5KSB7XG4gIGNvbnN0IGNvZGUgPSAobGV2ZWw6IElvTWVzc2FnZUxldmVsKSA9PiBkZWZhdWx0TWVzc2FnZUNvZGUobGV2ZWwsIGNhdGVnb3J5KTtcblxuICByZXR1cm4ge1xuICAgIHRyYWNlOiBhc3luYyAobXNnOiBzdHJpbmcsIC4uLmFyZ3M6IGFueVtdKSA9PiB7XG4gICAgICBhd2FpdCBpb0hvc3Qubm90aWZ5KHRyYWNlKHV0aWwuZm9ybWF0KG1zZywgYXJncyksIGNvZGUoJ3RyYWNlJykpKTtcbiAgICB9LFxuICAgIGRlYnVnOiBhc3luYyAobXNnOiBzdHJpbmcsIC4uLmFyZ3M6IGFueVtdKSA9PiB7XG4gICAgICBhd2FpdCBpb0hvc3Qubm90aWZ5KGRlYnVnKHV0aWwuZm9ybWF0KG1zZywgYXJncyksIGNvZGUoJ2RlYnVnJykpKTtcbiAgICB9LFxuICAgIGluZm86IGFzeW5jIChtc2c6IHN0cmluZywgLi4uYXJnczogYW55W10pID0+IHtcbiAgICAgIGF3YWl0IGlvSG9zdC5ub3RpZnkoaW5mbyh1dGlsLmZvcm1hdChtc2csIGFyZ3MpLCBjb2RlKCdpbmZvJykpKTtcbiAgICB9LFxuICAgIHdhcm46IGFzeW5jIChtc2c6IHN0cmluZywgLi4uYXJnczogYW55W10pID0+IHtcbiAgICAgIGF3YWl0IGlvSG9zdC5ub3RpZnkod2Fybih1dGlsLmZvcm1hdChtc2csIGFyZ3MpLCBjb2RlKCd3YXJuJykpKTtcbiAgICB9LFxuICAgIGVycm9yOiBhc3luYyAobXNnOiBzdHJpbmcsIC4uLmFyZ3M6IGFueVtdKSA9PiB7XG4gICAgICBhd2FpdCBpb0hvc3Qubm90aWZ5KGVycm9yKHV0aWwuZm9ybWF0KG1zZywgYXJncyksIGNvZGUoJ2Vycm9yJykpKTtcbiAgICB9LFxuICB9O1xufVxuIl19

package/lib/api/io/private/messages.d.ts

@@ -0,0 +1,64 @@
+import type { IoMessageLevel } from '../io-message';
+import { type VALID_CODE } from './codes';
+import type { ActionLessMessage, ActionLessRequest, IoMessageCodeCategory, Optional, SimplifiedMessage } from './types';
+/**
+ * Internal helper that processes log inputs into a consistent format.
+ * Handles string interpolation, format strings, and object parameter styles.
+ * Applies optional styling and prepares the final message for logging.
+ */
+export declare function formatMessage<T>(msg: Optional<SimplifiedMessage<T>, 'code'>, category?: IoMessageCodeCategory): ActionLessMessage<T>;
+/**
+ * Build a message code from level and category. The code must be valid for this function to pass.
+ * Otherwise it returns a ToolkitError.
+ */
+export declare function defaultMessageCode(level: IoMessageLevel, category?: IoMessageCodeCategory): VALID_CODE;
+/**
+ * Requests a yes/no confirmation from the IoHost.
+ */
+export declare const confirm: (code: VALID_CODE, question: string, motivation: string, defaultResponse: boolean, concurrency?: number) => ActionLessRequest<{
+    motivation: string;
+    concurrency?: number;
+}, boolean>;
+/**
+ * Prompt for a a response from the IoHost.
+ */
+export declare const prompt: <T, U>(code: VALID_CODE, message: string, defaultResponse: U, payload?: T) => ActionLessRequest<T, U>;
+/**
+ * Creates an error level message.
+ * Errors must always have a unique code.
+ */
+export declare const error: <T>(message: string, code: VALID_CODE, payload?: T) => ActionLessMessage<T>;
+/**
+ * Creates a result level message and represents the most important message for a given action.
+ *
+ * They should be used sparsely, with an action usually having no or exactly one result.
+ * However actions that operate on Cloud Assemblies might include a result per Stack.
+ * Unlike other messages, results must always have a code and a payload.
+ */
+export declare const result: <T>(message: string, code: VALID_CODE, payload: T) => ActionLessMessage<T>;
+/**
+ * Creates a warning level message.
+ */
+export declare const warn: <T>(message: string, code?: VALID_CODE, payload?: T) => ActionLessMessage<T>;
+/**
+ * Creates an info level message.
+ */
+export declare const info: <T>(message: string, code?: VALID_CODE, payload?: T) => ActionLessMessage<T>;
+/**
+ * Creates a debug level message.
+ */
+export declare const debug: <T>(message: string, code?: VALID_CODE, payload?: T) => ActionLessMessage<T>;
+/**
+ * Creates a trace level message.
+ */
+export declare const trace: <T>(message: string, code?: VALID_CODE, payload?: T) => ActionLessMessage<T>;
+/**
+ * Creates an info level success message in green text.
+ * @deprecated
+ */
+export declare const success: <T>(message: string, code?: VALID_CODE, payload?: T) => ActionLessMessage<T>;
+/**
+ * Creates an info level message in bold text.
+ * @deprecated
+ */
+export declare const highlight: <T>(message: string, code?: VALID_CODE, payload?: T) => ActionLessMessage<T>;

package/lib/api/io/private/messages.js

@@ -0,0 +1,159 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.highlight = exports.success = exports.trace = exports.debug = exports.info = exports.warn = exports.result = exports.error = exports.prompt = exports.confirm = void 0;
+exports.formatMessage = formatMessage;
+exports.defaultMessageCode = defaultMessageCode;
+const chalk = require("chalk");
+/**
+ * Internal helper that processes log inputs into a consistent format.
+ * Handles string interpolation, format strings, and object parameter styles.
+ * Applies optional styling and prepares the final message for logging.
+ */
+function formatMessage(msg, category = 'TOOLKIT') {
+    return {
+        time: new Date(),
+        level: msg.level,
+        code: msg.code ?? defaultMessageCode(msg.level, category),
+        message: msg.message,
+        data: msg.data,
+    };
+}
+/**
+ * Build a message code from level and category. The code must be valid for this function to pass.
+ * Otherwise it returns a ToolkitError.
+ */
+function defaultMessageCode(level, category = 'TOOLKIT') {
+    const levelIndicator = level === 'error' ? 'E' :
+        level === 'warn' ? 'W' :
+            'I';
+    return `CDK_${category}_${levelIndicator}0000`;
+}
+/**
+ * Requests a yes/no confirmation from the IoHost.
+ */
+const confirm = (code, question, motivation, defaultResponse, concurrency) => {
+    return (0, exports.prompt)(code, `${chalk.cyan(question)} (y/n)?`, defaultResponse, {
+        motivation,
+        concurrency,
+    });
+};
+exports.confirm = confirm;
+/**
+ * Prompt for a a response from the IoHost.
+ */
+const prompt = (code, message, defaultResponse, payload) => {
+    return {
+        defaultResponse,
+        ...formatMessage({
+            level: 'info',
+            code,
+            message,
+            data: payload,
+        }),
+    };
+};
+exports.prompt = prompt;
+/**
+ * Creates an error level message.
+ * Errors must always have a unique code.
+ */
+const error = (message, code, payload) => {
+    return formatMessage({
+        level: 'error',
+        code,
+        message,
+        data: payload,
+    });
+};
+exports.error = error;
+/**
+ * Creates a result level message and represents the most important message for a given action.
+ *
+ * They should be used sparsely, with an action usually having no or exactly one result.
+ * However actions that operate on Cloud Assemblies might include a result per Stack.
+ * Unlike other messages, results must always have a code and a payload.
+ */
+const result = (message, code, payload) => {
+    return formatMessage({
+        level: 'result',
+        code,
+        message,
+        data: payload,
+    });
+};
+exports.result = result;
+/**
+ * Creates a warning level message.
+ */
+const warn = (message, code, payload) => {
+    return formatMessage({
+        level: 'warn',
+        code,
+        message,
+        data: payload,
+    });
+};
+exports.warn = warn;
+/**
+ * Creates an info level message.
+ */
+const info = (message, code, payload) => {
+    return formatMessage({
+        level: 'info',
+        code,
+        message,
+        data: payload,
+    });
+};
+exports.info = info;
+/**
+ * Creates a debug level message.
+ */
+const debug = (message, code, payload) => {
+    return formatMessage({
+        level: 'debug',
+        code,
+        message,
+        data: payload,
+    });
+};
+exports.debug = debug;
+/**
+ * Creates a trace level message.
+ */
+const trace = (message, code, payload) => {
+    return formatMessage({
+        level: 'trace',
+        code,
+        message,
+        data: payload,
+    });
+};
+exports.trace = trace;
+/**
+ * Creates an info level success message in green text.
+ * @deprecated
+ */
+const success = (message, code, payload) => {
+    return formatMessage({
+        level: 'info',
+        code,
+        message: chalk.green(message),
+        data: payload,
+    });
+};
+exports.success = success;
+/**
+ * Creates an info level message in bold text.
+ * @deprecated
+ */
+const highlight = (message, code, payload) => {
+    return formatMessage({
+        level: 'info',
+        code,
+        message: chalk.bold(message),
+        data: payload,
+    });
+};
+exports.highlight = highlight;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWVzc2FnZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJtZXNzYWdlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFVQSxzQ0FRQztBQU1ELGdEQUtDO0FBN0JELCtCQUErQjtBQUsvQjs7OztHQUlHO0FBQ0gsU0FBZ0IsYUFBYSxDQUFJLEdBQTJDLEVBQUUsV0FBa0MsU0FBUztJQUN2SCxPQUFPO1FBQ0wsSUFBSSxFQUFFLElBQUksSUFBSSxFQUFFO1FBQ2hCLEtBQUssRUFBRSxHQUFHLENBQUMsS0FBSztRQUNoQixJQUFJLEVBQUUsR0FBRyxDQUFDLElBQUksSUFBSSxrQkFBa0IsQ0FBQyxHQUFHLENBQUMsS0FBSyxFQUFFLFFBQVEsQ0FBQztRQUN6RCxPQUFPLEVBQUUsR0FBRyxDQUFDLE9BQU87UUFDcEIsSUFBSSxFQUFFLEdBQUcsQ0FBQyxJQUFJO0tBQ2YsQ0FBQztBQUNKLENBQUM7QUFFRDs7O0dBR0c7QUFDSCxTQUFnQixrQkFBa0IsQ0FBQyxLQUFxQixFQUFFLFdBQWtDLFNBQVM7SUFDbkcsTUFBTSxjQUFjLEdBQUcsS0FBSyxLQUFLLE9BQU8sQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDLENBQUM7UUFDOUMsS0FBSyxLQUFLLE1BQU0sQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDLENBQUM7WUFDdEIsR0FBRyxDQUFDO0lBQ1IsT0FBTyxPQUFPLFFBQVEsSUFBSSxjQUFjLE1BQW9CLENBQUM7QUFDL0QsQ0FBQztBQUVEOztHQUVHO0FBQ0ksTUFBTSxPQUFPLEdBQUcsQ0FDckIsSUFBZ0IsRUFDaEIsUUFBZ0IsRUFDaEIsVUFBa0IsRUFDbEIsZUFBd0IsRUFDeEIsV0FBb0IsRUFJVixFQUFFO0lBQ1osT0FBTyxJQUFBLGNBQU0sRUFBQyxJQUFJLEVBQUUsR0FBRyxLQUFLLENBQUMsSUFBSSxDQUFDLFFBQVEsQ0FBQyxTQUFTLEVBQUUsZUFBZSxFQUFFO1FBQ3JFLFVBQVU7UUFDVixXQUFXO0tBQ1osQ0FBQyxDQUFDO0FBQ0ws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RUFBRSxPQUFXLEVBQUUsRUFBRTtJQUM5RSxPQUFPLGFBQWEsQ0FBQztRQUNuQixLQUFLLEVBQUUsTUFBTTtRQUNiLElBQUk7UUFDSixPQUFPLEVBQUUsS0FBSyxDQUFDLElBQUksQ0FBQyxPQUFPLENBQUM7UUFDNUIsSUFBSSxFQUFFLE9BQU87S0FDZCxDQUFDLENBQUM7QUFDTCxDQUFDLENBQUM7QUFQVyxRQUFBLFNBQVMsYUFPcEIiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgKiBhcyBjaGFsayBmcm9tICdjaGFsayc7XG5pbXBvcnQgdHlwZSB7IElvTWVzc2FnZUxldmVsIH0gZnJvbSAnLi4vaW8tbWVzc2FnZSc7XG5pbXBvcnQgeyB0eXBlIFZBTElEX0NPREUgfSBmcm9tICcuL2NvZGVzJztcbmltcG9ydCB0eXBlIHsgQWN0aW9uTGVzc01lc3NhZ2UsIEFjdGlvbkxlc3NSZXF1ZXN0LCBJb01lc3NhZ2VDb2RlQ2F0ZWdvcnksIE9wdGlvbmFsLCBTaW1wbGlmaWVkTWVzc2FnZSB9IGZyb20gJy4vdHlwZXMnO1xuXG4vKipcbiAqIEludGVybmFsIGhlbHBlciB0aGF0IHByb2Nlc3NlcyBsb2cgaW5wdXRzIGludG8gYSBjb25zaXN0ZW50IGZvcm1hdC5cbiAqIEhhbmRsZXMgc3RyaW5nIGludGVycG9sYXRpb24sIGZvcm1hdCBzdHJpbmdzLCBhbmQgb2JqZWN0IHBhcmFtZXRlciBzdHlsZXMuXG4gKiBBcHBsaWVzIG9wdGlvbmFsIHN0eWxpbmcgYW5kIHByZXBhcmVzIHRoZSBmaW5hbCBtZXNzYWdlIGZvciBsb2dnaW5nLlxuICovXG5leHBvcnQgZnVuY3Rpb24gZm9ybWF0TWVzc2FnZTxUPihtc2c6IE9wdGlvbmFsPFNpbXBsaWZpZWRNZXNzYWdlPFQ+LCAnY29kZSc+LCBjYXRlZ29yeTogSW9NZXNzYWdlQ29kZUNhdGVnb3J5ID0gJ1RPT0xLSVQnKTogQWN0aW9uTGVzc01lc3NhZ2U8VD4ge1xuICByZXR1cm4ge1xuICAgIHRpbWU6IG5ldyBEYXRlKCksXG4gICAgbGV2ZWw6IG1zZy5sZXZlbCxcbiAgICBjb2RlOiBtc2cuY29kZSA/PyBkZWZhdWx0TWVzc2FnZUNvZGUobXNnLmxldmVsLCBjYXRlZ29yeSksXG4gICAgbWVzc2FnZTogbXNnLm1lc3NhZ2UsXG4gICAgZGF0YTogbXNnLmRhdGEsXG4gIH07XG59XG5cbi8qKlxuICogQnVpbGQgYSBtZXNzYWdlIGNvZGUgZnJvbSBsZXZlbCBhbmQgY2F0ZWdvcnkuIFRoZSBjb2RlIG11c3QgYmUgdmFsaWQgZm9yIHRoaXMgZnVuY3Rpb24gdG8gcGFzcy5cbiAqIE90aGVyd2lzZSBpdCByZXR1cm5zIGEgVG9vbGtpdEVycm9yLlxuICovXG5leHBvcnQgZnVuY3Rpb24gZGVmYXVsdE1lc3NhZ2VDb2RlKGxldmVsOiBJb01lc3NhZ2VMZXZlbCwgY2F0ZWdvcnk6IElvTWVzc2FnZUNvZGVDYXRlZ29yeSA9ICdUT09MS0lUJyk6IFZBTElEX0NPREUge1xuICBjb25zdCBsZXZlbEluZGljYXRvciA9IGxldmVsID09PSAnZXJyb3InID8gJ0UnIDpcbiAgICBsZXZlbCA9PT0gJ3dhcm4nID8gJ1cnIDpcbiAgICAgICdJJztcbiAgcmV0dXJuIGBDREtfJHtjYXRlZ29yeX1fJHtsZXZlbEluZGljYXRvcn0wMDAwYCBhcyBWQUxJRF9DT0RFO1xufVxuXG4vKipcbiAqIFJlcXVlc3RzIGEgeWVzL25vIGNvbmZpcm1hdGlvbiBmcm9tIHRoZSBJb0hvc3QuXG4gKi9cbmV4cG9ydCBjb25zdCBjb25maXJtID0gKFxuICBjb2RlOiBWQUxJRF9DT0RFLFxuICBxdWVzdGlvbjogc3RyaW5nLFxuICBtb3RpdmF0aW9uOiBzdHJpbmcsXG4gIGRlZmF1bHRSZXNwb25zZTogYm9vbGVhbixcbiAgY29uY3VycmVuY3k/OiBudW1iZXIsXG4pOiBBY3Rpb25MZXNzUmVxdWVzdDx7XG4gIG1vdGl2YXRpb246IHN0cmluZztcbiAgY29uY3VycmVuY3k/OiBudW1iZXI7XG59LCBib29sZWFuPiA9PiB7XG4gIHJldHVybiBwcm9tcHQoY29kZSwgYCR7Y2hhbGsuY3lhbihxdWVzdGlvbil9ICh5L24pP2AsIGRlZmF1bHRSZXNwb25zZSwge1xuICAgIG1vdGl2YXRpb24sXG4gICAgY29uY3VycmVuY3ksXG4gIH0pO1xufTtcblxuLyoqXG4gKiBQcm9tcHQgZm9yIGEgYSByZXNwb25zZSBmcm9tIHRoZSBJb0hvc3QuXG4gKi9cbmV4cG9ydCBjb25zdCBwcm9tcHQgPSA8VCwgVT4oY29kZTogVkFMSURfQ09ERSwgbWVzc2FnZTogc3RyaW5nLCBkZWZhdWx0UmVzcG9uc2U6IFUsIHBheWxvYWQ/OiBUKTogQWN0aW9uTGVzc1JlcXVlc3Q8VCwgVT4gPT4ge1xuICByZXR1cm4ge1xuICAgIGRlZmF1bHRSZXNwb25zZSxcbiAgICAuLi5mb3JtYXRNZXNzYWdlKHtcbiAgICAgIGxldmVsOiAnaW5mbycsXG4gICAgICBjb2RlLFxuICAgICAgbWVzc2FnZSxcbiAgICAgIGRhdGE6IHBheWxvYWQsXG4gICAgfSksXG4gIH07XG59O1xuXG4vKipcbiAqIENyZWF0ZXMgYW4gZXJyb3IgbGV2ZWwgbWVzc2FnZS5cbiAqIEVycm9ycyBtdXN0IGFsd2F5cyBoYXZlIGEgdW5pcXVlIGNvZGUuXG4gKi9cbmV4cG9ydCBjb25zdCBlcnJvciA9IDxUPihtZXNzYWdlOiBzdHJpbmcsIGNvZGU6IFZBTElEX0NPREUsIHBheWxvYWQ/OiBUKSA9PiB7XG4gIHJldHVybiBmb3JtYXRNZXNzYWdlKHtcbiAgICBsZXZlbDogJ2Vycm9yJyxcbiAgICBjb2RlLFxuICAgIG1lc3NhZ2UsXG4gICAgZGF0YTogcGF5bG9hZCxcbiAgfSk7XG59O1xuXG4vKipcbiAqIENyZWF0ZXMgYSByZXN1bHQgbGV2ZWwgbWVzc2FnZSBhbmQgcmVwcmVzZW50cyB0aGUgbW9zdCBpbXBvcnRhbnQgbWVzc2FnZSBmb3IgYSBnaXZlbiBhY3Rpb24uXG4gKlxuICogVGhleSBzaG91bGQgYmUgdXNlZCBzcGFyc2VseSwgd2l0aCBhbiBhY3Rpb24gdXN1YWxseSBoYXZpbmcgbm8gb3IgZXhhY3RseSBvbmUgcmVzdWx0LlxuICogSG93ZXZlciBhY3Rpb25zIHRoYXQgb3BlcmF0ZSBvbiBDbG91ZCBBc3NlbWJsaWVzIG1pZ2h0IGluY2x1ZGUgYSByZXN1bHQgcGVyIFN0YWNrLlxuICogVW5saWtlIG90aGVyIG1lc3NhZ2VzLCByZXN1bHRzIG11c3QgYWx3YXlzIGhhdmUgYSBjb2RlIGFuZCBhIHBheWxvYWQuXG4gKi9cbmV4cG9ydCBjb25zdCByZXN1bHQgPSA8VD4obWVzc2FnZTogc3RyaW5nLCBjb2RlOiBWQUxJRF9DT0RFLCBwYXlsb2FkOiBUKSA9PiB7XG4gIHJldHVybiBmb3JtYXRNZXNzYWdlKHtcbiAgICBsZXZlbDogJ3Jlc3VsdCcsXG4gICAgY29kZSxcbiAgICBtZXNzYWdlLFxuICAgIGRhdGE6IHBheWxvYWQsXG4gIH0pO1xufTtcblxuLyoqXG4gKiBDcmVhdGVzIGEgd2FybmluZyBsZXZlbCBtZXNzYWdlLlxuICovXG5leHBvcnQgY29uc3Qgd2FybiA9IDxUPihtZXNzYWdlOiBzdHJpbmcsIGNvZGU/OiBWQUxJRF9DT0RFLCBwYXlsb2FkPzogVCkgPT4ge1xuICByZXR1cm4gZm9ybWF0TWVzc2FnZSh7XG4gICAgbGV2ZWw6ICd3YXJuJyxcbiAgICBjb2RlLFxuICAgIG1lc3NhZ2UsXG4gICAgZGF0YTogcGF5bG9hZCxcbiAgfSk7XG59O1xuXG4vKipcbiAqIENyZWF0ZXMgYW4gaW5mbyBsZXZlbCBtZXNzYWdlLlxuICovXG5leHBvcnQgY29uc3QgaW5mbyA9IDxUPihtZXNzYWdlOiBzdHJpbmcsIGNvZGU/OiBWQUxJRF9DT0RFLCBwYXlsb2FkPzogVCkgPT4ge1xuICByZXR1cm4gZm9ybWF0TWVzc2FnZSh7XG4gICAgbGV2ZWw6ICdpbmZvJyxcbiAgICBjb2RlLFxuICAgIG1lc3NhZ2UsXG4gICAgZGF0YTogcGF5bG9hZCxcbiAgfSk7XG59O1xuXG4vKipcbiAqIENyZWF0ZXMgYSBkZWJ1ZyBsZXZlbCBtZXNzYWdlLlxuICovXG5leHBvcnQgY29uc3QgZGVidWcgPSA8VD4obWVzc2FnZTogc3RyaW5nLCBjb2RlPzogVkFMSURfQ09ERSwgcGF5bG9hZD86IFQpID0+IHtcbiAgcmV0dXJuIGZvcm1hdE1lc3NhZ2Uoe1xuICAgIGxldmVsOiAnZGVidWcnLFxuICAgIGNvZGUsXG4gICAgbWVzc2FnZSxcbiAgICBkYXRhOiBwYXlsb2FkLFxuICB9KTtcbn07XG5cbi8qKlxuICogQ3JlYXRlcyBhIHRyYWNlIGxldmVsIG1lc3NhZ2UuXG4gKi9cbmV4cG9ydCBjb25zdCB0cmFjZSA9IDxUPihtZXNzYWdlOiBzdHJpbmcsIGNvZGU/OiBWQUxJRF9DT0RFLCBwYXlsb2FkPzogVCkgPT4ge1xuICByZXR1cm4gZm9ybWF0TWVzc2FnZSh7XG4gICAgbGV2ZWw6ICd0cmFjZScsXG4gICAgY29kZSxcbiAgICBtZXNzYWdlLFxuICAgIGRhdGE6IHBheWxvYWQsXG4gIH0pO1xufTtcblxuLyoqXG4gKiBDcmVhdGVzIGFuIGluZm8gbGV2ZWwgc3VjY2VzcyBtZXNzYWdlIGluIGdyZWVuIHRleHQuXG4gKiBAZGVwcmVjYXRlZFxuICovXG5leHBvcnQgY29uc3Qgc3VjY2VzcyA9IDxUPihtZXNzYWdlOiBzdHJpbmcsIGNvZGU/OiBWQUxJRF9DT0RFLCBwYXlsb2FkPzogVCkgPT4ge1xuICByZXR1cm4gZm9ybWF0TWVzc2FnZSh7XG4gICAgbGV2ZWw6ICdpbmZvJyxcbiAgICBjb2RlLFxuICAgIG1lc3NhZ2U6IGNoYWxrLmdyZWVuKG1lc3NhZ2UpLFxuICAgIGRhdGE6IHBheWxvYWQsXG4gIH0pO1xufTtcblxuLyoqXG4gKiBDcmVhdGVzIGFuIGluZm8gbGV2ZWwgbWVzc2FnZSBpbiBib2xkIHRleHQuXG4gKiBAZGVwcmVjYXRlZFxuICovXG5leHBvcnQgY29uc3QgaGlnaGxpZ2h0ID0gPFQ+KG1lc3NhZ2U6IHN0cmluZywgY29kZT86IFZBTElEX0NPREUsIHBheWxvYWQ/OiBUKSA9PiB7XG4gIHJldHVybiBmb3JtYXRNZXNzYWdlKHtcbiAgICBsZXZlbDogJ2luZm8nLFxuICAgIGNvZGUsXG4gICAgbWVzc2FnZTogY2hhbGsuYm9sZChtZXNzYWdlKSxcbiAgICBkYXRhOiBwYXlsb2FkLFxuICB9KTtcbn07XG4iXX0=

package/lib/api/io/private/timer.d.ts

@@ -0,0 +1,29 @@
+import { ActionAwareIoHost } from './types';
+/**
+ * Helper class to measure the time of code.
+ */
+export declare class Timer {
+    /**
+     * Start the timer.
+     * @return the timer instance
+     */
+    static start(): Timer;
+    private readonly startTime;
+    private constructor();
+    /**
+     * End the current timer.
+     * @returns the elapsed time
+     */
+    end(): {
+        asMs: number;
+        asSec: number;
+    };
+    /**
+     * Ends the current timer as a specified timing and notifies the IoHost.
+     * @returns the elapsed time
+     */
+    endAs(ioHost: ActionAwareIoHost, type: 'synth' | 'deploy' | 'rollback' | 'destroy'): Promise<{
+        asMs: number;
+        asSec: number;
+    }>;
+}

package/lib/api/io/private/timer.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Timer = void 0;
+const messages_1 = require("./messages");
+const aws_cdk_1 = require("../../aws-cdk");
+/**
+ * Helper class to measure the time of code.
+ */
+class Timer {
+    /**
+     * Start the timer.
+     * @return the timer instance
+     */
+    static start() {
+        return new Timer();
+    }
+    startTime;
+    constructor() {
+        this.startTime = new Date().getTime();
+    }
+    /**
+     * End the current timer.
+     * @returns the elapsed time
+     */
+    end() {
+        const elapsedTime = new Date().getTime() - this.startTime;
+        return {
+            asMs: elapsedTime,
+            asSec: (0, aws_cdk_1.formatTime)(elapsedTime),
+        };
+    }
+    /**
+     * Ends the current timer as a specified timing and notifies the IoHost.
+     * @returns the elapsed time
+     */
+    async endAs(ioHost, type) {
+        const duration = this.end();
+        const { code, text } = timerMessageProps(type);
+        await ioHost.notify((0, messages_1.info)(`\n✨  ${text} time: ${duration.asSec}s\n`, code, {
+            duration: duration.asMs,
+        }));
+        return duration;
+    }
+}
+exports.Timer = Timer;
+function timerMessageProps(type) {
+    switch (type) {
+        case 'synth': return { code: 'CDK_TOOLKIT_I1000', text: 'Synthesis' };
+        case 'deploy': return { code: 'CDK_TOOLKIT_I5000', text: 'Deployment' };
+        case 'rollback': return { code: 'CDK_TOOLKIT_I6000', text: 'Rollback' };
+        case 'destroy': return { code: 'CDK_TOOLKIT_I7000', text: 'Destroy' };
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGltZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJ0aW1lci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFDQSx5Q0FBa0M7QUFFbEMsMkNBQTJDO0FBRTNDOztHQUVHO0FBQ0gsTUFBYSxLQUFLO0lBQ2hCOzs7T0FHRztJQUNJLE1BQU0sQ0FBQyxLQUFLO1FBQ2pCLE9BQU8sSUFBSSxLQUFLLEVBQUUsQ0FBQztJQUNyQixDQUFDO0lBRWdCLFNBQVMsQ0FBUztJQUVuQztRQUNFLElBQUksQ0FBQyxTQUFTLEdBQUcsSUFBSSxJQUFJLEVBQUUsQ0FBQyxPQUFPLEVBQUUsQ0FBQztJQUN4QyxDQUFDO0lBRUQ7OztPQUdHO0lBQ0ksR0FBRztRQUNSLE1BQU0sV0FBVyxHQUFHLElBQUksSUFBSSxFQUFFLENBQUMsT0FBTyxFQUFFLEdBQUcsSUFBSSxDQUFDLFNBQVMsQ0FBQztRQUMxRCxPQUFPO1lBQ0wsSUFBSSxFQUFFLFdBQVc7WUFDakIsS0FBSyxFQUFFLElBQUEsb0JBQVUsRUFBQyxXQUFXLENBQUM7U0FDL0IsQ0FBQztJQUNKLENBQUM7SUFFRDs7O09BR0c7SUFDSSxLQUFLLENBQUMsS0FBSyxDQUFDLE1BQXlCLEVBQUUsSUFBaUQ7UUFDN0YsTUFBTSxRQUFRLEdBQUcsSUFBSSxDQUFDLEdBQUcsRUFBRSxDQUFDO1FBQzVCLE1BQU0sRUFBRSxJQUFJLEVBQUUsSUFBSSxFQUFFLEdBQUcsaUJBQWlCLENBQUMsSUFBSSxDQUFDLENBQUM7UUFFL0MsTUFBTSxNQUFNLENBQUMsTUFBTSxDQUFDLElBQUEsZUFBSSxFQUFDLFFBQVEsSUFBSSxVQUFVLFFBQVEsQ0FBQyxLQUFLLEtBQUssRUFBRSxJQUFJLEVBQUU7WUFDeEUsUUFBUSxFQUFFLFFBQVEsQ0FBQyxJQUFJO1NBQ3hCLENBQUMsQ0FBQyxDQUFDO1FBRUosT0FBTyxRQUFRLENBQUM7SUFDbEIsQ0FBQztDQUNGO0FBekNELHNCQXlDQztBQUVELFNBQVMsaUJBQWlCLENBQUMsSUFBZ0Q7SUFJekUsUUFBUSxJQUFJLEVBQUUsQ0FBQztRQUNiLEtBQUssT0FBTyxDQUFDLENBQUMsT0FBTyxFQUFFLElBQUksRUFBRSxtQkFBbUIsRUFBRSxJQUFJLEVBQUUsV0FBVyxFQUFFLENBQUM7UUFDdEUsS0FBSyxRQUFRLENBQUMsQ0FBQyxPQUFPLEVBQUUsSUFBSSxFQUFFLG1CQUFtQixFQUFFLElBQUksRUFBRSxZQUFZLEVBQUUsQ0FBQztRQUN4RSxLQUFLLFVBQVUsQ0FBQyxDQUFDLE9BQU8sRUFBRSxJQUFJLEVBQUUsbUJBQW1CLEVBQUUsSUFBSSxFQUFFLFVBQVUsRUFBRSxDQUFDO1FBQ3hFLEtBQUssU0FBUyxDQUFDLENBQUMsT0FBTyxFQUFFLElBQUksRUFBRSxtQkFBbUIsRUFBRSxJQUFJLEVBQUUsU0FBUyxFQUFFLENBQUM7SUFDeEUsQ0FBQztBQUNILENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBWQUxJRF9DT0RFIH0gZnJvbSAnLi9jb2Rlcyc7XG5pbXBvcnQgeyBpbmZvIH0gZnJvbSAnLi9tZXNzYWdlcyc7XG5pbXBvcnQgeyBBY3Rpb25Bd2FyZUlvSG9zdCB9IGZyb20gJy4vdHlwZXMnO1xuaW1wb3J0IHsgZm9ybWF0VGltZSB9IGZyb20gJy4uLy4uL2F3cy1jZGsnO1xuXG4vKipcbiAqIEhlbHBlciBjbGFzcyB0byBtZWFzdXJlIHRoZSB0aW1lIG9mIGNvZGUuXG4gKi9cbmV4cG9ydCBjbGFzcyBUaW1lciB7XG4gIC8qKlxuICAgKiBTdGFydCB0aGUgdGltZXIuXG4gICAqIEByZXR1cm4gdGhlIHRpbWVyIGluc3RhbmNlXG4gICAqL1xuICBwdWJsaWMgc3RhdGljIHN0YXJ0KCk6IFRpbWVyIHtcbiAgICByZXR1cm4gbmV3IFRpbWVyKCk7XG4gIH1cblxuICBwcml2YXRlIHJlYWRvbmx5IHN0YXJ0VGltZTogbnVtYmVyO1xuXG4gIHByaXZhdGUgY29uc3RydWN0b3IoKSB7XG4gICAgdGhpcy5zdGFydFRpbWUgPSBuZXcgRGF0ZSgpLmdldFRpbWUoKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBFbmQgdGhlIGN1cnJlbnQgdGltZXIuXG4gICAqIEByZXR1cm5zIHRoZSBlbGFwc2VkIHRpbWVcbiAgICovXG4gIHB1YmxpYyBlbmQoKSB7XG4gICAgY29uc3QgZWxhcHNlZFRpbWUgPSBuZXcgRGF0ZSgpLmdldFRpbWUoKSAtIHRoaXMuc3RhcnRUaW1lO1xuICAgIHJldHVybiB7XG4gICAgICBhc01zOiBlbGFwc2VkVGltZSxcbiAgICAgIGFzU2VjOiBmb3JtYXRUaW1lKGVsYXBzZWRUaW1lKSxcbiAgICB9O1xuICB9XG5cbiAgLyoqXG4gICAqIEVuZHMgdGhlIGN1cnJlbnQgdGltZXIgYXMgYSBzcGVjaWZpZWQgdGltaW5nIGFuZCBub3RpZmllcyB0aGUgSW9Ib3N0LlxuICAgKiBAcmV0dXJucyB0aGUgZWxhcHNlZCB0aW1lXG4gICAqL1xuICBwdWJsaWMgYXN5bmMgZW5kQXMoaW9Ib3N0OiBBY3Rpb25Bd2FyZUlvSG9zdCwgdHlwZTogJ3N5bnRoJyB8ICdkZXBsb3knIHwgJ3JvbGxiYWNrJyB8ICdkZXN0cm95Jykge1xuICAgIGNvbnN0IGR1cmF0aW9uID0gdGhpcy5lbmQoKTtcbiAgICBjb25zdCB7IGNvZGUsIHRleHQgfSA9IHRpbWVyTWVzc2FnZVByb3BzKHR5cGUpO1xuXG4gICAgYXdhaXQgaW9Ib3N0Lm5vdGlmeShpbmZvKGBcXG7inKggICR7dGV4dH0gdGltZTogJHtkdXJhdGlvbi5hc1NlY31zXFxuYCwgY29kZSwge1xuICAgICAgZHVyYXRpb246IGR1cmF0aW9uLmFzTXMsXG4gICAgfSkpO1xuXG4gICAgcmV0dXJuIGR1cmF0aW9uO1xuICB9XG59XG5cbmZ1bmN0aW9uIHRpbWVyTWVzc2FnZVByb3BzKHR5cGU6ICdzeW50aCcgfCAnZGVwbG95JyB8ICdyb2xsYmFjayd8ICdkZXN0cm95Jyk6IHtcbiAgY29kZTogVkFMSURfQ09ERTtcbiAgdGV4dDogc3RyaW5nO1xufSB7XG4gIHN3aXRjaCAodHlwZSkge1xuICAgIGNhc2UgJ3N5bnRoJzogcmV0dXJuIHsgY29kZTogJ0NES19UT09MS0lUX0kxMDAwJywgdGV4dDogJ1N5bnRoZXNpcycgfTtcbiAgICBjYXNlICdkZXBsb3knOiByZXR1cm4geyBjb2RlOiAnQ0RLX1RPT0xLSVRfSTUwMDAnLCB0ZXh0OiAnRGVwbG95bWVudCcgfTtcbiAgICBjYXNlICdyb2xsYmFjayc6IHJldHVybiB7IGNvZGU6ICdDREtfVE9PTEtJVF9JNjAwMCcsIHRleHQ6ICdSb2xsYmFjaycgfTtcbiAgICBjYXNlICdkZXN0cm95JzogcmV0dXJuIHsgY29kZTogJ0NES19UT09MS0lUX0k3MDAwJywgdGV4dDogJ0Rlc3Ryb3knIH07XG4gIH1cbn1cbiJdfQ==

package/lib/api/io/private/types.d.ts

@@ -0,0 +1,25 @@
+import { IIoHost } from '../io-host';
+import { IoMessage, IoRequest } from '../io-message';
+/**
+ * Valid reporting categories for messages.
+ */
+export type IoMessageCodeCategory = 'TOOLKIT' | 'SDK' | 'ASSETS' | 'ASSEMBLY';
+/**
+ * Code level matching the reporting level.
+ */
+export type IoCodeLevel = 'E' | 'W' | 'I';
+/**
+ * A message code at a specific level
+ */
+export type IoMessageSpecificCode<L extends IoCodeLevel> = `CDK_${IoMessageCodeCategory}_${L}${number}${number}${number}${number}`;
+export type Optional<T, K extends keyof T> = Pick<Partial<T>, K> & Omit<T, K>;
+export type SimplifiedMessage<T> = Pick<IoMessage<T>, 'level' | 'code' | 'message' | 'data'>;
+export type ActionLessMessage<T> = Omit<IoMessage<T>, 'action'>;
+export type ActionLessRequest<T, U> = Omit<IoRequest<T, U>, 'action'>;
+/**
+ * Helper type for IoHosts that are action aware
+ */
+export interface ActionAwareIoHost extends IIoHost {
+    notify<T>(msg: ActionLessMessage<T>): Promise<void>;
+    requestResponse<T, U>(msg: ActionLessRequest<T, U>): Promise<U>;
+}

package/lib/api/io/private/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJ0eXBlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgSUlvSG9zdCB9IGZyb20gJy4uL2lvLWhvc3QnO1xuaW1wb3J0IHsgSW9NZXNzYWdlLCBJb1JlcXVlc3QgfSBmcm9tICcuLi9pby1tZXNzYWdlJztcblxuLyoqXG4gKiBWYWxpZCByZXBvcnRpbmcgY2F0ZWdvcmllcyBmb3IgbWVzc2FnZXMuXG4gKi9cbmV4cG9ydCB0eXBlIElvTWVzc2FnZUNvZGVDYXRlZ29yeSA9ICdUT09MS0lUJyB8ICdTREsnIHwgJ0FTU0VUUycgfCAnQVNTRU1CTFknO1xuXG4vKipcbiAqIENvZGUgbGV2ZWwgbWF0Y2hpbmcgdGhlIHJlcG9ydGluZyBsZXZlbC5cbiAqL1xuZXhwb3J0IHR5cGUgSW9Db2RlTGV2ZWwgPSAnRScgfCAnVycgfCAnSSc7XG5cbi8qKlxuICogQSBtZXNzYWdlIGNvZGUgYXQgYSBzcGVjaWZpYyBsZXZlbFxuICovXG5leHBvcnQgdHlwZSBJb01lc3NhZ2VTcGVjaWZpY0NvZGU8TCBleHRlbmRzIElvQ29kZUxldmVsPiA9IGBDREtfJHtJb01lc3NhZ2VDb2RlQ2F0ZWdvcnl9XyR7TH0ke251bWJlcn0ke251bWJlcn0ke251bWJlcn0ke251bWJlcn1gO1xuXG5leHBvcnQgdHlwZSBPcHRpb25hbDxULCBLIGV4dGVuZHMga2V5b2YgVD4gPSBQaWNrPFBhcnRpYWw8VD4sIEs+ICYgT21pdDxULCBLPjtcbmV4cG9ydCB0eXBlIFNpbXBsaWZpZWRNZXNzYWdlPFQ+ID0gUGljazxJb01lc3NhZ2U8VD4sICdsZXZlbCcgfCAnY29kZScgfCAnbWVzc2FnZScgfCAnZGF0YSc+O1xuZXhwb3J0IHR5cGUgQWN0aW9uTGVzc01lc3NhZ2U8VD4gPSBPbWl0PElvTWVzc2FnZTxUPiwgJ2FjdGlvbic+O1xuZXhwb3J0IHR5cGUgQWN0aW9uTGVzc1JlcXVlc3Q8VCwgVT4gPSBPbWl0PElvUmVxdWVzdDxULCBVPiwgJ2FjdGlvbic+O1xuXG4vKipcbiAqIEhlbHBlciB0eXBlIGZvciBJb0hvc3RzIHRoYXQgYXJlIGFjdGlvbiBhd2FyZVxuICovXG5leHBvcnQgaW50ZXJmYWNlIEFjdGlvbkF3YXJlSW9Ib3N0IGV4dGVuZHMgSUlvSG9zdCB7XG4gIG5vdGlmeTxUPihtc2c6IEFjdGlvbkxlc3NNZXNzYWdlPFQ+KTogUHJvbWlzZTx2b2lkPjtcbiAgcmVxdWVzdFJlc3BvbnNlPFQsIFU+KG1zZzogQWN0aW9uTGVzc1JlcXVlc3Q8VCwgVT4pOiBQcm9taXNlPFU+O1xufVxuIl19

package/lib/index.d.ts

@@ -0,0 +1,6 @@
+export * from './toolkit';
+export * from './actions';
+export * from './api/aws-auth';
+export * from './api/cloud-assembly';
+export * from './api/io';
+export * from './api/errors';

package/lib/index.js

@@ -0,0 +1,25 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// The main show
+__exportStar(require("./toolkit"), exports);
+__exportStar(require("./actions"), exports);
+// Supporting acts
+__exportStar(require("./api/aws-auth"), exports);
+__exportStar(require("./api/cloud-assembly"), exports);
+__exportStar(require("./api/io"), exports);
+__exportStar(require("./api/errors"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJpbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7O0FBQUEsZ0JBQWdCO0FBQ2hCLDRDQUEwQjtBQUMxQiw0Q0FBMEI7QUFFMUIsa0JBQWtCO0FBQ2xCLGlEQUErQjtBQUMvQix1REFBcUM7QUFDckMsMkNBQXlCO0FBQ3pCLCtDQUE2QiIsInNvdXJjZXNDb250ZW50IjpbIi8vIFRoZSBtYWluIHNob3dcbmV4cG9ydCAqIGZyb20gJy4vdG9vbGtpdCc7XG5leHBvcnQgKiBmcm9tICcuL2FjdGlvbnMnO1xuXG4vLyBTdXBwb3J0aW5nIGFjdHNcbmV4cG9ydCAqIGZyb20gJy4vYXBpL2F3cy1hdXRoJztcbmV4cG9ydCAqIGZyb20gJy4vYXBpL2Nsb3VkLWFzc2VtYmx5JztcbmV4cG9ydCAqIGZyb20gJy4vYXBpL2lvJztcbmV4cG9ydCAqIGZyb20gJy4vYXBpL2Vycm9ycyc7XG4iXX0=

package/lib/toolkit/index.d.ts

@@ -0,0 +1 @@
+export * from './toolkit';

package/lib/toolkit/index.js

@@ -0,0 +1,18 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./toolkit"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJpbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7O0FBQUEsNENBQTBCIiwic291cmNlc0NvbnRlbnQiOlsiZXhwb3J0ICogZnJvbSAnLi90b29sa2l0JztcbiJdfQ==