adorn-api 1.0.13 → 1.0.14

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"}

package/dist/express.cjs

@@ -167,11 +167,25 @@ function computeBoundRoutes(controllers, manifest) {
 var import_ajv = __toESM(require("ajv"), 1);
 var import_ajv_formats = __toESM(require("ajv-formats"), 1);
 var ValidationErrorResponse = class extends Error {
+  /**
+   * HTTP status code for validation errors.
+   */
+  statusCode;
+  /**
+   * Detailed validation errors.
+   */
+  errors;
+  /**
+   * Creates a new ValidationErrorResponse.
+   * 
+   * @param statusCode - HTTP status code (typically 400)
+   * @param errors - Array of validation errors
+   */
   constructor(statusCode, errors) {
     super("Validation failed");
+    this.name = "ValidationErrorResponse";
     this.statusCode = statusCode;
     this.errors = errors;
-    this.name = "ValidationErrorResponse";
   }
 };
 function createValidator() {
@@ -477,13 +491,16 @@ function getRawQueryString(req) {
   if (index === -1) return "";
   return url.slice(index + 1);
 }
-function parseDeepObjectParams(rawQuery, names) {
+function parseDeepObjectParams(rawQuery, names, maxDepth = 5) {
   const out = {};
   if (!rawQuery || names.size === 0) return out;
   const params = new URLSearchParams(rawQuery);
   for (const [key, value] of params.entries()) {
     const path3 = parseBracketPath(key);
     if (path3.length === 0) continue;
+    if (path3.length > maxDepth) {
+      throw new Error(`Query parameter nesting depth (${path3.length}) exceeds maximum of ${maxDepth}`);
+    }
     const root = path3[0];
     if (!names.has(root)) continue;
     assignDeepValue(out, path3, value);
@@ -596,10 +613,10 @@ function createAuthMiddleware(authConfig, routeAuth, globalSecurity) {
 }
 
 // src/adapter/express/validation.ts
-function validateRequestWithPrecompiled(route, req, validators) {
+function validateRequestWithPrecompiled(route, req, validators, maxDepth = 5) {
   const errors = [];
   const deepNames = new Set(route.args.query.filter((q) => q.serialization?.style === "deepObject").map((q) => q.name));
-  const deepValues = deepNames.size > 0 ? parseDeepObjectParams(getRawQueryString(req), deepNames) : {};
+  const deepValues = deepNames.size > 0 ? parseDeepObjectParams(getRawQueryString(req), deepNames, maxDepth) : {};
   if (route.args.body) {
     const validator = validators[route.operationId]?.body;
     if (validator) {
@@ -635,11 +652,11 @@ function validateRequestWithPrecompiled(route, req, validators) {
   }
   return errors.length > 0 ? errors : null;
 }
-function validateRequest(route, req, openapi, validator) {
+function validateRequest(route, req, openapi, validator, maxDepth = 5) {
   const openapiOperation = getOpenApiOperation(openapi, route);
   const paramSchemaIndex = getParamSchemaIndex(openapiOperation);
   const deepNames = new Set(route.args.query.filter((q) => q.serialization?.style === "deepObject").map((q) => q.name));
-  const deepValues = deepNames.size > 0 ? parseDeepObjectParams(getRawQueryString(req), deepNames) : {};
+  const deepValues = deepNames.size > 0 ? parseDeepObjectParams(getRawQueryString(req), deepNames, maxDepth) : {};
   const errors = [];
   if (route.args.body) {
     const bodySchema = getSchemaByRef(openapi, route.args.body.schemaRef);
@@ -744,7 +761,7 @@ function validateRequest(route, req, openapi, validator) {
 
 // src/adapter/express/router.ts
 async function createExpressRouter(options) {
-  const { controllers, artifactsDir = ".adorn", middleware = {}, defaultPageSize = 10 } = options;
+  const { controllers, artifactsDir = ".adorn", middleware = {}, defaultPageSize = 10, queryOptions } = options;
   let manifest;
   let openapi;
   let precompiledValidators = null;
@@ -814,10 +831,15 @@ async function createExpressRouter(options) {
     }
     router[method](route.fullPath, ...middlewareChain, async (req, res, next) => {
       try {
-        const validationErrors = precompiledValidators ? validateRequestWithPrecompiled(route, req, precompiledValidators) : validateRequest(route, req, openapi, validator);
+        const maxDepth = queryOptions?.maxNestingDepth ?? 5;
+        const validationErrors = precompiledValidators ? validateRequestWithPrecompiled(route, req, precompiledValidators, maxDepth) : validateRequest(route, req, openapi, validator, maxDepth);
         if (validationErrors) {
           return res.status(400).json(formatValidationErrors(validationErrors));
         }
+        const deepNames = new Set(
+          route.args.query.filter((q) => q.serialization?.style === "deepObject").map((q) => q.name)
+        );
+        const deepValues = deepNames.size > 0 ? parseDeepObjectParams(getRawQueryString(req), deepNames, maxDepth) : {};
         const instance = getInstance(route.controllerCtor);
         const handler = instance[route.methodName];
         if (typeof handler !== "function") {
@@ -843,7 +865,7 @@ async function createExpressRouter(options) {
           }
           if (jsonArgs.length > 0) {
             for (const q of jsonArgs) {
-              const rawValue = req.query[q.name];
+              const rawValue = q.serialization?.style === "deepObject" ? deepValues[q.name] : req.query[q.name];
               if (rawValue === void 0 || rawValue === null) continue;
               let parsed = rawValue;
               if (typeof rawValue === "string" && rawValue.length > 0) {
@@ -863,7 +885,7 @@ async function createExpressRouter(options) {
           }
           if (standardArgs.length > 0) {
             for (const q of standardArgs) {
-              const rawValue = req.query[q.name];
+              const rawValue = q.serialization?.style === "deepObject" ? deepValues[q.name] : req.query[q.name];
               if (rawValue === void 0) continue;
               const parsed = parseQueryValue(rawValue, q);
               const paramSchema = getParamSchemaFromIndex(paramSchemaIndex, "query", q.name) ?? (q.schemaRef ? getSchemaByRef(openapi, q.schemaRef) : null) ?? schemaFromType(q.schemaType);