monsqlize 2.0.2 → 2.0.4

package/dist/types/monsqlize.d.ts

@@ -8,7 +8,7 @@ export interface SSHConfig {
     /** SSH server hostname or IP. */
     host: string;
     /** SSH server port (default: 22). */
-    scopedCollection<TSchema = unknown>(name: string, options?: { database?: string; pool?: string; }): Collection<TSchema>;
+    port?: number;
     /** SSH login username. */
     username: string;
     /** SSH password (mutually exclusive with privateKey). */
@@ -33,7 +33,7 @@ export interface SSHConfig {
 
 import type { Collection, DbAccessor, HealthView } from './collection';
 import type { Lock, LockOptions, LockStats } from './lock';
-import type { ModelInstance } from './model';
+import type { ModelAutoIndexOptions, ModelEnsureAllIndexesOptions, ModelIndexEnsureSummary, ModelInstance } from './model';
 import type { MongoConnectConfig } from './mongodb';
 import type { ConnectionPoolManagerOptions, PoolConfig, PoolHealthStatus, PoolStats, PoolStrategy } from './pool';
 import type {
@@ -41,6 +41,7 @@ import type {
     CacheLike,
     CacheLockManager,
     DistributedCacheInvalidator,
+    DistributedCacheInvalidatorStats,
     FunctionCache,
     Logger,
     MemoryCache,
@@ -65,7 +66,7 @@ import type {
 import type { SagaDefinition, SagaOrchestrator, SagaResult, SagaStats } from './saga';
 import type { SlowQueryLogConfigInput, SlowQueryLogEntry, SlowQueryLogFilter, SlowQueryLogManager, SlowQueryLogQueryOptions, SlowQueryLogRecord } from './slow-query-log';
 import type { ChangeStreamSyncManager, SyncConfig, SyncStats } from './sync';
-import type { Transaction, TransactionOptions } from './transaction';
+import type { Transaction, TransactionOptions, TransactionStats } from './transaction';
 
 export interface MonSQLizeOptions {
     type?: 'mongodb';
@@ -107,7 +108,7 @@ export interface MonSQLizeOptions {
         /**
          * Distributed cache invalidation via Redis Pub/Sub.
          * When configured, broadcasts `delPattern` events to all other connected instances.
-         * Requires `ioredis` to be installed separately.
+         * `ioredis` is installed with monSQLize; this block only enables and configures Redis usage.
          * @since v2.0.0
          */
         distributed?: {
@@ -131,6 +132,24 @@ export interface MonSQLizeOptions {
     maxPoolsCount?: number;
     sync?: SyncConfig;
     slowQueryLog?: SlowQueryLogConfigInput;
+    /** Global transaction defaults and transaction statistics settings. @since v1.4.0 */
+    transaction?: {
+        enableRetry?: boolean;
+        maxRetries?: number;
+        retryDelay?: number;
+        retryBackoff?: number;
+        /** Default transaction timeout in milliseconds. Alias: `maxDuration`. */
+        defaultTimeout?: number;
+        /** Default transaction timeout in milliseconds. Alias: `defaultTimeout`. */
+        maxDuration?: number;
+        defaultReadConcern?: TransactionOptions['readConcern'];
+        defaultWriteConcern?: TransactionOptions['writeConcern'];
+        defaultReadPreference?: TransactionOptions['readPreference'];
+        lockMaxDuration?: number;
+        lockCleanupInterval?: number;
+        maxStatsSamples?: number;
+        distributedLock?: Record<string, unknown>;
+    };
     /** Global query timeout in milliseconds applied to all find/aggregate operations. Default: 2000. @since v1.3.0 */
     maxTimeMS?: number;
     /** Default limit for find() when caller does not specify one. Default: 10. @since v1.3.0 */
@@ -157,6 +176,8 @@ export interface MonSQLizeOptions {
     countQueue?: boolean | { enabled?: boolean; concurrency?: number; maxQueueSize?: number; timeout?: number; };
     /** Model definitions to auto-register on connect. Accepts a file path (string) or an object with { path, pattern?, recursive? }. @since v1.3.0 */
     models?: string | { path: string; pattern?: string; recursive?: boolean; };
+    /** Global automatic model index creation control. Defaults to true for backward compatibility. */
+    autoIndex?: ModelAutoIndexOptions;
     /** Auto-invalidate cache on write operations. @since v1.3.0 */
     cacheAutoInvalidate?: boolean;
 }
@@ -237,6 +258,11 @@ export interface MonSQLizeInstance {
      */
     model<TDocument = any>(name: string): ModelInstance<TDocument>;
     model(name: string): ModelInstance<any>;
+    /**
+     * Ensures declared indexes for registered models.
+     * Use `dryRun: true` for production preflight; execution only creates missing indexes.
+     */
+    ensureModelIndexes(options?: ModelEnsureAllIndexesOptions): Promise<ModelIndexEnsureSummary>;
     /**
      * Start a MongoDB transaction session.
      * @param options Optional transaction options.
@@ -292,8 +318,12 @@ export interface MonSQLizeInstance {
     executeSaga(name: string, data: unknown): Promise<SagaResult>;
     /** List all registered Saga names. */
     listSagas(): string[];
+    /** Return aggregate transaction statistics; `null` before transaction capability initialization. */
+    getTransactionStats(): TransactionStats | null;
     /** Return Saga execution statistics (success / failure / compensation counts, etc.). */
     getSagaStats(): SagaStats;
+    /** Return distributed cache invalidator statistics; `null` when distributed invalidation is not enabled. */
+    getDistributedCacheInvalidatorStats(): DistributedCacheInvalidatorStats | null;
     /** Start ChangeStream data synchronisation. */
     startSync(): Promise<void>;
     /** Stop ChangeStream data synchronisation. */
@@ -419,6 +449,7 @@ export default class MonSQLize implements MonSQLizeInstance {
     scopedModel(name: string, options?: { database?: string; pool?: string; }): ModelInstance<any>;
     model<TDocument = any>(name: string): ModelInstance<TDocument>;
     model(name: string): ModelInstance<any>;
+    ensureModelIndexes(options?: ModelEnsureAllIndexesOptions): Promise<ModelIndexEnsureSummary>;
     startSession(options?: TransactionOptions): Promise<Transaction>;
     withTransaction<T>(callback: (transaction: Transaction) => Promise<T>, options?: TransactionOptions): Promise<T>;
     withLock<T>(key: string, callback: () => Promise<T>, options?: LockOptions): Promise<T>;
@@ -431,7 +462,9 @@ export default class MonSQLize implements MonSQLizeInstance {
     defineSaga(definition: SagaDefinition): Promise<SagaDefinition>;
     executeSaga(name: string, data: unknown): Promise<SagaResult>;
     listSagas(): string[];
+    getTransactionStats(): TransactionStats | null;
     getSagaStats(): SagaStats;
+    getDistributedCacheInvalidatorStats(): DistributedCacheInvalidatorStats | null;
     startSync(): Promise<void>;
     stopSync(): Promise<void>;
     getSyncStats(): SyncStats | null;

package/dist/types/pool.d.ts

@@ -68,7 +68,7 @@ export declare class ConnectionPoolManager {
     removePool(name: string): Promise<void>;
     getPool(name: string): unknown | null;
     getPoolNames(): string[];
-    selectPool(operation: string, options?: { pool?: string; tags?: string[]; databaseName?: string; }): {
+    selectPool(operation: string, options?: { pool?: string; tags?: string[]; databaseName?: string; poolPreference?: { role?: string; tags?: string[]; }; }): {
         name: string;
         client: unknown;
         db: (name?: string) => unknown;

package/dist/types/runtime.d.ts

@@ -1,6 +1,6 @@
 import type { BookmarkClearResult, BookmarkListResult, BookmarkPrewarmResult, DeleteBatchResult, DeleteResult, IncrementOneResult, IndexCreateResult, InsertBatchResult, InsertManyResult, UpdateBatchResult, UpdateResult } from './collection';
 import type { LoggerLike, ExpressionFunction, ExpressionObject } from './base';
-import type { ModelDefinition, ModelInstance as ModelInstanceContract, RegisteredModel, RelationConfig } from './model';
+import type { ModelDefinition, ModelEnsureIndexesOptions, ModelIndexEnsureResult, ModelInstance as ModelInstanceContract, RegisteredModel, RelationConfig } from './model';
 import type { LockOptions, LockStats } from './lock';
 import type { ConnectionPoolManagerOptions, FallbackStrategy, PoolConfig, PoolHealthStatus, PoolRole, PoolStats, PoolStrategy } from './pool';
 import type { SagaDefinition, SagaOrchestratorOptions, SagaResult, SagaStats, SagaStep } from './saga';
@@ -9,11 +9,16 @@ import type { ResumeTokenConfig, SyncChangeEvent, SyncConfig, SyncStats, SyncTar
 import type { MongoSession, TransactionOptions, TransactionStats } from './transaction';
 import type {
     CacheLike as HubCacheLike,
+    CacheRemainingTtl as HubCacheRemainingTtl,
+    CacheSetOptions as HubCacheSetOptions,
     CacheStats as HubCacheStats,
     LockManager as HubCacheLockLike,
     MemoryCacheOptions as HubMemoryCacheOptions,
 } from 'cache-hub';
-import type { RedisCacheAdapter as HubRedisCacheAdapter } from 'cache-hub/redis';
+import type {
+    RedisCacheAdapter as HubRedisCacheAdapter,
+    RedisCacheAdapterOptions as HubRedisCacheAdapterOptions,
+} from 'cache-hub/redis';
 import type {
     DistributedInvalidatorOptions as HubDistributedInvalidatorOptions,
     InvalidatorStats as HubInvalidatorStats,
@@ -44,6 +49,8 @@ export declare class Logger {
 
 export type CacheLockLike = HubCacheLockLike;
 export type CacheLike = HubCacheLike;
+export type CacheRemainingTtl = HubCacheRemainingTtl;
+export type CacheSetOptions = HubCacheSetOptions;
 export type MemoryCacheOptions = HubMemoryCacheOptions;
 
 /**
@@ -80,15 +87,27 @@ export interface MultiLevelCacheOptions {
     local?: MemoryCacheOptions;
     remote?: CacheLike | (MemoryCacheOptions & { timeoutMs?: number });
     policy?: MultiLevelCachePolicy;
-    publish?: (msg: unknown) => void;
+    publish?: MultiLevelPublish;
 }
 
+export type MultiLevelInvalidationMessage = {
+    type: 'delPattern';
+    pattern: string;
+    ts: number;
+} | {
+    type: 'invalidateTag';
+    tag: string;
+    ts: number;
+};
+
+export type MultiLevelPublish = (msg: MultiLevelInvalidationMessage) => void;
+
 export declare class MemoryCache {
     constructor(options?: MemoryCacheOptions);
     setLockManager(lockManager: CacheLockLike): void;
     getLockManager(): CacheLockLike | null;
     get<T = unknown>(key: string): T | undefined;
-    set(key: string, value: unknown, ttl?: number): void;
+    set(key: string, value: unknown, ttl?: number, options?: CacheSetOptions): void;
     del(key: string): boolean;
     exists(key: string): boolean;
     has(key: string): boolean;
@@ -98,6 +117,8 @@ export declare class MemoryCache {
     clear(): void;
     keys(pattern?: string): string[];
     delPattern(pattern: string): number;
+    getRemainingTtl(key: string): CacheRemainingTtl | undefined;
+    getRemainingTtlMany(keys: string[]): Record<string, CacheRemainingTtl>;
     getStats(): CacheStats;
     resetStats(): void;
     invalidateByTag(tag: string): void;
@@ -111,10 +132,11 @@ export declare class MultiLevelCache {
         writePolicy?: 'both' | 'local-first-async-remote';
         backfillOnRemoteHit?: boolean;
         remoteTimeoutMs?: number;
-        publish?: (msg: { type: string; pattern: string; ts: number }) => void;
+        publish?: MultiLevelPublish;
+        remoteInvalidationErrors?: 'ignore' | 'throw';
     });
     get<T = unknown>(key: string): Promise<T | undefined>;
-    set(key: string, value: unknown, ttl?: number): Promise<void>;
+    set(key: string, value: unknown, ttl?: number, options?: CacheSetOptions): Promise<void>;
     del(key: string): Promise<boolean>;
     exists(key: string): Promise<boolean>;
     has(key: string): Promise<boolean>;
@@ -125,14 +147,14 @@ export declare class MultiLevelCache {
     delPattern(pattern: string): Promise<number>;
     keys(pattern?: string): Promise<string[]>;
     invalidateByTag(tag: string): void | Promise<void>;
-    setPublish(publish: (msg: { type: string; pattern: string; ts: number }) => void): void;
+    setPublish(publish: MultiLevelPublish): void;
     setLockManager(lockManager: CacheLockLike): void;
     getStats(): CacheStats;
     resetStats(): void;
     destroy(): void;
 }
 
-export type RedisCacheAdapterOptions = never;
+export type RedisCacheAdapterOptions = HubRedisCacheAdapterOptions;
 export type RedisLike = object;
 
 /**
@@ -156,11 +178,13 @@ export type RedisCacheAdapter = HubRedisCacheAdapter;
 
 export declare function createRedisCacheAdapter(
     redisUrlOrInstance: string | object | undefined,
+    options?: RedisCacheAdapterOptions,
 ): HubRedisCacheAdapter;
 
 export type { LockOptions, LockStats, MongoSession, TransactionOptions, TransactionStats };
 
 export type DistributedCacheInvalidatorOptions = HubDistributedInvalidatorOptions;
+export type DistributedCacheInvalidatorStats = HubInvalidatorStats;
 
 export declare class DistributedCacheInvalidator {
     constructor(options: DistributedCacheInvalidatorOptions);
@@ -311,6 +335,7 @@ export declare class ModelInstance<TDocument = any> implements ModelInstanceCont
     createIndex(keys: unknown, options?: unknown): Promise<IndexCreateResult>;
     createIndexes(specs: Array<{ key: unknown; } & Record<string, unknown>>): Promise<string[]>;
     listIndexes(): Promise<Record<string, unknown>[]>;
+    ensureIndexes(options?: ModelEnsureIndexesOptions): Promise<ModelIndexEnsureResult>;
     dropIndex(name: string): Promise<unknown>;
     dropIndexes(): Promise<unknown>;
     prewarmBookmarks(keyDims?: unknown, pages?: number[]): Promise<BookmarkPrewarmResult>;

package/dist/types/transaction.d.ts

@@ -46,8 +46,15 @@ export interface TransactionStats {
     totalTransactions: number;
     successfulTransactions: number;
     failedTransactions: number;
+    readOnlyTransactions: number;
+    writeTransactions: number;
     activeTransactions: number;
     averageDuration: number;
+    p95Duration: number;
+    p99Duration: number;
+    successRate: string;
+    readOnlyRatio: string;
+    sampleCount: number;
 }
 
 /**
@@ -80,6 +87,7 @@ export declare class Transaction {
         logger?: LoggerLike | null;
         lockManager?: CacheLockManager | null;
         timeout?: number;
+        transactionOptions?: Record<string, unknown>;
     });
     /** Begin the transaction (starts the MongoDB session transaction). */
     start(): Promise<void>;
@@ -118,6 +126,10 @@ export declare class TransactionManager {
         maxRetries?: number;
         retryDelay?: number;
         retryBackoff?: number;
+        defaultReadConcern?: TransactionOptions['readConcern'];
+        defaultWriteConcern?: TransactionOptions['writeConcern'];
+        defaultReadPreference?: TransactionOptions['readPreference'];
+        maxStatsSamples?: number;
     });
     /** Open a new transaction session. */
     startSession(options?: TransactionOptions): Promise<Transaction>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "monsqlize",
-  "version": "2.0.2",
+  "version": "2.0.4",
   "description": "TypeScript-native MongoDB ODM with multi-level caching (cache-hub), distributed locks, Saga orchestration, unified expression system (122 operators), connection pool management, ChangeStream sync, slow-query logging, and full v1 API compatibility",
   "type": "commonjs",
   "main": "./dist/cjs/index.cjs",
@@ -18,6 +18,8 @@
     "dist/**/*.cjs",
     "dist/**/*.mjs",
     "dist/**/*.d.ts",
+    "changelogs/v2.0.4.md",
+    "changelogs/v2.0.3.md",
     "changelogs/v2.0.2.md",
     "changelogs/v2.0.1.md",
     "changelogs/v2.0.0.md",
@@ -53,6 +55,13 @@
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
+  "config": {
+    "mongodbMemoryServer": {
+      "downloadDir": ".cache/mongodb-memory-server/binaries",
+      "preferGlobalPath": "false",
+      "version": "7.0.14"
+    }
+  },
   "engines": {
     "node": ">=18.0.0"
   },
@@ -61,43 +70,33 @@
     "check:sizes:strict": "node scripts/check-file-sizes.cjs --strict",
     "build": "node scripts/build-p1.cjs",
     "build:tests": "node scripts/compile-tests.cjs",
-    "lint": "eslint . --ignore-pattern .generated/** --ignore-pattern dist/**",
-    "lint:fix": "eslint . --fix --ignore-pattern .generated/** --ignore-pattern dist/**",
+    "lint": "eslint . --ignore-pattern .generated/** --ignore-pattern dist/** --ignore-pattern .devcodex/**",
+    "lint:fix": "eslint . --fix --ignore-pattern .generated/** --ignore-pattern dist/** --ignore-pattern .devcodex/**",
     "test:runtime": "npm run build && npm run build:tests && node --test .generated/test-dist/test/smoke/root-cjs.test.js .generated/test-dist/test/smoke/root-esm.test.js .generated/test-dist/test/smoke/pack-artifacts.test.js",
     "test:compatibility": "npm run build && npm run build:tests && node --test .generated/test-dist/test/compatibility/exports/exports.test.js .generated/test-dist/test/compatibility/matrix.test.js",
     "probe:server-matrix": "node scripts/validation/probe-memory-server-matrix.cjs",
     "test:server-matrix": "node scripts/validation/run-memory-server-matrix.cjs",
     "test:real-env:private": "node scripts/validation/run-private-real-env-checks.cjs",
-    "test:examples": "npm run build && tsc -p tsconfig.examples.json && node .generated/examples-dist/examples/quick-start/basic-connect.js && node .generated/examples-dist/examples/cache/with-cache.js && node .generated/examples-dist/examples/docs/insert.js && node .generated/examples-dist/examples/docs/insert-many.js && node .generated/examples-dist/examples/docs/update.js && node .generated/examples-dist/examples/docs/update-one.js && node .generated/examples-dist/examples/docs/delete.js && node .generated/examples-dist/examples/docs/delete-many.js && node .generated/examples-dist/examples/docs/upsert.js && node .generated/examples-dist/examples/docs/upsert-one.js && node .generated/examples-dist/examples/docs/find.js && node .generated/examples-dist/examples/docs/find-one.js && node .generated/examples-dist/examples/docs/find-one-by-id.js && node .generated/examples-dist/examples/docs/find-by-ids.js && node .generated/examples-dist/examples/docs/find-page.js && node .generated/examples-dist/examples/docs/find-and-count.js && node .generated/examples-dist/examples/docs/count.js && node .generated/examples-dist/examples/docs/distinct.js && node .generated/examples-dist/examples/docs/explain.js && node .generated/examples-dist/examples/docs/aggregate.js && node .generated/examples-dist/examples/docs/chaining-api.js && node .generated/examples-dist/examples/docs/expression-functions.js && node .generated/examples-dist/examples/docs/model.js && node .generated/examples-dist/examples/docs/collection-management.js && node .generated/examples-dist/examples/docs/bookmarks.js && node .generated/examples-dist/examples/docs/transaction.js && node .generated/examples-dist/examples/docs/transaction-rollback.js && node .generated/examples-dist/examples/docs/slow-query-log.js && node .generated/examples-dist/examples/docs/watch.js && node .generated/examples-dist/examples/docs/aggregate-advanced.js && node .generated/examples-dist/examples/docs/batch-operations.js && node .generated/examples-dist/examples/docs/soft-delete.js && node .generated/examples-dist/examples/docs/increment-one.js && node .generated/examples-dist/examples/docs/populate-relations.js && node .generated/examples-dist/examples/docs/saga.js && node .generated/examples-dist/examples/docs/lock.js && node .generated/examples-dist/examples/docs/lock-timeout.js && node .generated/examples-dist/examples/docs/cache-multilevel.js && node .generated/examples-dist/examples/docs/objectid.js && node .generated/examples-dist/examples/docs/pool.js && node .generated/examples-dist/examples/docs/pool-fallback.js && node .generated/examples-dist/examples/docs/sync.js && node .generated/examples-dist/examples/docs/sync-target-failure.js",
+    "test:examples": "npm run build && tsc -p tsconfig.examples.json && node scripts/run-examples.cjs",
     "test:performance": "npm run build && npm run build:tests && node .generated/test-dist/test/performance/baselines/function-cache.benchmark.js",
     "test:unit": "npm run build && npm run build:tests && node --test .generated/test-dist/test/unit/expression/expression.test.js .generated/test-dist/test/unit/expression/operators.test.js .generated/test-dist/test/unit/errors/errors.test.js .generated/test-dist/test/unit/management/management.test.js .generated/test-dist/test/unit/writes/batch.test.js .generated/test-dist/test/unit/cache/cache.test.js .generated/test-dist/test/unit/cache/cache-refactor-guard.test.js .generated/test-dist/test/unit/coverage/core-helpers.test.js .generated/test-dist/test/unit/function-cache/function-cache.test.js .generated/test-dist/test/unit/model/model-registry.test.js .generated/test-dist/test/unit/lock/lock.test.js .generated/test-dist/test/unit/transaction/transaction.test.js .generated/test-dist/test/unit/pool/pool.test.js .generated/test-dist/test/unit/runtime/runtime-compat.test.js .generated/test-dist/test/unit/sync/sync.test.js .generated/test-dist/test/unit/slow-query-log/slow-query-log.test.js .generated/test-dist/test/unit/slow-query-log/slow-query-log-behavior.test.js .generated/test-dist/test/unit/saga/saga.test.js .generated/test-dist/test/unit/count-queue/count-queue.test.js .generated/test-dist/test/unit/model/model-softdelete-versioning.test.js .generated/test-dist/test/unit/function-cache/function-cache-behavior.test.js .generated/test-dist/test/unit/saga/saga-behavior.test.js .generated/test-dist/test/unit/lock/lock-distributed.test.js .generated/test-dist/test/unit/coverage/capability-wiring.test.js .generated/test-dist/test/unit/pool/pool-stats.test.js .generated/test-dist/test/unit/coverage/pure-functions.test.js",
     "test:integration": "npm run build && npm run build:tests && node --test --test-concurrency=1 .generated/test-dist/test/integration/cache/cache.test.js .generated/test-dist/test/integration/cache/cache-behavior.test.js .generated/test-dist/test/integration/mongodb/connect.test.js .generated/test-dist/test/integration/mongodb/queries.test.js .generated/test-dist/test/integration/mongodb/management.test.js .generated/test-dist/test/integration/mongodb/writes-batch.test.js .generated/test-dist/test/integration/mongodb/find.test.js .generated/test-dist/test/integration/mongodb/find-one.test.js .generated/test-dist/test/integration/mongodb/find-page.test.js .generated/test-dist/test/integration/mongodb/aggregate.test.js .generated/test-dist/test/integration/mongodb/chaining.test.js .generated/test-dist/test/integration/mongodb/insert.test.js .generated/test-dist/test/integration/mongodb/update.test.js .generated/test-dist/test/integration/mongodb/delete.test.js .generated/test-dist/test/integration/mongodb/update-pipeline.test.js .generated/test-dist/test/integration/model/model-features.test.js .generated/test-dist/test/integration/transaction/transaction.test.js .generated/test-dist/test/integration/pool/pool.test.js .generated/test-dist/test/integration/pool/pool-behavior.test.js .generated/test-dist/test/integration/watch/watch-native.test.js .generated/test-dist/test/integration/runtime/runtime-core-regression.test.js .generated/test-dist/test/integration/sync/sync.test.js .generated/test-dist/test/integration/slow-query-log/slow-query-log.test.js .generated/test-dist/test/integration/model/model-crud-extended.test.js .generated/test-dist/test/integration/mongodb/management-complete.test.js .generated/test-dist/test/integration/runtime/runtime-methods-extended.test.js .generated/test-dist/test/integration/mongodb/find-page-advanced.test.js",
     "test:refactor-guard": "npm run build && npm run build:tests && node --test --test-concurrency=1 .generated/test-dist/test/compatibility/exports/exports.test.js .generated/test-dist/test/integration/model/model-features.test.js .generated/test-dist/test/integration/runtime/runtime-core-regression.test.js .generated/test-dist/test/integration/sync/sync.test.js",
     "test:refactor-guard:cache": "npm run build && npm run build:tests && node --test .generated/test-dist/test/unit/cache/cache-refactor-guard.test.js",
-    "test:coverage": "npm run build && npm run build:tests && c8 --reporter=text --reporter=lcov --reporter=json-summary --check-coverage --lines 95 --statements 95 --functions 95 --branches 95 node test/run-tests.cjs",
+    "test:coverage": "npm run build && npm run build:tests && c8 --reporter=text --reporter=lcov --reporter=json-summary --include \".generated/test-dist/dist/cjs/**/*.cjs\" --check-coverage --lines 90 --statements 90 --functions 90 --branches 90 node test/run-tests.cjs",
+    "test:audit": "npm audit --omit=dev --registry=https://registry.npmjs.org/",
     "test": "npm run build && npm run build:tests && node test/run-tests.cjs",
     "type-check": "npm run build && tsc -p tsconfig.json --noEmit && tsd --files test/types/root-import.test-d.ts --files test/types/cache-usage.test-d.ts --files test/types/model-usage.test-d.ts --files test/types/pool-usage.test-d.ts --files test/types/sync-usage.test-d.ts --files test/types/slow-query-log-usage.test-d.ts --files test/types/saga-usage.test-d.ts",
     "check:test-language": "node scripts/check-test-language.cjs",
-    "verify:fast": "npm run lint && npm run type-check && npm run check:sizes:strict && npm run test:runtime && npm run test:compatibility && npm run test:refactor-guard && npm run test:refactor-guard:cache",
-    "verify:full": "npm run lint && npm run type-check && npm run check:sizes:strict && npm run test:coverage && npm run test:examples && npm run test:server-matrix",
+    "check:docs-examples": "node scripts/validation/check-doc-example-matrix.cjs",
+    "verify:fast": "npm run lint && npm run check:docs-examples && npm run type-check && npm run check:sizes:strict && npm run test:runtime && npm run test:compatibility && npm run test:refactor-guard && npm run test:refactor-guard:cache",
+    "verify:full": "npm run lint && npm run check:docs-examples && npm run type-check && npm run check:sizes:strict && npm run test:examples && npm run test:server-matrix",
     "verify:release": "npm run verify:full && npm run test:real-env:private",
     "verify": "npm run verify:full",
     "release:preflight": "node scripts/release-preflight.cjs",
     "prepublishOnly": "npm run release:preflight",
     "release:publish": "npm run release:preflight && npm publish --ignore-scripts",
-    "postpublish": "echo '✅ 发布成功！请创建 GitHub Release: https://github.com/vextjs/monSQLize/releases/new?tag=v'$npm_package_version"
-  },
-  "peerDependenciesMeta": {
-    "ioredis": {
-      "optional": true
-    },
-    "ssh2": {
-      "optional": true
-    }
-  },
-  "optionalDependencies": {
-    "ioredis": "5.8.2",
-    "ssh2": "1.17.0"
+    "postpublish": "echo 'Publish succeeded. Create GitHub Release: https://github.com/vextjs/monSQLize/releases/new?tag=v'$npm_package_version"
   },
   "devDependencies": {
     "@eslint/js": "9.39.4",
@@ -114,8 +113,10 @@
   },
   "dependencies": {
     "async-lock": "1.4.1",
-    "cache-hub": "1.0.0",
+    "cache-hub": "2.2.4",
+    "ioredis": "5.8.2",
     "mongodb": "6.21.0",
-    "schema-dsl": "2.0.3"
+    "schema-dsl": "2.0.9",
+    "ssh2": "1.17.0"
   }
 }