mnehmos.trace.mcp 1.0.0

package/dist/patterns/http-clients/fetch.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Fetch Pattern Matcher
+ *
+ * Pattern matcher for the native fetch() API.
+ * Extracts URL patterns, HTTP methods, request/response types,
+ * and property access tracking for consumer schema inference.
+ *
+ * @module patterns/http-clients/fetch
+ * @see .context/ADR-P2-3-HTTP-CLIENT-TRACING.md
+ */
+import { Node } from 'ts-morph';
+import { BasePatternMatcher } from '../base.js';
+import type { MatchResult, PatternDef, PatternType } from '../types.js';
+import type { NormalizedSchema } from '../../core/types.js';
+/**
+ * Pattern matcher for fetch() API calls.
+ *
+ * Detects patterns like:
+ * - `fetch('/api/users')`
+ * - `fetch(url, { method: 'POST', body: ... })`
+ * - `` fetch(`/api/users/${id}`) ``
+ * - `response.json()`
+ *
+ * @example
+ * ```typescript
+ * const matcher = new FetchPatternMatcher();
+ * const matches = matcher.scan(sourceFile);
+ * // Returns matches for all fetch() calls with extracted metadata
+ * ```
+ */
+export declare class FetchPatternMatcher extends BasePatternMatcher {
+    readonly name = "fetch-client";
+    readonly framework = "fetch";
+    readonly supportedTypes: PatternType[];
+    readonly patterns: PatternDef[];
+    /**
+     * Match a single pattern against a node.
+     *
+     * @param pattern - Pattern definition to match
+     * @param node - AST node to test
+     * @returns MatchResult if matched, null otherwise
+     */
+    protected matchPattern(pattern: PatternDef, node: Node): MatchResult | null;
+    /**
+     * Build a match result from a fetch call.
+     *
+     * @internal
+     */
+    private buildMatchResult;
+    /**
+     * Extract captures from a fetch call.
+     *
+     * @internal
+     */
+    private extractCaptures;
+    /**
+     * Parse fetch options object.
+     *
+     * @internal
+     */
+    private parseOptionsObject;
+    /**
+     * Check if a string is a valid HTTP method.
+     *
+     * @internal
+     */
+    private isValidMethod;
+    /**
+     * Extract body information.
+     *
+     * @internal
+     */
+    private extractBodyInfo;
+    /**
+     * Extract headers information.
+     *
+     * @internal
+     */
+    private extractHeadersInfo;
+    /**
+     * Extract schema from a match result.
+     *
+     * @param match - The match result to extract schema from
+     * @returns NormalizedSchema representing the fetch call
+     */
+    extract(match: MatchResult): Promise<NormalizedSchema>;
+}
+//# sourceMappingURL=fetch.d.ts.map

package/dist/patterns/http-clients/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../../src/patterns/http-clients/fetch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAiB,MAAM,aAAa,CAAC;AACvF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAU5D;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,mBAAoB,SAAQ,kBAAkB;IACzD,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,SAAS,WAAW;IAC7B,QAAQ,CAAC,cAAc,EAAE,WAAW,EAAE,CAAqB;IAE3D,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,CAM7B;IAMF;;;;;;OAMG;IACH,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,GAAG,WAAW,GAAG,IAAI;IAkB3E;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IA+BxB;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAyDvB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IA8C1B;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAQrB;;;;OAIG;IACH,OAAO,CAAC,eAAe;IA6BvB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAqD1B;;;;;OAKG;IACG,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC;CA8E7D"}

package/dist/patterns/http-clients/fetch.js

