@burn0/burn0 0.2.2 → 0.2.4

package/README.md

@@ -128,6 +128,55 @@ resend         $0.15   ░░░░░░░░░░░░░░░░░░░
 
 ---
 
+## Dashboard — See Everything in One Place
+
+The terminal is great for development. But when you want history, trends, and team visibility — connect to the **free dashboard** at [burn0.dev](https://burn0.dev).
+
+### Get started in 60 seconds:
+
+```bash
+# 1. Sign in with GitHub
+open https://burn0.dev/login
+
+# 2. Go to your dashboard and copy your API key
+#    Dashboard → API Keys → Create Key
+
+# 3. Add the key to your project
+echo 'BURN0_API_KEY=b0_sk_your_key_here' >> .env
+
+# 4. Restart your app — costs now sync to the dashboard
+npm run dev
+```
+
+That's it. Every API call is now tracked in the dashboard.
+
+### What you'll see:
+
+| Feature | Description |
+|---|---|
+| **Live Event Feed** | Every API call streams in real-time — service, model, tokens, cost, latency |
+| **Cost Breakdown** | Per-service, per-model cost breakdown with visual charts |
+| **Monthly Projection** | Estimated monthly spend based on your actual usage trends |
+| **Request History** | Full history of every tracked API call, searchable and filterable |
+| **API Key Management** | Create, list, and revoke keys from the dashboard |
+
+### How it works:
+
+```
+Your app (with BURN0_API_KEY set)
+  │
+  ├─ Costs still appear in your terminal (nothing changes)
+  │
+  └─ Events also sync to burn0.dev ──→ Dashboard
+       │
+       ├─ Only metadata: service, model, tokens, cost, status, latency
+       └─ Never request/response bodies. Never your API keys.
+```
+
+> **Privacy**: burn0 never reads your request or response content. Only metadata is synced — service name, model, token counts, cost, status code, and latency. Your API keys and data stay on your machine.
+
+---
+
 ## Feature Attribution
 
 Know exactly which feature burns money:
@@ -243,22 +292,9 @@ Your app starts
 | Mode | API Key | What happens |
 |---|---|---|
 | **Local** (default) | No | Costs in terminal + local ledger. Zero network calls to burn0. |
-| **Cloud** (opt-in) | Yes | Same as local + events sync to dashboard for team visibility. |
-
-### Cloud Dashboard
-
-Connect an API key to see costs in the browser:
-
-- **Live event feed** — every API call in real-time via SSE
-- **Cost breakdown** — per service, per model, per day
-- **Monthly projection** — estimated monthly spend based on trends
-- **API key management** — create, list, revoke keys
+| **Cloud** (opt-in) | Yes | Same as local + events sync to [dashboard](https://burn0.dev/dashboard) for full history and team visibility. |
 
-```bash
-# Sign in with GitHub at burn0.dev
-# Create an API key, then:
-npx burn0 connect
-```
+> **Start local, upgrade when ready.** burn0 works perfectly without an API key. When you want history and dashboards, add a key — it takes 60 seconds. [Get your free API key →](https://burn0.dev/login)
 
 ---
 

package/dist/{chunk-QJYKRVCP.mjs → chunk-H3A5NM5C.mjs}

@@ -560,7 +560,7 @@ var FREE_SERVICES = /* @__PURE__ */ new Set([
   "slack-api",
   "discord-api"
 ]);
-async function fetchPricing(apiUrl, fetchFn) {
+function loadCachedPricing() {
   try {
     const cachePath = path2.join(process.cwd(), CACHE_FILE);
     if (fs2.existsSync(cachePath)) {
@@ -568,11 +568,15 @@ async function fetchPricing(apiUrl, fetchFn) {
       const cached = JSON.parse(raw);
       if (Date.now() - cached.cached_at < CACHE_TTL_MS) {
         pricingData = cached;
-        return;
+        return true;
       }
     }
   } catch {
   }
+  return false;
+}
+async function fetchPricing(apiUrl, fetchFn) {
+  if (pricingData) return;
   try {
     const response = await fetchFn(`${apiUrl}/v1/pricing`, {
       headers: { "Accept": "application/json" }
@@ -760,6 +764,7 @@ var apiKey = getApiKey();
 var mode = detectMode({ isTTY: isTTY(), apiKey });
 var { track, startSpan, enrichEvent } = createTracker();
 var originalFetch2 = globalThis.fetch;
+loadCachedPricing();
 if (mode !== "test-disabled" && mode !== "prod-local") {
   fetchPricing(BURN0_API_URL, originalFetch2).catch(() => {
   });
@@ -841,4 +846,4 @@ export {
   startSpan,
   restore
 };
-//# sourceMappingURL=chunk-QJYKRVCP.mjs.map
+//# sourceMappingURL=chunk-H3A5NM5C.mjs.map

package/dist/cli/index.js

@@ -18380,18 +18380,7 @@ var init_local = __esm({
 
 // src/transport/local-pricing.ts
 async function fetchPricing(apiUrl, fetchFn) {
-  try {
-    const cachePath = import_node_path8.default.join(process.cwd(), CACHE_FILE);
-    if (import_node_fs7.default.existsSync(cachePath)) {
-      const raw = import_node_fs7.default.readFileSync(cachePath, "utf-8");
-      const cached = JSON.parse(raw);
-      if (Date.now() - cached.cached_at < CACHE_TTL_MS) {
-        pricingData = cached;
-        return;
-      }
-    }
-  } catch {
-  }
+  if (pricingData) return;
   try {
     const response = await fetchFn(`${apiUrl}/v1/pricing`, {
       headers: { "Accept": "application/json" }

package/dist/index.js

@@ -621,7 +621,7 @@ var FREE_SERVICES = /* @__PURE__ */ new Set([
   "slack-api",
   "discord-api"
 ]);
-async function fetchPricing(apiUrl, fetchFn) {
+function loadCachedPricing() {
   try {
     const cachePath = import_node_path2.default.join(process.cwd(), CACHE_FILE);
     if (import_node_fs2.default.existsSync(cachePath)) {
@@ -629,11 +629,15 @@ async function fetchPricing(apiUrl, fetchFn) {
       const cached = JSON.parse(raw);
       if (Date.now() - cached.cached_at < CACHE_TTL_MS) {
         pricingData = cached;
-        return;
+        return true;
       }
     }
   } catch {
   }
+  return false;
+}
+async function fetchPricing(apiUrl, fetchFn) {
+  if (pricingData) return;
   try {
     const response = await fetchFn(`${apiUrl}/v1/pricing`, {
       headers: { "Accept": "application/json" }
@@ -821,6 +825,7 @@ var apiKey = getApiKey();
 var mode = detectMode({ isTTY: isTTY(), apiKey });
 var { track, startSpan, enrichEvent } = createTracker();
 var originalFetch2 = globalThis.fetch;
+loadCachedPricing();
 if (mode !== "test-disabled" && mode !== "prod-local") {
   fetchPricing(BURN0_API_URL, originalFetch2).catch(() => {
   });

package/dist/index.mjs

@@ -2,7 +2,7 @@ import {
   restore,
   startSpan,
   track
-} from "./chunk-QJYKRVCP.mjs";
+} from "./chunk-H3A5NM5C.mjs";
 import "./chunk-DJ72YN4C.mjs";
 export {
   restore,

package/dist/register.js

@@ -607,7 +607,7 @@ var FREE_SERVICES = /* @__PURE__ */ new Set([
   "slack-api",
   "discord-api"
 ]);
-async function fetchPricing(apiUrl, fetchFn) {
+function loadCachedPricing() {
   try {
     const cachePath = import_node_path2.default.join(process.cwd(), CACHE_FILE);
     if (import_node_fs2.default.existsSync(cachePath)) {
@@ -615,11 +615,15 @@ async function fetchPricing(apiUrl, fetchFn) {
       const cached = JSON.parse(raw);
       if (Date.now() - cached.cached_at < CACHE_TTL_MS) {
         pricingData = cached;
-        return;
+        return true;
       }
     }
   } catch {
   }
+  return false;
+}
+async function fetchPricing(apiUrl, fetchFn) {
+  if (pricingData) return;
   try {
     const response = await fetchFn(`${apiUrl}/v1/pricing`, {
       headers: { "Accept": "application/json" }
@@ -807,6 +811,7 @@ var apiKey = getApiKey();
 var mode = detectMode({ isTTY: isTTY(), apiKey });
 var { track, startSpan, enrichEvent } = createTracker();
 var originalFetch2 = globalThis.fetch;
+loadCachedPricing();
 if (mode !== "test-disabled" && mode !== "prod-local") {
   fetchPricing(BURN0_API_URL, originalFetch2).catch(() => {
   });

package/dist/register.mjs

@@ -1,3 +1,3 @@
-import "./chunk-QJYKRVCP.mjs";
+import "./chunk-H3A5NM5C.mjs";
 import "./chunk-DJ72YN4C.mjs";
 //# sourceMappingURL=register.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@burn0/burn0",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Lightweight cost observability for every API call in your stack",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",