@korajs/store 1.0.0-beta.5 → 1.0.0-beta.7

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-D1MzKVmk.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-D1MzKVmk.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-DAo9oduO.cjs';
-export { C as Collection } from './types-DAo9oduO.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';
@@ -820,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).
      */
@@ -1008,6 +1016,7 @@ declare class QueryStore<T = CollectionRecord> {
     private listeners;
     private unsubscribeQuery;
     private active;
+    private hasEmittedSnapshot;
     private readonly queryBuilder;
     constructor(queryBuilder: QueryBuilder<T>);
     /**
@@ -1018,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;

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-D1MzKVmk.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-D1MzKVmk.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-C1kigrWz.js';
-export { C as Collection } from './types-C1kigrWz.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';
@@ -820,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).
      */
@@ -1008,6 +1016,7 @@ declare class QueryStore<T = CollectionRecord> {
     private listeners;
     private unsubscribeQuery;
     private active;
+    private hasEmittedSnapshot;
     private readonly queryBuilder;
     constructor(queryBuilder: QueryBuilder<T>);
     /**
@@ -1018,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;

package/dist/index.js

@@ -1,9 +1,3 @@
-import {
-  exportBackup,
-  readBackupManifest,
-  restoreBackup,
-  verifyBackupChecksum
-} from "./chunk-HS6DBMST.js";
 import {
   decodeAuditExport,
   readAuditExportManifest,
@@ -39,7 +33,24 @@ import {
   serializeRowVersion,
   validateStateTransition,
   validateUpdateStateMachine
-} from "./chunk-RL43UYQZ.js";
+} from "./chunk-YT7MRFCP.js";
+import {
+  AdapterError,
+  NoLeaderError,
+  OptimisticLockError,
+  PersistenceError,
+  QueryError,
+  RecordNotFoundError,
+  StoreNotOpenError,
+  WorkerInitError,
+  WorkerTimeoutError
+} from "./chunk-TUR7RGEP.js";
+import {
+  exportBackup,
+  readBackupManifest,
+  restoreBackup,
+  verifyBackupChecksum
+} from "./chunk-HS6DBMST.js";
 import {
   decodeRichtext,
   decodeRichtextFieldsFromOpData,
@@ -52,17 +63,6 @@ import {
   serializeOperation,
   serializeRecord
 } from "./chunk-GSJ7EEUC.js";
-import {
-  AdapterError,
-  NoLeaderError,
-  OptimisticLockError,
-  PersistenceError,
-  QueryError,
-  RecordNotFoundError,
-  StoreNotOpenError,
-  WorkerInitError,
-  WorkerTimeoutError
-} from "./chunk-TUR7RGEP.js";
 
 // src/compaction/types.ts
 var COMPACTION_BASELINE_META_KEY = "compaction_baseline_at";
@@ -2596,6 +2596,22 @@ var Store = class {
       col.setMutationHandler(handler);
     }
   }
+  /**
+   * 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) {
+    this.ensureOpen();
+    const definition = this.schema.collections[operation.collection];
+    if (!definition) {
+      return;
+    }
+    this.recordOperationSequence(operation);
+    this.subscriptionManager.notify(operation.collection, operation);
+  }
   /**
    * Build mutation context for a collection (used by ApplyPipeline side effects).
    */
@@ -3091,6 +3107,7 @@ var QueryStore = class {
   listeners = /* @__PURE__ */ new Set();
   unsubscribeQuery = null;
   active = false;
+  hasEmittedSnapshot = false;
   queryBuilder;
   constructor(queryBuilder) {
     this.queryBuilder = queryBuilder;
@@ -3116,16 +3133,25 @@ var QueryStore = class {
   getSnapshot = () => {
     return this.snapshot;
   };
+  /**
+   * Whether the underlying query subscription has delivered at least one
+   * authoritative result for the current subscription lifecycle.
+   */
+  hasSnapshot = () => {
+    return this.hasEmittedSnapshot;
+  };
   /** Tear down listeners and the underlying query subscription. */
   destroy() {
     this.stopSubscription();
     this.listeners.clear();
     this.snapshot = EMPTY_ARRAY;
+    this.hasEmittedSnapshot = false;
   }
   startSubscription() {
     this.active = true;
     this.unsubscribeQuery = this.queryBuilder.subscribe((results) => {
       if (!this.active) return;
+      this.hasEmittedSnapshot = true;
       this.snapshot = Object.freeze([...results]);
       this.notifyListeners();
     });