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

package/AGENT.md

@@ -51,28 +51,28 @@ const usersRoute = createRoute({
 
 ### Transport
 ```tsx
-import { configureTransport } from "@evjs/runtime/client";
+import { initTransport } from "@evjs/runtime/client";
 
 // Simple: custom base URL and endpoint path
-configureTransport({
+initTransport({
   baseUrl: "https://api.example.com",
-  endpoint: "/server-function",  // default: "/api/rpc"
+  endpoint: "/server-function",  // default: "/api/fn"
 });
 
 // Advanced: fully custom transport
-configureTransport({ transport: { send: async (fnId, args) => { /* custom */ } } });
+initTransport({ transport: { send: async (fnId, args) => { /* custom */ } } });
 ```
 
 ## Server API (`@evjs/runtime/server`)
 
-- `createApp(options?)` — Create Hono app with RPC middleware. Options: `{ rpcEndpoint?: string, port?: number }`. Default RPC path: `/api/rpc`.
-- `runNodeServer(app, { port?, host? })` — Start on Node.js (default port 3001).
+- `createApp(options?)` — Create Hono app with server function handler. Options: `{ endpoint?: string, port?: number }`. Default endpoint path: `/api/fn`.
+- `serve(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.
+- `createHandler()` — Standalone Hono server function handler.
 
 ## ECMA Adapter (`@evjs/runtime/server/ecma`)
 
-- `createHandler(app)` — Wraps a Hono app for deployment to Deno, Bun, Cloudflare Workers, or any Fetch API-compatible runtime.
+- `createFetchHandler(app)` — Wraps a Hono app for deployment to Deno, Bun, or any Fetch-compatible runtime.
 
 ## Server Functions
 Files must start with `"use server";`, use named async exports, and end in `.server.ts`.

package/README.md

@@ -19,7 +19,9 @@ npm install @evjs/runtime
 | `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) |
+| `initTransport` | One-time transport configuration (endpoint, custom transport, codec) |
+| `ServerFunctionError` | Structured error class for server function failures |
+| `jsonCodec` | Default JSON codec |
 | `createRootRoute`, `createRoute`, `Link`, `Outlet`, ... | Re-exports from `@tanstack/react-router` |
 | `useQuery`, `useMutation`, `useQueryClient`, ... | Re-exports from `@tanstack/react-query` |
 
@@ -27,16 +29,25 @@ npm install @evjs/runtime
 
 | Export | Description |
 |--------|-------------|
-| `createApp` | Create a Hono app with RPC middleware (`rpcEndpoint` option) |
-| `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 |
+| `createApp` | Create a Hono app with server function handler |
+| `createHandler` | Standalone Hono sub-app for server function dispatch |
+| `dispatch` | Protocol-agnostic dispatcher for custom transports (WebSocket, IPC) |
+| `registerMiddleware` | Register middleware for all server function calls |
+| `registerServerFn` | Register a server function in the registry |
+| `ServerError` | Throwable error with structured data and custom status |
+| `jsonCodec` | Default JSON codec |
+
+### `@evjs/runtime/server/node`
+
+| Export | Description |
+|--------|-------------|
+| `serve` | Start the app on Node.js (default port 3001) |
 
 ### `@evjs/runtime/server/ecma`
 
 | Export | Description |
 |--------|-------------|
-| `createHandler` | Wrap Hono app for Deno, Bun, Cloudflare Workers |
+| `createFetchHandler` | Wrap Hono app for Deno, Bun, or any Fetch-compatible runtime |
 
 ## Usage
 
@@ -47,8 +58,10 @@ import { createApp, createRootRoute, query, mutation } from "@evjs/runtime/clien
 import { getUsers, createUser } from "./api/users.server";
 
 function Users() {
-  const { data } = query(getUsers).useQuery([]);
-  const { mutate } = mutation(createUser).useMutation();
+  const { data } = query(getUsers).useQuery();
+  const { mutate } = mutation(createUser).useMutation({
+    invalidates: [getUsers],  // auto-invalidate on success
+  });
 }
 
 const rootRoute = createRootRoute({ component: Root });
@@ -58,58 +71,101 @@ app.render("#app");
 
 ### Server
 
-The server app is a runtime-agnostic Hono instance. Use a Runner to start it:
-
 ```ts
-import { createApp, runNodeServer } from "@evjs/runtime/server";
+import { createApp } from "@evjs/runtime/server";
+import { serve } from "@evjs/runtime/server/node";
 
 const app = createApp();
-runNodeServer(app, { port: 3001 });
+serve(app, { port: 3001 });
 ```
 
-In development, `ev dev` with `runner` configured in `EvWebpackPlugin` handles this automatically.
-
-### Custom Endpoint
+### Custom Transport
 
 ```ts
-import { configureTransport } from "@evjs/runtime/client";
+import { initTransport } from "@evjs/runtime/client";
 
-configureTransport({
+// Custom endpoint
+initTransport({
   baseUrl: "https://api.example.com",
-  endpoint: "/server-function",  // default: "/api/rpc"
+  endpoint: "/server-function",  // default: "/api/fn"
+});
+
+// Custom protocol (e.g. WebSocket)
+initTransport({
+  transport: {
+    send: async (fnId, args) => { /* your protocol */ },
+  },
+});
+
+// Custom serialization
+initTransport({
+  codec: { serialize: msgpack.encode, deserialize: msgpack.decode, contentType: "application/msgpack" },
 });
 ```
 
-### Custom Transport
+### Server Middleware
 
 ```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;
-    },
-  },
+import { registerMiddleware } from "@evjs/runtime/server";
+
+registerMiddleware(async (ctx, next) => {
+  console.log(`Calling ${ctx.fnId}`);
+  const start = Date.now();
+  const result = await next();
+  console.log(`${ctx.fnId} took ${Date.now() - start}ms`);
+  return result;
 });
 ```
 
+### Typed Errors
+
+```ts
+import { ServerError } from "@evjs/runtime/server";
+
+export async function getUser(id: string) {
+  const user = db.find(id);
+  if (!user) throw new ServerError("User not found", { status: 404, data: { id } });
+  return user;
+}
+```
+
 ### Query Proxy Patterns
 
 ```tsx
-// A. Direct wrapper (single function)
-const { data } = query(getUsers).useQuery([]);
+// Direct wrapper
+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]);
+// With args
+const { data } = query(getUser).useQuery(userId);
+
+// Query invalidation
+query(getUsers).invalidate();
+
+// queryOptions (for prefetching)
+const options = query(getUsers).queryOptions();
 queryClient.prefetchQuery(options);
