@velajs/client 0.1.0 → 0.1.1

package/dist/presence.js

@@ -1,45 +1,47 @@
+//#region src/presence.ts
 /**
- * The built-in roster query name served by `@velajs/vela/live`'s presence
- * preset (`PRESENCE_ROSTER_QUERY` on the server side).
- */ export const PRESENCE_ROSTER_QUERY = '$presence.roster';
+* The built-in roster query name served by `@velajs/vela/live`'s presence
+* preset (`PRESENCE_ROSTER_QUERY` on the server side).
+*/
+const PRESENCE_ROSTER_QUERY = "$presence.roster";
 /**
- * Framework-neutral presence: joins a room's roster (heartbeats over the
- * room's live socket) and subscribes to it. Departure is immediate on socket
- * close — the heartbeat/TTL pair only covers ungraceful drops.
- */ export function createPresence(client, options) {
-    const intervalMs = options.heartbeatIntervalMs ?? 10_000;
-    let members;
-    let timer;
-    let stopped = false;
-    const beat = ()=>{
-        if (stopped) return;
-        const meta = typeof options.meta === 'function' ? options.meta() : options.meta;
-        client.presenceBeat(options.room, meta);
-    };
-    const tick = ()=>{
-        timer = undefined;
-        if (stopped) return;
-        beat();
-        timer = setTimeout(tick, intervalMs);
-    };
-    const unsubscribe = client.subscribe(PRESENCE_ROSTER_QUERY, {
-        room: options.room
-    }, (value)=>{
-        members = value ?? [];
-        options.onRoster?.(members);
-    }, {
-        room: options.room
-    });
-    // First beat rides after the subscription so the socket is being opened.
-    tick();
-    return {
-        roster: ()=>members,
-        beat,
-        stop () {
-            stopped = true;
-            if (timer) clearTimeout(timer);
-            timer = undefined;
-            unsubscribe();
-        }
-    };
+* Framework-neutral presence: joins a room's roster (heartbeats over the
+* room's live socket) and subscribes to it. Departure is immediate on socket
+* close — the heartbeat/TTL pair only covers ungraceful drops.
+*/
+function createPresence(client, options) {
+	const intervalMs = options.heartbeatIntervalMs ?? 1e4;
+	let members;
+	let timer;
+	let stopped = false;
+	const beat = () => {
+		if (stopped) return;
+		const meta = typeof options.meta === "function" ? options.meta() : options.meta;
+		client.presenceBeat(options.room, meta);
+	};
+	const tick = () => {
+		timer = void 0;
+		if (stopped) return;
+		beat();
+		timer = setTimeout(tick, intervalMs);
+	};
+	const unsubscribe = client.subscribe(PRESENCE_ROSTER_QUERY, { room: options.room }, (value) => {
+		members = value ?? [];
+		options.onRoster?.(members);
+	}, { room: options.room });
+	tick();
+	return {
+		roster: () => members,
+		beat,
+		stop() {
+			stopped = true;
+			if (timer) clearTimeout(timer);
+			timer = void 0;
+			unsubscribe();
+		}
+	};
 }
+//#endregion
+export { PRESENCE_ROSTER_QUERY, createPresence };
+
+//# sourceMappingURL=presence.js.map

package/dist/presence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence.js","names":[],"sources":["../src/presence.ts"],"sourcesContent":["import type { LiveClient } from './live-client';\nimport type { LiveContract, Unsubscribe } from './types';\n\n/**\n * The built-in roster query name served by `@velajs/vela/live`'s presence\n * preset (`PRESENCE_ROSTER_QUERY` on the server side).\n */\nexport const PRESENCE_ROSTER_QUERY = '$presence.roster';\n\n/** One present connection, as the server's roster query returns it. */\nexport interface PresenceMember {\n  id: string;\n  meta?: unknown;\n  lastSeen: number;\n}\n\nexport interface PresenceOptions {\n  room: string;\n  /** Payload attached to this connection's roster entry (function form re-evaluated per beat). */\n  meta?: unknown | (() => unknown);\n  /** Keep WELL under the server's TTL (default beat 10 000 ms vs 30 000 ms TTL). */\n  heartbeatIntervalMs?: number;\n  onRoster?: (members: PresenceMember[]) => void;\n}\n\nexport interface PresenceHandle {\n  /** The last received roster (undefined until the first push). */\n  roster(): PresenceMember[] | undefined;\n  /** Send an immediate heartbeat (e.g. on visibility regain — the React binding wires this). */\n  beat(): void;\n  stop(): void;\n}\n\n/**\n * Framework-neutral presence: joins a room's roster (heartbeats over the\n * room's live socket) and subscribes to it. Departure is immediate on socket\n * close — the heartbeat/TTL pair only covers ungraceful drops.\n */\nexport function createPresence(\n  client: LiveClient<LiveContract>,\n  options: PresenceOptions,\n): PresenceHandle {\n  const intervalMs = options.heartbeatIntervalMs ?? 10_000;\n  let members: PresenceMember[] | undefined;\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  let stopped = false;\n\n  const beat = (): void => {\n    if (stopped) return;\n    const meta =\n      typeof options.meta === 'function' ? (options.meta as () => unknown)() : options.meta;\n    client.presenceBeat(options.room, meta);\n  };\n\n  const tick = (): void => {\n    timer = undefined;\n    if (stopped) return;\n    beat();\n    timer = setTimeout(tick, intervalMs);\n  };\n\n  const unsubscribe: Unsubscribe = client.subscribe(\n    PRESENCE_ROSTER_QUERY,\n    { room: options.room },\n    (value) => {\n      members = (value ?? []) as PresenceMember[];\n      options.onRoster?.(members);\n    },\n    { room: options.room },\n  );\n\n  // First beat rides after the subscription so the socket is being opened.\n  tick();\n\n  return {\n    roster: () => members,\n    beat,\n    stop() {\n      stopped = true;\n      if (timer) clearTimeout(timer);\n      timer = undefined;\n      unsubscribe();\n    },\n  };\n}\n"],"mappings":";;;;;AAOA,MAAa,wBAAwB;;;;;;AA+BrC,SAAgB,eACd,QACA,SACgB;CAChB,MAAM,aAAa,QAAQ,uBAAuB;CAClD,IAAI;CACJ,IAAI;CACJ,IAAI,UAAU;CAEd,MAAM,aAAmB;EACvB,IAAI,SAAS;EACb,MAAM,OACJ,OAAO,QAAQ,SAAS,aAAc,QAAQ,KAAuB,IAAI,QAAQ;EACnF,OAAO,aAAa,QAAQ,MAAM,IAAI;CACxC;CAEA,MAAM,aAAmB;EACvB,QAAQ,KAAA;EACR,IAAI,SAAS;EACb,KAAK;EACL,QAAQ,WAAW,MAAM,UAAU;CACrC;CAEA,MAAM,cAA2B,OAAO,UACtC,uBACA,EAAE,MAAM,QAAQ,KAAK,IACpB,UAAU;EACT,UAAW,SAAS,CAAC;EACrB,QAAQ,WAAW,OAAO;CAC5B,GACA,EAAE,MAAM,QAAQ,KAAK,CACvB;CAGA,KAAK;CAEL,OAAO;EACL,cAAc;EACd;EACA,OAAO;GACL,UAAU;GACV,IAAI,OAAO,aAAa,KAAK;GAC7B,QAAQ,KAAA;GACR,YAAY;EACd;CACF;AACF"}

package/package.json

@@ -1,8 +1,34 @@
 {
   "name": "@velajs/client",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Framework-neutral client for Vela live queries: live subscriptions over WebSocket, keyed deltas, cursor-gated optimistic updates, reconnect with resume",
+  "keywords": [
+    "client",
+    "live-queries",
+    "optimistic-updates",
+    "realtime",
+    "vela",
+    "websocket"
+  ],
+  "homepage": "https://github.com/velajs/client#readme",
+  "bugs": {
+    "url": "https://github.com/velajs/client/issues"
+  },
+  "license": "MIT",
+  "author": "ksh",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/velajs/client.git",
+    "directory": "packages/client"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
   "type": "module",
+  "sideEffects": false,
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
@@ -15,48 +41,22 @@
       "import": "./dist/presence.js"
     }
   },
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE",
-    "CHANGELOG.md"
-  ],
-  "sideEffects": false,
-  "keywords": [
-    "vela",
-    "live-queries",
-    "realtime",
-    "websocket",
-    "optimistic-updates",
-    "client"
-  ],
-  "author": "ksh",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/velajs/client.git",
-    "directory": "packages/client"
-  },
-  "homepage": "https://github.com/velajs/client#readme",
-  "bugs": {
-    "url": "https://github.com/velajs/client/issues"
-  },
-  "engines": {
-    "node": ">=20"
-  },
   "dependencies": {
     "@velajs/live-protocol": "^1.0.0"
   },
   "devDependencies": {
-    "@swc/cli": "^0.8.1",
     "@swc/core": "^1.15.43",
-    "typescript": "^6.0.3",
+    "@velajs/vela": "^1.17.0",
+    "tsdown": "^0.22.4",
+    "typescript": "^7.0.2",
     "unplugin-swc": "^1.5.9",
-    "vitest": "^4.1.9",
-    "@velajs/vela": "^1.17.0"
+    "vitest": "^4.1.10"
+  },
+  "engines": {
+    "node": ">=24"
   },
   "scripts": {
-    "build": "rm -rf dist && swc src -d dist --strip-leading-paths && tsc --emitDeclarationOnly",
+    "build": "tsdown",
     "test": "vitest run",
     "typecheck": "tsc --noEmit"
   }

