snapfail 0.0.15 → 0.0.16

package/package.json

@@ -1,22 +1,26 @@
 {
   "name": "snapfail",
-  "version": "0.0.15",
-  "description": "CLI to initialise SnapFail error-tracking in Vite & Astro projects",
+  "version": "0.0.16",
   "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "description": "CLI for snapfail — project setup, incident inspection and AI diagnostics",
+  "license": "MIT",
   "bin": {
-    "snapfail": "bin/snapfail.js"
+    "snapfail": "./src/index.ts"
   },
-  "files": [
-    "dist",
-    "bin"
-  ],
+  "main": "./src/index.ts",
+  "publishConfig": {
+    "bin": {
+      "snapfail": "./dist/index.js"
+    },
+    "main": "./dist/index.js"
+  },
+  "files": ["dist"],
   "scripts": {
-    "build": "bun build ./src/index.ts --outfile ./dist/index.js --target=node --sourcemap=none && bunx tsc --project tsconfig.json --declaration --emitDeclarationOnly --outDir dist --noEmit false",
-    "dev": "bun --watch ./src/index.ts"
+    "build": "bun build src/index.ts --outdir dist --target bun --format esm --sourcemap=none",
+    "prepublishOnly": "bun run build"
   },
-  "engines": {
-    "node": ">=18"
+  "dependencies": {
+    "@clack/prompts": "^1.5.1",
+    "@snapfail/protocol": "^0.0.1"
   }
 }

package/src/index.ts

@@ -0,0 +1,95 @@
+#!/usr/bin/env bun
+import { runIncidents } from "./commands/incidents.ts";
+import { runIncident } from "./commands/incident.ts";
+import { runInit } from "./commands/init.ts";
+import { runExplain } from "./commands/explain.ts";
+
+function parseArgs(argv: string[]): {
+  command: string;
+  args: string[];
+  flags: Record<string, string | boolean>;
+} {
+  const [, , rawCommand = "incidents", ...rest] = argv;
+  const command = rawCommand;
+  const args: string[] = [];
+  const flags: Record<string, string | boolean> = {};
+
+  for (const token of rest) {
+    if (token.startsWith("--")) {
+      const eq = token.indexOf("=");
+      if (eq !== -1) {
+        flags[token.slice(2, eq)] = token.slice(eq + 1);
+      } else {
+        flags[token.slice(2)] = true;
+      }
+    } else {
+      args.push(token);
+    }
+  }
+
+  return { command, args, flags };
+}
+
+const VERSION = "0.0.16";
+
+async function main(): Promise<void> {
+  const { command, args, flags } = parseArgs(process.argv);
+  const json = flags["json"] === true;
+
+  if (command === "--version" || command === "-v" || flags["version"] === true) {
+    console.log(VERSION);
+    return;
+  }
+
+  try {
+    if (command === "init") {
+      await runInit();
+      return;
+    }
+
+    if (command === "incidents") {
+      await runIncidents({
+        json,
+        status: typeof flags["status"] === "string" ? flags["status"] : undefined,
+        limit: typeof flags["limit"] === "string" ? parseInt(flags["limit"]) : undefined,
+        offset: typeof flags["offset"] === "string" ? parseInt(flags["offset"]) : undefined,
+      });
+      return;
+    }
+
+    if (command === "incident") {
+      const id = args[0];
+      if (!id) {
+        console.error("Usage: snapfail incident <id> [--sample <n>] [--json]");
+        process.exit(1);
+      }
+      const sampleFlag = flags["sample"];
+      const sample =
+        typeof sampleFlag === "string" ? parseInt(sampleFlag) : undefined;
+      await runIncident({ id, sample, json });
+      return;
+    }
+
+    if (command === "explain") {
+      const id = args[0];
+      if (!id) {
+        console.error("Usage: snapfail explain <id> [--force] [--json]");
+        process.exit(1);
+      }
+      await runExplain({ id, force: flags["force"] === true, json });
+      return;
+    }
+
+    console.error(`Unknown command: ${command}`);
+    console.error(`snapfail v${VERSION} — Usage: snapfail [incidents|incident|init|explain] [--version]`);
+    process.exit(1);
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(`Error: ${message}`);
+    process.exit(1);
+  }
+}
+
+if (import.meta.main) {
+  main();
+}

package/README.md

@@ -1,78 +0,0 @@
-# snapfail
-
-> **The official Command Line Interface (CLI) to automatically initialize and configure SnapFail error-tracking.**
-
-[![npm version](https://img.shields.io/npm/v/snapfail.svg)](https://www.npmjs.com/package/snapfail)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
-**SnapFail CLI** is a terminal-based onboarding utility that automatically configures and integrates SnapFail error tracking and session replays inside your Vite and Astro codebases in seconds.
-
-Visit the live telemetry dashboard at [app.snapfail.com](https://app.snapfail.com).
-
----
-
-## Getting Started
-
-You do not need to install the CLI permanently. You can run it on-demand using standard Node `npx`:
-
-```bash
-npx snapfail init
-```
-
-Or, if you prefer, install it globally on your system:
-
-```bash
-# npm
-npm install -g snapfail
-
-# pnpm
-pnpm add -g snapfail
-
-# Bun
-bun add -g snapfail
-```
-
-Once installed globally, you can invoke the CLI with:
-```bash
-snapfail init
-```
-
----
-
-## Interactive Onboarding Flow
-
-Running `snapfail init` initiates a guided terminal onboarding experience:
-
-1. **Dashboard Authentication:** Automatically opens your default web browser to [app.snapfail.com/cli-auth](https://app.snapfail.com/cli-auth), securely performing a local CORS-approved handshake to authorize your CLI session.
-2. **Project Selection:** Fetches your existing projects from the SnapFail dashboard, allowing you to select one or instantly create a new one right from the terminal.
-3. **Session Replay Setup:** Prompts whether you want to enable **rrweb Session Replays** (enables full 60-second DOM playback video captures of browser crashes).
-4. **Codebase Inspection:** Detects your project's build tool configuration:
-   * **Astro Project:** Locates `astro.config.mjs` / `astro.config.ts`, automatically installs `@snapfail/sdk` using your project's active package manager (`npm`, `pnpm`, `yarn`, or `bun`), and safely injects the `snapfail` integration.
-   * **Vite Project:** Locates `vite.config.js` / `vite.config.ts`, automatically installs `@snapfail/sdk`, and injects the `snapfail` Vite plugin.
-   * **Vanilla HTML:** Provides a ready-to-copy custom CDN `<script>` tag snippet pre-configured with your project's API Key and the new `sdk.js` loader.
-
----
-
-## CLI Options
-
-```bash
-# Show help and commands list
-npx snapfail --help
-
-# Initialize integration in the current directory
-npx snapfail init
-```
-
----
-
-## Advanced Detection Features
-
-* 📦 **Dynamic Package Manager Detection:** The CLI automatically inspects lockfiles (`package-lock.json`, `pnpm-lock.yaml`, `bun.lock`, `yarn.lock`) to run the correct installation command natively in your project.
-* 🔐 **Secure Handshake:** The CLI launches a temporary local secure server on port `4321` or random fallback, using full cross-origin headers to safely receive authorization tokens back from the dashboard browser.
-* ⚡ **Node.js Native:** Executable binary runs natively in standard Node.js without requiring third-party runtime dependencies (like Bun or ts-node).
-
----
-
-## License
-
-MIT © [SnapFail Protocol](https://app.snapfail.com)

package/bin/snapfail.js

@@ -1,5 +0,0 @@
-#!/usr/bin/env node
-// SnapFail CLI entry point
-// Built for Node.js (also works with Bun).
-// The compiled dist/index.js is generated by `bun run build`.
-import "../dist/index.js";

package/dist/index.d.ts

@@ -1,15 +0,0 @@
-/**
- * SnapFail CLI
- *
- * Authenticates against the SnapFail dashboard via a browser-based OAuth-style
- * flow, obtains an API key for a project, writes it to the project's .env file,
- * and injects the SDK plugin/integration into the project's Vite or Astro config
- * automatically.
- *
- * Usage:
- *   snapfail init            # initialise SnapFail in the current project
- *   snapfail init ./path     # use a different project root
- *   snapfail --version
- *   snapfail --help
- */
-export {};