@crowdedkingdoms/crowdy-dsh 0.3.0 → 0.3.1-dev.1

package/dist/dsh-web/BUILD.json

@@ -1,10 +1,10 @@
 {
   "package": "@crowdedkingdoms/crowdy-dsh",
-  "version": "0.3.0",
-  "builtAt": "2026-09-13T18:14:35.893Z",
+  "version": "0.3.1",
+  "builtAt": "2026-09-13T20:32:20.481Z",
   "source": {
     "repository": "CrowdedKingdoms/crowdy-dsh",
-    "commit": "702cda3c17f7e9c3db831854a38825859ea493ff",
+    "commit": "fefcd8ee55fc6df8b16a09f6db19de1e8a3189db",
     "dirty": false
   },
   "upstream": {
@@ -15,7 +15,7 @@
   },
   "crowdyjs": {
     "name": "@crowdedkingdoms/crowdyjs",
-    "version": "17.0.1",
+    "version": "17.1.0-dev.1",
     "source": "node_modules"
   },
   "files": {
@@ -112,7 +112,7 @@
     "manifest.webmanifest": "sha256:9b54d57eea00f2fdd1affe6e7999a4209a515755f12ac1a3299da2d55e178d4c",
     "preview/bootstrap-CYECZNXt.js": "sha256:9f303a0485c0badfdd19fad0c357ef050c5b9a343744ab5bf0c70015e7d95092",
     "preview/crowdy-boot-Cklh1qNl.js": "sha256:b21e8eb126e1cd8a52159d2d577e610df6c8af36a436f9ed5028cfabd11a85ff",
-    "preview/vfs-image.tar.gz": "sha256:abde28e45be058a6ca93008319306615441e75e4cfee1257ba8cd0781a719021",
+    "preview/vfs-image.tar.gz": "sha256:721074e8f744bc811e7c9cf18d486682cce88264014412671b7d5436a834cce6",
     "preview/worker-C8-_ANaz.js": "sha256:81099e5732dfe0c32bacd5897316b7956c5a0a22da01b4a0c6e21d0a3b9d9aa1"
   }
 }

package/lib/vendor/crowdyjs-sdk.js

@@ -5814,6 +5814,44 @@ function validateChunkCoordinates(chunk) {
 }
 
 var RELAY_MAX_DATAGRAM_BYTES = 1232;
+var BUNDLE_HEADER_BYTES = 1;
+var BUNDLE_LENGTH_PREFIX_BYTES = 2;
+var RELAY_MAX_BUNDLE_MEMBERS = 32;
+var RELAY_MAX_BUNDLE_MEMBER_BYTES = RELAY_MAX_DATAGRAM_BYTES - BUNDLE_HEADER_BYTES - BUNDLE_LENGTH_PREFIX_BYTES;
+function bundleSizeOf(members) {
+  let size = BUNDLE_HEADER_BYTES;
+  for (const m of members)
+    size += BUNDLE_LENGTH_PREFIX_BYTES + m.length;
+  return size;
+}
+function packMessageBundle(members) {
+  if (members.length === 0)
+    throw new Error("MESSAGE_BUNDLE needs at least one member");
+  if (members.length > RELAY_MAX_BUNDLE_MEMBERS) {
+    throw new Error(`MESSAGE_BUNDLE holds at most ${RELAY_MAX_BUNDLE_MEMBERS} members`);
+  }
+  for (const m of members) {
+    if (m.length === 0)
+      throw new Error("MESSAGE_BUNDLE member cannot be empty");
+  }
+  if (members.length === 1)
+    return members[0];
+  const size = bundleSizeOf(members);
+  if (size > RELAY_MAX_DATAGRAM_BYTES) {
+    throw new Error(`MESSAGE_BUNDLE of ${size} bytes exceeds ${RELAY_MAX_DATAGRAM_BYTES}`);
+  }
+  const out = new Uint8Array(size);
+  const view = new DataView(out.buffer);
+  out[0] = WireMessageType.MESSAGE_BUNDLE;
+  let off = BUNDLE_HEADER_BYTES;
+  for (const m of members) {
+    view.setUint16(off, m.length, true);
+    off += BUNDLE_LENGTH_PREFIX_BYTES;
+    out.set(m, off);
+    off += m.length;
+  }
+  return out;
+}
 var WireMessageType = {
   MESSAGE_BUNDLE: 2,
   GENERIC_ERROR_MESSAGE: 3,
@@ -6252,6 +6290,10 @@ function isSameEstate(current, candidate) {
   const site = (h) => h.split(".").slice(-2).join(".");
   return site(a) === site(b) && site(a).includes(".");
 }
+function documentIsHidden() {
+  const doc = globalThis.document;
+  return doc?.visibilityState === "hidden";
+}
 function base64UrlEncode(value) {
   return btoa(value).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/g, "");
 }
