bazis 0.105.0 → 0.105.2

package/cli/main.ts

@@ -6,7 +6,7 @@ import { parseCliArgs, type ParsedGenerateArgs } from "./parseCli";
 import { runCodegen, type CodegenOptions } from "./codegen";
 import { generateProject } from "./generateProject";
 import { runBuild, runDev, runTest } from "./build";
-import { commandFailed, commandHeader, createScreens, lineOutput, type CliOutput } from "./ui";
+import { bazisVersion, commandFailed, commandHeader, createScreens, lineOutput, requiredBun, type CliOutput } from "./ui";
 
 export const USAGE = `Usage:
   bazis new <Name> [options]                  Create a new application project
@@ -21,6 +21,7 @@ export const USAGE = `Usage:
   bazis build --bin [--outfile <path>]        Also compile a standalone executable (default bin/<name>)
   bazis build --bin --dotenv                  The executable also reads .env files from its working directory
   bazis --help
+  bazis --version                             Print the bazis version (also -v)
   g can also be written as generate.
   --lang <en|ru> sets the output language (also BAZIS_LANG, "language" in bazis.config.json).
 
@@ -72,6 +73,8 @@ export interface CliRuntime {
   readonly stderr?: ScreenOutput;
   /** Output language when `--lang` is not given; detected from the environment otherwise. */
   readonly language?: Language;
+  /** The running Bun: version and executable (default: this process). */
+  readonly bun?: { readonly version: string; readonly path: string };
 }
 
 const defaultRuntime: CliRuntime = {
@@ -107,6 +110,18 @@ export async function runCli(argv: readonly string[], runtime: CliRuntime = defa
     runtime.log(USAGE.trim());
     return parsed.help ? 0 : 1;
   }
+  if (parsed.kind === "version") {
+    runtime.log(bazisVersion());
+    return 0;
+  }
+  // `#!/usr/bin/env bun` runs the CLI on the first bun in PATH, which may be
+  // older than the one the user called; stop before it fails somewhere later.
+  const bun = runtime.bun ?? { version: Bun.version, path: process.execPath };
+  const required = requiredBun();
+  if (required !== undefined && !Bun.semver.satisfies(bun.version, required)) {
+    const t = ui.err.t.errors;
+    return commandFailed(ui.err, ui.err.t.failure.command, [{ tag: "BUN", where: bun.path, cause: t.bunTooOld(required, bun.version), fixes: [t.bunWhich(bun.path), t.bunUpgrade] }], 1);
+  }
   if (parsed.kind === "error") {
     return commandFailed(ui.err, ui.err.t.failure.command, [{ tag: "CLI", where: "bazis", cause: parsed.message, fixes: [ui.err.t.errors.unknown] }], 1);
   }

package/cli/parseCli.ts

@@ -20,6 +20,7 @@ export interface ParsedGenerateArgs {
 
 export type ParseCliResult =
   | { readonly kind: "help"; readonly help: boolean }
+  | { readonly kind: "version" }
   | { readonly kind: "new"; readonly name: string; readonly outputPath?: string; readonly frameworkPath?: string; readonly linkFramework: boolean; readonly vendor: boolean; readonly dryRun: boolean }
   | { readonly kind: "generate"; readonly args: ParsedGenerateArgs }
   | { readonly kind: "codegen"; readonly target?: string }
@@ -38,6 +39,7 @@ const FLAG_OPTIONS = new Set(["--no-register", "--force", "--full", "--enterpris
 /** Parsing is pure: help and invalid input can never start generation. */
 export function parseCliArgs(argv: readonly string[]): ParseCliResult {
   if (argv.some((arg) => arg === "--help" || arg === "-h")) return { kind: "help", help: true };
+  if (argv.length === 1 && (argv[0] === "--version" || argv[0] === "-v")) return { kind: "version" };
   if (argv.length === 0) return { kind: "help", help: false };
   // Everything after `test` (or `test --`) belongs to `bun test`.
   if (argv[0] === "test") return { kind: "test", args: argv[1] === "--" ? argv.slice(2) : argv.slice(1) };

package/cli/ui.ts

@@ -37,18 +37,28 @@ export function projectInfo(cwd: string): { name?: string; version?: string } {
   }
 }
 
-/** Version of the bazis package this CLI belongs to. */
-export function bazisVersion(): string {
+function bazisPackage(): { version?: unknown; engines?: { bun?: unknown } } | undefined {
   try {
     const file = fileURLToPath(new URL("../package.json", import.meta.url));
-    if (!existsSync(file)) return "?";
-    const version = (JSON.parse(readFileSync(file, "utf8")) as { version?: unknown }).version;
-    return typeof version === "string" ? version : "?";
+    if (!existsSync(file)) return undefined;
+    return JSON.parse(readFileSync(file, "utf8")) as { version?: unknown; engines?: { bun?: unknown } };
   } catch {
-    return "?";
+    return undefined;
   }
 }
 
+/** Version of the bazis package this CLI belongs to. */
+export function bazisVersion(): string {
+  const version = bazisPackage()?.version;
+  return typeof version === "string" ? version : "?";
+}
+
+/** The Bun range the package declares in `engines` (`>=1.4.0`). */
+export function requiredBun(): string | undefined {
+  const range = bazisPackage()?.engines?.bun;
+  return typeof range === "string" ? range : undefined;
+}
+
 /** The logo with the command badge: project, versions, and the command's own facts. */
 export function commandHeader(screen: Screen, mode: keyof typeof MODE, cwd: string, facts: readonly string[], project = projectInfo(cwd)): void {
   screen.header(mode, MODE[mode], [

package/core/di/errors/NamedDependencyNotFoundError.ts

@@ -10,9 +10,18 @@ export function registerNamedDependencyHint(hint: NamedDependencyHint): void {
   hints.push(hint);
 }
 
+function hintFor(name: string): string {
+  const hint = hints.map((item) => item(name)).find((text) => text !== undefined);
+  return hint ? ` ${hint}` : "";
+}
+
+/** The graph-validation issue for a named dependency nobody registers, naming the service that needs it. */
+export function missingNamedDependencyIssue(name: string, requester: string): string {
+  return `Missing dependency "${name}" for "${requester}".${hintFor(name)}`;
+}
+
 export class NamedDependencyNotFoundError extends DiError {
   public constructor(name: string) {
-    const hint = hints.map((item) => item(name)).find((text) => text !== undefined);
-    super(`No provider token found for named dependency "${name}".${hint ? ` ${hint}` : ""}`);
+    super(`No provider token found for named dependency "${name}".${hintFor(name)}`);
   }
 }

package/core/di/internal/GraphValidator.ts

@@ -1,4 +1,5 @@
 import { ServiceValidationError } from "../errors";
+import { missingNamedDependencyIssue } from "../errors/NamedDependencyNotFoundError";
 import { isLazyDependency, isNamedDependency, isOptionalDependency } from "../provider";
 import type {
   KeyedDependency,
@@ -97,7 +98,8 @@ export class GraphValidator {
         const isOptional = isOptionalDependency(dependency);
         const inner = isLazy || isOptional ? dependency.inner : dependency;
         // An optional dependency on a name nothing registered is simply absent.
-        if (isOptional && isNamedDependency(inner) && !this.context.hasName(inner.name)) {
+        if (isNamedDependency(inner) && !this.context.hasName(inner.name)) {
+          if (!isOptional) issues.add(missingNamedDependencyIssue(inner.name, tokenToDebugName(registration.token)));
           continue;
         }
         const descriptor = this.context.describeDependency(inner);

package/core/infra/connectors/codex/CodexAppServerClient.ts

@@ -232,7 +232,7 @@ export class CodexAppServerClient implements CodexClient {
         if (method === "account/updated") this.modelCache = undefined;
       }, () => { this.clearLogin(); this.modelCache = undefined; });
       const initialized = await client.request("initialize", {
-        clientInfo: { name: "bazis", title: "Bazis", version: "0.105.0" }, capabilities: { experimentalApi: true },
+        clientInfo: { name: "bazis", title: "Bazis", version: "0.105.2" }, capabilities: { experimentalApi: true },
       }, 15_000, signal);
       if (resolve(text(initialized.codexHome, 4096)) !== this.paths.home) throw new CodexError("PROTOCOL_ERROR");
       client.notify("initialized");

package/core/kernel/config/defineConfig.ts

@@ -7,6 +7,16 @@ import { ENV_PREFIX } from "./sources";
 import { isSensitiveKey, redactSensitiveText } from "../../../library/redaction";
 import { ConfigValidationError, type ConfigIssue, type ConfigIssueKind } from "./ConfigValidationError";
 import { callerFile } from "./callerFile";
+import { registerNamedDependencyHint } from "../../di/errors/NamedDependencyNotFoundError";
+
+// `ConfigView<T>` is injected by the name of its config; a config that no
+// module declares has no provider, and the start says where to declare it.
+registerNamedDependencyHint((name) => {
+  const match = /^Config:(.+)$/.exec(name);
+  if (!match) return undefined;
+  const declaration = match[1] === "default" ? "defineConfig({ … })" : `defineConfig("${match[1]}", …)`;
+  return `The config ${declaration} is not declared in the application: add it to \`config\` of the module that uses it, or to runApp({ config }).`;
+});
 
 type Stand = "development" | "test" | "production";
 type Primitive = string | number | boolean;

package/library/terminal/messages.ts

@@ -238,6 +238,9 @@ const en = {
   },
   errors: {
     unknown: "Use bazis --help to list commands and options.",
+    bunTooOld: (required: string, actual: string) => `bazis needs Bun ${required.startsWith(">=") ? `${required.slice(2).trim()} or newer` : required}; this is Bun ${actual}.`,
+    bunWhich: (file: string) => `This Bun is ${file}. bunx bazis and bun run scripts start bazis with the first bun in PATH, not with the Bun that called them.`,
+    bunUpgrade: "Update that Bun: bun upgrade. Or put the newer Bun first in PATH.",
   },
 };
 
@@ -397,6 +400,9 @@ const ru: Messages = {
   },
   errors: {
     unknown: "Список команд и опций: bazis --help.",
+    bunTooOld: (required, actual) => `bazis нужен Bun ${required.startsWith(">=") ? `${required.slice(2).trim()} или новее` : required}, а запущен Bun ${actual}.`,
+    bunWhich: (file) => `Запущен ${file}. bunx bazis и скрипты bun run запускают bazis первым bun из PATH, а не тем Bun, который их вызвал.`,
+    bunUpgrade: "Обновите этот Bun: bun upgrade. Или поставьте новый Bun первым в PATH.",
   },
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bazis",
-  "version": "0.105.0",
+  "version": "0.105.2",
   "description": "Modular backend framework for Bun in TypeScript: DI wired by codegen, HTTP, a PostgreSQL ORM, JWT, WebSocket, agents and a CLI.",
   "license": "MIT",
   "author": "Alexander Alenin",