package/dist/connection.d.ts

@@ -1,43 +0,0 @@
-import type { SubscriptionState } from './subscription';
-import type { ConnectionStatus, ReconnectOptions, WebSocketFactory } from './types';
-export interface ConnectionDeps {
-    makeSocket: WebSocketFactory;
-    authToken?: () => string | undefined | Promise<string | undefined>;
-    heartbeatIntervalMs: number;
-    reconnect?: ReconnectOptions;
-    onStatusChange: () => void;
-}
-/**
- * One socket per room (vela's node transport auto-joins the `:id` route
- * param's room; Cloudflare is one-DO≈one-room), multiplexing every live
- * subscription for that room. Owns: connect/reconnect (decorrelated jitter),
- * resubscribe-with-cursor on open, app-level ping keepalive (self-rescheduling
- * setTimeout — never setInterval), and inbound `$live` frame routing into the
- * pure frame reducer.
- */
-export declare class RoomConnection {
-    private readonly url;
-    private readonly deps;
-    status: ConnectionStatus;
-    private socket?;
-    private readonly bySub;
-    private readonly reconnectState;
-    private reconnectTimer?;
-    private heartbeatTimer?;
-    private closedByUser;
-    private generation;
-    constructor(url: string, deps: ConnectionDeps);
-    register(state: SubscriptionState): void;
-    unregister(state: SubscriptionState): void;
-    sendPresence(room: string, meta?: unknown): void;
-    close(): void;
-    private ensureConnected;
-    private connect;
-    private handleMessage;
-    private sendSub;
-    private sendFrame;
-    private scheduleReconnect;
-    private scheduleHeartbeat;
-    private clearTimers;
-    private setStatus;
-}

