@evjs/runtime 0.0.1-alpha.5 → 0.0.1-alpha.7

package/README.md

@@ -1,6 +1,6 @@
 # @evjs/runtime
 
-Core runtime for the **ev** framework. It provides isomorphic utilities for client-side routing, state management, and server-side RPC handling via Hono.
+Core runtime for the **ev** framework. Provides client-side routing, data fetching, and server-side handling via Hono.
 
 ## Installation
 
@@ -8,32 +8,91 @@ Core runtime for the **ev** framework. It provides isomorphic utilities for clie
 npm install @evjs/runtime
 ```
 
-## Features
+## Exports
 
-- **`createApp`**: A unified factory to bootstrap TanStack Router + Query.
-- **Routing**: Re-exports the full power of `@tanstack/react-router`.
-- **RPC**: Internal logic for calling `"use server"` functions from the client.
-- **Hono Server**: `createServer()` starts a Hono-based API server for RPC.
+### `@evjs/runtime/client`
+
+| Export | Description |
+|--------|-------------|
+| `createApp` | Bootstrap TanStack Router + Query + DOM |
+| `query(fn)` | Universal query proxy for server functions |
+| `mutation(fn)` | Universal mutation proxy for server functions |
+| `createQueryProxy(module)` | Module-level query proxy |
+| `createMutationProxy(module)` | Module-level mutation proxy |
+| `configureTransport` | Set custom transport (fetch, axios, WebSocket) |
+| `createRootRoute`, `createRoute`, `Link`, `Outlet`, ... | Re-exports from `@tanstack/react-router` |
+| `useQuery`, `useMutation`, `useQueryClient`, ... | Re-exports from `@tanstack/react-query` |
+
+### `@evjs/runtime/server`
+
+| Export | Description |
+|--------|-------------|
+| `createApp` | Create a Hono app with RPC middleware |
+| `runNodeServer` | Start the app on Node.js (default port 3001) |
+| `registerServerFn` | Register a server function in the RPC registry |
+| `createRpcMiddleware` | Standalone Hono sub-app for RPC dispatch |
 
 ## Usage
 
-### Client Entry
+### Client
 
 ```tsx
-import { createApp, createRootRoute } from "@evjs/runtime";
+import { createApp, createRootRoute, query, mutation } from "@evjs/runtime/client";
+import { getUsers, createUser } from "./api/users.server";
+
+function Users() {
+  const { data } = query(getUsers).useQuery([]);
+  const { mutate } = mutation(createUser).useMutation();
+}
 
 const rootRoute = createRootRoute({ component: Root });
 const app = createApp({ routeTree: rootRoute });
-
 app.render("#app");
 ```
 
-### Server Entry
+### Server
+
+The server app is a runtime-agnostic Hono instance. Use a Runner to start it:
 
 ```ts
-import { createServer } from "@evjs/runtime/server";
+import { createApp, runNodeServer } from "@evjs/runtime/server";
 
