mnehmos.trace.mcp 1.0.0

package/dist/patterns/http-clients/url-extractor.js

@@ -0,0 +1,338 @@
+/**
+ * URL Extraction Utilities
+ *
+ * Extract URL information from AST nodes for HTTP client calls.
+ * Handles static strings, template literals, variable references,
+ * and string concatenation.
+ *
+ * @module patterns/http-clients/url-extractor
+ * @see .context/ADR-P2-3-HTTP-CLIENT-TRACING.md
+ */
+import { Node, SyntaxKind } from 'ts-morph';
+/* ═══════════════════════════════════════════════════════════════════════════
+ * 🔗 Public API
+ * ═══════════════════════════════════════════════════════════════════════════ */
+/**
+ * Extract URL information from an AST node.
+ *
+ * Handles:
+ * - String literals: `'/api/users'`
+ * - Template literals: `` `/api/users/${id}` ``
+ * - Variable references: `API_URL`
+ * - Concatenation: `baseUrl + '/users'`
+ *
+ * @param node - The AST node to extract URL from
+ * @returns URLExtractionResult or undefined if not extractable
+ *
+ * @example
+ * ```typescript
+ * const urlNode = callExpr.getArguments()[0];
+ * const result = extractURL(urlNode);
+ * // { raw: '/api/users', static: '/api/users', isDynamic: false }
+ * ```
+ */
+export function extractURL(node) {
+    if (!node)
+        return undefined;
+    // Handle string literals
+    if (Node.isStringLiteral(node)) {
+        const value = node.getLiteralValue();
+        return parseStaticURL(value);
+    }
+    // Handle no-substitution template literals (static templates)
+    if (Node.isNoSubstitutionTemplateLiteral(node)) {
+        const value = node.getLiteralValue();
+        return parseStaticURL(value);
+    }
+    // Handle template expressions with substitutions
+    if (Node.isTemplateExpression(node)) {
+        return parseTemplateExpression(node);
+    }
+    // Handle identifier references (variable names)
+    if (Node.isIdentifier(node)) {
+        return resolveIdentifier(node);
+    }
+    // Handle binary expressions (concatenation)
+    if (Node.isBinaryExpression(node)) {
+        return parseBinaryExpression(node);
+    }
+    // Handle call expressions like URL.toString()
+    if (Node.isCallExpression(node)) {
+        const expr = node.getExpression();
+        if (Node.isPropertyAccessExpression(expr)) {
+            const methodName = expr.getName();
+            if (methodName === 'toString') {
+                // URL object's toString() - mark as dynamic
+                return {
+                    raw: 'URL.toString()',
+                    isDynamic: true,
+                    pathParams: [],
+                    queryParams: [],
+                };
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * Compose a baseURL with a path.
+ *
+ * Handles:
+ * - Trailing slashes in baseURL
+ * - Missing leading slashes in path
+ * - Full URL baseURLs
+ *
+ * @param baseURL - Base URL (e.g., '/api' or 'https://api.example.com')
+ * @param path - Path to append (e.g., '/users' or 'users')
+ * @returns Composed URL
+ *
+ * @example
+ * ```typescript
+ * composeURL('/api', '/users')           // '/api/users'
+ * composeURL('/api/', 'users')           // '/api/users'
+ * composeURL('https://api.com', '/users') // 'https://api.com/users'
+ * ```
+ */
+export function composeURL(baseURL, path) {
+    // Normalize base URL - remove trailing slash
+    const normalizedBase = baseURL.replace(/\/+$/, '');
+    // Normalize path - ensure leading slash
+    const normalizedPath = path.startsWith('/') ? path : `/${path}`;
+    return normalizedBase + normalizedPath;
+}
+/* ═══════════════════════════════════════════════════════════════════════════
+ * 🔧 Static URL Parsing
+ * ═══════════════════════════════════════════════════════════════════════════ */
+/**
+ * Parse a static URL string and extract path/query params.
+ *
+ * @internal
+ */
+function parseStaticURL(url) {
+    const pathParams = [];
+    const queryParams = [];
+    // Check for Express-style path params like :userId
+    const expressParamRegex = /:(\w+)/g;
+    let match;
+    while ((match = expressParamRegex.exec(url)) !== null) {
+        pathParams.push(match[1]);
+    }
+    // Extract query parameters
+    const queryIndex = url.indexOf('?');
+    if (queryIndex !== -1) {
+        const queryString = url.slice(queryIndex + 1);
+        const params = queryString.split('&');
+        for (const param of params) {
+            const [key] = param.split('=');
+            if (key) {
+                // Remove any template placeholders in query param names
+                const cleanKey = key.replace(/\$\{[^}]+\}/, '').trim();
+                if (cleanKey) {
+                    queryParams.push(cleanKey);
+                }
+            }
+        }
+    }
+    const hasExpressParams = pathParams.length > 0;
+    return {
+        raw: url,
+        static: hasExpressParams ? undefined : url,
+        isDynamic: hasExpressParams,
+        pattern: hasExpressParams ? url : undefined,
+        pathParams: pathParams.length > 0 ? pathParams : undefined,
+        queryParams: queryParams.length > 0 ? queryParams : undefined,
+    };
+}
+/* ═══════════════════════════════════════════════════════════════════════════
+ * 📝 Template Expression Parsing
+ * ═══════════════════════════════════════════════════════════════════════════ */
+/**
+ * Get the literal text from a template head/middle/tail node.
+ *
+ * @internal
+ */
+function getTemplatePartText(node) {
+    // Use getText() and strip the template delimiters
+    const text = node.getText();
+    // TemplateHead: `text${  -> extract "text"
+    // TemplateMiddle: }text${  -> extract "text"
+    // TemplateTail: }text`  -> extract "text"
+    // Remove leading ` or }
+    let result = text;
+    if (result.startsWith('`')) {
+        result = result.slice(1);
+    }
+    else if (result.startsWith('}')) {
+        result = result.slice(1);
+    }
+    // Remove trailing ${ or `
+    if (result.endsWith('${')) {
+        result = result.slice(0, -2);
+    }
+    else if (result.endsWith('`')) {
+        result = result.slice(0, -1);
+    }
+    return result;
+}
+/**
+ * Parse a template expression with substitutions.
+ *
+ * @internal
+ */
+function parseTemplateExpression(node) {
+    if (!Node.isTemplateExpression(node))
+        return { raw: '', isDynamic: true };
+    const head = node.getHead();
+    const spans = node.getTemplateSpans();
+    let pattern = getTemplatePartText(head);
+    const pathParams = [];
+    const queryParams = [];
+    for (const span of spans) {
+        const expr = span.getExpression();
+        let paramName = 'param';
+        // Try to extract parameter name from expression
+        if (Node.isIdentifier(expr)) {
+            paramName = expr.getText();
+        }
+        else if (Node.isPropertyAccessExpression(expr)) {
+            // Get the property name: user.id -> id
+            paramName = expr.getName();
+        }
+        else if (Node.isElementAccessExpression(expr)) {
+            // Get array index identifier if possible
+            const argExpr = expr.getArgumentExpression();
+            if (argExpr && Node.isNumericLiteral(argExpr)) {
+                paramName = `item${argExpr.getText()}`;
+            }
+        }
+        // Check if we're in query params section
+        const literal = span.getLiteral();
+        const literalText = getTemplatePartText(literal);
+        const isInQuerySection = pattern.includes('?') || literalText.includes('?');
+        if (isInQuerySection && !pattern.includes('?')) {
+            // We're adding a query param
+            const beforeQuestion = literalText.indexOf('?');
+            if (beforeQuestion !== -1) {
+                pattern += `:${paramName}` + literalText.slice(0, beforeQuestion + 1);
+                pathParams.push(paramName);
+                // Continue parsing query params
+                const afterQuestion = literalText.slice(beforeQuestion + 1);
+                if (afterQuestion.includes('=')) {
+                    const queryKey = afterQuestion.split('=')[0];
+                    if (queryKey)
+                        queryParams.push(queryKey);
+                }
+                pattern += afterQuestion;
+            }
+            else {
+                pattern += `:${paramName}` + literalText;
+                queryParams.push(paramName);
+            }
+        }
+        else {
+            pattern += `:${paramName}` + literalText;
+            pathParams.push(paramName);
+        }
+        // Extract any query params from literal text
+        const queryMatch = literalText.match(/[?&](\w+)=/g);
+        if (queryMatch) {
+            for (const q of queryMatch) {
+                const key = q.replace(/[?&=]/g, '');
+                if (key && !queryParams.includes(key)) {
+                    queryParams.push(key);
+                }
+            }
+        }
+    }
+    // Build the raw template string representation
+    const rawParts = [getTemplatePartText(head)];
+    for (const span of spans) {
+        rawParts.push('${', span.getExpression().getText(), '}');
+        rawParts.push(getTemplatePartText(span.getLiteral()));
+    }
+    const raw = rawParts.join('');
+    return {
+        raw,
+        isDynamic: true,
+        pattern,
+        pathParams: pathParams.length > 0 ? pathParams : undefined,
+        queryParams: queryParams.length > 0 ? queryParams : undefined,
+    };
+}
+/* ═══════════════════════════════════════════════════════════════════════════
+ * 🔍 Identifier Resolution
+ * ═══════════════════════════════════════════════════════════════════════════ */
+/**
+ * Resolve an identifier to its value.
+ *
+ * @internal
+ */
+function resolveIdentifier(node) {
+    if (!Node.isIdentifier(node))
+        return undefined;
+    const name = node.getText();
+    const symbol = node.getSymbol();
+    if (!symbol) {
+        return {
+            raw: name,
+            isDynamic: true,
+            pathParams: [],
+        };
+    }
+    // Try to find the variable declaration
+    const declarations = symbol.getDeclarations();
+    for (const decl of declarations) {
+        if (Node.isVariableDeclaration(decl)) {
+            const initializer = decl.getInitializer();
+            if (initializer) {
+                const result = extractURL(initializer);
+                if (result)
+                    return result;
+            }
+        }
+    }
+    return {
+        raw: name,
+        isDynamic: true,
+        pathParams: [],
+    };
+}
+/* ═══════════════════════════════════════════════════════════════════════════
+ * ➕ Binary Expression Parsing
+ * ═══════════════════════════════════════════════════════════════════════════ */
+/**
+ * Parse binary expression (concatenation).
+ *
+ * @internal
+ */
+function parseBinaryExpression(node) {
+    if (!Node.isBinaryExpression(node))
+        return undefined;
+    const operator = node.getOperatorToken().getKind();
+    if (operator !== SyntaxKind.PlusToken)
+        return undefined;
+    const left = extractURL(node.getLeft());
+    const right = extractURL(node.getRight());
+    if (!left && !right) {
+        return {
+            raw: node.getText(),
+            isDynamic: true,
+            pathParams: [],
+        };
+    }
+    const leftRaw = left?.raw || node.getLeft().getText();
+    const rightRaw = right?.raw || node.getRight().getText();
+    return {
+        raw: leftRaw + rightRaw,
+        isDynamic: true,
+        pathParams: [
+            ...(left?.pathParams || []),
+            ...(right?.pathParams || []),
+        ],
+        queryParams: [
+            ...(left?.queryParams || []),
+            ...(right?.queryParams || []),
+        ],
+    };
+}
+//# sourceMappingURL=url-extractor.js.map

package/dist/patterns/http-clients/url-extractor.js.map

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

package/dist/patterns/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Pattern Matcher Module
+ *
+ * Public API for the pattern matcher abstraction that enables pluggable
+ * framework-agnostic API detection.
+ *
+ * ## Overview
+ *
+ * The pattern matcher system provides:
+ * - **Type Definitions**: Core types for pattern matching ({@link PatternType}, {@link PatternDef})
+ * - **Error Handling**: Typed errors with machine-readable codes ({@link PatternErrorCodes})
+ * - **Base Classes**: Abstract base for custom matchers ({@link BasePatternMatcher})
+ * - **Registry**: Singleton registry for pattern matchers ({@link registerPattern}, {@link scanForPatterns})
+ * - **Extractors**: Schema extraction utilities ({@link extractSchemaNode})
+ *
+ * ## Quick Start
+ *
+ * ```typescript
+ * import {
+ *   registerPattern,
+ *   scanForPatterns,
+ *   BasePatternMatcher
+ * } from './patterns';
+ *
+ * // Register a custom matcher
+ * class MyMatcher extends BasePatternMatcher { ... }
+ * registerPattern(new MyMatcher());
+ *
+ * // Scan for patterns
+ * const matches = scanForPatterns(sourceFile);
+ * ```
+ *
+ * @module patterns
+ * @see .context/ADR-P2-1-PATTERN-MATCHER.md
+ */
+export type { PatternType, SchemaLocation, PatternDef, MatchCaptures, MatchResult, } from './types.js';
+export { PatternErrorCodes, PatternRegistryError, PatternNotFoundError, PatternValidationError, PatternMatchError, PatternExtractionError, } from './errors.js';
+export type { PatternErrorCode } from './errors.js';
+export type { PatternMatcher } from './base.js';
+export { BasePatternMatcher } from './base.js';
+export { registerPattern, getPattern, getPatternsByFramework, getPatternsByType, hasPattern, listPatterns, listFrameworks, scanForPatterns, } from './registry.js';
+export type { ScanOptions } from './registry.js';
+export { extractSchemaNode, extractFromArg, extractFromNamedArg, extractFromReturn, extractFromTypeParam, extractFromBody, extractFromChainMethod, extractFromDecoratorArg, } from './extractors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/patterns/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/patterns/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAMH,YAAY,EACV,WAAW,EACX,cAAc,EACd,UAAU,EACV,aAAa,EACb,WAAW,GACZ,MAAM,YAAY,CAAC;AAMpB,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAErB,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAMpD,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAM/C,OAAO,EACL,eAAe,EACf,UAAU,EACV,sBAAsB,EACtB,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,cAAc,EACd,eAAe,GAChB,MAAM,eAAe,CAAC;AAEvB,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAMjD,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC"}

package/dist/patterns/index.js

@@ -0,0 +1,49 @@
+/**
+ * Pattern Matcher Module
+ *
+ * Public API for the pattern matcher abstraction that enables pluggable
+ * framework-agnostic API detection.
+ *
+ * ## Overview
+ *
+ * The pattern matcher system provides:
+ * - **Type Definitions**: Core types for pattern matching ({@link PatternType}, {@link PatternDef})
+ * - **Error Handling**: Typed errors with machine-readable codes ({@link PatternErrorCodes})
+ * - **Base Classes**: Abstract base for custom matchers ({@link BasePatternMatcher})
+ * - **Registry**: Singleton registry for pattern matchers ({@link registerPattern}, {@link scanForPatterns})
+ * - **Extractors**: Schema extraction utilities ({@link extractSchemaNode})
+ *
+ * ## Quick Start
+ *
+ * ```typescript
+ * import {
+ *   registerPattern,
+ *   scanForPatterns,
+ *   BasePatternMatcher
+ * } from './patterns';
+ *
+ * // Register a custom matcher
+ * class MyMatcher extends BasePatternMatcher { ... }
+ * registerPattern(new MyMatcher());
+ *
+ * // Scan for patterns
+ * const matches = scanForPatterns(sourceFile);
+ * ```
+ *
+ * @module patterns
+ * @see .context/ADR-P2-1-PATTERN-MATCHER.md
+ */
+// ─────────────────────────────────────────────────────────────────────────────
+// ⚠️ Error Types and Codes
+// ─────────────────────────────────────────────────────────────────────────────
+export { PatternErrorCodes, PatternRegistryError, PatternNotFoundError, PatternValidationError, PatternMatchError, PatternExtractionError, } from './errors.js';
+export { BasePatternMatcher } from './base.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// 📝 Registry Functions
+// ─────────────────────────────────────────────────────────────────────────────
+export { registerPattern, getPattern, getPatternsByFramework, getPatternsByType, hasPattern, listPatterns, listFrameworks, scanForPatterns, } from './registry.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// 🔍 Schema Extractors
+// ─────────────────────────────────────────────────────────────────────────────
+export { extractSchemaNode, extractFromArg, extractFromNamedArg, extractFromReturn, extractFromTypeParam, extractFromBody, extractFromChainMethod, extractFromDecoratorArg, } from './extractors.js';
+//# sourceMappingURL=index.js.map

package/dist/patterns/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/patterns/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAcH,gFAAgF;AAChF,2BAA2B;AAC3B,gFAAgF;AAEhF,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AASrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,gFAAgF;AAChF,wBAAwB;AACxB,gFAAgF;AAEhF,OAAO,EACL,eAAe,EACf,UAAU,EACV,sBAAsB,EACtB,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,cAAc,EACd,eAAe,GAChB,MAAM,eAAe,CAAC;AAIvB,gFAAgF;AAChF,uBAAuB;AACvB,gFAAgF;AAEhF,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC"}

package/dist/patterns/python/aiohttp.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Python aiohttp library HTTP client detection
+ *
+ * Detects calls to the aiohttp library:
+ * - aiohttp.ClientSession().get(), etc.
+ * - session.get(), session.post() within context managers
+ *
+ * aiohttp is always async and uses context managers heavily
+ *
+ * @see .context/TASK_MAP_P3.md - Task P3-4
+ */
+import type { PythonHttpCall } from './types.js';
+/**
+ * Detect HTTP calls from the aiohttp library in Python source code
+ */
+export declare function detectAiohttpCalls(content: string): PythonHttpCall[];
+/**
+ * Get the response properties that aiohttp library supports
+ */
+export declare function getAiohttpResponseProperties(): string[];
+//# sourceMappingURL=aiohttp.d.ts.map

package/dist/patterns/python/aiohttp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiohttp.d.ts","sourceRoot":"","sources":["../../../src/patterns/python/aiohttp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,cAAc,EAGf,MAAM,YAAY,CAAC;AAUpB;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE,CAsFpE;AAiHD;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,EAAE,CAEvD"}

package/dist/patterns/python/aiohttp.js

@@ -0,0 +1,188 @@
+/**
+ * Python aiohttp library HTTP client detection
+ *
+ * Detects calls to the aiohttp library:
+ * - aiohttp.ClientSession().get(), etc.
+ * - session.get(), session.post() within context managers
+ *
+ * aiohttp is always async and uses context managers heavily
+ *
+ * @see .context/TASK_MAP_P3.md - Task P3-4
+ */
+import { HTTP_CLIENT_PATTERNS, normalizeHttpMethod } from './types.js';
+const AIOHTTP_PATTERN = HTTP_CLIENT_PATTERNS.aiohttp;
+/**
+ * Track known session variable names
+ */
+const sessionVars = new Set();
+/**
+ * Detect HTTP calls from the aiohttp library in Python source code
+ */
+export function detectAiohttpCalls(content) {
+    const calls = [];
+    const lines = content.split('\n');
+    // First pass: detect imports
+    const hasAiohttpImport = /^\s*import\s+aiohttp\b/m.test(content) ||
+        /^\s*from\s+aiohttp\s+import\s+/.test(content);
+    if (!hasAiohttpImport) {
+        return [];
+    }
+    // Second pass: find session variables
+    sessionVars.clear();
+    // Match: async with aiohttp.ClientSession() as session:
+    const asyncWithSessionRegex = /async\s+with\s+(?:aiohttp\.)?ClientSession\s*\([^)]*\)\s+as\s+(\w+)/g;
+    let match;
+    while ((match = asyncWithSessionRegex.exec(content)) !== null) {
+        sessionVars.add(match[1]);
+    }
+    // Match: session = aiohttp.ClientSession()
+    const sessionCreateRegex = /\b(\w+)\s*=\s*(?:aiohttp\.)?ClientSession\s*\(/g;
+    while ((match = sessionCreateRegex.exec(content)) !== null) {
+        sessionVars.add(match[1]);
+    }
+    // Also match common variable names that might be sessions
+    // (client, session, http_session, api_session)
+    const commonSessionNames = ['session', 'client', 'http_session', 'api_session'];
+    for (const name of commonSessionNames) {
+        const regex = new RegExp(`\\b${name}\\s*=\\s*(?:aiohttp\\.)?ClientSession\\s*\\(`, 'g');
+        if (regex.test(content)) {
+            sessionVars.add(name);
+        }
+    }
+    // Third pass: detect HTTP calls line by line
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const lineNum = i + 1;
+        // Detect session.method() calls in context managers
+        // Pattern: async with session.get(...) as response:
+        const asyncWithMethodRegex = /async\s+with\s+(\w+)\.(get|post|put|patch|delete|head|options|request)\s*\(/gi;
+        while ((match = asyncWithMethodRegex.exec(line)) !== null) {
+            const sessionVar = match[1];
+            const method = normalizeHttpMethod(match[2]);
+            // Check if it's a known session or likely a session
+            if (method && (sessionVars.has(sessionVar) || isLikelySession(sessionVar, content))) {
+                const call = createHttpCall(method, 'aiohttp', line, lineNum, match.index);
+                call.isSession = true;
+                call.isAsync = true;
+                // Extract response variable from "as response"
+                const asMatch = line.match(/as\s+(\w+)\s*:/);
+                if (asMatch) {
+                    call.responseVariable = asMatch[1];
+                }
+                calls.push(call);
+            }
+        }
+        // Detect await session.method() calls (not in context manager)
+        // Pattern: await session.get(...)
+        for (const sessionVar of sessionVars) {
+            const awaitCallRegex = new RegExp(`await\\s+${escapeRegex(sessionVar)}\\.(get|post|put|patch|delete|head|options|request)\\s*\\(`, 'gi');
+            while ((match = awaitCallRegex.exec(line)) !== null) {
+                const method = normalizeHttpMethod(match[1]);
+                if (method) {
+                    const call = createHttpCall(method, 'aiohttp', line, lineNum, match.index);
+                    call.isSession = true;
+                    call.isAsync = true;
+                    calls.push(call);
+                }
+            }
+        }
+    }
+    return calls;
+}
+/**
+ * Check if a variable name is likely a session based on context
+ */
+function isLikelySession(varName, content) {
+    // Common patterns that indicate aiohttp session
+    const sessionIndicators = [
+        `${varName} = aiohttp.ClientSession`,
+        `${varName} = ClientSession`,
+        `aiohttp.ClientSession() as ${varName}`,
+        `ClientSession() as ${varName}`
+    ];
+    for (const indicator of sessionIndicators) {
+        if (content.includes(indicator)) {
+            return true;
+        }
+    }
+    // Variable names that suggest sessions
+    const sessionNamePatterns = /^(session|client|http_client|api_client|http_session|api_session)$/i;
+    return sessionNamePatterns.test(varName);
+}
+/**
+ * Create a PythonHttpCall from a detected call
+ */
+function createHttpCall(method, library, line, lineNum, column) {
+    const call = {
+        method,
+        library,
+        line: lineNum,
+        column,
+        isAsync: true // aiohttp is always async
+    };
+    // Extract URL
+    const urlInfo = extractUrl(line);
+    if (urlInfo) {
+        call.url = urlInfo.url;
+        call.isDynamicUrl = urlInfo.isDynamic;
+        call.pathParams = urlInfo.pathParams;
+    }
+    // Detect query params
+    if (/\bparams\s*=/.test(line)) {
+        call.hasQueryParams = true;
+    }
+    // URL with query string
+    if (call.url?.includes('?')) {
+        call.hasQueryParams = true;
+    }
+    // Detect headers
+    if (/\bheaders\s*=/.test(line)) {
+        call.hasHeaders = true;
+    }
+    // Detect body
+    if (/\bjson\s*=/.test(line) || /\bdata\s*=/.test(line)) {
+        call.hasBody = true;
+    }
+    return call;
+}
+/**
+ * Extract URL from a call line
+ */
+function extractUrl(line) {
+    // Match f-strings first
+    const fstringMatch = line.match(/f["']([^"']+)["']/);
+    if (fstringMatch) {
+        const url = fstringMatch[1];
+        const pathParams = [];
+        let paramMatch;
+        const paramRegex = /\{(\w+)\}/g;
+        while ((paramMatch = paramRegex.exec(url)) !== null) {
+            pathParams.push(paramMatch[1]);
+        }
+        return { url, isDynamic: true, pathParams };
+    }
+    // Match regular strings - look for method call with string arg
+    const stringMatch = line.match(/\.(get|post|put|patch|delete|head|options|request)\s*\(\s*["']([^"']+)["']/i);
+    if (stringMatch) {
+        return { url: stringMatch[2], isDynamic: false, pathParams: [] };
+    }
+    // Generic string match after opening paren
+    const genericMatch = line.match(/\(\s*["']([^"']+)["']/);
+    if (genericMatch) {
+        return { url: genericMatch[1], isDynamic: false, pathParams: [] };
+    }
+    return null;
+}
+/**
+ * Escape special regex characters in a string
+ */
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Get the response properties that aiohttp library supports
+ */
+export function getAiohttpResponseProperties() {
+    return AIOHTTP_PATTERN.responseAccess;
+}
+//# sourceMappingURL=aiohttp.js.map