package/dist/connection.js

@@ -1,215 +0,0 @@
-import { LIVE_PROTOCOL, encodeLiveEnvelope, isServerLiveFrame, readLiveEnvelope } from "@velajs/live-protocol";
-import { applyServerFrame } from "./frame-reducer.js";
-import { nextReconnectDelay, resetReconnect } from "./reconnect.js";
-import { notify } from "./subscription.js";
-const OPEN = 1;
-/**
- * One socket per room (vela's node transport auto-joins the `:id` route
- * param's room; Cloudflare is one-DO≈one-room), multiplexing every live
- * subscription for that room. Owns: connect/reconnect (decorrelated jitter),
- * resubscribe-with-cursor on open, app-level ping keepalive (self-rescheduling
- * setTimeout — never setInterval), and inbound `$live` frame routing into the
- * pure frame reducer.
- */ export class RoomConnection {
-    url;
-    deps;
-    status = 'idle';
-    socket;
-    bySub = new Map();
-    reconnectState = {};
-    reconnectTimer;
-    heartbeatTimer;
-    closedByUser = false;
-    generation = 0;
-    constructor(url, deps){
-        this.url = url;
-        this.deps = deps;
-    }
-    register(state) {
-        this.bySub.set(state.sub, state);
-        if (this.socket?.readyState === OPEN) {
-            this.sendSub(state);
-        } else {
-            this.ensureConnected();
-        }
-    }
-    unregister(state) {
-        this.bySub.delete(state.sub);
-        this.sendFrame({
-            t: 'unsub',
-            sub: state.sub
-        });
-    }
-    sendPresence(room, meta) {
-        this.ensureConnected();
-        this.sendFrame({
-            t: 'presence',
-            room,
-            meta
-        });
-    }
-    close() {
-        this.closedByUser = true;
-        this.clearTimers();
-        this.socket?.close(1000, 'client closed');
-        this.socket = undefined;
-        this.setStatus('closed');
-    }
-    ensureConnected() {
-        if (this.closedByUser) return;
-        if (this.socket && this.socket.readyState <= OPEN) return; // CONNECTING or OPEN
-        void this.connect();
-    }
-    async connect() {
-        this.setStatus('connecting');
-        const generation = ++this.generation;
-        let token;
-        try {
-            token = await this.deps.authToken?.();
-        } catch  {
-            // A failing token provider is treated as a connection failure: back off
-            // and retry — the next attempt re-invokes it (rotation-friendly).
-            if (generation === this.generation) this.scheduleReconnect();
-            return;
-        }
-        if (generation !== this.generation || this.closedByUser) return;
-        const url = token === undefined ? this.url : `${this.url}${this.url.includes('?') ? '&' : '?'}token=${encodeURIComponent(token)}`;
-        let socket;
-        try {
-            socket = this.deps.makeSocket(url);
-        } catch  {
-            this.scheduleReconnect();
-            return;
-        }
-        this.socket = socket;
-        socket.onopen = ()=>{
-            if (generation !== this.generation) return;
-            resetReconnect(this.reconnectState);
-            this.setStatus('connected');
-            // Resubscribe everything with resume watermarks — the server answers
-            // each with data (re-run), resume (untouched), or a cold snapshot.
-            for (const state of this.bySub.values())this.sendSub(state);
-            this.scheduleHeartbeat();
-        };
-        socket.onmessage = (event)=>{
-            if (typeof event.data !== 'string') return;
-            this.handleMessage(event.data);
-        };
-        socket.onclose = ()=>{
-            if (generation !== this.generation) return;
-            this.clearTimers();
-            this.socket = undefined;
-            if (this.closedByUser) return;
-            this.setStatus('offline');
-            this.scheduleReconnect();
-        };
-        socket.onerror = ()=>{
-        // onclose follows; nothing to do here.
-        };
-    }
-    handleMessage(raw) {
-        let envelope;
-        try {
-            envelope = JSON.parse(raw);
-        } catch  {
-            return;
-        }
-        const frame = readLiveEnvelope(envelope);
-        if (frame === undefined || !isServerLiveFrame(frame)) return; // classic gateway events / pong / unknown frames
-        const sub = 'sub' in frame ? frame.sub : undefined;
-        const state = sub === undefined ? undefined : this.bySub.get(sub);
-        if (!state) return;
-        const effect = applyServerFrame(state, frame);
-        switch(effect){
-            case 'notify':
-                notify(state);
-                return;
-            case 'error':
-                if (frame.t === 'error') {
-                    for (const callback of state.errorCallbacks){
-                        callback({
-                            code: frame.code,
-                            message: frame.message,
-                            fatal: frame.fatal
-                        });
-                    }
-                }
-                return;
-            case 'resubscribe':
-                // Unusable cache (epoch fork mid-delta / unmergeable delta): start
-                // cold. Same wire id ⇒ unsub first so the server replaces the record.
-                state.hasBase = false;
-                state.serverBase = undefined;
-                state.serverCursor = undefined;
-                state.serverEpoch = undefined;
-                this.sendFrame({
-                    t: 'unsub',
-                    sub: state.sub
-                });
-                this.sendSub(state);
-                return;
-            case 'none':
-                return;
-        }
-    }
-    sendSub(state) {
-        const frame = {
-            t: 'sub',
-            sub: state.sub,
-            query: state.query,
-            ...state.args === undefined ? {} : {
-                args: state.args
-            },
-            ...state.serverCursor !== undefined && state.serverEpoch !== undefined ? {
-                sinceCursor: state.serverCursor,
-                sinceEpoch: state.serverEpoch
-            } : {},
-            ...state.key === undefined ? {} : {
-                key: state.key
-            },
-            v: LIVE_PROTOCOL
-        };
-        this.sendFrame(frame);
-    }
-    sendFrame(frame) {
-        if (this.socket?.readyState !== OPEN) return; // onopen resends subscriptions
-        try {
-            this.socket.send(encodeLiveEnvelope(frame));
-        } catch  {
-        // socket died between the readyState check and send — onclose recovers
-        }
-    }
-    scheduleReconnect() {
-        if (this.closedByUser || this.reconnectTimer) return;
-        const delay = nextReconnectDelay(this.reconnectState, this.deps.reconnect?.baseMs, this.deps.reconnect?.capMs);
-        this.reconnectTimer = setTimeout(()=>{
-            this.reconnectTimer = undefined;
-            void this.connect();
-        }, delay);
-    }
-    scheduleHeartbeat() {
-        if (this.heartbeatTimer) return;
-        const tick = ()=>{
-            this.heartbeatTimer = undefined;
-            if (this.socket?.readyState !== OPEN) return;
-            try {
-                this.socket.send('{"event":"ping"}');
-            } catch  {
-                return;
-            }
-            this.heartbeatTimer = setTimeout(tick, this.deps.heartbeatIntervalMs);
-        };
-        this.heartbeatTimer = setTimeout(tick, this.deps.heartbeatIntervalMs);
-    }
-    clearTimers() {
-        if (this.reconnectTimer) clearTimeout(this.reconnectTimer);
-        if (this.heartbeatTimer) clearTimeout(this.heartbeatTimer);
-        this.reconnectTimer = undefined;
-        this.heartbeatTimer = undefined;
-    }
-    setStatus(status) {
-        if (this.status === status) return;
-        this.status = status;
-        this.deps.onStatusChange();
-    }
-}

