websocket-ts 1.1.1 → 2.1.1

package/lib/websocketBuilder.js

@@ -1,68 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WebsocketBuilder = void 0;
-var websocket_1 = require("./websocket");
-/**
- * Used to build Websocket-instances.
- */
-var WebsocketBuilder = /** @class */ (function () {
-    function WebsocketBuilder(url) {
-        this.ws = null;
-        this.onOpenListeners = [];
-        this.onCloseListeners = [];
-        this.onErrorListeners = [];
-        this.onMessageListeners = [];
-        this.onRetryListeners = [];
-        this.url = url;
-    }
-    WebsocketBuilder.prototype.withProtocols = function (p) {
-        this.protocols = p;
-        return this;
-    };
-    WebsocketBuilder.prototype.withBackoff = function (backoff) {
-        this.backoff = backoff;
-        return this;
-    };
-    WebsocketBuilder.prototype.withBuffer = function (buffer) {
-        this.buffer = buffer;
-        return this;
-    };
-    WebsocketBuilder.prototype.onOpen = function (listener, options) {
-        this.onOpenListeners.push({ listener: listener, options: options });
-        return this;
-    };
-    WebsocketBuilder.prototype.onClose = function (listener, options) {
-        this.onCloseListeners.push({ listener: listener, options: options });
-        return this;
-    };
-    WebsocketBuilder.prototype.onError = function (listener, options) {
-        this.onErrorListeners.push({ listener: listener, options: options });
-        return this;
-    };
-    WebsocketBuilder.prototype.onMessage = function (listener, options) {
-        this.onMessageListeners.push({ listener: listener, options: options });
-        return this;
-    };
-    WebsocketBuilder.prototype.onRetry = function (listener, options) {
-        this.onRetryListeners.push({ listener: listener, options: options });
-        return this;
-    };
-    /**
-     * Multiple calls to build() will always return the same websocket-instance.
-     */
-    WebsocketBuilder.prototype.build = function () {
-        var _this = this;
-        if (this.ws !== null)
-            return this.ws;
-        this.ws = new websocket_1.Websocket(this.url, this.protocols, this.buffer, this.backoff);
-        this.onOpenListeners.forEach(function (h) { var _a; return (_a = _this.ws) === null || _a === void 0 ? void 0 : _a.addEventListener(websocket_1.WebsocketEvents.open, h.listener, h.options); });
-        this.onCloseListeners.forEach(function (h) { var _a; return (_a = _this.ws) === null || _a === void 0 ? void 0 : _a.addEventListener(websocket_1.WebsocketEvents.close, h.listener, h.options); });
-        this.onErrorListeners.forEach(function (h) { var _a; return (_a = _this.ws) === null || _a === void 0 ? void 0 : _a.addEventListener(websocket_1.WebsocketEvents.error, h.listener, h.options); });
-        this.onMessageListeners.forEach(function (h) { var _a; return (_a = _this.ws) === null || _a === void 0 ? void 0 : _a.addEventListener(websocket_1.WebsocketEvents.message, h.listener, h.options); });
-        this.onRetryListeners.forEach(function (h) { var _a; return (_a = _this.ws) === null || _a === void 0 ? void 0 : _a.addEventListener(websocket_1.WebsocketEvents.retry, h.listener, h.options); });
-        return this.ws;
-    };
-    return WebsocketBuilder;
-}());
-exports.WebsocketBuilder = WebsocketBuilder;
-//# sourceMappingURL=websocketBuilder.js.map

package/lib/websocketBuilder.js.map

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

package/src/buffer/buffer.ts

@@ -1,45 +0,0 @@
-/**
- * Temporary container for generic elements.
- */
-export interface Buffer<E> {
-    /**
-     * Length of the buffer, the count of elements
-     * that can be read from the buffer.
-     * @return the length of the buffer
-     */
-    len(): number
-
-    /**
-     * Capacity of the buffer, the total amount of
-     * elements the buffer can contain.
-     * @return the capacity of the buffer
-     */
-    cap(): number
-
-    /**
-     * Reads elements from the buffer.
-     * @param es array to read into from the buffer
-     * @return the count of elements that were read
-     */
-    read(es: E[]): number
-
-    /**
-     * Writes elements to the buffer.
-     * @param es array to write to the buffer
-     * @return the count of elements that were written
-     */
-    write(es: E[]): number
-
-    /**
-     * Applies a function to every element in the buffer.
-     * @param fn the function to apply to every element
-     * @return: the count of elements that were used
-     */
-    forEach(fn: (e: E) => any): number
-
-    /**
-     * Clears the buffer. This effectively removes all
-     * items in the buffer.
-     */
-    clear(): void
-}

