@signalium/query 1.0.8 → 1.0.10

package/dist/esm/QueryClient.js.map

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

package/dist/esm/QueryResult.d.ts

@@ -1,12 +1,12 @@
-import { BaseQueryResult } from './types.js';
+import { BaseQueryResult, QueryExtra } from './types.js';
 import { type AnyQueryDefinition, type QueryClient, type QueryParams } from './QueryClient.js';
 /**
  * QueryResult wraps a DiscriminatedReactivePromise and adds additional functionality
  * like refetch, while forwarding all the base relay properties.
  * This class combines the old QueryInstance and QueryResultImpl into a single entity.
  */
-export declare class QueryResultImpl<T> implements BaseQueryResult<T> {
-    def: AnyQueryDefinition<any, any>;
+export declare class QueryResultImpl<T> implements BaseQueryResult<T, unknown, unknown> {
+    def: AnyQueryDefinition<any, any, any>;
     queryKey: number;
     private queryClient;
     private initialized;
@@ -15,17 +15,21 @@ export declare class QueryResultImpl<T> implements BaseQueryResult<T> {
     private updatedAt;
     private params;
     private refIds;
+    private allNestedRefIdsSignal;
     private refetchPromise;
     private fetchMorePromise;
     private attemptCount;
     private unsubscribe?;
+    private streamUnsubscribe?;
     private relay;
     private _relayState;
     private wasOffline;
     private get relayState();
+    private _extra;
+    private get extraData();
     private _nextPageParams;
     private get nextPageParams();
-    constructor(def: AnyQueryDefinition<any, any>, queryClient: QueryClient, queryKey: number, params: QueryParams | undefined);
+    constructor(def: AnyQueryDefinition<any, any, any>, queryClient: QueryClient, queryKey: number, params: QueryParams | undefined);
     get value(): T | undefined;
     get error(): unknown;
     get isPending(): boolean;
@@ -40,13 +44,15 @@ export declare class QueryResultImpl<T> implements BaseQueryResult<T> {
     catch<TResult = never>(onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | null | undefined): Promise<T | TResult>;
     finally(onfinally?: (() => void) | null | undefined): Promise<T>;
     get [Symbol.toStringTag](): string;
+    private getAllEntityRefs;
     /**
      * Initialize the query by loading from cache and fetching if stale
      */
     private initialize;
     /**
-     * Handle stream updates by merging with existing entity.
-     * Deep merging is handled automatically by parseEntities/setEntity.
+     * Handle stream updates. This method handles both StreamQuery and Query/InfiniteQuery with stream options.
+     * - For StreamQuery: directly updates the relay state with the entity
+     * - For Query/InfiniteQuery with stream: updates entities in response or adds to orphans
      */
     private setupSubscription;
     /**
@@ -59,6 +65,28 @@ export declare class QueryResultImpl<T> implements BaseQueryResult<T> {
     get isFetchingMore(): boolean;
     get isFetching(): boolean;
     get hasNextPage(): boolean;
+    get extra(): QueryExtra<unknown, unknown>;
+    /**
+     * Persist the current extra data to the store
+     */
+    private persistExtraData;
+    /**
+     * Get extra data for persistence (converts Sets to arrays of entity ref IDs)
+     */
+    private getExtraForPersistence;
+    /**
+     * Add an optimistic insert to the query result.
+     * The insert will be automatically removed when:
+     * - The entity appears in a refetched response
+     * - The entity appears as a stream orphan
+     * - refetch() is called
+     */
+    addOptimisticInsert(insert: Record<string, unknown>): void;
+    /**
+     * Remove an optimistic insert from the query result.
+     * This is a no-op if the insert has already been removed.
+     */
+    removeOptimisticInsert(insert: Record<string, unknown>): void;
     get isStale(): boolean;
     get isPaused(): boolean;
     private getRetryConfig;

package/dist/esm/QueryResult.d.ts.map

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

package/dist/esm/QueryResult.js

@@ -1,9 +1,252 @@
-import { relay, signal } from 'signalium';
+import { relay, signal, reactiveSignal, notifier, } from 'signalium';
 import { setReactivePromise } from 'signalium/utils';
-import { NetworkMode, } from './types.js';
-import { parseValue } from './proxy.js';
-import { parseEntities } from './parseEntities.js';
+import { NetworkMode } from './types.js';
+import { getProxyId, parseValue } from './proxy.js';
+import { parseEntities, parseObjectEntities } from './parseEntities.js';
 import { ValidatorDef } from './typeDefs.js';
+// ======================================================
+// QueryResultExtra - Manages stream orphans and optimistic inserts
+// ======================================================
+/**
+ * Manages extra data for a query result: stream orphans and optimistic inserts.
+ * Created lazily when first needed.
+ */
+class QueryResultExtra {
+    _streamOrphansNotifier = undefined;
+    _streamOrphans = undefined;
+    _optimisticInsertsNotifier = undefined;
+    _optimisticInserts = undefined;
+    onChanged;
+    constructor(onChanged) {
+        this.onChanged = onChanged;
+    }
+    get streamOrphansNotifier() {
+        return this._streamOrphansNotifier ?? (this._streamOrphansNotifier = notifier());
+    }
+    get optimisticInsertsNotifier() {
+        return this._optimisticInsertsNotifier ?? (this._optimisticInsertsNotifier = notifier());
+    }
+    get streamOrphans() {
+        return this._streamOrphans ?? (this._streamOrphans = new Set());
+    }
+    get optimisticInserts() {
+        return this._optimisticInserts ?? (this._optimisticInserts = new Set());
+    }
+    /**
+     * Returns the QueryExtra object for public API consumption.
+     * Consumes the notifiers to establish reactive tracking.
+     */
+    getExtra() {
+        this.streamOrphansNotifier.consume();
+        this.optimisticInsertsNotifier.consume();
+        return {
+            streamOrphans: this.streamOrphans,
+            optimisticInserts: this.optimisticInserts,
+        };
+    }
+    /**
+     * Add a stream orphan entity.
+     * Returns true if the orphan was added (not a duplicate).
+     */
+    addStreamOrphan(entity) {
+        const orphans = this.streamOrphans;
+        const sizeBefore = orphans.size;
+        orphans.add(entity);
+        if (orphans.size !== sizeBefore) {
+            this.streamOrphansNotifier.notify();
+            // Check if this orphan was an optimistic insert - if so, remove it
+            const proxyId = getProxyId(entity);
+            if (proxyId !== undefined) {
+                this.removeOptimisticInsertById(proxyId);
+            }
+            this.onChanged();
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Add an optimistic insert entity.
+     * Returns true if the insert was added (not a duplicate).
+     */
+    addOptimisticInsert(entity) {
+        const inserts = this.optimisticInserts;
+        const sizeBefore = inserts.size;
+        inserts.add(entity);
+        if (inserts.size !== sizeBefore) {
+            this.optimisticInsertsNotifier.notify();
+            this.onChanged();
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Remove an optimistic insert by its entity.
+     * Returns true if the insert was removed.
+     */
+    removeOptimisticInsert(entity) {
+        const proxyId = getProxyId(entity);
+        if (proxyId === undefined) {
+            return false;
+        }
+        return this.removeOptimisticInsertById(proxyId);
+    }
+    /**
+     * Remove an optimistic insert by proxy ID.
+     */
+    removeOptimisticInsertById(proxyId) {
+        const inserts = this._optimisticInserts;
+        if (inserts === undefined || inserts.size === 0) {
+            return false;
+        }
+        for (const existing of inserts) {
+            if (getProxyId(existing) === proxyId) {
+                inserts.delete(existing);
+                this.optimisticInsertsNotifier.notify();
+                this.onChanged();
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Check if a proxy ID exists in stream orphans.
+     */
+    hasOrphanWithId(proxyId) {
+        const orphans = this._streamOrphans;
+        if (orphans === undefined) {
+            return false;
+        }
+        for (const orphan of orphans) {
+            if (getProxyId(orphan) === proxyId) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Reconcile orphans and optimistic inserts against the main response entity refs.
+     * Removes any that now exist in the main response.
+     */
+    reconcile(allRefIds) {
+        // Check stream orphans for entities that now exist in main response
+        const orphans = this._streamOrphans;
+        if (orphans !== undefined && orphans.size > 0) {
+            let orphansChanged = false;
+            for (const orphan of orphans) {
+                const entityRefId = getProxyId(orphan);
+                if (entityRefId !== undefined && allRefIds.has(entityRefId)) {
+                    orphans.delete(orphan);
+                    orphansChanged = true;
+                }
+            }
+            if (orphansChanged) {
+                this.streamOrphansNotifier.notify();
+            }
+        }
+        // Check optimistic inserts for entities that now exist in main response or stream orphans
+        const inserts = this._optimisticInserts;
+        if (inserts !== undefined && inserts.size > 0) {
+            let insertsChanged = false;
+            for (const insert of inserts) {
+                const entityRefId = getProxyId(insert);
+                if (entityRefId !== undefined) {
+                    // Remove if entity is now in main response
+                    if (allRefIds.has(entityRefId)) {
+                        inserts.delete(insert);
+                        insertsChanged = true;
+                    }
+                    // Also remove if entity is now in stream orphans
+                    else if (orphans !== undefined && orphans.has(insert)) {
+                        inserts.delete(insert);
+                        insertsChanged = true;
+                    }
+                }
+            }
+            if (insertsChanged) {
+                this.optimisticInsertsNotifier.notify();
+            }
+        }
+    }
+    /**
+     * Clear all stream orphans and optimistic inserts.
+     * Called on refetch.
+     */
+    clear() {
+        let changed = false;
+        if (this._streamOrphans !== undefined && this._streamOrphans.size > 0) {
+            this._streamOrphans = undefined;
+            this.streamOrphansNotifier.notify();
+            changed = true;
+        }
+        if (this._optimisticInserts !== undefined && this._optimisticInserts.size > 0) {
+            this._optimisticInserts = undefined;
+            this.optimisticInsertsNotifier.notify();
+            changed = true;
+        }
+        if (changed) {
+            this.onChanged();
+        }
+    }
+    /**
+     * Load extra data from cached values.
+     */
+    loadFromCache(cachedExtra, queryClient, streamShape, optimisticInsertsShape) {
+        if (cachedExtra.streamOrphanRefs && cachedExtra.streamOrphanRefs.length > 0 && streamShape) {
+            const orphans = this.streamOrphans;
+            for (const refId of cachedExtra.streamOrphanRefs) {
+                const entityRecord = queryClient.hydrateEntity(refId, streamShape);
+                orphans.add(entityRecord.proxy);
+            }
+        }
+        if (cachedExtra.optimisticInsertRefs && cachedExtra.optimisticInsertRefs.length > 0 && optimisticInsertsShape) {
+            const inserts = this.optimisticInserts;
+            for (const refId of cachedExtra.optimisticInsertRefs) {
+                const entityRecord = queryClient.hydrateEntity(refId, optimisticInsertsShape);
+                inserts.add(entityRecord.proxy);
+            }
+        }
+    }
+    /**
+     * Get extra data for persistence (converts Sets to arrays of entity ref IDs).
+     */
+    getForPersistence() {
+        const orphans = this._streamOrphans;
+        const inserts = this._optimisticInserts;
+        if ((orphans === undefined || orphans.size === 0) && (inserts === undefined || inserts.size === 0)) {
+            return undefined;
+        }
+        const extra = {};
+        if (orphans !== undefined && orphans.size > 0) {
+            extra.streamOrphanRefs = [];
+            for (const orphan of orphans) {
+                const refId = getProxyId(orphan);
+                if (refId !== undefined) {
+                    extra.streamOrphanRefs.push(refId);
+                }
+            }
+        }
+        if (inserts !== undefined && inserts.size > 0) {
+            extra.optimisticInsertRefs = [];
+            for (const insert of inserts) {
+                const refId = getProxyId(insert);
+                if (refId !== undefined) {
+                    extra.optimisticInsertRefs.push(refId);
+                }
+            }
+        }
+        return extra;
+    }
+    /**
+     * Check if there's any extra data.
+     */
+    get hasData() {
+        return ((this._streamOrphans !== undefined && this._streamOrphans.size > 0) ||
+            (this._optimisticInserts !== undefined && this._optimisticInserts.size > 0));
+    }
+}
+// ======================================================
+// QueryResultImpl
+// ======================================================
 /**
  * QueryResult wraps a DiscriminatedReactivePromise and adds additional functionality
  * like refetch, while forwarding all the base relay properties.
@@ -19,10 +262,12 @@ export class QueryResultImpl {
     updatedAt = undefined;
     params = undefined;
     refIds = undefined;
+    allNestedRefIdsSignal = undefined;
     refetchPromise = undefined;
     fetchMorePromise = undefined;
     attemptCount = 0;
     unsubscribe = undefined;
+    streamUnsubscribe = undefined;
     relay;
     _relayState = undefined;
     wasOffline = false;
@@ -33,10 +278,14 @@ export class QueryResultImpl {
         }
         return relayState;
     }
+    _extra = undefined;
+    get extraData() {
+        return this._extra ?? (this._extra = new QueryResultExtra(() => this.persistExtraData()));
+    }
     _nextPageParams = undefined;
     get nextPageParams() {
-        // Streams don't have pagination
-        if (this.def.type === "stream" /* QueryType.Stream */) {
+        // Streams and non-infinite queries don't have pagination
+        if (this.def.type !== "infiniteQuery" /* QueryType.InfiniteQuery */) {
             return null;
         }
         let params = this._nextPageParams;
@@ -84,10 +333,12 @@ export class QueryResultImpl {
             // Store initial offline state
             this.wasOffline = !isOnline;
             if (this.initialized) {
-                if (this.def.type === "stream" /* QueryType.Stream */) {
+                // For any query with streams, resubscribe on reactivation
+                if (this.def.type === "stream" /* QueryType.Stream */ ||
+                    this.def.stream) {
                     this.setupSubscription();
                 }
-                else {
+                if (this.def.type !== "stream" /* QueryType.Stream */) {
                     // Check if we just came back online
                     if (!this.wasOffline && isOnline) {
                         // We're back online - check if we should refresh
@@ -111,9 +362,13 @@ export class QueryResultImpl {
             // Return deactivation callback
             return {
                 update: () => {
-                    // For streams, unsubscribe and resubscribe to re-establish connection
-                    if (this.def.type === "stream" /* QueryType.Stream */) {
+                    // For any query with streams, unsubscribe and resubscribe to re-establish connection
+                    if (this.def.type === "stream" /* QueryType.Stream */ ||
+                        this.def.stream) {
                         this.setupSubscription();
+                    }
+                    // For StreamQuery, we're done - it doesn't react to network status
+                    if (this.def.type === "stream" /* QueryType.Stream */) {
                         return;
                     }
                     // Network status changed - check if we should react
@@ -132,14 +387,17 @@ export class QueryResultImpl {
                 },
                 deactivate: () => {
                     // Last subscriber left, deactivate refetch and schedule memory eviction
-                    if (this.def.type === "stream" /* QueryType.Stream */) {
-                        // Unsubscribe from stream
-                        if (this.unsubscribe) {
-                            this.unsubscribe();
-                            this.unsubscribe = undefined;
-                        }
+                    // Unsubscribe from any active streams
+                    if (this.unsubscribe) {
+                        this.unsubscribe();
+                        this.unsubscribe = undefined;
+                    }
+                    if (this.streamUnsubscribe) {
+                        this.streamUnsubscribe();
+                        this.streamUnsubscribe = undefined;
                     }
-                    else if (this.def.cache?.refetchInterval) {
+                    // Remove from refetch manager if configured
+                    if (this.def.type !== "stream" /* QueryType.Stream */ && this.def.cache?.refetchInterval) {
                         this.queryClient.refetchManager.removeQuery(this);
                     }
                     // Schedule removal from memory using the global eviction manager
@@ -201,6 +459,28 @@ export class QueryResultImpl {
     // ======================================================
     // Internal fetch methods
     // ======================================================
+    getAllEntityRefs() {
+        let allNestedRefIdsSignal = this.allNestedRefIdsSignal;
+        if (!allNestedRefIdsSignal) {
+            const queryClient = this.queryClient;
+            this.allNestedRefIdsSignal = allNestedRefIdsSignal = reactiveSignal(() => {
+                // Entangle the relay value. Whenever the relay value is updated, the
+                // allNestedRefIdsSignal will be updated, so no need for a second signal.
+                // eslint-disable-next-line @typescript-eslint/no-unused-expressions
+                this.relay.value;
+                const allRefIds = new Set();
+                if (this.refIds !== undefined) {
+                    for (const refId of this.refIds) {
+                        queryClient.getNestedEntityRefIds(refId, allRefIds);
+                    }
+                }
+                // Reconcile extra data against the main response
+                this.extraData.reconcile(allRefIds);
+                return allRefIds;
+            });
+        }
+        return allNestedRefIdsSignal.value;
+    }
     /**
      * Initialize the query by loading from cache and fetching if stale
      */
@@ -211,20 +491,30 @@ export class QueryResultImpl {
             // Load from cache first
             const cached = await this.queryClient.loadCachedQuery(this.def, this.queryKey);
             if (cached !== undefined) {
+                // Set the cached timestamp
+                this.updatedAt = cached.updatedAt;
+                // Set the cached reference IDs
+                this.refIds = cached.refIds;
+                // Load extra data (stream orphans and optimistic inserts) BEFORE setting state.value
+                // because setting state.value resolves the relay
+                if (cached.extra) {
+                    const def = this.def;
+                    this.extraData.loadFromCache(cached.extra, this.queryClient, def.stream?.shape, def.optimisticInserts?.shape);
+                }
+                // Set the value last - this resolves the relay
                 const shape = this.def.shape;
                 state.value =
                     shape instanceof ValidatorDef
                         ? parseEntities(cached.value, shape, this.queryClient, new Set())
                         : parseValue(cached.value, shape, this.def.id);
-                // Set the cached timestamp
-                this.updatedAt = cached.updatedAt;
-                // Set the cached reference IDs
-                this.refIds = cached.refIds;
             }
-            if (this.def.type === "stream" /* QueryType.Stream */) {
+            // Setup subscriptions (handles both StreamQuery and Query/InfiniteQuery with stream)
+            if (this.def.type === "stream" /* QueryType.Stream */ ||
+                this.def.stream) {
                 this.setupSubscription();
             }
-            else {
+            // For non-stream queries, fetch if stale or no cache
+            if (this.def.type !== "stream" /* QueryType.Stream */) {
                 if (cached !== undefined) {
                     // Check if data is stale
                     if (this.isStale) {
@@ -244,22 +534,43 @@ export class QueryResultImpl {
         }
     }
     /**
-     * Handle stream updates by merging with existing entity.
-     * Deep merging is handled automatically by parseEntities/setEntity.
+     * Handle stream updates. This method handles both StreamQuery and Query/InfiniteQuery with stream options.
+     * - For StreamQuery: directly updates the relay state with the entity
+     * - For Query/InfiniteQuery with stream: updates entities in response or adds to orphans
      */
     setupSubscription() {
         this.unsubscribe?.();
-        const streamDef = this.def;
-        this.unsubscribe = streamDef.subscribeFn(this.queryClient.getContext(), this.params, update => {
-            const shapeDef = this.def.shape;
-            const entityRefs = this.refIds ?? new Set();
-            const parsedData = parseEntities(update, shapeDef, this.queryClient, entityRefs);
+        let subscribeFn;
+        let shapeDef;
+        if (this.def.type === "stream" /* QueryType.Stream */) {
+            shapeDef = this.def.shape;
+            subscribeFn = this.def.subscribeFn;
+        }
+        else {
+            const stream = this.def.stream;
+            if (!stream) {
+                return;
+            }
+            shapeDef = stream.shape;
+            subscribeFn = stream.subscribeFn;
+        }
+        this.unsubscribe = subscribeFn(this.queryClient.getContext(), this.params, update => {
+            const parsedData = parseObjectEntities(update, shapeDef, this.queryClient);
             // Update the relay state
-            this.relayState.value = parsedData;
-            this.updatedAt = Date.now();
-            this.refIds = entityRefs;
-            // Cache the data
-            this.queryClient.saveQueryData(this.def, this.queryKey, parsedData, this.updatedAt, entityRefs);
+            if (this.def.type === "stream" /* QueryType.Stream */) {
+                this.relayState.value = parsedData;
+                this.updatedAt = Date.now();
+                // Cache the data
+                this.queryClient.saveQueryData(this.def, this.queryKey, parsedData, this.updatedAt);
+            }
+            else {
+                const allRefIds = this.getAllEntityRefs();
+                const proxyId = getProxyId(parsedData);
+                // Add to orphans if not in main response
+                if (proxyId !== undefined && !allRefIds.has(proxyId)) {
+                    this.extraData.addStreamOrphan(parsedData);
+                }
+            }
         });
     }
     /**
@@ -286,7 +597,7 @@ export class QueryResultImpl {
                     entityRefs = this.refIds;
                 }
                 else {
-                    entityRefs = new Set();
+                    entityRefs = this.refIds = new Set();
                 }
                 const shape = this.def.shape;
                 const parsedData = shape instanceof ValidatorDef
@@ -309,7 +620,7 @@ export class QueryResultImpl {
                 }
                 this._nextPageParams = undefined;
                 // Cache the data (synchronous, fire-and-forget)
-                this.queryClient.saveQueryData(this.def, this.queryKey, queryData, updatedAt, entityRefs);
+                this.queryClient.saveQueryData(this.def, this.queryKey, queryData, updatedAt, entityRefs, this.getExtraForPersistence());
                 // Update the timestamp
                 this.updatedAt = Date.now();
                 return queryData;
@@ -355,6 +666,10 @@ export class QueryResultImpl {
         const promise = this.runQuery(this.params, true)
             .then(result => {
             this.relayState.value = result;
+            // Clear stream orphans and optimistic inserts on refetch
+            if (this._extra !== undefined) {
+                this._extra.clear();
+            }
             return result;
         })
             .catch((error) => {
@@ -420,6 +735,68 @@ export class QueryResultImpl {
     get hasNextPage() {
         return this.nextPageParams !== null;
     }
+    get extra() {
+        this.getAllEntityRefs();
+        return this.extraData.getExtra();
+    }
+    /**
+     * Persist the current extra data to the store
+     */
+    persistExtraData() {
+        if (this.updatedAt === undefined) {
+            return; // Query not initialized yet
+        }
+        const extra = this._extra?.getForPersistence();
+        this.queryClient.saveQueryData(this.def, this.queryKey, this.relayState.value, this.updatedAt, this.refIds, extra);
+    }
+    /**
+     * Get extra data for persistence (converts Sets to arrays of entity ref IDs)
+     */
+    getExtraForPersistence() {
+        return this._extra?.getForPersistence();
+    }
+    /**
+     * Add an optimistic insert to the query result.
+     * The insert will be automatically removed when:
+     * - The entity appears in a refetched response
+     * - The entity appears as a stream orphan
+     * - refetch() is called
+     */
+    addOptimisticInsert(insert) {
+        // Check that the query has optimisticInserts configured
+        const def = this.def;
+        const optimisticInsertsConfig = def.optimisticInserts;
+        if (optimisticInsertsConfig === undefined) {
+            throw new Error('Query does not have optimisticInserts configured. Add optimisticInserts: { type: YourEntity } to the query definition.');
+        }
+        let proxyId = getProxyId(insert);
+        let parsedInsert = insert;
+        // If not already a proxy, parse it through the optimisticInserts shape
+        if (proxyId === undefined) {
+            parsedInsert = parseObjectEntities(insert, optimisticInsertsConfig.shape, this.queryClient);
+            proxyId = getProxyId(parsedInsert);
+            if (proxyId === undefined) {
+                throw new Error('Optimistic insert must be or produce an entity proxy');
+            }
+        }
+        // Check if already in main response
+        const allRefIds = this.getAllEntityRefs();
+        if (allRefIds.has(proxyId)) {
+            return; // Already in response, no-op
+        }
+        // Check if already in stream orphans
+        if (this.extraData.hasOrphanWithId(proxyId)) {
+            return; // Already in stream orphans, no-op
+        }
+        this.extraData.addOptimisticInsert(parsedInsert);
+    }
+    /**
+     * Remove an optimistic insert from the query result.
+     * This is a no-op if the insert has already been removed.
+     */
+    removeOptimisticInsert(insert) {
+        this.extraData.removeOptimisticInsert(insert);
+    }
     get isStale() {
         // Streams are never stale - they're always receiving updates
         if (this.def.type === "stream" /* QueryType.Stream */) {