wenay-common2 1.0.74 → 1.0.76

package/lib/Common/events/replay-channel.js

@@ -2,6 +2,55 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.serveReplayChannel = serveReplayChannel;
 exports.channelReplayRemote = channelReplayRemote;
+const BASE64 = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
+const REPLAY_BYTES = '__wenayReplayBytes';
+function bytesToBase64(bytes) {
+    let out = '';
+    for (let i = 0; i < bytes.length; i += 3) {
+        const a = bytes[i];
+        const b = bytes[i + 1];
+        const c = bytes[i + 2];
+        out += BASE64[a >> 2];
+        out += BASE64[((a & 3) << 4) | ((b ?? 0) >> 4)];
+        out += b == null ? '=' : BASE64[((b & 15) << 2) | ((c ?? 0) >> 6)];
+        out += c == null ? '=' : BASE64[c & 63];
+    }
+    return out;
+}
+function base64ToBytes(text) {
+    const clean = text.replace(/=+$/, '');
+    const out = new Uint8Array(Math.floor(clean.length * 3 / 4));
+    let bits = 0;
+    let nBits = 0;
+    let at = 0;
+    for (const char of clean) {
+        const n = BASE64.indexOf(char);
+        if (n < 0)
+            throw new Error('replay channel: invalid binary payload');
+        bits = (bits << 6) | n;
+        nBits += 6;
+        if (nBits < 8)
+            continue;
+        nBits -= 8;
+        out[at++] = (bits >> nBits) & 255;
+    }
+    return out;
+}
+function stringifyMessage(value) {
+    return JSON.stringify(value, function encodeReplayBytes(_key, item) {
+        if (item instanceof Uint8Array)
+            return { [REPLAY_BYTES]: bytesToBase64(item) };
+        return item;
+    });
+}
+function parseMessage(raw) {
+    return JSON.parse(raw, function decodeReplayBytes(_key, item) {
+        if (item != null && typeof item == 'object' && Object.keys(item).length == 1 && typeof item[REPLAY_BYTES] == 'string') {
+            return base64ToBytes(item[REPLAY_BYTES]);
+        }
+        return item;
+    });
+}
 function unsubscribeHandle(handle) {
     if (typeof handle == 'function') {
         handle();
@@ -22,11 +71,11 @@ function serveReplayChannel(source, channel) {
                     : msg.m == 'frame' ? (source.frame ? await source.frame(msg.a[0], msg.a[1]) : null)
                         : undefined;
             if (!closed)
-                channel.send(JSON.stringify({ t: 'res', id: msg.id, ok: true, v: v ?? null }));
+                channel.send(stringifyMessage({ t: 'res', id: msg.id, ok: true, v: v ?? null }));
         }
         catch (e) {
             if (!closed)
-                channel.send(JSON.stringify({ t: 'res', id: msg.id, ok: false, e: String(e) }));
+                channel.send(stringifyMessage({ t: 'res', id: msg.id, ok: false, e: String(e) }));
         }
     }
     const offMsg = channel.onMessage(function onReplayChannelMessage(raw) {
@@ -34,7 +83,7 @@ function serveReplayChannel(source, channel) {
             return;
         let msg;
         try {
-            msg = JSON.parse(raw);
+            msg = parseMessage(raw);
         }
         catch {
             return;
@@ -42,7 +91,7 @@ function serveReplayChannel(source, channel) {
         if (msg?.t == 'sub' && !lineOff) {
             lineOff = source.line.on(function forwardEnvelope(ev) {
                 if (!closed)
-                    channel.send(JSON.stringify({ t: 'ev', ev }));
+                    channel.send(stringifyMessage({ t: 'ev', ev }));
             });
             return;
         }
@@ -70,7 +119,7 @@ function channelReplayRemote(channel) {
     channel.onMessage(function onRemoteChannelMessage(raw) {
         let msg;
         try {
-            msg = JSON.parse(raw);
+            msg = parseMessage(raw);
         }
         catch {
             return;
@@ -108,7 +157,7 @@ function channelReplayRemote(channel) {
         return new Promise((resolve, reject) => {
             const id = nextId++;
             pending.set(id, { resolve, reject });
-            channel.send(JSON.stringify({ t: 'req', id, m, a }));
+            channel.send(stringifyMessage({ t: 'req', id, m, a }));
         });
     }
     return {

package/lib/Common/events/replay-route.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.replayRouteSubscribe = replayRouteSubscribe;
+const transport_lifecycle_1 = require("./transport-lifecycle");
 function unsubscribeHandle(handle) {
     if (typeof handle == 'function') {
         handle();
@@ -50,7 +51,8 @@ function replayRouteSubscribe(remote, cb, opts = {}) {
         let replaying = true;
         let lineError;
         const queue = [];
-        const liveLine = policy == 'frame' && nextRemote.frameLine ? nextRemote.frameLine : nextRemote.line;
+        const frameLineState = (0, transport_lifecycle_1.getRpcMemberState)(nextRemote, 'frameLine');
+        const liveLine = policy == 'frame' && frameLineState != false && nextRemote.frameLine ? nextRemote.frameLine : nextRemote.line;
         const handle = liveLine.on(function liveTap(ev) {
             if (slotClosed)
                 return;
@@ -76,7 +78,8 @@ function replayRouteSubscribe(remote, cb, opts = {}) {
         async function catchUp() {
             try {
                 let done = false;
-                if (since >= 0 && nextRemote.frame) {
+                const frameState = (0, transport_lifecycle_1.getRpcMemberState)(nextRemote, 'frame');
+                if (since >= 0 && frameState != false && nextRemote.frame) {
                     const envs = await nextRemote.frame(since, hint);
                     if (slotClosed)
                         return;

package/lib/Common/events/replay-wire.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.exposeReplay = exposeReplay;
 exports.replaySubscribe = replaySubscribe;
 const replay_conflate_1 = require("./replay-conflate");
+const transport_lifecycle_1 = require("./transport-lifecycle");
 function exposeReplayPlain(replay) {
     return {
         line: replay.line,
@@ -29,10 +30,21 @@ function unsubscribeHandle(handle) {
 }
 function replaySubscribe(remote, cb, opts = {}) {
     const { since = -1, onSeq, onError, staleMs, onStale, skewMs = 0, now = Date.now, policy = 'queue', hint } = opts;
+    const lifecycle = (0, transport_lifecycle_1.getRpcTransportLifecycle)(remote);
     let lastDelivered = since;
     let replaying = true;
     let closed = false;
+    let recoveryGeneration = 0;
     const queue = [];
+    let readySettled = false;
+    let resolveReady = function resolveReadyLater() { };
+    const ready = new Promise(function waitUntilReady(resolve) { resolveReady = resolve; });
+    function settleReady() {
+        if (readySettled)
+            return;
+        readySettled = true;
+        resolveReady();
+    }
     let lastTs = 0;
     let lastArrival = now();
     let staleFlag = false;
@@ -95,17 +107,68 @@ function replaySubscribe(remote, cb, opts = {}) {
         if (!replaying)
             assessStale();
     }
-    const liveLine = policy == 'frame' && remote.frameLine ? remote.frameLine : remote.line;
-    const handle = liveLine.on(function liveTap(ev) {
+    function deliverSorted(events, allowReset) {
+        const sorted = [...events].sort((a, b) => a.seq - b.seq);
+        if (allowReset && sorted.length && sorted[0].seq <= lastDelivered) {
+            lastDelivered = sorted[0].seq - 1;
+        }
+        for (const event of sorted)
+            deliver(event);
+    }
+    function drainLiveQueue() {
+        while (queue.length) {
+            const batch = queue.splice(0).sort((a, b) => a.seq - b.seq);
+            for (const event of batch)
+                deliver(event);
+        }
+    }
+    const frameLineState = (0, transport_lifecycle_1.getRpcMemberState)(remote, 'frameLine');
+    const liveLine = policy == 'frame' && frameLineState != false && remote.frameLine ? remote.frameLine : remote.line;
+    let handle = null;
+    let offConnect = function noConnectListener() { };
+    let offDisconnect = function noDisconnectListener() { };
+    let offClose = function noCloseListener() { };
+    function closeSubscription() {
+        if (closed)
+            return false;
+        closed = true;
+        recoveryGeneration++;
+        queue.length = 0;
+        stopStaleTimer();
+        offConnect();
+        offDisconnect();
+        offClose();
+        unsubscribeHandle(handle);
+        settleReady();
+        return true;
+    }
+    function errorText(error) {
+        if (typeof error?.message == 'string')
+            return error.message;
+        if (typeof error?.error?.message == 'string')
+            return error.error.message;
+        return String(error);
+    }
+    function failRecovery(error, point, phase) {
+        const wrapped = new Error('replaySubscribe: ' + phase + ' from seq ' + point + ' failed: ' + errorText(error));
+        wrapped.cause = error;
+        if (!closeSubscription())
+            return;
+        if (onError) {
+            try {
+                onError(wrapped);
+            }
+            catch (caught) {
+                setTimeout(function rethrowOnError() { throw caught; }, 0);
+            }
+        }
+        else {
+            setTimeout(function rethrowRecoveryError() { throw wrapped; }, 0);
+        }
+    }
+    handle = liveLine.on(function liveTap(ev) {
         if (ev == null || typeof ev.seq != 'number') {
-            if (closed)
-                return;
-            const err = new Error('replaySubscribe: line ended by server (' + String(ev) + ')');
-            off();
-            if (onError)
-                onError(err);
-            else
-                setTimeout(function rethrowLineEnd() { throw err; }, 0);
+            failRecovery(new Error('line ended by server (' + String(ev) + ')'), lastDelivered, 'live line');
             return;
         }
         lastArrival = now();
@@ -114,64 +177,91 @@ function replaySubscribe(remote, cb, opts = {}) {
         else
             deliver(ev);
     });
-    async function catchUp() {
+    if (typeof handle?.then == 'function') {
+        handle.then(function logicalLineEnded() {
+            if (!closed)
+                failRecovery(new Error('logical RPC line ended'), lastDelivered, 'live line');
+        }, function logicalLineFailed(error) {
+            if (!closed)
+                failRecovery(error, lastDelivered, 'live line');
+        });
+    }
+    function isCurrent(generation) {
+        return !closed && generation == recoveryGeneration;
+    }
+    async function catchUp(generation, point, initial) {
         try {
             let done = false;
-            if (since >= 0 && remote.frame) {
-                const envs = await remote.frame(since, hint);
-                if (closed)
+            const frameState = (0, transport_lifecycle_1.getRpcMemberState)(remote, 'frame');
+            if (point >= 0 && frameState != false && remote.frame) {
+                const envelopes = await remote.frame(point, hint);
+                if (!isCurrent(generation))
                     return;
-                if (envs) {
-                    if (envs.length) {
-                        lastDelivered = envs[0].seq - 1;
-                        for (const ev of envs)
-                            deliver(ev);
-                    }
+                if (envelopes) {
+                    deliverSorted(envelopes, initial);
                     done = true;
                 }
             }
             if (!done) {
-                const tail = since >= 0 ? await remote.since(since) : null;
-                if (closed)
+                const tail = point >= 0 ? await remote.since(point) : null;
+                if (!isCurrent(generation))
                     return;
                 if (tail) {
-                    for (const ev of tail)
-                        deliver(ev);
+                    deliverSorted(tail, false);
                 }
                 else {
-                    const kf = await remote.keyframe();
-                    if (closed)
+                    const keyframe = await remote.keyframe();
+                    if (!isCurrent(generation))
                         return;
-                    if (kf) {
-                        lastDelivered = kf.seq;
-                        lastTs = kf.ts;
-                        lastArrival = now();
-                        cb(...kf.event);
-                        onSeq?.(kf.seq);
+                    if (keyframe) {
+                        if (initial && keyframe.seq <= lastDelivered)
+                            lastDelivered = keyframe.seq - 1;
+                        deliver(keyframe);
+                    }
+                    else if (point >= 0) {
+                        throw new Error('journal evicted or unavailable; no keyframe can cover the gap');
                     }
                 }
             }
-        }
-        catch (e) {
-            if (onError)
-                onError(e);
-            else
-                setTimeout(function rethrowCatchUp() { throw e; }, 0);
-        }
-        finally {
-            while (queue.length)
-                deliver(queue.shift());
+            if (!isCurrent(generation))
+                return;
+            drainLiveQueue();
             replaying = false;
             assessStale();
+            settleReady();
+        }
+        catch (error) {
+            if (!isCurrent(generation))
+                return;
+            failRecovery(error, point, initial ? 'initial catch-up' : 'reconnect catch-up');
         }
     }
-    const ready = catchUp();
-    function off() {
+    function startCatchUp(initial) {
         if (closed)
             return;
-        closed = true;
-        stopStaleTimer();
-        unsubscribeHandle(handle);
+        replaying = true;
+        const generation = ++recoveryGeneration;
+        void catchUp(generation, lastDelivered, initial);
+    }
+    if (lifecycle) {
+        offDisconnect = lifecycle.onDisconnect(function replayTransportDisconnected() {
+            if (closed)
+                return;
+            replaying = true;
+            recoveryGeneration++;
+            queue.length = 0;
+        });
+        offConnect = lifecycle.onConnect(function replayTransportConnected() {
+            startCatchUp(!readySettled);
+        });
+        offClose = lifecycle.onClose(function replayTransportClosed() {
+            closeSubscription();
+        });
+    }
+    if (!lifecycle || lifecycle.connected())
+        startCatchUp(true);
+    function off() {
+        closeSubscription();
     }
     return Object.assign(off, {
         ready,

package/lib/Common/events/transport-lifecycle.d.ts

@@ -0,0 +1,23 @@
+export declare const RPC_TRANSPORT_LIFECYCLE: unique symbol;
+export declare const RPC_TRANSPORT_CONTROL: unique symbol;
+export declare const RPC_MEMBER_LOOKUP: unique symbol;
+export type RpcMemberLookup = (member: string) => boolean | undefined;
+export declare function getRpcMemberState(remote: any, member: string): boolean | undefined;
+export type TransportLifecycleApi = {
+    connected: () => boolean;
+    closed: () => boolean;
+    generation: () => number;
+    onConnect: (cb: (generation: number) => void) => () => void;
+    onDisconnect: (cb: (reason: string, generation: number) => void) => () => void;
+    onClose: (cb: (reason: string) => void) => () => void;
+};
+export declare function getRpcTransportLifecycle(remote: any): TransportLifecycleApi | undefined;
+export type TransportLifecycleControl = {
+    connect: () => void;
+    disconnect: (reason: string) => void;
+    close: (reason: string) => void;
+};
+export declare function createTransportLifecycle(initialConnected?: boolean): {
+    api: TransportLifecycleApi;
+    control: TransportLifecycleControl;
+};

package/lib/Common/events/transport-lifecycle.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RPC_MEMBER_LOOKUP = exports.RPC_TRANSPORT_CONTROL = exports.RPC_TRANSPORT_LIFECYCLE = void 0;
+exports.getRpcMemberState = getRpcMemberState;
+exports.getRpcTransportLifecycle = getRpcTransportLifecycle;
+exports.createTransportLifecycle = createTransportLifecycle;
+exports.RPC_TRANSPORT_LIFECYCLE = Symbol.for('wenay-common2.rpc.transportLifecycle');
+exports.RPC_TRANSPORT_CONTROL = Symbol.for('wenay-common2.rpc.transportControl');
+exports.RPC_MEMBER_LOOKUP = Symbol.for('wenay-common2.rpc.memberLookup');
+function getRpcMemberState(remote, member) {
+    let lookup;
+    try {
+        const candidate = remote?.[exports.RPC_MEMBER_LOOKUP];
+        if (typeof candidate != 'function')
+            return undefined;
+        if (Object.getOwnPropertyDescriptor(candidate, exports.RPC_MEMBER_LOOKUP)?.value != true)
+            return undefined;
+        lookup = candidate;
+    }
+    catch {
+        return undefined;
+    }
+    return lookup(member);
+}
+function getRpcTransportLifecycle(remote) {
+    try {
+        const candidate = remote?.[exports.RPC_TRANSPORT_LIFECYCLE];
+        if (candidate == null || (typeof candidate != 'object' && typeof candidate != 'function'))
+            return undefined;
+        if (Object.getOwnPropertyDescriptor(candidate, exports.RPC_TRANSPORT_LIFECYCLE)?.value != true)
+            return undefined;
+        return candidate;
+    }
+    catch {
+        return undefined;
+    }
+}
+function createTransportLifecycle(initialConnected = true) {
+    let online = initialConnected;
+    let terminal = false;
+    let generation = initialConnected ? 1 : 0;
+    const connectCbs = new Set();
+    const disconnectCbs = new Set();
+    const closeCbs = new Set();
+    function onConnect(cb) {
+        connectCbs.add(cb);
+        return function offConnect() { connectCbs.delete(cb); };
+    }
+    function onDisconnect(cb) {
+        disconnectCbs.add(cb);
+        return function offDisconnect() { disconnectCbs.delete(cb); };
+    }
+    function onClose(cb) {
+        closeCbs.add(cb);
+        return function offClose() { closeCbs.delete(cb); };
+    }
+    function connect() {
+        if (terminal || online)
+            return;
+        online = true;
+        generation++;
+        for (const cb of [...connectCbs])
+            cb(generation);
+    }
+    function disconnect(reason) {
+        if (terminal || !online)
+            return;
+        online = false;
+        for (const cb of [...disconnectCbs])
+            cb(reason, generation);
+    }
+    function close(reason) {
+        if (terminal)
+            return;
+        terminal = true;
+        online = false;
+        for (const cb of [...closeCbs])
+            cb(reason);
+        connectCbs.clear();
+        disconnectCbs.clear();
+        closeCbs.clear();
+    }
+    const api = {
+        connected: () => online,
+        closed: () => terminal,
+        generation: () => generation,
+        onConnect,
+        onDisconnect,
+        onClose,
+    };
+    Object.defineProperty(api, exports.RPC_TRANSPORT_LIFECYCLE, { value: true });
+    const control = { connect, disconnect, close };
+    return { api, control };
+}