@syncular/relay 0.0.1-60

package/dist/client-role/pull-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull-engine.js","sourceRoot":"","sources":["../../src/client-role/pull-engine.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAe,GAAG,EAAE,MAAM,QAAQ,CAAC;AAyB1C;;GAEG;AACH,MAAM,OAAO,UAAU;IACJ,EAAE,CAAa;IACf,OAAO,CAAoB;IAC3B,SAAS,CAAgB;IACzB,QAAQ,CAAS;IACjB,MAAM,CAAW;IACjB,MAAM,CAAc;IACpB,MAAM,CAAoB;IAC1B,cAAc,CAAqB;IACnC,QAAQ,CAAgB;IACxB,UAAU,CAAS;IACnB,OAAO,CAA0B;IACjC,cAAc,CAAuB;IAE9C,OAAO,GAAG,KAAK,CAAC;IAChB,KAAK,GAAyC,IAAI,CAAC;IACnD,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE5C,YAAY,OAA8B,EAAE;QAC1C,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;QAC7C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,KAAK,CAAC;QAC9C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAAA,CAC9C;IAED;;OAEG;IACH,KAAK,GAAS;QACZ,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YAC5B,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAAA,CACtB,CAAC,CAAC;IAAA,CACJ;IAED;;OAEG;IACH,IAAI,GAAS;QACX,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;IAAA,CACF;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,GAAqB;QACjC,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC;IAAA,CAC1B;IAEO,KAAK,CAAC,WAAW,GAAkB;QACzC,IAAI,CAAC;YACH,2BAA2B;YAC3B,MAAM,SAAS,GAAG,MAAM,GAAG,CAAwB;;eAE1C,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC;;;OAGjC,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACnB,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAE9B,IAAI,GAAG,EAAE,UAAU,EAAE,CAAC;gBACpB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;gBAC1C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;oBAClD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;wBAClD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;4BAC9B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;wBAC/B,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,8BAA8B;QAChC,CAAC;IAAA,CACF;IAEO,KAAK,CAAC,WAAW,GAAkB;QACzC,MAAM,SAAS,GAA2B,EAAE,CAAC;QAC7C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACxC,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACzB,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAC5C,MAAM,GAAG,CAAA;oBACO,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC;gCACb,SAAS;;mCAEN,SAAS;KACvC,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAAA,CACpB;IAEO,YAAY,CAAC,OAAe,EAAQ;QAC1C,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO;QAEvB,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,IAAI,EAAE,CAAC;YAClC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YAElB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;gBACvC,gDAAgD;gBAChD,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;gBAC/C,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;YAC/B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBACpE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACrC,CAAC;QAAA,CACF,EAAE,OAAO,CAAC,CAAC;IAAA,CACb;IAEO,KAAK,CAAC,UAAU,GAAqB;QAC3C,qCAAqC;QACrC,MAAM,oBAAoB,GAA8B,IAAI,CAAC,MAAM,CAAC,GAAG,CACrE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACV,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;SACtC,CAAC,CACH,CAAC;QAEF,IAAI,QAA0B,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;gBACzC,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,IAAI,EAAE;oBACJ,aAAa,EAAE,oBAAoB;oBACnC,YAAY,EAAE,GAAG;iBAClB;aACF,CAAC,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACnB,OAAO,KAAK,CAAC;YACf,CAAC;YACD,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,6BAA6B;YAC7B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,UAAU,GAAG,KAAK,CAAC;QACvB,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;QAEzC,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,aAAa,EAAE,CAAC;YACzC,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ;gBAAE,SAAS;YAEtC,MAAM,KAAK,GAAG,GAAG,CAAC,EAAE,CAAC;YAErB,kBAAkB;YAClB,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;gBACjC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;gBAC7D,IAAI,OAAO,EAAE,CAAC;oBACZ,UAAU,GAAG,IAAI,CAAC;oBAClB,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBAC5B,CAAC;YACH,CAAC;YAED,gBAAgB;YAChB,IAAI,GAAG,CAAC,UAAU,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;gBACrD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;QAED,uBAAuB;QACvB,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAEzB,0CAA0C;QAC1C,IAAI,UAAU,IAAI,cAAc,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YAC1C,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC/D,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,SAAS,CAAC,CAAC;QACvE,CAAC;QAED,mDAAmD;QACnD,MAAM,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;QAE9B,OAAO,UAAU,CAAC;IAAA,CACnB;IAED;;;;;OAKG;IACK,KAAK,CAAC,kBAAkB,CAC9B,MAAkB,EAClB,KAAa,EACK;QAClB,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAE9C,gCAAgC;QAChC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACjD,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,OAAO,EAAE,MAAM,CAAC,QAA0C;SAC3D,CAAC,CAAC,CAAC;QAEJ,sDAAsD;QACtD,MAAM,aAAa,GAAG,QAAQ,MAAM,CAAC,SAAS,IAAI,KAAK,EAAE,CAAC;QAE1D,6BAA6B;QAC7B,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC;YAC9B,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,OAAO,EAAE;gBACP,QAAQ,EAAE,SAAS,IAAI,CAAC,QAAQ,EAAE;gBAClC,cAAc,EAAE,aAAa;gBAC7B,UAAU;gBACV,aAAa,EAAE,CAAC;aACjB;SACF,CAAC,CAAC;QAEH,IACE,MAAM,CAAC,QAAQ,CAAC,EAAE,KAAK,IAAI;YAC3B,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,SAAS;YACpC,OAAO,MAAM,CAAC,QAAQ,CAAC,SAAS,KAAK,QAAQ,EAC7C,CAAC;YACD,0BAA0B;YAC1B,MAAM,IAAI,CAAC,cAAc,CAAC,sBAAsB,CAC9C,MAAM,CAAC,QAAQ,CAAC,SAAS,EACzB,MAAM,CAAC,SAAS,CACjB,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;QAED,yCAAyC;QACzC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACxC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,uDAAuD;QACvD,qBAAqB;QACrB,OAAO,CAAC,IAAI,CACV,iCAAiC,MAAM,CAAC,SAAS,WAAW,EAC5D,MAAM,CAAC,QAAQ,CAChB,CAAC;QACF,OAAO,KAAK,CAAC;IAAA,CACd;CACF"}

