@push.rocks/smartdb 5.5.2 → 5.6.1

package/dist_rust/rustdb_linux_amd64.tsrust-build.json

@@ -1,12 +1,12 @@
 {
   "format": "tsrust.build-provenance.v2",
-  "binarySha256": "00320ccbef2538dfa9fba1da65bb5db3b1874aef58eb85cdf40f8f29f4822578",
+  "binarySha256": "5655214ec6aaa52a37a786e4401199ac0ed9049fdfe9e0aa772f9321068ca213",
   "buildInfo": {
     "projectName": "@push.rocks/smartdb",
-    "projectVersion": "5.5.2",
-    "gitCommit": "389db71389a45d42b0f205736ae52f55d593aeb3",
+    "projectVersion": "5.6.1",
+    "gitCommit": "ea0aa192b25f5cb4c03d0c3c428c7659de40d314",
     "gitDirty": false,
-    "builtAt": "2026-09-04T18:59:43.562Z",
+    "builtAt": "2026-09-05T18:26:42.556Z",
     "tsrustVersion": "1.10.4",
     "binary": "rustdb",
     "target": "linux_amd64"

package/dist_rust/rustdb_linux_arm64.tsrust-build.json

@@ -1,12 +1,12 @@
 {
   "format": "tsrust.build-provenance.v2",
-  "binarySha256": "0efe48ad0d320b53e565e5ac16810bb8ca153b1d1c39cb86e971297e62931442",
+  "binarySha256": "74b7d64b133a2e8192eed352c53e67727833593417995610682b7f5eb90326f5",
   "buildInfo": {
     "projectName": "@push.rocks/smartdb",
-    "projectVersion": "5.5.2",
-    "gitCommit": "389db71389a45d42b0f205736ae52f55d593aeb3",
+    "projectVersion": "5.6.1",
+    "gitCommit": "ea0aa192b25f5cb4c03d0c3c428c7659de40d314",
     "gitDirty": false,
-    "builtAt": "2026-09-04T19:00:17.487Z",
+    "builtAt": "2026-09-05T18:27:24.134Z",
     "tsrustVersion": "1.10.4",
     "binary": "rustdb",
     "target": "linux_arm64"

package/dist_rust/rustdb_macos_amd64.tsrust-build.json

@@ -1,12 +1,12 @@
 {
   "format": "tsrust.build-provenance.v2",
-  "binarySha256": "f309ef5182f62bd147bab7bfd39be556d1ec0fce1dede84b9c424f607fe0a8b5",
+  "binarySha256": "9ad5d9cd4e00896c71c8de557a8fd3ca548857a79be2d59af84121618ae0e5b6",
   "buildInfo": {
     "projectName": "@push.rocks/smartdb",
-    "projectVersion": "5.5.2",
-    "gitCommit": "389db71389a45d42b0f205736ae52f55d593aeb3",
+    "projectVersion": "5.6.1",
+    "gitCommit": "ea0aa192b25f5cb4c03d0c3c428c7659de40d314",
     "gitDirty": false,
-    "builtAt": "2026-09-04T19:01:23.168Z",
+    "builtAt": "2026-09-05T18:28:28.488Z",
     "tsrustVersion": "1.10.4",
     "binary": "rustdb",
     "target": "macos_amd64"

package/dist_rust/rustdb_macos_arm64.tsrust-build.json

@@ -1,12 +1,12 @@
 {
   "format": "tsrust.build-provenance.v2",
-  "binarySha256": "6935370ae83f20f3dfd5e8167b68c9a60c656c17f8839a9b16c05e4009c27797",
+  "binarySha256": "144e6fcce955a5ae6e31ef95782a3f2c2931b7af4303102b27b082997b00f9b0",
   "buildInfo": {
     "projectName": "@push.rocks/smartdb",
-    "projectVersion": "5.5.2",
-    "gitCommit": "389db71389a45d42b0f205736ae52f55d593aeb3",
+    "projectVersion": "5.6.1",
+    "gitCommit": "ea0aa192b25f5cb4c03d0c3c428c7659de40d314",
     "gitDirty": false,
-    "builtAt": "2026-09-04T19:02:04.202Z",
+    "builtAt": "2026-09-05T18:29:16.114Z",
     "tsrustVersion": "1.10.4",
     "binary": "rustdb",
     "target": "macos_arm64"

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@push.rocks/smartdb',
-    version: '5.5.2',
+    version: '5.6.1',
     description: 'A MongoDB-compatible embedded database server with wire protocol support, backed by a high-performance Rust engine.'
 };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSxxQkFBcUI7SUFDM0IsT0FBTyxFQUFFLE9BQU87SUFDaEIsV0FBVyxFQUFFLHFIQUFxSDtDQUNuSSxDQUFBIn0=

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@push.rocks/smartdb",
-  "version": "5.5.2",
+  "version": "5.6.1",
   "private": false,
   "description": "A MongoDB-compatible embedded database server with wire protocol support, backed by a high-performance Rust engine.",
   "exports": {

package/readme.md

@@ -869,6 +869,52 @@ validated no-op and index version `v: 2`. Unsupported options, including
 index in the request is created. TTL metadata is retained in the catalog;
 automatic TTL expiry is not implemented.
 
+`find()` and collection `aggregate()` accept `hint` as an index name (including
+`_id_`) or an exact ascending/descending key pattern. Key-pattern order matters;
+if several indexes share a key pattern, use a name. The selected active scalar
+index supplies every candidate, using safe full-key equality bounds or a full
+scan of that index. The complete predicate still runs, and explicit sorting,
+projection, skip, and limit retain their normal semantics. Index traversal uses
+bounded pages under the namespace lock, so concurrent writes wait until the
+hinted source read finishes. Unsorted results have no guaranteed BSON value order.
+
+```typescript
+await collection.createIndex({ organizationId: 1, userId: 1 }, { name: 'organization_user' });
+const page = await collection.find({ organizationId: 'org-1' }, {
+  hint: 'organization_user', sort: { userId: 1, _id: 1 }, skip: 20, limit: 10,
+}).toArray();
+const count = await collection.countDocuments({ organizationId: 'org-1' }, {
+  hint: 'organization_user',
+});
+```
+
+Unknown or quarantined indexes, malformed/ambiguous patterns, `$natural`, and
+hints on missing collections or views fail explicitly. Forced multikey traversal
+is unsupported and rejects; unhinted array queries keep their existing scan
+behavior. Sparse hints intentionally exclude documents absent from that index,
+including for empty filters and counts. A hint is never silently replaced by a
+collection scan or another index.
+
+Hinted transaction reads construct the selected index from the existing bounded
+transaction snapshot plus buffered writes; they never fetch candidate documents
+from live storage. Read-only aggregate source pipelines also use that transaction
+view. Foreign-collection stages (`$lookup`, `$unionWith`) and writing stages
+(`$out`, `$merge`), including stages inside `$facet`, reject within transactions.
+Their existing nontransaction behavior is unchanged.
+
+Count pipelines consisting of optional `$match`, optional `$skip`, optional positive
+integer `$limit`, and `$count` (or the driver's equivalent constant-one `$group`)
+stream candidates. With a limit they stop at that limit; without one they count
+to the end of the selected source. They preserve hints,
+deadlines, and empty-result shapes without materializing the matched set. Stage
+dispatch, syntax, specifications, predicates, and streamed BSON processing consume
+the same aggregation work budget as ordinary pipelines. This permits both bounded
+and exact namespace inspection of collections larger than 10,000 documents or
+32 MiB. Work-budget exhaustion, deadlines and signed BSON count overflow reject
+explicitly; exact counts never fall back to estimates. Generic pipelines retain their existing
+materialization limits. Transactions still require the existing bounded base
+snapshot; streaming counts do not bypass its 10,000-document / 32 MiB admission cap.
+
 ### Database & Admin
 
 ```typescript

package/ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@push.rocks/smartdb',
-  version: '5.5.2',
+  version: '5.6.1',
   description: 'A MongoDB-compatible embedded database server with wire protocol support, backed by a high-performance Rust engine.'
 }