monsqlize 2.0.4 → 2.0.6

package/CHANGELOG.md

@@ -1,7 +1,7 @@
 # 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.6.md](./changelogs/v2.0.6.md); historical details live in the repository changelog archive.
+> **Last updated**: 2026-06-15
 
 ---
 
@@ -9,6 +9,8 @@
 
 | 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) |
 | [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 +449,9 @@ const result = await msq.collection('orders').insertOne(dataFromMongoose);
 changelogs/
 ├── README.md          # 变更文档说明
 ├── TEMPLATE.md        # 变更文档模板
-├── v2.0.4.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 详细变更
 ├── v2.0.1.md         # v2.0.1 详细变更
@@ -502,7 +506,9 @@ changelogs/
 
 ## 相关文档
 
-- [changelogs/v2.0.4.md](./changelogs/v2.0.4.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 详细变更文档
 - [changelogs/v2.0.1.md](./changelogs/v2.0.1.md) - v2.0.1 详细变更文档
@@ -511,5 +517,5 @@ changelogs/
 
 ---
 
-**最后更新**: 2026-06-12
+**最后更新**: 2026-06-15
 

package/README.md

@@ -518,7 +518,7 @@ 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:
 
@@ -526,11 +526,17 @@ Key release-readiness 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.

package/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

package/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`

package/dist/cjs/index.cjs

@@ -320,49 +320,8 @@ try {
   _schemaValidateFn = mod.validate;
 } catch {
 }
-var KNOWN_SCHEMA_BASE_TYPES = /* @__PURE__ */ new Set([
-  "string",
-  "number",
-  "boolean",
-  "integer",
-  "float",
-  "int",
-  "double",
-  "decimal",
-  "date",
-  "objectid",
-  "uuid",
-  "email",
-  "url",
-  "buffer",
-  "binary",
-  "object",
-  "array",
-  "any",
-  "mixed",
-  "null"
-]);
-function _extractBaseType(typeStr) {
-  const m = typeStr.match(/^[a-zA-Z_]+/);
-  return m ? m[0].toLowerCase() : "";
-}
 function _makeValidatingDslFn(realDsl) {
   const validating = function validatingDsl(fields) {
-    if (fields && typeof fields === "object") {
-      for (const [field, spec] of Object.entries(fields)) {
-        if (typeof spec === "string") {
-          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(fields);
   };
   return validating;

package/dist/esm/index.mjs

@@ -303,49 +303,8 @@ try {
   _schemaValidateFn = mod.validate;
 } catch {
 }
-var KNOWN_SCHEMA_BASE_TYPES = /* @__PURE__ */ new Set([
-  "string",
-  "number",
-  "boolean",
-  "integer",
-  "float",
-  "int",
-  "double",
-  "decimal",
-  "date",
-  "objectid",
-  "uuid",
-  "email",
-  "url",
-  "buffer",
-  "binary",
-  "object",
-  "array",
-  "any",
-  "mixed",
-  "null"
-]);
-function _extractBaseType(typeStr) {
-  const m = typeStr.match(/^[a-zA-Z_]+/);
-  return m ? m[0].toLowerCase() : "";
-}
 function _makeValidatingDslFn(realDsl) {
   const validating = function validatingDsl(fields) {
-    if (fields && typeof fields === "object") {
-      for (const [field, spec] of Object.entries(fields)) {
-        if (typeof spec === "string") {
-          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(fields);
   };
   return validating;

package/dist/types/base.d.mts

@@ -0,0 +1,81 @@
+export type DbType = 'mongodb';
+
+export interface ExpressionObject {
+    __expr__: string;
+    __compiled__: boolean;
+}
+
+export type ExpressionFunction = (expression: string) => ExpressionObject;
+
+/** Context in which an expression is evaluated. @since v1.0.0 */
+export type ExpressionContext = '$match' | '$project' | '$group' | 'unknown';
+
+export interface LoggerLike {
+    debug?: (...args: unknown[]) => void;
+    info?: (...args: unknown[]) => void;
+    warn?: (...args: unknown[]) => void;
+    error?: (...args: unknown[]) => void;
+    /** Wrap a function execution with a trace ID. @since v1.3.0 */
+    withTraceId?: (fn: Function, traceId?: string) => any;
+    /** Retrieve the current trace ID. @since v1.3.0 */
+    getTraceId?: () => string | null;
+}
+
+/** Logger configuration options. @since v1.3.0 */
+export interface LoggerOptions {
+    /** Enable structured (JSON) log output. */
+    structured?: boolean;
+    /** Enable automatic trace ID injection into log entries. */
+    enableTraceId?: boolean;
+}
+
+export declare const enum ErrorCodes {
+    INVALID_ARGUMENT = 'INVALID_ARGUMENT',
+    INVALID_COLLECTION_NAME = 'INVALID_COLLECTION_NAME',
+    INVALID_DATABASE_NAME = 'INVALID_DATABASE_NAME',
+    INVALID_EXPRESSION = 'INVALID_EXPRESSION',
+    INVALID_PAGINATION = 'INVALID_PAGINATION',
+    INVALID_OPERATION = 'INVALID_OPERATION',
+    INVALID_CURSOR = 'INVALID_CURSOR',
+    INVALID_CONFIG = 'INVALID_CONFIG',
+    INVALID_MODEL_DEFINITION = 'INVALID_MODEL_DEFINITION',
+    INVALID_SCHEMA_TYPE = 'INVALID_SCHEMA_TYPE',
+    NOT_CONNECTED = 'NOT_CONNECTED',
+    NO_POOL_MANAGER = 'NO_POOL_MANAGER',
+    POOL_NOT_FOUND = 'POOL_NOT_FOUND',
+    MODEL_NOT_DEFINED = 'MODEL_NOT_DEFINED',
+    MODEL_ALREADY_EXISTS = 'MODEL_ALREADY_EXISTS',
+    MISSING_SCHEMA = 'MISSING_SCHEMA',
+    UNSUPPORTED_DATABASE = 'UNSUPPORTED_DATABASE',
+    CONNECTION_FAILED = 'CONNECTION_FAILED',
+    CONNECTION_CLOSED = 'CONNECTION_CLOSED',
+    CONNECTION_TIMEOUT = 'CONNECTION_TIMEOUT',
+    OPERATION_TIMEOUT = 'OPERATION_TIMEOUT',
+    QUERY_TIMEOUT = 'QUERY_TIMEOUT',
+    DATABASE_ERROR = 'DATABASE_ERROR',
+    CACHE_UNAVAILABLE = 'CACHE_UNAVAILABLE',
+    CACHE_ERROR = 'CACHE_ERROR',
+    CACHE_TIMEOUT = 'CACHE_TIMEOUT',
+    MANAGEMENT_OPERATION_FAILED = 'MANAGEMENT_OPERATION_FAILED',
+    VALIDATION_ERROR = 'VALIDATION_ERROR',
+    DOCUMENT_REQUIRED = 'DOCUMENT_REQUIRED',
+    DOCUMENTS_REQUIRED = 'DOCUMENTS_REQUIRED',
+    DUPLICATE_KEY = 'DUPLICATE_KEY',
+    WRITE_ERROR = 'WRITE_ERROR',
+    WRITE_CONFLICT = 'WRITE_CONFLICT',
+    CURSOR_SORT_MISMATCH = 'CURSOR_SORT_MISMATCH',
+    JUMP_TOO_FAR = 'JUMP_TOO_FAR',
+    STREAM_NO_JUMP = 'STREAM_NO_JUMP',
+    STREAM_NO_TOTALS = 'STREAM_NO_TOTALS',
+    STREAM_NO_EXPLAIN = 'STREAM_NO_EXPLAIN',
+    MONGODB_ERROR = 'MONGODB_ERROR',
+    LOCK_ACQUIRE_FAILED = 'LOCK_ACQUIRE_FAILED',
+    LOCK_TIMEOUT = 'LOCK_TIMEOUT',
+}
+
+export interface MonSQLizeError extends Error {
+    code: string;
+    details?: unknown[];
+    cause?: Error;
+}
+