@aws-cdk/cx-api - npm Package Compare versions

Comparing version 0.32.0 to 0.33.0

lib/cxapi.d.ts

@@ -1,118 +0,4 @@
-/**
- * File with definitions for the interface between the Cloud Executable and the CDK toolkit.
- */
-import { Artifact } from './artifacts';
-import { Environment } from './environment';
-/**
- * Bump this to the library version if and only if the CX protocol changes.
- *
- * We could also have used 1, 2, 3, ... here to indicate protocol versions, but
- * those then still need to be mapped to software versions to be useful. So we
- * might as well use the software version as protocol version and immediately
- * generate a useful error message from this.
- *
- * Note the following:
- *
- * - The versions are not compared in a semver way, they are used as
- *    opaque ordered tokens.
- * - The version needs to be set to the NEXT releasable version when it's
- *   updated (as the current verison in package.json has already been released!)
- * - The request does not have versioning yet, only the response.
- */
-export declare const PROTO_RESPONSE_VERSION = "0.19.0";
-/**
- * The name of the root manifest file of the assembly.
- */
-export declare const MANIFEST_FILE = "manifest.json";
-/**
- * The name of the root file with build instructions.
- */
-export declare const BUILD_FILE = "build.json";
 export declare const OUTDIR_ENV = "CDK_OUTDIR";
 export declare const CONTEXT_ENV = "CDK_CONTEXT_JSON";
 /**
- * Represents a missing piece of context.
- */
-export interface MissingContext {
-    readonly provider: string;
-    readonly props: {
-        account?: string;
-        region?: string;
-        [key: string]: any;
-    };
-}
-export interface AssemblyManifest {
-    /**
-     * Protocol version
-     */
-    readonly version: string;
-    /**
-     * The set of artifacts in this assembly.
-     */
-    readonly artifacts?: {
-        [id: string]: Artifact;
-    };
-    /**
-     * Runtime information.
-     */
-    readonly runtime?: AppRuntime;
-}
-/**
- * @deprecated use `AssemblyManifest`
- */
-export interface SynthesizeResponse extends AssemblyManifest {
-    readonly stacks: SynthesizedStack[];
-}
-/**
- * A complete synthesized stack
- */
-export interface SynthesizedStack {
-    readonly name: string;
-    readonly environment: Environment;
-    readonly missing?: {
-        [key: string]: MissingContext;
-    };
-    readonly metadata: StackMetadata;
-    readonly template: any;
-    readonly autoDeploy?: boolean;
-    /**
-     * Other stacks this stack depends on
-     */
-    readonly dependsOn?: string[];
-}
-/**
- * An metadata entry in the construct.
- */
-export interface MetadataEntry {
-    /**
-     * The type of the metadata entry.
-     */
-    readonly type: string;
-    /**
-     * The data.
-     */
-    readonly data?: any;
-    /**
-     * A stack trace for when the entry was created.
-     */
-    readonly trace: string[];
-}
-/**
- * Metadata associated with the objects in the stack's Construct tree
- */
-export declare type StackMetadata = {
-    [path: string]: MetadataEntry[];
-};
-/**
- * Information about the application's runtime components.
- */
-export interface AppRuntime {
-    /**
-     * The list of libraries loaded in the application, associated with their versions.
-     */
-    readonly libraries: {
-        [name: string]: string;
-    };
-}
-/**
  * Context parameter for the default AWS account to use if a stack's environment is not set.
@@ -126,19 +12,2 @@ */
 /**
- * Metadata key used to print INFO-level messages by the toolkit when an app is syntheized.
- */
-export declare const INFO_METADATA_KEY = "aws:cdk:info";
-/**
- * Metadata key used to print WARNING-level messages by the toolkit when an app is syntheized.
- */
-export declare const WARNING_METADATA_KEY = "aws:cdk:warning";
-/**
- * Metadata key used to print ERROR-level messages by the toolkit when an app is syntheized.
- */
-export declare const ERROR_METADATA_KEY = "aws:cdk:error";
-/**
- * The key used when CDK path is embedded in **CloudFormation template**
- * metadata.
- */
-export declare const PATH_METADATA_KEY = "aws:cdk:path";
-/**
  * Enables the embedding of the "aws:cdk:path" in CloudFormation template metadata.
@@ -148,20 +17,13 @@ */
 /**
- * Disables the emission of `cdk.out`
+ * Disable the collection and reporting of version information.
  */
-export declare const DISABLE_LEGACY_MANIFEST_CONTEXT = "aws:cdk:disable-legacy-manifest";
+export declare const DISABLE_VERSION_REPORTING = "aws:cdk:disable-version-reporting";
 /**
- * The name of the pre 0.25.0 manifest file. Will only be emitted if
- * aws:cdk:disable-legacy-manifest is not defined.
- *
- * @deprecated Use `MANIFEST_FILE`
+ * If this is set, asset staging is disabled. This means that assets will not be copied to
+ * the output directory and will be referenced with absolute source paths.
  */
-export declare const OUTFILE_NAME = "cdk.out";
+export declare const DISABLE_ASSET_STAGING_CONTEXT = "aws:cdk:disable-asset-staging";
 /**
- * Disable the collection and reporting of version information.
+ * Omits stack traces from construct metadata entries.
  */
-export declare const DISABLE_VERSION_REPORTING = "aws:cdk:disable-version-reporting";
-/**
- * If this context key is set, the CDK will stage assets under the specified
- * directory. Otherwise, assets will not be staged.
- */
-export declare const ASSET_STAGING_DIR_CONTEXT = "aws:cdk:asset-staging-dir";
+export declare const DISABLE_METADATA_STACK_TRACE = "aws:cdk:disable-stack-trace";

lib/cxapi.js

 "use strict";
-/**
- * File with definitions for the interface between the Cloud Executable and the CDK toolkit.
- */
 Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * Bump this to the library version if and only if the CX protocol changes.
