feat: decouple "synth" and "deploy" through cloud assemblies

.gitignore

@@ -26,3 +26,5 @@ coverage/
 # CDK Context & Staging files
 cdk.context.json
 .cdk.staging/
+cdk.out/
+

packages/@aws-cdk/applet-js/README.md

@@ -1,2 +1,5 @@
 ## AWS CDK applet host program for Javascript
+
+CDK applets have been deprecated in favor of [decdk](https://github.com/awslabs/aws-cdk/tree/master/packages/decdk).
+
 This module is part of the [AWS Cloud Development Kit](https://github.com/awslabs/aws-cdk) project.

packages/@aws-cdk/applet-js/bin/cdk-applet-js.ts

@@ -1,104 +1,3 @@
 #!/usr/bin/env node
-import 'source-map-support/register';
-
-import cdk = require('@aws-cdk/cdk');
-import child_process = require('child_process');
-import fs = require('fs-extra');
-import os = require('os');
-import path = require('path');
-import YAML = require('yaml');
-
-import { isStackConstructor, parseApplet } from '../lib/applet-helpers';
-
-main().catch(e => {
-  // tslint:disable-next-line:no-console
-  console.error(e);
-  process.exit(1);
-});
-
-async function main() {
-  const progname = path.basename(process.argv[1]);
-
-  const appletFile = process.argv[2];
-  if (!appletFile) {
-    throw new Error(`Usage: ${progname} <applet.yaml>`);
-  }
-
-  // read applet(s) properties from the provided file
-  const fileContents = YAML.parse(await fs.readFile(appletFile, { encoding: 'utf-8' }));
-  if (typeof fileContents !== 'object') {
-    throw new Error(`${appletFile}: should contain a YAML object`);
-  }
-  const appletMap = fileContents.applets;
-  if (!appletMap) {
-    throw new Error(`${appletFile}: must have an 'applets' key`);
-  }
-
-  const searchDir = path.dirname(appletFile);
-  const tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'cdkapplet'));
-  try {
-    const app = new cdk.App();
-
-    for (const [name, definition] of Object.entries(appletMap)) {
-      await constructStack(app, searchDir, tempDir, name, definition);
-    }
-    app.run();
-  } finally {
-    await fs.remove(tempDir);
-  }
-}
-
-/**
- * Construct a stack from the given props
- * @param props Const
- */
-async function constructStack(app: cdk.App, searchDir: string, tempDir: string, stackName: string, spec: any) {
-  // the 'applet' attribute tells us how to load the applet. in the javascript case
-  // it will be in the format <module>:<class> where <module> is technically passed to "require"
-  // and <class> is expected to be exported from the module.
-  const appletSpec: string | undefined = spec.type;
-  if (!appletSpec) {
-    throw new Error(`Applet ${stackName} missing "type" attribute`);
-  }
-
-  const applet = parseApplet(appletSpec);
-
-  const props = spec.properties || {};
-
-  if (applet.npmPackage) {
-    // tslint:disable-next-line:no-console
-    console.error(`Installing NPM package ${applet.npmPackage}`);
-    // Magic marker to download this package directly off of NPM
-    // We're going to run NPM as a shell (since programmatic usage is not stable
-    // by their own admission) and we're installing into a temporary directory.
-    // (Installing into a permanent directory is useless since NPM doesn't do
-    // any real caching anyway).
-    child_process.execFileSync('npm', ['install', '--prefix', tempDir, '--global', applet.npmPackage], {
-      stdio: 'inherit'
-    });
-    searchDir = path.join(tempDir, 'lib');
-  }
-
-  // we need to resolve the module name relatively to where the applet file is
-  // and not relative to this module or cwd.
-  const modulePath = require.resolve(applet.moduleName, { paths: [ searchDir ] });
-
-  // load the module
-  const pkg = require(modulePath);
-
-  // find the applet class within the package
-  // tslint:disable-next-line:variable-name
-  const appletConstructor = pkg[applet.className];
-  if (!appletConstructor) {
-    throw new Error(`Cannot find applet class "${applet.className}" in module "${applet.moduleName}"`);
-  }
-
-  if (isStackConstructor(appletConstructor)) {
-    // add the applet stack into the app.
-    new appletConstructor(app, stackName, props);
-  } else {
-    // Make a stack THEN add it in
-    const stack = new cdk.Stack(app, stackName, props);
-    new appletConstructor(stack, 'Default', props);
-  }
-}
+// tslint:disable-next-line:no-console
+console.error('applets are no longer supported. see: https://github.com/awslabs/aws-cdk/tree/master/packages/decdk');

packages/@aws-cdk/applet-js/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@aws-cdk/applet-js",
   "version": "0.32.0",
+  "deprecated": "Applets have been deprecated in favor of 'decdk'",
   "description": "Javascript CDK applet host program",
   "main": "bin/cdk-applet-js.js",
   "types": "bin/cdk-applet-js.d.ts",
@@ -25,16 +26,9 @@
   "license": "Apache-2.0",
   "devDependencies": {
     "@types/fs-extra": "^5.0.5",
-    "@types/yaml": "^1.0.2",
     "cdk-build-tools": "^0.32.0",
     "pkglint": "^0.32.0"
   },
-  "dependencies": {
-    "@aws-cdk/cdk": "^0.32.0",
-    "fs-extra": "^7.0.1",
-    "source-map-support": "^0.5.12",
-    "yaml": "^1.5.0"
-  },
   "repository": {
     "url": "https://github.com/awslabs/aws-cdk.git",
     "type": "git",