@korajs/store 1.0.0-beta.1 → 1.0.0-beta.11

package/dist/index.d.cts

@@ -1,9 +1,9 @@
-import { C as CollectionRecord, S as StorageAdapter, Q as QueryDescriptor, c as SubscriptionCallback, W as WhereClause, d as OrderByDirection, L as LocalMutationHandler, e as StoreConfig, A as ApplyRemoteOptions, f as MaterializedRowSnapshot, g as RowVersionState } from './types-k6AZgiH4.cjs';
-export { M as MigrationPlan, h as OrderByClause, i as StoreIsolation, T as Transaction, j as TransactionBufferedEntry, k as TransactionCommitBatch, l as TransactionCommitResult, m as WhereOperators } from './types-k6AZgiH4.cjs';
+import { C as CollectionRecord, S as StorageAdapter, Q as QueryDescriptor, d as SubscriptionCallback, W as WhereClause, e as OrderByDirection, L as LocalMutationHandler, f as StoreConfig, A as ApplyRemoteOptions, g as MaterializedRowSnapshot, h as RowVersionState } from './types-BslDOTk0.cjs';
+export { M as MigrationPlan, i as OrderByClause, j as StorageFallbackReason, a as StorageOpenState, k as StoreIsolation, T as Transaction, l as TransactionBufferedEntry, m as TransactionCommitBatch, n as TransactionCommitResult, o as WhereOperators } from './types-BslDOTk0.cjs';
 import { Operation, KoraError, VersionVector, SchemaDefinition, HLCTimestamp, MergeTrace, CollectionDefinition, SequenceConfig, HybridLogicalClock, CausalTracker, OperationLog, ApplyResult, StateMachineDefinition, KoraBytesValue, KoraEvent, BlobRefMetadata, BlobRef } from '@korajs/core';
 export { ApplyResult } from '@korajs/core';
-import { R as RelationEnforcer, L as LocalMutationContext } from './types-DfPiPwKr.cjs';
-export { C as Collection } from './types-DfPiPwKr.cjs';
+import { R as RelationEnforcer, L as LocalMutationContext } from './types-C_GDavG-.cjs';
+export { C as Collection } from './types-C_GDavG-.cjs';
 import * as yjs from 'yjs';
 import { C as ContentAddressedBlobStore, M as MemoryBlobStore } from './content-addressed-blob-store-Dcj3SB9r.cjs';
 export { B as BlobIntegrityError } from './content-addressed-blob-store-Dcj3SB9r.cjs';
