express-model-binding 1.0.0

package/dist/adapters/TypeORMAdapter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/errors/index.ts","../../src/core/BaseAdapter.ts","../../src/utils/validators.ts","../../src/adapters/TypeORMAdapter.ts"],"sourcesContent":["/**\n * Base error class for model binding errors\n */\nexport class BindingError extends Error {\n  public readonly originalError?: Error;\n\n  constructor(message: string, originalError?: Error) {\n    super(message);\n    this.name = 'BindingError';\n    this.originalError = originalError;\n    Error.captureStackTrace(this, this.constructor);\n  }\n\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      message: this.message,\n      originalError: this.originalError?.message,\n    };\n  }\n}\n\n/**\n * Error thrown when a model is not found (404)\n */\nexport class ModelNotFoundError extends Error {\n  public readonly statusCode = 404;\n  public readonly paramName: string;\n  public readonly paramValue: string;\n  public readonly modelName: string;\n\n  constructor(paramName: string, paramValue: string, modelName: string, customMessage?: string) {\n    super(customMessage || `${modelName} not found with ${paramName} = ${paramValue}`);\n    this.name = 'ModelNotFoundError';\n    this.paramName = paramName;\n    this.paramValue = paramValue;\n    this.modelName = modelName;\n    Error.captureStackTrace(this, this.constructor);\n  }\n\n  toJSON(): Record<string, unknown> {\n    return {\n      error: 'Not Found',\n      message: this.message,\n      statusCode: this.statusCode,\n      param: this.paramName,\n      value: this.paramValue,\n      model: this.modelName,\n    };\n  }\n}\n\n/**\n * Error thrown when no adapter is configured\n */\nexport class AdapterNotSetError extends Error {\n  constructor(\n    message: string = 'No adapter set. Call ModelBinder.setAdapter() before using model binding.'\n  ) {\n    super(message);\n    this.name = 'AdapterNotSetError';\n    Error.captureStackTrace(this, this.constructor);\n  }\n\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      message: this.message,\n    };\n  }\n}\n\n/**\n * Error thrown when a model is invalid for an adapter\n */\nexport class InvalidModelError extends Error {\n  public readonly model: unknown;\n\n  constructor(message: string, model: unknown) {\n    super(message);\n    this.name = 'InvalidModelError';\n    this.model = model;\n    Error.captureStackTrace(this, this.constructor);\n  }\n\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      message: this.message,\n      model: typeof this.model === 'string' ? this.model : String(this.model),\n    };\n  }\n}\n\n/**\n * Error thrown when validation fails\n */\nexport class ValidationError extends Error {\n  public readonly statusCode: number;\n  public readonly details?: unknown;\n\n  constructor(message: string, statusCode: number = 400, details?: unknown) {\n    super(message);\n    this.name = 'ValidationError';\n    this.statusCode = statusCode;\n    this.details = details;\n    Error.captureStackTrace(this, this.constructor);\n  }\n\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      message: this.message,\n      statusCode: this.statusCode,\n      details: this.details,\n    };\n  }\n}\n","import { IORMAdapter, QueryOptions, ModelMetadata, QueryModifier } from './types';\nimport { InvalidModelError } from '../errors';\n\n/**\n * Abstract base class providing common adapter functionality.\n * Extend this class to implement ORM-specific adapters.\n *\n * @typeParam TModel - Model type accepted by this adapter\n * @typeParam TResult - Result type returned by queries\n * @typeParam TQueryBuilder - ORM-specific query builder type\n */\nexport abstract class BaseAdapter<\n  TModel = unknown,\n  TResult = unknown,\n  TQueryBuilder = unknown,\n> implements IORMAdapter<TModel, TResult> {\n  abstract readonly name: string;\n\n  abstract findByKey(\n    model: TModel,\n    key: string,\n    value: unknown,\n    options?: QueryOptions\n  ): Promise<TResult | null>;\n\n  abstract getPrimaryKeyName(model: TModel): string;\n\n  abstract isValidModel(model: unknown): model is TModel;\n\n  transformValue(_model: TModel, _key: string, value: string): unknown {\n    if (/^\\d+$/.test(value)) {\n      const num = parseInt(value, 10);\n      if (!isNaN(num) && Number.isSafeInteger(num)) {\n        return num;\n      }\n    }\n    return value;\n  }\n\n  supportsSoftDeletes(_model: TModel): boolean {\n    return false;\n  }\n\n  getModelMetadata(model: TModel): ModelMetadata {\n    return {\n      name: this.getModelName(model),\n      primaryKey: this.getPrimaryKeyName(model),\n      softDeletes: this.supportsSoftDeletes(model),\n      adapter: this.name,\n    };\n  }\n\n  protected validateModel(model: unknown): asserts model is TModel {\n    if (!this.isValidModel(model)) {\n      throw new InvalidModelError(`Invalid model for ${this.name} adapter`, model);\n    }\n  }\n\n  protected getModelName(model: TModel): string {\n    if (typeof model === 'string') {\n      return model;\n    }\n    if (model && typeof model === 'object') {\n      const obj = model as Record<string, unknown>;\n      if (typeof obj.name === 'string') return obj.name;\n      if (typeof obj.modelName === 'string') return obj.modelName;\n      if (typeof obj.tableName === 'string') return obj.tableName;\n    }\n    if (model && typeof model === 'function') {\n      return (model as { name: string }).name || 'Unknown';\n    }\n    return 'Unknown';\n  }\n\n  protected applySoftDeleteFilter(\n    queryBuilder: TQueryBuilder,\n    _options?: QueryOptions\n  ): TQueryBuilder {\n    return queryBuilder;\n  }\n\n  protected applyIncludes(\n    queryBuilder: TQueryBuilder,\n    _includes?: string[] | Record<string, unknown>\n  ): TQueryBuilder {\n    return queryBuilder;\n  }\n\n  protected applySelect(queryBuilder: TQueryBuilder, _select?: string[]): TQueryBuilder {\n    return queryBuilder;\n  }\n\n  protected applyWhereConditions(\n    queryBuilder: TQueryBuilder,\n    _where?: Record<string, unknown>\n  ): TQueryBuilder {\n    return queryBuilder;\n  }\n\n  protected applyCustomQuery(\n    queryBuilder: TQueryBuilder,\n    queryFn?: QueryModifier<TQueryBuilder>\n  ): TQueryBuilder {\n    if (queryFn) {\n      return queryFn(queryBuilder) as TQueryBuilder;\n    }\n    return queryBuilder;\n  }\n}\n","/**\n * UUID regex pattern\n */\nconst UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\n\n/**\n * MongoDB ObjectId regex pattern (24 hex characters)\n */\nconst OBJECT_ID_REGEX = /^[0-9a-f]{24}$/i;\n\n/**\n * Check if a value is a valid UUID\n */\nexport function isUUID(value: string): boolean {\n  return UUID_REGEX.test(value);\n}\n\n/**\n * Check if a value is a valid MongoDB ObjectId\n */\nexport function isObjectId(value: string): boolean {\n  return OBJECT_ID_REGEX.test(value);\n}\n\n/**\n * Check if a value is a numeric string\n */\nexport function isNumeric(value: string): boolean {\n  return /^-?\\d+$/.test(value);\n}\n\n/**\n * Check if a value is a valid positive integer\n */\nexport function isPositiveInteger(value: string): boolean {\n  return /^\\d+$/.test(value) && parseInt(value, 10) > 0;\n}\n\n/**\n * Check if a value is a valid slug (lowercase alphanumeric with hyphens)\n */\nexport function isSlug(value: string): boolean {\n  return /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(value);\n}\n\n/**\n * Check if a value is a valid email\n */\nexport function isEmail(value: string): boolean {\n  return /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(value);\n}\n\n/**\n * Validate that a value is not empty\n */\nexport function isNotEmpty(value: unknown): boolean {\n  if (value === null || value === undefined) {\n    return false;\n  }\n  if (typeof value === 'string') {\n    return value.trim().length > 0;\n  }\n  return true;\n}\n\n/**\n * Validate that a value is a non-empty string\n */\nexport function isNonEmptyString(value: unknown): value is string {\n  return typeof value === 'string' && value.trim().length > 0;\n}\n\n/**\n * Validate that a value is a plain object\n */\nexport function isPlainObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/**\n * Validate that a value is a function\n */\n// eslint-disable-next-line @typescript-eslint/ban-types\nexport function isFunction(value: unknown): value is Function {\n  return typeof value === 'function';\n}\n\n/**\n * Validate route parameter name\n */\nexport function isValidParamName(value: string): boolean {\n  return /^[a-zA-Z_][a-zA-Z0-9_]*$/.test(value);\n}\n","import type {\n  DataSource,\n  Repository,\n  EntityTarget,\n  ObjectLiteral,\n  SelectQueryBuilder,\n} from 'typeorm';\nimport { BaseAdapter } from '../core/BaseAdapter';\nimport { QueryOptions, ModelMetadata, QueryModifier } from '../core/types';\nimport { BindingError } from '../errors';\nimport { isUUID } from '../utils/validators';\n\n/**\n * TypeORM entity type alias for better readability\n */\nexport type TypeORMEntity = EntityTarget<ObjectLiteral>;\n\n/**\n * TypeORM find options structure\n */\ninterface TypeORMFindOptions {\n  where: Record<string, unknown>;\n  select?: Record<string, boolean>;\n  relations?: string[];\n  withDeleted?: boolean;\n}\n\n/**\n * Adapter for TypeORM supporting SQL and NoSQL databases\n */\nexport class TypeORMAdapter extends BaseAdapter<\n  TypeORMEntity,\n  ObjectLiteral,\n  SelectQueryBuilder<ObjectLiteral>\n> {\n  readonly name = 'typeorm';\n\n  constructor(private dataSource: DataSource) {\n    super();\n  }\n\n  getDataSource(): DataSource {\n    return this.dataSource;\n  }\n\n  async findByKey(\n    entity: TypeORMEntity,\n    key: string,\n    value: unknown,\n    options: QueryOptions = {}\n  ): Promise<ObjectLiteral | null> {\n    this.validateModel(entity);\n\n    try {\n      const repository = this.dataSource.getRepository(entity);\n      const metadata = repository.metadata;\n\n      const transformedValue = this.transformValue(entity, key, value as string);\n\n      if (options.query || options.lock || options.onlyTrashed) {\n        return await this.findWithQueryBuilder(repository, key, transformedValue, options);\n      }\n\n      const findOptions: TypeORMFindOptions = {\n        where: { [key]: transformedValue },\n      };\n\n      if (options.select && options.select.length > 0) {\n        findOptions.select = options.select.reduce<Record<string, boolean>>((acc, field) => {\n          acc[field] = true;\n          return acc;\n        }, {});\n      }\n\n      if (options.include) {\n        findOptions.relations = Array.isArray(options.include)\n          ? options.include\n          : Object.keys(options.include);\n      }\n\n      if (options.where) {\n        findOptions.where = {\n          ...findOptions.where,\n          ...options.where,\n        };\n      }\n\n      if (options.withTrashed && metadata.deleteDateColumn) {\n        findOptions.withDeleted = true;\n      }\n\n      const result = await repository.findOne(findOptions);\n      return result;\n    } catch (error) {\n      throw new BindingError(`Failed to fetch entity: ${(error as Error).message}`, error as Error);\n    }\n  }\n\n  getPrimaryKeyName(entity: TypeORMEntity): string {\n    try {\n      const repository = this.dataSource.getRepository(entity);\n      const metadata = repository.metadata;\n\n      if (metadata.primaryColumns.length > 0) {\n        return metadata.primaryColumns[0].propertyName;\n      }\n    } catch {\n      // Fall through to default\n    }\n    return 'id';\n  }\n\n  isValidModel(model: unknown): model is TypeORMEntity {\n    try {\n      this.dataSource.getRepository(model as TypeORMEntity);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  transformValue(entity: TypeORMEntity, key: string, value: string): unknown {\n    try {\n      const repository = this.dataSource.getRepository(entity);\n      const metadata = repository.metadata;\n      const column = metadata.findColumnWithPropertyName(key);\n\n      if (!column) {\n        if (isUUID(value)) {\n          return value;\n        }\n        const num = parseInt(value, 10);\n        if (!isNaN(num) && num.toString() === value) {\n          return num;\n        }\n        return value;\n      }\n\n      const columnType = String(column.type).toLowerCase();\n\n      if (['int', 'integer', 'smallint', 'bigint', 'number'].includes(columnType)) {\n        const num = parseInt(value, 10);\n        return isNaN(num) ? value : num;\n      }\n\n      if (columnType === 'uuid') {\n        return value;\n      }\n\n      if (columnType === 'boolean' || columnType === 'bool') {\n        return value === 'true' || value === '1';\n      }\n\n      return value;\n    } catch {\n      return value;\n    }\n  }\n\n  supportsSoftDeletes(entity: TypeORMEntity): boolean {\n    try {\n      const repository = this.dataSource.getRepository(entity);\n      const metadata = repository.metadata;\n      return !!metadata.deleteDateColumn;\n    } catch {\n      return false;\n    }\n  }\n\n  getModelMetadata(entity: TypeORMEntity): ModelMetadata {\n    try {\n      const repository = this.dataSource.getRepository(entity);\n      const metadata = repository.metadata;\n\n      return {\n        name: metadata.name,\n        primaryKey: this.getPrimaryKeyName(entity),\n        tableName: metadata.tableName,\n        softDeletes: this.supportsSoftDeletes(entity),\n        relations: metadata.relations.map(r => r.propertyName),\n        adapter: this.name,\n      };\n    } catch {\n      return {\n        name: 'Unknown',\n        primaryKey: 'id',\n        softDeletes: false,\n        adapter: this.name,\n      };\n    }\n  }\n\n  private async findWithQueryBuilder(\n    repository: Repository<ObjectLiteral>,\n    key: string,\n    value: unknown,\n    options: QueryOptions\n  ): Promise<ObjectLiteral | null> {\n    const metadata = repository.metadata;\n    const alias = metadata.name.toLowerCase();\n\n    let queryBuilder = repository\n      .createQueryBuilder(alias)\n      .where(`${alias}.${key} = :value`, { value });\n\n    if (options.include) {\n      const relations = Array.isArray(options.include)\n        ? options.include\n        : Object.keys(options.include);\n\n      relations.forEach(relation => {\n        queryBuilder = queryBuilder.leftJoinAndSelect(`${alias}.${relation}`, relation);\n      });\n    }\n\n    if (options.where) {\n      Object.entries(options.where).forEach(([field, val]) => {\n        queryBuilder = queryBuilder.andWhere(`${alias}.${field} = :${field}`, { [field]: val });\n      });\n    }\n\n    if (options.select && options.select.length > 0) {\n      queryBuilder = queryBuilder.select(options.select.map(field => `${alias}.${field}`));\n    }\n\n    if (options.withTrashed) {\n      queryBuilder = queryBuilder.withDeleted();\n    } else if (options.onlyTrashed && metadata.deleteDateColumn) {\n      queryBuilder = queryBuilder\n        .withDeleted()\n        .andWhere(`${alias}.${metadata.deleteDateColumn.propertyName} IS NOT NULL`);\n    }\n\n    if (options.lock === 'forUpdate') {\n      queryBuilder = queryBuilder.setLock('pessimistic_write');\n    } else if (options.lock === 'forShare') {\n      queryBuilder = queryBuilder.setLock('pessimistic_read');\n    }\n\n    if (options.query) {\n      queryBuilder = this.applyCustomQuery(\n        queryBuilder,\n        options.query as QueryModifier<SelectQueryBuilder<ObjectLiteral>>\n      );\n    }\n\n    return await queryBuilder.getOne();\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.mts

