apptvty 0.3.1 → 0.3.2

package/dist/{chunk-DFSZAE6R.mjs → chunk-6LXUHEWB.mjs}

@@ -6,7 +6,7 @@ import {
   detectCrawler,
   detectScraperService,
   getClientIp
-} from "./chunk-EZYPAN7G.mjs";
+} from "./chunk-LHLZDTTY.mjs";
 
 // src/ad-injection.ts
 var AD_INJECTION_MARKER = "<!-- apptvty-sponsored -->";
@@ -229,4 +229,4 @@ export {
   createExpressQueryHandler,
   createExpressDashboardHandler
 };
-//# sourceMappingURL=chunk-DFSZAE6R.mjs.map
+//# sourceMappingURL=chunk-6LXUHEWB.mjs.map

package/dist/{chunk-EZYPAN7G.mjs → chunk-LHLZDTTY.mjs}

@@ -80,6 +80,28 @@ var ApptvtyClient = class {
       this.warn("Failed to log impression (billing may be delayed):", err);
     }
   }
+  // ─── Programmatic Indexing ───────────────────────────────────────────────────
+  /**
+   * Manually push text or markdown directly into your site's RAG vector database.
+   * This instantly embeds the content for AI agents to query, bypassing the 
+   * need for a scheduled HTML crawl. This is ideal for Client-Side Rendered (CSR) 
+   * Apps or for injecting private institutional facts/databases.
+   *
+   * @example
+   * const result = await client.pushKnowledge({
+   *   title: "Capitol Technology University Profile",
+   *   content: "Here are all the detailed specs, majors, and acceptances...",
+   *   url: "https://thecollegeradar.com/institution/499" // Optional reference
+   * });
+   */
+  async pushKnowledge(params) {
+    const payload = {
+      title: params.title,
+      content: params.content,
+      url: params.url
+    };
+    return this.post(`/v1/sites/${this.siteId}/knowledge`, payload);
+  }
   // ─── Analytics (for coding agents) ───────────────────────────────────────────
   // These allow agents to check activity, logs, and errors without a human.
   /** Get 30-day traffic overview (requests, AI %, crawlers, queries). */
@@ -327,8 +349,12 @@ var ApptvtyClient = class {
         let dashboardUrl = (typeof process !== "undefined" ? process.env?.DASHBOARD_URL : void 0) ?? "https://dashboard.apptvty.com/login";
         try {
           const json = JSON.parse(text);
+          if (json?.error?.code === "INSUFFICIENT_BALANCE") {
+            throw new ApptvtyApiError(402, path, text);
+          }
           dashboardUrl = json?.error?.details?.dashboard_url ?? dashboardUrl;
-        } catch {
+        } catch (e) {
+          if (e instanceof ApptvtyApiError) throw e;
         }
         throw new ApptvtyTrialExpiredError(dashboardUrl);
       }
@@ -1077,4 +1103,4 @@ export {
   createQueryHandler,
   createDashboardHandler
 };
-//# sourceMappingURL=chunk-EZYPAN7G.mjs.map
+//# sourceMappingURL=chunk-LHLZDTTY.mjs.map

