bazis 0.98.3 → 0.98.4

package/core/http/HttpServer.ts

@@ -16,7 +16,7 @@ import type { PreparedOpenApiDocs } from "../../library/openapi";
 import { RouterBuilder } from "./Routing/RouterBuilder";
 import type { Router } from "./Routing/Router";
 import { parseRequestPath } from "./Routing/template";
-import { createVersionReader, type VersionReader } from "./Versioning/VersionReader";
+import { assertVersioningOptions, createVersionReader, type VersionReader } from "./Versioning/VersionReader";
 import { HTTP_ERROR_HOOK, ROUTE_MIDDLEWARE_COMPOSER, SERVER_MIDDLEWARE, sortByOrder } from "./middlewareTokens";
 import type { HealthEndpointOptions, RouteMiddlewareComposer, HttpModuleOptions } from "./options";
 import { WEBSOCKET_UPGRADE, type WebSocketUpgrade } from "./WebSocketUpgrade";
@@ -102,6 +102,7 @@ export class HttpServer implements HostedService {
     this.phase = options.phase ?? 10;
     this.modelValidator = options.validator ?? getModelValidator();
     assertHttpLimits(options);
+    assertVersioningOptions(options.versioning);
     if (options.inspectableRedirects !== undefined && typeof options.inspectableRedirects !== "boolean") {
       throw new HttpSetupError("inspectableRedirects must be a boolean.");
     }

package/core/http/Versioning/VersionReader.ts

@@ -1,3 +1,4 @@
+import { HttpSetupError } from "../Errors/HttpError";
 import type { ApiVersioningOptions } from "../options";
 
 /**
@@ -18,3 +19,35 @@ export function createVersionReader(options: ApiVersioningOptions | undefined):
   const header = options.headerName ?? "x-api-version";
   return (request) => request.headers.get(header) ?? options.defaultVersion;
 }
+
+const SOURCES = ["url", "query", "header"] as const;
+
+/**
+ * Rejects versioning options that would be silently ignored: an unknown
+ * source, or a setting that belongs to another source.
+ */
+export function assertVersioningOptions(options: ApiVersioningOptions | undefined): void {
+  if (options === undefined) return;
+  const { source } = options;
+  if (!SOURCES.includes(source)) {
+    throw new HttpSetupError(`versioning.source must be "url", "query" or "header", got ${JSON.stringify(source)}.`);
+  }
+  if (source === "url" && options.defaultVersion !== undefined) {
+    throw new HttpSetupError(
+      'versioning.defaultVersion has no effect with source "url": the version is part of the path (/v1/...). '
+        + 'Remove it, or use source "query" or "header".',
+    );
+  }
+  if (source !== "query" && options.parameterName !== undefined) {
+    throw new HttpSetupError(
+      `versioning.parameterName has no effect with source "${source}": it names the query parameter of source "query".`
+        + (source === "header" ? " Use headerName for the header." : ""),
+    );
+  }
+  if (source !== "header" && options.headerName !== undefined) {
+    throw new HttpSetupError(
+      `versioning.headerName has no effect with source "${source}": it names the header of source "header".`
+        + (source === "query" ? " Use parameterName for the query parameter." : ""),
+    );
+  }
+}

package/core/http/options.ts

@@ -37,11 +37,15 @@ export interface ApiVersioningOptions {
    * - `"header"` — custom header (default `x-api-version`).
    */
   readonly source: "url" | "query" | "header";
-  /** Query parameter name for `source: "query"` (default "api-version"). */
+  /** Query parameter name for `source: "query"` (default "api-version"); other sources reject it. */
   readonly parameterName?: string;
-  /** Header name for `source: "header"` (default "x-api-version"). */
+  /** Header name for `source: "header"` (default "x-api-version"); other sources reject it. */
   readonly headerName?: string;
-  /** Version assumed when the request does not specify one. */
+  /**
+   * Version assumed when the request does not specify one. Only for the
+   * `"query"` and `"header"` sources: with `"url"` the version is part of the
+   * path, and the server refuses to start.
+   */
   readonly defaultVersion?: string;
 }
 

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.98.3" }, capabilities: { experimentalApi: true },
+        clientInfo: { name: "bazis", title: "Bazis", version: "0.98.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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bazis",
-  "version": "0.98.3",
+  "version": "0.98.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",