@halospv3/hce.shared-config/src/dotnet/GithubNugetRegistryInfo.ts

Automate commit message quality, changelogs, and CI/CD releases. Its `main` entry point is a Semantic Release config. Functions and classes are exposed for customization. An ESLint config, a Commitlint config, and addl. resources for .NET projects are als

import type { Type } from 'arktype';
import { getEnvVarValue as getEnvironmentVariableValue } from '../utils/env.ts';
import type { MSBuildProject, MSBuildEvaluationOutput } from './MSBuildProject.ts';
import type { NugetProjectProperties } from './NugetProjectProperties.ts';
import {
  NugetRegistryInfo,
  NRIOptsBase as NRIOptionsBase,
} from './NugetRegistryInfo.ts';
import type { Default } from 'arktype/internal/attributes.ts';

const NUGET_PKG_GITHUB_COM = 'https://nuget.pkg.github.com';
// eslint-disable-next-line unicorn/name-replacements
export const DefaultGithubTokenEnvVars: readonly ['GH_TOKEN', 'GITHUB_TOKEN'] = Object.freeze([
  'GH_TOKEN',
  'GITHUB_TOKEN',
]);

export class GithubNugetRegistryInfo extends NugetRegistryInfo {
  static readonly NUGET_PKG_GITHUB_COM = 'https://nuget.pkg.github.com';

  /**
   * Returns `https://nuget.pkg.github.com/${GITHUB_REPOSITORY_OWNER}/index.json`
   * or (if GITHUB_REPOSITORY_OWNER is not defined in {@link process.env} nor
   * {@link process.cwd() $CWD}/.env) `undefined`.
   * @returns If GITHUB_REPOSITORY_OWNER is defined, returns the GitHub Package Repository URL endpoint for NuGet pushes (--source).\
   * Otherwise, returns `undefined`
   */
  static getNugetGitHubUrl(): string | undefined {
    const owner = getEnvironmentVariableValue('GITHUB_REPOSITORY_OWNER');
    return owner === undefined
      ? undefined
      : `${NUGET_PKG_GITHUB_COM}/${owner}/index.json`;
  }

  // GithubNugetRegistryInfo.CtorArgs(...) behaves differently than NugetRegistryInfo.CtorArgs(...)
  /**
   * Creates an instance of GithubNugetRegistryInfo.
   * @param opts The input type of {@link GHNRIOpts.from}
   */
  // eslint-disable-next-line unicorn/name-replacements
  constructor(opts: typeof GHNRIOpts.inferIn) {
    super(GHNRIOpts.from(opts));
  }
}
const GHNRI = GithubNugetRegistryInfo;

/**
 * The default value of {@link GHNRIOpts.t.source `source`} is dependent on
 * {@link GHNRI.getNugetGitHubUrl} and will default to an empty string if the
 * environment variable `GITHUB_REPOSITORY_OWNER` is undefined!
 */
// eslint-disable-next-line unicorn/name-replacements
export const GHNRIOpts: Type<{
  project: MSBuildProject | {
    readonly Items: Readonly<Required<MSBuildEvaluationOutput>['Items']>;
    readonly Properties: Readonly<NugetProjectProperties>;
    readonly Targets: readonly string[];
    readonly TargetResults: Required<MSBuildEvaluationOutput>['TargetResults'][];
  };
  source: Default<string, string>;
  tokenEnvVars: Default<readonly string[], readonly ['GH_TOKEN', 'GITHUB_TOKEN']>;
}> = NRIOptionsBase.merge({
  /** @see {@link GHNRI.getNugetGitHubUrl } */
  source: NRIOptionsBase.get('source')
    .default(() => GHNRI.getNugetGitHubUrl() ?? ''),
  tokenEnvVars: NRIOptionsBase.get('tokenEnvVars')
    .default(
      /* must be a function. A fixed-length array is NOT a primitive type! */
      (): typeof DefaultGithubTokenEnvVars => DefaultGithubTokenEnvVars,
    ),
});