expo-beacon 0.3.1 → 0.3.3

package/build/ExpoBeaconModule.d.ts

@@ -1,2 +1,57 @@
-export default module;
+import { NativeModule } from "expo";
+import { ExpoBeaconModuleEvents, BeaconScanResult, PairedBeacon, NotificationConfig, MonitoringOptions } from "./ExpoBeacon.types";
+declare class ExpoBeaconModule extends NativeModule<ExpoBeaconModuleEvents> {
+    /**
+     * Start a one-shot iBeacon scan. Resolves with discovered beacons after scanDuration ms.
+     *
+     * Pass one or more UUIDs to scan for specific beacons (uses CoreLocation on iOS).
+     * Pass an empty array or omit to perform a wildcard scan that discovers all nearby
+     * iBeacons (uses CoreBluetooth on iOS — foreground only).
+     *
+     * @param uuids Proximity UUIDs to filter by. Empty/omitted = wildcard scan.
+     * @param scanDuration Duration in ms (default 5000)
+     */
+    scanForBeaconsAsync(uuids?: string[], scanDuration?: number): Promise<BeaconScanResult[]>;
+    /**
+     * Register a beacon for persistent region monitoring.
+     */
+    pairBeacon(identifier: string, uuid: string, major: number, minor: number): void;
+    /**
+     * Remove a previously paired beacon.
+     */
+    unpairBeacon(identifier: string): void;
+    /**
+     * Return all currently paired beacons.
+     */
+    getPairedBeacons(): PairedBeacon[];
+    /**
+     * Set persistent notification configuration. Settings are saved and applied to all
+     * subsequent monitoring sessions until explicitly changed.
+     */
+    setNotificationConfig(config: NotificationConfig): void;
+    /**
+     * Start background region monitoring for all paired beacons.
+     * On Android starts a foreground service.
+     * On iOS starts CLLocationManager region monitoring.
+     *
+     * Accepts a plain number (backward-compatible maxDistance shorthand) or a
+     * MonitoringOptions object with maxDistance and/or notification overrides.
+     */
+    startMonitoring(options?: MonitoringOptions | number): Promise<void>;
+    /**
+     * Stop background region monitoring.
+     */
+    stopMonitoring(): Promise<void>;
+    /**
+     * Start a continuous BLE scan. Fires `onBeaconFound` events as beacons are detected.
+     * Call stopContinuousScan() to end the scan.
+     */
+    startContinuousScan(): void;
+    /** Stop the continuous scan started by startContinuousScan(). */
+    stopContinuousScan(): void;
+    /** Request Bluetooth + Location permissions. Returns true if granted. */
+    requestPermissionsAsync(): Promise<boolean>;
+}
+declare const _default: ExpoBeaconModule;
+export default _default;
 //# sourceMappingURL=ExpoBeaconModule.d.ts.map

