apptvty 0.1.4 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (37) hide show
  1. package/README.md +37 -17
  2. package/dist/chunk-2KXDQCUZ.mjs +177 -0
  3. package/dist/chunk-2KXDQCUZ.mjs.map +1 -0
  4. package/dist/{chunk-XOWRKLFM.mjs → chunk-454YBHM2.mjs} +62 -34
  5. package/dist/chunk-454YBHM2.mjs.map +1 -0
  6. package/dist/chunk-OTPVLSG5.mjs +1084 -0
  7. package/dist/chunk-OTPVLSG5.mjs.map +1 -0
  8. package/dist/cli.js +75 -16
  9. package/dist/index.d.mts +138 -20
  10. package/dist/index.d.ts +138 -20
  11. package/dist/index.js +403 -45
  12. package/dist/index.js.map +1 -1
  13. package/dist/index.mjs +7 -3
  14. package/dist/middleware/express.d.mts +24 -5
  15. package/dist/middleware/express.d.ts +24 -5
  16. package/dist/middleware/express.js +676 -14
  17. package/dist/middleware/express.js.map +1 -1
  18. package/dist/middleware/express.mjs +4 -2
  19. package/dist/middleware/nextjs.d.mts +29 -6
  20. package/dist/middleware/nextjs.d.ts +29 -6
  21. package/dist/middleware/nextjs.js +641 -40
  22. package/dist/middleware/nextjs.js.map +1 -1
  23. package/dist/middleware/nextjs.mjs +4 -2
  24. package/dist/setup.d.mts +9 -0
  25. package/dist/setup.d.ts +9 -0
  26. package/dist/setup.js +6 -2
  27. package/dist/setup.js.map +1 -1
  28. package/dist/setup.mjs +6 -2
  29. package/dist/setup.mjs.map +1 -1
  30. package/dist/{types-C1oUTCsT.d.mts → types-D2A_0sPm.d.mts} +116 -2
  31. package/dist/{types-C1oUTCsT.d.ts → types-D2A_0sPm.d.ts} +116 -2
  32. package/package.json +1 -1
  33. package/dist/chunk-RGUS6IL6.mjs +0 -87
  34. package/dist/chunk-RGUS6IL6.mjs.map +0 -1
  35. package/dist/chunk-WATTAPBA.mjs +0 -502
  36. package/dist/chunk-WATTAPBA.mjs.map +0 -1
  37. package/dist/chunk-XOWRKLFM.mjs.map +0 -1
package/README.md CHANGED
@@ -259,6 +259,21 @@ The `sponsored` field is present only when ads are enabled for your site and a m
259
259
  }
260
260
  ```
261
261
 
262
+ ---
263
+
264
+ ## Advertiser funding (X402)
265
+ If you are an agent or company paying for ads, Apptvty supports autonomous pre-paid credits via USDC on Base.
266
+
267
+ 1. **Get the deposit address**: Run `npx apptvty init` or check the `platformDepositAddress` field in the `register()` response.
268
+ 2. **Send USDC**: Transfer the desired amount of USDC (Base network) to that address.
269
+ 3. **Sync your balance**: Call the wallet sync endpoint with your transaction hash:
270
+ ```bash
271
+ curl "https://api.apptvty.com/v1/wallet/sync?tx_hash=0x..."
272
+ ```
273
+ *Note: On-chain verification takes ~30-60 seconds.*
274
+
275
+ ---
276
+
262
277
  Response headers always include:
263
278
  - `Content-Type: application/json`
264
279
  - `Cache-Control: no-store`
@@ -278,25 +293,12 @@ const client = new ApptvtyClient({
278
293
  siteId: process.env.APPTVTY_SITE_ID!,
279
294
  });
280
295
 
281
- // 30-day overview
282
- const stats = await client.getSiteStats();
283
- console.log(`AI traffic: ${stats.ai_percentage}%`);
284
-
285
- // Recent activity (last hour)
286
- const { activity } = await client.getSiteActivity(20);
287
- activity.forEach(a => console.log(a.path, a.crawler_type, a.status_code));
288
-
289
- // Recent agent queries
290
- const { queries } = await client.getSiteQueries(10);
291
-
292
- // Crawler breakdown
293
- const { crawlers } = await client.getSiteCrawlers(7);
294
-
295
- // Daily stats
296
- const { stats: daily } = await client.getSiteDailyStats(30);
297
-
298
296
  // Wallet balance
299
297
  const wallet = await client.getSiteWallet();
298
+
299
+ // Ad Campaign Insights (for advertisers)
300
+ const insights = await client.getCampaignInsights('camp_123');
301
+ console.log(`Top site: ${insights.top_publishers[0].domain}`);
300
302
  ```
301
303
 
302
304
  | Method | Returns |
@@ -307,6 +309,24 @@ const wallet = await client.getSiteWallet();
307
309
  | `getSiteQueries(limit?)` | Recent agent queries |
308
310
  | `getSiteCrawlers(days?)` | Crawler type breakdown |
309
311
  | `getSiteWallet()` | Balance, earnings, spend |
