@claxedo/workspace-relay-protocol 0.10.0 → 0.10.1

package/dist/index.d.ts

@@ -9,6 +9,19 @@ export declare const SESSION_TURN_LEASE_TTL_MS = 60000;
  * admits only this number, and a lower one is never promoted.
  */
 export declare const CURRENT_CHANNEL_IDENTITY_VERSION = 1;
+/**
+ * A close code a server may send: 1000–4999 except 1004, 1005 and 1006, which
+ * only ever describe a close and which workerd's `close()` refuses; anything
+ * else becomes `fallback`.
+ */
+export declare function closeCode(code: number | undefined, fallback?: number): number;
+/**
+ * A WebSocket close reason cut to the 123 UTF-8 bytes a close frame carries,
+ * at a character boundary. A WHATWG or Node `ws` socket's `close()` throws past
+ * it, and workerd's does from compatibility date 2026-03-03
+ * (`websocket_close_reason_byte_limit`).
+ */
+export declare function closeReason(reason: unknown): string;
 /**
  * What a Runtime Access Token's scope reaches, asked of the runtime path a
  * request names. A token with no session is the workspace owner's and reaches

package/dist/index.mjs

@@ -245,6 +245,30 @@ var TUNNEL_PROTOCOL_VERSION = 1;
 var SESSION_STREAM_LEASE_TTL_MS = 15000;
 var SESSION_TURN_LEASE_TTL_MS = 60000;
 var CURRENT_CHANNEL_IDENTITY_VERSION = 1;
+function closeCode(code, fallback = 1011) {
+  if (code === undefined)
+    return fallback;
+  if (code >= 1000 && code <= 4999 && ![1004, 1005, 1006].includes(code))
+    return code;
+  return fallback;
+}
+var CLOSE_REASON_MAX_BYTES = 123;
+function closeReason(reason) {
+  if (typeof reason !== "string")
+    return "";
+  const encoder = new TextEncoder;
+  if (encoder.encode(reason).byteLength <= CLOSE_REASON_MAX_BYTES)
+    return reason;
+  let cut = "";
+  let bytes = 0;
+  for (const char of reason) {
+    bytes += encoder.encode(char).byteLength;
+    if (bytes > CLOSE_REASON_MAX_BYTES)
+      return cut;
+    cut += char;
+  }
+  return cut;
+}
 function sessionScopeReaches(sessionScope, path, search) {
   if (sessionScope === undefined)
     return true;
@@ -372,6 +396,8 @@ export {
   createStaticTokenVerifier,
   createOidcTokenVerifier,
   createHttpTokenVerifier,
+  closeReason,
+  closeCode,
   TokenVerifierError,
   TUNNEL_PROTOCOL_VERSION,
   SESSION_TURN_LEASE_TTL_MS,

package/package.json

@@ -33,7 +33,7 @@
     "access": "public"
   },
   "name": "@claxedo/workspace-relay-protocol",
-  "version": "0.10.0",
+  "version": "0.10.1",
   "scripts": {
     "build": "bun scripts/build.ts",
     "prepublishOnly": "npm run build",
@@ -41,7 +41,7 @@
     "test": "mkdir -p .artifacts/unit && node ../../script/test-deadline.mjs bun test src --reporter=junit --reporter-outfile=.artifacts/unit/junit.xml"
   },
   "dependencies": {
-    "@claxedo/helpers": "0.2.0",
+    "@claxedo/helpers": "0.2.1",
     "jose": "6.0.11"
   },
   "devDependencies": {