@simplysm/capacitor-plugin-intent 12.16.41 → 14.0.1

package/dist/web/IntentWeb.js

@@ -0,0 +1,28 @@
+import { WebPlugin } from "@capacitor/core";
+export class IntentWeb extends WebPlugin {
+    static _warn = () => 
+    // eslint-disable-next-line no-console
+    console.warn("[Intent] 웹 환경에서는 지원하지 않습니다.");
+    subscribe(_options, _callback) {
+        IntentWeb._warn();
+        return Promise.resolve({ id: "web-stub" });
+    }
+    async unsubscribe(_options) {
+        // 웹에서는 동작 없음
+    }
+    async unsubscribeAll() {
+        // 웹에서는 동작 없음
+    }
+    send(_options) {
+        IntentWeb._warn();
+        return Promise.resolve();
+    }
+    getLaunchIntent() {
+        return Promise.resolve({});
+    }
+    startActivityForResult(_options) {
+        IntentWeb._warn();
+        return Promise.resolve({ resultCode: 0 });
+    }
+}
+//# sourceMappingURL=IntentWeb.js.map

package/dist/web/IntentWeb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntentWeb.js","sourceRoot":"","sources":["../../src/web/IntentWeb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAQ5C,MAAM,OAAO,SAAU,SAAQ,SAAS;IAC9B,MAAM,CAAU,KAAK,GAAG,GAAG,EAAE;IACnC,sCAAsC;IACtC,OAAO,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAE9C,SAAS,CACP,QAA+B,EAC/B,SAAyC;QAEzC,SAAS,CAAC,KAAK,EAAE,CAAC;QAClB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,QAAwB;QACxC,aAAa;IACf,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,aAAa;IACf,CAAC;IAED,IAAI,CAAC,QAA8D;QACjE,SAAS,CAAC,KAAK,EAAE,CAAC;QAClB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,eAAe;QACb,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED,sBAAsB,CACpB,QAAuC;QAEvC,SAAS,CAAC,KAAK,EAAE,CAAC;QAClB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;IAC5C,CAAC"}

package/package.json

@@ -1,26 +1,31 @@
 {
   "name": "@simplysm/capacitor-plugin-intent",
-  "version": "12.16.41",
-  "description": "심플리즘 패키지 - Capacitor Intent Plugin",
-  "author": "김석래",
+  "version": "14.0.1",
+  "description": "심플리즘 패키지 - Capacitor Intent 플러그인",
+  "author": "심플리즘",
+  "license": "Apache-2.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/kslhunter/simplysm.git",
     "directory": "packages/capacitor-plugin-intent"
   },
-  "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src",
+    "android"
+  ],
+  "devDependencies": {
+    "@capacitor/core": "^7.6.0"
+  },
+  "peerDependencies": {
+    "@capacitor/core": "^7"
+  },
   "capacitor": {
     "android": {
       "src": "android"
     }
-  },
-  "peerDependencies": {
-    "@capacitor/core": "^7.4.4"
-  },
-  "devDependencies": {
-    "@capacitor/core": "^7.6.0"
   }
 }

package/src/Intent.ts

@@ -1,7 +1,13 @@
 import { registerPlugin } from "@capacitor/core";
-import { IActivityResult, IIntentPlugin, IIntentResult, IStartActivityForResultOptions } from "./IIntentPlugin";
+import type { PluginListenerHandle } from "@capacitor/core";
+import type {
+  IntentPlugin,
+  IntentResult,
+  StartActivityForResultOptions,
+  StartActivityForResultResult,
+} from "./IntentPlugin";
 
