@syncular/client 0.30.12 → 0.30.14

package/src/window.ts

@@ -1,3 +1,5 @@
+export const PENDING_EVICTIONS = '_syncular_window_pending_evict';
+export const WINDOWS_TABLE = '_syncular_windows';
 /**
  * Windowed subscriptions (SPEC.md §4.8).
  *
@@ -151,7 +153,7 @@ export function loadWindowUnits(
 ): WindowUnit[] {
   return db
     .query(
-      'SELECT unit, sub_id FROM _syncular_windows WHERE base = ? ORDER BY unit ASC',
+      `SELECT unit,sub_id FROM ${WINDOWS_TABLE} WHERE base=? ORDER BY unit`,
       [baseKey],
     )
     .map((row) => ({ unit: row.unit as string, subId: row.sub_id as string }));
@@ -163,7 +165,7 @@ export function getWindowUnitBySubId(
   subId: string,
 ): RegisteredWindowUnit | undefined {
   const row = db.query(
-    `SELECT base, unit, sub_id FROM _syncular_windows
+    `SELECT base, unit, sub_id FROM ${WINDOWS_TABLE}
       WHERE sub_id = ? LIMIT 1`,
     [subId],
   )[0];
@@ -183,7 +185,7 @@ export function insertWindowUnit(
   subId: string,
 ): void {
   db.exec(
-    'INSERT OR REPLACE INTO _syncular_windows(base, unit, sub_id) VALUES (?, ?, ?)',
+    `INSERT OR REPLACE INTO ${WINDOWS_TABLE}(base,unit,sub_id)VALUES(?,?,?)`,
     [baseKey, unit, subId],
   );
 }
@@ -193,7 +195,7 @@ export function deleteWindowUnit(
   baseKey: string,
   unit: string,
 ): void {
-  db.exec('DELETE FROM _syncular_windows WHERE base = ? AND unit = ?', [
+  db.exec(`DELETE FROM ${WINDOWS_TABLE} WHERE base=? AND unit=?`, [
     baseKey,
     unit,
   ]);
@@ -206,10 +208,10 @@ export function isUnitLive(
   unit: string,
 ): boolean {
   return (
-    db.query(
-      'SELECT 1 FROM _syncular_windows WHERE base = ? AND unit = ? LIMIT 1',
-      [baseKey, unit],
-    ).length > 0
+    db.query(`SELECT 1 FROM ${WINDOWS_TABLE} WHERE base=? AND unit=? LIMIT 1`, [
+      baseKey,
+      unit,
+    ]).length > 0
   );
 }
 
@@ -230,23 +232,19 @@ export function savePendingEviction(
   effective: ScopeMap,
 ): void {
   db.exec(
-    `INSERT OR REPLACE INTO _syncular_window_pending_evict(sub_id, tbl, effective_scopes)
+    `INSERT OR REPLACE INTO ${PENDING_EVICTIONS}(sub_id, tbl, effective_scopes)
        VALUES (?, ?, ?)`,
     [subId, table, JSON.stringify(effective)],
   );
 }
 
 export function deletePendingEviction(db: ClientDatabase, subId: string): void {
-  db.exec('DELETE FROM _syncular_window_pending_evict WHERE sub_id = ?', [
-    subId,
-  ]);
+  db.exec(`DELETE FROM ${PENDING_EVICTIONS} WHERE sub_id = ?`, [subId]);
 }
 
 export function loadPendingEvictions(db: ClientDatabase): PendingEviction[] {
   return db
-    .query(
-      'SELECT sub_id, tbl, effective_scopes FROM _syncular_window_pending_evict',
-    )
+    .query(`SELECT sub_id, tbl, effective_scopes FROM ${PENDING_EVICTIONS}`)
     .map((row) => ({
       subId: row.sub_id as string,
       table: row.tbl as string,

package/src/worker-entry.ts

@@ -165,6 +165,7 @@ export function startSyncWorker(overrides: SyncWorkerOverrides = {}): void {
     if (
       closed ||
       client === undefined ||
+      offline ||
       client.securityLifecycle() === 'preflight'
     ) {
       return;
@@ -189,6 +190,7 @@ export function startSyncWorker(overrides: SyncWorkerOverrides = {}): void {
       !autoSync ||
       closed ||
       client === undefined ||
+      offline ||
       client.securityLifecycle() === 'preflight' ||
       intent.kind === 'none'
     ) {
@@ -235,41 +237,6 @@ export function startSyncWorker(overrides: SyncWorkerOverrides = {}): void {
     return client;
   }
 
-  function assertOnline(): void {
-    if (offline) {
-      throw new ClientSyncError(
-        'sync.transport_failed',
-        'the worker transport is offline (setOffline(true))',
-        true,
-      );
-    }
-  }
-
-  function gateOffline<T>(inner: (request: T) => Promise<Uint8Array>) {
-    return (request: T): Promise<Uint8Array> => {
-      assertOnline();
-      return inner(request);
-    };
-  }
-
-  /** Offline gate that preserves the §5.4 `fetchUrl` capability marker. */
-  function gateSegmentsOffline(inner: SegmentDownloader): SegmentDownloader {
-    const fetchUrl = inner.fetchUrl;
-    return Object.assign(gateOffline(inner), {
-      ...(fetchUrl !== undefined
-        ? {
-            fetchUrl: (
-              url: string,
-              onProgress?: (bytesReceived: number) => void,
-            ) => {
-              assertOnline();
-              return fetchUrl(url, onProgress);
-            },
-          }
-        : {}),
-    });
-  }
-
   async function init(config: WorkerInitConfig): Promise<WorkerInitResult> {
     if (client !== undefined) {
       throw new ClientSyncError(
@@ -308,11 +275,10 @@ export function startSyncWorker(overrides: SyncWorkerOverrides = {}): void {
         }
       }
     }
-    const transport = gateOffline(
+    const transport =
       overrides.createTransport !== undefined
         ? overrides.createTransport(config)
-        : httpSyncTransport(config.endpoints.syncUrl, http),
-    );
+        : httpSyncTransport(config.endpoints.syncUrl, http);
     const segments =
       overrides.createSegments !== undefined
         ? overrides.createSegments(config)
@@ -329,22 +295,15 @@ export function startSyncWorker(overrides: SyncWorkerOverrides = {}): void {
     // `{clientId}` URL placeholder — start the client first, then attach
     // the connector through a mutable slot read at connect time.
     let realtimeConnector: RealtimeConnector | undefined;
+    offline = config.transportEnabled === false;
     const started = new SyncClient({
+      transportEnabled: !offline,
       database,
       schema: config.schema,
       transport,
-      ...(segments !== undefined
-        ? { segments: gateSegmentsOffline(segments) }
-        : {}),
+      ...(segments !== undefined ? { segments } : {}),
       ...(blobs !== undefined ? { blobs } : {}),
       realtime: (handlers) => {
-        if (offline) {
-          throw new ClientSyncError(
-            'sync.transport_failed',
-            'the worker realtime channel is offline (setOffline(true))',
-            true,
-          );
-        }
         if (realtimeConnector === undefined) {
           throw new ClientSyncError(
             'sync.invalid_request',
@@ -515,8 +474,12 @@ export function startSyncWorker(overrides: SyncWorkerOverrides = {}): void {
     },
     setOffline: (value) => {
       offline = value;
-      if (offline) client?.disconnectRealtime();
-      else if (client !== undefined) {
+      requireClient().setTransportEnabled(!value);
+      if (offline) {
+        if (backgroundTimer !== undefined) clearTimeout(backgroundTimer);
+        backgroundTimer = undefined;
+        backgroundDue = Number.POSITIVE_INFINITY;
+      } else if (client !== undefined) {
         const snapshot = client.diagnosticsSnapshot();
         post({
           t: 'event',

package/src/worker-host.ts

@@ -194,6 +194,7 @@ export interface SyncClientHandleConfig {
   readonly encryption?: EncryptionKeyringConfig;
   /** Open the worker-owned replica behind the fail-closed security gate. */
   readonly securityPreflight?: boolean;
+  readonly transportEnabled?: boolean;
   readonly clientId?: string;
   readonly limits?: SyncClientLimits;
   readonly retainFailedCommits?: boolean;
@@ -947,6 +948,9 @@ function buildInitConfig(
     ...(config.encryption !== undefined
       ? { encryption: config.encryption }
       : {}),
+    ...(config.transportEnabled !== undefined
+      ? { transportEnabled: config.transportEnabled }
+      : {}),
     ...(config.securityPreflight !== undefined
       ? { securityPreflight: config.securityPreflight }
       : {}),

package/src/worker-protocol.ts

@@ -112,6 +112,7 @@ export interface WorkerInitConfig {
   readonly encryption?: EncryptionKeyringConfig;
   /** Open the worker-owned replica behind the fail-closed security gate. */
   readonly securityPreflight?: boolean;
+  readonly transportEnabled?: boolean;
   readonly clientId?: string;
   readonly limits?: SyncClientLimits;
   readonly retainFailedCommits?: boolean;