package/dist/errors.d.ts

@@ -1,18 +0,0 @@
-/**
- * The client's error surface — three tiers:
- * - connection-level: surfaced through `onConnectionStatus('offline')`;
- * - subscription-level: `error` frames → `SubscribeOptions.onError`;
- * - mutation-level: `mutate()` rejects with a {@link VelaLiveError}.
- *
- * Follows lunora's zero-dep catalog pattern (one error class, a small code
- * union, structural guards) inlined rather than published separately.
- */
-export declare class VelaLiveError extends Error {
-    readonly code: string;
-    readonly status?: number | undefined;
-    constructor(code: string, message: string, status?: number | undefined);
-}
-export declare const isVelaLiveError: (value: unknown) => value is VelaLiveError;
-export declare const getErrorCode: (value: unknown) => string | undefined;
-/** Decode an HTTP error response into a VelaLiveError (vela's `{ error | message }` shapes tolerated). */
-export declare const toMutationError: (response: Response) => Promise<VelaLiveError>;

package/dist/errors.js

@@ -1,36 +0,0 @@
-/**
- * The client's error surface — three tiers:
- * - connection-level: surfaced through `onConnectionStatus('offline')`;
- * - subscription-level: `error` frames → `SubscribeOptions.onError`;
- * - mutation-level: `mutate()` rejects with a {@link VelaLiveError}.
- *
- * Follows lunora's zero-dep catalog pattern (one error class, a small code
- * union, structural guards) inlined rather than published separately.
- */ export class VelaLiveError extends Error {
-    code;
-    status;
-    constructor(code, message, status){
-        super(message), this.code = code, this.status = status;
-        this.name = 'VelaLiveError';
-    }
-}
-export const isVelaLiveError = (value)=>value instanceof VelaLiveError || typeof value === 'object' && value !== null && value.name === 'VelaLiveError' && typeof value.code === 'string';
-export const getErrorCode = (value)=>isVelaLiveError(value) ? value.code : undefined;
-/** Decode an HTTP error response into a VelaLiveError (vela's `{ error | message }` shapes tolerated). */ export const toMutationError = async (response)=>{
-    let code = `http_${response.status}`;
-    let message = response.statusText || `mutation failed with status ${response.status}`;
-    try {
-        const body = await response.json();
-        if (typeof body.error === 'object' && body.error !== null) {
-            code = body.error.code ?? code;
-            message = body.error.message ?? message;
-        } else if (typeof body.error === 'string') {
-            message = body.error;
-        } else if (typeof body.message === 'string') {
-            message = body.message;
-        }
-    } catch  {
-    // non-JSON body — keep the status-derived error
-    }
-    return new VelaLiveError(code, message, response.status);
-};

