@codiac.io/codiac-cli 1.2.175 → 1.2.202

package/dist/ops/project-initializer.js

@@ -0,0 +1,219 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProjectInitializer = void 0;
+const tslib_1 = require("tslib");
+const fs = require("fs");
+const path = require("path");
+const nodeUtil = require("util");
+const contracts_1 = require("@codiac.io/codiac-common/contracts");
+const _1 = require(".");
+const base_scaffolding_1 = require("./scaffolding/base-scaffolding");
+const mkdirAsync = nodeUtil.promisify(fs.mkdir); // anitquated nastiness
+const existsAsync = nodeUtil.promisify(fs.exists); // anitquated nastiness
+/**
+ *
+ */
+class ProjectInitializer {
+    constructor(cliRoot, _ops, _cfgRepo, logger) {
+        this._ops = _ops;
+        this._cfgRepo = _cfgRepo;
+        this.logger = logger;
+        this.cliAssetsFolder = path.join(cliRoot, "scaffolding");
+    }
+    /**
+     *
+     * @param targetFolder Absolute or relative to the current working directory.  If clone url is specified, the repo will be cloned directly into this folder.
+     * @param projectType The Codiac project type to scaffold.
+     * @param cloneUrl Fully qualified clone url for the repo.  This url gets stored with the project.
+     */
+    init(targetFolder, projectType, cloneUrl) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve, reject) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+                try {
+                    // change dir
+                    // try {
+                    //   process.chdir(targetFolder);
+                    //   fs.mkdirSync(process.cwd());
+                    // } catch (error) {
+                    //   this.logger.error(`Error switching current working directory to ${targetFolder}: ${error.message||""}`, error);
+                    // }
+                    if (cloneUrl) {
+                        yield this._ops.gitClone(cloneUrl, targetFolder);
+                        // COMMENTED OUT BC:  git clone behavior differs from the defaults we should use here 
+                        //                    (we want to default to current folder, like npm init does), 
+                        //                    so instead of introducing wierdness or counter-intuitive defaults, 
+                        //                    we made targetFolder a required argument, so it simply never defaults. 
+                        // Derive the git project name fromthe repo url
+                        // if (!targetFolder) {
+                        //   const splits = cloneUrl.split('/');
+                        //   destination = splits[splits.length - 1]
+                        // }
+                        this.logger.detail(`Cloned repo to target folder: ${path.resolve(targetFolder)}`);
+                    }
+                    else {
+                        if (path.resolve(targetFolder) != process.cwd()) {
+                            fs.mkdirSync(targetFolder);
+                            this.logger.detail(`Created target folder: ${path.resolve(targetFolder)}`);
+                        }
+                    }
+                    process.chdir(targetFolder);
+                    let projectRoot = process.cwd();
+                    // Commented out bc: This copmmand doesnt care whether we are in a repo or not.
+                    // let repoRoot = await this._ops.getRepoRoot(projectRoot);  // NOTE this will throw if the folder isnt a repo
+                    // this.logger.trace(`Repo root: ${repoRoot}`);
+                    yield this._ops.tryOpenVsCode(projectRoot);
+                    this._projectConfig = this._cfgRepo.writeNewProjectConfig();
+                    // this.logger.detail('Added project config: ' + this.styler.hilite(projectRoot));
+                    this.logger.detail('Added project config: ' + projectRoot);
+                    let scaffolding = this.getScaffolding(projectType);
+                    yield this.scaffoldProject(scaffolding, this._projectConfig);
+                    resolve(new contracts_1.Result(true));
+                }
+                catch (err) {
+                    reject(err);
+                }
+            }));
+        });
+    }
+    /** Poor-man's ioc to get the project initializer.
+     *
+     * @param name (Optional: defaults to the base scaffolding) name of scaffolding package to initialize with.
+     */
+    getScaffolding(name) {
+        switch (name) {
+            case "api":
+                return new _1.CodiacApiScaffolding(this.logger);
+            case "typescript":
+                return new _1.TypescriptScaffolding(this.logger);
+            default:
+                return new base_scaffolding_1.BaseScaffolding();
+        }
+    }
+    // private getApiScaffolding(): Scaffolding {
+    //   try {
+    //     let scaf = new Scaffolding("api");
+    //     scaf.npmDependencies = [
+    //       "reflect-metadata",
+    //       "@codiac.io/codiac-api-base",
+    //       "@codiac.io/codiac-auth-contracts",
+    //       "@codiac.io/codiac-common",
+    //       "@codiac.io/plugins-auth-sdk",
+    //       "@codiac.io/plugins-mongo-repo"
+    //     ];
+    //     scaf.npmDevDependencies = [
+    //       "mocha",
+    //       "chai",
+    //       "nyc",
+    //       "@types/mocha",
+    //       "@types/chai",
+    //       "@types/node",
+    //       "ts-node",
+    //       "typescript@4.0.5",
+    //       'reflect-metadata'
+    //     ];
+    //     scaf.scaffoldFolders = [".vscode", "src"]
+    //     scaf.scaffoldFiles = [
+    //       `.gitignore${ProjectInitializer.SCAFFOLDING_SUFFIX}`,
+    //       "src/app-config.json",
+    //       `src/index.ts${ProjectInitializer.SCAFFOLDING_SUFFIX}`,
+    //       `src/myApiDef.ts${ProjectInitializer.SCAFFOLDING_SUFFIX}`,
+    //       ".vscode/settings.json",
+    //       ".vscode/tasks.json",
+    //       ".vscode/launch.json"
+    //     ];
+    //     scaf.sccIgnoreFile = `.gitignore${ProjectInitializer.SCAFFOLDING_SUFFIX}`;
+    //     scaf.afterInitHandler = async config => {
+    //       // Declare the api image
+    //       let target = new RegistryTarget("default", ProjectInitializer.DEFAULT_REGISTRY_URL)
+    //       this._ops.declareImageExport(<ProjectConfig>config, config.name, target, "Dockerfile", undefined);
+    //     };
+    //     return scaf;
+    //   } catch (err) {
+    //     // this.logger.error(err.message||`Error loading api scaffolding.`, err);
+    //     throw err;
+    //   }
+    // }
+    // private getTypescriptScaffolding(): Scaffolding {
+    //   try {
+    //     let scaf = new Scaffolding("default");
+    //     scaf.npmDependencies = ["reflect-metadata"]
+    //     scaf.npmDevDependencies = [
+    //       "mocha",
+    //       "chai",
+    //       "nyc",
+    //       "@types/mocha",
+    //       "@types/chai",
+    //       "@types/node",
+    //       "ts-node",
+    //       "typescript@3.8.3",
+    //       'reflect-metadata'
+    //     ];
+    //     scaf.scaffoldFolders = [".vscode", "src"]
+    //     scaf.scaffoldFiles = [
+    //       `.gitignore${ProjectInitializer.SCAFFOLDING_SUFFIX}`,
+    //       `src/index.ts${ProjectInitializer.SCAFFOLDING_SUFFIX}`,
+    //       ".vscode/settings.json",
+    //       ".vscode/tasks.json",
+    //       ".vscode/launch.json"
+    //     ];
+    //     scaf.sccIgnoreFile = `.gitignore${ProjectInitializer.SCAFFOLDING_SUFFIX}`;
+    //     // scaf.afterInitHandler = async config => {
+    //     //   // Declare the api image
+    //     //   let target = new RegistryTarget("default", ProjectInitializer.DEFAULT_REGISTRY_URL)
+    //     //   this._ops.declareImageExport(<ProjectConfig>config, config.name, target, "Dockerfile", undefined);
+    //     // };
+    //     return scaf;
+    //   } catch (err) {
+    //     throw err;
+    //   }
+    // }
+    /** Creates initial files and folders required for any api using the given scaffolding parameters. */
+    scaffoldProject(scaffolding, projectConfig) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve, reject) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+                try {
+                    this.logger.detail(`Scaffolding project as '${scaffolding.name}'...`);
+                    let projectRoot = path.join(this._ops.getConfigRoot());
+                    // this.logger.detail(`Assets folder: ${cliAssetsFolder}`)
+                    // TODO:  Consiuder walking the assets folder instead of listing the assets in this._scaffoldFolders and this._scaffoldFiles
+                    this.logger.detail("Initial folders...");
+                    for (let index in scaffolding.scaffoldFolders) {
+                        let relPath = scaffolding.scaffoldFolders[index];
+                        let targetFolder = path.join(projectRoot, relPath);
+                        if (!(yield existsAsync(targetFolder))) {
+                            this.logger.detail(`Creating folder: ${relPath}`);
+                            yield mkdirAsync(targetFolder);
+                        }
+                    }
+                    this.logger.detail("Initial files...");
+                    for (let index in scaffolding.scaffoldFiles) {
+                        let relPath = scaffolding.scaffoldFiles[index];
+                        let source = path.join(this.cliAssetsFolder, scaffolding.name, relPath);
+                        let target = path.join(projectRoot, relPath);
+                        if (target.endsWith(ProjectInitializer.SCAFFOLDING_SUFFIX)) {
+                            target = target.substring(0, target.lastIndexOf(ProjectInitializer.SCAFFOLDING_SUFFIX));
+                        }
+                        this.logger.detail(`Creating file: ${relPath}`);
+                        if (fs.existsSync(target)) {
+                            fs.unlinkSync(target);
+                        }
+                        fs.copyFileSync(source, target);
+                    }
+                    if (scaffolding.afterInitHandler) {
+                        this.logger.detail(`Executing after-init script...`);
+                        yield scaffolding.afterInitHandler(projectRoot, projectConfig, this._ops);
+                    }
+                    yield this._cfgRepo.updateProjectConfigFile(projectConfig);
+                    resolve();
+                }
+                catch (err) {
+                    reject(err);
+                }
+            }));
+        });
+    }
+}
+exports.ProjectInitializer = ProjectInitializer;
+ProjectInitializer.SCAFFOLDING_SUFFIX = "-scaffolding";
+ProjectInitializer.DEFAULT_REGISTRY_URL = "https://index.docker.io/v1";
+//# sourceMappingURL=project-initializer.js.map

