@wayq/beekon-rn 0.0.3 → 0.0.6

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,29 @@
 "use strict";
 
 /**
- * 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()`.
  */
 
 /**
- * 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;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAQA;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":[]}

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

@@ -1,53 +1,183 @@
 /**
- * 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;
+};
+/** Flat wire form of `AuthResponseMapping`. Omitted keys use common-name detection. */
+export type WireAuthResponseMapping = {
+    accessToken?: string;
+    refreshToken?: string;
+    expiresIn?: string;
+    expiresAt?: string;
+};
+/**
+ * Flat wire form of `AuthConfig` on {@link WireSyncConfig.auth}. Enums travel as
+ * strings (`strategy`: 'bearer'|'raw'; `refreshBodyFormat`: 'form'|'json'),
+ * string maps as `WireKeyValue[]`, and `expiresAtMs` is epoch milliseconds.
+ */
+export type WireAuthConfig = {
+    accessToken?: string;
+    refreshToken?: string;
+    expiresAtMs?: number;
+    strategy: string;
+    refreshUrl?: string;
+    refreshPayload: WireKeyValue[];
+    refreshHeaders: WireKeyValue[];
+    refreshBodyFormat: string;
+    responseMapping: WireAuthResponseMapping;
+    skewMarginSeconds: number;
+    seedEpoch?: number;
+};
+export type WireSyncConfig = {
+    url: string;
+    headers: WireKeyValue[];
+    intervalSeconds: number;
+    batchSize: number;
+    /** Token-refresh recipe; omitted keeps static-header auth. */
+    auth?: WireAuthConfig;
+};
+/** Android-only foreground-service notification overrides. iOS ignores it. */
+export type WireNotificationConfig = {
     title?: string;
     text?: string;
-    smallIconResName?: string;
+    smallIcon?: 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;
+};
+/**
+ * A token set the SDK rotated, delivered on `onAuthTokens`. `expiresAtMs` is
+ * epoch milliseconds; both it and `refreshToken` are `null` when absent.
+ */
+export type WireAuthTokens = {
+    accessToken: string;
+    refreshToken: string | null;
+    expiresAtMs: number | null;
+    epoch: number;
+};
 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>;
+    /**
+     * One immediate fix. `accuracy` `''` uses the configured mode (a plain
+     * `string` rather than `string | null` for portable Codegen, matching
+     * `deleteLocations`). Resolves a 0- or 1-element array — empty means timeout /
+     * no fix — rather than a nullable struct, which Codegen does not portably
+     * support. Rejects with `PERMISSION_DENIED` / `LOCATION_SERVICES_DISABLED` /
+     * `LOCATION_UNAVAILABLE` on a precondition failure.
+     */
+    getCurrentLocation(timeoutMs: number, accuracy: string): Promise<WireLocation[]>;
+    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>;
+    readonly onAuthTokens: CodegenTypes.EventEmitter<WireAuthTokens>;
 }
 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,143 @@
+import type { AuthTokens } from './types/auth';
 import type { BeekonConfig } from './types/config';
-import type { BeekonState } from './types/state';
+import type { AccuracyMode } from './types/enums';
+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.
+     *
+     * 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>;
+    /**
+     * Return a single fresh fix on demand — for the moment a host needs an
+     * immediate position (e.g. the instant a trip starts).
      *
-     * Retention: fixes older than 7 days OR beyond the most recent 100K are
-     * pruned automatically.
+     * Independent of tracking: works whether or not a session is running and never
+     * starts, stops, or disturbs one. The fix is not persisted and does not appear
+     * on `onLocation` — it is returned here only, tagged `'manual'`.
      *
-     * Throws `BeekonError` with kind `'storageFailure'` on database read failure.
+     * Resolves `null` if no usable fix arrives within `timeoutMs` (default
+     * 15000). `accuracy` overrides the configured mode for this call only;
+     * omitted uses the configured mode.
+     *
+     * Throws `BeekonError` with kind `'permissionDenied'`,
+     * `'locationServicesDisabled'`, or `'locationUnavailable'` on a precondition
+     * failure.
+     */
+    getCurrentLocation(options?: {
+        timeoutMs?: number;
+        accuracy?: AccuracyMode;
+    }): Promise<Location | null>;
+    /**
+     * 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.
+     */
+    getLocations(from: Date, to: Date): Promise<Location[]>;
+    /**
+     * Delete stored locations captured before `before` (all of them when
+     * `before` is omitted). Returns the number of rows removed. Throws
+     * `BeekonError` with kind `'storage'` on a failure.
      */
