@contractspec/lib.source-extractors 2.7.5 → 2.7.7

package/README.md

@@ -1,86 +1,68 @@
 # @contractspec/lib.source-extractors
 
-Extract contract candidates from TypeScript source code across multiple frameworks.
+Website: https://contractspec.io
 
-## Supported Frameworks
+**Extract contract candidates from TypeScript source code across multiple frameworks (NestJS, Express, Fastify, Hono, Elysia, tRPC, Next.js).**
 
-| Framework | Detection | Routes | Schemas | Status |
-|-----------|-----------|--------|---------|--------|
-| NestJS | ✅ | ✅ | ✅ | Ready |
-| Express | ✅ | ✅ | ✅ | Ready |
-| Fastify | ✅ | ✅ | ✅ | Ready |
-| Hono | ✅ | ✅ | ✅ | Ready |
-| Elysia | ✅ | ✅ | ✅ | Ready |
-| tRPC | ✅ | ✅ | ✅ | Ready |
-| Next.js API | ✅ | ✅ | ✅ | Ready |
-| Zod Schemas | ✅ | N/A | ✅ | Ready |
+## What It Provides
+
+- **Layer**: lib.
+- **Consumers**: CLI, bundles.
+- Related ContractSpec packages include `@contractspec/lib.contracts-spec`, `@contractspec/lib.schema`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.
+- Related ContractSpec packages include `@contractspec/lib.contracts-spec`, `@contractspec/lib.schema`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.
 
 ## Installation
 
-```bash
-bun add @contractspec/lib.source-extractors
-```
+`npm install @contractspec/lib.source-extractors`
+
+or
+
+`bun add @contractspec/lib.source-extractors`
 
 ## Usage
 
-```typescript
-import { detectFramework, extractFromProject } from '@contractspec/lib.source-extractors';
-import { registerAllExtractors } from '@contractspec/lib.source-extractors/extractors';
-import { generateOperations } from '@contractspec/lib.source-extractors/codegen';
-
-// Register all built-in extractors
-registerAllExtractors();
-
-// Detect frameworks in a project
-const project = await detectFramework('./my-project', {
-  readFile: (path) => fs.readFile(path, 'utf-8'),
-  glob: (pattern) => glob(pattern),
-});
-
-// Extract contract candidates
-const result = await extractFromProject(project, {
-  scope: ['src/controllers'], // Optional: limit scope
-});
-
-if (result.success && result.ir) {
-  console.log(`Found ${result.ir.endpoints.length} endpoints`);
-  console.log(`Found ${result.ir.schemas.length} schemas`);
-
-  // Generate ContractSpec code
-  const files = generateOperations(result.ir, {
-    outputDir: './generated',
-    defaultAuth: 'user',
-  });
-}
-```
-
-## IR Schema
-
-The Intermediate Representation (IR) provides a framework-agnostic view of extracted contracts:
-
-```typescript
-interface ImportIR {
-  version: '1.0';
-  extractedAt: string;
-  project: ProjectInfo;
-  endpoints: EndpointCandidate[];
-  schemas: SchemaCandidate[];
-  errors: ErrorCandidate[];
-  events: EventCandidate[];
-  ambiguities: Ambiguity[];
-  stats: { ... };
-}
-```
-
-## Confidence Levels
-
-Each extracted item has a confidence score:
-
-- **high**: Explicit schema found (Zod, class-validator, JSON Schema)
-- **medium**: TypeScript types or framework decorators present
-- **low**: Inferred from naming conventions or partial information
-- **ambiguous**: Requires manual review
-
-## License
-
-MIT
+Import the root entrypoint from `@contractspec/lib.source-extractors`, or choose a documented subpath when you only need one part of the package surface.
+
+## Architecture
+
+- `src/__fixtures__` is part of the package's public or composition surface.
+- `src/__snapshots__` is part of the package's public or composition surface.
+- `src/codegen` is part of the package's public or composition surface.
+- `src/codegen.test.ts` is part of the package's public or composition surface.
+- `src/detect.test.ts` is part of the package's public or composition surface.
+- `src/detect.ts` is part of the package's public or composition surface.
+- `src/edge-cases.test.ts` is part of the package's public or composition surface.
+- `src/index.ts` is the root public barrel and package entrypoint.
+- `src/types.ts` is shared public type definitions.
+
+## Public Entry Points
+
+- Export `.` resolves through `./src/index.ts`.
+- Export `./codegen` resolves through `./src/codegen/index.ts`.
+- Export `./extractors` resolves through `./src/extractors/index.ts`.
+- Export `./types` resolves through `./src/types.ts`.
+
+## Local Commands
+
+- `bun run dev` — contractspec-bun-build dev
+- `bun run build` — bun run prebuild && bun run build:bundle && bun run build:types
+- `bun run test` — bun test
+- `bun run lint` — bun lint:fix
+- `bun run lint:check` — biome check .
+- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
+- `bun run typecheck` — tsc --noEmit
+- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
+- `bun run publish:pkg:canary` — bun publish:pkg --tag canary
+- `bun run clean` — rimraf dist .turbo
+- `bun run build:bundle` — contractspec-bun-build transpile
+- `bun run build:types` — contractspec-bun-build types
+- `bun run prebuild` — contractspec-bun-build prebuild
+
+## Recent Updates
+
+- Replace eslint+prettier by biomejs to optimize speed.
+
+## Notes
+
+- Extractor interface must support multiple frameworks — keep it generic.
+- Codegen output must stay deterministic (same input → same output, always).

