@johnhenry/wsh 0.5.0 → 0.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@johnhenry/wsh",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "Web Shell \u2014 browser-native remote command execution over WebTransport and WebSocket with Ed25519 authentication",
   "type": "module",
   "main": "./src/index.mjs",

package/src/index.d.ts

@@ -127,9 +127,6 @@ export const MSG: {
   readonly REVERSE_ACCEPT: 0x54;
   readonly REVERSE_REJECT: 0x55;
 
-  // Framing
-  readonly WS_DATA: 0x60;
-
   // Gateway
   readonly OPEN_TCP: 0x70;
   readonly OPEN_UDP: 0x71;

package/src/index.mjs

@@ -49,8 +49,8 @@ export {
 } from './auth.mjs';
 
 // Transport
-export { WshTransport, WebTransportTransport } from './transport.mjs';
-export { WebSocketTransport } from './transport-ws.mjs';
+export { WshTransport, WebTransportTransport, dispatchSerially, SerialQueue } from './transport.mjs';
+export { WebSocketTransport, WS_FRAME_TYPE } from './transport-ws.mjs';
 
 // Session + Client
 export { WshSession } from './session.mjs';

package/src/messages.gen.mjs

@@ -66,11 +66,6 @@ export const MSG = Object.freeze({
   // Session
   SESSION_LIST:      0x5f,
   DETACH:            0x60,
-
-  // Framing
-  WS_DATA:           0x60,
-
-  // Session
   DETACH_OK:         0x61,
   DETACH_FAIL:       0x62,
 

package/src/transport-ws.mjs

@@ -20,19 +20,33 @@ import { WshTransport, dispatchSerially, SerialQueue } from './transport.mjs';
 
 // ── Frame type constants ─────────────────────────────────────────────
 //
-// NOTE: these are unrelated to MSG.WS_DATA (0x60) in messages.gen.mjs.
-// WS_DATA is a JS-only, CBOR-layer bookkeeping marker (it shares its
-// opcode with MSG.DETACH and is explicitly excluded from the Rust
-// message enum by spec/codegen.mjs) — it is never sent as the outer
-// envelope's frame-type byte below. See spec/wsh-v1.yaml's
-// `transport.websocket` section for the authoritative outer-envelope
-// framing docs.
+// Unrelated to the CBOR-layer MSG opcodes (messages.gen.mjs) -- these are
+// the outer envelope's frame-type byte. See spec/wsh-v1.yaml's
+// `transport.websocket` section for the authoritative framing docs.
 
 const FRAME_CONTROL      = 0x01;
 const FRAME_DATA         = 0x02;
 const FRAME_OPEN_STREAM  = 0x03;
 const FRAME_CLOSE_STREAM = 0x04;
 
+/**
+ * The mux frame-type byte values, exported for anything outside this
+ * module that needs to name or inspect them correctly — tooling,
+ * logging, or an alternative from-scratch implementation of this
+ * transport in another runtime, which needs these exact wire values to
+ * interoperate. Not related to `MSG` (messages.gen.mjs): that's the
+ * CBOR-layer protocol-message opcode space carried *inside* a
+ * FRAME_CONTROL payload, a separate numbering space at a different
+ * layer of the stack. (An earlier, since-removed `MSG.WS_DATA` conflated
+ * the two and collided with a real MSG opcode — see CHANGELOG 0.6.0.)
+ */
+export const WS_FRAME_TYPE = Object.freeze({
+  CONTROL: FRAME_CONTROL,
+  DATA: FRAME_DATA,
+  OPEN_STREAM: FRAME_OPEN_STREAM,
+  CLOSE_STREAM: FRAME_CLOSE_STREAM,
+});
+
 // ── Header helpers ───────────────────────────────────────────────────
 
 const HEADER_SIZE = 5; // 1 byte type + 4 bytes stream ID