adorn-api 1.0.22 → 1.0.24

package/src/e2e/sqlite.e2e.test.ts

@@ -0,0 +1,126 @@
+import { afterAll, beforeAll, describe, expect, it } from "vitest";
+import request from "supertest";
+import sqlite3 from "sqlite3";
+import {
+  Body,
+  Controller,
+  Dto,
+  Field,
+  Get,
+  Post,
+  Returns,
+  createExpressApp,
+  t,
+  type RequestContext
+} from "../index";
+
+let db: sqlite3.Database;
+
+function run(sql: string, params: unknown[] = []): Promise<{ lastID: number; changes: number }> {
+  return new Promise((resolve, reject) => {
+    db.run(sql, params, function onRun(err) {
+      if (err) {
+        reject(err);
+        return;
+      }
+      resolve({ lastID: this.lastID, changes: this.changes });
+    });
+  });
+}
+
+function get<T>(sql: string, params: unknown[] = []): Promise<T | undefined> {
+  return new Promise((resolve, reject) => {
+    db.get(sql, params, (err, row) => {
+      if (err) {
+        reject(err);
+        return;
+      }
+      resolve(row as T | undefined);
+    });
+  });
+}
+
+function all<T>(sql: string, params: unknown[] = []): Promise<T[]> {
+  return new Promise((resolve, reject) => {
+    db.all(sql, params, (err, rows) => {
+      if (err) {
+        reject(err);
+        return;
+      }
+      resolve(rows as T[]);
+    });
+  });
+}
+
+function closeDb(): Promise<void> {
+  return new Promise((resolve, reject) => {
+    db.close((err) => {
+      if (err) {
+        reject(err);
+        return;
+      }
+      resolve();
+    });
+  });
+}
+
+@Dto()
+class CreateUserDto {
+  @Field(t.string({ minLength: 1 }))
+  name!: string;
+}
+
+@Dto()
+class UserDto {
+  @Field(t.integer())
+  id!: number;
+
+  @Field(t.string({ minLength: 1 }))
+  name!: string;
+}
+
+@Controller("/users")
+class UserController {
+  @Get("/")
+  @Returns(t.array(t.ref(UserDto)))
+  async list() {
+    return all<UserDto>("select id, name from users order by id asc");
+  }
+
+  @Post("/")
+  @Body(CreateUserDto)
+  @Returns({ status: 201, schema: UserDto })
+  async create(ctx: RequestContext<CreateUserDto>) {
+    const result = await run("insert into users (name) values (?)", [ctx.body.name]);
+    const row = await get<UserDto>("select id, name from users where id = ?", [result.lastID]);
+    return row!;
+  }
+}
+
+describe("e2e sqlite memory", () => {
+  const app = createExpressApp({ controllers: [UserController] });
+
+  beforeAll(async () => {
+    db = new sqlite3.Database(":memory:");
+    await run("create table users (id integer primary key autoincrement, name text not null)");
+  });
+
+  afterAll(async () => {
+    await closeDb();
+  });
+
+  it("creates and lists users", async () => {
+    const createResponse = await request(app)
+      .post("/users")
+      .send({ name: "Ada" })
+      .expect(201);
+
+    expect(createResponse.body).toMatchObject({ id: 1, name: "Ada" });
+
+    const listResponse = await request(app)
+      .get("/users")
+      .expect(200);
+
+    expect(listResponse.body).toEqual([{ id: 1, name: "Ada" }]);
+  });
+});

package/src/index.ts

@@ -0,0 +1,8 @@
+export * from "./core/decorators";
+export * from "./core/schema";
+export * from "./core/openapi";
+export * from "./core/errors";
+export * from "./core/coerce";
+export * from "./adapter/express";
+export * from "./adapter/metal-orm/index";
+export * from "./core/types";

package/tsconfig.eslint.json

@@ -0,0 +1,7 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "allowJs": true
+  },
+  "include": ["src", "examples", "scripts", "vitest.config.ts"]
+}

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "CommonJS",
+    "moduleResolution": "Node",
+    "rootDir": "src",
+    "outDir": "dist",
+    "declaration": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "esModuleInterop": true,
+    "useDefineForClassFields": true,
+    "experimentalDecorators": false,
+    "emitDecoratorMetadata": false
+  },
+  "include": ["src"]
+}

package/vitest.config.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    environment: "node",
+    include: ["src/**/*.test.ts"]
+  }
+});

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

