fix: release monsqlize 2.0.6 compatibility

Author: rockyshi1993

CHANGELOG.md

@@ -1,14 +1,15 @@
 # CHANGELOG
 
-> Summary index — current release details are packaged in [changelogs/v2.0.5.md](./changelogs/v2.0.5.md); historical details live in the repository changelog archive.
-> **Last updated**: 2026-06-13
+> Summary index — current release details are packaged in [changelogs/v2.0.6.md](./changelogs/v2.0.6.md); historical details live in the repository changelog archive.
+> **Last updated**: 2026-06-15
 
 ---
 
 ## Version Overview
 
 | Version | Date | Summary | Details |
 |---------|------|---------|---------|
+| [v2.0.6](./changelogs/v2.0.6.md) | 2026-06-15 | Patch: dependency alignment to `schema-dsl@2.0.11` so downstream frameworks inherit the ESM/CJS shared custom type registry fix | [View](./changelogs/v2.0.6.md) |
 | [v2.0.5](./changelogs/v2.0.5.md) | 2026-06-13 | Patch: Model schema adapter delegates DSL type authority to `schema-dsl@2.0.10`, removing the duplicated monSQLize allowlist while preserving legacy aliases and business literals | [View](./changelogs/v2.0.5.md) |
 | [v2.0.4](./changelogs/v2.0.4.md) | 2026-06-12 | Patch: production-safe Model index rollout controls, `schema-dsl@2.0.9`, capability-index wording cleanup, and documentation home refinements | [View](./changelogs/v2.0.4.md) |
 | [v2.0.3](./changelogs/v2.0.3.md) | 2026-06-11 | Patch: v1 compatibility fixes, public stats APIs, standalone docs-site link safety, bilingual docs consistency, and release preflight alignment | [View](./changelogs/v2.0.3.md) |
@@ -448,7 +449,8 @@ const result = await msq.collection('orders').insertOne(dataFromMongoose);
 changelogs/
 ├── README.md          # 变更文档说明
 ├── TEMPLATE.md        # 变更文档模板
-├── v2.0.5.md         # 当前发布详细变更
+├── v2.0.6.md         # 当前发布详细变更
+├── v2.0.5.md         # v2.0.5 详细变更
 ├── v2.0.4.md         # v2.0.4 详细变更
 ├── v2.0.3.md         # v2.0.3 详细变更
 ├── v2.0.2.md         # v2.0.2 详细变更
@@ -504,7 +506,8 @@ changelogs/
 
 ## 相关文档
 
-- [changelogs/v2.0.5.md](./changelogs/v2.0.5.md) - 当前发布详细变更文档
+- [changelogs/v2.0.6.md](./changelogs/v2.0.6.md) - 当前发布详细变更文档
+- [changelogs/v2.0.5.md](./changelogs/v2.0.5.md) - v2.0.5 详细变更文档
 - [changelogs/v2.0.4.md](./changelogs/v2.0.4.md) - v2.0.4 详细变更文档
 - [changelogs/v2.0.3.md](./changelogs/v2.0.3.md) - v2.0.3 详细变更文档
 - [changelogs/v2.0.2.md](./changelogs/v2.0.2.md) - v2.0.2 详细变更文档
@@ -514,5 +517,5 @@ changelogs/
 
 ---
 
-**最后更新**: 2026-06-13
+**最后更新**: 2026-06-15
 

README.md

@@ -518,19 +518,25 @@ npm run test:real-env:private
 
 ## Release Status
 
-The current published release is `v2.0.4`.
+The current release train targets `v2.0.6`.
 
 Key release-readiness points:
 
 - TypeScript rewrite completed for the current runtime and test entry points.
 - Package exports are consolidated under `dist/cjs`, `dist/esm`, and `dist/types`.
 - npm packages include the runtime bundles and declaration files only; source maps are disabled by default and can be generated locally with `MONSQLIZE_BUILD_SOURCEMAPS=1 npm run build`.
 - v1 smooth-upgrade compatibility has been validated against the target workspace consumers.
-- `schema-dsl` follows the npm `latest` TypeScript line `schema-dsl@2.0.9`; deprecated `2.3.x` mistake releases are intentionally excluded.
+- `schema-dsl` follows the npm `latest` TypeScript line `schema-dsl@2.0.11`; deprecated `2.3.x` mistake releases are intentionally excluded.
 - GitHub Actions publishes to npm from `v*` tags after running `npm run release:preflight`; the publish step skips duplicate lifecycle scripts because the gate already ran in the same job.
 
 ## Roadmap
 
