@halospv3/hce.shared-config 3.0.0-develop.4 → 3.0.0-develop.6

package/CHANGELOG.md

@@ -1,3 +1,32 @@
+## [3.0.0-develop.6](https://github.com/HaloSPV3/HCE.Shared/compare/v3.0.0-develop.5...v3.0.0-develop.6) (2025-07-17)
+
+### Bug Fixes
+
+* try fixing GitLab asset label, path ([75463a0](https://github.com/HaloSPV3/HCE.Shared/commit/75463a02ce247b33c25435d1e4afa78d6748f8db))
+* try fixing GitLab assets path AGAIN ([0bee0ae](https://github.com/HaloSPV3/HCE.Shared/commit/0bee0aee71e2da6707228820cec41c4a2248c44a))
+
+## [3.0.0-develop.5](https://github.com/HaloSPV3/HCE.Shared/compare/v3.0.0-develop.4...v3.0.0-develop.5) (2025-07-17)
+
+### Features
+
+* **insertPlugins:** add, export `insertPlugin`; declare internal `insertAndSortPlugins`; fix false-positive error caused by `!0` ([8971599](https://github.com/HaloSPV3/HCE.Shared/commit/8971599585dc962d5be6e7c3cc084f8c1a65d71c))
+
+### Bug Fixes
+
+* **dotnet.SemanticRelease:** append `@semantic-release/exec` plugin to plugins array if not found ([7eeafb2](https://github.com/HaloSPV3/HCE.Shared/commit/7eeafb2caab31358ecb91f8b3f1b885a11bc43b8))
+* **dotnet.SemanticRelease:** set/append dummy pack, dummy push, and INVAP commands ([88a523e](https://github.com/HaloSPV3/HCE.Shared/commit/88a523e231a821b59b72af0dee785affa9889499))
+
+## [3.0.0-develop.5](https://github.com/HaloSPV3/HCE.Shared/compare/v3.0.0-develop.4...v3.0.0-develop.5) (2025-07-17)
+
+### Features
+
+* **insertPlugins:** add, export `insertPlugin`; declare internal `insertAndSortPlugins`; fix false-positive error caused by `!0` ([8971599](https://github.com/HaloSPV3/HCE.Shared/commit/8971599585dc962d5be6e7c3cc084f8c1a65d71c))
+
+### Bug Fixes
+
+* **dotnet.SemanticRelease:** append `@semantic-release/exec` plugin to plugins array if not found ([7eeafb2](https://github.com/HaloSPV3/HCE.Shared/commit/7eeafb2caab31358ecb91f8b3f1b885a11bc43b8))
+* **dotnet.SemanticRelease:** set/append dummy pack, dummy push, and INVAP commands ([88a523e](https://github.com/HaloSPV3/HCE.Shared/commit/88a523e231a821b59b72af0dee785affa9889499))
+
 ## [3.0.0-develop.4](https://github.com/HaloSPV3/HCE.Shared/compare/v3.0.0-develop.3...v3.0.0-develop.4) (2025-07-16)
 
 ### Bug Fixes

package/dotnet/.github/workflows/_unit_test.yml

@@ -14,9 +14,6 @@ jobs:
 
     runs-on: ${{ matrix.os }}
     steps:
-      - uses: GitHubSecurityLab/actions-permissions/monitor@v1
-        with:
-          config: ${{ vars.PERMISSIONS_CONFIG }}
       - uses: actions/checkout@v4
         with:
           fetch-depth: 0

package/dotnet/.github/workflows/dotnet-release.yml

@@ -24,9 +24,6 @@ jobs:
       issues: write
       pull-requests: write
     steps:
-      - uses: GitHubSecurityLab/actions-permissions/monitor@v1
-        with:
-          config: ${{ vars.PERMISSIONS_CONFIG }}
       ################
       # SETUP
       ################

package/dotnet/.github/workflows/sample-dotnet-build.yml

@@ -9,9 +9,6 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: GitHubSecurityLab/actions-permissions/monitor@v1
-        with:
-          config: ${{ vars.PERMISSIONS_CONFIG }}
       - uses: actions/checkout@v4
         with:
           submodules: 'recursive'

package/mjs/CaseInsensitiveMap.d.ts

@@ -0,0 +1,12 @@
+/**
+ * https://stackoverflow.com/a/50022230/14894786
+ * licensed under CC BY-SA 4.0
+ * changes: add overrides, remove "as any", remove empty lines
+ */
+export declare class CaseInsensitiveMap<T, U> extends Map<T, U> {
+    delete(key: T): boolean;
+    get(key: T): U | undefined;
+    has(key: T): boolean;
+    set(key: T, value: U): this;
+}
+//# sourceMappingURL=CaseInsensitiveMap.d.ts.map

package/mjs/CaseInsensitiveMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CaseInsensitiveMap.d.ts","sourceRoot":"","sources":["../src/CaseInsensitiveMap.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAE,SAAQ,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IAC5C,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAOvB,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAO1B,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAOpB,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;CAMrC"}

package/mjs/CaseInsensitiveMap.mjs

@@ -0,0 +1,33 @@
+/**
+ * https://stackoverflow.com/a/50022230/14894786
+ * licensed under CC BY-SA 4.0
+ * changes: add overrides, remove "as any", remove empty lines
+ */
+class CaseInsensitiveMap extends Map {
+  delete(key) {
+    if (typeof key === 'string') {
+      key = key.toLowerCase();
+    }
+    return super.delete(key);
+  }
+  get(key) {
+    if (typeof key === 'string') {
+      key = key.toLowerCase();
+    }
+    return super.get(key);
+  }
+  has(key) {
+    if (typeof key === 'string') {
+      key = key.toLowerCase();
+    }
+    return super.has(key);
+  }
+  set(key, value) {
+    if (typeof key === 'string') {
+      key = key.toLowerCase();
+    }
+    return super.set(key, value);
+  }
+}
+export { CaseInsensitiveMap };
+//# sourceMappingURL=CaseInsensitiveMap.mjs.map

package/mjs/CaseInsensitiveMap.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"CaseInsensitiveMap.mjs","sources":["../src/CaseInsensitiveMap.ts"],"sourcesContent":null,"names":[],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACO,MAAM,kBAAkB,SAAS,GAAG,CAAC;AAC5C,EAAE,MAAM,CAAC,GAAG,EAAE;AACd,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE;AACjC,MAAM,GAAG,GAAG,GAAG,CAAC,WAAW,EAAE;AAC7B;AACA,IAAI,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC;AAC5B;AACA,EAAE,GAAG,CAAC,GAAG,EAAE;AACX,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE;AACjC,MAAM,GAAG,GAAG,GAAG,CAAC,WAAW,EAAE;AAC7B;AACA,IAAI,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;AACzB;AACA,EAAE,GAAG,CAAC,GAAG,EAAE;AACX,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE;AACjC,MAAM,GAAG,GAAG,GAAG,CAAC,WAAW,EAAE;AAC7B;AACA,IAAI,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;AACzB;AACA,EAAE,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE;AAClB,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE;AACjC,MAAM,GAAG,GAAG,GAAG,CAAC,WAAW,EAAE;AAC7B;AACA,IAAI,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC;AAChC;AACA;;;;"}

package/mjs/commitlintConfig.d.ts

@@ -0,0 +1,12 @@
+import type { RuleConfigSeverity, UserConfig } from '@commitlint/types';
+declare const disabled: RuleConfigSeverity.Disabled;
+declare const commitlintConfig: UserConfig & {
+    extends: UserConfig['extends'] | ['@commitlint/config-conventional'];
+    rules: {
+        'body-max-line-length': [typeof disabled];
+        'footer-max-line-length': [typeof disabled];
+        'header-max-length': [typeof disabled];
+    };
+};
+export default commitlintConfig;
+//# sourceMappingURL=commitlintConfig.d.ts.map

package/mjs/commitlintConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commitlintConfig.d.ts","sourceRoot":"","sources":["../src/commitlintConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAIxE,QAAA,MAAM,QAAQ,EAAQ,kBAAkB,CAAC,QAAQ,CAAC;AAClD,QAAA,MAAM,gBAAgB,EAAE,UAAU,GAAG;IACnC,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IACrE,KAAK,EAAE;QACL,sBAAsB,EAAE,CAAC,OAAO,QAAQ,CAAC,CAAC;QAC1C,wBAAwB,EAAE,CAAC,OAAO,QAAQ,CAAC,CAAC;QAC5C,mBAAmB,EAAE,CAAC,OAAO,QAAQ,CAAC,CAAC;KACxC,CAAC;CAQH,CAAC;AAGF,eAAe,gBAAgB,CAAC"}

package/mjs/commitlintConfig.mjs

@@ -0,0 +1,13 @@
+// explicit type annotations for isolatedDeclarations. Allows for faster processing.
+
+const disabled = 0;
+const commitlintConfig = {
+  extends: ['@commitlint/config-conventional'],
+  rules: {
+    'body-max-line-length': [disabled],
+    'footer-max-line-length': [disabled],
+    'header-max-length': [disabled]
+  }
+};
+export { commitlintConfig as default };
+//# sourceMappingURL=commitlintConfig.mjs.map

package/mjs/commitlintConfig.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"commitlintConfig.mjs","sources":["../src/commitlintConfig.ts"],"sourcesContent":null,"names":[],"mappings":"AAAA;;AAEA,MAAM,QAAQ,GAAG,CAAC;AACb,MAAC,gBAAgB,GAAG;AACzB,EAAE,OAAO,EAAE,CAAC,iCAAiC,CAAC;AAC9C,EAAE,KAAK,EAAE;AACT,IAAI,sBAAsB,EAAE,CAAC,QAAQ,CAAC;AACtC,IAAI,wBAAwB,EAAE,CAAC,QAAQ,CAAC;AACxC,IAAI,mBAAmB,EAAE,CAAC,QAAQ;AAClC;AACA;;;;"}

package/mjs/debug.d.ts

@@ -0,0 +1,4 @@
+import debug from 'debug';
+declare const _debug: debug.Debugger;
+export default _debug;
+//# sourceMappingURL=debug.d.ts.map

package/mjs/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../src/debug.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,QAAA,MAAM,MAAM,gBAAuC,CAAC;AAMpD,eAAe,MAAM,CAAC"}

package/mjs/debug.mjs

@@ -0,0 +1,7 @@
+import debug from 'debug';
+const _debug = debug('@halospv3/hce.shared-config');
+if (process.argv.some(v => v.includes('--debug')) || debug.enabled('@halospv3/hce.shared-config')) {
+  debug.enable(_debug.namespace);
+}
+export { _debug as default };
+//# sourceMappingURL=debug.mjs.map

package/mjs/debug.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.mjs","sources":["../src/debug.ts"],"sourcesContent":null,"names":[],"mappings":";;AACK,MAAC,MAAM,GAAG,KAAK,CAAC,6BAA6B;AAClD,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,6BAA6B,CAAC,EAAE;AACnG,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;AAChC;;;;"}

package/mjs/dotnet/GithubNugetRegistryInfo.d.ts

@@ -0,0 +1,34 @@
+import { NugetRegistryInfo } from './NugetRegistryInfo.js';
+export declare class GithubNugetRegistryInfo extends NugetRegistryInfo {
+    static readonly NUGET_PKG_GITHUB_COM = "https://nuget.pkg.github.com";
+    static readonly DefaultGithubTokenEnvVars: readonly ["GH_TOKEN", "GITHUB_TOKEN"];
+    /**
+     * Creates an instance of GithubNugetRegistryInfo.
+     * @param opts The input type of {@link GHNRIOpts.from}
+     */
+    constructor(opts: typeof GHNRIOpts.inferIn);
+    /**
+     * Returns `https://nuget.pkg.github.com/${GITHUB_REPOSITORY_OWNER}/index.json`
+     * or (if GITHUB_REPOSITORY_OWNER is not defined in {@link process.env} nor
+     * {@link process.cwd() $CWD}/.env) `undefined`.
+     * @returns If GITHUB_REPOSITORY_OWNER is defined, returns the GitHub Package Repository URL endpoint for NuGet pushes (--source).\
+     * Otherwise, returns `undefined`
+     */
+    static getNugetGitHubUrl(): string | undefined;
+}
+/**
+ * The default value of {@link GHNRIOpts.t.source `source`} is dependent on
+ * {@link GHNRI.getNugetGitHubUrl} and will default to an empty string if the
+ * environment variable `GITHUB_REPOSITORY_OWNER` is undefined!
+ */
+export declare const GHNRIOpts: import("arktype/internal/methods/object.ts").ObjectType<{
+    project: import("./MSBuildProject.js").MSBuildProject | {
+        readonly Items: Readonly<Required<import("./MSBuildProject.js").MSBuildEvaluationOutput>["Items"]>;
+        readonly Properties: Readonly<import("./NugetProjectProperties.js").NugetProjectProperties>;
+        readonly Targets: readonly string[];
+        readonly TargetResults: Required<import("./MSBuildProject.js").MSBuildEvaluationOutput>["TargetResults"][];
+    };
+    source: import("arktype/internal/attributes.ts").Default<string, string>;
+    tokenEnvVars: import("arktype/internal/attributes.ts").Default<readonly string[], readonly ["GH_TOKEN", "GITHUB_TOKEN"]>;
+}, {}>;
+//# sourceMappingURL=GithubNugetRegistryInfo.d.ts.map

package/mjs/dotnet/GithubNugetRegistryInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GithubNugetRegistryInfo.d.ts","sourceRoot":"","sources":["../../src/dotnet/GithubNugetRegistryInfo.ts"],"names":[],"mappings":"AACA,OAAO,EACL,iBAAiB,EAElB,MAAM,wBAAwB,CAAC;AAQhC,qBAAa,uBAAwB,SAAQ,iBAAiB;IAC5D,MAAM,CAAC,QAAQ,CAAC,oBAAoB,kCAAkC;IAEtE,MAAM,CAAC,QAAQ,CAAC,yBAAyB,wCAG7B;IAGZ;;;OAGG;gBACS,IAAI,EAAE,OAAO,SAAS,CAAC,OAAO;IAI1C;;;;;;OAMG;IACH,MAAM,CAAC,iBAAiB,IAAI,MAAM,GAAG,SAAS;CAM/C;AAGD;;;;GAIG;AACH,eAAO,MAAM,SAAS;;;;;;;;;MASpB,CAAC"}

package/mjs/dotnet/GithubNugetRegistryInfo.mjs

@@ -0,0 +1,45 @@
+import { getEnvVarValue } from '../utils/env.mjs';
+import { NugetRegistryInfo, NRIOptsBase } from './NugetRegistryInfo.mjs';
+const NUGET_PKG_GITHUB_COM = 'https://nuget.pkg.github.com';
+const DefaultGithubTokenEnvVars = Object.freeze(['GH_TOKEN', 'GITHUB_TOKEN']);
+class GithubNugetRegistryInfo extends NugetRegistryInfo {
+  static NUGET_PKG_GITHUB_COM = 'https://nuget.pkg.github.com';
+  // todo: deduplicate definition
+  static DefaultGithubTokenEnvVars = Object.freeze(['GH_TOKEN', 'GITHUB_TOKEN']);
+
+  // GithubNugetRegistryInfo.CtorArgs(...) behaves differently than NugetRegistryInfo.CtorArgs(...)
+  /**
+   * Creates an instance of GithubNugetRegistryInfo.
+   * @param opts The input type of {@link GHNRIOpts.from}
+   */
+  constructor(opts) {
+    super(GHNRIOpts.from(opts));
+  }
+
+  /**
+   * Returns `https://nuget.pkg.github.com/${GITHUB_REPOSITORY_OWNER}/index.json`
+   * or (if GITHUB_REPOSITORY_OWNER is not defined in {@link process.env} nor
+   * {@link process.cwd() $CWD}/.env) `undefined`.
+   * @returns If GITHUB_REPOSITORY_OWNER is defined, returns the GitHub Package Repository URL endpoint for NuGet pushes (--source).\
+   * Otherwise, returns `undefined`
+   */
+  static getNugetGitHubUrl() {
+    const owner = getEnvVarValue('GITHUB_REPOSITORY_OWNER');
+    return owner === undefined ? undefined : `${NUGET_PKG_GITHUB_COM}/${owner}/index.json`;
+  }
+}
+const GHNRI = GithubNugetRegistryInfo;
+
+/**
+ * The default value of {@link GHNRIOpts.t.source `source`} is dependent on
+ * {@link GHNRI.getNugetGitHubUrl} and will default to an empty string if the
+ * environment variable `GITHUB_REPOSITORY_OWNER` is undefined!
+ */
+const GHNRIOpts = NRIOptsBase.merge({
+  /** @see {@link GHNRI.getNugetGitHubUrl } */
+  source: NRIOptsBase.get('source').default(() => GHNRI.getNugetGitHubUrl() ?? ''),
+  tokenEnvVars: NRIOptsBase.get('tokenEnvVars').default(/* must be a function. A fixed-length array is NOT a primitive type! */
+  () => DefaultGithubTokenEnvVars)
+});
+export { GHNRIOpts, GithubNugetRegistryInfo };
+//# sourceMappingURL=GithubNugetRegistryInfo.mjs.map

package/mjs/dotnet/GithubNugetRegistryInfo.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"GithubNugetRegistryInfo.mjs","sources":["../../src/dotnet/GithubNugetRegistryInfo.ts"],"sourcesContent":null,"names":[],"mappings":";;;AAEA,MAAM,oBAAoB,GAAG,8BAA8B;AAC3D,MAAM,yBAAyB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;AACtE,MAAM,uBAAuB,SAAS,iBAAiB,CAAC;AAC/D,EAAE,OAAO,oBAAoB,GAAG,8BAA8B;AAC9D;AACA,EAAE,OAAO,yBAAyB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;;AAEhF;AACA;AACA;AACA;AACA;AACA,EAAE,WAAW,CAAC,IAAI,EAAE;AACpB,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/B;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,EAAE,OAAO,iBAAiB,GAAG;AAC7B,IAAI,MAAM,KAAK,GAAG,cAAc,CAAC,yBAAyB,CAAC;AAC3D,IAAI,OAAO,KAAK,KAAK,SAAS,GAAG,SAAS,GAAG,CAAC,EAAE,oBAAoB,CAAC,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC;AAC1F;AACA;AACA,MAAM,KAAK,GAAG,uBAAuB;;AAErC;AACA;AACA;AACA;AACA;AACY,MAAC,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC;AAC3C;AACA,EAAE,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,iBAAiB,EAAE,IAAI,EAAE,CAAC;AAClF,EAAE,YAAY,EAAE,WAAW,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,OAAO;AACvD,EAAE,MAAM,yBAAyB;AACjC,CAAC;;;;"}

package/mjs/dotnet/GitlabNugetRegistryInfo.d.ts

@@ -0,0 +1,57 @@
+import { NugetRegistryInfo } from './NugetRegistryInfo.js';
+export declare class GitlabNugetRegistryInfo extends NugetRegistryInfo {
+    /**
+     * The GitLab API v4 root URL.
+     * @returns The value of the environment variable `CI_API_V4_URL`.
+     * If that's `undefined`, 'https://gitlab.com/api/v4' is returned, instead.
+     */
+    static get CI_API_V4_URL(): string;
+    /**
+     * CI_PROJECT_ID - If you want to publish to your GitLab server, this needs to be set to the Id of the project you want to publish to. When running in GitLab CI this is already set to the project the pipeline runs in by GitLab.
+     * This method checks the contents of your `.env` file, if present.
+     * @returns The value of the environment variable `CI_PROJECT_ID` or `undefined`.
+     * @todo add URI encoded project pathname as alternative e.g. 'halospv3%2FHCE.Shared' in 'https://gitlab.com/api/v4/projects/halospv3%2FHCE.Shared'
+     */
+    static get projectId(): string | undefined;
+    /**
+     * CI_PROJECT_NAMESPACE_ID
+     * This method checks the contents of your `.env` file, if present.
+     * @returns The value of the environment variable 'CI_PROJECT_NAMESPACE_ID' or `undefined`.
+     */
+    static get ownerId(): string | undefined;
+    static readonly DefaultGitlabTokenEnvVars: readonly ["GL_TOKEN", "GITLAB_TOKEN", "CI_JOB_TOKEN"];
+    /**
+     * Creates an instance of GitlabNugetRegistryInfo.
+     * @param opts The input type of {@link GLNRIOpts.from}
+     */
+    constructor(opts: typeof GLNRIOpts.inferIn);
+    /**
+     * Get the GitLab Nuget API for your project url as seen in https://docs.gitlab.com/ee/user/packages/nuget_repository/index.html#publish-a-nuget-package-by-using-cicd
+     * ${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/packages/nuget/index.json
+     * @returns If {@link this.projectId} is a string, a string formatted like
+     * `${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/packages/nuget/index.json`.
+     * Else, {@link Error}.
+     */
+    static get projectUrl(): string | Error;
+    /**
+     * ${CI_API_V4_URL}/groups/${CI_PROJECT_NAMESPACE_ID}/-/packages/nuget/index.json
+     * @returns If {@link ownerId} is a string, then a string formatted like
+     * `${CI_API_V4_URL}/groups/${CI_PROJECT_NAMESPACE_ID}/-/packages/nuget/index.json`.
+     * Else, {@link Error}.
+     */
+    static get groupUrl(): string | Error;
+}
+/**
+ * The Arktype definition for {@link GitlabNugetRegistryInfo}'s constructor parameter. Construct an object of this type by calling {@link GLNRIOpts.from}
+ */
+export declare const GLNRIOpts: import("arktype/internal/methods/object.ts").ObjectType<{
+    project: import("./MSBuildProject.js").MSBuildProject | {
+        readonly Items: Readonly<Required<import("./MSBuildProject.js").MSBuildEvaluationOutput>["Items"]>;
+        readonly Properties: Readonly<import("./NugetProjectProperties.js").NugetProjectProperties>;
+        readonly Targets: readonly string[];
+        readonly TargetResults: Required<import("./MSBuildProject.js").MSBuildEvaluationOutput>["TargetResults"][];
+    };
+    tokenEnvVars: import("arktype/internal/attributes.ts").Default<readonly string[], readonly ["GL_TOKEN", "GITLAB_TOKEN", "CI_JOB_TOKEN"]>;
+    source: (In: import("arktype/internal/attributes.ts").Default<string | Error, string | Error>) => import("arktype").Out<string | Error>;
+}, {}>;
+//# sourceMappingURL=GitlabNugetRegistryInfo.d.ts.map

package/mjs/dotnet/GitlabNugetRegistryInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitlabNugetRegistryInfo.d.ts","sourceRoot":"","sources":["../../src/dotnet/GitlabNugetRegistryInfo.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,iBAAiB,EAGlB,MAAM,wBAAwB,CAAC;AAGhC,qBAAa,uBAAwB,SAAQ,iBAAiB;IAC5D;;;;OAIG;IACH,MAAM,KAAK,aAAa,WAEvB;IAED;;;;;OAKG;IACH,MAAM,KAAK,SAAS,uBAEnB;IAED;;;;OAIG;IACH,MAAM,KAAK,OAAO,uBAEjB;IAED,MAAM,CAAC,QAAQ,CAAC,yBAAyB,wDAI7B;IAEZ;;;OAGG;gBACS,IAAI,EAAE,OAAO,SAAS,CAAC,OAAO;IAO1C;;;;;;OAMG;IACH,MAAM,KAAK,UAAU,IAAI,MAAM,GAAG,KAAK,CAItC;IAED;;;;;OAKG;IACH,MAAM,KAAK,QAAQ,IAAI,MAAM,GAAG,KAAK,CAIpC;CACF;AAGD;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;;;MA0BpB,CAAC"}

package/mjs/dotnet/GitlabNugetRegistryInfo.mjs

@@ -0,0 +1,99 @@
+import { isNativeError } from 'node:util/types';
+import { getEnvVarValue } from '../utils/env.mjs';
+import { NugetRegistryInfo, NRIOpts, NRIOptsBase } from './NugetRegistryInfo.mjs';
+
+// https://docs.gitlab.com/ee/user/packages/nuget_repository/
+class GitlabNugetRegistryInfo extends NugetRegistryInfo {
+  /**
+   * The GitLab API v4 root URL.
+   * @returns The value of the environment variable `CI_API_V4_URL`.
+   * If that's `undefined`, 'https://gitlab.com/api/v4' is returned, instead.
+   */
+  static get CI_API_V4_URL() {
+    return getEnvVarValue('CI_API_V4_URL') ?? 'https://gitlab.com/api/v4';
+  }
+
+  /**
+   * CI_PROJECT_ID - If you want to publish to your GitLab server, this needs to be set to the Id of the project you want to publish to. When running in GitLab CI this is already set to the project the pipeline runs in by GitLab.
+   * This method checks the contents of your `.env` file, if present.
+   * @returns The value of the environment variable `CI_PROJECT_ID` or `undefined`.
+   * @todo add URI encoded project pathname as alternative e.g. 'halospv3%2FHCE.Shared' in 'https://gitlab.com/api/v4/projects/halospv3%2FHCE.Shared'
+   */
+  static get projectId() {
+    return getEnvVarValue('CI_PROJECT_ID');
+  }
+
+  /**
+   * CI_PROJECT_NAMESPACE_ID
+   * This method checks the contents of your `.env` file, if present.
+   * @returns The value of the environment variable 'CI_PROJECT_NAMESPACE_ID' or `undefined`.
+   */
+  static get ownerId() {
+    return getEnvVarValue('CI_PROJECT_NAMESPACE_ID');
+  }
+  static DefaultGitlabTokenEnvVars = Object.freeze(['GL_TOKEN', 'GITLAB_TOKEN', 'CI_JOB_TOKEN']);
+
+  /**
+   * Creates an instance of GitlabNugetRegistryInfo.
+   * @param opts The input type of {@link GLNRIOpts.from}
+   */
+  constructor(opts) {
+    const optsOut = GLNRIOpts.from(opts);
+    if (isNativeError(optsOut.source)) throw optsOut.source;
+    super(optsOut);
+  }
+
+  /**
+   * Get the GitLab Nuget API for your project url as seen in https://docs.gitlab.com/ee/user/packages/nuget_repository/index.html#publish-a-nuget-package-by-using-cicd
+   * ${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/packages/nuget/index.json
+   * @returns If {@link this.projectId} is a string, a string formatted like
+   * `${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/packages/nuget/index.json`.
+   * Else, {@link Error}.
+   */
+  static get projectUrl() {
+    return this.projectId ? `${this.CI_API_V4_URL}/projects/${this.projectId}/packages/nuget/index.json` : new Error('The project-type URL was specified, but one or more of the required environment variables (CI_API_V4_URL, CI_PROJECT_ID) were undefined.');
+  }
+
+  /**
+   * ${CI_API_V4_URL}/groups/${CI_PROJECT_NAMESPACE_ID}/-/packages/nuget/index.json
+   * @returns If {@link ownerId} is a string, then a string formatted like
+   * `${CI_API_V4_URL}/groups/${CI_PROJECT_NAMESPACE_ID}/-/packages/nuget/index.json`.
+   * Else, {@link Error}.
+   */
+  static get groupUrl() {
+    return this.ownerId ? `${this.CI_API_V4_URL}/groups/${this.ownerId}/-/packages/nuget/index.json` : new Error('env.CI_PROJECT_NAMESPACE_ID must be defined to use its GitLab API endpoint!');
+  }
+}
+const GLNRI = GitlabNugetRegistryInfo;
+
+/**
+ * The Arktype definition for {@link GitlabNugetRegistryInfo}'s constructor parameter. Construct an object of this type by calling {@link GLNRIOpts.from}
+ */
+const GLNRIOpts = NRIOpts.merge({
+  tokenEnvVars: NRIOptsBase.get('tokenEnvVars').default(() => GLNRI.DefaultGitlabTokenEnvVars),
+  /**
+   * The GitLab Nuget API URL to push packages to -OR- a keyword such as "group"
+   * or "project" used to determine URL.
+   * @default GLNRI.projectUrl
+   * @see {@link GLNRI.projectUrl}, {@link GLNRI.groupUrl}
+   */
+  // todo: change '"group" | "project"' to '"GITLAB:PROJECT" | "GITLAB:GROUP"'
+  source: NRIOptsBase.get('source').or('"group" | "project" | Error').pipe(source => {
+    switch (source) {
+      case 'group':
+        {
+          return GLNRI.groupUrl;
+        }
+      case 'project':
+        {
+          return GLNRI.projectUrl;
+        }
+      default:
+        {
+          return source;
+        }
+    }
+  }).default(() => GLNRI.projectUrl)
+});
+export { GLNRIOpts, GitlabNugetRegistryInfo };
+//# sourceMappingURL=GitlabNugetRegistryInfo.mjs.map

package/mjs/dotnet/GitlabNugetRegistryInfo.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitlabNugetRegistryInfo.mjs","sources":["../../src/dotnet/GitlabNugetRegistryInfo.ts"],"sourcesContent":null,"names":[],"mappings":";;;;AAIA;AACO,MAAM,uBAAuB,SAAS,iBAAiB,CAAC;AAC/D;AACA;AACA;AACA;AACA;AACA,EAAE,WAAW,aAAa,GAAG;AAC7B,IAAI,OAAO,cAAc,CAAC,eAAe,CAAC,IAAI,2BAA2B;AACzE;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,EAAE,WAAW,SAAS,GAAG;AACzB,IAAI,OAAO,cAAc,CAAC,eAAe,CAAC;AAC1C;;AAEA;AACA;AACA;AACA;AACA;AACA,EAAE,WAAW,OAAO,GAAG;AACvB,IAAI,OAAO,cAAc,CAAC,yBAAyB,CAAC;AACpD;AACA,EAAE,OAAO,yBAAyB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC;;AAEhG;AACA;AACA;AACA;AACA,EAAE,WAAW,CAAC,IAAI,EAAE;AACpB,IAAI,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;AACxC,IAAI,IAAI,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM;AAC3D,IAAI,KAAK,CAAC,OAAO,CAAC;AAClB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,EAAE,WAAW,UAAU,GAAG;AAC1B,IAAI,OAAO,IAAI,CAAC,SAAS,GAAG,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,0BAA0B,CAAC,GAAG,IAAI,KAAK,CAAC,0IAA0I,CAAC;AAChQ;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,EAAE,WAAW,QAAQ,GAAG;AACxB,IAAI,OAAO,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,4BAA4B,CAAC,GAAG,IAAI,KAAK,CAAC,6EAA6E,CAAC;AAC/L;AACA;AACA,MAAM,KAAK,GAAG,uBAAuB;;AAErC;AACA;AACA;AACY,MAAC,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC;AACvC,EAAE,YAAY,EAAE,WAAW,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,yBAAyB,CAAC;AAC9F;AACA;AACA;AACA;AACA;AACA;AACA;AACA,EAAE,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,6BAA6B,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI;AACrF,IAAI,QAAQ,MAAM;AAClB,MAAM,KAAK,OAAO;AAClB,QAAQ;AACR,UAAU,OAAO,KAAK,CAAC,QAAQ;AAC/B;AACA,MAAM,KAAK,SAAS;AACpB,QAAQ;AACR,UAAU,OAAO,KAAK,CAAC,UAAU;AACjC;AACA,MAAM;AACN,QAAQ;AACR,UAAU,OAAO,MAAM;AACvB;AACA;AACA,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,UAAU;AACnC,CAAC;;;;"}

package/mjs/dotnet/IsNextVersionAlreadyPublished.cli.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IsNextVersionAlreadyPublished.cli.d.ts.map

package/mjs/dotnet/IsNextVersionAlreadyPublished.cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IsNextVersionAlreadyPublished.cli.d.ts","sourceRoot":"","sources":["../../src/dotnet/IsNextVersionAlreadyPublished.cli.ts"],"names":[],"mappings":""}

package/mjs/dotnet/IsNextVersionAlreadyPublished.cli.mjs

@@ -0,0 +1,26 @@
+import { getGithubOutput, NugetRegistryInfo } from './NugetRegistryInfo.mjs';
+const args = process.argv.slice(2);
+
+// Parse command-line arguments - https://stackoverflow.com/a/76298476/14894786
+const options = {};
+for (let i = 0; i < args.length; i += 2) {
+  const argName = args[i];
+  const argValue = args[i + 1];
+  if (argValue !== undefined && argName?.startsWith('--') === true && options[argName.slice(2)] !== undefined) {
+    options[argName.slice(2)] = argValue;
+  }
+}
+if (typeof options.packageId !== 'string') throw new Error('packageId must be a string');
+if (typeof options.source !== 'string') throw new Error('source must be a string');
+const packageId = options.packageId,
+  source = options.source,
+  versionPattern = new RegExp(/\d+\.\d+\.\d+([-+].+)?/);
+const ghOutput = (await getGithubOutput()) ?? {};
+const matches = versionPattern.exec(ghOutput['new-release-version'] ?? '');
+if (matches === null || matches.length === 0) throw new Error('The variable new-release-version is not present in the GITHUB_OUTPUT env file or its value contains invalid characters.');
+const nextVersion = matches[0];
+const isPublished = await NugetRegistryInfo.IsNextVersionAlreadyPublished(source, packageId, nextVersion);
+if (typeof isPublished !== 'boolean') throw new Error('isPublished is not a boolean');
+if (isPublished) throw new Error(`${packageId}@${nextVersion} already exists at ${source}.`);
+console.log(`OK: ${packageId}@${nextVersion} does NOT yet exist at ${source}. Yay.`);
+//# sourceMappingURL=IsNextVersionAlreadyPublished.cli.mjs.map

package/mjs/dotnet/IsNextVersionAlreadyPublished.cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"IsNextVersionAlreadyPublished.cli.mjs","sources":["../../src/dotnet/IsNextVersionAlreadyPublished.cli.ts"],"sourcesContent":null,"names":[],"mappings":";;AACA,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;;AAElC;AACA,MAAM,OAAO,GAAG,EAAE;AAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE;AACzC,EAAE,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC;AACzB,EAAE,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;AAC9B,EAAE,IAAI,QAAQ,KAAK,SAAS,IAAI,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE;AAC/G,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ;AACxC;AACA;AACA,IAAI,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ,EAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC;AACxF,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,EAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC;AAClF,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS;AACnC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM;AACzB,EAAE,cAAc,GAAG,IAAI,MAAM,CAAC,wBAAwB,CAAC;AACvD,MAAM,QAAQ,GAAG,CAAC,MAAM,eAAe,EAAE,KAAK,EAAE;AAChD,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,qBAAqB,CAAC,IAAI,EAAE,CAAC;AAC1E,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,IAAI,KAAK,CAAC,yHAAyH,CAAC;AACxL,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;AAC9B,MAAM,WAAW,GAAG,MAAM,iBAAiB,CAAC,6BAA6B,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,CAAC;AACzG,IAAI,OAAO,WAAW,KAAK,SAAS,EAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC;AACrF,IAAI,WAAW,EAAE,MAAM,IAAI,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,EAAE,WAAW,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;AAC5F,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,EAAE,WAAW,CAAC,uBAAuB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC"}