@aws-cdk/toolkit-lib 0.1.0

package/lib/api/errors.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Represents a general toolkit error in the AWS CDK Toolkit.
+ */
+export declare class ToolkitError extends Error {
+    /**
+     * Determines if a given error is an instance of ToolkitError.
+     */
+    static isToolkitError(x: any): x is ToolkitError;
+    /**
+     * Determines if a given error is an instance of AuthenticationError.
+     */
+    static isAuthenticationError(x: any): x is AuthenticationError;
+    /**
+     * Determines if a given error is an instance of AssemblyError.
+     */
+    static isAssemblyError(x: any): x is AssemblyError;
+    /**
+     * Determines if a given error is an instance of AssemblyError.
+     */
+    static isContextProviderError(x: any): x is ContextProviderError;
+    /**
+     * The type of the error, defaults to "toolkit".
+     */
+    readonly type: string;
+    constructor(message: string, type?: string);
+}
+/**
+ * Represents an authentication-specific error in the AWS CDK Toolkit.
+ */
+export declare class AuthenticationError extends ToolkitError {
+    constructor(message: string);
+}
+/**
+ * Represents an authentication-specific error in the AWS CDK Toolkit.
+ */
+export declare class AssemblyError extends ToolkitError {
+    constructor(message: string);
+}
+/**
+ * Represents an error originating from a Context Provider
+ */
+export declare class ContextProviderError extends ToolkitError {
+    constructor(message: string);
+}

