adorn-api 1.0.4 → 1.0.5

package/dist/core/binding/binder.js

@@ -1,161 +0,0 @@
-import { HttpError } from '../errors/http-error.js';
-import { getPathTokenNames } from './rules/inferFromPath.js';
-import { conventionForMethod } from './rules/inferFromHttpMethod.js';
-import { coerceObjectSmart, coerceValueSmart } from './coerce/arrays.js';
-/**
- * Binds request data to handler function arguments based on route configuration.
- *
- * This function automatically maps path parameters, query parameters, and request body
- * to the handler function arguments based on the route's binding configuration and
- * HTTP method conventions.
- *
- * @param route - The route entry containing metadata about the handler
- * @param handler - The handler function to bind arguments for
- * @param ctx - The request context containing params, query, and body
- * @param opts - Binding options to control behavior
- * @returns Object containing args to pass to handler and prepared binding data
- *
- * @example
- * ```typescript
- * // For a route like: @Get('/users/:id')
- * // With handler: async getUser(id: string, ctx: RequestContext)
- * const { args } = bindArgs(route, handler, requestContext);
- * const result = await handler(...args); // Automatically passes id and ctx
- * ```
- *
- * @example
- * ```typescript
- * // For a POST route with body
- * // @Post('/users')
- * // async createUser(userData: CreateUserDto)
- * const { args } = bindArgs(route, handler, requestContext);
- * const result = await handler(...args); // Automatically passes parsed body
- * ```
- *
- * @see RouteEntry for route metadata structure
- * @see RequestContext for request data structure
- */
-export function bindArgs(route, handler, ctx, opts = {}) {
-    const passContext = opts.passContext ?? true;
-    const coerceMode = opts.coerce ?? 'smart';
-    const csv = opts.csv ?? true;
-    const tokenNames = getPathTokenNames(route.fullPath);
-    const methodBindings = route.bindings?.byMethod?.[route.handlerName];
-    const pathTypes = methodBindings?.path ?? {};
-    const rawParams = ctx.params ?? {};
-    const preparedParams = {};
-    const pathArgs = tokenNames.map((t) => {
-        const raw = rawParams[t];
-        const hint = pathTypes[t];
-        const value = coercePathValue(raw, hint, t);
-        preparedParams[t] = value;
-        return value;
-    });
-    for (const [key, value] of Object.entries(rawParams)) {
-        if (!(key in preparedParams)) {
-            preparedParams[key] = value;
-        }
-    }
-    const conv = conventionForMethod(route.method);
-    const expected = typeof handler.length === 'number' ? handler.length : pathArgs.length;
-    const args = [...pathArgs];
-    const remainingSlots = Math.max(0, expected - args.length);
-    const preparedQuery = coerceMode === 'smart'
-        ? coerceObjectSmart(normalizeQuery(ctx.query), { csv })
-        : normalizeQuery(ctx.query);
-    const preparedBody = coerceMode === 'smart'
-        ? coerceValueSmart(ctx.body, { csv })
-        : ctx.body;
-    if (remainingSlots > 0) {
-        const payloads = [];
-        if (conv.primary === 'query')
-            payloads.push(preparedQuery);
-        else if (conv.primary === 'body')
-            payloads.push(preparedBody);
-        if (conv.secondary === 'query')
-            payloads.push(preparedQuery);
-        else if (conv.secondary === 'body')
-            payloads.push(preparedBody);
-        for (let i = 0; i < Math.min(remainingSlots, payloads.length); i++) {
-            args.push(payloads[i]);
-        }
-    }
-    if (passContext && args.length < expected) {
-        args.push(ctx);
-    }
-    return {
-        args,
-        prepared: {
-            params: preparedParams,
-            query: preparedQuery,
-            body: preparedBody,
-        },
-    };
-}
-function normalizeQuery(q) {
-    if (!q || typeof q !== 'object')
-        return {};
-    const out = {};
-    for (const [k, v] of Object.entries(q)) {
-        out[k] = v;
-    }
-    return out;
-}
-function coercePathValue(raw, hint, paramName) {
-    if (raw === undefined)
-        return undefined;
-    switch (hint) {
-        case 'string':
-            return raw;
-        case 'boolean': {
-            const s = raw.trim().toLowerCase();
-            if (s === 'true')
-                return true;
-            if (s === 'false')
-                return false;
-            throw new HttpError(400, `Invalid boolean for path param "${paramName ?? '?'}"`, {
-                code: 'INVALID_PATH_PARAM',
-                details: { param: paramName, expected: 'boolean', got: raw },
-            });
-        }
-        case 'int': {
-            if (!/^-?\d+$/.test(raw)) {
-                throw new HttpError(400, `Invalid int for path param "${paramName ?? '?'}"`, {
-                    code: 'INVALID_PATH_PARAM',
-                    details: { param: paramName, expected: 'int', got: raw },
-                });
-            }
-            const n = Number(raw);
-            if (!Number.isSafeInteger(n)) {
-                throw new HttpError(400, `Unsafe int for path param "${paramName ?? '?'}"`, {
-                    code: 'INVALID_PATH_PARAM',
-                    details: { param: paramName, expected: 'int(safe)', got: raw },
-                });
-            }
-            return n;
-        }
-        case 'number': {
-            const n = Number(raw);
-            if (!Number.isFinite(n)) {
-                throw new HttpError(400, `Invalid number for path param "${paramName ?? '?'}"`, {
-                    code: 'INVALID_PATH_PARAM',
-                    details: { param: paramName, expected: 'number', got: raw },
-                });
-            }
-            return n;
-        }
-        case 'uuid': {
-            const ok = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(raw);
-            if (!ok) {
-                throw new HttpError(400, `Invalid uuid for path param "${paramName ?? '?'}"`, {
-                    code: 'INVALID_PATH_PARAM',
-                    details: { param: paramName, expected: 'uuid', got: raw },
-                });
-            }
-            return raw;
-        }
-        default:
-            return raw;
-    }
-}
-//# sourceMappingURL=binder.js.map

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