package/dist/browser/codegen/index.js

@@ -104,6 +104,42 @@ function generateOperationCode(endpoint, specName, options) {
   return lines.join(`
 `);
 }
+// src/codegen/registry-gen.ts
+function generateRegistry(operationFiles) {
+  const operationImports = operationFiles.filter((f) => f.type === "operation").map((f) => {
+    const name = f.path.replace(".ts", "").replace(/-/g, "_");
+    const specName = toPascalCase(name) + "Spec";
+    return { path: f.path, name, specName };
+  });
+  const lines = [
+    `/**`,
+    ` * Generated operation registry.`,
+    ` */`,
+    ``,
+    `import { OperationSpecRegistry } from '@contractspec/lib.contracts-spec';`,
+    ``
+  ];
+  for (const op of operationImports) {
+    const importPath = `./${op.path.replace(".ts", "")}`;
+    lines.push(`import { ${op.specName} } from '${importPath}';`);
+  }
+  lines.push(``);
+  lines.push(`export const operationRegistry = new OperationSpecRegistry();`);
+  lines.push(``);
+  for (const op of operationImports) {
+    lines.push(`operationRegistry.register(${op.specName});`);
+  }
+  lines.push(``);
+  return {
+    path: "registry.ts",
+    content: lines.join(`
+`),
+    type: "registry"
+  };
+}
+function toPascalCase(str) {
+  return str.split(/[-_]/).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join("");
+}
 // src/codegen/schema-gen.ts
 function generateSchema(schema, _options) {
   const fileName = `${toFileName2(schema.name)}.ts`;
@@ -184,42 +220,6 @@ function mapToZodType(tsType, optional) {
   }
   return optional ? `${zodType}.optional()` : zodType;
 }
-// src/codegen/registry-gen.ts
-function generateRegistry(operationFiles) {
-  const operationImports = operationFiles.filter((f) => f.type === "operation").map((f) => {
-    const name = f.path.replace(".ts", "").replace(/-/g, "_");
-    const specName = toPascalCase(name) + "Spec";
-    return { path: f.path, name, specName };
-  });
-  const lines = [
-    `/**`,
-    ` * Generated operation registry.`,
-    ` */`,
-    ``,
-    `import { OperationSpecRegistry } from '@contractspec/lib.contracts-spec';`,
-    ``
-  ];
-  for (const op of operationImports) {
-    const importPath = `./${op.path.replace(".ts", "")}`;
-    lines.push(`import { ${op.specName} } from '${importPath}';`);
-  }
-  lines.push(``);
-  lines.push(`export const operationRegistry = new OperationSpecRegistry();`);
-  lines.push(``);
-  for (const op of operationImports) {
-    lines.push(`operationRegistry.register(${op.specName});`);
-  }
-  lines.push(``);
-  return {
-    path: "registry.ts",
-    content: lines.join(`
-`),
-    type: "registry"
-  };
-}
-function toPascalCase(str) {
-  return str.split(/[-_]/).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join("");
-}
 export {
   generateSchemas,
   generateSchema,

package/dist/browser/extractors/index.js

@@ -317,101 +317,54 @@ class BaseExtractor {
     ctx.ir.schemas.push(schema);
   }
 }
