@siteed/audio-studio 3.2.0-beta.1 → 3.2.0

package/package.json

@@ -1,147 +1,164 @@
 {
-    "name": "@siteed/audio-studio",
-    "version": "3.2.0-beta.1",
-    "description": "Comprehensive audio processing library for React Native and Expo with recording, analysis, visualization, and streaming capabilities across iOS, Android, and web",
-    "license": "MIT",
-    "type": "commonjs",
-    "main": "./build/cjs/index.js",
-    "module": "./build/esm/index.js",
-    "types": "./build/types/index.d.ts",
-    "expo": {
-        "plugin": "./app.plugin.js"
-    },
-    "author": "Arthur Breton <abreton@siteed.net> (https://github.com/deeeed)",
-    "homepage": "https://github.com/deeeed/audiolab/blob/main/packages/audio-studio/README.md",
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/deeeed/audiolab.git",
-        "directory": "packages/audio-studio"
-    },
-    "bugs": {
-        "url": "https://github.com/deeeed/audiolab/issues"
-    },
-    "keywords": [
-        "react-native",
-        "expo",
-        "audio",
-        "recording",
-        "audio-analysis",
-        "audio-processing",
-        "audio-visualization",
-        "waveform",
-        "spectrogram",
-        "mel-spectrogram",
-        "mfcc",
-        "audio-features",
-        "audio-compression",
-        "opus",
-        "aac",
-        "pcm",
-        "wav",
-        "cross-platform",
-        "background-recording",
-        "audio-trimming",
-        "dual-stream"
-    ],
-    "files": [
-        "src",
-        "android",
-        "ios",
-        "cpp",
-        "plugin",
-        "app.plugin.js",
-        "LICENSE",
-        "CHANGELOG.md",
-        "generated",
-        "expo-module.config.json",
-        "README.md",
-        "package.json",
-        "*.podspec",
-        "prebuilt",
-        "build",
-        "!ios/build",
-        "!android/build",
-        "!android/gradle",
-        "!android/gradlew",
-        "!android/gradlew.bat",
-        "!android/local.properties",
-        "!**/__tests__",
-        "!**/__fixtures__",
-        "!**/__mocks__",
-        "!**/.*"
-    ],
-    "scripts": {
-        "build:wasm": "bash scripts/build-wasm.sh",
-        "build": "rimraf build && yarn build:types && yarn build:cjs && yarn build:esm && yarn build:plugin && cp -r prebuilt/ build/cjs/prebuilt && cp -r prebuilt/ build/esm/prebuilt",
-        "build:cjs": "tsc -p tsconfig.cjs.json",
-        "build:esm": "tsc -p tsconfig.esm.json",
-        "build:types": "tsc -p tsconfig.types.json",
-        "build:plugin": "tsc --project plugin/tsconfig.json && cp plugin/build/index.js plugin/build/index.cjs",
-        "build:plugin:dev": "expo-module build plugin",
-        "build:dev": "expo-module build",
-        "clean": "expo-module clean && rimraf build plugin/build",
-        "lint": "expo-module lint",
-        "lint:fix": "expo-module lint --fix",
-        "test": "expo-module test",
-        "test:android": "yarn test:android:unit && yarn test:android:instrumented",
-        "test:android:unit": "cd ../../apps/playground/android && ./gradlew :siteed-audio-studio:test",
-        "test:android:instrumented": "cd ../../apps/playground/android && ./gradlew :siteed-audio-studio:connectedAndroidTest",
-        "test:android:unit:watch": "cd ../../apps/playground/android && ./gradlew :siteed-audio-studio:test --continuous",
-        "test:ios": "cd ../../apps/playground/ios && xcodebuild -workspace AudioDevPlayground.xcworkspace -scheme AudioDevPlayground -destination 'platform=iOS Simulator,name=iPhone 15' build",
-        "test:coverage": "cd ../../apps/playground/android && ./gradlew :siteed-audio-studio:jacocoTestReport",
-        "typecheck": "tsc --noEmit",
-        "docgen": "typedoc src/index.ts --plugin typedoc-plugin-markdown --readme none --out ../../documentation_site/docs/api-reference/API && node ../../scripts/escape-mdx-generics.js ../../documentation_site/docs/api-reference",
-        "prepare": "yarn build && node -e \"require('fs').renameSync('./plugin/build/index.d.ts', './plugin/build/index.d.cts')\"",
-        "prepublishOnly.disabled": "expo-module prepublishOnly",
-        "expo-module": "expo-module",
-        "open:ios": "open -a \"Xcode\" ../../apps/playground/ios",
-        "open:android": "open -a \"Android Studio\" ../../apps/playground/android",
-        "size": "bundle-size && size-limit",
-        "release": "./publish.sh",
-        "agent:test:unit": "yarn test:android:unit",
-        "agent:test:integration": "yarn test:android:instrumented",
-        "agent:compilation:check": "yarn typecheck && yarn build"
-    },
-    "devDependencies": {
-        "@expo/config-plugins": "~54.0.0",
-        "@expo/npm-proofread": "^1.0.1",
-        "@siteed/publisher": "^0.4.18",
-        "@size-limit/preset-big-lib": "^11.1.4",
-        "@types/jest": "^29.5.12",
-        "@types/node": "^20.12.7",
-        "@types/react": "~19.0.10",
-        "@typescript-eslint/eslint-plugin": "^7.7.0",
-        "@typescript-eslint/parser": "^7.7.0",
-        "bundle-size": "^1.1.5",
-        "eslint": "^8.56.0",
-        "eslint-config-prettier": "^9.1.0",
-        "eslint-config-universe": "^12.0.0",
-        "eslint-plugin-import": "^2.29.1",
-        "eslint-plugin-prettier": "^5.1.3",
-        "eslint-plugin-promise": "^6.1.1",
-        "eslint-plugin-react": "^7.34.1",
-        "expo": "^54.0.0",
-        "expo-module-scripts": "^4.1.7",
-        "expo-modules-core": "~3.0.0",
-        "jest": "^29.7.0",
-        "prettier": "^3.2.5",
-        "react": "19.2.0",
-        "react-native": "0.83.6",
-        "rimraf": "^6.0.1",
-        "size-limit": "^11.1.4",
-        "ts-node": "^10.9.2",
-        "typedoc": "^0.27.4",
-        "typedoc-plugin-markdown": "~4.4.2",
-        "typescript": "~5.8.3"
-    },
-    "peerDependencies": {
-        "@expo/config-plugins": ">=7.0.0",
-        "expo": ">=52.0.0",
-        "react": "*",
-        "react-native": "*"
-    },
-    "publishConfig": {
-        "access": "public",
-        "registry": "https://registry.npmjs.org"
-    }
-}
+  "name": "@siteed/audio-studio",
+  "version": "3.2.0",
+  "description": "Comprehensive audio processing library for React Native and Expo with recording, analysis, visualization, and streaming capabilities across iOS, Android, and web",
+  "license": "MIT",
+  "type": "commonjs",
+  "main": "./build/cjs/index.js",
+  "module": "./build/esm/index.js",
+  "types": "./build/types/index.d.ts",
+  "expo": {
+    "plugin": "./app.plugin.js"
+  },
+  "author": "Arthur Breton <abreton@siteed.net> (https://github.com/deeeed)",
+  "homepage": "https://github.com/deeeed/audiolab/blob/main/packages/audio-studio/README.md",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deeeed/audiolab.git",
+    "directory": "packages/audio-studio"
+  },
+  "bugs": {
+    "url": "https://github.com/deeeed/audiolab/issues"
+  },
+  "keywords": [
+    "react-native",
+    "expo",
+    "audio",
+    "recording",
+    "audio-analysis",
+    "audio-processing",
+    "audio-visualization",
+    "waveform",
+    "spectrogram",
+    "mel-spectrogram",
+    "mfcc",
+    "audio-features",
+    "audio-compression",
+    "opus",
+    "aac",
+    "pcm",
+    "wav",
+    "cross-platform",
+    "background-recording",
+    "audio-trimming",
+    "dual-stream"
+  ],
+  "files": [
+    "src",
+    "android",
+    "ios",
+    "cpp",
+    "plugin",
+    "app.plugin.js",
+    "LICENSE",
+    "CHANGELOG.md",
+    "generated",
+    "expo-module.config.json",
+    "README.md",
+    "package.json",
+    "*.podspec",
+    "prebuilt",
+    "build",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!ios/AudioStudioTests",
+    "!ios/AudioStudioTests/**",
+    "!ios/tests",
+    "!ios/tests/**",
+    "!android/src/androidTest",
+    "!android/src/androidTest/**",
+    "!android/src/test",
+    "!android/src/test/**",
+    "!android/src/test/resources",
+    "!android/src/test/resources/**",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "build:wasm": "bash scripts/build-wasm.sh",
+    "build": "rimraf build && yarn build:types && yarn build:cjs && yarn build:esm && yarn build:plugin && cp -r prebuilt/ build/cjs/prebuilt && cp -r prebuilt/ build/esm/prebuilt",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:types": "tsc -p tsconfig.types.json",
+    "build:plugin": "tsc --project plugin/tsconfig.json && cp plugin/build/index.js plugin/build/index.cjs",
+    "build:plugin:dev": "expo-module build plugin",
+    "build:dev": "expo-module build",
+    "clean": "expo-module clean && rimraf build plugin/build",
+    "lint": "expo-module lint",
+    "lint:fix": "expo-module lint --fix",
+    "test": "expo-module test",
+    "test:android": "yarn test:android:unit && yarn test:android:instrumented",
+    "test:android:unit": "cd ../../apps/playground/android && ./gradlew :siteed-audio-studio:test",
+    "test:android:instrumented": "cd ../../apps/playground/android && ./gradlew :siteed-audio-studio:connectedAndroidTest",
+    "test:android:unit:watch": "cd ../../apps/playground/android && ./gradlew :siteed-audio-studio:test --continuous",
+    "test:ios": "cd ../../apps/playground/ios && xcodebuild -workspace AudioDevPlayground.xcworkspace -scheme AudioDevPlayground -destination 'generic/platform=iOS Simulator' build",
+    "test:coverage": "cd ../../apps/playground/android && ./gradlew :siteed-audio-studio:jacocoTestReport",
+    "typecheck": "tsc --noEmit",
+    "docgen": "typedoc src/index.ts --plugin typedoc-plugin-markdown --readme none --out ../../documentation_site/docs/api-reference/API && node ../../scripts/escape-mdx-generics.js ../../documentation_site/docs/api-reference",
+    "prepare": "yarn build && node -e \"require('fs').renameSync('./plugin/build/index.d.ts', './plugin/build/index.d.cts')\"",
+    "prepublishOnly.disabled": "expo-module prepublishOnly",
+    "expo-module": "expo-module",
+    "open:ios": "open -a \"Xcode\" ../../apps/playground/ios",
+    "open:android": "open -a \"Android Studio\" ../../apps/playground/android",
+    "size": "bundle-size && size-limit",
+    "release": "./publish.sh",
+    "agent:test:unit": "yarn test:android:unit",
+    "agent:test:integration": "yarn test:android:instrumented",
+    "agent:compilation:check": "yarn typecheck && yarn build",
+    "android": "cd ../../apps/playground && yarn android",
+    "android:launch": "cd ../../apps/playground && yarn android:launch",
+    "validate:stream-long": "node scripts/validate-stream-long.mjs",
+    "android:device": "cd ../../apps/playground && yarn android:device",
+    "android:device:launch": "cd ../../apps/playground && yarn android:device:launch",
+    "summarize:stream-long": "node scripts/summarize-stream-long.mjs"
+  },
+  "devDependencies": {
+    "@expo/config-plugins": "~54.0.0",
+    "@expo/npm-proofread": "^1.0.1",
+    "@siteed/publisher": "^0.4.18",
+    "@size-limit/preset-big-lib": "^11.1.4",
+    "@types/jest": "^29.5.12",
+    "@types/node": "^20.12.7",
+    "@types/react": "~19.0.10",
+    "@typescript-eslint/eslint-plugin": "^7.7.0",
+    "@typescript-eslint/parser": "^7.7.0",
+    "bundle-size": "^1.1.5",
+    "eslint": "^8.56.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-config-universe": "^12.0.0",
+    "eslint-plugin-import": "^2.29.1",
+    "eslint-plugin-prettier": "^5.1.3",
+    "eslint-plugin-promise": "^6.1.1",
+    "eslint-plugin-react": "^7.34.1",
+    "expo": "^54.0.0",
+    "expo-module-scripts": "^4.1.7",
+    "expo-modules-core": "~3.0.0",
+    "jest": "^29.7.0",
+    "prettier": "^3.2.5",
+    "react": "19.2.0",
+    "react-native": "0.83.6",
+    "rimraf": "^6.0.1",
+    "size-limit": "^11.1.4",
+    "ts-jest": "^29.2.6",
+    "ts-node": "^10.9.2",
+    "typedoc": "^0.27.4",
+    "typedoc-plugin-markdown": "~4.4.2",
+    "typescript": "~5.8.3"
+  },
+  "peerDependencies": {
+    "@expo/config-plugins": ">=7.0.0",
+    "expo": ">=52.0.0",
+    "react": "*",
+    "react-native": "*"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  }
+}

