@sylphx/lens-server 2.1.0 → 2.3.0

package/src/e2e/server.test.ts

@@ -8,7 +8,7 @@
  */
 
 import { describe, expect, it } from "bun:test";
-import { entity, lens, mutation, query, t } from "@sylphx/lens-core";
+import { entity, firstValueFrom, lens, mutation, query, t } from "@sylphx/lens-core";
 import { z } from "zod";
 import { optimisticPlugin } from "../plugin/optimistic.js";
 import { createApp } from "../server/create.js";
@@ -58,7 +58,7 @@ describe("E2E - Basic Operations", () => {
 			queries: { getUsers },
 		});
 
-		const result = await server.execute({ path: "getUsers" });
+		const result = await firstValueFrom(server.execute({ path: "getUsers" }));
 
 		expect(result.error).toBeUndefined();
 		expect(result.data).toEqual(mockUsers);
@@ -79,10 +79,12 @@ describe("E2E - Basic Operations", () => {
 			queries: { getUser },
 		});
 
-		const result = await server.execute({
-			path: "getUser",
-			input: { id: "user-1" },
-		});
+		const result = await firstValueFrom(
+			server.execute({
+				path: "getUser",
+				input: { id: "user-1" },
+			}),
+		);
 
 		expect(result.error).toBeUndefined();
 		expect(result.data).toEqual(mockUsers[0]);
@@ -104,10 +106,12 @@ describe("E2E - Basic Operations", () => {
 			mutations: { createUser },
 		});
 
