@aws-cdk/toolkit-lib 0.1.8 → 0.2.0

package/lib/toolkit/types.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Result interface for toolkit.deploy operation
+ */
+export interface DeployResult {
+    /**
+     * Map of deployed stacks by artifact ID.
+     */
+    readonly stacks: DeployedStack[];
+}
+/**
+ * Properties that describe a physically deployed stack
+ */
+export interface PhysicalStack<Arn extends 'arnRequired' | 'arnOptional' = 'arnRequired'> {
+    /**
+     * The name of the stack
+     *
+     * A stack name is unique inside its environment, but not unique globally.
+     */
+    readonly stackName: string;
+    /**
+     * The environment of the stack
+     *
+     * This environment is always concrete, because even though the CDK app's
+     * stack may be region-agnostic, in order to be deployed it will have to have
+     * been specialized.
+     */
+    readonly environment: Environment;
+    /**
+     * The ARN of the stack
+     */
+    readonly stackArn: Arn extends 'arnOptional' ? string | undefined : string;
+}
+/**
+ * Information about a deployed stack
+ */
+export interface DeployedStack extends PhysicalStack {
+    /**
+     * Hierarchical identifier
+     *
+     * This uniquely identifies the stack inside the CDK app.
+     *
+     * In practice this will be the stack's construct path, but unfortunately the
+     * Cloud Assembly contract doesn't require or guarantee that.
+     */
+    readonly hierarchicalId: string;
+    /**
+     * The outputs of the deployed CloudFormation stack
+     */
+    readonly outputs: {
+        [key: string]: string;
+    };
+}
+/**
+ * An environment, which is an (account, region) pair
+ */
+export interface Environment {
+    /**
+     * The account number
+     */
+    readonly account: string;
+    /**
+     * The region number
+     */
+    readonly region: string;
+}
+/**
+ * Result interface for toolkit.deploy operation
+ */
+export interface DeployResult {
+    /**
+     * List of stacks deployed by this operation
+     */
+    readonly stacks: DeployedStack[];
+}
+/**
+ * Information about a deployed stack
+ */
+export interface DeployedStack extends PhysicalStack {
+    /**
+     * Hierarchical identifier
+     *
+     * This uniquely identifies the stack inside the CDK app.
+     *
+     * In practice this will be the stack's construct path, but unfortunately the
+     * Cloud Assembly contract doesn't require or guarantee that.
+     */
+    readonly hierarchicalId: string;
+    /**
+     * The outputs of the deployed CloudFormation stack
+     */
+    readonly outputs: {
+        [key: string]: string;
+    };
+}
+/**
+ * An environment, which is an (account, region) pair
+ */
+export interface Environment {
+    /**
+     * The account number
+     */
+    readonly account: string;
+    /**
+     * The region number
+     */
+    readonly region: string;
+}
+/**
+ * Result interface for toolkit.destroy operation
+ */
+export interface DestroyResult {
+    /**
+     * List of stacks destroyed by this operation
+     */
+    readonly stacks: DestroyedStack[];
+}
+/**
+ * A stack targeted by a destroy operation
+ */
+export interface DestroyedStack extends PhysicalStack<'arnOptional'> {
+    /**
+     * Whether the stack existed to begin with
+     *
+     * If `!stackExisted`, the stack didn't exist, wasn't deleted, and `stackArn`
+     * will be `undefined`.
+     */
+    readonly stackExisted: boolean;
+}
+/**
+ * Result interface for toolkit.rollback operation
+ */
+export interface RollbackResult {
+    /**
+     * List of stacks rolled back by this operation
+     */
+    readonly stacks: RolledBackStack[];
+}
+/**
+ * A stack targeted by a rollback operation
+ */
+export interface RolledBackStack extends PhysicalStack {
+    /**
+     * What operation we did for this stack
+     *
+     * Either: we did roll it back, or we didn't need to roll it back because
+     * it was already stable.
+     */
+    readonly result: StackRollbackResult;
+}
+/**
+ * An environment, which is an (account, region) pair
+ */
+export interface Environment {
+    /**
+     * The account number
+     */
+    readonly account: string;
+    /**
+     * The region number
+     */
+    readonly region: string;
+}
+export type StackRollbackResult = 'rolled-back' | 'already-stable';

package/lib/toolkit/types.js

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

package/lib/util/promises.d.ts