package/lib/api/errors.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextProviderError = exports.AssemblyError = exports.AuthenticationError = exports.ToolkitError = void 0;
+const TOOLKIT_ERROR_SYMBOL = Symbol.for('@aws-cdk/toolkit.ToolkitError');
+const AUTHENTICATION_ERROR_SYMBOL = Symbol.for('@aws-cdk/toolkit.AuthenticationError');
+const ASSEMBLY_ERROR_SYMBOL = Symbol.for('@aws-cdk/toolkit.AssemblyError');
+const CONTEXT_PROVIDER_ERROR_SYMBOL = Symbol.for('@aws-cdk/toolkit.ContextProviderError');
+/**
+ * Represents a general toolkit error in the AWS CDK Toolkit.
+ */
+class ToolkitError extends Error {
+    /**
+     * Determines if a given error is an instance of ToolkitError.
+     */
+    static isToolkitError(x) {
+        return x !== null && typeof (x) === 'object' && TOOLKIT_ERROR_SYMBOL in x;
+    }
+    /**
+     * Determines if a given error is an instance of AuthenticationError.
+     */
+    static isAuthenticationError(x) {
+        return this.isToolkitError(x) && AUTHENTICATION_ERROR_SYMBOL in x;
+    }
+    /**
+     * Determines if a given error is an instance of AssemblyError.
+     */
+    static isAssemblyError(x) {
+        return this.isToolkitError(x) && ASSEMBLY_ERROR_SYMBOL in x;
+    }
+    /**
+     * Determines if a given error is an instance of AssemblyError.
+     */
+    static isContextProviderError(x) {
+        return this.isToolkitError(x) && CONTEXT_PROVIDER_ERROR_SYMBOL in x;
+    }
+    /**
+     * The type of the error, defaults to "toolkit".
+     */
+    type;
+    constructor(message, type = 'toolkit') {
+        super(message);
+        Object.setPrototypeOf(this, ToolkitError.prototype);
+        Object.defineProperty(this, TOOLKIT_ERROR_SYMBOL, { value: true });
+        this.name = new.target.name;
+        this.type = type;
+    }
+}
+exports.ToolkitError = ToolkitError;
+/**
+ * Represents an authentication-specific error in the AWS CDK Toolkit.
+ */
+class AuthenticationError extends ToolkitError {
+    constructor(message) {
+        super(message, 'authentication');
+        Object.setPrototypeOf(this, AuthenticationError.prototype);
+        Object.defineProperty(this, AUTHENTICATION_ERROR_SYMBOL, { value: true });
+    }
+}
+exports.AuthenticationError = AuthenticationError;
+/**
+ * Represents an authentication-specific error in the AWS CDK Toolkit.
+ */
+class AssemblyError extends ToolkitError {
+    constructor(message) {
+        super(message, 'assembly');
+        Object.setPrototypeOf(this, AssemblyError.prototype);
+        Object.defineProperty(this, ASSEMBLY_ERROR_SYMBOL, { value: true });
+    }
+}
+exports.AssemblyError = AssemblyError;
+/**
+ * Represents an error originating from a Context Provider
+ */
+class ContextProviderError extends ToolkitError {
+    constructor(message) {
+        super(message, 'context-provider');
+        Object.setPrototypeOf(this, ContextProviderError.prototype);
+        Object.defineProperty(this, CONTEXT_PROVIDER_ERROR_SYMBOL, { value: true });
+    }
+}
+exports.ContextProviderError = ContextProviderError;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXJyb3JzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiZXJyb3JzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUFBLE1BQU0sb0JBQW9CLEdBQUcsTUFBTSxDQUFDLEdBQUcsQ0FBQywrQkFBK0IsQ0FBQyxDQUFDO0FBQ3pFLE1BQU0sMkJBQTJCLEdBQUcsTUFBTSxDQUFDLEdBQUcsQ0FBQyxzQ0FBc0MsQ0FBQyxDQUFDO0FBQ3ZGLE1BQU0scUJBQXFCLEdBQUcsTUFBTSxDQUFDLEdBQUcsQ0FBQyxnQ0FBZ0MsQ0FBQyxDQUFDO0FBQzNFLE1BQU0sNkJBQTZCLEdBQUcsTUFBTSxDQUFDLEdBQUcsQ0FBQyx1Q0FBdUMsQ0FBQyxDQUFDO0FBRTFGOztHQUVHO0FBQ0gsTUFBYSxZQUFhLFNBQVEsS0FBSztJQUNyQzs7T0FFRztJQUNJLE1BQU0sQ0FBQyxjQUFjLENBQUMsQ0FBTTtRQUNqQyxPQUFPLENBQUMsS0FBSyxJQUFJLElBQUksT0FBTSxDQUFDLENBQUMsQ0FBQyxLQUFLLFFBQVEsSUFBSSxvQkFBb0IsSUFBSSxDQUFDLENBQUM7SUFDM0UsQ0FBQztJQUVEOztPQUVHO0lBQ0ksTUFBTSxDQUFDLHFCQUFxQixDQUFDLENBQU07UUFDeEMsT0FBTyxJQUFJLENBQUMsY0FBYyxDQUFDLENBQUMsQ0FBQyxJQUFJLDJCQUEyQixJQUFJLENBQUMsQ0FBQztJQUNwRSxDQUFDO0lBRUQ7O09BRUc7SUFDSSxNQUFNLENBQUMsZUFBZSxDQUFDLENBQU07UUFDbEMsT0FBTyxJQUFJLENBQUMsY0FBYyxDQUFDLENBQUMsQ0FBQyxJQUFJLHFCQUFxQixJQUFJLENBQUMsQ0FBQztJQUM5RCxDQUFDO0lBRUQ7O09BRUc7SUFDSSxNQUFNLENBQUMsc0JBQXNCLENBQUMsQ0FBTTtRQUN6QyxPQUFPLElBQUksQ0FBQyxjQUFjLENBQUMsQ0FBQyxDQUFDLElBQUksNkJBQTZCLElBQUksQ0FBQyxDQUFDO0lBQ3RFLENBQUM7SUFFRDs7T0FFRztJQUNhLElBQUksQ0FBUztJQUU3QixZQUFZLE9BQWUsRUFBRSxPQUFlLFNBQVM7UUFDbkQsS0FBSyxDQUFDLE9BQU8sQ0FBQyxDQUFDO1FBQ2YsTUFBTSxDQUFDLGNBQWMsQ0FBQyxJQUFJLEVBQUUsWUFBWSxDQUFDLFNBQVMsQ0FBQyxDQUFDO1FBQ3BELE1BQU0sQ0FBQyxjQUFjLENBQUMsSUFBSSxFQUFFLG9CQUFvQixFQUFFLEVBQUUsS0FBSyxFQUFFLElBQUksRUFBRSxDQUFDLENBQUM7UUFDbkUsSUFBSSxDQUFDLElBQUksR0FBRyxHQUFHLENBQUMsTUFBTSxDQUFDLElBQUksQ0FBQztRQUM1QixJQUFJLENBQUMsSUFBSSxHQUFHLElBQUksQ0FBQztJQUNuQixDQUFDO0NBQ0Y7QUF6Q0Qsb0NBeUNDO0FBRUQ7O0dBRUc7QUFDSCxNQUFhLG1CQUFvQixTQUFRLFlBQVk7SUFDbkQsWUFBWSxPQUFlO1FBQ3pCLEtBQUssQ0FBQyxPQUFPLEVBQUUsZ0JBQWdCLENBQUMsQ0FBQztRQUNqQyxNQUFNLENBQUMsY0FBYyxDQUFDLElBQUksRUFBRSxtQkFBbUIsQ0FBQyxTQUFTLENBQUMsQ0FBQztRQUMzRCxNQUFNLENBQUMsY0FBYyxDQUFDLElBQUksRUFBRSwyQkFBMkIsRUFBRSxFQUFFLEtBQUssRUFBRSxJQUFJLEVBQUUsQ0FBQyxDQUFDO0lBQzVFLENBQUM7Q0FDRjtBQU5ELGtEQU1DO0FBRUQ7O0dBRUc7QUFDSCxNQUFhLGFBQWMsU0FBUSxZQUFZO0lBQzdDLFlBQVksT0FBZTtRQUN6QixLQUFLLENBQUMsT0FBTyxFQUFFLFVBQVUsQ0FBQyxDQUFDO1FBQzNCLE1BQU0sQ0FBQyxjQUFjLENBQUMsSUFBSSxFQUFFLGFBQWEsQ0FBQyxTQUFTLENBQUMsQ0FBQztRQUNyRCxNQUFNLENBQUMsY0FBYyxDQUFDLElBQUksRUFBRSxxQkFBcUIsRUFBRSxFQUFFLEtBQUssRUFBRSxJQUFJLEVBQUUsQ0FBQyxDQUFDO0lBQ3RFLENBQUM7Q0FDRjtBQU5ELHNDQU1DO0FBRUQ7O0dBRUc7QUFDSCxNQUFhLG9CQUFxQixTQUFRLFlBQVk7SUFDcEQsWUFBWSxPQUFlO1FBQ3pCLEtBQUssQ0FBQyxPQUFPLEVBQUUsa0JBQWtCLENBQUMsQ0FBQztRQUNuQyxNQUFNLENBQUMsY0FBYyxDQUFDLElBQUksRUFBRSxvQkFBb0IsQ0FBQyxTQUFTLENBQUMsQ0FBQztRQUM1RCxNQUFNLENBQUMsY0FBYyxDQUFDLElBQUksRUFBRSw2QkFBNkIsRUFBRSxFQUFFLEtBQUssRUFBRSxJQUFJLEVBQUUsQ0FBQyxDQUFDO0lBQzlFLENBQUM7Q0FDRjtBQU5ELG9EQU1DIiwic291cmNlc0NvbnRlbnQiOlsiY29uc3QgVE9PTEtJVF9FUlJPUl9TWU1CT0wgPSBTeW1ib2wuZm9yKCdAYXdzLWNkay90b29sa2l0LlRvb2xraXRFcnJvcicpO1xuY29uc3QgQVVUSEVOVElDQVRJT05fRVJST1JfU1lNQk9MID0gU3ltYm9sLmZvcignQGF3cy1jZGsvdG9vbGtpdC5BdXRoZW50aWNhdGlvbkVycm9yJyk7XG5jb25zdCBBU1NFTUJMWV9FUlJPUl9TWU1CT0wgPSBTeW1ib2wuZm9yKCdAYXdzLWNkay90b29sa2l0LkFzc2VtYmx5RXJyb3InKTtcbmNvbnN0IENPTlRFWFRfUFJPVklERVJfRVJST1JfU1lNQk9MID0gU3ltYm9sLmZvcignQGF3cy1jZGsvdG9vbGtpdC5Db250ZXh0UHJvdmlkZXJFcnJvcicpO1xuXG4vKipcbiAqIFJlcHJlc2VudHMgYSBnZW5lcmFsIHRvb2xraXQgZXJyb3IgaW4gdGhlIEFXUyBDREsgVG9vbGtpdC5cbiAqL1xuZXhwb3J0IGNsYXNzIFRvb2xraXRFcnJvciBleHRlbmRzIEVycm9yIHtcbiAgLyoqXG4gICAqIERldGVybWluZXMgaWYgYSBnaXZlbiBlcnJvciBpcyBhbiBpbnN0YW5jZSBvZiBUb29sa2l0RXJyb3IuXG4gICAqL1xuICBwdWJsaWMgc3RhdGljIGlzVG9vbGtpdEVycm9yKHg6IGFueSk6IHggaXMgVG9vbGtpdEVycm9yIHtcbiAgICByZXR1cm4geCAhPT0gbnVsbCAmJiB0eXBlb2YoeCkgPT09ICdvYmplY3QnICYmIFRPT0xLSVRfRVJST1JfU1lNQk9MIGluIHg7XG4gIH1cblxuICAvKipcbiAgICogRGV0ZXJtaW5lcyBpZiBhIGdpdmVuIGVycm9yIGlzIGFuIGluc3RhbmNlIG9mIEF1dGhlbnRpY2F0aW9uRXJyb3IuXG4gICAqL1xuICBwdWJsaWMgc3RhdGljIGlzQXV0aGVudGljYXRpb25FcnJvcih4OiBhbnkpOiB4IGlzIEF1dGhlbnRpY2F0aW9uRXJyb3Ige1xuICAgIHJldHVybiB0aGlzLmlzVG9vbGtpdEVycm9yKHgpICYmIEFVVEhFTlRJQ0FUSU9OX0VSUk9SX1NZTUJPTCBpbiB4O1xuICB9XG5cbiAgLyoqXG4gICAqIERldGVybWluZXMgaWYgYSBnaXZlbiBlcnJvciBpcyBhbiBpbnN0YW5jZSBvZiBBc3NlbWJseUVycm9yLlxuICAgKi9cbiAgcHVibGljIHN0YXRpYyBpc0Fzc2VtYmx5RXJyb3IoeDogYW55KTogeCBpcyBBc3NlbWJseUVycm9yIHtcbiAgICByZXR1cm4gdGhpcy5pc1Rvb2xraXRFcnJvcih4KSAmJiBBU1NFTUJMWV9FUlJPUl9TWU1CT0wgaW4geDtcbiAgfVxuXG4gIC8qKlxuICAgKiBEZXRlcm1pbmVzIGlmIGEgZ2l2ZW4gZXJyb3IgaXMgYW4gaW5zdGFuY2Ugb2YgQXNzZW1ibHlFcnJvci5cbiAgICovXG4gIHB1YmxpYyBzdGF0aWMgaXNDb250ZXh0UHJvdmlkZXJFcnJvcih4OiBhbnkpOiB4IGlzIENvbnRleHRQcm92aWRlckVycm9yIHtcbiAgICByZXR1cm4gdGhpcy5pc1Rvb2xraXRFcnJvcih4KSAmJiBDT05URVhUX1BST1ZJREVSX0VSUk9SX1NZTUJPTCBpbiB4O1xuICB9XG5cbiAgLyoqXG4gICAqIFRoZSB0eXBlIG9mIHRoZSBlcnJvciwgZGVmYXVsdHMgdG8gXCJ0b29sa2l0XCIuXG4gICAqL1xuICBwdWJsaWMgcmVhZG9ubHkgdHlwZTogc3RyaW5nO1xuXG4gIGNvbnN0cnVjdG9yKG1lc3NhZ2U6IHN0cmluZywgdHlwZTogc3RyaW5nID0gJ3Rvb2xraXQnKSB7XG4gICAgc3VwZXIobWVzc2FnZSk7XG4gICAgT2JqZWN0LnNldFByb3RvdHlwZU9mKHRoaXMsIFRvb2xraXRFcnJvci5wcm90b3R5cGUpO1xuICAgIE9iamVjdC5kZWZpbmVQcm9wZXJ0eSh0aGlzLCBUT09MS0lUX0VSUk9SX1NZTUJPTCwgeyB2YWx1ZTogdHJ1ZSB9KTtcbiAgICB0aGlzLm5hbWUgPSBuZXcudGFyZ2V0Lm5hbWU7XG4gICAgdGhpcy50eXBlID0gdHlwZTtcbiAgfVxufVxuXG4vKipcbiAqIFJlcHJlc2VudHMgYW4gYXV0aGVudGljYXRpb24tc3BlY2lmaWMgZXJyb3IgaW4gdGhlIEFXUyBDREsgVG9vbGtpdC5cbiAqL1xuZXhwb3J0IGNsYXNzIEF1dGhlbnRpY2F0aW9uRXJyb3IgZXh0ZW5kcyBUb29sa2l0RXJyb3Ige1xuICBjb25zdHJ1Y3RvcihtZXNzYWdlOiBzdHJpbmcpIHtcbiAgICBzdXBlcihtZXNzYWdlLCAnYXV0aGVudGljYXRpb24nKTtcbiAgICBPYmplY3Quc2V0UHJvdG90eXBlT2YodGhpcywgQXV0aGVudGljYXRpb25FcnJvci5wcm90b3R5cGUpO1xuICAgIE9iamVjdC5kZWZpbmVQcm9wZXJ0eSh0aGlzLCBBVVRIRU5USUNBVElPTl9FUlJPUl9TWU1CT0wsIHsgdmFsdWU6IHRydWUgfSk7XG4gIH1cbn1cblxuLyoqXG4gKiBSZXByZXNlbnRzIGFuIGF1dGhlbnRpY2F0aW9uLXNwZWNpZmljIGVycm9yIGluIHRoZSBBV1MgQ0RLIFRvb2xraXQuXG4gKi9cbmV4cG9ydCBjbGFzcyBBc3NlbWJseUVycm9yIGV4dGVuZHMgVG9vbGtpdEVycm9yIHtcbiAgY29uc3RydWN0b3IobWVzc2FnZTogc3RyaW5nKSB7XG4gICAgc3VwZXIobWVzc2FnZSwgJ2Fzc2VtYmx5Jyk7XG4gICAgT2JqZWN0LnNldFByb3RvdHlwZU9mKHRoaXMsIEFzc2VtYmx5RXJyb3IucHJvdG90eXBlKTtcbiAgICBPYmplY3QuZGVmaW5lUHJvcGVydHkodGhpcywgQVNTRU1CTFlfRVJST1JfU1lNQk9MLCB7IHZhbHVlOiB0cnVlIH0pO1xuICB9XG59XG5cbi8qKlxuICogUmVwcmVzZW50cyBhbiBlcnJvciBvcmlnaW5hdGluZyBmcm9tIGEgQ29udGV4dCBQcm92aWRlclxuICovXG5leHBvcnQgY2xhc3MgQ29udGV4dFByb3ZpZGVyRXJyb3IgZXh0ZW5kcyBUb29sa2l0RXJyb3Ige1xuICBjb25zdHJ1Y3RvcihtZXNzYWdlOiBzdHJpbmcpIHtcbiAgICBzdXBlcihtZXNzYWdlLCAnY29udGV4dC1wcm92aWRlcicpO1xuICAgIE9iamVjdC5zZXRQcm90b3R5cGVPZih0aGlzLCBDb250ZXh0UHJvdmlkZXJFcnJvci5wcm90b3R5cGUpO1xuICAgIE9iamVjdC5kZWZpbmVQcm9wZXJ0eSh0aGlzLCBDT05URVhUX1BST1ZJREVSX0VSUk9SX1NZTUJPTCwgeyB2YWx1ZTogdHJ1ZSB9KTtcbiAgfVxufVxuIl19

