@apitap/core 1.0.0

package/dist/capture/body-variables.js

@@ -0,0 +1,142 @@
+// src/capture/body-variables.ts
+// Strategy 2: Name-based heuristics — keys implying dynamic values
+const DYNAMIC_KEY_PATTERNS = [
+    // Time
+    /timestamp/i, /\btime\b/i, /\bdate\b/i, /created[_-]?at/i, /updated[_-]?at/i,
+    /\bsince\b/i, /\buntil\b/i, /\bbefore\b/i, /\bafter\b/i, /\bexpires?\b/i,
+    // Pagination
+    /\bcursor\b/i, /\boffset\b/i, /\bpage\b/i, /page[_-]?number/i,
+    /next[_-]?token/i, /continuation/i,
+    // Identity
+    /request[_-]?id/i, /correlation[_-]?id/i, /trace[_-]?id/i,
+    /\bnonce\b/i, /idempotency[_-]?key/i,
+    // Session
+    /session[_-]?id/i, /\bcsrf\b/i, /\bxsrf\b/i,
+    // Geolocation
+    /\bgeo(code|loc(ation)?)\b/i, /\blat(itude)?\b/i, /\blo?ng(itude)?\b/i,
+    /\bcoord/i, /\bzip\b/i, /\bpostal/i,
+    // Search / user input
+    /\bquery\b/i, /\bsearch/i, /\bkeyword/i, /\bterm\b/i, /\bfilter\b/i,
+];
+function isDynamicKeyName(key) {
+    return DYNAMIC_KEY_PATTERNS.some(p => p.test(key));
+}
+// Strategy 3: Pattern-based detection — value patterns implying dynamic data
+function isTimestampOrPattern(value) {
+    if (typeof value === 'number') {
+        // Unix epoch seconds (roughly 2001–2603)
+        if (Number.isInteger(value) && value >= 1e9 && value < 2e10)
+            return true;
+        // Unix epoch milliseconds
+        if (Number.isInteger(value) && value >= 1e12 && value < 2e13)
+            return true;
+        return false;
+    }
+    // ISO 8601 datetime
+    if (/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}/.test(value))
+        return true;
+    // ISO 8601 date only
+    if (/^\d{4}-\d{2}-\d{2}$/.test(value))
+        return true;
+    // Prefixed IDs (req_xxx, id_xxx, txn_xxx, msg_xxx, evt_xxx)
+    if (/^(req|id|txn|msg|evt)_[a-zA-Z0-9]+$/.test(value))
+        return true;
+    return false;
+}
+/**
+ * Detect which fields in a JSON body are likely dynamic variables.
+ * Uses three strategies:
+ *   Strategy 1 (cross-request diffing) is in body-diff.ts
+ *   Strategy 2: Name-based key heuristics
+ *   Strategy 3: Pattern-based value detection
+ *   Plus existing: numeric values, UUIDs, base64 cursors, numeric strings
+ */
+export function detectBodyVariables(body, prefix = '') {
+    if (!body || typeof body !== 'object' || Array.isArray(body)) {
+        return [];
+    }
+    const detected = [];
+    const obj = body;
+    for (const [key, value] of Object.entries(obj)) {
+        const path = prefix ? `${prefix}.${key}` : key;
+        // Strategy 2: key name implies dynamic value
+        if (isDynamicKeyName(key) && value != null) {
+            detected.push(path);
+            continue;
+        }
+        if (typeof value === 'number') {
+            // Strategy 3: epoch timestamp detection
+            if (isTimestampOrPattern(value)) {
+                detected.push(path);
+            }
+            else {
+                // Original: numeric values are often IDs
+                detected.push(path);
+            }
+        }
+        else if (typeof value === 'string') {
+            // Strategy 3: timestamp/pattern detection (checked first, catches more)
+            if (isTimestampOrPattern(value)) {
+                detected.push(path);
+            }
+            else if (isLikelyDynamic(value)) {
+                detected.push(path);
+            }
+        }
+        else if (value && typeof value === 'object' && !Array.isArray(value)) {
+            // Recurse into nested objects
+            detected.push(...detectBodyVariables(value, path));
+        }
+    }
+    return detected;
+}
+function isLikelyDynamic(value) {
+    // UUID
+    if (/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(value)) {
+        return true;
+    }
+    // Base64-ish cursor (long alphanumeric with optional padding)
+    if (value.length > 15 && /^[a-zA-Z0-9+/=_-]+$/.test(value)) {
+        return true;
+    }
+    // Numeric string (ID)
+    if (/^\d{4,}$/.test(value)) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Substitute variables in a body template.
+ */
+export function substituteBodyVariables(template, values) {
+    if (typeof template === 'string') {
+        // String template with :param placeholders
+        return template.replace(/:([a-zA-Z_][a-zA-Z0-9_]*)/g, (match, name) => {
+            return values[name] ?? match;
+        });
+    }
+    // Deep clone and substitute
+    const result = JSON.parse(JSON.stringify(template));
+    for (const [path, value] of Object.entries(values)) {
+        setNestedValue(result, path, value);
+    }
+    return result;
+}
+function setNestedValue(obj, path, value) {
+    const parts = path.split('.');
+    let current = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const part = parts[i];
+        if (current[part] && typeof current[part] === 'object') {
+            current = current[part];
+        }
+        else {
+            return; // Path doesn't exist
+        }
+    }
+    const lastPart = parts[parts.length - 1];
+    if (lastPart in current) {
+        current[lastPart] = value;
+    }
+}
+//# sourceMappingURL=body-variables.js.map