+### v2.0.6
+
+- Dependency alignment to `schema-dsl@2.0.11`, carrying the shared ESM/CJS custom type registry fix to downstream vext applications.
+- NodeNext declaration compatibility for ESM consumers through generated `*.d.mts` mirrors and import-side `types` conditions.
+- Restored v1-compatible root option type exports.
+
 ### v2.0.4
 
 - Production-safe Model index rollout controls with `autoIndex`, dry-run preflight, conflict reporting, and explicit `ensureIndexes()` / `ensureModelIndexes()` APIs.

changelogs/v2.0.6.md

@@ -0,0 +1,16 @@
+# monSQLize v2.0.6
+
+Released: 2026-06-15
+
+## Changes
+
+- Upgrade runtime dependency `schema-dsl` from `2.0.10` to `2.0.11`.
+- This keeps monSQLize aligned with the schema-dsl ESM/CJS shared custom type registry fix used by downstream vext applications.
+- Restore v1-compatible root type exports: `FindOptions`, `CountOptions`, `AggregateOptions`, and `DistinctOptions`.
+- Add NodeNext-safe type-only import attributes for ESM `cache-hub` declarations consumed from monSQLize's CommonJS package boundary.
+- Generate ESM declaration mirrors (`*.d.mts`) and point the import-side package `types` condition at `dist/types/index.d.mts`, preserving default import constructability for NodeNext ESM consumers.
+
+## Validation
+
+- Dependency-only release; full release preflight should run after `schema-dsl@2.0.11` is available from npm.
+- `npm run type-check`

docs/en/file-dependency-governance.md

@@ -4,10 +4,10 @@ The current root package adopts the **precise version dependency strategy**:
 
 | Dependencies | Strategy | Reasons |
 |------|------|------|
-| `cache-hub` | Exact version `2.2.4` | The npm latest release has passed compatibility verification; the root direct dependency is fixed to 2.2.4, and `schema-dsl@2.0.10` declares the same transitive dependency version |
-| `schema-dsl` | Exact version `2.0.10` | The release chain targets the current non-deprecated TypeScript line; monSQLize relies on schema-dsl for DSL parsing, validation and alias diagnostics, and uses 2.0.10 for type-check and Model schema verification |
+| `cache-hub` | Exact version `2.2.4` | The npm latest release has passed compatibility verification; the root direct dependency is fixed to 2.2.4, and `schema-dsl@2.0.11` declares the same transitive dependency version |
+| `schema-dsl` | Exact version `2.0.11` | The release chain targets the current non-deprecated TypeScript line; monSQLize relies on schema-dsl for DSL parsing, validation and alias diagnostics, and uses 2.0.11 for type-check and Model schema verification |
 
-> `schema-dsl@2.0.10` is the intended latest for this release chain; the historical `2.3.x` line exists on npm but has been marked as misreleased/deprecated and must not be followed by upgrades.
+> `schema-dsl@2.0.11` is the intended latest for this release chain; the historical `2.3.x` line exists on npm but has been marked as misreleased/deprecated and must not be followed by upgrades.
 
 ## Current Risk
 
@@ -20,8 +20,8 @@ The current root package adopts the **precise version dependency strategy**:
 
 ## Development status
 
-- The root direct `cache-hub` dependency is fixed to `2.2.4`; `schema-dsl@2.0.10` also declares `cache-hub@2.2.4`, so no additional override is needed.
-- `schema-dsl` is fixed to `2.0.10`.
+- The root direct `cache-hub` dependency is fixed to `2.2.4`; `schema-dsl@2.0.11` also declares `cache-hub@2.2.4`, so no additional override is needed.
+- `schema-dsl` is fixed to `2.0.11`.
 - Local sibling `../schema-dsl` is only used for debugging the upstream library itself and is no longer a prerequisite for monSQLize root package installation.
 
 
@@ -36,21 +36,21 @@ npm run release:preflight
 
 ## schema-dsl 2.x upgrade verification
 
-The dependency governance baseline has upgraded and fixed `schema-dsl` from the historical `^1.2.5` to `2.0.10`. The verification standard is as follows:
+The dependency governance baseline has upgraded and fixed `schema-dsl` from the historical `^1.2.5` to `2.0.11`. The verification standard is as follows:
 
-1. The upstream released the **non-deprecated** 2.x latest version on npm: `2.0.10`.
-2. `npm install schema-dsl@2.0.10 --save-exact` followed by `npm run type-check`.
+1. The upstream released the **non-deprecated** 2.x latest version on npm: `2.0.11`.
+2. `npm install schema-dsl@2.0.11 --save-exact` followed by `npm run type-check`.
 3. All model-related unit tests/integration tests passed (covered with `npm run test:unit` and `npm run test:integration`).
 4. `npm run test:examples` all passed.
 5. `npm run release:preflight` still needs to be used as the final access control before release.
