@carlonicora/nestjs-neo4jsonapi 1.3.1 → 1.4.0

package/dist/scripts/generate-module/utils/file-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-writer.d.ts","sourceRoot":"","sources":["../../../../scripts/generate-module/utils/file-writer.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM,EAAE,CAEjE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,WAAW,EAAE,EACpB,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACZ,GACL,IAAI,CA4BN;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAG1D"}

package/dist/scripts/generate-module/utils/file-writer.js

@@ -0,0 +1,89 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkFileConflicts = checkFileConflicts;
+exports.writeFiles = writeFiles;
+exports.buildFilePath = buildFilePath;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Check if files exist (for conflict detection)
+ *
+ * @param files - List of files to check
+ * @returns Array of existing file paths
+ */
+function checkFileConflicts(files) {
+    return files.filter((file) => fs.existsSync(file.path)).map((file) => file.path);
+}
+/**
+ * Write files to disk
+ *
+ * @param files - Files to write
+ * @param options - Write options
+ */
+function writeFiles(files, options = {}) {
+    const { dryRun = false, force = false } = options;
+    if (!force) {
+        const conflicts = checkFileConflicts(files);
+        if (conflicts.length > 0) {
+            throw new Error(`Files already exist. Use --force to overwrite:\n${conflicts.map((f) => `  - ${f}`).join("\n")}`);
+        }
+    }
+    for (const file of files) {
+        if (dryRun) {
+            console.log(`[DRY RUN] Would create: ${file.path}`);
+            continue;
+        }
+        // Create directory if it doesn't exist
+        const dir = path.dirname(file.path);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        // Write file
+        fs.writeFileSync(file.path, file.content, "utf-8");
+        console.log(`✓ Created: ${file.path}`);
+    }
+}
+/**
+ * Build absolute file path
+ *
+ * @param relativePath - Relative path from project root
+ * @returns Absolute path
+ */
+function buildFilePath(relativePath) {
+    // Assuming the script is run from the project root
+    return path.resolve(process.cwd(), relativePath);
+}
+//# sourceMappingURL=file-writer.js.map

package/dist/scripts/generate-module/utils/file-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-writer.js","sourceRoot":"","sources":["../../../../scripts/generate-module/utils/file-writer.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAcA,gDAEC;AAQD,gCAkCC;AAQD,sCAGC;AArED,uCAAyB;AACzB,2CAA6B;AAO7B;;;;;GAKG;AACH,SAAgB,kBAAkB,CAAC,KAAoB;IACrD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACnF,CAAC;AAED;;;;;GAKG;AACH,SAAgB,UAAU,CACxB,KAAoB,EACpB,UAGI,EAAE;IAEN,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,KAAK,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAElD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,SAAS,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC5C,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,mDAAmD,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACjG,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YACpD,SAAS;QACX,CAAC;QAED,uCAAuC;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC;QAED,aAAa;QACb,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,YAAoB;IAChD,mDAAmD;IACnD,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,YAAY,CAAC,CAAC;AACnD,CAAC"}

package/dist/scripts/generate-module/utils/module-registrar.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Update features.modules.ts to register the new module
+ *
+ * @param params - Module information
+ */
+export declare function registerModule(params: {
+    moduleName: string;
+    targetDir: string;
+    kebabName: string;
+    dryRun?: boolean;
+}): void;
+//# sourceMappingURL=module-registrar.d.ts.map

package/dist/scripts/generate-module/utils/module-registrar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-registrar.d.ts","sourceRoot":"","sources":["../../../../scripts/generate-module/utils/module-registrar.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,IAAI,CAyFP"}

package/dist/scripts/generate-module/utils/module-registrar.js

