@replit/river 0.10.0 → 0.10.1

package/dist/__tests__/e2e.test.js

@@ -1,317 +0,0 @@
-import { afterAll, assert, describe, expect, test } from 'vitest';
-import { createLocalWebSocketClient, createWebSocketServer, createWsTransports, iterNext, onServerReady, } from '../util/testHelpers';
-import { createServer } from '../router/server';
-import { createClient } from '../router/client';
-import http from 'http';
-import { BinaryFileServiceConstructor, DIV_BY_ZERO, FallibleServiceConstructor, OrderingServiceConstructor, STREAM_ERROR, SubscribableServiceConstructor, UploadableServiceConstructor, TestServiceConstructor, } from './fixtures/services';
-import { UNCAUGHT_ERROR } from '../router/result';
-import { codecs } from '../codec/codec.test';
-import { WebSocketClientTransport } from '../transport/impls/ws/client';
-import { WebSocketServerTransport } from '../transport/impls/ws/server';
-import { testFinishesCleanly } from './fixtures/cleanup';
-import { buildServiceDefs } from '../router/defs';
-describe.each(codecs)('client <-> server integration test ($name codec)', async ({ codec }) => {
-    const httpServer = http.createServer();
-    const port = await onServerReady(httpServer);
-    const webSocketServer = await createWebSocketServer(httpServer);
-    const getTransports = () => createWsTransports(port, webSocketServer, codec);
-    afterAll(() => {
-        webSocketServer.close();
-        httpServer.close();
-    });
-    test('rpc', async () => {
-        const [clientTransport, serverTransport] = getTransports();
-        const serviceDefs = buildServiceDefs([TestServiceConstructor()]);
-        const server = createServer(serverTransport, serviceDefs);
-        const client = createClient(clientTransport);
-        const result = await client.test.add.rpc({ n: 3 });
-        assert(result.ok);
-        expect(result.payload).toStrictEqual({ result: 3 });
-        await testFinishesCleanly({
-            clientTransports: [clientTransport],
-            serverTransport,
-            server,
-        });
-    });
-    test('fallible rpc', async () => {
-        const [clientTransport, serverTransport] = getTransports();
-        const serviceDefs = buildServiceDefs([FallibleServiceConstructor()]);
-        const server = createServer(serverTransport, serviceDefs);
-        const client = createClient(clientTransport);
-        const result = await client.fallible.divide.rpc({ a: 10, b: 2 });
-        assert(result.ok);
-        expect(result.payload).toStrictEqual({ result: 5 });
-        const result2 = await client.fallible.divide.rpc({ a: 10, b: 0 });
-        assert(!result2.ok);
-        expect(result2.payload).toStrictEqual({
-            code: DIV_BY_ZERO,
-            message: 'Cannot divide by zero',
-            extras: {
-                test: 'abc',
-            },
-        });
-        await testFinishesCleanly({
-            clientTransports: [clientTransport],
-            serverTransport,
-            server,
-        });
-    });
-    test('rpc with binary (uint8array)', async () => {
-        const [clientTransport, serverTransport] = getTransports();
-        const serviceDefs = buildServiceDefs([BinaryFileServiceConstructor()]);
-        const server = createServer(serverTransport, serviceDefs);
-        const client = createClient(clientTransport);
-        const result = await client.bin.getFile.rpc({ file: 'test.py' });
-        assert(result.ok);
-        assert(result.payload.contents instanceof Uint8Array);
-        expect(new TextDecoder().decode(result.payload.contents)).toStrictEqual('contents for file test.py');
-        await testFinishesCleanly({
-            clientTransports: [clientTransport],
-            serverTransport,
-            server,
-        });
-    });
-    test('stream', async () => {
-        const [clientTransport, serverTransport] = getTransports();
-        const serviceDefs = buildServiceDefs([TestServiceConstructor()]);
-        const server = createServer(serverTransport, serviceDefs);
-        const client = createClient(clientTransport);
-        const [input, output, close] = await client.test.echo.stream();
-        input.push({ msg: 'abc', ignore: false });
-        input.push({ msg: 'def', ignore: true });
-        input.push({ msg: 'ghi', ignore: false });
-        input.push({ msg: 'end', ignore: false, end: true });
-        input.end();
-        const result1 = await iterNext(output);
-        assert(result1.ok);
-        expect(result1.payload).toStrictEqual({ response: 'abc' });
-        const result2 = await iterNext(output);
-        assert(result2.ok);
-        expect(result2.payload).toStrictEqual({ response: 'ghi' });
-        const result3 = await iterNext(output);
-        assert(result3.ok);
-        expect(result3.payload).toStrictEqual({ response: 'end' });
-        // after the server stream is ended, the client stream should be ended too
-        const result4 = await output.next();
-        assert(result4.done);
-        close();
-        await testFinishesCleanly({
-            clientTransports: [clientTransport],
-            serverTransport,
-            server,
-        });
-    });
-    test('stream with init message', async () => {
-        const [clientTransport, serverTransport] = getTransports();
-        const serviceDefs = buildServiceDefs([TestServiceConstructor()]);
-        const server = createServer(serverTransport, serviceDefs);
-        const client = createClient(clientTransport);
-        const [input, output, close] = await client.test.echoWithPrefix.stream({
-            prefix: 'test',
-        });
-        input.push({ msg: 'abc', ignore: false });
-        input.push({ msg: 'def', ignore: true });
-        input.push({ msg: 'ghi', ignore: false });
-        input.end();
-        const result1 = await iterNext(output);
-        assert(result1.ok);
-        expect(result1.payload).toStrictEqual({ response: 'test abc' });
-        const result2 = await iterNext(output);
-        assert(result2.ok);
-        expect(result2.payload).toStrictEqual({ response: 'test ghi' });
-        close();
-        await testFinishesCleanly({
-            clientTransports: [clientTransport],
-            serverTransport,
-            server,
-        });
-    });
-    test('fallible stream', async () => {
-        const [clientTransport, serverTransport] = getTransports();
-        const serviceDefs = buildServiceDefs([FallibleServiceConstructor()]);
-        const server = createServer(serverTransport, serviceDefs);
-        const client = createClient(clientTransport);
-        const [input, output, close] = await client.fallible.echo.stream();
-        input.push({ msg: 'abc', throwResult: false, throwError: false });
-        const result1 = await iterNext(output);
-        assert(result1 && result1.ok);
-        expect(result1.payload).toStrictEqual({ response: 'abc' });
-        input.push({ msg: 'def', throwResult: true, throwError: false });
-        const result2 = await iterNext(output);
-        assert(result2 && !result2.ok);
-        expect(result2.payload.code).toStrictEqual(STREAM_ERROR);
-        input.push({ msg: 'ghi', throwResult: false, throwError: true });
-        const result3 = await iterNext(output);
-        assert(result3 && !result3.ok);
-        expect(result3.payload).toStrictEqual({
-            code: UNCAUGHT_ERROR,
-            message: 'some message',
-        });
-        close();
-        await testFinishesCleanly({
-            clientTransports: [clientTransport],
-            serverTransport,
-            server,
-        });
-    });
-    test('subscription', async () => {
-        const options = { codec };
-        const serverTransport = new WebSocketServerTransport(webSocketServer, 'SERVER', options);
-        const client1Transport = new WebSocketClientTransport(() => createLocalWebSocketClient(port), 'client1', 'SERVER', options);
-        const client2Transport = new WebSocketClientTransport(() => createLocalWebSocketClient(port), 'client2', 'SERVER', options);
-        const serviceDefs = buildServiceDefs([SubscribableServiceConstructor()]);
-        const server = createServer(serverTransport, serviceDefs);
-        const client1 = createClient(client1Transport);
-        const client2 = createClient(client2Transport);
-        const [subscription1, close1] = await client1.subscribable.value.subscribe({});
-        let result = await iterNext(subscription1);
-        assert(result.ok);
-        expect(result.payload).toStrictEqual({ result: 0 });
-        const [subscription2, close2] = await client2.subscribable.value.subscribe({});
-        result = await iterNext(subscription2);
-        assert(result.ok);
-        expect(result.payload).toStrictEqual({ result: 0 });
-        const add1 = await client1.subscribable.add.rpc({ n: 1 });
-        assert(add1.ok);
-        result = await iterNext(subscription1);
-        assert(result.ok);
-        expect(result.payload).toStrictEqual({ result: 1 });
-        result = await iterNext(subscription2);
-        assert(result.ok);
-        expect(result.payload).toStrictEqual({ result: 1 });
-        const add2 = await client2.subscribable.add.rpc({ n: 3 });
-        assert(add2.ok);
-        result = await iterNext(subscription1);
-        assert(result.ok);
-        expect(result.payload).toStrictEqual({ result: 4 });
-        result = await iterNext(subscription2);
-        assert(result.ok);
-        expect(result.payload).toStrictEqual({ result: 4 });
-        close1();
-        close2();
-        await testFinishesCleanly({
-            clientTransports: [client1Transport, client2Transport],
-            serverTransport,
-            server,
-        });
-    });
-    test('upload', async () => {
-        const [clientTransport, serverTransport] = getTransports();
-        const serviceDefs = buildServiceDefs([UploadableServiceConstructor()]);
-        const server = createServer(serverTransport, serviceDefs);
-        const client = createClient(clientTransport);
-        const [addStream, addResult] = await client.uploadable.addMultiple.upload();
-        addStream.push({ n: 1 });
-        addStream.push({ n: 2 });
-        addStream.end();
-        const result = await addResult;
-        assert(result.ok);
-        expect(result.payload).toStrictEqual({ result: 3 });
-        await testFinishesCleanly({
-            clientTransports: [clientTransport],
-            serverTransport,
-            server,
-        });
-    });
-    test('upload with init message', async () => {
-        const [clientTransport, serverTransport] = getTransports();
-        const serviceDefs = buildServiceDefs([UploadableServiceConstructor()]);
-        const server = createServer(serverTransport, serviceDefs);
-        const client = createClient(clientTransport);
-        const [addStream, addResult] = await client.uploadable.addMultipleWithPrefix.upload({
-            prefix: 'test',
-        });
-        addStream.push({ n: 1 });
-        addStream.push({ n: 2 });
-        addStream.end();
-        const result = await addResult;
-        assert(result.ok);
-        expect(result.payload).toStrictEqual({ result: 'test 3' });
-        await testFinishesCleanly({
-            clientTransports: [clientTransport],
-            serverTransport,
-            server,
-        });
-    });
-    test('message order is preserved in the face of disconnects', async () => {
-        const [clientTransport, serverTransport] = getTransports();
-        const serviceDefs = buildServiceDefs([OrderingServiceConstructor()]);
-        const server = createServer(serverTransport, serviceDefs);
-        const client = createClient(clientTransport);
-        const expected = [];
-        for (let i = 0; i < 50; i++) {
-            expected.push(i);
-            if (i == 10) {
-                clientTransport.connections.forEach((conn) => conn.ws.close());
-            }
-            if (i == 42) {
-                clientTransport.connections.forEach((conn) => conn.ws.terminate());
-            }
-            await client.test.add.rpc({
-                n: i,
-            });
-        }
-        const res = await client.test.getAll.rpc({});
-        assert(res.ok);
-        expect(res.payload.msgs).toStrictEqual(expected);
-        await testFinishesCleanly({
-            clientTransports: [clientTransport],
-            serverTransport,
-            server,
-        });
-    });
-    const CONCURRENCY = 10;
-    test('concurrent rpcs', async () => {
-        const [clientTransport, serverTransport] = getTransports();
-        const serviceDefs = buildServiceDefs([OrderingServiceConstructor()]);
-        const server = createServer(serverTransport, serviceDefs);
-        const client = createClient(clientTransport);
-        const promises = [];
-        for (let i = 0; i < CONCURRENCY; i++) {
-            promises.push(client.test.add.rpc({ n: i }));
-        }
-        for (let i = 0; i < CONCURRENCY; i++) {
-            const result = await promises[i];
-            assert(result.ok);
-            expect(result.payload).toStrictEqual({ n: i });
-        }
-        await testFinishesCleanly({
-            clientTransports: [clientTransport],
-            serverTransport,
-            server,
-        });
-    });
-    test('concurrent streams', async () => {
-        const [clientTransport, serverTransport] = getTransports();
-        const serviceDefs = buildServiceDefs([TestServiceConstructor()]);
-        const server = createServer(serverTransport, serviceDefs);
-        const client = createClient(clientTransport);
-        const openStreams = [];
-        for (let i = 0; i < CONCURRENCY; i++) {
-            const streamHandle = await client.test.echo.stream();
-            const input = streamHandle[0];
-            input.push({ msg: `${i}-1`, ignore: false });
-            input.push({ msg: `${i}-2`, ignore: false });
-            openStreams.push(streamHandle);
-        }
-        for (let i = 0; i < CONCURRENCY; i++) {
-            const output = openStreams[i][1];
-            const result1 = await iterNext(output);
-            assert(result1.ok);
-            expect(result1.payload).toStrictEqual({ response: `${i}-1` });
-            const result2 = await iterNext(output);
-            assert(result2.ok);
-            expect(result2.payload).toStrictEqual({ response: `${i}-2` });
-        }
-        // cleanup
-        for (let i = 0; i < CONCURRENCY; i++) {
-            const [_input, _output, close] = openStreams[i];
-            close();
-        }
-        await testFinishesCleanly({
-            clientTransports: [clientTransport],
-            serverTransport,
-            server,
-        });
-    });
-});

