hippocampus-mcp 1.0.0

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 (70) hide show
  1. package/README.md +284 -0
  2. package/dist/aws/credentials-provider.d.ts +20 -0
  3. package/dist/aws/credentials-provider.d.ts.map +1 -0
  4. package/dist/aws/credentials-provider.js +107 -0
  5. package/dist/aws/credentials-provider.js.map +1 -0
  6. package/dist/config/environment.d.ts +12 -0
  7. package/dist/config/environment.d.ts.map +1 -0
  8. package/dist/config/environment.js +42 -0
  9. package/dist/config/environment.js.map +1 -0
  10. package/dist/config/index.d.ts +2 -0
  11. package/dist/config/index.d.ts.map +1 -0
  12. package/dist/config/index.js +2 -0
  13. package/dist/config/index.js.map +1 -0
  14. package/dist/data/dynamodb-client.d.ts +25 -0
  15. package/dist/data/dynamodb-client.d.ts.map +1 -0
  16. package/dist/data/dynamodb-client.js +107 -0
  17. package/dist/data/dynamodb-client.js.map +1 -0
  18. package/dist/data/entity-manager.d.ts +31 -0
  19. package/dist/data/entity-manager.d.ts.map +1 -0
  20. package/dist/data/entity-manager.js +330 -0
  21. package/dist/data/entity-manager.js.map +1 -0
  22. package/dist/data/models.d.ts +67 -0
  23. package/dist/data/models.d.ts.map +1 -0
  24. package/dist/data/models.js +19 -0
  25. package/dist/data/models.js.map +1 -0
  26. package/dist/data/preference-manager.d.ts +11 -0
  27. package/dist/data/preference-manager.d.ts.map +1 -0
  28. package/dist/data/preference-manager.js +47 -0
  29. package/dist/data/preference-manager.js.map +1 -0
  30. package/dist/data/search-engine.d.ts +19 -0
  31. package/dist/data/search-engine.d.ts.map +1 -0
  32. package/dist/data/search-engine.js +164 -0
  33. package/dist/data/search-engine.js.map +1 -0
  34. package/dist/index.d.ts +3 -0
  35. package/dist/index.d.ts.map +1 -0
  36. package/dist/index.js +105 -0
  37. package/dist/index.js.map +1 -0
  38. package/dist/mcp/resource-registry.d.ts +18 -0
  39. package/dist/mcp/resource-registry.d.ts.map +1 -0
  40. package/dist/mcp/resource-registry.js +140 -0
  41. package/dist/mcp/resource-registry.js.map +1 -0
  42. package/dist/mcp/tool-handler.d.ts +37 -0
  43. package/dist/mcp/tool-handler.d.ts.map +1 -0
  44. package/dist/mcp/tool-handler.js +221 -0
  45. package/dist/mcp/tool-handler.js.map +1 -0
  46. package/dist/mcp/tool-registry.d.ts +6 -0
  47. package/dist/mcp/tool-registry.d.ts.map +1 -0
  48. package/dist/mcp/tool-registry.js +619 -0
  49. package/dist/mcp/tool-registry.js.map +1 -0
  50. package/dist/protocol/jsonrpc-handler.d.ts +36 -0
  51. package/dist/protocol/jsonrpc-handler.d.ts.map +1 -0
  52. package/dist/protocol/jsonrpc-handler.js +143 -0
  53. package/dist/protocol/jsonrpc-handler.js.map +1 -0
  54. package/dist/protocol/stdio-handler.d.ts +20 -0
  55. package/dist/protocol/stdio-handler.d.ts.map +1 -0
  56. package/dist/protocol/stdio-handler.js +100 -0
  57. package/dist/protocol/stdio-handler.js.map +1 -0
  58. package/dist/protocol/types.d.ts +38 -0
  59. package/dist/protocol/types.d.ts.map +1 -0
  60. package/dist/protocol/types.js +11 -0
  61. package/dist/protocol/types.js.map +1 -0
  62. package/dist/utils/errors.d.ts +2 -0
  63. package/dist/utils/errors.d.ts.map +1 -0
  64. package/dist/utils/errors.js +2 -0
  65. package/dist/utils/errors.js.map +1 -0
  66. package/dist/utils/logger.d.ts +2 -0
  67. package/dist/utils/logger.d.ts.map +1 -0
  68. package/dist/utils/logger.js +2 -0
  69. package/dist/utils/logger.js.map +1 -0
  70. package/package.json +81 -0
