Installation Guide

# Install dependencies (optional - for type hints)
npm install @stackfox/sdk

# Or just copy the SDK to your project
curl -o lib/stackfox.ts https://stackfox.co/sdk/stackfox.ts

// middleware.ts (at your project root)
import { NextResponse } from 'next/server';
import type { NextRequest } from 'next/server';

const STACKFOX_KEY = 'sf_YOUR_API_KEY';
const STACKFOX_ENDPOINT = 'https://stackfox.co/api/v1/events';

// AI bot patterns
const BOT_PATTERNS = [
  /gptbot/i, /chatgpt-user/i, /oai-searchbot/i,
  /claudebot/i, /claude-web/i, /anthropic/i,
  /google-extended/i, /googleother/i,
  /perplexitybot/i, /meta-externalagent/i,
  /bytespider/i, /ccbot/i, /cohere-ai/i,
  /amazonbot/i, /applebot/i, /bingbot/i,
];

function isAIBot(ua: string): boolean {
  return BOT_PATTERNS.some(p => p.test(ua));
}

export function middleware(request: NextRequest) {
  const userAgent = request.headers.get('user-agent') || '';

  // Only track AI bot traffic
  if (isAIBot(userAgent)) {
    // Fire and forget - don't block the response
    fetch(STACKFOX_ENDPOINT, {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'X-SF-Key': STACKFOX_KEY,
      },
      body: JSON.stringify({
        events: [{
          userAgent,
          path: request.nextUrl.pathname,
          method: request.method,
          timestamp: new Date().toISOString(),
        }]
      }),
    }).catch(() => {});
  }

  return NextResponse.next();
}

// Match all routes except static files
export const config = {
  matcher: ['/((?!_next/static|_next/image|favicon.ico).*)'],
};