mnehmos.trace.mcp 1.0.0

package/dist/patterns/python/requests.js

@@ -0,0 +1,239 @@
+/**
+ * Python requests library HTTP client detection
+ *
+ * Detects calls to the requests library:
+ * - requests.get(), requests.post(), etc.
+ * - session.get(), session.post() with Session instances
+ *
+ * @see .context/TASK_MAP_P3.md - Task P3-4
+ */
+import { HTTP_CLIENT_PATTERNS, normalizeHttpMethod } from './types.js';
+const REQUESTS_PATTERN = HTTP_CLIENT_PATTERNS.requests;
+/**
+ * Regex patterns for detecting requests library calls
+ */
+const PATTERNS = {
+    // Import detection
+    importRequests: /^\s*import\s+requests\b/m,
+    fromRequests: /^\s*from\s+requests\s+import\s+(.+)/m,
+    // Direct function calls: requests.get(...), requests.post(...)
+    directCall: /\brequests\.(get|post|put|patch|delete|head|options|request)\s*\(/gi,
+    // Session creation: requests.Session(), Session()
+    sessionCreate: /\b(\w+)\s*=\s*(?:requests\.)?Session\s*\(\s*\)/g,
+    // Session method calls: session.get(...), session.post(...)
+    sessionCall: /\b(\w+)\.(get|post|put|patch|delete|head|options|request)\s*\(/gi,
+    // Response assignment: response = requests.get(...)
+    responseAssign: /\b(\w+)\s*=\s*(?:requests\.)?(?:\w+\.)?(get|post|put|patch|delete|head|options|request)\s*\(/gi,
+    // URL extraction from calls (first string argument)
+    urlArg: /\(\s*(?:url\s*=\s*)?["'f]([^"']+)["']|f["']([^"']+)["']/,
+    // f-string path params
+    fstringParams: /\{(\w+)\}/g,
+    // Query params detection
+    queryParams: /\bparams\s*=/,
+    // Headers detection
+    headers: /\bheaders\s*=/,
+    // JSON body detection
+    jsonBody: /\bjson\s*=/,
+    // Data body detection  
+    dataBody: /\bdata\s*=/
+};
+/**
+ * Track known session variable names
+ */
+const sessionVars = new Set();
+/**
+ * Detect HTTP calls from the requests library in Python source code
+ */
+export function detectRequestsCalls(content) {
+    const calls = [];
+    const lines = content.split('\n');
+    // First pass: detect imports
+    const hasRequestsImport = PATTERNS.importRequests.test(content) ||
+        PATTERNS.fromRequests.test(content);
+    if (!hasRequestsImport) {
+        return [];
+    }
+    // Second pass: find session variables
+    sessionVars.clear();
+    let match;
+    // Match both requests.Session() and Session() (when imported directly)
+    const sessionCreateRegex = /\b(\w+)\s*=\s*(?:requests\.)?Session\s*\(\s*\)/g;
+    while ((match = sessionCreateRegex.exec(content)) !== null) {
+        sessionVars.add(match[1]);
+    }
+    // Also match session created via from requests import Session
+    // and Session() call in the same file
+    const fromImportMatch = content.match(/from\s+requests\s+import\s+.*\bSession\b/);
+    if (fromImportMatch) {
+        // Look for any variable = Session() patterns
+        const directSessionRegex = /\b(\w+)\s*=\s*Session\s*\(\s*\)/g;
+        while ((match = directSessionRegex.exec(content)) !== null) {
+            sessionVars.add(match[1]);
+        }
+    }
+    // Third pass: detect HTTP calls line by line
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const lineNum = i + 1;
+        // Get multi-line context (look ahead up to 10 lines for multiline calls)
+        const multilineContext = getMultilineContext(lines, i);
+        // Detect direct requests.method() calls
+        const directCallRegex = /\brequests\.(get|post|put|patch|delete|head|options|request)\s*\(/gi;
+        while ((match = directCallRegex.exec(line)) !== null) {
+            const method = normalizeHttpMethod(match[1]);
+            if (method) {
+                const call = createHttpCall(method, 'requests', multilineContext, lineNum, match.index);
+                call.isSession = false;
+                calls.push(call);
+            }
+        }
+        // Detect session.method() calls
+        for (const sessionVar of sessionVars) {
+            const sessionCallRegex = new RegExp(`\\b${escapeRegex(sessionVar)}\\.(get|post|put|patch|delete|head|options|request)\\s*\\(`, 'gi');
+            while ((match = sessionCallRegex.exec(line)) !== null) {
+                const method = normalizeHttpMethod(match[1]);
+                if (method) {
+                    const call = createHttpCall(method, 'requests', multilineContext, lineNum, match.index);
+                    call.isSession = true;
+                    calls.push(call);
+                }
+            }
+        }
+    }
+    return calls;
+}
+/**
+ * Get multi-line context for a call starting at line index
+ * Looks ahead up to 10 lines to capture multiline function calls
+ */
+function getMultilineContext(lines, startIndex) {
+    let context = lines[startIndex];
+    let parenDepth = 0;
+    let inCall = false;
+    // Count opening parens in the first line
+    for (const char of context) {
+        if (char === '(') {
+            parenDepth++;
+            inCall = true;
+        }
+        else if (char === ')') {
+            parenDepth--;
+        }
+    }
+    // If call is complete (balanced parens), return single line
+    if (inCall && parenDepth === 0) {
+        return context;
+    }
+    // Look ahead for closing paren
+    for (let i = 1; i <= 10 && startIndex + i < lines.length; i++) {
+        const nextLine = lines[startIndex + i];
+        context += '\n' + nextLine;
+        for (const char of nextLine) {
+            if (char === '(') {
+                parenDepth++;
+            }
+            else if (char === ')') {
+                parenDepth--;
+            }
+        }
+        // Found matching close
+        if (parenDepth === 0) {
+            break;
+        }
+    }
+    return context;
+}
+/**
+ * Create a PythonHttpCall from a detected call
+ */
+function createHttpCall(method, library, line, lineNum, column) {
+    const call = {
+        method,
+        library,
+        line: lineNum,
+        column
+    };
+    // Extract URL
+    const urlInfo = extractUrl(line);
+    if (urlInfo) {
+        call.url = urlInfo.url;
+        call.isDynamicUrl = urlInfo.isDynamic;
+        call.pathParams = urlInfo.pathParams;
+    }
+    // Detect query params
+    if (PATTERNS.queryParams.test(line)) {
+        call.hasQueryParams = true;
+    }
+    // URL with query string
+    if (call.url?.includes('?')) {
+        call.hasQueryParams = true;
+    }
+    // Detect headers
+    if (PATTERNS.headers.test(line)) {
+        call.hasHeaders = true;
+    }
+    // Detect body
+    if (PATTERNS.jsonBody.test(line) || PATTERNS.dataBody.test(line)) {
+        call.hasBody = true;
+    }
+    // Extract response variable
+    const assignMatch = line.match(/^\s*(\w+)\s*=/);
+    if (assignMatch) {
+        call.responseVariable = assignMatch[1];
+    }
+    return call;
+}
+/**
+ * Extract URL from a call line
+ */
+function extractUrl(line) {
+    // Try to find URL in the call
+    // 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
+    const stringMatch = line.match(/\(\s*["']([^"']+)["']/);
+    if (stringMatch) {
+        return { url: stringMatch[1], isDynamic: false, pathParams: [] };
+    }
+    // Match url= keyword argument
+    const kwargMatch = line.match(/url\s*=\s*["']([^"']+)["']/);
+    if (kwargMatch) {
+        return { url: kwargMatch[1], isDynamic: false, pathParams: [] };
+    }
+    // Match url= with f-string
+    const kwargFstringMatch = line.match(/url\s*=\s*f["']([^"']+)["']/);
+    if (kwargFstringMatch) {
+        const url = kwargFstringMatch[1];
+        const pathParams = [];
+        let paramMatch;
+        const paramRegex = /\{(\w+)\}/g;
+        while ((paramMatch = paramRegex.exec(url)) !== null) {
+            pathParams.push(paramMatch[1]);
+        }
+        return { url, isDynamic: true, pathParams };
+    }
+    return null;
+}
+/**
+ * Escape special regex characters in a string
+ */
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Get the response properties that requests library supports
+ */
+export function getRequestsResponseProperties() {
+    return REQUESTS_PATTERN.responseAccess;
+}
+//# sourceMappingURL=requests.js.map

package/dist/patterns/python/requests.js.map

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

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

@@ -0,0 +1,95 @@
+/**
+ * Python HTTP Client Pattern Types
+ *
+ * Types for detecting Python HTTP client calls (requests, httpx, aiohttp)
+ * and tracking response property access.
+ *
+ * @see .context/TASK_MAP_P3.md - Task P3-4
+ */
+/**
+ * Supported Python HTTP client libraries
+ */
+export type PythonHttpLibrary = 'requests' | 'httpx' | 'aiohttp';
+/**
+ * HTTP method types
+ */
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';
+/**
+ * Represents a detected Python HTTP client call
+ */
+export interface PythonHttpCall {
+    /** HTTP method used (GET, POST, etc.) */
+    method: HttpMethod;
+    /** Library that was detected (requests, httpx, aiohttp) */
+    library: PythonHttpLibrary;
+    /** Extracted URL (may be partial or contain placeholders) */
+    url?: string;
+    /** Whether the URL contains dynamic parts (f-strings) */
+    isDynamicUrl?: boolean;
+    /** Path parameters extracted from f-string URLs */
+    pathParams?: string[];
+    /** Whether request has query parameters */
+    hasQueryParams?: boolean;
+    /** Whether request has custom headers */
+    hasHeaders?: boolean;
+    /** Whether request has a body (json, data) */
+    hasBody?: boolean;
+    /** Whether this is a session-based call */
+    isSession?: boolean;
+    /** Whether this uses a Client instance (httpx) */
+    isClient?: boolean;
+    /** Whether this uses an AsyncClient (httpx) */
+    isAsyncClient?: boolean;
+    /** Whether this is an async call (httpx AsyncClient, aiohttp) */
+    isAsync?: boolean;
+    /** Variable name storing the response */
+    responseVariable?: string;
+    /** Line number in source */
+    line: number;
+    /** Column number in source */
+    column?: number;
+}
+/**
+ * Represents response property access on an HTTP response variable
+ */
+export interface PythonPropertyAccess {
+    /** Variable name being accessed */
+    variable: string;
+    /** Property or method being accessed (json, text, status_code, etc.) */
+    property: string;
+    /** Whether this is a method call (json()) vs property access (text) */
+    isMethodCall: boolean;
+    /** Line number in source */
+    line: number;
+}
+/**
+ * Combined result of HTTP call detection
+ */
+export interface PythonHttpCallResult extends PythonHttpCall {
+    /** Properties accessed on the response */
+    responseProperties: string[];
+}
+/**
+ * Pattern for detecting library-specific HTTP calls
+ */
+export interface HttpClientPattern {
+    /** Library name */
+    library: PythonHttpLibrary;
+    /** Module names to detect imports from */
+    modules: string[];
+    /** Function/method names that make HTTP calls */
+    httpMethods: string[];
+    /** Session/Client class names */
+    sessionClasses: string[];
+    /** Response property/method names */
+    responseAccess: string[];
+}
+/**
+ * Pattern definitions for each supported library
+ */
+export declare const HTTP_CLIENT_PATTERNS: Record<PythonHttpLibrary, HttpClientPattern>;
+/**
+ * Map HTTP method string to type
+ */
+export declare function normalizeHttpMethod(method: string): HttpMethod | null;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/patterns/python/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;AAEjE;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAE1F;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,MAAM,EAAE,UAAU,CAAC;IAEnB,2DAA2D;IAC3D,OAAO,EAAE,iBAAiB,CAAC;IAE3B,6DAA6D;IAC7D,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,yDAAyD;IACzD,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB,2CAA2C;IAC3C,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB,yCAAyC;IACzC,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,+CAA+C;IAC/C,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,iEAAiE;IACjE,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,yCAAyC;IACzC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IAEb,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IAEjB,wEAAwE;IACxE,QAAQ,EAAE,MAAM,CAAC;IAEjB,uEAAuE;IACvE,YAAY,EAAE,OAAO,CAAC;IAEtB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC1D,0CAA0C;IAC1C,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mBAAmB;IACnB,OAAO,EAAE,iBAAiB,CAAC;IAE3B,0CAA0C;IAC1C,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB,iDAAiD;IACjD,WAAW,EAAE,MAAM,EAAE,CAAC;IAEtB,iCAAiC;IACjC,cAAc,EAAE,MAAM,EAAE,CAAC;IAEzB,qCAAqC;IACrC,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,iBAAiB,EAAE,iBAAiB,CAsB7E,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAIrE"}

package/dist/patterns/python/types.js

@@ -0,0 +1,43 @@
+/**
+ * Python HTTP Client Pattern Types
+ *
+ * Types for detecting Python HTTP client calls (requests, httpx, aiohttp)
+ * and tracking response property access.
+ *
+ * @see .context/TASK_MAP_P3.md - Task P3-4
+ */
+/**
+ * Pattern definitions for each supported library
+ */
+export const HTTP_CLIENT_PATTERNS = {
+    requests: {
+        library: 'requests',
+        modules: ['requests'],
+        httpMethods: ['get', 'post', 'put', 'patch', 'delete', 'head', 'options', 'request'],
+        sessionClasses: ['Session'],
+        responseAccess: ['json', 'text', 'content', 'status_code', 'headers', 'ok', 'reason', 'url', 'encoding', 'cookies']
+    },
+    httpx: {
+        library: 'httpx',
+        modules: ['httpx'],
+        httpMethods: ['get', 'post', 'put', 'patch', 'delete', 'head', 'options', 'request'],
+        sessionClasses: ['Client', 'AsyncClient'],
+        responseAccess: ['json', 'text', 'content', 'status_code', 'headers', 'is_success', 'is_error', 'is_redirect', 'url', 'encoding', 'cookies']
+    },
+    aiohttp: {
+        library: 'aiohttp',
+        modules: ['aiohttp'],
+        httpMethods: ['get', 'post', 'put', 'patch', 'delete', 'head', 'options', 'request'],
+        sessionClasses: ['ClientSession'],
+        responseAccess: ['json', 'text', 'read', 'status', 'headers', 'ok', 'reason', 'url', 'content_type', 'cookies']
+    }
+};
+/**
+ * Map HTTP method string to type
+ */
+export function normalizeHttpMethod(method) {
+    const upper = method.toUpperCase();
+    const methods = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS'];
+    return methods.includes(upper) ? upper : null;
+}
+//# sourceMappingURL=types.js.map

package/dist/patterns/python/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/patterns/python/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA2GH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAiD;IAChF,QAAQ,EAAE;QACR,OAAO,EAAE,UAAU;QACnB,OAAO,EAAE,CAAC,UAAU,CAAC;QACrB,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC;QACpF,cAAc,EAAE,CAAC,SAAS,CAAC;QAC3B,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,CAAC;KACpH;IACD,KAAK,EAAE;QACL,OAAO,EAAE,OAAO;QAChB,OAAO,EAAE,CAAC,OAAO,CAAC;QAClB,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC;QACpF,cAAc,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC;QACzC,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,CAAC;KAC7I;IACD,OAAO,EAAE;QACP,OAAO,EAAE,SAAS;QAClB,OAAO,EAAE,CAAC,SAAS,CAAC;QACpB,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC;QACpF,cAAc,EAAE,CAAC,eAAe,CAAC;QACjC,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,cAAc,EAAE,SAAS,CAAC;KAChH;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACnC,MAAM,OAAO,GAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IAC3F,OAAO,OAAO,CAAC,QAAQ,CAAC,KAAmB,CAAC,CAAC,CAAC,CAAC,KAAmB,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5E,CAAC"}

package/dist/patterns/registry.d.ts

@@ -0,0 +1,181 @@
+/**
+ * Pattern Registry
+ *
+ * Registry for pattern matchers, following the same design as AdapterRegistry.
+ * Provides registration, lookup, and scanning capabilities.
+ *
+ * The registry uses a module-scoped singleton pattern with exported wrapper
+ * functions for a clean, functional API.
+ *
+ * @module patterns/registry
+ * @see .context/ADR-P2-1-PATTERN-MATCHER.md
+ *
+ * @example
+ * ```typescript
+ * import { registerPattern, scanForPatterns } from './patterns';
+ *
+ * // Register a custom pattern matcher
+ * registerPattern(myExpressMatcher);
+ *
+ * // Scan source file for patterns
+ * const matches = scanForPatterns(sourceFile, {
+ *   frameworks: ['express'],
+ *   types: ['call']
+ * });
+ * ```
+ */
+import type { SourceFile } from 'ts-morph';
+import type { PatternMatcher } from './base.js';
+import type { MatchResult, PatternType } from './types.js';
+/**
+ * Options for filtering pattern matchers during source file scanning.
+ *
+ * @example
+ * ```typescript
+ * const options: ScanOptions = {
+ *   frameworks: ['express', 'nestjs'],
+ *   types: ['call', 'decorator']
+ * };
+ * ```
+ */
+export interface ScanOptions {
+    /**
+     * Filter matchers by framework name.
+     * Only matchers matching these frameworks will be used.
+     */
+    frameworks?: string[];
+    /**
+     * Filter matchers by supported pattern type.
+     * Only matchers supporting at least one of these types will be used.
+     */
+    types?: PatternType[];
+}
+/**
+ * Register a pattern matcher with the global registry.
+ *
+ * The matcher is validated before registration. If validation fails,
+ * a {@link PatternValidationError} is thrown with details.
+ *
+ * @param matcher - The pattern matcher to register
+ * @throws {PatternValidationError} If the matcher fails validation
+ *
+ * @example
+ * ```typescript
+ * import { registerPattern, BasePatternMatcher } from './patterns';
+ *
+ * class MyMatcher extends BasePatternMatcher {
+ *   readonly name = 'my-matcher';
+ *   readonly framework = 'express';
+ *   // ... implementation
+ * }
+ *
+ * registerPattern(new MyMatcher());
+ * ```
+ */
+export declare function registerPattern(matcher: PatternMatcher): void;
+/**
+ * Get a pattern matcher by its unique name.
+ *
+ * @param name - The unique name of the matcher to retrieve
+ * @returns The registered pattern matcher
+ * @throws {PatternNotFoundError} If no matcher with that name exists
+ *
+ * @example
+ * ```typescript
+ * const matcher = getPattern('express-router');
+ * const matches = matcher.scan(sourceFile);
+ * ```
+ */
+export declare function getPattern(name: string): PatternMatcher;
+/**
+ * Get all pattern matchers for a specific framework.
+ *
+ * @param framework - The framework name to filter by
+ * @returns Array of matchers for that framework (empty if none)
+ *
+ * @example
+ * ```typescript
+ * const expressMatchers = getPatternsByFramework('express');
+ * console.log(`Found ${expressMatchers.length} Express matchers`);
+ * ```
+ */
+export declare function getPatternsByFramework(framework: string): PatternMatcher[];
+/**
+ * Get all pattern matchers supporting a specific pattern type.
+ *
+ * @param type - The pattern type to filter by
+ * @returns Array of matchers supporting that type
+ *
+ * @example
+ * ```typescript
+ * const decoratorMatchers = getPatternsByType('decorator');
+ * // Returns matchers like NestJS that use decorators
+ * ```
+ */
+export declare function getPatternsByType(type: PatternType): PatternMatcher[];
+/**
+ * Check if a pattern matcher is registered by name.
+ *
+ * @param name - The name to check
+ * @returns `true` if a matcher with that name exists
+ *
+ * @example
+ * ```typescript
+ * if (!hasPattern('express-router')) {
+ *   registerPattern(new ExpressRouterMatcher());
+ * }
+ * ```
+ */
+export declare function hasPattern(name: string): boolean;
+/**
+ * List all registered pattern matcher names.
+ *
+ * @returns Array of all registered matcher names
+ *
+ * @example
+ * ```typescript
+ * console.log('Available matchers:', listPatterns().join(', '));
+ * ```
+ */
+export declare function listPatterns(): string[];
+/**
+ * List all unique framework names from registered matchers.
+ *
+ * @returns Array of unique framework names
+ *
+ * @example
+ * ```typescript
+ * const frameworks = listFrameworks();
+ * // ['express', 'nestjs', 'trpc', ...]
+ * ```
+ */
+export declare function listFrameworks(): string[];
+/**
+ * Scan a source file for patterns using all registered matchers.
+ *
+ * This is the primary entry point for pattern detection. It applies
+ * all registered matchers (or a filtered subset) to find API patterns.
+ *
+ * @param sourceFile - The ts-morph SourceFile to scan
+ * @param options - Optional filtering options
+ * @returns Array of all matches found across all matchers
+ *
+ * @example
+ * ```typescript
+ * import { Project } from 'ts-morph';
+ *
+ * const project = new Project();
+ * const sourceFile = project.addSourceFileAtPath('./src/routes.ts');
+ *
+ * // Scan with all matchers
+ * const allMatches = scanForPatterns(sourceFile);
+ *
+ * // Scan with filters
+ * const expressMatches = scanForPatterns(sourceFile, {
+ *   frameworks: ['express'],
+ *   types: ['call']
+ * });
+ * ```
+ */
+export declare function scanForPatterns(sourceFile: SourceFile, options?: ScanOptions): MatchResult[];
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/patterns/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAM3D;;;;;;;;;;GAUG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB;;;OAGG;IACH,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;CACvB;AA4KD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAE7D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAEvD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,EAAE,CAE1E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,cAAc,EAAE,CAErE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAEvC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAEzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,UAAU,EACtB,OAAO,CAAC,EAAE,WAAW,GACpB,WAAW,EAAE,CAEf"}