@lossless.org/client 1.20.2 → 1.21.0

package/dist_ts/nosqldb/classes.writeobserver.js

@@ -136,4 +136,4 @@ export const captureSmartdataWrite = (dbArg, writeArg) => {
         }
     };
 };
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy53cml0ZW9ic2VydmVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvbm9zcWxkYi9jbGFzc2VzLndyaXRlb2JzZXJ2ZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxFQUFFLGlCQUFpQixFQUFFLE1BQU0sOEJBQThCLENBQUM7QUFDakUsT0FBTyxFQUFFLHlCQUF5QixFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUFDckUsT0FBTyxFQUFFLE1BQU0sRUFBRSxNQUFNLGNBQWMsQ0FBQztBQXlEdEMsTUFBTSxxQkFBcUIsR0FBRyxFQUFFLENBQUM7QUFDakMsTUFBTSxhQUFhLEdBQUcsSUFBSSxPQUFPLEVBQW9DLENBQUM7QUFFdEUsTUFBTSx3QkFBd0IsR0FBRyxDQUFDLFVBQW1CLEVBQWtCLEVBQUU7SUFDdkUsTUFBTSxFQUFFLE1BQU0sRUFBRSxRQUFRLEVBQUUsR0FBRyxpQkFBaUIsQ0FBQyxVQUFVLEVBQUUsQ0FBQyxRQUFRLEVBQUUsVUFBVSxDQUFDLENBQUMsQ0FBQztJQUNuRixJQUFJLE9BQU8sUUFBUSxLQUFLLFVBQVUsRUFBRSxDQUFDO1FBQ25DLE1BQU0sSUFBSSx5QkFBeUIsQ0FBQyxrQkFBa0IsRUFDcEQsMERBQTBELENBQUMsQ0FBQztJQUNoRSxDQUFDO0lBQ0QsSUFDRSxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsTUFBTSxDQUFDO1dBQ25CLE1BQU0sQ0FBQyxNQUFNLEtBQUssQ0FBQztXQUNuQixNQUFNLENBQUMsTUFBTSxHQUFHLHFCQUFxQjtXQUNyQyxNQUFNLENBQUMsSUFBSSxDQUFDLENBQUMsUUFBUSxFQUFFLEVBQUUsQ0FDMUIsT0FBTyxRQUFRLEtBQUssUUFBUTtlQUN6QixRQUFRLENBQUMsTUFBTSxLQUFLLENBQUM7ZUFDckIsUUFBUSxDQUFDLFFBQVEsQ0FBQyxHQUFHLENBQUM7ZUFDdEIsUUFBUSxDQUFDLFVBQVUsQ0FBQyxHQUFHLENBQUMsQ0FBQztXQUMzQixJQUFJ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
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy53cml0ZW9ic2VydmVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvbm9zcWxkYi9jbGFzc2VzLndyaXRlb2JzZXJ2ZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxFQUFFLGlCQUFpQixFQUFFLE1BQU0sOEJBQThCLENBQUM7QUFDakUsT0FBTyxFQUFFLHlCQUF5QixFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUFDckUsT0FBTyxFQUFFLE1BQU0sRUFBRSxNQUFNLGNBQWMsQ0FBQztBQW9FdEMsTUFBTSxxQkFBcUIsR0FBRyxFQUFFLENBQUM7QUFDakMsTUFBTSxhQUFhLEdBQUcsSUFBSSxPQUFPLEVBQW9DLENBQUM7QUFFdEUsTUFBTSx3QkFBd0IsR0FBRyxDQUFDLFVBQW1CLEVBQWtCLEVBQUU7SUFDdkUsTUFBTSxFQUFFLE1BQU0sRUFBRSxRQUFRLEVBQUUsR0FBRyxpQkFBaUIsQ0FBQyxVQUFVLEVBQUUsQ0FBQyxRQUFRLEVBQUUsVUFBVSxDQUFDLENBQUMsQ0FBQztJQUNuRixJQUFJLE9BQU8sUUFBUSxLQUFLLFVBQVUsRUFBRSxDQUFDO1FBQ25DLE1BQU0sSUFBSSx5QkFBeUIsQ0FBQyxrQkFBa0IsRUFDcEQsMERBQTBELENBQUMsQ0FBQztJQUNoRSxDQUFDO0lBQ0QsSUFDRSxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsTUFBTSxDQUFDO1dBQ25CLE1BQU0sQ0FBQyxNQUFNLEtBQUssQ0FBQztXQUNuQixNQUFNLENBQUMsTUFBTSxHQUFHLHFCQUFxQjtXQUNyQyxNQUFNLENBQUMsSUFBSSxDQUFDLENBQUMsUUFBUSxFQUFFLEVBQUUsQ0FDMUIsT0FBTyxRQUFRLEtBQUssUUFBUTtlQUN6QixRQUFRLENBQUMsTUFBTSxLQUFLLENBQUM7ZUFDckIsUUFBUSxDQUFDLFFBQVEsQ0FBQyxHQUFHLENBQUM7ZUFDdEIsUUFBUSxDQUFDLFVBQVUsQ0FBQyxHQUFHLENBQUMsQ0FBQztXQUMzQixJQUFJLEdBQUcsQ0FBQyxNQUFNLENBQUMsQ0FBQyxJQUFJLEtBQUssTUFBTSxDQUFDLE1BQU0sRUFDekMsQ0FBQztRQUNELE1BQU0sSUFBSSx5QkFBeUIsQ0FBQyxrQkFBa0IsRUFDcEQsNENBQTRDLHFCQUFxQixrQ0FBa0MsQ0FBQyxDQUFDO0lBQ3pHLENBQUM7SUFDRCxPQUFPO1FBQ0wsTUFBTSxFQUFFLE1BQU0sQ0FBQyxNQUFNLENBQUMsQ0FBQyxHQUFHLE1BQU0sQ0FBYSxDQUFDO1FBQzlDLFFBQVEsRUFBRSxRQUFzQztLQUNqRCxDQUFDO0FBQ0osQ0FBQyxDQUFDO0FBRUYsOEVBQThFO0FBQzlFLE1BQU0sQ0FBQyxNQUFNLHlCQUF5QixHQUFHLENBQ3ZDLEtBQWtCLEVBQ2xCLFVBQTBDLEVBQzVCLEVBQUU7SUFDaEIsTUFBTSxRQUFRLEdBQUcsd0JBQXdCLENBQUMsVUFBVSxDQUFDLENBQUM7SUFDdEQsSUFBSSxTQUFTLEdBQUcsYUFBYSxDQUFDLEdBQUcsQ0FBQyxLQUFLLENBQUMsQ0FBQztJQUN6QyxJQUFJLENBQUMsU0FBUyxFQUFFLENBQUM7UUFDZixTQUFTLEdBQUcsSUFBSSxHQUFHLEVBQUUsQ0FBQztRQUN0QixhQUFhLENBQUMsR0FBRyxDQUFDLEtBQUssRUFBRSxTQUFTLENBQUMsQ0FBQztJQUN0QyxDQUFDO0lBQ0QsU0FBUyxDQUFDLEdBQUcsQ0FBQyxRQUFRLENBQUMsQ0FBQztJQUN4QixPQUFPLEdBQUcsRUFBRTtRQUNWLGFBQWEsQ0FBQyxHQUFHLENBQUMsS0FBSyxDQUFDLEVBQUUsTUFBTSxDQUFDLFFBQVEsQ0FBQyxDQUFDO0lBQzdDLENBQUMsQ0FBQztBQUNKLENBQUMsQ0FBQztBQUVGLGdCQUFnQjtBQUNoQixNQUFNLENBQUMsTUFBTSwwQkFBMEIsR0FBRyxDQUFDLEtBQWtCLEVBQVcsRUFBRSxDQUN4RSxDQUFDLGFBQWEsQ0FBQyxHQUFHLENBQUMsS0FBSyxDQUFDLEVBQUUsSUFBSSxJQUFJLENBQUMsQ0FBQyxHQUFHLENBQUMsQ0FBQztBQUU1QyxNQUFNLGVBQWUsR0FBRyxDQUFDLFFBQWlCLEVBQXVDLEVBQUUsQ0FDakYsUUFBUSxLQUFLLElBQUk7T0FDWixPQUFPLFFBQVEsS0FBSyxRQUFRO09BQzVCLE9BQU8sUUFBUSxLQUFLLFNBQVM7T0FDN0IsQ0FBQyxPQUFPLFFBQVEsS0FBSyxRQUFRLElBQUksTUFBTSxDQUFDLFFBQVEsQ0FBQyxRQUFRLENBQUMsQ0FBQztJQUM5RCxDQUFDLENBQUMsUUFBbUM7SUFDckMsQ0FBQyxDQUFDLFNBQVMsQ0FBQztBQUVoQixNQUFNLGFBQWEsR0FBRyxDQUFDLFFBQWlCLEVBQXVDLEVBQUU7SUFDL0UsSUFBSSxPQUFPLFFBQVEsS0FBSyxRQUFRLElBQUksUUFBUSxLQUFLLElBQUksSUFBSSxLQUFLLENBQUMsT0FBTyxDQUFDLFFBQVEsQ0FBQyxFQUFFLENBQUM7UUFDakYsT0FBTyxLQUFLLENBQUM7SUFDZixDQUFDO0lBQ0QsTUFBTSxTQUFTLEdBQUcsTUFBTSxDQUFDLGNBQWMsQ0FBQyxRQUFRLENBQUMsQ0FBQztJQUNsRCxPQUFPLFNBQVMsS0FBSyxNQUFNLENBQUMsU0FBUyxJQUFJLFNBQVMsS0FBSyxJQUFJLENBQUM7QUFDOUQsQ0FBQyxDQUFDO0FBRUYsTUFBTSxrQkFBa0IsR0FBRyxDQUN6QixXQUFtQixFQUNuQixTQUE0QixFQUNhLEVBQUU7SUFDM0MsTUFBTSxNQUFNLEdBQTRDLEVBQUUsQ0FBQztJQUMzRCxLQUFLLE1BQU0sS0FBSyxJQUFJLFNBQVMsRUFBRSxDQUFDO1FBQzlCLElBQUksQ0FBQyxNQUFNLENBQUMsTUFBTSxDQUFDLFdBQVcsRUFBRSxLQUFLLENBQUM7WUFBRSxTQUFTO1FBQ2pELE1BQU0sS0FBSyxHQUFHLGVBQWUsQ0FBRSxXQUF1QyxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUM7UUFDL0UsSUFBSSxLQUFLLEtBQUssU0FBUztZQUFFLE1BQU0sQ0FBQyxLQUFLLENBQUMsR0FBRyxLQUFLLENBQUM7SUFDakQsQ0FBQztJQUNELE9BQU8sTUFBTSxDQUFDO0FBQ2hCLENBQUMsQ0FBQztBQUVGOzs7R0FHRztBQUNILE1BQU0sc0JBQXNCLEdBQUcsQ0FDN0IsV0FBb0IsRUFDcEIsU0FBOEIsRUFDOUIsMEJBQThDLEVBQzlDLFVBQW1ELEVBQzdDLEVBQUU7SUFDUixJQUFJLENBQUMsYUFBYSxDQUFDLFdBQVcsQ0FBQztRQUFFLE9BQU87SUFDeEMsS0FBSyxNQUFNLEdBQUcsSUFBSSxNQUFNLENBQUMsSUFBSSxDQUFDLFdBQVcsQ0FBQyxFQUFFLENBQUM7UUFDM0MsTUFBTSxTQUFTLEdBQUcsV0FBVyxDQUFDLEdBQUcsQ0FBQyxDQUFDO1FBQ25DLElBQUksR0FBRyxLQUFLLE1BQU0sRUFBRSxDQUFDO1lBQ25CLElBQUksS0FBSyxDQUFDLE9BQU8sQ0FBQyxTQUFTLENBQUMsRUFBRSxDQUFDO2dCQUM3QixLQUFLLE1BQU0sUUFBUSxJQUFJLFNBQVMsRUFBRSxDQUFDO29CQUNqQyxzQkFBc0IsQ0FBQyxRQUFRLEVBQUUsU0FBUyxFQUFFLDBCQUEwQixFQUFFLFVBQVUsQ0FBQyxDQUFDO2dCQUN0RixDQUFDO1lBQ0gsQ0FBQztZQUNELFNBQVM7UUFDWCxDQUFDO1FBQ0QsSUFBSSxLQUFLLEdBQUcsZUFBZSxDQUFDLFNBQVMsQ0FBQyxDQUFDO1FBQ3ZDLElBQ0UsS0FBSyxLQUFLLFNBQVM7ZUFDaEIsYUFBYSxDQUFDLFNBQVMsQ0FBQztlQUN4QixNQUFNLENBQUMsSUFBSSxDQUFDLFNBQVMsQ0FBQyxDQUFDLE1BQU0sS0FBSyxDQUFDO2VBQ25DLE1BQU0sQ0FBQyxNQUFNLENBQUMsU0FBUyxFQUFFLEtBQUssQ0FBQyxFQUNsQyxDQUFDO1lBQ0QsS0FBSyxHQUFHLGVBQWUsQ0FBQyxTQUFTLENBQUMsR0FBRyxDQUFDLENBQUM7UUFDekMsQ0FBQztRQUNELElBQUksS0FBSyxLQUFLLFNBQVMsSUFBSSxLQUFLLEtBQUssSUFBSTtZQUFFLFNBQVM7UUFDcEQsTUFBTSxNQUFNLEdBQUcsR0FBRyxLQUFLLEtBQUssSUFBSSwwQkFBMEI7WUFDeEQsQ0FBQyxDQUFDLENBQUMsR0FBRyxFQUFFLDBCQUEwQixDQUFDO1lBQ25DLENBQUMsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxDQUFDO1FBQ1YsS0FBSyxNQUFNLEtBQUssSUFBSSxNQUFNLEVBQUUsQ0FBQztZQUMzQixJQUFJLFNBQVMsQ0FBQyxHQUFHLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxNQUFNLENBQUMsTUFBTSxDQUFDLFVBQVUsRUFBRSxLQUFLLENBQUMsRUFBRSxDQUFDO2dCQUM5RCxVQUFVLENBQUMsS0FBSyxDQUFDLEdBQUcsS0FBSyxDQUFDO1lBQzVCLENBQUM7UUFDSCxDQUFDO0lBQ0gsQ0FBQztBQUNILENBQUMsQ0FBQztBQUVGLE1BQU0sYUFBYSxHQUFHLENBQUMsUUFBaUIsRUFBVSxFQUFFLENBQ2xELFFBQVEsWUFBWSxLQUFLLENBQUMsQ0FBQyxDQUFDLFFBQVEsQ0FBQyxPQUFPLENBQUMsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxRQUFRLENBQUMsQ0FBQztBQUVsRTs7Ozs7O0dBTUc7QUFDSCxNQUFNLENBQUMsTUFBTSxxQkFBcUIsR0FBRyxDQUNuQyxLQUFrQixFQUNsQixRQUF5QixFQUNDLEVBQUU7SUFDNUIsTUFBTSxVQUFVLEdBQUcsYUFBYSxDQUFDLEdBQUcsQ0FBQyxLQUFLLENBQUMsQ0FBQztJQUM1QyxJQUFJLENBQUMsVUFBVSxJQUFJLFVBQVUsQ0FBQyxJQUFJLEtBQUssQ0FBQztRQUFFLE9BQU8sU0FBUyxDQUFDO0lBQzNELE1BQU0sU0FBUyxHQUFHLENBQUMsR0FBRyxVQUFVLENBQUMsQ0FBQztJQUNsQyxNQUFNLE1BQU0sR0FBRyxDQUFDLEdBQUcsSUFBSSxHQUFHLENBQUMsU0FBUyxDQUFDLE9BQU8sQ0FBQyxDQUFDLFdBQVcsRUFBRSxFQUFFLENBQUMsV0FBVyxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUMsQ0FBQztJQUNwRixNQUFNLFNBQVMsR0FBRyxRQUFRLENBQUMsU0FBUyxFQUFFLEdBQUcsQ0FBQyxDQUFDLFdBQVcsRUFBRSxFQUFFLENBQ3hELGtCQUFrQixDQUFDLFdBQVcsRUFBRSxNQUFNLENBQUMsQ0FBQyxJQUFJLElBQUksQ0FBQztJQUNuRCxNQUFNLE9BQU8sR0FBNEMsRUFBRSxDQUFDO0lBQzVELHNCQUFzQixDQUFDLFFBQVEsQ0FBQyxRQUFRLEVBQUUsSUFBSSxHQUFHLENBQUMsTUFBTSxDQUFDLEVBQUUsUUFBUSxDQUFDLHVCQUF1QixFQUFFLE9BQU8sQ0FBQyxDQUFDO0lBQ3RHLE9BQU8sR0FBRyxFQUFFO1FBQ1YsS0FBSyxNQUFNLFFBQVEsSUFBSSxTQUFTLEVBQUUsQ0FBQztZQUNqQyxJQUFJLENBQUMsYUFBYSxDQUFDLEdBQUcsQ0FBQyxLQUFLLENBQUMsRUFBRSxHQUFHLENBQUMsUUFBUSxDQUFDO2dCQUFFLFNBQVM7WUFDdkQsTUFBTSxNQUFNLEdBQTBCLE1BQU0sQ0FBQyxNQUFNLENBQUM7Z0JBQ2xELFVBQVUsRUFBRSxRQUFRLENBQUMsVUFBVTtnQkFDL0IsSUFBSSxFQUFFLFFBQVEsQ0FBQyxJQUFJO2dCQUNuQixTQUFTLEVBQUUsU0FBUyxLQUFLLElBQUk7b0JBQzNCLENBQUMsQ0FBQyxJQUFJO29CQUNOLENBQUMsQ0FBQyxNQUFNLENBQUMsTUFBTSxDQUFDLFNBQVMsQ0FBQyxHQUFHLENBQUMsQ0FBQyxXQUFXLEVBQUUsRUFBRSxDQUM1QyxNQUFNLENBQUMsTUFBTSxDQUFDLGtCQUFrQixDQUFDLFdBQVcsRUFBRSxRQUFRLENBQUMsTUFBTSxDQUFDLENBQUMsQ0FBQyxDQUFDO2dCQUNyRSxPQUFPLEVBQUUsTUFBTSxDQUFDLE1BQU0sQ0FBQyxrQkFBa0IsQ0FBQyxPQUFPLEVBQUUsUUFBUSxDQUFDLE1BQU0sQ0FBQyxDQUFDO2FBQ3JFLENBQUMsQ0FBQztZQUNILElBQUksQ0FBQztnQkFDSCxRQUFRLENBQUMsUUFBUSxDQUFDLE1BQU0sQ0FBQyxDQUFDO1lBQzVCLENBQUM7WUFBQyxPQUFPLFFBQVEsRUFBRSxDQUFDO2dCQUNsQixNQUFNLENBQUMsR0FBRyxDQUFDLE9BQU8sRUFDaEIsbURBQW1ELFFBQVEsQ0FBQyxVQUFVLE1BQU0sYUFBYSxDQUFDLFFBQVEsQ0FBQyxFQUFFLENBQUMsQ0FBQztZQUMzRyxDQUFDO1FBQ0gsQ0FBQztJQUNILENBQUMsQ0FBQztBQUNKLENBQUMsQ0FBQyJ9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lossless.org/client",
-  "version": "1.20.2",
+  "version": "1.21.0",
   "private": false,
   "description": "One typed client for NoSQLDB, MongoDB, SQLDB, MariaDB, ClickHouse and S3 object storage.",
   "exports": {

package/readme.md

@@ -117,6 +117,7 @@ Family imports preserve the established SmartData and SmartBucket names and cons
 | Per-instance model binding | `bindDocToManager(manager, Model)` returns a subclass of a model declared with `@managed()` and no manager argument, named like the model and bound to that manager, so several databases use the same models at once; any other binding is refused with `invalid_configuration` |
 | Subclasses need their own binding | a subclass of a bound model that declares decorators or a persistence policy of its own and no `@Collection()`, `@managed()` or `defineCollectionModel()` binding is refused with `invalid_configuration` on every read and write, so it never writes through the parent's schema; an undecorated subclass keeps the inherited binding |
 | Observing this process's writes | `db.observeWrites({ fields, listener })` — one frozen report per acknowledged model write, `{ collection, kind, documents, anchors }` with the requested top-level fields of the written documents and of the selector's equality anchors; writes inside a `db.createSession()` transaction are reported after the commit, never after a rollback; works on NoSQLDB, where `watch()` is unsupported |
+| Following this process's reads | `db.trackReads(fn)` resolves `{ result, reads }`; `reads.changed` turns true once a write this process makes through the database's models could have changed what a model read of `fn` returned, judged by the read's query and the ids it returned, and a write it cannot place counts as one that did, so a cache keyed by `reads` rebuilds only what a write touched; works on NoSQLDB |
 | Disposable test databases on a unix socket | `SmartdataTestDatabase.create({ connection: { socketPath } })` from `@lossless.org/client/testsupport` reaches an engine that listens only on a unix-domain socket, fault helpers included; the loopback `host`/`port` form is unchanged |
 
 `docs/source/smartdata/readme.md` documents each one with its refusals.

package/ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@lossless.org/client',
-  version: '1.20.2',
+  version: '1.21.0',
   description: 'One typed client for NoSQLDB, MongoDB, SQLDB, MariaDB, ClickHouse and S3 object storage.'
 }