package/dist/client-role/sequence-mapper.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @syncular/relay - Sequence Mapper
+ *
+ * Tracks the mapping between relay's local commit_seq
+ * and the main server's global commit_seq.
+ */
+import { type Kysely } from 'kysely';
+import type { RelayDatabase, RelaySequenceMapStatus } from '../schema';
+/**
+ * Sequence mapping entry.
+ */
+export interface SequenceMapping {
+    localCommitSeq: number;
+    mainCommitSeq: number | null;
+    status: RelaySequenceMapStatus;
+}
+/**
+ * Sequence mapper for tracking local to main commit sequence mappings.
+ */
+export declare class SequenceMapper<DB extends RelayDatabase = RelayDatabase> {
+    private readonly db;
+    constructor(options: {
+        db: Kysely<DB>;
+    });
+    /**
+     * Create a pending mapping for a local commit that will be forwarded.
+     */
+    createPendingMapping(localCommitSeq: number): Promise<void>;
+    /**
+     * Mark a mapping as forwarded with the main server's commit_seq.
+     */
+    markForwarded(localCommitSeq: number, mainCommitSeq: number): Promise<void>;
+    /**
+     * Mark a mapping as confirmed (main server acknowledged).
+     */
+    markConfirmed(localCommitSeq: number): Promise<void>;
+    /**
+     * Get the mapping for a local commit sequence.
+     */
+    getMapping(localCommitSeq: number): Promise<SequenceMapping | null>;
+    /**
+     * Get the local commit sequence for a main server commit sequence.
+     */
+    getLocalCommitSeq(mainCommitSeq: number): Promise<number | null>;
+    /**
+     * Get all pending mappings (commits not yet forwarded).
+     */
+    getPendingMappings(): Promise<SequenceMapping[]>;
+    /**
+     * Create a mapping for commits pulled from main (assigned new local commit_seq).
+     *
+     * These mappings go directly to 'confirmed' status since they came from main.
+     */
+    createConfirmedMapping(localCommitSeq: number, mainCommitSeq: number): Promise<void>;
+    /**
+     * Delete confirmed/forwarded sequence mappings older than the given age.
+     * Keeps pending mappings (they haven't been forwarded yet).
+     */
+    pruneOldMappings(maxAgeMs: number): Promise<number>;
+    /**
+     * Get the highest main_commit_seq we've seen (for tracking pull cursor).
+     */
+    getHighestMainCommitSeq(): Promise<number>;
+}
+//# sourceMappingURL=sequence-mapper.d.ts.map

