@contractspec/lib.source-extractors 0.2.0

package/dist/extractors/elysia/extractor.js

@@ -0,0 +1,58 @@
+import { BaseExtractor } from "../base.js";
+
+//#region src/extractors/elysia/extractor.ts
+/**
+* Elysia extractor.
+*
+* Extracts contract candidates from Elysia applications by parsing:
+* - app.get(), app.post(), etc. route handlers
+* - t.* schema definitions
+*/
+const PATTERNS = {
+	route: /\.(get|post|put|patch|delete)\s*\(\s*['"`]([^'"`]+)['"`]/gi,
+	tSchema: /body:\s*t\.\w+/g
+};
+var ElysiaExtractor = class extends BaseExtractor {
+	id = "elysia";
+	name = "Elysia Extractor";
+	frameworks = ["elysia"];
+	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("elysia")) continue;
+			await this.extractRoutes(ctx, file, content);
+		}
+	}
+	async extractRoutes(ctx, file, content) {
+		const matches = [...content.matchAll(PATTERNS.route)];
+		for (const match of matches) {
+			const method = match[1]?.toUpperCase() ?? "GET";
+			const path = match[2] ?? "/";
+			const index = match.index ?? 0;
+			const lineNumber = content.slice(0, index).split("\n").length;
+			const afterMatch = content.slice(index, index + 500);
+			const hasTSchema = PATTERNS.tSchema.test(afterMatch);
+			const endpoint = {
+				id: this.generateEndpointId(method, path),
+				method,
+				path,
+				kind: this.methodToOpKind(method),
+				handlerName: "handler",
+				source: this.createLocation(file, lineNumber, lineNumber + 5),
+				confidence: this.createConfidence(hasTSchema ? "high" : "medium", hasTSchema ? "explicit-schema" : "decorator-hints")
+			};
+			this.addEndpoint(ctx, endpoint);
+		}
+	}
+};
+
+//#endregion
+export { ElysiaExtractor };
+//# sourceMappingURL=extractor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.js","names":[],"sources":["../../../src/extractors/elysia/extractor.ts"],"sourcesContent":["/**\n * Elysia extractor.\n *\n * Extracts contract candidates from Elysia applications by parsing:\n * - app.get(), app.post(), etc. route handlers\n * - t.* schema definitions\n */\n\nimport { BaseExtractor, type ExtractionContext } from '../base';\nimport type { EndpointCandidate, HttpMethod } from '../../types';\n\nconst PATTERNS = {\n  route: /\\.(get|post|put|patch|delete)\\s*\\(\\s*['\"`]([^'\"`]+)['\"`]/gi,\n  tSchema: /body:\\s*t\\.\\w+/g,\n};\n\nexport class ElysiaExtractor extends BaseExtractor {\n  id = 'elysia';\n  name = 'Elysia Extractor';\n  frameworks = ['elysia'];\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('elysia')) continue;\n\n      await this.extractRoutes(ctx, file, content);\n    }\n  }\n\n  private async extractRoutes(\n    ctx: ExtractionContext,\n    file: string,\n    content: string\n  ): Promise<void> {\n    const matches = [...content.matchAll(PATTERNS.route)];\n\n    for (const match of matches) {\n      const method = (match[1]?.toUpperCase() ?? 'GET') as HttpMethod;\n      const path = match[2] ?? '/';\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 hasTSchema = PATTERNS.tSchema.test(afterMatch);\n\n      const endpoint: EndpointCandidate = {\n        id: this.generateEndpointId(method, path),\n        method,\n        path,\n        kind: this.methodToOpKind(method),\n        handlerName: 'handler',\n        source: this.createLocation(file, lineNumber, lineNumber + 5),\n        confidence: this.createConfidence(\n          hasTSchema ? 'high' : 'medium',\n          hasTSchema ? 'explicit-schema' : 'decorator-hints'\n        ),\n      };\n\n      this.addEndpoint(ctx, endpoint);\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;AAWA,MAAM,WAAW;CACf,OAAO;CACP,SAAS;CACV;AAED,IAAa,kBAAb,cAAqC,cAAc;CACjD,KAAK;CACL,OAAO;CACP,aAAa,CAAC,SAAS;CACvB,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,SAAS,CAAE;AAEjC,SAAM,KAAK,cAAc,KAAK,MAAM,QAAQ;;;CAIhD,MAAc,cACZ,KACA,MACA,SACe;EACf,MAAM,UAAU,CAAC,GAAG,QAAQ,SAAS,SAAS,MAAM,CAAC;AAErD,OAAK,MAAM,SAAS,SAAS;GAC3B,MAAM,SAAU,MAAM,IAAI,aAAa,IAAI;GAC3C,MAAM,OAAO,MAAM,MAAM;GACzB,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,aAAa,SAAS,QAAQ,KAAK,WAAW;GAEpD,MAAM,WAA8B;IAClC,IAAI,KAAK,mBAAmB,QAAQ,KAAK;IACzC;IACA;IACA,MAAM,KAAK,eAAe,OAAO;IACjC,aAAa;IACb,QAAQ,KAAK,eAAe,MAAM,YAAY,aAAa,EAAE;IAC7D,YAAY,KAAK,iBACf,aAAa,SAAS,UACtB,aAAa,oBAAoB,kBAClC;IACF;AAED,QAAK,YAAY,KAAK,SAAS"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.d.ts","names":[],"sources":["../../../src/extractors/express/extractor.ts"],"sourcesContent":[],"mappings":";;;;cAmBa,gBAAA,SAAyB,aAAA;;;;;2BAML,oBAAoB"}

package/dist/extractors/express/extractor.js

@@ -0,0 +1,61 @@
+import { BaseExtractor } from "../base.js";
+
+//#region src/extractors/express/extractor.ts
+/**
+* Express extractor.
+*
+* Extracts contract candidates from Express applications by parsing:
+* - app.get(), app.post(), etc. route handlers
+* - Router instances
+* - Zod validation middleware
+*/
+const PATTERNS = {
+	route: /(?:app|router)\.(get|post|put|patch|delete|head|options)\s*\(\s*['"`]([^'"`]+)['"`]/gi,
+	routerUse: /(?:app|router)\.use\s*\(\s*['"`]([^'"`]+)['"`]/gi,
+	zodValidate: /validate\s*\(\s*(\w+)\s*\)/g
+};
+var ExpressExtractor = class extends BaseExtractor {
+	id = "express";
+	name = "Express Extractor";
+	frameworks = ["express"];
+	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);
+			await this.extractRoutes(ctx, file, content);
+		}
+	}
+	async extractRoutes(ctx, file, content) {
+		const matches = [...content.matchAll(PATTERNS.route)];
+		for (const match of matches) {
+			const method = match[1]?.toUpperCase() ?? "GET";
+			const path = match[2] ?? "/";
+			const index = match.index ?? 0;
+			const lineNumber = content.slice(0, index).split("\n").length;
+			const afterMatch = content.slice(index, index + 500);
+			const handlerMatch = afterMatch.match(/(?:async\s+)?(?:function\s+)?(\w+)|,\s*(\w+)\s*\)/);
+			const handlerName = handlerMatch?.[1] ?? handlerMatch?.[2] ?? "handler";
+			const hasZodValidation = PATTERNS.zodValidate.test(afterMatch);
+			const endpoint = {
+				id: this.generateEndpointId(method, path, handlerName),
+				method,
+				path,
+				kind: this.methodToOpKind(method),
+				handlerName,
+				source: this.createLocation(file, lineNumber, lineNumber + 5),
+				confidence: this.createConfidence(hasZodValidation ? "high" : "medium", hasZodValidation ? "explicit-schema" : "decorator-hints")
+			};
+			this.addEndpoint(ctx, endpoint);
+		}
+	}
+};
+
+//#endregion
+export { ExpressExtractor };
+//# sourceMappingURL=extractor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.js","names":[],"sources":["../../../src/extractors/express/extractor.ts"],"sourcesContent":["/**\n * Express extractor.\n *\n * Extracts contract candidates from Express applications by parsing:\n * - app.get(), app.post(), etc. route handlers\n * - Router instances\n * - Zod validation middleware\n */\n\nimport { BaseExtractor, type ExtractionContext } from '../base';\nimport type { EndpointCandidate, HttpMethod } from '../../types';\n\nconst PATTERNS = {\n  route:\n    /(?:app|router)\\.(get|post|put|patch|delete|head|options)\\s*\\(\\s*['\"`]([^'\"`]+)['\"`]/gi,\n  routerUse: /(?:app|router)\\.use\\s*\\(\\s*['\"`]([^'\"`]+)['\"`]/gi,\n  zodValidate: /validate\\s*\\(\\s*(\\w+)\\s*\\)/g,\n};\n\nexport class ExpressExtractor extends BaseExtractor {\n  id = 'express';\n  name = 'Express Extractor';\n  frameworks = ['express'];\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      await this.extractRoutes(ctx, file, content);\n    }\n  }\n\n  private async extractRoutes(\n    ctx: ExtractionContext,\n    file: string,\n    content: string\n  ): Promise<void> {\n    const matches = [...content.matchAll(PATTERNS.route)];\n\n    for (const match of matches) {\n      const method = (match[1]?.toUpperCase() ?? 'GET') as HttpMethod;\n      const path = match[2] ?? '/';\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 handlerMatch = afterMatch.match(\n        /(?:async\\s+)?(?:function\\s+)?(\\w+)|,\\s*(\\w+)\\s*\\)/\n      );\n      const handlerName = handlerMatch?.[1] ?? handlerMatch?.[2] ?? 'handler';\n\n      const hasZodValidation = PATTERNS.zodValidate.test(afterMatch);\n\n      const endpoint: EndpointCandidate = {\n        id: this.generateEndpointId(method, path, handlerName),\n        method,\n        path,\n        kind: this.methodToOpKind(method),\n        handlerName,\n        source: this.createLocation(file, lineNumber, lineNumber + 5),\n        confidence: this.createConfidence(\n          hasZodValidation ? 'high' : 'medium',\n          hasZodValidation ? 'explicit-schema' : 'decorator-hints'\n        ),\n      };\n\n      this.addEndpoint(ctx, endpoint);\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;AAYA,MAAM,WAAW;CACf,OACE;CACF,WAAW;CACX,aAAa;CACd;AAED,IAAa,mBAAb,cAAsC,cAAc;CAClD,KAAK;CACL,OAAO;CACP,aAAa,CAAC,UAAU;CACxB,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,SAAM,KAAK,cAAc,KAAK,MAAM,QAAQ;;;CAIhD,MAAc,cACZ,KACA,MACA,SACe;EACf,MAAM,UAAU,CAAC,GAAG,QAAQ,SAAS,SAAS,MAAM,CAAC;AAErD,OAAK,MAAM,SAAS,SAAS;GAC3B,MAAM,SAAU,MAAM,IAAI,aAAa,IAAI;GAC3C,MAAM,OAAO,MAAM,MAAM;GACzB,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,eAAe,WAAW,MAC9B,oDACD;GACD,MAAM,cAAc,eAAe,MAAM,eAAe,MAAM;GAE9D,MAAM,mBAAmB,SAAS,YAAY,KAAK,WAAW;GAE9D,MAAM,WAA8B;IAClC,IAAI,KAAK,mBAAmB,QAAQ,MAAM,YAAY;IACtD;IACA;IACA,MAAM,KAAK,eAAe,OAAO;IACjC;IACA,QAAQ,KAAK,eAAe,MAAM,YAAY,aAAa,EAAE;IAC7D,YAAY,KAAK,iBACf,mBAAmB,SAAS,UAC5B,mBAAmB,oBAAoB,kBACxC;IACF;AAED,QAAK,YAAY,KAAK,SAAS"}

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

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

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

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

package/dist/extractors/fastify/extractor.js

@@ -0,0 +1,61 @@
+import { BaseExtractor } from "../base.js";
+
+//#region src/extractors/fastify/extractor.ts
+/**
+* Fastify extractor.
+*
+* Extracts contract candidates from Fastify applications by parsing:
+* - fastify.get(), fastify.post(), etc. route handlers
+* - JSON Schema definitions
+* - Route options with schema
+*/
+const PATTERNS = {
+	route: /(?:fastify|app|server)\.(get|post|put|patch|delete|head|options)\s*\(\s*['"`]([^'"`]+)['"`]/gi,
+	schemaOption: /schema\s*:\s*\{/g,
+	bodySchema: /body\s*:\s*(\w+)/g,
+	responseSchema: /response\s*:\s*\{/g
+};
+var FastifyExtractor = class extends BaseExtractor {
+	id = "fastify";
+	name = "Fastify Extractor";
+	frameworks = ["fastify"];
+	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);
+			await this.extractRoutes(ctx, file, content);
+		}
+	}
+	async extractRoutes(ctx, file, content) {
+		const matches = [...content.matchAll(PATTERNS.route)];
+		for (const match of matches) {
+			const method = match[1]?.toUpperCase() ?? "GET";
+			const path = match[2] ?? "/";
+			const index = match.index ?? 0;
+			const lineNumber = content.slice(0, index).split("\n").length;
+			const afterMatch = content.slice(index, index + 1e3);
+			const hasSchema = PATTERNS.schemaOption.test(afterMatch);
+			const endpoint = {
+				id: this.generateEndpointId(method, path),
+				method,
+				path,
+				kind: this.methodToOpKind(method),
+				handlerName: "handler",
+				source: this.createLocation(file, lineNumber, lineNumber + 10),
+				confidence: this.createConfidence(hasSchema ? "high" : "medium", hasSchema ? "explicit-schema" : "decorator-hints"),
+				frameworkMeta: { hasSchema }
+			};
+			this.addEndpoint(ctx, endpoint);
+		}
+	}
+};
+
+//#endregion
+export { FastifyExtractor };
+//# sourceMappingURL=extractor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.js","names":[],"sources":["../../../src/extractors/fastify/extractor.ts"],"sourcesContent":["/**\n * Fastify extractor.\n *\n * Extracts contract candidates from Fastify applications by parsing:\n * - fastify.get(), fastify.post(), etc. route handlers\n * - JSON Schema definitions\n * - Route options with schema\n */\n\nimport { BaseExtractor, type ExtractionContext } from '../base';\nimport type { EndpointCandidate, HttpMethod } from '../../types';\n\nconst PATTERNS = {\n  route:\n    /(?:fastify|app|server)\\.(get|post|put|patch|delete|head|options)\\s*\\(\\s*['\"`]([^'\"`]+)['\"`]/gi,\n  schemaOption: /schema\\s*:\\s*\\{/g,\n  bodySchema: /body\\s*:\\s*(\\w+)/g,\n  responseSchema: /response\\s*:\\s*\\{/g,\n};\n\nexport class FastifyExtractor extends BaseExtractor {\n  id = 'fastify';\n  name = 'Fastify Extractor';\n  frameworks = ['fastify'];\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      await this.extractRoutes(ctx, file, content);\n    }\n  }\n\n  private async extractRoutes(\n    ctx: ExtractionContext,\n    file: string,\n    content: string\n  ): Promise<void> {\n    const matches = [...content.matchAll(PATTERNS.route)];\n\n    for (const match of matches) {\n      const method = (match[1]?.toUpperCase() ?? 'GET') as HttpMethod;\n      const path = match[2] ?? '/';\n      const index = match.index ?? 0;\n      const lineNumber = content.slice(0, index).split('\\n').length;\n\n      const afterMatch = content.slice(index, index + 1000);\n      const hasSchema = PATTERNS.schemaOption.test(afterMatch);\n\n      const endpoint: EndpointCandidate = {\n        id: this.generateEndpointId(method, path),\n        method,\n        path,\n        kind: this.methodToOpKind(method),\n        handlerName: 'handler',\n        source: this.createLocation(file, lineNumber, lineNumber + 10),\n        confidence: this.createConfidence(\n          hasSchema ? 'high' : 'medium',\n          hasSchema ? 'explicit-schema' : 'decorator-hints'\n        ),\n        frameworkMeta: { hasSchema },\n      };\n\n      this.addEndpoint(ctx, endpoint);\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;AAYA,MAAM,WAAW;CACf,OACE;CACF,cAAc;CACd,YAAY;CACZ,gBAAgB;CACjB;AAED,IAAa,mBAAb,cAAsC,cAAc;CAClD,KAAK;CACL,OAAO;CACP,aAAa,CAAC,UAAU;CACxB,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,SAAM,KAAK,cAAc,KAAK,MAAM,QAAQ;;;CAIhD,MAAc,cACZ,KACA,MACA,SACe;EACf,MAAM,UAAU,CAAC,GAAG,QAAQ,SAAS,SAAS,MAAM,CAAC;AAErD,OAAK,MAAM,SAAS,SAAS;GAC3B,MAAM,SAAU,MAAM,IAAI,aAAa,IAAI;GAC3C,MAAM,OAAO,MAAM,MAAM;GACzB,MAAM,QAAQ,MAAM,SAAS;GAC7B,MAAM,aAAa,QAAQ,MAAM,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC;GAEvD,MAAM,aAAa,QAAQ,MAAM,OAAO,QAAQ,IAAK;GACrD,MAAM,YAAY,SAAS,aAAa,KAAK,WAAW;GAExD,MAAM,WAA8B;IAClC,IAAI,KAAK,mBAAmB,QAAQ,KAAK;IACzC;IACA;IACA,MAAM,KAAK,eAAe,OAAO;IACjC,aAAa;IACb,QAAQ,KAAK,eAAe,MAAM,YAAY,aAAa,GAAG;IAC9D,YAAY,KAAK,iBACf,YAAY,SAAS,UACrB,YAAY,oBAAoB,kBACjC;IACD,eAAe,EAAE,WAAW;IAC7B;AAED,QAAK,YAAY,KAAK,SAAS"}

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

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

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

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

package/dist/extractors/hono/extractor.js

@@ -0,0 +1,57 @@
+import { BaseExtractor } from "../base.js";
+
+//#region src/extractors/hono/extractor.ts
+/**
+* Hono extractor.
+*
+* Extracts contract candidates from Hono applications by parsing:
+* - app.get(), app.post(), etc. route handlers
+* - Zod validator middleware
+*/
+const PATTERNS = {
+	route: /(?:app|hono)\.(get|post|put|patch|delete|all)\s*\(\s*['"`]([^'"`]+)['"`]/gi,
+	zodValidator: /zValidator\s*\(\s*['"`](\w+)['"`]\s*,\s*(\w+)/g
+};
+var HonoExtractor = class extends BaseExtractor {
+	id = "hono";
+	name = "Hono Extractor";
+	frameworks = ["hono"];
+	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);
+			await this.extractRoutes(ctx, file, content);
+		}
+	}
+	async extractRoutes(ctx, file, content) {
+		const matches = [...content.matchAll(PATTERNS.route)];
+		for (const match of matches) {
+			const method = match[1]?.toUpperCase() ?? "GET";
+			const path = match[2] ?? "/";
+			const index = match.index ?? 0;
+			const lineNumber = content.slice(0, index).split("\n").length;
+			const afterMatch = content.slice(index, index + 500);
+			const hasZodValidator = PATTERNS.zodValidator.test(afterMatch);
+			const endpoint = {
+				id: this.generateEndpointId(method, path),
+				method,
+				path,
+				kind: this.methodToOpKind(method),
+				handlerName: "handler",
+				source: this.createLocation(file, lineNumber, lineNumber + 5),
+				confidence: this.createConfidence(hasZodValidator ? "high" : "medium", hasZodValidator ? "explicit-schema" : "decorator-hints")
+			};
+			this.addEndpoint(ctx, endpoint);
+		}
+	}
+};
+
+//#endregion
+export { HonoExtractor };
+//# sourceMappingURL=extractor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.js","names":[],"sources":["../../../src/extractors/hono/extractor.ts"],"sourcesContent":["/**\n * Hono extractor.\n *\n * Extracts contract candidates from Hono applications by parsing:\n * - app.get(), app.post(), etc. route handlers\n * - Zod validator middleware\n */\n\nimport { BaseExtractor, type ExtractionContext } from '../base';\nimport type { EndpointCandidate, HttpMethod } from '../../types';\n\nconst PATTERNS = {\n  route:\n    /(?:app|hono)\\.(get|post|put|patch|delete|all)\\s*\\(\\s*['\"`]([^'\"`]+)['\"`]/gi,\n  zodValidator: /zValidator\\s*\\(\\s*['\"`](\\w+)['\"`]\\s*,\\s*(\\w+)/g,\n};\n\nexport class HonoExtractor extends BaseExtractor {\n  id = 'hono';\n  name = 'Hono Extractor';\n  frameworks = ['hono'];\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      await this.extractRoutes(ctx, file, content);\n    }\n  }\n\n  private async extractRoutes(\n    ctx: ExtractionContext,\n    file: string,\n    content: string\n  ): Promise<void> {\n    const matches = [...content.matchAll(PATTERNS.route)];\n\n    for (const match of matches) {\n      const method = (match[1]?.toUpperCase() ?? 'GET') as HttpMethod;\n      const path = match[2] ?? '/';\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 hasZodValidator = PATTERNS.zodValidator.test(afterMatch);\n\n      const endpoint: EndpointCandidate = {\n        id: this.generateEndpointId(method, path),\n        method,\n        path,\n        kind: this.methodToOpKind(method),\n        handlerName: 'handler',\n        source: this.createLocation(file, lineNumber, lineNumber + 5),\n        confidence: this.createConfidence(\n          hasZodValidator ? 'high' : 'medium',\n          hasZodValidator ? 'explicit-schema' : 'decorator-hints'\n        ),\n      };\n\n      this.addEndpoint(ctx, endpoint);\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;AAWA,MAAM,WAAW;CACf,OACE;CACF,cAAc;CACf;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,SAAM,KAAK,cAAc,KAAK,MAAM,QAAQ;;;CAIhD,MAAc,cACZ,KACA,MACA,SACe;EACf,MAAM,UAAU,CAAC,GAAG,QAAQ,SAAS,SAAS,MAAM,CAAC;AAErD,OAAK,MAAM,SAAS,SAAS;GAC3B,MAAM,SAAU,MAAM,IAAI,aAAa,IAAI;GAC3C,MAAM,OAAO,MAAM,MAAM;GACzB,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,kBAAkB,SAAS,aAAa,KAAK,WAAW;GAE9D,MAAM,WAA8B;IAClC,IAAI,KAAK,mBAAmB,QAAQ,KAAK;IACzC;IACA;IACA,MAAM,KAAK,eAAe,OAAO;IACjC,aAAa;IACb,QAAQ,KAAK,eAAe,MAAM,YAAY,aAAa,EAAE;IAC7D,YAAY,KAAK,iBACf,kBAAkB,SAAS,UAC3B,kBAAkB,oBAAoB,kBACvC;IACF;AAED,QAAK,YAAY,KAAK,SAAS"}

package/dist/extractors/index.d.ts

@@ -0,0 +1,21 @@
+import { BaseExtractor, ExtractionContext, ExtractorFsAdapter } from "./base.js";
+import { NestJsExtractor } from "./nestjs/extractor.js";
+import { ExpressExtractor } from "./express/extractor.js";
+import { FastifyExtractor } from "./fastify/extractor.js";
+import { HonoExtractor } from "./hono/extractor.js";
+import { ElysiaExtractor } from "./elysia/extractor.js";
+import { TrpcExtractor } from "./trpc/extractor.js";
+import { NextApiExtractor } from "./next-api/extractor.js";
+import { ZodSchemaExtractor } from "./zod/extractor.js";
+
+//#region src/extractors/index.d.ts
+declare namespace index_d_exports {
+  export { BaseExtractor, ElysiaExtractor, ExpressExtractor, ExtractionContext, ExtractorFsAdapter, FastifyExtractor, HonoExtractor, NestJsExtractor, NextApiExtractor, TrpcExtractor, ZodSchemaExtractor, registerAllExtractors };
+}
+/**
+ * Register all built-in extractors with the global registry.
+ */
+declare function registerAllExtractors(): void;
+//#endregion
+export { BaseExtractor, ElysiaExtractor, ExpressExtractor, type ExtractionContext, type ExtractorFsAdapter, FastifyExtractor, HonoExtractor, NestJsExtractor, NextApiExtractor, TrpcExtractor, ZodSchemaExtractor, index_d_exports, registerAllExtractors };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/extractors/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;iBAoCgB,qBAAA,CAAA"}

package/dist/extractors/index.js

@@ -0,0 +1,42 @@
+import { __exportAll } from "../_virtual/rolldown_runtime.js";
+import { extractorRegistry } from "../registry.js";
+import { BaseExtractor } from "./base.js";
+import { NestJsExtractor } from "./nestjs/extractor.js";
+import { ExpressExtractor } from "./express/extractor.js";
+import { FastifyExtractor } from "./fastify/extractor.js";
+import { HonoExtractor } from "./hono/extractor.js";
+import { ElysiaExtractor } from "./elysia/extractor.js";
+import { TrpcExtractor } from "./trpc/extractor.js";
+import { NextApiExtractor } from "./next-api/extractor.js";
+import { ZodSchemaExtractor } from "./zod/extractor.js";
+
+//#region src/extractors/index.ts
+var extractors_exports = /* @__PURE__ */ __exportAll({
+	BaseExtractor: () => BaseExtractor,
+	ElysiaExtractor: () => ElysiaExtractor,
+	ExpressExtractor: () => ExpressExtractor,
+	FastifyExtractor: () => FastifyExtractor,
+	HonoExtractor: () => HonoExtractor,
+	NestJsExtractor: () => NestJsExtractor,
+	NextApiExtractor: () => NextApiExtractor,
+	TrpcExtractor: () => TrpcExtractor,
+	ZodSchemaExtractor: () => ZodSchemaExtractor,
+	registerAllExtractors: () => registerAllExtractors
+});
+/**
+* Register all built-in extractors with the global registry.
+*/
+function registerAllExtractors() {
+	extractorRegistry.register(new NestJsExtractor());
+	extractorRegistry.register(new ExpressExtractor());
+	extractorRegistry.register(new FastifyExtractor());
+	extractorRegistry.register(new HonoExtractor());
+	extractorRegistry.register(new ElysiaExtractor());
+	extractorRegistry.register(new TrpcExtractor());
+	extractorRegistry.register(new NextApiExtractor());
+	extractorRegistry.register(new ZodSchemaExtractor());
+}
+
+//#endregion
+export { BaseExtractor, ElysiaExtractor, ExpressExtractor, FastifyExtractor, HonoExtractor, NestJsExtractor, NextApiExtractor, TrpcExtractor, ZodSchemaExtractor, extractors_exports, registerAllExtractors };
+//# sourceMappingURL=index.js.map

package/dist/extractors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/extractors/index.ts"],"sourcesContent":["/**\n * Source extractors module.\n *\n * Exports all available framework extractors.\n */\n\n// Base extractor class\nexport { BaseExtractor } from './base';\nexport type { ExtractorFsAdapter, ExtractionContext } from './base';\n\n// Framework-specific extractors\nexport { NestJsExtractor } from './nestjs/extractor';\nexport { ExpressExtractor } from './express/extractor';\nexport { FastifyExtractor } from './fastify/extractor';\nexport { HonoExtractor } from './hono/extractor';\nexport { ElysiaExtractor } from './elysia/extractor';\nexport { TrpcExtractor } from './trpc/extractor';\nexport { NextApiExtractor } from './next-api/extractor';\n\n// Schema extractors\nexport { ZodSchemaExtractor } from './zod/extractor';\n\n// Registration helper\nimport { extractorRegistry } from '../registry';\nimport { NestJsExtractor } from './nestjs/extractor';\nimport { ExpressExtractor } from './express/extractor';\nimport { FastifyExtractor } from './fastify/extractor';\nimport { HonoExtractor } from './hono/extractor';\nimport { ElysiaExtractor } from './elysia/extractor';\nimport { TrpcExtractor } from './trpc/extractor';\nimport { NextApiExtractor } from './next-api/extractor';\nimport { ZodSchemaExtractor } from './zod/extractor';\n\n/**\n * Register all built-in extractors with the global registry.\n */\nexport function registerAllExtractors(): void {\n  extractorRegistry.register(new NestJsExtractor());\n  extractorRegistry.register(new ExpressExtractor());\n  extractorRegistry.register(new FastifyExtractor());\n  extractorRegistry.register(new HonoExtractor());\n  extractorRegistry.register(new ElysiaExtractor());\n  extractorRegistry.register(new TrpcExtractor());\n  extractorRegistry.register(new NextApiExtractor());\n  extractorRegistry.register(new ZodSchemaExtractor());\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCA,SAAgB,wBAA8B;AAC5C,mBAAkB,SAAS,IAAI,iBAAiB,CAAC;AACjD,mBAAkB,SAAS,IAAI,kBAAkB,CAAC;AAClD,mBAAkB,SAAS,IAAI,kBAAkB,CAAC;AAClD,mBAAkB,SAAS,IAAI,eAAe,CAAC;AAC/C,mBAAkB,SAAS,IAAI,iBAAiB,CAAC;AACjD,mBAAkB,SAAS,IAAI,eAAe,CAAC;AAC/C,mBAAkB,SAAS,IAAI,kBAAkB,CAAC;AAClD,mBAAkB,SAAS,IAAI,oBAAoB,CAAC"}

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

@@ -0,0 +1,29 @@
+import { BaseExtractor, ExtractionContext } from "../base.js";
+
+//#region src/extractors/nestjs/extractor.d.ts
+
+/**
+ * NestJS framework extractor.
+ */
+declare class NestJsExtractor extends BaseExtractor {
+  id: string;
+  name: string;
+  frameworks: string[];
+  priority: number;
+  protected doExtract(ctx: ExtractionContext): Promise<void>;
+  /**
+   * Extract controllers and their routes from a file.
+   */
+  private extractControllers;
+  /**
+   * Extract DTO classes from a file.
+   */
+  private extractDtos;
+  /**
+   * Normalize a path (remove double slashes, ensure leading slash).
+   */
+  private normalizePath;
+}
+//#endregion
+export { NestJsExtractor };
+//# sourceMappingURL=extractor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.d.ts","names":[],"sources":["../../../src/extractors/nestjs/extractor.ts"],"sourcesContent":[],"mappings":";;;;;;;cAmCa,eAAA,SAAwB,aAAA;;;;;2BAMJ,oBAAoB"}

package/dist/extractors/nestjs/extractor.js

@@ -0,0 +1,118 @@
+import { BaseExtractor } from "../base.js";
+
+//#region src/extractors/nestjs/extractor.ts
+/**
+* NestJS extractor.
+*
+* Extracts contract candidates from NestJS applications by parsing:
+* - @Controller() decorated classes
+* - @Get(), @Post(), etc. decorated methods
+* - Class-validator DTOs
+* - HttpException patterns
+*/
+/**
+* Regex patterns for NestJS detection and extraction.
+*/
+const PATTERNS = {
+	controller: /@Controller\s*\(\s*['"`]([^'"`]*)['"`]\s*\)/g,
+	route: /@(Get|Post|Put|Patch|Delete|Head|Options)\s*\(\s*(?:['"`]([^'"`]*)['"`])?\s*\)/g,
+	body: /@Body\s*\(\s*\)/g,
+	param: /@Param\s*\(\s*(?:['"`]([^'"`]*)['"`])?\s*\)/g,
+	query: /@Query\s*\(\s*(?:['"`]([^'"`]*)['"`])?\s*\)/g,
+	dto: /class\s+(\w+(?:Dto|DTO|Request|Response|Input|Output))\s*\{/g,
+	classValidator: /@(IsString|IsNumber|IsBoolean|IsArray|IsOptional|IsNotEmpty|Min|Max|Length|Matches)/g
+};
+/**
+* NestJS framework extractor.
+*/
+var NestJsExtractor = class extends BaseExtractor {
+	id = "nestjs";
+	name = "NestJS Extractor";
+	frameworks = ["nestjs"];
+	priority = 20;
+	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(".spec.") || file.includes(".test.")) continue;
+			const fullPath = `${project.rootPath}/${file}`;
+			const content = await fs.readFile(fullPath);
+			await this.extractControllers(ctx, file, content);
+			await this.extractDtos(ctx, file, content);
+		}
+	}
+	/**
+	* Extract controllers and their routes from a file.
+	*/
+	async extractControllers(ctx, file, content) {
+		const controllerMatches = [...content.matchAll(PATTERNS.controller)];
+		for (const controllerMatch of controllerMatches) {
+			const basePath = controllerMatch[1] || "";
+			const controllerIndex = controllerMatch.index ?? 0;
+			const controllerName = content.slice(controllerIndex).match(/class\s+(\w+)/)?.[1] ?? "UnknownController";
+			const nextController = content.indexOf("@Controller", controllerIndex + 1);
+			const controllerBlock = nextController > 0 ? content.slice(controllerIndex, nextController) : content.slice(controllerIndex);
+			const routeMatches = [...controllerBlock.matchAll(PATTERNS.route)];
+			for (const routeMatch of routeMatches) {
+				const method = routeMatch[1]?.toUpperCase();
+				const routePath = routeMatch[2] || "";
+				const fullPath = this.normalizePath(`/${basePath}/${routePath}`);
+				const afterRoute = controllerBlock.slice(routeMatch.index ?? 0);
+				const handlerName = afterRoute.match(/(?:async\s+)?(\w+)\s*\([^)]*\)\s*(?::\s*\w+(?:<[^>]+>)?)?\s*\{/)?.[1] ?? "unknownHandler";
+				const absoluteIndex = controllerIndex + (routeMatch.index ?? 0);
+				const lineNumber = content.slice(0, absoluteIndex).split("\n").length;
+				const hasBody = PATTERNS.body.test(afterRoute.slice(0, 200));
+				const hasParams = PATTERNS.param.test(afterRoute.slice(0, 200));
+				const hasQuery = PATTERNS.query.test(afterRoute.slice(0, 200));
+				const endpoint = {
+					id: this.generateEndpointId(method, fullPath, handlerName),
+					method,
+					path: fullPath,
+					kind: this.methodToOpKind(method),
+					handlerName,
+					controllerName,
+					source: this.createLocation(file, lineNumber, lineNumber + 10),
+					confidence: this.createConfidence("medium", "decorator-hints"),
+					frameworkMeta: {
+						hasBody,
+						hasParams,
+						hasQuery
+					}
+				};
+				this.addEndpoint(ctx, endpoint);
+			}
+		}
+	}
+	/**
+	* Extract DTO classes from a file.
+	*/
+	async extractDtos(ctx, file, content) {
+		const dtoMatches = [...content.matchAll(PATTERNS.dto)];
+		for (const match of dtoMatches) {
+			const name = match[1] ?? "UnknownDto";
+			const index = match.index ?? 0;
+			const lineNumber = content.slice(0, index).split("\n").length;
+			const hasClassValidator = content.includes("class-validator") || content.includes("@IsString") || content.includes("@IsNumber");
+			const schema = {
+				id: this.generateSchemaId(name, file),
+				name,
+				schemaType: hasClassValidator ? "class-validator" : "typescript",
+				source: this.createLocation(file, lineNumber, lineNumber + 20),
+				confidence: this.createConfidence(hasClassValidator ? "high" : "medium", hasClassValidator ? "explicit-schema" : "inferred-types")
+			};
+			this.addSchema(ctx, schema);
+		}
+	}
+	/**
+	* Normalize a path (remove double slashes, ensure leading slash).
+	*/
+	normalizePath(path) {
+		return "/" + path.replace(/\/+/g, "/").replace(/^\/+|\/+$/g, "");
+	}
+};
+
+//#endregion
+export { NestJsExtractor };
+//# sourceMappingURL=extractor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.js","names":[],"sources":["../../../src/extractors/nestjs/extractor.ts"],"sourcesContent":["/**\n * NestJS extractor.\n *\n * Extracts contract candidates from NestJS applications by parsing:\n * - @Controller() decorated classes\n * - @Get(), @Post(), etc. decorated methods\n * - Class-validator DTOs\n * - HttpException patterns\n */\n\nimport { BaseExtractor, type ExtractionContext } from '../base';\nimport type {\n  EndpointCandidate,\n  HttpMethod,\n  SchemaCandidate,\n} from '../../types';\n\n/**\n * Regex patterns for NestJS detection and extraction.\n */\nconst PATTERNS = {\n  controller: /@Controller\\s*\\(\\s*['\"`]([^'\"`]*)['\"`]\\s*\\)/g,\n  route:\n    /@(Get|Post|Put|Patch|Delete|Head|Options)\\s*\\(\\s*(?:['\"`]([^'\"`]*)['\"`])?\\s*\\)/g,\n  body: /@Body\\s*\\(\\s*\\)/g,\n  param: /@Param\\s*\\(\\s*(?:['\"`]([^'\"`]*)['\"`])?\\s*\\)/g,\n  query: /@Query\\s*\\(\\s*(?:['\"`]([^'\"`]*)['\"`])?\\s*\\)/g,\n  dto: /class\\s+(\\w+(?:Dto|DTO|Request|Response|Input|Output))\\s*\\{/g,\n  classValidator:\n    /@(IsString|IsNumber|IsBoolean|IsArray|IsOptional|IsNotEmpty|Min|Max|Length|Matches)/g,\n};\n\n/**\n * NestJS framework extractor.\n */\nexport class NestJsExtractor extends BaseExtractor {\n  id = 'nestjs';\n  name = 'NestJS Extractor';\n  frameworks = ['nestjs'];\n  priority = 20; // Higher priority for NestJS-specific detection\n\n  protected async doExtract(ctx: ExtractionContext): Promise<void> {\n    const { project, options, fs } = ctx;\n\n    // Find TypeScript files\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      // Skip test files and node_modules\n      if (\n        file.includes('node_modules') ||\n        file.includes('.spec.') ||\n        file.includes('.test.')\n      ) {\n        continue;\n      }\n\n      const fullPath = `${project.rootPath}/${file}`;\n      const content = await fs.readFile(fullPath);\n\n      // Extract controllers and routes\n      await this.extractControllers(ctx, file, content);\n\n      // Extract DTOs\n      await this.extractDtos(ctx, file, content);\n    }\n  }\n\n  /**\n   * Extract controllers and their routes from a file.\n   */\n  private async extractControllers(\n    ctx: ExtractionContext,\n    file: string,\n    content: string\n  ): Promise<void> {\n    // Find controllers\n    const controllerMatches = [...content.matchAll(PATTERNS.controller)];\n\n    for (const controllerMatch of controllerMatches) {\n      const basePath = controllerMatch[1] || '';\n      const controllerIndex = controllerMatch.index ?? 0;\n\n      // Find the class name after the decorator\n      const afterDecorator = content.slice(controllerIndex);\n      const classMatch = afterDecorator.match(/class\\s+(\\w+)/);\n      const controllerName = classMatch?.[1] ?? 'UnknownController';\n\n      // Find route decorators in this controller\n      // We need to find routes between this controller and the next one (or end of file)\n      const nextController = content.indexOf(\n        '@Controller',\n        controllerIndex + 1\n      );\n      const controllerBlock =\n        nextController > 0\n          ? content.slice(controllerIndex, nextController)\n          : content.slice(controllerIndex);\n\n      const routeMatches = [...controllerBlock.matchAll(PATTERNS.route)];\n\n      for (const routeMatch of routeMatches) {\n        const method = routeMatch[1]?.toUpperCase() as HttpMethod;\n        const routePath = routeMatch[2] || '';\n        const fullPath = this.normalizePath(`/${basePath}/${routePath}`);\n\n        // Find the method name after the route decorator\n        const afterRoute = controllerBlock.slice(routeMatch.index ?? 0);\n        const methodMatch = afterRoute.match(\n          /(?:async\\s+)?(\\w+)\\s*\\([^)]*\\)\\s*(?::\\s*\\w+(?:<[^>]+>)?)?\\s*\\{/\n        );\n        const handlerName = methodMatch?.[1] ?? 'unknownHandler';\n\n        // Calculate line numbers\n        const absoluteIndex = controllerIndex + (routeMatch.index ?? 0);\n        const lineNumber = content.slice(0, absoluteIndex).split('\\n').length;\n\n        // Check for body, params, query decorators\n        const hasBody = PATTERNS.body.test(afterRoute.slice(0, 200));\n        const hasParams = PATTERNS.param.test(afterRoute.slice(0, 200));\n        const hasQuery = PATTERNS.query.test(afterRoute.slice(0, 200));\n\n        const endpoint: EndpointCandidate = {\n          id: this.generateEndpointId(method, fullPath, handlerName),\n          method,\n          path: fullPath,\n          kind: this.methodToOpKind(method),\n          handlerName,\n          controllerName,\n          source: this.createLocation(file, lineNumber, lineNumber + 10),\n          confidence: this.createConfidence('medium', 'decorator-hints'),\n          frameworkMeta: {\n            hasBody,\n            hasParams,\n            hasQuery,\n          },\n        };\n\n        this.addEndpoint(ctx, endpoint);\n      }\n    }\n  }\n\n  /**\n   * Extract DTO classes from a file.\n   */\n  private async extractDtos(\n    ctx: ExtractionContext,\n    file: string,\n    content: string\n  ): Promise<void> {\n    const dtoMatches = [...content.matchAll(PATTERNS.dto)];\n\n    for (const match of dtoMatches) {\n      const name = match[1] ?? 'UnknownDto';\n      const index = match.index ?? 0;\n      const lineNumber = content.slice(0, index).split('\\n').length;\n\n      // Check if it uses class-validator (check for import statement)\n      const hasClassValidator =\n        content.includes('class-validator') ||\n        content.includes('@IsString') ||\n        content.includes('@IsNumber');\n\n      const schema: SchemaCandidate = {\n        id: this.generateSchemaId(name, file),\n        name,\n        schemaType: hasClassValidator ? 'class-validator' : 'typescript',\n        source: this.createLocation(file, lineNumber, lineNumber + 20),\n        confidence: this.createConfidence(\n          hasClassValidator ? 'high' : 'medium',\n          hasClassValidator ? 'explicit-schema' : 'inferred-types'\n        ),\n      };\n\n      this.addSchema(ctx, schema);\n    }\n  }\n\n  /**\n   * Normalize a path (remove double slashes, ensure leading slash).\n   */\n  private normalizePath(path: string): string {\n    return '/' + path.replace(/\\/+/g, '/').replace(/^\\/+|\\/+$/g, '');\n  }\n}\n"],"mappings":"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"}

package/dist/extractors/next-api/extractor.d.ts

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

package/dist/extractors/next-api/extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.d.ts","names":[],"sources":["../../../src/extractors/next-api/extractor.ts"],"sourcesContent":[],"mappings":";;;;cAkBa,gBAAA,SAAyB,aAAA;;;;;2BAML,oBAAoB"}