@aws-cdk/cloud-assembly-api 0.0.1 → 2.0.0

package/lib/cloud-artifact.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CloudArtifact = void 0;
+const cxschema = require("@aws-cdk/cloud-assembly-schema");
+const metadata_1 = require("./metadata");
+const error_1 = require("./private/error");
+/**
+ * Represents an artifact within a cloud assembly.
+ */
+class CloudArtifact {
+    /**
+     * Returns a subclass of `CloudArtifact` based on the artifact type defined in the artifact manifest.
+     *
+     * @param assembly - The cloud assembly from which to load the artifact
+     * @param id - The artifact ID
+     * @param artifact - The artifact manifest
+     * @returns the `CloudArtifact` that matches the artifact type or `undefined` if it's an artifact type that is unrecognized by this module.
+     */
+    static fromManifest(assembly, id, artifact) {
+        // Implementation is defined in a separate file to break cyclic dependencies
+        void (assembly), void (id), void (artifact);
+        throw new error_1.CloudAssemblyError('Implementation not overridden yet');
+    }
+    constructor(assembly, id, manifest) {
+        this.assembly = assembly;
+        this.id = id;
+        this.manifest = manifest;
+        this.messages = this.renderMessages();
+        this._dependencyIDs = manifest.dependencies || [];
+    }
+    /**
+     * Returns all the artifacts that this artifact depends on.
+     */
+    get dependencies() {
+        if (this._deps) {
+            return this._deps;
+        }
+        this._deps = this._dependencyIDs.map(id => {
+            const dep = this.assembly.tryGetArtifact(id);
+            if (!dep) {
+                throw new error_1.CloudAssemblyError(`Artifact ${this.id} depends on non-existing artifact ${id}`);
+            }
+            return dep;
+        });
+        return this._deps;
+    }
+    /**
+     * @returns all the metadata entries of a specific type in this artifact.
+     */
+    findMetadataByType(type) {
+        const result = new Array();
+        for (const path of Object.keys(this.manifest.metadata || {})) {
+            for (const entry of (this.manifest.metadata || {})[path]) {
+                if (entry.type === type) {
+                    result.push({ path, ...entry });
+                }
+            }
+        }
+        return result;
+    }
+    renderMessages() {
+        const messages = new Array();
+        for (const [id, metadata] of Object.entries(this.manifest.metadata || {})) {
+            for (const entry of metadata) {
+                let level;
+                switch (entry.type) {
+                    case cxschema.ArtifactMetadataEntryType.WARN:
+                        level = metadata_1.SynthesisMessageLevel.WARNING;
+                        break;
+                    case cxschema.ArtifactMetadataEntryType.ERROR:
+                        level = metadata_1.SynthesisMessageLevel.ERROR;
+                        break;
+                    case cxschema.ArtifactMetadataEntryType.INFO:
+                        level = metadata_1.SynthesisMessageLevel.INFO;
+                        break;
+                    default:
+                        continue;
+                }
+                messages.push({ level, entry, id });
+            }
+        }
+        return messages;
+    }
+    /**
+     * An identifier that shows where this artifact is located in the tree
+     * of nested assemblies, based on their manifests. Defaults to the normal
+     * id. Should only be used in user interfaces.
+     */
+    get hierarchicalId() {
+        return this.manifest.displayName ?? this.id;
+    }
+}
+exports.CloudArtifact = CloudArtifact;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xvdWQtYXJ0aWZhY3QuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJjbG91ZC1hcnRpZmFjdC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQSwyREFBMkQ7QUFHM0QseUNBQW1EO0FBQ25ELDJDQUFxRDtBQThCckQ7O0dBRUc7QUFDSCxNQUFhLGFBQWE7SUFDeEI7Ozs7Ozs7T0FPRztJQUNJLE1BQU0sQ0FBQyxZQUFZLENBQUMsUUFBdUIsRUFBRSxFQUFVLEVBQUUsUUFBbUM7UUFDakcsNEVBQTRFO1FBQzVFLEtBQUksQ0FBQyxRQUFRLENBQUMsRUFBRSxLQUFJLENBQUMsRUFBRSxDQUFDLEVBQUUsS0FBSSxDQUFDLFFBQVEsQ0FBQyxDQUFDO1FBQ3pDLE1BQU0sSUFBSSwwQkFBa0IsQ0FBQyxtQ0FBbUMsQ0FBQyxDQUFDO0lBQ3BFLENBQUM7SUF1QkQsWUFBc0MsUUFBdUIsRUFBa0IsRUFBVSxFQUFFLFFBQW1DO1FBQXhGLGFBQVEsR0FBUixRQUFRLENBQWU7UUFBa0IsT0FBRSxHQUFGLEVBQUUsQ0FBUTtRQUN2RixJQUFJLENBQUMsUUFBUSxHQUFHLFFBQVEsQ0FBQztRQUN6QixJQUFJLENBQUMsUUFBUSxHQUFHLElBQUksQ0FBQyxjQUFjLEVBQUUsQ0FBQztRQUN0QyxJQUFJLENBQUMsY0FBYyxHQUFHLFFBQVEsQ0FBQyxZQUFZLElBQUksRUFBRSxDQUFDO0lBQ3BELENBQUM7SUFFRDs7T0FFRztJQUNILElBQVcsWUFBWTtRQUNyQixJQUFJLElBQUksQ0FBQyxLQUFLLEVBQUUsQ0FBQztZQUNmLE9BQU8sSUFBSSxDQUFDLEtBQUssQ0FBQztRQUNwQixDQUFDO1FBRUQsSUFBSSxDQUFDLEtBQUssR0FBRyxJQUFJLENBQUMsY0FBYyxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUMsRUFBRTtZQUN4QyxNQUFNLEdBQUcsR0FBRyxJQUFJLENBQUMsUUFBUSxDQUFDLGNBQWMsQ0FBQyxFQUFFLENBQUMsQ0FBQztZQUM3QyxJQUFJLENBQUMsR0FBRyxFQUFFLENBQUM7Z0JBQ1QsTUFBTSxJQUFJLDBCQUFrQixDQUFDLFlBQVksSUFBSSxDQUFDLEVBQUUscUNBQXFDLEVBQUUsRUFBRSxDQUFDLENBQUM7WUFDN0YsQ0FBQztZQUNELE9BQU8sR0FBRyxDQUFDO1FBQ2IsQ0FBQyxDQUFDLENBQUM7UUFFSCxPQUFPLElBQUksQ0FBQyxLQUFLLENBQUM7SUFDcEIsQ0FBQztJQUVEOztPQUVHO0lBQ0ksa0JBQWtCLENBQUMsSUFBWTtRQUNwQyxNQUFNLE1BQU0sR0FBRyxJQUFJLEtBQUssRUFBdUIsQ0FBQztRQUNoRCxLQUFLLE1BQU0sSUFBSSxJQUFJLE1BQU0sQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLFFBQVEsQ0FBQyxRQUFRLElBQUksRUFBRSxDQUFDLEVBQUUsQ0FBQztZQUM3RCxLQUFLLE1BQU0sS0FBSyxJQUFJLENBQUMsSUFBSSxDQUFDLFFBQVEsQ0FBQyxRQUFRLElBQUksRUFBRSxDQUFDLENBQUMsSUFBSSxDQUFDLEVBQUUsQ0FBQztnQkFDekQsSUFBSSxLQUFLLENBQUMsSUFBSSxLQUFLLElBQUksRUFBRSxDQUFDO29CQUN4QixNQUFNLENBQUMsSUFBSSxDQUFDLEVBQUUsSUFBSSxFQUFFLEdBQUcsS0FBSyxFQUFFLENBQUMsQ0FBQztnQkFDbEMsQ0FBQztZQUNILENBQUM7UUFDSCxDQUFDO1FBQ0QsT0FBTyxNQUFNLENBQUM7SUFDaEIsQ0FBQztJQUVPLGNBQWM7UUFDcEIsTUFBTSxRQUFRLEdBQUcsSUFBSSxLQUFLLEVBQW9CLENBQUM7UUFFL0MsS0FBSyxNQUFNLENBQUMsRUFBRSxFQUFFLFFBQVEsQ0FBQyxJQUFJLE1BQU0sQ0FBQyxPQUFPLENBQUMsSUFBSSxDQUFDLFFBQVEsQ0FBQyxRQUFRLElBQUksRUFBRyxDQUFDLEVBQUUsQ0FBQztZQUMzRSxLQUFLLE1BQU0sS0FBSyxJQUFJLFFBQVEsRUFBRSxDQUFDO2dCQUM3QixJQUFJLEtBQTRCLENBQUM7Z0JBQ2pDLFFBQVEsS0FBSyxDQUFDLElBQUksRUFBRSxDQUFDO29CQUNuQixLQUFLLFFBQVEsQ0FBQyx5QkFBeUIsQ0FBQyxJQUFJO3dCQUMxQyxLQUFLLEdBQUcsZ0NBQXFCLENBQUMsT0FBTyxDQUFDO3dCQUN0QyxNQUFNO29CQUNSLEtBQUssUUFBUSxDQUFDLHlCQUF5QixDQUFDLEtBQUs7d0JBQzNDLEtBQUssR0FBRyxnQ0FBcUIsQ0FBQyxLQUFLLENBQUM7d0JBQ3BDLE1BQU07b0JBQ1IsS0FBSyxRQUFRLENBQUMseUJBQXlCLENBQUMsSUFBSTt3QkFDMUMsS0FBSyxHQUFHLGdDQUFxQixDQUFDLElBQUksQ0FBQzt3QkFDbkMsTUFBTTtvQkFDUjt3QkFDRSxTQUFTO2dCQUNiLENBQUM7Z0JBRUQsUUFBUSxDQUFDLElBQUksQ0FBQyxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsRUFBRSxFQUFFLENBQUMsQ0FBQztZQUN0QyxDQUFDO1FBQ0gsQ0FBQztRQUVELE9BQU8sUUFBUSxDQUFDO0lBQ2xCLENBQUM7SUFFRDs7OztPQUlHO0lBQ0gsSUFBVyxjQUFjO1FBQ3ZCLE9BQU8sSUFBSSxDQUFDLFFBQVEsQ0FBQyxXQUFXLElBQUksSUFBSSxDQUFDLEVBQUUsQ0FBQztJQUM5QyxDQUFDO0NBQ0Y7QUEvR0Qsc0NBK0dDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0ICogYXMgY3hzY2hlbWEgZnJvbSAnQGF3cy1jZGsvY2xvdWQtYXNzZW1ibHktc2NoZW1hJztcbmltcG9ydCB0eXBlIHsgQ2xvdWRBc3NlbWJseSB9IGZyb20gJy4vY2xvdWQtYXNzZW1ibHknO1xuaW1wb3J0IHR5cGUgeyBNZXRhZGF0YUVudHJ5UmVzdWx0LCBTeW50aGVzaXNNZXNzYWdlIH0gZnJvbSAnLi9tZXRhZGF0YSc7XG5pbXBvcnQgeyBTeW50aGVzaXNNZXNzYWdlTGV2ZWwgfSBmcm9tICcuL21ldGFkYXRhJztcbmltcG9ydCB7IENsb3VkQXNzZW1ibHlFcnJvciB9IGZyb20gJy4vcHJpdmF0ZS9lcnJvcic7XG5cbi8qKlxuICogQXJ0aWZhY3QgcHJvcGVydGllcyBmb3IgQ2xvdWRGb3JtYXRpb24gc3RhY2tzLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIEF3c0Nsb3VkRm9ybWF0aW9uU3RhY2tQcm9wZXJ0aWVzIHtcbiAgLyoqXG4gICAqIEEgZmlsZSByZWxhdGl2ZSB0byB0aGUgYXNzZW1ibHkgcm9vdCB3aGljaCBjb250YWlucyB0aGUgQ2xvdWRGb3JtYXRpb24gdGVtcGxhdGUgZm9yIHRoaXMgc3RhY2suXG4gICAqL1xuICByZWFkb25seSB0ZW1wbGF0ZUZpbGU6IHN0cmluZztcblxuICAvKipcbiAgICogVmFsdWVzIGZvciBDbG91ZEZvcm1hdGlvbiBzdGFjayBwYXJhbWV0ZXJzIHRoYXQgc2hvdWxkIGJlIHBhc3NlZCB3aGVuIHRoZSBzdGFjayBpcyBkZXBsb3llZC5cbiAgICovXG4gIHJlYWRvbmx5IHBhcmFtZXRlcnM/OiB7IFtpZDogc3RyaW5nXTogc3RyaW5nIH07XG5cbiAgLyoqXG4gICAqIFRoZSBuYW1lIHRvIHVzZSBmb3IgdGhlIENsb3VkRm9ybWF0aW9uIHN0YWNrLlxuICAgKiBAZGVmYXVsdCAtIG5hbWUgZGVyaXZlZCBmcm9tIGFydGlmYWN0IElEXG4gICAqL1xuICByZWFkb25seSBzdGFja05hbWU/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIFdoZXRoZXIgdG8gZW5hYmxlIHRlcm1pbmF0aW9uIHByb3RlY3Rpb24gZm9yIHRoaXMgc3RhY2suXG4gICAqXG4gICAqIEBkZWZhdWx0IGZhbHNlXG4gICAqL1xuICByZWFkb25seSB0ZXJtaW5hdGlvblByb3RlY3Rpb24/OiBib29sZWFuO1xufVxuXG4vKipcbiAqIFJlcHJlc2VudHMgYW4gYXJ0aWZhY3Qgd2l0aGluIGEgY2xvdWQgYXNzZW1ibHkuXG4gKi9cbmV4cG9ydCBjbGFzcyBDbG91ZEFydGlmYWN0IHtcbiAgLyoqXG4gICAqIFJldHVybnMgYSBzdWJjbGFzcyBvZiBgQ2xvdWRBcnRpZmFjdGAgYmFzZWQgb24gdGhlIGFydGlmYWN0IHR5cGUgZGVmaW5lZCBpbiB0aGUgYXJ0aWZhY3QgbWFuaWZlc3QuXG4gICAqXG4gICAqIEBwYXJhbSBhc3NlbWJseSAtIFRoZSBjbG91ZCBhc3NlbWJseSBmcm9tIHdoaWNoIHRvIGxvYWQgdGhlIGFydGlmYWN0XG4gICAqIEBwYXJhbSBpZCAtIFRoZSBhcnRpZmFjdCBJRFxuICAgKiBAcGFyYW0gYXJ0aWZhY3QgLSBUaGUgYXJ0aWZhY3QgbWFuaWZlc3RcbiAgICogQHJldHVybnMgdGhlIGBDbG91ZEFydGlmYWN0YCB0aGF0IG1hdGNoZXMgdGhlIGFydGlmYWN0IHR5cGUgb3IgYHVuZGVmaW5lZGAgaWYgaXQncyBhbiBhcnRpZmFjdCB0eXBlIHRoYXQgaXMgdW5yZWNvZ25pemVkIGJ5IHRoaXMgbW9kdWxlLlxuICAgKi9cbiAgcHVibGljIHN0YXRpYyBmcm9tTWFuaWZlc3QoYXNzZW1ibHk6IENsb3VkQXNzZW1ibHksIGlkOiBzdHJpbmcsIGFydGlmYWN0OiBjeHNjaGVtYS5BcnRpZmFjdE1hbmlmZXN0KTogQ2xvdWRBcnRpZmFjdCB8IHVuZGVmaW5lZCB7XG4gICAgLy8gSW1wbGVtZW50YXRpb24gaXMgZGVmaW5lZCBpbiBhIHNlcGFyYXRlIGZpbGUgdG8gYnJlYWsgY3ljbGljIGRlcGVuZGVuY2llc1xuICAgIHZvaWQoYXNzZW1ibHkpLCB2b2lkKGlkKSwgdm9pZChhcnRpZmFjdCk7XG4gICAgdGhyb3cgbmV3IENsb3VkQXNzZW1ibHlFcnJvcignSW1wbGVtZW50YXRpb24gbm90IG92ZXJyaWRkZW4geWV0Jyk7XG4gIH1cblxuICAvKipcbiAgICogVGhlIGFydGlmYWN0J3MgbWFuaWZlc3RcbiAgICovXG4gIHB1YmxpYyByZWFkb25seSBtYW5pZmVzdDogY3hzY2hlbWEuQXJ0aWZhY3RNYW5pZmVzdDtcblxuICAvKipcbiAgICogVGhlIHNldCBvZiBtZXNzYWdlcyBleHRyYWN0ZWQgZnJvbSB0aGUgYXJ0aWZhY3QncyBtZXRhZGF0YS5cbiAgICovXG4gIHB1YmxpYyByZWFkb25seSBtZXNzYWdlczogU3ludGhlc2lzTWVzc2FnZVtdO1xuXG4gIC8qKlxuICAgKiBJRHMgb2YgYWxsIGRlcGVuZGVuY2llcy4gVXNlZCB3aGVuIHRvcG9sb2dpY2FsbHkgc29ydGluZyB0aGUgYXJ0aWZhY3RzIHdpdGhpbiB0aGUgY2xvdWQgYXNzZW1ibHkuXG4gICAqIEBpbnRlcm5hbFxuICAgKi9cbiAgcHVibGljIHJlYWRvbmx5IF9kZXBlbmRlbmN5SURzOiBzdHJpbmdbXTtcblxuICAvKipcbiAgICogQ2FjaGUgb2YgcmVzb2x2ZWQgZGVwZW5kZW5jaWVzLlxuICAgKi9cbiAgcHJpdmF0ZSBfZGVwcz86IENsb3VkQXJ0aWZhY3RbXTtcblxuICBwcm90ZWN0ZWQgY29uc3RydWN0b3IocHVibGljIHJlYWRvbmx5IGFzc2VtYmx5OiBDbG91ZEFzc2VtYmx5LCBwdWJsaWMgcmVhZG9ubHkgaWQ6IHN0cmluZywgbWFuaWZlc3Q6IGN4c2NoZW1hLkFydGlmYWN0TWFuaWZlc3QpIHtcbiAgICB0aGlzLm1hbmlmZXN0ID0gbWFuaWZlc3Q7XG4gICAgdGhpcy5tZXNzYWdlcyA9IHRoaXMucmVuZGVyTWVzc2FnZXMoKTtcbiAgICB0aGlzLl9kZXBlbmRlbmN5SURzID0gbWFuaWZlc3QuZGVwZW5kZW5jaWVzIHx8IFtdO1xuICB9XG5cbiAgLyoqXG4gICAqIFJldHVybnMgYWxsIHRoZSBhcnRpZmFjdHMgdGhhdCB0aGlzIGFydGlmYWN0IGRlcGVuZHMgb24uXG4gICAqL1xuICBwdWJsaWMgZ2V0IGRlcGVuZGVuY2llcygpOiBDbG91ZEFydGlmYWN0W10ge1xuICAgIGlmICh0aGlzLl9kZXBzKSB7XG4gICAgICByZXR1cm4gdGhpcy5fZGVwcztcbiAgICB9XG5cbiAgICB0aGlzLl9kZXBzID0gdGhpcy5fZGVwZW5kZW5jeUlEcy5tYXAoaWQgPT4ge1xuICAgICAgY29uc3QgZGVwID0gdGhpcy5hc3NlbWJseS50cnlHZXRBcnRpZmFjdChpZCk7XG4gICAgICBpZiAoIWRlcCkge1xuICAgICAgICB0aHJvdyBuZXcgQ2xvdWRBc3NlbWJseUVycm9yKGBBcnRpZmFjdCAke3RoaXMuaWR9IGRlcGVuZHMgb24gbm9uLWV4aXN0aW5nIGFydGlmYWN0ICR7aWR9YCk7XG4gICAgICB9XG4gICAgICByZXR1cm4gZGVwO1xuICAgIH0pO1xuXG4gICAgcmV0dXJuIHRoaXMuX2RlcHM7XG4gIH1cblxuICAvKipcbiAgICogQHJldHVybnMgYWxsIHRoZSBtZXRhZGF0YSBlbnRyaWVzIG9mIGEgc3BlY2lmaWMgdHlwZSBpbiB0aGlzIGFydGlmYWN0LlxuICAgKi9cbiAgcHVibGljIGZpbmRNZXRhZGF0YUJ5VHlwZSh0eXBlOiBzdHJpbmcpOiBNZXRhZGF0YUVudHJ5UmVzdWx0W10ge1xuICAgIGNvbnN0IHJlc3VsdCA9IG5ldyBBcnJheTxNZXRhZGF0YUVudHJ5UmVzdWx0PigpO1xuICAgIGZvciAoY29uc3QgcGF0aCBvZiBPYmplY3Qua2V5cyh0aGlzLm1hbmlmZXN0Lm1ldGFkYXRhIHx8IHt9KSkge1xuICAgICAgZm9yIChjb25zdCBlbnRyeSBvZiAodGhpcy5tYW5pZmVzdC5tZXRhZGF0YSB8fCB7fSlbcGF0aF0pIHtcbiAgICAgICAgaWYgKGVudHJ5LnR5cGUgPT09IHR5cGUpIHtcbiAgICAgICAgICByZXN1bHQucHVzaCh7IHBhdGgsIC4uLmVudHJ5IH0pO1xuICAgICAgICB9XG4gICAgICB9XG4gICAgfVxuICAgIHJldHVybiByZXN1bHQ7XG4gIH1cblxuICBwcml2YXRlIHJlbmRlck1lc3NhZ2VzKCkge1xuICAgIGNvbnN0IG1lc3NhZ2VzID0gbmV3IEFycmF5PFN5bnRoZXNpc01lc3NhZ2U+KCk7XG5cbiAgICBmb3IgKGNvbnN0IFtpZCwgbWV0YWRhdGFdIG9mIE9iamVjdC5lbnRyaWVzKHRoaXMubWFuaWZlc3QubWV0YWRhdGEgfHwgeyB9KSkge1xuICAgICAgZm9yIChjb25zdCBlbnRyeSBvZiBtZXRhZGF0YSkge1xuICAgICAgICBsZXQgbGV2ZWw6IFN5bnRoZXNpc01lc3NhZ2VMZXZlbDtcbiAgICAgICAgc3dpdGNoIChlbnRyeS50eXBlKSB7XG4gICAgICAgICAgY2FzZSBjeHNjaGVtYS5BcnRpZmFjdE1ldGFkYXRhRW50cnlUeXBlLldBUk46XG4gICAgICAgICAgICBsZXZlbCA9IFN5bnRoZXNpc01lc3NhZ2VMZXZlbC5XQVJOSU5HO1xuICAgICAgICAgICAgYnJlYWs7XG4gICAgICAgICAgY2FzZSBjeHNjaGVtYS5BcnRpZmFjdE1ldGFkYXRhRW50cnlUeXBlLkVSUk9SOlxuICAgICAgICAgICAgbGV2ZWwgPSBTeW50aGVzaXNNZXNzYWdlTGV2ZWwuRVJST1I7XG4gICAgICAgICAgICBicmVhaztcbiAgICAgICAgICBjYXNlIGN4c2NoZW1hLkFydGlmYWN0TWV0YWRhdGFFbnRyeVR5cGUuSU5GTzpcbiAgICAgICAgICAgIGxldmVsID0gU3ludGhlc2lzTWVzc2FnZUxldmVsLklORk87XG4gICAgICAgICAgICBicmVhaztcbiAgICAgICAgICBkZWZhdWx0OlxuICAgICAgICAgICAgY29udGludWU7XG4gICAgICAgIH1cblxuICAgICAgICBtZXNzYWdlcy5wdXNoKHsgbGV2ZWwsIGVudHJ5LCBpZCB9KTtcbiAgICAgIH1cbiAgICB9XG5cbiAgICByZXR1cm4gbWVzc2FnZXM7XG4gIH1cblxuICAvKipcbiAgICogQW4gaWRlbnRpZmllciB0aGF0IHNob3dzIHdoZXJlIHRoaXMgYXJ0aWZhY3QgaXMgbG9jYXRlZCBpbiB0aGUgdHJlZVxuICAgKiBvZiBuZXN0ZWQgYXNzZW1ibGllcywgYmFzZWQgb24gdGhlaXIgbWFuaWZlc3RzLiBEZWZhdWx0cyB0byB0aGUgbm9ybWFsXG4gICAqIGlkLiBTaG91bGQgb25seSBiZSB1c2VkIGluIHVzZXIgaW50ZXJmYWNlcy5cbiAgICovXG4gIHB1YmxpYyBnZXQgaGllcmFyY2hpY2FsSWQoKTogc3RyaW5nIHtcbiAgICByZXR1cm4gdGhpcy5tYW5pZmVzdC5kaXNwbGF5TmFtZSA/PyB0aGlzLmlkO1xuICB9XG59XG4iXX0=

