pwrdrvr 0.4.0-alpha.13

package/dist/lib/S3TransferUtility.d.ts

@@ -0,0 +1,19 @@
+import type { IDeployVersionPreflightResponse } from '@pwrdrvr/microapps-deployer-lib';
+export declare class S3TransferUtility {
+    /**
+     * @deprecated 2021-11-27
+     *
+     * @param s3Path
+     * @param destPrefixPath
+     * @param bucketName
+     * @param preflightResponse
+     */
+    static UploadDir(s3Path: string, destPrefixPath: string, bucketName: string, preflightResponse: IDeployVersionPreflightResponse): Promise<void>;
+    /**
+     * Resursively enumerate the files to be uploaded
+     * @param dir
+     * @returns
+     */
+    static GetFiles(dir: string): string[];
+}
+//# sourceMappingURL=S3TransferUtility.d.ts.map

package/dist/lib/S3TransferUtility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"S3TransferUtility.d.ts","sourceRoot":"","sources":["../../src/lib/S3TransferUtility.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,iCAAiC,CAAC;AAIvF,qBAAa,iBAAiB;IAC5B;;;;;;;OAOG;WACiB,SAAS,CAC3B,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,iBAAiB,EAAE,+BAA+B,GACjD,OAAO,CAAC,IAAI,CAAC;IAqDhB;;;;OAIG;WACW,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE;CA4B9C"}

package/dist/lib/S3TransferUtility.js

@@ -0,0 +1,94 @@
+"use strict";
+//
+// From: https://stackoverflow.com/a/65862128/878903
+//
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S3TransferUtility = void 0;
+const tslib_1 = require("tslib");
+const fs_1 = require("fs");
+const path = tslib_1.__importStar(require("path"));
+const s3 = tslib_1.__importStar(require("@aws-sdk/client-s3"));
+const lib_storage_1 = require("@aws-sdk/lib-storage");
+const mime_types_1 = require("mime-types");
+const p_map_1 = tslib_1.__importDefault(require("p-map"));
+class S3TransferUtility {
+    /**
+     * @deprecated 2021-11-27
+     *
+     * @param s3Path
+     * @param destPrefixPath
+     * @param bucketName
+     * @param preflightResponse
+     */
+    static async UploadDir(s3Path, destPrefixPath, bucketName, preflightResponse) {
+        // Use temp credentials for S3
+        const s3Client = new s3.S3Client({
+            maxAttempts: 16,
+            credentials: {
+                accessKeyId: preflightResponse.awsCredentials.accessKeyId,
+                secretAccessKey: preflightResponse.awsCredentials.secretAccessKey,
+                sessionToken: preflightResponse.awsCredentials.sessionToken,
+            },
+        });
+        // console.log('Uploading files to S3');
+        const files = S3TransferUtility.GetFiles(s3Path);
+        // const pathWithoutAppAndVer = path.join(s3Path, destPrefixPath);
+        // for (const filePath of files) {
+        //   const relFilePath = path.relative(pathWithoutAppAndVer, filePath);
+        //   console.log(`  ${relFilePath}`);
+        // }
+        // Use p-map to limit upload parallelism
+        await (0, p_map_1.default)(files, async (filePath) => {
+            // Use 4 multi-part parallel uploads for items > 5 MB
+            const upload = new lib_storage_1.Upload({
+                client: s3Client,
+                leavePartsOnError: false,
+                params: {
+                    Bucket: bucketName,
+                    Key: path.relative(s3Path, filePath),
+                    Body: (0, fs_1.createReadStream)(filePath),
+                    ContentType: (0, mime_types_1.contentType)(path.basename(filePath)) || 'application/octet-stream',
+                    CacheControl: 'max-age=86400; public',
+                },
+            });
+            await upload.done();
+        }, {
+            concurrency: 10,
+        });
+    }
+    // Recursive getFiles from
+    // https://stackoverflow.com/a/45130990/831465
+    /**
+     * Resursively enumerate the files to be uploaded
+     * @param dir
+     * @returns
+     */
+    static GetFiles(dir) {
+        const dirents = (0, fs_1.readdirSync)(dir, { withFileTypes: true });
+        const files = [];
+        const toScan = dirents.map((dirent) => ({
+            path: path.resolve(dir, dirent.name),
+            isDirectory: dirent.isDirectory(),
+        }));
+        // Iteratively collect all the files in the directories
+        // Do not use function call recursion
+        while (toScan.length > 0) {
+            const dirOrFile = toScan.pop();
+            if (dirOrFile.isDirectory) {
+                const direntsChild = (0, fs_1.readdirSync)(dirOrFile.path, { withFileTypes: true });
+                const toScanChild = direntsChild.map((dirent) => ({
+                    path: path.resolve(dirOrFile.path, dirent.name),
+                    isDirectory: dirent.isDirectory(),
+                }));
+                Array.prototype.push.apply(toScan, toScanChild);
+            }
+            else {
+                files.push(dirOrFile.path);
+            }
+        }
+        // Reverse the array so that the files are in the same order as the original
+        return files.reverse();
+    }
+}
+exports.S3TransferUtility = S3TransferUtility;
+//# sourceMappingURL=S3TransferUtility.js.map