package/src/buffer/lrubuffer.ts

@@ -1,80 +0,0 @@
-import {Buffer} from "./buffer";
-
-/**
- * LRUBuffer is a buffer that keeps the last n elements. When it is
- * full and written to, the oldest element in the buffer will be
- * replaced. When reading from the LRUBuffer, elements are returned
- * in FIFO-order (queue).
- *
- * LRUBuffer has linear space- and time-requirements. Internally
- * an array is used as a circular-buffer. All memory is allocated
- * on initialization.
- */
-export class LRUBuffer<E> implements Buffer<E> {
-    private readonly buffer: E[];
-    private writePtr: number = 0;
-    private wrapped: boolean = false;
-
-    constructor(len: number) {
-        this.buffer = Array<E>(len);
-    }
-
-    len(): number {
-        return this.wrapped ? this.buffer.length : this.writePtr;
-    }
-
-    cap(): number {
-        return this.buffer.length;
-    }
-
-    read(es: E[]): number {
-        if (es === null || es === undefined || es.length === 0 || this.buffer.length === 0)
-            return 0;
-        if (this.writePtr === 0 && !this.wrapped)
-            return 0;
-        const first = this.wrapped ? this.writePtr : 0;
-        const last = (first - 1) < 0 ?
-            this.buffer.length - 1 :
-            first - 1;
-        for (let i = 0; i < es.length; i++) {
-            let r = (first + i) % this.buffer.length;
-            es[i] = this.buffer[r];
-            if (r === last)
-                return i + 1;
-        }
-        return es.length;
-    }
-
-    write(es: E[]): number {
-        if (es === null || es === undefined || es.length === 0 || this.buffer.length === 0)
-            return 0;
-        const start = es.length > this.buffer.length ? es.length - this.buffer.length : 0;
-        for (let i = 0; i < es.length - start; i++) {
-            this.buffer[this.writePtr] = es[start + i];
-            this.writePtr = (this.writePtr + 1) % this.buffer.length;
-            if (this.writePtr === 0)
-                this.wrapped = true;
-        }
-        return es.length;
-    }
-
-    forEach(fn: (e: E) => any): number {
-        if (this.writePtr === 0 && !this.wrapped)
-            return 0;
-        let cur = this.wrapped ? this.writePtr : 0;
-        const last = this.wrapped ? (cur - 1) < 0 ? this.buffer.length - 1 : cur - 1 : this.writePtr - 1;
-        const len = this.len();
-        while (true) {
-            fn(this.buffer[cur]);
-            if (cur === last)
-                break;
-            cur = (cur + 1) % this.buffer.length;
-        }
-        return len;
-    }
-
-    clear(): void {
-        this.writePtr = 0;
-        this.wrapped = false;
-    }
-}

package/src/buffer/timebuffer.ts

@@ -1,105 +0,0 @@
-import {Buffer} from "./buffer";
-
-/**
- * TimeBuffer keeps the elements that were written to the buffer
- * within maxAge milliseconds. For example, to  keep items in the
- * buffer that are less than a minute old, create the buffer with
- * maxAge equal to 60.000.
- *
- * When reading from the TimeBuffer, elements will be returned
- * in FIFO-order (queue).
- */
-export class TimeBuffer<E> implements Buffer<E> {
-    private readonly maxAge: number;
-    private tail?: elementWithTimestamp<E>;
-    private head?: elementWithTimestamp<E>;
-
-    constructor(maxAge: number) {
-        this.maxAge = maxAge;
-    }
-
-    cap(): number {
-        return Number.POSITIVE_INFINITY;
-    }
-
-    len(): number {
-        this.forwardTail();
-        let cur = this.tail;
-        let i = 0;
-        while (cur !== undefined) {
-            i++;
-            cur = cur.n;
-        }
-        return i;
-    }
-
-    read(es: E[]): number {
-        this.forwardTail();
-        if (es.length === 0)
-            return 0;
-        let cur = this.tail;
-        let i = 0;
-        while (cur !== undefined) {
-            es[i++] = cur.e;
-            if (i === es.length)
-                break;
-            cur = cur.n;
-        }
-        return i;
-    }
-
-    write(es: E[]): number {
-        for (let i = 0; i < es.length; i++)
-            this.putElement(es[i]);
-        return es.length;
-    }
-
-    forEach(fn: (e: E) => any): number {
-        this.forwardTail();
-        let cur = this.tail;
-        let i = 0;
-        while (cur !== undefined) {
-            fn(cur.e);
-            i++;
-            cur = cur.n;
-        }
-        return i;
-    }
-
-    private putElement(e: E) {
-        const newElement = {e, t: Date.now(), n: undefined} as elementWithTimestamp<E>;
-        if (this.tail === undefined)
-            this.tail = newElement;
-        if (this.head === undefined)
-            this.head = newElement
-        else {
-            this.head.n = newElement;
-            this.head = newElement;
-        }
-    }
-
-    private forwardTail() {
-        if (this.tail === undefined)
-            return;
-        const d = Date.now();
-        while (d - this.tail.t > this.maxAge) {
-            if (this.tail === this.head) {
-                this.tail = undefined;
-                this.head = undefined;
-            } else
-                this.tail = this.tail.n;
-            if (this.tail === undefined)
-                break;
-        }
-    }
-
-    clear(): void {
-        // TODO
-    }
-}
-
-type elementWithTimestamp<E> = {
-    e: E,
-    t: number,
-    n?: elementWithTimestamp<E>
-}