package/dist/ops/scaffolding/base-scaffolding.d.ts

@@ -0,0 +1,7 @@
+import { Scaffolding } from "..";
+/** Stack-agnostic project initializer.
+ * Creates only the bare minimum for what is required to run codiac on a project.
+ */
+export declare class BaseScaffolding extends Scaffolding {
+    constructor();
+}

package/dist/ops/scaffolding/base-scaffolding.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseScaffolding = void 0;
+const tslib_1 = require("tslib");
+const inversify_1 = require("inversify");
+const __1 = require("..");
+/** Stack-agnostic project initializer.
+ * Creates only the bare minimum for what is required to run codiac on a project.
+ */
+let BaseScaffolding = class BaseScaffolding extends __1.Scaffolding {
+    constructor() {
+        super("base");
+        this.sccIgnoreFile = `.gitignore${__1.ProjectInitializer.SCAFFOLDING_SUFFIX}`;
+    }
+};
+BaseScaffolding = tslib_1.__decorate([
+    (0, inversify_1.injectable)(),
+    tslib_1.__metadata("design:paramtypes", [])
+], BaseScaffolding);
+exports.BaseScaffolding = BaseScaffolding;
+//# sourceMappingURL=base-scaffolding.js.map

package/dist/ops/scaffolding/base-scaffolding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-scaffolding.js","sourceRoot":"","sources":["../../../src/ops/scaffolding/base-scaffolding.ts"],"names":[],"mappings":";;;;AAAA,yCAAuC;AACvC,0BAAqD;AAErD;;GAEG;AAEH,IAAa,eAAe,GAA5B,MAAa,eAAgB,SAAQ,eAAW;IAC9C;QACE,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,aAAa,GAAG,aAAa,sBAAkB,CAAC,kBAAkB,EAAE,CAAC;IAC5E,CAAC;CACF,CAAA;AALY,eAAe;IAD3B,IAAA,sBAAU,GAAE;;GACA,eAAe,CAK3B;AALY,0CAAe"}

