@doorstepai/dropoff-sdk 2.0.8 → 2.0.9

package/lib/module/DoorstepAI.js

@@ -1,10 +1,26 @@
 "use strict";
 
-import { NativeModules, Platform } from 'react-native';
+import { NativeModules, NativeEventEmitter, Platform } from 'react-native';
 const {
   DoorstepAI
 } = NativeModules;
 
+// Bridges the native geofence-session event stream (iOS RCTEventEmitter /
+// Android DeviceEventManagerModule) to JS. See `addGeofenceSessionListener`.
+const GEOFENCE_SESSION_EVENT = 'DoorstepGeofenceSessionEvent';
+const doorstepEventEmitter = DoorstepAI ? new NativeEventEmitter(DoorstepAI) : undefined;
+
+/**
+ * A single stop the SDK should geofence in `startRouteGeofencing`. On geofence
+ * ENTER the SDK auto-starts a delivery session for `deliveryId`; on EXIT it stops
+ * it (only if `markDropoff` was called for that id — otherwise the per-session
+ * timeout backstop applies).
+ */
+
+/** Route-wide options for `startRouteGeofencing`. */
+
+/** Emitted whenever route geofencing auto-starts or auto-stops a session. */
+
 /**
  * Per-delivery options shared across both platforms. Fields not supported on a
  * given platform are silently ignored.
@@ -161,9 +177,14 @@ class DoorstepAIModule {
       throw error;
     }
   }
-  static async newEvent(eventName, deliveryId) {
+
+  /**
+   * Record a custom event on a delivery. `timestamp` is optional epoch SECONDS —
+   * when provided the event is recorded at that time instead of "now".
+   */
+  static async newEvent(eventName, deliveryId, timestamp) {
     try {
-      const result = await DoorstepAI.newEvent(eventName, deliveryId);
+      const result = await DoorstepAI.newEvent(eventName, deliveryId, timestamp ?? null);
       console.log('DOORSTEPAI - Event sent successfully:', result);
       return result;
     } catch (error) {
@@ -172,6 +193,68 @@ class DoorstepAIModule {
     }
   }
 
+  // ---- Route geofencing (in-SDK) ----
+
+  /**
+   * Begin in-SDK route geofencing. The SDK fences each stop and auto-starts a
+   * delivery session on geofence ENTER / stops it on EXIT (EXIT is gated on
+   * `markDropoff`). Requires location permission; background operation needs
+   * "Allow all the time" (Android) / Always authorization (iOS). Subscribe to
+   * start/stop events via `addGeofenceSessionListener`.
+   */
+  static async startRouteGeofencing(stops, options) {
+    try {
+      await DoorstepAI.startRouteGeofencing(stops, options ?? null);
+      console.log('DOORSTEPAI - Route geofencing started for', stops.length, 'stop(s)');
+    } catch (error) {
+      console.error('DOORSTEPAI - Failed to start route geofencing:', error);
+      throw error;
+    }
+  }
+
+  /** Stop route geofencing and clear all monitored stops. */
+  static async stopRouteGeofencing() {
+    try {
+      await DoorstepAI.stopRouteGeofencing();
+    } catch (error) {
+      console.error('DOORSTEPAI - Failed to stop route geofencing:', error);
+      throw error;
+    }
+  }
+
+  /**
+   * Re-arm route geofencing after a process relaunch if a route was active.
+   * Safe no-op when no route is persisted.
+   */
+  static async resumeRouteGeofencingIfNeeded() {
+    try {
+      await DoorstepAI.resumeRouteGeofencingIfNeeded();
+    } catch (error) {
+      console.error('DOORSTEPAI - Failed to resume route geofencing:', error);
+      throw error;
+    }
+  }
+
+  /** The stops currently registered for route geofencing (empty if none). */
+  static async getMonitoredStops() {
+    try {
+      const stops = await DoorstepAI.getMonitoredStops();
+      return stops ?? [];
+    } catch (error) {
+      console.error('DOORSTEPAI - Failed to get monitored stops:', error);
+      return [];
+    }
+  }
+
+  /**
+   * Subscribe to geofence-session events (auto start/stop of a delivery on
+   * geofence transitions). Returns a subscription — call `.remove()` to
+   * unsubscribe. Returns `undefined` if the native module is unavailable.
+   */
+  static addGeofenceSessionListener(listener) {
+    return doorstepEventEmitter?.addListener(GEOFENCE_SESSION_EVENT, listener);
+  }
+
   // ---- Dev-mode helpers (Android exposes a richer surface than iOS) ----
 
   static async enableDevMode(apiKey) {

package/lib/module/DoorstepAI.js.map

@@ -1 +1 @@
-{"version":3,"names":["NativeModules","Platform","DoorstepAI","SDK_LOG_LEVEL_RAW","debug","info","warning","error","critical","DEFAULT_TIMEOUT_SECONDS","DoorstepAIModule","isInitialized","init","notificationTitle","notificationText","OS","console","log","setApiKey","apiKey","requestAllPermissions","requestAlwaysLocation","configureRemoteLogging","options","minLevelRaw","minLevel","enabled","flushIntervalSeconds","batchSize","maxQueueSize","startDeliveryByPlaceID","placeID","deliveryId","timeoutSeconds","timeout","autoStop","autoStopAfterDropoffSeconds","customerId","driverId","result","manualForeground","startDeliveryByPlusCode","plusCode","startDeliveryByAddress","address","coordinates","startDeliveryByAddressString","startDeliveryByLatLng","latitude","longitude","subUnit","markDropoff","dropoffType","stopDelivery","newEvent","eventName","enableDevMode","Boolean","validateDevModeAccess","disableDevMode"],"sourceRoot":"../../src","sources":["DoorstepAI.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["NativeModules","NativeEventEmitter","Platform","DoorstepAI","GEOFENCE_SESSION_EVENT","doorstepEventEmitter","undefined","SDK_LOG_LEVEL_RAW","debug","info","warning","error","critical","DEFAULT_TIMEOUT_SECONDS","DoorstepAIModule","isInitialized","init","notificationTitle","notificationText","OS","console","log","setApiKey","apiKey","requestAllPermissions","requestAlwaysLocation","configureRemoteLogging","options","minLevelRaw","minLevel","enabled","flushIntervalSeconds","batchSize","maxQueueSize","startDeliveryByPlaceID","placeID","deliveryId","timeoutSeconds","timeout","autoStop","autoStopAfterDropoffSeconds","customerId","driverId","result","manualForeground","startDeliveryByPlusCode","plusCode","startDeliveryByAddress","address","coordinates","startDeliveryByAddressString","startDeliveryByLatLng","latitude","longitude","subUnit","markDropoff","dropoffType","stopDelivery","newEvent","eventName","timestamp","startRouteGeofencing","stops","length","stopRouteGeofencing","resumeRouteGeofencingIfNeeded","getMonitoredStops","addGeofenceSessionListener","listener","addListener","enableDevMode","Boolean","validateDevModeAccess","disableDevMode"],"sourceRoot":"../../src","sources":["DoorstepAI.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["RootDoorstepAI","DoorstepAI"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,SAASA,cAAc,QAAQ,qBAAkB;AACjD,SAASC,UAAU,QAAQ,iBAAc;AAQzC,SAASA,UAAU,EAAED,cAAc","ignoreList":[]}
+{"version":3,"names":["RootDoorstepAI","DoorstepAI"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,SAASA,cAAc,QAAQ,qBAAkB;AACjD,SAASC,UAAU,QAAQ,iBAAc;AAYzC,SAASA,UAAU,EAAED,cAAc","ignoreList":[]}

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

@@ -1,3 +1,4 @@
+import type { EmitterSubscription } from 'react-native';
 type AddressType = {
     streetNumber: string;
     route: string;
@@ -10,6 +11,41 @@ type LatLngObject = {
     lat: number;
     lng: number;
 };
+/**
+ * A single stop the SDK should geofence in `startRouteGeofencing`. On geofence
+ * ENTER the SDK auto-starts a delivery session for `deliveryId`; on EXIT it stops
+ * it (only if `markDropoff` was called for that id — otherwise the per-session
+ * timeout backstop applies).
+ */
+type DeliveryStop = {
+    deliveryId: string;
+    address: string;
+    latitude: number;
+    longitude: number;
+    /** Fence radius in meters. Falls back to `RouteGeofenceOptions.defaultRadiusMeters` (250 m). */
+    radiusMeters?: number;
+    customerId?: string;
+    driverId?: string;
+};
+/** Route-wide options for `startRouteGeofencing`. */
+type RouteGeofenceOptions = {
+    /** Radius (m) for stops that don't set their own `radiusMeters`. Default 250. */
+    defaultRadiusMeters?: number;
+    /** Per-session safety timeout (s) forwarded to the auto-started delivery. */
+    timeoutSeconds?: number;
+    /** Auto-stop countdown (s) applied when `stopDelivery` is called for a stop. */
+    autoStopAfterDropoffSeconds?: number;
+    /** Android only. Host owns the foreground service; SDK won't promote its own. Ignored on iOS. */
+    manualForeground?: boolean;
+};
+type GeofenceSessionEventType = 'STARTED' | 'STOPPED';
+/** Emitted whenever route geofencing auto-starts or auto-stops a session. */
+type GeofenceSessionEvent = {
+    deliveryId: string;
+    type: GeofenceSessionEventType;
+    /** Short trigger tag, e.g. "geofence", "distance", "route_cleared". */
+    reason: string;
+};
 /**
  * Per-delivery options shared across both platforms. Fields not supported on a
  * given platform are silently ignored.
@@ -81,7 +117,34 @@ declare class DoorstepAIModule {
     static startDeliveryByLatLng(latitude: number, longitude: number, subUnit: string, deliveryId: string, timeoutSeconds?: number, options?: StartDeliveryOptions): Promise<any>;
     static markDropoff(deliveryId: string, dropoffType: 'pod' | 'non_pod'): Promise<void>;
     static stopDelivery(deliveryId: string): Promise<void>;
-    static newEvent(eventName: string, deliveryId: string): Promise<any>;
+    /**
+     * Record a custom event on a delivery. `timestamp` is optional epoch SECONDS —
+     * when provided the event is recorded at that time instead of "now".
+     */
+    static newEvent(eventName: string, deliveryId: string, timestamp?: number): Promise<any>;
+    /**
+     * Begin in-SDK route geofencing. The SDK fences each stop and auto-starts a
+     * delivery session on geofence ENTER / stops it on EXIT (EXIT is gated on
+     * `markDropoff`). Requires location permission; background operation needs
+     * "Allow all the time" (Android) / Always authorization (iOS). Subscribe to
+     * start/stop events via `addGeofenceSessionListener`.
+     */
+    static startRouteGeofencing(stops: DeliveryStop[], options?: RouteGeofenceOptions): Promise<void>;
+    /** Stop route geofencing and clear all monitored stops. */
+    static stopRouteGeofencing(): Promise<void>;
+    /**
+     * Re-arm route geofencing after a process relaunch if a route was active.
+     * Safe no-op when no route is persisted.
+     */
+    static resumeRouteGeofencingIfNeeded(): Promise<void>;
+    /** The stops currently registered for route geofencing (empty if none). */
+    static getMonitoredStops(): Promise<DeliveryStop[]>;
+    /**
+     * Subscribe to geofence-session events (auto start/stop of a delivery on
+     * geofence transitions). Returns a subscription — call `.remove()` to
+     * unsubscribe. Returns `undefined` if the native module is unavailable.
+     */
+    static addGeofenceSessionListener(listener: (event: GeofenceSessionEvent) => void): EmitterSubscription | undefined;
     static enableDevMode(apiKey: string): Promise<boolean>;
     /** Android only. Returns false on iOS. */
     static validateDevModeAccess(): Promise<boolean>;
@@ -89,5 +152,5 @@ declare class DoorstepAIModule {
     static disableDevMode(): Promise<boolean>;
 }
 export { DoorstepAIModule as DoorstepAI };
-export type { AddressType, LatLngObject, StartDeliveryOptions, SDKLogLevel };
+export type { AddressType, LatLngObject, StartDeliveryOptions, SDKLogLevel, DeliveryStop, RouteGeofenceOptions, GeofenceSessionEvent, GeofenceSessionEventType, };
 //# sourceMappingURL=DoorstepAI.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"DoorstepAI.d.ts","sourceRoot":"","sources":["../../../src/DoorstepAI.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"DoorstepAI.d.ts","sourceRoot":"","sources":["../../../src/DoorstepAI.tsx"],"names":[],"mappings":"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"}

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

@@ -2,5 +2,5 @@ export declare function RootDoorstepAI(props: {
     apiKey: string;
     notificationTitle?: string;
     notificationText?: string;
-}): import("react/jsx-runtime").JSX.Element;
+}): import("react").JSX.Element;
 //# sourceMappingURL=RootDoorstepAI.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"RootDoorstepAI.d.ts","sourceRoot":"","sources":["../../../src/RootDoorstepAI.tsx"],"names":[],"mappings":"AAcA,wBAAgB,cAAc,CAAC,KAAK,EAAE;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,2CAoDA"}
+{"version":3,"file":"RootDoorstepAI.d.ts","sourceRoot":"","sources":["../../../src/RootDoorstepAI.tsx"],"names":[],"mappings":"AAcA,wBAAgB,cAAc,CAAC,KAAK,EAAE;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,+BAoDA"}

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

@@ -1,5 +1,5 @@
 import { RootDoorstepAI } from './RootDoorstepAI';
 import { DoorstepAI } from './DoorstepAI';
-export type { AddressType, LatLngObject, StartDeliveryOptions, SDKLogLevel, } from './DoorstepAI';
+export type { AddressType, LatLngObject, StartDeliveryOptions, SDKLogLevel, DeliveryStop, RouteGeofenceOptions, GeofenceSessionEvent, GeofenceSessionEventType, } from './DoorstepAI';
 export { DoorstepAI, RootDoorstepAI };
 //# 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,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EACV,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,WAAW,GACZ,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EACV,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doorstepai/dropoff-sdk",
-  "version": "2.0.8",
+  "version": "2.0.9",
   "description": "doorstep.ai dropoff sdk for React Native",
   "source": "./src/index.tsx",
   "main": "./lib/module/index.js",

package/src/DoorstepAI.tsx

@@ -1,6 +1,14 @@
-import { NativeModules, Platform } from 'react-native';
+import { NativeModules, NativeEventEmitter, Platform } from 'react-native';
+import type { EmitterSubscription } from 'react-native';
 const { DoorstepAI } = NativeModules;
 
+// Bridges the native geofence-session event stream (iOS RCTEventEmitter /
+// Android DeviceEventManagerModule) to JS. See `addGeofenceSessionListener`.
+const GEOFENCE_SESSION_EVENT = 'DoorstepGeofenceSessionEvent';
+const doorstepEventEmitter = DoorstepAI
+  ? new NativeEventEmitter(DoorstepAI)
+  : undefined;
+
 type AddressType = {
   streetNumber: string;
   route: string;
@@ -15,6 +23,45 @@ type LatLngObject = {
   lng: number;
 };
 
+/**
+ * A single stop the SDK should geofence in `startRouteGeofencing`. On geofence
+ * ENTER the SDK auto-starts a delivery session for `deliveryId`; on EXIT it stops
+ * it (only if `markDropoff` was called for that id — otherwise the per-session
+ * timeout backstop applies).
+ */
+type DeliveryStop = {
+  deliveryId: string;
+  address: string;
+  latitude: number;
+  longitude: number;
+  /** Fence radius in meters. Falls back to `RouteGeofenceOptions.defaultRadiusMeters` (250 m). */
+  radiusMeters?: number;
+  customerId?: string;
+  driverId?: string;
+};
+
+/** Route-wide options for `startRouteGeofencing`. */
+type RouteGeofenceOptions = {
+  /** Radius (m) for stops that don't set their own `radiusMeters`. Default 250. */
+  defaultRadiusMeters?: number;
+  /** Per-session safety timeout (s) forwarded to the auto-started delivery. */
+  timeoutSeconds?: number;
+  /** Auto-stop countdown (s) applied when `stopDelivery` is called for a stop. */
+  autoStopAfterDropoffSeconds?: number;
+  /** Android only. Host owns the foreground service; SDK won't promote its own. Ignored on iOS. */
+  manualForeground?: boolean;
+};
+
+type GeofenceSessionEventType = 'STARTED' | 'STOPPED';
+
+/** Emitted whenever route geofencing auto-starts or auto-stops a session. */
+type GeofenceSessionEvent = {
+  deliveryId: string;
+  type: GeofenceSessionEventType;
+  /** Short trigger tag, e.g. "geofence", "distance", "route_cleared". */
+  reason: string;
+};
+
 /**
  * Per-delivery options shared across both platforms. Fields not supported on a
  * given platform are silently ignored.
@@ -397,9 +444,21 @@ class DoorstepAIModule {
     }
   }
 
-  static async newEvent(eventName: string, deliveryId: string) {
+  /**
+   * Record a custom event on a delivery. `timestamp` is optional epoch SECONDS —
+   * when provided the event is recorded at that time instead of "now".
+   */
+  static async newEvent(
+    eventName: string,
+    deliveryId: string,
+    timestamp?: number
+  ) {
     try {
-      const result = await DoorstepAI.newEvent(eventName, deliveryId);
+      const result = await DoorstepAI.newEvent(
+        eventName,
+        deliveryId,
+        timestamp ?? null
+      );
       console.log('DOORSTEPAI - Event sent successfully:', result);
       return result;
     } catch (error: any) {
@@ -413,6 +472,77 @@ class DoorstepAIModule {
     }
   }
 
+  // ---- Route geofencing (in-SDK) ----
+
+  /**
+   * Begin in-SDK route geofencing. The SDK fences each stop and auto-starts a
+   * delivery session on geofence ENTER / stops it on EXIT (EXIT is gated on
+   * `markDropoff`). Requires location permission; background operation needs
+   * "Allow all the time" (Android) / Always authorization (iOS). Subscribe to
+   * start/stop events via `addGeofenceSessionListener`.
+   */
+  static async startRouteGeofencing(
+    stops: DeliveryStop[],
+    options?: RouteGeofenceOptions
+  ): Promise<void> {
+    try {
+      await DoorstepAI.startRouteGeofencing(stops, options ?? null);
+      console.log(
+        'DOORSTEPAI - Route geofencing started for',
+        stops.length,
+        'stop(s)'
+      );
+    } catch (error: any) {
+      console.error('DOORSTEPAI - Failed to start route geofencing:', error);
+      throw error;
+    }
+  }
+
+  /** Stop route geofencing and clear all monitored stops. */
+  static async stopRouteGeofencing(): Promise<void> {
+    try {
+      await DoorstepAI.stopRouteGeofencing();
+    } catch (error: any) {
+      console.error('DOORSTEPAI - Failed to stop route geofencing:', error);
+      throw error;
+    }
+  }
+
+  /**
+   * Re-arm route geofencing after a process relaunch if a route was active.
+   * Safe no-op when no route is persisted.
+   */
+  static async resumeRouteGeofencingIfNeeded(): Promise<void> {
+    try {
+      await DoorstepAI.resumeRouteGeofencingIfNeeded();
+    } catch (error: any) {
+      console.error('DOORSTEPAI - Failed to resume route geofencing:', error);
+      throw error;
+    }
+  }
+
+  /** The stops currently registered for route geofencing (empty if none). */
+  static async getMonitoredStops(): Promise<DeliveryStop[]> {
+    try {
+      const stops = await DoorstepAI.getMonitoredStops();
+      return (stops as DeliveryStop[]) ?? [];
+    } catch (error: any) {
+      console.error('DOORSTEPAI - Failed to get monitored stops:', error);
+      return [];
+    }
+  }
+
+  /**
+   * Subscribe to geofence-session events (auto start/stop of a delivery on
+   * geofence transitions). Returns a subscription — call `.remove()` to
+   * unsubscribe. Returns `undefined` if the native module is unavailable.
+   */
+  static addGeofenceSessionListener(
+    listener: (event: GeofenceSessionEvent) => void
+  ): EmitterSubscription | undefined {
+    return doorstepEventEmitter?.addListener(GEOFENCE_SESSION_EVENT, listener);
+  }
+
   // ---- Dev-mode helpers (Android exposes a richer surface than iOS) ----
 
   static async enableDevMode(apiKey: string): Promise<boolean> {
@@ -437,4 +567,13 @@ class DoorstepAIModule {
 }
 
 export { DoorstepAIModule as DoorstepAI };
-export type { AddressType, LatLngObject, StartDeliveryOptions, SDKLogLevel };
+export type {
+  AddressType,
+  LatLngObject,
+  StartDeliveryOptions,
+  SDKLogLevel,
+  DeliveryStop,
+  RouteGeofenceOptions,
+  GeofenceSessionEvent,
+  GeofenceSessionEventType,
+};

package/src/index.tsx

@@ -5,6 +5,10 @@ export type {
   LatLngObject,
   StartDeliveryOptions,
   SDKLogLevel,
+  DeliveryStop,
+  RouteGeofenceOptions,
+  GeofenceSessionEvent,
+  GeofenceSessionEventType,
 } from './DoorstepAI';
 
 export { DoorstepAI, RootDoorstepAI };