package/dist/lib/S3TransferUtility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"S3TransferUtility.js","sourceRoot":"","sources":["../../src/lib/S3TransferUtility.ts"],"names":[],"mappings":"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"}

package/dist/lib/S3Uploader.d.ts

@@ -0,0 +1,27 @@
+import type { IDeployVersionPreflightResponse } from '@pwrdrvr/microapps-deployer-lib';
+import { IConfig } from '../config/Config';
+export declare class S3Uploader {
+    /**
+     * Copy files to local upload directory
+     * @param config
+     * @param s3UploadPath
+     * @param preflightResponse
+     */
+    static CopyToUploadDir(config: IConfig, s3UploadPath: string): Promise<void>;
+    static ParseUploadPath(s3UploadPath: string): {
+        bucketName: string;
+        destinationPrefix: string;
+    };
+    /**
+     * Upload files to S3
+     * @deprecated 2021-11-27
+     * @param config
+     * @param s3UploadPath
+     * @param preflightResponse
+     */
+    static Upload(config: IConfig, s3UploadPath: string, preflightResponse: IDeployVersionPreflightResponse): Promise<void>;
+    static removeTempDirIfExists(): Promise<void>;
+    private static readonly _tempDir;
+    static get TempDir(): string;
+}
+//# sourceMappingURL=S3Uploader.d.ts.map

package/dist/lib/S3Uploader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"S3Uploader.d.ts","sourceRoot":"","sources":["../../src/lib/S3Uploader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,iCAAiC,CAAC;AAEvF,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAG3C,qBAAa,UAAU;IACrB;;;;;OAKG;WACiB,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;WAa3E,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG;QACnD,UAAU,EAAE,MAAM,CAAC;QACnB,iBAAiB,EAAE,MAAM,CAAC;KAC3B;IASD;;;;;;OAMG;WACiB,MAAM,CACxB,MAAM,EAAE,OAAO,EACf,YAAY,EAAE,MAAM,EACpB,iBAAiB,EAAE,+BAA+B,GACjD,OAAO,CAAC,IAAI,CAAC;WA2BI,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAa1D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IACvD,WAAkB,OAAO,IAAI,MAAM,CAElC;CACF"}

