@mcpmake/core 0.2.0

package/dist/emitter/worker-templates/wrangler.toml.hbs

@@ -0,0 +1,19 @@
+name = "{{serverName}}"
+main = "src/index.ts"
+compatibility_date = "2024-11-01"
+# nodejs_compat backs the reused modules (AsyncLocalStorage trace context,
+# node:crypto, Buffer). Required — do not remove.
+compatibility_flags = ["nodejs_compat"]
+
+# Non-secret configuration. Override per-environment as needed.
+[vars]
+BASE_URL = "{{baseUrl}}"
+MAX_RETRIES = "3"
+REQUEST_INTERVAL_MS = "100"
+# ALLOWED_ORIGIN = "https://your-client.example.com"
+
+# Secrets are NOT stored in this file. Set them before `wrangler deploy`:
+#   wrangler secret put MCP_AUTH_TOKEN        # bearer token clients must present
+{{#each authEnvVars}}
+#   wrangler secret put {{name}}
+{{/each}}

package/dist/generator/spec-generator.d.ts

@@ -0,0 +1,7 @@
+export interface GenerateSpecOptions {
+    description: string;
+    baseUrl?: string;
+    model?: string;
+}
+export declare function generateSpecFromDescription(options: GenerateSpecOptions): Promise<string>;
+//# sourceMappingURL=spec-generator.d.ts.map

package/dist/generator/spec-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-generator.d.ts","sourceRoot":"","sources":["../../src/generator/spec-generator.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAcD,wBAAsB,2BAA2B,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CA6C/F"}

package/dist/generator/spec-generator.js

@@ -0,0 +1,51 @@
+import Anthropic from '@anthropic-ai/sdk';
+import { logger } from '../utils/logger.js';
+const SYSTEM_PROMPT = `You are an API architect. Given a description of an API or service, generate a valid OpenAPI 3.0 specification in JSON format.
+
+Rules:
+- Output ONLY valid JSON (no markdown fences, no explanation)
+- Include realistic endpoints with proper HTTP methods
+- Use descriptive operationIds in camelCase
+- Include request/response schemas with realistic field types
+- Add path parameters, query parameters, and request bodies where appropriate
+- Include at least one security scheme if auth is likely needed
+- Include a servers array with a base URL
+- Keep it practical — 3-10 operations is typical`;
+export async function generateSpecFromDescription(options) {
+    const apiKey = process.env.ANTHROPIC_API_KEY;
+    if (!apiKey) {
+        throw new Error('ANTHROPIC_API_KEY environment variable is required for describe mode.\n' +
+            'Set it with: export ANTHROPIC_API_KEY=your-key-here');
+    }
+    const client = new Anthropic({ apiKey });
+    const model = options.model ?? 'claude-sonnet-4-20250514';
+    let userPrompt = `Generate an OpenAPI 3.0 spec for: ${options.description}`;
+    if (options.baseUrl) {
+        userPrompt += `\n\nUse this base URL: ${options.baseUrl}`;
+    }
+    logger.info('Generating OpenAPI spec from description...');
+    const message = await client.messages.create({
+        model,
+        max_tokens: 4096,
+        system: SYSTEM_PROMPT,
+        messages: [{ role: 'user', content: userPrompt }],
+    });
+    const content = message.content[0];
+    if (content.type !== 'text') {
+        throw new Error('Unexpected response format from Claude');
+    }
+    // Extract JSON — strip markdown fences if present
+    let json = content.text.trim();
+    if (json.startsWith('```')) {
+        json = json.replace(/^```(?:json)?\n?/, '').replace(/\n?```$/, '');
+    }
+    // Validate it's parseable JSON
+    try {
+        JSON.parse(json);
+    }
+    catch {
+        throw new Error('Claude returned invalid JSON. Try again or refine your description.');
+    }
+    return json;
+}
+//# sourceMappingURL=spec-generator.js.map

package/dist/generator/spec-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-generator.js","sourceRoot":"","sources":["../../src/generator/spec-generator.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAQ5C,MAAM,aAAa,GAAG;;;;;;;;;;iDAU2B,CAAC;AAElD,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,OAA4B;IAC5E,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAC7C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,yEAAyE;YACvE,qDAAqD,CACxD,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,0BAA0B,CAAC;IAE1D,IAAI,UAAU,GAAG,qCAAqC,OAAO,CAAC,WAAW,EAAE,CAAC;IAC5E,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,UAAU,IAAI,0BAA0B,OAAO,CAAC,OAAO,EAAE,CAAC;IAC5D,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;IAE3D,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC3C,KAAK;QACL,UAAU,EAAE,IAAI;QAChB,MAAM,EAAE,aAAa;QACrB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;KAClD,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IAED,kDAAkD;IAClD,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,+BAA+B;IAC/B,IAAI,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;IACzF,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,75 @@
+/**
+ * @mcpmake/core — the shared MCP-server generation library.
+ *
+ * Public API consumed by the `mcpmake` CLI (and the managed cloud). Everything
+ * exported here is supported surface; deep imports into `@mcpmake/core/dist/...`
+ * are not.
+ */
+export { emitProject, emitPythonProject, emitWorkerProject, emitSiteProject, } from './emitter/index.js';
+export type { EmitOptions } from './emitter/index.js';
+export { generateMcpb } from './emitter/mcpb-bundler.js';
+export { renderTemplate } from './emitter/template-loader.js';
+export { scaffoldSharedModules } from './emitter/project-scaffolder.js';
+export { loadOpenApiSpec } from './parser/openapi-loader.js';
+export type { LoadResult } from './parser/openapi-loader.js';
+export { applyOverlay } from './parser/overlay-loader.js';
+export { extractOperations } from './parser/operation-extractor.js';
+export type { ExtractionResult } from './parser/operation-extractor.js';
+export { jsonSchemaToZodCode, buildOperationInputSchema } from './parser/schema-converter.js';
+export { loadHarFile } from './parser/har-loader.js';
+export { filterHarEntries } from './parser/har-filter.js';
+export type { FilterOptions } from './parser/har-filter.js';
+export { normalizeEntry } from './parser/har-normalizer.js';
+export type { NormalizedEntry, PathParam, QueryParam } from './parser/har-normalizer.js';
+export { loadPostmanCollection } from './parser/postman-loader.js';
+export { toToolName, toToolTitle, toFileName, toFunctionName } from './transformer/naming.js';
+export { detectAuthSchemes } from './transformer/auth-detector.js';
+export { buildToolDefinition, buildAllTools } from './transformer/tool-builder.js';
+export { filterOperations } from './transformer/operation-filter.js';
+export { buildResources, buildPrompts } from './transformer/resource-builder.js';
+export { applyClientCompat } from './transformer/client-compat.js';
+export type { ClientMode } from './transformer/client-compat.js';
+export { improveToolNames } from './transformer/llm-namer.js';
+export { clusterEntries } from './transformer/har-clusterer.js';
+export type { EntryCluster } from './transformer/har-clusterer.js';
+export { clustersToOperations } from './transformer/har-to-operations.js';
+export type { HarConversionResult, DetectedAuth } from './transformer/har-to-operations.js';
+export { deduplicateEntries } from './transformer/har-dedup.js';
+export { inferJsonSchema, inferResponseSchema, inferRequestBodySchema, } from './transformer/har-schema-inferrer.js';
+export { parseStainlessConfig, resolveSpecPath } from './transformer/stainless-config.js';
+export { translateStainless } from './transformer/stainless-translator.js';
+export { crawlSite } from './analyzer/site-crawler.js';
+export type { CrawlOptions, CrawlResult } from './analyzer/site-crawler.js';
+export { parsePage } from './analyzer/dom-parser.js';
+export { buildSelectorSet, validateSelector } from './analyzer/selector-builder.js';
+export { analyzeSemantics } from './analyzer/semantic-analyzer.js';
+export { detectAuthFlow } from './analyzer/auth-detector.js';
+export { classifyForms } from './analyzer/hybrid-detector.js';
+export type { HybridClassification } from './analyzer/hybrid-detector.js';
+export { goalDirectedCrawl } from './analyzer/goal-crawler.js';
+export type { GoalCrawlOptions } from './analyzer/goal-crawler.js';
+export { generateSiteTools } from './site-transformer/tool-generator.js';
+export { buildBrowserLifecycleTools } from './site-transformer/browser-tools.js';
+export { healBrokenSelector } from './site-transformer/selector-healer.js';
+export { generateSpecFromDescription } from './generator/spec-generator.js';
+export { getProvider, listProviders, getProviderNames } from './providers/index.js';
+export type { ProviderConfig } from './providers/index.js';
+export { recordBrowserSession } from './recorder/browser-recorder.js';
+export { diffSiteDescriptors } from './rescan/diff-engine.js';
+export { RescanScheduler, computeNextRun } from './rescan/rescan-scheduler.js';
+export type { ScheduleEntry, RescanCallback } from './rescan/rescan-scheduler.js';
+export { collectLowConfidenceSelectors, summarizeRescan } from './rescan/rescan-runner.js';
+export type { LowConfidenceSelector, RescanSummary, ChangeCounts } from './rescan/rescan-runner.js';
+export { defineConfigurableCommand } from './config/configurable-command.js';
+export { registerAdapter, getAdapter, listAdapters } from './plugins/loader.js';
+export type { McpmakeAdapter } from './plugins/adapter.js';
+export * from './types/index.js';
+export * from './types/site.js';
+export { logger } from './utils/logger.js';
+export { fail } from './utils/fail.js';
+export { pathExists } from './utils/fs.js';
+export { confirmOperations } from './utils/interactive.js';
+export { watchFile } from './utils/watcher.js';
+export { FAMILY_A_PRICING, DEFAULT_PRICING_SERVER, fetchPricing, formatPrice } from './pricing.js';
+export type { BillingPeriod, PricePoint } from './pricing.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,101 @@
+/**
+ * @mcpmake/core — the shared MCP-server generation library.
+ *
+ * Public API consumed by the `mcpmake` CLI (and the managed cloud). Everything
+ * exported here is supported surface; deep imports into `@mcpmake/core/dist/...`
+ * are not.
+ */
+// ---------------------------------------------------------------------------
+// Emitter (code generation)
+// ---------------------------------------------------------------------------
+export { emitProject, emitPythonProject, emitWorkerProject, emitSiteProject, } from './emitter/index.js';
+export { generateMcpb } from './emitter/mcpb-bundler.js';
+export { renderTemplate } from './emitter/template-loader.js';
+export { scaffoldSharedModules } from './emitter/project-scaffolder.js';
+// ---------------------------------------------------------------------------
+// Parser (OpenAPI / HAR / Postman ingestion)
+// ---------------------------------------------------------------------------
+export { loadOpenApiSpec } from './parser/openapi-loader.js';
+export { applyOverlay } from './parser/overlay-loader.js';
+export { extractOperations } from './parser/operation-extractor.js';
+export { jsonSchemaToZodCode, buildOperationInputSchema } from './parser/schema-converter.js';
+export { loadHarFile } from './parser/har-loader.js';
+export { filterHarEntries } from './parser/har-filter.js';
+export { normalizeEntry } from './parser/har-normalizer.js';
+export { loadPostmanCollection } from './parser/postman-loader.js';
+// ---------------------------------------------------------------------------
+// Transformer (operations -> tools/resources/prompts)
+// ---------------------------------------------------------------------------
+export { toToolName, toToolTitle, toFileName, toFunctionName } from './transformer/naming.js';
+export { detectAuthSchemes } from './transformer/auth-detector.js';
+export { buildToolDefinition, buildAllTools } from './transformer/tool-builder.js';
+export { filterOperations } from './transformer/operation-filter.js';
+export { buildResources, buildPrompts } from './transformer/resource-builder.js';
+export { applyClientCompat } from './transformer/client-compat.js';
+export { improveToolNames } from './transformer/llm-namer.js';
+export { clusterEntries } from './transformer/har-clusterer.js';
+export { clustersToOperations } from './transformer/har-to-operations.js';
+export { deduplicateEntries } from './transformer/har-dedup.js';
+export { inferJsonSchema, inferResponseSchema, inferRequestBodySchema, } from './transformer/har-schema-inferrer.js';
+export { parseStainlessConfig, resolveSpecPath } from './transformer/stainless-config.js';
+export { translateStainless } from './transformer/stainless-translator.js';
+// ---------------------------------------------------------------------------
+// Analyzer (website crawling / form detection)
+// ---------------------------------------------------------------------------
+export { crawlSite } from './analyzer/site-crawler.js';
+export { parsePage } from './analyzer/dom-parser.js';
+export { buildSelectorSet, validateSelector } from './analyzer/selector-builder.js';
+export { analyzeSemantics } from './analyzer/semantic-analyzer.js';
+export { detectAuthFlow } from './analyzer/auth-detector.js';
+export { classifyForms } from './analyzer/hybrid-detector.js';
+export { goalDirectedCrawl } from './analyzer/goal-crawler.js';
+// ---------------------------------------------------------------------------
+// Site transformer (browser tools / selector healing)
+// ---------------------------------------------------------------------------
+export { generateSiteTools } from './site-transformer/tool-generator.js';
+export { buildBrowserLifecycleTools } from './site-transformer/browser-tools.js';
+export { healBrokenSelector } from './site-transformer/selector-healer.js';
+// ---------------------------------------------------------------------------
+// Generator (LLM spec synthesis)
+// ---------------------------------------------------------------------------
+export { generateSpecFromDescription } from './generator/spec-generator.js';
+// ---------------------------------------------------------------------------
+// Providers (known-API presets)
+// ---------------------------------------------------------------------------
+export { getProvider, listProviders, getProviderNames } from './providers/index.js';
+// ---------------------------------------------------------------------------
+// Recorder (browser session capture)
+// ---------------------------------------------------------------------------
+export { recordBrowserSession } from './recorder/browser-recorder.js';
+// ---------------------------------------------------------------------------
+// Rescan (scheduled re-generation)
+// ---------------------------------------------------------------------------
+export { diffSiteDescriptors } from './rescan/diff-engine.js';
+export { RescanScheduler, computeNextRun } from './rescan/rescan-scheduler.js';
+export { collectLowConfidenceSelectors, summarizeRescan } from './rescan/rescan-runner.js';
+// ---------------------------------------------------------------------------
+// Config (shared command/config plumbing)
+// ---------------------------------------------------------------------------
+export { defineConfigurableCommand } from './config/configurable-command.js';
+// ---------------------------------------------------------------------------
+// Plugins (adapter registry)
+// ---------------------------------------------------------------------------
+export { registerAdapter, getAdapter, listAdapters } from './plugins/loader.js';
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+export * from './types/index.js';
+export * from './types/site.js';
+// ---------------------------------------------------------------------------
+// Utils
+// ---------------------------------------------------------------------------
+export { logger } from './utils/logger.js';
+export { fail } from './utils/fail.js';
+export { pathExists } from './utils/fs.js';
+export { confirmOperations } from './utils/interactive.js';
+export { watchFile } from './utils/watcher.js';
+// ---------------------------------------------------------------------------
+// Pricing
+// ---------------------------------------------------------------------------
+export { FAMILY_A_PRICING, DEFAULT_PRICING_SERVER, fetchPricing, formatPrice } from './pricing.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/parser/har-filter.d.ts

@@ -0,0 +1,9 @@
+import type { Entry } from 'har-format';
+export interface FilterOptions {
+    /** Only include entries from these domains. If empty, include all. */
+    allowedDomains?: string[];
+    /** Include requests that returned errors (4xx/5xx). Default: false */
+    includeErrors?: boolean;
+}
+export declare function filterHarEntries(entries: Entry[], options?: FilterOptions): Entry[];
+//# sourceMappingURL=har-filter.d.ts.map

package/dist/parser/har-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"har-filter.d.ts","sourceRoot":"","sources":["../../src/parser/har-filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAiCxC,MAAM,WAAW,aAAa;IAC5B,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,sEAAsE;IACtE,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,GAAE,aAAkB,GAAG,KAAK,EAAE,CA4CvF"}

package/dist/parser/har-filter.js

@@ -0,0 +1,72 @@
+const NOISE_EXTENSIONS = /\.(js|css|png|jpg|jpeg|gif|svg|ico|woff|woff2|ttf|eot|map|webp|avif)(\?|$)/i;
+const ANALYTICS_DOMAINS = [
+    'google-analytics.com',
+    'googletagmanager.com',
+    'analytics.',
+    'mixpanel.com',
+    'segment.io',
+    'segment.com',
+    'hotjar.com',
+    'doubleclick.net',
+    'facebook.net',
+    'fbcdn.net',
+    'sentry.io',
+    'newrelic.com',
+    'datadoghq.com',
+    'clarity.ms',
+];
+const SKIP_MIME_TYPES = [
+    'text/html',
+    'text/css',
+    'application/javascript',
+    'text/javascript',
+    'image/',
+    'font/',
+    'audio/',
+    'video/',
+];
+export function filterHarEntries(entries, options = {}) {
+    return entries.filter((entry) => {
+        const url = entry.request.url;
+        let hostname;
+        try {
+            hostname = new URL(url).hostname;
+        }
+        catch {
+            return false;
+        }
+        // Skip non-HTTP methods
+        const method = entry.request.method.toUpperCase();
+        if (method === 'CONNECT' || method === 'OPTIONS')
+            return false;
+        // Skip static assets by extension
+        const pathname = new URL(url).pathname;
+        if (NOISE_EXTENSIONS.test(pathname))
+            return false;
+        // Skip analytics/tracking domains
+        if (ANALYTICS_DOMAINS.some((d) => hostname.includes(d)))
+            return false;
+        // Domain allowlist
+        if (options.allowedDomains?.length) {
+            if (!options.allowedDomains.some((d) => hostname.includes(d)))
+                return false;
+        }
+        // Skip error responses unless requested
+        if (!options.includeErrors && entry.response.status >= 400)
+            return false;
+        // Skip non-API content types in response
+        const responseMime = entry.response.content?.mimeType ?? '';
+        if (SKIP_MIME_TYPES.some((m) => responseMime.startsWith(m))) {
+            // Exception: text/html that's actually an API response (rare but possible)
+            // Keep if response body looks like JSON
+            if (responseMime.startsWith('text/html') && !entry.response.content?.text?.startsWith('{')) {
+                return false;
+            }
+            if (!responseMime.includes('json') && !responseMime.includes('xml')) {
+                return false;
+            }
+        }
+        return true;
+    });
+}
+//# sourceMappingURL=har-filter.js.map

package/dist/parser/har-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"har-filter.js","sourceRoot":"","sources":["../../src/parser/har-filter.ts"],"names":[],"mappings":"AAEA,MAAM,gBAAgB,GACpB,6EAA6E,CAAC;AAEhF,MAAM,iBAAiB,GAAG;IACxB,sBAAsB;IACtB,sBAAsB;IACtB,YAAY;IACZ,cAAc;IACd,YAAY;IACZ,aAAa;IACb,YAAY;IACZ,iBAAiB;IACjB,cAAc;IACd,WAAW;IACX,WAAW;IACX,cAAc;IACd,eAAe;IACf,YAAY;CACb,CAAC;AAEF,MAAM,eAAe,GAAG;IACtB,WAAW;IACX,UAAU;IACV,wBAAwB;IACxB,iBAAiB;IACjB,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,QAAQ;CACT,CAAC;AASF,MAAM,UAAU,gBAAgB,CAAC,OAAgB,EAAE,UAAyB,EAAE;IAC5E,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;QAC9B,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAC9B,IAAI,QAAgB,CAAC;QACrB,IAAI,CAAC;YACH,QAAQ,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;QAED,wBAAwB;QACxB,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QAClD,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAE/D,kCAAkC;QAClC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;QACvC,IAAI,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO,KAAK,CAAC;QAElD,kCAAkC;QAClC,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QAEtE,mBAAmB;QACnB,IAAI,OAAO,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;YACnC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAC;QAC9E,CAAC;QAED,wCAAwC;QACxC,IAAI,CAAC,OAAO,CAAC,aAAa,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,IAAI,GAAG;YAAE,OAAO,KAAK,CAAC;QAEzE,yCAAyC;QACzC,MAAM,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC;QAC5D,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5D,2EAA2E;YAC3E,wCAAwC;YACxC,IAAI,YAAY,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3F,OAAO,KAAK,CAAC;YACf,CAAC;YACD,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpE,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/parser/har-loader.d.ts

@@ -0,0 +1,3 @@
+import type { Har } from 'har-format';
+export declare function loadHarFile(filePath: string): Promise<Har>;
+//# sourceMappingURL=har-loader.d.ts.map

package/dist/parser/har-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"har-loader.d.ts","sourceRoot":"","sources":["../../src/parser/har-loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAItC,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAgBhE"}

package/dist/parser/har-loader.js

@@ -0,0 +1,15 @@
+import { readFile, stat } from 'node:fs/promises';
+const MAX_HAR_SIZE_BYTES = 50 * 1024 * 1024; // 50 MB
+export async function loadHarFile(filePath) {
+    const fileInfo = await stat(filePath);
+    if (fileInfo.size > MAX_HAR_SIZE_BYTES) {
+        throw new Error(`HAR file is too large (${Math.round(fileInfo.size / 1024 / 1024)} MB). Maximum is 50 MB.`);
+    }
+    const raw = await readFile(filePath, 'utf-8');
+    const har = JSON.parse(raw);
+    if (!har.log?.entries || !Array.isArray(har.log.entries)) {
+        throw new Error('Invalid HAR file: missing log.entries array');
+    }
+    return har;
+}
+//# sourceMappingURL=har-loader.js.map

package/dist/parser/har-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"har-loader.js","sourceRoot":"","sources":["../../src/parser/har-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAGlD,MAAM,kBAAkB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,QAAQ;AAErD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB;IAChD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtC,IAAI,QAAQ,CAAC,IAAI,GAAG,kBAAkB,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CACb,0BAA0B,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,yBAAyB,CAC3F,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9C,MAAM,GAAG,GAAQ,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAEjC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/parser/har-normalizer.d.ts

@@ -0,0 +1,21 @@
+import type { Entry } from 'har-format';
+export interface NormalizedEntry {
+    entry: Entry;
+    normalizedPath: string;
+    baseUrl: string;
+    pathParams: PathParam[];
+    queryParams: QueryParam[];
+}
+export interface PathParam {
+    name: string;
+    position: number;
+    exampleValue: string;
+    inferredType: 'uuid' | 'integer' | 'string';
+}
+export interface QueryParam {
+    name: string;
+    exampleValue: string;
+    inferredType: 'integer' | 'boolean' | 'string';
+}
+export declare function normalizeEntry(entry: Entry): NormalizedEntry;
+//# sourceMappingURL=har-normalizer.d.ts.map

package/dist/parser/har-normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"har-normalizer.d.ts","sourceRoot":"","sources":["../../src/parser/har-normalizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAOxC,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,KAAK,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;CAC7C;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;CAChD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,eAAe,CAgD5D"}

package/dist/parser/har-normalizer.js

@@ -0,0 +1,79 @@
+const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const NUMERIC_ID_PATTERN = /^\d+$/;
+const MONGO_ID_PATTERN = /^[0-9a-f]{24}$/i;
+const SHORT_ID_PATTERN = /^[a-zA-Z0-9]{8,22}$/;
+export function normalizeEntry(entry) {
+    const url = new URL(entry.request.url);
+    const baseUrl = `${url.protocol}//${url.host}`;
+    const segments = url.pathname.split('/').filter(Boolean);
+    const pathParams = [];
+    let paramCounter = 0;
+    const normalizedSegments = segments.map((segment, i) => {
+        if (UUID_PATTERN.test(segment)) {
+            const name = deriveParamName(segments, i, paramCounter++);
+            pathParams.push({ name, position: i, exampleValue: segment, inferredType: 'uuid' });
+            return `{${name}}`;
+        }
+        if (NUMERIC_ID_PATTERN.test(segment) && segment.length < 15) {
+            const name = deriveParamName(segments, i, paramCounter++);
+            pathParams.push({ name, position: i, exampleValue: segment, inferredType: 'integer' });
+            return `{${name}}`;
+        }
+        if (MONGO_ID_PATTERN.test(segment)) {
+            const name = deriveParamName(segments, i, paramCounter++);
+            pathParams.push({ name, position: i, exampleValue: segment, inferredType: 'string' });
+            return `{${name}}`;
+        }
+        // Heuristic: if previous segment is a known collection name and this looks like an ID
+        if (i > 0 && isCollectionName(segments[i - 1]) && SHORT_ID_PATTERN.test(segment)) {
+            const prevSegment = segments[i - 1];
+            // Only treat as ID if short enough and not a known sub-resource
+            if (segment.length <= 22 && !isCollectionName(segment)) {
+                const name = singularize(prevSegment) + 'Id';
+                pathParams.push({ name, position: i, exampleValue: segment, inferredType: 'string' });
+                return `{${name}}`;
+            }
+        }
+        return segment;
+    });
+    const normalizedPath = '/' + normalizedSegments.join('/');
+    const queryParams = [];
+    for (const qs of entry.request.queryString) {
+        queryParams.push({
+            name: qs.name,
+            exampleValue: qs.value,
+            inferredType: inferQueryParamType(qs.value),
+        });
+    }
+    return { entry, normalizedPath, baseUrl, pathParams, queryParams };
+}
+function deriveParamName(segments, currentIndex, counter) {
+    if (currentIndex > 0) {
+        const prev = segments[currentIndex - 1];
+        if (isCollectionName(prev)) {
+            return singularize(prev) + 'Id';
+        }
+    }
+    return counter === 0 ? 'id' : `id${counter + 1}`;
+}
+function isCollectionName(segment) {
+    // Common REST patterns: plurals, known resource names
+    return (/^[a-z][a-z0-9_-]*s$/i.test(segment) || ['api', 'v1', 'v2', 'v3'].includes(segment) === false);
+}
+function singularize(word) {
+    if (word.endsWith('ies'))
+        return word.slice(0, -3) + 'y';
+    if (word.endsWith('ses') || word.endsWith('xes') || word.endsWith('zes'))
+        return word.slice(0, -2);
+    if (word.endsWith('s') && !word.endsWith('ss'))
+        return word.slice(0, -1);
+    return word;
+}
+function inferQueryParamType(value) {
+    if (NUMERIC_ID_PATTERN.test(value))
+        return 'integer';
+    if (value === 'true' || value === 'false')
+        return 'boolean';
+    return 'string';
+}
+//# sourceMappingURL=har-normalizer.js.map

package/dist/parser/har-normalizer.js.map

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

package/dist/parser/index.d.ts

@@ -0,0 +1,11 @@
+export { loadOpenApiSpec } from './openapi-loader.js';
+export type { LoadResult } from './openapi-loader.js';
+export { extractOperations } from './operation-extractor.js';
+export type { ExtractionResult } from './operation-extractor.js';
+export { jsonSchemaToZodCode, buildOperationInputSchema } from './schema-converter.js';
+export { loadHarFile } from './har-loader.js';
+export { filterHarEntries } from './har-filter.js';
+export type { FilterOptions } from './har-filter.js';
+export { normalizeEntry } from './har-normalizer.js';
+export type { NormalizedEntry, PathParam, QueryParam } from './har-normalizer.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/parser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AACvF,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/parser/index.js

@@ -0,0 +1,7 @@
+export { loadOpenApiSpec } from './openapi-loader.js';
+export { extractOperations } from './operation-extractor.js';
+export { jsonSchemaToZodCode, buildOperationInputSchema } from './schema-converter.js';
+export { loadHarFile } from './har-loader.js';
+export { filterHarEntries } from './har-filter.js';
+export { normalizeEntry } from './har-normalizer.js';
+//# sourceMappingURL=index.js.map

package/dist/parser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AACvF,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/parser/openapi-loader.d.ts

@@ -0,0 +1,7 @@
+import type { OpenAPI } from 'openapi-types';
+export interface LoadResult {
+    api: OpenAPI.Document;
+    specPath: string;
+}
+export declare function loadOpenApiSpec(input: string): Promise<LoadResult>;
+//# sourceMappingURL=openapi-loader.d.ts.map

package/dist/parser/openapi-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-loader.d.ts","sourceRoot":"","sources":["../../src/parser/openapi-loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAG7C,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,OAAO,CAAC,QAAQ,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AA0VD,wBAAsB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAcxE"}