monsqlize 1.3.1 → 2.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (114) hide show
  1. package/CHANGELOG.md +506 -235
  2. package/LICENSE +201 -21
  3. package/README.md +542 -928
  4. package/changelogs/README.md +163 -0
  5. package/changelogs/v2.0.0.md +222 -0
  6. package/changelogs/v2.0.1.md +39 -0
  7. package/dist/cjs/index.cjs +10788 -0
  8. package/dist/cjs/mongodb/common/transaction-aware.cjs +10 -0
  9. package/dist/cjs/transaction/CacheLockManager.cjs +100 -0
  10. package/dist/cjs/transaction/Transaction.cjs +158 -0
  11. package/dist/cjs/transaction/TransactionManager.cjs +298 -0
  12. package/dist/esm/index.mjs +10838 -0
  13. package/dist/types/base.d.ts +81 -0
  14. package/dist/types/collection.d.ts +1031 -0
  15. package/dist/types/expression.d.ts +115 -0
  16. package/dist/types/index.d.ts +23 -0
  17. package/dist/types/lock.d.ts +74 -0
  18. package/dist/types/model.d.ts +530 -0
  19. package/dist/types/mongodb.d.ts +49 -0
  20. package/dist/types/monsqlize.d.ts +491 -0
  21. package/dist/types/pool.d.ts +84 -0
  22. package/dist/types/runtime.d.ts +362 -0
  23. package/dist/types/saga.d.ts +143 -0
  24. package/dist/types/slow-query-log.d.ts +126 -0
  25. package/dist/types/sync.d.ts +103 -0
  26. package/dist/types/transaction.d.ts +132 -0
  27. package/package.json +120 -117
  28. package/index.d.ts +0 -1289
  29. package/lib/cache.js +0 -491
  30. package/lib/common/cursor.js +0 -58
  31. package/lib/common/docs-urls.js +0 -72
  32. package/lib/common/index-options.js +0 -222
  33. package/lib/common/log.js +0 -60
  34. package/lib/common/namespace.js +0 -21
  35. package/lib/common/normalize.js +0 -33
  36. package/lib/common/page-result.js +0 -42
  37. package/lib/common/runner.js +0 -56
  38. package/lib/common/server-features.js +0 -231
  39. package/lib/common/shape-builders.js +0 -26
  40. package/lib/common/validation.js +0 -112
  41. package/lib/connect.js +0 -76
  42. package/lib/constants.js +0 -54
  43. package/lib/count-queue.js +0 -187
  44. package/lib/distributed-cache-invalidator.js +0 -259
  45. package/lib/errors.js +0 -167
  46. package/lib/index.js +0 -461
  47. package/lib/infrastructure/ssh-tunnel-ssh2.js +0 -211
  48. package/lib/infrastructure/ssh-tunnel.js +0 -40
  49. package/lib/infrastructure/uri-parser.js +0 -35
  50. package/lib/lock/Lock.js +0 -66
  51. package/lib/lock/errors.js +0 -27
  52. package/lib/lock/index.js +0 -12
  53. package/lib/logger.js +0 -224
  54. package/lib/model/examples/test.js +0 -114
  55. package/lib/mongodb/common/accessor-helpers.js +0 -58
  56. package/lib/mongodb/common/agg-pipeline.js +0 -32
  57. package/lib/mongodb/common/iid.js +0 -27
  58. package/lib/mongodb/common/lexicographic-expr.js +0 -52
  59. package/lib/mongodb/common/shape.js +0 -31
  60. package/lib/mongodb/common/sort.js +0 -38
  61. package/lib/mongodb/common/transaction-aware.js +0 -24
  62. package/lib/mongodb/connect.js +0 -233
  63. package/lib/mongodb/index.js +0 -591
  64. package/lib/mongodb/management/admin-ops.js +0 -199
  65. package/lib/mongodb/management/bookmark-ops.js +0 -166
  66. package/lib/mongodb/management/cache-ops.js +0 -49
  67. package/lib/mongodb/management/collection-ops.js +0 -386
  68. package/lib/mongodb/management/database-ops.js +0 -201
  69. package/lib/mongodb/management/index-ops.js +0 -474
  70. package/lib/mongodb/management/index.js +0 -16
  71. package/lib/mongodb/management/namespace.js +0 -30
  72. package/lib/mongodb/management/validation-ops.js +0 -267
  73. package/lib/mongodb/queries/aggregate.js +0 -142
  74. package/lib/mongodb/queries/chain.js +0 -630
  75. package/lib/mongodb/queries/count.js +0 -98
  76. package/lib/mongodb/queries/distinct.js +0 -77
  77. package/lib/mongodb/queries/find-and-count.js +0 -192
  78. package/lib/mongodb/queries/find-by-ids.js +0 -235
  79. package/lib/mongodb/queries/find-one-by-id.js +0 -170
  80. package/lib/mongodb/queries/find-one.js +0 -70
  81. package/lib/mongodb/queries/find-page.js +0 -577
  82. package/lib/mongodb/queries/find.js +0 -170
  83. package/lib/mongodb/queries/index.js +0 -50
  84. package/lib/mongodb/queries/watch.js +0 -537
  85. package/lib/mongodb/writes/delete-many.js +0 -190
  86. package/lib/mongodb/writes/delete-one.js +0 -182
  87. package/lib/mongodb/writes/find-one-and-delete.js +0 -202
  88. package/lib/mongodb/writes/find-one-and-replace.js +0 -238
  89. package/lib/mongodb/writes/find-one-and-update.js +0 -239
  90. package/lib/mongodb/writes/increment-one.js +0 -252
  91. package/lib/mongodb/writes/index.js +0 -41
  92. package/lib/mongodb/writes/insert-batch.js +0 -507
  93. package/lib/mongodb/writes/insert-many.js +0 -227
  94. package/lib/mongodb/writes/insert-one.js +0 -180
  95. package/lib/mongodb/writes/replace-one.js +0 -215
  96. package/lib/mongodb/writes/result-handler.js +0 -236
  97. package/lib/mongodb/writes/update-many.js +0 -221
  98. package/lib/mongodb/writes/update-one.js +0 -223
  99. package/lib/mongodb/writes/upsert-one.js +0 -206
  100. package/lib/multi-level-cache.js +0 -189
  101. package/lib/operators.js +0 -330
  102. package/lib/redis-cache-adapter.js +0 -237
  103. package/lib/slow-query-log/base-storage.js +0 -69
  104. package/lib/slow-query-log/batch-queue.js +0 -96
  105. package/lib/slow-query-log/config-manager.js +0 -195
  106. package/lib/slow-query-log/index.js +0 -237
  107. package/lib/slow-query-log/mongodb-storage.js +0 -323
  108. package/lib/slow-query-log/query-hash.js +0 -38
  109. package/lib/transaction/CacheLockManager.js +0 -161
  110. package/lib/transaction/DistributedCacheLockManager.js +0 -474
  111. package/lib/transaction/Transaction.js +0 -314
  112. package/lib/transaction/TransactionManager.js +0 -266
  113. package/lib/transaction/index.js +0 -10
  114. package/lib/utils/objectid-converter.js +0 -566
