@syncular/server 0.0.1-100

package/dist/push.d.ts

@@ -0,0 +1,33 @@
+import { type SyncChange, type SyncPushRequest, type SyncPushResponse } from '@syncular/core';
+import type { Kysely } from 'kysely';
+import type { ServerSyncDialect } from './dialect/types';
+import type { SyncCoreDb } from './schema';
+import type { TableRegistry } from './shapes/registry';
+export interface PushCommitResult {
+    response: SyncPushResponse;
+    /**
+     * Distinct tables affected by this commit.
+     * Empty for rejected commits and for commits that emit no changes.
+     */
+    affectedTables: string[];
+    /**
+     * Scope keys derived from emitted changes (e.g. "org:abc", "team:xyz").
+     * Computed in-transaction so callers don't need an extra DB query.
+     * Empty for rejected/cached commits.
+     */
+    scopeKeys: string[];
+    /**
+     * Changes emitted by this commit. Available for WS data delivery.
+     * Empty for rejected/cached commits.
+     */
+    emittedChanges: SyncChange[];
+}
+export declare function pushCommit<DB extends SyncCoreDb>(args: {
+    db: Kysely<DB>;
+    dialect: ServerSyncDialect;
+    shapes: TableRegistry<DB>;
+    actorId: string;
+    partitionId?: string;
+    request: SyncPushRequest;
+}): Promise<PushCommitResult>;
+//# sourceMappingURL=push.d.ts.map

package/dist/push.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../src/push.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,gBAAgB,EAEtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAEV,MAAM,EAIP,MAAM,QAAQ,CAAC;AAEhB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAKvD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B;;;OAGG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB;;;;OAIG;IACH,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB;;;OAGG;IACH,cAAc,EAAE,UAAU,EAAE,CAAC;CAC9B;AA6FD,wBAAsB,UAAU,CAAC,EAAE,SAAS,UAAU,EAAE,IAAI,EAAE;IAC5D,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,EAAE,iBAAiB,CAAC;IAC3B,MAAM,EAAE,aAAa,CAAC,EAAE,CAAC,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,eAAe,CAAC;CAC1B,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAwb5B"}

package/dist/push.js

