segmentational

aws-lambda-factory

All notable changes to this project will be documented in this file.

See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

* Chore(Naming): Accounting for `cloud-iac` ([ca3c85f](https://github.com/iac-factory/cli-utilities/commit/ca3c85f))

* Chore(Lock): Dependencies ([3bbfb07](https://github.com/iac-factory/cli-utilities/commit/3bbfb07))

* Chore(Package): Changed Package Name, Publish, Lock Files, Recursive Name Search ([d2fa2bb](https://github.com/iac-factory/cli-utilities/commit/d2fa2bb))

* Chore(Release): Version Bump, Ignore Clean-Up ([e6d8a36](https://github.com/iac-factory/cli-utilities/commit/e6d8a36))

* Publish ([5961e40](https://github.com/iac-factory/cli-utilities/commit/5961e40))

* Publish ([fda7508](https://github.com/iac-factory/cli-utilities/commit/fda7508))

* Publish ([8c3547f](https://github.com/iac-factory/cli-utilities/commit/8c3547f))

* Feature(Package): Created Lambda-Factory Package, Clean-Up General Codebase, Inline Documentation ([5504cd9](https://github.com/iac-factory/cli-utilities/commit/5504cd9))

        "directory": "packages/aws-lambda-factory",

        "url": "https://github.com/iac-factory/cli-utilities.git"

        "prepublishOnly": "tsc --build tsconfig.json",

        "watch": "tsc --build tsconfig.json --watch"

        "@aws-sdk/client-iam": "^3.81.0",

        "@aws-sdk/client-lambda": "^3.81.0",

    "gitHead": "d1aea1e92d64b3489dfd40cfab08f4c1446e00c0"

    "gitHead": "18c4be682176b41ad43eb3f536f3c29de7803582"

var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {

    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }

    return new (P || (P = Promise))(function (resolve, reject) {

        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }

        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }

        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }

        step((generator = generator.apply(thisArg, _arguments || [])).next());

var __importDefault = (this && this.__importDefault) || function (mod) {

    return (mod && mod.__esModule) ? mod : { "default": mod };

Object.defineProperty(exports, "__esModule", { value: true });

const tty_1 = __importDefault(require("tty"));

const path_1 = __importDefault(require("path"));

const assert_1 = __importDefault(require("assert"));

const environment_1 = __importDefault(require("./environment"));

const utilities_1 = require("./utilities");

const fs_1 = __importDefault(require("fs"));

const Main = (options) => __awaiter(void 0, void 0, void 0, function* () {

    /// Prevent standard-input, except for SIGKILL-alike signals

    (tty_1.default.isatty(process.stdin.fd)) && (0, cli_1.Handler)();

    /// Validate that the repository uri is shaped correctly

    const valid = utilities_1.Expression.test(options.repository);

        (0, cli_1.Exit)("Invalid Repository URL");

    /// Update the environment-variables attribute according to resolved user-input

    options.variables = yield (0, environment_1.default)(options.variables);

    /// Update `local` to fully qualified system path

    options.local = path_1.default.join(process.cwd(), options.local);

    /// Update `build` to fully qualified system path

    options.build = path_1.default.join(process.cwd(), options.build);

    /// Update `directory` to fully qualified system path

    options.directory = path_1.default.join(options.local, options.directory);

    // options.sg = (typeof options.sg === "object" && options.sg.length > 0) ? options.sg : [];

    // options.layer = (typeof options.layer === "object" && options.layer.length > 0) ? options.layer : [];

    // options.subnet = (typeof options.subnet === "object" && options.subnet.length > 0) ? options.subnet : [];

    const { repository, branch, local, directory, environment, name, role, description, timeout, memory, runtime, variables, joiner, layer, subnet, build, sg, debug } = options;

    (debug) && console.debug("[Debug] Input Argument(s)" + "\n" + "  ", "- Repository" + ":", repository + "\n" + "  ", "- Branch" + ":", (branch !== null && branch !== void 0 ? branch : null) + "\n" + "  ", "- Local-Target" + ":", (local !== null && local !== void 0 ? local : null) + "\n" + "  ", "- Build" + ":", (build !== null && build !== void 0 ? build : null) + "\n" + "  ", "- Package Directory" + ":", (directory !== null && directory !== void 0 ? directory : null) + "\n" + "  ", "- Environment Alias" + ":", (environment !== null && environment !== void 0 ? environment : null) + "\n" + "  ", "- Function Name" + ":", (name !== null && name !== void 0 ? name : null) + "\n" + "  ", "- IAM-Role" + ":", (role !== null && role !== void 0 ? role : null) + "\n" + "  ", "- Description" + ":", (description !== null && description !== void 0 ? description : null) + "\n" + "  ", "- Timeout" + ":", (timeout !== null && timeout !== void 0 ? timeout : null) + "\n" + "  ", "- Memory" + ":", (memory !== null && memory !== void 0 ? memory : null) + "\n" + "  ", "- Runtime" + ":", (runtime !== null && runtime !== void 0 ? runtime : null) + "\n" + "  ", "- Environment-Variables" + ":", (variables !== null && variables !== void 0 ? variables : null) + "\n" + "  ", "- Delimiter" + ":", (joiner !== null && joiner !== void 0 ? joiner : null) + "\n" + "  ", "- Layer(s)" + ":", (layer.length > 0 ? layer : "[]") + "\n" + "  ", "- Subnet-ID(s)" + ":", (subnet.length > 0 ? subnet : "[]") + "\n" + "  ", "- Security-Group ID(s)" + ":", (sg.length > 0 ? sg : "[]") + "\n" + "  ");

    yield (0, factory_1.Clone)(options.repository, options.local, options.branch);

    /// The resolved `node_modules` directory that's only available once the package is locally installed

    const modules = yield (0, factory_1.Install)(options.directory);

    /// The distribution (folder containing "package.json") relative to its parent directory

    const distribution = path_1.default.dirname(modules);

    /// Parse the Cloned `package.json` from repository

    const pkg = JSON.parse(fs_1.default.readFileSync(path_1.default.join(distribution, "package.json"), { encoding: "utf-8" }));

    /// Compressed archives ready for deployment(s)

    const artifacts = yield (0, factory_1.Prepare)(distribution, options.build);

    /// Lastly, update the options.name to ensure derivative cloud resource(s) are appropriately named; at a

    /// later time, the `--name` parameter may be used as an escape-hatch to overwrite or forcefully set

    /// the cloud-resource name(s) prefix. However, for now, we ignore user-input and establish the value

    /// as it's found in the repository's `package.json` + delimiter + `--environment`.

     * options.name = (options.name === null || options.name === "") ? options.name : pkg.name;

    options.name = (options.name === null || options.name === "") ? /* options.name */ pkg.name : pkg.name;

    options.name = [options.name, options.environment].join(options.joiner);

    /*** Handle cases where an organization is prefixed e.g. @cloud-iac/lambda-function-name */

    /*** Handle cases where an organization is prefixed e.g. @aws-lambda-factory/lambda-function-name */

    options.name = (options.name.includes("/")) ? options.name.split("/").pop() : options.name;

    assert_1.default.equal(String(options.name).length > 0, true);

    assert_1.default.equal(typeof options.name, "string");

    yield (0, factory_1.Deploy)(options, artifacts);

import { Clone, Deploy, Install, Prepare } from "./factory";

import { Expression } from "./utilities";

    /*** Where the repository folder was cloned into; defaults to `source` */

    /*** Relative Directory from Repository's Root where `"package.json"` is Located; allows for custom relative directory within repository folder (where `package.json` is located` and `node_modules` are installed) */

    /*** The AWS IAM Role (ARN) to associate lambda function invocation permissions */

    ( TTY.isatty( process.stdin.fd ) ) && Handler();

    const valid = Expression.test( options.repository );

    if ( !valid ) Exit( "Invalid Repository URL" );

    options.variables = await Environment( options.variables );

    options.local = Path.join( process.cwd(), options.local );

    options.build = Path.join( process.cwd(), options.build );

    options.directory = Path.join( options.local, options.directory );

        "[Debug] Input Argument(s)" + "\n" + "  ",

        "- Repository" + ":", repository + "\n" + "  ",

        "- Branch" + ":", ( branch ?? null ) + "\n" + "  ",

        "- Local-Target" + ":", ( local ?? null ) + "\n" + "  ",

    options.name = ( options.name.includes( "/" ) ) ? options.name.split( "/" ).pop() as string : ( options.name as string );

    Assertion.equal( String( options.name ).length > 0, true );

    Assertion.equal( typeof options.name, "string" );

var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6, _7, _8;

const commander_1 = require("commander");

const banner_1 = __importDefault(require("./banner"));

    .version(((_b = (_a = process.env) === null || _a === void 0 ? void 0 : _a["VERSION"]) !== null && _b !== void 0 ? _b : "0.0.0"), "-v, --version", "Display the Package Version")

    .helpOption("-h, --help", "Display Help Information");

    .addOption(new commander_1.Option("-r, --repository <string>", "Git, HTTPs, or SSH Clone URI")

    .addOption(new commander_1.Option("-b, --branch [string]", "VCS Remote Branch or Commit-Hash")

    .default((_c = process.env) === null || _c === void 0 ? void 0 : _c.BRANCH)

    .addOption(new commander_1.Option("-l, --local [string]", "Target Relative Clone Directory")

    .default((_e = (_d = process.env) === null || _d === void 0 ? void 0 : _d.LOCAL) !== null && _e !== void 0 ? _e : "source")

    .addOption(new commander_1.Option("-s, --directory [string]", "Relative Directory from Repository's Root where \"package.json\" is Located")

    .default((_g = (_f = process.env) === null || _f === void 0 ? void 0 : _f.DIRECTORY) !== null && _g !== void 0 ? _g : ".")

    .addOption(new commander_1.Option("-a, --environment [string]", "Deployment Alias Relating to Target Environment")

    .choices([(_j = (_h = process.env) === null || _h === void 0 ? void 0 : _h.DEVELOPMENT) !== null && _j !== void 0 ? _j : "development", (_l = (_k = process.env) === null || _k === void 0 ? void 0 : _k.QA) !== null && _l !== void 0 ? _l : "qa", (_o = (_m = process.env) === null || _m === void 0 ? void 0 : _m.STAGING) !== null && _o !== void 0 ? _o : "staging", (_q = (_p = process.env) === null || _p === void 0 ? void 0 : _p.UAT) !== null && _q !== void 0 ? _q : "uat", (_s = (_r = process.env) === null || _r === void 0 ? void 0 : _r.PRODUCTION) !== null && _s !== void 0 ? _s : "production"])

    .default((_u = (_t = process.env) === null || _t === void 0 ? void 0 : _t.ENVIRONMENT) !== null && _u !== void 0 ? _u : "development")

    .addOption(new commander_1.Option("-n, --name [string]", "Lambda Function Name - Searches for & Parses \"package.json\" if := null")

    .addOption(new commander_1.Option("-i, --role [string]", "IAM Execution Role (ARN) - A Dynamically Named, Attributed Role is Created by Default")

    .addOption(new commander_1.Option("-d, --description [string]", "Descriptive Context Describing Lambda Functionality")

    .default((_w = (_v = process.env) === null || _v === void 0 ? void 0 : _v.DESCRIPTION) !== null && _w !== void 0 ? _w : "...")

    .addOption(new commander_1.Option("-t, --timeout [number]", "Invocation Timeout Delay")

    .default((_z = parseInt((_y = (_x = process.env) === null || _x === void 0 ? void 0 : _x.TIMEOUT) !== null && _y !== void 0 ? _y : "30")) !== null && _z !== void 0 ? _z : 30)

    .addOption(new commander_1.Option("-m, --memory [number]", "Allotted Container Runtime Memory (MB)")

    .default((_2 = parseInt((_1 = (_0 = process.env) === null || _0 === void 0 ? void 0 : _0.MEMORY) !== null && _1 !== void 0 ? _1 : "256")) !== null && _2 !== void 0 ? _2 : 256)

    .addOption(new commander_1.Option("-x, --runtime [string]", "Container Runtime")

    .default((_4 = (_3 = process.env) === null || _3 === void 0 ? void 0 : _3.RUNTIME) !== null && _4 !== void 0 ? _4 : "nodejs14.x")

    .addOption(new commander_1.Option("-e, --variables [string]", "Environment-Variable(s) Path to JSON File Configuration or *.env File (Secrets Manager Integration Coming Soon)")

    .default((_6 = (_5 = process.env) === null || _5 === void 0 ? void 0 : _5.ENV_VARS) !== null && _6 !== void 0 ? _6 : null)

    .addOption(new commander_1.Option("-d, --joiner [string]", "Character Used in Name-Environment Joining")

    .makeOptionMandatory(false).hideHelp(true))

    .addOption(new commander_1.Option("-o, --build [string]", "Target Relative Build Directory")

    .default((_8 = (_7 = process.env) === null || _7 === void 0 ? void 0 : _7.BUILD) !== null && _8 !== void 0 ? _8 : "build")

    .addOption(new commander_1.Option("-a, --layer [layer-arn...]", "Additional Layer-Version ARN(s) for Dependency Injection")

    .addOption(new commander_1.Option("-p, --subnet [subnets-id...]", "VPC Subnet-ID(s)")

    .addOption(new commander_1.Option("-g, --sg [security-group-id...]", "Security-Group ID(s)")

    .addOption(new commander_1.Option("-z, --debug", "Enable Debug Logging")

    .action((options) => (0, deploy_1.Main)(options))

CLI.command("help").description("").action(() => CLI.help());

void (() => __awaiter(void 0, void 0, void 0, function* () { return (yield (0, banner_1.default)()) && (yield CLI.parseAsync(process.argv)) && process.exit(0); }))();

import { Command, Option } from "commander";

import { Main as Deploy } from "./deploy";

    .version( (process.env?.[ "VERSION" ] ?? "0.0.0") as string, "-v, --version", "Display the Package Version" )

    .helpOption( "-h, --help", "Display Help Information" );

    .addOption( new Option( "-r, --repository <string>", "Git, HTTPs, or SSH Clone URI" )

    .addOption( new Option( "-b, --branch [string]", "VCS Remote Branch or Commit-Hash" )

    .addOption( new Option( "-l, --local [string]", "Target Relative Clone Directory" )

        .default( process.env?.LOCAL ?? "source" )

    .addOption( new Option( "-s, --directory [string]", "Relative Directory from Repository's Root where \"package.json\" is Located" )

        .default( process.env?.DIRECTORY ?? "." )

    .addOption( new Option( "-a, --environment [string]", "Deployment Alias Relating to Target Environment" )

        .choices( [ process.env?.DEVELOPMENT ?? "development", process.env?.QA ?? "qa", process.env?.STAGING ?? "staging", process.env?.UAT ?? "uat", process.env?.PRODUCTION ?? "production" ] )

        .default( process.env?.ENVIRONMENT ?? "development" )

    .addOption( new Option( "-n, --name [string]", "Lambda Function Name - Searches for & Parses \"package.json\" if := null" )

    .addOption( new Option( "-i, --role [string]", "IAM Execution Role (ARN) - A Dynamically Named, Attributed Role is Created by Default" )

    .addOption( new Option( "-d, --description [string]", "Descriptive Context Describing Lambda Functionality" )

        .default( process.env?.DESCRIPTION ?? "..." )

    .addOption( new Option( "-t, --timeout [number]", "Invocation Timeout Delay" )

        .default( parseInt( process.env?.TIMEOUT ?? "30" ) ?? 30 )

    .addOption( new Option( "-m, --memory [number]", "Allotted Container Runtime Memory (MB)" )

        .default( parseInt( process.env?.MEMORY ?? "256" ) ?? 256 )

    .addOption( new Option( "-x, --runtime [string]", "Container Runtime" )

        .default( process.env?.RUNTIME ?? "nodejs14.x" )

    .addOption( new Option( "-e, --variables [string]", "Environment-Variable(s) Path to JSON File Configuration or *.env File (Secrets Manager Integration Coming Soon)" )

        .default( process.env?.ENV_VARS ?? null )

    .addOption( new Option( "-d, --joiner [string]", "Character Used in Name-Environment Joining" )

        .makeOptionMandatory( false ).hideHelp( true ) )

    .addOption( new Option( "-o, --build [string]", "Target Relative Build Directory" )

        .default( process.env?.BUILD ?? "build" )

    .addOption( new Option( "-a, --layer [layer-arn...]", "Additional Layer-Version ARN(s) for Dependency Injection" )

    .addOption( new Option( "-p, --subnet [subnets-id...]", "VPC Subnet-ID(s)" )

    .addOption( new Option( "-g, --sg [security-group-id...]", "Security-Group ID(s)" )

    .addOption( new Option( "-z, --debug", "Enable Debug Logging" )

    .action( (options) => Deploy( options ) )

CLI.command( "help" ).description( "" ).action( () => CLI.help() );

void ( async () => await Banner() && await CLI.parseAsync( process.argv ) && process.exit( 0 ) )();

		@@ -6,2 +6,10 @@ # Change Log

		## <small>0.4.95 (2022-05-02)</small>

		* Chore(Naming): Accounting for `cloud-iac` ([ca3c85f](https://github.com/iac-factory/cli-utilities/commit/ca3c85f))





		## <small>0.4.94 (2022-05-02)</small>
		@@ -8,0 +16,0 @@

		{
		"name": "aws-lambda-factory",
		"version": "0.4.94",
		"version": "0.4.95",
		"main": "index.js",
		@@ -41,3 +41,3 @@ "description": "...",
		},
		"gitHead": "d1aea1e92d64b3489dfd40cfab08f4c1446e00c0"
		"gitHead": "18c4be682176b41ad43eb3f536f3c29de7803582"
		}

		@@ -20,3 +20,3 @@ "use strict";
		const CLI = new commander_1.Command()
		.name("cloud-iac")
		.name("aws-lambda-factory")
		.version(((_b = (_a = process.env) === null \|\| _a === void 0 ? void 0 : _a["VERSION"]) !== null && _b !== void 0 ? _b : "0.0.0"), "-v, --version", "Display the Package Version")
		@@ -23,0 +23,0 @@ .helpOption("-h, --help", "Display Help Information");

		@@ -8,3 +8,3 @@ import { Command, Option } from "commander";
		const CLI = new Command()
		.name( "cloud-iac" )
		.name( "aws-lambda-factory" )
		.version( (process.env?.[ "VERSION" ] ?? "0.0.0") as string, "-v, --version", "Display the Package Version" )
		@@ -11,0 +11,0 @@ .helpOption( "-h, --help", "Display Help Information" );

		@@ -66,3 +66,3 @@ "use strict";
		options.name = [options.name, options.environment].join(options.joiner);
		/*** Handle cases where an organization is prefixed e.g. @cloud-iac/lambda-function-name */
		/*** Handle cases where an organization is prefixed e.g. @aws-lambda-factory/lambda-function-name */
		options.name = (options.name.includes("/")) ? options.name.split("/").pop() : options.name;
		@@ -69,0 +69,0 @@ assert_1.default.equal(String(options.name).length > 0, true);

		@@ -146,3 +146,3 @@ import TTY from "tty";

		/*** Handle cases where an organization is prefixed e.g. @cloud-iac/lambda-function-name */
		/*** Handle cases where an organization is prefixed e.g. @aws-lambda-factory/lambda-function-name */
		options.name = ( options.name.includes( "/" ) ) ? options.name.split( "/" ).pop() as string : ( options.name as string );
		@@ -149,0 +149,0 @@

Improved metrics