@halospv3/hce.shared-config 2.6.4 → 3.0.0-develop.2

package/src/dotnet/dotnetGHPR.ts

@@ -1,232 +0,0 @@
-import { ok } from 'node:assert/strict';
-import { spawnSync, type ExecException, type SpawnSyncReturns } from 'node:child_process';
-import { getEnvVarValue } from '../envUtils.js';
-import { createDummyNupkg } from './createDummyNupkg.js';
-import type { NuGetRegistryInfo } from './dotnetHelpers.js';
-import { isNativeError } from 'node:util/types';
-
-/**
- * @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 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();
-	}
-
-	if (url === undefined || url === '') 
-		throw new Error('The NuGet source is undefined or empty!')
-
-	if (info.fallback)
-		tokenEnvVar = info.fallback;
-
-	const tokenValue = getEnvVarValue(tokenEnvVar);
-	if (tokenValue === undefined)
-		throw new TypeError(`The environment variable ${tokenEnvVar} is undefined!`)
-
-	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();
-
-	try {
-		let pushResult: SpawnSyncReturns<string> | undefined = undefined;
-		try {
-			pushResult = spawnSync(
-				'dotnet',
-				[
-					'nuget',
-					'push',
-					dummyNupkgPath,
-					'--source',
-					url,
-					'--api-key',
-					tokenValue,
-					'--skip-duplicate',
-					'--force-english-output'
-				],
-				{
-					stdio: 'pipe',
-					encoding: 'utf8',
-					shell: process.platform === 'win32' && spawnSync('dotnet.exe', { windowsHide: true }).status === null
-						? 'cmd.exe'
-						: undefined,
-					windowsHide: true,
-				},
-			);
-		}
-		catch (_error) {
-				// censor token
-				const error = !isNativeError(_error)
-					? new Error(`dotnet nuget push failed. \n${String(_error)}`)
-					: _error;
-
-				const tokenPattern = new RegExp(tokenValue, 'g');
-
-				error.message = error.message.replace(tokenPattern,'***');
-
-				if (error.stack)
-						error.stack = error.stack.replace(tokenPattern, '***');
-				if ('cmd' in error && typeof error.cmd === 'string')
-						error.cmd = error.cmd.replace(tokenPattern, '***');
-				if ('stdout' in error && typeof error.stdout === 'string')
-						error.stdout = error.stdout.replace(tokenPattern, '***');
-				if ('stderr' in error&& typeof error.stderr === 'string') {
-					error.stderr = error.stderr.replace(tokenPattern, '***');
-				}
-			if ('spawnargs' in error && Array.isArray(error.spawnargs)) {
-				error.spawnargs = error.spawnargs.map(arg => {
-			return typeof arg === 'string'
-				? arg.replace(tokenPattern, '***')
-				: arg;
-				})
-			}
-
-			throw error;
-		}
-
-		const errNewline = pushResult.stdout.includes('\r\n') ? '\r\n' : pushResult.stdout.includes('\r') ? '\r' : '\n';
-
-		// if any *lines* start with "error: " or "Error: ", log stderr
-		const errorCount = pushResult.stdout.split(errNewline).filter(line => line.trim().startsWith('error: ') || line.trim().startsWith('Error: ')).length;
-		if (errorCount > 0)
-			console.error(pushResult.stdout);
-
-		// if any lines start with "warn : ", log stdout
-		const warningCount = pushResult.stdout.split(errNewline).filter(line => line.trim().startsWith('warn : ')).length;
-		if (warningCount > 0)
-			console.warn(pushResult.stdout);
-
-		const hasAuthError = pushResult.stdout.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;
-	}
-}
-
-/** returns the value of GITHUB_REPOSITORY_OWNER */
-function getOwner(): string | undefined {
-	return getEnvVarValue('GITHUB_REPOSITORY_OWNER')
-}
-
-export const nugetGitHubUrlBase = 'https://nuget.pkg.github.com';
-
-/** @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 | '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 function getGithubNugetRegistryPair(
-	tokenEnvVar: string | 'GITHUB_TOKEN' | 'GH_TOKEN' = 'GITHUB_TOKEN',
-	url: string | undefined = getNugetGitHubUrl(),
-): NuGetRegistryInfo | undefined {
-	const errors: Error[] = [];
-	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 (_isTokenDefinedInfo.isDefined) {
-		if (_isTokenDefinedInfo.fallback)
-			tokenEnvVar = _isTokenDefinedInfo.fallback;
-		try {
-			canTokenWritePackages = 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 (_isTokenDefinedInfo.isDefined && url !== undefined && canTokenWritePackages)
-		return { tokenEnvVar, url };
-
-	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 aggErr;
-}

package/src/dotnet/dotnetGLPR.ts

@@ -1,46 +0,0 @@
-import { getEnv, getEnvVarValue } from '../envUtils.js';
-import type { NuGetRegistryInfo } from './dotnetHelpers.js';
-
-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',
-};
-
-export const GitLabTokenEnvVar = 'CI_JOB_TOKEN';
-export const nugetGitLabUrlBase = CI_API_V4_URL;
-export const nugetGitLabUrl: string | undefined =
-	CI_API_V4_URL && CI_PROJECT_ID
-		? `${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/packages/nuget/index.json`
-		: undefined;
-
-/**
- * Get a {@link NuGetRegistryInfo} for pushing to your GitLab Packages NuGet registry.
- * @export
- * @param {string} [tokenEnvVar=GitLabTokenEnvVar] The name of environment variable storing the GitLab Packages NuGet registry API key. Defaults to {@link GitLabTokenEnvVar}.
- * @param {string} [url=nugetGitLabUrl] The url of the GitLab Packages NuGet registry. Defaults to {@link nugetGitLabUrl}.
- * @returns {(NuGetRegistryInfo | undefined)} a {@link NuGetRegistryInfo} object if {@link tokenEnvVar} and {@link url} are defined. Else, undefined.
- */
-export function getGitlabNugetRegistryPair(
-	tokenEnvVar: string = GitLabTokenEnvVar,
-	url: string | undefined = nugetGitLabUrl,
-): NuGetRegistryInfo | undefined {
-	// yes, this is stupid. No, I won't change it.
-	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.`,
-			),
-		);
-		return undefined;
-	}
-	if (url) {
-		return { tokenEnvVar, url };
-	}
-	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;
-}

package/src/dotnet/dotnetHelpers.ts

@@ -1,184 +0,0 @@
-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';
-
-function formatDotnetPublish(projectsToPublish: string[], publishProperties: string[]): string {
-	/* Fun Fact: You can define a property and get the evaluated value in the same command!
-	```pwsh
-	dotnet msbuild .\src\HXE.csproj -property:RuntimeIdentifiers="""place;holder""" -getProperty:RuntimeIdentifiers
-	place;holder
-	```
-	 enclosing with """ is required in pwsh to prevent the semicolon from breaking the string.
-	*/
-	if (!(Array.isArray(projectsToPublish) && projectsToPublish.length > 0))
-		throw new Error(`Type of projectsToPublish (${typeof projectsToPublish}) is not allowed. Expected a string[] where length > 0.`);
-
-	// each may have TargetFramework OR TargetFrameworks (plural)
-	const evaluatedProjects: MSBuildProject[] = projectsToPublish.map(
-		(proj) => new MSBuildProject(proj, publishProperties),
-	);
-	// args appended to "dotnet publish", joined by space
-
-	return evaluatedProjects.flatMap(proj => {
-		const args: string[] = [proj.Properties.FullPath];
-
-		function appendCustomProperties(publishProperties: string[]) {
-			// convert to dictionary and filter for user-defined properties.
-			const dictionary = Object.entries(proj.Properties).filter(
-				(p) => !publishProperties.includes(p[0]),
-			);
-			if (dictionary.length > 0) {
-				/* format remaining properties as "-p:Property=Value" and append to args */
-				args.push(
-					...dictionary.map((keyValuePair) => `-p:${keyValuePair[0]}=${keyValuePair[1]}`),
-				);
-			}
-		}
-		appendCustomProperties(publishProperties);
-
-		const cmdPermutations: string[][] = []; // forEach, run dotnet [...args,...v]
-
-		function formatFrameworksAndRuntimes() {
-			const RIDs: string[] =
-				proj.Properties.RuntimeIdentifiers.length > 0
-					? proj.Properties.RuntimeIdentifiers.split(';')
-					: [];
-			const TFMs: string[] =
-				proj.Properties.TargetFrameworks.length > 0
-					? proj.Properties.TargetFrameworks.split(';')
-					: [];
-			if (RIDs.length > 0) {
-				if (TFMs.length > 0) {
-					for (const RID of RIDs) {
-						for (const TFM of TFMs) {
-							cmdPermutations.push(['--runtime', RID, '--framework', TFM]);
-						}
-					}
-				} else {
-					// assume singular TFM. No need to specify it.
-					for (const RID of RIDs) {
-						cmdPermutations.push(['--runtime', RID]);
-					}
-				}
-			} else if (TFMs.length > 0) {
-				for (const TFM of TFMs) {
-					cmdPermutations.push(['--framework', TFM]);
-				}
-			}
-		}
-		formatFrameworksAndRuntimes();
-
-		return cmdPermutations.length > 0
-			? cmdPermutations.map((permArgs) => [...args, ...permArgs]) // string[][]
-			: [args]; // string[][]
-	}).map((args) => `dotnet publish ${args.join(' ')}`).join(' && ');
-}
-
-function formatDotnetPack(projectsToPackAndPush: string[] | false): string {
-	return projectsToPackAndPush === false
-		? ""
-		: projectsToPackAndPush
-			.map(v => `dotnet pack ${v}`)
-			.join(' && ');
-}
-
-function formatDotnetNugetSign(dotnetNugetSignArgs: string[]): string {
-	switch (dotnetNugetSignArgs.length) {
-		case 0:
-			return '';
-		default:
-			return `dotnet nuget sign ${dotnetNugetSignArgs.join(' ')}`;
-		// default: {
-		//     throw new Error("")
-		//     // this needs a rework.
-		//     const packagePaths: string[] = [];
-		//     dotnetNugetSignArgs.forEach((dotnetNugetSignArg, i) => {
-		//         // if current arg doesn't start with '-' and (current arg is first -OR- previous arg also does not start with '-')...
-		//         if (!dotnetNugetSignArg.startsWith("-") && (i === 0 || (i > 0 && !dotnetNugetSignArgs[i - 1].startsWith("-")))) {
-		//             // ...then it's probably a package path.
-		//             packagePaths.push(dotnetNugetSignArg);
-		//         }
-		//     });
-		//     if (packagePaths.length === 0)
-		//         return `dotnet nuget sign ${dotnetNugetSignArgs.join(" ")}`
-		//     else return
-		// }
-	}
-}
-
-/**
- * Build a prepareCmd string from .NET project paths and `dotnet nuget sign` arguments.
- *
- * todo: parse Solution files to publish all projects with default Publish parameters (as evaluated by MSBuild). If multi-targeting frameworks and/or runtime, evaluate those properties for Publish permutation matrix.
- * todo: cleanup, docs
- * @export
- * @param {string[]} projectsToPublish
- * @param {string[]|false} projectsToPackAndPush Relative and/or full file paths of projects to pass to `dotnet pack`. By default, these will be output to `./publish/`.
- * @param {string[]} dotnetNugetSignArgs Arguments appended to `dotnet nuget sign`. You can also append '&&' if you want to start a new command or if you want to sign different sets of packages with different keys.
- */
-export function configurePrepareCmd(
-	projectsToPublish: string[],
-	projectsToPackAndPush: string[] | false,
-	dotnetNugetSignArgs: string[] = ['./publish'],
-) {
-	// These are later evaluated with MSBuild, but are passed via --framework and --runtime arguments instead of -p:TargetFramework
-	const publishProperties = MSBuildProjectPreDefinedProperties;
-
-	return [
-		formatDotnetPublish(projectsToPublish, publishProperties),
-		formatDotnetPack(projectsToPackAndPush),
-		formatDotnetNugetSign(dotnetNugetSignArgs)
-	].join(' && ');
-}
-
-export interface NuGetRegistryInfo {
-	tokenEnvVar: string;
-	url: string;
-	user?: string | undefined;
-}
-export const nugetDefault: NuGetRegistryInfo = {
-	tokenEnvVar: 'NUGET_TOKEN',
-	url: 'https://api.nuget.org/v3/index.json',
-};
-
-/**
- * todo -
- * @param nupkgDir
- * @param registries
- * @param pushToGitHub
- * @returns
- */
-export function configureDotnetNugetPush(
-	nupkgDir = './publish',
-	registries: NuGetRegistryInfo[] = [nugetDefault],
-	pushToGitHub = true,
-): string {
-	if (registries.some((registry) => registry.url.trim() === ''))
-		throw new Error('The URL for one of the provided NuGet registries was empty or whitespace.');
-
-	// if user did not specify a GitHub NuGet Registry, try determine default values and add the Source.
-	if (pushToGitHub && !registries.some((reg) => reg.url.startsWith(nugetGitHubUrlBase))) {
-		const ghPair: NuGetRegistryInfo | undefined = getGithubNugetRegistryPair();
-		if (ghPair) {
-			registries.push(ghPair);
-		}
-	}
-	if (!registries.some((reg) => reg.url.startsWith(nugetGitHubUrlBase))) {
-		const glPair = getGitlabNugetRegistryPair();
-		if (glPair) {
-			registries.push(glPair);
-		}
-	}
-
-	return registries
-		.map(
-			(registry) => {
-				const tokenValue = getEnvVarValue(registry.tokenEnvVar);
-				ok(getEnvVarValue('SKIP_TOKEN') === 'true' || tokenValue, `The environment variable ${registry.tokenEnvVar} is undefined!`);
-				return `dotnet nuget push ${nupkgDir} --source ${registry.url} --token ${tokenValue ?? '**placeholder**'}`
-			}
-		)
-		.join(' && ');
-}

package/src/dotnet.ts

@@ -1,6 +0,0 @@
-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"

package/src/envUtils.ts

@@ -1,36 +0,0 @@
-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/findStaticConfig.ts

@@ -1,31 +0,0 @@
-import { existsSync } from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-/// ../static/.releaserc.yml
-export function findStaticConfig(): string {
-	const glob = 'static/.releaserc.yml';
-	let dirPath = fileURLToPath(path.dirname(import.meta.url));
-	let combinedPath = path.join(dirPath, glob);
-
-	while (!existsSync(combinedPath)) {
-		/* file:// + dirname behavior on Windows. 'root' is empty when 'file://' is present.
-		 * file:///C:/Repos
-		 * file:///C:
-		 * file://
-		 * .
-		 */
-		// DEBUG.log(dirPath);
-		// DEBUG.log(combinedPath.href);
-		/** Throw if we reached root. */
-		if (path.dirname(dirPath) === '')
-			throw new Error(
-				`Failed to get full path for HCE.Shared's shared configuration. HCE.Shared recursively searched parent directories for '${glob}' starting from '${path.dirname(
-					import.meta.url,
-				)}'`,
-			);
-		dirPath = path.dirname(dirPath);
-		combinedPath = path.join(dirPath, glob);
-	}
-	return combinedPath;
-}

