feat: release monsqlize 2.0.5

Author: rockyshi1993

CHANGELOG.md

@@ -1,14 +1,15 @@
 # CHANGELOG
 
-> Summary index — current release details are packaged in [changelogs/v2.0.4.md](./changelogs/v2.0.4.md); historical details live in the repository changelog archive.
-> **Last updated**: 2026-06-12
+> 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
 
 ---
 
 ## Version Overview
 
 | Version | Date | Summary | Details |
 |---------|------|---------|---------|
+| [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) |
 | [v2.0.2](./changelogs/v2.0.2.md) | 2026-06-09 | Patch: direct runtime, optional and development dependencies pinned to exact versions for deterministic consumer installs | [View](./changelogs/v2.0.2.md) |
@@ -447,7 +448,8 @@ const result = await msq.collection('orders').insertOne(dataFromMongoose);
 changelogs/
 ├── README.md          # 变更文档说明
 ├── TEMPLATE.md        # 变更文档模板
-├── v2.0.4.md         # 当前发布详细变更
+├── v2.0.5.md         # 当前发布详细变更
+├── v2.0.4.md         # v2.0.4 详细变更
 ├── v2.0.3.md         # v2.0.3 详细变更
 ├── v2.0.2.md         # v2.0.2 详细变更
 ├── v2.0.1.md         # v2.0.1 详细变更
@@ -502,7 +504,8 @@ changelogs/
 
 ## 相关文档
 
