syntaxshot-cli 1.0.2 → 1.0.4

package/README.md

@@ -94,3 +94,4 @@ Quick list: `syntaxshot themes`
 - `bin/syntaxshot.js` — CLI, plan limits, `--auto`, confirmation prompt, `login`/`logout`
 
 The license backend itself (Stripe webhook, `/api/v1/validate`, license key generation) lives in the separate `syntaxshot-api` project.
+# syntaxshot-cli

package/bin/syntaxshot.js

@@ -11,16 +11,14 @@ import { detectLang, tokenizeCode } from "../src/highlighter.js";
 import { renderSnippet } from "../src/renderer.js";
 import { renderSnippetSVG } from "../src/svgRenderer.js";
 import { checkAndConsume, FREE_LIMIT } from "../src/usage.js";
-import { findEligibleFiles } from "../src/scanner.js";
+import { findEligibleFiles, isEligibleFile } from "../src/scanner.js";
 import { activateLicense, logoutLicense, resolvePlan } from "../src/license.js";
 
 const program = new Command();
 
 program
   .name("syntaxshot")
-  .description(
-    "Generate syntax-highlighted code screenshots from your terminal.",
-  )
+  .description("Generate syntax-highlighted code screenshots from your terminal.")
   .version("1.0.0");
 
 program
@@ -30,7 +28,8 @@ program
     const result = await activateLicense(licenseKey.trim());
     if (!result.ok) {
       console.error(`❌ ${result.error}`);
-      process.exit(1);
+      process.exitCode = 1;
+      return;
     }
     console.log(`✅ License activated. Plan: ${result.plan}.`);
   });
@@ -45,9 +44,7 @@ program
 
 program
   .command("init")
-  .description(
-    "Create a .syntaxshotrc.json file with the default configuration",
-  )
+  .description("Create a .syntaxshotrc.json file with the default configuration")
   .action(() => writeDefaultConfig());
 
 program
@@ -55,22 +52,20 @@ program
   .description("List the available themes")
   .action(() => {
     console.log("Available themes:");
-    Object.entries(THEMES).forEach(([key, t]) =>
-      console.log(`  - ${key} (${t.label})`),
-    );
+    Object.entries(THEMES).forEach(([key, t]) => console.log(`  - ${key} (${t.label})`));
   });
 
 program
   .argument(
     "[paths...]",
-    "File(s) to capture (Free and Pro), or a folder to auto-scan (Pro only)",
+    "File(s) to capture (Free and Pro), or a folder to auto-scan (Pro only)"
   )
   .option("-t, --theme <name>", "Visual theme (overrides config)")
   .option("-f, --format <ext>", "png | jpg (overrides config)")
   .option("-o, --output <dir>", "Output folder (overrides config)")
   .option("--no-line-numbers", "Hide line numbers")
   .option("-y, --yes", "Skip the confirmation prompt when scanning a folder")