package/static/.releaserc.yml

@@ -1,35 +0,0 @@
-# footer contains links e.g. 3rd-party plugins, little-known features
-
-### global vars
-# https://semantic-release.gitbook.io/semantic-release/v/beta/usage/plugins#plugin-options-configuration
-preset: conventionalcommits
-
-### main options
-
-branches: # https://semantic-release.gitbook.io/semantic-release/v/beta/usage/configuration#branches
-  - main
-  - name: develop
-    channel: develop
-    prerelease: true
-plugins: # https://semantic-release.gitbook.io/semantic-release/v/beta/usage/configuration#plugins
-  - "@semantic-release/commit-analyzer"
-  - "semantic-release-export-data"
-  - "@semantic-release/release-notes-generator"
-  - "@semantic-release/changelog"
-  - - "@semantic-release/git"
-    - assets:
-        - README.md
-        - CHANGELOG.md
-  # Arbitrary shell commands - https://github.com/semantic-release/exec
-  # hint: set 'prepareCmd' to `dotnet publish`.
-  #   Because this is sorted after @semantic-release/git, the new Git tag will
-  #   be visible to dotnet (and GitVersion). Dotnet artifacts will be
-  #   versioned accordingly.
-  # Plugins' Steps: https://github.com/semantic-release/semantic-release/blob/master/docs/extending/plugins-list.md
-  - "@semantic-release/exec"
-  - - "@semantic-release/github"
-    - assets:
-        - path: ./publish/*
-## (OPTIONAL) update static Version strings before Git plugin
-# https://github.com/jpoehnelt/semantic-release-replace-plugin
-# https://github.com/droidsolutions/semantic-release-update-file