apptvty 0.1.5 → 0.2.0

package/dist/middleware/nextjs.js

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/middleware/nextjs.ts
 var nextjs_exports = {};
 __export(nextjs_exports, {
+  createNextjsDashboardHandler: () => createNextjsDashboardHandler,
   createNextjsQueryHandler: () => createNextjsQueryHandler,
   withApptvty: () => withApptvty
 });
@@ -39,6 +40,13 @@ var ApptvtyClient = class {
     this.siteId = config.siteId;
     this.debug = config.debug ?? false;
   }
+  /**
+   * Set the X402 (LSAT) token for subsequent requests.
+   * This is called after the agent has successfully paid an X402 challenge.
+   */
+  setX402Token(macaroon, preimage) {
+    this.x402Token = `LSAT ${macaroon}:${preimage}`;
+  }
   /**
    * Send a batch of request log entries to the Apptvty ingestion API.
    * Called by the logger's auto-flush — not called directly by user code.
@@ -111,6 +119,20 @@ var ApptvtyClient = class {
   async getSiteDailyStats(days = 30) {
     return this.get(`/v1/sites/${this.siteId}/stats/daily`, { days: String(days) });
   }
+  /** Get recent activity logs (last 48h). */
+  async getRecentActivity(siteId, limit = 50, offset = 0) {
+    return this.get(`/v1/sites/${siteId}/activity`, {
+      limit: String(limit),
+      offset: String(offset)
+    });
+  }
+  /** Get recent agent queries. */
+  async getRecentQueries(siteId, limit = 20, offset = 0) {
+    return this.get(`/v1/sites/${siteId}/queries`, {
+      limit: String(limit),
+      offset: String(offset)
+    });
+  }
   /** Get crawler breakdown by type (default 30 days). */
   async getSiteCrawlers(days = 30) {
     return this.get(`/v1/sites/${this.siteId}/crawlers`, { days: String(days) });
@@ -127,6 +149,106 @@ var ApptvtyClient = class {
   async getSiteWallet() {
     return this.get(`/v1/sites/${this.siteId}/wallet`);
   }
+  // ─── Campaign management (for coding agents) ────────────────────────────────
+  //
+  // A coding agent that installed the SDK can create and manage ad campaigns
+  // programmatically — no human dashboard login required.
+  //
+  // Typical agentic advertiser flow:
+  //   1. Check wallet balance:  const w = await client.getSiteWallet()
+  //   2. Fund wallet if needed: send USDC to w.wallet_address on Base chain
+  //   3. Create campaign:       await client.createCampaign({ ... })
+  //   4. Monitor performance:   await client.getCampaign(id)
+  //   5. Adjust or pause:       await client.updateCampaign(id, { status: 'paused' })
+  /**
+   * Create an ad campaign. The campaign goes live immediately once the wallet
+   * has sufficient balance.
+   *
+   * If the wallet balance is too low, throws `ApptvtyInsufficientBalanceError`
+   * which includes deposit instructions so the agent can fund the wallet and retry.
+   *
+   * @example
+   * // Site-based: ad copy derived from your site's crawled content
+   * const campaign = await client.createCampaign({
+   *   name: 'My Kubernetes Blog',
+   *   advertiser_site_id: 'site_abc123',
+   *   keywords: ['kubernetes', 'devops', 'containers'],
+   *   categories: ['technology'],
+   *   bid_per_view_usdc: 0.001,
+   *   daily_budget_usdc: 1.0,
+   *   total_budget_usdc: 20.0,
+   * });
+   *
+   * // Static: manually written ad copy
+   * const campaign = await client.createCampaign({
+   *   name: 'My Blog — Static',
+   *   ad_text: 'Deep dives on Kubernetes, written by practitioners.',
+   *   landing_url: 'https://myblog.com',
+   *   keywords: ['kubernetes', 'devops'],
+   *   categories: ['technology'],
+   *   bid_per_view_usdc: 0.001,
+   *   daily_budget_usdc: 1.0,
+   *   total_budget_usdc: 10.0,
+   * });
+   */
+  async createCampaign(params) {
+    try {
+      return await this.post("/v1/campaigns", params);
+    } catch (err) {
+      if (err instanceof ApptvtyApiError && err.statusCode === 402) {
+        let details;
+        try {
+          const body = JSON.parse(err.body);
+          details = body?.error;
+        } catch {
+        }
+        throw new ApptvtyInsufficientBalanceError(details);
+      }
+      throw err;
+    }
+  }
+  /**
+   * List all campaigns for this account.
+   * Also returns the schema (valid categories, minimum bid) so the agent
+   * knows valid field values without guessing.
+   */
+  async listCampaigns() {
+    return this.get("/v1/campaigns");
+  }
+  /**
+   * Get a single campaign by ID, including current spend and impression count.
+   * `budget_remaining_usdc` tells the agent how much budget is left before
+   * the campaign auto-pauses.
+   */
+  async getCampaign(campaignId) {
+    return this.get(`/v1/campaigns/${campaignId}`);
+  }
+  /**
+   * Partially update a campaign. Only fields present in `params` are changed.
+   *
+   * @example
+   * // Pause a campaign
+   * await client.updateCampaign(id, { status: 'paused' });
+   *
+   * // Increase bid and daily budget
+   * await client.updateCampaign(id, { bid_per_view_usdc: 0.002, daily_budget_usdc: 5.0 });
+   */
+  async updateCampaign(campaignId, params) {
+    return this.patch(`/v1/campaigns/${campaignId}`, params);
+  }
+  /**
+   * Pause a campaign immediately. Equivalent to updateCampaign(id, { status: 'paused' }).
+   * Campaigns are never deleted — billing history is retained.
+   */
+  async pauseCampaign(campaignId) {
+    await this.delete(`/v1/campaigns/${campaignId}`);
+  }
+  /**
+   * Resume a paused campaign.
+   */
+  async resumeCampaign(campaignId) {
+    await this.patch(`/v1/campaigns/${campaignId}`, { status: "active" });
+  }
   async get(path, params) {
     const url = new URL(`${this.baseUrl}${path}`);
     if (params) {
@@ -135,7 +257,7 @@ var ApptvtyClient = class {
     const response = await fetch(url.toString(), {
       method: "GET",
       headers: {
-        Authorization: `Bearer ${this.apiKey}`,
+        Authorization: this.x402Token ?? `Bearer ${this.apiKey}`,
         "User-Agent": "apptvty-sdk/0.1.0"
       },
       signal: AbortSignal.timeout(1e4)
@@ -146,22 +268,91 @@ var ApptvtyClient = class {
     }
     return response.json();
   }
+  async patch(path, body) {
+    const url = `${this.baseUrl}${path}`;
+    const response = await fetch(url, {
+      method: "PATCH",
+      headers: {
+        "Authorization": this.x402Token ?? `Bearer ${this.apiKey}`,
+        "Content-Type": "application/json",
+        "User-Agent": "apptvty-sdk/0.1.0"
+      },
+      body: JSON.stringify(body),
+      signal: AbortSignal.timeout(1e4)
+    });
+    if (!response.ok) {
+      const text = await response.text().catch(() => "");
+      throw new ApptvtyApiError(response.status, path, text);
+    }
+    return response.json();
+  }
+  async delete(path) {
+    const url = `${this.baseUrl}${path}`;
+    const response = await fetch(url, {
+      method: "DELETE",
+      headers: {
+        "Authorization": this.x402Token ?? `Bearer ${this.apiKey}`,
+        "User-Agent": "apptvty-sdk/0.1.0"
+      },
+      signal: AbortSignal.timeout(1e4)
+    });
+    if (!response.ok) {
+      const text = await response.text().catch(() => "");
+      throw new ApptvtyApiError(response.status, path, text);
+    }
+  }
+  /**
+   * Settle an X402 challenge from the site's own USDC wallet balance.
+   * Called automatically when `post()` receives a 402 with an X402 header.
+   * Returns the preimage on success, or throws if the wallet balance is too low.
+   */
+  async payX402Challenge(macaroon) {
+    const url = `${this.baseUrl}/v1/x402/pay`;
+    const response = await fetch(url, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${this.apiKey}`,
+        "Content-Type": "application/json",
+        "User-Agent": "apptvty-sdk/0.1.0"
+      },
+      body: JSON.stringify({ macaroon }),
+      signal: AbortSignal.timeout(1e4)
+    });
+    const text = await response.text().catch(() => "");
+    if (!response.ok) {
+      let details;
+      try {
+        details = JSON.parse(text)?.error?.details;
+      } catch {
+      }
+      throw new ApptvtyInsufficientBalanceError(details);
+    }
+    const json = JSON.parse(text);
+    return json.preimage;
+  }
   async post(path, body) {
     const url = `${this.baseUrl}${path}`;
     const response = await fetch(url, {
       method: "POST",
       headers: {
-        "Authorization": `Bearer ${this.apiKey}`,
+        "Authorization": this.x402Token ?? `Bearer ${this.apiKey}`,
         "Content-Type": "application/json",
         "User-Agent": "apptvty-sdk/0.1.0"
       },
       body: JSON.stringify(body),
-      // Node 18+ fetch: set a reasonable timeout via AbortSignal
       signal: AbortSignal.timeout(1e4)
     });
     if (!response.ok) {
       const text = await response.text().catch(() => "");
       if (response.status === 402) {
+        const authHeader = response.headers.get("WWW-Authenticate");
+        if (authHeader?.includes("X402") || authHeader?.includes("LSAT")) {
+          const macaroon = authHeader.match(/macaroon="([^"]+)"/)?.[1] || "";
+          const preimage = await this.payX402Challenge(macaroon);
+          this.setX402Token(macaroon, preimage);
+          this.log("X402 challenge auto-paid from wallet, retrying request");
+          return this.post(path, body);
+        }
         let dashboardUrl = "https://dashboard.apptvty.com/login";
         try {
           const json = JSON.parse(text);
@@ -197,6 +388,16 @@ var ApptvtyTrialExpiredError = class extends Error {
     this.name = "ApptvtyTrialExpiredError";
   }
 };
+var ApptvtyInsufficientBalanceError = class extends Error {
+  constructor(details) {
+    const shortfall = details?.shortfall_usdc ?? "?";
+    super(
+      `Wallet balance too low to create campaign. Send ${shortfall} USDC to ${details?.deposit?.address ?? "your wallet"} on Base and retry.`
+    );
+    this.details = details;
+    this.name = "ApptvtyInsufficientBalanceError";
+  }
+};
 
 // src/crawler.ts
 var KNOWN_CRAWLERS = [
@@ -306,6 +507,27 @@ function extractBotName(userAgent) {
   }
   return "unknown_ai_bot";
 }
+var SCRAPER_SERVICES = [
+  // Jina AI Reader — r.jina.ai/URL — converts any page to clean Markdown
+  { name: "JinaReader", patterns: [/JinaReader/i] },
+  // Cloudflare Browser Rendering /crawl endpoint (open beta, announced March 2026)
+  { name: "Cloudflare-BrowserRendering", patterns: [/CloudflareBrowserRenderingCrawler/i] },
+  // FireCrawl — LLM-ready content extraction service
+  { name: "FireCrawl", patterns: [/FireCrawlAgent/i, /firecrawl/i] },
+  // Apify web scraping platform
+  { name: "Apify", patterns: [/ApifyBot/i] }
+];
+function detectScraperService(userAgent) {
+  if (!userAgent) return { isScraperService: false, name: null };
+  for (const service of SCRAPER_SERVICES) {
+    for (const pattern of service.patterns) {
+      if (pattern.test(userAgent)) {
+        return { isScraperService: true, name: service.name };
+      }
+    }
+  }
+  return { isScraperService: false, name: null };
+}
 
 // src/logger.ts
 var RequestLogger = class {
@@ -522,6 +744,354 @@ function getOrigin(url) {
   }
 }
 
+// src/dashboard-handler.ts
+function createDashboardHandler(client, config) {
+  return async function handleDashboard(req) {
+    const { path, method } = req;
+    if (path.endsWith("/api/overview")) {
+      const data = await client.getSiteStats();
+      return jsonResponse(200, data);
+    }
+    if (path.endsWith("/api/activity")) {
+      const url = new URL(path, "http://localhost");
+      const limit = parseInt(url.searchParams.get("limit") || "50");
+      const offset = parseInt(url.searchParams.get("offset") || "0");
+      const data = await client.getRecentActivity(config.siteId, limit, offset);
+      return jsonResponse(200, data);
+    }
+    if (path.endsWith("/api/queries")) {
+      const url = new URL(path, "http://localhost");
+      const limit = parseInt(url.searchParams.get("limit") || "20");
+      const offset = parseInt(url.searchParams.get("offset") || "0");
+      const data = await client.getRecentQueries(config.siteId, limit, offset);
+      return jsonResponse(200, data);
+    }
+    if (path.endsWith("/api/stats")) {
+      const data = await client.getSiteDailyStats();
+      return jsonResponse(200, data);
+    }
+    const html = getDashboardHtml(config);
+    return {
+      status: 200,
+      body: html,
+      headers: { "Content-Type": "text/html" }
+    };
+  };
+}
+function jsonResponse(status, data) {
+  return {
+    status,
+    body: JSON.stringify(data),
+    headers: { "Content-Type": "application/json" }
+  };
+}
+function getDashboardHtml(config) {
+  return `
+<!DOCTYPE html>
+<html lang="en" class="dark">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Apptvty Logs \u2014 ${config.siteId}</title>
+    <script src="https://cdn.tailwindcss.com"></script>
+    <script src="https://unpkg.com/lucide@latest"></script>
+    <script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
+    <style>
+        @import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap');
+        body { font-family: 'Inter', sans-serif; background-color: #09090b; color: #fafafa; }
+        .glass { background: rgba(24, 24, 27, 0.8); backdrop-filter: blur(12px); border: 1px solid rgba(39, 39, 42, 1); }
+        .gradient-text { background: linear-gradient(to right, #60a5fa, #a855f7); -webkit-background-clip: text; -webkit-text-fill-color: transparent; }
+    </style>
+</head>
+<body class="p-6">
+    <div id="app" class="max-w-7xl mx-auto space-y-6">
+        <!-- Header -->
+        <header class="flex justify-between items-center mb-8">
+            <div>
+                <h1 class="text-3xl font-bold gradient-text">Activity Logs</h1>
+                <p class="text-zinc-400">Real-time agentic insights for ${config.siteId}</p>
+            </div>
+            <div class="flex items-center gap-3">
+                <span class="flex h-2 w-2 rounded-full bg-green-500 animate-pulse"></span>
+                <span class="text-sm font-medium text-zinc-300">Live Connection</span>
+            </div>
+        </header>
+
+        <!-- Stats Grid -->
+        <div class="grid grid-cols-1 md:grid-cols-4 gap-4" id="stats-grid">
+            <div class="glass p-5 rounded-2xl animate-pulse h-24"></div>
+            <div class="glass p-5 rounded-2xl animate-pulse h-24"></div>
+            <div class="glass p-5 rounded-2xl animate-pulse h-24"></div>
+            <div class="glass p-5 rounded-2xl animate-pulse h-24"></div>
+        </div>
+
+        <!-- Main Content -->
+        <div class="grid grid-cols-1 lg:grid-cols-3 gap-6">
+            <!-- Traffic Chart -->
+            <div class="lg:col-span-2 glass p-6 rounded-2xl">
+                <h2 class="text-lg font-semibold mb-4">Traffic Overview</h2>
+                <div class="h-[300px]">
+                    <canvas id="trafficChart"></canvas>
+                </div>
+            </div>
+
+            <!-- Recent Queries -->
+            <div class="glass p-6 rounded-2xl flex flex-col h-[400px]">
+                <div class="flex justify-between items-center mb-4">
+                    <h2 class="text-lg font-semibold">Agent Queries</h2>
+                    <button id="load-more-queries" class="text-xs text-blue-400 hover:text-blue-300 transition-colors">Load More</button>
+                </div>
+                <div id="queries-list" class="flex-1 overflow-y-auto space-y-3 custom-scrollbar">
+                    <div class="text-zinc-500 text-sm italic">Loading queries...</div>
+                </div>
+            </div>
+        </div>
+
+        <!-- Real-time Activity Table -->
+        <div class="glass p-6 rounded-2xl overflow-hidden">
+            <div class="flex justify-between items-center mb-4">
+                <h2 class="text-lg font-semibold">Real-time Activity</h2>
+                <button id="load-more-activity" class="text-sm px-3 py-1 bg-zinc-800 hover:bg-zinc-700 rounded-lg text-zinc-300 transition-colors">Load More</button>
+            </div>
+            <div class="overflow-x-auto">
+                <table class="w-full text-left">
+                    <thead>
+                        <tr class="text-zinc-500 text-sm border-b border-zinc-800">
+                            <th class="pb-3 pr-4">Timestamp</th>
+                            <th class="pb-3 pr-4">Method</th>
+                            <th class="pb-3 pr-4">Path</th>
+                            <th class="pb-3 pr-4">Agent</th>
+                            <th class="pb-3">Status</th>
+                        </tr>
+                    </thead>
+                    <tbody id="activity-body" class="text-sm">
+                        <tr><td colspan="5" class="pt-4 text-zinc-500 italic">Connecting to activity stream...</td></tr>
+                    </tbody>
+                </table>
+            </div>
+        </div>
+    </div>
+
+    <script>
+        const API_BASE = window.location.pathname.replace(//$/, '');
+        let queryOffset = 0;
+        let activityOffset = 0;
+        const LIMIT_QUERIES = 20;
+        const LIMIT_ACTIVITY = 50;
+
+        async function fetchData() {
+            try {
+                // Initial load or refresh (offset 0 resets)
+                const [overview, stats] = await Promise.all([
+                    fetch(\`\${API_BASE}/api/overview\`).then(r => r.json()),
+                    fetch(\`\${API_BASE}/api/stats\`).then(r => r.json())
+                ]);
+
+                updateStats(overview);
+                initChart(stats);
+
+                // Fetch first pages if empty
+                if (queryOffset === 0) fetchQueries(true);
+                if (activityOffset === 0) fetchActivity(true);
+            } catch (err) {
+                console.error('Failed to fetch dashboard data:', err);
+            }
+        }
+
+        async function fetchQueries(replace = false) {
+            try {
+                const data = await fetch(\`\${API_BASE}/api/queries?limit=\${LIMIT_QUERIES}&offset=\${queryOffset}\`).then(r => r.json());
+                updateQueries(data, replace);
+            } catch (e) { console.error('Queries error:', e); }
+        }
+
+        async function fetchActivity(replace = false) {
+            try {
+                const data = await fetch(\`\${API_BASE}/api/activity?limit=\${LIMIT_ACTIVITY}&offset=\${activityOffset}\`).then(r => r.json());
+                updateActivity(data, replace);
+            } catch (e) { console.error('Activity error:', e); }
+        }
+
+        function updateStats(data) {
+            const grid = document.getElementById('stats-grid');
+            grid.innerHTML = \`
+                <div class="glass p-5 rounded-2xl">
+                    <p class="text-zinc-400 text-xs font-medium uppercase tracking-wider mb-1">Total Requests</p>
+                    <p class="text-2xl font-bold">\${data.total_requests_30d.toLocaleString()}</p>
+                </div>
+                <div class="glass p-5 rounded-2xl border-l-4 border-blue-500">
+                    <p class="text-zinc-400 text-xs font-medium uppercase tracking-wider mb-1">AI Requests</p>
+                    <p class="text-2xl font-bold">\${data.ai_requests_30d.toLocaleString()}</p>
+                </div>
+                <div class="glass p-5 rounded-2xl">
+                    <p class="text-zinc-400 text-xs font-medium uppercase tracking-wider mb-1">AI Percentage</p>
+                    <p class="text-2xl font-bold text-blue-400">\${data.ai_percentage.toFixed(1)}%</p>
+                </div>
+                <div class="glass p-5 rounded-2xl">
+                    <p class="text-zinc-400 text-xs font-medium uppercase tracking-wider mb-1">Health Status</p>
+                    <p class="text-2xl font-bold text-green-400">Optimal</p>
+                </div>
+            \`;
+        }
+
+        function updateQueries(data, replace) {
+            const list = document.getElementById('queries-list');
+            const items = Array.isArray(data) ? data : (data.queries || []);
+            const rows = items.map(q => \`
+                <div class="p-3 bg-zinc-900/50 rounded-xl border border-zinc-800 hover:border-zinc-700 transition-colors">
+                    <p class="text-sm font-medium text-zinc-200">\${q.question || q.query}</p>
+                    <div class="mt-2 flex justify-between items-center text-[10px] text-zinc-500">
+                        <span class="flex items-center gap-1">
+                            <i data-lucide="clock" class="w-3 h-3"></i>
+                            \${new Date(q.timestamp).toLocaleString()}
+                        </span>
+                        <span class="px-2 py-0.5 rounded-full bg-blue-500/10 text-blue-400 border border-blue-500/20">
+                            Agent Match
+                        </span>
+                    </div>
+                </div>
+            \`).join('');
+
+            if (replace) list.innerHTML = rows || '<div class="text-zinc-600 text-sm">No recent queries.</div>';
+            else list.insertAdjacentHTML('beforeend', rows);
+            lucide.createIcons();
+        }
+
+        function updateActivity(data, replace) {
+            const body = document.getElementById('activity-body');
+            const items = Array.isArray(data) ? data : (data.activity || []);
+            const rows = items.map(r => \`
+                <tr class="border-b border-zinc-800/50 hover:bg-zinc-800/20 transition-colors">
+                    <td class="py-3 pr-4 text-zinc-400 text-xs">\${new Date(r.timestamp || r.created_at).toLocaleTimeString()}</td>
+                    <td class="py-3 pr-4 font-mono text-[10px] tracking-tight text-blue-400">\${r.method}</td>
+                    <td class="py-3 pr-4 text-zinc-300 max-w-xs truncate">\${r.path}</td>
+                    <td class="py-3 pr-4 text-zinc-500">\${r.crawler_type || 'Human'}</td>
+                    <td class="py-3">
+                        <span class="px-2 py-0.5 rounded-md \${r.status_code >= 400 ? 'bg-red-500/10 text-red-400' : 'bg-green-500/10 text-green-400'} text-[10px] font-medium border border-current/20">
+                            \${r.status_code || 200}
+                        </span>
+                    </td>
+                </tr>
+            \`).join('');
+
+            if (replace) body.innerHTML = rows || '<tr><td colspan="5" class="py-4 text-center text-zinc-600">No activity.</td></tr>';
+            else body.insertAdjacentHTML('beforeend', rows);
+        }
+
+        function initChart(stats) {
+            const canvas = document.getElementById('trafficChart');
+            if (window.myChart) window.myChart.destroy();
+            const ctx = canvas.getContext('2d');
+            window.myChart = new Chart(ctx, {
+                type: 'line',
+                data: {
+                    labels: stats.map(s => s.date.split('-').slice(1).join('/')),
+                    datasets: [
+                        {
+                            label: 'AI Requests',
+                            data: stats.map(s => s.ai_requests),
+                            borderColor: '#3b82f6',
+                            backgroundColor: 'rgba(59, 130, 246, 0.1)',
+                            fill: true,
+                            tension: 0.4
+                        },
+                        {
+                            label: 'Total Requests',
+                            data: stats.map(s => s.total_requests),
+                            borderColor: '#8b5cf6',
+                            backgroundColor: 'rgba(139, 92, 246, 0.1)',
+                            fill: true,
+                            tension: 0.4
+                        }
+                    ]
+                },
+                options: {
+                    responsive: true,
+                    maintainAspectRatio: false,
+                    plugins: { legend: { display: false }, tooltip: { mode: 'index', intersect: false } },
+                    scales: {
+                        y: { beginAtZero: true, grid: { color: 'rgba(39, 39, 42, 0.5)' }, ticks: { color: '#71717a' } },
+                        x: { grid: { display: false }, ticks: { color: '#71717a' } }
+                    }
+                }
+            });
+        }
+
+        document.getElementById('load-more-queries').onclick = () => {
+            queryOffset += LIMIT_QUERIES;
+            fetchQueries(false);
+        };
+
+        document.getElementById('load-more-activity').onclick = () => {
+            activityOffset += LIMIT_ACTIVITY;
+            fetchActivity(false);
+        };
+
+        fetchData();
+        setInterval(fetchData, 30000); // Polling for updates (stats only)
+    </script>
+</body>
+</html>
+  `;
+}
+
+// src/ad-injection.ts
+var AD_INJECTION_MARKER = "<!-- apptvty-sponsored -->";
+function injectIntoHtml(html, ads, isScraperService) {
+  if (!html || ads.length === 0) return html;
+  if (html.includes(AD_INJECTION_MARKER)) return html;
+  let modified = html;
+  const contentBlock = buildContentStreamBlock(ads);
+  if (modified.includes("</article>")) {
+    modified = modified.replace("</article>", `${contentBlock}
+</article>`);
+  } else if (modified.includes("</main>")) {
+    modified = modified.replace("</main>", `${contentBlock}
+</main>`);
+  } else if (!isScraperService && modified.includes("</body>")) {
+    modified = modified.replace("</body>", `${contentBlock}
+</body>`);
+  }
+  if (!isScraperService && modified.includes("</head>")) {
+    const jsonLdBlock = buildJsonLdBlock(ads);
+    modified = modified.replace("</head>", `${jsonLdBlock}
+</head>`);
+  }
+  return modified;
+}
+function buildSponsoredHeader(ads) {
+  return JSON.stringify(
+    ads.map((ad) => ({ text: ad.text, url: ad.url, advertiser: ad.advertiser }))
+  );
+}
+function buildContentStreamBlock(ads) {
+  const paragraphs = ads.map(
+    (ad) => `<p data-apptvty-sponsored="${escapeAttr(ad.impression_id)}"><strong>[Sponsored]</strong> <a href="${escapeAttr(ad.url)}" rel="sponsored noopener">${escapeHtml(ad.text)}</a> \u2014 <span>${escapeHtml(ad.advertiser)}</span></p>`
+  ).join("\n");
+  return `${AD_INJECTION_MARKER}
+${paragraphs}`;
+}
+function buildJsonLdBlock(ads) {
+  const entries = ads.map((ad) => ({
+    "@context": "https://schema.org",
+    "@type": "WPAdBlock",
+    sponsor: {
+      "@type": "Organization",
+      name: ad.advertiser,
+      url: ad.url
+    },
+    description: ad.text
+  }));
+  const ld = entries.length === 1 ? entries[0] : entries;
+  return `<script type="application/ld+json">${JSON.stringify(ld)}</script>`;
+}
+function escapeHtml(s) {
+  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+function escapeAttr(s) {
+  return s.replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+
 // src/middleware/nextjs.ts
 function headersToRecord(h) {
   const entries = h.entries();
@@ -544,8 +1114,9 @@ function withApptvty(config, next) {
     const startMs = Date.now();
     const userAgent = request.headers.get("user-agent") ?? "";
     const crawlerInfo = detectCrawler(userAgent);
+    const scraperService = detectScraperService(userAgent);
     const aiCrawlerParam = parseBoolParam(request.nextUrl.searchParams.get("ai_crawler"), false);
-    const isCrawler = crawlerInfo.isAi || aiCrawlerParam;
+    const isCrawler = crawlerInfo.isAi || aiCrawlerParam || scraperService.isScraperService;
     let response;
     try {
       response = next ? await next(request) : import_server.NextResponse.next();
@@ -571,14 +1142,23 @@ function withApptvty(config, next) {
       is_ai_crawler: crawlerInfo.isAi,
       crawler_type: crawlerInfo.name,
       crawler_organization: crawlerInfo.organization,
-      confidence_score: crawlerInfo.confidence
+      confidence_score: crawlerInfo.confidence,
+      scraper_service: scraperService.name
     };
     logger.enqueue(entry);
     if (isCrawler && response.ok && !pathname.startsWith(queryPath)) {
       const contentType = response.headers.get("content-type") ?? "";
       if (contentType.includes("text/html")) {
         try {
-          const modified = await injectAdsIntoHtml(response, client, config.siteId, pathname);
+          const modified = await injectAdsIntoResponse(
+            response,
+            client,
+            config,
+            pathname,
+            userAgent,
+            getClientIp(headers),
+            scraperService.isScraperService
+          );
           if (modified) return modified;
         } catch (err) {
           if (config.debug) console.warn("[apptvty] Ad injection failed:", err);
@@ -614,40 +1194,53 @@ function createNextjsQueryHandler(config) {
     });
   };
 }
-var AD_INJECTION_MARKER = "<!-- apptvty-sponsored -->";
-function buildAdBlock(ads) {
-  const items = ads.map(
-    (ad) => `<li><a href="${escapeHtml(ad.url)}" rel="nofollow">${escapeHtml(ad.text)}</a> <small>\u2014 ${escapeHtml(ad.advertiser)}</small></li>`
-  ).join("\n");
-  return `
-<section aria-label="Sponsored" data-sponsored ${AD_INJECTION_MARKER}>
-  <h3>Sponsored</h3>
-  <ul>${items}</ul>
-</section>`;
-}
-function escapeHtml(s) {
-  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+function createNextjsDashboardHandler(config) {
+  const { client } = getInstance(config);
+  const handleDashboard = createDashboardHandler(client, config);
+  return async function dashboardHandler(request) {
+    const result = await handleDashboard({
+      path: request.nextUrl.pathname + request.nextUrl.search,
+      method: request.method,
+      apiKey: config.apiKey,
+      siteId: config.siteId
+    });
+    if (result.headers["Content-Type"] === "text/html") {
+      return new import_server.NextResponse(result.body, {
+        status: result.status,
+        headers: result.headers
+      });
+    }
+    return import_server.NextResponse.json(JSON.parse(result.body), {
+      status: result.status,
+      headers: result.headers
+    });
+  };
 }
-async function injectAdsIntoHtml(response, client, siteId, pathname) {
+async function injectAdsIntoResponse(response, client, config, pathname, userAgent, ipAddress, isScraperService) {
   const html = await response.text();
-  if (!html || html.includes(AD_INJECTION_MARKER)) return null;
-  const pageAds = await client.getAdsForPage({ site_id: siteId, page_path: pathname });
+  if (!html) return null;
+  const pageAds = await client.getAdsForPage({ site_id: config.siteId, page_path: pathname });
   if (!pageAds.ads || pageAds.ads.length === 0) return null;
-  const adBlock = buildAdBlock(pageAds.ads);
-  let modified;
-  if (html.includes("</body>")) {
-    modified = html.replace("</body>", `${adBlock}
-</body>`);
-  } else if (html.includes("</html>")) {
-    modified = html.replace("</html>", `${adBlock}
-</html>`);
-  } else {
-    modified = html + adBlock;
+  const modified = injectIntoHtml(html, pageAds.ads, isScraperService);
+  if (modified === html) return null;
+  const newHeaders = new Headers(response.headers);
+  newHeaders.set("X-Sponsored-Content", buildSponsoredHeader(pageAds.ads));
+  const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+  for (const ad of pageAds.ads) {
+    client.logImpression({
+      impression_id: ad.impression_id,
+      site_id: config.siteId,
+      page_path: pathname,
+      agent_ua: userAgent,
+      agent_ip: ipAddress,
+      timestamp
+    }).catch(() => {
+    });
   }
   return new import_server.NextResponse(modified, {
     status: response.status,
     statusText: response.statusText,
-    headers: new Headers(response.headers)
+    headers: newHeaders
   });
 }
 function parseBoolParam(value, defaultValue) {
@@ -659,6 +1252,7 @@ function shouldSkip(pathname) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  createNextjsDashboardHandler,
   createNextjsQueryHandler,
   withApptvty
 });