dexie-cloud-addon 4.3.9 → 4.4.1

package/dist/modern/middlewares/blobResolveMiddleware.d.ts

@@ -0,0 +1,21 @@
+/**
+ * DBCore Middleware for resolving BlobRefs on read
+ *
+ * This middleware intercepts read operations and resolves any BlobRefs
+ * found in objects marked with _hasBlobRefs.
+ *
+ * Important: Avoids async/await to preserve Dexie's Promise.PSD context.
+ * Uses Dexie.waitFor() only for explicit rw transactions to keep them alive.
+ * For readonly or implicit transactions, resolves directly (no waitFor needed).
+ *
+ * Resolved blobs are queued for saving via BlobSavingQueue, which uses
+ * setTimeout(fn, 0) to completely isolate from Dexie's transaction context.
+ * Each blob is saved atomically using Table.update() with its keyPath to
+ * avoid race conditions with other property changes.
+ *
+ * Blob downloads use Authorization header (same as sync) via the server
+ * proxy endpoint: GET /blob/{ref}
+ */
+import { DBCore, Middleware } from 'dexie';
+import { DexieCloudDB } from '../db/DexieCloudDB';
+export declare function createBlobResolveMiddleware(db: DexieCloudDB): Middleware<DBCore>;