@owlmeans/server-socket 0.1.0

package/build/service.d.ts

@@ -0,0 +1,5 @@
+import type { SocketService } from './types.js';
+import type { Config, Context } from '@owlmeans/server-api';
+export declare const createSocketService: (alias?: string) => SocketService;
+export declare const appendSocketService: <C extends Config, T extends Context<C>>(ctx: T, alias?: string) => T;
+//# sourceMappingURL=service.d.ts.map

package/build/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAW,MAAM,sBAAsB,CAAA;AAWpE,eAAO,MAAM,mBAAmB,WAAW,MAAM,KAAmB,aA4GnE,CAAA;AAED,eAAO,MAAM,mBAAmB,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,OACnE,CAAC,UAAS,MAAM,KACpB,CAOF,CAAA"}

package/build/service.js

@@ -0,0 +1,109 @@
+import { assertContext, createService } from '@owlmeans/context';
+import { DEFAULT_ALIAS } from './consts.js';
+import { canServerModule } from './utils/server.js';
+import { fastifyWebsocket } from '@fastify/websocket';
+import { authorize, executeResponse, extractContext, handleError, populateContext, provideRequest } from '@owlmeans/server-api/utils';
+import { ModuleOutcome, provideResponse } from '@owlmeans/module';
+import { ResilientError } from '@owlmeans/error';
+export const createSocketService = (alias = DEFAULT_ALIAS) => {
+    const service = createService(alias, {
+        update: async (api) => {
+            const closeListeners = [];
+            const ctx = assertContext(service.ctx, alias);
+            await api.server.register(fastifyWebsocket, {
+                preClose: () => closeListeners.forEach(listener => listener())
+            });
+            await api.server.register(async (server) => {
+                server.addHook('preHandler', async (req, reply) => {
+                    const context = extractContext(req, service.ctx, alias);
+                    await context?.modules()
+                        .filter(module => canServerModule(context, module) && !module.route.isIntermediate())
+                        .reduce(async (ctx, module) => {
+                        let context = await ctx;
+                        await module.resolve();
+                        if (!module.route.match(req)) {
+                            return context;
+                        }
+                        if (reply.sent) {
+                            return context;
+                        }
+                        try {
+                            const response = provideResponse(reply);
+                            const request = provideRequest(module.alias, req, true);
+                            const authorized = await authorize(context, module, req, reply);
+                            context = authorized[0];
+                            module = authorized[1];
+                            populateContext(req, context);
+                            // @TODO there code duplication with server-api
+                            const gates = module.getGates();
+                            for (const [srv, params] of gates) {
+                                const gate = context.service(srv);
+                                await gate.assert(request, response, params);
+                                executeResponse(response, reply, true);
+                            }
+                        }
+                        catch (error) {
+                            console.error(error);
+                            if (module.fixer != null) {
+                                const fixer = context.service(module.fixer);
+                                fixer.handle(reply, ResilientError.ensure(error));
+                            }
+                            else {
+                                handleError(error, reply);
+                            }
+                        }
+                        return context;
+                    }, Promise.resolve(context));
+                });
+                await Promise.all(ctx.modules().filter(module => canServerModule(ctx, module) && !module.route.isIntermediate()).map(async (module) => {
+                    await module.resolve();
+                    if (module.handle == null) {
+                        return;
+                    }
+                    server.get(module.getPath(), {
+                        schema: {
+                            querystring: module.filter?.query ?? {},
+                            params: module.filter?.params ?? {},
+                            response: module.filter?.response,
+                            headers: module.filter?.headers ?? {}
+                        }, websocket: true
+                    }, (conn, req) => {
+                        const request = provideRequest(module.alias, req, true);
+                        request.body = conn;
+                        conn.on('error', error => console.error('WebSocket error: ', error));
+                        void module.handle(request, {
+                            resolve: (value, outcome) => {
+                                conn.send(typeof value === 'string' ? value : JSON.stringify(value));
+                                if (outcome === ModuleOutcome.Ok) {
+                                    conn.close();
+                                }
+                            },
+                            reject: error => {
+                                console.error('Connection rejected: ', error);
+                                conn.close(1011, ResilientError.ensure(error).marshal().message);
+                            }
+                        });
+                        const close = () => conn.close(1001);
+                        closeListeners.push(close);
+                        conn.on('close', () => {
+                            const index = closeListeners.indexOf(close);
+                            if (index !== -1) {
+                                closeListeners.splice(index, 1);
+                            }
+                        });
+                    });
+                }));
+            });
+        }
+    }, service => async () => {
+        service.initialized = true;
+    });
+    return service;
+};
+export const appendSocketService = (ctx, alias = DEFAULT_ALIAS) => {
+    const service = createSocketService(alias);
+    const context = ctx;
+    context.registerService(service);
+    return context;
+};
+//# sourceMappingURL=service.js.map

