@aklinker1/zeta 2.1.2 → 2.1.3

package/dist/types.d.mts

@@ -0,0 +1,2 @@
+import { $ as SchemaAdapter, A as LifeCycleHookName, B as OnGlobalAfterResponseHook, C as GetResponseInputFromDef, D as GetRouteHandler, E as GetResponseStatusMap, F as MergeAppData, G as OnMapResponseContext, H as OnGlobalErrorHook, I as MergeRoutes, J as OnTransformHook, K as OnMapResponseHook, L as OnAfterHandleHook, M as MaybePromise, N as Merge, O as GetRouteHandlerReturnType, P as MergeApp, Q as RouterData, R as OnBeforeHandleContext, S as GetResponseInput, T as GetResponseOutputFromDef, U as OnGlobalRequestContext, V as OnGlobalErrorContext, W as OnGlobalRequestHook, X as RouteDef, Y as PrefixObjectKeys, Z as RouteHandler, _ as GetAppRoutes, a as AppData, at as Transport, b as GetRequestParamsOutput, c as BaseCtx, d as BaseRoutes, et as ServerSideFetch, f as BuildHandlerContext, g as GetAppDataCtx, h as GetAppData, i as App, it as StatusResult, j as LifeCycleHooks, k as LifeCycleHook, l as BasePath, m as DefaultAppData, n as AfterResponseContext, nt as Simplify, o as ApplyAppDataPrefix, ot as UseApp, p as CompiledRouteHandler, q as OnTransformContext, r as AnyDef, rt as StatusFn, s as ApplyAppPrefix, st as UseAppData, t as AfterHandleContext, tt as Setter, u as BasePrefix, v as GetRequestParamsInput, w as GetResponseOutput, x as GetRequestParamsOutputFromDef, y as GetRequestParamsInputFromDef, z as OnBeforeHandleHook } from "./types-D9oRVe1E.mjs";
+export { AfterHandleContext, AfterResponseContext, AnyDef, App, AppData, ApplyAppDataPrefix, ApplyAppPrefix, BaseCtx, BasePath, BasePrefix, BaseRoutes, BuildHandlerContext, CompiledRouteHandler, DefaultAppData, GetAppData, GetAppDataCtx, GetAppRoutes, GetRequestParamsInput, GetRequestParamsInputFromDef, GetRequestParamsOutput, GetRequestParamsOutputFromDef, GetResponseInput, GetResponseInputFromDef, GetResponseOutput, GetResponseOutputFromDef, GetResponseStatusMap, GetRouteHandler, GetRouteHandlerReturnType, LifeCycleHook, LifeCycleHookName, LifeCycleHooks, MaybePromise, Merge, MergeApp, MergeAppData, MergeRoutes, OnAfterHandleHook, OnBeforeHandleContext, OnBeforeHandleHook, OnGlobalAfterResponseHook, OnGlobalErrorContext, OnGlobalErrorHook, OnGlobalRequestContext, OnGlobalRequestHook, OnMapResponseContext, OnMapResponseHook, OnTransformContext, OnTransformHook, PrefixObjectKeys, RouteDef, RouteHandler, RouterData, SchemaAdapter, ServerSideFetch, Setter, Simplify, StatusFn, StatusResult, Transport, UseApp, UseAppData };

