@expo/devtools 0.0.1

package/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015-present 650 Industries, Inc. (aka Expo)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,16 @@
+<!-- Title -->
+<h1 align="center">
+👋 Welcome to <br><code>@expo/devtools</code>
+</h1>
+
+<p align="center">DevTools plugin helpers for Expo.</p>
+
+<p align="center">
+  <img src="https://flat.badgen.net/packagephobia/install/@expo/devtools">
+
+  <a href="https://www.npmjs.com/package/@expo/devtools">
+    <img src="https://flat.badgen.net/npm/dw/@expo/devtools" target="_blank" />
+  </a>
+</p>
+
+<!-- Body -->

package/build/DevToolsPluginClient.d.ts

@@ -0,0 +1,73 @@
+import { WebSocketBackingStore } from './WebSocketBackingStore';
+import { type WebSocketMessageEvent } from './WebSocketWithReconnect';
+import type { ConnectionInfo, DevToolsPluginClientOptions, HandshakeMessageParams } from './devtools.types';
+export interface EventSubscription {
+    remove(): void;
+}
+/**
+ * This client is for the Expo DevTools Plugins to communicate between the app and the DevTools webpage hosted in a browser.
+ * All the code should be both compatible with browsers and React Native.
+ */
+export declare abstract class DevToolsPluginClient {
+    readonly connectionInfo: ConnectionInfo;
+    private readonly options?;
+    private listeners;
+    private static defaultWSStore;
+    private readonly wsStore;
+    protected isClosed: boolean;
+    protected retries: number;
+    private readonly messageFramePacker;
+    constructor(connectionInfo: ConnectionInfo, options?: DevToolsPluginClientOptions | undefined);
+    /**
+     * Initialize the connection.
+     * @hidden
+     */
+    initAsync(): Promise<void>;
+    /**
+     * Close the connection.
+     */
+    closeAsync(): Promise<void>;
+    /**
+     * Send a message to the other end of DevTools.
+     * @param method A method name.
+     * @param params any extra payload.
+     */
+    sendMessage(method: string, params: any): void;
+    /**
+     * Subscribe to a message from the other end of DevTools.
+     * @param method Subscribe to a message with a method name.
+     * @param listener Listener to be called when a message is received.
+     */
+    addMessageListener(method: string, listener: (params: any) => void): EventSubscription;
+    /**
+     * Subscribe to a message from the other end of DevTools just once.
+     * @param method Subscribe to a message with a method name.
+     * @param listener Listener to be called when a message is received.
+     */
+    addMessageListenerOnce(method: string, listener: (params: any) => void): void;
+    /**
+     * Internal handshake message sender.
+     * @hidden
+     */
+    protected sendHandshakeMessage(params: HandshakeMessageParams): void;
+    /**
+     * Internal handshake message listener.
+     * @hidden
+     */
+    protected addHandskakeMessageListener(listener: (params: HandshakeMessageParams) => void): EventSubscription;
+    /**
+     * Returns whether the client is connected to the server.
+     */
+    isConnected(): boolean;
+    /**
+     * The method to create the WebSocket connection.
+     */
+    protected connectAsync(): Promise<WebSocket>;
+    protected handleMessage: (event: WebSocketMessageEvent) => Promise<void>;
+    /**
+     * Get the WebSocket backing store. Exposed for testing.
+     * @hidden
+     */
+    getWebSocketBackingStore(): WebSocketBackingStore;
+}
+//# sourceMappingURL=DevToolsPluginClient.d.ts.map

package/build/DevToolsPluginClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevToolsPluginClient.d.ts","sourceRoot":"","sources":["../src/DevToolsPluginClient.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EACV,cAAc,EACd,2BAA2B,EAC3B,sBAAsB,EACvB,MAAM,kBAAkB,CAAC;AAS1B,MAAM,WAAW,iBAAiB;IAChC,MAAM,IAAI,IAAI,CAAC;CAChB;AAED;;;GAGG;AACH,8BAAsB,oBAAoB;aAYtB,cAAc,EAAE,cAAc;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAZ3B,OAAO,CAAC,SAAS,CAAyD;IAE1E,OAAO,CAAC,MAAM,CAAC,cAAc,CAAsD;IACnF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8D;IAEtF,SAAS,CAAC,QAAQ,UAAS;IAC3B,SAAS,CAAC,OAAO,SAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CACR;gBAGT,cAAc,EAAE,cAAc,EAC7B,OAAO,CAAC,EAAE,2BAA2B,YAAA;IAMxD;;;OAGG;IACU,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAQvC;;OAEG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAWxC;;;;OAIG;IACI,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG;IAmB9C;;;;OAIG;IACI,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,GAAG,iBAAiB;IAU7F;;;;OAIG;IACI,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI;IAQpF;;;OAGG;IACH,SAAS,CAAC,oBAAoB,CAAC,MAAM,EAAE,sBAAsB;IAQ7D;;;OAGG;IACH,SAAS,CAAC,2BAA2B,CACnC,QAAQ,EAAE,CAAC,MAAM,EAAE,sBAAsB,KAAK,IAAI,GACjD,iBAAiB;IA2BpB;;OAEG;IACI,WAAW,IAAI,OAAO;IAI7B;;OAEG;IACH,SAAS,CAAC,YAAY,IAAI,OAAO,CAAC,SAAS,CAAC;IAyB5C,SAAS,CAAC,aAAa,GAAU,OAAO,qBAAqB,mBA6B3D;IAEF;;;OAGG;IACI,wBAAwB,IAAI,qBAAqB;CAGzD"}

package/build/DevToolsPluginClient.js

