@simplysm/capacitor-plugin-broadcast 13.0.69 → 13.0.70

package/README.md

@@ -1,254 +1,22 @@
 # @simplysm/capacitor-plugin-broadcast
 
-A Capacitor plugin for sending and receiving Android Broadcast Intents. It is primarily designed for integration with industrial Android devices such as barcode scanners and PDAs.
-
-It provides features including BroadcastReceiver registration/unregistration, Intent sending, app launch Intent retrieval, and new Intent reception listeners.
+Simplysm Package - Capacitor Broadcast Plugin
 
 ## Installation
 
-```bash
-npm install @simplysm/capacitor-plugin-broadcast
-npx cap sync
-```
-
-## Supported Platforms
-
-| Platform | Supported | Notes |
-|--------|----------|------|
-| Android | Yes | Native BroadcastReceiver implementation |
-| iOS | No | Not supported |
-| Web | Partial | Stub implementation (outputs warning messages, no actual functionality) |
-
-## Main Modules
-
-### `Broadcast` Class
-
-A wrapper class consisting only of static methods. Access the native plugin through this class instead of using it directly.
-
-```typescript
-import { Broadcast } from "@simplysm/capacitor-plugin-broadcast";
-```
-
-| Method | Signature | Return Type | Description |
-|--------|-----------|----------|------|
-| `subscribe` | `(filters: string[], callback: (result: IBroadcastResult) => void)` | `Promise<() => Promise<void>>` | Registers a Broadcast receiver and returns an unsubscribe function |
-| `unsubscribeAll` | `()` | `Promise<void>` | Unregisters all registered Broadcast receivers |
-| `send` | `(options: { action: string; extras?: Record<string, unknown> })` | `Promise<void>` | Sends a Broadcast Intent |
-| `getLaunchIntent` | `()` | `Promise<IBroadcastResult>` | Retrieves the Intent information that launched the app |
-| `addNewIntentListener` | `(callback: (result: IBroadcastResult) => void)` | `Promise<PluginListenerHandle>` | Registers a listener for new Intents received while the app is running |
-
-### `IBroadcastResult` Interface
-
-An interface representing Broadcast reception results or Intent information.
-
-| Property | Type | Description |
-|------|------|------|
-| `action` | `string \| undefined` | Broadcast action string |
-| `extras` | `Record<string, unknown> \| undefined` | Additional data included in the Intent |
-
-### `IBroadcastPlugin` Interface
-
-The low-level Capacitor plugin interface. In most cases, use the `Broadcast` wrapper class instead of this interface directly. It is exported for advanced use cases such as custom plugin registration.
-
-| Method | Signature | Return Type | Description |
-|--------|-----------|----------|------|
-| `subscribe` | `(options: { filters: string[] }, callback: (result: IBroadcastResult) => void)` | `Promise<{ id: string }>` | Register a BroadcastReceiver with intent filters |
-| `unsubscribe` | `(options: { id: string })` | `Promise<void>` | Unregister a specific BroadcastReceiver by ID |
-| `unsubscribeAll` | `()` | `Promise<void>` | Unregister all BroadcastReceivers |
-| `send` | `(options: { action: string; extras?: Record<string, unknown> })` | `Promise<void>` | Send a Broadcast Intent |
-| `getLaunchIntent` | `()` | `Promise<IBroadcastResult>` | Retrieve the launch Intent |
-| `addListener` | `(eventName: "onNewIntent", listenerFunc: (data: IBroadcastResult) => void)` | `Promise<PluginListenerHandle>` | Listen for new Intents while the app is running |
-
-```typescript
-import type { IBroadcastPlugin, IBroadcastResult } from "@simplysm/capacitor-plugin-broadcast";
-```
-
-## Usage Examples
-
-### Receiving Broadcasts
-
-Registers a Broadcast receiver for specific actions. `subscribe` returns an unsubscribe function that can be called to remove the receiver.
-
-```typescript
-import { Broadcast } from "@simplysm/capacitor-plugin-broadcast";
-
-// Register Broadcast receiver
-const unsubscribe = await Broadcast.subscribe(
-  ["com.symbol.datawedge.api.RESULT_ACTION"],
-  (result) => {
-    console.log("Action:", result.action);
-    console.log("Extras:", result.extras);
-  },
-);
-
-// Unsubscribe receiver
-await unsubscribe();
-```
-
-You can also filter multiple actions simultaneously.
-
-```typescript
-const unsubscribe = await Broadcast.subscribe(
-  [
-    "com.symbol.datawedge.api.RESULT_ACTION",
-    "com.symbol.datawedge.api.NOTIFICATION_ACTION",
-  ],
-  (result) => {
-    switch (result.action) {
-      case "com.symbol.datawedge.api.RESULT_ACTION":
-        // Handle result
-        break;
-      case "com.symbol.datawedge.api.NOTIFICATION_ACTION":
-        // Handle notification
-        break;
-    }
-  },
-);
-```
-
-### Unsubscribe All Receivers
-
-Unregisters all registered Broadcast receivers at once. Use this for cleanup when the app exits or during screen transitions.
-
-```typescript
-import { Broadcast } from "@simplysm/capacitor-plugin-broadcast";
-
-await Broadcast.unsubscribeAll();
-```
-
-### Sending Broadcasts
-
-Sends a Broadcast Intent to other apps or the system. You can include additional data as key-value pairs in `extras`.
-
-```typescript
-import { Broadcast } from "@simplysm/capacitor-plugin-broadcast";
-
-await Broadcast.send({
-  action: "com.symbol.datawedge.api.ACTION",
-  extras: {
-    "com.symbol.datawedge.api.SOFT_SCAN_TRIGGER": "TOGGLE_SCANNING",
-  },
-});
-```
-
-`extras` can contain various types of values.
-
-```typescript
-await Broadcast.send({
-  action: "com.example.MY_ACTION",
-  extras: {
-    stringValue: "hello",
-    numberValue: 42,
-    booleanValue: true,
-    arrayValue: ["item1", "item2"],
-    nestedValue: {
-      key: "value",
-    },
-  },
-});
-```
-
-### Retrieving Launch Intent
-
-If the app was started through an Intent from another app, you can retrieve that Intent information.
-
-```typescript
-import { Broadcast } from "@simplysm/capacitor-plugin-broadcast";
-
-const launchIntent = await Broadcast.getLaunchIntent();
-if (launchIntent.action != null) {
-  console.log("Launch Action:", launchIntent.action);
-  console.log("Launch Extras:", launchIntent.extras);
-}
-```
-
-### New Intent Listener
-
-Detects when a new Intent is received while the app is already running. Remove the listener using the `remove()` method of the returned `PluginListenerHandle`.
-
-```typescript
-import { Broadcast } from "@simplysm/capacitor-plugin-broadcast";
-
-const handle = await Broadcast.addNewIntentListener((result) => {
-  console.log("New Intent received:", result.action);
-  console.log("Extras:", result.extras);
-});
-
-// Remove listener
-await handle.remove();
-```
-
-### DataWedge Integration Example (Zebra Devices)
-
-A real-world usage pattern for integrating with industrial barcode scanners (Zebra DataWedge).
-
-```typescript
-import { Broadcast } from "@simplysm/capacitor-plugin-broadcast";
-
-// Register barcode scan result receiver
-const unsubscribe = await Broadcast.subscribe(
-  ["com.symbol.datawedge.api.RESULT_ACTION"],
-  (result) => {
-    const barcode = result.extras?.["com.symbol.datawedge.data_string"];
-    if (barcode != null) {
-      console.log("Scanned barcode:", barcode);
-    }
-  },
-);
-
-// Trigger soft scan
-await Broadcast.send({
-  action: "com.symbol.datawedge.api.ACTION",
-  extras: {
-    "com.symbol.datawedge.api.SOFT_SCAN_TRIGGER": "TOGGLE_SCANNING",
-  },
-});
-```
-
-## Supported Extras Types
-
-The types of values that can be included in `extras` when calling `send()`, and the types they are converted to when received, are as follows.
-
-### When Sending (TypeScript -> Android Intent)
-
-| TypeScript Type | Android Intent Type |
-|----------------|-------------------|
-| `string` | `String` |
-| `number` (integer) | `Integer` |
-| `number` (decimal) | `Double` |
-| `boolean` | `Boolean` |
-| `string[]` | `String[]` |
-| Nested object | `Bundle` |
-
-### When Receiving (Android Intent -> TypeScript)
-
-| Android Type | TypeScript Type |
-|-------------|----------------|
-| `String` | `string` |
-| `Integer` | `number` |
-| `Long` | `number` |
-| `Double` | `number` |
-| `Float` | `number` |
-| `Boolean` | `boolean` |
-| `Bundle` | Nested object |
-| `String[]` | `string[]` |
-| `int[]` | `number[]` |
-| `Parcelable` | `string` (toString) |
-
-## Lifecycle Management
+pnpm add @simplysm/capacitor-plugin-broadcast
 