package/dist/lib/S3Uploader.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S3Uploader = void 0;
+const tslib_1 = require("tslib");
+const path = tslib_1.__importStar(require("path"));
+const fs = tslib_1.__importStar(require("fs-extra"));
+const S3TransferUtility_1 = require("./S3TransferUtility");
+class S3Uploader {
+    /**
+     * Copy files to local upload directory
+     * @param config
+     * @param s3UploadPath
+     * @param preflightResponse
+     */
+    static async CopyToUploadDir(config, s3UploadPath) {
+        const { destinationPrefix } = S3Uploader.ParseUploadPath(s3UploadPath);
+        // Make a local root dir for the upload
+        const tempUploadPath = path.join(S3Uploader._tempDir, destinationPrefix);
+        await S3Uploader.removeTempDirIfExists();
+        await fs.mkdir(tempUploadPath, { recursive: true });
+        // Copy the files in the source dir to the root dir
+        // Note: It would be faster to move the files, then move them back
+        await fs.copy(config.app.staticAssetsPath, tempUploadPath);
+    }
+    static ParseUploadPath(s3UploadPath) {
+        // Parse the S3 Source URI
+        const uri = new URL(s3UploadPath);
+        const bucketName = uri.host;
+        const destinationPrefix = uri.pathname.length >= 1 ? uri.pathname.slice(1) : '';
+        return { bucketName, destinationPrefix };
+    }
+    /**
+     * Upload files to S3
+     * @deprecated 2021-11-27
+     * @param config
+     * @param s3UploadPath
+     * @param preflightResponse
+     */
+    static async Upload(config, s3UploadPath, preflightResponse) {
+        try {
+            const { destinationPrefix, bucketName } = S3Uploader.ParseUploadPath(s3UploadPath);
+            // Make a local root dir for the upload
+            const tempUploadPath = path.join(S3Uploader._tempDir, destinationPrefix);
+            await S3Uploader.removeTempDirIfExists();
+            await fs.mkdir(tempUploadPath, { recursive: true });
+            // Copy the files in the source dir to the root dir
+            // Note: It would be faster to move the files, then move them back
+            // FIXME: Use p-map for controlled parallelism
+            await fs.copy(config.app.staticAssetsPath, tempUploadPath);
+            // Do the upload
+            await S3TransferUtility_1.S3TransferUtility.UploadDir(this._tempDir, destinationPrefix, bucketName, preflightResponse);
+        }
+        finally {
+            // Delete the directory, now that it's uploaded or if we failed
+            await S3Uploader.removeTempDirIfExists();
+        }
+    }
+    static async removeTempDirIfExists() {
+        try {
+            const stats = await fs.stat(S3Uploader._tempDir);
+            if (stats.isDirectory()) {
+                await fs.rm(S3Uploader._tempDir, { recursive: true });
+            }
+        }
+        catch (_a) {
+            // Don't care
+            // fs.stat will throw if file/dir does not exist
+            // Since we want the directory deleted this is ok
+        }
+    }
+    static get TempDir() {
+        return S3Uploader._tempDir;
+    }
+}
+exports.S3Uploader = S3Uploader;
+S3Uploader._tempDir = './deploytool-temp';
+//# sourceMappingURL=S3Uploader.js.map

package/dist/lib/S3Uploader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"S3Uploader.js","sourceRoot":"","sources":["../../src/lib/S3Uploader.ts"],"names":[],"mappings":";;;;AAAA,mDAA6B;AAE7B,qDAA+B;AAE/B,2DAAwD;AAExD,MAAa,UAAU;IACrB;;;;;OAKG;IACI,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,MAAe,EAAE,YAAoB;QACvE,MAAM,EAAE,iBAAiB,EAAE,GAAG,UAAU,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;QAEvE,uCAAuC;QACvC,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;QACzE,MAAM,UAAU,CAAC,qBAAqB,EAAE,CAAC;QACzC,MAAM,EAAE,CAAC,KAAK,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEpD,mDAAmD;QACnD,kEAAkE;QAClE,MAAM,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;IAC7D,CAAC;IAEM,MAAM,CAAC,eAAe,CAAC,YAAoB;QAIhD,0BAA0B;QAC1B,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;QAClC,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,CAAC;QAC5B,MAAM,iBAAiB,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAEhF,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAC3C,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,KAAK,CAAC,MAAM,CACxB,MAAe,EACf,YAAoB,EACpB,iBAAkD;QAElD,IAAI;YACF,MAAM,EAAE,iBAAiB,EAAE,UAAU,EAAE,GAAG,UAAU,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;YAEnF,uCAAuC;YACvC,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;YACzE,MAAM,UAAU,CAAC,qBAAqB,EAAE,CAAC;YACzC,MAAM,EAAE,CAAC,KAAK,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAEpD,mDAAmD;YACnD,kEAAkE;YAClE,8CAA8C;YAC9C,MAAM,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;YAE3D,gBAAgB;YAChB,MAAM,qCAAiB,CAAC,SAAS,CAC/B,IAAI,CAAC,QAAQ,EACb,iBAAiB,EACjB,UAAU,EACV,iBAAiB,CAClB,CAAC;SACH;gBAAS;YACR,+DAA+D;YAC/D,MAAM,UAAU,CAAC,qBAAqB,EAAE,CAAC;SAC1C;IACH,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,qBAAqB;QACvC,IAAI;YACF,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YACjD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE;gBACvB,MAAM,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;aACvD;SACF;QAAC,WAAM;YACN,aAAa;YACb,gDAAgD;YAChD,iDAAiD;SAClD;IACH,CAAC;IAGM,MAAM,KAAK,OAAO;QACvB,OAAO,UAAU,CAAC,QAAQ,CAAC;IAC7B,CAAC;;AAtFH,gCAuFC;AAJyB,mBAAQ,GAAG,mBAAmB,CAAC"}

