@litert/televoke 0.4.7 → 1.0.0-1

package/src/lib/Server/Gateways/Http.ts

@@ -1,209 +0,0 @@
-/**
- * Copyright 2021 Angus.Fenying <fenying@litert.org>
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *   https://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-import * as $Net from 'net';
-import * as C from '../Common';
-import * as G from '../../Common';
-import * as E from '../Errors';
-import * as $Http from 'http';
-
-enum EStatus {
-
-    IDLE,
-    STARTING,
-    WORKING,
-    CLOSING,
-}
-
-const INVALID_REQUEST_RESPONSE = Buffer.from('{"rid":"null","body":INVALID REQUEST,"sst":1698886839989,"srt":0,"code":4}');
-
-function refuseBadRequest(resp: $Http.ServerResponse): void {
-
-    try {
-
-        resp.writeHead(400, {
-            'content-length': INVALID_REQUEST_RESPONSE.byteLength,
-        });
-        const socket = resp.socket!;
-        resp.end(INVALID_REQUEST_RESPONSE);
-        socket.destroy();
-    }
-    catch {
-
-        // do nothing.
-    }
-}
-
-class HttpGateway implements C.IGateway {
-
-    private readonly _server: $Http.Server = $Http.createServer(this._onRequest.bind(this));
-
-    private _status: EStatus = EStatus.IDLE;
-
-    public onError!: (e: unknown) => void;
-
-    public onRequest!: (
-        request: G.IRawRequest,
-        reply: (data: any) => void
-    ) => void;
-
-    public constructor(
-        public host: string,
-        public port: number,
-        private readonly _backlog?: number,
-    ) { }
-
-    private _onRequest(req: $Http.IncomingMessage, resp: $Http.ServerResponse): void {
-
-        if (req.method !== 'POST' || !req.headers['content-length']) {
-
-            refuseBadRequest(resp);
-            return;
-        }
-
-        const length = parseInt(req.headers['content-length']);
-
-        if (!Number.isSafeInteger(length) || length > G.MAX_PACKET_SIZE) { // Maximum request packet is 64MB
-
-            refuseBadRequest(resp);
-            return;
-        }
-
-        const buf: Buffer = Buffer.allocUnsafe(length);
-
-        let offset: number = 0;
-
-        resp.on('error', this.onError);
-
-        req.on('error', this.onError).on('data', (chunk: Buffer) => {
-
-            const index = offset;
-
-            offset += chunk.byteLength;
-
-            if (offset > length) {
-
-                req.removeAllListeners('end');
-                req.removeAllListeners('data');
-                refuseBadRequest(resp);
-                return;
-            }
-
-            chunk.copy(buf, index);
-        }).on('end', () => {
-
-            let input: any;
-
-            if (offset !== length || buf[0] !== 123 || buf[offset - 1] !== 125) {
-
-                refuseBadRequest(resp);
-                return;
-            }
-
-            try {
-
-                input = JSON.parse(buf as any);
-                input.ip = (req.socket.address() as any).address;
-            }
-            catch (e) {
-
-                refuseBadRequest(resp);
-                this.onError(e);
-                return;
-            }
-
-            this.onRequest(
-                input,
-                (content) => {
-
-                    if (resp.writable) {
-
-                        const data = JSON.stringify(content);
-
-                        resp.setHeader('content-length', Buffer.byteLength(data));
-                        resp.end(data);
-                    }
-                }
-            );
-        });
-    }
-
-    public async start(): Promise<void> {
-
-        if (!this.onError || !this.onRequest) {
-
-            throw new E.E_NO_SERVER_ATTACHED();
-        }
-
-        switch (this._status) {
-
-            case EStatus.IDLE:
-
-                this._status = EStatus.STARTING;
-
-                return new Promise((resolve, reject) => {
-
-                    this._server.listen(this.port, this.host, this._backlog)
-                        .once('listening', () => {
-
-                            this._server.removeAllListeners('error');
-                            this._status = EStatus.WORKING;
-                            if (this.port === 0) {
-
-                                this.port = (this._server.address() as $Net.AddressInfo).port;
-                            }
-                            resolve();
-                        })
-                        .once('error', (e) => {
-
-                            this._server.removeAllListeners('listening');
-                            this._status = EStatus.IDLE;
-                            reject(e);
-                        });
-                });
-
-            case EStatus.STARTING:
-                throw new E.E_GATEWAY_STARTING();
-            case EStatus.CLOSING:
-                throw new E.E_GATEWAY_CLOSING();
-            case EStatus.WORKING:
-                return;
-        }
-    }
-
-    public async close(): Promise<void> {
-
-        switch (this._status) {
-
-            case EStatus.IDLE:
-                return;
-            case EStatus.STARTING:
-                throw new E.E_GATEWAY_STARTING();
-            case EStatus.CLOSING:
-                throw new E.E_GATEWAY_CLOSING();
-            case EStatus.WORKING:
-                return new Promise((resolve) => {
-
-                    this._server.close(() => { resolve(); });
-                });
-        }
-    }
-}
-
-export function createHttpGateway(host: string, port: number, backlog?: number): C.IGateway {
-
-    return new HttpGateway(host, port, backlog);
-}

package/src/lib/Server/Gateways/TCP.ts

@@ -1,221 +0,0 @@
-/**
- * Copyright 2021 Angus.Fenying <fenying@litert.org>
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *   https://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-import * as C from '../Common';
-import * as G from '../../Common';
-import * as E from '../Errors';
-import * as $Net from 'net';
-import { createEncoder } from '../../Encoder/Encoder';
-import { createDecoder } from '../../Encoder/Decoder';
-
-enum EStatus {
-
-    IDLE,
-    STARTING,
-    WORKING,
-    CLOSING,
-}
-
-enum EClientStatus {
-
-    WORKING,
-    CLOSING,
-}
-
-interface IClient {
-
-    socket: $Net.Socket;
-
-    decoder: G.IDecoder<C.IRequest>;
-
-    status: EClientStatus;
-
-    loads: number;
-}
-
-class TCPGateway implements C.IGateway {
-
-    private readonly _socket: $Net.Server = $Net.createServer(this._onConnect.bind(this));
-
-    private _status: EStatus = EStatus.IDLE;
-
-    private _clients: Record<string, IClient> = {};
-
-    private _clientIdCounter: number = 0;
-
-    public onError!: (e: unknown) => void;
-
-    public onRequest!: (
-        request: G.IRawRequest,
-        reply: (data: any) => void
-    ) => void;
-
-    public constructor(
-        public host: string,
-        public port: number,
-        private readonly _backlog?: number,
-    ) {}
-
-    private _onConnect(socket: $Net.Socket): void {
-
-        const clientId = this._clientIdCounter++;
-
-        const encoder = createEncoder();
-        const decoder = createDecoder<C.IRequest>();
-        const client = {
-            decoder,
-            socket,
-            status: EClientStatus.WORKING,
-            loads: 0
-        };
-
-        decoder.onLogicError = decoder.onProtocolError = (e: unknown) => {
-
-            delete this._clients[clientId];
-
-            socket.destroy();
-
-            this.onError(e);
-        };
-
-        decoder.onData = (data) => {
-
-            client.loads++;
-            data.ip = (socket.address() as any).address;
-
-            this.onRequest(
-                data,
-                (content) => {
-
-                    if (socket.writable) {
-
-                        encoder.encode(socket, content);
-                    }
-
-                    if (!--client.loads && client.status === EClientStatus.CLOSING) {
-
-                        socket.end();
-                    }
-                }
-            );
-        };
-
-        this._clients[clientId] = client;
-
-        socket.on('data', decoder.decode.bind(decoder)).on('end', () => {
-
-            client.status = EClientStatus.CLOSING;
-            delete this._clients[clientId];
-        }).on(
-            'error',
-            this.onError
-        ).on(
-            'close',
-            () => delete this._clients[clientId]
-        );
-    }
-
-    public async start(): Promise<void> {
-
-        if (!this.onError || !this.onRequest) {
-
-            throw new E.E_NO_SERVER_ATTACHED();
-        }
-
-        switch (this._status) {
-
-            case EStatus.IDLE:
-
-                this._status = EStatus.STARTING;
-
-                return new Promise((resolve, reject) => {
-
-                    this._socket.listen(this.port, this.host, this._backlog)
-                        .once('listening', () => {
-
-                            this._socket.removeAllListeners('error');
-                            this._status = EStatus.WORKING;
-                            if (this.port === 0) {
-
-                                this.port = (this._socket.address() as $Net.AddressInfo).port;
-                            }
-                            resolve();
-                        })
-                        .once('error', (e) => {
-
-                            this._socket.removeAllListeners('listening');
-                            this._status = EStatus.IDLE;
-                            reject(e);
-                        });
-                });
-
-            case EStatus.STARTING:
-                throw new E.E_GATEWAY_STARTING();
-            case EStatus.CLOSING:
-                throw new E.E_GATEWAY_CLOSING();
-            case EStatus.WORKING:
-                return;
-        }
-    }
-
-    public async close(): Promise<void> {
-
-        switch (this._status) {
-
-            case EStatus.IDLE:
-                return;
-            case EStatus.STARTING:
-                throw new E.E_GATEWAY_STARTING();
-            case EStatus.CLOSING:
-                throw new E.E_GATEWAY_CLOSING();
-            case EStatus.WORKING:
-                return new Promise((resolve) => {
-
-                    this._socket.close(() => { resolve(); });
-
-                    for (const clientId in this._clients) {
-
-                        this._closeClient(clientId);
-                    }
-                });
-        }
-    }
-
-    private _closeClient(clientId: string | number): void {
-
-        if (this._clients[clientId].loads) {
-
-            this._clients[clientId].decoder.onData = () => void 0;
-            this._clients[clientId].status = EClientStatus.CLOSING;
-        }
-        else {
-
-            this._clients[clientId].socket.end();
-        }
-
-        delete this._clients[clientId];
-    }
-}
-
-/**
- * Create a gateway of TCP-base televoke/1 protocol.
- *
- * @deprecated This legacy TCP-based televoke/1 protocol is no longer maintained, and will be removed in v2.0.0
- */
-export function createTCPGateway(host: string, port: number, backlog?: number): C.IGateway {
-
-    return new TCPGateway(host, port, backlog);
-}