-// src/extractors/nestjs/extractor.ts
+// src/extractors/elysia/extractor.ts
 var 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
+  route: /\.(get|post|put|patch|delete)\s*\(\s*['"`]([^'"`]+)['"`]/gi,
+  tSchema: /body:\s*t\.\w+/g
 };
 
-class NestJsExtractor extends BaseExtractor {
-  id = "nestjs";
-  name = "NestJS Extractor";
-  frameworks = ["nestjs"];
-  priority = 20;
+class ElysiaExtractor 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(".spec.") || file.includes(".test.")) {
+      if (file.includes("node_modules") || 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);
-    }
-  }
-  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 afterDecorator = content.slice(controllerIndex);
-      const classMatch = afterDecorator.match(/class\s+(\w+)/);
-      const controllerName = classMatch?.[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 methodMatch = afterRoute.match(/(?:async\s+)?(\w+)\s*\([^)]*\)\s*(?::\s*\w+(?:<[^>]+>)?)?\s*\{/);
-        const handlerName = methodMatch?.[1] ?? "unknownHandler";
-        const absoluteIndex = controllerIndex + (routeMatch.index ?? 0);
-        const lineNumber = content.slice(0, absoluteIndex).split(`
-`).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);
-      }
+      if (!content.includes("elysia"))
+        continue;
+      await this.extractRoutes(ctx, file, content);
     }
   }
-  async extractDtos(ctx, file, content) {
-    const dtoMatches = [...content.matchAll(PATTERNS.dto)];
-    for (const match of dtoMatches) {
-      const name = match[1] ?? "UnknownDto";
+  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(`
 `).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")
+      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.addSchema(ctx, schema);
+      this.addEndpoint(ctx, endpoint);
     }
   }
-  normalizePath(path) {
-    return "/" + path.replace(/\/+/g, "/").replace(/^\/+|\/+$/g, "");
-  }
 }
 // src/extractors/express/extractor.ts
 var PATTERNS2 = {
@@ -560,119 +513,104 @@ class HonoExtractor extends BaseExtractor {
     }
   }
 }
-// src/extractors/elysia/extractor.ts
+// src/extractors/nestjs/extractor.ts
 var PATTERNS5 = {
-  route: /\.(get|post|put|patch|delete)\s*\(\s*['"`]([^'"`]+)['"`]/gi,
-  tSchema: /body:\s*t\.\w+/g
+  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
 };
 
-class ElysiaExtractor extends BaseExtractor {
-  id = "elysia";
-  name = "Elysia Extractor";
-  frameworks = ["elysia"];
-  priority = 15;
+class NestJsExtractor 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(".test."))
+      if (file.includes("node_modules") || file.includes(".spec.") || 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);
+      await this.extractControllers(ctx, file, content);
+      await this.extractDtos(ctx, file, content);
     }
   }