package/dist/lib/Versions.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Represents a File To Modify
+ */
+export interface IFileToModify {
+    path: string;
+    versions: IVersions;
+}
+/**
+ * Write new versions into specified config file
+ * @param path
+ * @param requiredVersions
+ * @param leaveFiles
+ * @returns
+ */
+export declare function writeNewVersions(path: string, requiredVersions: IVersions, leaveFiles: boolean): Promise<boolean>;
+/**
+ * Restore files that the version was patched into
+ */
+export declare function restoreFiles(filesToModify: IFileToModify[]): Promise<void>;
+/**
+ * Represents a Versions
+ */
+export interface IVersions {
+    version: string;
+    alias?: string;
+}
+/**
+ * Setup version and alias strings
+ * @param version
+ * @returns
+ */
+export declare function createVersions(version: string): Required<IVersions>;
+//# sourceMappingURL=Versions.d.ts.map

package/dist/lib/Versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Versions.d.ts","sourceRoot":"","sources":["../../src/lib/Versions.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,SAAS,CAAC;CACrB;AAOD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,SAAS,EAC3B,UAAU,EAAE,OAAO,GAClB,OAAO,CAAC,OAAO,CAAC,CAoClB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,aAAa,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBhF;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,CAEnE"}

package/dist/lib/Versions.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createVersions = exports.restoreFiles = exports.writeNewVersions = void 0;
+const fs_extra_1 = require("fs-extra");
+// https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions#escaping
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'); // $& means the whole matched string
+}
+/**
+ * Write new versions into specified config file
+ * @param path
+ * @param requiredVersions
+ * @param leaveFiles
+ * @returns
+ */
+async function writeNewVersions(path, requiredVersions, leaveFiles) {
+    const stats = await fs_extra_1.promises.stat(path);
+    if (!stats.isFile) {
+        return false;
+    }
+    // Make a backup of the file
+    await fs_extra_1.promises.copyFile(path, `${path}.original`);
+    // File exists, check that it has the required version strings
+    let fileText = await fs_extra_1.promises.readFile(path, 'utf8');
+    for (const key of Object.keys(requiredVersions)) {
+        const placeHolder = key === 'version' ? '0.0.0' : 'v0_0_0';
+        if (fileText.indexOf(placeHolder) === -1) {
+            // The required placeholder is missing
+            return false;
+        }
+        else {
+            const regExp = new RegExp(escapeRegExp(placeHolder), 'g');
+            fileText = fileText.replace(regExp, key === 'version' ? requiredVersions.version : requiredVersions.alias);
+        }
+    }
+    // Write the updated file contents
+    await fs_extra_1.promises.writeFile(path, fileText, 'utf8');
+    // Leave a copy of the modified file if requested
+    if (leaveFiles) {
+        // This copy will overwrite an existing file
+        await fs_extra_1.promises.copyFile(path, `${path}.modified`);
+    }
+    return true;
+}
+exports.writeNewVersions = writeNewVersions;
+/**
+ * Restore files that the version was patched into
+ */
+async function restoreFiles(filesToModify) {
+    // Put the old files back when succeeded or failed
+    for (const fileToModify of filesToModify) {
+        try {
+            const stats = await fs_extra_1.promises.stat(`${fileToModify.path}.original`);
+            if (stats.isFile()) {
+                // Remove the possibly modified file
+                await fs_extra_1.promises.unlink(fileToModify.path);
+                // Move the original file back
+                await fs_extra_1.promises.rename(`${fileToModify.path}.original`, fileToModify.path);
+            }
+        }
+        catch (_a) {
+            // don't care... if the file doesn't exist we can't do anything
+        }
+    }
+}
+exports.restoreFiles = restoreFiles;
+/**
+ * Setup version and alias strings
+ * @param version
+ * @returns
+ */
+function createVersions(version) {
+    return { version, alias: `v${version.replace(/\./g, '_')}` };
+}
+exports.createVersions = createVersions;
+//# sourceMappingURL=Versions.js.map