package/dist/capture/body-variables.js.map

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

package/dist/capture/domain.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Check if a hostname matches the target domain.
+ * Uses dot-prefix matching to prevent evil-example.com matching example.com.
+ *
+ * @param hostname - The hostname to check (e.g. "api.example.com")
+ * @param target - The target domain or URL (e.g. "example.com" or "https://example.com/path")
+ */
+export declare function isDomainMatch(hostname: string, target: string): boolean;

package/dist/capture/domain.js

@@ -0,0 +1,34 @@
+// src/capture/domain.ts
+/**
+ * Check if a hostname matches the target domain.
+ * Uses dot-prefix matching to prevent evil-example.com matching example.com.
+ *
+ * @param hostname - The hostname to check (e.g. "api.example.com")
+ * @param target - The target domain or URL (e.g. "example.com" or "https://example.com/path")
+ */
+export function isDomainMatch(hostname, target) {
+    // Extract hostname from URL if target looks like a URL
+    let targetHost;
+    try {
+        if (target.includes('://')) {
+            targetHost = new URL(target).hostname;
+        }
+        else {
+            targetHost = target;
+        }
+    }
+    catch {
+        targetHost = target;
+    }
+    // Strip www. prefix from target for broader matching
+    if (targetHost.startsWith('www.')) {
+        targetHost = targetHost.slice(4);
+    }
+    // Exact match
+    if (hostname === targetHost)
+        return true;
+    // Dot-prefix suffix match: hostname must end with ".targetHost"
+    // This prevents evil-example.com from matching example.com
+    return hostname.endsWith('.' + targetHost);
+}
+//# sourceMappingURL=domain.js.map

package/dist/capture/domain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.js","sourceRoot":"","sources":["../../src/capture/domain.ts"],"names":[],"mappings":"AAAA,wBAAwB;AAExB;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,MAAc;IAC5D,uDAAuD;IACvD,IAAI,UAAkB,CAAC;IACvB,IAAI,CAAC;QACH,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,UAAU,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,UAAU,GAAG,MAAM,CAAC;QACtB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,UAAU,GAAG,MAAM,CAAC;IACtB,CAAC;IAED,qDAAqD;IACrD,IAAI,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAClC,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC;IAED,cAAc;IACd,IAAI,QAAQ,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC;IAEzC,gEAAgE;IAChE,2DAA2D;IAC3D,OAAO,QAAQ,CAAC,QAAQ,CAAC,GAAG,GAAG,UAAU,CAAC,CAAC;AAC7C,CAAC"}

package/dist/capture/entropy.d.ts

