bazis 0.110.0 → 0.111.0

package/core/app/runApp.ts

@@ -6,15 +6,18 @@ import {
   Global,
   Module,
   singletonValue,
+  CLASS_PROVIDER_HOOK,
   type BazisModuleRef,
 } from "../di";
 import { loadBazisGeneratedRuntime } from "../generatedRuntime";
 import { missingCacheModuleCheck } from "../cache/http/missingCacheModuleCheck";
+import { cacheableClassProviderHook } from "../cache/di/classProviderHook";
 import { httpModule, useModelValidator, type HttpModuleOptions, type ModelValidator } from "../http";
 import { grpcModule, type GrpcModuleOptions } from "../grpc";
 import { buildHttpOpenApiDocument } from "../http/OpenApi/openApiDocument";
 import { defaultAuthorizeChecks } from "../http/Authorization/metadata";
 import { KernelBuilder, Bazis, KernelError, type KernelOptions, type ValidatableConfig } from "../kernel";
+import { reportBuildFailure } from "../kernel/Bazis";
 import { websocketModule, type WebSocketOptions } from "../websocket";
 import {
   isUiProfileAuthoringClass,
@@ -287,7 +290,14 @@ function normalizeAbsolutePath(path: string): string {
  */
 export async function runApp(root: BazisModuleRef, options: RunAppOptions = {}): Promise<number> {
   await loadBazisGeneratedRuntime();
-  return Bazis.run(composeApp(root, options), options.kernel, (builder) => {
+  let app: BazisModuleRef;
+  try {
+    app = composeApp(root, options);
+  } catch (error) {
+    // Composing already reads routes and options: report its errors like the kernel build does.
+    return reportBuildFailure(error);
+  }
+  return Bazis.run(app, options.kernel, (builder) => {
     builder.useApplicationRoot(root);
     options.configure?.(builder);
   });
@@ -314,6 +324,11 @@ export function composeApp(root: BazisModuleRef, options: RunAppOptions = {}): B
     // Warns about @OutputCache routes when no cache module is installed.
     globals.push({ global: true, providers: [missingCacheModuleCheck()] });
   }
+  // The cache wrapper of @Cacheable / @CacheableRedis classes, also without a cache
+  // module: it then needs ICache, and the graph check names the class and says to add
+  // cache: memory(). Without it the decorators would silently do nothing. The cache
+  // module registers the same hook, and DI keeps one.
+  globals.push({ global: true, providers: [singletonValue(CLASS_PROVIDER_HOOK, cacheableClassProviderHook)] });
   const appRoot: BazisModuleRef =
     globals.length > 0 || options.config !== undefined
       ? {

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

@@ -47,17 +47,7 @@ export class Bazis {
     try {
       kernel = await builder.build();
     } catch (error) {
-      if (screen !== undefined && !(error instanceof ShutdownTimeoutError)) {
-        screen.failed(error, undefined, builder.report);
-        process.exitCode = 1;
-        return 1;
-      }
-      if (error instanceof DiError || error instanceof KernelError) {
-        console.error(`[bazis] configuration error: ${redactSensitiveText(error.message)}`);
-        process.exitCode = 1;
-        return 1;
-      }
-      throw error;
+      return reportBuildFailure(error, screen, builder.report);
     }
 
     try {
@@ -96,3 +86,27 @@ export class Bazis {
     }
   }
 }
+
+/**
+ * @internal How a start that failed before the kernel was built is reported:
+ * the startup screen on a terminal, otherwise one `[bazis] configuration error`
+ * line for DI and kernel errors. Returns exit code 1; anything else is rethrown.
+ * `runApp` uses it for errors found while it composes the application.
+ */
+export function reportBuildFailure(
+  error: unknown,
+  screen: StartupScreen | undefined = startupScreenEnabled() ? new StartupScreen() : undefined,
+  report?: KernelBuilder["report"],
+): number {
+  if (screen !== undefined && !(error instanceof ShutdownTimeoutError)) {
+    screen.failed(error, undefined, report);
+    process.exitCode = 1;
+    return 1;
+  }
+  if (error instanceof DiError || error instanceof KernelError) {
+    console.error(`[bazis] configuration error: ${redactSensitiveText(error.message)}`);
+    process.exitCode = 1;
+    return 1;
+  }
+  throw error;
+}

package/package.json

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