package/dist/types.mjs

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,27 +1,48 @@
 {
   "name": "@aklinker1/zeta",
   "description": "Composable, testable, OpenAPI-first backend framework with validation built-in",
-  "version": "2.1.2",
+  "version": "2.1.3",
   "type": "module",
   "license": "MIT",
   "packageManager": "bun@1.3.5",
-  "module": "src/index.ts",
-  "types": "src/index.ts",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.mts",
   "exports": {
-    ".": "./src/index.ts",
-    "./types": "./src/types.ts",
-    "./client": "./src/client.ts",
-    "./testing": "./src/testing.ts",
-    "./schema": "./src/schema.ts",
-    "./adapters/zod-schema-adapter": "./src/adapters/zod-schema-adapter.ts",
-    "./transports/bun-transport": "./src/transports/bun-transport.ts",
-    "./transports/deno-transport": "./src/transports/deno-transport.ts"
+    ".": {
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    },
+    "./types": {
+      "types": "./dist/types.d.mts",
+      "default": "./dist/types.mjs"
+    },
+    "./client": {
+      "types": "./dist/client.d.mts",
+      "default": "./dist/client.mjs"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.mts",
+      "default": "./dist/testing.mjs"
+    },
+    "./schema": {
+      "types": "./dist/schema.d.mts",
+      "default": "./dist/schema.mjs"
+    },
+    "./adapters/zod-schema-adapter": {
+      "types": "./dist/adapters/zod-schema-adapter.d.mts",
+      "default": "./dist/adapters/zod-schema-adapter.mjs"
+    },
+    "./transports/bun-transport": {
+      "types": "./dist/transports/bun-transport.d.mts",
+      "default": "./dist/transports/bun-transport.mjs"
+    },
+    "./transports/deno-transport": {
+      "types": "./dist/transports/deno-transport.d.mts",
+      "default": "./dist/transports/deno-transport.mjs"
+    }
   },
   "files": [
-    "src/*.ts",
-    "src/adapters/*.ts",
-    "src/internal/*.ts",
-    "src/transports/*.ts"
+    "dist/*"
   ],
   "publishConfig": {
     "access": "public"
@@ -37,7 +58,7 @@
   ],
   "scripts": {
     "dev": "bun test --watch",
-    "build": "echo 'Noop - nothing to build.'",
+    "build": "tsdown src/{index,types,client,testing,schema,adapters/zod-schema-adapter,transports/bun-transport,transports/deno-transport}.ts",
     "bench": "bun run src/__tests__/bench.ts",
     "example": "bun --watch run example.ts",
     "example:prod": "NODE_ENV=production bun run example",
@@ -72,6 +93,7 @@
     "prettier": "^3.5.3",
     "publint": "^0.3.12",
     "tinybench": "^4.0.1",
+    "tsdown": "^0.21.2",
     "vitepress": "^2.0.0-alpha.12",
     "vitepress-plugin-mermaid": "^2.0.17",
     "zod": "^4.1.11"

package/src/adapters/zod-schema-adapter.ts

@@ -1,29 +0,0 @@
-/**
- * Contains a schema adapter for app's using [`zod`](https://npmjs.com/package/zod).
- * @module
- */
-import { z } from "zod";
-import type { SchemaAdapter } from "../types";
-
-/**
- * Usage:
- *
- * ```ts
- * import { zodSchemaAdapter } from "@aklinker1/zeta/adapters/zod-schema-adapter";
- *
- * const app = createApp({
- *   schemaAdapter: zodSchemaAdapter,
- * });
- * ```
- */
-export const zodSchemaAdapter: SchemaAdapter = {
-  toJsonSchema: (schema) => {
-    if (!("_zod" in schema)) throw Error("input schema is not a Zod schema");
-    const res = z.toJSONSchema(schema, { target: "openapi-3.0" });
-    delete res.$schema;
-    return res;
-  },
-  getMeta: (schema: any) => {
-    return z.globalRegistry.get(schema);
-  },
-};

package/src/app.ts

@@ -1,479 +0,0 @@
-import type { OpenAPI, OpenAPIV3_1 } from "openapi-types";
-import { addRoute, createRouter } from "rou3";
-import { compileRouter } from "rou3/compiler";
-import { compileFetchFunction } from "./internal/compile-fetch-function";
-import { compileRouteHandler } from "./internal/compile-route-handler";
-import { detectTransport } from "./internal/utils";
-import { buildOpenApiDocs, buildScalarHtml } from "./open-api";
-import type {
-  App,
-  BasePath,
-  BasePrefix,
-  DefaultAppData,
-  LifeCycleHook,
-  LifeCycleHookName,
-  RouteDef,
-  RouterData,
-  SchemaAdapter,
-  ServerSideFetch,
-  Transport,
-} from "./types";
-
-let appIdInc = 0;
-const nextAppId = () => `app-${appIdInc++}`;
-
-let _hookIdInc = 0;
-const nextHookId = (appId: string) => `${appId}/hook-${_hookIdInc++}`;
-
-/**
- * Create a server-side, Zeta application.
- *
- * Zeta provides simple support for serving applications using `Bun.serve` and
- * `Deno.serve` by calling `app.listen(3000)`.
- *
- * If you need more customization, you can use the `build` method to create a
- * `fetch` function and serve it however you like.
- *
- * @example
- * ```ts
- * import { createApp } from "@aklinker1/zeta";
- *
- * const app = createApp({ prefix: "/api" })
- *   .get("/health", () => "OK")
- *   .get("/users", () => ["user1", "user2"]);
- *
- * app.listen(3000);
- *
- * // Or serve the app yourself
- * const fetch = app.build();
- * Bun.serve({ fetch, ... });
- * Deno.serve({ fetch, ... });
- * ```
- *
- * @param options Configure application behavior.
- */
-export function createApp<TPrefix extends BasePrefix = "">(
-  options?: CreateAppOptions<TPrefix>,
-): App<{
-  ctx: {};
-  exported: false;
-  prefix: TPrefix;
-  routes: {};
-}> {
-  const appId = nextAppId();
-
-  const { origin = "http://localhost", prefix = "" } = options ?? {};
-  const hooks: App["~zeta"]["hooks"] = {};
-  const routes: App["~zeta"]["routes"] = {};
-
-  const addRoutesEntry = (method: string, route: string, data: RouterData) => {
-    routes[method] ??= {};
-    if (routes[method][route]) {
-      console.warn(`Route ${route} already exists`);
-    }
-    routes[method][route] = data;
-  };
-
-  const cloneHooks = (): App["~zeta"]["hooks"] => {
-    const cloned: App["~zeta"]["hooks"] = {};
-    for (const key of Object.keys(hooks) as LifeCycleHookName[]) {
-      if (hooks[key]) cloned[key] = [...hooks[key]] as any;
-    }
-    return cloned;
-  };
-
-  const app: App<DefaultAppData> = {
-    // @ts-expect-error
-    [Symbol.toStringTag]: "ZetaApp",
-
-    "~zeta": {
-      id: appId,
-      prefix,
-      routes,
-      hooks,
-    },
-
-    build: () => {
-      const jsonRoute = options?.openApiRoute ?? "/openapi.json";
-      const scalarRoute = options?.scalarRoute ?? "/scalar";
-      const docs = buildOpenApiDocs(options, app);
-      if (docs.type === "error") {
-        console.error("Failed to build OpenAPI docs:", docs.error);
-      }
-
-      app.get(jsonRoute, () => {
-        if (docs.type === "error") {
-          console.error("Failed to build OpenAPI docs:", docs.error);
-          throw docs.error;
-        }
-        return docs.spec;
-      });
-      if (docs.type === "success") {
-        const scalarHtml = buildScalarHtml(jsonRoute, options);
-        app.get(
-          scalarRoute,
-          () =>
-            new Response(scalarHtml, {
-              headers: { "content-type": "text/html;charset=utf-8" },
-            }),
-        );
-      }
-
-      const router = createRouter<RouterData>();
-      for (const [method, methodValue] of Object.entries(routes)) {
-        for (const [path, data] of Object.entries(methodValue)) {
-          addRoute(
-            router,
-            method === Method.Any ? undefined : method,
-            path,
-            data,
-          );
-        }
-      }
-
-      const getRoute = compileRouter(router);
-      return compileFetchFunction({ getRoute, hooks, origin });
-    },
-
-    getOpenApiSpec: () => {
-      const res = buildOpenApiDocs(options, app);
-      if (res.type === "error") throw res.error;
-
-      return res.spec;
-    },
-
-    export: () => {
-      app["~zeta"].exported = true;
-      return app as any;
-    },
-
-    listen: (port, cb) => {
-      const transport = options?.transport ?? detectTransport();
-      transport.listen(port, app.build(), cb);
-      return app;
-    },
-
-    decorate: (...args: any[]) => {
-      const obj: Record<string, any> =
-        args.length === 2 ? { [args[0]]: args[1] } : args[0];
-
-      hooks.onTransform ??= [];
-      hooks.onTransform.push({
-        id: nextHookId(appId),
-        applyTo: "local",
-        callback: () => obj,
-      });
-
-      return app;
-    },
-
-    onGlobalRequest(callback: any) {
-      hooks.onGlobalRequest ??= [];
-      hooks.onGlobalRequest.push({
-        id: nextHookId(appId),
-        applyTo: "global",
-        callback,
-      });
-      return app;
-    },
-    onTransform(callback: any) {
-      hooks.onTransform ??= [];
-      hooks.onTransform.push({
-        id: nextHookId(appId),
-        applyTo: "local",
-        callback,
-      });
-      return app;
-    },
-    onBeforeHandle(callback: any) {
-      hooks.onBeforeHandle ??= [];
-      hooks.onBeforeHandle.push({
-        id: nextHookId(appId),
-        applyTo: "local",
-        callback,
-      });
-      return app;
-    },
-    onAfterHandle(callback: any) {
-      hooks.onAfterHandle ??= [];
-      hooks.onAfterHandle.push({
-        id: nextHookId(appId),
-        applyTo: "local",
-        callback,
-      });
-      return app;
-    },
-    onMapResponse(callback: any) {
-      hooks.onMapResponse ??= [];
-      hooks.onMapResponse.push({
-        id: nextHookId(appId),
-        applyTo: "local",
-        callback,
-      });
-      return app;
-    },
-    onGlobalError(callback: any) {
-      hooks.onGlobalError ??= [];
-      hooks.onGlobalError.push({
-        id: nextHookId(appId),
-        applyTo: "global",
-        callback,
-      });
-      return app;
-    },
-    onGlobalAfterResponse(callback: any) {
-      hooks.onGlobalAfterResponse ??= [];
-      hooks.onGlobalAfterResponse.push({
-        id: nextHookId(appId),
-        applyTo: "global",
-        callback,
-      });
-      return app;
-    },
-
-    get: (...args: any[]) =>
-      app.method.apply(app, [Method.Get, ...args] as any) as any,
-    post: (...args: any[]) =>
-      app.method.apply(app, [Method.Post, ...args] as any) as any,
-    put: (...args: any[]) =>
-      app.method.apply(app, [Method.Put, ...args] as any) as any,
-    delete: (...args: any[]) =>
-      app.method.apply(app, [Method.Delete, ...args] as any) as any,
-    any: (...args: any[]) =>
-      app.method.apply(app, [Method.Any, ...args] as any) as any,
-
-    method(method: string, path: BasePath, ...args: any[]) {
-      const routeDef: RouteDef | undefined =
-        args.length === 2 ? args[0] : undefined;
-      const handler = args[1] ?? args[0];
-      const route = `${prefix}${path}`;
-      const hooks = cloneHooks();
-
-      // Merge app-level tags and security into route definition
-      const def: RouteDef | undefined = mergeAppDefaults(routeDef, options);
-
-      const compiledHandler = compileRouteHandler({
-        schemaAdapter: options?.schemaAdapter,
-        def,
-        hooks,
-        method,
-        route,
-        handler,
-      });
-      addRoutesEntry(method, route, {
-        def,
-        route,
-        hooks,
-        compiledHandler,
-        handler,
-      });
-      return app;
-    },
-
-    mount(...args: any[]) {
-      let path = "";
-      let routeDef: RouteDef = {};
-      let fetch: ServerSideFetch;
-
-      if (args.length === 1) {
-        fetch = args[0];
-      } else if (args.length === 2) {
-        path = args[0];
-        fetch = args[1];
-      } else {
-        path = args[0];
-        routeDef = args[1];
-        fetch = args[2];
-      }
-
-      const route = `${prefix}${path}/**`;
-      const hooks = cloneHooks();
-
-      // Merge app-level tags and security into route definition
-      const def = mergeAppDefaults(routeDef, options);
-
-      const compiledHandler = compileRouteHandler({
-        schemaAdapter: options?.schemaAdapter,
-        hooks,
-        method: "ANY",
-        route,
-        fetch,
-        def,
-      });
-
-      addRoutesEntry(Method.Any, route, {
-        def,
-        fetch,
-        route,
-        hooks,
-        compiledHandler,
-      });
-
-      return app as any;
-    },
-
-    use: (childApp) => {
-      // Bring in routes
-      for (const [method, methodValue] of Object.entries(
-        childApp["~zeta"].routes,
-      )) {
-        for (const [subRoute, routeValue] of Object.entries(methodValue)) {
-          const route = `${prefix}${subRoute}`;
-          addRoutesEntry(method, route, { ...routeValue, route });
-        }
-      }
-
-      // Add the child's global hooks to parent
-      for (const hookName of Object.keys(
-        childApp["~zeta"].hooks,
-      ) as LifeCycleHookName[]) {
-        for (const hook of childApp["~zeta"].hooks[
-          hookName
-        ]! as LifeCycleHook<any>[]) {
-          if (hook.applyTo !== "global" && !childApp["~zeta"].exported)
-            continue;
-
-          if (hooks[hookName]) {
-            // Don't add a hook if it's already there
-            if (!hooks[hookName].includes(hook)) hooks[hookName].push(hook);
-          } else {
-            hooks[hookName] = [hook];
-          }
-        }
-      }
-
-      return app as any;
-    },
-  };
-
-  return app as any;
-}
-
-/**
- * Configure how the app is created.
- */
-export type CreateAppOptions<TPrefix extends BasePrefix = ""> = {
-  /**
-   * The origin to use when constructing URLs.
-   * @default "http://localhost"
-   */
-  origin?: string;
-
-  /**
-   * Add a prefix to the beginning of all routes in the app.
-   */
-  prefix?: TPrefix;
-
-  /**
-   * Tell Zeta which library you're using for validation. OpenAPI docs cannot
-   * be served without a schema adapter.
-   *
-   * @example
-   * ```ts
-   * import { zodSchemaAdapter } from "@aklinker1/zeta/adapters/zod-schema-adapter"
-   *
-   * const app = createApp({
-   *   openApi: {
-   *     schemaAdapter: zodSchemaAdapter,
-   *   },
-   * });
-   * ```
-   */
-  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"
-   */
-  openApiRoute?: BasePath;
-  /**
-   * Where the Scalar UI is hosted.
-   * @default "/scalar"
-   */
-  scalarRoute?: BasePath;
-
-  /** Configure how your application's OpenAPI docs are generated. */
-  openApi?: Partial<OpenAPIV3_1.Document> & {};
-
-  /**
-   * OpenAPI tags to apply to all routes in this app. Route-level tags will
-   * override these app-level tags.
-   *
-   * @example
-   * ```ts
-   * const usersApp = createApp({
-   *   prefix: "/users",
-   *   tags: ["Users"],
-   * })
-   *   .get("/", {}, () => [...])  // Will have ["Users"] tag
-   *   .get("/:id", { tags: ["Admin"] }, () => {...})  // Will have ["Admin"] tag (overrides app-level)
-   * ```
-   */
-  tags?: string[];
-
-  /**
-   * OpenAPI security requirements to apply to all routes in this app.
-   * Route-level security will override these app-level security requirements.
-   *
-   * @example
-   * ```ts
-   * const authApp = createApp({
-   *   prefix: "/auth",
-   *   security: [{ bearerAuth: [] }],
-   * })
-   *   .get("/profile", {}, () => {...})  // Will require bearerAuth
-   *   .get("/admin", { security: [{ adminKey: [] }] }, () => {...})  // Will require adminKey (overrides app-level)
-   * ```
-   */
-  security?: OpenAPI.Document["security"];
-  /**
-   * Configure [Scalar](https://scalar.com/) UI docs.
-   * @see https://github.com/scalar/scalar/blob/main/documentation/configuration.md#list-of-all-attributes
-   */
-  scalar?: any;
-};
-
-/**
- * Apply app-level defaults (tags, security) to a route definition.
- * Route-level values override app-level defaults.
- */
-function mergeAppDefaults(
-  routeDef: RouteDef | undefined,
-  options: CreateAppOptions<any> | undefined,
-): RouteDef | undefined {
-  if (!options?.tags?.length && !options?.security?.length) {
-    return routeDef;
-  }
-
-  return {
-    tags: options.tags,
-    security: options.security,
-    ...routeDef,
-  };
-}
-
-enum Method {
-  Get = "GET",
-  Post = "POST",
-  Put = "PUT",
-  Delete = "DELETE",
-  Any = "ANY",
-}