-createServer({ port: 3001 });
+const app = createApp();
+runNodeServer(app, { port: 3001 });
 ```
 
-The Hono server mounts an RPC endpoint at `/api/rpc` (configurable via `rpcEndpoint`). Server functions are auto-discovered by `EvWebpackPlugin` — no manual imports needed.
+In development, `ev dev` with `runner` configured in `EvWebpackPlugin` handles this automatically.
+
+### Custom Transport
+
+```ts
+import { configureTransport } from "@evjs/runtime/client";
+
+configureTransport({
+  transport: {
+    send: async (fnId, args) => {
+      const { data } = await axios.post("/api/rpc", { fnId, args });
+      return data.result;
+    },
+  },
+});
+```
+
+### Query Proxy Patterns
+
+```tsx
+// A. Direct wrapper (single function)
+const { data } = query(getUsers).useQuery([]);
+
+// B. Module proxy (feature-based API)
+import * as UsersAPI from "./api/users.server";
+const users = {
+  query: createQueryProxy(UsersAPI),
+  mutation: createMutationProxy(UsersAPI),
+};
+users.query.getUsers.useQuery([]);
+
+// C. queryOptions (for prefetching, etc.)
+const options = query(getUsers).queryOptions([id]);
+queryClient.prefetchQuery(options);
+```

package/esm/client/index.d.ts

@@ -1,9 +1,11 @@
 /**
  * Client-side runtime utilities.
  */
+export * from "@tanstack/react-query";
 export type { App, CreateAppOptions } from "./create-app";
 export { createApp } from "./create-app";
+export * from "./query";
 export * from "./route";
-export { __ev_rpc, configureRpc } from "./rpc";
-export type { RpcOptions } from "./rpc";
+export type { RequestContext, ServerTransport, TransportOptions, } from "./transport";
+export { configureTransport } from "./transport";
 //# sourceMappingURL=index.d.ts.map

package/esm/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,GAAG,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAC/C,YAAY,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,uBAAuB,CAAC;AACtC,YAAY,EAAE,GAAG,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,YAAY,EACV,cAAc,EACd,eAAe,EACf,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}

package/esm/client/index.js

@@ -1,7 +1,9 @@
 /**
  * Client-side runtime utilities.
  */
+export * from "@tanstack/react-query";
 export { createApp } from "./create-app";
+export * from "./query";
 export * from "./route";
-export { __ev_rpc, configureRpc } from "./rpc";
+export { configureTransport } from "./transport";
 //# sourceMappingURL=index.js.map

package/esm/client/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,uBAAuB,CAAC;AAEtC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AAMxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}

package/esm/client/query.d.ts

@@ -0,0 +1,74 @@
+import { type UseMutationOptions, type UseMutationResult, type UseQueryOptions, type UseQueryResult, type UseSuspenseQueryOptions, type UseSuspenseQueryResult } from "@tanstack/react-query";
+/**
+ * A server function stub as generated by the evjs webpack loader.
+ */
+export type ServerFunction<TArgs extends unknown[], TResponse> = ((...args: TArgs) => Promise<TResponse>) & {
+    _evId?: string;
+};
+/**
+ * The interface for a single server function's query proxy.
+ */
+export interface QueryProxyHandler<TArgs extends unknown[], TResponse> {
+    /** Call the server function directly. */
+    (...args: TArgs): Promise<TResponse>;
+    /** Use as a standard TanStack Query. */
+    useQuery(args: TArgs, options?: Omit<UseQueryOptions<TResponse, Error>, "queryKey" | "queryFn">): UseQueryResult<TResponse, Error>;
+    /** Use as a TanStack Suspense Query. */
+    useSuspenseQuery(args: TArgs, options?: Omit<UseSuspenseQueryOptions<TResponse, Error>, "queryKey" | "queryFn">): UseSuspenseQueryResult<TResponse, Error>;
+    /** Returns standard TanStack Query options. */
+    queryOptions(args: TArgs, options?: Omit<UseQueryOptions<TResponse, Error>, "queryKey" | "queryFn">): UseQueryOptions<TResponse, Error> & {
+        queryKey: unknown[];
+        queryFn: () => Promise<TResponse>;
+    };
+    /** Returns the query key for this function and arguments. */
+    queryKey(args?: TArgs): unknown[];
+    /** The stable function ID (internal). */
+    _evId: string;
+}
+/**
+ * The interface for a single server function's mutation proxy.
+ */
+export interface MutationProxyHandler<TVariables, TResponse> {
+    /** Call the server function directly. */
+    (variables: TVariables): Promise<TResponse>;
+    /** Use as a TanStack Mutation. */
+    useMutation(options?: Omit<UseMutationOptions<TResponse, Error, TVariables>, "mutationFn">): UseMutationResult<TResponse, Error, TVariables>;
+    /** Returns standard TanStack Mutation options. */
+    mutationOptions(options?: Omit<UseMutationOptions<TResponse, Error, TVariables>, "mutationFn">): UseMutationOptions<TResponse, Error, TVariables> & {
+        mutationFn: (variables: TVariables) => Promise<TResponse>;
+    };
+    /** The stable function ID (internal). */
+    _evId: string;
+}
+/**
+ * A recursive proxy that maps property access to server function stubs.
+ */
+export type QueryProxy<TModule> = {
+    [K in keyof TModule]: TModule[K] extends ServerFunction<infer TArgs, infer TResponse> ? QueryProxyHandler<TArgs, TResponse> : QueryProxy<TModule[K]>;
+};
+export type MutationProxy<TModule> = {
+    [K in keyof TModule]: TModule[K] extends ServerFunction<infer TVars, infer TResponse> ? MutationProxyHandler<TVars, TResponse> : MutationProxy<TModule[K]>;
+};
+/**
+ * Create a type-safe query proxy for a module or object.
+ */
+export declare function createQueryProxy<T>(source?: T): QueryProxy<T>;
+/**
+ * Create a type-safe mutation proxy for a module or object.
+ */
+export declare function createMutationProxy<T>(source?: T): MutationProxy<T>;
+/**
+ * The global query proxy/wrapper.
+ * @example
+ * const { data } = query(getUsers).useQuery();
+ * // or with a typed proxy:
+ * const api = createQueryProxy(getUsersModule);
+ * const { data } = api.getUsers.useQuery();
+ */
+export declare const query: (<TArgs extends unknown[], TResponse>(fn: ServerFunction<TArgs, TResponse>) => QueryProxyHandler<TArgs, TResponse>) & QueryProxy<Record<string, unknown>>;
+/**
+ * The global mutation proxy/wrapper.
+ * @example const { mutate } = mutation(createUser).useMutation();
+ */
+export declare const mutation: (<TVariables, TResponse>(fn: (args: TVariables) => Promise<TResponse>) => MutationProxyHandler<TVariables, TResponse>) & MutationProxy<Record<string, unknown>>;
+//# sourceMappingURL=query.d.ts.map

package/esm/client/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/client/query.ts"],"names":[],"mappings":"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"}

package/esm/client/query.js

@@ -0,0 +1,96 @@
+import { useMutation, useQuery, useSuspenseQuery, } from "@tanstack/react-query";
+function createHandler(fn, path) {
+    return {
+        useQuery: (args = [], options) => {
+            return useQuery({
+                ...options,
+                queryKey: [fn._evId || path.join("."), ...args],
+                queryFn: () => fn(...args),
+            });
+        },
+        useSuspenseQuery: (args = [], options) => {
+            return useSuspenseQuery({
+                ...options,
+                queryKey: [fn._evId || path.join("."), ...args],
+                queryFn: () => fn(...args),
+            });
+        },
+        useMutation: (options) => {
+            return useMutation({
+                ...options,
+                mutationFn: (variables) => fn(variables),
+            });
+        },
+        queryOptions: (args = [], options) => {
+            return {
+                ...options,
+                queryKey: [fn._evId || path.join("."), ...args],
+                queryFn: () => fn(...args),
+            };
+        },
+        mutationOptions: (options) => {
+            return {
+                ...options,
+                mutationFn: (variables) => fn(variables),
+            };
+        },
+        queryKey: (args = []) => {
+            return [fn._evId || path.join("."), ...args];
+        },
+        _evId: fn._evId,
+        path: path.join("."),
+    };
+}
+function createProxy(type, source, path = []) {
+    const target = source ?? (() => { });
+    return new Proxy(target, {
+        get(_target, prop) {
+            if (prop === "_evId")
+                return _target._evId;
+            const newPath = [...path, prop];
+            const val = source
+                ? source[prop]
+                : undefined;
+            // If we have a source and this is a function, return the handler
+            if (typeof val === "function") {
+                return createHandler(val, newPath);
+            }
+            // Otherwise return a nested proxy
+            return createProxy(type, val, newPath);
+        },
+        apply(_target, _thisArg, args) {
+            const fn = args[0];
+            if (typeof fn === "function") {
+                return createHandler(fn, path);
+            }
+            return fn; // Fallback
+        },
+    });
+}
+/**
+ * Create a type-safe query proxy for a module or object.
+ */
+export function createQueryProxy(source) {
+    return createProxy("query", source);
+}
+/**
+ * Create a type-safe mutation proxy for a module or object.
+ */
+export function createMutationProxy(source) {
+    return createProxy("mutation", source);
+}
+/**
+ * The global query proxy/wrapper.
+ * @example
+ * const { data } = query(getUsers).useQuery();
+ * // or with a typed proxy:
+ * const api = createQueryProxy(getUsersModule);
+ * const { data } = api.getUsers.useQuery();
+ */
+export const query = createProxy("query");
+/**
+ * The global mutation proxy/wrapper.
+ * @example const { mutate } = mutation(createUser).useMutation();
+ */
+export const mutation = createProxy("mutation");
+//# sourceMappingURL=query.js.map

package/esm/client/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/client/query.ts"],"names":[],"mappings":"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"}

package/esm/client/transport.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Client-side transport for calling server functions.
+ *
+ * When the Webpack loader transforms a `"use server"` module for the client
+ * bundle, each exported function is replaced with a stub that calls
+ * `__ev_call(fnId, args)`. This module provides that helper.
+ */
+/**
+ * Request context passed through server calls.
+ * Used during SSR to forward headers/cookies, and in RSC for streaming.
+ *
+ * @experimental This interface is reserved for future SSR/RSC support.
+ * Do not rely on it in production — the shape may change.
+ */
+export interface RequestContext {
+    /** @experimental Request headers to forward (e.g. cookies during SSR). SSR is not yet supported. */
+    headers?: Record<string, string>;
+    /** Signal for aborting the request. */
+    signal?: AbortSignal;
+}
+/**
+ * Transport interface for client-server communication.
+ * Implement this to use a custom request library or protocol.
+ */
+export interface ServerTransport {
+    /** Standard request-response call for server functions. */
+    send(fnId: string, args: unknown[], context?: RequestContext): Promise<unknown>;
+    /**
+     * Streaming call for RSC Flight protocol.
+     * Returns a ReadableStream of serialized React elements.
+     *
+     * @experimental Not yet implemented. Reserved for future RSC support.
+     * Do not use — this method signature may change.
+     */
+    stream?(fnId: string, args: unknown[], context?: RequestContext): ReadableStream<Uint8Array>;
+}
+export interface TransportOptions {
+    /** Base URL for the RPC endpoint. Defaults to the current origin. */
+    baseUrl?: string;
+    /** Path prefix for the RPC endpoint. Defaults to `/api/rpc`. */
+    endpoint?: string;
+    /** Custom transport. When provided, `baseUrl` and `endpoint` are ignored. */
+    transport?: ServerTransport;
+}
+/**
+ * Configure the server transport. Call once at app startup if you need to
+ * customise the endpoint URL or provide a custom transport.
+ */
+export declare function configureTransport(options: TransportOptions): void;
+//# sourceMappingURL=transport.d.ts.map

package/esm/client/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/client/transport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,oGAAoG;IACpG,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,uCAAuC;IACvC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,IAAI,CACF,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EAAE,EACf,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB;;;;;;OAMG;IACH,MAAM,CAAC,CACL,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EAAE,EACf,OAAO,CAAC,EAAE,cAAc,GACvB,cAAc,CAAC,UAAU,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B;AAwDD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CASlE"}

package/esm/client/transport.js

@@ -0,0 +1,71 @@
+/**
+ * Client-side transport for calling server functions.
+ *
+ * When the Webpack loader transforms a `"use server"` module for the client
+ * 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";
+/**
+ * Default fetch-based transport.
+ */
+function createFetchTransport(baseUrl, endpoint) {
+    return {
+        async send(fnId, args, context) {
+            const url = `${baseUrl}${endpoint}`;
+            const res = await fetch(url, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    ...context?.headers,
+                },
+                body: JSON.stringify({ 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 payload = await res.json();
+            if (payload.error) {
+                throw new Error(`[ev] Server function "${fnId}" threw: ${payload.error}`);
+            }
+            return payload.result;
+        },
+    };
+}
+let _transport = null;
+function getTransport() {
+    if (!_transport) {
+        _transport = createFetchTransport("", DEFAULT_RPC_ENDPOINT);
+    }
+    return _transport;
+}
+/**
+ * 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) {
+    if (options.transport) {
+        _transport = options.transport;
+    }
+    else {
+        _transport = createFetchTransport(options.baseUrl ?? "", options.endpoint ?? DEFAULT_RPC_ENDPOINT);
+    }
+}
+/**
+ * Call a server function by its unique ID.
+ *
+ * @internal This function is auto-injected by the Webpack loader.
+ * Do not call directly — use server functions as normal imports instead.
+ *
+ * @param fnId - The unique identifier assigned to the server function by the
+ *   Webpack loader (e.g. `"user_server_getUser"`).
+ * @param args - The arguments to pass to the server function. Must be
+ *   JSON-serializable.
+ * @returns A promise that resolves with the server function's return value.
+ */
+export async function __ev_call(fnId, args, context) {
+    return getTransport().send(fnId, args, context);
+}
+//# sourceMappingURL=transport.js.map

package/esm/client/transport.js.map

@@ -0,0 +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;;;;;;;;;;;GAWG;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"}

package/esm/constants.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Shared constants for the ev runtime.
+ */
+/** Default RPC endpoint path, shared between client and server. */
+export declare const DEFAULT_RPC_ENDPOINT = "/api/rpc";
+//# sourceMappingURL=constants.d.ts.map

package/esm/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,mEAAmE;AACnE,eAAO,MAAM,oBAAoB,aAAa,CAAC"}

package/esm/constants.js

@@ -0,0 +1,6 @@
+/**
+ * Shared constants for the ev runtime.
+ */
+/** Default RPC endpoint path, shared between client and server. */
+export const DEFAULT_RPC_ENDPOINT = "/api/rpc";
+//# sourceMappingURL=constants.js.map

package/esm/constants.js.map

@@ -0,0 +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"}

package/esm/server/app.d.ts

@@ -1,25 +1,25 @@
 /**
  * Server application factory.
  *
- * Creates a Hono app with RPC middleware and starts a Node.js HTTP
- * server via @hono/node-server.
+ * Creates a Hono app with RPC middleware.
+ * This app is runtime-agnostic and can be mounted in Node, Edge, or Bun.
  */
 import { Hono } from "hono";
-/** Options for createServer. */
-export interface CreateServerOptions {
+/** Options for createApp. */
+export interface CreateAppOptions {
     /** Port to listen on. Defaults to 3001. */
     port?: number;
     /** RPC endpoint path. Defaults to "/api/rpc". */
     rpcEndpoint?: string;
 }
 /**
- * Create and start an ev API server.
+ * Create an ev API server application.
  *
- * Mounts the RPC middleware at `/api/rpc` and starts listening.
+ * Mounts the RPC middleware at `/api/rpc`.
  * In Stage 3, this will be extended with SSR middleware.
  *
- * @param options - Server configuration.
- * @returns The Hono app instance (for extension or testing).
+ * @param options - Application configuration.
+ * @returns A runtime-agnostic Hono app instance.
  */
-export declare function createServer(options?: CreateServerOptions): Hono;
+export declare function createApp(options?: CreateAppOptions): Hono;
 //# sourceMappingURL=app.d.ts.map

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,gCAAgC;AAChC,MAAM,WAAW,mBAAmB;IAClC,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAahE"}
+{"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,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAS1D"}

package/esm/server/app.js

@@ -1,29 +1,26 @@
 /**
  * Server application factory.
  *
- * Creates a Hono app with RPC middleware and starts a Node.js HTTP
- * server via @hono/node-server.
+ * Creates a Hono app with RPC middleware.
+ * This app is runtime-agnostic and can be mounted in Node, Edge, or Bun.
  */
 import { Hono } from "hono";
-import { serve } from "@hono/node-server";
+import { DEFAULT_RPC_ENDPOINT } from "../constants";
 import { createRpcMiddleware } from "./handler";
 /**
- * Create and start an ev API server.
+ * Create an ev API server application.
  *
- * Mounts the RPC middleware at `/api/rpc` and starts listening.
+ * Mounts the RPC middleware at `/api/rpc`.
  * In Stage 3, this will be extended with SSR middleware.
  *
- * @param options - Server configuration.
- * @returns The Hono app instance (for extension or testing).
+ * @param options - Application configuration.
+ * @returns A runtime-agnostic Hono app instance.
  */
-export function createServer(options) {
-    const { port = 3001, rpcEndpoint = "/api/rpc" } = options ?? {};
+export function createApp(options) {
+    const { rpcEndpoint = DEFAULT_RPC_ENDPOINT } = options ?? {};
     const app = new Hono();
     // Mount RPC endpoint
     app.route(rpcEndpoint, createRpcMiddleware());
-    serve({ fetch: app.fetch, port }, (info) => {
-        console.log(`ev server running at http://localhost:${info.port}`);
-    });
     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,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAUhD;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,OAA6B;IACxD,MAAM,EAAE,IAAI,GAAG,IAAI,EAAE,WAAW,GAAG,UAAU,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IAEhE,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IAEvB,qBAAqB;IACrB,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,mBAAmB,EAAE,CAAC,CAAC;IAE9C,KAAK,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE;QACzC,OAAO,CAAC,GAAG,CAAC,yCAAyC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,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;AAC5B,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAUhD;;;;;;;;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,qBAAqB;IACrB,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,mBAAmB,EAAE,CAAC,CAAC;IAE9C,OAAO,GAAG,CAAC;AACb,CAAC"}

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

