@syncular/server 0.0.6-96 → 0.1.0

package/dist/relay/evaluation/rust-boundary.js

@@ -0,0 +1,220 @@
+import { readFileSync } from 'node:fs';
+import { BlobRefSchema, BlobUploadCompleteResponseSchema, BlobUploadInitRequestSchema, BlobUploadInitResponseSchema, decodeBinarySyncPack, SyncAuthLeaseIssueRequestSchema, SyncAuthLeaseIssueResponseSchema, SyncAuthLeaseProvenanceSchema, SyncCombinedRequestSchema, SyncCombinedResponseSchema, SyncSnapshotArtifactRefSchema, SyncSnapshotChunkRefSchema, } from '@syncular/core';
+const DEFAULT_ITERATIONS = 2_000;
+const DEFAULT_WARMUP_ITERATIONS = 100;
+let evaluationSink;
+function readRelayProtocolBoundaryFixture() {
+    return JSON.parse(readFileSync(new URL('../../../../rust/crates/runtime/tests/fixtures/relay-protocol-boundary-v1.json', import.meta.url), 'utf8'));
+}
+export function evaluateRelayRustBoundary(options = {}) {
+    const iterations = positiveIntegerOrDefault(options.iterations, DEFAULT_ITERATIONS);
+    const warmupIterations = positiveIntegerOrDefault(options.warmupIterations, DEFAULT_WARMUP_ITERATIONS);
+    const fixture = readRelayProtocolBoundaryFixture();
+    const combinedRequestJson = JSON.stringify(fixture.combined.request);
+    const combinedResponseJson = JSON.stringify(fixture.combined.response);
+    const realtimeServerSyncMessageJson = JSON.stringify(fixture.realtime.serverSyncMessage);
+    const binarySyncPackBytes = bytesFromHex(fixture.binarySyncPack.encodedHex);
+    const metrics = [
+        measureOperation('json.parse.combined_request', iterations, warmupIterations, () => JSON.parse(combinedRequestJson)),
+        measureOperation('json.parse.combined_response', iterations, warmupIterations, () => JSON.parse(combinedResponseJson)),
+        measureOperation('schema.combined_request', iterations, warmupIterations, () => SyncCombinedRequestSchema.parse(fixture.combined.request)),
+        measureOperation('schema.combined_response', iterations, warmupIterations, () => SyncCombinedResponseSchema.parse(fixture.combined.response)),
+        measureOperation('http_style_parse_and_schema.combined_request', iterations, warmupIterations, () => SyncCombinedRequestSchema.parse(JSON.parse(combinedRequestJson))),
+        measureOperation('http_style_parse_and_schema.combined_response', iterations, warmupIterations, () => SyncCombinedResponseSchema.parse(JSON.parse(combinedResponseJson))),
+        measureOperation('binary_sync_pack.decode', iterations, warmupIterations, () => decodeBinarySyncPack(binarySyncPackBytes)),
+        measureOperation('binary_sync_pack.decode_plus_schema', iterations, warmupIterations, () => SyncCombinedResponseSchema.parse(decodeBinarySyncPack(binarySyncPackBytes))),
+        measureOperation('relay_protocol_boundary.validate_schema_backed_fixture_objects', iterations, warmupIterations, () => validateRelayProtocolBoundaryFixture(fixture)),
+    ];
+    return {
+        fixture: {
+            name: fixture.name,
+            generatedBy: fixture.generatedBy,
+            binarySyncPackWireVersion: fixture.binarySyncPack.wireVersion,
+        },
+        payloads: {
+            combinedRequestJsonBytes: byteLength(combinedRequestJson),
+            combinedResponseJsonBytes: byteLength(combinedResponseJson),
+            binarySyncPackBytes: binarySyncPackBytes.byteLength,
+            snapshotChunkBytes: bytesFromHex(fixture.snapshotChunk.encodedHex)
+                .byteLength,
+            scopedSnapshotArtifactBytes: bytesFromHex(fixture.scopedSnapshotArtifact.encodedHex).byteLength,
+            blobBytes: bytesFromHex(fixture.blob.bytesHex).byteLength,
+            realtimeServerSyncMessageJsonBytes: byteLength(realtimeServerSyncMessageJson),
+        },
+        metrics,
+        malformedDiagnostics: collectMalformedDiagnostics(fixture, binarySyncPackBytes),
+        notes: [
+            'This is a current TypeScript relay/protocol baseline, not a Rust production integration.',
+            'Metrics are candidate/control inputs for deciding whether a Rust validation boundary is worth a later prototype.',
+            'Malformed diagnostics intentionally report schema paths and codes without row payloads or secret material.',
+        ],
+    };
+}
+export function assertRelayRustBoundaryEvaluation(result) {
+    if (result.metrics.length === 0) {
+        throw new Error('Relay Rust boundary evaluation produced no metrics');
+    }
+    const emptyMetric = result.metrics.find((metric) => metric.iterations <= 0 || metric.totalUs <= 0);
+    if (emptyMetric) {
+        throw new Error(`Relay Rust boundary metric ${emptyMetric.name} did not record timing`);
+    }
+    const acceptedMalformedCase = result.malformedDiagnostics.find((diagnostic) => !diagnostic.rejected);
+    if (acceptedMalformedCase) {
+        throw new Error(`Malformed protocol case ${acceptedMalformedCase.case} was accepted`);
+    }
+}
+function validateRelayProtocolBoundaryFixture(fixture) {
+    SyncCombinedRequestSchema.parse(fixture.combined.request);
+    SyncCombinedResponseSchema.parse(fixture.combined.response);
+    SyncSnapshotChunkRefSchema.parse(fixture.snapshotChunk.ref);
+    SyncSnapshotArtifactRefSchema.parse(fixture.scopedSnapshotArtifact.ref);
+    BlobRefSchema.parse(fixture.blob.ref);
+    BlobUploadInitRequestSchema.parse(fixture.blob.uploadInitRequest);
+    BlobUploadInitResponseSchema.parse(fixture.blob.uploadInitResponse);
+    BlobUploadCompleteResponseSchema.parse(fixture.blob.uploadCompleteResponse);
+    SyncAuthLeaseProvenanceSchema.parse(fixture.authLease.provenance);
+    SyncAuthLeaseIssueRequestSchema.parse(fixture.authLease.issueRequest);
+    SyncAuthLeaseIssueResponseSchema.parse(fixture.authLease.issueResponse);
+    decodeBinarySyncPack(bytesFromHex(fixture.binarySyncPack.encodedHex));
+    return true;
+}
+function collectMalformedDiagnostics(fixture, binarySyncPackBytes) {
+    return [
+        collectDiagnostic('combined_request.empty_client_id', () => {
+            SyncCombinedRequestSchema.parse({
+                ...fixture.combined.request,
+                clientId: '',
+            });
+        }),
+        collectDiagnostic('combined_response.non_true_ok', () => {
+            SyncCombinedResponseSchema.parse({
+                ...fixture.combined.response,
+                ok: false,
+            });
+        }),
+        collectDiagnostic('blob_ref.invalid_hash', () => {
+            BlobRefSchema.parse({
+                ...recordFrom(fixture.blob.ref),
+                hash: 'sha256:bad',
+            });
+        }),
+        collectDiagnostic('binary_sync_pack.unsupported_wire_version', () => {
+            const stale = new Uint8Array(binarySyncPackBytes);
+            stale[4] = 0;
+            stale[5] = 0;
+            decodeBinarySyncPack(stale);
+        }),
+    ];
+}
+function collectDiagnostic(name, action) {
+    try {
+        action();
+        return {
+            case: name,
+            rejected: false,
+            issues: [],
+        };
+    }
+    catch (error) {
+        return {
+            case: name,
+            rejected: true,
+            issues: sanitizedIssues(error),
+        };
+    }
+}
+function sanitizedIssues(error) {
+    const issues = issueArray(error);
+    if (issues) {
+        return issues.map((issue) => ({
+            path: issue.path.map(String).join('.'),
+            code: issue.code,
+            message: issue.message,
+        }));
+    }
+    const message = error instanceof Error ? error.message : 'Unknown error';
+    return [
+        {
+            path: '',
+            code: 'error',
+            message,
+        },
+    ];
+}
+function issueArray(error) {
+    if (typeof error !== 'object' ||
+        error === null ||
+        !('issues' in error) ||
+        !Array.isArray(error.issues)) {
+        return undefined;
+    }
+    const issues = error.issues;
+    return issues
+        .filter((issue) => typeof issue === 'object' &&
+        issue !== null &&
+        'path' in issue &&
+        Array.isArray(issue.path) &&
+        'code' in issue &&
+        typeof issue.code === 'string' &&
+        'message' in issue &&
+        typeof issue.message === 'string')
+        .map((issue) => ({
+        path: issue.path,
+        code: issue.code,
+        message: issue.message,
+    }));
+}
+function measureOperation(name, iterations, warmupIterations, operation) {
+    for (let index = 0; index < warmupIterations; index += 1) {
+        evaluationSink = operation();
+    }
+    const samples = new Array(iterations);
+    const totalStart = process.hrtime.bigint();
+    for (let index = 0; index < iterations; index += 1) {
+        const start = process.hrtime.bigint();
+        evaluationSink = operation();
+        samples[index] = Number(process.hrtime.bigint() - start) / 1_000;
+    }
+    void evaluationSink;
+    const totalUs = Number(process.hrtime.bigint() - totalStart) / 1_000;
+    samples.sort((left, right) => left - right);
+    return {
+        name,
+        iterations,
+        totalUs: roundUs(totalUs),
+        minUs: roundUs(samples[0] ?? 0),
+        avgUs: roundUs(totalUs / iterations),
+        p50Us: roundUs(percentile(samples, 0.5)),
+        p95Us: roundUs(percentile(samples, 0.95)),
+        maxUs: roundUs(samples[samples.length - 1] ?? 0),
+    };
+}
+function percentile(sortedSamples, percentileValue) {
+    if (sortedSamples.length === 0) {
+        return 0;
+    }
+    const index = Math.min(sortedSamples.length - 1, Math.floor((sortedSamples.length - 1) * percentileValue));
+    return sortedSamples[index] ?? 0;
+}
+function positiveIntegerOrDefault(value, defaultValue) {
+    if (Number.isInteger(value) && value !== undefined && value > 0) {
+        return value;
+    }
+    return defaultValue;
+}
+function bytesFromHex(hex) {
+    return Buffer.from(hex, 'hex');
+}
+function byteLength(value) {
+    return Buffer.byteLength(value, 'utf8');
+}
+function roundUs(value) {
+    return Math.round(value * 100) / 100;
+}
+function recordFrom(value) {
+    if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+        return value;
+    }
+    throw new Error('Expected record value in relay protocol fixture');
+}
+//# sourceMappingURL=rust-boundary.js.map

