@danielsimonjr/memory-mcp 0.7.2 → 0.47.1

package/dist/utils/validationUtils.js

@@ -0,0 +1,109 @@
+/**
+ * Validation Utilities
+ *
+ * Helper functions for validating entities, relations, and other data structures.
+ *
+ * @module utils/validationUtils
+ */
+import { IMPORTANCE_RANGE } from './constants.js';
+/**
+ * Type guard to check if value is a non-null object.
+ */
+function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Validate an entity object.
+ *
+ * Checks required fields and data types.
+ *
+ * @param entity - Entity to validate (unknown type for runtime validation)
+ * @returns Validation result
+ */
+export function validateEntity(entity) {
+    const errors = [];
+    if (!isObject(entity)) {
+        return { valid: false, errors: ['Entity must be an object'] };
+    }
+    if (!entity.name || typeof entity.name !== 'string' || entity.name.trim() === '') {
+        errors.push('Entity name is required and must be a non-empty string');
+    }
+    if (!entity.entityType || typeof entity.entityType !== 'string' || entity.entityType.trim() === '') {
+        errors.push('Entity type is required and must be a non-empty string');
+    }
+    if (!Array.isArray(entity.observations)) {
+        errors.push('Observations must be an array');
+    }
+    else if (!entity.observations.every((o) => typeof o === 'string')) {
+        errors.push('All observations must be strings');
+    }
+    if (entity.tags !== undefined) {
+        if (!Array.isArray(entity.tags)) {
+            errors.push('Tags must be an array');
+        }
+        else if (!entity.tags.every((t) => typeof t === 'string')) {
+            errors.push('All tags must be strings');
+        }
+    }
+    if (entity.importance !== undefined) {
+        if (typeof entity.importance !== 'number') {
+            errors.push('Importance must be a number');
+        }
+        else if (!validateImportance(entity.importance)) {
+            errors.push('Importance must be between 0 and 10');
+        }
+    }
+    return { valid: errors.length === 0, errors };
+}
+/**
+ * Validate a relation object.
+ *
+ * Checks required fields and data types.
+ *
+ * @param relation - Relation to validate (unknown type for runtime validation)
+ * @returns Validation result
+ */
+export function validateRelation(relation) {
+    const errors = [];
+    if (!isObject(relation)) {
+        return { valid: false, errors: ['Relation must be an object'] };
+    }
+    if (!relation.from || typeof relation.from !== 'string' || relation.from.trim() === '') {
+        errors.push('Relation "from" is required and must be a non-empty string');
+    }
+    if (!relation.to || typeof relation.to !== 'string' || relation.to.trim() === '') {
+        errors.push('Relation "to" is required and must be a non-empty string');
+    }
+    if (!relation.relationType || typeof relation.relationType !== 'string' || relation.relationType.trim() === '') {
+        errors.push('Relation type is required and must be a non-empty string');
+    }
+    return { valid: errors.length === 0, errors };
+}
+/**
+ * Validate importance level (must be 0-10).
+ *
+ * @param importance - Importance value to validate
+ * @returns True if valid
+ */
+export function validateImportance(importance) {
+    return typeof importance === 'number'
+        && !isNaN(importance)
+        && importance >= IMPORTANCE_RANGE.MIN
+        && importance <= IMPORTANCE_RANGE.MAX;
+}
+/**
+ * Validate an array of tags.
+ *
+ * @param tags - Tags array to validate (unknown type for runtime validation)
+ * @returns Validation result
+ */
+export function validateTags(tags) {
+    const errors = [];
+    if (!Array.isArray(tags)) {
+        return { valid: false, errors: ['Tags must be an array'] };
+    }
+    if (!tags.every((t) => typeof t === 'string' && t.trim() !== '')) {
+        errors.push('All tags must be non-empty strings');
+    }
+    return { valid: errors.length === 0, errors };
+}

package/package.json

@@ -1,48 +1,82 @@
-{
-  "name": "@danielsimonjr/memory-mcp",
-  "version": "0.7.2",
-  "description": "Enhanced MCP memory server with timestamps, tags, importance, search, and export (JSON/CSV/GraphML)",
-  "license": "MIT",
-  "author": "Daniel Simon Jr. (https://github.com/danielsimonjr)",
-  "homepage": "https://github.com/danielsimonjr/memory-mcp",
-  "bugs": "https://github.com/danielsimonjr/memory-mcp/issues",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/danielsimonjr/memory-mcp.git"
-  },
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "memory",
-    "knowledge-graph",
-    "enhanced",
-    "timestamps",
-    "tags",
-    "export",
-    "graphml",
-    "analytics"
-  ],
-  "type": "module",
-  "bin": {
-    "mcp-server-memory": "dist/index.js"
-  },
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "tsc && shx chmod +x dist/*.js",
-    "prepare": "npm run build",
-    "watch": "tsc --watch",
-    "test": "vitest run --coverage"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.21.1"
-  },
-  "devDependencies": {
-    "@types/node": "^22",
-    "@vitest/coverage-v8": "^2.1.8",
-    "shx": "^0.3.4",
-    "typescript": "^5.6.2",
-    "vitest": "^2.1.8"
-  }
-}
+{
+  "name": "@danielsimonjr/memory-mcp",
+  "version": "0.47.1",
+  "description": "Enhanced MCP memory server with hierarchies, compression, archiving, and 45 advanced tools",
+  "license": "MIT",
+  "author": "Daniel Simon Jr. (https://github.com/danielsimonjr)",
+  "homepage": "https://github.com/danielsimonjr/memory-mcp",
+  "bugs": "https://github.com/danielsimonjr/memory-mcp/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/danielsimonjr/memory-mcp.git"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "memory",
+    "knowledge-graph",
+    "enhanced",
+    "timestamps",
+    "tags",
+    "export",
+    "graphml",
+    "analytics"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./types": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/types/index.js"
+    },
+    "./utils": {
+      "types": "./dist/utils/index.d.ts",
+      "import": "./dist/utils/index.js"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.js"
+    },
+    "./search": {
+      "types": "./dist/search/index.d.ts",
+      "import": "./dist/search/index.js"
+    },
+    "./features": {
+      "types": "./dist/features/index.d.ts",
+      "import": "./dist/features/index.js"
+    },
+    "./server": {
+      "types": "./dist/server/MCPServer.d.ts",
+      "import": "./dist/server/MCPServer.js"
+    }
+  },
+  "bin": {
+    "mcp-server-memory": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build",
+    "watch": "tsc --watch",
+    "test": "vitest run --coverage",
+    "typecheck": "tsc --noEmit --noUnusedLocals --noUnusedParameters --strict"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.21.1",
+    "zod": "^4.1.13"
+  },
+  "devDependencies": {
+    "@types/node": "^22",
+    "@vitest/coverage-v8": "^4.0.13",
+    "shx": "^0.4.0",
+    "typescript": "^5.6.2",
+    "vitest": "^4.0.13"
+  }
+}