- *
- * We could also have used 1, 2, 3, ... here to indicate protocol versions, but
- * those then still need to be mapped to software versions to be useful. So we
- * might as well use the software version as protocol version and immediately
- * generate a useful error message from this.
- *
- * Note the following:
- *
- * - The versions are not compared in a semver way, they are used as
- *    opaque ordered tokens.
- * - The version needs to be set to the NEXT releasable version when it's
- *   updated (as the current verison in package.json has already been released!)
- * - The request does not have versioning yet, only the response.
- */
-exports.PROTO_RESPONSE_VERSION = '0.19.0';
-/**
- * The name of the root manifest file of the assembly.
- */
-exports.MANIFEST_FILE = 'manifest.json';
-/**
- * The name of the root file with build instructions.
- */
-exports.BUILD_FILE = 'build.json';
+// output directory into which to emit synthesis outputs. CDK doesn't allow outdir
+// to be specified both through the CDK_OUTDIR environment variable and the through
+// aws:cdk:outdir context.
 exports.OUTDIR_ENV = 'CDK_OUTDIR';
@@ -42,19 +17,2 @@ exports.CONTEXT_ENV = 'CDK_CONTEXT_JSON';
 /**
- * Metadata key used to print INFO-level messages by the toolkit when an app is syntheized.
- */
-exports.INFO_METADATA_KEY = 'aws:cdk:info';
-/**
- * Metadata key used to print WARNING-level messages by the toolkit when an app is syntheized.
- */
-exports.WARNING_METADATA_KEY = 'aws:cdk:warning';
-/**
- * Metadata key used to print ERROR-level messages by the toolkit when an app is syntheized.
- */
-exports.ERROR_METADATA_KEY = 'aws:cdk:error';
-/**
- * The key used when CDK path is embedded in **CloudFormation template**
- * metadata.
- */
-exports.PATH_METADATA_KEY = 'aws:cdk:path';
-/**
  * Enables the embedding of the "aws:cdk:path" in CloudFormation template metadata.
@@ -64,21 +22,14 @@ */
 /**
- * Disables the emission of `cdk.out`
+ * Disable the collection and reporting of version information.
  */
-exports.DISABLE_LEGACY_MANIFEST_CONTEXT = 'aws:cdk:disable-legacy-manifest';
+exports.DISABLE_VERSION_REPORTING = 'aws:cdk:disable-version-reporting';
 /**
- * The name of the pre 0.25.0 manifest file. Will only be emitted if
- * aws:cdk:disable-legacy-manifest is not defined.
- *
- * @deprecated Use `MANIFEST_FILE`
+ * If this is set, asset staging is disabled. This means that assets will not be copied to
+ * the output directory and will be referenced with absolute source paths.
  */
-exports.OUTFILE_NAME = 'cdk.out';
+exports.DISABLE_ASSET_STAGING_CONTEXT = 'aws:cdk:disable-asset-staging';
 /**
- * Disable the collection and reporting of version information.
+ * Omits stack traces from construct metadata entries.
  */
