shelving 1.76.2 → 1.79.0

package/{constraint → modules/constraint}/Constraints.d.ts

@@ -2,7 +2,7 @@ import type { Data } from "../util/data.js";
 import { ImmutableArray } from "../util/array.js";
 import { Constraint } from "./Constraint.js";
 /** Type of Rule that is powered by several sub-constraints (e.g. `Filters` and `Sorts` and `Query` itself extend this). */
-export declare abstract class Constraints<T extends Data, C extends Constraint<T>> extends Constraint<T> implements Iterable<C> {
+export declare abstract class Constraints<T extends Data, C extends Constraint<Partial<T>>> extends Constraint<T> implements Iterable<C> {
     protected readonly _constraints: ImmutableArray<C>;
     /** Get the first constraint. */
     get first(): C | undefined;

package/{constraint → modules/constraint}/FilterConstraint.d.ts

@@ -1,8 +1,8 @@
-import { ArrayType, ImmutableArray } from "../util/array.js";
-import { Data, Key } from "../util/data.js";
+import type { Data, Key } from "../util/data.js";
+import type { Nullish } from "../util/null.js";
+import { ImmutableArray } from "../util/array.js";
 import { Matchable } from "../util/match.js";
-import { NotString } from "../util/string.js";
-import { Constraint } from "./Constraint.js";
+import type { Constraint } from "./Constraint.js";
 /** Possible operator references. */
 export declare type FilterOperator = "IS" | "NOT" | "IN" | "OUT" | "CONTAINS" | "LT" | "LTE" | "GT" | "GTE";
 /** Format that allows filters to be specified as a string, e.g. `!name` means `name is not` and `age>` means `age is more than` and `tags[]` means `tags array contains` */
@@ -11,12 +11,12 @@ export declare type FilterKey<T extends Data> = Key<T> | `${Key<T>}` | `!${Key<T
 export declare type FilterProps<T extends Data> = {
     [K in Key<T> as `${K}` | `!${K}`]?: T[K] | ImmutableArray<T[K]>;
 } & {
-    [K in Key<T> as `${K}[]`]?: T[K] extends ImmutableArray ? ArrayType<T[K]> : never;
+    [K in Key<T> as `${K}[]`]?: Required<T>[K] extends ImmutableArray<infer X> ? X : never;
 } & {
     [K in Key<T> as `${K}<` | `${K}<=` | `${K}>` | `${K}>=`]?: T[K];
 };
 /** List of filters in a flexible format. */
-export declare type FilterList<T extends Data> = FilterProps<T> | FilterConstraint<T> | Iterable<FilterList<T> & NotString>;
+export declare type FilterList<T extends Data> = Nullish<FilterProps<T> | FilterConstraint<T>> | Iterable<FilterList<T>>;
 /**
  * Filter: filters a list of data.
  *

package/{constraint → modules/constraint}/FilterConstraint.js

@@ -89,7 +89,7 @@ export function* getFilters(filters) {
         for (const filter of filters)
             yield* getFilters(filter);
     }
-    else {
+    else if (filters) {
         for (const [key, value] of Object.entries(filters))
             yield new FilterConstraint(key, value);
     }

package/{constraint → modules/constraint}/FilterConstraints.d.ts

@@ -1,6 +1,6 @@
 import type { Data } from "../util/data.js";
 import type { Matchable } from "../util/match.js";
-import { FilterList, FilterProps, FilterConstraint } from "./FilterConstraint.js";
+import { FilterList, FilterConstraint } from "./FilterConstraint.js";
 import { Constraints } from "./Constraints.js";
 /**
  * Interface to make sure an object implements all matchers.
@@ -8,14 +8,14 @@ import { Constraints } from "./Constraints.js";
  */
 export interface Filterable<T extends Data> extends Matchable<T, void> {
     /** Add a filter to this filterable. */
-    filter(props: FilterProps<T>): this;
+    filter(...filters: FilterList<Partial<T>>[]): this;
     /** Match an item against the filters specified for this object. */
     match(item: T): boolean;
 }
 /** A set of filters. */
-export declare class FilterConstraints<T extends Data = Data> extends Constraints<T, FilterConstraint<T>> implements Filterable<T> {
-    constructor(...filters: FilterList<T>[]);
-    filter(...filters: FilterList<T>[]): this;
+export declare class FilterConstraints<T extends Data = Data> extends Constraints<T, FilterConstraint<Partial<T>>> implements Filterable<T> {
+    constructor(...filters: FilterList<Partial<T>>[]);
+    filter(...filters: FilterList<Partial<T>>[]): this;
     match(item: T): boolean;
     transform(items: Iterable<T>): Iterable<T>;
     toString(): string;

package/{constraint → modules/constraint}/QueryConstraints.d.ts

@@ -3,7 +3,7 @@ import { Filterable, FilterConstraints } from "./FilterConstraints.js";
 import { Sortable, SortConstraints } from "./SortConstraints.js";
 import { Constraint } from "./Constraint.js";
 import { FilterList } from "./FilterConstraint.js";
-import { SortKeys, SortList } from "./SortConstraint.js";
+import { SortList } from "./SortConstraint.js";
 /** Interface that combines Filterable, Sortable, Sliceable. */
 export interface Queryable<T extends Data> extends Filterable<T>, Sortable<T> {
     /**
@@ -31,11 +31,11 @@ export declare class QueryConstraints<T extends Data = Data> extends Constraint<
     readonly filters: FilterConstraints<T>;
     readonly sorts: SortConstraints<T>;
     readonly limit: number | null;
-    constructor(filters?: FilterList<T>, sorts?: SortList<T>, limit?: number | null);
-    filter(...filters: FilterList<T>[]): this;
+    constructor(filters?: FilterList<Partial<T>>, sorts?: SortList<Partial<T>>, limit?: number | null);
+    filter(...filters: FilterList<Partial<T>>[]): this;
     get unfilter(): this;
     match(item: T): boolean;
-    sort(...keys: SortKeys<T>[]): this;
+    sort(...sorts: SortList<Partial<T>>[]): this;
     get unsort(): this;
     rank(left: T, right: T): number;
     after(item: T): this;

package/{constraint → modules/constraint}/QueryConstraints.js

@@ -37,11 +37,11 @@ export class QueryConstraints extends Constraint {
         return this.filters.match(item);
     }
     // Implement `Sortable`
-    sort(...keys) {
+    sort(...sorts) {
         return {
             __proto__: Object.getPrototypeOf(this),
             ...this,
-            sorts: this.sorts.sort(...keys),
+            sorts: this.sorts.sort(...sorts),
         };
     }
     get unsort() {

package/{constraint → modules/constraint}/SortConstraint.d.ts

@@ -1,7 +1,8 @@
 import type { ImmutableArray } from "../util/array.js";
-import { Data, Key } from "../util/data.js";
+import type { Data, Key } from "../util/data.js";
+import type { Nullish } from "../util/null.js";
 import { Rankable } from "../util/sort.js";
-import { Constraint } from "./Constraint.js";
+import type { Constraint } from "./Constraint.js";
 /** Format that allows sorts to be set as a plain string, e.g. `name` sorts by name in ascending order and `!date` sorts by date in descending order. */
 export declare type SortKey<T extends Data> = Key<T> | `${Key<T>}` | `!${Key<T>}`;
 /** One or more sort keys. */
@@ -9,7 +10,7 @@ export declare type SortKeys<T extends Data> = SortKey<T> | ImmutableArray<SortK
 /** Possible operator references. */
 export declare type SortDirection = "ASC" | "DESC";
 /** List of sorts in a flexible format. */
-export declare type SortList<T extends Data> = SortKeys<T> | SortConstraint<T> | Iterable<SortList<T>>;
+export declare type SortList<T extends Data> = Nullish<SortKeys<T> | SortConstraint<T> | Iterable<SortList<T>>>;
 /** Sort a list of values. */
 export declare class SortConstraint<T extends Data = Data> implements Constraint<T>, Rankable<T> {
     readonly key: string;

package/{constraint → modules/constraint}/SortConstraint.js

@@ -1,4 +1,3 @@
-import { getProp } from "../util/data.js";
 import { rank, rankAsc, rankDesc, sortItems } from "../util/sort.js";
 /** Sort a list of values. */
 export class SortConstraint {
@@ -16,7 +15,7 @@ export class SortConstraint {
         return `"${this.direction === "DESC" ? "!" : ""}${this.key}"`;
     }
     rank(left, right) {
-        return rank(getProp(left, this.key), this.direction === "ASC" ? rankAsc : rankDesc, getProp(right, this.key));
+        return rank(left[this.key], this.direction === "ASC" ? rankAsc : rankDesc, right[this.key]);
     }
     transform(items) {
         return sortItems(items, this);
@@ -33,7 +32,7 @@ export function* getSorts(sorts) {
     else if (sorts instanceof SortConstraint) {
         yield sorts;
     }
-    else {
+    else if (sorts) {
         for (const sort of sorts)
             yield* getSorts(sort);
     }

package/{constraint → modules/constraint}/SortConstraints.d.ts

@@ -1,19 +1,19 @@
 import type { Data } from "../util/data.js";
 import { Rankable } from "../util/sort.js";
 import { Constraints } from "./Constraints.js";
-import { SortConstraint, SortKeys, SortList } from "./SortConstraint.js";
+import { SortConstraint, SortList } from "./SortConstraint.js";
 /**
  * Interface to make sure an object implements all directions.
  * - Extends `Rankable` so this object itself can be directly be used with `filterItems()` and `filterEntries()`
  */
 export interface Sortable<T extends Data> extends Rankable<T> {
     /** Add one or more sorts to this sortable. */
-    sort(...keys: SortKeys<T>[]): this;
+    sort(...keys: SortList<Partial<T>>[]): this;
 }
 /** A set of sorts. */
-export declare class SortConstraints<T extends Data = Data> extends Constraints<T, SortConstraint<T>> implements Sortable<T> {
-    constructor(...sorts: SortList<T>[]);
-    sort(...sorts: SortList<T>[]): this;
+export declare class SortConstraints<T extends Data = Data> extends Constraints<T, SortConstraint<Partial<T>>> implements Sortable<T> {
+    constructor(...sorts: SortList<Partial<T>>[]);
+    sort(...sorts: SortList<Partial<T>>[]): this;
     rank(left: T, right: T): number;
     transform(items: Iterable<T>): Iterable<T>;
     toString(): string;

package/{db → modules/db}/Change.d.ts

@@ -1,38 +1,35 @@
-import type { Data, Datas, Key, Value } from "../util/data.js";
+import type { Data, Datas, Key } from "../util/data.js";
 import type { ImmutableArray } from "../util/array.js";
 import type { Provider, AsyncProvider } from "../provider/Provider.js";
-import { DataUpdate } from "../update/DataUpdate.js";
+import { Updates } from "../update/DataUpdate.js";
 import { Nullish } from "../util/null.js";
 import { DeepIterable } from "../util/iterate.js";
 import type { ItemConstraints, ItemData } from "./Item.js";
-export interface Change<T extends Datas> {
+/** Change on a collection. */
+export interface Change<T extends Datas, K extends Key<T> = Key<T>> {
     readonly action: string;
-    readonly collection: Key<T>;
+    readonly collection: K;
 }
 /** Add on an item. */
-export interface AddChange<T extends Datas, K extends Key<T> = Key<T>> extends Change<T> {
+export interface AddChange<T extends Datas, K extends Key<T> = Key<T>> extends Change<T, K> {
     readonly action: "ADD";
-    readonly collection: K;
     readonly data: T[K];
 }
 /** Set on an item. */
-export interface SetChange<T extends Datas, K extends Key<T> = Key<T>> extends Change<T> {
+export interface SetChange<T extends Datas, K extends Key<T> = Key<T>> extends Change<T, K> {
     readonly action: "SET";
-    readonly collection: K;
     readonly id: string;
     readonly data: T[K];
 }
 /** Update change on an item. */
-export interface UpdateChange<T extends Datas, K extends Key<T> = Key<T>> extends Change<T> {
+export interface UpdateChange<T extends Datas, K extends Key<T> = Key<T>> extends Change<T, K> {
     readonly action: "UPDATE";
-    readonly collection: K;
     readonly id: string;
-    readonly update: DataUpdate<Value<T>>;
+    readonly updates: Updates<T[K]>;
 }
 /** Delete change on an item. */
-export interface DeleteChange<T extends Datas, K extends Key<T> = Key<T>> extends Change<T> {
+export interface DeleteChange<T extends Datas, K extends Key<T> = Key<T>> extends Change<T, K> {
     readonly action: "DELETE";
-    readonly collection: K;
     readonly id: string;
 }
 /** Set, update, or delete change on an item. */

package/{db → modules/db}/Change.js

@@ -13,7 +13,7 @@ function _changeItem(change) {
     else if (action === "SET")
         this.setItem(collection, change.id, change.data);
     else if (action === "UPDATE")
-        this.updateQuery(collection, _getItemConstraint(change.id), change.update);
+        this.updateQuery(collection, _getItemConstraint(change.id), change.updates);
     else if (action === "DELETE")
         this.deleteItem(collection, change.id);
     return change;
@@ -29,7 +29,7 @@ async function _changeAsyncItem(change) {
     else if (action === "SET")
         await this.setItem(collection, change.id, change.data);
     else if (action === "UPDATE")
-        await this.updateQuery(collection, _getItemConstraint(change.id), change.update);
+        await this.updateQuery(collection, _getItemConstraint(change.id), change.updates);
     else if (action === "DELETE")
         await this.deleteItem(collection, change.id);
     return change;

package/modules/db/Collection.d.ts

@@ -0,0 +1,74 @@
+import type { Datas, Key } from "../util/data.js";
+import type { Nullish } from "../util/null.js";
+import type { FilterList } from "../constraint/FilterConstraint.js";
+import type { SortList } from "../constraint/SortConstraint.js";
+import type { DeepIterable } from "../util/iterate.js";
+import type { Updates } from "../update/DataUpdate.js";
+import type { PartialObserver } from "../observe/Observer.js";
+import type { Dispatch } from "../util/function.js";
+import type { Unsubscribe } from "../observe/Observable.js";
+import type { AsyncDatabase, Database } from "./Database.js";
+import { ItemData, AsyncItem, Item, ItemValue } from "./Item.js";
+import { AsyncQuery, Query } from "./Query.js";
+import { AddChange, ItemChanges, WriteChange, UpdateChange, DeleteChange, SetChange } from "./Change.js";
+/** Reference to a collection in a synchronous or asynchronous provider. */
+declare abstract class BaseCollection<T extends Datas = Datas, K extends Key<T> = Key<T>> {
+    abstract readonly db: Database<T> | AsyncDatabase<T>;
+    abstract readonly collection: K;
+    /** Create a query on this item's collection. */
+    abstract query(filters?: FilterList<Partial<ItemData<T[K]>>>, sorts?: SortList<Partial<ItemData<T[K]>>>, limit?: number | null): Query<T, K> | AsyncQuery<T, K>;
+    /** Create a query on this item's collection. */
+    abstract item(id: string): Item<T, K> | AsyncItem<T, K>;
+    /** Run a set of changes on this database. */
+    abstract change(...changes: DeepIterable<Nullish<WriteChange<T, K>>>[]): ItemChanges<T, K> | Promise<ItemChanges<T, K>>;
+    /** Get an item from this collection. */
+    abstract get(id: string): ItemValue<T[K]> | Promise<ItemValue<T[K]>>;
+    /** Subscribe a document from a collection in this database. */
+    subscribe(id: string, next: PartialObserver<ItemValue<T[K]>> | Dispatch<[ItemValue<T[K]>]>): Unsubscribe;
+    /** Add an item to this collection. */
+    abstract add(data: T[K]): string | Promise<string>;
+    /** Set a document in this collection. */
+    abstract set(id: string, data: T[K]): void | Promise<void>;
+    /** Update a document in this collection. */
+    abstract update(id: string, updates: Updates<T[K]>): void | Promise<void>;
+    /** Delete a document in this collection. */
+    abstract delete(id: string): void | Promise<void>;
+    /** Get an add change for this collection. */
+    getAdd(data: T[K]): AddChange<T, K>;
+    /** Get a set change for this collection. */
+    getSet(id: string, data: T[K]): SetChange<T, K>;
+    /** Get an update change for this collection. */
+    getUpdate(id: string, updates: Updates<T[K]>): UpdateChange<T, K>;
+    /** Get a delete change for this collection. */
+    getDelete(id: string): DeleteChange<T, K>;
+    toString(): K;
+}
+/** Reference to a collection in a synchronous provider. */
+export declare class Collection<T extends Datas = Datas, K extends Key<T> = Key<T>> extends BaseCollection<T, K> {
+    readonly db: Database<T>;
+    readonly collection: K;
+    constructor(db: Database<T>, collection: K);
+    query(filters?: FilterList<Partial<ItemData<T[K]>>>, sorts?: SortList<Partial<ItemData<T[K]>>>, limit?: number | null): Query<T, K>;
+    item(id: string): Item<T, K>;
+    change(...changes: DeepIterable<Nullish<WriteChange<T, K>>>[]): ItemChanges<T, K>;
+    get(id: string): ItemValue<T[K]>;
+    add(data: T[K]): string;
+    set(id: string, data: T[K]): void;
+    update(id: string, updates: Updates<T[K]>): void;
+    delete(id: string): void;
+}
+/** Reference to a collection in an asynchronous provider. */
+export declare class AsyncCollection<T extends Datas = Datas, K extends Key<T> = Key<T>> extends BaseCollection<T, K> {
+    readonly db: AsyncDatabase<T>;
+    readonly collection: K;
+    constructor(db: AsyncDatabase<T>, collection: K);
+    query(filters?: FilterList<Partial<ItemData<T[K]>>>, sorts?: SortList<Partial<ItemData<T[K]>>>, limit?: number | null): AsyncQuery<T, K>;
+    item(id: string): AsyncItem<T, K>;
+    change(...changes: DeepIterable<Nullish<WriteChange<T, K>>>[]): Promise<ItemChanges<T, K>>;
+    get(id: string): Promise<ItemValue<T[K]>>;
+    add(data: T[K]): Promise<string>;
+    set(id: string, data: T[K]): Promise<void>;
+    update(id: string, updates: Updates<T[K]>): Promise<void>;
+    delete(id: string): Promise<void>;
+}
+export {};

package/{db → modules/db}/Collection.js

@@ -3,9 +3,25 @@ import { AsyncQuery, Query } from "./Query.js";
 import { changeAsyncProvider, changeProvider } from "./Change.js";
 /** Reference to a collection in a synchronous or asynchronous provider. */
 class BaseCollection {
+    /** Subscribe a document from a collection in this database. */
+    subscribe(id, next) {
+        return this.db.subscribe(this.collection, id, typeof next === "function" ? { next } : next);
+    }
     /** Get an add change for this collection. */
     getAdd(data) {
-        return { action: "ADD", collection: this.collection, data };
+        return this.db.getAdd(this.collection, data);
+    }
+    /** Get a set change for this collection. */
+    getSet(id, data) {
+        return this.db.getSet(this.collection, id, data);
+    }
+    /** Get an update change for this collection. */
+    getUpdate(id, updates) {
+        return this.db.getUpdate(this.collection, id, updates);
+    }
+    /** Get a delete change for this collection. */
+    getDelete(id) {
+        return this.db.getDelete(this.collection, id);
     }
     // Implement toString()
     toString() {
@@ -25,12 +41,24 @@ export class Collection extends BaseCollection {
     item(id) {
         return new Item(this.db, this.collection, id);
     }
-    add(data) {
-        return this.db.provider.addItem(this.collection, data);
-    }
     change(...changes) {
         return changeProvider(this.db.provider, changes);
     }
+    get(id) {
+        return this.db.get(this.collection, id);
+    }
+    add(data) {
+        return this.db.add(this.collection, data);
+    }
+    set(id, data) {
+        return this.db.set(this.collection, id, data);
+    }
+    update(id, updates) {
+        return this.db.update(this.collection, id, updates);
+    }
+    delete(id) {
+        return this.db.delete(this.collection, id);
+    }
 }
 /** Reference to a collection in an asynchronous provider. */
 export class AsyncCollection extends BaseCollection {
@@ -45,10 +73,22 @@ export class AsyncCollection extends BaseCollection {
     item(id) {
         return new AsyncItem(this.db, this.collection, id);
     }
-    add(data) {
-        return this.db.provider.addItem(this.collection, data);
-    }
     change(...changes) {
         return changeAsyncProvider(this.db.provider, changes);
     }
+    get(id) {
+        return this.db.get(this.collection, id);
+    }
+    add(data) {
+        return this.db.add(this.collection, data);
+    }
+    set(id, data) {
+        return this.db.set(this.collection, id, data);
+    }
+    update(id, updates) {
+        return this.db.update(this.collection, id, updates);
+    }
+    delete(id) {
+        return this.db.delete(this.collection, id);
+    }
 }

package/modules/db/Database.d.ts

@@ -0,0 +1,76 @@
+import type { Key, Datas } from "../util/data.js";
+import type { Nullish } from "../util/null.js";
+import type { DeepIterable } from "../util/iterate.js";
+import type { AsyncProvider, Provider } from "../provider/Provider.js";
+import type { FilterList } from "../constraint/FilterConstraint.js";
+import type { SortList } from "../constraint/SortConstraint.js";
+import type { ItemData, ItemValue } from "../db/Item.js";
+import type { Updates } from "../update/DataUpdate.js";
+import type { PartialObserver } from "../observe/Observer.js";
+import type { Dispatch } from "../util/function.js";
+import type { Unsubscribe } from "../observe/Observable.js";
+import { Item, AsyncItem } from "./Item.js";
+import { Query, AsyncQuery } from "./Query.js";
+import { Collection, AsyncCollection } from "./Collection.js";
+import { AddChange, DeleteChange, ItemChanges, SetChange, UpdateChange, WriteChange } from "./Change.js";
+/** Database with a synchronous or asynchronous provider. */
+declare abstract class BaseDatabase<T extends Datas> {
+    abstract readonly provider: Provider<T> | AsyncProvider<T>;
+    /** Create a query on a collection in this database. */
+    abstract collection<K extends Key<T>>(collection: K): Collection<T, K> | AsyncCollection<T, K>;
+    /** Create a query on a collection in this database. */
+    abstract query<K extends Key<T>>(collection: K, filters?: FilterList<Partial<ItemData<T[K]>>>, sorts?: SortList<Partial<ItemData<T[K]>>>, limit?: number | null): Query<T, K> | AsyncQuery<T, K>;
+    /** Reference an item in a collection in this database. */
+    abstract item<K extends Key<T>>(collection: K, id: string): Item<T, K> | AsyncItem<T, K>;
+    /** Run a set of changes in this database. */
+    abstract change(...changes: DeepIterable<Nullish<WriteChange<T>>>[]): ItemChanges<T> | Promise<ItemChanges<T>>;
+    /** Get a document from a collection in this database. */
+    abstract get<K extends Key<T>>(collection: K, id: string): ItemValue<T[K]> | Promise<ItemValue<T[K]>>;
+    /** Subscribe a document from a collection in this database. */
+    subscribe<K extends Key<T>>(collection: K, id: string, next: PartialObserver<ItemValue<T[K]>> | Dispatch<[ItemValue<T[K]>]>): Unsubscribe;
+    /** Add a document to a collection in this database. */
+    abstract add<K extends Key<T>>(collection: K, data: T[K]): string | Promise<string>;
+    /** Set a document in a collection in this database. */
+    abstract set<K extends Key<T>>(collection: K, id: string, data: T[K]): void | Promise<void>;
+    /** Update a document in a collection in this database. */
+    abstract update<K extends Key<T>>(collection: K, id: string, updates: Updates<T[K]>): void | Promise<void>;
+    /** Delete a document from a collection in this database. */
+    abstract delete<K extends Key<T>>(collection: K, id: string): void | Promise<void>;
+    /** Get an add change for a collection in this database. */
+    getAdd<K extends Key<T>>(collection: K, data: T[K]): AddChange<T, K>;
+    /** Get a set change for a collection in this database. */
+    getSet<K extends Key<T>>(collection: K, id: string, data: T[K]): SetChange<T, K>;
+    /** Get an update change for a collection in this database. */
+    getUpdate<K extends Key<T>>(collection: K, id: string, updates: Updates<T[K]>): UpdateChange<T, K>;
+    /** Get a delete change for a collection in this database. */
+    getDelete<K extends Key<T>>(collection: K, id: string): DeleteChange<T, K>;
+}
+/** Database with a synchronous provider. */
+export declare class Database<T extends Datas = Datas> extends BaseDatabase<T> {
+    readonly provider: Provider<T>;
+    constructor(provider: Provider<T>);
+    collection<K extends Key<T>>(collection: K): Collection<T, K>;
+    query<K extends Key<T>>(collection: K, filters?: FilterList<Partial<ItemData<T[K]>>>, sorts?: SortList<Partial<ItemData<T[K]>>>, limit?: number | null): Query<T, K>;
+    item<K extends Key<T>>(collection: K, id: string): Item<T, K>;
+    change(...changes: DeepIterable<Nullish<WriteChange<T>>>[]): ItemChanges<T>;
+    get<K extends Key<T>>(collection: K, id: string): ItemValue<T[K]>;
+    add<K extends Key<T>>(collection: K, data: T[K]): string;
+    set<K extends Key<T>>(collection: K, id: string, data: T[K]): void;
+    update<K extends Key<T>>(collection: K, id: string, updates: Updates<T[K]>): void;
+    delete<K extends Key<T>>(collection: K, id: string): void;
+}
+/** Database with a synchronous provider. */
+export declare class AsyncDatabase<T extends Datas = Datas> extends BaseDatabase<T> {
+    readonly provider: AsyncProvider<T>;
+    constructor(provider: AsyncProvider<T>);
+    collection<K extends Key<T>>(collection: K): AsyncCollection<T, K>;
+    query<K extends Key<T>>(collection: K, filters?: FilterList<Partial<ItemData<T[K]>>>, sorts?: SortList<Partial<ItemData<T[K]>>>, limit?: number | null): AsyncQuery<T, K>;
+    item<K extends Key<T>>(collection: K, id: string): AsyncItem<T, K>;
+    change(...changes: DeepIterable<Nullish<WriteChange<T>>>[]): Promise<ItemChanges<T>>;
+    get<K extends Key<T>>(collection: K, id: string): Promise<ItemValue<T[K]>>;
+    add<K extends Key<T>>(collection: K, data: T[K]): Promise<string>;
+    set<K extends Key<T>>(collection: K, id: string, data: T[K]): Promise<void>;
+    update<K extends Key<T>>(collection: K, id: string, updates: Updates<T[K]>): Promise<void>;
+    delete<K extends Key<T>>(collection: K, id: string): Promise<void>;
+}
+export {};

package/modules/db/Database.js

@@ -0,0 +1,95 @@
+import { Item, AsyncItem } from "./Item.js";
+import { Query, AsyncQuery } from "./Query.js";
+import { Collection, AsyncCollection } from "./Collection.js";
+import { changeAsyncProvider, changeProvider } from "./Change.js";
+/** Database with a synchronous or asynchronous provider. */
+class BaseDatabase {
+    /** Subscribe a document from a collection in this database. */
+    subscribe(collection, id, next) {
+        return this.provider.subscribeItem(collection, id, typeof next === "function" ? { next } : next);
+    }
+    /** Get an add change for a collection in this database. */
+    getAdd(collection, data) {
+        return { action: "ADD", collection, data };
+    }
+    /** Get a set change for a collection in this database. */
+    getSet(collection, id, data) {
+        return { action: "SET", collection, id, data };
+    }
+    /** Get an update change for a collection in this database. */
+    getUpdate(collection, id, updates) {
+        return { action: "UPDATE", collection, id, updates };
+    }
+    /** Get a delete change for a collection in this database. */
+    getDelete(collection, id) {
+        return { action: "DELETE", collection, id };
+    }
+}
+/** Database with a synchronous provider. */
+export class Database extends BaseDatabase {
+    constructor(provider) {
+        super();
+        this.provider = provider;
+    }
+    collection(collection) {
+        return new Collection(this, collection);
+    }
+    query(collection, filters, sorts, limit) {
+        return new Query(this, collection, filters, sorts, limit);
+    }
+    item(collection, id) {
+        return new Item(this, collection, id);
+    }
+    change(...changes) {
+        return changeProvider(this.provider, changes);
+    }
+    get(collection, id) {
+        return this.provider.getItem(collection, id);
+    }
+    add(collection, data) {
+        return this.provider.addItem(collection, data);
+    }
+    set(collection, id, data) {
+        return this.provider.setItem(collection, id, data);
+    }
+    update(collection, id, updates) {
+        return this.provider.updateItem(collection, id, updates);
+    }
+    delete(collection, id) {
+        return this.provider.deleteItem(collection, id);
+    }
+}
+/** Database with a synchronous provider. */
+export class AsyncDatabase extends BaseDatabase {
+    constructor(provider) {
+        super();
+        this.provider = provider;
+    }
+    collection(collection) {
+        return new AsyncCollection(this, collection);
+    }
+    query(collection, filters, sorts, limit) {
+        return new AsyncQuery(this, collection, filters, sorts, limit);
+    }
+    item(collection, id) {
+        return new AsyncItem(this, collection, id);
+    }
+    change(...changes) {
+        return changeAsyncProvider(this.provider, changes);
+    }
+    get(collection, id) {
+        return this.provider.getItem(collection, id);
+    }
+    add(collection, data) {
+        return this.provider.addItem(collection, data);
+    }
+    set(collection, id, data) {
+        return this.provider.setItem(collection, id, data);
+    }
+    update(collection, id, updates) {
+        return this.provider.updateItem(collection, id, updates);
+    }
+    delete(collection, id) {
+        return this.provider.deleteItem(collection, id);
+    }
+}