@codiac.io/codiac-cli 1.2.175 → 1.2.202

package/dist/ops/workspace-versioner.js

@@ -0,0 +1,292 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SemanticVersioner = exports.WorkspaceVersioner = void 0;
+const tslib_1 = require("tslib");
+const codiac_common_1 = require("@codiac.io/codiac-common");
+const contracts_1 = require("@codiac.io/codiac-common/contracts");
+const inversify_1 = require("inversify");
+const cli_context_repo_1 = require("./data/cli-context-repo");
+const dx_constants_1 = require("./dx-constants");
+const semver = require("semver");
+/** Manages the semantic version number for image exports declared in the workspace (aka: the codiac.json).  */
+let WorkspaceVersioner = class WorkspaceVersioner {
+    constructor(logger, projCfgRepo
+    // @inject(SemanticVersioner) private versioner: SemanticVersioner
+    ) {
+        this.logger = logger;
+        this.projCfgRepo = projCfgRepo;
+        this.versioner = new SemanticVersioner(logger);
+    }
+    /** Increments the version number of the given image export by the given increment.
+     *  Retains existing version number if no increment is specified.
+     *  Sets to the default init version number if the imageExport doesnt yet have a version declared.
+     *  Writes changes to the project config (aka: codiac.json).
+     *  Throws if existing version is invalid.
+     *
+     * @param cfg Project config doc (aka: codiac.json deserialized)
+     */
+    incrementImageVersion(imageExport, cfg, increment) {
+        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 {
+                    if (!imageExport.version)
+                        imageExport.version = dx_constants_1.DxConstants.DEFAULT_INIT_IMAGE_VERSION; // TODO: Absorb this into this class
+                    let newVersion = this.versioner.incrementVersion(imageExport.version, increment);
+                    if (newVersion != imageExport.version) {
+                        imageExport.version = newVersion;
+                        if (!cfg.images)
+                            cfg.images = {};
+                        cfg.images[imageExport.name] = imageExport;
+                        yield this.projCfgRepo.updateProjectConfigFile(cfg);
+                    }
+                    resolve(imageExport);
+                }
+                catch (err) {
+                    reject(err);
+                }
+            }));
+        });
+    }
+    /** Increments the project code version number by the given increment.
+     *  Retains existing version number if no increment is specified.
+     *  Writes changes to the project config (aka: codiac.json).
+     *  Throws if existing version is invalid.
+     *
+     * @param cfg Project config doc (aka: codiac.json deserialized)
+     */
+    incrementCodeVersion(cfg, increment) {
+        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 {
+                    let newVersion = this.versioner.incrementVersion(cfg.codeVersion, increment);
+                    if (newVersion != cfg.codeVersion) {
+                        cfg.codeVersion = newVersion;
+                        yield this.projCfgRepo.updateProjectConfigFile(cfg);
+                    }
+                    resolve(cfg);
+                }
+                catch (err) {
+                    reject(err);
+                }
+            }));
+        });
+    }
+};
+WorkspaceVersioner = tslib_1.__decorate([
+    (0, inversify_1.injectable)(),
+    tslib_1.__param(0, (0, inversify_1.inject)(codiac_common_1.INTERFACES.IBetterLogger)),
+    tslib_1.__param(1, (0, inversify_1.inject)(cli_context_repo_1.ProjectContextRepo)),
+    tslib_1.__metadata("design:paramtypes", [Object, cli_context_repo_1.ProjectContextRepo
+        // @inject(SemanticVersioner) private versioner: SemanticVersioner
+    ])
+], WorkspaceVersioner);
+exports.WorkspaceVersioner = WorkspaceVersioner;
+let SemanticVersioner = class SemanticVersioner {
+    constructor(logger) {
+        this.logger = logger;
+    }
+    /** Increments the given semantic version nnumber by the given increment.
+     *  Returns existing version number if no increment is specified.
+     *  Throws if existing version is invalid.
+     */
+    incrementVersion(existing, increment) {
+        try {
+            let newVersion = existing;
+            if (increment) {
+                if (increment.fullName) {
+                    this.logger.notice(`Applying new version number ${increment.fullName}...`);
+                    newVersion = increment.fullName;
+                }
+                else if (increment.major) {
+                    this.logger.notice(`Incrementing ${"major"} version number...`);
+                    newVersion = semver.inc(existing, "major");
+                }
+                else if (increment.minor) {
+                    this.logger.notice(`Incrementing ${"minor"} version number...`);
+                    newVersion = semver.inc(existing, "minor");
+                }
+                else if (increment.patch) {
+                    this.logger.notice(`Incrementing ${"patch"} version number...`);
+                    newVersion = semver.inc(existing, "patch");
+                }
+                else if (increment.preId) {
+                    this.logger.notice(`Incrementing ${"prerelease"} id and number...`);
+                    newVersion = this.addPrereleaseId(existing, increment.preId);
+                    newVersion = semver.inc(newVersion, "prerelease");
+                }
+                else if (increment.prerelease) {
+                    this.logger.notice(`Incrementing ${"prerelease"} version number...`);
+                    newVersion = semver.inc(existing, "prerelease");
+                }
+                if (newVersion == null)
+                    throw new contracts_1.CodiacError(`Cannot increment; current version number [${existing}] is not a valid semantic version.`);
+            }
+            return newVersion;
+        }
+        catch (err) {
+            throw err;
+        }
+    }
+    /** Prefixes the prerelease version segment
+     * with the given prerelease identifier.
+     *
+     * using format:  `[major].[minor].[patch]-[id].[prereleaseNumber]`
+     *
+     * eg:  `1.2.3`  remains  `1.2.3`
+     * eg:  `1.2.3-4`  becomes  `1.2.3-thisBranch.4`
+     * eg:  `1.2.3-toro.4`  becomes  `1.2.3-thisBranch.4`   */
+    addPrereleaseId(version, prereleaseId) {
+        let output = version;
+        let parts = semver.parse(version);
+        // let ultimateId = /[^\w\d\.-]/g.exec(id); 
+        let ultimateId = prereleaseId.replace(/[^\w\d\.-]|_/g, "-");
+        // console.log(ultimateId);
+        if (parts) {
+            let pre = parts.prerelease; // semver.prerelease(version);
+            let newPre;
+            if (pre === null || pre.length == 0) {
+                // CASE 0) no prerelease at all.
+                newPre = [ultimateId];
+            }
+            else {
+                let newBuild = [...parts.build];
+                if (pre.length == 1) {
+                    if (typeof pre[0] === 'number') {
+                        // CASE 1) prerelease is a number
+                        output = `${ultimateId}.${pre[0]}`;
+                        newPre = [ultimateId, 0];
+                        newBuild = [];
+                    }
+                    else {
+                        // CASE 2) just a string body - no numeric suffix
+                        newPre = [ultimateId, 0];
+                        newBuild = [];
+                    }
+                }
+                else if (pre.length == 2) {
+                    // CASE 3) string body with numeric suffix
+                    if (pre[0] === ultimateId) {
+                        // CASE 3A) id already in prerelease
+                        newPre = [...pre]; // id is already in the prerelease; keep it as is.
+                    }
+                    else {
+                        // CASE 3B) given version has a diff prerelease id
+                        newPre = [ultimateId, 0];
+                        newBuild = [];
+                    }
+                }
+                else {
+                    // more than two segments in prerelease?  
+                    // Is this the case when a build number is attached?  eg:  [id].[number]+[build] 
+                    newPre = [...pre]; // not supporting this case yet...  
+                }
+            }
+            output = `${parts.major}.${parts.minor}.${parts.patch}`;
+            if (newPre.length > 0) {
+                output = output.concat("-", newPre.join("."));
+            }
+        }
+        return output;
+    }
+    /** Rewrites the entire semantic version with the given semantic version.
+     *
+     * @param version (required) Must be a valid semantic version (eg: `1.2.3` or `1.2.3-something` or `1.2.3-something.4`).
+     */
+    bump(change) {
+        try {
+            let newVersion = "";
+            return newVersion;
+        }
+        catch (err) {
+            throw err;
+        }
+    }
+    /** Rewrites the entire semantic version with the given semantic version.
+     *
+     * @param version (required) Must be a valid semantic version (eg: `1.2.3` or `1.2.3-something` or `1.2.3-something.4`).
+     */
+    set(version) {
+        return this.bump({ fullName: version });
+    }
+    /** Increments the major number of the semantic version for the current image definition.
+     *
+     * That is: the term `[major]` in the version format:
+     * ```
+     * [major].[minor].[patch]-[prereleaseName].[prereleaseNumber]
+     * ```
+     *
+     * eg:  `1.2.3` becomes `2.0.0`
+     *
+     * eg:  `1.2.3-my-branch.3` becomes `2.0.0`
+     */
+    major() {
+        return this.bump({ major: true });
+    }
+    /** Increments the minor number of the semantic version for the current image definition.
+     *
+     * That is: the term `[minor]` in the version format:
+     * ```
+     * [major].[minor].[patch]-[prereleaseName].[prereleaseNumber]
+     * ```
+     *
+     * eg:  `1.2.3` becomes `1.3.0`
+     *
+     * eg:  `1.2.3-my-branch.3` becomes `1.3.0`
+     */
+    minor(newValue) {
+        return this.bump({ minor: true });
+    }
+    /** Increments the patch number of the semantic version for the current image definition.
+     *
+     * That is: the term `[patch]` in the version format:
+     * ```
+     * [major].[minor].[patch]-[prereleaseName].[prereleaseNumber]
+     * ```
+     *
+     * eg:  `1.2.3` becomes `1.2.4`
+     *
+     * eg:  `1.2.3-my-branch.3` becomes `1.2.3`
+     *
+     * *(note: NOT 1.2.4 because prereleases lead up to a patch release, thus the term "cut a version")*
+     */
+    patch() {
+        return this.bump({ patch: true });
+    }
+    /** Increments the prerelease of the semantic version for the current image definition.
+     * Passing in an alphanumeric prerelease name
+     * will prefix the number and delimit with a period (.).
+     *
+     * That is: the `[prereleaseName]` and `[prereleaseNumber]` terms in the version format:
+     * ```
+     * [major].[minor].[patch]-[prereleaseName].[prereleaseNumber]
+     * ```
+     *
+     * eg: without providing a name...
+     *
+     * `1.2.3` becomes `1.2.4-0`
+     *
+     * `1.2.3-my-branch.3` becomes `1.2.3-my-branch.4`
+     *
+     * `1.2.3-my-branch` becomes `1.2.3-my-branch.0`
+     *
+     * eg: providing "workitem-pdq" as name...
+     *
+     * `1.2.3` becomes `1.2.4-workitem-pdq.0`
+     *
+     * `1.2.3-workitem-pdq.0` becomes `1.2.3-workitem-pdq.1`
+     *
+     * `1.2.3-my-branch.3` becomes `1.2.3-workitem-pdq.0`
+     *
+     * `1.2.3-my-branch` becomes `1.2.3-workitem-pdq.0`
+     */
+    prerelease(name) {
+        return this.bump({ prerelease: true, preId: name });
+    }
+};
+SemanticVersioner = 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])
+], SemanticVersioner);
+exports.SemanticVersioner = SemanticVersioner;
+//# sourceMappingURL=workspace-versioner.js.map