package/lib/cloud-assembly.d.ts

@@ -0,0 +1,266 @@
+import type { ICloudAssembly } from '@aws-cdk/cloud-assembly-schema';
+import * as cxschema from '@aws-cdk/cloud-assembly-schema/lib';
+import { CloudFormationStackArtifact } from './artifacts/cloudformation-artifact';
+import { NestedCloudAssemblyArtifact } from './artifacts/nested-cloud-assembly-artifact';
+import { TreeCloudArtifact } from './artifacts/tree-cloud-artifact';
+import { CloudArtifact } from './cloud-artifact';
+/**
+ * Represents a deployable cloud application.
+ */
+export declare class CloudAssembly implements ICloudAssembly {
+    /**
+     * Return whether the given object is a CloudAssembly.
+     *
+     * We do attribute detection since we can't reliably use 'instanceof'.
+     */
+    static isCloudAssembly(x: any): x is CloudAssembly;
+    /**
+     * Cleans up any temporary assembly directories that got created in this process
+     *
+     * If a Cloud Assembly is emitted to a temporary directory, its directory gets
+     * added to a list. This function iterates over that list and deletes each
+     * directory in it, to free up disk space.
+     *
+     * This function will normally be called automatically during Node process
+     * exit and so you don't need to call this. However, some test environments do
+     * not properly trigger Node's `exit` event. Notably: Jest does not trigger
+     * the `exit` event (<https://github.com/jestjs/jest/issues/10927>).
+     *
+     * ## Cleaning up temporary directories in jest
+     *
+     * For Jest, you have to make sure this function is called at the end of the
+     * test suite instead:
+     *
+     * ```js
+     * import { CloudAssembly } from 'aws-cdk-lib/cx-api';
+     *
+     * afterAll(CloudAssembly.cleanupTemporaryDirectories);
+     * ```
+     *
+     * Alternatively, you can use the `setupFilesAfterEnv` feature and use a
+     * provided helper script to automatically inject the above into every
+     * test file, so you don't have to do it by hand.
+     *
+     * ```
+     * $ npx jest --setupFilesAfterEnv aws-cdk-lib/testhelpers/jest-autoclean
+     * ```
+     *
+     * Or put the following into `jest.config.js`:
+     *
+     * ```js
+     * module.exports = {
+     *   // ...
+     *   setupFilesAfterEnv: ['aws-cdk-lib/testhelpers/jest-cleanup'],
+     * };
+     * ```
+     */
+    static cleanupTemporaryDirectories(): void;
+    /**
+     * The root directory of the cloud assembly.
+     */
+    readonly directory: string;
+    /**
+     * The schema version of the assembly manifest.
+     */
+    readonly version: string;
+    /**
+     * All artifacts included in this assembly.
+     */
+    readonly artifacts: CloudArtifact[];
+    /**
+     * Runtime information such as module versions used to synthesize this assembly.
+     */
+    readonly runtime: cxschema.RuntimeInfo;
+    /**
+     * The raw assembly manifest.
+     */
+    readonly manifest: cxschema.AssemblyManifest;
+    /**
+     * Reads a cloud assembly from the specified directory.
+     * @param directory - The root directory of the assembly.
+     */
+    constructor(directory: string, loadOptions?: cxschema.LoadManifestOptions);
+    /**
+     * Attempts to find an artifact with a specific identity.
+     * @returns A `CloudArtifact` object or `undefined` if the artifact does not exist in this assembly.
+     * @param id - The artifact ID
+     */
+    tryGetArtifact(id: string): CloudArtifact | undefined;
+    /**
+     * Returns a CloudFormation stack artifact from this assembly.
+     *
+     * Will only search the current assembly.
+     *
+     * @param stackName - the name of the CloudFormation stack.
+     * @throws if there is no stack artifact by that name
+     * @throws if there is more than one stack with the same stack name. You can
+     * use `getStackArtifact(stack.artifactId)` instead.
+     * @returns a `CloudFormationStackArtifact` object.
+     */
+    getStackByName(stackName: string): CloudFormationStackArtifact;
+    /**
+     * Returns a CloudFormation stack artifact by name from this assembly.
+     * @deprecated renamed to `getStackByName` (or `getStackArtifact(id)`)
+     */
+    getStack(stackName: string): CloudFormationStackArtifact;
+    /**
+     * Returns a CloudFormation stack artifact from this assembly.
+     *
+     * @param artifactId - the artifact id of the stack (can be obtained through `stack.artifactId`).
+     * @throws if there is no stack artifact with that id
+     * @returns a `CloudFormationStackArtifact` object.
+     */
+    getStackArtifact(artifactId: string): CloudFormationStackArtifact;
+    private tryGetArtifactRecursively;
+    /**
+     * Returns all the stacks, including the ones in nested assemblies
+     */
+    get stacksRecursively(): CloudFormationStackArtifact[];
+    /**
+     * Returns a nested assembly artifact.
+     *
+     * @param artifactId - The artifact ID of the nested assembly
+     */
+    getNestedAssemblyArtifact(artifactId: string): NestedCloudAssemblyArtifact;
+    /**
+     * Returns a nested assembly.
+     *
+     * @param artifactId - The artifact ID of the nested assembly
+     */
+    getNestedAssembly(artifactId: string): CloudAssembly;
+    /**
+     * Returns the tree metadata artifact from this assembly.
+     * @throws if there is no metadata artifact by that name
+     * @returns a `TreeCloudArtifact` object if there is one defined in the manifest, `undefined` otherwise.
+     */
+    tree(): TreeCloudArtifact | undefined;
+    /**
+     * @returns all the CloudFormation stack artifacts that are included in this assembly.
+     */
+    get stacks(): CloudFormationStackArtifact[];
+    /**
+     * The nested assembly artifacts in this assembly
+     */
+    get nestedAssemblies(): NestedCloudAssemblyArtifact[];
+    private validateDeps;
+    private renderArtifacts;
+}
+/**
+ * Construction properties for CloudAssemblyBuilder
+ */
+export interface CloudAssemblyBuilderProps {
+    /**
+     * Use the given asset output directory
+     *
+     * @default - Same as the manifest outdir
+     */
+    readonly assetOutdir?: string;
+    /**
+     * If this builder is for a nested assembly, the parent assembly builder
+     *
+     * @default - This is a root assembly
+     */
+    readonly parentBuilder?: CloudAssemblyBuilder;
+}
+/**
+ * Can be used to build a cloud assembly.
+ */
+export declare class CloudAssemblyBuilder {
+    /**
+     * The root directory of the resulting cloud assembly.
+     */
+    readonly outdir: string;
+    /**
+     * The directory where assets of this Cloud Assembly should be stored
+     */
+    readonly assetOutdir: string;
+    private readonly artifacts;
+    private readonly missing;
+    private readonly parentBuilder?;
+    /**
+     * Initializes a cloud assembly builder.
+     * @param outdir - The output directory, uses temporary directory if undefined
+     */
+    constructor(outdir?: string, props?: CloudAssemblyBuilderProps);
+    /**
+     * Adds an artifact into the cloud assembly.
+     * @param id - The ID of the artifact.
+     * @param manifest - The artifact manifest
+     */
+    addArtifact(id: string, manifest: cxschema.ArtifactManifest): void;
+    /**
+     * Reports that some context is missing in order for this cloud assembly to be fully synthesized.
+     * @param missing - Missing context information.
+     */
+    addMissing(missing: cxschema.MissingContext): void;
+    /**
+     * Finalizes the cloud assembly into the output directory returns a
+     * `CloudAssembly` object that can be used to inspect the assembly.
+     */
+    buildAssembly(options?: AssemblyBuildOptions): CloudAssembly;
+    /**
+     * Creates a nested cloud assembly
+     */
+    createNestedAssembly(artifactId: string, displayName: string): CloudAssemblyBuilder;
+    /**
+     * Delete the cloud assembly directory
+     */
+    delete(): void;
+}
+/**
+ * Backwards compatibility for when `RuntimeInfo`
+ * was defined here. This is necessary because its used as an input in the stable
+ * @aws-cdk/core library.
+ *
+ * @deprecated moved to package 'cloud-assembly-schema'
+ * @see core.ConstructNode.synth
+ */
+export interface RuntimeInfo extends cxschema.RuntimeInfo {
+}
+/**
+ * Backwards compatibility for when `MetadataEntry`
+ * was defined here. This is necessary because its used as an input in the stable
+ * @aws-cdk/core library.
+ *
+ * @deprecated moved to package 'cloud-assembly-schema'
+ * @see core.ConstructNode.metadata
+ */
+export interface MetadataEntry extends cxschema.MetadataEntry {
+}
+/**
+ * Backwards compatibility for when `MissingContext`
+ * was defined here. This is necessary because its used as an input in the stable
+ * @aws-cdk/core library.
+ *
+ * @deprecated moved to package 'cloud-assembly-schema'
+ * @see core.Stack.reportMissingContext
+ */
+export interface MissingContext {
+    /**
+     * The missing context key.
+     */
+    readonly key: string;
+    /**
+     * The provider from which we expect this context key to be obtained.
+     *
+     * (This is the old untyped definition, which is necessary for backwards compatibility.
+     * See cxschema for a type definition.)
+     */
+    readonly provider: string;
+    /**
+     * A set of provider-specific options.
+     *
+     * (This is the old untyped definition, which is necessary for backwards compatibility.
+     * See cxschema for a type definition.)
+     */
+    readonly props: Record<string, any>;
+}
+export interface AssemblyBuildOptions {
+    /**
+     * Include the specified runtime information (module versions) in manifest.
+     * @default - if this option is not specified, runtime info will not be included
+     * @deprecated All template modifications that should result from this should
+     * have already been inserted into the template.
+     */
+    readonly runtimeInfo?: RuntimeInfo;
+}