@@ -71,6 +71,15 @@ declare class WorkerInitError extends KoraError {
 declare class WorkerTimeoutError extends KoraError {
     constructor(operation: string, timeoutMs: number);
 }
+/**
+ * Thrown when a follower tab cannot reach a live leader tab over the multi-tab
+ * broadcast channel (the leader tab was closed, crashed, or is unresponsive).
+ * Distinct from {@link WorkerTimeoutError}: this fails fast on a confirmed-absent
+ * leader instead of waiting out the full RPC timeout.
+ */
+declare class NoLeaderError extends KoraError {
+    constructor(operation: string);
+}
 /**
  * Thrown when IndexedDB persistence operations fail (serialize/deserialize).
  */
@@ -811,6 +820,14 @@ declare class Store implements OperationLog {
      * Route local CRUD through the unified apply pipeline (korajs ApplyPipeline).
      */
     setLocalMutationHandler(handler: LocalMutationHandler | null): void;
+    /**
+     * Notify this store that another same-origin runtime committed an operation to
+     * the shared local database. The operation has already been persisted and
+     * materialized by the database owner; this method only advances in-memory causal
+     * watermarks and invalidates local reactive queries so already-open tabs stay
+     * live without reapplying or rewriting the operation.
+     */
+    notifyExternalOperation(operation: Operation): void;
     /**
      * Build mutation context for a collection (used by ApplyPipeline side effects).
      */
@@ -849,6 +866,23 @@ declare class Store implements OperationLog {
      * Persist or clear the delta cursor for paginated initial sync resume.
      */
     saveDeltaCursor(cursor: string | null): Promise<void>;
+    /**
+     * Load the persisted delivery watermark for a view signature (0 when none recorded).
+     * Defaults to the unfiltered view so existing single-watermark reads keep working.
+     */
+    loadDeliveryWatermark(signature?: string): Promise<number>;
+    /**
+     * Persist the delivery watermark for a view signature so it survives a client restart.
+     */
+    saveDeliveryWatermark(signature: string, watermark: number): Promise<void>;
+    /**
+     * Load every persisted view watermark, keyed by signature.
+     */
+    loadAllDeliveryWatermarks(): Promise<Record<string, number>>;
+    /**
+     * Delete a persisted view watermark (safe: the view back-fills from 0 when next visited).
+     */
+    deleteDeliveryWatermark(signature: string): Promise<void>;
     /**
      * Local operations not yet reflected on the server version vector.
      */
@@ -883,6 +917,12 @@ declare class Store implements OperationLog {
      * Latest operation for a record from any node (for 3-way merge when local op log is empty).
      */
     getLatestOperationForRecord(collection: string, recordId: string): Promise<Operation | null>;
+    /**
+     * All operations for a record, sorted in HLC total order (wallTime, logical,
+     * nodeId). Used by the apply pipeline to materialize atomic-op fields by folding
+     * the record's log, matching the server's materialization exactly.
+     */
+    getOperationsForRecord(collection: string, recordId: string): Promise<Operation[]>;
     /** Expose the subscription manager for direct access (e.g., by QueryBuilder) */
     getSubscriptionManager(): SubscriptionManager;
     /**
@@ -976,6 +1016,7 @@ declare class QueryStore<T = CollectionRecord> {
     private listeners;
     private unsubscribeQuery;
     private active;
+    private hasEmittedSnapshot;
     private readonly queryBuilder;
     constructor(queryBuilder: QueryBuilder<T>);
     /**
@@ -986,6 +1027,11 @@ declare class QueryStore<T = CollectionRecord> {
     subscribe: (onStoreChange: () => void) => (() => void);
     /** Synchronous read of the latest query results. */
     getSnapshot: () => readonly T[];
+    /**
+     * Whether the underlying query subscription has delivered at least one
+     * authoritative result for the current subscription lifecycle.
+     */
+    hasSnapshot: () => boolean;
     /** Tear down listeners and the underlying query subscription. */
     destroy(): void;
     private startSubscription;
@@ -1748,4 +1794,4 @@ declare function createChunkPortPair(): {
     b: ChunkMessagePort;
 };
 
-export { AdapterError, ApplyRemoteOptions, type AuditExportManifest, type AuditExportOptions, type AuditExportPayload, type AuditExportProgress, type AuditTraceQuery, type BackupManifest, type BackupOptions, type BackupProgress, type BlobGcOptions, type BlobGcResult, type BlobManifest, type BlobManifestMetadata, COMPACTION_BASELINE_META_KEY, type ChunkMessage, type ChunkMessagePort, type ChunkProvider, type ChunkRequestMessage, type ChunkResponseMessage, type ClockRebaseResult, type CollectionAccessor, CollectionRecord, type CompactionResult, type CompactionStrategy, ContentAddressedBlobStore, type CreateRichTextControllerOptions, DEFAULT_CHUNK_SIZE, InvalidStateTransitionError, LAST_ACKED_SERVER_VECTOR_META_KEY, LocalMutationHandler, MaterializedRowSnapshot, MemoryBlobStore, type OpfsBlobDirectory, OpfsBlobStore, OptimisticLockError, OrderByDirection, type PersistedAuditTrace, PersistenceError, QueryBuilder, QueryDescriptor, QueryError, QueryStore, QueryStoreCache, type ReceiveBlobResult, type ReceiveBlobStores, RecordNotFoundError, type RemoteChunkProvider, type ReplaySnapshot, type RestoreOptions, type RestoreResult, type RichTextAwarenessUser, type RichTextController, type RichTextControllerSnapshot, type RichTextCursorInfo, type RichTextSyncEngine, RowVersionState, SequenceManager, type ServerBlobCallbacks, StorageAdapter, Store, StoreConfig, StoreNotOpenError, SubscriptionBloomFilter, SubscriptionCallback, SubscriptionManager, type SubscriptionManagerOptions, type SubscriptionStats, type TransactionCollectionAccessor, TransactionContext, type TransactionContextConfig, WhereClause, WorkerInitError, WorkerTimeoutError, asRichTextSyncEngine, assertQueryReady, chunkBlob, collectBlobGarbage, collectOperationsAheadOfServer, compactOperationLog, computeAckCompactionWatermark, createChunkPortPair, createMemoryServerBlobStore, createOpfsBlobDirectory, createOpfsBlobStore, createRemoteChunkProvider, createRichTextController, decodeAuditExport, decodeRichtext, deserializeVersionVectorFromMeta, encodeRichtext, exportBackup, extractBlobRefs, fetchBlobManifest, getSharedQueryStoreCache, mergeVersionVectors, parseBlobManifest, persistedAuditTraceFromEvent, pluralize, prepareBlobForSend, putBlobForTransfer, readAuditExportManifest, readBackupManifest, reassembleBlob, receiveBlob, resolveBlobManifest, restoreBackup, richtextStatesEqual, richtextToPlainText, serializeBlobManifest, serializeVersionVectorToMeta, serveBlobChunks, singularize, toServerBlobCallbacks, validateStateTransition, validateUpdateStateMachine, verifyAuditExportChecksum, verifyBackupChecksum };
+export { AdapterError, ApplyRemoteOptions, type AuditExportManifest, type AuditExportOptions, type AuditExportPayload, type AuditExportProgress, type AuditTraceQuery, type BackupManifest, type BackupOptions, type BackupProgress, type BlobGcOptions, type BlobGcResult, type BlobManifest, type BlobManifestMetadata, COMPACTION_BASELINE_META_KEY, type ChunkMessage, type ChunkMessagePort, type ChunkProvider, type ChunkRequestMessage, type ChunkResponseMessage, type ClockRebaseResult, type CollectionAccessor, CollectionRecord, type CompactionResult, type CompactionStrategy, ContentAddressedBlobStore, type CreateRichTextControllerOptions, DEFAULT_CHUNK_SIZE, InvalidStateTransitionError, LAST_ACKED_SERVER_VECTOR_META_KEY, LocalMutationHandler, MaterializedRowSnapshot, MemoryBlobStore, NoLeaderError, type OpfsBlobDirectory, OpfsBlobStore, OptimisticLockError, OrderByDirection, type PersistedAuditTrace, PersistenceError, QueryBuilder, QueryDescriptor, QueryError, QueryStore, QueryStoreCache, type ReceiveBlobResult, type ReceiveBlobStores, RecordNotFoundError, type RemoteChunkProvider, type ReplaySnapshot, type RestoreOptions, type RestoreResult, type RichTextAwarenessUser, type RichTextController, type RichTextControllerSnapshot, type RichTextCursorInfo, type RichTextSyncEngine, RowVersionState, SequenceManager, type ServerBlobCallbacks, StorageAdapter, Store, StoreConfig, StoreNotOpenError, SubscriptionBloomFilter, SubscriptionCallback, SubscriptionManager, type SubscriptionManagerOptions, type SubscriptionStats, type TransactionCollectionAccessor, TransactionContext, type TransactionContextConfig, WhereClause, WorkerInitError, WorkerTimeoutError, asRichTextSyncEngine, assertQueryReady, chunkBlob, collectBlobGarbage, collectOperationsAheadOfServer, compactOperationLog, computeAckCompactionWatermark, createChunkPortPair, createMemoryServerBlobStore, createOpfsBlobDirectory, createOpfsBlobStore, createRemoteChunkProvider, createRichTextController, decodeAuditExport, decodeRichtext, deserializeVersionVectorFromMeta, encodeRichtext, exportBackup, extractBlobRefs, fetchBlobManifest, getSharedQueryStoreCache, mergeVersionVectors, parseBlobManifest, persistedAuditTraceFromEvent, pluralize, prepareBlobForSend, putBlobForTransfer, readAuditExportManifest, readBackupManifest, reassembleBlob, receiveBlob, resolveBlobManifest, restoreBackup, richtextStatesEqual, richtextToPlainText, serializeBlobManifest, serializeVersionVectorToMeta, serveBlobChunks, singularize, toServerBlobCallbacks, validateStateTransition, validateUpdateStateMachine, verifyAuditExportChecksum, verifyBackupChecksum };

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { C as CollectionRecord, S as StorageAdapter, Q as QueryDescriptor, c as SubscriptionCallback, W as WhereClause, d as OrderByDirection, L as LocalMutationHandler, e as StoreConfig, A as ApplyRemoteOptions, f as MaterializedRowSnapshot, g as RowVersionState } from './types-k6AZgiH4.js';
-export { M as MigrationPlan, h as OrderByClause, i as StoreIsolation, T as Transaction, j as TransactionBufferedEntry, k as TransactionCommitBatch, l as TransactionCommitResult, m as WhereOperators } from './types-k6AZgiH4.js';
+import { C as CollectionRecord, S as StorageAdapter, Q as QueryDescriptor, d as SubscriptionCallback, W as WhereClause, e as OrderByDirection, L as LocalMutationHandler, f as StoreConfig, A as ApplyRemoteOptions, g as MaterializedRowSnapshot, h as RowVersionState } from './types-BslDOTk0.js';
+export { M as MigrationPlan, i as OrderByClause, j as StorageFallbackReason, a as StorageOpenState, k as StoreIsolation, T as Transaction, l as TransactionBufferedEntry, m as TransactionCommitBatch, n as TransactionCommitResult, o as WhereOperators } from './types-BslDOTk0.js';
 import { Operation, KoraError, VersionVector, SchemaDefinition, HLCTimestamp, MergeTrace, CollectionDefinition, SequenceConfig, HybridLogicalClock, CausalTracker, OperationLog, ApplyResult, StateMachineDefinition, KoraBytesValue, KoraEvent, BlobRefMetadata, BlobRef } from '@korajs/core';
 export { ApplyResult } from '@korajs/core';
-import { R as RelationEnforcer, L as LocalMutationContext } from './types-5h4Hqcwc.js';
-export { C as Collection } from './types-5h4Hqcwc.js';
+import { R as RelationEnforcer, L as LocalMutationContext } from './types-BOO9EPt1.js';
+export { C as Collection } from './types-BOO9EPt1.js';
 import * as yjs from 'yjs';
 import { C as ContentAddressedBlobStore, M as MemoryBlobStore } from './content-addressed-blob-store-Dcj3SB9r.js';
 export { B as BlobIntegrityError } from './content-addressed-blob-store-Dcj3SB9r.js';
@@ -71,6 +71,15 @@ declare class WorkerInitError extends KoraError {
 declare class WorkerTimeoutError extends KoraError {
     constructor(operation: string, timeoutMs: number);
 }
+/**
+ * Thrown when a follower tab cannot reach a live leader tab over the multi-tab
+ * broadcast channel (the leader tab was closed, crashed, or is unresponsive).
+ * Distinct from {@link WorkerTimeoutError}: this fails fast on a confirmed-absent
+ * leader instead of waiting out the full RPC timeout.
+ */
+declare class NoLeaderError extends KoraError {
+    constructor(operation: string);
+}
 /**
  * Thrown when IndexedDB persistence operations fail (serialize/deserialize).
  */
@@ -811,6 +820,14 @@ declare class Store implements OperationLog {
      * Route local CRUD through the unified apply pipeline (korajs ApplyPipeline).
      */
     setLocalMutationHandler(handler: LocalMutationHandler | null): void;
+    /**
+     * Notify this store that another same-origin runtime committed an operation to
+     * the shared local database. The operation has already been persisted and
+     * materialized by the database owner; this method only advances in-memory causal
+     * watermarks and invalidates local reactive queries so already-open tabs stay
+     * live without reapplying or rewriting the operation.
+     */
+    notifyExternalOperation(operation: Operation): void;
     /**
      * Build mutation context for a collection (used by ApplyPipeline side effects).
      */
@@ -849,6 +866,23 @@ declare class Store implements OperationLog {
      * Persist or clear the delta cursor for paginated initial sync resume.
      */
     saveDeltaCursor(cursor: string | null): Promise<void>;
+    /**
+     * Load the persisted delivery watermark for a view signature (0 when none recorded).
+     * Defaults to the unfiltered view so existing single-watermark reads keep working.
+     */
+    loadDeliveryWatermark(signature?: string): Promise<number>;
+    /**
+     * Persist the delivery watermark for a view signature so it survives a client restart.
+     */
+    saveDeliveryWatermark(signature: string, watermark: number): Promise<void>;
+    /**
+     * Load every persisted view watermark, keyed by signature.
+     */
+    loadAllDeliveryWatermarks(): Promise<Record<string, number>>;
+    /**
+     * Delete a persisted view watermark (safe: the view back-fills from 0 when next visited).
+     */
+    deleteDeliveryWatermark(signature: string): Promise<void>;
     /**
      * Local operations not yet reflected on the server version vector.
      */
@@ -883,6 +917,12 @@ declare class Store implements OperationLog {
      * Latest operation for a record from any node (for 3-way merge when local op log is empty).
      */
     getLatestOperationForRecord(collection: string, recordId: string): Promise<Operation | null>;
+    /**
+     * All operations for a record, sorted in HLC total order (wallTime, logical,
+     * nodeId). Used by the apply pipeline to materialize atomic-op fields by folding
+     * the record's log, matching the server's materialization exactly.
+     */
+    getOperationsForRecord(collection: string, recordId: string): Promise<Operation[]>;
     /** Expose the subscription manager for direct access (e.g., by QueryBuilder) */
     getSubscriptionManager(): SubscriptionManager;
     /**
@@ -976,6 +1016,7 @@ declare class QueryStore<T = CollectionRecord> {
     private listeners;
     private unsubscribeQuery;
     private active;
+    private hasEmittedSnapshot;
     private readonly queryBuilder;
     constructor(queryBuilder: QueryBuilder<T>);
     /**
@@ -986,6 +1027,11 @@ declare class QueryStore<T = CollectionRecord> {
     subscribe: (onStoreChange: () => void) => (() => void);
     /** Synchronous read of the latest query results. */
     getSnapshot: () => readonly T[];
+    /**
+     * Whether the underlying query subscription has delivered at least one
+     * authoritative result for the current subscription lifecycle.
+     */
+    hasSnapshot: () => boolean;
     /** Tear down listeners and the underlying query subscription. */
     destroy(): void;
     private startSubscription;
@@ -1748,4 +1794,4 @@ declare function createChunkPortPair(): {
     b: ChunkMessagePort;
 };
 
-export { AdapterError, ApplyRemoteOptions, type AuditExportManifest, type AuditExportOptions, type AuditExportPayload, type AuditExportProgress, type AuditTraceQuery, type BackupManifest, type BackupOptions, type BackupProgress, type BlobGcOptions, type BlobGcResult, type BlobManifest, type BlobManifestMetadata, COMPACTION_BASELINE_META_KEY, type ChunkMessage, type ChunkMessagePort, type ChunkProvider, type ChunkRequestMessage, type ChunkResponseMessage, type ClockRebaseResult, type CollectionAccessor, CollectionRecord, type CompactionResult, type CompactionStrategy, ContentAddressedBlobStore, type CreateRichTextControllerOptions, DEFAULT_CHUNK_SIZE, InvalidStateTransitionError, LAST_ACKED_SERVER_VECTOR_META_KEY, LocalMutationHandler, MaterializedRowSnapshot, MemoryBlobStore, type OpfsBlobDirectory, OpfsBlobStore, OptimisticLockError, OrderByDirection, type PersistedAuditTrace, PersistenceError, QueryBuilder, QueryDescriptor, QueryError, QueryStore, QueryStoreCache, type ReceiveBlobResult, type ReceiveBlobStores, RecordNotFoundError, type RemoteChunkProvider, type ReplaySnapshot, type RestoreOptions, type RestoreResult, type RichTextAwarenessUser, type RichTextController, type RichTextControllerSnapshot, type RichTextCursorInfo, type RichTextSyncEngine, RowVersionState, SequenceManager, type ServerBlobCallbacks, StorageAdapter, Store, StoreConfig, StoreNotOpenError, SubscriptionBloomFilter, SubscriptionCallback, SubscriptionManager, type SubscriptionManagerOptions, type SubscriptionStats, type TransactionCollectionAccessor, TransactionContext, type TransactionContextConfig, WhereClause, WorkerInitError, WorkerTimeoutError, asRichTextSyncEngine, assertQueryReady, chunkBlob, collectBlobGarbage, collectOperationsAheadOfServer, compactOperationLog, computeAckCompactionWatermark, createChunkPortPair, createMemoryServerBlobStore, createOpfsBlobDirectory, createOpfsBlobStore, createRemoteChunkProvider, createRichTextController, decodeAuditExport, decodeRichtext, deserializeVersionVectorFromMeta, encodeRichtext, exportBackup, extractBlobRefs, fetchBlobManifest, getSharedQueryStoreCache, mergeVersionVectors, parseBlobManifest, persistedAuditTraceFromEvent, pluralize, prepareBlobForSend, putBlobForTransfer, readAuditExportManifest, readBackupManifest, reassembleBlob, receiveBlob, resolveBlobManifest, restoreBackup, richtextStatesEqual, richtextToPlainText, serializeBlobManifest, serializeVersionVectorToMeta, serveBlobChunks, singularize, toServerBlobCallbacks, validateStateTransition, validateUpdateStateMachine, verifyAuditExportChecksum, verifyBackupChecksum };
+export { AdapterError, ApplyRemoteOptions, type AuditExportManifest, type AuditExportOptions, type AuditExportPayload, type AuditExportProgress, type AuditTraceQuery, type BackupManifest, type BackupOptions, type BackupProgress, type BlobGcOptions, type BlobGcResult, type BlobManifest, type BlobManifestMetadata, COMPACTION_BASELINE_META_KEY, type ChunkMessage, type ChunkMessagePort, type ChunkProvider, type ChunkRequestMessage, type ChunkResponseMessage, type ClockRebaseResult, type CollectionAccessor, CollectionRecord, type CompactionResult, type CompactionStrategy, ContentAddressedBlobStore, type CreateRichTextControllerOptions, DEFAULT_CHUNK_SIZE, InvalidStateTransitionError, LAST_ACKED_SERVER_VECTOR_META_KEY, LocalMutationHandler, MaterializedRowSnapshot, MemoryBlobStore, NoLeaderError, type OpfsBlobDirectory, OpfsBlobStore, OptimisticLockError, OrderByDirection, type PersistedAuditTrace, PersistenceError, QueryBuilder, QueryDescriptor, QueryError, QueryStore, QueryStoreCache, type ReceiveBlobResult, type ReceiveBlobStores, RecordNotFoundError, type RemoteChunkProvider, type ReplaySnapshot, type RestoreOptions, type RestoreResult, type RichTextAwarenessUser, type RichTextController, type RichTextControllerSnapshot, type RichTextCursorInfo, type RichTextSyncEngine, RowVersionState, SequenceManager, type ServerBlobCallbacks, StorageAdapter, Store, StoreConfig, StoreNotOpenError, SubscriptionBloomFilter, SubscriptionCallback, SubscriptionManager, type SubscriptionManagerOptions, type SubscriptionStats, type TransactionCollectionAccessor, TransactionContext, type TransactionContextConfig, WhereClause, WorkerInitError, WorkerTimeoutError, asRichTextSyncEngine, assertQueryReady, chunkBlob, collectBlobGarbage, collectOperationsAheadOfServer, compactOperationLog, computeAckCompactionWatermark, createChunkPortPair, createMemoryServerBlobStore, createOpfsBlobDirectory, createOpfsBlobStore, createRemoteChunkProvider, createRichTextController, decodeAuditExport, decodeRichtext, deserializeVersionVectorFromMeta, encodeRichtext, exportBackup, extractBlobRefs, fetchBlobManifest, getSharedQueryStoreCache, mergeVersionVectors, parseBlobManifest, persistedAuditTraceFromEvent, pluralize, prepareBlobForSend, putBlobForTransfer, readAuditExportManifest, readBackupManifest, reassembleBlob, receiveBlob, resolveBlobManifest, restoreBackup, richtextStatesEqual, richtextToPlainText, serializeBlobManifest, serializeVersionVectorToMeta, serveBlobChunks, singularize, toServerBlobCallbacks, validateStateTransition, validateUpdateStateMachine, verifyAuditExportChecksum, verifyBackupChecksum };