tudada-sdk-types 0.0.1 → 0.1.2

package/README.md

@@ -10,22 +10,23 @@ npm install tudada-sdk-types
 
 ## Usage
 
-### With Script Tag (Global)
+### Global Types (Recommended)
 
-When using TudadaSDK via script tag, the types are automatically available globally:
-
-```html
-<script src="https://your-cdn-url.com/tudadaGameSDK.js"></script>
-```
+After installing `tudada-sdk-types`, global types are **automatically available** without any import:
 
 ```typescript
-// Types are available globally
+// No import needed! Types are automatically recognized
 TudadaSDK.login({
   success: (res) => console.log('Login code:', res.code),
   fail: (err) => console.error('Login failed:', err.errMsg),
 });
+
+const systemInfo = TudadaSDK.getSystemInfoSync();
+console.log('Platform:', systemInfo.platform);
 ```
 
+This works because the package includes `global.d.ts` which declares the global `TudadaSDK` and `tudadaSDK` variables.
+
 ### Import Types
 
 You can also import types directly:

package/index.d.ts

@@ -13,6 +13,7 @@
  * - **UI**: UI 정보 (getMenuButtonBoundingClientRect)
  * - **Device**: 디바이스 제어 (vibrateShort, vibrateLong, showKeyboard, hideKeyboard, onKeyboardInput, offKeyboardInput, onKeyboardConfirm, offKeyboardConfirm, onKeyboardComplete, offKeyboardComplete)
  * - **Clipboard**: 클립보드 (setClipboardData, getClipboardData)
+ * - **Audio**: 오디오 (createInnerAudioContext)
  * - **Ad**: 광고 (createRewardedVideoAd)
  * - **Lifecycle**: 앱 라이프사이클 (onShow, onHide, exitMiniProgram, restartMiniProgram)
  *