-- [changelogs/v2.0.4.md](./changelogs/v2.0.4.md) - 当前发布详细变更文档
+- [changelogs/v2.0.5.md](./changelogs/v2.0.5.md) - 当前发布详细变更文档
+- [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 详细变更文档
 - [changelogs/v2.0.1.md](./changelogs/v2.0.1.md) - v2.0.1 详细变更文档
@@ -511,5 +514,5 @@ changelogs/
 
 ---
 
-**最后更新**: 2026-06-12
+**最后更新**: 2026-06-13
 

changelogs/unreleased.md

@@ -1,13 +1,3 @@
 # Unreleased
 
-## Fixed
-
-- No unreleased fixes yet.
-
-## Changed
-
-- No unreleased changes yet.
-
-## Documentation
-
 - No unreleased documentation changes yet.

changelogs/v2.0.5.md

@@ -0,0 +1,33 @@
+# v2.0.5 — 2026-06-13
+
+## Overview
+
+v2.0.5 is a compatibility patch for Model schema validation. It removes the duplicated schema-dsl base-type allowlist from monSQLize and delegates DSL type decisions to schema-dsl, keeping schema-dsl as the single validation DSL authority.
+
+---
+
+## Runtime Fixes
+
+- Removed the monSQLize-side schema-dsl base-type allowlist from the Model schema adapter.
+- Delegated schema compilation and unknown-type handling to schema-dsl diagnostics instead of maintaining a second type table.
+- Preserved compatibility for schema-dsl-owned aliases such as `int`, `mixed`, `buffer` and `objectid`.
+- Preserved existing literal business DSL strings such as `datetime` and `admin_login!` through schema-dsl fallback semantics.
+
+## Dependencies
+
+- Targets `schema-dsl@2.0.10`, which contains the shared legacy DSL aliases and structured diagnostics used by this patch.
+- Keeps the root `cache-hub@2.2.4` dependency unchanged.
+
+## Compatibility
+
+- SemVer: patch release.
+- Breaking changes: none.
+- Existing v2 Model schema declarations continue to validate through the same public Model API.
+- Consumer projects do not need to change source code for the checked schema alias and business-literal paths.
+
+## Validation
+
+- `npm run type-check`
+- targeted Model schema validation tests
+- targeted pure-function and branch coverage tests
+- local schema-dsl@2.0.10 compatibility smoke

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.9` declares the same transitive dependency version |
-| `schema-dsl` | Exact version `2.0.9` | npm `latest` points to 2.0.9, and this version is the current official TypeScript line; monSQLize only relies on `dsl` / `validate` capabilities, and uses 2.0.9 for type-check, model test, integration, and examples 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.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 |
 
-> `schema-dsl@2.0.9` is the current npm `latest`; 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.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.
 
 ## 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.9` also declares `cache-hub@2.2.4`, so no additional override is needed.
-- `schema-dsl` is fixed to `2.0.9`.
+- 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`.
 - 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.9`. 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.10`. The verification standard is as follows:
 
-1. The upstream released the **non-deprecated** 2.x latest version on npm: `2.0.9`.
-2. `npm install schema-dsl@2.0.9 --save-exact` followed by `npm run type-check`.
+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`.
 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.9`.
+6. This file, Profile, CHANGELOG, and lockfile must be synchronized to `2.0.10`.
 
 ## 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.9` also declares `cache-hub@2.2.4`.
+2. The root direct dependency resolves to `2.2.4`; `schema-dsl@2.0.10` 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.4 TypeScript release
+  badge: v2.0.5 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.9` 声明的传递依赖同为 2.2.4 |
-| `schema-dsl` | 精确版本 `2.0.9` | npm `latest` 指向 2.0.9，且该版本是当前 TypeScript 正式线；monSQLize 仅依赖 `dsl` / `validate` 能力，并以 2.0.9 执行 type-check、model 测试、integration 与 examples 验证 |
+| `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 验证 |
 
-> `schema-dsl@2.0.9` 是当前 npm `latest`；npm 上历史 `2.3.x` 已标记为误发布 / deprecated，不得跟随升级。
+> `schema-dsl@2.0.10` 是本次发布链路的预期 latest；npm 上历史 `2.3.x` 已标记为误发布 / deprecated，不得跟随升级。
 
 ## 当前风险
 
@@ -19,8 +19,8 @@
 
 ### 开发态
 
-- 根包 direct `cache-hub` 固定为 `2.2.4`；`schema-dsl@2.0.9` 声明的 `cache-hub` 版本同为 `2.2.4`，不需要额外 override。
-- `schema-dsl` 固定为 `2.0.9`。
+- 根包 direct `cache-hub` 固定为 `2.2.4`；`schema-dsl@2.0.10` 声明的 `cache-hub` 版本同为 `2.2.4`，不需要额外 override。
+- `schema-dsl` 固定为 `2.0.10`。
 - 本地 sibling `../schema-dsl` 仅用于上游库自身调试，不再作为 monSQLize 根包安装前提。
 
 ### 发布态
@@ -34,21 +34,21 @@ npm run release:preflight
 
 ## schema-dsl 2.x 升级验证
 
-依赖治理基线已将 `schema-dsl` 从历史 `^1.2.5` 升级并固定到 `2.0.9`，验证标准如下：
+依赖治理基线已将 `schema-dsl` 从历史 `^1.2.5` 升级并固定到 `2.0.10`，验证标准如下：
 
-1. 上游在 npm 发布了**非 deprecated** 的 2.x latest 版本：`2.0.9`。
-2. `npm install schema-dsl@2.0.9 --save-exact` 后通过 `npm run type-check`。
+1. 上游在 npm 发布了**非 deprecated** 的 2.x latest 版本：`2.0.10`。
+2. `npm install schema-dsl@2.0.10 --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.9`。
+6. 本文件、Profile、CHANGELOG 与 lockfile 必须同步到 `2.0.10`。
 
 ## 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.9` 也声明 `cache-hub@2.2.4`。
+2. 根包 direct dependency 解析到 `2.2.4`；`schema-dsl@2.0.10` 也声明 `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.4 TypeScript 正式版
+  badge: v2.0.5 TypeScript 正式版
   name: monSQLize
   text: TypeScript MongoDB 增强引擎
   tagline: 保留 MongoDB 原生体验，整合 cache-hub 两级缓存、多连接池路由、Saga 编排与可选 Model 层。

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "monsqlize",
-  "version": "2.0.4",
+  "version": "2.0.5",
   "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",
@@ -18,6 +18,7 @@
     "dist/**/*.cjs",
     "dist/**/*.mjs",
     "dist/**/*.d.ts",
+    "changelogs/v2.0.5.md",
     "changelogs/v2.0.4.md",
     "changelogs/v2.0.3.md",
     "changelogs/v2.0.2.md",
@@ -116,7 +117,7 @@
     "cache-hub": "2.2.4",
     "ioredis": "5.8.2",
     "mongodb": "6.21.0",
-    "schema-dsl": "2.0.9",
+    "schema-dsl": "2.0.10",
     "ssh2": "1.17.0"
   }
 }

package.json

@@ -9,6 +9,8 @@
  * - This file attempts require('schema-dsl') at module load time; if successful, dsl and validate are enabled;
  *   otherwise it silently degrades.
  * - Exposes two variables (_schemaDslFn / _schemaValidateFn) and one wrapper factory (_makeValidatingDslFn).
+ * - _makeValidatingDslFn intentionally delegates DSL semantics to schema-dsl instead of maintaining
+ *   a shadow type allowlist in monsqlize.
  */
 
 // ── schema-dsl type declarations ────────────────────────────────────────────
@@ -32,55 +34,16 @@ try {
     // schema-dsl not available – schema validation will be skipped
 }
 
-// ── Known valid base types (consistent with v1) ──────────────────────────────
-const KNOWN_SCHEMA_BASE_TYPES = new Set([
-    'string', 'number', 'boolean', 'integer', 'float', 'int', 'double', 'decimal',
-    'date', 'objectid', 'uuid', 'email', 'url', 'buffer', 'binary',
-    'object', 'array', 'any', 'mixed', 'null',
-]);
-
 /**
- * Extract the base type name from a schema-dsl type string (strips modifiers like ! ? [] :range).
- *
- * Examples:
- *   "string!"    → "string"
- *   "objectid!"  → "objectid"
- *   "invalid!"   → "invalid"
- */
-function _extractBaseType(typeStr: string): string {
-    const m = typeStr.match(/^[a-zA-Z_]+/);
-    return m ? m[0].toLowerCase() : '';
-}
-
-/**
- * Wrap the schema-dsl dsl() function to eagerly validate field type strings during Model.define().
+ * Wrap the schema-dsl dsl() function while keeping schema-dsl as the single DSL authority.
  *
  * Behavior:
- * - If a field type string contains an unknown base type, a TypeError is thrown immediately
- *   (rather than silently failing at validation time).
- * - Enum DSL strings (e.g. "admin|user") are skipped — pipe-separated values are literal unions, not base types.
- *
- * This enables fast-fail at Model.define() time instead of silent degradation at runtime.
+ * - monsqlize no longer keeps a duplicate schema-dsl type allowlist.
+ * - Unknown types, custom types, aliases, and fallback behavior are delegated to schema-dsl.
+ * - A future schema-dsl diagnostics API can be consumed here without parsing DSL strings in monsqlize.
  */
 export function _makeValidatingDslFn(realDsl: SchemaDslFn): SchemaDslFn {
     const validating = function validatingDsl(fields: unknown): unknown {
-        if (fields && typeof fields === 'object') {
-            for (const [field, spec] of Object.entries(fields as Record<string, unknown>)) {
-                if (typeof spec === 'string') {
-                    // v1 compat: enum DSL like "admin|user" is a literal-union, not a base type.
-                    if (spec.includes('|')) {
-                        continue;
-                    }
-                    const base = _extractBaseType(spec);
-                    if (base && !KNOWN_SCHEMA_BASE_TYPES.has(base)) {
-                        throw new TypeError(
-                            `[schema] Invalid type "${base}" in field "${field}". ` +
-                            `Known types: ${[...KNOWN_SCHEMA_BASE_TYPES].join(', ')}.`
-                        );
-                    }
-                }
-            }
-        }
         return (realDsl as unknown as (f: unknown) => unknown)(fields);
     };
     return validating as unknown as SchemaDslFn;