monsqlize 3.1.0 → 3.2.0

package/CHANGELOG.md

@@ -1,7 +1,7 @@
 # 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 latest stable release details are in [changelogs/v3.2.0.md](./changelogs/v3.2.0.md); the earlier RC note remains an unpublished rehearsal archive.
+> **Last updated**: 2026-08-07
 
 ---
 
@@ -9,6 +9,7 @@
 
 | Version | Date | Summary | Details |
 |---------|------|---------|---------|
+| [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

@@ -7,9 +7,9 @@ Database-native production data runtime layer for TypeScript services. monSQLize
 [![MongoDB](https://img.shields.io/badge/MongoDB-7.x%20%2F%208.x-green.svg)](https://www.mongodb.com/)
 [![Node.js](https://img.shields.io/badge/Node.js-18%2B-brightgreen)](https://nodejs.org/)
 
-Documentation: [English](https://vextjs.github.io/monSQLize/) · [简体中文](https://vextjs.github.io/monSQLize/zh/)
-Quick path: [Installation](https://vextjs.github.io/monSQLize/getting-started) · [Basic Usage](https://vextjs.github.io/monSQLize/basic-operations)
-Configuration reference: [English](https://vextjs.github.io/monSQLize/configuration) · [简体中文](https://vextjs.github.io/monSQLize/zh/configuration)
+Documentation: [English](https://devcodex-labs.github.io/monSQLize/) · [简体中文](https://devcodex-labs.github.io/monSQLize/zh/)
+Quick path: [Installation](https://devcodex-labs.github.io/monSQLize/getting-started) · [Basic Usage](https://devcodex-labs.github.io/monSQLize/basic-operations)
+Configuration reference: [English](https://devcodex-labs.github.io/monSQLize/configuration) · [简体中文](https://devcodex-labs.github.io/monSQLize/zh/configuration)
 Upgrade and security: [Migration Guide](./MIGRATION.md) · [Private Vulnerability Reporting](./SECURITY.md)
 
 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.
@@ -134,7 +134,7 @@ await users.updateOne(
 await msq.close();
 ```
 
-Next, use the [Basic Usage guide](https://vextjs.github.io/monSQLize/basic-operations) for common CRUD, pagination, read cache, and Model entry-point examples.
+Next, use the [Basic Usage guide](https://devcodex-labs.github.io/monSQLize/basic-operations) for common CRUD, pagination, read cache, and Model entry-point examples.
 
 ### ESM and TypeScript
 
@@ -496,34 +496,34 @@ The v3 line has been validated against the workspace consumers `chat`, `payment`
 
 See the current support and verification documents:
 
-- [English documentation](https://github.com/vextjs/monSQLize/blob/main/docs/en/README.md)
-- [Chinese documentation](https://github.com/vextjs/monSQLize/blob/main/docs/zh/README.md)
-- [English common scenarios](https://github.com/vextjs/monSQLize/blob/main/docs/en/recipes.md)
-- [Support matrix](https://github.com/vextjs/monSQLize/blob/main/docs/en/support-matrix.md)
-- [test/compatibility/README.md](https://github.com/vextjs/monSQLize/blob/main/test/compatibility/README.md)
-- [test/validation/VERIFICATION-PROGRESS.md](https://github.com/vextjs/monSQLize/blob/main/test/validation/VERIFICATION-PROGRESS.md)
+- [English documentation](https://github.com/devcodex-labs/monSQLize/blob/main/docs/en/README.md)
+- [Chinese documentation](https://github.com/devcodex-labs/monSQLize/blob/main/docs/zh/README.md)
+- [English common scenarios](https://github.com/devcodex-labs/monSQLize/blob/main/docs/en/recipes.md)
+- [Support matrix](https://github.com/devcodex-labs/monSQLize/blob/main/docs/en/support-matrix.md)
+- [test/compatibility/README.md](https://github.com/devcodex-labs/monSQLize/blob/main/test/compatibility/README.md)
+- [test/validation/VERIFICATION-PROGRESS.md](https://github.com/devcodex-labs/monSQLize/blob/main/test/validation/VERIFICATION-PROGRESS.md)
 
 ## Documentation
 
 Current TypeScript documentation and examples are the source of truth for the v3 package:
 
-- Complete docs: [English](https://vextjs.github.io/monSQLize/) · [简体中文](https://vextjs.github.io/monSQLize/zh/)
-- Constructor configuration: [English](https://vextjs.github.io/monSQLize/configuration) · [简体中文](https://vextjs.github.io/monSQLize/zh/configuration)
-- Production rollout: [English](https://vextjs.github.io/monSQLize/production-rollout) · [简体中文](https://vextjs.github.io/monSQLize/zh/production-rollout)
-- Production data migration: [English](https://vextjs.github.io/monSQLize/production-data-migration) · [简体中文](https://vextjs.github.io/monSQLize/zh/production-data-migration)
-- Data tasks API: [English](https://vextjs.github.io/monSQLize/data-tasks) · [简体中文](https://vextjs.github.io/monSQLize/zh/data-tasks)
-- Common scenarios: [English](https://vextjs.github.io/monSQLize/recipes) · [简体中文](https://vextjs.github.io/monSQLize/zh/recipes)
-- Example source: [examples index](https://github.com/vextjs/monSQLize/blob/main/examples/README.md)
-- Documentation source: [docs/en](https://github.com/vextjs/monSQLize/tree/main/docs/en) · [docs/zh](https://github.com/vextjs/monSQLize/tree/main/docs/zh)
-- Compatibility checks: [test/compatibility](https://github.com/vextjs/monSQLize/tree/main/test/compatibility)
-- Verification mapping: [test/validation](https://github.com/vextjs/monSQLize/tree/main/test/validation)
+- Complete docs: [English](https://devcodex-labs.github.io/monSQLize/) · [简体中文](https://devcodex-labs.github.io/monSQLize/zh/)
+- Constructor configuration: [English](https://devcodex-labs.github.io/monSQLize/configuration) · [简体中文](https://devcodex-labs.github.io/monSQLize/zh/configuration)
+- Production rollout: [English](https://devcodex-labs.github.io/monSQLize/production-rollout) · [简体中文](https://devcodex-labs.github.io/monSQLize/zh/production-rollout)
+- Production data migration: [English](https://devcodex-labs.github.io/monSQLize/production-data-migration) · [简体中文](https://devcodex-labs.github.io/monSQLize/zh/production-data-migration)
+- Data tasks API: [English](https://devcodex-labs.github.io/monSQLize/data-tasks) · [简体中文](https://devcodex-labs.github.io/monSQLize/zh/data-tasks)
+- Common scenarios: [English](https://devcodex-labs.github.io/monSQLize/recipes) · [简体中文](https://devcodex-labs.github.io/monSQLize/zh/recipes)
+- Example source: [examples index](https://github.com/devcodex-labs/monSQLize/blob/main/examples/README.md)
+- Documentation source: [docs/en](https://github.com/devcodex-labs/monSQLize/tree/main/docs/en) · [docs/zh](https://github.com/devcodex-labs/monSQLize/tree/main/docs/zh)
+- Compatibility checks: [test/compatibility](https://github.com/devcodex-labs/monSQLize/tree/main/test/compatibility)
+- Verification mapping: [test/validation](https://github.com/devcodex-labs/monSQLize/tree/main/test/validation)
 
 Historical v1 and v2 assets are useful for tracing old behavior, but they are not the current publishing surface for v3.
 
 ## Development
 
 ```bash
-git clone https://github.com/vextjs/monSQLize.git
+git clone https://github.com/devcodex-labs/monSQLize.git
 cd monSQLize
 npm install
 ```
@@ -581,6 +581,6 @@ monSQLize is released under the [Apache License 2.0](./LICENSE).
 
 ## Support
 
-- Issues: [GitHub Issues](https://github.com/vextjs/monSQLize/issues)
+- Issues: [GitHub Issues](https://github.com/devcodex-labs/monSQLize/issues)
 - npm: [monsqlize](https://www.npmjs.com/package/monsqlize)
-- Website: [https://vextjs.github.io/monSQLize/](https://vextjs.github.io/monSQLize/)
+- Website: [https://devcodex-labs.github.io/monSQLize/](https://devcodex-labs.github.io/monSQLize/)

package/SECURITY.md

@@ -9,7 +9,7 @@ support window.
 
 ## Reporting a Vulnerability / 报告安全问题
 
-Use [GitHub private vulnerability reporting](https://github.com/vextjs/monSQLize/security/advisories/new).
+Use [GitHub private vulnerability reporting](https://github.com/devcodex-labs/monSQLize/security/advisories/new).
 Do not open a public issue for an undisclosed vulnerability.
 
 - Include the affected version, minimal reproduction, impact, and any known workaround.

package/changelogs/v3.1.11.md

@@ -0,0 +1,12 @@
+# monSQLize v3.1.11
+
+> Release date: 2026-07-27
+
+## Highlights
+
+- chore: republish package repository/homepage metadata for GitHub org `devcodex-labs`.
+- Package name `monsqlize` unchanged.
+
+## Compatibility boundaries
+
+- No runtime API changes in this metadata release.

package/changelogs/v3.1.12.md

@@ -0,0 +1,12 @@
+# monSQLize v3.1.12
+
+> Release date: 2026-07-27
+
+## Highlights
+
+- chore: republish package repository/homepage metadata for GitHub org `devcodex-labs`.
+- Package name `monsqlize` unchanged.
+
+## Compatibility boundaries
+
+- No runtime API changes in this metadata release.

package/changelogs/v3.1.13.md

@@ -0,0 +1,12 @@
+# monSQLize v3.1.13
+
+> Release date: 2026-07-27
+
+## Highlights
+
+- chore: republish package repository/homepage metadata for GitHub org `devcodex-labs`.
+- Package name `monsqlize` unchanged.
+
+## Compatibility boundaries
+
+- No runtime API changes in this metadata release.

package/changelogs/v3.1.14.md

@@ -0,0 +1,12 @@
+# monSQLize v3.1.14
+
+> Release date: 2026-07-27
+
+## Highlights
+
+- chore: republish package repository/homepage metadata for GitHub org `devcodex-labs`.
+- Package name `monsqlize` unchanged.
+
+## Compatibility boundaries
+
+- No runtime API changes in this metadata release.

package/changelogs/v3.1.5.md

@@ -0,0 +1,3 @@
+# v3.1.5
+
+- chore: fix package.json and package-lock version for release preflight.

package/changelogs/v3.1.6.md

@@ -0,0 +1,4 @@
+# v3.1.6
+
+- chore: include release changelog in package files for preflight coverage.
+- Package name `monsqlize` unchanged; repository metadata on devcodex-labs.

package/changelogs/v3.1.7.md

@@ -0,0 +1,7 @@
+# monSQLize v3.1.7
+
+> Release date: 2026-07-27
+
+## Highlights
+
+- Intermediate metadata release attempt (superseded by v3.1.8 packaging fixes).

package/changelogs/v3.1.8.md

@@ -0,0 +1,12 @@
+# monSQLize v3.1.8
+
+> Release date: 2026-07-27
+
+## Highlights
+
+- chore: republish package repository/homepage metadata for GitHub org `devcodex-labs`.
+- Package name `monsqlize` unchanged.
+
+## Compatibility boundaries
+
+- No runtime API changes in this metadata release.

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/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.0",
+  version: "3.2.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,10 +52,19 @@ var package_default = {
     "./package.json": "./package.json"
   },
   files: [
+    "changelogs/v3.2.0.md",
+    "changelogs/v3.1.14.md",
+    "changelogs/v3.1.13.md",
+    "changelogs/v3.1.12.md",
+    "changelogs/v3.1.11.md",
+    "changelogs/v3.1.7.md",
+    "changelogs/v3.1.8.md",
     "dist/**/*.cjs",
     "dist/**/*.mjs",
     "dist/**/*.d.ts",
     "dist/**/*.d.mts",
+    "changelogs/v3.1.6.md",
+    "changelogs/v3.1.5.md",
     "changelogs/v3.1.0.md",
     "changelogs/v3.1.0-rc.0.md",
     "changelogs/v3.0.0.md",
@@ -95,12 +104,12 @@ var package_default = {
   license: "Apache-2.0",
   repository: {
     type: "git",
-    url: "git+https://github.com/vextjs/monSQLize.git"
+    url: "git+https://github.com/devcodex-labs/monSQLize.git"
   },
   bugs: {
-    url: "https://github.com/vextjs/monSQLize/issues"
+    url: "https://github.com/devcodex-labs/monSQLize/issues"
   },
-  homepage: "https://vextjs.github.io/monSQLize/",
+  homepage: "https://devcodex-labs.github.io/monSQLize/",
   publishConfig: {
     access: "public",
     registry: "https://registry.npmjs.org/"
@@ -184,6 +193,15 @@ var package_default = {
     mongodb: "6.21.0",
     "schema-dsl": "3.0.0",
     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"
+    }
   }
 };