feat: add telemetry for performance metrics and opt-out option

Author: brrock

README.md

@@ -104,6 +104,18 @@ bun run benchmark
 
 > Results may vary based on your app size and system. The test app includes 4 routes with images, fonts, and interactivity.
 
+## Telemetry
+
+Anonymized telemetry is collected to help improve the tool. **No IP addresses are tracked.** All we collect is time taken and RAM used. 
+
+To disable telemetry:
+
+```bash
+NEXT_SINGLE_FILE_NO_TELEMETRY=1 bunx next-single-file --input out
+```
+
+Telemetry is sent by default. Set the above env var to opt out.
+
 ## Development
 
 ```bash

index.ts

@@ -3,6 +3,7 @@ import { parseNextOutput } from "./src/parser";
 import { inlineAssets } from "./src/inliner";
 import { generateRouterShim } from "./src/router";
 import { bundleToSingleHtml } from "./src/bundler";
+import { sendTelemetry, getMemoryUsage } from "./src/telemetry";
 import { $ } from "bun";
 
 function parseArgs() {
@@ -30,6 +31,8 @@ function parseArgs() {
 
 const { inputDir, outputFile } = parseArgs();
 
+const startTime = Date.now();
+
 console.log(`📖 Parsing Next.js output from: ${inputDir}`);
 const parsed = await parseNextOutput(inputDir);
 
@@ -50,7 +53,16 @@ const html = bundleToSingleHtml(inlined, routerShim);
 await $`mkdir -p ${outputFile.split("/").slice(0, -1).join("/") || "."}`.quiet();
 await Bun.write(outputFile, html);
 
+const endTime = Date.now();
+const memoryUsed = getMemoryUsage();
+
 console.log(`✅ Done! Output: ${outputFile}`);
 console.log(`   Size: ${(html.length / 1024).toFixed(1)} KB`);
+console.log(`   Time: ${(endTime - startTime)} ms`);
+console.log(`   Memory: ${memoryUsed} MB`);
 console.log("Star us: https://github.com/simples-tools/next-single-file");   
-console.log("Report bugs: https://github.com/simples-tools/next-single-file/issues");
+console.log("Report bugs: https://github.com/simples-tools/next-single-file/issues");
+
+if (process.env.NEXT_SINGLE_FILE_NO_TELEMETRY !== "1") {
+  await sendTelemetry(endTime - startTime, memoryUsed);
+}

package.json

@@ -1,6 +1,6 @@
 {
   "name": "next-single-file",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "Convert Next.js static export to a single HTML file with hash routing",
   "bin": {
     "next-single-file": "dist/cli.js"

src/telemetry.ts

@@ -0,0 +1,24 @@
+export async function sendTelemetry(time: number, ram: number): Promise<void> {
+  const endpoint = "https://next-single-file-backend.vercel.app/";
+
+  try {
+    const response = await fetch(endpoint, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ time, ram }),
+    });
+
+    if (!response.ok) {
+      console.error("Telemetry failed:", response.statusText);
+      return;
+    }
+
+  } catch (error) {
+    console.error("Telemetry error:", error);
+  }
+}
+
+export function getMemoryUsage(): number {
+  const usage = process.memoryUsage();
+  return Math.round(usage.heapTotal / 1024 / 1024);
+}