@aspectly/transports 0.1.0

package/dist/window.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';
+
+/**
+ * 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 };

package/dist/window.js

@@ -0,0 +1,79 @@
+'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/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()
+};
+
+exports.WindowTransport = WindowTransport;
+exports.windowDetector = windowDetector;
+//# sourceMappingURL=window.js.map
+//# sourceMappingURL=window.js.map

package/dist/window.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/BaseTransport.ts","../src/transports/WindowTransport.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;;;ACRO,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;AACjB,IAAA,OAAO,GAAA,CAAI,MAAA,KAAW,IAAA,IAAQ,CAAC,IAAI,MAAA,CAAO,MAAA;AAAA,EAC5C;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,CAAC,GAAA,CAAI,MAAA,IAAU,GAAA,CAAI,OAAO,MAAA,EAAQ;AACpC,MAAA,OAAA,CAAQ,KAAK,kDAAkD,CAAA;AAC/D,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;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,cAAA,GAAoC;AAAA,EAC/C,IAAA,EAAM,QAAA;AAAA,EACN,QAAA,EAAU,EAAA;AAAA;AAAA,EACV,QAAQ,MAAM;AACZ,IAAA,IAAI;AACF,MAAA,OAAO,OAAO,WAAW,WAAA,IACvB,MAAA,CAAO,UAAU,IAAA,IACjB,CAAC,OAAO,MAAA,CAAO,MAAA;AAAA,IACnB,CAAA,CAAA,MAAQ;AACN,MAAA,OAAO,KAAA;AAAA,IACT;AAAA,EACF,CAAA;AAAA,EACA,eAAA,EAAiB,MAAM,IAAI,eAAA;AAC7B","file":"window.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';\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"]}

package/dist/window.mjs

@@ -0,0 +1,76 @@
+// 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/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()
+};
+
+export { WindowTransport, windowDetector };
+//# sourceMappingURL=window.mjs.map
+//# sourceMappingURL=window.mjs.map

package/dist/window.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/BaseTransport.ts","../src/transports/WindowTransport.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;;;ACRO,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;AACjB,IAAA,OAAO,GAAA,CAAI,MAAA,KAAW,IAAA,IAAQ,CAAC,IAAI,MAAA,CAAO,MAAA;AAAA,EAC5C;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,CAAC,GAAA,CAAI,MAAA,IAAU,GAAA,CAAI,OAAO,MAAA,EAAQ;AACpC,MAAA,OAAA,CAAQ,KAAK,kDAAkD,CAAA;AAC/D,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;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,cAAA,GAAoC;AAAA,EAC/C,IAAA,EAAM,QAAA;AAAA,EACN,QAAA,EAAU,EAAA;AAAA;AAAA,EACV,QAAQ,MAAM;AACZ,IAAA,IAAI;AACF,MAAA,OAAO,OAAO,WAAW,WAAA,IACvB,MAAA,CAAO,UAAU,IAAA,IACjB,CAAC,OAAO,MAAA,CAAO,MAAA;AAAA,IACnB,CAAA,CAAA,MAAQ;AACN,MAAA,OAAO,KAAA;AAAA,IACT;AAAA,EACF,CAAA;AAAA,EACA,eAAA,EAAiB,MAAM,IAAI,eAAA;AAC7B","file":"window.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';\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"]}

package/package.json

@@ -0,0 +1,97 @@
+{
+  "name": "@aspectly/transports",
+  "version": "0.1.0",
+  "description": "Transport layer for Aspectly bridge - platform detection and message passing",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    },
+    "./cefsharp": {
+      "import": {
+        "types": "./dist/cefsharp.d.mts",
+        "default": "./dist/cefsharp.mjs"
+      },
+      "require": {
+        "types": "./dist/cefsharp.d.ts",
+        "default": "./dist/cefsharp.js"
+      }
+    },
+    "./react-native": {
+      "import": {
+        "types": "./dist/react-native.d.mts",
+        "default": "./dist/react-native.mjs"
+      },
+      "require": {
+        "types": "./dist/react-native.d.ts",
+        "default": "./dist/react-native.js"
+      }
+    },
+    "./iframe": {
+      "import": {
+        "types": "./dist/iframe.d.mts",
+        "default": "./dist/iframe.mjs"
+      },
+      "require": {
+        "types": "./dist/iframe.d.ts",
+        "default": "./dist/iframe.js"
+      }
+    },
+    "./window": {
+      "import": {
+        "types": "./dist/window.d.mts",
+        "default": "./dist/window.mjs"
+      },
+      "require": {
+        "types": "./dist/window.d.ts",
+        "default": "./dist/window.js"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "sideEffects": false,
+  "keywords": [
+    "aspectly",
+    "bridge",
+    "transport",
+    "cefsharp",
+    "webview",
+    "iframe",
+    "postmessage"
+  ],
+  "author": "Zhan Isaakian <jeanisahkyan@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/JeanIsahakyan/aspectly",
+    "directory": "packages/transports"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.2",
+    "rimraf": "^5.0.5"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --ext .ts,.tsx",
+    "clean": "rimraf dist",
+    "test": "vitest run"
+  }
+}

package/src/BaseTransport.test.ts

@@ -0,0 +1,60 @@
+import { describe, it, expect } from 'vitest';
+import { BaseTransport } from './BaseTransport';
+import type { TransportListener, TransportUnsubscribe } from './types';
+
+/**
+ * Concrete test implementation of BaseTransport
+ */
+class TestTransport extends BaseTransport {
+  readonly name = 'test';
+
+  isAvailable(): boolean {
+    return this.hasWindow();
+  }
+
+  send(_message: string): void {
+    // No-op for testing
+  }
+
+  subscribe(_listener: TransportListener): TransportUnsubscribe {
+    return () => {};
+  }
+}
+
+describe('BaseTransport', () => {
+  it('should have hasWindow() return true in jsdom environment', () => {
+    const transport = new TestTransport();
+    expect(transport.isAvailable()).toBe(true);
+  });
+
+  it('should have getWindow() return window object in jsdom environment', () => {
+    const transport = new TestTransport();
+    // Using any to access protected method for testing
+    const win = (transport as any).getWindow();
+    expect(win).toBe(window);
+  });
+
+  it('should require abstract name property', () => {
+    const transport = new TestTransport();
+    expect(transport.name).toBe('test');
+  });
+
+  it('should require abstract isAvailable method', () => {
+    const transport = new TestTransport();
+    expect(typeof transport.isAvailable).toBe('function');
+    expect(typeof transport.isAvailable()).toBe('boolean');
+  });
+
+  it('should require abstract send method', () => {
+    const transport = new TestTransport();
+    expect(typeof transport.send).toBe('function');
+    expect(() => transport.send('test')).not.toThrow();
+  });
+
+  it('should require abstract subscribe method', () => {
+    const transport = new TestTransport();
+    expect(typeof transport.subscribe).toBe('function');
+    const unsubscribe = transport.subscribe(() => {});
+    expect(typeof unsubscribe).toBe('function');
+  });
+});

package/src/BaseTransport.ts

@@ -0,0 +1,27 @@
+import type { Transport, TransportListener, TransportUnsubscribe } from './types';
+
+/**
+ * Abstract base class for transports
+ * Provides common functionality for message handling
+ */
+export abstract class BaseTransport implements Transport {
+  abstract readonly name: string;
+
+  abstract isAvailable(): boolean;
+  abstract send(message: string): void;
+  abstract subscribe(listener: TransportListener): TransportUnsubscribe;
+
+  /**
+   * Helper to check if window is defined (for SSR safety)
+   */
+  protected hasWindow(): boolean {
+    return typeof window !== 'undefined';
+  }
+
+  /**
+   * Helper to safely get window object
+   */
+  protected getWindow(): Window | null {
+    return this.hasWindow() ? window : null;
+  }
+}