@@ -0,0 +1,143 @@
1
+ import { MCPProtocolError } from './types';
2
+ export class JSONRPCHandler {
3
+ handlers = new Map();
4
+ serverInfo;
5
+ capabilities;
6
+ toolRegistry = [];
7
+ resourceRegistry = [];
8
+ toolExecutor;
9
+ resourceReader;
10
+ constructor(serverInfo, capabilities) {
11
+ this.serverInfo = serverInfo;
12
+ this.capabilities = capabilities;
13
+ this.registerBuiltInMethods();
14
+ }
15
+ registerBuiltInMethods() {
16
+ this.registerMethod('initialize', async (params) => {
17
+ return {
18
+ protocolVersion: '2024-11-05',
19
+ serverInfo: this.serverInfo,
20
+ capabilities: this.capabilities,
21
+ };
22
+ });
23
+ this.registerMethod('tools/list', async (params) => {
24
+ return {
25
+ tools: this.toolRegistry,
26
+ };
27
+ });
28
+ this.registerMethod('resources/list', async (params) => {
29
+ return {
30
+ resources: this.resourceRegistry,
31
+ };
32
+ });
33
+ this.registerMethod('tools/call', async (params) => {
34
+ if (!params || typeof params.name !== 'string') {
35
+ throw new MCPProtocolError(-32602, 'Invalid params: tools/call requires a "name" parameter');
36
+ }
37
+ if (!this.toolExecutor) {
38
+ throw new MCPProtocolError(-32603, 'Internal error: tool executor not configured');
39
+ }
40
+ const toolParams = params.arguments || {};
41
+ const result = await this.toolExecutor(params.name, toolParams);
42
+ return {
43
+ content: [
44
+ {
45
+ type: 'text',
46
+ text: JSON.stringify(result, null, 2),
47
+ },
48
+ ],
49
+ };
50
+ });
51
+ this.registerMethod('resources/read', async (params) => {
52
+ if (!params || typeof params.uri !== 'string') {
53
+ throw new MCPProtocolError(-32602, 'Invalid params: resources/read requires a "uri" parameter');
54
+ }
55
+ if (!this.resourceReader) {
56
+ throw new MCPProtocolError(-32603, 'Internal error: resource reader not configured');
57
+ }
58
+ try {
59
+ const content = await this.resourceReader(params.uri);
60
+ return {
61
+ contents: [
62
+ {
63
+ uri: params.uri,
64
+ mimeType: 'application/json',
65
+ text: content,
66
+ },
67
+ ],
68
+ };
69
+ }
70
+ catch (error) {
71
+ throw new MCPProtocolError(-32603, `Failed to read resource: ${error instanceof Error ? error.message : String(error)}`);
72
+ }
73
+ });
74
+ }
75
+ setToolRegistry(tools) {
76
+ this.toolRegistry = tools;
77
+ }
78
+ setResourceRegistry(resources) {
79
+ this.resourceRegistry = resources;
80
+ }
81
+ setToolExecutor(executor) {
82
+ this.toolExecutor = executor;
83
+ }
84
+ setResourceReader(reader) {
85
+ this.resourceReader = reader;
86
+ }
87
+ registerMethod(method, handler) {
88
+ this.handlers.set(method, handler);
89
+ }
90
+ async handleRequest(request) {
91
+ if (request.jsonrpc !== '2.0') {
92
+ return this.createErrorResponse(request.id, -32600, 'Invalid Request: jsonrpc must be "2.0"');
93
+ }
94
+ if (typeof request.method !== 'string' || request.method.length === 0) {
95
+ return this.createErrorResponse(request.id, -32600, 'Invalid Request: method must be a non-empty string');
96
+ }
97
+ const handler = this.handlers.get(request.method);
98
+ if (!handler) {
99
+ return this.createErrorResponse(request.id, -32601, `Method not found: ${request.method}`);
100
+ }
101
+ try {
102
+ const result = await handler(request.params);
103
+ return this.createSuccessResponse(request.id, result);
104
+ }
105
+ catch (error) {
106
+ if (error instanceof MCPProtocolError) {
107
+ return this.createErrorResponse(request.id, error.code, error.message, error.data);
108
+ }
109
+ return this.createErrorResponse(request.id, -32603, `Internal error: ${error instanceof Error ? error.message : String(error)}`);
110
+ }
111
+ }
112
+ createSuccessResponse(id, result) {
113
+ return {
114
+ jsonrpc: '2.0',
115
+ id: id ?? null,
116
+ result,
117
+ };
118
+ }
119
+ createErrorResponse(id, code, message, data) {
120
+ return {
121
+ jsonrpc: '2.0',
122
+ id: id ?? null,
123
+ error: {
124
+ code,
125
+ message,
126
+ data,
127
+ },
128
+ };
129
+ }
130
+ getRegisteredMethods() {
131
+ return Array.from(this.handlers.keys());
132
+ }
133
+ hasMethod(method) {
134
+ return this.handlers.has(method);
135
+ }
136
+ unregisterMethod(method) {
137
+ return this.handlers.delete(method);
138
+ }
139
+ clearHandlers() {
140
+ this.handlers.clear();
141
+ }
142
+ }
143
+ //# sourceMappingURL=jsonrpc-handler.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"jsonrpc-handler.js","sourceRoot":"","sources":["../../src/protocol/jsonrpc-handler.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,20 @@
1
+ import { Readable, Writable } from 'stream';
2
+ import { MCPRequest, MCPResponse } from './types';
3
+ export type MessageHandler = (message: MCPRequest) => Promise<MCPResponse>;
4
+ export declare class StdioHandler {
5
+ private buffer;
6
+ private messageHandler;
7
+ private isRunning;
8
+ private readonly input;
9
+ private readonly output;
10
+ constructor(input?: Readable, output?: Writable);
11
+ setMessageHandler(handler: MessageHandler): void;
12
+ start(): void;
13
+ stop(): void;
14
+ private handleData;
15
+ private processMessage;
16
+ writeResponse(response: MCPResponse): void;
17
+ private writeError;
18
+ isActive(): boolean;
19
+ }
20
+ //# sourceMappingURL=stdio-handler.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"stdio-handler.d.ts","sourceRoot":"","sources":["../../src/protocol/stdio-handler.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAKlD,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,UAAU,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;AAQ3E,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;gBAOtB,KAAK,GAAE,QAAwB,EAAE,MAAM,GAAE,QAAyB;IAQ9E,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAOhD,KAAK,IAAI,IAAI;IAqCb,IAAI,IAAI,IAAI;IAaZ,OAAO,CAAC,UAAU;YAwBJ,cAAc;IA2C5B,aAAa,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI;IAQ1C,OAAO,CAAC,UAAU;IAqBlB,QAAQ,IAAI,OAAO;CAGpB"}
@@ -0,0 +1,100 @@
1
+ export class StdioHandler {
2
+ buffer = '';
3
+ messageHandler = null;
4
+ isRunning = false;
5
+ input;
6
+ output;
7
+ constructor(input = process.stdin, output = process.stdout) {
8
+ this.input = input;
9
+ this.output = output;
10
+ }
11
+ setMessageHandler(handler) {
12
+ this.messageHandler = handler;
13
+ }
14
+ start() {
15
+ if (this.isRunning) {
16
+ return;
17
+ }
18
+ this.isRunning = true;
19
+ this.input.setEncoding('utf8');
20
+ this.input.on('data', (chunk) => {
21
+ this.handleData(chunk);
22
+ });
23
+ this.input.on('end', () => {
24
+ this.stop();
25
+ });
26
+ if (this.input === process.stdin) {
27
+ process.on('SIGINT', () => {
28
+ this.stop();
29
+ process.exit(0);
30
+ });
31
+ process.on('SIGTERM', () => {
32
+ this.stop();
33
+ process.exit(0);
34
+ });
35
+ }
36
+ }
37
+ stop() {
38
+ if (!this.isRunning) {
39
+ return;
40
+ }
41
+ this.isRunning = false;
42
+ this.input.pause();
43
+ }
44
+ handleData(chunk) {
45
+ this.buffer += chunk;
46
+ let newlineIndex;
47
+ while ((newlineIndex = this.buffer.indexOf('\n')) !== -1) {
48
+ const line = this.buffer.slice(0, newlineIndex).trim();
49
+ this.buffer = this.buffer.slice(newlineIndex + 1);
50
+ if (line.length === 0) {
51
+ continue;
52
+ }
53
+ this.processMessage(line);
54
+ }
55
+ }
56
+ async processMessage(line) {
57
+ try {
58
+ const message = JSON.parse(line);
59
+ if (message.jsonrpc !== '2.0' || typeof message.method !== 'string') {
60
+ this.writeError(message.id, -32600, 'Invalid Request: missing or invalid jsonrpc or method field');
61
+ return;
62
+ }
63
+ if (this.messageHandler) {
64
+ const response = await this.messageHandler(message);
65
+ this.writeResponse(response);
66
+ }
67
+ else {
68
+ this.writeError(message.id, -32603, 'Internal error: no message handler configured');
69
+ }
70
+ }
71
+ catch (error) {
72
+ if (error instanceof SyntaxError) {
73
+ this.writeError(undefined, -32700, 'Parse error: invalid JSON');
74
+ }
75
+ else {
76
+ this.writeError(undefined, -32603, `Internal error: ${error instanceof Error ? error.message : String(error)}`);
77
+ }
78
+ }
79
+ }
80
+ writeResponse(response) {
81
+ const json = JSON.stringify(response);
82
+ this.output.write(json + '\n');
83
+ }
84
+ writeError(id, code, message, data) {
85
+ const response = {
86
+ jsonrpc: '2.0',
87
+ id: id ?? null,
88
+ error: {
89
+ code,
90
+ message,
91
+ data,
92
+ },
93
+ };
94
+ this.writeResponse(response);
95
+ }
96
+ isActive() {
97
+ return this.isRunning;
98
+ }
99
+ }
100
+ //# sourceMappingURL=stdio-handler.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"stdio-handler.js","sourceRoot":"","sources":["../../src/protocol/stdio-handler.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,38 @@
1
+ export interface MCPRequest {
2
+ jsonrpc: "2.0";
3
+ id?: string | number;
4
+ method: string;
5
+ params?: Record<string, any>;
6
+ }
7
+ export interface MCPResponse {
8
+ jsonrpc: "2.0";
9
+ id: string | number;
10
+ result?: any;
11
+ error?: MCPError;
12
+ }
13
+ export interface MCPError {
14
+ code: number;
15
+ message: string;
16
+ data?: any;
17
+ }
18
+ export declare class MCPProtocolError extends Error {
19
+ code: number;
20
+ data?: any | undefined;
21
+ constructor(code: number, message: string, data?: any | undefined);
22
+ }
23
+ export interface MCPTool {
24
+ name: string;
25
+ description: string;
26
+ inputSchema: {
27
+ type: "object";
28
+ properties: Record<string, any>;
29
+ required?: string[];
30
+ };
31
+ }
32
+ export interface MCPResource {
33
+ uri: string;
34
+ name: string;
35
+ description: string;
36
+ mimeType: string;
37
+ }
38
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/protocol/types.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B;AAKD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB;AAKD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ;AAKD,qBAAa,gBAAiB,SAAQ,KAAK;IAEhC,IAAI,EAAE,MAAM;IAEZ,IAAI,CAAC,EAAE,GAAG;gBAFV,IAAI,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACR,IAAI,CAAC,EAAE,GAAG,YAAA;CAKpB;AAKD,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAChC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAKD,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB"}
@@ -0,0 +1,11 @@
1
+ export class MCPProtocolError extends Error {
2
+ code;
3
+ data;
4
+ constructor(code, message, data) {
5
+ super(message);
6
+ this.code = code;
7
+ this.data = data;
8
+ this.name = 'MCPProtocolError';
9
+ }
10
+ }
11
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/protocol/types.ts"],"names":[],"mappings":"AAuCA,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAEhC;IAEA;IAHT,YACS,IAAY,EACnB,OAAe,EACR,IAAU;QAEjB,KAAK,CAAC,OAAO,CAAC,CAAC;QAJR,SAAI,GAAJ,IAAI,CAAQ;QAEZ,SAAI,GAAJ,IAAI,CAAM;QAGjB,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=errors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=errors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=logger.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=logger.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":""}
package/package.json ADDED
@@ -0,0 +1,81 @@
1
+ {
2
+ "name": "hippocampus-mcp",
3
+ "version": "1.0.0",
4
+ "description": "Personal Knowledge MCP Server - Provides AI assistants with access to personal knowledge, preferences, and contextual information stored in AWS DynamoDB",
5
+ "main": "dist/index.js",
6
+ "type": "module",
7
+ "bin": {
8
+ "hippocampus-mcp": "./dist/index.js"
9
+ },
10
+ "scripts": {
11
+ "build": "tsc",
12
+ "build:watch": "tsc --watch",
13
+ "start": "node dist/index.js",
14
+ "dev": "tsc && node dist/index.js",
15
+ "test": "jest",
16
+ "test:watch": "jest --watch",
17
+ "test:coverage": "jest --coverage",
18
+ "clean": "rm -rf dist",
19
+ "lint": "eslint src --ext .ts",
20
+ "lint:fix": "eslint src --ext .ts --fix",
21
+ "prepublishOnly": "npm run clean && npm run build",
22
+ "deploy": "tsx bin/deploy.ts",
23
+ "cdk": "cdk",
24
+ "cdk:deploy": "cdk deploy --profile hc1 --require-approval never",
25
+ "cdk:synth": "cdk synth --profile hc1",
26
+ "cdk:diff": "cdk diff --profile hc1",
27
+ "cdk:destroy": "cdk destroy --profile hc1"
28
+ },
29
+ "keywords": [
30
+ "mcp",
31
+ "model-context-protocol",
32
+ "personal-knowledge",
33
+ "aws",
34
+ "dynamodb",
35
+ "ai-assistant",
36
+ "bedrock",
37
+ "knowledge-base"
38
+ ],
39
+ "author": "hippocampus_v1",
40
+ "license": "MIT",
41
+ "repository": {
42
+ "type": "git",
43
+ "url": "https://github.com/yourusername/hippocampus-mcp.git"
44
+ },
45
+ "bugs": {
46
+ "url": "https://github.com/yourusername/hippocampus-mcp/issues"
47
+ },
48
+ "homepage": "https://github.com/yourusername/hippocampus-mcp#readme",
49
+ "files": [
50
+ "dist/**/*",
51
+ "README.md",
52
+ "LICENSE"
53
+ ],
54
+ "dependencies": {
55
+ "@aws-sdk/client-dynamodb": "^3.709.0",
56
+ "@aws-sdk/lib-dynamodb": "^3.709.0",
57
+ "uuid": "^11.0.3"
58
+ },
59
+ "devDependencies": {
60
+ "@types/jest": "^29.5.14",
61
+ "@types/node": "^22.10.2",
62
+ "@types/source-map-support": "^0.5.10",
63
+ "@types/uuid": "^10.0.0",
64
+ "@typescript-eslint/eslint-plugin": "^8.18.2",
65
+ "@typescript-eslint/parser": "^8.18.2",
66
+ "aws-cdk": "^2.1101.0",
67
+ "aws-cdk-lib": "^2.235.1",
68
+ "constructs": "^10.4.5",
69
+ "eslint": "^9.17.0",
70
+ "fast-check": "^3.23.1",
71
+ "jest": "^29.7.0",
72
+ "source-map-support": "^0.5.21",
73
+ "ts-jest": "^29.2.5",
74
+ "ts-node": "^10.9.2",
75
+ "tsx": "^4.21.0",
76
+ "typescript": "^5.7.2"
77
+ },
78
+ "engines": {
79
+ "node": ">=18.0.0"
80
+ }
81
+ }