@lossless.org/nosqldb 10.10.0 → 10.11.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lossless.org/nosqldb",
-  "version": "10.10.0",
+  "version": "10.11.0",
   "private": false,
   "description": "A MongoDB-compatible embedded database server with wire protocol support, backed by a high-performance Rust engine.",
   "exports": {
@@ -15,12 +15,12 @@
     "@api.global/typedserver": "^8.4.6",
     "@design.estate/dees-element": "^2.2.4",
     "@git.zone/tsbuild": "^6.0.2",
-    "@git.zone/tsbundle": "^3.2.1",
-    "@git.zone/tsrust": "^4.1.0",
-    "@git.zone/tstest": "^7.2.0",
+    "@git.zone/tsbundle": "^3.7.1",
+    "@git.zone/tsrust": "^5.0.0",
+    "@git.zone/tstest": "^8.0.0",
     "@lossless.org/client": "0.1.1",
     "@lossless.org/nosqldb-baseline-1081": "npm:@lossless.org/nosqldb@10.8.1",
-    "@types/node": "26.6.4",
+    "@types/node": "26.6.5",
     "mongodb": "npm:@tempfix/mongodb@7.6.1"
   },
   "dependencies": {
@@ -31,16 +31,7 @@
     "last 1 chrome versions"
   ],
   "files": [
-    "ts/**/*",
-    "ts_migration/**/*",
-    "ts_web/**/*",
-    "dist/**/*",
     "dist_*/**/*",
-    "dist_ts/**/*",
-    "dist_ts_web/**/*",
-    "assets/**/*",
-    "cli.js",
-    ".smartconfig.json",
     "readme.md",
     "third-party-notices.md",
     "license.md",

package/readme.md

@@ -663,6 +663,69 @@ unique index key wins, and the later writer is told at its own statement.
   their statements and the second commit reports `WriteConflict` (112), as on
   MongoDB 7.
 
+#### Read fences
+
+`readFence` is a NoSQLDB command, not a MongoDB one, available from 10.11.0. It
+lets a transaction depend on documents it read without writing them: its commit
+fails if any of them changed after the transaction's snapshot. Two transactions
+that only read and fence one document therefore both commit, where fencing by
+writing the document would make one of them conflict.
+
+```typescript
+await session.withTransaction(async () => {
+  const lane = await lanes.findOne({ _id: 'dns' }, { session });
+  await db.command({ readFence: 'lanes', ids: ['dns'] }, { session });
+  await jobs.insertOne({ _id: 'next', basedOn: lane?.revision }, { session });
+});
+```
+
+- `{ readFence: <collection>, ids: [...] }` answers `{ ok: 1 }`, only as a
+  statement of a multi-document transaction; outside one it is refused with
+  `InvalidOptions` (72). `ids` holds 1 to 1,000 `_id` values, otherwise the
+  statement fails with `BadValue` (2). Duplicates count once, compared as
+  `_id` values are, so `1`, `NumberLong(1)` and `1.0` are one id. It needs the
+  read privilege of the database, as `find` does, and refuses a view with
+  `CommandNotSupportedOnView` (166). A refused statement ends its transaction,
+  as every failed transaction statement does.
+- `commitTransaction` is refused with `WriteConflict` (112), labelled
+  `TransientTransactionError` and never `UnknownTransactionCommitResult`, when
+  a fenced `_id` has a committed change newer than the transaction's snapshot:
+  an insert, replace, update, delete or TTL expiry, by any writer, inside or
+  outside a transaction. Fencing an absent `_id` holds its absence. A drop,
+  rename or re-create of the collection, a drop of its database, and the
+  creation of a fenced collection or database that was absent also refuse the
+  commit. The check is atomic with the commit, and nothing of a refused
+  transaction becomes visible; `withTransaction` retries it on a fresh
+  snapshot.
+- A fence can also name documents by the value of a unique key, which holds
+  a value whether a document holds it or not:
+  `{ readFence: <collection>, key: <field>, values: [...] }`. On an existing
+  collection the field needs a unique, non-partial, single-field index with
+  the simple collation, otherwise the statement fails with `IndexNotFound`
+  (27). A null value, empty `values`, more than 1,000 values, or `ids` and
+  `key` together fail with `BadValue` (2); equal values count once.
+  `commitTransaction` is refused when, after the snapshot, a committed write
+  changed the document that held a fenced value, or made any document hold
+  one: an insert of an absent value, an update or replace of the holder, its
+  delete, a move of its key to another value, a delete and re-insert, another
+  document taking the value, or TTL expiry. Dropping the index also refuses
+  the commit. `key: "_id"` is the fence by `ids`.
+- The statement itself never fails because of a concurrent change: only the
+  commit decides.
+- A fence takes no write claim. Fences never conflict with each other, never
+  wait for a writer and never make one wait or fail. A writer that commits
+  after the fencer has committed succeeds: the order is fencer, then writer.
+  Changes to other documents of the collection, new indexes and new
+  collections do not refuse the fencer.
+- Fencing and writing the same document makes the transaction a plain writer
+  of it. A transaction that only reads and fences still gets the commit check.
+  Transactions without fences behave exactly as before.
+- The statement takes the database gate every transaction statement takes, so
+  `drop`, `renameCollection` and `dropDatabase` in that database wait for the
+  transaction to end, as they wait for any transaction with a statement there.
+  It retains no collection gate: creating the fenced collection or its indexes
+  does not wait for the transaction.
+
 Write intents live in memory only; no transaction survives a restart, so
 there is nothing to recover.
 
@@ -2193,7 +2256,7 @@ a 64-bit integer above that, as MongoDB does.
 | **Aggregation** | `aggregate`, `count`, `distinct` |
 | **Indexes** | `createIndexes`, `dropIndexes`, `listIndexes` |
 | **Sessions** | `startSession`, `endSessions`, `killSessions` |
-| **Transactions** | `startTransaction`, `commitTransaction`, `abortTransaction` through driver sessions |
+| **Transactions** | `startTransaction`, `commitTransaction`, `abortTransaction` through driver sessions; `readFence` (NoSQLDB-specific, see Read fences) |
 | **Admin** | `ping`, `buildInfo`/`buildinfo`, `listDatabases`, `listCollections`, `drop`, `dropDatabase`, `create`, `collMod` (validation options), `serverStatus`, `dbStats`, `collStats`, `connectionStatus`, `renameCollection` |
 
 Advertises MongoDB wire protocol versions 0–21 and reports MongoDB 7.0.0

package/third_party_licenses/inventory.json

@@ -246,7 +246,7 @@
     "zmij@1.0.21"
   ],
   "files": {
-    ".smartconfig.json": "a6b17fae7da13c9b5f6eef7049cfd13b497ab7e80739e17446becc0edd5ccefe",
+    ".smartconfig.json": "202775795f11034486c78ca5d7746a4524e522ea007da650cd66ceb37ed96334",
     "license.md": "cfa51b1d8428e453099273832dc2ec1cebdf23d7ba4eda307883158cfc77da2d",
     "rust-toolchain.toml": "8c3afbe90fa0feff766dffd92e6728a569c0a804cf49f1ecd47bf5ac262499b3",
     "rust/Cargo.lock": "543fc19bc27e5842b6c6326fbb66f9a52f0f0b7935d36181b8fb264a61df7d6f",

package/.smartconfig.json

@@ -1,115 +0,0 @@
-{
-  "@git.zone/cli": {
-    "projectType": "npm",
-    "module": {
-      "githost": "code.foss.global",
-      "gitscope": "lossless.org",
-      "gitrepo": "nosqldb",
-      "description": "A MongoDB-compatible embedded database server with wire protocol support, backed by a high-performance Rust engine.",
-      "npmPackagename": "@lossless.org/nosqldb",
-      "license": "MIT",
-      "projectDomain": "lossless.org",
-      "keywords": [
-        "mongodb-compatible",
-        "wire protocol",
-        "embedded database",
-        "in-memory database",
-        "testing",
-        "local database",
-        "database server",
-        "rust"
-      ]
-    },
-    "commit": {
-      "push": {
-        "remote": "lossless",
-        "followTags": true
-      }
-    },
-    "release": {
-      "preflight": {
-        "test": true,
-        "testCommand": "pnpm run release:check-builders",
-        "build": true,
-        "buildCommand": "pnpm run release:build-artifacts"
-      },
-      "targets": {
-        "git": {
-          "enabled": true,
-          "remote": "lossless",
-          "pushBranch": true,
-          "pushTags": true
-        },
-        "npm": {
-          "enabled": true,
-          "registries": [
-            "https://verdaccio.lossless.digital",
-            "https://registry.npmjs.org"
-          ],
-          "accessLevel": "public",
-          "alreadyPublished": "success"
-        }
-      }
-    },
-    "services": [],
-    "schemaVersion": 2
-  },
-  "@git.zone/tsdoc": {
-    "legal": "\n## License and Legal Information\n\nThis repository contains open-source code that is licensed under the MIT License. A copy of the MIT License can be found in the [license](license.md) file within this repository. \n\n**Please note:** The MIT License does not grant permission to use the trade names, trademarks, service marks, or product names of the project, except as required for reasonable and customary use in describing the origin of the work and reproducing the content of the NOTICE file.\n\n### Trademarks\n\nThis project is owned and maintained by Task Venture Capital GmbH. The names and logos associated with Task Venture Capital GmbH and any related products or services are trademarks of Task Venture Capital GmbH and are not included within the scope of the MIT license granted herein. Use of these trademarks must comply with Task Venture Capital GmbH's Trademark Guidelines, and any usage must be approved in writing by Task Venture Capital GmbH.\n\n### Company Information\n\nTask Venture Capital GmbH  \nRegistered at District court Bremen HRB 35230 HB, Germany\n\nFor any legal inquiries or if you require further information, please contact us via email at hello@task.vc.\n\nBy using this repository, you acknowledge that you have read this section, agree to comply with its terms, and understand that the licensing of the code does not imply endorsement by Task Venture Capital GmbH of any derivative works.\n"
-  },
-  "@git.zone/tsbundle": {
-    "bundles": [
-      {
-        "from": "./ts_debugui/index.ts",
-        "to": "./ts_debugserver/bundled.ts",
-        "outputMode": "base64ts",
-        "bundler": "esbuild",
-        "includeFiles": [
-          {
-            "from": "./html/index.html",
-            "to": "index.html"
-          }
-        ]
-      }
-    ]
-  },
-  "@git.zone/tsrust": {
-    "targetsByHost": {
-      "linux": [
-        "linux_amd64",
-        "linux_arm64",
-        "linux_amd64_musl",
-        "linux_arm64_musl"
-      ],
-      "macos": [
-        "macos_amd64",
-        "macos_arm64"
-      ]
-    },
-    "locked": true,
-    "static": false,
-    "matrix": {
-      "builders": {
-        "macos_arm64": {
-          "transport": "ssh",
-          "destinationEnv": "NOSQLDB_RELEASE_MACOS_SSH",
-          "temporaryRootEnv": "NOSQLDB_RELEASE_MACOS_TEMP_ROOT"
-        },
-        "linux_amd64": {
-          "transport": "local"
-        }
-      },
-      "smokeTestArgs": [
-        "--version"
-      ],
-      "verificationCommand": [
-        "pnpm",
-        "run",
-        "release:verify-native"
-      ]
-    }
-  },
-  "@ship.zone/szci": {
-    "npmGlobalTools": []
-  }
-}

package/ts/00_commitinfo_data.ts

@@ -1,8 +0,0 @@
-/**
- * autocreated commitinfo by @push.rocks/commitinfo
- */
-export const commitinfo = {
-  name: '@lossless.org/nosqldb',
-  version: '10.10.0',
-  description: 'A MongoDB-compatible embedded database server with wire protocol support, backed by a high-performance Rust engine.'
-}

package/ts/index.ts

@@ -1,85 +0,0 @@
-import { commitinfo } from './00_commitinfo_data.js';
-
-// Export core NoSQLDB module
-export * from './ts_nosqldb/index.js';
-
-// Export LocalNoSqlDb
-export { LocalNoSqlDb } from './ts_local/index.js';
-export type {
-  ILocalNoSqlDbOptions,
-  ILocalNoSqlDbConnectionInfo,
-  ILocalNoSqlDbOfflineInspectionLimits,
-  ILocalNoSqlDbOfflinePhysicalNamespaceInspectionLimits,
-  ILocalNoSqlDbOfflinePhysicalNamespaceInspection,
-  ILocalNoSqlDbOfflinePhysicalNamespaceInspectionResult,
-  ILocalNoSqlDbOfflineStringValueInspection,
-  TLocalNoSqlDbOfflineStringValueInspectionResult,
-  ILocalNoSqlDbStoppedStorageRootRelocationInput,
-  ILocalNoSqlDbStoppedStorageRootRelocationReceipt,
-  TLocalNoSqlDbStorageRootRelocationErrorCode,
-} from './ts_local/index.js';
-export {
-  LocalNoSqlDbStorageRootRelocationError,
-  localNoSqlDbStorageRootRelocationErrorCodes,
-} from './ts_local/index.js';
-
-// Export commitinfo
-export { commitinfo };
-
-// Re-export oplog / debug types for convenience
-export type {
-  IOpLogEntry,
-  IOpLogResult,
-  IOpLogStats,
-  IRevertResult,
-  ICollectionInfo,
-  IDocumentsResult,
-  INoSqlDbMetrics,
-  INoSqlDbHealth,
-  INoSqlDbResourceFence,
-  INoSqlDbResourceFenceReceipt,
-  INoSqlDbHeldPublicationReceipt,
-  INoSqlDbCommitDatabasePublicationInput,
-  INoSqlDbManagementOperationOptions,
-  INoSqlDbDatabaseResourceFenceState,
-  INoSqlDbDatabaseAllocationIdentity,
-  INoSqlDbDatabaseAllocationLifecycle,
-  INoSqlDbDatabaseAllocationReadAccessGrantIdentity,
-  INoSqlDbIssueDatabaseAllocationReadAccessGrantInput,
-  INoSqlDbIssueDatabaseAllocationReadAccessGrantResult,
-  INoSqlDbRevokeDatabaseAllocationReadAccessGrantInput,
-  INoSqlDbRevokeDatabaseAllocationReadAccessGrantResult,
-  TNoSqlDbCommitDatabasePublicationResult,
-  TNoSqlDbResourceFenceErrorCode,
-  TNoSqlDbAllocationReadAccessGrantErrorCode,
-  INoSqlDbDatabaseTenantInput,
-  INoSqlDbAttestDatabaseTenantInput,
-  INoSqlDbAttestDatabaseTenantResult,
-  INoSqlDbEnsureDatabaseTenantInput,
-  INoSqlDbEnsureDatabaseTenantResult,
-  INoSqlDbAllocateDatabaseTenantInput,
-  INoSqlDbAllocateDatabaseTenantResult,
-  INoSqlDbDeleteDatabaseTenantInput,
-  INoSqlDbRotateDatabaseTenantPasswordInput,
-  INoSqlDbDatabaseTenantDescriptor,
-  INoSqlDbDeleteDatabaseTenantResult,
-  INoSqlDbDatabaseExportCollection,
-  INoSqlDbDatabaseExport,
-  INoSqlDbDatabaseExportLimits,
-  INoSqlDbExportDatabaseInput,
-  INoSqlDbDatabaseContentDigestLimits,
-  INoSqlDbGetDatabaseContentDigestInput,
-  INoSqlDbDatabaseContentDigest,
-  INoSqlDbImportDatabaseInput,
-  INoSqlDbImportDatabaseResult,
-  TNoSqlDbEffectivePayloadInputV1,
-} from './ts_nosqldb/index.js';
-export {
-  NoSqlDbAllocationReadAccessGrantError,
-  normalizeNoSqlDbAllocationReadAccessGrantError,
-  noSqlDbAllocationReadAccessGrantErrorCodes,
-  NoSqlDbResourceFenceError,
-  normalizeNoSqlDbResourceFenceError,
-  noSqlDbResourceFenceErrorCodes,
-  createNoSqlDbEffectivePayloadSha256V1,
-} from './ts_nosqldb/index.js';