@contractspec/lib.source-extractors 0.0.0-canary-20260119222405

package/README.md

@@ -0,0 +1,86 @@
+# @contractspec/lib.source-extractors
+
+Extract contract candidates from TypeScript source code across multiple frameworks.
+
+## Supported Frameworks
+
+| 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 |
+
+## Installation
+
+```bash
+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

package/dist/_virtual/rolldown_runtime.js

@@ -0,0 +1,18 @@
+//#region rolldown:runtime
+var __defProp = Object.defineProperty;
+var __exportAll = (all, symbols) => {
+	let target = {};
+	for (var name in all) {
+		__defProp(target, name, {
+			get: all[name],
+			enumerable: true
+		});
+	}
+	if (symbols) {
+		__defProp(target, Symbol.toStringTag, { value: "Module" });
+	}
+	return target;
+};
+
+//#endregion
+export { __exportAll };

package/dist/codegen/index.d.ts

@@ -0,0 +1,12 @@
+import { GeneratedFile, GenerationOptions, GenerationResult } from "./types.js";
+import { generateOperation, generateOperations } from "./operation-gen.js";
+import { generateSchema, generateSchemas } from "./schema-gen.js";
+import { generateRegistry } from "./registry-gen.js";
+
+//#region src/codegen/index.d.ts
+declare namespace index_d_exports {
+  export { GeneratedFile, GenerationOptions, GenerationResult, generateOperation, generateOperations, generateRegistry, generateSchema, generateSchemas };
+}
+//#endregion
+export { type GeneratedFile, type GenerationOptions, type GenerationResult, generateOperation, generateOperations, generateRegistry, generateSchema, generateSchemas, index_d_exports };
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/codegen/index.js

@@ -0,0 +1,17 @@
+import { __exportAll } from "../_virtual/rolldown_runtime.js";
+import { generateOperation, generateOperations } from "./operation-gen.js";
+import { generateSchema, generateSchemas } from "./schema-gen.js";
+import { generateRegistry } from "./registry-gen.js";
+
+//#region src/codegen/index.ts
+var codegen_exports = /* @__PURE__ */ __exportAll({
+	generateOperation: () => generateOperation,
+	generateOperations: () => generateOperations,
+	generateRegistry: () => generateRegistry,
+	generateSchema: () => generateSchema,
+	generateSchemas: () => generateSchemas
+});
+
+//#endregion
+export { codegen_exports, generateOperation, generateOperations, generateRegistry, generateSchema, generateSchemas };
+//# sourceMappingURL=index.js.map

package/dist/codegen/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/codegen/index.ts"],"sourcesContent":["/**\n * Code generation module.\n *\n * Generates ContractSpec definitions from the Intermediate Representation.\n */\n\n// Operation generators\nexport { generateOperation, generateOperations } from './operation-gen';\n\n// Schema generators\nexport { generateSchema, generateSchemas } from './schema-gen';\n\n// Registry generators\nexport { generateRegistry } from './registry-gen';\n\n// Types\nexport type {\n  GeneratedFile,\n  GenerationOptions,\n  GenerationResult,\n} from './types';\n"],"mappings":""}

package/dist/codegen/operation-gen.d.ts

@@ -0,0 +1,16 @@
+import { EndpointCandidate, ImportIR } from "../types.js";
+import { GeneratedFile, GenerationOptions } from "./types.js";
+
+//#region src/codegen/operation-gen.d.ts
+
+/**
+ * Generate a single operation spec file.
+ */
+declare function generateOperation(endpoint: EndpointCandidate, options: GenerationOptions): GeneratedFile;
+/**
+ * Generate all operation spec files from IR.
+ */
+declare function generateOperations(ir: ImportIR, options: GenerationOptions): GeneratedFile[];
+//#endregion
+export { generateOperation, generateOperations };
+//# sourceMappingURL=operation-gen.d.ts.map

package/dist/codegen/operation-gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-gen.d.ts","names":[],"sources":["../../src/codegen/operation-gen.ts"],"sourcesContent":[],"mappings":";;;;;;;AA+BA;AACM,iBApBU,iBAAA,CAoBV,QAAA,EAnBM,iBAmBN,EAAA,OAAA,EAlBK,iBAkBL,CAAA,EAjBH,aAiBG;;;;iBADU,kBAAA,KACV,mBACK,oBACR"}

package/dist/codegen/operation-gen.js

@@ -0,0 +1,91 @@
+//#region src/codegen/operation-gen.ts
+/**
+* Generate a single operation spec file.
+*/
+function generateOperation(endpoint, options) {
+	const specName = toSpecName(endpoint);
+	return {
+		path: `${toFileName(endpoint)}.ts`,
+		content: generateOperationCode(endpoint, specName, options),
+		type: "operation"
+	};
+}
+/**
+* Generate all operation spec files from IR.
+*/
+function generateOperations(ir, options) {
+	return ir.endpoints.map((endpoint) => generateOperation(endpoint, options));
+}
+/**
+* Convert endpoint to spec name (PascalCase).
+*/
+function toSpecName(endpoint) {
+	const parts = endpoint.path.replace(/^\//, "").split("/").filter((p) => p && !p.startsWith(":") && !p.startsWith("{"));
+	return `${endpoint.method.toLowerCase()}${parts.map((p) => p.charAt(0).toUpperCase() + p.slice(1)).join("")}Spec`;
+}
+/**
+* Convert endpoint to file name (kebab-case).
+*/
+function toFileName(endpoint) {
+	const parts = endpoint.path.replace(/^\//, "").split("/").filter((p) => p && !p.startsWith(":") && !p.startsWith("{"));
+	return `${endpoint.method.toLowerCase()}-${parts.join("-")}`.replace(/--+/g, "-");
+}
+/**
+* Generate the operation spec code.
+*/
+function generateOperationCode(endpoint, specName, options) {
+	const defineFunc = endpoint.kind === "command" ? "defineCommand" : "defineQuery";
+	const auth = options.defaultAuth ?? "user";
+	const owners = options.defaultOwners ?? ["team"];
+	return [
+		`/**`,
+		` * ${endpoint.method} ${endpoint.path}`,
+		` *`,
+		` * Generated from: ${endpoint.source.file}:${endpoint.source.startLine}`,
+		` * Confidence: ${endpoint.confidence.level}`,
+		` */`,
+		``,
+		`import { ${defineFunc} } from '@contractspec/lib.contracts';`,
+		`import { fromZod } from '@contractspec/lib.schema';`,
+		`import { z } from 'zod';`,
+		``,
+		`// TODO: Define input schema based on extracted information`,
+		`const inputSchema = fromZod(z.object({`,
+		`  // Add fields here`,
+		`}));`,
+		``,
+		`// TODO: Define output schema`,
+		`const outputSchema = fromZod(z.object({`,
+		`  // Add fields here`,
+		`}));`,
+		``,
+		`export const ${specName} = ${defineFunc}({`,
+		`  meta: {`,
+		`    name: '${endpoint.handlerName ?? endpoint.id}',`,
+		`    version: 1,`,
+		`    stability: 'experimental',`,
+		`    owners: ${JSON.stringify(owners)},`,
+		`    goal: 'TODO: Describe the business goal',`,
+		`    context: 'Generated from ${endpoint.source.file}',`,
+		`  },`,
+		`  io: {`,
+		`    input: inputSchema,`,
+		`    output: outputSchema,`,
+		`  },`,
+		`  policy: {`,
+		`    auth: '${auth}',`,
+		`  },`,
+		`  transport: {`,
+		`    rest: {`,
+		`      method: '${endpoint.method}',`,
+		`      path: '${endpoint.path}',`,
+		`    },`,
+		`  },`,
+		`});`,
+		``
+	].join("\n");
+}
+
+//#endregion
+export { generateOperation, generateOperations };
+//# sourceMappingURL=operation-gen.js.map

