@evjs/runtime 0.0.1-alpha.1 → 0.0.1-alpha.10

package/AGENT.md

@@ -0,0 +1,66 @@
+# @evjs/runtime
+
+Core runtime for the ev React framework. Provides client-side routing, data fetching, and server-side handling.
+
+## Client API (`@evjs/runtime/client`)
+
+### App Bootstrap
+- `createApp({ routeTree, routerOptions?, queryClientConfig? })` — Bootstrap Router + Query + DOM. Injects `queryClient` into router context.
+- `createAppRootRoute(options)` — Create root route with typed `context.queryClient` for route loaders.
+
+### Server Function Proxies
+Always use these instead of raw `useQuery`/`useMutation` for server functions:
+
+```tsx
+import { query, mutation, createQueryProxy, createMutationProxy } from "@evjs/runtime/client";
+import { getUsers, createUser } from "./api/users.server";
+
+// Direct wrapper
+const { data } = query(getUsers).useQuery([]);
+const { mutate } = mutation(createUser).useMutation();
+
+// Module proxy
+const api = { query: createQueryProxy({ getUsers }), mutation: createMutationProxy({ createUser }) };
+api.query.getUsers.useQuery([]);
+
+// queryOptions (for loaders, prefetch)
+const opts = query(getUsers).queryOptions([]);
+queryClient.ensureQueryData(opts);
+
+// Query key (for invalidation)
+queryClient.invalidateQueries({ queryKey: query(getUsers).queryKey() });
+```
+
+### Route Loader Pattern
+```tsx
+const rootRoute = createAppRootRoute({ component: Root });
+const usersRoute = createRoute({
+  getParentRoute: () => rootRoute,
+  path: "/users",
+  loader: ({ context }) =>
+    context.queryClient.ensureQueryData(query(getUsers).queryOptions([])),
+  component: UsersPage,
+});
+```
+
+### Routing (re-exports from @tanstack/react-router)
+`createRootRoute`, `createRoute`, `createRouter`, `Link`, `Outlet`, `Navigate`, `useParams`, `useSearch`, `useNavigate`, `useLocation`, `useMatch`, `useLoaderData`, `redirect`, `notFound`, `lazyRouteComponent`
+
+### Data (re-exports from @tanstack/react-query)
+`useQuery`, `useMutation`, `useQueryClient`, `useSuspenseQuery`, `QueryClient`, `QueryClientProvider`
+
+### Transport
+```tsx
+import { configureTransport } from "@evjs/runtime/client";
+configureTransport({ transport: { send: async (fnId, args) => { /* custom */ } } });
+```
+
+## Server API (`@evjs/runtime/server`)
+
+- `createApp(options?)` — Create Hono app with RPC middleware.
+- `runNodeServer(app, { port?, host? })` — Start on Node.js (default port 3001).
+- `registerServerFn(fnId, fn)` — Register server function (called by build-tools).
+- `createRpcMiddleware()` — Standalone Hono RPC sub-app.
+
+## Server Functions
+Files must start with `"use server";`, use named async exports, and end in `.server.ts`.

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/context.d.ts

@@ -0,0 +1,25 @@
+import type { QueryClient } from "@tanstack/react-query";
+/** Default context available in route loaders. */
+export interface AppRouteContext {
+    queryClient: QueryClient;
+}
+/**
+ * Create a root route with the app's default context (queryClient).
+ *
+ * Use this instead of `createRootRoute` when you want typed access
+ * to `context.queryClient` in `loader` / `beforeLoad`.
+ *
+ * @example
+ * ```tsx
+ * const rootRoute = createAppRootRoute({ component: Root });
+ *
+ * const usersRoute = createRoute({
+ *   getParentRoute: () => rootRoute,
+ *   path: "/users",
+ *   loader: ({ context }) =>
+ *     context.queryClient.ensureQueryData(query(getUsers).queryOptions([])),
+ * });
+ * ```
+ */
+export declare const createAppRootRoute: <TRegister = import("@tanstack/router-core").Register, TRouteContextFn = import("@tanstack/router-core").AnyContext, TBeforeLoadFn = import("@tanstack/router-core").AnyContext, TSearchValidator = undefined, TLoaderDeps extends Record<string, any> = {}, TLoaderFn = undefined, TSSR = unknown, TServerMiddlewares = unknown>(options?: import("@tanstack/router-core").RootRouteOptions<TRegister, TSearchValidator, AppRouteContext, TRouteContextFn, TBeforeLoadFn, TLoaderDeps, TLoaderFn, TSSR, TServerMiddlewares, undefined> | undefined) => import("@tanstack/react-router").RootRoute<TRegister, TSearchValidator, AppRouteContext, TRouteContextFn, TBeforeLoadFn, TLoaderDeps, TLoaderFn, unknown, unknown, TSSR, TServerMiddlewares, undefined>;
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/client/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGzD,kDAAkD;AAClD,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,kBAAkB,iuBAAgD,CAAC"}

package/esm/client/context.js

@@ -0,0 +1,21 @@
+import { createRootRouteWithContext } from "@tanstack/react-router";
+/**
+ * Create a root route with the app's default context (queryClient).
+ *
+ * Use this instead of `createRootRoute` when you want typed access
+ * to `context.queryClient` in `loader` / `beforeLoad`.
+ *
+ * @example
+ * ```tsx
+ * const rootRoute = createAppRootRoute({ component: Root });
+ *
+ * const usersRoute = createRoute({
+ *   getParentRoute: () => rootRoute,
+ *   path: "/users",
+ *   loader: ({ context }) =>
+ *     context.queryClient.ensureQueryData(query(getUsers).queryOptions([])),
+ * });
+ * ```
+ */
+export const createAppRootRoute = createRootRouteWithContext();
+//# sourceMappingURL=context.js.map

