adorn-api 1.0.23 → 1.0.24

package/dist/compiler/manifest/format.d.ts

@@ -1,119 +0,0 @@
-/**
- * Manifest type definitions.
- * Describes the structure of the manifest file generated during compilation.
- */
-/**
- * Supported HTTP methods for API operations.
- */
-export type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS" | "HEAD";
-/**
- * Supported content types for request and response bodies.
- */
-export type ContentType = "application/json" | "text/plain" | "application/octet-stream" | "multipart/form-data" | string;
-/**
- * Root manifest interface representing the complete API metadata.
- * Contains version, generation info, schema references, and all controller definitions.
- */
-export interface ManifestV1 {
-    manifestVersion: 1;
-    generatedAt: string;
-    generator: {
-        name: "adorn-api";
-        version: string;
-        typescript: string;
-    };
-    schemas: {
-        kind: "openapi-3.1";
-        file: string;
-        componentsSchemasPointer: string;
-    };
-    validation: {
-        mode: "none" | "ajv-runtime" | "precompiled";
-        precompiledModule: string | null;
-    };
-    controllers: ControllerEntry[];
-}
-/**
- * Represents a controller entry in the manifest.
- * Contains the controller identifier and all its operations.
- */
-export interface ControllerEntry {
-    controllerId: string;
-    basePath: string;
-    operations: OperationEntry[];
-}
-/**
- * Represents a single API operation (endpoint) in the manifest.
- * Contains operation ID, HTTP method/path, handler reference, arguments, and responses.
- */
-export interface OperationEntry {
-    operationId: string;
-    http: {
-        method: HttpMethod;
-        path: string;
-    };
-    handler: {
-        methodName: string;
-    };
-    args: ArgsSpec;
-    responses: ResponseSpec[];
-}
-/**
- * Specification of all arguments for an operation.
- * Groups arguments by their location (body, path, query, headers, cookies).
- */
-export interface ArgsSpec {
-    body: BodyArgSpec | null;
-    path: NamedArgSpec[];
-    query: NamedArgSpec[];
-    headers: NamedArgSpec[];
-    cookies: NamedArgSpec[];
-}
-/**
- * Specification for a request body argument.
- */
-export interface BodyArgSpec {
-    index: number;
-    required: boolean;
-    contentType: ContentType;
-    schemaRef: string;
-    encoding?: Record<string, EncodingSpec>;
-}
-/**
- * Encoding options for multipart request bodies.
- */
-export interface EncodingSpec {
-    contentType?: string;
-    headers?: Record<string, string>;
-}
-/**
- * Specification for named arguments (path, query, headers, cookies).
- * Contains the parameter name, index, requirement status, and schema reference.
- */
-export interface NamedArgSpec {
-    name: string;
-    index: number;
-    required: boolean;
-    schemaRef: string;
-    schemaType?: string | string[];
-    serialization?: SerializationSpec;
-    content?: "application/json";
-}
-/**
- * Serialization options for complex parameter types.
- */
-export interface SerializationSpec {
-    style?: "form" | "spaceDelimited" | "pipeDelimited" | "deepObject";
-    explode?: boolean;
-    allowReserved?: boolean;
-}
-/**
- * Specification for an operation response.
- */
-export interface ResponseSpec {
-    status: number;
-    contentType: ContentType;
-    schemaRef: string;
-    isArray?: boolean;
-}
-//# sourceMappingURL=format.d.ts.map

package/dist/compiler/manifest/format.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/compiler/manifest/format.ts"],"names":[],"mappings":"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"}

package/dist/compiler/manifest/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * Manifest module exports
- */
-export { generateManifest } from './emit.js';
-export type { ManifestV1, ControllerEntry, OperationEntry, HttpMethod } from './format.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/compiler/manifest/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/compiler/manifest/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,YAAY,EACV,UAAU,EACV,eAAe,EACf,cAAc,EACd,UAAU,EACX,MAAM,aAAa,CAAC"}

