@lossless.org/nosqldb 10.1.1 → 10.2.0

package/dist_rust/rustdb_linux_amd64.tsrust-build.json

@@ -1,12 +1,12 @@
 {
   "format": "tsrust.build-provenance.v2",
-  "binarySha256": "ef5967c55ec1c790a14f98bf9d1eabf788023cf34aac123b671a7dfbdd13f485",
+  "binarySha256": "fd82ec4f34a3e8c6d929c2dddf5062038a0f7d6e32b6d4f67a2c9b3173090304",
   "buildInfo": {
     "projectName": "@lossless.org/nosqldb",
-    "projectVersion": "10.1.1",
-    "gitCommit": "594c38140cc22eb5e5cf1205875dcba9c331358e",
+    "projectVersion": "10.2.0",
+    "gitCommit": "2d839fb50b71879c161b9ef0232376bf7eecabab",
     "gitDirty": false,
-    "builtAt": "2026-09-11T14:38:18.748Z",
+    "builtAt": "2026-09-12T12:59:11.537Z",
     "tsrustVersion": "1.13.0",
     "binary": "rustdb",
     "target": "linux_amd64"

package/dist_rust/rustdb_linux_amd64_musl.tsrust-build.json

@@ -1,12 +1,12 @@
 {
   "format": "tsrust.build-provenance.v2",
-  "binarySha256": "97cacd08b63456f933c644b34da1fa15b20d0da5d6d7fd617a63a2405befb078",
+  "binarySha256": "59dcf447f442727d84ffe268b0149be153c832b8eafd646190713192a5b3d4da",
   "buildInfo": {
     "projectName": "@lossless.org/nosqldb",
-    "projectVersion": "10.1.1",
-    "gitCommit": "594c38140cc22eb5e5cf1205875dcba9c331358e",
+    "projectVersion": "10.2.0",
+    "gitCommit": "2d839fb50b71879c161b9ef0232376bf7eecabab",
     "gitDirty": false,
-    "builtAt": "2026-09-11T14:38:19.489Z",
+    "builtAt": "2026-09-12T12:59:12.326Z",
     "tsrustVersion": "1.13.0",
     "binary": "rustdb",
     "target": "linux_amd64_musl"

package/dist_rust/rustdb_linux_arm64.tsrust-build.json

@@ -1,12 +1,12 @@
 {
   "format": "tsrust.build-provenance.v2",
-  "binarySha256": "7ff8dc0adf917bd35cd67de448f66d1a1327eed53d1bbaf4dded30fd79d3cd99",
+  "binarySha256": "572e699f56465f1be565bd54d797ba90d05d21e5732b10fc1763cdb5d3a323b2",
   "buildInfo": {
     "projectName": "@lossless.org/nosqldb",
-    "projectVersion": "10.1.1",
-    "gitCommit": "594c38140cc22eb5e5cf1205875dcba9c331358e",
+    "projectVersion": "10.2.0",
+    "gitCommit": "2d839fb50b71879c161b9ef0232376bf7eecabab",
     "gitDirty": false,
-    "builtAt": "2026-09-11T14:38:19.119Z",
+    "builtAt": "2026-09-12T12:59:11.939Z",
     "tsrustVersion": "1.13.0",
     "binary": "rustdb",
     "target": "linux_arm64"

package/dist_rust/rustdb_linux_arm64_musl.tsrust-build.json

@@ -1,12 +1,12 @@
 {
   "format": "tsrust.build-provenance.v2",
-  "binarySha256": "5049fd8ab809455b3b967222776df485ce75657eb4684f5704867978ddd9025e",
+  "binarySha256": "fd36c74946021dac647bf4f6564447c8d40fb80340113bd6c695a93a156edc4c",
   "buildInfo": {
     "projectName": "@lossless.org/nosqldb",
-    "projectVersion": "10.1.1",
-    "gitCommit": "594c38140cc22eb5e5cf1205875dcba9c331358e",
+    "projectVersion": "10.2.0",
+    "gitCommit": "2d839fb50b71879c161b9ef0232376bf7eecabab",
     "gitDirty": false,
-    "builtAt": "2026-09-11T14:38:19.867Z",
+    "builtAt": "2026-09-12T12:59:12.734Z",
     "tsrustVersion": "1.13.0",
     "binary": "rustdb",
     "target": "linux_arm64_musl"

package/dist_rust/rustdb_macos_amd64.tsrust-build.json

@@ -1,12 +1,12 @@
 {
   "format": "tsrust.build-provenance.v2",
-  "binarySha256": "01856b90f9df1d96d1735d04e0f2f422115f5d928b7394a5689c6e8b87336843",
+  "binarySha256": "c586e06728502fbf83ca837a13901275ad4f04949f82ce35e88aa3ecd9195f72",
   "buildInfo": {
     "projectName": "@lossless.org/nosqldb",
-    "projectVersion": "10.1.1",
-    "gitCommit": "594c38140cc22eb5e5cf1205875dcba9c331358e",
+    "projectVersion": "10.2.0",
+    "gitCommit": "2d839fb50b71879c161b9ef0232376bf7eecabab",
     "gitDirty": false,
-    "builtAt": "2026-09-11T14:24:45.449Z",
+    "builtAt": "2026-09-12T12:46:15.715Z",
     "tsrustVersion": "1.13.0",
     "binary": "rustdb",
     "target": "macos_amd64"

package/dist_rust/rustdb_macos_arm64.tsrust-build.json

@@ -1,12 +1,12 @@
 {
   "format": "tsrust.build-provenance.v2",
-  "binarySha256": "04cbf83f4809008f0fc747e6052555a246fadae7d7949d7ed231a45c45bf7623",
+  "binarySha256": "4b83a98e1b7b7b513e39f3b243c0f3d341c3c3af02636b3e5cd198d1db99375d",
   "buildInfo": {
     "projectName": "@lossless.org/nosqldb",
-    "projectVersion": "10.1.1",
-    "gitCommit": "594c38140cc22eb5e5cf1205875dcba9c331358e",
+    "projectVersion": "10.2.0",
+    "gitCommit": "2d839fb50b71879c161b9ef0232376bf7eecabab",
     "gitDirty": false,
-    "builtAt": "2026-09-11T14:24:45.961Z",
+    "builtAt": "2026-09-12T12:46:16.254Z",
     "tsrustVersion": "1.13.0",
     "binary": "rustdb",
     "target": "macos_arm64"

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@lossless.org/nosqldb',
-    version: '10.1.1',
+    version: '10.2.0',
     description: 'A MongoDB-compatible embedded database server with wire protocol support, backed by a high-performance Rust engine.'
 };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSx1QkFBdUI7SUFDN0IsT0FBTyxFQUFFLFFBQVE7SUFDakIsV0FBVyxFQUFFLHFIQUFxSDtDQUNuSSxDQUFBIn0=

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lossless.org/nosqldb",
-  "version": "10.1.1",
+  "version": "10.2.0",
   "private": false,
   "description": "A MongoDB-compatible embedded database server with wire protocol support, backed by a high-performance Rust engine.",
   "exports": {

package/readme.md

@@ -254,12 +254,7 @@ Each entry contains:
 
 The engine detects document rewrites that change nothing and skips them entirely — no storage write, no WAL append, no index update, and no oplog entry. A skipped rewrite still counts as matched (`matchedCount: 1`) but reports `modifiedCount: 0`.
 
-Two classes are skipped:
-
-- **Identical** — the post-image equals the stored document byte for byte.
-- **Volatile-only** — the post-image differs only in top-level volatile metadata fields (currently `_updatedAt`, the field ODM layers such as `@push.rocks/smartdata` restamp on every save). The stored document is kept as-is, including its existing `_updatedAt`, so the timestamp means "last real change" rather than "last save call".
-
-This makes periodic reconcile loops that re-save unchanged documents cost nothing at the engine level. A caller that needs a document to actually change must change a non-volatile field.
+Only identical field values are skipped; top-level field order does not cause a write. Explicit changes to `_updatedAt` are persisted and returned just like changes to any other field. Applications decide when to advance their timestamps.
 
 Counters are exposed through `serverStatus`:
 
@@ -270,7 +265,7 @@ console.log(status.writes);
 //   updatesWritten: 42,        // rewrites that reached storage, index, and oplog
 //   noopSkipped: {
 //     identical: 1337,         // post-image equal to the stored document
-//     volatileOnly: 271,       // only volatile metadata differed
+//     volatileOnly: 0,         // retained metric; timestamp changes now write
 //   },
 // }
 ```
@@ -279,6 +274,22 @@ console.log(status.writes);
 
 ## API Reference
 
+### Find execution plans and pooled cursors
+
+`collection.find(filter).hint(index).sort(order).limit(count).explain('executionStats')`
+uses the serving query planner and reports actual document and index-entry reads.
+`queryPlanner` inspects the plan without executing it; `allPlansExecution` also
+executes the selected plan, with an empty trial-execution list because selection
+is deterministic. Explain currently supports `find` outside transactions.
+Queries can use a compound index's sort prefix after equality-constrained fields,
+and scalar `$in` predicates on single-field indexes use bounded, deduplicated point
+lookups. Unsupported point shapes retain ordinary predicate evaluation.
+
+Driver cursors belong to their logical session and authenticated principal
+generations, so `getMore` can use another connection in the pool. Session
+retirement, expiry, and shutdown release their cursors. Reads made without a
+logical session retain connection ownership and disconnect cleanup.
+
 ### NoSqlDbServer
 
 The core server class. Manages the Rust database engine and exposes connection details.
@@ -1420,10 +1431,11 @@ result document. Unindexed joins can still require repeated foreign scans.
 Facet branches replay a shared input buffer or temporary spool; their combined
 result must fit the BSON document budget.
 
-Scalar ordered indexes can satisfy complete sort keys after equality fields,
+Scalar ordered indexes can satisfy a sort prefix after equality fields,
 including reverse traversal and mixed compound directions. This path currently
-requires distinct full index keys to preserve stable equal-key ordering. Arrays,
-unsupported BSON index types, and equal-key data use the general sort executor.
+requires distinct full index keys. Equal requested sort keys follow the remaining
+index columns; include a unique field in the sort when tie order matters. Arrays,
+unsupported BSON index types, and duplicate full index keys use the general sort executor.
 Numeric comparison and scalar equality indexes share exact Int32, Int64, Double,
 and Decimal128 ordering, including large integers, signed zero, and NaNs.
 
@@ -1695,7 +1707,7 @@ replication.
 ### Unsupported Administrative Commands
 
 NoSQLDB returns `CommandNotFound` (code 59) for the wire commands `validate`,
-`explain`, legacy `authenticate`, `buildInfo`/`buildinfo`, `hostInfo`,
+legacy `authenticate`, `buildInfo`/`buildinfo`, `hostInfo`,
 `whatsmyuri`, `getLog`, `getCmdLineOpts`, `getParameter`, `setFreeMonitoring`,
 `currentOp`, `killOp`, `top`, `profile`, `compact`, `reIndex`, `fsync`, and
 `connPoolSync`. These commands previously had placeholder success responses but

package/ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@lossless.org/nosqldb',
-  version: '10.1.1',
+  version: '10.2.0',
   description: 'A MongoDB-compatible embedded database server with wire protocol support, backed by a high-performance Rust engine.'
 }