powersync-bridge 0.0.1-alpha.0

package/dist/testing.d.ts

@@ -0,0 +1,118 @@
+import { Q as QueryAdapter, B as BridgeDriver, h as PendingOpRef, d as StreamDescription, a as BridgeClock, u as PreparedQuery, D as DifferentialStream, g as CrudDelta, P as Params, G as StreamHandle, J as SyncStatusView, t as PendingOp, z as RowsBuilder } from './clock-BAt_Za0Q.js';
+
+/**
+ * `powersync-bridge/testing` — a fake driver with VIRTUAL TIME for deterministic interleavings.
+ * Every invariant test (T1–T44) runs on this. Nothing here touches PowerSync.
+ */
+
+type Row = Record<string, unknown> & {
+    id: string;
+};
+declare class VirtualClock implements BridgeClock {
+    private t;
+    private timers;
+    private seq;
+    now(): number;
+    setTimeout(fn: () => void, ms: number): () => void;
+    /** Advance time, firing due timers in order. */
+    advance(ms: number): Promise<void>;
+}
+/** Drain microtasks (the engines do async work after every emission). */
+declare function flush(rounds?: number): Promise<void>;
+interface FakeQuery<T> extends RowsBuilder<T> {
+    readonly __tables: readonly string[];
+    readonly __run: () => T[];
+}
+declare class FakeOrm {
+    readonly driver: FakeDriver;
+    constructor(driver: FakeDriver);
+    /** A query over `tables` computed by `fn`; thenable so TItem infers like a Drizzle builder. */
+    query<T>(tables: readonly string[], fn: (db: FakeDriver) => T[]): FakeQuery<T>;
+    rows<T extends Row = Row>(table: string): T[];
+}
+declare class FakeAdapter implements QueryAdapter {
+    readonly orm: FakeOrm;
+    constructor(driver: FakeDriver);
+    prepare<T>(builder: RowsBuilder<T>): PreparedQuery<T>;
+}
+interface FakeStream {
+    desc: StreamDescription;
+    refs: number;
+    expiresAt: number | null;
+    hasSynced: boolean;
+    lastSyncedAt: number | null;
+    firstSync: {
+        promise: Promise<void>;
+        resolve: () => void;
+    };
+}
+declare class FakeDriver implements BridgeDriver {
+    readonly tables: Map<string, Map<string, Row>>;
+    readonly crud: Map<string, PendingOpRef>;
+    readonly streams: Map<string, FakeStream>;
+    readonly clock: VirtualClock;
+    private connected;
+    private downloading;
+    private hasSynced;
+    private lastSyncedAt;
+    private online;
+    private readonly crudListeners;
+    private readonly statusListeners;
+    private readonly diffSubs;
+    readonly presentIdsCalls: Array<{
+        table: string;
+        ids: readonly string[];
+    }>;
+    readonly subscribeLog: StreamDescription[];
+    streamTtlDefault: number;
+    constructor(clock?: VirtualClock);
+    query<T>(q: PreparedQuery<T>): Promise<T[]>;
+    diffs<T>(q: PreparedQuery<T>): DifferentialStream<T>;
+    pendingUploadIds(): Promise<PendingOpRef[]>;
+    onCrudChange(cb: (delta: CrudDelta) => void): () => void;
+    presentIds(table: string, ids: readonly string[]): Promise<Set<string>>;
+    onlineHint(): boolean | undefined;
+    syncStream(name: string, params: Params | null, opts?: {
+        ttl?: number;
+    }): Promise<StreamHandle>;
+    syncStatus(): SyncStatusView;
+    onStatusChanged(cb: () => void): () => void;
+    /** Open a previously synced DB: hasSynced is PERSISTED (true before any connect). */
+    openWarm(lastSyncedAt: number): void;
+    connect(): void;
+    disconnect(): void;
+    startDownload(): void;
+    /** A checkpoint completes: rows in `apply` land, lastSyncedAt advances, downloading ends unless `keepDownloading`. */
+    completeCheckpoint(apply?: () => void, opts?: {
+        keepDownloading?: boolean;
+        stream?: StreamDescription;
+    }): Promise<void>;
+    /** The service restarted: the SDK resets lastSyncedAt to null. */
+    serviceRestart(): void;
+    /** disconnectAndClear(): tables wiped, hasSynced → false. */
+    clear(): Promise<void>;
+    setOnline(v: boolean | undefined): void;
+    /** Resolve a stream subscription's first sync, landing `apply` rows. */
+    resolveFirstSync(desc: StreamDescription, apply?: () => void): Promise<void>;
+    /** Expire every TTL-pending stream whose expiry has passed and remove its rows (`ownerOf` maps a row to its stream). */
+    expireStreams(ownerOf: (table: string, row: Row) => StreamDescription | undefined): Promise<void>;
+    /** Get-or-create a table map (tests write rows directly through this). */
+    table(name: string): Map<string, Row>;
+    /** Rows arriving via sync (no crud entry). Emits diffs unless `silent`. */
+    synced(table: string, rows: Row[], opts?: {
+        silent?: boolean;
+        delete?: boolean;
+    }): Promise<void>;
+    /** A local write: row applied + crud entry + delta + diffs. */
+    writeLocal(table: string, op: PendingOp, row: Row): Promise<void>;
+    /** Uploads complete: crud drained, completed delta emitted. */
+    completeUploads(filter?: (r: PendingOpRef) => boolean): void;
+    /** Re-run every differential watch and emit changes (what a table change notification does). */
+    emitAll(): Promise<void>;
+    notifyStatus(): void;
+    private emitFor;
+}
+/** Build an unsigned JWT for identity tests. */
+declare function fakeJwt(claims: Record<string, unknown>): string;
+
+export { FakeAdapter, FakeDriver, FakeOrm, type FakeQuery, type Row, VirtualClock, fakeJwt, flush };

