@powersync/common 0.0.0-dev-20251209082930 → 0.0.0-dev-20260120150240

package/dist/bundle.node.cjs

@@ -581,6 +581,10 @@ class SyncStatus {
             priorityStatusEntries: this.priorityStatusEntries
         };
     }
+    /**
+     * Not all errors are serializable over a MessagePort. E.g. some `DomExceptions` fail to be passed across workers.
+     * This explicitly serializes errors in the SyncStatus.
+     */
     serializeError(error) {
         if (typeof error == 'undefined') {
             return undefined;
@@ -1945,7 +1949,7 @@ var hasRequiredFrames;
 function requireFrames () {
 	if (hasRequiredFrames) return Frames;
 	hasRequiredFrames = 1;
-	(function (exports) {
+	(function (exports$1) {
 		/*
 		 * Copyright 2021-2022 the original author or authors.
 		 *
@@ -1961,8 +1965,8 @@ function requireFrames () {
 		 * See the License for the specific language governing permissions and
 		 * limitations under the License.
 		 */
-		Object.defineProperty(exports, "__esModule", { value: true });
-		exports.Frame = exports.Lengths = exports.Flags = exports.FrameTypes = void 0;
+		Object.defineProperty(exports$1, "__esModule", { value: true });
+		exports$1.Frame = exports$1.Lengths = exports$1.Flags = exports$1.FrameTypes = void 0;
 		var FrameTypes;
 		(function (FrameTypes) {
 		    FrameTypes[FrameTypes["RESERVED"] = 0] = "RESERVED";
@@ -1981,7 +1985,7 @@ function requireFrames () {
 		    FrameTypes[FrameTypes["RESUME"] = 13] = "RESUME";
 		    FrameTypes[FrameTypes["RESUME_OK"] = 14] = "RESUME_OK";
 		    FrameTypes[FrameTypes["EXT"] = 63] = "EXT";
-		})(FrameTypes = exports.FrameTypes || (exports.FrameTypes = {}));
+		})(FrameTypes = exports$1.FrameTypes || (exports$1.FrameTypes = {}));
 		(function (Flags) {
 		    Flags[Flags["NONE"] = 0] = "NONE";
 		    Flags[Flags["COMPLETE"] = 64] = "COMPLETE";
@@ -1992,7 +1996,7 @@ function requireFrames () {
 		    Flags[Flags["NEXT"] = 32] = "NEXT";
 		    Flags[Flags["RESPOND"] = 128] = "RESPOND";
 		    Flags[Flags["RESUME_ENABLE"] = 128] = "RESUME_ENABLE";
-		})(exports.Flags || (exports.Flags = {}));
+		})(exports$1.Flags || (exports$1.Flags = {}));
 		(function (Flags) {
 		    function hasMetadata(flags) {
 		        return (flags & Flags.METADATA) === Flags.METADATA;
@@ -2026,13 +2030,13 @@ function requireFrames () {
 		        return (flags & Flags.RESUME_ENABLE) === Flags.RESUME_ENABLE;
 		    }
 		    Flags.hasResume = hasResume;
-		})(exports.Flags || (exports.Flags = {}));
+		})(exports$1.Flags || (exports$1.Flags = {}));
 		(function (Lengths) {
 		    Lengths[Lengths["FRAME"] = 3] = "FRAME";
 		    Lengths[Lengths["HEADER"] = 6] = "HEADER";
 		    Lengths[Lengths["METADATA"] = 3] = "METADATA";
 		    Lengths[Lengths["REQUEST"] = 3] = "REQUEST";
-		})(exports.Lengths || (exports.Lengths = {}));
+		})(exports$1.Lengths || (exports$1.Lengths = {}));
 		(function (Frame) {
 		    function isConnection(frame) {
 		        return frame.streamId === 0;
@@ -2043,7 +2047,7 @@ function requireFrames () {
 		            frame.type <= FrameTypes.REQUEST_CHANNEL);
 		    }
 		    Frame.isRequest = isRequest;
-		})(exports.Frame || (exports.Frame = {}));
+		})(exports$1.Frame || (exports$1.Frame = {}));
 		
 	} (Frames));
 	return Frames;
