@sylphx/lens-server 1.0.2

package/dist/server/create.d.ts

@@ -0,0 +1,226 @@
+/**
+ * @sylphx/lens-server - Lens Server
+ *
+ * Core server implementation:
+ * - Free Operations (query/mutation definitions)
+ * - GraphStateManager (per-client state tracking, minimal diffs)
+ * - Field-level subscriptions
+ * - Entity Resolvers with DataLoader batching
+ */
+import { type ContextValue, type EntityDef, type EntityDefinition, type EntityResolvers, type EntityResolversDefinition, type MutationDef, type QueryDef, type RelationDef, type RelationTypeWithForeignKey, type RouterDef } from "@sylphx/lens-core";
+/** Selection object type for nested field selection */
+export interface SelectionObject {
+    [key: string]: boolean | SelectionObject | {
+        select: SelectionObject;
+    };
+}
+import { GraphStateManager } from "../state/graph-state-manager";
+/** Entity map type */
+export type EntitiesMap = Record<string, EntityDef<string, any>>;
+/** Queries map type */
+export type QueriesMap = Record<string, QueryDef<unknown, unknown>>;
+/** Mutations map type */
+export type MutationsMap = Record<string, MutationDef<unknown, unknown>>;
+/** Relations array type */
+export type RelationsArray = RelationDef<EntityDef<string, EntityDefinition>, Record<string, RelationTypeWithForeignKey>>[];
+/** Operation metadata for handshake */
+export interface OperationMeta {
+    type: "query" | "mutation";
+    optimistic?: unknown;
+}
+/** Nested operations structure for handshake */
+export type OperationsMap = {
+    [key: string]: OperationMeta | OperationsMap;
+};
+/** Server configuration */
+export interface LensServerConfig<TContext extends ContextValue = ContextValue> {
+    /** Entity definitions */
+    entities?: EntitiesMap;
+    /** Relation definitions */
+    relations?: RelationsArray;
+    /** Router definition (namespaced operations) */
+    router?: RouterDef;
+    /** Query definitions (flat, legacy) */
+    queries?: QueriesMap;
+    /** Mutation definitions (flat, legacy) */
+    mutations?: MutationsMap;
+    /** Entity resolvers */
+    resolvers?: EntityResolvers<EntityResolversDefinition>;
+    /** Context factory */
+    context?: (req?: unknown) => TContext | Promise<TContext>;
+    /** Server version */
+    version?: string;
+}
+/** Server metadata for transport handshake */
+export interface ServerMetadata {
+    /** Server version */
+    version: string;
+    /** Operations metadata map */
+    operations: OperationsMap;
+}
+/** Operation for in-process transport */
+export interface LensOperation {
+    /** Operation path (e.g., 'user.get', 'session.create') */
+    path: string;
+    /** Operation input */
+    input?: unknown;
+}
+/** Result from operation execution */
+export interface LensResult<T = unknown> {
+    /** Success data */
+    data?: T;
+    /** Error if operation failed */
+    error?: Error;
+}
+/** Lens server interface */
+export interface LensServer {
+    /** Get server metadata for transport handshake */
+    getMetadata(): ServerMetadata;
+    /** Execute operation - auto-detects query vs mutation from registered operations */
+    execute(op: LensOperation): Promise<LensResult>;
+    /** Execute a query (one-time) */
+    executeQuery<TInput, TOutput>(name: string, input?: TInput): Promise<TOutput>;
+    /** Execute a mutation */
+    executeMutation<TInput, TOutput>(name: string, input: TInput): Promise<TOutput>;
+    /** Handle WebSocket connection */
+    handleWebSocket(ws: WebSocketLike): void;
+    /** Handle HTTP request */
+    handleRequest(req: Request): Promise<Response>;
+    /** Get GraphStateManager for external access */
+    getStateManager(): GraphStateManager;
+    /** Start server */
+    listen(port: number): Promise<void>;
+    /** Close server */
+    close(): Promise<void>;
+}
+/** WebSocket interface */
+export interface WebSocketLike {
+    send(data: string): void;
+    close(): void;
+    onmessage?: ((event: {
+        data: string;
+    }) => void) | null;
+    onclose?: (() => void) | null;
+    onerror?: ((error: unknown) => void) | null;
+}
+declare class LensServerImpl<Q extends QueriesMap = QueriesMap, M extends MutationsMap = MutationsMap, TContext extends ContextValue = ContextValue> implements LensServer {
+    private queries;
+    private mutations;
+    private entities;
+    private resolvers?;
+    private contextFactory;
+    private version;
+    private ctx;
+    /** GraphStateManager for per-client state tracking */
+    private stateManager;
+    /** DataLoaders for N+1 batching (per-request) */
+    private loaders;
+    /** Client connections */
+    private connections;
+    private connectionCounter;
+    /** Server instance */
+    private server;
+    constructor(config: LensServerConfig<TContext> & {
+        queries?: Q;
+        mutations?: M;
+    });
+    getStateManager(): GraphStateManager;
+    /**
+     * Get server metadata for transport handshake.
+     * Used by inProcess transport for direct access.
+     */
+    getMetadata(): ServerMetadata;
+    /**
+     * Execute operation - auto-detects query vs mutation from registered operations.
+     * Used by inProcess transport for direct server calls.
+     */
+    execute(op: LensOperation): Promise<LensResult>;
+    /**
+     * Build nested operations map for handshake response
+     * Converts flat "user.get", "user.create" into nested { user: { get: {...}, create: {...} } }
+     */
+    private buildOperationsMap;
+    handleWebSocket(ws: WebSocketLike): void;
+    private handleMessage;
+    private handleHandshake;
+    private handleSubscribe;
+    private executeSubscription;
+    private handleUpdateFields;
+    private handleUnsubscribe;
+    private handleQuery;
+    private handleMutation;
+    private handleDisconnect;
+    executeQuery<TInput, TOutput>(name: string, input?: TInput): Promise<TOutput>;
+    executeMutation<TInput, TOutput>(name: string, input: TInput): Promise<TOutput>;
+    handleRequest(req: Request): Promise<Response>;
+    listen(port: number): Promise<void>;
+    close(): Promise<void>;
+    private findConnectionByWs;
+    private getEntityNameFromOutput;
+    private getEntityNameFromMutation;
+    private extractEntities;
+    private applySelection;
+    private applySelectionToObject;
+    /**
+     * Execute entity resolvers for nested data.
+     * Processes the selection object and resolves relation fields.
+     */
+    private executeEntityResolvers;
+    /**
+     * Get target entity name for a relation field.
+     */
+    private getRelationTargetEntity;
+    /**
+     * Serialize entity data for transport.
+     * Auto-calls serialize() on field types (Date → ISO string, etc.)
+     */
+    private serializeEntity;
+    /**
+     * Process query result: execute entity resolvers, apply selection, serialize
+     */
+    private processQueryResult;
+    private computeUpdates;
+    private deepEqual;
+    private clearLoaders;
+}
+/**
+ * Infer input type from a query/mutation definition
+ */
+export type InferInput<T> = T extends QueryDef<infer I, unknown> ? I extends void ? void : I : T extends MutationDef<infer I, unknown> ? I : never;
+/**
+ * Infer output type from a query/mutation definition
+ */
+export type InferOutput<T> = T extends QueryDef<unknown, infer O> ? O : T extends MutationDef<unknown, infer O> ? O : never;
+/**
+ * API type for client inference
+ * Export this type for client-side type safety
+ *
+ * @example
+ * ```typescript
+ * // Server
+ * const server = createLensServer({ queries, mutations });
+ * export type Api = InferApi<typeof server>;
+ *
+ * // Client (only imports TYPE)
+ * import type { Api } from './server';
+ * const client = createClient<Api>({ links: [...] });
+ * ```
+ */
+export type InferApi<T extends LensServer> = T extends LensServerImpl<infer Q, infer M> ? {
+    queries: Q;
+    mutations: M;
+} : never;
+/**
+ * Create Lens server with Operations API + Optimization Layer
+ */
+export declare function createServer<TContext extends ContextValue = ContextValue, Q extends QueriesMap = QueriesMap, M extends MutationsMap = MutationsMap>(config: LensServerConfig<TContext> & {
+    queries?: Q;
+    mutations?: M;
+}): LensServer & {
+    _types: {
+        queries: Q;
+        mutations: M;
+    };
+};
+export {};
+//# sourceMappingURL=create.d.ts.map