package/dist/frame-reducer.d.ts

@@ -1,17 +0,0 @@
-import type { ServerLiveFrame } from '@velajs/live-protocol';
-import type { SubscriptionState } from './subscription';
-/**
- * What the connection layer must do after a frame was applied:
- * - `notify` — the displayed value changed, fire callbacks;
- * - `resubscribe` — the cache is unusable (epoch fork mid-delta, unmergeable
- *   delta); send a fresh cold `sub` for this state;
- * - `error` — an error frame; route to error callbacks;
- * - `none` — bookkeeping only.
- */
-export type FrameEffect = 'none' | 'notify' | 'resubscribe' | 'error';
-/**
- * The pure per-subscription frame state machine (adapts lunora's
- * `handleDataMessage`/`handleResumeMessage`/`handleSettledMessage`).
- * Deliberately socket-free so the protocol semantics are unit-testable.
- */
-export declare function applyServerFrame(state: SubscriptionState, frame: ServerLiveFrame): FrameEffect;

package/dist/frame-reducer.js

@@ -1,66 +0,0 @@
-import { DEFAULT_KEY_FIELD, applyListDelta } from "@velajs/live-protocol";
-import { dropConfirmedLayers } from "./optimistic.js";
-import { refold } from "./subscription.js";
-/**
- * The pure per-subscription frame state machine (adapts lunora's
- * `handleDataMessage`/`handleResumeMessage`/`handleSettledMessage`).
- * Deliberately socket-free so the protocol semantics are unit-testable.
- */ export function applyServerFrame(state, frame) {
-    switch(frame.t){
-        case 'ack':
-            state.acked = true;
-            return 'none';
-        case 'error':
-            return 'error';
-        case 'resume':
-            {
-                // Nothing relevant changed while away: keep the cached value, advance
-                // the watermark. Confirmed layers the new cursor covers still drop.
-                state.serverCursor = frame.cursor;
-                state.serverEpoch = frame.epoch;
-                const dropped = dropConfirmedLayers(state, frame.cursor, frame.epoch);
-                return dropped && refold(state) ? 'notify' : 'none';
-            }
-        case 'settled':
-            {
-                // Byte-identical re-run: no payload, but the cursor advance is what
-                // drops optimistic layers for writes that didn't change this query.
-                advanceWatermark(state, frame.cursor, frame.epoch);
-                const dropped = dropConfirmedLayers(state, frame.cursor, frame.epoch);
-                return dropped && refold(state) ? 'notify' : 'none';
-            }
-        case 'data':
-            {
-                if (epochForked(state, frame.epoch)) {
-                    // New timeline: every optimistic gate is void. The snapshot itself is
-                    // authoritative, so apply it as a cold first frame.
-                    state.layers = [];
-                }
-                state.serverBase = frame.snapshot;
-                state.hasBase = true;
-                advanceWatermark(state, frame.cursor, frame.epoch);
-                dropConfirmedLayers(state, frame.cursor, frame.epoch);
-                refold(state);
-                return 'notify';
-            }
-        case 'delta':
-            {
-                // A delta diffs against the baseline the server believes we confirmed —
-                // across an epoch fork or without a base that belief is wrong by
-                // construction: start over.
-                if (epochForked(state, frame.epoch) || !state.hasBase) return 'resubscribe';
-                const merged = applyListDelta(state.serverBase, frame.ops, state.key ?? DEFAULT_KEY_FIELD);
-                if (merged === undefined) return 'resubscribe';
-                state.serverBase = merged;
-                advanceWatermark(state, frame.cursor, frame.epoch);
-                dropConfirmedLayers(state, frame.cursor, frame.epoch);
-                refold(state);
-                return 'notify';
-            }
-    }
-}
-const epochForked = (state, epoch)=>epoch !== undefined && state.serverEpoch !== undefined && epoch !== state.serverEpoch;
-function advanceWatermark(state, cursor, epoch) {
-    if (cursor !== undefined) state.serverCursor = cursor;
-    if (epoch !== undefined) state.serverEpoch = epoch;
-}

