@socket-mesh/core 1.0.2 → 1.0.4

package/dist/socket-transport.d.ts

@@ -1,95 +1,92 @@
-import { CodecEngine } from "@socket-mesh/formatter";
-import ws from "isomorphic-ws";
-import { Plugin } from "./plugins/plugin.js";
-import { AnyRequest, InvokeMethodRequest, InvokeServiceRequest, TransmitMethodRequest, TransmitServiceRequest } from "./request.js";
-import { AnyPacket } from "./packet.js";
-import { FunctionReturnType, MethodMap, ServiceMap } from "./maps/method-map.js";
-import { AnyResponse } from "./response.js";
-import { AuthToken, SignedAuthToken } from "@socket-mesh/auth";
-import { Socket, SocketOptions, SocketStatus, StreamCleanupMode } from "./socket.js";
-import { SocketMap } from "./maps/socket-map.js";
+import { AuthToken, SignedAuthToken } from '@socket-mesh/auth';
+import { CodecEngine } from '@socket-mesh/formatter';
+import ws from 'isomorphic-ws';
+import { FunctionReturnType, MethodMap, PrivateMethodMap, PublicMethodMap, ServiceMap } from './maps/method-map.js';
+import { AnyPacket } from './packet.js';
+import { Plugin } from './plugins/plugin.js';
+import { AnyRequest, InvokeMethodRequest, InvokeServiceRequest, TransmitMethodRequest, TransmitServiceRequest } from './request.js';
+import { AnyResponse } from './response.js';
+import { Socket, SocketOptions, SocketStatus, StreamCleanupMode } from './socket.js';
 export type CallIdGenerator = () => number;
+export interface InboundMessage<TIncoming extends MethodMap, TOutgoing extends PublicMethodMap, TPrivateOutgoing extends PrivateMethodMap, TService extends ServiceMap> {
+    packet: (AnyPacket<TIncoming, TService> | AnyResponse<TOutgoing, TPrivateOutgoing, TService>)[] | (AnyPacket<TIncoming, TService> | AnyResponse<TOutgoing, TPrivateOutgoing, TService>) | null;
+    timestamp: Date;
+}
 export interface InvokeMethodOptions<TMethodMap extends MethodMap, TMethod extends keyof TMethodMap> {
+    ackTimeoutMs?: false | number;
     method: TMethod;
-    ackTimeoutMs?: number | false;
 }
 export interface InvokeServiceOptions<TServiceMap extends ServiceMap, TService extends keyof TServiceMap, TMethod extends keyof TServiceMap[TService]> {
-    service: TService;
+    ackTimeoutMs?: false | number;
     method: TMethod;
-    ackTimeoutMs?: number | false;
-}
-export interface InboundMessage<T extends SocketMap> {
-    timestamp: Date;
-    packet: (AnyPacket<T> | AnyResponse<T>) | (AnyPacket<T> | AnyResponse<T>)[];
+    service: TService;
 }
