Skip to content

Commit 55b6bed

Browse files
docs: fix v1.0 versioned snapshot and bump native SDK to 3.3.3
Remove v1.1 content that leaked into the frozen v1.0 docs and update v1.1 compatibility/release notes for Couchbase Lite Enterprise 3.3.3.
1 parent b343f01 commit 55b6bed

10 files changed

Lines changed: 14 additions & 120 deletions

File tree

docs/ProductNotes/compatibility.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ sidebar_position: 2
99
Supported iOS and Android versions are dependent on React Native. See the [React Native Documentation](https://github.com/reactwg/react-native-releases/blob/main/docs/support.md) documentation for more information.
1010
:::
1111

12-
The cbl-reactnative library is built against Couchbase Lite Enterprise for iOS and Android. Version 1.1 uses Couchbase Lite Android Enterprise 3.3.0 and Couchbase Lite Swift Enterprise 3.3.1.
12+
The cbl-reactnative library is built against Couchbase Lite Enterprise for iOS and Android. Version 1.1 uses Couchbase Lite Android Enterprise 3.3.3 and Couchbase Lite Swift Enterprise 3.3.3.
1313

1414
Version 1.1 supports [React Native New Architecture](https://reactnative.dev/architecture/overview) through TurboModules. Apps should use React Native 0.76.3 or higher and enable New Architecture for the TurboModule path.
1515

docs/ProductNotes/release-notes.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,7 @@ New Features:
1515
- `FileSystem.getFilesInDirectory(path)` API for listing files in a directory, useful when discovering generated log files.
1616

1717
Improvements and Fixes:
18+
- Updated Couchbase Lite Android and iOS Enterprise SDKs to 3.3.3.
1819
- Improved listener reliability for collection, query, and replicator events on the New Architecture event path.
1920
- Replicator event payloads now include error fields where applicable.
2021
- Document expiration handling now supports clearing expiration with `null` and uses stricter UTC ISO-8601 parsing.

versioned_docs/version-1.0/DataSync/remote-sync-gateway.md

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -506,10 +506,6 @@ await replicator.start();
506506

507507
1. The callback should follow the semantics of a [pure function](https://en.wikipedia.org/wiki/Pure_function). Otherwise, long running functions would slow down the replicator considerably.
508508

509-
:::note Version 1.1
510-
Android replication filters now support JavaScript arrow functions in the V8 evaluation path.
511-
:::
512-
513509
##### Pull Filter
514510

515511
The pull filter gives an app the ability to validate documents being pulled, and skip ones that fail. This is an important security mechanism in a peer-to-peer topology with peers that are not fully trusted.

versioned_docs/version-1.0/ProductNotes/compatibility.md

Lines changed: 1 addition & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -9,11 +9,7 @@ sidebar_position: 2
99
Supported iOS and Android versions are dependent on React Native. See the [React Native Documentation](https://github.com/reactwg/react-native-releases/blob/main/docs/support.md) documentation for more information.
1010
:::
1111

12-
The cbl-reactnative library is built against Couchbase Lite Enterprise for iOS and Android. Version 1.1 uses Couchbase Lite Android Enterprise 3.3.0 and Couchbase Lite Swift Enterprise 3.3.1.
13-
14-
Version 1.1 supports React Native New Architecture through TurboModules. Apps should use React Native 0.76.3 or higher and enable New Architecture for the TurboModule path.
15-
16-
To see the compatibility notes for the native SDK, see the following documentation:
12+
The cbl-reactnative library is build against the native SDK for iOS and Android. The current version of the native SDK is 3.2.0. To see the compatibility notes for the native SDK, see the following documentation:
1713

1814
- [Couchbase Mobile Compatibility Guide - iOS](https://docs.couchbase.com/couchbase-lite/current/swift/supported-os.html).
1915

versioned_docs/version-1.0/ProductNotes/release-notes.md

Lines changed: 4 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -5,35 +5,6 @@ sidebar_position: 1
55

66
# Release Notes
77

8-
**1.1.0** (June 2026)
9-
10-
New Features:
11-
- Official React Native New Architecture / TurboModule support for iOS and Android native modules.
12-
- Improved file logging: React Native wrapper diagnostics can now be forwarded into configured file and custom log sinks.
13-
- React Native-originated log lines are prefixed with `RN ::LEVEL::` so they are easy to distinguish from native Couchbase Lite log output.
14-
- `LogSinks.write()` API for writing app-authored messages into the Couchbase Lite logging pipeline.
15-
- `FileSystem.getFilesInDirectory(path)` API for listing files in a directory, useful when discovering generated log files.
16-
17-
Improvements and Fixes:
18-
- Improved listener reliability for collection, query, and replicator events on the New Architecture event path.
19-
- Replicator event payloads now include error fields where applicable.
20-
- Document expiration handling now supports clearing expiration with `null` and uses stricter UTC ISO-8601 parsing.
21-
- Delete operations using `ConcurrencyControl.FAIL_ON_CONFLICT` now honor revision IDs more consistently.
22-
- Android replicator filters can use JavaScript arrow functions in the V8 evaluation path.
23-
24-
Repository Updates:
25-
- Main React Native repository: [couchbase/couchbase-lite-react-native](https://github.com/couchbase/couchbase-lite-react-native)
26-
- Shared JavaScript library repository: [couchbase/couchbase-lite-js-common](https://github.com/couchbase/couchbase-lite-js-common)
27-
28-
Migration from 1.0.x:
29-
- Existing application-level APIs remain largely compatible.
30-
- Enable React Native New Architecture to use the TurboModule implementation.
31-
- Review logging setup if you want React Native wrapper logs included in file or custom log sinks.
32-
33-
See [Migration Guide](../Guides/Migration/v1.1.md) for detailed instructions.
34-
35-
---
36-
378
**1.0.0** (December 2025)
389

3910
New Features:
@@ -75,14 +46,14 @@ See [Migration Guide](../Guides/Migration/v1.md) for detailed instructions.
7546
---
7647

7748
**0.6.3**
78-
- Array handling and improve blob data validation in DataAdapter [null-pointer issue](https://github.com/couchbase/couchbase-lite-react-native/pull/73)
49+
- Array handling and improve blob data validation in DataAdapter [null-pointer issue](https://github.com/Couchbase-Ecosystem/cbl-reactnative/pull/73)
7950
- Fix a crash caused by improper handling of encryption key
8051

8152
**0.6.1**
82-
- Implemented [Collection Change Listeners](https://github.com/couchbase/couchbase-lite-react-native/pull/54) on Android
83-
- Implemented [Query Change Listeners](https://github.com/couchbase/couchbase-lite-react-native/pull/55) on Android
53+
- Implemented [Collection Change Listeners](https://github.com/Couchbase-Ecosystem/cbl-reactnative/pull/54) on Android
54+
- Implemented [Query Change Listeners](https://github.com/Couchbase-Ecosystem/cbl-reactnative/pull/55) on Android
8455
- Fixed data adapter issues and improved testing
85-
- Fixed [issue](https://github.com/couchbase/couchbase-lite-react-native/issues/38) related to collection `getDocument` always pulling blob content
56+
- Fixed [issue](https://github.com/Couchbase-Ecosystem/cbl-reactnative/issues/38) related to collection `getDocument` always pulling blob content
8657

8758
**0.5.0**
8859
- Implemented Collection Document Change

versioned_docs/version-1.0/Queries/live-queries.md

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -44,10 +44,6 @@ const token: ListenerToken = await query.addChangeListener((change) => {
4444
Change listeners now return a `ListenerToken` object with a `remove()` method for cleanup.
4545
:::
4646

47-
:::note Version 1.1
48-
Live query listeners use the TurboModule typed event path on New Architecture builds. This improves listener routing and cleanup consistency across iOS and Android.
49-
:::
50-
5147
#### Example 2. Stopping a Live Query - Change Listener
5248

5349
```typescript

versioned_docs/version-1.0/StartHere/install.md

Lines changed: 2 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ sidebar_position: 2
55
# Install
66

77
:::note
8-
This Native Module is currently under active development. If you find problems, please open an issue on the [GitHub repo](https://github.com/couchbase/couchbase-lite-react-native/issues).
8+
This Native Module is currently under active development. If you find problems, please open an issue on the [GitHub repo](https://github.com/Couchbase-Ecosystem/cbl-reactnative/issues).
99
:::
1010

1111
:::note
@@ -16,8 +16,6 @@ The version of this Native Module is based on supporting Couchbase Lite Enterpri
1616

1717
The setup for using the Couchbase Lite React Native Native Module is a bit more involved than a typical React Native project. This is because the Native Module is a wrapper around the Couchbase Lite SDKs for iOS and Android. The Couchbase Lite SDKs are written in Swift and Kotlin, respectively, and are not directly compatible with JavaScript. The Native Module provides a bridge between the two languages.
1818

19-
Version 1.1 supports React Native New Architecture through TurboModules. In React Native and Expo development builds, enable New Architecture when you want to use the TurboModule implementation.
20-
2119
The installation for the Native Module is provided in two sections: one section for standard React Native apps and one for Expo based apps.
2220

2321
### React Native Based Apps
@@ -42,9 +40,7 @@ cd ..
4240

4341
#### Android
4442

45-
For React Native New Architecture builds, make sure `newArchEnabled=true` is set in your Android project configuration.
46-
47-
If your app needs manual Gradle wiring, update the Android Gradle file to include the native module. This can be done by editing the build.gradle file in the android directory of your React native app and adding the following line below the apply plugin line for the com.facebook.react.rootproject:
43+
In the current beta release, the Android Gradle file needs to be updated manually to include the native module. This can be done by editing the build.gradle file in the android directory of your React native app and adding the following line below the apply plugin line for the com.facebook.react.rootproject:
4844

4945
```kotlin
5046
apply from: "../node_modules/cbl-reactnative/android/build.gradle"
@@ -158,16 +154,6 @@ When completed, the `expo` section of your app.json file should look something l
158154

159155
You can now build your expo app locally on iOS and Android. The native module will be included in the build.
160156

161-
For Expo development builds using version 1.1, enable New Architecture in `app.json`:
162-
163-
```json
164-
{
165-
"expo": {
166-
"newArchEnabled": true
167-
}
168-
}
169-
```
170-
171157
iOS:
172158
```bash
173159
npx expo run:ios

versioned_docs/version-1.0/StartHere/prerequisties.md

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -5,14 +5,13 @@ sidebar_position: 1
55

66
# Prerequisites
77

8-
Couchbase Lite for React Native is provided as a [Native Module](https://reactnative.dev/docs/native-modules-intro).
8+
Couchbase Lite for React Native is provided as a [Native Module](https://reactnative.dev/docs/legacy/native-modules-intro).
99

10-
The Native Module can be found at the following repository: [Couchbase Lite for React Native](https://github.com/couchbase/couchbase-lite-react-native). Shared TypeScript and JavaScript code lives in [couchbase-lite-js-common](https://github.com/couchbase/couchbase-lite-js-common).
10+
The Native Module can be found at the following repository [Couchbase Lite for React Native](https://github.com/Couchbase-Ecosystem/cbl-reactnative). This plugin is actively developed and maintained by the community. It is not an official Couchbase product.
1111

1212
A developer using this plugin should have a basic understanding of the following technologies:
1313
- [React Native](https://reactnative.dev/)
14-
- [React Native - Native Modules](https://reactnative.dev/docs/native-modules-intro)
15-
- [React Native - New Architecture](https://reactnative.dev/architecture/overview)
14+
- [React Native - Native Modules](https://reactnative.dev/docs/legacy/native-modules-intro)
1615
- [Expo Framework](https://docs.expo.dev/)
1716
- [Couchbase Lite](https://docs.couchbase.com/couchbase-lite/current/index.html)
1817

@@ -24,7 +23,6 @@ React Native's recommmendation is to use [Expo](https://reactnative.dev/blog/202
2423

2524
## React Native Version
2625
- The plugin is built using React Native 0.76.3. Support for older versions of React Native is not guaranteed and apps should be based on 0.76.3 or higher.
27-
- Version 1.1 supports TurboModules through React Native New Architecture. Apps should enable New Architecture when using the TurboModule implementation.
2826

2927
Please review the React Native [Support documentation](https://github.com/reactwg/react-native-releases/blob/main/docs/support.md) for a full listed of supported platform versions.
3028

versioned_docs/version-1.0/Troubleshooting/using-logs.md

Lines changed: 0 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -34,8 +34,6 @@ Log output is split into the following streams:
3434

3535
Version 1.0 introduces the Log Sink API which provides three types of log sinks for flexible logging control.
3636

37-
Version 1.1 improves file logging by forwarding React Native wrapper diagnostics into configured file and custom log sinks. These wrapper-originated lines are prefixed with `RN ::LEVEL::`, for example `RN ::DEBUG:: database_Open`, so they can be distinguished from native Couchbase Lite SDK logs.
38-
3937
### Log Levels
4038

4139
| Level | Value | Description |
@@ -125,30 +123,6 @@ When a log file reaches `maxFileSize`, it's closed and a new one is created. Old
125123
await LogSinks.setFile(null);
126124
```
127125

128-
### React Native Wrapper Logs in File Logging
129-
130-
When file logging is enabled, version 1.1 can include diagnostics from the React Native wrapper in the same log files as native Couchbase Lite logs. This helps troubleshoot issues that cross the JavaScript/native boundary, such as listener registration, database open/close calls, query execution, and replication operations.
131-
132-
Wrapper log lines use the `RN` marker:
133-
134-
```text
135-
RN ::DEBUG:: database_Open
136-
RN ::WARNING:: query_RemoveChangeListener rejected: no listener for token
137-
RN ::ERROR:: collection_Save failed
138-
```
139-
140-
The wrapper avoids forwarding sensitive payloads such as document bodies, blob contents, encryption keys, and raw filesystem paths.
141-
142-
You can use `FileSystem.getFilesInDirectory(path)` to list generated log files in the log directory:
143-
144-
```typescript
145-
import { FileSystem } from 'cbl-reactnative';
146-
147-
const fileSystem = new FileSystem();
148-
const files = await fileSystem.getFilesInDirectory(logDirectory);
149-
console.log('Log files:', files);
150-
```
151-
152126
## Custom Log Sink
153127

154128
Custom logging allows you to implement your own logging logic with a callback function.
@@ -174,22 +148,6 @@ await LogSinks.setCustom({
174148
await LogSinks.setCustom(null);
175149
```
176150

177-
## Writing App Logs to Couchbase Lite Sinks
178-
179-
Version 1.1 adds `LogSinks.write()` for writing your own application log messages into the configured Couchbase Lite logging pipeline. These messages are delivered to enabled sinks such as file, console, and custom sinks.
180-
181-
```typescript
182-
import { LogSinks, LogLevel, LogDomain } from 'cbl-reactnative';
183-
184-
await LogSinks.write(
185-
LogLevel.WARNING,
186-
LogDomain.DATABASE,
187-
'Retrying database open after transient failure'
188-
);
189-
```
190-
191-
`LogSinks.write()` accepts concrete domains such as `DATABASE`, `QUERY`, `REPLICATOR`, `NETWORK`, and `LISTENER`. `LogDomain.ALL` is for sink configuration and is not accepted for a single written log line.
192-
193151
## Using Multiple Log Sinks
194152

195153
You can enable multiple log sinks simultaneously for different purposes.

versioned_docs/version-1.0/documents.md

Lines changed: 2 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ sidebar_position: 7
66
# Documents
77

88
> Description - _Couchbase Lite Concepts - Data Model - Documents_
9-
> Related Content - [Databases](databases.md) | [Blobs](blobs.md) | [Indexing](indexes.md)
9+
> Related Content - [Databases](databases.md) | [Blobs](blobs.md) | [Indexing](indexing.md)
1010
1111
## Overview
1212

@@ -97,7 +97,7 @@ First open your database. If the database does not already exist, Couchbase Lite
9797
```typescript
9898
const myDatabase = new Database('myDatabaseName', config);
9999
```
100-
See [Databases](databases.md) for more information.
100+
See [Databases](https://cbl-reactnative.dev/databases) for more information.
101101

102102
### Create a Document
103103

@@ -442,12 +442,6 @@ const expirationDate = new Date('2024-12-31T23:59:59');
442442
await collection.setDocumentExpiration('doc123', expirationDate);
443443
```
444444

445-
In version 1.1, passing `null` clears a document's expiration. Expiration values are parsed as strict UTC ISO-8601 dates when crossing the native bridge.
446-
447-
```typescript
448-
await collection.setDocumentExpiration('doc123', null);
449-
```
450-
451445
## Purge a Document
452446

453447
Documents can be purged from the local database using the `purge` method on the collection they are stored in.
@@ -474,8 +468,6 @@ await collection.delete(doc);
474468
```
475469
Note that document deletion are replicated to Sync Gateway or Capella App Services.
476470

477-
When using `ConcurrencyControl.FAIL_ON_CONFLICT`, version 1.1 checks the document revision ID before deleting. A delete using a stale document revision rejects instead of deleting a newer revision.
478-
479471
## Document Constraints
480472

481473
Couchbase Lite APIs do not explicitly disallow the use of attributes with the underscore prefix at the top level of document. This is to facilitate the creation of documents for use either in local only mode where documents are not synced.

0 commit comments

Comments
 (0)