adorn-api 1.0.12 → 1.0.14

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

@@ -0,0 +1,70 @@
+/**
+ * Union type handling module.
+ * Converts TypeScript union types to JSON Schema anyOf/oneOf constructs.
+ */
+import ts from "typescript";
+import type { JsonSchema, DiscriminatorObject, SchemaContext } from "./types.js";
+/**
+ * Handles TypeScript union types and converts them to JSON Schema.
+ * Creates anyOf schemas with optional discriminator for union members.
+ *
+ * @param type - The union 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 handleUnion(type: ts.UnionType, ctx: SchemaContext, typeNode?: ts.TypeNode): JsonSchema;
+/**
+ * Detects if a union type forms a discriminated union.
+ * A discriminated union has a common property with literal values that can be used for discrimination.
+ *
+ * @param types - The constituent types of the union
+ * @param ctx - The schema generation context
+ * @param branches - The generated schemas for each branch (unused in current impl)
+ * @returns Discriminator object if discriminated union detected, null otherwise
+ */
+export declare function detectDiscriminatedUnion(types: readonly ts.Type[], ctx: SchemaContext, _branches: JsonSchema[]): DiscriminatorObject | null;
+/**
+ * Finds property names that are common across all types in a union.
+ *
+ * @param checker - TypeScript type checker for property lookup
+ * @param types - The types to analyze
+ * @returns Array of property names present in all types
+ */
+export declare function findCommonPropertyNames(checker: ts.TypeChecker, types: readonly ts.Type[]): string[];
+/**
+ * Checks if a property is required (non-optional) in a given type.
+ *
+ * @param checker - TypeScript type checker for symbol analysis
+ * @param type - The type to check
+ * @param propName - The property name to check
+ * @returns True if the property is required
+ */
+export declare function isRequiredProperty(checker: ts.TypeChecker, type: ts.Type, propName: string): boolean;
+/**
+ * Gets the literal string values of a property across a type.
+ * Used for detecting discriminated unions.
+ *
+ * @param checker - TypeScript type checker for property type analysis
+ * @param type - The type to check
+ * @param propName - The property name to get values for
+ * @returns Set of literal values, or null if not a literal union
+ */
+export declare function getPropertyLiteralValues(checker: ts.TypeChecker, type: ts.Type, propName: string): Set<string> | null;
+/**
+ * Checks if multiple sets are pairwise disjoint (have no common elements).
+ *
+ * @param sets - Array of sets to check for disjointness
+ * @returns True if all sets are pairwise disjoint
+ */
+export declare function areSetsDisjoint(sets: Array<Set<string>>): boolean;
+/**
+ * Gets the schema name for a union branch type.
+ * Used for discriminator mapping.
+ *
+ * @param type - The type to get name for
+ * @param ctx - The schema generation context
+ * @returns The schema name, or generated anonymous name
+ */
+export declare function getBranchSchemaName(type: ts.Type, ctx: SchemaContext): string;
+//# sourceMappingURL=unionHandler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"unionHandler.d.ts","sourceRoot":"","sources":["../../../src/compiler/schema/unionHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGjF;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,EAAE,CAAC,SAAS,EAClB,GAAG,EAAE,aAAa,EAClB,QAAQ,CAAC,EAAE,EAAE,CAAC,QAAQ,GACrB,UAAU,CA6DZ;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,SAAS,EAAE,CAAC,IAAI,EAAE,EACzB,GAAG,EAAE,aAAa,EAClB,SAAS,EAAE,UAAU,EAAE,GACtB,mBAAmB,GAAG,IAAI,CA0B5B;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,IAAI,EAAE,GAAG,MAAM,EAAE,CAOpG;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAapG;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAoBrH;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CASjE;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,aAAa,GAAG,MAAM,CAY7E"}