package/dist/lib/Versions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Versions.js","sourceRoot":"","sources":["../../src/lib/Versions.ts"],"names":[],"mappings":";;;AAAA,uCAA0C;AAU1C,6FAA6F;AAC7F,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC,CAAC,oCAAoC;AAC3F,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,gBAAgB,CACpC,IAAY,EACZ,gBAA2B,EAC3B,UAAmB;IAEnB,MAAM,KAAK,GAAG,MAAM,mBAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;QACjB,OAAO,KAAK,CAAC;KACd;IAED,4BAA4B;IAC5B,MAAM,mBAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,IAAI,WAAW,CAAC,CAAC;IAE5C,8DAA8D;IAC9D,IAAI,QAAQ,GAAG,MAAM,mBAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAE/C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE;QAC/C,MAAM,WAAW,GAAG,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC3D,IAAI,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE;YACxC,sCAAsC;YACtC,OAAO,KAAK,CAAC;SACd;aAAM;YACL,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,YAAY,CAAC,WAAW,CAAC,EAAE,GAAG,CAAC,CAAC;YAC1D,QAAQ,GAAG,QAAQ,CAAC,OAAO,CACzB,MAAM,EACN,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAE,gBAAgB,CAAC,KAAgB,CAClF,CAAC;SACH;KACF;IAED,kCAAkC;IAClC,MAAM,mBAAE,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAE3C,iDAAiD;IACjD,IAAI,UAAU,EAAE;QACd,4CAA4C;QAC5C,MAAM,mBAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,IAAI,WAAW,CAAC,CAAC;KAC7C;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAxCD,4CAwCC;AAED;;GAEG;AACI,KAAK,UAAU,YAAY,CAAC,aAA8B;IAC/D,kDAAkD;IAClD,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE;QACxC,IAAI;YACF,MAAM,KAAK,GAAG,MAAM,mBAAE,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,IAAI,WAAW,CAAC,CAAC;YAC7D,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE;gBAClB,oCAAoC;gBACpC,MAAM,mBAAE,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;gBAEnC,8BAA8B;gBAC9B,MAAM,mBAAE,CAAC,MAAM,CAAC,GAAG,YAAY,CAAC,IAAI,WAAW,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;aACrE;SACF;QAAC,WAAM;YACN,+DAA+D;SAChE;KACF;AACH,CAAC;AAhBD,oCAgBC;AAUD;;;;GAIG;AACH,SAAgB,cAAc,CAAC,OAAe;IAC5C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC;AAC/D,CAAC;AAFD,wCAEC"}

package/package.json

