apptvty 0.1.5 → 0.2.0

package/dist/middleware/express.js

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/middleware/express.ts
 var express_exports = {};
 __export(express_exports, {
+  createExpressDashboardHandler: () => createExpressDashboardHandler,
   createExpressMiddleware: () => createExpressMiddleware,
   createExpressQueryHandler: () => createExpressQueryHandler
 });
@@ -38,6 +39,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.
@@ -110,6 +118,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) });
@@ -126,6 +148,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) {
@@ -134,7 +256,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)
@@ -145,22 +267,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);
@@ -196,6 +387,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 = [
@@ -305,6 +506,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 {
@@ -521,6 +743,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/express.ts
 var instances = /* @__PURE__ */ new Map();
 function getInstance(config) {
@@ -533,12 +1103,77 @@ function getInstance(config) {
   return instances.get(key);
 }
 function createExpressMiddleware(config) {
-  const { logger } = getInstance(config);
-  return function apptvtyLogger(req, res, next) {
+  const { client, logger } = getInstance(config);
+  return function apptvtyMiddleware(req, res, next) {
     const startMs = Date.now();
     const userAgent = req.headers["user-agent"] ?? "";
     const crawlerInfo = detectCrawler(userAgent);
+    const scraperService = detectScraperService(userAgent);
     const path = req.url ?? "/";
+    const isCrawler = crawlerInfo.isAi || scraperService.isScraperService;
+    const ipAddress = getClientIp(req.headers);
+    const adsPromise = isCrawler && !shouldSkip(path) ? client.getAdsForPage({ site_id: config.siteId, page_path: path }).catch(() => ({ ads: [] })) : Promise.resolve({ ads: [] });
+    if (isCrawler && !shouldSkip(path)) {
+      const chunks = [];
+      const originalWrite = res.write.bind(res);
+      const originalEnd = res.end.bind(res);
+      res.write = function(chunk, encodingOrCallback, callback) {
+        if (chunk != null) {
+          chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+        }
+        if (typeof encodingOrCallback === "function") encodingOrCallback();
+        else if (typeof callback === "function") callback();
+        return true;
+      };
+      res.end = function(chunk, encodingOrCallback, callback) {
+        if (chunk != null) {
+          chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+        }
+        const contentType = res.getHeader("content-type") ?? "";
+        const isHtml = contentType.includes("text/html");
+        if (!isHtml || chunks.length === 0) {
+          res.write = originalWrite;
+          res.end = originalEnd;
+          return originalEnd(Buffer.concat(chunks), encodingOrCallback, callback);
+        }
+        const html = Buffer.concat(chunks).toString("utf-8");
+        if (html.includes(AD_INJECTION_MARKER)) {
+          res.write = originalWrite;
+          res.end = originalEnd;
+          return originalEnd(html, encodingOrCallback, callback);
+        }
+        adsPromise.then((pageAds) => {
+          res.write = originalWrite;
+          res.end = originalEnd;
+          if (!pageAds.ads || pageAds.ads.length === 0) {
+            originalEnd(html, encodingOrCallback, callback);
+            return;
+          }
+          const modified = injectIntoHtml(html, pageAds.ads, scraperService.isScraperService);
+          res.setHeader("X-Sponsored-Content", buildSponsoredHeader(pageAds.ads));
+          const buf = Buffer.from(modified, "utf-8");
+          res.setHeader("Content-Length", buf.length);
+          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: path,
+              agent_ua: userAgent,
+              agent_ip: ipAddress,
+              timestamp
+            }).catch(() => {
+            });
+          }
+          originalEnd(buf, encodingOrCallback, callback);
+        }).catch(() => {
+          res.write = originalWrite;
+          res.end = originalEnd;
+          originalEnd(html, encodingOrCallback, callback);
+        });
+        return res;
+      };
+    }
     res.on("finish", () => {
       if (shouldSkip(path)) return;
       const entry = {
@@ -548,13 +1183,14 @@ function createExpressMiddleware(config) {
         path,
         status_code: res.statusCode,
         response_time_ms: Date.now() - startMs,
-        ip_address: getClientIp(req.headers),
+        ip_address: ipAddress,
         user_agent: userAgent,
         referer: req.headers["referer"] ?? null,
         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);
     });
@@ -587,6 +1223,24 @@ function createExpressQueryHandler(config) {
     res.end(JSON.stringify(result.body));
   };
 }
+function createExpressDashboardHandler(config) {
+  const { client } = getInstance(config);
+  const handleDashboard = createDashboardHandler(client, config);
+  return async function dashboardHandler(req, res) {
+    const url = new URL(req.url ?? "/", `http://${req.headers.host ?? "localhost"}`);
+    const result = await handleDashboard({
+      path: url.pathname + url.search,
+      method: req.method ?? "GET",
+      apiKey: config.apiKey,
+      siteId: config.siteId
+    });
+    for (const [key, value] of Object.entries(result.headers)) {
+      res.setHeader(key, value);
+    }
+    res.statusCode = result.status;
+    res.end(result.body);
+  };
+}
 function parseBoolParam(value, defaultValue) {
   if (value === null) return defaultValue;
   return value === "1" || value === "true" || value === "yes";
@@ -596,6 +1250,7 @@ function shouldSkip(path) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  createExpressDashboardHandler,
   createExpressMiddleware,
   createExpressQueryHandler
 });