@@ -0,0 +1,212 @@
+import { MessageFramePacker } from './MessageFramePacker';
+import { WebSocketBackingStore } from './WebSocketBackingStore';
+import { WebSocketWithReconnect, } from './WebSocketWithReconnect';
+import * as logger from './logger';
+import { blobToArrayBufferAsync } from './utils/blobUtils';
+/**
+ * This client is for the Expo DevTools Plugins to communicate between the app and the DevTools webpage hosted in a browser.
+ * All the code should be both compatible with browsers and React Native.
+ */
+export class DevToolsPluginClient {
+    connectionInfo;
+    options;
+    listeners;
+    static defaultWSStore = new WebSocketBackingStore();
+    wsStore = DevToolsPluginClient.defaultWSStore;
+    isClosed = false;
+    retries = 0;
+    messageFramePacker = new MessageFramePacker();
+    constructor(connectionInfo, options) {
+        this.connectionInfo = connectionInfo;
+        this.options = options;
+        this.wsStore = connectionInfo.wsStore || DevToolsPluginClient.defaultWSStore;
+        this.listeners = Object.create(null);
+    }
+    /**
+     * Initialize the connection.
+     * @hidden
+     */
+    async initAsync() {
+        if (this.wsStore.ws == null) {
+            this.wsStore.ws = await this.connectAsync();
+        }
+        this.wsStore.refCount += 1;
+        this.wsStore.ws.addEventListener('message', this.handleMessage);
+    }
+    /**
+     * Close the connection.
+     */
+    async closeAsync() {
+        this.isClosed = true;
+        this.wsStore.ws?.removeEventListener('message', this.handleMessage);
+        this.wsStore.refCount -= 1;
+        if (this.wsStore.refCount < 1) {
+            this.wsStore.ws?.close();
+            this.wsStore.ws = null;
+        }
+        this.listeners = Object.create(null);
+    }
+    /**
+     * Send a message to the other end of DevTools.
+     * @param method A method name.
+     * @param params any extra payload.
+     */
+    sendMessage(method, params) {
+        if (this.wsStore.ws?.readyState === WebSocket.CLOSED) {
+            logger.warn('Unable to send message in a disconnected state.');
+            return;
+        }
+        const messageKey = {
+            pluginName: this.connectionInfo.pluginName,
+            method,
+        };
+        const packedData = this.messageFramePacker.pack({ messageKey, payload: params });
+        if (!(packedData instanceof Promise)) {
+            this.wsStore.ws?.send(packedData);
+            return;
+        }
+        packedData.then((data) => {
+            this.wsStore.ws?.send(data);
+        });
+    }
+    /**
+     * Subscribe to a message from the other end of DevTools.
+     * @param method Subscribe to a message with a method name.
+     * @param listener Listener to be called when a message is received.
+     */
+    addMessageListener(method, listener) {
+        const listenersForMethod = this.listeners[method] || (this.listeners[method] = new Set());
+        listenersForMethod.add(listener);
+        return {
+            remove: () => {
+                this.listeners[method]?.delete(listener);
+            },
+        };
+    }
+    /**
+     * Subscribe to a message from the other end of DevTools just once.
+     * @param method Subscribe to a message with a method name.
+     * @param listener Listener to be called when a message is received.
+     */
+    addMessageListenerOnce(method, listener) {
+        const wrappedListenerOnce = (params) => {
+            listener(params);
+            this.listeners[method]?.delete(wrappedListenerOnce);
+        };
+        this.addMessageListener(method, wrappedListenerOnce);
+    }
+    /**
+     * Internal handshake message sender.
+     * @hidden
+     */
+    sendHandshakeMessage(params) {
+        if (this.wsStore.ws?.readyState === WebSocket.CLOSED) {
+            logger.warn('Unable to send message in a disconnected state.');
+            return;
+        }
+        this.wsStore.ws?.send(JSON.stringify({ ...params, __isHandshakeMessages: true }));
+    }
+    /**
+     * Internal handshake message listener.
+     * @hidden
+     */
+    addHandskakeMessageListener(listener) {
+        const messageListener = (event) => {
+            if (typeof event.data !== 'string') {
+                // binary data is not coming from the handshake messages.
+                return;
+            }
+            const data = JSON.parse(event.data);
+            if (!data.__isHandshakeMessages) {
+                return;
+            }
+            delete data.__isHandshakeMessages;
+            const params = data;
+            if (params.pluginName && params.pluginName !== this.connectionInfo.pluginName) {
+                return;
+            }
+            listener(params);
+        };
+        this.wsStore.ws?.addEventListener('message', messageListener);
+        return {
+            remove: () => {
+                this.wsStore.ws?.removeEventListener('message', messageListener);
+            },
+        };
+    }
+    /**
+     * Returns whether the client is connected to the server.
+     */
+    isConnected() {
+        return this.wsStore.ws?.readyState === WebSocket.OPEN;
+    }
+    /**
+     * The method to create the WebSocket connection.
+     */
+    connectAsync() {
+        return new Promise((resolve, reject) => {
+            const endpoint = 'expo-dev-plugins/broadcast';
+            const ws = new WebSocketWithReconnect(`ws://${this.connectionInfo.devServer}/${endpoint}`, {
+                binaryType: this.options?.websocketBinaryType,
+                onError: (e) => {
+                    if (e instanceof Error) {
+                        console.warn(`Error happened from the WebSocket connection: ${e.message}\n${e.stack}`);
+                    }
+                    else {
+                        console.warn(`Error happened from the WebSocket connection: ${JSON.stringify(e)}`);
+                    }
+                },
+            });
+            ws.addEventListener('open', () => {
+                resolve(ws);
+            });
+            ws.addEventListener('error', (e) => {
+                reject(e);
+            });
+            ws.addEventListener('close', (e) => {
+                logger.info('WebSocket closed', e.code, e.reason);
+            });
+        });
+    }
+    handleMessage = async (event) => {
+        let data;
+        if (typeof event.data === 'string') {
+            data = event.data;
+        }
+        else if (event.data instanceof ArrayBuffer) {
+            data = event.data;
+        }
+        else if (ArrayBuffer.isView(event.data)) {
+            data = event.data.buffer;
+        }
+        else if (event.data instanceof Blob) {
+            data = await blobToArrayBufferAsync(event.data);
+        }
+        else {
+            logger.warn('Unsupported received data type in handleMessageImpl');
+            return;
+        }
+        const { messageKey, payload, ...rest } = this.messageFramePacker.unpack(data);
+        // @ts-expect-error: `__isHandshakeMessages` is a private field that is not part of the MessageFramePacker type.
+        if (rest?.__isHandshakeMessages === true) {
+            return;
+        }
+        if (messageKey.pluginName && messageKey.pluginName !== this.connectionInfo.pluginName) {
+            return;
+        }
+        const listenersForMethod = this.listeners[messageKey.method];
+        if (listenersForMethod) {
+            for (const listener of listenersForMethod) {
+                listener(payload);
+            }
+        }
+    };
+    /**
+     * Get the WebSocket backing store. Exposed for testing.
+     * @hidden
+     */
+    getWebSocketBackingStore() {
+        return this.wsStore;
+    }
+}
+//# sourceMappingURL=DevToolsPluginClient.js.map