-  async extractRoutes(ctx, file, content) {
-    const matches = [...content.matchAll(PATTERNS5.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(`
+  async extractControllers(ctx, file, content) {
+    const controllerMatches = [...content.matchAll(PATTERNS5.controller)];
+    for (const controllerMatch of controllerMatches) {
+      const basePath = controllerMatch[1] || "";
+      const controllerIndex = controllerMatch.index ?? 0;
+      const afterDecorator = content.slice(controllerIndex);
+      const classMatch = afterDecorator.match(/class\s+(\w+)/);
+      const controllerName = classMatch?.[1] ?? "UnknownController";
+      const nextController = content.indexOf("@Controller", controllerIndex + 1);
+      const controllerBlock = nextController > 0 ? content.slice(controllerIndex, nextController) : content.slice(controllerIndex);
+      const routeMatches = [...controllerBlock.matchAll(PATTERNS5.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 methodMatch = afterRoute.match(/(?:async\s+)?(\w+)\s*\([^)]*\)\s*(?::\s*\w+(?:<[^>]+>)?)?\s*\{/);
+        const handlerName = methodMatch?.[1] ?? "unknownHandler";
+        const absoluteIndex = controllerIndex + (routeMatch.index ?? 0);
+        const lineNumber = content.slice(0, absoluteIndex).split(`
 `).length;
-      const afterMatch = content.slice(index, index + 500);
-      const hasTSchema = PATTERNS5.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);
-    }
-  }
-}
-// src/extractors/trpc/extractor.ts
-var PATTERNS6 = {
-  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
-};
-
-class TrpcExtractor 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);
+        const hasBody = PATTERNS5.body.test(afterRoute.slice(0, 200));
+        const hasParams = PATTERNS5.param.test(afterRoute.slice(0, 200));
+        const hasQuery = PATTERNS5.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);
+      }
     }
   }
-  async extractProcedures(ctx, file, content) {
-    const nameMatches = [...content.matchAll(PATTERNS6.procedureName)];
-    for (const match of nameMatches) {
-      const procedureName = match[1] ?? "unknownProcedure";
+  async extractDtos(ctx, file, content) {
+    const dtoMatches = [...content.matchAll(PATTERNS5.dto)];
+    for (const match of dtoMatches) {
+      const name = match[1] ?? "UnknownDto";
       const index = match.index ?? 0;
       const lineNumber = content.slice(0, index).split(`
 `).length;
-      const afterMatch = content.slice(index, index + 500);
-      const isQuery = afterMatch.includes(".query(");
-      const isMutation = afterMatch.includes(".mutation(");
-      if (!isQuery && !isMutation)
-        continue;
-      const hasZodInput = PATTERNS6.zodInput.test(afterMatch);
-      const hasZodOutput = PATTERNS6.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
-        }
+      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.addEndpoint(ctx, endpoint);
+      this.addSchema(ctx, schema);
     }
   }
+  normalizePath(path) {
+    return "/" + path.replace(/\/+/g, "/").replace(/^\/+|\/+$/g, "");
+  }
 }
 // src/extractors/next-api/extractor.ts
-var PATTERNS7 = {
+var PATTERNS6 = {
   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
@@ -706,13 +644,13 @@ class NextApiExtractor extends BaseExtractor {
   async extractAppRoutes(ctx, file, content) {
     const pathMatch = file.match(/app\/api\/(.+)\/route\.ts$/);
     const routePath = pathMatch ? `/api/${pathMatch[1]}` : "/api";
-    const matches = [...content.matchAll(PATTERNS7.appRouterExport)];
+    const matches = [...content.matchAll(PATTERNS6.appRouterExport)];
     for (const match of matches) {
       const method = match[1]?.toUpperCase() ?? "GET";
       const index = match.index ?? 0;
       const lineNumber = content.slice(0, index).split(`
 `).length;
-      const hasZod = PATTERNS7.zodSchema.test(content);
+      const hasZod = PATTERNS6.zodSchema.test(content);
       const endpoint = {
         id: this.generateEndpointId(method, routePath),
         method,
@@ -729,10 +667,10 @@ class NextApiExtractor extends BaseExtractor {
   async extractPagesRoutes(ctx, file, content) {
     const pathMatch = file.match(/pages\/api\/(.+)\.ts$/);
     const routePath = pathMatch ? `/api/${pathMatch[1]}` : "/api";
-    if (!PATTERNS7.pagesHandler.test(content))
+    if (!PATTERNS6.pagesHandler.test(content))
       return;
     const lineNumber = 1;
-    const _hasZod = PATTERNS7.zodSchema.test(content);
+    const _hasZod = PATTERNS6.zodSchema.test(content);
     const methods = ["GET", "POST"];
     for (const method of methods) {
       const endpoint = {
@@ -749,6 +687,68 @@ class NextApiExtractor extends BaseExtractor {
     }
   }
 }
+// src/extractors/trpc/extractor.ts
+var PATTERNS7 = {
+  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
+};
+
+class TrpcExtractor 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(PATTERNS7.procedureName)];
+    for (const match of nameMatches) {
+      const procedureName = match[1] ?? "unknownProcedure";
+      const index = match.index ?? 0;
+      const lineNumber = content.slice(0, index).split(`
+`).length;
+      const afterMatch = content.slice(index, index + 500);
+      const isQuery = afterMatch.includes(".query(");
+      const isMutation = afterMatch.includes(".mutation(");
+      if (!isQuery && !isMutation)
+        continue;
+      const hasZodInput = PATTERNS7.zodInput.test(afterMatch);
+      const hasZodOutput = PATTERNS7.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);
+    }
+  }
+}
 // src/extractors/zod/extractor.ts
 var PATTERNS8 = {
   zodSchema: /(?:export\s+)?const\s+(\w+)\s*=\s*z\.(?:object|string|number|boolean|array|enum|union|intersection|literal|tuple|record)/g,