2027-track 0.1.3 → 0.1.4

package/README.md

@@ -29,6 +29,50 @@ Or wrap existing middleware:
 export default withAIAnalytics(yourMiddleware);
 ```
 
+## Vercel (any framework)
+
+Works with Remix, SvelteKit, Astro, Nuxt, or any Vercel deployment:
+
+```ts
+// middleware.ts
+import { withAIAnalytics } from "2027-track/vercel";
+
+export default withAIAnalytics();
+
+export const config = {
+  matcher: "/((?!_next|api|favicon.ico|assets|.*\\..*).*)",
+};
+```
+
+Or wrap existing middleware:
+
+```ts
+export default withAIAnalytics(yourMiddleware);
+```
+
+Or use `trackVisit` directly:
+
+```ts
+import { trackVisit } from "2027-track";
+
+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(() => {})
+  );
+}
+```
+
 ## Generic Usage
 
 ```ts

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.3",
+  "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",