package/dist/codegen/operation-gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-gen.js","names":[],"sources":["../../src/codegen/operation-gen.ts"],"sourcesContent":["/**\n * Operation code generator.\n *\n * Generates defineCommand/defineQuery specs from endpoint candidates.\n */\n\nimport type { EndpointCandidate, ImportIR } from '../types';\nimport type { GeneratedFile, GenerationOptions } from './types';\n\n/**\n * Generate a single operation spec file.\n */\nexport function generateOperation(\n  endpoint: EndpointCandidate,\n  options: GenerationOptions\n): GeneratedFile {\n  const specName = toSpecName(endpoint);\n  const fileName = `${toFileName(endpoint)}.ts`;\n\n  const code = generateOperationCode(endpoint, specName, options);\n\n  return {\n    path: fileName,\n    content: code,\n    type: 'operation',\n  };\n}\n\n/**\n * Generate all operation spec files from IR.\n */\nexport function generateOperations(\n  ir: ImportIR,\n  options: GenerationOptions\n): GeneratedFile[] {\n  return ir.endpoints.map((endpoint) => generateOperation(endpoint, options));\n}\n\n/**\n * Convert endpoint to spec name (PascalCase).\n */\nfunction toSpecName(endpoint: EndpointCandidate): string {\n  const parts = endpoint.path\n    .replace(/^\\//, '')\n    .split('/')\n    .filter((p) => p && !p.startsWith(':') && !p.startsWith('{'));\n\n  const methodPart = endpoint.method.toLowerCase();\n  const pathPart = parts\n    .map((p) => p.charAt(0).toUpperCase() + p.slice(1))\n    .join('');\n\n  return `${methodPart}${pathPart}Spec`;\n}\n\n/**\n * Convert endpoint to file name (kebab-case).\n */\nfunction toFileName(endpoint: EndpointCandidate): string {\n  const parts = endpoint.path\n    .replace(/^\\//, '')\n    .split('/')\n    .filter((p) => p && !p.startsWith(':') && !p.startsWith('{'));\n\n  const methodPart = endpoint.method.toLowerCase();\n  const pathPart = parts.join('-');\n\n  return `${methodPart}-${pathPart}`.replace(/--+/g, '-');\n}\n\n/**\n * Generate the operation spec code.\n */\nfunction generateOperationCode(\n  endpoint: EndpointCandidate,\n  specName: string,\n  options: GenerationOptions\n): string {\n  const isCommand = endpoint.kind === 'command';\n  const defineFunc = isCommand ? 'defineCommand' : 'defineQuery';\n  const auth = options.defaultAuth ?? 'user';\n  const owners = options.defaultOwners ?? ['team'];\n\n  const lines = [\n    `/**`,\n    ` * ${endpoint.method} ${endpoint.path}`,\n    ` *`,\n    ` * Generated from: ${endpoint.source.file}:${endpoint.source.startLine}`,\n    ` * Confidence: ${endpoint.confidence.level}`,\n    ` */`,\n    ``,\n    `import { ${defineFunc} } from '@contractspec/lib.contracts';`,\n    `import { fromZod } from '@contractspec/lib.schema';`,\n    `import { z } from 'zod';`,\n    ``,\n    `// TODO: Define input schema based on extracted information`,\n    `const inputSchema = fromZod(z.object({`,\n    `  // Add fields here`,\n    `}));`,\n    ``,\n    `// TODO: Define output schema`,\n    `const outputSchema = fromZod(z.object({`,\n    `  // Add fields here`,\n    `}));`,\n    ``,\n    `export const ${specName} = ${defineFunc}({`,\n    `  meta: {`,\n    `    name: '${endpoint.handlerName ?? endpoint.id}',`,\n    `    version: 1,`,\n    `    stability: 'experimental',`,\n    `    owners: ${JSON.stringify(owners)},`,\n    `    goal: 'TODO: Describe the business goal',`,\n    `    context: 'Generated from ${endpoint.source.file}',`,\n    `  },`,\n    `  io: {`,\n    `    input: inputSchema,`,\n    `    output: outputSchema,`,\n    `  },`,\n    `  policy: {`,\n    `    auth: '${auth}',`,\n    `  },`,\n    `  transport: {`,\n    `    rest: {`,\n    `      method: '${endpoint.method}',`,\n    `      path: '${endpoint.path}',`,\n    `    },`,\n    `  },`,\n    `});`,\n    ``,\n  ];\n\n  return lines.join('\\n');\n}\n"],"mappings":";;;;AAYA,SAAgB,kBACd,UACA,SACe;CACf,MAAM,WAAW,WAAW,SAAS;AAKrC,QAAO;EACL,MALe,GAAG,WAAW,SAAS,CAAC;EAMvC,SAJW,sBAAsB,UAAU,UAAU,QAAQ;EAK7D,MAAM;EACP;;;;;AAMH,SAAgB,mBACd,IACA,SACiB;AACjB,QAAO,GAAG,UAAU,KAAK,aAAa,kBAAkB,UAAU,QAAQ,CAAC;;;;;AAM7E,SAAS,WAAW,UAAqC;CACvD,MAAM,QAAQ,SAAS,KACpB,QAAQ,OAAO,GAAG,CAClB,MAAM,IAAI,CACV,QAAQ,MAAM,KAAK,CAAC,EAAE,WAAW,IAAI,IAAI,CAAC,EAAE,WAAW,IAAI,CAAC;AAO/D,QAAO,GALY,SAAS,OAAO,aAAa,GAC/B,MACd,KAAK,MAAM,EAAE,OAAO,EAAE,CAAC,aAAa,GAAG,EAAE,MAAM,EAAE,CAAC,CAClD,KAAK,GAAG,CAEqB;;;;;AAMlC,SAAS,WAAW,UAAqC;CACvD,MAAM,QAAQ,SAAS,KACpB,QAAQ,OAAO,GAAG,CAClB,MAAM,IAAI,CACV,QAAQ,MAAM,KAAK,CAAC,EAAE,WAAW,IAAI,IAAI,CAAC,EAAE,WAAW,IAAI,CAAC;AAK/D,QAAO,GAHY,SAAS,OAAO,aAAa,CAG3B,GAFJ,MAAM,KAAK,IAAI,GAEG,QAAQ,QAAQ,IAAI;;;;;AAMzD,SAAS,sBACP,UACA,UACA,SACQ;CAER,MAAM,aADY,SAAS,SAAS,YACL,kBAAkB;CACjD,MAAM,OAAO,QAAQ,eAAe;CACpC,MAAM,SAAS,QAAQ,iBAAiB,CAAC,OAAO;AAkDhD,QAhDc;EACZ;EACA,MAAM,SAAS,OAAO,GAAG,SAAS;EAClC;EACA,sBAAsB,SAAS,OAAO,KAAK,GAAG,SAAS,OAAO;EAC9D,kBAAkB,SAAS,WAAW;EACtC;EACA;EACA,YAAY,WAAW;EACvB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,gBAAgB,SAAS,KAAK,WAAW;EACzC;EACA,cAAc,SAAS,eAAe,SAAS,GAAG;EAClD;EACA;EACA,eAAe,KAAK,UAAU,OAAO,CAAC;EACtC;EACA,gCAAgC,SAAS,OAAO,KAAK;EACrD;EACA;EACA;EACA;EACA;EACA;EACA,cAAc,KAAK;EACnB;EACA;EACA;EACA,kBAAkB,SAAS,OAAO;EAClC,gBAAgB,SAAS,KAAK;EAC9B;EACA;EACA;EACA;EACD,CAEY,KAAK,KAAK"}

package/dist/codegen/registry-gen.d.ts

@@ -0,0 +1,11 @@
+import { GeneratedFile } from "./types.js";
+
+//#region src/codegen/registry-gen.d.ts
+
+/**
+ * Generate a registry file for the generated operations.
+ */
+declare function generateRegistry(operationFiles: GeneratedFile[]): GeneratedFile;
+//#endregion
+export { generateRegistry };
+//# sourceMappingURL=registry-gen.d.ts.map

package/dist/codegen/registry-gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-gen.d.ts","names":[],"sources":["../../src/codegen/registry-gen.ts"],"sourcesContent":[],"mappings":";;;;;;;iBAWgB,gBAAA,iBACE,kBACf"}

package/dist/codegen/registry-gen.js

@@ -0,0 +1,47 @@
+//#region src/codegen/registry-gen.ts
+/**
+* Generate a registry file for the generated operations.
+*/
+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';`,
+		``
+	];
+	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("\n"),
+		type: "registry"
+	};
+}
+/**
+* Convert kebab-case to PascalCase.
+*/
+function toPascalCase(str) {
+	return str.split(/[-_]/).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join("");
+}
+
+//#endregion
+export { generateRegistry };
+//# sourceMappingURL=registry-gen.js.map

