@adminide-stack/extension-api 0.0.2-alpha.0

package/lib/connections/jsonrpc2/messages.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isResponseMessage = exports.isNotificationMessage = exports.isRequestMessage = exports.ResponseError = exports.ErrorCodes = void 0;
+/**
+ * Predefined error codes.
+ */
+var ErrorCodes;
+(function (ErrorCodes) {
+    // Defined by JSON-RPC 2.0.
+    ErrorCodes.ParseError = -32700;
+    ErrorCodes.InvalidRequest = -32600;
+    ErrorCodes.MethodNotFound = -32601;
+    ErrorCodes.InvalidParams = -32602;
+    ErrorCodes.InternalError = -32603;
+    ErrorCodes.serverErrorStart = -32099;
+    ErrorCodes.serverErrorEnd = -32000;
+    ErrorCodes.ServerNotInitialized = -32002;
+    ErrorCodes.UnknownErrorCode = -32001;
+    // Defined by this library.
+    ErrorCodes.MessageWriteError = 1;
+    ErrorCodes.MessageReadError = 2;
+    ErrorCodes.RequestAborted = -32800;
+})(ErrorCodes = exports.ErrorCodes || (exports.ErrorCodes = {}));
+/**
+ * An error object return in a response in case a request
+ * has failed.
+ */
+class ResponseError extends Error {
+    constructor(code, message, data) {
+        super(message);
+        this.code = typeof code === 'number' ? code : ErrorCodes.UnknownErrorCode;
+        this.data = data;
+        Object.setPrototypeOf(this, ResponseError.prototype);
+    }
+    toJSON() {
+        return {
+            code: this.code,
+            message: this.message,
+            data: this.data,
+        };
+    }
+}
+exports.ResponseError = ResponseError;
+/**
+ * Tests if the given message is a request message
+ */
+function isRequestMessage(message) {
+    const candidate = message;
+    return (candidate &&
+        typeof candidate.method === 'string' &&
+        (typeof candidate.id === 'string' || typeof candidate.id === 'number'));
+}
+exports.isRequestMessage = isRequestMessage;
+/**
+ * Tests if the given message is a notification message
+ */
+function isNotificationMessage(message) {
+    const candidate = message;
+    return candidate && typeof candidate.method === 'string' && message.id === void 0;
+}
+exports.isNotificationMessage = isNotificationMessage;
+/**
+ * Tests if the given message is a response message
+ */
+function isResponseMessage(message) {
+    const candidate = message;
+    return (candidate &&
+        (candidate.result !== void 0 || !!candidate.error || !!candidate.complete) &&
+        (typeof candidate.id === 'string' || typeof candidate.id === 'number' || candidate.id === null));
+}
+exports.isResponseMessage = isResponseMessage;
+//# sourceMappingURL=messages.js.map