@@ -1,13 +0,0 @@
-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 +0,0 @@
-{"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,40 +0,0 @@
-import express from "express";
-import { type Server } from "http";
-import { type CreateRouterOptions, type CorsConfig, type SetupSwaggerOptions } from "./index.js";
-/**
- * Options for bootstrapping an Express server with Adorn API
- */
-export interface BootstrapOptions {
-    controllers: Array<new (...args: any[]) => any>;
-    port?: number;
-    host?: string;
-    artifactsDir?: string;
-    enableSwagger?: boolean;
-    swaggerPath?: string;
-    swaggerJsonPath?: string;
-    swaggerOptions?: SetupSwaggerOptions["swaggerOptions"];
-    swaggerUiOptions?: SetupSwaggerOptions["swaggerUiOptions"];
-    middleware?: CreateRouterOptions["middleware"];
-    auth?: CreateRouterOptions["auth"];
-    coerce?: CreateRouterOptions["coerce"];
-    cors?: CorsConfig;
-}
-/**
- * Result of bootstrapping an Express server
- */
-export interface BootstrapResult {
-    server: Server;
-    app: express.Express;
-    url: string;
-    port: number;
-    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 +0,0 @@
-{"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,KAAK,UAAU,EAAE,KAAK,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAIpI;;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,cAAc,CAAC,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;IACvD,gBAAgB,CAAC,EAAE,mBAAmB,CAAC,kBAAkB,CAAC,CAAC;IAC3D,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;IACvC,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;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;AAkDD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAyG7E"}

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

@@ -1,102 +0,0 @@
-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?: {
-        style?: string;
-        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;
-/**
- * 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 +0,0 @@
-{"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

@@ -1,6 +0,0 @@
-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 +0,0 @@
-{"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,45 +0,0 @@
-import type { ManifestV1, OperationEntry } from "../../compiler/manifest/format.js";
-/**
- * Represents a route bound to a controller
- */
-export interface BoundRoute {
-    operationId: string;
-    fullPath: string;
-    httpMethod: OperationEntry["http"]["method"];
-    controllerCtor: new (...args: any[]) => any;
-    methodName: string;
-    args: OperationEntry["args"];
-    responses: OperationEntry["responses"];
-    use?: Array<string | ((req: any, res: any, next: (err?: any) => void) => any)>;
-    auth?: {
-        scheme: string;
-        scopes?: string[];
-        optional?: boolean;
-    } | "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[];
-};
-//# sourceMappingURL=merge.d.ts.map

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

@@ -1 +0,0 @@
-{"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,66 +0,0 @@
-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 +0,0 @@
-{"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,10 +0,0 @@
-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 +0,0 @@
-{"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,18 +0,0 @@
-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;
-/**
- * Create a Swagger UI router with custom configuration
- *
- * @param openapiPath - Path to the OpenAPI spec file
- * @param options - Additional Swagger UI options
- * @returns Configured Express router
- */
-export declare function createSwaggerRouter(openapiPath: string, options?: Partial<SetupSwaggerOptions>): Router;
-//# sourceMappingURL=swagger.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"swagger.d.ts","sourceRoot":"","sources":["../../../src/adapter/express/swagger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAKjC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAoDtD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,MAAM,CAqDtE;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,OAAO,CAAC,mBAAmB,CAAM,GACzC,MAAM,CAOR"}

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

@@ -1,110 +0,0 @@
-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: {
-        schemas: Record<string, Record<string, unknown>>;
-        securitySchemes?: Record<string, Record<string, unknown>>;
-    };
-    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;
-    path?: boolean;
-    header?: boolean;
-    cookie?: boolean;
-    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;
-    manifest?: ManifestV1;
-    openapi?: OpenAPI31;
-    auth?: {
-        schemes: Record<string, AuthSchemeRuntime>;
-    };
-    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;
-    uiPath?: string;
-    swaggerOptions?: {
-        url?: string;
-        servers?: Array<{
-            url: string;
-            description?: string;
-        }>;
-        [key: string]: any;
-    };
-    swaggerUiOptions?: {
-        dom_id?: string;
-        deepLinking?: boolean;
-        presets?: Array<any>;
-        plugins?: Array<any>;
-        [key: string]: any;
-    };
-}
-/**
- * Represents a validation error
- */
-export interface ValidationError {
-    path: string;
-    message: string;
-    keyword: string;
-    params: Record<string, unknown>;
-}
-export type CoerceLocation = "body" | "query" | "path" | "header" | "cookie";
-export type DateCoercionOptions = {
-    dateTime: boolean;
-    date: boolean;
-};
-export type StaticOrigin = boolean | string | RegExp | Array<string | RegExp>;
-export type CustomOrigin = (requestOrigin: string | undefined, callback: (err: Error | null, origin?: StaticOrigin) => void) => void;
-export interface CorsOptions {
-    origin?: StaticOrigin | CustomOrigin;
-    methods?: string | string[];
-    allowedHeaders?: string | string[];
-    exposedHeaders?: string | string[];
-    credentials?: boolean;
-    maxAge?: number;
-    preflightContinue?: boolean;
-    optionsSuccessStatus?: number;
-}
-export type CorsConfig = boolean | CorsOptions | ((app: import('express').Express) => void);
-//# sourceMappingURL=types.d.ts.map

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

@@ -1 +0,0 @@
-{"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

@@ -1,27 +0,0 @@
-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>;
-}>, 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