liwi-mongo 13.4.0 → 14.1.0

package/README.md

@@ -81,7 +81,9 @@ interface MongoBaseModel<KeyValue extends AllowedKeyValue = string> {
 }
 ```
 
-The key path is always `_id`. `MongoInsertType<Model>` makes `_id`, `created` and `updated` optional; the store fills `created` / `updated` on insert and `updated` on every update. `insertOne` mutates and returns the object you passed.
+The key path is always `_id`. `MongoInsertType<Model>` makes `_id`, `created` and `updated` optional. Every write sets `updated` to the write time from the app clock, and an update or a replace never changes `created`: see [`created` and `updated`](../liwi-store#created-and-updated) for the rule of each method. `insertOne` and `upsertOne` mutate and return the object you passed; `replaceOne` leaves it untouched and returns the stored document.
+
+Requires MongoDB ≥ 4.2: replaces are update pipelines.
 
 ## `MongoConnection`
 
@@ -91,6 +93,12 @@ new MongoConnection({ host, port, database, user, password });
 
 `host` defaults to `localhost` and `port` to `27017`; `database` is required. Connecting starts immediately in the constructor and is awaited lazily by store operations, so no explicit `connect()` call is needed. Credentials are redacted from logs. Call `connection.close()` on shutdown.
 
+```ts
+new MongoConnection({ client });
+```
+
+Uses a `MongoClient` you created yourself, connected or connecting: a connection string or client options `MongoConfig` does not cover, or the [in-memory client](#in-memory). `close()` closes it.
+
 ## `MongoStore`
 
 ```ts
@@ -111,6 +119,29 @@ const set: Update<Task>["$set"] = { completed: true };
 
 The store also exposes the underlying driver handles when you need them: `store.collection` resolves the `mongodb` collection.
 
