bazis 0.97.2 → 0.97.4

package/cli/build.ts

@@ -13,7 +13,7 @@ export interface BuildOptions {
 }
 
 /**
- * `bazis dev`: codegen, then run the default target's entrypoint from source.
+ * `bazis dev`: codegen of every target, then run the default target's entrypoint from source.
  * With `watch`, a change under src/ (except src/generated) stops the app,
  * reruns codegen and starts it again; a failed codegen waits for the next change.
  * The app runs as `development` unless BAZIS_ENV is set in the shell.
@@ -28,7 +28,7 @@ export async function runDev(cwd: string, codegen: Codegen, log: (message: strin
   const entry = await projectEntry(cwd);
   const env = devEnvironment(process.env);
   if (!options.watch) {
-    const generated = await codegen(cwd);
+    const generated = await codegen(cwd, "all");
     if (generated !== 0) return generated;
     const child = Bun.spawn([bun, "run", entry], { cwd, env, stdin: "inherit", stdout: "inherit", stderr: "inherit" });
     // The app owns graceful shutdown; forward the signal instead of dying first.
@@ -55,7 +55,7 @@ export async function runDev(cwd: string, codegen: Codegen, log: (message: strin
     await running.exited;
   };
   const start = async () => {
-    if (await codegen(cwd) !== 0) { log("[bazis] codegen failed; waiting for changes..."); return; }
+    if (await codegen(cwd, "all") !== 0) { log("[bazis] codegen failed; waiting for changes..."); return; }
     child = Bun.spawn([bun, "run", entry], { cwd, env, stdin: "inherit", stdout: "inherit", stderr: "inherit" });
   };
   const watcher = watch(path.join(cwd, "src"), { recursive: true }, (_event, file) => {
@@ -84,16 +84,16 @@ export async function runDev(cwd: string, codegen: Codegen, log: (message: strin
   }
 }
 
-/** `bazis test [args]`: codegen, then `bun test` with the given arguments. */
+/** `bazis test [args]`: codegen of every target, then `bun test` with the given arguments. */
 export async function runTest(cwd: string, args: readonly string[], codegen: Codegen): Promise<number> {
-  const generated = await codegen(cwd);
+  const generated = await codegen(cwd, "all");
   if (generated !== 0) return generated;
   return await Bun.spawn([await resolveBun(cwd), "test", ...args], { cwd, stdin: "inherit", stdout: "inherit", stderr: "inherit" }).exited;
 }
 
