@aspectly/transports 0.1.0

package/dist/cefsharp.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/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()
+};
+
+export { CefSharpTransport, cefSharpDetector };
+//# sourceMappingURL=cefsharp.mjs.map
+//# sourceMappingURL=cefsharp.mjs.map

package/dist/cefsharp.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/BaseTransport.ts","../src/transports/CefSharpTransport.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;;;ACAO,IAAM,iBAAA,GAAN,cAAgC,aAAA,CAAc;AAAA,EAA9C,WAAA,GAAA;AAAA,IAAA,KAAA,CAAA,GAAA,SAAA,CAAA;AACL,IAAA,IAAA,CAAS,IAAA,GAAO,UAAA;AAAA,EAAA;AAAA,EAEhB,WAAA,GAAuB;AACrB,IAAA,MAAM,GAAA,GAAM,KAAK,SAAA,EAAU;AAC3B,IAAA,OAAO,OAAO,GAAA,EAAK,QAAA,EAAU,WAAA,KAAgB,UAAA;AAAA,EAC/C;AAAA,EAEA,KAAK,OAAA,EAAuB;AAC1B,IAAA,MAAM,GAAA,GAAM,KAAK,SAAA,EAAU;AAC3B,IAAA,IAAI,CAAC,GAAA,EAAK,QAAA,EAAU,WAAA,EAAa;AAC/B,MAAA,OAAA,CAAQ,KAAK,2DAA2D,CAAA;AACxE,MAAA;AAAA,IACF;AACA,IAAA,GAAA,CAAI,QAAA,CAAS,YAAY,OAAO,CAAA;AAAA,EAClC;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,gBAAA,GAAsC;AAAA,EACjD,IAAA,EAAM,UAAA;AAAA,EACN,QAAA,EAAU,GAAA;AAAA;AAAA,EACV,QAAQ,MAAM;AACZ,IAAA,OAAO,OAAO,MAAA,KAAW,WAAA,IAClB,OAAO,MAAA,CAAO,UAAU,WAAA,KAAgB,UAAA;AAAA,EACjD,CAAA;AAAA,EACA,eAAA,EAAiB,MAAM,IAAI,iBAAA;AAC7B","file":"cefsharp.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"]}

package/dist/iframe.d.mts

