@syncular/server 0.1.3 → 0.2.0

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

@@ -1,65 +0,0 @@
-/**
- * @syncular/server/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/relay/client-role/sequence-mapper.d.ts.map

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

@@ -1,161 +0,0 @@
-/**
- * @syncular/server/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/relay/client-role/sequence-mapper.js.map

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

package/dist/relay/evaluation/relay-paths.d.ts

@@ -1,41 +0,0 @@
-interface RelayAppPathEvaluationOptions {
-    iterations?: number;
-    warmupIterations?: number;
-    realtimeConnections?: number;
-}
-interface RelayAppPathMetric {
-    name: string;
-    iterations: number;
-    totalUs: number;
-    minUs: number;
-    avgUs: number;
-    p50Us: number;
-    p95Us: number;
-    maxUs: number;
-}
-interface RelayAppPathEvaluationResult {
-    fixture: {
-        name: string;
-        database: 'bun:sqlite:memory';
-        dialect: '@syncular/server/sqlite';
-        table: 'tasks';
-    };
-    config: {
-        iterations: number;
-        warmupIterations: number;
-        realtimeConnections: number;
-    };
-    counters: {
-        localPushCommits: number;
-        forwardedCommits: number;
-        mainPullAppliedCommits: number;
-        localPullResponses: number;
-        realtimeMessages: number;
-    };
-    metrics: RelayAppPathMetric[];
-    notes: string[];
-}
-export declare function evaluateRelayAppPaths(options?: RelayAppPathEvaluationOptions): Promise<RelayAppPathEvaluationResult>;
-export declare function assertRelayAppPathEvaluation(result: RelayAppPathEvaluationResult): void;
-export {};
-//# sourceMappingURL=relay-paths.d.ts.map

package/dist/relay/evaluation/relay-paths.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"relay-paths.d.ts","sourceRoot":"","sources":["../../../src/relay/evaluation/relay-paths.ts"],"names":[],"mappings":"AA6BA,UAAU,6BAA6B;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,UAAU,kBAAkB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,4BAA4B;IACpC,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,mBAAmB,CAAC;QAC9B,OAAO,EAAE,yBAAyB,CAAC;QACnC,KAAK,EAAE,OAAO,CAAC;KAChB,CAAC;IACF,MAAM,EAAE;QACN,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,EAAE,MAAM,CAAC;QACzB,mBAAmB,EAAE,MAAM,CAAC;KAC7B,CAAC;IACF,QAAQ,EAAE;QACR,gBAAgB,EAAE,MAAM,CAAC;QACzB,gBAAgB,EAAE,MAAM,CAAC;QACzB,sBAAsB,EAAE,MAAM,CAAC;QAC/B,kBAAkB,EAAE,MAAM,CAAC;QAC3B,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAWD,wBAAsB,qBAAqB,CACzC,OAAO,GAAE,6BAAkC,GAC1C,OAAO,CAAC,4BAA4B,CAAC,CA4DvC;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,4BAA4B,GACnC,IAAI,CA4BN"}