@contractspec/lib.source-extractors 0.11.0 → 0.13.0

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

@@ -1,28 +1,33 @@
-import { BaseExtractor, ExtractionContext } from "../base.js";
-
-//#region src/extractors/nestjs/extractor.d.ts
+/**
+ * NestJS extractor.
+ *
+ * Extracts contract candidates from NestJS applications by parsing:
+ * - @Controller() decorated classes
+ * - @Get(), @Post(), etc. decorated methods
+ * - Class-validator DTOs
+ * - HttpException patterns
+ */
+import { BaseExtractor, type ExtractionContext } from '../base';
 /**
  * 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;
+export 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

@@ -1 +1 @@
-{"version":3,"file":"extractor.d.ts","names":[],"sources":["../../../src/extractors/nestjs/extractor.ts"],"mappings":";;;;;;cAmCa,eAAA,SAAwB,aAAA;EACnC,EAAA;EACA,IAAA;EACA,UAAA;EACA,QAAA;EAAA,UAEgB,SAAA,CAAU,GAAA,EAAK,iBAAA,GAAoB,OAAA;EAAA;;;EAAA,QAmCrC,kBAAA;EA+GO;;;EAAA,QApCP,WAAA;;;;UAoCN,aAAA;AAAA"}
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../../src/extractors/nestjs/extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAsBhE;;GAEG;AACH,qBAAa,eAAgB,SAAQ,aAAa;IAChD,EAAE,SAAY;IACd,IAAI,SAAsB;IAC1B,UAAU,WAAc;IACxB,QAAQ,SAAM;cAEE,SAAS,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgChE;;OAEG;YACW,kBAAkB;IAwEhC;;OAEG;YACW,WAAW;IAiCzB;;OAEG;IACH,OAAO,CAAC,aAAa;CAGtB"}

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

@@ -1,15 +1,18 @@
-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;
+/**
+ * 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)
+ */
+import { BaseExtractor, type ExtractionContext } from '../base';
+export 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

@@ -1 +1 @@
-{"version":3,"file":"extractor.d.ts","names":[],"sources":["../../../src/extractors/next-api/extractor.ts"],"mappings":";;;cAkBa,gBAAA,SAAyB,aAAA;EACpC,EAAA;EACA,IAAA;EACA,UAAA;EACA,QAAA;EAAA,UAEgB,SAAA,CAAU,GAAA,EAAK,iBAAA,GAAoB,OAAA;EAAA,QA2BrC,gBAAA;EAAA,QAoCA,kBAAA;AAAA"}
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../../src/extractors/next-api/extractor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAUhE,qBAAa,gBAAiB,SAAQ,aAAa;IACjD,EAAE,SAAc;IAChB,IAAI,SAA2B;IAC/B,UAAU,WAAgB;IAC1B,QAAQ,SAAM;cAEE,SAAS,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;YA2BlD,gBAAgB;YAoChB,kBAAkB;CA+BjC"}

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

@@ -1,14 +1,18 @@
-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;
+/**
+ * tRPC extractor.
+ *
+ * Extracts contract candidates from tRPC applications by parsing:
+ * - router definitions
+ * - procedure definitions (query, mutation)
+ * - Zod input/output schemas
+ */
+import { BaseExtractor, type ExtractionContext } from '../base';
+export 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

@@ -1 +1 @@
-{"version":3,"file":"extractor.d.ts","names":[],"sources":["../../../src/extractors/trpc/extractor.ts"],"mappings":";;;cAoBa,aAAA,SAAsB,aAAA;EACjC,EAAA;EACA,IAAA;EACA,UAAA;EACA,QAAA;EAAA,UAEgB,SAAA,CAAU,GAAA,EAAK,iBAAA,GAAoB,OAAA;EAAA,QAsBrC,iBAAA;AAAA"}
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../../src/extractors/trpc/extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAWhE,qBAAa,aAAc,SAAQ,aAAa;IAC9C,EAAE,SAAU;IACZ,IAAI,SAAoB;IACxB,UAAU,WAAY;IACtB,QAAQ,SAAM;cAEE,SAAS,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;YAsBlD,iBAAiB;CA6ChC"}

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

@@ -1,15 +1,17 @@
-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;
+/**
+ * Zod schema extractor.
+ *
+ * Extracts standalone Zod schema definitions that aren't tied to a specific framework.
+ * Useful for shared validation schemas.
+ */
+import { BaseExtractor, type ExtractionContext } from '../base';
+export 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

@@ -1 +1 @@
-{"version":3,"file":"extractor.d.ts","names":[],"sources":["../../../src/extractors/zod/extractor.ts"],"mappings":";;;cAgBa,kBAAA,SAA2B,aAAA;EACtC,EAAA;EACA,IAAA;EACA,UAAA;EACA,QAAA;EAEM,MAAA,CAAA,GAAU,OAAA;EAAA,UAKA,SAAA,CAAU,GAAA,EAAK,iBAAA,GAAoB,OAAA;EAAA,QAsBrC,cAAA;AAAA"}
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../../src/extractors/zod/extractor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAShE,qBAAa,kBAAmB,SAAQ,aAAa;IACnD,EAAE,SAAS;IACX,IAAI,SAA0B;IAC9B,UAAU,WAAW;IACrB,QAAQ,SAAK;IAEP,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;cAKhB,SAAS,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;YAsBlD,cAAc;CAwC7B"}

package/dist/index.d.ts

@@ -1,7 +1,30 @@
-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 };
+/**
+ * @contractspec/lib.source-extractors
+ *
+ * Extract contract candidates from TypeScript source code across multiple frameworks.
+ * Produces an Intermediate Representation (IR) that can be converted to ContractSpec definitions.
+ *
+ * Supported frameworks:
+ * - NestJS
+ * - Express
+ * - Fastify
+ * - Hono
+ * - Elysia
+ * - tRPC
+ * - Next.js API Routes
+ *
+ * @example
+ * ```typescript
+ * import { extractFromProject, detectFramework } from '@contractspec/lib.source-extractors';
+ *
+ * const framework = await detectFramework('./my-project');
+ * const ir = await extractFromProject('./my-project', { framework });
+ * ```
+ */
+export * from './types';
+export * from './registry';
+export * from './detect';
+export * from './extract';
+export * as extractors from './extractors/index';
+export * as codegen from './codegen/index';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,cAAc,SAAS,CAAC;AAGxB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AAGzB,cAAc,WAAW,CAAC;AAG1B,OAAO,KAAK,UAAU,MAAM,oBAAoB,CAAC;AAGjD,OAAO,KAAK,OAAO,MAAM,iBAAiB,CAAC"}