@sylphx/lens-server 3.0.1 → 4.0.0

package/src/server/types.ts

@@ -7,14 +7,15 @@
 import type {
 	AnyQueryDef,
 	ContextValue,
-	EntityDef,
 	InferRouterContext,
+	ModelDef,
 	MutationDef,
 	Observable,
 	OptimisticDSL,
 	QueryDef,
 	Resolvers,
 	RouterDef,
+	SubscriptionDef,
 } from "@sylphx/lens-core";
 import type { PluginManager, ServerPlugin } from "../plugin/types.js";
 
@@ -49,7 +50,7 @@ export interface SelectionObject {
 // =============================================================================
 
 /** Entity map type */
-export type EntitiesMap = Record<string, EntityDef<string, any>>;
+export type EntitiesMap = Record<string, ModelDef<string, any>>;
 
 /** Queries map type */
 export type QueriesMap = Record<string, AnyQueryDef<unknown, unknown>>;
@@ -57,6 +58,9 @@ export type QueriesMap = Record<string, AnyQueryDef<unknown, unknown>>;
 /** Mutations map type */
 export type MutationsMap = Record<string, MutationDef<unknown, unknown>>;
 
+/** Subscriptions map type */
+export type SubscriptionsMap = Record<string, SubscriptionDef<unknown, unknown>>;
+
 // =============================================================================
 // Operation Metadata
 // =============================================================================
@@ -70,6 +74,11 @@ export 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 */
@@ -238,16 +247,24 @@ export interface LensServer {
 import type { FieldType } from "@sylphx/lens-core";
 
 export type InferInput<T> =
-	T extends QueryDef<infer I, any> ? I : T extends MutationDef<infer I, any> ? I : never;
+	T extends QueryDef<infer I, any>
+		? I
+		: T extends MutationDef<infer I, any>
+			? I
+			: T extends SubscriptionDef<infer I, any>
+				? I
+				: never;
 
 export type InferOutput<T> =
 	T extends QueryDef<any, infer O>
 		? O
 		: T extends MutationDef<any, infer O>
 			? O
-			: T extends FieldType<infer F>
-				? F
-				: never;
+			: T extends SubscriptionDef<any, infer O>
+				? O
+				: T extends FieldType<infer F>
+					? F
+					: never;
 
 export type InferApi<T> = T extends { _types: infer Types } ? Types : never;
 

package/src/storage/memory.ts

@@ -42,6 +42,26 @@ function makeKey(entity: string, entityId: string): EntityKey {
 	return `${entity}:${entityId}`;
 }
 
+/**
+ * Stable JSON stringify that sorts object keys for consistent comparison.
+ * This ensures { a: 1, b: 2 } and { b: 2, a: 1 } produce the same string.
+ */
+function stableStringify(value: unknown): string {
+	if (value === null || typeof value !== "object") {
+		return JSON.stringify(value);
+	}
+
+	if (Array.isArray(value)) {
+		return `[${value.map(stableStringify).join(",")}]`;
+	}
+
+	const sortedKeys = Object.keys(value as Record<string, unknown>).sort();
+	const pairs = sortedKeys.map(
+		(key) => `${JSON.stringify(key)}:${stableStringify((value as Record<string, unknown>)[key])}`,
+	);
+	return `{${pairs.join(",")}}`;
+}
+
 /**
  * Compute JSON Patch operations between two states.
  */
@@ -61,8 +81,8 @@ function computePatch(
 		if (!oldKeys.has(key)) {
 			// New field
 			patch.push({ op: "add", path: `/${key}`, value: newValue });
-		} else if (JSON.stringify(oldValue) !== JSON.stringify(newValue)) {
-			// Changed field
+		} else if (stableStringify(oldValue) !== stableStringify(newValue)) {
+			// Changed field - use stable stringify for consistent comparison
 			patch.push({ op: "replace", path: `/${key}`, value: newValue });
 		}
 	}
@@ -79,9 +99,10 @@ function computePatch(
 
 /**
  * Hash entity state for change detection.
+ * Uses stable stringify to ensure consistent hashing regardless of key order.
  */
 function hashState(state: Record<string, unknown>): string {
-	return JSON.stringify(state);
+	return stableStringify(state);
 }
 
 /**