usetraceforge-cli 0.1.10 → 0.1.13

package/dist/index.js

@@ -3,6 +3,9 @@ import { intro, outro, text, select, spinner } from "@clack/prompts";
 import chalk from "chalk";
 import { execa } from "execa";
 import { installNextJs } from "./installers/nextjs.js";
+import { installExpress } from "./installers/express.js";
+import { installReact } from "./installers/react.js";
+import { installNode } from "./installers/node.js";
 async function main() {
     console.log();
     intro(chalk.bgBlue(chalk.white(" Welcome to TraceForge ")));
@@ -27,7 +30,9 @@ async function main() {
         message: "Which framework are you using?",
         options: [
             { value: "nextjs", label: "Next.js (Prebuilt)" },
-            { value: "express", label: "Express.js (Prebuilt)" },
+            { value: "express", label: "Express.js (Auto Setup)" },
+            { value: "react", label: "React (Manual Setup)" },
+            { value: "node", label: "Raw Node.js (Manual Setup)" },
         ],
     });
     if (typeof framework !== "string") {
@@ -49,7 +54,13 @@ async function main() {
         await installNextJs(apiKey, endpoint);
     }
     else if (framework === "express") {
-        console.log(chalk.yellow("Express auto-installation coming soon."));
+        await installExpress(apiKey, endpoint);
+    }
+    else if (framework === "react") {
+        await installReact(apiKey, endpoint);
+    }
+    else if (framework === "node") {
+        await installNode(apiKey, endpoint);
     }
     outro(chalk.green("✨ You're all set! TraceForge is now protecting your application."));
 }

package/dist/installers/express.js

@@ -0,0 +1,119 @@
+import fs from "fs";
+import path from "path";
+import { spinner } from "@clack/prompts";
+import chalk from "chalk";
+import { Project, SyntaxKind } from "ts-morph";
+function printManualInstructions() {
+    console.log(chalk.cyan(`\n=================================================`));
+    console.log(chalk.bold.white(`🚀 Express.js Manual Setup Instructions`));
+    console.log(chalk.cyan(`=================================================\n`));
+    console.log(`Add this at the ${chalk.bold('TOP')} of your main file (e.g. app.js or server.js):`);
+    console.log(chalk.yellow(`
+import TraceForge from "usetraceforge";
+import { expressErrorHandler } from "usetraceforge/express";
+
+TraceForge.init({ 
+  apiKey: process.env.TRACEFORGE_API_KEY, 
+  endpoint: process.env.TRACEFORGE_INGEST_URL 
+});
+`));
+    console.log(`Then, add the middleware at the ${chalk.bold('VERY END')} of your routes:`);
+    console.log(chalk.yellow(`
+// ... all your other app.use() and app.get() routes ...
+
+app.use(expressErrorHandler());
+
+// ... your custom error handlers (if any) ...
+app.listen(3000);
+`));
+}
+export async function installExpress(apiKey, endpoint) {
+    const s = spinner();
+    s.start("Agent: Configuring Express.js environment...");
+    try {
+        const envPath = path.resolve(process.cwd(), ".env");
+        const envVar = `\nTRACEFORGE_API_KEY="${apiKey}"\nTRACEFORGE_INGEST_URL="${endpoint}"\n`;
+        if (fs.existsSync(envPath)) {
+            let content = fs.readFileSync(envPath, "utf-8");
+            if (content.includes("TRACEFORGE_API_KEY")) {
+                content = content.replace(/TRACEFORGE_API_KEY=.*/g, `TRACEFORGE_API_KEY="${apiKey}"`);
+                content = content.replace(/TRACEFORGE_INGEST_URL=.*/g, `TRACEFORGE_INGEST_URL="${endpoint}"`);
+                fs.writeFileSync(envPath, content);
+            }
+            else {
+                fs.appendFileSync(envPath, envVar);
+            }
+        }
+        else {
+            fs.writeFileSync(envPath, envVar);
+        }
+        s.stop(chalk.green("Agent: .env configured successfully!"));
+        const project = new Project();
+        const possiblePaths = [
+            "app.ts", "app.js",
+            "server.ts", "server.js",
+            "index.ts", "index.js",
+            "src/app.ts", "src/app.js",
+            "src/server.ts", "src/server.js",
+            "src/index.ts", "src/index.js",
+            "bin/www", "bin/www.js"
+        ];
+        let targetFile = null;
+        for (const p of possiblePaths) {
+            const fullPath = path.resolve(process.cwd(), p);
+            if (fs.existsSync(fullPath)) {
+                targetFile = fullPath;
+                break; // First match wins
+            }
+        }
+        if (!targetFile) {
+            console.log(chalk.yellow("\nAgent: Could not find your Express entrypoint file automatically."));
+            printManualInstructions();
+            return;
+        }
+        const sourceFile = project.addSourceFileAtPath(targetFile);
+        let astSuccess = false;
+        const callExpressions = sourceFile.getDescendantsOfKind(SyntaxKind.CallExpression);
+        let listenCall = null;
+        let appVariableName = null;
+        for (const callExpr of callExpressions) {
+            const expression = callExpr.getExpression();
+            if (expression.getKind() === SyntaxKind.PropertyAccessExpression) {
+                const propAccess = expression.asKindOrThrow(SyntaxKind.PropertyAccessExpression);
+                if (propAccess.getName() === "listen") {
+                    listenCall = callExpr;
+                    appVariableName = propAccess.getExpression().getText();
+                    break;
+                }
+            }
+        }
+        if (listenCall && appVariableName) {
+            const listenStatement = listenCall.getFirstAncestorByKind(SyntaxKind.ExpressionStatement);
+            if (listenStatement) {
+                if (!sourceFile.getFullText().includes("TraceForge.init")) {
+                    // Inject imports and init at the top
+                    sourceFile.insertStatements(0, `import TraceForge from "usetraceforge";\nimport { expressErrorHandler } from "usetraceforge/express";\n\nTraceForge.init({\n  apiKey: process.env.TRACEFORGE_API_KEY as string,\n  endpoint: process.env.TRACEFORGE_INGEST_URL\n});\n`);
+                    // Inject middleware right before app.listen()
+                    const listenIndex = listenStatement.getChildIndex();
+                    sourceFile.insertStatements(listenIndex, `\n// TraceForge must be the last middleware before listen\n${appVariableName}.use(expressErrorHandler());\n`);
+                    sourceFile.saveSync();
+                    console.log(chalk.green(`\nAgent: Auto-injected TraceForge into ${targetFile.replace(process.cwd(), "")}!`));
+                    astSuccess = true;
+                }
+                else {
+                    console.log(chalk.blue(`\nAgent: TraceForge is already configured in ${targetFile.replace(process.cwd(), "")}`));
+                    astSuccess = true;
+                }
+            }
+        }
+        if (!astSuccess) {
+            console.log(chalk.yellow(`\nAgent: Found ${targetFile.replace(process.cwd(), "")} but could not auto-inject safely.`));
+            printManualInstructions();
+        }
+    }
+    catch (error) {
+        s.stop(chalk.red("Agent: An error occurred during Express configuration."));
+        console.error(error);
+        printManualInstructions();
+    }
+}