package/dist/__tests__/fixtures/cleanup.d.ts

@@ -1,12 +0,0 @@
-import { Connection, Transport } from '../../transport';
-import { Server } from '../../router';
-export declare function ensureTransportIsClean(t: Transport<Connection>): Promise<void>;
-export declare function waitFor<T>(cb: () => T | Promise<T>): Promise<T>;
-export declare function ensureTransportQueuesAreEventuallyEmpty(t: Transport<Connection>): Promise<void>;
-export declare function ensureServerIsClean(s: Server<unknown>): Promise<void>;
-export declare function testFinishesCleanly({ clientTransports, serverTransport, server, }: Partial<{
-    clientTransports: Array<Transport<Connection>>;
-    serverTransport: Transport<Connection>;
-    server: Server<unknown>;
-}>): Promise<void>;
-//# sourceMappingURL=cleanup.d.ts.map

package/dist/__tests__/fixtures/cleanup.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../../../__tests__/fixtures/cleanup.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAOtC,wBAAsB,sBAAsB,CAAC,CAAC,EAAE,SAAS,CAAC,UAAU,CAAC,iBAiBpE;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,cAElD;AAED,wBAAsB,uCAAuC,CAC3D,CAAC,EAAE,SAAS,CAAC,UAAU,CAAC,iBAczB;AAED,wBAAsB,mBAAmB,CAAC,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,iBAO3D;AAED,wBAAsB,mBAAmB,CAAC,EACxC,gBAAgB,EAChB,eAAe,EACf,MAAM,GACP,EAAE,OAAO,CAAC;IACT,gBAAgB,EAAE,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;IAC/C,eAAe,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;IACvC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;CACzB,CAAC,iBAgBD"}