package/build/ExpoBeaconModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoBeaconModule.d.ts","sourceRoot":"","sources":["../src/ExpoBeaconModule.ts"],"names":[],"mappings":"AA0FA,eAAe,MAAM,CAAC"}
+{"version":3,"file":"ExpoBeaconModule.d.ts","sourceRoot":"","sources":["../src/ExpoBeaconModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAuB,MAAM,MAAM,CAAC;AAEzD,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,OAAO,gBAAiB,SAAQ,YAAY,CAAC,sBAAsB,CAAC;IACzE;;;;;;;;;OASG;IACH,mBAAmB,CACjB,KAAK,CAAC,EAAE,MAAM,EAAE,EAChB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAE9B;;OAEG;IACH,UAAU,CACR,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,IAAI;IAEP;;OAEG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAEtC;;OAEG;IACH,gBAAgB,IAAI,YAAY,EAAE;IAElC;;;OAGG;IACH,qBAAqB,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAEvD;;;;;;;OAOG;IACH,eAAe,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAEpE;;OAEG;IACH,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAE/B;;;OAGG;IACH,mBAAmB,IAAI,IAAI;IAE3B,iEAAiE;IACjE,kBAAkB,IAAI,IAAI;IAE1B,yEAAyE;IACzE,uBAAuB,IAAI,OAAO,CAAC,OAAO,CAAC;CAC5C;;AAED,wBAAmE"}

package/build/ExpoBeaconModule.js

@@ -1,11 +1,3 @@
 import { requireNativeModule } from "expo";
-try {
-    // eslint-disable-next-line import/no-mutable-exports
-    var module = requireNativeModule("ExpoBeacon");
-}
-catch {
-    throw new Error("expo-beacon: native module not found. Make sure you are using a development build " +
-        "(not Expo Go) and have run `npx expo prebuild` followed by a native rebuild.");
-}
-export default module;
+export default requireNativeModule("ExpoBeacon");
 //# sourceMappingURL=ExpoBeaconModule.js.map

package/build/ExpoBeaconModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoBeaconModule.js","sourceRoot":"","sources":["../src/ExpoBeaconModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,mBAAmB,EAAE,MAAM,MAAM,CAAC;AAgFzD,IAAI,CAAC;IACH,qDAAqD;IACrD,IAAI,MAAM,GAAG,mBAAmB,CAAmB,YAAY,CAAC,CAAC;AACnE,CAAC;AAAC,MAAM,CAAC;IACP,MAAM,IAAI,KAAK,CACb,oFAAoF;QAClF,8EAA8E,CACjF,CAAC;AACJ,CAAC;AAED,eAAe,MAAM,CAAC","sourcesContent":["import { NativeModule, requireNativeModule } from \"expo\";\r\n\r\nimport {\r\n  ExpoBeaconModuleEvents,\r\n  BeaconScanResult,\r\n  PairedBeacon,\r\n  NotificationConfig,\r\n  MonitoringOptions,\r\n} from \"./ExpoBeacon.types\";\r\n\r\ndeclare class ExpoBeaconModule extends NativeModule<ExpoBeaconModuleEvents> {\r\n  /**\r\n   * Start a one-shot iBeacon scan. Resolves with discovered beacons after scanDuration ms.\r\n   *\r\n   * Pass one or more UUIDs to scan for specific beacons (uses CoreLocation on iOS).\r\n   * Pass an empty array or omit to perform a wildcard scan that discovers all nearby\r\n   * iBeacons (uses CoreBluetooth on iOS — foreground only).\r\n   *\r\n   * @param uuids Proximity UUIDs to filter by. Empty/omitted = wildcard scan.\r\n   * @param scanDuration Duration in ms (default 5000)\r\n   */\r\n  scanForBeaconsAsync(\r\n    uuids?: string[],\r\n    scanDuration?: number,\r\n  ): Promise<BeaconScanResult[]>;\r\n\r\n  /**\r\n   * Register a beacon for persistent region monitoring.\r\n   */\r\n  pairBeacon(\r\n    identifier: string,\r\n    uuid: string,\r\n    major: number,\r\n    minor: number,\r\n  ): void;\r\n\r\n  /**\r\n   * Remove a previously paired beacon.\r\n   */\r\n  unpairBeacon(identifier: string): void;\r\n\r\n  /**\r\n   * Return all currently paired beacons.\r\n   */\r\n  getPairedBeacons(): PairedBeacon[];\r\n\r\n  /**\r\n   * Set persistent notification configuration. Settings are saved and applied to all\r\n   * subsequent monitoring sessions until explicitly changed.\r\n   */\r\n  setNotificationConfig(config: NotificationConfig): void;\r\n\r\n  /**\r\n   * Start background region monitoring for all paired beacons.\r\n   * On Android starts a foreground service.\r\n   * On iOS starts CLLocationManager region monitoring.\r\n   *\r\n   * Accepts a plain number (backward-compatible maxDistance shorthand) or a\r\n   * MonitoringOptions object with maxDistance and/or notification overrides.\r\n   */\r\n  startMonitoring(options?: MonitoringOptions | number): Promise<void>;\r\n\r\n  /**\r\n   * Stop background region monitoring.\r\n   */\r\n  stopMonitoring(): Promise<void>;\r\n\r\n  /**\r\n   * Start a continuous BLE scan. Fires `onBeaconFound` events as beacons are detected.\r\n   * Call stopContinuousScan() to end the scan.\r\n   */\r\n  startContinuousScan(): void;\r\n\r\n  /** Stop the continuous scan started by startContinuousScan(). */\r\n  stopContinuousScan(): void;\r\n\r\n  /** Request Bluetooth + Location permissions. Returns true if granted. */\r\n  requestPermissionsAsync(): Promise<boolean>;\r\n}\r\n\r\ntry {\r\n  // eslint-disable-next-line import/no-mutable-exports\r\n  var module = requireNativeModule<ExpoBeaconModule>(\"ExpoBeacon\");\r\n} catch {\r\n  throw new Error(\r\n    \"expo-beacon: native module not found. Make sure you are using a development build \" +\r\n      \"(not Expo Go) and have run `npx expo prebuild` followed by a native rebuild.\",\r\n  );\r\n}\r\n\r\nexport default module;\r\n"]}
+{"version":3,"file":"ExpoBeaconModule.js","sourceRoot":"","sources":["../src/ExpoBeaconModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,mBAAmB,EAAE,MAAM,MAAM,CAAC;AAgFzD,eAAe,mBAAmB,CAAmB,YAAY,CAAC,CAAC","sourcesContent":["import { NativeModule, requireNativeModule } from \"expo\";\r\n\r\nimport {\r\n  ExpoBeaconModuleEvents,\r\n  BeaconScanResult,\r\n  PairedBeacon,\r\n  NotificationConfig,\r\n  MonitoringOptions,\r\n} from \"./ExpoBeacon.types\";\r\n\r\ndeclare class ExpoBeaconModule extends NativeModule<ExpoBeaconModuleEvents> {\r\n  /**\r\n   * Start a one-shot iBeacon scan. Resolves with discovered beacons after scanDuration ms.\r\n   *\r\n   * Pass one or more UUIDs to scan for specific beacons (uses CoreLocation on iOS).\r\n   * Pass an empty array or omit to perform a wildcard scan that discovers all nearby\r\n   * iBeacons (uses CoreBluetooth on iOS — foreground only).\r\n   *\r\n   * @param uuids Proximity UUIDs to filter by. Empty/omitted = wildcard scan.\r\n   * @param scanDuration Duration in ms (default 5000)\r\n   */\r\n  scanForBeaconsAsync(\r\n    uuids?: string[],\r\n    scanDuration?: number,\r\n  ): Promise<BeaconScanResult[]>;\r\n\r\n  /**\r\n   * Register a beacon for persistent region monitoring.\r\n   */\r\n  pairBeacon(\r\n    identifier: string,\r\n    uuid: string,\r\n    major: number,\r\n    minor: number,\r\n  ): void;\r\n\r\n  /**\r\n   * Remove a previously paired beacon.\r\n   */\r\n  unpairBeacon(identifier: string): void;\r\n\r\n  /**\r\n   * Return all currently paired beacons.\r\n   */\r\n  getPairedBeacons(): PairedBeacon[];\r\n\r\n  /**\r\n   * Set persistent notification configuration. Settings are saved and applied to all\r\n   * subsequent monitoring sessions until explicitly changed.\r\n   */\r\n  setNotificationConfig(config: NotificationConfig): void;\r\n\r\n  /**\r\n   * Start background region monitoring for all paired beacons.\r\n   * On Android starts a foreground service.\r\n   * On iOS starts CLLocationManager region monitoring.\r\n   *\r\n   * Accepts a plain number (backward-compatible maxDistance shorthand) or a\r\n   * MonitoringOptions object with maxDistance and/or notification overrides.\r\n   */\r\n  startMonitoring(options?: MonitoringOptions | number): Promise<void>;\r\n\r\n  /**\r\n   * Stop background region monitoring.\r\n   */\r\n  stopMonitoring(): Promise<void>;\r\n\r\n  /**\r\n   * Start a continuous BLE scan. Fires `onBeaconFound` events as beacons are detected.\r\n   * Call stopContinuousScan() to end the scan.\r\n   */\r\n  startContinuousScan(): void;\r\n\r\n  /** Stop the continuous scan started by startContinuousScan(). */\r\n  stopContinuousScan(): void;\r\n\r\n  /** Request Bluetooth + Location permissions. Returns true if granted. */\r\n  requestPermissionsAsync(): Promise<boolean>;\r\n}\r\n\r\nexport default requireNativeModule<ExpoBeaconModule>(\"ExpoBeacon\");\r\n"]}

package/ios/ExpoBeaconModule.swift

@@ -513,8 +513,11 @@ public class ExpoBeaconModule: Module {
 
     fileprivate func handleDidChangeAuthorization(_ status: CLAuthorizationStatus) {
         let granted = (status == .authorizedAlways || status == .authorizedWhenInUse)
-        permissionCompletion?(granted)
+        // Nil out BEFORE calling so the closure can set a new permissionCompletion
+        // (e.g. the notDetermined → whenInUse → always two-step upgrade flow).
+        let completion = permissionCompletion
         permissionCompletion = nil
+        completion?(granted)
     }
 
     fileprivate func handleDidRange(_ beacons: [CLBeacon], satisfying constraint: CLBeaconIdentityConstraint) {
@@ -713,8 +716,8 @@ private class LocationDelegate: NSObject, CLLocationManagerDelegate {
         self.module = module
     }
 
-    func locationManager(_ manager: CLLocationManager, didChangeAuthorization status: CLAuthorizationStatus) {
-        module?.handleDidChangeAuthorization(status)
+    func locationManagerDidChangeAuthorization(_ manager: CLLocationManager) {
+        module?.handleDidChangeAuthorization(manager.authorizationStatus)
     }
 
     func locationManager(_ manager: CLLocationManager, didRange beacons: [CLBeacon], satisfying constraint: CLBeaconIdentityConstraint) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-beacon",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "Expo module for scanning, pairing, and monitoring iBeacons on Android and iOS",
   "main": "build/index.js",
   "types": "build/index.d.ts",

package/src/ExpoBeaconModule.ts

@@ -78,14 +78,4 @@ declare class ExpoBeaconModule extends NativeModule<ExpoBeaconModuleEvents> {
   requestPermissionsAsync(): Promise<boolean>;
 }
 
-try {
-  // eslint-disable-next-line import/no-mutable-exports
-  var module = requireNativeModule<ExpoBeaconModule>("ExpoBeacon");
-} catch {
-  throw new Error(
-    "expo-beacon: native module not found. Make sure you are using a development build " +
-      "(not Expo Go) and have run `npx expo prebuild` followed by a native rebuild.",
-  );
-}
-
-export default module;
+export default requireNativeModule<ExpoBeaconModule>("ExpoBeacon");