@wayq/beekon-rn 0.0.3 → 0.0.5

package/lib/module/beekon.js

@@ -1,103 +1,255 @@
 "use strict";
 
 import NativeBeekon from "./NativeBeekonRn.js";
-import { configToWire, wireToLocation, wireToState, rethrowAsBeekonError } from "./internal/mappers.js";
+import { configToWire, geofenceToWire, recordToEntries, rethrowAsBeekonError, wireToGeofence, wireToGeofenceEvent, wireToLocation, wireToState, wireToSyncStatus } from "./internal/mappers.js";
+/**
+ * Fans the four native EventEmitters out to multiple JS subscribers and adds
+ * replay-1 semantics for `state` / `syncStatus` (RN EventEmitters don't replay,
+ * so we cache the latest value and hand it to new subscribers immediately —
+ * matching the native StateFlow / AsyncStream contract). `location` /
+ * `geofenceEvent` are plain fan-out with no replay.
+ *
+ * Native subscriptions are opened once, on first use, and kept for the app
+ * lifetime — the native module collects its flows continuously regardless, so
+ * this only keeps the JS cache warm.
+ */
+class EventHub {
+  subscribed = false;
+  stateListeners = new Set();
+  locationListeners = new Set();
+  geofenceListeners = new Set();
+  syncListeners = new Set();
+  /** Idempotent: opens the native subscriptions the first time it is called. */
+  ensureSubscribed() {
+    if (this.subscribed) return;
+    this.subscribed = true;
+    NativeBeekon.onState(w => {
+      const s = wireToState(w);
+      this.lastState = s;
+      this.stateListeners.forEach(cb => cb(s));
+    });
+    NativeBeekon.onLocation(w => {
+      const l = wireToLocation(w);
+      this.locationListeners.forEach(cb => cb(l));
+    });
+    NativeBeekon.onGeofenceEvent(w => {
+      const g = wireToGeofenceEvent(w);
+      this.geofenceListeners.forEach(cb => cb(g));
+    });
+    NativeBeekon.onSyncStatus(w => {
+      const s = wireToSyncStatus(w);
+      this.lastSyncStatus = s;
+      this.syncListeners.forEach(cb => cb(s));
+    });
+  }
+  onState(cb) {
+    this.ensureSubscribed();
+    this.stateListeners.add(cb);
+    if (this.lastState !== undefined) cb(this.lastState);
+    return () => {
+      this.stateListeners.delete(cb);
+    };
+  }
+  onLocation(cb) {
+    this.ensureSubscribed();
+    this.locationListeners.add(cb);
+    return () => {
+      this.locationListeners.delete(cb);
+    };
+  }
+  onGeofenceEvent(cb) {
+    this.ensureSubscribed();
+    this.geofenceListeners.add(cb);
+    return () => {
+      this.geofenceListeners.delete(cb);
+    };
+  }
+  onSyncStatus(cb) {
+    this.ensureSubscribed();
+    this.syncListeners.add(cb);
+    if (this.lastSyncStatus !== undefined) cb(this.lastSyncStatus);
+    return () => {
+      this.syncListeners.delete(cb);
+    };
+  }
+}
 
 /**
- * Public facade for the Beekon SDK. Mirrors the native APIs:
+ * Public facade for the Beekon SDK — a 1:1 mirror of the native APIs:
  *
  * - Android: `in.wayq.beekon.Beekon` (object)
  * - iOS:     `BeekonKit.Beekon.shared` (actor)
  *
- * Lifecycle: `configure(config)` → `start()` → ... → `stop()` (idempotent).
- * Subscribe to `onState` / `onLocation` for live updates; query
- * `history(from, to)` for persisted fixes.
+ * There is **no `initialize()`** — the native SDKs auto-initialize. Lifecycle:
+ * `configure(config)` (optional; defaults 30s / 100m) → `start()` → … →
+ * `stop()`. `start()` / `stop()` **never throw** — `onState` is the single
+ * source of truth for whether tracking is active and why it stopped.
  *
- * **Threading:** Methods are safe to call from any JS context. Subscribers'
+ * **Threading:** methods are safe to call from any JS context; subscriber
  * callbacks fire on the JS thread.
  *
- * **Persistence invariant:** the SDK persists every gated fix natively; JS is
- * a passive observer. In background, the JS engine is not guaranteed to be
- * alive — for past fixes, use `history()`.
+ * **Persistence invariant:** the SDK persists every gated fix natively; JS is a
+ * passive observer that is not guaranteed to be alive in the background. For
+ * past fixes use `getLocations()`.
  */
 class BeekonImpl {
+  hub = new EventHub();
+
   /**
    * Set tracking parameters. Optional — `start()` falls back to the previously
-   * persisted config or the SDK default (30s / 100m) if never configured.
-   *
-   * While tracking, the new gate values take effect on the next admitted fix
-   * without restarting the underlying location subscription.
+   * persisted config, or the SDK defaults if never configured. While tracking,
+   * gate thresholds take effect on the next admitted fix without restarting the
+   * location subscription; `accuracyMode` applies on the next `start()`.
    */
   async configure(config) {
+    this.hub.ensureSubscribed();
+    await NativeBeekon.configure(configToWire(config));
+  }
+
+  /**
+   * Begin tracking. Never throws — observe `onState` for the outcome
+   * (`stopped(reason)` on a permission / services / system problem). Beekon
+   * ships no permission API: request permissions in the host app, then observe
+   * `onState`.
+   */
+  async start() {
+    this.hub.ensureSubscribed();
+    await NativeBeekon.start();
+  }
+
+  /** Stop tracking. Idempotent. Registered geofences keep firing. */
+  async stop() {
+    this.hub.ensureSubscribed();
+    await NativeBeekon.stop();
+  }
+
+  /**
+   * Resume tracking if a session was active before the app was terminated. A
+   * no-op if the user explicitly stopped. Call early in app startup.
+   *
+   * Note: on a background relaunch the JS engine may not be running, so true
+   * cold-launch resume also requires native host wiring (Android: call
+   * `Beekon.start()` from `Application.onCreate`; iOS: `registerBackgroundTasks`
+   * in the AppDelegate). See the README.
+   */
+  async resumeIfNeeded() {
+    this.hub.ensureSubscribed();
+    await NativeBeekon.resumeIfNeeded();
+  }
+
+  /**
+   * Read persisted fixes in the inclusive range `[from, to]`, oldest first.
+   * Reads come from the SDK's local storage (Room on Android, GRDB on iOS) — the
+   * source of truth even when JS was asleep. With sync enabled, rows are deleted
+   * locally once the server accepts them, so this returns only un-uploaded fixes.
+   *
+   * Throws `BeekonError` with kind `'storage'` on a database read failure.
+   */
+  async getLocations(from, to) {
     try {
-      await NativeBeekon.configure(configToWire(config));
+      const wires = await NativeBeekon.getLocations(from.getTime(), to.getTime());
+      return wires.map(wireToLocation);
     } catch (e) {
       rethrowAsBeekonError(e);
     }
   }
 
   /**
-   * Begin tracking. State transitions to `tracking`.
-   *
-   * Throws a `BeekonError` with kind:
-   * - `'permissionDenied'` — location permission not granted.
-   * - `'locationServicesDisabled'` — system location services off (or GMS
-   *   unavailable on Android).
+   * Delete stored locations captured at or before `before` (all of them when
+   * `before` is omitted). Returns the number of rows removed. Throws
+   * `BeekonError` with kind `'storage'` on a failure.
    */
-  async start() {
+  async deleteLocations(before) {
     try {
-      await NativeBeekon.start();
+      // Negative is the wire sentinel for "delete all" (see NativeBeekonRn.ts).
+      return await NativeBeekon.deleteLocations(before ? before.getTime() : -1);
     } catch (e) {
       rethrowAsBeekonError(e);
     }
   }
 
-  /** Stop tracking. Idempotent. State transitions to `stopped(user)`. */
-  async stop() {
+  /**
+   * The number of stored locations not yet uploaded. Throws `BeekonError` with
+   * kind `'storage'` on a failure.
+   */
+  async pendingUploadCount() {
     try {
-      await NativeBeekon.stop();
+      return await NativeBeekon.pendingUploadCount();
     } catch (e) {
       rethrowAsBeekonError(e);
     }
   }
 
   /**
-   * Read persisted fixes in the time range [from, to]. Returns fixes in
-   * chronological order. Reads come from the SDK's local storage (Room on
-   * Android, GRDB on iOS) — the source of truth even when JS was asleep.
-   *
-   * Retention: fixes older than 7 days OR beyond the most recent 100K are
-   * pruned automatically.
-   *
-   * Throws `BeekonError` with kind `'storageFailure'` on database read failure.
+   * Request an immediate upload. Best-effort and self-retrying; a no-op when
+   * sync is not configured.
    */
-  async history(from, to) {
+  async sync() {
+    await NativeBeekon.sync();
+  }
+
+  /** Set custom key/value fields (e.g. `user_id`) included with every upload. */
+  async setExtras(extras) {
+    await NativeBeekon.setExtras(recordToEntries(extras));
+  }
+
+  /**
+   * Register geofences. Re-adding an `id` replaces the existing one. Throws
+   * `BeekonError` with kind `'invalidGeofence'` if any entry fails validation —
+   * none are added when one is invalid.
+   */
+  async addGeofences(geofences) {
     try {
-      const wires = await NativeBeekon.history(from.getTime(), to.getTime());
-      return wires.map(wireToLocation);
+      await NativeBeekon.addGeofences(geofences.map(geofenceToWire));
     } catch (e) {
       rethrowAsBeekonError(e);
     }
   }
 
+  /** Unregister geofences by id. Unknown ids are ignored. */
+  async removeGeofences(ids) {
+    await NativeBeekon.removeGeofences(ids);
+  }
+
+  /** The currently registered geofences. */
+  async listGeofences() {
+    const wires = await NativeBeekon.listGeofences();
+    return wires.map(wireToGeofence);
+  }
+
   /**
-   * Subscribe to state transitions. Returns an unsubscribe function. The
-   * current state is delivered to new subscribers immediately (replay-1
-   * semantics, matching the native `state` flow / AsyncStream).
+   * Subscribe to tracking-state transitions (`idle` / `tracking` /
+   * `stopped(reason)`). The current state is delivered to new subscribers
+   * immediately (replay-1). Returns an unsubscribe function.
    */
   onState(cb) {
-    const subscription = NativeBeekon.onState(wire => cb(wireToState(wire)));
-    return () => subscription.remove();
+    return this.hub.onState(cb);
   }
 
   /**
-   * Subscribe to gated locations as they arrive. Returns an unsubscribe
-   * function. Broadcast (no replay) — only delivers while the JS engine is
-   * alive. For fixes emitted while JS was asleep, use `history()`.
+   * Subscribe to gated locations as they arrive. Broadcast (no replay) — only
+   * delivers while the JS engine is alive. For fixes emitted while JS was
+   * asleep, use `getLocations()`. Returns an unsubscribe function.
    */
   onLocation(cb) {
-    const subscription = NativeBeekon.onLocation(wire => cb(wireToLocation(wire)));
-    return () => subscription.remove();
+    return this.hub.onLocation(cb);
+  }
+
+  /**
+   * Subscribe to geofence enter / exit crossings. Broadcast (no replay).
+   * Returns an unsubscribe function.
+   */
+  onGeofenceEvent(cb) {
+    return this.hub.onGeofenceEvent(cb);
+  }
+
+  /**
+   * Subscribe to upload health (`idle` / `pending` / `failed(reason)`). The
+   * current status is delivered to new subscribers immediately (replay-1).
+   * Returns an unsubscribe function.
+   */
+  onSyncStatus(cb) {
+    return this.hub.onSyncStatus(cb);
   }
 }
 export const Beekon = new BeekonImpl();

package/lib/module/beekon.js.map

@@ -1 +1 @@
-{"version":3,"names":["NativeBeekon","configToWire","wireToLocation","wireToState","rethrowAsBeekonError","BeekonImpl","configure","config","e","start","stop","history","from","to","wires","getTime","map","onState","cb","subscription","wire","remove","onLocation","Beekon"],"sourceRoot":"../../src","sources":["beekon.ts"],"mappings":";;AAAA,OAAOA,YAAY,MAAM,qBAAkB;AAI3C,SACEC,YAAY,EACZC,cAAc,EACdC,WAAW,EACXC,oBAAoB,QACf,uBAAoB;;AAE3B;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,UAAU,CAAC;EACf;AACF;AACA;AACA;AACA;AACA;AACA;EACE,MAAMC,SAASA,CAACC,MAAoB,EAAiB;IACnD,IAAI;MACF,MAAMP,YAAY,CAACM,SAAS,CAACL,YAAY,CAACM,MAAM,CAAC,CAAC;IACpD,CAAC,CAAC,OAAOC,CAAC,EAAE;MACVJ,oBAAoB,CAACI,CAAC,CAAC;IACzB;EACF;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;EACE,MAAMC,KAAKA,CAAA,EAAkB;IAC3B,IAAI;MACF,MAAMT,YAAY,CAACS,KAAK,CAAC,CAAC;IAC5B,CAAC,CAAC,OAAOD,CAAC,EAAE;MACVJ,oBAAoB,CAACI,CAAC,CAAC;IACzB;EACF;;EAEA;EACA,MAAME,IAAIA,CAAA,EAAkB;IAC1B,IAAI;MACF,MAAMV,YAAY,CAACU,IAAI,CAAC,CAAC;IAC3B,CAAC,CAAC,OAAOF,CAAC,EAAE;MACVJ,oBAAoB,CAACI,CAAC,CAAC;IACzB;EACF;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACE,MAAMG,OAAOA,CAACC,IAAU,EAAEC,EAAQ,EAAuB;IACvD,IAAI;MACF,MAAMC,KAAK,GAAG,MAAMd,YAAY,CAACW,OAAO,CAACC,IAAI,CAACG,OAAO,CAAC,CAAC,EAAEF,EAAE,CAACE,OAAO,CAAC,CAAC,CAAC;MACtE,OAAOD,KAAK,CAACE,GAAG,CAACd,cAAc,CAAC;IAClC,CAAC,CAAC,OAAOM,CAAC,EAAE;MACVJ,oBAAoB,CAACI,CAAC,CAAC;IACzB;EACF;;EAEA;AACF;AACA;AACA;AACA;EACES,OAAOA,CAACC,EAA4B,EAAc;IAChD,MAAMC,YAAY,GAAGnB,YAAY,CAACiB,OAAO,CAAEG,IAAI,IAAKF,EAAE,CAACf,WAAW,CAACiB,IAAI,CAAC,CAAC,CAAC;IAC1E,OAAO,MAAMD,YAAY,CAACE,MAAM,CAAC,CAAC;EACpC;;EAEA;AACF;AACA;AACA;AACA;EACEC,UAAUA,CAACJ,EAAyB,EAAc;IAChD,MAAMC,YAAY,GAAGnB,YAAY,CAACsB,UAAU,CAAEF,IAAI,IAChDF,EAAE,CAAChB,cAAc,CAACkB,IAAI,CAAC,CACzB,CAAC;IACD,OAAO,MAAMD,YAAY,CAACE,MAAM,CAAC,CAAC;EACpC;AACF;AAEA,OAAO,MAAME,MAAM,GAAG,IAAIlB,UAAU,CAAC,CAAC","ignoreList":[]}
+{"version":3,"names":["NativeBeekon","configToWire","geofenceToWire","recordToEntries","rethrowAsBeekonError","wireToGeofence","wireToGeofenceEvent","wireToLocation","wireToState","wireToSyncStatus","EventHub","subscribed","stateListeners","Set","locationListeners","geofenceListeners","syncListeners","ensureSubscribed","onState","w","s","lastState","forEach","cb","onLocation","l","onGeofenceEvent","g","onSyncStatus","lastSyncStatus","add","undefined","delete","BeekonImpl","hub","configure","config","start","stop","resumeIfNeeded","getLocations","from","to","wires","getTime","map","e","deleteLocations","before","pendingUploadCount","sync","setExtras","extras","addGeofences","geofences","removeGeofences","ids","listGeofences","Beekon"],"sourceRoot":"../../src","sources":["beekon.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["Beekon","BeekonError"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,SAASA,MAAM,QAAQ,aAAU;AAIjC,SAASC,WAAW,QAA8B,kBAAe","ignoreList":[]}
+{"version":3,"names":["Beekon","BeekonError"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,SAASA,MAAM,QAAQ,aAAU;AAuBjC,SAASC,WAAW,QAA8B,kBAAe","ignoreList":[]}

package/lib/module/internal/mappers.js

@@ -1,37 +1,96 @@
 "use strict";
 
 import { BeekonError } from "../types/error.js";
-const DEFAULT_INTERVAL_SECONDS = 30;
-const DEFAULT_DISTANCE_METERS = 100;
+// Config defaults. Kept here (not in the wire layer) so the native modules can
+// treat every wire field as present.
+const DEFAULTS = {
+  minTimeBetweenLocationsSeconds: 30,
+  minDistanceBetweenLocationsMeters: 100,
+  accuracyMode: 'balanced',
+  whenStationary: 'pause',
+  stationaryRadiusMeters: 5,
+  detectActivity: false,
+  syncIntervalSeconds: 300,
+  syncBatchSize: 100
+};
+
+// --- Public → wire ---------------------------------------------------------
+
+export function recordToEntries(record) {
+  if (!record) return [];
+  return Object.keys(record).map(key => ({
+    key,
+    value: record[key]
+  }));
+}
 export function configToWire(config) {
+  const sync = config.sync;
+  return {
+    minTimeBetweenLocationsSeconds: config.minTimeBetweenLocationsSeconds ?? DEFAULTS.minTimeBetweenLocationsSeconds,
+    minDistanceBetweenLocationsMeters: config.minDistanceBetweenLocationsMeters ?? DEFAULTS.minDistanceBetweenLocationsMeters,
+    accuracyMode: config.accuracyMode ?? DEFAULTS.accuracyMode,
+    whenStationary: config.whenStationary ?? DEFAULTS.whenStationary,
+    stationaryRadiusMeters: config.stationaryRadiusMeters ?? DEFAULTS.stationaryRadiusMeters,
+    detectActivity: config.detectActivity ?? DEFAULTS.detectActivity,
+    sync: sync ? {
+      url: sync.url,
+      headers: recordToEntries(sync.headers),
+      intervalSeconds: sync.intervalSeconds ?? DEFAULTS.syncIntervalSeconds,
+      batchSize: sync.batchSize ?? DEFAULTS.syncBatchSize
+    } : undefined,
+    notification: config.notification ? {
+      title: config.notification.title,
+      text: config.notification.text
+    } : undefined
+  };
+}
+export function geofenceToWire(g) {
   return {
-    intervalSeconds: config.intervalSeconds ?? DEFAULT_INTERVAL_SECONDS,
-    distanceMeters: config.distanceMeters ?? DEFAULT_DISTANCE_METERS,
-    androidNotification: config.androidNotification
+    id: g.id,
+    lat: g.latitude,
+    lng: g.longitude,
+    radiusMeters: g.radiusMeters,
+    notifyOnEntry: g.notifyOnEntry ?? true,
+    notifyOnExit: g.notifyOnExit ?? true
   };
 }
+
+// --- Wire → public ---------------------------------------------------------
+
 export function wireToLocation(w) {
   return {
-    lat: w.lat,
-    lng: w.lng,
+    id: w.id,
+    latitude: w.lat,
+    longitude: w.lng,
+    timestamp: new Date(w.timestampMs),
     accuracy: w.accuracy,
     speed: w.speed,
     bearing: w.bearing,
     altitude: w.altitude,
-    timestamp: new Date(w.timestampMs)
+    quality: oneOf(w.quality, ['ok', 'lowAccuracy', 'implausibleSpeed'], 'ok'),
+    trigger: oneOf(w.trigger, ['interval', 'motion', 'checkIn', 'geofence', 'manual'], 'interval'),
+    motion: oneOf(w.motion, ['moving', 'stationary', 'unknown'], 'unknown'),
+    activity: w.activity == null ? null : oneOf(w.activity, ['stationary', 'walking', 'running', 'cycling', 'automotive', 'unknown'], 'unknown'),
+    isMock: w.isMock
   };
 }
-function toStopReason(s) {
-  switch (s) {
-    case 'user':
-    case 'permissionDenied':
-    case 'locationServicesDisabled':
-    case 'system':
-      return s;
-    default:
-      // Defensive — native should never emit an unknown reason.
-      return 'user';
-  }
+export function wireToGeofence(w) {
+  return {
+    id: w.id,
+    latitude: w.lat,
+    longitude: w.lng,
+    radiusMeters: w.radiusMeters,
+    notifyOnEntry: w.notifyOnEntry,
+    notifyOnExit: w.notifyOnExit
+  };
+}
+export function wireToGeofenceEvent(w) {
+  return {
+    id: w.id,
+    geofenceId: w.geofenceId,
+    type: oneOf(w.type, ['enter', 'exit'], 'enter'),
+    timestamp: new Date(w.timestampMs)
+  };
 }
 export function wireToState(w) {
   switch (w.type) {
@@ -55,12 +114,49 @@ export function wireToState(w) {
       };
   }
 }
+export function wireToSyncStatus(w) {
+  switch (w.type) {
+    case 'idle':
+      return {
+        kind: 'idle'
+      };
+    case 'pending':
+      return {
+        kind: 'pending'
+      };
+    case 'failed':
+      return {
+        kind: 'failed',
+        reason: toSyncFailure(w.failure)
+      };
+    default:
+      return {
+        kind: 'idle'
+      };
+  }
+}
+function toStopReason(s) {
+  return oneOf(s, ['user', 'permissionDenied', 'locationServicesDisabled', 'locationUnavailable', 'system'],
+  // The native side always populates the reason for a `stopped` state; an
+  // unknown/missing value means the wire contract was violated — fall back to
+  // `system` rather than throwing on a subscriber.
+  'system');
+}
+function toSyncFailure(s) {
+  return oneOf(s, ['auth', 'rejected'], 'rejected');
+}
+
+/** Validate a wire enum string against the known set, with a safe fallback. */
+function oneOf(value, allowed, fallback) {
+  return allowed.includes(value ?? '') ? value : fallback;
+}
+
+// --- Errors ----------------------------------------------------------------
 
 /**
- * Re-throw a native promise rejection as a typed `BeekonError`. Native modules
- * encode the kind in the error code string (`PERMISSION_DENIED`,
- * `LOCATION_SERVICES_DISABLED`, `STORAGE_FAILURE`); anything else falls
- * through as the original error.
+ * Re-throw a native promise rejection as a typed {@link BeekonError}. The native
+ * modules encode the kind in the error-code string (`STORAGE_FAILURE`,
+ * `INVALID_GEOFENCE`); anything else falls through as the original error.
  */
 export function rethrowAsBeekonError(e) {
   const code = e?.code;
@@ -73,12 +169,10 @@ export function rethrowAsBeekonError(e) {
 }
 function codeToKind(code) {
   switch (code) {
-    case 'PERMISSION_DENIED':
-      return 'permissionDenied';
-    case 'LOCATION_SERVICES_DISABLED':
-      return 'locationServicesDisabled';
     case 'STORAGE_FAILURE':
-      return 'storageFailure';
+      return 'storage';
+    case 'INVALID_GEOFENCE':
+      return 'invalidGeofence';
     default:
       return undefined;
   }

package/lib/module/internal/mappers.js.map

@@ -1 +1 @@
-{"version":3,"names":["BeekonError","DEFAULT_INTERVAL_SECONDS","DEFAULT_DISTANCE_METERS","configToWire","config","intervalSeconds","distanceMeters","androidNotification","wireToLocation","w","lat","lng","accuracy","speed","bearing","altitude","timestamp","Date","timestampMs","toStopReason","s","wireToState","type","kind","reason","stopReason","rethrowAsBeekonError","e","code","message","String","codeToKind","undefined"],"sourceRoot":"../../../src","sources":["internal/mappers.ts"],"mappings":";;AAGA,SAASA,WAAW,QAA8B,mBAAgB;AAGlE,MAAMC,wBAAwB,GAAG,EAAE;AACnC,MAAMC,uBAAuB,GAAG,GAAG;AAEnC,OAAO,SAASC,YAAYA,CAACC,MAAoB,EAAc;EAC7D,OAAO;IACLC,eAAe,EAAED,MAAM,CAACC,eAAe,IAAIJ,wBAAwB;IACnEK,cAAc,EAAEF,MAAM,CAACE,cAAc,IAAIJ,uBAAuB;IAChEK,mBAAmB,EAAEH,MAAM,CAACG;EAC9B,CAAC;AACH;AAEA,OAAO,SAASC,cAAcA,CAACC,CAAe,EAAY;EACxD,OAAO;IACLC,GAAG,EAAED,CAAC,CAACC,GAAG;IACVC,GAAG,EAAEF,CAAC,CAACE,GAAG;IACVC,QAAQ,EAAEH,CAAC,CAACG,QAAQ;IACpBC,KAAK,EAAEJ,CAAC,CAACI,KAAK;IACdC,OAAO,EAAEL,CAAC,CAACK,OAAO;IAClBC,QAAQ,EAAEN,CAAC,CAACM,QAAQ;IACpBC,SAAS,EAAE,IAAIC,IAAI,CAACR,CAAC,CAACS,WAAW;EACnC,CAAC;AACH;AAEA,SAASC,YAAYA,CAACC,CAAqB,EAAc;EACvD,QAAQA,CAAC;IACP,KAAK,MAAM;IACX,KAAK,kBAAkB;IACvB,KAAK,0BAA0B;IAC/B,KAAK,QAAQ;MACX,OAAOA,CAAC;IACV;MACE;MACA,OAAO,MAAM;EACjB;AACF;AAEA,OAAO,SAASC,WAAWA,CAACZ,CAAY,EAAe;EACrD,QAAQA,CAAC,CAACa,IAAI;IACZ,KAAK,MAAM;MACT,OAAO;QAAEC,IAAI,EAAE;MAAO,CAAC;IACzB,KAAK,UAAU;MACb,OAAO;QAAEA,IAAI,EAAE;MAAW,CAAC;IAC7B,KAAK,SAAS;MACZ,OAAO;QAAEA,IAAI,EAAE,SAAS;QAAEC,MAAM,EAAEL,YAAY,CAACV,CAAC,CAACgB,UAAU;MAAE,CAAC;IAChE;MACE;MACA,OAAO;QAAEF,IAAI,EAAE;MAAO,CAAC;EAC3B;AACF;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASG,oBAAoBA,CAACC,CAAU,EAAS;EACtD,MAAMC,IAAI,GAAID,CAAC,EAAoCC,IAAI;EACvD,MAAMC,OAAO,GAAIF,CAAC,EAAuCE,OAAO,IAAIC,MAAM,CAACH,CAAC,CAAC;EAC7E,MAAMJ,IAAI,GAAGQ,UAAU,CAACH,IAAI,CAAC;EAC7B,IAAIL,IAAI,EAAE;IACR,MAAM,IAAIvB,WAAW,CAACuB,IAAI,EAAEM,OAAO,CAAC;EACtC;EACA,MAAMF,CAAC;AACT;AAEA,SAASI,UAAUA,CAACH,IAAwB,EAA+B;EACzE,QAAQA,IAAI;IACV,KAAK,mBAAmB;MACtB,OAAO,kBAAkB;IAC3B,KAAK,4BAA4B;MAC/B,OAAO,0BAA0B;IACnC,KAAK,iBAAiB;MACpB,OAAO,gBAAgB;IACzB;MACE,OAAOI,SAAS;EACpB;AACF","ignoreList":[]}
+{"version":3,"names":["BeekonError","DEFAULTS","minTimeBetweenLocationsSeconds","minDistanceBetweenLocationsMeters","accuracyMode","whenStationary","stationaryRadiusMeters","detectActivity","syncIntervalSeconds","syncBatchSize","recordToEntries","record","Object","keys","map","key","value","configToWire","config","sync","url","headers","intervalSeconds","batchSize","undefined","notification","title","text","geofenceToWire","g","id","lat","latitude","lng","longitude","radiusMeters","notifyOnEntry","notifyOnExit","wireToLocation","w","timestamp","Date","timestampMs","accuracy","speed","bearing","altitude","quality","oneOf","trigger","motion","activity","isMock","wireToGeofence","wireToGeofenceEvent","geofenceId","type","wireToState","kind","reason","toStopReason","stopReason","wireToSyncStatus","toSyncFailure","failure","s","allowed","fallback","includes","rethrowAsBeekonError","e","code","message","String","codeToKind"],"sourceRoot":"../../../src","sources":["internal/mappers.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/types/config.js

@@ -1,2 +1,4 @@
 "use strict";
+
+export {};
 //# sourceMappingURL=config.js.map

package/lib/module/types/enums.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=enums.js.map

package/lib/module/types/enums.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["types/enums.ts"],"mappings":"","ignoreList":[]}

package/lib/module/types/error.js

@@ -1,13 +1,19 @@
 "use strict";
 
 /**
- * Error kinds thrown from `Beekon.start()` / `Beekon.history()`. Match the
- * native `BeekonError` cases byte-for-byte.
+ * Error kinds thrown across the bridge. These are the **only** errors Beekon
+ * throws — permission / location-services / lifecycle problems never throw; they
+ * surface on the `onState` stream as `stopped(reason)` instead.
+ *
+ * - `'storage'` — a local-store (SQLite) read/write failed. Thrown by
+ *   `getLocations()`, `deleteLocations()`, and `pendingUploadCount()`.
+ * - `'invalidGeofence'` — a geofence passed to `addGeofences()` failed
+ *   validation (empty/oversized id, or non-positive radius).
  */
 
 /**
- * Typed error surfaced from the bridge. The native module rejects promises
- * with the kind encoded as the error code; the facade re-wraps into this.
+ * Typed error surfaced from the bridge. The native module rejects promises with
+ * the kind encoded as the error code; the facade re-wraps into this.
  */
 export class BeekonError extends Error {
   constructor(kind, message) {

package/lib/module/types/error.js.map

@@ -1 +1 @@
-{"version":3,"names":["BeekonError","Error","constructor","kind","message","name"],"sourceRoot":"../../../src","sources":["types/error.ts"],"mappings":";;AAAA;AACA;AACA;AACA;;AAMA;AACA;AACA;AACA;AACA,OAAO,MAAMA,WAAW,SAASC,KAAK,CAAC;EAGrCC,WAAWA,CAACC,IAAqB,EAAEC,OAAe,EAAE;IAClD,KAAK,CAACA,OAAO,CAAC;IACd,IAAI,CAACC,IAAI,GAAG,aAAa;IACzB,IAAI,CAACF,IAAI,GAAGA,IAAI;EAClB;AACF","ignoreList":[]}
+{"version":3,"names":["BeekonError","Error","constructor","kind","message","name"],"sourceRoot":"../../../src","sources":["types/error.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA,OAAO,MAAMA,WAAW,SAASC,KAAK,CAAC;EAGrCC,WAAWA,CAACC,IAAqB,EAAEC,OAAe,EAAE;IAClD,KAAK,CAACA,OAAO,CAAC;IACd,IAAI,CAACC,IAAI,GAAG,aAAa;IACzB,IAAI,CAACF,IAAI,GAAGA,IAAI;EAClB;AACF","ignoreList":[]}

package/lib/module/types/geofence.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=geofence.js.map

package/lib/module/types/geofence.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["types/geofence.ts"],"mappings":"","ignoreList":[]}

package/lib/module/types/location.js

@@ -1,2 +1,4 @@
 "use strict";
+
+export {};
 //# sourceMappingURL=location.js.map

package/lib/module/types/sync.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=sync.js.map

package/lib/module/types/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["types/sync.ts"],"mappings":"","ignoreList":[]}