2027-track 0.1.2 → 0.1.4

package/README.md

@@ -1,14 +1,16 @@
 # 2027-track
 
-Track AI coding agents (Claude Code, Codex, OpenCode) visiting your documentation.
+**Know who's using your product: humans or agents**
 
-## Installation
+Lightweight middleware to detect and track AI coding agents visiting your docs.
+
+## Install
 
 ```bash
 npm install 2027-track
 ```
 
-## Usage with Next.js
+## Next.js
 
 ```ts
 // middleware.ts
@@ -16,76 +18,103 @@ import { withAIAnalytics } from "2027-track/next";
 
 export default withAIAnalytics();
 
-// Or wrap your existing middleware:
-export default withAIAnalytics(yourExistingMiddleware);
+export const config = {
+  matcher: ["/((?!api|_next|admin|auth).*)",],
+};
 ```
 
-## Usage (generic)
+Or wrap existing middleware:
 
 ```ts
-import { trackVisit } from "2027-track";
-
-await trackVisit({
-  host: "docs.example.com",
-  path: "/api/getting-started",
-  userAgent: request.headers.get("user-agent"),
-  accept: request.headers.get("accept"),
-  country: "US", // optional
-});
+export default withAIAnalytics(yourMiddleware);
 ```
 
-## Route Filtering
-
-**Important:** Only track public documentation routes. Exclude private endpoints to avoid leaking sensitive paths.
+## Vercel (any framework)
 
-### Next.js matcher (recommended)
+Works with Remix, SvelteKit, Astro, Nuxt, or any Vercel deployment:
 
 ```ts
 // middleware.ts
-import { withAIAnalytics } from "2027-track/next";
+import { withAIAnalytics } from "2027-track/vercel";
 
 export default withAIAnalytics();
 
 export const config = {
-  matcher: [
-    // Exclude private routes, track everything else
-    "/((?!api|_next|app|admin|dashboard|auth|login|signup).*)",
-  ],
+  matcher: "/((?!_next|api|favicon.ico|assets|.*\\..*).*)",
 };
 ```
 
-### Manual filtering
+Or wrap existing middleware:
+
+```ts
+export default withAIAnalytics(yourMiddleware);
+```
+
+Or use `trackVisit` directly:
 
 ```ts
 import { trackVisit } from "2027-track";
 
-// Only track if path starts with /docs
-if (path.startsWith("/docs")) {
-  await trackVisit({ host, path, userAgent, accept });
+export const config = {
+  matcher: "/((?!_next|api|favicon.ico|assets|.*\\..*).*)",
+};
+
+export default function middleware(request: Request, context: { waitUntil: (promise: Promise<unknown>) => void }) {
+  const url = new URL(request.url);
+  context.waitUntil(
+    trackVisit({
+      host: url.hostname,
+      path: url.pathname,
+      userAgent: request.headers.get("user-agent") || "",
+      accept: request.headers.get("accept") || "",
+      country: request.headers.get("x-vercel-ip-country") || undefined,
+    }).catch(() => {})
+  );
 }
 ```
 
-## Configuration
+## Generic Usage
+
+```ts
+import { trackVisit } from "2027-track";
 
-### Kill switch
+await trackVisit({
+  host: "docs.example.com",
+  path: "/getting-started",
+  userAgent: request.headers.get("user-agent"),
+  accept: request.headers.get("accept"),
+});
+```
 
-Set `AI_ANALYTICS_ENDPOINT=""` to disable tracking entirely.
+## Configuration
 
-### Custom endpoint
+```bash
+# Disable tracking
+AI_ANALYTICS_ENDPOINT=""
 
-Set `AI_ANALYTICS_ENDPOINT` to your own endpoint URL.
+# Self-host (optional)
+AI_ANALYTICS_ENDPOINT="https://your-api.workers.dev/track"
+```
 
 ## Privacy
 
