apiforge-analyzer 1.1.0 → 1.2.1

package/dist/esm/uploader.js

@@ -1,28 +1,64 @@
 import axios from 'axios';
+import { writeFileSync, unlinkSync, existsSync } from 'fs';
+import { join } from 'path';
 import { enrichRoutes } from './export.js';
+/** Status file written to the project root so the CLI can detect completion. */
+const STATUS_FILE = '.apiforge-status.json';
+export function writeStatusFile(status, data) {
+    try {
+        writeFileSync(join(process.cwd(), STATUS_FILE), JSON.stringify({ status, timestamp: Date.now(), ...data }), 'utf-8');
+    }
+    catch { }
+}
+export function removeStatusFile() {
+    try {
+        const p = join(process.cwd(), STATUS_FILE);
+        if (existsSync(p))
+            unlinkSync(p);
+    }
+    catch { }
+}
 /**
- * Upload routes to APIForge server
+ * Submit routes to the APIForge backend for user review.
+ * Returns the pendingImportId so the CLI can poll for approval.
  */
 export async function uploadRoutes(routes, options) {
-    const url = options.apiForgeUrl || process.env.APIFORGE_URL || 'http://localhost:3000';
+    // Production URL is the built-in default — no config needed.
+    // Override only for local testing via option or env var.
+    const backendUrl = (options.apiForgeUrl ||
+        process.env.APIFORGE_URL ||
+        'https://apiforgeapi.brainfogagency.com').replace(/\/$/, '');
     const enrichedRoutes = enrichRoutes(routes);
+    const payload = {
+        projectName: options.projectName,
+        routes: enrichedRoutes,
+        baseUrl: options.baseUrl,
+        framework: enrichedRoutes[0]?.framework || 'unknown',
+    };
     try {
-        const response = await axios.post(`${url}/api/upload-routes`, {
-            projectName: options.projectName,
-            routes: enrichedRoutes,
-            baseUrl: options.baseUrl,
-            framework: enrichedRoutes[0]?.framework || 'unknown',
-        }, {
+        const response = await axios.post(`${backendUrl}/api/cli/submit`, payload, {
             headers: {
                 'Content-Type': 'application/json',
                 'X-API-Key': options.apiKey,
+                'User-Agent': 'apiforge-analyzer/1.2.0',
             },
             timeout: 30000,
         });
-        console.log('✅ Uploaded to APIForge:', response.data);
+        const data = response.data?.data;
+        console.log(`✅ APIForge: ${data?.message || 'Routes submitted for review'}`);
+        writeStatusFile('submitted', {
+            pendingImportId: data.pendingImportId,
+            routeCount: data.routeCount,
+        });
+        return data;
     }
     catch (error) {
-        console.error('❌ Upload failed:', error.message);
-        throw error;
+        const msg = error.response?.data?.message ||
+            error.response?.data?.error ||
+            error.message ||
+            'Unknown error';
+        console.error(`❌ APIForge upload failed: ${msg}`);
+        writeStatusFile('error', { error: msg });
+        return null;
     }
 }

package/dist/types/detect.d.ts

@@ -1,13 +1,11 @@
-/**
- * Framework detection utilities
- */
-export type Framework = 'express' | 'nextjs-pages' | 'nextjs-app' | 'vite' | 'react-router' | 'node-http' | 'unknown';
+export type Framework = 'express' | 'fastify' | 'koa' | 'hapi' | 'nestjs' | 'nextjs-pages' | 'nextjs-app' | 'vite' | 'react-router' | 'node-http' | 'unknown';
 export interface FrameworkInfo {
     name: Framework;
     version?: string;
     confidence: number;
 }
 /**
- * Detect which framework is being used
+ * Detect the web framework from the live app instance + filesystem hints.
+ * Confidence is used to pick the best match when multiple signals fire.
  */
 export declare function detectFramework(app?: any): FrameworkInfo;

package/dist/types/frameworks/express.d.ts

@@ -1,5 +1,5 @@
 /**
- * Express analyzer — accurate route + payload extraction
+ * Express route analyzer — deep extraction of routes, parameters, and auth patterns
  */
 export interface Route {
     id?: number;
@@ -8,6 +8,7 @@ export interface Route {
     tag: string;
     operationId: string;
     summary: string;
+    description?: string;
     middleware: string[];
     authRequired: boolean;
     pathParams: string[];
@@ -18,6 +19,5 @@ export interface Route {
     framework: string;
     responseStatuses?: number[];
     headerParams?: string[];
-    description?: string;
 }
 export declare function analyzeExpress(app: any): Route[];

package/dist/types/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * Main analyzer entry point with dual module support
+ * APIForge Analyzer — main entry point (dual ESM/CJS)
  */
 import { analyzeExpress } from './frameworks/express.js';
 import { analyzeNextPages } from './frameworks/nextjs-pages.js';
@@ -22,9 +22,6 @@ export interface AnalyzerOptions {
     skipInProduction?: boolean;
     runOnce?: boolean;
 }
-/**
- * Main analyze function with auto-detection
- */
 export declare function analyze(app: any, options: AnalyzerOptions): Promise<any[]>;
 export { analyzeExpress, analyzeNextPages, analyzeNextApp, analyzeVite, analyzeReactRouter };
 export { exportToJSON } from './export.js';

package/dist/types/uploader.d.ts

@@ -5,7 +5,15 @@ export interface UploadOptions {
     apiForgeUrl?: string;
     apiKey: string;
 }
+export interface UploadResult {
+    pendingImportId: string;
+    routeCount: number;
+    message: string;
+}
+export declare function writeStatusFile(status: 'submitted' | 'error', data: Record<string, any>): void;
+export declare function removeStatusFile(): void;
 /**
- * Upload routes to APIForge server
+ * Submit routes to the APIForge backend for user review.
+ * Returns the pendingImportId so the CLI can poll for approval.
  */
-export declare function uploadRoutes(routes: Route[], options: UploadOptions): Promise<void>;
+export declare function uploadRoutes(routes: Route[], options: UploadOptions): Promise<UploadResult | null>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apiforge-analyzer",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "description": "Universal API documentation generator for Express, Next.js, Vite, React Router, and Node.js",
   "type": "module",
   "main": "./dist/cjs/index.js",