@@ -0,0 +1,411 @@
+import { Request, Response, RequestHandler } from 'express';
+import { I as IORMAdapter, B as BindOptions, a as BindingResult, M as ModelBindingsConfig } from './BaseAdapter-BjvLQijd.mjs';
+export { b as BaseAdapter, c as BindingContext, C as CacheEntry, E as ExtractModelType, g as MiddlewareFunction, e as ModelBindingGlobalConfig, d as ModelMetadata, Q as QueryOptions, T as TypedRequest, f as TypedRequestHandler } from './BaseAdapter-BjvLQijd.mjs';
+export { KnexAdapter, KnexModel, defineKnexModel } from './adapters/KnexAdapter.mjs';
+export { MongooseAdapter } from './adapters/MongooseAdapter.mjs';
+export { TypeORMAdapter } from './adapters/TypeORMAdapter.mjs';
+export { SequelizeAdapter } from './adapters/SequelizeAdapter.mjs';
+export { PrismaAdapter } from './adapters/PrismaAdapter.mjs';
+import 'knex';
+import 'mongoose';
+import 'typeorm';
+import 'sequelize';
+
+/**
+ * Central model binding orchestrator
+ */
+declare class ModelBinder {
+    private static adapter;
+    private static cache;
+    private static debug;
+    static setAdapter(adapter: IORMAdapter): void;
+    static getAdapter(): IORMAdapter;
+    static hasAdapter(): boolean;
+    static clearAdapter(): void;
+    static setDebug(enabled: boolean): void;
+    static isDebugEnabled(): boolean;
+    static clearCache(): void;
+    static getCacheStats(): {
+        size: number;
+        maxSize: number;
+    };
+    static bind(req: Request, res: Response, paramName: string, model: unknown, options?: BindOptions): Promise<BindingResult>;
+    private static attachToRequest;
+    private static getCacheKey;
+    private static getModelName;
+    static reset(): void;
+}
+
+/**
+ * Create middleware that binds a model to a route parameter
+ *
+ * @param paramName - The route parameter name (without ':')
+ * @param model - The model class/schema/table
+ * @param options - Binding options
+ * @returns Express middleware function
+ *
+ * @example
+ * app.get('/users/:user', bindModel('user', User), (req, res) => {
+ *   res.json(req.user);
+ * });
+ */
+declare function bindModel(paramName: string, model: unknown, options?: BindOptions): RequestHandler;
+/**
+ * Bind multiple models in a single middleware
+ *
+ * @param bindings - Object mapping parameter names to model configs
+ * @returns Express middleware function
+ *
+ * @example
+ * app.get('/users/:user/posts/:post',
+ *   bindModels({
+ *     user: { model: User },
+ *     post: { model: Post, options: { include: ['comments'] } }
+ *   }),
+ *   (req, res) => {
+ *     res.json({ user: req.user, post: req.post });
+ *   }
+ * );
+ */
+declare function bindModels(bindings: ModelBindingsConfig): RequestHandler;
+/**
+ * Bind a model optionally (don't throw 404 if not found)
+ *
+ * @param paramName - The route parameter name
+ * @param model - The model class/schema/table
+ * @param options - Binding options
+ * @returns Express middleware function
+ *
+ * @example
+ * app.get('/posts/:post?', bindOptional('post', Post), (req, res) => {
+ *   if (req.post) {
+ *     res.json(req.post);
+ *   } else {
+ *     res.json({ message: 'No specific post' });
+ *   }
+ * });
+ */
+declare function bindOptional(paramName: string, model: unknown, options?: BindOptions): RequestHandler;
+/**
+ * Create a middleware that binds a model using a custom key
+ *
+ * @param paramName - The route parameter name
+ * @param model - The model class/schema/table
+ * @param key - The field to search by
+ * @param options - Additional binding options
+ * @returns Express middleware function
+ *
+ * @example
+ * app.get('/users/by-email/:email', bindByKey('email', User, 'email'), (req, res) => {
+ *   res.json(req.email);
+ * });
+ */
+declare function bindByKey(paramName: string, model: unknown, key: string, options?: BindOptions): RequestHandler;
+/**
+ * Create a middleware that binds a model and attaches it with a custom name
+ *
+ * @param paramName - The route parameter name
+ * @param model - The model class/schema/table
+ * @param attachAs - The name to attach the model as on the request
+ * @param options - Additional binding options
+ * @returns Express middleware function
+ *
+ * @example
+ * app.get('/users/:id', bindAs('id', User, 'currentUser'), (req, res) => {
+ *   res.json(req.currentUser);
+ * });
+ */
+declare function bindAs(paramName: string, model: unknown, attachAs: string, options?: BindOptions): RequestHandler;
+/**
+ * Create a middleware that binds a model with caching
+ *
+ * @param paramName - The route parameter name
+ * @param model - The model class/schema/table
+ * @param ttl - Cache TTL in milliseconds (default: 60000)
+ * @param options - Additional binding options
+ * @returns Express middleware function
+ *
+ * @example
+ * app.get('/users/:user', bindCached('user', User, 300000), (req, res) => {
+ *   res.json(req.user);
+ * });
+ */
+declare function bindCached(paramName: string, model: unknown, ttl?: number, options?: BindOptions): RequestHandler;
+/**
+ * Create a middleware that binds a model with eager-loaded relations
+ *
+ * @param paramName - The route parameter name
+ * @param model - The model class/schema/table
+ * @param relations - Relations to eager load
+ * @param options - Additional binding options
+ * @returns Express middleware function
+ *
+ * @example
+ * app.get('/users/:user', bindWithRelations('user', User, ['posts', 'profile']), (req, res) => {
+ *   res.json(req.user);
+ * });
+ */
+declare function bindWithRelations(paramName: string, model: unknown, relations: string[] | Record<string, unknown>, options?: BindOptions): RequestHandler;
+
+/**
+ * Base error class for model binding errors
+ */
+declare class BindingError extends Error {
+    readonly originalError?: Error;
+    constructor(message: string, originalError?: Error);
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Error thrown when a model is not found (404)
+ */
+declare class ModelNotFoundError extends Error {
+    readonly statusCode = 404;
+    readonly paramName: string;
+    readonly paramValue: string;
+    readonly modelName: string;
+    constructor(paramName: string, paramValue: string, modelName: string, customMessage?: string);
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Error thrown when no adapter is configured
+ */
+declare class AdapterNotSetError extends Error {
+    constructor(message?: string);
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Error thrown when a model is invalid for an adapter
+ */
+declare class InvalidModelError extends Error {
+    readonly model: unknown;
+    constructor(message: string, model: unknown);
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Error thrown when validation fails
+ */
+declare class ValidationError extends Error {
+    readonly statusCode: number;
+    readonly details?: unknown;
+    constructor(message: string, statusCode?: number, details?: unknown);
+    toJSON(): Record<string, unknown>;
+}
+
+/**
+ * Simple in-memory cache for model binding
+ */
+declare class Cache {
+    private store;
+    private maxSize;
+    constructor(maxSize?: number);
+    /**
+     * Get a value from cache
+     */
+    get<T = unknown>(key: string): T | null;
+    /**
+     * Set a value in cache
+     */
+    set<T = unknown>(key: string, value: T, ttl: number): void;
+    /**
+     * Delete a value from cache
+     */
+    delete(key: string): boolean;
+    /**
+     * Clear all cached values
+     */
+    clear(): void;
+    /**
+     * Get cache size
+     */
+    get size(): number;
+    /**
+     * Check if key exists and is not expired
+     */
+    has(key: string): boolean;
+    /**
+     * Get all keys in the cache
+     */
+    keys(): string[];
+    /**
+     * Remove expired entries
+     */
+    prune(): number;
+    /**
+     * Get cache statistics
+     */
+    getStats(): {
+        size: number;
+        maxSize: number;
+    };
+}
+
+/**
+ * Log levels for the logger
+ */
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Logger configuration
+ */
+interface LoggerConfig {
+    enabled: boolean;
+    level: LogLevel;
+    prefix: string;
+}
+/**
+ * Simple logger utility for debugging
+ */
+declare class Logger {
+    private config;
+    private levelPriority;
+    /**
+     * Enable debug logging
+     */
+    enable(): void;
+    /**
+     * Disable debug logging
+     */
+    disable(): void;
+    /**
+     * Check if logging is enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Set log level
+     */
+    setLevel(level: LogLevel): void;
+    /**
+     * Get current log level
+     */
+    getLevel(): LogLevel;
+    /**
+     * Set custom prefix
+     */
+    setPrefix(prefix: string): void;
+    /**
+     * Check if a message at the given level should be logged
+     */
+    private shouldLog;
+    /**
+     * Format log message
+     */
+    private formatMessage;
+    /**
+     * Log a debug message
+     */
+    debug(message: string, context?: unknown): void;
+    /**
+     * Log an info message
+     */
+    info(message: string, context?: unknown): void;
+    /**
+     * Log a warning message
+     */
+    warn(message: string, context?: unknown): void;
+    /**
+     * Log an error message
+     */
+    error(message: string, error?: unknown): void;
+    /**
+     * Reset logger to default configuration
+     */
+    reset(): void;
+    /**
+     * Get current configuration
+     */
+    getConfig(): LoggerConfig;
+}
+declare const logger: Logger;
+
+/**
+ * Check if a value is a valid UUID
+ */
+declare function isUUID(value: string): boolean;
+/**
+ * Check if a value is a valid MongoDB ObjectId
+ */
+declare function isObjectId(value: string): boolean;
+/**
+ * Check if a value is a numeric string
+ */
+declare function isNumeric(value: string): boolean;
+/**
+ * Check if a value is a valid positive integer
+ */
+declare function isPositiveInteger(value: string): boolean;
+/**
+ * Check if a value is a valid slug (lowercase alphanumeric with hyphens)
+ */
+declare function isSlug(value: string): boolean;
+/**
+ * Check if a value is a valid email
+ */
+declare function isEmail(value: string): boolean;
+/**
+ * Validate that a value is not empty
+ */
+declare function isNotEmpty(value: unknown): boolean;
+/**
+ * Validate that a value is a non-empty string
+ */
+declare function isNonEmptyString(value: unknown): value is string;
+/**
+ * Validate that a value is a plain object
+ */
+declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+/**
+ * Validate that a value is a function
+ */
+declare function isFunction(value: unknown): value is Function;
+/**
+ * Validate route parameter name
+ */
+declare function isValidParamName(value: string): boolean;
+
+/**
+ * Transform a string value to a number if it's numeric
+ */
+declare function toNumber(value: string): number | string;
+/**
+ * Transform a string value to a float if it's a valid decimal
+ */
+declare function toFloat(value: string): number | string;
+/**
+ * Transform a string value to a boolean
+ */
+declare function toBoolean(value: string): boolean;
+/**
+ * Transform a string to lowercase
+ */
+declare function toLowerCase(value: string): string;
+/**
+ * Transform a string to uppercase
+ */
+declare function toUpperCase(value: string): string;
+/**
+ * Trim whitespace from a string
+ */
+declare function trim(value: string): string;
+/**
+ * Transform a slug to underscore format
+ */
+declare function slugToUnderscore(value: string): string;
+/**
+ * Transform underscores to dashes (slug format)
+ */
+declare function underscoreToSlug(value: string): string;
+/**
+ * Auto-detect and transform value based on format
+ */
+declare function autoTransform(value: string): unknown;
+/**
+ * Create a composed transformer from multiple transform functions
+ */
+declare function compose(...transformers: Array<(value: string) => unknown>): (value: string) => unknown;
+/**
+ * Identity transformer - returns the value unchanged
+ */
+declare function identity<T>(value: T): T;
+
+declare const VERSION = "1.0.0";
+
+export { AdapterNotSetError, BindOptions, BindingError, BindingResult, Cache, IORMAdapter, InvalidModelError, type LogLevel, type LoggerConfig, ModelBinder, ModelBindingsConfig, ModelNotFoundError, VERSION, ValidationError, autoTransform, bindAs, bindByKey, bindCached, bindModel, bindModels, bindOptional, bindWithRelations, compose, identity, isEmail, isFunction, isNonEmptyString, isNotEmpty, isNumeric, isObjectId, isPlainObject, isPositiveInteger, isSlug, isUUID, isValidParamName, logger, slugToUnderscore, toBoolean, toFloat, toLowerCase, toNumber, toUpperCase, trim, underscoreToSlug };