adorn-api 1.0.1 → 1.0.2

package/dist/metadata/keys.d.ts

@@ -5,6 +5,9 @@
  * Some runtimes may not have Symbol.metadata yet; TypeScript's emit still uses it,
  * so we polyfill Symbol.metadata to a stable symbol if missing.
  */
+import type { ResponsesSpec } from '../contracts/responses.js';
+import type { RouteOptions } from '../contracts/route-options.js';
+import type { SecurityRequirementObject, SecuritySchemeObject } from '../contracts/openapi-v3.js';
 export declare const SYMBOL_METADATA: symbol;
 /**
  * All adorn-api metadata keys live here.
@@ -20,20 +23,118 @@ export declare const META: {
     readonly bindings: symbol;
 };
 /**
- * Minimal shapes for group-1.
+ * Metadata shape for controller-level configuration.
+ *
+ * Stores base path information for controllers that can be used
+ * to prefix all routes defined within the controller.
+ *
+ * @example
+ * ```typescript
+ * // Controller with base path metadata
+ * const controllerMeta: ControllerMeta = {
+ *   basePath: '/api/v1'
+ * };
+ *
+ * // This would make all routes in the controller start with /api/v1
+ * ```
  */
 export type ControllerMeta = {
+    /** Base path for all routes in this controller */
     basePath: string;
 };
+/**
+ * Metadata shape for individual route definitions.
+ *
+ * Stores information about HTTP methods, paths, route names,
+ * and additional route-specific configuration.
+ *
+ * @example
+ * ```typescript
+ * // Route metadata for a GET endpoint
+ * const routeMeta: RouteMeta = {
+ *   method: 'GET',
+ *   path: '/users/:id',
+ *   name: 'getUser',
+ *   options: {
+ *     summary: 'Get user by ID',
+ *     responses: {
+ *       200: { description: 'User found' },
+ *       404: { description: 'User not found' }
+ *     }
+ *   }
+ * };
+ * ```
+ */
 export type RouteMeta = {
+    /** HTTP method for this route */
     method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    /** Route path template */
     path: string;
+    /** Method name on the controller */
     name: string;
+    /** Additional route configuration options */
     options?: unknown;
 };
+/**
+ * Metadata shape for database transaction configuration.
+ *
+ * Controls transactional behavior for database operations
+ * associated with routes or controllers.
+ *
+ * @example
+ * ```typescript
+ * // Automatic transaction (default)
+ * const autoTransaction: DbMeta = {
+ *   transactional: 'auto'
+ * };
+ *
+ * // Required transaction
+ * const requiredTransaction: DbMeta = {
+ *   transactional: 'required'
+ * };
+ *
+ * // No transaction
+ * const noTransaction: DbMeta = {
+ *   transactional: 'none'
+ * };
+ * ```
+ */
 export type DbMeta = {
+    /**
+     * Transactional behavior:
+     * - 'auto': Automatic transaction management (default)
+     * - 'required': Requires existing transaction
+     * - 'none': No transaction
+     */
     transactional: 'auto' | 'required' | 'none';
 };
