express-model-binding 1.0.0

package/dist/adapters/MongooseAdapter.d.ts

@@ -0,0 +1,30 @@
+import { Model, Document, Schema, Query } from 'mongoose';
+import { b as BaseAdapter, Q as QueryOptions, d as ModelMetadata } from '../BaseAdapter-BjvLQijd.js';
+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 };

package/dist/adapters/MongooseAdapter.js

@@ -0,0 +1,245 @@
+"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/MongooseAdapter.ts
+var MongooseAdapter_exports = {};
+__export(MongooseAdapter_exports, {
+  MongooseAdapter: () => MongooseAdapter
+});
+module.exports = __toCommonJS(MongooseAdapter_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/utils/validators.ts
+var OBJECT_ID_REGEX = /^[0-9a-f]{24}$/i;
+function isObjectId(value) {
+  return OBJECT_ID_REGEX.test(value);
+}
+
+// src/adapters/MongooseAdapter.ts
+function isSchemaPathType(value) {
+  return typeof value === "object" && value !== null && "instance" in value;
+}
+var MongooseAdapter = class extends BaseAdapter {
+  constructor() {
+    super(...arguments);
+    this.name = "mongoose";
+  }
+  async findByKey(model, key, value, options = {}) {
+    this.validateModel(model);
+    try {
+      const transformedValue = this.transformValue(model, key, value);
+      let query = model.findOne({ [key]: transformedValue });
+      if (options.select && options.select.length > 0) {
+        query = query.select(options.select.join(" "));
+      }
+      if (options.include) {
+        query = this.applyIncludes(query, options.include);
+      }
+      if (options.where) {
+        Object.entries(options.where).forEach(([field, val]) => {
+          query = query.where(field).equals(val);
+        });
+      }
+      if (options.query) {
+        query = this.applyCustomQuery(query, options.query);
+      }
+      const result = await query.exec();
+      if (result && this.supportsSoftDeletes(model)) {
+        const doc = result;
+        const isDeleted = doc.deleted || doc.deletedAt || doc.isDeleted;
+        if (!options.withTrashed && !options.onlyTrashed && isDeleted) {
+          return null;
+        }
+        if (options.onlyTrashed && !isDeleted) {
+          return null;
+        }
+      }
+      return result;
+    } catch (error) {
+      throw new BindingError(
+        `Failed to fetch ${model.modelName}: ${error.message}`,
+        error
+      );
+    }
+  }
+  getPrimaryKeyName(_model) {
+    return "_id";
+  }
+  isValidModel(model) {
+    if (!model || typeof model !== "function") {
+      return false;
+    }
+    const m = model;
+    return typeof m.findOne === "function" && typeof m.modelName === "string" && m.schema !== void 0;
+  }
+  transformValue(model, key, value) {
+    if (key === "_id" || key === "id") {
+      if (isObjectId(value)) {
+        try {
+          const mongoose = require("mongoose");
+          return new mongoose.Types.ObjectId(value);
+        } catch {
+          return value;
+        }
+      }
+      return value;
+    }
+    const schemaType = model.schema.path(key);
+    if (isSchemaPathType(schemaType) && schemaType.instance === "Number") {
+      const num = parseInt(value, 10);
+      if (!isNaN(num)) {
+        return num;
+      }
+    }
+    return value;
+  }
+  supportsSoftDeletes(model) {
+    const schema = model.schema;
+    return schema.path("deleted") !== void 0 || schema.path("deletedAt") !== void 0 || schema.path("isDeleted") !== void 0;
+  }
+  getModelMetadata(model) {
+    const schema = model.schema;
+    const paths = Object.keys(schema.paths);
+    return {
+      name: model.modelName,
+      primaryKey: "_id",
+      tableName: model.collection.name,
+      softDeletes: this.supportsSoftDeletes(model),
+      fields: paths,
+      adapter: this.name
+    };
+  }
+  applyIncludes(query, includes) {
+    if (Array.isArray(includes)) {
+      includes.forEach((relation) => {
+        query = query.populate(relation);
+      });
+    } else {
+      Object.entries(includes).forEach(([relation, options]) => {
+        if (typeof options === "boolean" && options) {
+          query = query.populate(relation);
+        } else if (typeof options === "object" && options !== null) {
+          query = query.populate({
+            path: relation,
+            ...options
+          });
+        }
+      });
+    }
+    return query;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MongooseAdapter
+});
+//# sourceMappingURL=MongooseAdapter.js.map

package/dist/adapters/MongooseAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/MongooseAdapter.ts","../../src/errors/index.ts","../../src/core/BaseAdapter.ts","../../src/utils/validators.ts"],"sourcesContent":["import type { Model, Document, Query, PopulateOptions, Schema } from 'mongoose';\nimport { BaseAdapter } from '../core/BaseAdapter';\nimport { QueryOptions, ModelMetadata, QueryModifier } from '../core/types';\nimport { BindingError } from '../errors';\nimport { isObjectId } from '../utils/validators';\n\n/**\n * Mongoose model type with required schema property\n */\ninterface MongooseModel extends Model<Document> {\n  schema: Schema;\n  modelName: string;\n}\n\n/**\n * Mongoose query type\n */\ntype MongooseQuery = Query<Document | null, Document>;\n\n/**\n * Type guard for Mongoose schema path\n */\ninterface SchemaPathType {\n  instance: string;\n}\n\nfunction isSchemaPathType(value: unknown): value is SchemaPathType {\n  return typeof value === 'object' && value !== null && 'instance' in value;\n}\n\n/**\n * Adapter for MongoDB using Mongoose ODM\n */\nexport class MongooseAdapter extends BaseAdapter<MongooseModel, Document, MongooseQuery> {\n  readonly name = 'mongoose';\n\n  async findByKey(\n    model: MongooseModel,\n    key: string,\n    value: unknown,\n    options: QueryOptions = {}\n  ): Promise<Document | null> {\n    this.validateModel(model);\n\n    try {\n      const transformedValue = this.transformValue(model, key, value as string);\n\n      let query: MongooseQuery = model.findOne({ [key]: transformedValue });\n\n      if (options.select && options.select.length > 0) {\n        query = query.select(options.select.join(' '));\n      }\n\n      if (options.include) {\n        query = this.applyIncludes(query, options.include);\n      }\n\n      if (options.where) {\n        Object.entries(options.where).forEach(([field, val]) => {\n          query = query.where(field).equals(val);\n        });\n      }\n\n      if (options.query) {\n        query = this.applyCustomQuery(query, options.query as QueryModifier<MongooseQuery>);\n      }\n\n      const result = await query.exec();\n\n      if (result && this.supportsSoftDeletes(model)) {\n        const doc = result as Document & {\n          deleted?: boolean;\n          deletedAt?: Date;\n          isDeleted?: boolean;\n        };\n        const isDeleted = doc.deleted || doc.deletedAt || doc.isDeleted;\n\n        if (!options.withTrashed && !options.onlyTrashed && isDeleted) {\n          return null;\n        }\n\n        if (options.onlyTrashed && !isDeleted) {\n          return null;\n        }\n      }\n\n      return result;\n    } catch (error) {\n      throw new BindingError(\n        `Failed to fetch ${model.modelName}: ${(error as Error).message}`,\n        error as Error\n      );\n    }\n  }\n\n  getPrimaryKeyName(_model: MongooseModel): string {\n    return '_id';\n  }\n\n  isValidModel(model: unknown): model is MongooseModel {\n    if (!model || typeof model !== 'function') {\n      return false;\n    }\n    const m = model as Partial<MongooseModel>;\n    return (\n      typeof m.findOne === 'function' && typeof m.modelName === 'string' && m.schema !== undefined\n    );\n  }\n\n  transformValue(model: MongooseModel, key: string, value: string): unknown {\n    if (key === '_id' || key === 'id') {\n      if (isObjectId(value)) {\n        try {\n          // Mongoose must be loaded synchronously for ObjectId construction\n          // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires\n          const mongoose = require('mongoose');\n          return new mongoose.Types.ObjectId(value);\n        } catch {\n          return value;\n        }\n      }\n      return value;\n    }\n\n    const schemaType = model.schema.path(key);\n    if (isSchemaPathType(schemaType) && schemaType.instance === 'Number') {\n      const num = parseInt(value, 10);\n      if (!isNaN(num)) {\n        return num;\n      }\n    }\n\n    return value;\n  }\n\n  supportsSoftDeletes(model: MongooseModel): boolean {\n    const schema = model.schema;\n    return (\n      schema.path('deleted') !== undefined ||\n      schema.path('deletedAt') !== undefined ||\n      schema.path('isDeleted') !== undefined\n    );\n  }\n\n  getModelMetadata(model: MongooseModel): ModelMetadata {\n    const schema = model.schema;\n    const paths = Object.keys(schema.paths);\n\n    return {\n      name: model.modelName,\n      primaryKey: '_id',\n      tableName: model.collection.name,\n      softDeletes: this.supportsSoftDeletes(model),\n      fields: paths,\n      adapter: this.name,\n    };\n  }\n\n  protected applyIncludes(\n    query: MongooseQuery,\n    includes: string[] | Record<string, unknown>\n  ): MongooseQuery {\n    if (Array.isArray(includes)) {\n      includes.forEach(relation => {\n        query = query.populate(relation);\n      });\n    } else {\n      Object.entries(includes).forEach(([relation, options]) => {\n        if (typeof options === 'boolean' && options) {\n          query = query.populate(relation);\n        } else if (typeof options === 'object' && options !== null) {\n          query = query.populate({\n            path: relation,\n            ...options,\n          } as PopulateOptions);\n        }\n      });\n    }\n    return query;\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","/**\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/MongooseAdapter.mjs

@@ -0,0 +1,225 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// 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/utils/validators.ts
+var OBJECT_ID_REGEX = /^[0-9a-f]{24}$/i;
+function isObjectId(value) {
+  return OBJECT_ID_REGEX.test(value);
+}
+
+// src/adapters/MongooseAdapter.ts
+function isSchemaPathType(value) {
+  return typeof value === "object" && value !== null && "instance" in value;
+}
+var MongooseAdapter = class extends BaseAdapter {
+  constructor() {
+    super(...arguments);
+    this.name = "mongoose";
+  }
+  async findByKey(model, key, value, options = {}) {
+    this.validateModel(model);
+    try {
+      const transformedValue = this.transformValue(model, key, value);
+      let query = model.findOne({ [key]: transformedValue });
+      if (options.select && options.select.length > 0) {
+        query = query.select(options.select.join(" "));
+      }
+      if (options.include) {
+        query = this.applyIncludes(query, options.include);
+      }
+      if (options.where) {
+        Object.entries(options.where).forEach(([field, val]) => {
+          query = query.where(field).equals(val);
+        });
+      }
+      if (options.query) {
+        query = this.applyCustomQuery(query, options.query);
+      }
+      const result = await query.exec();
+      if (result && this.supportsSoftDeletes(model)) {
+        const doc = result;
+        const isDeleted = doc.deleted || doc.deletedAt || doc.isDeleted;
+        if (!options.withTrashed && !options.onlyTrashed && isDeleted) {
+          return null;
+        }
+        if (options.onlyTrashed && !isDeleted) {
+          return null;
+        }
+      }
+      return result;
+    } catch (error) {
+      throw new BindingError(
+        `Failed to fetch ${model.modelName}: ${error.message}`,
+        error
+      );
+    }
+  }
+  getPrimaryKeyName(_model) {
+    return "_id";
+  }
+  isValidModel(model) {
+    if (!model || typeof model !== "function") {
+      return false;
+    }
+    const m = model;
+    return typeof m.findOne === "function" && typeof m.modelName === "string" && m.schema !== void 0;
+  }
+  transformValue(model, key, value) {
+    if (key === "_id" || key === "id") {
+      if (isObjectId(value)) {
+        try {
+          const mongoose = __require("mongoose");
+          return new mongoose.Types.ObjectId(value);
+        } catch {
+          return value;
+        }
+      }
+      return value;
+    }
+    const schemaType = model.schema.path(key);
+    if (isSchemaPathType(schemaType) && schemaType.instance === "Number") {
+      const num = parseInt(value, 10);
+      if (!isNaN(num)) {
+        return num;
+      }
+    }
+    return value;
+  }
+  supportsSoftDeletes(model) {
+    const schema = model.schema;
+    return schema.path("deleted") !== void 0 || schema.path("deletedAt") !== void 0 || schema.path("isDeleted") !== void 0;
+  }
+  getModelMetadata(model) {
+    const schema = model.schema;
+    const paths = Object.keys(schema.paths);
+    return {
+      name: model.modelName,
+      primaryKey: "_id",
+      tableName: model.collection.name,
+      softDeletes: this.supportsSoftDeletes(model),
+      fields: paths,
+      adapter: this.name
+    };
+  }
+  applyIncludes(query, includes) {
+    if (Array.isArray(includes)) {
+      includes.forEach((relation) => {
+        query = query.populate(relation);
+      });
+    } else {
+      Object.entries(includes).forEach(([relation, options]) => {
+        if (typeof options === "boolean" && options) {
+          query = query.populate(relation);
+        } else if (typeof options === "object" && options !== null) {
+          query = query.populate({
+            path: relation,
+            ...options
+          });
+        }
+      });
+    }
+    return query;
+  }
+};
+export {
+  MongooseAdapter
+};
+//# sourceMappingURL=MongooseAdapter.mjs.map

package/dist/adapters/MongooseAdapter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/errors/index.ts","../../src/core/BaseAdapter.ts","../../src/utils/validators.ts","../../src/adapters/MongooseAdapter.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 { Model, Document, Query, PopulateOptions, Schema } from 'mongoose';\nimport { BaseAdapter } from '../core/BaseAdapter';\nimport { QueryOptions, ModelMetadata, QueryModifier } from '../core/types';\nimport { BindingError } from '../errors';\nimport { isObjectId } from '../utils/validators';\n\n/**\n * Mongoose model type with required schema property\n */\ninterface MongooseModel extends Model<Document> {\n  schema: Schema;\n  modelName: string;\n}\n\n/**\n * Mongoose query type\n */\ntype MongooseQuery = Query<Document | null, Document>;\n\n/**\n * Type guard for Mongoose schema path\n */\ninterface SchemaPathType {\n  instance: string;\n}\n\nfunction isSchemaPathType(value: unknown): value is SchemaPathType {\n  return typeof value === 'object' && value !== null && 'instance' in value;\n}\n\n/**\n * Adapter for MongoDB using Mongoose ODM\n */\nexport class MongooseAdapter extends BaseAdapter<MongooseModel, Document, MongooseQuery> {\n  readonly name = 'mongoose';\n\n  async findByKey(\n    model: MongooseModel,\n    key: string,\n    value: unknown,\n    options: QueryOptions = {}\n  ): Promise<Document | null> {\n    this.validateModel(model);\n\n    try {\n      const transformedValue = this.transformValue(model, key, value as string);\n\n      let query: MongooseQuery = model.findOne({ [key]: transformedValue });\n\n      if (options.select && options.select.length > 0) {\n        query = query.select(options.select.join(' '));\n      }\n\n      if (options.include) {\n        query = this.applyIncludes(query, options.include);\n      }\n\n      if (options.where) {\n        Object.entries(options.where).forEach(([field, val]) => {\n          query = query.where(field).equals(val);\n        });\n      }\n\n      if (options.query) {\n        query = this.applyCustomQuery(query, options.query as QueryModifier<MongooseQuery>);\n      }\n\n      const result = await query.exec();\n\n      if (result && this.supportsSoftDeletes(model)) {\n        const doc = result as Document & {\n          deleted?: boolean;\n          deletedAt?: Date;\n          isDeleted?: boolean;\n        };\n        const isDeleted = doc.deleted || doc.deletedAt || doc.isDeleted;\n\n        if (!options.withTrashed && !options.onlyTrashed && isDeleted) {\n          return null;\n        }\n\n        if (options.onlyTrashed && !isDeleted) {\n          return null;\n        }\n      }\n\n      return result;\n    } catch (error) {\n      throw new BindingError(\n        `Failed to fetch ${model.modelName}: ${(error as Error).message}`,\n        error as Error\n      );\n    }\n  }\n\n  getPrimaryKeyName(_model: MongooseModel): string {\n    return '_id';\n  }\n\n  isValidModel(model: unknown): model is MongooseModel {\n    if (!model || typeof model !== 'function') {\n      return false;\n    }\n    const m = model as Partial<MongooseModel>;\n    return (\n      typeof m.findOne === 'function' && typeof m.modelName === 'string' && m.schema !== undefined\n    );\n  }\n\n  transformValue(model: MongooseModel, key: string, value: string): unknown {\n    if (key === '_id' || key === 'id') {\n      if (isObjectId(value)) {\n        try {\n          // Mongoose must be loaded synchronously for ObjectId construction\n          // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires\n          const mongoose = require('mongoose');\n          return new mongoose.Types.ObjectId(value);\n        } catch {\n          return value;\n        }\n      }\n      return value;\n    }\n\n    const schemaType = model.schema.path(key);\n    if (isSchemaPathType(schemaType) && schemaType.instance === 'Number') {\n      const num = parseInt(value, 10);\n      if (!isNaN(num)) {\n        return num;\n      }\n    }\n\n    return value;\n  }\n\n  supportsSoftDeletes(model: MongooseModel): boolean {\n    const schema = model.schema;\n    return (\n      schema.path('deleted') !== undefined ||\n      schema.path('deletedAt') !== undefined ||\n      schema.path('isDeleted') !== undefined\n    );\n  }\n\n  getModelMetadata(model: MongooseModel): ModelMetadata {\n    const schema = model.schema;\n    const paths = Object.keys(schema.paths);\n\n    return {\n      name: model.modelName,\n      primaryKey: '_id',\n      tableName: model.collection.name,\n      softDeletes: this.supportsSoftDeletes(model),\n      fields: paths,\n      adapter: this.name,\n    };\n  }\n\n  protected applyIncludes(\n    query: MongooseQuery,\n    includes: string[] | Record<string, unknown>\n  ): MongooseQuery {\n    if (Array.isArray(includes)) {\n      includes.forEach(relation => {\n        query = query.populate(relation);\n      });\n    } else {\n      Object.entries(includes).forEach(([relation, options]) => {\n        if (typeof options === 'boolean' && options) {\n          query = query.populate(relation);\n        } else if (typeof options === 'object' && options !== null) {\n          query = query.populate({\n            path: relation,\n            ...options,\n          } as PopulateOptions);\n        }\n      });\n    }\n    return query;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/adapters/PrismaAdapter.d.mts

@@ -0,0 +1,42 @@
+import { b as BaseAdapter, Q as QueryOptions, d as ModelMetadata } from '../BaseAdapter-BjvLQijd.mjs';
+import 'express';
+
+/**
+ * Prisma model delegate (dynamic accessor on PrismaClient)
+ */
+interface PrismaModelDelegate {
+    findUnique: (args: PrismaFindArgs) => Promise<unknown>;
+    findFirst: (args: PrismaFindArgs) => Promise<unknown>;
+}
+/**
+ * Prisma find operation arguments
+ */
+interface PrismaFindArgs {
+    where: Record<string, unknown>;
+    select?: Record<string, boolean>;
+    include?: Record<string, unknown>;
+}
+/**
+ * Prisma client interface (minimal required methods)
+ */
+interface PrismaClientLike {
+    [modelName: string]: PrismaModelDelegate | ((...args: unknown[]) => unknown);
+}
+/**
+ * Adapter for Prisma ORM with type-safe database access
+ */
+declare class PrismaAdapter extends BaseAdapter<string, unknown, PrismaFindArgs> {
+    private prisma;
+    readonly name = "prisma";
+    constructor(prisma: PrismaClientLike);
+    getPrisma(): PrismaClientLike;
+    findByKey(modelName: string, key: string, value: unknown, options?: QueryOptions): Promise<unknown>;
+    getPrimaryKeyName(_modelName: string): string;
+    isValidModel(modelName: unknown): modelName is string;
+    transformValue(_modelName: string, key: string, value: string): unknown;
+    supportsSoftDeletes(_modelName: string): boolean;
+    getModelMetadata(modelName: string): ModelMetadata;
+    private buildIncludeOptions;
+}
+
+export { PrismaAdapter };

package/dist/adapters/PrismaAdapter.d.ts

@@ -0,0 +1,42 @@
+import { b as BaseAdapter, Q as QueryOptions, d as ModelMetadata } from '../BaseAdapter-BjvLQijd.js';
+import 'express';
+
+/**
+ * Prisma model delegate (dynamic accessor on PrismaClient)
+ */
+interface PrismaModelDelegate {
+    findUnique: (args: PrismaFindArgs) => Promise<unknown>;
+    findFirst: (args: PrismaFindArgs) => Promise<unknown>;
+}
+/**
+ * Prisma find operation arguments
+ */
+interface PrismaFindArgs {
+    where: Record<string, unknown>;
+    select?: Record<string, boolean>;
+    include?: Record<string, unknown>;
+}
+/**
+ * Prisma client interface (minimal required methods)
+ */
+interface PrismaClientLike {
+    [modelName: string]: PrismaModelDelegate | ((...args: unknown[]) => unknown);
+}
+/**
+ * Adapter for Prisma ORM with type-safe database access
+ */
+declare class PrismaAdapter extends BaseAdapter<string, unknown, PrismaFindArgs> {
+    private prisma;
+    readonly name = "prisma";
+    constructor(prisma: PrismaClientLike);
+    getPrisma(): PrismaClientLike;
+    findByKey(modelName: string, key: string, value: unknown, options?: QueryOptions): Promise<unknown>;
+    getPrimaryKeyName(_modelName: string): string;
+    isValidModel(modelName: unknown): modelName is string;
+    transformValue(_modelName: string, key: string, value: string): unknown;
+    supportsSoftDeletes(_modelName: string): boolean;
+    getModelMetadata(modelName: string): ModelMetadata;
+    private buildIncludeOptions;
+}
+
+export { PrismaAdapter };