package/dist/compiler/transform/dedup.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Deduplication transformation for removing duplicate type definitions.
+ * Merges identical types and updates references.
+ */
+import type { Graph, NodeId } from "../graph/types.js";
+import type { NodeTransformer } from "../ir/visitor.js";
+/**
+ * Type similarity comparison result
+ */
+interface TypeSimilarity {
+    score: number;
+    identical: boolean;
+}
+/**
+ * Deduplication transformation result
+ */
+export interface DeduplicationResult {
+    mergedNodes: Map<NodeId, NodeId>;
+    removedCount: number;
+    duplicatesFound: number;
+}
+/**
+ * Type deduplication transformer
+ */
+export declare function createDeduplicationTransformer(): NodeTransformer;
+/**
+ * Apply deduplication to graph
+ */
+export declare function applyDeduplication(graph: Graph): DeduplicationResult;
+/**
+ * Find structurally similar types
+ */
+export declare function findSimilarTypes(graph: Graph, threshold?: number): Array<[NodeId, NodeId, TypeSimilarity]>;
+export {};
+//# sourceMappingURL=dedup.d.ts.map

package/dist/compiler/transform/dedup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.d.ts","sourceRoot":"","sources":["../../../src/compiler/transform/dedup.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAGV,KAAK,EACL,MAAM,EACP,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAkB,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGxE;;GAEG;AACH,UAAU,cAAc;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,8BAA8B,IAAI,eAAe,CAkBhE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,mBAAmB,CA+CpE;AA0CD;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,KAAK,EACZ,SAAS,GAAE,MAAY,GACtB,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC,CAwBzC"}

package/dist/compiler/transform/flatten.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Flattening transformation for simplifying nested type structures.
+ * Flattens deeply nested object types into shallower structures.
+ */
+import type { Graph, NodeId } from "../graph/types.js";
+import type { NodeTransformer } from "../ir/visitor.js";
+/**
+ * Flattening configuration
+ */
+export interface FlattenConfig {
+    maxNestingLevel: number;
+    preserveNaming: boolean;
+    prefix: string;
+    mergeOverlapping: boolean;
+    maxProperties: number;
+}
+/**
+ * Default flattening configuration
+ */
+export declare const DEFAULT_FLATTEN_CONFIG: FlattenConfig;
+/**
+ * Flattening transformation result
+ */
+export interface FlattenResult {
+    flattenedNodes: NodeId[];
+    propertiesFlattened: number;
+    conflictsResolved: number;
+}
+/**
+ * Create flattening transformer
+ */
+export declare function createFlattenTransformer(config?: Partial<FlattenConfig>): NodeTransformer;
+/**
+ * Apply flattening to graph
+ */
+export declare function applyFlattening(graph: Graph, config?: Partial<FlattenConfig>): FlattenResult;
+/**
+ * Find deeply nested types that could benefit from flattening
+ */
+export declare function findNestedTypes(graph: Graph, config?: Partial<FlattenConfig>): NodeId[];
+/**
+ * Analyze flattening impact on the graph
+ */
+export declare function analyzeFlatteningImpact(graph: Graph, config?: Partial<FlattenConfig>): {
+    nodesAffected: number;
+    propertiesFlattened: number;
+    avgNestingLevelBefore: number;
+    avgNestingLevelAfter: number;
+};
+//# sourceMappingURL=flatten.d.ts.map

package/dist/compiler/transform/flatten.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatten.d.ts","sourceRoot":"","sources":["../../../src/compiler/transform/flatten.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAGV,KAAK,EACL,MAAM,EACP,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAkB,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGxE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,OAAO,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAMpC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM,GAClC,eAAe,CAajB;AA4BD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,KAAK,EACZ,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM,GAClC,aAAa,CAwBf;AAuHD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,KAAK,EACZ,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM,GAClC,MAAM,EAAE,CAqBV;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,KAAK,EACZ,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM,GAClC;IACD,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,oBAAoB,EAAE,MAAM,CAAC;CAC9B,CA0BA"}

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

@@ -0,0 +1,7 @@
+/**
+ * Graph transformations
+ */
+export * from './dedup.js';
+export * from './inline.js';
+export * from './flatten.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/compiler/transform/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}

