express-model-binding 1.0.0

package/dist/adapters/KnexAdapter.d.ts

@@ -0,0 +1,44 @@
+import { Knex } from 'knex';
+import { b as BaseAdapter, Q as QueryOptions, d as ModelMetadata } from '../BaseAdapter-BjvLQijd.js';
+import 'express';
+
+/**
+ * Model definition for Knex tables with soft delete support
+ */
+interface KnexModel {
+    tableName: string;
+    primaryKey?: string;
+    softDeleteColumn?: string;
+}
+/**
+ * Union type for Knex model inputs
+ */
+type KnexModelInput = string | KnexModel;
+/**
+ * Adapter for Knex query builder supporting PostgreSQL, MySQL, SQLite, MSSQL, Oracle
+ */
+declare class KnexAdapter extends BaseAdapter<KnexModelInput, Record<string, unknown>, Knex.QueryBuilder> {
+    private knex;
+    readonly name = "knex";
+    constructor(knex: Knex);
+    getKnex(): Knex;
+    findByKey(model: KnexModelInput, key: string, value: unknown, options?: QueryOptions): Promise<Record<string, unknown> | null>;
+    getPrimaryKeyName(model: KnexModelInput): string;
+    isValidModel(model: unknown): model is KnexModelInput;
+    transformValue(model: KnexModelInput, key: string, value: string): unknown;
+    supportsSoftDeletes(model: KnexModelInput): boolean;
+    getModelMetadata(model: KnexModelInput): ModelMetadata;
+    private getTableName;
+    private getSoftDeleteColumn;
+    protected applyWhereConditions(query: Knex.QueryBuilder, where: Record<string, unknown>): Knex.QueryBuilder;
+}
+/**
+ * Create a Knex model definition
+ */
+declare function defineKnexModel(config: {
+    tableName: string;
+    primaryKey?: string;
+    softDeleteColumn?: string;
+}): KnexModel;
+
+export { KnexAdapter, type KnexModel, type KnexModelInput, defineKnexModel };

package/dist/adapters/KnexAdapter.js