package/build/service.js.map

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

package/build/types.d.ts

@@ -0,0 +1,11 @@
+import type { InitializedService } from '@owlmeans/context';
+import type { ApiServer, ApiServerAppend } from '@owlmeans/server-api';
+import type { ServerConfig, ServerContext } from '@owlmeans/server-context';
+export interface SocketService extends InitializedService {
+    update: (api: ApiServer) => Promise<void>;
+}
+export interface Config extends ServerConfig {
+}
+export interface Context<C extends Config = Config> extends ServerContext<C>, ApiServerAppend {
+}
+//# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAE3E,MAAM,WAAW,aAAc,SAAQ,kBAAkB;IACvD,MAAM,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1C;AAED,MAAM,WAAW,MAAO,SAAQ,YAAY;CAAI;AAEhD,MAAM,WAAW,OAAO,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,aAAa,CAAC,CAAC,CAAC,EACxE,eAAe;CAAI"}

package/build/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/build/utils/connection.d.ts

@@ -0,0 +1,6 @@
+import type { WebSocket } from '@fastify/websocket';
+import type { Connection } from '@owlmeans/socket';
+import type { Config, Context } from '@owlmeans/server-api';
+import { AbstractRequest } from '@owlmeans/module';
+export declare const makeConnection: <C extends Config, T extends Context<C> = Context<C>>(request: AbstractRequest<WebSocket>, context: T) => Connection;
+//# sourceMappingURL=connection.d.ts.map

package/build/utils/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/utils/connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,kBAAkB,CAAA;AAChE,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAI3D,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAOlD,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,wBAC1D,eAAe,CAAC,SAAS,CAAC,WAAW,CAAC,KAC9C,UA4GF,CAAA"}

package/build/utils/connection.js

@@ -0,0 +1,104 @@
+import { SocketUnsupported, createBasicConnection, MessageType, SocketInitializationError, SocketUnauthorized } from '@owlmeans/socket';
+import { AuthenticationStage, AUTH_QUERY } from '@owlmeans/auth';
+import { isAuth, isAuthCredentials, isAuthToken } from '@owlmeans/auth';
+import { EnvelopeKind, makeEnvelopeModel } from '@owlmeans/basic-envelope';
+export const makeConnection = (request, context) => {
+    if (request.body == null) {
+        throw new SocketInitializationError('request');
+    }
+    let auth = undefined;
+    const conn = request.body;
+    const model = createBasicConnection();
+    model.close = async () => {
+        await conn.close();
+        // @TODO check if on close event is triggered
+    };
+    model.send = async (message) => {
+        if (typeof message !== 'string') {
+            model.prepare?.(message);
+        }
+        await conn.send(typeof message === 'string' ? message : JSON.stringify(message));
+    };
+    // @TODO This method is fully supported only by authentication services
+    model.authenticate = async (stage, payload) => {
+        if (AuthenticationStage.Authenticate === stage) {
+            if (isAuthToken(payload)) {
+                const ctx = context;
+                const _auth = await ctx.auth().authenticate(payload);
+                if (_auth == null) {
+                    throw new SocketUnauthorized(stage);
+                }
+                const model = makeEnvelopeModel(_auth.token, EnvelopeKind.Token);
+                auth = model.message();
+                return [AuthenticationStage.Authenticated, _auth];
+            }
+            if (isAuth(payload)) {
+                auth = payload;
+                return [stage, auth];
+            }
+        }
+        else if (AuthenticationStage.Authenticated === stage) {
+            if (auth == null) {
+                throw new SocketUnauthorized(stage);
+            }
+            return [stage, auth];
+        }
+        throw new SocketUnsupported('auth-service');
+    };
+    model.prepare = (message, isRequest) => {
+        if (auth === undefined) {
+            auth = null;
+            try {
+                let authorization = request.query?.[AUTH_QUERY];
+                if (authorization != null) {
+                    const envelope = makeEnvelopeModel(authorization, EnvelopeKind.Token);
+                    const _auth = envelope.message();
+                    if (isAuth(_auth) || isAuthCredentials(_auth)) {
+                        auth = _auth;
+                    }
+                }
+            }
+            catch {
+                auth = null;
+            }
+        }
+        if (isRequest) {
+            message.dt = message.dt ?? Date.now();
+            if (auth != null && message.recipient == null) {
+                message.recipient = auth.profileId ?? auth.userId;
+            }
+            if (message.sender == null) {
+                // @TODO think about using dids here
+                message.sender = context.cfg.service;
+            }
+        }
+        else {
+            if (auth != null && message.sender == null) {
+                message.sender = auth.profileId ?? auth.userId;
+            }
+        }
+        return message;
+    };
+    const messageHandler = async (_message) => {
+        _message = Array.isArray(_message) ? _message : [_message];
+        const message = _message.map(msg => msg.toString('utf8')).join('');
+        await model.receive(message);
+    };
+    const closeHandler = async (code) => {
+        const msg = {
+            type: MessageType.System,
+            event: 'close',
+            payload: { code }
+        };
+        if (model.prepare != null) {
+            model.prepare(msg);
+        }
+        await Promise.all(model.getListeners().map(async (listener) => listener(msg)));
+        conn.off('message', messageHandler);
+        conn.off('close', closeHandler);
+    };
+    conn.on('message', messageHandler);
+    conn.on('close', closeHandler);
+    return model;
+};
+//# sourceMappingURL=connection.js.map

