@aippy/runtime 0.2.5-dev.0 → 0.2.6-dev.0

package/dist/core/index.js

@@ -1,4 +1,5 @@
-import { a as d, A as f, C as u, E as A, R as _, b as m, c as R, p as g } from "../runtime-DjBdOttl.js";
+import { A as v, E as d, c as u } from "../errors-CDEBaBxB.js";
+import { A as m, C as _, R, a as g, p as I } from "../runtime-CmoG3v2m.js";
 const s = {
   mode: "development",
   debug: !1,
@@ -9,7 +10,7 @@ function o() {
   const e = {};
   return typeof process < "u" && process.env && (process.env.NODE_ENV && (e.mode = process.env.NODE_ENV), process.env.AIPPY_DEBUG && (e.debug = process.env.AIPPY_DEBUG === "true"), process.env.AIPPY_API_BASE_URL && (e.apiBaseUrl = process.env.AIPPY_API_BASE_URL)), e;
 }
-function c(e) {
+function p(e) {
   const n = o();
   return {
     ...s,
@@ -22,10 +23,10 @@ function c(e) {
     }
   };
 }
-const r = "0.2.5-dev.0", a = {
+const r = "0.2.6-dev.0", a = {
   version: r
 }, i = a.version, t = "@aippy/runtime";
-function p() {
+function c() {
   return {
     name: t,
     version: i,
@@ -33,18 +34,18 @@ function p() {
   };
 }
 export {
-  d as AippyRuntime,
-  f as AippyRuntimeError,
-  u as Cancellable,
+  m as AippyRuntime,
+  v as AippyRuntimeError,
+  _ as Cancellable,
   s as DEFAULT_CONFIG,
-  A as ERROR_CODES,
-  _ as ReceiveChannel,
+  d as ERROR_CODES,
+  R as ReceiveChannel,
   t as SDK_NAME,
   i as VERSION,
-  m as aippyRuntime,
-  R as createError,
+  g as aippyRuntime,
+  u as createError,
   o as getConfigFromEnv,
-  p as getVersionInfo,
-  c as mergeConfig,
-  g as processMotionData
+  c as getVersionInfo,
+  p as mergeConfig,
+  I as processMotionData
 };

package/dist/core/native-bridge.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Native Bridge Detection
+ * Shared utility for detecting iOS native bridge availability
+ */
+/**
+ * Check if native bridge is available (iOS WebView)
+ * Used by both device and user modules
+ */
+export declare function hasNativeBridge(): boolean;

package/dist/device/index.js

@@ -1,10 +1,12 @@
-var L = Object.defineProperty;
-var T = (n, t, e) => t in n ? L(n, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : n[t] = e;
-var S = (n, t, e) => T(n, typeof t != "symbol" ? t + "" : t, e);
-import { c, b as k } from "../runtime-DjBdOttl.js";
-class D {
+var U = Object.defineProperty;
+var D = (r, t, e) => t in r ? U(r, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : r[t] = e;
+var A = (r, t, e) => D(r, typeof t != "symbol" ? t + "" : t, e);
+import { c } from "../errors-CDEBaBxB.js";
+import { a as L } from "../runtime-CmoG3v2m.js";
+import { h as N } from "../native-bridge-JAmH-zTN.js";
+class T {
   constructor() {
-    S(this, "stream", null);
+    A(this, "stream", null);
   }
   /**
    * Check if camera is supported
@@ -47,11 +49,11 @@ class D {
       if (!o)
         throw c("Failed to get canvas context", "UNKNOWN_ERROR");
       i.width = t.width || e.videoWidth, i.height = t.height || e.videoHeight, o.drawImage(e, 0, 0, i.width, i.height);
-      const r = t.format || "jpeg", s = t.quality === "high" ? 0.9 : t.quality === "medium" ? 0.7 : 0.5, a = await new Promise((u, m) => {
+      const n = t.format || "jpeg", s = t.quality === "high" ? 0.9 : t.quality === "medium" ? 0.7 : 0.5, a = await new Promise((u, m) => {
         i.toBlob((l) => {
           l ? u(l) : m(new Error("Failed to create blob"));
-        }, `image/${r}`, s);
-      }), d = i.toDataURL(`image/${r}`, s);
+        }, `image/${n}`, s);
+      }), d = i.toDataURL(`image/${n}`, s);
       return {
         blob: a,
         dataUrl: d,
@@ -72,8 +74,8 @@ class D {
     this.stream && (this.stream.getTracks().forEach((t) => t.stop()), this.stream = null);
   }
 }
-const H = new D();
-class x {
+const H = new T();
+class k {
   /**
    * Check if geolocation is supported
    */
@@ -93,29 +95,29 @@ class x {
         maximumAge: t.maximumAge ?? 6e4
       };
       navigator.geolocation.getCurrentPosition(
-        (r) => {
+        (n) => {
           const s = {
-            latitude: r.coords.latitude,
-            longitude: r.coords.longitude,
-            accuracy: r.coords.accuracy,
-            altitude: r.coords.altitude ?? void 0,
-            altitudeAccuracy: r.coords.altitudeAccuracy ?? void 0,
-            heading: r.coords.heading ?? void 0,
-            speed: r.coords.speed ?? void 0,
-            timestamp: r.timestamp
+            latitude: n.coords.latitude,
+            longitude: n.coords.longitude,
+            accuracy: n.coords.accuracy,
+            altitude: n.coords.altitude ?? void 0,
+            altitudeAccuracy: n.coords.altitudeAccuracy ?? void 0,
+            heading: n.coords.heading ?? void 0,
+            speed: n.coords.speed ?? void 0,
+            timestamp: n.timestamp
           };
           e(s);
         },
-        (r) => {
+        (n) => {
           let s = "UNKNOWN_ERROR", a = "Unknown geolocation error";
-          switch (r.code) {
-            case r.PERMISSION_DENIED:
+          switch (n.code) {
+            case n.PERMISSION_DENIED:
               s = "PERMISSION_DENIED", a = "Geolocation permission denied";
               break;
-            case r.POSITION_UNAVAILABLE:
+            case n.POSITION_UNAVAILABLE:
               a = "Position unavailable";
               break;
-            case r.TIMEOUT:
+            case n.TIMEOUT:
               a = "Geolocation timeout";
               break;
           }
@@ -138,7 +140,7 @@ class x {
     };
     return navigator.geolocation.watchPosition(
       (o) => {
-        const r = {
+        const n = {
           latitude: o.coords.latitude,
           longitude: o.coords.longitude,
           accuracy: o.coords.accuracy,
@@ -148,7 +150,7 @@ class x {
           speed: o.coords.speed ?? void 0,
           timestamp: o.timestamp
         };
-        t(r);
+        t(n);
       },
       (o) => {
         console.error("Geolocation watch error:", o);
@@ -163,47 +165,37 @@ class x {
     navigator.geolocation.clearWatch(t);
   }
 }
-const C = new x();
+const K = new k();
 function E() {
   return "DeviceMotionEvent" in window;
 }
-function N() {
-  return "DeviceOrientationEvent" in window;
-}
 function R() {
-  const n = typeof window < "u", t = n && !!window.webkit, e = t && !!window.webkit?.messageHandlers, i = e && !!window.webkit?.messageHandlers?.aippyListener;
-  return console.log("🔍 [Aippy Sensors] hasNativeBridge check:", {
-    hasWindow: n,
-    hasWebkit: t,
-    hasMessageHandlers: e,
-    hasAippyListener: i,
-    result: i
-  }), i;
+  return "DeviceOrientationEvent" in window;
 }
 function I() {
   return typeof window < "u" && typeof window.orientation < "u" ? window.orientation : typeof window < "u" && window.screen?.orientation?.angle !== void 0 ? window.screen.orientation.angle : 0;
 }
-function P(n, t, e) {
+function P(r, t, e) {
   switch (e) {
     case 0:
-      return [n, -t];
+      return [r, -t];
     case 180:
-      return [-n, t];
+      return [-r, t];
     case 90:
-      return [-t, n];
+      return [-t, r];
     case -90:
-      return [t, -n];
+      return [t, -r];
     default:
-      return [n, -t];
+      return [r, -t];
   }
 }
 async function b() {
-  if (console.log("🔐 [Aippy Sensors] requestMotionPermission called"), R())
+  if (console.log("🔐 [Aippy Sensors] requestMotionPermission called"), N())
     return console.log("✅ [Aippy Sensors] Native bridge available, skipping permission request"), !0;
   if (!E())
     return console.warn("❌ [Aippy Sensors] Device motion not supported"), !1;
-  const n = typeof DeviceMotionEvent < "u" && typeof DeviceMotionEvent.requestPermission == "function";
-  if (console.log("🔍 [Aippy Sensors] Permission API available:", n), n)
+  const r = typeof DeviceMotionEvent < "u" && typeof DeviceMotionEvent.requestPermission == "function";
+  if (console.log("🔍 [Aippy Sensors] Permission API available:", r), r)
     try {
       console.log("🙏 [Aippy Sensors] Requesting device motion permission...");
       const t = await DeviceMotionEvent.requestPermission();
@@ -213,25 +205,42 @@ async function b() {
     }
   return console.log("✅ [Aippy Sensors] No permission needed (granted by default)"), !0;
 }
-function F(n) {
+function x(r) {
   console.log("🔧 [Aippy Sensors] watchMotionNative - Setting up native bridge listener");
-  const t = k.addMotionListener((e) => {
-    const i = I(), o = e.gravity?.x ?? 0, r = e.gravity?.y ?? 0, s = e.gravity?.z ?? 0, a = e.userAcceleration?.x ?? 0, d = e.userAcceleration?.y ?? 0, u = e.userAcceleration?.z ?? 0, [m, l] = P(o, r, i), [y, v] = P(a, d, i), g = e.attitude && typeof e.attitude.yaw == "number" && typeof e.attitude.pitch == "number" && typeof e.attitude.roll == "number";
+  const t = L.addMotionListener((e) => {
+    const i = I(), o = e.gravity?.x ?? 0, n = e.gravity?.y ?? 0, s = e.gravity?.z ?? 0, a = e.userAcceleration?.x ?? 0, d = e.userAcceleration?.y ?? 0, u = e.userAcceleration?.z ?? 0, [m, l] = P(o, n, i), [y, v] = P(a, d, i), g = e.attitude && typeof e.attitude.yaw == "number" && typeof e.attitude.pitch == "number" && typeof e.attitude.roll == "number";
     let w = 0;
     g && (w = e.attitude.yaw * (180 / Math.PI), w < 0 && (w += 360));
     const f = {
-      gravity: { x: m, y: l, z: s },
-      acceleration: { x: y, y: v, z: u },
+      gravity: {
+        x: m,
+        y: l,
+        z: s
+        // Z-axis not affected by screen rotation
+      },
+      acceleration: {
+        x: y,
+        y: v,
+        z: u
+        // Z-axis not affected by screen rotation
+      },
       accelerationIncludingGravity: {
         x: m + y,
         y: l + v,
         z: s + u
       },
+      // iOS native uses rotationRate.x/y/z (rad/s)
+      // Convert to rotation.alpha/beta/gamma (deg/s)
       rotation: {
+        // If attitude is available, use yaw for alpha (compass heading)
+        // Otherwise fallback to rotationRate.z (angular velocity)
         alpha: g ? w : (e.rotationRate?.z ?? 0) * (180 / Math.PI),
         beta: (e.rotationRate?.x ?? 0) * (180 / Math.PI),
+        // x -> beta (around X-axis)
         gamma: (e.rotationRate?.y ?? 0) * (180 / Math.PI)
+        // y -> gamma (around Y-axis)
       },
+      // Add attitude data for more precise orientation info
       attitude: g ? {
         yaw: w,
         pitch: e.attitude.pitch * (180 / Math.PI),
@@ -245,11 +254,11 @@ function F(n) {
       } : void 0,
       timestamp: Date.now()
     };
-    n(f);
+    r(f);
   });
   return console.log("✅ [Aippy Sensors] watchMotionNative - Listener setup complete"), t;
 }
-function M(n, t = !0) {
+function _(r, t = !0) {
   if (!E())
     throw c("Device motion API is not supported", "NOT_SUPPORTED");
   let e = !1, i = null;
@@ -264,12 +273,22 @@ function M(n, t = !0) {
       const p = a.accelerationIncludingGravity, h = 9.8;
       u = (p?.x ?? 0) / h, m = (p?.y ?? 0) / h, l = (p?.z ?? 0) / h;
     }
-    const y = a.acceleration?.x ?? 0, v = a.acceleration?.y ?? 0, g = a.acceleration?.z ?? 0, [w, f] = P(u, m, d), [O, A] = P(y, v, d), U = {
-      gravity: { x: w, y: f, z: l },
-      acceleration: { x: O, y: A, z: g },
+    const y = a.acceleration?.x ?? 0, v = a.acceleration?.y ?? 0, g = a.acceleration?.z ?? 0, [w, f] = P(u, m, d), [O, S] = P(y, v, d), M = {
+      gravity: {
+        x: w,
+        y: f,
+        z: l
+        // Z-axis not affected by screen rotation
+      },
+      acceleration: {
+        x: O,
+        y: S,
+        z: g
+        // Z-axis not affected by screen rotation
+      },
       accelerationIncludingGravity: {
         x: w + O,
-        y: f + A,
+        y: f + S,
         z: l + g
       },
       rotation: {
@@ -279,60 +298,60 @@ function M(n, t = !0) {
       },
       timestamp: Date.now()
     };
-    n(U);
-  }, r = async () => {
+    r(M);
+  }, n = async () => {
     t && !await b() || (e = !0, window.addEventListener("devicemotion", o));
   };
   return (async () => {
     if (typeof DeviceMotionEvent < "u" && typeof DeviceMotionEvent.requestPermission == "function" && t) {
       const d = async () => {
-        i = null, await r();
+        i = null, await n();
       };
       window.addEventListener("click", d, { once: !0 }), window.addEventListener("touchstart", d, { once: !0 }), i = () => {
         window.removeEventListener("click", d), window.removeEventListener("touchstart", d);
       };
     } else
-      await r();
+      await n();
   })(), () => {
     e = !1, window.removeEventListener("devicemotion", o), i && (i(), i = null);
   };
 }
-function _(n, t, e = 500) {
-  let i = !1, o = null;
-  const r = F((a) => {
-    i || (i = !0, clearTimeout(s)), n(a);
-  }), s = setTimeout(() => {
-    i || (console.warn("[Aippy Sensors] No native data, falling back to Web API"), r(), o = M(n, t));
-  }, e);
-  return () => {
-    clearTimeout(s), r(), o?.();
-  };
-}
-function K(n, t = !0) {
-  return R() ? _(n, t) : M(n, t);
+function X(r, t = !0) {
+  const e = N();
+  return console.log(`🎯 [Aippy Sensors] watchMotion - Using ${e ? "NATIVE BRIDGE" : "WEB API"} mode`), e ? (console.log("📱 [Aippy Sensors] Starting native bridge motion listener"), x(r)) : (console.log("🌐 [Aippy Sensors] Starting Web API motion listener (may require permission)"), _(r, t));
 }
-function X(n) {
-  if (!N())
+function Y(r) {
+  if (!R())
     throw c("Device orientation API is not supported", "NOT_SUPPORTED");
   const t = (e) => {
-    n({
+    const i = {
       alpha: e.alpha ?? 0,
       beta: e.beta ?? 0,
       gamma: e.gamma ?? 0,
       timestamp: Date.now()
-    });
+    };
+    r(i);
   };
   return window.addEventListener("deviceorientation", t), () => {
     window.removeEventListener("deviceorientation", t);
   };
 }
-class z {
+class F {
+  /**
+   * Check if device orientation is supported
+   */
   isOrientationSupported() {
-    return N();
+    return R();
   }
+  /**
+   * Check if device motion is supported
+   */
   isMotionSupported() {
     return E();
   }
+  /**
+   * Get device orientation data
+   */
   async getOrientation() {
     if (!this.isOrientationSupported())
       throw c("Device orientation API is not supported", "NOT_SUPPORTED");
@@ -350,7 +369,10 @@ class z {
       }, 5e3);
     });
   }
-  /** @deprecated Use watchOrientation() instead */
+  /**
+   * Watch device orientation changes
+   * @deprecated Use watchOrientation() function instead
+   */
   watchOrientation(t) {
     if (!this.isOrientationSupported())
       throw c("Device orientation API is not supported", "NOT_SUPPORTED");
@@ -366,6 +388,9 @@ class z {
       window.removeEventListener("deviceorientation", e);
     };
   }
+  /**
+   * Get device motion data
+   */
   async getMotion() {
     if (!this.isMotionSupported())
       throw c("Device motion API is not supported", "NOT_SUPPORTED");
@@ -383,7 +408,10 @@ class z {
       }, 5e3);
     });
   }
-  /** @deprecated Use watchMotion() instead */
+  /**
+   * Watch device motion changes
+   * @deprecated Use watchMotion() function instead
+   */
   watchMotion(t) {
     if (!this.isMotionSupported())
       throw c("Device motion API is not supported", "NOT_SUPPORTED");
@@ -399,12 +427,15 @@ class z {
       window.removeEventListener("devicemotion", e);
     };
   }
+  /**
+   * Request permission for motion sensors (iOS 13+)
+   */
   async requestPermission() {
     return b();
   }
 }
-const Y = new z();
-class G {
+const B = new F();
+class z {
   /**
    * Check if file system access is supported
    */
@@ -428,16 +459,16 @@ class G {
         types: t.accept ? [{
           description: "Files",
           accept: Object.fromEntries(
-            t.accept.map((r) => [r, [r]])
+            t.accept.map((n) => [n, [n]])
           )
         }] : void 0,
         multiple: t.multiple ?? !1
       }, i = await window.showOpenFilePicker(e), o = await Promise.all(
-        i.map(async (r) => r.getFile())
+        i.map(async (n) => n.getFile())
       );
       return {
         files: o,
-        paths: o.map((r) => r.name)
+        paths: o.map((n) => n.name)
       };
     } catch (e) {
       throw e instanceof Error && e.name === "AbortError" ? c("File picker was cancelled", "PERMISSION_DENIED") : c(
@@ -454,8 +485,8 @@ class G {
       throw c("File input is not supported", "NOT_SUPPORTED");
     return new Promise((e, i) => {
       const o = document.createElement("input");
-      o.type = "file", o.multiple = t.multiple ?? !1, o.accept = t.accept?.join(",") ?? "", o.onchange = (r) => {
-        const s = r.target, a = Array.from(s.files || []);
+      o.type = "file", o.multiple = t.multiple ?? !1, o.accept = t.accept?.join(",") ?? "", o.onchange = (n) => {
+        const s = n.target, a = Array.from(s.files || []);
         e({
           files: a,
           paths: a.map((d) => d.name)
@@ -504,15 +535,15 @@ class G {
     });
   }
 }
-const j = new G();
-function $(n) {
+const $ = new z();
+function j(r) {
   return new Promise((t) => {
     if ("vibrate" in navigator)
-      navigator.vibrate(n), t();
+      navigator.vibrate(r), t();
     else if (window.webkit && window.webkit.messageHandlers && window.webkit.messageHandlers.aippyListener) {
       const e = {
         command: "navigator.vibrate",
-        parameters: n
+        parameters: r
       };
       window.webkit.messageHandlers.aippyListener.postMessage(e), t();
     } else
@@ -520,19 +551,19 @@ function $(n) {
   });
 }
 export {
-  D as CameraAPI,
-  G as FileSystemAPI,
-  x as GeolocationAPI,
-  z as SensorsAPI,
+  T as CameraAPI,
+  z as FileSystemAPI,
+  k as GeolocationAPI,
+  F as SensorsAPI,
   H as camera,
-  j as fileSystem,
-  C as geolocation,
-  R as hasNativeBridge,
+  $ as fileSystem,
+  K as geolocation,
+  N as hasNativeBridge,
   E as isMotionSupported,
-  N as isOrientationSupported,
+  R as isOrientationSupported,
   b as requestMotionPermission,
-  Y as sensors,
-  $ as vibrate,
-  K as watchMotion,
-  X as watchOrientation
+  B as sensors,
+  j as vibrate,
+  X as watchMotion,
+  Y as watchOrientation
 };

package/dist/device/sensors.d.ts

@@ -1,24 +1,72 @@
+import { hasNativeBridge } from '../core/native-bridge';
 import { SensorData, MotionData, OrientationData } from './types';
+export { hasNativeBridge };
+/**
+ * Check if device motion is supported
+ */
 export declare function isMotionSupported(): boolean;
+/**
+ * Check if device orientation is supported
+ */
 export declare function isOrientationSupported(): boolean;
-export declare function hasNativeBridge(): boolean;
-/** Request motion sensor permission (iOS 13+) */
+/**
+ * Request permission for motion sensors (iOS 13+)
+ * @returns Promise<boolean> - true if permission granted
+ */
 export declare function requestMotionPermission(): Promise<boolean>;
-/** Watch device motion (auto selects native bridge or Web API) */
+/**
+ * Watch device motion changes with full motion data
+ * Automatically uses native bridge if available, otherwise falls back to Web API
+ *
+ * @param callback - Function to call with motion data
+ * @param autoRequestPermission - Automatically request permission on iOS (default: true, only for Web API)
+ * @returns Cleanup function to stop watching
+ */
 export declare function watchMotion(callback: (data: MotionData) => void, autoRequestPermission?: boolean): () => void;
-/** Watch device orientation changes */
+/**
+ * Watch device orientation changes
+ * @param callback - Function to call with orientation data
+ * @returns Cleanup function to stop watching
+ */
 export declare function watchOrientation(callback: (data: OrientationData) => void): () => void;
-/** @deprecated Use watchMotion() and watchOrientation() instead */
+/**
+ * Legacy SensorsAPI class for backward compatibility
+ * @deprecated Use watchMotion() and watchOrientation() functions instead
+ */
 export declare class SensorsAPI {
+    /**
+     * Check if device orientation is supported
+     */
     isOrientationSupported(): boolean;
+    /**
+     * Check if device motion is supported
+     */
     isMotionSupported(): boolean;
+    /**
+     * Get device orientation data
+     */
     getOrientation(): Promise<SensorData>;
-    /** @deprecated Use watchOrientation() instead */
+    /**
+     * Watch device orientation changes
+     * @deprecated Use watchOrientation() function instead
+     */
     watchOrientation(callback: (data: SensorData) => void): () => void;
+    /**
+     * Get device motion data
+     */
     getMotion(): Promise<SensorData>;
-    /** @deprecated Use watchMotion() instead */
+    /**
+     * Watch device motion changes
+     * @deprecated Use watchMotion() function instead
+     */
     watchMotion(callback: (data: SensorData) => void): () => void;
+    /**
+     * Request permission for motion sensors (iOS 13+)
+     */
     requestPermission(): Promise<boolean>;
 }
-/** @deprecated Use watchMotion() and watchOrientation() instead */
+/**
+ * Sensors API instance (for backward compatibility)
+ * @deprecated Use watchMotion() and watchOrientation() functions instead
+ */
 export declare const sensors: SensorsAPI;