package/dist/client-role/sequence-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence-mapper.d.ts","sourceRoot":"","sources":["../../src/client-role/sequence-mapper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,MAAM,EAAO,MAAM,QAAQ,CAAC;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,sBAAsB,CAAC;CAChC;AAED;;GAEG;AACH,qBAAa,cAAc,CAAC,EAAE,SAAS,aAAa,GAAG,aAAa;IAClE,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAa;IAEhC,YAAY,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAA;KAAE,EAEtC;IAED;;OAEG;IACG,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAahE;IAED;;OAEG;IACG,aAAa,CACjB,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CAUf;IAED;;OAEG;IACG,aAAa,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOzD;IAED;;OAEG;IACG,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAoBxE;IAED;;OAEG;IACG,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CASrE;IAED;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAkBrD;IAED;;;;OAIG;IACG,sBAAsB,CAC1B,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CAuBf;IAED;;;OAGG;IACG,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CASxD;IAED;;OAEG;IACG,uBAAuB,IAAI,OAAO,CAAC,MAAM,CAAC,CAS/C;CACF"}

package/dist/client-role/sequence-mapper.js

@@ -0,0 +1,161 @@
+/**
+ * @syncular/relay - Sequence Mapper
+ *
+ * Tracks the mapping between relay's local commit_seq
+ * and the main server's global commit_seq.
+ */
+import { sql } from 'kysely';
+/**
+ * Sequence mapper for tracking local to main commit sequence mappings.
+ */
+export class SequenceMapper {
+    db;
+    constructor(options) {
+        this.db = options.db;
+    }
+    /**
+     * Create a pending mapping for a local commit that will be forwarded.
+     */
+    async createPendingMapping(localCommitSeq) {
+        const now = Date.now();
+        await sql `
+      insert into ${sql.table('relay_sequence_map')} (
+        local_commit_seq,
+        main_commit_seq,
+        status,
+        created_at,
+        updated_at
+      )
+      values (${localCommitSeq}, ${null}, 'pending', ${now}, ${now})
+      on conflict (local_commit_seq) do nothing
+    `.execute(this.db);
+    }
+    /**
+     * Mark a mapping as forwarded with the main server's commit_seq.
+     */
+    async markForwarded(localCommitSeq, mainCommitSeq) {
+        const now = Date.now();
+        await sql `
+      update ${sql.table('relay_sequence_map')}
+      set
+        main_commit_seq = ${mainCommitSeq},
+        status = 'forwarded',
+        updated_at = ${now}
+      where local_commit_seq = ${localCommitSeq}
+    `.execute(this.db);
+    }
+    /**
+     * Mark a mapping as confirmed (main server acknowledged).
+     */
+    async markConfirmed(localCommitSeq) {
+        const now = Date.now();
+        await sql `
+      update ${sql.table('relay_sequence_map')}
+      set status = 'confirmed', updated_at = ${now}
+      where local_commit_seq = ${localCommitSeq}
+    `.execute(this.db);
+    }
+    /**
+     * Get the mapping for a local commit sequence.
+     */
+    async getMapping(localCommitSeq) {
+        const rowResult = await sql `
+      select local_commit_seq, main_commit_seq, status
+      from ${sql.table('relay_sequence_map')}
+      where local_commit_seq = ${localCommitSeq}
+      limit 1
+    `.execute(this.db);
+        const row = rowResult.rows[0];
+        if (!row)
+            return null;
+        return {
+            localCommitSeq: row.local_commit_seq,
+            mainCommitSeq: row.main_commit_seq,
+            status: row.status,
+        };
+    }
+    /**
+     * Get the local commit sequence for a main server commit sequence.
+     */
+    async getLocalCommitSeq(mainCommitSeq) {
+        const rowResult = await sql `
+      select local_commit_seq
+      from ${sql.table('relay_sequence_map')}
+      where main_commit_seq = ${mainCommitSeq}
+      limit 1
+    `.execute(this.db);
+        return rowResult.rows[0]?.local_commit_seq ?? null;
+    }
+    /**
+     * Get all pending mappings (commits not yet forwarded).
+     */
+    async getPendingMappings() {
+        const rowsResult = await sql `
+      select local_commit_seq, main_commit_seq, status
+      from ${sql.table('relay_sequence_map')}
+      where status = 'pending'
+      order by local_commit_seq asc
+    `.execute(this.db);
+        const rows = rowsResult.rows;
+        return rows.map((row) => ({
+            localCommitSeq: row.local_commit_seq,
+            mainCommitSeq: row.main_commit_seq,
+            status: row.status,
+        }));
+    }
+    /**
+     * Create a mapping for commits pulled from main (assigned new local commit_seq).
+     *
+     * These mappings go directly to 'confirmed' status since they came from main.
+     */
+    async createConfirmedMapping(localCommitSeq, mainCommitSeq) {
+        const now = Date.now();
+        await sql `
+      insert into ${sql.table('relay_sequence_map')} (
+        local_commit_seq,
+        main_commit_seq,
+        status,
+        created_at,
+        updated_at
+      )
+      values (
+        ${localCommitSeq},
+        ${mainCommitSeq},
+        'confirmed',
+        ${now},
+        ${now}
+      )
+      on conflict (local_commit_seq)
+      do update set
+        main_commit_seq = ${mainCommitSeq},
+        status = 'confirmed',
+        updated_at = ${now}
+    `.execute(this.db);
+    }
+    /**
+     * Delete confirmed/forwarded sequence mappings older than the given age.
+     * Keeps pending mappings (they haven't been forwarded yet).
+     */
+    async pruneOldMappings(maxAgeMs) {
+        const threshold = Date.now() - maxAgeMs;
+        const result = await sql `
+      delete from ${sql.table('relay_sequence_map')}
+      where status in ('confirmed', 'forwarded')
+      and updated_at < ${threshold}
+    `.execute(this.db);
+        return Number(result.numAffectedRows ?? 0);
+    }
+    /**
+     * Get the highest main_commit_seq we've seen (for tracking pull cursor).
+     */
+    async getHighestMainCommitSeq() {
+        const rowResult = await sql `
+      select max(main_commit_seq) as max_seq
+      from ${sql.table('relay_sequence_map')}
+      where main_commit_seq is not null
+      limit 1
+    `.execute(this.db);
+        return rowResult.rows[0]?.max_seq ?? 0;
+    }
+}
+//# sourceMappingURL=sequence-mapper.js.map

