@mena-emad/documind 1.0.0

package/README.md

@@ -0,0 +1,221 @@
+# DocuMind
+
+[![Version](https://img.shields.io/badge/version-1.0.0-blue)](https://github.com/mena-emad/DocuMind) [![License](https://img.shields.io/badge/license-ISC-yellow)](./LICENSE) [![Language](https://img.shields.io/badge/language-TypeScript-3178c6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+
+> Generate production-ready Swagger/OpenAPI docs from Express.js code using Gemini AI and smart context stitching.
+
+## 🚀 Why DocuMind?
+
+DocuMind is designed to fix the common problem of shallow or empty generated API docs.
+Instead of only parsing route definitions, it intelligently collects surrounding business logic so Gemini understands each endpoint in context.
+
+- Extracts routes, controllers, services, models, and validations
+- Encourages deep summaries and descriptions from Gemini
+- Prevents empty `paths` and weak documentation
+- Keeps generated output aligned with your implementation
+
+## 🎯 Showcase
+
+### Input
+A simple Express route plus related service and validation code.
+
+```ts
+// src/routes/auth.ts
+router.post('/login', authController.login);
+```
+
+### Output
+
+```yaml
+openapi: 3.0.0
+info:
+  title: DocuMind Generated API
+  version: 1.0.0
+  description: Automated OpenAPI documentation generated by DocuMind AI.
+paths:
+  /login:
+    post:
+      tags:
+        - Auth
+      summary: Authenticate user and issue a JWT token.
+      description: |
+        Verifies credentials against the hashed user password, checks authorization
+        roles, signs a JWT token, and returns a session payload.
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/LoginRequest'
+      responses:
+        '200':
+          description: User authenticated successfully.
+components:
+  schemas:
+    LoginRequest:
+      type: object
+      properties:
+        email:
+          type: string
+          format: email
+        password:
+          type: string
+```
+
+## 🧠 How it Works
+
+### Context Stitching
+DocuMind attaches nearby compute context to route files so Gemini sees the full backend flow.
+
+```mermaid
+flowchart LR
+  A[Route File] --> B[Controller Code]
+  A --> C[Service Logic]
+  A --> D[Validation / Models]
+  B --> E[AI Prompt]
+  C --> E
+  D --> E
+  E --> F[Gemini AI]
+  F --> G[OpenAPI Output]
+```
+
+### Generation Flow
+
+```mermaid
+flowchart TD
+  A[CLI Start] --> B[Parse CLI Options]
+  B --> C[Scan Project Directory]
+  C --> D[Filter Express Route Files]
+  D --> E[Collect Related Context]
+  E --> F[Call Gemini Model]
+  F --> G[Defensive Merge Output]
+  G --> H[Write swagger.yaml / json]
+```
+
+## ✨ Key Features
+
+- **Smart File Scanning**: finds Express route files across the project.
+- **Context Stitching**: includes controllers, services, models, and validation code.
+- **Defensive Merging**: merges AI-generated `paths` and `schemas` safely.
+- **Rich Descriptions**: forces Gemini to explain workflows like hashing, JWT creation, roles, and errors.
+- **Interactive CLI**: animated progress using `ora`.
+
+## 🧰 Tech Stack
+
+- Node.js (>= 18.0.0)
+- TypeScript
+- Google Gen AI SDK (`@google/genai`)
+- Commander.js
+- Ora
+- Dotenv
+- yaml
+
+## 📥 Installation
+
+### Global
+
+```bash
+npm install -g @mena-emad/documind
+```
+
+### Local
+
+```bash
+git clone https://github.com/mena-emad/DocuMind.git
+cd DocuMind
+npm install
+npm run build
+```
+
+Run in development mode:
+
+```bash
+npm run dev
+```
+
+Run locally:
+
+```bash
+npx @mena-emad/documind
+```
+
+## 🔧 Environment Variables
+
+DocuMind reads the Gemini API key from `.env`:
+
+```env
+DOCUMIND_API_KEY=your_gemini_api_key_here
+```
+
+Or pass the key directly using `-k`.
+
+## ▶️ Usage
+
+```bash
+documind [options]
+```
+
+### CLI Options
+
+| Option | Description | Default |
+|---|---|---|
+| `-k, --key <api-key>` | Gemini API Key | `DOCUMIND_API_KEY` from `.env` |
+| `-d, --dir [directory]` | Directory to scan | `./` |
+| `-o, --output [file-name]` | Output filename | `swagger.yaml` |
+| `--title [title]` | OpenAPI `info.title` | auto-generated |
+| `--api-version [version]` | OpenAPI `info.version` | auto-generated |
+| `--desc [description]` | OpenAPI `info.description` | auto-generated |
+| `-v, --version` | Show CLI version | - |
+
+### Examples
+
+Generate default output:
+
+```bash
+documind
+```
+
+Generate docs for a custom source directory:
+
+```bash
+documind -d ./src -o api-docs.yaml
+```
+
+Use the API key directly:
+
+```bash
+documind -k sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+```
+
+Provide OpenAPI metadata:
+
+```bash
+documind --title "My App API" --api-version "2.0.0" --desc "AI-generated Swagger docs from Express source code."
+```
+
+## 🔍 How DocuMind Processes Code
+
+1. **Scan files**
+   - Recursively collect `.js` and `.ts` files.
+2. **Filter Express routes**
+   - Detect route patterns and Express router usage.
+3. **Gather related context**
+   - Add matching service, controller, model, and validation files.
+4. **Ask Gemini**
+   - Send a prompt that demands valid OpenAPI JSON and rich documentation.
+5. **Merge outputs defensively**
+   - Combine returned `paths` and `components` while handling missing or malformed sections.
+6. **Write output**
+   - Save YAML or JSON based on the requested filename.
+
+## 👨‍💻 About the Author
+
+Built by **Mena Emad Sawares**.
+
+- Website: [https://menaemad.vercel.app/](https://menaemad.vercel.app/)
+- GitHub: [https://github.com/mena-emad](https://github.com/mena-emad)
+- Email: [menaemad6543@gmail.com](mailto:menaemad6543@gmail.com)
+
+## 📜 License
+
+DocuMind is released under the **ISC License**.

package/dist/cli/index.d.ts

@@ -0,0 +1,15 @@
+interface CLIOptions {
+    key?: string;
+    dir: string;
+    output: string;
+    title?: string;
+    description?: string;
+    version?: string;
+}
+/**
+ * Parses and returns command-line options for DocuMind.
+ * @returns Parsed CLI options.
+ */
+export default function parseCLI(): CLIOptions;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAEA,UAAU,UAAU;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,IAAI,UAAU,CAkB7C"}

package/dist/cli/index.js

@@ -0,0 +1,22 @@
+import { Command } from 'commander';
+/**
+ * Parses and returns command-line options for DocuMind.
+ * @returns Parsed CLI options.
+ */
+export default function parseCLI() {
+    const program = new Command();
+    program
+        .name("documind")
+        .description("AI-Powered Swagger/OpenAPI Documentation Generator for Express.js")
+        .version("1.0.0", "-v, --version", "--version for version of documind CLI");
+    program
+        .option('-d, --dir [directory]', 'The directory to scan for Express routes', './')
+        .option('-k, --key <api-key>', 'Your Gemini API Key (Alternative to .env)')
+        .option('-o, --output [file-name]', 'The output file name', 'swagger.yaml')
+        .option('--title [title]', 'API Documentation Title')
+        .option('--api-version [version]', 'API Document Version')
+        .option('--desc [description]', 'API Description');
+    program.parse(process.argv);
+    return program.opts();
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ;IAC5B,MAAM,OAAO,GAAY,IAAI,OAAO,EAAE,CAAC;IAEvC,OAAO;SACN,IAAI,CAAC,UAAU,CAAC;SAChB,WAAW,CAAC,mEAAmE,CAAC;SAChF,OAAO,CAAC,OAAO,EAAC,eAAe,EAAG,uCAAuC,CAAC,CAAC;IAE5E,OAAO;SACN,MAAM,CAAC,uBAAuB,EAAE,0CAA0C,EAAE,IAAI,CAAC;SACjF,MAAM,CAAC,qBAAqB,EAAE,2CAA2C,CAAC;SAC1E,MAAM,CAAC,0BAA0B,EAAE,sBAAsB,EAAE,cAAc,CAAC;SAC1E,MAAM,CAAC,iBAAiB,EAAE,yBAAyB,CAAC;SACpD,MAAM,CAAC,yBAAyB,EAAE,sBAAsB,CAAC;SACzD,MAAM,CAAC,sBAAsB,EAAE,iBAAiB,CAAC,CAAC;IACnD,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B,OAAO,OAAO,CAAC,IAAI,EAAc,CAAC;AACtC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,118 @@
+#!/usr/bin/env node
+import parseCLI from './cli/index.js';
+import { AIService } from './services/aiService.js';
+import scanDirectory from './parser/fileScanner.js';
+import isExpressRouteFile from './parser/routerExtractor.js';
+import { writeSwaggerFile } from './utils/fileWriter.js';
+import * as fs from 'fs';
+import * as path from 'path';
+import ora from 'ora';
+/**
+ * Entry point for the DocuMind CLI.
+ * It scans the project, sends merged route context to Gemini, merges responses, and writes the output file.
+ */
+async function main() {
+    console.log("🧠 Welcome to DocuMind! Let's build some magic...\n");
+    const options = parseCLI();
+    let aiService;
+    try {
+        aiService = new AIService(options.key);
+    }
+    catch (err) {
+        console.error(err.message);
+        process.exit(1);
+    }
+    let dirInput = './';
+    if (typeof options.dir === 'string') {
+        dirInput = options.dir;
+    }
+    const targetDir = path.resolve(dirInput);
+    const outputFileName = typeof options.output === 'string' ? options.output : 'swagger.yaml';
+    const scanSpinner = ora(`Scanning directory: ${targetDir}`).start();
+    const allFiles = scanDirectory(targetDir);
+    const validRouteFiles = allFiles.filter(file => isExpressRouteFile(file));
+    scanSpinner.succeed(`📁 Found ${allFiles.length} total files. | 🎯 ${validRouteFiles.length} Express controller/route files detected.\n`);
+    if (validRouteFiles.length === 0) {
+        console.log("⚠️ No valid Express routes or controllers detected to document.");
+        return;
+    }
+    const finalPaths = {};
+    const finalComponents = {};
+    for (const file of validRouteFiles) {
+        const fileName = path.basename(file);
+        if (fileName === 'app.js' || fileName === 'index.js' || fileName === 'server.js') {
+            continue;
+        }
+        const fileSpinner = ora(`Analyzing file: ${fileName}...`).start();
+        const fileContent = fs.readFileSync(file, 'utf8');
+        const prefix = fileName.split('.')[0] || '';
+        let additionalContext = '';
+        const relatedFiles = allFiles.filter(f => {
+            const name = path.basename(f).toLowerCase();
+            return name.startsWith(prefix.toLowerCase()) && f !== file;
+        });
+        for (const related of relatedFiles) {
+            const relName = path.basename(related);
+            if (relName.includes('service') || relName.includes('controller') || relName.includes('validation') || relName.includes('model')) {
+                fileSpinner.text = `🔗 Injecting context into ${fileName} from: ${relName}`;
+                additionalContext += `\n\n[Attached Related Context - ${relName}]:\n${fs.readFileSync(related, 'utf8')}`;
+            }
+        }
+        const totalPayload = fileContent + additionalContext;
+        fileSpinner.text = `⏳ Waiting for Gemini to generate docs for ${fileName}...`;
+        try {
+            const docResult = await aiService.generateDoc(totalPayload);
+            fileSpinner.stop();
+            fileSpinner.start(`Processing and merging JSON data for ${fileName}...`);
+            const aiJson = JSON.parse(docResult);
+            if (aiJson.paths && Object.keys(aiJson.paths).length > 0) {
+                Object.assign(finalPaths, aiJson.paths);
+            }
+            else {
+                const upperPaths = aiJson.Paths || aiJson.PATHS;
+                if (upperPaths)
+                    Object.assign(finalPaths, upperPaths);
+            }
+            if (aiJson.components) {
+                if (aiJson.components.schemas) {
+                    finalComponents.schemas = {
+                        ...finalComponents.schemas,
+                        ...aiJson.components.schemas
+                    };
+                }
+                for (const key of Object.keys(aiJson.components)) {
+                    if (key !== 'schemas') {
+                        finalComponents[key] = {
+                            ...finalComponents[key],
+                            ...aiJson.components[key]
+                        };
+                    }
+                }
+            }
+            fileSpinner.succeed(`✅ ${fileName} parsed and merged successfully.`);
+        }
+        catch (err) {
+            fileSpinner.fail(`❌ Failed to parse AI response for ${fileName}. Raw response structure invalid.`);
+        }
+    }
+    const totalData = {
+        openapi: '3.0.0',
+        paths: finalPaths,
+        ...(Object.keys(finalComponents).length > 0 ? { components: finalComponents } : {})
+    };
+    console.log('\n🚀 Final Data Object Structure Ready.');
+    const writeSpinner = ora('Writing final Swagger documentation...').start();
+    try {
+        writeSwaggerFile(outputFileName, totalData, {
+            title: typeof options.title === 'string' ? options.title : undefined,
+            version: typeof options.apiVersion === 'string' ? options.apiVersion : undefined,
+            desc: typeof options.desc === 'string' ? options.desc : undefined
+        });
+        writeSpinner.succeed(`🎉 Success! Swagger documentation saved to: ${outputFileName}`);
+    }
+    catch (writeError) {
+        writeSpinner.fail('❌ Failed to write the documentation file.');
+    }
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/parser/fileScanner.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Recursively scans a directory for JavaScript and TypeScript files.
+ * @param dir Directory to scan.
+ * @returns Array of matched file paths.
+ */
+export default function scanDirectory(dir: string): string[];
+//# sourceMappingURL=fileScanner.d.ts.map

package/dist/parser/fileScanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileScanner.d.ts","sourceRoot":"","sources":["../../src/parser/fileScanner.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAuB3D"}

package/dist/parser/fileScanner.js

@@ -0,0 +1,29 @@
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Recursively scans a directory for JavaScript and TypeScript files.
+ * @param dir Directory to scan.
+ * @returns Array of matched file paths.
+ */
+export default function scanDirectory(dir) {
+    let results = [];
+    const list = fs.readdirSync(dir);
+    list.forEach((file) => {
+        const fullPath = path.join(dir, file);
+        const stat = fs.statSync(fullPath);
+        if (file === 'node_modules' || file.startsWith('.')) {
+            return;
+        }
+        if (stat && stat.isDirectory()) {
+            results = results.concat(scanDirectory(fullPath));
+        }
+        else {
+            const ext = path.extname(fullPath);
+            if (['.js', '.ts'].includes(ext)) {
+                results.push(fullPath);
+            }
+        }
+    });
+    return results;
+}
+//# sourceMappingURL=fileScanner.js.map

package/dist/parser/fileScanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileScanner.js","sourceRoot":"","sources":["../../src/parser/fileScanner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,GAAW;IAC7C,IAAI,OAAO,GAAa,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAEjC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAClB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACtC,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAEnC,IAAI,IAAI,KAAK,cAAc,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAClD,OAAO;QACX,CAAC;QAED,IAAI,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YAC7B,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;QACtD,CAAC;aAAM,CAAC;YACJ,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACnC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC/B,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC3B,CAAC;QACL,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACnB,CAAC"}

package/dist/parser/routerExtractor.d.ts

@@ -0,0 +1,7 @@
+/**
+ * دالة ذكية تفحص محتوى الملف وتحدد هل هو ملف Express Controller/Router حقيقي يستحق الـ Documentation أم لا
+ * @param filePath المسار الكامل للملف المراد فحصه
+ * @returns boolean (true لو الملف يحتوي على كود إكسبريس حقيقي)
+ */
+export default function isExpressRouteFile(filePath: string): boolean;
+//# sourceMappingURL=routerExtractor.d.ts.map

package/dist/parser/routerExtractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routerExtractor.d.ts","sourceRoot":"","sources":["../../src/parser/routerExtractor.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAsBpE"}

package/dist/parser/routerExtractor.js

@@ -0,0 +1,27 @@
+import * as fs from 'fs';
+/**
+ * دالة ذكية تفحص محتوى الملف وتحدد هل هو ملف Express Controller/Router حقيقي يستحق الـ Documentation أم لا
+ * @param filePath المسار الكامل للملف المراد فحصه
+ * @returns boolean (true لو الملف يحتوي على كود إكسبريس حقيقي)
+ */
+export default function isExpressRouteFile(filePath) {
+    if (filePath.endsWith('.d.ts') ||
+        filePath.includes('.test.') ||
+        filePath.includes('.spec.') ||
+        filePath.endsWith('tsconfig.json') ||
+        filePath.endsWith('package.json')) {
+        return false;
+    }
+    try {
+        const content = fs.readFileSync(filePath, 'utf8');
+        const hasExpress = content.includes('express');
+        const hasRouter = content.includes('Router') || content.includes('router.');
+        const hasHttpMethods = /router\.(get|post|put|delete|patch)/i.test(content) || /app\.(get|post|put|delete|patch)/i.test(content);
+        const hasReqRes = content.includes('req,res') && content.includes('request,response');
+        return (hasExpress && hasRouter) || hasHttpMethods || hasReqRes;
+    }
+    catch (error) {
+        return false;
+    }
+}
+//# sourceMappingURL=routerExtractor.js.map

package/dist/parser/routerExtractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routerExtractor.js","sourceRoot":"","sources":["../../src/parser/routerExtractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,QAAgB;IACvD,IACI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;QAC1B,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC3B,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC3B,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC;QAClC,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,EACnC,CAAC;QACC,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,IAAI,CAAC;QACD,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAClD,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC5E,MAAM,cAAc,GAAG,sCAAsC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,mCAAmC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjI,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;QAEtF,OAAO,CAAC,UAAU,IAAI,SAAS,CAAC,IAAI,cAAc,IAAI,SAAS,CAAC;IACpE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC"}

package/dist/services/aiService.d.ts

@@ -0,0 +1,14 @@
+/**
+ * AIService wraps the Google Gemini client to generate OpenAPI documentation.
+ */
+export declare class AIService {
+    private ai;
+    constructor(apiKey?: string);
+    /**
+     * Generates documentation output for the provided source code context.
+     * @param fileContent Combined route file content and attached context.
+     * @returns A JSON string representing the generated OpenAPI payload.
+     */
+    generateDoc(fileContent: string): Promise<string>;
+}
+//# sourceMappingURL=aiService.d.ts.map

package/dist/services/aiService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiService.d.ts","sourceRoot":"","sources":["../../src/services/aiService.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,EAAE,CAAc;gBAEZ,MAAM,CAAC,EAAE,MAAM;IAQ3B;;;;OAIG;IACG,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAsDxD"}

package/dist/services/aiService.js

@@ -0,0 +1,75 @@
+import { GoogleGenAI } from '@google/genai';
+import * as dotenv from 'dotenv';
+import * as path from 'path';
+dotenv.config({ path: path.resolve(process.cwd(), '.env') });
+/**
+ * AIService wraps the Google Gemini client to generate OpenAPI documentation.
+ */
+export class AIService {
+    ai;
+    constructor(apiKey) {
+        const key = apiKey || process.env.DOCUMIND_API_KEY;
+        if (!key) {
+            throw new Error('❌ Gemini API Key is missing! Please provide it via -k or set DOCUMIND_API_KEY environment variable.');
+        }
+        this.ai = new GoogleGenAI({ apiKey: key });
+    }
+    /**
+     * Generates documentation output for the provided source code context.
+     * @param fileContent Combined route file content and attached context.
+     * @returns A JSON string representing the generated OpenAPI payload.
+     */
+    async generateDoc(fileContent) {
+        const prompt = `
+You are an expert Senior Backend Engineer and a world-class OpenAPI/Swagger Architect.
+Analyze the following Express.js source code (including its routes, controllers, and validations).
+
+Your absolute main task is to extract all API endpoints, methods, and schemas to populate a valid OpenAPI 3.0 JSON object.
+
+Strict Instructions for High-Quality Documentation:
+1. **DO NOT return an empty paths object**. You must extract the routes found in the code (e.g., /register, /login, /logout, /profile).
+2. **RICH DESCRIPTIONS AND SUMMARIES (CRITICAL)**: For every single operation (get, post, put, delete, etc.) under each route, you MUST include:
+   - "summary": A short, clear, one-sentence explanation of what the endpoint does.
+   - "description": A highly detailed paragraph explaining the inner mechanics and business logic of the endpoint. For example, explain if it performs password hashing, check if user exists, generates a JWT session token, or requires specific middleware/roles. Do not make it generic.
+3. For each route, trace its controller function to document the expected request body, parameters, and HTTP response status codes (like 200, 201, 400, 401, 500) with descriptive answers for each status.
+4. Extract payload fields into components.schemas.
+5. **CRITICAL REGEX HANDLING**: If you write any regular expressions inside string patterns, double-escape all backslashes (use \\\\ instead of \\) so the output is perfectly valid JSON.
+6. Return ONLY a valid JSON object matching this schema style:
+{
+  "paths": {
+    "/api/route": {
+      "post": {
+        "tags": ["Auth"],
+        "summary": "...",
+        "description": "...",
+        "requestBody": { ... },
+        "responses": { ... }
+      }
+    }
+  },
+  "components": {
+    "schemas": { ... }
+  }
+}
+`;
+        try {
+            const response = await this.ai.models.generateContent({
+                model: 'gemini-2.5-flash',
+                contents: [prompt, fileContent],
+                config: {
+                    responseMimeType: 'application/json'
+                }
+            });
+            let cleanText = response.text || '{}';
+            if (cleanText.includes('```')) {
+                cleanText = cleanText.replace(/```json/g, '').replace(/```/g, '').trim();
+            }
+            return cleanText;
+        }
+        catch (apiError) {
+            console.error(`\n❌ Gemini API Error: ${apiError.message}`);
+            return '{}';
+        }
+    }
+}
+//# sourceMappingURL=aiService.js.map

package/dist/services/aiService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiService.js","sourceRoot":"","sources":["../../src/services/aiService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;AAE7D;;GAEG;AACH,MAAM,OAAO,SAAS;IACZ,EAAE,CAAc;IAExB,YAAY,MAAe;QACzB,MAAM,GAAG,GAAG,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;QACnD,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,qGAAqG,CAAC,CAAC;QACzH,CAAC;QACD,IAAI,CAAC,EAAE,GAAG,IAAI,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,WAAW,CAAC,WAAmB;QACnC,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BlB,CAAC;QAEE,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC;gBACpD,KAAK,EAAE,kBAAkB;gBACzB,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC;gBAC/B,MAAM,EAAE;oBACN,gBAAgB,EAAE,kBAAkB;iBACrC;aACF,CAAC,CAAC;YAEH,IAAI,SAAS,GAAG,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC;YACtC,IAAI,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9B,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAC3E,CAAC;YAED,OAAO,SAAS,CAAC;QACnB,CAAC;QAAC,OAAO,QAAa,EAAE,CAAC;YACvB,OAAO,CAAC,KAAK,CAAC,yBAAyB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;YAC3D,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;CACF"}

package/dist/utils/fileWriter.d.ts

@@ -0,0 +1,14 @@
+interface SwaggerOptions {
+    title?: string | undefined;
+    version?: string | undefined;
+    desc?: string | undefined;
+}
+/**
+ * Writes an OpenAPI document as YAML or JSON to disk.
+ * @param outputPath Destination file path.
+ * @param pathsData Merged OpenAPI paths and components.
+ * @param options Title, version, and description metadata.
+ */
+export declare function writeSwaggerFile(outputPath: string, pathsData: Record<string, any>, options: SwaggerOptions): void;
+export {};
+//# sourceMappingURL=fileWriter.d.ts.map

package/dist/utils/fileWriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileWriter.d.ts","sourceRoot":"","sources":["../../src/utils/fileWriter.ts"],"names":[],"mappings":"AAIA,UAAU,cAAc;IACtB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAsClH"}

package/dist/utils/fileWriter.js

@@ -0,0 +1,48 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import yaml from 'yaml';
+/**
+ * Writes an OpenAPI document as YAML or JSON to disk.
+ * @param outputPath Destination file path.
+ * @param pathsData Merged OpenAPI paths and components.
+ * @param options Title, version, and description metadata.
+ */
+export function writeSwaggerFile(outputPath, pathsData, options) {
+    let localTitle = 'DocuMind Generated API';
+    let localVersion = '1.0.0';
+    let localDesc = 'Automated OpenAPI documentation generated by DocuMind AI.';
+    try {
+        const localPackageJsonPath = path.resolve('./package.json');
+        if (fs.existsSync(localPackageJsonPath)) {
+            const pkg = JSON.parse(fs.readFileSync(localPackageJsonPath, 'utf8'));
+            if (pkg.name)
+                localTitle = `${pkg.name} API Documentation`;
+            if (pkg.version)
+                localVersion = pkg.version;
+            if (pkg.description)
+                localDesc = pkg.description;
+        }
+    }
+    catch (e) { }
+    const swaggerDoc = {
+        openapi: '3.0.0',
+        info: {
+            title: options.title || localTitle,
+            version: options.version || localVersion,
+            description: options.desc || localDesc
+        },
+        ...pathsData
+    };
+    const fullPath = path.resolve(outputPath);
+    const fileExtension = path.extname(fullPath).toLowerCase();
+    let fileContent;
+    if (fileExtension === '.yaml' || fileExtension === '.yml') {
+        fileContent = yaml.stringify(swaggerDoc);
+    }
+    else {
+        fileContent = JSON.stringify(swaggerDoc, null, 2);
+    }
+    fs.writeFileSync(fullPath, fileContent, 'utf8');
+    console.log(`\n🎉 Success! Swagger documentation saved to: ${fullPath}`);
+}
+//# sourceMappingURL=fileWriter.js.map

package/dist/utils/fileWriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileWriter.js","sourceRoot":"","sources":["../../src/utils/fileWriter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AAQxB;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAkB,EAAE,SAA8B,EAAE,OAAuB;IACxG,IAAI,UAAU,GAAG,wBAAwB,CAAC;IAC1C,IAAI,YAAY,GAAG,OAAO,CAAC;IAC3B,IAAI,SAAS,GAAG,2DAA2D,CAAC;IAE5E,IAAI,CAAC;QACD,MAAM,oBAAoB,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAC5D,IAAI,EAAE,CAAC,UAAU,CAAC,oBAAoB,CAAC,EAAE,CAAC;YACtC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC,CAAC;YACtE,IAAI,GAAG,CAAC,IAAI;gBAAE,UAAU,GAAG,GAAG,GAAG,CAAC,IAAI,oBAAoB,CAAC;YAC3D,IAAI,GAAG,CAAC,OAAO;gBAAE,YAAY,GAAG,GAAG,CAAC,OAAO,CAAC;YAC5C,IAAI,GAAG,CAAC,WAAW;gBAAE,SAAS,GAAG,GAAG,CAAC,WAAW,CAAC;QACrD,CAAC;IACL,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC,CAAA,CAAC;IAEd,MAAM,UAAU,GAAG;QACf,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE;YACF,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,UAAU;YAClC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,YAAY;YACxC,WAAW,EAAE,OAAO,CAAC,IAAI,IAAI,SAAS;SACzC;QACD,GAAG,SAAS;KACf,CAAC;IAEF,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC1C,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IAE3D,IAAI,WAAmB,CAAC;IAExB,IAAI,aAAa,KAAK,OAAO,IAAI,aAAa,KAAK,MAAM,EAAE,CAAC;QACxD,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAC7C,CAAC;SAAM,CAAC;QACJ,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,iDAAiD,QAAQ,EAAE,CAAC,CAAC;AAC7E,CAAC"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@mena-emad/documind",
+  "version": "1.0.0",
+  "description": "AI-Powered Swagger/OpenAPI Documentation Generator for Express.js projects with intelligent context stitching.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "bin": {
+    "documind": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "cli",
+    "swagger",
+    "openapi",
+    "express",
+    "gemini",
+    "ai",
+    "automation",
+    "documentation"
+  ],
+  "author": {
+    "name": "Mena Emad Sawares",
+    "url": "https://menaemad.vercel.app/",
+    "email": "menaemad6543@gmail.com",
+    "github": "https://github.com/mena-emad"
+  },
+  "license": "ISC",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0"
+  },
+  "dependencies": {
+    "@google/genai": "^0.1.2",
+    "commander": "^13.1.0",
+    "dotenv": "^16.4.7",
+    "ora": "^8.1.1",
+    "yaml": "^2.7.0"
+  }
+}