-  .option("--auto", "[Pro plan] auto-detect files changed via git")
+  .option("--auto", "[Pro plan] screenshot only the files changed since the last commit — perfect for reviews")
   .action(async (inputPaths, cmdOpts) => {
     const cwd = process.cwd();
     const config = loadConfig(cwd);
@@ -80,14 +75,14 @@ program
     const lineNumbers = cmdOpts.lineNumbers ?? config.lineNumbers;
     const plan = await resolvePlan(config.plan);
 
-    const allowedFormats =
-      plan === "pro" ? ["png", "jpg", "jpeg", "svg"] : ["png", "jpg", "jpeg"];
+    const allowedFormats = plan === "pro" ? ["png", "jpg", "jpeg", "svg"] : ["png", "jpg", "jpeg"];
     if (!allowedFormats.includes(format)) {
       console.error(
         `❌ The "${format}" format is a Pro plan feature. The Free plan supports png or jpg.\n` +
-          `   Use --format png or --format jpg, or upgrade to Pro for svg.`,
+        `   Use --format png or --format jpg, or upgrade to Pro for svg.`
       );
-      process.exit(1);
+      process.exitCode = 1;
+      return;
     }
 
     let targets = [];
@@ -95,18 +90,17 @@ program
     if (cmdOpts.auto) {
       if (plan !== "pro") {
         console.error(
-          "❌ --auto is a Pro plan feature. On the Free plan, list file(s) manually:\n   syntaxshot path/to/file.js",
+          "❌ --auto is a Pro plan feature. On the Free plan, list file(s) manually:\n   syntaxshot path/to/file.js"
         );
-        process.exit(1);
+        process.exitCode = 1;
+        return;
       }
       const changed = getChangedFilesFromGit();
       if (changed.length === 0) {
         console.log("No modified files detected via git. Nothing to capture.");
         return;
       }
-      console.log(
-        `🔎 Auto-detected ${changed.length} file(s) changed via git.`,
-      );
+      console.log(`🔎 Auto-detected ${changed.length} file(s) changed via git.`);
       targets = changed.map((f) => ({ file: path.resolve(f), scanRoot: null }));
     } else {
       const explicitFiles = [];
@@ -127,16 +121,14 @@ program
       if (directories.length > 0 && plan !== "pro") {
         console.error(
           "❌ Scanning a whole folder is a Pro plan feature.\n" +
-            "   On the Free plan, list files one by one:\n" +
-            "   syntaxshot file1.js file2.css file3.ts",
+          "   On the Free plan, list files one by one:\n" +
+          "   syntaxshot file1.js file2.css file3.ts"
         );
-        process.exit(1);
+        process.exitCode = 1;
+        return;
       }
 
-      targets = explicitFiles.map((f) => ({
-        file: path.resolve(f),
-        scanRoot: null,
-      }));
+      targets = explicitFiles.map((f) => ({ file: path.resolve(f), scanRoot: null }));
 
       for (const dir of directories) {
         const found = findEligibleFiles(dir, {
@@ -152,29 +144,22 @@ program
         if (scannedCount === 0) {
           console.log(
             `📁 Scanned: ${directories.map((d) => path.relative(cwd, d) || ".").join(", ")}\n` +
-              "No eligible files found (everything was excluded or unsupported).",
+            "No eligible files found (everything was excluded or unsupported)."
           );
           return;
         }
 
-        console.log(
-          `📁 Folder(s) scanned: ${directories.map((d) => path.relative(cwd, d) || ".").join(", ")}`,
-        );
-        console.log(
-          `📄 Found ${scannedCount} eligible file(s). This will generate ${scannedCount} image(s):`,
-        );
+        console.log(`📁 Folder(s) scanned: ${directories.map((d) => path.relative(cwd, d) || ".").join(", ")}`);
+        console.log(`📄 Found ${scannedCount} eligible file(s). This will generate ${scannedCount} image(s):`);
         targets
           .filter((t) => t.scanRoot)
           .slice(0, 25)
           .forEach((t) => console.log(`   - ${path.relative(cwd, t.file)}`));
-        if (scannedCount > 25)
-          console.log(`   ...and ${scannedCount - 25} more`);
+        if (scannedCount > 25) console.log(`   ...and ${scannedCount - 25} more`);
         console.log("");
 
         if (!cmdOpts.yes) {
-          const proceed = await askConfirmation(
-            `Continue and generate ${scannedCount} image(s)? (y/N) `,
-          );
+          const proceed = await askConfirmation(`Continue and generate ${scannedCount} image(s)? (y/N) `);
           if (!proceed) {
             console.log("Cancelled. No images were generated.");
             return;
@@ -186,10 +171,11 @@ program
     if (targets.length === 0) {
       console.error(
         "❌ You must provide at least one file or one folder.\n" +
-          "   Usage: syntaxshot path/to/file.js [another/file.ts ...]\n" +
-          "   Pro plan: syntaxshot path/to/folder   (scans and generates everything automatically)",
+        "   Usage: syntaxshot path/to/file.js [another/file.ts ...]\n" +
+        "   Pro plan: syntaxshot path/to/folder   (scans and generates everything automatically)"
       );
-      process.exit(1);
+      process.exitCode = 1;
+      return;
     }
 
     const check = checkAndConsume(plan, targets.length, cwd);
@@ -197,10 +183,11 @@ program
       console.error(
         `❌ Free plan limit reached (${FREE_LIMIT} images). You have ${Math.max(
           check.remaining,
-          0,
-        )} left. Upgrade to Pro for unlimited generation.`,
+          0
+        )} left. Upgrade to Pro for unlimited generation.`
       );
-      process.exit(1);
+      process.exitCode = 1;
+      return;
     }
 
     const resolvedOutputDir = path.resolve(cwd, outputDir);
@@ -219,17 +206,12 @@ program
     }
 
     if (plan === "free") {
-      console.log(
-        `ℹ️  Free plan: ${check.remaining} capture(s) left this month.`,
-      );
+      console.log(`ℹ️  Free plan: ${check.remaining} capture(s) left this month.`);
     }
   });
 
 async function askConfirmation(question) {
-  const rl = readline.createInterface({
-    input: process.stdin,
-    output: process.stdout,
-  });
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
   const answer = await rl.question(question);
   rl.close();
   return /^y(es)?$/i.test(answer.trim());
@@ -278,22 +260,28 @@ async function processFile(absPath, opts) {
   }
 
   fs.writeFileSync(outPath, buffer);
-  console.log(
-    `✅ ${path.relative(process.cwd(), absPath)} → ${path.relative(process.cwd(), outPath)}`,
-  );
+  console.log(`✅ ${path.relative(process.cwd(), absPath)} → ${path.relative(process.cwd(), outPath)}`);
 }
 
 function getChangedFilesFromGit() {
   try {
-    const output = execSync("git diff --name-only HEAD", { encoding: "utf-8" });
-    return output
-      .split("\n")
-      .map((l) => l.trim())
-      .filter(Boolean)
-      .filter((f) => fs.existsSync(f));
+    // Tracked files modified since the last commit (staged or not).
+    const modified = execSync("git diff --name-only HEAD", { encoding: "utf-8" });
+    // New files not yet tracked by git (e.g. a component you just created).
+    const untracked = execSync("git ls-files --others --exclude-standard", { encoding: "utf-8" });
+
+    const combined = new Set(
+      [...modified.split("\n"), ...untracked.split("\n")]
+        .map((l) => l.trim())
+        .filter(Boolean)
+    );
+
+    return [...combined]
+      .filter((f) => fs.existsSync(f) && fs.statSync(f).isFile())
+      .filter((f) => isEligibleFile(path.basename(f)));
   } catch {
     return [];
   }
 }
 
-program.parse();
+program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "syntaxshot-cli",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Genera capturas de codigo con resaltado de sintaxis desde la terminal",
   "type": "module",
   "bin": {

package/src/license.js

@@ -11,7 +11,7 @@ const REVALIDATE_AFTER_MS = 24 * 60 * 60 * 1000; // 24h
 // license for this long before falling back to Free.
 const OFFLINE_GRACE_MS = 7 * 24 * 60 * 60 * 1000; // 7 days
 
-const API_URL = process.env.SYNTAXSHOT_API_URL || "https://api.syntaxshot.dev";
+const API_URL = process.env.SYNTAXSHOT_API_URL || "https://syntaxshot-api.vercel.app";
 
 function readLicenseFile() {
   if (!fs.existsSync(LICENSE_FILE)) return null;
@@ -39,7 +39,16 @@ async function validateWithApi(licenseKey) {
 
 /** Called by `syntaxshot login <key>`. Validates once and stores it. */
 export async function activateLicense(licenseKey) {
-  const result = await validateWithApi(licenseKey);
+  let result;
+  try {
+    result = await validateWithApi(licenseKey);
+  } catch {
+    return {
+      ok: false,
+      error: "Couldn't reach the license server. Check your internet connection and try again.",
+    };
+  }
+
   if (!result.valid) {
     return { ok: false, error: result.error || "This license key is not active." };
   }
@@ -92,4 +101,4 @@ export async function resolvePlan(localConfigPlan) {
     if (cached.lastKnownValid && age < OFFLINE_GRACE_MS) return "pro";
     return "free";
   }
-}
+}

package/src/scanner.js

@@ -27,6 +27,12 @@ function isExcludedFile(fileName, excludedFilenames) {
   return false;
 }
 
+/** Same exclusion rule used by the folder scan, exposed for --auto (git mode). */
+export function isEligibleFile(fileName, opts = {}) {
+  const excludedFilenames = new Set([...DEFAULT_EXCLUDED_FILENAMES, ...(opts.excludeFiles || [])]);
+  return !isExcludedFile(fileName, excludedFilenames) && !!EXT_TO_LANG[path.extname(fileName).toLowerCase()];
+}
+
 /**
  * Recursively walks `rootDir` and returns the absolute paths of
  * "capturable" files: they have a recognized language extension and are not
@@ -60,4 +66,4 @@ export function findEligibleFiles(rootDir, opts = {}) {
 
   walk(rootDir);
   return results;
-}
+}

package/.syntaxshot-usage.json

@@ -1,3 +0,0 @@
-{
-  "count": 1
-}

package/.syntaxshotrc.json

@@ -1,11 +0,0 @@
-{
-  "theme": "solar",
-  "format": "png",
-  "output": "syntaxshots",
-  "fontSize": 16,
-  "lineNumbers": true,
-  "quality": 0.95,
-  "excludeDirs": [],
-  "excludeFiles": [],
-  "plan": "pro"
-}