@aippy/runtime 0.2.3 → 0.2.4-dev.4

package/dist/device/sensors.d.ts

@@ -1,6 +1,39 @@
-import { SensorData } from './types';
+import { SensorData, MotionData, OrientationData } from './types';
 /**
- * Device sensors functionality wrapper
+ * Check if device motion is supported
+ */
+export declare function isMotionSupported(): boolean;
+/**
+ * Check if device orientation is supported
+ */
+export declare function isOrientationSupported(): boolean;
+/**
+ * Check if native bridge is available
+ */
+export declare function hasNativeBridge(): boolean;
+/**
+ * Request permission for motion sensors (iOS 13+)
+ * @returns Promise<boolean> - true if permission granted
+ */
+export declare function requestMotionPermission(): Promise<boolean>;
+/**
+ * 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
+ * @param callback - Function to call with orientation data
+ * @returns Cleanup function to stop watching
+ */
+export declare function watchOrientation(callback: (data: OrientationData) => void): () => void;
+/**
+ * Legacy SensorsAPI class for backward compatibility
+ * @deprecated Use watchMotion() and watchOrientation() functions instead
  */
 export declare class SensorsAPI {
     /**
@@ -17,6 +50,7 @@ export declare class SensorsAPI {
     getOrientation(): Promise<SensorData>;
     /**
      * Watch device orientation changes
+     * @deprecated Use watchOrientation() function instead
      */
     watchOrientation(callback: (data: SensorData) => void): () => void;
     /**
@@ -25,6 +59,7 @@ export declare class SensorsAPI {
     getMotion(): Promise<SensorData>;
     /**
      * Watch device motion changes
+     * @deprecated Use watchMotion() function instead
      */
     watchMotion(callback: (data: SensorData) => void): () => void;
     /**
@@ -33,6 +68,7 @@ export declare class SensorsAPI {
     requestPermission(): Promise<boolean>;
 }
 /**
- * Sensors API instance
+ * Sensors API instance (for backward compatibility)
+ * @deprecated Use watchMotion() and watchOrientation() functions instead
  */
 export declare const sensors: SensorsAPI;

package/dist/device/types.d.ts

@@ -58,6 +58,44 @@ export interface SensorData {
     /** Timestamp */
     timestamp: number;
 }
+export interface MotionData {
+    /** Gravity vector (normalized, -1 to 1) */
+    gravity: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /** Linear acceleration (m/s²) */
+    acceleration: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /** Acceleration including gravity (m/s²) */
+    accelerationIncludingGravity: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /** Rotation rate (deg/s) */
+    rotation: {
+        alpha: number;
+        beta: number;
+        gamma: number;
+    };
+    /** Timestamp */
+    timestamp: number;
+}
+export interface OrientationData {
+    /** Rotation around Z axis (0-360°) */
+    alpha: number;
+    /** Rotation around X axis (-180 to 180°) */
+    beta: number;
+    /** Rotation around Y axis (-90 to 90°) */
+    gamma: number;
+    /** Timestamp */
+    timestamp: number;
+}
 export interface FileSystemOptions {
     /** File types to accept */
     accept?: string[];

package/dist/index/index.js

@@ -1,44 +1,55 @@
-import { DEFAULT_CONFIG as r, SDK_NAME as a, VERSION as t, getConfigFromEnv as s, getVersionInfo as i, mergeConfig as n } from "../core/index.js";
-import { A as m, E as c, c as f } from "../errors-CDEBaBxB.js";
-import { CameraAPI as A, FileSystemAPI as E, GeolocationAPI as S, SensorsAPI as l, camera as u, fileSystem as x, geolocation as I, sensors as P, vibrate as C } from "../device/index.js";
-import { c as R, a as y, P as D, b as M, p as O, d as b } from "../pwa-8DGmPqLV.js";
-import { a as F, b as w } from "../useTweaks-QxMRmg7i.js";
-import { c as T, a as V, i as _, b as k, p as G, u as H } from "../useAudioContext-BKgy28A1.js";
-import { reportScore as h, sendEvent as K, updateScore as L } from "../leaderboard/index.js";
+import { DEFAULT_CONFIG as o, SDK_NAME as t, VERSION as r, getConfigFromEnv as i, getVersionInfo as s, mergeConfig as n } from "../core/index.js";
+import { a as m, A as c, C as d, E as f, R as u, b as l, c as A, p as S } from "../runtime-Boz38wSz.js";
+import { CameraAPI as C, FileSystemAPI as R, GeolocationAPI as x, SensorsAPI as M, camera as P, fileSystem as I, geolocation as g, hasNativeBridge as y, isMotionSupported as O, isOrientationSupported as b, requestMotionPermission as v, sensors as D, vibrate as h, watchMotion as w, watchOrientation as F } from "../device/index.js";
+import { c as T, a as V, P as _, b as k, p as G, d as H } from "../pwa-8DGmPqLV.js";
+import { a as q, b as B } from "../useTweaks-QxMRmg7i.js";
+import { c as L, a as W, b as j, i as z, p as J, u as Q } from "../useAudioContext-CNQQSTab.js";
+import { reportScore as Y, sendEvent as Z, updateScore as $ } from "../leaderboard/index.js";
 export {
-  m as AippyRuntimeError,
-  A as CameraAPI,
-  r as DEFAULT_CONFIG,
-  c as ERROR_CODES,
-  E as FileSystemAPI,
-  S as GeolocationAPI,
-  R as PWAUtils,
-  y as PerformanceMonitor,
-  D as PlatformDetector,
-  a as SDK_NAME,
-  l as SensorsAPI,
-  t as VERSION,
-  F as aippyTweaks,
-  w as aippyTweaksRuntime,
-  u as camera,
-  f as createError,
-  T as createHiddenMediaElement,
-  V as createHiddenVideoElement,
-  x as fileSystem,
-  I as geolocation,
-  s as getConfigFromEnv,
-  i as getVersionInfo,
-  _ as isIOSDevice,
-  k as isMediaStreamAudioSupported,
+  m as AippyRuntime,
+  c as AippyRuntimeError,
+  C as CameraAPI,
+  d as Cancellable,
+  o as DEFAULT_CONFIG,
+  f as ERROR_CODES,
+  R as FileSystemAPI,
+  x as GeolocationAPI,
+  T as PWAUtils,
+  V as PerformanceMonitor,
+  _ as PlatformDetector,
+  u as ReceiveChannel,
+  t as SDK_NAME,
+  M as SensorsAPI,
+  r as VERSION,
+  l as aippyRuntime,
+  q as aippyTweaks,
+  B as aippyTweaksRuntime,
+  P as camera,
+  A as createError,
+  L as createHiddenMediaElement,
+  W as createHiddenVideoElement,
+  I as fileSystem,
+  g as geolocation,
+  i as getConfigFromEnv,
+  s as getVersionInfo,
+  y as hasNativeBridge,
+  j as isIOSDevice,
+  z as isMediaStreamAudioSupported,
+  O as isMotionSupported,
+  b as isOrientationSupported,
   n as mergeConfig,
-  G as patchAudioContext,
-  M as performanceMonitor,
-  O as platform,
-  b as pwa,
-  h as reportScore,
-  K as sendEvent,
-  P as sensors,
-  L as updateScore,
-  H as useAudioContext,
-  C as vibrate
+  J as patchAudioContext,
+  k as performanceMonitor,
+  G as platform,
+  S as processMotionData,
+  H as pwa,
+  Y as reportScore,
+  v as requestMotionPermission,
+  Z as sendEvent,
+  D as sensors,
+  $ as updateScore,
+  Q as useAudioContext,
+  h as vibrate,
+  w as watchMotion,
+  F as watchOrientation
 };

package/dist/runtime-Boz38wSz.js

@@ -0,0 +1,227 @@
+var l = Object.defineProperty;
+var u = (o, e, t) => e in o ? l(o, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : o[e] = t;
+var s = (o, e, t) => u(o, typeof e != "symbol" ? e + "" : e, t);
+class d extends Error {
+  constructor(t, n = "AIPPY_ERROR", i) {
+    super(t);
+    s(this, "code");
+    s(this, "context");
+    this.name = "AippyRuntimeError", this.code = n, this.context = i;
+  }
+}
+const f = {
+  NOT_SUPPORTED: "NOT_SUPPORTED",
+  PERMISSION_DENIED: "PERMISSION_DENIED",
+  INVALID_CONFIG: "INVALID_CONFIG",
+  NETWORK_ERROR: "NETWORK_ERROR",
+  UNKNOWN_ERROR: "UNKNOWN_ERROR"
+};
+function E(o, e = "UNKNOWN_ERROR", t) {
+  return new d(o, f[e], t);
+}
+class a {
+  constructor(e) {
+    s(this, "cancelled", !1);
+    this.cancelFn = e;
+  }
+  cancel() {
+    this.cancelled || (this.cancelled = !0, this.cancelFn?.());
+  }
+  get isCancelled() {
+    return this.cancelled;
+  }
+}
+class h {
+  constructor() {
+    s(this, "listeners", /* @__PURE__ */ new Map());
+  }
+  addEventListener(e, t) {
+    this.listeners.has(e) || this.listeners.set(e, []), this.listeners.get(e).push(t);
+  }
+  removeEventListener(e, t) {
+    const n = this.listeners.get(e);
+    if (n) {
+      const i = n.indexOf(t);
+      i > -1 && n.splice(i, 1);
+    }
+  }
+  emit(e, t) {
+    const n = this.listeners.get(e);
+    n && n.forEach((i) => i(t));
+  }
+}
+class m {
+  constructor() {
+    s(this, "emitter", new h());
+  }
+  /**
+   * Emit a message to subscribers
+   */
+  emit(e) {
+    this.emitter.emit(e.endpoint, e.payload);
+  }
+  /**
+   * Subscribe to messages on a specific endpoint
+   */
+  subscribe(e, t) {
+    const n = (i) => {
+      t(i);
+    };
+    return this.emitter.addEventListener(e, n), new a(() => {
+      this.emitter.removeEventListener(e, n);
+    });
+  }
+  /**
+   * Subscribe to a single message (auto-unsubscribe after first message)
+   */
+  once(e, t) {
+    const n = this.subscribe(e, (i) => {
+      n.cancel(), t(i);
+    });
+    return n;
+  }
+}
+class R {
+  constructor() {
+    s(this, "receiveChannel", new m());
+    s(this, "seq", 0);
+    s(this, "motionListeners", []);
+  }
+  /**
+   * Unified native data receiver - Routes to specific handlers based on message type
+   * Called by native code via: window.aippyRuntime.receiveMessage(message)
+   * 
+   * Supports two message formats:
+   * 1. Motion: { endpoint: "0", payload: { motion: {...} } }
+   * 2. Tweaks: { "tweakKey": { value: ..., type: ... }, ... }
+   */
+  receiveMessage(e) {
+    return !e || typeof e != "object" ? (console.warn("⚠️ [Aippy Runtime] Invalid message type:", typeof e), Promise.resolve()) : this.isMotionMessage(e) ? (this.receiveChannel.emit(e), Promise.resolve()) : this.isTweaksMessage(e) ? (typeof window < "u" && window.processNativeData && window.processNativeData(e), Promise.resolve()) : (console.warn("⚠️ [Aippy Runtime] Unknown message format:", e), Promise.resolve());
+  }
+  /**
+   * Check if message is Motion format
+   * Motion: { endpoint: string, payload: object }
+   */
+  isMotionMessage(e) {
+    return typeof e == "object" && "endpoint" in e && typeof e.endpoint == "string" && "payload" in e && typeof e.payload == "object" && e.payload !== null;
+  }
+  /**
+   * Check if message is Tweaks format
+   * Tweaks: { "key": { value: any, type?: string, ... }, ... }
+   */
+  isTweaksMessage(e) {
+    if (typeof e != "object" || e === null || "endpoint" in e || "payload" in e)
+      return !1;
+    const t = Object.keys(e);
+    return t.length === 0 ? !1 : t.some((i) => {
+      const r = e[i];
+      return typeof r == "object" && r !== null && "value" in r;
+    });
+  }
+  /**
+   * Create a subscription to native events
+   * @param handler - WebKit message handler (e.g., deviceMotionHandler)
+   * @param subscribePayload - Subscription parameters (e.g., { type: "motion" })
+   * @param callback - Callback to handle received data
+   * @returns Cancellable subscription
+   */
+  createSubscription(e, t, n) {
+    const i = this.makeSubscriptionMessage(t), r = this.receiveChannel.subscribe(i.endpoint, (c) => {
+      c.error === void 0 && n(c);
+    });
+    try {
+      e.postMessage(i);
+    } catch {
+    }
+    return new a(() => {
+      r.cancel();
+      try {
+        e.postMessage({
+          endpoint: i.endpoint,
+          payload: "unsubscribe"
+        });
+      } catch {
+      }
+    });
+  }
+  /**
+   * Make a subscription message with unique endpoint
+   */
+  makeSubscriptionMessage(e) {
+    return {
+      endpoint: (this.seq++).toString(),
+      payload: {
+        subscribe: e
+      }
+    };
+  }
+  /**
+   * Add motion listener (convenience method)
+   * @param callback - Callback to handle motion data
+   * @returns Cleanup function
+   */
+  addMotionListener(e) {
+    this.motionListeners.push(e);
+    const t = window.webkit?.messageHandlers?.aippyListener;
+    if (!t)
+      return () => {
+        const i = this.motionListeners.indexOf(e);
+        i > -1 && this.motionListeners.splice(i, 1);
+      };
+    const n = this.createSubscription(
+      t,
+      {
+        command: "navigator.motion",
+        type: "motion"
+      },
+      (i) => {
+        i.motion && e(i.motion);
+      }
+    );
+    return () => {
+      n.cancel();
+      const i = this.motionListeners.indexOf(e);
+      i > -1 && this.motionListeners.splice(i, 1);
+    };
+  }
+  /**
+   * Broadcast motion data to all registered listeners
+   * Called by processMotionData when iOS sends data directly
+   * @param data - Motion data from iOS
+   */
+  broadcastMotionData(e) {
+    if (this.motionListeners.length === 0)
+      return;
+    const t = e.motion || e;
+    this.motionListeners.forEach((n) => {
+      try {
+        n(t);
+      } catch (i) {
+        console.error("⚠️ [Aippy Runtime] Error in motion listener:", i);
+      }
+    });
+  }
+}
+function y(o) {
+  if (!o || typeof o != "object") {
+    console.warn("⚠️ [Aippy Runtime] Invalid motion data type:", typeof o);
+    return;
+  }
+  if (!("motion" in o) || typeof o.motion != "object") {
+    console.warn("⚠️ [Aippy Runtime] Motion data missing valid motion field");
+    return;
+  }
+  p.broadcastMotionData(o);
+}
+const p = new R();
+typeof window < "u" && (window.aippyRuntime = p, window.processMotionData = y);
+export {
+  d as A,
+  a as C,
+  f as E,
+  m as R,
+  R as a,
+  p as b,
+  E as c,
+  y as p
+};

package/dist/{useAudioContext-BKgy28A1.js → useAudioContext-CNQQSTab.js}

@@ -215,9 +215,9 @@ function O(e = {}) {
 }
 export {
   C as a,
-  P as b,
+  E as b,
   v as c,
-  E as i,
+  P as i,
   S as p,
   O as u
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aippy/runtime",
-  "version": "0.2.3",
+  "version": "0.2.4-dev.4",
   "description": "Aippy Runtime SDK - Runtime SDK for Aippy projects",
   "private": false,
   "type": "module",
@@ -44,30 +44,6 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "dev": "vite build --watch",
-    "build": "vite build && find dist -name '*.d.ts.map' -delete",
-    "type-check": "tsc --noEmit",
-    "lint": "eslint src --ext .ts,.tsx",
-    "lint:fix": "eslint src --ext .ts,.tsx --fix",
-    "format": "prettier --write \"src/**/*.{ts,tsx,json,md}\"",
-    "format:check": "prettier --check \"src/**/*.{ts,tsx,json,md}\"",
-    "clean": "rm -rf dist",
-    "prepublishOnly": "pnpm run clean && pnpm run type-check && pnpm run build",
-    "publish:patch": "pnpm prepublishOnly && pnpm version patch && pnpm publish --no-git-checks",
-    "publish:minor": "pnpm prepublishOnly && pnpm version minor && pnpm publish --no-git-checks",
-    "publish:major": "pnpm prepublishOnly && pnpm version major && pnpm publish --no-git-checks",
-    "publish:alpha": "pnpm prepublishOnly && pnpm version prerelease --preid=alpha && pnpm publish --tag alpha --no-git-checks",
-    "publish:beta": "pnpm prepublishOnly && pnpm version prerelease --preid=beta && pnpm publish --tag beta --no-git-checks",
-    "publish:rc": "pnpm prepublishOnly && pnpm version prerelease --preid=rc && pnpm publish --tag rc --no-git-checks",
-    "publish:dev": "pnpm prepublishOnly && pnpm version prerelease --preid=dev && pnpm publish --tag dev --no-git-checks",
-    "audit": "pnpm audit --audit-level moderate",
-    "audit:fix": "pnpm audit --fix",
-    "security:check": "pnpm audit && pnpm outdated",
-    "prerelease": "pnpm run audit && pnpm run type-check && pnpm run lint && pnpm run build",
-    "release:dry": "npm publish --dry-run",
-    "test:build": "node -e \"require('./dist/index.js')\""
-  },
   "keywords": [
     "aippy",
     "runtime",
@@ -106,5 +82,28 @@
   "engines": {
     "node": ">=20.0.0",
     "pnpm": ">=10.0.0"
+  },
+  "scripts": {
+    "dev": "vite build --watch",
+    "build": "vite build && find dist -name '*.d.ts.map' -delete",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint src --ext .ts,.tsx",
+    "lint:fix": "eslint src --ext .ts,.tsx --fix",
+    "format": "prettier --write \"src/**/*.{ts,tsx,json,md}\"",
+    "format:check": "prettier --check \"src/**/*.{ts,tsx,json,md}\"",
+    "clean": "rm -rf dist",
+    "publish:patch": "pnpm prepublishOnly && pnpm version patch && pnpm publish --no-git-checks",
+    "publish:minor": "pnpm prepublishOnly && pnpm version minor && pnpm publish --no-git-checks",
+    "publish:major": "pnpm prepublishOnly && pnpm version major && pnpm publish --no-git-checks",
+    "publish:alpha": "pnpm prepublishOnly && pnpm version prerelease --preid=alpha && pnpm publish --tag alpha --no-git-checks",
+    "publish:beta": "pnpm prepublishOnly && pnpm version prerelease --preid=beta && pnpm publish --tag beta --no-git-checks",
+    "publish:rc": "pnpm prepublishOnly && pnpm version prerelease --preid=rc && pnpm publish --tag rc --no-git-checks",
+    "publish:dev": "pnpm prepublishOnly && pnpm version prerelease --preid=dev && pnpm publish --tag dev --no-git-checks",
+    "audit": "pnpm audit --audit-level moderate",
+    "audit:fix": "pnpm audit --fix",
+    "security:check": "pnpm audit && pnpm outdated",
+    "prerelease": "pnpm run audit && pnpm run type-check && pnpm run lint && pnpm run build",
+    "release:dry": "npm publish --dry-run",
+    "test:build": "node -e \"require('./dist/index.js')\""
   }
-}
+}

package/dist/errors-CDEBaBxB.js

@@ -1,26 +0,0 @@
-var e = Object.defineProperty;
-var o = (E, R, N) => R in E ? e(E, R, { enumerable: !0, configurable: !0, writable: !0, value: N }) : E[R] = N;
-var O = (E, R, N) => o(E, typeof R != "symbol" ? R + "" : R, N);
-class I extends Error {
-  constructor(N, r = "AIPPY_ERROR", t) {
-    super(N);
-    O(this, "code");
-    O(this, "context");
-    this.name = "AippyRuntimeError", this.code = r, this.context = t;
-  }
-}
-const _ = {
-  NOT_SUPPORTED: "NOT_SUPPORTED",
-  PERMISSION_DENIED: "PERMISSION_DENIED",
-  INVALID_CONFIG: "INVALID_CONFIG",
-  NETWORK_ERROR: "NETWORK_ERROR",
-  UNKNOWN_ERROR: "UNKNOWN_ERROR"
-};
-function s(E, R = "UNKNOWN_ERROR", N) {
-  return new I(E, _[R], N);
-}
-export {
-  I as A,
-  _ as E,
-  s as c
-};