-    history(from: Date, to: Date): Promise<Location[]>;
+    deleteLocations(before?: Date): Promise<number>;
     /**
-     * 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).
+     * 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.
+     */
+    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 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;
+    /**
+     * Subscribe to token rotations the SDK performed during a native refresh (see
+     * `SyncConfig.auth`). Mirror them into your own session store. The latest
+     * rotation is delivered to new subscribers immediately (replay-1). Sensitive —
+     * delivered in-process only, never logged. Returns an unsubscribe function.
+     */
+    onAuthTokens(cb: (t: AuthTokens) => 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,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,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;AA+G/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;;;;;;;;;;;;;;;OAeG;IACG,kBAAkB,CAAC,OAAO,CAAC,EAAE;QACjC,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,YAAY,CAAC;KACzB,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAY5B;;;;;;;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;IAIrD;;;;;OAKG;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,10 @@
 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, AuthStrategy, AuthBodyFormat, } from './types/enums';
+export type { AuthConfig, AuthResponseMapping, AuthTokens } from './types/auth';
 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,EACZ,YAAY,EACZ,cAAc,GACf,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAChF,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,25 @@
+import type { AuthConfig, AuthTokens } from '../types/auth';
 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 { WireAuthConfig, WireAuthTokens, 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 authToWire(a: AuthConfig): WireAuthConfig;
 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;
+/** `expiresAtMs` (epoch millis) becomes a `Date`; `null` propagates faithfully. */
+export declare function wireToAuthTokens(w: WireAuthTokens): AuthTokens;
 /**
- * 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,UAAU,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAWpD,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,cAAc,EACd,cAAc,EACd,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,cAAc,EACf,MAAM,mBAAmB,CAAC;AAwB3B,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,CA+B7D;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,cAAc,GAAG,YAAY,CAS9D;AAID,wBAAgB,UAAU,CAAC,CAAC,EAAE,UAAU,GAAG,cAAc,CAqBxD;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;AAED,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,cAAc,GAAG,UAAU,CAO9D;AAoCD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,OAAO,GAAG,KAAK,CAQtD"}

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

@@ -0,0 +1,99 @@
+import type { AuthBodyFormat, AuthStrategy } from './enums';
+/**
+ * Where the SDK reads rotated tokens from the JSON response to a refresh
+ * request. Mirrors the native `AuthResponseMapping` (iOS) / `ResponseMapping`
+ * (Android).
+ *
+ * Each value is a response key. An omitted field falls back to common-name
+ * detection: `access_token`/`accessToken`/`token` for the access token,
+ * `refresh_token`/`refreshToken` for a rotated refresh token, and `expires_in`
+ * (relative seconds) or `expires_at`/`expires` (absolute epoch seconds) for the
+ * expiry. The default (all-omitted) is pure common-name detection.
+ */
+export type AuthResponseMapping = {
+    /** Response key holding the new access token. Omitted uses common-name detection. */
+    accessToken?: string;
+    /** Response key holding a rotated refresh token. Omitted uses common-name detection. */
+    refreshToken?: string;
+    /** Response key holding a relative lifetime in seconds. Omitted uses detection. */
+    expiresIn?: string;
+    /** Response key holding an absolute expiry in epoch seconds. Omitted uses detection. */
+    expiresAt?: string;
+};
+/**
+ * Declarative recipe for native token refresh, set on `SyncConfig.auth`.
+ * Mirrors the native `AuthConfig`.
+ *
+ * When present, the SDK attaches the access token to every upload (per
+ * {@link AuthConfig.strategy}), refreshes it **proactively** before
+ * {@link AuthConfig.expiresAt} and **reactively** on a `401`/`403`, then retries
+ * the upload — all natively, so it works in the background and on a cold launch
+ * with no host involvement. Omit {@link AuthConfig.refreshUrl} to disable
+ * refresh and keep the legacy behaviour (a `401`/`403` pauses sync and surfaces
+ * `SyncFailure 'auth'`).
+ *
+ * **Tokens are a seed, not config.** {@link AuthConfig.accessToken},
+ * {@link AuthConfig.refreshToken} and {@link AuthConfig.expiresAt} are supplied
+ * once; the SDK then owns and rotates the live token set in secure storage
+ * (Keychain / encrypted prefs). Observe rotations via `Beekon.onAuthTokens()` to
+ * mirror the tokens into your own session store.
+ *
+ * Requires the native SDK ≥ 0.0.6; with an older native binary the recipe is
+ * ignored and only static `SyncConfig.headers` apply.
+ */
+export type AuthConfig = {
+    /** Initial access token. A seed: the SDK owns and rotates it after first persist. */
+    accessToken?: string;
+    /** Initial refresh token POSTed to {@link AuthConfig.refreshUrl}. A seed. */
+    refreshToken?: string;
+    /** Absolute expiry of {@link AuthConfig.accessToken}. Omitted disables proactive refresh. */
+    expiresAt?: Date;
+    /** How the access token is attached. Default: `'bearer'`. */
+    strategy?: AuthStrategy;
+    /** Authorization server's refresh endpoint. Omitted disables refresh. */
+    refreshUrl?: string;
+    /**
+     * Form fields POSTed to {@link AuthConfig.refreshUrl}. A value containing
+     * `{refreshToken}` is substituted with the current refresh token. Default: empty.
+     */
+    refreshPayload?: Record<string, string>;
+    /**
+     * Headers sent on the refresh request. A value containing `{accessToken}` is
+     * substituted with the current access token. Default:
+     * `{ Authorization: 'Bearer {accessToken}' }`.
+     */
+    refreshHeaders?: Record<string, string>;
+    /** Encoding of the refresh request body. Default: `'form'`. */
+    refreshBodyFormat?: AuthBodyFormat;
+    /** Where to read rotated tokens from the refresh response. Default: detection. */
+    responseMapping?: AuthResponseMapping;
+    /** Seconds before {@link AuthConfig.expiresAt} at which a proactive refresh fires. Default: `60`. */
+    skewMarginSeconds?: number;
+    /**
+     * Optional monotonic re-seed signal. When greater than the SDK's stored epoch,
+     * a re-supplied seed replaces the rotated token set (e.g. after the user
+     * re-authenticates). Omitted adopts a re-supplied seed only when no token has
+     * been stored yet.
+     */
+    seedEpoch?: number;
+};
+/**
+ * A token set the SDK rotated, delivered via `Beekon.onAuthTokens()`. Mirrors
+ * the native `AuthTokens` (iOS) / `TokenRefresh` (Android).
+ *
+ * Treat these as sensitive: they are delivered in-process only and are never
+ * logged or persisted to plaintext. Use them to mirror the SDK's current
+ * credentials into your own session store. The latest rotation is replayed to
+ * new subscribers (replay-1).
+ */
+export type AuthTokens = {
+    /** The rotated access token now in use. */
+    accessToken: string;
+    /** The current refresh token (rotated if the server returned a new one), or `null`. */
+    refreshToken: string | null;
+    /** Absolute expiry of {@link AuthTokens.accessToken}, or `null` if the response carried none. */
+    expiresAt: Date | null;
+    /** The SDK's monotonic token generation, incremented on each successful refresh. */
+    epoch: number;
+};
+//# sourceMappingURL=auth.d.ts.map