adorn-api 1.0.12 → 1.0.14

package/dist/adapter/express/auth.d.ts

@@ -1,5 +1,13 @@
 import type { Response, NextFunction } from "express";
 import type { AuthenticatedRequest, CreateRouterOptions, OpenAPI31 } from "./types.js";
 import type { BoundRoute } from "./merge.js";
+/**
+ * Creates an authentication middleware for Express routes
+ *
+ * @param authConfig - Authentication configuration
+ * @param routeAuth - Route-specific authentication settings
+ * @param globalSecurity - Global security requirements from OpenAPI
+ * @returns Express middleware function
+ */
 export declare function createAuthMiddleware(authConfig: NonNullable<CreateRouterOptions["auth"]>, routeAuth: BoundRoute["auth"], globalSecurity: NonNullable<OpenAPI31["security"]>): (req: AuthenticatedRequest, res: Response, next: NextFunction) => Promise<void>;
 //# sourceMappingURL=auth.d.ts.map

package/dist/adapter/express/auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/adapter/express/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,wBAAgB,oBAAoB,CAChC,UAAU,EAAE,WAAW,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,EACpD,SAAS,EAAE,UAAU,CAAC,MAAM,CAAC,EAC7B,cAAc,EAAE,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,IAEpC,KAAK,oBAAoB,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,mBA4C7E"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/adapter/express/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAChC,UAAU,EAAE,WAAW,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,EACpD,SAAS,EAAE,UAAU,CAAC,MAAM,CAAC,EAC7B,cAAc,EAAE,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,IAEpC,KAAK,oBAAoB,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,mBA4C7E"}

package/dist/adapter/express/bootstrap.d.ts

@@ -1,6 +1,9 @@
 import express from "express";
 import { type Server } from "http";
 import { type CreateRouterOptions } from "./index.js";
