@nyirusu/nact-websocket-server 0.0.0-stage → 1.0.4

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+import http from 'node:http';
+import type { ServerHandle, ServerProvider, Channel } from '@nyirusu/nasdk/NACT';
+export type WebSocketServerOptions = {
+    host: string;
+    port: number;
+    path?: string;
+    noServer?: false;
+} | {
+    noServer: true;
+    path?: never;
+    host?: never;
+    port?: never;
+};
+export interface WebSocketServerTransportSpec {
+    type: 'websocket';
+    provider: WebSocketServerOptions;
+    nact?: {
+        chunkSize?: number;
+    };
+}
+export default class WebSocketServerProvider implements ServerProvider<'websocket', WebSocketServerOptions> {
+    readonly type = "websocket";
+    readonly role = "server";
+    readonly defaultChunkSize: number;
+    private websocket?;
+    private detach;
+    attach(server: http.Server, options?: {
+        path?: string;
+    }): () => void;
+    private attachServer;
+    listen(options: WebSocketServerOptions, accept: (channel: Channel) => void): Promise<ServerHandle>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAA;AAG5B,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAEhF,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,KAAK,CAAA;CACjB,GAAG;IACF,QAAQ,EAAE,IAAI,CAAA;IACd,IAAI,CAAC,EAAE,KAAK,CAAA;IACZ,IAAI,CAAC,EAAE,KAAK,CAAA;IACZ,IAAI,CAAC,EAAE,KAAK,CAAA;CACb,CAAA;AACD,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,WAAW,CAAA;IACjB,QAAQ,EAAE,sBAAsB,CAAA;IAChC,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAC9B;AAgCD,MAAM,CAAC,OAAO,OAAO,uBACnB,YAAW,cAAc,CAAC,WAAW,EAAE,sBAAsB,CAAC;IAC9D,QAAQ,CAAC,IAAI,eAAc;IAC3B,QAAQ,CAAC,IAAI,YAAW;IACxB,QAAQ,CAAC,gBAAgB,SAAoB;IAC7C,OAAO,CAAC,SAAS,CAAC,CAAiB;IACnC,OAAO,CAAC,MAAM,CAAwB;IAEtC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,MAAM,IAAI;IAKxE,OAAO,CAAC,YAAY;IAed,MAAM,CAAC,OAAO,EAAE,sBAAsB,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC;CAiCzG"}

package/dist/index.js

@@ -0,0 +1,108 @@
+import http from 'node:http';
+import { WebSocketServer } from 'ws';
+class WebSocketChannel {
+    socket;
+    errorHandlers = new Set();
+    constructor(socket) {
+        this.socket = socket;
+    }
+    send(frame) {
+        if (this.socket.readyState !== 1)
+            throw Object.assign(new Error('transport-closed'), { code: 'transport-closed' });
+        const size = frame.reduce((sum, part) => sum + part.byteLength, 0);
+        const bytes = new Uint8Array(size);
+        let offset = 0;
+        for (const part of frame) {
+            bytes.set(part, offset);
+            offset += part.byteLength;
+        }
+        this.socket.send(bytes);
+    }
+    close() { this.socket.close(); }
+    terminate() { this.socket.terminate(); }
+    onReceive(handler) {
+        const listener = (data, isBinary) => {
+            if (!isBinary)
+                return this.fail('non-binary-frame');
+            handler([data]); // default binaryType 'nodebuffer': one Buffer per message
+        };
+        this.socket.on('message', listener);
+        return () => this.socket.off('message', listener);
+    }
+    onClose(handler) { this.socket.on('close', handler); return () => this.socket.off('close', handler); }
+    onError(handler) {
+        this.errorHandlers.add(handler);
+        this.socket.on('error', handler);
+        return () => { this.errorHandlers.delete(handler); this.socket.off('error', handler); };
+    }
+    fail(reason) { for (const handler of this.errorHandlers)
+        handler(reason); }
+}
+export default class WebSocketServerProvider {
+    type = 'websocket';
+    role = 'server';
+    defaultChunkSize = 100 * 1024 * 1024;
+    websocket;
+    detach = new Set();
+    attach(server, options = {}) {
+        if (!this.websocket)
+            throw Object.assign(new Error('provider-not-listening'), { code: 'provider-not-listening' });
+        return this.attachServer(server, options);
+    }
+    attachServer(server, options, owned = false) {
+        const websocket = this.websocket;
+        const upgrade = (request, socket, head) => {
+            if (options.path && new URL(request.url ?? '/', 'http://localhost').pathname !== options.path) {
+                if (owned)
+                    socket.end('HTTP/1.1 404 Not Found\r\nConnection: close\r\n\r\n');
+                return;
+            }
+            websocket.handleUpgrade(request, socket, head, ws => websocket.emit('connection', ws, request));
+        };
+        const detach = () => { server.off('upgrade', upgrade); this.detach.delete(detach); };
+        server.on('upgrade', upgrade);
+        this.detach.add(detach);
+        return detach;
+    }
+    async listen(options, accept) {
+        if (this.websocket)
+            throw Object.assign(new Error('provider-already-listening'), { code: 'provider-already-listening' });
+        const server = options.noServer ? undefined : http.createServer();
+        const websocket = new WebSocketServer({ noServer: true, perMessageDeflate: false });
+        this.websocket = websocket;
+        websocket.on('connection', socket => accept(new WebSocketChannel(socket)));
+        if (server && !options.noServer) {
+            this.attachServer(server, options, true);
+            try {
+                await new Promise((resolve, reject) => {
+                    server.once('error', reject);
+                    server.listen(options.port, options.host, () => { server.off('error', reject); resolve(); });
+                });
+            }
+            catch (reason) {
+                for (const detach of this.detach)
+                    detach();
+                this.websocket = undefined;
+                websocket.close();
+                throw reason;
+            }
+        }
+        let closing;
+        return {
+            close: () => closing ??= new Promise(resolve => {
+                this.websocket = undefined;
+                for (const detach of this.detach)
+                    detach();
+                for (const socket of websocket.clients)
+                    socket.terminate();
+                websocket.close(() => {
+                    if (server)
+                        server.close(() => resolve());
+                    else
+                        resolve();
+                });
+            }),
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -1,6 +1,14 @@
 {
   "name": "@nyirusu/nact-websocket-server",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.4",
+  "type": "module",
+  "files": ["dist/index.js", "dist/index.js.map", "dist/index.d.ts", "dist/index.d.ts.map"],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": { ".": { "types": "./dist/index.d.ts", "import": "./dist/index.js" } },
+  "scripts": { "build": "tsc -p tsconfig.build.json", "typecheck": "tsc -p tsconfig.json --noEmit", "test": "npm run test:simple", "test:simple": "node --import tsx --test test/simple.test.mjs", "test:full": "node --import tsx --test test/full.test.mjs", "test:edge": "node --import tsx --test test/edge.test.mjs" },
+  "dependencies": { "ws": "8.21.3" },
+  "devDependencies": { "@types/ws": "8.18.1" },
+  "peerDependencies": { "@nyirusu/nasdk": ">=1.0.4" },
+  "peerDependenciesMeta": { "@nyirusu/nasdk": { "optional": true } }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.