monsqlize 3.1.14 → 3.3.0

package/CHANGELOG.md

@@ -1,14 +1,20 @@
 # CHANGELOG
 
-> Summary index — the v3.1.0 stable release details are in [changelogs/v3.1.0.md](./changelogs/v3.1.0.md); the earlier RC note remains an unpublished rehearsal archive.
-> **Last updated**: 2026-07-15
+> Summary index — the newest versioned release details are in [changelogs/v3.3.0.md](./changelogs/v3.3.0.md); the earlier RC note remains an unpublished rehearsal archive.
+> **Last updated**: 2026-08-11
 
 ---
 
+## Unreleased
+
+No changes are currently recorded after v3.3.0.
+
 ## Version Overview
 
 | Version | Date | Summary | Details |
 |---------|------|---------|---------|
+| [v3.3.0](./changelogs/v3.3.0.md) | 2026-08-11 | Minor: static Model schema type inference, schema-dsl 3.0.4, and silent-by-default Pool logging | [View](./changelogs/v3.3.0.md) |
+| [v3.2.0](./changelogs/v3.2.0.md) | 2026-08-07 | Minor: Vector Search APIs, relation-safe Model deletion, and relation projection improvements | [View](./changelogs/v3.2.0.md) |
 | [v3.1.0](./changelogs/v3.1.0.md) | 2026-07-15 | Minor: schema-dsl v3 GA consumption, canonical validation errors, and normalized full-document persistence | [View](./changelogs/v3.1.0.md) |
 | [v3.0.0](./changelogs/v3.0.0.md) | 2026-07-14 | Major: two-instance preview/apply/restore data tasks, write-path policy, runtime-scoped schema DSL, stricter OCC/sync/query contracts, and release recovery controls | [View](./changelogs/v3.0.0.md) |
 | [v2.0.7](./changelogs/v2.0.7.md) | Unpublished | Withdrawn patch candidate; never published and superseded by v3.0.0 | [Archive](./changelogs/v2.0.7.md) |

package/README.md