package/dist/compiler/transform/inline.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Reference inlining transformation.
+ * Inlines small type definitions to reduce schema complexity.
+ */
+import type { AnyNode, Graph, NodeId } from "../graph/types.js";
+import type { VisitorContext } from "../ir/visitor.js";
+/**
+ * Inlining configuration
+ */
+export interface InliningConfig {
+    maxDepth: number;
+    maxNodes: number;
+    inlinePrimitives: boolean;
+    inlineSmallTypes: boolean;
+    smallTypeThreshold: number;
+    excludePatterns: RegExp[];
+}
+/**
+ * Default inlining configuration
+ */
+export declare const DEFAULT_INLINING_CONFIG: InliningConfig;
+/**
+ * Inlining transformation result
+ */
+export interface InliningResult {
+    inlinedNodes: NodeId[];
+    inlinedEdges: number;
+    nodesRemoved: number;
+}
+/**
+ * Create inlining transformer with custom config
+ */
+export declare function createInliningTransformer(config?: Partial<InliningConfig>): (node: AnyNode, context: VisitorContext) => AnyNode | null;
+/**
+ * Apply inlining to graph
+ */
+export declare function applyInlining(graph: Graph, config?: Partial<InliningConfig>): InliningResult;
+/**
+ * Calculate inlining depth for a node
+ */
+export declare function calculateInliningDepth(graph: Graph, nodeId: NodeId, visited?: Set<NodeId>): number;
+/**
+ * Find potential inline candidates
+ */
+export declare function findInlineCandidates(graph: Graph, config?: Partial<InliningConfig>): NodeId[];
+//# sourceMappingURL=inline.d.ts.map

package/dist/compiler/transform/inline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inline.d.ts","sourceRoot":"","sources":["../../../src/compiler/transform/inline.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EACV,OAAO,EACP,KAAK,EACL,MAAM,EAEP,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,cAOrC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,GAAE,OAAO,CAAC,cAAc,CAAM,IAGpE,MAAM,OAAO,EAAE,SAAS,cAAc,KAAG,OAAO,GAAG,IAAI,CAYhE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,KAAK,EACZ,MAAM,GAAE,OAAO,CAAC,cAAc,CAAM,GACnC,cAAc,CAsBhB;AA0KD;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,GAAG,CAAC,MAAM,CAAa,GAC/B,MAAM,CAgBR;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,KAAK,EACZ,MAAM,GAAE,OAAO,CAAC,cAAc,CAAM,GACnC,MAAM,EAAE,CAkBV"}

package/dist/compiler/validation/emitPrecompiledValidators.d.ts

@@ -1,9 +1,15 @@
+/**
+ * OpenAPI specification interface for validator generation.
+ */
 interface OpenApi {
     openapi: string;
     components?: {
         schemas?: Record<string, unknown>;
     };
 }
+/**
+ * Manifest interface for validator generation.
+ */
 interface Manifest {
     manifestVersion: number;
     controllers: Array<{
@@ -30,6 +36,9 @@ interface Manifest {
         }>;
     }>;
 }
