@contractspec/lib.source-extractors 0.2.0

package/dist/extractors/next-api/extractor.js

@@ -0,0 +1,80 @@
+import { BaseExtractor } from "../base.js";
+
+//#region src/extractors/next-api/extractor.ts
+/**
+* Next.js API Routes extractor.
+*
+* Extracts contract candidates from Next.js applications by parsing:
+* - App Router API routes (app/api/.../route.ts)
+* - Pages Router API routes (pages/api/.../*.ts)
+*/
+const PATTERNS = {
+	appRouterExport: /export\s+(?:async\s+)?function\s+(GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS)/gi,
+	pagesHandler: /export\s+default\s+(?:async\s+)?function/g,
+	zodSchema: /z\.\w+\(/g
+};
+var NextApiExtractor = class extends BaseExtractor {
+	id = "next-api";
+	name = "Next.js API Extractor";
+	frameworks = ["next-api"];
+	priority = 15;
+	async doExtract(ctx) {
+		const { project, fs } = ctx;
+		const appRoutes = await fs.glob("**/app/api/**/route.ts", { cwd: project.rootPath });
+		const pagesRoutes = await fs.glob("**/pages/api/**/*.ts", { cwd: project.rootPath });
+		const allRoutes = [...appRoutes, ...pagesRoutes];
+		ctx.ir.stats.filesScanned = allRoutes.length;
+		for (const file of allRoutes) {
+			const fullPath = `${project.rootPath}/${file}`;
+			const content = await fs.readFile(fullPath);
+			if (file.includes("/app/api/")) await this.extractAppRoutes(ctx, file, content);
+			else await this.extractPagesRoutes(ctx, file, content);
+		}
+	}
+	async extractAppRoutes(ctx, file, content) {
+		const pathMatch = file.match(/app\/api\/(.+)\/route\.ts$/);
+		const routePath = pathMatch ? `/api/${pathMatch[1]}` : "/api";
+		const matches = [...content.matchAll(PATTERNS.appRouterExport)];
+		for (const match of matches) {
+			const method = match[1]?.toUpperCase() ?? "GET";
+			const index = match.index ?? 0;
+			const lineNumber = content.slice(0, index).split("\n").length;
+			const hasZod = PATTERNS.zodSchema.test(content);
+			const endpoint = {
+				id: this.generateEndpointId(method, routePath),
+				method,
+				path: routePath.replace(/\[(\w+)\]/g, ":$1"),
+				kind: this.methodToOpKind(method),
+				handlerName: method,
+				source: this.createLocation(file, lineNumber, lineNumber + 10),
+				confidence: this.createConfidence(hasZod ? "high" : "medium", hasZod ? "explicit-schema" : "inferred-types"),
+				frameworkMeta: { routeType: "app-router" }
+			};
+			this.addEndpoint(ctx, endpoint);
+		}
+	}
+	async extractPagesRoutes(ctx, file, content) {
+		const pathMatch = file.match(/pages\/api\/(.+)\.ts$/);
+		const routePath = pathMatch ? `/api/${pathMatch[1]}` : "/api";
+		if (!PATTERNS.pagesHandler.test(content)) return;
+		const lineNumber = 1;
+		PATTERNS.zodSchema.test(content);
+		for (const method of ["GET", "POST"]) {
+			const endpoint = {
+				id: this.generateEndpointId(method, routePath),
+				method,
+				path: routePath.replace(/\[(\w+)\]/g, ":$1"),
+				kind: this.methodToOpKind(method),
+				handlerName: "handler",
+				source: this.createLocation(file, lineNumber, lineNumber + 20),
+				confidence: this.createConfidence("low", "naming-convention"),
+				frameworkMeta: { routeType: "pages-router" }
+			};
+			this.addEndpoint(ctx, endpoint);
+		}
+	}
+};
+
+//#endregion
+export { NextApiExtractor };
+//# sourceMappingURL=extractor.js.map

package/dist/extractors/next-api/extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.js","names":[],"sources":["../../../src/extractors/next-api/extractor.ts"],"sourcesContent":["/**\n * Next.js API Routes extractor.\n *\n * Extracts contract candidates from Next.js applications by parsing:\n * - App Router API routes (app/api/.../route.ts)\n * - Pages Router API routes (pages/api/.../*.ts)\n */\n\nimport { BaseExtractor, type ExtractionContext } from '../base';\nimport type { EndpointCandidate, HttpMethod } from '../../types';\n\nconst PATTERNS = {\n  appRouterExport:\n    /export\\s+(?:async\\s+)?function\\s+(GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS)/gi,\n  pagesHandler: /export\\s+default\\s+(?:async\\s+)?function/g,\n  zodSchema: /z\\.\\w+\\(/g,\n};\n\nexport class NextApiExtractor extends BaseExtractor {\n  id = 'next-api';\n  name = 'Next.js API Extractor';\n  frameworks = ['next-api'];\n  priority = 15;\n\n  protected async doExtract(ctx: ExtractionContext): Promise<void> {\n    const { project, fs } = ctx;\n\n    // Find App Router API routes\n    const appRoutes = await fs.glob('**/app/api/**/route.ts', {\n      cwd: project.rootPath,\n    });\n    // Find Pages Router API routes\n    const pagesRoutes = await fs.glob('**/pages/api/**/*.ts', {\n      cwd: project.rootPath,\n    });\n\n    const allRoutes = [...appRoutes, ...pagesRoutes];\n    ctx.ir.stats.filesScanned = allRoutes.length;\n\n    for (const file of allRoutes) {\n      const fullPath = `${project.rootPath}/${file}`;\n      const content = await fs.readFile(fullPath);\n\n      if (file.includes('/app/api/')) {\n        await this.extractAppRoutes(ctx, file, content);\n      } else {\n        await this.extractPagesRoutes(ctx, file, content);\n      }\n    }\n  }\n\n  private async extractAppRoutes(\n    ctx: ExtractionContext,\n    file: string,\n    content: string\n  ): Promise<void> {\n    // Derive path from file path\n    const pathMatch = file.match(/app\\/api\\/(.+)\\/route\\.ts$/);\n    const routePath = pathMatch ? `/api/${pathMatch[1]}` : '/api';\n\n    const matches = [...content.matchAll(PATTERNS.appRouterExport)];\n\n    for (const match of matches) {\n      const method = (match[1]?.toUpperCase() ?? 'GET') as HttpMethod;\n      const index = match.index ?? 0;\n      const lineNumber = content.slice(0, index).split('\\n').length;\n\n      const hasZod = PATTERNS.zodSchema.test(content);\n\n      const endpoint: EndpointCandidate = {\n        id: this.generateEndpointId(method, routePath),\n        method,\n        path: routePath.replace(/\\[(\\w+)\\]/g, ':$1'),\n        kind: this.methodToOpKind(method),\n        handlerName: method,\n        source: this.createLocation(file, lineNumber, lineNumber + 10),\n        confidence: this.createConfidence(\n          hasZod ? 'high' : 'medium',\n          hasZod ? 'explicit-schema' : 'inferred-types'\n        ),\n        frameworkMeta: { routeType: 'app-router' },\n      };\n\n      this.addEndpoint(ctx, endpoint);\n    }\n  }\n\n  private async extractPagesRoutes(\n    ctx: ExtractionContext,\n    file: string,\n    content: string\n  ): Promise<void> {\n    const pathMatch = file.match(/pages\\/api\\/(.+)\\.ts$/);\n    const routePath = pathMatch ? `/api/${pathMatch[1]}` : '/api';\n\n    if (!PATTERNS.pagesHandler.test(content)) return;\n\n    const lineNumber = 1;\n    const _hasZod = PATTERNS.zodSchema.test(content);\n\n    // Pages API routes can handle multiple methods\n    const methods: HttpMethod[] = ['GET', 'POST'];\n\n    for (const method of methods) {\n      const endpoint: EndpointCandidate = {\n        id: this.generateEndpointId(method, routePath),\n        method,\n        path: routePath.replace(/\\[(\\w+)\\]/g, ':$1'),\n        kind: this.methodToOpKind(method),\n        handlerName: 'handler',\n        source: this.createLocation(file, lineNumber, lineNumber + 20),\n        confidence: this.createConfidence('low', 'naming-convention'),\n        frameworkMeta: { routeType: 'pages-router' },\n      };\n\n      this.addEndpoint(ctx, endpoint);\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;AAWA,MAAM,WAAW;CACf,iBACE;CACF,cAAc;CACd,WAAW;CACZ;AAED,IAAa,mBAAb,cAAsC,cAAc;CAClD,KAAK;CACL,OAAO;CACP,aAAa,CAAC,WAAW;CACzB,WAAW;CAEX,MAAgB,UAAU,KAAuC;EAC/D,MAAM,EAAE,SAAS,OAAO;EAGxB,MAAM,YAAY,MAAM,GAAG,KAAK,0BAA0B,EACxD,KAAK,QAAQ,UACd,CAAC;EAEF,MAAM,cAAc,MAAM,GAAG,KAAK,wBAAwB,EACxD,KAAK,QAAQ,UACd,CAAC;EAEF,MAAM,YAAY,CAAC,GAAG,WAAW,GAAG,YAAY;AAChD,MAAI,GAAG,MAAM,eAAe,UAAU;AAEtC,OAAK,MAAM,QAAQ,WAAW;GAC5B,MAAM,WAAW,GAAG,QAAQ,SAAS,GAAG;GACxC,MAAM,UAAU,MAAM,GAAG,SAAS,SAAS;AAE3C,OAAI,KAAK,SAAS,YAAY,CAC5B,OAAM,KAAK,iBAAiB,KAAK,MAAM,QAAQ;OAE/C,OAAM,KAAK,mBAAmB,KAAK,MAAM,QAAQ;;;CAKvD,MAAc,iBACZ,KACA,MACA,SACe;EAEf,MAAM,YAAY,KAAK,MAAM,6BAA6B;EAC1D,MAAM,YAAY,YAAY,QAAQ,UAAU,OAAO;EAEvD,MAAM,UAAU,CAAC,GAAG,QAAQ,SAAS,SAAS,gBAAgB,CAAC;AAE/D,OAAK,MAAM,SAAS,SAAS;GAC3B,MAAM,SAAU,MAAM,IAAI,aAAa,IAAI;GAC3C,MAAM,QAAQ,MAAM,SAAS;GAC7B,MAAM,aAAa,QAAQ,MAAM,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC;GAEvD,MAAM,SAAS,SAAS,UAAU,KAAK,QAAQ;GAE/C,MAAM,WAA8B;IAClC,IAAI,KAAK,mBAAmB,QAAQ,UAAU;IAC9C;IACA,MAAM,UAAU,QAAQ,cAAc,MAAM;IAC5C,MAAM,KAAK,eAAe,OAAO;IACjC,aAAa;IACb,QAAQ,KAAK,eAAe,MAAM,YAAY,aAAa,GAAG;IAC9D,YAAY,KAAK,iBACf,SAAS,SAAS,UAClB,SAAS,oBAAoB,iBAC9B;IACD,eAAe,EAAE,WAAW,cAAc;IAC3C;AAED,QAAK,YAAY,KAAK,SAAS;;;CAInC,MAAc,mBACZ,KACA,MACA,SACe;EACf,MAAM,YAAY,KAAK,MAAM,wBAAwB;EACrD,MAAM,YAAY,YAAY,QAAQ,UAAU,OAAO;AAEvD,MAAI,CAAC,SAAS,aAAa,KAAK,QAAQ,CAAE;EAE1C,MAAM,aAAa;AACH,WAAS,UAAU,KAAK,QAAQ;AAKhD,OAAK,MAAM,UAFmB,CAAC,OAAO,OAAO,EAEf;GAC5B,MAAM,WAA8B;IAClC,IAAI,KAAK,mBAAmB,QAAQ,UAAU;IAC9C;IACA,MAAM,UAAU,QAAQ,cAAc,MAAM;IAC5C,MAAM,KAAK,eAAe,OAAO;IACjC,aAAa;IACb,QAAQ,KAAK,eAAe,MAAM,YAAY,aAAa,GAAG;IAC9D,YAAY,KAAK,iBAAiB,OAAO,oBAAoB;IAC7D,eAAe,EAAE,WAAW,gBAAgB;IAC7C;AAED,QAAK,YAAY,KAAK,SAAS"}

package/dist/extractors/trpc/extractor.d.ts

@@ -0,0 +1,15 @@
+import { BaseExtractor, ExtractionContext } from "../base.js";
+
+//#region src/extractors/trpc/extractor.d.ts
+
+declare class TrpcExtractor extends BaseExtractor {
+  id: string;
+  name: string;
+  frameworks: string[];
+  priority: number;
+  protected doExtract(ctx: ExtractionContext): Promise<void>;
+  private extractProcedures;
+}
+//#endregion
+export { TrpcExtractor };
+//# sourceMappingURL=extractor.d.ts.map

package/dist/extractors/trpc/extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.d.ts","names":[],"sources":["../../../src/extractors/trpc/extractor.ts"],"sourcesContent":[],"mappings":";;;;cAoBa,aAAA,SAAsB,aAAA;;;;;2BAMF,oBAAoB"}

package/dist/extractors/trpc/extractor.js

@@ -0,0 +1,71 @@
+import { BaseExtractor } from "../base.js";
+
+//#region src/extractors/trpc/extractor.ts
+/**
+* tRPC extractor.
+*
+* Extracts contract candidates from tRPC applications by parsing:
+* - router definitions
+* - procedure definitions (query, mutation)
+* - Zod input/output schemas
+*/
+const PATTERNS = {
+	procedure: /\.(query|mutation)\s*\(\s*(?:\{[^}]*\}|[^)]+)\)/gi,
+	procedureName: /(\w+)\s*:\s*(?:publicProcedure|protectedProcedure|procedure)/g,
+	zodInput: /\.input\s*\(\s*(\w+)/g,
+	zodOutput: /\.output\s*\(\s*(\w+)/g
+};
+var TrpcExtractor = class extends BaseExtractor {
+	id = "trpc";
+	name = "tRPC Extractor";
+	frameworks = ["trpc"];
+	priority = 15;
+	async doExtract(ctx) {
+		const { project, options, fs } = ctx;
+		const pattern = options.scope?.length ? options.scope.map((s) => `${s}/**/*.ts`).join(",") : "**/*.ts";
+		const files = await fs.glob(pattern, { cwd: project.rootPath });
+		ctx.ir.stats.filesScanned = files.length;
+		for (const file of files) {
+			if (file.includes("node_modules") || file.includes(".test.")) continue;
+			const fullPath = `${project.rootPath}/${file}`;
+			const content = await fs.readFile(fullPath);
+			if (!content.includes("trpc") && !content.includes("Procedure")) continue;
+			await this.extractProcedures(ctx, file, content);
+		}
+	}
+	async extractProcedures(ctx, file, content) {
+		const nameMatches = [...content.matchAll(PATTERNS.procedureName)];
+		for (const match of nameMatches) {
+			const procedureName = match[1] ?? "unknownProcedure";
+			const index = match.index ?? 0;
+			const lineNumber = content.slice(0, index).split("\n").length;
+			const afterMatch = content.slice(index, index + 500);
+			const isQuery = afterMatch.includes(".query(");
+			const isMutation = afterMatch.includes(".mutation(");
+			if (!isQuery && !isMutation) continue;
+			const hasZodInput = PATTERNS.zodInput.test(afterMatch);
+			const hasZodOutput = PATTERNS.zodOutput.test(afterMatch);
+			const hasSchema = hasZodInput || hasZodOutput;
+			const method = isMutation ? "POST" : "GET";
+			const endpoint = {
+				id: `trpc.${procedureName}`,
+				method,
+				path: `/trpc/${procedureName}`,
+				kind: isMutation ? "command" : "query",
+				handlerName: procedureName,
+				source: this.createLocation(file, lineNumber, lineNumber + 10),
+				confidence: this.createConfidence(hasSchema ? "high" : "medium", hasSchema ? "explicit-schema" : "inferred-types"),
+				frameworkMeta: {
+					procedureType: isMutation ? "mutation" : "query",
+					hasInput: hasZodInput,
+					hasOutput: hasZodOutput
+				}
+			};
+			this.addEndpoint(ctx, endpoint);
+		}
+	}
+};
+
+//#endregion
+export { TrpcExtractor };
+//# sourceMappingURL=extractor.js.map

package/dist/extractors/trpc/extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.js","names":[],"sources":["../../../src/extractors/trpc/extractor.ts"],"sourcesContent":["/**\n * tRPC extractor.\n *\n * Extracts contract candidates from tRPC applications by parsing:\n * - router definitions\n * - procedure definitions (query, mutation)\n * - Zod input/output schemas\n */\n\nimport { BaseExtractor, type ExtractionContext } from '../base';\nimport type { EndpointCandidate, HttpMethod } from '../../types';\n\nconst PATTERNS = {\n  procedure: /\\.(query|mutation)\\s*\\(\\s*(?:\\{[^}]*\\}|[^)]+)\\)/gi,\n  procedureName:\n    /(\\w+)\\s*:\\s*(?:publicProcedure|protectedProcedure|procedure)/g,\n  zodInput: /\\.input\\s*\\(\\s*(\\w+)/g,\n  zodOutput: /\\.output\\s*\\(\\s*(\\w+)/g,\n};\n\nexport class TrpcExtractor extends BaseExtractor {\n  id = 'trpc';\n  name = 'tRPC Extractor';\n  frameworks = ['trpc'];\n  priority = 15;\n\n  protected async doExtract(ctx: ExtractionContext): Promise<void> {\n    const { project, options, fs } = ctx;\n\n    const pattern = options.scope?.length\n      ? options.scope.map((s) => `${s}/**/*.ts`).join(',')\n      : '**/*.ts';\n\n    const files = await fs.glob(pattern, { cwd: project.rootPath });\n    ctx.ir.stats.filesScanned = files.length;\n\n    for (const file of files) {\n      if (file.includes('node_modules') || file.includes('.test.')) continue;\n\n      const fullPath = `${project.rootPath}/${file}`;\n      const content = await fs.readFile(fullPath);\n\n      if (!content.includes('trpc') && !content.includes('Procedure')) continue;\n\n      await this.extractProcedures(ctx, file, content);\n    }\n  }\n\n  private async extractProcedures(\n    ctx: ExtractionContext,\n    file: string,\n    content: string\n  ): Promise<void> {\n    const nameMatches = [...content.matchAll(PATTERNS.procedureName)];\n\n    for (const match of nameMatches) {\n      const procedureName = match[1] ?? 'unknownProcedure';\n      const index = match.index ?? 0;\n      const lineNumber = content.slice(0, index).split('\\n').length;\n\n      const afterMatch = content.slice(index, index + 500);\n      const isQuery = afterMatch.includes('.query(');\n      const isMutation = afterMatch.includes('.mutation(');\n\n      if (!isQuery && !isMutation) continue;\n\n      const hasZodInput = PATTERNS.zodInput.test(afterMatch);\n      const hasZodOutput = PATTERNS.zodOutput.test(afterMatch);\n      const hasSchema = hasZodInput || hasZodOutput;\n\n      const method: HttpMethod = isMutation ? 'POST' : 'GET';\n\n      const endpoint: EndpointCandidate = {\n        id: `trpc.${procedureName}`,\n        method,\n        path: `/trpc/${procedureName}`,\n        kind: isMutation ? 'command' : 'query',\n        handlerName: procedureName,\n        source: this.createLocation(file, lineNumber, lineNumber + 10),\n        confidence: this.createConfidence(\n          hasSchema ? 'high' : 'medium',\n          hasSchema ? 'explicit-schema' : 'inferred-types'\n        ),\n        frameworkMeta: {\n          procedureType: isMutation ? 'mutation' : 'query',\n          hasInput: hasZodInput,\n          hasOutput: hasZodOutput,\n        },\n      };\n\n      this.addEndpoint(ctx, endpoint);\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;AAYA,MAAM,WAAW;CACf,WAAW;CACX,eACE;CACF,UAAU;CACV,WAAW;CACZ;AAED,IAAa,gBAAb,cAAmC,cAAc;CAC/C,KAAK;CACL,OAAO;CACP,aAAa,CAAC,OAAO;CACrB,WAAW;CAEX,MAAgB,UAAU,KAAuC;EAC/D,MAAM,EAAE,SAAS,SAAS,OAAO;EAEjC,MAAM,UAAU,QAAQ,OAAO,SAC3B,QAAQ,MAAM,KAAK,MAAM,GAAG,EAAE,UAAU,CAAC,KAAK,IAAI,GAClD;EAEJ,MAAM,QAAQ,MAAM,GAAG,KAAK,SAAS,EAAE,KAAK,QAAQ,UAAU,CAAC;AAC/D,MAAI,GAAG,MAAM,eAAe,MAAM;AAElC,OAAK,MAAM,QAAQ,OAAO;AACxB,OAAI,KAAK,SAAS,eAAe,IAAI,KAAK,SAAS,SAAS,CAAE;GAE9D,MAAM,WAAW,GAAG,QAAQ,SAAS,GAAG;GACxC,MAAM,UAAU,MAAM,GAAG,SAAS,SAAS;AAE3C,OAAI,CAAC,QAAQ,SAAS,OAAO,IAAI,CAAC,QAAQ,SAAS,YAAY,CAAE;AAEjE,SAAM,KAAK,kBAAkB,KAAK,MAAM,QAAQ;;;CAIpD,MAAc,kBACZ,KACA,MACA,SACe;EACf,MAAM,cAAc,CAAC,GAAG,QAAQ,SAAS,SAAS,cAAc,CAAC;AAEjE,OAAK,MAAM,SAAS,aAAa;GAC/B,MAAM,gBAAgB,MAAM,MAAM;GAClC,MAAM,QAAQ,MAAM,SAAS;GAC7B,MAAM,aAAa,QAAQ,MAAM,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC;GAEvD,MAAM,aAAa,QAAQ,MAAM,OAAO,QAAQ,IAAI;GACpD,MAAM,UAAU,WAAW,SAAS,UAAU;GAC9C,MAAM,aAAa,WAAW,SAAS,aAAa;AAEpD,OAAI,CAAC,WAAW,CAAC,WAAY;GAE7B,MAAM,cAAc,SAAS,SAAS,KAAK,WAAW;GACtD,MAAM,eAAe,SAAS,UAAU,KAAK,WAAW;GACxD,MAAM,YAAY,eAAe;GAEjC,MAAM,SAAqB,aAAa,SAAS;GAEjD,MAAM,WAA8B;IAClC,IAAI,QAAQ;IACZ;IACA,MAAM,SAAS;IACf,MAAM,aAAa,YAAY;IAC/B,aAAa;IACb,QAAQ,KAAK,eAAe,MAAM,YAAY,aAAa,GAAG;IAC9D,YAAY,KAAK,iBACf,YAAY,SAAS,UACrB,YAAY,oBAAoB,iBACjC;IACD,eAAe;KACb,eAAe,aAAa,aAAa;KACzC,UAAU;KACV,WAAW;KACZ;IACF;AAED,QAAK,YAAY,KAAK,SAAS"}

package/dist/extractors/zod/extractor.d.ts

@@ -0,0 +1,16 @@
+import { BaseExtractor, ExtractionContext } from "../base.js";
+
+//#region src/extractors/zod/extractor.d.ts
+
+declare class ZodSchemaExtractor extends BaseExtractor {
+  id: string;
+  name: string;
+  frameworks: string[];
+  priority: number;
+  detect(): Promise<boolean>;
+  protected doExtract(ctx: ExtractionContext): Promise<void>;
+  private extractSchemas;
+}
+//#endregion
+export { ZodSchemaExtractor };
+//# sourceMappingURL=extractor.d.ts.map

package/dist/extractors/zod/extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.d.ts","names":[],"sources":["../../../src/extractors/zod/extractor.ts"],"sourcesContent":[],"mappings":";;;;AAgBwC,cAA3B,kBAAA,SAA2B,aAAA,CAAA;EAAa,EAAA,EAAA,MAAA;;;;YAMnC;2BAKe,oBAAoB"}

package/dist/extractors/zod/extractor.js

@@ -0,0 +1,69 @@
+import { BaseExtractor } from "../base.js";
+
+//#region src/extractors/zod/extractor.ts
+/**
+* Zod schema extractor.
+*
+* Extracts standalone Zod schema definitions that aren't tied to a specific framework.
+* Useful for shared validation schemas.
+*/
+const PATTERNS = {
+	zodSchema: /(?:export\s+)?const\s+(\w+)\s*=\s*z\.(?:object|string|number|boolean|array|enum|union|intersection|literal|tuple|record)/g,
+	zodInfer: /type\s+(\w+)\s*=\s*z\.infer<typeof\s+(\w+)>/g
+};
+var ZodSchemaExtractor = class extends BaseExtractor {
+	id = "zod";
+	name = "Zod Schema Extractor";
+	frameworks = ["zod"];
+	priority = 5;
+	async detect() {
+		return true;
+	}
+	async doExtract(ctx) {
+		const { project, options, fs } = ctx;
+		const pattern = options.scope?.length ? options.scope.map((s) => `${s}/**/*.ts`).join(",") : "**/*.ts";
+		const files = await fs.glob(pattern, { cwd: project.rootPath });
+		ctx.ir.stats.filesScanned = files.length;
+		for (const file of files) {
+			if (file.includes("node_modules") || file.includes(".test.")) continue;
+			const fullPath = `${project.rootPath}/${file}`;
+			const content = await fs.readFile(fullPath);
+			if (!content.includes("z.")) continue;
+			await this.extractSchemas(ctx, file, content);
+		}
+	}
+	async extractSchemas(ctx, file, content) {
+		const matches = [...content.matchAll(PATTERNS.zodSchema)];
+		for (const match of matches) {
+			const name = match[1] ?? "unknownSchema";
+			const index = match.index ?? 0;
+			const lineNumber = content.slice(0, index).split("\n").length;
+			let depth = 0;
+			let endIndex = index;
+			for (let i = index; i < content.length; i++) {
+				const char = content[i];
+				if (char === "(" || char === "{" || char === "[") depth++;
+				if (char === ")" || char === "}" || char === "]") depth--;
+				if (depth === 0 && (char === ";" || char === "\n")) {
+					endIndex = i;
+					break;
+				}
+			}
+			const rawDefinition = content.slice(index, endIndex + 1);
+			const endLineNumber = lineNumber + rawDefinition.split("\n").length - 1;
+			const schema = {
+				id: this.generateSchemaId(name, file),
+				name,
+				schemaType: "zod",
+				rawDefinition,
+				source: this.createLocation(file, lineNumber, endLineNumber),
+				confidence: this.createConfidence("high", "explicit-schema")
+			};
+			this.addSchema(ctx, schema);
+		}
+	}
+};
+
+//#endregion
+export { ZodSchemaExtractor };
+//# sourceMappingURL=extractor.js.map

package/dist/extractors/zod/extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.js","names":[],"sources":["../../../src/extractors/zod/extractor.ts"],"sourcesContent":["/**\n * Zod schema extractor.\n *\n * Extracts standalone Zod schema definitions that aren't tied to a specific framework.\n * Useful for shared validation schemas.\n */\n\nimport { BaseExtractor, type ExtractionContext } from '../base';\nimport type { SchemaCandidate } from '../../types';\n\nconst PATTERNS = {\n  zodSchema:\n    /(?:export\\s+)?const\\s+(\\w+)\\s*=\\s*z\\.(?:object|string|number|boolean|array|enum|union|intersection|literal|tuple|record)/g,\n  zodInfer: /type\\s+(\\w+)\\s*=\\s*z\\.infer<typeof\\s+(\\w+)>/g,\n};\n\nexport class ZodSchemaExtractor extends BaseExtractor {\n  id = 'zod';\n  name = 'Zod Schema Extractor';\n  frameworks = ['zod'];\n  priority = 5; // Lower priority, runs after framework extractors\n\n  async detect(): Promise<boolean> {\n    // Always available as a fallback\n    return true;\n  }\n\n  protected async doExtract(ctx: ExtractionContext): Promise<void> {\n    const { project, options, fs } = ctx;\n\n    const pattern = options.scope?.length\n      ? options.scope.map((s) => `${s}/**/*.ts`).join(',')\n      : '**/*.ts';\n\n    const files = await fs.glob(pattern, { cwd: project.rootPath });\n    ctx.ir.stats.filesScanned = files.length;\n\n    for (const file of files) {\n      if (file.includes('node_modules') || file.includes('.test.')) continue;\n\n      const fullPath = `${project.rootPath}/${file}`;\n      const content = await fs.readFile(fullPath);\n\n      if (!content.includes('z.')) continue;\n\n      await this.extractSchemas(ctx, file, content);\n    }\n  }\n\n  private async extractSchemas(\n    ctx: ExtractionContext,\n    file: string,\n    content: string\n  ): Promise<void> {\n    const matches = [...content.matchAll(PATTERNS.zodSchema)];\n\n    for (const match of matches) {\n      const name = match[1] ?? 'unknownSchema';\n      const index = match.index ?? 0;\n      const lineNumber = content.slice(0, index).split('\\n').length;\n\n      // Find the end of the schema definition (roughly)\n      let depth = 0;\n      let endIndex = index;\n      for (let i = index; i < content.length; i++) {\n        const char = content[i];\n        if (char === '(' || char === '{' || char === '[') depth++;\n        if (char === ')' || char === '}' || char === ']') depth--;\n        if (depth === 0 && (char === ';' || char === '\\n')) {\n          endIndex = i;\n          break;\n        }\n      }\n\n      const rawDefinition = content.slice(index, endIndex + 1);\n      const endLineNumber = lineNumber + rawDefinition.split('\\n').length - 1;\n\n      const schema: SchemaCandidate = {\n        id: this.generateSchemaId(name, file),\n        name,\n        schemaType: 'zod',\n        rawDefinition,\n        source: this.createLocation(file, lineNumber, endLineNumber),\n        confidence: this.createConfidence('high', 'explicit-schema'),\n      };\n\n      this.addSchema(ctx, schema);\n    }\n  }\n}\n"],"mappings":";;;;;;;;;AAUA,MAAM,WAAW;CACf,WACE;CACF,UAAU;CACX;AAED,IAAa,qBAAb,cAAwC,cAAc;CACpD,KAAK;CACL,OAAO;CACP,aAAa,CAAC,MAAM;CACpB,WAAW;CAEX,MAAM,SAA2B;AAE/B,SAAO;;CAGT,MAAgB,UAAU,KAAuC;EAC/D,MAAM,EAAE,SAAS,SAAS,OAAO;EAEjC,MAAM,UAAU,QAAQ,OAAO,SAC3B,QAAQ,MAAM,KAAK,MAAM,GAAG,EAAE,UAAU,CAAC,KAAK,IAAI,GAClD;EAEJ,MAAM,QAAQ,MAAM,GAAG,KAAK,SAAS,EAAE,KAAK,QAAQ,UAAU,CAAC;AAC/D,MAAI,GAAG,MAAM,eAAe,MAAM;AAElC,OAAK,MAAM,QAAQ,OAAO;AACxB,OAAI,KAAK,SAAS,eAAe,IAAI,KAAK,SAAS,SAAS,CAAE;GAE9D,MAAM,WAAW,GAAG,QAAQ,SAAS,GAAG;GACxC,MAAM,UAAU,MAAM,GAAG,SAAS,SAAS;AAE3C,OAAI,CAAC,QAAQ,SAAS,KAAK,CAAE;AAE7B,SAAM,KAAK,eAAe,KAAK,MAAM,QAAQ;;;CAIjD,MAAc,eACZ,KACA,MACA,SACe;EACf,MAAM,UAAU,CAAC,GAAG,QAAQ,SAAS,SAAS,UAAU,CAAC;AAEzD,OAAK,MAAM,SAAS,SAAS;GAC3B,MAAM,OAAO,MAAM,MAAM;GACzB,MAAM,QAAQ,MAAM,SAAS;GAC7B,MAAM,aAAa,QAAQ,MAAM,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC;GAGvD,IAAI,QAAQ;GACZ,IAAI,WAAW;AACf,QAAK,IAAI,IAAI,OAAO,IAAI,QAAQ,QAAQ,KAAK;IAC3C,MAAM,OAAO,QAAQ;AACrB,QAAI,SAAS,OAAO,SAAS,OAAO,SAAS,IAAK;AAClD,QAAI,SAAS,OAAO,SAAS,OAAO,SAAS,IAAK;AAClD,QAAI,UAAU,MAAM,SAAS,OAAO,SAAS,OAAO;AAClD,gBAAW;AACX;;;GAIJ,MAAM,gBAAgB,QAAQ,MAAM,OAAO,WAAW,EAAE;GACxD,MAAM,gBAAgB,aAAa,cAAc,MAAM,KAAK,CAAC,SAAS;GAEtE,MAAM,SAA0B;IAC9B,IAAI,KAAK,iBAAiB,MAAM,KAAK;IACrC;IACA,YAAY;IACZ;IACA,QAAQ,KAAK,eAAe,MAAM,YAAY,cAAc;IAC5D,YAAY,KAAK,iBAAiB,QAAQ,kBAAkB;IAC7D;AAED,QAAK,UAAU,KAAK,OAAO"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+import { Ambiguity, ConfidenceLevel, ConfidenceMeta, ConfidenceReason, EndpointCandidate, ErrorCandidate, ErrorRef, EventCandidate, ExtractError, ExtractOptions, ExtractResult, FrameworkInfo, HttpMethod, ImportIR, OpKind, ProjectInfo, SchemaCandidate, SchemaField, SchemaRef, SourceLocation } from "./types.js";
+import { index_d_exports } from "./codegen/index.js";
+import { ExtractorRegistry, SourceExtractor, extractorRegistry, registerBuiltInExtractors } from "./registry.js";
+import { index_d_exports as index_d_exports$1 } from "./extractors/index.js";
+import { detectFramework, detectFrameworksFromCode, detectFrameworksFromPackageJson, detectFrameworksFromPaths, getSupportedFrameworks, isFrameworkSupported, mergeFrameworkDetections } from "./detect.js";
+import { createEmptyIR, extractFromProject, mergeIRs } from "./extract.js";
+export { Ambiguity, ConfidenceLevel, ConfidenceMeta, ConfidenceReason, EndpointCandidate, ErrorCandidate, ErrorRef, EventCandidate, ExtractError, ExtractOptions, ExtractResult, ExtractorRegistry, FrameworkInfo, HttpMethod, ImportIR, OpKind, ProjectInfo, SchemaCandidate, SchemaField, SchemaRef, SourceExtractor, SourceLocation, index_d_exports as codegen, createEmptyIR, detectFramework, detectFrameworksFromCode, detectFrameworksFromPackageJson, detectFrameworksFromPaths, extractFromProject, extractorRegistry, index_d_exports$1 as extractors, getSupportedFrameworks, isFrameworkSupported, mergeFrameworkDetections, mergeIRs, registerBuiltInExtractors };

package/dist/index.js

@@ -0,0 +1,7 @@
+import { ExtractorRegistry, extractorRegistry, registerBuiltInExtractors } from "./registry.js";
+import { detectFramework, detectFrameworksFromCode, detectFrameworksFromPackageJson, detectFrameworksFromPaths, getSupportedFrameworks, isFrameworkSupported, mergeFrameworkDetections } from "./detect.js";
+import { createEmptyIR, extractFromProject, mergeIRs } from "./extract.js";
+import { extractors_exports } from "./extractors/index.js";
+import { codegen_exports } from "./codegen/index.js";
+
+export { ExtractorRegistry, codegen_exports as codegen, createEmptyIR, detectFramework, detectFrameworksFromCode, detectFrameworksFromPackageJson, detectFrameworksFromPaths, extractFromProject, extractorRegistry, extractors_exports as extractors, getSupportedFrameworks, isFrameworkSupported, mergeFrameworkDetections, mergeIRs, registerBuiltInExtractors };

package/dist/registry.d.ts

@@ -0,0 +1,85 @@
+import { ExtractOptions, ExtractResult, ProjectInfo } from "./types.js";
+
+//#region src/registry.d.ts
+
+/**
+ * Interface that all source extractors must implement.
+ */
+interface SourceExtractor {
+  /** Unique identifier for this extractor */
+  id: string;
+  /** Human-readable name */
+  name: string;
+  /** Frameworks this extractor supports */
+  frameworks: string[];
+  /** Priority (higher = preferred when multiple match) */
+  priority: number;
+  /**
+   * Detect if this extractor can handle the given project.
+   * @param project Project information
+   * @returns true if this extractor should be used
+   */
+  detect(project: ProjectInfo): Promise<boolean>;
+  /**
+   * Extract contract candidates from the project.
+   * @param project Project information
+   * @param options Extraction options
+   * @returns Extraction result with IR
+   */
+  extract(project: ProjectInfo, options: ExtractOptions): Promise<ExtractResult>;
+}
+/**
+ * Registry for source extractor plugins.
+ */
+declare class ExtractorRegistry {
+  private extractors;
+  /**
+   * Register an extractor plugin.
+   */
+  register(extractor: SourceExtractor): void;
+  /**
+   * Unregister an extractor plugin.
+   */
+  unregister(id: string): boolean;
+  /**
+   * Get an extractor by ID.
+   */
+  get(id: string): SourceExtractor | undefined;
+  /**
+   * Get all registered extractors.
+   */
+  getAll(): SourceExtractor[];
+  /**
+   * Find extractors that can handle the given project.
+   * Returns extractors sorted by priority (highest first).
+   */
+  findMatching(project: ProjectInfo): Promise<SourceExtractor[]>;
+  /**
+   * Find extractors for a specific framework.
+   */
+  findByFramework(framework: string): SourceExtractor[];
+  /**
+   * Alias for findByFramework.
+   */
+  findForFramework(framework: string): SourceExtractor[];
+  /**
+   * Check if an extractor exists for the given framework.
+   */
+  hasExtractorFor(framework: string): boolean;
+  /**
+   * Get list of all supported framework IDs.
+   */
+  getSupportedFrameworks(): string[];
+}
+/**
+ * Global extractor registry instance.
+ */
+declare const extractorRegistry: ExtractorRegistry;
+/**
+ * Register built-in extractors.
+ * Called automatically when the module is imported.
+ */
+declare function registerBuiltInExtractors(): void;
+//#endregion
+export { ExtractorRegistry, SourceExtractor, extractorRegistry, registerBuiltInExtractors };
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","names":[],"sources":["../src/registry.ts"],"sourcesContent":[],"mappings":";;;;;;;AAqCK,UA1BY,eAAA,CA0BZ;EAAO;EAMC,EAAA,EAAA,MAAA;EAMS;EAcH,IAAA,EAAA,MAAA;EAOP;EAQkB,UAAA,EAAA,MAAA,EAAA;EAAsB;EAAR,QAAA,EAAA,MAAA;EAmBN;;;AAoDtC;AAMA;kBAjIkB,cAAc;;;;;;;mBASnB,sBACA,iBACR,QAAQ;;;;;cAMA,iBAAA;;;;;sBAMS;;;;;;;;mBAcH;;;;YAOP;;;;;wBAQkB,cAAc,QAAQ;;;;sCAmBd;;;;uCAeC;;;;;;;;;;;;;cAqC1B,mBAAiB;;;;;iBAMd,yBAAA,CAAA"}

package/dist/registry.js

@@ -0,0 +1,87 @@
+//#region src/registry.ts
+/**
+* Registry for source extractor plugins.
+*/
+var ExtractorRegistry = class {
+	extractors = /* @__PURE__ */ new Map();
+	/**
+	* Register an extractor plugin.
+	*/
+	register(extractor) {
+		this.extractors.set(extractor.id, extractor);
+	}
+	/**
+	* Unregister an extractor plugin.
+	*/
+	unregister(id) {
+		return this.extractors.delete(id);
+	}
+	/**
+	* Get an extractor by ID.
+	*/
+	get(id) {
+		return this.extractors.get(id);
+	}
+	/**
+	* Get all registered extractors.
+	*/
+	getAll() {
+		return Array.from(this.extractors.values());
+	}
+	/**
+	* Find extractors that can handle the given project.
+	* Returns extractors sorted by priority (highest first).
+	*/
+	async findMatching(project) {
+		const matches = [];
+		for (const extractor of this.extractors.values()) try {
+			if (await extractor.detect(project)) matches.push(extractor);
+		} catch {}
+		return matches.sort((a, b) => b.priority - a.priority);
+	}
+	/**
+	* Find extractors for a specific framework.
+	*/
+	findByFramework(framework) {
+		const matches = [];
+		for (const extractor of this.extractors.values()) if (extractor.frameworks.includes(framework)) matches.push(extractor);
+		return matches.sort((a, b) => b.priority - a.priority);
+	}
+	/**
+	* Alias for findByFramework.
+	*/
+	findForFramework(framework) {
+		return this.findByFramework(framework);
+	}
+	/**
+	* Check if an extractor exists for the given framework.
+	*/
+	hasExtractorFor(framework) {
+		for (const extractor of this.extractors.values()) if (extractor.frameworks.includes(framework) || extractor.id === framework) return true;
+		return false;
+	}
+	/**
+	* Get list of all supported framework IDs.
+	*/
+	getSupportedFrameworks() {
+		const frameworks = /* @__PURE__ */ new Set();
+		for (const extractor of this.extractors.values()) {
+			frameworks.add(extractor.id);
+			for (const fw of extractor.frameworks) frameworks.add(fw);
+		}
+		return Array.from(frameworks);
+	}
+};
+/**
+* Global extractor registry instance.
+*/
+const extractorRegistry = new ExtractorRegistry();
+/**
+* Register built-in extractors.
+* Called automatically when the module is imported.
+*/
+function registerBuiltInExtractors() {}
+
+//#endregion
+export { ExtractorRegistry, extractorRegistry, registerBuiltInExtractors };
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","names":[],"sources":["../src/registry.ts"],"sourcesContent":["/**\n * Source extractor registry.\n *\n * Manages extractor plugins and provides lookup by framework.\n */\n\nimport type { ExtractOptions, ExtractResult, ProjectInfo } from './types';\n\n/**\n * Interface that all source extractors must implement.\n */\nexport interface SourceExtractor {\n  /** Unique identifier for this extractor */\n  id: string;\n  /** Human-readable name */\n  name: string;\n  /** Frameworks this extractor supports */\n  frameworks: string[];\n  /** Priority (higher = preferred when multiple match) */\n  priority: number;\n\n  /**\n   * Detect if this extractor can handle the given project.\n   * @param project Project information\n   * @returns true if this extractor should be used\n   */\n  detect(project: ProjectInfo): Promise<boolean>;\n\n  /**\n   * Extract contract candidates from the project.\n   * @param project Project information\n   * @param options Extraction options\n   * @returns Extraction result with IR\n   */\n  extract(\n    project: ProjectInfo,\n    options: ExtractOptions\n  ): Promise<ExtractResult>;\n}\n\n/**\n * Registry for source extractor plugins.\n */\nexport class ExtractorRegistry {\n  private extractors = new Map<string, SourceExtractor>();\n\n  /**\n   * Register an extractor plugin.\n   */\n  register(extractor: SourceExtractor): void {\n    this.extractors.set(extractor.id, extractor);\n  }\n\n  /**\n   * Unregister an extractor plugin.\n   */\n  unregister(id: string): boolean {\n    return this.extractors.delete(id);\n  }\n\n  /**\n   * Get an extractor by ID.\n   */\n  get(id: string): SourceExtractor | undefined {\n    return this.extractors.get(id);\n  }\n\n  /**\n   * Get all registered extractors.\n   */\n  getAll(): SourceExtractor[] {\n    return Array.from(this.extractors.values());\n  }\n\n  /**\n   * Find extractors that can handle the given project.\n   * Returns extractors sorted by priority (highest first).\n   */\n  async findMatching(project: ProjectInfo): Promise<SourceExtractor[]> {\n    const matches: SourceExtractor[] = [];\n\n    for (const extractor of this.extractors.values()) {\n      try {\n        if (await extractor.detect(project)) {\n          matches.push(extractor);\n        }\n      } catch {\n        // Skip extractors that fail detection\n      }\n    }\n\n    return matches.sort((a, b) => b.priority - a.priority);\n  }\n\n  /**\n   * Find extractors for a specific framework.\n   */\n  findByFramework(framework: string): SourceExtractor[] {\n    const matches: SourceExtractor[] = [];\n\n    for (const extractor of this.extractors.values()) {\n      if (extractor.frameworks.includes(framework)) {\n        matches.push(extractor);\n      }\n    }\n\n    return matches.sort((a, b) => b.priority - a.priority);\n  }\n\n  /**\n   * Alias for findByFramework.\n   */\n  findForFramework(framework: string): SourceExtractor[] {\n    return this.findByFramework(framework);\n  }\n\n  /**\n   * Check if an extractor exists for the given framework.\n   */\n  hasExtractorFor(framework: string): boolean {\n    for (const extractor of this.extractors.values()) {\n      if (\n        extractor.frameworks.includes(framework) ||\n        extractor.id === framework\n      ) {\n        return true;\n      }\n    }\n    return false;\n  }\n\n  /**\n   * Get list of all supported framework IDs.\n   */\n  getSupportedFrameworks(): string[] {\n    const frameworks = new Set<string>();\n    for (const extractor of this.extractors.values()) {\n      frameworks.add(extractor.id);\n      for (const fw of extractor.frameworks) {\n        frameworks.add(fw);\n      }\n    }\n    return Array.from(frameworks);\n  }\n}\n\n/**\n * Global extractor registry instance.\n */\nexport const extractorRegistry = new ExtractorRegistry();\n\n/**\n * Register built-in extractors.\n * Called automatically when the module is imported.\n */\nexport function registerBuiltInExtractors(): void {\n  // Built-in extractors are registered in extractors/index.ts\n  // This function is called after all extractors are imported\n}\n"],"mappings":";;;;AA2CA,IAAa,oBAAb,MAA+B;CAC7B,AAAQ,6BAAa,IAAI,KAA8B;;;;CAKvD,SAAS,WAAkC;AACzC,OAAK,WAAW,IAAI,UAAU,IAAI,UAAU;;;;;CAM9C,WAAW,IAAqB;AAC9B,SAAO,KAAK,WAAW,OAAO,GAAG;;;;;CAMnC,IAAI,IAAyC;AAC3C,SAAO,KAAK,WAAW,IAAI,GAAG;;;;;CAMhC,SAA4B;AAC1B,SAAO,MAAM,KAAK,KAAK,WAAW,QAAQ,CAAC;;;;;;CAO7C,MAAM,aAAa,SAAkD;EACnE,MAAM,UAA6B,EAAE;AAErC,OAAK,MAAM,aAAa,KAAK,WAAW,QAAQ,CAC9C,KAAI;AACF,OAAI,MAAM,UAAU,OAAO,QAAQ,CACjC,SAAQ,KAAK,UAAU;UAEnB;AAKV,SAAO,QAAQ,MAAM,GAAG,MAAM,EAAE,WAAW,EAAE,SAAS;;;;;CAMxD,gBAAgB,WAAsC;EACpD,MAAM,UAA6B,EAAE;AAErC,OAAK,MAAM,aAAa,KAAK,WAAW,QAAQ,CAC9C,KAAI,UAAU,WAAW,SAAS,UAAU,CAC1C,SAAQ,KAAK,UAAU;AAI3B,SAAO,QAAQ,MAAM,GAAG,MAAM,EAAE,WAAW,EAAE,SAAS;;;;;CAMxD,iBAAiB,WAAsC;AACrD,SAAO,KAAK,gBAAgB,UAAU;;;;;CAMxC,gBAAgB,WAA4B;AAC1C,OAAK,MAAM,aAAa,KAAK,WAAW,QAAQ,CAC9C,KACE,UAAU,WAAW,SAAS,UAAU,IACxC,UAAU,OAAO,UAEjB,QAAO;AAGX,SAAO;;;;;CAMT,yBAAmC;EACjC,MAAM,6BAAa,IAAI,KAAa;AACpC,OAAK,MAAM,aAAa,KAAK,WAAW,QAAQ,EAAE;AAChD,cAAW,IAAI,UAAU,GAAG;AAC5B,QAAK,MAAM,MAAM,UAAU,WACzB,YAAW,IAAI,GAAG;;AAGtB,SAAO,MAAM,KAAK,WAAW;;;;;;AAOjC,MAAa,oBAAoB,IAAI,mBAAmB;;;;;AAMxD,SAAgB,4BAAkC"}