@doorstepai/dropoff-sdk 1.0.8 → 1.0.10

package/README.md

@@ -1,4 +1,3 @@
-
 # DoorstepAI Dropoff SDK for React Native
 
 The `@doorstepai/dropoff-sdk` provides a set of tools to integrate delivery tracking into your React Native application. This SDK enables seamless coordination between your delivery interface and DoorstepAI's backend systems.
@@ -52,22 +51,35 @@ import { DoorstepAI } from "@doorstepai/dropoff-sdk"
 
 // Start a delivery using a Google Place ID
 <Button title="Start Delivery" onPress={() => {
-  DoorstepAI.startDeliveryByPlaceID("213");
+  DoorstepAI.startDeliveryByPlaceID('destination_place_id', 'delivery_id_1');
+}} />
+
+// Start a delivery using an address
+<Button title="Start Delivery by Address" onPress={() => {
+  const address = {
+    streetNumber: '123',
+    route: 'Main St',
+    subPremise: 'Apt 4B',
+    locality: 'New York',
+    administrativeAreaLevel1: 'NY',
+    postalCode: '10001'
+  };
+  DoorstepAI.startDeliveryByAddress(address, 'delivery_id_1');
 }} />
 
 // Send "taking_pod" event
 <Button title="Taking POD" onPress={() => {
-  DoorstepAI.newEvent("taking_pod");
+  DoorstepAI.newEvent('taking_pod', 'delivery_id_1');
 }} />
 
 // Send "pod_captured" event
 <Button title="POD Captured" onPress={() => {
-  DoorstepAI.newEvent("pod_captured");
+  DoorstepAI.newEvent('pod_captured', 'delivery_id_1');
 }} />
 
 // End the delivery
 <Button title="End Delivery" onPress={() => {
-  DoorstepAI.stopDelivery();
+  DoorstepAI.stopDelivery('delivery_id_1');
 }} />
 ```
 
@@ -89,43 +101,44 @@ Sets the API key to authenticate SDK usage.
 
 ---
 
-### `DoorstepAI.startDeliveryByPlaceID(placeID: string): Promise<void>`
+### `DoorstepAI.startDeliveryByPlaceID(placeID: string, deliveryId: string): Promise<string>`
 
-Starts a delivery using a Google Place ID.
+Starts a delivery using a Google Place ID. Returns a session ID on success.
 
 ---
 
-### `DoorstepAI.startDeliveryByPlusCode(plusCode: string): Promise<void>`
+### `DoorstepAI.startDeliveryByPlusCode(plusCode: string, deliveryId: string): Promise<string>`
 
-Starts a delivery using a Google Plus Code.
+Starts a delivery using a Google Plus Code. Returns a session ID on success.
 
 ---
 
-### `DoorstepAI.startDeliveryByAddress(address: AddressType): Promise<void>`
+### `DoorstepAI.startDeliveryByAddress(address: AddressType, deliveryId: string): Promise<string>`
 
-Starts a delivery using a structured address object.
+Starts a delivery using a structured address object. Returns a session ID on success.
 
 ```ts
 type AddressType = {
   streetNumber: string;
   route: string;
-  locality: string;
-  administrativeAreaLevel1: string;
+  subPremise: string;      // Apartment, suite, unit, etc.
+  locality: string;        // City
+  administrativeAreaLevel1: string;  // State/Province
   postalCode: string;
 }
 ```
 
 ---
 
-### `DoorstepAI.stopDelivery(): Promise<void>`
+### `DoorstepAI.stopDelivery(deliveryId: string): Promise<void>`
 
-Stops the current delivery.
+Stops the specified delivery.
 
 ---
 
-### `DoorstepAI.newEvent(eventName: string): Promise<void>`
+### `DoorstepAI.newEvent(eventName: string, deliveryId: string): Promise<void>`
 
-Sends a delivery-related event. Supported events include:
+Sends a delivery-related event for the specified delivery. Supported events include:
 - `"taking_pod"`
 - `"pod_captured"`
 
@@ -138,6 +151,8 @@ More can be added per vender/customer relationship.
 - Always wrap `DoorstepAI` API calls in `try/catch` or use `.catch()` for better error handling when applicable.
 - Use the `RootDoorstepAI` component only **once** at the **root** of your app.
 - Ensure your API key is securely stored and never hardcoded in production.
+- Always provide a unique `deliveryId` for each delivery session.
+- Keep track of the `deliveryId` throughout the delivery lifecycle as it's required for all operations.
 
 ---
 
@@ -148,8 +163,7 @@ If something isn't working as expected:
 - Check console logs for `DoorstepAI initialized` or error messages.
 - Verify that the API key is valid and accepted by the SDK.
 - Ensure your permissions (e.g., location) are correctly set up on the device.
-
----
+- Verify that you're using the correct `deliveryId` for each operation.
 
 ---
 

package/android/build.gradle

@@ -86,7 +86,7 @@ def kotlin_version = getExtOrDefault("kotlinVersion")
 dependencies {
   implementation "com.facebook.react:react-android"
   implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
-  implementation("ai.doorstep.com:doorstepai-dropoff-sdk:1.0.1")
+  implementation("ai.doorstep.com:doorstepai-dropoff-sdk:1.0.3")
   api "org.jetbrains.kotlinx:kotlinx-serialization-json:1.5.1"
 }
 

package/android/src/main/java/com/doorstepai/dropoffsdk/DoorstepAIModule.kt

@@ -18,13 +18,13 @@ class DoorstepAIModule(private val reactContext: ReactApplicationContext) :
   }
 
   @ReactMethod
-  fun init(promise: Promise) {
+  fun init(notificationTitle: String?, notificationText: String?, promise: Promise) {
     try {
-      DoorstepAI.init(reactContext) { result ->
+      DoorstepAI.init(reactContext, notificationTitle, notificationText) { result ->
         result.onSuccess {
           promise.resolve(true)
         }.onFailure { error ->
-          promise.reject("INIT_ERROR", error.message ?: "Promise Rejection: Failed to initialize DoorstepAI")
+          promise.reject("INIT_ERROR", error.message ?: "Failed to initialize DoorstepAI")
         }
       }
     } catch (e: Exception) {
@@ -100,13 +100,8 @@ class DoorstepAIModule(private val reactContext: ReactApplicationContext) :
   @ReactMethod
   fun newEvent(eventName: String, deliveryId: String, promise: Promise) {
     try {
-      DoorstepAI.newEvent(eventName, deliveryId) { result ->
-        result.onSuccess { eventResponse ->
-          promise.resolve(eventResponse)
-        }.onFailure { error ->
-          promise.reject("EVENT_CREATION_ERROR", error.message ?: "Promise Rejection: Failed to save event")
-        }
-      }
+      DoorstepAI.newEvent(eventName, deliveryId) { /* Callback might not be invoked or provide useful data */ }
+      promise.resolve("Event $eventName triggered for $deliveryId")
     } catch (e: Exception) {
       promise.reject("EVENT_CREATION_ERROR", e.message ?: "Failed to save event")
     }
@@ -127,11 +122,6 @@ class DoorstepAIModule(private val reactContext: ReactApplicationContext) :
     DoorstepAI.setAPIKey(key)
   }
 
-  @ReactMethod
-  fun setDevMode(devModeEnabled: Boolean) {
-    DoorstepAI.devMode = devModeEnabled
-  }
-
   companion object {
     const val NAME = "DoorstepAI"
   }

package/ios/DoorstepDropoffSDK.xcframework/Info.plist

@@ -10,18 +10,15 @@
 			<key>DebugSymbolsPath</key>
 			<string>dSYMs</string>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64_x86_64-simulator</string>
+			<string>ios-arm64</string>
 			<key>LibraryPath</key>
 			<string>DoorstepDropoffSDK.framework</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
-				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
 			<string>ios</string>
-			<key>SupportedPlatformVariant</key>
-			<string>simulator</string>
 		</dict>
 		<dict>
 			<key>BinaryPath</key>
@@ -29,15 +26,18 @@
 			<key>DebugSymbolsPath</key>
 			<string>dSYMs</string>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64</string>
+			<string>ios-arm64_x86_64-simulator</string>
 			<key>LibraryPath</key>
 			<string>DoorstepDropoffSDK.framework</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
+				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
 			<string>ios</string>
+			<key>SupportedPlatformVariant</key>
+			<string>simulator</string>
 		</dict>
 	</array>
 	<key>CFBundlePackageType</key>

package/ios/DoorstepDropoffSDK.xcframework/ios-arm64/DoorstepDropoffSDK.framework/Modules/DoorstepDropoffSDK.swiftmodule/arm64-apple-ios.abi.json

@@ -1879,93 +1879,100 @@
       "value": "\"DoorstepDropoffSDK.LocationManager\""
     },
     {
-      "filePath": "\/Users\/sheelpatel\/Documents\/doorstepai\/doorstepai-track\/iOS\/DoorstepDropoffSDK\/DoorstepDropoffSDK\/src\/c.swift",
+      "filePath": "\/Users\/sheelpatel\/Documents\/doorstepai\/doorstepai-track\/iOS\/DoorstepDropoffSDK\/DoorstepDropoffSDK\/src\/Network.swift",
       "kind": "StringLiteral",
-      "offset": 2177,
+      "offset": 2175,
       "length": 21,
       "value": "\"NetworkMonitorQueue\""
     },
     {
-      "filePath": "\/Users\/sheelpatel\/Documents\/doorstepai\/doorstepai-track\/iOS\/DoorstepDropoffSDK\/DoorstepDropoffSDK\/src\/c.swift",
+      "filePath": "\/Users\/sheelpatel\/Documents\/doorstepai\/doorstepai-track\/iOS\/DoorstepDropoffSDK\/DoorstepDropoffSDK\/src\/Network.swift",
       "kind": "BooleanLiteral",
-      "offset": 2230,
+      "offset": 2228,
       "length": 4,
       "value": "true"
     },
     {
-      "filePath": "\/Users\/sheelpatel\/Documents\/doorstepai\/doorstepai-track\/iOS\/DoorstepDropoffSDK\/DoorstepDropoffSDK\/src\/c.swift",
+      "filePath": "\/Users\/sheelpatel\/Documents\/doorstepai\/doorstepai-track\/iOS\/DoorstepDropoffSDK\/DoorstepDropoffSDK\/src\/Network.swift",
       "kind": "IntegerLiteral",
-      "offset": 2275,
+      "offset": 2273,
       "length": 1,
       "value": "5"
     },
     {
-      "filePath": "\/Users\/sheelpatel\/Documents\/doorstepai\/doorstepai-track\/iOS\/DoorstepDropoffSDK\/DoorstepDropoffSDK\/src\/c.swift",
+      "filePath": "\/Users\/sheelpatel\/Documents\/doorstepai\/doorstepai-track\/iOS\/DoorstepDropoffSDK\/DoorstepDropoffSDK\/src\/Network.swift",
       "kind": "IntegerLiteral",
-      "offset": 2320,
+      "offset": 2318,
       "length": 2,
       "value": "20"
     },
     {
-      "filePath": "\/Users\/sheelpatel\/Documents\/doorstepai\/doorstepai-track\/iOS\/DoorstepDropoffSDK\/DoorstepDropoffSDK\/src\/c.swift",
+      "filePath": "\/Users\/sheelpatel\/Documents\/doorstepai\/doorstepai-track\/iOS\/DoorstepDropoffSDK\/DoorstepDropoffSDK\/src\/Network.swift",
       "kind": "Array",
-      "offset": 2410,
+      "offset": 2408,
       "length": 2,
       "value": "[]"
     },
     {
-      "filePath": "\/Users\/sheelpatel\/Documents\/doorstepai\/doorstepai-track\/iOS\/DoorstepDropoffSDK\/DoorstepDropoffSDK\/src\/c.swift",
+      "filePath": "\/Users\/sheelpatel\/Documents\/doorstepai\/doorstepai-track\/iOS\/DoorstepDropoffSDK\/DoorstepDropoffSDK\/src\/Network.swift",
       "kind": "StringLiteral",
-      "offset": 2465,
+      "offset": 2463,
       "length": 24,
       "value": "\"RequestQueueProcessing\""
     },
     {
-      "filePath": "\/Users\/sheelpatel\/Documents\/doorstepai\/doorstepai-track\/iOS\/DoorstepDropoffSDK\/DoorstepDropoffSDK\/src\/c.swift",
+      "filePath": "\/Users\/sheelpatel\/Documents\/doorstepai\/doorstepai-track\/iOS\/DoorstepDropoffSDK\/DoorstepDropoffSDK\/src\/Network.swift",
       "kind": "StringLiteral",
-      "offset": 2543,
+      "offset": 2541,
       "length": 24,
       "value": "\"pendingNetworkRequests\""
     },
     {
-      "filePath": "\/Users\/sheelpatel\/Documents\/doorstepai\/doorstepai-track\/iOS\/DoorstepDropoffSDK\/DoorstepDropoffSDK\/src\/c.swift",
+      "filePath": "\/Users\/sheelpatel\/Documents\/doorstepai\/doorstepai-track\/iOS\/DoorstepDropoffSDK\/DoorstepDropoffSDK\/src\/Network.swift",
       "kind": "StringLiteral",
-      "offset": 2652,
+      "offset": 2650,
       "length": 9,
       "value": "\"network\""
     },
     {
-      "filePath": "\/Users\/sheelpatel\/Documents\/doorstepai\/doorstepai-track\/iOS\/DoorstepDropoffSDK\/DoorstepDropoffSDK\/src\/c.swift",
+      "filePath": "\/Users\/sheelpatel\/Documents\/doorstepai\/doorstepai-track\/iOS\/DoorstepDropoffSDK\/DoorstepDropoffSDK\/src\/Network.swift",
       "kind": "BooleanLiteral",
-      "offset": 2706,
+      "offset": 2704,
       "length": 4,
       "value": "true"
     },
     {
-      "filePath": "\/Users\/sheelpatel\/Documents\/doorstepai\/doorstepai-track\/iOS\/DoorstepDropoffSDK\/DoorstepDropoffSDK\/src\/c.swift",
+      "filePath": "\/Users\/sheelpatel\/Documents\/doorstepai\/doorstepai-track\/iOS\/DoorstepDropoffSDK\/DoorstepDropoffSDK\/src\/Network.swift",
+      "kind": "BooleanLiteral",
+      "offset": 2780,
+      "length": 5,
+      "value": "false"
+    },
+    {
+      "filePath": "\/Users\/sheelpatel\/Documents\/doorstepai\/doorstepai-track\/iOS\/DoorstepDropoffSDK\/DoorstepDropoffSDK\/src\/Network.swift",
       "kind": "StringLiteral",
-      "offset": 2775,
+      "offset": 2856,
       "length": 2,
       "value": "\"\""
     },
     {
-      "filePath": "\/Users\/sheelpatel\/Documents\/doorstepai\/doorstepai-track\/iOS\/DoorstepDropoffSDK\/DoorstepDropoffSDK\/src\/c.swift",
+      "filePath": "\/Users\/sheelpatel\/Documents\/doorstepai\/doorstepai-track\/iOS\/DoorstepDropoffSDK\/DoorstepDropoffSDK\/src\/Network.swift",
       "kind": "Dictionary",
-      "offset": 2828,
+      "offset": 2909,
       "length": 3,
       "value": "[]"
     },
     {
-      "filePath": "\/Users\/sheelpatel\/Documents\/doorstepai\/doorstepai-track\/iOS\/DoorstepDropoffSDK\/DoorstepDropoffSDK\/src\/c.swift",
+      "filePath": "\/Users\/sheelpatel\/Documents\/doorstepai\/doorstepai-track\/iOS\/DoorstepDropoffSDK\/DoorstepDropoffSDK\/src\/Network.swift",
       "kind": "IntegerLiteral",
-      "offset": 13918,
+      "offset": 22877,
       "length": 1,
       "value": "0"
     },
     {
-      "filePath": "\/Users\/sheelpatel\/Documents\/doorstepai\/doorstepai-track\/iOS\/DoorstepDropoffSDK\/DoorstepDropoffSDK\/src\/c.swift",
+      "filePath": "\/Users\/sheelpatel\/Documents\/doorstepai\/doorstepai-track\/iOS\/DoorstepDropoffSDK\/DoorstepDropoffSDK\/src\/Network.swift",
       "kind": "IntegerLiteral",
-      "offset": 15083,
+      "offset": 25323,
       "length": 1,
       "value": "0"
     },

package/ios/DoorstepDropoffSDK.xcframework/ios-arm64/DoorstepDropoffSDK.framework/_CodeSignature/CodeResources

@@ -14,7 +14,7 @@
 		</data>
 		<key>Modules/DoorstepDropoffSDK.swiftmodule/arm64-apple-ios.abi.json</key>
 		<data>
-		UpBoOWEU7IEc9MPvU0Tnt8S5LBY=
+		Bti4hQv8H3LnIo370ur2hjsg1tM=
 		</data>
 		<key>Modules/DoorstepDropoffSDK.swiftmodule/arm64-apple-ios.private.swiftinterface</key>
 		<data>
@@ -30,7 +30,7 @@
 		</data>
 		<key>Modules/DoorstepDropoffSDK.swiftmodule/arm64-apple-ios.swiftmodule</key>
 		<data>
-		CuN7R2E1ZUinItd8jwKXetvftq0=
+		pNdE+zFGYbgP5r0L4uMOH8Gx19Q=
 		</data>
 		<key>Modules/module.modulemap</key>
 		<data>
@@ -50,7 +50,7 @@
 		<dict>
 			<key>hash2</key>
 			<data>
-			Q62L0T5iYTT6nkMFA5sEwyTUT8LIV2FyLvmH+Gj8bsU=
+			lX5ArHpFBCSmgrQ6G4S8UJv2EL9AMg7iCdAiFzySMPw=
 			</data>
 		</dict>
 		<key>Modules/DoorstepDropoffSDK.swiftmodule/arm64-apple-ios.private.swiftinterface</key>
@@ -78,7 +78,7 @@
 		<dict>
 			<key>hash2</key>
 			<data>
-			f42WeWmfXqqOeD93SkdzR3RifgdC5zXeVOkOHuzJ55o=
+			6lxkCUecX0GS3/kRqxBDgSqHGwxzu+OjrnpizRTBhtA=
 			</data>
 		</dict>
 		<key>Modules/module.modulemap</key>