package/dist/client-role/sequence-mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence-mapper.js","sourceRoot":"","sources":["../../src/client-role/sequence-mapper.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @syncular/relay - Edge Relay Server
+ *
+ * An edge relay server that acts as a local server to nearby clients
+ * while simultaneously acting as a client to the main server.
+ *
+ * @example
+ * ```typescript
+ * import { createRelayServer } from '@syncular/relay';
+ * import { createSqliteServerDialect } from '@syncular/server-dialect-sqlite';
+ *
+ * const relay = createRelayServer({
+ *   db: sqliteDb,
+ *   dialect: createSqliteServerDialect(),
+ *   mainServerTransport: createHttpTransport({ baseUrl: 'https://main.example.com/sync' }),
+ *   mainServerClientId: 'relay-branch-001',
+ *   mainServerActorId: 'relay-service',
+ *   scopeKeys: ['client:acme'],
+ *   shapes: shapeRegistry,
+ *   subscriptions: subscriptionRegistry,
+ * });
+ *
+ * // Mount routes for local clients
+ * app.route('/sync', relay.getRoutes());
+ *
+ * // Start background sync with main
+ * await relay.start();
+ * ```
+ */
+export * from './client-role';
+export * from './migrate';
+export * from './mode-manager';
+export * from './realtime';
+export * from './relay';
+export * from './schema';
+export * from './server-role';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,cAAc,eAAe,CAAC;AAG9B,cAAc,WAAW,CAAC;AAG1B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,YAAY,CAAC;AAG3B,cAAc,SAAS,CAAC;AAGxB,cAAc,UAAU,CAAC;AAGzB,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,44 @@
+/**
+ * @syncular/relay - Edge Relay Server
+ *
+ * An edge relay server that acts as a local server to nearby clients
+ * while simultaneously acting as a client to the main server.
+ *
+ * @example
+ * ```typescript
+ * import { createRelayServer } from '@syncular/relay';
+ * import { createSqliteServerDialect } from '@syncular/server-dialect-sqlite';
+ *
+ * const relay = createRelayServer({
+ *   db: sqliteDb,
+ *   dialect: createSqliteServerDialect(),
+ *   mainServerTransport: createHttpTransport({ baseUrl: 'https://main.example.com/sync' }),
+ *   mainServerClientId: 'relay-branch-001',
+ *   mainServerActorId: 'relay-service',
+ *   scopeKeys: ['client:acme'],
+ *   shapes: shapeRegistry,
+ *   subscriptions: subscriptionRegistry,
+ * });
+ *
+ * // Mount routes for local clients
+ * app.route('/sync', relay.getRoutes());
+ *
+ * // Start background sync with main
+ * await relay.start();
+ * ```
+ */
+// Client role (syncing with main server)
+export * from './client-role';
+// Migration
+export * from './migrate';
+// Mode manager
+export * from './mode-manager';
+// Realtime WebSocket manager
+export * from './realtime';
+// Main exports
+export * from './relay';
+// Schema types
+export * from './schema';
+// Server role (serving local clients)
+export * from './server-role';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,yCAAyC;AACzC,cAAc,eAAe,CAAC;AAE9B,YAAY;AACZ,cAAc,WAAW,CAAC;AAE1B,eAAe;AACf,cAAc,gBAAgB,CAAC;AAE/B,6BAA6B;AAC7B,cAAc,YAAY,CAAC;AAE3B,eAAe;AACf,cAAc,SAAS,CAAC;AAExB,eAAe;AACf,cAAc,UAAU,CAAC;AAEzB,sCAAsC;AACtC,cAAc,eAAe,CAAC"}