@@ -0,0 +1,11 @@
+import type { Hono } from "hono";
+export interface NodeRunnerOptions {
+    port?: number;
+    host?: string;
+}
+/**
+ * Runner plugin for Node.js environments.
+ * Takes a compiled Hono app and starts a native Node HTTP server.
+ */
+export declare function runNodeServer(app: Hono, options?: NodeRunnerOptions): import("@hono/node-server").ServerType;
+//# sourceMappingURL=node.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../src/server/environments/node.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAIjC,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,iBAAiB,0CAYnE"}

package/esm/server/environments/node.js

@@ -0,0 +1,19 @@
+import { serve } from "@hono/node-server";
+import { getLogger } from "@logtape/logtape";
+const logger = getLogger(["evjs", "server"]);
+/**
+ * Runner plugin for Node.js environments.
+ * Takes a compiled Hono app and starts a native Node HTTP server.
+ */
+export function runNodeServer(app, options) {
+    const port = options?.port || 3001;
+    const hostname = options?.host;
+    const server = serve({ fetch: app.fetch, port, hostname }, (info) => {
+        const address = info.address === "0.0.0.0" || info.address === "::"
+            ? "localhost"
+            : info.address;
+        logger.info `Server API ready at http://${address}:${info.port}`;
+    });
+    return server;
+}
+//# sourceMappingURL=node.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../../src/server/environments/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAG7C,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;AAO7C;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,GAAS,EAAE,OAA2B;IAClE,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,IAAI,CAAC;IACnC,MAAM,QAAQ,GAAG,OAAO,EAAE,IAAI,CAAC;IAC/B,MAAM,MAAM,GAAG,KAAK,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE;QAClE,MAAM,OAAO,GACX,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI;YACjD,CAAC,CAAC,WAAW;YACb,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;QACnB,MAAM,CAAC,IAAI,CAAA,8BAA8B,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/esm/server/index.d.ts