package/dist/ops/scaffolding/codiac-api-scaffolding.d.ts

@@ -0,0 +1,7 @@
+import { IBetterLogger } from "@codiac.io/codiac-common/IBetterLogger";
+import { TypescriptScaffolding } from "..";
+/** Initializes a project for the Codiac Api platform.
+ */
+export declare class CodiacApiScaffolding extends TypescriptScaffolding {
+    constructor(logger: IBetterLogger);
+}

package/dist/ops/scaffolding/codiac-api-scaffolding.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CodiacApiScaffolding = void 0;
+const tslib_1 = require("tslib");
+const codiac_common_1 = require("@codiac.io/codiac-common");
+const codiac_relay_contracts_1 = require("@codiac.io/codiac-relay-contracts");
+const inversify_1 = require("inversify");
+const __1 = require("..");
+/** Initializes a project for the Codiac Api platform.
+ */
+let CodiacApiScaffolding = class CodiacApiScaffolding extends __1.TypescriptScaffolding {
+    constructor(logger) {
+        super(logger);
+        this.name = "api";
+        this.npmDependencies = [
+            "reflect-metadata",
+            "@codiac.io/codiac-api-base",
+            "@codiac.io/codiac-auth-contracts",
+            "@codiac.io/codiac-common",
+            "@codiac.io/plugins-auth-sdk",
+            "@codiac.io/plugins-mongo-repo"
+        ];
+        this.npmDevDependencies = [
+            "mocha",
+            "chai",
+            "nyc",
+            "@types/mocha",
+            "@types/chai",
+            "@types/node",
+            "ts-node",
+            "typescript@4.0.5",
+            'reflect-metadata'
+        ];
+        this.scaffoldFolders = [".vscode", "src"];
+        this.scaffoldFiles = [
+            `.gitignore${__1.ProjectInitializer.SCAFFOLDING_SUFFIX}`,
+            "src/app-config.json",
+            `src/index.ts${__1.ProjectInitializer.SCAFFOLDING_SUFFIX}`,
+            `src/myApiDef.ts${__1.ProjectInitializer.SCAFFOLDING_SUFFIX}`,
+            ".vscode/settings.json",
+            ".vscode/tasks.json",
+            ".vscode/launch.json"
+        ];
+        this.sccIgnoreFile = `.gitignore${__1.ProjectInitializer.SCAFFOLDING_SUFFIX}`;
+        this.afterInitHandler = (projectRoot, config, localOps) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+            // await super.afterInitHandler!(projectRoot, config, localOps);
+            // OR
+            yield this.initTypescript(projectRoot, true);
+            yield this.initNpm(projectRoot, config, this, localOps);
+            config.buildDef = ["tsc"];
+            // Declare the api image
+            let target = new codiac_relay_contracts_1.RegistryTarget("default", __1.ProjectInitializer.DEFAULT_REGISTRY_URL);
+            localOps.declareImageExport(config, config.name, target, "Dockerfile", undefined);
+            config.buildIncludes = ["src/app-config.json"];
+        });
+    }
+};
+CodiacApiScaffolding = tslib_1.__decorate([
+    (0, inversify_1.injectable)(),
+    tslib_1.__param(0, (0, inversify_1.inject)(codiac_common_1.INTERFACES.IBetterLogger)),
+    tslib_1.__metadata("design:paramtypes", [Object])
+], CodiacApiScaffolding);
+exports.CodiacApiScaffolding = CodiacApiScaffolding;
+//# sourceMappingURL=codiac-api-scaffolding.js.map