package/dist/ops/workspace-versioner.js.map

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

package/dist/prettify.d.ts

@@ -0,0 +1,7 @@
+export declare type prettifyOptions = {
+    keyColor?: string;
+    valueColor?: string;
+    numberColor?: string;
+};
+/** Renders the given entity as YAML with color-coded keys and values. */
+export declare function prettify(entity: any, hideEntities?: string[], options?: prettifyOptions): string;

package/dist/prettify.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prettify = void 0;
+const cli_tools_1 = require("@codiac.io/cli-tools");
+const YAML = require("yaml");
+/** Renders the given entity as YAML with color-coded keys and values. */
+function prettify(entity, hideEntities = [], options) {
+    let output = YAML.stringify(entity, { indent: 2 });
+    let styler = new cli_tools_1.TtyOutputStyler();
+    let lines = output.split("\n");
+    for (let idx in lines) {
+        let line = lines[idx];
+        let pos = line.indexOf(":");
+        let value = line.substr(pos + 1);
+        const hide = hideEntities.find(f => (f !== undefined && f.trim() == value.trim()));
+        if (hide)
+            value = "*********";
+        lines[idx] = line.substr(0, pos + 1).concat(styler.hilite(value));
+    }
+    output = lines.join("\n");
+    return output;
+}
+exports.prettify = prettify;
+//# sourceMappingURL=prettify.js.map

