@halospv3/hce.shared-config 3.0.0-develop.9 → 3.1.0-develop.1

package/mjs/utils/execAsync.mjs

@@ -2,7 +2,7 @@ import { type } from 'arktype';
 import { exec } from 'node:child_process';
 import { constants } from 'node:os';
 import { promisify } from 'node:util';
-import { isNativeError } from 'node:util/types';
+import { isError } from './isError.mjs';
 
 /* eslint-disable jsdoc/no-defaults */
 
@@ -16,7 +16,7 @@ import { isNativeError } from 'node:util/types';
  */
 async function execAsync(command, setStderrAsCause = false) {
   return await promisify(exec)(command).catch(error => {
-    if (!isNativeError(error)) throw new Error(JSON.stringify(error));
+    if (!isError(error)) throw new Error(JSON.stringify(error));
     if (setStderrAsCause && 'stderr' in error && typeof error.stderr === 'string' && error.stderr !== '') error.cause ??= error.stderr;
     if ('stdout' in error && typeof error.stdout === 'string') {
       error.message += '\nSTDOUT:\n' + `  ${error.stdout.replaceAll('\n', '\n  ')}`;

package/mjs/utils/execAsync.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"execAsync.mjs","sources":["../../src/utils/execAsync.ts"],"sourcesContent":null,"names":[],"mappings":";;;;;;AAAA;;AAOA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,eAAe,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,KAAK,EAAE;AACnE,EAAE,OAAO,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI;AACvD,IAAI,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AACrE,IAAI,IAAI,gBAAgB,IAAI,QAAQ,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,EAAE,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,MAAM;AACtI,IAAI,IAAI,QAAQ,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE;AAC/D,MAAM,KAAK,CAAC,OAAO,IAAI,aAAa,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;AACnF;AACA,IAAI,IAAI,QAAQ,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE;AAC/D,MAAM,KAAK,CAAC,OAAO,IAAI,aAAa,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;AACnF;AACA,IAAI,MAAM,IAAI,0BAA0B,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC;AAC9D,GAAG,CAAC;AACJ;AACA,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC;AAC1C,EAAE,MAAM,EAAE,eAAe;AACzB,EAAE,SAAS,EAAE,gBAAgB;AAC7B,EAAE,OAAO,EAAE,eAAe;AAC1B,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAChF;AACA,GAAG,MAAM,CAAC,CAAC,QAAQ,EAAE,OAAO,KAAK,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;AACvD,EAAE,SAAS,EAAE,QAAQ;AACrB,EAAE,SAAS,EAAE;AACb,CAAC,CAAC;AACK,MAAM,0BAA0B,SAAS,KAAK,CAAC;AACtD,EAAE,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE;AAChC,IAAI,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC;AAC3C,IAAI,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC;AAC3B,IAAI,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG;AAC1B,IAAI,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI;AAC5B,IAAI,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM;AAChC,IAAI,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM;AAChC,IAAI,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM;AAChC,IAAI,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM;AAChC;AACA,EAAE,GAAG;AACL,EAAE,IAAI;AACN,EAAE,MAAM;AACR,EAAE,MAAM;AACR,EAAE,MAAM;AACR,EAAE,MAAM;AACR;;;;"}
+{"version":3,"file":"execAsync.mjs","sources":["../../src/utils/execAsync.ts"],"sourcesContent":null,"names":[],"mappings":";;;;;;AAAA;;AAOA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,eAAe,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,KAAK,EAAE;AACnE,EAAE,OAAO,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI;AACvD,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/D,IAAI,IAAI,gBAAgB,IAAI,QAAQ,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,EAAE,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,MAAM;AACtI,IAAI,IAAI,QAAQ,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE;AAC/D,MAAM,KAAK,CAAC,OAAO,IAAI,aAAa,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;AACnF;AACA,IAAI,IAAI,QAAQ,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE;AAC/D,MAAM,KAAK,CAAC,OAAO,IAAI,aAAa,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;AACnF;AACA,IAAI,MAAM,IAAI,0BAA0B,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC;AAC9D,GAAG,CAAC;AACJ;AACA,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC;AAC1C,EAAE,MAAM,EAAE,eAAe;AACzB,EAAE,SAAS,EAAE,gBAAgB;AAC7B,EAAE,OAAO,EAAE,eAAe;AAC1B,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAChF;AACA,GAAG,MAAM,CAAC,CAAC,QAAQ,EAAE,OAAO,KAAK,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;AACvD,EAAE,SAAS,EAAE,QAAQ;AACrB,EAAE,SAAS,EAAE;AACb,CAAC,CAAC;AACK,MAAM,0BAA0B,SAAS,KAAK,CAAC;AACtD,EAAE,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE;AAChC,IAAI,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC;AAC3C,IAAI,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC;AAC3B,IAAI,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG;AAC1B,IAAI,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI;AAC5B,IAAI,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM;AAChC,IAAI,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM;AAChC,IAAI,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM;AAChC,IAAI,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM;AAChC;AACA,EAAE,GAAG;AACL,EAAE,IAAI;AACN,EAAE,MAAM;AACR,EAAE,MAAM;AACR,EAAE,MAAM;AACR,EAAE,MAAM;AACR;;;;"}

package/mjs/utils/isError.d.ts

@@ -0,0 +1,11 @@
+/** @import 'typescript/lib/lib.esnext.error.d.ts' */
+/**
+ * Compatibility wrapper for ES2026 (Node.js 25)
+ * {@link Error.isError Error.isError}
+ * with failover to the deprecated {@link isNativeError utils.types.isNativeError}.
+ * @param error A parameter which may be an Error.
+ * @returns `true` if {@link error} is derived from or is sufficiently similar to {@link Error}. Else, `false`.
+ * Note: DOMExceptions will result in `false`
+ */
+export declare function isError(error: unknown): error is Error;
+//# sourceMappingURL=isError.d.ts.map

package/mjs/utils/isError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isError.d.ts","sourceRoot":"","sources":["../../src/utils/isError.ts"],"names":[],"mappings":"AAEA,qDAAqD;AAErD;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAKtD"}

package/mjs/utils/isError.mjs

@@ -0,0 +1,19 @@
+import { isNativeError } from 'node:util/types';
+
+/** @import 'typescript/lib/lib.esnext.error.d.ts' */
+
+/**
+ * Compatibility wrapper for ES2026 (Node.js 25)
+ * {@link Error.isError Error.isError}
+ * with failover to the deprecated {@link isNativeError utils.types.isNativeError}.
+ * @param error A parameter which may be an Error.
+ * @returns `true` if {@link error} is derived from or is sufficiently similar to {@link Error}. Else, `false`.
+ * Note: DOMExceptions will result in `false`
+ */
+function isError(error) {
+  return 'isError' in Error && typeof Error.isError === 'function' && Error.isError.length > 0 ? Error.isError(error)
+  // eslint-disable-next-line @typescript-eslint/no-deprecated
+  : isNativeError(error);
+}
+export { isError };
+//# sourceMappingURL=isError.mjs.map

package/mjs/utils/isError.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"isError.mjs","sources":["../../src/utils/isError.ts"],"sourcesContent":null,"names":[],"mappings":";;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,OAAO,CAAC,KAAK,EAAE;AAC/B,EAAE,OAAO,SAAS,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,UAAU,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK;AACpH;AACA,IAAI,aAAa,CAAC,KAAK,CAAC;AACxB;;;;"}

package/mjs/utils/miscTypes.d.ts

@@ -1,6 +1,5 @@
 import { type Type } from 'arktype';
-import type { StringType } from 'arktype/internal/methods/string.ts';
-export declare const tBooleanString: StringType<'false' | 'true'>;
+export declare const tBooleanString: Type<'false' | 'true'>;
 export type BooleanString = typeof tBooleanString.infer;
 export declare const tEmptyOrBooleanString: Type<'' | 'false' | 'true'>;
 export type EmptyOrBooleanString = typeof tEmptyOrBooleanString.infer;

package/mjs/utils/miscTypes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"miscTypes.d.ts","sourceRoot":"","sources":["../../src/utils/miscTypes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,IAAI,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAErE,eAAO,MAAM,cAAc,EAAE,UAAU,CAAC,OAAO,GAAG,MAAM,CAA4B,CAAC;AACrF,MAAM,MAAM,aAAa,GAAG,OAAO,cAAc,CAAC,KAAK,CAAC;AAExD,eAAO,MAAM,qBAAqB,EAAE,IAAI,CAAC,EAAE,GAAG,OAAO,GAAG,MAAM,CAAiC,CAAC;AAChG,MAAM,MAAM,oBAAoB,GAAG,OAAO,qBAAqB,CAAC,KAAK,CAAC;AAEtE,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,MAAM,IAAI,GAAG,CAAC,EAAE,SAAS,GAAG,MAAM,IAAI,MAAM,EAAE,GAAG,KAAK,GAAG,CAAC,CAAC;AAEzF;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,SAAS,OAAO,EAAE,IACjD,OAAO,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,MAAM,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC;AAElF,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,QAAQ,CAAC"}
+{"version":3,"file":"miscTypes.d.ts","sourceRoot":"","sources":["../../src/utils/miscTypes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,IAAI,EAAE,MAAM,SAAS,CAAC;AAE1C,eAAO,MAAM,cAAc,EAAE,IAAI,CAAC,OAAO,GAAG,MAAM,CAA4B,CAAC;AAC/E,MAAM,MAAM,aAAa,GAAG,OAAO,cAAc,CAAC,KAAK,CAAC;AAExD,eAAO,MAAM,qBAAqB,EAAE,IAAI,CAAC,EAAE,GAAG,OAAO,GAAG,MAAM,CAAiC,CAAC;AAChG,MAAM,MAAM,oBAAoB,GAAG,OAAO,qBAAqB,CAAC,KAAK,CAAC;AAEtE,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,MAAM,IAAI,GAAG,CAAC,EAAE,SAAS,GAAG,MAAM,IAAI,MAAM,EAAE,GAAG,KAAK,GAAG,CAAC,CAAC;AAEzF;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,SAAS,OAAO,EAAE,IACjD,OAAO,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,MAAM,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC;AAElF,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,QAAQ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@halospv3/hce.shared-config",
-  "version": "3.0.0-develop.9",
+  "version": "3.1.0-develop.1",
   "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",
@@ -26,7 +26,8 @@
     "dotnet/*",
     "dotnet/.github/**/*",
     "mjs/**/*",
-    "src/**/*"
+    "src/**/*",
+    "tsconfig*.json"
   ],
   "main": "./mjs/index.mjs",
   "infra": "polyrepo",
@@ -49,48 +50,49 @@
     "prepare": "husky",
     "presemantic-release": "npm pack",
     "semantic-release": "semantic-release",
-    "test": "npm run build && npm run test:noBuild",
+    "pretest": "npm run build && npm run test:cacheSampleProjects",
+    "test": "tsx --test --experimental-test-coverage --enable-source-maps --test-reporter=spec --test-reporter-destination=stdout --test-reporter=lcov --test-reporter-destination=lcov.txt --test-reporter=junit --test-reporter-destination=junit.xml",
     "test:cacheSampleProjects": "echo \"START: Cache Sample Projects\" && tsx ./tests/dotnet/MSBuildProject.projects.ts && echo \"DONE: Cache Sample Projects\"",
-    "pretest:noBuild": "npm run test:cacheSampleProjects",
-    "test:noBuild": "npm run test:justTest",
-    "test:justTest": "tsx --test --experimental-test-coverage --enable-source-maps --test-reporter=spec --test-reporter-destination=stdout --test-reporter=lcov --test-reporter-destination=lcov.txt --test-reporter=junit --test-reporter-destination=junit.xml",
-    "test:watch": "npm run test:justTest -- -- --watch",
+    "test:watch": "npm run test -- --watch",
     "type": "tsc --build",
     "validate": "packemon validate",
     "watch": "packemon watch --loadConfigs"
   },
   "dependencies": {
-    "@commitlint/cli": "^19.8.1",
-    "@commitlint/config-conventional": "^19.8.1",
+    "@commitlint/cli": "^20.0.0",
+    "@commitlint/config-conventional": "^20.0.0",
     "@dotenvx/dotenvx": "^1.47.6",
     "@eslint/js": "^9.31.0",
+    "@eslint/json": "^0.13.2",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/commit-analyzer": "^13.0.1",
     "@semantic-release/exec": "^7.1.0",
     "@semantic-release/git": "^10.0.1",
-    "@semantic-release/github": "^11.0.3",
-    "@semantic-release/npm": "^12.0.2",
+    "@semantic-release/github": "^12.0.0",
+    "@semantic-release/npm": "^13.0.0",
     "@semantic-release/release-notes-generator": "^14.0.3",
     "@stylistic/eslint-plugin": "^5.1.0",
-    "@types/node": "~20.11.0",
+    "@types/node": "~24.9.1",
     "arktype": "^2.1.20",
     "chardet": "^2.1.0",
     "conventional-changelog-conventionalcommits": "^9.1.0",
     "debug": "^4.4.1",
-    "eslint-plugin-jsonc": "^2.20.1",
+    "error.iserror": "^1.0.2",
+    "es-main": "^1.3.0",
     "globals": "^16.3.0",
     "husky": "^9.1.7",
     "sanitize-filename": "^1.6.3",
-    "semantic-release": "^24.2.7",
+    "semantic-release": "^25.0.0",
     "semantic-release-export-data": "^1.1.0",
     "ts-essentials": "^10.1.1",
     "typescript-eslint": "^8.37.0"
   },
   "devDependencies": {
+    "@amanda-mitchell/semantic-release-npm-multiple": "^3.16.0",
     "@babel/cli": "^7.28.0",
     "@babel/core": "^7.28.0",
     "@babel/eslint-parser": "^7.28.0",
-    "@commitlint/types": "^19.8.1",
+    "@commitlint/types": "^20.0.0",
     "@eslint/config-inspector": "^1.1.0",
     "@eslint/markdown": "^7.0.0",
     "@sebbo2002/semantic-release-jsr": "^3.0.0",
@@ -100,16 +102,17 @@
     "@types/tmp": "^0.2.6",
     "conventional-changelog-preset-loader": "^5.0.0",
     "eslint": "^9.31.0",
-    "eslint-plugin-jsdoc": "^51.4.0",
-    "eslint-plugin-unicorn": "^60.0.0",
+    "eslint-plugin-jsdoc": "^61.0.0",
+    "eslint-plugin-unicorn": "^62.0.0",
     "packemon": "^4.1.2",
     "tmp": "^0.2.3",
     "tslib": "^2.8.1",
     "tsx": "^4.20.3",
     "typescript": "^5.8.3"
   },
+  "//engines.node": "See file://./.nvmrc, https://github.com/nvm-sh/nvm#nvmrc. Supporting the lowest version possible is a PITA. Just support LTS. ",
   "engines": {
-    "node": "^20.11.0 || >=21.2.0",
+    "node": ">=24.10.0",
     "npm": ">=10.5.0"
   },
   "engineStrict": true,
@@ -137,5 +140,5 @@
       "setupGitPluginSpec": "src/setupGitPluginSpec.ts"
     }
   },
