@vention/vention-cli 0.12.1 → 0.13.0

package/cli.esm.js

@@ -10,6 +10,7 @@ import { URLSearchParams, fileURLToPath } from 'url';
 import { once } from 'events';
 import crypto from 'crypto';
 import { z } from 'zod';
+import { createRequire } from 'module';
 
 const getConfigPath = () => {
     const homeDir = process.env.HOME || process.env.USERPROFILE;
@@ -217,6 +218,132 @@ const loginWithSso = async (environment) => {
 };
 const getSsoEnvironmentConfig = getSsoConfig;
 
+let verboseEnabled = false;
+const setVerbose = (enabled) => {
+    verboseEnabled = enabled;
+};
+const isVerbose = () => verboseEnabled;
+const verboseLog = (message) => {
+    if (verboseEnabled) {
+        console.log(chalk.dim("[verbose]"), message);
+    }
+};
+
+class ApiError extends Error {
+    constructor(message, status, statusText, responseBody, url) {
+        super(message);
+        this.status = status;
+        this.statusText = statusText;
+        this.responseBody = responseBody;
+        this.url = url;
+        this.name = "ApiError";
+    }
+}
+async function assertApiResponseOk(res, url) {
+    if (!res.ok) {
+        let responseBody;
+        let text = "";
+        try {
+            text = await res.text();
+            responseBody = text ? JSON.parse(text) : null;
+        }
+        catch (_a) {
+            responseBody = text || null;
+        }
+        throw new ApiError(`Request failed: ${res.status} ${res.statusText}`, res.status, res.statusText, responseBody, url);
+    }
+}
+const ERROR_SUGGESTIONS = {
+    400: {
+        default: ["The request was invalid. Check the server response above for details."],
+        byEndpoint: {
+            library: [
+                "The application data may be invalid or corrupted.",
+                "Try running 'vention unlink' and then 'vention link' to re-link the application.",
+            ],
+        },
+    },
+    401: {
+        default: ["Authentication error. Try running 'vention login' to re-authenticate."],
+    },
+    403: {
+        default: ["Authentication error. Try running 'vention login' to re-authenticate."],
+    },
+    404: {
+        default: ["The requested resource was not found."],
+        byEndpoint: {
+            allocations: ["No active session found for this design.", "Make sure the design is open in your browser with a live session."],
+            library: [
+                "The application was not found on the digital twin.",
+                "The application may have been deleted or the session may have expired.",
+                "Try refreshing the design in your browser and running 'vention link' again.",
+            ],
+        },
+    },
+    413: {
+        default: ["The payload is too large."],
+        byEndpoint: {
+            library: [
+                "The application is too large to push.",
+                "Remove these from the application directory before pushing again:",
+                "  - .venv or venv (Python virtual environment)",
+                "  - node_modules (Node.js dependencies)",
+                "  - Large data files or binary assets",
+            ],
+        },
+    },
+    500: {
+        default: ["The server encountered an error.", "This is likely a temporary issue. Please try again in a few moments."],
+    },
+};
+const ENDPOINT_PATTERNS = [
+    ["allocations", "/allocations"],
+    ["library", "/library"],
+];
+const getEndpointFromUrl = (url) => { var _a; return (_a = ENDPOINT_PATTERNS.find(([, pattern]) => url.includes(pattern))) === null || _a === void 0 ? void 0 : _a[0]; };
+const getErrorSuggestions = (status, url) => {
+    var _a, _b, _c;
+    const entry = (_a = ERROR_SUGGESTIONS[status]) !== null && _a !== void 0 ? _a : (status >= 500 ? ERROR_SUGGESTIONS[500] : undefined);
+    if (!entry)
+        return [];
+    const endpoint = getEndpointFromUrl(url);
+    return (_c = (endpoint && ((_b = entry.byEndpoint) === null || _b === void 0 ? void 0 : _b[endpoint]))) !== null && _c !== void 0 ? _c : entry.default;
+};
+const handleCommandError = (error, context) => {
+    console.error(chalk.red(`${context}:`));
+    if (error instanceof ApiError) {
+        console.error(chalk.red(`HTTP ${error.status}: ${error.statusText}`));
+        if (error.responseBody) {
+            console.error(chalk.yellow("Server response:"));
+            console.error(chalk.dim(JSON.stringify(error.responseBody, null, 2)));
+        }
+        if (isVerbose()) {
+            console.error(chalk.dim(`URL: ${error.url}`));
+        }
+        const suggestions = getErrorSuggestions(error.status, error.url);
+        if (suggestions.length > 0) {
+            console.error();
+            suggestions.forEach(msg => console.error(chalk.yellow(msg)));
+        }
+    }
+    else {
+        console.error(chalk.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
+    }
+    process.exit(1);
+};
+
+const fetchJson = async (url, options = {}) => {
+    const { method = "GET", headers = {}, body } = options;
+    verboseLog(`${method} ${url}`);
+    const res = await fetch(url, {
+        method,
+        headers,
+        body: body !== undefined ? JSON.stringify(body) : undefined,
+    });
+    await assertApiResponseOk(res, url);
+    return await res.json();
+};
+
 const getDigitalTwinUrl = (environment, sessionId) => {
     switch (environment) {
         case "local":
@@ -234,17 +361,13 @@ const getAllApplicationsWithSourceCode = async (environment, designId, sessionId
         throw new Error("Linked session token is not set");
     }
     const digitalTwinUrl = getDigitalTwinUrl(environment, sessionId);
-    const res = await fetch(`${digitalTwinUrl}/v2/library`, {
-        method: "GET",
+    const url = `${digitalTwinUrl}/v2/library`;
+    const response = await fetchJson(url, {
         headers: {
             Accept: "application/json",
             Cookie: `digital-twin-session-${designId}=s%3A${sessionId}.s`,
         },
     });
-    if (!res.ok) {
-        throw new Error(`Request failed: ${res.status} ${res.statusText}`);
-    }
-    const response = await res.json();
     return response.applications || [];
 };
 const pushApplicationToDigitalTwin = async (environment, designId, sessionId, application) => {
@@ -252,19 +375,16 @@ const pushApplicationToDigitalTwin = async (environment, designId, sessionId, ap
         throw new Error("Linked session token is not set");
     }
     const digitalTwinUrl = getDigitalTwinUrl(environment, sessionId);
-    const res = await fetch(`${digitalTwinUrl}/v1/library`, {
+    const url = `${digitalTwinUrl}/v1/library`;
+    return await fetchJson(url, {
         method: "PUT",
         headers: {
             "Content-Type": "application/json",
             Accept: "application/json",
             Cookie: `digital-twin-session-${designId}=s%3A${sessionId}.s`,
         },
-        body: JSON.stringify(application),
+        body: application,
     });
-    if (!res.ok) {
-        throw new Error(`Request failed: ${res.status} ${res.statusText}`);
-    }
-    return await res.json();
 };
 
 const STATE_FILENAME = ".machine-code-app-directory-info.json";
@@ -301,15 +421,8 @@ const getBaseRailsUrl = (environment) => {
 const getUserAllocations = async (session) => {
     const baseUrl = getBaseRailsUrl(session.environment);
     const headers = await getAuthHeaders(session);
-    const res = await fetch(`${baseUrl}/api/v3/digital_twin_infrastructure/allocations`, {
-        method: "GET",
-        headers,
-    });
-    if (!res.ok) {
-        throw new Error(`Request failed: ${res.status} ${res.statusText}`);
-    }
-    const response = await res.json();
-    return response;
+    const url = `${baseUrl}/api/v3/digital_twin_infrastructure/allocations`;
+    return await fetchJson(url, { headers });
 };
 const getAuthHeaders = async (session) => {
     var _a;
@@ -342,7 +455,7 @@ const getAuthHeaders = async (session) => {
 };
 
 const getDefaultIgnorePatterns = () => {
-    return new Set(["venv", "node_modules", "dist", "build", "__pycache__", /\.egg-info$/, ".machine-code-app-directory-info.json"]);
+    return new Set(["venv", ".venv", "node_modules", "dist", "build", "__pycache__", /\.egg-info$/, ".machine-code-app-directory-info.json"]);
 };
 const shouldIgnoreFileSystemNode = (nodeName, ignoredNodes) => {
     for (const pattern of ignoredNodes) {
@@ -540,8 +653,29 @@ const selectDesignAndApp = async (session) => {
     };
 };
 
+const require$1 = createRequire(import.meta.url);
+function loadPackageJson() {
+    try {
+        return require$1("./package.json");
+    }
+    catch (_a) {
+        return require$1("../package.json");
+    }
+}
+const packageJson = loadPackageJson();
 const program = new Command();
-program.name("vention").description("CLI tool for Vention").version("0.2.0");
+program
+    .name("vention")
+    .description("CLI tool for Vention")
+    .version(packageJson.version)
+    .option("--verbose", "Enable verbose output for debugging")
+    .hook("preAction", thisCommand => {
+    const opts = thisCommand.opts();
+    setVerbose(opts.verbose === true);
+})
+    .hook("postAction", () => {
+    setVerbose(false);
+});
 const ventionLogo = `
   ╔════════════════════════════════════════════════════════════════════════════════════════════════════════╗
   ║                                                                                                        ║
@@ -629,10 +763,7 @@ program
         console.log(chalk.blue("You can now use 'vention pull' to download app content or 'vention push' to upload local changes."));
     }
     catch (error) {
-        console.log();
-        console.error(chalk.red("Failed to link directory:"));
-        console.error(chalk.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
-        process.exit(1);
+        handleCommandError(error, "Failed to link directory");
     }
 });
 program
@@ -708,10 +839,7 @@ program
         console.log(chalk.blue("💡 Your changes have been uploaded!"));
     }
     catch (error) {
-        console.log();
-        console.error(chalk.red("Failed to push application:"));
-        console.error(chalk.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
-        process.exit(1);
+        handleCommandError(error, "Failed to push application");
     }
 });
 program
@@ -736,10 +864,7 @@ program
         }
     }
     catch (error) {
-        console.log();
-        console.error(chalk.red("Failed to pull application:"));
-        console.error(chalk.red(`Error: ${error instanceof Error ? error.message : String(error)}`));
-        process.exit(1);
+        handleCommandError(error, "Failed to pull application");
     }
 });
 const resolvedArgv = realpathSync(process.argv[1]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vention/vention-cli",
-  "version": "0.12.1",
+  "version": "0.13.0",
   "description": "CLI tool for Vention applications",
   "type": "module",
   "engines": {
@@ -23,7 +23,7 @@
     "chalk": "4.1.2",
     "commander": "14.0.2",
     "@inquirer/prompts": "7.6.0",
-    "zod": "3.23.8"
+    "zod": "3.25.76"
   },
   "devDependencies": {
     "@nx/vite": "21.1.3",

package/src/digital-twin-client.d.ts

@@ -11,4 +11,4 @@ export interface Application {
 }
 export declare const getDigitalTwinUrl: (environment: SessionData["environment"], sessionId: string) => string;
 export declare const getAllApplicationsWithSourceCode: (environment: SessionData["environment"], designId: number, sessionId: string) => Promise<Application[]>;
-export declare const pushApplicationToDigitalTwin: (environment: SessionData["environment"], designId: number, sessionId: string, application: Application) => Promise<void>;
+export declare const pushApplicationToDigitalTwin: <T = unknown>(environment: SessionData["environment"], designId: number, sessionId: string, application: Application) => Promise<T>;

package/src/error-handler.d.ts

@@ -0,0 +1,9 @@
+export declare class ApiError extends Error {
+    readonly status: number;
+    readonly statusText: string;
+    readonly responseBody: unknown;
+    readonly url: string;
+    constructor(message: string, status: number, statusText: string, responseBody: unknown, url: string);
+}
+export declare function assertApiResponseOk(res: Response, url: string): Promise<void>;
+export declare const handleCommandError: (error: unknown, context: string) => never;

package/src/error-handler.test.d.ts

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

package/src/fetch-helper.d.ts

@@ -0,0 +1,8 @@
+type HttpMethod = "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+interface FetchOptions {
+    method?: HttpMethod;
+    headers?: Record<string, string>;
+    body?: unknown;
+}
+export declare const fetchJson: <T>(url: string, options?: FetchOptions) => Promise<T>;
+export {};

package/src/fetch-helper.test.d.ts

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

package/src/verbose-logger.d.ts

@@ -0,0 +1,3 @@
+export declare const setVerbose: (enabled: boolean) => void;
+export declare const isVerbose: () => boolean;
+export declare const verboseLog: (message: string) => void;

package/src/verbose-logger.test.d.ts

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