@dittolive/ditto 4.8.2-rc.1 → 4.8.3

package/node/ditto.cjs.js

@@ -108,6 +108,8 @@ class Observer {
 }
 Observer.finalizationRegistry = new FinalizationRegistry(Observer.finalize);
 
+const isWebBuild = false;
+
 //
 // Copyright © 2021 DittoLive Incorporated. All rights reserved.
 //
@@ -118,6 +120,8 @@ const privateToken$1 = Symbol('privateConstructorToken');
 /**
  * Represents a CRDT counter that can be upserted as part of a document or
  * assigned to a property during an update of a document.
+ *
+ * Not available in React Native environments.
  */
 class Counter {
     /** The value of the counter. */
@@ -156,6 +160,8 @@ class MutableCounter extends Counter {
      * {@link PendingCursorOperation.update | PendingCursorOperation.update()} and
      * {@link PendingIDSpecificOperation.update | PendingIDSpecificOperation.update()},
      * otherwise an exception is thrown.
+     *
+     * @throws {Error} when called in a React Native environment.
      */
     increment(amount) {
         const mutDoc = this.mutDoc;
@@ -189,6 +195,8 @@ const privateToken = '@ditto.ff82dae89821c5ab822a8b539056bce4';
 /**
  * Represents a CRDT register that can be upserted as part of a document or
  * assigned to a property during an update of a document.
+ *
+ * Not available in React Native environments.
  */
 class Register {
     /** Returns the value of the register. */
@@ -216,15 +224,24 @@ class Register {
  * updating a document.
  *
  * This class can't be instantiated directly, it's returned automatically for
- * any register property of a document within an update block via {@link MutableDocumentPath.register}.
+ * any register property of a document within an update block via
+ * {@link MutableDocumentPath.register}.
+ *
+ * Not available in React Native environments.
  */
 class MutableRegister extends Register {
-    /** Returns the value of the register. */
+    /**
+     * Returns the value of the register.
+     *
+     * Not available in React Native environments.
+     */
     get value() {
         return super.value;
     }
     /**
      * Convenience setter, equivalent to {@link set | set()}.
+     *
+     * Not available in React Native environments.
      */
     set value(value) {
         this.set(value);
@@ -236,6 +253,8 @@ class MutableRegister extends Register {
      * {@link PendingCursorOperation.update | PendingCursorOperation.update()} and
      * {@link PendingIDSpecificOperation.update | PendingIDSpecificOperation.update()},
      * otherwise an exception is thrown.
+     *
+     * Not available in React Native environments.
      */
     set(value) {
         const mutableDocument = this['@ditto.mutableDocument'];
@@ -438,8 +457,6 @@ function refCStringToString(...args) { return ditto.refCStringToString(...args)
 function setDeadlockTimeout$1(...args) { return ditto.setDeadlockTimeout(...args) }
 function withOutBoxCBytes(...args) { return ditto.withOutBoxCBytes(...args) }
 
-const isWebBuild = false;
-
 //
 // Copyright © 2023 DittoLive Incorporated. All rights reserved.
 //
@@ -2233,7 +2250,7 @@ class AttachmentToken {
 
 // NOTE: this is patched up with the actual build version by Jake task
 // build:package and has to be a valid semantic version as defined here: https://semver.org.
-const fullBuildVersionString = '4.8.2-rc.1';
+const fullBuildVersionString = '4.8.3';
 
 //
 // Copyright © 2021 DittoLive Incorporated. All rights reserved.
@@ -2383,7 +2400,7 @@ class Logger {
      * callbacks.
      *
      * @throws {TypeError} if `callback` is not a function or `undefined`.
-     * @throws {Error} if called in a React Native environment.
+     * @throws {Error} when called in a React Native environment.
      */
     static async setCustomLogCallback(callback) {
         if (callback != null && typeof callback !== 'function') {
@@ -4319,6 +4336,8 @@ function checkForUnsupportedValues(jsObj) {
  *   - `set`
  *   - `removed`
  *   - `incremented`
+ *
+ * Not available in React Native environments.
  */
 class UpdateResult {
     // ----------------------------------------------------------- Internal ------
@@ -4623,6 +4642,8 @@ class KeyPath {
  * type. You don't create a `DocumentPath` directly but obtain one via the
  * {@link Document.path | path} property or the {@link Document.at | at()}
  * method of {@link Document}.
+ *
+ * Not available in React Native environments.
  */
 class DocumentPath {
     /**
@@ -4643,6 +4664,8 @@ class DocumentPath {
      *    - `documentPath.at('passengers[2]')`
      *    - `documentPath.at('passengers[2].belongings[1].kind')`
      *    - `documentPath.at('.mileage')`
+     *
+     * @throws {Error} when called in a React Native environment.
      */
     at(keyPathOrIndex) {
         if (typeof keyPathOrIndex === 'string') {
@@ -4662,6 +4685,8 @@ class DocumentPath {
     /**
      * Traverses the document with the key-path represented by the receiver and
      * returns the corresponding object or value.
+     *
+     * @throws {Error} when called in a React Native environment.
      */
     get value() {
         return this.underlyingValueForPathType('Any');
@@ -4669,6 +4694,8 @@ class DocumentPath {
     /**
      * Returns the value at the previously specified key in the document as a
      * {@link Counter} if possible, otherwise returns `null`.
+     *
+     * @throws {Error} when called in a React Native environment.
      */
     get counter() {
         const underlyingValue = this.underlyingValueForPathType('Counter');
@@ -4677,6 +4704,8 @@ class DocumentPath {
     /**
      * Returns the value at the previously specified key in the document as a
      * {@link Register} if possible, otherwise returns `null`.
+     *
+     * @throws {Error} when called in a React Native environment.
      */
     get register() {
         const underlyingValue = this.underlyingValueForPathType('Register');
@@ -4685,6 +4714,8 @@ class DocumentPath {
     /**
      * Returns the value at the previously specified key in the document as an
      * {@link AttachmentToken} if possible, otherwise returns `null`.
+     *
+     * @throws {Error} when called in a React Native environment.
      */
     get attachmentToken() {
         const underlyingValue = this.underlyingValueForPathType('Attachment');
@@ -4710,6 +4741,8 @@ class DocumentPath {
  * a specific key-path. You don't create a `MutableDocumentPath` directly but
  * obtain one via the {@link MutableDocument.path | path} property or the
  * {@link MutableDocument.at | at()} method of {@link MutableDocument}.
+ *
+ * Not available in React Native environments.
  */
 class MutableDocumentPath {
     /**
@@ -4730,6 +4763,8 @@ class MutableDocumentPath {
      *    - `mutableDocumentPath.at('passengers[2]')`
      *    - `mutableDocumentPath.at('passengers[2].belongings[1].kind')`
      *    - `mutableDocumentPath.at('.mileage')`
+     *
+     * @throws {Error} when called in a React Native environment.
      */
     at(keyPathOrIndex) {
         if (typeof keyPathOrIndex === 'string') {
@@ -4749,6 +4784,8 @@ class MutableDocumentPath {
     /**
      * Traverses the document with the key-path represented by the receiver and
      * returns the corresponding object or value.
+     *
+     * @throws {Error} when called in a React Native environment.
      */
     get value() {
         return this.underlyingValueForPathType('Any');
@@ -4756,6 +4793,8 @@ class MutableDocumentPath {
     /**
      * Returns the value at the previously specified key in the document as a
      * {@link MutableCounter} if possible, otherwise returns `null`.
+     *
+     * @throws {Error} when called in a React Native environment.
      */
     get counter() {
         const underlyingValue = this.underlyingValueForPathType('Counter');
@@ -4764,6 +4803,8 @@ class MutableDocumentPath {
     /**
      * Returns the value at the previously specified key in the document as a
      * {@link MutableRegister} if possible, otherwise returns `null`.
+     *
+     * @throws {Error} when called in a React Native environment.
      */
     get register() {
         const underlyingValue = this.underlyingValueForPathType('Register');
@@ -4772,6 +4813,8 @@ class MutableDocumentPath {
     /**
      * Returns the value at the previously specified key in the document as a
      * {@link AttachmentToken} if possible, otherwise returns `null`.
+     *
+     * @throws {Error} when called in a React Native environment.
      */
     get attachmentToken() {
         const underlyingValue = this.underlyingValueForPathType('Attachment');
@@ -4784,12 +4827,16 @@ class MutableDocumentPath {
      * default value. Set this to `true` if you want to set a default value that
      * you expect to be overwritten by other devices in the network. The default
      * value is `false`.
+     *
+     * @throws {Error} when called in a React Native environment.
      */
     set(value, isDefault) {
         return this['@ditto.set'](value, isDefault);
     }
     /**
      * Removes a value at the document's key-path defined by the receiver.
+     *
+     * @throws {Error} when called in a React Native environment.
      */
     remove() {
         return this['@ditto.remove']();
@@ -4876,10 +4923,16 @@ class MutableDocumentPath {
 // the object is inspected with console.log() or util.inspect().
 const CUSTOM_INSPECT_SYMBOL$1 = Symbol.for('nodejs.util.inspect.custom');
 // -----------------------------------------------------------------------------
-/** A document belonging to a {@link Collection} with an inner value. */
+/**
+ * A document belonging to a {@link Collection} with an inner value.
+ *
+ * Not available in React Native environments.
+ */
 class Document {
     /**
      * Returns a hash that represents the passed in document(s).
+     *
+     * @throws {Error} when called in a React Native environment.
      */
     static hash(documentOrMany) {
         const documents = documentsFrom(documentOrMany);
@@ -4889,6 +4942,8 @@ class Document {
     /**
      * Returns a pattern of words that together create a mnemonic, which
      * represents the passed in document(s).
+     *
+     * @throws {Error} when called in a React Native environment.
      */
     static hashMnemonic(documentOrMany) {
         const documents = documentsFrom(documentOrMany);
@@ -4897,6 +4952,8 @@ class Document {
     }
     /**
      * Returns the document ID.
+     *
+     * @throws {Error} when called in a React Native environment.
      */
     get id() {
         let id = this['@ditto.id'];
@@ -4910,6 +4967,8 @@ class Document {
     }
     /**
      * Returns the document path at the root of the document.
+     *
+     * @throws {Error} when called in a React Native environment.
      */
     get path() {
         return new DocumentPath(this, '', false);
@@ -4918,6 +4977,8 @@ class Document {
      * Convenience property, same as calling `path.value`. The value is cached on
      * first access and returned on subsequent calls without calling `path.value`
      * again.
+     *
+     * @throws {Error} when called in a React Native environment.
      */
     get value() {
         let value = this['@ditto.value'];
@@ -4929,6 +4990,8 @@ class Document {
     }
     /**
      * Convenience method, same as calling `path.at()`.
+     *
+     * @throws {Error} when called in a React Native environment.
      */
     at(keyPathOrIndex) {
         return this.path.at(keyPathOrIndex);
@@ -4978,10 +5041,14 @@ class Document {
  * `MutableDocument` directly but rather through the `update()` methods of
  * {@link PendingCursorOperation.update | PendingCursorOperation} and
  * {@link PendingIDSpecificOperation.update | PendingIDSpecificOperation}.
+ *
+ * Not available in React Native environments.
  */
 class MutableDocument {
     /**
      * Returns the ID of the document.
+     *
+     * @throws {Error} when called in a React Native environment.
      */
     get id() {
         let id = this['@ditto.id'];
@@ -4995,18 +5062,24 @@ class MutableDocument {
     }
     /**
      * Returns the document path at the root of the document.
+     *
+     * @throws {Error} when called in a React Native environment.
      */
     get path() {
         return new MutableDocumentPath(this, '', false);
     }
     /**
      * Convenience property, same as `path.value`.
+     *
+     * @throws {Error} when called in a React Native environment.
      */
     get value() {
         return this.path.value;
     }
     /**
      * Convenience method, same as calling `path.at()`.
+     *
+     * @throws {Error} when called in a React Native environment.
      */
     at(keyPathOrIndex) {
         return this.path.at(keyPathOrIndex);
@@ -5062,6 +5135,8 @@ function documentsFrom(documentOrMany) {
  * {@link UpdateResult | update results}. This is the data structure you get
  * when {@link PendingCursorOperation.update | updating} a set of documents
  * with detailed info about the performed updates.
+ *
+ * Not available in React Native environments.
  */
 class UpdateResultsMap {
     /**
@@ -5106,6 +5181,9 @@ class UpdateResultsMap {
 //
 // Copyright © 2023 DittoLive Incorporated. All rights reserved.
 //
+/**
+ * Not available in React Native environments.
+ */
 class BasePendingCursorOperation {
     /**
      * Sorts the documents that match the query provided in the preceding
@@ -5119,6 +5197,7 @@ class BasePendingCursorOperation {
      * @param direction Specify whether you want the sorting order to be
      * `ascending` or `descending`. Defaults to `ascending`.
      *
+     * @throws {Error} when called in a React Native environment.
      * @return A cursor that you can chain further function calls and then either
      * get the matching documents immediately or get updates about them over time.
      */
@@ -5141,6 +5220,7 @@ class BasePendingCursorOperation {
      * @param offset The number of matching documents that you want the eventual
      * resulting set of matching documents to be offset by (and thus not include).
      *
+     * @throws {Error} when called in a React Native environment.
      * @return A cursor that you can chain further function calls and then either
      * get the matching documents immediately or get updates about them over time.
      */
@@ -5164,6 +5244,7 @@ class BasePendingCursorOperation {
      *
      * @param limit The maximum number of documents that will be returned.
      *
+     * @throws {Error} when called in a React Native environment.
      * @return A cursor that you can chain further function calls and then either
      * get the matching documents immediately or get updates about them over time.
      */
@@ -5185,6 +5266,7 @@ class BasePendingCursorOperation {
      * Executes the query generated by the preceding function chaining and return
      * the list of matching documents.
      *
+     * @throws {Error} when called in a React Native environment.
      * @returns An array promise containing {@link Document | documents} matching
      * the query generated by the preceding function chaining.
      */
@@ -5288,11 +5370,14 @@ class BasePendingCursorOperation {
  * return value, or chain calls to update, evict or remove the document.
  *
  * Live queries and subscriptions are only available outside of a transaction.
+ *
+ * Not available in React Native environments.
  */
 class BasePendingIDSpecificOperation {
     /**
      * Executes the find operation to return the document with the matching ID.
      *
+     * @throws {Error} when called in a React Native environment.
      * @returns The {@link Document} promise with the ID provided in the
      * {@link Collection.findByID | findByID()} call or `undefined` if the document was
      * not found.
@@ -6220,6 +6305,11 @@ class AttachmentFetcher {
  * While {@link Subscription} objects remain in scope they ensure that
  * documents in the collection specified and that match the query provided will
  * try to be kept up-to-date with the latest changes from remote peers.
+ *
+ * This class is used by Ditto's query builder APIs.
+ * @see {@link SyncSubscription} for the DQL equivalent.
+ *
+ * Not available in React Native environments.
  */
 class Subscription {
     /**
@@ -6273,6 +6363,8 @@ class Subscription {
 /**
  * First event fired immediately after registering a live query without any
  * mutations. All subsequent events are of type {@link LiveQueryEventUpdate}.
+ *
+ * Not available in React Native environments.
  */
 class LiveQueryEventInitial {
     constructor() {
@@ -6308,11 +6400,14 @@ class LiveQueryEventInitial {
 /**
  * Represents an update event describing all changes that occured for documents
  * covered by a (live) query.
+ *
+ * Not available in React Native environments.
  */
 class LiveQueryEventUpdate {
     /**
      * Returns a hash that represents the set of matching documents.
      *
+     * @throws {Error} when called in a React Native environment.
      * @deprecated use {@link Document.hash | Document.hash()} instead.
      */
     hash(documents) {
@@ -6324,6 +6419,7 @@ class LiveQueryEventUpdate {
      * Returns a pattern of words that together create a mnemonic, which
      * represents the set of matching documents.
      *
+     * @throws {Error} when called in a React Native environment.
      * @deprecated use {@link Document.hashMnemonic | Document.hashMnemonic()} instead.
      */
     hashMnemonic(documents) {
@@ -6395,6 +6491,8 @@ class SingleDocumentLiveQueryEvent {
  * your event handler be called when there is an update to a document matching
  * the query you provide. When you no longer want to receive updates about
  * documents matching a query then you must call {@link stop | stop()}.
+ *
+ * Not available in React Native environments.
  */
 class LiveQuery {
     /** The name of the collection that the live query is based on. */
@@ -6407,6 +6505,8 @@ class LiveQuery {
     }
     /**
      * Stop the live query from delivering updates.
+     *
+     * @throws {Error} when called in a React Native environment.
      */
     stop() {
         if (!this.isStopped) {
@@ -6495,6 +6595,8 @@ class LiveQuery {
  * preceding `find`-like call.
  *
  * Update and remove functionality is also exposed through this object.
+ *
+ * Not available in React Native environments.
  */
 class PendingCursorOperation extends BasePendingCursorOperation {
     sort(propertyPath, direction = 'ascending') {
@@ -6558,6 +6660,8 @@ class PendingCursorOperation extends BasePendingCursorOperation {
      * The returned {@link Subscription} object must be kept in scope for as long
      * as you want to keep receiving updates.
      *
+     * @throws {Error} when called in a React Native environment.
+     *
      * @returns A {@link Subscription} object that must be kept in scope for as
      * long as you want to keep receiving updates for documents that match the
      * query specified in the preceding chain.
@@ -6588,6 +6692,8 @@ class PendingCursorOperation extends BasePendingCursorOperation {
      * transaction committed to the store that involves modifications to documents
      * matching the query in the collection this method was called on.
      *
+     * @throws {Error} when called in a React Native environment.
+     *
      * @return A {@link LiveQuery} object that must be kept in scope for as long
      * as you want to keep receiving updates.
      */
@@ -6617,6 +6723,8 @@ class PendingCursorOperation extends BasePendingCursorOperation {
      * documents matching the query in the collection that this method was called
      * on.
      *
+     * @throws {Error} when called in a React Native environment.
+     *
      * @return A {@link LiveQuery} object that must be kept in scope for as long
      * as you want to keep receiving updates.
      */
@@ -6668,6 +6776,8 @@ class PendingCursorOperation extends BasePendingCursorOperation {
  * {@link Collection.findByID | findByID()} call.
  *
  * Update and remove functionality is also exposed through this object.
+ *
+ * Not available in React Native environments.
  */
 class PendingIDSpecificOperation extends BasePendingIDSpecificOperation {
     async remove() {
@@ -6722,6 +6832,8 @@ class PendingIDSpecificOperation extends BasePendingIDSpecificOperation {
      * The returned {@link Subscription} object must be kept in scope for as long
      * as you want to keep receiving updates.
      *
+     * @throws {Error} when called in a React Native environment.
+     *
      * @returns A {@link Subscription} object that must be kept in scope for as
      * long as you want to keep receiving updates for the document.
      */
@@ -6749,6 +6861,8 @@ class PendingIDSpecificOperation extends BasePendingIDSpecificOperation {
      * document with the relevant ID in the collection that
      * {@link PendingIDSpecificOperation.observeLocal | observeLocal()} was called on.
      *
+     * @throws {Error} when called in a React Native environment.
+     *
      * @returns A {@link LiveQuery} object that must be kept in scope for as long
      * as you want to keep receiving updates.
      */
@@ -6775,6 +6889,8 @@ class PendingIDSpecificOperation extends BasePendingIDSpecificOperation {
      * document with the relevant ID in the collection that
      * {@link PendingIDSpecificOperation.observeLocal | observeLocal()} was called on.
      *
+     * @throws {Error} when called in a React Native environment.
+     *
      * @returns A {@link LiveQuery} object that must be kept in scope for as long
      * as you want to keep receiving updates.
      */
@@ -6836,6 +6952,8 @@ class PendingIDSpecificOperation extends BasePendingIDSpecificOperation {
  * querying a collection. You can get a collection by calling
  * {@link Store.collection | collection()} on a {@link Store} of a {@link Ditto}
  * object.
+ *
+ * Not available in React Native environments.
  */
 class Collection {
     /**
@@ -6856,6 +6974,7 @@ class Collection {
      * Find more information about the query string format in the documentation's
      * section on {@link https://docs.ditto.live/javascript/common/concepts/querying Querying}
      *
+     * @throws {Error} when called in a React Native environment.
      * @param query The query to run against the collection.
      * @param queryArgs The arguments to use to replace placeholders in the
      * provided query.
@@ -6878,6 +6997,7 @@ class Collection {
      * remove or evict the document.
      *
      * @param id The ID of the document to find.
+     * @throws {Error} when called in a React Native environment.
      */
     findByID(id) {
         const documentID = id instanceof DocumentID ? id : new DocumentID(id);
@@ -6918,9 +7038,10 @@ class Collection {
      *
      * @param pathOrData The path to the file that you want to create an
      * attachment with or the raw data.
-     *
      * @param metadata Metadata relating to the attachment.
      *
+     * @throws {Error} when called in a React Native environment.
+     *
      * @deprecated Use {@link Store.newAttachment | ditto.store.newAttachment() }
      * instead.
      */
@@ -6961,10 +7082,11 @@ class Collection {
      *
      * @param token The {@link AttachmentToken} relevant to the attachment that
      * you wish to download and observe. Throws if token is invalid.
-     *
      * @param eventHandler An optional callback that will be called when there is
      * an update to the status of the attachment fetch attempt.
      *
+     * @throws {Error} when called in a React Native environment.
+     *
      * @return An `AttachmentFetcher` object, which must be kept alive for the
      * fetch request to proceed and for you to be notified about the attachment's
      * fetch status changes.
@@ -7149,6 +7271,8 @@ class StoreObserver {
  * the collections that were previously known about in the previous event, along
  * with information about what collections have been inserted, deleted, updated,
  * or moved since the last event.
+ *
+ * Not available in React Native environments.
  */
 class CollectionsEvent {
     /** @internal */
@@ -7196,6 +7320,8 @@ class CollectionsEvent {
  * A subscription, established by calling {@link subscribe | subscribe()}, will
  * act as a signal to other peers that the device connects to that you would
  * like to receive updates from them about the collections that they know about.
+ *
+ * Not available in React Native environments.
  */
 class PendingCollectionsOperation {
     /**
@@ -7207,6 +7333,8 @@ class PendingCollectionsOperation {
      * @param direction Specify whether you want the sorting order to be
      * `Ascending` or `Descending`.
      *
+     * @throws {Error} when called in a React Native environment.
+     *
      * @return A {@link PendingCollectionsOperation} that you can chain further
      * function calls to.
      */
@@ -7227,6 +7355,8 @@ class PendingCollectionsOperation {
      * @param offset The number of collections that you want the eventual
      * resulting set of collections to be offset by (and thus not include).
      *
+     * @throws {Error} when called in a React Native environment.
+     *
      * @return A {@link PendingCollectionsOperation} that you can chain further
      * function calls to.
      */
@@ -7241,6 +7371,8 @@ class PendingCollectionsOperation {
      *
      * @param limit The maximum number of collections that will be returned.
      *
+     * @throws {Error} when called in a React Native environment.
+     *
      * @return A {@link PendingCollectionsOperation} that you can chain further
      * function calls to.
      */
@@ -7257,6 +7389,8 @@ class PendingCollectionsOperation {
      * The returned {@link Subscription} object must be kept in scope for as long
      * as you want to keep receiving updates.
      *
+     * @throws {Error} when called in a React Native environment.
+     *
      * @return A {@link Subscription} object that must be kept in scope for as
      * long as you want to keep receiving updates from other devices about the
      * collections that they know about.
@@ -7279,6 +7413,8 @@ class PendingCollectionsOperation {
      * @param handler A closure that will be called every time there is an update
      * about the list of known about collections.
      *
+     * @throws {Error} when called in a React Native environment.
+     *
      * @return A {@link LiveQuery} object that must be kept in scope for as long
      * as you want to keep receiving updates.
      */
@@ -7300,6 +7436,8 @@ class PendingCollectionsOperation {
      * @param handler A closure that will be called every time there is an update
      * about the list of known about collections.
      *
+     * @throws {Error} when called in a React Native environment.
+     *
      * @return A {@link LiveQuery} object that must be kept in scope for as long
      * as you want to keep receiving updates.
      */
@@ -7310,6 +7448,8 @@ class PendingCollectionsOperation {
      * Return the list of collections requested based on the preceding function
      * chaining.
      *
+     * @throws {Error} when called in a React Native environment.
+     *
      * @return A list of {@link Collection}s based on the preceding function
      * chaining.
      */
@@ -7392,6 +7532,8 @@ function collectionsFromDocuments(documents, store) {
  * or evicting any matching documents.
  *
  * Live queries and subscriptions are only available outside of transactions.
+ *
+ * Not available in React Native environments.
  */
 class WriteTransactionPendingCursorOperation extends BasePendingCursorOperation {
     sort(propertyPath, direction = 'ascending') {
@@ -7509,6 +7651,8 @@ class WriteTransactionPendingIDSpecificOperation extends BasePendingIDSpecificOp
  *
  * Create a `WriteTransactionCollection` by starting a {@link WriteTransaction}
  * and using its `scoped` method.
+ *
+ * Not available in React Native environments.
  */
 class WriteTransactionCollection {
     /**
@@ -7520,6 +7664,7 @@ class WriteTransactionCollection {
      * @param query The query to run against the collection.
      * @param queryArgs These arguments replace placeholders in the provided
      * query.
+     * @throws {Error} when called in a React Native environment.
      */
     find(query, queryArgs) {
         return new WriteTransactionPendingCursorOperation(query, queryArgs !== null && queryArgs !== void 0 ? queryArgs : null, this);
@@ -7527,6 +7672,8 @@ class WriteTransactionCollection {
     /**
      * Convenience method, equivalent to calling {@link find | find()} and passing
      * the query `"true"`.
+     *
+     * @throws {Error} when called in a React Native environment.
      */
     findAll() {
         return this.find('true');
@@ -7538,6 +7685,7 @@ class WriteTransactionCollection {
      * The returned object can be used to find and return the document. It can also be used to update, remove or evict the document.
      *
      * @param id The ID of the document to find.
+     * @throws {Error} when called in a React Native environment.
      */
     findByID(id) {
         const documentID = id instanceof DocumentID ? id : new DocumentID(id);
@@ -7594,6 +7742,8 @@ class WriteTransaction {
      * provided to this function. You can create many
      * {@link WriteTransactionCollection | collection} objects per
      * {@link WriteTransaction} object.
+     *
+     * @throws {Error} when called in a React Native environment.
      * */
     scoped(toCollectionNamed) {
         if (typeof toCollectionNamed !== 'string') {
@@ -7779,6 +7929,8 @@ class Store {
      * * it is not empty
      * * it does not contain the char '\0'
      * * it does not begin with "$TS_"
+     *
+     * @throws {Error} when called in a React Native environment.
      */
     collection(name) {
         return new Collection(name, this);
@@ -7789,6 +7941,8 @@ class Store {
      *
      * @return A {@link PendingCollectionsOperation} object that you can use to
      * fetch or observe the collections in the store
+     *
+     * @throws {Error} when called in a React Native environment.
      */
     collections() {
         return new PendingCollectionsOperation(this);
@@ -7796,6 +7950,8 @@ class Store {
     /**
      * Returns the names of all available collections in the store of the
      * related {@link Ditto} instance.
+     *
+     * @throws {Error} when called in a React Native environment.
      */
     collectionNames() {
         return this.ditto.deferClose((dittoHandle) => {
@@ -7856,6 +8012,7 @@ class Store {
      * Allows you to group multiple operations together that affect multiple documents, potentially across multiple collections.
      *
      * @param callback is given access to a {@link WriteTransaction | write transaction object} that can be used to perform operations on the store.
+     * @throws {Error} when called in a React Native environment.
      * @returns a list of `WriteTransactionResult`s. There is a result for each operation performed as part of the write transaction.
      */
     async write(callback) {
@@ -8823,7 +8980,7 @@ class Sync {
     /** @internal */
     constructor(ditto) {
         /**
-         * All currently active sync subscriptions.
+         * All currently active {@link SyncSubscription | sync subscriptions}.
          *
          * **Note:** Manage sync subscriptions using
          * {@link registerSubscription | registerSubscription()} to register a new
@@ -9748,7 +9905,7 @@ class Ditto {
      * disables this behavior, thus allowing the use of an interactive debugger
      * without triggering the deadlock detection.
      *
-     * This feature is not available in the browser.
+     * This feature is only available in Node.js environments.
      */
     static disableDeadlockDetection() {
         {
@@ -9770,8 +9927,8 @@ class Ditto {
      * {@link Ditto.disableDeadlockDetection | Ditto.disableDeadlockDetection()}
      * for more information.
      *
-     * This method always returns `false` in the browser where deadlock detection
-     * is not available.
+     * When called outside of a Node.js environment, this method always returns
+     * `false` as deadlock detection is only available in Node.js.
      *
      * @returns `true` if deadlock detection is enabled
      */
@@ -10042,7 +10199,8 @@ class Ditto {
      * This improves performance of initial sync when this peer has never before
      * connected to a Ditto mesh for which sync with v3 peers is disabled.
      *
-     * @throws {Error} if called in a React Native environment.
+     * @throws {Error} when called in a React Native environment where sync with v3
+     * is always disabled.
      */
     async disableSyncWithV3() {
         return this.deferCloseAsync(async (dittoHandle) => {