@kumiai/hub-server 0.12.1 → 0.12.2

package/lib/handlers.js

@@ -1,7 +1,7 @@
 import { HandlerError } from '@enkaku/server';
 import { HUB_ERROR_CODES, hubErrorCodeOf, InvalidPayloadError, KeyPackageFetchLimitError, keyPackageDigest, wakeRecipientKeyProblem } from '@kumiai/hub-protocol';
 import { fromB64, toB64 } from '@sozai/codec';
-import { getReporter } from '@sozai/log';
+import { getLogger, getReporter } from '@sozai/log';
 import { createRateLimiter } from './rateLimit.js';
 function normalizeAuthorizeDecision(decision) {
     return typeof decision === 'boolean' ? {
@@ -29,6 +29,11 @@ const reportStoreError = getReporter([
     'kumiai',
     'hub-server'
 ], '@kumiai/hub-server');
+const receiveLogger = getLogger([
+    'kumiai',
+    'hub-server',
+    'receive'
+]);
 /** What the failed operation was about, for the default log line: a DID for the per-recipient
  * methods, a topic for fan-out, nothing for a store-wide purge. */ function subjectOf(event) {
     switch(event.method){
@@ -550,11 +555,22 @@ export function createHandlers(params) {
             // backpressure stalls `writer.write` until `receiveBufferLimit` tears the channel down.
             function waitForRoom(bytes) {
                 if (tornDown || hasRoom(bytes)) return Promise.resolve();
+                receiveLogger.debug('receive window full for {recipientDID}: paused with {frames} frames ({bytes} bytes) unacked', {
+                    recipientDID: clientDID,
+                    frames: inFlight.size,
+                    bytes: inFlightBytes
+                });
                 return new Promise((resolve)=>{
                     let timer;
                     const arm = ()=>{
                         clearTimeout(timer);
                         timer = setTimeout(()=>{
+                            receiveLogger.warn('receive ack timeout for {recipientDID}: released {frames} frames ({bytes} bytes) after {timeoutMs} ms', {
+                                recipientDID: clientDID,
+                                frames: inFlight.size,
+                                bytes: inFlightBytes,
+                                timeoutMs: receiveAckTimeout
+                            });
                             releaseAll();
                             notifyWindow();
                         }, receiveAckTimeout);
@@ -593,10 +609,19 @@ export function createHandlers(params) {
             const done = new Promise((resolve)=>{
                 resolveDone = resolve;
             });
+            function logUnackedFrames() {
+                if (inFlight.size === 0) return;
+                receiveLogger.debug('receive stream ended for {recipientDID} with {frames} frames ({bytes} bytes) unacked', {
+                    recipientDID: clientDID,
+                    frames: inFlight.size,
+                    bytes: inFlightBytes
+                });
+            }
             // Idempotent teardown, shared by every failure and end path. Frames stay pending in the store
             // and redeliver on the next connect (store-and-forward).
             function finish() {
                 if (tornDown) return;
+                logUnackedFrames();
                 tornDown = true;
                 notifyWindow();
                 if (receiveToken != null) registry.releaseReceiveWriter(clientDID, receiveToken);
@@ -742,6 +767,7 @@ export function createHandlers(params) {
                 }
             } catch (error) {
                 // A synchronous drain error (e.g. store.fetch threw): clean up and reject the handler.
+                if (!tornDown) logUnackedFrames();
                 tornDown = true;
                 notifyWindow();
                 if (receiveToken != null) registry.releaseReceiveWriter(clientDID, receiveToken);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kumiai/hub-server",
-  "version": "0.12.1",
+  "version": "0.12.2",
   "description": "Hub server for Enkaku E2EE group message routing",
   "keywords": [
     "hub",
@@ -25,8 +25,8 @@
     "lib/*"
   ],
   "dependencies": {
-    "@enkaku/protocol": "^0.22.4",
-    "@enkaku/server": "^0.22.4",
+    "@enkaku/protocol": "^0.22.5",
+    "@enkaku/server": "^0.22.5",
     "@kokuin/capability": "^0.5.2",
     "@kokuin/token": "^0.6.4",
     "@kumiai/hub-protocol": "^0.12.0",
@@ -35,8 +35,8 @@
     "@sozai/log": "^0.4.0"
   },
   "devDependencies": {
-    "@enkaku/client": "^0.22.4",
-    "@enkaku/transport": "^0.22.4",
+    "@enkaku/client": "^0.22.5",
+    "@enkaku/transport": "^0.22.5",
     "@kumiai/hub-conformance": "^0.12.0",
     "@kumiai/hub-wake": "^0.12.0"
   },