request-iframe 0.1.1 → 0.2.1

package/esm/utils/debug.js

@@ -10,28 +10,21 @@ import "core-js/modules/es.promise.js";
 import "core-js/modules/web.dom-collections.iterator.js";
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
-import { MessageType, getStatusText, Messages } from '../constants';
-
-/**
- * Debug log prefix
- */
-var DEBUG_PREFIX = '[request-iframe]';
-
-/**
- * Format log output
- * - Prefix: bold
- * - info: message text in blue
- */
-function log(level, message, data) {
-  var timestamp = new Date().toISOString();
-  var prefix = `${DEBUG_PREFIX} [${timestamp}] [${level.toUpperCase()}]`;
-  var prefixStyle = 'font-weight:bold';
-  var messageStyle = level === 'info' ? 'color: #1976d2' : '';
-  if (data !== undefined) {
-    console[level](`%c${prefix}%c ${message}`, prefixStyle, messageStyle, data);
-  } else {
-    console[level](`%c${prefix}%c ${message}`, prefixStyle, messageStyle);
+import { MessageType, getStatusText, Messages, LogLevel, DebugEvent } from '../constants';
+import { ensureRequestIframeLogLevel, requestIframeLog } from './logger';
+function logEvent(level, event, message, data) {
+  if (data !== undefined && data !== null && typeof data === 'object') {
+    requestIframeLog(level, message, _objectSpread({
+      event
+    }, data));
+    return;
   }
+  requestIframeLog(level, message, data === undefined ? {
+    event
+  } : {
+    event,
+    data
+  });
 }
 
 /**
@@ -63,9 +56,11 @@ function formatMessageData(data) {
  * Register debug interceptors for client
  */
 export function setupClientDebugInterceptors(client) {
+  ensureRequestIframeLogLevel(LogLevel.INFO);
+
   // Request interceptor: log request start
   client.interceptors.request.use(config => {
-    log('info', Messages.DEBUG_CLIENT_REQUEST_START, formatMessageData({
+    logEvent(LogLevel.INFO, DebugEvent.CLIENT_REQUEST_START, Messages.DEBUG_CLIENT_REQUEST_START, formatMessageData({
       path: config.path,
       body: config.body,
       headers: config.headers,
@@ -98,20 +93,20 @@ export function setupClientDebugInterceptors(client) {
         mimeType,
         contentLength
       };
-      log('info', Messages.DEBUG_CLIENT_REQUEST_SUCCESS_FILE, formatMessageData(logData));
+      logEvent(LogLevel.INFO, DebugEvent.CLIENT_REQUEST_SUCCESS_FILE, Messages.DEBUG_CLIENT_REQUEST_SUCCESS_FILE, formatMessageData(logData));
     } else if (response.stream) {
       logData.stream = {
         streamId: response.stream.streamId,
         type: response.stream.type
       };
-      log('info', Messages.DEBUG_CLIENT_REQUEST_SUCCESS_STREAM, formatMessageData(logData));
+      logEvent(LogLevel.INFO, DebugEvent.CLIENT_REQUEST_SUCCESS_STREAM, Messages.DEBUG_CLIENT_REQUEST_SUCCESS_STREAM, formatMessageData(logData));
     } else {
       logData.data = response.data;
-      log('info', Messages.DEBUG_CLIENT_REQUEST_SUCCESS, formatMessageData(logData));
+      logEvent(LogLevel.INFO, DebugEvent.CLIENT_REQUEST_SUCCESS, Messages.DEBUG_CLIENT_REQUEST_SUCCESS, formatMessageData(logData));
     }
     return response;
   }, error => {
-    log('error', Messages.DEBUG_CLIENT_REQUEST_FAILED, formatMessageData({
+    logEvent(LogLevel.ERROR, DebugEvent.CLIENT_REQUEST_FAILED, Messages.DEBUG_CLIENT_REQUEST_FAILED, formatMessageData({
       requestId: error.requestId,
       code: error.code,
       message: error.message,
@@ -121,114 +116,116 @@ export function setupClientDebugInterceptors(client) {
     return Promise.reject(error);
   });
 
-  // Hook into client's internal message handling via server's message dispatcher
-  // This requires accessing internal properties, so we use type assertion
+  /** Attach hook-based message debugging (no monkey patch). */
   var clientImpl = client;
-  if (clientImpl.server && clientImpl.server.messageDispatcher) {
-    setupClientMessageDebugging(clientImpl);
-  }
+  setupClientMessageDebuggingViaHooks(clientImpl);
 }
 
 /**
- * Setup message-level debugging for client
+ * Setup message-level debugging for client (hook-based, no monkey patch).
  */
-function setupClientMessageDebugging(clientImpl) {
-  var _server$_registerPend, _server$messageDispat;
-  var server = clientImpl.server;
-
-  // Store original _registerPendingRequest
-  var originalRegister = (_server$_registerPend = server._registerPendingRequest) === null || _server$_registerPend === void 0 ? void 0 : _server$_registerPend.bind(server);
-  if (originalRegister) {
-    server._registerPendingRequest = function (requestId, resolve, reject, origin) {
-      // Wrap resolve to log incoming messages
-      var wrappedResolve = data => {
-        if (data.type === MessageType.ACK) {
-          log('info', Messages.DEBUG_CLIENT_RECEIVED_ACK, formatMessageData({
-            requestId: data.requestId,
-            path: data.path
-          }));
-        } else if (data.type === MessageType.ASYNC) {
-          log('info', Messages.DEBUG_CLIENT_RECEIVED_ASYNC, formatMessageData({
-            requestId: data.requestId,
-            path: data.path
-          }));
-        } else if (data.type === MessageType.STREAM_START) {
-          var streamBody = data.body;
-          log('info', Messages.DEBUG_CLIENT_RECEIVED_STREAM_START, formatMessageData({
-            requestId: data.requestId,
-            streamId: streamBody === null || streamBody === void 0 ? void 0 : streamBody.streamId,
-            streamType: streamBody === null || streamBody === void 0 ? void 0 : streamBody.type,
-            chunked: streamBody === null || streamBody === void 0 ? void 0 : streamBody.chunked,
-            autoResolve: streamBody === null || streamBody === void 0 ? void 0 : streamBody.autoResolve,
-            metadata: streamBody === null || streamBody === void 0 ? void 0 : streamBody.metadata
-          }));
-        } else if (data.type === MessageType.STREAM_DATA) {
-          var _streamBody$data;
-          var _streamBody = data.body;
-          log('info', Messages.DEBUG_CLIENT_RECEIVED_STREAM_DATA, formatMessageData({
-            requestId: data.requestId,
-            streamId: _streamBody === null || _streamBody === void 0 ? void 0 : _streamBody.streamId,
-            done: _streamBody === null || _streamBody === void 0 ? void 0 : _streamBody.done,
-            dataLength: (_streamBody === null || _streamBody === void 0 || (_streamBody$data = _streamBody.data) === null || _streamBody$data === void 0 ? void 0 : _streamBody$data.length) || 0
-          }));
-        } else if (data.type === MessageType.STREAM_END) {
-          var _streamBody2 = data.body;
-          log('info', Messages.DEBUG_CLIENT_RECEIVED_STREAM_END, formatMessageData({
-            requestId: data.requestId,
-            streamId: _streamBody2 === null || _streamBody2 === void 0 ? void 0 : _streamBody2.streamId
-          }));
-        } else if (data.type === MessageType.RESPONSE) {
-          log('info', Messages.DEBUG_CLIENT_RECEIVED_RESPONSE, formatMessageData({
-            requestId: data.requestId,
-            status: data.status,
-            statusText: data.statusText,
-            requireAck: data.requireAck
-          }));
-        } else if (data.type === MessageType.ERROR) {
-          log('error', Messages.DEBUG_CLIENT_RECEIVED_ERROR, formatMessageData({
-            requestId: data.requestId,
-            status: data.status,
-            statusText: data.statusText,
-            error: data.error
-          }));
-        }
-        resolve(data);
-      };
-
-      // Wrap reject to log timeouts
-      var wrappedReject = () => {
-        log('warn', Messages.DEBUG_CLIENT_REQUEST_TIMEOUT, {
-          requestId,
-          origin
-        });
-        reject();
-      };
-      return originalRegister(requestId, wrappedResolve, wrappedReject, origin);
-    };
-  }
+function setupClientMessageDebuggingViaHooks(clientImpl) {
+  var _clientImpl$hub, _clientImpl$getHub, _outbox$hooks, _dispatcher$hooks, _inbox$hooks, _dispatcher$hooks2;
+  var inbox = clientImpl.inbox;
+  var outbox = clientImpl.outbox;
+  var dispatcher = ((_clientImpl$hub = clientImpl.hub) === null || _clientImpl$hub === void 0 ? void 0 : _clientImpl$hub.messageDispatcher) || ((_clientImpl$getHub = clientImpl.getHub) === null || _clientImpl$getHub === void 0 || (_clientImpl$getHub = _clientImpl$getHub.call(clientImpl)) === null || _clientImpl$getHub === void 0 ? void 0 : _clientImpl$getHub.messageDispatcher);
 
-  // Log when messages are sent
-  var originalSendMessage = (_server$messageDispat = server.messageDispatcher) === null || _server$messageDispat === void 0 || (_server$messageDispat = _server$messageDispat.sendMessage) === null || _server$messageDispat === void 0 ? void 0 : _server$messageDispat.bind(server.messageDispatcher);
-  if (originalSendMessage) {
-    server.messageDispatcher.sendMessage = function (target, targetOrigin, type, requestId, data) {
+  /** Outbound */
+  if (outbox !== null && outbox !== void 0 && (_outbox$hooks = outbox.hooks) !== null && _outbox$hooks !== void 0 && (_outbox$hooks = _outbox$hooks.afterSendMessage) !== null && _outbox$hooks !== void 0 && _outbox$hooks.tap) {
+    outbox.hooks.afterSendMessage.tap('debug', (type, requestId, data) => {
       if (type === MessageType.REQUEST) {
-        log('info', Messages.DEBUG_CLIENT_SENDING_REQUEST, formatMessageData({
+        logEvent(LogLevel.INFO, DebugEvent.CLIENT_MESSAGE_OUTBOUND, Messages.DEBUG_CLIENT_SENDING_REQUEST, formatMessageData({
           requestId,
           path: data === null || data === void 0 ? void 0 : data.path,
           body: data === null || data === void 0 ? void 0 : data.body,
           headers: data === null || data === void 0 ? void 0 : data.headers
         }));
       } else if (type === MessageType.PING) {
-        log('info', Messages.DEBUG_CLIENT_SENDING_PING, {
+        logEvent(LogLevel.INFO, DebugEvent.CLIENT_MESSAGE_OUTBOUND, Messages.DEBUG_CLIENT_SENDING_PING, {
           requestId
         });
       } else if (type === MessageType.ACK) {
-        log('info', Messages.DEBUG_CLIENT_SENDING_RECEIVED_ACK, {
+        logEvent(LogLevel.INFO, DebugEvent.CLIENT_MESSAGE_OUTBOUND, Messages.DEBUG_CLIENT_SENDING_RECEIVED_ACK, {
           requestId
         });
       }
-      return originalSendMessage(target, targetOrigin, type, requestId, data);
-    };
+    });
+  } else if (dispatcher !== null && dispatcher !== void 0 && (_dispatcher$hooks = dispatcher.hooks) !== null && _dispatcher$hooks !== void 0 && (_dispatcher$hooks = _dispatcher$hooks.afterSend) !== null && _dispatcher$hooks !== void 0 && _dispatcher$hooks.tap) {
+    dispatcher.hooks.afterSend.tap('debug', (_target, _origin, message) => {
+      if (message.type === MessageType.REQUEST) {
+        logEvent(LogLevel.INFO, DebugEvent.CLIENT_MESSAGE_OUTBOUND, Messages.DEBUG_CLIENT_SENDING_REQUEST, formatMessageData({
+          requestId: message.requestId,
+          path: message.path,
+          body: message.body,
+          headers: message.headers
+        }));
+      }
+    });
+  }
+
+  /** Inbound */
+  if (inbox !== null && inbox !== void 0 && (_inbox$hooks = inbox.hooks) !== null && _inbox$hooks !== void 0 && (_inbox$hooks = _inbox$hooks.inbound) !== null && _inbox$hooks !== void 0 && _inbox$hooks.tap) {
+    inbox.hooks.inbound.tap('debug', data => {
+      if (data.type === MessageType.ACK) {
+        logEvent(LogLevel.INFO, DebugEvent.CLIENT_MESSAGE_INBOUND, Messages.DEBUG_CLIENT_RECEIVED_ACK, formatMessageData({
+          requestId: data.requestId,
+          path: data.path
+        }));
+      } else if (data.type === MessageType.ASYNC) {
+        logEvent(LogLevel.INFO, DebugEvent.CLIENT_MESSAGE_INBOUND, Messages.DEBUG_CLIENT_RECEIVED_ASYNC, formatMessageData({
+          requestId: data.requestId,
+          path: data.path
+        }));
+      } else if (data.type === MessageType.STREAM_START) {
+        var streamBody = data.body;
+        logEvent(LogLevel.INFO, DebugEvent.CLIENT_MESSAGE_INBOUND, Messages.DEBUG_CLIENT_RECEIVED_STREAM_START, formatMessageData({
+          requestId: data.requestId,
+          streamId: streamBody === null || streamBody === void 0 ? void 0 : streamBody.streamId,
+          streamType: streamBody === null || streamBody === void 0 ? void 0 : streamBody.type,
+          chunked: streamBody === null || streamBody === void 0 ? void 0 : streamBody.chunked,
+          autoResolve: streamBody === null || streamBody === void 0 ? void 0 : streamBody.autoResolve,
+          metadata: streamBody === null || streamBody === void 0 ? void 0 : streamBody.metadata
+        }));
+      } else if (data.type === MessageType.STREAM_DATA) {
+        var _streamBody$data;
+        var _streamBody = data.body;
+        logEvent(LogLevel.INFO, DebugEvent.CLIENT_MESSAGE_INBOUND, Messages.DEBUG_CLIENT_RECEIVED_STREAM_DATA, formatMessageData({
+          requestId: data.requestId,
+          streamId: _streamBody === null || _streamBody === void 0 ? void 0 : _streamBody.streamId,
+          done: _streamBody === null || _streamBody === void 0 ? void 0 : _streamBody.done,
+          dataLength: (_streamBody === null || _streamBody === void 0 || (_streamBody$data = _streamBody.data) === null || _streamBody$data === void 0 ? void 0 : _streamBody$data.length) || 0
+        }));
+      } else if (data.type === MessageType.STREAM_END) {
+        var _streamBody2 = data.body;
+        logEvent(LogLevel.INFO, DebugEvent.CLIENT_MESSAGE_INBOUND, Messages.DEBUG_CLIENT_RECEIVED_STREAM_END, formatMessageData({
+          requestId: data.requestId,
+          streamId: _streamBody2 === null || _streamBody2 === void 0 ? void 0 : _streamBody2.streamId
+        }));
+      } else if (data.type === MessageType.RESPONSE) {
+        logEvent(LogLevel.INFO, DebugEvent.CLIENT_MESSAGE_INBOUND, Messages.DEBUG_CLIENT_RECEIVED_RESPONSE, formatMessageData({
+          requestId: data.requestId,
+          status: data.status,
+          statusText: data.statusText,
+          requireAck: data.requireAck
+        }));
+      } else if (data.type === MessageType.ERROR) {
+        logEvent(LogLevel.ERROR, DebugEvent.CLIENT_MESSAGE_INBOUND, Messages.DEBUG_CLIENT_RECEIVED_ERROR, formatMessageData({
+          requestId: data.requestId,
+          status: data.status,
+          statusText: data.statusText,
+          error: data.error
+        }));
+      }
+    });
+  } else if (dispatcher !== null && dispatcher !== void 0 && (_dispatcher$hooks2 = dispatcher.hooks) !== null && _dispatcher$hooks2 !== void 0 && (_dispatcher$hooks2 = _dispatcher$hooks2.inbound) !== null && _dispatcher$hooks2 !== void 0 && _dispatcher$hooks2.tap) {
+    dispatcher.hooks.inbound.tap('debug', data => {
+      if (data.type === MessageType.ACK) {
+        logEvent(LogLevel.INFO, DebugEvent.CLIENT_MESSAGE_INBOUND, Messages.DEBUG_CLIENT_RECEIVED_ACK, formatMessageData({
+          requestId: data.requestId,
+          path: data.path
+        }));
+      }
+    });
   }
 }
 
@@ -237,6 +234,7 @@ function setupClientMessageDebugging(clientImpl) {
  * Use middleware to log requests and responses
  */
 export function setupServerDebugListeners(server) {
+  ensureRequestIframeLogLevel(LogLevel.INFO);
   var serverImpl = server;
   var startTimes = new Map();
 
@@ -245,7 +243,7 @@ export function setupServerDebugListeners(server) {
     var _res$sendStream;
     var startTime = Date.now();
     startTimes.set(req.requestId, startTime);
-    log('info', Messages.DEBUG_SERVER_RECEIVED_REQUEST, formatMessageData({
+    logEvent(LogLevel.INFO, DebugEvent.SERVER_REQUEST_RECEIVED, Messages.DEBUG_SERVER_RECEIVED_REQUEST, formatMessageData({
       requestId: req.requestId,
       path: req.path,
       body: req.body,
@@ -265,7 +263,7 @@ export function setupServerDebugListeners(server) {
 
     // Track status code changes
     res.status = function (code) {
-      log('info', Messages.DEBUG_SERVER_SETTING_STATUS_CODE, {
+      logEvent(LogLevel.INFO, DebugEvent.SERVER_RESPONSE_SEND, Messages.DEBUG_SERVER_SETTING_STATUS_CODE, {
         requestId: req.requestId,
         path: req.path,
         statusCode: code
@@ -275,7 +273,7 @@ export function setupServerDebugListeners(server) {
 
     // Track header changes
     res.setHeader = function (name, value) {
-      log('info', Messages.DEBUG_SERVER_SETTING_HEADER, {
+      logEvent(LogLevel.INFO, DebugEvent.SERVER_RESPONSE_SEND, Messages.DEBUG_SERVER_SETTING_HEADER, {
         requestId: req.requestId,
         path: req.path,
         header: name,
@@ -293,7 +291,7 @@ export function setupServerDebugListeners(server) {
             case 0:
               duration = Date.now() - (startTimes.get(req.requestId) || startTime);
               startTimes.delete(req.requestId);
-              log('info', Messages.DEBUG_SERVER_SENDING_RESPONSE, formatMessageData({
+              logEvent(LogLevel.INFO, DebugEvent.SERVER_RESPONSE_SEND, Messages.DEBUG_SERVER_SENDING_RESPONSE, formatMessageData({
                 requestId: req.requestId,
                 path: req.path,
                 status: res.statusCode,
@@ -324,7 +322,7 @@ export function setupServerDebugListeners(server) {
             case 0:
               duration = Date.now() - (startTimes.get(req.requestId) || startTime);
               startTimes.delete(req.requestId);
-              log('info', Messages.DEBUG_SERVER_SENDING_JSON_RESPONSE, formatMessageData({
+              logEvent(LogLevel.INFO, DebugEvent.SERVER_RESPONSE_SEND, Messages.DEBUG_SERVER_SENDING_JSON_RESPONSE, formatMessageData({
                 requestId: req.requestId,
                 path: req.path,
                 status: res.statusCode,
@@ -355,7 +353,7 @@ export function setupServerDebugListeners(server) {
             case 0:
               duration = Date.now() - (startTimes.get(req.requestId) || startTime);
               startTimes.delete(req.requestId);
-              log('info', Messages.DEBUG_SERVER_SENDING_FILE, formatMessageData({
+              logEvent(LogLevel.INFO, DebugEvent.SERVER_RESPONSE_SEND, Messages.DEBUG_SERVER_SENDING_FILE, formatMessageData({
                 requestId: req.requestId,
                 path: req.path,
                 status: res.statusCode,
@@ -387,7 +385,7 @@ export function setupServerDebugListeners(server) {
               case 0:
                 duration = Date.now() - (startTimes.get(req.requestId) || startTime);
                 startTimes.delete(req.requestId);
-                log('info', Messages.DEBUG_SERVER_SENDING_STREAM, formatMessageData({
+                logEvent(LogLevel.INFO, DebugEvent.SERVER_RESPONSE_SEND, Messages.DEBUG_SERVER_SENDING_STREAM, formatMessageData({
                   requestId: req.requestId,
                   path: req.path,
                   status: res.statusCode,
@@ -410,36 +408,37 @@ export function setupServerDebugListeners(server) {
     next();
   });
 
-  // Hook into server's message dispatcher for more detailed logging
-  if (serverImpl.messageDispatcher) {
-    setupServerMessageDebugging(serverImpl);
-  }
+  /** Hook into MessageDispatcher hooks (no monkey patch). */
+  setupServerMessageDebuggingViaHooks(serverImpl);
 }
 
 /**
- * Setup message-level debugging for server
+ * Setup message-level debugging for server (hook-based, no monkey patch).
  */
-function setupServerMessageDebugging(serverImpl) {
-  var _dispatcher$sendMessa, _serverImpl$handleReq, _serverImpl$runMiddle;
-  var dispatcher = serverImpl.messageDispatcher;
+function setupServerMessageDebuggingViaHooks(serverImpl) {
+  var _dispatcher$hooks$aft, _dispatcher$hooks$inb;
+  var dispatcher = serverImpl.messageDispatcher || serverImpl.dispatcher;
+  if (!(dispatcher !== null && dispatcher !== void 0 && dispatcher.hooks)) return;
 
-  // Log when messages are sent
-  var originalSendMessage = (_dispatcher$sendMessa = dispatcher.sendMessage) === null || _dispatcher$sendMessa === void 0 ? void 0 : _dispatcher$sendMessa.bind(dispatcher);
-  if (originalSendMessage) {
-    dispatcher.sendMessage = function (target, targetOrigin, type, requestId, data) {
+  /** Outbound messages */
+  if ((_dispatcher$hooks$aft = dispatcher.hooks.afterSend) !== null && _dispatcher$hooks$aft !== void 0 && _dispatcher$hooks$aft.tap) {
+    dispatcher.hooks.afterSend.tap('debug', (_target, _targetOrigin, message) => {
+      var type = message.type;
+      var requestId = message.requestId;
+      var data = message;
       if (type === MessageType.ACK) {
-        log('info', Messages.DEBUG_SERVER_SENDING_ACK, formatMessageData({
+        logEvent(LogLevel.INFO, DebugEvent.SERVER_MESSAGE_OUTBOUND, Messages.DEBUG_SERVER_SENDING_ACK, formatMessageData({
           requestId,
-          path: data === null || data === void 0 ? void 0 : data.path
+          path: data.path
         }));
       } else if (type === MessageType.ASYNC) {
-        log('info', Messages.DEBUG_SERVER_SENDING_ASYNC, formatMessageData({
+        logEvent(LogLevel.INFO, DebugEvent.SERVER_MESSAGE_OUTBOUND, Messages.DEBUG_SERVER_SENDING_ASYNC, formatMessageData({
           requestId,
-          path: data === null || data === void 0 ? void 0 : data.path
+          path: data.path
         }));
       } else if (type === MessageType.STREAM_START) {
         var streamBody = (data === null || data === void 0 ? void 0 : data.body) || {};
-        log('info', Messages.DEBUG_SERVER_SENDING_STREAM_START, formatMessageData({
+        logEvent(LogLevel.INFO, DebugEvent.SERVER_MESSAGE_OUTBOUND, Messages.DEBUG_SERVER_SENDING_STREAM_START, formatMessageData({
           requestId,
           streamId: streamBody.streamId,
           streamType: streamBody.type,
@@ -450,7 +449,7 @@ function setupServerMessageDebugging(serverImpl) {
       } else if (type === MessageType.STREAM_DATA) {
         var _streamBody3$data;
         var _streamBody3 = (data === null || data === void 0 ? void 0 : data.body) || {};
-        log('info', Messages.DEBUG_SERVER_SENDING_STREAM_DATA, formatMessageData({
+        logEvent(LogLevel.INFO, DebugEvent.SERVER_MESSAGE_OUTBOUND, Messages.DEBUG_SERVER_SENDING_STREAM_DATA, formatMessageData({
           requestId,
           streamId: _streamBody3.streamId,
           done: _streamBody3.done,
@@ -458,12 +457,12 @@ function setupServerMessageDebugging(serverImpl) {
         }));
       } else if (type === MessageType.STREAM_END) {
         var _streamBody4 = (data === null || data === void 0 ? void 0 : data.body) || {};
-        log('info', Messages.DEBUG_SERVER_SENDING_STREAM_END, formatMessageData({
+        logEvent(LogLevel.INFO, DebugEvent.SERVER_MESSAGE_OUTBOUND, Messages.DEBUG_SERVER_SENDING_STREAM_END, formatMessageData({
           requestId,
           streamId: _streamBody4.streamId
         }));
       } else if (type === MessageType.ERROR) {
-        log('error', Messages.DEBUG_SERVER_SENDING_ERROR, formatMessageData({
+        logEvent(LogLevel.ERROR, DebugEvent.SERVER_MESSAGE_OUTBOUND, Messages.DEBUG_SERVER_SENDING_ERROR, formatMessageData({
           requestId,
           status: data === null || data === void 0 ? void 0 : data.status,
           statusText: data === null || data === void 0 ? void 0 : data.statusText,
@@ -471,7 +470,7 @@ function setupServerMessageDebugging(serverImpl) {
           path: data === null || data === void 0 ? void 0 : data.path
         }));
       } else if (type === MessageType.RESPONSE) {
-        log('info', Messages.DEBUG_SERVER_SENDING_RESPONSE_VIA_DISPATCHER, formatMessageData({
+        logEvent(LogLevel.INFO, DebugEvent.SERVER_MESSAGE_OUTBOUND, Messages.DEBUG_SERVER_SENDING_RESPONSE_VIA_DISPATCHER, formatMessageData({
           requestId,
           status: data === null || data === void 0 ? void 0 : data.status,
           statusText: data === null || data === void 0 ? void 0 : data.statusText,
@@ -479,43 +478,21 @@ function setupServerMessageDebugging(serverImpl) {
           path: data === null || data === void 0 ? void 0 : data.path
         }));
       }
-      return originalSendMessage(target, targetOrigin, type, requestId, data);
-    };
+    });
   }
 
-  // Log when requests are received (before handler)
-  var originalHandleRequest = (_serverImpl$handleReq = serverImpl.handleRequest) === null || _serverImpl$handleReq === void 0 ? void 0 : _serverImpl$handleReq.bind(serverImpl);
-  if (originalHandleRequest) {
-    serverImpl.handleRequest = function (data, context) {
-      log('info', Messages.DEBUG_SERVER_HANDLING_REQUEST, formatMessageData({
-        requestId: data.requestId,
-        path: data.path,
-        origin: context === null || context === void 0 ? void 0 : context.origin,
-        role: data.role,
-        creatorId: data.creatorId
-      }));
-      return originalHandleRequest(data, context);
-    };
-  }
-
-  // Log handler execution
-  var originalRunMiddlewares = (_serverImpl$runMiddle = serverImpl.runMiddlewares) === null || _serverImpl$runMiddle === void 0 ? void 0 : _serverImpl$runMiddle.bind(serverImpl);
-  if (originalRunMiddlewares) {
-    serverImpl.runMiddlewares = function (req, res, callback) {
-      var handlerStartTime = Date.now();
-      log('info', Messages.DEBUG_SERVER_EXECUTING_MIDDLEWARE_CHAIN, {
-        requestId: req.requestId,
-        path: req.path
-      });
-      return originalRunMiddlewares(req, res, () => {
-        var handlerDuration = Date.now() - handlerStartTime;
-        log('info', Messages.DEBUG_SERVER_MIDDLEWARE_CHAIN_COMPLETED, {
-          requestId: req.requestId,
-          path: req.path,
-          duration: `${handlerDuration}ms`
-        });
-        callback();
-      });
-    };
+  /** Inbound messages */
+  if ((_dispatcher$hooks$inb = dispatcher.hooks.inbound) !== null && _dispatcher$hooks$inb !== void 0 && _dispatcher$hooks$inb.tap) {
+    dispatcher.hooks.inbound.tap('debug', (data, context) => {
+      if (data.type === MessageType.REQUEST) {
+        logEvent(LogLevel.INFO, DebugEvent.SERVER_MESSAGE_INBOUND, Messages.DEBUG_SERVER_HANDLING_REQUEST, formatMessageData({
+          requestId: data.requestId,
+          path: data.path,
+          origin: context === null || context === void 0 ? void 0 : context.origin,
+          role: data.role,
+          creatorId: data.creatorId
+        }));
+      }
+    });
   }
 }

package/esm/utils/hooks.js

@@ -0,0 +1,130 @@
+import _asyncToGenerator from "@babel/runtime/helpers/esm/asyncToGenerator";
+import _defineProperty from "@babel/runtime/helpers/esm/defineProperty";
+import _regeneratorRuntime from "@babel/runtime/regenerator";
+function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t.return || t.return(); } finally { if (u) throw o; } } }; }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+import "core-js/modules/es.symbol.description.js";
+import "core-js/modules/es.array.from.js";
+import "core-js/modules/es.array.index-of.js";
+import "core-js/modules/es.array.iterator.js";
+import "core-js/modules/es.array.slice.js";
+import "core-js/modules/es.array.splice.js";
+import "core-js/modules/es.regexp.exec.js";
+import "core-js/modules/es.regexp.to-string.js";
+import "core-js/modules/web.dom-collections.iterator.js";
+/**
+ * A tiny "Tapable-like" hook implementation.
+ *
+ * Design goals:
+ * - Zero dependencies
+ * - Browser-friendly
+ * - Familiar API surface (tap/call, tapPromise/promise)
+ */
+
+/**
+ * SyncHook - runs taps synchronously in registration order.
+ */
+export class SyncHook {
+  constructor() {
+    _defineProperty(this, "taps", []);
+  }
+  tap(name, fn) {
+    var tap = {
+      name,
+      fn
+    };
+    this.taps.push(tap);
+    return () => {
+      var idx = this.taps.indexOf(tap);
+      if (idx >= 0) this.taps.splice(idx, 1);
+    };
+  }
+  call(...args) {
+    var _iterator = _createForOfIteratorHelper(this.taps),
+      _step;
+    try {
+      for (_iterator.s(); !(_step = _iterator.n()).done;) {
+        var t = _step.value;
+        t.fn(...args);
+      }
+    } catch (err) {
+      _iterator.e(err);
+    } finally {
+      _iterator.f();
+    }
+  }
+}
+
+/**
+ * AsyncSeriesHook - runs taps in series, awaiting each.
+ */
+export class AsyncSeriesHook {
+  constructor() {
+    _defineProperty(this, "taps", []);
+  }
+  tapPromise(name, fn) {
+    var tap = {
+      name,
+      fn
+    };
+    this.taps.push(tap);
+    return () => {
+      var idx = this.taps.indexOf(tap);
+      if (idx >= 0) this.taps.splice(idx, 1);
+    };
+  }
+  tap(name, fn) {
+    return this.tapPromise(name, /*#__PURE__*/_asyncToGenerator(/*#__PURE__*/_regeneratorRuntime.mark(function _callee(...args) {
+      return _regeneratorRuntime.wrap(function (_context) {
+        while (1) switch (_context.prev = _context.next) {
+          case 0:
+            _context.next = 1;
+            return fn(...args);
+          case 1:
+          case "end":
+            return _context.stop();
+        }
+      }, _callee);
+    })));
+  }
+  promise(...args) {
+    var _this = this;
+    return _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime.mark(function _callee2() {
+      var _iterator2, _step2, t, _t;
+      return _regeneratorRuntime.wrap(function (_context2) {
+        while (1) switch (_context2.prev = _context2.next) {
+          case 0:
+            _iterator2 = _createForOfIteratorHelper(_this.taps);
+            _context2.prev = 1;
+            _iterator2.s();
+          case 2:
+            if ((_step2 = _iterator2.n()).done) {
+              _context2.next = 4;
+              break;
+            }
+            t = _step2.value;
+            _context2.next = 3;
+            return t.fn(...args);
+          case 3:
+            _context2.next = 2;
+            break;
+          case 4:
+            _context2.next = 6;
+            break;
+          case 5:
+            _context2.prev = 5;
+            _t = _context2["catch"](1);
+            _iterator2.e(_t);
+          case 6:
+            _context2.prev = 6;
+            _iterator2.f();
+            return _context2.finish(6);
+          case 7:
+          case "end":
+            return _context2.stop();
+        }
+      }, _callee2, null, [[1, 5, 6, 7]]);
+    }))();
+  }
+}

package/esm/utils/id.js

@@ -0,0 +1,14 @@
+import "core-js/modules/es.regexp.to-string.js";
+/**
+ * Generate unique request ID
+ */
+export function generateRequestId() {
+  return `req_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`;
+}
+
+/**
+ * Generate unique instance ID
+ */
+export function generateInstanceId() {
+  return `inst_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`;
+}