package/build/utils/connection.js.map

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

package/build/utils/index.d.ts

@@ -0,0 +1,3 @@
+export * from './server.js';
+export * from './connection.js';
+//# sourceMappingURL=index.d.ts.map

package/build/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA"}

package/build/utils/index.js

@@ -0,0 +1,3 @@
+export * from './server.js';
+export * from './connection.js';
+//# sourceMappingURL=index.js.map

package/build/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA"}

package/build/utils/server.d.ts

@@ -0,0 +1,5 @@
+import type { CommonModule } from '@owlmeans/module';
+import type { ServerModule } from '@owlmeans/server-module';
+import type { Context } from '@owlmeans/server-api';
+export declare const canServerModule: (context: Context, module: CommonModule) => module is ServerModule<unknown>;
+//# sourceMappingURL=server.d.ts.map

package/build/utils/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/utils/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAG3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAEnD,eAAO,MAAM,eAAe,YAAa,OAAO,UAAU,YAAY,KAAG,MAAM,IAAI,YAAY,CAAC,OAAO,CActG,CAAA"}

package/build/utils/server.js

@@ -0,0 +1,15 @@
+import { RouteProtocols } from '@owlmeans/route';
+import { AppType } from '@owlmeans/context';
+export const canServerModule = (context, module) => {
+    if (module.route.route.type !== AppType.Backend) {
+        return false;
+    }
+    if (module.route.route.service != null && module.route.route.service !== context.cfg.service) {
+        return false;
+    }
+    if (module.route.route.protocol !== RouteProtocols.SOCKET) {
+        return false;
+    }
+    return 'isIntermediate' in module.route;
+};
+//# sourceMappingURL=server.js.map

package/build/utils/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/utils/server.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAG3C,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAgB,EAAE,MAAoB,EAAmC,EAAE;IACzG,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC;QAChD,OAAO,KAAK,CAAA;IACd,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,IAAI,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,KAAK,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAC7F,OAAO,KAAK,CAAA;IACd,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,KAAK,cAAc,CAAC,MAAM,EAAE,CAAC;QAC1D,OAAO,KAAK,CAAA;IACd,CAAC;IAED,OAAO,gBAAgB,IAAI,MAAM,CAAC,KAAK,CAAA;AACzC,CAAC,CAAA"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@owlmeans/server-socket",
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "sleep 324 && nodemon -e ts,tsx,json --watch src --exec \"tsc -p ./tsconfig.json\"",
+    "watch": "tsc -b -w --preserveWatchOutput --pretty"
+  },
+  "main": "build/index.js",
+  "module": "build/index.js",
+  "types": "build/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./build/index.js",
+      "require": "./build/index.js",
+      "default": "./build/index.js",
+      "module": "./build/index.js",
+      "types": "./build/index.d.ts"
+    }
+  },
+  "devDependencies": {
+    "@types/connect": "^3.4.38",
+    "nodemon": "^3.1.7",
+    "typescript": "^5.6.3"
+  },
+  "peerDependencies": {
+    "fastify": "*"
+  },
+  "dependencies": {
+    "@fastify/websocket": "^11.0.1",
+    "@owlmeans/auth": "^0.1.0",
+    "@owlmeans/basic-envelope": "^0.1.0",
+    "@owlmeans/context": "^0.1.0",
+    "@owlmeans/module": "^0.1.0",
+    "@owlmeans/server-api": "^0.1.0",
+    "@owlmeans/server-auth": "^0.1.0",
+    "@owlmeans/server-context": "^0.1.0",
+    "@owlmeans/server-module": "^0.1.0",
+    "@owlmeans/socket": "^0.1.0"
+  },
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/consts.ts