-		const result = await server.execute({
-			path: "createUser",
-			input: { name: "Charlie", email: "charlie@example.com" },
-		});
+		const result = await firstValueFrom(
+			server.execute({
+				path: "createUser",
+				input: { name: "Charlie", email: "charlie@example.com" },
+			}),
+		);
 
 		expect(result.error).toBeUndefined();
 		expect(result.data).toEqual({
@@ -129,10 +133,12 @@ describe("E2E - Basic Operations", () => {
 			queries: { failingQuery },
 		});
 
-		const result = await server.execute({
-			path: "failingQuery",
-			input: { id: "123" },
-		});
+		const result = await firstValueFrom(
+			server.execute({
+				path: "failingQuery",
+				input: { id: "123" },
+			}),
+		);
 
 		expect(result.data).toBeUndefined();
 		expect(result.error).toBeInstanceOf(Error);
@@ -142,10 +148,12 @@ describe("E2E - Basic Operations", () => {
 	it("handles unknown operation", async () => {
 		const server = createApp({});
 
-		const result = await server.execute({
-			path: "unknownOperation",
-			input: {},
-		});
+		const result = await firstValueFrom(
+			server.execute({
+				path: "unknownOperation",
+				input: {},
+			}),
+		);
 
 		expect(result.data).toBeUndefined();
 		expect(result.error?.message).toContain("not found");
@@ -172,10 +180,12 @@ describe("E2E - Context", () => {
 			context: () => ({ userId: "ctx-user-1", role: "admin" }),
 		});
 
-		await server.execute({
-			path: "getUser",
-			input: { id: "user-1" },
-		});
+		await firstValueFrom(
+			server.execute({
+				path: "getUser",
+				input: { id: "user-1" },
+			}),
+		);
 
 		expect(capturedContext).toMatchObject({
 			userId: "ctx-user-1",
@@ -201,10 +211,12 @@ describe("E2E - Context", () => {
 			},
 		});
 
-		await server.execute({
-			path: "getUser",
-			input: { id: "user-1" },
-		});
+		await firstValueFrom(
+			server.execute({
+				path: "getUser",
+				input: { id: "user-1" },
+			}),
+		);
 
 		expect(capturedContext).toMatchObject({
 			userId: "async-user",
@@ -232,13 +244,15 @@ describe("E2E - Selection", () => {
 			queries: { getUser },
 		});
 
-		const result = await server.execute({
-			path: "getUser",
-			input: {
-				id: "user-1",
-				$select: { name: true },
-			},
-		});
+		const result = await firstValueFrom(
+			server.execute({
+				path: "getUser",
+				input: {
+					id: "user-1",
+					$select: { name: true },
+				},
+			}),
+		);
 
 		expect(result.error).toBeUndefined();
 		// Should include id (always) and selected fields
@@ -262,13 +276,15 @@ describe("E2E - Selection", () => {
 			queries: { getUser },
 		});
 
-		const result = await server.execute({
-			path: "getUser",
-			input: {
-				id: "user-1",
-				$select: { email: true },
-			},
-		});
+		const result = await firstValueFrom(
+			server.execute({
+				path: "getUser",
+				input: {
+					id: "user-1",
+					$select: { email: true },
+				},
+			}),
+		);
 
 		expect(result.data).toEqual({
 			id: "user-1",
@@ -318,20 +334,22 @@ describe("E2E - Entity Resolvers", () => {
 		});
 
 		// Test with $select for nested posts
-		const result = await server.execute({
-			path: "getUser",
-			input: {
-				id: "user-1",
-				$select: {
-					name: true,
-					posts: {
-						select: {
-							title: true,
+		const result = await firstValueFrom(
+			server.execute({
+				path: "getUser",
+				input: {
+					id: "user-1",
+					$select: {
+						name: true,
+						posts: {
+							select: {
+								title: true,
+							},
 						},
 					},
 				},
-			},
-		});
+			}),
+		);
 
 		expect(result.error).toBeUndefined();
 		expect(result.data).toMatchObject({
@@ -380,19 +398,21 @@ describe("E2E - Entity Resolvers", () => {
 		});
 
 		// Execute query with nested selection for all users
-		const result = await server.execute({
-			path: "getUsers",
-			input: {
-				$select: {
-					name: true,
-					posts: {
-						select: {
-							title: true,
+		const result = await firstValueFrom(
+			server.execute({
+				path: "getUsers",
+				input: {
+					$select: {
+						name: true,
+						posts: {
+							select: {
+								title: true,
+							},
 						},
 					},
 				},
-			},
-		});
+			}),
+		);
 
 		expect(result.error).toBeUndefined();
 		// Resolvers are called - exact count depends on DataLoader batching behavior

package/src/handlers/framework.ts

@@ -37,6 +37,7 @@
  * ```
  */
 
+import { firstValueFrom } from "@sylphx/lens-core";
 import type { LensServer } from "../server/create.js";
 
 // =============================================================================
@@ -74,7 +75,7 @@ export function createServerClientProxy(server: LensServer): unknown {
 			},
 			async apply(_, __, args) {
 				const input = args[0];
-				const result = await server.execute({ path, input });
+				const result = await firstValueFrom(server.execute({ path, input }));
 
 				if (result.error) {
 					throw result.error;
@@ -112,7 +113,7 @@ export async function handleWebQuery(
 		const inputParam = url.searchParams.get("input");
 		const input = inputParam ? JSON.parse(inputParam) : undefined;
 
-		const result = await server.execute({ path, input });
+		const result = await firstValueFrom(server.execute({ path, input }));
 
 		if (result.error) {
 			return Response.json({ error: result.error.message }, { status: 400 });
@@ -147,7 +148,7 @@ export async function handleWebMutation(
 		const body = (await request.json()) as { input?: unknown };
 		const input = body.input;
 
-		const result = await server.execute({ path, input });
+		const result = await firstValueFrom(server.execute({ path, input }));
 
 		if (result.error) {
 			return Response.json({ error: result.error.message }, { status: 400 });

package/src/handlers/http.ts

@@ -5,6 +5,7 @@
  * Works with Bun, Node (with adapter), Vercel, Cloudflare Workers.
  */
 
+import { firstValueFrom } from "@sylphx/lens-core";
 import type { LensServer } from "../server/create.js";
 
 // =============================================================================
@@ -139,10 +140,12 @@ export function createHTTPHandler(
 					});
 				}
 
-				const result = await server.execute({
-					path: operationPath,
-					input: body.input,
-				});
+				const result = await firstValueFrom(
+					server.execute({
+						path: operationPath,
+						input: body.input,
+					}),
+				);
 
 				if (result.error) {
 					return new Response(JSON.stringify({ error: result.error.message }), {

package/src/handlers/ws.ts

@@ -22,7 +22,11 @@
  * ```
  */
 
-import type { ReconnectMessage, ReconnectSubscription } from "@sylphx/lens-core";
+import {
+	firstValueFrom,
+	type ReconnectMessage,
+	type ReconnectSubscription,
+} from "@sylphx/lens-core";
 import type { LensServer, WebSocketLike } from "../server/create.js";
 import type {
 	ClientConnection,
@@ -174,7 +178,7 @@ export function createWSHandler(server: LensServer, options: WSHandlerOptions =
 		// Execute query first to get data
 		let result: { data?: unknown; error?: Error };
 		try {
-			result = await server.execute({ path: operation, input });
+			result = await firstValueFrom(server.execute({ path: operation, input }));
 
 			if (result.error) {
 				conn.ws.send(
@@ -349,10 +353,12 @@ export function createWSHandler(server: LensServer, options: WSHandlerOptions =
 	// Handle query
 	async function handleQuery(conn: ClientConnection, message: QueryMessage): Promise<void> {
 		try {
-			const result = await server.execute({
-				path: message.operation,
-				input: message.input,
-			});
+			const result = await firstValueFrom(
+				server.execute({
+					path: message.operation,
+					input: message.input,
+				}),
+			);
 
 			if (result.error) {
 				conn.ws.send(
@@ -389,10 +395,12 @@ export function createWSHandler(server: LensServer, options: WSHandlerOptions =
 	// Handle mutation
 	async function handleMutation(conn: ClientConnection, message: MutationMessage): Promise<void> {
 		try {
-			const result = await server.execute({
-				path: message.operation,
-				input: message.input,
-			});
+			const result = await firstValueFrom(
+				server.execute({
+					path: message.operation,
+					input: message.input,
+				}),
+			);
 
 			if (result.error) {
 				conn.ws.send(