@aklinker1/zeta 1.1.3 → 1.2.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aklinker1/zeta",
   "description": "Composable, testable, OpenAPI-first backend framework with validation built-in",
-  "version": "1.1.3",
+  "version": "1.2.0",
   "type": "module",
   "license": "MIT",
   "packageManager": "bun@1.3.2",
@@ -42,12 +42,13 @@
     "docs:preview": "vitepress preview docs"
   },
   "dependencies": {
-    "openapi-types": "^12.1.3",
     "@standard-schema/spec": "^1.0.0",
+    "openapi-types": "^12.1.3",
     "rou3": "^0.7.1"
   },
   "devDependencies": {
-    "@aklinker1/check": "^2.1.0",
+    "@aklinker1/check": "^2.2.0",
+    "@typescript/native-preview": "^7.0.0-dev.20251114.1",
     "@types/bun": "latest",
     "changelogen": "^0.6.2",
     "elysia": "^1.3.5",
@@ -59,7 +60,6 @@
     "prettier": "^3.5.3",
     "publint": "^0.3.12",
     "tinybench": "^4.0.1",
-    "typescript": "^5.8.3",
     "vitepress": "^2.0.0-alpha.12",
     "vitepress-plugin-mermaid": "^2.0.17",
     "zod": "^4.1.11"

package/src/app.ts

@@ -13,9 +13,14 @@ import type {
   DefaultAppData,
   BasePrefix,
   SchemaAdapter,
+  Transport,
 } from "./types";
 import { addRoute, createRouter, findRoute } from "rou3";
-import { callCtxModifierHooks, serializeErrorResponse } from "./internal/utils";
+import {
+  callCtxModifierHooks,
+  detectTransport,
+  serializeErrorResponse,
+} from "./internal/utils";
 import type { OpenAPIV3_1 } from "openapi-types";
 import { buildOpenApiDocs, buildScalarHtml } from "./open-api";
 
@@ -227,17 +232,8 @@ export function createApp<TPrefix extends BasePrefix = "">(
     },
 
     listen: (port, cb) => {
-      if (typeof Bun !== "undefined") {
-        Bun.serve({ port, fetch: app.build() });
-        if (cb) setTimeout(cb, 0);
-      } else if (
-        // @ts-expect-error: Deno types not installed.
-        typeof Deno !== "undefined"
-      ) {
-        // @ts-expect-error: Deno types not installed.
-        Deno.serve({ port, fetch: app.build() });
-        if (cb) setTimeout(cb, 0);
-      }
+      const transport = options?.transport ?? detectTransport();
+      transport.listen(port, app.build(), cb);
       return app;
     },
 
@@ -428,6 +424,24 @@ export type CreateAppOptions<TPrefix extends BasePrefix = ""> = {
    */
   schemaAdapter?: SchemaAdapter;
 
+  /**
+   * Tell Zeta how to serve your app over a port. By default, Zeta will detect
+   * if you're runtime is Bun or Deno, and use the appropriate transport.
+   *
+   * If you need to customize the transport, like adding an `idleTimeout` to
+   * bun, you can do so by passing options into the transport's factory function.
+   *
+   * @example
+   * ```ts
+   * import { createBunTransport } from "@aklinker1/zeta/transports/bun-transport"
+   *
+   * const app = createApp({
+   *   transport: createBunTransport(),
+   * });
+   * ```
+   */
+  transport?: Transport;
+
   /**
    * Where the OpenAPI JSON docs is hosted.
    * @default "/openapi.json"

package/src/internal/utils.ts

@@ -7,9 +7,12 @@ import type {
   MaybePromise,
   RouterData,
   StatusResult,
+  Transport,
 } from "../types";
 import type { MatchedRoute } from "rou3";
 import type { ErrorResponse } from "../custom-responses";
+import { createBunTransport } from "../transports/bun-transport";
+import { createDenoTransport } from "../transports/deno-transport";
 
 export function validateSchema<T>(
   schema: StandardSchemaV1<T, T>,
@@ -136,3 +139,22 @@ export const IsStatusResult = Symbol("IsStatusResult");
 export function isStatusResult(result: any): result is StatusResult {
   return IsStatusResult in result;
 }
+
+export function detectTransport(): Transport {
+  // @ts-ignore: Bun types may not be available
+  if (typeof Bun !== "undefined") return createBunTransport();
+  // @ts-ignore: Deno types may not be available
+  if (typeof Deno !== "undefined") return createDenoTransport();
+
+  throw Error(`Cannot automatically detect which transport to use. You must specify a transport in your top-level app:
+
+    ---
+    import { createBunTransport } from '@aklinker1/zeta/transports/bun-transport';
+
+    const app = createApp({
+      transport: createBunTransport(),
+    })
+
+    app.listen();
+    ---`);
+}

package/src/open-api.ts

@@ -193,6 +193,7 @@ function optimizeSpec(spec: OpenAPI.Document): OpenAPI.Document {
 
   // Optimizations
   addModelRefs(optimized);
+  sortComponentSchemas(optimized);
 
   return optimized;
 }
@@ -234,3 +235,13 @@ function addModelRefs(spec: any): void {
   // Process the "paths" object
   recurse(spec.paths);
 }
+
+function sortComponentSchemas(spec: any): void {
+  if (!spec?.components?.schemas) return;
+
+  spec.components.schemas = Object.fromEntries(
+    Object.entries(spec.components.schemas).sort((a, b) =>
+      a[0].toLowerCase().localeCompare(b[0].toLowerCase()),
+    ),
+  );
+}

package/src/types.ts

@@ -1042,6 +1042,14 @@ export interface SchemaAdapter {
   getMeta: (schema: StandardSchemaV1) => Record<string, any> | undefined;
 }
 
+//
+// TRANSPORTS
+//
+
+export interface Transport {
+  listen: (port: number, fetch: ServerSideFetch, cb?: () => void) => void;
+}
+
 //
 // SETTER
 //