@dittolive/ditto 3.0.0 → 4.0.0-alpha2

package/node/ditto.cjs.js

@@ -368,7 +368,7 @@ function ditto_collection_remove(...args) { return ditto.ditto_collection_remove
 function ditto_collection_remove_query_str(...args) { return ditto.ditto_collection_remove_query_str(...args) }
 function ditto_collection_update(...args) { return ditto.ditto_collection_update(...args) }
 function ditto_collection_update_multiple(...args) { return ditto.ditto_collection_update_multiple(...args) }
-function ditto_disable_sync_with_v2(...args) { return ditto.ditto_disable_sync_with_v2(...args) }
+function ditto_disable_sync_with_v3(...args) { return ditto.ditto_disable_sync_with_v3(...args) }
 function ditto_document_free(...args) { return ditto.ditto_document_free(...args) }
 function ditto_document_get_cbor_with_path_type(...args) { return ditto.ditto_document_get_cbor_with_path_type(...args) }
 function ditto_document_id(...args) { return ditto.ditto_document_id(...args) }
@@ -463,12 +463,12 @@ function dittoAddInternalBLEServerTransport(ditto) {
         return ditto_add_internal_ble_server_transport(ditto);
     }
 }
-function BLEClientFreeHandle(handle) {
+function bleClientFreeHandle(handle) {
     {
         return ble_client_free_handle(handle);
     }
 }
-function BLEServerFreeHandle(handle) {
+function bleServerFreeHandle(handle) {
     {
         return ble_server_free_handle(handle);
     }
@@ -478,7 +478,7 @@ function dittoAddInternalMdnsTransport(ditto) {
         return ditto_add_internal_mdns_transport(ditto);
     }
 }
-function MdnsClientFreeHandle(handle) {
+function mdnsClientFreeHandle(handle) {
     {
         return mdns_client_free_handle(handle);
     }
@@ -488,26 +488,26 @@ function dittoAddInternalMdnsAdvertiser(ditto) {
         return ditto_add_internal_mdns_advertiser(ditto);
     }
 }
-function MdnsServerFreeHandle(handle) {
+function mdnsServerFreeHandle(handle) {
     {
         return mdns_server_free_handle(handle);
     }
 }
 // ------------------------------------------------------------- Document ------
 /** @internal */
-function documentSetCBORWithTimestamp(document, path, cbor, createPath, timestamp) {
+function documentSetCBORWithTimestamp(document, path, cbor, timestamp) {
     ensureInitialized();
     const pathX = bytesFromString(path);
-    const errorCode = ditto_document_set_cbor_with_timestamp(document, pathX, cbor, createPath, timestamp);
+    const errorCode = ditto_document_set_cbor_with_timestamp(document, pathX, cbor, timestamp);
     if (errorCode !== 0)
         throw new Error(errorMessage() || `ditto_document_set_cbor_with_timestamp() failed with error code: ${errorCode}`);
 }
 /** @internal */
-function documentSetCBOR(document, path, cbor, createPath) {
+function documentSetCBOR(document, path, cbor) {
     ensureInitialized();
     // NOTE: not sure if this should be async or not.
     const pathX = bytesFromString(path);
-    const errorCode = ditto_document_set_cbor(document, pathX, cbor, createPath);
+    const errorCode = ditto_document_set_cbor(document, pathX, cbor);
     if (errorCode !== 0)
         throw new Error(errorMessage() || `ditto_document_set_cbor() failed with error code: ${errorCode}`);
 }
@@ -769,10 +769,10 @@ function staticTCPClientFreeHandle(self) {
 }
 // ------------------------------------------------------ WebsocketClient ------
 /** @internal */
-function addWebsocketClient(ditto, address) {
+function addWebsocketClient(ditto, address, routingHint) {
     ensureInitialized();
     const addressBuffer = bytesFromString(address);
-    return ditto_add_websocket_client(ditto, addressBuffer);
+    return ditto_add_websocket_client(ditto, addressBuffer, routingHint);
 }
 /** @internal */
 function websocketClientFreeHandle(self) {
@@ -1151,11 +1151,11 @@ function dittoRunGarbageCollection(dittoPointer) {
     return ditto_run_garbage_collection(dittoPointer);
 }
 /** @internal */
-async function dittoDisableSyncWithV2(dittoPointer) {
+async function dittoDisableSyncWithV3(dittoPointer) {
     ensureInitialized();
-    const errorCode = await ditto_disable_sync_with_v2(dittoPointer);
+    const errorCode = await ditto_disable_sync_with_v3(dittoPointer);
     if (errorCode !== 0)
-        throw new Error(errorMessage() || `ditto_disable_sync_with_v2() failed with error code: ${errorCode}`);
+        throw new Error(errorMessage() || `ditto_disable_sync_with_v3() failed with error code: ${errorCode}`);
 }
 // ------------------------------------------------------ Hash & Mnemonic ------
 /** @internal */
@@ -1434,7 +1434,7 @@ function awdlDestroy(awdl) {
 
 // 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 = '3.0.0';
+const fullBuildVersionString = '4.0.0-alpha2';
 
 //
 /**
@@ -1471,16 +1471,16 @@ async function init(options = {}) {
 //
 /** @internal */
 class KeepAlive {
+    /** @internal */
+    get isActive() {
+        return this.intervalID !== null;
+    }
     /** @internal */
     constructor() {
         this.countsByID = {};
         this.intervalID = null;
     }
     /** @internal */
-    get isActive() {
-        return this.intervalID !== null;
-    }
-    /** @internal */
     retain(id) {
         if (typeof this.countsByID[id] === 'undefined') {
             this.countsByID[id] = 0;
@@ -1532,10 +1532,6 @@ KeepAlive.finalizationRegistry = new FinalizationRegistry(clearInterval);
  * log messages with the Ditto logging infrastructure.
  */
 class Logger {
-    // ------------------------------------------------------------ Private ------
-    constructor() {
-        throw new Error("Logger can't be instantiated, use it's static properties & methods directly instead.");
-    }
     /**
      * On Node, registers a file path where logs will be written to, whenever
      * Ditto wants to issue a log (on _top_ of emitting the log to the console).
@@ -1666,6 +1662,10 @@ class Logger {
     static verbose(message) {
         this.log('Verbose', message);
     }
+    // ------------------------------------------------------------ Private ------
+    constructor() {
+        throw new Error("Logger can't be instantiated, use it's static properties & methods directly instead.");
+    }
 }
 
 //
@@ -1821,13 +1821,6 @@ Observer.finalizationRegistry = new FinalizationRegistry(Observer.finalize);
  * `OnlineWithAuthentication` or an `Online` identity.
  */
 class Authenticator {
-    /** @internal */
-    constructor(keepAlive) {
-        this.keepAlive = keepAlive;
-        this.status = { isAuthenticated: false, userID: null };
-        this.loginSupported = false;
-        this.observerManager = new ObserverManager('AuthenticationStatusObservation', { keepAlive });
-    }
     /**
      * Log in to Ditto with a third-party token. Throws if authentication is not
      * available, which can be checked with {@link loginSupported}.
@@ -1874,6 +1867,13 @@ class Authenticator {
         return new Observer(this.observerManager, token, { stopsWhenFinalized: true });
     }
     /** @internal */
+    constructor(keepAlive) {
+        this.keepAlive = keepAlive;
+        this.status = { isAuthenticated: false, userID: null };
+        this.loginSupported = false;
+        this.observerManager = new ObserverManager('AuthenticationStatusObservation', { keepAlive });
+    }
+    /** @internal */
     '@ditto.authenticationExpiring'(number) {
         throw new Error(`Authenticator['@ditto.authenticationExpiring']() is abstract and must be implemented by subclasses.`);
     }
@@ -1885,19 +1885,6 @@ class Authenticator {
 // -----------------------------------------------------------------------------
 /** @internal */
 class OnlineAuthenticator extends Authenticator {
-    constructor(keepAlive, authClientPointer, ditto, authenticationHandler) {
-        super(keepAlive);
-        this['loginSupported'] = true;
-        this['status'] = { isAuthenticated: false, userID: null };
-        this.authClientPointer = authClientPointer;
-        this.ditto = new WeakRef(ditto);
-        this.authenticationHandler = authenticationHandler;
-        this.updateAndNotify(false);
-        // NOTE: The ownership of the auth client is transferred to us (from Ditto),
-        // so we have to free the auth client once this instance is garbage
-        // collected.
-        OnlineAuthenticator.finalizationRegistry.register(this, authClientPointer);
-    }
     async loginWithToken(token, provider) {
         await dittoAuthClientLoginWithToken(this.authClientPointer, token, provider);
     }
@@ -1915,6 +1902,19 @@ class OnlineAuthenticator extends Authenticator {
             Logger.warning('Unable to logout, related Ditto object does not exist anymore.');
         }
     }
+    constructor(keepAlive, authClientPointer, ditto, authenticationHandler) {
+        super(keepAlive);
+        this['loginSupported'] = true;
+        this['status'] = { isAuthenticated: false, userID: null };
+        this.authClientPointer = authClientPointer;
+        this.ditto = new WeakRef(ditto);
+        this.authenticationHandler = authenticationHandler;
+        this.updateAndNotify(false);
+        // NOTE: The ownership of the auth client is transferred to us (from Ditto),
+        // so we have to free the auth client once this instance is garbage
+        // collected.
+        OnlineAuthenticator.finalizationRegistry.register(this, authClientPointer);
+    }
     '@ditto.authenticationExpiring'(secondsRemaining) {
         const authenticationHandler = this.authenticationHandler;
         if (secondsRemaining > 0) {
@@ -1977,6 +1977,7 @@ const IdentityTypesRequiringOfflineLicenseToken = ['manual', 'sharedKey', 'offli
 //
 // Copyright © 2021 DittoLive Incorporated. All rights reserved.
 //
+const NO_PREFERRED_ROUTE_HINT = 0;
 /**
  * A configuration object specifying which network transports Ditto should
  * use to sync data.
@@ -2034,6 +2035,7 @@ class TransportConfig {
         };
         this.global = {
             syncGroup: 0,
+            routingHint: NO_PREFERRED_ROUTE_HINT,
         };
     }
     /**
@@ -2079,6 +2081,7 @@ class TransportConfig {
         copy.listen['tcp'] = { ...this.listen.tcp };
         copy.listen['http'] = { ...this.listen.http };
         copy.global.syncGroup = this.global.syncGroup;
+        copy.global.routingHint = this.global.routingHint;
         return copy;
     }
     /**
@@ -2580,6 +2583,18 @@ class CBOR {
 //
 /** Represents a unique identifier for a {@link Document}. */
 class DocumentID {
+    /**
+     * Returns the value of the receiver, lazily decoded from its CBOR
+     * representation if needed.
+     */
+    get value() {
+        let value = this['@ditto.value'];
+        if (typeof value === 'undefined') {
+            value = CBOR.decode(this['@ditto.cbor']);
+            this['@ditto.value'] = value;
+        }
+        return value;
+    }
     /**
      * Creates a new `DocumentID`.
      *
@@ -2618,18 +2633,6 @@ class DocumentID {
         this.isValidated = !skipValidation;
         this['@ditto.cbor'] = validatedCBOR;
     }
-    /**
-     * Returns the value of the receiver, lazily decoded from its CBOR
-     * representation if needed.
-     */
-    get value() {
-        let value = this['@ditto.value'];
-        if (typeof value === 'undefined') {
-            value = CBOR.decode(this['@ditto.cbor']);
-            this['@ditto.value'] = value;
-        }
-        return value;
-    }
     /**
      * Returns `true` if passed in `documentID` is equal to the receiver,
      * otherwise returns `false`.
@@ -2712,11 +2715,6 @@ function validateDocumentIDCBOR(idCBOR) {
  * method of {@link Collection} instead.
  */
 class Attachment {
-    /** @internal */
-    constructor(ditto, token) {
-        this.ditto = ditto;
-        this.token = token;
-    }
     /** The attachment's metadata. */
     get metadata() {
         return this.token.metadata;
@@ -2750,6 +2748,11 @@ class Attachment {
             return fs.copyFile(attachmentPath, path, fs.COPYFILE_EXCL);
         }
     }
+    /** @internal */
+    constructor(ditto, token) {
+        this.ditto = ditto;
+        this.token = token;
+    }
 }
 /** @internal */
 const attachmentBridge = new Bridge(Attachment, freeAttachmentHandle);
@@ -2792,6 +2795,26 @@ class AttachmentToken {
  * and allow you to stop an in-flight attachment fetch.
  */
 class AttachmentFetcher {
+    /**
+     * Stops fetching the associated attachment and cleans up any associated
+     * resources.
+     *
+     * Note that you are not required to call `stop()` once your attachment fetch
+     * operation has finished. The method primarily exists to allow you to cancel
+     * an attachment fetch request while it is ongoing if you no longer wish for
+     * the attachment to be made available locally to the device.
+     */
+    stop() {
+        AttachmentFetcher.stopWithContextInfo({
+            ditto: this.ditto,
+            attachmentTokenID: this.token.id,
+            cancelTokenPromise: this.cancelTokenPromise,
+        });
+    }
+    /** @internal */
+    then(onfulfilled, onrejected) {
+        return this.attachment.then(onfulfilled, onrejected);
+    }
     /** @internal */
     constructor(ditto, token, eventHandler) {
         this.ditto = ditto;
@@ -2837,26 +2860,6 @@ class AttachmentFetcher {
         };
         AttachmentFetcher.finalizationRegistry.register(this, contextInfo, contextInfo);
     }
-    /**
-     * Stops fetching the associated attachment and cleans up any associated
-     * resources.
-     *
-     * Note that you are not required to call `stop()` once your attachment fetch
-     * operation has finished. The method primarily exists to allow you to cancel
-     * an attachment fetch request while it is ongoing if you no longer wish for
-     * the attachment to be made available locally to the device.
-     */
-    stop() {
-        AttachmentFetcher.stopWithContextInfo({
-            ditto: this.ditto,
-            attachmentTokenID: this.token.id,
-            cancelTokenPromise: this.cancelTokenPromise,
-        });
-    }
-    /** @internal */
-    then(onfulfilled, onrejected) {
-        return this.attachment.then(onfulfilled, onrejected);
-    }
     static stopWithContextInfo(contextInfo) {
         // No need for synchronicity, here: we let the "stop promise", float / run
         // in a detached fashion since there is no point in awaiting the
@@ -2883,6 +2886,21 @@ AttachmentFetcher.finalizationRegistry = new FinalizationRegistry(AttachmentFetc
  * try to be kept up-to-date with the latest changes from remote peers.
  */
 class Subscription {
+    /**
+     * The name of the collection that the subscription is based on.
+     */
+    get collectionName() {
+        return this.collection.name;
+    }
+    /**
+     * Cancels a subscription and releases all associated resources.
+     */
+    cancel() {
+        if (!this.isCancelled) {
+            this['isCancelled'] = true;
+            Subscription.remove(this, this.contextInfo);
+        }
+    }
     // ----------------------------------------------------------- Internal ------
     /** @internal */
     constructor(collection, query, queryArgsCBOR, orderBys, limit, offset) {
@@ -2906,21 +2924,6 @@ class Subscription {
         };
         Subscription.add(this, this.contextInfo);
     }
-    /**
-     * The name of the collection that the subscription is based on.
-     */
-    get collectionName() {
-        return this.collection.name;
-    }
-    /**
-     * Cancels a subscription and releases all associated resources.
-     */
-    cancel() {
-        if (!this.isCancelled) {
-            this['isCancelled'] = true;
-            Subscription.remove(this, this.contextInfo);
-        }
-    }
     static add(subscription, contextInfo) {
         const dittoX = dittoBridge.pointerFor(contextInfo.ditto);
         addSubscription(dittoX, contextInfo.collectionName, contextInfo.query, contextInfo.queryArgsCBOR, contextInfo.orderBys, contextInfo.limit, contextInfo.offset);
@@ -3015,16 +3018,16 @@ const privateToken = '@ditto.ff82dae89821c5ab822a8b539056bce4';
  * assigned to a property during an update of a document.
  */
 class Register {
+    /** Returns the value of the register. */
+    get value() {
+        return this['@ditto.value'];
+    }
     /**
      * Creates a new Register that can be used as part of a document's content.
      */
     constructor(value) {
         this['@ditto.value'] = value;
     }
-    /** Returns the value of the register. */
-    get value() {
-        return this['@ditto.value'];
-    }
     /** @internal */
     static '@ditto.create'(mutableDocument, path, value) {
         const register = mutableDocument ? new MutableRegister(value, privateToken) : new Register(value);
@@ -3080,33 +3083,6 @@ class MutableRegister extends Register {
     }
 }
 
-//
-// Copyright © 2022 DittoLive Incorporated. All rights reserved.
-//
-/**
- * Represents a CRDT Replicated Growable Array (RGA).
- *
- * RGAs are deprecated and you should instead use a `Register` containing an
- * array.
- */
-class RGA {
-    /** @internal */
-    constructor(array = []) {
-        this['@ditto.value'] = array;
-    }
-    /** The array representation of the RGA. */
-    get value() {
-        return this['@ditto.value'];
-    }
-    /** @internal */
-    static '@ditto.create'(path, value) {
-        const rga = new RGA(value);
-        rga['@ditto.path'] = path;
-        rga['@ditto.value'] = value;
-        return rga;
-    }
-}
-
 //
 // Copyright © 2021 DittoLive Incorporated. All rights reserved.
 //
@@ -3119,16 +3095,6 @@ class RGA {
  *   - `incremented`
  */
 class UpdateResult {
-    /** @internal */
-    constructor(type, docID, path, value, amount) {
-        this.type = type;
-        this.docID = docID;
-        this.path = path;
-        if (value !== undefined)
-            this.value = value;
-        if (amount !== undefined)
-            this.amount = amount;
-    }
     // ----------------------------------------------------------- Internal ------
     /** @internal */
     static set(docID, path, value) {
@@ -3142,6 +3108,16 @@ class UpdateResult {
     static removed(docID, path) {
         return new UpdateResult('removed', docID, path, undefined, undefined);
     }
+    /** @internal */
+    constructor(type, docID, path, value, amount) {
+        this.type = type;
+        this.docID = docID;
+        this.path = path;
+        if (value !== undefined)
+            this.value = value;
+        if (amount !== undefined)
+            this.amount = amount;
+    }
 }
 
 //
@@ -3161,10 +3137,6 @@ function augmentJSONValue(json, mutDoc, workingPath) {
         else if (json[DittoCRDTTypeKey] === DittoCRDTType.register) {
             return Register['@ditto.create'](mutDoc, workingPath, json[DittoCRDTValueKey]);
         }
-        else if (json[DittoCRDTTypeKey] === DittoCRDTType.rga) {
-            const augmentedValue = augmentJSONValue(json[DittoCRDTValueKey], mutDoc, workingPath);
-            return RGA['@ditto.create'](workingPath, augmentedValue);
-        }
         else if (json[DittoCRDTTypeKey] === DittoCRDTType.attachment) {
             return new AttachmentToken(json);
         }
@@ -3199,12 +3171,6 @@ function desugarJSObject(jsObj, atRoot = false) {
             registerJSON[DittoCRDTValueKey] = jsObj.value;
             return registerJSON;
         }
-        else if (jsObj instanceof RGA) {
-            const rgaJSON = {};
-            rgaJSON[DittoCRDTTypeKey] = DittoCRDTType.rga;
-            rgaJSON[DittoCRDTValueKey] = desugarJSObject(jsObj.value);
-            return rgaJSON;
-        }
         else if (jsObj instanceof Attachment) {
             const attachmentJSON = {
                 _id: jsObj.token.id,
@@ -3390,11 +3356,6 @@ class KeyPath {
  * method of {@link Document}.
  */
 class DocumentPath {
-    /** @internal */
-    constructor(document, path, validate) {
-        this.document = document;
-        this.path = validate ? KeyPath.validate(path, { isInitial: true }) : path;
-    }
     /**
      * Returns a new document path instance with the passed in key-path or
      * index appended.
@@ -3452,17 +3413,6 @@ class DocumentPath {
         const underlyingValue = this.underlyingValueForPathType('Register');
         return typeof underlyingValue !== 'undefined' ? Register['@ditto.create'](null, this.path, underlyingValue) : null;
     }
-    /**
-     * Returns the value at the previously specified key in the document as an
-     * {@link RGA} if possible, otherwise returns `null`.
-     *
-     * @deprecated RGA usage should be replaced. Use arrays inside Registers
-     * instead.
-     */
-    get rga() {
-        const underlyingValue = this.underlyingValueForPathType('Rga');
-        return typeof underlyingValue !== 'undefined' ? RGA['@ditto.create'](this.path, underlyingValue) : null;
-    }
     /**
      * Returns the value at the previously specified key in the document as an
      * {@link AttachmentToken} if possible, otherwise returns `null`.
@@ -3472,6 +3422,11 @@ class DocumentPath {
         return typeof underlyingValue !== 'undefined' ? new AttachmentToken(underlyingValue) : null;
     }
     /** @internal */
+    constructor(document, path, validate) {
+        this.document = document;
+        this.path = validate ? KeyPath.validate(path, { isInitial: true }) : path;
+    }
+    /** @internal */
     underlyingValueForPathType(pathType) {
         const path = this.path;
         const document = this.document;
@@ -3488,11 +3443,6 @@ class DocumentPath {
  * {@link MutableDocument.at | at()} method of {@link MutableDocument}.
  */
 class MutableDocumentPath {
-    /** @internal */
-    constructor(mutableDocument, path, validate) {
-        this.mutableDocument = mutableDocument;
-        this.path = validate ? KeyPath.validate(path, { isInitial: true }) : path;
-    }
     /**
      * Returns a new mutable document path instance with the passed in key-path or
      * index appended.
@@ -3550,21 +3500,6 @@ class MutableDocumentPath {
         const underlyingValue = this.underlyingValueForPathType('Register');
         return typeof underlyingValue !== 'undefined' ? Register['@ditto.create'](this.mutableDocument, this.path, underlyingValue) : null;
     }
-    /**
-     * Returns the value at the previously specified key in the document as a
-     * {@link RGA} if possible, otherwise returns `null`.
-     *
-     * Note that the returned type, {@link RGA}, is deprecated and does not allow
-     * any mutation. RGAs cannot be created or mutated with this version of the
-     * SDK; they can only be read and this is for backwards compatibility reasons.
-     *
-     * @deprecated RGA usage should be replaced. Use arrays inside Registers
-     * instead.
-     */
-    get rga() {
-        const underlyingValue = this.underlyingValueForPathType('Rga');
-        return typeof underlyingValue !== 'undefined' ? RGA['@ditto.create'](this.path, underlyingValue) : null;
-    }
     /**
      * Returns the value at the previously specified key in the document as a
      * {@link AttachmentToken} if possible, otherwise returns `null`.
@@ -3586,13 +3521,16 @@ class MutableDocumentPath {
     }
     /**
      * Removes a value at the document's key-path defined by the receiver.
-     * If removing an index from an `RGA`, any subsequent indexes will be shifted
-     * left to fill the gap.
      */
     remove() {
         return this['@ditto.remove']();
     }
     /** @internal */
+    constructor(mutableDocument, path, validate) {
+        this.mutableDocument = mutableDocument;
+        this.path = validate ? KeyPath.validate(path, { isInitial: true }) : path;
+    }
+    /** @internal */
     underlyingValueForPathType(pathType) {
         const path = this.path;
         const document = this.mutableDocument;
@@ -3616,10 +3554,10 @@ class MutableDocumentPath {
         const valueJSON = desugarJSObject(value, false);
         const valueCBOR = CBOR.encode(valueJSON);
         if (isDefault) {
-            documentSetCBORWithTimestamp(documentX, this.path, valueCBOR, true, 0);
+            documentSetCBORWithTimestamp(documentX, this.path, valueCBOR, 0);
         }
         else {
-            documentSetCBOR(documentX, this.path, valueCBOR, true);
+            documentSetCBOR(documentX, this.path, valueCBOR);
         }
         // HACK: we need a copy of value because the original value can be mutated
         // later on and an update result needs the state of the value at this
@@ -3756,11 +3694,6 @@ class Document {
  * {@link PendingIDSpecificOperation.update | PendingIDSpecificOperation}.
  */
 class MutableDocument {
-    /** @internal */
-    constructor() {
-        /** @internal */
-        this['@ditto.updateResults'] = [];
-    }
     /**
      * Returns the ID of the document.
      */
@@ -3792,6 +3725,11 @@ class MutableDocument {
     at(keyPathOrIndex) {
         return this.path.at(keyPathOrIndex);
     }
+    /** @internal */
+    constructor() {
+        /** @internal */
+        this['@ditto.updateResults'] = [];
+    }
     // TEMPORARY: helpers to deal with non-canonical IDs.
     /** @internal */
     static idCBOR(mutableDocument) {
@@ -3832,6 +3770,22 @@ function documentsFrom(documentOrMany) {
  * with detailed info about the performed updates.
  */
 class UpdateResultsMap {
+    /**
+     * Returns an array of {@link UpdateResult | update results} associated with
+     * the `documentID` or undefined if not found.
+     */
+    get(documentIDOrValue) {
+        const documentID = documentIDOrValue instanceof DocumentID ? documentIDOrValue : new DocumentID(documentIDOrValue);
+        const documentIDString = documentID.toString();
+        return this.updateResultsByDocumentIDString[documentIDString];
+    }
+    /**
+     * Returns all contained keys, i.e. {@link DocumentID | document IDs}
+     * contained in this map.
+     */
+    keys() {
+        return this.documentIDs.slice();
+    }
     // ----------------------------------------------------------- Internal ------
     /** @internal */
     constructor(documentIDs, updateResultsByDocumentIDString) {
@@ -3853,22 +3807,6 @@ class UpdateResultsMap {
         this.documentIDs = documentIDs.slice();
         this.updateResultsByDocumentIDString = { ...updateResultsByDocumentIDString };
     }
-    /**
-     * Returns an array of {@link UpdateResult | update results} associated with
-     * the `documentID` or undefined if not found.
-     */
-    get(documentIDOrValue) {
-        const documentID = documentIDOrValue instanceof DocumentID ? documentIDOrValue : new DocumentID(documentIDOrValue);
-        const documentIDString = documentID.toString();
-        return this.updateResultsByDocumentIDString[documentIDString];
-    }
-    /**
-     * Returns all contained keys, i.e. {@link DocumentID | document IDs}
-     * contained in this map.
-     */
-    keys() {
-        return this.documentIDs.slice();
-    }
 }
 
 //
@@ -3905,19 +3843,6 @@ class LiveQueryEventInitial {
  * covered by a (live) query.
  */
 class LiveQueryEventUpdate {
-    /** @internal */
-    constructor(params) {
-        /**
-         * Whether or not this is the initial event being delivered. Always `false`
-         * for `LiveQueryEventUpdate`.
-         */
-        this.isInitial = false;
-        this.oldDocuments = params.oldDocuments;
-        this.insertions = params.insertions;
-        this.deletions = params.deletions;
-        this.updates = params.updates;
-        this.moves = params.moves;
-    }
     /**
      * Returns a hash that represents the set of matching documents.
      */
@@ -3931,6 +3856,19 @@ class LiveQueryEventUpdate {
     hashMnemonic(documents) {
         return documentsHashMnemonic(documents.map((doc) => documentBridge.pointerFor(doc)));
     }
+    /** @internal */
+    constructor(params) {
+        /**
+         * Whether or not this is the initial event being delivered. Always `false`
+         * for `LiveQueryEventUpdate`.
+         */
+        this.isInitial = false;
+        this.oldDocuments = params.oldDocuments;
+        this.insertions = params.insertions;
+        this.deletions = params.deletions;
+        this.updates = params.updates;
+        this.moves = params.moves;
+    }
 }
 // -----------------------------------------------------------------------------
 /**
@@ -3938,11 +3876,6 @@ class LiveQueryEventUpdate {
  * live query.
  */
 class SingleDocumentLiveQueryEvent {
-    /** @internal */
-    constructor(isInitial, oldDocument) {
-        this.isInitial = isInitial;
-        this.oldDocument = oldDocument;
-    }
     /**
      * Returns a hash that represents the set of matching documents.
      */
@@ -3956,6 +3889,11 @@ class SingleDocumentLiveQueryEvent {
     hashMnemonic(document) {
         return documentsHashMnemonic(document === null ? [] : [documentBridge.pointerFor(document)]);
     }
+    /** @internal */
+    constructor(isInitial, oldDocument) {
+        this.isInitial = isInitial;
+        this.oldDocument = oldDocument;
+    }
 }
 
 //
@@ -3974,6 +3912,28 @@ class SingleDocumentLiveQueryEvent {
  * documents matching a query then you must call {@link stop | stop()}.
  */
 class LiveQuery {
+    /** The name of the collection that the live query is based on. */
+    get collectionName() {
+        return this.collection.name;
+    }
+    /** Returns true if the receiver has been stopped. */
+    get isStopped() {
+        return this.liveQueryID === null;
+    }
+    /**
+     * Stop the live query from delivering updates.
+     */
+    stop() {
+        var _a;
+        const liveQueryID = this.liveQueryID;
+        if (liveQueryID !== null) {
+            this.collection.store.ditto.keepAlive.release(`LiveQuery.${liveQueryID}`);
+            this.liveQueryID = null;
+            const dittoPointer = dittoBridge.pointerFor(this.collection.store.ditto);
+            (_a = this.subscription) === null || _a === void 0 ? void 0 : _a.cancel();
+            liveQueryStop(dittoPointer, liveQueryID);
+        }
+    }
     /** @internal */
     constructor(query, queryArgs, queryArgsCBOR, orderBys, limit, offset, collection, subscription, handler) {
         // Query should be validated at this point.
@@ -4026,28 +3986,6 @@ class LiveQuery {
         step(async () => await liveQueryStart(dittoPointer, liveQueryID));
         collection.store.ditto.keepAlive.retain(`LiveQuery.${liveQueryID}`);
     }
-    /** The name of the collection that the live query is based on. */
-    get collectionName() {
-        return this.collection.name;
-    }
-    /** Returns true if the receiver has been stopped. */
-    get isStopped() {
-        return this.liveQueryID === null;
-    }
-    /**
-     * Stop the live query from delivering updates.
-     */
-    stop() {
-        var _a;
-        const liveQueryID = this.liveQueryID;
-        if (liveQueryID !== null) {
-            this.collection.store.ditto.keepAlive.release(`LiveQuery.${liveQueryID}`);
-            this.liveQueryID = null;
-            const dittoPointer = dittoBridge.pointerFor(this.collection.store.ditto);
-            (_a = this.subscription) === null || _a === void 0 ? void 0 : _a.cancel();
-            liveQueryStop(dittoPointer, liveQueryID);
-        }
-    }
     /** @internal */
     async signalNext() {
         // IDEA: make this public?
@@ -4084,17 +4022,6 @@ class LiveQuery {
  * Update and remove functionality is also exposed through this object.
  */
 class PendingCursorOperation {
-    // ----------------------------------------------------------- Internal ------
-    /** @internal */
-    constructor(query, queryArgs, collection) {
-        this.currentLimit = -1;
-        this.currentOffset = 0;
-        this.orderBys = [];
-        this.query = validateQuery(query);
-        this.queryArgs = queryArgs ? Object.freeze({ ...queryArgs }) : null;
-        this.collection = collection;
-        this.queryArgsCBOR = queryArgs ? CBOR.encode(queryArgs) : null;
-    }
     /**
      * Sorts the documents that match the query provided in the preceding
      * `find`-like function call.
@@ -4350,6 +4277,17 @@ class PendingCursorOperation {
             return new UpdateResultsMap(updateResultsDocumentIDs, updateResultsByDocumentIDString);
         });
     }
+    // ----------------------------------------------------------- Internal ------
+    /** @internal */
+    constructor(query, queryArgs, collection) {
+        this.currentLimit = -1;
+        this.currentOffset = 0;
+        this.orderBys = [];
+        this.query = validateQuery(query);
+        this.queryArgs = queryArgs ? Object.freeze({ ...queryArgs }) : null;
+        this.collection = collection;
+        this.queryArgsCBOR = queryArgs ? CBOR.encode(queryArgs) : null;
+    }
     /** @internal */
     _observe(handler, createSubscription, waitForNextSignal) {
         const subscription = createSubscription ? this.subscribe() : null;
@@ -4393,13 +4331,6 @@ class PendingCursorOperation {
  * Update and remove functionality is also exposed through this object.
  */
 class PendingIDSpecificOperation {
-    // ----------------------------------------------------------- Internal ------
-    /** @internal */
-    constructor(documentID, collection) {
-        this.documentID = documentID;
-        this.collection = collection;
-        this.documentIDCBOR = documentID.toCBOR();
-    }
     /**
      * Enables you to subscribe to changes that occur in relation to a document
      * remotely.
@@ -4545,6 +4476,13 @@ class PendingIDSpecificOperation {
         await writeTransactionCommit(dittoX, writeTransactionX);
         return mutableDocument['@ditto.updateResults'].slice();
     }
+    // ----------------------------------------------------------- Internal ------
+    /** @internal */
+    constructor(documentID, collection) {
+        this.documentID = documentID;
+        this.collection = collection;
+        this.documentIDCBOR = documentID.toCBOR();
+    }
     /** @internal */
     _observe(handler, createSubscription, waitForNextSignal) {
         const subscription = createSubscription ? this.subscribe() : null;
@@ -4603,11 +4541,6 @@ class PendingIDSpecificOperation {
  * object.
  */
 class Collection {
-    /** @internal */
-    constructor(name, store) {
-        this.name = name;
-        this.store = store;
-    }
     /**
      * Generates a {@link PendingCursorOperation} using the provided query.
      *
@@ -4762,6 +4695,11 @@ class Collection {
         const ditto = this.store.ditto;
         return new AttachmentFetcher(ditto, token, eventHandler);
     }
+    /** @internal */
+    constructor(name, store) {
+        this.name = name;
+        this.store = store;
+    }
     // TEMPORARY: helpers to deal with non-canonical IDs.
     /** @internal */
     findByIDCBOR(idCBOR) {
@@ -4784,16 +4722,6 @@ class Collection {
  * or moved since the last event.
  */
 class CollectionsEvent {
-    /** @internal */
-    constructor(params) {
-        this.isInitial = params.isInitial;
-        this.collections = params.collections;
-        this.oldCollections = params.oldCollections;
-        this.insertions = params.insertions;
-        this.deletions = params.deletions;
-        this.updates = params.updates;
-        this.moves = params.moves;
-    }
     /** @internal */
     static initial(collections) {
         return new CollectionsEvent({
@@ -4806,6 +4734,16 @@ class CollectionsEvent {
             moves: [],
         });
     }
+    /** @internal */
+    constructor(params) {
+        this.isInitial = params.isInitial;
+        this.collections = params.collections;
+        this.oldCollections = params.oldCollections;
+        this.insertions = params.insertions;
+        this.deletions = params.deletions;
+        this.updates = params.updates;
+        this.moves = params.moves;
+    }
 }
 
 //
@@ -4829,11 +4767,6 @@ class CollectionsEvent {
  * like to receive updates from them about the collections that they know about.
  */
 class PendingCollectionsOperation {
-    /** @internal */
-    constructor(store) {
-        this.store = store;
-        this.pendingCursorOperation = new PendingCursorOperation('true', null, new Collection('__collections', store));
-    }
     /**
      * Sort the collections based on a property of the collection.
      *
@@ -4948,24 +4881,30 @@ class PendingCollectionsOperation {
         return collectionsFromDocuments(documents, this.store);
     }
     /** @internal */
+    constructor(store) {
+        this.store = store;
+        this.pendingCursorOperation = new PendingCursorOperation('true', null, new Collection('__collections', store));
+    }
+    /** @internal */
     then(onfulfilled, onrejected) {
         return this.exec().then(onfulfilled, onrejected);
     }
     // ----------------------------------------------------------- Internal ------
     /** @internal */
     _observe(handler, createSubscription, waitForNextSignal) {
-        const weakThis = new WeakRef(this);
+        const weakStore = new WeakRef(this.store);
         const collectionsObservationHandler = function (documents, event, nextSignal) {
-            const strongThis = weakThis.deref();
-            if (strongThis === null)
+            const strongStore = weakStore.deref();
+            if (!strongStore) {
                 return;
-            const collections = collectionsFromDocuments(documents, strongThis.store);
+            }
+            const collections = collectionsFromDocuments(documents, strongStore);
             let collEvent;
             if (event.isInitial === true) {
                 collEvent = CollectionsEvent.initial(collections);
             }
             else {
-                const oldCollections = collectionsFromDocuments(event.oldDocuments, strongThis.store);
+                const oldCollections = collectionsFromDocuments(event.oldDocuments, strongStore);
                 collEvent = new CollectionsEvent({
                     isInitial: false,
                     collections,
@@ -5007,11 +4946,6 @@ function collectionsFromDocuments(documents, store) {
  * instance via its {@link Ditto.store | store} property.
  */
 class Store {
-    // ----------------------------------------------------------- Internal ------
-    /** @internal */
-    constructor(ditto) {
-        this.ditto = ditto;
-    }
     /**
      * Returns the collection for the given name. If the collection doesn't
      * exist yet, it will be created automatically as soon as the first
@@ -5037,6 +4971,11 @@ class Store {
     collectionNames() {
         return dittoGetCollectionNames(dittoBridge.pointerFor(this.ditto));
     }
+    // ----------------------------------------------------------- Internal ------
+    /** @internal */
+    constructor(ditto) {
+        this.ditto = ditto;
+    }
     /**
      * Private method, used only by the Portal https://github.com/getditto/ditto/pull/3652
      * @internal
@@ -5067,25 +5006,6 @@ function addressToString(address) {
  * instance via its `presence` property.
  */
 class Presence {
-    /** @internal */
-    constructor(ditto) {
-        this.ditto = ditto;
-        this.observerManager = new ObserverManager('PresenceObservation', {
-            keepAlive: ditto.keepAlive,
-            register: (callback) => {
-                const dittoPointer = dittoBridge.pointerFor(this.ditto);
-                dittoRegisterPresenceV3Callback(dittoPointer, callback);
-            },
-            unregister: () => {
-                const dittoPointer = dittoBridge.pointerFor(this.ditto);
-                dittoClearPresenceV3Callback(dittoPointer);
-            },
-            process: (presenceGraphJSONString) => {
-                const presenceGraph = JSON.parse(presenceGraphJSONString);
-                return [presenceGraph];
-            },
-        });
-    }
     /**
      * Returns the current presence graph capturing all known peers and
      * connections between them.
@@ -5114,6 +5034,25 @@ class Presence {
         didChangeHandler(this.graph);
         return observer;
     }
+    /** @internal */
+    constructor(ditto) {
+        this.ditto = ditto;
+        this.observerManager = new ObserverManager('PresenceObservation', {
+            keepAlive: ditto.keepAlive,
+            register: (callback) => {
+                const dittoPointer = dittoBridge.pointerFor(this.ditto);
+                dittoRegisterPresenceV3Callback(dittoPointer, callback);
+            },
+            unregister: () => {
+                const dittoPointer = dittoBridge.pointerFor(this.ditto);
+                dittoClearPresenceV3Callback(dittoPointer);
+            },
+            process: (presenceGraphJSONString) => {
+                const presenceGraph = JSON.parse(presenceGraphJSONString);
+                return [presenceGraph];
+            },
+        });
+    }
 }
 
 //
@@ -5342,8 +5281,8 @@ class Sync {
         if (shouldStop && !this.bluetoothLETransportPointer)
             throw new Error(`Internal inconsistency, when stopping BLE transport, a BLE transport pointer should exist.`);
         {
-            // HACK: quick & dirty Linux hack. A proper implementation should
-            // encapsulate everything behind the transports module. To undo,
+            // HACK: quick & dirty Linux & Windows hack. A proper implementation
+            // should encapsulate everything behind the transports module. To undo,
             // remove the whole if block.
             if (process.platform === 'linux' || process.platform === 'win32') {
                 if (shouldStart) {
@@ -5355,8 +5294,8 @@ class Sync {
                 if (shouldStop) {
                     const blePlatform = this.bluetoothLETransportPointer;
                     const { clientTransport, serverTransport } = blePlatform;
-                    BLEServerFreeHandle(serverTransport);
-                    BLEClientFreeHandle(clientTransport);
+                    bleServerFreeHandle(serverTransport);
+                    bleClientFreeHandle(clientTransport);
                     this.bluetoothLETransportPointer = null;
                 }
                 return;
@@ -5392,58 +5331,41 @@ class Sync {
             this.awdlTransportPointer = null;
         }
     }
-    startLan(newConfig, { lanStartsServer }) {
-        const dittoPointer = dittoBridge.pointerFor(this.ditto);
-        if (lanStartsServer) {
-            dittoStartTCPServer(dittoPointer, null);
-        }
-        if (newConfig.isMdnsEnabled) {
-            const clientHandle = dittoAddInternalMdnsTransport(dittoPointer);
-            this.mdnsClientTransportPointer = clientHandle;
-            const serverHandle = dittoAddInternalMdnsAdvertiser(dittoPointer);
-            this.mdnsServerAdvertiserPointer = serverHandle;
-        }
-        if (newConfig.isMulticastEnabled) {
-            dittoAddMulticastTransport(dittoPointer);
-        }
-    }
-    stopLan({ lanStopsServer }) {
-        const dittoPointer = dittoBridge.pointerFor(this.ditto);
-        if (lanStopsServer) {
-            dittoStopTCPServer(dittoPointer);
-        }
-        if (this.mdnsClientTransportPointer) {
-            MdnsClientFreeHandle(this.mdnsClientTransportPointer);
-            this.mdnsClientTransportPointer = null;
-        }
-        if (this.mdnsServerAdvertiserPointer) {
-            MdnsServerFreeHandle(this.mdnsServerAdvertiserPointer);
-            this.mdnsServerAdvertiserPointer = null;
-        }
-        dittoRemoveMulticastTransport(dittoPointer);
-    }
     updatePeerToPeerLAN(stateOld, stateNew) {
         const dittoPointer = dittoBridge.pointerFor(this.ditto);
         const lanOld = stateOld.effectiveTransportConfig.peerToPeer.lan;
         const lanNew = stateNew.effectiveTransportConfig.peerToPeer.lan;
         {
+            // HACK: quick & dirty Linux & Windows hack. A proper implementation
+            // should encapsulate everything behind the transports module. To undo,
+            // remove the whole if block.
             // FIXME: include 'linux' as well
             if (process.platform === 'win32') {
-                if (stateOld.effectiveTransportConfig.listen.tcp !== stateNew.effectiveTransportConfig.listen.tcp || lanOld !== lanNew) {
-                    this.stopLan({
-                        lanStopsServer: !stateOld.effectiveTransportConfig.listen.tcp.isEnabled,
-                    });
-                    if (lanNew.isEnabled) {
-                        this.startLan(lanNew, {
-                            lanStartsServer: !stateNew.effectiveTransportConfig.listen.tcp.isEnabled,
-                        });
+                if (lanOld.isEnabled) {
+                    if (lanOld.isMdnsEnabled) {
+                        mdnsClientFreeHandle(this.mdnsClientTransportPointer);
+                        this.mdnsClientTransportPointer = null;
+                        mdnsServerFreeHandle(this.mdnsServerAdvertiserPointer);
+                        this.mdnsServerAdvertiserPointer = null;
+                    }
+                    if (lanOld.isMulticastEnabled) {
+                        dittoRemoveMulticastTransport(dittoPointer);
+                    }
+                }
+                if (lanNew.isEnabled) {
+                    if (lanNew.isMdnsEnabled) {
+                        this.mdnsClientTransportPointer = dittoAddInternalMdnsTransport(dittoPointer);
+                        this.mdnsServerAdvertiserPointer = dittoAddInternalMdnsAdvertiser(dittoPointer);
+                    }
+                    if (lanNew.isMulticastEnabled) {
+                        dittoAddMulticastTransport(dittoPointer);
                     }
                 }
                 return;
             }
         }
         // IDEA: move the logic for this dance into stateFrom() signal
-        // via some additional state what needs to be done here?
+        // via some additional state signaling the actions here.
         if (lanOld.isEnabled) {
             if (lanOld.isMdnsEnabled) {
                 lanDestroy(this.lanTransportPointer);
@@ -5532,8 +5454,9 @@ class Sync {
             websocketURLsToDisconnectFromSet.delete(websocketURL);
         const websocketURLsToConnectTo = websocketURLsToConnectToSet.values();
         const websocketURLsToDisconnectFrom = websocketURLsToDisconnectFromSet.values();
+        const routingHint = stateNew.effectiveTransportConfig.global.routingHint;
         for (const websocketURL of websocketURLsToConnectTo) {
-            const websocketClientPointer = addWebsocketClient(dittoBridge.pointerFor(this.ditto), websocketURL);
+            const websocketClientPointer = addWebsocketClient(dittoBridge.pointerFor(this.ditto), websocketURL, routingHint);
             const websocketClient = websocketClientBridge.bridge(websocketClientPointer);
             this.websocketClientsByURL[websocketURL] = websocketClient;
         }
@@ -5604,8 +5527,7 @@ function stateFrom(parameters) {
     // TCP listening is explicitly enabled. This means we also have to stop it
     // if we started it previously due to this condition.
     if (transportConfig.peerToPeer.lan.isEnabled && !transportConfig.listen.tcp.isEnabled) {
-        // FIXME(Daniel): Having this enabled messes up with the logic of `startLan`; so let's avoid this.
-        // transportConfig.listen.tcp.isEnabled = true
+        transportConfig.listen.tcp.isEnabled = true;
         transportConfig.listen.tcp.interfaceIP = '0.0.0.0';
         transportConfig.listen.tcp.port = 0;
     }
@@ -5621,6 +5543,11 @@ function stateFrom(parameters) {
  * Ditto is the entry point for accessing Ditto-related functionality.
  */
 class Ditto {
+    /** Returns a string identifying the version of the Ditto SDK. */
+    get sdkVersion() {
+        const dittoPointer = dittoBridge.pointerFor(this);
+        return dittoGetSDKVersion(dittoPointer);
+    }
     /**
      * Initializes a new `Ditto` instance.
      *
@@ -5761,11 +5688,6 @@ class Ditto {
             this.auth['@ditto.authenticationExpiring'](secondsRemainingUntilAuthenticationExpires);
         }
     }
-    /** Returns a string identifying the version of the Ditto SDK. */
-    get sdkVersion() {
-        const dittoPointer = dittoBridge.pointerFor(this);
-        return dittoGetSDKVersion(dittoPointer);
-    }
     /**
      * Activate a `Ditto` instance by setting an offline only license token. You cannot initiate sync
      * with `Ditto` before you have activated it. The offline license token is only valid for identities
@@ -5908,16 +5830,16 @@ class Ditto {
     }
     /**
      * Explicitly opt-in to disabling the ability to sync with Ditto peers running
-     * any version of the SDK in the v2 series of releases.
+     * any version of the SDK in the v3 series of releases.
      *
      * Assuming this succeeds then this peer will only be able to sync with other
-     * peers using SDKs in the v3 series of releases. Note that this disabling of
+     * peers using SDKs in the v4 series of releases. Note that this disabling of
      * sync spreads to peers that sync with a peer that has disabled, or has
-     * (transitively) had disabled, syncing with v2 SDK peers.
+     * (transitively) had disabled, syncing with v3 SDK peers.
      */
-    disableSyncWithV2() {
+    disableSyncWithV3() {
         const dittoPointer = dittoBridge.pointerFor(this);
-        dittoDisableSyncWithV2(dittoPointer);
+        dittoDisableSyncWithV3(dittoPointer);
     }
     authClientValidityChanged(isWebValid, isX509Valid) {
         const transportConfig = this.transportConfig;
@@ -6062,7 +5984,6 @@ exports.PendingCollectionsOperation = PendingCollectionsOperation;
 exports.PendingCursorOperation = PendingCursorOperation;
 exports.PendingIDSpecificOperation = PendingIDSpecificOperation;
 exports.Presence = Presence;
-exports.RGA = RGA;
 exports.Register = Register;
 exports.SingleDocumentLiveQueryEvent = SingleDocumentLiveQueryEvent;
 exports.Store = Store;