+/**
+ * Options for bootstrapping an Express server with Adorn API
+ */
 export interface BootstrapOptions {
     controllers: Array<new (...args: any[]) => any>;
     port?: number;
@@ -13,6 +16,9 @@ export interface BootstrapOptions {
     auth?: CreateRouterOptions["auth"];
     coerce?: CreateRouterOptions["coerce"];
 }
+/**
+ * Result of bootstrapping an Express server
+ */
 export interface BootstrapResult {
     server: Server;
     app: express.Express;
@@ -21,5 +27,11 @@ export interface BootstrapResult {
     host: string;
     close: () => Promise<void>;
 }
+/**
+ * Bootstraps an Express server with the provided controllers and options
+ *
+ * @param options - Configuration options for the server
+ * @returns Promise that resolves with the server instance and metadata
+ */
 export declare function bootstrap(options: BootstrapOptions): Promise<BootstrapResult>;
 //# sourceMappingURL=bootstrap.d.ts.map

package/dist/adapter/express/bootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../../src/adapter/express/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,EAAuB,KAAK,mBAAmB,EAA0C,MAAM,YAAY,CAAC;AAGnH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,KAAK,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,mBAAmB,CAAC,YAAY,CAAC,CAAC;IAC/C,IAAI,CAAC,EAAE,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAuG7E"}
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../../src/adapter/express/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,EAAuB,KAAK,mBAAmB,EAAgB,MAAM,YAAY,CAAC;AAGzF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,KAAK,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,mBAAmB,CAAC,YAAY,CAAC,CAAC;IAC/C,IAAI,CAAC,EAAE,mBAAmB,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAkG7E"}

package/dist/adapter/express/coercion.d.ts

@@ -1,13 +1,67 @@
 import type { Request } from "express";
 import type { CoerceLocation, DateCoercionOptions, CoerceOptions } from "./types.js";
+/**
+ * Normalizes coercion options to ensure all properties are set
+ *
+ * @param coerce - Optional coercion options
+ * @returns Required coercion options with defaults applied
+ */
 export declare function normalizeCoerceOptions(coerce?: CoerceOptions): Required<CoerceOptions>;
+/**
+ * Gets date coercion options for a specific location
+ *
+ * @param coerce - Required coercion options
+ * @param location - The location to get options for
+ * @returns Date coercion options for the specified location
+ */
 export declare function getDateCoercionOptions(coerce: Required<CoerceOptions>, location: CoerceLocation): DateCoercionOptions;
+/**
+ * Coerces dates in a value based on the schema
+ *
+ * @param value - The value to coerce
+ * @param schema - The schema to use for coercion
+ * @param dateCoercion - Date coercion options
+ * @param components - OpenAPI components for schema resolution
+ * @returns The coerced value
+ */
 export declare function coerceDatesWithSchema(value: any, schema: Record<string, unknown> | null, dateCoercion: DateCoercionOptions, components: Record<string, Record<string, unknown>>): any;
+/**
+ * Coerces a parameter value based on the schema
+ *
+ * @param value - The value to coerce
+ * @param schema - The schema to use for coercion
+ * @param dateCoercion - Date coercion options
+ * @param components - OpenAPI components for schema resolution
+ * @returns The coerced value
+ */
 export declare function coerceParamValue(value: any, schema: Record<string, unknown> | null, dateCoercion: DateCoercionOptions, components: Record<string, Record<string, unknown>>): any;
+/**
+ * Coerces a value based on the schema
+ *
+ * @param value - The value to coerce
+ * @param schema - The schema to use for coercion
+ * @param dateCoercion - Date coercion options
+ * @param components - OpenAPI components for schema resolution
+ * @param options - Additional coercion options
+ * @returns The coerced value
+ */
 export declare function coerceWithSchema(value: any, schema: Record<string, unknown>, dateCoercion: DateCoercionOptions, components: Record<string, Record<string, unknown>>, options: {
     coercePrimitives: boolean;
 }): any;
+/**
+ * Checks if a value is a plain object
+ *
+ * @param value - The value to check
+ * @returns True if the value is a plain object
+ */
 export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+/**
+ * Parses a query value based on its schema type and serialization options
+ *
+ * @param value - The raw query value
+ * @param param - The parameter configuration
+ * @returns The parsed value
+ */
 export declare function parseQueryValue(value: any, param: {
     schemaType?: string | string[];
     serialization?: {
@@ -15,8 +69,34 @@ export declare function parseQueryValue(value: any, param: {
         explode?: boolean;
     };
 }): any;
+/**
+ * Gets the raw query string from a request
+ *
+ * @param req - The Express request object
+ * @returns The raw query string without the leading "?"
+ */
 export declare function getRawQueryString(req: Request): string;
-export declare function parseDeepObjectParams(rawQuery: string, names: Set<string>): Record<string, unknown>;
+/**
+ * Parses query string parameters with deep object style
+ *
+ * @param rawQuery - The raw query string
+ * @param names - Set of parameter names that use deepObject style
+ * @param maxDepth - Maximum nesting depth (default: 5)
+ * @returns Object containing the parsed deep object parameters
+ */
+export declare function parseDeepObjectParams(rawQuery: string, names: Set<string>, maxDepth?: number): Record<string, unknown>;
+/**
+ * Parses cookies from a cookie header
+ *
+ * @param cookieHeader - The cookie header string
+ * @returns Object containing the parsed cookies
+ */
 export declare function parseCookies(cookieHeader: string | undefined): Record<string, string>;
+/**
+ * Normalizes a sort parameter to an array of strings
+ *
+ * @param sort - The sort parameter (array or string)
+ * @returns Array of sort field names
+ */
 export declare function normalizeSort(sort: unknown): string[];
 //# sourceMappingURL=coercion.d.ts.map

package/dist/adapter/express/coercion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"coercion.d.ts","sourceRoot":"","sources":["../../../src/adapter/express/coercion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGrF,wBAAgB,sBAAsB,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,QAAQ,CAAC,aAAa,CAAC,CAUtF;AAED,wBAAgB,sBAAsB,CAClC,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC/B,QAAQ,EAAE,cAAc,GACzB,mBAAmB,CAMrB;AAED,wBAAgB,qBAAqB,CACjC,KAAK,EAAE,GAAG,EACV,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACtC,YAAY,EAAE,mBAAmB,EACjC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACpD,GAAG,CAGL;AAED,wBAAgB,gBAAgB,CAC5B,KAAK,EAAE,GAAG,EACV,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACtC,YAAY,EAAE,mBAAmB,EACjC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACpD,GAAG,CAGL;AAED,wBAAgB,gBAAgB,CAC5B,KAAK,EAAE,GAAG,EACV,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,YAAY,EAAE,mBAAmB,EACjC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACnD,OAAO,EAAE;IAAE,gBAAgB,EAAE,OAAO,CAAA;CAAE,GACvC,GAAG,CAiEL;AA0DD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAI9E;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAAC,aAAa,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GAAG,GAAG,CAgCjJ;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAKtD;AAED,wBAAgB,qBAAqB,CACjC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,GACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAczB;AAyDD,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAcrF;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE,CAQrD"}
+{"version":3,"file":"coercion.d.ts","sourceRoot":"","sources":["../../../src/adapter/express/coercion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGrF;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,QAAQ,CAAC,aAAa,CAAC,CAUtF;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAClC,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC/B,QAAQ,EAAE,cAAc,GACzB,mBAAmB,CAMrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACjC,KAAK,EAAE,GAAG,EACV,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACtC,YAAY,EAAE,mBAAmB,EACjC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACpD,GAAG,CAGL;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC5B,KAAK,EAAE,GAAG,EACV,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACtC,YAAY,EAAE,mBAAmB,EACjC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACpD,GAAG,CAGL;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC5B,KAAK,EAAE,GAAG,EACV,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,YAAY,EAAE,mBAAmB,EACjC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACnD,OAAO,EAAE;IAAE,gBAAgB,EAAE,OAAO,CAAA;CAAE,GACvC,GAAG,CAiEL;AA0DD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAI9E;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAAC,aAAa,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GAAG,GAAG,CAgCjJ;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAKtD;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACjC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,EAClB,QAAQ,GAAE,MAAU,GACrB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBzB;AAyDD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAcrF;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE,CAQrD"}

package/dist/adapter/express/index.d.ts

@@ -2,4 +2,5 @@ export * from "./types.js";
 export * from "./router.js";
 export * from "./swagger.js";
 export { bootstrap, type BootstrapOptions } from "./bootstrap.js";
+export { parseDeepObjectParams, getRawQueryString } from "./coercion.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/adapter/express/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapter/express/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapter/express/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC"}

package/dist/adapter/express/merge.d.ts

@@ -1,4 +1,7 @@
 import type { ManifestV1, OperationEntry } from "../../compiler/manifest/format.js";
+/**
+ * Represents a route bound to a controller
+ */
 export interface BoundRoute {
     operationId: string;
     fullPath: string;
@@ -15,12 +18,26 @@ export interface BoundRoute {
     } | "public";
     controllerUse?: Array<string | ((req: any, res: any, next: (err?: any) => void) => any)>;
 }
+/**
+ * Binds controllers to routes from the manifest
+ *
+ * @param params - Binding parameters including controllers and manifest
+ * @returns Array of bound routes
+ */
 export declare function bindRoutes(params: {
     controllers: Array<new (...args: any[]) => any>;
     manifest: ManifestV1;
     useCache?: boolean;
 }): BoundRoute[];
+/**
+ * Clears the route cache
+ */
 export declare function clearRouteCache(): void;
+/**
+ * Gets statistics about the route cache
+ *
+ * @returns Object containing cache size and keys
+ */
 export declare function getRouteCacheStats(): {
     size: number;
     keys: string[];

package/dist/adapter/express/merge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../../src/adapter/express/merge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAMpF,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC7C,cAAc,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IAC7B,SAAS,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC;IACvC,GAAG,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,KAAK,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC;IAC/E,IAAI,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,QAAQ,CAAC;IAC5E,aAAa,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,KAAK,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC;CAC1F;AA+BD,wBAAgB,UAAU,CAAC,MAAM,EAAE;IACjC,WAAW,EAAE,KAAK,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC;IAChD,QAAQ,EAAE,UAAU,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,UAAU,EAAE,CAyBf;AAoED,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED,wBAAgB,kBAAkB,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAKrE"}
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../../src/adapter/express/merge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAMpF;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC7C,cAAc,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IAC7B,SAAS,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC;IACvC,GAAG,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,KAAK,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC;IAC/E,IAAI,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,QAAQ,CAAC;IAC5E,aAAa,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,KAAK,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC;CAC1F;AA2BD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE;IACjC,WAAW,EAAE,KAAK,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC;IAChD,QAAQ,EAAE,UAAU,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,GAAG,UAAU,EAAE,CAyBf;AAoED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAKrE"}

package/dist/adapter/express/openapi.d.ts

@@ -1,11 +1,66 @@
 import type { BoundRoute } from "./merge.js";
 import type { OpenAPI31 } from "./types.js";
+/**
+ * Converts an Express path to OpenAPI path format
+ *
+ * @param path - Express path with colon parameters
+ * @returns OpenAPI path with curly brace parameters
+ */
 export declare function toOpenApiPath(path: string): string;
+/**
+ * Gets the OpenAPI operation for a given route
+ *
+ * @param openapi - The OpenAPI specification
+ * @param route - The bound route
+ * @returns OpenAPI operation object or null
+ */
 export declare function getOpenApiOperation(openapi: OpenAPI31, route: BoundRoute): any | null;
+/**
+ * Creates an index of parameter schemas by location and name
+ *
+ * @param operation - OpenAPI operation object
+ * @returns Map of parameter schemas keyed by location:name
+ */
 export declare function getParamSchemaIndex(operation: any | null): Map<string, Record<string, unknown>>;
+/**
+ * Gets a parameter schema from the index
+ *
+ * @param index - The parameter schema index
+ * @param location - The parameter location
+ * @param name - The parameter name
+ * @returns Parameter schema or null
+ */
 export declare function getParamSchemaFromIndex(index: Map<string, Record<string, unknown>>, location: "path" | "query" | "header" | "cookie", name: string): Record<string, unknown> | null;
+/**
+ * Gets the request body schema for an operation
+ *
+ * @param operation - OpenAPI operation object
+ * @param contentType - Optional content type to retrieve
+ * @returns Request body schema or null
+ */
 export declare function getRequestBodySchema(operation: any | null, contentType?: string): Record<string, unknown> | null;
+/**
+ * Creates a schema from a type
+ *
+ * @param schemaType - Schema type (string or array of strings)
+ * @returns Schema object or null
+ */
 export declare function schemaFromType(schemaType?: string | string[]): Record<string, unknown> | null;
+/**
+ * Resolves a schema, following $ref references
+ *
+ * @param schema - The schema to resolve
+ * @param components - OpenAPI components for reference resolution
+ * @param seen - Set of already seen references to prevent cycles
+ * @returns Resolved schema
+ */
 export declare function resolveSchema(schema: Record<string, unknown>, components: Record<string, Record<string, unknown>>, seen?: Set<string>): Record<string, unknown>;
+/**
+ * Gets a schema from OpenAPI by reference
+ *
+ * @param openapi - The OpenAPI specification
+ * @param ref - The schema reference
+ * @returns Schema object or null
+ */
 export declare function getSchemaByRef(openapi: OpenAPI31, ref: string): Record<string, unknown> | null;
 //# sourceMappingURL=openapi.d.ts.map

package/dist/adapter/express/openapi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../../src/adapter/express/openapi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,GAAG,GAAG,GAAG,IAAI,CAKrF;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,GAAG,GAAG,IAAI,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAU/F;AAED,wBAAgB,uBAAuB,CACnC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC3C,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,EAChD,IAAI,EAAE,MAAM,GACb,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAEhC;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,GAAG,GAAG,IAAI,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAUhH;AAED,wBAAgB,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAG7F;AAED,wBAAgB,aAAa,CACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACnD,IAAI,GAAE,GAAG,CAAC,MAAM,CAAa,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAczB;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAI9F"}
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../../src/adapter/express/openapi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,GAAG,GAAG,GAAG,IAAI,CAKrF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,GAAG,GAAG,IAAI,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAU/F;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACnC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC3C,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,EAChD,IAAI,EAAE,MAAM,GACb,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAEhC;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,GAAG,GAAG,IAAI,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAUhH;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAG7F;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACnD,IAAI,GAAE,GAAG,CAAC,MAAM,CAAa,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAczB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAI9F"}

package/dist/adapter/express/router.d.ts

@@ -1,4 +1,10 @@
 import { Router } from "express";
 import type { CreateRouterOptions } from "./types.js";
+/**
+ * Creates an Express router with Adorn API controllers
+ *
+ * @param options - Router configuration options
+ * @returns Promise that resolves with the configured Express router
+ */
 export declare function createExpressRouter(options: CreateRouterOptions): Promise<Router>;
 //# sourceMappingURL=router.d.ts.map

package/dist/adapter/express/router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../../src/adapter/express/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAOjC,OAAO,KAAK,EAAa,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAuBjE,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmQvF"}
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../../src/adapter/express/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAOjC,OAAO,KAAK,EAAa,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAuBjE;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CA6QvF"}

package/dist/adapter/express/swagger.d.ts

@@ -1,4 +1,10 @@
 import { Router } from "express";
 import type { SetupSwaggerOptions } from "./types.js";
+/**
+ * Sets up Swagger UI for API documentation
+ *
+ * @param options - Swagger configuration options
+ * @returns Express router with Swagger endpoints
+ */
 export declare function setupSwagger(options?: SetupSwaggerOptions): Router;
 //# sourceMappingURL=swagger.d.ts.map

package/dist/adapter/express/swagger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"swagger.d.ts","sourceRoot":"","sources":["../../../src/adapter/express/swagger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAIjC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,MAAM,CA4BtE"}
+{"version":3,"file":"swagger.d.ts","sourceRoot":"","sources":["../../../src/adapter/express/swagger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAIjC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,MAAM,CA4BtE"}

package/dist/adapter/express/types.d.ts

@@ -1,6 +1,9 @@
 import type { Request } from "express";
 import type { ManifestV1 } from "../../compiler/manifest/format.js";
 import type { AuthSchemeRuntime } from "../../runtime/auth/runtime.js";
+/**
+ * OpenAPI 3.1 specification structure
+ */
 export interface OpenAPI31 {
     openapi: string;
     components: {
@@ -10,9 +13,15 @@ export interface OpenAPI31 {
     paths?: Record<string, Record<string, any>>;
     security?: Array<Record<string, string[]>>;
 }
+/**
+ * Express request with authentication data
+ */
 export interface AuthenticatedRequest extends Request {
     auth?: any;
 }
+/**
+ * Coercion options for request parameters
+ */
 export interface CoerceOptions {
     body?: boolean;
     query?: boolean;
@@ -22,6 +31,16 @@ export interface CoerceOptions {
     dateTime?: boolean;
     date?: boolean;
 }
+/**
+ * Query parameter options
+ */
+export interface QueryOptions {
+    /** Maximum nesting depth for deepObject parameters (default: 5) */
+    maxNestingDepth?: number;
+}
+/**
+ * Options for creating an Express router
+ */
 export interface CreateRouterOptions {
     controllers: Array<new (...args: any[]) => any>;
     artifactsDir?: string;
@@ -32,11 +51,15 @@ export interface CreateRouterOptions {
     };
     coerce?: CoerceOptions;
     defaultPageSize?: number;
+    queryOptions?: QueryOptions;
     middleware?: {
         global?: Array<string | ((req: any, res: any, next: (err?: any) => void) => any)>;
         named?: Record<string, (req: any, res: any, next: (err?: any) => void) => any>;
     };
 }
+/**
+ * Options for setting up Swagger UI
+ */
 export interface SetupSwaggerOptions {
     artifactsDir?: string;
     jsonPath?: string;
@@ -50,6 +73,9 @@ export interface SetupSwaggerOptions {
         [key: string]: any;
     };
 }
+/**
+ * Represents a validation error
+ */
 export interface ValidationError {
     path: string;
     message: string;

package/dist/adapter/express/types.d.ts.map

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

package/dist/adapter/express/validation.d.ts

@@ -2,9 +2,26 @@ import type { Request } from "express";
 import type { BoundRoute } from "./merge.js";
 import type { OpenAPI31, ValidationError } from "./types.js";
 import { createValidator } from "../../runtime/validation/ajv.js";
+/**
+ * Validates a request using precompiled validators
+ *
+ * @param route - The bound route configuration
+ * @param req - The Express request object
+ * @param validators - Precompiled validators for the route
+ * @returns Array of validation errors, or null if validation passes
+ */
 export declare function validateRequestWithPrecompiled(route: BoundRoute, req: Request, validators: Record<string, {
     body?: (data: unknown) => boolean;
     response: Record<string, (data: unknown) => boolean>;
-}>): ValidationError[] | null;
-export declare function validateRequest(route: BoundRoute, req: Request, openapi: OpenAPI31, validator: ReturnType<typeof createValidator>): ValidationError[] | null;
+}>, maxDepth?: number): ValidationError[] | null;
+/**
+ * Validates a request against the OpenAPI schema
+ *
+ * @param route - The bound route configuration
+ * @param req - The Express request object
+ * @param openapi - The OpenAPI specification
+ * @param validator - The AJV validator instance
+ * @returns Array of validation errors, or null if validation passes
+ */
+export declare function validateRequest(route: BoundRoute, req: Request, openapi: OpenAPI31, validator: ReturnType<typeof createValidator>, maxDepth?: number): ValidationError[] | null;
 //# sourceMappingURL=validation.d.ts.map

package/dist/adapter/express/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/adapter/express/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAclE,wBAAgB,8BAA8B,CAC1C,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,OAAO,EACZ,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,CAAA;CAAE,CAAC,GACxH,eAAe,EAAE,GAAG,IAAI,CA6C1B;AAED,wBAAgB,eAAe,CAC3B,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,SAAS,EAClB,SAAS,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,GAC9C,eAAe,EAAE,GAAG,IAAI,CAwH1B"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/adapter/express/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAclE;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC1C,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,OAAO,EACZ,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,CAAA;CAAE,CAAC,EACvH,QAAQ,GAAE,MAAU,GACrB,eAAe,EAAE,GAAG,IAAI,CA2C1B;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC3B,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,SAAS,EAClB,SAAS,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,EAC7C,QAAQ,GAAE,MAAU,GACrB,eAAe,EAAE,GAAG,IAAI,CAwH1B"}