Skip to content

v2.0.4.md

Latest commit

 

History

History
61 lines (45 loc) · 2.74 KB

v2.0.4.md

File metadata and controls

61 lines (45 loc) · 2.74 KB
Raw

v2.0.4 — 2026-06-12

Overview

v2.0.4 is a production-safety and documentation-quality patch. It keeps the public API backward compatible while adding explicit Model index rollout controls, updating the schema validation dependency, and refining user-facing documentation language.

Runtime Fixes

  • Added production-safe Model index controls:
    • runtime-level and model-level autoIndex options.
    • explicit ModelInstance.ensureIndexes() and MonSQLize.ensureModelIndexes() APIs.
    • dry-run index preflight with existing, missing, conflicts, and failed classification.
    • missing-index creation without dropping, renaming, or rebuilding conflicting indexes.
    • model-index-error events for observable automatic-index creation failures.
  • Kept automatic Model indexing enabled by default for backward compatibility.
  • Moved runtime Model index aggregation into the Model runtime helper layer so the strict source-size gate remains clean.

Dependencies

  • Updated schema-dsl from 2.0.8 to npm latest 2.0.9.
  • Confirmed schema-dsl@2.0.9 keeps the required dsl() and validate() runtime paths compatible with monSQLize.
  • Confirmed the schema-dsl transitive cache-hub dependency now resolves to 2.2.4, matching the root direct dependency.

Documentation

  • Documented the recommended production index rollout flow:
    • set autoIndex: false in production services.
    • run ensureIndexes({ dryRun: true }) / ensureModelIndexes({ dryRun: true }).
    • create only missing indexes during a low-traffic maintenance window.
    • monitor TTL and index-build behavior.
  • Corrected create-index documentation to distinguish local INVALID_ARGUMENT validation from raw MongoDB driver/server index conflicts.
  • Reworded capability-index and verification-entry documentation to use user-facing availability and verification language instead of internal migration status terms.
  • Refined the documentation home experience with the VextJS-style footer, aligned hero/feature layout, and updated hero data-flow visual.

Compatibility

  • SemVer: patch release.
  • Breaking changes: none.
  • Existing v2 imports remain under dist/cjs, dist/esm, and dist/types.
  • Existing default automatic Model indexing behavior remains enabled unless users opt into the new production-safe controls.

Validation

  • npm run lint
  • npm run check:docs-examples
  • npm run type-check
  • targeted Model/index unit and integration tests
  • npm run test:examples
  • npm --prefix website run build
  • npm run verify:fast
  • npm run test:server-matrix
  • npm run test:audit
  • git diff --check

Full release validation is handled by npm run release:preflight, npm pack --dry-run, npm publish --dry-run, and pack install smoke before publishing.