package/dist/ops/scaffolding/codiac-api-scaffolding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codiac-api-scaffolding.js","sourceRoot":"","sources":["../../../src/ops/scaffolding/codiac-api-scaffolding.ts"],"names":[],"mappings":";;;;AAAA,4DAAsD;AAEtD,8EAAmE;AACnE,yCAA+C;AAC/C,0BAA+D;AAG/D;GACG;AAEH,IAAa,oBAAoB,GAAjC,MAAa,oBAAqB,SAAQ,yBAAqB;IAC7D,YAA8C,MAAqB;QACjE,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC;QAElB,IAAI,CAAC,eAAe,GAAG;YACrB,kBAAkB;YAClB,4BAA4B;YAC5B,kCAAkC;YAClC,0BAA0B;YAC1B,6BAA6B;YAC7B,+BAA+B;SAChC,CAAC;QACF,IAAI,CAAC,kBAAkB,GAAG;YACxB,OAAO;YACP,MAAM;YACN,KAAK;YACL,cAAc;YACd,aAAa;YACb,aAAa;YACb,SAAS;YACT,kBAAkB;YAClB,kBAAkB;SACnB,CAAC;QACF,IAAI,CAAC,eAAe,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;QACzC,IAAI,CAAC,aAAa,GAAG;YACnB,aAAa,sBAAkB,CAAC,kBAAkB,EAAE;YACpD,qBAAqB;YACrB,eAAe,sBAAkB,CAAC,kBAAkB,EAAE;YACtD,kBAAkB,sBAAkB,CAAC,kBAAkB,EAAE;YACzD,uBAAuB;YACvB,oBAAoB;YACpB,qBAAqB;SACtB,CAAC;QACF,IAAI,CAAC,aAAa,GAAG,aAAa,sBAAkB,CAAC,kBAAkB,EAAE,CAAC;QAC1E,IAAI,CAAC,gBAAgB,GAAG,CAAO,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE;YAE9D,gEAAgE;YAChE,KAAK;YACL,MAAM,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;YAC7C,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;YACxD,MAAM,CAAC,QAAQ,GAAG,CAAC,KAAK,CAAC,CAAC;YAE1B,wBAAwB;YACxB,IAAI,MAAM,GAAG,IAAI,uCAAc,CAAC,SAAS,EAAE,sBAAkB,CAAC,oBAAoB,CAAC,CAAA;YACnF,QAAQ,CAAC,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;YAClF,MAAM,CAAC,aAAa,GAAG,CAAC,qBAAqB,CAAC,CAAC;QACjD,CAAC,CAAA,CAAC;IAGJ,CAAC;CACF,CAAA;AAnDY,oBAAoB;IADhC,IAAA,sBAAU,GAAE;IAEE,mBAAA,IAAA,kBAAM,EAAC,0BAAU,CAAC,aAAa,CAAC,CAAA;;GADlC,oBAAoB,CAmDhC;AAnDY,oDAAoB"}

package/dist/ops/scaffolding/typescript-scaffolding.d.ts

@@ -0,0 +1,15 @@
+import { LocalOps, Scaffolding } from "..";
+import { IBetterLogger } from '@codiac.io/codiac-common/IBetterLogger';
+import { ProjectConfig } from "@codiac.io/codiac-relay-contracts";
+/** Initializes a node-typescript project for use with Codiac.
+ */
+export declare class TypescriptScaffolding extends Scaffolding {
+    protected logger: IBetterLogger;
+    constructor(logger: IBetterLogger);
+    /**
+     * @param rootFolder
+     * @param overwrite Reinitializes seamlessly if the project has already been initialized.  Otherwise will throw exception.
+     */
+    initTypescript(rootFolder: string, overwrite?: boolean): Promise<void>;
+    initNpm(rootFolder: string, projConfig: ProjectConfig, scaffolding: Scaffolding, localOps: LocalOps): Promise<void>;
+}

package/dist/ops/scaffolding/typescript-scaffolding.js