package/dist/migrate.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @syncular/relay - Schema setup
+ *
+ * Creates relay-specific tables for edge relay functionality.
+ * Uses Kysely for dialect-agnostic schema creation.
+ */
+import type { ServerSyncDialect } from '@syncular/server';
+import type { Kysely } from 'kysely';
+import type { RelayDatabase } from './schema';
+/**
+ * Ensures the relay schema exists in the database.
+ * Safe to call multiple times (idempotent).
+ *
+ * This creates relay-specific tables on top of the base sync schema.
+ * Call `ensureSyncSchema()` from @syncular/server first to create base tables.
+ */
+export declare function ensureRelaySchema<DB extends RelayDatabase = RelayDatabase>(db: Kysely<DB>, dialect: ServerSyncDialect): Promise<void>;
+//# sourceMappingURL=migrate.d.ts.map

package/dist/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../src/migrate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,EAAE,SAAS,aAAa,GAAG,aAAa,EACxC,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2F3D"}

package/dist/migrate.js

@@ -0,0 +1,99 @@
+/**
+ * @syncular/relay - Schema setup
+ *
+ * Creates relay-specific tables for edge relay functionality.
+ * Uses Kysely for dialect-agnostic schema creation.
+ */
+import { sql } from 'kysely';
+/**
+ * Ensures the relay schema exists in the database.
+ * Safe to call multiple times (idempotent).
+ *
+ * This creates relay-specific tables on top of the base sync schema.
+ * Call `ensureSyncSchema()` from @syncular/server first to create base tables.
+ */
+export async function ensureRelaySchema(db, dialect) {
+    // Ensure base sync schema exists first
+    await dialect.ensureSyncSchema(db);
+    // Create relay-specific tables
+    const isSqlite = dialect.name === 'sqlite';
+    // Forward outbox table
+    await sql
+        .raw(`
+    CREATE TABLE IF NOT EXISTS relay_forward_outbox (
+      id TEXT PRIMARY KEY,
+      local_commit_seq INTEGER NOT NULL,
+      client_id TEXT NOT NULL,
+      client_commit_id TEXT NOT NULL,
+      operations_json TEXT NOT NULL,
+      schema_version INTEGER NOT NULL DEFAULT 1,
+      status TEXT NOT NULL DEFAULT 'pending',
+      main_commit_seq INTEGER,
+      error TEXT,
+      last_response_json TEXT,
+      created_at INTEGER NOT NULL DEFAULT (${isSqlite ? "strftime('%s','now') * 1000" : 'EXTRACT(EPOCH FROM NOW()) * 1000'}),
+      updated_at INTEGER NOT NULL DEFAULT (${isSqlite ? "strftime('%s','now') * 1000" : 'EXTRACT(EPOCH FROM NOW()) * 1000'}),
+      attempt_count INTEGER NOT NULL DEFAULT 0
+    )
+  `)
+        .execute(db);
+    // Index for finding next sendable outbox entry
+    await sql
+        .raw(`
+    CREATE INDEX IF NOT EXISTS idx_relay_forward_outbox_status
+    ON relay_forward_outbox (status, created_at)
+  `)
+        .execute(db);
+    // Sequence map table
+    await sql
+        .raw(`
+    CREATE TABLE IF NOT EXISTS relay_sequence_map (
+      local_commit_seq INTEGER PRIMARY KEY,
+      main_commit_seq INTEGER,
+      status TEXT NOT NULL DEFAULT 'pending',
+      created_at INTEGER NOT NULL DEFAULT (${isSqlite ? "strftime('%s','now') * 1000" : 'EXTRACT(EPOCH FROM NOW()) * 1000'}),
+      updated_at INTEGER NOT NULL DEFAULT (${isSqlite ? "strftime('%s','now') * 1000" : 'EXTRACT(EPOCH FROM NOW()) * 1000'})
+    )
+  `)
+        .execute(db);
+    // Index for looking up main_commit_seq
+    await sql
+        .raw(`
+    CREATE INDEX IF NOT EXISTS idx_relay_sequence_map_main
+    ON relay_sequence_map (main_commit_seq)
+    WHERE main_commit_seq IS NOT NULL
+  `)
+        .execute(db);
+    // Forward conflicts table
+    await sql
+        .raw(`
+    CREATE TABLE IF NOT EXISTS relay_forward_conflicts (
+      id TEXT PRIMARY KEY,
+      local_commit_seq INTEGER NOT NULL,
+      client_id TEXT NOT NULL,
+      client_commit_id TEXT NOT NULL,
+      response_json TEXT NOT NULL,
+      created_at INTEGER NOT NULL,
+      resolved_at INTEGER
+    )
+  `)
+        .execute(db);
+    // Index for finding unresolved conflicts
+    await sql
+        .raw(`
+    CREATE INDEX IF NOT EXISTS idx_relay_forward_conflicts_unresolved
+    ON relay_forward_conflicts (resolved_at)
+    WHERE resolved_at IS NULL
+  `)
+        .execute(db);
+    // Config table
+    await sql
+        .raw(`
+    CREATE TABLE IF NOT EXISTS relay_config (
+      key TEXT PRIMARY KEY,
+      value_json TEXT NOT NULL
+    )
+  `)
+        .execute(db);
+}
+//# sourceMappingURL=migrate.js.map

