@sylphx/lens-server 4.1.2 → 4.1.3

package/dist/index.d.ts

@@ -735,70 +735,6 @@ declare function createApp<
 */
 declare function createServerClientProxy(server: LensServer): unknown;
 /**
-* Handle a query request using standard Web Request/Response API.
-*
-* Expects input in URL search params as JSON string.
-*
-* @example
-* ```typescript
-* // GET /api/lens/user.get?input={"id":"123"}
-* const response = await handleWebQuery(server, 'user.get', url);
-* ```
-*/
-declare function handleWebQuery(server: LensServer, path: string, url: URL): Promise<Response>;
-/**
-* Handle a mutation request using standard Web Request/Response API.
-*
-* Expects input in request body as JSON.
-*
-* @example
-* ```typescript
-* // POST /api/lens/user.create with body { "input": { "name": "John" } }
-* const response = await handleWebMutation(server, 'user.create', request);
-* ```
-*/
-declare function handleWebMutation(server: LensServer, path: string, request: Request): Promise<Response>;
-/**
-* Handle an SSE subscription request using standard Web Request/Response API.
-*
-* Creates a ReadableStream that emits SSE events from the subscription.
-*
-* @example
-* ```typescript
-* // GET /api/lens/events.stream with Accept: text/event-stream
-* const response = handleWebSSE(server, 'events.stream', url, request.signal);
-* ```
-*/
-declare function handleWebSSE(server: LensServer, path: string, url: URL, signal?: AbortSignal): Response;
-/**
-* Options for creating a framework handler.
-*/
-interface FrameworkHandlerOptions {
-	/** Base path to strip from request URLs */
-	basePath?: string;
-}
-/**
-* Create a complete request handler for Web standard Request/Response.
-*
-* Handles:
-* - GET requests → Query execution
-* - POST requests → Mutation execution
-* - SSE requests (Accept: text/event-stream) → Subscriptions
-*
-* @example
-* ```typescript
-* const handler = createFrameworkHandler(server, { basePath: '/api/lens' });
-*
-* // In Next.js App Router:
-* const GET = handler;
-* const POST = handler;
-*
-* // In Fresh:
-* const handler = { GET: lensHandler, POST: lensHandler };
-* ```
-*/
-declare function createFrameworkHandler(server: LensServer, options?: FrameworkHandlerOptions): (request: Request) => Promise<Response>;
-/**
 * @sylphx/lens-server - SSE Handler
 *
 * Pure transport handler for Server-Sent Events.
@@ -1627,4 +1563,4 @@ declare function toBasicLogger(structuredLogger: StructuredLogger): {
 	warn: (message: string, ...args: unknown[]) => void;
 	error: (message: string, ...args: unknown[]) => void;
 };
-export { useContext, tryUseContext, toBasicLogger, runWithContextAsync, runWithContext, router, query, prettyOutput, optimisticPlugin, opLog, mutation, memoryStorage, jsonOutput, isOptimisticPlugin, isOpLogPlugin, hasContext, handleWebSSE, handleWebQuery, handleWebMutation, extendContext, estimatePatchSize, createWSHandler, createStructuredLogger, createServerClientProxy, createSSEHandler, createPluginManager, createFrameworkHandler, createContext, createApp, coalescePatches, WebSocketLike, WebSocketContext, WSHandlerOptions, WSHandlerConfig, WSHandler, UnsubscribeContext, SubscribeContext, StructuredLoggerOptions, StructuredLogger, StoredPatchEntry, StoredEntityState, ServerPlugin, ServerMetadata, LensServerConfig as ServerConfig, SelectionObject, SSEHandlerConfig as SSEHandlerOptions, SSEHandlerConfig, SSEHandler, SSEClient, RouterRoutes, RouterDef3 as RouterDef, RequestContext, QueryDef2 as QueryDef, QueriesMap, PluginManager, PerformanceContext, OptimisticPluginOptions, OperationsMap, OperationMeta, OperationLog, OpLogStorageConfig, OpLogStorage, OpLogPlugin, OpLogOptions, MutationsMap, MutationDef2 as MutationDef, LogOutput, LogLevel, LogEntry, LogContext, LensServer, LensResult, LensOperation, InferRouterContext3 as InferRouterContext, InferOutput, InferInput, InferApi, FrameworkHandlerOptions, ErrorContext, EntitiesMap, EnhanceOperationMetaContext, EmitResult, DisconnectContext, DEFAULT_WS_HANDLER_CONFIG, DEFAULT_STORAGE_CONFIG, ConnectContext, ClientSendFn, BroadcastResult, BeforeSendContext, BeforeMutationContext, AfterSendContext, AfterMutationContext };
+export { useContext, tryUseContext, toBasicLogger, runWithContextAsync, runWithContext, router, query, prettyOutput, optimisticPlugin, opLog, mutation, memoryStorage, jsonOutput, isOptimisticPlugin, isOpLogPlugin, hasContext, extendContext, estimatePatchSize, createWSHandler, createStructuredLogger, createServerClientProxy, createSSEHandler, createPluginManager, createContext, createApp, coalescePatches, WebSocketLike, WebSocketContext, WSHandlerOptions, WSHandlerConfig, WSHandler, UnsubscribeContext, SubscribeContext, StructuredLoggerOptions, StructuredLogger, StoredPatchEntry, StoredEntityState, ServerPlugin, ServerMetadata, LensServerConfig as ServerConfig, SelectionObject, SSEHandlerConfig as SSEHandlerOptions, SSEHandlerConfig, SSEHandler, SSEClient, RouterRoutes, RouterDef3 as RouterDef, RequestContext, QueryDef2 as QueryDef, QueriesMap, PluginManager, PerformanceContext, OptimisticPluginOptions, OperationsMap, OperationMeta, OperationLog, OpLogStorageConfig, OpLogStorage, OpLogPlugin, OpLogOptions, MutationsMap, MutationDef2 as MutationDef, LogOutput, LogLevel, LogEntry, LogContext, LensServer, LensResult, LensOperation, InferRouterContext3 as InferRouterContext, InferOutput, InferInput, InferApi, ErrorContext, EntitiesMap, EnhanceOperationMetaContext, EmitResult, DisconnectContext, DEFAULT_WS_HANDLER_CONFIG, DEFAULT_STORAGE_CONFIG, ConnectContext, ClientSendFn, BroadcastResult, BeforeSendContext, BeforeMutationContext, AfterSendContext, AfterMutationContext };

package/dist/index.js

@@ -1045,7 +1045,7 @@ class LensServerImpl {
         headers: baseHeaders
       });
     }
-    if (request.method === "POST" && (pathname === "/" || pathname === "")) {
+    if (request.method === "POST") {
       let body;
       try {
         body = await request.json();
@@ -1126,135 +1126,6 @@ function createServerClientProxy(server) {
   }
   return createProxy("");
 }
-async function handleWebQuery(server, path, url) {
-  try {
-    const inputParam = url.searchParams.get("input");
-    const input = inputParam ? JSON.parse(inputParam) : undefined;
-    const result = await firstValueFrom2(server.execute({ path, input }));
-    if (isError2(result)) {
-      return Response.json({ error: result.error }, { status: 400 });
-    }
-    if (isSnapshot2(result)) {
-      return Response.json(result);
-    }
-    return Response.json(result);
-  } catch (error) {
-    return Response.json({ error: error instanceof Error ? error.message : "Unknown error" }, { status: 500 });
-  }
-}
-async function handleWebMutation(server, path, request) {
-  try {
-    const body = await request.json();
-    const input = body.input;
-    const result = await firstValueFrom2(server.execute({ path, input }));
-    if (isError2(result)) {
-      return Response.json({ error: result.error }, { status: 400 });
-    }
-    if (isSnapshot2(result)) {
-      return Response.json(result);
-    }
-    return Response.json(result);
-  } catch (error) {
-    return Response.json({ error: error instanceof Error ? error.message : "Unknown error" }, { status: 500 });
-  }
-}
-function handleWebSSE(server, path, url, signal) {
-  const inputParam = url.searchParams.get("input");
-  let input;
-  if (inputParam) {
-    try {
-      input = JSON.parse(inputParam);
-    } catch (parseError) {
-      const encoder = new TextEncoder;
-      const errorStream = new ReadableStream({
-        start(controller) {
-          const errMsg = parseError instanceof Error ? parseError.message : "Invalid JSON";
-          const data = `event: error
-data: ${JSON.stringify({ error: `Invalid input JSON: ${errMsg}` })}
-
-`;
-          controller.enqueue(encoder.encode(data));
-          controller.close();
-        }
-      });
-      return new Response(errorStream, {
-        headers: {
-          "Content-Type": "text/event-stream",
-          "Cache-Control": "no-cache",
-          Connection: "keep-alive"
-        }
-      });
-    }
-  }
-  const stream = new ReadableStream({
-    start(controller) {
-      const encoder = new TextEncoder;
-      try {
-        const result = server.execute({ path, input });
-        if (result && typeof result === "object" && "subscribe" in result) {
-          const observable = result;
-          const subscription = observable.subscribe({
-            next: (value) => {
-              const data = `data: ${JSON.stringify(value)}
-
-`;
-              controller.enqueue(encoder.encode(data));
-            },
-            error: (err) => {
-              const data = `event: error
-data: ${JSON.stringify({ error: err.message })}
-
-`;
-              controller.enqueue(encoder.encode(data));
-              controller.close();
-            },
-            complete: () => {
-              controller.close();
-            }
-          });
-          if (signal) {
-            signal.addEventListener("abort", () => {
-              subscription.unsubscribe();
-              controller.close();
-            });
-          }
-        }
-      } catch (execError) {
-        const errMsg = execError instanceof Error ? execError.message : "Internal error";
-        const data = `event: error
-data: ${JSON.stringify({ error: errMsg })}
-
-`;
-        controller.enqueue(encoder.encode(data));
-        controller.close();
-      }
-    }
-  });
-  return new Response(stream, {
-    headers: {
-      "Content-Type": "text/event-stream",
-      "Cache-Control": "no-cache",
-      Connection: "keep-alive"
-    }
-  });
-}
-function createFrameworkHandler(server, options = {}) {
-  const basePath = options.basePath ?? "";
-  return async (request) => {
-    const url = new URL(request.url);
-    const path = url.pathname.replace(basePath, "").replace(/^\//, "");
-    if (request.headers.get("accept") === "text/event-stream") {
-      return handleWebSSE(server, path, url, request.signal);
-    }
-    if (request.method === "GET") {
-      return handleWebQuery(server, path, url);
-    }
-    if (request.method === "POST") {
-      return handleWebMutation(server, path, request);
-    }
-    return new Response("Method not allowed", { status: 405 });
-  };
-}
 // src/sse/handler.ts
 class SSEHandler {
   heartbeatInterval;
@@ -2818,9 +2689,6 @@ export {
   isOptimisticPlugin,
   isOpLogPlugin,
   hasContext,
-  handleWebSSE,
-  handleWebQuery,
-  handleWebMutation,
   extendContext,
   estimatePatchSize,
   createWSHandler,
@@ -2828,7 +2696,6 @@ export {
   createServerClientProxy,
   createSSEHandler,
   createPluginManager,
-  createFrameworkHandler,
   createContext,
   createApp,
   coalescePatches,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@sylphx/lens-server",
-	"version": "4.1.2",
+	"version": "4.1.3",
 	"description": "Server runtime for Lens API framework",
 	"type": "module",
 	"main": "./dist/index.js",

package/src/handlers/framework.ts

@@ -1,39 +1,15 @@
 /**
- * @sylphx/lens-server - Framework Handler Utilities
+ * @sylphx/lens-server - Framework Utilities
  *
- * Shared utilities for framework integrations (Next.js, Nuxt, SolidStart, Fresh, etc.).
- * These provide common implementations that framework packages can use instead of
- * duplicating the same logic.
+ * Utilities for framework integrations (Next.js, Nuxt, SolidStart, Fresh, etc.).
  *
  * @example
  * ```typescript
- * // In a framework integration package
- * import {
- *   createServerClientProxy,
- *   handleWebQuery,
- *   handleWebMutation,
- *   handleWebSSE,
- * } from '@sylphx/lens-server';
+ * import { createServerClientProxy } from '@sylphx/lens-server';
  *
+ * // Create a typed proxy for direct server-side calls
  * const serverClient = createServerClientProxy(server);
- *
- * function createHandler(server, basePath) {
- *   return async (request: Request) => {
- *     const url = new URL(request.url);
- *     const path = url.pathname.replace(basePath, '').replace(/^\//, '');
- *
- *     if (request.headers.get('accept') === 'text/event-stream') {
- *       return handleWebSSE(server, path, url, request.signal);
- *     }
- *     if (request.method === 'GET') {
- *       return handleWebQuery(server, path, url);
- *     }
- *     if (request.method === 'POST') {
- *       return handleWebMutation(server, path, request);
- *     }
- *     return new Response('Method not allowed', { status: 405 });
- *   };
- * }
+ * const users = await serverClient.user.list();
  * ```
  */
 