@@ -0,0 +1,119 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerModule = registerModule;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Update features.modules.ts to register the new module
+ *
+ * @param params - Module information
+ */
+function registerModule(params) {
+    const { moduleName, targetDir, kebabName, dryRun = false } = params;
+    // Determine the parent module file based on targetDir
+    let parentModulePath;
+    if (targetDir === "features") {
+        parentModulePath = path.resolve(process.cwd(), "apps/api/src/features/features.modules.ts");
+    }
+    else if (targetDir === "foundations") {
+        parentModulePath = path.resolve(process.cwd(), "apps/api/src/foundations/foundations.modules.ts");
+    }
+    else {
+        throw new Error(`Unknown target directory: ${targetDir}`);
+    }
+    // Check if parent module file exists
+    if (!fs.existsSync(parentModulePath)) {
+        console.warn(`⚠️  Warning: Parent module file not found: ${parentModulePath}`);
+        console.warn(`   You will need to manually register ${moduleName}Module`);
+        return;
+    }
+    let content = fs.readFileSync(parentModulePath, "utf-8");
+    // Build import statement
+    const moduleClassName = `${moduleName}Module`;
+    const importPath = `src/${targetDir}/${kebabName}/${kebabName}.module`;
+    const newImport = `import { ${moduleClassName} } from "${importPath}";\n`;
+    // Check if already imported
+    if (content.includes(`import { ${moduleClassName} }`)) {
+        console.log(`ℹ️  ${moduleClassName} is already imported in ${parentModulePath}`);
+        return;
+    }
+    if (dryRun) {
+        console.log(`[DRY RUN] Would add import to ${parentModulePath}:`);
+        console.log(`  ${newImport.trim()}`);
+        console.log(`[DRY RUN] Would add ${moduleClassName} to imports array`);
+        return;
+    }
+    // Find the last import statement
+    const importRegex = /import\s+{[^}]+}\s+from\s+"[^"]+";?\n/g;
+    const imports = [...content.matchAll(importRegex)];
+    if (imports.length === 0) {
+        throw new Error("Could not find any import statements in parent module file");
+    }
+    const lastImport = imports[imports.length - 1];
+    const lastImportEnd = lastImport.index + lastImport[0].length;
+    // Insert new import alphabetically
+    let insertPosition = lastImportEnd;
+    for (const imp of imports) {
+        const impText = imp[0];
+        if (impText > newImport) {
+            insertPosition = imp.index;
+            break;
+        }
+    }
+    content = content.slice(0, insertPosition) + newImport + content.slice(insertPosition);
+    // Find the @Module imports array
+    const moduleImportsRegex = /imports:\s*\[([\s\S]*?)\]/;
+    const match = content.match(moduleImportsRegex);
+    if (!match) {
+        throw new Error("Could not find @Module imports array");
+    }
+    // Parse existing modules
+    const importsArrayContent = match[1];
+    const modules = importsArrayContent
+        .split(",")
+        .map((m) => m.trim())
+        .filter((m) => m);
+    // Add new module alphabetically
+    modules.push(moduleClassName);
+    modules.sort();
+    // Rebuild imports array with proper formatting
+    const newImportsArray = `imports: [\n    ${modules.join(",\n    ")},\n  ]`;
+    content = content.replace(moduleImportsRegex, newImportsArray);
+    // Write back
+    fs.writeFileSync(parentModulePath, content, "utf-8");
+    console.log(`✓ Registered ${moduleClassName} in ${parentModulePath}`);
+}
+//# sourceMappingURL=module-registrar.js.map

package/dist/scripts/generate-module/utils/module-registrar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-registrar.js","sourceRoot":"","sources":["../../../../scripts/generate-module/utils/module-registrar.ts"],"names":[],"mappings":"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"}

package/dist/scripts/generate-module/validators/json-schema-validator.d.ts

@@ -0,0 +1,27 @@
+export interface ValidationError {
+    field: string;
+    message: string;
+    severity: "error" | "warning";
+}
+/**
+ * Validate JSON module definition
+ *
+ * @param schema - JSON module definition
+ * @returns Array of validation errors (empty if valid)
+ */
+export declare function validateJsonSchema(schema: any): ValidationError[];
+/**
+ * Check if validation passed (no errors, only warnings allowed)
+ *
+ * @param errors - Validation errors
+ * @returns true if validation passed
+ */
+export declare function validationPassed(errors: ValidationError[]): boolean;
+/**
+ * Format validation errors for display
+ *
+ * @param errors - Validation errors
+ * @returns Formatted error message
+ */
+export declare function formatValidationErrors(errors: ValidationError[]): string;
+//# sourceMappingURL=json-schema-validator.d.ts.map

package/dist/scripts/generate-module/validators/json-schema-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema-validator.d.ts","sourceRoot":"","sources":["../../../../scripts/generate-module/validators/json-schema-validator.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,GAAG,GAAG,eAAe,EAAE,CAqIjE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,CAEnE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,CAWxE"}

package/dist/scripts/generate-module/validators/json-schema-validator.js