package/dist/compiler/runner/createProgram.d.ts

@@ -1,24 +0,0 @@
-/**
- * TypeScript program creation module.
- * Sets up the TypeScript compiler API for source analysis.
- */
-import ts from "typescript";
-/**
- * Context object containing the TypeScript program, type checker, and source files.
- * Used throughout the compiler for source analysis and type information.
- */
-export interface ProgramContext {
-    program: ts.Program;
-    checker: ts.TypeChecker;
-    sourceFiles: ts.SourceFile[];
-}
-/**
- * Creates a TypeScript program from a tsconfig.json file.
- * Parses the configuration and sets up the compiler host for source analysis.
- *
- * @param tsconfigPath - Path to the TypeScript configuration file
- * @returns ProgramContext containing the program, checker, and filtered source files
- * @throws Error if the config file cannot be read or parsed
- */
-export declare function createProgramFromConfig(tsconfigPath: string): ProgramContext;
-//# sourceMappingURL=createProgram.d.ts.map

package/dist/compiler/runner/createProgram.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"createProgram.d.ts","sourceRoot":"","sources":["../../../src/compiler/runner/createProgram.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,YAAY,CAAC;AAI5B;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC;IACpB,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC;IACxB,WAAW,EAAE,EAAE,CAAC,UAAU,EAAE,CAAC;CAC9B;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc,CAwB5E"}

package/dist/compiler/runner/index.d.ts

@@ -1,5 +0,0 @@
-/**
- * Runner module exports
- */
-export { createProgramFromConfig, type ProgramContext } from './createProgram.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/compiler/runner/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/compiler/runner/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,uBAAuB,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/compiler/schema/extractAnnotations.d.ts

@@ -1,57 +0,0 @@
-/**
- * Schema annotation extraction module.
- * Parses decorator-based schema annotations from TypeScript source code.
- */
-import ts from "typescript";
-/**
- * Represents a fragment of JSON Schema that can be merged with other fragments.
- * Used for collecting schema annotations from decorators.
- */
-export interface SchemaFragment {
-    [key: string]: unknown;
-}
-/**
- * Extracts schema annotation fragments from a property or parameter declaration.
- * Looks for decorators like @Min, @Max, @Pattern, etc. and converts them to JSON Schema fragments.
- *
- * @param checker - TypeScript type checker for symbol resolution
- * @param prop - The property or parameter declaration to analyze
- * @returns Array of schema fragments from found decorators
- */
-export declare function extractPropertySchemaFragments(checker: ts.TypeChecker, prop: ts.PropertyDeclaration | ts.ParameterDeclaration): SchemaFragment[];
-/**
- * Merges multiple schema fragments into a single schema object.
- * Later fragments override earlier ones for conflicting keys.
- *
- * @param base - The base schema object to merge into
- * @param frags - Variable number of schema fragments to merge
- * @returns The merged schema object
- */
-export declare function mergeFragments(base: Record<string, unknown>, ...frags: SchemaFragment[]): Record<string, unknown>;
-/**
- * Extracts the description from JSDoc comments on a node.
- *
- * @param checker - TypeScript type checker
- * @param node - The AST node to extract description from
- * @returns The cleaned description text, or undefined if no description found
- */
-export declare function extractJSDocDescription(checker: ts.TypeChecker, node: ts.Node): string | undefined;
-/**
- * Extracts JSDoc tags from a node and converts them to schema properties.
- * Supports @example, @default, @description, and @deprecated tags.
- *
- * @param checker - TypeScript type checker
- * @param node - The AST node to extract tags from
- * @returns Object mapping tag names to their extracted values
- */
-export declare function extractJSDocTags(checker: ts.TypeChecker, node: ts.Node): Record<string, unknown>;
-/**
- * Extracts schema annotation fragments from a class declaration.
- * Looks for class-level decorators and JSDoc comments.
- *
- * @param checker - TypeScript type checker for symbol resolution
- * @param classDecl - The class declaration to analyze
- * @returns Array of schema fragments from found annotations
- */
-export declare function extractClassSchemaFragments(checker: ts.TypeChecker, classDecl: ts.ClassDeclaration): SchemaFragment[];
-//# sourceMappingURL=extractAnnotations.d.ts.map