package/ts/nosqldb/classes.atomicdelete.ts

@@ -40,7 +40,14 @@ export const executeAtomicDelete = async <T>(
         },
       );
       if (result.deletedCount > 0) {
-        reportSmartdataCollectionWrite(collectionArg, optsArg?.session, 'delete', null, filterArg);
+        reportSmartdataCollectionWrite(
+          collectionArg,
+          optsArg?.session,
+          'delete',
+          null,
+          filterArg,
+          { images: 'none' },
+        );
       }
       return result;
     },
@@ -84,7 +91,14 @@ export const executeAtomicDeleteMany = async <T>(
         },
       );
       if (result.deletedCount > 0) {
-        reportSmartdataCollectionWrite(collectionArg, optsArg?.session, 'delete', null, filterArg);
+        reportSmartdataCollectionWrite(
+          collectionArg,
+          optsArg?.session,
+          'delete',
+          null,
+          filterArg,
+          { images: 'none' },
+        );
       }
       return result;
     },

package/ts/nosqldb/classes.atomicfindoneandupdate.ts

@@ -146,6 +146,10 @@ export const executeAtomicFindOneAndUpdate = async <T>(
               classified.status === 'upserted' ? 'insert' : 'update',
               classified.document ? [classified.document] : null,
               filterArg,
+              {
+                images: classified.document ? optionsArg.returnDocument : 'none',
+                update: updateArg,
+              },
             );
           }
           return classified;