package/scripts/README.md

@@ -0,0 +1,58 @@
+# Test Scripts
+
+This directory contains unified test scripts for expo-audio-studio.
+
+## run_tests.sh
+
+A unified test runner that can execute tests for both Android and iOS platforms.
+
+### Usage
+
+```bash
+./scripts/run_tests.sh [platform] [type]
+```
+
+### Parameters
+
+- **platform**: Which platform to test
+  - `all` (default) - Run tests for both platforms
+  - `android` - Run Android tests only
+  - `ios` - Run iOS tests only
+
+- **type**: Which type of tests to run
+  - `all` (default) - Run all test types
+  - `unit` - Run unit tests (Android only)
+  - `instrumented` - Run instrumented tests (Android only)
+  - `standalone` - Run standalone Swift tests (iOS only)
+
+### Examples
+
+```bash
+# Run all tests for both platforms
+./scripts/run_tests.sh
+
+# Run Android tests only
+./scripts/run_tests.sh android
+
+# Run Android unit tests only
+./scripts/run_tests.sh android unit
+
+# Run iOS tests only
+./scripts/run_tests.sh ios
+
+# Run all tests explicitly
+./scripts/run_tests.sh all all
+```
+
+### Requirements
+
+- **Android**: Requires Android SDK and a connected device/emulator for instrumented tests
+- **iOS**: Requires Swift compiler (comes with Xcode)
+
+### Output
+
+The script provides colored output:
+- 🧪 Test execution progress
+- ✅ Success messages in green
+- ❌ Failure messages in red
+- Summary of tests passed/failed 

