@evjs/runtime 0.0.1-alpha.1

package/README.md

@@ -0,0 +1,39 @@
+# @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.
+
+## Installation
+
+```bash
+npm install @evjs/runtime
+```
+
+## Features
+
+- **`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.
+
+## Usage
+
+### Client Entry
+
+```tsx
+import { createApp, createRootRoute } from "@evjs/runtime";
+
+const rootRoute = createRootRoute({ component: Root });
+const app = createApp({ routeTree: rootRoute });
+
+app.render("#app");
+```
+
+### Server Entry
+
+```ts
+import { createServer } from "@evjs/runtime/server";
+
+createServer({ 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.

package/esm/client/create-app.d.ts

@@ -0,0 +1,48 @@
+import { QueryClient, type QueryClientConfig } from "@tanstack/react-query";
+import type { AnyRoute, AnyRouter } from "@tanstack/react-router";
+/**
+ * Options for creating an ev application.
+ */
+export interface CreateAppOptions<TRouteTree extends AnyRoute> {
+    /** The root route tree produced by createRootRoute and addChildren. */
+    routeTree: TRouteTree;
+    /**
+     * Optional configuration for the TanStack Router.
+     */
+    routerOptions?: Omit<Parameters<typeof import("@tanstack/react-router").createRouter>[0], "routeTree">;
+    /**
+     * Optional configuration for the TanStack Query Client.
+     */
+    queryClientConfig?: QueryClientConfig;
+}
+/**
+ * An initialized ev application instance.
+ */
+export interface App {
+    /** The TanStack Router instance. */
+    router: AnyRouter;
+    /** The TanStack Query Client instance. */
+    queryClient: QueryClient;
+    /**
+     * Mount the application into the DOM.
+     * @param container - A CSS selector string or an HTMLElement.
+     */
+    render(container: string | HTMLElement): void;
+}
+/**
+ * Create a new ev application instance.
+ *
+ * This function initializes the router and query client and returns
+ * an app object that can be mounted into the DOM.
+ *
+ * @param options - Application configuration options.
+ * @returns An initialized App instance.
+ *
+ * @example
+ * ```tsx
+ * const app = createApp({ routeTree });
+ * app.render("#app");
+ * ```
+ */
+export declare function createApp<TRouteTree extends AnyRoute>(options: CreateAppOptions<TRouteTree>): App;
+//# sourceMappingURL=create-app.d.ts.map

package/esm/client/create-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-app.d.ts","sourceRoot":"","sources":["../../src/client/create-app.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,KAAK,iBAAiB,EAEvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAIlE;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,UAAU,SAAS,QAAQ;IAC3D,uEAAuE;IACvE,SAAS,EAAE,UAAU,CAAC;IACtB;;OAEG;IACH,aAAa,CAAC,EAAE,IAAI,CAClB,UAAU,CAAC,cAAc,wBAAwB,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,EACnE,WAAW,CACZ,CAAC;IACF;;OAEG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,GAAG;IAClB,oCAAoC;IACpC,MAAM,EAAE,SAAS,CAAC;IAClB,0CAA0C;IAC1C,WAAW,EAAE,WAAW,CAAC;IACzB;;;OAGG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;CAC/C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,UAAU,SAAS,QAAQ,EACnD,OAAO,EAAE,gBAAgB,CAAC,UAAU,CAAC,GACpC,GAAG,CA+BL"}

package/esm/client/create-app.js

@@ -0,0 +1,39 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { QueryClient, QueryClientProvider, } from "@tanstack/react-query";
+import { createRouter, RouterProvider } from "@tanstack/react-router";
+import { createRoot } from "react-dom/client";
+/**
+ * Create a new ev application instance.
+ *
+ * This function initializes the router and query client and returns
+ * an app object that can be mounted into the DOM.
+ *
+ * @param options - Application configuration options.
+ * @returns An initialized App instance.
+ *
+ * @example
+ * ```tsx
+ * const app = createApp({ routeTree });
+ * app.render("#app");
+ * ```
+ */
+export function createApp(options) {
+    const { routeTree, routerOptions, queryClientConfig } = options;
+    const queryClient = new QueryClient(queryClientConfig);
+    const router = createRouter({
+        ...routerOptions,
+        routeTree,
+    });
+    function render(container) {
+        const el = typeof container === "string"
+            ? document.querySelector(container)
+            : container;
+        if (!el) {
+            throw new Error(`[ev] Could not find container element: ${String(container)}`);
+        }
+        const root = createRoot(el);
+        root.render(_jsx(QueryClientProvider, { client: queryClient, children: _jsx(RouterProvider, { router: router }) }));
+    }
+    return { router, queryClient, render };
+}
+//# sourceMappingURL=create-app.js.map

package/esm/client/create-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-app.js","sourceRoot":"","sources":["../../src/client/create-app.tsx"],"names":[],"mappings":";AAAA,OAAO,EACL,WAAW,EAEX,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAoC9C;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,SAAS,CACvB,OAAqC;IAErC,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC;IAEhE,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,iBAAiB,CAAC,CAAC;IAEvD,MAAM,MAAM,GAAG,YAAY,CAAC;QAC1B,GAAG,aAAa;QAChB,SAAS;KAC4B,CAAC,CAAC;IAEzC,SAAS,MAAM,CAAC,SAA+B;QAC7C,MAAM,EAAE,GACN,OAAO,SAAS,KAAK,QAAQ;YAC3B,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAc,SAAS,CAAC;YAChD,CAAC,CAAC,SAAS,CAAC;QAEhB,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,MAAM,IAAI,KAAK,CACb,0CAA0C,MAAM,CAAC,SAAS,CAAC,EAAE,CAC9D,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;QAC5B,IAAI,CAAC,MAAM,CACT,KAAC,mBAAmB,IAAC,MAAM,EAAE,WAAW,YACtC,KAAC,cAAc,IAAC,MAAM,EAAE,MAAM,GAAI,GACd,CACvB,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;AACzC,CAAC"}

package/esm/client/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Client-side runtime utilities.
+ */
+export type { App, CreateAppOptions } from "./create-app";
+export { createApp } from "./create-app";
+export * from "./route";
+export { __ev_rpc, configureRpc } from "./rpc";
+export type { RpcOptions } from "./rpc";
+//# sourceMappingURL=index.d.ts.map

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

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

package/esm/client/index.js

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

package/esm/client/index.js.map

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

package/esm/client/route.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Routing utilities re-exported from @tanstack/react-router.
+ *
+ * This module provides the core primitives for building file-based
+ * or code-based routing in the ev framework.
+ */
+export type { AnyRootRoute, AnyRoute, AnyRouteMatch, AnyRouter, ErrorComponentProps, ErrorRouteComponent, LinkOptions, LinkProps, NavigateOptions, NotFoundError, NotFoundRouteComponent, NotFoundRouteProps, RegisteredRouter, RouteComponent, RouteMatch, RouterOptions, RouterState, SearchSchemaInput, } from "@tanstack/react-router";
+export { CatchBoundary, CatchNotFound, createLink, createRootRoute, createRootRouteWithContext, createRoute, createRouteMask, createRouter, DefaultGlobalNotFound, ErrorComponent, getRouteApi, isNotFound, isRedirect, Link, lazyRouteComponent, linkOptions, Navigate, notFound, Outlet, RouterProvider, redirect, useBlocker, useCanGoBack, useLoaderData, useLoaderDeps, useLocation, useMatch, useMatchRoute, useNavigate, useParams, useRouteContext, useRouter, useRouterState, useSearch, } from "@tanstack/react-router";
+//# sourceMappingURL=route.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../src/client/route.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,SAAS,EACT,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,SAAS,EACT,eAAe,EACf,aAAa,EACb,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,aAAa,EACb,WAAW,EACX,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,aAAa,EACb,aAAa,EACb,UAAU,EACV,eAAe,EACf,0BAA0B,EAC1B,WAAW,EACX,eAAe,EACf,YAAY,EACZ,qBAAqB,EACrB,cAAc,EACd,WAAW,EACX,UAAU,EACV,UAAU,EACV,IAAI,EACJ,kBAAkB,EAClB,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,cAAc,EACd,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,aAAa,EACb,aAAa,EACb,WAAW,EACX,QAAQ,EACR,aAAa,EACb,WAAW,EACX,SAAS,EACT,eAAe,EACf,SAAS,EACT,cAAc,EACd,SAAS,GACV,MAAM,wBAAwB,CAAC"}

package/esm/client/route.js

@@ -0,0 +1,8 @@
+/**
+ * Routing utilities re-exported from @tanstack/react-router.
+ *
+ * This module provides the core primitives for building file-based
+ * or code-based routing in the ev framework.
+ */
+export { CatchBoundary, CatchNotFound, createLink, createRootRoute, createRootRouteWithContext, createRoute, createRouteMask, createRouter, DefaultGlobalNotFound, ErrorComponent, getRouteApi, isNotFound, isRedirect, Link, lazyRouteComponent, linkOptions, Navigate, notFound, Outlet, RouterProvider, redirect, useBlocker, useCanGoBack, useLoaderData, useLoaderDeps, useLocation, useMatch, useMatchRoute, useNavigate, useParams, useRouteContext, useRouter, useRouterState, useSearch, } from "@tanstack/react-router";
+//# sourceMappingURL=route.js.map

package/esm/client/route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.js","sourceRoot":"","sources":["../../src/client/route.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuBH,OAAO,EACL,aAAa,EACb,aAAa,EACb,UAAU,EACV,eAAe,EACf,0BAA0B,EAC1B,WAAW,EACX,eAAe,EACf,YAAY,EACZ,qBAAqB,EACrB,cAAc,EACd,WAAW,EACX,UAAU,EACV,UAAU,EACV,IAAI,EACJ,kBAAkB,EAClB,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,cAAc,EACd,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,aAAa,EACb,aAAa,EACb,WAAW,EACX,QAAQ,EACR,aAAa,EACb,WAAW,EACX,SAAS,EACT,eAAe,EACf,SAAS,EACT,cAAc,EACd,SAAS,GACV,MAAM,wBAAwB,CAAC"}

package/esm/client/rpc.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 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

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

@@ -0,0 +1,45 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @evjs/runtime
+ *
+ * Core runtime for the ev framework, providing isomorphic utilities
+ * for client-side routing, state management, and server-side RPC handling.
+ */
+export * as client from "./client/index";
+export * as server from "./server/index";
+//# sourceMappingURL=index.d.ts.map

package/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,MAAM,gBAAgB,CAAC;AACzC,OAAO,KAAK,MAAM,MAAM,gBAAgB,CAAC"}

package/esm/index.js

@@ -0,0 +1,9 @@
+/**
+ * @evjs/runtime
+ *
+ * Core runtime for the ev framework, providing isomorphic utilities
+ * for client-side routing, state management, and server-side RPC handling.
+ */
+export * as client from "./client/index";
+export * as server from "./server/index";
+//# sourceMappingURL=index.js.map

package/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,MAAM,gBAAgB,CAAC;AACzC,OAAO,KAAK,MAAM,MAAM,gBAAgB,CAAC"}

package/esm/server/app.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Server application factory.
+ *
+ * Creates a Hono app with RPC middleware and starts a Node.js HTTP
+ * server via @hono/node-server.
+ */
+import { Hono } from "hono";
+/** Options for createServer. */
+export interface CreateServerOptions {
+    /** 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.
+ *
+ * Mounts the RPC middleware at `/api/rpc` and starts listening.
+ * In Stage 3, this will be extended with SSR middleware.
+ *
+ * @param options - Server configuration.
+ * @returns The Hono app instance (for extension or testing).
+ */
+export declare function createServer(options?: CreateServerOptions): Hono;
+//# sourceMappingURL=app.d.ts.map

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

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

package/esm/server/app.js

@@ -0,0 +1,29 @@
+/**
+ * Server application factory.
+ *
+ * Creates a Hono app with RPC middleware and starts a Node.js HTTP
+ * server via @hono/node-server.
+ */
+import { Hono } from "hono";
+import { serve } from "@hono/node-server";
+import { createRpcMiddleware } from "./handler";
+/**
+ * Create and start an ev API server.
+ *
+ * Mounts the RPC middleware at `/api/rpc` and starts listening.
+ * In Stage 3, this will be extended with SSR middleware.
+ *
+ * @param options - Server configuration.
+ * @returns The Hono app instance (for extension or testing).
+ */
+export function createServer(options) {
+    const { port = 3001, rpcEndpoint = "/api/rpc" } = 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

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

package/esm/server/handler.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Hono middleware for dispatching RPC calls to registered server functions.
+ *
+ * The Webpack server-fn-loader calls `registerServerFn()` at module load
+ * time, populating the registry. This middleware handles incoming
+ * `POST /api/rpc` requests and dispatches them to the correct function.
+ */
+import { Hono } from "hono";
+/** A registered server function. */
+type ServerFn = (...args: unknown[]) => Promise<unknown>;
+/**
+ * Register a server function so it can be invoked via RPC.
+ * Called automatically by the Webpack-transformed server bundles at load time.
+ *
+ * @param fnId - The unique ID for this function.
+ * @param fn - The actual function implementation.
+ */
+export declare function registerServerFn(fnId: string, fn: ServerFn): void;
+/**
+ * Create a Hono sub-app that handles RPC requests.
+ *
+ * Expects `POST /` with JSON body `{ fnId: string, args: unknown[] }`.
+ * Responds with `{ result: unknown }` on success or `{ error: string }` on failure.
+ *
+ * @returns A Hono app to be mounted at the desired path (e.g. `/api/rpc`).
+ */
+export declare function createRpcMiddleware(): Hono;
+export {};
+//# sourceMappingURL=handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/server/handler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,oCAAoC;AACpC,KAAK,QAAQ,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAKzD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,GAAG,IAAI,CAEjE;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAwB1C"}

package/esm/server/handler.js

@@ -0,0 +1,48 @@
+/**
+ * Hono middleware for dispatching RPC calls to registered server functions.
+ *
+ * The Webpack server-fn-loader calls `registerServerFn()` at module load
+ * time, populating the registry. This middleware handles incoming
+ * `POST /api/rpc` requests and dispatches them to the correct function.
+ */
+import { Hono } from "hono";
+/** Internal registry mapping function IDs to implementations. */
+const registry = new Map();
+/**
+ * Register a server function so it can be invoked via RPC.
+ * Called automatically by the Webpack-transformed server bundles at load time.
+ *
+ * @param fnId - The unique ID for this function.
+ * @param fn - The actual function implementation.
+ */
+export function registerServerFn(fnId, fn) {
+    registry.set(fnId, fn);
+}
+/**
+ * Create a Hono sub-app that handles RPC requests.
+ *
+ * Expects `POST /` with JSON body `{ fnId: string, args: unknown[] }`.
+ * Responds with `{ result: unknown }` on success or `{ error: string }` on failure.
+ *
+ * @returns A Hono app to be mounted at the desired path (e.g. `/api/rpc`).
+ */
+export function createRpcMiddleware() {
+    const rpc = new Hono();
+    rpc.post("/", async (c) => {
+        const { fnId, args } = await c.req.json();
+        const fn = registry.get(fnId);
+        if (!fn) {
+            return c.json({ error: `Server function "${fnId}" not found` }, 404);
+        }
+        try {
+            const result = await fn(...(args ?? []));
+            return c.json({ result });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return c.json({ error: message }, 500);
+        }
+    });
+    return rpc;
+}
+//# sourceMappingURL=handler.js.map

package/esm/server/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../src/server/handler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAK5B,iEAAiE;AACjE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAC;AAE7C;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,EAAY;IACzD,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AACzB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IAEvB,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QACxB,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,EAGnC,CAAC;QAEL,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,oBAAoB,IAAI,aAAa,EAAE,EAAE,GAAG,CAAC,CAAC;QACvE,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;YACzC,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC;QACzC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC"}

package/esm/server/index.d.ts

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

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

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

package/esm/server/index.js

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

package/esm/server/index.js.map

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

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@evjs/runtime",
+  "version": "0.0.1-alpha.1",
+  "description": "",
+  "dependencies": {
+    "@hono/node-server": "^1.19.11",
+    "@tanstack/react-query": "^5.90.21",
+    "@tanstack/react-router": "^1.163.3",
+    "hono": "^4.12.5"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.3"
+  },
+  "homepage": "https://github.com/evjs/evjs#readme",
+  "bugs": {
+    "url": "https://github.com/evjs/evjs/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/evjs/evjs.git"
+  },
+  "license": "MIT",
+  "author": "xusd320",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./esm/index.d.ts",
+      "import": "./esm/index.js"
+    },
+    "./client": {
+      "types": "./esm/client/index.d.ts",
+      "import": "./esm/client/index.js"
+    },
+    "./server": {
+      "types": "./esm/server/index.d.ts",
+      "import": "./esm/server/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "check-types": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "esm"
+  ]
+}