+### Writes and their cost
+
+The plain methods do one round trip and do not read the previous document:
+
+| Method               | Driver call                                                           | Missing key            |
+| -------------------- | --------------------------------------------------------------------- | ---------------------- |
+| `partialUpdateByKey` | `findOneAndUpdate` with `returnDocument: "after"`                     | throws `NotFoundError` |
+| `partialUpdateMany`  | one `updateMany`; every document gets the same `updated`              | —                      |
+| `replaceOne`         | `findOneAndUpdate` with a replace pipeline, `returnDocument: "after"` | throws `NotFoundError` |
+| `deleteByKey`        | `deleteOne`                                                           | no-op                  |
+
+The replace pipeline is `$replaceWith` of the object (wrapped in `$literal`, so string values starting with `$` stay data) merged with the stored `created`. A plain `replaceOne` command could not keep `created`.
+
+The [`…WithInfo` variants](../liwi-store#writes-with-info) also return the previous document, read atomically with the write. The subscribe store uses them:
+
+| Method                       | Driver calls                                                                                                            |
+| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| `partialUpdateByKeyWithInfo` | `findOneAndUpdate` with `returnDocument: "before"`, then `findOne` for `next`                                           |
+| `replaceOneWithInfo`         | the replace pipeline with `returnDocument: "before"`; `next` is the replacement with the stored `created`, no read back |
+| `deleteByKeyWithInfo`        | `findOneAndDelete`                                                                                                      |
+
+Mongo cannot return both the before and after documents of one update, so `partialUpdateByKeyWithInfo` reads `next` back. That read may already include a later concurrent write (which emits its own change), and it finds nothing if a concurrent delete landed first: `next` is then `undefined` although the update was applied.
+
 ## Indexes
 
 Indexes are declared on the store and applied by an explicit sync step. The declaration is validated eagerly in the constructor (empty key, a name resolving to `_id_`, duplicate names, more than one text index).
@@ -259,7 +290,7 @@ const subscription = query.fetchAndSubscribe((error, changes) => {
 subscription.stop();
 ```
 
-`createQuerySingleItem` behaves the same but resolves a single item.
+`createQuerySingleItem` behaves the same but resolves a single item. Without `sort`, its criteria must match at most one document: when one update moves several matching documents, the subscription reports the error `should not match more than 1, use sort if you can have multiple match` through its callback. With `sort`, it refetches on every relevant update.
 
 Subscriptions are driven in-process: writes going through the subscribe store are matched against the query criteria with [mingo](https://github.com/kofrasa/mingo).
 
@@ -268,3 +299,113 @@ Caveats:
 - Writes performed outside this process (other services, mongo shell, migrations) are not detected.
 - `$text` criteria cannot be matched in memory: such queries fetch correctly but never emit updates.
 - Queries returned by the subscribe store are fixed — `changeParams` throws; build a new query when parameters change.
+
+## Testing
+
+Two ways to give tests a database, both behind the same `MongoConnection`, so the stores and the app code under test do not change.
+
+### A real mongod
+
+The behaviour is mongod's by definition. Start one per test run with [`mongodb-memory-server`](https://github.com/typegoose/mongodb-memory-server) (it downloads a mongod binary once, then starts in about a second) or point at a mongod you already run:
+
+```ts
+import { MongoMemoryServer } from "mongodb-memory-server-core";
+import { MongoConnection, MongoRegistry } from "liwi-mongo";
+
+const mongod = await MongoMemoryServer.create();
+const connection = new MongoConnection({
+  host: "127.0.0.1",
+  port: mongod.instanceInfo!.port,
+  database: "app-test",
+});
+const stores = createStores(connection); // your app's MongoStore instances
+await new MongoRegistry(stores).syncIndexes();
+
+// between tests
+await Promise.all(stores.map((store) => store.deleteMany({})));
+
+// teardown
+await connection.close();
+await mongod.stop();
+```
+
+Nothing in liwi is needed for this. Every write is a round trip to another process, which is what makes a large e2e suite slow.
+
+### In memory
+
+`liwi-mongo/memory` is a mongo client that keeps the data in the test process: no binary, no port, no round trip. `MongoStore`, its queries, subscriptions and `MongoRegistry.syncIndexes` run unchanged on top of it; queries, sorts, projections, update operators and pipelines are evaluated by [mingo](https://github.com/kofrasa/mingo).
+
+```ts
+import { MongoConnection, MongoRegistry } from "liwi-mongo";
+import { createMemoryMongoClient } from "liwi-mongo/memory";
+
+const memory = createMemoryMongoClient();
+const connection = new MongoConnection({ client: memory.client });
+const stores = createStores(connection);
+await new MongoRegistry(stores).syncIndexes();
+
+// between tests: empties every collection, indexes stay
+memory.clear();
+```
+
+An e2e server can switch on an environment variable, and import the entry only in that mode:
+
+```ts
+const connection = process.env.E2E_MEMORY_DATABASE
+  ? new MongoConnection({
+      client: (await import("liwi-mongo/memory")).createMemoryMongoClient()
+        .client,
+    })
+  : new MongoConnection(config.mongo);
+```
+
+Sync the indexes as production does: the memory client only enforces the unique indexes it was asked to create.
+
+`createMemoryMongoClient({ database })` — `database` (default `liwi-memory`) is the one `client.db()` returns. Every client has its own data.
+
+#### Behaviour
+
+Documents are written and read back the way the driver serializes them: `undefined` becomes `null`, functions are dropped, a `Buffer` becomes a `Binary`, a class instance or a `Map` becomes a plain document. Every read returns a copy. A missing `_id` is generated as an `ObjectId`, set on the object passed in, as the driver does.
+
+Indexes are listed as mongod lists them, so a second `syncIndexes` plans nothing. Unique indexes are enforced, with `sparse`, `partialFilterExpression`, compound and array (multikey) keys, and a case-insensitive `collation` (strength 1 or 2). A violation throws a `MongoServerError` with code `11000`, `keyPattern` and `keyValue`.
+
+Errors carry mongod's codes where code reads them: `26` (missing collection on `listIndexes` / `dropIndex`), `27` (missing index), `40` (conflicting update paths), `66` (`_id` change), `85` / `86` (index conflicts), `11000` (duplicate key).
+
+Implemented driver methods:
+
+- client: `db`, `connect`, `close`, `on`
+- db: `collection`, `command` (`ping`, `collMod` of an index), `dropDatabase`
+- collection: `insertOne`, `insertMany`, `findOne`, `find` (`sort`, `project`, `skip`, `limit`), `countDocuments`, `estimatedDocumentCount`, `aggregate` (with `$lookup` on other collections of the database), `updateOne`, `updateMany`, `findOneAndUpdate` (`upsert`, `arrayFilters`, `sort`, `returnDocument`, `projection`), `deleteOne`, `deleteMany`, `findOneAndDelete`, `createIndex`, `createIndexes`, `listIndexes`, `indexes`, `dropIndex`, `drop`
+
+Reading any other method throws `liwi-mongo/memory: collection(<name>).<method> is not supported` rather than `undefined is not a function`.
+
+#### What differs from mongod
+
+- `$text` queries and `$meta` sorts throw; text indexes are created and listed, not searched.
+- TTL indexes (`expireAfterSeconds`) never expire documents.
+- No transactions, sessions, change streams (`watch`) or `bulkWrite`. Options such as `session`, `writeConcern` or `collation` on a query are ignored.
+- Writes are never concurrent: each operation runs to completion before the next one starts. Code relying on mongod interleaving two writes is not exercised.
+- `insertMany` stops at the first error and throws it as is, not as a `MongoBulkWriteError`.
+- `$out` and `$merge` stages do not write.
+- `$currentDate` reads this process clock.
+- Data is lost when the process exits, and invisible to any other process: an e2e test that reads the database directly must do so through the server.
+
+#### Contract suite
+
+[`src/memory/contract.test.ts`](src/memory/contract.test.ts) runs the same scenarios against the memory client and against a real mongod started with `mongodb-memory-server`. The mongod run is opt-in:
+
+```bash
+pnpm --filter liwi-mongo run test:integration
+```
+
+A behaviour difference found in an app belongs there first, as a scenario that passes on mongod and fails in memory.
+
+### Choosing
+
+|                  | Real mongod                                   | In memory                              |
+| ---------------- | --------------------------------------------- | -------------------------------------- |
+| Fidelity         | exact                                         | the [contract suite](#contract-suite)  |
+| Setup            | binary download (cache it in CI), a free port | none                                   |
+| Speed            | a round trip per operation                    | a function call                        |
+| Data shared with | any process connecting to it                  | the process that created it            |
+| Not covered      |                                               | [see above](#what-differs-from-mongod) |

package/dist/definitions/MongoConnection.d.ts

@@ -8,6 +8,10 @@ export interface MongoConfig {
     password?: string;
     authSource?: string;
 }
+export interface MongoClientConfig {
+    /** Used as is, connected or connecting: `close()` closes it. */
+    client: mongodb.MongoClient;
+}
 interface BuildMongoConnectionStringParams extends MongoConfig {
     redactCredentials: boolean;
 }
@@ -16,8 +20,9 @@ export default class MongoConnection extends AbstractConnection {
     _connection?: mongodb.MongoClient;
     _connecting?: Promise<mongodb.MongoClient>;
     connectionFailed?: boolean;
-    constructor(config: MongoConfig);
+    constructor(config: MongoClientConfig | MongoConfig);
     connect(connectionString: string, connectionStringRedacted: string): void;
+    private useClient;
     getConnection(): Promise<mongodb.MongoClient>;
     close(): Promise<void>;
 }

package/dist/definitions/MongoConnection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MongoConnection.d.ts","sourceRoot":"","sources":["../../src/MongoConnection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,OAAO,MAAM,SAAS,CAAC;AAK9B,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,gCAAiC,SAAQ,WAAW;IAC5D,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,eAAO,MAAM,0BAA0B,6EAQpC,gCAAgC,KAAG,MAalC,CAAC;AAEL,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,kBAAkB;IAC7D,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC;IAElC,WAAW,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAE3C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAG3B,YAAY,MAAM,EAAE,WAAW,EAiB9B;IAED,OAAO,CAAC,gBAAgB,EAAE,MAAM,EAAE,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAgDxE;IAED,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAE5C;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAS3B;CACF"}
+{"version":3,"file":"MongoConnection.d.ts","sourceRoot":"","sources":["../../src/MongoConnection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,OAAO,MAAM,SAAS,CAAC;AAK9B,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,gEAAgE;IAChE,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC;CAC7B;AAED,UAAU,gCAAiC,SAAQ,WAAW;IAC5D,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,eAAO,MAAM,0BAA0B,6EAQpC,gCAAgC,KAAG,MAalC,CAAC;AAEL,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,kBAAkB;IAC7D,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC;IAElC,WAAW,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAE3C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,YAAY,MAAM,EAAE,iBAAiB,GAAG,WAAW,EAsBlD;IAED,OAAO,CAAC,gBAAgB,EAAE,MAAM,EAAE,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAuBxE;IAED,OAAO,CAAC,SAAS;IAgCjB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAE5C;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAS3B;CACF"}

package/dist/definitions/MongoCursor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MongoCursor.d.ts","sourceRoot":"","sources":["../../src/MongoCursor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAE3C,MAAM,CAAC,OAAO,OAAO,WAAW,CAC9B,KAAK,SAAS,cAAc,CAAC,QAAQ,CAAC,EACtC,MAAM,SAAS,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,EACrC,QAAQ,SAAS,eAAe,GAAG,KAAK,CAAC,KAAK,CAAC,CAC/C,SAAQ,mBAAmB,CAC3B,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,EAC3B,QAAQ,EACR,KAAK,EACL,MAAM,CACP;IAGC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAE5C,OAAO,CAAC,OAAO,CAAC,CAAgB;IAEhC,YAAY,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,EAGzE;IAED,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAE3B;IAED,IAAI,IAAI,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAMpC;IAEc,OAAO,CACpB,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GACjD,OAAO,CAAC,IAAI,CAAC,CAIf;IAED,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGrC;IAEQ,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,CAGjC;IAED,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAMrB;IAED,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAE3B;CACF"}
+{"version":3,"file":"MongoCursor.d.ts","sourceRoot":"","sources":["../../src/MongoCursor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAE3C,MAAM,CAAC,OAAO,OAAO,WAAW,CAC9B,KAAK,SAAS,cAAc,CAAC,QAAQ,CAAC,EACtC,MAAM,SAAS,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,EACrC,QAAQ,SAAS,eAAe,GAAG,KAAK,CAAC,KAAK,CAAC,CAC/C,SAAQ,mBAAmB,CAC3B,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,EAC3B,QAAQ,EACR,KAAK,EACL,MAAM,CACP;IAGC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAE5C,OAAO,CAAC,OAAO,CAAC,CAAgB;IAEhC,YAAY,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,EAGzE;IAED,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAE3B;IAED,IAAI,IAAI,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAMpC;IAEc,OAAO,CACpB,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GACjD,OAAO,CAAC,IAAI,CAAC,CAIf;IAED,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGrC;IAEQ,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,CAGjC;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAI3B;IAED,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAE3B;CACF"}

package/dist/definitions/MongoQuerySingleItem.d.ts

@@ -11,6 +11,7 @@ export default class MongoQuerySingleItem<Model extends MongoBaseModel<KeyValue>
     constructor(store: MongoStore<Model, KeyValue>, options: QueryOptions<Model>, transformer?: Transformer<Model, Result>);
     createMingoTestCriteria(): TestCriteria;
     fetch<T>(onFulfilled: (result: QueryResult<Result>) => T): Promise<T>;
+    private computeChanges;
     _subscribe(callback: SubscribeCallback<KeyValue, Result>, _includeInitial: boolean): QuerySubscription;
     private createMongoCursor;
 }

package/dist/definitions/MongoQuerySingleItem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MongoQuerySingleItem.d.ts","sourceRoot":"","sources":["../../src/MongoQuerySingleItem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAEf,YAAY,EACZ,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAC;AAEtE,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,YAAY,EACb,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAS3C,KAAK,YAAY,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC;AAE1C,MAAM,CAAC,OAAO,OAAO,oBAAoB,CACvC,KAAK,SAAS,cAAc,CAAC,QAAQ,CAAC,EACtC,MAAM,SAAS,WAAW,CAAC,MAAM,CAAC,GAAG,KAAK,EAC1C,MAAM,SAAS,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,EACnE,QAAQ,SAAS,eAAe,GAAG,KAAK,CAAC,KAAK,CAAC,CAC/C,SAAQ,8BAA8B,CACtC,YAAY,EACZ,QAAQ,EACR,KAAK,EACL,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC,EAChC,MAAM,EACN,MAAM,CACP;IACC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8B;IAEpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAE9C,OAAO,CAAC,YAAY,CAAC,CAAe;IAEpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IAEzD,YACE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,EAClC,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,EAC5B,WAAW,GAAE,WAAW,CAAC,KAAK,EAAE,MAAM,CAAuB,EAM9D;IAED,uBAAuB,IAAI,YAAY,CAWtC;IAEK,KAAK,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAe1E;IAED,UAAU,CACR,QAAQ,EAAE,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,EAC7C,eAAe,EAAE,OAAO,GACvB,iBAAiB,CAmFnB;YAEa,iBAAiB;CAehC"}
+{"version":3,"file":"MongoQuerySingleItem.d.ts","sourceRoot":"","sources":["../../src/MongoQuerySingleItem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAEf,YAAY,EACZ,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAC;AAEtE,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,YAAY,EACb,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAS3C,KAAK,YAAY,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC;AAE1C,MAAM,CAAC,OAAO,OAAO,oBAAoB,CACvC,KAAK,SAAS,cAAc,CAAC,QAAQ,CAAC,EACtC,MAAM,SAAS,WAAW,CAAC,MAAM,CAAC,GAAG,KAAK,EAC1C,MAAM,SAAS,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,EACnE,QAAQ,SAAS,eAAe,GAAG,KAAK,CAAC,KAAK,CAAC,CAC/C,SAAQ,8BAA8B,CACtC,YAAY,EACZ,QAAQ,EACR,KAAK,EACL,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC,EAChC,MAAM,EACN,MAAM,CACP;IACC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8B;IAEpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAE9C,OAAO,CAAC,YAAY,CAAC,CAAe;IAEpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IAEzD,YACE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,EAClC,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,EAC5B,WAAW,GAAE,WAAW,CAAC,KAAK,EAAE,MAAM,CAAuB,EAM9D;IAED,uBAAuB,IAAI,YAAY,CAWtC;IAEK,KAAK,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAe1E;YAEa,cAAc;IAkD5B,UAAU,CACR,QAAQ,EAAE,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,EAC7C,eAAe,EAAE,OAAO,GACvB,iBAAiB,CAuCnB;YAEa,iBAAiB;CAehC"}

package/dist/definitions/MongoQuerySingleItem.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=MongoQuerySingleItem.test.d.ts.map

package/dist/definitions/MongoQuerySingleItem.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MongoQuerySingleItem.test.d.ts","sourceRoot":"","sources":["../../src/MongoQuerySingleItem.test.ts"],"names":[],"mappings":""}

package/dist/definitions/MongoStore.d.ts

@@ -1,4 +1,4 @@
-import type { AllowedKeyValue, CreateQueryOptions, Criteria, Fields, OptionalBaseModelKeysForInsert, QueryParams, Sort, SubscribableStore, Update, UpsertPartialObject, UpsertResult } from "liwi-store";
+import type { AllowedKeyValue, CreateQueryOptions, Criteria, DeleteResult, Fields, OptionalBaseModelKeysForInsert, PartialUpdateOptions, PartialUpdateResult, QueryParams, Sort, SubscribableStore, Update, UpsertPartialObject, UpsertResult, WriteResult } from "liwi-store";
 import type { Collection } from "mongodb";
 import type { MongoBaseModel, MongoInsertType, MongoKeyPath } from "./MongoBaseModel.ts";
 import type MongoConnection from "./MongoConnection.ts";
@@ -23,14 +23,28 @@ export default class MongoStore<Model extends MongoBaseModel<KeyValue>, KeyValue
     createQuerySingleItem<Result extends Record<MongoKeyPath, KeyValue> = Model, Params extends QueryParams<Params> = never>({ transformer, ...options }: CreateQueryOptions<Model, Result>): MongoQuerySingleItem<Model, Params, Result, KeyValue>;
     createQueryCollection<Item extends Record<MongoKeyPath, KeyValue> = Model, Params extends QueryParams<Params> = never>({ transformer, ...options }: CreateQueryOptions<Model, Item>): MongoQueryCollection<Model, Params, Model["_id"], Item>;
     insertOne(object: MongoInsertType<Model>): Promise<Model>;
+    /**
+     * Always sets `updated` to the write time and keeps the stored `created`: the
+     * object's own `created` and `updated` are ignored. The object is not mutated.
+     */
     replaceOne(object: Model): Promise<Model>;
+    /** Same rules as `replaceOne`; `next` is derived from the atomic `prev`, no read back. */
+    replaceOneWithInfo(object: Model): Promise<WriteResult<Model> | undefined>;
     upsertOne<K extends Exclude<keyof Model, MongoKeyPath | OptionalBaseModelKeysForInsert>>(object: UpsertPartialObject<MongoKeyPath, KeyValue, Model, K>, setOnInsertPartialObject?: Update<Model>["$setOnInsert"]): Promise<Model>;
     upsertOneWithInfo<K extends Exclude<keyof Model, MongoKeyPath | OptionalBaseModelKeysForInsert>>(object: UpsertPartialObject<MongoKeyPath, KeyValue, Model, K>, setOnInsertPartialObject?: Update<Model>["$setOnInsert"]): Promise<MongoUpsertResult<KeyValue, Model>>;
     replaceSeveral(objects: Model[]): Promise<Model[]>;
-    partialUpdateByKey(key: KeyValue, partialUpdate: Update<Model>, criteria?: Criteria<Model>): Promise<Model>;
-    partialUpdateOne(object: Model, partialUpdate: Update<Model>): Promise<Model>;
-    partialUpdateMany(criteria: Criteria<Model>, partialUpdate: Update<Model>): Promise<void>;
+    partialUpdateByKey(key: KeyValue, partialUpdate: Update<Model>, criteria?: Criteria<Model>, options?: PartialUpdateOptions): Promise<Model>;
+    /**
+     * `prev` is read atomically with the write. `next` is read right after it,
+     * so it may already include a later concurrent write, which emits its own change.
+     * Resolves `undefined` when no document matches.
+     */
+    partialUpdateByKeyWithInfo(key: KeyValue, partialUpdate: Update<Model>, criteria?: Criteria<Model>, options?: PartialUpdateOptions): Promise<PartialUpdateResult<Model> | undefined>;
+    partialUpdateOne(object: Model, partialUpdate: Update<Model>, options?: PartialUpdateOptions): Promise<Model>;
+    /** One `updateMany` command; every document gets the same `updated`. */
+    partialUpdateMany(criteria: Criteria<Model>, partialUpdate: Update<Model>, options?: PartialUpdateOptions): Promise<void>;
     deleteByKey(key: KeyValue, criteria?: Criteria<Model>): Promise<void>;
+    deleteByKeyWithInfo(key: KeyValue, criteria?: Criteria<Model>): Promise<DeleteResult<Model> | undefined>;
     deleteOne(object: Model): Promise<void>;
     deleteMany(selector: Criteria<Model>): Promise<void>;
     count(filter?: Criteria<Model>): Promise<number>;

package/dist/definitions/MongoStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MongoStore.d.ts","sourceRoot":"","sources":["../../src/MongoStore.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"MongoStore.d.ts","sourceRoot":"","sources":["../../src/MongoStore.ts"],"names":[],"mappings":"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"}

package/dist/definitions/SubscribeStore.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SubscribeStore.integration.test.d.ts.map

package/dist/definitions/SubscribeStore.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubscribeStore.integration.test.d.ts","sourceRoot":"","sources":["../../src/SubscribeStore.integration.test.ts"],"names":[],"mappings":""}

package/dist/definitions/index.d.ts

@@ -1,7 +1,7 @@
 export type { MongoBaseModel, MongoKeyPath, MongoInsertType, } from "./MongoBaseModel";
 export type { Update } from "liwi-store";
 export { default as MongoStore, type MongoStoreOptions } from "./MongoStore.ts";
-export { default as MongoConnection, type MongoConfig, } from "./MongoConnection.ts";
+export { default as MongoConnection, type MongoClientConfig, type MongoConfig, } from "./MongoConnection.ts";
 export { default as createMongoSubscribeStore, type SubscribeStore, } from "./createMongoSubscribeStore.ts";
 export { default as MongoRegistry, type MongoRegistryOptions, } from "./MongoRegistry.ts";
 export type { MongoRegistryStore } from "./MongoRegistryStore.ts";

package/dist/definitions/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EACd,YAAY,EACZ,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,EACL,OAAO,IAAI,eAAe,EAC1B,KAAK,WAAW,GACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,OAAO,IAAI,yBAAyB,EACpC,KAAK,cAAc,GACpB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,OAAO,IAAI,aAAa,EACxB,KAAK,oBAAoB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,YAAY,EACV,UAAU,EACV,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,EACL,eAAe,EACf,gBAAgB,GACjB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,aAAa,EACb,KAAK,mBAAmB,GACzB,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EACd,YAAY,EACZ,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,EACL,OAAO,IAAI,eAAe,EAC1B,KAAK,iBAAiB,EACtB,KAAK,WAAW,GACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,OAAO,IAAI,yBAAyB,EACpC,KAAK,cAAc,GACpB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,OAAO,IAAI,aAAa,EACxB,KAAK,oBAAoB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,YAAY,EACV,UAAU,EACV,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,EACL,eAAe,EACf,gBAAgB,GACjB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,aAAa,EACb,KAAK,mBAAmB,GACzB,MAAM,4BAA4B,CAAC"}

package/dist/definitions/memory/applyUpdate.d.ts

@@ -0,0 +1,23 @@
+import type { Document } from "mongodb";
+export type MemoryUpdate = Document | Document[];
+/** The driver rejects these before sending them. */
+export declare const assertUpdate: (update: MemoryUpdate) => void;
+/** The document an upsert starts from: the equality conditions of its filter. */
+export declare const createUpsertBase: (filter: Document) => Document;
+interface ApplyUpdateOptions {
+    /** The filter that matched `document`: the positional `$` resolves against it. */
+    filter: Document;
+    arrayFilters?: Document[];
+    isInsert: boolean;
+}
+interface AppliedUpdate {
+    next: Document;
+    isModified: boolean;
+}
+/**
+ * Applies `update` to a copy: `document` is never mutated. The update is read as
+ * the driver serializes it, `undefined` as `null`.
+ */
+export declare const applyUpdate: (document: Document, update: MemoryUpdate, { filter, arrayFilters, isInsert }: ApplyUpdateOptions) => AppliedUpdate;
+export {};
+//# sourceMappingURL=applyUpdate.d.ts.map

package/dist/definitions/memory/applyUpdate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applyUpdate.d.ts","sourceRoot":"","sources":["../../../src/memory/applyUpdate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAOxC,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,EAAE,CAAC;AAWjD,oDAAoD;AACpD,eAAO,MAAM,YAAY,WAAY,YAAY,KAAG,IAWnD,CAAC;AAiDF,iFAAiF;AACjF,eAAO,MAAM,gBAAgB,WAAY,QAAQ,KAAG,QAkBnD,CAAC;AAEF,UAAU,kBAAkB;IAC1B,kFAAkF;IAClF,MAAM,EAAE,QAAQ,CAAC;IACjB,YAAY,CAAC,EAAE,QAAQ,EAAE,CAAC;IAC1B,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,aACZ,QAAQ,UACV,YAAY,sCACgB,kBAAkB,KACrD,aAwBF,CAAC"}

package/dist/definitions/memory/cloneAsStored.d.ts

@@ -0,0 +1,10 @@
+import type { Document } from "mongodb";
+/**
+ * Copies a value the way the driver writes it then reads it back: `undefined`
+ * becomes `null` (`ignoreUndefined` is off), functions are dropped, bytes become
+ * a `Binary`, a `Map` or a class instance becomes a plain document.
+ * BSON values (`ObjectId`, `Decimal128`...) are immutable and kept as is.
+ */
+export declare const cloneAsStored: (value: unknown) => unknown;
+export declare const cloneDocument: <T extends Document>(document: T) => T;
+//# sourceMappingURL=cloneAsStored.d.ts.map

package/dist/definitions/memory/cloneAsStored.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloneAsStored.d.ts","sourceRoot":"","sources":["../../../src/memory/cloneAsStored.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAUxC;;;;;GAKG;AACH,eAAO,MAAM,aAAa,UAAW,OAAO,KAAG,OAc9C,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,QAAQ,YAAY,CAAC,KAAG,CAClC,CAAC"}

package/dist/definitions/memory/cloneAsStored.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cloneAsStored.test.d.ts.map

package/dist/definitions/memory/cloneAsStored.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloneAsStored.test.d.ts","sourceRoot":"","sources":["../../../src/memory/cloneAsStored.test.ts"],"names":[],"mappings":""}

package/dist/definitions/memory/contract.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contract.test.d.ts.map

package/dist/definitions/memory/contract.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.test.d.ts","sourceRoot":"","sources":["../../../src/memory/contract.test.ts"],"names":[],"mappings":""}

package/dist/definitions/memory/createMemoryCollection.d.ts

@@ -0,0 +1,19 @@
+import type { Document } from "mongodb";
+import type { MemoryIndexChanges } from "./indexes/createMemoryIndexes.ts";
+export interface MemoryCollection {
+    /** The driver's `Collection`, for the methods this package implements. */
+    readonly api: object;
+    readonly listDocuments: () => Document[];
+    readonly modifyIndex: (changes: MemoryIndexChanges) => void;
+    readonly clear: () => void;
+    readonly drop: () => void;
+}
+interface CreateMemoryCollectionParams {
+    databaseName: string;
+    collectionName: string;
+    /** `$lookup`, `$graphLookup` and `$unionWith` read other collections of the database. */
+    resolveCollection: (collectionName: string) => Document[];
+}
+export declare const createMemoryCollection: ({ databaseName, collectionName, resolveCollection, }: CreateMemoryCollectionParams) => MemoryCollection;
+export {};
+//# sourceMappingURL=createMemoryCollection.d.ts.map

package/dist/definitions/memory/createMemoryCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createMemoryCollection.d.ts","sourceRoot":"","sources":["../../../src/memory/createMemoryCollection.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,QAAQ,EAKT,MAAM,SAAS,CAAC;AAgBjB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AA6B3E,MAAM,WAAW,gBAAgB;IAC/B,0EAA0E;IAC1E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,aAAa,EAAE,MAAM,QAAQ,EAAE,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED,UAAU,4BAA4B;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,yFAAyF;IACzF,iBAAiB,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,QAAQ,EAAE,CAAC;CAC3D;AAWD,eAAO,MAAM,sBAAsB,yDAIhC,4BAA4B,KAAG,gBAmUjC,CAAC"}

package/dist/definitions/memory/createMemoryCursor.d.ts

@@ -0,0 +1,29 @@
+import type { Document, Sort } from "mongodb";
+export interface MemoryCursor<T> {
+    next: () => Promise<T | null>;
+    tryNext: () => Promise<T | null>;
+    hasNext: () => Promise<boolean>;
+    toArray: () => Promise<T[]>;
+    /** Stops when `iterator` returns `false`. */
+    forEach: (iterator: (document: T) => unknown) => Promise<void>;
+    close: () => Promise<void>;
+    [Symbol.asyncIterator]: () => AsyncGenerator<T, void>;
+}
+/** Runs `run` on the first read: the results are a snapshot, as a single batch would be. */
+export declare const createMemoryCursor: <T>(run: () => T[]) => MemoryCursor<T> & {
+    isStarted: () => boolean;
+};
+export interface MemoryFindOptions {
+    sort?: Sort;
+    projection?: Document;
+    skip?: number;
+    limit?: number;
+}
+export interface MemoryFindCursor<T> extends MemoryCursor<T> {
+    sort: (sort: Sort) => MemoryFindCursor<T>;
+    project: (projection: Document) => MemoryFindCursor<T>;
+    skip: (skip: number) => MemoryFindCursor<T>;
+    limit: (limit: number) => MemoryFindCursor<T>;
+}
+export declare const createMemoryFindCursor: <T>(run: (options: MemoryFindOptions) => T[], initialOptions: MemoryFindOptions) => MemoryFindCursor<T>;
+//# sourceMappingURL=createMemoryCursor.d.ts.map

package/dist/definitions/memory/createMemoryCursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createMemoryCursor.d.ts","sourceRoot":"","sources":["../../../src/memory/createMemoryCursor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAI9C,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC9B,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAC5B,6CAA6C;IAC7C,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,MAAM,cAAc,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;CACvD;AAED,4FAA4F;AAC5F,eAAO,MAAM,kBAAkB,GAAI,CAAC,OAC7B,MAAM,CAAC,EAAE,KACb,YAAY,CAAC,CAAC,CAAC,GAAG;IAAE,SAAS,EAAE,MAAM,OAAO,CAAA;CA8B9C,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,UAAU,CAAC,EAAE,QAAQ,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC,CAAE,SAAQ,YAAY,CAAC,CAAC,CAAC;IAC1D,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAC1C,OAAO,EAAE,CAAC,UAAU,EAAE,QAAQ,KAAK,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACvD,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAC5C,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,gBAAgB,CAAC,CAAC,CAAC,CAAC;CAC/C;AAED,eAAO,MAAM,sBAAsB,GAAI,CAAC,OACjC,CAAC,OAAO,EAAE,iBAAiB,KAAK,CAAC,EAAE,kBACxB,iBAAiB,KAChC,gBAAgB,CAAC,CAAC,CAsBpB,CAAC"}

package/dist/definitions/memory/createMemoryCursor.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=createMemoryCursor.test.d.ts.map

package/dist/definitions/memory/createMemoryCursor.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createMemoryCursor.test.d.ts","sourceRoot":"","sources":["../../../src/memory/createMemoryCursor.test.ts"],"names":[],"mappings":""}

package/dist/definitions/memory/createMemoryDb.d.ts

@@ -0,0 +1,7 @@
+export interface MemoryDb {
+    /** The driver's `Db`, for the methods this package implements. */
+    readonly api: object;
+    readonly clear: () => void;
+}
+export declare const createMemoryDb: (databaseName: string) => MemoryDb;
+//# sourceMappingURL=createMemoryDb.d.ts.map

package/dist/definitions/memory/createMemoryDb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createMemoryDb.d.ts","sourceRoot":"","sources":["../../../src/memory/createMemoryDb.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,QAAQ;IACvB,kEAAkE;IAClE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;CAC5B;AAED,eAAO,MAAM,cAAc,iBAAkB,MAAM,KAAG,QAkDrD,CAAC"}

package/dist/definitions/memory/createMemoryMongoClient.d.ts

@@ -0,0 +1,13 @@
+import type { MongoClient } from "mongodb";
+export interface MemoryMongoClient {
+    /** For `new MongoConnection({ client })`. A driver method it does not implement throws when read. */
+    client: MongoClient;
+    /** Empties every collection of every database; indexes stay. */
+    clear: () => void;
+}
+export interface MemoryMongoClientOptions {
+    /** The database `client.db()` returns. */
+    database?: string;
+}
+export declare const createMemoryMongoClient: ({ database, }?: MemoryMongoClientOptions) => MemoryMongoClient;
+//# sourceMappingURL=createMemoryMongoClient.d.ts.map

package/dist/definitions/memory/createMemoryMongoClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createMemoryMongoClient.d.ts","sourceRoot":"","sources":["../../../src/memory/createMemoryMongoClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAK3C,MAAM,WAAW,iBAAiB;IAChC,qGAAqG;IACrG,MAAM,EAAE,WAAW,CAAC;IACpB,gEAAgE;IAChE,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,uBAAuB,mBAEjC,wBAAwB,KAAQ,iBA2BlC,CAAC"}

package/dist/definitions/memory/createMemoryMongoClient.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=createMemoryMongoClient.test.d.ts.map

package/dist/definitions/memory/createMemoryMongoClient.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createMemoryMongoClient.test.d.ts","sourceRoot":"","sources":["../../../src/memory/createMemoryMongoClient.test.ts"],"names":[],"mappings":""}

package/dist/definitions/memory/errors.d.ts

@@ -0,0 +1,20 @@
+import type { Document } from "mongodb";
+import mongodb from "mongodb";
+interface DuplicateKeyErrorParams {
+    namespace: string;
+    indexName: string;
+    keyPattern: Document;
+    keyValue: Document;
+}
+export declare const createDuplicateKeyError: ({ namespace, indexName, keyPattern, keyValue, }: DuplicateKeyErrorParams) => mongodb.MongoServerError;
+export declare const createNamespaceNotFoundError: (namespace: string) => mongodb.MongoServerError;
+export declare const createIndexNotFoundError: (name: string) => mongodb.MongoServerError;
+export declare const createInvalidOptionsError: (message: string) => mongodb.MongoServerError;
+export declare const createIndexOptionsConflictError: (message: string) => mongodb.MongoServerError;
+export declare const createIndexKeySpecsConflictError: (message: string) => mongodb.MongoServerError;
+export declare const createImmutableIdError: () => mongodb.MongoServerError;
+/** The server error mongod answers for an update mingo rejects. */
+export declare const toServerError: (error: unknown) => unknown;
+export declare const createUnsupportedError: (feature: string) => TypeError;
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/definitions/memory/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/memory/errors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,OAAO,MAAM,SAAS,CAAC;AAe9B,UAAU,uBAAuB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,QAAQ,CAAC;IACrB,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,eAAO,MAAM,uBAAuB,oDAKjC,uBAAuB,KAAG,OAAO,CAAC,gBAMlC,CAAC;AAEJ,eAAO,MAAM,4BAA4B,cAC5B,MAAM,KAChB,OAAO,CAAC,gBACoE,CAAC;AAEhF,eAAO,MAAM,wBAAwB,SAC7B,MAAM,KACX,OAAO,CAAC,gBACoE,CAAC;AAEhF,eAAO,MAAM,yBAAyB,YAC3B,MAAM,KACd,OAAO,CAAC,gBAAoE,CAAC;AAEhF,eAAO,MAAM,+BAA+B,YACjC,MAAM,KACd,OAAO,CAAC,gBAC6C,CAAC;AAEzD,eAAO,MAAM,gCAAgC,YAClC,MAAM,KACd,OAAO,CAAC,gBAC8C,CAAC;AAE1D,eAAO,MAAM,sBAAsB,QAAO,OAAO,CAAC,gBAK/C,CAAC;AAQJ,mEAAmE;AACnE,eAAO,MAAM,aAAa,UAAW,OAAO,KAAG,OAM9C,CAAC;AAEF,eAAO,MAAM,sBAAsB,YAAa,MAAM,KAAG,SACQ,CAAC"}

package/dist/definitions/memory/guardUnsupported.d.ts

@@ -0,0 +1,3 @@
+/** A driver method this package does not implement throws its name instead of `undefined is not a function`. */
+export declare const guardUnsupported: <T extends object>(target: T, label: string) => T;
+//# sourceMappingURL=guardUnsupported.d.ts.map

package/dist/definitions/memory/guardUnsupported.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardUnsupported.d.ts","sourceRoot":"","sources":["../../../src/memory/guardUnsupported.ts"],"names":[],"mappings":"AAWA,gHAAgH;AAChH,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,MAAM,UACvC,CAAC,SACF,MAAM,KACZ,CASC,CAAC"}

package/dist/definitions/memory/indexes/createIndexInfo.d.ts

@@ -0,0 +1,5 @@
+import type { IndexDescription, IndexDescriptionInfo } from "mongodb";
+/** The index as `listIndexes` returns it once created from `description`. */
+export declare const createIndexInfo: (description: IndexDescription) => IndexDescriptionInfo;
+export declare const idIndexInfo: IndexDescriptionInfo;
+//# sourceMappingURL=createIndexInfo.d.ts.map

package/dist/definitions/memory/indexes/createIndexInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createIndexInfo.d.ts","sourceRoot":"","sources":["../../../../src/memory/indexes/createIndexInfo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AA0DhF,6EAA6E;AAC7E,eAAO,MAAM,eAAe,gBACb,gBAAgB,KAC5B,oBAcF,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,oBAIzB,CAAC"}

package/dist/definitions/memory/indexes/createIndexInfo.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=createIndexInfo.test.d.ts.map

package/dist/definitions/memory/indexes/createIndexInfo.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createIndexInfo.test.d.ts","sourceRoot":"","sources":["../../../../src/memory/indexes/createIndexInfo.test.ts"],"names":[],"mappings":""}

package/dist/definitions/memory/indexes/createMemoryIndexes.d.ts

@@ -0,0 +1,19 @@
+import type { Document, IndexDescription, IndexDescriptionInfo } from "mongodb";
+export interface MemoryIndexChanges {
+    name: string;
+    hidden?: boolean;
+    expireAfterSeconds?: number;
+}
+export interface MemoryIndexes {
+    list: () => IndexDescriptionInfo[];
+    /** Validates every description first, like `createIndexes`: nothing is created on a conflict. */
+    create: (descriptions: readonly IndexDescription[], documents: ReadonlyMap<string, Document>) => string[];
+    drop: (name: string) => void;
+    dropAll: () => void;
+    modify: (changes: MemoryIndexChanges) => void;
+    assertCanWrite: (documentKey: string, document: Document) => void;
+    write: (documentKey: string, previous: Document | undefined, next: Document | undefined) => void;
+    clearDocuments: () => void;
+}
+export declare const createMemoryIndexes: (namespace: string) => MemoryIndexes;
+//# sourceMappingURL=createMemoryIndexes.d.ts.map

package/dist/definitions/memory/indexes/createMemoryIndexes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createMemoryIndexes.d.ts","sourceRoot":"","sources":["../../../../src/memory/indexes/createMemoryIndexes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAiBhF,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,oBAAoB,EAAE,CAAC;IACnC,iGAAiG;IACjG,MAAM,EAAE,CACN,YAAY,EAAE,SAAS,gBAAgB,EAAE,EACzC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,KACrC,MAAM,EAAE,CAAC;IACd,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC9C,cAAc,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;IAClE,KAAK,EAAE,CACL,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,QAAQ,GAAG,SAAS,EAC9B,IAAI,EAAE,QAAQ,GAAG,SAAS,KACvB,IAAI,CAAC;IACV,cAAc,EAAE,MAAM,IAAI,CAAC;CAC5B;AAyBD,eAAO,MAAM,mBAAmB,cAAe,MAAM,KAAG,aAgHvD,CAAC"}

package/dist/definitions/memory/indexes/createUniqueConstraint.d.ts

@@ -0,0 +1,16 @@
+import type { Document, IndexDescription } from "mongodb";
+export interface UniqueConstraint {
+    /** Throws mongod's duplicate key error when another document holds one of its keys. */
+    assertCanWrite: (documentKey: string, document: Document) => void;
+    /** Moves the keys of `previous` to `next`; either is `undefined` on insert / delete. */
+    write: (documentKey: string, previous: Document | undefined, next: Document | undefined) => void;
+    clear: () => void;
+}
+interface CreateUniqueConstraintParams {
+    namespace: string;
+    indexName: string;
+    description: IndexDescription;
+}
+export declare const createUniqueConstraint: ({ namespace, indexName, description, }: CreateUniqueConstraintParams) => UniqueConstraint;
+export {};
+//# sourceMappingURL=createUniqueConstraint.d.ts.map

package/dist/definitions/memory/indexes/createUniqueConstraint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createUniqueConstraint.d.ts","sourceRoot":"","sources":["../../../../src/memory/indexes/createUniqueConstraint.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAoB,QAAQ,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAW5E,MAAM,WAAW,gBAAgB;IAC/B,uFAAuF;IACvF,cAAc,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;IAClE,wFAAwF;IACxF,KAAK,EAAE,CACL,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,QAAQ,GAAG,SAAS,EAC9B,IAAI,EAAE,QAAQ,GAAG,SAAS,KACvB,IAAI,CAAC;IACV,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAgDD,UAAU,4BAA4B;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,gBAAgB,CAAC;CAC/B;AAED,eAAO,MAAM,sBAAsB,2CAIhC,4BAA4B,KAAG,gBAsEjC,CAAC"}