-const IntentPlugin = registerPlugin<IIntentPlugin>("Intent", {
+const intentPlugin = registerPlugin<IntentPlugin>("Intent", {
   web: async () => {
     const { IntentWeb } = await import("./web/IntentWeb");
     return new IntentWeb();
@@ -9,13 +15,14 @@ const IntentPlugin = registerPlugin<IIntentPlugin>("Intent", {
 });
 
 /**
- * Android Intent 송수신 플러그인
- * - 산업용 장치(바코드 스캐너, PDA 등) 연동용
+ * Android 인텐트 플러그인
+ * - 브로드캐스트 송수신, 실행 인텐트 조회
+ * - 산업용 디바이스 연동용 (바코드 스캐너, PDA 등)
  */
 export abstract class Intent {
   /**
-   * Intent 수신 등록
-   * @returns 해제 함수
+   * 브로드캐스트 수신기 등록
+   * @returns 구독 해제 함수
    *
    * @example
    * ```ts
@@ -24,29 +31,34 @@ export abstract class Intent {
    *   (result) => console.log(result.extras)
    * );
    *
-   * // 해제
+   * // 구독 해제
    * unsub();
    * ```
    */
   static async subscribe(
     filters: string[],
-    callback: (result: IIntentResult) => void,
+    callback: (result: IntentResult) => void,
   ): Promise<() => Promise<void>> {
-    const { id } = await IntentPlugin.subscribe({ filters }, callback);
+    const { id } = await intentPlugin.subscribe({ filters }, (result) => {
+      // { id }만 포함된 초기 resolve를 필터링
+      if (result.action != null) {
+        callback(result);
+      }
+    });
     return async () => {
-      await IntentPlugin.unsubscribe({ id });
+      await intentPlugin.unsubscribe({ id });
     };
   }
 
   /**
-   * 모든 Intent 수신기 해제
+   * 모든 브로드캐스트 수신기 구독 해제
    */
   static async unsubscribeAll(): Promise<void> {
-    await IntentPlugin.unsubscribeAll();
+    await intentPlugin.unsubscribeAll();
   }
 
   /**
-   * Intent 전송
+   * 브로드캐스트 전송
    *
    * @example
    * ```ts
@@ -59,32 +71,51 @@ export abstract class Intent {
    * ```
    */
   static async send(options: { action: string; extras?: Record<string, unknown> }): Promise<void> {
-    await IntentPlugin.send(options);
+    await intentPlugin.send(options);
   }
 
   /**
-   * 앱 시작 Intent 가져오기
+   * 실행 인텐트 조회
    */
-  static async getLaunchIntent(): Promise<IIntentResult> {
-    return await IntentPlugin.getLaunchIntent();
+  static async getLaunchIntent(): Promise<IntentResult> {
+    return intentPlugin.getLaunchIntent();
   }
 
   /**
-   * Activity 시작 후 결과 수신
+   * 이벤트 리스너 등록
+   * @returns 리스너 핸들 (handle.remove()로 해제)
+   */
+  static async addListener(
+    eventName: "newIntent",
+    callback: (result: IntentResult) => void,
+  ): Promise<PluginListenerHandle> {
+    return intentPlugin.addListener(eventName, callback);
+  }
+
+  /**
+   * 모든 이벤트 리스너 제거
+   */
+  static async removeAllListeners(): Promise<void> {
+    await intentPlugin.removeAllListeners();
+  }
+
+  /**
+   * startActivityForResult로 외부 Activity를 실행하고 결과를 수신한다
    *
    * @example
    * ```ts
    * const result = await Intent.startActivityForResult({
-   *   action: "android.intent.action.GET_CONTENT",
-   *   type: "image/*",
+   *   action: "com.example.PAY",
+   *   extras: { amount: 1000 },
    * });
-   *
-   * if (result.resultCode === -1) { // RESULT_OK
-   *   console.log("Selected:", result.data);
+   * if (result.resultCode === -1) {
+   *   // RESULT_OK
    * }
    * ```
    */
-  static async startActivityForResult(options: IStartActivityForResultOptions): Promise<IActivityResult> {
-    return await IntentPlugin.startActivityForResult(options);
+  static async startActivityForResult(
+    options: StartActivityForResultOptions,
+  ): Promise<StartActivityForResultResult> {
+    return intentPlugin.startActivityForResult(options);
   }
 }

package/src/IntentPlugin.ts

@@ -0,0 +1,81 @@
+import type { PluginListenerHandle } from "@capacitor/core";
+
+export interface IntentResult {
+  /** 브로드캐스트 액션 */
+  action?: string;
+  /** 추가 데이터 */
+  extras?: Record<string, unknown>;
+}
+
+export interface StartActivityForResultOptions {
+  action?: string;
+  uri?: string;
+  extras?: Record<string, unknown>;
+  /** MIME type */
+  type?: string;
+  /** 특정 앱 지정 */
+  packageName?: string;
+  /** 특정 Activity 지정 */
+  className?: string;
+  /** Intent flags */
+  flags?: number;
+}
+
+export interface StartActivityForResultResult {
+  resultCode: number;
+  data?: {
+    action?: string;
+    uri?: string;
+    extras?: Record<string, unknown>;
+  };
+}
+
+export interface IntentPlugin {
+  /**
+   * 브로드캐스트 수신기 등록
+   */
+  subscribe(
+    options: { filters: string[] },
+    callback: (result: IntentResult) => void,
+  ): Promise<{ id: string }>;
+
+  /**
+   * 특정 브로드캐스트 수신기 구독 해제
+   */
+  unsubscribe(options: { id: string }): Promise<void>;
+
+  /**
+   * 모든 브로드캐스트 수신기 구독 해제
+   */
+  unsubscribeAll(): Promise<void>;
+
+  /**
+   * 브로드캐스트 전송
+   */
+  send(options: { action: string; extras?: Record<string, unknown> }): Promise<void>;
+
+  /**
+   * 실행 인텐트 조회
+   */
+  getLaunchIntent(): Promise<IntentResult>;
+
+  /**
+   * 앱 실행 중 수신되는 새 인텐트에 대한 리스너 등록
+   */
+  addListener(
+    eventName: "newIntent",
+    listenerFunc: (data: IntentResult) => void,
+  ): Promise<PluginListenerHandle>;
+
+  /**
+   * 모든 이벤트 리스너 제거
+   */
+  removeAllListeners(): Promise<void>;
+
+  /**
+   * startActivityForResult로 외부 Activity를 실행하고 결과를 수신한다
+   */
+  startActivityForResult(
+    options: StartActivityForResultOptions,
+  ): Promise<StartActivityForResultResult>;
+}

package/src/index.ts

@@ -1,2 +1,3 @@
-export * from "./IIntentPlugin";
+// 인텐트
 export * from "./Intent";
+export * from "./IntentPlugin";

package/src/web/IntentWeb.ts

@@ -1,34 +1,45 @@
 import { WebPlugin } from "@capacitor/core";
-import { IActivityResult, IIntentPlugin, IIntentResult, IStartActivityForResultOptions } from "../IIntentPlugin";
+import type {
+  IntentPlugin,
+  IntentResult,
+  StartActivityForResultOptions,
+  StartActivityForResultResult,
+} from "../IntentPlugin";
 
-export class IntentWeb extends WebPlugin implements IIntentPlugin {
-  async subscribe(
+export class IntentWeb extends WebPlugin implements IntentPlugin {
+  private static readonly _warn = () =>
+    // eslint-disable-next-line no-console
+    console.warn("[Intent] 웹 환경에서는 지원하지 않습니다.");
+
+  subscribe(
     _options: { filters: string[] },
-    _callback: (result: IIntentResult) => void,
+    _callback: (result: IntentResult) => void,
   ): Promise<{ id: string }> {
-    alert("[Intent] 웹 환경에서는 Intent를 지원하지 않습니다.");
-    return await Promise.resolve({ id: "web-stub" });
+    IntentWeb._warn();
+    return Promise.resolve({ id: "web-stub" });
   }
 
   async unsubscribe(_options: { id: string }): Promise<void> {
-    await Promise.resolve();
+    // 웹에서는 동작 없음
   }
 
   async unsubscribeAll(): Promise<void> {
-    await Promise.resolve();
+    // 웹에서는 동작 없음
   }
 
-  async send(_options: { action: string; extras?: Record<string, unknown> }): Promise<void> {
-    alert("[Intent] 웹 환경에서는 Intent를 지원하지 않습니다.");
-    await Promise.resolve();
+  send(_options: { action: string; extras?: Record<string, unknown> }): Promise<void> {
+    IntentWeb._warn();
+    return Promise.resolve();
   }
 
-  async getLaunchIntent(): Promise<IIntentResult> {
-    return await Promise.resolve({});
+  getLaunchIntent(): Promise<IntentResult> {
+    return Promise.resolve({});
   }
 
-  async startActivityForResult(_options: IStartActivityForResultOptions): Promise<IActivityResult> {
-    alert("[Intent] 웹 환경에서는 startActivityForResult를 지원하지 않습니다.");
-    return await Promise.resolve({ resultCode: 0 });
+  startActivityForResult(
+    _options: StartActivityForResultOptions,
+  ): Promise<StartActivityForResultResult> {
+    IntentWeb._warn();
+    return Promise.resolve({ resultCode: 0 });
   }
 }

package/README.md

@@ -1,188 +0,0 @@
-# @simplysm/capacitor-plugin-intent
-
-Capacitor Intent Plugin -- Android intent send/receive for industrial devices (barcode scanners, PDA, etc.). Provides subscription-based intent receiving, intent sending with extras, launch intent retrieval, and startActivityForResult support.
-
-## Installation
-
-```bash
-npm install @simplysm/capacitor-plugin-intent
-```
-
-## API Overview
-
-| API | Type | Description |
-|-----|------|-------------|
-| `Intent` | Abstract class | Static methods for subscribing to, sending, and managing Android intents |
-| `IIntentResult` | Interface | Intent result containing action and extras |
-| `IStartActivityForResultOptions` | Interface | Options for starting an activity for result |
-| `IActivityResult` | Interface | Activity result containing resultCode, data, and extras |
-| `IIntentPlugin` | Interface | Low-level Capacitor plugin interface for intent operations |
-
-## API Reference
-
-### `IIntentResult`
-
-Result object received from an intent or launch intent.
-
-```typescript
-export interface IIntentResult {
-  action?: string;
-  extras?: Record<string, unknown>;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `action` | `string \| undefined` | The intent action string |
-| `extras` | `Record<string, unknown> \| undefined` | Extra data attached to the intent |
-
-### `IStartActivityForResultOptions`
-
-Options for starting an activity and receiving its result.
-
-```typescript
-export interface IStartActivityForResultOptions {
-  action: string;
-  uri?: string;
-  extras?: Record<string, unknown>;
-  package?: string;
-  component?: string;
-  type?: string;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `action` | `string` | Intent action (required) |
-| `uri` | `string \| undefined` | Data URI |
-| `extras` | `Record<string, unknown> \| undefined` | Extra data to include in the intent |
-| `package` | `string \| undefined` | Target package name |
-| `component` | `string \| undefined` | Target component class name (requires `package`) |
-| `type` | `string \| undefined` | MIME type |
-
-### `IActivityResult`
-
-Result returned from a started activity.
-
-```typescript
-export interface IActivityResult {
-  resultCode: number;
-  data?: string;
-  extras?: Record<string, unknown>;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `resultCode` | `number` | Activity result code (`RESULT_OK = -1`, `RESULT_CANCELED = 0`) |
-| `data` | `string \| undefined` | Result data URI |
-| `extras` | `Record<string, unknown> \| undefined` | Result extras |
-
-### `IIntentPlugin`
-
-Low-level Capacitor plugin interface. Use `Intent` instead for a simplified API.
-
-```typescript
-export interface IIntentPlugin {
-  subscribe(
-    options: { filters: string[] },
-    callback: (result: IIntentResult) => void,
-  ): Promise<{ id: string }>;
-  unsubscribe(options: { id: string }): Promise<void>;
-  unsubscribeAll(): Promise<void>;
-  send(options: { action: string; extras?: Record<string, unknown> }): Promise<void>;
-  getLaunchIntent(): Promise<IIntentResult>;
-  startActivityForResult(options: IStartActivityForResultOptions): Promise<IActivityResult>;
-}
-```
-
-| Method | Parameters | Returns | Description |
-|--------|------------|---------|-------------|
-| `subscribe` | `options: { filters: string[] }, callback` | `Promise<{ id: string }>` | Register an intent receiver with action filters |
-| `unsubscribe` | `options: { id: string }` | `Promise<void>` | Remove a specific intent receiver by ID |
-| `unsubscribeAll` | -- | `Promise<void>` | Remove all intent receivers |
-| `send` | `options: { action, extras? }` | `Promise<void>` | Send an intent with action and optional extras |
-| `getLaunchIntent` | -- | `Promise<IIntentResult>` | Get the intent that launched the app |
-| `startActivityForResult` | `options: IStartActivityForResultOptions` | `Promise<IActivityResult>` | Start an activity and receive its result |
-
-### `Intent`
-
-Abstract class with static methods for Android intent send/receive. Designed for industrial device integration (barcode scanners, PDA, etc.).
-
-```typescript
-export abstract class Intent {
-  static async subscribe(
-    filters: string[],
-    callback: (result: IIntentResult) => void,
-  ): Promise<() => Promise<void>>;
-
-  static async unsubscribeAll(): Promise<void>;
-
-  static async send(options: {
-    action: string;
-    extras?: Record<string, unknown>;
-  }): Promise<void>;
-
-  static async getLaunchIntent(): Promise<IIntentResult>;
-
-  static async startActivityForResult(
-    options: IStartActivityForResultOptions,
-  ): Promise<IActivityResult>;
-}
-```
-
-| Method | Parameters | Returns | Description |
-|--------|------------|---------|-------------|
-| `subscribe` | `filters: string[], callback: (result: IIntentResult) => void` | `Promise<() => Promise<void>>` | Register an intent receiver; returns an unsubscribe function |
-| `unsubscribeAll` | -- | `Promise<void>` | Remove all registered intent receivers |
-| `send` | `options: { action: string; extras?: Record<string, unknown> }` | `Promise<void>` | Send an intent with action and optional extras |
-| `getLaunchIntent` | -- | `Promise<IIntentResult>` | Retrieve the intent that launched the application |
-| `startActivityForResult` | `options: IStartActivityForResultOptions` | `Promise<IActivityResult>` | Start an activity and receive its result |
-
-## Usage Examples
-
-### Subscribe to intents from a barcode scanner
-
-```typescript
-import { Intent } from "@simplysm/capacitor-plugin-intent";
-
-const unsubscribe = await Intent.subscribe(
-  ["com.symbol.datawedge.api.RESULT_ACTION"],
-  (result) => {
-    console.log("Action:", result.action);
-    console.log("Extras:", result.extras);
-  },
-);
-
-// Later, unsubscribe
-await unsubscribe();
-```
-
-### Send an intent to trigger a scan
-
-```typescript
-import { Intent } from "@simplysm/capacitor-plugin-intent";
-
-await Intent.send({
-  action: "com.symbol.datawedge.api.ACTION",
-  extras: {
-    "com.symbol.datawedge.api.SOFT_SCAN_TRIGGER": "TOGGLE_SCANNING",
-  },
-});
-```
-
-### Start an activity for result
-
-```typescript
-import { Intent } from "@simplysm/capacitor-plugin-intent";
-
-const result = await Intent.startActivityForResult({
-  action: "android.intent.action.GET_CONTENT",
-  type: "image/*",
-});
-
-if (result.resultCode === -1) {
-  // RESULT_OK
-  console.log("Selected:", result.data);
-}
-```