-exports.DISABLE_VERSION_REPORTING = 'aws:cdk:disable-version-reporting';
-/**
- * If this context key is set, the CDK will stage assets under the specified
- * directory. Otherwise, assets will not be staged.
- */
-exports.ASSET_STAGING_DIR_CONTEXT = 'aws:cdk:asset-staging-dir';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY3hhcGkuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJjeGFwaS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUE7O0dBRUc7O0FBS0g7Ozs7Ozs7Ozs7Ozs7OztHQWVHO0FBQ1UsUUFBQSxzQkFBc0IsR0FBRyxRQUFRLENBQUM7QUFFL0M7O0dBRUc7QUFDVSxRQUFBLGFBQWEsR0FBRyxlQUFlLENBQUM7QUFFN0M7O0dBRUc7QUFDVSxRQUFBLFVBQVUsR0FBRyxZQUFZLENBQUM7QUFFMUIsUUFBQSxVQUFVLEdBQUcsWUFBWSxDQUFDO0FBQzFCLFFBQUEsV0FBVyxHQUFHLGtCQUFrQixDQUFDO0FBMEY5Qzs7R0FFRztBQUNVLFFBQUEsMkJBQTJCLEdBQUcsaUNBQWlDLENBQUM7QUFFN0U7O0dBRUc7QUFDVSxRQUFBLDBCQUEwQixHQUFHLGdDQUFnQyxDQUFDO0FBRTNFOztHQUVHO0FBQ1UsUUFBQSxpQkFBaUIsR0FBRyxjQUFjLENBQUM7QUFFaEQ7O0dBRUc7QUFDVSxRQUFBLG9CQUFvQixHQUFHLGlCQUFpQixDQUFDO0FBRXREOztHQUVHO0FBQ1UsUUFBQSxrQkFBa0IsR0FBRyxlQUFlLENBQUM7QUFFbEQ7OztHQUdHO0FBQ1UsUUFBQSxpQkFBaUIsR0FBRyxjQUFjLENBQUM7QUFFaEQ7O0dBRUc7QUFDVSxRQUFBLDRCQUE0QixHQUFHLDhCQUE4QixDQUFDO0FBRTNFOztHQUVHO0FBQ1UsUUFBQSwrQkFBK0IsR0FBRyxpQ0FBaUMsQ0FBQztBQUVqRjs7Ozs7R0FLRztBQUNVLFFBQUEsWUFBWSxHQUFHLFNBQVMsQ0FBQztBQUV0Qzs7R0FFRztBQUNVLFFBQUEseUJBQXlCLEdBQUcsbUNBQW1DLENBQUM7QUFFN0U7OztHQUdHO0FBQ1UsUUFBQSx5QkFBeUIsR0FBRywyQkFBMkIsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogRmlsZSB3aXRoIGRlZmluaXRpb25zIGZvciB0aGUgaW50ZXJmYWNlIGJldHdlZW4gdGhlIENsb3VkIEV4ZWN1dGFibGUgYW5kIHRoZSBDREsgdG9vbGtpdC5cbiAqL1xuXG5pbXBvcnQgeyBBcnRpZmFjdCB9IGZyb20gJy4vYXJ0aWZhY3RzJztcbmltcG9ydCB7IEVudmlyb25tZW50IH0gZnJvbSAnLi9lbnZpcm9ubWVudCc7XG5cbi8qKlxuICogQnVtcCB0aGlzIHRvIHRoZSBsaWJyYXJ5IHZlcnNpb24gaWYgYW5kIG9ubHkgaWYgdGhlIENYIHByb3RvY29sIGNoYW5nZXMuXG4gKlxuICogV2UgY291bGQgYWxzbyBoYXZlIHVzZWQgMSwgMiwgMywgLi4uIGhlcmUgdG8gaW5kaWNhdGUgcHJvdG9jb2wgdmVyc2lvbnMsIGJ1dFxuICogdGhvc2UgdGhlbiBzdGlsbCBuZWVkIHRvIGJlIG1hcHBlZCB0byBzb2Z0d2FyZSB2ZXJzaW9ucyB0byBiZSB1c2VmdWwuIFNvIHdlXG4gKiBtaWdodCBhcyB3ZWxsIHVzZSB0aGUgc29mdHdhcmUgdmVyc2lvbiBhcyBwcm90b2NvbCB2ZXJzaW9uIGFuZCBpbW1lZGlhdGVseVxuICogZ2VuZXJhdGUgYSB1c2VmdWwgZXJyb3IgbWVzc2FnZSBmcm9tIHRoaXMuXG4gKlxuICogTm90ZSB0aGUgZm9sbG93aW5nOlxuICpcbiAqIC0gVGhlIHZlcnNpb25zIGFyZSBub3QgY29tcGFyZWQgaW4gYSBzZW12ZXIgd2F5LCB0aGV5IGFyZSB1c2VkIGFzXG4gKiAgICBvcGFxdWUgb3JkZXJlZCB0b2tlbnMuXG4gKiAtIFRoZSB2ZXJzaW9uIG5lZWRzIHRvIGJlIHNldCB0byB0aGUgTkVYVCByZWxlYXNhYmxlIHZlcnNpb24gd2hlbiBpdCdzXG4gKiAgIHVwZGF0ZWQgKGFzIHRoZSBjdXJyZW50IHZlcmlzb24gaW4gcGFja2FnZS5qc29uIGhhcyBhbHJlYWR5IGJlZW4gcmVsZWFzZWQhKVxuICogLSBUaGUgcmVxdWVzdCBkb2VzIG5vdCBoYXZlIHZlcnNpb25pbmcgeWV0LCBvbmx5IHRoZSByZXNwb25zZS5cbiAqL1xuZXhwb3J0IGNvbnN0IFBST1RPX1JFU1BPTlNFX1ZFUlNJT04gPSAnMC4xOS4wJztcblxuLyoqXG4gKiBUaGUgbmFtZSBvZiB0aGUgcm9vdCBtYW5pZmVzdCBmaWxlIG9mIHRoZSBhc3NlbWJseS5cbiAqL1xuZXhwb3J0IGNvbnN0IE1BTklGRVNUX0ZJTEUgPSAnbWFuaWZlc3QuanNvbic7XG5cbi8qKlxuICogVGhlIG5hbWUgb2YgdGhlIHJvb3QgZmlsZSB3aXRoIGJ1aWxkIGluc3RydWN0aW9ucy5cbiAqL1xuZXhwb3J0IGNvbnN0IEJVSUxEX0ZJTEUgPSAnYnVpbGQuanNvbic7XG5cbmV4cG9ydCBjb25zdCBPVVRESVJfRU5WID0gJ0NES19PVVRESVInO1xuZXhwb3J0IGNvbnN0IENPTlRFWFRfRU5WID0gJ0NES19DT05URVhUX0pTT04nO1xuXG4vKipcbiAqIFJlcHJlc2VudHMgYSBtaXNzaW5nIHBpZWNlIG9mIGNvbnRleHQuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgTWlzc2luZ0NvbnRleHQge1xuICByZWFkb25seSBwcm92aWRlcjogc3RyaW5nO1xuICByZWFkb25seSBwcm9wczoge1xuICAgIGFjY291bnQ/OiBzdHJpbmc7XG4gICAgcmVnaW9uPzogc3RyaW5nO1xuICAgIFtrZXk6IHN0cmluZ106IGFueTtcbiAgfTtcbn1cblxuZXhwb3J0IGludGVyZmFjZSBBc3NlbWJseU1hbmlmZXN0IHtcbiAgLyoqXG4gICAqIFByb3RvY29sIHZlcnNpb25cbiAgICovXG4gIHJlYWRvbmx5IHZlcnNpb246IHN0cmluZztcblxuICAvKipcbiAgICogVGhlIHNldCBvZiBhcnRpZmFjdHMgaW4gdGhpcyBhc3NlbWJseS5cbiAgICovXG4gIHJlYWRvbmx5IGFydGlmYWN0cz86IHsgW2lkOiBzdHJpbmddOiBBcnRpZmFjdCB9O1xuXG4gIC8qKlxuICAgKiBSdW50aW1lIGluZm9ybWF0aW9uLlxuICAgKi9cbiAgcmVhZG9ubHkgcnVudGltZT86IEFwcFJ1bnRpbWU7XG59XG5cbi8qKlxuICogQGRlcHJlY2F0ZWQgdXNlIGBBc3NlbWJseU1hbmlmZXN0YFxuICovXG5leHBvcnQgaW50ZXJmYWNlIFN5bnRoZXNpemVSZXNwb25zZSBleHRlbmRzIEFzc2VtYmx5TWFuaWZlc3Qge1xuICByZWFkb25seSBzdGFja3M6IFN5bnRoZXNpemVkU3RhY2tbXTtcbn1cblxuLyoqXG4gKiBBIGNvbXBsZXRlIHN5bnRoZXNpemVkIHN0YWNrXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgU3ludGhlc2l6ZWRTdGFjayB7XG4gIHJlYWRvbmx5IG5hbWU6IHN0cmluZztcbiAgcmVhZG9ubHkgZW52aXJvbm1lbnQ6IEVudmlyb25tZW50O1xuICByZWFkb25seSBtaXNzaW5nPzogeyBba2V5OiBzdHJpbmddOiBNaXNzaW5nQ29udGV4dCB9O1xuICByZWFkb25seSBtZXRhZGF0YTogU3RhY2tNZXRhZGF0YTtcbiAgcmVhZG9ubHkgdGVtcGxhdGU6IGFueTtcbiAgcmVhZG9ubHkgYXV0b0RlcGxveT86IGJvb2xlYW47XG5cbiAgLyoqXG4gICAqIE90aGVyIHN0YWNrcyB0aGlzIHN0YWNrIGRlcGVuZHMgb25cbiAgICovXG4gIHJlYWRvbmx5IGRlcGVuZHNPbj86IHN0cmluZ1tdO1xufVxuXG4vKipcbiAqIEFuIG1ldGFkYXRhIGVudHJ5IGluIHRoZSBjb25zdHJ1Y3QuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgTWV0YWRhdGFFbnRyeSB7XG4gIC8qKlxuICAgKiBUaGUgdHlwZSBvZiB0aGUgbWV0YWRhdGEgZW50cnkuXG4gICAqL1xuICByZWFkb25seSB0eXBlOiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFRoZSBkYXRhLlxuICAgKi9cbiAgcmVhZG9ubHkgZGF0YT86IGFueTtcblxuICAvKipcbiAgICogQSBzdGFjayB0cmFjZSBmb3Igd2hlbiB0aGUgZW50cnkgd2FzIGNyZWF0ZWQuXG4gICAqL1xuICByZWFkb25seSB0cmFjZTogc3RyaW5nW107XG59XG5cbi8qKlxuICogTWV0YWRhdGEgYXNzb2NpYXRlZCB3aXRoIHRoZSBvYmplY3RzIGluIHRoZSBzdGFjaydzIENvbnN0cnVjdCB0cmVlXG4gKi9cbmV4cG9ydCB0eXBlIFN0YWNrTWV0YWRhdGEgPSB7IFtwYXRoOiBzdHJpbmddOiBNZXRhZGF0YUVudHJ5W10gfTtcblxuLyoqXG4gKiBJbmZvcm1hdGlvbiBhYm91dCB0aGUgYXBwbGljYXRpb24ncyBydW50aW1lIGNvbXBvbmVudHMuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQXBwUnVudGltZSB7XG4gIC8qKlxuICAgKiBUaGUgbGlzdCBvZiBsaWJyYXJpZXMgbG9hZGVkIGluIHRoZSBhcHBsaWNhdGlvbiwgYXNzb2NpYXRlZCB3aXRoIHRoZWlyIHZlcnNpb25zLlxuICAgKi9cbiAgcmVhZG9ubHkgbGlicmFyaWVzOiB7IFtuYW1lOiBzdHJpbmddOiBzdHJpbmcgfTtcbn1cblxuLyoqXG4gKiBDb250ZXh0IHBhcmFtZXRlciBmb3IgdGhlIGRlZmF1bHQgQVdTIGFjY291bnQgdG8gdXNlIGlmIGEgc3RhY2sncyBlbnZpcm9ubWVudCBpcyBub3Qgc2V0LlxuICovXG5leHBvcnQgY29uc3QgREVGQVVMVF9BQ0NPVU5UX0NPTlRFWFRfS0VZID0gJ2F3czpjZGs6dG9vbGtpdDpkZWZhdWx0LWFjY291bnQnO1xuXG4vKipcbiAqIENvbnRleHQgcGFyYW1ldGVyIGZvciB0aGUgZGVmYXVsdCBBV1MgcmVnaW9uIHRvIHVzZSBpZiBhIHN0YWNrJ3MgZW52aXJvbm1lbnQgaXMgbm90IHNldC5cbiAqL1xuZXhwb3J0IGNvbnN0IERFRkFVTFRfUkVHSU9OX0NPTlRFWFRfS0VZID0gJ2F3czpjZGs6dG9vbGtpdDpkZWZhdWx0LXJlZ2lvbic7XG5cbi8qKlxuICogTWV0YWRhdGEga2V5IHVzZWQgdG8gcHJpbnQgSU5GTy1sZXZlbCBtZXNzYWdlcyBieSB0aGUgdG9vbGtpdCB3aGVuIGFuIGFwcCBpcyBzeW50aGVpemVkLlxuICovXG5leHBvcnQgY29uc3QgSU5GT19NRVRBREFUQV9LRVkgPSAnYXdzOmNkazppbmZvJztcblxuLyoqXG4gKiBNZXRhZGF0YSBrZXkgdXNlZCB0byBwcmludCBXQVJOSU5HLWxldmVsIG1lc3NhZ2VzIGJ5IHRoZSB0b29sa2l0IHdoZW4gYW4gYXBwIGlzIHN5bnRoZWl6ZWQuXG4gKi9cbmV4cG9ydCBjb25zdCBXQVJOSU5HX01FVEFEQVRBX0tFWSA9ICdhd3M6Y2RrOndhcm5pbmcnO1xuXG4vKipcbiAqIE1ldGFkYXRhIGtleSB1c2VkIHRvIHByaW50IEVSUk9SLWxldmVsIG1lc3NhZ2VzIGJ5IHRoZSB0b29sa2l0IHdoZW4gYW4gYXBwIGlzIHN5bnRoZWl6ZWQuXG4gKi9cbmV4cG9ydCBjb25zdCBFUlJPUl9NRVRBREFUQV9LRVkgPSAnYXdzOmNkazplcnJvcic7XG5cbi8qKlxuICogVGhlIGtleSB1c2VkIHdoZW4gQ0RLIHBhdGggaXMgZW1iZWRkZWQgaW4gKipDbG91ZEZvcm1hdGlvbiB0ZW1wbGF0ZSoqXG4gKiBtZXRhZGF0YS5cbiAqL1xuZXhwb3J0IGNvbnN0IFBBVEhfTUVUQURBVEFfS0VZID0gJ2F3czpjZGs6cGF0aCc7XG5cbi8qKlxuICogRW5hYmxlcyB0aGUgZW1iZWRkaW5nIG9mIHRoZSBcImF3czpjZGs6cGF0aFwiIGluIENsb3VkRm9ybWF0aW9uIHRlbXBsYXRlIG1ldGFkYXRhLlxuICovXG5leHBvcnQgY29uc3QgUEFUSF9NRVRBREFUQV9FTkFCTEVfQ09OVEVYVCA9ICdhd3M6Y2RrOmVuYWJsZS1wYXRoLW1ldGFkYXRhJztcblxuLyoqXG4gKiBEaXNhYmxlcyB0aGUgZW1pc3Npb24gb2YgYGNkay5vdXRgXG4gKi9cbmV4cG9ydCBjb25zdCBESVNBQkxFX0xFR0FDWV9NQU5JRkVTVF9DT05URVhUID0gJ2F3czpjZGs6ZGlzYWJsZS1sZWdhY3ktbWFuaWZlc3QnO1xuXG4vKipcbiAqIFRoZSBuYW1lIG9mIHRoZSBwcmUgMC4yNS4wIG1hbmlmZXN0IGZpbGUuIFdpbGwgb25seSBiZSBlbWl0dGVkIGlmXG4gKiBhd3M6Y2RrOmRpc2FibGUtbGVnYWN5LW1hbmlmZXN0IGlzIG5vdCBkZWZpbmVkLlxuICpcbiAqIEBkZXByZWNhdGVkIFVzZSBgTUFOSUZFU1RfRklMRWBcbiAqL1xuZXhwb3J0IGNvbnN0IE9VVEZJTEVfTkFNRSA9ICdjZGsub3V0JztcblxuLyoqXG4gKiBEaXNhYmxlIHRoZSBjb2xsZWN0aW9uIGFuZCByZXBvcnRpbmcgb2YgdmVyc2lvbiBpbmZvcm1hdGlvbi5cbiAqL1xuZXhwb3J0IGNvbnN0IERJU0FCTEVfVkVSU0lPTl9SRVBPUlRJTkcgPSAnYXdzOmNkazpkaXNhYmxlLXZlcnNpb24tcmVwb3J0aW5nJztcblxuLyoqXG4gKiBJZiB0aGlzIGNvbnRleHQga2V5IGlzIHNldCwgdGhlIENESyB3aWxsIHN0YWdlIGFzc2V0cyB1bmRlciB0aGUgc3BlY2lmaWVkXG4gKiBkaXJlY3RvcnkuIE90aGVyd2lzZSwgYXNzZXRzIHdpbGwgbm90IGJlIHN0YWdlZC5cbiAqL1xuZXhwb3J0IGNvbnN0IEFTU0VUX1NUQUdJTkdfRElSX0NPTlRFWFQgPSAnYXdzOmNkazphc3NldC1zdGFnaW5nLWRpcic7XG4iXX0=
+exports.DISABLE_METADATA_STACK_TRACE = 'aws:cdk:disable-stack-trace';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY3hhcGkuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJjeGFwaS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQUFBLGtGQUFrRjtBQUNsRixtRkFBbUY7QUFDbkYsMEJBQTBCO0FBQ2IsUUFBQSxVQUFVLEdBQUcsWUFBWSxDQUFDO0FBQzFCLFFBQUEsV0FBVyxHQUFHLGtCQUFrQixDQUFDO0FBRTlDOztHQUVHO0FBQ1UsUUFBQSwyQkFBMkIsR0FBRyxpQ0FBaUMsQ0FBQztBQUU3RTs7R0FFRztBQUNVLFFBQUEsMEJBQTBCLEdBQUcsZ0NBQWdDLENBQUM7QUFFM0U7O0dBRUc7QUFDVSxRQUFBLDRCQUE0QixHQUFHLDhCQUE4QixDQUFDO0FBRTNFOztHQUVHO0FBQ1UsUUFBQSx5QkFBeUIsR0FBRyxtQ0FBbUMsQ0FBQztBQUU3RTs7O0dBR0c7QUFDVSxRQUFBLDZCQUE2QixHQUFHLCtCQUErQixDQUFDO0FBRTdFOztHQUVHO0FBQ1UsUUFBQSw0QkFBNEIsR0FBRyw2QkFBNkIsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8vIG91dHB1dCBkaXJlY3RvcnkgaW50byB3aGljaCB0byBlbWl0IHN5bnRoZXNpcyBvdXRwdXRzLiBDREsgZG9lc24ndCBhbGxvdyBvdXRkaXJcbi8vIHRvIGJlIHNwZWNpZmllZCBib3RoIHRocm91Z2ggdGhlIENES19PVVRESVIgZW52aXJvbm1lbnQgdmFyaWFibGUgYW5kIHRoZSB0aHJvdWdoXG4vLyBhd3M6Y2RrOm91dGRpciBjb250ZXh0LlxuZXhwb3J0IGNvbnN0IE9VVERJUl9FTlYgPSAnQ0RLX09VVERJUic7XG5leHBvcnQgY29uc3QgQ09OVEVYVF9FTlYgPSAnQ0RLX0NPTlRFWFRfSlNPTic7XG5cbi8qKlxuICogQ29udGV4dCBwYXJhbWV0ZXIgZm9yIHRoZSBkZWZhdWx0IEFXUyBhY2NvdW50IHRvIHVzZSBpZiBhIHN0YWNrJ3MgZW52aXJvbm1lbnQgaXMgbm90IHNldC5cbiAqL1xuZXhwb3J0IGNvbnN0IERFRkFVTFRfQUNDT1VOVF9DT05URVhUX0tFWSA9ICdhd3M6Y2RrOnRvb2xraXQ6ZGVmYXVsdC1hY2NvdW50JztcblxuLyoqXG4gKiBDb250ZXh0IHBhcmFtZXRlciBmb3IgdGhlIGRlZmF1bHQgQVdTIHJlZ2lvbiB0byB1c2UgaWYgYSBzdGFjaydzIGVudmlyb25tZW50IGlzIG5vdCBzZXQuXG4gKi9cbmV4cG9ydCBjb25zdCBERUZBVUxUX1JFR0lPTl9DT05URVhUX0tFWSA9ICdhd3M6Y2RrOnRvb2xraXQ6ZGVmYXVsdC1yZWdpb24nO1xuXG4vKipcbiAqIEVuYWJsZXMgdGhlIGVtYmVkZGluZyBvZiB0aGUgXCJhd3M6Y2RrOnBhdGhcIiBpbiBDbG91ZEZvcm1hdGlvbiB0ZW1wbGF0ZSBtZXRhZGF0YS5cbiAqL1xuZXhwb3J0IGNvbnN0IFBBVEhfTUVUQURBVEFfRU5BQkxFX0NPTlRFWFQgPSAnYXdzOmNkazplbmFibGUtcGF0aC1tZXRhZGF0YSc7XG5cbi8qKlxuICogRGlzYWJsZSB0aGUgY29sbGVjdGlvbiBhbmQgcmVwb3J0aW5nIG9mIHZlcnNpb24gaW5mb3JtYXRpb24uXG4gKi9cbmV4cG9ydCBjb25zdCBESVNBQkxFX1ZFUlNJT05fUkVQT1JUSU5HID0gJ2F3czpjZGs6ZGlzYWJsZS12ZXJzaW9uLXJlcG9ydGluZyc7XG5cbi8qKlxuICogSWYgdGhpcyBpcyBzZXQsIGFzc2V0IHN0YWdpbmcgaXMgZGlzYWJsZWQuIFRoaXMgbWVhbnMgdGhhdCBhc3NldHMgd2lsbCBub3QgYmUgY29waWVkIHRvXG4gKiB0aGUgb3V0cHV0IGRpcmVjdG9yeSBhbmQgd2lsbCBiZSByZWZlcmVuY2VkIHdpdGggYWJzb2x1dGUgc291cmNlIHBhdGhzLlxuICovXG5leHBvcnQgY29uc3QgRElTQUJMRV9BU1NFVF9TVEFHSU5HX0NPTlRFWFQgPSAnYXdzOmNkazpkaXNhYmxlLWFzc2V0LXN0YWdpbmcnO1xuXG4vKipcbiAqIE9taXRzIHN0YWNrIHRyYWNlcyBmcm9tIGNvbnN0cnVjdCBtZXRhZGF0YSBlbnRyaWVzLlxuICovXG5leHBvcnQgY29uc3QgRElTQUJMRV9NRVRBREFUQV9TVEFDS19UUkFDRSA9ICdhd3M6Y2RrOmRpc2FibGUtc3RhY2stdHJhY2UnO1xuIl19