package/dist/migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../src/migrate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAG7B;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAErC,EAAc,EAAE,OAA0B,EAAiB;IAC3D,uCAAuC;IACvC,MAAM,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;IAEnC,+BAA+B;IAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC;IAE3C,uBAAuB;IACvB,MAAM,GAAG;SACN,GAAG,CAAC;;;;;;;;;;;;6CAYoC,QAAQ,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,kCAAkC;6CAC7E,QAAQ,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,kCAAkC;;;GAGvH,CAAC;SACC,OAAO,CAAC,EAAE,CAAC,CAAC;IAEf,+CAA+C;IAC/C,MAAM,GAAG;SACN,GAAG,CAAC;;;GAGN,CAAC;SACC,OAAO,CAAC,EAAE,CAAC,CAAC;IAEf,qBAAqB;IACrB,MAAM,GAAG;SACN,GAAG,CAAC;;;;;6CAKoC,QAAQ,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,kCAAkC;6CAC7E,QAAQ,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,kCAAkC;;GAEvH,CAAC;SACC,OAAO,CAAC,EAAE,CAAC,CAAC;IAEf,uCAAuC;IACvC,MAAM,GAAG;SACN,GAAG,CAAC;;;;GAIN,CAAC;SACC,OAAO,CAAC,EAAE,CAAC,CAAC;IAEf,0BAA0B;IAC1B,MAAM,GAAG;SACN,GAAG,CAAC;;;;;;;;;;GAUN,CAAC;SACC,OAAO,CAAC,EAAE,CAAC,CAAC;IAEf,yCAAyC;IACzC,MAAM,GAAG;SACN,GAAG,CAAC;;;;GAIN,CAAC;SACC,OAAO,CAAC,EAAE,CAAC,CAAC;IAEf,eAAe;IACf,MAAM,GAAG;SACN,GAAG,CAAC;;;;;GAKN,CAAC;SACC,OAAO,CAAC,EAAE,CAAC,CAAC;AAAA,CAChB"}

