nest-scramble 1.1.1 → 1.2.0

package/README.md

@@ -55,9 +55,31 @@ Nest-Scramble is engineered using cutting-edge static analysis techniques that t
 
 This approach delivers what runtime reflection simply cannot: perfect accuracy, zero overhead, and future-proof compatibility with TypeScript's evolving type system.
 
-## ⚡ Quick Start (3 Steps)
+## ⚡ Quick Start - Zero Config (2 Steps!)
 
-### 1. Install the Package
+### Option A: Auto-Injection (Recommended - 30 seconds!)
+
+```bash
+# 1. Install
+npm install nest-scramble
+
+# 2. Auto-inject into your project
+npx nest-scramble init
+
+# 3. Start your app
+npm run start:dev
+
+# 🎉 Done! Visit http://localhost:3000/docs
+```
+
+The `init` command automatically:
+- ✅ Adds the import statement to your `app.module.ts`
+- ✅ Injects `NestScrambleModule.forRoot()` into your imports
+- ✅ Uses smart defaults with zero configuration needed
+
+### Option B: Manual Installation (3 Steps)
+
+#### 1. Install the Package
 
 ```bash
 # Using npm
@@ -70,42 +92,73 @@ yarn add nest-scramble
 pnpm add nest-scramble
 ```
 
-### 2. Import Module in Your NestJS App
+#### 2. Import Module in Your NestJS App
+
+**Zero-Config (Recommended):**
+```typescript
+import { Module } from '@nestjs/common';
+import { NestScrambleModule } from 'nest-scramble';
 
-Open your `app.module.ts` (or main module) and add:
+@Module({
+  imports: [
+    NestScrambleModule.forRoot(), // 🎯 That's it! Zero config needed
+  ],
+})
+export class AppModule {}
+```
 
+**With Custom Options:**
 ```typescript
 import { Module } from '@nestjs/common';
 import { NestScrambleModule } from 'nest-scramble';
 
 @Module({
   imports: [
-    // Your other modules...
     NestScrambleModule.forRoot({
-      sourcePath: 'src',           // Path to your source code
-      baseUrl: 'http://localhost:3000',
-      enableMock: true,            // Enable mock endpoints
-      autoExportPostman: false,    // Auto-generate Postman collection
+      sourcePath: 'src',              // Auto-detected by default
+      baseUrl: 'http://localhost:3000', // Auto-detected from PORT env
+      enableMock: true,               // Enabled by default
+      autoExportPostman: false,       // Disabled by default
+      apiTitle: 'My API',             // Auto-detected from package.json
+      apiVersion: '1.0.0',            // Auto-detected from package.json
     }),
   ],
 })
 export class AppModule {}
 ```
 
-### 3. Start Your App and Visit Documentation
+#### 3. Start Your App and Visit Documentation
 
 ```bash
 npm run start:dev
 ```
 
+You'll see a beautiful dashboard in your terminal:
+
+```
+┌──────────────────────────────────────────────────────────┐
+│  🚀 Nest-Scramble by Mohamed Mustafa is Active!          │
+├──────────────────────────────────────────────────────────┤
+│  📖 Docs: http://localhost:3000/docs                     │
+│  📄 JSON: http://localhost:3000/docs-json                │
+│  🎭 Mock: http://localhost:3000/scramble-mock            │
+│  ✨ Scanning: src                                        │
+│  🎯 Controllers: 5                                       │
+└──────────────────────────────────────────────────────────┘
+```
+
 Then open your browser:
 
 - **📖 Interactive API Docs (Scalar UI)**: http://localhost:3000/docs
 - **📄 OpenAPI JSON Spec**: http://localhost:3000/docs-json
 - **🎭 Mock Endpoints**: http://localhost:3000/scramble-mock/*
-- **📤 Postman Collection**: Auto-generated at `collection.json` (if enabled)
 
-**That's it!** Nest-Scramble will automatically scan your controllers and generate beautiful documentation.
+**That's it!** Nest-Scramble automatically:
+- 🔍 Detects your project structure
+- 📂 Finds your controllers
+- 📝 Generates OpenAPI spec
+- 🎨 Serves beautiful documentation
+- 🎭 Provides mock endpoints
 
 ## ⚙️ Configuration Options
 
@@ -177,26 +230,119 @@ GET /scramble-mock/users/123
 ## 🔧 Advanced Usage
 
 ### CLI Generation
+
+The Nest-Scramble CLI allows you to generate API documentation without running your NestJS application.
+
+#### Generate OpenAPI Specification
+
+```bash
+# Using npx
+npx nest-scramble generate src
+
+# Using pnpm dlx
+pnpm dlx nest-scramble generate src
+
+# Using yarn dlx
+yarn dlx nest-scramble generate src
+```
+
+#### CLI Options
+
+```bash
+nest-scramble generate <sourcePath> [options]
+
+Options:
+  -o, --output <file>         Output file path (default: "openapi.json")
+  -f, --format <type>         Output format: openapi or postman (default: "openapi")
+  -b, --baseUrl <url>         Base URL for the API (default: "http://localhost:3000")
+  -t, --title <title>         API title (default: "NestJS API")
+  -v, --apiVersion <version>  API version (default: "1.0.0")
+  -h, --help                  Display help for command
+```
+
+#### Examples
+
+**Generate OpenAPI JSON:**
 ```bash
-pnpm dlx nest-scramble generate src --output my-api.json
+pnpm dlx nest-scramble generate src --output openapi.json
+```
+
+**Generate Postman Collection:**
+```bash
+pnpm dlx nest-scramble generate src --format postman --output collection.json
+```
+
+**Custom API Details:**
+```bash
+pnpm dlx nest-scramble generate src \
+  --output my-api.json \
+  --title "My Awesome API" \
+  --apiVersion "2.0.0" \
+  --baseUrl "https://api.example.com"
+```
+
+**Check Version:**
+```bash
+pnpm dlx nest-scramble --version
 ```
 
 ### Programmatic API