-- The plugin automatically unregisters all BroadcastReceivers when the Activity is destroyed (`handleOnDestroy`).
-- On Android 13 (API 33, Tiramisu) and above, receivers are registered using the `RECEIVER_EXPORTED` flag.
-- To prevent memory leaks, it is recommended to unregister receivers that are no longer needed using the returned unsubscribe function or `unsubscribeAll()`.
+**Peer Dependencies:** `@capacitor/core ^7.4.4`
 
-## Dependencies
+## Source Index
 
-### Peer Dependencies
+### Broadcast
 
-| Package | Version |
-|--------|------|
-| `@capacitor/core` | `^7.4.4` |
+| Source | Exports | Description | Test |
+|--------|---------|-------------|------|
+| `src/Broadcast.ts` | `Broadcast` | Static class to send, subscribe, and listen to Android broadcast intents | - |
+| `src/IBroadcastPlugin.ts` | `IBroadcastResult`, `IBroadcastPlugin` | Interfaces for broadcast result data and the native broadcast plugin contract | - |
 
 ## License
 
-MIT
+Apache-2.0

package/dist/Broadcast.d.ts

@@ -1,13 +1,13 @@
 import type { PluginListenerHandle } from "@capacitor/core";
 import type { IBroadcastResult } from "./IBroadcastPlugin";
 /**
- * Android Broadcast 송수신 플러그인
- * - 산업용 장치(바코드 스캐너, PDA 등) 연동용
+ * Android Broadcast send/receive plugin
+ * - For industrial device integration (barcode scanners, PDAs, etc.)
  */
 export declare abstract class Broadcast {
     /**
-     * Broadcast 수신 등록
-     * @returns 해제 함수
+     * Register broadcast receiver
+     * @returns Unsubscribe function
      *
      * @example
      * ```ts
@@ -16,17 +16,17 @@ export declare abstract class Broadcast {
      *   (result) => console.log(result.extras)
      * );
      *
-     * // 해제
+     * // Unsubscribe
      * unsub();
      * ```
      */
     static subscribe(filters: string[], callback: (result: IBroadcastResult) => void): Promise<() => Promise<void>>;
     /**
-     * 모든 Broadcast 수신기 해제
+     * Unsubscribe all broadcast receivers
      */
     static unsubscribeAll(): Promise<void>;
     /**
-     * Broadcast 전송
+     * Send broadcast
      *
      * @example
      * ```ts
@@ -43,12 +43,12 @@ export declare abstract class Broadcast {
         extras?: Record<string, unknown>;
     }): Promise<void>;
     /**
-     * 앱 시작 Intent 가져오기
+     * Get launch intent
      */
     static getLaunchIntent(): Promise<IBroadcastResult>;
     /**
-     * 앱 실행 중 새 Intent 수신 리스너 등록
-     * @returns 리스너 핸들 (remove()로 해제)
+     * Register listener for new intents received while app is running
+     * @returns Listener handle (release with remove())
      */
     static addNewIntentListener(callback: (result: IBroadcastResult) => void): Promise<PluginListenerHandle>;
 }

