@dynamic-labs/message-transport 4.20.12 → 4.20.14

package/CHANGELOG.md

@@ -1,4 +1,24 @@
 
+### [4.20.14](https://github.com/dynamic-labs/dynamic-auth/compare/v4.20.13...v4.20.14) (2025-07-03)
+
+
+### Bug Fixes
+
+* refresh function user state for sessionId ([#9073](https://github.com/dynamic-labs/dynamic-auth/issues/9073)) ([080e923](https://github.com/dynamic-labs/dynamic-auth/commit/080e92356e3920f1d240b5025db9c831aa2abc5a))
+* remove default commonjs setups for @dynamic-labs-wallet/browser-wallet-client ([#9079](https://github.com/dynamic-labs/dynamic-auth/issues/9079)) ([27507ab](https://github.com/dynamic-labs/dynamic-auth/commit/27507abedfd223209cad15d5c1e12b37fa421071))
+
+### [4.20.13](https://github.com/dynamic-labs/dynamic-auth/compare/v4.20.12...v4.20.13) (2025-07-02)
+
+
+### Features
+
+* add createWalletClient method to ZeroDevExtension ([#9036](https://github.com/dynamic-labs/dynamic-auth/issues/9036)) ([674df45](https://github.com/dynamic-labs/dynamic-auth/commit/674df45f21e76070594963c2e3b7c19ba94e3004))
+
+
+### Bug Fixes
+
+* allow to retry metamask deeplink ([#9066](https://github.com/dynamic-labs/dynamic-auth/issues/9066)) ([308c0d2](https://github.com/dynamic-labs/dynamic-auth/commit/308c0d2ddd7a5c7460f31d25365687b315b0a0f4))
+
 ### [4.20.12](https://github.com/dynamic-labs/dynamic-auth/compare/v4.20.11...v4.20.12) (2025-07-01)
 
 

package/package.cjs

@@ -3,6 +3,6 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var version = "4.20.12";
+var version = "4.20.14";
 
 exports.version = version;

package/package.js

@@ -1,4 +1,4 @@
 'use client'
-var version = "4.20.12";
+var version = "4.20.14";
 
 export { version };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamic-labs/message-transport",
-  "version": "4.20.12",
+  "version": "4.20.14",
   "description": "Defines the interface to communicate with dynamic's webview",
   "author": "Dynamic Labs, Inc.",
   "license": "MIT",
@@ -18,14 +18,14 @@
   },
   "homepage": "https://www.dynamic.xyz/",
   "dependencies": {
-    "@dynamic-labs/sdk-api-core": "0.0.699",
+    "@dynamic-labs/sdk-api-core": "0.0.704",
     "@vue/reactivity": "^3.4.21",
-    "@dynamic-labs/types": "4.20.12",
+    "@dynamic-labs/types": "4.20.14",
     "eventemitter3": "5.0.1",
-    "@dynamic-labs/assert-package-version": "4.20.12",
-    "@dynamic-labs/logger": "4.20.12",
-    "@dynamic-labs/utils": "4.20.12",
-    "@dynamic-labs/webauthn": "4.20.12"
+    "@dynamic-labs/assert-package-version": "4.20.14",
+    "@dynamic-labs/logger": "4.20.14",
+    "@dynamic-labs/utils": "4.20.14",
+    "@dynamic-labs/webauthn": "4.20.14"
   },
   "peerDependencies": {}
 }

package/src/debug/debug.cjs

@@ -0,0 +1,17 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * Global debug flag that can be set to true to enable debug mode
+ * for all resources that use the message transport.
+ */
+let globalDebugEnabled = false;
+const setGlobalDebugEnabled = (debug) => {
+    globalDebugEnabled = debug;
+};
+const isGlobalDebugEnabled = () => globalDebugEnabled;
+
+exports.isGlobalDebugEnabled = isGlobalDebugEnabled;
+exports.setGlobalDebugEnabled = setGlobalDebugEnabled;

package/src/debug/debug.d.ts

@@ -0,0 +1,2 @@
+export declare const setGlobalDebugEnabled: (debug: boolean) => void;
+export declare const isGlobalDebugEnabled: () => boolean;

package/src/debug/debug.js

@@ -0,0 +1,12 @@
+'use client'
+/**
+ * Global debug flag that can be set to true to enable debug mode
+ * for all resources that use the message transport.
+ */
+let globalDebugEnabled = false;
+const setGlobalDebugEnabled = (debug) => {
+    globalDebugEnabled = debug;
+};
+const isGlobalDebugEnabled = () => globalDebugEnabled;
+
+export { isGlobalDebugEnabled, setGlobalDebugEnabled };

package/src/debug/index.d.ts

@@ -0,0 +1 @@
+export * from './debug';

package/src/index.cjs

@@ -7,9 +7,10 @@ var assertPackageVersion = require('@dynamic-labs/assert-package-version');
 var _package = require('../package.cjs');
 var messageTransport = require('./messageTransport/messageTransport.cjs');
 var applyDefaultMessageOrigin = require('./messageTransport/decorators/applyDefaultMessageOrigin/applyDefaultMessageOrigin.cjs');
+var applyRecoveryManager = require('./messageTransport/decorators/applyRecoveryManager/applyRecoveryManager.cjs');
+var applyTransportStamps = require('./messageTransport/decorators/applyTransportStamps/applyTransportStamps.cjs');
 var makeWaitForInitEvent = require('./messageTransport/decorators/makeWaitForInitEvent/makeWaitForInitEvent.cjs');
 var makeWaitForUnblock = require('./messageTransport/decorators/makeWaitForUnblock/makeWaitForUnblock.cjs');
-var applyRecoveryManager = require('./messageTransport/decorators/applyRecoveryManager/applyRecoveryManager.cjs');
 var requestChannel = require('./requestChannel/requestChannel.cjs');
 var utils = require('./requestChannel/utils/utils.cjs');
 var isSerializedError = require('./utils/isSerializedError/isSerializedError.cjs');
@@ -25,15 +26,17 @@ var OtpMessages = require('./messageTypes/OtpMessages.cjs');
 var SdkModuleMessages = require('./messageTypes/SdkModuleMessages.cjs');
 var UserInterfaceModuleMessages = require('./messageTypes/UserInterfaceModuleMessages.cjs');
 var WalletsModuleMessages = require('./messageTypes/WalletsModuleMessages.cjs');
+var debug = require('./debug/debug.cjs');
 
 assertPackageVersion.assertPackageVersion('@dynamic-labs/message-transport', _package.version);
 
 exports.createMessageTransport = messageTransport.createMessageTransport;
 exports.applyDefaultMessageOrigin = applyDefaultMessageOrigin.applyDefaultMessageOrigin;
-exports.makeWaitForInitEvent = makeWaitForInitEvent.makeWaitForInitEvent;
-exports.makeWaitForUnblock = makeWaitForUnblock.makeWaitForUnblock;
 exports.applyRecoveryManager = applyRecoveryManager.applyRecoveryManager;
 exports.hasRecoveryManager = applyRecoveryManager.hasRecoveryManager;
+exports.applyTransportStamps = applyTransportStamps.applyTransportStamps;
+exports.makeWaitForInitEvent = makeWaitForInitEvent.makeWaitForInitEvent;
+exports.makeWaitForUnblock = makeWaitForUnblock.makeWaitForUnblock;
 exports.createRequestChannel = requestChannel.createRequestChannel;
 exports.getAckMessageType = utils.getAckMessageType;
 exports.getRejectMessageType = utils.getRejectMessageType;
@@ -56,3 +59,5 @@ exports.smsEventNames = OtpMessages.smsEventNames;
 exports.sdkHasLoadedEventName = SdkModuleMessages.sdkHasLoadedEventName;
 exports.userInterfaceEventNames = UserInterfaceModuleMessages.userInterfaceEventNames;
 exports.userWalletsEventNames = WalletsModuleMessages.userWalletsEventNames;
+exports.isGlobalDebugEnabled = debug.isGlobalDebugEnabled;
+exports.setGlobalDebugEnabled = debug.setGlobalDebugEnabled;

package/src/index.d.ts

@@ -1,4 +1,4 @@
-export { applyDefaultMessageOrigin, applyRecoveryManager, createMessageTransport, hasRecoveryManager, makeWaitForInitEvent, makeWaitForUnblock, type BypassBlockCallback, type MessageTransport, type MessageTransportCallback, type MessageTransportData, type MessageTransportDataOptionalOrigin, type MessageTransportWithDefaultOrigin, } from './messageTransport';
+export { applyDefaultMessageOrigin, applyRecoveryManager, applyTransportStamps, createMessageTransport, hasRecoveryManager, makeWaitForInitEvent, makeWaitForUnblock, type BypassBlockCallback, type MessageTransport, type MessageTransportCallback, type MessageTransportData, type MessageTransportDataOptionalOrigin, type MessageTransportWithDefaultOrigin, } from './messageTransport';
 export { createRequestChannel, getAckMessageType, getRejectMessageType, getResolveMessageType, isAckMessageType, isRejectMessageType, isRequestMessageType, isResolveMessageType, type RequestChannel, type RequestTypes, type TypesExpectingResponse, } from './requestChannel';
 export { isSerializedError } from './utils/isSerializedError';
 export { parseErrorFromTransport } from './utils/parseErrorFromTransport';
@@ -7,4 +7,5 @@ export { serializeErrorForTransport, type SerializedError, } from './utils/seria
 export { createEventEmitterForMessages, createStore, createStoreSetter, type CreateStoreProps, } from './store';
 export type { Store, StoreEventListeners, StoreKeys, StoreSetter, StoreStateChangeEvent, StoreStateEvents, StoreStateGetters, } from './store/types';
 export type { PickedEventListeners } from './types';
-export { authEventNames, emailEventNames, embeddedWalletsEventNames, sdkHasLoadedEventName, smsEventNames, userInterfaceEventNames, userWalletsEventNames, type AccountAbstractionGetEOAWalletArgs, type AccountAbstractionGetSmartWalletArgs, type AccountAbstractionIsSmartWalletArgs, type AccountAbstractionMessages, type AuthModuleMessages, type AuthModuleState, type ClientManifest, type ConsoleMessages, type CreateEmbeddedWalletArgs, type DeleteStorageItemArgs, type EmailOtpParams, type EmbeddedWalletsModuleMessages, type EmbeddedWalletsModuleState, type EthMessages, type EthRequestParams, type EthRequestWithAddressParams, type EthRequestWithChainIdParams, type ExternalAuthMessages, type FetchMessages, type GetStorageItemArgs, type NetworksModuleState, type OtpData, type OtpMessages, type PasskeyMessages, type PlatformServiceMessages, type ProjectSettingsMessages, type SdkModuleMessages, type SdkModuleState, type SetStorageItemArgs, type SignInWithExternalJwtParams, type SmsOtpParams, type SocialAuthModuleMessages, type MfaMessages, type SocialProvider, type SolanaMessages, type StorageMessages, type StorageMessageSource, type TurnkeyIframeEventProxyMessages, type UserInterfaceModuleMessages, type VerifyWithExternalJwtParams, type ViemMessages, type WaasMessages, type WalletEvents, type WalletsModuleMessages, type WalletsModuleState, type WebViewVisibilityMessages, type ZeroDevExtensionMessages, } from './messageTypes';
+export { authEventNames, emailEventNames, embeddedWalletsEventNames, sdkHasLoadedEventName, smsEventNames, userInterfaceEventNames, userWalletsEventNames, type AccountAbstractionGetEOAWalletArgs, type AccountAbstractionGetSmartWalletArgs, type AccountAbstractionIsSmartWalletArgs, type AccountAbstractionMessages, type AuthModuleMessages, type AuthModuleState, type ClientManifest, type ConsoleMessages, type CreateEmbeddedWalletArgs, type DeleteStorageItemArgs, type EmailOtpParams, type EmbeddedWalletsModuleMessages, type EmbeddedWalletsModuleState, type EthMessages, type EthRequestParams, type EthRequestWithAddressParams, type EthRequestWithChainIdParams, type ExternalAuthMessages, type FetchMessages, type GetStorageItemArgs, type MfaMessages, type NetworksModuleState, type OtpData, type OtpMessages, type PasskeyMessages, type PlatformServiceMessages, type ProjectSettingsMessages, type SdkModuleMessages, type SdkModuleState, type SetStorageItemArgs, type SignInWithExternalJwtParams, type SmsOtpParams, type SocialAuthModuleMessages, type SocialProvider, type SolanaMessages, type StorageMessages, type StorageMessageSource, type TurnkeyIframeEventProxyMessages, type UserInterfaceModuleMessages, type VerifyWithExternalJwtParams, type ViemMessages, type WaasMessages, type WalletEvents, type WalletsModuleMessages, type WalletsModuleState, type WebViewVisibilityMessages, type ZeroDevExtensionMessages, } from './messageTypes';
+export { isGlobalDebugEnabled, setGlobalDebugEnabled } from './debug';

package/src/index.js

@@ -3,9 +3,10 @@ import { assertPackageVersion } from '@dynamic-labs/assert-package-version';
 import { version } from '../package.js';
 export { createMessageTransport } from './messageTransport/messageTransport.js';
 export { applyDefaultMessageOrigin } from './messageTransport/decorators/applyDefaultMessageOrigin/applyDefaultMessageOrigin.js';
+export { applyRecoveryManager, hasRecoveryManager } from './messageTransport/decorators/applyRecoveryManager/applyRecoveryManager.js';
+export { applyTransportStamps } from './messageTransport/decorators/applyTransportStamps/applyTransportStamps.js';
 export { makeWaitForInitEvent } from './messageTransport/decorators/makeWaitForInitEvent/makeWaitForInitEvent.js';
 export { makeWaitForUnblock } from './messageTransport/decorators/makeWaitForUnblock/makeWaitForUnblock.js';
-export { applyRecoveryManager, hasRecoveryManager } from './messageTransport/decorators/applyRecoveryManager/applyRecoveryManager.js';
 export { createRequestChannel } from './requestChannel/requestChannel.js';
 export { getAckMessageType, getRejectMessageType, getResolveMessageType, isAckMessageType, isRejectMessageType, isRequestMessageType, isResolveMessageType } from './requestChannel/utils/utils.js';
 export { isSerializedError } from './utils/isSerializedError/isSerializedError.js';
@@ -21,5 +22,6 @@ export { emailEventNames, smsEventNames } from './messageTypes/OtpMessages.js';
 export { sdkHasLoadedEventName } from './messageTypes/SdkModuleMessages.js';
 export { userInterfaceEventNames } from './messageTypes/UserInterfaceModuleMessages.js';
 export { userWalletsEventNames } from './messageTypes/WalletsModuleMessages.js';
+export { isGlobalDebugEnabled, setGlobalDebugEnabled } from './debug/debug.js';
 
 assertPackageVersion('@dynamic-labs/message-transport', version);

package/src/messageTransport/decorators/applyTransportStamps/applyTransportStamps.cjs

@@ -0,0 +1,25 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * Applies transport stamps to a message transport
+ * as a trail of where the message has been
+ */
+const applyTransportStamps = (messageTransport) => {
+    const id = Math.random().toString(36).slice(2);
+    return Object.assign(Object.assign({}, messageTransport), { emit: (message) => {
+            var _a;
+            const transportStamps = [
+                ...((_a = message.transportStamps) !== null && _a !== void 0 ? _a : []),
+                {
+                    emittedAt: new Date().toISOString(),
+                    messageTransportId: id,
+                },
+            ];
+            messageTransport.emit(Object.assign(Object.assign({}, message), { transportStamps }));
+        } });
+};
+
+exports.applyTransportStamps = applyTransportStamps;

package/src/messageTransport/decorators/applyTransportStamps/applyTransportStamps.d.ts

@@ -0,0 +1,6 @@
+import { MessageTransport } from '../../messageTransport';
+/**
+ * Applies transport stamps to a message transport
+ * as a trail of where the message has been
+ */
+export declare const applyTransportStamps: <T extends MessageTransport>(messageTransport: T) => T;

package/src/messageTransport/decorators/applyTransportStamps/applyTransportStamps.js

@@ -0,0 +1,21 @@
+'use client'
+/**
+ * Applies transport stamps to a message transport
+ * as a trail of where the message has been
+ */
+const applyTransportStamps = (messageTransport) => {
+    const id = Math.random().toString(36).slice(2);
+    return Object.assign(Object.assign({}, messageTransport), { emit: (message) => {
+            var _a;
+            const transportStamps = [
+                ...((_a = message.transportStamps) !== null && _a !== void 0 ? _a : []),
+                {
+                    emittedAt: new Date().toISOString(),
+                    messageTransportId: id,
+                },
+            ];
+            messageTransport.emit(Object.assign(Object.assign({}, message), { transportStamps }));
+        } });
+};
+
+export { applyTransportStamps };

package/src/messageTransport/decorators/applyTransportStamps/index.d.ts

@@ -0,0 +1 @@
+export { applyTransportStamps } from './applyTransportStamps';

package/src/messageTransport/decorators/index.d.ts

@@ -1,4 +1,5 @@
 export * from './applyDefaultMessageOrigin';
+export { applyRecoveryManager, hasRecoveryManager, } from './applyRecoveryManager';
+export * from './applyTransportStamps';
 export * from './makeWaitForInitEvent';
 export * from './makeWaitForUnblock';
-export { applyRecoveryManager, hasRecoveryManager, } from './applyRecoveryManager';

package/src/messageTransport/messageTransport.d.ts

@@ -1,5 +1,18 @@
 /** Defines the structure of messages that can be sent to and from webviews */
 export type MessageTransportData = {
+    /**
+     * A list of stamps that represent the history of the message
+     */
+    transportStamps?: {
+        /**
+         * The id of the message transport that emitted this message
+         */
+        messageTransportId: string;
+        /**
+         * The date and time when the message was emitted
+         */
+        emittedAt: string;
+    }[];
     /**
      * Defines which kind of message this is.
      *
@@ -25,6 +38,12 @@ export type MessageTransportData = {
     messageSessionId: string;
     /** Identifies which end emitted this message */
     origin: 'webview' | 'host';
+    /**
+     * Whether this message is expected to NOT receive an ack reply.
+     *
+     * If this is true, the other end should NOT emit an ack message.
+     */
+    doNotAck?: boolean;
 };
 export type MessageTransportCallback = (data: MessageTransportData) => void;
 /**

package/src/messageTypes/SdkModuleMessages.d.ts

@@ -1,3 +1,4 @@
+import { LogLevel } from '@dynamic-labs/logger';
 /**
  * Defines the settings required by the SDK to be properly initialized
  * inside the webview
@@ -12,7 +13,11 @@ export type ClientManifest = {
     environmentId: string;
     platform: 'browser' | 'react-native' | 'flutter' | 'swift';
     redirectUrl: string;
-    debugWebview?: boolean;
+    debug?: {
+        webview?: boolean;
+        messageTransport?: boolean;
+        loggerLevel?: LogLevel;
+    };
 };
 export type SdkModuleState = {
     /** Indicates the SDK is set up and ready for requests */

package/src/requestChannel/createRequestChannelMessageSender/createRequestChannelMessageSender.cjs

@@ -3,11 +3,12 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
+var debug = require('../../debug/debug.cjs');
 var applyRecoveryManager = require('../../messageTransport/decorators/applyRecoveryManager/applyRecoveryManager.cjs');
 var logger = require('../../utils/logger.cjs');
 var utils = require('../utils/utils.cjs');
 
-const createRequestChannelMessageSender = ({ requestType, messageSessionId, timeoutMap, onReceiveAck, messageTransport, onTimeout, params, }) => {
+const createRequestChannelMessageSender = ({ requestType, messageSessionId, timeoutMap, onReceiveAck, messageTransport, onTimeout, params, debugOverride, disableAckForOutgoingMessage = false, }) => {
     /**
      * Tracks whether this sender's message has timed out.
      * This way we can identify that it was a false negative if the message
@@ -15,30 +16,54 @@ const createRequestChannelMessageSender = ({ requestType, messageSessionId, time
      */
     let messageTimedOut = false;
     const ackMessageType = utils.getAckMessageType(requestType);
-    const message = {
+    const isDebugEnabled = () => debugOverride !== null && debugOverride !== void 0 ? debugOverride : debug.isGlobalDebugEnabled();
+    const outgoingMessage = {
         args: params,
+        doNotAck: disableAckForOutgoingMessage,
         messageSessionId,
         type: requestType,
     };
+    const getTimestamp = () => new Date().toISOString();
     // We must listen for acks
-    const handleAckMessage = ({ messageSessionId: incomingSessionId, type: incomingType, }) => {
+    const handleAckMessage = ({ messageSessionId: incomingSessionId, type: incomingType, doNotAck: incomingDoNotAck, }) => {
+        // DO NOT ignore ack messages when disableAckForOutgoingMessage is true.
+        // disableAckForOutgoingMessage means OUTGOING messages will not receive an ack.
+        // This is different than the INCOMING message's doNotAck, which is what we care about here
         if (incomingSessionId !== messageSessionId ||
-            incomingType !== ackMessageType)
+            incomingType !== ackMessageType ||
+            incomingDoNotAck) {
             return;
+        }
+        if (isDebugEnabled()) {
+            logger.logger.debug(`[messageSender ${requestType} ${getTimestamp()}] — received ack message (messageSessionId: ${messageSessionId}). Message timeout ID: ${timeoutMap[messageSessionId]}. Content of timeoutMap: ${JSON.stringify(timeoutMap)}`);
+        }
         clearTimeout(timeoutMap[messageSessionId]);
         delete timeoutMap[messageSessionId];
         onReceiveAck === null || onReceiveAck === void 0 ? void 0 : onReceiveAck();
         if (messageTimedOut) {
+            if (isDebugEnabled()) {
+                logger.logger.debug(`[messageSender ${requestType} ${getTimestamp()}] — identified a false negative for message time out. Message: ${requestType} with session id ${messageSessionId}`);
+            }
             logger.logger.instrument(`Identified a false negative for message time out. Message: ${requestType} with session id ${messageSessionId}. Params: ${JSON.stringify(params)}`);
         }
     };
     const sendMessage = () => {
+        if (disableAckForOutgoingMessage) {
+            messageTransport.emit(outgoingMessage);
+            return;
+        }
         const startTimer = () => {
             const timeoutTimer = setTimeout(() => {
                 // Try to recover connection if available
                 if (applyRecoveryManager.hasRecoveryManager(messageTransport) &&
                     messageTransport.recoveryManager.canRetryMessageSessionId(messageSessionId)) {
+                    if (isDebugEnabled()) {
+                        logger.logger.debug(`[messageSender ${requestType} ${getTimestamp()}] — timed out, triggering recovery (messageSessionId: ${messageSessionId})`);
+                    }
                     messageTransport.recoveryManager.triggerRecovery(messageSessionId);
+                    if (isDebugEnabled()) {
+                        logger.logger.debug(`[messageSender ${requestType} ${getTimestamp()}] — attempting to send message again (messageSessionId: ${messageSessionId})`);
+                    }
                     sendMessage();
                 }
                 else {
@@ -47,6 +72,9 @@ const createRequestChannelMessageSender = ({ requestType, messageSessionId, time
                     messageTimedOut = true;
                 }
             }, utils.TIMEOUT_DURATION);
+            if (isDebugEnabled()) {
+                logger.logger.debug(`[messageSender ${requestType} ${getTimestamp()}] — setting timeout timer (messageSessionId: ${messageSessionId}). Timeout ID: ${timeoutTimer}. Content of timeoutMap: ${JSON.stringify(timeoutMap)}`);
+            }
             timeoutMap[messageSessionId] = timeoutTimer;
         };
         // If this message transport is currently blocked, we must only start
@@ -54,13 +82,13 @@ const createRequestChannelMessageSender = ({ requestType, messageSessionId, time
         // We don't just default to this because the onEmit option is only
         // present in the message transport if has the block decorator
         if ('isBlocked' in messageTransport && messageTransport.isBlocked()) {
-            messageTransport.emit(message, { onEmit: startTimer });
+            messageTransport.emit(outgoingMessage, { onEmit: startTimer });
             return;
         }
-        // Now we emit the event to set off the request
-        messageTransport.emit(message);
         // We start the timer immediately since the message was not blocked
         startTimer();
+        // Now we emit the event to set off the request
+        messageTransport.emit(outgoingMessage);
     };
     return { handleAckMessage, sendMessage };
 };

package/src/requestChannel/createRequestChannelMessageSender/createRequestChannelMessageSender.d.ts

@@ -10,9 +10,11 @@ type RequestChannelMessageSenderParams<T extends RequestTypes, K extends Extract
     onTimeout: VoidFunction;
     messageTransport: MessageTransportWithDefaultOrigin | WithBlock<MessageTransportWithDefaultOrigin>;
     params: Parameters<T[K]>;
+    debugOverride?: boolean;
+    disableAckForOutgoingMessage?: boolean;
 };
-export declare const createRequestChannelMessageSender: <T extends RequestTypes, K extends Extract<keyof T, string>>({ requestType, messageSessionId, timeoutMap, onReceiveAck, messageTransport, onTimeout, params, }: RequestChannelMessageSenderParams<T, K>) => {
-    handleAckMessage: ({ messageSessionId: incomingSessionId, type: incomingType, }: MessageTransportData) => void;
+export declare const createRequestChannelMessageSender: <T extends RequestTypes, K extends Extract<keyof T, string>>({ requestType, messageSessionId, timeoutMap, onReceiveAck, messageTransport, onTimeout, params, debugOverride, disableAckForOutgoingMessage, }: RequestChannelMessageSenderParams<T, K>) => {
+    handleAckMessage: ({ messageSessionId: incomingSessionId, type: incomingType, doNotAck: incomingDoNotAck, }: MessageTransportData) => void;
     sendMessage: () => void;
 };
 export {};

package/src/requestChannel/createRequestChannelMessageSender/createRequestChannelMessageSender.js

@@ -1,9 +1,10 @@
 'use client'
+import { isGlobalDebugEnabled } from '../../debug/debug.js';
 import { hasRecoveryManager } from '../../messageTransport/decorators/applyRecoveryManager/applyRecoveryManager.js';
 import { logger } from '../../utils/logger.js';
 import { getAckMessageType, TIMEOUT_DURATION } from '../utils/utils.js';
 
-const createRequestChannelMessageSender = ({ requestType, messageSessionId, timeoutMap, onReceiveAck, messageTransport, onTimeout, params, }) => {
+const createRequestChannelMessageSender = ({ requestType, messageSessionId, timeoutMap, onReceiveAck, messageTransport, onTimeout, params, debugOverride, disableAckForOutgoingMessage = false, }) => {
     /**
      * Tracks whether this sender's message has timed out.
      * This way we can identify that it was a false negative if the message
@@ -11,30 +12,54 @@ const createRequestChannelMessageSender = ({ requestType, messageSessionId, time
      */
     let messageTimedOut = false;
     const ackMessageType = getAckMessageType(requestType);
-    const message = {
+    const isDebugEnabled = () => debugOverride !== null && debugOverride !== void 0 ? debugOverride : isGlobalDebugEnabled();
+    const outgoingMessage = {
         args: params,
+        doNotAck: disableAckForOutgoingMessage,
         messageSessionId,
         type: requestType,
     };
+    const getTimestamp = () => new Date().toISOString();
     // We must listen for acks
-    const handleAckMessage = ({ messageSessionId: incomingSessionId, type: incomingType, }) => {
+    const handleAckMessage = ({ messageSessionId: incomingSessionId, type: incomingType, doNotAck: incomingDoNotAck, }) => {
+        // DO NOT ignore ack messages when disableAckForOutgoingMessage is true.
+        // disableAckForOutgoingMessage means OUTGOING messages will not receive an ack.
+        // This is different than the INCOMING message's doNotAck, which is what we care about here
         if (incomingSessionId !== messageSessionId ||
-            incomingType !== ackMessageType)
+            incomingType !== ackMessageType ||
+            incomingDoNotAck) {
             return;
+        }
+        if (isDebugEnabled()) {
+            logger.debug(`[messageSender ${requestType} ${getTimestamp()}] — received ack message (messageSessionId: ${messageSessionId}). Message timeout ID: ${timeoutMap[messageSessionId]}. Content of timeoutMap: ${JSON.stringify(timeoutMap)}`);
+        }
         clearTimeout(timeoutMap[messageSessionId]);
         delete timeoutMap[messageSessionId];
         onReceiveAck === null || onReceiveAck === void 0 ? void 0 : onReceiveAck();
         if (messageTimedOut) {
+            if (isDebugEnabled()) {
+                logger.debug(`[messageSender ${requestType} ${getTimestamp()}] — identified a false negative for message time out. Message: ${requestType} with session id ${messageSessionId}`);
+            }
             logger.instrument(`Identified a false negative for message time out. Message: ${requestType} with session id ${messageSessionId}. Params: ${JSON.stringify(params)}`);
         }
     };
     const sendMessage = () => {
+        if (disableAckForOutgoingMessage) {
+            messageTransport.emit(outgoingMessage);
+            return;
+        }
         const startTimer = () => {
             const timeoutTimer = setTimeout(() => {
                 // Try to recover connection if available
                 if (hasRecoveryManager(messageTransport) &&
                     messageTransport.recoveryManager.canRetryMessageSessionId(messageSessionId)) {
+                    if (isDebugEnabled()) {
+                        logger.debug(`[messageSender ${requestType} ${getTimestamp()}] — timed out, triggering recovery (messageSessionId: ${messageSessionId})`);
+                    }
                     messageTransport.recoveryManager.triggerRecovery(messageSessionId);
+                    if (isDebugEnabled()) {
+                        logger.debug(`[messageSender ${requestType} ${getTimestamp()}] — attempting to send message again (messageSessionId: ${messageSessionId})`);
+                    }
                     sendMessage();
                 }
                 else {
@@ -43,6 +68,9 @@ const createRequestChannelMessageSender = ({ requestType, messageSessionId, time
                     messageTimedOut = true;
                 }
             }, TIMEOUT_DURATION);
+            if (isDebugEnabled()) {
+                logger.debug(`[messageSender ${requestType} ${getTimestamp()}] — setting timeout timer (messageSessionId: ${messageSessionId}). Timeout ID: ${timeoutTimer}. Content of timeoutMap: ${JSON.stringify(timeoutMap)}`);
+            }
             timeoutMap[messageSessionId] = timeoutTimer;
         };
         // If this message transport is currently blocked, we must only start
@@ -50,13 +78,13 @@ const createRequestChannelMessageSender = ({ requestType, messageSessionId, time
         // We don't just default to this because the onEmit option is only
         // present in the message transport if has the block decorator
         if ('isBlocked' in messageTransport && messageTransport.isBlocked()) {
-            messageTransport.emit(message, { onEmit: startTimer });
+            messageTransport.emit(outgoingMessage, { onEmit: startTimer });
             return;
         }
-        // Now we emit the event to set off the request
-        messageTransport.emit(message);
         // We start the timer immediately since the message was not blocked
         startTimer();
+        // Now we emit the event to set off the request
+        messageTransport.emit(outgoingMessage);
     };
     return { handleAckMessage, sendMessage };
 };

package/src/requestChannel/requestChannel.cjs

@@ -4,7 +4,9 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var _tslib = require('../../_virtual/_tslib.cjs');
+var debug = require('../debug/debug.cjs');
 var isSerializedError = require('../utils/isSerializedError/isSerializedError.cjs');
+var logger = require('../utils/logger.cjs');
 var parseErrorFromTransport = require('../utils/parseErrorFromTransport/parseErrorFromTransport.cjs');
 var serializeErrorForTransport = require('../utils/serializeErrorForTransport/serializeErrorForTransport.cjs');
 var createRequestChannelMessageSender = require('./createRequestChannelMessageSender/createRequestChannelMessageSender.cjs');
@@ -28,7 +30,7 @@ var utils = require('./utils/utils.cjs');
  *
  * This is an abstraction built on top of the MessageTransport interface.
  */
-const createRequestChannel = (messageTransport) => {
+const createRequestChannel = (messageTransport, { debugOverride, disableAcknowledgement } = {}) => {
     /** Used to generated unique ids */
     let uniqueIdCounter = 0;
     /** Id prefix unique to this channel */
@@ -37,6 +39,8 @@ const createRequestChannel = (messageTransport) => {
     const getUniqueId = () => `${idPrefix}-${uniqueIdCounter++}`;
     /** Maps a request's session ID to its time out timer */
     const timeoutMap = {};
+    const isDebugEnabled = () => debugOverride !== null && debugOverride !== void 0 ? debugOverride : debug.isGlobalDebugEnabled();
+    const getTimestamp = () => new Date().toISOString();
     return {
         emit: (requestType, ...params) => new Promise((resolve, reject) => {
             // Generate the unique id for this message exchange session
@@ -44,6 +48,8 @@ const createRequestChannel = (messageTransport) => {
             // to avoid tangling with other requests.
             const messageSessionId = getUniqueId();
             const { handleAckMessage, sendMessage } = createRequestChannelMessageSender.createRequestChannelMessageSender({
+                debugOverride,
+                disableAckForOutgoingMessage: disableAcknowledgement,
                 messageSessionId,
                 messageTransport,
                 onReceiveAck: () => {
@@ -59,19 +65,26 @@ const createRequestChannel = (messageTransport) => {
                 timeoutMap,
             });
             const cleanupMessageHandler = () => messageTransport.off(handleAckMessage);
-            messageTransport.on(handleAckMessage);
+            if (disableAcknowledgement) {
+                resolve();
+            }
+            else {
+                messageTransport.on(handleAckMessage);
+            }
             sendMessage();
         }),
         handle: (requestType, handler) => {
-            const messageHandler = (_a) => _tslib.__awaiter(void 0, [_a], void 0, function* ({ args, messageSessionId, type: incomingType, }) {
+            const messageHandler = (_a) => _tslib.__awaiter(void 0, [_a], void 0, function* ({ args, messageSessionId, type: incomingType, doNotAck = false, }) {
                 if (requestType !== incomingType)
                     return;
-                // Emit an Ack since the message will time out unless some handler acks it in time
-                messageTransport.emit({
-                    args: [],
-                    messageSessionId,
-                    type: utils.getAckMessageType(requestType),
-                });
+                if (!doNotAck) {
+                    // Emit an Ack since the message will time out unless some handler acks it in time
+                    messageTransport.emit({
+                        args: [],
+                        messageSessionId,
+                        type: utils.getAckMessageType(requestType),
+                    });
+                }
                 const result = handler(...args);
                 // If the handler doesn't return a promise,
                 // that means we don't need to respond.
@@ -106,6 +119,8 @@ const createRequestChannel = (messageTransport) => {
             const resolveMessageType = utils.getResolveMessageType(requestType);
             const rejectMessageType = utils.getRejectMessageType(requestType);
             const { handleAckMessage, sendMessage } = createRequestChannelMessageSender.createRequestChannelMessageSender({
+                debugOverride,
+                disableAckForOutgoingMessage: disableAcknowledgement,
                 messageSessionId,
                 messageTransport,
                 onTimeout: () => {
@@ -120,10 +135,16 @@ const createRequestChannel = (messageTransport) => {
             const handleMessage = (message) => {
                 if (message.messageSessionId !== messageSessionId)
                     return;
+                if (isDebugEnabled()) {
+                    logger.logger.debug(`[request ${requestType} ${getTimestamp()}] — received response message (messageSessionId: ${messageSessionId})`);
+                }
                 const { args: [result], type: incomingType, } = message;
                 if (incomingType === resolveMessageType) {
                     cleanupMessageHandler();
                     resolve(result);
+                    if (isDebugEnabled()) {
+                        logger.logger.debug(`[request ${requestType} ${getTimestamp()}] — resolved message (messageSessionId: ${messageSessionId})`);
+                    }
                     return;
                 }
                 if (incomingType === rejectMessageType) {
@@ -134,6 +155,9 @@ const createRequestChannel = (messageTransport) => {
                     else {
                         reject(result);
                     }
+                    if (isDebugEnabled()) {
+                        logger.logger.debug(`[request ${requestType} ${getTimestamp()}] — rejected message (messageSessionId: ${messageSessionId})`);
+                    }
                     return;
                 }
                 handleAckMessage(message);

package/src/requestChannel/requestChannel.d.ts

@@ -1,6 +1,20 @@
 import { WithBlock } from '../messageTransport';
 import { MessageTransportWithDefaultOrigin } from '../messageTransport/decorators/applyDefaultMessageOrigin/applyDefaultMessageOrigin';
 import { RequestChannel, RequestTypes } from './types';
+type CreateRequestChannelProps = {
+    /**
+     * Overrides whether to debug the request channel messages
+     */
+    debugOverride?: boolean;
+    /**
+     * Disables ack message replies for messages sent from this channel.
+     *
+     * Doesn't mean that this channel won't send ack replies to messages sent from
+     * other channels — what this does mean is messages SENT from THIS channel will
+     * not receive an ack reply.
+     */
+    disableAcknowledgement?: boolean;
+};
 /**
  * Allows handling and submitting requests to and from a webview.
  * Requests are messages that (can) expect some response.
@@ -19,4 +33,5 @@ import { RequestChannel, RequestTypes } from './types';
  *
  * This is an abstraction built on top of the MessageTransport interface.
  */
-export declare const createRequestChannel: <T extends RequestTypes = never>(messageTransport: MessageTransportWithDefaultOrigin | WithBlock<MessageTransportWithDefaultOrigin>) => RequestChannel<T>;
+export declare const createRequestChannel: <T extends RequestTypes = never>(messageTransport: MessageTransportWithDefaultOrigin | WithBlock<MessageTransportWithDefaultOrigin>, { debugOverride, disableAcknowledgement }?: CreateRequestChannelProps) => RequestChannel<T>;
+export {};

package/src/requestChannel/requestChannel.js

@@ -1,6 +1,8 @@
 'use client'
 import { __awaiter } from '../../_virtual/_tslib.js';
+import { isGlobalDebugEnabled } from '../debug/debug.js';
 import { isSerializedError } from '../utils/isSerializedError/isSerializedError.js';
+import { logger } from '../utils/logger.js';
 import { parseErrorFromTransport } from '../utils/parseErrorFromTransport/parseErrorFromTransport.js';
 import { serializeErrorForTransport } from '../utils/serializeErrorForTransport/serializeErrorForTransport.js';
 import { createRequestChannelMessageSender } from './createRequestChannelMessageSender/createRequestChannelMessageSender.js';
@@ -24,7 +26,7 @@ import { createNoHandlerError, getAckMessageType, getResolveMessageType, getReje
  *
  * This is an abstraction built on top of the MessageTransport interface.
  */
-const createRequestChannel = (messageTransport) => {
+const createRequestChannel = (messageTransport, { debugOverride, disableAcknowledgement } = {}) => {
     /** Used to generated unique ids */
     let uniqueIdCounter = 0;
     /** Id prefix unique to this channel */
@@ -33,6 +35,8 @@ const createRequestChannel = (messageTransport) => {
     const getUniqueId = () => `${idPrefix}-${uniqueIdCounter++}`;
     /** Maps a request's session ID to its time out timer */
     const timeoutMap = {};
+    const isDebugEnabled = () => debugOverride !== null && debugOverride !== void 0 ? debugOverride : isGlobalDebugEnabled();
+    const getTimestamp = () => new Date().toISOString();
     return {
         emit: (requestType, ...params) => new Promise((resolve, reject) => {
             // Generate the unique id for this message exchange session
@@ -40,6 +44,8 @@ const createRequestChannel = (messageTransport) => {
             // to avoid tangling with other requests.
             const messageSessionId = getUniqueId();
             const { handleAckMessage, sendMessage } = createRequestChannelMessageSender({
+                debugOverride,
+                disableAckForOutgoingMessage: disableAcknowledgement,
                 messageSessionId,
                 messageTransport,
                 onReceiveAck: () => {
@@ -55,19 +61,26 @@ const createRequestChannel = (messageTransport) => {
                 timeoutMap,
             });
             const cleanupMessageHandler = () => messageTransport.off(handleAckMessage);
-            messageTransport.on(handleAckMessage);
+            if (disableAcknowledgement) {
+                resolve();
+            }
+            else {
+                messageTransport.on(handleAckMessage);
+            }
             sendMessage();
         }),
         handle: (requestType, handler) => {
-            const messageHandler = (_a) => __awaiter(void 0, [_a], void 0, function* ({ args, messageSessionId, type: incomingType, }) {
+            const messageHandler = (_a) => __awaiter(void 0, [_a], void 0, function* ({ args, messageSessionId, type: incomingType, doNotAck = false, }) {
                 if (requestType !== incomingType)
                     return;
-                // Emit an Ack since the message will time out unless some handler acks it in time
-                messageTransport.emit({
-                    args: [],
-                    messageSessionId,
-                    type: getAckMessageType(requestType),
-                });
+                if (!doNotAck) {
+                    // Emit an Ack since the message will time out unless some handler acks it in time
+                    messageTransport.emit({
+                        args: [],
+                        messageSessionId,
+                        type: getAckMessageType(requestType),
+                    });
+                }
                 const result = handler(...args);
                 // If the handler doesn't return a promise,
                 // that means we don't need to respond.
@@ -102,6 +115,8 @@ const createRequestChannel = (messageTransport) => {
             const resolveMessageType = getResolveMessageType(requestType);
             const rejectMessageType = getRejectMessageType(requestType);
             const { handleAckMessage, sendMessage } = createRequestChannelMessageSender({
+                debugOverride,
+                disableAckForOutgoingMessage: disableAcknowledgement,
                 messageSessionId,
                 messageTransport,
                 onTimeout: () => {
@@ -116,10 +131,16 @@ const createRequestChannel = (messageTransport) => {
             const handleMessage = (message) => {
                 if (message.messageSessionId !== messageSessionId)
                     return;
+                if (isDebugEnabled()) {
+                    logger.debug(`[request ${requestType} ${getTimestamp()}] — received response message (messageSessionId: ${messageSessionId})`);
+                }
                 const { args: [result], type: incomingType, } = message;
                 if (incomingType === resolveMessageType) {
                     cleanupMessageHandler();
                     resolve(result);
+                    if (isDebugEnabled()) {
+                        logger.debug(`[request ${requestType} ${getTimestamp()}] — resolved message (messageSessionId: ${messageSessionId})`);
+                    }
                     return;
                 }
                 if (incomingType === rejectMessageType) {
@@ -130,6 +151,9 @@ const createRequestChannel = (messageTransport) => {
                     else {
                         reject(result);
                     }
+                    if (isDebugEnabled()) {
+                        logger.debug(`[request ${requestType} ${getTimestamp()}] — rejected message (messageSessionId: ${messageSessionId})`);
+                    }
                     return;
                 }
                 handleAckMessage(message);

package/src/requestChannel/utils/utils.cjs

@@ -34,7 +34,7 @@ const createNoHandlerError = (type) => {
  *
  * This controls how many ms we should wait before we time out.
  */
-const TIMEOUT_DURATION = 1000;
+const TIMEOUT_DURATION = 5000;
 
 exports.TIMEOUT_DURATION = TIMEOUT_DURATION;
 exports.createNoHandlerError = createNoHandlerError;

package/src/requestChannel/utils/utils.d.ts

@@ -21,4 +21,4 @@ export declare const createNoHandlerError: (type: string) => RequestChannelNotHa
  *
  * This controls how many ms we should wait before we time out.
  */
-export declare const TIMEOUT_DURATION = 1000;
+export declare const TIMEOUT_DURATION = 5000;

package/src/requestChannel/utils/utils.js

@@ -30,6 +30,6 @@ const createNoHandlerError = (type) => {
  *
  * This controls how many ms we should wait before we time out.
  */
-const TIMEOUT_DURATION = 1000;
+const TIMEOUT_DURATION = 5000;
 
 export { TIMEOUT_DURATION, createNoHandlerError, getAckMessageType, getRejectMessageType, getResolveMessageType, isAckMessageType, isRejectMessageType, isRequestMessageType, isResolveMessageType };

package/src/utils/parseMessageTransportData/parseMessageTransportData.cjs

@@ -11,8 +11,10 @@ parsedData) => {
     }
     const message = {
         args: parsedData.args,
+        doNotAck: parsedData.doNotAck,
         messageSessionId: parsedData.messageSessionId,
         origin: parsedData.origin,
+        transportStamps: parsedData.transportStamps,
         type: parsedData.type,
     };
     if (!Array.isArray(message.args) ||

package/src/utils/parseMessageTransportData/parseMessageTransportData.js

@@ -7,8 +7,10 @@ parsedData) => {
     }
     const message = {
         args: parsedData.args,
+        doNotAck: parsedData.doNotAck,
         messageSessionId: parsedData.messageSessionId,
         origin: parsedData.origin,
+        transportStamps: parsedData.transportStamps,
         type: parsedData.type,
     };
     if (!Array.isArray(message.args) ||