+
+Use Nest-Scramble programmatically in your Node.js scripts:
+
 ```typescript
-import { ScannerService, OpenApiTransformer } from 'nest-scramble';
+import { ScannerService, OpenApiTransformer, PostmanCollectionGenerator } from 'nest-scramble';
+import * as fs from 'fs';
 
+// Scan controllers
 const scanner = new ScannerService();
 const controllers = scanner.scanControllers('src');
 
-const transformer = new OpenApiTransformer();
-const spec = transformer.transform(controllers);
+// Generate OpenAPI spec
+const transformer = new OpenApiTransformer('http://localhost:3000');
+const openApiSpec = transformer.transform(
+  controllers,
+  'My API',
+  '1.0.0',
+  'http://localhost:3000'
+);
+
+// Save to file
+fs.writeFileSync('openapi.json', JSON.stringify(openApiSpec, null, 2));
+
+// Or generate Postman collection
+const postmanGen = new PostmanCollectionGenerator('http://localhost:3000');
+const collection = postmanGen.generateCollection(controllers);
+fs.writeFileSync('collection.json', JSON.stringify(collection, null, 2));
 ```
 
-### Watch Mode
-```bash
-pnpm run watch-generate
+### CI/CD Integration
+
+Add to your CI/CD pipeline to auto-generate documentation:
+
+```yaml
+# .github/workflows/docs.yml
+name: Generate API Docs
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  generate-docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-node@v3
+        with:
+          node-version: '18'
+      - run: npm install
+      - run: npx nest-scramble generate src --output openapi.json
+      - uses: actions/upload-artifact@v3
+        with:
+          name: api-docs
+          path: openapi.json
 ```
-Automatically regenerates docs on file changes.
 
 ## 🎨 Documentation UI
 
@@ -335,7 +481,73 @@ npm install
 npm run build
 ```
 
-#### 4. **pnpm Dependency Conflicts**
+#### 4. **"Unauthorized" (401) Error on /docs Endpoint**
+
+If you have a Global AuthGuard and get 401 Unauthorized when accessing `/docs` or `/docs-json`:
+
+**Solution:**
+
+Nest-Scramble automatically marks its documentation endpoints as public using `@SetMetadata('isPublic', true)`. However, your AuthGuard needs to respect this metadata.
+
+Update your AuthGuard to check for the `isPublic` metadata:
+
+```typescript
+import { Injectable, ExecutionContext } from '@nestjs/common';
+import { Reflector } from '@nestjs/core';
+import { AuthGuard } from '@nestjs/passport';
+
+@Injectable()
+export class JwtAuthGuard extends AuthGuard('jwt') {
+  constructor(private reflector: Reflector) {
+    super();
+  }
+
+  canActivate(context: ExecutionContext) {
+    // Check if route is marked as public
+    const isPublic = this.reflector.getAllAndOverride<boolean>('isPublic', [
+      context.getHandler(),
+      context.getClass(),
+    ]);
+    
+    if (isPublic) {
+      return true; // Allow access to public routes
+    }
+    
+    return super.canActivate(context);
+  }
+}
+```
+
+**Alternative Solution - Exclude /docs path:**
+
+```typescript
+import { Module } from '@nestjs/common';
+import { APP_GUARD } from '@nestjs/core';
+
+@Module({
+  providers: [
+    {
+      provide: APP_GUARD,
+      useClass: JwtAuthGuard,
+    },
+  ],
+})
+export class AppModule {}
+
+// In your AuthGuard:
+canActivate(context: ExecutionContext) {
+  const request = context.switchToHttp().getRequest();
+  
+  // Skip authentication for documentation endpoints
+  if (request.url.startsWith('/docs')) {
+    return true;
+  }
+  
+  return super.canActivate(context);
+}
+```
+
+#### 5. **pnpm Dependency Conflicts**
 
 If using pnpm and getting peer dependency warnings:
 
@@ -345,7 +557,7 @@ Nest-Scramble v1.1.0+ properly declares peer dependencies. Update to the latest
 pnpm update nest-scramble
 ```
 
-#### 5. **Controllers Not Being Scanned**
+#### 6. **Controllers Not Being Scanned**
 
 The scanner looks in your **host project's** `src` folder, not the library's folder.
 
@@ -360,7 +572,7 @@ The scanner looks in your **host project's** `src` folder, not the library's fol
 
 3. Verify your `tsconfig.json` exists in the project root
 
-#### 6. **Mock Endpoints Not Working**
+#### 7. **Mock Endpoints Not Working**
 
 If `/scramble-mock/*` returns 404:
 
@@ -369,7 +581,7 @@ If `/scramble-mock/*` returns 404:
 - The middleware applies to all routes matching `/scramble-mock/*`
 - Example: `http://localhost:3000/scramble-mock/users/123`
 
-#### 7. **OpenAPI Spec is Empty or Incomplete**
+#### 8. **OpenAPI Spec is Empty or Incomplete**
 
 **Solution:**
 - Ensure your DTOs are TypeScript classes or interfaces (not plain objects)

package/dist/NestScrambleModule.d.ts

@@ -1,5 +1,5 @@
 /** Nest-Scramble | Developed by Mohamed Mustafa | MIT License **/
