@evjs/runtime 0.0.1-rc.2 → 0.0.1-rc.5

package/esm/client/transport.js

@@ -5,30 +5,35 @@
  * bundle, each exported function is replaced with a stub that calls
  * `__ev_call(fnId, args)`. This module provides that helper.
  */
-import { DEFAULT_RPC_ENDPOINT } from "../constants";
+import { jsonCodec } from "../codec";
+import { DEFAULT_CONTENT_TYPE, DEFAULT_ENDPOINT, DEFAULT_ERROR_STATUS, } from "../constants";
+import { ServerFunctionError } from "../errors";
 /**
  * Default fetch-based transport.
  */
-function createFetchTransport(baseUrl, endpoint) {
+function createFetchTransport(baseUrl, endpoint, codec = jsonCodec) {
     return {
         async send(fnId, args, context) {
             const url = `${baseUrl}${endpoint}`;
             const res = await fetch(url, {
                 method: "POST",
                 headers: {
-                    "Content-Type": "application/json",
+                    "Content-Type": codec.contentType ?? DEFAULT_CONTENT_TYPE,
                     ...context?.headers,
                 },
-                body: JSON.stringify({ fnId, args }),
+                body: codec.serialize({ fnId, args }),
                 signal: context?.signal,
             });
             if (!res.ok) {
                 const text = await res.text().catch(() => res.statusText);
-                throw new Error(`[ev] Server function "${fnId}" failed (${res.status}): ${text}`);
+                const name = getFnName(fnId);
+                throw new ServerFunctionError(`Server function "${name}" failed (${res.status}): ${text}`, fnId, res.status);
             }
-            const payload = await res.json();
+            const raw = await res.text();
+            const payload = codec.deserialize(raw);
             if (payload.error) {
-                throw new Error(`[ev] Server function "${fnId}" threw: ${payload.error}`);
+                const name = getFnName(fnId);
+                throw new ServerFunctionError(`Server function "${name}" threw: ${payload.error}`, payload.fnId ?? fnId, DEFAULT_ERROR_STATUS, { data: payload.data });
             }
             return payload.result;
         },
@@ -37,7 +42,7 @@ function createFetchTransport(baseUrl, endpoint) {
 let _transport = null;
 function getTransport() {
     if (!_transport) {
-        _transport = createFetchTransport("", DEFAULT_RPC_ENDPOINT);
+        _transport = createFetchTransport("", DEFAULT_ENDPOINT);
     }
     return _transport;
 }
@@ -45,12 +50,16 @@ function getTransport() {
  * Configure the server transport. Call once at app startup if you need to
  * customise the endpoint URL or provide a custom transport.
  */
-export function configureTransport(options) {
+export function initTransport(options) {
+    if (process.env.NODE_ENV !== "production" && _transport !== null) {
+        console.warn("[ev] initTransport() was called more than once. " +
+            "This overwrites the previous transport configuration.");
+    }
     if (options.transport) {
         _transport = options.transport;
     }
     else {
-        _transport = createFetchTransport(options.baseUrl ?? "", options.endpoint ?? DEFAULT_RPC_ENDPOINT);
+        _transport = createFetchTransport(options.baseUrl ?? "", options.endpoint ?? DEFAULT_ENDPOINT, options.codec);
     }
 }
 /**
@@ -69,13 +78,28 @@ export async function __ev_call(fnId, args, context) {
 // biome-ignore lint/suspicious/noExplicitAny: must accept any function shape
 const fnIdRegistry = new WeakMap();
 /**
- * Register a server function stub with its ID.
+ * Internal registry mapping function IDs to human-readable export names.
+ */
+const fnNameRegistry = new Map();
+/**
+ * Look up the human-readable export name for a function ID.
+ * Falls back to the fnId itself if no name is registered.
+ */
+export function getFnName(fnId) {
+    return fnNameRegistry.get(fnId) ?? fnId;
+}
+/**
+ * Register a server function stub with its ID and optional export name.
  *
  * @internal Called by build-tools codegen. Do not use directly.
  */
+export function __ev_register(
 // biome-ignore lint/suspicious/noExplicitAny: must accept any function shape
-export function __ev_register(fn, fnId) {
+fn, fnId, exportName) {
     fnIdRegistry.set(fn, fnId);
+    if (exportName) {
+        fnNameRegistry.set(fnId, exportName);
+    }
 }
 /**
  * Look up the internal function ID for a server function stub.

package/esm/client/transport.js.map

@@ -1 +1 @@
-{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/client/transport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAmDpD;;GAEG;AACH,SAAS,oBAAoB,CAC3B,OAAe,EACf,QAAgB;IAEhB,OAAO;QACL,KAAK,CAAC,IAAI,CACR,IAAY,EACZ,IAAe,EACf,OAAwB;YAExB,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,QAAQ,EAAE,CAAC;YAEpC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAC3B,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,GAAG,OAAO,EAAE,OAAO;iBACpB;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;gBACpC,MAAM,EAAE,OAAO,EAAE,MAAM;aACxB,CAAC,CAAC;YAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;gBAC1D,MAAM,IAAI,KAAK,CACb,yBAAyB,IAAI,aAAa,GAAG,CAAC,MAAM,MAAM,IAAI,EAAE,CACjE,CAAC;YACJ,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YAEjC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;gBAClB,MAAM,IAAI,KAAK,CACb,yBAAyB,IAAI,YAAY,OAAO,CAAC,KAAK,EAAE,CACzD,CAAC;YACJ,CAAC;YAED,OAAO,OAAO,CAAC,MAAM,CAAC;QACxB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,IAAI,UAAU,GAA2B,IAAI,CAAC;AAE9C,SAAS,YAAY;IACnB,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,UAAU,GAAG,oBAAoB,CAAC,EAAE,EAAE,oBAAoB,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAyB;IAC1D,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IACjC,CAAC;SAAM,CAAC;QACN,UAAU,GAAG,oBAAoB,CAC/B,OAAO,CAAC,OAAO,IAAI,EAAE,EACrB,OAAO,CAAC,QAAQ,IAAI,oBAAoB,CACzC,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,IAAY,EACZ,IAAe,EACf,OAAwB;IAExB,OAAO,YAAY,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,6EAA6E;AAC7E,MAAM,YAAY,GAAG,IAAI,OAAO,EAAmC,CAAC;AAEpE;;;;GAIG;AACH,6EAA6E;AAC7E,MAAM,UAAU,aAAa,CAAC,EAA2B,EAAE,IAAY;IACrE,YAAY,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,6EAA6E;AAC7E,MAAM,UAAU,OAAO,CAAC,EAA2B;IACjD,OAAO,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/client/transport.ts"],"names":[],"mappings":"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"}

package/esm/codec.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Pluggable codec interface for serialization/deserialization.
+ *
+ * By default the framework uses JSON. Implement this interface to use
+ * a custom codec (e.g. protobuf, msgpack, superjson, devalue).
+ *
+ * @example
+ * ```ts
+ * import superjson from "superjson";
+ *
+ * const superJsonCodec: Codec = {
+ *   contentType: "application/json",
+ *   serialize: (data) => superjson.stringify(data),
+ *   deserialize: (raw) => superjson.parse(raw as string),
+ * };
+ * ```
+ */
+export interface Codec {
+    /**
+     * Content-Type header value for the serialized format.
+     * Defaults to `"application/json"` when not specified.
+     */
+    contentType?: string;
+    /** Serialize a JS value for transmission. */
+    serialize(data: unknown): string | ArrayBuffer;
+    /** Deserialize a raw payload back to a JS value. */
+    deserialize(raw: string | ArrayBuffer): unknown;
+}
+/** Built-in JSON codec (the default). */
+export declare const jsonCodec: Codec;
+//# sourceMappingURL=codec.d.ts.map

package/esm/codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.d.ts","sourceRoot":"","sources":["../src/codec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,KAAK;IACpB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,6CAA6C;IAC7C,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,WAAW,CAAC;IAE/C,oDAAoD;IACpD,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,OAAO,CAAC;CACjD;AAED,yCAAyC;AACzC,eAAO,MAAM,SAAS,EAAE,KAIvB,CAAC"}

package/esm/codec.js

@@ -0,0 +1,7 @@
+/** Built-in JSON codec (the default). */
+export const jsonCodec = {
+    contentType: "application/json",
+    serialize: (data) => JSON.stringify(data),
+    deserialize: (raw) => JSON.parse(raw),
+};
+//# sourceMappingURL=codec.js.map

package/esm/codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.js","sourceRoot":"","sources":["../src/codec.ts"],"names":[],"mappings":"AA+BA,yCAAyC;AACzC,MAAM,CAAC,MAAM,SAAS,GAAU;IAC9B,WAAW,EAAE,kBAAkB;IAC/B,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;IACzC,WAAW,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAa,CAAC;CAChD,CAAC"}

package/esm/constants.d.ts

@@ -1,6 +1,10 @@
 /**
  * Shared constants for the ev runtime.
  */
-/** Default RPC endpoint path, shared between client and server. */
-export declare const DEFAULT_RPC_ENDPOINT = "/api/rpc";
+/** Default server function endpoint path, shared between client and server. */
+export declare const DEFAULT_ENDPOINT = "/api/fn";
+/** Default HTTP status code for server function errors. */
+export declare const DEFAULT_ERROR_STATUS = 500;
+/** Default content type for server function requests/responses. */
+export declare const DEFAULT_CONTENT_TYPE = "application/json";
 //# sourceMappingURL=constants.d.ts.map

package/esm/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,mEAAmE;AACnE,eAAO,MAAM,oBAAoB,aAAa,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAE1C,2DAA2D;AAC3D,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC,mEAAmE;AACnE,eAAO,MAAM,oBAAoB,qBAAqB,CAAC"}

package/esm/constants.js

@@ -1,6 +1,10 @@
 /**
  * Shared constants for the ev runtime.
  */
-/** Default RPC endpoint path, shared between client and server. */
-export const DEFAULT_RPC_ENDPOINT = "/api/rpc";
+/** Default server function endpoint path, shared between client and server. */
+export const DEFAULT_ENDPOINT = "/api/fn";
+/** Default HTTP status code for server function errors. */
+export const DEFAULT_ERROR_STATUS = 500;
+/** Default content type for server function requests/responses. */
+export const DEFAULT_CONTENT_TYPE = "application/json";
 //# sourceMappingURL=constants.js.map

package/esm/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,mEAAmE;AACnE,MAAM,CAAC,MAAM,oBAAoB,GAAG,UAAU,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,+EAA+E;AAC/E,MAAM,CAAC,MAAM,gBAAgB,GAAG,SAAS,CAAC;AAE1C,2DAA2D;AAC3D,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAExC,mEAAmE;AACnE,MAAM,CAAC,MAAM,oBAAoB,GAAG,kBAAkB,CAAC"}

package/esm/errors.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Error thrown when a server function call fails.
+ * Available on both client and server.
+ */
+export declare class ServerFunctionError extends Error {
+    /** The unique function ID. */
+    readonly fnId: string;
+    /** HTTP status code from the server. */
+    readonly status: number;
+    /** Structured error data from the server (if any). */
+    readonly data?: unknown;
+    constructor(message: string, fnId: string, status: number, options?: {
+        cause?: Error;
+        data?: unknown;
+    });
+}
+/**
+ * Throwable error for server functions to return structured error data.
+ *
+ * @example
+ * ```ts
+ * export async function getUser(id: string) {
+ *   const user = db.find(id);
+ *   if (!user) throw new ServerError("User not found", { status: 404, data: { id } });
+ *   return user;
+ * }
+ * ```
+ */
+export declare class ServerError extends Error {
+    readonly status: number;
+    readonly data?: unknown;
+    constructor(message: string, options?: {
+        status?: number;
+        data?: unknown;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/esm/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,sDAAsD;IACtD,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;gBAGtB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE;CAS9C;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;gBAEZ,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE;CAM3E"}

package/esm/errors.js

@@ -0,0 +1,45 @@
+import { DEFAULT_ERROR_STATUS } from "./constants";
+/**
+ * Error thrown when a server function call fails.
+ * Available on both client and server.
+ */
+export class ServerFunctionError extends Error {
+    /** The unique function ID. */
+    fnId;
+    /** HTTP status code from the server. */
+    status;
+    /** Structured error data from the server (if any). */
+    data;
+    constructor(message, fnId, status, options) {
+        super(message);
+        this.name = "ServerFunctionError";
+        this.fnId = fnId;
+        this.status = status;
+        this.data = options?.data;
+        if (options?.cause)
+            this.cause = options.cause;
+    }
+}
+/**
+ * Throwable error for server functions to return structured error data.
+ *
+ * @example
+ * ```ts
+ * export async function getUser(id: string) {
+ *   const user = db.find(id);
+ *   if (!user) throw new ServerError("User not found", { status: 404, data: { id } });
+ *   return user;
+ * }
+ * ```
+ */
+export class ServerError extends Error {
+    status;
+    data;
+    constructor(message, options) {
+        super(message);
+        this.name = "ServerError";
+        this.status = options?.status ?? DEFAULT_ERROR_STATUS;
+        this.data = options?.data;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/esm/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD;;;GAGG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,8BAA8B;IACrB,IAAI,CAAS;IACtB,wCAAwC;IAC/B,MAAM,CAAS;IACxB,sDAAsD;IAC7C,IAAI,CAAW;IAExB,YACE,OAAe,EACf,IAAY,EACZ,MAAc,EACd,OAA2C;QAE3C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,CAAC;QAC1B,IAAI,OAAO,EAAE,KAAK;YAAE,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IACjD,CAAC;CACF;AAED;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,MAAM,CAAS;IACf,IAAI,CAAW;IAExB,YAAY,OAAe,EAAE,OAA6C;QACxE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,oBAAoB,CAAC;QACtD,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,CAAC;IAC5B,CAAC;CACF"}

package/esm/serializer.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Pluggable serialization interface.
+ *
+ * By default the framework uses JSON. Implement this interface to use
+ * a custom serializer (e.g. protobuf, msgpack, superjson, devalue).
+ *
+ * @example
+ * ```ts
+ * import superjson from "superjson";
+ *
+ * const superJsonSerializer: Serializer = {
+ *   contentType: "application/json",
+ *   serialize: (data) => superjson.stringify(data),
+ *   deserialize: (raw) => superjson.parse(raw as string),
+ * };
+ * ```
+ */
+export interface Serializer {
+    /**
+     * Content-Type header value for the serialized format.
+     * Defaults to `"application/json"` when not specified.
+     */
+    contentType?: string;
+    /** Serialize a JS value for transmission. */
+    serialize(data: unknown): string | ArrayBuffer;
+    /** Deserialize a raw payload back to a JS value. */
+    deserialize(raw: string | ArrayBuffer): unknown;
+}
+/** Built-in JSON serializer (the default). */
+export declare const jsonSerializer: Serializer;
+//# sourceMappingURL=serializer.d.ts.map

package/esm/serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.d.ts","sourceRoot":"","sources":["../src/serializer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,6CAA6C;IAC7C,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,WAAW,CAAC;IAE/C,oDAAoD;IACpD,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,OAAO,CAAC;CACjD;AAED,8CAA8C;AAC9C,eAAO,MAAM,cAAc,EAAE,UAI5B,CAAC"}

package/esm/serializer.js

@@ -0,0 +1,7 @@
+/** Built-in JSON serializer (the default). */
+export const jsonSerializer = {
+    contentType: "application/json",
+    serialize: (data) => JSON.stringify(data),
+    deserialize: (raw) => JSON.parse(raw),
+};
+//# sourceMappingURL=serializer.js.map

package/esm/serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.js","sourceRoot":"","sources":["../src/serializer.ts"],"names":[],"mappings":"AA+BA,8CAA8C;AAC9C,MAAM,CAAC,MAAM,cAAc,GAAe;IACxC,WAAW,EAAE,kBAAkB;IAC/B,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;IACzC,WAAW,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAa,CAAC;CAChD,CAAC"}

package/esm/server/app.d.ts

@@ -1,20 +1,22 @@
 /**
  * Server application factory.
  *
- * Creates a Hono app with RPC middleware.
+ * Creates a Hono app with server function handler.
  * This app is runtime-agnostic and can be mounted in Node, Edge, or Bun.
  */
 import { Hono } from "hono";
+import type { Codec } from "../codec";
 /** Options for createApp. */
 export interface CreateAppOptions {
-    /** RPC endpoint path. Defaults to "/api/rpc". */
-    rpcEndpoint?: string;
+    /** server function endpoint path. Defaults to "/api/fn". */
+    endpoint?: string;
+    /** Custom codec for the server function endpoint. Defaults to JSON. */
+    codec?: Codec;
 }
 /**
  * Create an ev API server application.
  *
- * Mounts the RPC middleware at `/api/rpc`.
- * In Stage 3, this will be extended with SSR middleware.
+ * Mounts the server function handler at the configured endpoint.
  *
  * @param options - Application configuration.
  * @returns A runtime-agnostic Hono app instance.

package/esm/server/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/server/app.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAI5B,6BAA6B;AAC7B,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAY1D"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/server/app.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAItC,6BAA6B;AAC7B,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAS1D"}

package/esm/server/app.js

@@ -1,28 +1,25 @@
 /**
  * Server application factory.
  *
- * Creates a Hono app with RPC middleware.
+ * Creates a Hono app with server function handler.
  * This app is runtime-agnostic and can be mounted in Node, Edge, or Bun.
  */
 import { Hono } from "hono";
-import { DEFAULT_RPC_ENDPOINT } from "../constants";
-import { createRpcMiddleware } from "./handler";
+import { DEFAULT_ENDPOINT } from "../constants";
+import { createHandler } from "./handler";
 /**
  * Create an ev API server application.
  *
- * Mounts the RPC middleware at `/api/rpc`.
- * In Stage 3, this will be extended with SSR middleware.
+ * Mounts the server function handler at the configured endpoint.
  *
  * @param options - Application configuration.
  * @returns A runtime-agnostic Hono app instance.
  */
 export function createApp(options) {
-    const { rpcEndpoint = DEFAULT_RPC_ENDPOINT } = options ?? {};
+    const { endpoint = DEFAULT_ENDPOINT, codec } = options ?? {};
     const app = new Hono();
-    // Health check for load balancers / container orchestrators
-    app.get("/health", (c) => c.json({ status: "ok" }));
-    // Mount RPC endpoint
-    app.route(rpcEndpoint, createRpcMiddleware());
+    // Mount server function endpoint
+    app.route(endpoint, createHandler({ codec }));
     return app;
 }
 //# sourceMappingURL=app.js.map

package/esm/server/app.js.map

@@ -1 +1 @@
-{"version":3,"file":"app.js","sourceRoot":"","sources":["../../src/server/app.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAQhD;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CAAC,OAA0B;IAClD,MAAM,EAAE,WAAW,GAAG,oBAAoB,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IAE7D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IAEvB,4DAA4D;IAC5D,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAEpD,qBAAqB;IACrB,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,mBAAmB,EAAE,CAAC,CAAC;IAE9C,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../src/server/app.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAU1C;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,OAA0B;IAClD,MAAM,EAAE,QAAQ,GAAG,gBAAgB,EAAE,KAAK,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IAE7D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IAEvB,iCAAiC;IACjC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,aAAa,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAE9C,OAAO,GAAG,CAAC;AACb,CAAC"}

package/esm/server/dispatch.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Protocol-agnostic server function dispatcher.
+ *
+ * Looks up a registered server function by ID, invokes it with the
+ * given arguments, and returns a structured result. This is the core
+ * dispatch logic used by the HTTP handler and can be used directly
+ * to build custom transport adapters (WebSocket, IPC, etc.).
+ */
+/**
+ * Context passed to middleware functions.
+ */
+export interface MiddlewareContext {
+    /** The function ID being called. */
+    fnId: string;
+    /** The arguments passed to the function. */
+    args: unknown[];
+}
+/**
+ * Middleware function type.
+ * Call `next()` to proceed to the next middleware or the function itself.
+ *
+ * @example
+ * ```ts
+ * registerMiddleware(async (ctx, next) => {
+ *   console.log(`Calling ${ctx.fnId}`);
+ *   const start = Date.now();
+ *   const result = await next();
+ *   console.log(`${ctx.fnId} took ${Date.now() - start}ms`);
+ *   return result;
+ * });
+ * ```
+ */
+export type Middleware = (ctx: MiddlewareContext, next: () => Promise<unknown>) => Promise<unknown>;
+/**
+ * Register a middleware that wraps all server function calls.
+ * Middleware functions run in registration order.
+ */
+export declare function registerMiddleware(fn: Middleware): void;
+/** Successful dispatch result. */
+export interface DispatchSuccess {
+    result: unknown;
+}
+/** Failed dispatch result. */
+export interface DispatchError {
+    error: string;
+    fnId: string;
+    /** HTTP-equivalent status code for the error. */
+    status: number;
+    /** Structured error data (if thrown via ServerError). */
+    data?: unknown;
+}
+export type DispatchResult = DispatchSuccess | DispatchError;
+/**
+ * Dispatch an server function call to a registered server function.
+ *
+ * @param fnId - The unique function ID.
+ * @param args - The arguments to pass to the function.
+ * @returns A structured result: `{ result }` on success, `{ error, fnId, status }` on failure.
+ *
+ * @example
+ * ```ts
+ * // WebSocket adapter
+ * ws.on("message", async (data) => {
+ *   const { fnId, args } = JSON.parse(data);
+ *   const response = await dispatch(fnId, args);
+ *   ws.send(JSON.stringify(response));
+ * });
+ * ```
+ */
+export declare function dispatch(fnId: string, args: unknown[]): Promise<DispatchResult>;
+//# sourceMappingURL=dispatch.d.ts.map

package/esm/server/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/server/dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,IAAI,EAAE,OAAO,EAAE,CAAC;CACjB;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,UAAU,GAAG,CACvB,GAAG,EAAE,iBAAiB,EACtB,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,KACzB,OAAO,CAAC,OAAO,CAAC,CAAC;AAItB;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,UAAU,GAAG,IAAI,CAEvD;AAED,kCAAkC;AAClC,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,8BAA8B;AAC9B,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG,aAAa,CAAC;AAE7D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EAAE,GACd,OAAO,CAAC,cAAc,CAAC,CA4CzB"}

package/esm/server/dispatch.js

@@ -0,0 +1,80 @@
+/**
+ * Protocol-agnostic server function dispatcher.
+ *
+ * Looks up a registered server function by ID, invokes it with the
+ * given arguments, and returns a structured result. This is the core
+ * dispatch logic used by the HTTP handler and can be used directly
+ * to build custom transport adapters (WebSocket, IPC, etc.).
+ */
+import { DEFAULT_ERROR_STATUS } from "../constants";
+import { ServerError } from "../errors";
+import { registry } from "./register";
+const middlewares = [];
+/**
+ * Register a middleware that wraps all server function calls.
+ * Middleware functions run in registration order.
+ */
+export function registerMiddleware(fn) {
+    middlewares.push(fn);
+}
+/**
+ * Dispatch an server function call to a registered server function.
+ *
+ * @param fnId - The unique function ID.
+ * @param args - The arguments to pass to the function.
+ * @returns A structured result: `{ result }` on success, `{ error, fnId, status }` on failure.
+ *
+ * @example
+ * ```ts
+ * // WebSocket adapter
+ * ws.on("message", async (data) => {
+ *   const { fnId, args } = JSON.parse(data);
+ *   const response = await dispatch(fnId, args);
+ *   ws.send(JSON.stringify(response));
+ * });
+ * ```
+ */
+export async function dispatch(fnId, args) {
+    if (!fnId || typeof fnId !== "string") {
+        return {
+            error: "Missing or invalid 'fnId' in request body",
+            fnId: fnId ?? "",
+            status: 400,
+        };
+    }
+    const fn = registry.get(fnId);
+    if (!fn) {
+        return {
+            error: `Server function "${fnId}" not found`,
+            fnId,
+            status: 404,
+        };
+    }
+    try {
+        // Build middleware chain
+        let index = 0;
+        const runFn = () => fn(...args);
+        const next = () => {
+            if (index < middlewares.length) {
+                const mw = middlewares[index++];
+                return mw({ fnId, args }, next);
+            }
+            return runFn();
+        };
+        const result = await next();
+        return { result };
+    }
+    catch (err) {
+        if (err instanceof ServerError) {
+            return {
+                error: err.message,
+                fnId,
+                status: err.status,
+                data: err.data,
+            };
+        }
+        const message = err instanceof Error ? err.message : String(err);
+        return { error: message, fnId, status: DEFAULT_ERROR_STATUS };
+    }
+}
+//# sourceMappingURL=dispatch.js.map

package/esm/server/dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../../src/server/dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAgCtC,MAAM,WAAW,GAAiB,EAAE,CAAC;AAErC;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,EAAc;IAC/C,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACvB,CAAC;AAmBD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,IAAY,EACZ,IAAe;IAEf,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO;YACL,KAAK,EAAE,2CAA2C;YAClD,IAAI,EAAE,IAAI,IAAI,EAAE;YAChB,MAAM,EAAE,GAAG;SACZ,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,OAAO;YACL,KAAK,EAAE,oBAAoB,IAAI,aAAa;YAC5C,IAAI;YACJ,MAAM,EAAE,GAAG;SACZ,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,yBAAyB;QACzB,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QAChC,MAAM,IAAI,GAAG,GAAqB,EAAE;YAClC,IAAI,KAAK,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC;gBAC/B,MAAM,EAAE,GAAG,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC;gBAChC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;YAClC,CAAC;YACD,OAAO,KAAK,EAAE,CAAC;QACjB,CAAC,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;QAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;IACpB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,WAAW,EAAE,CAAC;YAC/B,OAAO;gBACL,KAAK,EAAE,GAAG,CAAC,OAAO;gBAClB,IAAI;gBACJ,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,IAAI,EAAE,GAAG,CAAC,IAAI;aACf,CAAC;QACJ,CAAC;QACD,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAChE,CAAC;AACH,CAAC"}

package/esm/server/environments/ecma.d.ts

@@ -4,7 +4,7 @@ import type { Hono } from "hono";
  *
  * Exports the Hono app's fetch handler as a standard ECMA-compatible
  * module. Works in any runtime that supports the Fetch API standard
- * (Deno, Bun, Cloudflare Workers, Vercel Edge, etc.).
+ * (Deno, Bun, or any Fetch-compatible runtime.).
  *
  * Usage:
  * ```ts
@@ -13,7 +13,7 @@ import type { Hono } from "hono";
  * export default createHandler(app);
  * ```
  */
-export declare function createHandler(app: Hono): {
+export declare function createFetchHandler(app: Hono): {
     fetch: (request: Request, Env?: unknown, executionCtx?: import("hono").ExecutionContext) => Response | Promise<Response>;
 };
 //# sourceMappingURL=ecma.d.ts.map

package/esm/server/environments/ecma.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ecma.d.ts","sourceRoot":"","sources":["../../../src/server/environments/ecma.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,IAAI;;EAItC"}
+{"version":3,"file":"ecma.d.ts","sourceRoot":"","sources":["../../../src/server/environments/ecma.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,IAAI;;EAI3C"}

package/esm/server/environments/ecma.js

@@ -3,7 +3,7 @@
  *
  * Exports the Hono app's fetch handler as a standard ECMA-compatible
  * module. Works in any runtime that supports the Fetch API standard
- * (Deno, Bun, Cloudflare Workers, Vercel Edge, etc.).
+ * (Deno, Bun, or any Fetch-compatible runtime.).
  *
  * Usage:
  * ```ts
@@ -12,7 +12,7 @@
  * export default createHandler(app);
  * ```
  */
-export function createHandler(app) {
+export function createFetchHandler(app) {
     return {
         fetch: app.fetch,
     };

package/esm/server/environments/ecma.js.map

@@ -1 +1 @@
-{"version":3,"file":"ecma.js","sourceRoot":"","sources":["../../../src/server/environments/ecma.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa,CAAC,GAAS;IACrC,OAAO;QACL,KAAK,EAAE,GAAG,CAAC,KAAK;KACjB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"ecma.js","sourceRoot":"","sources":["../../../src/server/environments/ecma.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAS;IAC1C,OAAO;QACL,KAAK,EAAE,GAAG,CAAC,KAAK;KACjB,CAAC;AACJ,CAAC"}

package/esm/server/environments/node.d.ts

@@ -4,11 +4,10 @@ export interface NodeRunnerOptions {
     host?: string;
 }
 /**
- * Runner plugin for Node.js environments.
- * Takes a compiled Hono app and starts a native Node HTTP server.
+ * Start a Node.js HTTP server for the given Hono app.
  *
  * Port resolution order: options.port → PORT env → 3001 default.
  * Registers SIGTERM/SIGINT handlers for graceful shutdown.
  */
-export declare function runNodeServer(app: Hono, options?: NodeRunnerOptions): import("@hono/node-server").ServerType;
+export declare function serve(app: Hono, options?: NodeRunnerOptions): import("@hono/node-server").ServerType;
 //# sourceMappingURL=node.d.ts.map