@@ -1,7 +1,9 @@
 /**
  * Server-side runtime utilities.
  */
-export { createServer } from "./app";
-export type { CreateServerOptions } from "./app";
+export type { CreateAppOptions } from "./app";
+export { createApp } from "./app";
+export type { NodeRunnerOptions } from "./environments/node";
+export { runNodeServer } from "./environments/node";
 export { createRpcMiddleware, registerServerFn } from "./handler";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AACrC,YAAY,EAAE,mBAAmB,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC"}

package/esm/server/index.js

@@ -1,6 +1,7 @@
 /**
  * Server-side runtime utilities.
  */
-export { createServer } from "./app";
+export { createApp } from "./app";
+export { runNodeServer } from "./environments/node";
 export { createRpcMiddleware, registerServerFn } from "./handler";
 //# sourceMappingURL=index.js.map

package/esm/server/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAErC,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC"}

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@evjs/runtime",
-  "version": "0.0.1-alpha.5",
+  "version": "0.0.1-alpha.7",
   "description": "",
   "dependencies": {
     "@hono/node-server": "^1.19.11",
+    "@logtape/logtape": "^2.0.4",
     "@tanstack/react-query": "^5.90.21",
     "@tanstack/react-router": "^1.163.3",
     "hono": "^4.12.5"
@@ -38,6 +39,10 @@
       "types": "./esm/client/index.d.ts",
       "import": "./esm/client/index.js"
     },