package/dist/chunk-LHLZDTTY.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../src/logger.ts","../src/crawler.ts","../src/query-handler.ts","../src/dashboard-handler.ts"],"sourcesContent":["/**\n * HTTP client for the Apptvty API.\n *\n * Handles:\n *   - Batch log ingestion (/v1/logs/batch)\n *   - Query processing (/v1/query) — returns answer + optional ad\n *   - Impression logging (/v1/impressions) — triggers billing for ads\n */\n\nimport type {\n  ApptvtyConfig,\n  BackendQueryResponse,\n  CampaignRecord,\n  CrawlerBreakdown,\n  CreateCampaignParams,\n  DailyStat,\n  ImpressionLog,\n  InsufficientBalanceError,\n  PageAdsResponse,\n  QueryRequest,\n  RecentActivityItem,\n  RecentQueryItem,\n  RequestLogEntry,\n  SiteOverviewStats,\n  SiteWalletInfo,\n  UpdateCampaignParams,\n  IndexDocumentOptions,\n  IndexDocumentResult,\n} from './types.js';\n\nconst DEFAULT_BASE_URL = 'https://api.apptvty.com';\n\nfunction resolveBaseUrl(config: ApptvtyConfig): string {\n  const raw: string =\n    config.baseUrl ??\n    (typeof process !== 'undefined' ? process.env?.APPTVTY_API_URL : undefined) ??\n    DEFAULT_BASE_URL;\n  return raw.replace(/\\/$/, '');\n}\n\nexport class ApptvtyClient {\n  private readonly baseUrl: string;\n  private readonly apiKey: string;\n  private readonly siteId: string;\n  private readonly debug: boolean;\n\n  private x402Token?: string;\n\n  constructor(config: ApptvtyConfig) {\n    this.baseUrl = resolveBaseUrl(config);\n    this.apiKey = config.apiKey;\n    this.siteId = config.siteId;\n    this.debug = config.debug ?? false;\n  }\n\n  /**\n   * Set the X402 (LSAT) token for subsequent requests.\n   * This is called after the agent has successfully paid an X402 challenge.\n   */\n  setX402Token(macaroon: string, preimage: string): void {\n    this.x402Token = `LSAT ${macaroon}:${preimage}`;\n  }\n\n  /**\n   * Send a batch of request log entries to the Apptvty ingestion API.\n   * Called by the logger's auto-flush — not called directly by user code.\n   */\n  async sendLogs(logs: RequestLogEntry[]): Promise<void> {\n    if (logs.length === 0) return;\n\n    try {\n      await this.post('/v1/logs/batch', { logs });\n      this.log(`Flushed ${logs.length} log(s)`);\n    } catch (err) {\n      if (err instanceof ApptvtyTrialExpiredError) {\n        // Always visible — coding agents and developers need to see this\n        console.warn(\n          `\\n[apptvty] ⚠  FREE TRIAL EXPIRED\\n` +\n          `[apptvty]    Log in and upgrade to keep receiving agent analytics.\\n` +\n          `[apptvty]    Dashboard: ${err.dashboardUrl}\\n`,\n        );\n        return;\n      }\n      // Other logging failures must never propagate to the user's request path\n      this.warn('Failed to send logs:', err);\n    }\n  }\n\n  /**\n   * Send a query to the Apptvty backend.\n   * The backend runs RAG against the site's indexed content and,\n   * if ads are enabled for the site, attaches a relevant sponsored ad.\n   *\n   * @throws on non-retryable errors (network errors, 5xx) — callers should catch\n   */\n  async query(req: QueryRequest): Promise<BackendQueryResponse> {\n    // ApptvtyTrialExpiredError propagates to the query handler, which surfaces it to the agent\n    const response = await this.post<BackendQueryResponse>('/v1/query', req);\n    return response;\n  }\n\n  /**\n   * Get relevant ads for a page (for HTML injection when crawler is detected).\n   * Used by middleware to inject ads into HTML responses.\n   */\n  async getAdsForPage(req: { site_id: string; page_path: string }): Promise<PageAdsResponse> {\n    const response = await this.post<PageAdsResponse>('/v1/ads/for-page', req);\n    return response;\n  }\n\n  /**\n   * Log an ad impression back to Apptvty.\n   *\n   * Called after returning a query response that contains a `sponsored` block.\n   * This is what triggers the billing cycle:\n   *   - Advertiser gets charged (debited from their USDC ad budget)\n   *   - Publisher (the website) gets credited in USDC\n   *\n   * This call is fire-and-forget. The SDK logs a warning on failure\n   * but does not throw — a missed impression log is better than\n   * breaking the query response.\n   */\n  async logImpression(impression: ImpressionLog): Promise<void> {\n    try {\n      await this.post('/v1/impressions', impression);\n      this.log(`Impression logged: ${impression.impression_id}`);\n    } catch (err) {\n      this.warn('Failed to log impression (billing may be delayed):', err);\n    }\n  }\n\n  // ─── Programmatic Indexing ───────────────────────────────────────────────────\n\n  /**\n   * Manually push text or markdown directly into your site's RAG vector database.\n   * This instantly embeds the content for AI agents to query, bypassing the \n   * need for a scheduled HTML crawl. This is ideal for Client-Side Rendered (CSR) \n   * Apps or for injecting private institutional facts/databases.\n   *\n   * @example\n   * const result = await client.pushKnowledge({\n   *   title: \"Capitol Technology University Profile\",\n   *   content: \"Here are all the detailed specs, majors, and acceptances...\",\n   *   url: \"https://thecollegeradar.com/institution/499\" // Optional reference\n   * });\n   */\n  async pushKnowledge(params: Omit<IndexDocumentOptions, 'apiKey' | 'siteId' | 'apiUrl'>): Promise<IndexDocumentResult> {\n    const payload = {\n      title: params.title,\n      content: params.content,\n      url: params.url,\n    };\n    return this.post<IndexDocumentResult>(`/v1/sites/${this.siteId}/knowledge`, payload);\n  }\n\n  // ─── Analytics (for coding agents) ───────────────────────────────────────────\n  // These allow agents to check activity, logs, and errors without a human.\n\n  /** Get 30-day traffic overview (requests, AI %, crawlers, queries). */\n  async getSiteStats(): Promise<SiteOverviewStats> {\n    return this.get<SiteOverviewStats>(`/v1/sites/${this.siteId}/stats`);\n  }\n\n  /** Get day-by-day stats (default 30 days, max 90). */\n  async getSiteDailyStats(days = 30): Promise<{ days: number; stats: DailyStat[] }> {\n    return this.get(`/v1/sites/${this.siteId}/stats/daily`, { days: String(days) });\n  }\n\n  /** Get recent activity logs (last 48h). */\n  async getRecentActivity(siteId: string, limit = 50, offset = 0): Promise<RecentActivityItem[]> {\n    return this.get(`/v1/sites/${siteId}/activity`, {\n      limit: String(limit),\n      offset: String(offset),\n    });\n  }\n\n  /** Get recent agent queries. */\n  async getRecentQueries(siteId: string, limit = 20, offset = 0): Promise<RecentQueryItem[]> {\n    return this.get(`/v1/sites/${siteId}/queries`, {\n      limit: String(limit),\n      offset: String(offset),\n    });\n  }\n\n  /** Get crawler breakdown by type (default 30 days). */\n  async getSiteCrawlers(days = 30): Promise<{ days: number; crawlers: CrawlerBreakdown[] }> {\n    return this.get(`/v1/sites/${this.siteId}/crawlers`, { days: String(days) });\n  }\n\n  /** Get recent activity feed (last hour, default 50 items, max 200). */\n  async getSiteActivity(limit = 50): Promise<{ activity: RecentActivityItem[] }> {\n    return this.get(`/v1/sites/${this.siteId}/activity`, { limit: String(limit) });\n  }\n\n  /** Get recent agent queries (default 50, max 200). */\n  async getSiteQueries(limit = 50): Promise<{ queries: RecentQueryItem[] }> {\n    return this.get(`/v1/sites/${this.siteId}/queries`, { limit: String(limit) });\n  }\n\n  /** Get wallet balance and earnings. */\n  async getSiteWallet(): Promise<SiteWalletInfo> {\n    return this.get<SiteWalletInfo>(`/v1/sites/${this.siteId}/wallet`);\n  }\n\n  // ─── Campaign management (for coding agents) ────────────────────────────────\n  //\n  // A coding agent that installed the SDK can create and manage ad campaigns\n  // programmatically — no human dashboard login required.\n  //\n  // Typical agentic advertiser flow:\n  //   1. Check wallet balance:  const w = await client.getSiteWallet()\n  //   2. Fund wallet if needed: send USDC to w.wallet_address on Base chain\n  //   3. Create campaign:       await client.createCampaign({ ... })\n  //   4. Monitor performance:   await client.getCampaign(id)\n  //   5. Adjust or pause:       await client.updateCampaign(id, { status: 'paused' })\n\n  /**\n   * Create an ad campaign. The campaign goes live immediately once the wallet\n   * has sufficient balance.\n   *\n   * If the wallet balance is too low, throws `ApptvtyInsufficientBalanceError`\n   * which includes deposit instructions so the agent can fund the wallet and retry.\n   *\n   * @example\n   * // Site-based: ad copy derived from your site's crawled content\n   * const campaign = await client.createCampaign({\n   *   name: 'My Kubernetes Blog',\n   *   advertiser_site_id: 'site_abc123',\n   *   keywords: ['kubernetes', 'devops', 'containers'],\n   *   categories: ['technology'],\n   *   bid_per_view_usdc: 0.001,\n   *   daily_budget_usdc: 1.0,\n   *   total_budget_usdc: 20.0,\n   * });\n   *\n   * // Static: manually written ad copy\n   * const campaign = await client.createCampaign({\n   *   name: 'My Blog — Static',\n   *   ad_text: 'Deep dives on Kubernetes, written by practitioners.',\n   *   landing_url: 'https://myblog.com',\n   *   keywords: ['kubernetes', 'devops'],\n   *   categories: ['technology'],\n   *   bid_per_view_usdc: 0.001,\n   *   daily_budget_usdc: 1.0,\n   *   total_budget_usdc: 10.0,\n   * });\n   */\n  async createCampaign(params: CreateCampaignParams): Promise<CampaignRecord> {\n    try {\n      return await this.post<CampaignRecord>('/v1/campaigns', params);\n    } catch (err) {\n      if (err instanceof ApptvtyApiError && err.statusCode === 402) {\n        let details: InsufficientBalanceError | undefined;\n        try {\n          const body = JSON.parse(err.body);\n          details = body?.error as InsufficientBalanceError;\n        } catch { /* ignore parse errors */ }\n        throw new ApptvtyInsufficientBalanceError(details);\n      }\n      throw err;\n    }\n  }\n\n  /**\n   * List all campaigns for this account.\n   * Also returns the schema (valid categories, minimum bid) so the agent\n   * knows valid field values without guessing.\n   */\n  async listCampaigns(): Promise<{\n    campaigns: CampaignRecord[];\n    total: number;\n    schema: { valid_categories: string[]; valid_statuses: string[]; bid_per_view_usdc_minimum: number };\n  }> {\n    return this.get('/v1/campaigns');\n  }\n\n  /**\n   * Get a single campaign by ID, including current spend and impression count.\n   * `budget_remaining_usdc` tells the agent how much budget is left before\n   * the campaign auto-pauses.\n   */\n  async getCampaign(campaignId: string): Promise<CampaignRecord> {\n    return this.get<CampaignRecord>(`/v1/campaigns/${campaignId}`);\n  }\n\n  /**\n   * Partially update a campaign. Only fields present in `params` are changed.\n   *\n   * @example\n   * // Pause a campaign\n   * await client.updateCampaign(id, { status: 'paused' });\n   *\n   * // Increase bid and daily budget\n   * await client.updateCampaign(id, { bid_per_view_usdc: 0.002, daily_budget_usdc: 5.0 });\n   */\n  async updateCampaign(campaignId: string, params: UpdateCampaignParams): Promise<CampaignRecord> {\n    return this.patch<CampaignRecord>(`/v1/campaigns/${campaignId}`, params);\n  }\n\n  /**\n   * Pause a campaign immediately. Equivalent to updateCampaign(id, { status: 'paused' }).\n   * Campaigns are never deleted — billing history is retained.\n   */\n  async pauseCampaign(campaignId: string): Promise<void> {\n    await this.delete(`/v1/campaigns/${campaignId}`);\n  }\n\n  /**\n   * Resume a paused campaign.\n   */\n  async resumeCampaign(campaignId: string): Promise<void> {\n    await this.patch(`/v1/campaigns/${campaignId}`, { status: 'active' });\n  }\n\n  private async get<T>(path: string, params?: Record<string, string>): Promise<T> {\n    const url = new URL(`${this.baseUrl}${path}`);\n    if (params) {\n      Object.entries(params).forEach(([k, v]) => url.searchParams.set(k, v));\n    }\n    const response = await fetch(url.toString(), {\n      method: 'GET',\n      headers: {\n        Authorization: this.x402Token ?? `Bearer ${this.apiKey}`,\n        'User-Agent': 'apptvty-sdk/0.1.0',\n      },\n      signal: AbortSignal.timeout(10_000),\n    });\n    if (!response.ok) {\n      const text = await response.text().catch(() => '');\n      throw new ApptvtyApiError(response.status, path, text);\n    }\n    return response.json() as Promise<T>;\n  }\n\n  private async patch<T>(path: string, body: unknown): Promise<T> {\n    const url = `${this.baseUrl}${path}`;\n    const response = await fetch(url, {\n      method: 'PATCH',\n      headers: {\n        'Authorization': this.x402Token ?? `Bearer ${this.apiKey}`,\n        'Content-Type': 'application/json',\n        'User-Agent': 'apptvty-sdk/0.1.0',\n      },\n      body: JSON.stringify(body),\n      signal: AbortSignal.timeout(10_000),\n    });\n    if (!response.ok) {\n      const text = await response.text().catch(() => '');\n      throw new ApptvtyApiError(response.status, path, text);\n    }\n    return response.json() as Promise<T>;\n  }\n\n  private async delete(path: string): Promise<void> {\n    const url = `${this.baseUrl}${path}`;\n    const response = await fetch(url, {\n      method: 'DELETE',\n      headers: {\n        'Authorization': this.x402Token ?? `Bearer ${this.apiKey}`,\n        'User-Agent': 'apptvty-sdk/0.1.0',\n      },\n      signal: AbortSignal.timeout(10_000),\n    });\n    if (!response.ok) {\n      const text = await response.text().catch(() => '');\n      throw new ApptvtyApiError(response.status, path, text);\n    }\n  }\n\n  /**\n   * Settle an X402 challenge from the site's own USDC wallet balance.\n   * Called automatically when `post()` receives a 402 with an X402 header.\n   * Returns the preimage on success, or throws if the wallet balance is too low.\n   */\n  private async payX402Challenge(macaroon: string): Promise<string> {\n    const url = `${this.baseUrl}/v1/x402/pay`;\n    const response = await fetch(url, {\n      method: 'POST',\n      headers: {\n        Authorization: `Bearer ${this.apiKey}`,\n        'Content-Type': 'application/json',\n        'User-Agent': 'apptvty-sdk/0.1.0',\n      },\n      body: JSON.stringify({ macaroon }),\n      signal: AbortSignal.timeout(10_000),\n    });\n\n    const text = await response.text().catch(() => '');\n    if (!response.ok) {\n      let details: InsufficientBalanceError | undefined;\n      try { details = JSON.parse(text)?.error?.details as InsufficientBalanceError; } catch {}\n      throw new ApptvtyInsufficientBalanceError(details);\n    }\n\n    const json = JSON.parse(text) as { preimage: string };\n    return json.preimage;\n  }\n\n  private async post<T>(path: string, body: unknown): Promise<T> {\n    const url = `${this.baseUrl}${path}`;\n    const response = await fetch(url, {\n      method: 'POST',\n      headers: {\n        'Authorization': this.x402Token ?? `Bearer ${this.apiKey}`,\n        'Content-Type': 'application/json',\n        'User-Agent': 'apptvty-sdk/0.1.0',\n      },\n      body: JSON.stringify(body),\n      signal: AbortSignal.timeout(10_000),\n    });\n\n    if (!response.ok) {\n      const text = await response.text().catch(() => '');\n      if (response.status === 402) {\n        const authHeader = response.headers.get('WWW-Authenticate');\n        if (authHeader?.includes('X402') || authHeader?.includes('LSAT')) {\n          const macaroon = authHeader.match(/macaroon=\"([^\"]+)\"/)?.[1] || '';\n          // Auto-pay from wallet balance and retry once\n          const preimage = await this.payX402Challenge(macaroon);\n          this.setX402Token(macaroon, preimage);\n          this.log('X402 challenge auto-paid from wallet, retrying request');\n          return this.post<T>(path, body);\n        }\n        let dashboardUrl = (typeof process !== 'undefined' ? process.env?.DASHBOARD_URL : undefined) ?? 'https://dashboard.apptvty.com/login';\n        try {\n          const json = JSON.parse(text);\n          if (json?.error?.code === 'INSUFFICIENT_BALANCE') {\n            throw new ApptvtyApiError(402, path, text);\n          }\n          dashboardUrl = json?.error?.details?.dashboard_url ?? dashboardUrl;\n        } catch (e) {\n          if (e instanceof ApptvtyApiError) throw e;\n        }\n        throw new ApptvtyTrialExpiredError(dashboardUrl);\n      }\n      throw new ApptvtyApiError(response.status, path, text);\n    }\n\n    return response.json() as Promise<T>;\n  }\n\n  private log(...args: unknown[]): void {\n    if (this.debug) console.log('[apptvty]', ...args);\n  }\n\n  private warn(...args: unknown[]): void {\n    if (this.debug) console.warn('[apptvty]', ...args);\n  }\n}\n\nexport class ApptvtyApiError extends Error {\n  constructor(\n    public readonly statusCode: number,\n    public readonly path: string,\n    public readonly body: string,\n  ) {\n    super(`Apptvty API error ${statusCode} at ${path}: ${body}`);\n    this.name = 'ApptvtyApiError';\n  }\n}\n\nexport class ApptvtyTrialExpiredError extends Error {\n  constructor(public readonly dashboardUrl: string) {\n    super(`Apptvty free trial has expired. Log in to continue: ${dashboardUrl}`);\n    this.name = 'ApptvtyTrialExpiredError';\n  }\n}\n\nexport class ApptvtyX402Error extends Error {\n  constructor(public readonly macaroon: string, public readonly invoice: string) {\n    super(`X402 Payment Required: Activity trial has ended. Pay invoice to continue: ${invoice}`);\n    this.name = 'ApptvtyX402Error';\n  }\n}\n\n/**\n * Thrown by createCampaign() when the wallet balance is too low.\n *\n * The `details` property contains everything needed to fund the wallet\n * autonomously and retry — the agent can inspect `details.deposit.address`\n * and send USDC on Base without human intervention.\n *\n * @example\n * import { ApptvtyInsufficientBalanceError } from 'apptvty';\n *\n * try {\n *   await client.createCampaign(params);\n * } catch (err) {\n *   if (err instanceof ApptvtyInsufficientBalanceError) {\n *     const { shortfall_usdc, deposit } = err.details;\n *     // Agent can now: send shortfall_usdc USDC to deposit.address on deposit.chain\n *     // Then retry createCampaign\n *   }\n * }\n */\nexport class ApptvtyInsufficientBalanceError extends Error {\n  constructor(public readonly details: import('./types.js').InsufficientBalanceError | undefined) {\n    const shortfall = details?.shortfall_usdc ?? '?';\n    super(\n      `Wallet balance too low to create campaign. ` +\n      `Send ${shortfall} USDC to ${details?.deposit?.address ?? 'your wallet'} on Base and retry.`,\n    );\n    this.name = 'ApptvtyInsufficientBalanceError';\n  }\n}\n","/**\n * Batched request logger.\n *\n * Queues RequestLogEntry objects in memory and flushes them in batches\n * to the Apptvty API. This keeps per-request overhead near zero.\n *\n * Flush triggers:\n *   1. Queue reaches batchSize (default 50)\n *   2. flushInterval elapses (default 5s)\n *   3. process.exit / SIGTERM (best-effort sync flush)\n */\n\nimport type { ApptvtyClient } from './client.js';\nimport type { ApptvtyConfig, RequestLogEntry } from './types.js';\n\nexport class RequestLogger {\n  private queue: RequestLogEntry[] = [];\n  private timer: ReturnType<typeof setInterval> | null = null;\n  private activeFlushPromise: Promise<void> | null = null;\n  private readonly batchSize: number;\n  private readonly debug: boolean;\n\n  constructor(\n    private readonly client: ApptvtyClient,\n    config: ApptvtyConfig,\n  ) {\n    this.batchSize = config.batchSize ?? 50;\n    this.debug = config.debug ?? false;\n\n    const interval = config.flushInterval ?? 5_000;\n    this.timer = setInterval(() => { void this.flush(); }, interval);\n\n    // Unref so the timer doesn't keep the process alive\n    if (this.timer && typeof (this.timer as any).unref === 'function') {\n      (this.timer as any).unref();\n    }\n\n    // Best-effort flush on process shutdown (Node-only)\n    if (typeof process !== 'undefined' && typeof process.once === 'function') {\n      const handleExit = () => { void this.flushSync(); };\n      try {\n        process.once('SIGTERM', handleExit);\n        process.once('SIGINT', handleExit);\n        process.once('beforeExit', handleExit);\n      } catch {\n        // Ignore errors in environments where process exists but signal listeners don't\n      }\n    }\n  }\n\n  /** Enqueue a single log entry. Non-blocking. */\n  enqueue(entry: RequestLogEntry): void {\n    this.queue.push(entry);\n    // In Serverless environments (Vercel), we must flush immediately \n    // because the process might be suspended after the request ends.\n    void this.flush();\n  }\n\n  /** Flush the current queue to the API. Returns the active Promise so Edge runtimes can wait. */\n  async flush(): Promise<void> {\n    if (this.queue.length === 0) {\n      return this.activeFlushPromise || Promise.resolve();\n    }\n\n    // If already flushing, return the current promise to pause the edge thread\n    // and let the next event loop check the queue again.\n    if (this.activeFlushPromise) {\n      await this.activeFlushPromise;\n      if (this.queue.length > 0) return this.flush();\n      return Promise.resolve();\n    }\n\n    const batch = this.queue.splice(0, this.batchSize);\n\n    this.activeFlushPromise = (async () => {\n      try {\n        await this.client.sendLogs(batch);\n      } catch {\n        // Already handled (logged) inside client.sendLogs — nothing to do here\n      } finally {\n        this.activeFlushPromise = null;\n        // Keep draining the queue if elements remain\n        if (this.queue.length > 0) {\n          // Fire explicitly without awaiting to avoid endless sync recursion lock scope,\n          // it will assign a new activeFlushPromise.\n          void this.flush();\n        }\n      }\n    })();\n\n    return this.activeFlushPromise;\n  }\n\n  /**\n   * Synchronous-ish flush for process shutdown.\n   * Fires the fetch and doesn't await to avoid blocking exit handlers.\n   */\n  private flushSync(): void {\n    if (this.queue.length === 0) return;\n    const batch = this.queue.splice(0);\n    // Fire without await — best effort on exit\n    void this.client.sendLogs(batch);\n  }\n\n  /** Stop the interval timer. Call when you want to fully tear down the SDK. */\n  destroy(): void {\n    if (this.timer) {\n      clearInterval(this.timer);\n      this.timer = null;\n    }\n    void this.flush();\n  }\n\n  private log(...args: unknown[]): void {\n    if (this.debug) console.log('[apptvty:logger]', ...args);\n  }\n}\n\n// ─── Helpers used by middleware to build log entries ──────────────────────────\n\nexport function getClientIp(headers: Record<string, string | string[] | undefined>): string {\n  const forwarded = headers['x-forwarded-for'];\n  if (forwarded) {\n    const first = Array.isArray(forwarded) ? forwarded[0] : forwarded;\n    return first.split(',')[0].trim();\n  }\n  return (headers['x-real-ip'] as string) ?? 'unknown';\n}\n","/**\n * Lightweight AI crawler detection.\n *\n * This is the single source of truth for crawler classification in the SDK.\n * The backend (Python analytics API and TypeScript handlers) should eventually\n * consume this same list rather than maintaining separate copies.\n */\n\nimport type { CrawlerInfo } from './types.js';\n\ninterface KnownCrawler {\n  name: string;\n  organization: string;\n  patterns: RegExp[];\n}\n\nconst KNOWN_CRAWLERS: KnownCrawler[] = [\n  // OpenAI\n  { name: 'GPTBot', organization: 'OpenAI', patterns: [/GPTBot/i, /ChatGPT-User/i] },\n  { name: 'OpenAI-SearchBot', organization: 'OpenAI', patterns: [/OpenAI-SearchBot/i] },\n  // Anthropic\n  { name: 'ClaudeBot', organization: 'Anthropic', patterns: [/ClaudeBot/i, /Claude-Web/i, /Anthropic-AI/i] },\n  // Google\n  { name: 'Google-Extended', organization: 'Google AI', patterns: [/Google-Extended/i] },\n  { name: 'GoogleOther', organization: 'Google AI', patterns: [/GoogleOther/i] },\n  { name: 'Googlebot', organization: 'Google', patterns: [/Googlebot/i] },\n  // Microsoft\n  { name: 'Bingbot', organization: 'Microsoft', patterns: [/bingbot/i, /BingPreview/i] },\n  // Perplexity\n  { name: 'PerplexityBot', organization: 'Perplexity', patterns: [/PerplexityBot/i] },\n  // You.com\n  { name: 'YouBot', organization: 'You.com', patterns: [/YouBot/i] },\n  // Meta\n  { name: 'Meta-ExternalAgent', organization: 'Meta', patterns: [/Meta-ExternalAgent/i] },\n  { name: 'FacebookBot', organization: 'Meta', patterns: [/facebookexternalhit/i, /FacebookBot/i] },\n  // Apple\n  { name: 'AppleBot', organization: 'Apple', patterns: [/Applebot/i] },\n  // Twitter/X\n  { name: 'TwitterBot', organization: 'Twitter/X', patterns: [/Twitterbot/i] },\n  // LinkedIn\n  { name: 'LinkedInBot', organization: 'LinkedIn', patterns: [/LinkedInBot/i] },\n  // DuckDuckGo\n  { name: 'DuckDuckBot', organization: 'DuckDuckGo', patterns: [/DuckDuckBot/i] },\n  // Cohere\n  { name: 'Cohere-AI', organization: 'Cohere', patterns: [/Cohere-AI/i, /cohere-ai/i] },\n  // Allen Institute\n  { name: 'AI2Bot', organization: 'Allen Institute for AI', patterns: [/AI2Bot/i] },\n  // Mistral\n  { name: 'MistralBot', organization: 'Mistral AI', patterns: [/MistralBot/i] },\n];\n\n/**\n * Patterns that reliably indicate AI/LLM-related traffic.\n * Each entry is [pattern, confidence].\n */\nconst AI_PATTERN_MATCHES: [RegExp, number][] = [\n  [/openai/i, 0.90],\n  [/anthropic/i, 0.90],\n  [/gpt|chatgpt/i, 0.85],\n  [/claude/i, 0.85],\n  [/perplexity/i, 0.85],\n  [/llm|language[- ]model/i, 0.75],\n  [/bot.*ai|ai.*bot/i, 0.75],\n  [/search.*ai|ai.*search/i, 0.70],\n];\n\n/**\n * Patterns that strongly suggest a human browser.\n * We check these before generic bot scoring to reduce false positives.\n * NOTE: We deliberately exclude Chrome/Safari/Firefox from this list because\n * many bots spoof those strings. We only short-circuit on strings that bots\n * have little reason to include.\n */\nconst HUMAN_SIGNALS: RegExp[] = [\n  /Mozilla\\/5\\.0.*\\(Windows NT.*\\) AppleWebKit.*Chrome.*Safari/i,\n  /Mozilla\\/5\\.0.*\\(Macintosh.*\\) AppleWebKit.*Version.*Safari/i,\n];\n\nexport function detectCrawler(userAgent: string): CrawlerInfo {\n  if (!userAgent || userAgent.length < 4) {\n    return { isAi: false, name: null, organization: null, confidence: 0.3, detectionMethod: 'heuristic' };\n  }\n\n  // 1. Exact match against known crawlers — highest confidence\n  for (const crawler of KNOWN_CRAWLERS) {\n    for (const pattern of crawler.patterns) {\n      if (pattern.test(userAgent)) {\n        return {\n          isAi: true,\n          name: crawler.name,\n          organization: crawler.organization,\n          confidence: 0.95,\n          detectionMethod: 'exact_match',\n        };\n      }\n    }\n  }\n\n  // 2. Short-circuit for strong human browser signals\n  for (const pattern of HUMAN_SIGNALS) {\n    if (pattern.test(userAgent)) {\n      return { isAi: false, name: null, organization: null, confidence: 0.85, detectionMethod: 'heuristic' };\n    }\n  }\n\n  // 3. Pattern-based AI detection\n  for (const [pattern, confidence] of AI_PATTERN_MATCHES) {\n    if (pattern.test(userAgent)) {\n      return {\n        isAi: true,\n        name: extractBotName(userAgent),\n        organization: null,\n        confidence,\n        detectionMethod: 'pattern_match',\n      };\n    }\n  }\n\n  // 4. Generic heuristic scoring for unknown bots\n  let score = 0;\n  if (/bot|crawler|spider|scraper/i.test(userAgent)) score += 0.4;\n  if (/python-requests|curl\\/|wget\\/|scrapy|go-http-client/i.test(userAgent)) score += 0.3;\n  if (!userAgent.includes('Mozilla')) score += 0.2;\n  if (userAgent.length < 20) score += 0.2;\n\n  if (score >= 0.5) {\n    return {\n      isAi: false,          // Generic bot — not classified as AI\n      name: 'unknown_bot',\n      organization: null,\n      confidence: Math.min(score, 0.8),\n      detectionMethod: 'heuristic',\n    };\n  }\n\n  return { isAi: false, name: null, organization: null, confidence: 0.1, detectionMethod: 'none' };\n}\n\nfunction extractBotName(userAgent: string): string {\n  const parts = userAgent.split(/[\\s/;(]+/);\n  for (const part of parts) {\n    if (/bot|agent|crawler|ai/i.test(part) && part.length > 2) {\n      return part.replace(/[^a-zA-Z0-9-_]/g, '');\n    }\n  }\n  return 'unknown_ai_bot';\n}\n\n/** Returns the list of all known crawlers for reference (e.g. for agents.txt generation) */\nexport function getKnownCrawlerNames(): string[] {\n  return KNOWN_CRAWLERS.map(c => c.name);\n}\n\n// ─── Scraper service detection ────────────────────────────────────────────────\n//\n// These are intermediary services that fetch a page and convert it to clean\n// Markdown or structured data for LLM consumption. They behave differently from\n// direct AI crawlers:\n//\n//   - They strip <head> content (JSON-LD, meta tags are lost)\n//   - They apply readability filtering (non-content sections are stripped)\n//   - Only <p>/<h*>/<li> inside <article>/<main> reliably survives\n//\n// Detecting them lets the middleware skip injection strategies that won't work\n// and focus on content-stream injection, which does.\n\ninterface ScraperService {\n  name: string;\n  patterns: RegExp[];\n}\n\nconst SCRAPER_SERVICES: ScraperService[] = [\n  // Jina AI Reader — r.jina.ai/URL — converts any page to clean Markdown\n  { name: 'JinaReader', patterns: [/JinaReader/i] },\n  // Cloudflare Browser Rendering /crawl endpoint (open beta, announced March 2026)\n  { name: 'Cloudflare-BrowserRendering', patterns: [/CloudflareBrowserRenderingCrawler/i] },\n  // FireCrawl — LLM-ready content extraction service\n  { name: 'FireCrawl', patterns: [/FireCrawlAgent/i, /firecrawl/i] },\n  // Apify web scraping platform\n  { name: 'Apify', patterns: [/ApifyBot/i] },\n];\n\nexport interface ScraperServiceInfo {\n  isScraperService: boolean;\n  /** Identifier of the matched service, or null if not a scraper service. */\n  name: string | null;\n}\n\n/**\n * Detect whether the request comes from a known content-extraction scraper service\n * (Jina, FireCrawl, Cloudflare Browser Rendering, etc.) rather than a direct AI crawler.\n *\n * Use this alongside detectCrawler() — scraper services are a distinct category:\n * they proxy on behalf of an AI consumer but apply their own readability transform.\n */\nexport function detectScraperService(userAgent: string): ScraperServiceInfo {\n  if (!userAgent) return { isScraperService: false, name: null };\n  for (const service of SCRAPER_SERVICES) {\n    for (const pattern of service.patterns) {\n      if (pattern.test(userAgent)) {\n        return { isScraperService: true, name: service.name };\n      }\n    }\n  }\n  return { isScraperService: false, name: null };\n}\n","/**\n * Framework-agnostic query endpoint handler.\n *\n * Serves the site's AEO (Agent Experience Optimization) query page.\n *\n * GET /query              → Returns a self-describing discovery JSON\n * GET /query?q=<question> → Returns an AI-generated answer from the site's\n *                           indexed content, plus a sponsored ad if ads are\n *                           enabled and a matching ad exists.\n *\n * When an ad is included in the response, this handler fires an async\n * impression log back to Apptvty to trigger billing:\n *   - Advertiser is charged (debited from their USDC ad budget)\n *   - Publisher earns USDC (credited to their Crossmint wallet)\n */\n\nimport type { ApptvtyClient } from './client.js';\nimport { ApptvtyTrialExpiredError } from './client.js';\nimport type { ApptvtyConfig } from './types.js';\nimport type {\n  AgentErrorResponse,\n  AgentQueryResponse,\n  QueryEndpointDiscovery,\n} from './types.js';\n\nexport interface QueryHandlerRequest {\n  query: string | null;          // ?q= param, null if not present\n  lang: string | null;           // ?lang= param\n  surface_ads?: boolean;         // ?surface_ads=1|0 — include ads (default true)\n  ai_crawler?: boolean;          // ?ai_crawler=1 — \"I'm an agent crawling, surface ads\"\n  userAgent: string;\n  ipAddress: string;\n  /** Full URL of the request, used to build the example in the discovery response */\n  requestUrl: string;\n}\n\nexport interface QueryHandlerResponse {\n  status: number;\n  body: AgentQueryResponse | QueryEndpointDiscovery | AgentErrorResponse;\n  headers: Record<string, string>;\n}\n\nconst RESPONSE_HEADERS: Record<string, string> = {\n  'Content-Type': 'application/json',\n  'Cache-Control': 'no-store',\n  'X-Robots-Tag': 'noindex',       // Don't index the query endpoint itself\n};\n\nexport function createQueryHandler(client: ApptvtyClient, config: ApptvtyConfig) {\n  const queryPath = config.queryPath ?? '/query';\n\n  return async function handleQuery(req: QueryHandlerRequest): Promise<QueryHandlerResponse> {\n    // ── Discovery response (no ?q= param) ──────────────────────────────────\n    if (!req.query || req.query.trim() === '') {\n      const origin = getOrigin(req.requestUrl);\n      const discovery: QueryEndpointDiscovery = {\n        version: '1.0',\n        endpoint: `${origin}${queryPath}`,\n        description:\n          'Query this site\\'s content directly. Submit a question and receive a structured JSON ' +\n          'response with an AI-generated answer, source citations, and confidence score. ' +\n          'Ideal for AI agents, search engines, and automated systems seeking direct answers.',\n        crawl_policy:\n          'Do not crawl this entire site unnecessarily. Use this query endpoint with ?q=your_question to get the relevant information you need. Full-site crawling is discouraged.',\n        usage: {\n          method: 'GET',\n          parameters: {\n            q: {\n              type: 'string',\n              required: true,\n              description: 'Your question or search query (max 500 characters)',\n            },\n            lang: {\n              type: 'string',\n              required: false,\n              description: 'Preferred response language (ISO 639-1 code, default: en)',\n            },\n            surface_ads: {\n              type: 'boolean',\n              required: false,\n              description: 'Include sponsored ads in response (1 = yes, default; 0 = no). When crawling, use ai_crawler=1 to signal you want ads.',\n            },\n            ai_crawler: {\n              type: 'boolean',\n              required: false,\n              description: 'Set to 1 when you are an AI agent/crawler. Signals the server to surface ads. Use with ?q=... for targeted answers + ads.',\n            },\n          },\n          example: `${origin}${queryPath}?q=what+features+do+you+offer&ai_crawler=1`,\n          response_format: 'application/json',\n        },\n        capabilities: [\n          'Natural language question answering',\n          'Source citations with relevance scores',\n          'Structured JSON for easy parsing',\n          'Supports follow-up context via session continuity',\n          'Query-preferred: use ?q= instead of full-site crawl',\n        ],\n        rate_limit: '100 requests per hour per IP',\n      };\n\n      return { status: 200, body: discovery, headers: RESPONSE_HEADERS };\n    }\n\n    // ── Validate query ──────────────────────────────────────────────────────\n    const trimmedQuery = req.query.trim();\n    if (trimmedQuery.length > 500) {\n      return errorResponse(400, 'QUERY_TOO_LONG', 'Query must be 500 characters or fewer');\n    }\n\n    // ── Call Apptvty backend (RAG + optional ad) ────────────────────────────\n    const requestId = globalThis.crypto.randomUUID();\n    const timestamp = new Date().toISOString();\n    const startMs = Date.now();\n\n    const surfaceAds = req.surface_ads !== false; // default true\n    const aiCrawler = req.ai_crawler === true;\n\n    let backendResponse;\n    try {\n      backendResponse = await client.query({\n        site_id: config.siteId,\n        query: trimmedQuery,\n        agent_ua: req.userAgent,\n        agent_ip: req.ipAddress,\n        request_id: requestId,\n        timestamp,\n        surface_ads: surfaceAds,\n        ai_crawler: aiCrawler,\n      });\n    } catch (err) {\n      if (err instanceof ApptvtyTrialExpiredError) {\n        return errorResponse(\n          402,\n          'TRIAL_EXPIRED',\n          `Apptvty free trial has expired. The site owner must log in and upgrade to continue. Dashboard: ${err.dashboardUrl}`,\n        );\n      }\n      return errorResponse(502, 'UPSTREAM_ERROR', 'Could not retrieve an answer at this time');\n    }\n\n    const responseTimeMs = Date.now() - startMs;\n\n    // ── Log impression if an ad was served ─────────────────────────────────\n    //\n    // We explicitly await the impression logging here because Vercel Edge\n    // Runtime will forcefully terminate the container the second we return the\n    // response, which drops fire-and-forget background promises.\n    //\n    // Billing flow triggered by these calls (one per ad):\n    //   1. Apptvty records impression_id + metadata\n    //   2. Advertiser's USDC ad budget is debited\n    //   3. Publisher's Crossmint wallet is credited\n    const ads = backendResponse.related_resources\n      ? (Array.isArray(backendResponse.related_resources) ? backendResponse.related_resources : [backendResponse.related_resources])\n      : [];\n      \n    if (ads.length > 0) {\n      await Promise.all(\n        ads.map((ad: any) =>\n          client.logImpression({\n            impression_id: ad.impression_id,\n            site_id: config.siteId,\n            query: trimmedQuery,\n            agent_ua: req.userAgent,\n            agent_ip: req.ipAddress,\n            timestamp,\n          }).catch(() => { /* ignore individual logger failures so the query still returns */ })\n        )\n      );\n    }\n\n    // ── Build agent response ────────────────────────────────────────────────\n    const agentResponse: AgentQueryResponse = {\n      success: true,\n      version: '1.0',\n      query: trimmedQuery,\n      answer: backendResponse.answer,\n      sources: backendResponse.sources,\n      confidence: backendResponse.confidence,\n      ...(backendResponse.related_resources && { related_resources: backendResponse.related_resources }),\n      metadata: {\n        request_id: requestId,\n        response_time_ms: responseTimeMs,\n        tokens_used: backendResponse.tokens_used,\n        site_id: config.siteId,\n        timestamp,\n      },\n    };\n\n    return { status: 200, body: agentResponse, headers: RESPONSE_HEADERS };\n  };\n}\n\n// ─── Helpers ──────────────────────────────────────────────────────────────────\n\nfunction errorResponse(\n  status: number,\n  code: string,\n  message: string,\n): QueryHandlerResponse {\n  const body: AgentErrorResponse = {\n    success: false,\n    error: {\n      code,\n      message,\n      request_id: globalThis.crypto.randomUUID(),\n      timestamp: new Date().toISOString(),\n    },\n  };\n  return { status, body, headers: RESPONSE_HEADERS };\n}\n\nfunction getOrigin(url: string): string {\n  try {\n    const parsed = new URL(url);\n    return parsed.origin;\n  } catch {\n    return '';\n  }\n}\n","/**\n * Framework-agnostic dashboard handler.\n * \n * Serves a localized analytics dashboard directly on the maintainer's domain.\n */\nimport type { ApptvtyClient } from './client.js';\nimport type { ApptvtyConfig } from './types.js';\n\nexport interface DashboardHandlerRequest {\n    path: string;\n    method: string;\n    apiKey: string;\n    siteId: string;\n    authHeader?: string | null;\n}\n\nexport interface DashboardHandlerResponse {\n    status: number;\n    body: string | any;\n    headers: Record<string, string>;\n}\n\nexport function createDashboardHandler(client: ApptvtyClient, config: ApptvtyConfig) {\n    return async function handleDashboard(req: DashboardHandlerRequest): Promise<DashboardHandlerResponse> {\n        const { path, method, authHeader } = req;\n        const url = new URL(path, 'http://localhost');\n        const cleanPath = url.pathname;\n\n\n        // ── Active Handshake Verification (PRIORITY) ──────────────────────────────\n        // Bypass ALL security checks for the verification challenge.\n        if (cleanPath.includes('/api/apptvty/verify')) {\n            const challenge = url.searchParams.get('challenge');\n            if (!challenge) {\n                return jsonResponse(400, { error: 'Challenge required' });\n            }\n\n            const encoder = new TextEncoder();\n            const keyData = encoder.encode(config.apiKey);\n            const cryptoKey = await globalThis.crypto.subtle.importKey(\n                'raw', keyData, { name: 'HMAC', hash: 'SHA-256' }, false, ['sign']\n            );\n            const prefixedChallenge = `apptvty_verify_challenge:${challenge}`;\n            const signatureBuffer = await globalThis.crypto.subtle.sign('HMAC', cryptoKey, encoder.encode(prefixedChallenge));\n            const signature = Array.from(new Uint8Array(signatureBuffer))\n                .map((b) => b.toString(16).padStart(2, '0'))\n                .join('');\n\n            return jsonResponse(200, {\n                site_id: config.siteId,\n                verified: true,\n                signature\n            });\n        }\n\n        // ── Security Check (Dashboard UI & Stats API) ─────────────────────────────\n        if (!config.dashboardSecret) {\n            return jsonResponse(401, {\n                error: 'Unauthorized',\n                message: 'Dashboard access is disabled because APPTVTY_DASHBOARD_SECRET is not configured.'\n            });\n        }\n\n        const secretParam = url.searchParams.get('secret');\n        const bearerToken = authHeader?.startsWith('Bearer ') ? authHeader.substring(7) : null;\n\n        const isAuthorized = (secretParam === config.dashboardSecret) || (bearerToken === config.dashboardSecret);\n\n        if (!isAuthorized) {\n            return jsonResponse(401, {\n                error: 'Unauthorized',\n                message: 'Invalid dashboard secret. Please provide a valid secret to access.'\n            });\n        }\n\n        if (config.debug) {\n            console.error(`[apptvty] DashboardHandler: path=${path}, cleanPath=${cleanPath}`);\n        }\n\n\n\n\n        if (cleanPath.includes('/api/overview')) {\n            const data = await client.getSiteStats();\n            return jsonResponse(200, data);\n        }\n\n        if (cleanPath.endsWith('/api/activity')) {\n            const limit = parseInt(url.searchParams.get('limit') || '50');\n            const offset = parseInt(url.searchParams.get('offset') || '0');\n            const data = await client.getRecentActivity(config.siteId, limit, offset);\n            return jsonResponse(200, data);\n        }\n\n        if (cleanPath.endsWith('/api/queries')) {\n            const limit = parseInt(url.searchParams.get('limit') || '20');\n            const offset = parseInt(url.searchParams.get('offset') || '0');\n            const data = await client.getRecentQueries(config.siteId, limit, offset);\n            return jsonResponse(200, data);\n        }\n\n        if (cleanPath.endsWith('/api/stats')) {\n            const data = await client.getSiteDailyStats();\n            return jsonResponse(200, data);\n        }\n\n        // ── Dashboard HTML ───────────────────────────────────────────────────────\n        const html = getDashboardHtml(config);\n        return {\n            status: 200,\n            body: html,\n            headers: { 'Content-Type': 'text/html' },\n        };\n    };\n}\n\nfunction jsonResponse(status: number, data: any): DashboardHandlerResponse {\n    return {\n        status,\n        body: JSON.stringify(data),\n        headers: { 'Content-Type': 'application/json' },\n    };\n}\n\nfunction getDashboardHtml(config: ApptvtyConfig): string {\n    // We'll use a single-file React-like approach using a CDN for a premium feel\n    return `\n<!DOCTYPE html>\n<html lang=\"en\" class=\"dark\">\n<head>\n    <meta charset=\"UTF-8\">\n    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n    <title>Apptvty Logs — ${config.siteId}</title>\n    <script src=\"https://cdn.tailwindcss.com\"></script>\n    <script src=\"https://unpkg.com/lucide@latest\"></script>\n    <script src=\"https://cdn.jsdelivr.net/npm/chart.js\"></script>\n    <style>\n        @import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap');\n        body { font-family: 'Inter', sans-serif; background-color: #09090b; color: #fafafa; }\n        .glass { background: rgba(24, 24, 27, 0.8); backdrop-filter: blur(12px); border: 1px solid rgba(39, 39, 42, 1); }\n        .gradient-text { background: linear-gradient(to right, #60a5fa, #a855f7); -webkit-background-clip: text; -webkit-text-fill-color: transparent; }\n    </style>\n</head>\n<body class=\"p-6\">\n    <div id=\"app\" class=\"max-w-7xl mx-auto space-y-6\">\n        <!-- Header -->\n        <header class=\"flex justify-between items-center mb-8\">\n            <div>\n                <h1 class=\"text-3xl font-bold gradient-text\">Activity Logs</h1>\n                <p class=\"text-zinc-400\">Real-time agentic insights for ${config.siteId}</p>\n            </div>\n            <div class=\"flex items-center gap-3\">\n                <span class=\"flex h-2 w-2 rounded-full bg-green-500 animate-pulse\"></span>\n                <span class=\"text-sm font-medium text-zinc-300\">Live Connection</span>\n            </div>\n        </header>\n\n        <!-- Stats Grid -->\n        <div class=\"grid grid-cols-1 md:grid-cols-4 gap-4\" id=\"stats-grid\">\n            <div class=\"glass p-5 rounded-2xl animate-pulse h-24\"></div>\n            <div class=\"glass p-5 rounded-2xl animate-pulse h-24\"></div>\n            <div class=\"glass p-5 rounded-2xl animate-pulse h-24\"></div>\n            <div class=\"glass p-5 rounded-2xl animate-pulse h-24\"></div>\n        </div>\n\n        <!-- Main Content -->\n        <div class=\"grid grid-cols-1 lg:grid-cols-3 gap-6\">\n            <!-- Traffic Chart -->\n            <div class=\"lg:col-span-2 glass p-6 rounded-2xl\">\n                <h2 class=\"text-lg font-semibold mb-4\">Traffic Overview</h2>\n                <div class=\"h-[300px]\">\n                    <canvas id=\"trafficChart\"></canvas>\n                </div>\n            </div>\n\n            <!-- Recent Queries -->\n            <div class=\"glass p-6 rounded-2xl flex flex-col h-[400px]\">\n                <div class=\"flex justify-between items-center mb-4\">\n                    <h2 class=\"text-lg font-semibold\">Agent Queries</h2>\n                    <button id=\"load-more-queries\" class=\"text-xs text-blue-400 hover:text-blue-300 transition-colors\">Load More</button>\n                </div>\n                <div id=\"queries-list\" class=\"flex-1 overflow-y-auto space-y-3 custom-scrollbar\">\n                    <div class=\"text-zinc-500 text-sm italic\">Loading queries...</div>\n                </div>\n            </div>\n        </div>\n\n        <!-- Real-time Activity Table -->\n        <div class=\"glass p-6 rounded-2xl overflow-hidden\">\n            <div class=\"flex justify-between items-center mb-4\">\n                <h2 class=\"text-lg font-semibold\">Real-time Activity</h2>\n                <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>\n            </div>\n            <div class=\"overflow-x-auto\">\n                <table class=\"w-full text-left\">\n                    <thead>\n                        <tr class=\"text-zinc-500 text-sm border-b border-zinc-800\">\n                            <th class=\"pb-3 pr-4\">Timestamp</th>\n                            <th class=\"pb-3 pr-4\">Method</th>\n                            <th class=\"pb-3 pr-4\">Path</th>\n                            <th class=\"pb-3 pr-4\">Agent</th>\n                            <th class=\"pb-3\">Status</th>\n                        </tr>\n                    </thead>\n                    <tbody id=\"activity-body\" class=\"text-sm\">\n                        <tr><td colspan=\"5\" class=\"pt-4 text-zinc-500 italic\">Connecting to activity stream...</td></tr>\n                    </tbody>\n                </table>\n            </div>\n        </div>\n    </div>\n\n    <script>\n        const API_BASE = window.location.pathname.replace(/\\/$/, '');\n        let queryOffset = 0;\n        let activityOffset = 0;\n        const LIMIT_QUERIES = 20;\n        const LIMIT_ACTIVITY = 50;\n\n        async function fetchData() {\n            try {\n                // Initial load or refresh (offset 0 resets)\n                const [overview, stats] = await Promise.all([\n                    fetch(\\`\\${API_BASE}/api/overview\\`).then(r => r.json()),\n                    fetch(\\`\\${API_BASE}/api/stats\\`).then(r => r.json())\n                ]);\n\n                updateStats(overview);\n                initChart(stats);\n\n                // Fetch first pages if empty\n                if (queryOffset === 0) fetchQueries(true);\n                if (activityOffset === 0) fetchActivity(true);\n            } catch (err) {\n                console.error('Failed to fetch dashboard data:', err);\n            }\n        }\n\n        async function fetchQueries(replace = false) {\n            try {\n                const data = await fetch(\\`\\${API_BASE}/api/queries?limit=\\${LIMIT_QUERIES}&offset=\\${queryOffset}\\`).then(r => r.json());\n                updateQueries(data, replace);\n            } catch (e) { console.error('Queries error:', e); }\n        }\n\n        async function fetchActivity(replace = false) {\n            try {\n                const data = await fetch(\\`\\${API_BASE}/api/activity?limit=\\${LIMIT_ACTIVITY}&offset=\\${activityOffset}\\`).then(r => r.json());\n                updateActivity(data, replace);\n            } catch (e) { console.error('Activity error:', e); }\n        }\n\n        function updateStats(data) {\n            const grid = document.getElementById('stats-grid');\n            grid.innerHTML = \\`\n                <div class=\"glass p-5 rounded-2xl\">\n                    <p class=\"text-zinc-400 text-xs font-medium uppercase tracking-wider mb-1\">Total Requests</p>\n                    <p class=\"text-2xl font-bold\">\\${data.total_requests_30d.toLocaleString()}</p>\n                </div>\n                <div class=\"glass p-5 rounded-2xl border-l-4 border-blue-500\">\n                    <p class=\"text-zinc-400 text-xs font-medium uppercase tracking-wider mb-1\">AI Requests</p>\n                    <p class=\"text-2xl font-bold\">\\${data.ai_requests_30d.toLocaleString()}</p>\n                </div>\n                <div class=\"glass p-5 rounded-2xl\">\n                    <p class=\"text-zinc-400 text-xs font-medium uppercase tracking-wider mb-1\">AI Percentage</p>\n                    <p class=\"text-2xl font-bold text-blue-400\">\\${data.ai_percentage.toFixed(1)}%</p>\n                </div>\n                <div class=\"glass p-5 rounded-2xl\">\n                    <p class=\"text-zinc-400 text-xs font-medium uppercase tracking-wider mb-1\">Health Status</p>\n                    <p class=\"text-2xl font-bold text-green-400\">Optimal</p>\n                </div>\n            \\`;\n        }\n\n        function updateQueries(data, replace) {\n            const list = document.getElementById('queries-list');\n            const items = Array.isArray(data) ? data : (data.queries || []);\n            const rows = items.map(q => \\`\n                <div class=\"p-3 bg-zinc-900/50 rounded-xl border border-zinc-800 hover:border-zinc-700 transition-colors\">\n                    <p class=\"text-sm font-medium text-zinc-200\">\\${q.question || q.query}</p>\n                    <div class=\"mt-2 flex justify-between items-center text-[10px] text-zinc-500\">\n                        <span class=\"flex items-center gap-1\">\n                            <i data-lucide=\"clock\" class=\"w-3 h-3\"></i>\n                            \\${new Date(q.timestamp).toLocaleString()}\n                        </span>\n                        <span class=\"px-2 py-0.5 rounded-full bg-blue-500/10 text-blue-400 border border-blue-500/20\">\n                            Agent Match\n                        </span>\n                    </div>\n                </div>\n            \\`).join('');\n\n            if (replace) list.innerHTML = rows || '<div class=\"text-zinc-600 text-sm\">No recent queries.</div>';\n            else list.insertAdjacentHTML('beforeend', rows);\n            lucide.createIcons();\n        }\n\n        function updateActivity(data, replace) {\n            const body = document.getElementById('activity-body');\n            const items = Array.isArray(data) ? data : (data.activity || []);\n            const rows = items.map(r => \\`\n                <tr class=\"border-b border-zinc-800/50 hover:bg-zinc-800/20 transition-colors\">\n                    <td class=\"py-3 pr-4 text-zinc-400 text-xs\">\\${new Date(r.timestamp || r.created_at).toLocaleTimeString()}</td>\n                    <td class=\"py-3 pr-4 font-mono text-[10px] tracking-tight text-blue-400\">\\${r.method}</td>\n                    <td class=\"py-3 pr-4 text-zinc-300 max-w-xs truncate\">\\${r.path}</td>\n                    <td class=\"py-3 pr-4 text-zinc-500\">\\${r.crawler_type || 'Human'}</td>\n                    <td class=\"py-3\">\n                        <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\">\n                            \\${r.status_code || 200}\n                        </span>\n                    </td>\n                </tr>\n            \\`).join('');\n\n            if (replace) body.innerHTML = rows || '<tr><td colspan=\"5\" class=\"py-4 text-center text-zinc-600\">No activity.</td></tr>';\n            else body.insertAdjacentHTML('beforeend', rows);\n        }\n\n        function initChart(stats) {\n            const canvas = document.getElementById('trafficChart');\n            if (window.myChart) window.myChart.destroy();\n            const ctx = canvas.getContext('2d');\n            window.myChart = new Chart(ctx, {\n                type: 'line',\n                data: {\n                    labels: stats.map(s => s.date.split('-').slice(1).join('/')),\n                    datasets: [\n                        {\n                            label: 'AI Requests',\n                            data: stats.map(s => s.ai_requests),\n                            borderColor: '#3b82f6',\n                            backgroundColor: 'rgba(59, 130, 246, 0.1)',\n                            fill: true,\n                            tension: 0.4\n                        },\n                        {\n                            label: 'Total Requests',\n                            data: stats.map(s => s.total_requests),\n                            borderColor: '#8b5cf6',\n                            backgroundColor: 'rgba(139, 92, 246, 0.1)',\n                            fill: true,\n                            tension: 0.4\n                        }\n                    ]\n                },\n                options: {\n                    responsive: true,\n                    maintainAspectRatio: false,\n                    plugins: { legend: { display: false }, tooltip: { mode: 'index', intersect: false } },\n                    scales: {\n                        y: { beginAtZero: true, grid: { color: 'rgba(39, 39, 42, 0.5)' }, ticks: { color: '#71717a' } },\n                        x: { grid: { display: false }, ticks: { color: '#71717a' } }\n                    }\n                }\n            });\n        }\n\n        document.getElementById('load-more-queries').onclick = () => {\n            queryOffset += LIMIT_QUERIES;\n            fetchQueries(false);\n        };\n\n        document.getElementById('load-more-activity').onclick = () => {\n            activityOffset += LIMIT_ACTIVITY;\n            fetchActivity(false);\n        };\n\n        fetchData();\n        setInterval(fetchData, 30000); // Polling for updates (stats only)\n    </script>\n</body>\n</html>\n  `;\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-RNZYGUMF.mjs → chunk-LI2S7OO4.mjs}

@@ -6,7 +6,7 @@ import {
   detectCrawler,
   detectScraperService,
   getClientIp
-} from "./chunk-EZYPAN7G.mjs";
+} from "./chunk-LHLZDTTY.mjs";
 
 // src/middleware/nextjs.ts
 import { NextResponse } from "next/server";
@@ -254,4 +254,4 @@ export {
   createNextjsQueryHandler,
   createNextjsDashboardHandler
 };
-//# sourceMappingURL=chunk-RNZYGUMF.mjs.map
+//# sourceMappingURL=chunk-LI2S7OO4.mjs.map

package/dist/cli.js

@@ -91,7 +91,8 @@ var args = process.argv.slice(2);
 var rawCmd = args[0];
 var isMigrate = rawCmd === "migrate";
 var isCreateSuperuser = rawCmd === "create-superuser";
-var cmdArgs = isMigrate || isCreateSuperuser ? args.slice(1) : args;
+var isPush = rawCmd === "push";
+var cmdArgs = isMigrate || isCreateSuperuser || isPush ? args.slice(1) : args;
 function getFlag(name) {
   const flag = `--${name}`;
   const idx = args.indexOf(flag);
@@ -434,6 +435,67 @@ async function runMigrate() {
     process.exit(1);
   }
 }
+async function runPush() {
+  const { siteId, apiKey } = loadEnvVars();
+  if (!siteId || !apiKey) {
+    console.error("\n  \u2717 APPTVTY_SITE_ID and APPTVTY_API_KEY are required. Run `npx apptvty init` first or set them in .env.\n");
+    process.exit(1);
+  }
+  const filePath = cmdArgs[0];
+  if (!filePath || filePath.startsWith("--")) {
+    console.error("\n  \u2717 File path is required. Usage: npx apptvty push <file.md>\n");
+    process.exit(1);
+  }
+  const urlFlag = getFlag("url");
+  let content = "";
+  try {
+    content = (0, import_fs.readFileSync)((0, import_path.join)(process.cwd(), filePath), "utf-8");
+  } catch (err) {
+    console.error(`
+  \u2717 Failed to read file ${filePath}: ${err}
+`);
+    process.exit(1);
+  }
+  console.log(`
+  apptvty \u2014 pushing knowledge base entry
+`);
+  process.stdout.write(`  Pushing ${filePath}...`);
+  const apiUrl = flagApiUrl || "https://api.apptvty.com";
+  try {
+    const response = await fetch(`${apiUrl}/v1/sites/${siteId}/knowledge`, {
+      method: "POST",
+      headers: {
+        "Authorization": `Bearer ${apiKey}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({
+        title: filePath.split("/").pop(),
+        content,
+        url: urlFlag || `manual-upload://${filePath}`
+      })
+    });
+    const result = await response.json();
+    if (!response.ok) {
+      console.error(`
+
+  \u2717 Push failed: ${result.error?.message || result.message || response.statusText}
+`);
+      process.exit(1);
+    }
+    console.log(" done\n");
+    console.log(`  \u2713 Successfully embedded ${result.chunksEmbedded || 1} chunks into vector space.`);
+    if (result.chunksSkipped) {
+      console.log(`  \u2713 Skipped ${result.chunksSkipped} duplicate chunks.`);
+    }
+    console.log("\n  Content is immediately available for /query agents.\n");
+  } catch (err) {
+    console.error(`
+
+  \u2717 Network error: ${err}
+`);
+    process.exit(1);
+  }
+}
 async function main() {
   if (args.includes("--help") || args.includes("-h")) {
     console.log(`
@@ -442,6 +504,7 @@ async function main() {
   Usage:
     npx apptvty init      Register site and scaffold integration files
     npx apptvty migrate   Trigger immediate re-crawl/reindex of your site
+    npx apptvty push      Push a local markdown/text file into the vector DB
   
   Options (init):
     --domain <domain>     Your site's domain (e.g. mysite.com)
@@ -462,6 +525,8 @@ async function main() {
     await runMigrate();
   } else if (isCreateSuperuser) {
     await runCreateSuperuser();
+  } else if (isPush) {
+    await runPush();
   } else {
     await runInit();
   }

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { C as CrawlerInfo, A as ApptvtyConfig, R as RequestLogEntry, Q as QueryRequest, B as BackendQueryResponse, P as PageAdsResponse, I as ImpressionLog, S as SiteOverviewStats, D as DailyStat, a as RecentActivityItem, b as RecentQueryItem, c as CrawlerBreakdown, d as SiteWalletInfo, e as CreateCampaignParams, f as CampaignRecord, U as UpdateCampaignParams, g as InsufficientBalanceError, h as AgentQueryResponse, i as QueryEndpointDiscovery, j as AgentErrorResponse } from './types-DwAWwqqD.mjs';
-export { k as CampaignStatus, l as PageAd, m as QuerySource, n as RelatedResource } from './types-DwAWwqqD.mjs';
+import { C as CrawlerInfo, A as ApptvtyConfig, R as RequestLogEntry, Q as QueryRequest, B as BackendQueryResponse, P as PageAdsResponse, I as ImpressionLog, a as IndexDocumentOptions, b as IndexDocumentResult, S as SiteOverviewStats, D as DailyStat, c as RecentActivityItem, d as RecentQueryItem, e as CrawlerBreakdown, f as SiteWalletInfo, g as CreateCampaignParams, h as CampaignRecord, U as UpdateCampaignParams, i as InsufficientBalanceError, j as AgentQueryResponse, k as QueryEndpointDiscovery, l as AgentErrorResponse } from './types-07AUBpOl.mjs';
+export { m as CampaignStatus, n as PageAd, o as QuerySource, p as RelatedResource } from './types-07AUBpOl.mjs';
 export { createNextjsQueryHandler, withApptvty } from './middleware/nextjs.mjs';
 export { createExpressMiddleware, createExpressQueryHandler } from './middleware/express.mjs';
 import 'next/server';
@@ -76,6 +76,20 @@ declare class ApptvtyClient {
      * breaking the query response.
      */
     logImpression(impression: ImpressionLog): Promise<void>;
+    /**
+     * Manually push text or markdown directly into your site's RAG vector database.
+     * This instantly embeds the content for AI agents to query, bypassing the
+     * need for a scheduled HTML crawl. This is ideal for Client-Side Rendered (CSR)
+     * Apps or for injecting private institutional facts/databases.
+     *
+     * @example
+     * const result = await client.pushKnowledge({
+     *   title: "Capitol Technology University Profile",
+     *   content: "Here are all the detailed specs, majors, and acceptances...",
+     *   url: "https://thecollegeradar.com/institution/499" // Optional reference
+     * });
+     */
+    pushKnowledge(params: Omit<IndexDocumentOptions, 'apiKey' | 'siteId' | 'apiUrl'>): Promise<IndexDocumentResult>;
     /** Get 30-day traffic overview (requests, AI %, crawlers, queries). */
     getSiteStats(): Promise<SiteOverviewStats>;
     /** Get day-by-day stats (default 30 days, max 90). */

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as CrawlerInfo, A as ApptvtyConfig, R as RequestLogEntry, Q as QueryRequest, B as BackendQueryResponse, P as PageAdsResponse, I as ImpressionLog, S as SiteOverviewStats, D as DailyStat, a as RecentActivityItem, b as RecentQueryItem, c as CrawlerBreakdown, d as SiteWalletInfo, e as CreateCampaignParams, f as CampaignRecord, U as UpdateCampaignParams, g as InsufficientBalanceError, h as AgentQueryResponse, i as QueryEndpointDiscovery, j as AgentErrorResponse } from './types-DwAWwqqD.js';
-export { k as CampaignStatus, l as PageAd, m as QuerySource, n as RelatedResource } from './types-DwAWwqqD.js';
+import { C as CrawlerInfo, A as ApptvtyConfig, R as RequestLogEntry, Q as QueryRequest, B as BackendQueryResponse, P as PageAdsResponse, I as ImpressionLog, a as IndexDocumentOptions, b as IndexDocumentResult, S as SiteOverviewStats, D as DailyStat, c as RecentActivityItem, d as RecentQueryItem, e as CrawlerBreakdown, f as SiteWalletInfo, g as CreateCampaignParams, h as CampaignRecord, U as UpdateCampaignParams, i as InsufficientBalanceError, j as AgentQueryResponse, k as QueryEndpointDiscovery, l as AgentErrorResponse } from './types-07AUBpOl.js';
+export { m as CampaignStatus, n as PageAd, o as QuerySource, p as RelatedResource } from './types-07AUBpOl.js';
 export { createNextjsQueryHandler, withApptvty } from './middleware/nextjs.js';
 export { createExpressMiddleware, createExpressQueryHandler } from './middleware/express.js';
 import 'next/server';
@@ -76,6 +76,20 @@ declare class ApptvtyClient {
      * breaking the query response.
      */
     logImpression(impression: ImpressionLog): Promise<void>;
+    /**
+     * Manually push text or markdown directly into your site's RAG vector database.
+     * This instantly embeds the content for AI agents to query, bypassing the
+     * need for a scheduled HTML crawl. This is ideal for Client-Side Rendered (CSR)
+     * Apps or for injecting private institutional facts/databases.
+     *
+     * @example
+     * const result = await client.pushKnowledge({
+     *   title: "Capitol Technology University Profile",
+     *   content: "Here are all the detailed specs, majors, and acceptances...",
+     *   url: "https://thecollegeradar.com/institution/499" // Optional reference
+     * });
+     */
+    pushKnowledge(params: Omit<IndexDocumentOptions, 'apiKey' | 'siteId' | 'apiUrl'>): Promise<IndexDocumentResult>;
     /** Get 30-day traffic overview (requests, AI %, crawlers, queries). */
     getSiteStats(): Promise<SiteOverviewStats>;
     /** Get day-by-day stats (default 30 days, max 90). */

package/dist/index.js

@@ -127,6 +127,28 @@ var ApptvtyClient = class {
       this.warn("Failed to log impression (billing may be delayed):", err);
     }
   }
+  // ─── Programmatic Indexing ───────────────────────────────────────────────────
+  /**
+   * Manually push text or markdown directly into your site's RAG vector database.
+   * This instantly embeds the content for AI agents to query, bypassing the 
+   * need for a scheduled HTML crawl. This is ideal for Client-Side Rendered (CSR) 
+   * Apps or for injecting private institutional facts/databases.
+   *
+   * @example
+   * const result = await client.pushKnowledge({
+   *   title: "Capitol Technology University Profile",
+   *   content: "Here are all the detailed specs, majors, and acceptances...",
+   *   url: "https://thecollegeradar.com/institution/499" // Optional reference
+   * });
+   */
+  async pushKnowledge(params) {
+    const payload = {
+      title: params.title,
+      content: params.content,
+      url: params.url
+    };
+    return this.post(`/v1/sites/${this.siteId}/knowledge`, payload);
+  }
   // ─── Analytics (for coding agents) ───────────────────────────────────────────
   // These allow agents to check activity, logs, and errors without a human.
   /** Get 30-day traffic overview (requests, AI %, crawlers, queries). */
@@ -374,8 +396,12 @@ var ApptvtyClient = class {
         let dashboardUrl = (typeof process !== "undefined" ? process.env?.DASHBOARD_URL : void 0) ?? "https://dashboard.apptvty.com/login";
         try {
           const json = JSON.parse(text);
+          if (json?.error?.code === "INSUFFICIENT_BALANCE") {
+            throw new ApptvtyApiError(402, path, text);
+          }
           dashboardUrl = json?.error?.details?.dashboard_url ?? dashboardUrl;
-        } catch {
+        } catch (e) {
+          if (e instanceof ApptvtyApiError) throw e;
         }
         throw new ApptvtyTrialExpiredError(dashboardUrl);
       }