@@ -1 +0,0 @@
-{"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/arrays.d.ts

@@ -1,7 +0,0 @@
-export type ArrayCoerceOptions = {
-    csv?: boolean;
-};
-export declare function coerceArraySmart(arr: unknown[], opts: ArrayCoerceOptions): unknown[];
-export declare function coerceValueSmart(v: unknown, opts: ArrayCoerceOptions): unknown;
-export declare function coerceObjectSmart(obj: Record<string, unknown>, opts: ArrayCoerceOptions): Record<string, unknown>;
-//# sourceMappingURL=arrays.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"arrays.d.ts","sourceRoot":"","sources":["../../../../src/core/binding/coerce/arrays.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,CAAC,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,EAAE,CAYpF;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAI9E;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIjH"}

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

@@ -1,28 +0,0 @@
-import { coercePrimitiveSmart } from './primitives.js';
-import { splitCsv } from './csv.js';
-export function coerceArraySmart(arr, opts) {
-    const out = [];
-    for (const item of arr) {
-        if (typeof item === 'string' && opts.csv && item.includes(',')) {
-            for (const part of splitCsv(item))
-                out.push(coercePrimitiveSmart(part));
-            continue;
-        }
-        out.push(coerceValueSmart(item, opts));
-    }
-    return out;
-}
-export function coerceValueSmart(v, opts) {
-    if (Array.isArray(v))
-        return coerceArraySmart(v, opts);
-    if (v && typeof v === 'object')
-        return coerceObjectSmart(v, opts);
-    return coercePrimitiveSmart(v);
-}
-export function coerceObjectSmart(obj, opts) {
-    const out = {};
-    for (const [k, v] of Object.entries(obj))
-        out[k] = coerceValueSmart(v, opts);
-    return out;
-}
-//# sourceMappingURL=arrays.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"arrays.js","sourceRoot":"","sources":["../../../../src/core/binding/coerce/arrays.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAMpC,MAAM,UAAU,gBAAgB,CAAC,GAAc,EAAE,IAAwB;IACvE,MAAM,GAAG,GAAc,EAAE,CAAC;IAE1B,KAAK,MAAM,IAAI,IAAI,GAAG,EAAE,CAAC;QACvB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/D,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC;gBAAE,GAAG,CAAC,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC;YACxE,SAAS;QACX,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,CAAU,EAAE,IAAwB;IACnE,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAAE,OAAO,gBAAgB,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACvD,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,iBAAiB,CAAC,CAA4B,EAAE,IAAI,CAAC,CAAC;IAC7F,OAAO,oBAAoB,CAAC,CAAC,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAA4B,EAAE,IAAwB;IACtF,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,GAAG,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAC7E,OAAO,GAAG,CAAC;AACb,CAAC"}

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

@@ -1,2 +0,0 @@
-export declare function splitCsv(s: string): string[];
-//# sourceMappingURL=csv.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"csv.d.ts","sourceRoot":"","sources":["../../../../src/core/binding/coerce/csv.ts"],"names":[],"mappings":"AAAA,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAK5C"}

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

@@ -1,7 +0,0 @@
-export function splitCsv(s) {
-    return s
-        .split(',')
-        .map((x) => x.trim())
-        .filter((x) => x.length > 0);
-}
-//# sourceMappingURL=csv.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"csv.js","sourceRoot":"","sources":["../../../../src/core/binding/coerce/csv.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,QAAQ,CAAC,CAAS;IAChC,OAAO,CAAC;SACL,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACjC,CAAC"}

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

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=objects.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"objects.d.ts","sourceRoot":"","sources":["../../../../src/core/binding/coerce/objects.ts"],"names":[],"mappings":""}

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