@@ -14,7 +14,7 @@ Upgrade and security: [Migration Guide](./MIGRATION.md) · [Private Vulnerabilit
 
 The npm `latest` dist-tag and GitHub Pages are the stable channel; `main` may contain the next release. Pages deployment accepts only a versioned Git tag whose package version is already present on npm, so unpublished APIs are not promoted as stable documentation.
 
-This source tree contains the stable `3.1.0` release candidate, pinned to verified registry `schema-dsl@3.0.0`. The v3 package remains subject to the full release gate before its immutable tag and npm publication.
+This development source is pinned to verified registry `schema-dsl@3.0.4`. The v3 package remains subject to the full release gate before an immutable tag and npm publication.
 
 ```bash
 npm install monsqlize
@@ -234,6 +234,30 @@ const user = await User.insertOne({
 });
 ```
 
+### TypeScript Schema Inference
+
+For a static object-literal schema, `defineModel()` carries the schema-derived document type from definition through registration to runtime access. Registration remains explicit, so it does not change the process-wide Model registry behavior.
+
+```ts
+import { defineModel, Model } from 'monsqlize';
+
+const User = defineModel('users', {
+  schema: {
+    email: 'email!',
+    age: 'number?'
+  }
+});
+
+Model.define(User);
+
+const users = msq.model(User);
+const user = await users.findOne({ email: 'ada@example.com' });
+// user?.email: string
+// user?.age: number | undefined
+```
+
+Call `Model.define(User)` before `model(User)`, `use(...).model(User)`, or `pool(...).model(User)`. Callback-based or dynamically composed schemas continue to use the existing explicit generic API, such as `msq.model<UserDocument>('users')`; managed fields added by timestamps, soft delete, versioning, relations, or virtuals are not synthesized into this schema-derived type.
+
 When a service needs runtime-local custom types, messages, locale, or an already-owned schema-dsl runtime, configure `schemaDsl` on the MonSQLize instance:
 
 ```js

package/changelogs/v3.2.0.md

@@ -0,0 +1,24 @@
+# monSQLize v3.2.0
+
+> Release date: 2026-08-07
+
+## Highlights
+
+- Added first-class Vector Search entrypoints for Collections and Models.
+- Added relation-aware Model deletion guards and completed relation projection behavior.
+
+## Added
+
+- Added `Collection.vectorSearch()` and `Model.vectorSearch()` with ANN/ENN option validation, score envelopes, and Model soft-delete visibility expressed inside `$vectorSearch.filter`.
+- Added Model relation-usage reporting plus explicit restrict-style `deleteOneWithRelations()` and `forceDeleteWithRelations()` methods.
+
+## Changed
+
+- `populate()` now supports local ID arrays, relation-level default inclusion selection, server-side relation projections, and cleanup of internal join keys after nested population.
+- Added stable `INVALID_VECTOR_SEARCH`, `INVALID_RELATION_SELECT`, `RELATION_IN_USE`, and `RELATION_USAGE_UNAVAILABLE` error codes.
+- Updated production dependency overrides to resolve audited `fast-uri` and `brace-expansion` versions.
+
+## Compatibility boundaries
+
+- This is a backward-compatible minor release. Existing `expr` APIs remain unchanged.
+- Vector Search requires a MongoDB-compatible deployment with a pre-created Vector Search index. The API validates its local contract; deployment/index execution remains an operator-managed prerequisite.

package/changelogs/v3.3.0.md

@@ -0,0 +1,29 @@
+# monSQLize v3.3.0
+
+> Release date: 2026-08-11
+
+## Highlights
+
+- Added schema-derived TypeScript document inference for static Model definitions.
+- Made Pool logging silent by default while preserving explicit logger delivery.
+
+## Added
+
+- Added `defineModel()` and `ModelDescriptor` so object-literal `schema` definitions carry their inferred document type through `Model.define()`, `model()`, `scopedModel()`, `use().model()`, and `pool().model()`.
+- Added CJS, ESM, public-type, compatibility, pack-consumer, and registry-consumer verification for the descriptor API.
+
+## Changed
+
+- Updated the exact production dependency from `schema-dsl@3.0.0` to `schema-dsl@3.0.4`.
+- Extended current-version validation so README and bilingual dependency-governance documents must match the exact `schema-dsl` version in `package.json`.
+
+## Fixed
+
+- Forwarded the configured `ConnectionPoolManager` logger to `PoolSelector`, `HealthChecker`, and `PoolStatsManager`.
+- Removed implicit `console` fallback logging from Pool helpers when no logger is configured.
+
+## Compatibility boundaries
+
+- This is a backward-compatible minor release. Existing string-based Model registration/access, manual TypeScript generics, Pool APIs, and explicit process-wide Model registry lifecycle remain unchanged.
+- `defineModel()` creates a static descriptor; it does not register the Model. Call `Model.define(descriptor)` before binding it through a runtime accessor.
+- Callback or dynamically composed schemas continue to use explicit document generics. Schema-derived types do not synthesize timestamp, soft-delete, version, relation, or virtual fields.

package/dist/cjs/cli/data-task.cjs

@@ -31,7 +31,7 @@ var import_node_url = require("node:url");
 // package.json
 var package_default = {
   name: "monsqlize",
-  version: "3.1.14",
+  version: "3.3.0",
   description: "TypeScript production data runtime layer for MongoDB today, with cache, transactions, pools, models, sync, and observability",
   type: "commonjs",
   main: "./dist/cjs/index.cjs",
@@ -52,6 +52,8 @@ var package_default = {
     "./package.json": "./package.json"
   },
   files: [
+    "changelogs/v3.3.0.md",
+    "changelogs/v3.2.0.md",
     "changelogs/v3.1.14.md",
     "changelogs/v3.1.13.md",
     "changelogs/v3.1.12.md",
@@ -190,8 +192,17 @@ var package_default = {
     "cache-hub": "2.2.4",
     ioredis: "5.11.1",
     mongodb: "6.21.0",
-    "schema-dsl": "3.0.0",
+    "schema-dsl": "3.0.4",
     ssh2: "1.17.0"
+  },
+  overrides: {
+    "fast-uri": "3.1.5",
+    "minimatch@3.1.5": {
+      "brace-expansion": "1.1.18"
+    },
+    "minimatch@10.2.5": {
+      "brace-expansion": "5.0.9"
+    }
   }
 };