Skip to main content
Version: v10.0.0

TrpcWebsocketAdapter

Socket adapter for tRPC subscriptions over WebSocket. It speaks the protocol of wsLink and

applyWSSHandler from @trpc/server/adapters/ws .

Every procedure called with one input is one server subscription, shared by the listeners with that input. Subscriptions started before the connection opens wait for it, and after a reconnect they are restarted with the id of the last tracked() event, so the server can resume. Queries and mutations are not supported - emit

throws.


Import
import { TrpcWebsocketAdapter } from "@hyper-fetch/trpc"

Usage​

const socket = new Socket({ url: "ws://localhost:3001", adapter: TrpcWebsocketAdapter({ transformer: superjson }) });
const api = createSocketSdk<typeof socket, TrpcSocketSchema<AppRouter>>(socket, { camelCaseToKebabCase: false });

api.user.onUpdate.$listener.setPayload({ id: 1 }).listen(({ data, extra }) => {});

Parameters​

TrpcWebsocketAdapter(__namedParameters: TrpcAdapterOptionsType)
Parameters
NameTypeDescription
__namedParameters
TrpcAdapterOptionsType

Returns​

class SocketAdapter<Extra, AdapterOptions, ListenerOptions, EmitterOptions, QueryParams, QueryParamsMapperType, ListenerQueryParams> {
constructor(options: { confirmsSubscriptions?: boolean; defaultConnected?: boolean; defaultConnecting?: boolean; defaultForceClosed?: boolean; defaultReconnectionAttempts?: number; name: string; queryParams?: QueryParams }) {};
unstable_queryParamsMapperConfig: Parameters<QueryParamsMapperType>[1];
unstable_queryParamsMapper: QueryParamsMapperType;
socket: SocketInstance;
reconnectionAttempts: number;
queryParamsConfig: QueryStringifyOptionsType;
queryParams: QueryParams;
options: { confirmsSubscriptions?: boolean; defaultConnected?: boolean; defaultConnecting?: boolean; defaultForceClosed?: boolean; defaultReconnectionAttempts?: number; name: string; queryParams?: QueryParams };
name: string;
listeners: Map<string, Map<ListenerCallbackType<SocketAdapter<Extra, AdapterOptions, ListenerOptions, EmitterOptions, QueryParams, QueryParamsMapperType, ListenerQueryParams>, any>, VoidFunction>>;
listenerOptions: ListenerOptions | EmptyTypes;
listenerLifecycle: Map<string, Map<ListenerCallbackType<SocketAdapter<Extra, AdapterOptions, ListenerOptions, EmitterOptions, QueryParams, QueryParamsMapperType, ListenerQueryParams>, any>, ListenerLifecycleType>>;
forceClosed: boolean;
emitterOptions: EmitterOptions | EmptyTypes;
defaultExtra: Extra;
connecting: boolean;
connected: boolean;
confirmsSubscriptions: boolean;
adapterOptions: AdapterOptions | EmptyTypes;
__listenerQueryParams: ListenerQueryParams;
connect() => () => void;
disconnect() => () => void;
emit() => (emitter: EmitterInstance) => void;
listen() => (listener: ListenerOfAdapter<SocketAdapter<Extra, AdapterOptions, ListenerOptions, EmitterOptions, QueryParams, QueryParamsMapperType, ListenerQueryParams>>, callback: ListenerCallbackType<SocketAdapter<Extra, AdapterOptions, ListenerOptions, EmitterOptions, QueryParams, QueryParamsMapperType, ListenerQueryParams>, any>) => RemoveListenerCallbackType;
reconnect() => () => void;
unstable_listenerQueryParamsResolver() => (callback: (...args: any[]) => unknown) => unknown;
dispose() => void;
initialize(socket: SocketInstance) => SocketAdapter<Extra, AdapterOptions, ListenerOptions, EmitterOptions, QueryParams, QueryParamsMapperType, ListenerQueryParams>;
removeListener(__namedParameters: { callback: ListenerCallbackType<SocketAdapter<Extra, AdapterOptions, ListenerOptions, EmitterOptions, QueryParams, QueryParamsMapperType, ListenerQueryParams>, any>; topic: string }) => boolean;
setConnected(connected: boolean) => SocketAdapter<Extra, AdapterOptions, ListenerOptions, EmitterOptions, QueryParams, QueryParamsMapperType, ListenerQueryParams>;
setConnecting(connecting: boolean) => SocketAdapter<Extra, AdapterOptions, ListenerOptions, EmitterOptions, QueryParams, QueryParamsMapperType, ListenerQueryParams>;
setConnector(connector: (bindings: { adapter: SocketAdapter<Extra, AdapterOptions, ListenerOptions, EmitterOptions, QueryParams, QueryParamsMapperType, ListenerQueryParams>; getQueryParams: (queryParams: undefined | QueryParams) => any; logger: LoggerMethods; onConnect: () => Promise<null | SocketConnectionType<SocketAdapter<Extra, AdapterOptions, ListenerOptions, EmitterOptions, QueryParams, QueryParamsMapperType, ListenerQueryParams>>>; onConnectFailed: (__namedParameters: { error: Error }) => void; onConnected: (__namedParameters: { resetAttempts?: boolean }) => void; onDisconnect: () => boolean; onDisconnected: () => void; onEmit: (__namedParameters: { emitter: EmitterInstance }) => Promise<null | EmitterInstance>; onEmitError: <ErrorType>(__namedParameters: { emitter: EmitterInstance; error: ErrorType }) => void; onError: (__namedParameters: { error: Error }) => void; onEvent: (__namedParameters: { callbacks?: ReadonlySet<ListenerCallbackType<SocketAdapter<Extra, AdapterOptions, ListenerOptions, EmitterOptions, QueryParams, QueryParamsMapperType, ListenerQueryParams>, any>>; data: any; extra: Extra; topic: string }) => void; onListen: (__namedParameters: { callback: ListenerCallbackType<SocketAdapter<Extra, AdapterOptions, ListenerOptions, EmitterOptions, QueryParams, QueryParamsMapperType, ListenerQueryParams>, any>; listener: Pick<ListenerOfAdapter<SocketAdapter<Extra, AdapterOptions, ListenerOptions, EmitterOptions, QueryParams, QueryParamsMapperType, ListenerQueryParams>>, topic>; onUnmount?: VoidFunction }) => () => void; onListenerEnd: (__namedParameters: { callbacks: ReadonlySet<ListenerCallbackType<SocketAdapter<Extra, AdapterOptions, ListenerOptions, EmitterOptions, QueryParams, QueryParamsMapperType, ListenerQueryParams>, any>>; error?: null | Error; topic: string }) => void; onListenerStart: (__namedParameters: { callbacks: ReadonlySet<ListenerCallbackType<SocketAdapter<Extra, AdapterOptions, ListenerOptions, EmitterOptions, QueryParams, QueryParamsMapperType, ListenerQueryParams>, any>>; topic: string }) => void; onReconnect: (__namedParameters: { connect: () => Promise<any>; disconnect: () => Promise<any>; manual?: boolean }) => Promise<boolean>; onReconnectFailed: (attempts: number) => void; socket: Socket<SocketAdapter<Extra, AdapterOptions, ListenerOptions, EmitterOptions, QueryParams, QueryParamsMapperType, ListenerQueryParams>> }) => Connector<SocketAdapter<Extra, AdapterOptions, ListenerOptions, EmitterOptions, QueryParams, QueryParamsMapperType, ListenerQueryParams>>) => SocketAdapter<Extra, AdapterOptions, ListenerOptions, EmitterOptions, QueryParams, QueryParamsMapperType, ListenerQueryParams>;
setDefaultEmitterOptions(emitterOptions: EmitterOptions | EmptyTypes) => SocketAdapter<Extra, AdapterOptions, ListenerOptions, EmitterOptions, QueryParams, QueryParamsMapperType, ListenerQueryParams>;
setDefaultExtra(defaultExtra: Extra) => SocketAdapter<Extra, AdapterOptions, ListenerOptions, EmitterOptions, QueryParams, QueryParamsMapperType, ListenerQueryParams>;
setDefaultListenerOptions(listenerOptions: ListenerOptions | EmptyTypes) => SocketAdapter<Extra, AdapterOptions, ListenerOptions, EmitterOptions, QueryParams, QueryParamsMapperType, ListenerQueryParams>;
setForceClosed(forceClosed: boolean) => SocketAdapter<Extra, AdapterOptions, ListenerOptions, EmitterOptions, QueryParams, QueryParamsMapperType, ListenerQueryParams>;
setListenerLifecycle(__namedParameters: { callback: ListenerCallbackType<SocketAdapter<Extra, AdapterOptions, ListenerOptions, EmitterOptions, QueryParams, QueryParamsMapperType, ListenerQueryParams>, any>; lifecycle: ListenerLifecycleType; topic: string }) => void;
setListenerQueryParamsResolver(resolver: (callback: (...args: any[]) => unknown) => unknown) => SocketAdapter<Extra, AdapterOptions, ListenerOptions, EmitterOptions, QueryParams, QueryParamsMapperType, ListenerQueryParams>;
setOptions(adapterOptions: AdapterOptions | EmptyTypes) => SocketAdapter<Extra, AdapterOptions, ListenerOptions, EmitterOptions, QueryParams, QueryParamsMapperType, ListenerQueryParams>;
setQueryParams(queryParams: QueryParams) => SocketAdapter<Extra, AdapterOptions, ListenerOptions, EmitterOptions, QueryParams, QueryParamsMapperType, ListenerQueryParams>;
setQueryParamsConfig(queryParamsConfig: QueryStringifyOptionsType) => SocketAdapter<Extra, AdapterOptions, ListenerOptions, EmitterOptions, QueryParams, QueryParamsMapperType, ListenerQueryParams>;
setQueryParamsMapper<NewQueryParamsMapper>(queryParamsMapper: NewQueryParamsMapper) => SocketAdapter<Extra, AdapterOptions, ListenerOptions, EmitterOptions, QueryParams, NewQueryParamsMapper, ListenerQueryParams>;
setQueryParamsMapperConfig<NewQueryParamsMapperConfig>(config: NewQueryParamsMapperConfig) => SocketAdapter<Extra, AdapterOptions, ListenerOptions, EmitterOptions, QueryParams, QueryParamsMapperType, ListenerQueryParams>;
setReconnectionAttempts(reconnectionAttempts: number) => SocketAdapter<Extra, AdapterOptions, ListenerOptions, EmitterOptions, QueryParams, QueryParamsMapperType, ListenerQueryParams>;
triggerListeners(__namedParameters: { callbacks?: ReadonlySet<ListenerCallbackType<any, any>>; data: any; extra: Extra; topic: string }) => void;
}
TrpcWebsocketAdapterType