package/dist/mode-manager.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @syncular/relay - Mode Manager
+ *
+ * State machine for tracking relay online/offline status.
+ */
+/**
+ * Relay operating modes.
+ */
+export type RelayMode = 'online' | 'offline' | 'reconnecting';
+/**
+ * Mode manager options.
+ */
+export interface ModeManagerOptions {
+    healthCheckIntervalMs?: number;
+    reconnectBackoffMs?: number;
+    maxReconnectBackoffMs?: number;
+    onModeChange?: (mode: RelayMode) => void;
+}
+/**
+ * Mode manager for tracking relay online/offline state.
+ *
+ * Uses health checks to detect connectivity to the main server
+ * and manages reconnection with exponential backoff.
+ */
+export declare class ModeManager {
+    private mode;
+    private healthCheckIntervalMs;
+    private reconnectBackoffMs;
+    private maxReconnectBackoffMs;
+    private currentBackoffMs;
+    private onModeChange?;
+    private running;
+    private timer;
+    private healthCheckFn;
+    private consecutiveFailures;
+    constructor(options?: ModeManagerOptions);
+    /**
+     * Get the current mode.
+     */
+    getMode(): RelayMode;
+    /**
+     * Start the mode manager with a health check function.
+     */
+    start(healthCheckFn: () => Promise<boolean>): void;
+    /**
+     * Stop the mode manager.
+     */
+    stop(): void;
+    /**
+     * Manually report a successful operation (resets backoff).
+     */
+    reportSuccess(): void;
+    /**
+     * Manually report a failed operation.
+     */
+    reportFailure(): void;
+    private setMode;
+    private scheduleHealthCheck;
+}
+//# sourceMappingURL=mode-manager.d.ts.map

package/dist/mode-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode-manager.d.ts","sourceRoot":"","sources":["../src/mode-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,cAAc,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;CAC1C;AAED;;;;;GAKG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,IAAI,CAAwB;IACpC,OAAO,CAAC,qBAAqB,CAAS;IACtC,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,qBAAqB,CAAS;IACtC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,YAAY,CAAC,CAA4B;IAEjD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,aAAa,CAAyC;IAE9D,OAAO,CAAC,mBAAmB,CAAK;IAEhC,YAAY,OAAO,GAAE,kBAAuB,EAM3C;IAED;;OAEG;IACH,OAAO,IAAI,SAAS,CAEnB;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAOjD;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,CAMX;IAED;;OAEG;IACH,aAAa,IAAI,IAAI,CAMpB;IAED;;OAEG;IACH,aAAa,IAAI,IAAI,CAYpB;IAED,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,mBAAmB;CA4B5B"}

