@wayq/beekon-rn 0.0.3 → 0.0.6

package/lib/typescript/src/types/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../../src/types/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5D;;;;;;;;;;GAUG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wFAAwF;IACxF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mFAAmF;IACnF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6FAA6F;IAC7F,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,cAAc,CAAC;IACnC,kFAAkF;IAClF,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,qGAAqG;IACrG,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,uFAAuF;IACvF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,iGAAiG;IACjG,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,oFAAoF;IACpF,KAAK,EAAE,MAAM,CAAC;CACf,CAAC"}

package/lib/typescript/src/types/config.d.ts

@@ -1,33 +1,79 @@
+import type { AuthConfig } from './auth';
+import type { AccuracyMode, StationaryMode } from './enums';
 /**
- * Foreground-service notification overrides. Android-only — required by the
- * platform because every location foreground service must show a persistent
- * notification. All fields are optional; missing values resolve at runtime
- * against the host app's label and icon. Ignored on iOS.
+ * Foreground-service notification overrides. **Android-only** — the platform
+ * requires every location foreground service to show a persistent notification.
+ * Both fields are optional; missing values fall back to native defaults.
+ * Ignored on iOS.
  */
-export type AndroidNotificationConfig = {
-    /** Notification title. Defaults to "Location active". */
+export type NotificationConfig = {
+    /** Notification title. Defaults to "Tracking location". */
     title?: string;
-    /** Notification body text. Defaults to the host app's label. */
+    /** Notification body text. Defaults to no body. */
     text?: string;
     /**
-     * Drawable resource name (e.g. `ic_notification`) — resolved at runtime via
-     * `Resources.getIdentifier()` against the host app's `res/drawable*` folders.
-     * Pass the resource name without extension or `R.drawable.` prefix. Defaults
-     * to the host app's `applicationInfo.icon`.
+     * Status-bar icon, given as an Android drawable or mipmap resource **name**
+     * — `"ic_notification"`, `"drawable/ic_x"`, or `"mipmap/ic_x"`. Android
+     * renders the small icon from its alpha channel only, so supply a monochrome
+     * silhouette on a transparent background. Falls back to the host app's
+     * launcher icon when omitted or unresolvable.
      */
-    smallIconResName?: string;
+    smallIcon?: string;
 };
 /**
- * Tracking configuration. Two knobs: a minimum time interval and a minimum
- * distance between emitted fixes. A fix is admitted only when **both** gates
- * are satisfied. Pass `0` to disable a gate.
+ * Server-upload configuration. Presence of {@link BeekonConfig.sync} turns on
+ * batched uploads of stored locations and geofence events; omitting it keeps
+ * tracking local-only.
  */
-export type BeekonConfig = {
-    /** Minimum seconds between admitted fixes. Default: `30`. `0` disables the time gate. */
+export type SyncConfig = {
+    /** Ingest endpoint — an `http` or `https` URL. */
+    url: string;
+    /** Extra HTTP headers sent with every upload (e.g. `Authorization`). */
+    headers?: Record<string, string>;
+    /**
+     * Target seconds between uploads. The SDK enforces a 60s floor; background
+     * uploads may be delayed to the OS scheduler floor (~15 min). Default: `300`.
+     */
     intervalSeconds?: number;
-    /** Minimum metres between admitted fixes. Default: `100`. `0` disables the distance gate. */
-    distanceMeters?: number;
+    /** Maximum locations per upload. Clamped to `[1, 1000]`. Default: `100`. */
+    batchSize?: number;
+    /**
+     * Declarative token-refresh recipe. When set, the SDK attaches and natively
+     * refreshes the access token (proactively before expiry, reactively on
+     * `401`/`403`). Omit to keep the legacy static-{@link SyncConfig.headers}
+     * behaviour. Requires the native SDK ≥ 0.0.6. See {@link AuthConfig}.
+     */
+    auth?: AuthConfig;
+};
+/**
+ * Tracking configuration. Every field is optional — `Beekon.start()` falls back
+ * to the previously persisted config, or to the documented defaults below if
+ * never configured.
+ *
+ * The two gate knobs (`minTimeBetweenLocationsSeconds`,
+ * `minDistanceBetweenLocationsMeters`) admit a fix only when **both** are
+ * satisfied; pass `0` to disable a gate.
+ */
+export type BeekonConfig = {
+    /** Minimum seconds between admitted fixes (10s floor). Default: `30`. */
+    minTimeBetweenLocationsSeconds?: number;
+    /** Minimum metres between admitted fixes. `0` disables it. Default: `100`. */
+    minDistanceBetweenLocationsMeters?: number;
+    /** Accuracy / battery preset. Default: `'balanced'`. */
+    accuracyMode?: AccuracyMode;
+    /** Behaviour while stationary. Default: `'pause'`. */
+    whenStationary?: StationaryMode;
+    /** Stationary exit-geofence radius, clamped to `[5, 1000]`. Default: `5`. */
+    stationaryRadiusMeters?: number;
+    /**
+     * Detect physical activity (walking, driving, …). Requires the
+     * `ACTIVITY_RECOGNITION` permission on Android and the `NSMotionUsageDescription`
+     * Info.plist key on iOS. Default: `false`.
+     */
+    detectActivity?: boolean;
+    /** Server-upload configuration. Omit to keep tracking local-only. */
+    sync?: SyncConfig;
     /** Android-only notification overrides. Ignored on iOS. */
-    androidNotification?: AndroidNotificationConfig;
+    notification?: NotificationConfig;
 };
 //# sourceMappingURL=config.d.ts.map

package/lib/typescript/src/types/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/types/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,yFAAyF;IACzF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6FAA6F;IAC7F,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2DAA2D;IAC3D,mBAAmB,CAAC,EAAE,yBAAyB,CAAC;CACjD,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/types/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,kDAAkD;IAClD,GAAG,EAAE,MAAM,CAAC;IACZ,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,yEAAyE;IACzE,8BAA8B,CAAC,EAAE,MAAM,CAAC;IACxC,8EAA8E;IAC9E,iCAAiC,CAAC,EAAE,MAAM,CAAC;IAC3C,wDAAwD;IACxD,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,sDAAsD;IACtD,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,6EAA6E;IAC7E,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,qEAAqE;IACrE,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACnC,CAAC"}

package/lib/typescript/src/types/enums.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Value enums shared across the public API, expressed as string-literal unions
+ * (idiomatic TS). Each mirrors the like-named enum on both native SDKs by value;
+ * the wire layer carries them as plain strings and the mappers translate.
+ */
+/**
+ * Accuracy / battery-life preset for the location provider.
+ *
+ * - `'high'` — highest precision, highest battery cost (GPS-grade).
+ * - `'balanced'` — city-block precision, balanced battery (the default).
+ * - `'low'` — coarse, lowest battery.
+ */
+export type AccuracyMode = 'high' | 'balanced' | 'low';
+/**
+ * Behaviour while the device is stationary.
+ *
+ * - `'keepTracking'` — GPS stays on.
+ * - `'pause'` — GPS off while stationary, silent resume on movement (default).
+ * - `'pauseWithCheckIns'` — GPS off, but a location is recorded roughly every
+ *   15 minutes.
+ */
+export type StationaryMode = 'keepTracking' | 'pause' | 'pauseWithCheckIns';
+/**
+ * Why a {@link Location} was admitted and persisted.
+ *
+ * - `'interval'` — a scheduled fix that passed the time/distance gate.
+ * - `'motion'` — the device started or stopped moving.
+ * - `'checkIn'` — a periodic check-in while stationary.
+ * - `'geofence'` — a geofence crossing.
+ * - `'manual'` — an explicit request.
+ */
+export type LocationTrigger = 'interval' | 'motion' | 'checkIn' | 'geofence' | 'manual';
+/**
+ * The gate's quality verdict for a {@link Location}.
+ *
+ * - `'ok'` — passed the accuracy and speed checks.
+ * - `'lowAccuracy'` — worse than the usable accuracy threshold.
+ * - `'implausibleSpeed'` — an implausible jump from the previous fix.
+ */
+export type LocationQuality = 'ok' | 'lowAccuracy' | 'implausibleSpeed';
+/** Device motion when a {@link Location} was captured. */
+export type MotionState = 'moving' | 'stationary' | 'unknown';
+/**
+ * Detected physical activity. Only populated when
+ * {@link BeekonConfig.detectActivity} is enabled; otherwise `null`.
+ */
+export type ActivityType = 'stationary' | 'walking' | 'running' | 'cycling' | 'automotive' | 'unknown';
+/**
+ * How the access token is attached to upload requests (token refresh).
+ *
+ * - `'bearer'` — `Authorization: Bearer <accessToken>` (JWT / OAuth2 style, default).
+ * - `'raw'` — `Authorization: <accessToken>` (the raw token, no scheme).
+ */
+export type AuthStrategy = 'bearer' | 'raw';
+/**
+ * Encoding of the token-refresh request body.
+ *
+ * - `'form'` — `application/x-www-form-urlencoded` (default; most OAuth2 endpoints).
+ * - `'json'` — `application/json`.
+ */
+export type AuthBodyFormat = 'form' | 'json';
+//# sourceMappingURL=enums.d.ts.map

package/lib/typescript/src/types/enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../../../../src/types/enums.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,UAAU,GAAG,KAAK,CAAC;AAEvD;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG,OAAO,GAAG,mBAAmB,CAAC;AAE5E;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GACvB,UAAU,GACV,QAAQ,GACR,SAAS,GACT,UAAU,GACV,QAAQ,CAAC;AAEb;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,aAAa,GAAG,kBAAkB,CAAC;AAExE,0DAA0D;AAC1D,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,YAAY,GAAG,SAAS,CAAC;AAE9D;;;GAGG;AACH,MAAM,MAAM,YAAY,GACpB,YAAY,GACZ,SAAS,GACT,SAAS,GACT,SAAS,GACT,YAAY,GACZ,SAAS,CAAC;AAEd;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,CAAC"}

package/lib/typescript/src/types/error.d.ts

@@ -1,11 +1,27 @@
 /**
- * Error kinds thrown from `Beekon.start()` / `Beekon.history()`. Match the
- * native `BeekonError` cases byte-for-byte.
+ * Error kinds thrown across the bridge.
+ *
+ * Lifecycle problems on the tracking path never throw — they surface on the
+ * `onState` stream as `stopped(reason)`. The exceptions are the storage/geofence
+ * kinds below and the precondition kinds thrown by the explicit one-shot
+ * `getCurrentLocation()` (which has no `onState` arc of its own to report on; a
+ * plain timeout returns `null` instead of throwing).
+ *
+ * - `'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).
+ * - `'permissionDenied'` — location permission is missing. Thrown by
+ *   `getCurrentLocation()`.
+ * - `'locationServicesDisabled'` — system location services are off. Thrown by
+ *   `getCurrentLocation()`.
+ * - `'locationUnavailable'` — location is otherwise unavailable (e.g. Play
+ *   Services absent/old). Thrown by `getCurrentLocation()`.
  */
-export type BeekonErrorKind = 'permissionDenied' | 'locationServicesDisabled' | 'storageFailure';
+export type BeekonErrorKind = 'storage' | 'invalidGeofence' | 'permissionDenied' | 'locationServicesDisabled' | 'locationUnavailable';
 /**
- * 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 declare class BeekonError extends Error {
     readonly kind: BeekonErrorKind;

package/lib/typescript/src/types/error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../../../src/types/error.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,eAAe,GACvB,kBAAkB,GAClB,0BAA0B,GAC1B,gBAAgB,CAAC;AAErB;;;GAGG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,SAAgB,IAAI,EAAE,eAAe,CAAC;gBAE1B,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM;CAKnD"}
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../../../src/types/error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,iBAAiB,GACjB,kBAAkB,GAClB,0BAA0B,GAC1B,qBAAqB,CAAC;AAE1B;;;GAGG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,SAAgB,IAAI,EAAE,eAAe,CAAC;gBAE1B,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM;CAKnD"}

package/lib/typescript/src/types/geofence.d.ts

@@ -0,0 +1,36 @@
+/**
+ * A circular geofence registered via `Beekon.addGeofences()`. Mirrors
+ * `BeekonGeofence` on both native SDKs. The SDK pages registrations
+ * automatically, so you may register more than the OS geofence limit.
+ */
+export type BeekonGeofence = {
+    /** Unique id, 1–100 characters. Re-adding an existing id replaces it. */
+    id: string;
+    /** Center latitude in degrees, WGS-84. */
+    latitude: number;
+    /** Center longitude in degrees, WGS-84. */
+    longitude: number;
+    /** Radius in metres. Must be `> 0`; `>= 100` is recommended for reliability. */
+    radiusMeters: number;
+    /** Emit an event on entry. Default: `true`. */
+    notifyOnEntry?: boolean;
+    /** Emit an event on exit. Default: `true`. */
+    notifyOnExit?: boolean;
+};
+/** Whether a {@link GeofenceEvent} marks entering or exiting a geofence. */
+export type Transition = 'enter' | 'exit';
+/**
+ * A geofence entry/exit crossing, delivered via `Beekon.onGeofenceEvent()`.
+ * Mirrors `GeofenceEvent` on both native SDKs.
+ */
+export type GeofenceEvent = {
+    /** Unique event id. Used as the dedup key on upload. */
+    id: string;
+    /** The {@link BeekonGeofence.id} that was crossed. */
+    geofenceId: string;
+    /** Whether the device entered or exited. */
+    type: Transition;
+    /** When the crossing happened. */
+    timestamp: Date;
+};
+//# sourceMappingURL=geofence.d.ts.map

package/lib/typescript/src/types/geofence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geofence.d.ts","sourceRoot":"","sources":["../../../../src/types/geofence.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,yEAAyE;IACzE,EAAE,EAAE,MAAM,CAAC;IACX,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,YAAY,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,8CAA8C;IAC9C,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,4EAA4E;AAC5E,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;AAE1C;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,wDAAwD;IACxD,EAAE,EAAE,MAAM,CAAC;IACX,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,IAAI,EAAE,UAAU,CAAC;IACjB,kCAAkC;IAClC,SAAS,EAAE,IAAI,CAAC;CACjB,CAAC"}

package/lib/typescript/src/types/location.d.ts

@@ -1,17 +1,23 @@
+import type { ActivityType, LocationQuality, LocationTrigger, MotionState } from './enums';
 /**
  * A single location fix as emitted by the native SDK after gating. Fields map
  * 1:1 to `in.wayq.beekon.Location` on Android and `BeekonKit.Location` on iOS.
  *
- * `lat`, `lng`, and `timestamp` are always present. The four optional fields
- * are `null` when the OS did not report a value — the SDK never invents a
- * value to mask absence (e.g. a stationary device returns `bearing === null`,
- * not `0`).
+ * `id`, `latitude`, `longitude`, and `timestamp` are always present. The four
+ * optional numeric fields are `null` when the OS did not report a value — the
+ * SDK never invents a value to mask absence (e.g. a stationary device returns
+ * `bearing === null`, not `0`). `activity` is `null` unless
+ * {@link BeekonConfig.detectActivity} is enabled.
  */
 export type Location = {
+    /** Stable, unique storage id. Used as the dedup key on upload. */
+    id: string;
     /** Latitude in degrees, WGS-84. */
-    lat: number;
+    latitude: number;
     /** Longitude in degrees, WGS-84. */
-    lng: number;
+    longitude: number;
+    /** Time the OS provider reported this fix (not when JS received it). */
+    timestamp: Date;
     /** Horizontal accuracy in meters (1-sigma); `null` if unreported. */
     accuracy: number | null;
     /** Speed in m/s; `null` if unreported. */
@@ -20,7 +26,15 @@ export type Location = {
     bearing: number | null;
     /** Altitude in meters above the WGS-84 ellipsoid; `null` if unreported. */
     altitude: number | null;
-    /** Time the OS provider reported this fix (not when JS received it). */
-    timestamp: Date;
+    /** The gate's quality verdict for this fix. */
+    quality: LocationQuality;
+    /** Why this fix was captured. */
+    trigger: LocationTrigger;
+    /** Device motion when this fix was captured. */
+    motion: MotionState;
+    /** Detected activity, or `null` unless activity detection is enabled. */
+    activity: ActivityType | null;
+    /** `true` if the OS flagged this fix as mock/simulated. */
+    isMock: boolean;
 };
 //# sourceMappingURL=location.d.ts.map

package/lib/typescript/src/types/location.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"location.d.ts","sourceRoot":"","sources":["../../../../src/types/location.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,mCAAmC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,qEAAqE;IACrE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,qFAAqF;IACrF,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,wEAAwE;IACxE,SAAS,EAAE,IAAI,CAAC;CACjB,CAAC"}
+{"version":3,"file":"location.d.ts","sourceRoot":"","sources":["../../../../src/types/location.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,eAAe,EACf,WAAW,EACZ,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;GASG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,SAAS,EAAE,IAAI,CAAC;IAChB,qEAAqE;IACrE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,qFAAqF;IACrF,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,+CAA+C;IAC/C,OAAO,EAAE,eAAe,CAAC;IACzB,iCAAiC;IACjC,OAAO,EAAE,eAAe,CAAC;IACzB,gDAAgD;IAChD,MAAM,EAAE,WAAW,CAAC;IACpB,yEAAyE;IACzE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9B,2DAA2D;IAC3D,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC"}

package/lib/typescript/src/types/state.d.ts

@@ -1,15 +1,24 @@
 /**
  * Reason a tracking session ended. Mirrors `StopReason` on both platforms.
  *
- * `'system'` is Android-only — surfaces when the OS terminates the foreground
- * service (memory pressure, force-stop). iOS will never emit `'system'`.
+ * - `'user'` — `Beekon.stop()` was called.
+ * - `'permissionDenied'` — location permission is missing or was revoked
+ *   (user-fixable in Settings).
+ * - `'locationServicesDisabled'` — system-wide location services are off
+ *   (user-fixable in Settings).
+ * - `'locationUnavailable'` — no usable location backend on this device (e.g.
+ *   Google Play Services absent/outdated on Android). Not user-fixable.
+ * - `'system'` — the OS terminated tracking (e.g. foreground-service kill,
+ *   or an unrecoverable internal error).
  */
-export type StopReason = 'user' | 'permissionDenied' | 'locationServicesDisabled' | 'system';
+export type StopReason = 'user' | 'permissionDenied' | 'locationServicesDisabled' | 'locationUnavailable' | 'system';
 /**
  * Tracking state. Mirrors the native `BeekonState` sealed type on both
  * platforms. Use the `kind` field as a discriminator.
  *
- * Lifecycle: `idle → tracking → stopped(reason)`.
+ * Lifecycle: `idle → tracking → stopped(reason)`. `start()` / `stop()` never
+ * throw — this stream is the single source of truth for whether tracking is
+ * active and why it stopped.
  */
 export type BeekonState = {
     kind: 'idle';

package/lib/typescript/src/types/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../src/types/state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,kBAAkB,GAClB,0BAA0B,GAC1B,QAAQ,CAAC;AAEb;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../src/types/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,kBAAkB,GAClB,0BAA0B,GAC1B,qBAAqB,GACrB,QAAQ,CAAC;AAEb;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC"}

package/lib/typescript/src/types/sync.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Why a server upload failed terminally. Mirrors `SyncFailure` on both
+ * platforms.
+ *
+ * - `'auth'` — `401`/`403`; credentials were rejected. Refresh them (via
+ *   `Beekon.configure()` with new `sync.headers`) and sync resumes.
+ * - `'rejected'` — `400`/`422`; the server rejected the payload. A payload bug;
+ *   it won't self-resolve.
+ */
+export type SyncFailure = 'auth' | 'rejected';
+/**
+ * Upload health, delivered via `Beekon.onSyncStatus()`. Mirrors the native
+ * `SyncStatus` sealed type. Use the `kind` field as a discriminator.
+ *
+ * - `'idle'` — caught up, or sync is not configured.
+ * - `'pending'` — uploading or retrying (healthy).
+ * - `'failed'` — a terminal failure the app must act on.
+ */
+export type SyncStatus = {
+    kind: 'idle';
+} | {
+    kind: 'pending';
+} | {
+    kind: 'failed';
+    reason: SyncFailure;
+};
+//# sourceMappingURL=sync.d.ts.map

package/lib/typescript/src/types/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../../src/types/sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,UAAU,CAAC;AAE9C;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wayq/beekon-rn",
-  "version": "0.0.3",
+  "version": "0.0.6",
   "description": "React Native binding for the Beekon location SDK (Android + iOS).",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
@@ -20,6 +20,7 @@
     "scripts/fetch-beekonkit.sh",
     "*.podspec",
     "LICENSE.txt",
+    "CHANGELOG.md",
     "!ios/build",
     "!android/build",
     "!android/gradle",
@@ -45,23 +46,25 @@
     "android",
     "location",
     "tracking",
+    "location-tracking",
     "gps",
+    "gps-tracking",
     "background-location",
     "geolocation",
+    "geofencing",
     "beekon",
     "turbo-module"
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/wayqteam/beekon.git",
-    "directory": "beekon-rn"
+    "url": "git+https://github.com/wayqteam/beekon-rn.git"
   },
   "author": "wayqteam <wayqteam@users.noreply.github.com> (https://github.com/wayqteam)",
   "license": "SEE LICENSE IN LICENSE.txt",
   "bugs": {
-    "url": "https://github.com/wayqteam/beekon/issues"
+    "url": "https://github.com/wayqteam/beekon-rn/issues"
   },
-  "homepage": "https://github.com/wayqteam/beekon/tree/main/beekon-rn#readme",
+  "homepage": "https://github.com/wayqteam/beekon-rn#readme",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"

package/scripts/fetch-beekonkit.sh

@@ -13,12 +13,12 @@
 
 set -euo pipefail
 
-VERSION="0.0.3"
+VERSION="0.0.6"
 URL="https://github.com/wayqteam/beekon-ios-binary/releases/download/v${VERSION}/BeekonKit.xcframework.zip"
-# TODO(0.0.3): replace with the SHA256 emitted by `scripts/build-xcframework.sh`
-# when the v0.0.3 BeekonKit binary is cut and uploaded. v0.0.3 is the first
-# release with nullable Location fields (accuracy/speed/bearing/altitude).
-EXPECTED_SHA="c2f1990dd7064314deffc4af430839b0c8b7e61851e591c34fb683aed2fff127"
+# SHA256 of the v0.0.6 BeekonKit.xcframework.zip. Matches the SwiftPM
+# `binaryTarget` checksum in beekon-ios-binary's Package.swift at tag v0.0.6
+# (SwiftPM's compute-checksum is the SHA256 of the zip).
+EXPECTED_SHA="eb0cd87c869cdbce5374569efa2d47f0f7e6c01ce18461c0653ef701163cf343"
 
 ROOT="$(cd "$(dirname "$0")/.." && pwd)"
 DEST_DIR="${ROOT}/ios/Frameworks"