@@ -0,0 +1,257 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/adapters/KnexAdapter.ts
+var KnexAdapter_exports = {};
+__export(KnexAdapter_exports, {
+  KnexAdapter: () => KnexAdapter,
+  defineKnexModel: () => defineKnexModel
+});
+module.exports = __toCommonJS(KnexAdapter_exports);
+
+// src/errors/index.ts
+var BindingError = class extends Error {
+  constructor(message, originalError) {
+    super(message);
+    this.name = "BindingError";
+    this.originalError = originalError;
+    Error.captureStackTrace(this, this.constructor);
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      originalError: this.originalError?.message
+    };
+  }
+};
+var InvalidModelError = class extends Error {
+  constructor(message, model) {
+    super(message);
+    this.name = "InvalidModelError";
+    this.model = model;
+    Error.captureStackTrace(this, this.constructor);
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      model: typeof this.model === "string" ? this.model : String(this.model)
+    };
+  }
+};
+
+// src/core/BaseAdapter.ts
+var BaseAdapter = class {
+  transformValue(_model, _key, value) {
+    if (/^\d+$/.test(value)) {
+      const num = parseInt(value, 10);
+      if (!isNaN(num) && Number.isSafeInteger(num)) {
+        return num;
+      }
+    }
+    return value;
+  }
+  supportsSoftDeletes(_model) {
+    return false;
+  }
+  getModelMetadata(model) {
+    return {
+      name: this.getModelName(model),
+      primaryKey: this.getPrimaryKeyName(model),
+      softDeletes: this.supportsSoftDeletes(model),
+      adapter: this.name
+    };
+  }
+  validateModel(model) {
+    if (!this.isValidModel(model)) {
+      throw new InvalidModelError(`Invalid model for ${this.name} adapter`, model);
+    }
+  }
+  getModelName(model) {
+    if (typeof model === "string") {
+      return model;
+    }
+    if (model && typeof model === "object") {
+      const obj = model;
+      if (typeof obj.name === "string") return obj.name;
+      if (typeof obj.modelName === "string") return obj.modelName;
+      if (typeof obj.tableName === "string") return obj.tableName;
+    }
+    if (model && typeof model === "function") {
+      return model.name || "Unknown";
+    }
+    return "Unknown";
+  }
+  applySoftDeleteFilter(queryBuilder, _options) {
+    return queryBuilder;
+  }
+  applyIncludes(queryBuilder, _includes) {
+    return queryBuilder;
+  }
+  applySelect(queryBuilder, _select) {
+    return queryBuilder;
+  }
+  applyWhereConditions(queryBuilder, _where) {
+    return queryBuilder;
+  }
+  applyCustomQuery(queryBuilder, queryFn) {
+    if (queryFn) {
+      return queryFn(queryBuilder);
+    }
+    return queryBuilder;
+  }
+};
+
+// src/core/types.ts
+function isOperatorCondition(value) {
+  return typeof value === "object" && value !== null && "operator" in value && "value" in value;
+}
+
+// src/utils/validators.ts
+var UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function isUUID(value) {
+  return UUID_REGEX.test(value);
+}
+
+// src/adapters/KnexAdapter.ts
+function isKnexModel(value) {
+  return typeof value === "object" && value !== null && typeof value.tableName === "string";
+}
+var KnexAdapter = class extends BaseAdapter {
+  constructor(knex) {
+    super();
+    this.knex = knex;
+    this.name = "knex";
+  }
+  getKnex() {
+    return this.knex;
+  }
+  async findByKey(model, key, value, options = {}) {
+    this.validateModel(model);
+    const tableName = this.getTableName(model);
+    try {
+      let query = this.knex(tableName);
+      query = query.where(key, value);
+      if (this.supportsSoftDeletes(model) && !options.withTrashed && !options.onlyTrashed) {
+        const softDeleteColumn = this.getSoftDeleteColumn(model);
+        query = query.whereNull(softDeleteColumn);
+      } else if (options.onlyTrashed && this.supportsSoftDeletes(model)) {
+        const softDeleteColumn = this.getSoftDeleteColumn(model);
+        query = query.whereNotNull(softDeleteColumn);
+      }
+      if (options.where) {
+        query = this.applyWhereConditions(query, options.where);
+      }
+      if (options.select && options.select.length > 0) {
+        query = query.select(options.select);
+      } else {
+        query = query.select("*");
+      }
+      if (options.query) {
+        query = this.applyCustomQuery(
+          query,
+          options.query
+        );
+      }
+      if (options.lock === "forUpdate") {
+        query = query.forUpdate();
+      } else if (options.lock === "forShare") {
+        query = query.forShare();
+      }
+      const result = await query.first();
+      return result || null;
+    } catch (error) {
+      throw new BindingError(
+        `Failed to fetch ${this.getModelName(model)}: ${error.message}`,
+        error
+      );
+    }
+  }
+  getPrimaryKeyName(model) {
+    if (isKnexModel(model) && model.primaryKey) {
+      return model.primaryKey;
+    }
+    return "id";
+  }
+  isValidModel(model) {
+    return typeof model === "string" || isKnexModel(model);
+  }
+  transformValue(model, key, value) {
+    const primaryKey = this.getPrimaryKeyName(model);
+    if (key === primaryKey || key === "id") {
+      const num = parseInt(value, 10);
+      if (!isNaN(num) && num.toString() === value && Number.isSafeInteger(num)) {
+        return num;
+      }
+    }
+    if (isUUID(value)) {
+      return value;
+    }
+    return value;
+  }
+  supportsSoftDeletes(model) {
+    return isKnexModel(model) && !!model.softDeleteColumn;
+  }
+  getModelMetadata(model) {
+    return {
+      name: this.getModelName(model),
+      primaryKey: this.getPrimaryKeyName(model),
+      tableName: this.getTableName(model),
+      softDeletes: this.supportsSoftDeletes(model),
+      adapter: this.name
+    };
+  }
+  getTableName(model) {
+    return typeof model === "string" ? model : model.tableName;
+  }
+  getSoftDeleteColumn(model) {
+    if (isKnexModel(model) && model.softDeleteColumn) {
+      return model.softDeleteColumn;
+    }
+    return "deleted_at";
+  }
+  applyWhereConditions(query, where) {
+    Object.entries(where).forEach(([column, value]) => {
+      if (value === null) {
+        query = query.whereNull(column);
+      } else if (Array.isArray(value)) {
+        query = query.whereIn(column, value);
+      } else if (isOperatorCondition(value)) {
+        query = query.where(column, value.operator, value.value);
+      } else {
+        query = query.where(column, value);
+      }
+    });
+    return query;
+  }
+};
+function defineKnexModel(config) {
+  return {
+    tableName: config.tableName,
+    primaryKey: config.primaryKey || "id",
+    softDeleteColumn: config.softDeleteColumn
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  KnexAdapter,
+  defineKnexModel
+});
+//# sourceMappingURL=KnexAdapter.js.map

