apiforge-analyzer 1.3.8 → 1.3.9

package/dist/cjs/cli.js

@@ -111,6 +111,22 @@ async function main() {
         (0, prompts_1.cancel)('Cancelled.');
         process.exit(0);
     }
+    // ── Who can see the docs (APIForge spec §6.1 levels, chosen by the creator per §6.3) ──────────────────
+    const visibilityChoice = await (0, prompts_1.select)({
+        message: 'Who can see these docs?',
+        initialValue: 'PRIVATE', // "Only me" — the backend's default too
+        options: [
+            { value: 'ORG_WIDE', label: `${bold('Everyone in the org')}  ${dim('— every member of your organization')}` },
+            { value: 'TEAM', label: `${bold('Team')}  ${dim('— people you add, plus admins and the Superadmin')}` },
+            { value: 'PRIVATE', label: `${bold('Only me')}  ${dim('— you, people you add, and the Superadmin')}` },
+        ],
+    });
+    if ((0, prompts_1.isCancel)(visibilityChoice)) {
+        (0, prompts_1.cancel)('Cancelled.');
+        process.exit(0);
+    }
+    // Read by uploadRoutes — in this process and in the server this CLI starts (it inherits the environment)
+    process.env.APIFORGE_VISIBILITY = visibilityChoice;
     const isLocal = backendChoice === 'local';
     const backendUrl = isLocal ? BACKEND_LOCAL : BACKEND_PROD;
     const dashboardUrl = isLocal ? DASHBOARD_LOCAL : DASHBOARD_PROD;

package/dist/cjs/uploader.js

@@ -10,6 +10,16 @@ const axios_1 = __importDefault(require("axios"));
 const fs_1 = require("fs");
 const path_1 = require("path");
 const export_js_1 = require("./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';
 function writeStatusFile(status, data) {
@@ -44,6 +54,7 @@ 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_1.default.post(`${backendUrl}/api/cli/submit`, payload, {

package/dist/esm/cli.js

@@ -106,6 +106,22 @@ async function main() {
         cancel('Cancelled.');
         process.exit(0);
     }
+    // ── Who can see the docs (APIForge spec §6.1 levels, chosen by the creator per §6.3) ──────────────────
+    const visibilityChoice = await select({
+        message: 'Who can see these docs?',
+        initialValue: 'PRIVATE', // "Only me" — the backend's default too
+        options: [
+            { value: 'ORG_WIDE', label: `${bold('Everyone in the org')}  ${dim('— every member of your organization')}` },
+            { value: 'TEAM', label: `${bold('Team')}  ${dim('— people you add, plus admins and the Superadmin')}` },
+            { value: 'PRIVATE', label: `${bold('Only me')}  ${dim('— you, people you add, and the Superadmin')}` },
+        ],
+    });
+    if (isCancel(visibilityChoice)) {
+        cancel('Cancelled.');
+        process.exit(0);
+    }
+    // Read by uploadRoutes — in this process and in the server this CLI starts (it inherits the environment)
+    process.env.APIFORGE_VISIBILITY = visibilityChoice;
     const isLocal = backendChoice === 'local';
     const backendUrl = isLocal ? BACKEND_LOCAL : BACKEND_PROD;
     const dashboardUrl = isLocal ? DASHBOARD_LOCAL : DASHBOARD_PROD;

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/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,6 +1,6 @@
 {
   "name": "apiforge-analyzer",
-  "version": "1.3.8",
+  "version": "1.3.9",
   "description": "Universal API documentation generator for Express, Next.js, Vite, React Router, and Node.js",
   "type": "module",
   "main": "./dist/cjs/index.js",