@@ -1,3 +0,0 @@
-export {};
-// placeholder for src\core\binding\coerce\objects.ts
-//# sourceMappingURL=objects.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"objects.js","sourceRoot":"","sources":["../../../../src/core/binding/coerce/objects.ts"],"names":[],"mappings":";AAAA,qDAAqD"}

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

@@ -1,70 +0,0 @@
-/**
- * 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';
-/**
- * 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 +0,0 @@
-{"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,88 +0,0 @@
-/**
- * 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 (trimmed === 'true')
-        return true;
-    if (trimmed === 'false')
-        return false;
-    // 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 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 +0,0 @@
-{"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/binding/index.d.ts

@@ -1,2 +0,0 @@
-export * from './binder.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/core/binding/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/binding/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/dist/core/binding/index.js

@@ -1,2 +0,0 @@
-export * from './binder.js';
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/binding/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/dist/core/binding/rules/inferFromHttpMethod.d.ts

@@ -1,6 +0,0 @@
-export type PayloadConvention = {
-    primary: 'query' | 'body' | 'none';
-    secondary: 'query' | 'body' | 'none';
-};
-export declare function conventionForMethod(method: string): PayloadConvention;
-//# sourceMappingURL=inferFromHttpMethod.d.ts.map

package/dist/core/binding/rules/inferFromHttpMethod.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"inferFromHttpMethod.d.ts","sourceRoot":"","sources":["../../../../src/core/binding/rules/inferFromHttpMethod.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IACnC,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;CACtC,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAYrE"}

package/dist/core/binding/rules/inferFromHttpMethod.js

@@ -1,11 +0,0 @@
-export function conventionForMethod(method) {
-    const m = method.toUpperCase();
-    if (m === 'GET' || m === 'DELETE') {
-        return { primary: 'query', secondary: 'none' };
-    }
-    if (m === 'POST' || m === 'PUT' || m === 'PATCH') {
-        return { primary: 'body', secondary: 'query' };
-    }
-    return { primary: 'none', secondary: 'none' };
-}
-//# sourceMappingURL=inferFromHttpMethod.js.map

package/dist/core/binding/rules/inferFromHttpMethod.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"inferFromHttpMethod.js","sourceRoot":"","sources":["../../../../src/core/binding/rules/inferFromHttpMethod.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,MAAM,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IAE/B,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;QAClC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IACjD,CAAC;IAED,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;QACjD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;IACjD,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;AAChD,CAAC"}

package/dist/core/binding/rules/inferFromPath.d.ts

@@ -1,2 +0,0 @@
-export declare function getPathTokenNames(template: string): string[];
-//# sourceMappingURL=inferFromPath.d.ts.map

package/dist/core/binding/rules/inferFromPath.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"inferFromPath.d.ts","sourceRoot":"","sources":["../../../../src/core/binding/rules/inferFromPath.ts"],"names":[],"mappings":"AAAA,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAM5D"}

package/dist/core/binding/rules/inferFromPath.js

@@ -1,9 +0,0 @@
-export function getPathTokenNames(template) {
-    const out = [];
-    const re = /\{([^}]+)\}/g;
-    let m;
-    while ((m = re.exec(template)))
-        out.push(String(m[1]));
-    return out;
-}
-//# sourceMappingURL=inferFromPath.js.map

package/dist/core/binding/rules/inferFromPath.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"inferFromPath.js","sourceRoot":"","sources":["../../../../src/core/binding/rules/inferFromPath.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,EAAE,GAAG,cAAc,CAAC;IAC1B,IAAI,CAAyB,CAAC;IAC9B,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/core/binding/rules/wrappers.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=wrappers.d.ts.map

package/dist/core/binding/rules/wrappers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"wrappers.d.ts","sourceRoot":"","sources":["../../../../src/core/binding/rules/wrappers.ts"],"names":[],"mappings":""}

package/dist/core/binding/rules/wrappers.js

@@ -1,3 +0,0 @@
-export {};
-// placeholder for src\core\binding\rules\wrappers.ts
-//# sourceMappingURL=wrappers.js.map

package/dist/core/binding/rules/wrappers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"wrappers.js","sourceRoot":"","sources":["../../../../src/core/binding/rules/wrappers.ts"],"names":[],"mappings":";AAAA,qDAAqD"}

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

@@ -1,63 +0,0 @@
-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 +0,0 @@
-{"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,71 +0,0 @@
-/**
- * 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';
-        this.status = status;
-        if (options.code !== undefined) {
-            this.code = options.code;
-        }
-        this.details = options.details;
-        this.expose = options.expose ?? (status >= 400 && status < 500);
-    }
-}
-//# sourceMappingURL=http-error.js.map

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

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