@halospv3/hce.shared-config 2.4.3 → 2.6.0

package/CHANGELOG.md

@@ -1,3 +1,21 @@
+## [2.6.0](https://github.com/halospv3/hce.shared/compare/v2.5.0...v2.6.0) (2024-06-07)
+
+### Features
+
+* add createDummyNupkg ([ed67d06](https://github.com/halospv3/hce.shared/commit/ed67d06cd06e56a78b0a9ff2e51efb83ddd94386)), closes [#406](https://github.com/halospv3/hce.shared/issues/406)
+* add EnvUtils (getEnvVarValue, getEnv) ([f86562a](https://github.com/halospv3/hce.shared/commit/f86562aa1c19a13a612e6571ba2122bf134ba196))
+
+## [2.5.0](https://github.com/halospv3/hce.shared/compare/v2.4.3...v2.5.0) (2024-06-04)
+
+### Features
+
+* overhaul dotnetGHPR; misc refactors ([8d0a1d6](https://github.com/halospv3/hce.shared/commit/8d0a1d657e7f4754881c9a130fd4aa8191fb3e81))
+
+### Bug Fixes
+
+* **deps:** update dependency conventional-changelog-conventionalcommits to v8 ([e1defcd](https://github.com/halospv3/hce.shared/commit/e1defcd94ba51eda7384c1ca87f33c9928610e20))
+* **deps:** update semantic-release monorepo ([39fcf98](https://github.com/halospv3/hce.shared/commit/39fcf988fe55b894e269d64de1b48c7f8dfb950c))
+
 ## [2.4.3](https://github.com/halospv3/hce.shared/compare/v2.4.2...v2.4.3) (2024-05-31)
 
 
@@ -5,6 +23,13 @@
 
 * fix error being thrown because an 'else' is missing ([a4ed781](https://github.com/halospv3/hce.shared/commit/a4ed781dd9ebf696deae7b7914d8cf77e2beb5fb))
 
+## [2.4.3-develop.1](https://github.com/halospv3/hce.shared/compare/v2.4.2...v2.4.3-develop.1) (2024-06-01)
+
+### Bug Fixes
+
+* **deps:** update dependency conventional-changelog-conventionalcommits to v8 ([e1defcd](https://github.com/halospv3/hce.shared/commit/e1defcd94ba51eda7384c1ca87f33c9928610e20))
+* **deps:** update semantic-release monorepo ([39fcf98](https://github.com/halospv3/hce.shared/commit/39fcf988fe55b894e269d64de1b48c7f8dfb950c))
+
 ## [2.4.2](https://github.com/halospv3/hce.shared/compare/v2.4.1...v2.4.2) (2024-05-31)
 
 

package/cjs/dotnet/createDummyNupkg.cjs

@@ -0,0 +1,26 @@
+'use strict';
+
+const node_child_process = require('node:child_process');
+const node_fs = require('node:fs');
+const path = require('node:path');
+const tmp = require('tmp');
+function createDummyNupkg() {
+  const dirResult = tmp.dirSync({
+    unsafeCleanup: true
+  });
+  const dummyPkgFullPath = path.join(dirResult.name, 'DUMMY.1.0.0.nupkg');
+
+  // delete old and possibly-poisoned nupkg
+  if (node_fs.existsSync(dummyPkgFullPath)) node_fs.unlinkSync(dummyPkgFullPath);
+  const options = {
+    cwd: dirResult.name,
+    encoding: 'utf8'
+  };
+  node_child_process.execSync('dotnet new console --name DUMMY', options);
+  const packOut = node_child_process.execSync(`dotnet pack DUMMY --configuration Release --output ${path.dirname(dummyPkgFullPath)}`, options);
+  const createdLine = packOut.replace('\r', '').split('\n').find(line => line.includes('Successfully created package'))?.trim();
+  if (!node_fs.existsSync(dummyPkgFullPath)) throw new Error(`The dummy nupkg was created, but could not be found at ${dummyPkgFullPath}. See '${createdLine}'.`);
+  return dummyPkgFullPath;
+}
+exports.createDummyNupkg = createDummyNupkg;
+//# sourceMappingURL=createDummyNupkg.cjs.map

package/cjs/dotnet/createDummyNupkg.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createDummyNupkg.cjs","sources":["../../src/dotnet/createDummyNupkg.ts"],"sourcesContent":null,"names":["dirSync","join","existsSync","unlinkSync","execSync","dirname"],"mappings":";;;;;;;AAIO,SAAS,gBAAgB,GAAG;AACnC,EAAE,MAAM,SAAS,GAAGA,WAAO,CAAC;AAC5B,IAAI,aAAa,EAAE,IAAI;AACvB,GAAG,CAAC,CAAC;AACL,EAAE,MAAM,gBAAgB,GAAGC,SAAI,CAAC,SAAS,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;AACrE;AACA;AACA,EAAE,IAAIC,kBAAU,CAAC,gBAAgB,CAAC,EAAEC,kBAAU,CAAC,gBAAgB,CAAC,CAAC;AACjE,EAAE,MAAM,OAAO,GAAG;AAClB,IAAI,GAAG,EAAE,SAAS,CAAC,IAAI;AACvB,IAAI,QAAQ,EAAE,MAAM;AACpB,GAAG,CAAC;AACJ,EAAEC,2BAAQ,CAAC,iCAAiC,EAAE,OAAO,CAAC,CAAC;AACvD,EAAE,MAAM,OAAO,GAAGA,2BAAQ,CAAC,CAAC,mDAAmD,EAAEC,YAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AACvH,EAAE,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,8BAA8B,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;AAChI,EAAE,IAAI,CAACH,kBAAU,CAAC,gBAAgB,CAAC,EAAE,MAAM,IAAI,KAAK,CAAC,CAAC,uDAAuD,EAAE,gBAAgB,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC;AAC1J,EAAE,OAAO,gBAAgB,CAAC;AAC1B;;;;"}

package/cjs/dotnet/createDummyNupkg.d.ts

@@ -0,0 +1,2 @@
+export declare function createDummyNupkg(): string;
+//# sourceMappingURL=createDummyNupkg.d.ts.map

package/cjs/dotnet/createDummyNupkg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createDummyNupkg.d.ts","sourceRoot":"","sources":["../../src/dotnet/createDummyNupkg.ts"],"names":[],"mappings":"AAKA,wBAAgB,gBAAgB,IAAI,MAAM,CAwBzC"}

package/cjs/dotnet/dotnetGHPR.cjs

@@ -1,61 +1,150 @@
 'use strict';
 
-// todo: support custom base URL for private GitHub instances
-async function tokenCanWritePackages(tokenEnvVar) {
-  const tokenValue = process.env[tokenEnvVar];
+const strict = require('node:assert/strict');
+const node_child_process = require('node:child_process');
+const node_util = require('node:util');
+const envUtils = require('../envUtils.cjs');
+const createDummyNupkg = require('./createDummyNupkg.cjs');
+
+/**
+ * @param tokenEnvVar The name of the environment variable containing the NUGET token 
+ * @returns `true` if the token can be used to push nupkg to the given Nuget registry
+ * @throws
+ * - TypeError: The environment variable ${tokenEnvVar} is undefined!
+ * - Error: 
+ *   - The value of the token in ${tokenEnvVar} begins with 'github_pat_' which means it's a Fine-Grained token. At the time of writing, GitHub Fine-Grained tokens cannot push packages. If you believe this is statement is outdated, report the issue at https://github.com/halospv3/hce.shared/issues/new. For more information, see https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-nuget-registry.
+ *   - The GitHub API response header lacked "x-oauth-scopes". This indicates the token we provided is not a workflow token nor a Personal Access Token (classic) and can never have permission to push packages.
+ */
+async function tokenCanWritePackages(tokenEnvVar, url) {
+  /* double-check the token exists */
+  const info = isTokenDefined(tokenEnvVar);
+  strict.ok(info.isDefined);
+  if (url === undefined) {
+    console.debug(`tokenCanWritePackages was called without a NuGet Source URL. Defaulting to use ${`${nugetGitHubUrlBase}/\${GITHUB_REPOSITORY_OWNER}/index.json`} where GITHUB_REPOSITORY_OWNER is '${getOwner()}'`);
+    url = getNugetGitHubUrl();
+  }
+  strict.notDeepStrictEqual(url, undefined);
+  strict.notDeepStrictEqual(url, '');
+  if (info.fallback) tokenEnvVar = info.fallback;
+  const tokenValue = envUtils.getEnvVarValue(tokenEnvVar);
   if (tokenValue === undefined) throw new TypeError(`The environment variable ${tokenEnvVar} is undefined!`);
-  const reqH = {
-    authorization: `token ${tokenValue}`
-  };
-  // CJS compatibility - import { request } from '@octokit/request
-  const request = (await import('@octokit/request')).request;
-  const response = await request('GET /', {
-    headers: reqH
-  });
-  const scopes = response.headers['x-oauth-scopes'];
-  if (scopes) {
-    return scopes.includes('write:packages') || scopes.includes('write:packages');
+  if (tokenValue.startsWith('github_pat_')) throw new Error(`The value of the token in ${tokenEnvVar} begins with 'github_pat_' which means it's a Fine-Grained token. At the time of writing, GitHub Fine-Grained tokens cannot push packages. If you believe this is statement is outdated, report the issue at https://github.com/halospv3/hce.shared/issues/new. For more information, see https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-nuget-registry.`);
+  const dummyNupkgPath = createDummyNupkg.createDummyNupkg();
+  const promiseExec = node_util.promisify(node_child_process.exec);
+  try {
+    const pushResult = await promiseExec(`dotnet nuget push ${dummyNupkgPath} --source ${url} --api-key ${tokenValue} --skip-duplicate`, {
+      encoding: 'utf8'
+    });
+    const errNewline = pushResult.stderr.includes('\r\n') ? '\r\n' : pushResult.stdout.includes('\r') ? '\r' : '\n';
+
+    // if any *lines* start with "error: " or "Error: ", log stderr
+    const errorCount = pushResult.stderr.split(errNewline ?? '\n').filter(line => line.trim().startsWith('error: ') || line.trim().startsWith('Error: ')).length;
+    if (errorCount > 0) console.error(pushResult.stderr);
+
+    // if any lines start with "warn : ", log stdout
+    const warningCount = pushResult.stdout.split(errNewline ?? '\n').filter(line => line.trim().startsWith('warn : ')).length;
+    if (warningCount > 0) console.warn(pushResult.stdout);
+    const hasAuthError = pushResult.stderr.includes('401 (Unauthorized)');
+
+    // return true is no lines contain error indicators.
+    return errorCount === 0 && hasAuthError === false;
+  } catch (err) {
+    const stdout = err.stdout ?? '';
+    console.error(err.stack + '\n' + stdout.split('Usage: dotnet nuget push')[0]);
+    return false;
   }
-  return false;
 }
-const GITHUB_REPOSITORY_OWNER = process.env.GITHUB_REPOSITORY_OWNER;
+
+/** returns the value of GITHUB_REPOSITORY_OWNER */
+function getOwner() {
+  return envUtils.getEnvVarValue('GITHUB_REPOSITORY_OWNER');
+}
 const nugetGitHubUrlBase = 'https://nuget.pkg.github.com';
-const nugetGitHubUrl = GITHUB_REPOSITORY_OWNER ? `${nugetGitHubUrlBase}/${GITHUB_REPOSITORY_OWNER}/index.json` : undefined;
+
+/** @deprecated use {@link getNugetGitHubUrl()} instead. */
+const nugetGitHubUrl = getNugetGitHubUrl();
+
+// todo!: refactor to "return string else throw"
+function getNugetGitHubUrl() {
+  const owner = getOwner();
+  if (owner) return `${nugetGitHubUrlBase}/${owner}/index.json`;
+  console.warn('GITHUB_REPOSITORY_OWNER is undefined! Default NuGet source for GitHub is unavailable.');
+  return undefined;
+}
+
+/**
+ * If tokenEnvVar is NOT 'GITHUB_TOKEN', then test if the token is defined and return the boolean. 
+ * Else If tokenEnvVar is 'GITHUB_TOKEN' and defined, then return true.
+ * Else If tokenEnvVar is 'GITHUB_TOKEN' and undefined, then set tokenEnvVar to 'GH_TOKEN', test if GH_TOKEN is defined, and return the boolean.
+ * @param tokenEnvVar the name of the environment variable with the token's value. Defaults to 'GITHUB_TOKEN'. If environment variable 'GITHUB_TOKEN' is undefined, falls back to 'GH_TOKEN'.
+ * @returns `{isDefined: true}` if the token is defined. Else, if tokenEnvVar is 'GITHUB_TOKEN' (default) and token is defined, returns `true`. Else, if 'GH_TOKEN' is defined, returns `true`. Else, returns `false`
+ */
+function isTokenDefined(tokenEnvVar = 'GITHUB_TOKEN') {
+  let token = envUtils.getEnvVarValue(tokenEnvVar /* custom or GITHUB_TOKEN */);
+  if (tokenEnvVar !== 'GITHUB_TOKEN') return {
+    isDefined: token !== undefined && token !== 'undefined'
+  };
+
+  /* GITHUB_TOKEN */
+  if (token !== undefined && token !== 'undefined') return {
+    isDefined: true
+  };
+  token = envUtils.getEnvVarValue('GH_TOKEN');
+  return {
+    isDefined: token !== undefined && token !== 'undefined',
+    fallback: 'GH_TOKEN'
+  };
+}
 
 /**
  * Get a {@link NuGetRegistryInfo} for pushing to your GitHub Packages NuGet registry.
  * todo: add support for private, custom GitHub instances. Token is only validated against github.com.
  * @export
- * @param {string} [tokenEnvVar="GITHUB_TOKEN"] The name of environment variable storing the GitHub Packages NuGet registry API key. Defaults to `"GITHUB_TOKEN"`;
- * @param {string} [url=tokenEnvVar] The url of the GitHub Packages NuGet registry. Defaults to {@link nugetGitHubUrl}.
+ * @param {string | 'GITHUB_TOKEN' | 'GH_TOKEN'} [tokenEnvVar="GITHUB_TOKEN"] The name of environment variable storing the GitHub Packages NuGet registry API key. Defaults to `"GITHUB_TOKEN"`. If GITHUB_TOKEN is undefined, fallback to GH_TOKEN;
+ * @param {string} [url=tokenEnvVar] The url of the GitHub Packages NuGet registry. Defaults to return value of {@link getNugetGitHubUrl()}.
  * @returns {(NuGetRegistryInfo | undefined)} a {@link NuGetRegistryInfo} object if {@link tokenEnvVar} and {@link url} are defined. Else, `undefined`.
  * note: `url` defaults to job's repository owner's GitHub registry in GitHub Actions workflow. If GITHUB_REPOSITORY_OWNER is not defined, then an error will be logged and `undefined` will be returned.
  */
-async function getGithubNugetRegistryPair(tokenEnvVar = 'GITHUB_TOKEN', url = nugetGitHubUrl) {
-  // yes, this is stupid. No, I won't change it.
-  const isTokenDefined = process.env[tokenEnvVar] !== undefined;
-  const isUrlDefined = url !== undefined;
-  const canTokenWritePackages = isTokenDefined ? await tokenCanWritePackages(tokenEnvVar) : false;
+async function getGithubNugetRegistryPair(tokenEnvVar = 'GITHUB_TOKEN', url = getNugetGitHubUrl()) {
   const errors = [];
-  if (!isTokenDefined) errors.push(new Error(`The environment variable ${tokenEnvVar} was specified as the source of the token to push a NuGet package to GitHub, but the environment variable does not exist.`));
-  if (!isUrlDefined) {
+  const _isTokenDefinedInfo = isTokenDefined(tokenEnvVar);
+  let canTokenWritePackages = undefined;
+  if ((url ??= getNugetGitHubUrl()) === undefined) {
     errors.push(new Error('The url for the GitHub Packages NuGet registry was undefined.\n' + 'If running in a GitHub Actions workflow, something is seriously wrong.\n' + 'If running in a different CI/CD pipeline and you wish to cross-push to GHPR, ensure GITHUB_REPOSITORY_OWNER is set correctly.\n'));
   }
-  if (!canTokenWritePackages) {
+  if (_isTokenDefinedInfo.isDefined) {
+    if (_isTokenDefinedInfo.fallback) tokenEnvVar = _isTokenDefinedInfo.fallback;
+    try {
+      canTokenWritePackages = await tokenCanWritePackages(tokenEnvVar, url);
+    } catch (err) {
+      if (err instanceof Error) errors.push(err);else errors.push(new Error(String(err)));
+    }
+  } else {
+    const errMsg = `The environment variable ${tokenEnvVar} was specified as the source of the token to push a NuGet package to GitHub, but the environment variable does not exist.` + `${_isTokenDefinedInfo.fallback === undefined ? '' : ` The fallback environment variable ${_isTokenDefinedInfo.fallback} is also undefined.`}`;
+    errors.push(new Error(errMsg));
+  }
+  if (canTokenWritePackages === false) {
     // yes, this is a critical error that should be fixed before Semantic Release can succeed.
     // yes, this is incredibly irritating to deal with in local runs.
     errors.push(new Error('The provided GitHub token has insufficient permissions or is a fine-grained permissions token. Only class Personal Access Tokens (classic) or workflow tokens with `repo` or `write:packages` permission can push a package.'));
   }
 
   // conditions checked so `url` is certainly defined
-  if (isTokenDefined && isUrlDefined && canTokenWritePackages) return {
+  if (_isTokenDefinedInfo.isDefined && url !== undefined && canTokenWritePackages) return {
     tokenEnvVar,
     url
   };
-  if (process.env['SKIP_TOKEN'] === 'true') return undefined;
-  throw new Error(`One more more errors occurred when getting GHPR url-token pair. Errors:\n${errors.map(v => v.message).join('\n')}`);
+  const aggErr = new Error(`One more more errors occurred when getting GHPR url-token pair. Errors:\n${errors.map(v => v.stack).join('\n')}`);
+  if (envUtils.getEnvVarValue('SKIP_TOKEN') === 'true' && aggErr.message.length > 0) {
+    console.error('WARN: errors were thrown, but SKIP_TOKEN is defined.\n' + aggErr.stack);
+    return undefined;
+  }
+  throw aggErr;
 }
 exports.getGithubNugetRegistryPair = getGithubNugetRegistryPair;
+exports.getNugetGitHubUrl = getNugetGitHubUrl;
+exports.isTokenDefined = isTokenDefined;
 exports.nugetGitHubUrl = nugetGitHubUrl;
 exports.nugetGitHubUrlBase = nugetGitHubUrlBase;
+exports.tokenCanWritePackages = tokenCanWritePackages;
 //# sourceMappingURL=dotnetGHPR.cjs.map

package/cjs/dotnet/dotnetGHPR.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"dotnetGHPR.cjs","sources":["../../src/dotnet/dotnetGHPR.ts"],"sourcesContent":null,"names":[],"mappings":";;AAAA;AACA,eAAe,qBAAqB,CAAC,WAAW,EAAE;AAClD,EAAE,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AAC9C,EAAE,IAAI,UAAU,KAAK,SAAS,EAAE,MAAM,IAAI,SAAS,CAAC,CAAC,yBAAyB,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC,CAAC;AAC7G,EAAE,MAAM,IAAI,GAAG;AACf,IAAI,aAAa,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AACxC,GAAG,CAAC;AACJ;AACA,EAAE,MAAM,OAAO,GAAG,CAAC,MAAM,OAAO,kBAAkB,CAAC,EAAE,OAAO,CAAC;AAC7D,EAAE,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE;AAC1C,IAAI,OAAO,EAAE,IAAI;AACjB,GAAG,CAAC,CAAC;AACL,EAAE,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;AACpD,EAAE,IAAI,MAAM,EAAE;AACd,IAAI,OAAO,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;AAClF,GAAG;AACH,EAAE,OAAO,KAAK,CAAC;AACf,CAAC;AACD,MAAM;AACN,EAAE,uBAAuB;AACzB,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;AACJ,MAAC,kBAAkB,GAAG,+BAA+B;AACrD,MAAC,cAAc,GAAG,uBAAuB,GAAG,CAAC,EAAE,kBAAkB,CAAC,CAAC,EAAE,uBAAuB,CAAC,WAAW,CAAC,GAAG,UAAU;AAClI;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,eAAe,0BAA0B,CAAC,WAAW,GAAG,cAAc,EAAE,GAAG,GAAG,cAAc,EAAE;AACrG;AACA,EAAE,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,SAAS,CAAC;AAChE,EAAE,MAAM,YAAY,GAAG,GAAG,KAAK,SAAS,CAAC;AACzC,EAAE,MAAM,qBAAqB,GAAG,cAAc,GAAG,MAAM,qBAAqB,CAAC,WAAW,CAAC,GAAG,KAAK,CAAC;AAClG,EAAE,MAAM,MAAM,GAAG,EAAE,CAAC;AACpB,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,yBAAyB,EAAE,WAAW,CAAC,yHAAyH,CAAC,CAAC,CAAC,CAAC;AAClN,EAAE,IAAI,CAAC,YAAY,EAAE;AACrB,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,iEAAiE,GAAG,0EAA0E,GAAG,iIAAiI,CAAC,CAAC,CAAC;AAC/S,GAAG;AACH,EAAE,IAAI,CAAC,qBAAqB,EAAE;AAC9B;AACA;AACA,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,8NAA8N,CAAC,CAAC,CAAC;AAC3P,GAAG;AACH;AACA;AACA,EAAE,IAAI,cAAc,IAAI,YAAY,IAAI,qBAAqB,EAAE,OAAO;AACtE,IAAI,WAAW;AACf,IAAI,GAAG;AACP,GAAG,CAAC;AACJ,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,MAAM,EAAE,OAAO,SAAS,CAAC;AAC7D,EAAE,MAAM,IAAI,KAAK,CAAC,CAAC,yEAAyE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACvI;;;;;;"}
+{"version":3,"file":"dotnetGHPR.cjs","sources":["../../src/dotnet/dotnetGHPR.ts"],"sourcesContent":null,"names":["ok","notDeepStrictEqual","getEnvVarValue","createDummyNupkg","promisify","exec"],"mappings":"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"}

package/cjs/dotnet/dotnetGHPR.d.ts

@@ -1,14 +1,37 @@
 import type { NuGetRegistryInfo } from './dotnetHelpers.js';
+/**
+ * @param tokenEnvVar The name of the environment variable containing the NUGET token
+ * @returns `true` if the token can be used to push nupkg to the given Nuget registry
+ * @throws
+ * - TypeError: The environment variable ${tokenEnvVar} is undefined!
+ * - Error:
+ *   - The value of the token in ${tokenEnvVar} begins with 'github_pat_' which means it's a Fine-Grained token. At the time of writing, GitHub Fine-Grained tokens cannot push packages. If you believe this is statement is outdated, report the issue at https://github.com/halospv3/hce.shared/issues/new. For more information, see https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-nuget-registry.
+ *   - The GitHub API response header lacked "x-oauth-scopes". This indicates the token we provided is not a workflow token nor a Personal Access Token (classic) and can never have permission to push packages.
+ */
+export declare function tokenCanWritePackages(tokenEnvVar: string, url?: string): Promise<boolean>;
 export declare const nugetGitHubUrlBase = "https://nuget.pkg.github.com";
+/** @deprecated use {@link getNugetGitHubUrl()} instead. */
 export declare const nugetGitHubUrl: string | undefined;
+export declare function getNugetGitHubUrl(): string | undefined;
+/**
+ * If tokenEnvVar is NOT 'GITHUB_TOKEN', then test if the token is defined and return the boolean.
+ * Else If tokenEnvVar is 'GITHUB_TOKEN' and defined, then return true.
+ * Else If tokenEnvVar is 'GITHUB_TOKEN' and undefined, then set tokenEnvVar to 'GH_TOKEN', test if GH_TOKEN is defined, and return the boolean.
+ * @param tokenEnvVar the name of the environment variable with the token's value. Defaults to 'GITHUB_TOKEN'. If environment variable 'GITHUB_TOKEN' is undefined, falls back to 'GH_TOKEN'.
+ * @returns `{isDefined: true}` if the token is defined. Else, if tokenEnvVar is 'GITHUB_TOKEN' (default) and token is defined, returns `true`. Else, if 'GH_TOKEN' is defined, returns `true`. Else, returns `false`
+ */
+export declare function isTokenDefined(tokenEnvVar?: string): {
+    isDefined: boolean;
+    fallback?: string;
+};
 /**
  * Get a {@link NuGetRegistryInfo} for pushing to your GitHub Packages NuGet registry.
  * todo: add support for private, custom GitHub instances. Token is only validated against github.com.
  * @export
- * @param {string} [tokenEnvVar="GITHUB_TOKEN"] The name of environment variable storing the GitHub Packages NuGet registry API key. Defaults to `"GITHUB_TOKEN"`;
- * @param {string} [url=tokenEnvVar] The url of the GitHub Packages NuGet registry. Defaults to {@link nugetGitHubUrl}.
+ * @param {string | 'GITHUB_TOKEN' | 'GH_TOKEN'} [tokenEnvVar="GITHUB_TOKEN"] The name of environment variable storing the GitHub Packages NuGet registry API key. Defaults to `"GITHUB_TOKEN"`. If GITHUB_TOKEN is undefined, fallback to GH_TOKEN;
+ * @param {string} [url=tokenEnvVar] The url of the GitHub Packages NuGet registry. Defaults to return value of {@link getNugetGitHubUrl()}.
  * @returns {(NuGetRegistryInfo | undefined)} a {@link NuGetRegistryInfo} object if {@link tokenEnvVar} and {@link url} are defined. Else, `undefined`.
  * note: `url` defaults to job's repository owner's GitHub registry in GitHub Actions workflow. If GITHUB_REPOSITORY_OWNER is not defined, then an error will be logged and `undefined` will be returned.
  */
-export declare function getGithubNugetRegistryPair(tokenEnvVar?: string, url?: string | undefined): Promise<NuGetRegistryInfo | undefined>;
+export declare function getGithubNugetRegistryPair(tokenEnvVar?: string | 'GITHUB_TOKEN' | 'GH_TOKEN', url?: string | undefined): Promise<NuGetRegistryInfo | undefined>;
 //# sourceMappingURL=dotnetGHPR.d.ts.map

package/cjs/dotnet/dotnetGHPR.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dotnetGHPR.d.ts","sourceRoot":"","sources":["../../src/dotnet/dotnetGHPR.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAoB5D,eAAO,MAAM,kBAAkB,iCAAiC,CAAC;AACjE,eAAO,MAAM,cAAc,oBAEf,CAAC;AAEb;;;;;;;;GAQG;AACH,wBAAsB,0BAA0B,CAC/C,WAAW,SAAiB,EAC5B,GAAG,GAAE,MAAM,GAAG,SAA0B,GACtC,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAwCxC"}
+{"version":3,"file":"dotnetGHPR.d.ts","sourceRoot":"","sources":["../../src/dotnet/dotnetGHPR.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,oBAkD5E;AAOD,eAAO,MAAM,kBAAkB,iCAAiC,CAAC;AAEjE,2DAA2D;AAC3D,eAAO,MAAM,cAAc,EAAE,MAAM,GAAG,SAA+B,CAAC;AAGtE,wBAAgB,iBAAiB,uBAMhC;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,WAAW,SAAiB,GAAG;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAetG;AAED;;;;;;;;GAQG;AACH,wBAAsB,0BAA0B,CAC/C,WAAW,GAAE,MAAM,GAAG,cAAc,GAAG,UAA2B,EAClE,GAAG,GAAE,MAAM,GAAG,SAA+B,GAC3C,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAuDxC"}

package/cjs/dotnet/dotnetGLPR.cjs

@@ -1,9 +1,9 @@
 'use strict';
 
-const node_console = require('node:console');
-const _process$env = process.env,
-  CI_API_V4_URL = _process$env.CI_API_V4_URL,
-  CI_PROJECT_ID = _process$env.CI_PROJECT_ID;
+const envUtils = require('../envUtils.cjs');
+const _envUtils$getEnv = envUtils.getEnv(),
+  CI_API_V4_URL = _envUtils$getEnv.CI_API_V4_URL,
+  CI_PROJECT_ID = _envUtils$getEnv.CI_PROJECT_ID;
 const nameof = {
   CI_API_V4_URL: 'CI_API_V4_URL',
   CI_PROJECT_ID: 'CI_PROJECT_ID'
@@ -21,8 +21,8 @@ const nugetGitLabUrl = CI_API_V4_URL && CI_PROJECT_ID ? `${CI_API_V4_URL}/projec
  */
 function getGitlabNugetRegistryPair(tokenEnvVar = GitLabTokenEnvVar, url = nugetGitLabUrl) {
   // yes, this is stupid. No, I won't change it.
-  if (!process.env[tokenEnvVar]) {
-    node_console.error(new Error(`The environment variable ${tokenEnvVar} was specified as the source of the token to push a NuGet package to GitLab, but the environment variable does not exist.`));
+  if (!envUtils.getEnvVarValue(tokenEnvVar)) {
+    console.error(new Error(`The environment variable ${tokenEnvVar} was specified as the source of the token to push a NuGet package to GitLab, but the environment variable does not exist.`));
     return undefined;
   }
   if (url) {
@@ -31,7 +31,7 @@ function getGitlabNugetRegistryPair(tokenEnvVar = GitLabTokenEnvVar, url = nuget
       url
     };
   }
-  node_console.error(new Error(`The environment variables ${nameof.CI_API_V4_URL} or ${nameof.CI_PROJECT_ID} do not exist and a custom GitLab Packages NuGet registry URL was not provided.`));
+  console.error(new Error(`The environment variables ${nameof.CI_API_V4_URL} or ${nameof.CI_PROJECT_ID} do not exist and a custom GitLab Packages NuGet registry URL was not provided.`));
   return undefined;
 }
 exports.GitLabTokenEnvVar = GitLabTokenEnvVar;

package/cjs/dotnet/dotnetGLPR.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"dotnetGLPR.cjs","sources":["../../src/dotnet/dotnetGLPR.ts"],"sourcesContent":null,"names":["error"],"mappings":";;;;AACA,MAAM;AACN,EAAE,aAAa;AACf,EAAE,aAAa;AACf,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;AAChB,MAAM,MAAM,GAAG;AACf,EAAE,aAAa,EAAE,eAAe;AAChC,EAAE,aAAa,EAAE,eAAe;AAChC,CAAC,CAAC;AACU,MAAC,iBAAiB,GAAG,eAAe;AACpC,MAAC,kBAAkB,GAAG,cAAc;AACpC,MAAC,cAAc,GAAG,aAAa,IAAI,aAAa,GAAG,CAAC,EAAE,aAAa,CAAC,UAAU,EAAE,aAAa,CAAC,0BAA0B,CAAC,GAAG,UAAU;AAClJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,0BAA0B,CAAC,WAAW,GAAG,iBAAiB,EAAE,GAAG,GAAG,cAAc,EAAE;AAClG;AACA,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE;AACjC,IAAIA,kBAAK,CAAC,IAAI,KAAK,CAAC,CAAC,yBAAyB,EAAE,WAAW,CAAC,yHAAyH,CAAC,CAAC,CAAC,CAAC;AACzL,IAAI,OAAO,SAAS,CAAC;AACrB,GAAG;AACH,EAAE,IAAI,GAAG,EAAE;AACX,IAAI,OAAO;AACX,MAAM,WAAW;AACjB,MAAM,GAAG;AACT,KAAK,CAAC;AACN,GAAG;AACH,EAAEA,kBAAK,CAAC,IAAI,KAAK,CAAC,CAAC,0BAA0B,EAAE,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,aAAa,CAAC,+EAA+E,CAAC,CAAC,CAAC,CAAC;AAClL,EAAE,OAAO,SAAS,CAAC;AACnB;;;;;;;"}
+{"version":3,"file":"dotnetGLPR.cjs","sources":["../../src/dotnet/dotnetGLPR.ts"],"sourcesContent":null,"names":["getEnv","getEnvVarValue"],"mappings":";;;;AACA,MAAM;AACN,EAAE,aAAa;AACf,EAAE,aAAa;AACf,CAAC,GAAGA,eAAM,EAAE,CAAC;AACb,MAAM,MAAM,GAAG;AACf,EAAE,aAAa,EAAE,eAAe;AAChC,EAAE,aAAa,EAAE,eAAe;AAChC,CAAC,CAAC;AACU,MAAC,iBAAiB,GAAG,eAAe;AACpC,MAAC,kBAAkB,GAAG,cAAc;AACpC,MAAC,cAAc,GAAG,aAAa,IAAI,aAAa,GAAG,CAAC,EAAE,aAAa,CAAC,UAAU,EAAE,aAAa,CAAC,0BAA0B,CAAC,GAAG,UAAU;AAClJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,0BAA0B,CAAC,WAAW,GAAG,iBAAiB,EAAE,GAAG,GAAG,cAAc,EAAE;AAClG;AACA,EAAE,IAAI,CAACC,uBAAc,CAAC,WAAW,CAAC,EAAE;AACpC,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,yBAAyB,EAAE,WAAW,CAAC,yHAAyH,CAAC,CAAC,CAAC,CAAC;AACjM,IAAI,OAAO,SAAS,CAAC;AACrB,GAAG;AACH,EAAE,IAAI,GAAG,EAAE;AACX,IAAI,OAAO;AACX,MAAM,WAAW;AACjB,MAAM,GAAG;AACT,KAAK,CAAC;AACN,GAAG;AACH,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,0BAA0B,EAAE,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,aAAa,CAAC,+EAA+E,CAAC,CAAC,CAAC,CAAC;AAC1L,EAAE,OAAO,SAAS,CAAC;AACnB;;;;;;;"}

package/cjs/dotnet/dotnetHelpers.cjs

@@ -1,9 +1,10 @@
 'use strict';
 
 const strict = require('node:assert/strict');
+const envUtils = require('../envUtils.cjs');
+const MSBuildProject = require('./MSBuildProject.cjs');
 const dotnetGHPR = require('./dotnetGHPR.cjs');
 const dotnetGLPR = require('./dotnetGLPR.cjs');
-const MSBuildProject = require('./MSBuildProject.cjs');
 function formatDotnetPublish(projectsToPublish, publishProperties) {
   /* Fun Fact: You can define a property and get the evaluated value in the same command!
   ```pwsh
@@ -129,8 +130,8 @@ async function configureDotnetNugetPush(nupkgDir = './publish', registries = [nu
     }
   }
   return registries.map(registry => {
-    const tokenValue = process.env[registry.tokenEnvVar];
-    strict.ok(process.env['SKIP_TOKEN'] === 'true' || tokenValue, `The environment variable ${registry.tokenEnvVar} is undefined!`);
+    const tokenValue = envUtils.getEnvVarValue(registry.tokenEnvVar);
+    strict.ok(envUtils.getEnvVarValue('SKIP_TOKEN') === 'true' || tokenValue, `The environment variable ${registry.tokenEnvVar} is undefined!`);
     `dotnet nuget push ${nupkgDir} --source ${registry.url} --token ${tokenValue ?? '**placeholder**'}`;
   }).join(' && ');
 }

package/cjs/dotnet/dotnetHelpers.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"dotnetHelpers.cjs","sources":["../../src/dotnet/dotnetHelpers.ts"],"sourcesContent":null,"names":["MSBuildProject","MSBuildProjectPreDefinedProperties","nugetGitHubUrlBase","getGithubNugetRegistryPair","getGitlabNugetRegistryPair","ok"],"mappings":"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"}
+{"version":3,"file":"dotnetHelpers.cjs","sources":["../../src/dotnet/dotnetHelpers.ts"],"sourcesContent":null,"names":["MSBuildProject","MSBuildProjectPreDefinedProperties","nugetGitHubUrlBase","getGithubNugetRegistryPair","getGitlabNugetRegistryPair","getEnvVarValue","ok"],"mappings":"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"}

package/cjs/dotnet-wrapper.mjs

@@ -3,4 +3,4 @@
 
 import data from './dotnet.cjs';
 
-export const { dotnetGHPR, dotnetGLPR, dotnetHelpers, msbuildProject, msbuildProjectProperties } = data;
+export const { createDummyNupkg, dotnetGHPR, dotnetGLPR, dotnetHelpers, msbuildProject, msbuildProjectProperties } = data;

package/cjs/dotnet.cjs

@@ -1,13 +1,15 @@
 'use strict';
 
+const MSBuildProject = require('./dotnet/MSBuildProject.cjs');
+const MSBuildProjectProperties = require('./dotnet/MSBuildProjectProperties.cjs');
+const createDummyNupkg$1 = require('./dotnet/createDummyNupkg.cjs');
 const dotnetGHPR$1 = require('./dotnet/dotnetGHPR.cjs');
 const dotnetGLPR$1 = require('./dotnet/dotnetGLPR.cjs');
 const dotnetHelpers$1 = require('./dotnet/dotnetHelpers.cjs');
-const MSBuildProject = require('./dotnet/MSBuildProject.cjs');
-const MSBuildProjectProperties = require('./dotnet/MSBuildProjectProperties.cjs');
+exports.msbuildProject = MSBuildProject;
+exports.msbuildProjectProperties = MSBuildProjectProperties;
+exports.createDummyNupkg = createDummyNupkg$1;
 exports.dotnetGHPR = dotnetGHPR$1;
 exports.dotnetGLPR = dotnetGLPR$1;
 exports.dotnetHelpers = dotnetHelpers$1;
-exports.msbuildProject = MSBuildProject;
-exports.msbuildProjectProperties = MSBuildProjectProperties;
 //# sourceMappingURL=dotnet.cjs.map

package/cjs/dotnet.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"dotnet.cjs","sources":[],"sourcesContent":null,"names":[],"mappings":";;;;;;;;;;;;;;"}
+{"version":3,"file":"dotnet.cjs","sources":[],"sourcesContent":null,"names":[],"mappings":";;;;;;;;;;;;;;;;"}

package/cjs/dotnet.d.ts

@@ -1,6 +1,7 @@
+export * as msbuildProject from "./dotnet/MSBuildProject.js";
+export * as msbuildProjectProperties from "./dotnet/MSBuildProjectProperties.js";
+export * as createDummyNupkg from './dotnet/createDummyNupkg.js';
 export * as dotnetGHPR from "./dotnet/dotnetGHPR.js";
 export * as dotnetGLPR from "./dotnet/dotnetGLPR.js";
 export * as dotnetHelpers from "./dotnet/dotnetHelpers.js";
-export * as msbuildProject from "./dotnet/MSBuildProject.js";
-export * as msbuildProjectProperties from "./dotnet/MSBuildProjectProperties.js";
 //# sourceMappingURL=dotnet.d.ts.map

package/cjs/dotnet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dotnet.d.ts","sourceRoot":"","sources":["../src/dotnet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,wBAAwB,CAAA;AACpD,OAAO,KAAK,UAAU,MAAM,wBAAwB,CAAA;AACpD,OAAO,KAAK,aAAa,MAAM,2BAA2B,CAAA;AAC1D,OAAO,KAAK,cAAc,MAAM,4BAA4B,CAAA;AAC5D,OAAO,KAAK,wBAAwB,MAAM,sCAAsC,CAAA"}
+{"version":3,"file":"dotnet.d.ts","sourceRoot":"","sources":["../src/dotnet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,cAAc,MAAM,4BAA4B,CAAA;AAC5D,OAAO,KAAK,wBAAwB,MAAM,sCAAsC,CAAA;AAChF,OAAO,KAAK,gBAAgB,MAAM,8BAA8B,CAAA;AAChE,OAAO,KAAK,UAAU,MAAM,wBAAwB,CAAA;AACpD,OAAO,KAAK,UAAU,MAAM,wBAAwB,CAAA;AACpD,OAAO,KAAK,aAAa,MAAM,2BAA2B,CAAA"}

package/cjs/envUtils-wrapper.mjs

@@ -0,0 +1,6 @@
+// Bundled with Packemon: https://packemon.dev
+// This is an MJS wrapper for a sibling CJS file
+
+import data from './envUtils.cjs';
+
+export const { getEnv, getEnvVarValue } = data;

package/cjs/envUtils.cjs

@@ -0,0 +1,37 @@
+'use strict';
+
+const dotenv = require('dotenv');
+const node_process = require('node:process');
+
+/**
+ * Load a .env file from the CWD with the given options (or defaults), returns the new value of process.env
+ * @param dotenvOptions 
+ * @param overrides 
+ * @returns 
+ */
+function getEnv(dotenvOptions, overrides) {
+  dotenv.config(dotenvOptions);
+  if (overrides) Object.assign(node_process.env, overrides);
+  return node_process.env;
+}
+
+/**
+ * Get the value from the given env var. If undefined, load .env from CWD and try again or return undefined.
+ * @param envVar 
+ * @returns 
+ */
+function getEnvVarValue(envVar) {
+  let value = node_process.env[envVar];
+  if (!value) {
+    try {
+      dotenv.config();
+    } catch (err) {
+      console.error(String(err));
+    }
+    value = node_process.env[envVar];
+  }
+  return value;
+}
+exports.getEnv = getEnv;
+exports.getEnvVarValue = getEnvVarValue;
+//# sourceMappingURL=envUtils.cjs.map

package/cjs/envUtils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"envUtils.cjs","sources":["../src/envUtils.ts"],"sourcesContent":null,"names":["loadDotenv","env"],"mappings":";;;;;AAGA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,MAAM,CAAC,aAAa,EAAE,SAAS,EAAE;AACjD,EAAEA,aAAU,CAAC,aAAa,CAAC,CAAC;AAC5B,EAAE,IAAI,SAAS,EAAE,MAAM,CAAC,MAAM,CAACC,gBAAG,EAAE,SAAS,CAAC,CAAC;AAC/C,EAAE,OAAOA,gBAAG,CAAC;AACb,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,cAAc,CAAC,MAAM,EAAE;AACvC,EAAE,IAAI,KAAK,GAAGA,gBAAG,CAAC,MAAM,CAAC,CAAC;AAC1B,EAAE,IAAI,CAAC,KAAK,EAAE;AACd,IAAI,IAAI;AACR,MAAMD,aAAU,EAAE,CAAC;AACnB,KAAK,CAAC,OAAO,GAAG,EAAE;AAClB,MAAM,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AACjC,KAAK;AACL,IAAI,KAAK,GAAGC,gBAAG,CAAC,MAAM,CAAC,CAAC;AACxB,GAAG;AACH,EAAE,OAAO,KAAK,CAAC;AACf;;;;;"}

package/cjs/envUtils.d.ts

@@ -0,0 +1,16 @@
+/// <reference types="node" resolution-mode="require"/>
+import { type DotenvConfigOptions } from "dotenv";
+/**
+ * Load a .env file from the CWD with the given options (or defaults), returns the new value of process.env
+ * @param dotenvOptions
+ * @param overrides
+ * @returns
+ */
+export declare function getEnv(dotenvOptions?: DotenvConfigOptions, overrides?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+/**
+ * Get the value from the given env var. If undefined, load .env from CWD and try again or return undefined.
+ * @param envVar
+ * @returns
+ */
+export declare function getEnvVarValue(envVar: string): string | undefined;
+//# sourceMappingURL=envUtils.d.ts.map

package/cjs/envUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envUtils.d.ts","sourceRoot":"","sources":["../src/envUtils.ts"],"names":[],"mappings":";AAAA,OAAO,EAAwB,KAAK,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAGxE;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,aAAa,CAAC,EAAE,mBAAmB,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAO5G;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAYjE"}

package/cjs/eslintConfig.cjs

@@ -1,16 +1,16 @@
 'use strict';
 
-const jsonc = require('eslint-plugin-jsonc');
-const tseslint = require('typescript-eslint');
 const eslint = require('@eslint/js');
+const jsonc = require('eslint-plugin-jsonc');
 const node_module = require('node:module');
+const tseslint = require('typescript-eslint');
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 const _interopDefault = e => e && e.__esModule ? e : {
   default: e
 };
+const eslint__default = /*#__PURE__*/_interopDefault(eslint);
 const jsonc__default = /*#__PURE__*/_interopDefault(jsonc);
 const tseslint__default = /*#__PURE__*/_interopDefault(tseslint);
-const eslint__default = /*#__PURE__*/_interopDefault(eslint);
 
 // CJS compatibility; it started transpiling to a top-level await after upgrading from packemon 4.0.1 to 4.1.0
 const require$1 = node_module.createRequire(typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : _documentCurrentScript && _documentCurrentScript.src || new URL('eslintConfig.cjs', document.baseURI).href);

package/cjs/eslintConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eslintConfig.d.ts","sourceRoot":"","sources":["../src/eslintConfig.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;;AA2BzD,wBA2DE"}
+{"version":3,"file":"eslintConfig.d.ts","sourceRoot":"","sources":["../src/eslintConfig.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;;AA4BzD,wBA2DE"}

package/cjs/semanticReleaseConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"semanticReleaseConfig.d.ts","sourceRoot":"","sources":["../src/semanticReleaseConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAK5D,eAAO,MAAM,cAAc,EAAE,SAAS,UAAU,EAK/C,CAAC;AAEF,eAAO,MAAM,UAAU,SAmCX,CAAC"}
+{"version":3,"file":"semanticReleaseConfig.d.ts","sourceRoot":"","sources":["../src/semanticReleaseConfig.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG5D,eAAO,MAAM,cAAc,EAAE,SAAS,UAAU,EAK/C,CAAC;AAEF,eAAO,MAAM,UAAU,SAmCX,CAAC"}

package/cjs/semanticReleaseConfigDotnet.cjs

@@ -8,10 +8,12 @@ function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e =
 Object.defineProperty(exports, '__esModule', {
   value: true
 });
+const node_util = require('node:util');
+const debug = require('./debug.cjs');
 const dotnetHelpers = require('./dotnet/dotnetHelpers.cjs');
+const envUtils = require('./envUtils.cjs');
 const semanticReleaseConfig = require('./semanticReleaseConfig.cjs');
 const setupGitPluginSpec = require('./setupGitPluginSpec.cjs');
-const debug = require('./debug.cjs');
 
 /** Semantic-Release Config Factory (dotnet)
  * A functional Semantic-Release configuration for dotnet projects
@@ -81,25 +83,25 @@ function appendPlugins(config, projectsToPublish, projectsToPackAndPush) {
  */
 function getConfig(projectsToPublish = [], projectsToPackAndPush = []) {
   if (debug.enabled) {
-    debug('hce.shared-config:\n%o', semanticReleaseConfig.baseConfig);
+    console.debug('hce.shared-config:\n' + node_util.inspect(semanticReleaseConfig.baseConfig, false, Infinity, true));
   }
   const errors = [];
   if (projectsToPublish.length === 0) {
-    const _ = process.env["PROJECTS_TO_PUBLISH"];
+    const _ = envUtils.getEnvVarValue("PROJECTS_TO_PUBLISH");
     if (_ === undefined) errors.push(new Error("projectsToPublish.length must be > 0 or PROJECTS_TO_PUBLISH must be defined and contain at least one path."));else projectsToPublish = _.split(';');
   }
   if (projectsToPackAndPush !== false && projectsToPackAndPush.length === 0) {
-    const _ = process.env["PROJECTS_TO_PACK_AND_PUSH"];
+    const _ = envUtils.getEnvVarValue("PROJECTS_TO_PACK_AND_PUSH");
     if (_ === undefined) errors.push(new Error("projectsToPackAndPush.length must be > 0 or PROJECTS_TO_PACK_AND_PUSH must be defined and contain at least one path."));else projectsToPackAndPush = _.split(';');
   }
   if (errors.length > 0) {
-    throw new Error(["getConfig cannot continue. One or more errors occurred.", ...errors.map(v => v.message)].join('\n'));
+    throw new Error(["getConfig cannot continue. One or more errors occurred.", ...errors.map(v => v.stack)].join('\n'));
   }
   let config = _objectSpread({}, semanticReleaseConfig.baseConfig);
   config = insertAndEditPlugins(config);
   if (projectsToPublish) config = appendPlugins(config, projectsToPublish, projectsToPackAndPush);
   if (debug.enabled) {
-    debug('modified plugins array:\n%o', config.plugins);
+    console.debug(`modified plugins array:\n${node_util.inspect(config.plugins, false, Infinity)}`);
   }
   return config;
 }

package/cjs/semanticReleaseConfigDotnet.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"semanticReleaseConfigDotnet.cjs","sources":["../src/semanticReleaseConfigDotnet.ts"],"sourcesContent":null,"names":["defaultPlugins","setupGitPluginSpec","configurePrepareCmd","configureDotnetNugetPush","baseConfig"],"mappings":"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"}
+{"version":3,"file":"semanticReleaseConfigDotnet.cjs","sources":["../src/semanticReleaseConfigDotnet.ts"],"sourcesContent":null,"names":["defaultPlugins","setupGitPluginSpec","configurePrepareCmd","configureDotnetNugetPush","inspect","baseConfig","getEnvVarValue"],"mappings":"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"}

package/cjs/semanticReleaseConfigDotnet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"semanticReleaseConfigDotnet.d.ts","sourceRoot":"","sources":["../src/semanticReleaseConfigDotnet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAc,MAAM,kBAAkB,CAAC;AAM5D;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAO7D;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC5B,MAAM,EAAE,OAAO,EACf,iBAAiB,EAAE,MAAM,EAAE,EAC3B,qBAAqB,EAAE,MAAM,EAAE,GAAG,KAAK,GACrC,OAAO,CAgBT;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CAAC,iBAAiB,GAAE,MAAM,EAAO,EAAE,qBAAqB,GAAE,MAAM,EAAE,GAAG,KAAU,GAAG,OAAO,CA0CjH;AAED,eAAe,SAAS,CAAC"}
+{"version":3,"file":"semanticReleaseConfigDotnet.d.ts","sourceRoot":"","sources":["../src/semanticReleaseConfigDotnet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAc,MAAM,kBAAkB,CAAC;AAO5D;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAO7D;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC5B,MAAM,EAAE,OAAO,EACf,iBAAiB,EAAE,MAAM,EAAE,EAC3B,qBAAqB,EAAE,MAAM,EAAE,GAAG,KAAK,GACrC,OAAO,CAgBT;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CAAC,iBAAiB,GAAE,MAAM,EAAO,EAAE,qBAAqB,GAAE,MAAM,EAAE,GAAG,KAAU,GAAG,OAAO,CA0CjH;AAED,eAAe,SAAS,CAAC"}

package/cjs/setupGitPluginSpec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setupGitPluginSpec.d.ts","sourceRoot":"","sources":["../src/setupGitPluginSpec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD,eAAO,MAAM,WAAW,0BAA0B,CAAC;AACnD,sEAAsE;AACtE,eAAO,MAAM,cAAc;;;CAIL,CAAC;AASvB;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CA+CtE"}
+{"version":3,"file":"setupGitPluginSpec.d.ts","sourceRoot":"","sources":["../src/setupGitPluginSpec.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,eAAO,MAAM,WAAW,0BAA0B,CAAC;AACnD,sEAAsE;AACtE,eAAO,MAAM,cAAc;;;CAIL,CAAC;AASvB;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CA+CtE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@halospv3/hce.shared-config",
-  "version": "2.4.3",
+  "version": "2.6.0",
   "description": "Automate commit message quality, changelogs, and CI/CD releases. Exports a semantic-release shareable configuration deserialized from this package's '.releaserc.yml'. Shared resources for .NET projects are also distributed with this package.",
   "keywords": [
     "halo",
@@ -43,7 +43,8 @@
     "prepare": "husky",
     "presemantic-release": "npm run pack && npm run check",
     "semantic-release": "npx semantic-release",
-    "test": "npm run build && node --test --import tsx ./tests/**/*.test.ts",
+    "pretest": "npm run build",
+    "test": "tsx --test ./tests/**/*.test.ts",
     "type": "tsc --build",
     "validate": "packemon validate",
     "watch": "packemon watch"
@@ -55,12 +56,12 @@
     "@eslint/js": "^9.3.0",
     "@octokit/request": "^9.1.0",
     "@semantic-release/changelog": "^6.0.3",
-    "@semantic-release/commit-analyzer": "^12.0.0",
+    "@semantic-release/commit-analyzer": "^13.0.0",
     "@semantic-release/exec": "^6.0.3",
     "@semantic-release/git": "^10.0.1",
     "@semantic-release/github": "^10.0.4",
     "@semantic-release/npm": "^12.0.0",
-    "@semantic-release/release-notes-generator": "^13.0.0",
+    "@semantic-release/release-notes-generator": "^14.0.0",
     "@stylistic/eslint-plugin": "^2.1.0",
     "@types/eslint__js": "^8.42.3",
     "@types/js-yaml": "^4.0.9",
@@ -68,14 +69,14 @@
     "@types/semantic-release": "^20.0.6",
     "@typescript-eslint/eslint-plugin": "^7.10.0",
     "@typescript-eslint/parser": "^7.10.0",
-    "conventional-changelog-conventionalcommits": "^7.0.2",
+    "conventional-changelog-conventionalcommits": "^8.0.0",
     "debug": "^4.3.4",
     "eslint-plugin-jsonc": "^2.15.1",
     "globals": "^15.3.0",
     "husky": "^9.0.11",
     "js-yaml": "^4.1.0",
     "node-fetch": "^3.3.2",
-    "semantic-release": "^23.1.1",
+    "semantic-release": "^24.0.0",
     "semantic-release-export-data": "^1.0.1",
     "typescript-eslint": "^7.10.0"
   },
@@ -91,6 +92,7 @@
     "@types/tmp": "^0.2.6",
     "ajv": "^8.13.0",
     "ajv-draft-04": "^1.0.0",
+    "dotenv": "^16.4.5",
     "eslint": "^8.57.0",
     "node-fetch": "^3.3.2",
     "packemon": "^4.0.1",
@@ -135,6 +137,7 @@
       "commitlintConfig": "src/commitlintConfig.ts",
       "dotnet": "src/dotnet.ts",
       "eslintConfig": "src/eslintConfig.ts",
+      "envUtils": "src/envUtils.ts",
       "findStaticConfig": "src/findStaticConfig.ts",
       "index": "src/index.ts",
       "semanticReleaseConfig": "src/semanticReleaseConfig.ts",

package/src/dotnet/createDummyNupkg.ts

@@ -0,0 +1,30 @@
+import { execSync, type ExecSyncOptionsWithStringEncoding } from 'node:child_process';
+import { existsSync, unlinkSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { dirSync } from 'tmp';
+
+export function createDummyNupkg(): string {
+    const dirResult = dirSync({ unsafeCleanup: true });
+    const dummyPkgFullPath: string = join(dirResult.name, 'DUMMY.1.0.0.nupkg');
+
+    // delete old and possibly-poisoned nupkg
+    if (existsSync(dummyPkgFullPath))
+        unlinkSync(dummyPkgFullPath);
+
+    const options: ExecSyncOptionsWithStringEncoding = {
+        cwd: dirResult.name,
+        encoding: 'utf8'
+    };
+
+    execSync('dotnet new console --name DUMMY', options);
+    const packOut = execSync(`dotnet pack DUMMY --configuration Release --output ${dirname(dummyPkgFullPath)}`, options);
+
+    const createdLine = packOut.replace('\r', '')
+        .split('\n')
+        .find(line => line.includes('Successfully created package'))?.trim();
+
+    if (!existsSync(dummyPkgFullPath))
+        throw new Error(`The dummy nupkg was created, but could not be found at ${dummyPkgFullPath}. See '${createdLine}'.`);
+
+    return dummyPkgFullPath;
+}

package/src/dotnet/dotnetGHPR.ts

@@ -1,55 +1,132 @@
+import { notDeepStrictEqual, ok } from 'node:assert/strict';
+import { exec, type ExecException } from 'node:child_process';
+import { promisify } from 'node:util';
+import { getEnvVarValue } from '../envUtils.js';
+import { createDummyNupkg } from './createDummyNupkg.js';
 import type { NuGetRegistryInfo } from './dotnetHelpers.js';
 
-// todo: support custom base URL for private GitHub instances
-async function tokenCanWritePackages(tokenEnvVar: string) {
-	const tokenValue = process.env[tokenEnvVar];
+/**
+ * @param tokenEnvVar The name of the environment variable containing the NUGET token 
+ * @returns `true` if the token can be used to push nupkg to the given Nuget registry
+ * @throws
+ * - TypeError: The environment variable ${tokenEnvVar} is undefined!
+ * - Error: 
+ *   - The value of the token in ${tokenEnvVar} begins with 'github_pat_' which means it's a Fine-Grained token. At the time of writing, GitHub Fine-Grained tokens cannot push packages. If you believe this is statement is outdated, report the issue at https://github.com/halospv3/hce.shared/issues/new. For more information, see https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-nuget-registry.
+ *   - The GitHub API response header lacked "x-oauth-scopes". This indicates the token we provided is not a workflow token nor a Personal Access Token (classic) and can never have permission to push packages.
+ */
+export async function tokenCanWritePackages(tokenEnvVar: string, url?: string) {
+	/* double-check the token exists */
+	const info = isTokenDefined(tokenEnvVar);
+	ok(info.isDefined)
+
+	if (url === undefined) {
+		console.debug(`tokenCanWritePackages was called without a NuGet Source URL. Defaulting to use ${`${nugetGitHubUrlBase}/\${GITHUB_REPOSITORY_OWNER}/index.json`} where GITHUB_REPOSITORY_OWNER is '${getOwner()}'`)
+		url = getNugetGitHubUrl();
+	}
+
+	notDeepStrictEqual(url, undefined);
+	notDeepStrictEqual(url, '');
+
+	if (info.fallback)
+		tokenEnvVar = info.fallback;
+
+	const tokenValue = getEnvVarValue(tokenEnvVar);
 	if (tokenValue === undefined)
 		throw new TypeError(`The environment variable ${tokenEnvVar} is undefined!`)
-	const reqH = { authorization: `token ${tokenValue}` };
-	// CJS compatibility - import { request } from '@octokit/request
-	const request = (await import('@octokit/request')).request;
-	const response = await request('GET /', { headers: reqH });
-	const scopes = response.headers['x-oauth-scopes'];
-	if (scopes) {
-		return scopes.includes('write:packages') || scopes.includes('write:packages');
+
+	if (tokenValue.startsWith('github_pat_'))
+		throw new Error(`The value of the token in ${tokenEnvVar} begins with 'github_pat_' which means it's a Fine-Grained token. At the time of writing, GitHub Fine-Grained tokens cannot push packages. If you believe this is statement is outdated, report the issue at https://github.com/halospv3/hce.shared/issues/new. For more information, see https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-nuget-registry.`)
+
+	const dummyNupkgPath = createDummyNupkg();
+	const promiseExec = promisify(exec);
+
+	try {
+		const pushResult = await promiseExec(`dotnet nuget push ${dummyNupkgPath} --source ${url} --api-key ${tokenValue} --skip-duplicate`, { encoding: 'utf8' })
+		const errNewline = pushResult.stderr.includes('\r\n') ? '\r\n' : pushResult.stdout.includes('\r') ? '\r' : '\n';
+
+		// if any *lines* start with "error: " or "Error: ", log stderr
+		const errorCount = pushResult.stderr.split(errNewline ?? '\n').filter(line => line.trim().startsWith('error: ') || line.trim().startsWith('Error: ')).length;
+		if (errorCount > 0)
+			console.error(pushResult.stderr);
+
+		// if any lines start with "warn : ", log stdout
+		const warningCount = pushResult.stdout.split(errNewline ?? '\n').filter(line => line.trim().startsWith('warn : ')).length;
+		if (warningCount > 0)
+			console.warn(pushResult.stdout);
+
+		const hasAuthError = pushResult.stderr.includes('401 (Unauthorized)');
+
+		// return true is no lines contain error indicators.
+		return errorCount === 0 && hasAuthError === false;
+	}
+	catch (err) {
+		const stdout = (err as ExecException).stdout ?? '';
+		console.error((err as ExecException).stack + '\n' + stdout.split('Usage: dotnet nuget push')[0]);
+		return false;
 	}
-	return false;
 }
 
-const { GITHUB_REPOSITORY_OWNER } = process.env;
+/** returns the value of GITHUB_REPOSITORY_OWNER */
+function getOwner(): string | undefined {
+	return getEnvVarValue('GITHUB_REPOSITORY_OWNER')
+}
 
 export const nugetGitHubUrlBase = 'https://nuget.pkg.github.com';
-export const nugetGitHubUrl = GITHUB_REPOSITORY_OWNER
-	? `${nugetGitHubUrlBase}/${GITHUB_REPOSITORY_OWNER}/index.json`
-	: undefined;
+
+/** @deprecated use {@link getNugetGitHubUrl()} instead. */
+export const nugetGitHubUrl: string | undefined = getNugetGitHubUrl();
+
+// todo!: refactor to "return string else throw"
+export function getNugetGitHubUrl() {
+	const owner = getOwner();
+	if (owner)
+		return `${nugetGitHubUrlBase}/${owner}/index.json`;
+	console.warn('GITHUB_REPOSITORY_OWNER is undefined! Default NuGet source for GitHub is unavailable.');
+	return undefined;
+}
+
+/**
+ * If tokenEnvVar is NOT 'GITHUB_TOKEN', then test if the token is defined and return the boolean. 
+ * Else If tokenEnvVar is 'GITHUB_TOKEN' and defined, then return true.
+ * Else If tokenEnvVar is 'GITHUB_TOKEN' and undefined, then set tokenEnvVar to 'GH_TOKEN', test if GH_TOKEN is defined, and return the boolean.
+ * @param tokenEnvVar the name of the environment variable with the token's value. Defaults to 'GITHUB_TOKEN'. If environment variable 'GITHUB_TOKEN' is undefined, falls back to 'GH_TOKEN'.
+ * @returns `{isDefined: true}` if the token is defined. Else, if tokenEnvVar is 'GITHUB_TOKEN' (default) and token is defined, returns `true`. Else, if 'GH_TOKEN' is defined, returns `true`. Else, returns `false`
+ */
+export function isTokenDefined(tokenEnvVar = 'GITHUB_TOKEN'): { isDefined: boolean, fallback?: string } {
+	let token = getEnvVarValue(tokenEnvVar /* custom or GITHUB_TOKEN */);
+
+	if (tokenEnvVar !== 'GITHUB_TOKEN')
+		return { isDefined: (token !== undefined && token !== 'undefined') };
+
+	/* GITHUB_TOKEN */
+	if (token !== undefined && token !== 'undefined')
+		return { isDefined: true };
+
+	token = getEnvVarValue('GH_TOKEN');
+	return {
+		isDefined: (token !== undefined && token !== 'undefined'),
+		fallback: 'GH_TOKEN'
+	};
+}
 
 /**
  * Get a {@link NuGetRegistryInfo} for pushing to your GitHub Packages NuGet registry.
  * todo: add support for private, custom GitHub instances. Token is only validated against github.com.
  * @export
- * @param {string} [tokenEnvVar="GITHUB_TOKEN"] The name of environment variable storing the GitHub Packages NuGet registry API key. Defaults to `"GITHUB_TOKEN"`;
- * @param {string} [url=tokenEnvVar] The url of the GitHub Packages NuGet registry. Defaults to {@link nugetGitHubUrl}.
+ * @param {string | 'GITHUB_TOKEN' | 'GH_TOKEN'} [tokenEnvVar="GITHUB_TOKEN"] The name of environment variable storing the GitHub Packages NuGet registry API key. Defaults to `"GITHUB_TOKEN"`. If GITHUB_TOKEN is undefined, fallback to GH_TOKEN;
+ * @param {string} [url=tokenEnvVar] The url of the GitHub Packages NuGet registry. Defaults to return value of {@link getNugetGitHubUrl()}.
  * @returns {(NuGetRegistryInfo | undefined)} a {@link NuGetRegistryInfo} object if {@link tokenEnvVar} and {@link url} are defined. Else, `undefined`.
  * note: `url` defaults to job's repository owner's GitHub registry in GitHub Actions workflow. If GITHUB_REPOSITORY_OWNER is not defined, then an error will be logged and `undefined` will be returned.
  */
 export async function getGithubNugetRegistryPair(
-	tokenEnvVar = 'GITHUB_TOKEN',
-	url: string | undefined = nugetGitHubUrl,
+	tokenEnvVar: string | 'GITHUB_TOKEN' | 'GH_TOKEN' = 'GITHUB_TOKEN',
+	url: string | undefined = getNugetGitHubUrl(),
 ): Promise<NuGetRegistryInfo | undefined> {
-	// yes, this is stupid. No, I won't change it.
-	const isTokenDefined = process.env[tokenEnvVar] !== undefined;
-	const isUrlDefined = url !== undefined;
-	const canTokenWritePackages = isTokenDefined ? await tokenCanWritePackages(tokenEnvVar) : false;
-
 	const errors: Error[] = [];
+	const _isTokenDefinedInfo = isTokenDefined(tokenEnvVar);
+	let canTokenWritePackages = undefined;
 
-	if (!isTokenDefined)
-		errors.push(
-			new Error(
-				`The environment variable ${tokenEnvVar} was specified as the source of the token to push a NuGet package to GitHub, but the environment variable does not exist.`,
-			),
-		);
-	if (!isUrlDefined) {
+	if ((url ??= getNugetGitHubUrl()) === undefined) {
 		errors.push(
 			new Error(
 				'The url for the GitHub Packages NuGet registry was undefined.\n' +
@@ -58,7 +135,27 @@ export async function getGithubNugetRegistryPair(
 			),
 		);
 	}
-	if (!canTokenWritePackages) {
+
+	if (_isTokenDefinedInfo.isDefined) {
+		if (_isTokenDefinedInfo.fallback)
+			tokenEnvVar = _isTokenDefinedInfo.fallback;
+		try {
+			canTokenWritePackages = await tokenCanWritePackages(tokenEnvVar, url);
+		}
+		catch (err) {
+			if (err instanceof Error)
+				errors.push(err);
+			else
+				errors.push(new Error(String(err)));
+		}
+	}
+	else {
+		const errMsg = `The environment variable ${tokenEnvVar} was specified as the source of the token to push a NuGet package to GitHub, but the environment variable does not exist.`
+			+ `${_isTokenDefinedInfo.fallback === undefined ? '' : ` The fallback environment variable ${_isTokenDefinedInfo.fallback} is also undefined.`}`;
+		errors.push(new Error(errMsg));
+	}
+
+	if (canTokenWritePackages === false) {
 		// yes, this is a critical error that should be fixed before Semantic Release can succeed.
 		// yes, this is incredibly irritating to deal with in local runs.
 		errors.push(
@@ -69,10 +166,14 @@ export async function getGithubNugetRegistryPair(
 	}
 
 	// conditions checked so `url` is certainly defined
-	if (isTokenDefined && isUrlDefined && canTokenWritePackages)
+	if (_isTokenDefinedInfo.isDefined && url !== undefined && canTokenWritePackages)
 		return { tokenEnvVar, url };
 
-	if (process.env['SKIP_TOKEN'] === 'true')
+	const aggErr = new Error(`One more more errors occurred when getting GHPR url-token pair. Errors:\n${errors.map(v => v.stack).join('\n')}`);
+
+	if (getEnvVarValue('SKIP_TOKEN') === 'true' && aggErr.message.length > 0) {
+		console.error('WARN: errors were thrown, but SKIP_TOKEN is defined.\n' + aggErr.stack)
 		return undefined;
-	throw new Error(`One more more errors occurred when getting GHPR url-token pair. Errors:\n${errors.map(v => v.message).join('\n')}`);
+	}
+	throw aggErr;
 }

package/src/dotnet/dotnetGLPR.ts

@@ -1,7 +1,7 @@
-import { error } from 'node:console';
+import { getEnv, getEnvVarValue } from '../envUtils.js';
 import type { NuGetRegistryInfo } from './dotnetHelpers.js';
 
-const { CI_API_V4_URL, CI_PROJECT_ID } = process.env;
+const { CI_API_V4_URL, CI_PROJECT_ID } = getEnv();
 const nameof = {
 	CI_API_V4_URL: 'CI_API_V4_URL',
 	CI_PROJECT_ID: 'CI_PROJECT_ID',
@@ -26,8 +26,8 @@ export function getGitlabNugetRegistryPair(
 	url: string | undefined = nugetGitLabUrl,
 ): NuGetRegistryInfo | undefined {
 	// yes, this is stupid. No, I won't change it.
-	if (!process.env[tokenEnvVar]) {
-		error(
+	if (!getEnvVarValue(tokenEnvVar)) {
+		console.error(
 			new Error(
 				`The environment variable ${tokenEnvVar} was specified as the source of the token to push a NuGet package to GitLab, but the environment variable does not exist.`,
 			),
@@ -37,7 +37,7 @@ export function getGitlabNugetRegistryPair(
 	if (url) {
 		return { tokenEnvVar, url };
 	}
-	error(
+	console.error(
 		new Error(
 			`The environment variables ${nameof.CI_API_V4_URL} or ${nameof.CI_PROJECT_ID} do not exist and a custom GitLab Packages NuGet registry URL was not provided.`,
 		),

package/src/dotnet/dotnetHelpers.ts

@@ -1,8 +1,8 @@
 import { ok } from 'node:assert/strict';
+import { getEnvVarValue } from '../envUtils.js';
+import { MSBuildProject, MSBuildProjectPreDefinedProperties } from './MSBuildProject.js';
 import { getGithubNugetRegistryPair, nugetGitHubUrlBase } from './dotnetGHPR.js';
 import { getGitlabNugetRegistryPair } from './dotnetGLPR.js';
-import { MSBuildProject, MSBuildProjectPreDefinedProperties } from './MSBuildProject.js';
-
 
 function formatDotnetPublish(projectsToPublish: string[], publishProperties: string[]): string {
 	/* Fun Fact: You can define a property and get the evaluated value in the same command!
@@ -175,8 +175,8 @@ export async function configureDotnetNugetPush(
 	return registries
 		.map(
 			(registry) => {
-				const tokenValue = process.env[registry.tokenEnvVar];
-				ok(process.env['SKIP_TOKEN'] === 'true' || tokenValue, `The environment variable ${registry.tokenEnvVar} is undefined!`);
+				const tokenValue = getEnvVarValue(registry.tokenEnvVar);
+				ok(getEnvVarValue('SKIP_TOKEN') === 'true' || tokenValue, `The environment variable ${registry.tokenEnvVar} is undefined!`);
 				`dotnet nuget push ${nupkgDir} --source ${registry.url} --token ${tokenValue ?? '**placeholder**'}`
 			}
 		)

package/src/dotnet.ts

@@ -1,5 +1,6 @@
+export * as msbuildProject from "./dotnet/MSBuildProject.js"
+export * as msbuildProjectProperties from "./dotnet/MSBuildProjectProperties.js"
+export * as createDummyNupkg from './dotnet/createDummyNupkg.js'
 export * as dotnetGHPR from "./dotnet/dotnetGHPR.js"
 export * as dotnetGLPR from "./dotnet/dotnetGLPR.js"
 export * as dotnetHelpers from "./dotnet/dotnetHelpers.js"
-export * as msbuildProject from "./dotnet/MSBuildProject.js"
-export * as msbuildProjectProperties from "./dotnet/MSBuildProjectProperties.js"

package/src/envUtils.ts

@@ -0,0 +1,36 @@
+import { config as loadDotenv, type DotenvConfigOptions } from "dotenv";
+import { env } from 'node:process';
+
+/**
+ * Load a .env file from the CWD with the given options (or defaults), returns the new value of process.env
+ * @param dotenvOptions 
+ * @param overrides 
+ * @returns 
+ */
+export function getEnv(dotenvOptions?: DotenvConfigOptions, overrides?: NodeJS.ProcessEnv): NodeJS.ProcessEnv {
+    loadDotenv(dotenvOptions);
+
+    if (overrides)
+        Object.assign(env, overrides);
+
+    return env;
+}
+
+/**
+ * Get the value from the given env var. If undefined, load .env from CWD and try again or return undefined.
+ * @param envVar 
+ * @returns 
+ */
+export function getEnvVarValue(envVar: string): string | undefined {
+    let value = env[envVar];
+    if (!value) {
+        try {
+            loadDotenv();
+        }
+        catch (err) {
+            console.error(String(err))
+        }
+        value = env[envVar];
+    }
+    return value;
+}

package/src/eslintConfig.ts

@@ -1,8 +1,8 @@
-import jsonc from "eslint-plugin-jsonc";
-import tseslint from "typescript-eslint";
-import { type TSESLint } from "@typescript-eslint/utils";
 import eslint from "@eslint/js";
+import { type TSESLint } from "@typescript-eslint/utils";
+import jsonc from "eslint-plugin-jsonc";
 import { createRequire } from "module";
+import tseslint from "typescript-eslint";
 
 // CJS compatibility; it started transpiling to a top-level await after upgrading from packemon 4.0.1 to 4.1.0
 const require = createRequire(import.meta.url);

package/src/index.ts

@@ -1,4 +1,4 @@
 /**
  * Runs HCE.Shared and returns a semantic-release "shareable configuration" object.
 */
-export { baseConfig as default } from './semanticReleaseConfig.js';
+export { baseConfig as default } from './semanticReleaseConfig.js';

package/src/semantic-release__git.d.ts

@@ -87,5 +87,5 @@ declare module '@semantic-release/git' {
 			logger: { log(_0: string, _1: unknown | number): void },
 		}
 	): Promise<void>;
-	export { verifyConditions, prepare }
+	export { prepare, verifyConditions };
 }

package/src/semanticReleaseConfig.ts

@@ -1,6 +1,6 @@
+import type { Options as GitOptions } from '@semantic-release/git';
+import type { Options as GithubOptions } from '@semantic-release/github';
 import type { Options, PluginSpec } from 'semantic-release';
-import type { Options as GitOptions } from '@semantic-release/git'
-import type { Options as GithubOptions } from '@semantic-release/github'
 import { DefaultOptions } from './setupGitPluginSpec.js';
 
 export const defaultPlugins: readonly PluginSpec[] = [

package/src/semanticReleaseConfigDotnet.ts

@@ -11,11 +11,13 @@
  *
  */
 
+import { inspect } from 'node:util';
 import type { Options, PluginSpec } from 'semantic-release';
+import debug from './debug.js';
 import { configureDotnetNugetPush, configurePrepareCmd } from './dotnet/dotnetHelpers.js';
+import { getEnvVarValue } from './envUtils.js';
 import { baseConfig, defaultPlugins } from './semanticReleaseConfig.js';
 import { setupGitPluginSpec } from './setupGitPluginSpec.js';
-import debug from './debug.js'
 
 /**
  * TODO: options/params for inserts/edits. NOT ready for production. Currently, this can only add Git plugin's options if undefined or one or more is missing.
@@ -83,13 +85,13 @@ export function appendPlugins(
  */
 export function getConfig(projectsToPublish: string[] = [], projectsToPackAndPush: string[] | false = []): Options {
 	if (debug.enabled) {
-		debug('hce.shared-config:\n%o', baseConfig);
+		console.debug('hce.shared-config:\n' + inspect(baseConfig, false, Infinity, true));
 	}
 
 	const errors: Error[] = [];
 
 	if (projectsToPublish.length === 0) {
-		const _ = process.env["PROJECTS_TO_PUBLISH"];
+		const _ = getEnvVarValue("PROJECTS_TO_PUBLISH");
 		if (_ === undefined)
 			errors.push(new Error("projectsToPublish.length must be > 0 or PROJECTS_TO_PUBLISH must be defined and contain at least one path."));
 		else
@@ -97,7 +99,7 @@ export function getConfig(projectsToPublish: string[] = [], projectsToPackAndPus
 	}
 
 	if (projectsToPackAndPush !== false && projectsToPackAndPush.length === 0) {
-		const _ = process.env["PROJECTS_TO_PACK_AND_PUSH"]
+		const _ = getEnvVarValue("PROJECTS_TO_PACK_AND_PUSH")
 		if (_ === undefined)
 			errors.push(new Error("projectsToPackAndPush.length must be > 0 or PROJECTS_TO_PACK_AND_PUSH must be defined and contain at least one path."));
 		else
@@ -108,7 +110,7 @@ export function getConfig(projectsToPublish: string[] = [], projectsToPackAndPus
 		throw new Error(
 			[
 				"getConfig cannot continue. One or more errors occurred.",
-				...(errors.map(v => v.message))
+				...(errors.map(v => v.stack))
 			].join('\n')
 		)
 	}
@@ -119,7 +121,7 @@ export function getConfig(projectsToPublish: string[] = [], projectsToPackAndPus
 		config = appendPlugins(config, projectsToPublish, projectsToPackAndPush);
 
 	if (debug.enabled) {
-		debug('modified plugins array:\n%o', config.plugins);
+		console.debug(`modified plugins array:\n${inspect(config.plugins, false, Infinity)}`);
 	}
 
 	return config;

package/src/setupGitPluginSpec.ts

@@ -1,5 +1,5 @@
-import type { PluginSpec } from 'semantic-release';
 import type { AssetEntry, Options as GitOptions } from '@semantic-release/git';
+import type { PluginSpec } from 'semantic-release';
 
 export const GitPluginId = '@semantic-release/git';
 /** As specified at https://github.com/semantic-release/git#options */