@codiac.io/codiac-cli 1.2.174 → 1.2.202

package/dist/ops/entities/ThaulConfig.js

@@ -0,0 +1,30 @@
+"use strict";
+// import { Submodule } from './submodule';
+// import { genericDictionary } from '@codiac.io/codiac-common';
+// import { ImageExport } from '@codiac.io/codiac-relay-contracts/image-export';
+// import { PackageExport } from './package-export';
+// /** Settings for an API project.
+//  *  @param name Friendly title of the Api project.  THis is NOT used for system identification (use "apiCode" to uniquely identify the service itself). 
+//  * @param tenantCode Identifier for the Toyhauler tenant to which this api belongs.
+//  */
+// export class ProjectConfig {
+//   /** The filename used when serializing the ThaulConfig object. */
+//   public static FILENAME = 'thaulconfig.json'
+//   constructor(public name: string, public tenantCode: string) {
+//     this.submodules = [];
+//   }
+//   /** The identifier for the cicd pipeline to which this api project is bound */
+//   public pipelineCode: string | undefined;
+//   /** The registered identifier for the api project. */
+//   public apiCode: string | undefined;
+//   public submodules: Submodule[];
+//   /** Declares the packages that are to be published.  */
+//   public packages?: genericDictionary<PackageExport>
+//   /** Describes the registry to which a container image is to be published,  
+//    * as well as any credentials for doing so. */
+//   public images?: genericDictionary<ImageExport>
+//   /** Memorized command calls, ie: argument configurations for built in commands that can be called for by name.  */
+//   // public namedCalls?: { [command: string]: { [name: string]: string } };
+//   public namedCalls?: { [command: string]: { [name: string]: { args: Object, flags: Object } } };
+// }
+//# sourceMappingURL=ThaulConfig.js.map

package/dist/ops/entities/azure-service-principal.d.ts

@@ -0,0 +1,23 @@
+export declare class AzureServicePrincipal {
+    /** (guid) The id of the service principal, used when assigining permissions. eg: "bf52a5ea-3663-476c-bb54-aacf9a1b39db", */
+    appId: string;
+    /** The human readable name we give to the service principal.  eg: "svc-princ-devcluster1", */
+    displayName: string;
+    /** full url by which Azure identifies the service principal.  eg: "http://svc-princ-devcluster1", */
+    name: string;
+    /** (guid) This password is typically generated on creation and thus needs to be persisted for future use (eg: needed when creating a cluster). */
+    password: string;
+    /** (guid) The id of the Azure account holder.  NOTE: This is NOT the subscription id. */
+    tenant: string;
+    constructor(
+    /** (guid) The id of the service principal, used when assigining permissions. eg: "bf52a5ea-3663-476c-bb54-aacf9a1b39db", */
+    appId: string, 
+    /** The human readable name we give to the service principal.  eg: "svc-princ-devcluster1", */
+    displayName: string, 
+    /** full url by which Azure identifies the service principal.  eg: "http://svc-princ-devcluster1", */
+    name: string, 
+    /** (guid) This password is typically generated on creation and thus needs to be persisted for future use (eg: needed when creating a cluster). */
+    password: string, 
+    /** (guid) The id of the Azure account holder.  NOTE: This is NOT the subscription id. */
+    tenant: string);
+}

package/dist/ops/entities/azure-service-principal.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AzureServicePrincipal = void 0;
+class AzureServicePrincipal {
+    constructor(
+    /** (guid) The id of the service principal, used when assigining permissions. eg: "bf52a5ea-3663-476c-bb54-aacf9a1b39db", */
+    appId, 
+    /** The human readable name we give to the service principal.  eg: "svc-princ-devcluster1", */
+    displayName, 
+    /** full url by which Azure identifies the service principal.  eg: "http://svc-princ-devcluster1", */
+    name, 
+    /** (guid) This password is typically generated on creation and thus needs to be persisted for future use (eg: needed when creating a cluster). */
+    password, 
+    /** (guid) The id of the Azure account holder.  NOTE: This is NOT the subscription id. */
+    tenant) {
+        this.appId = appId;
+        this.displayName = displayName;
+        this.name = name;
+        this.password = password;
+        this.tenant = tenant;
+    }
+}
+exports.AzureServicePrincipal = AzureServicePrincipal;
+//# sourceMappingURL=azure-service-principal.js.map

