apiforge-analyzer 1.3.8 → 1.3.10

package/dist/esm/uploader.js

@@ -2,6 +2,16 @@ import axios from 'axios';
 import { writeFileSync, unlinkSync, existsSync } from 'fs';
 import { join } from 'path';
 import { enrichRoutes } from './export.js';
+/** The backend's fields for a visibility choice — nothing when none was made. */
+function visibilityFields(choice) {
+    if (choice === 'ORG_WIDE')
+        return { visibility: 'ORG_WIDE', isPrivate: false };
+    if (choice === 'TEAM')
+        return { visibility: 'TEAM', isPrivate: false };
+    if (choice === 'PRIVATE')
+        return { visibility: 'TEAM', isPrivate: true };
+    return {};
+}
 /** Status file written to the project root so the CLI can detect completion. */
 const STATUS_FILE = '.apiforge-status.json';
 export function writeStatusFile(status, data) {
@@ -36,6 +46,7 @@ export async function uploadRoutes(routes, options) {
         framework: enrichedRoutes[0]?.framework || 'unknown',
         architectureType: options.architectureType || 'monolithic',
         services: options.services || [],
+        ...visibilityFields(options.visibility ?? process.env.APIFORGE_VISIBILITY),
     };
     try {
         const response = await axios.post(`${backendUrl}/api/cli/submit`, payload, {

package/dist/types/express-mount-hook.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Records where every router / sub-app is mounted, at the moment it is mounted.
+ *
+ * The Express analyzer reads mount prefixes back off the router stack after the fact, which loses them:
+ *  - Express 5 (router@2) keeps no path on a layer at all (only compiled matchers), so every mounted
+ *    router's routes came out without their prefix, and same-looking ones collapsed as duplicates.
+ *  - A sub-app (`app.use('/admin', express())`) is wrapped in a `mounted_app` function with no `stack`,
+ *    so none of its routes were found.
+ *  - Express 4's mount regexp for a parameterised prefix (`/users/:id/posts`) doesn't turn back into the path.
+ *
+ * Wrapping `use()` tags each layer it adds with the mount path as written, and a sub-app's layer with the
+ * sub-app itself; express.ts prefers those tags and falls back to the old regexp reading without them.
+ * Must run before the app registers its routes — the CLI preloads it (express-preload.ts).
+ */
+export declare const MOUNT_PATH = "__apiforgeMountPath";
+export declare const SUB_APP = "__apiforgeSubApp";
+/** An app's router stack: `_router` in Express 4, the `router` getter in Express 5 (which throws in 4). */
+export declare function appStack(app: any): any[] | undefined;
+export declare function installExpressMountHook(express: any): void;

package/dist/types/express-preload.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/uploader.d.ts

@@ -11,7 +11,13 @@ export interface UploadOptions {
     apiKey: string;
     architectureType?: ArchitectureType;
     services?: ServiceMeta[];
+    /**
+     * Who can see the new project (APIForge spec §6.1 levels, chosen at creation per §6.3). Defaults to the
+     * CLI's answer in APIFORGE_VISIBILITY; with neither, the backend's default ("Only me") applies.
+     */
+    visibility?: ProjectVisibility;
 }
+export type ProjectVisibility = 'ORG_WIDE' | 'TEAM' | 'PRIVATE';
 export interface UploadResult {
     pendingImportId: string;
     routeCount: number;

package/package.json

@@ -1,67 +1,67 @@
-{
-  "name": "apiforge-analyzer",
-  "version": "1.3.8",
-  "description": "Universal API documentation generator for Express, Next.js, Vite, React Router, and Node.js",
-  "type": "module",
-  "main": "./dist/cjs/index.js",
-  "module": "./dist/esm/index.js",
-  "types": "./dist/types/index.d.ts",
-  "bin": {
-    "apiforge-analyzer": "./dist/esm/cli.js",
-    "apiforge": "./dist/esm/cli.js"
-  },
-  "exports": {
-    ".": {
-      "import": "./dist/esm/index.js",
-      "require": "./dist/cjs/index.js",
-      "types": "./dist/types/index.d.ts"
-    }
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "npm run build:esm && npm run build:cjs && npm run build:types",
-    "build:esm": "tsc -p tsconfig.esm.json",
-    "build:cjs": "tsc -p tsconfig.cjs.json && node -e \"require('fs').writeFileSync('dist/cjs/package.json', JSON.stringify({type:'commonjs'}))\"",
-    "build:types": "tsc -p tsconfig.types.json",
-    "prepublishOnly": "npm run build",
-    "test": "node ../test-apps/run-all.cjs"
-  },
-  "keywords": [
-    "api",
-    "documentation",
-    "openapi",
-    "swagger",
-    "express",
-    "nextjs",
-    "vite",
-    "react-router",
-    "nodejs",
-    "analyzer",
-    "cli"
-  ],
-  "author": "APIForge",
-  "license": "MIT",
-  "peerDependencies": {
-    "express": "^4.0.0 || ^5.0.0"
-  },
-  "peerDependenciesMeta": {
-    "express": {
-      "optional": true
-    }
-  },
-  "dependencies": {
-    "@clack/prompts": "^0.9.1",
-    "axios": "^1.6.0",
-    "ts-morph": "^28.0.0"
-  },
-  "devDependencies": {
-    "@types/express": "^4.17.21",
-    "@types/node": "^20.0.0",
-    "fastify": "^5.12.1",
-    "typescript": "^5.3.0",
-    "zod": "^4.5.4"
-  }
+{
+  "name": "apiforge-analyzer",
+  "version": "1.3.10",
+  "description": "Universal API documentation generator for Express, Next.js, Vite, React Router, and Node.js",
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/types/index.d.ts",
+  "bin": {
+    "apiforge-analyzer": "./dist/esm/cli.js",
+    "apiforge": "./dist/esm/cli.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js",
+      "types": "./dist/types/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "npm run build:esm && npm run build:cjs && npm run build:types",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:cjs": "tsc -p tsconfig.cjs.json && node -e \"require('fs').writeFileSync('dist/cjs/package.json', JSON.stringify({type:'commonjs'}))\"",
+    "build:types": "tsc -p tsconfig.types.json",
+    "prepublishOnly": "npm run build",
+    "test": "node ../test-apps/run-all.cjs"
+  },
+  "keywords": [
+    "api",
+    "documentation",
+    "openapi",
+    "swagger",
+    "express",
+    "nextjs",
+    "vite",
+    "react-router",
+    "nodejs",
+    "analyzer",
+    "cli"
+  ],
+  "author": "APIForge",
+  "license": "MIT",
+  "peerDependencies": {
+    "express": "^4.0.0 || ^5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "express": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.9.1",
+    "axios": "^1.6.0",
+    "ts-morph": "^28.0.0"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/node": "^20.0.0",
+    "fastify": "^5.12.1",
+    "typescript": "^5.3.0",
+    "zod": "^4.5.4"
+  }
 }