package/src/lib/Server/Server.ts

@@ -1,268 +0,0 @@
-/**
- * Copyright 2021 Angus.Fenying <fenying@litert.org>
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *   https://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-import * as C from './Common';
-import * as G from '../Common';
-import * as E from './Errors';
-import { Events } from '@litert/observable';
-
-enum EStatus {
-
-    IDLE,
-    STARTING,
-    WORKING,
-    CLOSING,
-}
-
-class Server extends Events.EventEmitter<C.IServerEvents> implements C.IServer {
-
-    private _gateways: Record<string, C.IGateway> = {};
-
-    private _router!: C.IRouter;
-
-    private _status: EStatus = EStatus.IDLE;
-
-    public getGateway(name: string): C.IGateway {
-
-        const ret = this._gateways[name];
-
-        if (!ret) {
-
-            throw new E.E_GATEWAY_NOT_FOUND({ name });
-        }
-
-        return ret;
-    }
-
-    public addGateway(name: string, gateway: C.IGateway): this {
-
-        if (this._status !== EStatus.IDLE) {
-
-            throw new E.E_SERVER_BUSY();
-        }
-
-        this._gateways[name] = gateway;
-
-        if (gateway.onError ?? gateway.onRequest) {
-
-            throw new E.E_GATEWAY_BUSY();
-        }
-
-        gateway.onError = (e) => this.emit('error', e);
-        gateway.onRequest = (rawReq, reply) => {
-
-            const req = rawReq as C.IRequest;
-
-            req.srt = Date.now();
-
-            const handler = this._router.route(rawReq.api);
-
-            if (!handler) {
-
-                reply({
-                    rid: req.rid,
-                    srt: req.srt,
-                    sst: Date.now(),
-                    code: G.EResponseCode.API_NOT_FOUND,
-                    body: null
-                });
-                return;
-            }
-
-            if (!this._router.validate(req, handler)) {
-
-                reply({
-                    rid: req.rid,
-                    srt: req.srt,
-                    sst: Date.now(),
-                    code: G.EResponseCode.MALFORMED_ARGUMENTS,
-                    body: null
-                });
-                return;
-            }
-
-            let resultPr: any;
-
-            try {
-
-                resultPr = this._router.execute(req, handler);
-            }
-            catch (e) {
-
-                reply({
-                    rid: req.rid,
-                    srt: req.srt,
-                    sst: Date.now(),
-                    code: G.EResponseCode.FAILURE,
-                    body: e ?? null
-                });
-
-                return;
-            }
-
-            if (resultPr instanceof Promise) {
-
-                resultPr.then(
-                    (body) => {
-                        reply({
-                            rid: req.rid,
-                            srt: req.srt,
-                            sst: Date.now(),
-                            code: G.EResponseCode.OK,
-                            body: body ?? null
-                        });
-                    },
-                    (err) => {
-                        reply({
-                            rid: req.rid,
-                            srt: req.srt,
-                            sst: Date.now(),
-                            code: G.EResponseCode.FAILURE,
-                            body: err ?? null
-                        });
-                    }
-                );
-            }
-            else {
-
-                reply({
-                    rid: req.rid,
-                    srt: req.srt,
-                    sst: Date.now(),
-                    code: G.EResponseCode.OK,
-                    body: resultPr ?? null
-                });
-            }
-        };
-
-        return this;
-    }
-
-    public removeGateway(name: string): this {
-
-        if (this._status !== EStatus.IDLE) {
-
-            throw new E.E_SERVER_BUSY();
-        }
-
-        const gateway = this._gateways[name];
-
-        if (gateway) {
-
-            delete this._gateways[name];
-
-            delete gateway.onRequest;
-            delete gateway.onError;
-        }
-
-        return this;
-    }
-
-    public setRouter(router: C.IRouter): this {
-
-        if (this._status !== EStatus.IDLE) {
-
-            throw new E.E_SERVER_BUSY();
-        }
-
-        this._router = router;
-        return this;
-    }
-
-    public async start(): Promise<void> {
-
-        if (!this.listenerCount('error')
-            || !this.listenerCount('handler_error')
-            || !this._router
-            || !Object.values(this._gateways).length
-        ) {
-
-            throw new E.E_SERVER_NOT_READY();
-        }
-
-        switch (this._status) {
-            case EStatus.IDLE: {
-
-                this._status = EStatus.STARTING;
-
-                try {
-
-                    const gateways = Object.keys(this._gateways);
-
-                    await Promise.all(gateways.map(
-                        (k) => this._gateways[k].start()
-                    ));
-
-                    this._status = EStatus.WORKING;
-                }
-                catch (e) {
-
-                    await this._doClose();
-                    this._status = EStatus.IDLE;
-                    throw e;
-                }
-
-                break;
-            }
-            case EStatus.STARTING:
-                throw new E.E_SERVER_STARTING();
-            case EStatus.CLOSING:
-                throw new E.E_SERVER_CLOSING();
-            case EStatus.WORKING:
-                return;
-        }
-    }
-
-    private async _doClose(): Promise<void> {
-
-        await Promise.all(Object.values(this._gateways).map((k) => k.close()));
-
-        this._status = EStatus.IDLE;
-    }
-
-    public async close(): Promise<void> {
-
-        switch (this._status) {
-            case EStatus.WORKING: {
-
-                this._status = EStatus.CLOSING;
-
-                try {
-
-                    await this._doClose();
-                }
-                catch (e) {
-
-                    this._status = EStatus.WORKING;
-                    throw e;
-                }
-
-                break;
-            }
-            case EStatus.STARTING:
-                throw new E.E_SERVER_STARTING();
-            case EStatus.CLOSING:
-                throw new E.E_SERVER_CLOSING();
-            case EStatus.IDLE:
-                return;
-        }
-    }
-}
-
-export function createServer(): C.IServer {
-
-    return new Server();
-}