@aspectly/transports 0.1.0

package/dist/index.mjs

@@ -0,0 +1,358 @@
+// src/BaseTransport.ts
+var BaseTransport = class {
+  /**
+   * Helper to check if window is defined (for SSR safety)
+   */
+  hasWindow() {
+    return typeof window !== "undefined";
+  }
+  /**
+   * Helper to safely get window object
+   */
+  getWindow() {
+    return this.hasWindow() ? window : null;
+  }
+};
+
+// src/transports/CefSharpTransport.ts
+var CefSharpTransport = class extends BaseTransport {
+  constructor() {
+    super(...arguments);
+    this.name = "cefsharp";
+  }
+  isAvailable() {
+    const win = this.getWindow();
+    return typeof win?.CefSharp?.PostMessage === "function";
+  }
+  send(message) {
+    const win = this.getWindow();
+    if (!win?.CefSharp?.PostMessage) {
+      console.warn("[CefSharpTransport] CefSharp.PostMessage is not available");
+      return;
+    }
+    win.CefSharp.PostMessage(message);
+  }
+  subscribe(listener) {
+    const win = this.getWindow();
+    if (!win) {
+      return () => {
+      };
+    }
+    const handler = (event) => {
+      if (typeof event.data === "string") {
+        listener(event.data);
+      }
+    };
+    win.addEventListener("message", handler);
+    return () => win.removeEventListener("message", handler);
+  }
+};
+var cefSharpDetector = {
+  name: "cefsharp",
+  priority: 100,
+  // Highest priority - check first
+  detect: () => {
+    return typeof window !== "undefined" && typeof window.CefSharp?.PostMessage === "function";
+  },
+  createTransport: () => new CefSharpTransport()
+};
+
+// src/transports/ReactNativeTransport.ts
+var ReactNativeTransport = class extends BaseTransport {
+  constructor() {
+    super(...arguments);
+    this.name = "react-native";
+  }
+  isAvailable() {
+    const win = this.getWindow();
+    return typeof win?.ReactNativeWebView?.postMessage === "function";
+  }
+  send(message) {
+    const win = this.getWindow();
+    if (!win?.ReactNativeWebView?.postMessage) {
+      console.warn("[ReactNativeTransport] ReactNativeWebView.postMessage is not available");
+      return;
+    }
+    win.ReactNativeWebView.postMessage(`'${message}'`);
+  }
+  subscribe(listener) {
+    const win = this.getWindow();
+    if (!win) {
+      return () => {
+      };
+    }
+    const handler = (event) => {
+      if (typeof event.data === "string") {
+        listener(event.data);
+      }
+    };
+    win.addEventListener("message", handler);
+    return () => win.removeEventListener("message", handler);
+  }
+};
+var reactNativeDetector = {
+  name: "react-native",
+  priority: 90,
+  // Second priority
+  detect: () => {
+    return typeof window !== "undefined" && typeof window.ReactNativeWebView?.postMessage === "function";
+  },
+  createTransport: () => new ReactNativeTransport()
+};
+
+// src/transports/IframeTransport.ts
+var IframeTransport = class extends BaseTransport {
+  /**
+   * Create an iframe transport
+   * @param targetOrigin Origin to send messages to (default: '*')
+   */
+  constructor(targetOrigin = "*") {
+    super();
+    this.name = "iframe";
+    this.targetOrigin = targetOrigin;
+  }
+  isAvailable() {
+    const win = this.getWindow();
+    if (!win) return false;
+    return win.parent !== win;
+  }
+  send(message) {
+    const win = this.getWindow();
+    if (!win) {
+      console.warn("[IframeTransport] Window is not available");
+      return;
+    }
+    if (win.parent === win) {
+      console.warn("[IframeTransport] Not inside an iframe");
+      return;
+    }
+    win.parent.postMessage(message, this.targetOrigin);
+  }
+  subscribe(listener) {
+    const win = this.getWindow();
+    if (!win) {
+      return () => {
+      };
+    }
+    const handler = (event) => {
+      if (typeof event.data === "string") {
+        listener(event.data);
+      }
+    };
+    win.addEventListener("message", handler);
+    return () => win.removeEventListener("message", handler);
+  }
+};
+var iframeDetector = {
+  name: "iframe",
+  priority: 80,
+  // Lowest priority - fallback
+  detect: () => {
+    return typeof window !== "undefined" && window.parent !== window;
+  },
+  createTransport: () => new IframeTransport()
+};
+
+// src/transports/WindowTransport.ts
+var WindowTransport = class extends BaseTransport {
+  /**
+   * Create a window transport
+   * @param targetOrigin Origin to send messages to (default: '*')
+   */
+  constructor(targetOrigin = "*") {
+    super();
+    this.name = "window";
+    this.targetOrigin = targetOrigin;
+  }
+  isAvailable() {
+    const win = this.getWindow();
+    if (!win) return false;
+    return win.opener !== null && !win.opener.closed;
+  }
+  send(message) {
+    const win = this.getWindow();
+    if (!win) {
+      console.warn("[WindowTransport] Window is not available");
+      return;
+    }
+    if (!win.opener || win.opener.closed) {
+      console.warn("[WindowTransport] Opener window is not available");
+      return;
+    }
+    win.opener.postMessage(message, this.targetOrigin);
+  }
+  subscribe(listener) {
+    const win = this.getWindow();
+    if (!win) {
+      return () => {
+      };
+    }
+    const handler = (event) => {
+      if (typeof event.data === "string") {
+        listener(event.data);
+      }
+    };
+    win.addEventListener("message", handler);
+    return () => win.removeEventListener("message", handler);
+  }
+};
+var windowDetector = {
+  name: "window",
+  priority: 70,
+  // Below iframe (80), above postmessage (10)
+  detect: () => {
+    try {
+      return typeof window !== "undefined" && window.opener != null && !window.opener.closed;
+    } catch {
+      return false;
+    }
+  },
+  createTransport: () => new WindowTransport()
+};
+
+// src/transports/PostMessageTransport.ts
+var PostMessageTransport = class extends BaseTransport {
+  constructor() {
+    super(...arguments);
+    this.name = "postmessage";
+  }
+  isAvailable() {
+    return typeof this.getWindow()?.addEventListener === "function";
+  }
+  send(message) {
+    const win = this.getWindow();
+    if (!win) return;
+    win.postMessage(message, "*");
+  }
+  subscribe(listener) {
+    const win = this.getWindow();
+    if (!win) {
+      return () => {
+      };
+    }
+    const handler = (event) => {
+      if (typeof event.data === "string") {
+        listener(event.data);
+      }
+    };
+    win.addEventListener("message", handler);
+    return () => win.removeEventListener("message", handler);
+  }
+};
+var postMessageDetector = {
+  name: "postmessage",
+  priority: 10,
+  // Lowest priority — fallback for any browser environment
+  detect: () => {
+    return typeof window !== "undefined" && typeof window.addEventListener === "function";
+  },
+  createTransport: () => new PostMessageTransport()
+};
+
+// src/transports/NullTransport.ts
+var NullTransport = class extends BaseTransport {
+  constructor() {
+    super(...arguments);
+    this.name = "null";
+  }
+  isAvailable() {
+    return true;
+  }
+  send(_message) {
+    if (process.env.NODE_ENV === "development") {
+      console.warn("[NullTransport] No transport available, message not sent");
+    }
+  }
+  subscribe(_listener) {
+    return () => {
+    };
+  }
+};
+
+// src/TransportRegistry.ts
+var TransportRegistryClass = class {
+  constructor() {
+    this.detectors = [];
+    this.cachedTransport = null;
+    this.register(cefSharpDetector);
+    this.register(reactNativeDetector);
+    this.register(iframeDetector);
+    this.register(windowDetector);
+    this.register(postMessageDetector);
+  }
+  /**
+   * Register a custom transport detector
+   * @param detector The detector to register
+   */
+  register(detector) {
+    this.detectors = this.detectors.filter((d) => d.name !== detector.name);
+    this.detectors.push(detector);
+    this.detectors.sort((a, b) => b.priority - a.priority);
+    this.cachedTransport = null;
+  }
+  /**
+   * Unregister a transport detector by name
+   * @param name Name of the detector to remove
+   */
+  unregister(name) {
+    this.detectors = this.detectors.filter((d) => d.name !== name);
+    this.cachedTransport = null;
+  }
+  /**
+   * Get all registered detectors
+   */
+  getDetectors() {
+    return this.detectors;
+  }
+  /**
+   * Detect and return the appropriate transport for the current environment
+   * Results are cached for performance
+   * @param forceRedetect Force re-detection (ignores cache)
+   */
+  detect(forceRedetect = false) {
+    if (this.cachedTransport && !forceRedetect) {
+      return this.cachedTransport;
+    }
+    for (const detector of this.detectors) {
+      try {
+        if (detector.detect()) {
+          this.cachedTransport = detector.createTransport();
+          return this.cachedTransport;
+        }
+      } catch (error) {
+        console.warn(`[TransportRegistry] Detector "${detector.name}" threw an error:`, error);
+      }
+    }
+    this.cachedTransport = new NullTransport();
+    return this.cachedTransport;
+  }
+  /**
+   * Clear the cached transport (useful for testing)
+   */
+  clearCache() {
+    this.cachedTransport = null;
+  }
+  /**
+   * Reset registry to default state (built-in detectors only)
+   */
+  reset() {
+    this.detectors = [];
+    this.cachedTransport = null;
+    this.register(cefSharpDetector);
+    this.register(reactNativeDetector);
+    this.register(iframeDetector);
+    this.register(windowDetector);
+    this.register(postMessageDetector);
+  }
+};
+var TransportRegistry = new TransportRegistryClass();
+var detectTransport = (forceRedetect = false) => {
+  return TransportRegistry.detect(forceRedetect);
+};
+var registerTransport = (detector) => {
+  TransportRegistry.register(detector);
+};
+
+export { BaseTransport, CefSharpTransport, IframeTransport, NullTransport, PostMessageTransport, ReactNativeTransport, TransportRegistry, WindowTransport, cefSharpDetector, detectTransport, iframeDetector, postMessageDetector, reactNativeDetector, registerTransport, windowDetector };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/BaseTransport.ts","../src/transports/CefSharpTransport.ts","../src/transports/ReactNativeTransport.ts","../src/transports/IframeTransport.ts","../src/transports/WindowTransport.ts","../src/transports/PostMessageTransport.ts","../src/transports/NullTransport.ts","../src/TransportRegistry.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import type { Transport, TransportListener, TransportUnsubscribe } from './types';\r\n\r\n/**\r\n * Abstract base class for transports\r\n * Provides common functionality for message handling\r\n */\r\nexport abstract class BaseTransport implements Transport {\r\n  abstract readonly name: string;\r\n\r\n  abstract isAvailable(): boolean;\r\n  abstract send(message: string): void;\r\n  abstract subscribe(listener: TransportListener): TransportUnsubscribe;\r\n\r\n  /**\r\n   * Helper to check if window is defined (for SSR safety)\r\n   */\r\n  protected hasWindow(): boolean {\r\n    return typeof window !== 'undefined';\r\n  }\r\n\r\n  /**\r\n   * Helper to safely get window object\r\n   */\r\n  protected getWindow(): Window | null {\r\n    return this.hasWindow() ? window : null;\r\n  }\r\n}\r\n","import { BaseTransport } from '../BaseTransport';\r\nimport type { TransportListener, TransportUnsubscribe, TransportDetector } from '../types';\r\n\r\ndeclare global {\r\n  interface Window {\r\n    CefSharp?: {\r\n      PostMessage: (message: string) => void;\r\n      BindObjectAsync: (...args: unknown[]) => Promise<void>;\r\n    };\r\n  }\r\n}\r\n\r\n/**\r\n * Transport for CefSharp (Chromium Embedded Framework for .NET)\r\n * Used in desktop applications with embedded Chromium browsers\r\n *\r\n * @example\r\n * ```typescript\r\n * import { CefSharpTransport } from '@aspectly/transports/cefsharp';\r\n *\r\n * const transport = new CefSharpTransport();\r\n * if (transport.isAvailable()) {\r\n *   transport.send(JSON.stringify({ type: 'hello' }));\r\n * }\r\n * ```\r\n */\r\nexport class CefSharpTransport extends BaseTransport {\r\n  readonly name = 'cefsharp';\r\n\r\n  isAvailable(): boolean {\r\n    const win = this.getWindow();\r\n    return typeof win?.CefSharp?.PostMessage === 'function';\r\n  }\r\n\r\n  send(message: string): void {\r\n    const win = this.getWindow();\r\n    if (!win?.CefSharp?.PostMessage) {\r\n      console.warn('[CefSharpTransport] CefSharp.PostMessage is not available');\r\n      return;\r\n    }\r\n    win.CefSharp.PostMessage(message);\r\n  }\r\n\r\n  subscribe(listener: TransportListener): TransportUnsubscribe {\r\n    const win = this.getWindow();\r\n    if (!win) {\r\n      return () => {};\r\n    }\r\n\r\n    // CefSharp sends messages via window.postMessage\r\n    const handler = (event: MessageEvent): void => {\r\n      if (typeof event.data === 'string') {\r\n        listener(event.data);\r\n      }\r\n    };\r\n\r\n    win.addEventListener('message', handler);\r\n    return () => win.removeEventListener('message', handler);\r\n  }\r\n}\r\n\r\n/**\r\n * Detector for auto-detection registry\r\n */\r\nexport const cefSharpDetector: TransportDetector = {\r\n  name: 'cefsharp',\r\n  priority: 100, // Highest priority - check first\r\n  detect: () => {\r\n    return typeof window !== 'undefined' &&\r\n           typeof window.CefSharp?.PostMessage === 'function';\r\n  },\r\n  createTransport: () => new CefSharpTransport(),\r\n};\r\n","import { BaseTransport } from '../BaseTransport';\r\nimport type { TransportListener, TransportUnsubscribe, TransportDetector } from '../types';\r\n\r\ndeclare global {\r\n  interface Window {\r\n    ReactNativeWebView?: {\r\n      postMessage: (message: string) => void;\r\n    };\r\n  }\r\n}\r\n\r\n/**\r\n * Transport for React Native WebView\r\n * Used when web content is displayed inside a React Native app\r\n *\r\n * @example\r\n * ```typescript\r\n * import { ReactNativeTransport } from '@aspectly/transports/react-native';\r\n *\r\n * const transport = new ReactNativeTransport();\r\n * if (transport.isAvailable()) {\r\n *   transport.send(JSON.stringify({ type: 'hello' }));\r\n * }\r\n * ```\r\n */\r\nexport class ReactNativeTransport extends BaseTransport {\r\n  readonly name = 'react-native';\r\n\r\n  isAvailable(): boolean {\r\n    const win = this.getWindow();\r\n    return typeof win?.ReactNativeWebView?.postMessage === 'function';\r\n  }\r\n\r\n  send(message: string): void {\r\n    const win = this.getWindow();\r\n    if (!win?.ReactNativeWebView?.postMessage) {\r\n      console.warn('[ReactNativeTransport] ReactNativeWebView.postMessage is not available');\r\n      return;\r\n    }\r\n    // React Native WebView expects message wrapped in quotes (iOS quirk)\r\n    win.ReactNativeWebView.postMessage(`'${message}'`);\r\n  }\r\n\r\n  subscribe(listener: TransportListener): TransportUnsubscribe {\r\n    const win = this.getWindow();\r\n    if (!win) {\r\n      return () => {};\r\n    }\r\n\r\n    // React Native sends messages via window.postMessage\r\n    const handler = (event: MessageEvent): void => {\r\n      if (typeof event.data === 'string') {\r\n        listener(event.data);\r\n      }\r\n    };\r\n\r\n    win.addEventListener('message', handler);\r\n    return () => win.removeEventListener('message', handler);\r\n  }\r\n}\r\n\r\n/**\r\n * Detector for auto-detection registry\r\n */\r\nexport const reactNativeDetector: TransportDetector = {\r\n  name: 'react-native',\r\n  priority: 90, // Second priority\r\n  detect: () => {\r\n    return typeof window !== 'undefined' &&\r\n           typeof window.ReactNativeWebView?.postMessage === 'function';\r\n  },\r\n  createTransport: () => new ReactNativeTransport(),\r\n};\r\n","import { BaseTransport } from '../BaseTransport';\r\nimport type { TransportListener, TransportUnsubscribe, TransportDetector } from '../types';\r\n\r\n/**\r\n * Transport for iframe/window.postMessage communication\r\n * Used when web content is displayed inside an iframe\r\n *\r\n * @example\r\n * ```typescript\r\n * import { IframeTransport } from '@aspectly/transports/iframe';\r\n *\r\n * const transport = new IframeTransport();\r\n * if (transport.isAvailable()) {\r\n *   transport.send(JSON.stringify({ type: 'hello' }));\r\n * }\r\n * ```\r\n */\r\nexport class IframeTransport extends BaseTransport {\r\n  readonly name = 'iframe';\r\n  private readonly targetOrigin: string;\r\n\r\n  /**\r\n   * Create an iframe transport\r\n   * @param targetOrigin Origin to send messages to (default: '*')\r\n   */\r\n  constructor(targetOrigin: string = '*') {\r\n    super();\r\n    this.targetOrigin = targetOrigin;\r\n  }\r\n\r\n  isAvailable(): boolean {\r\n    const win = this.getWindow();\r\n    if (!win) return false;\r\n    // Check if we're inside an iframe (parent !== self)\r\n    return win.parent !== win;\r\n  }\r\n\r\n  send(message: string): void {\r\n    const win = this.getWindow();\r\n    if (!win) {\r\n      console.warn('[IframeTransport] Window is not available');\r\n      return;\r\n    }\r\n    if (win.parent === win) {\r\n      console.warn('[IframeTransport] Not inside an iframe');\r\n      return;\r\n    }\r\n    win.parent.postMessage(message, this.targetOrigin);\r\n  }\r\n\r\n  subscribe(listener: TransportListener): TransportUnsubscribe {\r\n    const win = this.getWindow();\r\n    if (!win) {\r\n      return () => {};\r\n    }\r\n\r\n    const handler = (event: MessageEvent): void => {\r\n      // Optionally filter by origin here if targetOrigin !== '*'\r\n      if (typeof event.data === 'string') {\r\n        listener(event.data);\r\n      }\r\n    };\r\n\r\n    win.addEventListener('message', handler);\r\n    return () => win.removeEventListener('message', handler);\r\n  }\r\n}\r\n\r\n/**\r\n * Detector for auto-detection registry\r\n */\r\nexport const iframeDetector: TransportDetector = {\r\n  name: 'iframe',\r\n  priority: 80, // Lowest priority - fallback\r\n  detect: () => {\r\n    return typeof window !== 'undefined' && window.parent !== window;\r\n  },\r\n  createTransport: () => new IframeTransport(),\r\n};\r\n","import { BaseTransport } from '../BaseTransport';\nimport type { TransportListener, TransportUnsubscribe, TransportDetector } from '../types';\n\n/**\n * Transport for popup windows opened via window.open()\n * Used when web content is displayed in a child window\n *\n * @example\n * ```typescript\n * // In child window (opened via window.open())\n * import { WindowTransport } from '@aspectly/transports/window';\n *\n * const transport = new WindowTransport();\n * if (transport.isAvailable()) {\n *   transport.send(JSON.stringify({ type: 'hello' }));\n * }\n * ```\n */\nexport class WindowTransport extends BaseTransport {\n  readonly name = 'window';\n  private readonly targetOrigin: string;\n\n  /**\n   * Create a window transport\n   * @param targetOrigin Origin to send messages to (default: '*')\n   */\n  constructor(targetOrigin: string = '*') {\n    super();\n    this.targetOrigin = targetOrigin;\n  }\n\n  isAvailable(): boolean {\n    const win = this.getWindow();\n    if (!win) return false;\n    return win.opener !== null && !win.opener.closed;\n  }\n\n  send(message: string): void {\n    const win = this.getWindow();\n    if (!win) {\n      console.warn('[WindowTransport] Window is not available');\n      return;\n    }\n    if (!win.opener || win.opener.closed) {\n      console.warn('[WindowTransport] Opener window is not available');\n      return;\n    }\n    win.opener.postMessage(message, this.targetOrigin);\n  }\n\n  subscribe(listener: TransportListener): TransportUnsubscribe {\n    const win = this.getWindow();\n    if (!win) {\n      return () => {};\n    }\n\n    const handler = (event: MessageEvent): void => {\n      if (typeof event.data === 'string') {\n        listener(event.data);\n      }\n    };\n\n    win.addEventListener('message', handler);\n    return () => win.removeEventListener('message', handler);\n  }\n}\n\n/**\n * Detector for auto-detection registry\n */\nexport const windowDetector: TransportDetector = {\n  name: 'window',\n  priority: 70, // Below iframe (80), above postmessage (10)\n  detect: () => {\n    try {\n      return typeof window !== 'undefined' &&\n        window.opener != null &&\n        !window.opener.closed;\n    } catch {\n      return false;\n    }\n  },\n  createTransport: () => new WindowTransport(),\n};\n","import { BaseTransport } from '../BaseTransport';\r\nimport type { TransportListener, TransportUnsubscribe, TransportDetector } from '../types';\r\n\r\n/**\r\n * Fallback transport for browser environments.\r\n * Listens for window.postMessage events, allowing parent windows\r\n * to receive messages from child iframes.\r\n */\r\nexport class PostMessageTransport extends BaseTransport {\r\n  readonly name = 'postmessage';\r\n\r\n  isAvailable(): boolean {\r\n    return typeof this.getWindow()?.addEventListener === 'function';\r\n  }\r\n\r\n  send(message: string): void {\r\n    const win = this.getWindow();\r\n    if (!win) return;\r\n    win.postMessage(message, '*');\r\n  }\r\n\r\n  subscribe(listener: TransportListener): TransportUnsubscribe {\r\n    const win = this.getWindow();\r\n    if (!win) {\r\n      return () => {};\r\n    }\r\n\r\n    const handler = (event: MessageEvent): void => {\r\n      if (typeof event.data === 'string') {\r\n        listener(event.data);\r\n      }\r\n    };\r\n\r\n    win.addEventListener('message', handler);\r\n    return () => win.removeEventListener('message', handler);\r\n  }\r\n}\r\n\r\n/**\r\n * Detector for auto-detection registry\r\n */\r\nexport const postMessageDetector: TransportDetector = {\r\n  name: 'postmessage',\r\n  priority: 10, // Lowest priority — fallback for any browser environment\r\n  detect: () => {\r\n    return typeof window !== 'undefined' &&\r\n           typeof window.addEventListener === 'function';\r\n  },\r\n  createTransport: () => new PostMessageTransport(),\r\n};\r\n","import { BaseTransport } from '../BaseTransport';\r\nimport type { TransportListener, TransportUnsubscribe } from '../types';\r\n\r\n/**\r\n * Null transport - used when no transport is available\r\n * All operations are no-ops. Useful for SSR or testing.\r\n */\r\nexport class NullTransport extends BaseTransport {\r\n  readonly name = 'null';\r\n\r\n  isAvailable(): boolean {\r\n    // Always \"available\" as a fallback, but does nothing\r\n    return true;\r\n  }\r\n\r\n  send(_message: string): void {\r\n    // No-op\r\n    if (process.env.NODE_ENV === 'development') {\r\n      console.warn('[NullTransport] No transport available, message not sent');\r\n    }\r\n  }\r\n\r\n  subscribe(_listener: TransportListener): TransportUnsubscribe {\r\n    // No-op\r\n    return () => {};\r\n  }\r\n}\r\n","import type { Transport, TransportDetector } from './types';\r\nimport { cefSharpDetector } from './transports/CefSharpTransport';\r\nimport { reactNativeDetector } from './transports/ReactNativeTransport';\r\nimport { iframeDetector } from './transports/IframeTransport';\r\nimport { windowDetector } from './transports/WindowTransport';\r\nimport { postMessageDetector } from './transports/PostMessageTransport';\r\nimport { NullTransport } from './transports/NullTransport';\r\n\r\n/**\r\n * Registry for transport detectors\r\n * Manages auto-detection of the current environment\r\n */\r\nclass TransportRegistryClass {\r\n  private detectors: TransportDetector[] = [];\r\n  private cachedTransport: Transport | null = null;\r\n\r\n  constructor() {\r\n    // Register built-in detectors\r\n    this.register(cefSharpDetector);\r\n    this.register(reactNativeDetector);\r\n    this.register(iframeDetector);\r\n    this.register(windowDetector);\r\n    this.register(postMessageDetector);\r\n  }\r\n\r\n  /**\r\n   * Register a custom transport detector\r\n   * @param detector The detector to register\r\n   */\r\n  register(detector: TransportDetector): void {\r\n    // Remove existing detector with same name\r\n    this.detectors = this.detectors.filter(d => d.name !== detector.name);\r\n    this.detectors.push(detector);\r\n    // Sort by priority (descending)\r\n    this.detectors.sort((a, b) => b.priority - a.priority);\r\n    // Clear cache when detectors change\r\n    this.cachedTransport = null;\r\n  }\r\n\r\n  /**\r\n   * Unregister a transport detector by name\r\n   * @param name Name of the detector to remove\r\n   */\r\n  unregister(name: string): void {\r\n    this.detectors = this.detectors.filter(d => d.name !== name);\r\n    this.cachedTransport = null;\r\n  }\r\n\r\n  /**\r\n   * Get all registered detectors\r\n   */\r\n  getDetectors(): readonly TransportDetector[] {\r\n    return this.detectors;\r\n  }\r\n\r\n  /**\r\n   * Detect and return the appropriate transport for the current environment\r\n   * Results are cached for performance\r\n   * @param forceRedetect Force re-detection (ignores cache)\r\n   */\r\n  detect(forceRedetect = false): Transport {\r\n    if (this.cachedTransport && !forceRedetect) {\r\n      return this.cachedTransport;\r\n    }\r\n\r\n    for (const detector of this.detectors) {\r\n      try {\r\n        if (detector.detect()) {\r\n          this.cachedTransport = detector.createTransport();\r\n          return this.cachedTransport;\r\n        }\r\n      } catch (error) {\r\n        console.warn(`[TransportRegistry] Detector \"${detector.name}\" threw an error:`, error);\r\n      }\r\n    }\r\n\r\n    // No transport detected, return NullTransport\r\n    this.cachedTransport = new NullTransport();\r\n    return this.cachedTransport;\r\n  }\r\n\r\n  /**\r\n   * Clear the cached transport (useful for testing)\r\n   */\r\n  clearCache(): void {\r\n    this.cachedTransport = null;\r\n  }\r\n\r\n  /**\r\n   * Reset registry to default state (built-in detectors only)\r\n   */\r\n  reset(): void {\r\n    this.detectors = [];\r\n    this.cachedTransport = null;\r\n    this.register(cefSharpDetector);\r\n    this.register(reactNativeDetector);\r\n    this.register(iframeDetector);\r\n    this.register(windowDetector);\r\n    this.register(postMessageDetector);\r\n  }\r\n}\r\n\r\n/**\r\n * Global transport registry instance\r\n */\r\nexport const TransportRegistry = new TransportRegistryClass();\r\n\r\n/**\r\n * Convenience function to detect transport\r\n */\r\nexport const detectTransport = (forceRedetect = false): Transport => {\r\n  return TransportRegistry.detect(forceRedetect);\r\n};\r\n\r\n/**\r\n * Convenience function to register a custom detector\r\n */\r\nexport const registerTransport = (detector: TransportDetector): void => {\r\n  TransportRegistry.register(detector);\r\n};\r\n"]}

package/dist/react-native.d.mts

@@ -0,0 +1,36 @@
+import { B as BaseTransport, T as TransportListener, a as TransportUnsubscribe, b as TransportDetector } from './BaseTransport-CxzIr1Ds.mjs';
+export { c as Transport } from './BaseTransport-CxzIr1Ds.mjs';
+
+declare global {
+    interface Window {
+        ReactNativeWebView?: {
+            postMessage: (message: string) => void;
+        };
+    }
+}
+/**
+ * Transport for React Native WebView
+ * Used when web content is displayed inside a React Native app
+ *
+ * @example
+ * ```typescript
+ * import { ReactNativeTransport } from '@aspectly/transports/react-native';
+ *
+ * const transport = new ReactNativeTransport();
+ * if (transport.isAvailable()) {
+ *   transport.send(JSON.stringify({ type: 'hello' }));
+ * }
+ * ```
+ */
+declare class ReactNativeTransport extends BaseTransport {
+    readonly name = "react-native";
+    isAvailable(): boolean;
+    send(message: string): void;
+    subscribe(listener: TransportListener): TransportUnsubscribe;
+}
+/**
+ * Detector for auto-detection registry
+ */
+declare const reactNativeDetector: TransportDetector;
+
+export { ReactNativeTransport, TransportListener, TransportUnsubscribe, reactNativeDetector };

package/dist/react-native.d.ts

@@ -0,0 +1,36 @@
+import { B as BaseTransport, T as TransportListener, a as TransportUnsubscribe, b as TransportDetector } from './BaseTransport-CxzIr1Ds.js';
+export { c as Transport } from './BaseTransport-CxzIr1Ds.js';
+
+declare global {
+    interface Window {
+        ReactNativeWebView?: {
+            postMessage: (message: string) => void;
+        };
+    }
+}
+/**
+ * Transport for React Native WebView
+ * Used when web content is displayed inside a React Native app
+ *
+ * @example
+ * ```typescript
+ * import { ReactNativeTransport } from '@aspectly/transports/react-native';
+ *
+ * const transport = new ReactNativeTransport();
+ * if (transport.isAvailable()) {
+ *   transport.send(JSON.stringify({ type: 'hello' }));
+ * }
+ * ```
+ */
+declare class ReactNativeTransport extends BaseTransport {
+    readonly name = "react-native";
+    isAvailable(): boolean;
+    send(message: string): void;
+    subscribe(listener: TransportListener): TransportUnsubscribe;
+}
+/**
+ * Detector for auto-detection registry
+ */
+declare const reactNativeDetector: TransportDetector;
+
+export { ReactNativeTransport, TransportListener, TransportUnsubscribe, reactNativeDetector };

package/dist/react-native.js

@@ -0,0 +1,65 @@
+'use strict';
+
+// src/BaseTransport.ts
+var BaseTransport = class {
+  /**
+   * Helper to check if window is defined (for SSR safety)
+   */
+  hasWindow() {
+    return typeof window !== "undefined";
+  }
+  /**
+   * Helper to safely get window object
+   */
+  getWindow() {
+    return this.hasWindow() ? window : null;
+  }
+};
+
+// src/transports/ReactNativeTransport.ts
+var ReactNativeTransport = class extends BaseTransport {
+  constructor() {
+    super(...arguments);
+    this.name = "react-native";
+  }
+  isAvailable() {
+    const win = this.getWindow();
+    return typeof win?.ReactNativeWebView?.postMessage === "function";
+  }
+  send(message) {
+    const win = this.getWindow();
+    if (!win?.ReactNativeWebView?.postMessage) {
+      console.warn("[ReactNativeTransport] ReactNativeWebView.postMessage is not available");
+      return;
+    }
+    win.ReactNativeWebView.postMessage(`'${message}'`);
+  }
+  subscribe(listener) {
+    const win = this.getWindow();
+    if (!win) {
+      return () => {
+      };
+    }
+    const handler = (event) => {
+      if (typeof event.data === "string") {
+        listener(event.data);
+      }
+    };
+    win.addEventListener("message", handler);
+    return () => win.removeEventListener("message", handler);
+  }
+};
+var reactNativeDetector = {
+  name: "react-native",
+  priority: 90,
+  // Second priority
+  detect: () => {
+    return typeof window !== "undefined" && typeof window.ReactNativeWebView?.postMessage === "function";
+  },
+  createTransport: () => new ReactNativeTransport()
+};
+
+exports.ReactNativeTransport = ReactNativeTransport;
+exports.reactNativeDetector = reactNativeDetector;
+//# sourceMappingURL=react-native.js.map
+//# sourceMappingURL=react-native.js.map

package/dist/react-native.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/BaseTransport.ts","../src/transports/ReactNativeTransport.ts"],"names":[],"mappings":";;;AAMO,IAAe,gBAAf,MAAkD;AAAA;AAAA;AAAA;AAAA,EAU7C,SAAA,GAAqB;AAC7B,IAAA,OAAO,OAAO,MAAA,KAAW,WAAA;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA,EAKU,SAAA,GAA2B;AACnC,IAAA,OAAO,IAAA,CAAK,SAAA,EAAU,GAAI,MAAA,GAAS,IAAA;AAAA,EACrC;AACF,CAAA;;;ACDO,IAAM,oBAAA,GAAN,cAAmC,aAAA,CAAc;AAAA,EAAjD,WAAA,GAAA;AAAA,IAAA,KAAA,CAAA,GAAA,SAAA,CAAA;AACL,IAAA,IAAA,CAAS,IAAA,GAAO,cAAA;AAAA,EAAA;AAAA,EAEhB,WAAA,GAAuB;AACrB,IAAA,MAAM,GAAA,GAAM,KAAK,SAAA,EAAU;AAC3B,IAAA,OAAO,OAAO,GAAA,EAAK,kBAAA,EAAoB,WAAA,KAAgB,UAAA;AAAA,EACzD;AAAA,EAEA,KAAK,OAAA,EAAuB;AAC1B,IAAA,MAAM,GAAA,GAAM,KAAK,SAAA,EAAU;AAC3B,IAAA,IAAI,CAAC,GAAA,EAAK,kBAAA,EAAoB,WAAA,EAAa;AACzC,MAAA,OAAA,CAAQ,KAAK,wEAAwE,CAAA;AACrF,MAAA;AAAA,IACF;AAEA,IAAA,GAAA,CAAI,kBAAA,CAAmB,WAAA,CAAY,CAAA,CAAA,EAAI,OAAO,CAAA,CAAA,CAAG,CAAA;AAAA,EACnD;AAAA,EAEA,UAAU,QAAA,EAAmD;AAC3D,IAAA,MAAM,GAAA,GAAM,KAAK,SAAA,EAAU;AAC3B,IAAA,IAAI,CAAC,GAAA,EAAK;AACR,MAAA,OAAO,MAAM;AAAA,MAAC,CAAA;AAAA,IAChB;AAGA,IAAA,MAAM,OAAA,GAAU,CAAC,KAAA,KAA8B;AAC7C,MAAA,IAAI,OAAO,KAAA,CAAM,IAAA,KAAS,QAAA,EAAU;AAClC,QAAA,QAAA,CAAS,MAAM,IAAI,CAAA;AAAA,MACrB;AAAA,IACF,CAAA;AAEA,IAAA,GAAA,CAAI,gBAAA,CAAiB,WAAW,OAAO,CAAA;AACvC,IAAA,OAAO,MAAM,GAAA,CAAI,mBAAA,CAAoB,SAAA,EAAW,OAAO,CAAA;AAAA,EACzD;AACF;AAKO,IAAM,mBAAA,GAAyC;AAAA,EACpD,IAAA,EAAM,cAAA;AAAA,EACN,QAAA,EAAU,EAAA;AAAA;AAAA,EACV,QAAQ,MAAM;AACZ,IAAA,OAAO,OAAO,MAAA,KAAW,WAAA,IAClB,OAAO,MAAA,CAAO,oBAAoB,WAAA,KAAgB,UAAA;AAAA,EAC3D,CAAA;AAAA,EACA,eAAA,EAAiB,MAAM,IAAI,oBAAA;AAC7B","file":"react-native.js","sourcesContent":["import type { Transport, TransportListener, TransportUnsubscribe } from './types';\r\n\r\n/**\r\n * Abstract base class for transports\r\n * Provides common functionality for message handling\r\n */\r\nexport abstract class BaseTransport implements Transport {\r\n  abstract readonly name: string;\r\n\r\n  abstract isAvailable(): boolean;\r\n  abstract send(message: string): void;\r\n  abstract subscribe(listener: TransportListener): TransportUnsubscribe;\r\n\r\n  /**\r\n   * Helper to check if window is defined (for SSR safety)\r\n   */\r\n  protected hasWindow(): boolean {\r\n    return typeof window !== 'undefined';\r\n  }\r\n\r\n  /**\r\n   * Helper to safely get window object\r\n   */\r\n  protected getWindow(): Window | null {\r\n    return this.hasWindow() ? window : null;\r\n  }\r\n}\r\n","import { BaseTransport } from '../BaseTransport';\r\nimport type { TransportListener, TransportUnsubscribe, TransportDetector } from '../types';\r\n\r\ndeclare global {\r\n  interface Window {\r\n    ReactNativeWebView?: {\r\n      postMessage: (message: string) => void;\r\n    };\r\n  }\r\n}\r\n\r\n/**\r\n * Transport for React Native WebView\r\n * Used when web content is displayed inside a React Native app\r\n *\r\n * @example\r\n * ```typescript\r\n * import { ReactNativeTransport } from '@aspectly/transports/react-native';\r\n *\r\n * const transport = new ReactNativeTransport();\r\n * if (transport.isAvailable()) {\r\n *   transport.send(JSON.stringify({ type: 'hello' }));\r\n * }\r\n * ```\r\n */\r\nexport class ReactNativeTransport extends BaseTransport {\r\n  readonly name = 'react-native';\r\n\r\n  isAvailable(): boolean {\r\n    const win = this.getWindow();\r\n    return typeof win?.ReactNativeWebView?.postMessage === 'function';\r\n  }\r\n\r\n  send(message: string): void {\r\n    const win = this.getWindow();\r\n    if (!win?.ReactNativeWebView?.postMessage) {\r\n      console.warn('[ReactNativeTransport] ReactNativeWebView.postMessage is not available');\r\n      return;\r\n    }\r\n    // React Native WebView expects message wrapped in quotes (iOS quirk)\r\n    win.ReactNativeWebView.postMessage(`'${message}'`);\r\n  }\r\n\r\n  subscribe(listener: TransportListener): TransportUnsubscribe {\r\n    const win = this.getWindow();\r\n    if (!win) {\r\n      return () => {};\r\n    }\r\n\r\n    // React Native sends messages via window.postMessage\r\n    const handler = (event: MessageEvent): void => {\r\n      if (typeof event.data === 'string') {\r\n        listener(event.data);\r\n      }\r\n    };\r\n\r\n    win.addEventListener('message', handler);\r\n    return () => win.removeEventListener('message', handler);\r\n  }\r\n}\r\n\r\n/**\r\n * Detector for auto-detection registry\r\n */\r\nexport const reactNativeDetector: TransportDetector = {\r\n  name: 'react-native',\r\n  priority: 90, // Second priority\r\n  detect: () => {\r\n    return typeof window !== 'undefined' &&\r\n           typeof window.ReactNativeWebView?.postMessage === 'function';\r\n  },\r\n  createTransport: () => new ReactNativeTransport(),\r\n};\r\n"]}

package/dist/react-native.mjs

@@ -0,0 +1,62 @@
+// src/BaseTransport.ts
+var BaseTransport = class {
+  /**
+   * Helper to check if window is defined (for SSR safety)
+   */
+  hasWindow() {
+    return typeof window !== "undefined";
+  }
+  /**
+   * Helper to safely get window object
+   */
+  getWindow() {
+    return this.hasWindow() ? window : null;
+  }
+};
+
+// src/transports/ReactNativeTransport.ts
+var ReactNativeTransport = class extends BaseTransport {
+  constructor() {
+    super(...arguments);
+    this.name = "react-native";
+  }
+  isAvailable() {
+    const win = this.getWindow();
+    return typeof win?.ReactNativeWebView?.postMessage === "function";
+  }
+  send(message) {
+    const win = this.getWindow();
+    if (!win?.ReactNativeWebView?.postMessage) {
+      console.warn("[ReactNativeTransport] ReactNativeWebView.postMessage is not available");
+      return;
+    }
+    win.ReactNativeWebView.postMessage(`'${message}'`);
+  }
+  subscribe(listener) {
+    const win = this.getWindow();
+    if (!win) {
+      return () => {
+      };
+    }
+    const handler = (event) => {
+      if (typeof event.data === "string") {
+        listener(event.data);
+      }
+    };
+    win.addEventListener("message", handler);
+    return () => win.removeEventListener("message", handler);
+  }
+};
+var reactNativeDetector = {
+  name: "react-native",
+  priority: 90,
+  // Second priority
+  detect: () => {
+    return typeof window !== "undefined" && typeof window.ReactNativeWebView?.postMessage === "function";
+  },
+  createTransport: () => new ReactNativeTransport()
+};
+
+export { ReactNativeTransport, reactNativeDetector };
+//# sourceMappingURL=react-native.mjs.map
+//# sourceMappingURL=react-native.mjs.map

package/dist/react-native.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/BaseTransport.ts","../src/transports/ReactNativeTransport.ts"],"names":[],"mappings":";AAMO,IAAe,gBAAf,MAAkD;AAAA;AAAA;AAAA;AAAA,EAU7C,SAAA,GAAqB;AAC7B,IAAA,OAAO,OAAO,MAAA,KAAW,WAAA;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA,EAKU,SAAA,GAA2B;AACnC,IAAA,OAAO,IAAA,CAAK,SAAA,EAAU,GAAI,MAAA,GAAS,IAAA;AAAA,EACrC;AACF,CAAA;;;ACDO,IAAM,oBAAA,GAAN,cAAmC,aAAA,CAAc;AAAA,EAAjD,WAAA,GAAA;AAAA,IAAA,KAAA,CAAA,GAAA,SAAA,CAAA;AACL,IAAA,IAAA,CAAS,IAAA,GAAO,cAAA;AAAA,EAAA;AAAA,EAEhB,WAAA,GAAuB;AACrB,IAAA,MAAM,GAAA,GAAM,KAAK,SAAA,EAAU;AAC3B,IAAA,OAAO,OAAO,GAAA,EAAK,kBAAA,EAAoB,WAAA,KAAgB,UAAA;AAAA,EACzD;AAAA,EAEA,KAAK,OAAA,EAAuB;AAC1B,IAAA,MAAM,GAAA,GAAM,KAAK,SAAA,EAAU;AAC3B,IAAA,IAAI,CAAC,GAAA,EAAK,kBAAA,EAAoB,WAAA,EAAa;AACzC,MAAA,OAAA,CAAQ,KAAK,wEAAwE,CAAA;AACrF,MAAA;AAAA,IACF;AAEA,IAAA,GAAA,CAAI,kBAAA,CAAmB,WAAA,CAAY,CAAA,CAAA,EAAI,OAAO,CAAA,CAAA,CAAG,CAAA;AAAA,EACnD;AAAA,EAEA,UAAU,QAAA,EAAmD;AAC3D,IAAA,MAAM,GAAA,GAAM,KAAK,SAAA,EAAU;AAC3B,IAAA,IAAI,CAAC,GAAA,EAAK;AACR,MAAA,OAAO,MAAM;AAAA,MAAC,CAAA;AAAA,IAChB;AAGA,IAAA,MAAM,OAAA,GAAU,CAAC,KAAA,KAA8B;AAC7C,MAAA,IAAI,OAAO,KAAA,CAAM,IAAA,KAAS,QAAA,EAAU;AAClC,QAAA,QAAA,CAAS,MAAM,IAAI,CAAA;AAAA,MACrB;AAAA,IACF,CAAA;AAEA,IAAA,GAAA,CAAI,gBAAA,CAAiB,WAAW,OAAO,CAAA;AACvC,IAAA,OAAO,MAAM,GAAA,CAAI,mBAAA,CAAoB,SAAA,EAAW,OAAO,CAAA;AAAA,EACzD;AACF;AAKO,IAAM,mBAAA,GAAyC;AAAA,EACpD,IAAA,EAAM,cAAA;AAAA,EACN,QAAA,EAAU,EAAA;AAAA;AAAA,EACV,QAAQ,MAAM;AACZ,IAAA,OAAO,OAAO,MAAA,KAAW,WAAA,IAClB,OAAO,MAAA,CAAO,oBAAoB,WAAA,KAAgB,UAAA;AAAA,EAC3D,CAAA;AAAA,EACA,eAAA,EAAiB,MAAM,IAAI,oBAAA;AAC7B","file":"react-native.mjs","sourcesContent":["import type { Transport, TransportListener, TransportUnsubscribe } from './types';\r\n\r\n/**\r\n * Abstract base class for transports\r\n * Provides common functionality for message handling\r\n */\r\nexport abstract class BaseTransport implements Transport {\r\n  abstract readonly name: string;\r\n\r\n  abstract isAvailable(): boolean;\r\n  abstract send(message: string): void;\r\n  abstract subscribe(listener: TransportListener): TransportUnsubscribe;\r\n\r\n  /**\r\n   * Helper to check if window is defined (for SSR safety)\r\n   */\r\n  protected hasWindow(): boolean {\r\n    return typeof window !== 'undefined';\r\n  }\r\n\r\n  /**\r\n   * Helper to safely get window object\r\n   */\r\n  protected getWindow(): Window | null {\r\n    return this.hasWindow() ? window : null;\r\n  }\r\n}\r\n","import { BaseTransport } from '../BaseTransport';\r\nimport type { TransportListener, TransportUnsubscribe, TransportDetector } from '../types';\r\n\r\ndeclare global {\r\n  interface Window {\r\n    ReactNativeWebView?: {\r\n      postMessage: (message: string) => void;\r\n    };\r\n  }\r\n}\r\n\r\n/**\r\n * Transport for React Native WebView\r\n * Used when web content is displayed inside a React Native app\r\n *\r\n * @example\r\n * ```typescript\r\n * import { ReactNativeTransport } from '@aspectly/transports/react-native';\r\n *\r\n * const transport = new ReactNativeTransport();\r\n * if (transport.isAvailable()) {\r\n *   transport.send(JSON.stringify({ type: 'hello' }));\r\n * }\r\n * ```\r\n */\r\nexport class ReactNativeTransport extends BaseTransport {\r\n  readonly name = 'react-native';\r\n\r\n  isAvailable(): boolean {\r\n    const win = this.getWindow();\r\n    return typeof win?.ReactNativeWebView?.postMessage === 'function';\r\n  }\r\n\r\n  send(message: string): void {\r\n    const win = this.getWindow();\r\n    if (!win?.ReactNativeWebView?.postMessage) {\r\n      console.warn('[ReactNativeTransport] ReactNativeWebView.postMessage is not available');\r\n      return;\r\n    }\r\n    // React Native WebView expects message wrapped in quotes (iOS quirk)\r\n    win.ReactNativeWebView.postMessage(`'${message}'`);\r\n  }\r\n\r\n  subscribe(listener: TransportListener): TransportUnsubscribe {\r\n    const win = this.getWindow();\r\n    if (!win) {\r\n      return () => {};\r\n    }\r\n\r\n    // React Native sends messages via window.postMessage\r\n    const handler = (event: MessageEvent): void => {\r\n      if (typeof event.data === 'string') {\r\n        listener(event.data);\r\n      }\r\n    };\r\n\r\n    win.addEventListener('message', handler);\r\n    return () => win.removeEventListener('message', handler);\r\n  }\r\n}\r\n\r\n/**\r\n * Detector for auto-detection registry\r\n */\r\nexport const reactNativeDetector: TransportDetector = {\r\n  name: 'react-native',\r\n  priority: 90, // Second priority\r\n  detect: () => {\r\n    return typeof window !== 'undefined' &&\r\n           typeof window.ReactNativeWebView?.postMessage === 'function';\r\n  },\r\n  createTransport: () => new ReactNativeTransport(),\r\n};\r\n"]}

package/dist/window.d.mts

@@ -0,0 +1,36 @@
+import { B as BaseTransport, T as TransportListener, a as TransportUnsubscribe, b as TransportDetector } from './BaseTransport-CxzIr1Ds.mjs';
+export { c as Transport } from './BaseTransport-CxzIr1Ds.mjs';
+
+/**
+ * Transport for popup windows opened via window.open()
+ * Used when web content is displayed in a child window
+ *
+ * @example
+ * ```typescript
+ * // In child window (opened via window.open())
+ * import { WindowTransport } from '@aspectly/transports/window';
+ *
+ * const transport = new WindowTransport();
+ * if (transport.isAvailable()) {
+ *   transport.send(JSON.stringify({ type: 'hello' }));
+ * }
+ * ```
+ */
+declare class WindowTransport extends BaseTransport {
+    readonly name = "window";
+    private readonly targetOrigin;
+    /**
+     * Create a window transport
+     * @param targetOrigin Origin to send messages to (default: '*')
+     */
+    constructor(targetOrigin?: string);
+    isAvailable(): boolean;
+    send(message: string): void;
+    subscribe(listener: TransportListener): TransportUnsubscribe;
+}
+/**
+ * Detector for auto-detection registry
+ */
+declare const windowDetector: TransportDetector;
+
+export { TransportListener, TransportUnsubscribe, WindowTransport, windowDetector };