+
+// Module proxy
+import * as UsersAPI from "./api/users.server";
+const api = createQueryProxy(UsersAPI);
+const { data } = api.getUsers.useQuery();
+```
+
+### Custom Transport (WebSocket)
+
+```ts
+import { initTransport } from "@evjs/runtime/client";
+
+initTransport({
+  transport: {
+    send: async (fnId, args) => {
+      return new Promise((resolve, reject) => {
+        ws.send(JSON.stringify({ id: ++reqId, fnId, args }));
+        pending.set(reqId, { resolve, reject });
+      });
+    },
+  },
+});
 ```
+
+See [`examples/websocket-fns`](../../examples/websocket-fns) for a full working example.

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

@@ -14,6 +14,11 @@ export interface CreateAppOptions<TRouteTree extends AnyRoute> {
      * Optional configuration for the TanStack Query Client.
      */
     queryClientConfig?: QueryClientConfig;
+    /**
+     * server function endpoint path. When provided, automatically configures the transport.
+     * Defaults to `/api/fn` if not specified.
+     */
+    endpoint?: string;
 }
 /**
  * An initialized ev application instance.

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,CAgCL"}
+{"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;AAKlE;;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;IACtC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;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,CAoCL"}

package/esm/client/create-app.js

@@ -2,6 +2,7 @@ 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";
+import { initTransport } from "./transport";
 /**
  * Create a new ev application instance.
  *
@@ -18,7 +19,10 @@ import { createRoot } from "react-dom/client";
  * ```
  */
 export function createApp(options) {
-    const { routeTree, routerOptions, queryClientConfig } = options;
+    const { routeTree, routerOptions, queryClientConfig, endpoint } = options;
+    if (endpoint) {
+        initTransport({ endpoint: endpoint });
+    }
     const queryClient = new QueryClient(queryClientConfig);
     const router = createRouter({
         ...routerOptions,

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;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"}
+{"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;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAyC5C;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,SAAS,CACvB,OAAqC;IAErC,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,iBAAiB,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAE1E,IAAI,QAAQ,EAAE,CAAC;QACb,aAAa,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,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

@@ -3,12 +3,17 @@
  */
 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 { Codec } from "../codec";
+export { jsonCodec } from "../codec";
+export { ServerFunctionError } from "../errors";
 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 type { MutationProxy, MutationProxyHandler, QueryProxy, QueryProxyHandler, ServerFunction, } from "./query";
+export { createMutationProxy, createQueryProxy, mutation, query, } from "./query";
+export type { AnyRootRoute, AnyRoute, AnyRouteMatch, AnyRouter, ErrorComponentProps, ErrorRouteComponent, LinkOptions, LinkProps, NavigateOptions, NotFoundError, NotFoundRouteComponent, NotFoundRouteProps, RegisteredRouter, RouteComponent, RouteMatch, RouterOptions, RouterState, SearchSchemaInput, } from "./route";
+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 "./route";
 export type { RequestContext, ServerTransport, TransportOptions, } from "./transport";
-export { configureTransport } from "./transport";
+export { getFnName, initTransport } 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;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"}
+{"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,KAAK,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,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,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,UAAU,EACV,iBAAiB,EACjB,cAAc,GACf,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,QAAQ,EACR,KAAK,GACN,MAAM,SAAS,CAAC;AACjB,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,SAAS,CAAC;AACjB,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,SAAS,CAAC;AACjB,YAAY,EACV,cAAc,EACd,eAAe,EACf,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/esm/client/index.js

@@ -2,9 +2,11 @@
  * Client-side runtime utilities.
  */
 export { keepPreviousData, QueryClient, QueryClientProvider, useInfiniteQuery, useIsFetching, useMutation, usePrefetchQuery, useQuery, useQueryClient, useSuspenseQuery, } from "@tanstack/react-query";
+export { jsonCodec } from "../codec";
+export { ServerFunctionError } from "../errors";
 export { createAppRootRoute } from "./context";
 export { createApp } from "./create-app";
-export * from "./query";
-export * from "./route";
-export { configureTransport } from "./transport";
+export { createMutationProxy, createQueryProxy, mutation, query, } from "./query";
+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 "./route";
+export { getFnName, initTransport } 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;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"}
+{"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,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAQzC,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,QAAQ,EACR,KAAK,GACN,MAAM,SAAS,CAAC;AAqBjB,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,SAAS,CAAC;AAMjB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/esm/client/query.d.ts

@@ -10,16 +10,27 @@ 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>;
+    useQuery(...args: [
+        ...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>;
+    useSuspenseQuery(...args: [
+        ...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> & {
+    queryOptions(...args: [
+        ...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[];
+    queryKey(...args: TArgs): unknown[];
+    /** Invalidate cached queries for this function. */
+    invalidate(...args: TArgs): void;
 }
 /**
  * The interface for a single server function's mutation proxy.
@@ -28,7 +39,10 @@ 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>;
+    useMutation(options?: Omit<UseMutationOptions<TResponse, Error, TVariables>, "mutationFn"> & {
+        /** Server functions whose queries should be invalidated on success. */
+        invalidates?: ((...args: unknown[]) => unknown)[];
+    }): 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>;

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

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

package/esm/client/query.js

@@ -1,32 +1,64 @@
-import { useMutation, useQuery, useSuspenseQuery, } from "@tanstack/react-query";
-import { getFnId } from "./transport";
+import { useMutation, useQuery, useQueryClient, useSuspenseQuery, } from "@tanstack/react-query";
+import { __ev_call, getFnId } from "./transport";
+function splitArgsAndOptions(rawArgs) {
+    const last = rawArgs[rawArgs.length - 1];
+    if (rawArgs.length > 0 &&
+        last != null &&
+        typeof last === "object" &&
+        !Array.isArray(last) &&
+        // Plain object check — rules out class instances, Dates, etc.
+        Object.getPrototypeOf(last) === Object.prototype) {
+        return {
+            args: rawArgs.slice(0, -1),
+            options: last,
+        };
+    }
+    return { args: rawArgs };
+}
 function createHandler(fn, path) {
+    const fnId = getFnId(fn);
     return {
-        useQuery: (args = [], options) => {
+        useQuery: (...rawArgs) => {
+            const { args, options } = splitArgsAndOptions(rawArgs);
             return useQuery({
                 ...options,
-                queryKey: [getFnId(fn) || path.join("."), ...args],
-                queryFn: () => fn(...args),
+                queryKey: [fnId || path.join("."), ...args],
+                queryFn: ({ signal }) => __ev_call(fnId || path.join("."), args, { signal }),
             });
         },
-        useSuspenseQuery: (args = [], options) => {
+        useSuspenseQuery: (...rawArgs) => {
+            const { args, options } = splitArgsAndOptions(rawArgs);
             return useSuspenseQuery({
                 ...options,
-                queryKey: [getFnId(fn) || path.join("."), ...args],
-                queryFn: () => fn(...args),
+                queryKey: [fnId || path.join("."), ...args],
+                queryFn: ({ signal }) => __ev_call(fnId || path.join("."), args, { signal }),
             });
         },
         useMutation: (options) => {
+            const queryClient = useQueryClient();
+            const { invalidates, ...restOptions } = options ?? {};
             return useMutation({
-                ...options,
+                ...restOptions,
                 mutationFn: (variables) => fn(variables),
+                onSuccess: (...onSuccessArgs) => {
+                    if (invalidates) {
+                        for (const target of invalidates) {
+                            const targetId = getFnId(target);
+                            if (targetId) {
+                                queryClient.invalidateQueries({ queryKey: [targetId] });
+                            }
+                        }
+                    }
+                    restOptions?.onSuccess?.(...onSuccessArgs);
+                },
             });
         },
-        queryOptions: (args = [], options) => {
+        queryOptions: (...rawArgs) => {
+            const { args, options } = splitArgsAndOptions(rawArgs);
             return {
                 ...options,
-                queryKey: [getFnId(fn) || path.join("."), ...args],
-                queryFn: () => fn(...args),
+                queryKey: [fnId || path.join("."), ...args],
+                queryFn: ({ signal }) => __ev_call(fnId || path.join("."), args, { signal }),
             };
         },
         mutationOptions: (options) => {
@@ -35,8 +67,14 @@ function createHandler(fn, path) {
                 mutationFn: (variables) => fn(variables),
             };
         },
-        queryKey: (args = []) => {
-            return [getFnId(fn) || path.join("."), ...args];
+        queryKey: (...args) => {
+            return [fnId || path.join("."), ...args];
+        },
+        invalidate: (...args) => {
+            const queryClient = useQueryClient();
+            queryClient.invalidateQueries({
+                queryKey: [fnId || path.join("."), ...args],
+            });
         },
         path: path.join("."),
     };

package/esm/client/query.js.map

@@ -1 +1 @@
-{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/client/query.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/client/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,WAAW,EACX,QAAQ,EACR,cAAc,EACd,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAuGjD,SAAS,mBAAmB,CAAC,OAAkB;IAI7C,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACzC,IACE,OAAO,CAAC,MAAM,GAAG,CAAC;QAClB,IAAI,IAAI,IAAI;QACZ,OAAO,IAAI,KAAK,QAAQ;QACxB,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QACpB,8DAA8D;QAC9D,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,SAAS,EAChD,CAAC;QACD,OAAO;YACL,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC1B,OAAO,EAAE,IAA+B;SACzC,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC3B,CAAC;AAED,SAAS,aAAa,CAAC,EAAsC,EAAE,IAAc;IAC3E,MAAM,IAAI,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;IACzB,OAAO;QACL,QAAQ,EAAE,CAAC,GAAG,OAAkB,EAAE,EAAE;YAClC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;YACvD,OAAO,QAAQ,CAAC;gBACd,GAAG,OAAO;gBACV,QAAQ,EAAE,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC;gBAC3C,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CACtB,SAAS,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC;aACtD,CAAC,CAAC;QACL,CAAC;QACD,gBAAgB,EAAE,CAAC,GAAG,OAAkB,EAAE,EAAE;YAC1C,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;YACvD,OAAO,gBAAgB,CAAC;gBACtB,GAAG,OAAO;gBACV,QAAQ,EAAE,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC;gBAC3C,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CACtB,SAAS,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC;aACtD,CAAC,CAAC;QACL,CAAC;QACD,WAAW,EAAE,CACX,OAKC,EACD,EAAE;YACF,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;YACrC,MAAM,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;YACtD,OAAO,WAAW,CAAC;gBACjB,GAAG,WAAW;gBACd,UAAU,EAAE,CAAC,SAAkB,EAAE,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC;gBACjD,SAAS,EAAE,CAAC,GAAG,aAAa,EAAE,EAAE;oBAC9B,IAAI,WAAW,EAAE,CAAC;wBAChB,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,CAAC;4BACjC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;4BACjC,IAAI,QAAQ,EAAE,CAAC;gCACb,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;4BAC1D,CAAC;wBACH,CAAC;oBACH,CAAC;oBAEC,WACD,EAAE,SAAS,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC;gBACnC,CAAC;aACF,CAAC,CAAC;QACL,CAAC;QACD,YAAY,EAAE,CAAC,GAAG,OAAkB,EAAE,EAAE;YACtC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;YACvD,OAAO;gBACL,GAAG,OAAO;gBACV,QAAQ,EAAE,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC;gBAC3C,OAAO,EAAE,CAAC,EAAE,MAAM,EAA4B,EAAE,EAAE,CAChD,SAAS,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC;aACtD,CAAC;QACJ,CAAC;QACD,eAAe,EAAE,CACf,OAAyE,EACzE,EAAE;YACF,OAAO;gBACL,GAAG,OAAO;gBACV,UAAU,EAAE,CAAC,SAAkB,EAAE,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC;aAClD,CAAC;QACJ,CAAC;QACD,QAAQ,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE;YAC/B,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;QAC3C,CAAC;QACD,UAAU,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE;YACjC,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;YACrC,WAAW,CAAC,iBAAiB,CAAC;gBAC5B,QAAQ,EAAE,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC;aAC5C,CAAC,CAAC;QACL,CAAC;QACD,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;KACrB,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAClB,IAA0B,EAC1B,MAAgB,EAChB,OAAiB,EAAE;IAEnB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACpC,OAAO,IAAI,KAAK,CAAC,MAAgB,EAAE;QACjC,GAAG,CAAC,OAAO,EAAE,IAAY;YACvB,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC;YAChC,MAAM,GAAG,GAAG,MAAM;gBAChB,CAAC,CAAE,MAAkC,CAAC,IAAI,CAAC;gBAC3C,CAAC,CAAC,SAAS,CAAC;YAEd,iEAAiE;YACjE,IAAI,OAAO,GAAG,KAAK,UAAU,EAAE,CAAC;gBAC9B,OAAO,aAAa,CAClB,GAAoD,EACpD,OAAO,CACR,CAAC;YACJ,CAAC;YAED,kCAAkC;YAClC,OAAO,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QACzC,CAAC;QACD,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI;YAC3B,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAkD,CAAC;YACpE,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;gBAC7B,OAAO,aAAa,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YACjC,CAAC;YACD,OAAO,EAAE,CAAC,CAAC,WAAW;QACxB,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAI,MAAU;IAC5C,OAAO,WAAW,CAAC,OAAO,EAAE,MAAM,CAAkB,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAI,MAAU;IAC/C,OAAO,WAAW,CAAC,UAAU,EAAE,MAAM,CAAqB,CAAC;AAC7D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAMH,CAAC;AAEtC;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,WAAW,CAAC,UAAU,CAGN,CAAC"}

package/esm/client/transport.d.ts

@@ -5,6 +5,7 @@
  * bundle, each exported function is replaced with a stub that calls
  * `__ev_call(fnId, args)`. This module provides that helper.
  */
+import { type Codec } from "../codec";
 /**
  * Request context passed through server calls.
  * Used during SSR to forward headers/cookies, and in RSC for streaming.
@@ -35,18 +36,25 @@ export interface ServerTransport {
     stream?(fnId: string, args: unknown[], context?: RequestContext): ReadableStream<Uint8Array>;
 }
 export interface TransportOptions {
-    /** Base URL for the RPC endpoint. Defaults to the current origin. */
+    /** Base URL for the server function endpoint. Defaults to the current origin. */
     baseUrl?: string;
-    /** Path prefix for the RPC endpoint. Defaults to `/api/rpc`. */
+    /** Path prefix for the server function endpoint. Defaults to `/api/fn`. */
     endpoint?: string;
     /** Custom transport. When provided, `baseUrl` and `endpoint` are ignored. */
     transport?: ServerTransport;
+    /** Custom codec. Defaults to JSON. */
+    codec?: Codec;
 }
 /**
  * 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;
+export declare function initTransport(options: TransportOptions): void;
+/**
+ * Look up the human-readable export name for a function ID.
+ * Falls back to the fnId itself if no name is registered.
+ */
+export declare function getFnName(fnId: string): string;
 /**
  * Look up the internal function ID for a server function stub.
  * Returns undefined if the function is not a registered server function.

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

@@ -1 +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"}
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/client/transport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,KAAK,EAAa,MAAM,UAAU,CAAC;AAQjD;;;;;;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,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,sCAAsC;IACtC,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAiED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAgB7D;AA4BD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAmBD;;;GAGG;AAEH,wBAAgB,OAAO,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAAG,MAAM,GAAG,SAAS,CAEvE"}