@push.rocks/smartdb 2.17.0 → 2.18.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@push.rocks/smartdb",
-  "version": "2.17.0",
+  "version": "2.18.0",
   "private": false,
   "description": "A MongoDB-compatible embedded database server with wire protocol support, backed by a high-performance Rust engine.",
   "exports": {
@@ -15,10 +15,10 @@
     "@api.global/typedserver": "^8.4.6",
     "@design.estate/dees-element": "^2.2.4",
     "@git.zone/tsbuild": "^4.4.2",
-    "@git.zone/tsbundle": "^2.11.3",
+    "@git.zone/tsbundle": "^2.11.4",
     "@git.zone/tsrun": "^2.0.6",
     "@git.zone/tsrust": "^1.7.0",
-    "@git.zone/tstest": "^3.6.7",
+    "@git.zone/tstest": "^4.0.0",
     "@types/node": "26.1.2",
     "mongodb": "^7.5.0"
   },

package/readme.md

@@ -398,7 +398,9 @@ Coordinators that do not yet have their own durable record can call `getDatabase
 
 `exportDatabase()` drains live MongoDB wire commands for the selected database and holds an exclusive local and cross-process database lease while producing the snapshot. The export is therefore consistent across all collections. It enforces server ceilings while visiting documents instead of first materializing an unbounded database; callers can request lower `maxEncodedBytes`, `maxCollections`, `maxDocuments`, and `maxIndexes` limits. The result emits canonical MongoDB Extended JSON so every BSON type, including 64-bit integers, survives the JSON management channel exactly. `importDatabase()` accepts canonical or relaxed Extended JSON. Database migration clients should preserve the exported objects as JSON values and must not coerce Extended JSON numeric wrappers into JavaScript numbers.
 
-The lifecycle-critical health and fence-state inspections, export, import, publication-commit, tenant-ensure, and tenant-delete methods accept optional `ISmartDbManagementOperationOptions` with `signal?: AbortSignal` and `timeoutMs?: number`. `timeoutMs`, when provided, must be a positive safe integer. Cancellation and deadlines are fail-stop: SmartDB attempts to terminate the Rust engine before rejecting. Once termination is confirmed, the operation cannot continue after the caller releases ownership. If termination itself fails, the rejection is a `SmartDbManagementOperationTerminationError`; bridge ownership is retained and the service owner must retry `stop()` until it succeeds. After any cancellation or deadline, restart SmartDB before accepting more traffic.
+`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. `ISmartDbGetDatabaseContentDigestInput` accepts `databaseName` and optional `ISmartDbDatabaseContentDigestLimits` 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 `ISmartDbDatabaseContentDigest` result reports format `smartdb.database.content-digest.v1`, algorithm `sha256`, the lowercase digest, and exact scan counters.
+
+The lifecycle-critical health and fence-state inspections, digest, export, import, publication-commit, tenant-ensure, and tenant-delete methods accept optional `ISmartDbManagementOperationOptions` with `signal?: AbortSignal` and `timeoutMs?: number`. `timeoutMs`, when provided, must be a positive safe integer. Cancellation and deadlines are fail-stop: SmartDB attempts to terminate the Rust engine before rejecting. Once termination is confirmed, the operation cannot continue after the caller releases ownership. If termination itself fails, the rejection is a `SmartDbManagementOperationTerminationError`; bridge ownership is retained and the service owner must retry `stop()` until it succeeds. After any cancellation or deadline, restart SmartDB before accepting more traffic.
 
 ```typescript
 const controller = new AbortController();
@@ -440,6 +442,7 @@ await client.db('admin').command({ usersInfo: 'reader' });
 | `getHealth(options?)` | `Promise<ISmartDbHealth>` | Read readiness and explicit publication-hold capability fields with optional fail-stop cancellation/deadline ownership |
 | `ensureDatabaseTenant(params, options?)` | `Promise<ISmartDbEnsureDatabaseTenantResult>` | Idempotently ensure an exact fenced tenant; supports fail-stop cancellation and deadlines |
 | `getDatabaseResourceFenceState(params, options?)` | `Promise<ISmartDbDatabaseResourceFenceState \| null>` | Safely inspect a file-backed database fence high-water mark and publication phase without exposing receipts or capability material; supports fail-stop cancellation and deadlines |
+| `getDatabaseContentDigest(params, options?)` | `Promise<ISmartDbDatabaseContentDigest>` | Compute a bounded, database-name-independent digest over exact BSON documents and persisted index specifications; supports fail-stop cancellation and deadlines |
 | `exportDatabase(params, options?)` | `Promise<ISmartDbDatabaseExport>` | Export one database as lossless canonical MongoDB Extended JSON; supports fail-stop cancellation and deadlines |
 | `importDatabase(params, options?)` | `Promise<ISmartDbImportDatabaseResult>` | Durably replace one database from canonical or relaxed MongoDB Extended JSON, optionally leaving publication held; supports fail-stop cancellation and deadlines |
 | `deleteDatabaseTenant(params, options?)` | `Promise<ISmartDbDeleteDatabaseTenantResult>` | Durably delete an exact tenant database/user, optionally leaving publication held; supports fail-stop cancellation and deadlines |

package/ts/00_commitinfo_data.ts

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

package/ts/index.ts

@@ -53,6 +53,9 @@ export type {
   ISmartDbDatabaseExport,
   ISmartDbDatabaseExportLimits,
   ISmartDbExportDatabaseInput,
+  ISmartDbDatabaseContentDigestLimits,
+  ISmartDbGetDatabaseContentDigestInput,
+  ISmartDbDatabaseContentDigest,
   ISmartDbImportDatabaseInput,
   ISmartDbImportDatabaseResult,
   TSmartDbEffectivePayloadInputV1,

package/ts/ts_smartdb/index.ts

@@ -52,6 +52,9 @@ export type {
   ISmartDbDatabaseExport,
   ISmartDbDatabaseExportLimits,
   ISmartDbExportDatabaseInput,
+  ISmartDbDatabaseContentDigestLimits,
+  ISmartDbGetDatabaseContentDigestInput,
+  ISmartDbDatabaseContentDigest,
   ISmartDbImportDatabaseInput,
   ISmartDbImportDatabaseResult,
 } from './service-types.js';

package/ts/ts_smartdb/rust-db-bridge.ts

@@ -18,6 +18,8 @@ import type {
   ISmartDbDeleteDatabaseTenantResult,
   ISmartDbDatabaseExport,
   ISmartDbExportDatabaseInput,
+  ISmartDbDatabaseContentDigest,
+  ISmartDbGetDatabaseContentDigestInput,
   ISmartDbImportDatabaseInput,
   ISmartDbImportDatabaseResult,
   ISmartDbCommitDatabasePublicationInput,
@@ -193,6 +195,10 @@ type TSmartDbCommands = {
     params: ISmartDbExportDatabaseInput;
     result: ISmartDbDatabaseExport;
   };
+  getDatabaseContentDigest: {
+    params: ISmartDbGetDatabaseContentDigestInput;
+    result: ISmartDbDatabaseContentDigest;
+  };
   importDatabase: {
     params: ISmartDbImportDatabaseInput;
     result: ISmartDbImportDatabaseResult;
@@ -658,6 +664,22 @@ export class RustDbBridge extends EventEmitter {
     }
   }
 
+  public async getDatabaseContentDigest(
+    params: ISmartDbGetDatabaseContentDigestInput,
+    optionsArg?: ISmartDbManagementOperationOptions,
+  ): Promise<ISmartDbDatabaseContentDigest> {
+    try {
+      return await this.bridge.sendCommand(
+        'getDatabaseContentDigest',
+        params,
+        optionsArg,
+      ) as ISmartDbDatabaseContentDigest;
+    } catch (error) {
+      await this.awaitManagementOperationTermination(error);
+      throw error;
+    }
+  }
+
   public async importDatabase(
     params: ISmartDbImportDatabaseInput,
     optionsArg?: ISmartDbManagementOperationOptions,

package/ts/ts_smartdb/server/SmartdbServer.ts

@@ -23,6 +23,8 @@ import type {
   ISmartDbDeleteDatabaseTenantResult,
   ISmartDbDatabaseExport,
   ISmartDbExportDatabaseInput,
+  ISmartDbDatabaseContentDigest,
+  ISmartDbGetDatabaseContentDigestInput,
   ISmartDbImportDatabaseInput,
   ISmartDbImportDatabaseResult,
   ISmartDbCommitDatabasePublicationInput,
@@ -417,6 +419,16 @@ export class SmartdbServer {
     );
   }
 
+  /** Compute a bounded, database-name-independent digest of logical database content. */
+  async getDatabaseContentDigest(
+    params: ISmartDbGetDatabaseContentDigestInput,
+    optionsArg?: ISmartDbManagementOperationOptions,
+  ): Promise<ISmartDbDatabaseContentDigest> {
+    return this.runDatabaseManagementOperation(
+      () => this.bridge.getDatabaseContentDigest(params, optionsArg),
+    );
+  }
+
   /**
    * Replace one database with a previously exported snapshot.
    */

package/ts/ts_smartdb/service-types.ts

@@ -242,6 +242,29 @@ export interface ISmartDbExportDatabaseInput {
   limits?: ISmartDbDatabaseExportLimits;
 }
 
+export interface ISmartDbDatabaseContentDigestLimits {
+  maxScannedBsonBytes?: number;
+  maxCollections?: number;
+  maxDocuments?: number;
+  maxIndexes?: number;
+}
+
+export interface ISmartDbGetDatabaseContentDigestInput {
+  databaseName: string;
+  limits?: ISmartDbDatabaseContentDigestLimits;
+}
+
+export interface ISmartDbDatabaseContentDigest {
+  format: 'smartdb.database.content-digest.v1';
+  algorithm: 'sha256';
+  databaseName: string;
+  sha256: string;
+  scannedBsonBytes: number;
+  collections: number;
+  documents: number;
+  indexes: number;
+}
+
 export interface ISmartDbDatabaseExport {
   format: 'smartdb.database.export.v1';
   databaseName: string;