package/dist/ops/entities/better-logger.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=better-logger.js.map

package/dist/ops/entities/branch.d.ts

@@ -0,0 +1,13 @@
+/**
+ *  A branch in source control.
+ * @param name Name of the branch (without its "ref" prefixing - eg: "refs/heads/..")
+ * @param isCurrent Flag denoting that this branch is currently active in git on the local machine.
+ */
+export declare class Branch {
+    name: string;
+    isCurrent: boolean;
+    constructor(name: string, isCurrent?: boolean);
+    /** The name of the remote origin to which this local branch is bound.
+     * ie:  the remote branch to which this branch is set up to push. */
+    upstream: string | undefined;
+}

package/dist/ops/entities/branch.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Branch = void 0;
+/**
+ *  A branch in source control.
+ * @param name Name of the branch (without its "ref" prefixing - eg: "refs/heads/..")
+ * @param isCurrent Flag denoting that this branch is currently active in git on the local machine.
+ */
+class Branch {
+    constructor(name, isCurrent = false) {
+        this.name = name;
+        this.isCurrent = isCurrent;
+    }
+}
+exports.Branch = Branch;
+//# sourceMappingURL=branch.js.map

package/dist/ops/entities/cli-config.d.ts

@@ -0,0 +1,48 @@
+/** Basic local environment info about the current instance of the cli process.
+ */
+export declare class CliEnviro {
+    cliConfigDir: string;
+    version: string;
+    constructor(cliConfigDir: string, version: string);
+}
+/** Basic codiac project info for the current instance of the cli process.
+ */
+export declare class ProjectEnviro {
+    projectRoot: string;
+    constructor(projectRoot: string);
+}
+/** Configuration for the Toyhauler CLI (command Line Interface) itself.
+ *  This onfiguration is global for the install of the CLI.
+ */
+export declare class CliConfig {
+    static readonly FILENAME = "globalconfig.json";
+    constructor();
+    /** The url for the Toyhauler Authentication API, for use with the package: toyhauler-auth-client. */
+    authApiBaseUrl: string | undefined;
+    /** The url for the Toyhauler API, for use with the package: toyhauler-api-client. */
+    codiacApiBaseUrl: string | undefined;
+    /** Declares that the console should render all output details
+     * LogLevels rendered for each setting are as follows:
+     * normal: notice, warn, error, and fatal;
+     * detail: adds detail;
+     * debug: adds debug and trace. */
+    verbosity: Verbosity;
+    /** WHen incrementing a prerelease version,
+     * the prerelease version segment will be prefixed
+     * with the branch name
+     *
+     * using format:  `[major].[minor].[patch]-[branch].[prereleaseNumber]`
+     *
+     * eg:  `1.2.3-4`  becomes  `1.2.3-thisBranch.5`   */
+    addBranchNameToPrereleases: boolean | undefined;
+}
+/** User setting for console output volume.
+ * LogLevels rendered for each setting are as follows:
+ * normal: notice, warn, error, and fatal;
+ * detail: adds detail;
+ * debug: adds debug and trace. */
+export declare enum Verbosity {
+    normal = "normal",
+    detail = "detail",
+    debug = "debug"
+}