@@ -0,0 +1,163 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypescriptScaffolding = void 0;
+const tslib_1 = require("tslib");
+const fs = require("fs");
+const path = require("path");
+const __1 = require("..");
+const IBetterLogger_1 = require("@codiac.io/codiac-common/IBetterLogger");
+const codiac_common_1 = require("@codiac.io/codiac-common");
+const inversify_1 = require("inversify");
+const codiac_ops_common_1 = require("@codiac.io/codiac-ops-common");
+/** Initializes a node-typescript project for use with Codiac.
+ */
+let TypescriptScaffolding = class TypescriptScaffolding extends __1.Scaffolding {
+    constructor(logger) {
+        super("typescript");
+        this.logger = logger;
+        this.npmDependencies = ["reflect-metadata"];
+        this.npmDevDependencies = [
+            "mocha",
+            "chai",
+            "nyc",
+            "@types/mocha",
+            "@types/chai",
+            "@types/node",
+            "ts-node",
+            "typescript@3.8.3",
+            'reflect-metadata'
+        ];
+        this.scaffoldFolders = [".vscode", "src"];
+        this.scaffoldFiles = [
+            `.gitignore${__1.ProjectInitializer.SCAFFOLDING_SUFFIX}`,
+            `src/index.ts${__1.ProjectInitializer.SCAFFOLDING_SUFFIX}`,
+            ".vscode/settings.json",
+            ".vscode/tasks.json",
+            ".vscode/launch.json"
+        ];
+        this.sccIgnoreFile = `.gitignore${__1.ProjectInitializer.SCAFFOLDING_SUFFIX}`;
+        // this.afterInitHandler = async config => {
+        //   // Declare the api image
+        //   let target = new RegistryTarget("default", ProjectInitializer.DEFAULT_REGISTRY_URL)
+        //   this._ops.declareImageExport(<ProjectConfig>config, config.name, target, "Dockerfile", undefined);
+        // };
+        this.afterInitHandler = (projectRoot, projConfig, localOps) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve, reject) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+                try {
+                    yield this.initTypescript(projectRoot, true);
+                    yield this.initNpm(projectRoot, projConfig, this, localOps);
+                    projConfig.buildDef = ["tsc -p ."];
+                    resolve();
+                }
+                catch (err) {
+                    reject(err);
+                }
+            }));
+        });
+    }
+    /**
+     * @param rootFolder
+     * @param overwrite Reinitializes seamlessly if the project has already been initialized.  Otherwise will throw exception.
+     */
+    initTypescript(rootFolder, overwrite = false) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve, reject) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+                try {
+                    // TODO: replace this with this._ops.deleteProjectFile(LocalOps.TSCONFIG_JSON_FILENAME);
+                    let pathName = path.join(rootFolder, "tsconfig.json");
+                    this.logger.debug("tsConfigPath: " + pathName);
+                    if (fs.existsSync(pathName) && overwrite) {
+                        this.logger.detail("removing existing tsconfig");
+                        fs.unlinkSync(pathName);
+                        this.logger.detail(`Deleted existing Typescript config: ${pathName}`);
+                    }
+                    // "target": "es6",                          /* Specify ECMAScript target version: 'ES3' (default), 'ES5', 'ES2015', 'ES2016', 'ES2017', or 'ESNEXT'. */
+                    // "module": "commonjs",                     /* Specify module code generation: 'none', 'commonjs', 'amd', 'system', 'umd', 'es2015', or 'ESNext'. */
+                    // "lib": ["es6","dom"],                     /* Specify library files to be included in the compilation:  */
+                    // "declaration": true,                      /* Generates corresponding '.d.ts' file. */
+                    // "sourceMap": true,                        /* Generates corresponding '.map' file. */
+                    // "outDir": "bin",                          /* Redirect output structure to the directory. */
+                    // "rootDir": "src",                         /* Specify the root directory of input files. Use to control the output directory structure with --outDir. */
+                    // "strict": true,                            /* Enable all strict type-checking options. */
+                    // "types": ["node", "reflect-metadata"],                           /* Type declaration files to be included in compilation. */
+                    // "experimentalDecorators": true        /* Enables experimental support for ES7 decorators. */
+                    // "emitDecoratorMetadata": true         /* Enables experimental support for emitting type metadata for decorators. */
+                    let cliExec = new codiac_ops_common_1.CliExec(this.logger);
+                    let cmd = "tsc --init";
+                    cmd += " --target es6";
+                    cmd += " --module commonjs";
+                    cmd += " --lib es6,dom";
+                    cmd += " --declaration";
+                    cmd += " --sourceMap";
+                    cmd += " --outDir ./dist";
+                    cmd += " --rootDir ./src"; //  ??
+                    // cmd += " --strict"  // --alwaysStrict ?
+                    cmd += " --types node,reflect-metadata";
+                    // cmd += " --include src"
+                    // cmd += " --exclude node_modules submodules dist"  // this param doesnt exist - whats its equivalent?
+                    cmd += " --resolveJsonModule";
+                    cmd += " --esModuleInterop";
+                    cmd += " --experimentalDecorators"; // ??
+                    cmd += " --emitDecoratorMetadata"; // ??
+                    cmd += " --skipLibCheck"; // Keeps the plugin declarations from registering as errors & MS recommended  
+                    let output = yield cliExec.execAsync(cmd, { cwd: rootFolder });
+                    this.logger.detail(output.stderr + output.stdout);
+                    resolve();
+                }
+                catch (err) {
+                    reject(err);
+                }
+            }));
+        });
+    }
+    initNpm(rootFolder, projConfig, scaffolding, localOps) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve, reject) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+                try {
+                    this.logger.detail("Initializing NPM...");
+                    localOps.deleteNpmPackageJson();
+                    localOps.clearNpmNodeModulesFolder();
+                    let cliExec = new codiac_ops_common_1.CliExec(this.logger);
+                    let cmd = `npm init -y`; // How annoying that npm doesnt expose a way to set the name upon init.
+                    let { stdout, stderr } = yield cliExec.execAsync(cmd, { cwd: rootFolder });
+                    this.logger.detail(`${stderr} ${stdout}`);
+                    let pkgJson = localOps.readNpmPackageJson();
+                    pkgJson.name = projConfig.name;
+                    localOps.writeNpmPackageJson(pkgJson);
+                    this.logger.detail("NPM dependencies...");
+                    let cmdDep = `npm install ${this.npmDependencies.join(' ')}`;
+                    let depOutput = yield cliExec.spawnAndLog(cmdDep, rootFolder, undefined, IBetterLogger_1.LogLevel.detail);
+                    // for (let index in this.npmDependencies) {
+                    //   let dep = this.npmDependencies[index];
+                    //   this.logger.detail(`Installing ${dep}...`);
+                    //   let depOutput = await this.cliExec.spawnAndLog(`npm install ${dep}`, rootFolder, undefined, LogLevel.detail);
+                    //   // let depOutput = await this.cliExec.execAsync(`npm install ${dep}`, { cwd: rootFolder });
+                    //   // this.logger.detail(depOutput.stderr + depOutput.stdout);
+                    // }
+                    this.logger.detail("NPM Dev dependencies...");
+                    let cmdDev = `npm install ${this.npmDevDependencies.join(' ')}`;
+                    let devOutput = yield cliExec.spawnAndLog(cmdDev, rootFolder, undefined, IBetterLogger_1.LogLevel.detail);
+                    // for (let index in this.npmDevDependencies) {
+                    //   let dep = this.npmDevDependencies[index];
+                    //   this.logger.detail(`Installing ${dep}...`);
+                    //   let devDepOutput = await this.cliExec.spawnAndLog(`npm install --save-dev ${dep} `, rootFolder, undefined, LogLevel.detail);
+                    //   // let devDepOutput = await this.cliExec.execAsync(`npm install --save-dev ${dep} `, { cwd: rootFolder });
+                    //   // this.logger.detail(devDepOutput.stderr + devDepOutput.stdout);
+                    // }
+                    resolve();
+                }
+                catch (err) {
+                    this.logger.error(`Error occurred initializing NPM: ${err}`);
+                    reject(err);
+                }
+            }));
+        });
+    }
+};
+TypescriptScaffolding = tslib_1.__decorate([
+    (0, inversify_1.injectable)(),
+    tslib_1.__param(0, (0, inversify_1.inject)(codiac_common_1.INTERFACES.IBetterLogger)),
+    tslib_1.__metadata("design:paramtypes", [Object])
+], TypescriptScaffolding);
+exports.TypescriptScaffolding = TypescriptScaffolding;
+//# sourceMappingURL=typescript-scaffolding.js.map