package/src/websocketBuilder.ts

@@ -1,98 +0,0 @@
-import {Backoff} from "./backoff/backoff";
-import {Buffer} from "./buffer/buffer";
-import {RetryEventDetails, Websocket, WebsocketEvents} from "./websocket";
-
-/**
- * Used to build Websocket-instances.
- */
-export class WebsocketBuilder {
-    private readonly url: string;
-    private ws: Websocket | null = null;
-    private protocols?: string | string[];
-    private backoff?: Backoff;
-    private buffer?: Buffer<string | ArrayBufferLike | Blob | ArrayBufferView>;
-    private onOpenListeners: ({
-        listener: (instance: Websocket, ev: Event) => any,
-        options?: boolean | EventListenerOptions
-    })[] = [];
-    private onCloseListeners: ({
-        listener: (instance: Websocket, ev: CloseEvent) => any,
-        options?: boolean | EventListenerOptions
-    })[] = [];
-    private onErrorListeners: ({
-        listener: (instance: Websocket, ev: Event) => any,
-        options?: boolean | EventListenerOptions
-    })[] = [];
-    private onMessageListeners: ({
-        listener: (instance: Websocket, ev: MessageEvent) => any,
-        options?: boolean | EventListenerOptions
-    })[] = [];
-    private onRetryListeners: ({
-        listener: (instance: Websocket, ev: CustomEvent<RetryEventDetails>) => any,
-        options?: boolean | EventListenerOptions
-    })[] = [];
-
-    constructor(url: string) {
-        this.url = url;
-    }
-
-    public withProtocols(p: string | string[]): WebsocketBuilder {
-        this.protocols = p;
-        return this;
-    }
-
-    public withBackoff(backoff: Backoff): WebsocketBuilder {
-        this.backoff = backoff;
-        return this;
-    }
-
-    public withBuffer(buffer: Buffer<any>): WebsocketBuilder {
-        this.buffer = buffer;
-        return this;
-    }
-
-    public onOpen(listener: (instance: Websocket, ev: Event) => any,
-                  options?: boolean | EventListenerOptions): WebsocketBuilder {
-        this.onOpenListeners.push({listener, options});
-        return this;
-    }
-
-    public onClose(listener: (instance: Websocket, ev: CloseEvent) => any,
-                   options?: boolean | EventListenerOptions): WebsocketBuilder {
-        this.onCloseListeners.push({listener, options});
-        return this;
-    }
-
-    public onError(listener: (instance: Websocket, ev: Event) => any,
-                   options?: boolean | EventListenerOptions): WebsocketBuilder {
-        this.onErrorListeners.push({listener, options});
-        return this;
-    }
-
-    public onMessage(listener: (instance: Websocket, ev: MessageEvent) => any,
-                     options?: boolean | EventListenerOptions): WebsocketBuilder {
-        this.onMessageListeners.push({listener, options});
-        return this;
-    }
-
-    public onRetry(listener: (instance: Websocket, ev: CustomEvent<RetryEventDetails>) => any,
-                   options?: boolean | EventListenerOptions): WebsocketBuilder {
-        this.onRetryListeners.push({listener, options});
-        return this;
-    }
-
-    /**
-     * Multiple calls to build() will always return the same websocket-instance.
-     */
-    public build(): Websocket {
-        if (this.ws !== null)
-            return this.ws;
-        this.ws = new Websocket(this.url, this.protocols, this.buffer, this.backoff);
-        this.onOpenListeners.forEach(h => this.ws?.addEventListener(WebsocketEvents.open, h.listener, h.options));
-        this.onCloseListeners.forEach(h => this.ws?.addEventListener(WebsocketEvents.close, h.listener, h.options));
-        this.onErrorListeners.forEach(h => this.ws?.addEventListener(WebsocketEvents.error, h.listener, h.options));
-        this.onMessageListeners.forEach(h => this.ws?.addEventListener(WebsocketEvents.message, h.listener, h.options));
-        this.onRetryListeners.forEach(h => this.ws?.addEventListener(WebsocketEvents.retry, h.listener, h.options));
-        return this.ws;
-    }
-}