package/dist/ops/entities/cli-config.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Verbosity = exports.CliConfig = exports.ProjectEnviro = exports.CliEnviro = void 0;
+const tslib_1 = require("tslib");
+const inversify_1 = require("inversify");
+/** Basic local environment info about the current instance of the cli process.
+ */
+let CliEnviro = class CliEnviro {
+    constructor(cliConfigDir, version) {
+        this.cliConfigDir = cliConfigDir;
+        this.version = version;
+    }
+};
+CliEnviro = tslib_1.__decorate([
+    (0, inversify_1.injectable)(),
+    tslib_1.__metadata("design:paramtypes", [String, String])
+], CliEnviro);
+exports.CliEnviro = CliEnviro;
+/** Basic codiac project info for the current instance of the cli process.
+ */
+let ProjectEnviro = class ProjectEnviro {
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot;
+    }
+};
+ProjectEnviro = tslib_1.__decorate([
+    (0, inversify_1.injectable)(),
+    tslib_1.__metadata("design:paramtypes", [String])
+], ProjectEnviro);
+exports.ProjectEnviro = ProjectEnviro;
+/** Configuration for the Toyhauler CLI (command Line Interface) itself.
+ *  This onfiguration is global for the install of the CLI.
+ */
+let CliConfig = class CliConfig {
+    constructor() {
+        /** Declares that the console should render all output details
+         * LogLevels rendered for each setting are as follows:
+         * normal: notice, warn, error, and fatal;
+         * detail: adds detail;
+         * debug: adds debug and trace. */
+        this.verbosity = Verbosity.normal;
+    }
+};
+CliConfig.FILENAME = 'globalconfig.json';
+CliConfig = tslib_1.__decorate([
+    (0, inversify_1.injectable)(),
+    tslib_1.__metadata("design:paramtypes", [])
+], CliConfig);
+exports.CliConfig = CliConfig;
+/** User setting for console output volume.
+ * LogLevels rendered for each setting are as follows:
+ * normal: notice, warn, error, and fatal;
+ * detail: adds detail;
+ * debug: adds debug and trace. */
+var Verbosity;
+(function (Verbosity) {
+    Verbosity["normal"] = "normal";
+    Verbosity["detail"] = "detail";
+    Verbosity["debug"] = "debug";
+})(Verbosity = exports.Verbosity || (exports.Verbosity = {}));
+//# sourceMappingURL=cli-config.js.map

package/dist/ops/entities/cli-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-config.js","sourceRoot":"","sources":["../../../src/ops/entities/cli-config.ts"],"names":[],"mappings":";;;;AACA,yCAAuC;AAGvC;GACG;AAEF,IAAa,SAAS,GAAtB,MAAa,SAAS;IACpB,YAAmB,YAAoB,EAAS,OAAe;QAA5C,iBAAY,GAAZ,YAAY,CAAQ;QAAS,YAAO,GAAP,OAAO,CAAQ;IAE/D,CAAC;CACF,CAAA;AAJY,SAAS;IADrB,IAAA,sBAAU,GAAE;;GACA,SAAS,CAIrB;AAJY,8BAAS;AAOtB;GACG;AAEF,IAAa,aAAa,GAA1B,MAAa,aAAa;IACxB,YAAmB,WAAmB;QAAnB,gBAAW,GAAX,WAAW,CAAQ;IAEtC,CAAC;CACF,CAAA;AAJY,aAAa;IADzB,IAAA,sBAAU,GAAE;;GACA,aAAa,CAIzB;AAJY,sCAAa;AAM5B;;GAEG;AAEH,IAAa,SAAS,GAAtB,MAAa,SAAS;IAGpB;QAUA;;;;0CAIkC;QAC3B,cAAS,GAAc,SAAS,CAAC,MAAM,CAAC;IAb/C,CAAC;CAuBF,CAAA;AA3BwB,kBAAQ,GAAG,mBAAoB,CAAA;AAD3C,SAAS;IADrB,IAAA,sBAAU,GAAE;;GACA,SAAS,CA4BrB;AA5BY,8BAAS;AA+BtB;;;;kCAIkC;AAClC,IAAY,SAIX;AAJD,WAAY,SAAS;IACnB,8BAAiB,CAAA;IACjB,8BAAiB,CAAA;IACjB,4BAAe,CAAA;AACjB,CAAC,EAJW,SAAS,GAAT,iBAAS,KAAT,iBAAS,QAIpB"}

package/dist/ops/entities/docker-image.d.ts

@@ -0,0 +1,60 @@
+export declare class DockerImage {
+    Id: string;
+    RepoTags: [];
+    RepoDigests: [];
+    Parent: string;
+    Comment: string;
+    Created: Date;
+    Container: string;
+    ContainerConfig: {
+        Hostname: string;
+        Domainname: string;
+        User: string;
+        AttachStdin: boolean;
+        AttachStdout: boolean;
+        AttachStderr: boolean;
+        Tty: boolean;
+        OpenStdin: boolean;
+        StdinOnce: boolean;
+        Env: string;
+        Cmd: string;
+        Image: string;
+        Volumes: string;
+        WorkingDir: string;
+        Entrypoint: string;
+        OnBuild: string;
+        Labels: string;
+    };
+    DockerVersion: string;
+    Author: string;
+    Config: {
+        Hostname: string;
+        Domainname: string;
+        User: string;
+        AttachStdin: boolean;
+        AttachStdout: boolean;
+        AttachStderr: boolean;
+        ExposedPorts: {};
+        Tty: boolean;
+        OpenStdin: boolean;
+        StdinOnce: boolean;
+        Env: [];
+        Cmd: [];
+        ArgsEscaped: boolean;
+        Image: string;
+        Volumes: [];
+        WorkingDir: string;
+        Entrypoint: [];
+        Labels: {};
+    };
+    Architecture: string;
+    Os: string;
+    Size: number;
+    VirtualSize: number;
+    GraphDriver: {
+        Data: {};
+        Name: string;
+    };
+    RootFS: {};
+    Metadata: {};
+}