@@ -0,0 +1,35 @@
+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 iframe/window.postMessage communication
+ * Used when web content is displayed inside an iframe
+ *
+ * @example
+ * ```typescript
+ * import { IframeTransport } from '@aspectly/transports/iframe';
+ *
+ * const transport = new IframeTransport();
+ * if (transport.isAvailable()) {
+ *   transport.send(JSON.stringify({ type: 'hello' }));
+ * }
+ * ```
+ */
+declare class IframeTransport extends BaseTransport {
+    readonly name = "iframe";
+    private readonly targetOrigin;
+    /**
+     * Create an iframe 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 iframeDetector: TransportDetector;
+
+export { IframeTransport, TransportListener, TransportUnsubscribe, iframeDetector };

package/dist/iframe.d.ts

@@ -0,0 +1,35 @@
+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';
+
+/**
+ * Transport for iframe/window.postMessage communication
+ * Used when web content is displayed inside an iframe
+ *
+ * @example
+ * ```typescript
+ * import { IframeTransport } from '@aspectly/transports/iframe';
+ *
+ * const transport = new IframeTransport();
+ * if (transport.isAvailable()) {
+ *   transport.send(JSON.stringify({ type: 'hello' }));
+ * }
+ * ```
+ */
+declare class IframeTransport extends BaseTransport {
+    readonly name = "iframe";
+    private readonly targetOrigin;
+    /**
+     * Create an iframe 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 iframeDetector: TransportDetector;
+
+export { IframeTransport, TransportListener, TransportUnsubscribe, iframeDetector };

package/dist/iframe.js

@@ -0,0 +1,75 @@
+'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/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()
+};
+
+exports.IframeTransport = IframeTransport;
+exports.iframeDetector = iframeDetector;
+//# sourceMappingURL=iframe.js.map
+//# sourceMappingURL=iframe.js.map

package/dist/iframe.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/BaseTransport.ts","../src/transports/IframeTransport.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;;;ACTO,IAAM,eAAA,GAAN,cAA8B,aAAA,CAAc;AAAA;AAAA;AAAA;AAAA;AAAA,EAQjD,WAAA,CAAY,eAAuB,GAAA,EAAK;AACtC,IAAA,KAAA,EAAM;AARR,IAAA,IAAA,CAAS,IAAA,GAAO,QAAA;AASd,IAAA,IAAA,CAAK,YAAA,GAAe,YAAA;AAAA,EACtB;AAAA,EAEA,WAAA,GAAuB;AACrB,IAAA,MAAM,GAAA,GAAM,KAAK,SAAA,EAAU;AAC3B,IAAA,IAAI,CAAC,KAAK,OAAO,KAAA;AAEjB,IAAA,OAAO,IAAI,MAAA,KAAW,GAAA;AAAA,EACxB;AAAA,EAEA,KAAK,OAAA,EAAuB;AAC1B,IAAA,MAAM,GAAA,GAAM,KAAK,SAAA,EAAU;AAC3B,IAAA,IAAI,CAAC,GAAA,EAAK;AACR,MAAA,OAAA,CAAQ,KAAK,2CAA2C,CAAA;AACxD,MAAA;AAAA,IACF;AACA,IAAA,IAAI,GAAA,CAAI,WAAW,GAAA,EAAK;AACtB,MAAA,OAAA,CAAQ,KAAK,wCAAwC,CAAA;AACrD,MAAA;AAAA,IACF;AACA,IAAA,GAAA,CAAI,MAAA,CAAO,WAAA,CAAY,OAAA,EAAS,IAAA,CAAK,YAAY,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;AAEA,IAAA,MAAM,OAAA,GAAU,CAAC,KAAA,KAA8B;AAE7C,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,cAAA,GAAoC;AAAA,EAC/C,IAAA,EAAM,QAAA;AAAA,EACN,QAAA,EAAU,EAAA;AAAA;AAAA,EACV,QAAQ,MAAM;AACZ,IAAA,OAAO,OAAO,MAAA,KAAW,WAAA,IAAe,MAAA,CAAO,MAAA,KAAW,MAAA;AAAA,EAC5D,CAAA;AAAA,EACA,eAAA,EAAiB,MAAM,IAAI,eAAA;AAC7B","file":"iframe.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\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"]}

package/dist/iframe.mjs

@@ -0,0 +1,72 @@
+// 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/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()
+};
+
+export { IframeTransport, iframeDetector };
+//# sourceMappingURL=iframe.mjs.map
+//# sourceMappingURL=iframe.mjs.map

package/dist/iframe.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/BaseTransport.ts","../src/transports/IframeTransport.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;;;ACTO,IAAM,eAAA,GAAN,cAA8B,aAAA,CAAc;AAAA;AAAA;AAAA;AAAA;AAAA,EAQjD,WAAA,CAAY,eAAuB,GAAA,EAAK;AACtC,IAAA,KAAA,EAAM;AARR,IAAA,IAAA,CAAS,IAAA,GAAO,QAAA;AASd,IAAA,IAAA,CAAK,YAAA,GAAe,YAAA;AAAA,EACtB;AAAA,EAEA,WAAA,GAAuB;AACrB,IAAA,MAAM,GAAA,GAAM,KAAK,SAAA,EAAU;AAC3B,IAAA,IAAI,CAAC,KAAK,OAAO,KAAA;AAEjB,IAAA,OAAO,IAAI,MAAA,KAAW,GAAA;AAAA,EACxB;AAAA,EAEA,KAAK,OAAA,EAAuB;AAC1B,IAAA,MAAM,GAAA,GAAM,KAAK,SAAA,EAAU;AAC3B,IAAA,IAAI,CAAC,GAAA,EAAK;AACR,MAAA,OAAA,CAAQ,KAAK,2CAA2C,CAAA;AACxD,MAAA;AAAA,IACF;AACA,IAAA,IAAI,GAAA,CAAI,WAAW,GAAA,EAAK;AACtB,MAAA,OAAA,CAAQ,KAAK,wCAAwC,CAAA;AACrD,MAAA;AAAA,IACF;AACA,IAAA,GAAA,CAAI,MAAA,CAAO,WAAA,CAAY,OAAA,EAAS,IAAA,CAAK,YAAY,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;AAEA,IAAA,MAAM,OAAA,GAAU,CAAC,KAAA,KAA8B;AAE7C,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,cAAA,GAAoC;AAAA,EAC/C,IAAA,EAAM,QAAA;AAAA,EACN,QAAA,EAAU,EAAA;AAAA;AAAA,EACV,QAAQ,MAAM;AACZ,IAAA,OAAO,OAAO,MAAA,KAAW,WAAA,IAAe,MAAA,CAAO,MAAA,KAAW,MAAA;AAAA,EAC5D,CAAA;AAAA,EACA,eAAA,EAAiB,MAAM,IAAI,eAAA;AAC7B","file":"iframe.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\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"]}

package/dist/index.d.mts

@@ -0,0 +1,85 @@
+import { B as BaseTransport, T as TransportListener, a as TransportUnsubscribe, b as TransportDetector, c as Transport } from './BaseTransport-CxzIr1Ds.mjs';
+export { d as TransportFactory } from './BaseTransport-CxzIr1Ds.mjs';
+export { CefSharpTransport, cefSharpDetector } from './cefsharp.mjs';
+export { ReactNativeTransport, reactNativeDetector } from './react-native.mjs';
+export { IframeTransport, iframeDetector } from './iframe.mjs';
+export { WindowTransport, windowDetector } from './window.mjs';
+
+/**
+ * Fallback transport for browser environments.
+ * Listens for window.postMessage events, allowing parent windows
+ * to receive messages from child iframes.
+ */
+declare class PostMessageTransport extends BaseTransport {
+    readonly name = "postmessage";
+    isAvailable(): boolean;
+    send(message: string): void;
+    subscribe(listener: TransportListener): TransportUnsubscribe;
+}
+/**
+ * Detector for auto-detection registry
+ */
+declare const postMessageDetector: TransportDetector;
+
+/**
+ * Null transport - used when no transport is available
+ * All operations are no-ops. Useful for SSR or testing.
+ */
+declare class NullTransport extends BaseTransport {
+    readonly name = "null";
+    isAvailable(): boolean;
+    send(_message: string): void;
+    subscribe(_listener: TransportListener): TransportUnsubscribe;
+}
+
+/**
+ * Registry for transport detectors
+ * Manages auto-detection of the current environment
+ */
+declare class TransportRegistryClass {
+    private detectors;
+    private cachedTransport;
+    constructor();
+    /**
+     * Register a custom transport detector
+     * @param detector The detector to register
+     */
+    register(detector: TransportDetector): void;
+    /**
+     * Unregister a transport detector by name
+     * @param name Name of the detector to remove
+     */
+    unregister(name: string): void;
+    /**
+     * Get all registered detectors
+     */
+    getDetectors(): readonly TransportDetector[];
+    /**
+     * Detect and return the appropriate transport for the current environment
+     * Results are cached for performance
+     * @param forceRedetect Force re-detection (ignores cache)
+     */
+    detect(forceRedetect?: boolean): Transport;
+    /**
+     * Clear the cached transport (useful for testing)
+     */
+    clearCache(): void;
+    /**
+     * Reset registry to default state (built-in detectors only)
+     */
+    reset(): void;
+}
+/**
+ * Global transport registry instance
+ */
+declare const TransportRegistry: TransportRegistryClass;
+/**
+ * Convenience function to detect transport
+ */
+declare const detectTransport: (forceRedetect?: boolean) => Transport;
+/**
+ * Convenience function to register a custom detector
+ */
+declare const registerTransport: (detector: TransportDetector) => void;
+
+export { BaseTransport, NullTransport, PostMessageTransport, Transport, TransportDetector, TransportListener, TransportRegistry, TransportUnsubscribe, detectTransport, postMessageDetector, registerTransport };

package/dist/index.d.ts

@@ -0,0 +1,85 @@
+import { B as BaseTransport, T as TransportListener, a as TransportUnsubscribe, b as TransportDetector, c as Transport } from './BaseTransport-CxzIr1Ds.js';
+export { d as TransportFactory } from './BaseTransport-CxzIr1Ds.js';
+export { CefSharpTransport, cefSharpDetector } from './cefsharp.js';
+export { ReactNativeTransport, reactNativeDetector } from './react-native.js';
+export { IframeTransport, iframeDetector } from './iframe.js';
+export { WindowTransport, windowDetector } from './window.js';
+
+/**
+ * Fallback transport for browser environments.
+ * Listens for window.postMessage events, allowing parent windows
+ * to receive messages from child iframes.
+ */
+declare class PostMessageTransport extends BaseTransport {
+    readonly name = "postmessage";
+    isAvailable(): boolean;
+    send(message: string): void;
+    subscribe(listener: TransportListener): TransportUnsubscribe;
+}
+/**
+ * Detector for auto-detection registry
+ */
+declare const postMessageDetector: TransportDetector;
+
+/**
+ * Null transport - used when no transport is available
+ * All operations are no-ops. Useful for SSR or testing.
+ */
+declare class NullTransport extends BaseTransport {
+    readonly name = "null";
+    isAvailable(): boolean;
+    send(_message: string): void;
+    subscribe(_listener: TransportListener): TransportUnsubscribe;
+}
+
+/**
+ * Registry for transport detectors
+ * Manages auto-detection of the current environment
+ */
+declare class TransportRegistryClass {
+    private detectors;
+    private cachedTransport;
+    constructor();
+    /**
+     * Register a custom transport detector
+     * @param detector The detector to register
+     */
+    register(detector: TransportDetector): void;
+    /**
+     * Unregister a transport detector by name
+     * @param name Name of the detector to remove
+     */
+    unregister(name: string): void;
+    /**
+     * Get all registered detectors
+     */
+    getDetectors(): readonly TransportDetector[];
+    /**
+     * Detect and return the appropriate transport for the current environment
+     * Results are cached for performance
+     * @param forceRedetect Force re-detection (ignores cache)
+     */
+    detect(forceRedetect?: boolean): Transport;
+    /**
+     * Clear the cached transport (useful for testing)
+     */
+    clearCache(): void;
+    /**
+     * Reset registry to default state (built-in detectors only)
+     */
+    reset(): void;
+}
+/**
+ * Global transport registry instance
+ */
+declare const TransportRegistry: TransportRegistryClass;
+/**
+ * Convenience function to detect transport
+ */
+declare const detectTransport: (forceRedetect?: boolean) => Transport;
+/**
+ * Convenience function to register a custom detector
+ */
+declare const registerTransport: (detector: TransportDetector) => void;
+
+export { BaseTransport, NullTransport, PostMessageTransport, Transport, TransportDetector, TransportListener, TransportRegistry, TransportUnsubscribe, detectTransport, postMessageDetector, registerTransport };