express-model-binding 1.0.0

package/dist/adapters/PrismaAdapter.js

@@ -0,0 +1,247 @@
+"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/PrismaAdapter.ts
+var PrismaAdapter_exports = {};
+__export(PrismaAdapter_exports, {
+  PrismaAdapter: () => PrismaAdapter
+});
+module.exports = __toCommonJS(PrismaAdapter_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 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/PrismaAdapter.ts
+var PrismaAdapter = class extends BaseAdapter {
+  constructor(prisma) {
+    super();
+    this.prisma = prisma;
+    this.name = "prisma";
+  }
+  getPrisma() {
+    return this.prisma;
+  }
+  async findByKey(modelName, key, value, options = {}) {
+    this.validateModel(modelName);
+    try {
+      const model = this.prisma[modelName];
+      if (!model) {
+        throw new InvalidModelError(`Model '${modelName}' not found in Prisma schema`, modelName);
+      }
+      const transformedValue = this.transformValue(modelName, key, value);
+      const queryOptions = {
+        where: { [key]: transformedValue }
+      };
+      if (options.where) {
+        queryOptions.where = {
+          ...queryOptions.where,
+          ...options.where
+        };
+      }
+      if (options.select && options.select.length > 0) {
+        queryOptions.select = options.select.reduce((acc, field) => {
+          acc[field] = true;
+          return acc;
+        }, {});
+      }
+      if (options.include) {
+        queryOptions.include = this.buildIncludeOptions(options.include);
+        delete queryOptions.select;
+      }
+      if (options.query) {
+        options.query(queryOptions);
+      }
+      let result = null;
+      try {
+        result = await model.findUnique(queryOptions);
+      } catch {
+        result = await model.findFirst(queryOptions);
+      }
+      if (!result && key !== this.getPrimaryKeyName(modelName)) {
+        result = await model.findFirst(queryOptions);
+      }
+      return result;
+    } catch (error) {
+      if (error instanceof InvalidModelError) {
+        throw error;
+      }
+      throw new BindingError(
+        `Failed to fetch ${modelName}: ${error.message}`,
+        error
+      );
+    }
+  }
+  getPrimaryKeyName(_modelName) {
+    return "id";
+  }
+  isValidModel(modelName) {
+    if (typeof modelName !== "string") {
+      return false;
+    }
+    if (modelName.startsWith("$")) {
+      return false;
+    }
+    return !!this.prisma[modelName];
+  }
+  transformValue(_modelName, key, value) {
+    if (key === "id" || key.endsWith("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(_modelName) {
+    return false;
+  }
+  getModelMetadata(modelName) {
+    return {
+      name: modelName,
+      primaryKey: this.getPrimaryKeyName(modelName),
+      softDeletes: false,
+      adapter: this.name
+    };
+  }
+  buildIncludeOptions(includes) {
+    if (Array.isArray(includes)) {
+      return includes.reduce((acc, relation) => {
+        acc[relation] = true;
+        return acc;
+      }, {});
+    }
+    return Object.entries(includes).reduce((acc, [relation, opts]) => {
+      if (typeof opts === "boolean") {
+        acc[relation] = opts;
+      } else if (typeof opts === "object" && opts !== null) {
+        const nestedOpts = opts;
+        acc[relation] = {
+          ...nestedOpts,
+          include: nestedOpts.include ? this.buildIncludeOptions(nestedOpts.include) : void 0
+        };
+      }
+      return acc;
+    }, {});
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PrismaAdapter
+});
+//# sourceMappingURL=PrismaAdapter.js.map

package/dist/adapters/PrismaAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/PrismaAdapter.ts","../../src/errors/index.ts","../../src/core/BaseAdapter.ts","../../src/utils/validators.ts"],"sourcesContent":["import { BaseAdapter } from '../core/BaseAdapter';\nimport { QueryOptions, ModelMetadata, QueryModifier } from '../core/types';\nimport { InvalidModelError, BindingError } from '../errors';\nimport { isUUID } from '../utils/validators';\n\n/**\n * Prisma model delegate (dynamic accessor on PrismaClient)\n */\ninterface PrismaModelDelegate {\n  findUnique: (args: PrismaFindArgs) => Promise<unknown>;\n  findFirst: (args: PrismaFindArgs) => Promise<unknown>;\n}\n\n/**\n * Prisma find operation arguments\n */\ninterface PrismaFindArgs {\n  where: Record<string, unknown>;\n  select?: Record<string, boolean>;\n  include?: Record<string, unknown>;\n}\n\n/**\n * Prisma client interface (minimal required methods)\n */\ninterface PrismaClientLike {\n  [modelName: string]: PrismaModelDelegate | ((...args: unknown[]) => unknown);\n}\n\n/**\n * Adapter for Prisma ORM with type-safe database access\n */\nexport class PrismaAdapter extends BaseAdapter<string, unknown, PrismaFindArgs> {\n  readonly name = 'prisma';\n\n  constructor(private prisma: PrismaClientLike) {\n    super();\n  }\n\n  getPrisma(): PrismaClientLike {\n    return this.prisma;\n  }\n\n  async findByKey(\n    modelName: string,\n    key: string,\n    value: unknown,\n    options: QueryOptions = {}\n  ): Promise<unknown> {\n    this.validateModel(modelName);\n\n    try {\n      const model = this.prisma[modelName] as PrismaModelDelegate;\n\n      if (!model) {\n        throw new InvalidModelError(`Model '${modelName}' not found in Prisma schema`, modelName);\n      }\n\n      const transformedValue = this.transformValue(modelName, key, value as string);\n\n      const queryOptions: PrismaFindArgs = {\n        where: { [key]: transformedValue },\n      };\n\n      if (options.where) {\n        queryOptions.where = {\n          ...queryOptions.where,\n          ...options.where,\n        };\n      }\n\n      if (options.select && options.select.length > 0) {\n        queryOptions.select = options.select.reduce<Record<string, boolean>>((acc, field) => {\n          acc[field] = true;\n          return acc;\n        }, {});\n      }\n\n      if (options.include) {\n        queryOptions.include = this.buildIncludeOptions(options.include);\n        delete queryOptions.select;\n      }\n\n      if (options.query) {\n        (options.query as QueryModifier<PrismaFindArgs>)(queryOptions);\n      }\n\n      let result: unknown = null;\n      try {\n        result = await model.findUnique(queryOptions);\n      } catch {\n        result = await model.findFirst(queryOptions);\n      }\n\n      if (!result && key !== this.getPrimaryKeyName(modelName)) {\n        result = await model.findFirst(queryOptions);\n      }\n\n      return result;\n    } catch (error) {\n      if (error instanceof InvalidModelError) {\n        throw error;\n      }\n      throw new BindingError(\n        `Failed to fetch ${modelName}: ${(error as Error).message}`,\n        error as Error\n      );\n    }\n  }\n\n  getPrimaryKeyName(_modelName: string): string {\n    return 'id';\n  }\n\n  isValidModel(modelName: unknown): modelName is string {\n    if (typeof modelName !== 'string') {\n      return false;\n    }\n\n    if (modelName.startsWith('$')) {\n      return false;\n    }\n\n    return !!this.prisma[modelName];\n  }\n\n  transformValue(_modelName: string, key: string, value: string): unknown {\n    if (key === 'id' || key.endsWith('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(_modelName: string): boolean {\n    return false;\n  }\n\n  getModelMetadata(modelName: string): ModelMetadata {\n    return {\n      name: modelName,\n      primaryKey: this.getPrimaryKeyName(modelName),\n      softDeletes: false,\n      adapter: this.name,\n    };\n  }\n\n  private buildIncludeOptions(\n    includes: string[] | Record<string, unknown>\n  ): Record<string, unknown> {\n    if (Array.isArray(includes)) {\n      return includes.reduce<Record<string, boolean>>((acc, relation) => {\n        acc[relation] = true;\n        return acc;\n      }, {});\n    }\n\n    return Object.entries(includes).reduce<Record<string, unknown>>((acc, [relation, opts]) => {\n      if (typeof opts === 'boolean') {\n        acc[relation] = opts;\n      } else if (typeof opts === 'object' && opts !== null) {\n        const nestedOpts = opts as Record<string, unknown>;\n        acc[relation] = {\n          ...nestedOpts,\n          include: nestedOpts.include\n            ? this.buildIncludeOptions(nestedOpts.include as string[] | Record<string, unknown>)\n            : undefined,\n        };\n      }\n      return acc;\n    }, {});\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/PrismaAdapter.mjs

@@ -0,0 +1,220 @@
+// 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 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/PrismaAdapter.ts
+var PrismaAdapter = class extends BaseAdapter {
+  constructor(prisma) {
+    super();
+    this.prisma = prisma;
+    this.name = "prisma";
+  }
+  getPrisma() {
+    return this.prisma;
+  }
+  async findByKey(modelName, key, value, options = {}) {
+    this.validateModel(modelName);
+    try {
+      const model = this.prisma[modelName];
+      if (!model) {
+        throw new InvalidModelError(`Model '${modelName}' not found in Prisma schema`, modelName);
+      }
+      const transformedValue = this.transformValue(modelName, key, value);
+      const queryOptions = {
+        where: { [key]: transformedValue }
+      };
+      if (options.where) {
+        queryOptions.where = {
+          ...queryOptions.where,
+          ...options.where
+        };
+      }
+      if (options.select && options.select.length > 0) {
+        queryOptions.select = options.select.reduce((acc, field) => {
+          acc[field] = true;
+          return acc;
+        }, {});
+      }
+      if (options.include) {
+        queryOptions.include = this.buildIncludeOptions(options.include);
+        delete queryOptions.select;
+      }
+      if (options.query) {
+        options.query(queryOptions);
+      }
+      let result = null;
+      try {
+        result = await model.findUnique(queryOptions);
+      } catch {
+        result = await model.findFirst(queryOptions);
+      }
+      if (!result && key !== this.getPrimaryKeyName(modelName)) {
+        result = await model.findFirst(queryOptions);
+      }
+      return result;
+    } catch (error) {
+      if (error instanceof InvalidModelError) {
+        throw error;
+      }
+      throw new BindingError(
+        `Failed to fetch ${modelName}: ${error.message}`,
+        error
+      );
+    }
+  }
+  getPrimaryKeyName(_modelName) {
+    return "id";
+  }
+  isValidModel(modelName) {
+    if (typeof modelName !== "string") {
+      return false;
+    }
+    if (modelName.startsWith("$")) {
+      return false;
+    }
+    return !!this.prisma[modelName];
+  }
+  transformValue(_modelName, key, value) {
+    if (key === "id" || key.endsWith("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(_modelName) {
+    return false;
+  }
+  getModelMetadata(modelName) {
+    return {
+      name: modelName,
+      primaryKey: this.getPrimaryKeyName(modelName),
+      softDeletes: false,
+      adapter: this.name
+    };
+  }
+  buildIncludeOptions(includes) {
+    if (Array.isArray(includes)) {
+      return includes.reduce((acc, relation) => {
+        acc[relation] = true;
+        return acc;
+      }, {});
+    }
+    return Object.entries(includes).reduce((acc, [relation, opts]) => {
+      if (typeof opts === "boolean") {
+        acc[relation] = opts;
+      } else if (typeof opts === "object" && opts !== null) {
+        const nestedOpts = opts;
+        acc[relation] = {
+          ...nestedOpts,
+          include: nestedOpts.include ? this.buildIncludeOptions(nestedOpts.include) : void 0
+        };
+      }
+      return acc;
+    }, {});
+  }
+};
+export {
+  PrismaAdapter
+};
+//# sourceMappingURL=PrismaAdapter.mjs.map

package/dist/adapters/PrismaAdapter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/errors/index.ts","../../src/core/BaseAdapter.ts","../../src/utils/validators.ts","../../src/adapters/PrismaAdapter.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 { BaseAdapter } from '../core/BaseAdapter';\nimport { QueryOptions, ModelMetadata, QueryModifier } from '../core/types';\nimport { InvalidModelError, BindingError } from '../errors';\nimport { isUUID } from '../utils/validators';\n\n/**\n * Prisma model delegate (dynamic accessor on PrismaClient)\n */\ninterface PrismaModelDelegate {\n  findUnique: (args: PrismaFindArgs) => Promise<unknown>;\n  findFirst: (args: PrismaFindArgs) => Promise<unknown>;\n}\n\n/**\n * Prisma find operation arguments\n */\ninterface PrismaFindArgs {\n  where: Record<string, unknown>;\n  select?: Record<string, boolean>;\n  include?: Record<string, unknown>;\n}\n\n/**\n * Prisma client interface (minimal required methods)\n */\ninterface PrismaClientLike {\n  [modelName: string]: PrismaModelDelegate | ((...args: unknown[]) => unknown);\n}\n\n/**\n * Adapter for Prisma ORM with type-safe database access\n */\nexport class PrismaAdapter extends BaseAdapter<string, unknown, PrismaFindArgs> {\n  readonly name = 'prisma';\n\n  constructor(private prisma: PrismaClientLike) {\n    super();\n  }\n\n  getPrisma(): PrismaClientLike {\n    return this.prisma;\n  }\n\n  async findByKey(\n    modelName: string,\n    key: string,\n    value: unknown,\n    options: QueryOptions = {}\n  ): Promise<unknown> {\n    this.validateModel(modelName);\n\n    try {\n      const model = this.prisma[modelName] as PrismaModelDelegate;\n\n      if (!model) {\n        throw new InvalidModelError(`Model '${modelName}' not found in Prisma schema`, modelName);\n      }\n\n      const transformedValue = this.transformValue(modelName, key, value as string);\n\n      const queryOptions: PrismaFindArgs = {\n        where: { [key]: transformedValue },\n      };\n\n      if (options.where) {\n        queryOptions.where = {\n          ...queryOptions.where,\n          ...options.where,\n        };\n      }\n\n      if (options.select && options.select.length > 0) {\n        queryOptions.select = options.select.reduce<Record<string, boolean>>((acc, field) => {\n          acc[field] = true;\n          return acc;\n        }, {});\n      }\n\n      if (options.include) {\n        queryOptions.include = this.buildIncludeOptions(options.include);\n        delete queryOptions.select;\n      }\n\n      if (options.query) {\n        (options.query as QueryModifier<PrismaFindArgs>)(queryOptions);\n      }\n\n      let result: unknown = null;\n      try {\n        result = await model.findUnique(queryOptions);\n      } catch {\n        result = await model.findFirst(queryOptions);\n      }\n\n      if (!result && key !== this.getPrimaryKeyName(modelName)) {\n        result = await model.findFirst(queryOptions);\n      }\n\n      return result;\n    } catch (error) {\n      if (error instanceof InvalidModelError) {\n        throw error;\n      }\n      throw new BindingError(\n        `Failed to fetch ${modelName}: ${(error as Error).message}`,\n        error as Error\n      );\n    }\n  }\n\n  getPrimaryKeyName(_modelName: string): string {\n    return 'id';\n  }\n\n  isValidModel(modelName: unknown): modelName is string {\n    if (typeof modelName !== 'string') {\n      return false;\n    }\n\n    if (modelName.startsWith('$')) {\n      return false;\n    }\n\n    return !!this.prisma[modelName];\n  }\n\n  transformValue(_modelName: string, key: string, value: string): unknown {\n    if (key === 'id' || key.endsWith('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(_modelName: string): boolean {\n    return false;\n  }\n\n  getModelMetadata(modelName: string): ModelMetadata {\n    return {\n      name: modelName,\n      primaryKey: this.getPrimaryKeyName(modelName),\n      softDeletes: false,\n      adapter: this.name,\n    };\n  }\n\n  private buildIncludeOptions(\n    includes: string[] | Record<string, unknown>\n  ): Record<string, unknown> {\n    if (Array.isArray(includes)) {\n      return includes.reduce<Record<string, boolean>>((acc, relation) => {\n        acc[relation] = true;\n        return acc;\n      }, {});\n    }\n\n    return Object.entries(includes).reduce<Record<string, unknown>>((acc, [relation, opts]) => {\n      if (typeof opts === 'boolean') {\n        acc[relation] = opts;\n      } else if (typeof opts === 'object' && opts !== null) {\n        const nestedOpts = opts as Record<string, unknown>;\n        acc[relation] = {\n          ...nestedOpts,\n          include: nestedOpts.include\n            ? this.buildIncludeOptions(nestedOpts.include as string[] | Record<string, unknown>)\n            : undefined,\n        };\n      }\n      return acc;\n    }, {});\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/adapters/SequelizeAdapter.d.mts

@@ -0,0 +1,27 @@
+import { ModelStatic, Model, FindOptions, Sequelize } from 'sequelize';
+import { b as BaseAdapter, Q as QueryOptions, d as ModelMetadata } from '../BaseAdapter-BjvLQijd.mjs';
+import 'express';
+
+/**
+ * Sequelize model static type
+ */
+type SequelizeModelStatic = ModelStatic<Model>;
+/**
+ * Adapter for Sequelize ORM supporting PostgreSQL, MySQL, SQLite, MSSQL
+ */
+declare class SequelizeAdapter extends BaseAdapter<SequelizeModelStatic, Model, FindOptions> {
+    private sequelize;
+    readonly name = "sequelize";
+    constructor(sequelize: Sequelize);
+    getSequelize(): Sequelize;
+    findByKey(model: SequelizeModelStatic, key: string, value: unknown, options?: QueryOptions): Promise<Model | null>;
+    getPrimaryKeyName(model: SequelizeModelStatic): string;
+    isValidModel(model: unknown): model is SequelizeModelStatic;
+    transformValue(model: SequelizeModelStatic, key: string, value: string): unknown;
+    supportsSoftDeletes(model: SequelizeModelStatic): boolean;
+    getModelMetadata(model: SequelizeModelStatic): ModelMetadata;
+    private buildIncludes;
+    private findWithCustomQuery;
+}
+
+export { SequelizeAdapter };

package/dist/adapters/SequelizeAdapter.d.ts

@@ -0,0 +1,27 @@
+import { ModelStatic, Model, FindOptions, Sequelize } from 'sequelize';
+import { b as BaseAdapter, Q as QueryOptions, d as ModelMetadata } from '../BaseAdapter-BjvLQijd.js';
+import 'express';
+
+/**
+ * Sequelize model static type
+ */
+type SequelizeModelStatic = ModelStatic<Model>;
+/**
+ * Adapter for Sequelize ORM supporting PostgreSQL, MySQL, SQLite, MSSQL
+ */
+declare class SequelizeAdapter extends BaseAdapter<SequelizeModelStatic, Model, FindOptions> {
+    private sequelize;
+    readonly name = "sequelize";
+    constructor(sequelize: Sequelize);
+    getSequelize(): Sequelize;
+    findByKey(model: SequelizeModelStatic, key: string, value: unknown, options?: QueryOptions): Promise<Model | null>;
+    getPrimaryKeyName(model: SequelizeModelStatic): string;
+    isValidModel(model: unknown): model is SequelizeModelStatic;
+    transformValue(model: SequelizeModelStatic, key: string, value: string): unknown;
+    supportsSoftDeletes(model: SequelizeModelStatic): boolean;
+    getModelMetadata(model: SequelizeModelStatic): ModelMetadata;
+    private buildIncludes;
+    private findWithCustomQuery;
+}
+
+export { SequelizeAdapter };