package/dist/ops/entities/docker-image.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=docker-image.js.map

package/dist/ops/entities/helm-spec.d.ts

@@ -0,0 +1,15 @@
+/** Reference to an existing Helm chart. */
+export declare class HelmChart {
+    name: string;
+    version: string;
+    repoName: string;
+    repoUrl: string;
+    constructor(name: string, version: string, repoName: string, repoUrl: string);
+}
+/** Input for installation of an Asset delivered as a Helm chart. */
+export declare class HelmSpec {
+    chart: HelmChart;
+    name: string;
+    namespace: string;
+    constructor(chart: HelmChart, name: string, namespace: string);
+}

package/dist/ops/entities/helm-spec.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HelmSpec = exports.HelmChart = void 0;
+/** Reference to an existing Helm chart. */
+class HelmChart {
+    constructor(name, version, repoName, repoUrl) {
+        this.name = name;
+        this.version = version;
+        this.repoName = repoName;
+        this.repoUrl = repoUrl;
+    }
+}
+exports.HelmChart = HelmChart;
+/** Input for installation of an Asset delivered as a Helm chart. */
+class HelmSpec {
+    constructor(chart, name, namespace) {
+        this.chart = chart;
+        this.name = name;
+        this.namespace = namespace;
+    }
+}
+exports.HelmSpec = HelmSpec;
+//# sourceMappingURL=helm-spec.js.map

package/dist/ops/entities/index.d.ts

@@ -0,0 +1,4 @@
+export * from './operation-meta';
+export * from './PipelineContext';
+export * from './scaffolding';
+export * from "./cli-config";

package/dist/ops/entities/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+// export * from '@codiac.io/codiac-relay-contracts/package-export';
+tslib_1.__exportStar(require("./operation-meta"), exports);
+tslib_1.__exportStar(require("./PipelineContext"), exports);
+// export * from '@codiac.io/codiac-relay-contracts/project-config';
+tslib_1.__exportStar(require("./scaffolding"), exports);
+// export * from '@codiac.io/codiac-relay-contracts/scoped-config';
+// export * from '@codiac.io/codiac-relay-contracts/submodule';
+tslib_1.__exportStar(require("./cli-config"), exports);
+//# sourceMappingURL=index.js.map

package/dist/ops/entities/operation-meta.d.ts

@@ -0,0 +1,8 @@
+/** Common reference info among correlated transactions. */
+export declare class OperationMeta {
+    /** Identifier for a whole operation, linking each step from the original initiator to the last incremental step. */
+    correlationId: string;
+    constructor(
+    /** Identifier for a whole operation, linking each step from the original initiator to the last incremental step. */
+    correlationId: string);
+}

package/dist/ops/entities/operation-meta.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OperationMeta = void 0;
+const tslib_1 = require("tslib");
+const inversify_1 = require("inversify");
+/** Common reference info among correlated transactions. */
+let OperationMeta = class OperationMeta {
+    constructor(
+    /** Identifier for a whole operation, linking each step from the original initiator to the last incremental step. */
+    correlationId) {
+        this.correlationId = correlationId;
+    }
+};
+OperationMeta = tslib_1.__decorate([
+    (0, inversify_1.injectable)(),
+    tslib_1.__metadata("design:paramtypes", [String])
+], OperationMeta);
+exports.OperationMeta = OperationMeta;
+//# sourceMappingURL=operation-meta.js.map

package/dist/ops/entities/operation-meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-meta.js","sourceRoot":"","sources":["../../../src/ops/entities/operation-meta.ts"],"names":[],"mappings":";;;;AAAA,yCAAuC;AAEvC,2DAA2D;AAE3D,IAAa,aAAa,GAA1B,MAAa,aAAa;IACxB;IACE,oHAAoH;IAC7G,aAAqB;QAArB,kBAAa,GAAb,aAAa,CAAQ;IAG9B,CAAC;CACF,CAAA;AAPY,aAAa;IADzB,IAAA,sBAAU,GAAE;;GACA,aAAa,CAOzB;AAPY,sCAAa"}

