@dbx-tools/projen 0.9.122 → 0.9.124

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.122";
+export const PACKAGE_VERSION = "0.9.124";
 export * as barrels from "./src/barrels.ts";
 export * as bunApp from "./src/bun-app.ts";
 export * as bunWorkflow from "./src/bun-workflow.ts";
@@ -38,7 +38,7 @@ export * as watch from "./src/watch.ts";
 export * as workspaceLock from "./src/workspace-lock.ts";
 export * as workspaceVersion from "./src/workspace-version.ts";
 export { BUN_DEV_OVERRIDE, BUN_BUILD_OVERRIDE, BUN_APP_OVERRIDES, RootBunfigFile, BunfigFile, BunDevServerFile, BunBuildFile } from "./src/bun-app.ts";
-export { BUN_VERSION } from "./src/bun-workflow.ts";
+export { BUN_VERSION, MINIMUM_BUN_VERSION, BUN_VERSION_CHECK_SCRIPT } from "./src/bun-workflow.ts";
 export { DBXToolsConfigDataSchema, DBXToolsConfig } from "./src/dbx-tools-config.ts";
 export type { DBXToolsConfigOptions, DBXToolsConfigData } from "./src/dbx-tools-config.ts";
 export { DEV_WATCH_TASK, DEV_WATCH_SCRIPT, DEV_RESTART_DEBOUNCE_MS, DEV_RESTART_KEY } from "./src/dev-watch.ts";

package/package.json

@@ -30,10 +30,10 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.7.0",
-    "@dbx-tools/cli-args": "^0.9.122",
-    "@dbx-tools/core": "^0.9.122",
-    "@dbx-tools/path": "^0.9.122",
-    "@dbx-tools/shared-core": "^0.9.122",
+    "@dbx-tools/cli-args": "^0.9.124",
+    "@dbx-tools/core": "^0.9.124",
+    "@dbx-tools/path": "^0.9.124",
+    "@dbx-tools/shared-core": "^0.9.124",
     "commander": "^15.0.0",
     "concurrently": "^10.0.3",
     "constructs": "^10.6.0",
@@ -55,7 +55,7 @@
   },
   "main": "index.ts",
   "license": "Apache-2.0",
-  "version": "0.9.122",
+  "version": "0.9.124",
   "types": "index.ts",
   "type": "module",
   "exports": {

package/src/bun-workflow.ts

@@ -2,3 +2,9 @@
 
 /** Bun version used by package manifests, generated workflows, and CLI services. */
 export const BUN_VERSION = "1.4.2";
+
+/** Oldest Bun release allowed to run generated project tasks. */
+export const MINIMUM_BUN_VERSION = BUN_VERSION;
+
+/** Generated runtime-version guard executed before dependency installation. */
+export const BUN_VERSION_CHECK_SCRIPT = "scripts/check-bun.ts";

package/src/project-js.ts

@@ -12,13 +12,17 @@ import * as projectUtils from "@dbx-tools/core/project-utils";
 import { ignore, match } from "@dbx-tools/path";
 import { object, stringUtils, type OneOrMany } from "@dbx-tools/shared-core";
 import { type IConstruct } from "constructs";
-import { Component, LogLevel, Project, type Task, javascript, typescript } from "projen";
+import { Component, LogLevel, Project, type Task, TextFile, javascript, typescript } from "projen";
 import { JobPermission, type JobStep } from "projen/lib/github/workflows-model";
 import type { ReleaseProjectOptions } from "projen/lib/release";
 import { generateBarrels, isGeneratedBarrel } from "./barrels.ts";
 
 import { BUN_APP_OVERRIDES, RootBunfigFile } from "./bun-app.ts";
-import { BUN_VERSION } from "./bun-workflow.ts";
+import {
+  BUN_VERSION,
+  BUN_VERSION_CHECK_SCRIPT,
+  MINIMUM_BUN_VERSION,
+} from "./bun-workflow.ts";
 import { codegenModulePaths, generateCodegen } from "./codegen.ts";
 import { DBXToolsConfig, type DBXToolsConfigOptions } from "./dbx-tools-config.ts";
 import { DEV_WATCH_SCRIPT, DEV_WATCH_TASK } from "./dev-watch.ts";
@@ -503,10 +507,53 @@ function defaultTypeScriptProjectOptions(options: DBXToolsTypeScriptProjectOptio
 // Pinned to match the subproject defaults so bun resolves one TypeScript and
 // one runtime-compatible set of Bun globals across the workspace.
 const DEV_DEPS_ROOT: string[] = [
+  `bun@${BUN_VERSION}`,
   "typescript@^5.9.3",
   `@types/bun@${BUN_VERSION}`,
   "@types/node@^24.6.0",
 ];
+
+function configureRootBunRuntime(project: DBXToolsJavaScriptProject): void {
+  new TextFile(project, BUN_VERSION_CHECK_SCRIPT, {
+    lines: stringUtils
+      .dedent(
+        // ============================================================================
+        /*ts*/`
+          /** Minimum Bun version accepted by this workspace. */
+          const MINIMUM_VERSION = ${JSON.stringify(MINIMUM_BUN_VERSION)};
+
+          /** Convert one Bun version into a three-part numeric tuple. */
+          function versionTuple(version: string): [number, number, number] {
+            const parts = version.split("-", 1)[0]!.split(".");
+            return [0, 1, 2].map((index) => Number.parseInt(parts[index] ?? "0", 10)) as [
+              number,
+              number,
+              number,
+            ];
+          }
+
+          const current = versionTuple(Bun.version);
+          const minimum = versionTuple(MINIMUM_VERSION);
+          const isTooOld = current.some(
+            (part, index) =>
+              part < minimum[index]! &&
+              current.slice(0, index).every((value, prefix) => value === minimum[prefix]),
+          );
+
+          if (isTooOld) {
+            throw new Error(
+              \`Bun \${MINIMUM_VERSION} or newer is required; running \${Bun.version}. Use "bun run bun" to select the workspace-local Bun binary.\`,
+            );
+          }
+        `,
+        // ============================================================================
+      )
+      .split("\n"),
+  });
+  const check = `bun ${BUN_VERSION_CHECK_SCRIPT}`;
+  project.package.installTask.prependExec(check);
+  project.package.installCiTask.prependExec(check);
+}
 function validateReleaseOptions(options: DBXToolsJavaScriptProjectOptions): void {
   if (
     options.releaseMode === "disabled" &&
@@ -1209,6 +1256,7 @@ function initProject(
   // Workspaces generated by this engine intentionally do not track local-registry
   // lockfiles, so the CI-named install task must resolve from manifests as well.
   project.package.installCiTask.reset("bun install");
+  configureRootBunRuntime(project);
   const roots = options.packageRoots ?? DEFAULT_PACKAGE_ROOTS;
   project.dbxToolsConfig.packageRoots = [...roots];
   if (options.syncResynthPaths?.length) {