package/build/DevToolsPluginClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevToolsPluginClient.js","sourceRoot":"","sources":["../src/DevToolsPluginClient.ts"],"names":[],"mappings":"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","sourcesContent":["import { MessageFramePacker } from './MessageFramePacker';\nimport { WebSocketBackingStore } from './WebSocketBackingStore';\nimport {\n  WebSocketWithReconnect,\n  type WebSocketCloseEvent,\n  type WebSocketMessageEvent,\n} from './WebSocketWithReconnect';\nimport type {\n  ConnectionInfo,\n  DevToolsPluginClientOptions,\n  HandshakeMessageParams,\n} from './devtools.types';\nimport * as logger from './logger';\nimport { blobToArrayBufferAsync } from './utils/blobUtils';\n\ninterface MessageFramePackerMessageKey {\n  pluginName: string;\n  method: string;\n}\n\nexport interface EventSubscription {\n  remove(): void;\n}\n\n/**\n * This client is for the Expo DevTools Plugins to communicate between the app and the DevTools webpage hosted in a browser.\n * All the code should be both compatible with browsers and React Native.\n */\nexport abstract class DevToolsPluginClient {\n  private listeners: Record<string, undefined | Set<(params: any) => void>>;\n\n  private static defaultWSStore: WebSocketBackingStore = new WebSocketBackingStore();\n  private readonly wsStore: WebSocketBackingStore = DevToolsPluginClient.defaultWSStore;\n\n  protected isClosed = false;\n  protected retries = 0;\n  private readonly messageFramePacker: MessageFramePacker<MessageFramePackerMessageKey> =\n    new MessageFramePacker();\n\n  public constructor(\n    public readonly connectionInfo: ConnectionInfo,\n    private readonly options?: DevToolsPluginClientOptions\n  ) {\n    this.wsStore = connectionInfo.wsStore || DevToolsPluginClient.defaultWSStore;\n    this.listeners = Object.create(null);\n  }\n\n  /**\n   * Initialize the connection.\n   * @hidden\n   */\n  public async initAsync(): Promise<void> {\n    if (this.wsStore.ws == null) {\n      this.wsStore.ws = await this.connectAsync();\n    }\n    this.wsStore.refCount += 1;\n    this.wsStore.ws.addEventListener('message', this.handleMessage);\n  }\n\n  /**\n   * Close the connection.\n   */\n  public async closeAsync(): Promise<void> {\n    this.isClosed = true;\n    this.wsStore.ws?.removeEventListener('message', this.handleMessage);\n    this.wsStore.refCount -= 1;\n    if (this.wsStore.refCount < 1) {\n      this.wsStore.ws?.close();\n      this.wsStore.ws = null;\n    }\n    this.listeners = Object.create(null);\n  }\n\n  /**\n   * Send a message to the other end of DevTools.\n   * @param method A method name.\n   * @param params any extra payload.\n   */\n  public sendMessage(method: string, params: any) {\n    if (this.wsStore.ws?.readyState === WebSocket.CLOSED) {\n      logger.warn('Unable to send message in a disconnected state.');\n      return;\n    }\n    const messageKey: MessageFramePackerMessageKey = {\n      pluginName: this.connectionInfo.pluginName,\n      method,\n    };\n    const packedData = this.messageFramePacker.pack({ messageKey, payload: params });\n    if (!(packedData instanceof Promise)) {\n      this.wsStore.ws?.send(packedData);\n      return;\n    }\n    packedData.then((data) => {\n      this.wsStore.ws?.send(data);\n    });\n  }\n\n  /**\n   * Subscribe to a message from the other end of DevTools.\n   * @param method Subscribe to a message with a method name.\n   * @param listener Listener to be called when a message is received.\n   */\n  public addMessageListener(method: string, listener: (params: any) => void): EventSubscription {\n    const listenersForMethod = this.listeners[method] || (this.listeners[method] = new Set());\n    listenersForMethod.add(listener);\n    return {\n      remove: () => {\n        this.listeners[method]?.delete(listener);\n      },\n    };\n  }\n\n  /**\n   * Subscribe to a message from the other end of DevTools just once.\n   * @param method Subscribe to a message with a method name.\n   * @param listener Listener to be called when a message is received.\n   */\n  public addMessageListenerOnce(method: string, listener: (params: any) => void): void {\n    const wrappedListenerOnce = (params: any): void => {\n      listener(params);\n      this.listeners[method]?.delete(wrappedListenerOnce);\n    };\n    this.addMessageListener(method, wrappedListenerOnce);\n  }\n\n  /**\n   * Internal handshake message sender.\n   * @hidden\n   */\n  protected sendHandshakeMessage(params: HandshakeMessageParams) {\n    if (this.wsStore.ws?.readyState === WebSocket.CLOSED) {\n      logger.warn('Unable to send message in a disconnected state.');\n      return;\n    }\n    this.wsStore.ws?.send(JSON.stringify({ ...params, __isHandshakeMessages: true }));\n  }\n\n  /**\n   * Internal handshake message listener.\n   * @hidden\n   */\n  protected addHandskakeMessageListener(\n    listener: (params: HandshakeMessageParams) => void\n  ): EventSubscription {\n    const messageListener = (event: MessageEvent) => {\n      if (typeof event.data !== 'string') {\n        // binary data is not coming from the handshake messages.\n        return;\n      }\n\n      const data = JSON.parse(event.data);\n      if (!data.__isHandshakeMessages) {\n        return;\n      }\n      delete data.__isHandshakeMessages;\n      const params = data as HandshakeMessageParams;\n      if (params.pluginName && params.pluginName !== this.connectionInfo.pluginName) {\n        return;\n      }\n      listener(params);\n    };\n\n    this.wsStore.ws?.addEventListener('message', messageListener);\n    return {\n      remove: () => {\n        this.wsStore.ws?.removeEventListener('message', messageListener);\n      },\n    };\n  }\n\n  /**\n   * Returns whether the client is connected to the server.\n   */\n  public isConnected(): boolean {\n    return this.wsStore.ws?.readyState === WebSocket.OPEN;\n  }\n\n  /**\n   * The method to create the WebSocket connection.\n   */\n  protected connectAsync(): Promise<WebSocket> {\n    return new Promise((resolve, reject) => {\n      const endpoint = 'expo-dev-plugins/broadcast';\n      const ws = new WebSocketWithReconnect(`ws://${this.connectionInfo.devServer}/${endpoint}`, {\n        binaryType: this.options?.websocketBinaryType,\n        onError: (e: unknown) => {\n          if (e instanceof Error) {\n            console.warn(`Error happened from the WebSocket connection: ${e.message}\\n${e.stack}`);\n          } else {\n            console.warn(`Error happened from the WebSocket connection: ${JSON.stringify(e)}`);\n          }\n        },\n      });\n      ws.addEventListener('open', () => {\n        resolve(ws);\n      });\n      ws.addEventListener('error', (e) => {\n        reject(e);\n      });\n      ws.addEventListener('close', (e: WebSocketCloseEvent) => {\n        logger.info('WebSocket closed', e.code, e.reason);\n      });\n    });\n  }\n\n  protected handleMessage = async (event: WebSocketMessageEvent) => {\n    let data: ArrayBuffer | string;\n    if (typeof event.data === 'string') {\n      data = event.data;\n    } else if (event.data instanceof ArrayBuffer) {\n      data = event.data;\n    } else if (ArrayBuffer.isView(event.data)) {\n      data = event.data.buffer as ArrayBuffer;\n    } else if (event.data instanceof Blob) {\n      data = await blobToArrayBufferAsync(event.data);\n    } else {\n      logger.warn('Unsupported received data type in handleMessageImpl');\n      return;\n    }\n    const { messageKey, payload, ...rest } = this.messageFramePacker.unpack(data);\n    // @ts-expect-error: `__isHandshakeMessages` is a private field that is not part of the MessageFramePacker type.\n    if (rest?.__isHandshakeMessages === true) {\n      return;\n    }\n    if (messageKey.pluginName && messageKey.pluginName !== this.connectionInfo.pluginName) {\n      return;\n    }\n\n    const listenersForMethod = this.listeners[messageKey.method];\n    if (listenersForMethod) {\n      for (const listener of listenersForMethod) {\n        listener(payload);\n      }\n    }\n  };\n\n  /**\n   * Get the WebSocket backing store. Exposed for testing.\n   * @hidden\n   */\n  public getWebSocketBackingStore(): WebSocketBackingStore {\n    return this.wsStore;\n  }\n}\n"]}

package/build/DevToolsPluginClientFactory.d.ts

@@ -0,0 +1,16 @@
+import type { DevToolsPluginClient } from './DevToolsPluginClient';
+import type { ConnectionInfo, DevToolsPluginClientOptions } from './devtools.types';
+/**
+ * Factory of DevToolsPluginClient based on sender types.
+ * @hidden
+ */
+export declare function createDevToolsPluginClient(connectionInfo: ConnectionInfo, options?: DevToolsPluginClientOptions): Promise<DevToolsPluginClient>;
+/**
+ * Public API to get the DevToolsPluginClient instance.
+ */
+export declare function getDevToolsPluginClientAsync(pluginName: string, options?: DevToolsPluginClientOptions): Promise<DevToolsPluginClient>;
+/**
+ * Internal testing API to cleanup all DevToolsPluginClient instances.
+ */
+export declare function cleanupDevToolsPluginInstances(): void;
+//# sourceMappingURL=DevToolsPluginClientFactory.d.ts.map

package/build/DevToolsPluginClientFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevToolsPluginClientFactory.d.ts","sourceRoot":"","sources":["../src/DevToolsPluginClientFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAGnE,OAAO,KAAK,EAAE,cAAc,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAKpF;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,cAAc,EAAE,cAAc,EAC9B,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,oBAAoB,CAAC,CAS/B;AAED;;GAEG;AACH,wBAAsB,4BAA4B,CAChD,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,oBAAoB,CAAC,CAyB/B;AAED;;GAEG;AACH,wBAAgB,8BAA8B,SAU7C"}

package/build/DevToolsPluginClientFactory.js

@@ -0,0 +1,60 @@
+import { DevToolsPluginClientImplApp } from './DevToolsPluginClientImplApp';
+import { DevToolsPluginClientImplBrowser } from './DevToolsPluginClientImplBrowser';
+import { getConnectionInfo } from './getConnectionInfo';
+const instanceMap = {};
+/**
+ * Factory of DevToolsPluginClient based on sender types.
+ * @hidden
+ */
+export async function createDevToolsPluginClient(connectionInfo, options) {
+    let client;
+    if (connectionInfo.sender === 'app') {
+        client = new DevToolsPluginClientImplApp(connectionInfo, options);
+    }
+    else {
+        client = new DevToolsPluginClientImplBrowser(connectionInfo, options);
+    }
+    await client.initAsync();
+    return client;
+}
+/**
+ * Public API to get the DevToolsPluginClient instance.
+ */
+export async function getDevToolsPluginClientAsync(pluginName, options) {
+    const connectionInfo = getConnectionInfo();
+    let instance = instanceMap[pluginName];
+    if (instance != null) {
+        if (instance instanceof Promise) {
+            return instance;
+        }
+        if (instance.isConnected() === false ||
+            instance.connectionInfo.devServer !== connectionInfo.devServer) {
+            await instance.closeAsync();
+            delete instanceMap[pluginName];
+            instance = null;
+        }
+    }
+    if (instance == null) {
+        const instancePromise = createDevToolsPluginClient({ ...connectionInfo, pluginName }, options);
+        instanceMap[pluginName] = instancePromise;
+        instance = await instancePromise;
+        instanceMap[pluginName] = instance;
+    }
+    return instance;
+}
+/**
+ * Internal testing API to cleanup all DevToolsPluginClient instances.
+ */
+export function cleanupDevToolsPluginInstances() {
+    for (const pluginName of Object.keys(instanceMap)) {
+        const instance = instanceMap[pluginName];
+        delete instanceMap[pluginName];
+        if (instance instanceof Promise) {
+            instance.then((instance) => instance.closeAsync());
+        }
+        else {
+            instance.closeAsync();
+        }
+    }
+}
+//# sourceMappingURL=DevToolsPluginClientFactory.js.map

package/build/DevToolsPluginClientFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevToolsPluginClientFactory.js","sourceRoot":"","sources":["../src/DevToolsPluginClientFactory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AAEpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,WAAW,GAAyE,EAAE,CAAC;AAE7F;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,cAA8B,EAC9B,OAAqC;IAErC,IAAI,MAA4B,CAAC;IACjC,IAAI,cAAc,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QACpC,MAAM,GAAG,IAAI,2BAA2B,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IACpE,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,IAAI,+BAA+B,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;IACzB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,UAAkB,EAClB,OAAqC;IAErC,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAC;IAE3C,IAAI,QAAQ,GACV,WAAW,CAAC,UAAU,CAAC,CAAC;IAC1B,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,QAAQ,YAAY,OAAO,EAAE,CAAC;YAChC,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,IACE,QAAQ,CAAC,WAAW,EAAE,KAAK,KAAK;YAChC,QAAQ,CAAC,cAAc,CAAC,SAAS,KAAK,cAAc,CAAC,SAAS,EAC9D,CAAC;YACD,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC;YAC5B,OAAO,WAAW,CAAC,UAAU,CAAC,CAAC;YAC/B,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;IACH,CAAC;IACD,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,eAAe,GAAG,0BAA0B,CAAC,EAAE,GAAG,cAAc,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;QAC/F,WAAW,CAAC,UAAU,CAAC,GAAG,eAAe,CAAC;QAC1C,QAAQ,GAAG,MAAM,eAAe,CAAC;QACjC,WAAW,CAAC,UAAU,CAAC,GAAG,QAAQ,CAAC;IACrC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,8BAA8B;IAC5C,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QAClD,MAAM,QAAQ,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;QACzC,OAAO,WAAW,CAAC,UAAU,CAAC,CAAC;QAC/B,IAAI,QAAQ,YAAY,OAAO,EAAE,CAAC;YAChC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QACrD,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,UAAU,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;AACH,CAAC","sourcesContent":["import type { DevToolsPluginClient } from './DevToolsPluginClient';\nimport { DevToolsPluginClientImplApp } from './DevToolsPluginClientImplApp';\nimport { DevToolsPluginClientImplBrowser } from './DevToolsPluginClientImplBrowser';\nimport type { ConnectionInfo, DevToolsPluginClientOptions } from './devtools.types';\nimport { getConnectionInfo } from './getConnectionInfo';\n\nconst instanceMap: Record<string, DevToolsPluginClient | Promise<DevToolsPluginClient>> = {};\n\n/**\n * Factory of DevToolsPluginClient based on sender types.\n * @hidden\n */\nexport async function createDevToolsPluginClient(\n  connectionInfo: ConnectionInfo,\n  options?: DevToolsPluginClientOptions\n): Promise<DevToolsPluginClient> {\n  let client: DevToolsPluginClient;\n  if (connectionInfo.sender === 'app') {\n    client = new DevToolsPluginClientImplApp(connectionInfo, options);\n  } else {\n    client = new DevToolsPluginClientImplBrowser(connectionInfo, options);\n  }\n  await client.initAsync();\n  return client;\n}\n\n/**\n * Public API to get the DevToolsPluginClient instance.\n */\nexport async function getDevToolsPluginClientAsync(\n  pluginName: string,\n  options?: DevToolsPluginClientOptions\n): Promise<DevToolsPluginClient> {\n  const connectionInfo = getConnectionInfo();\n\n  let instance: DevToolsPluginClient | Promise<DevToolsPluginClient> | null =\n    instanceMap[pluginName];\n  if (instance != null) {\n    if (instance instanceof Promise) {\n      return instance;\n    }\n    if (\n      instance.isConnected() === false ||\n      instance.connectionInfo.devServer !== connectionInfo.devServer\n    ) {\n      await instance.closeAsync();\n      delete instanceMap[pluginName];\n      instance = null;\n    }\n  }\n  if (instance == null) {\n    const instancePromise = createDevToolsPluginClient({ ...connectionInfo, pluginName }, options);\n    instanceMap[pluginName] = instancePromise;\n    instance = await instancePromise;\n    instanceMap[pluginName] = instance;\n  }\n  return instance;\n}\n\n/**\n * Internal testing API to cleanup all DevToolsPluginClient instances.\n */\nexport function cleanupDevToolsPluginInstances() {\n  for (const pluginName of Object.keys(instanceMap)) {\n    const instance = instanceMap[pluginName];\n    delete instanceMap[pluginName];\n    if (instance instanceof Promise) {\n      instance.then((instance) => instance.closeAsync());\n    } else {\n      instance.closeAsync();\n    }\n  }\n}\n"]}

package/build/DevToolsPluginClientImplApp.d.ts

@@ -0,0 +1,15 @@
+import { DevToolsPluginClient } from './DevToolsPluginClient';
+/**
+ * The DevToolsPluginClient for the app -> browser communication.
+ */
+export declare class DevToolsPluginClientImplApp extends DevToolsPluginClient {
+    private browserClientMap;
+    /**
+     * Initialize the connection.
+     * @hidden
+     */
+    initAsync(): Promise<void>;
+    private addHandshakeHandler;
+    private terminateBrowserClient;
+}
+//# sourceMappingURL=DevToolsPluginClientImplApp.d.ts.map

package/build/DevToolsPluginClientImplApp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevToolsPluginClientImplApp.d.ts","sourceRoot":"","sources":["../src/DevToolsPluginClientImplApp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAG9D;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,oBAAoB;IAEnE,OAAO,CAAC,gBAAgB,CAA8B;IAEtD;;;OAGG;IACY,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAKzC,OAAO,CAAC,mBAAmB;IA4B3B,OAAO,CAAC,sBAAsB;CAQ/B"}

package/build/DevToolsPluginClientImplApp.js

@@ -0,0 +1,47 @@
+import { DevToolsPluginClient } from './DevToolsPluginClient';
+import * as logger from './logger';
+/**
+ * The DevToolsPluginClient for the app -> browser communication.
+ */
+export class DevToolsPluginClientImplApp extends DevToolsPluginClient {
+    // Map of pluginName -> browserClientId
+    browserClientMap = {};
+    /**
+     * Initialize the connection.
+     * @hidden
+     */
+    async initAsync() {
+        await super.initAsync();
+        this.addHandshakeHandler();
+    }
+    addHandshakeHandler() {
+        this.addHandskakeMessageListener((params) => {
+            if (params.method === 'handshake') {
+                const { pluginName, protocolVersion } = params;
+                // [0] Check protocol version
+                if (protocolVersion !== this.connectionInfo.protocolVersion) {
+                    // Use console.warn than logger because we want to show the warning even logging is disabled.
+                    console.warn(`Received an incompatible devtools plugin handshake message - pluginName[${pluginName}]`);
+                    this.terminateBrowserClient(pluginName, params.browserClientId);
+                    return;
+                }
+                // [1] Terminate duplicated browser clients for the same plugin
+                const previousBrowserClientId = this.browserClientMap[pluginName];
+                if (previousBrowserClientId != null && previousBrowserClientId !== params.browserClientId) {
+                    logger.info(`Terminate the previous browser client connection - previousBrowserClientId[${previousBrowserClientId}]`);
+                    this.terminateBrowserClient(pluginName, previousBrowserClientId);
+                }
+                this.browserClientMap[pluginName] = params.browserClientId;
+            }
+        });
+    }
+    terminateBrowserClient(pluginName, browserClientId) {
+        this.sendHandshakeMessage({
+            protocolVersion: this.connectionInfo.protocolVersion,
+            method: 'terminateBrowserClient',
+            browserClientId,
+            pluginName,
+        });
+    }
+}
+//# sourceMappingURL=DevToolsPluginClientImplApp.js.map

package/build/DevToolsPluginClientImplApp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevToolsPluginClientImplApp.js","sourceRoot":"","sources":["../src/DevToolsPluginClientImplApp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AAEnC;;GAEG;AACH,MAAM,OAAO,2BAA4B,SAAQ,oBAAoB;IACnE,uCAAuC;IAC/B,gBAAgB,GAA2B,EAAE,CAAC;IAEtD;;;OAGG;IACM,KAAK,CAAC,SAAS;QACtB,MAAM,KAAK,CAAC,SAAS,EAAE,CAAC;QACxB,IAAI,CAAC,mBAAmB,EAAE,CAAC;IAC7B,CAAC;IAEO,mBAAmB;QACzB,IAAI,CAAC,2BAA2B,CAAC,CAAC,MAAM,EAAE,EAAE;YAC1C,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBAClC,MAAM,EAAE,UAAU,EAAE,eAAe,EAAE,GAAG,MAAM,CAAC;gBAE/C,6BAA6B;gBAC7B,IAAI,eAAe,KAAK,IAAI,CAAC,cAAc,CAAC,eAAe,EAAE,CAAC;oBAC5D,6FAA6F;oBAC7F,OAAO,CAAC,IAAI,CACV,2EAA2E,UAAU,GAAG,CACzF,CAAC;oBACF,IAAI,CAAC,sBAAsB,CAAC,UAAU,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC;oBAChE,OAAO;gBACT,CAAC;gBAED,+DAA+D;gBAC/D,MAAM,uBAAuB,GAAG,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;gBAClE,IAAI,uBAAuB,IAAI,IAAI,IAAI,uBAAuB,KAAK,MAAM,CAAC,eAAe,EAAE,CAAC;oBAC1F,MAAM,CAAC,IAAI,CACT,8EAA8E,uBAAuB,GAAG,CACzG,CAAC;oBACF,IAAI,CAAC,sBAAsB,CAAC,UAAU,EAAE,uBAAuB,CAAC,CAAC;gBACnE,CAAC;gBACD,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,eAAe,CAAC;YAC7D,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,sBAAsB,CAAC,UAAkB,EAAE,eAAuB;QACxE,IAAI,CAAC,oBAAoB,CAAC;YACxB,eAAe,EAAE,IAAI,CAAC,cAAc,CAAC,eAAe;YACpD,MAAM,EAAE,wBAAwB;YAChC,eAAe;YACf,UAAU;SACX,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import { DevToolsPluginClient } from './DevToolsPluginClient';\nimport * as logger from './logger';\n\n/**\n * The DevToolsPluginClient for the app -> browser communication.\n */\nexport class DevToolsPluginClientImplApp extends DevToolsPluginClient {\n  // Map of pluginName -> browserClientId\n  private browserClientMap: Record<string, string> = {};\n\n  /**\n   * Initialize the connection.\n   * @hidden\n   */\n  override async initAsync(): Promise<void> {\n    await super.initAsync();\n    this.addHandshakeHandler();\n  }\n\n  private addHandshakeHandler() {\n    this.addHandskakeMessageListener((params) => {\n      if (params.method === 'handshake') {\n        const { pluginName, protocolVersion } = params;\n\n        // [0] Check protocol version\n        if (protocolVersion !== this.connectionInfo.protocolVersion) {\n          // Use console.warn than logger because we want to show the warning even logging is disabled.\n          console.warn(\n            `Received an incompatible devtools plugin handshake message - pluginName[${pluginName}]`\n          );\n          this.terminateBrowserClient(pluginName, params.browserClientId);\n          return;\n        }\n\n        // [1] Terminate duplicated browser clients for the same plugin\n        const previousBrowserClientId = this.browserClientMap[pluginName];\n        if (previousBrowserClientId != null && previousBrowserClientId !== params.browserClientId) {\n          logger.info(\n            `Terminate the previous browser client connection - previousBrowserClientId[${previousBrowserClientId}]`\n          );\n          this.terminateBrowserClient(pluginName, previousBrowserClientId);\n        }\n        this.browserClientMap[pluginName] = params.browserClientId;\n      }\n    });\n  }\n\n  private terminateBrowserClient(pluginName: string, browserClientId: string) {\n    this.sendHandshakeMessage({\n      protocolVersion: this.connectionInfo.protocolVersion,\n      method: 'terminateBrowserClient',\n      browserClientId,\n      pluginName,\n    });\n  }\n}\n"]}

package/build/DevToolsPluginClientImplBrowser.d.ts

@@ -0,0 +1,14 @@
+import { DevToolsPluginClient } from './DevToolsPluginClient';
+/**
+ * The DevToolsPluginClient for the browser -> app communication.
+ */
+export declare class DevToolsPluginClientImplBrowser extends DevToolsPluginClient {
+    private browserClientId;
+    /**
+     * Initialize the connection.
+     * @hidden
+     */
+    initAsync(): Promise<void>;
+    private startHandshake;
+}
+//# sourceMappingURL=DevToolsPluginClientImplBrowser.d.ts.map

package/build/DevToolsPluginClientImplBrowser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevToolsPluginClientImplBrowser.d.ts","sourceRoot":"","sources":["../src/DevToolsPluginClientImplBrowser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAG9D;;GAEG;AACH,qBAAa,+BAAgC,SAAQ,oBAAoB;IACvE,OAAO,CAAC,eAAe,CAAiC;IAExD;;;OAGG;IACY,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAKzC,OAAO,CAAC,cAAc;CAmBvB"}

package/build/DevToolsPluginClientImplBrowser.js

@@ -0,0 +1,32 @@
+import { DevToolsPluginClient } from './DevToolsPluginClient';
+import * as logger from './logger';
+/**
+ * The DevToolsPluginClient for the browser -> app communication.
+ */
+export class DevToolsPluginClientImplBrowser extends DevToolsPluginClient {
+    browserClientId = Date.now().toString();
+    /**
+     * Initialize the connection.
+     * @hidden
+     */
+    async initAsync() {
+        await super.initAsync();
+        this.startHandshake();
+    }
+    startHandshake() {
+        this.addHandskakeMessageListener((params) => {
+            if (params.method === 'terminateBrowserClient' &&
+                this.browserClientId === params.browserClientId) {
+                logger.info('Received terminateBrowserClient messages and terminate the current connection');
+                this.closeAsync();
+            }
+        });
+        this.sendHandshakeMessage({
+            protocolVersion: this.connectionInfo.protocolVersion,
+            pluginName: this.connectionInfo.pluginName,
+            method: 'handshake',
+            browserClientId: this.browserClientId,
+        });
+    }
+}
+//# sourceMappingURL=DevToolsPluginClientImplBrowser.js.map

package/build/DevToolsPluginClientImplBrowser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevToolsPluginClientImplBrowser.js","sourceRoot":"","sources":["../src/DevToolsPluginClientImplBrowser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AAEnC;;GAEG;AACH,MAAM,OAAO,+BAAgC,SAAQ,oBAAoB;IAC/D,eAAe,GAAW,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IAExD;;;OAGG;IACM,KAAK,CAAC,SAAS;QACtB,MAAM,KAAK,CAAC,SAAS,EAAE,CAAC;QACxB,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IAEO,cAAc;QACpB,IAAI,CAAC,2BAA2B,CAAC,CAAC,MAAM,EAAE,EAAE;YAC1C,IACE,MAAM,CAAC,MAAM,KAAK,wBAAwB;gBAC1C,IAAI,CAAC,eAAe,KAAK,MAAM,CAAC,eAAe,EAC/C,CAAC;gBACD,MAAM,CAAC,IAAI,CACT,+EAA+E,CAChF,CAAC;gBACF,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,CAAC;QACH,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,oBAAoB,CAAC;YACxB,eAAe,EAAE,IAAI,CAAC,cAAc,CAAC,eAAe;YACpD,UAAU,EAAE,IAAI,CAAC,cAAc,CAAC,UAAU;YAC1C,MAAM,EAAE,WAAW;YACnB,eAAe,EAAE,IAAI,CAAC,eAAe;SACtC,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import { DevToolsPluginClient } from './DevToolsPluginClient';\nimport * as logger from './logger';\n\n/**\n * The DevToolsPluginClient for the browser -> app communication.\n */\nexport class DevToolsPluginClientImplBrowser extends DevToolsPluginClient {\n  private browserClientId: string = Date.now().toString();\n\n  /**\n   * Initialize the connection.\n   * @hidden\n   */\n  override async initAsync(): Promise<void> {\n    await super.initAsync();\n    this.startHandshake();\n  }\n\n  private startHandshake() {\n    this.addHandskakeMessageListener((params) => {\n      if (\n        params.method === 'terminateBrowserClient' &&\n        this.browserClientId === params.browserClientId\n      ) {\n        logger.info(\n          'Received terminateBrowserClient messages and terminate the current connection'\n        );\n        this.closeAsync();\n      }\n    });\n    this.sendHandshakeMessage({\n      protocolVersion: this.connectionInfo.protocolVersion,\n      pluginName: this.connectionInfo.pluginName,\n      method: 'handshake',\n      browserClientId: this.browserClientId,\n    });\n  }\n}\n"]}

package/build/MessageFramePacker.d.ts

@@ -0,0 +1,50 @@
+/**
+ * A message frame packer that serializes a messageKey and a payload into either a JSON string
+ * (fast path) or a binary format (for complex payloads).
+ *
+ * Fast Path (JSON.stringify/JSON.parse):
+ * - For simple payloads (e.g., strings, numbers, null, undefined, or plain objects), the packer
+ *   uses `JSON.stringify` for serialization and `JSON.parse` for deserialization, ensuring
+ *   optimal performance.
+ *
+ * Binary Format:
+ * - For more complex payloads (e.g., Uint8Array, ArrayBuffer, Blob), the packer uses a binary
+ *   format with the following structure:
+ *
+ *   +------------------+-------------------+----------------------------+--------------------------+
+ *   | 4 bytes (Uint32) | Variable length   | 1 byte (Uint8)             | Variable length          |
+ *   | MessageKeyLength | MessageKey (JSON) | PayloadTypeIndicator (enum)| Payload (binary data)    |
+ *   +------------------+-------------------+----------------------------+--------------------------+
+ *
+ *   1. MessageKeyLength (4 bytes):
+ *      - A 4-byte unsigned integer indicating the length of the MessageKey JSON string.
+ *
+ *   2. MessageKey (Variable length):
+ *      - The JSON string representing the message key, encoded as UTF-8.
+ *
+ *   3. PayloadTypeIndicator (1 byte):
+ *      - A single byte enum value representing the type of the payload (e.g., Uint8Array, String,
+ *        Object, ArrayBuffer, Blob).
+ *
+ *   4. Payload (Variable length):
+ *      - The actual payload data, which can vary in type and length depending on the PayloadType.
+ */
+type MessageKeyTypeBase = string | object;
+type PayloadType = Uint8Array | string | number | null | undefined | object | ArrayBuffer | Blob;
+interface MessageFrame<T extends MessageKeyTypeBase> {
+    messageKey: T;
+    payload?: PayloadType;
+}
+export declare class MessageFramePacker<T extends MessageKeyTypeBase> {
+    private textEncoder;
+    private textDecoder;
+    pack({ messageKey, payload }: MessageFrame<T>): string | Uint8Array | Promise<Uint8Array>;
+    unpack(packedData: string | ArrayBuffer): MessageFrame<T>;
+    private isFastPathPayload;
+    private payloadToUint8Array;
+    private packImpl;
+    private deserializePayload;
+    private static getPayloadTypeIndicator;
+}
+export {};
+//# sourceMappingURL=MessageFramePacker.d.ts.map

package/build/MessageFramePacker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageFramePacker.d.ts","sourceRoot":"","sources":["../src/MessageFramePacker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAIH,KAAK,kBAAkB,GAAG,MAAM,GAAG,MAAM,CAAC;AAC1C,KAAK,WAAW,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;AAajG,UAAU,YAAY,CAAC,CAAC,SAAS,kBAAkB;IACjD,UAAU,EAAE,CAAC,CAAC;IACd,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED,qBAAa,kBAAkB,CAAC,CAAC,SAAS,kBAAkB;IAC1D,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,WAAW,CAAqB;IAEjC,IAAI,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IA2BzF,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC;IA0BhE,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,mBAAmB;IAuB3B,OAAO,CAAC,QAAQ;IA8BhB,OAAO,CAAC,kBAAkB;IAoC1B,OAAO,CAAC,MAAM,CAAC,uBAAuB;CAqBvC"}