@ateam-ai-mobile/expo 0.1.7 → 0.1.8

package/dist/device-bridge/index.mjs

@@ -11,9 +11,11 @@ import {
   sharing_exports,
   syncDomains,
   unregisterBackgroundSync
-} from "../chunk-VQJPSLHP.mjs";
+} from "../chunk-Z5AI2SXX.mjs";
 import "../chunk-KOXF2FZM.mjs";
 import "../chunk-XQSY6MHP.mjs";
+import "../chunk-7FWYEHN5.mjs";
+import "../chunk-J6XRNX7P.mjs";
 import "../chunk-WMJKH4XE.mjs";
 export {
   BACKGROUND_TASK_NAME,

package/dist/index.d.mts

@@ -30,6 +30,8 @@ declare class ExpoBundleStorage implements BundleStorage {
  * in one of them. Injection also matches how the rest of this SDK takes host
  * capabilities, and lets a test drive the engines without an Expo runtime.
  */
+/** GPS tier for a position stream: turn-by-turn, precise, city-block, coarse. */
+type WatchAccuracy = 'navigation' | 'high' | 'balanced' | 'low';
 interface DeviceStateCollectors {
     connectivity?: {
         collectConnectivity(): Promise<any>;
@@ -38,7 +40,10 @@ interface DeviceStateCollectors {
         getPosition(opts?: {
             accuracy?: 'low' | 'high';
         }): Promise<any>;
-        watchPosition(cb: (pos: any) => void): () => void;
+        /** `accuracy` is the GPS tier the stream runs at (battery vs precision). */
+        watchPosition(cb: (pos: any) => void, opts?: {
+            accuracy?: WatchAccuracy;
+        }): () => void;
         hasPermission(): Promise<boolean>;
     };
 }
@@ -59,9 +64,10 @@ interface DeviceStateCollectors {
  *   connectivity   reachability ✓ transport ✓   quality/stability/metered ✗
  *   capability     permission ✓   availability ✗   restriction ✗
  *   interaction    app lifecycle ✓  screenOn ✗  audio ✗
- *   spatial        position ✓  path ✓ (while a session is open)  heading/speed ✗
+ *   spatial        position ✓ heading ✓ turns ✓  path/events ✓ (while a session is open)  speed ~derived
  *   visual         frames ✓ heading ✓ freshness ✓   blur/exposure ✗
- *   activity / environment — NOT IMPLEMENTED AT ALL
+ *   activity       walking/running/stationary ✓ pose ✓   cycling/driving ✗   events ✗
+ *   environment    NOT IMPLEMENTED AT ALL
  *
  * Everything marked ✗ reports `unknown`, which is a real answer in this design
  * and the only honest one. It never reports a plausible default: an invented
@@ -426,6 +432,16 @@ declare const cameraTasks: CameraTaskBroker;
  * are replayed exactly as recorded. They are the most valuable records in the
  * file — they are what a guide must handle correctly, and precisely what a
  * hand-written fixture would never contain.
+ *
+ * SPATIAL EVENTS REPLAY; THE OTHERS REFUSE. Spatial events are derived from
+ * snapshots by the same detector the live engine runs, so feeding it the
+ * recorded snapshots in time order gives the events the walk produced — at the
+ * virtual time of the sample that completed each one. While a listener runs,
+ * the clock stands AT that sample, so a listener that re-reads gets the
+ * snapshot its event came from, as it would live. Two limits, inherited from
+ * recording snapshots: two turns inside one recorded tick collapse to the later
+ * one, because a snapshot carries only the last turn; and a hold completes at
+ * the recording's tick rather than the live engine's one-second one.
  */
 
 /** One tick of a recorded walk. Domains are stored verbatim, never normalised. */

package/dist/index.d.ts

@@ -30,6 +30,8 @@ declare class ExpoBundleStorage implements BundleStorage {
  * in one of them. Injection also matches how the rest of this SDK takes host
  * capabilities, and lets a test drive the engines without an Expo runtime.
  */
+/** GPS tier for a position stream: turn-by-turn, precise, city-block, coarse. */
+type WatchAccuracy = 'navigation' | 'high' | 'balanced' | 'low';
 interface DeviceStateCollectors {
     connectivity?: {
         collectConnectivity(): Promise<any>;
@@ -38,7 +40,10 @@ interface DeviceStateCollectors {
         getPosition(opts?: {
             accuracy?: 'low' | 'high';
         }): Promise<any>;
-        watchPosition(cb: (pos: any) => void): () => void;
+        /** `accuracy` is the GPS tier the stream runs at (battery vs precision). */
+        watchPosition(cb: (pos: any) => void, opts?: {
+            accuracy?: WatchAccuracy;
+        }): () => void;
         hasPermission(): Promise<boolean>;
     };
 }
@@ -59,9 +64,10 @@ interface DeviceStateCollectors {
  *   connectivity   reachability ✓ transport ✓   quality/stability/metered ✗
  *   capability     permission ✓   availability ✗   restriction ✗
  *   interaction    app lifecycle ✓  screenOn ✗  audio ✗
- *   spatial        position ✓  path ✓ (while a session is open)  heading/speed ✗
+ *   spatial        position ✓ heading ✓ turns ✓  path/events ✓ (while a session is open)  speed ~derived
  *   visual         frames ✓ heading ✓ freshness ✓   blur/exposure ✗
- *   activity / environment — NOT IMPLEMENTED AT ALL
+ *   activity       walking/running/stationary ✓ pose ✓   cycling/driving ✗   events ✗
+ *   environment    NOT IMPLEMENTED AT ALL
  *
  * Everything marked ✗ reports `unknown`, which is a real answer in this design
  * and the only honest one. It never reports a plausible default: an invented
@@ -426,6 +432,16 @@ declare const cameraTasks: CameraTaskBroker;
  * are replayed exactly as recorded. They are the most valuable records in the
  * file — they are what a guide must handle correctly, and precisely what a
  * hand-written fixture would never contain.
+ *
+ * SPATIAL EVENTS REPLAY; THE OTHERS REFUSE. Spatial events are derived from
+ * snapshots by the same detector the live engine runs, so feeding it the
+ * recorded snapshots in time order gives the events the walk produced — at the
+ * virtual time of the sample that completed each one. While a listener runs,
+ * the clock stands AT that sample, so a listener that re-reads gets the
+ * snapshot its event came from, as it would live. Two limits, inherited from
+ * recording snapshots: two turns inside one recorded tick collapse to the later
+ * one, because a snapshot carries only the last turn; and a hold completes at
+ * the recording's tick rather than the live engine's one-second one.
  */
 
 /** One tick of a recorded walk. Domains are stored verbatim, never normalised. */