package/dist/ops/scaffolding/typescript-scaffolding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript-scaffolding.js","sourceRoot":"","sources":["../../../src/ops/scaffolding/typescript-scaffolding.ts"],"names":[],"mappings":";;;;AAAA,yBAAyB;AACzB,6BAA6B;AAC7B,0BAA+D;AAC/D,0EAAiF;AACjF,4DAAsD;AACtD,yCAA+C;AAC/C,oEAAuD;AAGvD;GACG;AAEH,IAAa,qBAAqB,GAAlC,MAAa,qBAAsB,SAAQ,eAAW;IACpD,YAAwD,MAAqB;QAC3E,KAAK,CAAC,YAAY,CAAC,CAAC;QADkC,WAAM,GAAN,MAAM,CAAe;QAG3E,IAAI,CAAC,eAAe,GAAG,CAAC,kBAAkB,CAAC,CAAA;QAC3C,IAAI,CAAC,kBAAkB,GAAG;YACxB,OAAO;YACP,MAAM;YACN,KAAK;YACL,cAAc;YACd,aAAa;YACb,aAAa;YACb,SAAS;YACT,kBAAkB;YAClB,kBAAkB;SACnB,CAAC;QACF,IAAI,CAAC,eAAe,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;QACzC,IAAI,CAAC,aAAa,GAAG;YACnB,aAAa,sBAAkB,CAAC,kBAAkB,EAAE;YACpD,eAAe,sBAAkB,CAAC,kBAAkB,EAAE;YACtD,uBAAuB;YACvB,oBAAoB;YACpB,qBAAqB;SACtB,CAAC;QACF,IAAI,CAAC,aAAa,GAAG,aAAa,sBAAkB,CAAC,kBAAkB,EAAE,CAAC;QAC1E,4CAA4C;QAC5C,6BAA6B;QAC7B,wFAAwF;QACxF,uGAAuG;QACvG,KAAK;QAEL,IAAI,CAAC,gBAAgB,GAAG,CAAO,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE;YAClE,OAAO,IAAI,OAAO,CAAO,CAAO,OAAO,EAAE,MAAM,EAAE,EAAE;gBACjD,IAAI;oBAEF,MAAM,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;oBAC7C,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;oBAE5D,UAAU,CAAC,QAAQ,GAAG,CAAC,UAAU,CAAC,CAAC;oBAEnC,OAAO,EAAE,CAAC;iBACX;gBAAC,OAAO,GAAG,EAAE;oBACZ,MAAM,CAAC,GAAG,CAAC,CAAC;iBACb;YACH,CAAC,CAAA,CAAC,CAAC;QACL,CAAC,CAAA,CAAC;IACJ,CAAC;IAGD;;;OAGG;IACG,cAAc,CAAC,UAAkB,EAAE,YAAqB,KAAK;;YAEjE,OAAO,IAAI,OAAO,CAAO,CAAO,OAAO,EAAE,MAAM,EAAE,EAAE;gBACjD,IAAI;oBACF,wFAAwF;oBACxF,IAAI,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;oBACtD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,GAAG,QAAQ,CAAC,CAAA;oBAC9C,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,SAAS,EAAE;wBACxC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,4BAA4B,CAAC,CAAC;wBACjD,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;wBACxB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,uCAAuC,QAAQ,EAAE,CAAC,CAAC;qBACvE;oBAED,wJAAwJ;oBACxJ,qJAAqJ;oBACrJ,4GAA4G;oBAC5G,wFAAwF;oBACxF,uFAAuF;oBACvF,8FAA8F;oBAC9F,0JAA0J;oBAC1J,4FAA4F;oBAC5F,+HAA+H;oBAC/H,+FAA+F;oBAC/F,sHAAsH;oBAEtH,IAAI,OAAO,GAAG,IAAI,2BAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBAEvC,IAAI,GAAG,GAAG,YAAY,CAAC;oBACvB,GAAG,IAAI,eAAe,CAAC;oBACvB,GAAG,IAAI,oBAAoB,CAAA;oBAC3B,GAAG,IAAI,gBAAgB,CAAA;oBACvB,GAAG,IAAI,gBAAgB,CAAA;oBACvB,GAAG,IAAI,cAAc,CAAA;oBACrB,GAAG,IAAI,kBAAkB,CAAA;oBACzB,GAAG,IAAI,kBAAkB,CAAA,CAAG,MAAM;oBAClC,0CAA0C;oBAC1C,GAAG,IAAI,gCAAgC,CAAA;oBACvC,0BAA0B;oBAC1B,uGAAuG;oBACvG,GAAG,IAAI,sBAAsB,CAAA;oBAC7B,GAAG,IAAI,oBAAoB,CAAA;oBAC3B,GAAG,IAAI,2BAA2B,CAAA,CAAE,KAAK;oBACzC,GAAG,IAAI,0BAA0B,CAAA,CAAG,KAAK;oBACzC,GAAG,IAAI,iBAAiB,CAAA,CAAG,8EAA8E;oBACzG,IAAI,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC;oBAC/D,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;oBAClD,OAAO,EAAE,CAAC;iBACX;gBAAC,OAAO,GAAG,EAAE;oBACZ,MAAM,CAAC,GAAG,CAAC,CAAC;iBACb;YAEH,CAAC,CAAA,CAAC,CAAC;QACL,CAAC;KAAA;IAEK,OAAO,CAAC,UAAkB,EAAE,UAAyB,EAAE,WAAwB,EAAE,QAAkB;;YAEvG,OAAO,IAAI,OAAO,CAAO,CAAO,OAAO,EAAE,MAAM,EAAE,EAAE;gBACjD,IAAI;oBACF,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;oBAC1C,QAAQ,CAAC,oBAAoB,EAAE,CAAC;oBAChC,QAAQ,CAAC,yBAAyB,EAAE,CAAC;oBAErC,IAAI,OAAO,GAAG,IAAI,2BAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBAEvC,IAAI,GAAG,GAAG,aAAa,CAAC,CAAE,uEAAuE;oBACjG,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC;oBAC3E,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC,CAAC;oBAE1C,IAAI,OAAO,GAAG,QAAQ,CAAC,kBAAkB,EAAE,CAAC;oBAC5C,OAAO,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;oBAC/B,QAAQ,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;oBAEtC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;oBAC1C,IAAI,MAAM,GAAG,eAAe,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC7D,IAAI,SAAS,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,wBAAQ,CAAC,MAAM,CAAC,CAAC;oBAC1F,4CAA4C;oBAC5C,2CAA2C;oBAC3C,gDAAgD;oBAChD,kHAAkH;oBAClH,gGAAgG;oBAChG,gEAAgE;oBAChE,IAAI;oBACJ,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAAC;oBAC9C,IAAI,MAAM,GAAG,eAAe,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;oBAChE,IAAI,SAAS,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,wBAAQ,CAAC,MAAM,CAAC,CAAC;oBAC1F,+CAA+C;oBAC/C,8CAA8C;oBAC9C,gDAAgD;oBAChD,iIAAiI;oBACjI,+GAA+G;oBAC/G,sEAAsE;oBACtE,IAAI;oBAEJ,OAAO,EAAE,CAAC;iBACX;gBAAC,OAAO,GAAG,EAAE;oBACZ,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,oCAAoC,GAAG,EAAE,CAAC,CAAC;oBAC7D,MAAM,CAAC,GAAG,CAAC,CAAC;iBACb;YACH,CAAC,CAAA,CAAC,CAAC;QACL,CAAC;KAAA;CAEF,CAAA;AA1JY,qBAAqB;IADjC,IAAA,sBAAU,GAAE;IAEE,mBAAA,IAAA,kBAAM,EAAC,0BAAU,CAAC,aAAa,CAAC,CAAA;;GADlC,qBAAqB,CA0JjC;AA1JY,sDAAqB"}

