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

package/src/client/sync/stream/streaming-sync-types.ts

@@ -90,6 +90,11 @@ export interface StreamingSyncRequest {
    */
   parameters?: Record<string, StreamingSyncRequestParameterType>;
 
+  /**
+   * Application metadata to be included in service logs.
+   */
+  app_metadata?: Record<string, string>;
+
   client_id?: string;
 }
 

package/src/db/ConnectionClosedError.ts

@@ -0,0 +1,23 @@
+/**
+ * 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.
+ */
+export class ConnectionClosedError extends Error {
+  static NAME = 'ConnectionClosedError';
+
+  static MATCHES(input: any) {
+    /**
+     * 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: string) {
+    super(message);
+    this.name = ConnectionClosedError.NAME;
+  }
+}

package/src/db/crud/SyncStatus.ts

@@ -261,6 +261,10 @@ export class SyncStatus {
     };
   }
 
+  /**
+   * 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.
+   */
   protected serializeError(error?: Error) {
     if (typeof error == 'undefined') {
       return undefined;

package/src/index.ts

@@ -21,6 +21,7 @@ export * from './client/sync/stream/streaming-sync-types.js';
 export * from './client/sync/sync-streams.js';
 
 export * from './client/ConnectionManager.js';
+export * from './db/ConnectionClosedError.js';
 export { ProgressWithOperations, SyncProgress } from './db/crud/SyncProgress.js';
 export * from './db/crud/SyncStatus.js';
 export * from './db/crud/UploadQueueStatus.js';