package/esm/client/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/client/context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAOpE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,0BAA0B,EAAmB,CAAC"}

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

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

package/esm/client/create-app.js

@@ -23,6 +23,7 @@ export function createApp(options) {
     const router = createRouter({
         ...routerOptions,
         routeTree,
+        context: { queryClient, ...routerOptions?.context },
     });
     function render(container) {
         const el = typeof container === "string"

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

@@ -1 +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"}
+{"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;QACT,OAAO,EAAE,EAAE,WAAW,EAAE,GAAG,aAAa,EAAE,OAAO,EAAE;KACd,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

@@ -1,9 +1,14 @@
 /**
  * Client-side runtime utilities.
  */
+export type { QueryClientConfig, QueryKey, UseInfiniteQueryOptions, UseInfiniteQueryResult, UseMutationOptions, UseMutationResult, UseQueryOptions, UseQueryResult, UseSuspenseQueryOptions, UseSuspenseQueryResult, } from "@tanstack/react-query";
+export { keepPreviousData, QueryClient, QueryClientProvider, useInfiniteQuery, useIsFetching, useMutation, usePrefetchQuery, useQuery, useQueryClient, useSuspenseQuery, } from "@tanstack/react-query";
+export type { AppRouteContext } from "./context";
+export { createAppRootRoute } from "./context";
 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;AAGH,YAAY,EACV,iBAAiB,EACjB,QAAQ,EACR,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,cAAc,EACd,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,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,10 @@
 /**
  * Client-side runtime utilities.
  */
+export { keepPreviousData, QueryClient, QueryClientProvider, useInfiniteQuery, useIsFetching, useMutation, usePrefetchQuery, useQuery, useQueryClient, useSuspenseQuery, } from "@tanstack/react-query";
+export { createAppRootRoute } from "./context";
 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,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,cAAc,EACd,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,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,68 @@
+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 build-tools loader.
+ */
+export type ServerFunction<TArgs extends unknown[], TResponse> = (...args: TArgs) => Promise<TResponse>;
+/**
+ * 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 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>;
+    };
+}
+/**
+ * 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,94 @@
+import { useMutation, useQuery, useSuspenseQuery, } from "@tanstack/react-query";
+import { getFnId } from "./transport";
+function createHandler(fn, path) {
+    return {
+        useQuery: (args = [], options) => {
+            return useQuery({
+                ...options,
+                queryKey: [getFnId(fn) || path.join("."), ...args],
+                queryFn: () => fn(...args),
+            });
+        },
+        useSuspenseQuery: (args = [], options) => {
+            return useSuspenseQuery({
+                ...options,
+                queryKey: [getFnId(fn) || path.join("."), ...args],
+                queryFn: () => fn(...args),
+            });
+        },
+        useMutation: (options) => {
+            return useMutation({
+                ...options,
+                mutationFn: (variables) => fn(variables),
+            });
+        },
+        queryOptions: (args = [], options) => {
+            return {
+                ...options,
+                queryKey: [getFnId(fn) || path.join("."), ...args],
+                queryFn: () => fn(...args),
+            };
+        },
+        mutationOptions: (options) => {
+            return {
+                ...options,
+                mutationFn: (variables) => fn(variables),
+            };
+        },
+        queryKey: (args = []) => {
+            return [getFnId(fn) || path.join("."), ...args];
+        },
+        path: path.join("."),
+    };
+}
+function createProxy(type, source, path = []) {
+    const target = source ?? (() => { });
+    return new Proxy(target, {
+        get(_target, prop) {
+            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,55 @@
+/**
+ * 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;
+/**
+ * Look up the internal function ID for a server function stub.
+ * Returns undefined if the function is not a registered server function.
+ */
+export declare function getFnId(fn: (...args: any[]) => any): string | undefined;
+//# 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;AAiCD;;;GAGG;AAEH,wBAAgB,OAAO,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAAG,MAAM,GAAG,SAAS,CAEvE"}

package/esm/client/transport.js

@@ -0,0 +1,88 @@
+/**
+ * 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.
+ */
+export async function __ev_call(fnId, args, context) {
+    return getTransport().send(fnId, args, context);
+}
+/**
+ * Internal registry mapping server function references to their IDs.
+ * Uses WeakMap so function stubs can be garbage collected.
+ */
+// biome-ignore lint/suspicious/noExplicitAny: must accept any function shape
+const fnIdRegistry = new WeakMap();
+/**
+ * Register a server function stub with its ID.
+ *
+ * @internal Called by build-tools codegen. Do not use directly.
+ */
+// biome-ignore lint/suspicious/noExplicitAny: must accept any function shape
+export function __ev_register(fn, fnId) {
+    fnIdRegistry.set(fn, fnId);
+}
+/**
+ * Look up the internal function ID for a server function stub.
+ * Returns undefined if the function is not a registered server function.
+ */
+// biome-ignore lint/suspicious/noExplicitAny: must accept any function shape
+export function getFnId(fn) {
+    return fnIdRegistry.get(fn);
+}
+//# 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;;;;;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"}

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"}