@@ -0,0 +1,2 @@
+
+export const DEFAULT_ALIAS = 'socket-server'

package/src/helper.ts

@@ -0,0 +1,21 @@
+import { assertContext } from '@owlmeans/context'
+import type { AbstractRequest, AbstractResponse } from '@owlmeans/module'
+import type { Context } from '@owlmeans/server-api'
+import type { RefedModuleHandler } from '@owlmeans/server-module'
+import type { Connection } from '@owlmeans/socket'
+import type { WebSocket } from '@fastify/websocket'
+import { makeConnection } from './utils/connection.js'
+
+export const handleConnection: <T extends Connection = Connection>(
+  handler: (conn: T, ctx: Context, req: AbstractRequest<WebSocket>, res: AbstractResponse<any>) => Promise<void>
+) => RefedModuleHandler<AbstractResponse<any>> = handler => ref => async (req, res) => {
+  const ctx = assertContext(ref.ref?.ctx) as Context
+  try {
+    await handler(makeConnection(req, ctx) as any, ctx, req, res)
+  } catch (e) {
+    res.reject(e as Error)
+  }
+
+  // Actually it does nothing - just for compatibility here
+  return res.value
+}

package/src/index.ts

@@ -0,0 +1,6 @@
+
+export type * from './types.js'
+export * from './middleware.js'
+export * from './consts.js'
+export * from './service.js'
+export * from './helper.js'

package/src/middleware.ts

@@ -0,0 +1,32 @@
+
+import type { Middleware } from '@owlmeans/context'
+import { MiddlewareType, MiddlewareStage, assertContext } from '@owlmeans/context'
+import type { SocketService } from './types.js'
+import { DEFAULT_ALIAS as WEB_ALIAS } from '@owlmeans/server-api'
+import type { ApiServer, Config, Context, } from '@owlmeans/server-api'
+import { DEFAULT_ALIAS } from './consts.js'
+
+
+export const createSocketMiddleware = (web: string = WEB_ALIAS, socket = DEFAULT_ALIAS): Middleware => {
+  const middleware: Middleware = {
+    type: MiddlewareType.Context,
+    stage: MiddlewareStage.Loading,
+    apply: async ctx => {
+      const context = assertContext<Config, Context>(ctx as unknown as Context, 'socket-middleware')
+      const webService = context.service<ApiServer>(web)
+      const socketService = context.service<SocketService>(socket)
+      // @TODO There is some middlewares that are ok to work only once during context intialization
+      
+      const marker = `__socketServiceAdded-${web}-${socket}`
+      if (!ctx.cfg.records?.find(record => record.id === marker)) {
+        await socketService.update(webService)
+        if (ctx.cfg.records == null) {
+          ctx.cfg.records = []
+        }
+        ctx.cfg.records.push({ id: marker })
+      }
+    }
+  }
+
+  return middleware
+}

package/src/service.ts

