@replit/river 0.10.0 → 0.10.1

package/dist/transport/transport.js

@@ -1,281 +0,0 @@
-import { Value } from '@sinclair/typebox/value';
-import { OpaqueTransportMessageSchema, TransportAckSchema, isAck, reply, } from './message';
-import { log } from '../logging';
-import { EventDispatcher } from './events';
-/**
- * A 1:1 connection between two transports. Once this is created,
- * the {@link Connection} is expected to take over responsibility for
- * reading and writing messages from the underlying connection.
- *
- * 1) Messages received on the {@link Connection} are dispatched back to the {@link Transport}
- *    via {@link Transport.onMessage}. The {@link Transport} then notifies any registered message listeners.
- * 2) When {@link Transport.send}(msg) is called, the transport looks up the appropriate
- *    connection in the {@link connections} map via `msg.to` and calls {@link send}(bytes)
- *    so the connection can send it.
- */
-export class Connection {
-    connectedTo;
-    transport;
-    constructor(transport, connectedTo) {
-        this.connectedTo = connectedTo;
-        this.transport = transport;
-    }
-}
-/**
- * Transports manage the lifecycle (creation/deletion) of connections. Its responsibilities include:
- *
- *  1) Constructing a new {@link Connection} on {@link TransportMessage}s from new clients.
- *     After constructing the {@link Connection}, {@link onConnect} is called which adds it to the connection map.
- *  2) Delegating message listening of the connection to the newly created {@link Connection}.
- *     From this point on, the {@link Connection} is responsible for *reading* and *writing*
- *     messages from the connection.
- *  3) When a connection is closed, the {@link Transport} calls {@link onDisconnect} which closes the
- *     connection via {@link Connection.close} and removes it from the {@link connections} map.
-
- *
- * ```plaintext
- *            ▲
- *  incoming  │
- *  messages  │
- *            ▼
- *      ┌─────────────┐   1:N   ┌────────────┐
- *      │  Transport  │ ◄─────► │ Connection │
- *      └─────────────┘         └────────────┘
- *            ▲
- *            │
- *            ▼
- *      ┌───────────┐
- *      │ Message   │
- *      │ Listeners │
- *      └───────────┘
- * ```
- * @abstract
- */
-export class Transport {
-    /**
-     * A flag indicating whether the transport has been destroyed.
-     * A destroyed transport will not attempt to reconnect and cannot be used again.
-     */
-    state;
-    /**
-     * The {@link Codec} used to encode and decode messages.
-     */
-    codec;
-    /**
-     * The client ID of this transport.
-     */
-    clientId;
-    /**
-     * An array of message IDs that are waiting to be sent over the WebSocket connection.
-     * This builds up if the WebSocket is down for a period of time.
-     */
-    sendQueue;
-    /**
-     * The buffer of messages that have been sent but not yet acknowledged.
-     */
-    sendBuffer;
-    /**
-     * The map of {@link Connection}s managed by this transport.
-     */
-    connections;
-    /**
-     * The event dispatcher for handling events of type EventTypes.
-     */
-    eventDispatcher;
-    /**
-     * Creates a new Transport instance.
-     * @param codec The codec used to encode and decode messages.
-     * @param clientId The client ID of this transport.
-     */
-    constructor(codec, clientId) {
-        this.eventDispatcher = new EventDispatcher();
-        this.sendBuffer = new Map();
-        this.sendQueue = new Map();
-        this.connections = new Map();
-        this.codec = codec;
-        this.clientId = clientId;
-        this.state = 'open';
-    }
-    /**
-     * The downstream implementation needs to call this when a new connection is established.
-     * @param conn The connection object.
-     */
-    onConnect(conn) {
-        log?.info(`${this.clientId} -- new connection to ${conn.connectedTo}`);
-        this.connections.set(conn.connectedTo, conn);
-        this.eventDispatcher.dispatchEvent('connectionStatus', {
-            status: 'connect',
-            conn,
-        });
-        // send outstanding
-        const outstanding = this.sendQueue.get(conn.connectedTo);
-        if (!outstanding) {
-            return;
-        }
-        for (const id of outstanding) {
-            const msg = this.sendBuffer.get(id);
-            if (!msg) {
-                log?.warn(`${this.clientId} -- tried to resend a message we received an ack for`);
-                continue;
-            }
-            this.send(msg);
-        }
-        this.sendQueue.delete(conn.connectedTo);
-    }
-    /**
-     * The downstream implementation needs to call this when a connection is closed.
-     * @param conn The connection object.
-     */
-    onDisconnect(conn) {
-        log?.info(`${this.clientId} -- disconnect from ${conn.connectedTo}`);
-        conn.close();
-        this.connections.delete(conn.connectedTo);
-        this.eventDispatcher.dispatchEvent('connectionStatus', {
-            status: 'disconnect',
-            conn,
-        });
-    }
-    /**
-     * Handles a message received by this transport. Thin wrapper around {@link handleMsg} and {@link parseMsg}.
-     * @param msg The message to handle.
-     */
-    onMessage(msg) {
-        return this.handleMsg(this.parseMsg(msg));
-    }
-    /**
-     * Parses a message from a Uint8Array into a {@link OpaqueTransportMessage}.
-     * @param msg The message to parse.
-     * @returns The parsed message, or null if the message is malformed or invalid.
-     */
-    parseMsg(msg) {
-        const parsedMsg = this.codec.fromBuffer(msg);
-        if (parsedMsg === null) {
-            const decodedBuffer = new TextDecoder().decode(msg);
-            log?.warn(`${this.clientId} -- received malformed msg: ${decodedBuffer}`);
-            return null;
-        }
-        if (Value.Check(OpaqueTransportMessageSchema, parsedMsg)) {
-            // JSON can't express the difference between `undefined` and `null`, so we need to patch that.
-            return {
-                ...parsedMsg,
-                serviceName: parsedMsg.serviceName === null ? undefined : parsedMsg.serviceName,
-                procedureName: parsedMsg.procedureName === null
-                    ? undefined
-                    : parsedMsg.procedureName,
-            };
-        }
-        else {
-            log?.warn(`${this.clientId} -- received invalid msg: ${JSON.stringify(parsedMsg)}`);
-            return null;
-        }
-    }
-    /**
-     * Called when a message is received by this transport.
-     * You generally shouldn't need to override this in downstream transport implementations.
-     * @param msg The received message.
-     */
-    handleMsg(msg) {
-        if (!msg) {
-            return;
-        }
-        if (isAck(msg.controlFlags) && Value.Check(TransportAckSchema, msg)) {
-            // process ack
-            log?.info(`${this.clientId} -- received ack: ${JSON.stringify(msg)}`);
-            if (this.sendBuffer.has(msg.payload.ack)) {
-                this.sendBuffer.delete(msg.payload.ack);
-            }
-        }
-        else {
-            // regular river message
-            log?.info(`${this.clientId} -- received msg: ${JSON.stringify(msg)}`);
-            if (msg.to !== this.clientId) {
-                return;
-            }
-            this.eventDispatcher.dispatchEvent('message', msg);
-            if (!isAck(msg.controlFlags)) {
-                const ackMsg = reply(msg, { ack: msg.id });
-                ackMsg.controlFlags = 1 /* ControlFlags.AckBit */;
-                ackMsg.from = this.clientId;
-                this.send(ackMsg);
-            }
-        }
-    }
-    /**
-     * Adds a listener to this transport.
-     * @param the type of event to listen for
-     * @param handler The message handler to add.
-     */
-    addEventListener(type, handler) {
-        this.eventDispatcher.addEventListener(type, handler);
-    }
-    /**
-     * Removes a listener from this transport.
-     * @param the type of event to unlisten on
-     * @param handler The message handler to remove.
-     */
-    removeEventListener(type, handler) {
-        this.eventDispatcher.removeEventListener(type, handler);
-    }
-    /**
-     * Sends a message over this transport, delegating to the appropriate connection to actually
-     * send the message.
-     * @param msg The message to send.
-     * @returns The ID of the sent message.
-     */
-    send(msg) {
-        if (this.state === 'destroyed') {
-            const err = 'transport is destroyed, cant send';
-            log?.error(`${this.clientId} -- ` + err + `: ${JSON.stringify(msg)}`);
-            throw new Error(err);
-        }
-        else if (this.state === 'closed') {
-            log?.info(`${this.clientId} -- transport closed when sending, discarding : ${JSON.stringify(msg)}`);
-            return msg.id;
-        }
-        let conn = this.connections.get(msg.to);
-        // we only use sendBuffer to track messages that we expect an ack from,
-        // messages with the ack flag are not responded to
-        if (!isAck(msg.controlFlags)) {
-            this.sendBuffer.set(msg.id, msg);
-        }
-        if (conn) {
-            log?.info(`${this.clientId} -- sending ${JSON.stringify(msg)}`);
-            const ok = conn.send(this.codec.toBuffer(msg));
-            if (ok) {
-                return msg.id;
-            }
-        }
-        log?.info(`${this.clientId} -- connection to ${msg.to} not ready, attempting reconnect and queuing ${JSON.stringify(msg)}`);
-        const outstanding = this.sendQueue.get(msg.to) || [];
-        outstanding.push(msg.id);
-        this.sendQueue.set(msg.to, outstanding);
-        this.createNewConnection(msg.to);
-        return msg.id;
-    }
-    /**
-     * Default close implementation for transports. You should override this in the downstream
-     * implementation if you need to do any additional cleanup and call super.close() at the end.
-     * Closes the transport. Any messages sent while the transport is closed will be silently discarded.
-     */
-    async close() {
-        for (const conn of this.connections.values()) {
-            conn.close();
-        }
-        this.connections.clear();
-        this.state = 'closed';
-        log?.info(`${this.clientId} -- closed transport`);
-    }
-    /**
-     * Default destroy implementation for transports. You should override this in the downstream
-     * implementation if you need to do any additional cleanup and call super.destroy() at the end.
-     * Destroys the transport. Any messages sent while the transport is destroyed will throw an error.
-     */
-    async destroy() {
-        for (const conn of this.connections.values()) {
-            conn.close();
-        }
-        this.connections.clear();
-        this.state = 'destroyed';
-        log?.info(`${this.clientId} -- destroyed transport`);
-    }
-}

package/dist/util/testHelpers.d.ts.map

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