package/dist/Broadcast.js

@@ -7,8 +7,8 @@ const BroadcastPlugin = registerPlugin("Broadcast", {
 });
 class Broadcast {
   /**
-   * Broadcast 수신 등록
-   * @returns 해제 함수
+   * Register broadcast receiver
+   * @returns Unsubscribe function
    *
    * @example
    * ```ts
@@ -17,7 +17,7 @@ class Broadcast {
    *   (result) => console.log(result.extras)
    * );
    *
-   * // 해제
+   * // Unsubscribe
    * unsub();
    * ```
    */
@@ -32,13 +32,13 @@ class Broadcast {
     };
   }
   /**
-   * 모든 Broadcast 수신기 해제
+   * Unsubscribe all broadcast receivers
    */
   static async unsubscribeAll() {
     await BroadcastPlugin.unsubscribeAll();
   }
   /**
-   * Broadcast 전송
+   * Send broadcast
    *
    * @example
    * ```ts
@@ -54,14 +54,14 @@ class Broadcast {
     await BroadcastPlugin.send(options);
   }
   /**
-   * 앱 시작 Intent 가져오기
+   * Get launch intent
    */
   static async getLaunchIntent() {
     return BroadcastPlugin.getLaunchIntent();
   }
   /**
-   * 앱 실행 중 새 Intent 수신 리스너 등록
-   * @returns 리스너 핸들 (remove()로 해제)
+   * Register listener for new intents received while app is running
+   * @returns Listener handle (release with remove())
    */
   static async addNewIntentListener(callback) {
     return BroadcastPlugin.addListener("onNewIntent", callback);

package/dist/IBroadcastPlugin.d.ts

@@ -7,7 +7,7 @@ export interface IBroadcastResult {
 }
 export interface IBroadcastPlugin {
     /**
-     * Broadcast 수신기 등록
+     * Register broadcast receiver
      */
     subscribe(options: {
         filters: string[];
@@ -15,28 +15,28 @@ export interface IBroadcastPlugin {
         id: string;
     }>;
     /**
-     * 특정 Broadcast 수신기 해제
+     * Unsubscribe a specific broadcast receiver
      */
     unsubscribe(options: {
         id: string;
     }): Promise<void>;
     /**
-     * 모든 Broadcast 수신기 해제
+     * Unsubscribe all broadcast receivers
      */
     unsubscribeAll(): Promise<void>;
     /**
-     * Broadcast 전송
+     * Send broadcast
      */
     send(options: {
         action: string;
         extras?: Record<string, unknown>;
     }): Promise<void>;
     /**
-     * 앱 시작 Intent 가져오기
+     * Get launch intent
      */
     getLaunchIntent(): Promise<IBroadcastResult>;
     /**
-     * 앱 실행 중 새 Intent 수신 리스너 등록
+     * Register listener for new intents received while app is running
      */
     addListener(eventName: "onNewIntent", listenerFunc: (data: IBroadcastResult) => void): Promise<PluginListenerHandle>;
 }

package/dist/web/BroadcastWeb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BroadcastWeb.d.ts","sourceRoot":"","sources":["../../src/web/BroadcastWeb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE9E,qBAAa,YAAa,SAAQ,SAAU,YAAW,gBAAgB;IACrE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAE+B;IAE5D,SAAS,CACP,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,EAC/B,SAAS,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,GAC5C,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAKpB,WAAW,CAAC,QAAQ,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrC,IAAI,CAAC,QAAQ,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnF,eAAe,IAAI,OAAO,CAAC,gBAAgB,CAAC;CAG7C"}
+{"version":3,"file":"BroadcastWeb.d.ts","sourceRoot":"","sources":["../../src/web/BroadcastWeb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE9E,qBAAa,YAAa,SAAQ,SAAU,YAAW,gBAAgB;IACrE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAEgD;IAE7E,SAAS,CACP,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,EAC/B,SAAS,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,GAC5C,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAKpB,WAAW,CAAC,QAAQ,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrC,IAAI,CAAC,QAAQ,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnF,eAAe,IAAI,OAAO,CAAC,gBAAgB,CAAC;CAG7C"}

package/dist/web/BroadcastWeb.js

@@ -2,7 +2,7 @@ import { WebPlugin } from "@capacitor/core";
 class BroadcastWeb extends WebPlugin {
   static _warn = () => (
     // eslint-disable-next-line no-console
-    console.warn("[Broadcast] \uC6F9 \uD658\uACBD\uC5D0\uC11C\uB294 Broadcast\uB97C \uC9C0\uC6D0\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.")
+    console.warn("[Broadcast] Broadcast is not supported in web environment.")
   );
   subscribe(_options, _callback) {
     BroadcastWeb._warn();

package/dist/web/BroadcastWeb.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../src/web/BroadcastWeb.ts"],
-  "mappings": "AAAA,SAAS,iBAAiB;AAGnB,MAAM,qBAAqB,UAAsC;AAAA,EACtE,OAAwB,QAAQ;AAAA;AAAA,IAE9B,QAAQ,KAAK,sHAA2C;AAAA;AAAA,EAE1D,UACE,UACA,WACyB;AACzB,iBAAa,MAAM;AACnB,WAAO,QAAQ,QAAQ,EAAE,IAAI,WAAW,CAAC;AAAA,EAC3C;AAAA,EAEA,MAAM,YAAY,UAAyC;AAAA,EAE3D;AAAA,EAEA,MAAM,iBAAgC;AAAA,EAEtC;AAAA,EAEA,KAAK,UAA+E;AAClF,iBAAa,MAAM;AACnB,WAAO,QAAQ,QAAQ;AAAA,EACzB;AAAA,EAEA,kBAA6C;AAC3C,WAAO,QAAQ,QAAQ,CAAC,CAAC;AAAA,EAC3B;AACF;",
+  "mappings": "AAAA,SAAS,iBAAiB;AAGnB,MAAM,qBAAqB,UAAsC;AAAA,EACtE,OAAwB,QAAQ;AAAA;AAAA,IAE9B,QAAQ,KAAK,4DAA4D;AAAA;AAAA,EAE3E,UACE,UACA,WACyB;AACzB,iBAAa,MAAM;AACnB,WAAO,QAAQ,QAAQ,EAAE,IAAI,WAAW,CAAC;AAAA,EAC3C;AAAA,EAEA,MAAM,YAAY,UAAyC;AAAA,EAE3D;AAAA,EAEA,MAAM,iBAAgC;AAAA,EAEtC;AAAA,EAEA,KAAK,UAA+E;AAClF,iBAAa,MAAM;AACnB,WAAO,QAAQ,QAAQ;AAAA,EACzB;AAAA,EAEA,kBAA6C;AAC3C,WAAO,QAAQ,QAAQ,CAAC,CAAC;AAAA,EAC3B;AACF;",
   "names": []
 }

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@simplysm/capacitor-plugin-broadcast",
-  "version": "13.0.69",
-  "description": "심플리즘 패키지 - Capacitor Broadcast Plugin",
-  "author": "김석래",
+  "version": "13.0.70",
+  "description": "Simplysm Package - Capacitor Broadcast Plugin",
+  "author": "simplysm",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -14,6 +14,7 @@
   "types": "./dist/index.d.ts",
   "files": [
     "dist",
+    "src",
     "android"
   ],
   "devDependencies": {

package/src/Broadcast.ts

@@ -0,0 +1,87 @@
+import { registerPlugin } from "@capacitor/core";
+import type { PluginListenerHandle } from "@capacitor/core";
+import type { IBroadcastPlugin, IBroadcastResult } from "./IBroadcastPlugin";
+
+const BroadcastPlugin = registerPlugin<IBroadcastPlugin>("Broadcast", {
+  web: async () => {
+    const { BroadcastWeb } = await import("./web/BroadcastWeb");
+    return new BroadcastWeb();
+  },
+});
+
+/**
+ * Android Broadcast send/receive plugin
+ * - For industrial device integration (barcode scanners, PDAs, etc.)
+ */
+export abstract class Broadcast {
+  /**
+   * Register broadcast receiver
+   * @returns Unsubscribe function
+   *
+   * @example
+   * ```ts
+   * const unsub = await Broadcast.subscribe(
+   *   ["com.symbol.datawedge.api.RESULT_ACTION"],
+   *   (result) => console.log(result.extras)
+   * );
+   *
+   * // Unsubscribe
+   * unsub();
+   * ```
+   */
+  static async subscribe(
+    filters: string[],
+    callback: (result: IBroadcastResult) => void,
+  ): Promise<() => Promise<void>> {
+    const { id } = await BroadcastPlugin.subscribe({ filters }, (result) => {
+      // Filter out the initial resolve that only contains { id }
+      if (result.action != null) {
+        callback(result);
+      }
+    });
+    return async () => {
+      await BroadcastPlugin.unsubscribe({ id });
+    };
+  }
+
+  /**
+   * Unsubscribe all broadcast receivers
+   */
+  static async unsubscribeAll(): Promise<void> {
+    await BroadcastPlugin.unsubscribeAll();
+  }
+
+  /**
+   * Send broadcast
+   *
+   * @example
+   * ```ts
+   * await Broadcast.send({
+   *   action: "com.symbol.datawedge.api.ACTION",
+   *   extras: {
+   *     "com.symbol.datawedge.api.SOFT_SCAN_TRIGGER": "TOGGLE_SCANNING"
+   *   }
+   * });
+   * ```
+   */
+  static async send(options: { action: string; extras?: Record<string, unknown> }): Promise<void> {
+    await BroadcastPlugin.send(options);
+  }
+
+  /**
+   * Get launch intent
+   */
+  static async getLaunchIntent(): Promise<IBroadcastResult> {
+    return BroadcastPlugin.getLaunchIntent();
+  }
+
+  /**
+   * Register listener for new intents received while app is running
+   * @returns Listener handle (release with remove())
+   */
+  static async addNewIntentListener(
+    callback: (result: IBroadcastResult) => void,
+  ): Promise<PluginListenerHandle> {
+    return BroadcastPlugin.addListener("onNewIntent", callback);
+  }
+}

package/src/IBroadcastPlugin.ts

@@ -0,0 +1,46 @@
+import type { PluginListenerHandle } from "@capacitor/core";
+
+export interface IBroadcastResult {
+  /** Broadcast action */
+  action?: string;
+  /** Extra data */
+  extras?: Record<string, unknown>;
+}
+
+export interface IBroadcastPlugin {
+  /**
+   * Register broadcast receiver
+   */
+  subscribe(
+    options: { filters: string[] },
+    callback: (result: IBroadcastResult) => void,
+  ): Promise<{ id: string }>;
+
+  /**
+   * Unsubscribe a specific broadcast receiver
+   */
+  unsubscribe(options: { id: string }): Promise<void>;
+
+  /**
+   * Unsubscribe all broadcast receivers
+   */
+  unsubscribeAll(): Promise<void>;
+
+  /**
+   * Send broadcast
+   */
+  send(options: { action: string; extras?: Record<string, unknown> }): Promise<void>;
+
+  /**
+   * Get launch intent
+   */
+  getLaunchIntent(): Promise<IBroadcastResult>;
+
+  /**
+   * Register listener for new intents received while app is running
+   */
+  addListener(
+    eventName: "onNewIntent",
+    listenerFunc: (data: IBroadcastResult) => void,
+  ): Promise<PluginListenerHandle>;
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+// Broadcast
+export * from "./Broadcast";
+export * from "./IBroadcastPlugin";

package/src/web/BroadcastWeb.ts

@@ -0,0 +1,33 @@
+import { WebPlugin } from "@capacitor/core";
+import type { IBroadcastPlugin, IBroadcastResult } from "../IBroadcastPlugin";
+
+export class BroadcastWeb extends WebPlugin implements IBroadcastPlugin {
+  private static readonly _warn = () =>
+    // eslint-disable-next-line no-console
+    console.warn("[Broadcast] Broadcast is not supported in web environment.");
+
+  subscribe(
+    _options: { filters: string[] },
+    _callback: (result: IBroadcastResult) => void,
+  ): Promise<{ id: string }> {
+    BroadcastWeb._warn();
+    return Promise.resolve({ id: "web-stub" });
+  }
+
+  async unsubscribe(_options: { id: string }): Promise<void> {
+    // No-op on web
+  }
+
+  async unsubscribeAll(): Promise<void> {
+    // No-op on web
+  }
+
+  send(_options: { action: string; extras?: Record<string, unknown> }): Promise<void> {
+    BroadcastWeb._warn();
+    return Promise.resolve();
+  }
+
+  getLaunchIntent(): Promise<IBroadcastResult> {
+    return Promise.resolve({});
+  }
+}