package/dist/__tests__/fixtures/cleanup.js

@@ -1,36 +0,0 @@
-import { expect, vi } from 'vitest';
-const waitUntilOptions = {
-    timeout: 250,
-    interval: 5, // check every 5ms
-};
-export async function ensureTransportIsClean(t) {
-    expect(t.state, `transport ${t.clientId} should be closed after the test`).to.not.equal('open');
-    expect(t.connections, `transport ${t.clientId} should not have open connections after the test`).toStrictEqual(new Map());
-    expect(t.eventDispatcher.numberOfListeners('message'), `transport ${t.clientId} should not have open message handlers after the test`).equal(0);
-    expect(t.eventDispatcher.numberOfListeners('connectionStatus'), `transport ${t.clientId} should not have open connection handlers after the test`).equal(0);
-}
-export function waitFor(cb) {
-    return vi.waitFor(cb, waitUntilOptions);
-}
-export async function ensureTransportQueuesAreEventuallyEmpty(t) {
-    await waitFor(() => expect(t.sendQueue.size, `transport ${t.clientId} should not have any messages waiting to send after the test`).toEqual(0));
-    await waitFor(() => expect(t.sendBuffer.size, `transport ${t.clientId} should not have any un-acked messages after the test`).toEqual(0));
-}
-export async function ensureServerIsClean(s) {
-    return waitFor(() => expect(s.streams.size, `server should not have any open streams after the test`).toEqual(0));
-}
-export async function testFinishesCleanly({ clientTransports, serverTransport, server, }) {
-    if (clientTransports) {
-        await Promise.all(clientTransports.map((t) => t.close()));
-        await Promise.all(clientTransports.map(ensureTransportIsClean));
-    }
-    // server sits on top of server transport so we clean it up first
-    if (server) {
-        await ensureServerIsClean(server);
-        await server.close();
-    }
-    if (serverTransport) {
-        await serverTransport.close();
-        await ensureTransportIsClean(serverTransport);
-    }
-}