@@ -0,0 +1,364 @@
+/**
+ * Fetch Pattern Matcher
+ *
+ * Pattern matcher for the native fetch() API.
+ * Extracts URL patterns, HTTP methods, request/response types,
+ * and property access tracking for consumer schema inference.
+ *
+ * @module patterns/http-clients/fetch
+ * @see .context/ADR-P2-3-HTTP-CLIENT-TRACING.md
+ */
+import { Node } from 'ts-morph';
+import { BasePatternMatcher } from '../base.js';
+import { extractURL } from './url-extractor.js';
+import { findTypeInferenceSources } from './type-inference.js';
+import { trackPropertyAccesses } from './property-access.js';
+/* ═══════════════════════════════════════════════════════════════════════════
+ * 🌐 FetchPatternMatcher Class
+ * ═══════════════════════════════════════════════════════════════════════════ */
+/**
+ * Pattern matcher for fetch() API calls.
+ *
+ * Detects patterns like:
+ * - `fetch('/api/users')`
+ * - `fetch(url, { method: 'POST', body: ... })`
+ * - `` fetch(`/api/users/${id}`) ``
+ * - `response.json()`
+ *
+ * @example
+ * ```typescript
+ * const matcher = new FetchPatternMatcher();
+ * const matches = matcher.scan(sourceFile);
+ * // Returns matches for all fetch() calls with extracted metadata
+ * ```
+ */
+export class FetchPatternMatcher extends BasePatternMatcher {
+    name = 'fetch-client';
+    framework = 'fetch';
+    supportedTypes = ['call', 'chain'];
+    patterns = [
+        {
+            type: 'call',
+            signature: /^fetch$/,
+            inputSchemaLocation: { type: 'arg', index: 0 },
+        },
+    ];
+    /* ─────────────────────────────────────────────────────────────────────────
+     * Pattern Matching
+     * ───────────────────────────────────────────────────────────────────────── */
+    /**
+     * Match a single pattern against a node.
+     *
+     * @param pattern - Pattern definition to match
+     * @param node - AST node to test
+     * @returns MatchResult if matched, null otherwise
+     */
+    matchPattern(pattern, node) {
+        if (!Node.isCallExpression(node)) {
+            return null;
+        }
+        const expression = node.getExpression();
+        // Check for direct fetch() call
+        if (Node.isIdentifier(expression)) {
+            const name = expression.getText();
+            if (this.matchesSignature(name, pattern.signature)) {
+                return this.buildMatchResult(pattern, node);
+            }
+        }
+        return null;
+    }
+    /**
+     * Build a match result from a fetch call.
+     *
+     * @internal
+     */
+    buildMatchResult(pattern, callNode) {
+        if (!Node.isCallExpression(callNode)) {
+            throw new Error('Expected call expression');
+        }
+        const sourceFile = callNode.getSourceFile();
+        const args = callNode.getArguments();
+        // Extract captures
+        const captures = this.extractCaptures(callNode, args);
+        // Build identifier as "METHOD /path"
+        const method = captures.httpMethod || 'GET';
+        const url = captures.url?.raw ||
+            captures.url?.static || '/';
+        const identifier = `${method} ${url}`;
+        return {
+            pattern,
+            node: callNode,
+            framework: this.framework,
+            identifier,
+            location: this.getLocation(callNode, sourceFile.getFilePath()),
+            captures,
+        };
+    }
+    /* ─────────────────────────────────────────────────────────────────────────
+     * Capture Extraction
+     * ───────────────────────────────────────────────────────────────────────── */
+    /**
+     * Extract captures from a fetch call.
+     *
+     * @internal
+     */
+    extractCaptures(callNode, args) {
+        if (!Node.isCallExpression(callNode)) {
+            return { httpMethod: 'GET' };
+        }
+        const captures = {
+            httpMethod: 'GET', // Default method
+        };
+        // Extract URL from first argument
+        if (args.length > 0) {
+            const urlNode = args[0];
+            const urlResult = extractURL(urlNode);
+            if (urlResult) {
+                captures.url = urlResult;
+                captures.routePath = urlResult.raw || urlResult.static;
+            }
+        }
+        // Extract options from second argument
+        if (args.length > 1) {
+            const optionsNode = args[1];
+            const options = this.parseOptionsObject(optionsNode);
+            if (options.method) {
+                captures.httpMethod = options.method;
+            }
+            if (options.body !== undefined) {
+                captures.requestBody = options.body;
+            }
+            if (options.headers) {
+                captures.requestHeaders = options.headers;
+            }
+        }
+        // Extract type inference sources
+        const typeInference = findTypeInferenceSources(callNode);
+        if (typeInference.length > 0) {
+            captures.typeInference = typeInference;
+        }
+        // Track property accesses on the response
+        const propertyAccesses = trackPropertyAccesses(callNode);
+        if (propertyAccesses.length > 0) {
+            captures.propertyAccesses = propertyAccesses;
+        }
+        // Mark as fetch client
+        captures.clientLibrary = 'fetch';
+        return captures;
+    }
+    /* ─────────────────────────────────────────────────────────────────────────
+     * Options Parsing
+     * ───────────────────────────────────────────────────────────────────────── */
+    /**
+     * Parse fetch options object.
+     *
+     * @internal
+     */
+    parseOptionsObject(node) {
+        const result = {};
+        if (!Node.isObjectLiteralExpression(node)) {
+            return result;
+        }
+        for (const prop of node.getProperties()) {
+            if (!Node.isPropertyAssignment(prop))
+                continue;
+            const name = prop.getName();
+            const initializer = prop.getInitializer();
+            if (!initializer)
+                continue;
+            switch (name) {
+                case 'method':
+                    if (Node.isStringLiteral(initializer)) {
+                        const method = initializer.getLiteralValue().toUpperCase();
+                        if (this.isValidMethod(method)) {
+                            result.method = method;
+                        }
+                    }
+                    break;
+                case 'body':
+                    result.body = this.extractBodyInfo(initializer);
+                    break;
+                case 'headers':
+                    result.headers = this.extractHeadersInfo(initializer);
+                    break;
+            }
+        }
+        return result;
+    }
+    /**
+     * Check if a string is a valid HTTP method.
+     *
+     * @internal
+     */
+    isValidMethod(method) {
+        return ['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'HEAD', 'OPTIONS'].includes(method);
+    }
+    /* ─────────────────────────────────────────────────────────────────────────
+     * Request Body & Headers Extraction
+     * ───────────────────────────────────────────────────────────────────────── */
+    /**
+     * Extract body information.
+     *
+     * @internal
+     */
+    extractBodyInfo(node) {
+        // For JSON.stringify() calls
+        if (Node.isCallExpression(node)) {
+            const expr = node.getExpression();
+            if (Node.isPropertyAccessExpression(expr)) {
+                const objExpr = expr.getExpression();
+                const propName = expr.getName();
+                if (Node.isIdentifier(objExpr) && objExpr.getText() === 'JSON' && propName === 'stringify') {
+                    const args = node.getArguments();
+                    if (args.length > 0) {
+                        return { type: 'json', value: args[0].getText() };
+                    }
+                }
+            }
+        }
+        // For object literals
+        if (Node.isObjectLiteralExpression(node)) {
+            return { type: 'object', value: node.getText() };
+        }
+        // For identifiers
+        if (Node.isIdentifier(node)) {
+            return { type: 'reference', name: node.getText() };
+        }
+        return { type: 'unknown', raw: node.getText() };
+    }
+    /**
+     * Extract headers information.
+     *
+     * @internal
+     */
+    extractHeadersInfo(node) {
+        const result = {};
+        if (Node.isObjectLiteralExpression(node)) {
+            const staticHeaders = {};
+            const dynamicHeaders = [];
+            for (const prop of node.getProperties()) {
+                if (Node.isPropertyAssignment(prop)) {
+                    // Get property name - handle both quoted and unquoted
+                    const nameNode = prop.getNameNode();
+                    let name;
+                    if (Node.isStringLiteral(nameNode)) {
+                        name = nameNode.getLiteralValue();
+                    }
+                    else if (Node.isIdentifier(nameNode)) {
+                        name = nameNode.getText();
+                    }
+                    else {
+                        // Fallback - strip quotes from getName() if present
+                        name = prop.getName().replace(/^['"]|['"]$/g, '');
+                    }
+                    const init = prop.getInitializer();
+                    if (init && Node.isStringLiteral(init)) {
+                        staticHeaders[name] = init.getLiteralValue();
+                    }
+                    else if (init && Node.isNoSubstitutionTemplateLiteral(init)) {
+                        // Template literal without substitutions is static
+                        staticHeaders[name] = init.getLiteralValue();
+                    }
+                    else {
+                        // Template with substitutions, call expressions, identifiers are dynamic
+                        dynamicHeaders.push(name);
+                    }
+                }
+            }
+            if (Object.keys(staticHeaders).length > 0) {
+                result.static = staticHeaders;
+            }
+            if (dynamicHeaders.length > 0) {
+                result.dynamic = dynamicHeaders;
+            }
+        }
+        else {
+            // Headers object or variable reference
+            result.dynamic = ['*'];
+        }
+        return result;
+    }
+    /* ─────────────────────────────────────────────────────────────────────────
+     * Schema Extraction
+     * ───────────────────────────────────────────────────────────────────────── */
+    /**
+     * Extract schema from a match result.
+     *
+     * @param match - The match result to extract schema from
+     * @returns NormalizedSchema representing the fetch call
+     */
+    async extract(match) {
+        const captures = match.captures;
+        const url = captures.url?.raw ||
+            captures.url?.static || '';
+        const method = captures.httpMethod || 'GET';
+        // Build a NormalizedSchema from the captures
+        // identifier should be "METHOD /path" format
+        const schema = {
+            name: `${method} ${url}`,
+            properties: {
+                url: {
+                    type: { kind: 'primitive', value: 'string' },
+                    optional: false,
+                    nullable: false,
+                    readonly: true,
+                    deprecated: false,
+                    description: `URL: ${url}`,
+                },
+                method: {
+                    type: { kind: 'literal', value: captures.httpMethod || 'GET' },
+                    optional: false,
+                    nullable: false,
+                    readonly: true,
+                    deprecated: false,
+                },
+            },
+            required: ['url', 'method'],
+            source: {
+                source: 'typescript',
+                id: match.identifier,
+            },
+            location: match.location,
+        };
+        // Add request body if present
+        if (captures.requestBody) {
+            schema.properties.requestBody = {
+                type: { kind: 'any' },
+                optional: true,
+                nullable: false,
+                readonly: false,
+                deprecated: false,
+            };
+        }
+        // Add inferred response type from type inference
+        const typeInference = captures.typeInference;
+        if (typeInference && typeInference.length > 0) {
+            const bestType = typeInference[0];
+            schema.properties.responseType = {
+                type: { kind: 'ref', name: bestType.typeText || 'unknown' },
+                optional: true,
+                nullable: false,
+                readonly: true,
+                deprecated: false,
+                description: `Inferred via ${bestType.method}`,
+            };
+        }
+        // Add property accesses as hints
+        const propertyAccesses = captures.propertyAccesses;
+        if (propertyAccesses && propertyAccesses.length > 0) {
+            schema.properties.accessedProperties = {
+                type: {
+                    kind: 'array',
+                    element: { kind: 'primitive', value: 'string' }
+                },
+                optional: true,
+                nullable: false,
+                readonly: true,
+                deprecated: false,
+                description: `Properties accessed: ${propertyAccesses.map(p => p.path).join(', ')}`,
+            };
+        }
+        return schema;
+    }
+}
+//# sourceMappingURL=fetch.js.map

package/dist/patterns/http-clients/fetch.js.map

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

package/dist/patterns/http-clients/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * HTTP Client Pattern Matchers
+ *
+ * This module provides pattern matchers for HTTP client libraries (fetch, axios).
+ * It enables tracing of HTTP requests made from consumer code, extracting:
+ * - URL patterns and path parameters
+ * - HTTP methods
+ * - Request/response type inference
+ * - Property access tracking for consumer schema inference
+ *
+ * @module patterns/http-clients
+ * @see .context/ADR-P2-3-HTTP-CLIENT-TRACING.md
+ */
+export type { HTTPMethod, URLExtractionResult, TypeInferenceSource, PropertyAccess, HeadersInfo, HTTPClientCaptures, ConsumerUsage, AxiosInstanceConfig, } from './types.js';
+export { extractURL, composeURL } from './url-extractor.js';
+export { findTypeInferenceSources, getBestInferredType } from './type-inference.js';
+export { trackPropertyAccesses, buildTypeFromAccesses } from './property-access.js';
+export { FetchPatternMatcher } from './fetch.js';
+export { AxiosPatternMatcher } from './axios.js';
+/**
+ * Register all HTTP client pattern matchers with the global registry.
+ *
+ * Call this during application initialization to enable HTTP client tracing.
+ *
+ * @example
+ * ```typescript
+ * import { bootstrapHTTPClientPatterns } from './patterns/http-clients/index.js';
+ *
+ * // During app initialization
+ * bootstrapHTTPClientPatterns();
+ *
+ * // Now HTTP client patterns are available for matching
+ * ```
+ */
+export declare function bootstrapHTTPClientPatterns(): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/patterns/http-clients/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/patterns/http-clients/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,YAAY,EACV,UAAU,EACV,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAMpB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACpF,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAMpF,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAUjD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,2BAA2B,IAAI,IAAI,CAGlD"}

package/dist/patterns/http-clients/index.js

@@ -0,0 +1,50 @@
+/**
+ * HTTP Client Pattern Matchers
+ *
+ * This module provides pattern matchers for HTTP client libraries (fetch, axios).
+ * It enables tracing of HTTP requests made from consumer code, extracting:
+ * - URL patterns and path parameters
+ * - HTTP methods
+ * - Request/response type inference
+ * - Property access tracking for consumer schema inference
+ *
+ * @module patterns/http-clients
+ * @see .context/ADR-P2-3-HTTP-CLIENT-TRACING.md
+ */
+/* ═══════════════════════════════════════════════════════════════════════════
+ * 🔧 Utility Exports
+ * ═══════════════════════════════════════════════════════════════════════════ */
+export { extractURL, composeURL } from './url-extractor.js';
+export { findTypeInferenceSources, getBestInferredType } from './type-inference.js';
+export { trackPropertyAccesses, buildTypeFromAccesses } from './property-access.js';
+/* ═══════════════════════════════════════════════════════════════════════════
+ * 🔍 Matcher Exports
+ * ═══════════════════════════════════════════════════════════════════════════ */
+export { FetchPatternMatcher } from './fetch.js';
+export { AxiosPatternMatcher } from './axios.js';
+/* ═══════════════════════════════════════════════════════════════════════════
+ * 🚀 Bootstrap
+ * ═══════════════════════════════════════════════════════════════════════════ */
+import { registerPattern } from '../registry.js';
+import { FetchPatternMatcher } from './fetch.js';
+import { AxiosPatternMatcher } from './axios.js';
+/**
+ * Register all HTTP client pattern matchers with the global registry.
+ *
+ * Call this during application initialization to enable HTTP client tracing.
+ *
+ * @example
+ * ```typescript
+ * import { bootstrapHTTPClientPatterns } from './patterns/http-clients/index.js';
+ *
+ * // During app initialization
+ * bootstrapHTTPClientPatterns();
+ *
+ * // Now HTTP client patterns are available for matching
+ * ```
+ */
+export function bootstrapHTTPClientPatterns() {
+    registerPattern(new FetchPatternMatcher());
+    registerPattern(new AxiosPatternMatcher());
+}
+//# sourceMappingURL=index.js.map

package/dist/patterns/http-clients/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/patterns/http-clients/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAiBH;;iFAEiF;AAEjF,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACpF,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAEpF;;iFAEiF;AAEjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD;;iFAEiF;AAEjF,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,2BAA2B;IACzC,eAAe,CAAC,IAAI,mBAAmB,EAAE,CAAC,CAAC;IAC3C,eAAe,CAAC,IAAI,mBAAmB,EAAE,CAAC,CAAC;AAC7C,CAAC"}

package/dist/patterns/http-clients/property-access.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Property Access Tracking
+ *
+ * Track property accesses on HTTP client response data to infer types.
+ * This enables consumer schema inference from how response data is used.
+ *
+ * @module patterns/http-clients/property-access
+ * @see .context/ADR-P2-3-HTTP-CLIENT-TRACING.md
+ */
+import { Node } from 'ts-morph';
+import type { PropertyAccess } from './types.js';
+/**
+ * Track all property accesses on a variable assigned from a call expression.
+ *
+ * Handles:
+ * - Direct access: `response.data`
+ * - Chained access: `response.data.user.name`
+ * - Destructuring: `const { data } = response`
+ * - Optional chaining: `response?.data?.user`
+ *
+ * @param callNode - The call expression node
+ * @param variableName - Optional variable name to track (derived if not provided)
+ * @returns Array of property accesses found
+ *
+ * @example
+ * ```typescript
+ * const accesses = trackPropertyAccesses(fetchCall);
+ * // [{ path: 'data.user.name', segments: ['data', 'user', 'name'] }]
+ * ```
+ */
+export declare function trackPropertyAccesses(callNode: Node, variableName?: string): PropertyAccess[];
+/**
+ * Build an inferred type structure from property accesses.
+ *
+ * @param accesses - Property accesses observed
+ * @returns Nested object representing the inferred type structure
+ *
+ * @example
+ * ```typescript
+ * const accesses = [{ path: 'user.name' }, { path: 'user.email' }];
+ * const type = buildTypeFromAccesses(accesses);
+ * // { user: { name: 'unknown', email: 'unknown' } }
+ * ```
+ */
+export declare function buildTypeFromAccesses(accesses: PropertyAccess[]): Record<string, unknown>;
+//# sourceMappingURL=property-access.d.ts.map

package/dist/patterns/http-clients/property-access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"property-access.d.ts","sourceRoot":"","sources":["../../../src/patterns/http-clients/property-access.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAc,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,IAAI,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,cAAc,EAAE,CA6D7F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwCzF"}