@dbx-tools/projen 0.9.28 → 0.9.30

package/index.ts

@@ -3,7 +3,7 @@
 // Hand edits are overwritten on the next watch; this file is read-only.
 
 export const PACKAGE_IDENTIFIER = "@dbx-tools/projen";
-export const PACKAGE_VERSION = "0.9.28";
+export const PACKAGE_VERSION = "0.9.30";
 export * as barrels from "./src/barrels.ts";
 export * as bunApp from "./src/bun-app.ts";
 export * as bunWorkflow from "./src/bun-workflow.ts";
@@ -28,7 +28,6 @@ export * as pythonNodeBundle from "./src/python-node-bundle.ts";
 export * as release from "./src/release.ts";
 export * as releaseCatalog from "./src/release-catalog.ts";
 export * as releaseContext from "./src/release-context.ts";
-export * as releaseGithub from "./src/release-github.ts";
 export * as scaffold from "./src/scaffold.ts";
 export * as tags from "./src/tags.ts";
 export * as tsconfig from "./src/tsconfig.ts";
@@ -64,7 +63,6 @@ export type { ReleaseStage, ReleaseDocsOptions, DBXToolsReleaseOptions } from ".
 export { DBXToolsReleaseCatalog } from "./src/release-catalog.ts";
 export type { ReleaseProjectLanguage, ReleaseArtifactKind, ReleaseEdgeKind, ReleasePropagation, ReleaseUnitRule, DBXToolsReleaseCatalogOptions, ReleaseDependencyInput, ReleaseProjectRegistration, ExternalReleaseProjectRegistration, ReleaseArtifactRegistration, ReleaseProjectNode, ReleaseArtifact, ReleaseDependencyEdge, ReleaseUnit, ReleaseUnitGraph } from "./src/release-catalog.ts";
 export { RELEASE_TAG, RELEASE_SHA, RELEASE_VERSION } from "./src/release-context.ts";
-export type { GithubRepositoryIdentity, GithubAuthenticatedAccount, GithubRepositoryPermissions } from "./src/release-github.ts";
 export { AGNOSTIC_COMPILER_OPTIONS, PACKAGE_TAG_MIXINS } from "./src/tags.ts";
 export type { PackageTag } from "./src/tags.ts";
 export { DBXToolsRootTsconfig } from "./src/tsconfig.ts";

package/package.json

@@ -34,9 +34,9 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.7.0",
-    "@dbx-tools/core": "^0.9.28",
-    "@dbx-tools/path": "^0.9.28",
-    "@dbx-tools/shared-core": "^0.9.28",
+    "@dbx-tools/core": "^0.9.30",
+    "@dbx-tools/path": "^0.9.30",
+    "@dbx-tools/shared-core": "^0.9.30",
     "commander": "^15.0.0",
     "concurrently": "^10.0.3",
     "constructs": "^10.6.0",
@@ -56,7 +56,7 @@
   },
   "main": "index.ts",
   "license": "Apache-2.0",
-  "version": "0.9.28",
+  "version": "0.9.30",
   "types": "index.ts",
   "type": "module",
   "exports": {

package/src/release.ts

@@ -133,7 +133,9 @@ function refreshDocsRegistryDependencies(workflow: GithubWorkflow): void {
   const registryJobs = Object.keys(workflow.jobs).filter(
     (name) => name === "publish-node" || name.startsWith("publish-pypi-"),
   );
-  if (registryJobs.length > 0) workflow.updateJob("build-docs", { ...docs, needs: registryJobs });
+  if (registryJobs.length > 0) {
+    workflow.updateJob("build-docs", { ...docs, needs: ["verify-context", ...registryJobs] });
+  }
 }
 
 /** Keep documentation publication behind every configured package registry. */

package/tasks/bump.ts

@@ -6,43 +6,34 @@
  */
 import * as projectUtils from "@dbx-tools/core/project-utils";
 import { log } from "@dbx-tools/shared-core";
-import { Command } from "commander";
+import { Command, Option } from "commander";
+import { runTaskCommand } from "../src/_task-command.ts";
 import {
-  releaseArchitectureOption,
-  releaseLevelOption,
-  releaseOperatingSystemOption,
-  releasePlatformFilter,
-  type ReleaseArch,
-  type ReleaseOs,
+  resolveNextVersion,
   type VersionLevel,
-} from "../src/_release-platform.ts";
-import { runTaskCommand } from "../src/_task-command.ts";
-import { resolveNextVersion, writeWorkspaceVersion } from "../src/workspace-version.ts";
+  writeWorkspaceVersion,
+} from "../src/workspace-version.ts";
 
 const logger = log.logger("projen:bump");
 
 const program = new Command();
 program
   .description("Increment VERSION and synchronize generated workspace versions")
