@syncular/client 0.15.6 → 0.15.8

package/dist/client.js

@@ -18,7 +18,7 @@ import { appendOutboxCommit, deleteOutboxCommit, dropOutboxCommitsInScope, encod
 import { activeFailureRecords, listCommitOutcomes, persistCommitOutcomeResolution, pruneCommitOutcomes, commitOutcome as readCommitOutcome, recordCommitOutcome, } from './outcomes.js';
 import { assertReadOnlyQuery } from './query-guard.js';
 import { compileClientSchema, dropAndRecreateSyncedTables, ensureLocalBookkeepingSchema, ensureLocalSyncedSchema, fromSqlValue, jsonToRowValue, LOCAL_SCHEMA_VERSION_KEY, normalizeRecordKeys, OPTIMISTIC_VERSION, quoteIdent, recordToRowValues, rowValueToJson, SYNC_VERSION_COLUMN, stripSyncColumns, } from './schema.js';
-import { bumpLocalRevision, deleteSubscription, getLocalRevision, getMeta, getSubscription, loadSubscriptions, resetSubscriptionsForBump, saveSubscription, setMeta, } from './state.js';
+import { bumpLocalRevision, deleteSubscription, getLocalRevision, getMeta, getSubscription, loadSubscriptions, pruneUnknownSubscriptions, resetSubscriptionsForBump, saveSubscription, setMeta, } from './state.js';
 import { deletePendingEviction, deleteWindowUnit, deriveSubId, getWindowUnitBySubId, insertWindowUnit, loadPendingEvictions, loadWindowUnits, savePendingEviction, unitScopes, windowBaseKey, } from './window.js';
 /**
  * True iff `unit` is windowed-in AND its bootstrap completed (§4.8 I3):
@@ -178,6 +178,11 @@ export class SyncClient {
         // before the first sync round. A fresh install (no marker) is treated as
         // already at the generated version.
         this.#detectAndResetSchema();
+        // A registration remains app intent only while its table exists in the
+        // running schema. Removed-table registrations would poison every pull.
+        this.#db.transaction(() => {
+            pruneUnknownSubscriptions(this.#db, new Set(this.#schema.tables.keys()));
+        });
         this.#started = true;
         // A persisted active subscription needs one catch-up round on every open:
         // realtime only covers changes after the socket connects, and an

package/dist/state.d.ts

@@ -38,6 +38,13 @@ export declare function deleteSubscription(db: ClientDatabase, id: string): void
  * subscriptions the app still wants. Caller owns the transaction.
  */
 export declare function resetSubscriptionsForBump(db: ClientDatabase): void;
+/**
+ * Remove registrations whose table no longer exists in the running schema.
+ * Keeping one would make every subsequent pull fail with
+ * `sync.unknown_table`. Window bookkeeping belongs to the registration and
+ * is removed with it.
+ */
+export declare function pruneUnknownSubscriptions(db: ClientDatabase, tableNames: ReadonlySet<string>): void;
 export declare function getMeta(db: ClientDatabase, key: string): string | undefined;
 export declare function setMeta(db: ClientDatabase, key: string, value: string): void;
 /** Read the durable client-local observer revision (SPEC §7.5). */

package/dist/state.js

@@ -65,6 +65,25 @@ export function resetSubscriptionsForBump(db) {
        SET cursor = -1, bootstrap_state = NULL, effective_scopes = NULL,
            status = 'active', reason_code = NULL`);
 }
+/**
+ * Remove registrations whose table no longer exists in the running schema.
+ * Keeping one would make every subsequent pull fail with
+ * `sync.unknown_table`. Window bookkeeping belongs to the registration and
+ * is removed with it.
+ */
+export function pruneUnknownSubscriptions(db, tableNames) {
+    const staleIds = db
+        .query('SELECT id, tbl FROM _syncular_subscriptions')
+        .filter((row) => !tableNames.has(String(row.tbl)))
+        .map((row) => String(row.id));
+    for (const id of staleIds) {
+        db.exec('DELETE FROM _syncular_windows WHERE sub_id = ?', [id]);
+        db.exec('DELETE FROM _syncular_window_pending_evict WHERE sub_id = ?', [
+            id,
+        ]);
+        db.exec('DELETE FROM _syncular_subscriptions WHERE id = ?', [id]);
+    }
+}
 export function getMeta(db, key) {
     const row = db.query('SELECT value FROM _syncular_meta WHERE key = ?', [
         key,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syncular/client",
-  "version": "0.15.6",
+  "version": "0.15.8",
   "description": "Syncular TypeScript client core — offline-first sync over SQLite (WASM/OPFS, Bun, Node)",
   "license": "Apache-2.0",
   "author": "Benjamin Kniffler",
@@ -81,7 +81,7 @@
   },
   "dependencies": {
     "@sqlite.org/sqlite-wasm": "^3.53.0-build1",
-    "@syncular/core": "0.15.6"
+    "@syncular/core": "0.15.8"
   },
   "peerDependencies": {
     "better-sqlite3": ">=11"
@@ -92,7 +92,7 @@
     }
   },
   "devDependencies": {
-    "@syncular/server": "0.15.6",
+    "@syncular/server": "0.15.8",
     "@types/better-sqlite3": "^7.6.13",
     "better-sqlite3": "^12.11.1"
   }

package/src/client.ts

@@ -134,6 +134,7 @@ import {
   getMeta,
   getSubscription,
   loadSubscriptions,
+  pruneUnknownSubscriptions,
   resetSubscriptionsForBump,
   type SubscriptionRecord,
   saveSubscription,
@@ -585,6 +586,11 @@ export class SyncClient {
     // before the first sync round. A fresh install (no marker) is treated as
     // already at the generated version.
     this.#detectAndResetSchema();
+    // A registration remains app intent only while its table exists in the
+    // running schema. Removed-table registrations would poison every pull.
+    this.#db.transaction(() => {
+      pruneUnknownSubscriptions(this.#db, new Set(this.#schema.tables.keys()));
+    });
     this.#started = true;
     // A persisted active subscription needs one catch-up round on every open:
     // realtime only covers changes after the socket connects, and an

package/src/state.ts

@@ -115,6 +115,29 @@ export function resetSubscriptionsForBump(db: ClientDatabase): void {
   );
 }
 
+/**
+ * Remove registrations whose table no longer exists in the running schema.
+ * Keeping one would make every subsequent pull fail with
+ * `sync.unknown_table`. Window bookkeeping belongs to the registration and
+ * is removed with it.
+ */
+export function pruneUnknownSubscriptions(
+  db: ClientDatabase,
+  tableNames: ReadonlySet<string>,
+): void {
+  const staleIds = db
+    .query('SELECT id, tbl FROM _syncular_subscriptions')
+    .filter((row) => !tableNames.has(String(row.tbl)))
+    .map((row) => String(row.id));
+  for (const id of staleIds) {
+    db.exec('DELETE FROM _syncular_windows WHERE sub_id = ?', [id]);
+    db.exec('DELETE FROM _syncular_window_pending_evict WHERE sub_id = ?', [
+      id,
+    ]);
+    db.exec('DELETE FROM _syncular_subscriptions WHERE id = ?', [id]);
+  }
+}
+
 export function getMeta(db: ClientDatabase, key: string): string | undefined {
   const row = db.query('SELECT value FROM _syncular_meta WHERE key = ?', [
     key,