package/dist/ops/entities/scaffolding.d.ts

@@ -0,0 +1,19 @@
+import { ProjectConfig } from '@codiac.io/codiac-relay-contracts';
+import { LocalOps } from '../LocalOps';
+export declare type ProjectInitHandler = (iconfig: ProjectConfig) => Promise<void>;
+/**
+ * Parameters for initializing a new codiac project.
+ * @param sccIgnoreFile Ignore specification for the source code control provider.
+ *        This file is the first one scaffolded in to prevent the node_modules crazy folder contents
+ *        from overwhelming the source code provider's change tracker.
+ */
+export declare class Scaffolding {
+    name: string;
+    npmDependencies: string[];
+    npmDevDependencies: string[];
+    scaffoldFolders: string[];
+    scaffoldFiles: string[];
+    sccIgnoreFile?: string | undefined;
+    constructor(name: string, npmDependencies?: string[], npmDevDependencies?: string[], scaffoldFolders?: string[], scaffoldFiles?: string[], sccIgnoreFile?: string | undefined);
+    afterInitHandler?: (projectRoot: string, config: ProjectConfig, localOps: LocalOps) => Promise<void>;
+}

package/dist/ops/entities/scaffolding.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Scaffolding = void 0;
+/**
+ * Parameters for initializing a new codiac project.
+ * @param sccIgnoreFile Ignore specification for the source code control provider.
+ *        This file is the first one scaffolded in to prevent the node_modules crazy folder contents
+ *        from overwhelming the source code provider's change tracker.
+ */
+class Scaffolding {
+    constructor(name, npmDependencies = [], npmDevDependencies = [], scaffoldFolders = [], scaffoldFiles = [], sccIgnoreFile) {
+        this.name = name;
+        this.npmDependencies = npmDependencies;
+        this.npmDevDependencies = npmDevDependencies;
+        this.scaffoldFolders = scaffoldFolders;
+        this.scaffoldFiles = scaffoldFiles;
+        this.sccIgnoreFile = sccIgnoreFile;
+    }
+}
+exports.Scaffolding = Scaffolding;
+//# sourceMappingURL=scaffolding.js.map

package/dist/ops/extensions/azart-identity-adapter.d.ts

@@ -0,0 +1,19 @@
+import { IBetterLogger } from '@codiac.io/codiac-common/IBetterLogger';
+import { IdentityProvider, TokenizedIdentity } from '@codiac.io/codiac-relay-contracts';
+import { IIdentityAdapter } from '../i-identity-handler';
+import { npmrcIdentity } from './npm-identity-adapter-base';
+export declare class azartIdentity extends TokenizedIdentity {
+    organization: string;
+    feed: string;
+    email: string;
+    constructor(provider: IdentityProvider, registryUrl: string, token: string, organization: string, feed: string, email: string, scope?: string | undefined, tokenName?: string | undefined);
+}
+export declare class azartIdentityAdapter implements IIdentityAdapter {
+    private _projectRoot;
+    private logger;
+    constructor(_projectRoot: string, logger: IBetterLogger);
+    readonly provider = IdentityProvider["azart"];
+    createIdentity(token: string, input: any): TokenizedIdentity;
+    protected buildDefaultRegistryUrl(organization: string, feed: string): string;
+    syncIdentities(identities: TokenizedIdentity[]): Promise<npmrcIdentity[]>;
+}