-  .addOption(releaseLevelOption())
-  .addOption(releaseOperatingSystemOption())
-  .addOption(releaseArchitectureOption())
+  .addOption(
+    new Option("-l, --level <level>", "semver increment")
+      .choices(["patch", "minor", "major"])
+      .default("patch"),
+  )
   .option("--no-synth", "write VERSION without synchronizing generated files")
-  .action((opts: { level: VersionLevel; os: ReleaseOs[]; arch: ReleaseArch[]; synth: boolean }) => {
+  .action((opts: { level: VersionLevel; synth: boolean }) => {
     const root = projectUtils.root() ?? process.cwd();
     const next = resolveNextVersion(root, opts.level);
-    const releasePlatforms = releasePlatformFilter(opts.os, opts.arch);
 
     logger.info(`bump ${next.base} -> ${next.version} (${opts.level})`);
     writeWorkspaceVersion(root, next.version);
 
     if (opts.synth) {
-      runTaskCommand(root, process.execPath, [".projenrc.ts"], {
-        env: {
-          ...process.env,
-          ...(releasePlatforms ? { DBX_TOOLS_RELEASE_PLATFORMS: releasePlatforms } : {}),
-        },
-      });
+      runTaskCommand(root, process.execPath, [".projenrc.ts"]);
     }
     logger.success(`workspace version synchronized at ${next.version}`);
   });

package/src/_release-platform.ts

@@ -1,78 +0,0 @@
-import { Option } from "commander";
-import type { VersionLevel } from "./workspace-version.ts";
-
-/** Supported semantic version increments for release commands. */
-export const RELEASE_LEVELS = [
-  "patch",
-  "minor",
-  "major",
-] as const satisfies readonly VersionLevel[];
-
-/** Supported release operating systems. */
-export const RELEASE_OSES = ["darwin", "linux", "win32"] as const;
-
-/** Supported release CPU architectures. */
-export const RELEASE_ARCHES = ["arm64", "x64"] as const;
-
-/** Release operating system selector. */
-export type ReleaseOs = (typeof RELEASE_OSES)[number];
-
-/** Release CPU architecture selector. */
-export type ReleaseArch = (typeof RELEASE_ARCHES)[number];
-
-export type { VersionLevel } from "./workspace-version.ts";
-
-/** Stable archive name for one native release binary. */
-export function releaseBinaryAssetName(
-  binaryName: string,
-  nodeTarget: string,
-  operatingSystem: ReleaseOs,
-): string {
-  const extension = operatingSystem === "win32" ? "zip" : "tar.gz";
-  return `${binaryName}-${nodeTarget}.${extension}`;
-}
-
-function collectValue<T extends string>(value: T, previous: T[]): T[] {
-  return [...previous, value];
-}
-
-/** Commander option for selecting the semantic release increment. */
-export function releaseLevelOption(): Option {
-  return new Option("-l, --level <level>", "semver increment")
-    .choices([...RELEASE_LEVELS])
-    .default("patch");
-}
-
-/** Repeatable Commander option for release operating systems. */
-export function releaseOperatingSystemOption(): Option {
-  return new Option("--os <os>", "release operating system, repeatable; crossed with every --arch")
-    .choices([...RELEASE_OSES])
-    .argParser((value, previous: ReleaseOs[]) => collectValue(value as ReleaseOs, previous))
-    .default([] as ReleaseOs[]);
-}
-
-/** Repeatable Commander option for release CPU architectures. */
-export function releaseArchitectureOption(): Option {
-  return new Option(
-    "--arch <arch>",
-    "release CPU architecture, repeatable; crossed with every --os",
-  )
-    .choices([...RELEASE_ARCHES])
-    .argParser((value, previous: ReleaseArch[]) => collectValue(value as ReleaseArch, previous))
-    .default([] as ReleaseArch[]);
-}
-
-/** Cartesian-product release target filter shared by release commands. */
-export function releasePlatformFilter(
-  operatingSystems: readonly string[],
-  architectures: readonly string[],
-): string {
-  if ((operatingSystems.length === 0) !== (architectures.length === 0)) {
-    throw new Error("--os and --arch must be used together");
-  }
-  return operatingSystems
-    .flatMap((operatingSystem) =>
-      architectures.map((architecture) => `${operatingSystem}:${architecture}`),
-    )
-    .join(",");
-}

package/src/release-github.ts

@@ -1,109 +0,0 @@
-import { json, object } from "@dbx-tools/shared-core";
-
-/** GitHub repository identity used by release preparation. */
-export interface GithubRepositoryIdentity {
-  hostname: string;
-  owner: string;
-  repository: string;
-}
-
-/** Parse a GitHub repository URL without treating its owner as the authenticated actor. */
-export function githubRepositoryIdentity(repositoryUrl: string): GithubRepositoryIdentity {
-  const url = new URL(repositoryUrl);
-  const [owner, name] = url.pathname.split("/").filter(Boolean);
-  if (!owner || !name) {
-    throw new Error(`Cannot determine GitHub repository identity from ${repositoryUrl}`);
-  }
-  return {
-    hostname: url.hostname,
-    owner,
-    repository: name.replace(/\.git$/, ""),
-  };
-}
-
-/** One authenticated GitHub CLI account available on a repository host. */
-export interface GithubAuthenticatedAccount {
-  login: string;
-  active: boolean;
-  scopes: string[];
-}
-
-/** Repository capabilities returned for one authenticated actor. */
-export interface GithubRepositoryPermissions {
-  readonly push: boolean;
-  readonly maintain: boolean;
-  readonly admin: boolean;
-}
-
-/** Read normalized repository permissions from a GitHub repository response. */
-export function githubRepositoryPermissions(value: unknown): GithubRepositoryPermissions {
-  const repository = object.isRecord(value) ? value : undefined;
-  const permissions = object.isRecord(repository?.permissions) ? repository.permissions : undefined;
-  return {
-    push: permissions?.push === true,
-    maintain: permissions?.maintain === true,
-    admin: permissions?.admin === true,
-  };
-}
-
-/** Whether the actor can manage releases rather than only push source. */
-export function githubRepositoryCanManage(permissions: GithubRepositoryPermissions): boolean {
-  return permissions.maintain || permissions.admin;
-}
-
-/** Parse successful GitHub CLI accounts with the active account first. */
-export function githubAuthenticatedAccounts(
-  statusOutput: string,
-  hostname: string,
-): GithubAuthenticatedAccount[] {
-  const status = json.parseRecord(statusOutput);
-  const hosts = object.isRecord(status?.hosts) ? status.hosts : undefined;
-  const entries = hosts?.[hostname];
-  if (!Array.isArray(entries)) return [];
-  return entries
-    .flatMap((entry) => {
-      if (!object.isRecord(entry) || entry.state !== "success" || typeof entry.login !== "string") {
-        return [];
-      }
-      const scopes =
-        typeof entry.scopes === "string"
-          ? entry.scopes
-              .split(",")
-              .map((scope) => scope.trim())
-              .filter(Boolean)
-          : [];
-      return [{ login: entry.login, active: entry.active === true, scopes }];
-    })
-    .filter(
-      (account, index, accounts) =>
-        accounts.findIndex((candidate) => candidate.login === account.login) === index,
-    )
-    .sort((left, right) => Number(right.active) - Number(left.active));
-}
-
-/** Whether an account can update workflow files when using a classic OAuth token. */
-export function githubAccountSupportsWorkflowChanges(account: GithubAuthenticatedAccount): boolean {
-  return !account.scopes.includes("repo") || account.scopes.includes("workflow");
-}
-
-/** Ask GitHub CLI for one account token on the repository host. */
-export function githubTokenArguments(hostname: string, user?: string): string[] {
-  return ["auth", "token", "--hostname", hostname, ...(user ? ["--user", user] : [])];
-}
-
-/** GitHub CLI token variable for a public, data-residency, or enterprise host. */
-export function githubTokenEnvironmentName(hostname: string): "GH_TOKEN" | "GH_ENTERPRISE_TOKEN" {
-  return hostname === "github.com" || hostname.endsWith(".ghe.com")
-    ? "GH_TOKEN"
-    : "GH_ENTERPRISE_TOKEN";
-}
-
-/** Host-qualified repository selector consumed by GitHub CLI. */
-export function githubRepositorySpecifier(identity: GithubRepositoryIdentity): string {
-  return `${identity.hostname}/${identity.owner}/${identity.repository}`;
-}
-
-/** GitHub REST path for the detected repository. */
-export function githubRepositoryApiPath(identity: GithubRepositoryIdentity): string {
-  return `repos/${identity.owner}/${identity.repository}`;
-}