package/test/backoff/constantbackoff.test.ts

@@ -1,21 +0,0 @@
-import {ConstantBackoff} from "../../src";
-
-describe("Testsuite for ConstantBackoff", () => {
-    test("ConstantBackoff should always return the same value 0", () => {
-        const sut = new ConstantBackoff(0);
-        for (let i = 0; i < 10; i++)
-            expect(sut.next()).toBe(0);
-        sut.reset();
-        for (let i = 0; i < 10; i++)
-            expect(sut.next()).toBe(0);
-    });
-
-    test("ConstantBackoff should always return the same value 1000", () => {
-        const sut = new ConstantBackoff(1000);
-        for (let i = 0; i < 10; i++)
-            expect(sut.next()).toBe(1000);
-        sut.reset();
-        for (let i = 0; i < 10; i++)
-            expect(sut.next()).toBe(1000);
-    });
-})

package/test/backoff/exponentialbackoff.test.ts

@@ -1,13 +0,0 @@
-import {ExponentialBackoff} from "../../src/";
-
-describe("Testsuite for ExponentialBackoff", () => {
-    test("ExponentialBackoff should produce an exponentially increasing series", () => {
-        const sut = new ExponentialBackoff(100, 7);
-        const expected = [100, 200, 400, 800, 1600, 3200, 6400, 6400, 6400, 6400];
-        for (let i = 0; i < expected.length; i++)
-            expect(sut.next()).toBe(expected[i]);
-        sut.reset()
-        for (let i = 0; i < expected.length; i++)
-            expect(sut.next()).toBe(expected[i]);
-    });
-});

package/test/backoff/linearbackoff.test.ts

@@ -1,32 +0,0 @@
-import {LinearBackoff} from "../../src";
-
-describe("Testsuite for LinearBackoff", () => {
-    test("LinearBackoff should produce a linearly increasing series starting with 0", () => {
-        const sut = new LinearBackoff(0, 2000, 8000);
-        const expected = [0, 2000, 4000, 6000, 8000, 8000, 8000, 8000, 8000, 8000];
-        for (let i = 0; i < 10; i++)
-            expect(sut.next()).toBe(expected[i]);
-        sut.reset();
-        for (let i = 0; i < 10; i++)
-            expect(sut.next()).toBe(expected[i]);
-    });
-
-    test("LinearBackoff should produce a linearly increasing series starting with 1000", () => {
-        const sut = new LinearBackoff(1000, 3000, 10000);
-        const expected = [1000, 4000, 7000, 10000, 10000, 10000, 10000, 10000, 10000, 10000];
-        for (let i = 0; i < 10; i++)
-            expect(sut.next()).toBe(expected[i]);
-        sut.reset();
-        for (let i = 0; i < 10; i++)
-            expect(sut.next()).toBe(expected[i]);
-    });
-
-    test("LinearBackoff with undefined maximum should increase without bounds", () => {
-        const sut = new LinearBackoff(1000, 1000);
-        for (let i = 0; i < 100; i++)
-            expect(sut.next()).toBe(1000 + 1000 * i);
-        sut.reset();
-        for (let i = 0; i < 100; i++)
-            expect(sut.next()).toBe(1000 + 1000 * i);
-    })
-})

package/test/buffer/common.ts

@@ -1,10 +0,0 @@
-export const createEmptyArray = (len: number): Array<number> => {
-    return new Array<number>(len);
-}
-
-export const createSequentialArray = (len: number): Array<number> => {
-    const arr = new Array<number>(len);
-    for (let i = 0; i < arr.length; i++)
-        arr[i] = i;
-    return arr;
-}

package/test/buffer/lrubuffer.test.ts

