weifuwu 0.17.4 → 0.17.5

package/README.md

@@ -1146,6 +1146,56 @@ await deploy(config)
 
 ---
 
+## Analytics
+
+In-memory page view tracking with a built-in dashboard. Zero extra dependencies.
+
+```ts
+import { analytics } from 'weifuwu'
+
+app.use(analytics())  // mounts middleware + /analytics + /__analytics/data
+```
+
+| Endpoint | Description |
+|----------|-------------|
+| `GET /analytics` | Dashboard — PV trend, top pages, referrers, device breakdown |
+| `GET /__analytics/data?days=7` | Raw JSON data for custom dashboards |
+
+Excluded paths (not recorded): `/__analytics/*`, `__wfw/*`, `/static/*`, `/analytics`.
+
+### Dashboard
+
+The built-in `/analytics` page renders a server-generated HTML dashboard with:
+
+- **Summary cards** — total PV, unique pages, mobile/desktop ratio
+- **Bar chart** — daily page views for the selected period
+- **Top pages table** — most visited paths ranked by views
+- **Referrers table** — top referring domains
+
+### JSON API
+
+```ts
+// GET /__analytics/data?days=30
+{
+  "total_pv": 2847,
+  "total_uv": 1231,
+  "daily": [{ "date": "2026-06-05", "pv": 520, "uv": 310 }],
+  "top_pages": [{ "path": "/tools/uppercase", "pv": 1284 }],
+  "referrers": [{ "domain": "google.com", "count": 380 }],
+  "devices": { "mobile": 45.2, "desktop": 54.8 }
+}
+```
+
+### Options
+
+```ts
+app.use(analytics({
+  excluded: ['/admin', '/api'],  // custom exclude patterns (defaults listed above)
+}))
+```
+
+---
+
 ## Health check
 
 ```ts

package/dist/analytics.d.ts

@@ -0,0 +1,8 @@
+import { Router } from './router.ts';
+export interface AnalyticsOptions {
+    pg?: {
+        sql: any;
+    };
+    excluded?: string[];
+}
+export declare function analytics(options?: AnalyticsOptions): Router;

package/dist/index.d.ts

@@ -54,6 +54,8 @@ export { opencode } from './opencode/index.ts';
 export type { OpencodeOptions, OpencodeModule, SkillDef, OpencodePermissions, Session as OpencodeSession, } from './opencode/types.ts';
 export { health } from './health.ts';
 export type { HealthOptions } from './health.ts';
+export { analytics } from './analytics.ts';
+export type { AnalyticsOptions } from './analytics.ts';
 export { preferences } from './preferences.ts';
 export type { PrefOptions } from './preferences.ts';
 export { seo, seoMiddleware, seoTags } from './seo.ts';

package/dist/index.js

@@ -6798,6 +6798,179 @@ function health(options) {
   return r;
 }
 
+// analytics.ts
+var DEFAULT_EXCLUDED = ["/__analytics", "/__wfw", "/static", "/analytics"];
+var MemStore = class {
+  days = /* @__PURE__ */ new Map();
+  pages = /* @__PURE__ */ new Map();
+  refs = /* @__PURE__ */ new Map();
+  record(path2, date, refDomain, mobile) {
+    let day = this.days.get(date);
+    if (!day) {
+      day = { pv: 0, uv: /* @__PURE__ */ new Set(), mobile: 0, desktop: 0 };
+      this.days.set(date, day);
+    }
+    day.pv++;
+    day.uv.add(path2);
+    if (mobile) {
+      day.mobile++;
+    } else {
+      day.desktop++;
+    }
+    let page = this.pages.get(path2);
+    if (!page) {
+      page = { count: 0, dates: /* @__PURE__ */ new Set() };
+      this.pages.set(path2, page);
+    }
+    page.count++;
+    page.dates.add(date);
+    if (refDomain) {
+      let refs = this.refs.get(date);
+      if (!refs) {
+        refs = /* @__PURE__ */ new Map();
+        this.refs.set(date, refs);
+      }
+      refs.set(refDomain, (refs.get(refDomain) || 0) + 1);
+    }
+  }
+  query(days) {
+    const since = /* @__PURE__ */ new Date();
+    since.setDate(since.getDate() - days);
+    const sinceStr = since.toISOString().slice(0, 10);
+    const daily = [];
+    let totalPv = 0;
+    let totalMobile = 0;
+    let totalDesktop = 0;
+    const pageMap = /* @__PURE__ */ new Map();
+    const allUv = /* @__PURE__ */ new Set();
+    for (const [date, day] of this.days) {
+      if (date < sinceStr) continue;
+      daily.push({ date, pv: day.pv, uv: day.uv.size });
+      totalPv += day.pv;
+      totalMobile += day.mobile;
+      totalDesktop += day.desktop;
+      for (const p of day.uv) allUv.add(p);
+    }
+    for (const [path2, page] of this.pages) {
+      let count = 0;
+      for (const d of page.dates) if (d >= sinceStr) count += page.count / page.dates.size;
+      pageMap.set(path2, page.count);
+    }
+    const topPages = [...pageMap.entries()].sort((a, b) => b[1] - a[1]).slice(0, 20).map(([path2, count]) => ({ path: path2, pv: count }));
+    const refMap = /* @__PURE__ */ new Map();
+    for (const [date, refs] of this.refs) {
+      if (date < sinceStr) continue;
+      for (const [domain, count] of refs) refMap.set(domain, (refMap.get(domain) || 0) + count);
+    }
+    const referrers = [...refMap.entries()].sort((a, b) => b[1] - a[1]).slice(0, 10).map(([domain, count]) => ({ domain, count }));
+    const total = totalMobile + totalDesktop || 1;
+    return {
+      total_pv: totalPv,
+      total_uv: allUv.size,
+      daily,
+      top_pages: topPages,
+      referrers,
+      devices: { mobile: Math.round(totalMobile / total * 1e3) / 10, desktop: Math.round(totalDesktop / total * 1e3) / 10 }
+    };
+  }
+};
+function analytics(options) {
+  const excluded = options?.excluded ?? DEFAULT_EXCLUDED;
+  const store = new MemStore();
+  function shouldExclude(path2) {
+    return excluded.some((e) => path2.startsWith(e));
+  }
+  const middleware = async (req, ctx, next) => {
+    const url = new URL(req.url);
+    const path2 = url.pathname;
+    if (!shouldExclude(path2)) {
+      const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+      const ref = req.headers.get("referer") || "";
+      const refDomain = ref ? new URL(ref).hostname.replace(/^www\./, "") : "";
+      const ua = req.headers.get("user-agent") || "";
+      const mobile = /mobile|android|iphone|ipad/i.test(ua);
+      store.record(path2, date, refDomain, mobile);
+    }
+    return next(req, ctx);
+  };
+  const router = new Router();
+  router.use(middleware);
+  router.get("/__analytics/data", async (req) => {
+    const url = new URL(req.url);
+    const days = Math.min(Math.max(Number(url.searchParams.get("days")) || 7, 1), 365);
+    return Response.json(store.query(days));
+  });
+  router.get("/analytics", async (req) => {
+    const url = new URL(req.url);
+    const days = Math.min(Math.max(Number(url.searchParams.get("days")) || 7, 1), 365);
+    const data = store.query(days);
+    return new Response(renderDashboard(days, data), {
+      headers: { "content-type": "text/html; charset=utf-8" }
+    });
+  });
+  return router;
+}
+function renderDashboard(days, data) {
+  const { total_pv, total_uv, daily, top_pages, referrers, devices } = data;
+  const maxPv = Math.max(...daily.map((d) => d.pv), 1);
+  const bars = daily.map(
+    (d) => `<div class="bar-wrap"><div class="bar" style="height:${d.pv / maxPv * 100}%"></div><span class="bar-label">${d.date.slice(5)}</span></div>`
+  ).join("");
+  const rows = top_pages.map(
+    (p, i) => `<tr><td class="num">${i + 1}</td><td class="path">${p.path}</td><td class="num">${p.pv}</td></tr>`
+  ).join("");
+  const refRows = referrers.map(
+    (r) => `<tr><td>${r.domain}</td><td class="num">${r.count}</td></tr>`
+  ).join("");
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8"/>
+<meta name="viewport" content="width=device-width, initial-scale=1"/>
+<title>Analytics - weifuwu</title>
+<style>
+*,:before,:after{box-sizing:border-box;margin:0;padding:0}
+body{font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;background:#f8f9fa;color:#333;padding:24px;max-width:960px;margin:0 auto}
+h1{font-size:24px;font-weight:700;margin-bottom:24px}
+.cards{display:grid;grid-template-columns:repeat(auto-fit,minmax(140px,1fr));gap:12px;margin-bottom:24px}
+.card{background:#fff;border-radius:10px;padding:16px;box-shadow:0 1px 3px rgba(0,0,0,.08)}
+.card .val{font-size:28px;font-weight:700;color:#2563eb}
+.card .lbl{font-size:12px;color:#888;margin-top:4px}
+.section{background:#fff;border-radius:10px;padding:20px;margin-bottom:16px;box-shadow:0 1px 3px rgba(0,0,0,.08)}
+.section h2{font-size:14px;font-weight:600;color:#888;text-transform:uppercase;letter-spacing:.05em;margin-bottom:16px}
+.chart{display:flex;align-items:flex-end;gap:4px;height:160px;padding-top:8px}
+.bar-wrap{flex:1;display:flex;flex-direction:column;align-items:center;height:100%;justify-content:flex-end}
+.bar{width:100%;background:#2563eb;border-radius:4px 4px 0 0;min-height:2px;transition:height .3s}
+.bar-label{font-size:10px;color:#888;margin-top:6px;white-space:nowrap}
+table{width:100%;border-collapse:collapse;font-size:13px}
+th{text-align:left;padding:6px 8px;color:#888;font-weight:500;border-bottom:1px solid #eee}
+td{padding:6px 8px;border-bottom:1px solid #f0f0f0}
+.num{text-align:right;font-variant-numeric:tabular-nums}
+.path{font-family:ui-monospace,SFMono-Regular,monospace;font-size:12px}
+tr:hover td{background:#f8faff}
+</style>
+</head>
+<body>
+<h1>Analytics</h1>
+<div class="cards">
+  <div class="card"><div class="val">${total_pv}</div><div class="lbl">Page Views (${days}d)</div></div>
+  <div class="card"><div class="val">${total_uv}</div><div class="lbl">Unique Pages</div></div>
+  <div class="card"><div class="val">${devices.mobile}%</div><div class="lbl">Mobile</div></div>
+  <div class="card"><div class="val">${devices.desktop}%</div><div class="lbl">Desktop</div></div>
+</div>
+<div class="section">
+  <h2>Daily Page Views</h2>
+  <div class="chart">${bars}</div>
+</div>
+<div class="section">
+  <h2>Top Pages</h2>
+  <table><thead><tr><th style="width:32px">#</th><th>Path</th><th style="width:64px">Views</th></tr></thead><tbody>${rows}</tbody></table>
+</div>
+${referrers.length ? `<div class="section"><h2>Referrers</h2><table><thead><tr><th>Domain</th><th style="width:64px">Views</th></tr></thead><tbody>${refRows}</tbody></table></div>` : ""}
+</body>
+</html>`;
+}
+
 // preferences.ts
 import { readFile as readFile2 } from "node:fs/promises";
 import { existsSync as existsSync4 } from "node:fs";
@@ -8272,6 +8445,7 @@ export {
   TsxContext,
   agent,
   aiStream,
+  analytics,
   auth,
   compress,
   cors,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "weifuwu",
-  "version": "0.17.4",
+  "version": "0.17.5",
   "description": "Web-standard HTTP framework for Node.js — (req, ctx) => Response",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",