powersync-bridge 0.0.1-alpha.1 → 0.0.1-alpha.2

package/dist/index.d.cts

@@ -30,7 +30,6 @@ declare class FreshnessTracker {
     private lastHasSynced;
     private readonly streamFreshAt;
     private readonly streamSeenSyncedAt;
-    private readonly completions;
     private readonly completionListeners;
     private readonly clearListeners;
     private unsubscribe;
@@ -108,8 +107,20 @@ declare class CrudMirror {
     onChange(l: () => void): () => void;
 }
 
+/** Checkpoint maintenance has one shared slot; first reads and pagination bypass it. */
+declare class BackgroundReads {
+    private running;
+    private readonly queue;
+    run<T>(read: () => Promise<T>, signal: AbortSignal): Promise<T>;
+    private drain;
+}
+
 /** Minimal TanStack QueryClient surface the bridge relies on (R11: fetchQuery + keying only). */
 interface MinimalQueryClient {
+    cancelQueries?(filters: {
+        queryKey: readonly unknown[];
+        exact: boolean;
+    }): Promise<unknown>;
     fetchQuery<T>(opts: {
         queryKey: readonly unknown[];
         queryFn: (ctx: {
@@ -171,6 +182,7 @@ interface RacedDeps {
     readonly identityKey: string | null;
     readonly apiLegEnabled: boolean;
     readonly measure: MeasureSink | undefined;
+    readonly backgroundReads?: BackgroundReads;
 }
 declare function emptyRacedResult<T>(): RacedListResult<T>;
 /**
@@ -184,7 +196,10 @@ declare class RacedListStore<TItem, TScope, TApi, K extends OrderKey<TItem>> {
     readonly store: SnapshotStore<RacedListResult<TItem>>;
     private readonly compare;
     private readonly table;
-    private readonly abort;
+    private abort;
+    private observation;
+    private readonly checkpointRefresh;
+    private localFreshAt;
     private readonly startedAt;
     private snap;
     private snapPending;
@@ -203,18 +218,21 @@ declare class RacedListStore<TItem, TScope, TApi, K extends OrderKey<TItem>> {
     private readonly tombstones;
     private disposed;
     private refs;
+    private activeRefs;
     private measured;
     private localMs;
     private apiMs;
     constructor(deps: RacedDeps, def: RacedListDefinition<TItem, TScope, TApi, K>, scope: TScope, scopeKey: string);
-    retain(): void;
-    release(): void;
+    retain(active?: boolean): void;
+    release(active?: boolean): void;
     get isDisposed(): boolean;
     /** Synchronous part of an identity swap: the snapshot becomes empty 'pending' at once (R15). */
     swapRoot(): void;
     dispose(): void;
+    private pause;
     private start;
     private startApiLeg;
+    private snapshotKey;
     /**
      * A checkpoint completed. Status events and diff emissions are separate SDK events with no
      * ordering guarantee; taking ownership on the stale local map would render the pre-checkpoint
@@ -319,6 +337,9 @@ declare class InfiniteQueryStore<T extends {
     private watchGeneration;
     private lastLocalWatch;
     private refs;
+    private activeRefs;
+    private readonly checkpointRefresh;
+    private localAbort;
     private ready;
     private disposed;
     private unwatch;
@@ -327,10 +348,11 @@ declare class InfiniteQueryStore<T extends {
     private requestKey;
     constructor(deps: QueryDeps, options: InfiniteQueryOptions<T>);
     get isDisposed(): boolean;
-    retain(): void;
-    release(): void;
+    retain(active?: boolean): void;
+    release(active?: boolean): void;
     swapRoot(): void;
     dispose(): void;
+    private pause;
     private readOffline;
     private cancelRequest;
     private networkChanged;
@@ -557,6 +579,7 @@ declare class Bridge {
     private readonly freshness;
     private readonly crud;
     private readonly snapshots;
+    private readonly backgroundReads;
     private readonly epochSnapshot;
     private readonly stores;
     private readonly gates;

package/dist/index.d.ts

@@ -30,7 +30,6 @@ declare class FreshnessTracker {
     private lastHasSynced;
     private readonly streamFreshAt;
     private readonly streamSeenSyncedAt;
-    private readonly completions;
     private readonly completionListeners;
     private readonly clearListeners;
     private unsubscribe;
@@ -108,8 +107,20 @@ declare class CrudMirror {
     onChange(l: () => void): () => void;
 }
 
+/** Checkpoint maintenance has one shared slot; first reads and pagination bypass it. */
+declare class BackgroundReads {
+    private running;
+    private readonly queue;
+    run<T>(read: () => Promise<T>, signal: AbortSignal): Promise<T>;
+    private drain;
+}
+
 /** Minimal TanStack QueryClient surface the bridge relies on (R11: fetchQuery + keying only). */
 interface MinimalQueryClient {
+    cancelQueries?(filters: {
+        queryKey: readonly unknown[];
+        exact: boolean;
+    }): Promise<unknown>;
     fetchQuery<T>(opts: {
         queryKey: readonly unknown[];
         queryFn: (ctx: {
@@ -171,6 +182,7 @@ interface RacedDeps {
     readonly identityKey: string | null;
     readonly apiLegEnabled: boolean;
     readonly measure: MeasureSink | undefined;
+    readonly backgroundReads?: BackgroundReads;
 }
 declare function emptyRacedResult<T>(): RacedListResult<T>;
 /**
@@ -184,7 +196,10 @@ declare class RacedListStore<TItem, TScope, TApi, K extends OrderKey<TItem>> {
     readonly store: SnapshotStore<RacedListResult<TItem>>;
     private readonly compare;
     private readonly table;
-    private readonly abort;
+    private abort;
+    private observation;
+    private readonly checkpointRefresh;
+    private localFreshAt;
     private readonly startedAt;
     private snap;
     private snapPending;
@@ -203,18 +218,21 @@ declare class RacedListStore<TItem, TScope, TApi, K extends OrderKey<TItem>> {
     private readonly tombstones;
     private disposed;
     private refs;
+    private activeRefs;
     private measured;
     private localMs;
     private apiMs;
     constructor(deps: RacedDeps, def: RacedListDefinition<TItem, TScope, TApi, K>, scope: TScope, scopeKey: string);
-    retain(): void;
-    release(): void;
+    retain(active?: boolean): void;
+    release(active?: boolean): void;
     get isDisposed(): boolean;
     /** Synchronous part of an identity swap: the snapshot becomes empty 'pending' at once (R15). */
     swapRoot(): void;
     dispose(): void;
+    private pause;
     private start;
     private startApiLeg;
+    private snapshotKey;
     /**
      * A checkpoint completed. Status events and diff emissions are separate SDK events with no
      * ordering guarantee; taking ownership on the stale local map would render the pre-checkpoint
@@ -319,6 +337,9 @@ declare class InfiniteQueryStore<T extends {
     private watchGeneration;
     private lastLocalWatch;
     private refs;
+    private activeRefs;
+    private readonly checkpointRefresh;
+    private localAbort;
     private ready;
     private disposed;
     private unwatch;
@@ -327,10 +348,11 @@ declare class InfiniteQueryStore<T extends {
     private requestKey;
     constructor(deps: QueryDeps, options: InfiniteQueryOptions<T>);
     get isDisposed(): boolean;
-    retain(): void;
-    release(): void;
+    retain(active?: boolean): void;
+    release(active?: boolean): void;
     swapRoot(): void;
     dispose(): void;
+    private pause;
     private readOffline;
     private cancelRequest;
     private networkChanged;
@@ -557,6 +579,7 @@ declare class Bridge {
     private readonly freshness;
     private readonly crud;
     private readonly snapshots;
+    private readonly backgroundReads;
     private readonly epochSnapshot;
     private readonly stores;
     private readonly gates;