package/lib/connections/jsonrpc2/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../../src/connections/jsonrpc2/messages.ts"],"names":[],"mappings":";;;AAgCA;;GAEG;AACH,IAAiB,UAAU,CAgB1B;AAhBD,WAAiB,UAAU;IACvB,2BAA2B;IACd,qBAAU,GAAG,CAAC,KAAK,CAAA;IACnB,yBAAc,GAAG,CAAC,KAAK,CAAA;IACvB,yBAAc,GAAG,CAAC,KAAK,CAAA;IACvB,wBAAa,GAAG,CAAC,KAAK,CAAA;IACtB,wBAAa,GAAG,CAAC,KAAK,CAAA;IACtB,2BAAgB,GAAG,CAAC,KAAK,CAAA;IACzB,yBAAc,GAAG,CAAC,KAAK,CAAA;IACvB,+BAAoB,GAAG,CAAC,KAAK,CAAA;IAC7B,2BAAgB,GAAG,CAAC,KAAK,CAAA;IAEtC,2BAA2B;IACd,4BAAiB,GAAG,CAAC,CAAA;IACrB,2BAAgB,GAAG,CAAC,CAAA;IACpB,yBAAc,GAAG,CAAC,KAAK,CAAA;AACxC,CAAC,EAhBgB,UAAU,GAAV,kBAAU,KAAV,kBAAU,QAgB1B;AAoBD;;;GAGG;AACH,MAAa,aAAiB,SAAQ,KAAK;IAIvC,YAAY,IAAY,EAAE,OAAe,EAAE,IAAQ;QAC/C,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,gBAAgB,CAAA;QACzE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,CAAA;IACxD,CAAC;IAEM,MAAM;QACT,OAAO;YACH,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;SAClB,CAAA;IACL,CAAC;CACJ;AAlBD,sCAkBC;AA2CD;;GAEG;AACH,SAAgB,gBAAgB,CAAC,OAA4B;IACzD,MAAM,SAAS,GAAG,OAAyB,CAAA;IAC3C,OAAO,CACH,SAAS;QACT,OAAO,SAAS,CAAC,MAAM,KAAK,QAAQ;QACpC,CAAC,OAAO,SAAS,CAAC,EAAE,KAAK,QAAQ,IAAI,OAAO,SAAS,CAAC,EAAE,KAAK,QAAQ,CAAC,CACzE,CAAA;AACL,CAAC;AAPD,4CAOC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CAAC,OAA4B;IAC9D,MAAM,SAAS,GAAG,OAA8B,CAAA;IAChD,OAAO,SAAS,IAAI,OAAO,SAAS,CAAC,MAAM,KAAK,QAAQ,IAAK,OAAe,CAAC,EAAE,KAAK,KAAK,CAAC,CAAA;AAC9F,CAAC;AAHD,sDAGC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAAC,OAA4B;IAC1D,MAAM,SAAS,GAAG,OAA0B,CAAA;IAC5C,OAAO,CACH,SAAS;QACT,CAAC,SAAS,CAAC,MAAM,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC;QAC1E,CAAC,OAAO,SAAS,CAAC,EAAE,KAAK,QAAQ,IAAI,OAAO,SAAS,CAAC,EAAE,KAAK,QAAQ,IAAI,SAAS,CAAC,EAAE,KAAK,IAAI,CAAC,CAClG,CAAA;AACL,CAAC;AAPD,8CAOC"}

package/lib/connections/jsonrpc2/test-helper.d.ts

@@ -0,0 +1,8 @@
+import { MessageTransports } from './connection';
+/**
+ * Creates a pair of message transports that are connected to each other. One can be used as the server and the
+ * other as the client.
+ */
+export declare function createMessageTransports(): [MessageTransports, MessageTransports];
+/** Creates a single set of transports that are connected to each other. */
+export declare function createMessagePipe(): MessageTransports;

package/lib/connections/jsonrpc2/test-helper.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMessagePipe = exports.createMessageTransports = void 0;
+const transport_1 = require("./transport");
+/**
+ * Creates a pair of message transports that are connected to each other. One can be used as the server and the
+ * other as the client.
+ */
+function createMessageTransports() {
+    const { reader: reader1, writer: writer1 } = createMessagePipe();
+    const { reader: reader2, writer: writer2 } = createMessagePipe();
+    return [{ reader: reader1, writer: writer2 }, { reader: reader2, writer: writer1 }];
+}
+exports.createMessageTransports = createMessageTransports;
+/** Creates a single set of transports that are connected to each other. */
+function createMessagePipe() {
+    let readerCallback;
+    const reader = new class extends transport_1.AbstractMessageReader {
+        listen(callback) {
+            readerCallback = callback;
+        }
+    }();
+    const writer = new class extends transport_1.AbstractMessageWriter {
+        write(msg) {
+            if (readerCallback) {
+                readerCallback(msg);
+            }
+            else {
+                throw new Error('reader has no listener');
+            }
+        }
+    }();
+    return { reader, writer };
+}
+exports.createMessagePipe = createMessagePipe;
+//# sourceMappingURL=test-helper.js.map