+/**
+ * Binding hint for parameter binding configuration.
+ *
+ * Specifies how parameters should be bound from different
+ * sources (path, query, body) with optional type hints.
+ *
+ * @example
+ * ```typescript
+ * // Path parameter with type hint
+ * const pathHint: BindingHint = {
+ *   kind: 'path',
+ *   name: 'id',
+ *   type: 'uuid'
+ * };
+ *
+ * // Query parameter
+ * const queryHint: BindingHint = {
+ *   kind: 'query',
+ *   name: 'limit'
+ * };
+ *
+ * // Body binding
+ * const bodyHint: BindingHint = {
+ *   kind: 'body'
+ * };
+ * ```
+ */
 export type BindingHint = {
     kind: 'path';
     name: string;
@@ -44,9 +145,110 @@ export type BindingHint = {
 } | {
     kind: 'body';
 };
+/**
+ * Metadata shape for parameter binding configuration.
+ *
+ * Stores binding hints organized by method name for
+ * fine-grained control over parameter binding behavior.
+ *
+ * @example
+ * ```typescript
+ * // Binding metadata for a controller
+ * const bindingsMeta: BindingsMeta = {
+ *   byMethod: {
+ *     'getUser': {
+ *       path: {
+ *         id: 'uuid',      // Bind id parameter as UUID
+ *         status: 'string' // Bind status parameter as string
+ *       }
+ *     },
+ *     'createUser': {
+ *       path: {
+ *         teamId: 'int'    // Bind teamId parameter as integer
+ *       }
+ *     }
+ *   }
+ * };
+ * ```
+ */
 export type BindingsMeta = {
+    /**
+     * Binding configuration by method name
+     * @template MethodName - Name of the controller method
+     */
     byMethod?: Record<string, {
+        /** Type hints for path parameters */
         path?: Record<string, 'string' | 'int' | 'number' | 'boolean' | 'uuid'>;
     }>;
 };
+/**
+ * Metadata shape for OpenAPI documentation configuration.
+ *
+ * Stores documentation-related information including tags,
+ * security requirements, responses, and method-specific docs.
+ *
+ * @example
+ * ```typescript
+ * // Comprehensive documentation metadata
+ * const docsMeta: DocsMeta = {
+ *   tags: ['Users', 'API'],
+ *   deprecated: false,
+ *   operationId: 'getUserById',
+ *   security: [{ bearerAuth: [] }],
+ *   responses: {
+ *     200: { description: 'User found' },
+ *     404: { description: 'User not found' }
+ *   },
+ *   byMethod: {
+ *     'getUser': {
+ *       summary: 'Get user by ID',
+ *       description: 'Retrieves a user by their unique identifier'
+ *     }
+ *   }
+ * };
+ * ```
+ */
+export type DocsMeta = {
+    /** Tags for API documentation grouping */
+    tags?: string[];
+    /** Whether this endpoint is deprecated */
+    deprecated?: boolean;
+    /** Unique operation identifier */
+    operationId?: string;
+    /** Security requirements for this endpoint */
+    security?: SecurityRequirementObject[];
+    /** Response specifications */
+    responses?: ResponsesSpec;
+    /** Method-specific documentation overrides */
+    byMethod?: Record<string, Partial<RouteOptions<string>>>;
+};
+/**
+ * Metadata shape for security scheme definitions.
+ *
+ * Stores security schemes that can be referenced by
+ * routes and controllers for authentication/authorization.
+ *
+ * @example
+ * ```typescript
+ * // Security metadata with multiple schemes
+ * const securityMeta: SecurityMeta = {
+ *   schemes: {
+ *     bearerAuth: {
+ *       type: 'http',
+ *       scheme: 'bearer',
+ *       bearerFormat: 'JWT'
+ *     },
+ *     apiKey: {
+ *       type: 'apiKey',
+ *       name: 'X-API-Key',
+ *       in: 'header'
+ *     }
+ *   }
+ * };
+ * ```
+ */
+export type SecurityMeta = {
+    /** Security schemes available for this API */
+    schemes?: Record<string, SecuritySchemeObject>;
+};
 //# sourceMappingURL=keys.d.ts.map

package/dist/metadata/keys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../src/metadata/keys.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,EAAE,MAO1B,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,IAAI;;;;;;;;CAQP,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IACnB,aAAa,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAA;CAAE,GACvF;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErB,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,EAAE,MAAM,CACf,MAAM,EACN;QACE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC,CAAC;KACzE,CACF,CAAC;CACH,CAAC"}
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../src/metadata/keys.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAElG,eAAO,MAAM,eAAe,EAAE,MAS1B,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,IAAI;;;;;;;;CAQP,CAAC;AAEX;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,iCAAiC;IACjC,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpD,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,MAAM,MAAM,GAAG;IACnB;;;;;OAKG;IACH,aAAa,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;CAC7C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAA;CAAE,GACvF;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErB;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CACf,MAAM,EACN;QACE,qCAAqC;QACrC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC,CAAC;KACzE,CACF,CAAC;CACH,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,yBAAyB,EAAE,CAAC;IACvC,8BAA8B;IAC9B,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;CAC1D,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;CAChD,CAAC"}

package/dist/metadata/keys.js

@@ -1,16 +1,10 @@
-/**
- * Stage-3 decorators store metadata in a "metadata bag" accessible at runtime via:
- *   MyClass[Symbol.metadata]
- *
- * Some runtimes may not have Symbol.metadata yet; TypeScript's emit still uses it,
- * so we polyfill Symbol.metadata to a stable symbol if missing.
- */
 export const SYMBOL_METADATA = (() => {
-    const existing = Symbol.metadata;
+    const symbolWithMeta = Symbol;
+    const existing = symbolWithMeta.metadata;
     if (typeof existing === 'symbol')
         return existing;
     const created = Symbol('Symbol.metadata');
-    Symbol.metadata = created;
+    symbolWithMeta.metadata = created;
     return created;
 })();
 /**

package/dist/metadata/keys.js.map

@@ -1 +1 @@
-{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../src/metadata/keys.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAW,CAAC,GAAG,EAAE;IAC3C,MAAM,QAAQ,GAAI,MAAc,CAAC,QAAQ,CAAC;IAC1C,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAElD,MAAM,OAAO,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;IACzC,MAAc,CAAC,QAAQ,GAAG,OAAO,CAAC;IACnC,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC,EAAE,CAAC;AAEL;;;GAGG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,sBAAsB,CAAC;IAC9C,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC;IACtC,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,sBAAsB,CAAC;IAC9C,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC;CAClC,CAAC"}
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../src/metadata/keys.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,eAAe,GAAW,CAAC,GAAG,EAAE;IAE3C,MAAM,cAAc,GAAG,MAAwB,CAAC;IAChD,MAAM,QAAQ,GAAG,cAAc,CAAC,QAAQ,CAAC;IACzC,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAElD,MAAM,OAAO,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAC1C,cAAc,CAAC,QAAQ,GAAG,OAAO,CAAC;IAClC,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC,EAAE,CAAC;AAEL;;;GAGG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,sBAAsB,CAAC;IAC9C,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC;IACtC,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,sBAAsB,CAAC;IAC9C,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC;CAClC,CAAC"}

package/dist/metadata/merge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../src/metadata/merge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAqBhE"}
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../src/metadata/merge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAwBhE"}

package/dist/metadata/merge.js

@@ -14,7 +14,10 @@ export function mergeBags(base, child) {
             continue;
         }
         if (isPlainObject(baseValue) && isPlainObject(childValue)) {
-            out[key] = { ...baseValue, ...childValue };
+            out[key] = {
+                ...baseValue,
+                ...childValue,
+            };
             continue;
         }
         out[key] = childValue;

package/dist/metadata/merge.js.map

@@ -1 +1 @@
-{"version":3,"file":"merge.js","sourceRoot":"","sources":["../../src/metadata/merge.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,IAAa,EAAE,KAAc;IACrD,MAAM,GAAG,GAAY,EAAE,GAAG,IAAI,EAAE,CAAC;IAEjC,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3B,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QAE9B,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YAC1D,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,SAAS,EAAE,GAAG,UAAU,CAAC,CAAC;YACzC,SAAS;QACX,CAAC;QAED,IAAI,aAAa,CAAC,SAAS,CAAC,IAAI,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;YAC1D,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAI,SAAoB,EAAE,GAAI,UAAqB,EAAS,CAAC;YAC1E,SAAS;QACX,CAAC;QAED,GAAG,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;IACxB,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACvE,CAAC"}
+{"version":3,"file":"merge.js","sourceRoot":"","sources":["../../src/metadata/merge.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,IAAa,EAAE,KAAc;IACrD,MAAM,GAAG,GAAY,EAAE,GAAG,IAAI,EAAE,CAAC;IAEjC,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3B,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QAE9B,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YAC1D,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,SAAS,EAAE,GAAG,UAAU,CAAC,CAAC;YACzC,SAAS;QACX,CAAC;QAED,IAAI,aAAa,CAAC,SAAS,CAAC,IAAI,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;YAC1D,GAAG,CAAC,GAAG,CAAC,GAAG;gBACT,GAAI,SAA0C;gBAC9C,GAAI,UAA2C;aAChD,CAAC;YACF,SAAS;QACX,CAAC;QAED,GAAG,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;IACxB,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACvE,CAAC"}

package/dist/validation/native/schema.d.ts

@@ -6,11 +6,11 @@ export type Schema<T> = {
     readonly name?: string;
     parse(value: unknown, path?: Array<string | number>): ValidationResult<T>;
 };
-export type Infer<S extends Schema<any>> = S extends Schema<infer T> ? T : never;
+export type Infer<S extends Schema<unknown>> = S extends Schema<infer T> ? T : never;
 export declare function optional<T>(inner: Schema<T>): Schema<T | undefined>;
 declare function literalBase<T extends string | number | boolean | null>(lit: T): Schema<T>;
 declare function enumBase<T extends readonly string[]>(values: T): Schema<T[number]>;
-type ObjectShape = Record<string, Schema<any>>;
+type ObjectShape = Record<string, Schema<unknown>>;
 type StringBuilder = Schema<string> & {
     min(n: number): StringBuilder;
     max(n: number): StringBuilder;

package/dist/validation/native/schema.d.ts.map

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

package/dist/validation/native/validator.d.ts

@@ -1,6 +1,6 @@
 import type { Validator, ValidationResult } from '../../contracts/validator.js';
 import type { Schema } from './schema.js';
-type SchemaMap = Record<string, Schema<any>>;
+type SchemaMap = Record<string, Schema<unknown>>;
 export declare class NativeValidator implements Validator {
     private readonly bodies;
     private readonly queries;

package/dist/validation/native/validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/validation/native/validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AAE7C,qBAAa,eAAgB,YAAW,SAAS;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAY;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;gBAEvB,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,SAAS,CAAC;QAAC,KAAK,CAAC,EAAE,SAAS,CAAC;QAAC,MAAM,CAAC,EAAE,SAAS,CAAA;KAAE;IAM9E,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC;IAM/E,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC;IAMjF,cAAc,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC;IAMnF,UAAU,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC;IAM3D,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC;IAM7D,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC;CAKhE"}
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/validation/native/validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;AAEjD,qBAAa,eAAgB,YAAW,SAAS;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAY;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;gBAEvB,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,SAAS,CAAC;QAAC,KAAK,CAAC,EAAE,SAAS,CAAC;QAAC,MAAM,CAAC,EAAE,SAAS,CAAA;KAAE;IAM9E,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC;IAM/E,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC;IAMjF,cAAc,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC;IAMnF,UAAU,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC;IAM3D,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC;IAM7D,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC;CAKhE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "adorn-api",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Stage-3 decorator router + OpenAPI, with optional MetalORM integration",
   "license": "MIT",
   "type": "module",
@@ -35,6 +35,9 @@
     "@types/express": "^5.0.6",
     "@types/node": "^25.0.3",
     "@types/supertest": "^6.0.3",
+    "@typescript-eslint/eslint-plugin": "^8.50.1",
+    "@typescript-eslint/parser": "^8.50.1",
+    "eslint": "^9.39.2",
     "sqlite3": "^5.1.7",
     "supertest": "^7.1.4",
     "typescript": "^5.9.3",
@@ -43,7 +46,8 @@
   "scripts": {
     "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
     "build": "npm run clean && tsc -p tsconfig.build.json",
-    "check": "npm run typecheck && npm run check:decorated-returns && npm run test",
+    "check": "npm run lint && npm run typecheck && npm run check:decorated-returns && npm run test",
+    "lint": "eslint src test --ext .ts",
     "check:decorated-returns": "node scripts/check-decorated-returns.js",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "vitest run",