@asaidimu/utils-database 1.1.1 → 3.0.0

package/README.md

@@ -16,7 +16,7 @@ A flexible, schema-driven document database layer for browser and Node.js with b
   - [Basic CRUD](#basic-crud)
   - [Transactions](#transactions)
   - [Migrations](#migrations)
-  - [Events & Telemetry](#events--telemetry)
+  - [Events & Telemetry](#events-telemetry)
   - [Pagination & Filtering](#pagination--filtering)
 - [Project Architecture](#project-architecture)
 - [Development & Contributing](#development--contributing)
@@ -60,7 +60,7 @@ npm install @asaidimu/utils-database
 This package has the following peer dependencies – you need to install them manually:
 
 ```bash
-npm install @asaidimu/anansi @asaidimu/events
+npm install @asaidimu/anansi
 ```
 
 ### Basic Configuration
@@ -356,7 +356,6 @@ This project is licensed under the **MIT License**. See the [LICENSE](https://gi
 
 Built with ❤️ using:
 - [`@asaidimu/anansi`](https://github.com/asaidimu/anansi) – schema validation and migrations.
-- [`@asaidimu/events`](https://github.com/asaidimu/events) – type‑safe event bus.
 - [`@standard-schema/spec`](https://github.com/standard-schema/standard-schema) – Standard Schema interoperability.
 - [`uuid`](https://github.com/uuidjs/uuid) – for v7 UUIDs.
 - [`fake-indexeddb`](https://github.com/dumbmatter/fakeIndexedDB) – testing support.

package/index.d.mts

@@ -1,6 +1,5 @@
 import { QueryFilter, PaginationOptions } from '@asaidimu/query';
 import { IndexDefinition, SchemaDefinition, SchemaChange, DataTransform, PredicateMap } from '@asaidimu/anansi';
-import { EventBus } from '@asaidimu/events';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 
 /**
@@ -279,6 +278,16 @@ interface Collection<T> {
      * @param tx - Optional transaction to buffer the write into.
      */
     create: (initial: T, tx?: TransactionContext) => Promise<Document<T>>;
+    /**
+     * Updates all documents matching the query with the provided partial data.
+     * Returns the number of documents updated.
+     */
+    update: (query: QueryFilter<T>, data: Partial<T>, tx?: TransactionContext) => Promise<number>;
+    /**
+     * Deletes all documents matching the query.
+     * Returns the number of documents deleted.
+     */
+    delete: (query: QueryFilter<T>, tx?: TransactionContext) => Promise<number>;
     /**
      * Subscribes to collection-level events.
      */
@@ -367,19 +376,22 @@ type DatabaseEvent = {
     schema?: SchemaDefinition | Partial<SchemaDefinition>;
     timestamp: number;
 };
-type Document<T> = {
-    readonly [K in keyof T]: T[K];
-} & {
+type DocumentMetadata = {
     $id?: string;
     $created?: string | Date;
     $updated?: string | Date;
     $version?: number;
+};
+type Document<T> = {
+    readonly [K in keyof T]: T[K];
+} & DocumentMetadata & {
     read: () => Promise<boolean>;
     save: (tx?: TransactionContext) => Promise<boolean>;
     update: (props: Partial<T>, tx?: TransactionContext) => Promise<boolean>;
     delete: (tx?: TransactionContext) => Promise<boolean>;
     subscribe: (event: DocumentEventType | TelemetryEventType, callback: (event: DocumentEvent<T> | TelemetryEvent) => void) => () => void;
     state(): T;
+    $metadata(): DocumentMetadata;
 };
 type DocumentEventType = "document:create" | "document:write" | "document:update" | "document:delete" | "document:read";
 type DocumentEvent<T> = {
@@ -728,6 +740,126 @@ declare const createIndexedDbStore: <T extends Record<string, any>>(config: Stor
 
 declare function DatabaseConnection(config: Omit<DatabaseConfig, "keyPath">, createStore: <T extends Record<string, any>>(config: StoreConfig, indexes: IndexDefinition[]) => Store<T>): Promise<Database>;
 
+interface MutexOptions {
+    /**
+     * Maximum number of pending requests allowed in the queue.
+     * If exceeded, tryLock/lock will fail.
+     * @default Infinity
+     */
+    capacity?: number;
+    /**
+     * Controls how lock handoff is scheduled when a waiter is unblocked.
+     *
+     * - `"macrotask"` (default): Uses setTimeout(fn, 0) to yield to the event
+     *   loop between handoffs. Prevents microtask starvation under heavy
+     *   contention — I/O, rendering, and other macrotasks can run between
+     *   lock acquisitions. Use for Serializer and other coarse-grained
+     *   serializers.
+     *
+     * - `"microtask"`: Uses queueMicrotask(fn) for handoff. Near-zero latency
+     *   between acquisitions — no macrotask delay. Safe when you need
+     *   back-to-back operations to complete as fast as possible and starvation
+     *   is not a concern (e.g. Once, Semaphore where builds are infrequent
+     *   and latency matters more than fairness).
+     */
+    yieldMode?: "macrotask" | "microtask";
+}
+/**
+ * A mutual exclusion lock.
+ * Allows only one execution context to access a resource at a time.
+ *
+ * Yield mode is configurable per instance:
+ * - "macrotask" (default): yields between handoffs, preventing microtask starvation.
+ * - "microtask": zero-delay handoff for latency-sensitive paths.
+ */
+declare class Mutex {
+    private _locked;
+    private _capacity;
+    private _yieldMode;
+    private waiters;
+    constructor(options?: MutexOptions);
+    /**
+     * Acquires the lock. If already held, waits until released or timeout reached.
+     *
+     * @param timeout - Optional maximum wait time in milliseconds.
+     * @throws {TimeoutError} If the lock cannot be acquired within the timeout.
+     * @throws {Error} If the wait queue is full (backpressure).
+     */
+    lock(timeout?: number): Promise<void>;
+    /**
+     * Attempts to acquire the lock without waiting.
+     * @returns `true` if the lock was acquired, `false` otherwise.
+     */
+    tryLock(): boolean;
+    /**
+     * Releases the lock, scheduling the next waiter according to yieldMode.
+     *
+     * When a waiter exists, `_locked` intentionally remains `true` — ownership
+     * transfers directly to the next waiter without ever clearing the flag.
+     * Only when the queue is empty is `_locked` set to false.
+     *
+     * @throws {Error} If the mutex is not currently locked.
+     */
+    unlock(): void;
+    /** Returns true if the mutex is currently locked. */
+    locked(): boolean;
+    /** Returns the number of operations waiting for the lock. */
+    pending(): number;
+}
+
+/**
+ * Interface defining the shape of the EventBus.
+ * @template TEventMap - A record mapping event names to their respective payload types.
+ */
+interface EventBus<TEventMap extends Record<string, any>> {
+    /**
+     * Subscribes to a specific event by name.
+     * @param eventName - The name of the event to subscribe to.
+     * @param callback - The function to call when the event is emitted.
+     * @returns A function to unsubscribe from the event.
+     */
+    subscribe: <TEventName extends keyof TEventMap>(eventName: TEventName, callback: (payload: TEventMap[TEventName]) => void) => () => void;
+    /**
+     * Subscribes to an event and automatically unsubscribes after it fires once.
+     * @param eventName - The name of the event to subscribe to.
+     * @param callback - The function to call when the event is emitted.
+     * @returns A function to cancel the one-shot subscription before it fires.
+     */
+    once: <TEventName extends keyof TEventMap>(eventName: TEventName, callback: (payload: TEventMap[TEventName]) => void) => () => void;
+    /**
+     * Emits an event with a payload to all subscribed listeners.
+     * @param event - An object containing the event name and payload.
+     */
+    emit: <TEventName extends keyof TEventMap>(event: {
+        name: TEventName;
+        payload: TEventMap[TEventName];
+    }) => void;
+    /**
+     * Retrieves metrics about event bus usage.
+     * @returns An object containing various metrics.
+     */
+    metrics: () => EventMetrics;
+    /**
+     * Clears all subscriptions and resets metrics.
+     * After calling clear(), the bus is fully reset and can be reused —
+     * cross-tab communication is re-established if it was previously enabled.
+     */
+    clear: () => void;
+}
+/**
+ * Interface defining the metrics tracked by the EventBus.
+ */
+interface EventMetrics {
+    /** Total number of events emitted (both sync and deferred paths). */
+    totalEvents: number;
+    /** Number of active subscriptions across all event names. */
+    activeSubscriptions: number;
+    /** Map of event names to their emission counts. */
+    eventCounts: Map<string, number>;
+    /** Average duration of event dispatch in milliseconds. */
+    averageEmitDuration: number;
+}
+
 interface MiddlewareContext {
     collection?: string;
     documentId?: string;
@@ -745,13 +877,6 @@ declare class Pipeline {
     wrap<T extends object>(target: T, baseContext: Partial<MiddlewareContext>): T;
 }
 
-declare class Mutex {
-    private queue;
-    private locked;
-    acquire(): Promise<() => void>;
-    private release;
-}
-
 interface DocumentOptions<T extends Record<string, any>> {
     /**
      * The already-persisted initial state of the document.
@@ -760,6 +885,7 @@ interface DocumentOptions<T extends Record<string, any>> {
      */
     initial: Partial<T>;
     collection: string;
+    schema: SchemaDefinition;
     validator?: StandardSchemaV1;
     store: Store<T>;
     bus: EventBus<Record<DocumentEventType | TelemetryEventType, DocumentEvent<T> | TelemetryEvent>>;
@@ -780,13 +906,65 @@ interface DocumentOptions<T extends Record<string, any>> {
 declare function createDocument<T extends Record<string, any>>(opts: DocumentOptions<T>): Promise<Document<T & {
     $id: string | number;
 }>>;
-declare function openCollection<T extends Record<string, any>>({ collection: schema, validator, bus, store, pipeline, validate, }: {
+declare function openCollection<T extends Record<string, any>>({ collection: schemaName, validator, bus, store, pipeline, validate, schema: schemaDefinition, }: {
     store: Store<T>;
     collection: string;
     validator: StandardSchemaV1;
     bus: EventBus<any>;
     pipeline: Pipeline;
     validate: boolean;
+    schema: SchemaDefinition;
 }): Promise<Collection<T>>;
 
-export { type BufferedOperation, type Collection, type CollectionEvent, type CollectionEventType, type CollectionMigrationOptions, ConnectionManager, type CursorCallback, type CursorCallbackResult, type CursorPaginationOptions, DEFAULT_KEYPATH, type Database, type DatabaseConfig, DatabaseConnection, type DatabaseEvent, type DatabaseEventType, type Document, type DocumentEvent, type DocumentEventType, IndexedDBStore, type Store, type StoreConfig, type StoreKeyRange, type TelemetryEvent, type TelemetryEventType, createDocument, createEphemeralStore, createIndexedDbStore, openCollection };
+/**
+ * Error types for Database operations.
+ */
+declare enum DatabaseErrorType {
+    /** The schema does not exist. */
+    SCHEMA_NOT_FOUND = "SCHEMA_NOT_FOUND",
+    /** The schema already exists. */
+    SCHEMA_ALREADY_EXISTS = "SCHEMA_ALREADY_EXISTS",
+    /** The schema name is invalid. */
+    INVALID_SCHEMA_NAME = "INVALID_SCHEMA_NAME",
+    /** The schema definition is invalid. */
+    INVALID_SCHEMA_DEFINITION = "INVALID_SCHEMA_DEFINITION",
+    /** The database subscription failed. */
+    SUBSCRIPTION_FAILED = "SUBSCRIPTION_FAILED",
+    /** The database operation failed due to an internal error. */
+    INTERNAL_ERROR = "INTERNAL_ERROR",
+    /** Data being entered into a collection does not satisfy its schema definition. */
+    INVALID_DATA = "INVALID_DATA",
+    /** Optimistic Concurrency Control version mismatches */
+    CONFLICT = "CONFLICT",
+    /** For retryable store locks */
+    TRANSIENT_ERROR = "TRANSIENT_ERROR",
+    TRANSACTION_FAILED = "TRANSACTION_FAILED",
+    CONNECTION_FAILED = "CONNECTION_FAILED",
+    INVALID_OPERATION = "INVALID_OPERATION"
+}
+/**
+ * Error class for Database operations.
+ */
+declare class DatabaseError extends Error {
+    /**
+     * The type of error that occurred.
+     */
+    type: DatabaseErrorType;
+    /**
+     * The schema associated with the error, if applicable.
+     */
+    schema?: SchemaDefinition;
+    /**
+     * Issues associated with the error
+     */
+    issues?: any[];
+    /**
+     * Constructs a new DatabaseErrorClass instance.
+     * @param type - The type of error that occurred.
+     * @param message - A human-readable message describing the error.
+     * @param schema - The schema associated with the error, if applicable.
+     */
+    constructor(type: DatabaseErrorType, message: string, schema?: SchemaDefinition, cause?: unknown, issues?: any);
+}
+
+export { type BufferedOperation, type Collection, type CollectionEvent, type CollectionEventType, type CollectionMigrationOptions, ConnectionManager, type CursorCallback, type CursorCallbackResult, type CursorPaginationOptions, DEFAULT_KEYPATH, type Database, type DatabaseConfig, DatabaseConnection, DatabaseError, DatabaseErrorType, type DatabaseEvent, type DatabaseEventType, type Document, type DocumentEvent, type DocumentEventType, type DocumentMetadata, IndexedDBStore, type Store, type StoreConfig, type StoreKeyRange, type TelemetryEvent, type TelemetryEventType, createDocument, createEphemeralStore, createIndexedDbStore, openCollection };

package/index.d.ts

@@ -1,6 +1,5 @@
 import { QueryFilter, PaginationOptions } from '@asaidimu/query';
 import { IndexDefinition, SchemaDefinition, SchemaChange, DataTransform, PredicateMap } from '@asaidimu/anansi';
-import { EventBus } from '@asaidimu/events';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 
 /**
@@ -279,6 +278,16 @@ interface Collection<T> {
      * @param tx - Optional transaction to buffer the write into.
      */
     create: (initial: T, tx?: TransactionContext) => Promise<Document<T>>;
+    /**
+     * Updates all documents matching the query with the provided partial data.
+     * Returns the number of documents updated.
+     */
+    update: (query: QueryFilter<T>, data: Partial<T>, tx?: TransactionContext) => Promise<number>;
+    /**
+     * Deletes all documents matching the query.
+     * Returns the number of documents deleted.
+     */
+    delete: (query: QueryFilter<T>, tx?: TransactionContext) => Promise<number>;
     /**
      * Subscribes to collection-level events.
      */
@@ -367,19 +376,22 @@ type DatabaseEvent = {
     schema?: SchemaDefinition | Partial<SchemaDefinition>;
     timestamp: number;
 };
-type Document<T> = {
-    readonly [K in keyof T]: T[K];
-} & {
+type DocumentMetadata = {
     $id?: string;
     $created?: string | Date;
     $updated?: string | Date;
     $version?: number;
+};
+type Document<T> = {
+    readonly [K in keyof T]: T[K];
+} & DocumentMetadata & {
     read: () => Promise<boolean>;
     save: (tx?: TransactionContext) => Promise<boolean>;
     update: (props: Partial<T>, tx?: TransactionContext) => Promise<boolean>;
     delete: (tx?: TransactionContext) => Promise<boolean>;
     subscribe: (event: DocumentEventType | TelemetryEventType, callback: (event: DocumentEvent<T> | TelemetryEvent) => void) => () => void;
     state(): T;
+    $metadata(): DocumentMetadata;
 };
 type DocumentEventType = "document:create" | "document:write" | "document:update" | "document:delete" | "document:read";
 type DocumentEvent<T> = {
@@ -728,6 +740,126 @@ declare const createIndexedDbStore: <T extends Record<string, any>>(config: Stor
 
 declare function DatabaseConnection(config: Omit<DatabaseConfig, "keyPath">, createStore: <T extends Record<string, any>>(config: StoreConfig, indexes: IndexDefinition[]) => Store<T>): Promise<Database>;
 
+interface MutexOptions {
+    /**
+     * Maximum number of pending requests allowed in the queue.
+     * If exceeded, tryLock/lock will fail.
+     * @default Infinity
+     */
+    capacity?: number;
+    /**
+     * Controls how lock handoff is scheduled when a waiter is unblocked.
+     *
+     * - `"macrotask"` (default): Uses setTimeout(fn, 0) to yield to the event
+     *   loop between handoffs. Prevents microtask starvation under heavy
+     *   contention — I/O, rendering, and other macrotasks can run between
+     *   lock acquisitions. Use for Serializer and other coarse-grained
+     *   serializers.
+     *
+     * - `"microtask"`: Uses queueMicrotask(fn) for handoff. Near-zero latency
+     *   between acquisitions — no macrotask delay. Safe when you need
+     *   back-to-back operations to complete as fast as possible and starvation
+     *   is not a concern (e.g. Once, Semaphore where builds are infrequent
+     *   and latency matters more than fairness).
+     */
+    yieldMode?: "macrotask" | "microtask";
+}
+/**
+ * A mutual exclusion lock.
+ * Allows only one execution context to access a resource at a time.
+ *
+ * Yield mode is configurable per instance:
+ * - "macrotask" (default): yields between handoffs, preventing microtask starvation.
+ * - "microtask": zero-delay handoff for latency-sensitive paths.
+ */
+declare class Mutex {
+    private _locked;
+    private _capacity;
+    private _yieldMode;
+    private waiters;
+    constructor(options?: MutexOptions);
+    /**
+     * Acquires the lock. If already held, waits until released or timeout reached.
+     *
+     * @param timeout - Optional maximum wait time in milliseconds.
+     * @throws {TimeoutError} If the lock cannot be acquired within the timeout.
+     * @throws {Error} If the wait queue is full (backpressure).
+     */
+    lock(timeout?: number): Promise<void>;
+    /**
+     * Attempts to acquire the lock without waiting.
+     * @returns `true` if the lock was acquired, `false` otherwise.
+     */
+    tryLock(): boolean;
+    /**
+     * Releases the lock, scheduling the next waiter according to yieldMode.
+     *
+     * When a waiter exists, `_locked` intentionally remains `true` — ownership
+     * transfers directly to the next waiter without ever clearing the flag.
+     * Only when the queue is empty is `_locked` set to false.
+     *
+     * @throws {Error} If the mutex is not currently locked.
+     */
+    unlock(): void;
+    /** Returns true if the mutex is currently locked. */
+    locked(): boolean;
+    /** Returns the number of operations waiting for the lock. */
+    pending(): number;
+}
+
+/**
+ * Interface defining the shape of the EventBus.
+ * @template TEventMap - A record mapping event names to their respective payload types.
+ */
+interface EventBus<TEventMap extends Record<string, any>> {
+    /**
+     * Subscribes to a specific event by name.
+     * @param eventName - The name of the event to subscribe to.
+     * @param callback - The function to call when the event is emitted.
+     * @returns A function to unsubscribe from the event.
+     */
+    subscribe: <TEventName extends keyof TEventMap>(eventName: TEventName, callback: (payload: TEventMap[TEventName]) => void) => () => void;
+    /**
+     * Subscribes to an event and automatically unsubscribes after it fires once.
+     * @param eventName - The name of the event to subscribe to.
+     * @param callback - The function to call when the event is emitted.
+     * @returns A function to cancel the one-shot subscription before it fires.
+     */
+    once: <TEventName extends keyof TEventMap>(eventName: TEventName, callback: (payload: TEventMap[TEventName]) => void) => () => void;
+    /**
+     * Emits an event with a payload to all subscribed listeners.
+     * @param event - An object containing the event name and payload.
+     */
+    emit: <TEventName extends keyof TEventMap>(event: {
+        name: TEventName;
+        payload: TEventMap[TEventName];
+    }) => void;
+    /**
+     * Retrieves metrics about event bus usage.
+     * @returns An object containing various metrics.
+     */
+    metrics: () => EventMetrics;
+    /**
+     * Clears all subscriptions and resets metrics.
+     * After calling clear(), the bus is fully reset and can be reused —
+     * cross-tab communication is re-established if it was previously enabled.
+     */
+    clear: () => void;
+}
+/**
+ * Interface defining the metrics tracked by the EventBus.
+ */
+interface EventMetrics {
+    /** Total number of events emitted (both sync and deferred paths). */
+    totalEvents: number;
+    /** Number of active subscriptions across all event names. */
+    activeSubscriptions: number;
+    /** Map of event names to their emission counts. */
+    eventCounts: Map<string, number>;
+    /** Average duration of event dispatch in milliseconds. */
+    averageEmitDuration: number;
+}
+
 interface MiddlewareContext {
     collection?: string;
     documentId?: string;
@@ -745,13 +877,6 @@ declare class Pipeline {
     wrap<T extends object>(target: T, baseContext: Partial<MiddlewareContext>): T;
 }
 
-declare class Mutex {
-    private queue;
-    private locked;
-    acquire(): Promise<() => void>;
-    private release;
-}
-
 interface DocumentOptions<T extends Record<string, any>> {
     /**
      * The already-persisted initial state of the document.
@@ -760,6 +885,7 @@ interface DocumentOptions<T extends Record<string, any>> {
      */
     initial: Partial<T>;
     collection: string;
+    schema: SchemaDefinition;
     validator?: StandardSchemaV1;
     store: Store<T>;
     bus: EventBus<Record<DocumentEventType | TelemetryEventType, DocumentEvent<T> | TelemetryEvent>>;
@@ -780,13 +906,65 @@ interface DocumentOptions<T extends Record<string, any>> {
 declare function createDocument<T extends Record<string, any>>(opts: DocumentOptions<T>): Promise<Document<T & {
     $id: string | number;
 }>>;
-declare function openCollection<T extends Record<string, any>>({ collection: schema, validator, bus, store, pipeline, validate, }: {
+declare function openCollection<T extends Record<string, any>>({ collection: schemaName, validator, bus, store, pipeline, validate, schema: schemaDefinition, }: {
     store: Store<T>;
     collection: string;
     validator: StandardSchemaV1;
     bus: EventBus<any>;
     pipeline: Pipeline;
     validate: boolean;
+    schema: SchemaDefinition;
 }): Promise<Collection<T>>;
 
-export { type BufferedOperation, type Collection, type CollectionEvent, type CollectionEventType, type CollectionMigrationOptions, ConnectionManager, type CursorCallback, type CursorCallbackResult, type CursorPaginationOptions, DEFAULT_KEYPATH, type Database, type DatabaseConfig, DatabaseConnection, type DatabaseEvent, type DatabaseEventType, type Document, type DocumentEvent, type DocumentEventType, IndexedDBStore, type Store, type StoreConfig, type StoreKeyRange, type TelemetryEvent, type TelemetryEventType, createDocument, createEphemeralStore, createIndexedDbStore, openCollection };
+/**
+ * Error types for Database operations.
+ */
+declare enum DatabaseErrorType {
+    /** The schema does not exist. */
+    SCHEMA_NOT_FOUND = "SCHEMA_NOT_FOUND",
+    /** The schema already exists. */
+    SCHEMA_ALREADY_EXISTS = "SCHEMA_ALREADY_EXISTS",
+    /** The schema name is invalid. */
+    INVALID_SCHEMA_NAME = "INVALID_SCHEMA_NAME",
+    /** The schema definition is invalid. */
+    INVALID_SCHEMA_DEFINITION = "INVALID_SCHEMA_DEFINITION",
+    /** The database subscription failed. */
+    SUBSCRIPTION_FAILED = "SUBSCRIPTION_FAILED",
+    /** The database operation failed due to an internal error. */
+    INTERNAL_ERROR = "INTERNAL_ERROR",
+    /** Data being entered into a collection does not satisfy its schema definition. */
+    INVALID_DATA = "INVALID_DATA",
+    /** Optimistic Concurrency Control version mismatches */
+    CONFLICT = "CONFLICT",
+    /** For retryable store locks */
+    TRANSIENT_ERROR = "TRANSIENT_ERROR",
+    TRANSACTION_FAILED = "TRANSACTION_FAILED",
+    CONNECTION_FAILED = "CONNECTION_FAILED",
+    INVALID_OPERATION = "INVALID_OPERATION"
+}
+/**
+ * Error class for Database operations.
+ */
+declare class DatabaseError extends Error {
+    /**
+     * The type of error that occurred.
+     */
+    type: DatabaseErrorType;
+    /**
+     * The schema associated with the error, if applicable.
+     */
+    schema?: SchemaDefinition;
+    /**
+     * Issues associated with the error
+     */
+    issues?: any[];
+    /**
+     * Constructs a new DatabaseErrorClass instance.
+     * @param type - The type of error that occurred.
+     * @param message - A human-readable message describing the error.
+     * @param schema - The schema associated with the error, if applicable.
+     */
+    constructor(type: DatabaseErrorType, message: string, schema?: SchemaDefinition, cause?: unknown, issues?: any);
+}
+
+export { type BufferedOperation, type Collection, type CollectionEvent, type CollectionEventType, type CollectionMigrationOptions, ConnectionManager, type CursorCallback, type CursorCallbackResult, type CursorPaginationOptions, DEFAULT_KEYPATH, type Database, type DatabaseConfig, DatabaseConnection, DatabaseError, DatabaseErrorType, type DatabaseEvent, type DatabaseEventType, type Document, type DocumentEvent, type DocumentEventType, type DocumentMetadata, IndexedDBStore, type Store, type StoreConfig, type StoreKeyRange, type TelemetryEvent, type TelemetryEventType, createDocument, createEphemeralStore, createIndexedDbStore, openCollection };