package/dist/testing.js

@@ -0,0 +1,354 @@
+import { streamKey, idOf } from './chunk-TANEBEGU.js';
+
+// src/testing.ts
+var VirtualClock = class {
+  t = 1e6;
+  timers = [];
+  seq = 0;
+  now() {
+    return this.t;
+  }
+  setTimeout(fn, ms) {
+    const id = ++this.seq;
+    this.timers.push({ at: this.t + ms, fn, id });
+    return () => {
+      this.timers = this.timers.filter((x) => x.id !== id);
+    };
+  }
+  /** Advance time, firing due timers in order. */
+  async advance(ms) {
+    const target = this.t + ms;
+    for (; ; ) {
+      const due = this.timers.filter((x) => x.at <= target).sort((a, b) => a.at - b.at)[0];
+      if (!due) break;
+      this.timers = this.timers.filter((x) => x.id !== due.id);
+      this.t = due.at;
+      due.fn();
+      await flush();
+    }
+    this.t = target;
+    await flush();
+  }
+};
+async function flush(rounds = 8) {
+  for (let i = 0; i < rounds; i++) await new Promise((r) => setTimeout(r, 0));
+}
+var FakeOrm = class {
+  constructor(driver) {
+    this.driver = driver;
+  }
+  driver;
+  /** A query over `tables` computed by `fn`; thenable so TItem infers like a Drizzle builder. */
+  query(tables, fn) {
+    const driver = this.driver;
+    const q = {
+      __tables: tables,
+      __run: () => fn(driver),
+      then(onFul, onRej) {
+        return Promise.resolve(fn(driver)).then(onFul ?? void 0, onRej ?? void 0);
+      }
+    };
+    return q;
+  }
+  rows(table) {
+    return Array.from(this.driver.tables.get(table)?.values() ?? []);
+  }
+};
+var FakeAdapter = class {
+  orm;
+  constructor(driver) {
+    this.orm = new FakeOrm(driver);
+  }
+  prepare(builder) {
+    const q = builder;
+    return { tables: q.__tables, run: async () => q.__run() };
+  }
+};
+var FakeDriver = class {
+  tables = /* @__PURE__ */ new Map();
+  crud = /* @__PURE__ */ new Map();
+  streams = /* @__PURE__ */ new Map();
+  clock;
+  connected = false;
+  downloading = false;
+  hasSynced = false;
+  lastSyncedAt = null;
+  online = true;
+  crudListeners = /* @__PURE__ */ new Set();
+  statusListeners = /* @__PURE__ */ new Set();
+  diffSubs = /* @__PURE__ */ new Set();
+  presentIdsCalls = [];
+  subscribeLog = [];
+  streamTtlDefault = 864e5;
+  constructor(clock = new VirtualClock()) {
+    this.clock = clock;
+  }
+  // -- BridgeDriver -----------------------------------------------------------
+  async query(q) {
+    return q.run();
+  }
+  diffs(q) {
+    return {
+      subscribe: (onDiff, onError) => {
+        const sub = { q, prev: /* @__PURE__ */ new Map(), onDiff, first: true };
+        this.diffSubs.add(sub);
+        queueMicrotask(() => {
+          if (this.diffSubs.has(sub)) void this.emitFor(sub, onError);
+        });
+        return () => this.diffSubs.delete(sub);
+      }
+    };
+  }
+  async pendingUploadIds() {
+    return Array.from(this.crud.values());
+  }
+  onCrudChange(cb) {
+    this.crudListeners.add(cb);
+    return () => this.crudListeners.delete(cb);
+  }
+  async presentIds(table, ids) {
+    this.presentIdsCalls.push({ table, ids });
+    const t = this.tables.get(table);
+    return new Set(ids.filter((id) => t?.has(id)));
+  }
+  onlineHint() {
+    return this.online;
+  }
+  async syncStream(name, params, opts = {}) {
+    const desc = { name, params };
+    const key = streamKey(desc);
+    this.subscribeLog.push(desc);
+    let s = this.streams.get(key);
+    if (!s) {
+      s = { desc, refs: 0, expiresAt: null, hasSynced: false, lastSyncedAt: null, firstSync: deferred() };
+      this.streams.set(key, s);
+      s.ttl = (opts.ttl ?? this.streamTtlDefault / 1e3) * 1e3;
+    }
+    s.refs += 1;
+    s.expiresAt = null;
+    const stream = s;
+    let done = false;
+    return {
+      name,
+      params,
+      waitForFirstSync: (signal) => new Promise((resolve, reject) => {
+        stream.firstSync.promise.then(resolve);
+        signal?.addEventListener("abort", () => reject(signal.reason ?? new Error("aborted")), { once: true });
+      }),
+      unsubscribe: () => {
+        if (done) return;
+        done = true;
+        stream.refs -= 1;
+        if (stream.refs <= 0) stream.expiresAt = this.clock.now() + (stream.ttl ?? this.streamTtlDefault);
+        this.notifyStatus();
+      }
+    };
+  }
+  syncStatus() {
+    const now = this.clock.now();
+    const syncStreams = [];
+    for (const s of this.streams.values()) {
+      if (s.expiresAt !== null && now >= s.expiresAt) continue;
+      syncStreams.push({
+        name: s.desc.name,
+        params: s.desc.params,
+        active: s.refs > 0,
+        expiresAt: s.expiresAt === null ? null : new Date(s.expiresAt),
+        hasSynced: s.hasSynced,
+        lastSyncedAt: s.lastSyncedAt === null ? null : new Date(s.lastSyncedAt)
+      });
+    }
+    const self = this;
+    return {
+      connected: this.connected,
+      downloading: this.downloading,
+      hasSynced: this.hasSynced,
+      lastSyncedAt: this.lastSyncedAt === null ? null : new Date(this.lastSyncedAt),
+      syncStreams,
+      forStream(desc) {
+        return syncStreams.find((x) => streamKey(x) === streamKey(desc));
+      },
+      statusForPriority() {
+        return { hasSynced: self.hasSynced === true, lastSyncedAt: self.lastSyncedAt === null ? null : new Date(self.lastSyncedAt) };
+      }
+    };
+  }
+  onStatusChanged(cb) {
+    this.statusListeners.add(cb);
+    return () => this.statusListeners.delete(cb);
+  }
+  // -- Test helpers: sync side -----------------------------------------------
+  /** Open a previously synced DB: hasSynced is PERSISTED (true before any connect). */
+  openWarm(lastSyncedAt) {
+    this.hasSynced = true;
+    this.lastSyncedAt = lastSyncedAt;
+  }
+  connect() {
+    this.connected = true;
+    this.notifyStatus();
+  }
+  disconnect() {
+    this.connected = false;
+    this.notifyStatus();
+  }
+  startDownload() {
+    this.downloading = true;
+    this.notifyStatus();
+  }
+  /** A checkpoint completes: rows in `apply` land, lastSyncedAt advances, downloading ends unless `keepDownloading`. */
+  async completeCheckpoint(apply = () => {
+  }, opts = {}) {
+    apply();
+    this.lastSyncedAt = this.clock.now();
+    this.hasSynced = true;
+    this.downloading = opts.keepDownloading ?? false;
+    if (opts.stream) {
+      const s = this.streams.get(streamKey(opts.stream));
+      if (s) {
+        s.hasSynced = true;
+        s.lastSyncedAt = this.clock.now();
+      }
+    }
+    this.notifyStatus();
+    await this.emitAll();
+  }
+  /** The service restarted: the SDK resets lastSyncedAt to null. */
+  serviceRestart() {
+    this.lastSyncedAt = null;
+    this.notifyStatus();
+  }
+  /** disconnectAndClear(): tables wiped, hasSynced → false. */
+  async clear() {
+    this.tables.clear();
+    this.crud.clear();
+    this.hasSynced = false;
+    this.lastSyncedAt = null;
+    this.connected = false;
+    this.notifyStatus();
+    await this.emitAll();
+  }
+  setOnline(v) {
+    this.online = v;
+  }
+  /** Resolve a stream subscription's first sync, landing `apply` rows. */
+  async resolveFirstSync(desc, apply = () => {
+  }) {
+    const s = this.streams.get(streamKey(desc));
+    if (!s) throw new Error(`no subscription for ${streamKey(desc)}`);
+    apply();
+    s.hasSynced = true;
+    s.lastSyncedAt = this.clock.now();
+    s.firstSync.resolve();
+    this.notifyStatus();
+    await this.emitAll();
+  }
+  /** Expire every TTL-pending stream whose expiry has passed and remove its rows (`ownerOf` maps a row to its stream). */
+  async expireStreams(ownerOf) {
+    const now = this.clock.now();
+    for (const [key, s] of this.streams) {
+      if (s.expiresAt !== null && now >= s.expiresAt) {
+        for (const [table, rows] of this.tables) {
+          for (const [id, row] of rows) {
+            const owner = ownerOf(table, row);
+            if (owner && streamKey(owner) === key) rows.delete(id);
+          }
+        }
+        this.streams.delete(key);
+      }
+    }
+    this.notifyStatus();
+    await this.emitAll();
+  }
+  // -- Test helpers: data side ----------------------------------------------
+  /** Get-or-create a table map (tests write rows directly through this). */
+  table(name) {
+    let t = this.tables.get(name);
+    if (!t) {
+      t = /* @__PURE__ */ new Map();
+      this.tables.set(name, t);
+    }
+    return t;
+  }
+  /** Rows arriving via sync (no crud entry). Emits diffs unless `silent`. */
+  async synced(table, rows, opts = {}) {
+    const t = this.table(table);
+    for (const r of rows) {
+      if (opts.delete) t.delete(r.id);
+      else t.set(r.id, { ...r });
+    }
+    if (!opts.silent) await this.emitAll();
+  }
+  /** A local write: row applied + crud entry + delta + diffs. */
+  async writeLocal(table, op, row) {
+    const t = this.table(table);
+    if (op === "DELETE") t.delete(row.id);
+    else t.set(row.id, { ...t.get(row.id) ?? {}, ...row });
+    const ref = { table, id: row.id, op };
+    this.crud.set(`${table}\0${row.id}`, ref);
+    for (const l of this.crudListeners) l({ added: [ref], completed: [] });
+    await this.emitAll();
+  }
+  /** Uploads complete: crud drained, completed delta emitted. */
+  completeUploads(filter) {
+    const completed = [];
+    for (const [k, r] of this.crud) {
+      if (!filter || filter(r)) {
+        this.crud.delete(k);
+        completed.push(r);
+      }
+    }
+    if (completed.length) for (const l of this.crudListeners) l({ added: [], completed });
+  }
+  /** Re-run every differential watch and emit changes (what a table change notification does). */
+  async emitAll() {
+    for (const sub of Array.from(this.diffSubs)) await this.emitFor(sub);
+    await flush(2);
+  }
+  notifyStatus() {
+    for (const l of Array.from(this.statusListeners)) l();
+  }
+  async emitFor(sub, onError) {
+    let rows;
+    try {
+      rows = await sub.q.run();
+    } catch (e) {
+      onError?.(e instanceof Error ? e : new Error(String(e)));
+      return;
+    }
+    const next = /* @__PURE__ */ new Map();
+    const byId = /* @__PURE__ */ new Map();
+    for (const r of rows) {
+      const id = idOf(r);
+      next.set(id, JSON.stringify(r));
+      byId.set(id, r);
+    }
+    const added = [];
+    const updated = [];
+    const removed = [];
+    for (const [id, json] of next) {
+      const p = sub.prev.get(id);
+      if (p === void 0) added.push(byId.get(id));
+      else if (p !== json) updated.push(byId.get(id));
+    }
+    for (const id of sub.prev.keys()) if (!next.has(id)) removed.push(id);
+    const changed = sub.first || added.length || updated.length || removed.length;
+    sub.prev = next;
+    sub.first = false;
+    if (changed) sub.onDiff({ all: rows, added, updated, removed });
+  }
+};
+function deferred() {
+  let resolve;
+  const promise = new Promise((r) => {
+    resolve = r;
+  });
+  return { promise, resolve };
+}
+function fakeJwt(claims) {
+  const enc = (o) => Buffer.from(JSON.stringify(o)).toString("base64url");
+  return `${enc({ alg: "none" })}.${enc(claims)}.sig`;
+}
+
+export { FakeAdapter, FakeDriver, FakeOrm, VirtualClock, fakeJwt, flush };
+//# sourceMappingURL=testing.js.map
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/testing.ts"],"names":[],"mappings":"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","file":"testing.js","sourcesContent":["/**\n * `powersync-bridge/testing` — a fake driver with VIRTUAL TIME for deterministic interleavings.\n * Every invariant test (T1–T44) runs on this. Nothing here touches PowerSync.\n */\nimport type { BridgeClock } from './clock';\nimport { streamKey } from './freshness';\nimport { idOf } from './keyset';\nimport type {\n  BridgeDriver,\n  CrudDelta,\n  DifferentialStream,\n  Params,\n  PendingOp,\n  PendingOpRef,\n  PreparedQuery,\n  PriorityStatus,\n  QueryAdapter,\n  RowDiff,\n  RowsBuilder,\n  StreamDescription,\n  StreamHandle,\n  StreamStatus,\n  SyncStatusView,\n} from './types';\n\nexport type Row = Record<string, unknown> & { id: string };\n\n// ---------------------------------------------------------------------------\n// Virtual clock\n// ---------------------------------------------------------------------------\n\nexport class VirtualClock implements BridgeClock {\n  private t = 1_000_000;\n  private timers: Array<{ at: number; fn: () => void; id: number }> = [];\n  private seq = 0;\n\n  now(): number {\n    return this.t;\n  }\n\n  setTimeout(fn: () => void, ms: number): () => void {\n    const id = ++this.seq;\n    this.timers.push({ at: this.t + ms, fn, id });\n    return () => {\n      this.timers = this.timers.filter((x) => x.id !== id);\n    };\n  }\n\n  /** Advance time, firing due timers in order. */\n  async advance(ms: number): Promise<void> {\n    const target = this.t + ms;\n    for (;;) {\n      const due = this.timers.filter((x) => x.at <= target).sort((a, b) => a.at - b.at)[0];\n      if (!due) break;\n      this.timers = this.timers.filter((x) => x.id !== due.id);\n      this.t = due.at;\n      due.fn();\n      await flush();\n    }\n    this.t = target;\n    await flush();\n  }\n}\n\n/** Drain microtasks (the engines do async work after every emission). */\nexport async function flush(rounds = 8): Promise<void> {\n  for (let i = 0; i < rounds; i++) await new Promise<void>((r) => setTimeout(r, 0));\n}\n\n// ---------------------------------------------------------------------------\n// Fake ORM: queries are functions over in-memory tables\n// ---------------------------------------------------------------------------\n\nexport interface FakeQuery<T> extends RowsBuilder<T> {\n  readonly __tables: readonly string[];\n  readonly __run: () => T[];\n}\n\nexport class FakeOrm {\n  constructor(readonly driver: FakeDriver) {}\n\n  /** A query over `tables` computed by `fn`; thenable so TItem infers like a Drizzle builder. */\n  query<T>(tables: readonly string[], fn: (db: FakeDriver) => T[]): FakeQuery<T> {\n    const driver = this.driver;\n    const q = {\n      __tables: tables,\n      __run: () => fn(driver),\n      then<R1 = T[], R2 = never>(onFul?: ((v: T[]) => R1 | PromiseLike<R1>) | null, onRej?: ((e: unknown) => R2 | PromiseLike<R2>) | null): PromiseLike<R1 | R2> {\n        return Promise.resolve(fn(driver)).then(onFul ?? undefined, onRej ?? undefined);\n      },\n    };\n    return q as FakeQuery<T>;\n  }\n\n  rows<T extends Row = Row>(table: string): T[] {\n    return Array.from(this.driver.tables.get(table)?.values() ?? []) as T[];\n  }\n}\n\nexport class FakeAdapter implements QueryAdapter {\n  readonly orm: FakeOrm;\n  constructor(driver: FakeDriver) {\n    this.orm = new FakeOrm(driver);\n  }\n  prepare<T>(builder: RowsBuilder<T>): PreparedQuery<T> {\n    const q = builder as FakeQuery<T>;\n    return { tables: q.__tables, run: async () => q.__run() };\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Fake driver\n// ---------------------------------------------------------------------------\n\ninterface FakeStream {\n  desc: StreamDescription;\n  refs: number;\n  expiresAt: number | null;\n  hasSynced: boolean;\n  lastSyncedAt: number | null;\n  firstSync: { promise: Promise<void>; resolve: () => void };\n}\n\ninterface DiffSub<T> {\n  q: PreparedQuery<T>;\n  prev: Map<string, string>;\n  onDiff: (d: RowDiff<T>) => void;\n  first: boolean;\n}\n\nexport class FakeDriver implements BridgeDriver {\n  readonly tables = new Map<string, Map<string, Row>>();\n  readonly crud = new Map<string, PendingOpRef>();\n  readonly streams = new Map<string, FakeStream>();\n  readonly clock: VirtualClock;\n\n  private connected = false;\n  private downloading = false;\n  private hasSynced: boolean | undefined = false;\n  private lastSyncedAt: number | null = null;\n  private online: boolean | undefined = true;\n  private readonly crudListeners = new Set<(d: CrudDelta) => void>();\n  private readonly statusListeners = new Set<() => void>();\n  private readonly diffSubs = new Set<DiffSub<unknown>>();\n  readonly presentIdsCalls: Array<{ table: string; ids: readonly string[] }> = [];\n  readonly subscribeLog: StreamDescription[] = [];\n  streamTtlDefault = 86_400_000;\n\n  constructor(clock = new VirtualClock()) {\n    this.clock = clock;\n  }\n\n  // -- BridgeDriver -----------------------------------------------------------\n\n  async query<T>(q: PreparedQuery<T>): Promise<T[]> {\n    return q.run();\n  }\n\n  diffs<T>(q: PreparedQuery<T>): DifferentialStream<T> {\n    return {\n      subscribe: (onDiff, onError) => {\n        const sub: DiffSub<T> = { q, prev: new Map(), onDiff, first: true };\n        this.diffSubs.add(sub as DiffSub<unknown>);\n        queueMicrotask(() => {\n          if (this.diffSubs.has(sub as DiffSub<unknown>)) void this.emitFor(sub, onError);\n        });\n        return () => this.diffSubs.delete(sub as DiffSub<unknown>);\n      },\n    };\n  }\n\n  async pendingUploadIds(): Promise<PendingOpRef[]> {\n    return Array.from(this.crud.values());\n  }\n\n  onCrudChange(cb: (delta: CrudDelta) => void): () => void {\n    this.crudListeners.add(cb);\n    return () => this.crudListeners.delete(cb);\n  }\n\n  async presentIds(table: string, ids: readonly string[]): Promise<Set<string>> {\n    this.presentIdsCalls.push({ table, ids });\n    const t = this.tables.get(table);\n    return new Set(ids.filter((id) => t?.has(id)));\n  }\n\n  onlineHint(): boolean | undefined {\n    return this.online;\n  }\n\n  async syncStream(name: string, params: Params | null, opts: { ttl?: number } = {}): Promise<StreamHandle> {\n    const desc = { name, params };\n    const key = streamKey(desc);\n    this.subscribeLog.push(desc);\n    let s = this.streams.get(key);\n    if (!s) {\n      s = { desc, refs: 0, expiresAt: null, hasSynced: false, lastSyncedAt: null, firstSync: deferred() };\n      this.streams.set(key, s);\n      (s as FakeStream & { ttl?: number }).ttl = (opts.ttl ?? this.streamTtlDefault / 1000) * 1000; // first TTL wins\n    }\n    s.refs += 1;\n    s.expiresAt = null;\n    const stream = s;\n    let done = false;\n    return {\n      name,\n      params,\n      waitForFirstSync: (signal?: AbortSignal) =>\n        new Promise<void>((resolve, reject) => {\n          stream.firstSync.promise.then(resolve);\n          signal?.addEventListener('abort', () => reject(signal.reason ?? new Error('aborted')), { once: true });\n        }),\n      unsubscribe: () => {\n        if (done) return;\n        done = true;\n        stream.refs -= 1;\n        if (stream.refs <= 0) stream.expiresAt = this.clock.now() + ((stream as FakeStream & { ttl?: number }).ttl ?? this.streamTtlDefault);\n        this.notifyStatus();\n      },\n    };\n  }\n\n  syncStatus(): SyncStatusView {\n    const now = this.clock.now();\n    const syncStreams: StreamStatus[] = [];\n    for (const s of this.streams.values()) {\n      if (s.expiresAt !== null && now >= s.expiresAt) continue; // expired: no longer tracked\n      syncStreams.push({\n        name: s.desc.name,\n        params: s.desc.params,\n        active: s.refs > 0,\n        expiresAt: s.expiresAt === null ? null : new Date(s.expiresAt),\n        hasSynced: s.hasSynced,\n        lastSyncedAt: s.lastSyncedAt === null ? null : new Date(s.lastSyncedAt),\n      });\n    }\n    const self = this;\n    return {\n      connected: this.connected,\n      downloading: this.downloading,\n      hasSynced: this.hasSynced,\n      lastSyncedAt: this.lastSyncedAt === null ? null : new Date(this.lastSyncedAt),\n      syncStreams,\n      forStream(desc) {\n        return syncStreams.find((x) => streamKey(x) === streamKey(desc));\n      },\n      statusForPriority(): PriorityStatus {\n        return { hasSynced: self.hasSynced === true, lastSyncedAt: self.lastSyncedAt === null ? null : new Date(self.lastSyncedAt) };\n      },\n    };\n  }\n\n  onStatusChanged(cb: () => void): () => void {\n    this.statusListeners.add(cb);\n    return () => this.statusListeners.delete(cb);\n  }\n\n  // -- Test helpers: sync side -----------------------------------------------\n\n  /** Open a previously synced DB: hasSynced is PERSISTED (true before any connect). */\n  openWarm(lastSyncedAt: number): void {\n    this.hasSynced = true;\n    this.lastSyncedAt = lastSyncedAt;\n  }\n\n  connect(): void {\n    this.connected = true;\n    this.notifyStatus();\n  }\n\n  disconnect(): void {\n    this.connected = false;\n    this.notifyStatus();\n  }\n\n  startDownload(): void {\n    this.downloading = true;\n    this.notifyStatus();\n  }\n\n  /** A checkpoint completes: rows in `apply` land, lastSyncedAt advances, downloading ends unless `keepDownloading`. */\n  async completeCheckpoint(apply: () => void = () => {}, opts: { keepDownloading?: boolean; stream?: StreamDescription } = {}): Promise<void> {\n    apply();\n    this.lastSyncedAt = this.clock.now();\n    this.hasSynced = true;\n    this.downloading = opts.keepDownloading ?? false;\n    if (opts.stream) {\n      const s = this.streams.get(streamKey(opts.stream));\n      if (s) {\n        s.hasSynced = true;\n        s.lastSyncedAt = this.clock.now();\n      }\n    }\n    this.notifyStatus();\n    await this.emitAll();\n  }\n\n  /** The service restarted: the SDK resets lastSyncedAt to null. */\n  serviceRestart(): void {\n    this.lastSyncedAt = null;\n    this.notifyStatus();\n  }\n\n  /** disconnectAndClear(): tables wiped, hasSynced → false. */\n  async clear(): Promise<void> {\n    this.tables.clear();\n    this.crud.clear();\n    this.hasSynced = false;\n    this.lastSyncedAt = null;\n    this.connected = false;\n    this.notifyStatus();\n    await this.emitAll();\n  }\n\n  setOnline(v: boolean | undefined): void {\n    this.online = v;\n  }\n\n  /** Resolve a stream subscription's first sync, landing `apply` rows. */\n  async resolveFirstSync(desc: StreamDescription, apply: () => void = () => {}): Promise<void> {\n    const s = this.streams.get(streamKey(desc));\n    if (!s) throw new Error(`no subscription for ${streamKey(desc)}`);\n    apply();\n    s.hasSynced = true;\n    s.lastSyncedAt = this.clock.now();\n    s.firstSync.resolve();\n    this.notifyStatus();\n    await this.emitAll();\n  }\n\n  /** Expire every TTL-pending stream whose expiry has passed and remove its rows (`ownerOf` maps a row to its stream). */\n  async expireStreams(ownerOf: (table: string, row: Row) => StreamDescription | undefined): Promise<void> {\n    const now = this.clock.now();\n    for (const [key, s] of this.streams) {\n      if (s.expiresAt !== null && now >= s.expiresAt) {\n        for (const [table, rows] of this.tables) {\n          for (const [id, row] of rows) {\n            const owner = ownerOf(table, row);\n            if (owner && streamKey(owner) === key) rows.delete(id);\n          }\n        }\n        this.streams.delete(key);\n      }\n    }\n    this.notifyStatus();\n    await this.emitAll();\n  }\n\n  // -- Test helpers: data side ----------------------------------------------\n\n  /** Get-or-create a table map (tests write rows directly through this). */\n  table(name: string): Map<string, Row> {\n    let t = this.tables.get(name);\n    if (!t) {\n      t = new Map();\n      this.tables.set(name, t);\n    }\n    return t;\n  }\n\n  /** Rows arriving via sync (no crud entry). Emits diffs unless `silent`. */\n  async synced(table: string, rows: Row[], opts: { silent?: boolean; delete?: boolean } = {}): Promise<void> {\n    const t = this.table(table);\n    for (const r of rows) {\n      if (opts.delete) t.delete(r.id);\n      else t.set(r.id, { ...r });\n    }\n    if (!opts.silent) await this.emitAll();\n  }\n\n  /** A local write: row applied + crud entry + delta + diffs. */\n  async writeLocal(table: string, op: PendingOp, row: Row): Promise<void> {\n    const t = this.table(table);\n    if (op === 'DELETE') t.delete(row.id);\n    else t.set(row.id, { ...(t.get(row.id) ?? {}), ...row });\n    const ref: PendingOpRef = { table, id: row.id, op };\n    this.crud.set(`${table}\\u0000${row.id}`, ref);\n    for (const l of this.crudListeners) l({ added: [ref], completed: [] });\n    await this.emitAll();\n  }\n\n  /** Uploads complete: crud drained, completed delta emitted. */\n  completeUploads(filter?: (r: PendingOpRef) => boolean): void {\n    const completed: PendingOpRef[] = [];\n    for (const [k, r] of this.crud) {\n      if (!filter || filter(r)) {\n        this.crud.delete(k);\n        completed.push(r);\n      }\n    }\n    if (completed.length) for (const l of this.crudListeners) l({ added: [], completed });\n  }\n\n  /** Re-run every differential watch and emit changes (what a table change notification does). */\n  async emitAll(): Promise<void> {\n    for (const sub of Array.from(this.diffSubs)) await this.emitFor(sub);\n    await flush(2);\n  }\n\n  notifyStatus(): void {\n    for (const l of Array.from(this.statusListeners)) l();\n  }\n\n  private async emitFor<T>(sub: DiffSub<T>, onError?: (e: Error) => void): Promise<void> {\n    let rows: T[];\n    try {\n      rows = await sub.q.run();\n    } catch (e) {\n      onError?.(e instanceof Error ? e : new Error(String(e)));\n      return;\n    }\n    const next = new Map<string, string>();\n    const byId = new Map<string, T>();\n    for (const r of rows) {\n      const id = idOf(r);\n      next.set(id, JSON.stringify(r));\n      byId.set(id, r);\n    }\n    const added: T[] = [];\n    const updated: T[] = [];\n    const removed: string[] = [];\n    for (const [id, json] of next) {\n      const p = sub.prev.get(id);\n      if (p === undefined) added.push(byId.get(id) as T);\n      else if (p !== json) updated.push(byId.get(id) as T);\n    }\n    for (const id of sub.prev.keys()) if (!next.has(id)) removed.push(id);\n    const changed = sub.first || added.length || updated.length || removed.length;\n    sub.prev = next;\n    sub.first = false;\n    if (changed) sub.onDiff({ all: rows, added, updated, removed });\n  }\n}\n\nfunction deferred(): { promise: Promise<void>; resolve: () => void } {\n  let resolve!: () => void;\n  const promise = new Promise<void>((r) => {\n    resolve = r;\n  });\n  return { promise, resolve };\n}\n\n/** Build an unsigned JWT for identity tests. */\nexport function fakeJwt(claims: Record<string, unknown>): string {\n  const enc = (o: unknown) => Buffer.from(JSON.stringify(o)).toString('base64url');\n  return `${enc({ alg: 'none' })}.${enc(claims)}.sig`;\n}\n"]}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "powersync-bridge",
+  "version": "0.0.1-alpha.0",
+  "description": "Client-side bridge between a PowerSync local SQLite database and a conventional HTTP API: raced first paint, pending-write-aware reconcile, bounded partition escalation.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/akpor-kofi/powersync-bridge.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/akpor-kofi/powersync-bridge#readme",
+  "bugs": {
+    "url": "https://github.com/akpor-kofi/powersync-bridge/issues"
+  },
+  "keywords": [
+    "powersync",
+    "offline-first",
+    "local-first",
+    "sqlite",
+    "sync"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "import": "./dist/testing.js",
+      "require": "./dist/testing.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit"
+  }
+}