package/dist/compiler/schema/extractAnnotations.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"extractAnnotations.d.ts","sourceRoot":"","sources":["../../../src/compiler/schema/extractAnnotations.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,EAAE,CAAC,WAAW,EACvB,IAAI,EAAE,EAAE,CAAC,mBAAmB,GAAG,EAAE,CAAC,oBAAoB,GACrD,cAAc,EAAE,CAkGlB;AA+DD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,KAAK,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMjH;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,MAAM,GAAG,SAAS,CAmBlG;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA+BhG;AA+BD;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,EAAE,CAAC,WAAW,EACvB,SAAS,EAAE,EAAE,CAAC,gBAAgB,GAC7B,cAAc,EAAE,CA4DlB"}

package/dist/compiler/schema/index.d.ts

@@ -1,10 +0,0 @@
-/**
- * Schema module exports
- */
-export { typeToJsonSchema, createSchemaContext } from './typeToJsonSchema.js';
-export type { JsonSchema, SchemaContext } from './types.js';
-export { analyzeQueryBuilderWithServiceCalls, } from './queryBuilderAnalyzer.js';
-export { ServiceCallAnalyzer, analyzeMultipleControllersWithServiceCalls, clearServiceCallAnalyzerCaches, type ServiceCallInfo, type MethodCallChain, type ServiceCallAnalyzerOptions, } from './serviceCallAnalyzer.js';
-export { partitionSchemas, SchemaPartitioner, type PartitionStrategy, type SchemaGroup, type PartitioningResult, type SchemaComplexity, calculateSchemaComplexity, } from './partitioner.js';
-export { generateModularOpenAPI, generateLazyOpenAPI, type SplitOpenAPIConfig, type SplitOpenAPIResult, } from './splitOpenapi.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/compiler/schema/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/compiler/schema/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG5D,OAAO,EACL,mCAAmC,GACpC,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,mBAAmB,EACnB,0CAA0C,EAC1C,8BAA8B,EAC9B,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,0BAA0B,GAChC,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAC"}

package/dist/compiler/schema/intersectionHandler.d.ts

@@ -1,44 +0,0 @@
-/**
- * Intersection type handling module.
- * Converts TypeScript intersection types to JSON Schema allOf constructs.
- */
-import ts from "typescript";
-import type { JsonSchema, SchemaContext } from "./types.js";
-/**
- * Handles TypeScript intersection types and converts them to JSON Schema.
- * Tries to collapse branded intersections and builds named schemas for complex intersections.
- *
- * @param type - The intersection type to convert
- * @param ctx - The schema generation context
- * @param typeNode - Optional type node for additional context
- * @returns The generated JSON Schema
- */
-export declare function handleIntersection(type: ts.IntersectionType, ctx: SchemaContext, typeNode?: ts.TypeNode): JsonSchema;
-/**
- * Attempts to collapse a branded intersection type to a simpler schema.
- * A branded intersection is one that combines a primitive type with a brand object type.
- *
- * @param types - The constituent types of the intersection
- * @param ctx - The schema generation context
- * @param typeNode - Optional type node for additional context
- * @returns The simplified schema if collapse is possible, null otherwise
- */
-export declare function tryCollapseBrandedIntersection(types: readonly ts.Type[], ctx: SchemaContext, _typeNode?: ts.TypeNode): JsonSchema | null;
-/**
- * Checks if a TypeScript type represents a primitive type (string, number, boolean, bigint, or their literals).
- *
- * @param t - The type to check
- * @returns True if the type is a primitive or primitive literal
- */
-export declare function isPrimitiveLike(t: ts.Type): boolean;
-/**
- * Checks if a TypeScript type represents a brand/billing object type.
- * Brand objects are simple objects with only brand-related properties like __brand or brand.
- *
- * @param checker - TypeScript type checker
- * @param t - The type to check
- * @param _ctx - The schema generation context (unused)
- * @returns True if the type appears to be a brand object
- */
-export declare function isBrandObject(checker: ts.TypeChecker, t: ts.Type, _ctx: SchemaContext): boolean;
-//# sourceMappingURL=intersectionHandler.d.ts.map