package/src/errors/AudioStreamError.test.ts

@@ -11,13 +11,18 @@ describe('AudioStreamError', () => {
     })
 
     it('maps native FILE_NOT_FOUND code', () => {
-        const mapped = mapStreamError({ code: 'FILE_NOT_FOUND', message: 'gone' })
+        const mapped = mapStreamError({
+            code: 'FILE_NOT_FOUND',
+            message: 'gone',
+        })
         expect(mapped.code).toBe('ERR_AUDIO_STREAM_FILE_NOT_FOUND')
         expect(mapped.recoverable).toBe(false)
     })
 
     it('maps unsupported codec text', () => {
-        const mapped = mapStreamError(new Error('No suitable codec for audio/opus'))
+        const mapped = mapStreamError(
+            new Error('No suitable codec for audio/opus')
+        )
         expect(mapped.code).toBe('ERR_AUDIO_STREAM_UNSUPPORTED_FORMAT')
     })
 
@@ -30,11 +35,33 @@ describe('AudioStreamError', () => {
         expect(mapped.recoverable).toBe(true)
     })
 
+    it('maps backpressure timeout as recoverable', () => {
+        const mapped = mapStreamError({
+            code: 'ERR_AUDIO_STREAM_BACKPRESSURE_TIMEOUT',
+            message: 'ack timed out',
+        })
+        expect(mapped.code).toBe('ERR_AUDIO_STREAM_BACKPRESSURE_TIMEOUT')
+        expect(mapped.recoverable).toBe(true)
+    })
+
     it('falls back to UNKNOWN', () => {
         const mapped = mapStreamError({})
         expect(mapped.code).toBe('ERR_AUDIO_STREAM_UNKNOWN')
     })
 