@@ -93,253 +69,3 @@ export function createServerClientProxy(server: LensServer): unknown {
 
 	return createProxy("");
 }
-
-// =============================================================================
-// Web Request Handlers
-// =============================================================================
-
-/**
- * Handle a query request using standard Web Request/Response API.
- *
- * Expects input in URL search params as JSON string.
- *
- * @example
- * ```typescript
- * // GET /api/lens/user.get?input={"id":"123"}
- * const response = await handleWebQuery(server, 'user.get', url);
- * ```
- */
-export async function handleWebQuery(
-	server: LensServer,
-	path: string,
-	url: URL,
-): Promise<Response> {
-	try {
-		const inputParam = url.searchParams.get("input");
-		const input = inputParam ? JSON.parse(inputParam) : undefined;
-
-		const result = await firstValueFrom(server.execute({ path, input }));
-
-		if (isError(result)) {
-			return Response.json({ error: result.error }, { status: 400 });
-		}
-
-		if (isSnapshot(result)) {
-			return Response.json(result);
-		}
-
-		// ops message - forward as-is
-		return Response.json(result);
-	} catch (error) {
-		return Response.json(
-			{ error: error instanceof Error ? error.message : "Unknown error" },
-			{ status: 500 },
-		);
-	}
-}
-
-/**
- * Handle a mutation request using standard Web Request/Response API.
- *
- * Expects input in request body as JSON.
- *
- * @example
- * ```typescript
- * // POST /api/lens/user.create with body { "input": { "name": "John" } }
- * const response = await handleWebMutation(server, 'user.create', request);
- * ```
- */
-export async function handleWebMutation(
-	server: LensServer,
-	path: string,
-	request: Request,
-): Promise<Response> {
-	try {
-		const body = (await request.json()) as { input?: unknown };
-		const input = body.input;
-
-		const result = await firstValueFrom(server.execute({ path, input }));
-
-		if (isError(result)) {
-			return Response.json({ error: result.error }, { status: 400 });
-		}
-
-		if (isSnapshot(result)) {
-			return Response.json(result);
-		}
-
-		// ops message - forward as-is
-		return Response.json(result);
-	} catch (error) {
-		return Response.json(
-			{ error: error instanceof Error ? error.message : "Unknown error" },
-			{ status: 500 },
-		);
-	}
-}
-
-/**
- * Handle an SSE subscription request using standard Web Request/Response API.
- *
- * Creates a ReadableStream that emits SSE events from the subscription.
- *
- * @example
- * ```typescript
- * // GET /api/lens/events.stream with Accept: text/event-stream
- * const response = handleWebSSE(server, 'events.stream', url, request.signal);
- * ```
- */
-export function handleWebSSE(
-	server: LensServer,
-	path: string,
-	url: URL,
-	signal?: AbortSignal,
-): Response {
-	const inputParam = url.searchParams.get("input");
-
-	// Parse input with error handling
-	let input: unknown;
-	if (inputParam) {
-		try {
-			input = JSON.parse(inputParam);
-		} catch (parseError) {
-			// Return error response for malformed JSON
-			const encoder = new TextEncoder();
-			const errorStream = new ReadableStream({
-				start(controller) {
-					const errMsg = parseError instanceof Error ? parseError.message : "Invalid JSON";
-					const data = `event: error\ndata: ${JSON.stringify({ error: `Invalid input JSON: ${errMsg}` })}\n\n`;
-					controller.enqueue(encoder.encode(data));
-					controller.close();
-				},
-			});
-			return new Response(errorStream, {
-				headers: {
-					"Content-Type": "text/event-stream",
-					"Cache-Control": "no-cache",
-					Connection: "keep-alive",
-				},
-			});
-		}
-	}
-
-	const stream = new ReadableStream({
-		start(controller) {
-			const encoder = new TextEncoder();
-
-			try {
-				const result = server.execute({ path, input });
-
-				if (result && typeof result === "object" && "subscribe" in result) {
-					const observable = result as {
-						subscribe: (handlers: {
-							next: (value: unknown) => void;
-							error: (err: Error) => void;
-							complete: () => void;
-						}) => { unsubscribe: () => void };
-					};
-
-					const subscription = observable.subscribe({
-						next: (value) => {
-							// Send full LensResult envelope (e.g. { "$": "snapshot", "data": ... })
-							// Client expects the complete message, not just the inner data
-							const data = `data: ${JSON.stringify(value)}\n\n`;
-							controller.enqueue(encoder.encode(data));
-						},
-						error: (err) => {
-							const data = `event: error\ndata: ${JSON.stringify({ error: err.message })}\n\n`;
-							controller.enqueue(encoder.encode(data));
-							controller.close();
-						},
-						complete: () => {
-							controller.close();
-						},
-					});
-
-					// Clean up on abort
-					if (signal) {
-						signal.addEventListener("abort", () => {
-							subscription.unsubscribe();
-							controller.close();
-						});
-					}
-				}
-			} catch (execError) {
-				// Handle synchronous errors from server.execute() or subscribe()
-				const errMsg = execError instanceof Error ? execError.message : "Internal error";
-				const data = `event: error\ndata: ${JSON.stringify({ error: errMsg })}\n\n`;
-				controller.enqueue(encoder.encode(data));
-				controller.close();
-			}
-		},
-	});
-
-	return new Response(stream, {
-		headers: {
-			"Content-Type": "text/event-stream",
-			"Cache-Control": "no-cache",
-			Connection: "keep-alive",
-		},
-	});
-}
-
-// =============================================================================
-// Full Handler Factory
-// =============================================================================
-
-/**
- * Options for creating a framework handler.
- */
-export interface FrameworkHandlerOptions {
-	/** Base path to strip from request URLs */
-	basePath?: string;
-}
-
-/**
- * Create a complete request handler for Web standard Request/Response.
- *
- * Handles:
- * - GET requests → Query execution
- * - POST requests → Mutation execution
- * - SSE requests (Accept: text/event-stream) → Subscriptions
- *
- * @example
- * ```typescript
- * const handler = createFrameworkHandler(server, { basePath: '/api/lens' });
- *
- * // In Next.js App Router:
- * export const GET = handler;
- * export const POST = handler;
- *
- * // In Fresh:
- * export const handler = { GET: lensHandler, POST: lensHandler };
- * ```
- */
-export function createFrameworkHandler(
-	server: LensServer,
-	options: FrameworkHandlerOptions = {},
-): (request: Request) => Promise<Response> {
-	const basePath = options.basePath ?? "";
-
-	return async (request: Request): Promise<Response> => {
-		const url = new URL(request.url);
-		const path = url.pathname.replace(basePath, "").replace(/^\//, "");
-
-		// Handle SSE subscription
-		if (request.headers.get("accept") === "text/event-stream") {
-			return handleWebSSE(server, path, url, request.signal);
-		}
-
-		// Handle query (GET)
-		if (request.method === "GET") {
-			return handleWebQuery(server, path, url);
-		}
-
-		// Handle mutation (POST)
-		if (request.method === "POST") {
-			return handleWebMutation(server, path, request);
-		}
-
-		return new Response("Method not allowed", { status: 405 });
-	};
-}

package/src/handlers/index.ts

@@ -6,17 +6,10 @@
  */
 
 // =============================================================================
-// Framework Handler Utilities (for framework packages)
+// Server Client Proxy (for framework packages)
 // =============================================================================
 
-export {
-	createFrameworkHandler,
-	createServerClientProxy,
-	type FrameworkHandlerOptions,
-	handleWebMutation,
-	handleWebQuery,
-	handleWebSSE,
-} from "./framework.js";
+export { createServerClientProxy } from "./framework.js";
 
 // =============================================================================
 // SSE Handler

package/src/index.ts

@@ -93,17 +93,10 @@ export {
 } from "./handlers/index.js";
 
 // =============================================================================
-// Framework Integration Utilities (internal use)
+// Server Client Proxy (for framework packages)
 // =============================================================================
 
-export {
-	createFrameworkHandler,
-	createServerClientProxy,
-	type FrameworkHandlerOptions,
-	handleWebMutation,
-	handleWebQuery,
-	handleWebSSE,
-} from "./handlers/index.js";
+export { createServerClientProxy } from "./handlers/index.js";
 
 // =============================================================================
 // Plugin System

package/src/server/create.ts

@@ -1276,8 +1276,8 @@ class LensServerImpl<
 			});
 		}
 
-		// Operations: POST /
-		if (request.method === "POST" && (pathname === "/" || pathname === "")) {
+		// Operations: POST to any path (client sends path in body)
+		if (request.method === "POST") {
 			let body: { path?: string; input?: unknown };
 			try {
 				body = (await request.json()) as typeof body;