package/dist/compiler/schema/intersectionHandler.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"intersectionHandler.d.ts","sourceRoot":"","sources":["../../../src/compiler/schema/intersectionHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG5D;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,EAAE,CAAC,gBAAgB,EACzB,GAAG,EAAE,aAAa,EAClB,QAAQ,CAAC,EAAE,EAAE,CAAC,QAAQ,GACrB,UAAU,CA6BZ;AAED;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,SAAS,EAAE,CAAC,IAAI,EAAE,EACzB,GAAG,EAAE,aAAa,EAClB,SAAS,CAAC,EAAE,EAAE,CAAC,QAAQ,GACtB,UAAU,GAAG,IAAI,CAanB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,OAAO,CAInD;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAkB/F"}

package/dist/compiler/schema/objectHandler.d.ts

@@ -1,146 +0,0 @@
-/**
- * Object type handling module.
- * Converts TypeScript object types and interfaces to JSON Schema.
- */
-import ts from "typescript";
-import type { JsonSchema, SchemaContext } from "./types.js";
-/**
- * Checks if a type is a type parameter (generic type variable like T, U, etc.)
- *
- * @param type - The type to check
- * @returns True if the type is a type parameter
- */
-export declare function isTypeParameter(type: ts.Type): boolean;
-/**
- * Gets the name of a type parameter if the type is one
- *
- * @param type - The type to check
- * @returns The type parameter name, or null if not a type parameter
- */
-export declare function getTypeParameterName(type: ts.Type): string | null;
-/**
- * Extracts type arguments from a generic type reference
- *
- * @param type - The type to extract from
- * @returns Array of type arguments, or undefined if not a generic type
- */
-export declare function getTypeArguments(type: ts.Type): ts.Type[] | undefined;
-/**
- * Creates a type parameter substitution map from a generic type
- * For interface Foo<T, U>, creates Map("T" -> arg1, "U" -> arg2)
- *
- * @param type - The generic type
- * @param typeNode - Optional type node for extracting type parameter names
- * @param checker - TypeScript type checker
- * @returns Map of type parameter names to actual types
- */
-export declare function createTypeParameterSubstitutions(type: ts.Type, typeNode: ts.TypeNode | undefined, checker: ts.TypeChecker): Map<string, ts.Type> | undefined;
-/**
- * Resolves a type parameter to its actual type if a substitution is available
- *
- * @param type - The type to resolve
- * @param substitutions - Map of type parameter names to actual types
- * @param _checker - TypeScript type checker (unused, for future extensions)
- * @returns The resolved type if the type is a type parameter with a substitution, otherwise null
- */
-export declare function resolveTypeParameter(type: ts.Type, substitutions: Map<string, ts.Type> | undefined, _checker: ts.TypeChecker): ts.Type | null;
-/**
- * Handles TypeScript object types and converts them to JSON Schema.
- * Manages named schemas, component registration, and cycle detection.
- *
- * @param type - The object type to convert
- * @param ctx - The schema generation context
- * @param typeNode - Optional type node for additional context
- * @returns The generated JSON Schema
- */
-export declare function handleObjectType(type: ts.ObjectType, ctx: SchemaContext, typeNode?: ts.TypeNode): JsonSchema;
-/**
- * Builds the actual object schema from a TypeScript object type.
- * Extracts properties, handles required fields, and processes Record types.
- *
- * @param type - The object type to convert
- * @param ctx - The schema generation context
- * @param typeNode - Optional type node for additional context
- * @returns The generated object schema
- */
-export declare function buildObjectSchema(type: ts.ObjectType, ctx: SchemaContext, _typeNode?: ts.TypeNode): JsonSchema;
-/**
- * Checks if a TypeScript type represents a Record type.
- *
- * @param type - The type to check
- * @param _checker - TypeScript type checker (unused)
- * @returns True if the type is a Record type
- */
-export declare function isRecordType(type: ts.ObjectType, _checker: ts.TypeChecker): boolean;
-/**
- * Extracts the value type from a Record type.
- * For Record<K, V>, returns V.
- *
- * @param type - The Record type to extract from
- * @param _checker - TypeScript type checker (unused)
- * @returns The value type, or null if not a Record or has no type arguments
- */
-export declare function getRecordValueType(type: ts.ObjectType, _checker: ts.TypeChecker): ts.Type | null;
-/**
- * Checks if a type represents a Metal ORM wrapper type (e.g., HasManyCollection, BelongsToReference).
- *
- * @param type - The type to check
- * @param checker - TypeScript type checker for symbol resolution
- * @returns True if the type is a Metal ORM wrapper
- */
-export declare function isMetalOrmWrapperType(type: ts.Type, checker: ts.TypeChecker): boolean;
-/**
- * Checks if a TypeScript type represents a callable/method-like type.
- *
- * @param type - The type to check
- * @returns True if the type has call signatures (is callable)
- */
-export declare function isMethodLike(type: ts.Type): boolean;
-/**
- * Checks if a property name represents an iterator or Symbol property that should be excluded.
- *
- * @param propName - The property name to check
- * @returns True if the property should be excluded from schema generation
- */
-export declare function isIteratorOrSymbolProperty(propName: string): boolean;
-/**
- * Gets the type name from a type node or generates an anonymous name.
- *
- * @param typeNode - The type node to extract name from
- * @param _ctx - The schema generation context (unused)
- * @returns The type name or generated anonymous name
- */
-export declare function getTypeNameFromNode(typeNode: ts.TypeNode | undefined, _ctx: SchemaContext): string;
-interface MetalOrmWrapperInfo {
-    wrapperName: string;
-    targetTypeArgs: ReadonlyArray<ts.Type>;
-    isReadonlyArray: boolean;
-}
-/**
- * Finds and extracts information about a Metal ORM wrapper type within a type.
- * Handles both direct wrapper types and wrapper types within intersections.
- *
- * @param type - The type to analyze
- * @param checker - TypeScript type checker for symbol resolution
- * @returns Wrapper info if found, null otherwise
- */
-export declare function findMetalOrmWrapper(type: ts.Type, checker: ts.TypeChecker): MetalOrmWrapperInfo | null;
-/**
- * Gets the name of a Metal ORM wrapper type if applicable.
- *
- * @param type - The type to check
- * @param _checker - TypeScript type checker (unused)
- * @returns The wrapper type name if applicable, null otherwise
- */
-export declare function getWrapperTypeName(type: ts.Type, _checker: ts.TypeChecker): string | null;
-/**
- * Handles Metal ORM wrapper types and converts them to appropriate JSON Schema.
- * Different wrapper types result in different schema structures.
- *
- * @param type - The wrapper object type to convert
- * @param ctx - The schema generation context
- * @returns The generated JSON Schema for the wrapper
- */
-export declare function handleMetalOrmWrapper(type: ts.ObjectType, ctx: SchemaContext): JsonSchema;
-export {};
-//# sourceMappingURL=objectHandler.d.ts.map