package/dist/adapters/KnexAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/KnexAdapter.ts","../../src/errors/index.ts","../../src/core/BaseAdapter.ts","../../src/core/types.ts","../../src/utils/validators.ts"],"sourcesContent":["import type { Knex } from 'knex';\nimport { BaseAdapter } from '../core/BaseAdapter';\nimport { QueryOptions, ModelMetadata, isOperatorCondition } from '../core/types';\nimport { BindingError } from '../errors';\nimport { isUUID } from '../utils/validators';\n\n/**\n * Model definition for Knex tables with soft delete support\n */\nexport interface KnexModel {\n  tableName: string;\n  primaryKey?: string;\n  softDeleteColumn?: string;\n}\n\n/**\n * Union type for Knex model inputs\n */\nexport type KnexModelInput = string | KnexModel;\n\n/**\n * Type guard for KnexModel\n */\nfunction isKnexModel(value: unknown): value is KnexModel {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    typeof (value as KnexModel).tableName === 'string'\n  );\n}\n\n/**\n * Adapter for Knex query builder supporting PostgreSQL, MySQL, SQLite, MSSQL, Oracle\n */\nexport class KnexAdapter extends BaseAdapter<\n  KnexModelInput,\n  Record<string, unknown>,\n  Knex.QueryBuilder\n> {\n  readonly name = 'knex';\n\n  constructor(private knex: Knex) {\n    super();\n  }\n\n  getKnex(): Knex {\n    return this.knex;\n  }\n\n  async findByKey(\n    model: KnexModelInput,\n    key: string,\n    value: unknown,\n    options: QueryOptions = {}\n  ): Promise<Record<string, unknown> | null> {\n    this.validateModel(model);\n\n    const tableName = this.getTableName(model);\n\n    try {\n      let query = this.knex(tableName);\n\n      query = query.where(key, value as Knex.Value);\n\n      if (this.supportsSoftDeletes(model) && !options.withTrashed && !options.onlyTrashed) {\n        const softDeleteColumn = this.getSoftDeleteColumn(model);\n        query = query.whereNull(softDeleteColumn);\n      } else if (options.onlyTrashed && this.supportsSoftDeletes(model)) {\n        const softDeleteColumn = this.getSoftDeleteColumn(model);\n        query = query.whereNotNull(softDeleteColumn);\n      }\n\n      if (options.where) {\n        query = this.applyWhereConditions(query, options.where);\n      }\n\n      if (options.select && options.select.length > 0) {\n        query = query.select(options.select);\n      } else {\n        query = query.select('*');\n      }\n\n      if (options.query) {\n        query = this.applyCustomQuery(\n          query,\n          options.query as (qb: Knex.QueryBuilder) => Knex.QueryBuilder\n        );\n      }\n\n      if (options.lock === 'forUpdate') {\n        query = query.forUpdate();\n      } else if (options.lock === 'forShare') {\n        query = query.forShare();\n      }\n\n      const result = await query.first();\n      return (result as Record<string, unknown>) || null;\n    } catch (error) {\n      throw new BindingError(\n        `Failed to fetch ${this.getModelName(model)}: ${(error as Error).message}`,\n        error as Error\n      );\n    }\n  }\n\n  getPrimaryKeyName(model: KnexModelInput): string {\n    if (isKnexModel(model) && model.primaryKey) {\n      return model.primaryKey;\n    }\n    return 'id';\n  }\n\n  isValidModel(model: unknown): model is KnexModelInput {\n    return typeof model === 'string' || isKnexModel(model);\n  }\n\n  transformValue(model: KnexModelInput, key: string, value: string): unknown {\n    const primaryKey = this.getPrimaryKeyName(model);\n\n    if (key === primaryKey || key === 'id') {\n      const num = parseInt(value, 10);\n      if (!isNaN(num) && num.toString() === value && Number.isSafeInteger(num)) {\n        return num;\n      }\n    }\n\n    if (isUUID(value)) {\n      return value;\n    }\n\n    return value;\n  }\n\n  supportsSoftDeletes(model: KnexModelInput): boolean {\n    return isKnexModel(model) && !!model.softDeleteColumn;\n  }\n\n  getModelMetadata(model: KnexModelInput): ModelMetadata {\n    return {\n      name: this.getModelName(model),\n      primaryKey: this.getPrimaryKeyName(model),\n      tableName: this.getTableName(model),\n      softDeletes: this.supportsSoftDeletes(model),\n      adapter: this.name,\n    };\n  }\n\n  private getTableName(model: KnexModelInput): string {\n    return typeof model === 'string' ? model : model.tableName;\n  }\n\n  private getSoftDeleteColumn(model: KnexModelInput): string {\n    if (isKnexModel(model) && model.softDeleteColumn) {\n      return model.softDeleteColumn;\n    }\n    return 'deleted_at';\n  }\n\n  protected applyWhereConditions(\n    query: Knex.QueryBuilder,\n    where: Record<string, unknown>\n  ): Knex.QueryBuilder {\n    Object.entries(where).forEach(([column, value]) => {\n      if (value === null) {\n        query = query.whereNull(column);\n      } else if (Array.isArray(value)) {\n        query = query.whereIn(column, value as Knex.Value[]);\n      } else if (isOperatorCondition(value)) {\n        query = query.where(column, value.operator, value.value as Knex.Value);\n      } else {\n        query = query.where(column, value as Knex.Value);\n      }\n    });\n    return query;\n  }\n}\n\n/**\n * Create a Knex model definition\n */\nexport function defineKnexModel(config: {\n  tableName: string;\n  primaryKey?: string;\n  softDeleteColumn?: string;\n}): KnexModel {\n  return {\n    tableName: config.tableName,\n    primaryKey: config.primaryKey || 'id',\n    softDeleteColumn: config.softDeleteColumn,\n  };\n}\n","/**\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","import { Request, Response, NextFunction, RequestHandler } from 'express';\n\n/**\n * Generic query builder type - adapters can narrow this to their specific type\n */\nexport type QueryBuilder<T = unknown> = T;\n\n/**\n * Query modifier function type\n */\nexport type QueryModifier<T = unknown> = (queryBuilder: QueryBuilder<T>) => QueryBuilder<T>;\n\n/**\n * Base adapter interface that all ORM adapters must implement\n */\nexport interface IORMAdapter<TModel = unknown, TResult = unknown> {\n  readonly name: string;\n\n  findByKey(\n    model: TModel,\n    key: string,\n    value: unknown,\n    options?: QueryOptions\n  ): Promise<TResult | null>;\n\n  getPrimaryKeyName(model: TModel): string;\n\n  isValidModel(model: unknown): model is TModel;\n\n  transformValue(model: TModel, key: string, value: string): unknown;\n\n  supportsSoftDeletes(model: TModel): boolean;\n\n  getModelMetadata?(model: TModel): ModelMetadata;\n}\n\n/**\n * Query options for model lookups\n */\nexport interface QueryOptions {\n  /**\n   * Relations to eager load\n   */\n  include?: string[] | Record<string, unknown>;\n\n  /**\n   * Additional WHERE conditions\n   */\n  where?: Record<string, unknown>;\n\n  /**\n   * Custom query modifier - receives ORM-specific query builder\n   */\n  query?: QueryModifier;\n\n  /**\n   * Fields to select\n   */\n  select?: string[];\n\n  /**\n   * Include soft-deleted records\n   */\n  withTrashed?: boolean;\n\n  /**\n   * Only return soft-deleted records\n   */\n  onlyTrashed?: boolean;\n\n  /**\n   * Enable result caching\n   */\n  cache?: boolean | number;\n\n  /**\n   * Row locking for transactions\n   */\n  lock?: 'forUpdate' | 'forShare';\n}\n\n/**\n * Binding middleware options\n */\nexport interface BindOptions extends QueryOptions {\n  /**\n   * Field to search by (defaults to primary key)\n   */\n  key?: string;\n\n  /**\n   * Custom error when model not found\n   */\n  onNotFound?: Error | ((paramName: string, paramValue: string) => Error);\n\n  /**\n   * Transform parameter value before querying\n   */\n  transformValue?: (value: string) => unknown;\n\n  /**\n   * Property name for attaching model to request\n   */\n  as?: string;\n\n  /**\n   * Don't throw if model not found\n   */\n  optional?: boolean;\n\n  /**\n   * Custom 404 message\n   */\n  errorMessage?: string;\n\n  /**\n   * Validate loaded model\n   */\n  validate?: (model: unknown, req: Request) => void | Promise<void>;\n\n  /**\n   * Enable caching\n   */\n  cache?: boolean;\n\n  /**\n   * Cache TTL in milliseconds\n   */\n  cacheTTL?: number;\n}\n\n/**\n * Multi-model binding configuration\n */\nexport interface ModelBindingsConfig {\n  [paramName: string]: {\n    model: unknown;\n    options?: BindOptions;\n  };\n}\n\n/**\n * Binding operation context\n */\nexport interface BindingContext {\n  req: Request;\n  res: Response;\n  paramName: string;\n  paramValue: string;\n  model: unknown;\n  options: BindOptions;\n  adapter: IORMAdapter;\n  startTime: number;\n}\n\n/**\n * Binding operation result\n */\nexport interface BindingResult {\n  success: boolean;\n  model?: unknown;\n  error?: Error;\n  duration: number;\n  fromCache?: boolean;\n}\n\n/**\n * Model metadata for debugging\n */\nexport interface ModelMetadata {\n  name: string;\n  primaryKey: string;\n  tableName?: string;\n  relations?: string[];\n  softDeletes: boolean;\n  adapter?: string;\n  [key: string]: unknown;\n}\n\n/**\n * Cache entry structure\n */\nexport interface CacheEntry<T = unknown> {\n  value: T;\n  timestamp: number;\n  ttl: number;\n}\n\n/**\n * Global configuration options\n */\nexport interface ModelBindingGlobalConfig {\n  adapter?: IORMAdapter;\n  cache?: {\n    enabled: boolean;\n    ttl: number;\n    maxSize?: number;\n  };\n  debug?: boolean;\n  logger?: (message: string, context?: unknown) => void;\n  onError?: (error: Error, context: BindingContext) => void;\n}\n\n/**\n * Express request with bound models\n */\nexport interface TypedRequest<\n  P = Record<string, string>,\n  ResBody = unknown,\n  ReqBody = unknown,\n  ReqQuery = unknown,\n  Models extends Record<string, unknown> = Record<string, unknown>,\n> extends Request<P, ResBody, ReqBody, ReqQuery> {\n  [K: string]: unknown;\n  models?: Models;\n}\n\n/**\n * Extract model type from binding config\n */\nexport type ExtractModelType<T> = T extends { model: infer M } ? M : never;\n\n/**\n * Typed request handler\n */\nexport type TypedRequestHandler<\n  Models extends Record<string, unknown> = Record<string, unknown>,\n  P = Record<string, string>,\n  ResBody = unknown,\n  ReqBody = unknown,\n  ReqQuery = unknown,\n> = (\n  req: TypedRequest<P, ResBody, ReqBody, ReqQuery, Models>,\n  res: Response<ResBody>,\n  next: NextFunction\n) => void | Promise<void>;\n\n/**\n * Middleware function type\n */\nexport type MiddlewareFunction = RequestHandler;\n\n/**\n * Operator condition for advanced WHERE clauses\n */\nexport interface OperatorCondition {\n  operator: string;\n  value: unknown;\n}\n\n/**\n * Check if value is an operator condition\n */\nexport function isOperatorCondition(value: unknown): value is OperatorCondition {\n  return typeof value === 'object' && value !== null && 'operator' in value && 'value' in value;\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"],"mappings":"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","names":[]}

package/dist/adapters/KnexAdapter.mjs

@@ -0,0 +1,229 @@
+// src/errors/index.ts
+var BindingError = class extends Error {
+  constructor(message, originalError) {
+    super(message);
+    this.name = "BindingError";
+    this.originalError = originalError;
+    Error.captureStackTrace(this, this.constructor);
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      originalError: this.originalError?.message
+    };
+  }
+};
+var InvalidModelError = class extends Error {
+  constructor(message, model) {
+    super(message);
+    this.name = "InvalidModelError";
+    this.model = model;
+    Error.captureStackTrace(this, this.constructor);
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      model: typeof this.model === "string" ? this.model : String(this.model)
+    };
+  }
+};
+
+// src/core/BaseAdapter.ts
+var BaseAdapter = class {
+  transformValue(_model, _key, value) {
+    if (/^\d+$/.test(value)) {
+      const num = parseInt(value, 10);
+      if (!isNaN(num) && Number.isSafeInteger(num)) {
+        return num;
+      }
+    }
+    return value;
+  }
+  supportsSoftDeletes(_model) {
+    return false;
+  }
+  getModelMetadata(model) {
+    return {
+      name: this.getModelName(model),
+      primaryKey: this.getPrimaryKeyName(model),
+      softDeletes: this.supportsSoftDeletes(model),
+      adapter: this.name
+    };
+  }
+  validateModel(model) {
+    if (!this.isValidModel(model)) {
+      throw new InvalidModelError(`Invalid model for ${this.name} adapter`, model);
+    }
+  }
+  getModelName(model) {
+    if (typeof model === "string") {
+      return model;
+    }
+    if (model && typeof model === "object") {
+      const obj = model;
+      if (typeof obj.name === "string") return obj.name;
+      if (typeof obj.modelName === "string") return obj.modelName;
+      if (typeof obj.tableName === "string") return obj.tableName;
+    }
+    if (model && typeof model === "function") {
+      return model.name || "Unknown";
+    }
+    return "Unknown";
+  }
+  applySoftDeleteFilter(queryBuilder, _options) {
+    return queryBuilder;
+  }
+  applyIncludes(queryBuilder, _includes) {
+    return queryBuilder;
+  }
+  applySelect(queryBuilder, _select) {
+    return queryBuilder;
+  }
+  applyWhereConditions(queryBuilder, _where) {
+    return queryBuilder;
+  }
+  applyCustomQuery(queryBuilder, queryFn) {
+    if (queryFn) {
+      return queryFn(queryBuilder);
+    }
+    return queryBuilder;
+  }
+};
+
+// src/core/types.ts
+function isOperatorCondition(value) {
+  return typeof value === "object" && value !== null && "operator" in value && "value" in value;
+}
+
+// src/utils/validators.ts
+var UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function isUUID(value) {
+  return UUID_REGEX.test(value);
+}
+
+// src/adapters/KnexAdapter.ts
+function isKnexModel(value) {
+  return typeof value === "object" && value !== null && typeof value.tableName === "string";
+}
+var KnexAdapter = class extends BaseAdapter {
+  constructor(knex) {
+    super();
+    this.knex = knex;
+    this.name = "knex";
+  }
+  getKnex() {
+    return this.knex;
+  }
+  async findByKey(model, key, value, options = {}) {
+    this.validateModel(model);
+    const tableName = this.getTableName(model);
+    try {
+      let query = this.knex(tableName);
+      query = query.where(key, value);
+      if (this.supportsSoftDeletes(model) && !options.withTrashed && !options.onlyTrashed) {
+        const softDeleteColumn = this.getSoftDeleteColumn(model);
+        query = query.whereNull(softDeleteColumn);
+      } else if (options.onlyTrashed && this.supportsSoftDeletes(model)) {
+        const softDeleteColumn = this.getSoftDeleteColumn(model);
+        query = query.whereNotNull(softDeleteColumn);
+      }
+      if (options.where) {
+        query = this.applyWhereConditions(query, options.where);
+      }
+      if (options.select && options.select.length > 0) {
+        query = query.select(options.select);
+      } else {
+        query = query.select("*");
+      }
+      if (options.query) {
+        query = this.applyCustomQuery(
+          query,
+          options.query
+        );
+      }
+      if (options.lock === "forUpdate") {
+        query = query.forUpdate();
+      } else if (options.lock === "forShare") {
+        query = query.forShare();
+      }
+      const result = await query.first();
+      return result || null;
+    } catch (error) {
+      throw new BindingError(
+        `Failed to fetch ${this.getModelName(model)}: ${error.message}`,
+        error
+      );
+    }
+  }
+  getPrimaryKeyName(model) {
+    if (isKnexModel(model) && model.primaryKey) {
+      return model.primaryKey;
+    }
+    return "id";
+  }
+  isValidModel(model) {
+    return typeof model === "string" || isKnexModel(model);
+  }
+  transformValue(model, key, value) {
+    const primaryKey = this.getPrimaryKeyName(model);
+    if (key === primaryKey || key === "id") {
+      const num = parseInt(value, 10);
+      if (!isNaN(num) && num.toString() === value && Number.isSafeInteger(num)) {
+        return num;
+      }
+    }
+    if (isUUID(value)) {
+      return value;
+    }
+    return value;
+  }
+  supportsSoftDeletes(model) {
+    return isKnexModel(model) && !!model.softDeleteColumn;
+  }
+  getModelMetadata(model) {
+    return {
+      name: this.getModelName(model),
+      primaryKey: this.getPrimaryKeyName(model),
+      tableName: this.getTableName(model),
+      softDeletes: this.supportsSoftDeletes(model),
+      adapter: this.name
+    };
+  }
+  getTableName(model) {
+    return typeof model === "string" ? model : model.tableName;
+  }
+  getSoftDeleteColumn(model) {
+    if (isKnexModel(model) && model.softDeleteColumn) {
+      return model.softDeleteColumn;
+    }
+    return "deleted_at";
+  }
+  applyWhereConditions(query, where) {
+    Object.entries(where).forEach(([column, value]) => {
+      if (value === null) {
+        query = query.whereNull(column);
+      } else if (Array.isArray(value)) {
+        query = query.whereIn(column, value);
+      } else if (isOperatorCondition(value)) {
+        query = query.where(column, value.operator, value.value);
+      } else {
+        query = query.where(column, value);
+      }
+    });
+    return query;
+  }
+};
+function defineKnexModel(config) {
+  return {
+    tableName: config.tableName,
+    primaryKey: config.primaryKey || "id",
+    softDeleteColumn: config.softDeleteColumn
+  };
+}
+export {
+  KnexAdapter,
+  defineKnexModel
+};
+//# sourceMappingURL=KnexAdapter.mjs.map