-6. This file, Profile, CHANGELOG, and lockfile must be synchronized to `2.0.10`.
+6. This file, Profile, CHANGELOG, and lockfile must be synchronized to `2.0.11`.
 
 ## cache-hub 2.2.4 upgrade verification
 
 The dependency governance baseline has upgraded and fixed `cache-hub` from `1.0.0` to `2.2.4`. The verification standard is as follows:
 
 1. The upstream npm `latest` is `2.2.4`, and the Node.js engine requirement remains `>=18`, matching the current monSQLize baseline.
-2. The root direct dependency resolves to `2.2.4`; `schema-dsl@2.0.10` also declares `cache-hub@2.2.4`.
+2. The root direct dependency resolves to `2.2.4`; `schema-dsl@2.0.11` also declares `cache-hub@2.2.4`.
 3. `npm run type-check`, targeted cache / function-cache tests, website build, and memory probe must pass.
 4. This file, Profile, CHANGELOG, package manifest, and lockfile must be synchronized with the root direct dependency `2.2.4` baseline.
 

docs/en/index.md

@@ -2,7 +2,7 @@
 pageType: home
 
 hero:
-  badge: v2.0.5 TypeScript release
+  badge: v2.0.6 TypeScript release
   name: monSQLize
   text: TypeScript MongoDB Engine
   tagline: MongoDB-native APIs with cache-hub L1/L2 caching, multi-pool routing, Saga workflows, and schema-ready models.

docs/zh/file-dependency-governance.md

@@ -4,10 +4,10 @@
 
 | 依赖 | 策略 | 原因 |
 |------|------|------|
-| `cache-hub` | 精确版本 `2.2.4` | 上游 npm latest 已发布稳定版本并通过兼容验证；根包 direct dependency 固定到 2.2.4，`schema-dsl@2.0.10` 声明的传递依赖同为 2.2.4 |
-| `schema-dsl` | 精确版本 `2.0.10` | 本次发布链路目标为当前非 deprecated 的 TypeScript 正式线；monSQLize 依赖 schema-dsl 统一负责 DSL 解析、验证与 alias diagnostics，并以 2.0.10 执行 type-check 与 Model schema 验证 |
+| `cache-hub` | 精确版本 `2.2.4` | 上游 npm latest 已发布稳定版本并通过兼容验证；根包 direct dependency 固定到 2.2.4，`schema-dsl@2.0.11` 声明的传递依赖同为 2.2.4 |
+| `schema-dsl` | 精确版本 `2.0.11` | 本次发布链路目标为当前非 deprecated 的 TypeScript 正式线；monSQLize 依赖 schema-dsl 统一负责 DSL 解析、验证与 alias diagnostics，并以 2.0.11 执行 type-check 与 Model schema 验证 |
 
-> `schema-dsl@2.0.10` 是本次发布链路的预期 latest；npm 上历史 `2.3.x` 已标记为误发布 / deprecated，不得跟随升级。
+> `schema-dsl@2.0.11` 是本次发布链路的预期 latest；npm 上历史 `2.3.x` 已标记为误发布 / deprecated，不得跟随升级。
 
 ## 当前风险
 
@@ -19,8 +19,8 @@
 
 ### 开发态
 
-- 根包 direct `cache-hub` 固定为 `2.2.4`；`schema-dsl@2.0.10` 声明的 `cache-hub` 版本同为 `2.2.4`，不需要额外 override。
-- `schema-dsl` 固定为 `2.0.10`。
+- 根包 direct `cache-hub` 固定为 `2.2.4`；`schema-dsl@2.0.11` 声明的 `cache-hub` 版本同为 `2.2.4`，不需要额外 override。
+- `schema-dsl` 固定为 `2.0.11`。
 - 本地 sibling `../schema-dsl` 仅用于上游库自身调试，不再作为 monSQLize 根包安装前提。
 
 ### 发布态
@@ -34,21 +34,21 @@ npm run release:preflight
 
 ## schema-dsl 2.x 升级验证
 
-依赖治理基线已将 `schema-dsl` 从历史 `^1.2.5` 升级并固定到 `2.0.10`，验证标准如下：
+依赖治理基线已将 `schema-dsl` 从历史 `^1.2.5` 升级并固定到 `2.0.11`，验证标准如下：
 
-1. 上游在 npm 发布了**非 deprecated** 的 2.x latest 版本：`2.0.10`。
-2. `npm install schema-dsl@2.0.10 --save-exact` 后通过 `npm run type-check`。
+1. 上游在 npm 发布了**非 deprecated** 的 2.x latest 版本：`2.0.11`。
+2. `npm install schema-dsl@2.0.11 --save-exact` 后通过 `npm run type-check`。
 3. model 相关单测 / 集成测试全通过（随 `npm run test:unit` 与 `npm run test:integration` 覆盖）。
 4. `npm run test:examples` 全通过。
 5. 发布前仍需以 `npm run release:preflight` 作为最终门禁。