@@ -0,0 +1,83 @@
+{
+  "name": "pwrdrvr",
+  "version": "0.4.0-alpha.13",
+  "description": "Publish tool for deploying apps and updates",
+  "main": "dist/index.js",
+  "source": "src/index.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "microapps-publish": "./bin/run",
+    "pwrdrvr": "./bin/run"
+  },
+  "engineStrict": true,
+  "engine": {
+    "node": ">= 12.0.0"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "files": [
+    "dist",
+    "src",
+    "package.json",
+    "LICENSE",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pwrdrvr/microapps-core.git"
+  },
+  "author": "PwrDrvr LLC",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/pwrdrvr/microapps-core/issues"
+  },
+  "homepage": "https://github.com/pwrdrvr/microapps-core#readme",
+  "dependencies": {
+    "@aws-sdk/client-lambda": "^3.78.0",
+    "@aws-sdk/client-s3": "^3.78.0",
+    "@aws-sdk/client-sts": "^3.78.0",
+    "@aws-sdk/lib-storage": "^3.78.0",
+    "@oclif/command": "^1.8.4",
+    "@oclif/config": "^1.17.1",
+    "@oclif/core": "^1.0.4",
+    "@oclif/errors": "^1.3.5",
+    "@oclif/plugin-help": "^3.2.7",
+    "chalk": "^4.1.2",
+    "convict": "^6.1.0",
+    "convict-format-with-validator": "^6.0.1",
+    "fs-extra": "^9.1.0",
+    "js-yaml": "^4.1.0",
+    "listr2": "^3.13.5",
+    "mime-types": "^2.1.30",
+    "p-map": "^4.0.0",
+    "reflect-metadata": "^0.1.13",
+    "source-map-support": "0.5.21",
+    "ts-convict": "^1.1.0",
+    "tslib": "^2.1.0"
+  },
+  "peerDependencies": {
+    "@aws-sdk/client-lambda": "^3.78.0",
+    "@aws-sdk/client-s3": "^3.78.0",
+    "@aws-sdk/client-sts": "^3.78.0",
+    "@aws-sdk/lib-storage": "^3.78.0"
+  },
+  "devDependencies": {
+    "@types/convict": "^6.0.2",
+    "@types/convict-format-with-validator": "^6.0.2",
+    "@types/fs-extra": "^9.0.11",
+    "@types/js-yaml": "^4.0.1",
+    "@types/mime-types": "^2.1.0",
+    "@types/source-map-support": "0.5.6",
+    "type-fest": "^0.20.2"
+  },
+  "oclif": {
+    "commands": "./dist/commands/",
+    "bin": "pwrdrvr",
+    "plugins": [
+      "@oclif/plugin-help"
+    ]
+  }
+}

package/src/commands/delete.ts

@@ -0,0 +1,135 @@
+import 'reflect-metadata';
+import * as sts from '@aws-sdk/client-sts';
+import { Command, flags as flagsParser } from '@oclif/command';
+import { Listr } from 'listr2';
+import { Config } from '../config/Config';
+import DeployClient from '../lib/DeployClient';
+
+export class DeleteCommand extends Command {
+  static description = 'Delete app/version';
+
+  static examples = [
+    `$ pwrdrvr delete -d microapps-deployer-dev -a release -n 0.0.13
+✔ App/Version deleted: release/0.0.13 [1.2s]
+`,
+  ];
+
+  static flags = {
+    version: flagsParser.version({
+      char: 'v',
+    }),
+    help: flagsParser.help(),
+    // Deprecated
+    appName: flagsParser.string({
+      multiple: false,
+      required: false,
+      hidden: true,
+    }),
+    'app-name': flagsParser.string({
+      char: 'a',
+      multiple: false,
+      exactlyOne: ['app-name', 'appName'],
+      description: 'MicroApps app name (this becomes the path the app is rooted at)',
+    }),
+    // Deprecated
+    newVersion: flagsParser.string({
+      multiple: false,
+      required: false,
+      hidden: true,
+    }),
+    'new-version': flagsParser.string({
+      char: 'n',
+      multiple: false,
+      exactlyOne: ['new-version', 'newVersion'],
+      description: 'New semantic version to apply',
+    }),
+    // Deprecated
+    deployerLambdaName: flagsParser.string({
+      multiple: false,
+      required: false,
+      hidden: true,
+    }),
+    'deployer-lambda-name': flagsParser.string({
+      char: 'd',
+      multiple: false,
+      exactlyOne: ['deployer-lambda-name', 'deployerLambdaName'],
+      description: 'Name of the deployer lambda function',
+    }),
+  };
+
+  async run(): Promise<void> {
+    const config = Config.instance;
+
+    // const RUNNING_TEXT = ' RUNS ';
+    // const RUNNING = chalk.reset.inverse.yellow.bold(RUNNING_TEXT) + ' ';
+    const RUNNING = ''; //chalk.reset.inverse.yellow.bold(RUNNING_TEXT) + ' ';
+
+    const { flags: parsedFlags } = this.parse(DeleteCommand);
+    const semVer = parsedFlags.newVersion ?? parsedFlags['new-version'] ?? config.app.semVer;
+    const appName = parsedFlags.appName ?? parsedFlags['app-name'] ?? config.app.name;
+    const deployerLambdaName =
+      parsedFlags.deployerLambdaName ??
+      parsedFlags['deployer-lambda-name'] ??
+      config.deployer.lambdaName;
+
+    // Override the config value
+    config.deployer.lambdaName = deployerLambdaName;
+    config.app.name = appName;
+    config.app.semVer = semVer;
+
+    // TODO: Pick and validate the appname/semver from the config and flags
+
+    // Get the account ID and region from STS
+    // TODO: Move this to the right place
+    if (config.app.awsAccountID === '' || config.app.awsRegion === '') {
+      const stsClient = new sts.STSClient({
+        maxAttempts: 8,
+      });
+      const stsResponse = await stsClient.send(new sts.GetCallerIdentityCommand({}));
+      if (config.app.awsAccountID === '') {
+        config.app.awsAccountID = stsResponse.Account;
+      }
+      if (config.app.awsRegion === '') {
+        config.app.awsRegion = stsClient.config.region as string;
+      }
+    }
+
+    //
+    // Setup Tasks
+    //
+
+    const tasks = new Listr(
+      [
+        {
+          title: 'Deleting Version',
+          task: async (ctx, task) => {
+            const origTitle = task.title;
+            task.title = RUNNING + origTitle;
+
+            // Confirm the Version Does Not Exist in Published State
+            task.output = `Deleting app/version ${config.app.name}/${semVer}`;
+            const result = await DeployClient.DeleteVersion({
+              config,
+              output: (message: string) => (task.output = message),
+            });
+            if (result.statusCode === 200) {
+              task.title = `App/Version deleted: ${config.app.name}/${config.app.semVer}`;
+            } else if (result.statusCode === 404) {
+              task.title = `App/Version does not exist: ${config.app.name}/${config.app.semVer}`;
+            } else {
+              task.title = `App/Version delete failed: ${config.app.name}/${config.app.semVer}`;
+              throw new Error(`App/Version delete failed: ${config.app.name}/${config.app.semVer}`);
+            }
+          },
+        },
+      ],
+      {
+        rendererOptions: {
+          showTimer: true,
+        },
+      },
+    );
+
+    await tasks.run();
+  }
+}