package/dist/server/create.d.ts.map

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

package/dist/sse/handler.d.ts

@@ -0,0 +1,78 @@
+/**
+ * @sylphx/lens-server - SSE Transport Adapter
+ *
+ * Thin transport adapter for Server-Sent Events.
+ * Connects SSE streams to GraphStateManager.
+ */
+import type { GraphStateManager } from "../state/graph-state-manager";
+/** SSE handler configuration */
+export interface SSEHandlerConfig {
+    /** GraphStateManager instance (required) */
+    stateManager: GraphStateManager;
+    /** Heartbeat interval in ms (default: 30000) */
+    heartbeatInterval?: number;
+}
+/** SSE client info */
+export interface SSEClientInfo {
+    id: string;
+    connectedAt: number;
+}
+/**
+ * SSE transport adapter for GraphStateManager.
+ *
+ * This is a thin adapter that:
+ * - Creates SSE connections
+ * - Registers clients with GraphStateManager
+ * - Forwards updates to SSE streams
+ *
+ * All state/subscription logic is handled by GraphStateManager.
+ *
+ * @example
+ * ```typescript
+ * const stateManager = new GraphStateManager();
+ * const sse = new SSEHandler({ stateManager });
+ *
+ * // Handle SSE connection
+ * app.get('/events', (req) => sse.handleConnection(req));
+ *
+ * // Subscribe via separate endpoint or message
+ * stateManager.subscribe(clientId, "Post", "123", "*");
+ * ```
+ */
+export declare class SSEHandler {
+    private stateManager;
+    private heartbeatInterval;
+    private clients;
+    private clientCounter;
+    constructor(config: SSEHandlerConfig);
+    /**
+     * Handle new SSE connection
+     * Returns a Response with SSE stream
+     */
+    handleConnection(req?: Request): Response;
+    /**
+     * Remove client and cleanup
+     */
+    private removeClient;
+    /**
+     * Close specific client connection
+     */
+    closeClient(clientId: string): void;
+    /**
+     * Get connected client count
+     */
+    getClientCount(): number;
+    /**
+     * Get connected client IDs
+     */
+    getClientIds(): string[];
+    /**
+     * Close all connections
+     */
+    closeAll(): void;
+}
+/**
+ * Create SSE handler (transport adapter)
+ */
+export declare function createSSEHandler(config: SSEHandlerConfig): SSEHandler;
+//# sourceMappingURL=handler.d.ts.map