-6. 本文件、Profile、CHANGELOG 与 lockfile 必须同步到 `2.0.10`。
+6. 本文件、Profile、CHANGELOG 与 lockfile 必须同步到 `2.0.11`。
 
 ## cache-hub 2.2.4 升级验证
 
 依赖治理基线已将 `cache-hub` 从 `1.0.0` 升级并固定到 `2.2.4`，验证标准如下：
 
 1. 上游 npm `latest` 为 `2.2.4`，Node.js 引擎要求仍为 `>=18`，与 monSQLize 当前基线一致。
-2. 根包 direct dependency 解析到 `2.2.4`；`schema-dsl@2.0.10` 也声明 `cache-hub@2.2.4`。
+2. 根包 direct dependency 解析到 `2.2.4`；`schema-dsl@2.0.11` 也声明 `cache-hub@2.2.4`。
 3. `npm run type-check`、缓存 / function-cache 定向测试、文档站构建与内存探针必须通过。
 4. 本文件、Profile、CHANGELOG、package manifest 与 lockfile 必须同步 root direct dependency 的 `2.2.4` 口径。
 

docs/zh/index.md

@@ -2,7 +2,7 @@
 pageType: home
 
 hero:
-  badge: v2.0.5 TypeScript 正式版
+  badge: v2.0.6 TypeScript 正式版
   name: monSQLize
   text: TypeScript MongoDB 增强引擎
   tagline: 保留 MongoDB 原生体验，整合 cache-hub 两级缓存、多连接池路由、Saga 编排与可选 Model 层。

package-lock.json

@@ -1,14 +1,17 @@
 {
   "name": "monsqlize",
-  "version": "2.0.5",
+  "version": "2.0.6",
   "description": "TypeScript-native MongoDB ODM with multi-level caching (cache-hub), distributed locks, Saga orchestration, unified expression system (122 operators), connection pool management, ChangeStream sync, slow-query logging, and full v1 API compatibility",
   "type": "commonjs",
   "main": "./dist/cjs/index.cjs",
   "module": "./dist/esm/index.mjs",
   "types": "./dist/types/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/types/index.d.ts",
+      "types": {
+        "import": "./dist/types/index.d.mts",
+        "require": "./dist/types/index.d.ts"
+      },
       "require": "./dist/cjs/index.cjs",
       "import": "./dist/esm/index.mjs"
     },
@@ -18,6 +21,8 @@
     "dist/**/*.cjs",
     "dist/**/*.mjs",
     "dist/**/*.d.ts",
+    "dist/**/*.d.mts",
+    "changelogs/v2.0.6.md",
     "changelogs/v2.0.5.md",
     "changelogs/v2.0.4.md",
     "changelogs/v2.0.3.md",
@@ -117,7 +122,7 @@
     "cache-hub": "2.2.4",
     "ioredis": "5.8.2",
     "mongodb": "6.21.0",
-    "schema-dsl": "2.0.10",
+    "schema-dsl": "2.0.11",
     "ssh2": "1.17.0"
   }
 }

package.json

@@ -1,8 +1,35 @@
-const { cpSync, mkdirSync, rmSync } = require('node:fs');
+const { cpSync, mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } = require('node:fs');
+const { join } = require('node:path');
 const { build } = require('esbuild');
 
 const emitSourceMaps = process.env.MONSQLIZE_BUILD_SOURCEMAPS === '1';
 
+function toEsmDeclaration(content) {
+    return content
+        .replace(/from '((?:\.\/|\.\.\/)[^']+)'/g, (_match, specifier) => {
+            return specifier.endsWith('.mjs') ? `from '${specifier}'` : `from '${specifier}.mjs'`;
+        })
+        .replace(/import\('((?:\.\/|\.\.\/)[^']+)'\)/g, (_match, specifier) => {
+            return specifier.endsWith('.mjs') ? `import('${specifier}')` : `import('${specifier}.mjs')`;
+        });
+}
+
+function writeEsmDeclarations(dir) {
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        const fullPath = join(dir, entry.name);
+
+        if (entry.isDirectory()) {
+            writeEsmDeclarations(fullPath);
+            continue;
+        }
+
+        if (!entry.name.endsWith('.d.ts')) continue;
+
+        const content = readFileSync(fullPath, 'utf8');
+        writeFileSync(fullPath.replace(/\.d\.ts$/, '.d.mts'), toEsmDeclaration(content));
+    }
+}
+
 async function main() {
     rmSync('lib', { recursive: true, force: true });
     rmSync('dist', { recursive: true, force: true });
@@ -57,6 +84,7 @@ async function main() {
     }
 
     cpSync('types', 'dist/types', { recursive: true });
+    writeEsmDeclarations('dist/types');
 }
 
 main().catch((error) => {