@@ -2054,7 +2058,7 @@ var hasRequiredCodecs;
 function requireCodecs () {
 	if (hasRequiredCodecs) return Codecs;
 	hasRequiredCodecs = 1;
-	(function (exports) {
+	(function (exports$1) {
 		var __generator = (Codecs && Codecs.__generator) || function (thisArg, body) {
 		    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
 		    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
@@ -2082,22 +2086,22 @@ function requireCodecs () {
 		        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
 		    }
 		};
-		Object.defineProperty(exports, "__esModule", { value: true });
-		exports.Deserializer = exports.sizeOfFrame = exports.serializeFrame = exports.deserializeFrame = exports.serializeFrameWithLength = exports.deserializeFrames = exports.deserializeFrameWithLength = exports.writeUInt64BE = exports.readUInt64BE = exports.writeUInt24BE = exports.readUInt24BE = exports.MAX_VERSION = exports.MAX_TTL = exports.MAX_STREAM_ID = exports.MAX_RESUME_LENGTH = exports.MAX_REQUEST_N = exports.MAX_REQUEST_COUNT = exports.MAX_MIME_LENGTH = exports.MAX_METADATA_LENGTH = exports.MAX_LIFETIME = exports.MAX_KEEPALIVE = exports.MAX_CODE = exports.FRAME_TYPE_OFFFSET = exports.FLAGS_MASK = void 0;
+		Object.defineProperty(exports$1, "__esModule", { value: true });
+		exports$1.Deserializer = exports$1.sizeOfFrame = exports$1.serializeFrame = exports$1.deserializeFrame = exports$1.serializeFrameWithLength = exports$1.deserializeFrames = exports$1.deserializeFrameWithLength = exports$1.writeUInt64BE = exports$1.readUInt64BE = exports$1.writeUInt24BE = exports$1.readUInt24BE = exports$1.MAX_VERSION = exports$1.MAX_TTL = exports$1.MAX_STREAM_ID = exports$1.MAX_RESUME_LENGTH = exports$1.MAX_REQUEST_N = exports$1.MAX_REQUEST_COUNT = exports$1.MAX_MIME_LENGTH = exports$1.MAX_METADATA_LENGTH = exports$1.MAX_LIFETIME = exports$1.MAX_KEEPALIVE = exports$1.MAX_CODE = exports$1.FRAME_TYPE_OFFFSET = exports$1.FLAGS_MASK = void 0;
 		var Frames_1 = requireFrames();
-		exports.FLAGS_MASK = 0x3ff; // low 10 bits
-		exports.FRAME_TYPE_OFFFSET = 10; // frame type is offset 10 bytes within the uint16 containing type + flags
-		exports.MAX_CODE = 0x7fffffff; // uint31
-		exports.MAX_KEEPALIVE = 0x7fffffff; // uint31
-		exports.MAX_LIFETIME = 0x7fffffff; // uint31
-		exports.MAX_METADATA_LENGTH = 0xffffff; // uint24
-		exports.MAX_MIME_LENGTH = 0xff; // int8
-		exports.MAX_REQUEST_COUNT = 0x7fffffff; // uint31
-		exports.MAX_REQUEST_N = 0x7fffffff; // uint31
-		exports.MAX_RESUME_LENGTH = 0xffff; // uint16
-		exports.MAX_STREAM_ID = 0x7fffffff; // uint31
-		exports.MAX_TTL = 0x7fffffff; // uint31
-		exports.MAX_VERSION = 0xffff; // uint16
+		exports$1.FLAGS_MASK = 0x3ff; // low 10 bits
+		exports$1.FRAME_TYPE_OFFFSET = 10; // frame type is offset 10 bytes within the uint16 containing type + flags
+		exports$1.MAX_CODE = 0x7fffffff; // uint31
+		exports$1.MAX_KEEPALIVE = 0x7fffffff; // uint31
+		exports$1.MAX_LIFETIME = 0x7fffffff; // uint31
+		exports$1.MAX_METADATA_LENGTH = 0xffffff; // uint24
+		exports$1.MAX_MIME_LENGTH = 0xff; // int8
+		exports$1.MAX_REQUEST_COUNT = 0x7fffffff; // uint31
+		exports$1.MAX_REQUEST_N = 0x7fffffff; // uint31
+		exports$1.MAX_RESUME_LENGTH = 0xffff; // uint16
+		exports$1.MAX_STREAM_ID = 0x7fffffff; // uint31
+		exports$1.MAX_TTL = 0x7fffffff; // uint31
+		exports$1.MAX_VERSION = 0xffff; // uint16
 		/**
 		 * Mimimum value that would overflow bitwise operators (2^32).
 		 */
@@ -2111,7 +2115,7 @@ function requireCodecs () {
 		    var val3 = buffer.readUInt8(offset + 2);
 		    return val1 | val2 | val3;
 		}
-		exports.readUInt24BE = readUInt24BE;
+		exports$1.readUInt24BE = readUInt24BE;
 		/**
 		 * Writes a uint24 to a buffer starting at the given offset, returning the
 		 * offset of the next byte.
@@ -2121,7 +2125,7 @@ function requireCodecs () {
 		    offset = buffer.writeUInt8((value >>> 8) & 0xff, offset); // 2nd byte
 		    return buffer.writeUInt8(value & 0xff, offset); // 1st byte
 		}
-		exports.writeUInt24BE = writeUInt24BE;
+		exports$1.writeUInt24BE = writeUInt24BE;
 		/**
 		 * Read a uint64 (technically supports up to 53 bits per JS number
 		 * representation).
@@ -2131,7 +2135,7 @@ function requireCodecs () {
 		    var low = buffer.readUInt32BE(offset + 4);
 		    return high * BITWISE_OVERFLOW + low;
 		}
-		exports.readUInt64BE = readUInt64BE;
+		exports$1.readUInt64BE = readUInt64BE;
 		/**
 		 * Write a uint64 (technically supports up to 53 bits per JS number
 		 * representation).
@@ -2142,7 +2146,7 @@ function requireCodecs () {
 		    offset = buffer.writeUInt32BE(high, offset); // first half of uint64
 		    return buffer.writeUInt32BE(low, offset); // second half of uint64
 		}
-		exports.writeUInt64BE = writeUInt64BE;
+		exports$1.writeUInt64BE = writeUInt64BE;
 		/**
 		 * Frame header is:
 		 * - stream id (uint32 = 4)
@@ -2160,7 +2164,7 @@ function requireCodecs () {
 		    var frameLength = readUInt24BE(buffer, 0);
 		    return deserializeFrame(buffer.slice(UINT24_SIZE, UINT24_SIZE + frameLength));
 		}
-		exports.deserializeFrameWithLength = deserializeFrameWithLength;
+		exports$1.deserializeFrameWithLength = deserializeFrameWithLength;
 		/**
 		 * Given a buffer that may contain zero or more length-prefixed frames followed
 		 * by zero or more bytes of a (partial) subsequent frame, returns an array of
@@ -2193,7 +2197,7 @@ function requireCodecs () {
 		        }
 		    });
 		}
-		exports.deserializeFrames = deserializeFrames;
+		exports$1.deserializeFrames = deserializeFrames;
 		/**
 		 * Writes a frame to a buffer with a length prefix.
 		 */
@@ -2204,7 +2208,7 @@ function requireCodecs () {
 		    buffer.copy(lengthPrefixed, UINT24_SIZE);
 		    return lengthPrefixed;
 		}
-		exports.serializeFrameWithLength = serializeFrameWithLength;
+		exports$1.serializeFrameWithLength = serializeFrameWithLength;
 		/**
 		 * Read a frame from the buffer.
 		 */
@@ -2219,8 +2223,8 @@ function requireCodecs () {
 		    // );
 		    var typeAndFlags = buffer.readUInt16BE(offset);
 		    offset += 2;
-		    var type = typeAndFlags >>> exports.FRAME_TYPE_OFFFSET; // keep highest 6 bits
-		    var flags = typeAndFlags & exports.FLAGS_MASK; // keep lowest 10 bits
+		    var type = typeAndFlags >>> exports$1.FRAME_TYPE_OFFFSET; // keep highest 6 bits
+		    var flags = typeAndFlags & exports$1.FLAGS_MASK; // keep lowest 10 bits
 		    switch (type) {
 		        case Frames_1.FrameTypes.SETUP:
 		            return deserializeSetupFrame(buffer, streamId, flags);
@@ -2257,7 +2261,7 @@ function requireCodecs () {
 		        // );
 		    }
 		}
-		exports.deserializeFrame = deserializeFrame;
+		exports$1.deserializeFrame = deserializeFrame;
 		/**
 		 * Convert the frame to a (binary) buffer.
 		 */
@@ -2296,7 +2300,7 @@ function requireCodecs () {
 		        // );
 		    }
 		}
-		exports.serializeFrame = serializeFrame;
+		exports$1.serializeFrame = serializeFrame;
 		/**
 		 * Byte size of frame without size prefix
 		 */
@@ -2335,7 +2339,7 @@ function requireCodecs () {
 		        // );
 		    }
 		}
-		exports.sizeOfFrame = sizeOfFrame;
+		exports$1.sizeOfFrame = sizeOfFrame;
 		/**
 		 * Writes a SETUP frame into a new buffer and returns it.
 		 *
@@ -2970,7 +2974,7 @@ function requireCodecs () {
 		function writeHeader(frame, buffer) {
 		    var offset = buffer.writeInt32BE(frame.streamId, 0);
 		    // shift frame to high 6 bits, extract lowest 10 bits from flags
-		    return buffer.writeUInt16BE((frame.type << exports.FRAME_TYPE_OFFFSET) | (frame.flags & exports.FLAGS_MASK), offset);
+		    return buffer.writeUInt16BE((frame.type << exports$1.FRAME_TYPE_OFFFSET) | (frame.flags & exports$1.FLAGS_MASK), offset);
 		}
 		/**
 		 * Determine the length of the payload section of a frame. Only applies to
@@ -3051,7 +3055,7 @@ function requireCodecs () {
 		    };
 		    return Deserializer;
 		}());
-		exports.Deserializer = Deserializer;
+		exports$1.Deserializer = Deserializer;
 		
 	} (Codecs));
 	return Codecs;
@@ -3197,7 +3201,7 @@ var hasRequiredErrors;
 function requireErrors () {
 	if (hasRequiredErrors) return Errors;
 	hasRequiredErrors = 1;
-	(function (exports) {
+	(function (exports$1) {
 		/*
 		 * Copyright 2021-2022 the original author or authors.
 		 *
@@ -3228,8 +3232,8 @@ function requireErrors () {
 		        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
 		    };
 		})();
-		Object.defineProperty(exports, "__esModule", { value: true });
-		exports.ErrorCodes = exports.RSocketError = void 0;
+		Object.defineProperty(exports$1, "__esModule", { value: true });
+		exports$1.ErrorCodes = exports$1.RSocketError = void 0;
 		var RSocketError = /** @class */ (function (_super) {
 		    __extends(RSocketError, _super);
 		    function RSocketError(code, message) {
@@ -3239,7 +3243,7 @@ function requireErrors () {
 		    }
 		    return RSocketError;
 		}(Error));
-		exports.RSocketError = RSocketError;
+		exports$1.RSocketError = RSocketError;
 		(function (ErrorCodes) {
 		    ErrorCodes[ErrorCodes["RESERVED"] = 0] = "RESERVED";
 		    ErrorCodes[ErrorCodes["INVALID_SETUP"] = 1] = "INVALID_SETUP";
@@ -3253,7 +3257,7 @@ function requireErrors () {
 		    ErrorCodes[ErrorCodes["CANCELED"] = 515] = "CANCELED";
 		    ErrorCodes[ErrorCodes["INVALID"] = 516] = "INVALID";
 		    ErrorCodes[ErrorCodes["RESERVED_EXTENSION"] = 4294967295] = "RESERVED_EXTENSION";
-		})(exports.ErrorCodes || (exports.ErrorCodes = {}));
+		})(exports$1.ErrorCodes || (exports$1.ErrorCodes = {}));
 		
 	} (Errors));
 	return Errors;
@@ -3295,7 +3299,7 @@ var hasRequiredClientServerMultiplexerDemultiplexer;
 function requireClientServerMultiplexerDemultiplexer () {
 	if (hasRequiredClientServerMultiplexerDemultiplexer) return ClientServerMultiplexerDemultiplexer;
 	hasRequiredClientServerMultiplexerDemultiplexer = 1;
-	(function (exports) {
+	(function (exports$1) {
 		/*
 		 * Copyright 2021-2022 the original author or authors.
 		 *
@@ -3362,8 +3366,8 @@ function requireClientServerMultiplexerDemultiplexer () {
 		        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
 		    }
 		};
-		Object.defineProperty(exports, "__esModule", { value: true });
-		exports.ResumeOkAwaitingResumableClientServerInputMultiplexerDemultiplexer = exports.ResumableClientServerInputMultiplexerDemultiplexer = exports.ClientServerInputMultiplexerDemultiplexer = exports.StreamIdGenerator = void 0;
+		Object.defineProperty(exports$1, "__esModule", { value: true });
+		exports$1.ResumeOkAwaitingResumableClientServerInputMultiplexerDemultiplexer = exports$1.ResumableClientServerInputMultiplexerDemultiplexer = exports$1.ClientServerInputMultiplexerDemultiplexer = exports$1.StreamIdGenerator = void 0;
 		var _1 = requireDist();
 		var Deferred_1 = requireDeferred();
 		var Errors_1 = requireErrors();
@@ -3386,7 +3390,7 @@ function requireClientServerMultiplexerDemultiplexer () {
 		        };
 		        return StreamIdGeneratorImpl;
 		    }());
-		})(exports.StreamIdGenerator || (exports.StreamIdGenerator = {}));
+		})(exports$1.StreamIdGenerator || (exports$1.StreamIdGenerator = {}));
 		var ClientServerInputMultiplexerDemultiplexer = /** @class */ (function (_super) {
 		    __extends(ClientServerInputMultiplexerDemultiplexer, _super);
 		    function ClientServerInputMultiplexerDemultiplexer(streamIdSupplier, outbound, closeable) {
@@ -3475,7 +3479,7 @@ function requireClientServerMultiplexerDemultiplexer () {
 		    };
 		    return ClientServerInputMultiplexerDemultiplexer;
 		}(Deferred_1.Deferred));
-		exports.ClientServerInputMultiplexerDemultiplexer = ClientServerInputMultiplexerDemultiplexer;
+		exports$1.ClientServerInputMultiplexerDemultiplexer = ClientServerInputMultiplexerDemultiplexer;
 		var ResumableClientServerInputMultiplexerDemultiplexer = /** @class */ (function (_super) {
 		    __extends(ResumableClientServerInputMultiplexerDemultiplexer, _super);
 		    function ResumableClientServerInputMultiplexerDemultiplexer(streamIdSupplier, outbound, closeable, frameStore, token, sessionStoreOrReconnector, sessionTimeout) {
@@ -3632,7 +3636,7 @@ function requireClientServerMultiplexerDemultiplexer () {
 		    };
 		    return ResumableClientServerInputMultiplexerDemultiplexer;
 		}(ClientServerInputMultiplexerDemultiplexer));
-		exports.ResumableClientServerInputMultiplexerDemultiplexer = ResumableClientServerInputMultiplexerDemultiplexer;
+		exports$1.ResumableClientServerInputMultiplexerDemultiplexer = ResumableClientServerInputMultiplexerDemultiplexer;
 		var ResumeOkAwaitingResumableClientServerInputMultiplexerDemultiplexer = /** @class */ (function () {
 		    function ResumeOkAwaitingResumableClientServerInputMultiplexerDemultiplexer(outbound, closeable, delegate) {
 		        this.outbound = outbound;
@@ -3689,7 +3693,7 @@ function requireClientServerMultiplexerDemultiplexer () {
 		    };
 		    return ResumeOkAwaitingResumableClientServerInputMultiplexerDemultiplexer;
 		}());
-		exports.ResumeOkAwaitingResumableClientServerInputMultiplexerDemultiplexer = ResumeOkAwaitingResumableClientServerInputMultiplexerDemultiplexer;
+		exports$1.ResumeOkAwaitingResumableClientServerInputMultiplexerDemultiplexer = ResumeOkAwaitingResumableClientServerInputMultiplexerDemultiplexer;
 		
 	} (ClientServerMultiplexerDemultiplexer));
 	return ClientServerMultiplexerDemultiplexer;
@@ -6675,7 +6679,7 @@ var hasRequiredDist;
 function requireDist () {
 	if (hasRequiredDist) return dist;
 	hasRequiredDist = 1;
-	(function (exports) {
+	(function (exports$1) {
 		/*
 		 * Copyright 2021-2022 the original author or authors.
 		 *
@@ -6698,19 +6702,19 @@ function requireDist () {
 		    if (k2 === undefined) k2 = k;
 		    o[k2] = m[k];
 		}));
-		var __exportStar = (dist && dist.__exportStar) || function(m, exports) {
-		    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+		var __exportStar = (dist && dist.__exportStar) || function(m, exports$1) {
+		    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports$1, p)) __createBinding(exports$1, m, p);
 		};
-		Object.defineProperty(exports, "__esModule", { value: true });
-		__exportStar(requireCodecs(), exports);
-		__exportStar(requireCommon(), exports);
-		__exportStar(requireDeferred(), exports);
-		__exportStar(requireErrors(), exports);
-		__exportStar(requireFrames(), exports);
-		__exportStar(requireRSocket(), exports);
-		__exportStar(requireRSocketConnector(), exports);
-		__exportStar(requireRSocketServer(), exports);
-		__exportStar(requireTransport(), exports);
+		Object.defineProperty(exports$1, "__esModule", { value: true });
+		__exportStar(requireCodecs(), exports$1);
+		__exportStar(requireCommon(), exports$1);
+		__exportStar(requireDeferred(), exports$1);
+		__exportStar(requireErrors(), exports$1);
+		__exportStar(requireFrames(), exports$1);
+		__exportStar(requireRSocket(), exports$1);
+		__exportStar(requireRSocketConnector(), exports$1);
+		__exportStar(requireRSocketServer(), exports$1);
+		__exportStar(requireTransport(), exports$1);
 		
 	} (dist));
 	return dist;
@@ -6718,7 +6722,7 @@ function requireDist () {
 
 var distExports = requireDist();
 
-var version = "1.43.1";
+var version = "1.45.0";
 var PACKAGE = {
 	version: version};
 
@@ -6789,6 +6793,16 @@ class DataStream extends BaseObserver {
      * @returns a Data payload or Null if the stream closed.
      */
     async read() {
+        if (this.closed) {
+            return null;
+        }
+        // Wait for any pending processing to complete first.
+        // This ensures we register our listener before calling processQueue(),
+        // avoiding a race where processQueue() sees no reader and returns early.
+        if (this.processingPromise) {
+            await this.processingPromise;
+        }
+        // Re-check after await - stream may have closed while we were waiting
         if (this.closed) {
             return null;
         }
@@ -6828,7 +6842,7 @@ class DataStream extends BaseObserver {
         }
         const promise = (this.processingPromise = this._processQueue());
         promise.finally(() => {
-            return (this.processingPromise = null);
+            this.processingPromise = null;
         });
         return promise;
     }
@@ -6860,7 +6874,6 @@ class DataStream extends BaseObserver {
             this.notifyDataAdded = null;
         }
         if (this.dataQueue.length > 0) {
-            // Next tick
             setTimeout(() => this.processQueue());
         }
     }
@@ -7480,7 +7493,11 @@ class AbstractRemote {
         };
         const stream = new DataStream({
             logger: this.logger,
-            mapLine: mapLine
+            mapLine: mapLine,
+            pressure: {
+                highWaterMark: 20,
+                lowWaterMark: 10
+            }
         });
         abortSignal?.addEventListener('abort', () => {
             closeReader();
@@ -7488,42 +7505,47 @@ class AbstractRemote {
         });
         const decoder = this.createTextDecoder();
         let buffer = '';
-        const l = stream.registerListener({
-            lowWater: async () => {
-                if (stream.closed || abortSignal?.aborted || readerReleased) {
+        const consumeStream = async () => {
+            while (!stream.closed && !abortSignal?.aborted && !readerReleased) {
+                const { done, value } = await reader.read();
+                if (done) {
+                    const remaining = buffer.trim();
+                    if (remaining.length != 0) {
+                        stream.enqueueData(remaining);
+                    }
+                    stream.close();
+                    await closeReader();
                     return;
                 }
-                try {
-                    let didCompleteLine = false;
-                    while (!didCompleteLine) {
-                        const { done, value } = await reader.read();
-                        if (done) {
-                            const remaining = buffer.trim();
-                            if (remaining.length != 0) {
-                                stream.enqueueData(remaining);
-                            }
-                            stream.close();
-                            await closeReader();
-                            return;
-                        }
-                        const data = decoder.decode(value, { stream: true });
-                        buffer += data;
-                        const lines = buffer.split('\n');
-                        for (var i = 0; i < lines.length - 1; i++) {
-                            var l = lines[i].trim();
-                            if (l.length > 0) {
-                                stream.enqueueData(l);
-                                didCompleteLine = true;
-                            }
-                        }
-                        buffer = lines[lines.length - 1];
+                const data = decoder.decode(value, { stream: true });
+                buffer += data;
+                const lines = buffer.split('\n');
+                for (var i = 0; i < lines.length - 1; i++) {
+                    var l = lines[i].trim();
+                    if (l.length > 0) {
+                        stream.enqueueData(l);
                     }
                 }
-                catch (ex) {
-                    stream.close();
-                    throw ex;
+                buffer = lines[lines.length - 1];
+                // Implement backpressure by waiting for the low water mark to be reached
+                if (stream.dataQueue.length > stream.highWatermark) {
+                    await new Promise((resolve) => {
+                        const dispose = stream.registerListener({
+                            lowWater: async () => {
+                                resolve();
+                                dispose();
+                            },
+                            closed: () => {
+                                resolve();
+                                dispose();
+                            }
+                        });
+                    });
                 }
-            },
+            }
+        };
+        consumeStream().catch(ex => this.logger.error('Error consuming stream', ex));
+        const l = stream.registerListener({
             closed: () => {
                 closeReader();
                 l?.();
@@ -7645,6 +7667,7 @@ const DEFAULT_STREAMING_SYNC_OPTIONS = {
     crudUploadThrottleMs: DEFAULT_CRUD_UPLOAD_THROTTLE_MS
 };
 const DEFAULT_STREAM_CONNECTION_OPTIONS = {
+    appMetadata: {},
     connectionMethod: exports.SyncStreamConnectionMethod.WEB_SOCKET,
     clientImplementation: DEFAULT_SYNC_CLIENT_IMPLEMENTATION,
     fetchStrategy: exports.FetchStrategy.Buffered,
@@ -8023,6 +8046,11 @@ The next upload iteration will be delayed.`);
                     ...DEFAULT_STREAM_CONNECTION_OPTIONS,
                     ...(options ?? {})
                 };
+                // Validate app metadata
+                const invalidMetadata = Object.entries(resolvedOptions.appMetadata).filter(([_, value]) => typeof value != 'string');
+                if (invalidMetadata.length > 0) {
+                    throw new Error(`Invalid appMetadata provided. Only string values are allowed. Invalid values: ${invalidMetadata.map(([key, value]) => `${key}: ${value}`).join(', ')}`);
+                }
                 const clientImplementation = resolvedOptions.clientImplementation;
                 this.updateSyncStatus({ clientImplementation });
                 if (clientImplementation == exports.SyncClientImplementation.JAVASCRIPT) {
@@ -8058,6 +8086,7 @@ The next upload iteration will be delayed.`);
                 include_checksum: true,
                 raw_data: true,
                 parameters: resolvedOptions.params,
+                app_metadata: resolvedOptions.appMetadata,
                 client_id: clientId
             }
         };
@@ -8417,6 +8446,7 @@ The next upload iteration will be delayed.`);
         try {
             const options = {
                 parameters: resolvedOptions.params,
+                app_metadata: resolvedOptions.appMetadata,
                 active_streams: this.activeStreams,
                 include_defaults: resolvedOptions.includeDefaultStreams
             };
@@ -9053,14 +9083,14 @@ class AbstractPowerSyncDatabase extends BaseObserver {
     async initialize() {
         await this._initialize();
         await this.bucketStorageAdapter.init();
-        await this._loadVersion();
+        await this.loadVersion();
         await this.updateSchema(this.options.schema);
         await this.resolveOfflineSyncStatus();
         await this.database.execute('PRAGMA RECURSIVE_TRIGGERS=TRUE');
         this.ready = true;
         this.iterateListeners((cb) => cb.initialized?.());
     }
-    async _loadVersion() {
+    async loadVersion() {
         try {
             const { version } = await this.database.get('SELECT powersync_rs_version() as version');
             this.sdkVersion = version;
@@ -10199,6 +10229,27 @@ class SyncDataBatch {
     }
 }
 
+/**
+ * Thrown when an underlying database connection is closed.
+ * This is particularly relevant when worker connections are marked as closed while
+ * operations are still in progress.
+ */
+class ConnectionClosedError extends Error {
+    static NAME = 'ConnectionClosedError';
+    static MATCHES(input) {
+        /**
+         * If there are weird package issues which cause multiple versions of classes to be present, the instanceof
+         * check might fail. This also performs a failsafe check.
+         * This might also happen if the Error is serialized and parsed over a bridging channel like a MessagePort.
+         */
+        return (input instanceof ConnectionClosedError || (input instanceof Error && input.name == ConnectionClosedError.NAME));
+    }
+    constructor(message) {
+        super(message);
+        this.name = ConnectionClosedError.NAME;
+    }
+}
+
 // https://www.sqlite.org/lang_expr.html#castexpr
 exports.ColumnType = void 0;
 (function (ColumnType) {
@@ -10762,6 +10813,7 @@ exports.AbstractStreamingSyncImplementation = AbstractStreamingSyncImplementatio
 exports.ArrayComparator = ArrayComparator;
 exports.BaseObserver = BaseObserver;
 exports.Column = Column;
+exports.ConnectionClosedError = ConnectionClosedError;
 exports.ConnectionManager = ConnectionManager;
 exports.ControlledExecutor = ControlledExecutor;
 exports.CrudBatch = CrudBatch;
@@ -10800,6 +10852,7 @@ exports.MAX_OP_ID = MAX_OP_ID;
 exports.OnChangeQueryProcessor = OnChangeQueryProcessor;
 exports.OpType = OpType;
 exports.OplogEntry = OplogEntry;
+exports.RawTable = RawTable;
 exports.Schema = Schema;
 exports.SqliteBucketStorage = SqliteBucketStorage;
 exports.SyncDataBatch = SyncDataBatch;