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

package/dist/index.d.cts

@@ -397,6 +397,8 @@ declare class SubscriptionManager {
      * Schedules a microtask flush to batch multiple mutations in the same tick.
      */
     notify(collection: string, _operation: Operation): void;
+    /** Invalidate a collection after a local-view change that has no domain operation. */
+    invalidate(collection: string): void;
     /**
      * Immediately flush all pending notifications.
      * Useful for testing. In production, flushing happens via microtask.
@@ -766,6 +768,17 @@ declare class Store implements OperationLog {
      * and updates the version vector.
      */
     applyRemoteOperation(op: Operation, options?: ApplyRemoteOptions): Promise<ApplyResult>;
+    /**
+     * Hide a record from this client's authorized materialized view. This writes no
+     * replicated operation and therefore cannot be mistaken for a domain deletion.
+     * The marker lets a later authoritative backfill reactivate the retained row.
+     */
+    applyScopeRetraction(collection: string, recordId: string): Promise<void>;
+    /** Hide all live rows that no longer match a newly accepted server scope. */
+    applyScopeNarrowing(scopes: Record<string, Record<string, unknown>>): Promise<Array<{
+        collection: string;
+        recordId: string;
+    }>>;
     /**
      * Materialize update/delete operations that were logged for a record BEFORE
      * its insert arrived (reordered delivery). Runs inside the insert's write

package/dist/index.d.ts

@@ -397,6 +397,8 @@ declare class SubscriptionManager {
      * Schedules a microtask flush to batch multiple mutations in the same tick.
      */
     notify(collection: string, _operation: Operation): void;
+    /** Invalidate a collection after a local-view change that has no domain operation. */
+    invalidate(collection: string): void;
     /**
      * Immediately flush all pending notifications.
      * Useful for testing. In production, flushing happens via microtask.
@@ -766,6 +768,17 @@ declare class Store implements OperationLog {
      * and updates the version vector.
      */
     applyRemoteOperation(op: Operation, options?: ApplyRemoteOptions): Promise<ApplyResult>;
+    /**
+     * Hide a record from this client's authorized materialized view. This writes no
+     * replicated operation and therefore cannot be mistaken for a domain deletion.
+     * The marker lets a later authoritative backfill reactivate the retained row.
+     */
+    applyScopeRetraction(collection: string, recordId: string): Promise<void>;
+    /** Hide all live rows that no longer match a newly accepted server scope. */
+    applyScopeNarrowing(scopes: Record<string, Record<string, unknown>>): Promise<Array<{
+        collection: string;
+        recordId: string;
+    }>>;
     /**
      * Materialize update/delete operations that were logged for a record BEFORE
      * its insert arrived (reordered delivery). Runs inside the insert's write

package/dist/index.js

@@ -1350,6 +1350,10 @@ var SubscriptionManager = class {
    * Schedules a microtask flush to batch multiple mutations in the same tick.
    */
   notify(collection, _operation) {
+    this.invalidate(collection);
+  }
+  /** Invalidate a collection after a local-view change that has no domain operation. */
+  invalidate(collection) {
     this.pendingCollections.add(collection);
     this.scheduleFlush();
   }
@@ -2097,6 +2101,9 @@ var Store = class {
    */
   async open() {
     await this.adapter.open(this.schema);
+    await this.adapter.execute(
+      "CREATE TABLE IF NOT EXISTS _kora_scope_retractions (collection TEXT NOT NULL, record_id TEXT NOT NULL, PRIMARY KEY (collection, record_id))"
+    );
     await this.runMigrationsIfNeeded();
     this.nodeId = await this.loadOrGenerateNodeId();
     this.clock = new HybridLogicalClock3(this.nodeId);
@@ -2216,6 +2223,22 @@ var Store = class {
       [op.id]
     );
     if (existing.length > 0) {
+      const retracted = await this.adapter.query(
+        "SELECT record_id FROM _kora_scope_retractions WHERE collection = ? AND record_id = ?",
+        [collection, op.recordId]
+      );
+      if (retracted.length > 0) {
+        await this.adapter.transaction(async (tx) => {
+          await tx.execute(`UPDATE ${quoteIdent7(collection)} SET _deleted = 0 WHERE id = ?`, [
+            op.recordId
+          ]);
+          await tx.execute(
+            "DELETE FROM _kora_scope_retractions WHERE collection = ? AND record_id = ?",
+            [collection, op.recordId]
+          );
+        });
+        this.subscriptionManager.invalidate(collection);
+      }
       return "duplicate";
     }
     if (this.clock) {
@@ -2401,6 +2424,49 @@ var Store = class {
     this.subscriptionManager.notify(collection, op);
     return "applied";
   }
+  /**
+   * Hide a record from this client's authorized materialized view. This writes no
+   * replicated operation and therefore cannot be mistaken for a domain deletion.
+   * The marker lets a later authoritative backfill reactivate the retained row.
+   */
+  async applyScopeRetraction(collection, recordId) {
+    this.ensureOpen();
+    if (!this.schema.collections[collection]) return;
+    await this.adapter.transaction(async (tx) => {
+      await tx.execute(`UPDATE ${quoteIdent7(collection)} SET _deleted = 1 WHERE id = ?`, [recordId]);
+      await tx.execute(
+        "INSERT OR REPLACE INTO _kora_scope_retractions (collection, record_id) VALUES (?, ?)",
+        [collection, recordId]
+      );
+    });
+    this.subscriptionManager.invalidate(collection);
+  }
+  /** Hide all live rows that no longer match a newly accepted server scope. */
+  async applyScopeNarrowing(scopes) {
+    this.ensureOpen();
+    const retractions = [];
+    for (const [collection, definition] of Object.entries(this.schema.collections)) {
+      const rows = await this.adapter.query(
+        `SELECT * FROM ${quoteIdent7(collection)} WHERE _deleted = 0`
+      );
+      const predicate = scopes[collection];
+      for (const row of rows) {
+        const record = deserializeRecord(row, definition.fields);
+        const matches = predicate !== void 0 && Object.entries(predicate).every(([field, expected]) => {
+          if (expected && typeof expected === "object" && !Array.isArray(expected) && "$in" in expected) {
+            const values = expected.$in;
+            return Array.isArray(values) && values.some((value) => Object.is(record[field], value));
+          }
+          return Object.is(record[field], expected);
+        });
+        if (!matches) {
+          await this.applyScopeRetraction(collection, String(record.id));
+          retractions.push({ collection, recordId: String(record.id) });
+        }
+      }
+    }
+    return retractions;
+  }
   /**
    * Materialize update/delete operations that were logged for a record BEFORE
    * its insert arrived (reordered delivery). Runs inside the insert's write