lib/environment.d.ts

@@ -12,1 +12,5 @@ /**
 }
+export declare class EnvironmentUtils {
+    static parse(environment: string): Environment;
+    static format(account: string, region: string): string;
+}

lib/environment.js

 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZW52aXJvbm1lbnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJlbnZpcm9ubWVudC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBNb2RlbHMgYW4gQVdTIGV4ZWN1dGlvbiBlbnZpcm9ubWVudCwgZm9yIHVzZSB3aXRoaW4gdGhlIENESyB0b29sa2l0LlxuICovXG5leHBvcnQgaW50ZXJmYWNlIEVudmlyb25tZW50IHtcbiAgLyoqIFRoZSBhcmJpdHJhcnkgbmFtZSBvZiB0aGlzIGVudmlyb25tZW50ICh1c2VyLXNldCwgb3IgYXQgbGVhc3QgdXNlci1tZWFuaW5nZnVsKSAqL1xuICByZWFkb25seSBuYW1lOiBzdHJpbmc7XG5cbiAgLyoqIFRoZSAxMi1kaWdpdCBBV1MgYWNjb3VudCBJRCBmb3IgdGhlIGFjY291bnQgdGhpcyBlbnZpcm9ubWVudCBkZXBsb3lzIGludG8gKi9cbiAgcmVhZG9ubHkgYWNjb3VudDogc3RyaW5nO1xuXG4gIC8qKiBUaGUgQVdTIHJlZ2lvbiBuYW1lIHdoZXJlIHRoaXMgZW52aXJvbm1lbnQgZGVwbG95cyBpbnRvICovXG4gIHJlYWRvbmx5IHJlZ2lvbjogc3RyaW5nO1xufVxuIl19
+/**
+ * Parser for the artifact environment field.
+ */
+const AWS_ENV_REGEX = /aws\:\/\/([0-9]+|unknown-account)\/([a-z\-0-9]+)/;
+class EnvironmentUtils {
+    static parse(environment) {
+        const env = AWS_ENV_REGEX.exec(environment);
+        if (!env) {
+            throw new Error(`Unable to parse environment specification "${environment}". ` +
+                `Expected format: aws://acount/region`);
+        }
+        const [, account, region] = env;
+        if (!account || !region) {
+            throw new Error(`Invalid environment specification: ${environment}`);
+        }
+        return { account, region, name: environment };
+    }
+    static format(account, region) {
+        return `aws://${account}/${region}`;
+    }
+}
+exports.EnvironmentUtils = EnvironmentUtils;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZW52aXJvbm1lbnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJlbnZpcm9ubWVudC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQUFBOztHQUVHO0FBQ0gsTUFBTSxhQUFhLEdBQUcsa0RBQWtELENBQUM7QUFnQnpFLE1BQWEsZ0JBQWdCO0lBQ3BCLE1BQU0sQ0FBQyxLQUFLLENBQUMsV0FBbUI7UUFDckMsTUFBTSxHQUFHLEdBQUcsYUFBYSxDQUFDLElBQUksQ0FBQyxXQUFXLENBQUMsQ0FBQztRQUM1QyxJQUFJLENBQUMsR0FBRyxFQUFFO1lBQ1IsTUFBTSxJQUFJLEtBQUssQ0FDYiw4Q0FBOEMsV0FBVyxLQUFLO2dCQUM5RCxzQ0FBc0MsQ0FBQyxDQUFDO1NBQzNDO1FBRUQsTUFBTSxDQUFFLEFBQUQsRUFBRyxPQUFPLEVBQUUsTUFBTSxDQUFFLEdBQUcsR0FBRyxDQUFDO1FBQ2xDLElBQUksQ0FBQyxPQUFPLElBQUksQ0FBQyxNQUFNLEVBQUU7WUFDdkIsTUFBTSxJQUFJLEtBQUssQ0FBQyxzQ0FBc0MsV0FBVyxFQUFFLENBQUMsQ0FBQztTQUN0RTtRQUVELE9BQU8sRUFBRSxPQUFPLEVBQUUsTUFBTSxFQUFFLElBQUksRUFBRSxXQUFXLEVBQUUsQ0FBQztJQUNoRCxDQUFDO0lBRU0sTUFBTSxDQUFDLE1BQU0sQ0FBQyxPQUFlLEVBQUUsTUFBYztRQUNsRCxPQUFPLFNBQVMsT0FBTyxJQUFJLE1BQU0sRUFBRSxDQUFDO0lBQ3RDLENBQUM7Q0FDRjtBQXBCRCw0Q0FvQkMiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIFBhcnNlciBmb3IgdGhlIGFydGlmYWN0IGVudmlyb25tZW50IGZpZWxkLlxuICovXG5jb25zdCBBV1NfRU5WX1JFR0VYID0gL2F3c1xcOlxcL1xcLyhbMC05XSt8dW5rbm93bi1hY2NvdW50KVxcLyhbYS16XFwtMC05XSspLztcblxuLyoqXG4gKiBNb2RlbHMgYW4gQVdTIGV4ZWN1dGlvbiBlbnZpcm9ubWVudCwgZm9yIHVzZSB3aXRoaW4gdGhlIENESyB0b29sa2l0LlxuICovXG5leHBvcnQgaW50ZXJmYWNlIEVudmlyb25tZW50IHtcbiAgLyoqIFRoZSBhcmJpdHJhcnkgbmFtZSBvZiB0aGlzIGVudmlyb25tZW50ICh1c2VyLXNldCwgb3IgYXQgbGVhc3QgdXNlci1tZWFuaW5nZnVsKSAqL1xuICByZWFkb25seSBuYW1lOiBzdHJpbmc7XG5cbiAgLyoqIFRoZSAxMi1kaWdpdCBBV1MgYWNjb3VudCBJRCBmb3IgdGhlIGFjY291bnQgdGhpcyBlbnZpcm9ubWVudCBkZXBsb3lzIGludG8gKi9cbiAgcmVhZG9ubHkgYWNjb3VudDogc3RyaW5nO1xuXG4gIC8qKiBUaGUgQVdTIHJlZ2lvbiBuYW1lIHdoZXJlIHRoaXMgZW52aXJvbm1lbnQgZGVwbG95cyBpbnRvICovXG4gIHJlYWRvbmx5IHJlZ2lvbjogc3RyaW5nO1xufVxuXG5leHBvcnQgY2xhc3MgRW52aXJvbm1lbnRVdGlscyB7XG4gIHB1YmxpYyBzdGF0aWMgcGFyc2UoZW52aXJvbm1lbnQ6IHN0cmluZyk6IEVudmlyb25tZW50IHtcbiAgICBjb25zdCBlbnYgPSBBV1NfRU5WX1JFR0VYLmV4ZWMoZW52aXJvbm1lbnQpO1xuICAgIGlmICghZW52KSB7XG4gICAgICB0aHJvdyBuZXcgRXJyb3IoXG4gICAgICAgIGBVbmFibGUgdG8gcGFyc2UgZW52aXJvbm1lbnQgc3BlY2lmaWNhdGlvbiBcIiR7ZW52aXJvbm1lbnR9XCIuIGAgK1xuICAgICAgICBgRXhwZWN0ZWQgZm9ybWF0OiBhd3M6Ly9hY291bnQvcmVnaW9uYCk7XG4gICAgfVxuXG4gICAgY29uc3QgWyAsIGFjY291bnQsIHJlZ2lvbiBdID0gZW52O1xuICAgIGlmICghYWNjb3VudCB8fCAhcmVnaW9uKSB7XG4gICAgICB0aHJvdyBuZXcgRXJyb3IoYEludmFsaWQgZW52aXJvbm1lbnQgc3BlY2lmaWNhdGlvbjogJHtlbnZpcm9ubWVudH1gKTtcbiAgICB9XG5cbiAgICByZXR1cm4geyBhY2NvdW50LCByZWdpb24sIG5hbWU6IGVudmlyb25tZW50IH07XG4gIH1cblxuICBwdWJsaWMgc3RhdGljIGZvcm1hdChhY2NvdW50OiBzdHJpbmcsIHJlZ2lvbjogc3RyaW5nKTogc3RyaW5nIHtcbiAgICByZXR1cm4gYGF3czovLyR7YWNjb3VudH0vJHtyZWdpb259YDtcbiAgfVxufVxuIl19

