@simplysm/sd-claude 14.0.47 → 14.0.49

package/claude/references/sd-simplysm14/capacitor-plugin-intent/usage.md

@@ -1,203 +0,0 @@
-# @simplysm/capacitor-plugin-intent
-
-Capacitor Intent 플러그인. 브로드캐스트 송수신, 실행 인텐트 조회, 새 인텐트 이벤트 수신, `startActivityForResult`를 제공한다. 산업용 디바이스 연동(바코드 스캐너, PDA 등)을 위해 설계되었다.
-
-## Installation
-
-```bash
-npm install @simplysm/capacitor-plugin-intent
-```
-
-## API Overview
-
-### 인텐트
-
-| API | Type | Description |
-|-----|------|-------------|
-| `IntentResult` | interface | 브로드캐스트/인텐트 결과 데이터 |
-| `StartActivityForResultOptions` | interface | startActivityForResult 호출 옵션 |
-| `StartActivityForResultResult` | interface | startActivityForResult 반환 결과 |
-| `IntentPlugin` | interface | Capacitor 네이티브 플러그인 인터페이스 |
-| `Intent` | abstract class | 인텐트 플러그인 정적 파사드 |
-
----
-
-## `IntentResult`
-
-브로드캐스트 또는 인텐트 결과 데이터를 나타내는 인터페이스.
-
-```typescript
-export interface IntentResult {
-  action?: string;
-  extras?: Record<string, unknown>;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `action` | `string \| undefined` | 브로드캐스트 액션 |
-| `extras` | `Record<string, unknown> \| undefined` | 추가 데이터 |
-
-## `StartActivityForResultOptions`
-
-`startActivityForResult` 호출 시 전달하는 옵션 인터페이스.
-
-```typescript
-export interface StartActivityForResultOptions {
-  action?: string;
-  uri?: string;
-  extras?: Record<string, unknown>;
-  type?: string;
-  packageName?: string;
-  className?: string;
-  flags?: number;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `action` | `string \| undefined` | Intent 액션 |
-| `uri` | `string \| undefined` | Intent 데이터 URI |
-| `extras` | `Record<string, unknown> \| undefined` | 추가 데이터 |
-| `type` | `string \| undefined` | MIME type |
-| `packageName` | `string \| undefined` | 특정 앱 지정 |
-| `className` | `string \| undefined` | 특정 Activity 지정 |
-| `flags` | `number \| undefined` | Intent flags |
-
-## `StartActivityForResultResult`
-
-`startActivityForResult` 호출의 반환 결과 인터페이스.
-
-```typescript
-export interface StartActivityForResultResult {
-  resultCode: number;
-  data?: {
-    action?: string;
-    uri?: string;
-    extras?: Record<string, unknown>;
-  };
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `resultCode` | `number` | 결과 코드 (`-1`: RESULT_OK, `0`: RESULT_CANCELED) |
-| `data` | `object \| undefined` | 결과 데이터 |
-| `data.action` | `string \| undefined` | 결과 인텐트 액션 |
-| `data.uri` | `string \| undefined` | 결과 인텐트 데이터 URI |
-| `data.extras` | `Record<string, unknown> \| undefined` | 결과 인텐트 추가 데이터 |
-
-## `IntentPlugin`
-
-Capacitor 네이티브 플러그인 인터페이스. 직접 사용하지 않고 `Intent` 파사드를 통해 접근한다.
-
-```typescript
-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(
-    options: StartActivityForResultOptions,
-  ): Promise<StartActivityForResultResult>;
-}
-```
-
-| Method | Parameters | Return | Description |
-|--------|-----------|--------|-------------|
-| `subscribe` | `{ filters }, callback` | `Promise<{ id: string }>` | 브로드캐스트 수신기 등록 |
-| `unsubscribe` | `{ id }` | `Promise<void>` | 특정 수신기 구독 해제 |
-| `unsubscribeAll` | 없음 | `Promise<void>` | 모든 수신기 구독 해제 |
-| `send` | `{ action, extras? }` | `Promise<void>` | 브로드캐스트 전송 |
-| `getLaunchIntent` | 없음 | `Promise<IntentResult>` | 실행 인텐트 조회 |
-| `addListener` | `"newIntent", listenerFunc` | `Promise<PluginListenerHandle>` | 새 인텐트 이벤트 리스너 등록 |
-| `removeAllListeners` | 없음 | `Promise<void>` | 모든 이벤트 리스너 제거 |
-| `startActivityForResult` | `options` | `Promise<StartActivityForResultResult>` | 외부 Activity 실행 후 결과 수신 |
-
-## `Intent`
-
-Android 인텐트 플러그인 정적 파사드 클래스. 브로드캐스트 송수신, 실행 인텐트 조회, 산업용 디바이스 연동을 위한 기능을 제공한다.
-
-```typescript
-export abstract class Intent {
-  static async subscribe(
-    filters: string[],
-    callback: (result: IntentResult) => 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<IntentResult>;
-  static async addListener(
-    eventName: "newIntent",
-    callback: (result: IntentResult) => void,
-  ): Promise<PluginListenerHandle>;
-  static async removeAllListeners(): Promise<void>;
-  static async startActivityForResult(
-    options: StartActivityForResultOptions,
-  ): Promise<StartActivityForResultResult>;
-}
-```
-
-| Method | Parameters | Return | Description |
-|--------|-----------|--------|-------------|
-| `subscribe` | `filters: string[], callback` | `Promise<() => Promise<void>>` | 브로드캐스트 수신기 등록. 구독 해제 함수를 반환한다. 초기 resolve 콜백(`action == null`)은 자동 필터링된다. |
-| `unsubscribeAll` | 없음 | `Promise<void>` | 모든 브로드캐스트 수신기 구독 해제 |
-| `send` | `{ action, extras? }` | `Promise<void>` | 브로드캐스트 전송 |
-| `getLaunchIntent` | 없음 | `Promise<IntentResult>` | 앱 실행 인텐트 조회 |
-| `addListener` | `"newIntent", callback` | `Promise<PluginListenerHandle>` | 앱 실행 중 수신되는 새 인텐트 이벤트 리스너 등록. `handle.remove()`로 해제한다. |
-| `removeAllListeners` | 없음 | `Promise<void>` | 모든 이벤트 리스너 제거 |
-| `startActivityForResult` | `options: StartActivityForResultOptions` | `Promise<StartActivityForResultResult>` | 외부 Activity를 실행하고 결과를 수신한다 |
-
-## Usage Examples
-
-### 브로드캐스트 수신 (바코드 스캐너 연동)
-
-```typescript
-import { Intent } from "@simplysm/capacitor-plugin-intent";
-
-const unsub = await Intent.subscribe(
-  ["com.symbol.datawedge.api.RESULT_ACTION"],
-  (result) => {
-    // result.extras에서 스캔 데이터 처리
-  },
-);
-
-// 구독 해제
-await unsub();
-```
-
-### 브로드캐스트 전송
-
-```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",
-  },
-});
-```
-
-### startActivityForResult
-
-```typescript
-import { Intent } from "@simplysm/capacitor-plugin-intent";
-
-const result = await Intent.startActivityForResult({
-  action: "com.example.PAY",
-  extras: { amount: 1000 },
-});
-if (result.resultCode === -1) {
-  // RESULT_OK
-}
-```

package/claude/references/sd-simplysm14/capacitor-plugin-usb-storage/usage.md

@@ -1,258 +0,0 @@
-# @simplysm/capacitor-plugin-usb-storage
-
-Capacitor USB 저장소 플러그인. Android에서 libaums 라이브러리를 통해 USB Mass Storage 장치를 열거하고 파일을 읽는다. 브라우저에서는 IndexedDB 기반 가상 USB 저장소로 에뮬레이션한다.
-
-## Installation
-
-```bash
-npm install @simplysm/capacitor-plugin-usb-storage
-```
-
-## API Overview
-
-### USB 저장소 - 공개 API
-
-| API | Type | Description |
-|-----|------|-------------|
-| `UsbDeviceInfo` | interface | USB 장치 정보 (이름, 제조사, vendorId 등) |
-| `UsbDeviceFilter` | interface | USB 장치 필터 (vendorId + productId) |
-| `UsbFileInfo` | interface | USB 저장소 내 파일/디렉토리 정보 |
-| `UsbStoragePlugin` | interface | Capacitor 네이티브 플러그인 인터페이스 |
-| `UsbStorage` | abstract class | USB 저장 장치 접근 정적 파사드 |
-
----
-
-## `UsbDeviceInfo`
-
-연결된 USB 장치 정보를 나타내는 인터페이스.
-
-```typescript
-export interface UsbDeviceInfo {
-  deviceName: string;
-  manufacturerName: string;
-  productName: string;
-  vendorId: number;
-  productId: number;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `deviceName` | `string` | 장치 이름 |
-| `manufacturerName` | `string` | 제조사 이름 |
-| `productName` | `string` | 제품 이름 |
-| `vendorId` | `number` | USB Vendor ID |
-| `productId` | `number` | USB Product ID |
-
-## `UsbDeviceFilter`
-
-USB 장치를 식별하기 위한 필터 인터페이스. 모든 장치 접근 메서드의 첫 번째 파라미터로 사용된다.
-
-```typescript
-export interface UsbDeviceFilter {
-  vendorId: number;
-  productId: number;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `vendorId` | `number` | USB Vendor ID |
-| `productId` | `number` | USB Product ID |
-
-## `UsbFileInfo`
-
-USB 저장소 내 파일 또는 디렉토리 정보를 나타내는 인터페이스.
-
-```typescript
-export interface UsbFileInfo {
-  name: string;
-  isDirectory: boolean;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `name` | `string` | 파일 또는 디렉토리 이름 |
-| `isDirectory` | `boolean` | 디렉토리 여부 |
-
-## `UsbStoragePlugin`
-
-Capacitor 네이티브 플러그인 인터페이스. 직접 사용하지 않고 `UsbStorage` 파사드를 통해 접근한다.
-
-```typescript
-export interface UsbStoragePlugin {
-  getDevices(): Promise<{ devices: UsbDeviceInfo[] }>;
-  requestPermissions(options: UsbDeviceFilter): Promise<{ granted: boolean }>;
-  checkPermissions(options: UsbDeviceFilter): Promise<{ granted: boolean }>;
-  readdir(options: UsbDeviceFilter & { path: string }): Promise<{ files: UsbFileInfo[] }>;
-  readFile(options: UsbDeviceFilter & { path: string }): Promise<{ data: string | null }>;
-}
-```
-
-| Method | Parameters | Return | Description |
-|--------|-----------|--------|-------------|
-| `getDevices` | 없음 | `Promise<{ devices: UsbDeviceInfo[] }>` | 연결된 USB 장치 목록 조회 |
-| `requestPermissions` | `UsbDeviceFilter` | `Promise<{ granted: boolean }>` | USB 장치 접근 권한 요청 |
-| `checkPermissions` | `UsbDeviceFilter` | `Promise<{ granted: boolean }>` | USB 장치 접근 권한 확인 |
-| `readdir` | `UsbDeviceFilter & { path }` | `Promise<{ files: UsbFileInfo[] }>` | 디렉토리 내용 읽기 |
-| `readFile` | `UsbDeviceFilter & { path }` | `Promise<{ data: string \| null }>` | 파일 읽기 (Base64). 파일이 없으면 `null` |
-
-## `UsbStorage`
-
-USB 저장 장치 접근 정적 파사드 클래스. Android에서는 libaums를 통해 USB Mass Storage에 접근하고, 브라우저에서는 IndexedDB 기반으로 에뮬레이션된다.
-
-`readFile()`의 반환 타입 `Bytes`는 `@simplysm/core-common`의 타입이다 (`Uint8Array` 별칭).
-
-```typescript
-export abstract class UsbStorage {
-  static async getDevices(): Promise<UsbDeviceInfo[]>;
-  static async requestPermissions(filter: UsbDeviceFilter): Promise<boolean>;
-  static async checkPermissions(filter: UsbDeviceFilter): Promise<boolean>;
-  static async readdir(filter: UsbDeviceFilter, dirPath: string): Promise<UsbFileInfo[]>;
-  static async readFile(filter: UsbDeviceFilter, filePath: string): Promise<Bytes | undefined>;
-}
-```
-
-| Method | Parameters | Return | Description |
-|--------|-----------|--------|-------------|
-| `getDevices` | 없음 | `Promise<UsbDeviceInfo[]>` | 연결된 USB Mass Storage 장치 목록 조회 |
-| `requestPermissions` | `filter: UsbDeviceFilter` | `Promise<boolean>` | USB 장치 접근 권한 요청. 승인 여부 반환 |
-| `checkPermissions` | `filter: UsbDeviceFilter` | `Promise<boolean>` | USB 장치 접근 권한 보유 여부 확인 |
-| `readdir` | `filter: UsbDeviceFilter, dirPath: string` | `Promise<UsbFileInfo[]>` | USB 저장 장치의 디렉토리 내용 읽기 |
-| `readFile` | `filter: UsbDeviceFilter, filePath: string` | `Promise<Bytes \| undefined>` | USB 저장 장치에서 파일 읽기. 파일이 없으면 `undefined` 반환. 최대 100MB |
-
-## Browser-Only Testing API (`UsbStorageWeb`)
-
-브라우저 환경에서 테스트 및 개발 목적으로 사용하는 API. `UsbStorage` 정적 파사드로는 접근할 수 없으며, `UsbStorageWeb` 인스턴스를 직접 사용할 때만 호출 가능하다.
-
-### `addVirtualDevice(device)`
-
-가상 USB 장치를 IndexedDB에 등록한다. (테스트/개발용)
-
-```typescript
-async addVirtualDevice(device: {
-  vendorId: number;
-  productId: number;
-  deviceName: string;
-  manufacturerName: string;
-  productName: string;
-}): Promise<void>
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `device.vendorId` | `number` | USB Vendor ID |
-| `device.productId` | `number` | USB Product ID |
-| `device.deviceName` | `string` | 장치 이름 |
-| `device.manufacturerName` | `string` | 제조사 이름 |
-| `device.productName` | `string` | 제품 이름 |
-
-### `addVirtualFile(filter, filePath, data)`
-
-가상 USB 장치에 파일을 추가한다. (테스트/개발용)
-
-```typescript
-async addVirtualFile(
-  filter: UsbDeviceFilter,
-  filePath: string,
-  data: Uint8Array,
-): Promise<void>
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `filter.vendorId` | `number` | 대상 장치의 USB Vendor ID |
-| `filter.productId` | `number` | 대상 장치의 USB Product ID |
-| `filePath` | `string` | 파일 경로 (예: `/updates/config.json`) |
-| `data` | `Uint8Array` | 파일 바이너리 데이터 |
-
-**주의**: 파일이 위치할 부모 디렉토리가 존재하지 않으면 자동으로 생성된다.
-
-### `addVirtualDirectory(filter, dirPath)`
-
-가상 USB 장치에 디렉토리를 추가한다. (테스트/개발용)
-
-```typescript
-async addVirtualDirectory(
-  filter: UsbDeviceFilter,
-  dirPath: string,
-): Promise<void>
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `filter.vendorId` | `number` | 대상 장치의 USB Vendor ID |
-| `filter.productId` | `number` | 대상 장치의 USB Product ID |
-| `dirPath` | `string` | 생성할 디렉토리 경로 (예: `/updates`) |
-
----
-
-## Usage Examples
-
-### USB 장치 열거 및 권한 요청
-
-```typescript
-import { UsbStorage } from "@simplysm/capacitor-plugin-usb-storage";
-
-const devices = await UsbStorage.getDevices();
-if (devices.length > 0) {
-  const device = devices[0];
-  const filter = { vendorId: device.vendorId, productId: device.productId };
-
-  const granted = await UsbStorage.checkPermissions(filter);
-  if (!granted) {
-    await UsbStorage.requestPermissions(filter);
-  }
-}
-```
-
-### USB 저장소 파일 읽기
-
-```typescript
-import { UsbStorage } from "@simplysm/capacitor-plugin-usb-storage";
-import type { UsbDeviceFilter } from "@simplysm/capacitor-plugin-usb-storage";
-
-const filter: UsbDeviceFilter = { vendorId: 1234, productId: 5678 };
-
-// 디렉토리 목록 조회
-const files = await UsbStorage.readdir(filter, "/updates");
-
-// 파일 읽기 (Bytes | undefined 반환)
-const data = await UsbStorage.readFile(filter, "/updates/config.json");
-if (data != null) {
-  const text = new TextDecoder().decode(data);
-}
-```
-
-### 브라우저 테스트 - 가상 USB 장치 설정
-
-브라우저 환경에서 테스트할 때, `UsbStorageWeb`을 직접 import하여 가상 USB 저장소를 설정한다. `UsbStorageWeb`은 패키지 공개 API(`index.ts`)에서 export되지 않으므로, 소스 경로를 직접 참조한다.
-
-```typescript
-import { UsbStorageWeb } from "@simplysm/capacitor-plugin-usb-storage/src/web/UsbStorageWeb";
-import { UsbStorage } from "@simplysm/capacitor-plugin-usb-storage";
-
-const usbStorageWeb = new UsbStorageWeb();
-
-// 가상 장치 등록
-await usbStorageWeb.addVirtualDevice({
-  vendorId: 1234,
-  productId: 5678,
-  deviceName: "Test Device",
-  manufacturerName: "Test Manufacturer",
-  productName: "Test Product",
-});
-
-// 가상 파일 추가
-const fileData = new TextEncoder().encode("Hello, USB!");
-await usbStorageWeb.addVirtualFile(
-  { vendorId: 1234, productId: 5678 },
-  "/updates/config.json",
-  fileData,
-);
-
-// UsbStorage 정적 API로 접근 (Capacitor가 브라우저에서 UsbStorageWeb 인스턴스를 사용)
-const files = await UsbStorage.readdir({ vendorId: 1234, productId: 5678 }, "/updates");
-const data = await UsbStorage.readFile({ vendorId: 1234, productId: 5678 }, "/updates/config.json");
-```