+    it('warns when native returns an unknown audio stream code', () => {
+        const warn = jest.spyOn(console, 'warn').mockImplementation(() => {})
+        const mapped = mapStreamError({
+            code: 'ERR_AUDIO_STREAM_FOOBAR',
+            message: 'new native code',
+        })
+        expect(mapped.code).toBe('ERR_AUDIO_STREAM_UNKNOWN')
+        expect(warn).toHaveBeenCalledWith(
+            '[AudioStreamError] Unknown native audio stream error code: ERR_AUDIO_STREAM_FOOBAR'
+        )
+        warn.mockRestore()
+    })
+
     it('preserves nativeCode and nativeMessage', () => {
         const mapped = mapStreamError({
             code: 'WEIRD_NATIVE_CODE',

package/src/errors/AudioStreamError.ts

@@ -80,6 +80,14 @@ function getNativeCode(err: unknown): string | undefined {
     return undefined
 }
 
+function isUnknownAudioStreamCode(raw: string | undefined): boolean {
+    if (!raw) return false
+    return (
+        raw.toUpperCase().startsWith('ERR_AUDIO_STREAM_') &&
+        normalizeCode(raw) === null
+    )
+}
+
 function normalizeCode(raw: string | undefined): AudioStreamErrorCode | null {
     if (!raw) return null
     const upper = raw.toUpperCase()
@@ -151,6 +159,12 @@ export function mapStreamError(
     const nativeCode = getNativeCode(err)
     const lower = nativeMessage.toLowerCase()
 
+    if (isUnknownAudioStreamCode(nativeCode)) {
+        console.warn(
+            `[AudioStreamError] Unknown native audio stream error code: ${nativeCode}`
+        )
+    }
+
     let code =
         normalizeCode(nativeCode) ??
         normalizeCode(nativeMessage) ??