@@ -0,0 +1,156 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateJsonSchema = validateJsonSchema;
+exports.validationPassed = validationPassed;
+exports.formatValidationErrors = formatValidationErrors;
+/**
+ * Validate JSON module definition
+ *
+ * @param schema - JSON module definition
+ * @returns Array of validation errors (empty if valid)
+ */
+function validateJsonSchema(schema) {
+    const errors = [];
+    // Required fields
+    const required = ["moduleName", "endpointName", "targetDir"];
+    for (const field of required) {
+        if (!schema[field]) {
+            errors.push({
+                field,
+                message: `${field} is required`,
+                severity: "error",
+            });
+        }
+    }
+    // Module name format (PascalCase)
+    if (schema.moduleName && !/^[A-Z][a-zA-Z0-9]*$/.test(schema.moduleName)) {
+        errors.push({
+            field: "moduleName",
+            message: 'Must be PascalCase (e.g., "Comment", "Discussion")',
+            severity: "error",
+        });
+    }
+    // Endpoint format (kebab-case plural)
+    if (schema.endpointName && !/^[a-z][a-z0-9-]*$/.test(schema.endpointName)) {
+        errors.push({
+            field: "endpointName",
+            message: 'Must be kebab-case (e.g., "comments", "discussions")',
+            severity: "error",
+        });
+    }
+    // Target directory validation
+    if (schema.targetDir && !["features", "foundations"].includes(schema.targetDir)) {
+        errors.push({
+            field: "targetDir",
+            message: 'Must be either "features" or "foundations"',
+            severity: "error",
+        });
+    }
+    // Fields validation
+    if (schema.fields && Array.isArray(schema.fields)) {
+        schema.fields.forEach((field, index) => {
+            if (!field.name) {
+                errors.push({
+                    field: `fields[${index}].name`,
+                    message: "Field name is required",
+                    severity: "error",
+                });
+            }
+            if (!field.type) {
+                errors.push({
+                    field: `fields[${index}].type`,
+                    message: "Field type is required",
+                    severity: "error",
+                });
+            }
+            if (field.nullable === undefined) {
+                errors.push({
+                    field: `fields[${index}].nullable`,
+                    message: "Field nullable flag is required",
+                    severity: "error",
+                });
+            }
+        });
+    }
+    // Relationships validation
+    if (schema.relationships && Array.isArray(schema.relationships)) {
+        schema.relationships.forEach((rel, index) => {
+            if (!rel.name) {
+                errors.push({
+                    field: `relationships[${index}].name`,
+                    message: "Relationship name is required",
+                    severity: "error",
+                });
+            }
+            if (!rel.directory) {
+                errors.push({
+                    field: `relationships[${index}].directory`,
+                    message: "Relationship directory is required",
+                    severity: "error",
+                });
+            }
+            if (rel.single === undefined) {
+                errors.push({
+                    field: `relationships[${index}].single`,
+                    message: "Relationship single flag is required",
+                    severity: "error",
+                });
+            }
+            if (!rel.relationshipName) {
+                errors.push({
+                    field: `relationships[${index}].relationshipName`,
+                    message: "Neo4j relationship name is required",
+                    severity: "error",
+                });
+            }
+            if (rel.relationshipName && !/^[A-Z_]+$/.test(rel.relationshipName)) {
+                errors.push({
+                    field: `relationships[${index}].relationshipName`,
+                    message: 'Should be UPPER_SNAKE_CASE (e.g., "PUBLISHED", "COMMENT_TO")',
+                    severity: "warning",
+                });
+            }
+            if (rel.toNode === undefined) {
+                errors.push({
+                    field: `relationships[${index}].toNode`,
+                    message: "Relationship toNode flag is required",
+                    severity: "error",
+                });
+            }
+            if (rel.nullable === undefined) {
+                errors.push({
+                    field: `relationships[${index}].nullable`,
+                    message: "Relationship nullable flag is required",
+                    severity: "error",
+                });
+            }
+        });
+    }
+    return errors;
+}
+/**
+ * Check if validation passed (no errors, only warnings allowed)
+ *
+ * @param errors - Validation errors
+ * @returns true if validation passed
+ */
+function validationPassed(errors) {
+    return errors.filter((e) => e.severity === "error").length === 0;
+}
+/**
+ * Format validation errors for display
+ *
+ * @param errors - Validation errors
+ * @returns Formatted error message
+ */
+function formatValidationErrors(errors) {
+    if (errors.length === 0) {
+        return "No validation errors";
+    }
+    const errorLines = errors.map((error) => {
+        const icon = error.severity === "error" ? "❌" : "⚠️";
+        return `${icon} ${error.field}: ${error.message}`;
+    });
+    return errorLines.join("\n");
+}
+//# sourceMappingURL=json-schema-validator.js.map