@@ -0,0 +1,133 @@
+import { assertContext, createService } from '@owlmeans/context'
+import type { SocketService } from './types.js'
+import type { Config, Context, Request } from '@owlmeans/server-api'
+import { DEFAULT_ALIAS } from './consts.js'
+import type { FixerService, ServerModule } from '@owlmeans/server-module'
+import { canServerModule } from './utils/server.js'
+import { fastifyWebsocket } from '@fastify/websocket'
+import type { WebSocket } from '@fastify/websocket'
+import { authorize, executeResponse, extractContext, handleError, populateContext, provideRequest } from '@owlmeans/server-api/utils'
+import { ModuleOutcome, provideResponse } from '@owlmeans/module'
+import type { AbstractRequest, GateService } from '@owlmeans/module'
+import { ResilientError } from '@owlmeans/error'
+
+export const createSocketService = (alias: string = DEFAULT_ALIAS): SocketService => {
+  const service: SocketService = createService<SocketService>(alias, {
+    update: async api => {
+      const closeListeners: CallableFunction[] = []
+      const ctx = assertContext<Config, Context>(service.ctx as Context, alias)
+      await api.server.register(fastifyWebsocket, {
+        preClose: () => closeListeners.forEach(listener => listener())
+      })
+
+      await api.server.register(async server => {
+        server.addHook('preHandler', async (req, reply) => {
+          const context = extractContext(req, service.ctx as Context, alias)
+          await context?.modules<ServerModule<Request>>()
+            .filter(module => canServerModule(context, module) && !module.route.isIntermediate())
+            .reduce<Promise<Context>>(async (ctx, module) => {
+              let context = await ctx
+              await module.resolve()
+
+              if (!module.route.match(req)) {
+                return context
+              }
+
+              if (reply.sent) {
+                return context
+              }
+
+              try {
+                const response = provideResponse(reply)
+                const request = provideRequest(module.alias, req, true)
+
+                const authorized = await authorize(context, module, req, reply)
+                context = authorized[0]
+                module = authorized[1]
+
+                populateContext(req, context)
+
+                // @TODO there code duplication with server-api
+                const gates = module.getGates()
+                for (const [srv, params] of gates) {
+                  const gate: GateService = context.service(srv)
+                  await gate.assert(request, response, params)
+                  executeResponse(response, reply, true)
+                }
+              } catch (error) {
+                console.error(error)
+                if (module.fixer != null) {
+                  const fixer: FixerService = context.service(module.fixer)
+                  fixer.handle(reply, ResilientError.ensure(error as Error))
+                } else {
+                  handleError(error as Error, reply)
+                }
+              }
+
+              return context
+            }, Promise.resolve(context))
+        })
+
+        await Promise.all(ctx.modules<ServerModule<Request>>().filter(
+          module => canServerModule(ctx, module) && !module.route.isIntermediate()
+        ).map(async module => {
+          await module.resolve()
+          if (module.handle == null) {
+            return
+          }
+
+          server.get(module.getPath(), {
+            schema: {
+              querystring: module.filter?.query ?? {},
+              params: module.filter?.params ?? {},
+              response: module.filter?.response,
+              headers: module.filter?.headers ?? {}
+            }, websocket: true
+          }, (conn, req) => {
+            const request = provideRequest(module.alias, req, true)
+            request.body = conn
+
+            conn.on('error', error => console.error('WebSocket error: ', error))
+
+            void module.handle<AbstractRequest<WebSocket>>(request, {
+              resolve: (value, outcome) => {
+                conn.send(typeof value === 'string' ? value : JSON.stringify(value))
+                if (outcome === ModuleOutcome.Ok) {
+                  conn.close()
+                }
+              },
+              reject: error => {
+                console.error('Connection rejected: ', error)
+                conn.close(1011, ResilientError.ensure(error).marshal().message)
+              }
+            })
+
+            const close = () => conn.close(1001)
+            closeListeners.push(close)
+            conn.on('close', () => {
+              const index = closeListeners.indexOf(close)
+              if (index !== -1) {
+                closeListeners.splice(index, 1)
+              }
+            })
+          })
+        }))
+      })
+    }
+  }, service => async () => {
+    service.initialized = true
+  })
+
+  return service
+}
+
+export const appendSocketService = <C extends Config, T extends Context<C>>(
+  ctx: T, alias: string = DEFAULT_ALIAS
+): T => {
+  const service = createSocketService(alias)
+  const context = ctx as T
+
+  context.registerService(service)
+
+  return context
+}

package/src/types.ts

@@ -0,0 +1,12 @@
+import type { InitializedService } from '@owlmeans/context'
+import type { ApiServer, ApiServerAppend } from '@owlmeans/server-api'
+import type { ServerConfig, ServerContext } from '@owlmeans/server-context'
+
+export interface SocketService extends InitializedService {
+  update: (api: ApiServer) => Promise<void>
+}
+
+export interface Config extends ServerConfig { }
+
+export interface Context<C extends Config = Config> extends ServerContext<C>
+  , ApiServerAppend { }