package/lib/connections/jsonrpc2/test-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helper.js","sourceRoot":"","sources":["../../../src/connections/jsonrpc2/test-helper.ts"],"names":[],"mappings":";;;AAEA,2CAAsH;AAEtH;;;GAGG;AACH,SAAgB,uBAAuB;IACnC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,iBAAiB,EAAE,CAAA;IAChE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,iBAAiB,EAAE,CAAA;IAChE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAA;AACvF,CAAC;AAJD,0DAIC;AAED,2EAA2E;AAC3E,SAAgB,iBAAiB;IAC7B,IAAI,cAAwC,CAAA;IAC5C,MAAM,MAAM,GAAkB,IAAI,KAAM,SAAQ,iCAAqB;QAC1D,MAAM,CAAC,QAAsB;YAChC,cAAc,GAAG,QAAQ,CAAA;QAC7B,CAAC;KACJ,EAAE,CAAA;IACH,MAAM,MAAM,GAAkB,IAAI,KAAM,SAAQ,iCAAqB;QAC1D,KAAK,CAAC,GAAY;YACrB,IAAI,cAAc,EAAE;gBAChB,cAAc,CAAC,GAAG,CAAC,CAAA;aACtB;iBAAM;gBACH,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;aAC5C;QACL,CAAC;KACJ,EAAE,CAAA;IACH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;AAC7B,CAAC;AAjBD,8CAiBC"}

package/lib/connections/jsonrpc2/trace.d.ts

@@ -0,0 +1,30 @@
+import { NotificationMessage, RequestMessage, ResponseMessage } from './messages';
+/** Records messages sent and received on a JSON-RPC 2.0 connection. */
+export interface Tracer {
+    log(message: string, details?: string): void;
+    requestSent(message: RequestMessage): void;
+    requestReceived(message: RequestMessage): void;
+    notificationSent(message: NotificationMessage): void;
+    notificationReceived(message: NotificationMessage): void;
+    responseSent(message: ResponseMessage, request: RequestMessage, startTime: number): void;
+    responseAborted(message: ResponseMessage, request: RequestMessage, abortMessage: NotificationMessage): void;
+    responseReceived(message: ResponseMessage, request: RequestMessage | string, startTime: number): void;
+    unknownResponseReceived(message: ResponseMessage): void;
+}
+/** A tracer that implements the Tracer interface with noop methods. */
+export declare const noopTracer: Tracer;
+/** A tracer that implements the Tracer interface with console API calls, intended for a web browser. */
+export declare class BrowserConsoleTracer implements Tracer {
+    private name;
+    constructor(name: string);
+    private prefix;
+    log(message: string, details?: string): void;
+    requestSent(message: RequestMessage): void;
+    requestReceived(message: RequestMessage): void;
+    notificationSent(message: NotificationMessage): void;
+    notificationReceived(message: NotificationMessage): void;
+    responseSent(message: ResponseMessage, request: RequestMessage, startTime: number): void;
+    responseAborted(_message: ResponseMessage, request: RequestMessage, _abortMessage: NotificationMessage): void;
+    responseReceived(message: ResponseMessage, request: RequestMessage | string, startTime: number): void;
+    unknownResponseReceived(message: ResponseMessage): void;
+}