@@ -501,6 +502,9 @@ export interface GetClipboardDataOption {
 /** 플랫폼 타입 */
 export type Platform = 'ios' | 'android' | 'windows' | 'mac' | 'devtools';
 
+/** 접속 환경 */
+export type Environment = 'prod' | 'dev';
+
 /** 안전 영역 정보 */
 export interface SafeArea {
     /** 안전 영역 좌상단 X 좌표 */
@@ -530,6 +534,8 @@ export interface SystemInfo {
     fontSizeSetting: Mock<16>;
     /** 호스트 앱 정보 */
     host: { appId: string };
+    /** 접속 환경 */
+    environment: Environment;
     /** 디바이스 픽셀 비율 */
     pixelRatio: number;
     /** 화면 너비 (px) */
@@ -582,8 +588,8 @@ export interface SystemInfo {
     bluetoothEnabled: Mock<false>;
     /** 위치 서비스 활성화 상태 - 호환용 */
     locationEnabled: Mock<false>;
-    /** Wi-Fi 활성화 상태 - 호환용 */
-    wifiEnabled: Mock<false>;
+    /** Wi-Fi 활성화 상태 */
+    wifiEnabled: boolean;
     /** 정밀도 낮은 위치 사용 여부 - 호환용 */
     locationReducedAccuracy?: Mock<false>;
 }
@@ -640,12 +646,14 @@ export interface AppBaseInfo {
     fontSizeSetting: Mock<16>;
     /** 호스트 앱 정보 */
     host: { appId: string };
+    /** 접속 환경 */
+    environment: Environment;
     /** 글꼴 크기 확대 비율 - 호환용 */
     fontSizeScaleFactor: Mock<1>;
     /** 사용자 설정 언어 - 호환용 */
     language: Mock<'KO'>;
     /** 테마 설정 */
-    theme?: 'light' | 'dark';
+    theme: 'light' | 'dark';
 }
 
 /** getAppBaseInfo 옵션 */
@@ -722,6 +730,8 @@ export interface LoginSuccessResult {
     errCode?: number;
     /** 사용자 로그인 코드 */
     code: string;
+    /** 사용자 고유 ID */
+    userId: string;
 }
 
 /** 로그인 옵션 */
@@ -796,6 +806,107 @@ export interface GetUserInfoOption {
     complete?: (res: GetUserInfoSuccessResult | GeneralCallbackResult) => void;
 }
 
+// ============================================
+// Audio API 타입
+// ============================================
+
+/** InnerAudioContext 에러 결과 */
+export interface InnerAudioContextError {
+    /** 에러 코드 */
+    errCode: number;
+    /** 에러 메시지 */
+    errMsg: string;
+}
+
+/**
+ * InnerAudioContext 인스턴스
+ *
+ * HTML5 Audio를 래핑하여 WeChat InnerAudioContext 호환 인터페이스를 제공합니다.
+ *
+ * @see https://developers.weixin.qq.com/minigame/dev/api/media/audio/InnerAudioContext.html
+ */
+export interface InnerAudioContext {
+    /** 오디오 리소스 URL */
+    src: string;
+    /** 재생 시작 위치 (초 단위) */
+    startTime: number;
+    /** 자동 재생 여부 */
+    autoplay: boolean;
+    /** 반복 재생 여부 */
+    loop: boolean;
+    /**
+     * 볼륨 (0~1)
+     *
+     * @remarks
+     * iOS Safari에서는 HTMLAudioElement.volume이 무시됩니다 (하드웨어 버튼으로만 제어 가능).
+     */
+    volume: number;
+    /** 재생 속도 (0.5~2.0) */
+    playbackRate: number;
+
+    /** 총 재생 시간 (초 단위, 읽기 전용) */
+    readonly duration: number;
+    /** 현재 재생 위치 (초 단위, 읽기 전용) */
+    readonly currentTime: number;
+    /** 일시정지 상태 여부 (읽기 전용) */
+    readonly paused: boolean;
+    /** 버퍼링된 시간 (초 단위, 읽기 전용) */
+    readonly buffered: number;
+
+    /** 재생 */
+    play(): void;
+    /** 일시정지 */
+    pause(): void;
+    /** 정지 (재생 위치를 0으로 초기화) */
+    stop(): void;
+    /** 특정 위치로 이동 (초 단위) */
+    seek(position: number): void;
+    /** 인스턴스 파괴 및 리소스 해제 */
+    destroy(): void;
+
+    /** 재생 가능 상태 이벤트 */
+    onCanplay(callback: () => void): void;
+    /** 재생 시작 이벤트 */
+    onPlay(callback: () => void): void;
+    /** 일시정지 이벤트 */
+    onPause(callback: () => void): void;
+    /** 정지 이벤트 */
+    onStop(callback: () => void): void;
+    /** 재생 완료 이벤트 */
+    onEnded(callback: () => void): void;
+    /** 재생 시간 업데이트 이벤트 */
+    onTimeUpdate(callback: () => void): void;
+    /** 에러 이벤트 */
+    onError(callback: (res: InnerAudioContextError) => void): void;
+    /** 버퍼링 대기 이벤트 */
+    onWaiting(callback: () => void): void;
+    /** 탐색 시작 이벤트 */
+    onSeeking(callback: () => void): void;
+    /** 탐색 완료 이벤트 */
+    onSeeked(callback: () => void): void;
+
+    /** 재생 가능 상태 이벤트 해제 */
+    offCanplay(callback?: () => void): void;
+    /** 재생 시작 이벤트 해제 */
+    offPlay(callback?: () => void): void;
+    /** 일시정지 이벤트 해제 */
+    offPause(callback?: () => void): void;
+    /** 정지 이벤트 해제 */
+    offStop(callback?: () => void): void;
+    /** 재생 완료 이벤트 해제 */
+    offEnded(callback?: () => void): void;
+    /** 재생 시간 업데이트 이벤트 해제 */
+    offTimeUpdate(callback?: () => void): void;
+    /** 에러 이벤트 해제 */
+    offError(callback?: (res: InnerAudioContextError) => void): void;
+    /** 버퍼링 대기 이벤트 해제 */
+    offWaiting(callback?: () => void): void;
+    /** 탐색 시작 이벤트 해제 */
+    offSeeking(callback?: () => void): void;
+    /** 탐색 완료 이벤트 해제 */
+    offSeeked(callback?: () => void): void;
+}
+
 // ============================================
 // Ad API 타입
 // ============================================
@@ -1112,6 +1223,18 @@ export interface ITudadaSDK {
      */
     getClipboardData(options?: GetClipboardDataOption): void;
 
+    // ============================================
+    // Audio API
+    // ============================================
+
+    /**
+     * InnerAudioContext 인스턴스 생성
+     *
+     * HTML5 Audio를 래핑한 오디오 재생 객체를 생성합니다.
+     * 매 호출마다 새로운 인스턴스를 반환합니다.
+     */
+    createInnerAudioContext(): InnerAudioContext;
+
     // ============================================
     // Ad API
     // ============================================
@@ -1163,7 +1286,7 @@ export interface ITudadaSDK {
 declare global {
     /** TudadaSDK 글로벌 인스턴스 */
     const TudadaSDK: ITudadaSDK;
-    /** TudadaSDK 글로벌 인스턴스 (별칭) */
+    /** TudadaSDK 글로벌 인스턴스 (소문자) */
     const tudadaSDK: ITudadaSDK;
 
     interface Window {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tudada-sdk-types",
-  "version": "0.0.1",
+  "version": "0.1.2",
   "description": "TypeScript type definitions for TudadaSDK - H5 web game SDK for Tudada platform",
   "keywords": [
     "tudada",