@devtune/ai-traffic 0.1.2 → 0.2.1

package/dist/cjs/client.js

@@ -0,0 +1,505 @@
+"use strict";
+/**
+ * ABOUTME: Implements the DevTune AI Traffic edge-push client.
+ * Handles registry refresh, AI bot matching, batched ingest beacons, and route wrappers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DevTuneAiTrafficClient = exports.DEFAULT_REGISTRY_URL = exports.DEFAULT_INGEST_ENDPOINT = void 0;
+exports.createDevTuneAiTraffic = createDevTuneAiTraffic;
+exports.createDevTuneAiTrafficMiddleware = createDevTuneAiTrafficMiddleware;
+exports.mightBeAiBotUserAgent = mightBeAiBotUserAgent;
+exports.withDevTuneAiTrafficRoute = withDevTuneAiTrafficRoute;
+const registry_js_1 = require("./registry.js");
+exports.DEFAULT_INGEST_ENDPOINT = "https://devtune.ai/api/v1/llm-traffic/ingest";
+exports.DEFAULT_REGISTRY_URL = "https://devtune.ai/api/v1/llm-traffic/registry";
+const DEFAULT_REGISTRY_REVALIDATE_MS = 60 * 60 * 1000;
+const DEFAULT_WAIT_UNTIL_REGISTRY_REFRESH = true;
+const DEFAULT_BATCH_SIZE = 10;
+const DEFAULT_FLUSH_INTERVAL_MS = 250;
+const DEFAULT_STATUS = 200;
+const MAX_INGEST_BATCH_SIZE = 100;
+const MAX_EVENT_PATH_LENGTH = 2048;
+const MAX_EVENT_UA_LENGTH = 2048;
+const MAX_EVENT_URL_LENGTH = 4096;
+const RATE_LIMITED_STATUS = 429;
+const DEFAULT_MAX_RETRY_ATTEMPTS = 3;
+const RETRY_ATTEMPTS_CEILING = 10;
+const RETRY_BASE_DELAY_MS = 250;
+const DEFAULT_MAX_RETRY_DELAY_MS = 5_000;
+const RETRY_DELAY_CEILING_MS = 60_000;
+const DEFAULT_MAX_QUEUED_EVENTS = 1_000;
+const MAX_QUEUED_EVENTS_CEILING = 100_000;
+const AI_BOT_USER_AGENT_HINTS = [
+    "-ai",
+    "ai-",
+    "agent",
+    "anthropic",
+    "bot",
+    "bytespider",
+    "claude",
+    "cohere",
+    "crawler",
+    "fetch",
+    "google-",
+    "gpt",
+    "meta-external",
+    "mistral",
+    "notebooklm",
+    "oai-",
+    "openai",
+    "perplexity",
+    "quora",
+    "spider",
+    "xai",
+];
+class DevTuneAiTrafficClient {
+    options;
+    endpoint;
+    registryUrl;
+    registryRevalidateMs;
+    waitUntilRegistryRefresh;
+    batchSize;
+    flushIntervalMs;
+    defaultStatus;
+    fetchImpl;
+    logger;
+    now;
+    random;
+    errorSampleRate;
+    maxRetryAttempts;
+    maxRetryDelayMs;
+    maxQueuedEvents;
+    registry;
+    refreshPromise = null;
+    flushPromise = null;
+    delayedFlushPromise = null;
+    queue = [];
+    constructor(options) {
+        this.options = options;
+        if (!options.ingestKey) {
+            throw new Error("DevTune AI Traffic ingestKey is required");
+        }
+        this.endpoint = options.endpoint ?? exports.DEFAULT_INGEST_ENDPOINT;
+        this.registryUrl = options.registryUrl ?? exports.DEFAULT_REGISTRY_URL;
+        this.registryRevalidateMs = options.registryRevalidateMs ?? DEFAULT_REGISTRY_REVALIDATE_MS;
+        this.waitUntilRegistryRefresh =
+            options.waitUntilRegistryRefresh ?? DEFAULT_WAIT_UNTIL_REGISTRY_REFRESH;
+        this.batchSize = clampInteger(options.batchSize ?? DEFAULT_BATCH_SIZE, 1, MAX_INGEST_BATCH_SIZE);
+        this.flushIntervalMs = clampInteger(options.flushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS, 0, 60_000);
+        this.defaultStatus =
+            options.defaultStatus === null
+                ? null
+                : normalizeStatus(options.defaultStatus ?? DEFAULT_STATUS, DEFAULT_STATUS);
+        this.fetchImpl = options.fetch ?? fetch;
+        this.logger = options.logger ?? null;
+        this.now = options.now ?? (() => new Date());
+        this.random = options.random ?? Math.random;
+        this.errorSampleRate = clampNumber(options.errorSampleRate ?? 0.01, 0, 1);
+        this.maxRetryAttempts = clampInteger(options.maxRetryAttempts ?? DEFAULT_MAX_RETRY_ATTEMPTS, 0, RETRY_ATTEMPTS_CEILING);
+        this.maxRetryDelayMs = clampInteger(options.maxRetryDelayMs ?? DEFAULT_MAX_RETRY_DELAY_MS, 0, RETRY_DELAY_CEILING_MS);
+        this.maxQueuedEvents = clampInteger(options.maxQueuedEvents ?? DEFAULT_MAX_QUEUED_EVENTS, MAX_INGEST_BATCH_SIZE, MAX_QUEUED_EVENTS_CEILING);
+        const fallbackEntries = (0, registry_js_1.compileAiBotRegistryEntries)(registry_js_1.FALLBACK_AI_BOT_REGISTRY_ENTRIES);
+        const fallbackPrefilter = createRegistryPrefilter(fallbackEntries);
+        this.registry = {
+            entries: fallbackEntries,
+            etag: null,
+            fetchedAt: 0,
+            ...fallbackPrefilter,
+            version: "bundled",
+        };
+    }
+    mightTrackRequest(request) {
+        const userAgent = request.headers.get("user-agent");
+        if (!userAgent) {
+            return false;
+        }
+        if (mightBeAiBotUserAgent(userAgent) || this.registry.requiresFullPrefilterScan) {
+            return true;
+        }
+        const normalized = userAgent.toLowerCase();
+        return this.registry.userAgentHints.some((hint) => normalized.includes(hint));
+    }
+    trackRequest(request, waitUntilContext, responseStatus) {
+        if (!this.mightTrackRequest(request)) {
+            return null;
+        }
+        const userAgent = request.headers.get("user-agent");
+        if (!userAgent) {
+            return null;
+        }
+        const entry = (0, registry_js_1.matchAiBotRegistryEntry)(userAgent, this.registry.entries);
+        if (!entry) {
+            if (mightBeAiBotUserAgent(userAgent)) {
+                this.refreshRegistryIfStale(waitUntilContext);
+            }
+            return null;
+        }
+        this.refreshRegistryIfStale(waitUntilContext);
+        const event = this.createEvent(request, userAgent, responseStatus);
+        if (!event) {
+            return null;
+        }
+        this.enqueue(event, waitUntilContext);
+        return {
+            entry,
+            event,
+        };
+    }
+    async refreshRegistry() {
+        const headers = {
+            accept: "application/json",
+        };
+        if (this.registry.etag) {
+            headers["if-none-match"] = this.registry.etag;
+        }
+        const response = await this.fetchImpl(this.registryUrl, {
+            headers,
+            method: "GET",
+        });
+        if (response.status === 304) {
+            this.registry = {
+                ...this.registry,
+                fetchedAt: Date.now(),
+            };
+            return;
+        }
+        if (!response.ok) {
+            throw new Error(`Registry request failed with status ${response.status}`);
+        }
+        const payload = (0, registry_js_1.parseAiBotRegistryPayload)(await response.json());
+        if (!payload) {
+            throw new Error("Registry response was not a valid DevTune registry");
+        }
+        const entries = (0, registry_js_1.compileAiBotRegistryEntries)(payload.entries);
+        this.registry = {
+            entries,
+            etag: response.headers.get("etag") ?? `"${payload.version}"`,
+            fetchedAt: Date.now(),
+            ...createRegistryPrefilter(entries),
+            version: payload.version,
+        };
+    }
+    async flush() {
+        if (this.flushPromise) {
+            return this.flushPromise;
+        }
+        this.flushPromise = this.flushQueuedEvents().finally(() => {
+            this.flushPromise = null;
+        });
+        return this.flushPromise;
+    }
+    refreshRegistryIfStale(waitUntilContext) {
+        if (this.refreshPromise) {
+            return;
+        }
+        if (Date.now() - this.registry.fetchedAt < this.registryRevalidateMs) {
+            return;
+        }
+        this.refreshPromise = this.refreshRegistry()
+            .catch((error) => {
+            this.registry = {
+                ...this.registry,
+                fetchedAt: Date.now(),
+            };
+            this.sampleWarn("Failed to refresh DevTune AI bot registry", { error });
+        })
+            .finally(() => {
+            this.refreshPromise = null;
+        });
+        scheduleBackground(this.refreshPromise, this.waitUntilRegistryRefresh ? waitUntilContext : undefined);
+    }
+    createEvent(request, userAgent, responseStatus) {
+        const url = parseRequestUrl(request.url);
+        if (!url) {
+            return null;
+        }
+        const pathname = truncateString(url.pathname || "/", MAX_EVENT_PATH_LENGTH);
+        const status = this.resolveStatus(request, pathname, responseStatus);
+        return {
+            path: pathname,
+            url: truncateString(`${url.origin}${pathname}`, MAX_EVENT_URL_LENGTH),
+            ua: truncateString(userAgent, MAX_EVENT_UA_LENGTH),
+            ...(status === null ? {} : { status }),
+            ts: this.now().toISOString(),
+        };
+    }
+    resolveStatus(request, pathname, responseStatus) {
+        if (responseStatus === null) {
+            return null;
+        }
+        const explicitStatus = normalizeStatus(responseStatus, null);
+        if (explicitStatus !== null) {
+            return explicitStatus;
+        }
+        const resolverStatus = this.options.statusResolver?.(request);
+        if (resolverStatus === null) {
+            return null;
+        }
+        const resolvedStatus = normalizeStatus(resolverStatus, null);
+        if (resolvedStatus !== null) {
+            return resolvedStatus;
+        }
+        if (this.matchesNotFoundPath(pathname)) {
+            return 404;
+        }
+        return this.defaultStatus;
+    }
+    matchesNotFoundPath(pathname) {
+        for (const pattern of this.options.notFoundPathPatterns ?? []) {
+            if (typeof pattern === "string") {
+                if (pattern === pathname) {
+                    return true;
+                }
+                continue;
+            }
+            pattern.lastIndex = 0;
+            if (pattern.test(pathname)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Adds an event to the queue and decides when to send.
+     *
+     * Backing off on a 429 means the queue can now drain slower than traffic
+     * arrives, which it never could when every batch cost exactly one request.
+     * The bound is what keeps that from growing without limit in a customer's
+     * process: past `maxQueuedEvents` the oldest events are shed, because the
+     * newest ones are the ones still worth measuring.
+     */
+    enqueue(event, waitUntilContext) {
+        this.queue.push(event);
+        if (this.queue.length > this.maxQueuedEvents) {
+            const shed = this.queue.splice(0, this.queue.length - this.maxQueuedEvents);
+            this.sampleWarn("DevTune AI Traffic ingest queue overflowed", {
+                droppedEvents: shed.length,
+                maxQueuedEvents: this.maxQueuedEvents,
+            });
+        }
+        if (this.queue.length >= this.batchSize) {
+            scheduleBackground(this.flush(), waitUntilContext);
+            return;
+        }
+        if (this.delayedFlushPromise) {
+            scheduleBackground(this.delayedFlushPromise, waitUntilContext);
+            return;
+        }
+        this.delayedFlushPromise = delay(this.flushIntervalMs)
+            .then(() => this.flush())
+            .finally(() => {
+            this.delayedFlushPromise = null;
+        });
+        scheduleBackground(this.delayedFlushPromise, waitUntilContext);
+    }
+    /**
+     * Drains the queue one wire batch at a time.
+     *
+     * A 429 is the one failure the ingest endpoint tells us is temporary, so the
+     * batch is held out of the queue and redelivered after the server's
+     * `Retry-After`, or a capped exponential backoff when the header is absent or
+     * unparseable. Holding it locally rather than putting it back at the head of
+     * the queue keeps the wire batch intact: events that arrive during a backoff
+     * are not folded into the batch being retried, so they cannot be dropped on a
+     * bound they never had a chance to spend.
+     *
+     * The retry budget belongs to the whole drain, not to each batch. A per-batch
+     * bound says nothing about how long a drain can run, because a throttled
+     * endpoint rejects every batch in turn and traffic keeps arriving behind it.
+     * One budget per pass caps the added latency of a flush at
+     * `maxRetryAttempts * maxRetryDelayMs` no matter how deep the queue is. When
+     * it is spent the current batch is dropped with the usual sampled warning and
+     * the drain stops, leaving the rest queued for the next flush, which gets a
+     * fresh budget.
+     *
+     * Every other failure keeps its previous behavior: one attempt, dropped, and
+     * a sampled warning.
+     */
+    async flushQueuedEvents() {
+        let retryBudget = this.maxRetryAttempts;
+        while (this.queue.length > 0) {
+            const batch = this.queue.splice(0, MAX_INGEST_BATCH_SIZE);
+            let attempts = 0;
+            for (;;) {
+                let response;
+                try {
+                    response = await this.fetchImpl(this.endpoint, {
+                        body: JSON.stringify({ events: batch }),
+                        headers: {
+                            authorization: `Bearer ${this.options.ingestKey}`,
+                            "content-type": "application/json",
+                        },
+                        keepalive: true,
+                        method: "POST",
+                    });
+                }
+                catch (error) {
+                    this.sampleWarn("DevTune AI Traffic ingest request failed", { error });
+                    break;
+                }
+                attempts += 1;
+                if (response.status !== RATE_LIMITED_STATUS) {
+                    if (!response.ok) {
+                        this.sampleWarn("DevTune AI Traffic ingest request failed", {
+                            status: response.status,
+                        });
+                    }
+                    break;
+                }
+                if (retryBudget === 0) {
+                    this.sampleWarn("DevTune AI Traffic ingest request failed", {
+                        attempts,
+                        droppedEvents: batch.length,
+                        status: response.status,
+                    });
+                    return;
+                }
+                const retryDelayMs = this.resolveRetryDelayMs(response.headers.get("retry-after"), this.maxRetryAttempts - retryBudget);
+                retryBudget -= 1;
+                await delay(retryDelayMs);
+            }
+        }
+    }
+    resolveRetryDelayMs(retryAfterHeader, retryAttempts) {
+        const retryAfterMs = parseRetryAfterMs(retryAfterHeader, this.now());
+        const backoffMs = RETRY_BASE_DELAY_MS * 2 ** retryAttempts;
+        return Math.min(retryAfterMs ?? backoffMs, this.maxRetryDelayMs);
+    }
+    sampleWarn(message, context) {
+        if (this.errorSampleRate === 0 || this.random() > this.errorSampleRate) {
+            return;
+        }
+        this.logger?.warn(message, context);
+    }
+}
+exports.DevTuneAiTrafficClient = DevTuneAiTrafficClient;
+function createDevTuneAiTraffic(options) {
+    return new DevTuneAiTrafficClient(options);
+}
+function createDevTuneAiTrafficMiddleware(options) {
+    const client = createDevTuneAiTraffic({
+        ...options,
+        defaultStatus: options.defaultStatus ?? null,
+        waitUntilRegistryRefresh: options.waitUntilRegistryRefresh ?? false,
+    });
+    return function devTuneAiTrafficMiddleware(request, event) {
+        client.trackRequest(request, event);
+    };
+}
+function mightBeAiBotUserAgent(userAgent) {
+    if (!userAgent) {
+        return false;
+    }
+    const normalized = userAgent.toLowerCase();
+    return AI_BOT_USER_AGENT_HINTS.some((hint) => normalized.includes(hint));
+}
+function withDevTuneAiTrafficRoute(handler, options) {
+    const client = createDevTuneAiTraffic(options);
+    return async function devTuneAiTrafficRoute(request, context) {
+        const response = await handler(request, context);
+        const waitUntilContext = getWaitUntilContext(context);
+        client.trackRequest(request, waitUntilContext, response.status);
+        return response;
+    };
+}
+function scheduleBackground(promise, waitUntilContext) {
+    const guardedPromise = promise.catch(() => undefined);
+    if (waitUntilContext) {
+        waitUntilContext.waitUntil(guardedPromise);
+        return;
+    }
+    void guardedPromise;
+}
+function getWaitUntilContext(value) {
+    if (!isRecord(value)) {
+        return undefined;
+    }
+    const waitUntil = value.waitUntil;
+    if (typeof waitUntil !== "function") {
+        return undefined;
+    }
+    return {
+        waitUntil: (promise) => {
+            waitUntil.call(value, promise);
+        },
+    };
+}
+function parseRequestUrl(url) {
+    try {
+        return new URL(url);
+    }
+    catch {
+        return null;
+    }
+}
+function delay(ms) {
+    if (ms <= 0) {
+        return Promise.resolve();
+    }
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+/**
+ * Reads an RFC 9110 `Retry-After` value in either accepted form: delay seconds,
+ * or an HTTP date. Returns null when the header is missing or unusable so the
+ * caller can fall back to its own backoff.
+ */
+function parseRetryAfterMs(value, now) {
+    const trimmed = value?.trim();
+    if (!trimmed) {
+        return null;
+    }
+    if (/^\d+$/u.test(trimmed)) {
+        return Number(trimmed) * 1000;
+    }
+    const retryAt = Date.parse(trimmed);
+    if (Number.isNaN(retryAt)) {
+        return null;
+    }
+    return Math.max(retryAt - now.getTime(), 0);
+}
+function createRegistryPrefilter(entries) {
+    const userAgentHints = new Set();
+    let requiresFullPrefilterScan = false;
+    for (const { entry } of entries) {
+        const hint = entry.uaPattern.toLowerCase();
+        if (hint.length < 3 || /[.^$|]/u.test(hint)) {
+            requiresFullPrefilterScan = true;
+            continue;
+        }
+        userAgentHints.add(hint);
+    }
+    return {
+        requiresFullPrefilterScan,
+        userAgentHints: [...userAgentHints],
+    };
+}
+function normalizeStatus(value, fallback) {
+    if (typeof value === "number" && Number.isInteger(value) && value >= 100 && value <= 599) {
+        return value;
+    }
+    return fallback;
+}
+function clampInteger(value, min, max) {
+    if (!Number.isFinite(value)) {
+        return min;
+    }
+    return Math.min(Math.max(Math.trunc(value), min), max);
+}
+function clampNumber(value, min, max) {
+    if (!Number.isFinite(value)) {
+        return min;
+    }
+    return Math.min(Math.max(value, min), max);
+}
+function truncateString(value, maxLength) {
+    if (value.length <= maxLength) {
+        return value;
+    }
+    return value.slice(0, maxLength);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+//# sourceMappingURL=client.js.map

package/dist/cjs/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"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"}

package/dist/cjs/detection.js

@@ -0,0 +1,47 @@
+"use strict";
+/**
+ * ABOUTME: Standalone AI crawler and referrer classifiers for package consumers.
+ * Uses injectable registry entries with bundled snapshots as the offline default.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FALLBACK_AI_REFERRER_REGISTRY_ENTRIES = void 0;
+exports.detectAiCrawler = detectAiCrawler;
+exports.detectAiReferrer = detectAiReferrer;
+const registry_js_1 = require("./registry.js");
+exports.FALLBACK_AI_REFERRER_REGISTRY_ENTRIES = [
+    { hostname: "chat.openai.com", llmPlatform: "openai", label: "ChatGPT" },
+    { hostname: "chatgpt.com", llmPlatform: "openai", label: "ChatGPT" },
+    { hostname: "claude.ai", llmPlatform: "anthropic", label: "Claude" },
+    { hostname: "perplexity.ai", llmPlatform: "perplexity", label: "Perplexity" },
+    { hostname: "gemini.google.com", llmPlatform: "google", label: "Gemini" },
+    { hostname: "copilot.microsoft.com", llmPlatform: "microsoft", label: "Copilot" },
+    { hostname: "meta.ai", llmPlatform: "meta", label: "Meta AI" },
+];
+function detectAiCrawler(input, options = {}) {
+    const userAgent = typeof input === "string" ? input : input.headers.get("user-agent");
+    const entries = (0, registry_js_1.compileAiBotRegistryEntries)(options.registryEntries ?? registry_js_1.FALLBACK_AI_BOT_REGISTRY_ENTRIES);
+    return (0, registry_js_1.matchAiBotRegistryEntry)(userAgent, entries);
+}
+function detectAiReferrer(input, options = {}) {
+    const referrer = typeof input === "string"
+        ? input
+        : (input.headers.get("referer") ?? input.headers.get("referrer"));
+    if (!referrer) {
+        return null;
+    }
+    let hostname;
+    try {
+        hostname = new URL(referrer).hostname.toLowerCase().replace(/\.$/u, "");
+    }
+    catch {
+        return null;
+    }
+    for (const entry of options.registryEntries ?? exports.FALLBACK_AI_REFERRER_REGISTRY_ENTRIES) {
+        const knownHostname = entry.hostname.toLowerCase().replace(/\.$/u, "");
+        if (hostname === knownHostname || hostname.endsWith(`.${knownHostname}`)) {
+            return entry;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=detection.js.map

package/dist/cjs/detection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detection.js","sourceRoot":"","sources":["../../src/detection.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AA4CH,0CAUC;AAED,4CA8BC;AApFD,+CAMuB;AA0BV,QAAA,qCAAqC,GAAG;IACnD,EAAE,QAAQ,EAAE,iBAAiB,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE;IACxE,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE;IACpE,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE;IACpE,EAAE,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE;IAC7E,EAAE,QAAQ,EAAE,mBAAmB,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;IACzE,EAAE,QAAQ,EAAE,uBAAuB,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE;IACjF,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE;CAClB,CAAC;AAE/C,SAAgB,eAAe,CAC7B,KAAoC,EACpC,UAAkC,EAAE;IAEpC,MAAM,SAAS,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACtF,MAAM,OAAO,GAAG,IAAA,yCAA2B,EACzC,OAAO,CAAC,eAAe,IAAI,8CAAgC,CAC5D,CAAC;IAEF,OAAO,IAAA,qCAAuB,EAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AACrD,CAAC;AAED,SAAgB,gBAAgB,CAC9B,KAAoC,EACpC,UAAmC,EAAE;IAErC,MAAM,QAAQ,GACZ,OAAO,KAAK,KAAK,QAAQ;QACvB,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;IAEtE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,QAAgB,CAAC;IAErB,IAAI,CAAC;QACH,QAAQ,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC1E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,eAAe,IAAI,6CAAqC,EAAE,CAAC;QACrF,MAAM,aAAa,GAAG,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAEvE,IAAI,QAAQ,KAAK,aAAa,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,aAAa,EAAE,CAAC,EAAE,CAAC;YACzE,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/cjs/express.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * ABOUTME: Express middleware adapter for the DevTune AI Traffic client.
+ * Maps Express requests after response completion while sharing core matching and ingest logic.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDevTuneAiTrafficExpressMiddleware = createDevTuneAiTrafficExpressMiddleware;
+const ai_traffic_1 = require("@devtune/ai-traffic");
+function createDevTuneAiTrafficExpressMiddleware(options) {
+    const { origin, ...clientOptions } = options;
+    const client = (0, ai_traffic_1.createDevTuneAiTraffic)(clientOptions);
+    return function devTuneAiTrafficExpressMiddleware(request, response, next) {
+        const requestLike = {
+            headers: createHeadersLike(request),
+            url: createRequestUrl(request, origin),
+        };
+        if (!client.mightTrackRequest(requestLike)) {
+            next();
+            return;
+        }
+        response.once("finish", () => {
+            client.trackRequest(requestLike, undefined, response.statusCode);
+        });
+        next();
+    };
+}
+function createHeadersLike(request) {
+    return {
+        get(name) {
+            return getHeader(request, name);
+        },
+    };
+}
+function createRequestUrl(request, configuredOrigin) {
+    const requestPath = request.originalUrl ?? request.url;
+    try {
+        return new URL(requestPath, configuredOrigin ?? getRequestOrigin(request)).toString();
+    }
+    catch {
+        return requestPath;
+    }
+}
+function getRequestOrigin(request) {
+    const protocol = getForwardedHeader(request, "x-forwarded-proto") ?? request.protocol ?? "http";
+    const host = getForwardedHeader(request, "x-forwarded-host") ?? getHeader(request, "host") ?? "localhost";
+    return `${protocol}://${host}`;
+}
+function getHeader(request, name) {
+    return request.get?.(name) ?? headerValue(request.headers[name.toLowerCase()]);
+}
+function getForwardedHeader(request, name) {
+    const value = getHeader(request, name);
+    return value?.split(",", 1)[0]?.trim() || null;
+}
+function headerValue(value) {
+    if (typeof value === "string") {
+        return value;
+    }
+    return value?.[0] ?? null;
+}
+//# sourceMappingURL=express.js.map

package/dist/cjs/express.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.js","sourceRoot":"","sources":["../../../express/src/express.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AA6BH,0FA0BC;AArDD,oDAI6B;AAuB7B,SAAgB,uCAAuC,CAAC,OAAuC;IAC7F,MAAM,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE,GAAG,OAAO,CAAC;IAC7C,MAAM,MAAM,GAAG,IAAA,mCAAsB,EAAC,aAAa,CAAC,CAAC;IAErD,OAAO,SAAS,iCAAiC,CAC/C,OAAuC,EACvC,QAAyC,EACzC,IAAiC;QAEjC,MAAM,WAAW,GAAG;YAClB,OAAO,EAAE,iBAAiB,CAAC,OAAO,CAAC;YACnC,GAAG,EAAE,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC;SACvC,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,WAAW,CAAC,EAAE,CAAC;YAC3C,IAAI,EAAE,CAAC;YAEP,OAAO;QACT,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE;YAC3B,MAAM,CAAC,YAAY,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;QACnE,CAAC,CAAC,CAAC;QAEH,IAAI,EAAE,CAAC;IACT,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAuC;IAChE,OAAO;QACL,GAAG,CAAC,IAAI;YACN,OAAO,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAClC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAuC,EAAE,gBAAyB;IAC1F,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC;IAEvD,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,WAAW,EAAE,gBAAgB,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IACxF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,WAAW,CAAC;IACrB,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAuC;IAC/D,MAAM,QAAQ,GAAG,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,CAAC,IAAI,OAAO,CAAC,QAAQ,IAAI,MAAM,CAAC;IAChG,MAAM,IAAI,GACR,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,CAAC,IAAI,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,WAAW,CAAC;IAE/F,OAAO,GAAG,QAAQ,MAAM,IAAI,EAAE,CAAC;AACjC,CAAC;AAED,SAAS,SAAS,CAAC,OAAuC,EAAE,IAAY;IACtE,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;AACjF,CAAC;AAED,SAAS,kBAAkB,CAAC,OAAuC,EAAE,IAAY;IAC/E,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAEvC,OAAO,KAAK,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC;AACjD,CAAC;AAED,SAAS,WAAW,CAAC,KAAkB;IACrC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAC5B,CAAC"}