@simplysm/capacitor-plugin-intent 12.16.41

package/tests/slice5-start-activity-for-result-android.spec.md

@@ -0,0 +1,98 @@
+# Slice 1: startActivityForResult Android 수동 테스트
+
+## 전제 조건
+
+- Capacitor 앱이 Android 디바이스/에뮬레이터에서 실행 중이다
+- `capacitor-plugin-intent`가 플러그인으로 등록되어 있다
+
+## Scenario: action만 지정하여 Activity 시작
+
+### 수행 절차
+1. `Intent.startActivityForResult({ action: "android.intent.action.PICK" })` 호출
+2. Android 시스템이 해당 action을 처리할 수 있는 앱 목록을 표시하는지 확인
+
+### 기대 결과
+- 해당 action을 처리하는 Activity가 열린다
+
+## Scenario: action + uri 지정
+
+### 수행 절차
+1. `Intent.startActivityForResult({ action: "android.intent.action.VIEW", uri: "content://contacts/people/1" })` 호출
+
+### 기대 결과
+- Intent의 data에 해당 URI가 설정되어 Activity가 열린다
+
+## Scenario: extras 지정
+
+### 수행 절차
+1. `Intent.startActivityForResult({ action: "com.example.ACTION", extras: { "key": "value" } })` 호출
+
+### 기대 결과
+- Intent의 extra에 해당 데이터가 포함되어 Activity가 열린다
+
+## Scenario: package + component로 명시적 Activity 지정
+
+### 수행 절차
+1. 대상 앱의 패키지명과 Activity 클래스명을 확인
+2. `Intent.startActivityForResult({ action: "android.intent.action.MAIN", package: "com.example.app", component: "com.example.app.MainActivity" })` 호출
+
+### 기대 결과
+- 지정된 패키지의 지정된 Activity가 직접 열린다
+
+## Scenario: type(MIME type) 지정
+
+### 수행 절차
+1. `Intent.startActivityForResult({ action: "android.intent.action.GET_CONTENT", type: "image/*" })` 호출
+
+### 기대 결과
+- Intent의 MIME type이 설정되어 이미지 선택 Activity가 열린다
+
+## Scenario: uri + type 동시 지정
+
+### 수행 절차
+1. `Intent.startActivityForResult({ action: "android.intent.action.VIEW", uri: "content://media/images", type: "image/png" })` 호출
+
+### 기대 결과
+- Intent에 setDataAndType으로 URI와 MIME type이 함께 설정된다
+
+## Scenario: 대상 Activity가 RESULT_OK로 종료
+
+### 수행 절차
+1. `Intent.startActivityForResult({ action: "android.intent.action.GET_CONTENT", type: "image/*" })` 호출
+2. 열린 Activity에서 이미지를 선택
+
+### 기대 결과
+- Promise가 resolve되고 `{ resultCode: -1, data: "content://...", extras: {...} }` 형태의 결과를 반환한다
+
+## Scenario: 대상 Activity가 RESULT_CANCELED로 종료 (사용자 뒤로가기)
+
+### 수행 절차
+1. `Intent.startActivityForResult({ action: "android.intent.action.GET_CONTENT", type: "image/*" })` 호출
+2. 열린 Activity에서 뒤로가기 버튼 누름
+
+### 기대 결과
+- Promise가 resolve되고 `{ resultCode: 0 }`을 반환한다
+
+## Scenario: 대상 Activity가 data 없이 종료
+
+### 수행 절차
+1. data를 반환하지 않는 Activity를 시작하고 정상 완료
+
+### 기대 결과
+- 반환값의 `data` 필드는 undefined이다
+
+## Scenario: 대상 Activity가 extras 없이 종료
+
+### 수행 절차
+1. extras를 반환하지 않는 Activity를 시작하고 정상 완료
+
+### 기대 결과
+- 반환값의 `extras` 필드는 undefined이다
+
+## Scenario: 존재하지 않는 앱으로 Activity 시작 시도
+
+### 수행 절차
+1. `Intent.startActivityForResult({ action: "android.intent.action.MAIN", package: "com.nonexistent.app", component: "com.nonexistent.app.MainActivity" })` 호출
+
+### 기대 결과
+- ActivityNotFoundException이 발생하여 Promise가 reject된다

package/tests/slice5-start-activity-for-result-types.spec.ts