@@ -233,6 +237,7 @@ export const executeAtomicFindOneAndReplace = async <T>(
               ? [classified.document]
               : [classified.document, replacementArg],
             filterArg,
+            { images: optionsArg.returnDocument === 'after' ? 'after' : 'beforeAndAfter' },
           );
         }
         return classified;

package/ts/nosqldb/classes.atomicupdate.ts

@@ -57,6 +57,7 @@ export const executeAtomicUpdate = async <T>(
             result.upsertedCount > 0 ? 'insert' : 'update',
             optsArg?.observedDocument ? [optsArg.observedDocument] : null,
             filterArg,
+            { images: 'none', update: updateArg },
           );
         }
         return result;
@@ -122,6 +123,7 @@ export const executeAtomicUpsertMany = async <T>(
             Object.hasOwn(upsertedIdsArg ?? {}, indexArg) ? 'insert' : 'update',
             null,
             operationArg.filter,
+            { images: 'none', update: operationArg.update },
           );
         });
       };
@@ -206,7 +208,14 @@ export const executeAtomicUpdateMany = async <T>(
           },
         );
         if (result.matchedCount > 0) {
-          reportSmartdataCollectionWrite(collectionArg, optsArg?.session, 'update', null, filterArg);
+          reportSmartdataCollectionWrite(
+            collectionArg,
+            optsArg?.session,
+            'update',
+            null,
+            filterArg,
+            { images: 'none', update: updateArg },
+          );
         }
         return result;
       } catch (errorArg) {

package/ts/nosqldb/classes.bootstraprecord.ts

@@ -6,7 +6,8 @@ import { snapshotBoundedBsonDocument } from './classes.bsonsnapshot.js';
 import { validateOrdinaryStoredDocument } from './classes.ordinarypersistence.js';
 import { SmartdataPersistenceError, isMongoDuplicateKeyError } from './classes.persistence.js';
 import { readBoundedInspectionCursor } from './classes.namespaceinspection.js';
-import { reportSmartdataWrite } from './classes.session.js';
+import { reportSmartdataWrite, reportSmartdataWriteFailure } from './classes.session.js';
+import { runSmartdataWrite } from './classes.readtracker.js';
 import {
   collectionModelSchemaResolverSymbol, collectionTopologyDbInspectionSymbol,
   getExpectedCollectionTopologyForSchema, inspectCollectionTopologySnapshot,
@@ -63,7 +64,7 @@ export const insertBootstrapRecord = async (
     let outcome: TBootstrapOutcome;
     try {
       // Explicit preparation uses this same connection-generation guard.
-      outcome = await dbArg[collectionTopologyDbInspectionSymbol](async (mongoDbArg, assertCurrentArg) => {
+      outcome = await runSmartdataWrite(dbArg, () => dbArg[collectionTopologyDbInspectionSymbol](async (mongoDbArg, assertCurrentArg) => {
         budget.check();
         const namespaces = await readBoundedInspectionCursor(mongoDbArg.listCollections(
           { name: schema.collectionName },
@@ -91,18 +92,20 @@ export const insertBootstrapRecord = async (
         } catch (errorArg) {
           return isMongoDuplicateKeyError(errorArg) ? 'unique_conflict' : 'ambiguous_write';
         }
-      });
+      }));
     } catch {
+      if (dispatched) reportSmartdataWriteFailure(dbArg, undefined, schema.collectionName);
       throw new SmartdataPersistenceError(dispatched ? 'ambiguous_write' : 'unsupported_operation',
         dispatched ? 'Bootstrap insertion outcome is uncertain; inspect its explicit ID before proceeding.'
           : 'Bootstrap insertion could not inspect the current database connection.');
     }
     if (outcome === 'inserted') {
       reportSmartdataWrite(dbArg, undefined, {
-        collection: schema.collectionName, kind: 'insert', documents: [document],
+        collection: schema.collectionName, kind: 'insert', documents: [document], images: 'after',
       });
       return Object.freeze({ acknowledged: true, insertedId: document._id as string });
     }
+    if (outcome === 'ambiguous_write') reportSmartdataWriteFailure(dbArg, undefined, schema.collectionName);
     const messages = {
       unique_conflict: 'Bootstrap record conflicts with a unique index.',
       invalid_configuration: 'Bootstrap insertion requires absent or exact primary-only collection topology.',

package/ts/nosqldb/classes.collection.ts

@@ -35,6 +35,7 @@ import {
   leaseOrdinarySmartdataSession,
   reportSmartdataCollectionWrite,
   runWithOrdinarySmartdataSession,
+  trackSmartdataRead,
   type TSmartdataOrdinarySession,
 } from './classes.session.js';
 import {
@@ -2422,12 +2423,20 @@ export class SmartdataCollection<T> {
       { ordinaryWrite: false, timeoutMS: opts?.timeoutMS },
       async (rawSessionArg, deadlineArg) => {
         await deadlineArg.join(this.init());
-        return this.mongoDbCollection.findOne(filterObject, {
+        const tracked = trackSmartdataRead(this, opts?.session, {
+          kind: 'documents',
+          filter: filterObject,
+          limited: true,
+        });
+        const document = await this.mongoDbCollection.findOne(filterObject, {
           projection: opts?.projection,
           maxTimeMS: opts?.maxTimeMS,
           session: rawSessionArg,
           ...deadlineArg.commandOptions(),
         });
+        if (document) tracked?.record(document);
+        tracked?.settle();
+        return document;
       },
     );
   }
@@ -2448,10 +2457,14 @@ export class SmartdataCollection<T> {
     });
     try {
       await this.init();
+      const tracked = trackSmartdataRead(this, opts?.session, {
+        kind: 'documents',
+        filter: filterObjectArg,
+      });
       const cursor = this.mongoDbCollection.find(filterObjectArg, {
         session: lease.rawSession,
       });
-      return new SmartdataDbCursor(cursor, dbDocArg, lease.release);
+      return new SmartdataDbCursor(cursor, dbDocArg, lease.release, tracked);
     } catch (cursorCreationError) {
       lease.release();
       throw cursorCreationError;
@@ -2470,6 +2483,10 @@ export class SmartdataCollection<T> {
       { ordinaryWrite: false, timeoutMS: opts?.timeoutMS },
       async (rawSessionArg, deadlineArg) => {
         await deadlineArg.join(this.init());
+        const tracked = trackSmartdataRead(this, opts?.session, {
+          kind: 'documents',
+          filter: filterObject,
+        });
         const cursor = this.mongoDbCollection.find(filterObject, {
           session: rawSessionArg,
           ...deadlineArg.cursorOptions(),
@@ -2482,6 +2499,10 @@ export class SmartdataCollection<T> {
           (cursorArg) => cursorArg.toArray(),
           deadlineArg.signal,
         );
+        if (tracked) {
+          for (const document of result) tracked.record(document);
+          tracked.settle();
+        }
 
         // In-memory check for duplicate _id values (should never happen)
         if (result.length > 0) {
@@ -2625,7 +2646,9 @@ export class SmartdataCollection<T> {
             ...deadlineArg.commandOptions(),
           });
           if (result.acknowledged) {
-            reportSmartdataCollectionWrite(this, opts?.session, 'insert', [saveableObject]);
+            reportSmartdataCollectionWrite(
+              this, opts?.session, 'insert', [saveableObject], undefined, { images: 'after' },
+            );
           }
           return result;
         } catch (err: any) {
@@ -2668,6 +2691,12 @@ export class SmartdataCollection<T> {
       { ordinaryWrite: false, timeoutMS: opts?.timeoutMS, signal: opts?.signal },
       async (rawSessionArg, deadlineArg) => {
         await deadlineArg.join(this.init());
+        // Totals depend on every matching document, not on which ones come back.
+        trackSmartdataRead(this, opts?.session, {
+          kind: 'documents',
+          filter: matchArg ?? {},
+          matches: true,
+        });
         const pipeline: plugins.mongodb.Document[] = [];
         if (matchArg && Object.keys(matchArg).length > 0) {
           pipeline.push({ $match: matchArg });
@@ -2741,7 +2770,9 @@ export class SmartdataCollection<T> {
             .map((indexArg) => saveableObjects[Number(indexArg)])
             .filter((documentArg) => documentArg !== undefined);
           if (inserted.length > 0) {
-            reportSmartdataCollectionWrite(this, opts?.session, 'insert', inserted);
+            reportSmartdataCollectionWrite(
+              this, opts?.session, 'insert', inserted, undefined, { images: 'after' },
+            );
           }
         };
         try {
@@ -2806,7 +2837,9 @@ export class SmartdataCollection<T> {
           .map((indexArg) => prepared[Number(indexArg)])
           .filter((documentArg) => documentArg !== undefined);
         if (inserted.length > 0) {
-          reportSmartdataCollectionWrite(this, optsArg.session, 'insert', inserted);
+          reportSmartdataCollectionWrite(
+            this, optsArg.session, 'insert', inserted, undefined, { images: 'after' },
+          );
         }
       };
       try {
@@ -2881,15 +2914,16 @@ export class SmartdataCollection<T> {
           }
           updateableObject[key] = saveableObject[key];
         }
+        const update = {
+          $set: updateableObject,
+          ...(Object.keys(insertOnlyObject).length > 0
+            ? { $setOnInsert: insertOnlyObject }
+            : {}),
+        };
         try {
           const result = await this.mongoDbCollection.updateOne(
             identifiableObject,
-            {
-              $set: updateableObject,
-              ...(Object.keys(insertOnlyObject).length > 0
-                ? { $setOnInsert: insertOnlyObject }
-                : {}),
-            },
+            update,
             { upsert: true, session: rawSessionArg, ...deadlineArg.commandOptions() },
           );
           if (result.upsertedCount > 0 || result.matchedCount > 0) {
@@ -2899,6 +2933,7 @@ export class SmartdataCollection<T> {
               result.upsertedCount > 0 ? 'insert' : 'update',
               [saveableObject],
               identifiableObject,
+              { images: 'none', update },
             );
           }
           return result;
@@ -2939,6 +2974,7 @@ export class SmartdataCollection<T> {
             'delete',
             observedDocument ? [observedDocument] : null,
             identifiableObject,
+            { images: 'none' },
           );
         }
         return result;
@@ -2990,6 +3026,11 @@ export class SmartdataCollection<T> {
       { ordinaryWrite: false, timeoutMS: opts?.timeoutMS, signal: opts?.signal },
       async (rawSessionArg, deadlineArg) => {
         await deadlineArg.join(this.init());
+        const tracked = trackSmartdataRead(this, opts?.session, {
+          kind: 'count',
+          filter: filterObject,
+          hint: opts?.hint,
+        });
         const pipeline: plugins.mongodb.Document[] = [{ $match: filterObject }];
         if (opts?.limit !== undefined) {
           pipeline.push({ $limit: opts.limit });
@@ -3001,9 +3042,11 @@ export class SmartdataCollection<T> {
           ...deadlineArg.commandOptions(),
           session: rawSessionArg,
         });
-        return runCursorOperation(cursor, async (cursorArg) =>
+        const count = await runCursorOperation(cursor, async (cursorArg) =>
           (await cursorArg.next())?.count ?? 0,
         deadlineArg.signal);
+        tracked?.settle();
+        return count;
       },
     );
   }
@@ -3065,6 +3108,7 @@ export class SmartdataCollection<T> {
     duplicateFields: Array<{ field: string; duplicateValues: number }>;
   }> {
     await this.init();
+    trackSmartdataRead(this, undefined, { kind: 'collection' });
     const result = {
       ok: true,
       estimatedCount: 0,

package/ts/nosqldb/classes.cursor.ts

@@ -1,4 +1,5 @@
 import { SmartDataDbDoc } from './classes.doc.js';
+import type { ISmartdataReadRecorder } from './classes.readtracker.js';
 import * as plugins from './plugins.js';
 
 /**
@@ -16,14 +17,23 @@ export class SmartdataDbCursor<T = any> {
    * raw driver session or no session at all.
    */
   private releaseSession: () => void;
+  /** Records the read for open read sets; it settles once the cursor is exhausted. */
+  private readRecorder?: ISmartdataReadRecorder;
   constructor(
     cursorArg: plugins.mongodb.FindCursor<T>,
     dbDocArg: typeof SmartDataDbDoc,
     releaseSessionArg: () => void = () => {},
+    readRecorderArg?: ISmartdataReadRecorder,
   ) {
-    this.mongodbCursor = cursorArg;
+    this.mongodbCursor = readRecorderArg
+      ? cursorArg.map((documentArg) => {
+        readRecorderArg.record(documentArg);
+        return documentArg;
+      })
+      : cursorArg;
     this.smartdataDbDoc = dbDocArg;
     this.releaseSession = releaseSessionArg;
+    this.readRecorder = readRecorderArg;
   }
 
   public async next(closeAtEnd = true): Promise<T | null> {
@@ -34,6 +44,7 @@ export class SmartdataDbCursor<T = any> {
       return await this.closeAfterError(readError);
     }
     if (nextDocument === null) {
+      this.readRecorder?.settle();
       if (closeAtEnd) {
         await this.close();
       }
@@ -59,6 +70,7 @@ export class SmartdataDbCursor<T = any> {
           await forEachFuncArg(nextClassInstance as any);
         }
       } while (nextDocument);
+      this.readRecorder?.settle();
     } catch (iterationError) {
       if (closeCursorAtEnd) {
         await this.closeAfterError(iterationError);
@@ -74,6 +86,7 @@ export class SmartdataDbCursor<T = any> {
     let convertedResult: T[];
     try {
       const result = await this.mongodbCursor.toArray();
+      this.readRecorder?.settle();
       convertedResult = result.map((itemArg) =>
         this.smartdataDbDoc.createInstanceFromMongoDbNativeDoc(itemArg),
       ) as T[];

package/ts/nosqldb/classes.db.ts

@@ -24,8 +24,15 @@ import {
   addSmartdataWriteObserver,
   type ISmartdataWriteObserverOptions,
 } from './classes.writeobserver.js';
+import {
+  changeSmartdataReadSetsOfDb,
+  trackSmartdataReads,
+  type ISmartdataTrackedReads,
+} from './classes.readtracker.js';
 
 export { SmartdataSession } from './classes.session.js';
+export { SmartdataReadSet } from './classes.readtracker.js';
+export type { ISmartdataTrackedReads } from './classes.readtracker.js';
 export type {
   ISmartdataTransactionOptions,
   TSmartdataOrdinarySession,
@@ -358,6 +365,7 @@ export class SmartdataDb {
     this.beginLifecycleOperation('close');
     this.transitionLifecycle('closing');
     this.status = 'disconnected';
+    changeSmartdataReadSetsOfDb(this);
     const mongoDbClient = this.pendingClient ?? this.mongoDbClient;
     try {
       const closeErrors: unknown[] = [];
@@ -544,6 +552,30 @@ export class SmartdataDb {
     return addSmartdataWriteObserver(this, optionsArg);
   }
 
+  /**
+   * Runs `fnArg` and records every model read it makes on this database:
+   * `findOne`, `findAll`, `getCursor`, counts, pages and the exact reads.
+   * Each read is kept as its query and the ids it returned. The returned
+   * `reads.changed` turns true once a write this process makes through the
+   * database's models could have changed any of those results; a write it
+   * cannot place, such as an update by a selector it cannot evaluate, counts
+   * as one that did. A cache keyed by `reads` rebuilds only what such a write
+   * touched.
+   *
+   * Writes of other processes, raw driver access and migrations are not
+   * followed. A read inside a transaction, a read of another database and a
+   * write made inside `fnArg` mark the set changed at once. Queries are
+   * evaluated by MongoDB's simple binary comparison, so a read of a view or of
+   * a collection with a default collation marks the set changed as well; each
+   * read collection is checked once per connection when `fnArg` returns.
+   * Close a set that is no longer needed.
+   */
+  public async trackReads<TResult>(
+    fnArg: () => TResult | Promise<TResult>,
+  ): Promise<ISmartdataTrackedReads<TResult>> {
+    return trackSmartdataReads(this, fnArg);
+  }
+
   /**
    * Creates a narrowly scoped MongoDB administration facade bound to this
    * SmartData lifecycle. Applications never need direct driver access.

package/ts/nosqldb/classes.doc.ts

@@ -43,6 +43,7 @@ import {
   isOrdinarySessionInTransaction,
   leaseOrdinarySmartdataSession,
   runWithOrdinarySmartdataSession,
+  trackSmartdataRead,
   type TSmartdataOrdinarySession,
 } from './classes.session.js';
 import {
@@ -6055,24 +6056,39 @@ export class SmartDataDbDoc<T extends TImplements, TImplements, TManager extends
       timeoutMS,
     }, async (rawSessionArg, deadlineArg) => {
       await deadlineArg.join(collection.init());
+      const sort = { [optionsArg.sortField]: sortDirection, [uniqueField]: sortDirection } as const;
+      const tracked = trackSmartdataRead(collection, optionsArg.session, {
+        kind: 'documents',
+        filter: selector,
+        sort,
+        limited: true,
+      });
       const rawCursor = collection.mongoDbCollection
         .find(selector, { session: rawSessionArg, ...deadlineArg.cursorOptions() })
-        .sort({ [optionsArg.sortField]: sortDirection, [uniqueField]: sortDirection })
+        .sort(sort)
         .limit(limit + 1);
       return runCursorOperation(rawCursor, async (cursorArg) => {
         const rawDocuments = await cursorArg.toArray();
+        if (tracked) {
+          for (const rawDocument of rawDocuments) tracked.record(rawDocument);
+          tracked.settle();
+        }
         const hasMore = rawDocuments.length > limit;
         const pageRows = rawDocuments.slice(0, limit);
         const documents = pageRows.map(
           (rawDocument: any) => (this as any).createInstanceFromMongoDbNativeDoc(rawDocument) as T,
         );
         const lastRow: any = pageRows[pageRows.length - 1];
+        const countTracked = optionsArg.withTotal
+          ? trackSmartdataRead(collection, optionsArg.session, { kind: 'count', filter: baseSelector })
+          : undefined;
         const total = optionsArg.withTotal
           ? await collection.mongoDbCollection.countDocuments(baseSelector, {
               session: rawSessionArg,
               ...deadlineArg.commandOptions(),
             })
           : undefined;
+        countTracked?.settle();
         return {
           documents,
           ...(hasMore && lastRow
@@ -6211,8 +6227,14 @@ export class SmartDataDbDoc<T extends TImplements, TImplements, TManager extends
     });
     try {
       await collection.init();
+      const filter = (this as any).normalizeReadFilter(filterArg);
+      // A modifier changes the query in ways a read set cannot follow, and a
+      // skipped page depends on the documents before it.
+      const tracked = trackSmartdataRead(collection, session, modifier
+        ? { kind: 'collection' }
+        : { kind: 'documents', filter, sort, hint, matches: skip !== undefined && skip > 0, limited: Boolean(limit) });
       let rawCursor: plugins.mongodb.FindCursor<any> =
-        collection.mongoDbCollection.find((this as any).normalizeReadFilter(filterArg), {
+        collection.mongoDbCollection.find(filter, {
           projection,
           session: lease.rawSession,
           hint,
@@ -6261,6 +6283,7 @@ export class SmartDataDbDoc<T extends TImplements, TImplements, TManager extends
         rawCursor,
         this as any as typeof SmartDataDbDoc,
         lease.release,
+        tracked,
       );
     } catch (cursorCreationError) {
       lease.release();
@@ -6309,12 +6332,19 @@ export class SmartDataDbDoc<T extends TImplements, TImplements, TManager extends
       defaultTimeoutMS: 5_000,
       signal: opts.signal,
     }, async (rawSessionArg, deadlineArg) => {
+      const tracked = trackSmartdataRead(collection, opts.session, {
+        kind: 'documents', filter, sort, hint, matches: skip > 0, limited: true,
+      });
       const rawCursor = collection.mongoDbCollection.find(filter, {
         projection, sort, hint, skip, limit, maxTimeMS,
         ...deadlineArg.cursorOptions(), session: rawSessionArg,
       });
       return runCursorOperation(rawCursor, async (cursorArg) => {
         const documents = await cursorArg.toArray();
+        if (tracked) {
+          for (const document of documents) tracked.record(document);
+          tracked.settle();
+        }
         return documents.map((documentArg) =>
           (this as any).createInstanceFromMongoDbNativeDoc(documentArg) as T,
         );