@powersync/common 0.0.0-dev-20251203144301 → 0.0.0-dev-20260112083235

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};
 
@@ -7645,6 +7649,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 +8028,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 +8068,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 +8428,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 +9065,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;
@@ -9075,11 +9087,11 @@ class AbstractPowerSyncDatabase extends BaseObserver {
                 .map((n) => parseInt(n));
         }
         catch (e) {
-            throw new Error(`Unsupported powersync extension version. Need >=0.4.5 <1.0.0, got: ${this.sdkVersion}. Details: ${e.message}`);
+            throw new Error(`Unsupported powersync extension version. Need >=0.4.10 <1.0.0, got: ${this.sdkVersion}. Details: ${e.message}`);
         }
-        // Validate >=0.4.5 <1.0.0
-        if (versionInts[0] != 0 || versionInts[1] < 4 || (versionInts[1] == 4 && versionInts[2] < 5)) {
-            throw new Error(`Unsupported powersync extension version. Need >=0.4.5 <1.0.0, got: ${this.sdkVersion}`);
+        // Validate >=0.4.10 <1.0.0
+        if (versionInts[0] != 0 || versionInts[1] < 4 || (versionInts[1] == 4 && versionInts[2] < 10)) {
+            throw new Error(`Unsupported powersync extension version. Need >=0.4.10 <1.0.0, got: ${this.sdkVersion}`);
         }
     }
     async resolveOfflineSyncStatus() {
@@ -10199,6 +10211,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 +10795,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;