@@ -0,0 +1,40 @@
+import { resolve } from "path";
+
+const pkgRoot = resolve(import.meta.dirname, "..");
+const srcDir = resolve(pkgRoot, "src");
+
+describe("Slice 1: startActivityForResult TypeScript 인터페이스", () => {
+  test("IIntentPlugin에 startActivityForResult 메서드가 정의되어 있다", async () => {
+    const mod = await import(resolve(srcDir, "IIntentPlugin.ts"));
+
+    // IStartActivityForResultOptions 타입이 export되어야 한다
+    expect(mod.IStartActivityForResultOptions).toBeUndefined; // interface는 런타임에 없지만 export 확인
+
+    // IActivityResult 타입이 export되어야 한다
+    expect(mod.IActivityResult).toBeUndefined;
+  });
+
+  test("IStartActivityForResultOptions에 필수 필드 action과 선택 필드들이 정의되어 있다", async () => {
+    const content = (await import("fs")).readFileSync(resolve(srcDir, "IIntentPlugin.ts"), "utf-8");
+    expect(content).toContain("interface IStartActivityForResultOptions");
+    expect(content).toMatch(/action\s*:\s*string/);
+    expect(content).toMatch(/uri\?\s*:\s*string/);
+    expect(content).toMatch(/extras\?\s*:\s*Record<string,\s*unknown>/);
+    expect(content).toMatch(/package\?\s*:\s*string/);
+    expect(content).toMatch(/component\?\s*:\s*string/);
+    expect(content).toMatch(/type\?\s*:\s*string/);
+  });
+
+  test("IActivityResult에 resultCode, data?, extras? 필드가 정의되어 있다", async () => {
+    const content = (await import("fs")).readFileSync(resolve(srcDir, "IIntentPlugin.ts"), "utf-8");
+    expect(content).toContain("interface IActivityResult");
+    expect(content).toMatch(/resultCode\s*:\s*number/);
+    expect(content).toMatch(/data\?\s*:\s*string/);
+    expect(content).toMatch(/extras\?\s*:\s*Record<string,\s*unknown>/);
+  });
+
+  test("IIntentPlugin.startActivityForResult 메서드 시그니처가 올바르다", async () => {
+    const content = (await import("fs")).readFileSync(resolve(srcDir, "IIntentPlugin.ts"), "utf-8");
+    expect(content).toMatch(/startActivityForResult\s*\(\s*options\s*:\s*IStartActivityForResultOptions\s*\)\s*:\s*Promise<IActivityResult>/);
+  });
+});

package/tests/slice6-start-activity-for-result-web.spec.ts

@@ -0,0 +1,34 @@
+import { resolve } from "path";
+
+const pkgRoot = resolve(import.meta.dirname, "..");
+const srcDir = resolve(pkgRoot, "src");
+
+describe("Slice 2: startActivityForResult TypeScript 래퍼 및 웹 stub", () => {
+  // Scenario: Intent.startActivityForResult static 메서드 존재
+  test("Intent.startActivityForResult static 메서드가 존재한다", async () => {
+    const mod = await import(resolve(srcDir, "Intent.ts"));
+    expect(typeof mod.Intent.startActivityForResult).toBe("function");
+  });
+
+  // Scenario: 웹에서 startActivityForResult 호출
+  test("IntentWeb.startActivityForResult가 resultCode 0으로 resolve한다", async () => {
+    const mod = await import(resolve(srcDir, "web/IntentWeb.ts"));
+    const web = new mod.IntentWeb();
+
+    // alert를 mock
+    globalThis.alert = vi.fn();
+
+    const result = await web.startActivityForResult({ action: "test.ACTION" });
+    expect(result).toEqual({ resultCode: 0 });
+    expect(globalThis.alert).toHaveBeenCalledWith(
+      "[Intent] 웹 환경에서는 startActivityForResult를 지원하지 않습니다.",
+    );
+  });
+
+  // index.ts에서 새 타입이 export되는지 확인
+  test("index.ts에서 IStartActivityForResultOptions, IActivityResult가 re-export된다", async () => {
+    const content = (await import("fs")).readFileSync(resolve(srcDir, "IIntentPlugin.ts"), "utf-8");
+    expect(content).toContain("export interface IStartActivityForResultOptions");
+    expect(content).toContain("export interface IActivityResult");
+  });
+});

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "lib": ["ES2021", "DOM"],
+    "outDir": "./dist"
+  },
+  "exclude": ["dist", "node_modules"]
+}