@@ -0,0 +1,412 @@
+import { captureSyncException, countSyncMetric, distributionSyncMetric, startSyncSpan, } from '@syncular/core';
+import { sql } from 'kysely';
+class RejectCommitError extends Error {
+    response;
+    constructor(response) {
+        super('REJECT_COMMIT');
+        this.response = response;
+        this.name = 'RejectCommitError';
+    }
+}
+async function readCommitAffectedTables(db, dialect, commitSeq, partitionId) {
+    try {
+        const commitsQ = db.selectFrom('sync_commits');
+        const row = await commitsQ
+            .selectAll()
+            .where(sql `commit_seq = ${commitSeq}`)
+            .where(sql `partition_id = ${partitionId}`)
+            .executeTakeFirst();
+        const raw = row?.affected_tables;
+        return dialect.dbToArray(raw);
+    }
+    catch {
+        // ignore and fall back to scanning changes (best-effort)
+    }
+    // Fallback: read from changes using dialect-specific implementation
+    return dialect.readAffectedTablesFromChanges(db, commitSeq, { partitionId });
+}
+function scopeKeysFromEmitted(emitted) {
+    const keys = new Set();
+    for (const c of emitted) {
+        for (const [key, value] of Object.entries(c.scopes)) {
+            if (!value)
+                continue;
+            const prefix = key.replace(/_id$/, '');
+            keys.add(`${prefix}:${value}`);
+        }
+    }
+    return Array.from(keys);
+}
+function recordPushMetrics(args) {
+    const { status, durationMs, operationCount, emittedChangeCount, affectedTableCount, } = args;
+    countSyncMetric('sync.server.push.requests', 1, {
+        attributes: { status },
+    });
+    countSyncMetric('sync.server.push.operations', operationCount, {
+        attributes: { status },
+    });
+    distributionSyncMetric('sync.server.push.duration_ms', durationMs, {
+        unit: 'millisecond',
+        attributes: { status },
+    });
+    distributionSyncMetric('sync.server.push.emitted_changes', emittedChangeCount, {
+        attributes: { status },
+    });
+    distributionSyncMetric('sync.server.push.affected_tables', affectedTableCount, {
+        attributes: { status },
+    });
+}
+export async function pushCommit(args) {
+    const { request, dialect } = args;
+    const db = args.db;
+    const partitionId = args.partitionId ?? 'default';
+    const requestedOps = Array.isArray(request.operations)
+        ? request.operations
+        : [];
+    const operationCount = requestedOps.length;
+    const startedAtMs = Date.now();
+    return startSyncSpan({
+        name: 'sync.server.push',
+        op: 'sync.push',
+        attributes: {
+            operation_count: operationCount,
+        },
+    }, async (span) => {
+        const finalizeResult = (result) => {
+            const durationMs = Math.max(0, Date.now() - startedAtMs);
+            const status = result.response.status;
+            span.setAttribute('status', status);
+            span.setAttribute('duration_ms', durationMs);
+            span.setAttribute('emitted_change_count', result.emittedChanges.length);
+            span.setAttribute('affected_table_count', result.affectedTables.length);
+            span.setStatus('ok');
+            recordPushMetrics({
+                status,
+                durationMs,
+                operationCount,
+                emittedChangeCount: result.emittedChanges.length,
+                affectedTableCount: result.affectedTables.length,
+            });
+            return result;
+        };
+        try {
+            if (!request.clientId || !request.clientCommitId) {
+                return finalizeResult({
+                    response: {
+                        ok: true,
+                        status: 'rejected',
+                        results: [
+                            {
+                                opIndex: 0,
+                                status: 'error',
+                                error: 'INVALID_REQUEST',
+                                code: 'INVALID_REQUEST',
+                                retriable: false,
+                            },
+                        ],
+                    },
+                    affectedTables: [],
+                    scopeKeys: [],
+                    emittedChanges: [],
+                });
+            }
+            const ops = request.operations ?? [];
+            if (!Array.isArray(ops) || ops.length === 0) {
+                return finalizeResult({
+                    response: {
+                        ok: true,
+                        status: 'rejected',
+                        results: [
+                            {
+                                opIndex: 0,
+                                status: 'error',
+                                error: 'EMPTY_COMMIT',
+                                code: 'EMPTY_COMMIT',
+                                retriable: false,
+                            },
+                        ],
+                    },
+                    affectedTables: [],
+                    scopeKeys: [],
+                    emittedChanges: [],
+                });
+            }
+            return finalizeResult(await dialect.executeInTransaction(db, async (trx) => {
+                const syncTrx = trx;
+                // Clean up any stale commit row with null result_json.
+                // This can happen when a previous push inserted the commit row but crashed
+                // before writing the result (e.g., on D1 without transaction support).
+                await syncTrx
+                    .deleteFrom('sync_commits')
+                    .where('partition_id', '=', partitionId)
+                    .where('client_id', '=', request.clientId)
+                    .where('client_commit_id', '=', request.clientCommitId)
+                    .where('result_json', 'is', null)
+                    .execute();
+                // Insert commit row (idempotency key)
+                const commitRow = {
+                    partition_id: partitionId,
+                    actor_id: args.actorId,
+                    client_id: request.clientId,
+                    client_commit_id: request.clientCommitId,
+                    meta: null,
+                    result_json: null,
+                };
+                const insertResult = await syncTrx
+                    .insertInto('sync_commits')
+                    .values(commitRow)
+                    .onConflict((oc) => oc
+                    .columns(['partition_id', 'client_id', 'client_commit_id'])
+                    .doNothing())
+                    .executeTakeFirstOrThrow();
+                const insertedRows = Number(insertResult.numInsertedOrUpdatedRows ?? 0);
+                if (insertedRows === 0) {
+                    // Existing commit: return cached response (applied or rejected)
+                    // Use forUpdate() for row locking on databases that support it
+                    let query = syncTrx.selectFrom('sync_commits')
+                        .selectAll()
+                        .where('partition_id', '=', partitionId)
+                        .where('client_id', '=', request.clientId)
+                        .where('client_commit_id', '=', request.clientCommitId);
+                    if (dialect.supportsForUpdate) {
+                        query = query.forUpdate();
+                    }
+                    const existing = await query.executeTakeFirstOrThrow();
+                    const cached = existing.result_json;
+                    if (!cached || cached.ok !== true) {
+                        return {
+                            response: {
+                                ok: true,
+                                status: 'rejected',
+                                results: [
+                                    {
+                                        opIndex: 0,
+                                        status: 'error',
+                                        error: 'IDEMPOTENCY_CACHE_MISS',
+                                        code: 'INTERNAL',
+                                        retriable: true,
+                                    },
+                                ],
+                            },
+                            affectedTables: [],
+                            scopeKeys: [],
+                            emittedChanges: [],
+                        };
+                    }
+                    const base = {
+                        ...cached,
+                        commitSeq: Number(existing.commit_seq),
+                    };
+                    if (cached.status === 'applied') {
+                        const tablesFromDb = dialect.dbToArray(existing.affected_tables);
+                        return {
+                            response: { ...base, status: 'cached' },
+                            affectedTables: tablesFromDb.length > 0
+                                ? tablesFromDb
+                                : await readCommitAffectedTables(trx, dialect, Number(existing.commit_seq), partitionId),
+                            scopeKeys: [],
+                            emittedChanges: [],
+                        };
+                    }
+                    return {
+                        response: base,
+                        affectedTables: [],
+                        scopeKeys: [],
+                        emittedChanges: [],
+                    };
+                }
+                const insertedCommit = await syncTrx.selectFrom('sync_commits')
+                    .selectAll()
+                    .where('partition_id', '=', partitionId)
+                    .where('client_id', '=', request.clientId)
+                    .where('client_commit_id', '=', request.clientCommitId)
+                    .executeTakeFirstOrThrow();
+                const commitSeq = Number(insertedCommit.commit_seq);
+                const commitId = `${request.clientId}:${request.clientCommitId}`;
+                const savepointName = 'sync_apply';
+                const useSavepoints = dialect.supportsSavepoints;
+                let savepointCreated = false;
+                try {
+                    // Apply the commit under a savepoint so we can roll back app writes on conflict
+                    // while still persisting the commit-level cached response.
+                    if (useSavepoints) {
+                        await sql.raw(`SAVEPOINT ${savepointName}`).execute(trx);
+                        savepointCreated = true;
+                    }
+                    const allEmitted = [];
+                    const results = [];
+                    const affectedTablesSet = new Set();
+                    for (let i = 0; i < ops.length; i++) {
+                        const op = ops[i];
+                        const handler = args.shapes.getOrThrow(op.table);
+                        const applied = await handler.applyOperation({
+                            db: trx,
+                            trx,
+                            actorId: args.actorId,
+                            clientId: request.clientId,
+                            commitId,
+                            schemaVersion: request.schemaVersion,
+                        }, op, i);
+                        if (applied.result.status !== 'applied') {
+                            results.push(applied.result);
+                            throw new RejectCommitError({
+                                ok: true,
+                                status: 'rejected',
+                                commitSeq,
+                                results,
+                            });
+                        }
+                        // Framework-level enforcement: emitted changes must have scopes
+                        for (const c of applied.emittedChanges ?? []) {
+                            const scopes = c?.scopes;
+                            if (!scopes || typeof scopes !== 'object') {
+                                results.push({
+                                    opIndex: i,
+                                    status: 'error',
+                                    error: 'MISSING_SCOPES',
+                                    code: 'INVALID_SCOPE',
+                                    retriable: false,
+                                });
+                                throw new RejectCommitError({
+                                    ok: true,
+                                    status: 'rejected',
+                                    commitSeq,
+                                    results,
+                                });
+                            }
+                        }
+                        results.push(applied.result);
+                        allEmitted.push(...applied.emittedChanges);
+                        for (const c of applied.emittedChanges) {
+                            affectedTablesSet.add(c.table);
+                        }
+                    }
+                    if (allEmitted.length > 0) {
+                        const changeRows = allEmitted.map((c) => ({
+                            partition_id: partitionId,
+                            commit_seq: commitSeq,
+                            table: c.table,
+                            row_id: c.row_id,
+                            op: c.op,
+                            row_json: c.row_json,
+                            row_version: c.row_version,
+                            scopes: dialect.scopesToDb(c.scopes),
+                        }));
+                        await syncTrx
+                            .insertInto('sync_changes')
+                            .values(changeRows)
+                            .execute();
+                    }
+                    const appliedResponse = {
+                        ok: true,
+                        status: 'applied',
+                        commitSeq,
+                        results,
+                    };
+                    const affectedTables = Array.from(affectedTablesSet).sort();
+                    const appliedCommitUpdate = {
+                        result_json: appliedResponse,
+                        change_count: allEmitted.length,
+                        affected_tables: affectedTables,
+                    };
+                    await syncTrx
+                        .updateTable('sync_commits')
+                        .set(appliedCommitUpdate)
+                        .where('commit_seq', '=', commitSeq)
+                        .execute();
+                    // Insert table commits for subscription filtering
+                    if (affectedTables.length > 0) {
+                        const tableCommits = affectedTables.map((table) => ({
+                            partition_id: partitionId,
+                            table,
+                            commit_seq: commitSeq,
+                        }));
+                        await syncTrx
+                            .insertInto('sync_table_commits')
+                            .values(tableCommits)
+                            .onConflict((oc) => oc
+                            .columns(['partition_id', 'table', 'commit_seq'])
+                            .doNothing())
+                            .execute();
+                    }
+                    if (useSavepoints) {
+                        await sql
+                            .raw(`RELEASE SAVEPOINT ${savepointName}`)
+                            .execute(trx);
+                    }
+                    return {
+                        response: appliedResponse,
+                        affectedTables,
+                        scopeKeys: scopeKeysFromEmitted(allEmitted),
+                        emittedChanges: allEmitted.map((c) => ({
+                            table: c.table,
+                            row_id: c.row_id,
+                            op: c.op,
+                            row_json: c.row_json,
+                            row_version: c.row_version,
+                            scopes: c.scopes,
+                        })),
+                    };
+                }
+                catch (err) {
+                    // Roll back app writes but keep the commit row.
+                    if (savepointCreated) {
+                        try {
+                            await sql
+                                .raw(`ROLLBACK TO SAVEPOINT ${savepointName}`)
+                                .execute(trx);
+                            await sql
+                                .raw(`RELEASE SAVEPOINT ${savepointName}`)
+                                .execute(trx);
+                        }
+                        catch (savepointErr) {
+                            // If savepoint rollback fails, the transaction may be in an
+                            // inconsistent state. Log and rethrow to fail the entire commit
+                            // rather than risk data corruption.
+                            console.error('[pushCommit] Savepoint rollback failed:', savepointErr);
+                            throw savepointErr;
+                        }
+                    }
+                    if (!(err instanceof RejectCommitError))
+                        throw err;
+                    const rejectedCommitUpdate = {
+                        result_json: err.response,
+                        change_count: 0,
+                        affected_tables: [],
+                    };
+                    // Persist the rejected response for commit-level idempotency.
+                    await syncTrx
+                        .updateTable('sync_commits')
+                        .set(rejectedCommitUpdate)
+                        .where('commit_seq', '=', commitSeq)
+                        .execute();
+                    return {
+                        response: err.response,
+                        affectedTables: [],
+                        scopeKeys: [],
+                        emittedChanges: [],
+                    };
+                }
+            }));
+        }
+        catch (error) {
+            const durationMs = Math.max(0, Date.now() - startedAtMs);
+            span.setAttribute('status', 'error');
+            span.setAttribute('duration_ms', durationMs);
+            span.setStatus('error');
+            recordPushMetrics({
+                status: 'error',
+                durationMs,
+                operationCount,
+                emittedChangeCount: 0,
+                affectedTableCount: 0,
+            });
+            captureSyncException(error, {
+                event: 'sync.server.push',
+                operationCount,
+            });
+            throw error;
+        }
+    });
+}
+//# sourceMappingURL=push.js.map