-- Events are sent **server-side** from Vercel Edge (or your server)
-- Visitor IP addresses **never reach** the analytics endpoint
-- Only headers (user-agent, accept) and page info (host, path) are sent
-- **No cookies, no fingerprinting, no personal identifiers**
-
-This middleware collects no personally identifiable information (PII). Because there are no cookies, no IP forwarding, and no user identifiers, it generally does not trigger privacy policy or cookie-consent requirements under GDPR, CCPA, or similar regulations. That said, you should verify with your own legal counsel, especially under strict EU interpretations.
+- Events sent **server-side** — visitor IPs never reach the analytics endpoint
+- No cookies, no fingerprinting, no PII
+- Fully open source — [audit the code](https://github.com/team2027/track)
 
 ## Detection
 
-Agent classification (user-agent and accept header matching) happens server-side at the analytics endpoint — the middleware only forwards raw headers.
+| Agent | Signal |
+|-------|--------|
+| Claude Code | `axios` + `text/markdown` |
+| OpenCode | `text/markdown` with `q=` weights |
+| Codex | `ChatGPT-User` user-agent |
+
+## Links
+
+- [GitHub](https://github.com/team2027/track)
+- [Test your agent](https://ai-docs-analytics-api.theisease.workers.dev/detect)
+
+## License
 
-Dashboard: https://ai-docs-analytics.vercel.app
+MIT

package/dist/vercel.d.mts

@@ -0,0 +1,8 @@
+export { trackVisit } from './index.mjs';
+
+interface VercelContext {
+    waitUntil: (promise: Promise<unknown>) => void;
+}
+declare function withAIAnalytics(middleware?: (request: Request, context: VercelContext) => Response | undefined | Promise<Response | undefined>): (request: Request, context: VercelContext) => Promise<Response | undefined>;
+
+export { withAIAnalytics };

package/dist/vercel.d.ts

@@ -0,0 +1,8 @@
+export { trackVisit } from './index.js';
+
+interface VercelContext {
+    waitUntil: (promise: Promise<unknown>) => void;
+}
+declare function withAIAnalytics(middleware?: (request: Request, context: VercelContext) => Response | undefined | Promise<Response | undefined>): (request: Request, context: VercelContext) => Promise<Response | undefined>;
+
+export { withAIAnalytics };

package/dist/vercel.js

@@ -0,0 +1,93 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/vercel.ts
+var vercel_exports = {};
+__export(vercel_exports, {
+  trackVisit: () => trackVisit,
+  withAIAnalytics: () => withAIAnalytics
+});
+module.exports = __toCommonJS(vercel_exports);
+
+// src/index.ts
+var DEFAULT_ENDPOINT = "https://ai-docs-analytics-api.theisease.workers.dev/track";
+var TIMEOUT_MS = 2500;
+function getEndpoint() {
+  const env = typeof process !== "undefined" ? process.env.AI_ANALYTICS_ENDPOINT : void 0;
+  if (env === "") return null;
+  return env || DEFAULT_ENDPOINT;
+}
+function isPageView(accept) {
+  const a = accept.toLowerCase();
+  return a.includes("text/html") || a.includes("text/markdown");
+}
+async function trackVisit(options) {
+  const endpoint = getEndpoint();
+  if (!endpoint) {
+    return { ok: true, skipped: "disabled" };
+  }
+  if (!isPageView(options.accept)) {
+    return { ok: true, skipped: "not-page-view" };
+  }
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), TIMEOUT_MS);
+  try {
+    const response = await fetch(endpoint, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        host: options.host,
+        path: options.path,
+        user_agent: options.userAgent,
+        accept: options.accept,
+        country: options.country || "unknown"
+      }),
+      signal: controller.signal
+    });
+    clearTimeout(timeoutId);
+    return await response.json();
+  } catch (e) {
+    clearTimeout(timeoutId);
+    return { ok: false, error: e instanceof Error ? e.message : "unknown error" };
+  }
+}
+
+// src/vercel.ts
+function withAIAnalytics(middleware) {
+  return async (request, context) => {
+    const response = middleware ? await middleware(request, context) : void 0;
+    const url = new URL(request.url);
+    context.waitUntil(
+      trackVisit({
+        host: url.hostname,
+        path: url.pathname,
+        userAgent: request.headers.get("user-agent") || "",
+        accept: request.headers.get("accept") || "",
+        country: request.headers.get("x-vercel-ip-country") || void 0
+      }).catch(() => {
+      })
+    );
+    return response;
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  trackVisit,
+  withAIAnalytics
+});

package/dist/vercel.mjs

@@ -0,0 +1,26 @@
+import {
+  trackVisit
+} from "./chunk-2UMSOEKA.mjs";
+
+// src/vercel.ts
+function withAIAnalytics(middleware) {
+  return async (request, context) => {
+    const response = middleware ? await middleware(request, context) : void 0;
+    const url = new URL(request.url);
+    context.waitUntil(
+      trackVisit({
+        host: url.hostname,
+        path: url.pathname,
+        userAgent: request.headers.get("user-agent") || "",
+        accept: request.headers.get("accept") || "",
+        country: request.headers.get("x-vercel-ip-country") || void 0
+      }).catch(() => {
+      })
+    );
+    return response;
+  };
+}
+export {
+  trackVisit,
+  withAIAnalytics
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "2027-track",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Track AI coding agents visiting your documentation",
   "repository": {
     "type": "git",
@@ -20,14 +20,19 @@
       "types": "./dist/next.d.ts",
       "import": "./dist/next.mjs",
       "require": "./dist/next.js"
+    },
+    "./vercel": {
+      "types": "./dist/vercel.d.ts",
+      "import": "./dist/vercel.mjs",
+      "require": "./dist/vercel.js"
     }
   },
   "files": [
     "dist"
   ],
   "scripts": {
-    "build": "tsup src/index.ts src/next.ts --format cjs,esm --dts",
-    "dev": "tsup src/index.ts src/next.ts --format cjs,esm --dts --watch"
+    "build": "tsup src/index.ts src/next.ts src/vercel.ts --format cjs,esm --dts",
+    "dev": "tsup src/index.ts src/next.ts src/vercel.ts --format cjs,esm --dts --watch"
   },
   "keywords": [
     "ai",