312
+ | `getCampaignInsights(id)` | Ad performance (impressions per site, daily spend) |
313
+
314
+ ---
315
+
316
+ ## Local logs dashboard
317
+ Deploy a localized analytics portal on your own domain using the framework-agnostic dashboard handler.
318
+
319
+ ### Next.js (App Router)
320
+ ```typescript
321
+ // app/api/apptvty/logs/route.ts
322
+ import { createNextjsDashboardHandler } from 'apptvty/nextjs';
323
+
324
+ export const GET = createNextjsDashboardHandler({
325
+ apiKey: process.env.APPTVTY_API_KEY!,
326
+ siteId: process.env.APPTVTY_SITE_ID!,
327
+ });
328
+ ```
329
+ Your dashboard is now available at `https://yoursite.com/api/apptvty/logs`.
310
330
 
311
331
  ---
312
332
 
@@ -0,0 +1,177 @@
1
+ import {
2
+ AD_INJECTION_MARKER,
3
+ ApptvtyClient,
4
+ RequestLogger,
5
+ buildSponsoredHeader,
6
+ createDashboardHandler,
7
+ createQueryHandler,
8
+ detectCrawler,
9
+ detectScraperService,
10
+ getClientIp,
11
+ injectIntoHtml
12
+ } from "./chunk-OTPVLSG5.mjs";
13
+
14
+ // src/middleware/express.ts
15
+ var instances = /* @__PURE__ */ new Map();
16
+ function getInstance(config) {
17
+ const key = config.apiKey;
18
+ if (!instances.has(key)) {
19
+ const client = new ApptvtyClient(config);
20
+ const logger = new RequestLogger(client, config);
21
+ instances.set(key, { client, logger });
22
+ }
23
+ return instances.get(key);
24
+ }
25
+ function createExpressMiddleware(config) {
26
+ const { client, logger } = getInstance(config);
27
+ return function apptvtyMiddleware(req, res, next) {
28
+ const startMs = Date.now();
29
+ const userAgent = req.headers["user-agent"] ?? "";
30
+ const crawlerInfo = detectCrawler(userAgent);
31
+ const scraperService = detectScraperService(userAgent);
32
+ const path = req.url ?? "/";
33
+ const isCrawler = crawlerInfo.isAi || scraperService.isScraperService;
34
+ const ipAddress = getClientIp(req.headers);
35
+ const adsPromise = isCrawler && !shouldSkip(path) ? client.getAdsForPage({ site_id: config.siteId, page_path: path }).catch(() => ({ ads: [] })) : Promise.resolve({ ads: [] });
36
+ if (isCrawler && !shouldSkip(path)) {
37
+ const chunks = [];
38
+ const originalWrite = res.write.bind(res);
39
+ const originalEnd = res.end.bind(res);
40
+ res.write = function(chunk, encodingOrCallback, callback) {
41
+ if (chunk != null) {
42
+ chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
43
+ }
44
+ if (typeof encodingOrCallback === "function") encodingOrCallback();
45
+ else if (typeof callback === "function") callback();
46
+ return true;
47
+ };
48
+ res.end = function(chunk, encodingOrCallback, callback) {
49
+ if (chunk != null) {
50
+ chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
51
+ }
52
+ const contentType = res.getHeader("content-type") ?? "";
53
+ const isHtml = contentType.includes("text/html");
54
+ if (!isHtml || chunks.length === 0) {
55
+ res.write = originalWrite;
56
+ res.end = originalEnd;
57
+ return originalEnd(Buffer.concat(chunks), encodingOrCallback, callback);
58
+ }
59
+ const html = Buffer.concat(chunks).toString("utf-8");
60
+ if (html.includes(AD_INJECTION_MARKER)) {
61
+ res.write = originalWrite;
62
+ res.end = originalEnd;
63
+ return originalEnd(html, encodingOrCallback, callback);
64
+ }
65
+ adsPromise.then((pageAds) => {
66
+ res.write = originalWrite;
67
+ res.end = originalEnd;
68
+ if (!pageAds.ads || pageAds.ads.length === 0) {
69
+ originalEnd(html, encodingOrCallback, callback);
70
+ return;
71
+ }
72
+ const modified = injectIntoHtml(html, pageAds.ads, scraperService.isScraperService);
73
+ res.setHeader("X-Sponsored-Content", buildSponsoredHeader(pageAds.ads));
74
+ const buf = Buffer.from(modified, "utf-8");
75
+ res.setHeader("Content-Length", buf.length);
76
+ const timestamp = (/* @__PURE__ */ new Date()).toISOString();
77
+ for (const ad of pageAds.ads) {
78
+ client.logImpression({
79
+ impression_id: ad.impression_id,
80
+ site_id: config.siteId,
81
+ page_path: path,
82
+ agent_ua: userAgent,
83
+ agent_ip: ipAddress,
84
+ timestamp
85
+ }).catch(() => {
86
+ });
87
+ }
88
+ originalEnd(buf, encodingOrCallback, callback);
89
+ }).catch(() => {
90
+ res.write = originalWrite;
91
+ res.end = originalEnd;
92
+ originalEnd(html, encodingOrCallback, callback);
93
+ });
94
+ return res;
95
+ };
96
+ }
97
+ res.on("finish", () => {
98
+ if (shouldSkip(path)) return;
99
+ const entry = {
100
+ site_id: config.siteId,
101
+ timestamp: (/* @__PURE__ */ new Date()).toISOString(),
102
+ method: req.method ?? "GET",
103
+ path,
104
+ status_code: res.statusCode,
105
+ response_time_ms: Date.now() - startMs,
106
+ ip_address: ipAddress,
107
+ user_agent: userAgent,
108
+ referer: req.headers["referer"] ?? null,
109
+ is_ai_crawler: crawlerInfo.isAi,
110
+ crawler_type: crawlerInfo.name,
111
+ crawler_organization: crawlerInfo.organization,
112
+ confidence_score: crawlerInfo.confidence,
113
+ scraper_service: scraperService.name
114
+ };
115
+ logger.enqueue(entry);
116
+ });
117
+ next();
118
+ };
119
+ }
120
+ function createExpressQueryHandler(config) {
121
+ const { client } = getInstance(config);
122
+ const handleQuery = createQueryHandler(client, config);
123
+ return async function queryHandler(req, res) {
124
+ const url = new URL(req.url ?? "/", `http://${req.headers.host ?? "localhost"}`);
125
+ const q = url.searchParams.get("q");
126
+ const lang = url.searchParams.get("lang");
127
+ const surfaceAds = parseBoolParam(url.searchParams.get("surface_ads"), true);
128
+ const aiCrawler = parseBoolParam(url.searchParams.get("ai_crawler"), false);
129
+ const userAgent = req.headers["user-agent"] ?? "";
130
+ const result = await handleQuery({
131
+ query: q,
132
+ lang,
133
+ surface_ads: surfaceAds,
134
+ ai_crawler: aiCrawler,
135
+ userAgent,
136
+ ipAddress: getClientIp(req.headers),
137
+ requestUrl: url.toString()
138
+ });
139
+ for (const [key, value] of Object.entries(result.headers)) {
140
+ res.setHeader(key, value);
141
+ }
142
+ res.statusCode = result.status;
143
+ res.end(JSON.stringify(result.body));
144
+ };
145
+ }
146
+ function createExpressDashboardHandler(config) {
147
+ const { client } = getInstance(config);
148
+ const handleDashboard = createDashboardHandler(client, config);
149
+ return async function dashboardHandler(req, res) {
150
+ const url = new URL(req.url ?? "/", `http://${req.headers.host ?? "localhost"}`);
151
+ const result = await handleDashboard({
152
+ path: url.pathname + url.search,
153
+ method: req.method ?? "GET",
154
+ apiKey: config.apiKey,
155
+ siteId: config.siteId
156
+ });
157
+ for (const [key, value] of Object.entries(result.headers)) {
158
+ res.setHeader(key, value);
159
+ }
160
+ res.statusCode = result.status;
161
+ res.end(result.body);
162
+ };
163
+ }
164
+ function parseBoolParam(value, defaultValue) {
165
+ if (value === null) return defaultValue;
166
+ return value === "1" || value === "true" || value === "yes";
167
+ }
168
+ function shouldSkip(path) {
169
+ return path.startsWith("/_next/") || /\.(svg|png|jpg|jpeg|gif|webp|ico|woff2?|ttf|css|js\.map)$/.test(path);
170
+ }
171
+
172
+ export {
173
+ createExpressMiddleware,
174
+ createExpressQueryHandler,
175
+ createExpressDashboardHandler
176
+ };
177
+ //# sourceMappingURL=chunk-2KXDQCUZ.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/middleware/express.ts"],"sourcesContent":["/**\n * Express / Node.js integration for the Apptvty SDK.\n *\n * Usage:\n *\n * import express from 'express';\n * import { createExpressMiddleware, createExpressQueryHandler } from 'apptvty/express';\n *\n * const app = express();\n * const config = { apiKey: 'ak_...', siteId: 'site_...' };\n *\n * // 1. Log all traffic + inject ads into AI crawler responses\n * app.use(createExpressMiddleware(config));\n *\n * // 2. Mount the AEO query page\n * app.get('/query', createExpressQueryHandler(config));\n *\n * Works with any Connect-compatible framework (Express, Fastify via @fastify/express, etc.)\n *\n * Ad injection strategy:\n * When an AI crawler or scraper service is detected, the middleware buffers the\n * response body and injects sponsored content using the same three-layer strategy\n * as the Next.js integration. An ad fetch runs in parallel with the app's own\n * request processing, so the latency overhead is the difference between the ad\n * fetch time and the app's own response time — typically near zero.\n */\n\nimport type { IncomingMessage, ServerResponse } from 'node:http';\nimport { ApptvtyClient } from '../client.js';\nimport { detectCrawler, detectScraperService } from '../crawler.js';\nimport { RequestLogger, getClientIp } from '../logger.js';\nimport { createQueryHandler } from '../query-handler.js';\nimport { createDashboardHandler } from '../dashboard-handler.js';\nimport { injectIntoHtml, buildSponsoredHeader, AD_INJECTION_MARKER } from '../ad-injection.js';\nimport type { ApptvtyConfig, PageAdsResponse, RequestLogEntry } from '../types.js';\n\nexport type ConnectMiddleware = (\n req: IncomingMessage,\n res: ServerResponse,\n next: (err?: unknown) => void,\n) => void;\n\nexport type ConnectHandler = (\n req: IncomingMessage,\n res: ServerResponse,\n) => void | Promise<void>;\n\n// ─── Shared singleton instances per config ────────────────────────────────────\n\nconst instances = new Map<string, { client: ApptvtyClient; logger: RequestLogger }>();\n\nfunction getInstance(config: ApptvtyConfig) {\n const key = config.apiKey;\n if (!instances.has(key)) {\n const client = new ApptvtyClient(config);\n const logger = new RequestLogger(client, config);\n instances.set(key, { client, logger });\n }\n return instances.get(key)!;\n}\n\n// ─── Traffic logging + ad injection middleware ────────────────────────────────\n\n/**\n * Express middleware that:\n * 1. Logs every request to Apptvty (all traffic, batched).\n * 2. For AI crawler and scraper service requests on HTML pages: buffers the\n * response, fetches matching ads in parallel, and injects sponsored content\n * using the three-layer strategy (content-stream, JSON-LD, response header).\n *\n * Mount this before your routes so all traffic is captured.\n *\n * @example\n * app.use(createExpressMiddleware({ apiKey: 'ak_...', siteId: 'site_...' }));\n */\nexport function createExpressMiddleware(config: ApptvtyConfig): ConnectMiddleware {\n const { client, logger } = getInstance(config);\n\n return function apptvtyMiddleware(req, res, next) {\n const startMs = Date.now();\n const userAgent = req.headers['user-agent'] ?? '';\n const crawlerInfo = detectCrawler(userAgent);\n const scraperService = detectScraperService(userAgent);\n const path = req.url ?? '/';\n const isCrawler = crawlerInfo.isAi || scraperService.isScraperService;\n const ipAddress = getClientIp(req.headers as Record<string, string | string[] | undefined>);\n\n // Start ad fetch in parallel with the app's request processing.\n // By the time res.end() is called, the fetch is usually already resolved.\n const adsPromise: Promise<PageAdsResponse> =\n isCrawler && !shouldSkip(path)\n ? client\n .getAdsForPage({ site_id: config.siteId, page_path: path })\n .catch(() => ({ ads: [] }))\n : Promise.resolve({ ads: [] });\n\n // Buffer the response body for AI/scraper traffic so we can inject ads.\n if (isCrawler && !shouldSkip(path)) {\n const chunks: Buffer[] = [];\n const originalWrite = res.write.bind(res) as typeof res.write;\n const originalEnd = res.end.bind(res) as typeof res.end;\n\n // Collect response body chunks without sending them yet.\n (res as any).write = function (\n chunk: string | Buffer | Uint8Array,\n encodingOrCallback?: BufferEncoding | ((err?: Error | null) => void),\n callback?: (err?: Error | null) => void,\n ): boolean {\n if (chunk != null) {\n chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk as string));\n }\n // Signal to the caller that the write was accepted\n if (typeof encodingOrCallback === 'function') encodingOrCallback();\n else if (typeof callback === 'function') callback();\n return true;\n };\n\n (res as any).end = function (\n chunk?: string | Buffer | Uint8Array,\n encodingOrCallback?: BufferEncoding | ((err?: Error | null) => void),\n callback?: (err?: Error | null) => void,\n ): ServerResponse {\n if (chunk != null) {\n chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk as string));\n }\n\n const contentType = (res.getHeader('content-type') as string) ?? '';\n const isHtml = contentType.includes('text/html');\n\n if (!isHtml || chunks.length === 0) {\n // Not HTML — restore and send as-is\n res.write = originalWrite;\n res.end = originalEnd;\n return originalEnd(Buffer.concat(chunks), encodingOrCallback as BufferEncoding, callback);\n }\n\n const html = Buffer.concat(chunks).toString('utf-8');\n\n if (html.includes(AD_INJECTION_MARKER)) {\n // Already injected (e.g. double middleware mount) — send as-is\n res.write = originalWrite;\n res.end = originalEnd;\n return originalEnd(html, encodingOrCallback as BufferEncoding, callback);\n }\n\n // Await the parallel ad fetch and inject, then send.\n // adsPromise is fire-and-forget from Node's perspective; we must eventually\n // call originalEnd regardless of outcome.\n adsPromise\n .then((pageAds) => {\n res.write = originalWrite;\n res.end = originalEnd;\n\n if (!pageAds.ads || pageAds.ads.length === 0) {\n originalEnd(html, encodingOrCallback as BufferEncoding, callback);\n return;\n }\n\n const modified = injectIntoHtml(html, pageAds.ads, scraperService.isScraperService);\n\n // Layer 3: response header\n res.setHeader('X-Sponsored-Content', buildSponsoredHeader(pageAds.ads));\n\n const buf = Buffer.from(modified, 'utf-8');\n // Update Content-Length now that the body has grown\n res.setHeader('Content-Length', buf.length);\n\n // Log impressions fire-and-forget — triggers billing\n const timestamp = new Date().toISOString();\n for (const ad of pageAds.ads) {\n client\n .logImpression({\n impression_id: ad.impression_id,\n site_id: config.siteId,\n page_path: path,\n agent_ua: userAgent,\n agent_ip: ipAddress,\n timestamp,\n })\n .catch(() => {});\n }\n\n originalEnd(buf, encodingOrCallback as BufferEncoding, callback);\n })\n .catch(() => {\n // Ad fetch or injection failed — send the original unmodified HTML\n res.write = originalWrite;\n res.end = originalEnd;\n originalEnd(html, encodingOrCallback as BufferEncoding, callback);\n });\n\n // Return res synchronously — Node's HTTP server will keep the connection\n // open until originalEnd is called by the promise above.\n return res;\n };\n }\n\n // Log after response completes (captures final status code and timing)\n res.on('finish', () => {\n if (shouldSkip(path)) return;\n\n const entry: RequestLogEntry = {\n site_id: config.siteId,\n timestamp: new Date().toISOString(),\n method: req.method ?? 'GET',\n path,\n status_code: res.statusCode,\n response_time_ms: Date.now() - startMs,\n ip_address: ipAddress,\n user_agent: userAgent,\n referer: (req.headers['referer'] as string) ?? null,\n is_ai_crawler: crawlerInfo.isAi,\n crawler_type: crawlerInfo.name,\n crawler_organization: crawlerInfo.organization,\n confidence_score: crawlerInfo.confidence,\n scraper_service: scraperService.name,\n };\n\n logger.enqueue(entry);\n });\n\n next();\n };\n}\n\n// ─── Query endpoint handler ───────────────────────────────────────────────────\n\n/**\n * Express route handler for the AEO query endpoint.\n *\n * Mount this at the path configured in your dashboard (default: /query).\n *\n * @example\n * app.get('/query', createExpressQueryHandler({ apiKey: 'ak_...', siteId: 'site_...' }));\n */\nexport function createExpressQueryHandler(config: ApptvtyConfig): ConnectHandler {\n const { client } = getInstance(config);\n const handleQuery = createQueryHandler(client, config);\n\n return async function queryHandler(req, res) {\n const url = new URL(req.url ?? '/', `http://${req.headers.host ?? 'localhost'}`);\n const q = url.searchParams.get('q');\n const lang = url.searchParams.get('lang');\n const surfaceAds = parseBoolParam(url.searchParams.get('surface_ads'), true);\n const aiCrawler = parseBoolParam(url.searchParams.get('ai_crawler'), false);\n const userAgent = req.headers['user-agent'] ?? '';\n\n const result = await handleQuery({\n query: q,\n lang,\n surface_ads: surfaceAds,\n ai_crawler: aiCrawler,\n userAgent,\n ipAddress: getClientIp(req.headers as Record<string, string | string[] | undefined>),\n requestUrl: url.toString(),\n });\n\n for (const [key, value] of Object.entries(result.headers)) {\n res.setHeader(key, value);\n }\n res.statusCode = result.status;\n res.end(JSON.stringify(result.body));\n };\n}\n\n/**\n * Express route handler for the embedded analytics dashboard.\n *\n * Mount this at the path where you want to view your logs (default: /apptvty/logs).\n *\n * @example\n * app.get('/apptvty/logs', createExpressDashboardHandler({ apiKey: 'ak_...', siteId: 'site_...' }));\n */\nexport function createExpressDashboardHandler(config: ApptvtyConfig): ConnectHandler {\n const { client } = getInstance(config);\n const handleDashboard = createDashboardHandler(client, config);\n\n return async function dashboardHandler(req, res) {\n const url = new URL(req.url ?? '/', `http://${req.headers.host ?? 'localhost'}`);\n const result = await handleDashboard({\n path: url.pathname + url.search,\n method: req.method ?? 'GET',\n apiKey: config.apiKey,\n siteId: config.siteId,\n });\n\n for (const [key, value] of Object.entries(result.headers)) {\n res.setHeader(key, value);\n }\n res.statusCode = result.status;\n res.end(result.body);\n };\n}\n\n// ─── Helpers ──────────────────────────────────────────────────────────────────\n\nfunction parseBoolParam(value: string | null, defaultValue: boolean): boolean {\n if (value === null) return defaultValue;\n return value === '1' || value === 'true' || value === 'yes';\n}\n\nfunction shouldSkip(path: string): boolean {\n return (\n path.startsWith('/_next/') ||\n /\\.(svg|png|jpg|jpeg|gif|webp|ico|woff2?|ttf|css|js\\.map)$/.test(path)\n );\n}\n"],"mappings":"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","names":[]}
@@ -1,10 +1,14 @@
1
1
  import {
2
2
  ApptvtyClient,
3
3
  RequestLogger,
4
+ buildSponsoredHeader,
5
+ createDashboardHandler,
4
6
  createQueryHandler,
5
7
  detectCrawler,
6
- getClientIp
7
- } from "./chunk-WATTAPBA.mjs";
8
+ detectScraperService,
9
+ getClientIp,
10
+ injectIntoHtml
11
+ } from "./chunk-OTPVLSG5.mjs";
8
12
 