lib/index.d.ts

 export * from './cxapi';
-export * from './environment';
 export * from './context/hosted-zone';
@@ -7,4 +6,7 @@ export * from './context/vpc';
 export * from './context/availability-zones';
-export * from './metadata/assets';
-export * from './artifacts';
-export * from './build';
+export * from './cloud-artifact';
+export * from './cloudformation-artifact';
+export * from './cloud-assembly';
+export * from './assets';
+export * from './environment';
+export * from './metadata';

lib/index.js

@@ -11,5 +11,8 @@ "use strict";
 __export(require("./context/availability-zones"));
-__export(require("./metadata/assets"));
-__export(require("./artifacts"));
-__export(require("./build"));
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJpbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7OztBQUFBLDZCQUF3QjtBQUV4QiwyQ0FBc0M7QUFDdEMsbUNBQThCO0FBQzlCLDZDQUF3QztBQUN4QyxrREFBNkM7QUFDN0MsdUNBQWtDO0FBQ2xDLGlDQUE0QjtBQUM1Qiw2QkFBd0IiLCJzb3VyY2VzQ29udGVudCI6WyJleHBvcnQgKiBmcm9tICcuL2N4YXBpJztcbmV4cG9ydCAqIGZyb20gJy4vZW52aXJvbm1lbnQnO1xuZXhwb3J0ICogZnJvbSAnLi9jb250ZXh0L2hvc3RlZC16b25lJztcbmV4cG9ydCAqIGZyb20gJy4vY29udGV4dC92cGMnO1xuZXhwb3J0ICogZnJvbSAnLi9jb250ZXh0L3NzbS1wYXJhbWV0ZXInO1xuZXhwb3J0ICogZnJvbSAnLi9jb250ZXh0L2F2YWlsYWJpbGl0eS16b25lcyc7XG5leHBvcnQgKiBmcm9tICcuL21ldGFkYXRhL2Fzc2V0cyc7XG5leHBvcnQgKiBmcm9tICcuL2FydGlmYWN0cyc7XG5leHBvcnQgKiBmcm9tICcuL2J1aWxkJztcbiJdfQ==
+__export(require("./cloud-artifact"));
+__export(require("./cloudformation-artifact"));
+__export(require("./cloud-assembly"));
+__export(require("./assets"));
+__export(require("./environment"));
+__export(require("./metadata"));
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJpbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7OztBQUFBLDZCQUF3QjtBQUN4QiwyQ0FBc0M7QUFDdEMsbUNBQThCO0FBQzlCLDZDQUF3QztBQUN4QyxrREFBNkM7QUFDN0Msc0NBQWlDO0FBQ2pDLCtDQUEwQztBQUMxQyxzQ0FBaUM7QUFDakMsOEJBQXlCO0FBQ3pCLG1DQUE4QjtBQUM5QixnQ0FBMkIiLCJzb3VyY2VzQ29udGVudCI6WyJleHBvcnQgKiBmcm9tICcuL2N4YXBpJztcbmV4cG9ydCAqIGZyb20gJy4vY29udGV4dC9ob3N0ZWQtem9uZSc7XG5leHBvcnQgKiBmcm9tICcuL2NvbnRleHQvdnBjJztcbmV4cG9ydCAqIGZyb20gJy4vY29udGV4dC9zc20tcGFyYW1ldGVyJztcbmV4cG9ydCAqIGZyb20gJy4vY29udGV4dC9hdmFpbGFiaWxpdHktem9uZXMnO1xuZXhwb3J0ICogZnJvbSAnLi9jbG91ZC1hcnRpZmFjdCc7XG5leHBvcnQgKiBmcm9tICcuL2Nsb3VkZm9ybWF0aW9uLWFydGlmYWN0JztcbmV4cG9ydCAqIGZyb20gJy4vY2xvdWQtYXNzZW1ibHknO1xuZXhwb3J0ICogZnJvbSAnLi9hc3NldHMnO1xuZXhwb3J0ICogZnJvbSAnLi9lbnZpcm9ubWVudCc7XG5leHBvcnQgKiBmcm9tICcuL21ldGFkYXRhJztcbiJdfQ==