@@ -0,0 +1,12 @@
+/**
+ * A backport of Promiser.withResolvers
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/withResolvers
+ */
+export declare function promiseWithResolvers<A>(): PromiseAndResolvers<A>;
+interface PromiseAndResolvers<A> {
+    promise: Promise<A>;
+    resolve: (value: A) => void;
+    reject: (reason: any) => void;
+}
+export {};

package/lib/util/promises.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.promiseWithResolvers = promiseWithResolvers;
+/**
+ * A backport of Promiser.withResolvers
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/withResolvers
+ */
+function promiseWithResolvers() {
+    let resolve, reject;
+    const promise = new Promise((res, rej) => {
+        resolve = res;
+        reject = rej;
+    });
+    return { promise, resolve: resolve, reject: reject };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJvbWlzZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJwcm9taXNlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQUtBLG9EQU9DO0FBWkQ7Ozs7R0FJRztBQUNILFNBQWdCLG9CQUFvQjtJQUNsQyxJQUFJLE9BQTBDLEVBQUUsTUFBd0MsQ0FBQztJQUN6RixNQUFNLE9BQU8sR0FBRyxJQUFJLE9BQU8sQ0FBSSxDQUFDLEdBQUcsRUFBRSxHQUFHLEVBQUUsRUFBRTtRQUMxQyxPQUFPLEdBQUcsR0FBRyxDQUFDO1FBQ2QsTUFBTSxHQUFHLEdBQUcsQ0FBQztJQUNmLENBQUMsQ0FBQyxDQUFDO0lBQ0gsT0FBTyxFQUFFLE9BQU8sRUFBRSxPQUFPLEVBQUUsT0FBUSxFQUFFLE1BQU0sRUFBRSxNQUFPLEVBQUUsQ0FBQztBQUN6RCxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBBIGJhY2twb3J0IG9mIFByb21pc2VyLndpdGhSZXNvbHZlcnNcbiAqXG4gKiBAc2VlIGh0dHBzOi8vZGV2ZWxvcGVyLm1vemlsbGEub3JnL2VuLVVTL2RvY3MvV2ViL0phdmFTY3JpcHQvUmVmZXJlbmNlL0dsb2JhbF9PYmplY3RzL1Byb21pc2Uvd2l0aFJlc29sdmVyc1xuICovXG5leHBvcnQgZnVuY3Rpb24gcHJvbWlzZVdpdGhSZXNvbHZlcnM8QT4oKTogUHJvbWlzZUFuZFJlc29sdmVyczxBPiB7XG4gIGxldCByZXNvbHZlOiBQcm9taXNlQW5kUmVzb2x2ZXJzPEE+WydyZXNvbHZlJ10sIHJlamVjdDogUHJvbWlzZUFuZFJlc29sdmVyczxBPlsncmVqZWN0J107XG4gIGNvbnN0IHByb21pc2UgPSBuZXcgUHJvbWlzZTxBPigocmVzLCByZWopID0+IHtcbiAgICByZXNvbHZlID0gcmVzO1xuICAgIHJlamVjdCA9IHJlajtcbiAgfSk7XG4gIHJldHVybiB7IHByb21pc2UsIHJlc29sdmU6IHJlc29sdmUhLCByZWplY3Q6IHJlamVjdCEgfTtcbn1cblxuaW50ZXJmYWNlIFByb21pc2VBbmRSZXNvbHZlcnM8QT4ge1xuICBwcm9taXNlOiBQcm9taXNlPEE+O1xuICByZXNvbHZlOiAodmFsdWU6IEEpID0+IHZvaWQ7XG4gIHJlamVjdDogKHJlYXNvbjogYW55KSA9PiB2b2lkO1xufVxuIl19

package/lib/util/shell-env.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Returns true if the current process is running in a CI environment
+ * @returns true if the current process is running in a CI environment
+ */
+export declare function isCI(): boolean;
+/**
+ * Returns true if the current process is running in a TTY environment
+ * @returns true if the current process is running in a TTY environment
+ */
+export declare function isTTY(): boolean;

package/lib/util/shell-env.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isCI = isCI;
+exports.isTTY = isTTY;
+/**
+ * Returns true if the current process is running in a CI environment
+ * @returns true if the current process is running in a CI environment
+ */
+function isCI() {
+    return process.env.CI !== undefined && process.env.CI !== 'false' && process.env.CI !== '0';
+}
+/**
+ * Returns true if the current process is running in a TTY environment
+ * @returns true if the current process is running in a TTY environment
+ */
+function isTTY() {
+    return process.stdout.isTTY ?? false;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2hlbGwtZW52LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsic2hlbGwtZW52LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBSUEsb0JBRUM7QUFNRCxzQkFFQztBQWREOzs7R0FHRztBQUNILFNBQWdCLElBQUk7SUFDbEIsT0FBTyxPQUFPLENBQUMsR0FBRyxDQUFDLEVBQUUsS0FBSyxTQUFTLElBQUksT0FBTyxDQUFDLEdBQUcsQ0FBQyxFQUFFLEtBQUssT0FBTyxJQUFJLE9BQU8sQ0FBQyxHQUFHLENBQUMsRUFBRSxLQUFLLEdBQUcsQ0FBQztBQUM5RixDQUFDO0FBRUQ7OztHQUdHO0FBQ0gsU0FBZ0IsS0FBSztJQUNuQixPQUFPLE9BQU8sQ0FBQyxNQUFNLENBQUMsS0FBSyxJQUFJLEtBQUssQ0FBQztBQUN2QyxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBSZXR1cm5zIHRydWUgaWYgdGhlIGN1cnJlbnQgcHJvY2VzcyBpcyBydW5uaW5nIGluIGEgQ0kgZW52aXJvbm1lbnRcbiAqIEByZXR1cm5zIHRydWUgaWYgdGhlIGN1cnJlbnQgcHJvY2VzcyBpcyBydW5uaW5nIGluIGEgQ0kgZW52aXJvbm1lbnRcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGlzQ0koKTogYm9vbGVhbiB7XG4gIHJldHVybiBwcm9jZXNzLmVudi5DSSAhPT0gdW5kZWZpbmVkICYmIHByb2Nlc3MuZW52LkNJICE9PSAnZmFsc2UnICYmIHByb2Nlc3MuZW52LkNJICE9PSAnMCc7XG59XG5cbi8qKlxuICogUmV0dXJucyB0cnVlIGlmIHRoZSBjdXJyZW50IHByb2Nlc3MgaXMgcnVubmluZyBpbiBhIFRUWSBlbnZpcm9ubWVudFxuICogQHJldHVybnMgdHJ1ZSBpZiB0aGUgY3VycmVudCBwcm9jZXNzIGlzIHJ1bm5pbmcgaW4gYSBUVFkgZW52aXJvbm1lbnRcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGlzVFRZKCk6IGJvb2xlYW4ge1xuICByZXR1cm4gcHJvY2Vzcy5zdGRvdXQuaXNUVFkgPz8gZmFsc2U7XG59XG4iXX0=

package/package.json

@@ -7,6 +7,7 @@
     "directory": "packages/@aws-cdk/toolkit-lib"
   },
   "scripts": {
+    "api-extractor-docs": "npx projen api-extractor-docs",
     "build": "npx projen build",
     "bump": "npx projen bump",
     "check-for-updates": "npx projen check-for-updates",
@@ -34,8 +35,10 @@
     "organization": true
   },
   "devDependencies": {
+    "@aws-cdk/aws-service-spec": "^0.1.67",
     "@aws-cdk/tmp-toolkit-helpers": "0.0.0",
     "@cdklabs/eslint-plugin": "^1.3.2",
+    "@microsoft/api-extractor": "^7.52.3",
     "@smithy/types": "^4.2.0",
     "@stylistic/eslint-plugin": "^3",
     "@types/fs-extra": "^11.0.4",
@@ -44,12 +47,12 @@
     "@types/split2": "^4.2.3",
     "@typescript-eslint/eslint-plugin": "^8",
     "@typescript-eslint/parser": "^8",
-    "aws-cdk": "2.1007.0",
-    "aws-cdk-lib": "^2.186.0",
+    "aws-cdk-lib": "^2.187.0",
     "aws-sdk-client-mock": "^4.1.0",
+    "aws-sdk-client-mock-jest": "^4.1.0",
     "commit-and-tag-version": "^12",
     "constructs": "^10.0.0",
-    "dts-bundle-generator": "^9.5.1",
+    "dts-bundle-generator": "9.3.1",
     "esbuild": "^0.25.2",
     "eslint": "^9",
     "eslint-config-prettier": "^10.1.1",
@@ -57,21 +60,21 @@
     "eslint-plugin-import": "^2.31.0",
     "eslint-plugin-jest": "^28.11.0",
     "eslint-plugin-jsdoc": "^50.6.9",
-    "eslint-plugin-prettier": "^5.2.5",
+    "eslint-plugin-prettier": "^5.2.6",
     "jest": "^29.7.0",
     "jest-junit": "^16",
     "license-checker": "^25.0.1",
     "prettier": "^2.8",
-    "projen": "^0.91.18",
-    "ts-jest": "^29.3.0",
+    "projen": "^0.91.19",
+    "ts-jest": "^29.3.1",
     "typedoc": "^0.28.1",
     "typescript": "5.6"
   },
   "dependencies": {
-    "@aws-cdk/cloud-assembly-schema": "^43.0.0",
+    "@aws-cdk/cloud-assembly-schema": "^43.1.0",
     "@aws-cdk/cloudformation-diff": "^2.180.0",
-    "@aws-cdk/cx-api": "^2.186.0",
-    "@aws-cdk/region-info": "^2.186.0",
+    "@aws-cdk/cx-api": "^2.187.0",
+    "@aws-cdk/region-info": "^2.187.0",
     "@aws-sdk/client-appsync": "^3",
     "@aws-sdk/client-cloudcontrol": "^3",
     "@aws-sdk/client-cloudformation": "^3",
@@ -103,7 +106,7 @@
     "archiver": "^7.0.1",
     "camelcase": "^6",
     "cdk-assets": "^3.2.0",
-    "cdk-from-cfn": "^0.203.0",
+    "cdk-from-cfn": "^0.205.0",
     "chalk": "^4",
     "chokidar": "^3",
     "decamelize": "^5",
@@ -136,7 +139,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.1.8",
+  "version": "0.2.0",
   "types": "lib/index.d.ts",
   "exports": {
     ".": {

package/tsconfig.dts.json

@@ -0,0 +1,9 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "rootDir": null,
+    "composite": false
+  },
+  "include": ["lib/**/*.ts"],
+  "exclude": []
+}

package/lib/api/aws-cdk.d.ts

@@ -1,20 +0,0 @@
-export { SdkProvider } from '../../../../aws-cdk/lib/api/aws-auth';
-export { Context, PROJECT_CONTEXT } from '../../../../aws-cdk/lib/api/context';
-export { createDiffChangeSet, Deployments, type SuccessfulDeployStackResult, type DeployStackOptions, type DeployStackResult } from '../../../../aws-cdk/lib/api/deployments';
-export { Settings } from '../../../../aws-cdk/lib/api/settings';
-export { type Tag, tagsForStack } from '../../../../aws-cdk/lib/api/tags';
-export { DEFAULT_TOOLKIT_STACK_NAME } from '../../../../aws-cdk/lib/api/toolkit-info';
-export { ResourceMigrator } from '../../../../aws-cdk/lib/api/resource-import';
-export { CloudWatchLogEventMonitor, findCloudWatchLogGroups } from '../../../../aws-cdk/lib/api/logs';
-export { type WorkGraph, WorkGraphBuilder, AssetBuildNode, AssetPublishNode, StackNode, Concurrency } from '../../../../aws-cdk/lib/api/work-graph';
-export { Bootstrapper } from '../../../../aws-cdk/lib/api/bootstrap';
-export { loadTree, some } from '../../../../aws-cdk/lib/api/tree';
-export * as contextproviders from '../../../../aws-cdk/lib/context-providers';
-export { HotswapMode } from '../../../../aws-cdk/lib/api/hotswap/common';
-export { HotswapPropertyOverrides, EcsHotswapProperties } from '../../../../aws-cdk/lib/api/hotswap/common';
-export { RWLock, type ILock } from '../../../../aws-cdk/lib/api/util/rwlock';
-export { CloudAssembly, sanitizePatterns, StackCollection, ExtendedStackSelection } from '../../../../aws-cdk/lib/api/cxapp/cloud-assembly';
-export { prepareDefaultEnvironment, prepareContext, spaceAvailableForContext } from '../../../../aws-cdk/lib/api/cxapp/exec';
-export { guessExecutable } from '../../../../aws-cdk/lib/api/cxapp/exec';
-export { versionNumber } from '../../../../aws-cdk/lib/cli/version';
-export { CliIoHost } from '../../../../aws-cdk/lib/cli/io-host';