package/dist/installers/nextjs.js

@@ -11,8 +11,13 @@ export async function installNextJs(apiKey, endpoint) {
         const envPath = path.resolve(process.cwd(), ".env.local");
         const envVar = `\nNEXT_PUBLIC_TRACEFORGE_API_KEY="${apiKey}"\nNEXT_PUBLIC_TRACEFORGE_INGEST_URL="${endpoint}"\n`;
         if (fs.existsSync(envPath)) {
-            const content = fs.readFileSync(envPath, "utf-8");
-            if (!content.includes("NEXT_PUBLIC_TRACEFORGE_API_KEY")) {
+            let content = fs.readFileSync(envPath, "utf-8");
+            if (content.includes("NEXT_PUBLIC_TRACEFORGE_API_KEY")) {
+                content = content.replace(/NEXT_PUBLIC_TRACEFORGE_API_KEY=.*/g, `NEXT_PUBLIC_TRACEFORGE_API_KEY="${apiKey}"`);
+                content = content.replace(/NEXT_PUBLIC_TRACEFORGE_INGEST_URL=.*/g, `NEXT_PUBLIC_TRACEFORGE_INGEST_URL="${endpoint}"`);
+                fs.writeFileSync(envPath, content);
+            }
+            else {
                 fs.appendFileSync(envPath, envVar);
             }
         }

package/dist/installers/node.js

@@ -0,0 +1,51 @@
+import fs from "fs";
+import path from "path";
+import { spinner } from "@clack/prompts";
+import chalk from "chalk";
+export async function installNode(apiKey, endpoint) {
+    const s = spinner();
+    s.start("Agent: Configuring Node.js environment...");
+    try {
+        const envPath = path.resolve(process.cwd(), ".env");
+        const envVar = `\nTRACEFORGE_API_KEY="${apiKey}"\nTRACEFORGE_INGEST_URL="${endpoint}"\n`;
+        if (fs.existsSync(envPath)) {
+            let content = fs.readFileSync(envPath, "utf-8");
+            if (content.includes("TRACEFORGE_API_KEY")) {
+                content = content.replace(/TRACEFORGE_API_KEY=.*/g, `TRACEFORGE_API_KEY="${apiKey}"`);
+                content = content.replace(/TRACEFORGE_INGEST_URL=.*/g, `TRACEFORGE_INGEST_URL="${endpoint}"`);
+                fs.writeFileSync(envPath, content);
+            }
+            else {
+                fs.appendFileSync(envPath, envVar);
+            }
+        }
+        else {
+            fs.writeFileSync(envPath, envVar);
+        }
+        s.stop(chalk.green("Agent: .env configured successfully!"));
+        console.log(chalk.cyan(`\n=================================================`));
+        console.log(chalk.bold.white(`🚀 Node.js Manual Setup Instructions`));
+        console.log(chalk.cyan(`=================================================\n`));
+        console.log(`Add this to your entrypoint file:`);
+        console.log(chalk.yellow(`
+import TraceForge from "usetraceforge";
+
+TraceForge.init({ 
+  apiKey: process.env.TRACEFORGE_API_KEY, 
+  endpoint: process.env.TRACEFORGE_INGEST_URL 
+});
+`));
+        console.log(`Then, manually capture errors like this:`);
+        console.log(chalk.yellow(`
+try {
+  // your code
+} catch (error) {
+  TraceForge.captureException(error);
+}
+`));
+    }
+    catch (error) {
+        s.stop(chalk.red("Agent: An error occurred."));
+        console.error(error);
+    }
+}

package/dist/installers/react.js

@@ -0,0 +1,57 @@
+import fs from "fs";
+import path from "path";
+import { spinner } from "@clack/prompts";
+import chalk from "chalk";
+export async function installReact(apiKey, endpoint) {
+    const s = spinner();
+    s.start("Agent: Configuring React environment...");
+    try {
+        // For React, usually Vite uses VITE_ prefix, CRA uses REACT_APP_
+        // Let's create a generic .env but also print the keys
+        const envPath = path.resolve(process.cwd(), ".env");
+        const envVar = `\nVITE_TRACEFORGE_API_KEY="${apiKey}"\nVITE_TRACEFORGE_INGEST_URL="${endpoint}"\nREACT_APP_TRACEFORGE_API_KEY="${apiKey}"\nREACT_APP_TRACEFORGE_INGEST_URL="${endpoint}"\n`;
+        if (fs.existsSync(envPath)) {
+            let content = fs.readFileSync(envPath, "utf-8");
+            if (content.includes("TRACEFORGE_API_KEY")) {
+                content = content.replace(/VITE_TRACEFORGE_API_KEY=.*/g, `VITE_TRACEFORGE_API_KEY="${apiKey}"`);
+                content = content.replace(/VITE_TRACEFORGE_INGEST_URL=.*/g, `VITE_TRACEFORGE_INGEST_URL="${endpoint}"`);
+                content = content.replace(/REACT_APP_TRACEFORGE_API_KEY=.*/g, `REACT_APP_TRACEFORGE_API_KEY="${apiKey}"`);
+                content = content.replace(/REACT_APP_TRACEFORGE_INGEST_URL=.*/g, `REACT_APP_TRACEFORGE_INGEST_URL="${endpoint}"`);
+                fs.writeFileSync(envPath, content);
+            }
+            else {
+                fs.appendFileSync(envPath, envVar);
+            }
+        }
+        else {
+            fs.writeFileSync(envPath, envVar);
+        }
+        s.stop(chalk.green("Agent: .env configured successfully!"));
+        console.log(chalk.cyan(`\n=================================================`));
+        console.log(chalk.bold.white(`🚀 React Manual Setup Instructions`));
+        console.log(chalk.cyan(`=================================================\n`));
+        console.log(`Open your main file (e.g. App.tsx or main.tsx) and wrap your app:`);
+        console.log(chalk.yellow(`
+import TraceForge from "usetraceforge";
+import { TraceForgeProvider } from "usetraceforge/react";
+
+// For Vite use import.meta.env, for CRA use process.env
+TraceForge.init({ 
+  apiKey: import.meta.env.VITE_TRACEFORGE_API_KEY, 
+  endpoint: import.meta.env.VITE_TRACEFORGE_INGEST_URL 
+});
+
+export default function App() {
+  return (
+    <TraceForgeProvider>
+      <YourComponents />
+    </TraceForgeProvider>
+  );
+}
+`));
+    }
+    catch (error) {
+        s.stop(chalk.red("Agent: An error occurred."));
+        console.error(error);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "usetraceforge-cli",
-  "version": "0.1.10",
+  "version": "0.1.13",
   "description": "TraceForge CLI Wizard for 2-click installations",
   "bin": {
     "traceforge": "./dist/index.js"