9
13
  // src/middleware/nextjs.ts
10
14
  import { NextResponse } from "next/server";
@@ -29,8 +33,9 @@ function withApptvty(config, next) {
29
33
  const startMs = Date.now();
30
34
  const userAgent = request.headers.get("user-agent") ?? "";
31
35
  const crawlerInfo = detectCrawler(userAgent);
36
+ const scraperService = detectScraperService(userAgent);
32
37
  const aiCrawlerParam = parseBoolParam(request.nextUrl.searchParams.get("ai_crawler"), false);
33
- const isCrawler = crawlerInfo.isAi || aiCrawlerParam;
38
+ const isCrawler = crawlerInfo.isAi || aiCrawlerParam || scraperService.isScraperService;
34
39
  let response;
35
40
  try {
36
41
  response = next ? await next(request) : NextResponse.next();
@@ -56,14 +61,23 @@ function withApptvty(config, next) {
56
61
  is_ai_crawler: crawlerInfo.isAi,
57
62
  crawler_type: crawlerInfo.name,
58
63
  crawler_organization: crawlerInfo.organization,
59
- confidence_score: crawlerInfo.confidence
64
+ confidence_score: crawlerInfo.confidence,
65
+ scraper_service: scraperService.name
60
66
  };
61
67
  logger.enqueue(entry);
62
68
  if (isCrawler && response.ok && !pathname.startsWith(queryPath)) {
63
69
  const contentType = response.headers.get("content-type") ?? "";
64
70
  if (contentType.includes("text/html")) {
65
71
  try {
66
- const modified = await injectAdsIntoHtml(response, client, config.siteId, pathname);
72
+ const modified = await injectAdsIntoResponse(
73
+ response,
74
+ client,
75
+ config,
76
+ pathname,
77
+ userAgent,
78
+ getClientIp(headers),
79
+ scraperService.isScraperService
80
+ );
67
81
  if (modified) return modified;
68
82
  } catch (err) {
69
83
  if (config.debug) console.warn("[apptvty] Ad injection failed:", err);
@@ -99,40 +113,53 @@ function createNextjsQueryHandler(config) {
99
113
  });
100
114
  };
101
115
  }
102
- var AD_INJECTION_MARKER = "<!-- apptvty-sponsored -->";
103
- function buildAdBlock(ads) {
104
- const items = ads.map(
105
- (ad) => `<li><a href="${escapeHtml(ad.url)}" rel="nofollow">${escapeHtml(ad.text)}</a> <small>\u2014 ${escapeHtml(ad.advertiser)}</small></li>`
106
- ).join("\n");
107
- return `
108
- <section aria-label="Sponsored" data-sponsored ${AD_INJECTION_MARKER}>
109
- <h3>Sponsored</h3>
110
- <ul>${items}</ul>
111
- </section>`;
112
- }
113
- function escapeHtml(s) {
114
- return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
116
+ function createNextjsDashboardHandler(config) {
117
+ const { client } = getInstance(config);
118
+ const handleDashboard = createDashboardHandler(client, config);
119
+ return async function dashboardHandler(request) {
120
+ const result = await handleDashboard({
121
+ path: request.nextUrl.pathname + request.nextUrl.search,
122
+ method: request.method,
123
+ apiKey: config.apiKey,
124
+ siteId: config.siteId
125
+ });
126
+ if (result.headers["Content-Type"] === "text/html") {
127
+ return new NextResponse(result.body, {
128
+ status: result.status,
129
+ headers: result.headers
130
+ });
131
+ }
132
+ return NextResponse.json(JSON.parse(result.body), {
133
+ status: result.status,
134
+ headers: result.headers
135
+ });
136
+ };
115
137
  }
116
- async function injectAdsIntoHtml(response, client, siteId, pathname) {
138
+ async function injectAdsIntoResponse(response, client, config, pathname, userAgent, ipAddress, isScraperService) {
117
139
  const html = await response.text();
118
- if (!html || html.includes(AD_INJECTION_MARKER)) return null;
119
- const pageAds = await client.getAdsForPage({ site_id: siteId, page_path: pathname });
140
+ if (!html) return null;
141
+ const pageAds = await client.getAdsForPage({ site_id: config.siteId, page_path: pathname });
120
142
  if (!pageAds.ads || pageAds.ads.length === 0) return null;
121
- const adBlock = buildAdBlock(pageAds.ads);
122
- let modified;
123
- if (html.includes("</body>")) {
124
- modified = html.replace("</body>", `${adBlock}
125
- </body>`);
126
- } else if (html.includes("</html>")) {
127
- modified = html.replace("</html>", `${adBlock}
128
- </html>`);
129
- } else {
130
- modified = html + adBlock;
143
+ const modified = injectIntoHtml(html, pageAds.ads, isScraperService);
144
+ if (modified === html) return null;
145
+ const newHeaders = new Headers(response.headers);
146
+ newHeaders.set("X-Sponsored-Content", buildSponsoredHeader(pageAds.ads));
147
+ const timestamp = (/* @__PURE__ */ new Date()).toISOString();
148
+ for (const ad of pageAds.ads) {
149
+ client.logImpression({
150
+ impression_id: ad.impression_id,
151
+ site_id: config.siteId,
152
+ page_path: pathname,
153
+ agent_ua: userAgent,
154
+ agent_ip: ipAddress,
155
+ timestamp
156
+ }).catch(() => {
157
+ });
131
158
  }
132
159
  return new NextResponse(modified, {
133
160
  status: response.status,
134
161
  statusText: response.statusText,
135
- headers: new Headers(response.headers)
162
+ headers: newHeaders
136
163
  });
137
164
  }
138
165
  function parseBoolParam(value, defaultValue) {
@@ -145,6 +172,7 @@ function shouldSkip(pathname) {
145
172
 
146
173
  export {
147
174
  withApptvty,
148
- createNextjsQueryHandler
175
+ createNextjsQueryHandler,
176
+ createNextjsDashboardHandler
149
177
  };
150
- //# sourceMappingURL=chunk-XOWRKLFM.mjs.map
178
+ //# sourceMappingURL=chunk-454YBHM2.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/middleware/nextjs.ts"],"sourcesContent":["/**\n * Next.js App Router integration for the Apptvty SDK.\n *\n * Usage — two pieces:\n *\n * 1. Wrap your existing middleware.ts (or use ours standalone):\n *\n * import { withApptvty } from 'apptvty/nextjs';\n * export default withApptvty({ apiKey: 'ak_...', siteId: 'site_...' });\n * // or wrap your existing middleware:\n * export default withApptvty(config, yourMiddleware);\n *\n * 2. Create app/query/route.ts for the AEO query endpoint:\n *\n * import { createNextjsQueryHandler } from 'apptvty/nextjs';\n * export const GET = createNextjsQueryHandler({ apiKey: 'ak_...', siteId: 'site_...' });\n *\n * Ad injection strategy (three layers, applied for all AI/scraper traffic):\n *\n * Layer 1 — <p>[Sponsored]</p> inside <article>/<main>\n * Survives Jina, FireCrawl, Cloudflare Browser Rendering, BeautifulSoup,\n * headless browsers, curl, requests. Applied for all crawler types.\n *\n * Layer 2 — JSON-LD <script> in <head>\n * For direct HTML scrapers (BeautifulSoup, lxml). Skipped for known\n * scraper services (Jina/FireCrawl/Cloudflare) — they drop <head> on\n * Markdown conversion.\n *\n * Layer 3 — X-Sponsored-Content response header\n * For any HTTP client that reads response headers (requests, httpx, curl).\n * Applied for all crawler types.\n */\n\nimport type { NextRequest } from 'next/server';\nimport { NextResponse } from 'next/server';\nimport { ApptvtyClient } from '../client.js';\nimport { detectCrawler, detectScraperService } from '../crawler.js';\nimport { RequestLogger, getClientIp } from '../logger.js';\nimport { createQueryHandler } from '../query-handler.js';\nimport { createDashboardHandler } from '../dashboard-handler.js';\nimport { injectIntoHtml, buildSponsoredHeader } from '../ad-injection.js';\nimport type { ApptvtyConfig, RequestLogEntry } from '../types.js';\n\n/** Convert Next request headers to a plain object (Web API Headers.entries() at runtime). */\nfunction headersToRecord(h: NextRequest['headers']): Record<string, string> {\n const entries = (h as unknown as { entries(): IterableIterator<[string, string]> }).entries();\n return Object.fromEntries(Array.from(entries));\n}\n\n// ─── Shared singleton instances per config (keyed by apiKey) ─────────────────\n\nconst instances = new Map<string, { client: ApptvtyClient; logger: RequestLogger }>();\n\nfunction getInstance(config: ApptvtyConfig) {\n const key = config.apiKey;\n if (!instances.has(key)) {\n const client = new ApptvtyClient(config);\n const logger = new RequestLogger(client, config);\n instances.set(key, { client, logger });\n }\n return instances.get(key)!;\n}\n\n// ─── Middleware wrapper ───────────────────────────────────────────────────────\n\ntype NextMiddleware = (request: NextRequest) => Response | NextResponse | Promise<Response | NextResponse>;\n\n/**\n * Wraps a Next.js middleware function (or creates a passthrough) with\n * Apptvty request logging and multi-layer ad injection for AI/scraper traffic.\n *\n * @example\n * // middleware.ts\n * import { withApptvty } from 'apptvty/nextjs';\n * export default withApptvty({ apiKey: 'ak_...', siteId: 'site_...' });\n */\nexport function withApptvty(\n config: ApptvtyConfig,\n next?: NextMiddleware,\n): NextMiddleware {\n const { client, logger } = getInstance(config);\n const queryPath = config.queryPath ?? '/query';\n\n return async function apptvtyMiddleware(request: NextRequest): Promise<NextResponse> {\n const startMs = Date.now();\n const userAgent = request.headers.get('user-agent') ?? '';\n const crawlerInfo = detectCrawler(userAgent);\n const scraperService = detectScraperService(userAgent);\n const aiCrawlerParam = parseBoolParam(request.nextUrl.searchParams.get('ai_crawler'), false);\n const isCrawler = crawlerInfo.isAi || aiCrawlerParam || scraperService.isScraperService;\n\n // Run the user's middleware (or passthrough)\n let response: Response | NextResponse;\n try {\n response = next ? await next(request) : NextResponse.next();\n } catch (err) {\n throw err;\n }\n\n const responseTimeMs = Date.now() - startMs;\n const { pathname } = request.nextUrl;\n\n if (shouldSkip(pathname)) {\n return response as NextResponse;\n }\n\n const headers = headersToRecord(request.headers);\n const entry: RequestLogEntry = {\n site_id: config.siteId,\n timestamp: new Date().toISOString(),\n method: request.method,\n path: pathname,\n status_code: response.status,\n response_time_ms: responseTimeMs,\n ip_address: getClientIp(headers),\n user_agent: userAgent,\n referer: request.headers.get('referer'),\n is_ai_crawler: crawlerInfo.isAi,\n crawler_type: crawlerInfo.name,\n crawler_organization: crawlerInfo.organization,\n confidence_score: crawlerInfo.confidence,\n scraper_service: scraperService.name,\n };\n\n logger.enqueue(entry);\n\n // Ad injection for all AI crawler and scraper service traffic on HTML pages\n if (isCrawler && response.ok && !pathname.startsWith(queryPath)) {\n const contentType = response.headers.get('content-type') ?? '';\n if (contentType.includes('text/html')) {\n try {\n const modified = await injectAdsIntoResponse(\n response,\n client,\n config,\n pathname,\n userAgent,\n getClientIp(headers),\n scraperService.isScraperService,\n );\n if (modified) return modified;\n } catch (err) {\n if (config.debug) console.warn('[apptvty] Ad injection failed:', err);\n }\n }\n }\n\n return response as NextResponse;\n };\n}\n\n// ─── Query route handler ──────────────────────────────────────────────────────\n\n/**\n * Creates a Next.js App Router GET handler for the AEO query endpoint.\n *\n * @example\n * // app/query/route.ts\n * import { createNextjsQueryHandler } from 'apptvty/nextjs';\n * export const GET = createNextjsQueryHandler({ apiKey: 'ak_...', siteId: 'site_...' });\n */\nexport function createNextjsQueryHandler(config: ApptvtyConfig) {\n const { client } = getInstance(config);\n const handleQuery = createQueryHandler(client, config);\n\n return async function GET(request: NextRequest): Promise<NextResponse> {\n const { searchParams } = request.nextUrl;\n const q = searchParams.get('q');\n const lang = searchParams.get('lang');\n const surfaceAds = parseBoolParam(searchParams.get('surface_ads'), true);\n const aiCrawler = parseBoolParam(searchParams.get('ai_crawler'), false);\n const userAgent = request.headers.get('user-agent') ?? '';\n const headers = headersToRecord(request.headers);\n\n const result = await handleQuery({\n query: q,\n lang,\n surface_ads: surfaceAds,\n ai_crawler: aiCrawler,\n userAgent,\n ipAddress: getClientIp(headers),\n requestUrl: request.url,\n });\n\n return NextResponse.json(result.body, {\n status: result.status,\n headers: result.headers,\n });\n };\n}\n\n/**\n * Next.js route handler for the embedded analytics dashboard.\n *\n * Mount this in app/api/apptvty/logs/route.ts (or your preferred path).\n *\n * @example\n * // app/api/apptvty/logs/route.ts\n * import { createNextjsDashboardHandler } from 'apptvty/nextjs';\n * const config = { apiKey: 'ak_...', siteId: 'site_...' };\n * export const GET = createNextjsDashboardHandler(config);\n */\nexport function createNextjsDashboardHandler(config: ApptvtyConfig) {\n const { client } = getInstance(config);\n const handleDashboard = createDashboardHandler(client, config);\n\n return async function dashboardHandler(request: NextRequest) {\n const result = await handleDashboard({\n path: request.nextUrl.pathname + request.nextUrl.search,\n method: request.method,\n apiKey: config.apiKey,\n siteId: config.siteId,\n });\n\n if (result.headers['Content-Type'] === 'text/html') {\n return new NextResponse(result.body, {\n status: result.status,\n headers: result.headers,\n });\n }\n\n return NextResponse.json(JSON.parse(result.body), {\n status: result.status,\n headers: result.headers,\n });\n };\n}\n\n// ─── Ad injection ─────────────────────────────────────────────────────────────\n\nasync function injectAdsIntoResponse(\n response: Response,\n client: ApptvtyClient,\n config: ApptvtyConfig,\n pathname: string,\n userAgent: string,\n ipAddress: string,\n isScraperService: boolean,\n): Promise<NextResponse | null> {\n const html = await response.text();\n if (!html) return null;\n\n const pageAds = await client.getAdsForPage({ site_id: config.siteId, page_path: pathname });\n if (!pageAds.ads || pageAds.ads.length === 0) return null;\n\n const modified = injectIntoHtml(html, pageAds.ads, isScraperService);\n if (modified === html) return null; // nothing was injected\n\n const newHeaders = new Headers(response.headers);\n\n // Layer 3: HTTP response header — readable by any HTTP client inspecting headers\n newHeaders.set('X-Sponsored-Content', buildSponsoredHeader(pageAds.ads));\n\n // Log impressions fire-and-forget — triggers billing\n const timestamp = new Date().toISOString();\n for (const ad of pageAds.ads) {\n client\n .logImpression({\n impression_id: ad.impression_id,\n site_id: config.siteId,\n page_path: pathname,\n agent_ua: userAgent,\n agent_ip: ipAddress,\n timestamp,\n })\n .catch(() => {});\n }\n\n return new NextResponse(modified, {\n status: response.status,\n statusText: response.statusText,\n headers: newHeaders,\n });\n}\n\n// ─── Helpers ──────────────────────────────────────────────────────────────────\n\nfunction parseBoolParam(value: string | null, defaultValue: boolean): boolean {\n if (value === null) return defaultValue;\n return value === '1' || value === 'true' || value === 'yes';\n}\n\nfunction shouldSkip(pathname: string): boolean {\n return (\n pathname.startsWith('/_next/') ||\n pathname.startsWith('/api/_') ||\n pathname === '/favicon.ico' ||\n /\\.(svg|png|jpg|jpeg|gif|webp|ico|woff2?|ttf|css|js\\.map)$/.test(pathname)\n );\n}\n"],"mappings":"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","names":[]}