-/** `bazis build [--bin]`: codegen and typecheck; with `bin`, also compile. */
+/** `bazis build [--bin]`: codegen of every target and typecheck; with `bin`, also compile. */
 export async function runBuild(cwd: string, options: BuildOptions, codegen: Codegen, log: (message: string) => void): Promise<number> {
-  const generated = await codegen(cwd);
+  const generated = await codegen(cwd, "all");
   if (generated !== 0) return generated;
   const bun = await resolveBun(cwd);
   const tsc = path.join(cwd, "node_modules/typescript/bin/tsc");

package/cli/main.ts

@@ -115,7 +115,7 @@ export async function runCli(argv: readonly string[], runtime: CliRuntime = defa
       runtime.log(`[bazis] codegen skipped: ${!args.codegen ? "--no-codegen" : "module is not connected by this command"}.`);
       return 0;
     }
-    runtime.log("[bazis] running di:generate...");
+    runtime.log("[bazis] running codegen...");
     const exitCode = await runtime.codegen(process.cwd(), args.target);
     if (exitCode !== 0) runtime.error("[bazis] codegen failed; scaffold files were kept. Fix the error and run bazis codegen.");
     return exitCode;

package/core/agent/generated/catalog.ts

@@ -1,4 +1,4 @@
-// This file is auto-generated by `bun run di:generate`.
+// This file is auto-generated by `bazis codegen`.
 // Do not edit manually.
 
 import type { Class } from "../../di";

package/core/app/ui/uiProfileResolver.ts

@@ -746,7 +746,7 @@ function resolveAndValidateResponseSchema(
     diagnostics.push(uiDiagnosticV1(
       "error",
       "UIV1_RESPONSE_MODEL_NOT_REGISTERED",
-      `${profileName} response class is not bound to a generated OpenAPI schema. Run bun run di:generate.`,
+      `${profileName} response class is not bound to a generated OpenAPI schema. Run \`bazis codegen\`.`,
       { profile: profileName, path: "response" },
     ));
     return actual;

package/core/di/ServiceProvider.ts

@@ -112,6 +112,23 @@ export class ServiceProvider implements ServiceResolver {
     return this.resolveSingleAsync(token, key, this.lifetime.root, []);
   }
 
+  /**
+   * Creates every singleton registered with an async factory (keyed ones
+   * included), in registration order. Afterwards `resolve` and constructor
+   * injection return the cached instances. The kernel calls it at startup, so a
+   * failing factory stops the start instead of failing every request.
+   */
+  public async initializeAsyncSingletons(): Promise<void> {
+    this.lifetime.assertLive(this.lifetime.root);
+    for (const group of this.registry.groups()) {
+      for (const registration of group) {
+        if (registration.lifetime === "singleton" && isAsyncFactoryProvider(registration.provider)) {
+          await this.resolveRegistrationAsync(registration, registration.key, this.lifetime.root, [], undefined);
+        }
+      }
+    }
+  }
+
   public tryResolve<T>(token: Token<T>, key?: ServiceKey): T | undefined {
     return this.tryResolveForScope(token, key, this.lifetime.root);
   }

package/core/di/errors/ClassDependenciesMismatchError.ts

@@ -9,7 +9,7 @@ export class ClassDependenciesMismatchError extends DiError {
     declaredDeps: number,
   ) {
     super(
-      `Class provider "${tokenToDebugName(token)}" requires at least ${requiredConstructorParams} constructor deps, but only ${declaredDeps} declared.`,
+      `Class provider "${tokenToDebugName(token)}" requires at least ${requiredConstructorParams} constructor deps, but only ${declaredDeps} declared. Constructor dependencies are wired by codegen: if the constructor was added or changed after the last run, run \`bazis codegen\` (bazis dev, bazis test and bazis build run it automatically); otherwise pass the deps explicitly.`,
     );
   }
 }

package/core/di/internal/GraphValidator.ts

@@ -70,7 +70,7 @@ export class GraphValidator {
     const shape = this.context.classShape(registration.provider);
     if (shape && shape.required > shape.declared) {
       issues.add(
-        `Class provider "${tokenToDebugName(registration.token)}" requires at least ${shape.required} constructor deps, but only ${shape.declared} declared.`,
+        `Class provider "${tokenToDebugName(registration.token)}" requires at least ${shape.required} constructor deps, but only ${shape.declared} declared. Constructor dependencies are wired by codegen: if the constructor was added or changed after the last run, run \`bazis codegen\` (bazis dev, bazis test and bazis build run it automatically); otherwise pass the deps explicitly.`,
       );
     }
 

package/core/generatedFingerprint.ts

@@ -37,6 +37,16 @@ export function frameworkVersion(): string | undefined {
  * (or with another framework version): new routes and dependencies would be
  * silently missing. A compiled binary carries no sources, so it is skipped.
  */
+let staleGeneratedSources = false;
+
+/**
+ * True when the loaded generated code was produced from older sources (or
+ * another bazis version) than the ones running now.
+ */
+export function generatedSourcesAreStale(): boolean {
+  return staleGeneratedSources;
+}
+
 export function warnIfGeneratedSourcesChanged(
   generatedDir: string,
   fingerprint: GeneratedSourceFingerprint,
@@ -49,6 +59,7 @@ export function warnIfGeneratedSourcesChanged(
   const version = frameworkVersion();
   if (version !== undefined && version !== fingerprint.framework) changes.push(`bazis ${fingerprint.framework} -> ${version}`);
   if (changes.length === 0) return false;
+  staleGeneratedSources = true;
   warn([
     "",
     `[bazis] WARNING: generated code is out of date (${changes.join("; ")}).`,

package/core/http/Binding/autoBindings.ts

@@ -24,7 +24,7 @@ export function registerGeneratedBindings(
 }
 
 /**
- * Binding conventions inferred by codegen (`bun run di:generate`) from the
+ * Binding conventions inferred by codegen (`bazis codegen`) from the
  * controller method signature, the counterpart of DI auto deps:
  *
  * - a parameter named like a route `:name` -> from the route;
@@ -72,7 +72,7 @@ function toBinding(spec: GeneratedBindingSpec, controllerName: string, methodNam
       if (ctor === undefined) {
         throw new HttpSetupError(
           `${controllerName}.${methodName}: list model "${spec.model}" is not registered. ` +
-            `Make sure the class extends ListRequest and its module is imported, then run \`bun run di:generate\`.`,
+            `Make sure the class extends ListRequest and its module is imported, then run \`bazis codegen\`.`,
         );
       }
       if (ctor === AMBIGUOUS_LIST_MODEL) {

package/core/http/Binding/generatedSpec.ts

@@ -1,5 +1,5 @@
 /**
- * Format of the generated binding conventions (`bun run di:generate`).
+ * Format of the generated binding conventions (`bazis codegen`).
  *
  * Plain data without class references: the body model is given **by name** and
  * resolved at startup through the class index of the generated target.

package/core/http/Binding/modelBinder.ts

@@ -48,7 +48,7 @@ export interface ModelBindingOptions {
  *
  * The model class must have a parameterless constructor. Class-typed nested
  * DTOs (including arrays) are recursively hydrated from metadata emitted by
- * `bun run di:generate`; initialized nested DTO fields remain supported as a
+ * `bazis codegen`; initialized nested DTO fields remain supported as a
  * runtime fallback.
  */
 export function bindModel<T extends object>(model: Class<T>, data: unknown, validator?: ModelValidator, options: ModelBindingOptions = {}): T {

package/core/http/Binding/requestModelRegistry.ts

@@ -13,7 +13,7 @@ export const AMBIGUOUS_REQUEST_MODEL: unique symbol = Symbol("ambiguous-request-
 export type RequestModelClass = new () => object;
 
 /**
- * Runtime hydration metadata emitted by `bun run di:generate` for a class-
+ * Runtime hydration metadata emitted by `bazis codegen` for a class-
  * typed request-model field. Standard TC39 decorators deliberately do not
  * expose design types, so this tiny registry is the dependency-free bridge
  * from TypeScript source types to the HTTP binder.

package/core/http/Routing/RouterBuilder.ts

@@ -1,6 +1,7 @@
 import type { Class, Token } from "../../di";
 import { bindArguments } from "../Binding/ParameterBinder";
 import { resolveGeneratedBindings } from "../Binding/autoBindings";
+import { generatedSourcesAreStale } from "../../generatedFingerprint";
 import { controllerMetaOf, type ActionMeta, type ControllerMeta } from "../Decorators/metadata";
 import { HttpSetupError } from "../Errors/HttpError";
 import type { HttpContext } from "../HttpContext/HttpContext";
@@ -108,6 +109,7 @@ export class RouterBuilder {
     const filters: readonly ActionFilterHooks[] = [...meta.filters, ...action.filters];
     const catches = meta.catches;
     const bindings = resolveGeneratedBindings(controllerClass, methodName);
+    assertBindingsFresh(controllerClass, methodName, bindings);
     const responseDefaults = { httpCode: action.httpCode, produces: action.produces };
     const bindingDefaults = { consumes: action.consumes };
     const token = controllerClass as unknown as Token<object>;
@@ -182,3 +184,28 @@ export class RouterBuilder {
     return { boundary, terminal };
   }
 }
+
+/**
+ * Without generated bindings a method receives only the HttpContext. When the
+ * generated code is older than the sources, a method that declares parameters
+ * but has no bindings was most likely added or changed after the last codegen:
+ * its arguments would silently get wrong values, so the server refuses to start.
+ */
+function assertBindingsFresh(
+  controllerClass: Class<object>,
+  methodName: string | symbol,
+  bindings: readonly unknown[] | undefined,
+): void {
+  if (bindings !== undefined || !generatedSourcesAreStale()) {
+    return;
+  }
+  const method = (controllerClass.prototype as Record<string | symbol, unknown>)[methodName];
+  if (typeof method !== "function" || method.length === 0) {
+    return;
+  }
+  throw new HttpSetupError(
+    `${controllerClass.name}.${String(methodName)} has parameters but no generated argument bindings: ` +
+      "the generated code is older than this controller. Run `bazis codegen` " +
+      "(bazis dev, bazis test and bazis build run it automatically).",
+  );
+}

package/core/http/options.ts

@@ -116,7 +116,7 @@ export interface HttpModuleOptions {
   readonly health?: HealthEndpointOptions | boolean;
   /**
    * Built-in generated API docs. No user-facing Swagger decorators are needed:
-   * `bun run di:generate` derives request models and schemas from controllers.
+   * `bazis codegen` derives request models and schemas from controllers.
    *
    * Default: enabled in debug environments, disabled in production. `true`
    * serves `/docs` and `/docs/openapi.json`; pass an object to change paths or

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.97.2" }, capabilities: { experimentalApi: true },
+        clientInfo: { name: "bazis", title: "Bazis", version: "0.97.4" }, 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/Kernel.ts

@@ -13,6 +13,7 @@ import type { UnhandledErrorPolicy } from "./types";
 import { redactSensitive } from "../../library/redaction";
 import { validateTimeout } from "./internal/validateTimeout";
 import { awaitShutdown } from "./internal/awaitShutdown";
+import { awaitAbortable } from "./internal/awaitAbortable";
 import { reportDiagnosticFailure } from "./internal/reportDiagnosticFailure";
 
 export interface KernelTimings {
@@ -97,6 +98,9 @@ export class Kernel {
       );
     }
     try {
+      // Async singletons first: hosted services and controllers take them
+      // through constructors, which resolve synchronously.
+      await awaitAbortable(this.container.initializeAsyncSingletons(), abortController.signal);
       await this.coordinator.start(abortController.signal, this.options.shutdownTimeoutMs);
       coordinatorStarted = true;
       this.startupMs = performance.now() - this.timings.buildStartedAt;

package/core/scripts/agent-codegen.ts

@@ -879,7 +879,7 @@ function renderAgentCatalog(context: AgentCodegenContext): RenderedAgentCatalog
   const validPrompts = filterImportablePromptEntries(context.prompts, imports, context);
 
   const lines: string[] = [];
-  lines.push("// This file is auto-generated by `bun run di:generate`.");
+  lines.push("// This file is auto-generated by `bazis codegen`.");
   lines.push("// Do not edit manually.");
   lines.push("");
   if (context.frameworkImports === "public") {

package/core/scripts/di-generate.ts

@@ -156,6 +156,8 @@ interface CollectedDependency { readonly name: string; readonly target?: ts.Clas
 interface ConstructorDependencies {
   readonly deps: CollectedDependency[];
   readonly unsupportedInheritedParameter?: string;
+  /** An own constructor parameter whose type cannot name a DI dependency (`string`, `number`, an inline type). */
+  readonly unsupportedParameter?: { readonly index: number; readonly name: string; readonly type: string };
 }
 let classDeps = new Map<ts.ClassDeclaration, readonly CollectedDependency[]>();
 let inferredDiClasses = new Set<ts.ClassDeclaration>();
@@ -545,7 +547,7 @@ function failOnFatalErrors(): void {
 function renderGeneratedRuntime(targetId: string): string {
   if (activeGeneratedDir !== APP_GENERATED_DIR) {
     return [
-      "// This file is auto-generated by `bun run di:generate`.",
+      "// This file is auto-generated by `bazis codegen`.",
       "// Do not edit manually.",
       "",
       'import { registerBazisGeneratedTargetDescriptor } from "bazis/core/generatedRuntime";',
@@ -565,7 +567,7 @@ function renderGeneratedRuntime(targetId: string): string {
     ].join("\n");
   }
   return [
-    "// This file is auto-generated by `bun run di:generate`.",
+    "// This file is auto-generated by `bazis codegen`.",
     "// Do not edit manually.",
     "",
     "let registered: Promise<void> | undefined;",
@@ -615,7 +617,7 @@ function renderTargetDeps(): string {
       if (dependency.target && !references.has(dependency.target)) references.set(dependency.target, `DependencyClass_${references.size}`);
     }
   }
-  const lines = ["// This file is auto-generated by `bun run di:generate`.", "// Do not edit manually."];
+  const lines = ["// This file is auto-generated by `bazis codegen`.", "// Do not edit manually."];
   if (entries.some(([, deps]) => deps.some(dep => dep.target && dep.lazy))) lines.push('import { lazyDependency } from "bazis/core/di";');
   for (const [declaration, reference] of references) {
     const name = dependencyClassExportName(declaration);
@@ -668,7 +670,7 @@ function renderTargetBindings(): string {
   // bindable parameters as well as ordinary binding-bearing controllers.
   const entries = [...new Set([...Object.keys(httpBindings), ...Object.keys(openApiOperations)])]
     .sort((a, b) => a.localeCompare(b));
-  const lines = ["// This file is auto-generated by `bun run di:generate`.", "// Do not edit manually."];
+  const lines = ["// This file is auto-generated by `bazis codegen`.", "// Do not edit manually."];
   for (let index = 0; index < entries.length; index += 1) {
     const name = entries[index] as string;
     const file = httpControllerFiles[name] ?? classFilesByName.get(name);
@@ -796,6 +798,10 @@ function collectClassDeps(source: ts.SourceFile): void {
   const visit = (node: ts.Node): void => {
     if (ts.isClassDeclaration(node) && node.name) {
       const result = readConstructorTypeNames(node);
+      if (result.unsupportedParameter !== undefined && needsInferredDiDeps(node)) {
+        const { index, name, type } = result.unsupportedParameter;
+        fatalErrors.push(`BAZIS_DI_DEPENDENCY_UNKNOWN: ${sourceLocation(node)}: constructor parameter ${index + 1} "${name}" of "${node.name.text}" has type "${type}", which cannot be injected: DI resolves dependencies by class, contract or token, and a plain type does not say which value to inject. Declare a token with the same name as a type alias (export type Prefix = string; export const Prefix = createToken<Prefix>("Prefix")) and register a value, or pass the deps explicitly: scoped(${node.name.text}, ${node.name.text}, [TOKEN] as const).`);
+      }
       if (result.unsupportedInheritedParameter !== undefined && needsInferredDiDeps(node)) {
         fatalErrors.push(`BAZIS_DI_CONSTRUCTOR_UNRESOLVED: ${sourceLocation(node)}: cannot infer inherited constructor parameter "${result.unsupportedInheritedParameter}" for "${node.name.text}". The parameter needs a runtime DI token or an explicit value/factory binding.`);
       }
@@ -984,7 +990,7 @@ function readConstructorTypeNames(node: ts.ClassDeclaration): ConstructorDepende
     const paramType = param.type;
     const refName = paramType ? getDependencyTypeName(paramType) : undefined;
     if (!refName || BUILTIN_DEPENDENCY_NAMES.has(refName)) {
-      return { deps: [] };
+      return { deps: [], unsupportedParameter: { index, name: param.name.getText(), type: paramType?.getText() ?? "(no type)" } };
     }
 
     // `Lazy<X>` is a deferred dependency on X: encode it with a marker prefix
@@ -1677,7 +1683,7 @@ function sourceLocation(node: ts.Node): string {
 
 function renderListModels(imports: readonly RequestModelImport[]): string {
   const lines: string[] = [];
-  lines.push("// This file is auto-generated by `bun run di:generate`.");
+  lines.push("// This file is auto-generated by `bazis codegen`.");
   lines.push("// Do not edit manually.");
   lines.push("//");
   lines.push("// Target-local immutable descriptor; runtime publication is staged by runtime.ts.");
@@ -1717,7 +1723,7 @@ function renderRequestModels(
   hydration: RequestModelHydration,
 ): string {
   const lines: string[] = [];
-  lines.push("// This file is auto-generated by `bun run di:generate`.");
+  lines.push("// This file is auto-generated by `bazis codegen`.");
   lines.push("// Do not edit manually.");
   lines.push("//");
   lines.push("// Registers convention body models (class-typed action params) so they are");
@@ -1780,7 +1786,7 @@ function renderOpenApiMetadata(
   }
 
   const lines: string[] = [];
-  lines.push("// This file is auto-generated by `bun run di:generate`.");
+  lines.push("// This file is auto-generated by `bazis codegen`.");
   lines.push("// Do not edit manually.");
   lines.push("");
   lines.push(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bazis",
-  "version": "0.97.2",
+  "version": "0.97.4",
   "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",