package/dist/push.js.map

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

package/dist/realtime/in-memory.d.ts

@@ -0,0 +1,13 @@
+import type { SyncRealtimeBroadcaster, SyncRealtimeEvent } from './types';
+/**
+ * In-memory broadcaster for tests and single-process setups.
+ *
+ * This simulates multi-instance fanout when shared across "instances" in a test.
+ */
+export declare class InMemorySyncRealtimeBroadcaster implements SyncRealtimeBroadcaster {
+    private handlers;
+    subscribe(handler: (event: SyncRealtimeEvent) => void): () => void;
+    publish(event: SyncRealtimeEvent): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=in-memory.d.ts.map

package/dist/realtime/in-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory.d.ts","sourceRoot":"","sources":["../../src/realtime/in-memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE1E;;;;GAIG;AACH,qBAAa,+BACX,YAAW,uBAAuB;IAElC,OAAO,CAAC,QAAQ,CAAiD;IAEjE,SAAS,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAAG,MAAM,IAAI,CAKjE;IAEK,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQrD;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3B;CACF"}

package/dist/realtime/in-memory.js

@@ -0,0 +1,28 @@
+/**
+ * In-memory broadcaster for tests and single-process setups.
+ *
+ * This simulates multi-instance fanout when shared across "instances" in a test.
+ */
+export class InMemorySyncRealtimeBroadcaster {
+    handlers = new Set();
+    subscribe(handler) {
+        this.handlers.add(handler);
+        return () => {
+            this.handlers.delete(handler);
+        };
+    }
+    async publish(event) {
+        for (const handler of this.handlers) {
+            try {
+                handler(event);
+            }
+            catch {
+                // ignore individual handler errors; realtime is best-effort
+            }
+        }
+    }
+    async close() {
+        this.handlers.clear();
+    }
+}
+//# sourceMappingURL=in-memory.js.map

package/dist/realtime/in-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory.js","sourceRoot":"","sources":["../../src/realtime/in-memory.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,OAAO,+BAA+B;IAGlC,QAAQ,GAAG,IAAI,GAAG,EAAsC,CAAC;IAEjE,SAAS,CAAC,OAA2C,EAAc;QACjE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC3B,OAAO,GAAG,EAAE,CAAC;YACX,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAAA,CAC/B,CAAC;IAAA,CACH;IAED,KAAK,CAAC,OAAO,CAAC,KAAwB,EAAiB;QACrD,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,IAAI,CAAC;gBACH,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;YAAC,MAAM,CAAC;gBACP,4DAA4D;YAC9D,CAAC;QACH,CAAC;IAAA,CACF;IAED,KAAK,CAAC,KAAK,GAAkB;QAC3B,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IAAA,CACvB;CACF"}

package/dist/realtime/index.d.ts

@@ -0,0 +1,3 @@
+export { InMemorySyncRealtimeBroadcaster } from './in-memory';
+export type { SyncRealtimeBroadcaster, SyncRealtimeEvent, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/realtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/realtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,MAAM,aAAa,CAAC;AAC9D,YAAY,EACV,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,SAAS,CAAC"}

package/dist/realtime/index.js

@@ -0,0 +1,2 @@
+export { InMemorySyncRealtimeBroadcaster } from './in-memory.js';
+//# sourceMappingURL=index.js.map

package/dist/realtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/realtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,MAAM,aAAa,CAAC"}

package/dist/realtime/types.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @syncular/server - Realtime broadcaster types
+ *
+ * Realtime is a best-effort "wake up" mechanism. Correctness always comes from pull + cursors.
+ */
+export interface SyncRealtimeCommitEvent {
+    type: 'commit';
+    commitSeq: number;
+    /** Logical partition key (tenant / demo / workspace). */
+    partitionId?: string;
+    /**
+     * Optional scopes affected by the commit.
+     * Broadcasters may omit this to keep payloads small (listeners can look up in DB).
+     */
+    scopeKeys?: string[];
+    /** Optional instance id to suppress echo on the originating instance. */
+    sourceInstanceId?: string;
+}
+/**
+ * Presence event for tracking which clients are connected to which scopes.
+ * Used for collaborative features like "who's online" indicators.
+ */
+export interface SyncRealtimePresenceEvent {
+    type: 'presence';
+    /** The action that occurred */
+    action: 'join' | 'leave' | 'update';
+    /** The scope key this presence event relates to */
+    scopeKey: string;
+    /** Client/device identifier */
+    clientId: string;
+    /** Actor/user identifier */
+    actorId: string;
+    /** Optional metadata (e.g., entity being viewed/edited) */
+    metadata?: Record<string, unknown>;
+    /** Optional instance id to suppress echo on the originating instance. */
+    sourceInstanceId?: string;
+}
+export type SyncRealtimeEvent = SyncRealtimeCommitEvent | SyncRealtimePresenceEvent;
+export interface SyncRealtimeBroadcaster {
+    /** Publish an event to other app instances. */
+    publish(event: SyncRealtimeEvent): Promise<void>;
+    /**
+     * Subscribe to events from other app instances.
+     * Returns an unsubscribe function.
+     */
+    subscribe(handler: (event: SyncRealtimeEvent) => void): () => void;
+    /** Close underlying resources (best-effort). */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/realtime/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/realtime/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,UAAU,CAAC;IACjB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpC,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,iBAAiB,GACzB,uBAAuB,GACvB,yBAAyB,CAAC;AAE9B,MAAM,WAAW,uBAAuB;IACtC,+CAA+C;IAC/C,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACnE,gDAAgD;IAChD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}

package/dist/realtime/types.js

@@ -0,0 +1,7 @@
+/**
+ * @syncular/server - Realtime broadcaster types
+ *
+ * Realtime is a best-effort "wake up" mechanism. Correctness always comes from pull + cursors.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/realtime/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/realtime/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}