package/dist/mode-manager.js

@@ -0,0 +1,114 @@
+/**
+ * @syncular/relay - Mode Manager
+ *
+ * State machine for tracking relay online/offline status.
+ */
+/**
+ * Mode manager for tracking relay online/offline state.
+ *
+ * Uses health checks to detect connectivity to the main server
+ * and manages reconnection with exponential backoff.
+ */
+export class ModeManager {
+    mode = 'offline';
+    healthCheckIntervalMs;
+    reconnectBackoffMs;
+    maxReconnectBackoffMs;
+    currentBackoffMs;
+    onModeChange;
+    running = false;
+    timer = null;
+    healthCheckFn = null;
+    // biome-ignore lint/correctness/noUnusedPrivateClassMembers: assigned and incremented in healthCheck
+    consecutiveFailures = 0;
+    constructor(options = {}) {
+        this.healthCheckIntervalMs = options.healthCheckIntervalMs ?? 30000;
+        this.reconnectBackoffMs = options.reconnectBackoffMs ?? 1000;
+        this.maxReconnectBackoffMs = options.maxReconnectBackoffMs ?? 60000;
+        this.currentBackoffMs = this.reconnectBackoffMs;
+        this.onModeChange = options.onModeChange;
+    }
+    /**
+     * Get the current mode.
+     */
+    getMode() {
+        return this.mode;
+    }
+    /**
+     * Start the mode manager with a health check function.
+     */
+    start(healthCheckFn) {
+        if (this.running)
+            return;
+        this.running = true;
+        this.healthCheckFn = healthCheckFn;
+        // Start with immediate health check
+        this.scheduleHealthCheck(0);
+    }
+    /**
+     * Stop the mode manager.
+     */
+    stop() {
+        this.running = false;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+    }
+    /**
+     * Manually report a successful operation (resets backoff).
+     */
+    reportSuccess() {
+        if (this.mode !== 'online') {
+            this.setMode('online');
+        }
+        this.consecutiveFailures = 0;
+        this.currentBackoffMs = this.reconnectBackoffMs;
+    }
+    /**
+     * Manually report a failed operation.
+     */
+    reportFailure() {
+        this.consecutiveFailures++;
+        if (this.mode === 'online') {
+            this.setMode('reconnecting');
+        }
+        // Increase backoff for next attempt
+        this.currentBackoffMs = Math.min(this.currentBackoffMs * 2, this.maxReconnectBackoffMs);
+    }
+    setMode(newMode) {
+        if (this.mode === newMode)
+            return;
+        this.mode = newMode;
+        this.onModeChange?.(newMode);
+    }
+    scheduleHealthCheck(delayMs) {
+        if (!this.running)
+            return;
+        if (this.timer)
+            return;
+        this.timer = setTimeout(async () => {
+            this.timer = null;
+            if (!this.healthCheckFn) {
+                this.scheduleHealthCheck(this.healthCheckIntervalMs);
+                return;
+            }
+            try {
+                const healthy = await this.healthCheckFn();
+                if (healthy) {
+                    this.reportSuccess();
+                    this.scheduleHealthCheck(this.healthCheckIntervalMs);
+                }
+                else {
+                    this.reportFailure();
+                    this.scheduleHealthCheck(this.currentBackoffMs);
+                }
+            }
+            catch {
+                this.reportFailure();
+                this.scheduleHealthCheck(this.currentBackoffMs);
+            }
+        }, delayMs);
+    }
+}
+//# sourceMappingURL=mode-manager.js.map

package/dist/mode-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode-manager.js","sourceRoot":"","sources":["../src/mode-manager.ts"],"names":[],"mappings":"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"}