package/dist/codegen/registry-gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-gen.js","names":[],"sources":["../../src/codegen/registry-gen.ts"],"sourcesContent":["/**\n * Registry code generator.\n *\n * Generates OperationSpecRegistry from generated operations.\n */\n\nimport type { GeneratedFile } from './types';\n\n/**\n * Generate a registry file for the generated operations.\n */\nexport function generateRegistry(\n  operationFiles: GeneratedFile[]\n): GeneratedFile {\n  const operationImports = operationFiles\n    .filter((f) => f.type === 'operation')\n    .map((f) => {\n      const name = f.path.replace('.ts', '').replace(/-/g, '_');\n      const specName = toPascalCase(name) + 'Spec';\n      return { path: f.path, name, specName };\n    });\n\n  const lines = [\n    `/**`,\n    ` * Generated operation registry.`,\n    ` */`,\n    ``,\n    `import { OperationSpecRegistry } from '@contractspec/lib.contracts';`,\n    ``,\n  ];\n\n  // Add imports\n  for (const op of operationImports) {\n    const importPath = `./${op.path.replace('.ts', '')}`;\n    lines.push(`import { ${op.specName} } from '${importPath}';`);\n  }\n\n  lines.push(``);\n  lines.push(`export const operationRegistry = new OperationSpecRegistry();`);\n  lines.push(``);\n\n  // Register operations\n  for (const op of operationImports) {\n    lines.push(`operationRegistry.register(${op.specName});`);\n  }\n\n  lines.push(``);\n\n  return {\n    path: 'registry.ts',\n    content: lines.join('\\n'),\n    type: 'registry',\n  };\n}\n\n/**\n * Convert kebab-case to PascalCase.\n */\nfunction toPascalCase(str: string): string {\n  return str\n    .split(/[-_]/)\n    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))\n    .join('');\n}\n"],"mappings":";;;;AAWA,SAAgB,iBACd,gBACe;CACf,MAAM,mBAAmB,eACtB,QAAQ,MAAM,EAAE,SAAS,YAAY,CACrC,KAAK,MAAM;EACV,MAAM,OAAO,EAAE,KAAK,QAAQ,OAAO,GAAG,CAAC,QAAQ,MAAM,IAAI;EACzD,MAAM,WAAW,aAAa,KAAK,GAAG;AACtC,SAAO;GAAE,MAAM,EAAE;GAAM;GAAM;GAAU;GACvC;CAEJ,MAAM,QAAQ;EACZ;EACA;EACA;EACA;EACA;EACA;EACD;AAGD,MAAK,MAAM,MAAM,kBAAkB;EACjC,MAAM,aAAa,KAAK,GAAG,KAAK,QAAQ,OAAO,GAAG;AAClD,QAAM,KAAK,YAAY,GAAG,SAAS,WAAW,WAAW,IAAI;;AAG/D,OAAM,KAAK,GAAG;AACd,OAAM,KAAK,gEAAgE;AAC3E,OAAM,KAAK,GAAG;AAGd,MAAK,MAAM,MAAM,iBACf,OAAM,KAAK,8BAA8B,GAAG,SAAS,IAAI;AAG3D,OAAM,KAAK,GAAG;AAEd,QAAO;EACL,MAAM;EACN,SAAS,MAAM,KAAK,KAAK;EACzB,MAAM;EACP;;;;;AAMH,SAAS,aAAa,KAAqB;AACzC,QAAO,IACJ,MAAM,OAAO,CACb,KAAK,SAAS,KAAK,OAAO,EAAE,CAAC,aAAa,GAAG,KAAK,MAAM,EAAE,CAAC,CAC3D,KAAK,GAAG"}

package/dist/codegen/schema-gen.d.ts

@@ -0,0 +1,16 @@
+import { ImportIR, SchemaCandidate } from "../types.js";
+import { GeneratedFile, GenerationOptions } from "./types.js";
+
+//#region src/codegen/schema-gen.d.ts
+
+/**
+ * Generate a single schema file.
+ */
+declare function generateSchema(schema: SchemaCandidate, _options: GenerationOptions): GeneratedFile;
+/**
+ * Generate all schema files from IR.
+ */
+declare function generateSchemas(ir: ImportIR, options: GenerationOptions): GeneratedFile[];
+//#endregion
+export { generateSchema, generateSchemas };
+//# sourceMappingURL=schema-gen.d.ts.map

package/dist/codegen/schema-gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-gen.d.ts","names":[],"sources":["../../src/codegen/schema-gen.ts"],"sourcesContent":[],"mappings":";;;;;;;AA6BA;AACM,iBAlBU,cAAA,CAkBV,MAAA,EAjBI,eAiBJ,EAAA,QAAA,EAhBM,iBAgBN,CAAA,EAfH,aAeG;;;;iBADU,eAAA,KACV,mBACK,oBACR"}

package/dist/codegen/schema-gen.js

@@ -0,0 +1,93 @@
+//#region src/codegen/schema-gen.ts
+/**
+* Generate a single schema file.
+*/
+function generateSchema(schema, _options) {
+	const fileName = `${toFileName(schema.name)}.ts`;
+	const code = generateSchemaCode(schema);
+	return {
+		path: `schemas/${fileName}`,
+		content: code,
+		type: "schema"
+	};
+}
+/**
+* Generate all schema files from IR.
+*/
+function generateSchemas(ir, options) {
+	return ir.schemas.map((schema) => generateSchema(schema, options));
+}
+/**
+* Convert name to file name (kebab-case).
+*/
+function toFileName(name) {
+	return name.replace(/([a-z])([A-Z])/g, "$1-$2").replace(/([A-Z])([A-Z][a-z])/g, "$1-$2").toLowerCase();
+}
+/**
+* Generate schema code.
+*/
+function generateSchemaCode(schema) {
+	const lines = [
+		`/**`,
+		` * ${schema.name}`,
+		` *`,
+		` * Generated from: ${schema.source.file}:${schema.source.startLine}`,
+		` * Schema type: ${schema.schemaType}`,
+		` * Confidence: ${schema.confidence.level}`,
+		` */`,
+		``,
+		`import { fromZod } from '@contractspec/lib.schema';`,
+		`import { z } from 'zod';`,
+		``
+	];
+	if (schema.rawDefinition && schema.schemaType === "zod") {
+		lines.push(`// Original definition from source:`);
+		lines.push(`// ${schema.rawDefinition.split("\n")[0]}`);
+		lines.push(``);
+	}
+	lines.push(`export const ${schema.name}Schema = fromZod(z.object({`);
+	if (schema.fields && schema.fields.length > 0) for (const field of schema.fields) {
+		const zodType = mapToZodType(field.type, field.optional);
+		lines.push(`  ${field.name}: ${zodType},`);
+	}
+	else lines.push(`  // TODO: Define schema fields`);
+	lines.push(`}));`);
+	lines.push(``);
+	lines.push(`export type ${schema.name} = z.infer<typeof ${schema.name}Schema.zodSchema>;`);
+	lines.push(``);
+	return lines.join("\n");
+}
+/**
+* Map TypeScript type to Zod type.
+*/
+function mapToZodType(tsType, optional) {
+	let zodType;
+	switch (tsType.toLowerCase()) {
+		case "string":
+			zodType = "z.string()";
+			break;
+		case "number":
+			zodType = "z.number()";
+			break;
+		case "boolean":
+			zodType = "z.boolean()";
+			break;
+		case "date":
+			zodType = "z.date()";
+			break;
+		case "string[]":
+		case "array<string>":
+			zodType = "z.array(z.string())";
+			break;
+		case "number[]":
+		case "array<number>":
+			zodType = "z.array(z.number())";
+			break;
+		default: zodType = "z.unknown()";
+	}
+	return optional ? `${zodType}.optional()` : zodType;
+}
+
+//#endregion
+export { generateSchema, generateSchemas };
+//# sourceMappingURL=schema-gen.js.map

package/dist/codegen/schema-gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-gen.js","names":[],"sources":["../../src/codegen/schema-gen.ts"],"sourcesContent":["/**\n * Schema code generator.\n *\n * Generates defineSchemaModel specs from schema candidates.\n */\n\nimport type { SchemaCandidate, ImportIR } from '../types';\nimport type { GeneratedFile, GenerationOptions } from './types';\n\n/**\n * Generate a single schema file.\n */\nexport function generateSchema(\n  schema: SchemaCandidate,\n  _options: GenerationOptions\n): GeneratedFile {\n  const fileName = `${toFileName(schema.name)}.ts`;\n  const code = generateSchemaCode(schema);\n\n  return {\n    path: `schemas/${fileName}`,\n    content: code,\n    type: 'schema',\n  };\n}\n\n/**\n * Generate all schema files from IR.\n */\nexport function generateSchemas(\n  ir: ImportIR,\n  options: GenerationOptions\n): GeneratedFile[] {\n  return ir.schemas.map((schema) => generateSchema(schema, options));\n}\n\n/**\n * Convert name to file name (kebab-case).\n */\nfunction toFileName(name: string): string {\n  return name\n    .replace(/([a-z])([A-Z])/g, '$1-$2')\n    .replace(/([A-Z])([A-Z][a-z])/g, '$1-$2')\n    .toLowerCase();\n}\n\n/**\n * Generate schema code.\n */\nfunction generateSchemaCode(schema: SchemaCandidate): string {\n  const lines = [\n    `/**`,\n    ` * ${schema.name}`,\n    ` *`,\n    ` * Generated from: ${schema.source.file}:${schema.source.startLine}`,\n    ` * Schema type: ${schema.schemaType}`,\n    ` * Confidence: ${schema.confidence.level}`,\n    ` */`,\n    ``,\n    `import { fromZod } from '@contractspec/lib.schema';`,\n    `import { z } from 'zod';`,\n    ``,\n  ];\n\n  if (schema.rawDefinition && schema.schemaType === 'zod') {\n    // Use the raw Zod definition if available\n    lines.push(`// Original definition from source:`);\n    lines.push(`// ${schema.rawDefinition.split('\\n')[0]}`);\n    lines.push(``);\n  }\n\n  lines.push(`export const ${schema.name}Schema = fromZod(z.object({`);\n\n  if (schema.fields && schema.fields.length > 0) {\n    for (const field of schema.fields) {\n      const zodType = mapToZodType(field.type, field.optional);\n      lines.push(`  ${field.name}: ${zodType},`);\n    }\n  } else {\n    lines.push(`  // TODO: Define schema fields`);\n  }\n\n  lines.push(`}));`);\n  lines.push(``);\n  lines.push(\n    `export type ${schema.name} = z.infer<typeof ${schema.name}Schema.zodSchema>;`\n  );\n  lines.push(``);\n\n  return lines.join('\\n');\n}\n\n/**\n * Map TypeScript type to Zod type.\n */\nfunction mapToZodType(tsType: string, optional: boolean): string {\n  let zodType: string;\n\n  switch (tsType.toLowerCase()) {\n    case 'string':\n      zodType = 'z.string()';\n      break;\n    case 'number':\n      zodType = 'z.number()';\n      break;\n    case 'boolean':\n      zodType = 'z.boolean()';\n      break;\n    case 'date':\n      zodType = 'z.date()';\n      break;\n    case 'string[]':\n    case 'array<string>':\n      zodType = 'z.array(z.string())';\n      break;\n    case 'number[]':\n    case 'array<number>':\n      zodType = 'z.array(z.number())';\n      break;\n    default:\n      zodType = 'z.unknown()';\n  }\n\n  return optional ? `${zodType}.optional()` : zodType;\n}\n"],"mappings":";;;;AAYA,SAAgB,eACd,QACA,UACe;CACf,MAAM,WAAW,GAAG,WAAW,OAAO,KAAK,CAAC;CAC5C,MAAM,OAAO,mBAAmB,OAAO;AAEvC,QAAO;EACL,MAAM,WAAW;EACjB,SAAS;EACT,MAAM;EACP;;;;;AAMH,SAAgB,gBACd,IACA,SACiB;AACjB,QAAO,GAAG,QAAQ,KAAK,WAAW,eAAe,QAAQ,QAAQ,CAAC;;;;;AAMpE,SAAS,WAAW,MAAsB;AACxC,QAAO,KACJ,QAAQ,mBAAmB,QAAQ,CACnC,QAAQ,wBAAwB,QAAQ,CACxC,aAAa;;;;;AAMlB,SAAS,mBAAmB,QAAiC;CAC3D,MAAM,QAAQ;EACZ;EACA,MAAM,OAAO;EACb;EACA,sBAAsB,OAAO,OAAO,KAAK,GAAG,OAAO,OAAO;EAC1D,mBAAmB,OAAO;EAC1B,kBAAkB,OAAO,WAAW;EACpC;EACA;EACA;EACA;EACA;EACD;AAED,KAAI,OAAO,iBAAiB,OAAO,eAAe,OAAO;AAEvD,QAAM,KAAK,sCAAsC;AACjD,QAAM,KAAK,MAAM,OAAO,cAAc,MAAM,KAAK,CAAC,KAAK;AACvD,QAAM,KAAK,GAAG;;AAGhB,OAAM,KAAK,gBAAgB,OAAO,KAAK,6BAA6B;AAEpE,KAAI,OAAO,UAAU,OAAO,OAAO,SAAS,EAC1C,MAAK,MAAM,SAAS,OAAO,QAAQ;EACjC,MAAM,UAAU,aAAa,MAAM,MAAM,MAAM,SAAS;AACxD,QAAM,KAAK,KAAK,MAAM,KAAK,IAAI,QAAQ,GAAG;;KAG5C,OAAM,KAAK,kCAAkC;AAG/C,OAAM,KAAK,OAAO;AAClB,OAAM,KAAK,GAAG;AACd,OAAM,KACJ,eAAe,OAAO,KAAK,oBAAoB,OAAO,KAAK,oBAC5D;AACD,OAAM,KAAK,GAAG;AAEd,QAAO,MAAM,KAAK,KAAK;;;;;AAMzB,SAAS,aAAa,QAAgB,UAA2B;CAC/D,IAAI;AAEJ,SAAQ,OAAO,aAAa,EAA5B;EACE,KAAK;AACH,aAAU;AACV;EACF,KAAK;AACH,aAAU;AACV;EACF,KAAK;AACH,aAAU;AACV;EACF,KAAK;AACH,aAAU;AACV;EACF,KAAK;EACL,KAAK;AACH,aAAU;AACV;EACF,KAAK;EACL,KAAK;AACH,aAAU;AACV;EACF,QACE,WAAU;;AAGd,QAAO,WAAW,GAAG,QAAQ,eAAe"}

package/dist/codegen/types.d.ts

@@ -0,0 +1,48 @@
+//#region src/codegen/types.d.ts
+/**
+ * Code generation types.
+ */
+/**
+ * A generated file.
+ */
+interface GeneratedFile {
+  /** Relative path from output directory */
+  path: string;
+  /** File content */
+  content: string;
+  /** Type of generated file */
+  type: 'operation' | 'schema' | 'registry' | 'index';
+}
+/**
+ * Options for code generation.
+ */
+interface GenerationOptions {
+  /** Output directory */
+  outputDir: string;
+  /** Whether to overwrite existing files */
+  overwrite?: boolean;
+  /** Schema format to use */
+  schemaFormat?: 'zod' | 'typescript';
+  /** Default auth level */
+  defaultAuth?: 'anonymous' | 'user' | 'admin';
+  /** Default owners */
+  defaultOwners?: string[];
+  /** Prefix for generated names */
+  prefix?: string;
+}
+/**
+ * Result of code generation.
+ */
+interface GenerationResult {
+  /** Generated files */
+  files: GeneratedFile[];
+  /** Number of operations generated */
+  operationsGenerated: number;
+  /** Number of schemas generated */
+  schemasGenerated: number;
+  /** Warnings during generation */
+  warnings: string[];
+}
+//#endregion
+export { GeneratedFile, GenerationOptions, GenerationResult };
+//# sourceMappingURL=types.d.ts.map

package/dist/codegen/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/codegen/types.ts"],"sourcesContent":[],"mappings":";;AAOA;AAYA;AAkBA;;;UA9BiB,aAAA;;;;;;;;;;;UAYA,iBAAA;;;;;;;;;;;;;;;;;UAkBA,gBAAA;;SAER"}

package/dist/detect.d.ts

@@ -0,0 +1,47 @@
+import { FrameworkInfo, ProjectInfo } from "./types.js";
+
+//#region src/detect.d.ts
+
+/**
+ * Dependencies from package.json.
+ */
+interface PackageDependencies {
+  dependencies?: Record<string, string>;
+  devDependencies?: Record<string, string>;
+  peerDependencies?: Record<string, string>;
+}
+/**
+ * Detect frameworks from package.json dependencies.
+ */
+declare function detectFrameworksFromPackageJson(packageJson: PackageDependencies): FrameworkInfo[];
+/**
+ * Detect frameworks from source code imports.
+ */
+declare function detectFrameworksFromCode(sourceCode: string): FrameworkInfo[];
+/**
+ * Detect frameworks from file paths.
+ */
+declare function detectFrameworksFromPaths(filePaths: string[]): FrameworkInfo[];
+/**
+ * Merge framework detections, preferring higher confidence.
+ */
+declare function mergeFrameworkDetections(...detections: FrameworkInfo[][]): FrameworkInfo[];
+/**
+ * Detect frameworks for a project.
+ * This is a convenience function that combines all detection methods.
+ */
+declare function detectFramework(rootPath: string, options?: {
+  readFile?: (path: string) => Promise<string>;
+  glob?: (pattern: string) => Promise<string[]>;
+}): Promise<ProjectInfo>;
+/**
+ * Get all supported framework IDs.
+ */
+declare function getSupportedFrameworks(): string[];
+/**
+ * Check if a framework ID is supported.
+ */
+declare function isFrameworkSupported(id: string): boolean;
+//#endregion
+export { detectFramework, detectFrameworksFromCode, detectFrameworksFromPackageJson, detectFrameworksFromPaths, getSupportedFrameworks, isFrameworkSupported, mergeFrameworkDetections };
+//# sourceMappingURL=detect.d.ts.map

package/dist/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","names":[],"sources":["../src/detect.ts"],"sourcesContent":[],"mappings":";;;;;;AA8FA;AA+BA,UAxCU,mBAAA,CAwCM;EA0BA,YAAA,CAAA,EAjEC,MAiED,CAAA,MAAyB,EAAA,MAAA,CAAA;EA8BzB,eAAA,CAAA,EA9FI,MA8FJ,CAAA,MAAwB,EAAA,MACvB,CAAA;EA8BK,gBAAA,CAAA,EA5HD,MA4HgB,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;AAM3B,iBA5HM,+BAAA,CA4HN,WAAA,EA3HK,mBA2HL,CAAA,EA1HP,aA0HO,EAAA;AAoCV;AAOA;;iBAxIgB,wBAAA,sBAA8C;;;;iBA0B9C,yBAAA,uBAEb;;;;iBA4Ba,wBAAA,gBACC,oBACd;;;;;iBA6BmB,eAAA;+BAGW;8BACD;IAE7B,QAAQ;;;;iBAoCK,sBAAA,CAAA;;;;iBAOA,oBAAA"}