apiforgejs 0.1.0 → 1.0.1

package/README.md

@@ -1,9 +1,18 @@
 # apiforgejs
 
-API observability & intelligence SDK for Express.js — local-first, privacy-first.
+**API observability & intelligence for Express.js — local-first, privacy-first.**
+
+[![npm version](https://img.shields.io/npm/v/apiforgejs?color=0066FF)](https://www.npmjs.com/package/apiforgejs)
+[![CI](https://img.shields.io/github/actions/workflow/status/APIForge-Organisation/sdk-nodejs/ci.yml?branch=main&label=CI)](https://github.com/APIForge-Organisation/sdk-nodejs/actions)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D22.5-brightgreen)](https://nodejs.org)
 
 > Track latency, error rates, and behavioral trends of your APIs. Everything stays on your machine.
 
+**→ [Full documentation](https://apiforge-organisation.github.io/docs/)**
+
+---
+
 ## Install
 
 ```bash
@@ -18,13 +27,11 @@ const { apiforge } = require('apiforgejs');
 
 const app = express();
 
-// Add the middleware — one line, zero config required
 app.use(apiforge({ mode: 'local' }));
 
 app.get('/users/:id', (req, res) => res.json({ id: req.params.id }));
 
 app.listen(3000, () => {
-  console.log('App running on :3000');
   // Dashboard auto-starts at http://localhost:4242
 });
 ```
@@ -45,15 +52,15 @@ Data is collected locally in `.apiforge.db` (SQLite). Nothing leaves your machin
 
 ```javascript
 app.use(apiforge({
-  mode:          'local',                 // only supported mode in v0.x
-  dbPath:        '.apiforge.db',          // SQLite file location
-  dashboardPort: 4242,                    // set to 0 to disable dashboard
-  flushInterval: 60_000,                  // flush to SQLite every 60s (ms)
-  env:           process.env.NODE_ENV,    // 'production' | 'staging' | 'development'
-  release:       process.env.APP_VERSION, // enables release regression detection
-  service:       'my-api',               // label for multi-service setups
-  sampling:      1.0,                     // 0.0–1.0 sample rate
-  ignorePaths:   ['/health', '/ping'],    // paths to skip
+  mode:          'local',
+  dbPath:        '.apiforge.db',
+  dashboardPort: 4242,             // set to 0 to disable
+  flushInterval: 60_000,           // flush to SQLite every 60s (ms)
+  env:           process.env.NODE_ENV,
+  release:       process.env.APP_VERSION,
+  service:       'my-api',
+  sampling:      1.0,              // 0.0–1.0 sample rate
+  ignorePaths:   ['/health', '/ping'],
 }));
 ```
 
@@ -64,11 +71,11 @@ Pass your release version to enable before/after deployment comparison:
 ```javascript
 app.use(apiforge({
   mode: 'local',
-  release: process.env.npm_package_version, // or 'v1.4.0', git SHA, etc.
+  release: process.env.npm_package_version,
 }));
 ```
 
-When a new release is detected, APIForge automatically compares P90 latency before vs. after and surfaces regressions as insights.
+When a new release is detected, APIForge compares P90 latency before vs. after and surfaces regressions as insights automatically.
 
 ## Graceful shutdown
 
@@ -77,7 +84,7 @@ const forge = apiforge({ mode: 'local' });
 app.use(forge);
 
 process.on('SIGTERM', () => {
-  forge.shutdown(); // flush remaining buffer to SQLite
+  forge.shutdown();
   process.exit(0);
 });
 ```
@@ -91,27 +98,11 @@ The SDK **never** collects:
 - Route parameter values (`/users/12345` → only `/users/:id` is stored)
 - IP addresses or User-Agent strings
 
-Collected fields: route pattern, HTTP method, status code, latency (ms), timestamp, and optional env/release/service labels.
-
-## Data collected
-
-```json
-{
-  "route":       "GET /users/:id",
-  "method":      "GET",
-  "status":      200,
-  "duration_ms": 134.7,
-  "timestamp":   "2026-05-13T10:00:00.000Z",
-  "env":         "production",
-  "release":     "v1.4.0"
-}
-```
-
 ## Requirements
 
-- Node.js >= 18
-- Express >= 4
+- Node.js ≥ 22.5 (uses the built-in `node:sqlite` module)
+- Express.js v4 or v5
 
 ## License
 
-MIT
+MIT — [APIForge Organisation](https://github.com/APIForge-Organisation)

package/package.json

@@ -1,11 +1,19 @@
 {
   "name": "apiforgejs",
-  "version": "0.1.0",
+  "version": "1.0.1",
   "description": "API observability & intelligence SDK for Express.js — local-first, privacy-first",
   "main": "src/index.js",
   "keywords": [
-    "api", "observability", "monitoring", "express", "metrics",
-    "performance", "analytics", "middleware", "latency", "local-first"
+    "api",
+    "observability",
+    "monitoring",
+    "express",
+    "metrics",
+    "performance",
+    "analytics",
+    "middleware",
+    "latency",
+    "local-first"
   ],
   "author": "APIForge",
   "license": "MIT",

package/src/ui.html

@@ -315,11 +315,9 @@ input.fld:focus { outline: 2px solid var(--accent-line); border-color: var(--acc
 <body>
   <div id="root"></div>
 
-  <!-- React UMD served from node_modules by apiforgejs dashboard server -->
-  <script src="/assets/react.js"></script>
-  <script src="/assets/react-dom.js"></script>
-  <!-- Babel standalone for in-browser JSX transpilation -->
-  <script src="https://unpkg.com/@babel/standalone@7/babel.min.js" crossorigin></script>
+  <script src="https://cdn.jsdelivr.net/npm/react@18/umd/react.production.min.js" crossorigin></script>
+  <script src="https://cdn.jsdelivr.net/npm/react-dom@18/umd/react-dom.production.min.js" crossorigin></script>
+  <script src="https://cdn.jsdelivr.net/npm/@babel/standalone@7/babel.min.js" crossorigin></script>
 
   <script type="text/babel" data-presets="react">
 'use strict';
@@ -719,7 +717,7 @@ function StatusStackChart({ data, height = 200 }) {
 }
 
 // ─── Overview ─────────────────────────────────────────────────────────────────
-function Overview({ timeRange, setRoute, setParams }) {
+function Overview({ timeRange, setRoute, setParams, lastUpdated }) {
   const { ENDPOINTS, RELEASES, INSIGHTS, SUMMARY } = window.AF_DATA;
   const [globalTs, setGlobalTs] = useState(null);
   const hours = TIME_HOURS[timeRange] || 24;
@@ -728,7 +726,7 @@ function Overview({ timeRange, setRoute, setParams }) {
     setGlobalTs(null);
     fetch(`/api/global-timeseries?hours=${hours}`)
       .then(r => r.json()).then(d => setGlobalTs(d)).catch(() => setGlobalTs([]));
-  }, [hours]);
+  }, [hours, lastUpdated]);
 
   const chartData   = globalTs ? tsBucketsToChart(globalTs, hours) : null;
   const points      = Math.max(chartData?.p90?.length || 0, 2);
@@ -1050,7 +1048,7 @@ function Endpoints({ setRoute, setParams }) {
 }
 
 // ─── Endpoint detail ──────────────────────────────────────────────────────────
-function EndpointDetail({ id, timeRange, setRoute, setParams }) {
+function EndpointDetail({ id, timeRange, setRoute, setParams, lastUpdated }) {
   const { ENDPOINTS, INSIGHTS } = window.AF_DATA;
   const ep  = ENDPOINTS.find(e => e.id === id) || ENDPOINTS[0];
   const [tab, setTab]       = useState('performance');
@@ -1065,7 +1063,7 @@ function EndpointDetail({ id, timeRange, setRoute, setParams }) {
     setTs(null);
     fetch(`/api/timeseries?route=${encodeURIComponent(route)}&method=${encodeURIComponent(method)}&hours=${hours}`)
       .then(r => r.json()).then(d => setTs(d)).catch(() => setTs([]));
-  }, [id, hours]);
+  }, [id, hours, lastUpdated]);
 
   if (!ep) return <div className="empty-state">Endpoint not found.</div>;
 
@@ -1628,9 +1626,9 @@ function App() {
           lastUpdated={lastUpdated} onRefresh={() => fetchData.current()}/>
         <div className="content">
           <div className="content-inner">
-            {route === 'overview'  && <Overview  timeRange={timeRange} setRoute={setRoute} setParams={setParams}/>}
+            {route === 'overview'  && <Overview  timeRange={timeRange} setRoute={setRoute} setParams={setParams} lastUpdated={lastUpdated}/>}
             {route === 'endpoints' && <Endpoints setRoute={setRoute} setParams={setParams}/>}
-            {route === 'endpoint'  && <EndpointDetail id={params.id} timeRange={timeRange} setRoute={setRoute} setParams={setParams}/>}
+            {route === 'endpoint'  && <EndpointDetail id={params.id} timeRange={timeRange} setRoute={setRoute} setParams={setParams} lastUpdated={lastUpdated}/>}
             {route === 'insights'  && <Insights  setRoute={setRoute} setParams={setParams}/>}
             {route === 'releases'  && <Releases/>}
             {route === 'settings'  && <Settings/>}