@@ -0,0 +1,33 @@
+export interface TokenClassification {
+    isToken: boolean;
+    confidence: 'high' | 'medium';
+    format: 'jwt' | 'opaque';
+    jwtClaims?: JwtClaims;
+}
+export interface JwtClaims {
+    exp?: number;
+    iat?: number;
+    iss?: string;
+    aud?: string;
+    scope?: string;
+}
+/**
+ * Calculate Shannon entropy (bits per character) of a string.
+ * Higher values indicate more randomness.
+ */
+export declare function shannonEntropy(value: string): number;
+/**
+ * Parse JWT claims from a token string.
+ * Returns null if not a valid JWT structure.
+ */
+export declare function parseJwtClaims(token: string): JwtClaims | null;
+/**
+ * Classify whether a header/cookie value is likely an auth token.
+ *
+ * Detection hierarchy:
+ * 1. JWT (eyJ prefix, 2 dots) → decode and classify with rich metadata
+ * 2. UUID → skip (entity ID, not token)
+ * 3. Short values (<16 chars) → skip
+ * 4. High-entropy opaque string → classify by entropy threshold
+ */
+export declare function isLikelyToken(name: string, value: string): TokenClassification;

package/dist/capture/entropy.js

@@ -0,0 +1,100 @@
+// src/capture/entropy.ts
+const MIN_TOKEN_LENGTH = 16;
+const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/**
+ * Calculate Shannon entropy (bits per character) of a string.
+ * Higher values indicate more randomness.
+ */
+export function shannonEntropy(value) {
+    if (value.length === 0)
+        return 0;
+    const freq = new Map();
+    for (const ch of value) {
+        freq.set(ch, (freq.get(ch) ?? 0) + 1);
+    }
+    let entropy = 0;
+    const len = value.length;
+    for (const count of freq.values()) {
+        const p = count / len;
+        entropy -= p * Math.log2(p);
+    }
+    return entropy;
+}
+/**
+ * Parse JWT claims from a token string.
+ * Returns null if not a valid JWT structure.
+ */
+export function parseJwtClaims(token) {
+    // JWT: starts with eyJ, has exactly 2 dots
+    if (!token.startsWith('eyJ'))
+        return null;
+    const parts = token.split('.');
+    if (parts.length !== 3)
+        return null;
+    try {
+        // Decode payload (second part), base64url → JSON
+        const payload = parts[1];
+        const padded = payload.replace(/-/g, '+').replace(/_/g, '/');
+        const json = Buffer.from(padded, 'base64').toString('utf-8');
+        const claims = JSON.parse(json);
+        if (typeof claims !== 'object' || claims === null)
+            return null;
+        const result = {};
+        if (typeof claims.exp === 'number')
+            result.exp = claims.exp;
+        if (typeof claims.iat === 'number')
+            result.iat = claims.iat;
+        if (typeof claims.iss === 'string')
+            result.iss = claims.iss;
+        if (typeof claims.aud === 'string')
+            result.aud = claims.aud;
+        if (typeof claims.scope === 'string')
+            result.scope = claims.scope;
+        return result;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Classify whether a header/cookie value is likely an auth token.
+ *
+ * Detection hierarchy:
+ * 1. JWT (eyJ prefix, 2 dots) → decode and classify with rich metadata
+ * 2. UUID → skip (entity ID, not token)
+ * 3. Short values (<16 chars) → skip
+ * 4. High-entropy opaque string → classify by entropy threshold
+ */
+export function isLikelyToken(name, value) {
+    // Strip "Bearer " prefix for analysis
+    const raw = value.startsWith('Bearer ') ? value.slice(7) : value;
+    // JWT detection — takes priority
+    const jwtClaims = parseJwtClaims(raw);
+    if (jwtClaims) {
+        return {
+            isToken: true,
+            confidence: 'high',
+            format: 'jwt',
+            jwtClaims,
+        };
+    }
+    // UUID exclusion — almost always entity IDs, not tokens
+    if (UUID_PATTERN.test(raw)) {
+        return { isToken: false, confidence: 'medium', format: 'opaque' };
+    }
+    // Minimum length gate
+    if (raw.length < MIN_TOKEN_LENGTH) {
+        return { isToken: false, confidence: 'medium', format: 'opaque' };
+    }
+    // Entropy-based classification
+    const entropy = shannonEntropy(raw);
+    if (entropy >= 4.5) {
+        return { isToken: true, confidence: 'high', format: 'opaque' };
+    }
+    if (entropy >= 3.5) {
+        return { isToken: true, confidence: 'medium', format: 'opaque' };
+    }
+    // Below threshold — not a token
+    return { isToken: false, confidence: 'medium', format: 'opaque' };
+}
+//# sourceMappingURL=entropy.js.map

package/dist/capture/entropy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entropy.js","sourceRoot":"","sources":["../../src/capture/entropy.ts"],"names":[],"mappings":"AAAA,yBAAyB;AAEzB,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAC5B,MAAM,YAAY,GAAG,iEAAiE,CAAC;AAiBvF;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAEjC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvC,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC;IACzB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QAClC,MAAM,CAAC,GAAG,KAAK,GAAG,GAAG,CAAC;QACtB,OAAO,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,2CAA2C;IAC3C,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEpC,IAAI,CAAC;QACH,iDAAiD;QACjD,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEhC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAE/D,MAAM,MAAM,GAAc,EAAE,CAAC;QAC7B,IAAI,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ;YAAE,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;QAC5D,IAAI,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ;YAAE,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;QAC5D,IAAI,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ;YAAE,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;QAC5D,IAAI,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ;YAAE,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;QAC5D,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ;YAAE,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAElE,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,KAAa;IACvD,sCAAsC;IACtC,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAEjE,iCAAiC;IACjC,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,SAAS,EAAE,CAAC;QACd,OAAO;YACL,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,MAAM;YAClB,MAAM,EAAE,KAAK;YACb,SAAS;SACV,CAAC;IACJ,CAAC;IAED,wDAAwD;IACxD,IAAI,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IACpE,CAAC;IAED,sBAAsB;IACtB,IAAI,GAAG,CAAC,MAAM,GAAG,gBAAgB,EAAE,CAAC;QAClC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IACpE,CAAC;IAED,+BAA+B;IAC/B,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IAEpC,IAAI,OAAO,IAAI,GAAG,EAAE,CAAC;QACnB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IACjE,CAAC;IACD,IAAI,OAAO,IAAI,GAAG,EAAE,CAAC;QACnB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnE,CAAC;IAED,gCAAgC;IAChC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AACpE,CAAC"}

package/dist/capture/filter.d.ts

@@ -0,0 +1,11 @@
+export interface FilterableResponse {
+    url: string;
+    status: number;
+    contentType: string;
+}
+/**
+ * Check if a URL path is framework or telemetry noise.
+ * Exported for testing.
+ */
+export declare function isPathNoise(pathname: string): boolean;
+export declare function shouldCapture(response: FilterableResponse): boolean;

package/dist/capture/filter.js

@@ -0,0 +1,49 @@
+// src/capture/filter.ts
+import { isBlocklisted } from './blocklist.js';
+const JSON_CONTENT_TYPES = [
+    'application/json',
+    'application/vnd.api+json',
+    'text/json',
+];
+/** Exact path matches that are telemetry/framework noise */
+const NOISE_PATHS = new Set([
+    '/monitoring',
+    '/telemetry',
+    '/track',
+    '/manifest.json',
+]);
+/**
+ * Check if a URL path is framework or telemetry noise.
+ * Exported for testing.
+ */
+export function isPathNoise(pathname) {
+    // Exact match noise paths
+    if (NOISE_PATHS.has(pathname))
+        return true;
+    // Next.js static build assets (not data routes)
+    if (pathname.startsWith('/_next/static/'))
+        return true;
+    return false;
+}
+export function shouldCapture(response) {
+    // Only keep 2xx success responses
+    if (response.status < 200 || response.status >= 300)
+        return false;
+    // Content-type must indicate JSON
+    const ct = response.contentType.toLowerCase().split(';')[0].trim();
+    if (!JSON_CONTENT_TYPES.some(t => ct === t))
+        return false;
+    // Check domain and path
+    try {
+        const url = new URL(response.url);
+        if (isBlocklisted(url.hostname))
+            return false;
+        if (isPathNoise(url.pathname))
+            return false;
+    }
+    catch {
+        return false;
+    }
+    return true;
+}
+//# sourceMappingURL=filter.js.map

package/dist/capture/filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../src/capture/filter.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAQ/C,MAAM,kBAAkB,GAAG;IACzB,kBAAkB;IAClB,0BAA0B;IAC1B,WAAW;CACZ,CAAC;AAEF,4DAA4D;AAC5D,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;IAC1B,aAAa;IACb,YAAY;IACZ,QAAQ;IACR,gBAAgB;CACjB,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,0BAA0B;IAC1B,IAAI,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAE3C,gDAAgD;IAChD,IAAI,QAAQ,CAAC,UAAU,CAAC,gBAAgB,CAAC;QAAE,OAAO,IAAI,CAAC;IAEvD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAA4B;IACxD,kCAAkC;IAClC,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,KAAK,CAAC;IAElE,kCAAkC;IAClC,MAAM,EAAE,GAAG,QAAQ,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACnE,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAE1D,wBAAwB;IACxB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,OAAO,KAAK,CAAC;QAC9C,IAAI,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,OAAO,KAAK,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/capture/graphql.d.ts

@@ -0,0 +1,21 @@
+export interface GraphQLParsed {
+    operationName: string | null;
+    query: string;
+    variables: Record<string, unknown> | null;
+}
+/**
+ * Detect if a request is to a GraphQL endpoint.
+ */
+export declare function isGraphQLEndpoint(path: string, contentType: string, body: string | null): boolean;
+/**
+ * Parse a GraphQL request body.
+ */
+export declare function parseGraphQLBody(body: string): GraphQLParsed | null;
+/**
+ * Extract operation name from query string or explicit operationName.
+ */
+export declare function extractOperationName(query: string, explicitName: string | null): string;
+/**
+ * Detect which variables are likely dynamic (IDs, cursors, pagination).
+ */
+export declare function detectGraphQLVariables(variables: Record<string, unknown> | null, prefix?: string): string[];

package/dist/capture/graphql.js

@@ -0,0 +1,99 @@
+// src/capture/graphql.ts
+/**
+ * Detect if a request is to a GraphQL endpoint.
+ */
+export function isGraphQLEndpoint(path, contentType, body) {
+    // Path contains /graphql
+    if (path.includes('/graphql')) {
+        return true;
+    }
+    // Content-Type is application/graphql
+    if (contentType.includes('application/graphql')) {
+        return true;
+    }
+    // Body contains a "query" field (GraphQL-style)
+    if (body) {
+        try {
+            const parsed = JSON.parse(body);
+            if (typeof parsed.query === 'string') {
+                return true;
+            }
+        }
+        catch {
+            // Not JSON
+        }
+    }
+    return false;
+}
+/**
+ * Parse a GraphQL request body.
+ */
+export function parseGraphQLBody(body) {
+    try {
+        const parsed = JSON.parse(body);
+        if (typeof parsed.query !== 'string') {
+            return null;
+        }
+        return {
+            operationName: parsed.operationName ?? null,
+            query: parsed.query,
+            variables: parsed.variables ?? null,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Extract operation name from query string or explicit operationName.
+ */
+export function extractOperationName(query, explicitName) {
+    if (explicitName) {
+        return explicitName;
+    }
+    // Match "query Name" or "mutation Name" at start
+    const match = query.match(/^\s*(query|mutation|subscription)\s+(\w+)/);
+    if (match) {
+        return match[2];
+    }
+    return 'Anonymous';
+}
+/**
+ * Detect which variables are likely dynamic (IDs, cursors, pagination).
+ */
+export function detectGraphQLVariables(variables, prefix = '') {
+    if (!variables || typeof variables !== 'object') {
+        return [];
+    }
+    const detected = [];
+    for (const [key, value] of Object.entries(variables)) {
+        const path = prefix ? `${prefix}.${key}` : key;
+        if (typeof value === 'number') {
+            // Numbers are often IDs or pagination values
+            detected.push(path);
+        }
+        else if (typeof value === 'string') {
+            // Cursor-like strings (base64, long alphanumeric)
+            if (isLikelyCursor(value)) {
+                detected.push(path);
+            }
+        }
+        else if (value && typeof value === 'object' && !Array.isArray(value)) {
+            // Recurse into nested objects
+            detected.push(...detectGraphQLVariables(value, path));
+        }
+    }
+    return detected;
+}
+function isLikelyCursor(value) {
+    // Base64-ish: long alphanumeric, possibly with = padding
+    if (value.length > 10 && /^[a-zA-Z0-9+/=_-]+$/.test(value)) {
+        return true;
+    }
+    // UUID-like
+    if (/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(value)) {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=graphql.js.map

package/dist/capture/graphql.js.map

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

package/dist/capture/idle.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Tracks unique endpoint discoveries and detects idle periods.
+ * Used during interactive capture to nudge the user when no new
+ * endpoints have been found for a while.
+ */
+export declare class IdleTracker {
+    private seen;
+    private lastNewTime;
+    private thresholdMs;
+    private fired;
+    private now;
+    constructor(thresholdMs?: number, now?: () => number);
+    /**
+     * Record an endpoint key (e.g. "GET /api/items").
+     * Returns true if it's genuinely new (not seen before).
+     */
+    recordEndpoint(key: string): boolean;
+    /**
+     * Check if the idle threshold has been exceeded.
+     * Returns true exactly once per idle period (until reset by a new endpoint).
+     */
+    checkIdle(): boolean;
+}

package/dist/capture/idle.js

@@ -0,0 +1,44 @@
+// src/capture/idle.ts
+/**
+ * Tracks unique endpoint discoveries and detects idle periods.
+ * Used during interactive capture to nudge the user when no new
+ * endpoints have been found for a while.
+ */
+export class IdleTracker {
+    seen = new Set();
+    lastNewTime;
+    thresholdMs;
+    fired = false;
+    now;
+    constructor(thresholdMs = 15000, now = Date.now) {
+        this.thresholdMs = thresholdMs;
+        this.now = now;
+        this.lastNewTime = this.now();
+    }
+    /**
+     * Record an endpoint key (e.g. "GET /api/items").
+     * Returns true if it's genuinely new (not seen before).
+     */
+    recordEndpoint(key) {
+        if (this.seen.has(key))
+            return false;
+        this.seen.add(key);
+        this.lastNewTime = this.now();
+        this.fired = false;
+        return true;
+    }
+    /**
+     * Check if the idle threshold has been exceeded.
+     * Returns true exactly once per idle period (until reset by a new endpoint).
+     */
+    checkIdle() {
+        if (this.fired)
+            return false;
+        if (this.now() - this.lastNewTime >= this.thresholdMs) {
+            this.fired = true;
+            return true;
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=idle.js.map

package/dist/capture/idle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idle.js","sourceRoot":"","sources":["../../src/capture/idle.ts"],"names":[],"mappings":"AAAA,sBAAsB;AAEtB;;;;GAIG;AACH,MAAM,OAAO,WAAW;IACd,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IACzB,WAAW,CAAS;IACpB,WAAW,CAAS;IACpB,KAAK,GAAG,KAAK,CAAC;IACd,GAAG,CAAe;IAE1B,YAAY,WAAW,GAAG,KAAK,EAAE,MAAoB,IAAI,CAAC,GAAG;QAC3D,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAChC,CAAC;IAED;;;OAGG;IACH,cAAc,CAAC,GAAW;QACxB,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,SAAS;QACP,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QAC7B,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACtD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YAClB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/capture/monitor.d.ts

@@ -0,0 +1,26 @@
+import { SkillGenerator } from '../skill/generator.js';
+export interface CaptureOptions {
+    url: string;
+    port?: number;
+    launch?: boolean;
+    attach?: boolean;
+    headless?: boolean;
+    duration?: number;
+    allDomains?: boolean;
+    enablePreview?: boolean;
+    scrub?: boolean;
+    onEndpoint?: (endpoint: {
+        id: string;
+        method: string;
+        path: string;
+    }) => void;
+    onFiltered?: () => void;
+    onIdle?: () => void;
+}
+export interface CaptureResult {
+    generators: Map<string, SkillGenerator>;
+    totalRequests: number;
+    filteredRequests: number;
+    domBytes?: number;
+}
+export declare function capture(options: CaptureOptions): Promise<CaptureResult>;