-  "packageManager": "pnpm@10.13.1+sha512.37ebf1a5c7a30d5fabe0c5df44ee8da4c965ca0c5af3dbab28c3a1681b70a256218d05c81c9c0dcf767ef6b8551eb5b960042b9ed4300c59242336377e01cfad"
+  "packageManager": "npm@11.6.2+sha512.ee22b335fcbc95662cdf3ab8a053daf045d9cf9c6df6040d28965abb707512b2c16fa6c5eec049d34c74f78f390cebd14f697919eadb97756564d4f9eccc4954"
 }

package/src/debug.ts

@@ -1,9 +1,10 @@
-import debug from 'debug';
+// note: @types/debug is incorrect. There is no .log function!
+import createDebugger, { type Debugger } from 'debug';
 
-const _debug: ReturnType<typeof debug> = debug('@halospv3/hce.shared-config');
+const _debug = createDebugger('@halospv3/hce.shared-config') as Debugger & { log: never };
 
-if (process.argv.some(v => v.includes('--debug')) || debug.enabled('@halospv3/hce.shared-config')) {
-  debug.enable(_debug.namespace);
+if (process.argv.some(v => v.includes('--debug')) || createDebugger.enabled('@halospv3/hce.shared-config')) {
+  createDebugger.enable(_debug.namespace);
 }
 
 export default _debug;

package/src/dotnet/GitlabNugetRegistryInfo.ts

@@ -1,13 +1,12 @@
-import { isNativeError } from 'node:util/types';
 import { getEnvVarValue } from '../utils/env.js';
+import { isError } from '../utils/isError.js';
 import {
   NugetRegistryInfo,
   NRIOpts,
   NRIOptsBase,
 } from './NugetRegistryInfo.js';
-import type { Out } from 'arktype';
+import type { Out, Type } from 'arktype';
 import type { Default } from 'arktype/internal/attributes.ts';
-import type { ObjectType } from 'arktype/internal/methods/object.ts';
 import type { MSBuildProject, MSBuildEvaluationOutput } from './MSBuildProject.js';
 import type { NugetProjectProperties } from './NugetProjectProperties.js';
 
@@ -53,7 +52,7 @@ export class GitlabNugetRegistryInfo extends NugetRegistryInfo {
    */
   constructor(opts: typeof GLNRIOpts.inferIn) {
     const optsOut = GLNRIOpts.from(opts);
-    if (isNativeError(optsOut.source))
+    if (isError(optsOut.source))
       throw optsOut.source;
     super(optsOut as typeof optsOut & { source: string });
   }
@@ -88,7 +87,7 @@ const GLNRI = GitlabNugetRegistryInfo;
 /**
  * The Arktype definition for {@link GitlabNugetRegistryInfo}'s constructor parameter. Construct an object of this type by calling {@link GLNRIOpts.from}
  */
-export const GLNRIOpts: ObjectType<{
+export const GLNRIOpts: Type<{
   project: MSBuildProject | {
     readonly Items: Readonly<Required<MSBuildEvaluationOutput>['Items']>;
     readonly Properties: Readonly<NugetProjectProperties>;

package/src/dotnet/IsNextVersionAlreadyPublished.cli.ts

@@ -1,44 +1,61 @@
 import { NugetRegistryInfo, getGithubOutput } from './NugetRegistryInfo.js';
+import esMain from 'es-main';
 
-const args = process.argv.slice(2);
-
-// Parse command-line arguments - https://stackoverflow.com/a/76298476/14894786
-const options: {
-  packageId?: string;
-  source?: string;
-} & Record<string, string> = {};
-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;
+/**
+ * @returns if successful
+ * @throws {Error} if...
+ * - {@link process.argv} does not include...
+ *   - `--packageId [string]`
+ *   - `--source [string]`
+ * - Value of `await getGithubOutput())['new-release-version']`...
+ *   - is not a valid Version
+ *   - already exists at `source`
+ */
+async function main(): Promise<0> {
+  const args = process.argv.slice(2);
+  // Parse command-line arguments - https://stackoverflow.com/a/76298476/14894786
+  const options: {
+    packageId: string | undefined;
+    source: string | undefined;
+  } & Record<string, string | undefined> = { packageId: undefined, source: undefined };
+  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)] = 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');
+  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 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,
   );
 
-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.`);
+
+  return 0;
+}
 
-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.`);
+if (esMain(import.meta))
+  await main();

package/src/dotnet/MSBuildProject.ts

@@ -1,18 +1,17 @@
-import { type, type Scope } from 'arktype';
+import { type, type Scope, type Type } from 'arktype';
 import { warn } from 'node:console';
 import { type Dirent } from 'node:fs';
 import { readdir, realpath, stat } from 'node:fs/promises';
 import path from 'node:path';
 import { setTimeout } from 'node:timers/promises';
-import { isNativeError } from 'node:util/types';
 import { CaseInsensitiveMap } from '../CaseInsensitiveMap.js';
 import { execAsync } from '../utils/execAsync.js';
+import { isError } from '../utils/isError.js';
 import { MSBuildProjectProperties } from './MSBuildProjectProperties.js';
 import {
   NPPGetterNames,
   NugetProjectProperties,
 } from './NugetProjectProperties.js';
-import type { ObjectType } from 'arktype/internal/methods/object.ts';
 
 /**
  * See [MSBuild well-known item metadata](https://learn.microsoft.com/en-us/visualstudio/msbuild/msbuild-well-known-item-metadata).
@@ -73,7 +72,7 @@ const targetFailure = type({
   Items: 'never[]',
 });
 
-const msbuildEvaluationOutput: ObjectType<{
+const msbuildEvaluationOutput: Type<{
   Properties?: Record<string, string> | undefined;
   Items?: Record<string, {
     [x: string]: string | undefined;
@@ -170,7 +169,7 @@ export class MSBuildEvaluationOutput {
   TargetResults?: typeof msbuildEvaluationOutput.infer.TargetResults;
 }
 
-export const EvaluationOptions: ObjectType<{
+export const EvaluationOptions: Type<{
   FullName: string;
   Property: {
     MSBuildProjectFullPath?: string | undefined;
@@ -331,7 +330,7 @@ export class MSBuildProject {
    * target is specified. If you choose Pack, you must do ['Restore', 'Pack'].
    * @param options The result of {@link EvaluationOptions.from}.
    * @returns A promised {@link MSBuildProject} instance.
-   * @throws if the exec command fails -OR- the JSON parse fails -OR-
+   * @throws {Error} if the exec command fails -OR- the JSON parse fails -OR-
    * MSBuildProject's constructor fails.
    * @see {@link PackableProjectsToMSBuildProjects} for most use-cases.
    */
@@ -483,7 +482,7 @@ export class MSBuildProject {
             const dirent: Dirent | undefined = entries.find(v =>
               path.join(
                 // condition required for compatibility. `.path` was deprecated, but `.parentPath` is not available in our node minversion
-                v.path as string | undefined ?? (v as unknown as Omit<typeof v, 'path'> & { parentPath: string }).parentPath,
+                ('path' in v ? v.path as string | undefined : undefined) ?? (v as unknown as Omit<typeof v, 'path'> & { parentPath: string }).parentPath,
                 v.name,
               ) === proj,
             );
@@ -516,7 +515,7 @@ export class MSBuildProject {
     async function convertDirentToMSBuildProject(dirent: Dirent): Promise<MSBuildProject> {
       const fullPath = path.join(
         // condition required for compatibility. `.path` was deprecated, but `.parentPath` is not available in our node minversion
-        dirent.path as string | undefined ?? (dirent as unknown as Omit<typeof dirent, 'path'> & { parentPath: string }).parentPath,
+        ('path' in dirent ? dirent.path as string | undefined : undefined) ?? (dirent as unknown as Omit<typeof dirent, 'path'> & { parentPath: string }).parentPath,
         dirent.name,
       );
       const projTargets: Promise<string[]> = MSBuildProject.GetTargets(fullPath);
@@ -674,7 +673,7 @@ function makeAbsolute(_path: string) {
  * @returns `undefined` if CSC2012 (file in use by another process) occurs
  */
 export function catchCsc2012(error: unknown): undefined {
-  if (isNativeError(error)) {
+  if (isError(error)) {
     // check for error reported when "file in use by another process" i.e. EBUSY
     // (UNIX), NTSTATUS.ERROR_SHARING_VIOLATION == 0x20 == 32 (Windows)
     if ('stderr' in error && typeof error.stderr === 'string'

package/src/dotnet/NugetProjectProperties.ts

@@ -14,10 +14,9 @@ import {
   type WithProto,
 } from '../utils/reflection.js';
 import { MSBuildProjectProperties, type Class_MSBPP } from './MSBuildProjectProperties.js';
-import type { StringType } from 'arktype/internal/methods/string.ts';
 
-const Type_RepositoryType: StringType<'' | 'git' | 'tfs'> = type('""|"git"|"tfs"');
-const Type_SymbolPackageFormat: StringType<'symbols.nupkg' | 'snupkg'> = type('"symbols.nupkg" | "snupkg"');
+const Type_RepositoryType: type<'' | 'git' | 'tfs'> = type('""|"git"|"tfs"');
+const Type_SymbolPackageFormat: type<'symbols.nupkg' | 'snupkg'> = type('"symbols.nupkg" | "snupkg"');
 
 /**
  * A readonly record of a .csproj or .fsproj with NuGet configuration properties in

package/src/dotnet/NugetRegistryInfo.ts

@@ -5,7 +5,7 @@ import type { NugetProjectProperties } from './NugetProjectProperties.js';
 /* eslint-enable @typescript-eslint/no-unused-vars */
 
 import { config as configDotenv } from '@dotenvx/dotenvx';
-import { type } from 'arktype';
+import { type, type Type } from 'arktype';
 import { detectFile, detectFileSync } from 'chardet';
 import { ok } from 'node:assert/strict';
 import type { ExecException } from 'node:child_process';
@@ -15,12 +15,11 @@ import { tmpdir } from 'node:os';
 import node_path from 'node:path';
 import { cwd, env } from 'node:process';
 import { setTimeout } from 'node:timers/promises';
-import { isNativeError } from 'node:util/types';
+import { isError } from '../utils/isError.js';
 import sanitizeFileName from 'sanitize-filename';
 import { getEnvVarValue } from '../utils/env.js';
 import { execAsync } from '../utils/execAsync.js';
 import { catchCsc2012, MSBuildEvaluationOutput, MSBuildProject } from './MSBuildProject.js';
-import type { ObjectType } from 'arktype/internal/methods/object.ts';
 import type { Default } from 'arktype/internal/attributes.ts';
 
 type TmpDirNamespace_Unix = `${ReturnType<typeof tmpdir>}/HCE.Shared/.NET/Dummies`;
@@ -49,7 +48,7 @@ export async function getGithubOutput(): Promise<ReturnType<typeof configDotenv>
     processEnv: {},
   });
 
-  if (isNativeError(envOutput.error))
+  if (isError(envOutput.error))
     throw envOutput.error;
   return envOutput.parsed;
 }
@@ -294,7 +293,7 @@ but the environment variable is empty or undefined.`);
    * {@link NRI.PackPackagesOptionsType.t.propertyOverrides `propertyOverrides`}
    * is a wrapper for MSBuild's `-property:<n>=<v>` properties override arg.
    */
-  static readonly PackPackagesOptionsType: ObjectType<{
+  static readonly PackPackagesOptionsType: Type<{
     propertyOverrides?: Record<string, string> | undefined;
     artifactsPath?: string | undefined;
     configuration?: 'Release' | 'Debug' | undefined;
@@ -345,7 +344,7 @@ but the environment variable is empty or undefined.`);
     }),
   );
 
-  public static readonly PackDummyPackagesOptionsType: ObjectType<{
+  public static readonly PackDummyPackagesOptionsType: Type<{
     propertyOverrides?: Record<string, string> | undefined;
     artifactsPath?: string | undefined;
     configuration?: 'Release' | 'Debug' | undefined;
@@ -559,7 +558,7 @@ but the environment variable is empty or undefined.`);
    * Specific to this API:
    * If you want to use this API's default root value (\`${cwd()}/publish`), assign an empty string.
    */
-  static readonly PushPackagesOptionsType: ObjectType<{
+  static readonly PushPackagesOptionsType: Type<{
     root: string;
     apiKey?: string | undefined;
     configFile?: string | undefined;
@@ -612,7 +611,7 @@ but the environment variable is empty or undefined.`);
    * {@link NRI.PushPackagesOptionsType} sans {@link NRI.PushPackagesOptionsType.t.root}.
    * The result of {@link getDummiesDir} is used, instead.
    */
-  public static readonly PushDummyPackagesOptionsType: ObjectType<{
+  public static readonly PushDummyPackagesOptionsType: Type<{
     apiKey?: string | undefined;
     configFile?: string | undefined;
     disableBuffering?: boolean | undefined;
@@ -730,7 +729,7 @@ but the environment variable is empty or undefined.`);
       ),
       true,
     ).catch((error: unknown) => {
-      const _error: Error = isNativeError(error) ? error : new Error(JSON.stringify(error));
+      const _error: Error = isError(error) ? error : new Error(JSON.stringify(error));
       throw opts.apiKey
         ? _censorTokenInError(_error, opts.apiKey)
         : _error;
@@ -792,7 +791,7 @@ but the environment variable is empty or undefined.`);
     const pushCmd: string = this.GetPushDummyCommand(opts);
     return await execAsync(pushCmd, true)
       .catch((error: unknown) => {
-        const _error: Error = isNativeError(error) ? error : new Error(String(error));
+        const _error: Error = isError(error) ? error : new Error(String(error));
         throw opts.apiKey
           ? _censorTokenInError(_error, opts.apiKey)
           : _error;
@@ -906,7 +905,7 @@ const NRI: typeof NugetRegistryInfo = NugetRegistryInfo;
  * The base type for {@link NRIOpts} and related types. Extend this type while
  * overriding member types via {@link NRIOptsBase.merge}
  */
-export const NRIOptsBase: ObjectType<{
+export const NRIOptsBase: Type<{
   project: MSBuildProject | {
     readonly Items: Readonly<Required<MSBuildEvaluationOutput>['Items']>;
     readonly Properties: Readonly<NugetProjectProperties>;
@@ -960,7 +959,7 @@ export const NRIOptsBase: ObjectType<{
 /**
  * The type of the parameter for {@link NugetRegistryInfo}'s constructor.
  */
-export const NRIOpts: ObjectType<{
+export const NRIOpts: Type<{
   project: MSBuildProject | {
     readonly Items: Readonly<Required<MSBuildEvaluationOutput>['Items']>;
     readonly Properties: Readonly<NugetProjectProperties>;

package/src/dotnet/helpers.ts

@@ -1,11 +1,10 @@
-import { type } from 'arktype';
+import { type, type Type } from 'arktype';
 import path from 'node:path';
 import { cwd } from 'node:process';
 import { MSBuildProject } from './MSBuildProject.js';
 import { MSBuildProjectProperties as MSBPP } from './MSBuildProjectProperties.js';
 import { NugetRegistryInfo } from './NugetRegistryInfo.js';
 import type { Default } from 'arktype/internal/attributes.ts';
-import type { ObjectType } from 'arktype/internal/methods/object.ts';
 
 const ourDefaultPubDir = path.join('.', 'publish') as `.${'/' | '\\'}publish`;
 
@@ -67,7 +66,7 @@ export async function configurePrepareCmd(
    * paths.
    * @returns A Promise of a string. This string contains one or more `dotnet publish`
    * commands conjoined by " && ". It may also include one or more
-   * `dotnet msbuild ${...} -t:PublishAll` commands.
+   * `dotnet msbuild ${...} -t:PublishAll -p:Configuration=Release` commands.
    */
   async function formatDotnetPublish(
     projectsToPublish: string[] | MSBuildProject[],
@@ -138,7 +137,7 @@ export async function configurePrepareCmd(
      * runtime-framework combinations.
      * @returns If {@link proj} imports {@link ../../dotnet/PublishAll.targets}...
      * ```
-     * [`${proj.Properties.MSBuildProjectFullPath} -t:PublishAll`]
+     * [`${proj.Properties.MSBuildProjectFullPath} -t:PublishAll -p:Configuration=Release`]
      * ```
      * Else, an array of `dotnet publish` arguments permutations e.g.
      * ```
@@ -163,7 +162,7 @@ export async function configurePrepareCmd(
      * return publishCmdArray.join(' && ');
      */
     function getPublishArgsPermutations(proj: MSBuildProject):
-      ([`"${typeof proj.Properties.MSBuildProjectFullPath}" -t:PublishAll`])
+      ([`"${typeof proj.Properties.MSBuildProjectFullPath}" -t:PublishAll -p:Configuration=Release`])
       | ([`"${typeof proj.Properties.MSBuildProjectFullPath}"`])
       | (`"${typeof proj.Properties.MSBuildProjectFullPath}" --runtime ${string} --framework ${string}`)[]
       | (`"${typeof proj.Properties.MSBuildProjectFullPath}" --runtime ${string}`)[]
@@ -173,7 +172,7 @@ export async function configurePrepareCmd(
        * permutation, return the appropriate command line.
        */
       if (proj.Targets.includes('PublishAll'))
-        return [`"${proj.Properties.MSBuildProjectFullPath}" -t:PublishAll`];
+        return [`"${proj.Properties.MSBuildProjectFullPath}" -t:PublishAll -p:Configuration=Release`];
 
       // #region formatFrameworksAndRuntimes
       const tfmRidPermutations: `--runtime ${string} --framework ${string}`[]
@@ -220,7 +219,7 @@ export async function configurePrepareCmd(
       // #endregion formatFrameworksAndRuntimes
     }
 
-    const publishCmds: (`dotnet publish "${string}"` | `dotnet publish "${string}" ${string}` | `dotnet msbuild "${string}" -t:PublishAll`)[] = [];
+    const publishCmds: (`dotnet publish "${string}"` | `dotnet publish "${string}" ${string}` | `dotnet msbuild "${string}" -t:PublishAll -p:Configuration=Release`)[] = [];
     /** convert {@link evaluatedPublishProjects} to sets of space-separated CLI args. */
     const argsSets = evaluatedPublishProjects.map(
       proj => getPublishArgsPermutations(proj),
@@ -231,7 +230,10 @@ export async function configurePrepareCmd(
       for (const permutation of args) {
         if (typeof permutation === 'string' && permutation.length === 1)
           throw new Error('Something has gone terribly wrong. A `dotnet publish` argument set was split to single characters!');
-        publishCmds.push(`dotnet publish ${permutation}`);
+        if (/".+" -t:PublishAll -p:Configuration=Release/.test(permutation))
+          publishCmds.push(`dotnet msbuild ${permutation as `"${string}" -t:PublishAll -p:Configuration=Release`}`);
+        else
+          publishCmds.push(`dotnet publish ${permutation}`);
       }
     }
 
@@ -366,7 +368,7 @@ function formatDotnetNugetSign(
   }
 }
 
-const DotnetNugetSignOptions: ObjectType<
+const DotnetNugetSignOptions: Type<
   {
     timestamper: Default<string, 'https://rfc3161.ai.moda/'>;
     certificatePassword?: string | undefined;

package/src/dotnet/index.ts

@@ -1,12 +1,3 @@
-export type * from './GithubNugetRegistryInfo.js';
-export type * from './GitlabNugetRegistryInfo.js';
-export type * from './helpers.js';
-export type * from './IsNextVersionAlreadyPublished.cli.js';
-export type * from './MSBuildProject.js';
-export type * from './MSBuildProjectProperties.js';
-export type * from './NugetProjectProperties.js';
-export type * from './NugetRegistryInfo.js';
-
 export * from './GithubNugetRegistryInfo.js';
 export * from './GitlabNugetRegistryInfo.js';
 export * from './helpers.js';

package/src/dotnet.ts

@@ -1,2 +1 @@
-export type * from './dotnet/index.js';
 export * from './dotnet/index.js';