@univerjs-pro/collaboration-transport-node 1.0.0-insiders.20260808-70eefdd → 1.0.0

package/README.md

@@ -0,0 +1,244 @@
+# @univerjs-pro/collaboration-transport-node
+
+English | [简体中文](./README.zh-CN.md)
+
+The Node.js HTTP/WebSocket ingress for a Univer Collaboration server assembly.
+
+Transport attaches to a host Node HTTP/HTTPS server and handles matching HTTP requests and WebSocket connections. Applications integrate authentication, logging, and other ingress concerns through HTTP middleware, then registered protocol Endpoints handle Collaboration requests. Transport is not normally used by itself:
+
+```text
+Node HTTP server
+→ Transport
+  ├─→ HTTP middleware       login authentication, CORS, trace, network logs
+  │   → Endpoint HTTP       protocol routes; calls Service APIs as needed
+  │       → Service middleware / Database
+  └─→ Endpoint WebSocket    Sessions, JOIN, Presence, ACKs, broadcasts
+      → Endpoint middleware realtime-room ACL and Presence controls
+```
+
+## Server assembly
+
+```bash
+pnpm add \
+  @univerjs-pro/collaboration-service \
+  @univerjs-pro/collaboration-endpoint \
+  @univerjs-pro/collaboration-transport-node \
+  @univerjs-pro/collaboration-database-memory
+```
+
+```ts
+import { createServer } from 'node:http';
+import { MemoryDatabaseAdapter } from '@univerjs-pro/collaboration-database-memory';
+import { UniverCollabEndpoint } from '@univerjs-pro/collaboration-endpoint';
+import { UniverCollabService } from '@univerjs-pro/collaboration-service';
+import { createNodeTransport } from '@univerjs-pro/collaboration-transport-node';
+
+const database = new MemoryDatabaseAdapter();
+const collabService = new UniverCollabService({ dbAdapter: database });
+const endpoint = new UniverCollabEndpoint(collabService);
+const transport = createNodeTransport();
+
+// use() handles HTTP requests only. Authenticate and attach request-scoped data here.
+transport.use(async (ctx, next) => {
+  const user = await authenticate(ctx.incomingMessage);
+  if (!user) {
+    ctx.response.statusCode = 401;
+    ctx.response.end('Authentication required');
+    return;
+  }
+
+  // Map the application's stable user primary key at the SDK boundary.
+  ctx.userID = user.userId;
+  ctx.customData.user = user;
+  ctx.customData.traceId = readTraceId(ctx.incomingMessage);
+  await next();
+});
+
+// useUpgrade() runs once per WebSocket handshake and can reject before upgrade.
+transport.useUpgrade(async (ctx, next) => {
+  if (!isAllowedOrigin(ctx.incomingMessage.headers.origin)) {
+    ctx.reject(403, 'Origin rejected');
+    return;
+  }
+  await next();
+});
+
+endpoint.use('joinUnit', async (ctx, next) => {
+  // Transport ctx.userID → ctx.session.userID
+  // Transport ctx.customData → ctx.session.customData
+  console.log(ctx.session.userID, ctx.session.customData.user, ctx.session.customData.traceId);
+  await next();
+});
+
+collabService.use('readUnitData', async (ctx, next) => {
+  // Transport ctx.userID → Service ctx.userID
+  // Transport ctx.customData → Service ctx.customData
+  console.log(ctx.userID, ctx.customData.user, ctx.customData.traceId);
+  await next();
+});
+
+transport.register(endpoint);
+
+const server = createServer();
+transport.attach(server);
+server.listen(3010);
+```
+
+The Memory Adapter keeps this Transport example small; process exit loses all data. See
+[Database Adapters](https://office.univer.ai/collaboration/database-adapters) for production
+persistence choices.
+
+Transport does not prescribe cookies, bearer tokens, user tables, or user types. The application validates its own credentials in HTTP middleware and explicitly writes the stable business identity to `ctx.userID`. On authentication failure, end the response without calling `next()`.
+
+## How identity and customData reach Endpoint and Service
+
+Transport creates a separate `ctx.customData` for every HTTP request. HTTP middleware may add the current request's user, tenant, trace, or ACL query objects.
+
+```text
+regular protocol HTTP request
+→ Transport middleware sets userID/customData
+→ Endpoint validates the protocol and calls Service
+→ Service middleware reads the same userID/customData
+```
+
+WebSocket identity is inherited from a one-time ticket, not directly from the upgrade URL or client payload:
+
+```text
+userID/customData on the ticket HTTP request
+→ Endpoint stores the association server-side and returns an opaque ticket string
+→ WebSocket handshake consumes the association once
+→ Endpoint creates Session { userID, memberID, customData }
+→ Endpoint middleware reads ctx.session
+```
+
+The ticket string contains neither `userID` nor `customData`. Only the session-ticket HTTP route extends the current Transport context into a WebSocket Session; other HTTP routes do not.
+
+Transport network-data lifetimes are:
+
+- HTTP `ctx.customData` belongs only to the current request; every later HTTP request runs authentication middleware again.
+- `EndpointSession.customData` comes from the HTTP request that issued the ticket and keeps the same reference for the current WebSocket Session.
+- For regular HTTP protocol routes, Service middleware receives that HTTP request's `ctx.customData`, not Session `customData` automatically.
+
+`customData` is only passed in memory. It is not automatically sent to browsers, persisted in the collaboration database, or logged.
+
+## Application framework integration
+
+Attach Transport to your application's HTTP/HTTPS server to share a port between collaboration
+and business APIs. The application framework handles business requests, while Transport handles
+collaboration requests for registered Endpoints.
+
+This Express example reuses the `transport` configured above with middleware and an Endpoint:
+
+```ts
+import { createServer } from 'node:http';
+import express from 'express';
+
+const app = express();
+app.get('/health', (_request, response) => {
+  response.send('OK');
+});
+
+const server = createServer(app);
+transport.attach(server);
+server.listen(3010);
+```
+
+`attach(server)` connects both collaboration HTTP requests and WebSocket connections, without
+registering protocol routes again in Express. Requests are handled as follows:
+
+| Request | Handling |
+| --- | --- |
+| HTTP request matching an Endpoint route | Transport middleware → Endpoint |
+| Other HTTP request, such as `/health` | Express middleware → business route or 404 |
+| WebSocket upgrade matching an Endpoint route | Transport upgrade middleware → Endpoint |
+| Other WebSocket upgrade | Other WebSocket services in the application |
+
+HTTP routes match by method and path template. Once a request is handed to the SDK, the SDK
+completes its success, rejection, or error response. A 404 does not send it back to Express.
+
+Express middleware and Transport middleware apply to the requests each handles. Express
+authentication, body parsing, CORS, and logging therefore do not automatically apply to
+collaboration requests.
+
+Create the application's server, call `attach()`, then start that server. Business routes can
+still be registered within the framework; do not directly add or remove the server's `request`
+listeners while attached.
+
+Each server uses one Transport, with multiple Endpoints registered on it. For example,
+Collaboration, History, Comment, and Worktree can share the network entry point and Transport middleware.
+
+If the application has other WebSocket services, each service's `upgrade` listener should handle
+only its own paths. Transport claims only registered collaboration WebSocket routes and neither
+responds to nor closes other upgrade requests.
+
+### Custom request dispatch
+
+If your application already has a shared gateway or request dispatch logic, it can call
+`handleRequest(request, response)` and `handleUpgrade(request, socket, head)` directly. Your
+application decides which requests to pass to Transport, without calling `attach()`.
+
+Pass raw Node requests with their full URL before a body parser reads the request body.
+Transport completes the responses for these requests. Unhandled HTTP requests or WebSocket
+upgrades default to HTTP 404; they do not return to the application framework for further routing.
+
+## API layers
+
+```ts
+transport.use(httpMiddleware);
+transport.useUpgrade(upgradeMiddleware);
+transport.register(endpoint);
+```
+
+- `use()`: regular HTTP requests only; callbacks directly receive `incomingMessage`, `response`, `userID`, and request-scoped `customData`.
+- `useUpgrade()`: WebSocket handshakes only; read `incomingMessage` or call `reject(status, message)`.
+- `register()`: register and own a protocol Endpoint that handles matching HTTP requests and WebSocket connections.
+
+## Routes and execution order
+
+Register authentication and observation middleware before the Endpoints they apply to.
+`use()`, `useUpgrade()`, and `register()` follow registration order. `await next()` waits for
+later middleware and handlers; a middleware can end its response without calling `next()`.
+
+HTTP and upgrade middleware can read decoded path parameters from `ctx.params` and the full
+route template from `ctx.route?.path`. Before matching, params is empty and route is undefined.
+Use the exact protocol paths documented by each Endpoint, including case and slashes.
+
+To measure HTTP duration, read route metadata when the response finishes:
+
+```ts
+transport.use(async (ctx, next) => {
+  const start = performance.now();
+  ctx.response.once('finish', () => {
+    recordHttpDuration({
+      method: ctx.incomingMessage.method,
+      route: ctx.route?.path ?? 'unmatched',
+      status: ctx.response.statusCode,
+      durationMs: performance.now() - start,
+    });
+  });
+  await next();
+});
+transport.use(authenticationMiddleware);
+transport.register(collabEndpoint);
+```
+
+`recordHttpDuration` is an application callback. Requests rejected before routing and unknown
+paths have no route. Observe `close` as well, deduplicating it with `finish`, to track interrupted
+responses. Handler completion after `await next()` can precede response completion.
+
+## Request limits and disposal
+
+HTTP bodies and WebSocket messages both default to a 16 MiB limit. `readBody()` and `readJson()` enforce the limit and ensure the request stream is consumed only once.
+
+Dispose from the network boundary inward during shutdown:
+
+```ts
+await transport.dispose();
+await collabService.dispose();
+await database.dispose();
+```
+
+Transport detaches, closes its active connections, and disposes Endpoints it owns through `register()`. The registration returned by `register()` can also unregister and dispose that Endpoint early. Endpoint does not dispose Service, and Service does not dispose an externally injected Database Adapter.
+
+See the [Collaboration documentation](https://office.univer.ai/collaboration/overview) for the
+complete assembly, middleware, and production requirements.

package/README.zh-CN.md

@@ -0,0 +1,261 @@
+# @univerjs-pro/collaboration-transport-node
+
+[English](./README.md) | [简体中文](./README.zh-CN.md)
+
+Univer Collaboration 服务端组装中的 Node.js HTTP/WebSocket 入口。
+
+Transport 挂载到宿主 Node HTTP/HTTPS server，处理匹配的 HTTP 请求和 WebSocket 连接。
+应用通过 HTTP middleware 接入认证、日志等入口逻辑，再由注册的协议 Endpoint 处理 Collaboration 请求。
+它通常不单独使用：
+
+```text
+Node HTTP server
+→ Transport
+  ├─→ HTTP middleware       登录认证、CORS、trace 和网络日志
+  │   → Endpoint HTTP       协议路由，必要时调用 Service API
+  │       → Service middleware / Database
+  └─→ Endpoint WebSocket    Session、JOIN、Presence、ACK 和广播
+      → Endpoint middleware 实时房间 ACL 和 Presence 控制
+```
+
+## 服务端组装
+
+```bash
+pnpm add \
+  @univerjs-pro/collaboration-service \
+  @univerjs-pro/collaboration-endpoint \
+  @univerjs-pro/collaboration-transport-node \
+  @univerjs-pro/collaboration-database-memory
+```
+
+```ts
+import { createServer } from 'node:http';
+import { MemoryDatabaseAdapter } from '@univerjs-pro/collaboration-database-memory';
+import { UniverCollabEndpoint } from '@univerjs-pro/collaboration-endpoint';
+import { UniverCollabService } from '@univerjs-pro/collaboration-service';
+import { createNodeTransport } from '@univerjs-pro/collaboration-transport-node';
+
+const database = new MemoryDatabaseAdapter();
+const collabService = new UniverCollabService({ dbAdapter: database });
+const endpoint = new UniverCollabEndpoint(collabService);
+const transport = createNodeTransport();
+
+// use() 只接收 HTTP request；这里由应用认证并挂载身份和请求级数据。
+transport.use(async (ctx, next) => {
+  const user = await authenticate(ctx.incomingMessage);
+  if (!user) {
+    ctx.response.statusCode = 401;
+    ctx.response.end('Authentication required');
+    return;
+  }
+
+  // 在进入 Collaboration SDK 时映射应用的稳定用户主键。
+  ctx.userID = user.userId;
+  ctx.customData.user = user;
+  ctx.customData.traceId = readTraceId(ctx.incomingMessage);
+  await next();
+});
+
+// useUpgrade() 每次 WebSocket handshake 运行一次，可在升级前拒绝。
+transport.useUpgrade(async (ctx, next) => {
+  if (!isAllowedOrigin(ctx.incomingMessage.headers.origin)) {
+    ctx.reject(403, 'Origin rejected');
+    return;
+  }
+  await next();
+});
+
+// WebSocket Session 发送 JOIN 消息、尚未加入 Unit 房间时，
+// 会经过 joinUnit middleware；Session 数据继承自签发 ticket 的 HTTP 请求。
+endpoint.use('joinUnit', async (ctx, next) => {
+  // Transport 挂载的 ctx.userID → ctx.session.userID
+  // Transport 挂载的 ctx.customData → ctx.session.customData
+  console.log(ctx.session.userID, ctx.session.customData.user, ctx.session.customData.traceId);
+  await next();
+});
+
+// Endpoint 通过 HTTP 读取 Unit、changesets 或 Sheet block，
+// Service 尚未访问 Database Adapter 时，会经过 readUnitData middleware。
+collabService.use('readUnitData', async (ctx, next) => {
+  // Transport 挂载的 ctx.userID → Service ctx.userID
+  // Transport 挂载的 ctx.customData → Service ctx.customData
+  console.log(ctx.userID, ctx.customData.user, ctx.customData.traceId);
+  await next();
+});
+
+// Endpoint 通过独立入口注册，并由 Transport 管理生命周期。
+transport.register(endpoint);
+
+const server = createServer();
+transport.attach(server);
+server.listen(3010);
+```
+
+这里使用 Memory Adapter 只是为了让 Transport 示例保持最小；进程退出后数据会丢失。
+生产环境的持久化选择见文档站的
+[Database Adapter](https://office.univer.ai/zh-CN/collaboration/database-adapters)。
+
+Transport 不规定 Cookie、Bearer token、用户表或用户类型。应用在 HTTP
+middleware 中验证自己的凭据，再把稳定业务身份显式写入
+`ctx.userID`。认证失败时直接结束 response，不要继续调用 `next()`。
+
+## 身份与 customData 如何进入 Endpoint 和 Service
+
+Transport 为每个 HTTP 请求创建独立的 `ctx.customData`。HTTP middleware 可以在
+其中放入当前请求需要的用户、tenant、trace 或 ACL 查询对象。
+
+```text
+普通协议 HTTP 请求
+→ Transport middleware 设置 userID/customData
+→ Endpoint 验证协议并调用 Service
+→ Service middleware 读取同一 userID/customData
+```
+
+WebSocket 身份不直接取自 upgrade URL 或客户端 payload，而是由 Endpoint 通过一次性
+ticket 继承：
+
+```text
+ticket HTTP 请求上的 userID/customData
+→ Endpoint 在服务端保存关联并返回 opaque ticket 字符串
+→ WebSocket 握手时一次性消费关联记录
+→ Endpoint 创建 Session { userID, memberID, customData }
+→ Endpoint middleware 通过 ctx.session 读取
+```
+
+ticket 字符串本身不包含 `userID/customData`。只有 session-ticket HTTP 路由会把
+当前 Transport context 延长到 WebSocket Session；其他 HTTP 路由不会。
+
+Transport 的网络数据生命周期如下：
+
+- HTTP `ctx.customData` 只属于当前请求；每个后续 HTTP 请求都会重新运行认证
+  middleware。
+- `EndpointSession.customData` 来自签发 ticket 的那次 HTTP 请求，在当前
+  WebSocket Session 中保持同一引用。
+- Endpoint 处理普通 HTTP 协议路由时，传给 Service middleware 的是该 HTTP 请求的
+  `ctx.customData`，不是自动取 Session `customData`。
+
+`customData` 只在内存中传递，不会自动发送给浏览器、写入协同数据库或记录日志。
+
+## 与应用框架集成
+
+将 Transport 挂载到应用的 HTTP/HTTPS Server，即可让协同接口与业务接口共用一个端口。
+应用框架处理业务请求，Transport 处理已注册 Endpoint 的协同请求。
+
+下面复用上文已配置 middleware 和 Endpoint 的 `transport`，以 Express 为例：
+
+```ts
+import { createServer } from 'node:http';
+import express from 'express';
+
+const app = express();
+app.get('/health', (_request, response) => {
+  response.send('OK');
+});
+
+const server = createServer(app);
+transport.attach(server);
+server.listen(3010);
+```
+
+`attach(server)` 同时接入协同 HTTP 请求和 WebSocket 连接，无需在 Express 中重新注册
+协议路由。挂载后的请求处理方式如下：
+
+| 请求 | 处理方式 |
+| --- | --- |
+| 匹配 Endpoint 路由的 HTTP 请求 | Transport middleware → Endpoint |
+| 其他 HTTP 请求，例如 `/health` | Express middleware → 业务路由或 404 |
+| 匹配 Endpoint 路由的 WebSocket upgrade | Transport upgrade middleware → Endpoint |
+| 其他 WebSocket upgrade | 由应用中的其他 WebSocket 服务处理 |
+
+HTTP 路由按 method 和路径模板匹配。已经交给 SDK 的请求，其成功、拒绝和错误响应
+都由 SDK 完成，不会因返回 404 而再次交给 Express。
+
+Express middleware 与 Transport middleware 分别作用于各自处理的请求，因此 Express
+的认证、body parser、CORS 和日志不会自动作用于协同请求。
+
+先创建应用的 Server，再调用 `attach()`，最后启动这个 Server。框架内部仍可正常
+注册业务路由；挂载后不要直接增删 Server 的 `request` listeners。
+
+一个 Server 使用一个 Transport，多个 Endpoint 注册到同一个 Transport。例如
+Collaboration、History、Comment 和 Worktree 可以共享网络入口及 Transport middleware。
+
+如果应用还有其他 WebSocket 服务，各服务的 `upgrade` listener 应只处理自己的路径。
+Transport 只接管已注册的协同 WebSocket 路由，不响应或关闭其他 upgrade 请求。
+
+### 自定义请求分发
+
+如果应用已有统一的网关或请求分发逻辑，可以直接调用 `handleRequest(request, response)`
+和 `handleUpgrade(request, socket, head)`，由应用决定哪些请求交给 Transport，
+无需调用 `attach()`。
+
+传入原始 Node 请求并保留完整 URL，在 body parser 读取请求体之前完成转交。
+Transport 负责完成这些请求的响应；未处理的 HTTP 请求或 WebSocket upgrade 默认返回
+HTTP 404，不会返回应用框架继续匹配路由。
+
+## API 分层
+
+```ts
+transport.use(httpMiddleware);
+transport.useUpgrade(upgradeMiddleware);
+transport.register(endpoint);
+```
+
+- `use()`：仅普通 HTTP request；回调直接获得 `incomingMessage`、`response`、
+  `userID` 和请求级 `customData`。
+- `useUpgrade()`：仅 WebSocket handshake；可读取 `incomingMessage`，或调用
+  `reject(status, message)`。
+- `register()`：注册并管理协议 Endpoint，由 Endpoint 处理匹配的 HTTP 请求和 WebSocket
+  连接。
+
+## 路由与执行顺序
+
+将认证、观测 middleware 注册在需要处理的 Endpoint 前。`use()`、`useUpgrade()` 和
+`register()` 按注册顺序执行。`await next()` 等待后续 middleware 和 handler 完成；
+middleware 也可以自行结束响应并省略 `next()`。
+
+HTTP 和 upgrade middleware 可以通过 `ctx.params` 读取解码后的路径参数，通过
+`ctx.route?.path` 读取完整路由模板。匹配前 params 为空，route 未定义。
+请求应使用各 Endpoint 文档列出的精确协议路径，包括大小写和斜杠。
+
+统计 HTTP 耗时时，在响应结束时读取路由元数据：
+
+```ts
+transport.use(async (ctx, next) => {
+  const start = performance.now();
+  ctx.response.once('finish', () => {
+    recordHttpDuration({
+      method: ctx.incomingMessage.method,
+      route: ctx.route?.path ?? 'unmatched',
+      status: ctx.response.statusCode,
+      durationMs: performance.now() - start,
+    });
+  });
+  await next();
+});
+transport.use(authenticationMiddleware);
+transport.register(collabEndpoint);
+```
+
+`recordHttpDuration` 是应用提供的回调。路由匹配前被拒绝的请求和未知路径没有 route。
+要记录中途断开的响应，可监听 `close` 并与 `finish` 去重。`await next()` 后的 handler
+完成时机可能早于响应完成。
+
+## 请求限制与资源释放
+
+HTTP body 和 WebSocket message 限制默认都是 16 MiB。`readBody()` 和 `readJson()` 会
+执行大小限制，并保证请求流只消费一次。
+
+停止时从网络入口向持久化层反向释放：
+
+```ts
+await transport.dispose();
+await collabService.dispose();
+await database.dispose();
+```
+
+Transport 会解除挂载、终止自己的活动连接并释放它通过 `register()` 拥有的 Endpoint；
+`register()` 返回的 registration 也可提前注销并释放该 Endpoint。Endpoint 不释放 Service，Service 也不释放
+外部注入的 Database Adapter。
+
+完整服务端装配、middleware 和生产环境要求见
+[协同编辑文档](https://office.univer.ai/zh-CN/collaboration/overview)。

package/dist/index.cjs

@@ -1 +1 @@
-Object['defineProperty'](exports,Symbol['toStringTag'],{'value':'Module'});let e=require('node:crypto'),t=require('ws');function n(_0x292255){return typeof _0x292255=='function'?_0x292255:_0x292255['handle']['bind'](_0x292255);}async function r(_0x2548cb,_0x42813a){let _0x57f356=_0x2548cb['filter'](_0x48cacb=>!_0x48cacb['disposed'])['map'](_0x20fff2=>n(_0x20fff2['value'])),_0x35e739=async _0x1fa5c8=>{let _0x4a8e7b=_0x57f356[_0x1fa5c8];if(!_0x4a8e7b)return;let _0x4c9143=!0x1,_0x39ed79,_0x357e4c=()=>{if(_0x4c9143)throw Error('Transport\x20middleware\x20called\x20next()\x20more\x20than\x20once');return _0x4c9143=!0x0,_0x39ed79=_0x35e739(_0x1fa5c8+0x1),_0x39ed79;};try{await _0x4a8e7b(_0x42813a,_0x357e4c);}catch(_0x4a7a0e){if(_0x39ed79)try{await _0x39ed79;}catch{}throw _0x4a7a0e;}_0x39ed79&&await _0x39ed79;};await _0x35e739(0x0);}var i=0x10*0x400*0x400,a=class{['socket'];['id']=(0x0,e['randomUUID'])();['customData']={};['_closed']=!0x1;constructor(_0x44105b){this['socket']=_0x44105b;}['send'](_0x54f481){return this['_closed']||this['socket']['readyState']!==this['socket']['OPEN']?Promise['reject'](Error('WebSocket\x20connection\x20is\x20not\x20open')):new Promise((_0x4f3557,_0x586752)=>{this['socket']['send'](_0x54f481,_0x10c229=>{_0x10c229?_0x586752(_0x10c229):_0x4f3557();});});}['close'](_0x2dab0c,_0x4600c2){this['_closed']||(this['_closed']=!0x0,(this['socket']['readyState']===this['socket']['OPEN']||this['socket']['readyState']===this['socket']['CONNECTING'])&&this['socket']['close'](_0x2dab0c,_0x4600c2));}['terminate'](){this['_closed']=!0x0,this['socket']['readyState']!==this['socket']['CLOSED']&&this['socket']['terminate']();}};function o(_0x4721b5,_0x62c9c4){if(_0x4721b5===void 0x0)return _0x62c9c4;if(!Number['isSafeInteger'](_0x4721b5)||_0x4721b5<=0x0)throw TypeError('Transport\x20byte\x20limits\x20must\x20be\x20positive\x20safe\x20integers');return _0x4721b5;}function s(_0x45e6b7,_0x49dd56){let _0x83826f;return()=>(_0x83826f??=new Promise((_0x5b94c5,_0x20098d)=>{let _0x1bd198=_0x45e6b7['headers']['content-length'];if(_0x1bd198!==void 0x0&&Number['isFinite'](Number(_0x1bd198))&&Number(_0x1bd198)>_0x49dd56){_0x45e6b7['resume'](),_0x20098d(new f('REQUEST_BODY_TOO_LARGE','Request\x20body\x20exceeds\x20'+_0x49dd56+'\x20bytes'));return;}let _0x4764da=[],_0x316c49=0x0,_0x5aa051=!0x1,_0x5751a6=_0x36cf03=>{_0x5aa051||(_0x5aa051=!0x0,_0x20098d(_0x36cf03));};_0x45e6b7['on']('data',_0x3a8b91=>{if(_0x5aa051)return;let _0x43d353=typeof _0x3a8b91=='string'?Buffer['from'](_0x3a8b91):_0x3a8b91;if(_0x316c49+=_0x43d353['byteLength'],_0x316c49>_0x49dd56){_0x45e6b7['resume'](),_0x5751a6(new f('REQUEST_BODY_TOO_LARGE','Request\x20body\x20exceeds\x20'+_0x49dd56+'\x20bytes'));return;}_0x4764da['push'](_0x43d353);}),_0x45e6b7['once']('end',()=>{_0x5aa051||(_0x5aa051=!0x0,_0x5b94c5(Buffer['concat'](_0x4764da,_0x316c49)));}),_0x45e6b7['once']('aborted',()=>{_0x5751a6(new f('REQUEST_ABORTED','Request\x20was\x20aborted'));}),_0x45e6b7['once']('error',_0x3d27b1=>{_0x5751a6(new f('REQUEST_ABORTED','Request\x20stream\x20failed',{'cause':_0x3d27b1}));});}),_0x83826f);}function c(_0xa82add){return async()=>{let _0x4bf227=await _0xa82add();try{return JSON['parse'](Buffer['from'](_0x4bf227)['toString']('utf8'));}catch(_0x114fb8){throw new f('INVALID_JSON','Request\x20body\x20is\x20not\x20valid\x20JSON',{'cause':_0x114fb8});}};}function l(_0x707bda){return Array['isArray'](_0x707bda)?Buffer['concat'](_0x707bda):_0x707bda instanceof ArrayBuffer?Buffer['from'](_0x707bda):Buffer['from'](_0x707bda['buffer'],_0x707bda['byteOffset'],_0x707bda['byteLength']);}var u=class{['_entries']=[];['_webSocketServer'];['_connections']=new Set();['_eventQueues']=new Map();['_failedConnections']=new Set();['_connectionClosed']=new Map();['_maxRequestBodyBytes'];['_disposed']=!0x1;constructor(_0x23e8f9={}){this['_maxRequestBodyBytes']=o(_0x23e8f9['maxRequestBodyBytes'],i);let _0x583d89=o(_0x23e8f9['maxWebSocketMessageBytes'],this['_maxRequestBodyBytes']);this['_webSocketServer']=new t['WebSocketServer']({'noServer':!0x0,'maxPayload':_0x583d89});}['use'](_0x2439e3){this['_assertRunning']();let _0x35bdfc={'value':_0x2439e3,'disposed':!0x1};return this['_entries']['push'](_0x35bdfc),{'dispose':async()=>{_0x35bdfc['disposed']||(_0x35bdfc['disposed']=!0x0,await this['_disposeMiddleware'](_0x35bdfc['value']));}};}['handleRequest'](_0x6510,_0x5796ce){if(this['_disposed']){this['_writeHttpError'](_0x5796ce,new f('TRANSPORT_DISPOSED','Transport\x20is\x20disposed'));return;}let _0x30a51a=s(_0x6510,this['_maxRequestBodyBytes']),_0x2447ef={'kind':'http','incomingMessage':_0x6510,'response':_0x5796ce,'customData':{},'readBody':_0x30a51a,'readJson':c(_0x30a51a)};this['_dispatch'](_0x2447ef)['catch'](_0x27d36a=>{this['_writeHttpError'](_0x5796ce,_0x27d36a);});}['handleUpgrade'](_0x454e1c,_0x3d448d,_0x4673b9){if(this['_disposed']){_0x3d448d['destroy']();return;}try{this['_webSocketServer']['handleUpgrade'](_0x454e1c,_0x3d448d,_0x4673b9,_0x5ed814=>{if(this['_disposed']){_0x5ed814['terminate']();return;}this['_acceptWebSocket'](_0x454e1c,_0x5ed814);});}catch{_0x3d448d['destroy']();}}async['dispose'](){if(this['_disposed'])return;this['_disposed']=!0x0;let _0xb9fd24=[...this['_connectionClosed']['values']()]['map'](_0x502ff1=>_0x502ff1['promise']);for(let _0xfc6ce8 of this['_connections'])_0xfc6ce8['terminate']();await Promise['allSettled'](_0xb9fd24),await Promise['allSettled']([...this['_eventQueues']['values']()]);let _0x5408e6=[...this['_entries']]['reverse']();for(let _0x3d2d4b of _0x5408e6)_0x3d2d4b['disposed']||(_0x3d2d4b['disposed']=!0x0,await this['_disposeMiddleware'](_0x3d2d4b['value']));this['_entries']['length']=0x0;}['_acceptWebSocket'](_0x1bbdaf,_0x3b019a){let _0x549183=new a(_0x3b019a);this['_connections']['add'](_0x549183),this['_eventQueues']['set'](_0x549183,Promise['resolve']());let _0x58fa81,_0x94af53=new Promise(_0x2c41b6=>{_0x58fa81=_0x2c41b6;});this['_connectionClosed']['set'](_0x549183,{'promise':_0x94af53,'resolve':_0x58fa81}),_0x3b019a['on']('message',(_0x84c7ab,_0x3a45b4)=>{let _0x462b90=l(_0x84c7ab),_0x33c105=_0x3a45b4?new Uint8Array(_0x462b90):_0x462b90['toString']('utf8');this['_enqueue'](_0x549183,{'kind':'websocket-message','connection':_0x549183,'data':_0x33c105,'customData':{}});}),_0x3b019a['once']('close',(_0x37d291,_0x34a37f)=>{this['_enqueue'](_0x549183,{'kind':'websocket-close','connection':_0x549183,'code':_0x37d291,'reason':_0x34a37f['toString']('utf8'),'customData':{}},!0x0);}),_0x3b019a['on']('error',()=>{}),this['_enqueue'](_0x549183,{'kind':'websocket-open','incomingMessage':_0x1bbdaf,'connection':_0x549183,'customData':{}});}['_enqueue'](_0x2c0928,_0x2305d9,_0x4aea58=!0x1){let _0x579a5f=(this['_eventQueues']['get'](_0x2c0928)??Promise['resolve']())['catch'](()=>void 0x0)['then'](async()=>{this['_failedConnections']['has'](_0x2c0928)&&_0x2305d9['kind']!=='websocket-close'||await this['_dispatch'](_0x2305d9);})['catch'](()=>{this['_failedConnections']['add'](_0x2c0928),_0x2c0928['close'](0x3f3,'Transport\x20middleware\x20failure');})['finally'](()=>{_0x4aea58&&(this['_connections']['delete'](_0x2c0928),this['_eventQueues']['delete'](_0x2c0928),this['_failedConnections']['delete'](_0x2c0928),this['_connectionClosed']['get'](_0x2c0928)?.['resolve'](),this['_connectionClosed']['delete'](_0x2c0928));});this['_eventQueues']['set'](_0x2c0928,_0x579a5f);}async['_dispatch'](_0x2472d1){if(this['_disposed']&&_0x2472d1['kind']!=='websocket-close')throw new f('TRANSPORT_DISPOSED','Transport\x20is\x20disposed');await r([...this['_entries']],_0x2472d1);}['_writeHttpError'](_0x3f1734,_0x1c8680){if(_0x3f1734['writableEnded']||_0x3f1734['destroyed'])return;let _0x5c3959=_0x1c8680 instanceof f?_0x1c8680['code']==='REQUEST_BODY_TOO_LARGE'?0x19d:_0x1c8680['code']==='INVALID_JSON'||_0x1c8680['code']==='REQUEST_ABORTED'?0x190:0x1f7:0x1f4,_0x5dcb5e=_0x5c3959===0x19d?'Payload\x20Too\x20Large':_0x5c3959===0x190?'Bad\x20Request':_0x5c3959===0x1f7?'Service\x20Unavailable':'Internal\x20Server\x20Error';_0x3f1734['headersSent']?_0x3f1734['destroy'](_0x1c8680 instanceof Error?_0x1c8680:void 0x0):(_0x3f1734['statusCode']=_0x5c3959,_0x3f1734['setHeader']('content-type','text/plain;\x20charset=utf-8'),_0x3f1734['end'](_0x5dcb5e));}async['_disposeMiddleware'](_0x149cfe){typeof _0x149cfe!='function'&&await _0x149cfe['dispose']?.();}['_assertRunning'](){if(this['_disposed'])throw new f('TRANSPORT_DISPOSED','Transport\x20is\x20disposed');}};function d(_0x4f73c6){return new u(_0x4f73c6);}var f=class extends Error{['code'];constructor(_0x1eb163,_0x37b191,_0x1795f9){super(_0x37b191,_0x1795f9),this['code']=_0x1eb163,this['name']='NodeTransportError';}};exports['NodeTransportError']=f,exports['createNodeTransport']=d;
+Object['defineProperty'](exports,Symbol['toStringTag'],{'value':'Module'});let e=require('node:crypto'),t=require('node:http'),n=require('ws');var r=class extends Error{['code'];constructor(_0x7c1ba8,_0xa92da0,_0x34bb9b){super(_0xa92da0,_0x34bb9b),this['code']=_0x7c1ba8,this['name']='NodeTransportError';}};function i(_0x435c84,_0x415974,_0x268109){let _0x4872ca=Promise['resolve']()['then'](_0x415974),_0x5c4a63=_0x268109&&!_0x268109['writableFinished']&&!_0x268109['destroyed']?new Promise(_0x49750f=>{let _0x202c21=()=>{_0x268109['off']('finish',_0x202c21),_0x268109['off']('close',_0x202c21),_0x49750f();};_0x268109['once']('finish',_0x202c21),_0x268109['once']('close',_0x202c21);}):Promise['resolve'](),_0x76300b=Promise['allSettled']([_0x4872ca,_0x5c4a63])['then'](()=>void 0x0);return _0x435c84['calls']['add'](_0x76300b),_0x76300b['then'](()=>_0x435c84['calls']['delete'](_0x76300b)),_0x4872ca;}async function a(_0x5e6c3b,_0x4c8d76){let _0xef01ff=async _0x4a492d=>{let _0x1b2d00=_0x5e6c3b[_0x4a492d];if(!_0x1b2d00)return;let _0x556957=!0x1,_0x25e0d6,_0x9b4da=()=>{if(_0x556957)throw Error('Transport\x20middleware\x20called\x20next()\x20more\x20than\x20once');return _0x556957=!0x0,_0x25e0d6=_0xef01ff(_0x4a492d+0x1),_0x25e0d6;};try{await _0x1b2d00(_0x4c8d76,_0x9b4da);}catch(_0x2307f3){if(_0x25e0d6)try{await _0x25e0d6;}catch{}throw _0x2307f3;}_0x25e0d6&&await _0x25e0d6;};await _0xef01ff(0x0);}async function o(_0x3d526d,_0xb1c2c5){await a(_0x3d526d['flatMap'](_0x143f2d=>_0x143f2d['disposed']?[]:_0x143f2d['kind']==='http'?[(_0x373371,_0x45b34a)=>_0x143f2d['disposed']?_0x45b34a():_0x143f2d['middleware'](_0x373371,_0x45b34a)]:_0x143f2d['kind']==='endpoint'?[async(_0x123a7a,_0x104c8d)=>{if(_0x143f2d['disposed'])return _0x104c8d();let _0x393eae=_0x143f2d['router']['matchHttp'](_0x123a7a);_0x393eae?await i(_0x143f2d,()=>_0x393eae(_0x123a7a),_0x123a7a['response']):await _0x104c8d();}]:[]),_0xb1c2c5);}async function s(_0x15ac31,_0x27c001){let _0x214487;return await a(_0x15ac31['flatMap'](_0x39a9d4=>{if(_0x39a9d4['disposed'])return[];if(_0x39a9d4['kind']==='upgrade'){let _0x11cc16=_0x39a9d4['middleware'];return[(_0x1f0286,_0x36ef16)=>_0x39a9d4['disposed']?_0x36ef16():_0x11cc16(_0x1f0286,_0x36ef16)];}return _0x39a9d4['kind']==='endpoint'?[async(_0x31b927,_0x2ba57e)=>{if(_0x39a9d4['disposed'])return _0x2ba57e();let _0x44b6b0=_0x39a9d4['router']['matchUpgrade'](_0x31b927);_0x44b6b0?(_0x214487=_0x39a9d4,await i(_0x39a9d4,()=>_0x44b6b0(_0x31b927))):await _0x2ba57e();}]:[];}),_0x27c001),_0x214487;}var c=class{['_http']=[];['_upgrade']=[];['_sealed']=!0x1;['get'](_0x5787ca,_0x2aea93){this['_add'](this['_http'],'GET',_0x5787ca,_0x2aea93);}['post'](_0x5a2d47,_0x382e7b){this['_add'](this['_http'],'POST',_0x5a2d47,_0x382e7b);}['delete'](_0x3200a8,_0x50d9b6){this['_add'](this['_http'],'DELETE',_0x3200a8,_0x50d9b6);}['upgrade'](_0x13aa2e,_0x52fc42){this['_add'](this['_upgrade'],'GET',_0x13aa2e,_0x52fc42);}['seal'](){this['_sealed']=!0x0;}['owns'](_0x3f61ae,_0x22eb6c){try{return this['_find'](_0x22eb6c?this['_upgrade']:this['_http'],_0x3f61ae)!==void 0x0;}catch(_0x447a56){if(!(_0x447a56 instanceof r)||_0x447a56['code']!=='INVALID_URL')throw _0x447a56;return!0x1;}}['matchHttp'](_0x14a4dd){return this['_match'](this['_http'],_0x14a4dd);}['matchUpgrade'](_0x2f0e12){return this['_match'](this['_upgrade'],_0x2f0e12);}['_add'](_0x1d9e35,_0x754d6a,_0x200ded,_0x12ef23){if(this['_sealed'])throw Error('Router\x20registration\x20has\x20completed');if(typeof _0x12ef23!='function')throw TypeError('Route\x20handler\x20must\x20be\x20a\x20function');if(typeof _0x200ded!='string'||!_0x200ded['startsWith']('/')||/[?#]/['test'](_0x200ded))throw TypeError('Route\x20path\x20must\x20be\x20an\x20absolute\x20pathname\x20template');let _0x5cc5f0=_0x200ded['split']('/'),_0xaf64f4=new Set();for(let _0xb50af of _0x5cc5f0){if(!_0xb50af['startsWith'](':'))continue;let _0x1661d8=_0xb50af['slice'](0x1);if(!/^[A-Za-z_][A-Za-z0-9_]*$/['test'](_0x1661d8)||_0xaf64f4['has'](_0x1661d8))throw TypeError('Route\x20parameters\x20must\x20have\x20unique\x20identifier\x20names');_0xaf64f4['add'](_0x1661d8);}_0x1d9e35['push']({'method':_0x754d6a,'segments':_0x5cc5f0,'handler':_0x12ef23,'route':Object['freeze']({'path':_0x200ded})});}['_find'](_0x3db838,_0x2e4b4b){if(_0x3db838['length']===0x0)return;let _0x47d2c0;try{_0x47d2c0=new URL(_0x2e4b4b['url']??'/','http://localhost')['pathname']['split']('/');}catch(_0x59d773){throw new r('INVALID_URL','Invalid\x20request\x20URL',{'cause':_0x59d773});}for(let _0x6a4628 of _0x3db838)if(!(_0x6a4628['method']!==_0x2e4b4b['method']||_0x6a4628['segments']['length']!==_0x47d2c0['length'])&&_0x6a4628['segments']['every']((_0x59a311,_0x113f38)=>_0x59a311['startsWith'](':')?_0x47d2c0[_0x113f38]!=='':_0x59a311===_0x47d2c0[_0x113f38]))return{'entry':_0x6a4628,'segments':_0x47d2c0};}['_match'](_0x5e54f2,_0x1e1873){let _0x2e82db=this['_find'](_0x5e54f2,_0x1e1873['incomingMessage']);if(_0x2e82db){let {entry:_0xbfee43,segments:_0xd1c3e5}=_0x2e82db;Object['defineProperty'](_0x1e1873,'route',{'value':_0xbfee43['route'],'enumerable':!0x0});let _0x4984b4=Object['create'](null);try{_0xbfee43['segments']['forEach']((_0x37071e,_0x3ddc03)=>{_0x37071e['startsWith'](':')&&(_0x4984b4[_0x37071e['slice'](0x1)]=decodeURIComponent(_0xd1c3e5[_0x3ddc03]));});}catch(_0x2a9535){throw new r('INVALID_URL','Route\x20contains\x20invalid\x20encoding',{'cause':_0x2a9535});}return Object['defineProperty'](_0x1e1873,'params',{'value':Object['freeze'](_0x4984b4),'enumerable':!0x0,'writable':!0x1,'configurable':!0x1}),_0xbfee43['handler'];}}},l=new WeakSet();function u(_0x5b0940,_0x2eb953,_0x2d05b2,_0x1f31a0){if(l['has'](_0x5b0940))throw Error('Server\x20already\x20has\x20an\x20attached\x20Transport');let _0xad1390=_0x5b0940['rawListeners']('request'),_0x19e0d7=_0xad1390['map'](_0x5d5507=>({'listener':_0x5d5507,'once':_0x5d5507['listener']!==void 0x0,'called':!0x1})),_0x2a452d=(_0x364b96,_0x3911b6)=>{if(_0x2eb953(_0x364b96,!0x1)){_0x2d05b2(_0x364b96,_0x3911b6);return;}for(let _0x214ad8 of _0x19e0d7)_0x214ad8['once']&&_0x214ad8['called']||(_0x214ad8['called']=!0x0,_0x214ad8['listener']['call'](_0x5b0940,_0x364b96,_0x3911b6));},_0x1f74a7=(_0x18b8a6,_0x13788f,_0x5b47b8)=>{_0x2eb953(_0x18b8a6,!0x0)&&_0x1f31a0(_0x18b8a6,_0x13788f,_0x5b47b8);};l['add'](_0x5b0940);for(let _0x42b70 of _0xad1390)_0x5b0940['removeListener']('request',_0x42b70);return _0x5b0940['on']('request',_0x2a452d),_0x5b0940['on']('upgrade',_0x1f74a7),()=>{_0x5b0940['off']('request',_0x2a452d),_0x5b0940['off']('upgrade',_0x1f74a7);for(let _0x23d948 of[..._0x19e0d7]['reverse']())_0x23d948['once']&&_0x23d948['called']||_0x5b0940['prependListener']('request',_0x23d948['listener']);l['delete'](_0x5b0940);};}var d=0x10*0x400*0x400,f=class{['socket'];['customData'];['id']=(0x0,e['randomUUID'])();['_closed']=!0x1;constructor(_0x5b5816,_0x31bf75){this['socket']=_0x5b5816,this['customData']=_0x31bf75;}['send'](_0x2fc7ed){return this['_closed']||this['socket']['readyState']!==this['socket']['OPEN']?Promise['reject'](Error('WebSocket\x20connection\x20is\x20not\x20open')):new Promise((_0x47b339,_0x5139a7)=>{this['socket']['send'](_0x2fc7ed,_0x34fc95=>{_0x34fc95?_0x5139a7(_0x34fc95):_0x47b339();});});}['close'](_0x5d894f,_0x49cef9){this['_closed']||(this['_closed']=!0x0,(this['socket']['readyState']===this['socket']['OPEN']||this['socket']['readyState']===this['socket']['CONNECTING'])&&this['socket']['close'](_0x5d894f,_0x49cef9));}['terminate'](){this['_closed']=!0x0,this['socket']['readyState']!==this['socket']['CLOSED']&&this['socket']['terminate']();}};function p(_0x333a0c,_0x323ad3){if(_0x333a0c===void 0x0)return _0x323ad3;if(!Number['isSafeInteger'](_0x333a0c)||_0x333a0c<=0x0)throw TypeError('Transport\x20byte\x20limits\x20must\x20be\x20positive\x20safe\x20integers');return _0x333a0c;}function m(_0x1eb3da,_0x447220){let _0x42274b;return()=>(_0x42274b??=new Promise((_0x2e5c00,_0x55abc2)=>{let _0x4c33c6=_0x1eb3da['headers']['content-length'];if(_0x4c33c6!==void 0x0&&Number['isFinite'](Number(_0x4c33c6))&&Number(_0x4c33c6)>_0x447220){_0x1eb3da['resume'](),_0x55abc2(new r('REQUEST_BODY_TOO_LARGE','Request\x20body\x20exceeds\x20'+_0x447220+'\x20bytes'));return;}let _0x49bc02=[],_0xceee3=0x0,_0x4db022=!0x1,_0x2067f0=_0x31ad0b=>{_0x4db022||(_0x4db022=!0x0,_0x55abc2(_0x31ad0b));};_0x1eb3da['on']('data',_0x5d7425=>{if(_0x4db022)return;let _0x23967b=typeof _0x5d7425=='string'?Buffer['from'](_0x5d7425):_0x5d7425;if(_0xceee3+=_0x23967b['byteLength'],_0xceee3>_0x447220){_0x1eb3da['resume'](),_0x2067f0(new r('REQUEST_BODY_TOO_LARGE','Request\x20body\x20exceeds\x20'+_0x447220+'\x20bytes'));return;}_0x49bc02['push'](_0x23967b);}),_0x1eb3da['once']('end',()=>{_0x4db022||(_0x4db022=!0x0,_0x2e5c00(Buffer['concat'](_0x49bc02,_0xceee3)));}),_0x1eb3da['once']('aborted',()=>{_0x2067f0(new r('REQUEST_ABORTED','Request\x20was\x20aborted'));}),_0x1eb3da['once']('error',_0xf870be=>{_0x2067f0(new r('REQUEST_ABORTED','Request\x20stream\x20failed',{'cause':_0xf870be}));});}),_0x42274b);}function h(_0xd2dc90){return async()=>{let _0x203eb2=await _0xd2dc90();try{return JSON['parse'](Buffer['from'](_0x203eb2)['toString']('utf8'));}catch(_0x59b2f0){throw new r('INVALID_JSON','Request\x20body\x20is\x20not\x20valid\x20JSON',{'cause':_0x59b2f0});}};}function g(_0x19217a){return Array['isArray'](_0x19217a)?Buffer['concat'](_0x19217a):_0x19217a instanceof ArrayBuffer?Buffer['from'](_0x19217a):Buffer['from'](_0x19217a['buffer'],_0x19217a['byteOffset'],_0x19217a['byteLength']);}var _=class{['_detach'];['_entries']=[];['_webSocketServer'];['_connections']=new Set();['_eventQueues']=new Map();['_failedConnections']=new Set();['_connectionClosed']=new Map();['_maxRequestBodyBytes'];['_disposed']=!0x1;['_disposePromise'];['_endpointInstances']=new WeakSet();['_connectionOwners']=new Map();constructor(_0x23e566={}){this['_maxRequestBodyBytes']=p(_0x23e566['maxRequestBodyBytes'],d);let _0x26bfb9=p(_0x23e566['maxWebSocketMessageBytes'],this['_maxRequestBodyBytes']);this['_webSocketServer']=new n['WebSocketServer']({'noServer':!0x0,'maxPayload':_0x26bfb9});}['use'](_0x1a1ac4){if(this['_assertRunning'](),typeof _0x1a1ac4!='function')throw TypeError('HTTP\x20Transport\x20middleware\x20must\x20be\x20a\x20function');let _0xb9035f={'kind':'http','middleware':_0x1a1ac4,'disposed':!0x1};return this['_entries']['push'](_0xb9035f),this['_registration'](_0xb9035f);}['useUpgrade'](_0x530221){if(this['_assertRunning'](),typeof _0x530221!='function')throw TypeError('WebSocket\x20upgrade\x20middleware\x20must\x20be\x20a\x20function');let _0x3110cb={'kind':'upgrade','middleware':_0x530221,'disposed':!0x1};return this['_entries']['push'](_0x3110cb),this['_registration'](_0x3110cb);}['register'](_0x398af1){if(this['_assertRunning'](),!_0x398af1||typeof _0x398af1['register']!='function')throw TypeError('Transport\x20Endpoint\x20must\x20provide\x20register(router)');if(this['_endpointInstances']['has'](_0x398af1))throw Error('Endpoint\x20is\x20already\x20registered');let _0x92bff1=new c();this['_endpointInstances']['add'](_0x398af1);try{let _0x3ca517=_0x398af1['register'](_0x92bff1);if(_0x3ca517&&typeof _0x3ca517['then']=='function')throw Promise['resolve'](_0x3ca517)['catch'](()=>void 0x0),TypeError('Endpoint\x20register(router)\x20must\x20be\x20synchronous');this['_assertRunning']();}catch(_0x7a0a48){throw this['_endpointInstances']['delete'](_0x398af1),_0x7a0a48;}finally{_0x92bff1['seal']();}let _0x454fc0={'kind':'endpoint','endpoint':_0x398af1,'router':_0x92bff1,'calls':new Set(),'disposed':!0x1};return this['_entries']['push'](_0x454fc0),this['_registration'](_0x454fc0);}['attach'](_0x145982){if(this['_assertRunning'](),this['_detach'])throw Error('Transport\x20is\x20already\x20attached\x20to\x20a\x20Server');this['_detach']=u(_0x145982,(_0x35dcc0,_0x47f4bf)=>this['_entries']['some'](_0x1ef27c=>!_0x1ef27c['disposed']&&_0x1ef27c['kind']==='endpoint'&&_0x1ef27c['router']['owns'](_0x35dcc0,_0x47f4bf)),(_0x15477a,_0x863014)=>this['handleRequest'](_0x15477a,_0x863014),(_0x3194d2,_0x89996b,_0x1a8825)=>this['handleUpgrade'](_0x3194d2,_0x89996b,_0x1a8825));}['handleRequest'](_0x517a37,_0x6ff548){if(this['_disposed']){this['_writeHttpError'](_0x6ff548,new r('TRANSPORT_DISPOSED','Transport\x20is\x20disposed'));return;}let _0x4f8bdb=m(_0x517a37,this['_maxRequestBodyBytes']),_0x496d5b={'incomingMessage':_0x517a37,'response':_0x6ff548,'customData':Object['create'](null),'params':Object['freeze'](Object['create'](null)),'readBody':_0x4f8bdb,'readJson':h(_0x4f8bdb)};this['_dispatchHttp'](_0x496d5b)['then'](()=>{this['_writeHttpNotFound'](_0x6ff548);})['catch'](_0x5f5869=>{this['_writeHttpError'](_0x6ff548,_0x5f5869);});}['handleUpgrade'](_0x164a12,_0x3128d2,_0xc12c66){if(this['_disposed']){_0x3128d2['destroy']();return;}this['_handleUpgrade'](_0x164a12,_0x3128d2,_0xc12c66);}['dispose'](){if(this['_disposePromise'])return this['_disposePromise'];this['_disposed']=!0x0;let _0x3c85b0=this['_detach'];this['_detach']=void 0x0,_0x3c85b0?.();for(let _0x5697bb of this['_entries'])_0x5697bb['disposed']=!0x0;return this['_disposePromise']=this['_dispose'](),this['_disposePromise'];}async['_dispose'](){let _0x349a85=[...this['_connectionClosed']['values']()]['map'](_0x2581dd=>_0x2581dd['promise']);for(let _0xb81b5f of this['_connections'])_0xb81b5f['terminate']();await Promise['allSettled'](_0x349a85),await Promise['allSettled']([...this['_eventQueues']['values']()]);let _0x35b1fe=[...this['_entries']]['reverse']();for(let _0xb3d965 of _0x35b1fe)await this['_disposeEntry'](_0xb3d965);this['_entries']['length']=0x0;}async['_handleUpgrade'](_0x121676,_0x4d4877,_0x289c22){let _0x5b7357,_0x2992b1=Object['create'](null),_0x565ec6=_0x3cfa77=>{if(_0x5b7357)throw Error('WebSocket\x20upgrade\x20was\x20already\x20accepted\x20or\x20rejected');_0x5b7357=_0x3cfa77;},_0x2235de={'incomingMessage':_0x121676,'customData':_0x2992b1,'params':Object['freeze'](Object['create'](null)),'reject':(_0xceda8=0x193,_0x639ed4)=>{if(!Number['isSafeInteger'](_0xceda8)||_0xceda8<0x190||_0xceda8>0x257)throw TypeError('WebSocket\x20rejection\x20status\x20must\x20be\x20an\x20integer\x20from\x20400\x20to\x20599');_0x565ec6({'kind':'reject','statusCode':_0xceda8,'message':_0x639ed4??t['STATUS_CODES'][_0xceda8]??'Upgrade\x20rejected'});},'accept':_0x28b32d=>{if(!_0x28b32d||typeof _0x28b32d!='object')throw TypeError('WebSocket\x20handler\x20must\x20be\x20an\x20object');_0x565ec6({'kind':'accept','handler':_0x28b32d});}};try{let _0x5afa7b=await s([...this['_entries']],_0x2235de);if(this['_disposed']||_0x5afa7b?.['disposed']||_0x4d4877['destroyed']){_0x4d4877['destroy']();return;}if(!_0x5b7357){this['_writeUpgradeResponse'](_0x4d4877,0x194,'Not\x20Found');return;}if(_0x5b7357['kind']==='reject'){this['_writeUpgradeResponse'](_0x4d4877,_0x5b7357['statusCode'],_0x5b7357['message']);return;}let _0x2bff54=_0x5b7357['handler'];this['_webSocketServer']['handleUpgrade'](_0x121676,_0x4d4877,_0x289c22,_0x4d969f=>{if(this['_disposed']||_0x5afa7b?.['disposed']){_0x4d969f['terminate']();return;}this['_acceptWebSocket'](_0x4d969f,_0x2992b1,_0x2bff54,_0x5afa7b);});}catch(_0x6feba5){let _0x9c1128=_0x6feba5 instanceof r&&_0x6feba5['code']==='INVALID_URL';this['_writeUpgradeResponse'](_0x4d4877,_0x9c1128?0x190:0x1f4,_0x9c1128?'Bad\x20Request':'Internal\x20Server\x20Error');}}['_acceptWebSocket'](_0x1ca90a,_0x38fce9,_0x114f21,_0x2fb4f7){let _0x1b3539=new f(_0x1ca90a,_0x38fce9);this['_connections']['add'](_0x1b3539),_0x2fb4f7&&this['_connectionOwners']['set'](_0x1b3539,_0x2fb4f7),this['_eventQueues']['set'](_0x1b3539,Promise['resolve']());let _0xc71490,_0x45229c=new Promise(_0x10ea91=>{_0xc71490=_0x10ea91;});this['_connectionClosed']['set'](_0x1b3539,{'promise':_0x45229c,'resolve':_0xc71490}),_0x1ca90a['on']('message',(_0x3b91d3,_0x9b2ba9)=>{let _0x2a6894=g(_0x3b91d3),_0x440ac0=_0x9b2ba9?new Uint8Array(_0x2a6894):_0x2a6894['toString']('utf8'),_0x207387={'connection':_0x1b3539,'data':_0x440ac0,'customData':Object['create'](null)};this['_enqueue'](_0x1b3539,()=>_0x114f21['message']?.(_0x207387));}),_0x1ca90a['once']('close',(_0x4bef0e,_0x58e007)=>{let _0xdf663f={'connection':_0x1b3539,'code':_0x4bef0e,'reason':_0x58e007['toString']('utf8')};this['_enqueue'](_0x1b3539,()=>_0x114f21['close']?.(_0xdf663f),!0x0);}),_0x1ca90a['on']('error',()=>{});let _0x21fd14={'connection':_0x1b3539};this['_enqueue'](_0x1b3539,()=>_0x114f21['open']?.(_0x21fd14));}['_enqueue'](_0x2fa2c4,_0x438193,_0x50d2ed=!0x1){let _0x793df8=(this['_eventQueues']['get'](_0x2fa2c4)??Promise['resolve']())['catch'](()=>void 0x0)['then'](async()=>{this['_failedConnections']['has'](_0x2fa2c4)&&!_0x50d2ed||await _0x438193();})['catch'](()=>{this['_failedConnections']['add'](_0x2fa2c4),_0x2fa2c4['close'](0x3f3,'WebSocket\x20handler\x20failure');})['finally'](()=>{_0x50d2ed&&(this['_connections']['delete'](_0x2fa2c4),this['_connectionOwners']['delete'](_0x2fa2c4),this['_eventQueues']['delete'](_0x2fa2c4),this['_failedConnections']['delete'](_0x2fa2c4),this['_connectionClosed']['get'](_0x2fa2c4)?.['resolve'](),this['_connectionClosed']['delete'](_0x2fa2c4));});this['_eventQueues']['set'](_0x2fa2c4,_0x793df8);}async['_dispatchHttp'](_0x27ad34){if(this['_disposed'])throw new r('TRANSPORT_DISPOSED','Transport\x20is\x20disposed');await o([...this['_entries']],_0x27ad34);}['_writeHttpError'](_0x33a933,_0x8d27ed){if(_0x33a933['writableEnded']||_0x33a933['destroyed'])return;let _0x556ac3=_0x8d27ed instanceof r?_0x8d27ed['code']==='REQUEST_BODY_TOO_LARGE'?0x19d:_0x8d27ed['code']==='INVALID_JSON'||_0x8d27ed['code']==='REQUEST_ABORTED'||_0x8d27ed['code']==='INVALID_URL'?0x190:0x1f7:0x1f4,_0x30a51b=_0x556ac3===0x19d?'Payload\x20Too\x20Large':_0x556ac3===0x190?'Bad\x20Request':_0x556ac3===0x1f7?'Service\x20Unavailable':'Internal\x20Server\x20Error';_0x33a933['headersSent']?_0x33a933['destroy'](_0x8d27ed instanceof Error?_0x8d27ed:void 0x0):(_0x33a933['statusCode']=_0x556ac3,_0x33a933['setHeader']('content-type','text/plain;\x20charset=utf-8'),_0x33a933['end'](_0x30a51b));}['_writeHttpNotFound'](_0x5c275b){_0x5c275b['headersSent']||_0x5c275b['writableEnded']||_0x5c275b['destroyed']||(_0x5c275b['statusCode']=0x194,_0x5c275b['setHeader']('content-type','text/plain;\x20charset=utf-8'),_0x5c275b['end']('Not\x20Found'));}['_writeUpgradeResponse'](_0x2b2f30,_0xb999fa,_0x36a797){if(_0x2b2f30['destroyed'])return;let _0x4aed2a=t['STATUS_CODES'][_0xb999fa]??'Error',_0x30618a=Buffer['from'](_0x36a797,'utf8');_0x2b2f30['end']('HTTP/1.1\x20'+_0xb999fa+'\x20'+_0x4aed2a+'\x0d\x0aConnection:\x20close\x0d\x0aContent-Type:\x20text/plain;\x20charset=utf-8\x0d\x0aContent-Length:\x20'+_0x30618a['byteLength']+'\x0d\x0a\x0d\x0a'+_0x30618a['toString']('utf8'));}['_registration'](_0x28891d){return{'dispose':()=>this['_disposeEntry'](_0x28891d)};}['_disposeEntry'](_0x665c8){return _0x665c8['disposed']=!0x0,_0x665c8['kind']==='endpoint'?(_0x665c8['disposePromise']||=((async()=>{let _0x1b6027=[];for(let [_0x234627,_0x51bc65]of this['_connectionOwners']){if(_0x51bc65!==_0x665c8)continue;let _0x4f048d=this['_connectionClosed']['get'](_0x234627);_0x4f048d&&_0x1b6027['push'](_0x4f048d['promise']),_0x234627['terminate']();}await Promise['allSettled']([..._0x665c8['calls'],..._0x1b6027]),await _0x665c8['endpoint']['dispose']?.();})()),_0x665c8['disposePromise']):Promise['resolve']();}['_assertRunning'](){if(this['_disposed'])throw new r('TRANSPORT_DISPOSED','Transport\x20is\x20disposed');}};function v(_0x288433){return new _(_0x288433);}exports['NodeTransportError']=r,exports['createNodeTransport']=v;

package/dist/index.d.ts

@@ -1,6 +1,14 @@
-import { IncomingMessage, ServerResponse } from "node:http";
+import { IncomingMessage, Server, ServerResponse } from "node:http";
+import { Server as Server$1 } from "node:https";
 import { Duplex } from "node:stream";
 
+//#region src/errors.d.ts
+type NodeTransportErrorCode = "INVALID_URL" | "INVALID_JSON" | "REQUEST_BODY_TOO_LARGE" | "REQUEST_ABORTED" | "TRANSPORT_DISPOSED";
+declare class NodeTransportError extends Error {
+  readonly code: NodeTransportErrorCode;
+  constructor(code: NodeTransportErrorCode, message: string, options?: ErrorOptions);
+}
+//#endregion
 //#region src/node-transport.d.ts
 declare function createNodeTransport(options?: NodeTransportOptions): INodeTransport;
 //#endregion
@@ -9,49 +17,66 @@ type TransportCustomData = Record<string, unknown>;
 interface TransportDisposable {
   dispose(): void | Promise<void>;
 }
-type NodeTransportErrorCode = "INVALID_JSON" | "REQUEST_BODY_TOO_LARGE" | "REQUEST_ABORTED" | "TRANSPORT_DISPOSED";
-declare class NodeTransportError extends Error {
-  readonly code: NodeTransportErrorCode;
-  constructor(code: NodeTransportErrorCode, message: string, options?: ErrorOptions);
-}
 interface NodeTransportConnection {
   readonly id: string;
   readonly customData: TransportCustomData;
   send(data: string | Uint8Array): void | Promise<void>;
   close(code?: number, reason?: string): void;
 }
-interface BaseNodeTransportContext {
-  readonly customData: TransportCustomData;
-  userId?: string;
-}
-interface NodeHttpTransportContext extends BaseNodeTransportContext {
-  readonly kind: "http";
+interface NodeHttpTransportContext {
   readonly incomingMessage: IncomingMessage;
   readonly response: ServerResponse;
+  readonly customData: TransportCustomData;
+  readonly route?: NodeRoute;
+  readonly params: Readonly<Record<string, string | undefined>>;
+  userID?: string;
   readBody(): Promise<Uint8Array>;
   readJson<T = unknown>(): Promise<T>;
 }
-interface NodeWebSocketOpenTransportContext extends BaseNodeTransportContext {
-  readonly kind: "websocket-open";
+interface NodeWebSocketUpgradeContext {
   readonly incomingMessage: IncomingMessage;
+  readonly customData: TransportCustomData;
+  readonly route?: NodeRoute;
+  readonly params: Readonly<Record<string, string | undefined>>;
+  reject(statusCode?: number, message?: string): void;
+}
+interface NodeWebSocketEndpointContext extends NodeWebSocketUpgradeContext {
+  accept(handler: NodeWebSocketHandler): void;
+}
+interface NodeWebSocketOpenContext {
   readonly connection: NodeTransportConnection;
 }
-interface NodeWebSocketMessageTransportContext extends BaseNodeTransportContext {
-  readonly kind: "websocket-message";
+interface NodeWebSocketMessageContext {
   readonly connection: NodeTransportConnection;
   readonly data: string | Uint8Array;
+  readonly customData: TransportCustomData;
 }
-interface NodeWebSocketCloseTransportContext extends BaseNodeTransportContext {
-  readonly kind: "websocket-close";
+interface NodeWebSocketCloseContext {
   readonly connection: NodeTransportConnection;
   readonly code?: number;
   readonly reason?: string;
 }
-type NodeTransportContext = NodeHttpTransportContext | NodeWebSocketOpenTransportContext | NodeWebSocketMessageTransportContext | NodeWebSocketCloseTransportContext;
+interface NodeWebSocketHandler {
+  open?(ctx: NodeWebSocketOpenContext): void | Promise<void>;
+  message?(ctx: NodeWebSocketMessageContext): void | Promise<void>;
+  close?(ctx: NodeWebSocketCloseContext): void | Promise<void>;
+}
 type NodeTransportNext = () => Promise<void>;
-type NodeTransportMiddleware = (ctx: NodeTransportContext, next: NodeTransportNext) => void | Promise<void>;
-interface NodeTransportMiddlewareObject {
-  handle(ctx: NodeTransportContext, next: NodeTransportNext): void | Promise<void>;
+type NodeHttpTransportMiddleware = (ctx: NodeHttpTransportContext, next: NodeTransportNext) => void | Promise<void>;
+type NodeWebSocketUpgradeMiddleware = (ctx: NodeWebSocketUpgradeContext, next: NodeTransportNext) => void | Promise<void>;
+interface NodeRoute {
+  readonly path: string;
+}
+type NodeHttpHandler = (ctx: NodeHttpTransportContext) => void | Promise<void>;
+type NodeUpgradeHandler = (ctx: NodeWebSocketEndpointContext) => void | Promise<void>;
+interface NodeRouter {
+  get(path: string, handler: NodeHttpHandler): void;
+  post(path: string, handler: NodeHttpHandler): void;
+  delete(path: string, handler: NodeHttpHandler): void;
+  upgrade(path: string, handler: NodeUpgradeHandler): void;
+}
+interface NodeTransportEndpoint {
+  register(router: NodeRouter): void;
   dispose?(): void | Promise<void>;
 }
 interface NodeTransportOptions {
@@ -59,10 +84,13 @@ interface NodeTransportOptions {
   readonly maxWebSocketMessageBytes?: number;
 }
 interface INodeTransport {
-  use(middleware: NodeTransportMiddleware | NodeTransportMiddlewareObject): TransportDisposable;
+  attach(server: Server | Server$1): void;
+  use(middleware: NodeHttpTransportMiddleware): TransportDisposable;
+  useUpgrade(middleware: NodeWebSocketUpgradeMiddleware): TransportDisposable;
+  register(endpoint: NodeTransportEndpoint): TransportDisposable;
   handleRequest(request: IncomingMessage, response: ServerResponse): void;
   handleUpgrade(request: IncomingMessage, socket: Duplex, head: Buffer): void;
   dispose(): Promise<void>;
 }
 //#endregion
-export { type INodeTransport, type NodeHttpTransportContext, type NodeTransportConnection, type NodeTransportContext, NodeTransportError, type NodeTransportErrorCode, type NodeTransportMiddleware, type NodeTransportMiddlewareObject, type NodeTransportNext, type NodeTransportOptions, type NodeWebSocketCloseTransportContext, type NodeWebSocketMessageTransportContext, type NodeWebSocketOpenTransportContext, type TransportCustomData, type TransportDisposable, createNodeTransport };
+export { type INodeTransport, type NodeHttpHandler, type NodeHttpTransportContext, type NodeHttpTransportMiddleware, type NodeRoute, type NodeRouter, type NodeTransportConnection, type NodeTransportEndpoint, NodeTransportError, type NodeTransportErrorCode, type NodeTransportNext, type NodeTransportOptions, type NodeUpgradeHandler, type NodeWebSocketCloseContext, type NodeWebSocketEndpointContext, type NodeWebSocketHandler, type NodeWebSocketMessageContext, type NodeWebSocketOpenContext, type NodeWebSocketUpgradeContext, type NodeWebSocketUpgradeMiddleware, type TransportCustomData, type TransportDisposable, createNodeTransport };

package/dist/index.mjs

@@ -1 +1 @@
-const _0x2154a0=_0x50c8;(function(_0x32f47b,_0x4dd3d4){const _0x2f66b5=_0x50c8,_0xdc68ca=_0x32f47b();while(!![]){try{const _0x574f66=parseInt(_0x2f66b5(0x1b4))/0x1+-parseInt(_0x2f66b5(0x1b7))/0x2*(parseInt(_0x2f66b5(0x1b6))/0x3)+parseInt(_0x2f66b5(0x1bb))/0x4*(parseInt(_0x2f66b5(0x1bc))/0x5)+parseInt(_0x2f66b5(0x1b8))/0x6+parseInt(_0x2f66b5(0x1be))/0x7+-parseInt(_0x2f66b5(0x1ba))/0x8*(-parseInt(_0x2f66b5(0x1bf))/0x9)+-parseInt(_0x2f66b5(0x1b5))/0xa*(parseInt(_0x2f66b5(0x1bd))/0xb);if(_0x574f66===_0x4dd3d4)break;else _0xdc68ca['push'](_0xdc68ca['shift']());}catch(_0x1ca5c9){_0xdc68ca['push'](_0xdc68ca['shift']());}}}(_0x2327,0x59557));import _0x842b00 from'./index.cjs';function _0x50c8(_0xf399d9,_0x51d2bd){_0xf399d9=_0xf399d9-0x1b4;const _0x23271d=_0x2327();let _0x50c837=_0x23271d[_0xf399d9];return _0x50c837;}function _0x2327(){const _0x1ac2df=['979uDLGqU','4190907kIFyNN','54UWhzbt','675282SklcrG','207020bFgjRE','453vwLmjn','3908YABWkU','1216254aYAPnj','createNodeTransport','790456tCZUmI','28WCjdeL','309935BZyxtz'];_0x2327=function(){return _0x1ac2df;};return _0x2327();}const facadeExport0=_0x842b00['NodeTransportError'],facadeExport1=_0x842b00[_0x2154a0(0x1b9)];export{facadeExport0 as NodeTransportError,facadeExport1 as createNodeTransport};
+function _0x4dd9(_0x467017,_0x90024f){_0x467017=_0x467017-0xcf;const _0x488333=_0x4883();let _0x4dd96b=_0x488333[_0x467017];return _0x4dd96b;}const _0x41124a=_0x4dd9;function _0x4883(){const _0x333a69=['426ejxbEr','419904oMYlUv','2705JXrPYe','476367wFMNhu','NodeTransportError','245064ymUwTM','405111lJRLCM','230847HFCwxq','createNodeTransport','1800976dJNtzb'];_0x4883=function(){return _0x333a69;};return _0x4883();}(function(_0x1df63d,_0x3227cd){const _0x1fd1f1=_0x4dd9,_0xbeb02a=_0x1df63d();while(!![]){try{const _0x2483d1=-parseInt(_0x1fd1f1(0xd5))/0x1+-parseInt(_0x1fd1f1(0xd3))/0x2+parseInt(_0x1fd1f1(0xd1))/0x3+parseInt(_0x1fd1f1(0xcf))/0x4+-parseInt(_0x1fd1f1(0xd0))/0x5*(-parseInt(_0x1fd1f1(0xd8))/0x6)+-parseInt(_0x1fd1f1(0xd4))/0x7+parseInt(_0x1fd1f1(0xd7))/0x8;if(_0x2483d1===_0x3227cd)break;else _0xbeb02a['push'](_0xbeb02a['shift']());}catch(_0x12ba89){_0xbeb02a['push'](_0xbeb02a['shift']());}}}(_0x4883,0x1c54e));import _0x42aeb9 from'./index.cjs';const facadeExport0=_0x42aeb9[_0x41124a(0xd2)],facadeExport1=_0x42aeb9[_0x41124a(0xd6)];export{facadeExport0 as NodeTransportError,facadeExport1 as createNodeTransport};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@univerjs-pro/collaboration-transport-node",
   "type": "module",
-  "version": "1.0.0-insiders.20260808-70eefdd",
+  "version": "1.0.0",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
@@ -17,8 +17,5 @@
   ],
   "dependencies": {
     "ws": "^8.21.1"
-  },
-  "publishConfig": {
-    "access": "public"
   }
-}
+}