package/dist/compiler/schema/objectHandler.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"objectHandler.d.ts","sourceRoot":"","sources":["../../../src/compiler/schema/objectHandler.ts"],"names":[],"mappings":"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"}

package/dist/compiler/schema/openapi.d.ts

@@ -1,71 +0,0 @@
-/**
- * OpenAPI specification generation module.
- * Converts scanned controllers to OpenAPI 3.1 format.
- */
-import ts from "typescript";
-import type { ScannedController } from "../analyze/scanControllers.js";
-import type { JsonSchema } from "./types.js";
-/**
- * OpenAPI 3.1 specification interface.
- */
-export interface OpenAPI31 {
-    openapi: "3.1.0";
-    info: {
-        title: string;
-        version: string;
-    };
-    components: {
-        schemas: Record<string, JsonSchema>;
-    };
-    paths: Record<string, Record<string, any>>;
-}
-/**
- * Progress callback for OpenAPI generation
- */
-export interface OpenAPIProgressCallback {
-    (message: string, current: number, total: number): void;
-}
-/**
- * Detailed progress callback with query builder analysis info
- */
-export interface OpenAPIDetailedProgressCallback {
-    (info: {
-        /** Controller being processed */
-        controller: string;
-        /** Operation being processed */
-        operation: string;
-        /** HTTP method */
-        method: string;
-        /** Operation path */
-        path: string;
-        /** Whether query builder pattern was detected */
-        queryBuilderDetected: boolean;
-        /** Entity name if detected */
-        entityName?: string;
-        /** Selected fields if detected */
-        selectedFields?: string[];
-        /** Whether using paged results */
-        isPaged?: boolean;
-        /** Current progress */
-        current: number;
-        /** Total operations */
-        total: number;
-    }): void;
-}
-/**
- * Generates an OpenAPI 3.1 specification from scanned controllers.
- *
- * @param controllers - Array of scanned controllers to include in the spec
- * @param checker - TypeScript type checker for type analysis
- * @param options - Optional title and version for the OpenAPI info object
- * @param onProgress - Optional callback to report progress during generation
- * @param onQueryBuilderProgress - Optional callback to report query builder detection details
- * @returns Complete OpenAPI 3.1 specification object
- */
-export declare function generateOpenAPI(controllers: ScannedController[], checker: ts.TypeChecker, options?: {
-    title?: string;
-    version?: string;
-    onProgress?: OpenAPIProgressCallback;
-    onQueryBuilderProgress?: OpenAPIDetailedProgressCallback;
-}): OpenAPI31;
-//# sourceMappingURL=openapi.d.ts.map