package/dist/read-stdin.d.ts

@@ -0,0 +1,2 @@
+declare const readStdin: () => Promise<string | undefined>;
+export default readStdin;

package/dist/read-stdin.js

@@ -0,0 +1,29 @@
+"use strict";
+// Lifted from: https://github.com/oclif/oclif/issues/245#issuecomment-604413364
+// in 
+// https://github.com/hackmdio/hackmd-cli
+// 
+// https://github.com/hackmdio/hackmd-cli/blob/f4779995ad2a05aab676bcefa471df8886710624/src/read-stdin-stream.ts
+// https://github.com/hackmdio/hackmd-cli/blob/f4779995ad2a05aab676bcefa471df8886710624/src/index.ts#L18-L20
+Object.defineProperty(exports, "__esModule", { value: true });
+const readStdin = () => {
+    return new Promise(resolve => {
+        const stdin = process.openStdin();
+        stdin.setEncoding('utf-8');
+        let data = '';
+        stdin.on('data', chunk => {
+            data += chunk;
+        });
+        stdin.on('end', () => {
+            resolve(data);
+        });
+        stdin.on('error', (err) => {
+            resolve('');
+        });
+        if (stdin.isTTY) {
+            resolve('');
+        }
+    });
+};
+exports.default = readStdin;
+//# sourceMappingURL=read-stdin.js.map