-export declare class SocketTransport<T extends SocketMap> {
-    private _socket;
-    private _webSocket;
+export declare class SocketTransport<TIncoming extends MethodMap, TOutgoing extends PublicMethodMap, TPrivateOutgoing extends PrivateMethodMap, TService extends ServiceMap, TState extends object> {
+    private _authToken;
+    private readonly _callbackMap;
+    private readonly _callIdGenerator;
+    private readonly _handlers;
     private _inboundProcessedMessageCount;
     private _inboundReceivedMessageCount;
+    private _isReady;
     private _outboundPreparedMessageCount;
     private _outboundSentMessageCount;
-    private _isReady;
-    private _authToken?;
-    private _signedAuthToken?;
-    private readonly _callIdGenerator;
-    private readonly _callbackMap;
-    private readonly _handlers;
-    private _onUnhandledRequest;
+    private _pingTimeoutRef;
+    private _signedAuthToken;
+    private _socket;
+    private _webSocket;
+    ackTimeoutMs: number;
     readonly codecEngine: CodecEngine;
-    readonly plugins: Plugin<T>[];
+    id: null | string;
+    readonly plugins: Plugin<TIncoming, TOutgoing, TPrivateOutgoing, TService, TState>[];
     streamCleanupMode: StreamCleanupMode;
-    id: string | null;
-    ackTimeoutMs: number;
-    private _pingTimeoutRef;
-    protected constructor(options?: SocketOptions<T>);
+    protected constructor(options?: SocketOptions<TIncoming, TOutgoing, TPrivateOutgoing, TService, TState>);
     protected abortAllPendingCallbacksDueToBadConnection(status: SocketStatus): void;
-    get authToken(): AuthToken;
+    get authToken(): AuthToken | null;
     changeToUnauthenticatedState(): Promise<boolean>;
     protected decode(data: string | ws.RawData): any;
     disconnect(code?: number, reason?: string): void;
     getBackpressure(): number;
     getInboundBackpressure(): number;
     getOutboundBackpressure(): number;
-    protected handleInboudMessage({ packet, timestamp }: InboundMessage<T>): Promise<void>;
+    protected handleInboudMessage({ packet, timestamp }: InboundMessage<TIncoming, TOutgoing, TPrivateOutgoing, TService>): Promise<void>;
+    invoke<TMethod extends keyof TOutgoing>(method: TMethod, arg?: Parameters<TOutgoing[TMethod]>[0]): [Promise<FunctionReturnType<TOutgoing[TMethod]>>, () => void];
+    invoke<TServiceName extends keyof TService, TMethod extends keyof TService[TServiceName]>(options: [TServiceName, TMethod, (false | number)?], arg?: Parameters<TService[TServiceName][TMethod]>[0]): [Promise<FunctionReturnType<TService[TServiceName][TMethod]>>, () => void];
+    invoke<TServiceName extends keyof TService, TMethod extends keyof TService[TServiceName]>(options: InvokeServiceOptions<TService, TServiceName, TMethod>, arg?: Parameters<TService[TServiceName][TMethod]>[0]): [Promise<FunctionReturnType<TService[TServiceName][TMethod]>>, () => void];
+    invoke<TMethod extends keyof TOutgoing>(options: InvokeMethodOptions<TOutgoing, TMethod>, arg?: Parameters<TOutgoing[TMethod]>[0]): [Promise<FunctionReturnType<TOutgoing[TMethod]>>, () => void];
+    invoke<TMethod extends keyof TPrivateOutgoing>(method: TMethod, arg: Parameters<TPrivateOutgoing[TMethod]>[0]): [Promise<FunctionReturnType<TPrivateOutgoing[TMethod]>>, () => void];
+    invoke<TMethod extends keyof TPrivateOutgoing>(options: InvokeMethodOptions<TPrivateOutgoing, TMethod>, arg?: Parameters<TPrivateOutgoing[TMethod]>[0]): [Promise<FunctionReturnType<TPrivateOutgoing[TMethod]>>, () => void];
     protected onClose(code: number, reason?: Buffer | string): void;
     protected onDisconnect(status: SocketStatus, code: number, reason?: string): void;
     onError(error: Error): void;
-    protected onInvoke<TService extends keyof T['Service'], TServiceMethod extends keyof T['Service'][TService], TMethod extends keyof T['Outgoing'], TPrivateMethod extends keyof T['PrivateOutgoing']>(request: InvokeMethodRequest<T["Outgoing"], TMethod> | InvokeMethodRequest<T["PrivateOutgoing"], TPrivateMethod> | InvokeServiceRequest<T["Service"], TService, TServiceMethod>): void;
+    protected onInvoke<TServiceName extends keyof TService, TServiceMethod extends keyof TService[TServiceName], TMethod extends keyof TOutgoing, TPrivateMethod extends keyof TPrivateOutgoing>(request: InvokeMethodRequest<TOutgoing, TMethod> | InvokeMethodRequest<TPrivateOutgoing, TPrivateMethod> | InvokeServiceRequest<TService, TServiceName, TServiceMethod>): void;
     protected onMessage(data: ws.Data, isBinary: boolean): void;
     protected onOpen(): void;
     protected onPingPong(): void;
-    protected onRequest(packet: AnyPacket<T>, timestamp: Date, pluginError?: Error): Promise<boolean>;
-    protected onResponse(response: AnyResponse<T>, pluginError?: Error): void;
+    protected onRequest(packet: AnyPacket<TIncoming, TService>, timestamp: Date, pluginError?: Error): Promise<boolean>;
+    protected onResponse(response: AnyResponse<TOutgoing, TPrivateOutgoing, TService>, pluginError?: Error): void;
     private onSocketClose;
     private onSocketError;
     private onSocketMessage;
-    protected onTransmit<TService extends keyof T['Service'], TServiceMethod extends keyof T['Service'][TService], TMethod extends keyof T['Outgoing']>(request: TransmitMethodRequest<T['Outgoing'], TMethod> | TransmitServiceRequest<T['Service'], TService, TServiceMethod>): void;
-    protected onUnhandledRequest(packet: AnyPacket<T>): boolean;
-    protected resetPingTimeout(timeoutMs: number | false, code: number): void;
+    protected onTransmit<TServiceName extends keyof TService, TServiceMethod extends keyof TService[TServiceName], TMethod extends keyof TOutgoing>(request: TransmitMethodRequest<TOutgoing, TMethod> | TransmitServiceRequest<TService, TServiceName, TServiceMethod>): void;
+    protected onUnhandledRequest(packet: AnyPacket<TIncoming, TService>): boolean;
+    protected resetPingTimeout(timeoutMs: false | number, code: number): void;
     send(data: Buffer | string): Promise<void>;
-    protected sendRequest(requests: (AnyRequest<T>)[]): void;
-    protected sendRequest(index: number, requests: (AnyRequest<T>)[]): void;
-    protected sendResponse(responses: (AnyResponse<T>)[]): void;
-    protected sendResponse(index: number, responses: (AnyResponse<T>)[]): void;
-    setAuthorization(authToken: AuthToken): Promise<boolean>;
+    protected sendRequest(requests: (AnyRequest<TOutgoing, TPrivateOutgoing, TService>)[]): void;
+    protected sendRequest(index: number, requests: (AnyRequest<TOutgoing, TPrivateOutgoing, TService>)[]): void;
+    protected sendResponse(responses: (AnyResponse<TOutgoing, TPrivateOutgoing, TService>)[]): void;
+    protected sendResponse(index: number, responses: (AnyResponse<TOutgoing, TPrivateOutgoing, TService>)[]): void;
     setAuthorization(signedAuthToken: SignedAuthToken, authToken?: AuthToken): Promise<boolean>;
     setReadyStatus(pingTimeoutMs: number, authError?: Error): void;
-    get signedAuthToken(): SignedAuthToken;
-    get socket(): Socket<T>;
-    set socket(value: Socket<T>);
+    get signedAuthToken(): null | SignedAuthToken;
+    get socket(): Socket<TIncoming, TOutgoing, TPrivateOutgoing, TService, TState>;
+    set socket(value: Socket<TIncoming, TOutgoing, TPrivateOutgoing, TService, TState>);
     get status(): SocketStatus;
+    transmit<TMethod extends keyof TOutgoing>(method: TMethod, arg?: Parameters<TOutgoing[TMethod]>[0]): Promise<void>;
+    transmit<TServiceName extends keyof TService, TMethod extends keyof TService[TServiceName]>(options: [TServiceName, TMethod], arg?: Parameters<TService[TServiceName][TMethod]>[0]): Promise<void>;
+    transmit<TMethod extends keyof TPrivateOutgoing>(method: TMethod, arg?: Parameters<TPrivateOutgoing[TMethod]>[0]): Promise<void>;
     triggerAuthenticationEvents(wasSigned: boolean, wasAuthenticated: boolean): void;
-    transmit<TMethod extends keyof T['Outgoing']>(method: TMethod, arg?: Parameters<T['Outgoing'][TMethod]>[0]): Promise<void>;
-    transmit<TService extends keyof T['Service'], TMethod extends keyof T['Service'][TService]>(options: [TService, TMethod], arg?: Parameters<T['Service'][TService][TMethod]>[0]): Promise<void>;
-    transmit<TMethod extends keyof T['PrivateOutgoing']>(method: TMethod, arg?: Parameters<T['PrivateOutgoing'][TMethod]>[0]): Promise<void>;
-    invoke<TMethod extends keyof T['Outgoing']>(method: TMethod, arg?: Parameters<T['Outgoing'][TMethod]>[0]): [Promise<FunctionReturnType<T['Outgoing'][TMethod]>>, () => void];
-    invoke<TService extends keyof T['Service'], TMethod extends keyof T['Service'][TService]>(options: [TService, TMethod, (number | false)?], arg?: Parameters<T['Service'][TService][TMethod]>[0]): [Promise<FunctionReturnType<T['Service'][TService][TMethod]>>, () => void];
-    invoke<TService extends keyof T['Service'], TMethod extends keyof T['Service'][TService]>(options: InvokeServiceOptions<T['Service'], TService, TMethod>, arg?: Parameters<T['Service'][TService][TMethod]>[0]): [Promise<FunctionReturnType<T['Service'][TService][TMethod]>>, () => void];
-    invoke<TMethod extends keyof T['Outgoing']>(options: InvokeMethodOptions<T['Outgoing'], TMethod>, arg?: Parameters<T['Outgoing'][TMethod]>[0]): [Promise<FunctionReturnType<T['Outgoing'][TMethod]>>, () => void];
-    invoke<TMethod extends keyof T['PrivateOutgoing']>(method: TMethod, arg: Parameters<T['PrivateOutgoing'][TMethod]>[0]): [Promise<FunctionReturnType<T['PrivateOutgoing'][TMethod]>>, () => void];
-    invoke<TMethod extends keyof T['PrivateOutgoing']>(options: InvokeMethodOptions<T['PrivateOutgoing'], TMethod>, arg?: Parameters<T['PrivateOutgoing'][TMethod]>[0]): [Promise<FunctionReturnType<T['PrivateOutgoing'][TMethod]>>, () => void];
     get url(): string;
-    protected get webSocket(): ws.WebSocket;
-    protected set webSocket(value: ws.WebSocket | null);
+    protected get webSocket(): null | ws.WebSocket;
+    protected set webSocket(value: null | ws.WebSocket);
 }