+    "./client/transport": {
+      "types": "./esm/client/transport.d.ts",
+      "import": "./esm/client/transport.js"
+    },
     "./server": {
       "types": "./esm/server/index.d.ts",
       "import": "./esm/server/index.js"

package/esm/client/rpc.d.ts

@@ -1,29 +0,0 @@
-/**
- * Client-side RPC helper for calling server functions.
- *
- * When the Webpack loader transforms a `"use server"` module for the client
- * bundle, each exported function is replaced with a stub that calls
- * `__ev_rpc(fnId, args)`. This module provides that helper.
- */
-export interface RpcOptions {
-    /** Base URL for the RPC endpoint. Defaults to the current origin. */
-    baseUrl?: string;
-    /** Path prefix for the RPC endpoint. Defaults to `/api/rpc`. */
-    endpoint?: string;
-}
-/**
- * Configure the RPC client. Call once at app startup if you need to
- * customise the endpoint URL.
- */
-export declare function configureRpc(options: RpcOptions): void;
-/**
- * Call a server function by its unique ID.
- *
- * @param fnId - The unique identifier assigned to the server function by the
- *   Webpack loader (e.g. `"user_server_getUser"`).
- * @param args - The arguments to pass to the server function. Must be
- *   JSON-serializable.
- * @returns A promise that resolves with the server function's return value.
- */
-export declare function __ev_rpc(fnId: string, args: unknown[]): Promise<unknown>;
-//# sourceMappingURL=rpc.d.ts.map

package/esm/client/rpc.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../../src/client/rpc.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,UAAU;IACzB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAOD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAEtD;AAED;;;;;;;;GAQG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAqB9E"}

package/esm/client/rpc.js

@@ -1,45 +0,0 @@
-/**
- * Client-side RPC helper for calling server functions.
- *
- * When the Webpack loader transforms a `"use server"` module for the client
- * bundle, each exported function is replaced with a stub that calls
- * `__ev_rpc(fnId, args)`. This module provides that helper.
- */
-let _options = {
-    baseUrl: "",
-    endpoint: "/api/rpc",
-};
-/**
- * Configure the RPC client. Call once at app startup if you need to
- * customise the endpoint URL.
- */
-export function configureRpc(options) {
-    _options = { ..._options, ...options };
-}
-/**
- * Call a server function by its unique ID.
- *
- * @param fnId - The unique identifier assigned to the server function by the
- *   Webpack loader (e.g. `"user_server_getUser"`).
- * @param args - The arguments to pass to the server function. Must be
- *   JSON-serializable.
- * @returns A promise that resolves with the server function's return value.
- */
-export async function __ev_rpc(fnId, args) {
-    const url = `${_options.baseUrl}${_options.endpoint}`;
-    const res = await fetch(url, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ fnId, args }),
-    });
-    if (!res.ok) {
-        const text = await res.text().catch(() => res.statusText);
-        throw new Error(`[ev/rpc] Server function "${fnId}" failed (${res.status}): ${text}`);
-    }
-    const payload = await res.json();
-    if (payload.error) {
-        throw new Error(`[ev/rpc] Server function "${fnId}" threw: ${payload.error}`);
-    }
-    return payload.result;
-}
-//# sourceMappingURL=rpc.js.map

package/esm/client/rpc.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../../src/client/rpc.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,IAAI,QAAQ,GAAyB;IACnC,OAAO,EAAE,EAAE;IACX,QAAQ,EAAE,UAAU;CACrB,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,OAAmB;IAC9C,QAAQ,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,OAAO,EAAE,CAAC;AACzC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAY,EAAE,IAAe;IAC1D,MAAM,GAAG,GAAG,GAAG,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC;IAEtD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAC3B,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;KACrC,CAAC,CAAC;IAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,aAAa,GAAG,CAAC,MAAM,MAAM,IAAI,EAAE,CAAC,CAAC;IACxF,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAEjC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,YAAY,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,CAAC;AACxB,CAAC"}

package/esm/version.d.ts

@@ -1,2 +0,0 @@
-export declare const VERSION = "0.0.1-alpha.5";
-//# sourceMappingURL=version.d.ts.map

package/esm/version.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,kBAAkB,CAAC"}

package/esm/version.js

@@ -1,2 +0,0 @@
-export const VERSION = "0.0.1-alpha.5";
-//# sourceMappingURL=version.js.map

package/esm/version.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,eAAe,CAAC"}