package/dist/relay/contracts/contracts.d.ts

@@ -0,0 +1,207 @@
+import { CriteriaBase, StringFilter } from "@codiac.io/codiac-common/contracts";
+/** Identifier for a supported cloud service provider, for use in selecting infrastructure clients, provisioners, and credentials. */
+export declare enum CloudProviderEnum {
+    "azure" = "azure",
+    "aws" = "aws",
+    "dockerHub" = "dockerHub",
+    "other" = "other"
+}
+/** List of codenames for supported KeyValue stores.
+ * eg: Clients for these types of stores are registered under these values.  */
+export declare enum KvpStoreTypesEnum {
+    azKeyVault = "azKeyVault",
+    awsKeyVault = "awsKeyVault",
+    azBlob = "azBlob",
+    mongoCollection = "mongoCollection",
+    mongoDocument = "mongoDocument",
+    etcd = "etcd"
+}
+/** Identifying and access information for a living, breathing, concrete instance
+ * of a key value store resource in a cloud provider subscription. */
+export declare abstract class CloudResourceInstance {
+    name: string;
+    provider: CloudProviderEnum;
+    resourceId: string;
+    /**
+     * @param name The friendly, human-readable identifier of this resource,
+     *  as it is known by the cloud provider.
+     *  Its name is unique only within the resource group containing the instance,
+     *  and it necessarily matches the name of the definition from which it was spawned.
+     * @param provider  The third party cloud service provider that is hosting this resource.
+     * @param resourceId The Id given by the csp.
+     * @param id The id assigned to this entity by the codiac database.
+     */
+    constructor(name: string, provider: CloudProviderEnum, resourceId: string, id?: string, modified?: Date, modifiedBy?: string, created?: Date, createdBy?: string);
+    id: string | undefined;
+    createdBy: string;
+    modifiedBy: string;
+    created: Date;
+    modified: Date;
+}
+export declare class KvpStoreInfrx extends CloudResourceInstance {
+    type: KvpStoreTypesEnum;
+    constructor(name: string, provider: CloudProviderEnum, type: KvpStoreTypesEnum, resourceId: string, id?: string, modified?: Date, modifiedBy?: string, created?: Date, createdBy?: string);
+}
+/** The specs for a key value store to be managed by the codiac system.
+ * This class is used to programmatically put up and take down concrete key value stores. */
+export declare class KvpStoreDef {
+    name: string;
+    provider: CloudProviderEnum;
+    type: KvpStoreTypesEnum;
+    instance?: KvpStoreInfrx | undefined;
+    /**
+     * @param name  The friendly identifying name under which the key value store resource is registered within an enterprise.  The concrete instance that gets created will use this name (if the instance exists already, this property must match the name of the concrete instance).
+     * @param type  Differentiator for key value store resources (eg: KeyVault, etcd, mongo, etc) and their various implementations.
+     * @param instance  Info describing the concrete instance of this kvp store actually living within a cloud provider subscription.
+     */
+    constructor(name: string, provider: CloudProviderEnum, type: KvpStoreTypesEnum, instance?: KvpStoreInfrx | undefined, id?: string, modified?: Date, modifiedBy?: string, created?: Date, createdBy?: string);
+    id: string | undefined;
+    createdBy: string;
+    modifiedBy: string;
+    created: Date;
+    modified: Date;
+}
+export declare class KvpStoreDefCriteria extends CriteriaBase<KvpStoreDef> {
+    name?: string;
+    provider?: CloudProviderEnum;
+    type?: KvpStoreTypesEnum;
+}
+/** Representation of a secret store managed service on a cloud provider.
+ */
+export declare class SecretStoreDef extends KvpStoreDef {
+    constructor(name: string, provider: CloudProviderEnum, type: KvpStoreTypesEnum, instance?: SecretStore | undefined, id?: string, modified?: Date, modifiedBy?: string, created?: Date, createdBy?: string);
+}
+export declare class SecretStore extends KvpStoreInfrx {
+    constructor(name: string, resourceId: string, provider: CloudProviderEnum, type: KvpStoreTypesEnum, id?: string, modified?: Date, modifiedBy?: string, created?: Date, createdBy?: string);
+}
+export declare class AzureKeyVaultDef extends SecretStoreDef {
+    resourceGroup: string;
+    tenantId: string;
+    subscriptionId: string;
+    location: string;
+    azVaultSku: "standard" | "premium";
+    instance?: AzureKeyVault | undefined;
+    constructor(name: string, resourceGroup: string, tenantId: string, subscriptionId: string, location: string, azVaultSku?: "standard" | "premium", instance?: AzureKeyVault | undefined);
+}
+export declare class AzureKeyVault extends SecretStore {
+    resourceGroup: string;
+    tenantId: string;
+    subscriptionId: string;
+    location: string;
+    vaultUri: string;
+    constructor(name: string, resourceId: string, resourceGroup: string, tenantId: string, subscriptionId: string, location: string, vaultUri: string);
+}
+export declare class AwsSecretStoreDef extends SecretStoreDef {
+    accountId: string;
+    region: string;
+    instance?: AwsSecretStore | undefined;
+    constructor(name: string, accountId: string, region: string, instance?: AwsSecretStore | undefined);
+}
+export declare class AwsSecretStore extends SecretStore {
+    accountId: string;
+    region: string;
+    constructor(name: string, resourceId: string, accountId: string, region: string);
+}
+/** Limited details of a Storage Account. */
+export interface IStorageAccountEndpointUrls {
+    web?: string;
+    dfs?: string;
+    blob?: string;
+    file?: string;
+    queue?: string;
+    table?: string;
+}
+export declare class StorageAccount {
+    name: string;
+    location: string;
+    primaryEndpoints: IStorageAccountEndpointUrls;
+    constructor(name: string, location: string, primaryEndpoints: IStorageAccountEndpointUrls, id?: string);
+    id: string | undefined;
+}
+export declare class StorageAccountKey {
+    keyName: string;
+    permissions: "Full" | "Read";
+    value: string;
+    constructor(keyName: string, permissions: "Full" | "Read", value: string);
+}
+/** Supported file store adapters that can be mapped to a reserved folder on an asset. */
+export declare enum FileStoreTypeEnum {
+    AzureFileStorage = "AzureFileStorage",
+    AzureBlobStorage = "AzureBlobStorage",
+    AzureDisk = "AzureDisk",
+    HostMachineFolder = "HostMachineFolder"
+}
+/** Abstraction and specification for a share on a file store,
+ *  to be mapped to a reserved folder on an asset.
+ *
+ *  This class can be used as the specification
+ *  to programmatically put up and take down concrete file stores.
+ *  As such, it outlives the actual entity described by its "instance" property.
+ *
+ * @param name  The name by which to identify this fileshare definition within the enterprise (Optional: defaults to the shareName).
+ * @param type  Indicator of which type of fileshare resource is being used.
+ * @param storageAccount  The name within the cloud provider of the file storage account within which the share resides.
+ * @param shareName  The name of the fileshare to connect to within the file storage account.
+ * @param providerSubscriptionId The Id of the physical Cloud Provider Subscription in which this filestore exists (Azure-specific).
+ * @param resourceGroup  The name of the Azure resource group under which the instance is to be created  (Azure-specific).
+ * @param instance  Info describing the concrete instance of this file store actually living within a cloud provider subscription.
+ */
+export declare class FileStoreDef {
+    name: string;
+    type: FileStoreTypeEnum;
+    storageAccount: string;
+    shareName: string;
+    providerSubscriptionId: string;
+    resourceGroup: string;
+    instance?: FileStoreInfrx | undefined;
+    constructor(name: string, type: FileStoreTypeEnum, storageAccount: string, shareName: string, providerSubscriptionId: string, resourceGroup: string, instance?: FileStoreInfrx | undefined, id?: string, modified?: Date, modifiedBy?: string, created?: Date, createdBy?: string);
+    id: string | undefined;
+    createdBy: string;
+    modifiedBy: string;
+    created: Date;
+    modified: Date;
+}
+/** Metadata describing an existing concrete instance
+*  of a FileStoreDef resource within a cloud provider.  */
+export declare class FileStoreInfrx {
+    providerSubscriptionId: string;
+    resourceGroup: string;
+    resourceId: string;
+    accessKey: string;
+    /**
+     * @param providerSubscriptionId The Id of the physical Cloud Provider Subscription in which this filestore exists (Azure-specific).
+     * @param resourceGroup Name of the Azure resource group containing the filestore itself (Azure-specific).
+     * @param resourceId The unique identifier given by the cloud provider to the file storage account.
+     * @param accessKey The key generated upon creation of the FileStore, to enable the consumer to attach to it.
+     */
+    constructor(providerSubscriptionId: string, resourceGroup: string, resourceId: string, accessKey: string);
+}
+export declare class FileStoreDefCriteria extends CriteriaBase<FileStoreDef> {
+    name?: StringFilter | undefined;
+    type?: FileStoreTypeEnum | undefined;
+    shareName?: StringFilter | undefined;
+    providerSubscriptionId?: StringFilter | undefined;
+    constructor(name?: StringFilter | undefined, type?: FileStoreTypeEnum | undefined, shareName?: StringFilter | undefined, providerSubscriptionId?: StringFilter | undefined);
+}
+/** An object representation of a config file, assembled from ScopedSettings.
+ * This document can take any form, and is constructed solely from settings and values,
+ * with all meta information omitted to preserve the integrity of the ultimate config file.
+ * NOTE: To view the list of un-smashed settings with metadata from which this document is assembled,
+ * fire the same request object against the ScopedSetting endpoint.  */
+export declare class ConfigDoc {
+    id?: string | undefined;
+    constructor(id?: string | undefined);
+}
+/** Identifies a single asset replica. */
+export declare type AssetReplicaContext = {
+    asset: string;
+    enterprise: string;
+    environment: string;
+    cabinet: string;
+    replica?: string | undefined;
+};
+export declare type K8sContainerContext = {
+    namespace: string;
+    pod?: string | undefined;
+    container?: string | undefined;
+};