package/dist/__tests__/fixtures/largePayload.json

@@ -1,33 +0,0 @@
-{
-    "data": [
-        {
-            "type": "articles",
-            "id": "1",
-            "attributes": {
-                "title": "Example article",
-                "body": "The shortest article. Ever.",
-                "created": "2015-05-22T14:56:29.000Z",
-                "updated": "2015-05-22T14:56:28.000Z"
-            },
-            "relationships": {
-                "author": {
-                    "data": {
-                        "id": "42",
-                        "type": "people"
-                    }
-                }
-            }
-        }
-    ],
-    "included": [
-        {
-            "type": "people",
-            "id": "42",
-            "attributes": {
-                "name": "John",
-                "age": 21,
-                "gender": "male"
-            }
-        }
-    ]
-}

package/dist/__tests__/fixtures/observable.d.ts

@@ -1,26 +0,0 @@
-/**
- * Represents an observable value that can be subscribed to for changes.
- * This should only be used in tests
- * @template T - The type of the value being observed.
- */
-export declare class Observable<T> {
-    value: T;
-    private listeners;
-    constructor(initialValue: T);
-    /**
-     * Gets the current value of the observable.
-     */
-    get(): T;
-    /**
-     * Sets the current value of the observable. All listeners will get an update with this value.
-     * @param newValue - The new value to set.
-     */
-    set(tx: (preValue: T) => T): void;
-    /**
-     * Subscribes to changes in the observable value.
-     * @param listener - A callback function that will be called when the value changes.
-     * @returns A function that can be called to unsubscribe from further notifications.
-     */
-    observe(listener: (val: T) => void): () => boolean;
-}
-//# sourceMappingURL=observable.d.ts.map

