Skip to content

v2.0.3.md

Latest commit

 

History

History
58 lines (42 loc) · 3.41 KB

v2.0.3.md

File metadata and controls

58 lines (42 loc) · 3.41 KB
Raw

v2.0.3 — 2026-06-11

Overview

v2.0.3 is a compatibility and documentation-quality patch. It keeps the public API backward compatible while restoring documented v1 behaviors, tightening release checks, and making the bilingual documentation site safer to consume as a standalone site.

Runtime Fixes

  • Restored documented findPage({ cache }) page-result caching, cache invalidation, after/before totals, and v1-style totals TTL / hint / collation behavior.
  • Restored public transaction statistics parity through getTransactionStats(), including p95/p99 duration, success rate, read-only ratio, and bounded sample tracking.
  • Wired documented transaction defaults and lock settings into runtime transaction creation.
  • Added getDistributedCacheInvalidatorStats() so distributed cache invalidation statistics are available through a public API instead of private runtime fields.
  • Aligned pool selection with public health status updates and forwarded direct pool tags preferences into automatic pool selection.
  • Restored SSHConfig.port in public declarations and added a type guard against accidental SSHConfig shape drift.

Documentation and Examples

  • Replaced documentation-private runtime fields with public APIs across admin, database operations, explain, model relations, transaction, distributed deployment, sync backup, and pool health docs.
  • Converted source/example file links in the standalone documentation site to GitHub URLs.
  • Strengthened the 97/97 bilingual document example matrix and kept the final 56 runnable examples, 19 shared-example docs, and 22 doc-check docs in sync.
  • Refreshed docs-site navigation, ObjectId/ID query grouping, localized top navigation, home hero, logo presentation, theme parity, and mobile wrapping.
  • Added focused runnable examples for index management, aggregation-pipeline updates, upsert, function cache, model hooks, relations, nested populate, runtime events, CountQueue, pool chain routing, pool health checks, transaction optimization stats, and advanced Saga flows.
  • Normalized source, type, test, example, script, config, and package output text to English-only wording.

Dependencies and Release Gate

  • Fixed the root cache-hub direct dependency at 2.2.4.
  • Updated schema-dsl to the current supported TypeScript line 2.0.8 while continuing to exclude deprecated 2.3.x mistake releases.
  • Kept verify:full as the reproducible full functional gate and left the 90% coverage threshold on the independent test:coverage governance command.
  • Updated server-matrix runners to execute compiled integration tests from .generated/test-dist.
  • Updated release preflight to validate the current bilingual documentation paths and include the production dependency audit gate.

Compatibility

  • SemVer: patch release.
  • Breaking changes: none.
  • Existing v2 public imports remain under dist/cjs, dist/esm, and dist/types.
  • Redis, SSH, Model, multi-pool, Saga, Change Stream, and cache features remain opt-in by configuration where applicable.

Validation

  • npm run check:docs-examples
  • npm run type-check
  • targeted runtime / transaction / findPage regression tests
  • npm run test:unit
  • npm run test:integration
  • npm run test:examples
  • npm run lint
  • 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.