# 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.