package/lib/api/io/index.d.ts

@@ -0,0 +1,2 @@
+export * from './io-host';
+export * from './io-message';

package/lib/api/io/index.js

@@ -0,0 +1,19 @@
+"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("./io-host"), exports);
+__exportStar(require("./io-message"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJpbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7O0FBQUEsNENBQTBCO0FBQzFCLCtDQUE2QiIsInNvdXJjZXNDb250ZW50IjpbImV4cG9ydCAqIGZyb20gJy4vaW8taG9zdCc7XG5leHBvcnQgKiBmcm9tICcuL2lvLW1lc3NhZ2UnO1xuIl19

package/lib/api/io/io-host.d.ts

@@ -0,0 +1,15 @@
+import { IoMessage, IoRequest } from './io-message';
+export interface IIoHost {
+    /**
+     * Notifies the host of a message.
+     * The caller waits until the notification completes.
+     */
+    notify<T>(msg: IoMessage<T>): Promise<void>;
+    /**
+     * Notifies the host of a message that requires a response.
+     *
+     * If the host does not return a response the suggested
+     * default response from the input message will be used.
+     */
+    requestResponse<T, U>(msg: IoRequest<T, U>): Promise<U>;
+}

package/lib/api/io/io-host.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW8taG9zdC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbImlvLWhvc3QudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IElvTWVzc2FnZSwgSW9SZXF1ZXN0IH0gZnJvbSAnLi9pby1tZXNzYWdlJztcblxuZXhwb3J0IGludGVyZmFjZSBJSW9Ib3N0IHtcbiAgLyoqXG4gICAqIE5vdGlmaWVzIHRoZSBob3N0IG9mIGEgbWVzc2FnZS5cbiAgICogVGhlIGNhbGxlciB3YWl0cyB1bnRpbCB0aGUgbm90aWZpY2F0aW9uIGNvbXBsZXRlcy5cbiAgICovXG4gIG5vdGlmeTxUPihtc2c6IElvTWVzc2FnZTxUPik6IFByb21pc2U8dm9pZD47XG5cbiAgLyoqXG4gICAqIE5vdGlmaWVzIHRoZSBob3N0IG9mIGEgbWVzc2FnZSB0aGF0IHJlcXVpcmVzIGEgcmVzcG9uc2UuXG4gICAqXG4gICAqIElmIHRoZSBob3N0IGRvZXMgbm90IHJldHVybiBhIHJlc3BvbnNlIHRoZSBzdWdnZXN0ZWRcbiAgICogZGVmYXVsdCByZXNwb25zZSBmcm9tIHRoZSBpbnB1dCBtZXNzYWdlIHdpbGwgYmUgdXNlZC5cbiAgICovXG4gIHJlcXVlc3RSZXNwb25zZTxULCBVPihtc2c6IElvUmVxdWVzdDxULCBVPik6IFByb21pc2U8VT47XG59XG4iXX0=

package/lib/api/io/io-message.d.ts

@@ -0,0 +1,59 @@
+import { ToolkitAction } from '../../toolkit';
+/**
+ * The reporting level of the message.
+ * All messages are always reported, it's up to the IoHost to decide what to log.
+ */
+export type IoMessageLevel = 'error' | 'result' | 'warn' | 'info' | 'debug' | 'trace';
+/**
+ * A valid message code
+ */
+export type IoMessageCode = `CDK_${string}_${'E' | 'W' | 'I'}${number}${number}${number}${number}`;
+/**
+ * An IO message emitted.
+ */
+export interface IoMessage<T> {
+    /**
+     * The time the message was emitted.
+     */
+    readonly time: Date;
+    /**
+     * The log level of the message.
+     */
+    readonly level: IoMessageLevel;
+    /**
+     * The action that triggered the message.
+     */
+    readonly action: ToolkitAction;
+    /**
+     * A short message code uniquely identifying a message type using the format CDK_[CATEGORY]_[E/W/I][0000-9999].
+     *
+     * The level indicator follows these rules:
+     * - 'E' for error level messages
+     * - 'W' for warning level messages
+     * - 'I' for info/debug/trace level messages
+     *
+     * Codes ending in 000 0 are generic messages, while codes ending in 0001-9999 are specific to a particular message.
+     * The following are examples of valid and invalid message codes:
+     * ```ts
+     * 'CDK_ASSETS_I0000'       // valid: generic assets info message
+     * 'CDK_TOOLKIT_E0002'      // valid: specific toolkit error message
+     * 'CDK_SDK_W0023'          // valid: specific sdk warning message
+     * ```
+     */
+    readonly code: IoMessageCode;
+    /**
+     * The message text.
+     * This is safe to print to an end-user.
+     */
+    readonly message: string;
+    /**
+     * The data attached to the message.
+     */
+    readonly data?: T;
+}
+export interface IoRequest<T, U> extends IoMessage<T> {
+    /**
+     * The default response that will be used if no data is returned.
+     */
+    readonly defaultResponse: U;
+}

package/lib/api/io/io-message.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW8tbWVzc2FnZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbImlvLW1lc3NhZ2UudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IFRvb2xraXRBY3Rpb24gfSBmcm9tICcuLi8uLi90b29sa2l0JztcblxuLyoqXG4gKiBUaGUgcmVwb3J0aW5nIGxldmVsIG9mIHRoZSBtZXNzYWdlLlxuICogQWxsIG1lc3NhZ2VzIGFyZSBhbHdheXMgcmVwb3J0ZWQsIGl0J3MgdXAgdG8gdGhlIElvSG9zdCB0byBkZWNpZGUgd2hhdCB0byBsb2cuXG4gKi9cbmV4cG9ydCB0eXBlIElvTWVzc2FnZUxldmVsID0gJ2Vycm9yJ3wgJ3Jlc3VsdCcgfCAnd2FybicgfCAnaW5mbycgfCAnZGVidWcnIHwgJ3RyYWNlJztcblxuLyoqXG4gKiBBIHZhbGlkIG1lc3NhZ2UgY29kZVxuICovXG5leHBvcnQgdHlwZSBJb01lc3NhZ2VDb2RlID0gYENES18ke3N0cmluZ31fJHsnRScgfCAnVycgfCAnSSd9JHtudW1iZXJ9JHtudW1iZXJ9JHtudW1iZXJ9JHtudW1iZXJ9YDtcblxuLyoqXG4gKiBBbiBJTyBtZXNzYWdlIGVtaXR0ZWQuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgSW9NZXNzYWdlPFQ+IHtcbiAgLyoqXG4gICAqIFRoZSB0aW1lIHRoZSBtZXNzYWdlIHdhcyBlbWl0dGVkLlxuICAgKi9cbiAgcmVhZG9ubHkgdGltZTogRGF0ZTtcblxuICAvKipcbiAgICogVGhlIGxvZyBsZXZlbCBvZiB0aGUgbWVzc2FnZS5cbiAgICovXG4gIHJlYWRvbmx5IGxldmVsOiBJb01lc3NhZ2VMZXZlbDtcblxuICAvKipcbiAgICogVGhlIGFjdGlvbiB0aGF0IHRyaWdnZXJlZCB0aGUgbWVzc2FnZS5cbiAgICovXG4gIHJlYWRvbmx5IGFjdGlvbjogVG9vbGtpdEFjdGlvbjtcblxuICAvKipcbiAgICogQSBzaG9ydCBtZXNzYWdlIGNvZGUgdW5pcXVlbHkgaWRlbnRpZnlpbmcgYSBtZXNzYWdlIHR5cGUgdXNpbmcgdGhlIGZvcm1hdCBDREtfW0NBVEVHT1JZXV9bRS9XL0ldWzAwMDAtOTk5OV0uXG4gICAqXG4gICAqIFRoZSBsZXZlbCBpbmRpY2F0b3IgZm9sbG93cyB0aGVzZSBydWxlczpcbiAgICogLSAnRScgZm9yIGVycm9yIGxldmVsIG1lc3NhZ2VzXG4gICAqIC0gJ1cnIGZvciB3YXJuaW5nIGxldmVsIG1lc3NhZ2VzXG4gICAqIC0gJ0knIGZvciBpbmZvL2RlYnVnL3RyYWNlIGxldmVsIG1lc3NhZ2VzXG4gICAqXG4gICAqIENvZGVzIGVuZGluZyBpbiAwMDAgMCBhcmUgZ2VuZXJpYyBtZXNzYWdlcywgd2hpbGUgY29kZXMgZW5kaW5nIGluIDAwMDEtOTk5OSBhcmUgc3BlY2lmaWMgdG8gYSBwYXJ0aWN1bGFyIG1lc3NhZ2UuXG4gICAqIFRoZSBmb2xsb3dpbmcgYXJlIGV4YW1wbGVzIG9mIHZhbGlkIGFuZCBpbnZhbGlkIG1lc3NhZ2UgY29kZXM6XG4gICAqIGBgYHRzXG4gICAqICdDREtfQVNTRVRTX0kwMDAwJyAgICAgICAvLyB2YWxpZDogZ2VuZXJpYyBhc3NldHMgaW5mbyBtZXNzYWdlXG4gICAqICdDREtfVE9PTEtJVF9FMDAwMicgICAgICAvLyB2YWxpZDogc3BlY2lmaWMgdG9vbGtpdCBlcnJvciBtZXNzYWdlXG4gICAqICdDREtfU0RLX1cwMDIzJyAgICAgICAgICAvLyB2YWxpZDogc3BlY2lmaWMgc2RrIHdhcm5pbmcgbWVzc2FnZVxuICAgKiBgYGBcbiAgICovXG4gIHJlYWRvbmx5IGNvZGU6IElvTWVzc2FnZUNvZGU7XG5cbiAgLyoqXG4gICAqIFRoZSBtZXNzYWdlIHRleHQuXG4gICAqIFRoaXMgaXMgc2FmZSB0byBwcmludCB0byBhbiBlbmQtdXNlci5cbiAgICovXG4gIHJlYWRvbmx5IG1lc3NhZ2U6IHN0cmluZztcblxuICAvKipcbiAgICogVGhlIGRhdGEgYXR0YWNoZWQgdG8gdGhlIG1lc3NhZ2UuXG4gICAqL1xuICByZWFkb25seSBkYXRhPzogVDtcbn1cblxuZXhwb3J0IGludGVyZmFjZSBJb1JlcXVlc3Q8VCwgVT4gZXh0ZW5kcyBJb01lc3NhZ2U8VD4ge1xuICAvKipcbiAgICogVGhlIGRlZmF1bHQgcmVzcG9uc2UgdGhhdCB3aWxsIGJlIHVzZWQgaWYgbm8gZGF0YSBpcyByZXR1cm5lZC5cbiAgICovXG4gIHJlYWRvbmx5IGRlZmF1bHRSZXNwb25zZTogVTtcbn1cbiJdfQ==

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

@@ -0,0 +1,37 @@
+import { IoMessageCode } from '../io-message';
+/**
+ * We have a rough system by which we assign message codes:
+ * - First digit groups messages by action, e.g. synth or deploy
+ * - X000-X009 are reserved for timings
+ * - X900-X999 are reserved for results
+ */
+export declare const CODES: {
+    CDK_TOOLKIT_I1000: string;
+    CDK_TOOLKIT_I1901: string;
+    CDK_TOOLKIT_I1902: string;
+    CDK_TOOLKIT_I2901: string;
+    CDK_TOOLKIT_E3900: string;
+    CDK_TOOLKIT_I5000: string;
+    CDK_TOOLKIT_I5001: string;
+    CDK_TOOLKIT_I5002: string;
+    CDK_TOOLKIT_I5031: string;
+    CDK_TOOLKIT_I5050: string;
+    CDK_TOOLKIT_I5060: string;
+    CDK_TOOLKIT_I5900: string;
+    CDK_TOOLKIT_E5001: string;
+    CDK_TOOLKIT_I6000: string;
+    CDK_TOOLKIT_E6001: string;
+    CDK_TOOLKIT_E6900: string;
+    CDK_TOOLKIT_I7000: string;
+    CDK_TOOLKIT_I7010: string;
+    CDK_TOOLKIT_E7010: string;
+    CDK_TOOLKIT_E7900: string;
+    CDK_ASSEMBLY_I0042: string;
+    CDK_ASSEMBLY_I0241: string;
+    CDK_ASSEMBLY_I1000: string;
+    CDK_ASSEMBLY_I1001: string;
+    CDK_ASSEMBLY_E1002: string;
+    CDK_ASSEMBLY_I1003: string;
+    CDK_ASSEMBLY_E1111: string;
+};
+export type VALID_CODE = keyof typeof CODES & IoMessageCode;

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

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CODES = void 0;
+/**
+ * We have a rough system by which we assign message codes:
+ * - First digit groups messages by action, e.g. synth or deploy
+ * - X000-X009 are reserved for timings
+ * - X900-X999 are reserved for results
+ */
+exports.CODES = {
+    // 1: Synth
+    CDK_TOOLKIT_I1000: 'Provides synthesis times',
+    CDK_TOOLKIT_I1901: 'Provides stack data',
+    CDK_TOOLKIT_I1902: 'Successfully deployed stacks',
+    // 2: List
+    CDK_TOOLKIT_I2901: 'Provides details on the selected stacks and their dependencies',
+    // 3: Import & Migrate
+    CDK_TOOLKIT_E3900: 'Resource import failed',
+    // 4: Diff
+    // 5: Deploy & Watch
+    CDK_TOOLKIT_I5000: 'Provides deployment times',
+    CDK_TOOLKIT_I5001: 'Provides total time in deploy action, including synth and rollback',
+    CDK_TOOLKIT_I5002: 'Provides time for resource migration',
+    CDK_TOOLKIT_I5031: 'Informs about any log groups that are traced as part of the deployment',
+    CDK_TOOLKIT_I5050: 'Confirm rollback during deployment',
+    CDK_TOOLKIT_I5060: 'Confirm deploy security sensitive changes',
+    CDK_TOOLKIT_I5900: 'Deployment results on success',
+    CDK_TOOLKIT_E5001: 'No stacks found',
+    // 6: Rollback
+    CDK_TOOLKIT_I6000: 'Provides rollback times',
+    CDK_TOOLKIT_E6001: 'No stacks found',
+    CDK_TOOLKIT_E6900: 'Rollback failed',
+    // 7: Destroy
+    CDK_TOOLKIT_I7000: 'Provides destroy times',
+    CDK_TOOLKIT_I7010: 'Confirm destroy stacks',
+    CDK_TOOLKIT_E7010: 'Action was aborted due to negative confirmation of request',
+    CDK_TOOLKIT_E7900: 'Stack deletion failed',
+    // 9: Bootstrap
+    // Assembly codes
+    CDK_ASSEMBLY_I0042: 'Writing updated context',
+    CDK_ASSEMBLY_I0241: 'Fetching missing context',
+    CDK_ASSEMBLY_I1000: 'Cloud assembly output starts',
+    CDK_ASSEMBLY_I1001: 'Output lines emitted by the cloud assembly to stdout',
+    CDK_ASSEMBLY_E1002: 'Output lines emitted by the cloud assembly to stderr',
+    CDK_ASSEMBLY_I1003: 'Cloud assembly output finished',
+    CDK_ASSEMBLY_E1111: 'Incompatible CDK CLI version. Upgrade needed.',
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29kZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJjb2Rlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFFQTs7Ozs7R0FLRztBQUNVLFFBQUEsS0FBSyxHQUFHO0lBQ25CLFdBQVc7SUFDWCxpQkFBaUIsRUFBRSwwQkFBMEI7SUFDN0MsaUJBQWlCLEVBQUUscUJBQXFCO0lBQ3hDLGlCQUFpQixFQUFFLDhCQUE4QjtJQUVqRCxVQUFVO0lBQ1YsaUJBQWlCLEVBQUUsZ0VBQWdFO0lBRW5GLHNCQUFzQjtJQUN0QixpQkFBaUIsRUFBRSx3QkFBd0I7SUFFM0MsVUFBVTtJQUVWLG9CQUFvQjtJQUNwQixpQkFBaUIsRUFBRSwyQkFBMkI7SUFDOUMsaUJBQWlCLEVBQUUsb0VBQW9FO0lBQ3ZGLGlCQUFpQixFQUFFLHNDQUFzQztJQUN6RCxpQkFBaUIsRUFBRSx3RUFBd0U7SUFDM0YsaUJBQWlCLEVBQUUsb0NBQW9DO0lBQ3ZELGlCQUFpQixFQUFFLDJDQUEyQztJQUM5RCxpQkFBaUIsRUFBRSwrQkFBK0I7SUFFbEQsaUJBQWlCLEVBQUUsaUJBQWlCO0lBRXBDLGNBQWM7SUFDZCxpQkFBaUIsRUFBRSx5QkFBeUI7SUFFNUMsaUJBQWlCLEVBQUUsaUJBQWlCO0lBQ3BDLGlCQUFpQixFQUFFLGlCQUFpQjtJQUVwQyxhQUFhO0lBQ2IsaUJBQWlCLEVBQUUsd0JBQXdCO0lBQzNDLGlCQUFpQixFQUFFLHdCQUF3QjtJQUUzQyxpQkFBaUIsRUFBRSw0REFBNEQ7SUFDL0UsaUJBQWlCLEVBQUUsdUJBQXVCO0lBRTFDLGVBQWU7SUFFZixpQkFBaUI7SUFDakIsa0JBQWtCLEVBQUUseUJBQXlCO0lBQzdDLGtCQUFrQixFQUFFLDBCQUEwQjtJQUM5QyxrQkFBa0IsRUFBRSw4QkFBOEI7SUFDbEQsa0JBQWtCLEVBQUUsc0RBQXNEO0lBQzFFLGtCQUFrQixFQUFFLHNEQUFzRDtJQUMxRSxrQkFBa0IsRUFBRSxnQ0FBZ0M7SUFDcEQsa0JBQWtCLEVBQUUsK0NBQStDO0NBQ3BFLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBJb01lc3NhZ2VDb2RlIH0gZnJvbSAnLi4vaW8tbWVzc2FnZSc7XG5cbi8qKlxuICogV2UgaGF2ZSBhIHJvdWdoIHN5c3RlbSBieSB3aGljaCB3ZSBhc3NpZ24gbWVzc2FnZSBjb2RlczpcbiAqIC0gRmlyc3QgZGlnaXQgZ3JvdXBzIG1lc3NhZ2VzIGJ5IGFjdGlvbiwgZS5nLiBzeW50aCBvciBkZXBsb3lcbiAqIC0gWDAwMC1YMDA5IGFyZSByZXNlcnZlZCBmb3IgdGltaW5nc1xuICogLSBYOTAwLVg5OTkgYXJlIHJlc2VydmVkIGZvciByZXN1bHRzXG4gKi9cbmV4cG9ydCBjb25zdCBDT0RFUyA9IHtcbiAgLy8gMTogU3ludGhcbiAgQ0RLX1RPT0xLSVRfSTEwMDA6ICdQcm92aWRlcyBzeW50aGVzaXMgdGltZXMnLFxuICBDREtfVE9PTEtJVF9JMTkwMTogJ1Byb3ZpZGVzIHN0YWNrIGRhdGEnLFxuICBDREtfVE9PTEtJVF9JMTkwMjogJ1N1Y2Nlc3NmdWxseSBkZXBsb3llZCBzdGFja3MnLFxuXG4gIC8vIDI6IExpc3RcbiAgQ0RLX1RPT0xLSVRfSTI5MDE6ICdQcm92aWRlcyBkZXRhaWxzIG9uIHRoZSBzZWxlY3RlZCBzdGFja3MgYW5kIHRoZWlyIGRlcGVuZGVuY2llcycsXG5cbiAgLy8gMzogSW1wb3J0ICYgTWlncmF0ZVxuICBDREtfVE9PTEtJVF9FMzkwMDogJ1Jlc291cmNlIGltcG9ydCBmYWlsZWQnLFxuXG4gIC8vIDQ6IERpZmZcblxuICAvLyA1OiBEZXBsb3kgJiBXYXRjaFxuICBDREtfVE9PTEtJVF9JNTAwMDogJ1Byb3ZpZGVzIGRlcGxveW1lbnQgdGltZXMnLFxuICBDREtfVE9PTEtJVF9JNTAwMTogJ1Byb3ZpZGVzIHRvdGFsIHRpbWUgaW4gZGVwbG95IGFjdGlvbiwgaW5jbHVkaW5nIHN5bnRoIGFuZCByb2xsYmFjaycsXG4gIENES19UT09MS0lUX0k1MDAyOiAnUHJvdmlkZXMgdGltZSBmb3IgcmVzb3VyY2UgbWlncmF0aW9uJyxcbiAgQ0RLX1RPT0xLSVRfSTUwMzE6ICdJbmZvcm1zIGFib3V0IGFueSBsb2cgZ3JvdXBzIHRoYXQgYXJlIHRyYWNlZCBhcyBwYXJ0IG9mIHRoZSBkZXBsb3ltZW50JyxcbiAgQ0RLX1RPT0xLSVRfSTUwNTA6ICdDb25maXJtIHJvbGxiYWNrIGR1cmluZyBkZXBsb3ltZW50JyxcbiAgQ0RLX1RPT0xLSVRfSTUwNjA6ICdDb25maXJtIGRlcGxveSBzZWN1cml0eSBzZW5zaXRpdmUgY2hhbmdlcycsXG4gIENES19UT09MS0lUX0k1OTAwOiAnRGVwbG95bWVudCByZXN1bHRzIG9uIHN1Y2Nlc3MnLFxuXG4gIENES19UT09MS0lUX0U1MDAxOiAnTm8gc3RhY2tzIGZvdW5kJyxcblxuICAvLyA2OiBSb2xsYmFja1xuICBDREtfVE9PTEtJVF9JNjAwMDogJ1Byb3ZpZGVzIHJvbGxiYWNrIHRpbWVzJyxcblxuICBDREtfVE9PTEtJVF9FNjAwMTogJ05vIHN0YWNrcyBmb3VuZCcsXG4gIENES19UT09MS0lUX0U2OTAwOiAnUm9sbGJhY2sgZmFpbGVkJyxcblxuICAvLyA3OiBEZXN0cm95XG4gIENES19UT09MS0lUX0k3MDAwOiAnUHJvdmlkZXMgZGVzdHJveSB0aW1lcycsXG4gIENES19UT09MS0lUX0k3MDEwOiAnQ29uZmlybSBkZXN0cm95IHN0YWNrcycsXG5cbiAgQ0RLX1RPT0xLSVRfRTcwMTA6ICdBY3Rpb24gd2FzIGFib3J0ZWQgZHVlIHRvIG5lZ2F0aXZlIGNvbmZpcm1hdGlvbiBvZiByZXF1ZXN0JyxcbiAgQ0RLX1RPT0xLSVRfRTc5MDA6ICdTdGFjayBkZWxldGlvbiBmYWlsZWQnLFxuXG4gIC8vIDk6IEJvb3RzdHJhcFxuXG4gIC8vIEFzc2VtYmx5IGNvZGVzXG4gIENES19BU1NFTUJMWV9JMDA0MjogJ1dyaXRpbmcgdXBkYXRlZCBjb250ZXh0JyxcbiAgQ0RLX0FTU0VNQkxZX0kwMjQxOiAnRmV0Y2hpbmcgbWlzc2luZyBjb250ZXh0JyxcbiAgQ0RLX0FTU0VNQkxZX0kxMDAwOiAnQ2xvdWQgYXNzZW1ibHkgb3V0cHV0IHN0YXJ0cycsXG4gIENES19BU1NFTUJMWV9JMTAwMTogJ091dHB1dCBsaW5lcyBlbWl0dGVkIGJ5IHRoZSBjbG91ZCBhc3NlbWJseSB0byBzdGRvdXQnLFxuICBDREtfQVNTRU1CTFlfRTEwMDI6ICdPdXRwdXQgbGluZXMgZW1pdHRlZCBieSB0aGUgY2xvdWQgYXNzZW1ibHkgdG8gc3RkZXJyJyxcbiAgQ0RLX0FTU0VNQkxZX0kxMDAzOiAnQ2xvdWQgYXNzZW1ibHkgb3V0cHV0IGZpbmlzaGVkJyxcbiAgQ0RLX0FTU0VNQkxZX0UxMTExOiAnSW5jb21wYXRpYmxlIENESyBDTEkgdmVyc2lvbi4gVXBncmFkZSBuZWVkZWQuJyxcbn07XG5cbi8vIElmIHdlIGdpdmUgQ09ERVMgYSB0eXBlIHdpdGgga2V5OiBJb01lc3NhZ2VDb2RlLFxuLy8gdGhpcyBkeW5hbWljYWxseSBnZW5lcmF0ZWQgdHlwZSB3aWxsIGdlbmVyYWxpemUgdG8gYWxsb3cgYWxsIElvTWVzc2FnZUNvZGVzLlxuLy8gSW5zdGVhZCwgd2Ugd2lsbCB2YWxpZGF0ZSB0aGF0IFZBTElEX0NPREUgbXVzdCBiZSBJb01lc3NhZ2VDb2RlIHdpdGggdGhlICcmJy5cbmV4cG9ydCB0eXBlIFZBTElEX0NPREUgPSBrZXlvZiB0eXBlb2YgQ09ERVMgJiBJb01lc3NhZ2VDb2RlO1xuIl19

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

@@ -0,0 +1,6 @@
+export * from './codes';
+export * from './level-priority';
+export * from './logger';
+export * from './messages';
+export * from './timer';
+export * from './types';

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

@@ -0,0 +1,23 @@
+"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("./codes"), exports);
+__exportStar(require("./level-priority"), exports);
+__exportStar(require("./logger"), exports);
+__exportStar(require("./messages"), exports);
+__exportStar(require("./timer"), exports);
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJpbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7O0FBQUEsMENBQXdCO0FBQ3hCLG1EQUFpQztBQUNqQywyQ0FBeUI7QUFDekIsNkNBQTJCO0FBQzNCLDBDQUF3QjtBQUN4QiwwQ0FBd0IiLCJzb3VyY2VzQ29udGVudCI6WyJleHBvcnQgKiBmcm9tICcuL2NvZGVzJztcbmV4cG9ydCAqIGZyb20gJy4vbGV2ZWwtcHJpb3JpdHknO1xuZXhwb3J0ICogZnJvbSAnLi9sb2dnZXInO1xuZXhwb3J0ICogZnJvbSAnLi9tZXNzYWdlcyc7XG5leHBvcnQgKiBmcm9tICcuL3RpbWVyJztcbmV4cG9ydCAqIGZyb20gJy4vdHlwZXMnO1xuIl19

package/lib/api/io/private/level-priority.d.ts

@@ -0,0 +1,11 @@
+import { IoMessageLevel } from '../io-message';
+/**
+ * Determines if a message is relevant for the given log level.
+ *
+ * @param msg The message to compare.
+ * @param level The level to compare against.
+ * @returns true if the message is relevant for the given level.
+ */
+export declare function isMessageRelevantForLevel(msg: {
+    level: IoMessageLevel;
+}, level: IoMessageLevel): boolean;

package/lib/api/io/private/level-priority.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isMessageRelevantForLevel = isMessageRelevantForLevel;
+/**
+ * Keep this list ordered from most to least verbose.
+ * Every level "includes" all of the levels below it.
+ * This is used to compare levels of messages to determine what should be logged.
+ */
+const levels = [
+    'trace',
+    'debug',
+    'info',
+    'warn',
+    'result',
+    'error',
+];
+// compare levels helper
+// helper to convert the array into a map with numbers
+const orderedLevels = Object.fromEntries(Object.entries(levels).map(a => a.reverse()));
+function compareFn(a, b) {
+    return orderedLevels[a] - orderedLevels[b];
+}
+/**
+ * Determines if a message is relevant for the given log level.
+ *
+ * @param msg The message to compare.
+ * @param level The level to compare against.
+ * @returns true if the message is relevant for the given level.
+ */
+function isMessageRelevantForLevel(msg, level) {
+    return compareFn(msg.level, level) >= 0;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibGV2ZWwtcHJpb3JpdHkuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJsZXZlbC1wcmlvcml0eS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQThCQSw4REFFQztBQTlCRDs7OztHQUlHO0FBQ0gsTUFBTSxNQUFNLEdBQUc7SUFDYixPQUFPO0lBQ1AsT0FBTztJQUNQLE1BQU07SUFDTixNQUFNO0lBQ04sUUFBUTtJQUNSLE9BQU87Q0FDQyxDQUFDO0FBRVgsd0JBQXdCO0FBQ3hCLHNEQUFzRDtBQUN0RCxNQUFNLGFBQWEsR0FBMEMsTUFBTSxDQUFDLFdBQVcsQ0FBQyxNQUFNLENBQUMsT0FBTyxDQUFDLE1BQU0sQ0FBQyxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsQ0FBQyxPQUFPLEVBQUUsQ0FBQyxDQUFDLENBQUM7QUFDOUgsU0FBUyxTQUFTLENBQUMsQ0FBaUIsRUFBRSxDQUFpQjtJQUNyRCxPQUFPLGFBQWEsQ0FBQyxDQUFDLENBQUMsR0FBRyxhQUFhLENBQUMsQ0FBQyxDQUFDLENBQUM7QUFDN0MsQ0FBQztBQUVEOzs7Ozs7R0FNRztBQUNILFNBQWdCLHlCQUF5QixDQUFDLEdBQTZCLEVBQUUsS0FBcUI7SUFDNUYsT0FBTyxTQUFTLENBQUMsR0FBRyxDQUFDLEtBQUssRUFBRSxLQUFLLENBQUMsSUFBSSxDQUFDLENBQUM7QUFDMUMsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IElvTWVzc2FnZUxldmVsIH0gZnJvbSAnLi4vaW8tbWVzc2FnZSc7XG5cbi8qKlxuICogS2VlcCB0aGlzIGxpc3Qgb3JkZXJlZCBmcm9tIG1vc3QgdG8gbGVhc3QgdmVyYm9zZS5cbiAqIEV2ZXJ5IGxldmVsIFwiaW5jbHVkZXNcIiBhbGwgb2YgdGhlIGxldmVscyBiZWxvdyBpdC5cbiAqIFRoaXMgaXMgdXNlZCB0byBjb21wYXJlIGxldmVscyBvZiBtZXNzYWdlcyB0byBkZXRlcm1pbmUgd2hhdCBzaG91bGQgYmUgbG9nZ2VkLlxuICovXG5jb25zdCBsZXZlbHMgPSBbXG4gICd0cmFjZScsXG4gICdkZWJ1ZycsXG4gICdpbmZvJyxcbiAgJ3dhcm4nLFxuICAncmVzdWx0JyxcbiAgJ2Vycm9yJyxcbl0gYXMgY29uc3Q7XG5cbi8vIGNvbXBhcmUgbGV2ZWxzIGhlbHBlclxuLy8gaGVscGVyIHRvIGNvbnZlcnQgdGhlIGFycmF5IGludG8gYSBtYXAgd2l0aCBudW1iZXJzXG5jb25zdCBvcmRlcmVkTGV2ZWxzOiBSZWNvcmQ8dHlwZW9mIGxldmVsc1tudW1iZXJdLCBudW1iZXI+ID0gT2JqZWN0LmZyb21FbnRyaWVzKE9iamVjdC5lbnRyaWVzKGxldmVscykubWFwKGEgPT4gYS5yZXZlcnNlKCkpKTtcbmZ1bmN0aW9uIGNvbXBhcmVGbihhOiBJb01lc3NhZ2VMZXZlbCwgYjogSW9NZXNzYWdlTGV2ZWwpOiBudW1iZXIge1xuICByZXR1cm4gb3JkZXJlZExldmVsc1thXSAtIG9yZGVyZWRMZXZlbHNbYl07XG59XG5cbi8qKlxuICogRGV0ZXJtaW5lcyBpZiBhIG1lc3NhZ2UgaXMgcmVsZXZhbnQgZm9yIHRoZSBnaXZlbiBsb2cgbGV2ZWwuXG4gKlxuICogQHBhcmFtIG1zZyBUaGUgbWVzc2FnZSB0byBjb21wYXJlLlxuICogQHBhcmFtIGxldmVsIFRoZSBsZXZlbCB0byBjb21wYXJlIGFnYWluc3QuXG4gKiBAcmV0dXJucyB0cnVlIGlmIHRoZSBtZXNzYWdlIGlzIHJlbGV2YW50IGZvciB0aGUgZ2l2ZW4gbGV2ZWwuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBpc01lc3NhZ2VSZWxldmFudEZvckxldmVsKG1zZzogeyBsZXZlbDogSW9NZXNzYWdlTGV2ZWx9LCBsZXZlbDogSW9NZXNzYWdlTGV2ZWwpOiBib29sZWFuIHtcbiAgcmV0dXJuIGNvbXBhcmVGbihtc2cubGV2ZWwsIGxldmVsKSA+PSAwO1xufVxuXG4iXX0=

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

@@ -0,0 +1,40 @@
+import type { Logger } from '@smithy/types';
+import type { IoMessage, IoRequest } from '../io-message';
+import type { ActionAwareIoHost, IoMessageCodeCategory } from './types';
+import type { ToolkitAction } from '../../../toolkit';
+import type { IIoHost } from '../io-host';
+/**
+ * An IoHost wrapper that adds the given action to an actionless message before
+ * sending the message to the given IoHost
+ */
+export declare function withAction(ioHost: IIoHost, action: ToolkitAction): {
+    notify: <T>(msg: Omit<IoMessage<T>, "action">) => Promise<void>;
+    requestResponse: <T, U>(msg: Omit<IoRequest<T, U>, "action">) => Promise<U>;
+};
+/**
+ * An IoHost wrapper that strips out ANSI colors and styles from the message before
+ * sending the message to the given IoHost
+ */
+export declare function withoutColor(ioHost: IIoHost): IIoHost;
+/**
+ * An IoHost wrapper that strips out emojis from the message before
+ * sending the message to the given IoHost
+ */
+export declare function withoutEmojis(ioHost: IIoHost): IIoHost;
+/**
+ * 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.
+ */
+export declare function withTrimmedWhitespace(ioHost: IIoHost): IIoHost;
+export declare function asSdkLogger(ioHost: IIoHost, action: ToolkitAction): Logger;
+/**
+ * Turn an ActionAwareIoHost into a logger that is compatible with older code, but doesn't support data
+ */
+export declare function asLogger(ioHost: ActionAwareIoHost, category?: IoMessageCodeCategory): {
+    trace: (msg: string, ...args: any[]) => Promise<void>;
+    debug: (msg: string, ...args: any[]) => Promise<void>;
+    info: (msg: string, ...args: any[]) => Promise<void>;
+    warn: (msg: string, ...args: any[]) => Promise<void>;
+    error: (msg: string, ...args: any[]) => Promise<void>;
+};