@framers/sql-storage-adapter 0.6.12 → 0.6.14

package/dist/features/sync/index.d.ts

@@ -25,13 +25,13 @@
  * await sync.sync();
  * ```
  */
-export { CrossPlatformSync, createCrossPlatformSync, type CrossPlatformSyncOptions, type CrossPlatformSyncHooks, type TableSyncConfig, type SyncResult, type SyncStatus as CrossPlatformSyncStatus, } from './crossPlatformSync';
-export { VectorClock, createVectorClock, compareClocks, mergeClocks, generateDeviceId, dominates, type VectorClockData, type CausalRelation, type SerializedVectorClock, } from './protocol/vectorClock';
-export { type ChangeOperation, type ChangeRecord, type ChangeBatch, type SyncProgress, type SyncStatus as ProtocolSyncStatus, type BaseMessage, type HandshakeRequest, type HandshakeResponse, type DeltaPush, type DeltaPullRequest, type DeltaPullResponse, type AckMessage, type ConflictMessage, type PresenceMessage, type HeartbeatMessage, type HeartbeatAck, type ErrorMessage, type SyncMessage, type SyncMessageType, type DeviceType as ProtocolDeviceType, type DeviceInfo as ProtocolDeviceInfo, type ConflictResolution as ProtocolConflictResolution, generateMessageId, createBaseMessage, createHandshakeRequest, createAck, createHeartbeat, createError, createDeltaPushMessage, createDeltaPullRequest, createPresenceMessage, createHeartbeatMessage, createAckMessage, generateChangeId, createChangeRecord, isHandshakeRequest, isDeltaPush, isConflict, isError, isSyncMessage, } from './protocol/messages';
-export { BaseTransport, TransportError, TransportErrorCodes, type SyncTransport, type TransportOptions, type TransportState, type TransportStats, type TransportEventType, type TransportEvents, type TransportEventListener, } from './transport/transport';
-export { WebSocketTransport, createWebSocketTransport, type WebSocketTransportOptions, } from './transport/websocketTransport';
-export { HttpTransport, createHttpTransport, type HttpTransportOptions, } from './transport/httpTransport';
-export { ConflictResolver, createConflictResolver, FieldMergers, type ConflictStrategy, type ResolutionDecision, type SyncConflict, type ConflictResolution, type ConflictUIHooks, type ConflictResolverOptions, type FieldMerger, } from './conflicts/conflictResolver';
-export { DeviceManager, createDeviceManager, type DeviceType, type PresenceStatus, type DeviceInfo, type DeviceCapabilities, type DeviceRegistrationOptions, type PresenceEvent, type DeviceManagerEventType, type DeviceManagerEvents, type DeviceManagerOptions, } from './devices/deviceManager';
-export { SyncLogManager, type ChangeLogEntry as SyncLogChange, type ConflictEntry as SyncLogConflict, } from './tables/syncLogManager';
+export { CrossPlatformSync, createCrossPlatformSync, type CrossPlatformSyncOptions, type CrossPlatformSyncHooks, type TableSyncConfig, type SyncResult, type SyncStatus as CrossPlatformSyncStatus, } from './crossPlatformSync.js';
+export { VectorClock, createVectorClock, compareClocks, mergeClocks, generateDeviceId, dominates, type VectorClockData, type CausalRelation, type SerializedVectorClock, } from './protocol/vectorClock.js';
+export { type ChangeOperation, type ChangeRecord, type ChangeBatch, type SyncProgress, type SyncStatus as ProtocolSyncStatus, type BaseMessage, type HandshakeRequest, type HandshakeResponse, type DeltaPush, type DeltaPullRequest, type DeltaPullResponse, type AckMessage, type ConflictMessage, type PresenceMessage, type HeartbeatMessage, type HeartbeatAck, type ErrorMessage, type SyncMessage, type SyncMessageType, type DeviceType as ProtocolDeviceType, type DeviceInfo as ProtocolDeviceInfo, type ConflictResolution as ProtocolConflictResolution, generateMessageId, createBaseMessage, createHandshakeRequest, createAck, createHeartbeat, createError, createDeltaPushMessage, createDeltaPullRequest, createPresenceMessage, createHeartbeatMessage, createAckMessage, generateChangeId, createChangeRecord, isHandshakeRequest, isDeltaPush, isConflict, isError, isSyncMessage, } from './protocol/messages.js';
+export { BaseTransport, TransportError, TransportErrorCodes, type SyncTransport, type TransportOptions, type TransportState, type TransportStats, type TransportEventType, type TransportEvents, type TransportEventListener, } from './transport/transport.js';
+export { WebSocketTransport, createWebSocketTransport, type WebSocketTransportOptions, } from './transport/websocketTransport.js';
+export { HttpTransport, createHttpTransport, type HttpTransportOptions, } from './transport/httpTransport.js';
+export { ConflictResolver, createConflictResolver, FieldMergers, type ConflictStrategy, type ResolutionDecision, type SyncConflict, type ConflictResolution, type ConflictUIHooks, type ConflictResolverOptions, type FieldMerger, } from './conflicts/conflictResolver.js';
+export { DeviceManager, createDeviceManager, type DeviceType, type PresenceStatus, type DeviceInfo, type DeviceCapabilities, type DeviceRegistrationOptions, type PresenceEvent, type DeviceManagerEventType, type DeviceManagerEvents, type DeviceManagerOptions, } from './devices/deviceManager.js';
+export { SyncLogManager, type ChangeLogEntry as SyncLogChange, type ConflictEntry as SyncLogConflict, } from './tables/syncLogManager.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/features/sync/protocol/index.d.ts

@@ -6,6 +6,6 @@
  *
  * @packageDocumentation
  */
-export * from './vectorClock';
-export * from './messages';
+export * from './vectorClock.js';
+export * from './messages.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/features/sync/protocol/messages.d.ts

@@ -6,7 +6,7 @@
  *
  * @packageDocumentation
  */
-import type { VectorClockData } from './vectorClock';
+import type { VectorClockData } from './vectorClock.js';
 /**
  * Type of device in the sync network.
  */

package/dist/features/sync/syncManager.d.ts

@@ -33,7 +33,7 @@
  * await manager.sync();
  * ```
  */
