@wayq/beekon-rn 0.0.3 → 0.0.5

package/lib/typescript/src/NativeBeekonRn.d.ts

@@ -1,53 +1,135 @@
 /**
- * Codegen TurboModule spec — DO NOT export Wire* types from `src/index.tsx`.
- * The public TS API in `src/beekon.ts` and `src/types/` is what consumers use;
- * mappers in `src/internal/mappers.ts` convert between the two.
+ * Codegen TurboModule spec — the single source React Native's Codegen reads to
+ * generate the native interface. **DO NOT export Wire* types from
+ * `src/index.tsx`.** The public TS API in `src/beekon.ts` and `src/types/` is
+ * what consumers use; mappers in `src/internal/mappers.ts` convert between the
+ * two.
  *
- * Wire types are flat (primitives + nested flat objects) because Codegen's
- * TS-to-Kotlin/ObjC type derivation has limited support for unions and
- * recursive structures. The state variants are encoded as a `type`
- * discriminator string with sibling fields nullable per variant.
+ * Wire types are deliberately **flat** (primitives + flat nested objects +
+ * arrays) because Codegen's TS→Kotlin/ObjC derivation has no support for unions
+ * or recursive structures:
+ *
+ * - **Enums travel as plain `string`** (e.g. `accuracyMode`, `quality`); the
+ *   mappers translate to/from the public string-literal unions with a defensive
+ *   fallback, so an unknown value never crashes a subscriber.
+ * - **Sum types** (`WireState`, `WireSyncStatus`) are a `type` discriminator
+ *   string plus sibling fields nullable per variant.
+ * - **String maps** (`headers`, `extras`) travel as `WireKeyValue[]` pairs —
+ *   Codegen has no portable dictionary type.
+ * - **Timestamps** are epoch-milliseconds; intervals are seconds.
  */
 import type { CodegenTypes, TurboModule } from 'react-native';