package/dist/ops/test/mock-ui.d.ts

@@ -0,0 +1,26 @@
+import { EntryValue, IUserInputProvider, choice, IOutputStyler, FileSelectionOptions, FolderSelectionOptions } from '@codiac.io/codiac-ops-common';
+export declare class MockUi implements IUserInputProvider, IOutputStyler {
+    constructor();
+    private values;
+    responses: {
+        [id: string]: EntryValue | Error;
+    };
+    setValue(id: string, value: EntryValue): void;
+    private getValue;
+    userMessage(message: string): void;
+    prompt<T extends EntryValue>(id: string, prompt: string, required?: boolean | undefined, defaultValue?: T | undefined): Promise<T | undefined>;
+    promptPassword(id: string, prompt: string): Promise<string>;
+    promptSelect<T extends EntryValue>(id: string, prompt: string, choices: choice<T>[], multiSelect?: boolean | undefined): Promise<T | undefined>;
+    promptSelectFile(id: string, prompt: string, fileOptions: FileSelectionOptions): Promise<string>;
+    promptSelectFolder(id: string, prompt: string, folderOptions: FolderSelectionOptions): Promise<string>;
+    promptConfirm(id: string, prompt: string, defaultValue?: boolean): Promise<boolean>;
+    openUrl(url: string): Promise<void>;
+    startSpinner(userMessage: string): void;
+    stopSpinner(userMessage: string): void;
+    bold(content: string): string;
+    dim(content: string): string;
+    hilite(content: string): string;
+    colorGood(content: string): string;
+    colorWarning(content: string): string;
+    colorCritical(content: string): string;
+}