@@ -1,128 +0,0 @@
-import {LRUBuffer} from "../../src";
-
-describe("Testsuite for LRUBuffer", () => {
-    const capacity = 5;
-
-    test("LRUBuffer should return correct capacity", () => {
-        const sut = new LRUBuffer<number>(capacity);
-        expect(sut.cap()).toBe(capacity);
-    })
-
-    test("LRUBuffer should return correct length", () => {
-        const sut = new LRUBuffer<number>(capacity);
-        expect(sut.len()).toBe(0);
-        for (let i = 0; i <= 2 * capacity; i++) {
-            expect(sut.write([i])).toBe(1);
-            expect(sut.len()).toBe(i >= capacity ? capacity : i + 1);
-        }
-    });
-
-    test("LRUBuffer read/write zero elements", () => {
-        const sut1 = new LRUBuffer<number>(capacity);
-        const writeArr1 = createSequentialArray(0);
-        const readArr1 = createEmptyArray(0);
-        expect(sut1.write(writeArr1)).toBe(writeArr1.length);
-        expect(sut1.len()).toBe(writeArr1.length);
-        expect(sut1.read(readArr1)).toBe(writeArr1.length);
-        expect(readArr1).toEqual(writeArr1);
-    });
-
-    test("LRUBuffer read/write single elements", () => {
-        const sut = new LRUBuffer<number>(capacity)
-        const expected = [] as number[];
-        for (let i = 0; i < capacity * 3 + 2; i++) {
-            // write new element to buffer
-            expect(sut.write([i])).toBe(1);
-            expected.push(i);
-
-            // drop the last written element from expected if we exceed capacity
-            if (i > capacity - 1)
-                expected.shift();
-
-            // read actual elements
-            const r = createEmptyArray(i);
-            expect(sut.read(r)).toBe(i > capacity ? capacity : i);
-            for (let j = 0; j < i; j++) {
-                if (j > capacity - 1)
-                    expect(r[j]).toBeUndefined();
-                else
-                    expect(r[j]).toBe(expected[j]);
-            }
-        }
-    });
-
-    test("LRUBuffer read/write multiple elements", () => {
-        for (let i = 0; i < 2 * capacity; i++) {
-            const sut = new LRUBuffer<number>(capacity);
-            const writeArr = createSequentialArray(i);
-            const readArr = createEmptyArray(i);
-            expect(sut.write(writeArr)).toBe(i);
-            expect(sut.read(readArr)).toBe(i > capacity ? capacity : i);
-            for (let j = 0; j < i; j++) {
-                if (j > capacity - 1)
-                    expect(readArr[j]).toBeUndefined();
-                else
-                    expect(readArr[j]).toBe(writeArr[i > capacity ? j - (capacity - i) : j]);
-            }
-        }
-    });
-
-    test("LRUBuffer read/write on buffer with zero capacity should always return zero", () => {
-        const sut = new LRUBuffer<number>(0);
-        expect(sut.write([1])).toBe(0);
-        expect(sut.read([0])).toBe(0);
-    });
-
-    test("LRUBuffer read from empty buffer should return zero elements", () => {
-        const sut = new LRUBuffer<number>(capacity);
-        const readArr = new Array<number>(capacity);
-        expect(sut.read(readArr)).toBe(0);
-    });
-
-    test("LRUBuffer forEach should apply function to every element in the buffer", () => {
-       const sut = new LRUBuffer<number>(capacity);
-       const es = [] as number[];
-       sut.write([0]);
-       sut.forEach(e => es.push(e));
-       expect(es).toEqual([0]);
-
-       const es2 = [] as number[];
-       sut.write([1, 2, 3, 4]);
-       sut.forEach(e => es2.push(e));
-       expect(es2).toEqual([0, 1, 2, 3, 4]);
-
-        const es3 = [] as number[];
-        sut.write([5, 6]);
-        sut.forEach(e => es3.push(e));
-        expect(es3).toEqual([2, 3, 4, 5, 6]);
-    });
-
-    test("LRUBuffer forEach on empty buffer should do nothing", () => {
-        const sut = new LRUBuffer<number>(capacity);
-        const es = [] as number[];
-        sut.forEach(e => es.push(e));
-        expect(es.length).toBe(0);
-    });
-
-    test("LRUBuffer should contain zero items when cleared", () => {
-        const sut = new LRUBuffer<number>(capacity);
-        const writeArr = createSequentialArray(capacity);
-        const readArr = createEmptyArray(capacity);
-        sut.write(writeArr);
-        sut.clear();
-        expect(sut.len()).toBe(0);
-        expect(sut.read(readArr)).toBe(0);
-        expect(readArr).toEqual(createEmptyArray(capacity));
-    });
-});
-
-const createEmptyArray = (len: number): Array<number> => {
-    return new Array<number>(len);
-}
-
-const createSequentialArray = (len: number): Array<number> => {
-    const arr = new Array<number>(len);
-    for (let i = 0; i < arr.length; i++)
-        arr[i] = i;
-    return arr;
-}