@quipuscore/react-native-sms 0.0.1

package/README.md

@@ -0,0 +1,197 @@
+# React Native SMS SDK
+
+A React Native library to read and sync SMS messages on Android devices. It wraps the Quipu Bank SMS SDK (`com.quipubank:sms-sdk`) published on Maven Central.
+
+> **Note:** This library is **Android-only**. SMS reading is not supported on iOS.
+
+## Installation
+
+```bash
+npm install @quipuscore/react-native-sms
+```
+
+If using Expo, run a development build (custom native code is not supported in Expo Go):
+
+```bash
+npx expo prebuild --platform android
+npx expo run:android
+```
+
+## Requirements
+
+- React Native 0.60+ (auto-linking)
+- Android API level 24+ (minSdk in the library)
+- For Expo: use a development build, not Expo Go
+
+## Configuration
+
+### Android
+
+Add the **READ_SMS** permission to your app (e.g. in `app.json` for Expo, or `AndroidManifest.xml`):
+
+```xml
+<uses-permission android:name="android.permission.READ_SMS" />
+```
+
+Request `READ_SMS` at runtime before calling `readSms()` or `collectAndSync()` (e.g. with `PermissionsAndroid.request(PermissionsAndroid.PERMISSIONS.READ_SMS, ...)`).
+
+`INTERNET` and `ACCESS_NETWORK_STATE` are declared by the underlying Quipu SDK and are merged into your app automatically; you do not need to add them yourself.
+
+**Verifying merged permissions:** After building the Android app, open the manifest merger report at `android/app/build/outputs/logs/manifest-merger-debug-report.txt` and search for `com.quipubank:sms-sdk` — you will see `MERGED from [com.quipubank:sms-sdk:0.0.1]` for `INTERNET` and `ACCESS_NETWORK_STATE`.
+
+## Usage
+
+### Initialize the SDK
+
+```typescript
+import SmsSdk from '@quipuscore/react-native-sms';
+
+// Initialize with client ID and token
+const result = await SmsSdk.initialize('YOUR_CLIENT_ID', 'YOUR_API_TOKEN');
+```
+
+### Read and sync SMS messages
+
+```typescript
+// Collect SMS and sync to the server in one operation
+try {
+  const result = await SmsSdk.collectAndSync({
+    deviceId: 'device456',
+    userId: 'user123', // optional
+  });
+  console.log(result.message, result.count);
+} catch (error) {
+  console.error('Error reading or syncing SMS:', error);
+}
+```
+
+### Link user with device
+
+```typescript
+await SmsSdk.linkUserIdWithDevice('userId', 'deviceId');
+```
+
+## API
+
+<docgen-index>
+
+* [`initialize(...)`](#initialize)
+* [`collectAndSync(...)`](#collectandsync)
+* [`linkUserIdWithDevice(...)`](#linkuseridwithdevice)
+* [Interfaces](#interfaces)
+
+</docgen-index>
+
+<docgen-api>
+<!--Update the source file JSDoc comments and rerun docgen to update the docs below-->
+
+Public interface for the SMS plugin - exposing initialize, collectAndSync, and linkUserIdWithDevice methods
+
+### initialize(...)
+
+```typescript
+initialize(options: InitializeOptions) => Promise<InitializeResult>
+```
+
+Initialize the SMS plugin with a token
+
+| Param         | Type                                                            | Description                                 |
+| ------------- | --------------------------------------------------------------- | ------------------------------------------- |
+| **`options`** | <code><a href="#initializeoptions">InitializeOptions</a></code> | Options containing the authentication token |
+
+**Returns:** <code>Promise&lt;<a href="#initializeresult">InitializeResult</a>&gt;</code>
+
+--------------------
+
+
+### collectAndSync(...)
+
+```typescript
+collectAndSync(options: CollectAndSyncOptions) => Promise<SyncSmsResult>
+```
+
+Collect SMS messages and sync them to the server in one operation
+
+| Param         | Type                                                                    | Description                            |
+| ------------- | ----------------------------------------------------------------------- | -------------------------------------- |
+| **`options`** | <code><a href="#collectandsyncoptions">CollectAndSyncOptions</a></code> | Options containing userId and deviceId |
+
+**Returns:** <code>Promise&lt;<a href="#syncsmsresult">SyncSmsResult</a>&gt;</code>
+
+--------------------
+
+
+### linkUserIdWithDevice(...)
+
+```typescript
+linkUserIdWithDevice(options: LinkUserIdWithDeviceOptions) => Promise<LinkUserIdWithDeviceResult>
+```
+
+Link a user ID with a device ID
+
+| Param         | Type                                                                                | Description                            |
+| ------------- | ----------------------------------------------------------------------------------- | -------------------------------------- |
+| **`options`** | <code><a href="#linkuseridwithdeviceoptions">LinkUserIdWithDeviceOptions</a></code> | Options containing userId and deviceId |
+
+**Returns:** <code>Promise&lt;<a href="#linkuseridwithdeviceresult">LinkUserIdWithDeviceResult</a>&gt;</code>
+
+--------------------
+
+
+### Interfaces
+
+
+#### InitializeResult
+
+| Prop          | Type                 |
+| ------------- | -------------------- |
+| **`success`** | <code>boolean</code> |
+| **`message`** | <code>string</code>  |
+
+
+#### InitializeOptions
+
+| Prop           | Type                | Description                                                                              |
+| -------------- | ------------------- | ---------------------------------------------------------------------------------------- |
+| **`clientId`** | <code>string</code> | Client ID for identification                                                             |
+| **`token`**    | <code>string</code> | API token for authentication - this also determines the environment (sandbox/production) |
+
+
+#### SyncSmsResult
+
+| Prop          | Type                 |
+| ------------- | -------------------- |
+| **`success`** | <code>boolean</code> |
+| **`message`** | <code>string</code>  |
+
+
+#### CollectAndSyncOptions
+
+| Prop                 | Type                | Description              |
+| -------------------- | ------------------- | ------------------------ |
+| **`deviceId`**       | <code>string</code> |                          |
+| **`userId`**         | <code>string</code> | Optional user ID         |
+| **`identityNumber`** | <code>string</code> | Optional identity number |
+| **`identityType`**   | <code>string</code> | Optional identity type   |
+
+
+#### LinkUserIdWithDeviceResult
+
+| Prop          | Type                 |
+| ------------- | -------------------- |
+| **`success`** | <code>boolean</code> |
+| **`message`** | <code>string</code>  |
+
+
+#### LinkUserIdWithDeviceOptions
+
+| Prop           | Type                | Description                     |
+| -------------- | ------------------- | ------------------------------- |
+| **`userId`**   | <code>string</code> | User ID to link with the device |
+| **`deviceId`** | <code>string</code> | Device ID to link with the user |
+
+</docgen-api>
+
+## License
+
+Apache-2.0

package/android/build/.transforms/278baee71bd9f04a200f5e90b2c74ab9/results.bin

@@ -0,0 +1 @@
+o/bundleLibRuntimeToDirDebug

package/android/build/.transforms/7ce351f0dc5c564181486a677912b850/results.bin

@@ -0,0 +1 @@
+o/classes

package/android/build/generated/source/buildConfig/debug/com/quipumarket/reactnativesmssdk/BuildConfig.java

@@ -0,0 +1,10 @@
+/**
+ * Automatically generated file. DO NOT MODIFY
+ */
+package com.quipumarket.reactnativesmssdk;
+
+public final class BuildConfig {
+  public static final boolean DEBUG = Boolean.parseBoolean("true");
+  public static final String LIBRARY_PACKAGE_NAME = "com.quipumarket.reactnativesmssdk";
+  public static final String BUILD_TYPE = "debug";
+}

package/android/build/intermediates/aapt_friendly_merged_manifests/debug/processDebugManifest/aapt/AndroidManifest.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="com.quipumarket.reactnativesmssdk" >
+
+    <uses-sdk android:minSdkVersion="24" />
+
+</manifest>

package/android/build/intermediates/aapt_friendly_merged_manifests/debug/processDebugManifest/aapt/output-metadata.json

@@ -0,0 +1,18 @@
+{
+  "version": 3,
+  "artifactType": {
+    "type": "AAPT_FRIENDLY_MERGED_MANIFESTS",
+    "kind": "Directory"
+  },
+  "applicationId": "com.quipumarket.reactnativesmssdk",
+  "variantName": "debug",
+  "elements": [
+    {
+      "type": "SINGLE",
+      "filters": [],
+      "attributes": [],
+      "outputFile": "AndroidManifest.xml"
+    }
+  ],
+  "elementType": "File"
+}

package/android/build/intermediates/aar_metadata/debug/writeDebugAarMetadata/aar-metadata.properties

@@ -0,0 +1,6 @@
+aarFormatVersion=1.0
+aarMetadataVersion=1.0
+minCompileSdk=1
+minCompileSdkExtension=0
+minAndroidGradlePluginVersion=1.0.0
+coreLibraryDesugaringEnabled=false

package/android/build/intermediates/annotation_processor_list/debug/javaPreCompileDebug/annotationProcessors.json

@@ -0,0 +1 @@
+{}

package/android/build/intermediates/incremental/debug/packageDebugResources/compile-file-map.properties

@@ -0,0 +1 @@
+#Mon Feb 09 15:38:58 ART 2026

package/android/build/intermediates/incremental/debug/packageDebugResources/merger.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8"?>
+<merger version="3"><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="main$Generated" generated="true" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/leandrovignoni/Documents/quipu/projects/quipumarket-ionic-plugins/get-sms-plugin-v2/react-native-sms-sdk-2026-02-09/android/src/main/res"/></dataSet><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="main" generated-set="main$Generated" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/leandrovignoni/Documents/quipu/projects/quipumarket-ionic-plugins/get-sms-plugin-v2/react-native-sms-sdk-2026-02-09/android/src/main/res"/></dataSet><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="debug$Generated" generated="true" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/leandrovignoni/Documents/quipu/projects/quipumarket-ionic-plugins/get-sms-plugin-v2/react-native-sms-sdk-2026-02-09/android/src/debug/res"/></dataSet><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="debug" generated-set="debug$Generated" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/leandrovignoni/Documents/quipu/projects/quipumarket-ionic-plugins/get-sms-plugin-v2/react-native-sms-sdk-2026-02-09/android/src/debug/res"/></dataSet><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="generated$Generated" generated="true" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/leandrovignoni/Documents/quipu/projects/quipumarket-ionic-plugins/get-sms-plugin-v2/react-native-sms-sdk-2026-02-09/android/build/generated/res/resValues/debug"/></dataSet><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="generated" generated-set="generated$Generated" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/leandrovignoni/Documents/quipu/projects/quipumarket-ionic-plugins/get-sms-plugin-v2/react-native-sms-sdk-2026-02-09/android/build/generated/res/resValues/debug"/></dataSet><mergedItems/></merger>

package/android/build/intermediates/incremental/mergeDebugAssets/merger.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8"?>
+<merger version="3"><dataSet config="main" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/leandrovignoni/Documents/quipu/projects/quipumarket-ionic-plugins/get-sms-plugin-v2/react-native-sms-sdk-2026-02-09/android/src/main/assets"/></dataSet><dataSet config="debug" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/leandrovignoni/Documents/quipu/projects/quipumarket-ionic-plugins/get-sms-plugin-v2/react-native-sms-sdk-2026-02-09/android/src/debug/assets"/></dataSet><dataSet config="generated" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/leandrovignoni/Documents/quipu/projects/quipumarket-ionic-plugins/get-sms-plugin-v2/react-native-sms-sdk-2026-02-09/android/build/intermediates/shader_assets/debug/compileDebugShaders/out"/></dataSet></merger>

package/android/build/intermediates/incremental/mergeDebugJniLibFolders/merger.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8"?>
+<merger version="3"><dataSet config="main" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/leandrovignoni/Documents/quipu/projects/quipumarket-ionic-plugins/get-sms-plugin-v2/react-native-sms-sdk-2026-02-09/android/src/main/jniLibs"/></dataSet><dataSet config="debug" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/leandrovignoni/Documents/quipu/projects/quipumarket-ionic-plugins/get-sms-plugin-v2/react-native-sms-sdk-2026-02-09/android/src/debug/jniLibs"/></dataSet></merger>

package/android/build/intermediates/incremental/mergeDebugShaders/merger.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8"?>
+<merger version="3"><dataSet config="main" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/leandrovignoni/Documents/quipu/projects/quipumarket-ionic-plugins/get-sms-plugin-v2/react-native-sms-sdk-2026-02-09/android/src/main/shaders"/></dataSet><dataSet config="debug" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/leandrovignoni/Documents/quipu/projects/quipumarket-ionic-plugins/get-sms-plugin-v2/react-native-sms-sdk-2026-02-09/android/src/debug/shaders"/></dataSet></merger>

package/android/build/intermediates/local_only_symbol_list/debug/parseDebugLocalResources/R-def.txt

@@ -0,0 +1,2 @@
+R_DEF: Internal format may change without notice
+local

package/android/build/intermediates/manifest_merge_blame_file/debug/processDebugManifest/manifest-merger-blame-debug-report.txt

@@ -0,0 +1,7 @@
+1<?xml version="1.0" encoding="utf-8"?>
+2<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+3    package="com.quipumarket.reactnativesmssdk" >
+4
+5    <uses-sdk android:minSdkVersion="24" />
+6
+7</manifest>

package/android/build/intermediates/merged_manifest/debug/processDebugManifest/AndroidManifest.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="com.quipumarket.reactnativesmssdk" >
+
+    <uses-sdk android:minSdkVersion="24" />
+
+</manifest>

package/android/build/intermediates/navigation_json/debug/extractDeepLinksDebug/navigation.json

@@ -0,0 +1 @@
+[]

package/android/build/intermediates/nested_resources_validation_report/debug/generateDebugResources/nestedResourcesValidationReport.txt

@@ -0,0 +1 @@
+0 Warning/Error

package/android/build/intermediates/symbol_list_with_package_name/debug/generateDebugRFile/package-aware-r.txt

@@ -0,0 +1 @@
+com.quipumarket.reactnativesmssdk

package/android/build/outputs/logs/manifest-merger-debug-report.txt

@@ -0,0 +1,16 @@
+-- Merging decision tree log ---
+manifest
+ADDED from /Users/leandrovignoni/Documents/quipu/projects/quipumarket-ionic-plugins/get-sms-plugin-v2/react-native-sms-sdk-2026-02-09/android/src/main/AndroidManifest.xml:1:1-2:12
+INJECTED from /Users/leandrovignoni/Documents/quipu/projects/quipumarket-ionic-plugins/get-sms-plugin-v2/react-native-sms-sdk-2026-02-09/android/src/main/AndroidManifest.xml:1:1-2:12
+	package
+		INJECTED from /Users/leandrovignoni/Documents/quipu/projects/quipumarket-ionic-plugins/get-sms-plugin-v2/react-native-sms-sdk-2026-02-09/android/src/main/AndroidManifest.xml
+	xmlns:android
+		ADDED from /Users/leandrovignoni/Documents/quipu/projects/quipumarket-ionic-plugins/get-sms-plugin-v2/react-native-sms-sdk-2026-02-09/android/src/main/AndroidManifest.xml:1:11-69
+uses-sdk
+INJECTED from /Users/leandrovignoni/Documents/quipu/projects/quipumarket-ionic-plugins/get-sms-plugin-v2/react-native-sms-sdk-2026-02-09/android/src/main/AndroidManifest.xml reason: use-sdk injection requested
+INJECTED from /Users/leandrovignoni/Documents/quipu/projects/quipumarket-ionic-plugins/get-sms-plugin-v2/react-native-sms-sdk-2026-02-09/android/src/main/AndroidManifest.xml
+INJECTED from /Users/leandrovignoni/Documents/quipu/projects/quipumarket-ionic-plugins/get-sms-plugin-v2/react-native-sms-sdk-2026-02-09/android/src/main/AndroidManifest.xml
+	android:targetSdkVersion
+		INJECTED from /Users/leandrovignoni/Documents/quipu/projects/quipumarket-ionic-plugins/get-sms-plugin-v2/react-native-sms-sdk-2026-02-09/android/src/main/AndroidManifest.xml
+	android:minSdkVersion
+		INJECTED from /Users/leandrovignoni/Documents/quipu/projects/quipumarket-ionic-plugins/get-sms-plugin-v2/react-native-sms-sdk-2026-02-09/android/src/main/AndroidManifest.xml

package/android/build.gradle

@@ -0,0 +1,31 @@
+apply plugin: 'com.android.library'
+
+def safeExtGet(prop, fallback) {
+    rootProject.ext.has(prop) ? rootProject.ext.get(prop) : fallback
+}
+
+android {
+    namespace "com.quipumarket.reactnativesmssdk"
+    compileSdkVersion safeExtGet('compileSdkVersion', 34)
+
+    defaultConfig {
+        minSdkVersion safeExtGet('minSdkVersion', 24)
+        targetSdkVersion safeExtGet('targetSdkVersion', 34)
+    }
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_17
+        targetCompatibility JavaVersion.VERSION_17
+    }
+}
+
+repositories {
+    mavenCentral()
+    google()
+}
+
+dependencies {
+    //noinspection GradleDynamicVersion
+    implementation 'com.facebook.react:react-android:+'
+    implementation 'com.quipubank:sms-sdk:0.0.1'
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,2 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+</manifest>

package/android/src/main/java/com/quipumarket/reactnativesmssdk/SmsSdkModule.java

@@ -0,0 +1,210 @@
+package com.quipumarket.reactnativesmssdk;
+
+import android.util.Log;
+
+import androidx.annotation.NonNull;
+
+import com.facebook.react.bridge.Arguments;
+import com.facebook.react.bridge.Promise;
+import com.facebook.react.bridge.ReactApplicationContext;
+import com.facebook.react.bridge.ReactContextBaseJavaModule;
+import com.facebook.react.bridge.ReactMethod;
+import com.facebook.react.bridge.ReadableMap;
+import com.facebook.react.bridge.WritableArray;
+import com.facebook.react.bridge.WritableMap;
+
+import com.quipumarket.sms.AuthCallback;
+import com.quipumarket.sms.CombinedCallback;
+import com.quipumarket.sms.SmsCallback;
+import com.quipumarket.sms.SmsMessage;
+import com.quipumarket.sms.SmsReader;
+import com.quipumarket.sms.SmsReaderImpl;
+import com.quipumarket.sms.SyncCallback;
+
+import java.text.SimpleDateFormat;
+import java.util.List;
+import java.util.Locale;
+
+public class SmsSdkModule extends ReactContextBaseJavaModule {
+
+    private static final String TAG = "SmsSdkModule";
+    private final SmsReader smsReader;
+
+    public SmsSdkModule(ReactApplicationContext reactContext) {
+        super(reactContext);
+        smsReader = new SmsReaderImpl(reactContext);
+    }
+
+    @Override
+    @NonNull
+    public String getName() {
+        return "SmsSdk";
+    }
+
+    @ReactMethod
+    public void initialize(String clientId, String token, Promise promise) {
+        if (clientId == null || clientId.isEmpty()) {
+            promise.reject("INVALID_CLIENT_ID", "A valid clientId must be provided.");
+            return;
+        }
+        if (token == null || token.isEmpty()) {
+            promise.reject("INVALID_TOKEN", "A valid token must be provided.");
+            return;
+        }
+
+        Log.i(TAG, "Initializing SMS SDK with clientId and token");
+
+        smsReader.initialize(clientId, token, new AuthCallback() {
+            @Override
+            public void onAuthSuccess() {
+                WritableMap result = Arguments.createMap();
+                result.putBoolean("success", true);
+                result.putString("message", "Initialization successful");
+                promise.resolve(result);
+            }
+
+            @Override
+            public void onAuthError(Exception error) {
+                promise.reject("AUTH_ERROR", "Authentication failed: " + error.getMessage(), error);
+            }
+        });
+    }
+
+    @ReactMethod
+    public void isInitialized(Promise promise) {
+        promise.resolve(smsReader.isInitialized());
+    }
+
+    @ReactMethod
+    public void readSms(Promise promise) {
+        if (!smsReader.isInitialized()) {
+            promise.reject("NOT_INITIALIZED", "SDK not initialized. Call initialize() first.");
+            return;
+        }
+
+        smsReader.readSms(new SmsCallback() {
+            @Override
+            public void onSuccess(List<SmsMessage> messages) {
+                WritableArray smsArray = Arguments.createArray();
+                SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss", Locale.getDefault());
+
+                for (SmsMessage message : messages) {
+                    WritableMap smsMap = Arguments.createMap();
+                    smsMap.putString("address", message.getAddress());
+                    smsMap.putString("body", message.getBody());
+                    smsMap.putString("creator", message.getCreator());
+                    if (message.getDate() != null) {
+                        smsMap.putString("date", sdf.format(message.getDate()));
+                    }
+                    smsArray.pushMap(smsMap);
+                }
+
+                WritableMap result = Arguments.createMap();
+                result.putArray("messages", smsArray);
+                result.putInt("count", messages.size());
+                promise.resolve(result);
+            }
+
+            @Override
+            public void onError(Exception error) {
+                promise.reject("READ_ERROR", "Error reading SMS: " + error.getMessage(), error);
+            }
+        });
+    }
+
+    @ReactMethod
+    public void collectAndSync(ReadableMap options, Promise promise) {
+        if (!smsReader.isInitialized()) {
+            promise.reject("NOT_INITIALIZED", "SDK not initialized. Call initialize() first.");
+            return;
+        }
+
+        String deviceId = options.hasKey("deviceId") ? options.getString("deviceId") : null;
+        String userId = options.hasKey("userId") ? options.getString("userId") : null;
+        String identityNumber = options.hasKey("identityNumber") ? options.getString("identityNumber") : null;
+        String identityType = options.hasKey("identityType") ? options.getString("identityType") : null;
+
+        if (deviceId == null || deviceId.isEmpty()) {
+            promise.reject("INVALID_DEVICE_ID", "deviceId is required for collectAndSync");
+            return;
+        }
+
+        Log.d(TAG, "Collecting and syncing SMS for deviceId: " + deviceId);
+
+        smsReader.collectAndSync(deviceId, userId, identityNumber, identityType, new CombinedCallback() {
+            @Override
+            public void onSuccess(List<SmsMessage> messages) {
+                WritableMap result = Arguments.createMap();
+                result.putBoolean("success", true);
+                result.putString("message", "Successfully collected and synced " + messages.size() + " SMS messages");
+                result.putInt("count", messages.size());
+                promise.resolve(result);
+            }
+
+            @Override
+            public void onReadError(Exception e) {
+                promise.reject("READ_ERROR", "Error reading SMS: " + e.getMessage(), e);
+            }
+
+            @Override
+            public void onSyncError(List<SmsMessage> messages, Exception e) {
+                promise.reject("SYNC_ERROR", "SMS read succeeded but sync failed: " + e.getMessage(), e);
+            }
+        });
+    }
+
+    @ReactMethod
+    public void linkUserIdWithDevice(String userId, String deviceId, Promise promise) {
+        if (!smsReader.isInitialized()) {
+            promise.reject("NOT_INITIALIZED", "SDK not initialized. Call initialize() first.");
+            return;
+        }
+
+        if (userId == null || userId.isEmpty()) {
+            promise.reject("INVALID_USER_ID", "userId is required");
+            return;
+        }
+
+        if (deviceId == null || deviceId.isEmpty()) {
+            promise.reject("INVALID_DEVICE_ID", "deviceId is required");
+            return;
+        }
+
+        Log.d(TAG, "Linking userId: " + userId + " with device: " + deviceId);
+
+        smsReader.linkUserIdWithDevice(userId, deviceId, new SyncCallback() {
+            @Override
+            public void onSuccess() {
+                WritableMap result = Arguments.createMap();
+                result.putBoolean("success", true);
+                result.putString("message", "Successfully linked userId with device");
+                promise.resolve(result);
+            }
+
+            @Override
+            public void onError(Exception e) {
+                promise.reject("LINK_ERROR", "Error linking userId with device: " + e.getMessage(), e);
+            }
+        });
+    }
+
+    @ReactMethod
+    public void setSyncEndpoint(String endpoint, Promise promise) {
+        try {
+            smsReader.setSyncEndpoint(endpoint);
+            promise.resolve(true);
+        } catch (Exception e) {
+            promise.reject("SET_ENDPOINT_ERROR", "Error setting sync endpoint: " + e.getMessage(), e);
+        }
+    }
+
+    @ReactMethod
+    public void setBatchSize(double batchSize, Promise promise) {
+        try {
+            smsReader.setBatchSize((int) batchSize);
+            promise.resolve(true);
+        } catch (Exception e) {
+            promise.reject("SET_BATCH_SIZE_ERROR", "Error setting batch size: " + e.getMessage(), e);
+        }
+    }
+}

package/android/src/main/java/com/quipumarket/reactnativesmssdk/SmsSdkPackage.java

@@ -0,0 +1,29 @@
+package com.quipumarket.reactnativesmssdk;
+
+import androidx.annotation.NonNull;
+
+import com.facebook.react.ReactPackage;
+import com.facebook.react.bridge.NativeModule;
+import com.facebook.react.bridge.ReactApplicationContext;
+import com.facebook.react.uimanager.ViewManager;
+
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+
+public class SmsSdkPackage implements ReactPackage {
+
+    @NonNull
+    @Override
+    public List<NativeModule> createNativeModules(@NonNull ReactApplicationContext reactContext) {
+        List<NativeModule> modules = new ArrayList<>();
+        modules.add(new SmsSdkModule(reactContext));
+        return modules;
+    }
+
+    @NonNull
+    @Override
+    public List<ViewManager> createViewManagers(@NonNull ReactApplicationContext reactContext) {
+        return Collections.emptyList();
+    }
+}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@quipuscore/react-native-sms",
+  "version": "0.0.1",
+  "description": "React Native library for reading and syncing SMS messages on Android devices.",
+  "main": "src/index.ts",
+  "source": "src/index.ts",
+  "react-native": "src/index.ts",
+  "types": "src/index.ts",
+  "files": [
+    "src",
+    "android",
+    "react-native.config.js"
+  ],
+  "scripts": {},
+  "keywords": [
+    "react-native",
+    "sms",
+    "sdk",
+    "quipubank"
+  ],
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "license": "Apache-2.0"
+}

package/react-native.config.js

@@ -0,0 +1,8 @@
+module.exports = {
+  dependency: {
+    platforms: {
+      android: {},
+      ios: null, // No iOS support — this SDK is Android only
+    },
+  },
+};

package/src/index.ts

@@ -0,0 +1,83 @@
+import { NativeModules, Platform } from 'react-native';
+
+const LINKING_ERROR =
+  `The package 'react-native-sms-sdk' doesn't seem to be linked. Make sure:\n\n` +
+  Platform.select({ ios: "- You have run 'pod install'\n", default: '' }) +
+  '- You rebuilt the app after installing the package\n' +
+  '- You are not using Expo Go (custom native code requires a development build)\n';
+
+const SmsSdk = NativeModules.SmsSdk
+  ? NativeModules.SmsSdk
+  : new Proxy(
+      {},
+      {
+        get() {
+          throw new Error(LINKING_ERROR);
+        },
+      }
+    );
+
+// --- Type definitions ---
+
+export interface InitializeResult {
+  success: boolean;
+  message: string;
+}
+
+export interface CollectAndSyncOptions {
+  deviceId: string;
+  userId?: string;
+  identityNumber?: string;
+  identityType?: string;
+}
+
+export interface CollectAndSyncResult {
+  success: boolean;
+  message: string;
+  count: number;
+}
+
+export interface LinkResult {
+  success: boolean;
+  message: string;
+}
+
+// --- Public API ---
+
+/**
+ * Initialize the SMS SDK with authentication credentials.
+ * Must be called before any other SDK method.
+ */
+export function initialize(
+  clientId: string,
+  token: string
+): Promise<InitializeResult> {
+  return SmsSdk.initialize(clientId, token);
+}
+
+/**
+ * Collect SMS messages from the device and sync them to the server
+ * in a single operation.
+ * Requires READ_SMS permission to be granted.
+ */
+export function collectAndSync(
+  options: CollectAndSyncOptions
+): Promise<CollectAndSyncResult> {
+  return SmsSdk.collectAndSync(options);
+}
+
+/**
+ * Link a user ID with a device ID on the server.
+ */
+export function linkUserIdWithDevice(
+  userId: string,
+  deviceId: string
+): Promise<LinkResult> {
+  return SmsSdk.linkUserIdWithDevice(userId, deviceId);
+}
+
+export default {
+  initialize,
+  collectAndSync,
+  linkUserIdWithDevice,
+};