package/dist/ops/test/mock-ui.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MockUi = void 0;
+const tslib_1 = require("tslib");
+// --------------------------------------------------
+//
+// THIS FILE IS A COPY LIFTED FROM codiac-cli-common
+//
+// --------------------------------------------------
+class MockUi {
+    constructor() {
+        this.values = {};
+        this.responses = {};
+    }
+    setValue(id, value) {
+        this.values[id] = value;
+    }
+    getValue(id) {
+        return new Promise((resolve, reject) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+            try {
+                let response;
+                if (this.values[id]) {
+                    response = this.values[id];
+                }
+                else {
+                    throw new Error(`MockTenCon unable to respond: No mock value was provided for prompt: [${id}].  Use MockTenCon.setValue() to provide a value.`);
+                }
+                this.responses[id] = response;
+                resolve(response);
+            }
+            catch (err) {
+                this.responses[id] = err;
+                reject(err);
+            }
+        }));
+    }
+    userMessage(message) {
+        console.log(message);
+    }
+    prompt(id, prompt, required, defaultValue) {
+        return this.getValue(id);
+    }
+    promptPassword(id, prompt) {
+        return this.getValue(id);
+    }
+    promptSelect(id, prompt, choices, multiSelect) {
+        return this.getValue(id);
+    }
+    promptSelectFile(id, prompt, fileOptions) {
+        return this.getValue(id);
+    }
+    promptSelectFolder(id, prompt, folderOptions) {
+        return this.getValue(id);
+    }
+    promptConfirm(id, prompt, defaultValue) {
+        return this.getValue(id);
+    }
+    openUrl(url) {
+        return new Promise(() => console.log(`Pretending to open browser to url [${url}].`));
+    }
+    startSpinner(userMessage) {
+        this.userMessage(userMessage);
+    }
+    stopSpinner(userMessage) {
+        this.userMessage(userMessage);
+    }
+    // IOutputStyler members
+    bold(content) {
+        return content;
+    }
+    dim(content) {
+        return content;
+    }
+    hilite(content) {
+        return content;
+    }
+    colorGood(content) {
+        return content;
+    }
+    colorWarning(content) {
+        return content;
+    }
+    colorCritical(content) {
+        return content;
+    }
+}
+exports.MockUi = MockUi;
+//# sourceMappingURL=mock-ui.js.map

package/dist/ops/test/test-extensions.d.ts

@@ -0,0 +1,13 @@
+import { Result, ListResult, BatchResult, SingleResult } from "@codiac.io/codiac-common/contracts";
+export declare function expectSuccessful(eventAttempted: string, result: Result): void;
+export declare function expectSuccessfulSingleOutput<T>(eventAttempted: string, result: SingleResult<T>): void;
+export declare function expectSuccessfulListOutput<T>(eventAttempted: string, result: ListResult<T>, expectedQty?: number): void;
+export declare function expectSuccessfulBatchOutput<T>(eventAttempted: string, result: BatchResult<T>): void;
+/** NOTE:  This method ensures that there is no error either. */
+export declare function expectNoSingleOutput<T>(eventAttempted: string, result: SingleResult<T>): void;
+/** NOTE:  This method ensures that there is no error either. */
+export declare function expectNoListOutput<T>(eventAttempted: string, result: ListResult<T>): void;
+/** NOTE:  This method does NOT check for result.error. */
+export declare function expectBatchFailure<T>(eventAttempted: string, result: BatchResult<T>): void;
+/** NOTE:  This method does NOT check for null output. */
+export declare function expectError<T>(eventAttempted: string, result: Result): void;