package/dist/ops/extensions/azart-identity-adapter.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.azartIdentityAdapter = exports.azartIdentity = void 0;
+const tslib_1 = require("tslib");
+const codiac_relay_contracts_1 = require("@codiac.io/codiac-relay-contracts");
+class azartIdentity extends codiac_relay_contracts_1.TokenizedIdentity {
+    constructor(provider, registryUrl, token, organization, feed, email, scope, tokenName) {
+        super(provider, registryUrl, token, scope, tokenName);
+        this.organization = organization;
+        this.feed = feed;
+        this.email = email;
+    }
+}
+exports.azartIdentity = azartIdentity;
+class azartIdentityAdapter {
+    constructor(_projectRoot, logger) {
+        this._projectRoot = _projectRoot;
+        this.logger = logger;
+        this.provider = codiac_relay_contracts_1.IdentityProvider.azart;
+    }
+    createIdentity(token, input) {
+        if (!input.organization || !input.feed || !input.email) {
+            throw new Error(`Incomplete input: a ${this.provider} identity requires entries for organization, feed, and email.`);
+        }
+        let regUrl = input.registryUrl || this.buildDefaultRegistryUrl(input.organization, input.feed);
+        return new azartIdentity(this.provider, regUrl, token, input.organization, input.feed, input.email, input.scope, input.tokenName);
+    }
+    buildDefaultRegistryUrl(organization, feed) {
+        return `pkgs.dev.azure.com/${organization}/_packaging/${feed}/npm/registry/`;
+    }
+    syncIdentities(identities) {
+        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 {
+                    // from:  https://dev.azure.com/codiacdevops/Codiac/_packaging?_a=connect&feed=codiacdevops
+                    //
+                    // USER npmrc:
+                    // pkgs.dev.azure.com/codiacdevops/_packaging/codiacdevops/npm/registry/:username=codiacdevops
+                    // pkgs.dev.azure.com/codiacdevops/_packaging/codiacdevops/npm/registry/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
+                    // pkgs.dev.azure.com/codiacdevops/_packaging/codiacdevops/npm/registry/:email=npm requires email to be set but doesn't use the value
+                    // pkgs.dev.azure.com/codiacdevops/_packaging/codiacdevops/npm/:username=codiacdevops
+                    // pkgs.dev.azure.com/codiacdevops/_packaging/codiacdevops/npm/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
+                    // pkgs.dev.azure.com/codiacdevops/_packaging/codiacdevops/npm/:email=npm requires email to be set but doesn't use the value
+                    // PROJECT npmrc:
+                    // registry=https://pkgs.dev.azure.com/codiacdevops/_packaging/codiacdevops/npm/registry/
+                    // always-auth=true
+                    // ...but from https://docs.microsoft.com/en-us/azure/devops/artifacts/get-started-npm?view=azure-devops&tabs=mac
+                    // USER npmrc:
+                    // pkgs.dev.azure.com/<yourorganization>/_packaging/<yourfeed>/npm/registry/:username=ANYTHING-BUT-EMPTY
+                    // pkgs.dev.azure.com/<yourorganization>/_packaging/<yourfeed>/npm/registry/:_password=BASE64-ENCODED-PAT-GOES-HERE
+                    // pkgs.dev.azure.com/<yourorganization>/_packaging/<yourfeed>/npm/registry/:email=YOUREMAIL@EXAMPLE.COM
+                    // pkgs.dev.azure.com/<yourorganization>/_packaging/<yourfeed>/npm/registry/:always-auth=true
+                    let ours = identities.filter(x => x.provider == this.provider);
+                    let overridingDefaultRegistry = false;
+                    let lastDefaultReg = "";
+                    let npmrcEntries = [];
+                    for (let index in ours) {
+                        let identity = ours[index];
+                        let registryUrl = identity.registryUrl;
+                        // Proj-user-level
+                        let projUserEntries = {};
+                        let tokenSetting = `${registryUrl}:_password`;
+                        projUserEntries[tokenSetting] = identity.token;
+                        projUserEntries[`${registryUrl}:username`] = identity.organization;
+                        projUserEntries[`${registryUrl}:email`] = identity.email;
+                        // Proj-level
+                        let projEntries = {};
+                        if (identity.scope) {
+                            projEntries[`${identity.scope}:registry`] = registryUrl;
+                            projEntries[`${identity.scope}:always-auth`] = "true";
+                        }
+                        else {
+                            projEntries["registry"] = registryUrl;
+                            projEntries["always-auth"] = "true";
+                            // This will knock npmjs off the list.  
+                            // If they need both, one of them will need to operate from a scope.
+                            overridingDefaultRegistry = true;
+                            lastDefaultReg = registryUrl;
+                        }
+                        npmrcEntries.push({
+                            identity: identity,
+                            tokenSetting: tokenSetting,
+                            projUserEntries: projUserEntries,
+                            projEntries: projEntries
+                        });
+                    }
+                    resolve(npmrcEntries);
+                }
+                catch (err) {
+                    reject(err);
+                }
+            }));
+        });
+    }
+}
+exports.azartIdentityAdapter = azartIdentityAdapter;
+//# sourceMappingURL=azart-identity-adapter.js.map