package/dist/scripts/generate-module/validators/json-schema-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema-validator.js","sourceRoot":"","sources":["../../../../scripts/generate-module/validators/json-schema-validator.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@carlonicora/nestjs-neo4jsonapi",
-  "version": "1.3.1",
+  "version": "1.4.0",
   "description": "NestJS foundation package with JSON:API, Neo4j, Redis, LangChain agents, and common utilities",
   "author": "Carlo Nicora",
   "license": "GPL-3.0-or-later",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "bin": {
-    "neo4jsonapi-migrate": "./dist/tools/migrate-entity/index.js"
+    "neo4jsonapi-migrate": "./dist/tools/migrate-entity/index.js",
+    "generate-module": "./dist/scripts/generate-module/index.js"
   },
   "exports": {
     ".": {
@@ -48,7 +49,7 @@
     }
   },
   "scripts": {
-    "build": "tsc && tsc -p tools/migrate-entity/tsconfig.json",
+    "build": "tsc && tsc -p tools/migrate-entity/tsconfig.json && tsc -p scripts/generate-module/tsconfig.json",
     "dev": "tsc --watch",
     "clean": "rm -rf dist",
     "lint": "eslint \"src/**/*.ts\" --fix",
@@ -56,13 +57,13 @@
     "prepublishOnly": "pnpm build"
   },
   "dependencies": {
-    "@aws-sdk/client-s3": "^3.943.0",
-    "@aws-sdk/s3-request-presigner": "^3.943.0",
+    "@aws-sdk/client-s3": "^3.948.0",
+    "@aws-sdk/s3-request-presigner": "^3.948.0",
     "@azure/storage-blob": "^12.29.1",
     "@getbrevo/brevo": "^3.0.1",
-    "@langchain/community": "^1.0.6",
-    "@langchain/core": "^1.1.2",
-    "@langchain/langgraph": "^1.0.3",
+    "@langchain/community": "^1.0.7",
+    "@langchain/core": "^1.1.4",
+    "@langchain/langgraph": "^1.0.4",
     "@langchain/openai": "^1.1.3",
     "@langchain/textsplitters": "^1.0.1",
     "@opentelemetry/api": "^1.9.0",
@@ -76,10 +77,10 @@
     "adm-zip": "^0.5.16",
     "axios": "^1.13.2",
     "bcryptjs": "^3.0.3",
-    "bullmq": "^5.65.1",
+    "bullmq": "^5.66.0",
     "class-transformer": "^0.5.1",
     "class-validator": "^0.14.3",
-    "fast-xml-parser": "^5.3.2",
+    "fast-xml-parser": "^5.3.3",
     "fastify": "^5.6.2",
     "handlebars": "^4.7.8",
     "ioredis": "^5.8.2",
@@ -93,7 +94,7 @@
     "node-tesseract-ocr": "^2.2.1",
     "nodemailer": "^7.0.11",
     "officeparser": "^5.2.2",
-    "openai": "^6.9.1",
+    "openai": "^6.10.0",
     "passport": "^0.7.0",
     "passport-jwt": "^4.0.1",
     "pdf-parse": "^2.4.5",
@@ -124,18 +125,18 @@
     "@nestjs/bullmq": "^11.0.4",
     "@swc/core": "^1.15.3",
     "@types/bcryptjs": "^3.0.0",
-    "@types/node": "^24.10.1",
+    "@types/node": "^25.0.1",
     "@types/nodemailer": "^7.0.4",
     "@types/passport-jwt": "^4.0.1",
     "@types/qs": "^6.14.0",
     "@types/turndown": "^5.0.6",
-    "@typescript-eslint/eslint-plugin": "^8.48.1",
-    "@typescript-eslint/parser": "^8.48.1",
-    "commander": "^12.1.0",
+    "@typescript-eslint/eslint-plugin": "^8.49.0",
+    "@typescript-eslint/parser": "^8.49.0",
+    "commander": "^14.0.2",
     "eslint": "^9.39.1",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.4",
-    "glob": "^11.0.0",
+    "glob": "^13.0.0",
     "globals": "^16.5.0",
     "prettier": "^3.7.4",
     "ts-node": "^10.9.2",