trellis 3.1.35 → 3.2.2

package/dist/realtime/text.d.ts

@@ -0,0 +1,73 @@
+/**
+ * RealtimeText — a compact RGA-style sequence CRDT for collaborative text.
+ *
+ * Each character is a node with a globally-unique id (`<lamport>@<peerId>`) and
+ * an `after` pointer to the node it follows. Concurrent inserts sharing an
+ * anchor are ordered deterministically (higher lamport first, peer id as
+ * tiebreak), so all replicas converge regardless of delivery order. Deletes are
+ * tombstones, making them idempotent and commutative.
+ *
+ * This is intentionally minimal — enough for a genuine multiplayer editor demo
+ * without the weight of a full production CRDT (no block compaction, GC, or
+ * rich formatting).
+ */
+import type { RealtimeRoom } from './room.js';
+export interface TextNode {
+    id: string;
+    ch: string;
+    after: string | null;
+    deleted: boolean;
+}
+export type TextOp = {
+    op: 'ins';
+    id: string;
+    ch: string;
+    after: string | null;
+} | {
+    op: 'del';
+    id: string;
+};
+export interface RealtimeTextOptions {
+    peerId: string;
+    /** Optional room binding for automatic op + state sync. */
+    room?: RealtimeRoom;
+    /** Broadcast channel name when bound to a room. Default `text`. */
+    channel?: string;
+}
+export declare class RealtimeText {
+    private nodes;
+    private counter;
+    private peerId;
+    private listeners;
+    private room?;
+    private channel;
+    private unsubscribe?;
+    constructor(opts: RealtimeTextOptions);
+    /** Materialized visible text. */
+    toString(): string;
+    /** Current length of visible text. */
+    get length(): number;
+    /** Insert a string at a visible index. Broadcasts ops when room-bound. */
+    insert(index: number, str: string): TextOp[];
+    /** Delete `count` visible characters starting at `index`. */
+    delete(index: number, count?: number): TextOp[];
+    /** Apply a single remote op. Returns true if the document changed. */
+    applyOp(op: TextOp): boolean;
+    /** Apply a batch of remote ops, emitting once. */
+    applyOps(ops: TextOp[]): void;
+    /** Snapshot of all nodes (including tombstones) for state sync. */
+    getNodes(): TextNode[];
+    /** Merge a remote snapshot of nodes. */
+    mergeNodes(nodes: TextNode[]): void;
+    /** Subscribe to text changes. Returns an unsubscribe fn. */
+    onChange(cb: (text: string) => void): () => void;
+    /** Detach room bindings. */
+    dispose(): void;
+    private onRemote;
+    private publish;
+    private visibleNodes;
+    private nextId;
+    private bumpCounter;
+    private emit;
+}
+//# sourceMappingURL=text.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/realtime/text.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,MAAM,GACd;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC3D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9B,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAuBD,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,IAAI,CAAC,CAAe;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAC,CAAa;gBAErB,IAAI,EAAE,mBAAmB;IAerC,iCAAiC;IACjC,QAAQ,IAAI,MAAM;IAMlB,sCAAsC;IACtC,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,0EAA0E;IAC1E,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE;IAmB5C,6DAA6D;IAC7D,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,EAAE;IAsB1C,sEAAsE;IACtE,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAmB5B,kDAAkD;IAClD,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI;IAQ7B,mEAAmE;IACnE,QAAQ,IAAI,QAAQ,EAAE;IAItB,wCAAwC;IACxC,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI;IAgBnC,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAOhD,4BAA4B;IAC5B,OAAO,IAAI,IAAI;IASf,OAAO,CAAC,QAAQ;IAehB,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,YAAY;IAwBpB,OAAO,CAAC,MAAM;IAKd,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,IAAI;CAUb"}