-import { DynamicModule, MiddlewareConsumer } from '@nestjs/common';
+import { DynamicModule, MiddlewareConsumer, OnModuleInit } from '@nestjs/common';
 export interface NestScrambleOptions {
     path?: string;
     enableMock?: boolean;
@@ -7,8 +7,14 @@ export interface NestScrambleOptions {
     postmanOutputPath?: string;
     baseUrl?: string;
     sourcePath?: string;
+    apiTitle?: string;
+    apiVersion?: string;
 }
-export declare class NestScrambleModule {
+export declare class NestScrambleModule implements OnModuleInit {
+    private static moduleOptions;
+    private static detectedPort;
+    onModuleInit(): void;
+    private displayDashboard;
     static forRoot(options?: NestScrambleOptions): DynamicModule;
     static forRootAsync(options?: NestScrambleOptions): DynamicModule;
     configure(consumer: MiddlewareConsumer): void;

package/dist/NestScrambleModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NestScrambleModule.d.ts","sourceRoot":"","sources":["../src/NestScrambleModule.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAyB,MAAM,gBAAgB,CAAC;AAQ1F,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBACa,kBAAkB;IAC7B,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,mBAAwB,GAAG,aAAa;IAmEhE,MAAM,CAAC,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,aAAa;IAKrE,SAAS,CAAC,QAAQ,EAAE,kBAAkB;CAMvC"}
+{"version":3,"file":"NestScrambleModule.d.ts","sourceRoot":"","sources":["../src/NestScrambleModule.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAU,YAAY,EAAiB,MAAM,gBAAgB,CAAC;AASxG,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBACa,kBAAmB,YAAW,YAAY;IACrD,OAAO,CAAC,MAAM,CAAC,aAAa,CAA2B;IACvD,OAAO,CAAC,MAAM,CAAC,YAAY,CAAgB;IAE3C,YAAY;IAIZ,OAAO,CAAC,gBAAgB;IAkBxB,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,mBAAwB,GAAG,aAAa;IA4EhE,MAAM,CAAC,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,aAAa;IAKrE,SAAS,CAAC,QAAQ,EAAE,kBAAkB;CAMvC"}

package/dist/NestScrambleModule.js

@@ -16,35 +16,65 @@ const ScannerService_1 = require("./scanner/ScannerService");
 const MockGenerator_1 = require("./utils/MockGenerator");
 const OpenApiTransformer_1 = require("./utils/OpenApiTransformer");
 const DocsController_1 = require("./controllers/DocsController");
+const AutoDetector_1 = require("./utils/AutoDetector");
 let NestScrambleModule = NestScrambleModule_1 = class NestScrambleModule {
+    onModuleInit() {
+        this.displayDashboard();
+    }
+    displayDashboard() {
+        const port = NestScrambleModule_1.detectedPort;
+        const options = NestScrambleModule_1.moduleOptions;
+        const projectStructure = AutoDetector_1.AutoDetector.detectProjectStructure();
+        console.log('\n┌──────────────────────────────────────────────────────────┐');
+        console.log('│  🚀 Nest-Scramble by Mohamed Mustafa is Active!          │');
+        console.log('├──────────────────────────────────────────────────────────┤');
+        console.log(`│  📖 Docs: http://localhost:${port}/docs${' '.repeat(Math.max(0, 26 - port.toString().length))}│`);
+        console.log(`│  📄 JSON: http://localhost:${port}/docs-json${' '.repeat(Math.max(0, 21 - port.toString().length))}│`);
+        if (options.enableMock !== false) {
+            console.log(`│  🎭 Mock: http://localhost:${port}/scramble-mock${' '.repeat(Math.max(0, 16 - port.toString().length))}│`);
+        }
+        console.log(`│  ✨ Scanning: ${projectStructure.sourcePath}${' '.repeat(Math.max(0, 43 - projectStructure.sourcePath.length))}│`);
+        console.log(`│  🎯 Controllers: ${projectStructure.controllerPaths.length}${' '.repeat(Math.max(0, 40 - projectStructure.controllerPaths.length.toString().length))}│`);
+        console.log('└──────────────────────────────────────────────────────────┘\n');
+    }
     static forRoot(options = {}) {
-        const { path = '/docs', enableMock = true, autoExportPostman = false, postmanOutputPath = 'collection.json', baseUrl = 'http://localhost:3000', sourcePath = 'src', } = options;
+        // Auto-detect project structure
+        const projectStructure = AutoDetector_1.AutoDetector.detectProjectStructure();
+        // Smart defaults with auto-detection
+        const config = {
+            path: options.path || '/docs',
+            enableMock: options.enableMock !== undefined ? options.enableMock : true,
+            autoExportPostman: options.autoExportPostman || false,
+            postmanOutputPath: options.postmanOutputPath || 'collection.json',
+            baseUrl: options.baseUrl || AutoDetector_1.AutoDetector.detectBaseUrl(),
+            sourcePath: options.sourcePath || projectStructure.sourcePath,
+            apiTitle: options.apiTitle || AutoDetector_1.AutoDetector.getAppName(),
+            apiVersion: options.apiVersion || AutoDetector_1.AutoDetector.getAppVersion(),
+        };
+        // Store for dashboard display
+        NestScrambleModule_1.moduleOptions = config;
+        NestScrambleModule_1.detectedPort = AutoDetector_1.AutoDetector.detectPort();
         console.log(`\n${'='.repeat(60)}`);
-        console.log(`🚀 [Nest-Scramble] Initializing Documentation Engine`);
+        console.log(`🚀 [Nest-Scramble] Zero-Config Auto-Detection Engine`);
         console.log(`   Developed by Mohamed Mustafa | MIT License`);
         console.log(`${'='.repeat(60)}`);
+        console.log(`\n[Nest-Scramble] 🔍 Auto-detected project structure:`);
+        console.log(`   Root: ${projectStructure.rootPath}`);
+        console.log(`   Source: ${config.sourcePath}`);
+        console.log(`   Config: ${projectStructure.tsConfigPath}`);
         const scanner = new ScannerService_1.ScannerService();
-        const controllers = scanner.scanControllers(sourcePath);
-        console.log(`\n[Nest-Scramble] Generating OpenAPI specification...`);
-        const transformer = new OpenApiTransformer_1.OpenApiTransformer(baseUrl);
-        const openApiSpec = transformer.transform(controllers, 'NestJS API', '1.0.0', baseUrl);
-        console.log(`[Nest-Scramble] OpenAPI spec generated successfully`);
-        if (autoExportPostman) {
-            console.log(`[Nest-Scramble] Exporting Postman collection...`);
-            const generator = new PostmanCollectionGenerator_1.PostmanCollectionGenerator(baseUrl);
+        const controllers = scanner.scanControllers(config.sourcePath);
+        console.log(`\n[Nest-Scramble] 📦 Generating OpenAPI specification...`);
+        const transformer = new OpenApiTransformer_1.OpenApiTransformer(config.baseUrl);
+        const openApiSpec = transformer.transform(controllers, config.apiTitle, config.apiVersion, config.baseUrl);
+        console.log(`[Nest-Scramble] ✅ OpenAPI spec generated successfully`);
+        if (config.autoExportPostman) {
+            console.log(`[Nest-Scramble] 📤 Exporting Postman collection...`);
+            const generator = new PostmanCollectionGenerator_1.PostmanCollectionGenerator(config.baseUrl);
             const collection = generator.generateCollection(controllers);
-            require('fs').writeFileSync(postmanOutputPath, JSON.stringify(collection, null, 2));
-            console.log(`[Nest-Scramble] ✓ Postman collection exported to ${postmanOutputPath}`);
-        }
-        const port = baseUrl.split(':').pop() || '3000';
-        console.log(`\n${'='.repeat(60)}`);
-        console.log(`✅ [Nest-Scramble] Ready!`);
-        console.log(`📚 API Docs available at: http://localhost:${port}/docs`);
-        console.log(`📄 OpenAPI JSON at: http://localhost:${port}/docs-json`);
-        if (enableMock) {
-            console.log(`🎭 Mock endpoints at: http://localhost:${port}/scramble-mock/*`);
+            require('fs').writeFileSync(config.postmanOutputPath, JSON.stringify(collection, null, 2));
+            console.log(`[Nest-Scramble] ✓ Postman collection exported to ${config.postmanOutputPath}`);
         }
-        console.log(`${'='.repeat(60)}\n`);
         return {
             module: NestScrambleModule_1,
             providers: [
@@ -62,7 +92,7 @@ let NestScrambleModule = NestScrambleModule_1 = class NestScrambleModule {
                 },
                 {
                     provide: 'NEST_SCRAMBLE_OPTIONS',
-                    useValue: options,
+                    useValue: config,
                 },
             ],
             exports: [ScannerService_1.ScannerService, PostmanCollectionGenerator_1.PostmanCollectionGenerator, OpenApiTransformer_1.OpenApiTransformer],
@@ -82,6 +112,8 @@ let NestScrambleModule = NestScrambleModule_1 = class NestScrambleModule {
     }
 };
 exports.NestScrambleModule = NestScrambleModule;
+NestScrambleModule.moduleOptions = {};
+NestScrambleModule.detectedPort = 3000;
 exports.NestScrambleModule = NestScrambleModule = NestScrambleModule_1 = __decorate([
     (0, common_1.Module)({})
 ], NestScrambleModule);

package/dist/NestScrambleModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"NestScrambleModule.js","sourceRoot":"","sources":["../src/NestScrambleModule.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,kEAAkE;AAClE,2CAA0F;AAC1F,wFAAqF;AACrF,gEAA6D;AAC7D,6DAA0D;AAC1D,yDAAsD;AACtD,mEAAgE;AAChE,iEAA8D;AAYvD,IAAM,kBAAkB,0BAAxB,MAAM,kBAAkB;IAC7B,MAAM,CAAC,OAAO,CAAC,UAA+B,EAAE;QAC9C,MAAM,EACJ,IAAI,GAAG,OAAO,EACd,UAAU,GAAG,IAAI,EACjB,iBAAiB,GAAG,KAAK,EACzB,iBAAiB,GAAG,iBAAiB,EACrC,OAAO,GAAG,uBAAuB,EACjC,UAAU,GAAG,KAAK,GACnB,GAAG,OAAO,CAAC;QAEZ,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;QACpE,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;QAC7D,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAEjC,MAAM,OAAO,GAAG,IAAI,+BAAc,EAAE,CAAC;QACrC,MAAM,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;QAExD,OAAO,CAAC,GAAG,CAAC,uDAAuD,CAAC,CAAC;QACrE,MAAM,WAAW,GAAG,IAAI,uCAAkB,CAAC,OAAO,CAAC,CAAC;QACpD,MAAM,WAAW,GAAG,WAAW,CAAC,SAAS,CAAC,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACvF,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;QAEnE,IAAI,iBAAiB,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;YAC/D,MAAM,SAAS,GAAG,IAAI,uDAA0B,CAAC,OAAO,CAAC,CAAC;YAC1D,MAAM,UAAU,GAAG,SAAS,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;YAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,aAAa,CAAC,iBAAiB,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACpF,OAAO,CAAC,GAAG,CAAC,oDAAoD,iBAAiB,EAAE,CAAC,CAAC;QACvF,CAAC;QAED,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,MAAM,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,8CAA8C,IAAI,OAAO,CAAC,CAAC;QACvE,OAAO,CAAC,GAAG,CAAC,wCAAwC,IAAI,YAAY,CAAC,CAAC;QACtE,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CAAC,0CAA0C,IAAI,kBAAkB,CAAC,CAAC;QAChF,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QAEnC,OAAO;YACL,MAAM,EAAE,oBAAkB;YAC1B,SAAS,EAAE;gBACT,+BAAc;gBACd,uDAA0B;gBAC1B,uCAAkB;gBAClB,6BAAa;gBACb;oBACE,OAAO,EAAE,2BAA2B;oBACpC,QAAQ,EAAE,WAAW;iBACtB;gBACD;oBACE,OAAO,EAAE,uBAAuB;oBAChC,QAAQ,EAAE,WAAW;iBACtB;gBACD;oBACE,OAAO,EAAE,uBAAuB;oBAChC,QAAQ,EAAE,OAAO;iBAClB;aACF;YACD,OAAO,EAAE,CAAC,+BAAc,EAAE,uDAA0B,EAAE,uCAAkB,CAAC;YACzE,WAAW,EAAE,CAAC,+BAAc,CAAC;YAC7B,OAAO,EAAE,EAAE;SACZ,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,UAA+B,EAAE;QACnD,wDAAwD;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED,SAAS,CAAC,QAA4B;QACpC,mCAAmC;QACnC,QAAQ;aACL,KAAK,CAAC,+BAAc,CAAC;aACrB,SAAS,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,sBAAa,CAAC,GAAG,EAAE,CAAC,CAAC;IACvE,CAAC;CACF,CAAA;AA/EY,gDAAkB;6BAAlB,kBAAkB;IAD9B,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,kBAAkB,CA+E9B"}
+{"version":3,"file":"NestScrambleModule.js","sourceRoot":"","sources":["../src/NestScrambleModule.ts"],"names":[],"mappings":"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"}

package/dist/cli.js

@@ -40,36 +40,145 @@ const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const PostmanCollectionGenerator_1 = require("./generators/PostmanCollectionGenerator");
 const ScannerService_1 = require("./scanner/ScannerService");
+const OpenApiTransformer_1 = require("./utils/OpenApiTransformer");
+const packageJson = require('../package.json');
 const program = new commander_1.Command();
 program
     .name('nest-scramble')
     .description('Zero-config API Documentation & Postman Generator for NestJS')
-    .version('1.0.0');
+    .version(packageJson.version);
 program
     .command('generate')
-    .description('Generate Postman collection from NestJS project')
+    .description('Generate API documentation from NestJS project')
     .argument('<sourcePath>', 'Path to the source directory (e.g., src)')
-    .option('-o, --output <file>', 'Output file path', 'collection.json')
-    .option('-b, --baseUrl <url>', 'Base URL for the API', '{{baseUrl}}')
+    .option('-o, --output <file>', 'Output file path', 'openapi.json')
+    .option('-f, --format <type>', 'Output format: openapi or postman', 'openapi')
+    .option('-b, --baseUrl <url>', 'Base URL for the API', 'http://localhost:3000')
+    .option('-t, --title <title>', 'API title', 'NestJS API')
+    .option('-v, --apiVersion <version>', 'API version', '1.0.0')
     .action(async (sourcePath, options) => {
     try {
-        console.log('Scanning controllers...');
+        console.log('\n' + '='.repeat(60));
+        console.log('🚀 Nest-Scramble CLI');
+        console.log('   Developed by Mohamed Mustafa | MIT License');
+        console.log('='.repeat(60) + '\n');
+        console.log(`📂 Scanning controllers in: ${sourcePath}`);
         const scanner = new ScannerService_1.ScannerService();
         const controllers = scanner.scanControllers(sourcePath);
         if (controllers.length === 0) {
-            console.log('No controllers found.');
-            return;
+            console.log('❌ No controllers found.');
+            console.log('💡 Make sure your controllers use @Controller() decorator');
+            process.exit(1);
         }
-        console.log(`Found ${controllers.length} controllers with ${controllers.reduce((sum, c) => sum + c.methods.length, 0)} methods.`);
-        console.log('Generating Postman collection...');
-        const generator = new PostmanCollectionGenerator_1.PostmanCollectionGenerator(options.baseUrl);
-        const collection = generator.generateCollection(controllers);
+        const methodCount = controllers.reduce((sum, c) => sum + c.methods.length, 0);
+        console.log(`✅ Found ${controllers.length} controller(s) with ${methodCount} endpoint(s)\n`);
         const outputPath = path.resolve(options.output);
-        fs.writeFileSync(outputPath, JSON.stringify(collection, null, 2));
-        console.log(`Postman collection saved to ${outputPath}`);
+        if (options.format === 'postman') {
+            console.log('📦 Generating Postman collection...');
+            const generator = new PostmanCollectionGenerator_1.PostmanCollectionGenerator(options.baseUrl);
+            const collection = generator.generateCollection(controllers);
+            fs.writeFileSync(outputPath, JSON.stringify(collection, null, 2));
+            console.log(`✅ Postman collection saved to: ${outputPath}`);
+        }
+        else {
+            console.log('📄 Generating OpenAPI specification...');
+            const transformer = new OpenApiTransformer_1.OpenApiTransformer(options.baseUrl);
+            const spec = transformer.transform(controllers, options.title, options.apiVersion, options.baseUrl);
+            fs.writeFileSync(outputPath, JSON.stringify(spec, null, 2));
+            console.log(`✅ OpenAPI spec saved to: ${outputPath}`);
+        }
+        console.log('\n' + '='.repeat(60));
+        console.log('🎉 Generation complete!');
+        console.log('='.repeat(60) + '\n');
+    }
+    catch (error) {
+        console.error('\n❌ Error:', error instanceof Error ? error.message : error);
+        console.error('\n💡 Troubleshooting:');
+        console.error('   - Ensure the source path is correct');
+        console.error('   - Check that tsconfig.json exists in your project root');
+        console.error('   - Verify your controllers use @Controller() decorator\n');
+        process.exit(1);
+    }
+});
+program
+    .command('init')
+    .description('Auto-inject Nest-Scramble into your NestJS project')
+    .option('-m, --module <path>', 'Path to your app module', 'src/app.module.ts')
+    .action(async (options) => {
+    try {
+        console.log('\n' + '='.repeat(60));
+        console.log('🚀 Nest-Scramble Auto-Injector');
+        console.log('   Developed by Mohamed Mustafa | MIT License');
+        console.log('='.repeat(60) + '\n');
+        const { Project } = require('ts-morph');
+        const fs = require('fs');
+        const path = require('path');
+        const modulePath = path.resolve(options.module);
+        if (!fs.existsSync(modulePath)) {
+            console.error(`❌ Module file not found: ${modulePath}`);
+            console.error('💡 Try: nest-scramble init --module src/app.module.ts');
+            process.exit(1);
+        }
+        console.log(`📂 Found module: ${modulePath}`);
+        const project = new Project();
+        const sourceFile = project.addSourceFileAtPath(modulePath);
+        // Check if already imported
+        const existingImport = sourceFile.getImportDeclaration((imp) => imp.getModuleSpecifierValue() === 'nest-scramble');
+        if (existingImport) {
+            console.log('⚠️  Nest-Scramble is already imported in this module');
+            console.log('✅ No changes needed!');
+            process.exit(0);
+        }
+        // Add import statement
+        console.log('📝 Adding import statement...');
+        sourceFile.addImportDeclaration({
+            moduleSpecifier: 'nest-scramble',
+            namedImports: ['NestScrambleModule'],
+        });
+        // Find the @Module decorator
+        const classes = sourceFile.getClasses();
+        const moduleClass = classes.find((cls) => cls.getDecorator('Module') !== undefined);
+        if (!moduleClass) {
+            console.error('❌ Could not find @Module decorator');
+            console.error('💡 Please add NestScrambleModule.forRoot() manually');
+            process.exit(1);
+        }
+        const moduleDecorator = moduleClass.getDecorator('Module');
+        const decoratorArgs = moduleDecorator?.getArguments();
+        if (!decoratorArgs || decoratorArgs.length === 0) {
+            console.error('❌ Module decorator has no arguments');
+            process.exit(1);
+        }
+        const configObject = decoratorArgs[0];
+        const configText = configObject.getText();
+        // Add NestScrambleModule to imports array
+        let newConfigText = configText;
+        if (configText.includes('imports:')) {
+            // Add to existing imports array
+            newConfigText = configText.replace(/imports:\s*\[/, 'imports: [\n    NestScrambleModule.forRoot(),');
+        }
+        else {
+            // Create imports array
+            newConfigText = configText.replace(/\{/, '{\n  imports: [NestScrambleModule.forRoot()],');
+        }
+        configObject.replaceWithText(newConfigText);
+        // Save the file
+        console.log('💾 Saving changes...');
+        await sourceFile.save();
+        console.log('\n' + '='.repeat(60));
+        console.log('✅ Nest-Scramble successfully injected!');
+        console.log('='.repeat(60));
+        console.log('\n📋 Next steps:');
+        console.log('   1. Run: npm run start:dev');
+        console.log('   2. Visit: http://localhost:3000/docs');
+        console.log('   3. Enjoy zero-config API documentation! 🎉\n');
     }
     catch (error) {
-        console.error('Error:', error);
+        console.error('\n❌ Error:', error instanceof Error ? error.message : error);
+        console.error('\n💡 Manual installation:');
+        console.error('   1. Import: import { NestScrambleModule } from "nest-scramble";');
+        console.error('   2. Add to imports: NestScrambleModule.forRoot()');
+        console.error('   3. Done! 🚀\n');
         process.exit(1);
     }
 });

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;AACA,kEAAkE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAElE,yCAAoC;AACpC,uCAAyB;AACzB,2CAA6B;AAC7B,wFAAqF;AACrF,6DAA0D;AAE1D,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,eAAe,CAAC;KACrB,WAAW,CAAC,8DAA8D,CAAC;KAC3E,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,UAAU,CAAC;KACnB,WAAW,CAAC,iDAAiD,CAAC;KAC9D,QAAQ,CAAC,cAAc,EAAE,0CAA0C,CAAC;KACpE,MAAM,CAAC,qBAAqB,EAAE,kBAAkB,EAAE,iBAAiB,CAAC;KACpE,MAAM,CAAC,qBAAqB,EAAE,sBAAsB,EAAE,aAAa,CAAC;KACpE,MAAM,CAAC,KAAK,EAAE,UAAkB,EAAE,OAA4C,EAAE,EAAE;IACjF,IAAI,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;QACvC,MAAM,OAAO,GAAG,IAAI,+BAAc,EAAE,CAAC;QACrC,MAAM,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;QAExD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;YACrC,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,SAAS,WAAW,CAAC,MAAM,qBAAqB,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC;QAElI,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;QAChD,MAAM,SAAS,GAAG,IAAI,uDAA0B,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAClE,MAAM,UAAU,GAAG,SAAS,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;QAE7D,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAChD,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,+BAA+B,UAAU,EAAE,CAAC,CAAC;IAC3D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/controllers/DocsController.d.ts

@@ -1,3 +1,5 @@
+export declare const IS_PUBLIC_KEY = "isPublic";
+export declare const Public: () => import("@nestjs/common").CustomDecorator<string>;
 export declare class DocsController {
     private openApiSpec;
     constructor(openApiSpec: any);

package/dist/controllers/DocsController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DocsController.d.ts","sourceRoot":"","sources":["../../src/controllers/DocsController.ts"],"names":[],"mappings":"AAGA,qBACa,cAAc;IAEU,OAAO,CAAC,WAAW;gBAAX,WAAW,EAAE,GAAG;IAI3D,OAAO,CAAQ,GAAG,EAAE,GAAG;IA0BvB,cAAc,CAAQ,GAAG,EAAE,GAAG;IAa9B,oBAAoB,CAAQ,GAAG,EAAE,GAAG;IAKpC,cAAc;CAGf"}
+{"version":3,"file":"DocsController.d.ts","sourceRoot":"","sources":["../../src/controllers/DocsController.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,aAAa,aAAa,CAAC;AACxC,eAAO,MAAM,MAAM,wDAAyC,CAAC;AAE7D,qBAEa,cAAc;IAEU,OAAO,CAAC,WAAW;gBAAX,WAAW,EAAE,GAAG;IAI3D,OAAO,CAAQ,GAAG,EAAE,GAAG;IA0BvB,cAAc,CAAQ,GAAG,EAAE,GAAG;IAa9B,oBAAoB,CAAQ,GAAG,EAAE,GAAG;IAKpC,cAAc;CAGf"}

package/dist/controllers/DocsController.js

@@ -12,9 +12,12 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DocsController = void 0;
+exports.DocsController = exports.Public = exports.IS_PUBLIC_KEY = void 0;
 /** Nest-Scramble | Developed by Mohamed Mustafa | MIT License **/
 const common_1 = require("@nestjs/common");
+exports.IS_PUBLIC_KEY = 'isPublic';
+const Public = () => (0, common_1.SetMetadata)(exports.IS_PUBLIC_KEY, true);
+exports.Public = Public;
 let DocsController = class DocsController {
     constructor(openApiSpec) {
         this.openApiSpec = openApiSpec;
@@ -91,6 +94,7 @@ __decorate([
 ], DocsController.prototype, "getOpenApiSpec", null);
 exports.DocsController = DocsController = __decorate([
     (0, common_1.Controller)(),
+    (0, exports.Public)(),
     __param(0, (0, common_1.Inject)('NEST_SCRAMBLE_OPENAPI')),
     __metadata("design:paramtypes", [Object])
 ], DocsController);

package/dist/controllers/DocsController.js.map

@@ -1 +1 @@
-{"version":3,"file":"DocsController.js","sourceRoot":"","sources":["../../src/controllers/DocsController.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,kEAAkE;AAClE,2CAA8D;AAGvD,IAAM,cAAc,GAApB,MAAM,cAAc;IACzB,YAC2C,WAAgB;QAAhB,gBAAW,GAAX,WAAW,CAAK;IACxD,CAAC;IAGJ,OAAO,CAAQ,GAAQ;QACrB,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;QAkBT,CAAC;QAEL,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,0BAA0B,CAAC,CAAC;QAC1D,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IAGD,cAAc,CAAQ,GAAQ;QAC5B,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAC7D,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,iCAAiC,CAAC,CAAC;YACjE,GAAG,CAAC,SAAS,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;YAClD,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,iDAAiD,EAAE,KAAK,CAAC,CAAC;YACxE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,0CAA0C,EAAE,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IAGD,oBAAoB,CAAQ,GAAQ;QAClC,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAGD,cAAc;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;CACF,CAAA;AArDY,wCAAc;AAMzB;IADC,IAAA,YAAG,EAAC,MAAM,CAAC;IACH,WAAA,IAAA,YAAG,GAAE,CAAA;;;;6CAuBb;AAGD;IADC,IAAA,YAAG,EAAC,WAAW,CAAC;IACD,WAAA,IAAA,YAAG,GAAE,CAAA;;;;oDAUpB;AAGD;IADC,IAAA,YAAG,EAAC,WAAW,CAAC;IACK,WAAA,IAAA,YAAG,GAAE,CAAA;;;;0DAE1B;AAGD;IADC,IAAA,YAAG,EAAC,WAAW,CAAC;;;;oDAGhB;yBApDU,cAAc;IAD1B,IAAA,mBAAU,GAAE;IAGR,WAAA,IAAA,eAAM,EAAC,uBAAuB,CAAC,CAAA;;GAFvB,cAAc,CAqD1B"}
+{"version":3,"file":"DocsController.js","sourceRoot":"","sources":["../../src/controllers/DocsController.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,kEAAkE;AAClE,2CAA2E;AAE9D,QAAA,aAAa,GAAG,UAAU,CAAC;AACjC,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,IAAA,oBAAW,EAAC,qBAAa,EAAE,IAAI,CAAC,CAAC;AAAhD,QAAA,MAAM,UAA0C;AAItD,IAAM,cAAc,GAApB,MAAM,cAAc;IACzB,YAC2C,WAAgB;QAAhB,gBAAW,GAAX,WAAW,CAAK;IACxD,CAAC;IAGJ,OAAO,CAAQ,GAAQ;QACrB,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;QAkBT,CAAC;QAEL,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,0BAA0B,CAAC,CAAC;QAC1D,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IAGD,cAAc,CAAQ,GAAQ;QAC5B,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAC7D,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,iCAAiC,CAAC,CAAC;YACjE,GAAG,CAAC,SAAS,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;YAClD,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,iDAAiD,EAAE,KAAK,CAAC,CAAC;YACxE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,0CAA0C,EAAE,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IAGD,oBAAoB,CAAQ,GAAQ;QAClC,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAGD,cAAc;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;CACF,CAAA;AArDY,wCAAc;AAMzB;IADC,IAAA,YAAG,EAAC,MAAM,CAAC;IACH,WAAA,IAAA,YAAG,GAAE,CAAA;;;;6CAuBb;AAGD;IADC,IAAA,YAAG,EAAC,WAAW,CAAC;IACD,WAAA,IAAA,YAAG,GAAE,CAAA;;;;oDAUpB;AAGD;IADC,IAAA,YAAG,EAAC,WAAW,CAAC;IACK,WAAA,IAAA,YAAG,GAAE,CAAA;;;;0DAE1B;AAGD;IADC,IAAA,YAAG,EAAC,WAAW,CAAC;;;;oDAGhB;yBApDU,cAAc;IAF1B,IAAA,mBAAU,GAAE;IACZ,IAAA,cAAM,GAAE;IAGJ,WAAA,IAAA,eAAM,EAAC,uBAAuB,CAAC,CAAA;;GAFvB,cAAc,CAqD1B"}

package/dist/index.d.ts

@@ -5,6 +5,7 @@ export * from './scanner/ScannerService';
 export * from './utils/DtoAnalyzer';
 export * from './utils/MockGenerator';
 export * from './utils/OpenApiTransformer';
+export * from './utils/AutoDetector';
 export * from './middleware/MockMiddleware';
 export * from './controllers/DocsController';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,cAAc,yCAAyC,CAAC;AACxD,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,cAAc,yCAAyC,CAAC;AACxD,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC"}

package/dist/index.js

@@ -21,6 +21,7 @@ __exportStar(require("./scanner/ScannerService"), exports);
 __exportStar(require("./utils/DtoAnalyzer"), exports);
 __exportStar(require("./utils/MockGenerator"), exports);
 __exportStar(require("./utils/OpenApiTransformer"), exports);
+__exportStar(require("./utils/AutoDetector"), exports);
 __exportStar(require("./middleware/MockMiddleware"), exports);
 __exportStar(require("./controllers/DocsController"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kEAAkE;AAClE,0EAAwD;AACxD,uDAAqC;AACrC,2DAAyC;AACzC,sDAAoC;AACpC,wDAAsC;AACtC,6DAA2C;AAC3C,8DAA4C;AAC5C,+DAA6C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kEAAkE;AAClE,0EAAwD;AACxD,uDAAqC;AACrC,2DAAyC;AACzC,sDAAoC;AACpC,wDAAsC;AACtC,6DAA2C;AAC3C,uDAAqC;AACrC,8DAA4C;AAC5C,+DAA6C"}

package/dist/utils/AutoDetector.d.ts

@@ -0,0 +1,47 @@
+export interface ProjectStructure {
+    rootPath: string;
+    sourcePath: string;
+    packageJson: any;
+    tsConfigPath: string;
+    hasControllers: boolean;
+    controllerPaths: string[];
+}
+export declare class AutoDetector {
+    /**
+     * Auto-detect the project structure and configuration
+     */
+    static detectProjectStructure(): ProjectStructure;
+    /**
+     * Auto-detect the source directory
+     */
+    private static detectSourcePath;
+    /**
+     * Detect tsconfig.json location
+     */
+    private static detectTsConfig;
+    /**
+     * Check if directory has TypeScript files
+     */
+    private static hasTypeScriptFiles;
+    /**
+     * Find all controller files recursively
+     */
+    private static findControllers;
+    /**
+     * Detect the port from environment or default
+     */
+    static detectPort(): number;
+    /**
+     * Detect base URL
+     */
+    static detectBaseUrl(): string;
+    /**
+     * Get app name from package.json or default
+     */
+    static getAppName(): string;
+    /**
+     * Get app version from package.json or default
+     */
+    static getAppVersion(): string;
+}
+//# sourceMappingURL=AutoDetector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AutoDetector.d.ts","sourceRoot":"","sources":["../../src/utils/AutoDetector.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,GAAG,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,qBAAa,YAAY;IACvB;;OAEG;IACH,MAAM,CAAC,sBAAsB,IAAI,gBAAgB;IAkCjD;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAkB/B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAiB7B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IASjC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IA2B9B;;OAEG;IACH,MAAM,CAAC,UAAU,IAAI,MAAM;IAI3B;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,MAAM;IAM9B;;OAEG;IACH,MAAM,CAAC,UAAU,IAAI,MAAM;IAa3B;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,MAAM;CAY/B"}

package/dist/utils/AutoDetector.js

@@ -0,0 +1,194 @@
+"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.AutoDetector = void 0;
+/** Nest-Scramble | Developed by Mohamed Mustafa | MIT License **/
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+class AutoDetector {
+    /**
+     * Auto-detect the project structure and configuration
+     */
+    static detectProjectStructure() {
+        const rootPath = process.cwd();
+        // Try to find package.json
+        const packageJsonPath = path.join(rootPath, 'package.json');
+        let packageJson = {};
+        if (fs.existsSync(packageJsonPath)) {
+            try {
+                packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+            }
+            catch (error) {
+                console.warn('[Nest-Scramble] Could not parse package.json');
+            }
+        }
+        // Auto-detect source path
+        const sourcePath = this.detectSourcePath(rootPath);
+        // Find tsconfig.json
+        const tsConfigPath = this.detectTsConfig(rootPath);
+        // Find controllers
+        const controllerPaths = this.findControllers(path.join(rootPath, sourcePath));
+        return {
+            rootPath,
+            sourcePath,
+            packageJson,
+            tsConfigPath,
+            hasControllers: controllerPaths.length > 0,
+            controllerPaths,
+        };
+    }
+    /**
+     * Auto-detect the source directory
+     */
+    static detectSourcePath(rootPath) {
+        const possiblePaths = ['src', 'lib', 'app', 'source'];
+        for (const possiblePath of possiblePaths) {
+            const fullPath = path.join(rootPath, possiblePath);
+            if (fs.existsSync(fullPath) && fs.statSync(fullPath).isDirectory()) {
+                // Check if it contains TypeScript files
+                const hasTs = this.hasTypeScriptFiles(fullPath);
+                if (hasTs) {
+                    return possiblePath;
+                }
+            }
+        }
+        // Default to 'src'
+        return 'src';
+    }
+    /**
+     * Detect tsconfig.json location
+     */
+    static detectTsConfig(rootPath) {
+        const possiblePaths = [
+            'tsconfig.json',
+            'tsconfig.app.json',
+            'tsconfig.build.json',
+        ];
+        for (const possiblePath of possiblePaths) {
+            const fullPath = path.join(rootPath, possiblePath);
+            if (fs.existsSync(fullPath)) {
+                return fullPath;
+            }
+        }
+        return path.join(rootPath, 'tsconfig.json');
+    }
+    /**
+     * Check if directory has TypeScript files
+     */
+    static hasTypeScriptFiles(dirPath) {
+        try {
+            const files = fs.readdirSync(dirPath);
+            return files.some(file => file.endsWith('.ts'));
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Find all controller files recursively
+     */
+    static findControllers(dirPath, controllers = []) {
+        if (!fs.existsSync(dirPath)) {
+            return controllers;
+        }
+        try {
+            const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = path.join(dirPath, entry.name);
+                if (entry.isDirectory()) {
+                    // Skip node_modules and dist
+                    if (entry.name !== 'node_modules' && entry.name !== 'dist' && entry.name !== '.git') {
+                        this.findControllers(fullPath, controllers);
+                    }
+                }
+                else if (entry.isFile() && entry.name.endsWith('.controller.ts')) {
+                    controllers.push(fullPath);
+                }
+            }
+        }
+        catch (error) {
+            // Silently skip directories we can't read
+        }
+        return controllers;
+    }
+    /**
+     * Detect the port from environment or default
+     */
+    static detectPort() {
+        return parseInt(process.env.PORT || '3000', 10);
+    }
+    /**
+     * Detect base URL
+     */
+    static detectBaseUrl() {
+        const port = this.detectPort();
+        const host = process.env.HOST || 'localhost';
+        return `http://${host}:${port}`;
+    }
+    /**
+     * Get app name from package.json or default
+     */
+    static getAppName() {
+        try {
+            const packageJsonPath = path.join(process.cwd(), 'package.json');
+            if (fs.existsSync(packageJsonPath)) {
+                const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+                return packageJson.name || 'NestJS API';
+            }
+        }
+        catch {
+            // Ignore
+        }
+        return 'NestJS API';
+    }
+    /**
+     * Get app version from package.json or default
+     */
+    static getAppVersion() {
+        try {
+            const packageJsonPath = path.join(process.cwd(), 'package.json');
+            if (fs.existsSync(packageJsonPath)) {
+                const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+                return packageJson.version || '1.0.0';
+            }
+        }
+        catch {
+            // Ignore
+        }
+        return '1.0.0';
+    }
+}
+exports.AutoDetector = AutoDetector;
+//# sourceMappingURL=AutoDetector.js.map

package/dist/utils/AutoDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AutoDetector.js","sourceRoot":"","sources":["../../src/utils/AutoDetector.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,kEAAkE;AAClE,uCAAyB;AACzB,2CAA6B;AAW7B,MAAa,YAAY;IACvB;;OAEG;IACH,MAAM,CAAC,sBAAsB;QAC3B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAE/B,2BAA2B;QAC3B,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;QAC5D,IAAI,WAAW,GAAQ,EAAE,CAAC;QAE1B,IAAI,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC;gBACH,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;YACtE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;QAED,0BAA0B;QAC1B,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAEnD,qBAAqB;QACrB,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QAEnD,mBAAmB;QACnB,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;QAE9E,OAAO;YACL,QAAQ;YACR,UAAU;YACV,WAAW;YACX,YAAY;YACZ,cAAc,EAAE,eAAe,CAAC,MAAM,GAAG,CAAC;YAC1C,eAAe;SAChB,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,gBAAgB,CAAC,QAAgB;QAC9C,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;QAEtD,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;YACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;YACnD,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;gBACnE,wCAAwC;gBACxC,MAAM,KAAK,GAAG,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;gBAChD,IAAI,KAAK,EAAE,CAAC;oBACV,OAAO,YAAY,CAAC;gBACtB,CAAC;YACH,CAAC;QACH,CAAC;QAED,mBAAmB;QACnB,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,cAAc,CAAC,QAAgB;QAC5C,MAAM,aAAa,GAAG;YACpB,eAAe;YACf,mBAAmB;YACnB,qBAAqB;SACtB,CAAC;QAEF,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;YACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;YACnD,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC5B,OAAO,QAAQ,CAAC;YAClB,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,kBAAkB,CAAC,OAAe;QAC/C,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YACtC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAClD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,eAAe,CAAC,OAAe,EAAE,cAAwB,EAAE;QACxE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YAEjE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAEhD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;oBACxB,6BAA6B;oBAC7B,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;wBACpF,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;oBAC9C,CAAC;gBACH,CAAC;qBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;oBACnE,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC7B,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,0CAA0C;QAC5C,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,UAAU;QACf,OAAO,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,aAAa;QAClB,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,WAAW,CAAC;QAC7C,OAAO,UAAU,IAAI,IAAI,IAAI,EAAE,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,UAAU;QACf,IAAI,CAAC;YACH,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;YACjE,IAAI,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;gBACnC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;gBAC1E,OAAO,WAAW,CAAC,IAAI,IAAI,YAAY,CAAC;YAC1C,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,OAAO,YAAY,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,aAAa;QAClB,IAAI,CAAC;YACH,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;YACjE,IAAI,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;gBACnC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;gBAC1E,OAAO,WAAW,CAAC,OAAO,IAAI,OAAO,CAAC;YACxC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAxKD,oCAwKC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nest-scramble",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "description": "A next-generation, decorator-free API documentation engine and intelligent mock server for NestJS, engineered by Mohamed Mustafa",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",