package/src/commands/nextjs-version-restore.ts

@@ -0,0 +1,70 @@
+import 'reflect-metadata';
+import { Command, flags as flagsParser } from '@oclif/command';
+import { Listr } from 'listr2';
+import { createVersions, IVersions, restoreFiles } from '../lib/Versions';
+
+export class NextJSVersionRestoreCommand extends Command {
+  static description = 'Restore next.config.js';
+
+  static examples = [
+    `$ pwrdrvr nextjs-version-restore
+✔ Restoring Modified Config Files [0.0s]
+`,
+  ];
+
+  static flags = {
+    version: flagsParser.version({
+      char: 'v',
+    }),
+    help: flagsParser.help(),
+  };
+
+  private VersionAndAlias: IVersions;
+  private FILES_TO_MODIFY: {
+    path: string;
+    versions: IVersions;
+  }[];
+
+  async run(): Promise<void> {
+    // const RUNNING_TEXT = ' RUNS ';
+    // const RUNNING = chalk.reset.inverse.yellow.bold(RUNNING_TEXT) + ' ';
+    const RUNNING = ''; //chalk.reset.inverse.yellow.bold(RUNNING_TEXT) + ' ';
+
+    // const { flags: parsedFlags } =
+    this.parse(NextJSVersionRestoreCommand);
+
+    this.VersionAndAlias = createVersions('0.0.0');
+    const versionOnly = { version: this.VersionAndAlias.version };
+
+    this.FILES_TO_MODIFY = [{ path: 'next.config.js', versions: versionOnly }];
+
+    // TODO: Pick and validate the appname/semver from the config and flags
+
+    //
+    // Setup Tasks
+    //
+
+    const tasks = new Listr(
+      [
+        {
+          title: 'Restoring Modified Config Files',
+          task: async (ctx, task) => {
+            const origTitle = task.title;
+            task.title = RUNNING + origTitle;
+
+            await restoreFiles(this.FILES_TO_MODIFY);
+
+            task.title = origTitle;
+          },
+        },
+      ],
+      {
+        rendererOptions: {
+          showTimer: true,
+        },
+      },
+    );
+
+    await tasks.run();
+  }
+}