@minnowdb/core 0.7.8 → 0.8.0

package/dist/engine/client.d.ts

@@ -1,8 +1,9 @@
+import { type LiveQueryPatchOptions } from "./live-patch.js";
 import { type CompactionJobRecord, type GarbageCollectionJobRecord, type StorageIntegrityMode, type StorageIntegrityReport, type StorageStats, type InterruptedSnapshotImport, type InterruptedSnapshotImportAbortResult } from "../storage/types.js";
 import { type BatchRow } from "./batch.js";
 import type { Catalog } from "./catalog.js";
 import type { BufferPoolStats, StagedWriteResult, StagedUpsertResult, BufferedFlushResult, BufferedWriterOptions, CancelCompactionJobResult, CollectGarbageOptions, CollectGarbageStepOptions, CompactTableOptions, CompactTableResult, CompactTableStepOptions, CompactionJobProgress, CreateTableInput, MigrateOptions, DeleteBatchResult, ExecuteOptions, ExecuteResult, GarbageCollectionProgress, GarbageCollectionResult, MaintenanceStatus, InsertBatchResult, QueryOptions, QueryExecutionStats, QueryCursorOptions, QuerySpillCleanupOptions, QuerySpillCleanupResult, RunStatementOptions, SnapshotExportOptions, SnapshotImportOptions, TableDefinition, UpdateBatchResult, UpsertBatchResult, VisibleSegmentPage, VisibleSegmentPageOptions } from "./database.js";
-import type { LiveQueryInput, LiveQueryInvalidation, LiveQueryObserveOptions, LiveQueryStats, LiveQuerySubscribeOptions } from "./live.js";
+import type { LiveQueryDelivery, LiveQueryInput, LiveQueryInvalidation, LiveQueryObserveOptions, LiveQueryStats, LiveQuerySubscribeOptions } from "./live.js";
 import type { CompiledQuery, CompiledStatement, QueryResult, QueryValue } from "./query.js";
 import type { AnySchema, UntypedSchema, AnyTable, BatchColumnName, BatchDeleteInput, BatchInsertInput, BatchInsertRow, BatchKeyValue, BatchReadOptions, BatchReadRow, BatchUpdateChanges, BatchUpdateInput, BatchUpsertOptions, SchemaDefinition, TableName } from "./schema.js";
 import { type WireMigrationStep } from "./schema-wire.js";
@@ -65,7 +66,7 @@ export interface ClientMigrationResult {
     steps: WireMigrationStep[];
 }
 interface EventRoute {
-    onChange?: (result: QueryResult) => void;
+    onChange?: (result: QueryResult, delivery: LiveQueryDelivery) => void;
     onInvalidate?: (invalidation: LiveQueryInvalidation) => void;
     onError?: (error: unknown) => void;
     onComplete?: () => void;
@@ -264,6 +265,8 @@ export declare class ClientLiveQuerySet {
     constructor(client: MinnowDatabaseClient, handleId: string, created: Promise<unknown>);
     /** Registers a query (SQL or a compiled-plan envelope) and re-runs it on relevant changes. */
     subscribe(query: LiveQueryInput, options: LiveQuerySubscribeOptions): Promise<ClientLiveSubscription>;
+    /** Delivers changed row payloads; the worker transport still sends its result snapshot. */
+    subscribePatches(query: LiveQueryInput, options: LiveQueryPatchOptions): Promise<ClientLiveSubscription>;
     /** Registers dependency observation while leaving execution/result mapping to an adapter. */
     observe(query: LiveQueryInput, options: LiveQueryObserveOptions): Promise<ClientLiveSubscription>;
     stats(): Promise<LiveQueryStats>;

package/dist/engine/client.js

@@ -1,3 +1,4 @@
+import { createLiveQueryPatch } from "./live-patch.js";
 import { BlockReadBatchTooLargeError, CompactionBacklogError, CompactionJobConflictError, GarbageCollectionJobConflictError, IndexedDbSchemaUpgradeBlockedError, LeaseConflictError, LeaseExpiredError, LeaseOwnerConflictError, PostingBuildConflictError, SnapshotManifestMissingError, SnapshotImportConflictError, SchemaConflictError, StorageResourceLimitError, TableInUseError, TableRecordConflictError, TempOwnerConflictError, TransactionRecordConflictError, UniqueKeyBuildConflictError, UniqueKeyConflictError, UniqueIndexCoverageError, WriteConflictError, StorageCorruptionError, StorageFormatVersionError, OpfsUncertainOutcomeError } from "../storage/types.js";
 import { MAX_SNAPSHOT_STREAM_CHUNK_BYTES } from "../storage/snapshot.js";
 import { parseRpcResponse, MAX_DATABASE_RPC_IN_FLIGHT, protocolVersion } from "../worker-protocol/index.js";
@@ -556,9 +557,10 @@ class MinnowDatabaseClient {
       const route = this.#events.get(response.handleId);
       if (route === void 0)
         return;
-      if (response.event === "change")
-        route.onChange?.(decodeQueryResult(response.payload));
-      else if (response.event === "invalidate") {
+      if (response.event === "change") {
+        const { result, delivery } = response.payload;
+        route.onChange?.(decodeQueryResult(result), delivery);
+      } else if (response.event === "invalidate") {
         route.onInvalidate?.(response.payload);
       } else if (response.event === "error") {
         route.onError?.(rehydrateResponseError(response.payload));
@@ -682,6 +684,13 @@ class ClientLiveQuerySet {
       throw error;
     }
   }
+  subscribePatches(query, options) {
+    return this.subscribe(query, {
+      onChange: (result, delivery) => options.onPatch(createLiveQueryPatch(result, delivery), delivery),
+      ...options.onError === void 0 ? {} : { onError: options.onError.bind(options) },
+      ...options.onComplete === void 0 ? {} : { onComplete: options.onComplete.bind(options) }
+    });
+  }
   async observe(query, options) {
     await this.#created;
     const subscriptionId = crypto.randomUUID();
@@ -698,7 +707,8 @@ class ClientLiveQuerySet {
     try {
       const created = await this.client._invoke(this.handleId, "observe", [
         subscriptionId,
-        query
+        query,
+        { suppressUnchanged: options.suppressUnchanged === true }
       ]);
       this.#subscriptionIds.add(subscriptionId);
       return new ClientLiveSubscription(this.client, subscriptionId, created.dependencyTableIds, () => this.#subscriptionIds.delete(subscriptionId), state);