adorn-api 1.0.1 → 1.0.2

package/dist/core/binding/binder.js.map

@@ -1 +1 @@
-{"version":3,"file":"binder.js","sourceRoot":"","sources":["../../../src/core/binding/binder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"binder.js","sourceRoot":"","sources":["../../../src/core/binding/binder.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAErE,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAyCzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,UAAU,QAAQ,CACtB,KAAiB,EACjB,OAAwB,EACxB,GAAmB,EACnB,OAAoB,EAAE;IAEtB,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC;IAC7C,MAAM,UAAU,GAAe,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC;IACtD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC;IAE7B,MAAM,UAAU,GAAG,iBAAiB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACrD,MAAM,cAAc,GAAG,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACrE,MAAM,SAAS,GAAG,cAAc,EAAE,IAAI,IAAI,EAAE,CAAC;IAE7C,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC;IACnC,MAAM,cAAc,GAA4B,EAAE,CAAC;IAEnD,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACpC,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC1B,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC5C,cAAc,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACrD,IAAI,CAAC,CAAC,GAAG,IAAI,cAAc,CAAC,EAAE,CAAC;YAC7B,cAAc,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAE/C,MAAM,QAAQ,GAAG,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;IAEvF,MAAM,IAAI,GAAc,CAAC,GAAG,QAAQ,CAAC,CAAC;IAEtC,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAE3D,MAAM,aAAa,GAAG,UAAU,KAAK,OAAO;QAC1C,CAAC,CAAC,iBAAiB,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC;QACvD,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAE9B,MAAM,YAAY,GAAG,UAAU,KAAK,OAAO;QACzC,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC;QACrC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;IAEb,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAc,EAAE,CAAC;QAE7B,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO;YAAE,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;aACtD,IAAI,IAAI,CAAC,OAAO,KAAK,MAAM;YAAE,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAE9D,IAAI,IAAI,CAAC,SAAS,KAAK,OAAO;YAAE,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;aACxD,IAAI,IAAI,CAAC,SAAS,KAAK,MAAM;YAAE,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAElE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACnE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,IAAI,WAAW,IAAI,IAAI,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;QAC1C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjB,CAAC;IAED,OAAO;QACL,IAAI;QACJ,QAAQ,EAAE;YACR,MAAM,EAAE,cAAc;YACtB,KAAK,EAAE,aAAa;YACpB,IAAI,EAAE,YAAY;SACnB;KACF,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,CAA6C;IACnE,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IAC3C,MAAM,GAAG,GAA4B,EAAE,CAAC;IAExC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACvC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACb,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,eAAe,CACtB,GAAuB,EACvB,IAAuD,EACvD,SAAkB;IAElB,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAExC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,GAAG,CAAC;QAEb,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YACnC,IAAI,CAAC,KAAK,MAAM;gBAAE,OAAO,IAAI,CAAC;YAC9B,IAAI,CAAC,KAAK,OAAO;gBAAE,OAAO,KAAK,CAAC;YAChC,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,mCAAmC,SAAS,IAAI,GAAG,GAAG,EAAE;gBAC/E,IAAI,EAAE,oBAAoB;gBAC1B,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,EAAE;aAC7D,CAAC,CAAC;QACL,CAAC;QAED,KAAK,KAAK,CAAC,CAAC,CAAC;YACX,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBACzB,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,+BAA+B,SAAS,IAAI,GAAG,GAAG,EAAE;oBAC3E,IAAI,EAAE,oBAAoB;oBAC1B,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE;iBACzD,CAAC,CAAC;YACL,CAAC;YACD,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YACtB,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7B,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,8BAA8B,SAAS,IAAI,GAAG,GAAG,EAAE;oBAC1E,IAAI,EAAE,oBAAoB;oBAC1B,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,EAAE;iBAC/D,CAAC,CAAC;YACL,CAAC;YACD,OAAO,CAAC,CAAC;QACX,CAAC;QAED,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YACtB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxB,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,kCAAkC,SAAS,IAAI,GAAG,GAAG,EAAE;oBAC9E,IAAI,EAAE,oBAAoB;oBAC1B,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE;iBAC5D,CAAC,CAAC;YACL,CAAC;YACD,OAAO,CAAC,CAAC;QACX,CAAC;QAED,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,EAAE,GAAG,4EAA4E,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClG,IAAI,CAAC,EAAE,EAAE,CAAC;gBACR,MAAM,IAAI,SAAS,CAAC,GAAG,EAAE,gCAAgC,SAAS,IAAI,GAAG,GAAG,EAAE;oBAC5E,IAAI,EAAE,oBAAoB;oBAC1B,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE;iBAC1D,CAAC,CAAC;YACL,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC;QAED;YACE,OAAO,GAAG,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/core/binding/coerce/primitives.d.ts

@@ -1,3 +1,70 @@
+/**
+ * Coercion modes for automatic type conversion.
+ *
+ * Controls how primitive values are automatically converted
+ * during parameter binding.
+ *
+ * - `'none'` - No coercion; values remain as provided
+ * - `'smart'` - Intelligent type inference from string values
+ */
 export type CoerceMode = 'none' | 'smart';
-export declare function coercePrimitiveSmart(v: unknown): unknown;
+/**
+ * Smart coercion for primitive values.
+ *
+ * Automatically converts string values to appropriate primitive types:
+ *
+ * | Input                      | Output              |
+ * |----------------------------|---------------------|
+ * | `'null'`                   | `null`              |
+ * | `'true'` / `'false'`       | `boolean`           |
+ * | `'42'`, `'3.14'`, `'-10'`  | `number`            |
+ * | Other strings              | `string` (trimmed)  |
+ *
+ * @param value - Value to coerce
+ * @returns Coerced primitive value
+ *
+ * @remarks
+ * - Whitespace is trimmed before type detection
+ * - Non-string values pass through unchanged
+ * - Leading zeros preserve string type (`'007'` → `'007'`)
+ * - Special values (`Infinity`, `NaN`) are not coerced
+ *
+ * @example
+ * ```typescript
+ * // Boolean coercion
+ * coercePrimitiveSmart('true');   // → true
+ * coercePrimitiveSmart('false');  // → false
+ *
+ * // Numeric coercion
+ * coercePrimitiveSmart('42');     // → 42
+ * coercePrimitiveSmart('3.14');   // → 3.14
+ * coercePrimitiveSmart('-10');    // → -10
+ *
+ * // Null coercion
+ * coercePrimitiveSmart('null');   // → null
+ *
+ * // String handling
+ * coercePrimitiveSmart('  hello  '); // → 'hello'
+ * coercePrimitiveSmart('007');       // → '007' (preserved)
+ *
+ * // Non-string pass-through
+ * coercePrimitiveSmart(42);   // → 42
+ * coercePrimitiveSmart(null); // → null
+ * ```
+ */
+export declare function coercePrimitiveSmart(value: unknown): unknown;
+/**
+ * Coerce a value based on the specified mode.
+ *
+ * @param value - Value to coerce
+ * @param mode - Coercion mode to apply
+ * @returns Coerced value (or original if mode is 'none')
+ *
+ * @example
+ * ```typescript
+ * coercePrimitive('42', 'smart'); // → 42
+ * coercePrimitive('42', 'none');  // → '42'
+ * ```
+ */
+export declare function coercePrimitive(value: unknown, mode: CoerceMode): unknown;
 //# sourceMappingURL=primitives.d.ts.map

package/dist/core/binding/coerce/primitives.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../../../src/core/binding/coerce/primitives.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;AAE1C,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAexD"}
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../../../src/core/binding/coerce/primitives.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;AAS1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAqB5D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAEzE"}

package/dist/core/binding/coerce/primitives.js

@@ -1,18 +1,88 @@
-export function coercePrimitiveSmart(v) {
-    if (typeof v !== 'string')
-        return v;
-    const s = v.trim();
-    if (s === 'null')
+/**
+ * Pattern for valid numeric strings.
+ * Matches integers and decimals with optional negative sign.
+ * Rejects leading zeros to preserve string IDs (e.g., '007').
+ */
+const NUMERIC_RE = /^-?(?:0|[1-9]\d*)(?:\.\d+)?$/;
+/**
+ * Smart coercion for primitive values.
+ *
+ * Automatically converts string values to appropriate primitive types:
+ *
+ * | Input                      | Output              |
+ * |----------------------------|---------------------|
+ * | `'null'`                   | `null`              |
+ * | `'true'` / `'false'`       | `boolean`           |
+ * | `'42'`, `'3.14'`, `'-10'`  | `number`            |
+ * | Other strings              | `string` (trimmed)  |
+ *
+ * @param value - Value to coerce
+ * @returns Coerced primitive value
+ *
+ * @remarks
+ * - Whitespace is trimmed before type detection
+ * - Non-string values pass through unchanged
+ * - Leading zeros preserve string type (`'007'` → `'007'`)
+ * - Special values (`Infinity`, `NaN`) are not coerced
+ *
+ * @example
+ * ```typescript
+ * // Boolean coercion
+ * coercePrimitiveSmart('true');   // → true
+ * coercePrimitiveSmart('false');  // → false
+ *
+ * // Numeric coercion
+ * coercePrimitiveSmart('42');     // → 42
+ * coercePrimitiveSmart('3.14');   // → 3.14
+ * coercePrimitiveSmart('-10');    // → -10
+ *
+ * // Null coercion
+ * coercePrimitiveSmart('null');   // → null
+ *
+ * // String handling
+ * coercePrimitiveSmart('  hello  '); // → 'hello'
+ * coercePrimitiveSmart('007');       // → '007' (preserved)
+ *
+ * // Non-string pass-through
+ * coercePrimitiveSmart(42);   // → 42
+ * coercePrimitiveSmart(null); // → null
+ * ```
+ */
+export function coercePrimitiveSmart(value) {
+    if (typeof value !== 'string') {
+        return value;
+    }
+    const trimmed = value.trim();
+    // Special literal values
+    if (trimmed === 'null')
         return null;
-    if (s === 'true')
+    if (trimmed === 'true')
         return true;
-    if (s === 'false')
+    if (trimmed === 'false')
         return false;
-    if (s !== '' && /^-?\d+(\.\d+)?$/.test(s)) {
-        const n = Number(s);
-        if (Number.isFinite(n))
-            return n;
+    // Numeric conversion (excludes leading zeros and special values)
+    if (trimmed !== '' && NUMERIC_RE.test(trimmed)) {
+        const num = Number(trimmed);
+        if (Number.isFinite(num)) {
+            return num;
+        }
     }
-    return v;
+    return trimmed;
+}
+/**
+ * Coerce a value based on the specified mode.
+ *
+ * @param value - Value to coerce
+ * @param mode - Coercion mode to apply
+ * @returns Coerced value (or original if mode is 'none')
+ *
+ * @example
+ * ```typescript
+ * coercePrimitive('42', 'smart'); // → 42
+ * coercePrimitive('42', 'none');  // → '42'
+ * ```
+ */
+export function coercePrimitive(value, mode) {
+    return mode === 'smart' ? coercePrimitiveSmart(value) : value;
 }
 //# sourceMappingURL=primitives.js.map

package/dist/core/binding/coerce/primitives.js.map

@@ -1 +1 @@
-{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../../../../src/core/binding/coerce/primitives.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,oBAAoB,CAAC,CAAU;IAC7C,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC;IAEpC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAEnB,IAAI,CAAC,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IAC9B,IAAI,CAAC,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IAC9B,IAAI,CAAC,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IAEhC,IAAI,CAAC,KAAK,EAAE,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1C,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,CAAC,CAAC;AACX,CAAC"}
+{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../../../../src/core/binding/coerce/primitives.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,MAAM,UAAU,GAAG,8BAA8B,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAE7B,yBAAyB;IACzB,IAAI,OAAO,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACpC,IAAI,OAAO,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACpC,IAAI,OAAO,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IAEtC,iEAAiE;IACjE,IAAI,OAAO,KAAK,EAAE,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/C,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAC5B,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,OAAO,GAAG,CAAC;QACb,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc,EAAE,IAAgB;IAC9D,OAAO,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAChE,CAAC"}

package/dist/core/errors/http-error.d.ts

@@ -1,9 +1,63 @@
 import type { HttpErrorLike, HttpErrorOptions } from '../../contracts/errors.js';
+/**
+ * HTTP Error class for representing HTTP errors with status codes.
+ *
+ * This class extends the native Error class and implements HttpErrorLike interface.
+ * It's used throughout the framework to represent HTTP errors that should be
+ * returned to clients with appropriate status codes and error details.
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * throw new HttpError(404, 'User not found');
+ *
+ * // With error code and details
+ * throw new HttpError(400, 'Invalid input', {
+ *   code: 'INVALID_INPUT',
+ *   details: { field: 'email', reason: 'must be valid email' }
+ * });
+ *
+ * // For internal server errors (not exposed to client by default)
+ * throw new HttpError(500, 'Database connection failed', {
+ *   expose: false
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // In a controller
+ * @Get('/users/:id')
+ * async getUser(id: string) {
+ *   const user = await userService.findById(id);
+ *   if (!user) {
+ *     throw new HttpError(404, 'User not found', {
+ *       code: 'USER_NOT_FOUND',
+ *       details: { id }
+ *     });
+ *   }
+ *   return user;
+ * }
+ * ```
+ */
 export declare class HttpError extends Error implements HttpErrorLike {
+    /** HTTP status code (e.g., 404, 500) */
     readonly status: number;
+    /** Optional error code for programmatic handling */
     readonly code?: string;
+    /** Additional error details (can be any type) */
     readonly details?: unknown;
+    /** Whether to expose this error to clients */
     readonly expose: boolean;
+    /**
+     * Creates a new HttpError instance.
+     *
+     * @param status - HTTP status code
+     * @param message - Error message
+     * @param options - Additional error options
+     * @param options.code - Optional error code
+     * @param options.details - Additional error details
+     * @param options.expose - Whether to expose to clients (default: true for 4xx, false for 5xx)
+     */
     constructor(status: number, message: string, options?: HttpErrorOptions);
 }
 //# sourceMappingURL=http-error.d.ts.map

package/dist/core/errors/http-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-error.d.ts","sourceRoot":"","sources":["../../../src/core/errors/http-error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAEjF,qBAAa,SAAU,SAAQ,KAAM,YAAW,aAAa;IAC3D,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAgB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClC,SAAgB,MAAM,EAAE,OAAO,CAAC;gBAEpB,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB;CAU5E"}
+{"version":3,"file":"http-error.d.ts","sourceRoot":"","sources":["../../../src/core/errors/http-error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAEjF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,qBAAa,SAAU,SAAQ,KAAM,YAAW,aAAa;IAC3D,wCAAwC;IACxC,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,oDAAoD;IACpD,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAC9B,iDAAiD;IACjD,SAAgB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClC,8CAA8C;IAC9C,SAAgB,MAAM,EAAE,OAAO,CAAC;IAEhC;;;;;;;;;OASG;gBACS,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB;CAU5E"}

package/dist/core/errors/http-error.js

@@ -1,8 +1,62 @@
+/**
+ * HTTP Error class for representing HTTP errors with status codes.
+ *
+ * This class extends the native Error class and implements HttpErrorLike interface.
+ * It's used throughout the framework to represent HTTP errors that should be
+ * returned to clients with appropriate status codes and error details.
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * throw new HttpError(404, 'User not found');
+ *
+ * // With error code and details
+ * throw new HttpError(400, 'Invalid input', {
+ *   code: 'INVALID_INPUT',
+ *   details: { field: 'email', reason: 'must be valid email' }
+ * });
+ *
+ * // For internal server errors (not exposed to client by default)
+ * throw new HttpError(500, 'Database connection failed', {
+ *   expose: false
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // In a controller
+ * @Get('/users/:id')
+ * async getUser(id: string) {
+ *   const user = await userService.findById(id);
+ *   if (!user) {
+ *     throw new HttpError(404, 'User not found', {
+ *       code: 'USER_NOT_FOUND',
+ *       details: { id }
+ *     });
+ *   }
+ *   return user;
+ * }
+ * ```
+ */
 export class HttpError extends Error {
+    /** HTTP status code (e.g., 404, 500) */
     status;
+    /** Optional error code for programmatic handling */
     code;
+    /** Additional error details (can be any type) */
     details;
+    /** Whether to expose this error to clients */
     expose;
+    /**
+     * Creates a new HttpError instance.
+     *
+     * @param status - HTTP status code
+     * @param message - Error message
+     * @param options - Additional error options
+     * @param options.code - Optional error code
+     * @param options.details - Additional error details
+     * @param options.expose - Whether to expose to clients (default: true for 4xx, false for 5xx)
+     */
     constructor(status, message, options = {}) {
         super(message);
         this.name = 'HttpError';

package/dist/core/errors/http-error.js.map

@@ -1 +1 @@
-{"version":3,"file":"http-error.js","sourceRoot":"","sources":["../../../src/core/errors/http-error.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClB,MAAM,CAAS;IACf,IAAI,CAAU;IACd,OAAO,CAAW;IAClB,MAAM,CAAU;IAEhC,YAAY,MAAc,EAAE,OAAe,EAAE,UAA4B,EAAE;QACzE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC/B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAC3B,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG,CAAC,CAAC;IAClE,CAAC;CACF"}
+{"version":3,"file":"http-error.js","sourceRoot":"","sources":["../../../src/core/errors/http-error.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClC,wCAAwC;IACxB,MAAM,CAAS;IAC/B,oDAAoD;IACpC,IAAI,CAAU;IAC9B,iDAAiD;IACjC,OAAO,CAAW;IAClC,8CAA8C;IAC9B,MAAM,CAAU;IAEhC;;;;;;;;;OASG;IACH,YAAY,MAAc,EAAE,OAAe,EAAE,UAA4B,EAAE;QACzE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC/B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAC3B,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,MAAM,IAAI,GAAG,IAAI,MAAM,GAAG,GAAG,CAAC,CAAC;IAClE,CAAC;CACF"}

package/dist/core/errors/validation-error.d.ts

@@ -1,8 +1,73 @@
 import { HttpError } from './http-error.js';
 import type { ValidationIssue } from '../../contracts/validator.js';
+/**
+ * Validation Error class for representing validation failures.
+ *
+ * This class extends HttpError and is specifically used for validation errors.
+ * It includes an array of validation issues that provide detailed information
+ * about what validation failed and where.
+ *
+ * @example
+ * ```typescript
+ * // Manual creation
+ * const error = new ValidationError('Invalid user data', [
+ *   { path: ['body', 'email'], message: 'Email is required' },
+ *   { path: ['body', 'password'], message: 'Password must be at least 8 characters' }
+ * ]);
+ *
+ * throw error;
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Using the convenience method
+ * const issues = [
+ *   { path: ['query', 'limit'], message: 'Limit must be a number' },
+ *   { path: ['query', 'offset'], message: 'Offset must be a positive integer' }
+ * ];
+ *
+ * throw ValidationError.fromIssues(issues, 'Invalid query parameters');
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // In a controller with validation
+ * @Post('/users')
+ * async createUser(@Body() userData: CreateUserDto) {
+ *   const validationResult = await validator.validate(userData);
+ *
+ *   if (!validationResult.valid) {
+ *     throw ValidationError.fromIssues(validationResult.issues);
+ *   }
+ *
+ *   return await userService.create(userData);
+ * }
+ * ```
+ */
 export declare class ValidationError extends HttpError {
+    /** Array of validation issues with paths and messages */
     readonly issues: ValidationIssue[];
+    /**
+     * Creates a new ValidationError instance.
+     *
+     * @param message - Overall validation error message
+     * @param issues - Array of validation issues
+     */
     constructor(message: string, issues: ValidationIssue[]);
+    /**
+     * Convenience method to create a ValidationError from issues.
+     *
+     * @param issues - Array of validation issues
+     * @param message - Optional custom message (default: 'Validation failed')
+     * @returns New ValidationError instance
+     *
+     * @example
+     * ```typescript
+     * const error = ValidationError.fromIssues([
+     *   { path: ['body', 'email'], message: 'Invalid email format' }
+     * ]);
+     * ```
+     */
     static fromIssues(issues: ValidationIssue[], message?: string): ValidationError;
 }
 //# sourceMappingURL=validation-error.d.ts.map

package/dist/core/errors/validation-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation-error.d.ts","sourceRoot":"","sources":["../../../src/core/errors/validation-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,qBAAa,eAAgB,SAAQ,SAAS;IAC5C,SAAgB,MAAM,EAAE,eAAe,EAAE,CAAC;gBAE9B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE;IAUtD,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,eAAe,EAAE,EAAE,OAAO,SAAsB,GAAG,eAAe;CAG7F"}
+{"version":3,"file":"validation-error.d.ts","sourceRoot":"","sources":["../../../src/core/errors/validation-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,qBAAa,eAAgB,SAAQ,SAAS;IAC5C,yDAAyD;IACzD,SAAgB,MAAM,EAAE,eAAe,EAAE,CAAC;IAE1C;;;;;OAKG;gBACS,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE;IAUtD;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,eAAe,EAAE,EAAE,OAAO,SAAsB,GAAG,eAAe;CAG7F"}

package/dist/core/errors/validation-error.js

@@ -1,6 +1,57 @@
 import { HttpError } from './http-error.js';
+/**
+ * Validation Error class for representing validation failures.
+ *
+ * This class extends HttpError and is specifically used for validation errors.
+ * It includes an array of validation issues that provide detailed information
+ * about what validation failed and where.
+ *
+ * @example
+ * ```typescript
+ * // Manual creation
+ * const error = new ValidationError('Invalid user data', [
+ *   { path: ['body', 'email'], message: 'Email is required' },
+ *   { path: ['body', 'password'], message: 'Password must be at least 8 characters' }
+ * ]);
+ *
+ * throw error;
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Using the convenience method
+ * const issues = [
+ *   { path: ['query', 'limit'], message: 'Limit must be a number' },
+ *   { path: ['query', 'offset'], message: 'Offset must be a positive integer' }
+ * ];
+ *
+ * throw ValidationError.fromIssues(issues, 'Invalid query parameters');
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // In a controller with validation
+ * @Post('/users')
+ * async createUser(@Body() userData: CreateUserDto) {
+ *   const validationResult = await validator.validate(userData);
+ *
+ *   if (!validationResult.valid) {
+ *     throw ValidationError.fromIssues(validationResult.issues);
+ *   }
+ *
+ *   return await userService.create(userData);
+ * }
+ * ```
+ */
 export class ValidationError extends HttpError {
+    /** Array of validation issues with paths and messages */
     issues;
+    /**
+     * Creates a new ValidationError instance.
+     *
+     * @param message - Overall validation error message
+     * @param issues - Array of validation issues
+     */
     constructor(message, issues) {
         super(400, message, {
             code: 'VALIDATION_ERROR',
@@ -10,6 +61,20 @@ export class ValidationError extends HttpError {
         this.name = 'ValidationError';
         this.issues = issues;
     }
+    /**
+     * Convenience method to create a ValidationError from issues.
+     *
+     * @param issues - Array of validation issues
+     * @param message - Optional custom message (default: 'Validation failed')
+     * @returns New ValidationError instance
+     *
+     * @example
+     * ```typescript
+     * const error = ValidationError.fromIssues([
+     *   { path: ['body', 'email'], message: 'Invalid email format' }
+     * ]);
+     * ```
+     */
     static fromIssues(issues, message = 'Validation failed') {
         return new ValidationError(message, issues);
     }

package/dist/core/errors/validation-error.js.map

@@ -1 +1 @@
-{"version":3,"file":"validation-error.js","sourceRoot":"","sources":["../../../src/core/errors/validation-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAC5B,MAAM,CAAoB;IAE1C,YAAY,OAAe,EAAE,MAAyB;QACpD,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE;YAClB,IAAI,EAAE,kBAAkB;YACxB,OAAO,EAAE,EAAE,MAAM,EAAE;YACnB,MAAM,EAAE,IAAI;SACb,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,MAAyB,EAAE,OAAO,GAAG,mBAAmB;QACxE,OAAO,IAAI,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC9C,CAAC;CACF"}
+{"version":3,"file":"validation-error.js","sourceRoot":"","sources":["../../../src/core/errors/validation-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAC5C,yDAAyD;IACzC,MAAM,CAAoB;IAE1C;;;;;OAKG;IACH,YAAY,OAAe,EAAE,MAAyB;QACpD,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE;YAClB,IAAI,EAAE,kBAAkB;YACxB,OAAO,EAAE,EAAE,MAAM,EAAE;YACnB,MAAM,EAAE,IAAI;SACb,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,UAAU,CAAC,MAAyB,EAAE,OAAO,GAAG,mBAAmB;QACxE,OAAO,IAAI,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC9C,CAAC;CACF"}

package/dist/core/openapi/buildOpenApi.d.ts

@@ -1,14 +1,79 @@
 import type { OpenApiDocument } from '../../contracts/openapi-v3.js';
 import type { Registry } from '../registry/types.js';
+/**
+ * Options for building OpenAPI documentation.
+ *
+ * These options configure the basic metadata and behavior of the generated
+ * OpenAPI specification.
+ */
 export type OpenApiBuildOptions = {
+    /** Title of the API */
     title: string;
+    /** Version of the API */
     version: string;
+    /** Array of server objects with URLs and descriptions */
     servers?: {
         url: string;
         description?: string;
     }[];
+    /** Default content type for request bodies */
     defaultRequestContentType?: string;
+    /** Default content type for response bodies */
     defaultResponseContentType?: string;
 };
+/**
+ * Builds a complete OpenAPI 3.0.3 specification document from the route registry.
+ *
+ * This function generates a comprehensive OpenAPI specification by analyzing
+ * the route registry and extracting all necessary information including paths,
+ * operations, parameters, request/response bodies, and security schemes.
+ *
+ * @param registry - Route registry containing all registered routes and metadata
+ * @param opts - OpenAPI build options including title, version, and servers
+ * @returns Complete OpenAPI 3.0.3 document ready for serving or serialization
+ *
+ * @example
+ * ```typescript
+ * import { buildRegistry } from './registry';
+ * import { buildOpenApi } from './openapi';
+ *
+ * // Build route registry from controllers
+ * const registry = buildRegistry([UserController, ProductController]);
+ *
+ * // Generate OpenAPI specification
+ * const openApiDoc = buildOpenApi(registry, {
+ *   title: 'My API',
+ *   version: '1.0.0',
+ *   servers: [
+ *     { url: 'https://api.example.com/v1', description: 'Production server' },
+ *     { url: 'https://staging.api.example.com/v1', description: 'Staging server' }
+ *   ],
+ *   defaultRequestContentType: 'application/json',
+ *   defaultResponseContentType: 'application/json'
+ * });
+ *
+ * // Serve the OpenAPI JSON
+ * app.get('/openapi.json', (req, res) => {
+ *   res.json(openApiDoc);
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With custom content types
+ * const openApiDoc = buildOpenApi(registry, {
+ *   title: 'Multi-format API',
+ *   version: '2.0.0',
+ *   defaultRequestContentType: 'application/json',
+ *   defaultResponseContentType: 'application/problem+json'
+ * });
+ *
+ * // The generated spec will use application/problem+json for error responses
+ * // and application/json for successful responses by default
+ * ```
+ *
+ * @see Registry for route registry structure
+ * @see OpenApiDocument for the returned document structure
+ */
 export declare function buildOpenApi(registry: Registry, opts: OpenApiBuildOptions): OpenApiDocument;
 //# sourceMappingURL=buildOpenApi.d.ts.map

package/dist/core/openapi/buildOpenApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildOpenApi.d.ts","sourceRoot":"","sources":["../../../src/core/openapi/buildOpenApi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAKhB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,QAAQ,EAAc,MAAM,sBAAsB,CAAC;AASjE,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAClD,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,0BAA0B,CAAC,EAAE,MAAM,CAAC;CACrC,CAAC;AAEF,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,mBAAmB,GAAG,eAAe,CA4C3F"}
+{"version":3,"file":"buildOpenApi.d.ts","sourceRoot":"","sources":["../../../src/core/openapi/buildOpenApi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAMhB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,QAAQ,EAAc,MAAM,sBAAsB,CAAC;AASjE;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,OAAO,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAClD,8CAA8C;IAC9C,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,+CAA+C;IAC/C,0BAA0B,CAAC,EAAE,MAAM,CAAC;CACrC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,mBAAmB,GAAG,eAAe,CAoD3F"}