@@ -6267,11 +6309,27 @@ var BinaryRelayTransport = class {
     this.everReady = false;
     this.retryTimer = null;
     this.generation = 0;
+    this.pendingMembers = [];
+    this.pendingBytes = 0;
+    this.bundleTimer = null;
+    this.sendStats = {
+      messagesSent: 0,
+      framesSent: 0,
+      bundlesSent: 0,
+      bytesSent: 0,
+      messagesDropped: 0
+    };
     this.url = config.url;
     this.logger = config.logger ?? silentLogger;
     this.retryAttempts = config.retryAttempts ?? 8;
     this.retryInitialDelayMs = config.retryInitialDelayMs ?? 250;
     this.retryMaxDelayMs = config.retryMaxDelayMs ?? 5e3;
+    this.bundleSends = config.bundleSends ?? true;
+    this.bundleWindowMs = Math.max(0, config.bundleWindowMs ?? 1);
+  }
+  /** Snapshot of the uplink counters. */
+  stats() {
+    return { ...this.sendStats };
   }
   /** True when the socket is open and the `ready` handshake completed. */
   isReady() {
@@ -6290,6 +6348,7 @@ var BinaryRelayTransport = class {
   }
   disconnect() {
     this.desired = false;
+    this.flushSends();
     if (this.retryTimer) {
       clearTimeout(this.retryTimer);
       this.retryTimer = null;
@@ -6316,7 +6375,11 @@ var BinaryRelayTransport = class {
     this.appId = appId;
     this.open();
   }
-  /** Send one pre-serialized Buddy datagram as a BINARY frame. */
+  /**
+   * Send one pre-serialized, signed Buddy message. With `bundleSends` it joins
+   * the pending MESSAGE_BUNDLE and leaves with it (see {@link flushSends});
+   * otherwise it is one BINARY frame right now.
+   */
   sendFrame(frame) {
     if (!this.isReady() || !this.ws) {
       throw new CrowdyRealtimeError("Binary relay is not connected", {
@@ -6324,7 +6387,63 @@ var BinaryRelayTransport = class {
         retryable: true
       });
     }
+    if (frame.length === 0)
+      return;
+    this.sendStats.messagesSent += 1;
+    if (!this.bundleSends) {
+      this.transmit(frame, false);
+      return;
+    }
+    if (frame.length > RELAY_MAX_BUNDLE_MEMBER_BYTES) {
+      this.flushSends();
+      this.transmit(frame, false);
+      return;
+    }
+    const wouldBe = this.pendingBytes + BUNDLE_LENGTH_PREFIX_BYTES + frame.length;
+    if (this.pendingMembers.length > 0 && (wouldBe > RELAY_MAX_DATAGRAM_BYTES || this.pendingMembers.length >= RELAY_MAX_BUNDLE_MEMBERS)) {
+      this.flushSends();
+    }
+    if (this.pendingMembers.length === 0) {
+      this.pendingBytes = bundleSizeOf([]);
+      this.bundleTimer = setTimeout(() => {
+        this.bundleTimer = null;
+        this.flushSends();
+      }, this.bundleWindowMs);
+    }
+    this.pendingMembers.push(frame);
+    this.pendingBytes += BUNDLE_LENGTH_PREFIX_BYTES + frame.length;
+    if (documentIsHidden())
+      this.flushSends();
+  }
+  /**
+   * Put the pending bundle on the wire now instead of at the end of the
+   * window. Call it at the end of a frame when that frame's sends should not
+   * wait. No-op when nothing is pending.
+   */
+  flushSends() {
+    if (this.bundleTimer) {
+      clearTimeout(this.bundleTimer);
+      this.bundleTimer = null;
+    }
+    const members = this.pendingMembers;
+    if (members.length === 0)
+      return;
+    this.pendingMembers = [];
+    this.pendingBytes = 0;
+    if (!this.isReady() || !this.ws) {
+      this.sendStats.messagesDropped += members.length;
+      return;
+    }
+    this.transmit(packMessageBundle(members), members.length > 1);
+  }
+  transmit(frame, wrapped) {
+    if (!this.ws)
+      return;
     this.ws.send(frame);
+    this.sendStats.framesSent += 1;
+    this.sendStats.bytesSent += frame.length;
+    if (wrapped)
+      this.sendStats.bundlesSent += 1;
   }
   open() {
     const token = this.callbacks.getToken();
@@ -6523,6 +6642,8 @@ var RealtimeClient = class {
     this.lbCookieStore = config.lbCookieStore;
     this.wsUplinkMutations = config.wsUplinkMutations === true;
     this.binaryTransport = config.binaryTransport === true;
+    this.bundleSends = config.bundleSends ?? true;
+    this.bundleWindowMs = config.bundleWindowMs ?? 1;
     this.binaryRelayUrl = config.binaryRelayUrl ?? deriveBinaryRelayUrl(this.wsUrl);
     this.session.onChange((token) => {
       if (!this.desired)
@@ -6736,6 +6857,23 @@ var RealtimeClient = class {
   usingBinaryTransport() {
     return this.binaryTransport && !this.binaryUnavailable;
   }
+  /**
+   * Put the binary relay's pending `MESSAGE_BUNDLE` on the wire now instead of
+   * at the end of {@link RealtimeConfig.bundleWindowMs}. Call it at the end of
+   * a frame when that frame's sends should not wait. No-op on the GraphQL
+   * transport or when nothing is pending.
+   */
+  flushSends() {
+    this.binaryRelay?.flushSends();
+  }
+  /**
+   * Uplink counters of the binary relay (messages, frames, bundles, bytes,
+   * drops), or `null` when the relay has not been created. These are a local
+   * diagnostic, not a bill.
+   */
+  binaryRelayStats() {
+    return this.binaryRelay?.stats() ?? null;
+  }
   /**
    * Serialize (with the session signing context) and send one datagram over
    * the binary relay. Throws `BINARY_RELAY_UNAVAILABLE` when the relay is not
@@ -6938,7 +7076,9 @@ var RealtimeClient = class {
         retryAttempts: this.retryAttempts,
         retryInitialDelayMs: this.retryInitialDelayMs,
         retryMaxDelayMs: this.retryMaxDelayMs,
-        logger: this.logger
+        logger: this.logger,
+        bundleSends: this.bundleSends,
+        bundleWindowMs: this.bundleWindowMs
       }, {
         getToken: () => this.session.getToken(),
         onNotification: (notification) => this.dispatch(notification),
@@ -15786,6 +15926,15 @@ var UdpAPI = class {
    * @returns `true` once the session has been closed.
    * @throws {CrowdyGraphQLError} on auth failures.
    */
+  /**
+   * Binary relay only: put the pending `MESSAGE_BUNDLE` on the wire now
+   * instead of at the end of `realtime.bundleWindowMs`. Call it at the end of a
+   * frame whose sends should not wait. No-op on the GraphQL transport, when
+   * `realtime.bundleSends` is false, or when nothing is pending.
+   */
+  flushSends() {
+    this.subs.flushSends();
+  }
   async disconnect() {
     if (this.subs.usingBinaryTransport()) {
       this.subs.disconnect();
@@ -15905,6 +16054,7 @@ var UdpAPI = class {
     const request = this.withSequence(input);
     const wait = this.subs.waitForSequence(request.sequenceNumber, options.timeoutMs);
     await this.sendActorUpdate(request);
+    this.subs.flushSends();
     return wait;
   }
   /**
@@ -15972,6 +16122,7 @@ var UdpAPI = class {
     const request = this.withSequence(input);
     const wait = this.subs.waitForSequence(request.sequenceNumber, options.timeoutMs);
     await this.sendVoxelUpdate(request);
+    this.subs.flushSends();
     return wait;
   }
   /**
@@ -16030,6 +16181,7 @@ var UdpAPI = class {
     const request = this.withSequence(input);
     const wait = this.subs.waitForSequence(request.sequenceNumber, options.timeoutMs);
     await this.sendAudioPacket(request);
+    this.subs.flushSends();
     return wait;
   }
   /**
@@ -16141,6 +16293,7 @@ var UdpAPI = class {
     const request = this.withSequence(input);
     const wait = this.subs.waitForSequence(request.sequenceNumber, options.timeoutMs);
     await this.sendTextPacket(request);
+    this.subs.flushSends();
     return wait;
   }
   /**
@@ -16201,6 +16354,7 @@ var UdpAPI = class {
     const request = this.withSequence(input);
     const wait = this.subs.waitForSequence(request.sequenceNumber, options.timeoutMs);
     await this.sendClientEvent(request);
+    this.subs.flushSends();
     return wait;
   }
   /**

package/lib/vendor/crowdyjs-sdk.version.json

@@ -1,5 +1,5 @@
 {
   "name": "@crowdedkingdoms/crowdyjs",
-  "version": "17.0.1",
+  "version": "17.1.0-dev.1",
   "source": "node_modules"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crowdedkingdoms/crowdy-dsh",
-  "version": "0.3.0",
+  "version": "0.3.1-dev.1",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -94,11 +94,11 @@
   "crowdyDsh": {
     "build": {
       "package": "@crowdedkingdoms/crowdy-dsh",
-      "version": "0.3.0",
-      "builtAt": "2026-09-13T18:14:35.893Z",
+      "version": "0.3.1",
+      "builtAt": "2026-09-13T20:32:20.481Z",
       "source": {
         "repository": "CrowdedKingdoms/crowdy-dsh",
-        "commit": "702cda3c17f7e9c3db831854a38825859ea493ff",
+        "commit": "fefcd8ee55fc6df8b16a09f6db19de1e8a3189db",
         "dirty": false
       },
       "upstream": {
@@ -109,7 +109,7 @@
       },
       "crowdyjs": {
         "name": "@crowdedkingdoms/crowdyjs",
-        "version": "17.0.1",
+        "version": "17.1.0-dev.1",
         "source": "node_modules"
       },
       "files": {
@@ -206,7 +206,7 @@
         "manifest.webmanifest": "sha256:9b54d57eea00f2fdd1affe6e7999a4209a515755f12ac1a3299da2d55e178d4c",
         "preview/bootstrap-CYECZNXt.js": "sha256:9f303a0485c0badfdd19fad0c357ef050c5b9a343744ab5bf0c70015e7d95092",
         "preview/crowdy-boot-Cklh1qNl.js": "sha256:b21e8eb126e1cd8a52159d2d577e610df6c8af36a436f9ed5028cfabd11a85ff",
-        "preview/vfs-image.tar.gz": "sha256:abde28e45be058a6ca93008319306615441e75e4cfee1257ba8cd0781a719021",
+        "preview/vfs-image.tar.gz": "sha256:721074e8f744bc811e7c9cf18d486682cce88264014412671b7d5436a834cce6",
         "preview/worker-C8-_ANaz.js": "sha256:81099e5732dfe0c32bacd5897316b7956c5a0a22da01b4a0c6e21d0a3b9d9aa1"
       }
     }