-import type { StorageAdapter } from '../../core/contracts';
+import type { StorageAdapter } from '../../core/contracts/index.js';
 /**
  * Sync mode determines when synchronization occurs.
  */

package/dist/features/sync/tables/index.d.ts

@@ -6,5 +6,5 @@
  *
  * @packageDocumentation
  */
-export * from './syncLogManager';
+export * from './syncLogManager.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/features/sync/tables/syncLogManager.d.ts

@@ -22,10 +22,10 @@
  * const changes = await syncLog.getChangesSince(remoteVectorClock);
  * ```
  */
-import type { StorageAdapter } from '../../../core/contracts';
-import type { VectorClockData } from '../protocol/vectorClock';
-import { VectorClock } from '../protocol/vectorClock';
-import type { ChangeRecord, ChangeOperation, DeviceInfo, DeviceType } from '../protocol/messages';
+import type { StorageAdapter } from '../../../core/contracts/index.js';
+import type { VectorClockData } from '../protocol/vectorClock.js';
+import { VectorClock } from '../protocol/vectorClock.js';
+import type { ChangeRecord, ChangeOperation, DeviceInfo, DeviceType } from '../protocol/messages.js';
 /**
  * Change log entry as stored in database.
  */

package/dist/features/sync/transport/httpTransport.d.ts

@@ -6,8 +6,8 @@
  *
  * @packageDocumentation
  */
-import { BaseTransport, type TransportOptions } from './transport';
-import type { SyncMessage } from '../protocol/messages';
+import { BaseTransport, type TransportOptions } from './transport.js';
+import type { SyncMessage } from '../protocol/messages.js';
 /**
  * HTTP-specific transport options.
  */

package/dist/features/sync/transport/index.d.ts

@@ -6,7 +6,7 @@
  *
  * @packageDocumentation
  */
-export * from './transport';
-export * from './websocketTransport';
-export * from './httpTransport';
+export * from './transport.js';
+export * from './websocketTransport.js';
+export * from './httpTransport.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/features/sync/transport/transport.d.ts

@@ -6,7 +6,7 @@
  *
  * @packageDocumentation
  */
-import type { SyncMessage } from '../protocol/messages';
+import type { SyncMessage } from '../protocol/messages.js';
 /**
  * Transport connection state.
  */

package/dist/features/sync/transport/websocketTransport.d.ts

@@ -6,8 +6,8 @@
  *
  * @packageDocumentation
  */
-import { BaseTransport, type TransportOptions } from './transport';
-import type { SyncMessage } from '../protocol/messages';
+import { BaseTransport, type TransportOptions } from './transport.js';
+import type { SyncMessage } from '../protocol/messages.js';
 /**
  * WebSocket-specific transport options.
  */

package/dist/index.d.ts

@@ -1,26 +1,26 @@
-export * from './types';
-export * from './core/database';
-export * from './core/resolver';
-export * from './adapters/betterSqliteAdapter';
-export * from './adapters/sqlJsAdapter';
-export * from './adapters/indexedDbAdapter';
-export * from './adapters/capacitorSqliteAdapter';
-export * from './adapters/postgresAdapter';
-export * from './adapters/supabase';
-export * from './adapters/baseStorageAdapter';
-export * from './features/backup/cloudBackup';
-export * from './features/migrations/dataExport';
-export * from './features/migrations/dataImport';
-export * from './features/migrations/migration';
-export * from './features/sync/syncManager';
-export * from './shared/parameterUtils';
-export { SqliteDialect } from './dialects/SqliteDialect';
-export { PostgresDialect } from './dialects/PostgresDialect';
-export { SqliteFts5 } from './fts/SqliteFts5';
-export { PostgresFts } from './fts/PostgresFts';
-export { NodeBlobCodec } from './codecs/NodeBlobCodec';
-export { BrowserBlobCodec } from './codecs/BrowserBlobCodec';
-export { SqliteFileExporter } from './exporters/SqliteFileExporter';
-export { PostgresExporter } from './exporters/PostgresExporter';
-export { createStorageFeatures } from './core/contracts/features';
+export * from './types/index.js';
+export * from './core/database.js';
+export * from './core/resolver.js';
+export * from './adapters/betterSqliteAdapter.js';
+export * from './adapters/sqlJsAdapter.js';
+export * from './adapters/indexedDbAdapter.js';
+export * from './adapters/capacitorSqliteAdapter.js';
+export * from './adapters/postgresAdapter.js';
+export * from './adapters/supabase.js';
+export * from './adapters/baseStorageAdapter.js';
+export * from './features/backup/cloudBackup.js';
+export * from './features/migrations/dataExport.js';
+export * from './features/migrations/dataImport.js';
+export * from './features/migrations/migration.js';
+export * from './features/sync/syncManager.js';
+export * from './shared/parameterUtils.js';
+export { SqliteDialect } from './dialects/SqliteDialect.js';
+export { PostgresDialect } from './dialects/PostgresDialect.js';
+export { SqliteFts5 } from './fts/SqliteFts5.js';
+export { PostgresFts } from './fts/PostgresFts.js';
+export { NodeBlobCodec } from './codecs/NodeBlobCodec.js';
+export { BrowserBlobCodec } from './codecs/BrowserBlobCodec.js';
+export { SqliteFileExporter } from './exporters/SqliteFileExporter.js';
+export { PostgresExporter } from './exporters/PostgresExporter.js';
+export { createStorageFeatures } from './core/contracts/features.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/shared/connectionGate.d.ts

@@ -12,9 +12,11 @@
  * callback's handle it carries the transaction's token, so it is admitted
  * whatever async context runs it. Through the adapter itself, from code the
  * callback runs, the callback's async context tells it apart, so the gate needs
- * a context store (Node's AsyncLocalStorage); without one it admits every
- * statement that carries no token at once, which is how the adapters behaved
- * before the gate.
+ * a context store (Node's AsyncLocalStorage). Without one, the gate either
+ * admits every statement that carries no token at once, which is how the
+ * adapters behaved before the gate, or makes it wait like any outside caller,
+ * so that the handle is the only way into an open transaction: the adapters
+ * that run in a browser or a WebView, where there is no context store, wait.
  *
  * This module imports nothing from Node, so browser bundles can include it;
  * the adapter that runs on Node passes the store in.
@@ -50,22 +52,43 @@ export interface ConnectionGate {
     /** Releases the context store when the connection closes. */
     dispose(): void;
 }
+/** How a gate treats a statement that carries no token. */
+export interface ConnectionGateOptions {
+    /**
+     * When there is no context store: 'admit' runs such a statement at once (the
+     * default, how the adapters behaved before the gate); 'wait' holds it until
+     * the open transaction ends, so only the transaction's handle reaches it.
+     */
+    withoutContext?: 'admit' | 'wait';
+}
 /**
  * Creates the gate of one shared connection.
  *
- * @param context - Node's AsyncLocalStorage, or null where there is none (the
- *   gate then admits every statement at once).
+ * @param context - Node's AsyncLocalStorage, or null where there is none.
+ * @param options - What the gate does with a token-less statement when there
+ *   is no context store.
  */
-export declare const createConnectionGate: (context: TransactionContextStore | null) => ConnectionGate;
+export declare const createConnectionGate: (context: TransactionContextStore | null, options?: ConnectionGateOptions) => ConnectionGate;
+/** Reports a statement that is still waiting for an open transaction after a while. */
+export interface LongWaitWatch {
+    /** How long a statement may wait before `onLongWait` is called. */
+    afterMs: number;
+    /** Called once per waiting statement that passes `afterMs`. */
+    onLongWait: () => void;
+}
 /**
- * Runs `work`, a synchronous statement, once the gate admits it. The last check
- * and the work happen in the same turn, so no transaction can open between
+ * Runs `work` once the gate admits it. `work` starts the statement: it runs it
+ * (a synchronous adapter) or sends it (an asynchronous one), and the last check
+ * and that start happen in the same turn, so no transaction can open between
  * them; a caller woken when a transaction ends checks again, since the next
  * transaction may already be open.
  *
  * @param token - The transaction's token when the statement comes through a
  *   transaction handle; a handle whose transaction has ended waits like any
  *   outside caller.
+ * @param watch - Reports a statement that waits long, which is how a callback
+ *   that issues a statement through the adapter instead of its handle shows
+ *   on an adapter whose gate makes such statements wait.
  */
-export declare const whenAdmitted: <T>(gate: ConnectionGate, work: () => T, token?: symbol) => Promise<T>;
+export declare const whenAdmitted: <T>(gate: ConnectionGate, work: () => T | PromiseLike<T>, token?: symbol, watch?: LongWaitWatch) => Promise<T>;
 //# sourceMappingURL=connectionGate.d.ts.map

package/dist/shared/connectionGate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connectionGate.d.ts","sourceRoot":"","sources":["../../src/shared/connectionGate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,4DAA4D;AAC5D,MAAM,WAAW,uBAAuB;IACtC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5C,QAAQ,IAAI,MAAM,GAAG,SAAS,CAAC;IAC/B,0EAA0E;IAC1E,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,yCAAyC;AACzC,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,qEAAqE;IACrE,MAAM,IAAI,OAAO,CAAC;IAClB,yFAAyF;IACzF,SAAS,IAAI,MAAM,GAAG,IAAI,CAAC;IAC3B,yEAAyE;IACzE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB;;;;;OAKG;IACH,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACzD,6DAA6D;IAC7D,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,YAAa,uBAAuB,GAAG,IAAI,KAAG,cA8B9E,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,GAAU,CAAC,QAAQ,cAAc,QAAQ,MAAM,CAAC,UAAU,MAAM,KAAG,OAAO,CAAC,CAAC,CAKpG,CAAC"}
+{"version":3,"file":"connectionGate.d.ts","sourceRoot":"","sources":["../../src/shared/connectionGate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,4DAA4D;AAC5D,MAAM,WAAW,uBAAuB;IACtC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5C,QAAQ,IAAI,MAAM,GAAG,SAAS,CAAC;IAC/B,0EAA0E;IAC1E,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,yCAAyC;AACzC,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,qEAAqE;IACrE,MAAM,IAAI,OAAO,CAAC;IAClB,yFAAyF;IACzF,SAAS,IAAI,MAAM,GAAG,IAAI,CAAC;IAC3B,yEAAyE;IACzE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB;;;;;OAKG;IACH,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACzD,6DAA6D;IAC7D,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,2DAA2D;AAC3D,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CACnC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,YACtB,uBAAuB,GAAG,IAAI,YAC9B,qBAAqB,KAC7B,cAgCF,CAAC;AAEF,uFAAuF;AACvF,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,YAAY,GAAU,CAAC,QAC5B,cAAc,QACd,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,UACtB,MAAM,UACN,aAAa,KACpB,OAAO,CAAC,CAAC,CAYX,CAAC"}

package/dist/shared/connectionGate.js

@@ -12,9 +12,11 @@
  * callback's handle it carries the transaction's token, so it is admitted
  * whatever async context runs it. Through the adapter itself, from code the
  * callback runs, the callback's async context tells it apart, so the gate needs
- * a context store (Node's AsyncLocalStorage); without one it admits every
- * statement that carries no token at once, which is how the adapters behaved
- * before the gate.
+ * a context store (Node's AsyncLocalStorage). Without one, the gate either
+ * admits every statement that carries no token at once, which is how the
+ * adapters behaved before the gate, or makes it wait like any outside caller,
+ * so that the handle is the only way into an open transaction: the adapters
+ * that run in a browser or a WebView, where there is no context store, wait.
  *
  * This module imports nothing from Node, so browser bundles can include it;
  * the adapter that runs on Node passes the store in.
@@ -22,18 +24,22 @@
 /**
  * Creates the gate of one shared connection.
  *
- * @param context - Node's AsyncLocalStorage, or null where there is none (the
- *   gate then admits every statement at once).
+ * @param context - Node's AsyncLocalStorage, or null where there is none.
+ * @param options - What the gate does with a token-less statement when there
+ *   is no context store.
  */
-export const createConnectionGate = (context) => {
+export const createConnectionGate = (context, options = {}) => {
     let open = null;
+    const waitWithoutContext = options.withoutContext === 'wait';
     return {
         blocks: (token) => {
             if (open === null)
                 return false;
             if (token !== undefined)
                 return token !== open.id;
-            return context !== null && context.getStore() !== open.id;
+            if (context === null)
+                return waitWithoutContext;
+            return context.getStore() !== open.id;
         },
         inside: () => open !== null && context !== null && context.getStore() === open.id,
         openToken: () => open?.id ?? null,
@@ -59,18 +65,31 @@ export const createConnectionGate = (context) => {
     };
 };
 /**
- * Runs `work`, a synchronous statement, once the gate admits it. The last check
- * and the work happen in the same turn, so no transaction can open between
+ * Runs `work` once the gate admits it. `work` starts the statement: it runs it
+ * (a synchronous adapter) or sends it (an asynchronous one), and the last check
+ * and that start happen in the same turn, so no transaction can open between
  * them; a caller woken when a transaction ends checks again, since the next
  * transaction may already be open.
  *
  * @param token - The transaction's token when the statement comes through a
  *   transaction handle; a handle whose transaction has ended waits like any
  *   outside caller.
+ * @param watch - Reports a statement that waits long, which is how a callback
+ *   that issues a statement through the adapter instead of its handle shows
+ *   on an adapter whose gate makes such statements wait.
  */
-export const whenAdmitted = async (gate, work, token) => {
-    while (gate.blocks(token)) {
-        await gate.ended();
+export const whenAdmitted = async (gate, work, token, watch) => {
+    if (gate.blocks(token)) {
+        const timer = watch ? setTimeout(watch.onLongWait, watch.afterMs) : undefined;
+        try {
+            while (gate.blocks(token)) {
+                await gate.ended();
+            }
+        }
+        finally {
+            if (timer !== undefined)
+                clearTimeout(timer);
+        }
     }
     return work();
 };

package/dist/shared/connectionGate.js.map

@@ -1 +1 @@
-{"version":3,"file":"connectionGate.js","sourceRoot":"","sources":["../../src/shared/connectionGate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAmCH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,OAAuC,EAAkB,EAAE;IAC9F,IAAI,IAAI,GAA+C,IAAI,CAAC;IAE5D,OAAO;QACL,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YAChB,IAAI,IAAI,KAAK,IAAI;gBAAE,OAAO,KAAK,CAAC;YAChC,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,KAAK,KAAK,IAAI,CAAC,EAAE,CAAC;YAClD,OAAO,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC5D,CAAC;QACD,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,KAAK,IAAI,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,KAAK,IAAI,CAAC,EAAE;QACjF,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,IAAI,IAAI;QACjC,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,IAAI,IAAI,OAAO,CAAC,OAAO,EAAE;QAC5C,KAAK,CAAC,IAAI,CAAI,IAAmC;YAC/C,MAAM,EAAE,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;YACjC,IAAI,OAAoB,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBACzC,OAAO,GAAG,OAAO,CAAC;YACpB,CAAC,CAAC,CAAC;YACH,IAAI,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;YACpB,IAAI,CAAC;gBACH,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YACtE,CAAC;oBAAS,CAAC;gBACT,IAAI,GAAG,IAAI,CAAC;gBACZ,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;QACD,OAAO,EAAE,GAAG,EAAE;YACZ,OAAO,EAAE,OAAO,EAAE,CAAC;QACrB,CAAC;KACF,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAAK,IAAoB,EAAE,IAAa,EAAE,KAAc,EAAc,EAAE;IACvG,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IACD,OAAO,IAAI,EAAE,CAAC;AAChB,CAAC,CAAC"}
+{"version":3,"file":"connectionGate.js","sourceRoot":"","sources":["../../src/shared/connectionGate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AA6CH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,OAAuC,EACvC,UAAiC,EAAE,EACnB,EAAE;IAClB,IAAI,IAAI,GAA+C,IAAI,CAAC;IAC5D,MAAM,kBAAkB,GAAG,OAAO,CAAC,cAAc,KAAK,MAAM,CAAC;IAE7D,OAAO;QACL,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YAChB,IAAI,IAAI,KAAK,IAAI;gBAAE,OAAO,KAAK,CAAC;YAChC,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,KAAK,KAAK,IAAI,CAAC,EAAE,CAAC;YAClD,IAAI,OAAO,KAAK,IAAI;gBAAE,OAAO,kBAAkB,CAAC;YAChD,OAAO,OAAO,CAAC,QAAQ,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACxC,CAAC;QACD,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,KAAK,IAAI,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,KAAK,IAAI,CAAC,EAAE;QACjF,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,IAAI,IAAI;QACjC,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,IAAI,IAAI,OAAO,CAAC,OAAO,EAAE;QAC5C,KAAK,CAAC,IAAI,CAAI,IAAmC;YAC/C,MAAM,EAAE,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;YACjC,IAAI,OAAoB,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBACzC,OAAO,GAAG,OAAO,CAAC;YACpB,CAAC,CAAC,CAAC;YACH,IAAI,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;YACpB,IAAI,CAAC;gBACH,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YACtE,CAAC;oBAAS,CAAC;gBACT,IAAI,GAAG,IAAI,CAAC;gBACZ,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;QACD,OAAO,EAAE,GAAG,EAAE;YACZ,OAAO,EAAE,OAAO,EAAE,CAAC;QACrB,CAAC;KACF,CAAC;AACJ,CAAC,CAAC;AAUF;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAC/B,IAAoB,EACpB,IAA8B,EAC9B,KAAc,EACd,KAAqB,EACT,EAAE;IACd,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9E,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;YACrB,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,IAAI,KAAK,KAAK,SAAS;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IACD,OAAO,IAAI,EAAE,CAAC;AAChB,CAAC,CAAC"}

package/dist/shared/parameterUtils.d.ts

@@ -1,4 +1,4 @@
-import type { StorageParameters } from '../core/contracts';
+import type { StorageParameters } from '../core/contracts/index.js';
 /**
  * Normalises parameter payloads into a tuple of named/object parameters and positional arrays.
  */

package/dist/shared/postgresTarget.d.ts

@@ -0,0 +1,10 @@
+import type { PostgresAdapterOptions } from '../adapters/postgresAdapter.js';
+/** A string with something in it. */
+export declare const isNonEmpty: (value: unknown) => value is string;
+/**
+ * Whether Postgres options name a server: a connection string, or a host,
+ * database or user. `{ connectionString: process.env.DATABASE_URL }` with
+ * DATABASE_URL unset names none.
+ */
+export declare const namesPostgresServer: (options: PostgresAdapterOptions | undefined) => boolean;
+//# sourceMappingURL=postgresTarget.d.ts.map

package/dist/shared/postgresTarget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgresTarget.d.ts","sourceRoot":"","sources":["../../src/shared/postgresTarget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAE1E,qCAAqC;AACrC,eAAO,MAAM,UAAU,UAAW,OAAO,KAAG,KAAK,IAAI,MAAuD,CAAC;AAE7G;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,YAAa,sBAAsB,GAAG,SAAS,KAAG,OAO/E,CAAC"}

package/dist/shared/postgresTarget.js

@@ -0,0 +1,13 @@
+/** A string with something in it. */
+export const isNonEmpty = (value) => typeof value === 'string' && value.length > 0;
+/**
+ * Whether Postgres options name a server: a connection string, or a host,
+ * database or user. `{ connectionString: process.env.DATABASE_URL }` with
+ * DATABASE_URL unset names none.
+ */
+export const namesPostgresServer = (options) => Boolean(options &&
+    (isNonEmpty(options.connectionString) ||
+        isNonEmpty(options.host) ||
+        isNonEmpty(options.database) ||
+        isNonEmpty(options.user)));
+//# sourceMappingURL=postgresTarget.js.map

package/dist/shared/postgresTarget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgresTarget.js","sourceRoot":"","sources":["../../src/shared/postgresTarget.ts"],"names":[],"mappings":"AAEA,qCAAqC;AACrC,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAc,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AAE7G;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,OAA2C,EAAW,EAAE,CAC1F,OAAO,CACL,OAAO;IACL,CAAC,UAAU,CAAC,OAAO,CAAC,gBAAgB,CAAC;QACnC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC;QACxB,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC;QAC5B,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAC9B,CAAC"}

package/dist/shared/serializedTransaction.d.ts

@@ -1,4 +1,4 @@
-import type { StorageAdapter } from '../core/contracts';
+import type { StorageAdapter } from '../core/contracts/index.js';
 /** Function that runs one asynchronous operation after earlier operations finish. */
 export type SerializedTransactionRunner = <T>(operation: () => Promise<T>) => Promise<T>;
 /**

package/dist/types/index.d.ts

@@ -19,11 +19,11 @@
  * } from '@framers/sql-storage-adapter/types';
  * ```
  */
-export * from '../core/contracts';
-export * from '../core/contracts/context';
-export * from '../core/contracts/events';
-export * from '../core/contracts/extensions';
-export * from '../core/contracts/limitations';
-export * from '../core/contracts/performance';
-export * from '../core/contracts/hooks';
+export * from '../core/contracts/index.js';
+export * from '../core/contracts/context.js';
+export * from '../core/contracts/events.js';
+export * from '../core/contracts/extensions.js';
+export * from '../core/contracts/limitations.js';
+export * from '../core/contracts/performance.js';
+export * from '../core/contracts/hooks.js';
 //# sourceMappingURL=index.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@framers/sql-storage-adapter",
-  "version": "0.6.12",
+  "version": "0.6.14",
   "description": "Robust cross-platform SQL storage abstraction with automatic fallbacks and runtime detection",
   "type": "module",
   "main": "dist/index.js",
@@ -111,6 +111,7 @@
     "@vitest/coverage-v8": "^3.2.7",
     "eslint": "^9.13.0",
     "eslint-config-prettier": "^9.1.0",
+    "fake-indexeddb": "^6.2.5",
     "patch-package": "^8.0.0",
     "rimraf": "^5.0.7",
     "semantic-release": "^24.1.0",