package/lib/connections/jsonrpc2/trace.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserConsoleTracer = exports.noopTracer = void 0;
+/** A tracer that implements the Tracer interface with noop methods. */
+exports.noopTracer = {
+    log: () => void 0,
+    requestSent: () => void 0,
+    requestReceived: () => void 0,
+    notificationSent: () => void 0,
+    notificationReceived: () => void 0,
+    responseSent: () => void 0,
+    responseAborted: () => void 0,
+    responseReceived: () => void 0,
+    unknownResponseReceived: () => void 0,
+};
+/** A tracer that implements the Tracer interface with console API calls, intended for a web browser. */
+class BrowserConsoleTracer {
+    constructor(name) {
+        this.name = name;
+    }
+    prefix(level, label, title) {
+        let color;
+        let backgroundColor;
+        if (level === 'info') {
+            color = '#000';
+            backgroundColor = '#eee';
+        }
+        else {
+            color = 'white';
+            backgroundColor = 'red';
+        }
+        return [
+            '%c%s%c %s%c%s%c',
+            `font-weight:bold;background-color:#d8f7ff;color:black`,
+            this.name,
+            '',
+            label,
+            `background-color:${backgroundColor};color:${color};font-weight:bold`,
+            title,
+            '',
+        ];
+    }
+    log(message, details) {
+        if (details) {
+            ;
+            console.groupCollapsed(...this.prefix('info', 'log', ''), message);
+            console.log(details);
+            console.groupEnd();
+        }
+        else {
+            console.log(...this.prefix('info', 'log', ''), message);
+        }
+    }
+    requestSent(message) {
+        console.log(...this.prefix('info', `◀◀ sent request #${message.id}: `, message.method), message.params);
+    }
+    requestReceived(message) {
+        console.log(...this.prefix('info', `▶▶ recv request #${message.id}: `, message.method), message.params);
+    }
+    notificationSent(message) {
+        console.log(...this.prefix('info', `◀◀ sent notif: `, message.method), message.params);
+    }
+    notificationReceived(message) {
+        console.log(...this.prefix('info', `▶▶ recv notif: `, message.method), message.params);
+    }
+    responseSent(message, request, startTime) {
+        const prefix = this.prefix(message.error ? 'error' : 'info', `◀▶ sent response #${message.id}: `, typeof request === 'string' ? request : request.method);
+        console.groupCollapsed(...prefix);
+        console.log('Response:', message);
+        console.log('Request:', request);
+        console.log('Duration: %d msec', Date.now() - startTime);
+        console.groupEnd();
+    }
+    responseAborted(_message, request, _abortMessage) {
+        console.log(...this.prefix('info', '× abort: ', request.method));
+    }
+    responseReceived(message, request, startTime) {
+        const prefix = this.prefix(message.error ? 'error' : 'info', `◀▶ recv response #${message.id}: `, typeof request === 'string' ? request : request.method);
+        if (typeof request === 'string') {
+            console.log(...prefix, message.error || message.result);
+        }
+        else {
+            ;
+            console.groupCollapsed(...prefix);
+            console.log('Response:', message);
+            console.log('Request:', request);
+            console.log('Duration: %d msec', Date.now() - startTime);
+            console.groupEnd();
+        }
+    }
+    unknownResponseReceived(message) {
+        console.log(...this.prefix('error', 'UNKNOWN', ''), message);
+    }
+}
+exports.BrowserConsoleTracer = BrowserConsoleTracer;
+//# sourceMappingURL=trace.js.map

package/lib/connections/jsonrpc2/trace.js.map

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

package/lib/connections/jsonrpc2/transport.d.ts

@@ -0,0 +1,36 @@
+import { Event } from './events';
+import { Message } from './messages';
+export declare type DataCallback = (data: Message) => void;
+export interface MessageReader {
+    readonly onError: Event<Error>;
+    readonly onClose: Event<void>;
+    listen(callback: DataCallback): void;
+    unsubscribe(): void;
+}
+export declare abstract class AbstractMessageReader {
+    private errorEmitter;
+    private closeEmitter;
+    constructor();
+    unsubscribe(): void;
+    get onError(): Event<Error>;
+    protected fireError(error: any): void;
+    get onClose(): Event<void>;
+    protected fireClose(): void;
+    private asError;
+}
+export interface MessageWriter {
+    readonly onError: Event<[Error, Message | undefined, number | undefined]>;
+    readonly onClose: Event<void>;
+    write(msg: Message): void;
+    unsubscribe(): void;
+}
+export declare abstract class AbstractMessageWriter {
+    private errorEmitter;
+    private closeEmitter;
+    unsubscribe(): void;
+    get onError(): Event<[Error, Message | undefined, number | undefined]>;
+    protected fireError(error: any, message?: Message, count?: number): void;
+    get onClose(): Event<void>;
+    protected fireClose(): void;
+    private asError;
+}