package/dist/realtime/types.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Trellis Realtime — Ephemeral Presence & Broadcast Types
+ *
+ * Distinct from the persisted VCS op log: realtime messages are ephemeral,
+ * mesh-broadcast, and never written to the causal history. This is the right
+ * home for high-frequency, disposable signals like cursors and presence, plus
+ * fire-and-forget broadcast (chat, live text edits).
+ *
+ * The transport is a broadcast mesh: `send` delivers a message to every other
+ * peer sharing the channel. Senders never receive their own messages.
+ */
+export declare const REALTIME_PROTOCOL: 1;
+/** Arbitrary per-peer presence state (name, avatar, color, cursor, …). */
+export type PresenceState = Record<string, unknown>;
+export interface PresencePeer<P extends PresenceState = PresenceState> {
+    /** Peer/client identity. */
+    id: string;
+    /** Latest published presence state. */
+    state: P;
+    /** Epoch ms of the last presence heartbeat we saw. */
+    lastSeen: number;
+    /** True for the local peer. */
+    self: boolean;
+}
+/** A received broadcast on a channel. */
+export interface BroadcastEvent {
+    from: string;
+    channel: string;
+    event: string;
+    payload: unknown;
+    ts: number;
+    /**
+     * Stable message identity. Assigned by the sender and carried unchanged to
+     * every replica, so dedup is order-independent (a grow-only set). Present on
+     * all broadcasts emitted by {@link RealtimeRoom.broadcast}; may be absent on
+     * legacy frames.
+     */
+    id?: string;
+}
+export type RealtimeMessage<P extends PresenceState = PresenceState> = {
+    v: 1;
+    t: 'hello';
+    from: string;
+} | {
+    v: 1;
+    t: 'presence';
+    from: string;
+    state: P;
+    ts: number;
+} | {
+    v: 1;
+    t: 'bye';
+    from: string;
+    ts: number;
+} | {
+    v: 1;
+    t: 'msg';
+    from: string;
+    channel: string;
+    event: string;
+    payload: unknown;
+    ts: number;
+    /** Stable per-message id (dedup key for grow-only replay). */
+    id?: string;
+}
+/** Relay welcome: re-deliver persisted session state to a new connection. */
+ | {
+    v: 1;
+    t: 'replay';
+    from: string;
+    messages: RealtimeMessage<P>[];
+};
+/**
+ * Broadcast mesh transport. Implementations: {@link MemoryHub} (in-process /
+ * tests / side-by-side panes), {@link BroadcastChannelTransport} (serverless
+ * cross-tab in one browser), and {@link WebSocketRelayTransport} (relay-backed
+ * cross-browser rooms).
+ */
+export interface RealtimeTransport {
+    /** Local peer identity on this transport. */
+    readonly id: string;
+    /** Broadcast a message to all other peers. Never echoes to the sender. */
+    send(message: RealtimeMessage): void;
+    /** Register an inbound message handler. Returns an unsubscribe fn. */
+    onMessage(handler: (message: RealtimeMessage) => void): () => void;
+    /** Tear down the transport. */
+    close(): 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;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,iBAAiB,EAAG,CAAU,CAAC;AAE5C,0EAA0E;AAC1E,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEpD,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa;IACnE,4BAA4B;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,uCAAuC;IACvC,KAAK,EAAE,CAAC,CAAC;IACT,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,IAAI,EAAE,OAAO,CAAC;CACf;AAED,yCAAyC;AACzC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX;;;;;OAKG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa,IAC/D;IAAE,CAAC,EAAE,CAAC,CAAC;IAAC,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,CAAC,EAAE,CAAC,CAAC;IAAC,CAAC,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,CAAC,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,CAAC,EAAE,CAAC,CAAC;IAAC,CAAC,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC5C;IACE,CAAC,EAAE,CAAC,CAAC;IACL,CAAC,EAAE,KAAK,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,8DAA8D;IAC9D,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AACH,6EAA6E;GAC3E;IACE,CAAC,EAAE,CAAC,CAAC;IACL,CAAC,EAAE,QAAQ,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;CAChC,CAAC;AAEN;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,IAAI,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC;IACrC,sEAAsE;IACtE,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACnE,+BAA+B;IAC/B,KAAK,IAAI,IAAI,CAAC;CACf"}

package/dist/realtime/websocket-relay-transport.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Browser transport that relays {@link RealtimeMessage} frames through a
+ * shared WebSocket hub (demo server or custom relay). Unlike
+ * {@link BroadcastChannelTransport}, this works across different browsers on
+ * the same origin.
+ */
+import type { RealtimeMessage, RealtimeTransport } from './types.js';
+export interface WebSocketRelayTransportOptions {
+    /** Local peer identity. */
+    id: string;
+    /** Hub URL, e.g. `ws://localhost:8231/rt`. */
+    url: string;
+    /** Injectable WebSocket for tests. */
+    WebSocketImpl?: typeof WebSocket;
+}
+export declare class WebSocketRelayTransport implements RealtimeTransport {
+    readonly id: string;
+    private ws;
+    private handlers;
+    private closed;
+    private pending;
+    constructor(opts: WebSocketRelayTransportOptions);
+    send(message: RealtimeMessage): void;
+    onMessage(handler: (message: RealtimeMessage) => void): () => void;
+    close(): void;
+    private flushPending;
+}
+//# sourceMappingURL=websocket-relay-transport.d.ts.map

package/dist/realtime/websocket-relay-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-relay-transport.d.ts","sourceRoot":"","sources":["../../src/realtime/websocket-relay-transport.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAErE,MAAM,WAAW,8BAA8B;IAC7C,2BAA2B;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,sCAAsC;IACtC,aAAa,CAAC,EAAE,OAAO,SAAS,CAAC;CAClC;AAED,qBAAa,uBAAwB,YAAW,iBAAiB;IAC/D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,CAAY;IACtB,OAAO,CAAC,QAAQ,CAAiD;IACjE,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAyB;gBAE5B,IAAI,EAAE,8BAA8B;IAgChD,IAAI,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAUpC,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,GAAG,MAAM,IAAI;IAOlE,KAAK,IAAI,IAAI;IAYb,OAAO,CAAC,YAAY;CAOrB"}