package/dist/compiler/schema/openapi.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../../src/compiler/schema/openapi.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,KAAK,EAAE,iBAAiB,EAAsC,MAAM,+BAA+B,CAAC;AAG3G,OAAO,KAAK,EAAiB,UAAU,EAAE,MAAM,YAAY,CAAC;AAY5D;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,UAAU,EAAE;QACV,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;KACrC,CAAC;IACF,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACzD;AAED;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C,CAAC,IAAI,EAAE;QACL,iCAAiC;QACjC,UAAU,EAAE,MAAM,CAAC;QACnB,gCAAgC;QAChC,SAAS,EAAE,MAAM,CAAC;QAClB,kBAAkB;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,qBAAqB;QACrB,IAAI,EAAE,MAAM,CAAC;QACb,iDAAiD;QACjD,oBAAoB,EAAE,OAAO,CAAC;QAC9B,8BAA8B;QAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,kCAAkC;QAClC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;QAC1B,kCAAkC;QAClC,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,uBAAuB;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,uBAAuB;QACvB,KAAK,EAAE,MAAM,CAAC;KACf,GAAG,IAAI,CAAC;CACV;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,iBAAiB,EAAE,EAChC,OAAO,EAAE,EAAE,CAAC,WAAW,EACvB,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC,sBAAsB,CAAC,EAAE,+BAA+B,CAAC;CACrD,GACL,SAAS,CAyFX"}

package/dist/compiler/schema/parameters.d.ts