package/lib/connections/jsonrpc2/transport.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractMessageWriter = exports.AbstractMessageReader = void 0;
+const events_1 = require("./events");
+class AbstractMessageReader {
+    constructor() {
+        this.errorEmitter = new events_1.Emitter();
+        this.closeEmitter = new events_1.Emitter();
+    }
+    unsubscribe() {
+        this.errorEmitter.unsubscribe();
+        this.closeEmitter.unsubscribe();
+    }
+    get onError() {
+        return this.errorEmitter.event;
+    }
+    fireError(error) {
+        this.errorEmitter.fire(this.asError(error));
+    }
+    get onClose() {
+        return this.closeEmitter.event;
+    }
+    fireClose() {
+        this.closeEmitter.fire(undefined);
+    }
+    asError(error) {
+        if (error instanceof Error) {
+            return error;
+        }
+        throw error;
+        // return new Error(
+        //     `Reader received error. Reason: ${typeof error.message === 'string' ? error.message : 'unknown'}`
+        // )
+    }
+}
+exports.AbstractMessageReader = AbstractMessageReader;
+class AbstractMessageWriter {
+    constructor() {
+        this.errorEmitter = new events_1.Emitter();
+        this.closeEmitter = new events_1.Emitter();
+    }
+    unsubscribe() {
+        this.errorEmitter.unsubscribe();
+        this.closeEmitter.unsubscribe();
+    }
+    get onError() {
+        return this.errorEmitter.event;
+    }
+    fireError(error, message, count) {
+        this.errorEmitter.fire([this.asError(error), message, count]);
+    }
+    get onClose() {
+        return this.closeEmitter.event;
+    }
+    fireClose() {
+        this.closeEmitter.fire(undefined);
+    }
+    asError(error) {
+        if (error instanceof Error) {
+            return error;
+        }
+        return new Error(`Writer received error. Reason: ${typeof error.message === 'string' ? error.message : 'unknown'}`);
+    }
+}
+exports.AbstractMessageWriter = AbstractMessageWriter;
+//# sourceMappingURL=transport.js.map

package/lib/connections/jsonrpc2/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../src/connections/jsonrpc2/transport.ts"],"names":[],"mappings":";;;AAAA,qCAAyC;AAczC,MAAsB,qBAAqB;IAIvC;QACI,IAAI,CAAC,YAAY,GAAG,IAAI,gBAAO,EAAS,CAAA;QACxC,IAAI,CAAC,YAAY,GAAG,IAAI,gBAAO,EAAQ,CAAA;IAC3C,CAAC;IAEM,WAAW;QACd,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,CAAA;QAC/B,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,CAAA;IACnC,CAAC;IAED,IAAW,OAAO;QACd,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAAA;IAClC,CAAC;IAES,SAAS,CAAC,KAAU;QAC1B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAA;IAC/C,CAAC;IAED,IAAW,OAAO;QACd,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAAA;IAClC,CAAC;IAES,SAAS;QACf,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IACrC,CAAC;IAEO,OAAO,CAAC,KAAU;QACtB,IAAI,KAAK,YAAY,KAAK,EAAE;YACxB,OAAO,KAAK,CAAA;SACf;QACD,MAAM,KAAK,CAAC;QACZ,oBAAoB;QACpB,wGAAwG;QACxG,IAAI;IACR,CAAC;CACJ;AAvCD,sDAuCC;AASD,MAAsB,qBAAqB;IAA3C;QACY,iBAAY,GAAG,IAAI,gBAAO,EAAoD,CAAA;QAC9E,iBAAY,GAAG,IAAI,gBAAO,EAAQ,CAAA;IA+B9C,CAAC;IA7BU,WAAW;QACd,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,CAAA;QAC/B,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,CAAA;IACnC,CAAC;IAED,IAAW,OAAO;QACd,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAAA;IAClC,CAAC;IAES,SAAS,CAAC,KAAU,EAAE,OAAiB,EAAE,KAAc;QAC7D,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAA;IACjE,CAAC;IAED,IAAW,OAAO;QACd,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAAA;IAClC,CAAC;IAES,SAAS;QACf,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IACrC,CAAC;IAEO,OAAO,CAAC,KAAU;QACtB,IAAI,KAAK,YAAY,KAAK,EAAE;YACxB,OAAO,KAAK,CAAA;SACf;QACD,OAAO,IAAI,KAAK,CACZ,kCAAkC,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,CACpG,CAAA;IACL,CAAC;CACJ;AAjCD,sDAiCC"}

