rns-recplay 1.2.7

package/README.md

@@ -0,0 +1,172 @@
+# rns-recplay
+
+A high-performance React Native module for audio recording and playback with native support for looping, progress tracking, and automatic playback interruption.
+
+---
+
+## Table of Contents
+
+- [Features](#features)
+- [Installation](#installation)
+  - [Requirements](#requirements)
+  - [Permissions (Crucial)](#permissions-crucial)
+- [Usage](#usage)
+  - [Recording Example](#recording-example)
+  - [Playback Example (with Looping)](#playback-example-with-looping)
+- [API Reference](#api-reference)
+  - [Recording API](#recording-api)
+  - [Playback API](#playback-api)
+- [Status Types](#status-types)
+
+---
+
+## Features
+
+- 🎙️ **Recording**: High-quality AAC/M4A recording with real-time timer updates.
+- 🔊 **Playback**: Powered by ExoPlayer (Android) and AVPlayer (iOS).
+- 🔄 **Native Looping**: Seamless looping handled at the native level.
+- 📊 **Progress Tracking**: Real-time position and duration updates (every 500ms).
+- 🛡️ **Auto-Cleanup**: Option to automatically stop playback when starting a recording.
+
+---
+
+## Installation
+
+### Requirements
+
+- **Android**: minSdkVersion 21 or higher  
+- **iOS**: iOS 11.0 or higher
+
+### Permissions (Crucial)
+
+#### Android (`AndroidManifest.xml`)
+
+```xml
+<uses-permission android:name="android.permission.RECORD_AUDIO" />
+<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
+```
+
+#### iOS (`Info.plist`)
+
+```xml
+<key>NSMicrophoneUsageDescription</key>
+<string>We need access to your microphone to record voice notes.</string>
+```
+
+---
+
+## Usage
+
+### Recording Example
+
+```js
+import Recplay from 'rns-recplay';
+
+const startMyRecording = async () => {
+  try {
+    const fileName = await Recplay.startRecording(
+      "my_voice_note",
+      true,
+      (seconds) => console.log(`Recorded: ${seconds}s`)
+    );
+    console.log("Recording started:", fileName);
+  } catch (err) {
+    console.error(err);
+  }
+};
+
+const stopMyRecording = async () => {
+  const fileUri = await Recplay.stopRecording();
+  console.log("File saved at:", fileUri);
+};
+```
+
+---
+
+### Playback Example (with Looping)
+
+```js
+import Recplay from 'rns-recplay';
+
+Recplay.playAudio(
+  "file:///path/to/audio.m4a",
+  true,
+  true,
+  {
+    onStatus: (status) => console.log("Status:", status),
+    onProgress: (pos, dur) => console.log(`Progress: ${pos} / ${dur}`),
+    onFinished: () => console.log("Done!")
+  }
+);
+```
+
+---
+
+## API Reference
+
+### Recording API
+
+#### startRecording(fileName?, shouldStopPlayback?, onSecondsUpdate?)
+
+| Param               | Type     | Default | Description |
+|--------------------|----------|---------|-------------|
+| fileName           | string   | null    | Custom name for the `.m4a` file |
+| shouldStopPlayback | boolean  | true    | Stops any active audio player before recording |
+| onSecondsUpdate    | function | null    | Callback fired every second |
+
+---
+
+#### stopRecording()
+
+Stops the recording and releases the microphone.
+
+**Returns:** Promise<string>
+
+---
+
+#### pauseRecording() / resumeRecording()
+
+Pauses or resumes the current recording session.
+
+---
+
+### Playback API
+
+#### playAudio(uri, shouldStopPrevious?, loop?, callbacks?)
+
+| Param              | Type    | Default | Description |
+|-------------------|---------|---------|-------------|
+| uri               | string  | Required | Audio URI |
+| shouldStopPrevious| boolean | false   | Stops previous playback |
+| loop              | boolean | false   | Native looping |
+| callbacks         | object  | `{}`    | onStatus, onProgress, onFinished |
+
+---
+
+#### stopPlayback()
+
+Stops audio immediately.
+
+---
+
+#### togglePlayback()
+
+Plays or pauses the active player.
+
+---
+
+#### seekTo(seconds)
+
+| Param   | Type   | Description |
+|--------|--------|-------------|
+| seconds | number | Seek position |
+
+---
+
+## Status Types
+
+- BUFFERING
+- PLAYING
+- PAUSED
+- ENDED
+- IDLE

package/android/build/.transforms/cdad66fa505a583e6d3a40af343cb85b/results.bin

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

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

@@ -0,0 +1,10 @@
+/**
+ * Automatically generated file. DO NOT MODIFY
+ */
+package com.rnsrecplay;
+
+public final class BuildConfig {
+  public static final boolean DEBUG = Boolean.parseBoolean("true");
+  public static final String LIBRARY_PACKAGE_NAME = "com.rnsrecplay";
+  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.rnsrecplay" >
+
+    <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.rnsrecplay",
+  "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 @@
+#Sun Jan 18 17:20:58 GMT 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/bush/Desktop/Apps/Raiidr/node_modules/rns-recplay/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/bush/Desktop/Apps/Raiidr/node_modules/rns-recplay/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/bush/Desktop/Apps/Raiidr/node_modules/rns-recplay/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/bush/Desktop/Apps/Raiidr/node_modules/rns-recplay/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/bush/Desktop/Apps/Raiidr/node_modules/rns-recplay/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/bush/Desktop/Apps/Raiidr/node_modules/rns-recplay/android/build/generated/res/resValues/debug"/></dataSet><mergedItems/></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/bush/Desktop/Apps/Raiidr/node_modules/rns-recplay/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/bush/Desktop/Apps/Raiidr/node_modules/rns-recplay/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/bush/Desktop/Apps/Raiidr/node_modules/rns-recplay/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/bush/Desktop/Apps/Raiidr/node_modules/rns-recplay/android/src/debug/shaders"/></dataSet></merger>

package/android/build/intermediates/incremental/packageDebugAssets/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/bush/Desktop/Apps/Raiidr/node_modules/rns-recplay/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/bush/Desktop/Apps/Raiidr/node_modules/rns-recplay/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/bush/Desktop/Apps/Raiidr/node_modules/rns-recplay/android/build/intermediates/shader_assets/debug/compileDebugShaders/out"/></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.rnsrecplay" >
+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.rnsrecplay" >
+
+    <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.rnsrecplay

package/android/build/kotlin/compileDebugKotlin/cacheable/caches-jvm/lookups/counters.tab

@@ -0,0 +1,2 @@
+14
+0

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

@@ -0,0 +1,16 @@
+-- Merging decision tree log ---
+manifest
+ADDED from /Users/bush/Desktop/Apps/Raiidr/node_modules/rns-recplay/android/build/intermediates/tmp/ProcessLibraryManifest/debug/tempAndroidManifest10474479560867336143.xml:2:13-83
+INJECTED from /Users/bush/Desktop/Apps/Raiidr/node_modules/rns-recplay/android/build/intermediates/tmp/ProcessLibraryManifest/debug/tempAndroidManifest10474479560867336143.xml:2:13-83
+	package
+		INJECTED from /Users/bush/Desktop/Apps/Raiidr/node_modules/rns-recplay/android/build/intermediates/tmp/ProcessLibraryManifest/debug/tempAndroidManifest10474479560867336143.xml
+	xmlns:android
+		ADDED from /Users/bush/Desktop/Apps/Raiidr/node_modules/rns-recplay/android/build/intermediates/tmp/ProcessLibraryManifest/debug/tempAndroidManifest10474479560867336143.xml:2:23-81
+uses-sdk
+INJECTED from /Users/bush/Desktop/Apps/Raiidr/node_modules/rns-recplay/android/build/intermediates/tmp/ProcessLibraryManifest/debug/tempAndroidManifest10474479560867336143.xml reason: use-sdk injection requested
+INJECTED from /Users/bush/Desktop/Apps/Raiidr/node_modules/rns-recplay/android/build/intermediates/tmp/ProcessLibraryManifest/debug/tempAndroidManifest10474479560867336143.xml
+INJECTED from /Users/bush/Desktop/Apps/Raiidr/node_modules/rns-recplay/android/build/intermediates/tmp/ProcessLibraryManifest/debug/tempAndroidManifest10474479560867336143.xml
+	android:targetSdkVersion
+		INJECTED from /Users/bush/Desktop/Apps/Raiidr/node_modules/rns-recplay/android/build/intermediates/tmp/ProcessLibraryManifest/debug/tempAndroidManifest10474479560867336143.xml
+	android:minSdkVersion
+		INJECTED from /Users/bush/Desktop/Apps/Raiidr/node_modules/rns-recplay/android/build/intermediates/tmp/ProcessLibraryManifest/debug/tempAndroidManifest10474479560867336143.xml

package/android/build.gradle

@@ -0,0 +1,67 @@
+buildscript {
+    ext.kotlin_version = project.hasProperty('kotlinVersion') ? project.kotlinVersion : '1.8.10'
+    repositories {
+        google()
+        mavenCentral()
+    }
+    dependencies {
+        classpath "com.android.tools.build:gradle:7.4.2"
+        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
+    }
+}
+
+apply plugin: 'com.android.library'
+apply plugin: 'kotlin-android'
+
+def safeExtGet(prop, fallback) {
+    rootProject.ext.has(prop) ? rootProject.ext.get(prop) : fallback
+}
+
+android {
+    namespace "com.rnsrecplay"
+    
+    // Using 34 to match modern React Native standards
+    compileSdkVersion safeExtGet('compileSdkVersion', 34)
+
+    defaultConfig {
+        minSdkVersion safeExtGet('minSdkVersion', 21)
+        targetSdkVersion safeExtGet('targetSdkVersion', 34)
+        
+        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+    }
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_17
+        targetCompatibility JavaVersion.VERSION_17
+    }
+
+    kotlinOptions {
+        jvmTarget = '17'
+    }
+
+    lint {
+        abortOnError false
+    }
+}
+
+repositories {
+    mavenCentral()
+    google()
+}
+
+dependencies {
+    // React Native Core
+    implementation "com.facebook.react:react-native:+"
+    implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
+    implementation "androidx.core:core-ktx:1.12.0"
+    implementation "androidx.appcompat:appcompat:1.6.1"
+
+    // --- AUDIO PLAYBACK (EXOPLAYER) ---
+    // This solves your "Unresolved reference" errors
+    implementation "com.google.android.exoplayer:exoplayer-core:2.18.1"
+    implementation "com.google.android.exoplayer:exoplayer-dash:2.18.1"
+    implementation "com.google.android.exoplayer:exoplayer-ui:2.18.1"
+
+    // Optional: Keep your other dependencies if they are used elsewhere in the module
+    implementation "com.github.bumptech.glide:glide:4.15.1"
+}