package/dist/__tests__/fixtures/observable.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"observable.d.ts","sourceRoot":"","sources":["../../../__tests__/fixtures/observable.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,UAAU,CAAC,CAAC;IACvB,KAAK,EAAE,CAAC,CAAC;IACT,OAAO,CAAC,SAAS,CAAwB;gBAE7B,YAAY,EAAE,CAAC;IAK3B;;OAEG;IACH,GAAG;IAIH;;;OAGG;IACH,GAAG,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC;IAM1B;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI;CAKnC"}

package/dist/__tests__/fixtures/observable.js

@@ -1,38 +0,0 @@
-/**
- * Represents an observable value that can be subscribed to for changes.
- * This should only be used in tests
- * @template T - The type of the value being observed.
- */
-export class Observable {
-    value;
-    listeners;
-    constructor(initialValue) {
-        this.value = initialValue;
-        this.listeners = new Set();
-    }
-    /**
-     * Gets the current value of the observable.
-     */
-    get() {
-        return this.value;
-    }
-    /**
-     * Sets the current value of the observable. All listeners will get an update with this value.
-     * @param newValue - The new value to set.
-     */
-    set(tx) {
-        const newValue = tx(this.value);
-        this.value = newValue;
-        this.listeners.forEach((listener) => listener(newValue));
-    }
-    /**
-     * Subscribes to changes in the observable value.
-     * @param listener - A callback function that will be called when the value changes.
-     * @returns A function that can be called to unsubscribe from further notifications.
-     */
-    observe(listener) {
-        this.listeners.add(listener);
-        listener(this.get());
-        return () => this.listeners.delete(listener);
-    }
-}

package/dist/__tests__/fixtures/observable.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=observable.test.d.ts.map

package/dist/__tests__/fixtures/observable.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"observable.test.d.ts","sourceRoot":"","sources":["../../../__tests__/fixtures/observable.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/fixtures/observable.test.js

@@ -1,39 +0,0 @@
-import { Observable } from './observable';
-import { describe, expect, test, vitest } from 'vitest';
-describe('Observable', () => {
-    test('should set initial value correctly', () => {
-        const initialValue = 10;
-        const observable = new Observable(initialValue);
-        expect(observable.value).toBe(initialValue);
-    });
-    test('should update value correctly', () => {
-        const observable = new Observable(10);
-        const newValue = 20;
-        observable.set(() => newValue);
-        expect(observable.value).toBe(newValue);
-    });
-    test('should notify listeners when value changes', () => {
-        const observable = new Observable(10);
-        const listener = vitest.fn();
-        observable.observe(listener);
-        expect(listener).toHaveBeenCalledTimes(1);
-        const newValue = 20;
-        observable.set(() => newValue);
-        expect(listener).toHaveBeenCalledTimes(2);
-        expect(listener).toHaveBeenCalledWith(newValue);
-    });
-    test('should unsubscribe from notifications', () => {
-        const observable = new Observable(10);
-        const listener = vitest.fn();
-        const unsubscribe = observable.observe(listener);
-        expect(listener).toHaveBeenCalledTimes(1);
-        const newValue = 20;
-        observable.set(() => newValue);
-        expect(listener).toHaveBeenCalledTimes(2);
-        expect(listener).toHaveBeenCalledWith(newValue);
-        unsubscribe();
-        const anotherValue = 30;
-        observable.set(() => anotherValue);
-        expect(listener).toHaveBeenCalledTimes(2); // should not be called again after unsubscribing
-    });
-});