package.json

 {
   "name": "@aws-cdk/cx-api",
-  "version": "0.32.0",
+  "version": "0.33.0",
   "description": "Cloud executable protocol",
@@ -45,6 +45,23 @@ "main": "lib/index.js",
   },
+  "dependencies": {
+    "semver": "^6.0.0"
+  },
+  "jest": {
+    "moduleFileExtensions": [
+      "js"
+    ],
+    "coverageThreshold": {
+      "global": {
+        "branches": 80,
+        "statements": 80
+      }
+    }
+  },
   "license": "Apache-2.0",
   "devDependencies": {
-    "cdk-build-tools": "^0.32.0",
-    "pkglint": "^0.32.0"
+    "@types/jest": "^24.0.11",
+    "@types/semver": "^6.0.0",
+    "cdk-build-tools": "^0.33.0",
+    "jest": "^24.7.1",
+    "pkglint": "^0.33.0"
   },
@@ -61,2 +78,5 @@ "repository": {
   "homepage": "https://github.com/awslabs/aws-cdk",
+  "bundledDependencies": [
+    "semver"
+  ],
   "engines": {
@@ -63,0 +83,0 @@ "node": ">= 8.10.0"

New alerts

License Policy Violation

License

This package is not allowed per your license policy. Review the package's license to ensure compliance.

Found 1 instance in 1 package

Major refactor

Supply chain risk

Package has recently undergone a major refactor. It may be unstable or indicate significant internal changes. Use caution when updating to versions that include significant changes.

Found 1 instance in 1 package

Filesystem access

Supply chain risk

Accesses the file system, and could potentially read sensitive data.

Found 1 instance in 1 package

Mixed license

License

(Experimental) Package contains multiple licenses.

Found 1 instance in 1 package

Fixed alerts

License Policy Violation

License

This package is not allowed per your license policy. Review the package's license to ensure compliance.

Found 1 instance in 1 package

Improved metrics

Total package byte prevSize

251152

increased by163.85%

Number of package files

69

increased by165.38%

Lines of code

2814

increased by310.8%

Worsened metrics

Dependency count

1

increased byInfinity%

Dev dependency count

5

increased by150%

Number of low license alerts

1

increased byInfinity%

Number of low supply chain risk alerts

2

increased byInfinity%

Number of medium supply chain risk alerts

1

increased byInfinity%

Dependency changes

• + Addedsemver@^6.0.0