package/lib/connections/jsonrpc2/transports/browser-websocket.js

@@ -0,0 +1,189 @@
+// import { MessageTransports } from '../connection'
+// import { Message } from '../messages';
+// import { AbstractMessageReader, AbstractMessageWriter, DataCallback, MessageReader, MessageWriter } from '../transport'
+// // import { MessageBuffer, MessageIO } from '../../../protocol/browser-message-io';
+// import { MessageType } from '../../../protocol/rpc-protocol';
+// export class WebSocketMessageReader extends AbstractMessageReader implements MessageReader {
+//     private pending: Message[] = [];
+//     private callback: DataCallback | null = null;
+//     public static deserialize(buff: MessageBuffer, type: any, req: any) {
+//         const id = buff.readUInt8();
+//         const method = buff.readShortString();
+//         try {
+//             const args = buff.readLongString();
+//             const params = JSON.parse(args) || [];
+//             return {
+//                 id,
+//                 req,
+//                 type,
+//                 method: method,
+//                 params: params,
+//                 jsonrpc: "2.0",
+//             };
+//         } catch (e) {
+//             return {
+//                 id,
+//                 req,
+//                 type,
+//                 params: [],
+//                 method: method,
+//                 jsonrpc: "2.0",
+//             };
+//         }
+//     }
+//     constructor(private socket: WebSocket) {
+//         super();
+//         console.log('reader.created: ', socket);
+//         socket.onmessage = (e: MessageEvent) => {
+//             try {
+//                 console.log('WS.MSG: ', e.data);
+//                 const message = this._receiveOneMessage(e.data as Buffer);
+//                 this.processMessage(message);
+//                 // const data = WebSocketMessageReader.deserialize(msg);
+//             } catch (err) {
+//                 console.log('ERROR:', err);
+//                 this.fireError(err);
+//             }
+//         };
+//         socket.onclose = () => this.fireClose();
+//         socket.onerror = err => this.fireError(err);
+//     }
+//     private _receiveOneMessage(rawmsg: Buffer): any {
+//         const msgLength = rawmsg.length;
+//         const buff = MessageBuffer.read(new DataView(rawmsg), 0);
+//         const messageType = <MessageType>buff.readUInt8();
+//         const req = buff.readUInt32();
+//         console.log({ messageType, req });
+//         switch (messageType) {
+//             case MessageType.RequestJSONArgs:
+//             case MessageType.RequestJSONArgsWithCancellation: {
+//                 return WebSocketMessageReader.deserialize(buff, messageType, req);
+//             }
+//             case MessageType.RequestMixedArgs:
+//             case MessageType.RequestMixedArgsWithCancellation: {
+//                 let { rpcId, method, args } = MessageIO.deserializeRequestMixedArgs(buff);
+//                 // this._receiveRequest(msgLength, req, rpcId, method, args, (messageType === MessageType.RequestMixedArgsWithCancellation));
+//                 break;
+//             }
+//             case MessageType.Acknowledged: {
+//                 // this._onDidReceiveAcknowledge(req);
+//                 break;
+//             }
+//             case MessageType.Cancel: {
+//                 // this._receiveCancel(msgLength, req);
+//                 break;
+//             }
+//             case MessageType.ReplyOKEmpty: {
+//                 return this._receiveReply(msgLength, req, undefined);
+//             }
+//             case MessageType.ReplyOKJSON: {
+//                 let value = MessageIO.deserializeReplyOKJSON(buff);
+//                 return this._receiveReply(msgLength, req, value);
+//             }
+//             case MessageType.ReplyOKBuffer: {
+//                 let value = MessageIO.deserializeReplyOKBuffer(buff);
+//                 this._receiveReply(msgLength, req, value);
+//                 break;
+//             }
+//             case MessageType.ReplyErrError: {
+//                 let err = MessageIO.deserializeReplyErrError(buff);
+//                 this._receiveReplyErr(msgLength, req, err);
+//                 break;
+//             }
+//             case MessageType.ReplyErrEmpty: {
+//                 this._receiveReplyErr(msgLength, req, undefined);
+//                 break;
+//             }
+//         }
+//     }
+//     private _receiveReplyErr(msgLength: number, req: number, value: any): any {
+//         let err: Error | null = null;
+//         if (value && value.$isError) {
+//             err = new Error();
+//             err.name = value.name;
+//             err.message = value.message;
+//             err.stack = value.stack;
+//         }
+//         return { req, id: null, error: err, jsonrpc: "2.0", complete: true };
+//     }
+//     private _receiveReply(msgLength: number, req: number, result: any): any {
+//         return { req, id: 0, result, jsonrpc: "2.0", complete: true };
+//     }
+//     private processMessage(message: any): void {
+//         if (this.callback) {
+//             this.callback(message);
+//         } else {
+//             this.pending.push(message);
+//         }
+//     }
+//     public listen(callback: DataCallback): void {
+//         if (this.callback) {
+//             throw new Error('callback is already set');
+//         }
+//         this.callback = callback;
+//         while (this.pending.length !== 0) {
+//             callback(this.pending.pop()!);
+//         }
+//     }
+//     public unsubscribe(): void {
+//         super.unsubscribe();
+//         this.callback = null;
+//         closeIfOpen(this.socket);
+//     }
+// }
+// class WebSocketMessageWriter extends AbstractMessageWriter implements MessageWriter {
+//     private errorCount = 0;
+//     constructor(private socket: WebSocket) {
+//         super();
+//         socket.onclose = () => this.fireClose();
+//     }
+//     public write(message: any): void {
+//         try {
+//             const [rpcId, method] = message.method.split('/');
+//             this.socket.send(MessageIO.serializeRequest(message.req, rpcId, method, message.params, false, null));
+//         } catch (err) {
+//             this.fireError(err, message, ++this.errorCount);
+//         }
+//     }
+//     public unsubscribe(): void {
+//         super.unsubscribe();
+//         closeIfOpen(this.socket);
+//     }
+// }
+// function closeIfOpen(socket: WebSocket): void {
+//     if (socket.readyState === socket.OPEN) {
+//         // 1000 means normal closure. See
+//         // https://www.iana.org/assignments/websocket/websocket.xml#close-code-number.
+//         socket.close(1000);
+//     }
+// }
+// /** Creates JSON-RPC2 message transports for a WebSocket. */
+// export function createWebSocketMessageTransports(socket: WebSocket): Promise<MessageTransports> {
+//     console.log('createWebSocketMessageTransports>>>', socket);
+//     const transports: MessageTransports = {
+//         reader: new WebSocketMessageReader(socket),
+//         writer: new WebSocketMessageWriter(socket),
+//     }
+//     if (socket.readyState === socket.OPEN) {
+//         return Promise.resolve(transports);
+//     }
+//     return new Promise<MessageTransports>((resolve, reject) => {
+//         function cleanup(): void {
+//             socket.removeEventListener('open', doResolve);
+//             socket.removeEventListener('close', doReject);
+//             socket.removeEventListener('error', doReject);
+//         }
+//         function doResolve(): void {
+//             cleanup();
+//             resolve(transports);
+//         }
+//         function doReject(err: any): void {
+//             cleanup();
+//             reject(err);
+//         }
+//         socket.addEventListener('open', doResolve);
+//         socket.addEventListener('close', doResolve);
+//         socket.addEventListener('error', doResolve);
+//     })
+// }
+//# sourceMappingURL=browser-websocket.js.map

package/lib/connections/jsonrpc2/transports/browser-websocket.js.map

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