@push.rocks/smartdb 5.5.2 → 5.6.0

package/dist_rust/rustdb_linux_amd64.tsrust-build.json

@@ -1,12 +1,12 @@
 {
   "format": "tsrust.build-provenance.v2",
-  "binarySha256": "00320ccbef2538dfa9fba1da65bb5db3b1874aef58eb85cdf40f8f29f4822578",
+  "binarySha256": "55347a7396635075da1027b20e2bbccff00424f012d2001c087c73ea7e6c414d",
   "buildInfo": {
     "projectName": "@push.rocks/smartdb",
-    "projectVersion": "5.5.2",
-    "gitCommit": "389db71389a45d42b0f205736ae52f55d593aeb3",
+    "projectVersion": "5.6.0",
+    "gitCommit": "f0db2bc4f73ea31fd63f912dc61036c914946fce",
     "gitDirty": false,
-    "builtAt": "2026-09-04T18:59:43.562Z",
+    "builtAt": "2026-09-05T12:44:09.182Z",
     "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": "14467960f6674176bc91a7237a471459a415b8e699c3202541e7850e389627f9",
   "buildInfo": {
     "projectName": "@push.rocks/smartdb",
-    "projectVersion": "5.5.2",
-    "gitCommit": "389db71389a45d42b0f205736ae52f55d593aeb3",
+    "projectVersion": "5.6.0",
+    "gitCommit": "f0db2bc4f73ea31fd63f912dc61036c914946fce",
     "gitDirty": false,
-    "builtAt": "2026-09-04T19:00:17.487Z",
+    "builtAt": "2026-09-05T12:44:47.197Z",
     "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": "255233b261d637b0ef65245ba123672b4fb89393127e92647bde47a9da4d07d7",
   "buildInfo": {
     "projectName": "@push.rocks/smartdb",
-    "projectVersion": "5.5.2",
-    "gitCommit": "389db71389a45d42b0f205736ae52f55d593aeb3",
+    "projectVersion": "5.6.0",
+    "gitCommit": "f0db2bc4f73ea31fd63f912dc61036c914946fce",
     "gitDirty": false,
-    "builtAt": "2026-09-04T19:01:23.168Z",
+    "builtAt": "2026-09-05T12:45:49.186Z",
     "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": "c90862d452ac29941a98e94649cdf255cf93fdc895a2c0be61aa1c82bf146bbe",
   "buildInfo": {
     "projectName": "@push.rocks/smartdb",
-    "projectVersion": "5.5.2",
-    "gitCommit": "389db71389a45d42b0f205736ae52f55d593aeb3",
+    "projectVersion": "5.6.0",
+    "gitCommit": "f0db2bc4f73ea31fd63f912dc61036c914946fce",
     "gitDirty": false,
-    "builtAt": "2026-09-04T19:02:04.202Z",
+    "builtAt": "2026-09-05T12:46:28.431Z",
     "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.0',
     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.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

@@ -869,6 +869,49 @@ 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.
+
+Finite count probes consisting of optional `$match`, optional `$skip`, positive
+integer `$limit`, and `$count` (or the driver's equivalent constant-one `$group`)
+stream candidates and stop when the limit is reached. 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 bounded namespace inspection of collections larger
+than 10,000 documents or 32 MiB. Generic pipelines retain their existing
+materialization limits. Transactions still require the existing bounded base
+snapshot; finite counts do not bypass its 10,000-document / 32 MiB admission cap.
+
 ### Database & Admin
 
 ```typescript

package/readme.plan.md

@@ -0,0 +1,9 @@
+# Query hints and finite counts
+
+Find and aggregate select the requested active scalar index by name or exact numeric key pattern. Candidate pages have count and byte bounds; full predicates, explicit sorting, projection, skip, limit, deadlines, and cursor limits remain authoritative. Unknown, malformed, ambiguous, natural-order, and multikey hints reject explicitly. Sparse hints retain sparse membership semantics.
+
+Transaction source reads use the owned snapshot plus buffered writes. Foreign-reading and writing aggregate stages reject inside transactions, including nested facets. Their nontransaction behavior is preserved.
+
+Finite count pipelines support optional match, optional skip, positive integer limit, and count or the driver's constant-one count group. The query engine owns streaming accumulation and shares the normal aggregation work ceiling for stage dispatch, syntax, specifications, predicates, and BSON payload processing. Physical traversal preserves hints and deadlines. Generic materialization limits and the existing transaction snapshot admission cap of 10,000 documents / 32 MiB remain.
+
+Regression coverage includes competing sparse/dense indexes, SCIM compound keys, candidate page count/byte boundaries, malformed hints, buffered transactions, foreign-stage rejection, 12,000-document finite probes, sources exceeding 32 MiB, retained resource caps, and shared aggregation work-budget enforcement.

package/ts/00_commitinfo_data.ts

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