v8.0.0: reliable upload outcomes on a New Architecture TurboModule

.github/workflows/node.yml

@@ -1,26 +1,42 @@
-name: Node Environment
+name: CI
 
 on: [push, pull_request]
 
 jobs:
-  node-lint-tests:
+  checks:
     runs-on: ubuntu-latest
     if: "!contains(github.event.head_commit.message, '[skip ci]')"
 
     steps:
-    - name: checkout
-      uses: actions/checkout@v2
-
-    - name: setup node
-      uses: actions/setup-node@v1
-      with:
-        node-version: 20
-
-    - name: install node_modules
-      run: | 
-        yarn install --frozen-lockfile
-        yarn --cwd example/RNBGUExample install --frozen-lockfile 
-
-    - name: node lint
-      run:
-        yarn lint:ci
+      - name: checkout
+        uses: actions/checkout@v4
+
+      - name: setup node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: install node_modules
+        run: |
+          yarn install --frozen-lockfile
+          yarn --cwd example/RNBGUExample install --frozen-lockfile
+
+      - name: lint
+        run: yarn lint:ci
+
+      - name: typecheck
+        run: yarn typecheck
+
+      - name: js tests
+        run: yarn test
+
+      - name: setup java
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: 17
+
+      - name: android unit tests
+        run: |
+          cd example/RNBGUExample/android
+          ./gradlew :react-native-background-upload:testDebugUnitTest

CHANGELOG.md

@@ -1,3 +1,66 @@
-Since Version > 5.3.0 we follow semantic versioning.
+## 8.0.0
 
-See the [releases](https://github.com/Vydia/react-native-background-upload/releases) page on GitHub for information regarding each release.
+Reliability release. Terminal outcomes are now durable and accurately typed, the
+iOS module was rewritten in Swift, and the module is a New Architecture
+TurboModule.
+
+Breaking:
+- **New Architecture only.** The module is now a codegen TurboModule on both
+  platforms; the legacy bridge (`RCTEventEmitter` / `RCT_EXTERN_MODULE` on iOS,
+  `ReactPackage` + `RCTDeviceEventEmitter` on Android) is gone, along with any
+  reliance on RN's legacy-interop layer. Requires React Native >= 0.84 with the
+  New Architecture enabled, and React >= 19.
+- The iOS background-session handler moved from `RNFileUploader` to
+  `RNBackgroundUpload`: `[RNBackgroundUpload setBackgroundSessionCompletionHandler:
+  forIdentifier:]`. `RNFileUploader` is now the TurboModule and is intentionally
+  unreachable from plain Objective-C (its generated header is Objective-C++ only).
+  Update the AppDelegate snippet — see README.
+- Events are delivered through the codegen event emitters rather than
+  `DeviceEventEmitter`, so they are no longer visible under the raw
+  `RNFileUploader-*` device-event names. The `Upload.addListener(...)` API is
+  unchanged.
+- `cancelUpload` on iOS now resolves `false` when no matching in-flight upload was
+  found (it previously always resolved `true`). Android still always resolves `true`.
+- Terminal event payloads are typed as the journal entry they actually are. The
+  natives emit the journaled entry itself, so `CompletedData` / `ErrorData` /
+  `CancelledData` now declare the `eventId`, `type` and `timestamp` they were always
+  sending, plus `responseBodyTruncated`. `eventId` in particular means you can
+  `ackEvents([eventId])` straight after handling a live event. `JournaledEvent` is
+  now a union discriminated on `type`.
+- `CompletedData.responseCode` and `.responseBody` are optional. They were declared
+  required but are absent when a task completes without an HTTP response, so reading
+  them unguarded could throw.
+- The `cancelled` payload no longer carries `error` (it used to hold the cancellation
+  error string). Use `cancelReason` instead.
+- iOS `progress` reports `0` instead of `-1` when the total length is unknown,
+  matching Android and the documented 0-100 range.
+- iOS `getAllUploads` reports `cancelled` and `completed` states instead of
+  collapsing everything non-running into `pending`.
+- `completed` fires only for 2xx responses (plus a request's `acceptStatus`, e.g.
+  `acceptStatus: [409]`). Every other HTTP response now emits an `error` with
+  `errorKind: 'http'` and the full response attached (previously reported as
+  `completed`).
+- `error` events are typed: `errorKind: 'http' | 'network' | 'file' | 'unknown'`.
+- Native module renamed to `RNFileUploader` on both platforms (was
+  `VydiaRNFileUploader` on iOS); Android package is now `ai.openspace.backgroundupload`.
+- iOS AppDelegate must forward `handleEventsForBackgroundURLSession` (see README).
+- Removed the committed `lib/` build output; types are served from `src`
+  (deep imports of `lib/*` break — import from the package root).
+- Minimum iOS deployment target is 15.1; minimum Android SDK is 29. Minimum React
+  Native is 0.84 (New Architecture), minimum React is 19.
+- Removed non-functional iOS code paths: multipart, `assets-library://`, and the
+  `appGroup` option (a no-op even before this — it mutated the session config after
+  creation, which URLSession ignores; also removed from the TypeScript options).
+- Removed the unexposed Android `stopAllUploads`.
+
+Added:
+- Durable native event journal: `getUnacknowledgedEvents()` / `ackEvents(ids)` —
+  terminal events survive app death and JS reloads (at-least-once delivery).
+- `getAllUploads()` on both platforms.
+- `cancelled` events carry `cancelReason: 'user' | 'system'`.
+- `responseHeaders` on completed events on iOS (was Android-only).
+- iOS progress events throttled to 500ms; UUID default upload ids.
+- Android `android` options are now optional — sensible notification defaults and
+  a library-created notification channel.
+
+Earlier releases: see the [releases](https://github.com/openspacelabs/react-native-background-upload/releases) page.

CONTRIBUTING.md

@@ -1,8 +1,5 @@
 ## Issues
 
-Along with a bug report, provide a functional example repository which
-reproduces the bug you're experiencing. We've made this very easy by providing
-a full-stack (React Native + Express.js) example app, which you can fork and
-alter to reproduce your bug:
-
-[ReactNativeBackgroundUploadExample](https://github.com/Vydia/ReactNativeBackgroundUploadExample)
+Along with a bug report, provide a functional reproduction using the full-stack
+(React Native + Express.js) example app in this repo under `example/` — fork and
+alter it to reproduce your bug.