package/dist/live-client.d.ts

@@ -1,44 +0,0 @@
-import type { ArgsOf, ConnectionStatus, HydrationEntry, LiveClientOptions, LiveContract, MutateOptions, ResultOf, SubscribeOptions, Unsubscribe } from './types';
-/**
- * The framework-neutral Vela live client.
- *
- * ```ts
- * const client = new LiveClient<AppLive>({ url: 'https://api.example.com' });
- * const stop = client.subscribe('todos.list', { listId: 'l1' }, (todos) => render(todos));
- * await client.mutate('/todos', { text: 'hi' }, {
- *   optimistic: { query: 'todos.list', args: { listId: 'l1' }, apply: (t = []) => [...t, temp] },
- * });
- * ```
- *
- * Identical `(query, args, room)` subscriptions share one wire registration;
- * reconnects resubscribe with the last cursor+epoch so untouched
- * subscriptions resume without a re-run; optimistic updates are rebaseable
- * layers gated on the mutation's `Vela-Commit-Cursor` response header.
- */
-export declare class LiveClient<C extends LiveContract = LiveContract> {
-    private readonly options;
-    private readonly registry;
-    private readonly connections;
-    private readonly statusListeners;
-    private lastStatus;
-    constructor(options: LiveClientOptions);
-    subscribe<Q extends keyof C & string>(query: Q, args: ArgsOf<C, Q>, callback: (value: ResultOf<C, Q> | undefined) => void, subscribeOptions?: SubscribeOptions): Unsubscribe;
-    /** The current cached (folded) value — referentially stable between notifications. */
-    peek<Q extends keyof C & string>(query: Q, args: ArgsOf<C, Q>, room?: string): ResultOf<C, Q> | undefined;
-    /**
-     * Fire an HTTP mutation. Optimistic targets paint immediately; the layer
-     * drops when a subscription frame's cursor passes the response's
-     * `Vela-Commit-Cursor` (missing header ⇒ one-shot optimism); a rejection
-     * rolls back. Resolves with the parsed JSON body (undefined when empty).
-     */
-    mutate<R = unknown>(path: string, body?: unknown, mutateOptions?: MutateOptions): Promise<R>;
-    /** Presence heartbeat for a room (see `@velajs/client/presence` for the managed preset). */
-    presenceBeat(room: string, meta?: unknown): void;
-    /** Seed subscription state before connecting (SSR hydration). Subscribes then resume from the seeded cursor. */
-    hydrate(entries: HydrationEntry[]): void;
-    connectionStatus(): ConnectionStatus;
-    onConnectionStatus(listener: (status: ConnectionStatus) => void): Unsubscribe;
-    close(): void;
-    private makeStore;
-    private connectionFor;
-}