+/**
+ * Options for emitting precompiled validators.
+ */
 export interface EmitPrecompiledValidatorsOptions {
     outDir: string;
     openapi: OpenApi;
@@ -37,6 +46,13 @@ export interface EmitPrecompiledValidatorsOptions {
     strict?: "off" | "log" | "error";
     formatsMode?: "fast" | "full";
 }
+/**
+ * Emits precompiled validators for the API.
+ * Generates standalone validation code using AJV for optimal performance.
+ *
+ * @param opts - Options including output directory, OpenAPI spec, manifest, and validation settings
+ * @returns Promise resolving to paths of generated validator files and a content hash
+ */
 export declare function emitPrecompiledValidators(opts: EmitPrecompiledValidatorsOptions): Promise<{
     validatorsCjsPath: string;
     validatorsEsmPath: string;

package/dist/compiler/validation/emitPrecompiledValidators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"emitPrecompiledValidators.d.ts","sourceRoot":"","sources":["../../../src/compiler/validation/emitPrecompiledValidators.ts"],"names":[],"mappings":"AAQA,UAAU,OAAO;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE;QACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC;CACH;AAED,UAAU,QAAQ;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,KAAK,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,KAAK,CAAC;YAChB,WAAW,EAAE,MAAM,CAAC;YACpB,IAAI,EAAE;gBACJ,IAAI,CAAC,EAAE;oBACL,SAAS,EAAE,MAAM,CAAC;oBAClB,WAAW,EAAE,MAAM,CAAC;iBACrB,GAAG,IAAI,CAAC;gBACT,QAAQ,CAAC,EAAE,KAAK,CAAC;oBACf,MAAM,EAAE,MAAM,CAAC;oBACf,WAAW,EAAE,MAAM,CAAC;oBACpB,SAAS,CAAC,EAAE,MAAM,CAAC;iBACpB,CAAC,CAAC;aACJ,CAAC;YACF,SAAS,EAAE,KAAK,CAAC;gBACf,MAAM,EAAE,MAAM,CAAC;gBACf,WAAW,EAAE,MAAM,CAAC;gBACpB,SAAS,EAAE,MAAM,CAAC;aACnB,CAAC,CAAC;SACJ,CAAC,CAAC;KACJ,CAAC,CAAC;CACJ;AA4CD,MAAM,WAAW,gCAAgC;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,OAAO,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC/B;AAED,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,gCAAgC,GAAG,OAAO,CAAC;IAC/F,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd,CAAC,CAyGD"}
+{"version":3,"file":"emitPrecompiledValidators.d.ts","sourceRoot":"","sources":["../../../src/compiler/validation/emitPrecompiledValidators.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,UAAU,OAAO;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE;QACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC;CACH;AAED;;GAEG;AACH,UAAU,QAAQ;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,KAAK,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,KAAK,CAAC;YAChB,WAAW,EAAE,MAAM,CAAC;YACpB,IAAI,EAAE;gBACJ,IAAI,CAAC,EAAE;oBACL,SAAS,EAAE,MAAM,CAAC;oBAClB,WAAW,EAAE,MAAM,CAAC;iBACrB,GAAG,IAAI,CAAC;gBACT,QAAQ,CAAC,EAAE,KAAK,CAAC;oBACf,MAAM,EAAE,MAAM,CAAC;oBACf,WAAW,EAAE,MAAM,CAAC;oBACpB,SAAS,CAAC,EAAE,MAAM,CAAC;iBACpB,CAAC,CAAC;aACJ,CAAC;YACF,SAAS,EAAE,KAAK,CAAC;gBACf,MAAM,EAAE,MAAM,CAAC;gBACf,WAAW,EAAE,MAAM,CAAC;gBACpB,SAAS,EAAE,MAAM,CAAC;aACnB,CAAC,CAAC;SACJ,CAAC,CAAC;KACJ,CAAC,CAAC;CACJ;AA4CD;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,OAAO,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,gCAAgC,GAAG,OAAO,CAAC;IAC/F,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd,CAAC,CAyGD"}

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

@@ -0,0 +1,5 @@
+/**
+ * Validation module exports
+ */
+export { emitPrecompiledValidators } from './emitPrecompiledValidators.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/decorators/Auth.d.ts

@@ -1,3 +1,20 @@
+/**
+ * Decorator to mark a method as requiring authentication.
+ *
+ * @param scheme - The authentication scheme to use (e.g., "Bearer", "Basic")
+ * @param options - Optional authentication configuration
+ * @param options.scopes - Required permission scopes for this endpoint
+ * @param options.optional - If true, authentication is optional (useful for mixed auth endpoints)
+ *
+ * @example
+ * ```ts
+ * @Auth("Bearer", { scopes: ["admin"] })
+ * @Delete("/users/:id")
+ * deleteUser() {
+ *   // Implementation
+ * }
+ * ```
+ */
 export declare function Auth(scheme: string, options?: {
     scopes?: string[];
     optional?: boolean;

package/dist/decorators/Auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Auth.d.ts","sourceRoot":"","sources":["../../src/decorators/Auth.ts"],"names":[],"mappings":"AAGA,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,IAEpF,QAAQ,GAAG,EACX,SAAS,2BAA2B,UAwBvC"}
+{"version":3,"file":"Auth.d.ts","sourceRoot":"","sources":["../../src/decorators/Auth.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,IAEpF,QAAQ,GAAG,EACX,SAAS,2BAA2B,UAwBvC"}

package/dist/decorators/Controller.d.ts

@@ -1,2 +1,17 @@
+/**
+ * Decorator to mark a class as a controller with a base path.
+ * All methods in the controller will be relative to this base path.
+ *
+ * @param basePath - The base path for all routes in this controller
+ *
+ * @example
+ * ```ts
+ * @Controller("/users")
+ * export class UsersController {
+ *   @Get("/:id")
+ *   getUser() { }
+ * }
+ * ```
+ */
 export declare function Controller(basePath: string): <T extends new (...args: any[]) => any>(target: T, context: ClassDecoratorContext<T>) => T | void;
 //# sourceMappingURL=Controller.d.ts.map

package/dist/decorators/Controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Controller.d.ts","sourceRoot":"","sources":["../../src/decorators/Controller.ts"],"names":[],"mappings":"AAEA,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,IACxB,CAAC,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACpD,QAAQ,CAAC,EACT,SAAS,qBAAqB,CAAC,CAAC,CAAC,KAChC,CAAC,GAAG,IAAI,CAIZ"}
+{"version":3,"file":"Controller.d.ts","sourceRoot":"","sources":["../../src/decorators/Controller.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,IACxB,CAAC,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACpD,QAAQ,CAAC,EACT,SAAS,qBAAqB,CAAC,CAAC,CAAC,KAChC,CAAC,GAAG,IAAI,CAIZ"}

package/dist/decorators/Public.d.ts

@@ -1,2 +1,15 @@
+/**
+ * Decorator to mark a method as public (no authentication required).
+ * Use this to explicitly allow unauthenticated access to specific endpoints.
+ *
+ * @example
+ * ```ts
+ * @Public()
+ * @Get("/health")
+ * healthCheck() {
+ *   return { status: "ok" };
+ * }
+ * ```
+ */
 export declare function Public(): (target: any, context: ClassMethodDecoratorContext) => void;
 //# sourceMappingURL=Public.d.ts.map

package/dist/decorators/Public.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Public.d.ts","sourceRoot":"","sources":["../../src/decorators/Public.ts"],"names":[],"mappings":"AAGA,wBAAgB,MAAM,KAElB,QAAQ,GAAG,EACX,SAAS,2BAA2B,UAoBvC"}
+{"version":3,"file":"Public.d.ts","sourceRoot":"","sources":["../../src/decorators/Public.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AACH,wBAAgB,MAAM,KAElB,QAAQ,GAAG,EACX,SAAS,2BAA2B,UAoBvC"}

package/dist/decorators/Use.d.ts

@@ -1,5 +1,23 @@
 import type { ExpressMw } from "../runtime/metadata/types.js";
 type UseTarget = string | ExpressMw;
+/**
+ * Decorator to apply middleware to a controller class or individual methods.
+ *
+ * @param middleware - One or more middleware functions or paths (for path-specific middleware)
+ *
+ * @example
+ * ```ts
+ * // Apply to entire controller
+ * @Use(cors(), helmet())
+ * @Controller("/api")
+ * class ApiController { }
+ *
+ * // Apply to specific method
+ * @Use(express.json())
+ * @Post("/upload")
+ * uploadFile() { }
+ * ```
+ */
 export declare function Use(...middleware: UseTarget[]): (target: any, context: ClassDecoratorContext | ClassMethodDecoratorContext) => void;
 export {};
 //# sourceMappingURL=Use.d.ts.map

package/dist/decorators/Use.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Use.d.ts","sourceRoot":"","sources":["../../src/decorators/Use.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,8BAA8B,CAAC;AAE1E,KAAK,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;AAEpC,wBAAgB,GAAG,CAAC,GAAG,UAAU,EAAE,SAAS,EAAE,IAE1C,QAAQ,GAAG,EACX,SAAS,qBAAqB,GAAG,2BAA2B,UA4B/D"}
+{"version":3,"file":"Use.d.ts","sourceRoot":"","sources":["../../src/decorators/Use.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,8BAA8B,CAAC;AAE1E,KAAK,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;AAEpC;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,GAAG,CAAC,GAAG,UAAU,EAAE,SAAS,EAAE,IAE1C,QAAQ,GAAG,EACX,SAAS,qBAAqB,GAAG,2BAA2B,UA4B/D"}

package/dist/decorators/methods.d.ts

@@ -1,6 +1,26 @@
+/**
+ * Creates a method decorator for HTTP GET requests.
+ * @param path - The route path for this endpoint
+ */
 export declare const Get: (path: string) => <T extends (...args: any[]) => any>(target: T, context: ClassMethodDecoratorContext<any, T>) => T | void;
+/**
+ * Creates a method decorator for HTTP POST requests.
+ * @param path - The route path for this endpoint
+ */
 export declare const Post: (path: string) => <T extends (...args: any[]) => any>(target: T, context: ClassMethodDecoratorContext<any, T>) => T | void;
+/**
+ * Creates a method decorator for HTTP PUT requests.
+ * @param path - The route path for this endpoint
+ */
 export declare const Put: (path: string) => <T extends (...args: any[]) => any>(target: T, context: ClassMethodDecoratorContext<any, T>) => T | void;
+/**
+ * Creates a method decorator for HTTP PATCH requests.
+ * @param path - The route path for this endpoint
+ */
 export declare const Patch: (path: string) => <T extends (...args: any[]) => any>(target: T, context: ClassMethodDecoratorContext<any, T>) => T | void;
+/**
+ * Creates a method decorator for HTTP DELETE requests.
+ * @param path - The route path for this endpoint
+ */
 export declare const Delete: (path: string) => <T extends (...args: any[]) => any>(target: T, context: ClassMethodDecoratorContext<any, T>) => T | void;
 //# sourceMappingURL=methods.d.ts.map

package/dist/decorators/methods.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"methods.d.ts","sourceRoot":"","sources":["../../src/decorators/methods.ts"],"names":[],"mappings":"AA8BA,eAAO,MAAM,GAAG,GAAI,MAAM,MAAM,MA1Bb,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,UACxC,CAAC,WACA,2BAA2B,CAAC,GAAG,EAAE,CAAC,CAAC,KAC3C,CAAC,GAAG,IAuB8D,CAAC;AACxE,eAAO,MAAM,IAAI,GAAI,MAAM,MAAM,MA3Bd,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,UACxC,CAAC,WACA,2BAA2B,CAAC,GAAG,EAAE,CAAC,CAAC,KAC3C,CAAC,GAAG,IAwBgE,CAAC;AAC1E,eAAO,MAAM,GAAG,GAAI,MAAM,MAAM,MA5Bb,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,UACxC,CAAC,WACA,2BAA2B,CAAC,GAAG,EAAE,CAAC,CAAC,KAC3C,CAAC,GAAG,IAyB8D,CAAC;AACxE,eAAO,MAAM,KAAK,GAAI,MAAM,MAAM,MA7Bf,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,UACxC,CAAC,WACA,2BAA2B,CAAC,GAAG,EAAE,CAAC,CAAC,KAC3C,CAAC,GAAG,IA0BkE,CAAC;AAC5E,eAAO,MAAM,MAAM,GAAI,MAAM,MAAM,MA9BhB,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,UACxC,CAAC,WACA,2BAA2B,CAAC,GAAG,EAAE,CAAC,CAAC,KAC3C,CAAC,GAAG,IA2BoE,CAAC"}
+{"version":3,"file":"methods.d.ts","sourceRoot":"","sources":["../../src/decorators/methods.ts"],"names":[],"mappings":"AA8BA;;;GAGG;AACH,eAAO,MAAM,GAAG,GAAI,MAAM,MAAM,MA9Bb,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,UACxC,CAAC,WACA,2BAA2B,CAAC,GAAG,EAAE,CAAC,CAAC,KAC3C,CAAC,GAAG,IA2B8D,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,IAAI,GAAI,MAAM,MAAM,MApCd,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,UACxC,CAAC,WACA,2BAA2B,CAAC,GAAG,EAAE,CAAC,CAAC,KAC3C,CAAC,GAAG,IAiCgE,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,GAAG,GAAI,MAAM,MAAM,MA1Cb,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,UACxC,CAAC,WACA,2BAA2B,CAAC,GAAG,EAAE,CAAC,CAAC,KAC3C,CAAC,GAAG,IAuC8D,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,KAAK,GAAI,MAAM,MAAM,MAhDf,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,UACxC,CAAC,WACA,2BAA2B,CAAC,GAAG,EAAE,CAAC,CAAC,KAC3C,CAAC,GAAG,IA6CkE,CAAC;AAE5E;;;GAGG;AACH,eAAO,MAAM,MAAM,GAAI,MAAM,MAAM,MAtDhB,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,UACxC,CAAC,WACA,2BAA2B,CAAC,GAAG,EAAE,CAAC,CAAC,KAC3C,CAAC,GAAG,IAmDoE,CAAC"}