-export type WireAndroidNotification = {
+/** A single string map entry — see `headers` / `setExtras`. */
+export type WireKeyValue = {
+    key: string;
+    value: string;
+};
+export type WireSyncConfig = {
+    url: string;
+    headers: WireKeyValue[];
+    intervalSeconds: number;
+    batchSize: number;
+};
+/** Android-only foreground-service notification overrides. iOS ignores it. */
+export type WireNotificationConfig = {
     title?: string;
     text?: string;
-    smallIconResName?: string;
 };
 export type WireConfig = {
-    /** Required at the wire level — the TS facade applies defaults (30 / 100). */
-    intervalSeconds: number;
-    /** Required at the wire level — the TS facade applies defaults (30 / 100). */
-    distanceMeters: number;
-    /** Android-only. iOS native module ignores. */
-    androidNotification?: WireAndroidNotification;
+    /** All fields required at the wire level — the TS facade applies defaults. */
+    minTimeBetweenLocationsSeconds: number;
+    minDistanceBetweenLocationsMeters: number;
+    /** One of: 'high' | 'balanced' | 'low'. */
+    accuracyMode: string;
+    /** One of: 'keepTracking' | 'pause' | 'pauseWithCheckIns'. */
+    whenStationary: string;
+    stationaryRadiusMeters: number;
+    detectActivity: boolean;
+    /** Omitted keeps tracking local-only. */
+    sync?: WireSyncConfig;
+    /** Android-only; the iOS native module ignores it. */
+    notification?: WireNotificationConfig;
 };
 export type WireLocation = {
+    id: string;
     lat: number;
     lng: number;
     timestampMs: number;
-    /** `null` when the OS did not report a value (e.g. low-confidence fix). */
+    /** `null` when the OS did not report a value. */
     accuracy: number | null;
     speed: number | null;
     bearing: number | null;
     altitude: number | null;
+    /** One of: 'ok' | 'lowAccuracy' | 'implausibleSpeed'. */
+    quality: string;
+    /** One of: 'interval' | 'motion' | 'checkIn' | 'geofence' | 'manual'. */
+    trigger: string;
+    /** One of: 'moving' | 'stationary' | 'unknown'. */
+    motion: string;
+    /** Activity enum string, or `null` unless activity detection is enabled. */
+    activity: string | null;
+    isMock: boolean;
+};
+export type WireGeofence = {
+    id: string;
+    lat: number;
+    lng: number;
+    radiusMeters: number;
+    notifyOnEntry: boolean;
+    notifyOnExit: boolean;
+};
+export type WireGeofenceEvent = {
+    id: string;
+    geofenceId: string;
+    /** One of: 'enter' | 'exit'. */
+    type: string;
+    timestampMs: number;
 };
 export type WireState = {
     /** One of: 'idle' | 'tracking' | 'stopped'. */
     type: string;
     /**
-     * Only populated when `type === 'stopped'`. One of:
-     * 'user' | 'permissionDenied' | 'locationServicesDisabled' | 'system'.
+     * Only populated when `type === 'stopped'`. One of: 'user' |
+     * 'permissionDenied' | 'locationServicesDisabled' | 'locationUnavailable' |
+     * 'system'.
      */
     stopReason?: string;
 };
+export type WireSyncStatus = {
+    /** One of: 'idle' | 'pending' | 'failed'. */
+    type: string;
+    /** Only populated when `type === 'failed'`. One of: 'auth' | 'rejected'. */
+    failure?: string;
+};
 export interface Spec extends TurboModule {
-    configure(config: WireConfig): Promise<void>;
+    /**
+     * The config crosses as an untyped object (`ReadableMap` on Android,
+     * `NSDictionary` on iOS) and is parsed natively. Typing it as the nested
+     * {@link WireConfig} struct would force the iOS ObjC++ layer to walk Codegen's
+     * generated C++ structs; the facade still builds a `WireConfig`-shaped value
+     * via `configToWire`, so the shape is enforced upstream.
+     */
+    configure(config: CodegenTypes.UnsafeObject): Promise<void>;
     start(): Promise<void>;
     stop(): Promise<void>;
-    history(fromMs: number, toMs: number): Promise<WireLocation[]>;
+    resumeIfNeeded(): Promise<void>;
+    getLocations(fromMs: number, toMs: number): Promise<WireLocation[]>;
+    /**
+     * A negative `beforeMs` deletes all stored locations (the wire encoding of
+     * the public `deleteLocations()` no-argument case). A plain `number` is used
+     * rather than `number | null` for portable Codegen support across platforms.
+     */
+    deleteLocations(beforeMs: number): Promise<number>;
+    pendingUploadCount(): Promise<number>;
+    sync(): Promise<void>;
+    setExtras(entries: WireKeyValue[]): Promise<void>;
+    addGeofences(geofences: WireGeofence[]): Promise<void>;
+    removeGeofences(ids: string[]): Promise<void>;
+    listGeofences(): Promise<WireGeofence[]>;
     readonly onState: CodegenTypes.EventEmitter<WireState>;
     readonly onLocation: CodegenTypes.EventEmitter<WireLocation>;
+    readonly onGeofenceEvent: CodegenTypes.EventEmitter<WireGeofenceEvent>;
+    readonly onSyncStatus: CodegenTypes.EventEmitter<WireSyncStatus>;
 }
 declare const _default: Spec;
 export default _default;

package/lib/typescript/src/NativeBeekonRn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NativeBeekonRn.d.ts","sourceRoot":"","sources":["../../../src/NativeBeekonRn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG9D,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,8EAA8E;IAC9E,eAAe,EAAE,MAAM,CAAC;IACxB,8EAA8E;IAC9E,cAAc,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,mBAAmB,CAAC,EAAE,uBAAuB,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAE/D,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IACvD,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;CAC9D;;AAED,wBAAkE"}
+{"version":3,"file":"NativeBeekonRn.d.ts","sourceRoot":"","sources":["../../../src/NativeBeekonRn.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/beekon.d.ts

@@ -1,66 +1,114 @@
 import type { BeekonConfig } from './types/config';
-import type { BeekonState } from './types/state';
+import type { BeekonGeofence, GeofenceEvent } from './types/geofence';
 import type { Location } from './types/location';
+import type { BeekonState } from './types/state';
+import type { SyncStatus } from './types/sync';
 /**
- * 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()`.
  */
 declare class BeekonImpl {
+    private readonly hub;
     /**
      * 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()`.
      */
     configure(config: BeekonConfig): Promise<void>;
     /**
-     * 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).
+     * 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`.
      */
     start(): Promise<void>;
-    /** Stop tracking. Idempotent. State transitions to `stopped(user)`. */
+    /** Stop tracking. Idempotent. Registered geofences keep firing. */
     stop(): Promise<void>;
     /**
-     * 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.
+     * 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.
      *
-     * Retention: fixes older than 7 days OR beyond the most recent 100K are
-     * pruned automatically.
+     * 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.
+     */
+    resumeIfNeeded(): Promise<void>;
+    /**
+     * 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 `'storageFailure'` on database read failure.
+     * Throws `BeekonError` with kind `'storage'` on a database read failure.
+     */
+    getLocations(from: Date, to: Date): Promise<Location[]>;
+    /**
+     * 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.
+     */
+    deleteLocations(before?: Date): Promise<number>;
+    /**
+     * The number of stored locations not yet uploaded. Throws `BeekonError` with
+     * kind `'storage'` on a failure.
+     */
+    pendingUploadCount(): Promise<number>;
+    /**
+     * Request an immediate upload. Best-effort and self-retrying; a no-op when
+     * sync is not configured.
+     */
+    sync(): Promise<void>;
+    /** Set custom key/value fields (e.g. `user_id`) included with every upload. */
+    setExtras(extras: Record<string, string>): Promise<void>;
+    /**
+     * 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.
      */
-    history(from: Date, to: Date): Promise<Location[]>;
+    addGeofences(geofences: BeekonGeofence[]): Promise<void>;
+    /** Unregister geofences by id. Unknown ids are ignored. */
+    removeGeofences(ids: string[]): Promise<void>;
+    /** The currently registered geofences. */
+    listGeofences(): Promise<BeekonGeofence[]>;
     /**
-     * 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: (s: BeekonState) => void): () => void;
     /**
-     * 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: (l: Location) => void): () => void;
+    /**
+     * Subscribe to geofence enter / exit crossings. Broadcast (no replay).
+     * Returns an unsubscribe function.
+     */
+    onGeofenceEvent(cb: (e: GeofenceEvent) => void): () => void;
+    /**
+     * 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: (s: SyncStatus) => void): () => void;
 }
 export declare const Beekon: BeekonImpl;
 export {};

package/lib/typescript/src/beekon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"beekon.d.ts","sourceRoot":"","sources":["../../../src/beekon.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAQjD;;;;;;;;;;;;;;;;GAgBG;AACH,cAAM,UAAU;IACd;;;;;;OAMG;IACG,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpD;;;;;;;OAOG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B,uEAAuE;IACjE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B;;;;;;;;;OASG;IACG,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IASxD;;;;OAIG;IACH,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,IAAI,GAAG,MAAM,IAAI;IAKjD;;;;OAIG;IACH,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,KAAK,IAAI,GAAG,MAAM,IAAI;CAMlD;AAED,eAAO,MAAM,MAAM,YAAmB,CAAC"}
+{"version":3,"file":"beekon.d.ts","sourceRoot":"","sources":["../../../src/beekon.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AA8F/C;;;;;;;;;;;;;;;;;GAiBG;AACH,cAAM,UAAU;IACd,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAkB;IAEtC;;;;;OAKG;IACG,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpD;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,mEAAmE;IAC7D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B;;;;;;;;OAQG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAKrC;;;;;;;OAOG;IACG,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAY7D;;;;OAIG;IACG,eAAe,CAAC,MAAM,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IASrD;;;OAGG;IACG,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC;IAQ3C;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,+EAA+E;IACzE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9D;;;;OAIG;IACG,YAAY,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ9D,2DAA2D;IACrD,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD,0CAA0C;IACpC,aAAa,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAKhD;;;;OAIG;IACH,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,IAAI,GAAG,MAAM,IAAI;IAIjD;;;;OAIG;IACH,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,KAAK,IAAI,GAAG,MAAM,IAAI;IAIjD;;;OAGG;IACH,eAAe,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI;IAI3D;;;;OAIG;IACH,YAAY,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,GAAG,MAAM,IAAI;CAGtD;AAED,eAAO,MAAM,MAAM,YAAmB,CAAC"}

package/lib/typescript/src/index.d.ts

@@ -1,6 +1,9 @@
 export { Beekon } from './beekon';
-export type { BeekonConfig, AndroidNotificationConfig } from './types/config';
-export type { BeekonState, StopReason } from './types/state';
+export type { BeekonConfig, SyncConfig, NotificationConfig, } from './types/config';
+export type { AccuracyMode, StationaryMode, LocationTrigger, LocationQuality, MotionState, ActivityType, } from './types/enums';
 export type { Location } from './types/location';
+export type { BeekonGeofence, GeofenceEvent, Transition, } from './types/geofence';
+export type { BeekonState, StopReason } from './types/state';
+export type { SyncStatus, SyncFailure } from './types/sync';
 export { BeekonError, type BeekonErrorKind } from './types/error';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC9E,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC7D,YAAY,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,YAAY,EACV,YAAY,EACZ,UAAU,EACV,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,YAAY,EACZ,cAAc,EACd,eAAe,EACf,eAAe,EACf,WAAW,EACX,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EACV,cAAc,EACd,aAAa,EACb,UAAU,GACX,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC7D,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/lib/typescript/src/internal/mappers.d.ts

@@ -1,15 +1,21 @@
 import type { BeekonConfig } from '../types/config';
-import type { BeekonState } from '../types/state';
+import type { BeekonGeofence, GeofenceEvent } from '../types/geofence';
 import type { Location } from '../types/location';
-import type { WireConfig, WireLocation, WireState } from '../NativeBeekonRn';
+import type { BeekonState } from '../types/state';
+import type { SyncStatus } from '../types/sync';
+import type { WireConfig, WireGeofence, WireGeofenceEvent, WireKeyValue, WireLocation, WireState, WireSyncStatus } from '../NativeBeekonRn';
+export declare function recordToEntries(record: Record<string, string> | undefined): WireKeyValue[];
 export declare function configToWire(config: BeekonConfig): WireConfig;
+export declare function geofenceToWire(g: BeekonGeofence): WireGeofence;
 export declare function wireToLocation(w: WireLocation): Location;
+export declare function wireToGeofence(w: WireGeofence): BeekonGeofence;
+export declare function wireToGeofenceEvent(w: WireGeofenceEvent): GeofenceEvent;
 export declare function wireToState(w: WireState): BeekonState;
+export declare function wireToSyncStatus(w: WireSyncStatus): SyncStatus;
 /**
- * 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 declare function rethrowAsBeekonError(e: unknown): never;
 //# sourceMappingURL=mappers.d.ts.map

package/lib/typescript/src/internal/mappers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mappers.d.ts","sourceRoot":"","sources":["../../../../src/internal/mappers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,gBAAgB,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAK7E,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,UAAU,CAM7D;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,YAAY,GAAG,QAAQ,CAUxD;AAeD,wBAAgB,WAAW,CAAC,CAAC,EAAE,SAAS,GAAG,WAAW,CAYrD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,OAAO,GAAG,KAAK,CAQtD"}
+{"version":3,"file":"mappers.d.ts","sourceRoot":"","sources":["../../../../src/internal/mappers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AASpD,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EAEd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,gBAAgB,CAAC;AAC9D,OAAO,KAAK,EAAe,UAAU,EAAE,MAAM,eAAe,CAAC;AAE7D,OAAO,KAAK,EACV,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,cAAc,EACf,MAAM,mBAAmB,CAAC;AAiB3B,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GACzC,YAAY,EAAE,CAGhB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,UAAU,CA0B7D;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,cAAc,GAAG,YAAY,CAS9D;AAID,wBAAgB,cAAc,CAAC,CAAC,EAAE,YAAY,GAAG,QAAQ,CA0CxD;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,YAAY,GAAG,cAAc,CAS9D;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,iBAAiB,GAAG,aAAa,CAOvE;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,SAAS,GAAG,WAAW,CAYrD;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,cAAc,GAAG,UAAU,CAW9D;AAoCD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,OAAO,GAAG,KAAK,CAQtD"}

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

@@ -1,33 +1,63 @@
+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;
+};
+/**
+ * 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 SyncConfig = {
+    /** Ingest endpoint — an `http` or `https` URL. */
+    url: string;
+    /** Extra HTTP headers sent with every upload (e.g. `Authorization`). */
+    headers?: Record<string, 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`.
+     * Target seconds between uploads. The SDK enforces a 60s floor; background
+     * uploads may be delayed to the OS scheduler floor (~15 min). Default: `300`.
      */
-    smallIconResName?: string;
+    intervalSeconds?: number;
+    /** Maximum locations per upload. Clamped to `[1, 1000]`. Default: `100`. */
+    batchSize?: number;
 };
 /**
- * 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.
+ * 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. Default: `30`. `0` disables the time gate. */
-    intervalSeconds?: number;
-    /** Minimum metres between admitted fixes. Default: `100`. `0` disables the distance gate. */
-    distanceMeters?: number;
+    /** 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,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;CACf,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;CACpB,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,48 @@
+/**
+ * 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';
+//# 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"}

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

@@ -1,11 +1,17 @@
 /**
- * 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).
  */
-export type BeekonErrorKind = 'permissionDenied' | 'locationServicesDisabled' | 'storageFailure';
+export type BeekonErrorKind = 'storage' | 'invalidGeofence';
 /**
- * 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;;;;;;;;;GASG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,iBAAiB,CAAC;AAE5D;;;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"}