@lossless.org/nosqldb 10.1.1 → 10.2.1

package/dist_rust/rustdb_linux_amd64.tsrust-build.json

@@ -1,12 +1,12 @@
 {
   "format": "tsrust.build-provenance.v2",
-  "binarySha256": "ef5967c55ec1c790a14f98bf9d1eabf788023cf34aac123b671a7dfbdd13f485",
+  "binarySha256": "e3b27e759285b7ec2349ee0d9c19b9b224f223a5615dd55e9e98d3aea944bdc1",
   "buildInfo": {
     "projectName": "@lossless.org/nosqldb",
-    "projectVersion": "10.1.1",
-    "gitCommit": "594c38140cc22eb5e5cf1205875dcba9c331358e",
+    "projectVersion": "10.2.1",
+    "gitCommit": "ef25d0815dd8165c182614d6642abe18c5615d04",
     "gitDirty": false,
-    "builtAt": "2026-09-11T14:38:18.748Z",
+    "builtAt": "2026-09-19T16:13:35.123Z",
     "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": "160da7da2c0d9459b4991d10a4b7b01fef31427a467628eebd0139fc77a37165",
   "buildInfo": {
     "projectName": "@lossless.org/nosqldb",
-    "projectVersion": "10.1.1",
-    "gitCommit": "594c38140cc22eb5e5cf1205875dcba9c331358e",
+    "projectVersion": "10.2.1",
+    "gitCommit": "ef25d0815dd8165c182614d6642abe18c5615d04",
     "gitDirty": false,
-    "builtAt": "2026-09-11T14:38:19.489Z",
+    "builtAt": "2026-09-19T16:13:35.856Z",
     "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": "6c289b3ffad0d852170c01760f110edc516f4b180a04f43527b54ddaac175c1d",
   "buildInfo": {
     "projectName": "@lossless.org/nosqldb",
-    "projectVersion": "10.1.1",
-    "gitCommit": "594c38140cc22eb5e5cf1205875dcba9c331358e",
+    "projectVersion": "10.2.1",
+    "gitCommit": "ef25d0815dd8165c182614d6642abe18c5615d04",
     "gitDirty": false,
-    "builtAt": "2026-09-11T14:38:19.119Z",
+    "builtAt": "2026-09-19T16:13:35.490Z",
     "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": "b1eb1af3fd922012e6106adc320b7c99d0fabbda3bd67b2ca273e620bbef5127",
   "buildInfo": {
     "projectName": "@lossless.org/nosqldb",
-    "projectVersion": "10.1.1",
-    "gitCommit": "594c38140cc22eb5e5cf1205875dcba9c331358e",
+    "projectVersion": "10.2.1",
+    "gitCommit": "ef25d0815dd8165c182614d6642abe18c5615d04",
     "gitDirty": false,
-    "builtAt": "2026-09-11T14:38:19.867Z",
+    "builtAt": "2026-09-19T16:13:36.234Z",
     "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": "b330624335261bbc8bcd0ab6ae762016d13cd93ccb1e88e97c67c61fb59395f7",
   "buildInfo": {
     "projectName": "@lossless.org/nosqldb",
-    "projectVersion": "10.1.1",
-    "gitCommit": "594c38140cc22eb5e5cf1205875dcba9c331358e",
+    "projectVersion": "10.2.1",
+    "gitCommit": "ef25d0815dd8165c182614d6642abe18c5615d04",
     "gitDirty": false,
-    "builtAt": "2026-09-11T14:24:45.449Z",
+    "builtAt": "2026-09-19T15:59:40.927Z",
     "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": "2b002fb776308218af8e447553ba8560e38239098adc96741ca8fc9e05bcd659",
   "buildInfo": {
     "projectName": "@lossless.org/nosqldb",
-    "projectVersion": "10.1.1",
-    "gitCommit": "594c38140cc22eb5e5cf1205875dcba9c331358e",
+    "projectVersion": "10.2.1",
+    "gitCommit": "ef25d0815dd8165c182614d6642abe18c5615d04",
     "gitDirty": false,
-    "builtAt": "2026-09-11T14:24:45.961Z",
+    "builtAt": "2026-09-19T15:59:41.466Z",
     "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.1',
     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.1",
   "private": false,
   "description": "A MongoDB-compatible embedded database server with wire protocol support, backed by a high-performance Rust engine.",
   "exports": {
@@ -14,12 +14,12 @@
   "devDependencies": {
     "@api.global/typedserver": "^8.4.6",
     "@design.estate/dees-element": "^2.2.4",
-    "@git.zone/tsbuild": "^4.4.2",
+    "@git.zone/tsbuild": "^4.5.0",
     "@git.zone/tsbundle": "^2.13.0",
     "@git.zone/tsrust": "^1.13.0",
-    "@git.zone/tstest": "^6.0.0",
+    "@git.zone/tstest": "^6.1.1",
     "@lossless.org/client": "0.1.1",
-    "@types/node": "26.4.1",
+    "@types/node": "26.5.1",
     "mongodb": "^7.5.0"
   },
   "dependencies": {

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.
@@ -690,7 +701,9 @@ Cancellation or restart retires unpublished staging through the owning native
 logic. Index aliases, empty namespaces and validated `system.views` definitions
 are preserved; view IDs are rebound when the database name changes. Keep exported
 objects as JSON values rather than coercing BSON numeric wrappers into JavaScript
-numbers. These APIs transfer database contents; they do not convert storage files.
+numbers. Imported indexes retain their validated source catalog specification,
+including BSON field order and an absent `v` field in legacy exports.
+These APIs transfer database contents; they do not convert storage files.
 
 `getDatabaseContentDigest()` computes a bounded, database-name-independent SHA-256 over collection names, exact BSON document bytes, and persisted index specifications. Collection, document, and index enumeration order is normalized; BSON field order and compound-index key order remain significant. The physical `system.views` catalog is included, with only its already-validated deterministic database prefix removed from `_id` for hashing so a cross-name import retains the same digest. `INoSqlDbGetDatabaseContentDigestInput` accepts `databaseName` and optional `INoSqlDbDatabaseContentDigestLimits` fields `maxScannedBsonBytes`, `maxCollections`, `maxDocuments`, and `maxIndexes`. Callers may lower the server ceilings of 96 MiB scanned BSON, 10,000 collections, 1,000,000 documents, and 100,000 indexes. The `INoSqlDbDatabaseContentDigest` result reports format `smartdb.database.content-digest.v1`, algorithm `sha256`, the lowercase digest, and exact scan counters.
 
@@ -1420,10 +1433,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 +1709,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.1',
   description: 'A MongoDB-compatible embedded database server with wire protocol support, backed by a high-performance Rust engine.'
 }