@aws-cdk/toolkit-lib 0.3.2 → 0.3.3

package/lib/api/index.js

@@ -0,0 +1,42 @@
+"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("./aws-auth"), exports);
+__exportStar(require("./bootstrap"), exports);
+__exportStar(require("./cloud-assembly"), exports);
+__exportStar(require("./cloudformation"), exports);
+__exportStar(require("./context"), exports);
+__exportStar(require("./deployments"), exports);
+__exportStar(require("./diff"), exports);
+__exportStar(require("./environment"), exports);
+__exportStar(require("./garbage-collection"), exports);
+__exportStar(require("./hotswap"), exports);
+__exportStar(require("./io"), exports);
+__exportStar(require("./logs-monitor"), exports);
+__exportStar(require("./notices"), exports);
+__exportStar(require("./plugin"), exports);
+__exportStar(require("./refactoring"), exports);
+__exportStar(require("./require-approval"), exports);
+__exportStar(require("./resource-import"), exports);
+__exportStar(require("./rwlock"), exports);
+__exportStar(require("./settings"), exports);
+__exportStar(require("./stack-events"), exports);
+__exportStar(require("./toolkit-error"), exports);
+__exportStar(require("./toolkit-info"), exports);
+__exportStar(require("./work-graph"), exports);
+__exportStar(require("./tree"), exports);
+__exportStar(require("./tags"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJpbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7O0FBQUEsNkNBQTJCO0FBQzNCLDhDQUE0QjtBQUM1QixtREFBaUM7QUFDakMsbURBQWlDO0FBQ2pDLDRDQUEwQjtBQUMxQixnREFBOEI7QUFDOUIseUNBQXVCO0FBQ3ZCLGdEQUE4QjtBQUM5Qix1REFBcUM7QUFDckMsNENBQTBCO0FBQzFCLHVDQUFxQjtBQUNyQixpREFBK0I7QUFDL0IsNENBQTBCO0FBQzFCLDJDQUF5QjtBQUN6QixnREFBOEI7QUFDOUIscURBQW1DO0FBQ25DLG9EQUFrQztBQUNsQywyQ0FBeUI7QUFDekIsNkNBQTJCO0FBQzNCLGlEQUErQjtBQUMvQixrREFBZ0M7QUFDaEMsaURBQStCO0FBQy9CLCtDQUE2QjtBQUM3Qix5Q0FBdUI7QUFDdkIseUNBQXVCIiwic291cmNlc0NvbnRlbnQiOlsiZXhwb3J0ICogZnJvbSAnLi9hd3MtYXV0aCc7XG5leHBvcnQgKiBmcm9tICcuL2Jvb3RzdHJhcCc7XG5leHBvcnQgKiBmcm9tICcuL2Nsb3VkLWFzc2VtYmx5JztcbmV4cG9ydCAqIGZyb20gJy4vY2xvdWRmb3JtYXRpb24nO1xuZXhwb3J0ICogZnJvbSAnLi9jb250ZXh0JztcbmV4cG9ydCAqIGZyb20gJy4vZGVwbG95bWVudHMnO1xuZXhwb3J0ICogZnJvbSAnLi9kaWZmJztcbmV4cG9ydCAqIGZyb20gJy4vZW52aXJvbm1lbnQnO1xuZXhwb3J0ICogZnJvbSAnLi9nYXJiYWdlLWNvbGxlY3Rpb24nO1xuZXhwb3J0ICogZnJvbSAnLi9ob3Rzd2FwJztcbmV4cG9ydCAqIGZyb20gJy4vaW8nO1xuZXhwb3J0ICogZnJvbSAnLi9sb2dzLW1vbml0b3InO1xuZXhwb3J0ICogZnJvbSAnLi9ub3RpY2VzJztcbmV4cG9ydCAqIGZyb20gJy4vcGx1Z2luJztcbmV4cG9ydCAqIGZyb20gJy4vcmVmYWN0b3JpbmcnO1xuZXhwb3J0ICogZnJvbSAnLi9yZXF1aXJlLWFwcHJvdmFsJztcbmV4cG9ydCAqIGZyb20gJy4vcmVzb3VyY2UtaW1wb3J0JztcbmV4cG9ydCAqIGZyb20gJy4vcndsb2NrJztcbmV4cG9ydCAqIGZyb20gJy4vc2V0dGluZ3MnO1xuZXhwb3J0ICogZnJvbSAnLi9zdGFjay1ldmVudHMnO1xuZXhwb3J0ICogZnJvbSAnLi90b29sa2l0LWVycm9yJztcbmV4cG9ydCAqIGZyb20gJy4vdG9vbGtpdC1pbmZvJztcbmV4cG9ydCAqIGZyb20gJy4vd29yay1ncmFwaCc7XG5leHBvcnQgKiBmcm9tICcuL3RyZWUnO1xuZXhwb3J0ICogZnJvbSAnLi90YWdzJztcbiJdfQ==

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

@@ -1 +1,3 @@
-export type { IoMessageLevel, IoMessageCode, IIoHost, IoMessage, IoRequest } from '../shared-public';
+export * from './io-host';
+export * from './io-message';
+export * from './toolkit-action';

package/lib/api/io/index.js

@@ -1,3 +1,20 @@
 "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 });
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJpbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIiwic291cmNlc0NvbnRlbnQiOlsiZXhwb3J0IHR5cGUgeyBJb01lc3NhZ2VMZXZlbCwgSW9NZXNzYWdlQ29kZSwgSUlvSG9zdCwgSW9NZXNzYWdlLCBJb1JlcXVlc3QgfSBmcm9tICcuLi9zaGFyZWQtcHVibGljJztcbiJdfQ==
+__exportStar(require("./io-host"), exports);
+__exportStar(require("./io-message"), exports);
+__exportStar(require("./toolkit-action"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJpbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7O0FBQUEsNENBQTBCO0FBQzFCLCtDQUE2QjtBQUM3QixtREFBaUMiLCJzb3VyY2VzQ29udGVudCI6WyJleHBvcnQgKiBmcm9tICcuL2lvLWhvc3QnO1xuZXhwb3J0ICogZnJvbSAnLi9pby1tZXNzYWdlJztcbmV4cG9ydCAqIGZyb20gJy4vdG9vbGtpdC1hY3Rpb24nO1xuIl19

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

@@ -0,0 +1,15 @@
+import type { IoMessage, IoRequest } from './io-message';
+export interface IIoHost {
+    /**
+     * Notifies the host of a message.
+     * The caller waits until the notification completes.
+     */
+    notify(msg: IoMessage<unknown>): 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,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW8taG9zdC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbImlvLWhvc3QudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB0eXBlIHsgSW9NZXNzYWdlLCBJb1JlcXVlc3QgfSBmcm9tICcuL2lvLW1lc3NhZ2UnO1xuXG5leHBvcnQgaW50ZXJmYWNlIElJb0hvc3Qge1xuICAvKipcbiAgICogTm90aWZpZXMgdGhlIGhvc3Qgb2YgYSBtZXNzYWdlLlxuICAgKiBUaGUgY2FsbGVyIHdhaXRzIHVudGlsIHRoZSBub3RpZmljYXRpb24gY29tcGxldGVzLlxuICAgKi9cbiAgbm90aWZ5KG1zZzogSW9NZXNzYWdlPHVua25vd24+KTogUHJvbWlzZTx2b2lkPjtcblxuICAvKipcbiAgICogTm90aWZpZXMgdGhlIGhvc3Qgb2YgYSBtZXNzYWdlIHRoYXQgcmVxdWlyZXMgYSByZXNwb25zZS5cbiAgICpcbiAgICogSWYgdGhlIGhvc3QgZG9lcyBub3QgcmV0dXJuIGEgcmVzcG9uc2UgdGhlIHN1Z2dlc3RlZFxuICAgKiBkZWZhdWx0IHJlc3BvbnNlIGZyb20gdGhlIGlucHV0IG1lc3NhZ2Ugd2lsbCBiZSB1c2VkLlxuICAgKi9cbiAgcmVxdWVzdFJlc3BvbnNlPFQsIFU+KG1zZzogSW9SZXF1ZXN0PFQsIFU+KTogUHJvbWlzZTxVPjtcbn1cbiJdfQ==

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

@@ -0,0 +1,76 @@
+import type { ToolkitAction } from './toolkit-action';
+/**
+ * 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 recommended log level of the message.
+     *
+     * This is an indicative level and should not be used to explicitly match messages, instead match the `code`.
+     * The level of a message may change without notice.
+     */
+    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
+     * ```
+     *
+     * @see https://github.com/aws/aws-cdk-cli/blob/main/packages/%40aws-cdk/toolkit-lib/CODE_REGISTRY.md
+     */
+    readonly code: IoMessageCode;
+    /**
+     * The message text.
+     * This is safe to print to an end-user.
+     */
+    readonly message: string;
+    /**
+     * Identifies the message span, this message belongs to.
+     *
+     * A message span, groups multiple messages together that semantically related to the same operation.
+     * This is an otherwise meaningless identifier.
+     *
+     * A message without a `spanId`, does not belong to a span.
+     */
+    readonly span?: string;
+    /**
+     * The data attached to the message.
+     */
+    readonly data: T;
+}
+/**
+ * An IO request emitted.
+ */
+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,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW8tbWVzc2FnZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbImlvLW1lc3NhZ2UudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB0eXBlIHsgVG9vbGtpdEFjdGlvbiB9IGZyb20gJy4vdG9vbGtpdC1hY3Rpb24nO1xuXG4vKipcbiAqIFRoZSByZXBvcnRpbmcgbGV2ZWwgb2YgdGhlIG1lc3NhZ2UuXG4gKiBBbGwgbWVzc2FnZXMgYXJlIGFsd2F5cyByZXBvcnRlZCwgaXQncyB1cCB0byB0aGUgSW9Ib3N0IHRvIGRlY2lkZSB3aGF0IHRvIGxvZy5cbiAqL1xuZXhwb3J0IHR5cGUgSW9NZXNzYWdlTGV2ZWwgPSAnZXJyb3InfCAncmVzdWx0JyB8ICd3YXJuJyB8ICdpbmZvJyB8ICdkZWJ1ZycgfCAndHJhY2UnO1xuXG4vKipcbiAqIEEgdmFsaWQgbWVzc2FnZSBjb2RlLlxuICovXG5leHBvcnQgdHlwZSBJb01lc3NhZ2VDb2RlID0gYENES18ke3N0cmluZ31fJHsnRScgfCAnVycgfCAnSSd9JHtudW1iZXJ9JHtudW1iZXJ9JHtudW1iZXJ9JHtudW1iZXJ9YDtcblxuLyoqXG4gKiBBbiBJTyBtZXNzYWdlIGVtaXR0ZWQuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgSW9NZXNzYWdlPFQ+IHtcbiAgLyoqXG4gICAqIFRoZSB0aW1lIHRoZSBtZXNzYWdlIHdhcyBlbWl0dGVkLlxuICAgKi9cbiAgcmVhZG9ubHkgdGltZTogRGF0ZTtcblxuICAvKipcbiAgICogVGhlIHJlY29tbWVuZGVkIGxvZyBsZXZlbCBvZiB0aGUgbWVzc2FnZS5cbiAgICpcbiAgICogVGhpcyBpcyBhbiBpbmRpY2F0aXZlIGxldmVsIGFuZCBzaG91bGQgbm90IGJlIHVzZWQgdG8gZXhwbGljaXRseSBtYXRjaCBtZXNzYWdlcywgaW5zdGVhZCBtYXRjaCB0aGUgYGNvZGVgLlxuICAgKiBUaGUgbGV2ZWwgb2YgYSBtZXNzYWdlIG1heSBjaGFuZ2Ugd2l0aG91dCBub3RpY2UuXG4gICAqL1xuICByZWFkb25seSBsZXZlbDogSW9NZXNzYWdlTGV2ZWw7XG5cbiAgLyoqXG4gICAqIFRoZSBhY3Rpb24gdGhhdCB0cmlnZ2VyZWQgdGhlIG1lc3NhZ2UuXG4gICAqL1xuICByZWFkb25seSBhY3Rpb246IFRvb2xraXRBY3Rpb247XG5cbiAgLyoqXG4gICAqIEEgc2hvcnQgbWVzc2FnZSBjb2RlIHVuaXF1ZWx5IGlkZW50aWZ5aW5nIGEgbWVzc2FnZSB0eXBlIHVzaW5nIHRoZSBmb3JtYXQgQ0RLX1tDQVRFR09SWV1fW0UvVy9JXVswMDAwLTk5OTldLlxuICAgKlxuICAgKiBUaGUgbGV2ZWwgaW5kaWNhdG9yIGZvbGxvd3MgdGhlc2UgcnVsZXM6XG4gICAqIC0gJ0UnIGZvciBlcnJvciBsZXZlbCBtZXNzYWdlc1xuICAgKiAtICdXJyBmb3Igd2FybmluZyBsZXZlbCBtZXNzYWdlc1xuICAgKiAtICdJJyBmb3IgaW5mby9kZWJ1Zy90cmFjZSBsZXZlbCBtZXNzYWdlc1xuICAgKlxuICAgKiBDb2RlcyBlbmRpbmcgaW4gMDAwIDAgYXJlIGdlbmVyaWMgbWVzc2FnZXMsIHdoaWxlIGNvZGVzIGVuZGluZyBpbiAwMDAxLTk5OTkgYXJlIHNwZWNpZmljIHRvIGEgcGFydGljdWxhciBtZXNzYWdlLlxuICAgKiBUaGUgZm9sbG93aW5nIGFyZSBleGFtcGxlcyBvZiB2YWxpZCBhbmQgaW52YWxpZCBtZXNzYWdlIGNvZGVzOlxuICAgKiBgYGB0c1xuICAgKiAnQ0RLX0FTU0VUU19JMDAwMCcgICAgICAgLy8gdmFsaWQ6IGdlbmVyaWMgYXNzZXRzIGluZm8gbWVzc2FnZVxuICAgKiAnQ0RLX1RPT0xLSVRfRTAwMDInICAgICAgLy8gdmFsaWQ6IHNwZWNpZmljIHRvb2xraXQgZXJyb3IgbWVzc2FnZVxuICAgKiAnQ0RLX1NES19XMDAyMycgICAgICAgICAgLy8gdmFsaWQ6IHNwZWNpZmljIHNkayB3YXJuaW5nIG1lc3NhZ2VcbiAgICogYGBgXG4gICAqXG4gICAqIEBzZWUgaHR0cHM6Ly9naXRodWIuY29tL2F3cy9hd3MtY2RrLWNsaS9ibG9iL21haW4vcGFja2FnZXMvJTQwYXdzLWNkay90b29sa2l0LWxpYi9DT0RFX1JFR0lTVFJZLm1kXG4gICAqL1xuICByZWFkb25seSBjb2RlOiBJb01lc3NhZ2VDb2RlO1xuXG4gIC8qKlxuICAgKiBUaGUgbWVzc2FnZSB0ZXh0LlxuICAgKiBUaGlzIGlzIHNhZmUgdG8gcHJpbnQgdG8gYW4gZW5kLXVzZXIuXG4gICAqL1xuICByZWFkb25seSBtZXNzYWdlOiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIElkZW50aWZpZXMgdGhlIG1lc3NhZ2Ugc3BhbiwgdGhpcyBtZXNzYWdlIGJlbG9uZ3MgdG8uXG4gICAqXG4gICAqIEEgbWVzc2FnZSBzcGFuLCBncm91cHMgbXVsdGlwbGUgbWVzc2FnZXMgdG9nZXRoZXIgdGhhdCBzZW1hbnRpY2FsbHkgcmVsYXRlZCB0byB0aGUgc2FtZSBvcGVyYXRpb24uXG4gICAqIFRoaXMgaXMgYW4gb3RoZXJ3aXNlIG1lYW5pbmdsZXNzIGlkZW50aWZpZXIuXG4gICAqXG4gICAqIEEgbWVzc2FnZSB3aXRob3V0IGEgYHNwYW5JZGAsIGRvZXMgbm90IGJlbG9uZyB0byBhIHNwYW4uXG4gICAqL1xuICByZWFkb25seSBzcGFuPzogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBUaGUgZGF0YSBhdHRhY2hlZCB0byB0aGUgbWVzc2FnZS5cbiAgICovXG4gIHJlYWRvbmx5IGRhdGE6IFQ7XG59XG5cbi8qKlxuICogQW4gSU8gcmVxdWVzdCBlbWl0dGVkLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIElvUmVxdWVzdDxULCBVPiBleHRlbmRzIElvTWVzc2FnZTxUPiB7XG4gIC8qKlxuICAgKiBUaGUgZGVmYXVsdCByZXNwb25zZSB0aGF0IHdpbGwgYmUgdXNlZCBpZiBubyBkYXRhIGlzIHJldHVybmVkLlxuICAgKi9cbiAgcmVhZG9ubHkgZGVmYXVsdFJlc3BvbnNlOiBVO1xufVxuIl19

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

@@ -1,3 +1,9 @@
-export { IO, SPAN } from '../../shared-private';
 export * from './io-host-wrappers';
 export * from './sdk-logger';
+export * from './io-helper';
+export * from './level-priority';
+export * from './span';
+export * from './message-maker';
+export * from './messages';
+export * from './types';
+export * from './io-default-messages';

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

@@ -14,10 +14,13 @@ 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 });
-exports.SPAN = exports.IO = void 0;
-var shared_private_1 = require("../../shared-private");
-Object.defineProperty(exports, "IO", { enumerable: true, get: function () { return shared_private_1.IO; } });
-Object.defineProperty(exports, "SPAN", { enumerable: true, get: function () { return shared_private_1.SPAN; } });
 __exportStar(require("./io-host-wrappers"), exports);
 __exportStar(require("./sdk-logger"), exports);
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJpbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7OztBQUFBLHVEQUFnRDtBQUF2QyxvR0FBQSxFQUFFLE9BQUE7QUFBRSxzR0FBQSxJQUFJLE9BQUE7QUFDakIscURBQW1DO0FBQ25DLCtDQUE2QiIsInNvdXJjZXNDb250ZW50IjpbImV4cG9ydCB7IElPLCBTUEFOIH0gZnJvbSAnLi4vLi4vc2hhcmVkLXByaXZhdGUnO1xuZXhwb3J0ICogZnJvbSAnLi9pby1ob3N0LXdyYXBwZXJzJztcbmV4cG9ydCAqIGZyb20gJy4vc2RrLWxvZ2dlcic7XG5cbiJdfQ==
+__exportStar(require("./io-helper"), exports);
+__exportStar(require("./level-priority"), exports);
+__exportStar(require("./span"), exports);
+__exportStar(require("./message-maker"), exports);
+__exportStar(require("./messages"), exports);
+__exportStar(require("./types"), exports);
+__exportStar(require("./io-default-messages"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJpbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7O0FBQUEscURBQW1DO0FBQ25DLCtDQUE2QjtBQUM3Qiw4Q0FBNEI7QUFDNUIsbURBQWlDO0FBQ2pDLHlDQUF1QjtBQUN2QixrREFBZ0M7QUFDaEMsNkNBQTJCO0FBQzNCLDBDQUF3QjtBQUN4Qix3REFBc0MiLCJzb3VyY2VzQ29udGVudCI6WyJleHBvcnQgKiBmcm9tICcuL2lvLWhvc3Qtd3JhcHBlcnMnO1xuZXhwb3J0ICogZnJvbSAnLi9zZGstbG9nZ2VyJztcbmV4cG9ydCAqIGZyb20gJy4vaW8taGVscGVyJztcbmV4cG9ydCAqIGZyb20gJy4vbGV2ZWwtcHJpb3JpdHknO1xuZXhwb3J0ICogZnJvbSAnLi9zcGFuJztcbmV4cG9ydCAqIGZyb20gJy4vbWVzc2FnZS1tYWtlcic7XG5leHBvcnQgKiBmcm9tICcuL21lc3NhZ2VzJztcbmV4cG9ydCAqIGZyb20gJy4vdHlwZXMnO1xuZXhwb3J0ICogZnJvbSAnLi9pby1kZWZhdWx0LW1lc3NhZ2VzJztcbiJdfQ==

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

@@ -0,0 +1,21 @@
+import type { ActionLessMessage, ActionLessRequest, IoHelper } from './io-helper';
+/**
+ * Helper class to emit standard log messages to an IoHost
+ *
+ * It wraps an `IoHelper`, and adds convenience methods to emit default messages
+ * for the various log levels.
+ */
+export declare class IoDefaultMessages {
+    private readonly ioHelper;
+    constructor(ioHelper: IoHelper);
+    notify(msg: ActionLessMessage<unknown>): Promise<void>;
+    requestResponse<T, U>(msg: ActionLessRequest<T, U>): Promise<U>;
+    error(input: string, ...args: unknown[]): void;
+    warn(input: string, ...args: unknown[]): void;
+    warning(input: string, ...args: unknown[]): void;
+    info(input: string, ...args: unknown[]): void;
+    debug(input: string, ...args: unknown[]): void;
+    trace(input: string, ...args: unknown[]): void;
+    result(input: string, ...args: unknown[]): void;
+    private emitMessage;
+}

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

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IoDefaultMessages = void 0;
+const util = require("util");
+const messages_1 = require("./messages");
+/**
+ * Helper class to emit standard log messages to an IoHost
+ *
+ * It wraps an `IoHelper`, and adds convenience methods to emit default messages
+ * for the various log levels.
+ */
+class IoDefaultMessages {
+    ioHelper;
+    constructor(ioHelper) {
+        this.ioHelper = ioHelper;
+    }
+    notify(msg) {
+        return this.ioHelper.notify(msg);
+    }
+    requestResponse(msg) {
+        return this.ioHelper.requestResponse(msg);
+    }
+    error(input, ...args) {
+        this.emitMessage(messages_1.IO.DEFAULT_TOOLKIT_ERROR, input, ...args);
+    }
+    warn(input, ...args) {
+        this.emitMessage(messages_1.IO.DEFAULT_TOOLKIT_WARN, input, ...args);
+    }
+    warning(input, ...args) {
+        this.emitMessage(messages_1.IO.DEFAULT_TOOLKIT_WARN, input, ...args);
+    }
+    info(input, ...args) {
+        this.emitMessage(messages_1.IO.DEFAULT_TOOLKIT_INFO, input, ...args);
+    }
+    debug(input, ...args) {
+        this.emitMessage(messages_1.IO.DEFAULT_TOOLKIT_DEBUG, input, ...args);
+    }
+    trace(input, ...args) {
+        this.emitMessage(messages_1.IO.DEFAULT_TOOLKIT_TRACE, input, ...args);
+    }
+    result(input, ...args) {
+        const message = args.length > 0 ? util.format(input, ...args) : input;
+        // This is just the default "info" message but with a level of "result"
+        void this.ioHelper.notify({
+            time: new Date(),
+            code: messages_1.IO.DEFAULT_TOOLKIT_INFO.code,
+            level: 'result',
+            message,
+            data: undefined,
+        });
+    }
+    emitMessage(maker, input, ...args) {
+        // Format message if args are provided
+        const message = args.length > 0 ? util.format(input, ...args) : input;
+        void this.ioHelper.notify(maker.msg(message));
+    }
+}
+exports.IoDefaultMessages = IoDefaultMessages;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW8tZGVmYXVsdC1tZXNzYWdlcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbImlvLWRlZmF1bHQtbWVzc2FnZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBQUEsNkJBQTZCO0FBRzdCLHlDQUFnQztBQUVoQzs7Ozs7R0FLRztBQUNILE1BQWEsaUJBQWlCO0lBQ0M7SUFBN0IsWUFBNkIsUUFBa0I7UUFBbEIsYUFBUSxHQUFSLFFBQVEsQ0FBVTtJQUMvQyxDQUFDO0lBRU0sTUFBTSxDQUFDLEdBQStCO1FBQzNDLE9BQU8sSUFBSSxDQUFDLFFBQVEsQ0FBQyxNQUFNLENBQUMsR0FBRyxDQUFDLENBQUM7SUFDbkMsQ0FBQztJQUVNLGVBQWUsQ0FBTyxHQUE0QjtRQUN2RCxPQUFPLElBQUksQ0FBQyxRQUFRLENBQUMsZUFBZSxDQUFDLEdBQUcsQ0FBQyxDQUFDO0lBQzVDLENBQUM7SUFFTSxLQUFLLENBQUMsS0FBYSxFQUFFLEdBQUcsSUFBZTtRQUM1QyxJQUFJLENBQUMsV0FBVyxDQUFDLGFBQUUsQ0FBQyxxQkFBcUIsRUFBRSxLQUFLLEVBQUUsR0FBRyxJQUFJLENBQUMsQ0FBQztJQUM3RCxDQUFDO0lBRU0sSUFBSSxDQUFDLEtBQWEsRUFBRSxHQUFHLElBQWU7UUFDM0MsSUFBSSxDQUFDLFdBQVcsQ0FBQyxhQUFFLENBQUMsb0JBQW9CLEVBQUUsS0FBSyxFQUFFLEdBQUcsSUFBSSxDQUFDLENBQUM7SUFDNUQsQ0FBQztJQUVNLE9BQU8sQ0FBQyxLQUFhLEVBQUUsR0FBRyxJQUFlO1FBQzlDLElBQUksQ0FBQyxXQUFXLENBQUMsYUFBRSxDQUFDLG9CQUFvQixFQUFFLEtBQUssRUFBRSxHQUFHLElBQUksQ0FBQyxDQUFDO0lBQzVELENBQUM7SUFFTSxJQUFJLENBQUMsS0FBYSxFQUFFLEdBQUcsSUFBZTtRQUMzQyxJQUFJLENBQUMsV0FBVyxDQUFDLGFBQUUsQ0FBQyxvQkFBb0IsRUFBRSxLQUFLLEVBQUUsR0FBRyxJQUFJLENBQUMsQ0FBQztJQUM1RCxDQUFDO0lBRU0sS0FBSyxDQUFDLEtBQWEsRUFBRSxHQUFHLElBQWU7UUFDNUMsSUFBSSxDQUFDLFdBQVcsQ0FBQyxhQUFFLENBQUMscUJBQXFCLEVBQUUsS0FBSyxFQUFFLEdBQUcsSUFBSSxDQUFDLENBQUM7SUFDN0QsQ0FBQztJQUVNLEtBQUssQ0FBQyxLQUFhLEVBQUUsR0FBRyxJQUFlO1FBQzVDLElBQUksQ0FBQyxXQUFXLENBQUMsYUFBRSxDQUFDLHFCQUFxQixFQUFFLEtBQUssRUFBRSxHQUFHLElBQUksQ0FBQyxDQUFDO0lBQzdELENBQUM7SUFFTSxNQUFNLENBQUMsS0FBYSxFQUFFLEdBQUcsSUFBZTtRQUM3QyxNQUFNLE9BQU8sR0FBRyxJQUFJLENBQUMsTUFBTSxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDLE1BQU0sQ0FBQyxLQUFLLEVBQUUsR0FBRyxJQUFJLENBQUMsQ0FBQyxDQUFDLENBQUMsS0FBSyxDQUFDO1FBQ3RFLHVFQUF1RTtRQUN2RSxLQUFLLElBQUksQ0FBQyxRQUFRLENBQUMsTUFBTSxDQUFDO1lBQ3hCLElBQUksRUFBRSxJQUFJLElBQUksRUFBRTtZQUNoQixJQUFJLEVBQUUsYUFBRSxDQUFDLG9CQUFvQixDQUFDLElBQUk7WUFDbEMsS0FBSyxFQUFFLFFBQVE7WUFDZixPQUFPO1lBQ1AsSUFBSSxFQUFFLFNBQVM7U0FDaEIsQ0FBQyxDQUFDO0lBQ0wsQ0FBQztJQUVPLFdBQVcsQ0FBQyxLQUEyQixFQUFFLEtBQWEsRUFBRSxHQUFHLElBQWU7UUFDaEYsc0NBQXNDO1FBQ3RDLE1BQU0sT0FBTyxHQUFHLElBQUksQ0FBQyxNQUFNLEdBQUcsQ0FBQyxDQUFDLENBQUMsQ0FBQyxJQUFJLENBQUMsTUFBTSxDQUFDLEtBQUssRUFBRSxHQUFHLElBQUksQ0FBQyxDQUFDLENBQUMsQ0FBQyxLQUFLLENBQUM7UUFDdEUsS0FBSyxJQUFJLENBQUMsUUFBUSxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsR0FBRyxDQUFDLE9BQU8sQ0FBQyxDQUFDLENBQUM7SUFDaEQsQ0FBQztDQUNGO0FBckRELDhDQXFEQyIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCAqIGFzIHV0aWwgZnJvbSAndXRpbCc7XG5pbXBvcnQgdHlwZSB7IEFjdGlvbkxlc3NNZXNzYWdlLCBBY3Rpb25MZXNzUmVxdWVzdCwgSW9IZWxwZXIgfSBmcm9tICcuL2lvLWhlbHBlcic7XG5pbXBvcnQgdHlwZSB7IElvTWVzc2FnZU1ha2VyIH0gZnJvbSAnLi9tZXNzYWdlLW1ha2VyJztcbmltcG9ydCB7IElPIH0gZnJvbSAnLi9tZXNzYWdlcyc7XG5cbi8qKlxuICogSGVscGVyIGNsYXNzIHRvIGVtaXQgc3RhbmRhcmQgbG9nIG1lc3NhZ2VzIHRvIGFuIElvSG9zdFxuICpcbiAqIEl0IHdyYXBzIGFuIGBJb0hlbHBlcmAsIGFuZCBhZGRzIGNvbnZlbmllbmNlIG1ldGhvZHMgdG8gZW1pdCBkZWZhdWx0IG1lc3NhZ2VzXG4gKiBmb3IgdGhlIHZhcmlvdXMgbG9nIGxldmVscy5cbiAqL1xuZXhwb3J0IGNsYXNzIElvRGVmYXVsdE1lc3NhZ2VzIHtcbiAgY29uc3RydWN0b3IocHJpdmF0ZSByZWFkb25seSBpb0hlbHBlcjogSW9IZWxwZXIpIHtcbiAgfVxuXG4gIHB1YmxpYyBub3RpZnkobXNnOiBBY3Rpb25MZXNzTWVzc2FnZTx1bmtub3duPik6IFByb21pc2U8dm9pZD4ge1xuICAgIHJldHVybiB0aGlzLmlvSGVscGVyLm5vdGlmeShtc2cpO1xuICB9XG5cbiAgcHVibGljIHJlcXVlc3RSZXNwb25zZTxULCBVPihtc2c6IEFjdGlvbkxlc3NSZXF1ZXN0PFQsIFU+KTogUHJvbWlzZTxVPiB7XG4gICAgcmV0dXJuIHRoaXMuaW9IZWxwZXIucmVxdWVzdFJlc3BvbnNlKG1zZyk7XG4gIH1cblxuICBwdWJsaWMgZXJyb3IoaW5wdXQ6IHN0cmluZywgLi4uYXJnczogdW5rbm93bltdKSB7XG4gICAgdGhpcy5lbWl0TWVzc2FnZShJTy5ERUZBVUxUX1RPT0xLSVRfRVJST1IsIGlucHV0LCAuLi5hcmdzKTtcbiAgfVxuXG4gIHB1YmxpYyB3YXJuKGlucHV0OiBzdHJpbmcsIC4uLmFyZ3M6IHVua25vd25bXSkge1xuICAgIHRoaXMuZW1pdE1lc3NhZ2UoSU8uREVGQVVMVF9UT09MS0lUX1dBUk4sIGlucHV0LCAuLi5hcmdzKTtcbiAgfVxuXG4gIHB1YmxpYyB3YXJuaW5nKGlucHV0OiBzdHJpbmcsIC4uLmFyZ3M6IHVua25vd25bXSkge1xuICAgIHRoaXMuZW1pdE1lc3NhZ2UoSU8uREVGQVVMVF9UT09MS0lUX1dBUk4sIGlucHV0LCAuLi5hcmdzKTtcbiAgfVxuXG4gIHB1YmxpYyBpbmZvKGlucHV0OiBzdHJpbmcsIC4uLmFyZ3M6IHVua25vd25bXSkge1xuICAgIHRoaXMuZW1pdE1lc3NhZ2UoSU8uREVGQVVMVF9UT09MS0lUX0lORk8sIGlucHV0LCAuLi5hcmdzKTtcbiAgfVxuXG4gIHB1YmxpYyBkZWJ1ZyhpbnB1dDogc3RyaW5nLCAuLi5hcmdzOiB1bmtub3duW10pIHtcbiAgICB0aGlzLmVtaXRNZXNzYWdlKElPLkRFRkFVTFRfVE9PTEtJVF9ERUJVRywgaW5wdXQsIC4uLmFyZ3MpO1xuICB9XG5cbiAgcHVibGljIHRyYWNlKGlucHV0OiBzdHJpbmcsIC4uLmFyZ3M6IHVua25vd25bXSkge1xuICAgIHRoaXMuZW1pdE1lc3NhZ2UoSU8uREVGQVVMVF9UT09MS0lUX1RSQUNFLCBpbnB1dCwgLi4uYXJncyk7XG4gIH1cblxuICBwdWJsaWMgcmVzdWx0KGlucHV0OiBzdHJpbmcsIC4uLmFyZ3M6IHVua25vd25bXSkge1xuICAgIGNvbnN0IG1lc3NhZ2UgPSBhcmdzLmxlbmd0aCA+IDAgPyB1dGlsLmZvcm1hdChpbnB1dCwgLi4uYXJncykgOiBpbnB1dDtcbiAgICAvLyBUaGlzIGlzIGp1c3QgdGhlIGRlZmF1bHQgXCJpbmZvXCIgbWVzc2FnZSBidXQgd2l0aCBhIGxldmVsIG9mIFwicmVzdWx0XCJcbiAgICB2b2lkIHRoaXMuaW9IZWxwZXIubm90aWZ5KHtcbiAgICAgIHRpbWU6IG5ldyBEYXRlKCksXG4gICAgICBjb2RlOiBJTy5ERUZBVUxUX1RPT0xLSVRfSU5GTy5jb2RlLFxuICAgICAgbGV2ZWw6ICdyZXN1bHQnLFxuICAgICAgbWVzc2FnZSxcbiAgICAgIGRhdGE6IHVuZGVmaW5lZCxcbiAgICB9KTtcbiAgfVxuXG4gIHByaXZhdGUgZW1pdE1lc3NhZ2UobWFrZXI6IElvTWVzc2FnZU1ha2VyPHZvaWQ+LCBpbnB1dDogc3RyaW5nLCAuLi5hcmdzOiB1bmtub3duW10pIHtcbiAgICAvLyBGb3JtYXQgbWVzc2FnZSBpZiBhcmdzIGFyZSBwcm92aWRlZFxuICAgIGNvbnN0IG1lc3NhZ2UgPSBhcmdzLmxlbmd0aCA+IDAgPyB1dGlsLmZvcm1hdChpbnB1dCwgLi4uYXJncykgOiBpbnB1dDtcbiAgICB2b2lkIHRoaXMuaW9IZWxwZXIubm90aWZ5KG1ha2VyLm1zZyhtZXNzYWdlKSk7XG4gIH1cbn1cbiJdfQ==

package/lib/api/io/private/io-helper.d.ts

@@ -0,0 +1,32 @@
+import type { IIoHost } from '../io-host';
+import type { IoMessage, IoRequest } from '../io-message';
+import type { ToolkitAction } from '../toolkit-action';
+import type { SpanEnd, SpanDefinition } from './span';
+import { SpanMaker } from './span';
+export type ActionLessMessage<T> = Omit<IoMessage<T>, 'action'>;
+export type ActionLessRequest<T, U> = Omit<IoRequest<T, U>, 'action'>;
+/**
+ * A class containing helper tools to interact with IoHost
+ */
+export declare class IoHelper implements IIoHost {
+    static fromIoHost(ioHost: IIoHost, action: ToolkitAction): IoHelper;
+    private readonly ioHost;
+    private readonly action;
+    private constructor();
+    /**
+     * Forward a message to the IoHost, while injection the current action
+     */
+    notify(msg: ActionLessMessage<unknown>): Promise<void>;
+    /**
+     * Forward a request to the IoHost, while injection the current action
+     */
+    requestResponse<T, U>(msg: ActionLessRequest<T, U>): Promise<U>;
+    /**
+     * Create a new marker from a given registry entry
+     */
+    span<S extends object, E extends SpanEnd>(definition: SpanDefinition<S, E>): SpanMaker<S, E>;
+}
+/**
+ * Wraps an IoHost and creates an IoHelper from it
+ */
+export declare function asIoHelper(ioHost: IIoHost, action: ToolkitAction): IoHelper;

package/lib/api/io/private/io-helper.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IoHelper = void 0;
+exports.asIoHelper = asIoHelper;
+const span_1 = require("./span");
+/**
+ * A class containing helper tools to interact with IoHost
+ */
+class IoHelper {
+    static fromIoHost(ioHost, action) {
+        return new IoHelper(ioHost, action);
+    }
+    ioHost;
+    action;
+    constructor(ioHost, action) {
+        this.ioHost = ioHost;
+        this.action = action;
+    }
+    /**
+     * Forward a message to the IoHost, while injection the current action
+     */
+    notify(msg) {
+        return this.ioHost.notify({
+            ...msg,
+            action: this.action,
+        });
+    }
+    /**
+     * Forward a request to the IoHost, while injection the current action
+     */
+    requestResponse(msg) {
+        return this.ioHost.requestResponse({
+            ...msg,
+            action: this.action,
+        });
+    }
+    /**
+     * Create a new marker from a given registry entry
+     */
+    span(definition) {
+        return new span_1.SpanMaker(this, definition);
+    }
+}
+exports.IoHelper = IoHelper;
+/**
+ * Wraps an IoHost and creates an IoHelper from it
+ */
+function asIoHelper(ioHost, action) {
+    return IoHelper.fromIoHost(ioHost, action);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW8taGVscGVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiaW8taGVscGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQXdEQSxnQ0FFQztBQXRERCxpQ0FBbUM7QUFLbkM7O0dBRUc7QUFDSCxNQUFhLFFBQVE7SUFDWixNQUFNLENBQUMsVUFBVSxDQUFDLE1BQWUsRUFBRSxNQUFxQjtRQUM3RCxPQUFPLElBQUksUUFBUSxDQUFDLE1BQU0sRUFBRSxNQUFNLENBQUMsQ0FBQztJQUN0QyxDQUFDO0lBRWdCLE1BQU0sQ0FBVTtJQUNoQixNQUFNLENBQWdCO0lBRXZDLFlBQW9CLE1BQWUsRUFBRSxNQUFxQjtRQUN4RCxJQUFJLENBQUMsTUFBTSxHQUFHLE1BQU0sQ0FBQztRQUNyQixJQUFJLENBQUMsTUFBTSxHQUFHLE1BQU0sQ0FBQztJQUN2QixDQUFDO0lBRUQ7O09BRUc7SUFDSSxNQUFNLENBQUMsR0FBK0I7UUFDM0MsT0FBTyxJQUFJLENBQUMsTUFBTSxDQUFDLE1BQU0sQ0FBQztZQUN4QixHQUFHLEdBQUc7WUFDTixNQUFNLEVBQUUsSUFBSSxDQUFDLE1BQU07U0FDcEIsQ0FBQyxDQUFDO0lBQ0wsQ0FBQztJQUVEOztPQUVHO0lBQ0ksZUFBZSxDQUFPLEdBQTRCO1FBQ3ZELE9BQU8sSUFBSSxDQUFDLE1BQU0sQ0FBQyxlQUFlLENBQUM7WUFDakMsR0FBRyxHQUFHO1lBQ04sTUFBTSxFQUFFLElBQUksQ0FBQyxNQUFNO1NBQ3BCLENBQUMsQ0FBQztJQUNMLENBQUM7SUFFRDs7T0FFRztJQUNJLElBQUksQ0FBc0MsVUFBZ0M7UUFDL0UsT0FBTyxJQUFJLGdCQUFTLENBQUMsSUFBSSxFQUFFLFVBQVUsQ0FBQyxDQUFDO0lBQ3pDLENBQUM7Q0FDRjtBQXZDRCw0QkF1Q0M7QUFFRDs7R0FFRztBQUNILFNBQWdCLFVBQVUsQ0FBQyxNQUFlLEVBQUUsTUFBcUI7SUFDL0QsT0FBTyxRQUFRLENBQUMsVUFBVSxDQUFDLE1BQU0sRUFBRSxNQUFNLENBQUMsQ0FBQztBQUM3QyxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHR5cGUgeyBJSW9Ib3N0IH0gZnJvbSAnLi4vaW8taG9zdCc7XG5pbXBvcnQgdHlwZSB7IElvTWVzc2FnZSwgSW9SZXF1ZXN0IH0gZnJvbSAnLi4vaW8tbWVzc2FnZSc7XG5pbXBvcnQgdHlwZSB7IFRvb2xraXRBY3Rpb24gfSBmcm9tICcuLi90b29sa2l0LWFjdGlvbic7XG5pbXBvcnQgdHlwZSB7IFNwYW5FbmQsIFNwYW5EZWZpbml0aW9uIH0gZnJvbSAnLi9zcGFuJztcbmltcG9ydCB7IFNwYW5NYWtlciB9IGZyb20gJy4vc3Bhbic7XG5cbmV4cG9ydCB0eXBlIEFjdGlvbkxlc3NNZXNzYWdlPFQ+ID0gT21pdDxJb01lc3NhZ2U8VD4sICdhY3Rpb24nPjtcbmV4cG9ydCB0eXBlIEFjdGlvbkxlc3NSZXF1ZXN0PFQsIFU+ID0gT21pdDxJb1JlcXVlc3Q8VCwgVT4sICdhY3Rpb24nPjtcblxuLyoqXG4gKiBBIGNsYXNzIGNvbnRhaW5pbmcgaGVscGVyIHRvb2xzIHRvIGludGVyYWN0IHdpdGggSW9Ib3N0XG4gKi9cbmV4cG9ydCBjbGFzcyBJb0hlbHBlciBpbXBsZW1lbnRzIElJb0hvc3Qge1xuICBwdWJsaWMgc3RhdGljIGZyb21Jb0hvc3QoaW9Ib3N0OiBJSW9Ib3N0LCBhY3Rpb246IFRvb2xraXRBY3Rpb24pIHtcbiAgICByZXR1cm4gbmV3IElvSGVscGVyKGlvSG9zdCwgYWN0aW9uKTtcbiAgfVxuXG4gIHByaXZhdGUgcmVhZG9ubHkgaW9Ib3N0OiBJSW9Ib3N0O1xuICBwcml2YXRlIHJlYWRvbmx5IGFjdGlvbjogVG9vbGtpdEFjdGlvbjtcblxuICBwcml2YXRlIGNvbnN0cnVjdG9yKGlvSG9zdDogSUlvSG9zdCwgYWN0aW9uOiBUb29sa2l0QWN0aW9uKSB7XG4gICAgdGhpcy5pb0hvc3QgPSBpb0hvc3Q7XG4gICAgdGhpcy5hY3Rpb24gPSBhY3Rpb247XG4gIH1cblxuICAvKipcbiAgICogRm9yd2FyZCBhIG1lc3NhZ2UgdG8gdGhlIElvSG9zdCwgd2hpbGUgaW5qZWN0aW9uIHRoZSBjdXJyZW50IGFjdGlvblxuICAgKi9cbiAgcHVibGljIG5vdGlmeShtc2c6IEFjdGlvbkxlc3NNZXNzYWdlPHVua25vd24+KTogUHJvbWlzZTx2b2lkPiB7XG4gICAgcmV0dXJuIHRoaXMuaW9Ib3N0Lm5vdGlmeSh7XG4gICAgICAuLi5tc2csXG4gICAgICBhY3Rpb246IHRoaXMuYWN0aW9uLFxuICAgIH0pO1xuICB9XG5cbiAgLyoqXG4gICAqIEZvcndhcmQgYSByZXF1ZXN0IHRvIHRoZSBJb0hvc3QsIHdoaWxlIGluamVjdGlvbiB0aGUgY3VycmVudCBhY3Rpb25cbiAgICovXG4gIHB1YmxpYyByZXF1ZXN0UmVzcG9uc2U8VCwgVT4obXNnOiBBY3Rpb25MZXNzUmVxdWVzdDxULCBVPik6IFByb21pc2U8VT4ge1xuICAgIHJldHVybiB0aGlzLmlvSG9zdC5yZXF1ZXN0UmVzcG9uc2Uoe1xuICAgICAgLi4ubXNnLFxuICAgICAgYWN0aW9uOiB0aGlzLmFjdGlvbixcbiAgICB9KTtcbiAgfVxuXG4gIC8qKlxuICAgKiBDcmVhdGUgYSBuZXcgbWFya2VyIGZyb20gYSBnaXZlbiByZWdpc3RyeSBlbnRyeVxuICAgKi9cbiAgcHVibGljIHNwYW48UyBleHRlbmRzIG9iamVjdCwgRSBleHRlbmRzIFNwYW5FbmQ+KGRlZmluaXRpb246IFNwYW5EZWZpbml0aW9uPFMsIEU+KSB7XG4gICAgcmV0dXJuIG5ldyBTcGFuTWFrZXIodGhpcywgZGVmaW5pdGlvbik7XG4gIH1cbn1cblxuLyoqXG4gKiBXcmFwcyBhbiBJb0hvc3QgYW5kIGNyZWF0ZXMgYW4gSW9IZWxwZXIgZnJvbSBpdFxuICovXG5leHBvcnQgZnVuY3Rpb24gYXNJb0hlbHBlcihpb0hvc3Q6IElJb0hvc3QsIGFjdGlvbjogVG9vbGtpdEFjdGlvbik6IElvSGVscGVyIHtcbiAgcmV0dXJuIElvSGVscGVyLmZyb21Jb0hvc3QoaW9Ib3N0LCBhY3Rpb24pO1xufVxuIl19

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

@@ -0,0 +1,11 @@
+import type { IoMessageLevel } from '../';
+/**
+ * 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,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibGV2ZWwtcHJpb3JpdHkuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJsZXZlbC1wcmlvcml0eS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQThCQSw4REFFQztBQTlCRDs7OztHQUlHO0FBQ0gsTUFBTSxNQUFNLEdBQUc7SUFDYixPQUFPO0lBQ1AsT0FBTztJQUNQLE1BQU07SUFDTixNQUFNO0lBQ04sUUFBUTtJQUNSLE9BQU87Q0FDQyxDQUFDO0FBRVgsd0JBQXdCO0FBQ3hCLHNEQUFzRDtBQUN0RCxNQUFNLGFBQWEsR0FBMEMsTUFBTSxDQUFDLFdBQVcsQ0FBQyxNQUFNLENBQUMsT0FBTyxDQUFDLE1BQU0sQ0FBQyxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsQ0FBQyxPQUFPLEVBQUUsQ0FBQyxDQUFDLENBQUM7QUFDOUgsU0FBUyxTQUFTLENBQUMsQ0FBaUIsRUFBRSxDQUFpQjtJQUNyRCxPQUFPLGFBQWEsQ0FBQyxDQUFDLENBQUMsR0FBRyxhQUFhLENBQUMsQ0FBQyxDQUFDLENBQUM7QUFDN0MsQ0FBQztBQUVEOzs7Ozs7R0FNRztBQUNILFNBQWdCLHlCQUF5QixDQUFDLEdBQTZCLEVBQUUsS0FBcUI7SUFDNUYsT0FBTyxTQUFTLENBQUMsR0FBRyxDQUFDLEtBQUssRUFBRSxLQUFLLENBQUMsSUFBSSxDQUFDLENBQUM7QUFDMUMsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB0eXBlIHsgSW9NZXNzYWdlTGV2ZWwgfSBmcm9tICcuLi8nO1xuXG4vKipcbiAqIEtlZXAgdGhpcyBsaXN0IG9yZGVyZWQgZnJvbSBtb3N0IHRvIGxlYXN0IHZlcmJvc2UuXG4gKiBFdmVyeSBsZXZlbCBcImluY2x1ZGVzXCIgYWxsIG9mIHRoZSBsZXZlbHMgYmVsb3cgaXQuXG4gKiBUaGlzIGlzIHVzZWQgdG8gY29tcGFyZSBsZXZlbHMgb2YgbWVzc2FnZXMgdG8gZGV0ZXJtaW5lIHdoYXQgc2hvdWxkIGJlIGxvZ2dlZC5cbiAqL1xuY29uc3QgbGV2ZWxzID0gW1xuICAndHJhY2UnLFxuICAnZGVidWcnLFxuICAnaW5mbycsXG4gICd3YXJuJyxcbiAgJ3Jlc3VsdCcsXG4gICdlcnJvcicsXG5dIGFzIGNvbnN0O1xuXG4vLyBjb21wYXJlIGxldmVscyBoZWxwZXJcbi8vIGhlbHBlciB0byBjb252ZXJ0IHRoZSBhcnJheSBpbnRvIGEgbWFwIHdpdGggbnVtYmVyc1xuY29uc3Qgb3JkZXJlZExldmVsczogUmVjb3JkPHR5cGVvZiBsZXZlbHNbbnVtYmVyXSwgbnVtYmVyPiA9IE9iamVjdC5mcm9tRW50cmllcyhPYmplY3QuZW50cmllcyhsZXZlbHMpLm1hcChhID0+IGEucmV2ZXJzZSgpKSk7XG5mdW5jdGlvbiBjb21wYXJlRm4oYTogSW9NZXNzYWdlTGV2ZWwsIGI6IElvTWVzc2FnZUxldmVsKTogbnVtYmVyIHtcbiAgcmV0dXJuIG9yZGVyZWRMZXZlbHNbYV0gLSBvcmRlcmVkTGV2ZWxzW2JdO1xufVxuXG4vKipcbiAqIERldGVybWluZXMgaWYgYSBtZXNzYWdlIGlzIHJlbGV2YW50IGZvciB0aGUgZ2l2ZW4gbG9nIGxldmVsLlxuICpcbiAqIEBwYXJhbSBtc2cgVGhlIG1lc3NhZ2UgdG8gY29tcGFyZS5cbiAqIEBwYXJhbSBsZXZlbCBUaGUgbGV2ZWwgdG8gY29tcGFyZSBhZ2FpbnN0LlxuICogQHJldHVybnMgdHJ1ZSBpZiB0aGUgbWVzc2FnZSBpcyByZWxldmFudCBmb3IgdGhlIGdpdmVuIGxldmVsLlxuICovXG5leHBvcnQgZnVuY3Rpb24gaXNNZXNzYWdlUmVsZXZhbnRGb3JMZXZlbChtc2c6IHsgbGV2ZWw6IElvTWVzc2FnZUxldmVsfSwgbGV2ZWw6IElvTWVzc2FnZUxldmVsKTogYm9vbGVhbiB7XG4gIHJldHVybiBjb21wYXJlRm4obXNnLmxldmVsLCBsZXZlbCkgPj0gMDtcbn1cblxuIl19

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

@@ -0,0 +1,89 @@
+import type { IoMessage, IoMessageCode, IoMessageLevel } from '../io-message';
+import type { ActionLessMessage, ActionLessRequest } from './io-helper';
+/**
+ * Information for each IO Message Code.
+ */
+interface CodeInfo {
+    /**
+     * The message code.
+     */
+    readonly code: IoMessageCode;
+    /**
+     * A brief description of the meaning of this IO Message.
+     */
+    readonly description: string;
+    /**
+     * The name of the payload interface, if applicable.
+     * Some Io Messages include a payload, with a specific interface. The name of
+     * the interface is specified here so that it can be linked with the message
+     * when documentation is generated.
+     *
+     * The interface _must_ be exposed directly from toolkit-lib, so that it will
+     * have a documentation page generated (that can be linked to).
+     */
+    readonly interface?: string;
+}
+/**
+ * Information for each IO Message
+ */
+interface MessageInfo extends CodeInfo {
+    /**
+     * The message level
+     */
+    readonly level: IoMessageLevel;
+}
+/**
+ * An interface that can produce messages for a specific code.
+ */
+export interface IoMessageMaker<T> extends MessageInfo {
+    /**
+     * Create a message for this code, with or without payload.
+     */
+    msg: [T] extends [AbsentData] ? (message: string) => ActionLessMessage<AbsentData> : (message: string, data: T) => ActionLessMessage<T>;
+    /**
+     * Returns whether the given `IoMessage` instance matches the current message definition
+     */
+    is(x: IoMessage<unknown>): x is IoMessage<T>;
+}
+/**
+ * A type that is impossible for a user to replicate
+ * This is used to ensure that results always have a proper type generic declared.
+ */
+declare const privateKey: unique symbol;
+export type ImpossibleType = {
+    readonly [privateKey]: typeof privateKey;
+};
+type CodeInfoMaybeInterface<T> = [T] extends [AbsentData] ? Omit<CodeInfo, 'interface'> : Required<CodeInfo>;
+/**
+ * The type we use to represent an absent data field
+ *
+ * This is here to make it easy to change between `undefined`, `void`
+ * and `never`.
+ *
+ * Not a lot of difference between `undefined` and `void`, but `void`
+ * reads better.
+ */
+type AbsentData = void;
+export declare const trace: <T = void>(details: CodeInfoMaybeInterface<T>) => IoMessageMaker<T>;
+export declare const debug: <T = void>(details: CodeInfoMaybeInterface<T>) => IoMessageMaker<T>;
+export declare const info: <T = void>(details: CodeInfoMaybeInterface<T>) => IoMessageMaker<T>;
+export declare const warn: <T = void>(details: CodeInfoMaybeInterface<T>) => IoMessageMaker<T>;
+export declare const error: <T = void>(details: CodeInfoMaybeInterface<T>) => IoMessageMaker<T>;
+export declare const result: <T extends object = ImpossibleType>(details: Required<CodeInfo>) => IoMessageMaker<T>;
+interface RequestInfo<U> extends CodeInfo {
+    readonly defaultResponse: U;
+}
+/**
+ * An interface that can produce requests for a specific code.
+ */
+export interface IoRequestMaker<T, U> extends MessageInfo {
+    /**
+     * Create a message for this code, with or without payload.
+     */
+    req: [T] extends [AbsentData] ? (message: string) => ActionLessMessage<AbsentData> : (message: string, data: T) => ActionLessRequest<T, U>;
+}
+/**
+ * A request that is a simple yes/no question, with the expectation that 'yes' is the default.
+ */
+export declare const confirm: <T extends object = ImpossibleType>(details: Required<Omit<RequestInfo<boolean>, "defaultResponse">>) => IoRequestMaker<T, boolean>;
+export {};

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

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.confirm = exports.result = exports.error = exports.warn = exports.info = exports.debug = exports.trace = void 0;
+/**
+ * Produce an IoMessageMaker for the provided level and code info.
+ */
+function message(level, details) {
+    const maker = (text, data) => ({
+        time: new Date(),
+        level,
+        code: details.code,
+        message: text,
+        data,
+    });
+    return {
+        ...details,
+        level,
+        msg: maker,
+        is: (m) => m.code === details.code,
+    };
+}
+const trace = (details) => message('trace', details);
+exports.trace = trace;
+const debug = (details) => message('debug', details);
+exports.debug = debug;
+const info = (details) => message('info', details);
+exports.info = info;
+const warn = (details) => message('warn', details);
+exports.warn = warn;
+const error = (details) => message('error', details);
+exports.error = error;
+const result = (details) => message('result', details);
+exports.result = result;
+/**
+ * Produce an IoRequestMaker for the provided level and request info.
+ */
+function request(level, details) {
+    const maker = (text, data) => ({
+        time: new Date(),
+        level,
+        code: details.code,
+        message: text,
+        data,
+        defaultResponse: details.defaultResponse,
+    });
+    return {
+        ...details,
+        level,
+        req: maker,
+    };
+}
+/**
+ * A request that is a simple yes/no question, with the expectation that 'yes' is the default.
+ */
+const confirm = (details) => request('info', {
+    ...details,
+    defaultResponse: true,
+});
+exports.confirm = confirm;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibWVzc2FnZS1tYWtlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIm1lc3NhZ2UtbWFrZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBc0RBOztHQUVHO0FBQ0gsU0FBUyxPQUFPLENBQWlCLEtBQXFCLEVBQUUsT0FBaUI7SUFDdkUsTUFBTSxLQUFLLEdBQUcsQ0FBQyxJQUFZLEVBQUUsSUFBTyxFQUFFLEVBQUUsQ0FBQyxDQUFDO1FBQ3hDLElBQUksRUFBRSxJQUFJLElBQUksRUFBRTtRQUNoQixLQUFLO1FBQ0wsSUFBSSxFQUFFLE9BQU8sQ0FBQyxJQUFJO1FBQ2xCLE9BQU8sRUFBRSxJQUFJO1FBQ2IsSUFBSTtLQUNvQixDQUFBLENBQUM7SUFFM0IsT0FBTztRQUNMLEdBQUcsT0FBTztRQUNWLEtBQUs7UUFDTCxHQUFHLEVBQUUsS0FBWTtRQUNqQixFQUFFLEVBQUUsQ0FBQyxDQUFDLEVBQXFCLEVBQUUsQ0FBQyxDQUFDLENBQUMsSUFBSSxLQUFLLE9BQU8sQ0FBQyxJQUFJO0tBQ3RELENBQUM7QUFDSixDQUFDO0FBeUJNLE1BQU0sS0FBSyxHQUFHLENBQWlCLE9BQWtDLEVBQUUsRUFBRSxDQUFDLE9BQU8sQ0FBSSxPQUFPLEVBQUUsT0FBTyxDQUFDLENBQUM7QUFBN0YsUUFBQSxLQUFLLFNBQXdGO0FBQ25HLE1BQU0sS0FBSyxHQUFHLENBQWlCLE9BQWtDLEVBQUUsRUFBRSxDQUFDLE9BQU8sQ0FBSSxPQUFPLEVBQUUsT0FBTyxDQUFDLENBQUM7QUFBN0YsUUFBQSxLQUFLLFNBQXdGO0FBQ25HLE1BQU0sSUFBSSxHQUFHLENBQWlCLE9BQWtDLEVBQUUsRUFBRSxDQUFDLE9BQU8sQ0FBSSxNQUFNLEVBQUUsT0FBTyxDQUFDLENBQUM7QUFBM0YsUUFBQSxJQUFJLFFBQXVGO0FBQ2pHLE1BQU0sSUFBSSxHQUFHLENBQWlCLE9BQWtDLEVBQUUsRUFBRSxDQUFDLE9BQU8sQ0FBSSxNQUFNLEVBQUUsT0FBTyxDQUFDLENBQUM7QUFBM0YsUUFBQSxJQUFJLFFBQXVGO0FBQ2pHLE1BQU0sS0FBSyxHQUFHLENBQWlCLE9BQWtDLEVBQUUsRUFBRSxDQUFDLE9BQU8sQ0FBSSxPQUFPLEVBQUUsT0FBTyxDQUFDLENBQUM7QUFBN0YsUUFBQSxLQUFLLFNBQXdGO0FBQ25HLE1BQU0sTUFBTSxHQUFHLENBQW9DLE9BQTJCLEVBQUUsRUFBRSxDQUFDLE9BQU8sQ0FBSSxRQUFRLEVBQUUsT0FBTyxDQUFDLENBQUM7QUFBM0csUUFBQSxNQUFNLFVBQXFHO0FBZ0J4SDs7R0FFRztBQUNILFNBQVMsT0FBTyxDQUFxQyxLQUFxQixFQUFFLE9BQXVCO0lBQ2pHLE1BQU0sS0FBSyxHQUFHLENBQUMsSUFBWSxFQUFFLElBQU8sRUFBRSxFQUFFLENBQUMsQ0FBQztRQUN4QyxJQUFJLEVBQUUsSUFBSSxJQUFJLEVBQUU7UUFDaEIsS0FBSztRQUNMLElBQUksRUFBRSxPQUFPLENBQUMsSUFBSTtRQUNsQixPQUFPLEVBQUUsSUFBSTtRQUNiLElBQUk7UUFDSixlQUFlLEVBQUUsT0FBTyxDQUFDLGVBQWU7S0FDYixDQUFBLENBQUM7SUFFOUIsT0FBTztRQUNMLEdBQUcsT0FBTztRQUNWLEtBQUs7UUFDTCxHQUFHLEVBQUUsS0FBWTtLQUNsQixDQUFDO0FBQ0osQ0FBQztBQUVEOztHQUVHO0FBQ0ksTUFBTSxPQUFPLEdBQUcsQ0FBb0MsT0FBZ0UsRUFBRSxFQUFFLENBQUMsT0FBTyxDQUFhLE1BQU0sRUFBRTtJQUMxSixHQUFHLE9BQU87SUFDVixlQUFlLEVBQUUsSUFBSTtDQUN0QixDQUFDLENBQUM7QUFIVSxRQUFBLE9BQU8sV0FHakIiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgdHlwZSB7IElvTWVzc2FnZSwgSW9NZXNzYWdlQ29kZSwgSW9NZXNzYWdlTGV2ZWwgfSBmcm9tICcuLi9pby1tZXNzYWdlJztcbmltcG9ydCB0eXBlIHsgQWN0aW9uTGVzc01lc3NhZ2UsIEFjdGlvbkxlc3NSZXF1ZXN0IH0gZnJvbSAnLi9pby1oZWxwZXInO1xuXG4vKipcbiAqIEluZm9ybWF0aW9uIGZvciBlYWNoIElPIE1lc3NhZ2UgQ29kZS5cbiAqL1xuaW50ZXJmYWNlIENvZGVJbmZvIHtcbiAgLyoqXG4gICAqIFRoZSBtZXNzYWdlIGNvZGUuXG4gICAqL1xuICByZWFkb25seSBjb2RlOiBJb01lc3NhZ2VDb2RlO1xuXG4gIC8qKlxuICAgKiBBIGJyaWVmIGRlc2NyaXB0aW9uIG9mIHRoZSBtZWFuaW5nIG9mIHRoaXMgSU8gTWVzc2FnZS5cbiAgICovXG4gIHJlYWRvbmx5IGRlc2NyaXB0aW9uOiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFRoZSBuYW1lIG9mIHRoZSBwYXlsb2FkIGludGVyZmFjZSwgaWYgYXBwbGljYWJsZS5cbiAgICogU29tZSBJbyBNZXNzYWdlcyBpbmNsdWRlIGEgcGF5bG9hZCwgd2l0aCBhIHNwZWNpZmljIGludGVyZmFjZS4gVGhlIG5hbWUgb2ZcbiAgICogdGhlIGludGVyZmFjZSBpcyBzcGVjaWZpZWQgaGVyZSBzbyB0aGF0IGl0IGNhbiBiZSBsaW5rZWQgd2l0aCB0aGUgbWVzc2FnZVxuICAgKiB3aGVuIGRvY3VtZW50YXRpb24gaXMgZ2VuZXJhdGVkLlxuICAgKlxuICAgKiBUaGUgaW50ZXJmYWNlIF9tdXN0XyBiZSBleHBvc2VkIGRpcmVjdGx5IGZyb20gdG9vbGtpdC1saWIsIHNvIHRoYXQgaXQgd2lsbFxuICAgKiBoYXZlIGEgZG9jdW1lbnRhdGlvbiBwYWdlIGdlbmVyYXRlZCAodGhhdCBjYW4gYmUgbGlua2VkIHRvKS5cbiAgICovXG4gIHJlYWRvbmx5IGludGVyZmFjZT86IHN0cmluZztcbn1cblxuLyoqXG4gKiBJbmZvcm1hdGlvbiBmb3IgZWFjaCBJTyBNZXNzYWdlXG4gKi9cbmludGVyZmFjZSBNZXNzYWdlSW5mbyBleHRlbmRzIENvZGVJbmZvIHtcbiAgLyoqXG4gICAqIFRoZSBtZXNzYWdlIGxldmVsXG4gICAqL1xuICByZWFkb25seSBsZXZlbDogSW9NZXNzYWdlTGV2ZWw7XG59XG5cbi8qKlxuICogQW4gaW50ZXJmYWNlIHRoYXQgY2FuIHByb2R1Y2UgbWVzc2FnZXMgZm9yIGEgc3BlY2lmaWMgY29kZS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBJb01lc3NhZ2VNYWtlcjxUPiBleHRlbmRzIE1lc3NhZ2VJbmZvIHtcbiAgLyoqXG4gICAqIENyZWF0ZSBhIG1lc3NhZ2UgZm9yIHRoaXMgY29kZSwgd2l0aCBvciB3aXRob3V0IHBheWxvYWQuXG4gICAqL1xuICBtc2c6IFtUXSBleHRlbmRzIFtBYnNlbnREYXRhXSA/IChtZXNzYWdlOiBzdHJpbmcpID0+IEFjdGlvbkxlc3NNZXNzYWdlPEFic2VudERhdGE+IDogKG1lc3NhZ2U6IHN0cmluZywgZGF0YTogVCkgPT4gQWN0aW9uTGVzc01lc3NhZ2U8VD47XG5cbiAgLyoqXG4gICAqIFJldHVybnMgd2hldGhlciB0aGUgZ2l2ZW4gYElvTWVzc2FnZWAgaW5zdGFuY2UgbWF0Y2hlcyB0aGUgY3VycmVudCBtZXNzYWdlIGRlZmluaXRpb25cbiAgICovXG4gIGlzKHg6IElvTWVzc2FnZTx1bmtub3duPik6IHggaXMgSW9NZXNzYWdlPFQ+O1xufVxuXG4vKipcbiAqIFByb2R1Y2UgYW4gSW9NZXNzYWdlTWFrZXIgZm9yIHRoZSBwcm92aWRlZCBsZXZlbCBhbmQgY29kZSBpbmZvLlxuICovXG5mdW5jdGlvbiBtZXNzYWdlPFQgPSBBYnNlbnREYXRhPihsZXZlbDogSW9NZXNzYWdlTGV2ZWwsIGRldGFpbHM6IENvZGVJbmZvKTogSW9NZXNzYWdlTWFrZXI8VD4ge1xuICBjb25zdCBtYWtlciA9ICh0ZXh0OiBzdHJpbmcsIGRhdGE6IFQpID0+ICh7XG4gICAgdGltZTogbmV3IERhdGUoKSxcbiAgICBsZXZlbCxcbiAgICBjb2RlOiBkZXRhaWxzLmNvZGUsXG4gICAgbWVzc2FnZTogdGV4dCxcbiAgICBkYXRhLFxuICB9IGFzIEFjdGlvbkxlc3NNZXNzYWdlPFQ+KTtcblxuICByZXR1cm4ge1xuICAgIC4uLmRldGFpbHMsXG4gICAgbGV2ZWwsXG4gICAgbXNnOiBtYWtlciBhcyBhbnksXG4gICAgaXM6IChtKTogbSBpcyBJb01lc3NhZ2U8VD4gPT4gbS5jb2RlID09PSBkZXRhaWxzLmNvZGUsXG4gIH07XG59XG5cbi8qKlxuICogQSB0eXBlIHRoYXQgaXMgaW1wb3NzaWJsZSBmb3IgYSB1c2VyIHRvIHJlcGxpY2F0ZVxuICogVGhpcyBpcyB1c2VkIHRvIGVuc3VyZSB0aGF0IHJlc3VsdHMgYWx3YXlzIGhhdmUgYSBwcm9wZXIgdHlwZSBnZW5lcmljIGRlY2xhcmVkLlxuICovXG5kZWNsYXJlIGNvbnN0IHByaXZhdGVLZXk6IHVuaXF1ZSBzeW1ib2w7XG5leHBvcnQgdHlwZSBJbXBvc3NpYmxlVHlwZSA9IHtcbiAgcmVhZG9ubHkgW3ByaXZhdGVLZXldOiB0eXBlb2YgcHJpdmF0ZUtleTtcbn07XG5cbi8vIENyZWF0ZSBgSW9NZXNzYWdlTWFrZXJgcyBmb3IgYSBnaXZlbiBsZXZlbCBhbmQgdHlwZSBjaGVjayB0aGF0IGNhbGxzIHdpdGggcGF5bG9hZCBhcmUgdXNpbmcgdGhlIGNvcnJlY3QgaW50ZXJmYWNlXG50eXBlIENvZGVJbmZvTWF5YmVJbnRlcmZhY2U8VD4gPSBbVF0gZXh0ZW5kcyBbQWJzZW50RGF0YV0gPyBPbWl0PENvZGVJbmZvLCAnaW50ZXJmYWNlJz4gOiBSZXF1aXJlZDxDb2RlSW5mbz47XG5cbi8qKlxuICogVGhlIHR5cGUgd2UgdXNlIHRvIHJlcHJlc2VudCBhbiBhYnNlbnQgZGF0YSBmaWVsZFxuICpcbiAqIFRoaXMgaXMgaGVyZSB0byBtYWtlIGl0IGVhc3kgdG8gY2hhbmdlIGJldHdlZW4gYHVuZGVmaW5lZGAsIGB2b2lkYFxuICogYW5kIGBuZXZlcmAuXG4gKlxuICogTm90IGEgbG90IG9mIGRpZmZlcmVuY2UgYmV0d2VlbiBgdW5kZWZpbmVkYCBhbmQgYHZvaWRgLCBidXQgYHZvaWRgXG4gKiByZWFkcyBiZXR0ZXIuXG4gKi9cbnR5cGUgQWJzZW50RGF0YSA9IHZvaWQ7XG5cbmV4cG9ydCBjb25zdCB0cmFjZSA9IDxUID0gQWJzZW50RGF0YT4oZGV0YWlsczogQ29kZUluZm9NYXliZUludGVyZmFjZTxUPikgPT4gbWVzc2FnZTxUPigndHJhY2UnLCBkZXRhaWxzKTtcbmV4cG9ydCBjb25zdCBkZWJ1ZyA9IDxUID0gQWJzZW50RGF0YT4oZGV0YWlsczogQ29kZUluZm9NYXliZUludGVyZmFjZTxUPikgPT4gbWVzc2FnZTxUPignZGVidWcnLCBkZXRhaWxzKTtcbmV4cG9ydCBjb25zdCBpbmZvID0gPFQgPSBBYnNlbnREYXRhPihkZXRhaWxzOiBDb2RlSW5mb01heWJlSW50ZXJmYWNlPFQ+KSA9PiBtZXNzYWdlPFQ+KCdpbmZvJywgZGV0YWlscyk7XG5leHBvcnQgY29uc3Qgd2FybiA9IDxUID0gQWJzZW50RGF0YT4oZGV0YWlsczogQ29kZUluZm9NYXliZUludGVyZmFjZTxUPikgPT4gbWVzc2FnZTxUPignd2FybicsIGRldGFpbHMpO1xuZXhwb3J0IGNvbnN0IGVycm9yID0gPFQgPSBBYnNlbnREYXRhPihkZXRhaWxzOiBDb2RlSW5mb01heWJlSW50ZXJmYWNlPFQ+KSA9PiBtZXNzYWdlPFQ+KCdlcnJvcicsIGRldGFpbHMpO1xuZXhwb3J0IGNvbnN0IHJlc3VsdCA9IDxUIGV4dGVuZHMgb2JqZWN0ID0gSW1wb3NzaWJsZVR5cGU+KGRldGFpbHM6IFJlcXVpcmVkPENvZGVJbmZvPikgPT4gbWVzc2FnZTxUPigncmVzdWx0JywgZGV0YWlscyk7XG5cbmludGVyZmFjZSBSZXF1ZXN0SW5mbzxVPiBleHRlbmRzIENvZGVJbmZvIHtcbiAgcmVhZG9ubHkgZGVmYXVsdFJlc3BvbnNlOiBVO1xufVxuXG4vKipcbiAqIEFuIGludGVyZmFjZSB0aGF0IGNhbiBwcm9kdWNlIHJlcXVlc3RzIGZvciBhIHNwZWNpZmljIGNvZGUuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgSW9SZXF1ZXN0TWFrZXI8VCwgVT4gZXh0ZW5kcyBNZXNzYWdlSW5mbyB7XG4gIC8qKlxuICAgKiBDcmVhdGUgYSBtZXNzYWdlIGZvciB0aGlzIGNvZGUsIHdpdGggb3Igd2l0aG91dCBwYXlsb2FkLlxuICAgKi9cbiAgcmVxOiBbVF0gZXh0ZW5kcyBbQWJzZW50RGF0YV0gPyAobWVzc2FnZTogc3RyaW5nKSA9PiBBY3Rpb25MZXNzTWVzc2FnZTxBYnNlbnREYXRhPiA6IChtZXNzYWdlOiBzdHJpbmcsIGRhdGE6IFQpID0+IEFjdGlvbkxlc3NSZXF1ZXN0PFQsIFU+O1xufVxuXG4vKipcbiAqIFByb2R1Y2UgYW4gSW9SZXF1ZXN0TWFrZXIgZm9yIHRoZSBwcm92aWRlZCBsZXZlbCBhbmQgcmVxdWVzdCBpbmZvLlxuICovXG5mdW5jdGlvbiByZXF1ZXN0PFQgPSBBYnNlbnREYXRhLCBVID0gSW1wb3NzaWJsZVR5cGU+KGxldmVsOiBJb01lc3NhZ2VMZXZlbCwgZGV0YWlsczogUmVxdWVzdEluZm88VT4pOiBJb1JlcXVlc3RNYWtlcjxULCBVPiB7XG4gIGNvbnN0IG1ha2VyID0gKHRleHQ6IHN0cmluZywgZGF0YTogVCkgPT4gKHtcbiAgICB0aW1lOiBuZXcgRGF0ZSgpLFxuICAgIGxldmVsLFxuICAgIGNvZGU6IGRldGFpbHMuY29kZSxcbiAgICBtZXNzYWdlOiB0ZXh0LFxuICAgIGRhdGEsXG4gICAgZGVmYXVsdFJlc3BvbnNlOiBkZXRhaWxzLmRlZmF1bHRSZXNwb25zZSxcbiAgfSBhcyBBY3Rpb25MZXNzUmVxdWVzdDxULCBVPik7XG5cbiAgcmV0dXJuIHtcbiAgICAuLi5kZXRhaWxzLFxuICAgIGxldmVsLFxuICAgIHJlcTogbWFrZXIgYXMgYW55LFxuICB9O1xufVxuXG4vKipcbiAqIEEgcmVxdWVzdCB0aGF0IGlzIGEgc2ltcGxlIHllcy9ubyBxdWVzdGlvbiwgd2l0aCB0aGUgZXhwZWN0YXRpb24gdGhhdCAneWVzJyBpcyB0aGUgZGVmYXVsdC5cbiAqL1xuZXhwb3J0IGNvbnN0IGNvbmZpcm0gPSA8VCBleHRlbmRzIG9iamVjdCA9IEltcG9zc2libGVUeXBlPihkZXRhaWxzOiBSZXF1aXJlZDxPbWl0PFJlcXVlc3RJbmZvPGJvb2xlYW4+LCAnZGVmYXVsdFJlc3BvbnNlJz4+KSA9PiByZXF1ZXN0PFQsIGJvb2xlYW4+KCdpbmZvJywge1xuICAuLi5kZXRhaWxzLFxuICBkZWZhdWx0UmVzcG9uc2U6IHRydWUsXG59KTtcbiJdfQ==