@sylphx/lens-server 3.0.0 → 4.0.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { InferRouterContext as InferRouterContext3, MutationDef as MutationDef2, mutation, QueryDef as QueryDef2, query, ResolverContext, ResolverFn, RouterDef as RouterDef3, RouterRoutes, router } from "@sylphx/lens-core";
+import { InferRouterContext as InferRouterContext3, MutationDef as MutationDef2, mutation, QueryDef as QueryDef2, query, RouterDef as RouterDef3, RouterRoutes, router } from "@sylphx/lens-core";
 import { ContextStore, ContextValue } from "@sylphx/lens-core";
 /**
 * Create a typed context reference.
@@ -41,7 +41,7 @@ declare function extendContext<
 	E extends ContextValue
 >(current: T, extension: E): T & E;
 import { ContextValue as ContextValue3, InferRouterContext as InferRouterContext2, RouterDef as RouterDef2 } from "@sylphx/lens-core";
-import { AnyQueryDef, ContextValue as ContextValue2, EntityDef, InferRouterContext, MutationDef, Observable, OptimisticDSL, QueryDef, Resolvers, RouterDef } from "@sylphx/lens-core";
+import { AnyQueryDef, ContextValue as ContextValue2, InferRouterContext, ModelDef, MutationDef, Observable, OptimisticDSL, QueryDef, Resolvers, RouterDef, SubscriptionDef } from "@sylphx/lens-core";
 /**
 * @sylphx/lens-server - Plugin System Types
 *
@@ -459,7 +459,7 @@ interface SelectionObject {
 	} | NestedSelection;
 }
 /** Entity map type */
-type EntitiesMap = Record<string, EntityDef<string, any>>;
+type EntitiesMap = Record<string, ModelDef<string, any>>;
 /** Queries map type */
 type QueriesMap = Record<string, AnyQueryDef<unknown, unknown>>;
 /** Mutations map type */
@@ -473,6 +473,11 @@ interface OperationMeta {
 	* Used by client for field-level subscription detection.
 	*/
 	returnType?: string;
+	/**
+	* Indicates this is a live query (Publisher pattern with _subscriber).
+	* Client should use streaming transport even though type is "query".
+	*/
+	live?: boolean;
 }
 /** Nested operations structure for handshake */
 type OperationsMap = {
@@ -597,8 +602,8 @@ interface LensServer {
 	*/
 	getPluginManager(): PluginManager;
 }
-type InferInput<T> = T extends QueryDef<infer I, any> ? I : T extends MutationDef<infer I, any> ? I : never;
-type InferOutput<T> = T extends QueryDef<any, infer O> ? O : T extends MutationDef<any, infer O> ? O : T extends FieldType<infer F> ? F : never;
+type InferInput<T> = T extends QueryDef<infer I, any> ? I : T extends MutationDef<infer I, any> ? I : T extends SubscriptionDef<infer I, any> ? I : never;
+type InferOutput<T> = T extends QueryDef<any, infer O> ? O : T extends MutationDef<any, infer O> ? O : T extends SubscriptionDef<any, infer O> ? O : T extends FieldType<infer F> ? F : never;
 type InferApi<T> = T extends {
 	_types: infer Types;
 } ? Types : never;
@@ -1010,6 +1015,7 @@ interface WSHandlerOptions {
 	* Logger for debugging.
 	*/
 	logger?: {
+		debug?: (message: string, ...args: unknown[]) => void;
 		info?: (message: string, ...args: unknown[]) => void;
 		warn?: (message: string, ...args: unknown[]) => void;
 		error?: (message: string, ...args: unknown[]) => void;
@@ -1434,7 +1440,7 @@ type OptimisticPlugin = OptimisticPluginMarker & ServerPlugin;
 *   .input(z.object({ id: z.string(), name: z.string() }))
 *   .returns(User)
 *   .optimistic('merge')
-*   .resolve(({ input }) => db.user.update(input));
+*   .resolve(({ args }) => db.user.update(args));
 *
 * const server = createApp({ router, plugins });
 * ```
@@ -1522,6 +1528,9 @@ declare class OperationLog {
 	cleanup(): void;
 	/**
 	* Remove oldest entry and update tracking.
+	*
+	* IMPORTANT: After entries.shift(), ALL indices must be decremented by 1
+	* to maintain correctness of entityIndex lookups.
 	*/
 	private removeOldest;
 	/**
@@ -1717,4 +1726,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, createHandler, createHTTPHandler, 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, ResolverFn, ResolverContext, 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, HandlerOptions, Handler, HTTPHandlerOptions, HTTPHandler, 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, handleWebSSE, handleWebQuery, handleWebMutation, extendContext, estimatePatchSize, createWSHandler, createStructuredLogger, createServerClientProxy, createSSEHandler, createPluginManager, createHandler, createHTTPHandler, 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, HandlerOptions, Handler, HTTPHandlerOptions, HTTPHandler, FrameworkHandlerOptions, ErrorContext, EntitiesMap, EnhanceOperationMetaContext, EmitResult, DisconnectContext, DEFAULT_WS_HANDLER_CONFIG, DEFAULT_STORAGE_CONFIG, ConnectContext, ClientSendFn, BroadcastResult, BeforeSendContext, BeforeMutationContext, AfterSendContext, AfterMutationContext };