@ayden-fc2/riffle-bridge-web 1.0.0

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@ayden-fc2/riffle-bridge-web",
+  "version": "1.0.0",
+  "description": "Riffle Bridge Web SDK - WebView 与 Native 通信桥接库",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --ext .ts,.tsx"
+  },
+  "keywords": [
+    "react-native",
+    "webview",
+    "bridge",
+    "riffle",
+    "sdk"
+  ],
+  "author": "Riffle Team",
+  "license": "MIT",
+  "peerDependencies": {
+    "react": ">=17.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/react": "^18.2.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  }
+}

package/src/bridge.ts

@@ -0,0 +1,157 @@
+/**
+ * Riffle Bridge 主类
+ * 
+ * 提供完整的 WebView Bridge API
+ */
+
+import { BridgeCore, getBridgeCore } from './core';
+import {
+  HapticController,
+  SensorController,
+  DeviceController,
+  FileStorageController,
+  AudioController,
+  CameraController,
+  MicrophoneController,
+  ConfigController,
+} from './controllers';
+import type { HapticFeedbackType, TiltDirection, ShakeIntensity } from './types';
+
+/**
+ * 工具函数类
+ */
+export class Utils {
+  /**
+   * 计算向量模长
+   */
+  static magnitude(x: number, y: number, z: number): number {
+    return Math.sqrt(x * x + y * y + z * z);
+  }
+
+  /**
+   * 获取倾斜方向
+   */
+  static getTiltDirection(x: number, y: number, threshold = 2): TiltDirection {
+    if (Math.abs(x) > Math.abs(y)) {
+      return x > threshold ? 'right' : x < -threshold ? 'left' : 'center';
+    } else {
+      return y > threshold ? 'forward' : y < -threshold ? 'backward' : 'center';
+    }
+  }
+
+  /**
+   * 获取摇晃强度
+   */
+  static getShakeIntensity(x: number, y: number, z: number): ShakeIntensity {
+    const magnitude = this.magnitude(x, y, z);
+    if (magnitude > 15) return 'strong';
+    if (magnitude > 8) return 'medium';
+    if (magnitude > 3) return 'light';
+    return 'none';
+  }
+}
+
+/**
+ * RiffleBridge 主类
+ * 
+ * @example
+ * ```typescript
+ * import { RiffleBridge } from '@riffle/bridge-web';
+ * 
+ * const bridge = new RiffleBridge();
+ * 
+ * // 检查是否可用
+ * if (bridge.isAvailable()) {
+ *   // 震动
+ *   await bridge.vibrate('success');
+ *   
+ *   // 使用传感器
+ *   await bridge.sensor.start({ types: ['accelerometer'] });
+ *   bridge.sensor.onAccelerometer((data) => {
+ *     console.log(data);
+ *   });
+ * }
+ * ```
+ */
+export class RiffleBridge {
+  private core: BridgeCore;
+
+  /** 震动控制器 */
+  public readonly haptic: HapticController;
+  /** 传感器控制器 */
+  public readonly sensor: SensorController;
+  /** 设备信息控制器 */
+  public readonly device: DeviceController;
+  /** 文件存储控制器 */
+  public readonly fileStorage: FileStorageController;
+  /** 音频控制器 */
+  public readonly audio: AudioController;
+  /** 相机控制器 */
+  public readonly camera: CameraController;
+  /** 麦克风控制器 */
+  public readonly microphone: MicrophoneController;
+  /** 配置控制器 */
+  public readonly config: ConfigController;
+  /** 工具函数 */
+  public readonly utils = Utils;
+
+  constructor() {
+    this.core = getBridgeCore();
+    
+    // 初始化各控制器
+    this.haptic = new HapticController(this.core);
+    this.sensor = new SensorController(this.core);
+    this.device = new DeviceController(this.core);
+    this.fileStorage = new FileStorageController(this.core);
+    this.audio = new AudioController(this.core, this.fileStorage);
+    this.camera = new CameraController(this.core);
+    this.microphone = new MicrophoneController(this.core);
+    this.config = new ConfigController(this.core);
+  }
+
+  /**
+   * 检查 Bridge 是否可用
+   */
+  isAvailable(): boolean {
+    return this.core.isAvailable();
+  }
+
+  /**
+   * 等待 Bridge 就绪
+   */
+  async waitForReady(timeout?: number): Promise<boolean> {
+    return this.core.waitForReady(timeout);
+  }
+
+  /**
+   * 获取 SDK 版本
+   */
+  getVersion(): string {
+    return '1.0.0';
+  }
+
+  /**
+   * 便捷方法：震动
+   */
+  async vibrate(type: HapticFeedbackType = 'light'): Promise<void> {
+    const method = this.haptic[type as keyof HapticController];
+    if (typeof method === 'function') {
+      await (method as () => Promise<void>).call(this.haptic);
+    } else {
+      throw new Error(`Unsupported haptic type: ${type}`);
+    }
+  }
+}
+
+// 单例实例
+let riffleBridgeInstance: RiffleBridge | null = null;
+
+/**
+ * 获取 RiffleBridge 单例
+ */
+export function getRiffleBridge(): RiffleBridge {
+  if (!riffleBridgeInstance) {
+    riffleBridgeInstance = new RiffleBridge();
+  }
+  return riffleBridgeInstance;
+}