package/dist/sse/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/sse/handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAe,MAAM,8BAA8B,CAAC;AAMnF,gCAAgC;AAChC,MAAM,WAAW,gBAAgB;IAChC,4CAA4C;IAC5C,YAAY,EAAE,iBAAiB,CAAC;IAChC,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,sBAAsB;AACtB,MAAM,WAAW,aAAa;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;CACpB;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,UAAU;IACtB,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,OAAO,CAGX;IACJ,OAAO,CAAC,aAAa,CAAK;gBAEd,MAAM,EAAE,gBAAgB;IAKpC;;;OAGG;IACH,gBAAgB,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,QAAQ;IAqDzC;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAYnC;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,YAAY,IAAI,MAAM,EAAE;IAIxB;;OAEG;IACH,QAAQ,IAAI,IAAI;CAKhB;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU,CAErE"}

package/dist/state/graph-state-manager.d.ts

@@ -0,0 +1,146 @@
+/**
+ * @sylphx/lens-server - Graph State Manager
+ *
+ * Core orchestration layer that:
+ * - Maintains canonical state per entity (server truth)
+ * - Tracks per-client last known state
+ * - Computes minimal diffs when state changes
+ * - Auto-selects transfer strategy (value/delta/patch)
+ * - Pushes updates to subscribed clients
+ */
+import { type EntityKey, type Update } from "@sylphx/lens-core";
+export type { EntityKey };
+/** Client connection interface */
+export interface StateClient {
+    id: string;
+    send: (message: StateUpdateMessage) => void;
+}
+/** Update message sent to clients */
+export interface StateUpdateMessage {
+    type: "update";
+    entity: string;
+    id: string;
+    /** Field-level updates with strategy */
+    updates: Record<string, Update>;
+}
+/** Full entity update message */
+export interface StateFullMessage {
+    type: "data";
+    entity: string;
+    id: string;
+    data: Record<string, unknown>;
+}
+/** Subscription info */
+export interface Subscription {
+    clientId: string;
+    fields: Set<string> | "*";
+}
+/** Configuration */
+export interface GraphStateManagerConfig {
+    /** Called when an entity has no more subscribers */
+    onEntityUnsubscribed?: (entity: string, id: string) => void;
+}
+/**
+ * Manages server-side canonical state and syncs to clients.
+ *
+ * @example
+ * ```typescript
+ * const manager = new GraphStateManager();
+ *
+ * // Add client
+ * manager.addClient({
+ *   id: "client-1",
+ *   send: (msg) => ws.send(JSON.stringify(msg)),
+ * });
+ *
+ * // Subscribe client to entity
+ * manager.subscribe("client-1", "Post", "123", ["title", "content"]);
+ *
+ * // Emit updates (from resolvers)
+ * manager.emit("Post", "123", { content: "Updated content" });
+ * // → Automatically computes diff and sends to subscribed clients
+ * ```
+ */
+export declare class GraphStateManager {
+    /** Connected clients */
+    private clients;
+    /** Canonical state per entity (server truth) */
+    private canonical;
+    /** Per-client state tracking */
+    private clientStates;
+    /** Entity → subscribed client IDs */
+    private entitySubscribers;
+    /** Configuration */
+    private config;
+    constructor(config?: GraphStateManagerConfig);
+    /**
+     * Add a client connection
+     */
+    addClient(client: StateClient): void;
+    /**
+     * Remove a client and cleanup all subscriptions
+     */
+    removeClient(clientId: string): void;
+    /**
+     * Subscribe a client to an entity
+     */
+    subscribe(clientId: string, entity: string, id: string, fields?: string[] | "*"): void;
+    /**
+     * Unsubscribe a client from an entity
+     */
+    unsubscribe(clientId: string, entity: string, id: string): void;
+    /**
+     * Update subscription fields for a client
+     */
+    updateSubscription(clientId: string, entity: string, id: string, fields: string[] | "*"): void;
+    /**
+     * Emit data for an entity.
+     * This is the core method called by resolvers.
+     *
+     * @param entity - Entity name
+     * @param id - Entity ID
+     * @param data - Full or partial entity data
+     * @param options - Emit options
+     */
+    emit(entity: string, id: string, data: Record<string, unknown>, options?: {
+        replace?: boolean;
+    }): void;
+    /**
+     * Get current canonical state for an entity
+     */
+    getState(entity: string, id: string): Record<string, unknown> | undefined;
+    /**
+     * Check if entity has any subscribers
+     */
+    hasSubscribers(entity: string, id: string): boolean;
+    /**
+     * Push update to a specific client
+     */
+    private pushToClient;
+    /**
+     * Send initial data to a newly subscribed client
+     */
+    private sendInitialData;
+    /**
+     * Cleanup entity when no subscribers remain
+     */
+    private cleanupEntity;
+    private makeKey;
+    /**
+     * Get statistics
+     */
+    getStats(): {
+        clients: number;
+        entities: number;
+        totalSubscriptions: number;
+    };
+    /**
+     * Clear all state (for testing)
+     */
+    clear(): void;
+}
+/**
+ * Create a GraphStateManager instance
+ */
+export declare function createGraphStateManager(config?: GraphStateManagerConfig): GraphStateManager;
+//# sourceMappingURL=graph-state-manager.d.ts.map

package/dist/state/graph-state-manager.d.ts.map

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

package/dist/state/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @sylphx/lens-server - State Management
+ *
+ * Server-side state management for reactive data sync.
+ */
+export { GraphStateManager, createGraphStateManager, type EntityKey, type StateClient, type StateUpdateMessage, type StateFullMessage, type Subscription, type GraphStateManagerConfig, } from "./graph-state-manager";
+//# sourceMappingURL=index.d.ts.map

package/dist/state/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACN,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,uBAAuB,GAC5B,MAAM,uBAAuB,CAAC"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@sylphx/lens-server",
+  "version": "1.0.2",
+  "description": "Server runtime for Lens API framework",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "bun build ./src/index.ts --outdir ./dist --target node && bun run build:types",
+    "build:types": "tsc --emitDeclarationOnly --outDir ./dist",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "keywords": [
+    "lens",
+    "server",
+    "resolvers",
+    "graphql"
+  ],
+  "author": "SylphxAI",
+  "license": "MIT",
+  "dependencies": {
+    "@sylphx/lens-core": "workspace:*"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "zod": "^4.1.13"
+  }
+}