package/dist/ops/extensions/npm-identity-adapter-base.d.ts

@@ -0,0 +1,13 @@
+import { TokenizedIdentity } from '@codiac.io/codiac-relay-contracts';
+/** A holder for a given identity of the lines that need to be added
+ * to the project- and user- npmrc files.  */
+export declare type npmrcIdentity = {
+    identity: TokenizedIdentity;
+    tokenSetting: string;
+    projUserEntries: {
+        [key: string]: string;
+    };
+    projEntries: {
+        [key: string]: string;
+    };
+};

package/dist/ops/extensions/npm-identity-adapter-base.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=npm-identity-adapter-base.js.map

package/dist/ops/extensions/npmjs-identity-adapter.d.ts

@@ -0,0 +1,13 @@
+import { IBetterLogger } from '@codiac.io/codiac-common/IBetterLogger';
+import { IdentityProvider, TokenizedIdentity } from '@codiac.io/codiac-relay-contracts';
+import { IIdentityAdapter } from "../i-identity-handler";
+import { npmrcIdentity } from './npm-identity-adapter-base';
+export declare class npmjsIdentityAdapter implements IIdentityAdapter {
+    private _projectRoot;
+    private logger;
+    constructor(_projectRoot: string, logger: IBetterLogger);
+    readonly provider = IdentityProvider["npm"];
+    private readonly DEFAULT_REGISTRY_URL;
+    createIdentity(token: string, input: any): TokenizedIdentity;
+    syncIdentities(identities: TokenizedIdentity[]): Promise<npmrcIdentity[]>;
+}

package/dist/ops/extensions/npmjs-identity-adapter.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.npmjsIdentityAdapter = void 0;
+const tslib_1 = require("tslib");
+const codiac_relay_contracts_1 = require("@codiac.io/codiac-relay-contracts");
+class npmjsIdentityAdapter {
+    constructor(_projectRoot, logger) {
+        this._projectRoot = _projectRoot;
+        this.logger = logger;
+        this.provider = codiac_relay_contracts_1.IdentityProvider.npm;
+        this.DEFAULT_REGISTRY_URL = "http://registry.npmjs.org/";
+    }
+    createIdentity(token, input) {
+        let regUrl = input.registryUrl || this.DEFAULT_REGISTRY_URL;
+        let identity = new codiac_relay_contracts_1.TokenizedIdentity(this.provider, regUrl, token, input.scope, input.tokenName);
+        return identity;
+    }
+    syncIdentities(identities) {
+        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 npmrcEntries = [];
+                    let ours = identities.filter(x => x.provider == this.provider);
+                    for (let index in ours) {
+                        let identity = ours[index];
+                        let registryUrl = identity.registryUrl;
+                        // Proj-user-level
+                        let projUserEntries = {};
+                        // IMPORTANT!!  This key (the name of the variable we're inserting) is the registry url with the http segment removed !!!
+                        let regKey = registryUrl;
+                        if (registryUrl.indexOf("://") > 0) {
+                            regKey = registryUrl.substr(registryUrl.indexOf("://") + 1);
+                            // regKey = registryUrl.split(":")!.splice(0,1).join(":");
+                        }
+                        let tokenSetting = `${regKey}:_authToken`;
+                        projUserEntries[tokenSetting] = identity.token;
+                        // Proj-level
+                        let projEntries = {};
+                        if (identity.scope) {
+                            projEntries[`${identity.scope}:registry`] = registryUrl;
+                            projEntries[`${identity.scope}:always-auth`] = "true";
+                        }
+                        else {
+                            projEntries["registry"] = registryUrl;
+                            projEntries["always-auth"] = "true";
+                        }
+                        npmrcEntries.push({
+                            identity: identity,
+                            tokenSetting: tokenSetting,
+                            projUserEntries: projUserEntries,
+                            projEntries: projEntries
+                        });
+                    }
+                    resolve(npmrcEntries);
+                }
+                catch (err) {
+                    reject(err);
+                }
+            }));
+        });
+    }
+}
+exports.npmjsIdentityAdapter = npmjsIdentityAdapter;
+//# sourceMappingURL=npmjs-identity-adapter.js.map