package/dist/adapters/KnexAdapter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/errors/index.ts","../../src/core/BaseAdapter.ts","../../src/core/types.ts","../../src/utils/validators.ts","../../src/adapters/KnexAdapter.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","import { Request, Response, NextFunction, RequestHandler } from 'express';\n\n/**\n * Generic query builder type - adapters can narrow this to their specific type\n */\nexport type QueryBuilder<T = unknown> = T;\n\n/**\n * Query modifier function type\n */\nexport type QueryModifier<T = unknown> = (queryBuilder: QueryBuilder<T>) => QueryBuilder<T>;\n\n/**\n * Base adapter interface that all ORM adapters must implement\n */\nexport interface IORMAdapter<TModel = unknown, TResult = unknown> {\n  readonly name: string;\n\n  findByKey(\n    model: TModel,\n    key: string,\n    value: unknown,\n    options?: QueryOptions\n  ): Promise<TResult | null>;\n\n  getPrimaryKeyName(model: TModel): string;\n\n  isValidModel(model: unknown): model is TModel;\n\n  transformValue(model: TModel, key: string, value: string): unknown;\n\n  supportsSoftDeletes(model: TModel): boolean;\n\n  getModelMetadata?(model: TModel): ModelMetadata;\n}\n\n/**\n * Query options for model lookups\n */\nexport interface QueryOptions {\n  /**\n   * Relations to eager load\n   */\n  include?: string[] | Record<string, unknown>;\n\n  /**\n   * Additional WHERE conditions\n   */\n  where?: Record<string, unknown>;\n\n  /**\n   * Custom query modifier - receives ORM-specific query builder\n   */\n  query?: QueryModifier;\n\n  /**\n   * Fields to select\n   */\n  select?: string[];\n\n  /**\n   * Include soft-deleted records\n   */\n  withTrashed?: boolean;\n\n  /**\n   * Only return soft-deleted records\n   */\n  onlyTrashed?: boolean;\n\n  /**\n   * Enable result caching\n   */\n  cache?: boolean | number;\n\n  /**\n   * Row locking for transactions\n   */\n  lock?: 'forUpdate' | 'forShare';\n}\n\n/**\n * Binding middleware options\n */\nexport interface BindOptions extends QueryOptions {\n  /**\n   * Field to search by (defaults to primary key)\n   */\n  key?: string;\n\n  /**\n   * Custom error when model not found\n   */\n  onNotFound?: Error | ((paramName: string, paramValue: string) => Error);\n\n  /**\n   * Transform parameter value before querying\n   */\n  transformValue?: (value: string) => unknown;\n\n  /**\n   * Property name for attaching model to request\n   */\n  as?: string;\n\n  /**\n   * Don't throw if model not found\n   */\n  optional?: boolean;\n\n  /**\n   * Custom 404 message\n   */\n  errorMessage?: string;\n\n  /**\n   * Validate loaded model\n   */\n  validate?: (model: unknown, req: Request) => void | Promise<void>;\n\n  /**\n   * Enable caching\n   */\n  cache?: boolean;\n\n  /**\n   * Cache TTL in milliseconds\n   */\n  cacheTTL?: number;\n}\n\n/**\n * Multi-model binding configuration\n */\nexport interface ModelBindingsConfig {\n  [paramName: string]: {\n    model: unknown;\n    options?: BindOptions;\n  };\n}\n\n/**\n * Binding operation context\n */\nexport interface BindingContext {\n  req: Request;\n  res: Response;\n  paramName: string;\n  paramValue: string;\n  model: unknown;\n  options: BindOptions;\n  adapter: IORMAdapter;\n  startTime: number;\n}\n\n/**\n * Binding operation result\n */\nexport interface BindingResult {\n  success: boolean;\n  model?: unknown;\n  error?: Error;\n  duration: number;\n  fromCache?: boolean;\n}\n\n/**\n * Model metadata for debugging\n */\nexport interface ModelMetadata {\n  name: string;\n  primaryKey: string;\n  tableName?: string;\n  relations?: string[];\n  softDeletes: boolean;\n  adapter?: string;\n  [key: string]: unknown;\n}\n\n/**\n * Cache entry structure\n */\nexport interface CacheEntry<T = unknown> {\n  value: T;\n  timestamp: number;\n  ttl: number;\n}\n\n/**\n * Global configuration options\n */\nexport interface ModelBindingGlobalConfig {\n  adapter?: IORMAdapter;\n  cache?: {\n    enabled: boolean;\n    ttl: number;\n    maxSize?: number;\n  };\n  debug?: boolean;\n  logger?: (message: string, context?: unknown) => void;\n  onError?: (error: Error, context: BindingContext) => void;\n}\n\n/**\n * Express request with bound models\n */\nexport interface TypedRequest<\n  P = Record<string, string>,\n  ResBody = unknown,\n  ReqBody = unknown,\n  ReqQuery = unknown,\n  Models extends Record<string, unknown> = Record<string, unknown>,\n> extends Request<P, ResBody, ReqBody, ReqQuery> {\n  [K: string]: unknown;\n  models?: Models;\n}\n\n/**\n * Extract model type from binding config\n */\nexport type ExtractModelType<T> = T extends { model: infer M } ? M : never;\n\n/**\n * Typed request handler\n */\nexport type TypedRequestHandler<\n  Models extends Record<string, unknown> = Record<string, unknown>,\n  P = Record<string, string>,\n  ResBody = unknown,\n  ReqBody = unknown,\n  ReqQuery = unknown,\n> = (\n  req: TypedRequest<P, ResBody, ReqBody, ReqQuery, Models>,\n  res: Response<ResBody>,\n  next: NextFunction\n) => void | Promise<void>;\n\n/**\n * Middleware function type\n */\nexport type MiddlewareFunction = RequestHandler;\n\n/**\n * Operator condition for advanced WHERE clauses\n */\nexport interface OperatorCondition {\n  operator: string;\n  value: unknown;\n}\n\n/**\n * Check if value is an operator condition\n */\nexport function isOperatorCondition(value: unknown): value is OperatorCondition {\n  return typeof value === 'object' && value !== null && 'operator' in value && 'value' in value;\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 { Knex } from 'knex';\nimport { BaseAdapter } from '../core/BaseAdapter';\nimport { QueryOptions, ModelMetadata, isOperatorCondition } from '../core/types';\nimport { BindingError } from '../errors';\nimport { isUUID } from '../utils/validators';\n\n/**\n * Model definition for Knex tables with soft delete support\n */\nexport interface KnexModel {\n  tableName: string;\n  primaryKey?: string;\n  softDeleteColumn?: string;\n}\n\n/**\n * Union type for Knex model inputs\n */\nexport type KnexModelInput = string | KnexModel;\n\n/**\n * Type guard for KnexModel\n */\nfunction isKnexModel(value: unknown): value is KnexModel {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    typeof (value as KnexModel).tableName === 'string'\n  );\n}\n\n/**\n * Adapter for Knex query builder supporting PostgreSQL, MySQL, SQLite, MSSQL, Oracle\n */\nexport class KnexAdapter extends BaseAdapter<\n  KnexModelInput,\n  Record<string, unknown>,\n  Knex.QueryBuilder\n> {\n  readonly name = 'knex';\n\n  constructor(private knex: Knex) {\n    super();\n  }\n\n  getKnex(): Knex {\n    return this.knex;\n  }\n\n  async findByKey(\n    model: KnexModelInput,\n    key: string,\n    value: unknown,\n    options: QueryOptions = {}\n  ): Promise<Record<string, unknown> | null> {\n    this.validateModel(model);\n\n    const tableName = this.getTableName(model);\n\n    try {\n      let query = this.knex(tableName);\n\n      query = query.where(key, value as Knex.Value);\n\n      if (this.supportsSoftDeletes(model) && !options.withTrashed && !options.onlyTrashed) {\n        const softDeleteColumn = this.getSoftDeleteColumn(model);\n        query = query.whereNull(softDeleteColumn);\n      } else if (options.onlyTrashed && this.supportsSoftDeletes(model)) {\n        const softDeleteColumn = this.getSoftDeleteColumn(model);\n        query = query.whereNotNull(softDeleteColumn);\n      }\n\n      if (options.where) {\n        query = this.applyWhereConditions(query, options.where);\n      }\n\n      if (options.select && options.select.length > 0) {\n        query = query.select(options.select);\n      } else {\n        query = query.select('*');\n      }\n\n      if (options.query) {\n        query = this.applyCustomQuery(\n          query,\n          options.query as (qb: Knex.QueryBuilder) => Knex.QueryBuilder\n        );\n      }\n\n      if (options.lock === 'forUpdate') {\n        query = query.forUpdate();\n      } else if (options.lock === 'forShare') {\n        query = query.forShare();\n      }\n\n      const result = await query.first();\n      return (result as Record<string, unknown>) || null;\n    } catch (error) {\n      throw new BindingError(\n        `Failed to fetch ${this.getModelName(model)}: ${(error as Error).message}`,\n        error as Error\n      );\n    }\n  }\n\n  getPrimaryKeyName(model: KnexModelInput): string {\n    if (isKnexModel(model) && model.primaryKey) {\n      return model.primaryKey;\n    }\n    return 'id';\n  }\n\n  isValidModel(model: unknown): model is KnexModelInput {\n    return typeof model === 'string' || isKnexModel(model);\n  }\n\n  transformValue(model: KnexModelInput, key: string, value: string): unknown {\n    const primaryKey = this.getPrimaryKeyName(model);\n\n    if (key === primaryKey || key === 'id') {\n      const num = parseInt(value, 10);\n      if (!isNaN(num) && num.toString() === value && Number.isSafeInteger(num)) {\n        return num;\n      }\n    }\n\n    if (isUUID(value)) {\n      return value;\n    }\n\n    return value;\n  }\n\n  supportsSoftDeletes(model: KnexModelInput): boolean {\n    return isKnexModel(model) && !!model.softDeleteColumn;\n  }\n\n  getModelMetadata(model: KnexModelInput): ModelMetadata {\n    return {\n      name: this.getModelName(model),\n      primaryKey: this.getPrimaryKeyName(model),\n      tableName: this.getTableName(model),\n      softDeletes: this.supportsSoftDeletes(model),\n      adapter: this.name,\n    };\n  }\n\n  private getTableName(model: KnexModelInput): string {\n    return typeof model === 'string' ? model : model.tableName;\n  }\n\n  private getSoftDeleteColumn(model: KnexModelInput): string {\n    if (isKnexModel(model) && model.softDeleteColumn) {\n      return model.softDeleteColumn;\n    }\n    return 'deleted_at';\n  }\n\n  protected applyWhereConditions(\n    query: Knex.QueryBuilder,\n    where: Record<string, unknown>\n  ): Knex.QueryBuilder {\n    Object.entries(where).forEach(([column, value]) => {\n      if (value === null) {\n        query = query.whereNull(column);\n      } else if (Array.isArray(value)) {\n        query = query.whereIn(column, value as Knex.Value[]);\n      } else if (isOperatorCondition(value)) {\n        query = query.where(column, value.operator, value.value as Knex.Value);\n      } else {\n        query = query.where(column, value as Knex.Value);\n      }\n    });\n    return query;\n  }\n}\n\n/**\n * Create a Knex model definition\n */\nexport function defineKnexModel(config: {\n  tableName: string;\n  primaryKey?: string;\n  softDeleteColumn?: string;\n}): KnexModel {\n  return {\n    tableName: config.tableName,\n    primaryKey: config.primaryKey || 'id',\n    softDeleteColumn: config.softDeleteColumn,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/adapters/MongooseAdapter.d.mts

@@ -0,0 +1,30 @@
+import { Model, Document, Schema, Query } from 'mongoose';
+import { b as BaseAdapter, Q as QueryOptions, d as ModelMetadata } from '../BaseAdapter-BjvLQijd.mjs';
+import 'express';
+
+/**
+ * Mongoose model type with required schema property
+ */
+interface MongooseModel extends Model<Document> {
+    schema: Schema;
+    modelName: string;
+}
+/**
+ * Mongoose query type
+ */
+type MongooseQuery = Query<Document | null, Document>;
+/**
+ * Adapter for MongoDB using Mongoose ODM
+ */
+declare class MongooseAdapter extends BaseAdapter<MongooseModel, Document, MongooseQuery> {
+    readonly name = "mongoose";
+    findByKey(model: MongooseModel, key: string, value: unknown, options?: QueryOptions): Promise<Document | null>;
+    getPrimaryKeyName(_model: MongooseModel): string;
+    isValidModel(model: unknown): model is MongooseModel;
+    transformValue(model: MongooseModel, key: string, value: string): unknown;
+    supportsSoftDeletes(model: MongooseModel): boolean;
+    getModelMetadata(model: MongooseModel): ModelMetadata;
+    protected applyIncludes(query: MongooseQuery, includes: string[] | Record<string, unknown>): MongooseQuery;
+}
+
+export { MongooseAdapter };