@sylphx/lens-server 1.0.2 → 1.0.4

package/dist/index.d.ts

@@ -1,10 +1,439 @@
+import { ContextValue, EntityDef, EntityDefinition, EntityResolvers, EntityResolversDefinition, MutationDef, QueryDef, RelationDef, RelationTypeWithForeignKey, RouterDef } from "@sylphx/lens-core";
+import { EntityKey, Update } from "@sylphx/lens-core";
+/** Client connection interface */
+interface StateClient {
+	id: string;
+	send: (message: StateUpdateMessage) => void;
+}
+/** Update message sent to clients */
+interface StateUpdateMessage {
+	type: "update";
+	entity: string;
+	id: string;
+	/** Field-level updates with strategy */
+	updates: Record<string, Update>;
+}
+/** Full entity update message */
+interface StateFullMessage {
+	type: "data";
+	entity: string;
+	id: string;
+	data: Record<string, unknown>;
+}
+/** Subscription info */
+interface Subscription {
+	clientId: string;
+	fields: Set<string> | "*";
+}
+/** Configuration */
+interface GraphStateManagerConfig {
+	/** Called when an entity has no more subscribers */
+	onEntityUnsubscribed?: (entity: string, id: string) => void;
+}
 /**
- * @sylphx/lens-server
- *
- * Server runtime for Lens API framework.
- * Operations-based server with GraphStateManager for reactive updates.
- */
-export { createServer, type LensServer, type LensServerConfig as ServerConfig, type EntitiesMap, type RelationsArray, type QueriesMap, type MutationsMap, type WebSocketLike, type SelectionObject, type ServerMetadata, type OperationMeta, type OperationsMap, type LensOperation, type LensResult, type InferApi, type InferInput, type InferOutput, } from "./server/create";
-export { GraphStateManager, createGraphStateManager, type EntityKey, type StateClient, type StateUpdateMessage, type StateFullMessage, type Subscription, type GraphStateManagerConfig, } from "./state";
-export { SSEHandler, createSSEHandler, type SSEHandlerConfig, type SSEClientInfo, } from "./sse/handler";
-//# sourceMappingURL=index.d.ts.map
+* 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
+* ```
+*/
+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
+*/
+declare function createGraphStateManager(config?: GraphStateManagerConfig): GraphStateManager;
+/** Selection object type for nested field selection */
+interface SelectionObject {
+	[key: string]: boolean | SelectionObject | {
+		select: SelectionObject;
+	};
+}
+/** Entity map type */
+type EntitiesMap = Record<string, EntityDef<string, any>>;
+/** Queries map type */
+type QueriesMap = Record<string, QueryDef<unknown, unknown>>;
+/** Mutations map type */
+type MutationsMap = Record<string, MutationDef<unknown, unknown>>;
+/** Relations array type */
+type RelationsArray = RelationDef<EntityDef<string, EntityDefinition>, Record<string, RelationTypeWithForeignKey>>[];
+/** Operation metadata for handshake */
+interface OperationMeta {
+	type: "query" | "mutation";
+	optimistic?: unknown;
+}
+/** Nested operations structure for handshake */
+type OperationsMap = {
+	[key: string]: OperationMeta | OperationsMap;
+};
+/** Server configuration */
+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 */
+interface ServerMetadata {
+	/** Server version */
+	version: string;
+	/** Operations metadata map */
+	operations: OperationsMap;
+}
+/** Operation for in-process transport */
+interface LensOperation {
+	/** Operation path (e.g., 'user.get', 'session.create') */
+	path: string;
+	/** Operation input */
+	input?: unknown;
+}
+/** Result from operation execution */
+interface LensResult<T = unknown> {
+	/** Success data */
+	data?: T;
+	/** Error if operation failed */
+	error?: Error;
+}
+/** Lens server interface */
+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 */
+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
+*/
+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
+*/
+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 });
+* type Api = InferApi<typeof server>;
+*
+* // Client (only imports TYPE)
+* import type { Api } from './server';
+* const client = createClient<Api>({ links: [...] });
+* ```
+*/
+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
+*/
+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;
+	};
+};
+/** SSE handler configuration */
+interface SSEHandlerConfig {
+	/** GraphStateManager instance (required) */
+	stateManager: GraphStateManager;
+	/** Heartbeat interval in ms (default: 30000) */
+	heartbeatInterval?: number;
+}
+/** SSE client info */
+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", "*");
+* ```
+*/
+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)
+*/
+declare function createSSEHandler(config: SSEHandlerConfig): SSEHandler;
+export { createServer, createSSEHandler, createGraphStateManager, WebSocketLike, Subscription, StateUpdateMessage, StateFullMessage, StateClient, ServerMetadata, LensServerConfig as ServerConfig, SelectionObject, SSEHandlerConfig, SSEHandler, SSEClientInfo, RelationsArray, QueriesMap, OperationsMap, OperationMeta, MutationsMap, LensServer, LensResult, LensOperation, InferOutput, InferInput, InferApi, GraphStateManagerConfig, GraphStateManager, EntityKey, EntitiesMap };

package/dist/index.js

@@ -1,282 +1,17 @@
-// ../core/dist/index.js
-import { AsyncLocalStorage } from "node:async_hooks";
-var ENTITY_SYMBOL = Symbol("lens:entity");
-var valueStrategy = {
-  name: "value",
-  encode(_prev, next) {
-    return { strategy: "value", data: next };
-  },
-  decode(_current, update) {
-    return update.data;
-  },
-  estimateSize(update) {
-    return JSON.stringify(update.data).length;
-  }
-};
-var deltaStrategy = {
-  name: "delta",
-  encode(prev, next) {
-    const operations = computeStringDiff(prev, next);
-    const diffSize = JSON.stringify(operations).length;
-    const valueSize = next.length + 20;
-    if (diffSize >= valueSize) {
-      return { strategy: "value", data: next };
-    }
-    return { strategy: "delta", data: operations };
-  },
-  decode(current, update) {
-    if (update.strategy === "value") {
-      return update.data;
-    }
-    const operations = update.data;
-    return applyStringDiff(current, operations);
-  },
-  estimateSize(update) {
-    return JSON.stringify(update.data).length;
-  }
-};
-function computeStringDiff(prev, next) {
-  const operations = [];
-  let prefixLen = 0;
-  const minLen = Math.min(prev.length, next.length);
-  while (prefixLen < minLen && prev[prefixLen] === next[prefixLen]) {
-    prefixLen++;
-  }
-  let suffixLen = 0;
-  const remainingPrev = prev.length - prefixLen;
-  const remainingNext = next.length - prefixLen;
-  const maxSuffix = Math.min(remainingPrev, remainingNext);
-  while (suffixLen < maxSuffix && prev[prev.length - 1 - suffixLen] === next[next.length - 1 - suffixLen]) {
-    suffixLen++;
-  }
-  const deleteCount = prev.length - prefixLen - suffixLen;
-  const insertText = next.slice(prefixLen, next.length - suffixLen || undefined);
-  if (deleteCount > 0 || insertText.length > 0) {
-    operations.push({
-      position: prefixLen,
-      ...deleteCount > 0 ? { delete: deleteCount } : {},
-      ...insertText.length > 0 ? { insert: insertText } : {}
-    });
-  }
-  return operations;
-}
-function applyStringDiff(current, operations) {
-  let result = current;
-  const sortedOps = [...operations].sort((a, b) => b.position - a.position);
-  for (const op of sortedOps) {
-    const before = result.slice(0, op.position);
-    const after = result.slice(op.position + (op.delete ?? 0));
-    result = before + (op.insert ?? "") + after;
-  }
-  return result;
-}
-var patchStrategy = {
-  name: "patch",
-  encode(prev, next) {
-    const operations = computeJsonPatch(prev, next);
-    const patchSize = JSON.stringify(operations).length;
-    const valueSize = JSON.stringify(next).length + 20;
-    if (patchSize >= valueSize) {
-      return { strategy: "value", data: next };
-    }
-    return { strategy: "patch", data: operations };
-  },
-  decode(current, update) {
-    if (update.strategy === "value") {
-      return update.data;
-    }
-    const operations = update.data;
-    return applyJsonPatch(current, operations);
-  },
-  estimateSize(update) {
-    return JSON.stringify(update.data).length;
-  }
-};
-function computeJsonPatch(prev, next, basePath = "") {
-  const operations = [];
-  const prevObj = prev;
-  const nextObj = next;
-  for (const key of Object.keys(prevObj)) {
-    if (!(key in nextObj)) {
-      operations.push({ op: "remove", path: `${basePath}/${escapeJsonPointer(key)}` });
-    }
-  }
-  for (const [key, nextValue] of Object.entries(nextObj)) {
-    const path = `${basePath}/${escapeJsonPointer(key)}`;
-    const prevValue = prevObj[key];
-    if (!(key in prevObj)) {
-      operations.push({ op: "add", path, value: nextValue });
-    } else if (!deepEqual(prevValue, nextValue)) {
-      if (isPlainObject(prevValue) && isPlainObject(nextValue) && !Array.isArray(prevValue) && !Array.isArray(nextValue)) {
-        operations.push(...computeJsonPatch(prevValue, nextValue, path));
-      } else {
-        operations.push({ op: "replace", path, value: nextValue });
-      }
-    }
-  }
-  return operations;
-}
-function applyJsonPatch(current, operations) {
-  const result = structuredClone(current);
-  for (const op of operations) {
-    const pathParts = parseJsonPointer(op.path);
-    switch (op.op) {
-      case "add":
-      case "replace":
-        setValueAtPath(result, pathParts, op.value);
-        break;
-      case "remove":
-        removeValueAtPath(result, pathParts);
-        break;
-      case "move":
-        if (op.from) {
-          const fromParts = parseJsonPointer(op.from);
-          const value = getValueAtPath(result, fromParts);
-          removeValueAtPath(result, fromParts);
-          setValueAtPath(result, pathParts, value);
-        }
-        break;
-      case "copy":
-        if (op.from) {
-          const fromParts = parseJsonPointer(op.from);
-          const value = structuredClone(getValueAtPath(result, fromParts));
-          setValueAtPath(result, pathParts, value);
-        }
-        break;
-      case "test":
-        break;
-    }
-  }
-  return result;
-}
-var THRESHOLDS = {
-  STRING_DELTA_MIN: 100,
-  OBJECT_PATCH_MIN: 50
-};
-function selectStrategy(prev, next) {
-  if (typeof prev === "string" && typeof next === "string") {
-    if (next.length >= THRESHOLDS.STRING_DELTA_MIN) {
-      return deltaStrategy;
-    }
-    return valueStrategy;
-  }
-  if (typeof next !== "object" || next === null) {
-    return valueStrategy;
-  }
-  if (isPlainObject(prev) && isPlainObject(next)) {
-    const prevSize = JSON.stringify(prev).length;
-    if (prevSize >= THRESHOLDS.OBJECT_PATCH_MIN) {
-      return patchStrategy;
-    }
-  }
-  return valueStrategy;
-}
-function createUpdate(prev, next) {
-  const strategy = selectStrategy(prev, next);
-  return strategy.encode(prev, next);
-}
-function isPlainObject(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function deepEqual(a, b) {
-  if (a === b)
-    return true;
-  if (typeof a !== typeof b)
-    return false;
-  if (typeof a !== "object" || a === null || b === null)
-    return false;
-  const aKeys = Object.keys(a);
-  const bKeys = Object.keys(b);
-  if (aKeys.length !== bKeys.length)
-    return false;
-  for (const key of aKeys) {
-    if (!deepEqual(a[key], b[key])) {
-      return false;
-    }
-  }
-  return true;
-}
-function escapeJsonPointer(str) {
-  return str.replace(/~/g, "~0").replace(/\//g, "~1");
-}
-function parseJsonPointer(path) {
-  if (!path || path === "/")
-    return [];
-  return path.slice(1).split("/").map((p) => p.replace(/~1/g, "/").replace(/~0/g, "~"));
-}
-function getValueAtPath(obj, path) {
-  let current = obj;
-  for (const key of path) {
-    if (current === null || typeof current !== "object")
-      return;
-    current = current[key];
-  }
-  return current;
-}
-function setValueAtPath(obj, path, value) {
-  if (path.length === 0)
-    return;
-  let current = obj;
-  for (let i = 0;i < path.length - 1; i++) {
-    const key = path[i];
-    if (!(key in current) || typeof current[key] !== "object") {
-      current[key] = {};
-    }
-    current = current[key];
-  }
-  current[path[path.length - 1]] = value;
-}
-function removeValueAtPath(obj, path) {
-  if (path.length === 0)
-    return;
-  let current = obj;
-  for (let i = 0;i < path.length - 1; i++) {
-    const key = path[i];
-    if (!(key in current) || typeof current[key] !== "object")
-      return;
-    current = current[key];
-  }
-  delete current[path[path.length - 1]];
-}
-function isQueryDef(value) {
-  return typeof value === "object" && value !== null && value._type === "query";
-}
-function isMutationDef(value) {
-  return typeof value === "object" && value !== null && value._type === "mutation";
-}
-function isRouterDef(value) {
-  return typeof value === "object" && value !== null && value._type === "router";
-}
-function flattenRouter(routerDef, prefix = "") {
-  const result = new Map;
-  for (const [key, value] of Object.entries(routerDef._routes)) {
-    const path = prefix ? `${prefix}.${key}` : key;
-    if (isRouterDef(value)) {
-      const nested = flattenRouter(value, path);
-      for (const [nestedPath, procedure] of nested) {
-        result.set(nestedPath, procedure);
-      }
-    } else {
-      result.set(path, value);
-    }
-  }
-  return result;
-}
-function isBatchResolver(resolver) {
-  return typeof resolver === "object" && resolver !== null && "batch" in resolver;
-}
-var globalContextStore = new AsyncLocalStorage;
-function createContext() {
-  return globalContextStore;
-}
-function runWithContext(_context, value, fn) {
-  return globalContextStore.run(value, fn);
-}
-function makeEntityKey(entity2, id) {
-  return `${entity2}:${id}`;
-}
+// src/server/create.ts
+import {
+  createContext,
+  createUpdate as createUpdate2,
+  flattenRouter,
+  isBatchResolver,
+  isMutationDef,
+  isQueryDef,
+  runWithContext
+} from "@sylphx/lens-core";
 
 // src/state/graph-state-manager.ts
+import { createUpdate, makeEntityKey } from "@sylphx/lens-core";
+
 class GraphStateManager {
   clients = new Map;
   canonical = new Map;
@@ -1301,7 +1036,7 @@ class LensServerImpl {
       const oldValue = oldObj[key];
       const newValue = newObj[key];
       if (!this.deepEqual(oldValue, newValue)) {
-        updates[key] = createUpdate(oldValue, newValue);
+        updates[key] = createUpdate2(oldValue, newValue);
       }
     }
     return Object.keys(updates).length > 0 ? updates : null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sylphx/lens-server",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Server runtime for Lens API framework",
   "type": "module",
   "main": "./dist/index.js",
@@ -12,8 +12,7 @@
     }
   },
   "scripts": {
-    "build": "bun build ./src/index.ts --outdir ./dist --target node && bun run build:types",
-    "build:types": "tsc --emitDeclarationOnly --outDir ./dist",
+    "build": "bunup",
     "typecheck": "tsc --noEmit",
     "test": "bun test"
   },
@@ -30,7 +29,7 @@
   "author": "SylphxAI",
   "license": "MIT",
   "dependencies": {
-    "@sylphx/lens-core": "workspace:*"
+    "@sylphx/lens-core": "^1.0.4"
   },
   "devDependencies": {
     "typescript": "^5.9.3",

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAEN,YAAY,EAEZ,KAAK,UAAU,EACf,KAAK,gBAAgB,IAAI,YAAY,EACrC,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,eAAe,EAEpB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,aAAa,EAElB,KAAK,aAAa,EAClB,KAAK,UAAU,EAEf,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,WAAW,GAChB,MAAM,iBAAiB,CAAC;AAMzB,OAAO,EAEN,iBAAiB,EAEjB,uBAAuB,EAEvB,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,uBAAuB,GAC5B,MAAM,SAAS,CAAC;AAMjB,OAAO,EAEN,UAAU,EAEV,gBAAgB,EAEhB,KAAK,gBAAgB,EACrB,KAAK,aAAa,GAClB,MAAM,eAAe,CAAC"}

package/dist/server/create.d.ts

@@ -1,226 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/server/create.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACN,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,yBAAyB,EAE9B,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,0BAA0B,EAC/B,KAAK,SAAS,EASd,MAAM,mBAAmB,CAAC;AAE3B,uDAAuD;AACvD,MAAM,WAAW,eAAe;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,eAAe,GAAG;QAAE,MAAM,EAAE,eAAe,CAAA;KAAE,CAAC;CACvE;AAED,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAMjE,sBAAsB;AAEtB,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;AAEjE,uBAAuB;AACvB,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAEpE,yBAAyB;AACzB,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAEzE,2BAA2B;AAC3B,MAAM,MAAM,cAAc,GAAG,WAAW,CACvC,SAAS,CAAC,MAAM,EAAE,gBAAgB,CAAC,EACnC,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAC1C,EAAE,CAAC;AAEJ,uCAAuC;AACvC,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,OAAO,GAAG,UAAU,CAAC;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,gDAAgD;AAChD,MAAM,MAAM,aAAa,GAAG;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,aAAa,CAAC;CAC7C,CAAC;AAEF,2BAA2B;AAC3B,MAAM,WAAW,gBAAgB,CAAC,QAAQ,SAAS,YAAY,GAAG,YAAY;IAC7E,yBAAyB;IACzB,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,gDAAgD;IAChD,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,uCAAuC;IACvC,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,uBAAuB;IACvB,SAAS,CAAC,EAAE,eAAe,CAAC,yBAAyB,CAAC,CAAC;IACvD,sBAAsB;IACtB,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1D,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,8CAA8C;AAC9C,MAAM,WAAW,cAAc;IAC9B,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,UAAU,EAAE,aAAa,CAAC;CAC1B;AAED,yCAAyC;AACzC,MAAM,WAAW,aAAa;IAC7B,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,sCAAsC;AACtC,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO;IACtC,mBAAmB;IACnB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,gCAAgC;IAChC,KAAK,CAAC,EAAE,KAAK,CAAC;CACd;AAED,4BAA4B;AAC5B,MAAM,WAAW,UAAU;IAC1B,kDAAkD;IAClD,WAAW,IAAI,cAAc,CAAC;IAC9B,oFAAoF;IACpF,OAAO,CAAC,EAAE,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAChD,iCAAiC;IACjC,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9E,yBAAyB;IACzB,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChF,kCAAkC;IAClC,eAAe,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI,CAAC;IACzC,0BAA0B;IAC1B,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/C,gDAAgD;IAChD,eAAe,IAAI,iBAAiB,CAAC;IACrC,mBAAmB;IACnB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,mBAAmB;IACnB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,0BAA0B;AAC1B,MAAM,WAAW,aAAa;IAC7B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,IAAI,IAAI,CAAC;IACd,SAAS,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACvD,OAAO,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9B,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;CAC5C;AA4JD,cAAM,cAAc,CACnB,CAAC,SAAS,UAAU,GAAG,UAAU,EACjC,CAAC,SAAS,YAAY,GAAG,YAAY,EACrC,QAAQ,SAAS,YAAY,GAAG,YAAY,CAC3C,YAAW,UAAU;IAEtB,OAAO,CAAC,OAAO,CAAI;IACnB,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,SAAS,CAAC,CAA6C;IAC/D,OAAO,CAAC,cAAc,CAAkD;IACxE,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,GAAG,CAA6B;IAExC,sDAAsD;IACtD,OAAO,CAAC,YAAY,CAAoB;IAExC,iDAAiD;IACjD,OAAO,CAAC,OAAO,CAAmD;IAElE,yBAAyB;IACzB,OAAO,CAAC,WAAW,CAAuC;IAC1D,OAAO,CAAC,iBAAiB,CAAK;IAE9B,sBAAsB;IACtB,OAAO,CAAC,MAAM,CAAiB;gBAEnB,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,GAAG;QAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QAAC,SAAS,CAAC,EAAE,CAAC,CAAA;KAAE;IA+E/E,eAAe,IAAI,iBAAiB;IAIpC;;;OAGG;IACH,WAAW,IAAI,cAAc;IAO7B;;;OAGG;IACG,OAAO,CAAC,EAAE,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC;IAuBrD;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAwC1B,eAAe,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI;IA4BxC,OAAO,CAAC,aAAa;IAkCrB,OAAO,CAAC,eAAe;YAWT,eAAe;YA8Bf,mBAAmB;IAyGjC,OAAO,CAAC,kBAAkB;IAyD1B,OAAO,CAAC,iBAAiB;YAsBX,WAAW;YAgCX,cAAc;IA8B5B,OAAO,CAAC,gBAAgB;IAuBlB,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA6D7E,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA8C/E,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAiD9C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B,OAAO,CAAC,kBAAkB;IAa1B,OAAO,CAAC,uBAAuB;IAyB/B,OAAO,CAAC,yBAAyB;IAMjC,OAAO,CAAC,eAAe;IA6BvB,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,sBAAsB;IA0D9B;;;OAGG;YACW,sBAAsB;IA6DpC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAuB/B;;;OAGG;IACH,OAAO,CAAC,eAAe;IAmEvB;;OAEG;YACW,kBAAkB;IA2DhC,OAAO,CAAC,cAAc;IAoBtB,OAAO,CAAC,SAAS;IAoBjB,OAAO,CAAC,YAAY;CAMpB;AAcD;;GAEG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,GAC7D,CAAC,SAAS,IAAI,GACb,IAAI,GACJ,CAAC,GACF,CAAC,SAAS,WAAW,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,GACtC,CAAC,GACD,KAAK,CAAC;AAEV;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,GAC9D,CAAC,GACD,CAAC,SAAS,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,GACtC,CAAC,GACD,KAAK,CAAC;AAEV;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,UAAU,IAAI,CAAC,SAAS,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,GACpF;IAAE,OAAO,EAAE,CAAC,CAAC;IAAC,SAAS,EAAE,CAAC,CAAA;CAAE,GAC5B,KAAK,CAAC;AAMT;;GAEG;AACH,wBAAgB,YAAY,CAC3B,QAAQ,SAAS,YAAY,GAAG,YAAY,EAC5C,CAAC,SAAS,UAAU,GAAG,UAAU,EACjC,CAAC,SAAS,YAAY,GAAG,YAAY,EAErC,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IAAC,SAAS,CAAC,EAAE,CAAC,CAAA;CAAE,GACjE,UAAU,GAAG;IAAE,MAAM,EAAE;QAAE,OAAO,EAAE,CAAC,CAAC;QAAC,SAAS,EAAE,CAAC,CAAA;KAAE,CAAA;CAAE,CAIvD"}

package/dist/sse/handler.d.ts

@@ -1,78 +0,0 @@
-/**
- * @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

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

@@ -1,146 +0,0 @@
-/**
- * @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

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

@@ -1,7 +0,0 @@
-/**
- * @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

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