@@ -0,0 +1,103 @@
1
+ import type { ChangeStreamDocument, Document, MongoClientOptions } from 'mongodb';
2
+
3
+ import type { LoggerLike } from './base';
4
+
5
+ export type SyncChangeEvent<TDocument extends Document = Document> = ChangeStreamDocument<TDocument> & {
6
+ _id?: unknown;
7
+ operationType: 'insert' | 'update' | 'replace' | 'delete';
8
+ ns: {
9
+ db: string;
10
+ coll: string;
11
+ };
12
+ documentKey?: Record<string, unknown>;
13
+ fullDocument?: TDocument;
14
+ };
15
+
16
+ export interface SyncTargetHealthCheckConfig {
17
+ /** Whether to enable health checks; defaults to true. */
18
+ enabled?: boolean;
19
+ /** Health check interval in milliseconds; defaults to 30000. */
20
+ interval?: number;
21
+ /** Timeout for a single health check in milliseconds; defaults to 5000. */
22
+ timeout?: number;
23
+ /** Number of retries after failure; defaults to 3. */
24
+ retries?: number;
25
+ }
26
+
27
+ export interface SyncTargetConfig {
28
+ name: string;
29
+ uri?: string;
30
+ pool?: string;
31
+ databaseName?: string;
32
+ collections?: string[];
33
+ options?: MongoClientOptions;
34
+ apply?: (event: SyncChangeEvent, document: Record<string, unknown> | undefined) => Promise<void>;
35
+ /** Target node health check configuration. @since v1.0.8 */
36
+ healthCheck?: SyncTargetHealthCheckConfig;
37
+ }
38
+
39
+ export interface ResumeTokenRedisLike {
40
+ get(key: string): Promise<string | null> | string | null;
41
+ set(key: string, value: string): Promise<unknown> | unknown;
42
+ del?(key: string): Promise<unknown> | unknown;
43
+ }
44
+
45
+ export interface ResumeTokenConfig {
46
+ storage?: 'file' | 'redis';
47
+ path?: string;
48
+ redis?: ResumeTokenRedisLike;
49
+ key?: string;
50
+ }
51
+
52
+ export interface SyncConfig {
53
+ enabled: boolean;
54
+ targets: SyncTargetConfig[];
55
+ collections?: string[];
56
+ resumeToken?: ResumeTokenConfig;
57
+ filter?: (event: SyncChangeEvent) => boolean;
58
+ /**
59
+ * Transform a change-stream document before forwarding to sync targets.
60
+ * v1 form took a single argument (`doc => ...`); v2 added a second `event` argument.
61
+ * Signature is permissive (`any`) to accept both forms — v1 was never typed.
62
+ */
63
+ transform?: (document: any, event?: SyncChangeEvent) => any;
64
+ }
65
+
66
+ export interface SyncStats {
67
+ isRunning: boolean;
68
+ eventCount: number;
69
+ syncedCount: number;
70
+ errorCount: number;
71
+ startTime: Date | null;
72
+ lastEventTime: Date | null;
73
+ targets: Array<{
74
+ name: string;
75
+ syncCount: number;
76
+ errorCount: number;
77
+ lastSyncTime: Date | null;
78
+ lastError: Error | null;
79
+ successRate: string;
80
+ }>;
81
+ }
82
+
83
+ export declare function validateSyncConfig(config: SyncConfig): void;
84
+
85
+ export declare class ResumeTokenStore {
86
+ constructor(options?: ResumeTokenConfig & { logger?: LoggerLike | null; });
87
+ load(): Promise<unknown | null>;
88
+ save(token: unknown): Promise<void>;
89
+ clear(): Promise<void>;
90
+ }
91
+
92
+ export declare class ChangeStreamSyncManager {
93
+ constructor(options: {
94
+ db: unknown;
95
+ poolManager?: unknown;
96
+ config: SyncConfig;
97
+ logger?: LoggerLike | null;
98
+ });
99
+ start(): Promise<void>;
100
+ stop(): Promise<void>;
101
+ getStats(): SyncStats;
102
+ }
103
+
@@ -0,0 +1,132 @@
1
+ import type { CacheLike } from './runtime';
2
+ import type { LoggerLike } from './base';
3
+
4
+ /** Minimal MongoDB session contract used by the transaction layer. */
5
+ export interface MongoSession {
6
+ id: unknown;
7
+ inTransaction(): boolean;
8
+ startTransaction(options?: Record<string, unknown>): void;
9
+ commitTransaction(): Promise<void>;
10
+ abortTransaction(): Promise<void>;
11
+ endSession(): Promise<void>;
12
+ /** v1 compat — v1 callers read `session.transaction?.state`; populated by the underlying driver. */
13
+ transaction?: { state?: string;[key: string]: unknown };
14
+ }
15
+
16
+ /** Options forwarded to the MongoDB driver when starting a transaction session. */
17
+ export interface TransactionOptions {
18
+ readConcern?: {
19
+ level: 'local' | 'majority' | 'snapshot' | 'linearizable' | 'available';
20
+ };
21
+ readPreference?: 'primary' | 'primaryPreferred' | 'secondary' | 'secondaryPreferred' | 'nearest';
22
+ causalConsistency?: boolean;
23
+ /** Maximum transaction duration in milliseconds before an automatic abort. */
24
+ maxDuration?: number;
25
+ /** @alias maxDuration — v1 compat field */
26
+ timeout?: number;
27
+ enableRetry?: boolean;
28
+ maxRetries?: number;
29
+ retryDelay?: number;
30
+ retryBackoff?: number;
31
+ enableCacheLock?: boolean;
32
+ lockCleanupInterval?: number;
33
+ writeConcern?: Record<string, unknown>;
34
+ }
35
+
36
+ /** Snapshot of a transaction's current state. */
37
+ export interface TransactionInfo {
38
+ id: string;
39
+ status: 'pending' | 'started' | 'committed' | 'aborted';
40
+ duration: number;
41
+ sessionId: string;
42
+ }
43
+
44
+ /** Aggregate statistics for all transactions managed by a `TransactionManager`. */
45
+ export interface TransactionStats {
46
+ totalTransactions: number;
47
+ successfulTransactions: number;
48
+ failedTransactions: number;
49
+ activeTransactions: number;
50
+ averageDuration: number;
51
+ }
52
+
53
+ /**
54
+ * In-memory lock tracker used to serialise cache invalidation across transaction boundaries.
55
+ * Attached to `TransactionManager`; locks are auto-released when a transaction commits or aborts.
56
+ */
57
+ export declare class CacheLockManager {
58
+ constructor(options?: { logger?: LoggerLike | null; maxDuration?: number; cleanupInterval?: number; });
59
+ /** Register a lock for `key` owned by `owner`. */
60
+ addLock(key: string, owner: { id?: unknown; } | string): void;
61
+ /** Return `true` if `key` is currently locked. */
62
+ isLocked(key: string): boolean;
63
+ /** Release all locks held by `owner`. */
64
+ releaseLocks(owner: { id?: unknown; } | string): void;
65
+ /** Return lock usage statistics. */
66
+ getStats(): { totalLocks: number; activeLocks: number; maxDuration: number; };
67
+ /** Release all locks immediately. */
68
+ clear(): void;
69
+ /** Stop the background cleanup timer. */
70
+ stop(): void;
71
+ }
72
+
73
+ /** Represents a single MongoDB transaction session with optional cache-lock integration. */
74
+ export declare class Transaction {
75
+ readonly id: string;
76
+ readonly session: MongoSession;
77
+ readonly state: 'pending' | 'active' | 'committed' | 'aborted';
78
+ constructor(session: MongoSession, options?: {
79
+ cache?: CacheLike | null;
80
+ logger?: LoggerLike | null;
81
+ lockManager?: CacheLockManager | null;
82
+ timeout?: number;
83
+ });
84
+ /** Begin the transaction (starts the MongoDB session transaction). */
85
+ start(): Promise<void>;
86
+ /** Commit the transaction; replays recorded cache invalidations on success. */
87
+ commit(): Promise<void>;
88
+ /** Abort the transaction and discard pending cache invalidations. */
89
+ abort(): Promise<void>;
90
+ /** Alias for `commit()` — v1 compat shorthand. */
91
+ end(): Promise<void>;
92
+ /** Record a cache-invalidation pattern to be replayed on commit. */
93
+ recordInvalidation(pattern: string): Promise<void>;
94
+ /** Return the elapsed duration in milliseconds since the transaction started. */
95
+ getDuration(): number;
96
+ /** Return a snapshot of the transaction's current state and metadata. */
97
+ getInfo(): TransactionInfo;
98
+ /** Return v1-compatible per-transaction statistics. */
99
+ getStats(): {
100
+ id: string;
101
+ state: 'pending' | 'active' | 'committed' | 'aborted';
102
+ duration: number;
103
+ hasWriteOperation: boolean;
104
+ operationCount: number;
105
+ lockedKeysCount: number;
106
+ };
107
+ }
108
+
109
+ /** Manages the lifecycle of MongoDB transactions, including retry and session pooling. */
110
+ export declare class TransactionManager {
111
+ constructor(options: {
112
+ client: unknown;
113
+ cache?: CacheLike | null;
114
+ logger?: LoggerLike | null;
115
+ lockManager?: CacheLockManager | null;
116
+ maxDuration?: number;
117
+ enableRetry?: boolean;
118
+ maxRetries?: number;
119
+ retryDelay?: number;
120
+ retryBackoff?: number;
121
+ });
122
+ /** Open a new transaction session. */
123
+ startSession(options?: TransactionOptions): Promise<Transaction>;
124
+ /** Execute `callback` inside a transaction; commits on success, aborts on failure. */
125
+ withTransaction<T>(callback: (transaction: Transaction) => Promise<T>, options?: TransactionOptions): Promise<T>;
126
+ /** Return all currently active (uncommitted) transactions. */
127
+ getActiveTransactions(): Transaction[];
128
+ /** Abort all active transactions immediately. */
129
+ abortAll(): Promise<void>;
130
+ /** Return aggregate transaction statistics. */
131
+ getStats(): TransactionStats;
132
+ }
package/package.json CHANGED
@@ -1,117 +1,120 @@
1
- {
2
- "name": "monsqlize",
3
- "version": "1.3.1",
4
- "description": "A lightweight MongoDB ORM with multi-level caching, transaction support, and distributed features",
5
- "main": "lib/index.js",
6
- "module": "index.mjs",
7
- "type": "commonjs",
8
- "exports": {
9
- ".": {
10
- "require": "./lib/index.js",
11
- "import": "./index.mjs",
12
- "types": "./index.d.ts"
13
- },
14
- "./package.json": "./package.json"
15
- },
16
- "types": "./index.d.ts",
17
- "files": [
18
- "lib/",
19
- "index.d.ts",
20
- "README.md",
21
- "LICENSE",
22
- "CHANGELOG.md"
23
- ],
24
- "keywords": [
25
- "mongodb",
26
- "database",
27
- "orm",
28
- "cache",
29
- "transaction",
30
- "distributed",
31
- "pagination",
32
- "performance",
33
- "mongodb-driver",
34
- "nosql",
35
- "query-builder",
36
- "api"
37
- ],
38
- "author": "vext.js Team",
39
- "license": "MIT",
40
- "repository": {
41
- "type": "git",
42
- "url": "https://github.com/vextjs/monSQLize.git"
43
- },
44
- "bugs": {
45
- "url": "https://github.com/vextjs/monSQLize/issues"
46
- },
47
- "homepage": "https://github.com/vextjs/monSQLize#readme",
48
- "engines": {
49
- "node": ">=16.0.0"
50
- },
51
- "scripts": {
52
- "test": "node test/run-tests.js",
53
- "test:unit": "node test/run-tests.js",
54
- "test:performance": "node test/performance/transaction-benchmark.js",
55
- "test:coverage": "nyc --reporter=text --reporter=lcov node test/run-tests.js",
56
- "coverage": "nyc --reporter=text --reporter=lcov --reporter=html node test/run-tests.js",
57
- "benchmark": "node test/benchmark/run-benchmarks.js",
58
- "test:compatibility": "node test/compatibility/run-node-test.js",
59
- "test:compatibility:node": "node scripts/test-node-versions.js",
60
- "test:compatibility:driver": "node scripts/test-driver-versions-simple.js",
61
- "test:compatibility:driver:full": "node scripts/test-driver-versions-simple.js --drivers=4.17.2,5.9.2,6.17.0,7.0.0",
62
- "test:compatibility:driver:quick": "node test/compatibility/run-driver-test.js",
63
- "test:compatibility:server": "node scripts/test-server-versions.js --use-memory-server",
64
- "test:compatibility:server:quick": "node test/compatibility/run-server-test.js",
65
- "test:compatibility:server:docker": "node scripts/test-server-versions.js",
66
- "lint": "eslint lib/ test/ --ext .js",
67
- "lint:fix": "eslint lib/ test/ --ext .js --fix",
68
- "type-check": "tsc",
69
- "postpublish": "echo '✅ 发布成功!请创建 GitHub Release: https://github.com/vextjs/monSQLize/releases/new?tag=v'$npm_package_version"
70
- },
71
- "peerDependenciesMeta": {
72
- "ioredis": {
73
- "optional": true
74
- }
75
- },
76
- "optionalDependencies": {
77
- "ioredis": "^5.8.2"
78
- },
79
- "devDependencies": {
80
- "@eslint/js": "^9.39.1",
81
- "@types/node": "^25.0.1",
82
- "benchmark": "^2.1.4",
83
- "chai": "^6.2.1",
84
- "eslint": "^9.39.1",
85
- "mocha": "^11.7.5",
86
- "mongodb-memory-server": "^10.1.2",
87
- "nyc": "^15.1.0",
88
- "sinon": "^21.0.0",
89
- "tsd": "^0.33.0",
90
- "typescript": "^5.9.3"
91
- },
92
- "nyc": {
93
- "include": [
94
- "lib/**/*.js"
95
- ],
96
- "exclude": [
97
- "test/**",
98
- "examples/**",
99
- "scripts/**",
100
- "reports/**"
101
- ],
102
- "reporter": [
103
- "text",
104
- "lcov",
105
- "html"
106
- ],
107
- "check-coverage": true,
108
- "lines": 70,
109
- "statements": 70,
110
- "functions": 70,
111
- "branches": 65
112
- },
113
- "dependencies": {
114
- "mongodb": "^6.17.0",
115
- "ssh2": "^1.17.0"
116
- }
117
- }
1
+ {
2
+ "name": "monsqlize",
3
+ "version": "2.0.1",
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",
5
+ "type": "commonjs",
6
+ "main": "./dist/cjs/index.cjs",
7
+ "module": "./dist/esm/index.mjs",
8
+ "types": "./dist/types/index.d.ts",
9
+ "exports": {
10
+ ".": {
11
+ "types": "./dist/types/index.d.ts",
12
+ "require": "./dist/cjs/index.cjs",
13
+ "import": "./dist/esm/index.mjs"
14
+ },
15
+ "./package.json": "./package.json"
16
+ },
17
+ "files": [
18
+ "dist/**/*.cjs",
19
+ "dist/**/*.mjs",
20
+ "dist/**/*.d.ts",
21
+ "changelogs/v2.0.1.md",
22
+ "changelogs/v2.0.0.md",
23
+ "README.md",
24
+ "LICENSE",
25
+ "CHANGELOG.md"
26
+ ],
27
+ "keywords": [
28
+ "mongodb",
29
+ "database",
30
+ "orm",
31
+ "cache",
32
+ "transaction",
33
+ "distributed",
34
+ "pagination",
35
+ "performance",
36
+ "mongodb-driver",
37
+ "nosql",
38
+ "query-builder",
39
+ "api"
40
+ ],
41
+ "author": "vext.js Team",
42
+ "license": "Apache-2.0",
43
+ "repository": {
44
+ "type": "git",
45
+ "url": "git+https://github.com/vextjs/monSQLize.git"
46
+ },
47
+ "bugs": {
48
+ "url": "https://github.com/vextjs/monSQLize/issues"
49
+ },
50
+ "homepage": "https://vextjs.github.io/monSQLize/",
51
+ "publishConfig": {
52
+ "access": "public",
53
+ "registry": "https://registry.npmjs.org/"
54
+ },
55
+ "engines": {
56
+ "node": ">=18.0.0"
57
+ },
58
+ "scripts": {
59
+ "check:sizes": "node scripts/check-file-sizes.cjs",
60
+ "check:sizes:strict": "node scripts/check-file-sizes.cjs --strict",
61
+ "build": "node scripts/build-p1.cjs",
62
+ "build:tests": "node scripts/compile-tests.cjs",
63
+ "lint": "eslint . --ignore-pattern .generated/** --ignore-pattern dist/**",
64
+ "lint:fix": "eslint . --fix --ignore-pattern .generated/** --ignore-pattern dist/**",
65
+ "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",
66
+ "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",
67
+ "probe:server-matrix": "node scripts/validation/probe-memory-server-matrix.cjs",
68
+ "test:server-matrix": "node scripts/validation/run-memory-server-matrix.cjs",
69
+ "test:real-env:private": "node scripts/validation/run-private-real-env-checks.cjs",
70
+ "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",
71
+ "test:performance": "npm run build && npm run build:tests && node .generated/test-dist/test/performance/baselines/function-cache.benchmark.js",
72
+ "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",
73
+ "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",
74
+ "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",
75
+ "test:refactor-guard:cache": "npm run build && npm run build:tests && node --test .generated/test-dist/test/unit/cache/cache-refactor-guard.test.js",
76
+ "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",
77
+ "test": "npm run build && npm run build:tests && node test/run-tests.cjs",
78
+ "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",
79
+ "check:test-language": "node scripts/check-test-language.cjs",
80
+ "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",
81
+ "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",
82
+ "verify:release": "npm run verify:full && npm run test:real-env:private",
83
+ "verify": "npm run verify:full",
84
+ "release:preflight": "node scripts/release-preflight.cjs",
85
+ "prepublishOnly": "npm run release:preflight",
86
+ "release:publish": "npm run release:preflight && npm publish --ignore-scripts",
87
+ "postpublish": "echo '✅ 发布成功!请创建 GitHub Release: https://github.com/vextjs/monSQLize/releases/new?tag=v'$npm_package_version"
88
+ },
89
+ "peerDependenciesMeta": {
90
+ "ioredis": {
91
+ "optional": true
92
+ },
93
+ "ssh2": {
94
+ "optional": true
95
+ }
96
+ },
97
+ "optionalDependencies": {
98
+ "ioredis": "^5.8.2",
99
+ "ssh2": "^1.17.0"
100
+ },
101
+ "devDependencies": {
102
+ "@eslint/js": "^9.39.1",
103
+ "@types/node": "^25.0.1",
104
+ "@types/semver": "^7.7.1",
105
+ "c8": "^11.0.0",
106
+ "chai": "^6.2.2",
107
+ "esbuild": "^0.25.5",
108
+ "eslint": "^9.39.1",
109
+ "mongodb-memory-server": "^11.1.0",
110
+ "sinon": "^22.0.0",
111
+ "tsd": "^0.33.0",
112
+ "typescript": "^5.9.3"
113
+ },
114
+ "dependencies": {
115
+ "async-lock": "^1.4.1",
116
+ "cache-hub": "^1.0.0",
117
+ "mongodb": "^6.21.0",
118
+ "schema-dsl": "^2.0.3"
119
+ }
120
+ }