@@ -1,90 +0,0 @@
-/**
- * Parameter specification building module.
- * Converts scanned parameters to OpenAPI parameter objects.
- */
-import type { ScannedOperation } from "../analyze/scanControllers.js";
-import type { SchemaContext, JsonSchema } from "./types.js";
-/**
- * Builds OpenAPI path parameter objects from scanned operation parameters.
- * Adds them to the provided parameters array.
- *
- * @param operation - The scanned operation containing path parameters
- * @param ctx - The schema generation context
- * @param parameters - Array to accumulate parameter objects
- */
-export declare function buildPathParameters(operation: ScannedOperation, ctx: SchemaContext, parameters: any[]): void;
-/**
- * Builds OpenAPI query parameter objects from scanned operation parameters.
- * Handles both individual query parameters and query objects.
- *
- * @param operation - The scanned operation containing query parameters
- * @param ctx - The schema generation context
- * @param parameters - Array to accumulate parameter objects
- */
-export declare function buildQueryParameters(operation: ScannedOperation, ctx: SchemaContext, parameters: any[]): void;
-/**
- * Builds OpenAPI header parameter objects from scanned operation parameters.
- * Extracts individual header parameters from a headers object.
- *
- * @param operation - The scanned operation containing header parameters
- * @param ctx - The schema generation context
- * @param parameters - Array to accumulate parameter objects
- */
-export declare function buildHeaderParameters(operation: ScannedOperation, ctx: SchemaContext, parameters: any[]): void;
-/**
- * Builds OpenAPI cookie parameter objects from scanned operation parameters.
- * Extracts individual cookie parameters from a cookies object.
- *
- * @param operation - The scanned operation containing cookie parameters
- * @param ctx - The schema generation context
- * @param parameters - Array to accumulate parameter objects
- */
-export declare function buildCookieParameters(operation: ScannedOperation, ctx: SchemaContext, parameters: any[]): void;
-/**
- * Determines OpenAPI serialization style/explode options based on schema type.
- *
- * @param schemaType - The schema type(s) to analyze
- * @returns Object containing style and explode options if applicable
- */
-export declare function determineQuerySerialization(schemaType: string | string[] | undefined): {
-    style?: string;
-    explode?: boolean;
-};
-/**
- * Generates an example value description for a schema.
- * Creates a human-readable example showing the expected structure.
- *
- * @param schema - The JSON Schema to generate example for
- * @param propName - The property name for the example
- * @returns A description string with example value
- */
-export declare function generateExampleValue(schema: JsonSchema, propName: string): string;
-/**
- * Parses an example value from a description string.
- * Extracts the JSON object from "Example: propName={...}" format.
- *
- * @param description - The description string to parse
- * @returns The extracted JSON string, or default if not found
- */
-export declare function parseExampleValue(description: string): string;
-/**
- * Recursively resolves $ref references in a JSON Schema.
- *
- * @param schema - The schema to resolve references in
- * @param components - Map of component schemas for reference resolution
- * @returns The resolved schema with all references followed
- */
-export declare function resolveSchemaRef(schema: JsonSchema, components: Map<string, JsonSchema>): JsonSchema;
-/**
- * Resolves object schema references and collects all properties.
- * Handles allOf composition and $ref resolution.
- *
- * @param schema - The object schema to process
- * @param components - Map of component schemas for reference resolution
- * @returns Object containing all collected properties and required fields
- */
-export declare function resolveAndCollectObjectProps(schema: JsonSchema, components: Map<string, JsonSchema>): {
-    properties: Record<string, JsonSchema>;
-    required: string[];
-};
-//# sourceMappingURL=parameters.d.ts.map

package/dist/compiler/schema/parameters.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"parameters.d.ts","sourceRoot":"","sources":["../../../src/compiler/schema/parameters.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI5D;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,gBAAgB,EAAE,GAAG,EAAE,aAAa,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,IAAI,CAkC5G;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,gBAAgB,EAAE,GAAG,EAAE,aAAa,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,IAAI,CA4H7G;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,gBAAgB,EAAE,GAAG,EAAE,aAAa,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,IAAI,CAmB9G;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,gBAAgB,EAAE,GAAG,EAAE,aAAa,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,IAAI,CAqB9G;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAS5H;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAyBjF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAM7D;AA+CD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,UAAU,CAWpG;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAClC;IAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAiChE"}