monsqlize 2.0.5 → 2.0.6

package/CHANGELOG.md

@@ -1,7 +1,7 @@
 # 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
 
 ---
 
@@ -9,6 +9,7 @@
 
 | 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
 

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.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/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;
+}
+