package/dist/relay/evaluation/rust-boundary.js.map

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

package/dist/relay/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @syncular/server/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/server/relay';
+ * import { createSqliteServerDialect } from '@syncular/server/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'],
+ *   handlers: shapeRegistry,
+ *   subscriptions: subscriptionRegistry,
+ * });
+ *
+ * // Mount routes for local clients
+ * app.route('/sync', await 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/relay/index.d.ts.map

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

@@ -0,0 +1,44 @@
+/**
+ * @syncular/server/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/server/relay';
+ * import { createSqliteServerDialect } from '@syncular/server/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'],
+ *   handlers: shapeRegistry,
+ *   subscriptions: subscriptionRegistry,
+ * });
+ *
+ * // Mount routes for local clients
+ * app.route('/sync', await 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/relay/index.js.map

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

@@ -0,0 +1,18 @@
+/**
+ * @syncular/server/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/relay/migrate.d.ts.map

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

@@ -0,0 +1,99 @@
+/**
+ * @syncular/server/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.family === '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/relay/migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../src/relay/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;IAC1C,uCAAuC;IACvC,MAAM,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;IAEnC,+BAA+B;IAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC;IAE7C,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;AACjB,CAAC"}

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

@@ -0,0 +1,60 @@
+/**
+ * @syncular/server/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/relay/mode-manager.d.ts.map

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

@@ -0,0 +1,114 @@
+/**
+ * @syncular/server/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 !== 'reconnecting') {
+            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/relay/mode-manager.js.map

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