express-model-binding 1.0.0

package/dist/adapters/SequelizeAdapter.js

@@ -0,0 +1,280 @@
+"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/SequelizeAdapter.ts
+var SequelizeAdapter_exports = {};
+__export(SequelizeAdapter_exports, {
+  SequelizeAdapter: () => SequelizeAdapter
+});
+module.exports = __toCommonJS(SequelizeAdapter_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/SequelizeAdapter.ts
+function isSequelizeModel(model) {
+  if (!model || typeof model !== "function") {
+    return false;
+  }
+  const m = model;
+  return typeof m.findOne === "function" && typeof m.findAll === "function" && typeof m.rawAttributes === "object";
+}
+var SequelizeAdapter = class extends BaseAdapter {
+  constructor(sequelize) {
+    super();
+    this.sequelize = sequelize;
+    this.name = "sequelize";
+  }
+  getSequelize() {
+    return this.sequelize;
+  }
+  async findByKey(model, key, value, options = {}) {
+    this.validateModel(model);
+    try {
+      const transformedValue = this.transformValue(model, key, value);
+      const findOptions = {
+        where: { [key]: transformedValue }
+      };
+      if (options.select && options.select.length > 0) {
+        findOptions.attributes = options.select;
+      }
+      if (options.include) {
+        findOptions.include = this.buildIncludes(options.include);
+      }
+      if (options.where) {
+        findOptions.where = {
+          ...findOptions.where,
+          ...options.where
+        };
+      }
+      const isParanoid = model.options?.paranoid;
+      if (isParanoid) {
+        if (options.withTrashed) {
+          findOptions.paranoid = false;
+        } else if (options.onlyTrashed) {
+          findOptions.paranoid = false;
+          const { Op: SeqOp } = require("sequelize");
+          const whereClause = findOptions.where;
+          whereClause.deletedAt = { [SeqOp.ne]: null };
+        }
+      }
+      if (options.lock === "forUpdate") {
+        findOptions.lock = true;
+      } else if (options.lock === "forShare") {
+        const { Transaction: SeqTransaction } = require("sequelize");
+        findOptions.lock = SeqTransaction.LOCK.SHARE;
+      }
+      let result = await model.findOne(findOptions);
+      if (options.query && !result) {
+        result = await this.findWithCustomQuery(model, key, transformedValue, options);
+      }
+      return result;
+    } catch (error) {
+      throw new BindingError(
+        `Failed to fetch ${model.name}: ${error.message}`,
+        error
+      );
+    }
+  }
+  getPrimaryKeyName(model) {
+    return model.primaryKeyAttribute || "id";
+  }
+  isValidModel(model) {
+    return isSequelizeModel(model);
+  }
+  transformValue(model, key, value) {
+    const attributes = model.rawAttributes;
+    const attribute = attributes?.[key];
+    if (!attribute) {
+      if (isUUID(value)) {
+        return value;
+      }
+      const num = parseInt(value, 10);
+      if (!isNaN(num) && num.toString() === value) {
+        return num;
+      }
+      return value;
+    }
+    const attrType = attribute.type;
+    const type = attrType?.constructor?.name || String(attrType);
+    switch (type) {
+      case "INTEGER":
+      case "BIGINT":
+      case "SMALLINT": {
+        const intNum = parseInt(value, 10);
+        return isNaN(intNum) ? value : intNum;
+      }
+      case "FLOAT":
+      case "DOUBLE":
+      case "DECIMAL": {
+        const floatNum = parseFloat(value);
+        return isNaN(floatNum) ? value : floatNum;
+      }
+      case "BOOLEAN":
+        return value === "true" || value === "1";
+      case "UUID":
+        return value;
+      default:
+        return value;
+    }
+  }
+  supportsSoftDeletes(model) {
+    return !!model.options?.paranoid;
+  }
+  getModelMetadata(model) {
+    const tableName = model.tableName || model.name;
+    const associations = Object.keys(model.associations || {});
+    return {
+      name: model.name,
+      primaryKey: this.getPrimaryKeyName(model),
+      tableName,
+      softDeletes: this.supportsSoftDeletes(model),
+      relations: associations,
+      adapter: this.name
+    };
+  }
+  buildIncludes(includes) {
+    if (Array.isArray(includes)) {
+      return includes.map((relation) => ({ association: relation }));
+    }
+    return Object.entries(includes).map(([relation, opts]) => {
+      if (typeof opts === "boolean" && opts) {
+        return { association: relation };
+      }
+      if (typeof opts === "object" && opts !== null) {
+        return {
+          association: relation,
+          ...opts
+        };
+      }
+      return { association: relation };
+    });
+  }
+  async findWithCustomQuery(model, key, value, options) {
+    const findOptions = {
+      where: { [key]: value }
+    };
+    if (options.query) {
+      options.query(findOptions);
+    }
+    return await model.findOne(findOptions);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SequelizeAdapter
+});
+//# sourceMappingURL=SequelizeAdapter.js.map

package/dist/adapters/SequelizeAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/SequelizeAdapter.ts","../../src/errors/index.ts","../../src/core/BaseAdapter.ts","../../src/utils/validators.ts"],"sourcesContent":["import type {\n  Sequelize,\n  Model,\n  ModelStatic,\n  FindOptions,\n  Includeable,\n  Transaction,\n} from 'sequelize';\nimport { BaseAdapter } from '../core/BaseAdapter';\nimport { QueryOptions, ModelMetadata, QueryModifier } from '../core/types';\nimport { BindingError } from '../errors';\nimport { isUUID } from '../utils/validators';\n\n/**\n * Sequelize model static type\n */\ntype SequelizeModelStatic = ModelStatic<Model>;\n\n/**\n * Type guard for Sequelize model\n */\nfunction isSequelizeModel(model: unknown): model is SequelizeModelStatic {\n  if (!model || typeof model !== 'function') {\n    return false;\n  }\n  const m = model as unknown as Record<string, unknown>;\n  return (\n    typeof m.findOne === 'function' &&\n    typeof m.findAll === 'function' &&\n    typeof m.rawAttributes === 'object'\n  );\n}\n\n/**\n * Adapter for Sequelize ORM supporting PostgreSQL, MySQL, SQLite, MSSQL\n */\nexport class SequelizeAdapter extends BaseAdapter<SequelizeModelStatic, Model, FindOptions> {\n  readonly name = 'sequelize';\n\n  constructor(private sequelize: Sequelize) {\n    super();\n  }\n\n  getSequelize(): Sequelize {\n    return this.sequelize;\n  }\n\n  async findByKey(\n    model: SequelizeModelStatic,\n    key: string,\n    value: unknown,\n    options: QueryOptions = {}\n  ): Promise<Model | null> {\n    this.validateModel(model);\n\n    try {\n      const transformedValue = this.transformValue(model, key, value as string);\n\n      const findOptions: FindOptions = {\n        where: { [key]: transformedValue },\n      };\n\n      if (options.select && options.select.length > 0) {\n        findOptions.attributes = options.select;\n      }\n\n      if (options.include) {\n        findOptions.include = this.buildIncludes(options.include);\n      }\n\n      if (options.where) {\n        findOptions.where = {\n          ...findOptions.where,\n          ...options.where,\n        };\n      }\n\n      const isParanoid = model.options?.paranoid;\n      if (isParanoid) {\n        if (options.withTrashed) {\n          findOptions.paranoid = false;\n        } else if (options.onlyTrashed) {\n          findOptions.paranoid = false;\n          // Sequelize Op must be loaded synchronously for query construction\n          // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires\n          const { Op: SeqOp } = require('sequelize');\n          const whereClause = findOptions.where as Record<string, unknown>;\n          whereClause.deletedAt = { [SeqOp.ne]: null };\n        }\n      }\n\n      if (options.lock === 'forUpdate') {\n        findOptions.lock = true;\n      } else if (options.lock === 'forShare') {\n        // Sequelize Transaction must be loaded synchronously for lock types\n        // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires\n        const { Transaction: SeqTransaction } = require('sequelize') as {\n          Transaction: typeof Transaction;\n        };\n        findOptions.lock = SeqTransaction.LOCK.SHARE;\n      }\n\n      let result = await model.findOne(findOptions);\n\n      if (options.query && !result) {\n        result = await this.findWithCustomQuery(model, key, transformedValue, options);\n      }\n\n      return result;\n    } catch (error) {\n      throw new BindingError(\n        `Failed to fetch ${model.name}: ${(error as Error).message}`,\n        error as Error\n      );\n    }\n  }\n\n  getPrimaryKeyName(model: SequelizeModelStatic): string {\n    return model.primaryKeyAttribute || 'id';\n  }\n\n  isValidModel(model: unknown): model is SequelizeModelStatic {\n    return isSequelizeModel(model);\n  }\n\n  transformValue(model: SequelizeModelStatic, key: string, value: string): unknown {\n    const attributes = model.rawAttributes;\n    const attribute = attributes?.[key];\n\n    if (!attribute) {\n      if (isUUID(value)) {\n        return value;\n      }\n      const num = parseInt(value, 10);\n      if (!isNaN(num) && num.toString() === value) {\n        return num;\n      }\n      return value;\n    }\n\n    const attrType = attribute.type;\n    const type = attrType?.constructor?.name || String(attrType);\n\n    switch (type) {\n      case 'INTEGER':\n      case 'BIGINT':\n      case 'SMALLINT': {\n        const intNum = parseInt(value, 10);\n        return isNaN(intNum) ? value : intNum;\n      }\n\n      case 'FLOAT':\n      case 'DOUBLE':\n      case 'DECIMAL': {\n        const floatNum = parseFloat(value);\n        return isNaN(floatNum) ? value : floatNum;\n      }\n\n      case 'BOOLEAN':\n        return value === 'true' || value === '1';\n\n      case 'UUID':\n        return value;\n\n      default:\n        return value;\n    }\n  }\n\n  supportsSoftDeletes(model: SequelizeModelStatic): boolean {\n    return !!model.options?.paranoid;\n  }\n\n  getModelMetadata(model: SequelizeModelStatic): ModelMetadata {\n    const tableName = model.tableName || model.name;\n    const associations = Object.keys(model.associations || {});\n\n    return {\n      name: model.name,\n      primaryKey: this.getPrimaryKeyName(model),\n      tableName: tableName,\n      softDeletes: this.supportsSoftDeletes(model),\n      relations: associations,\n      adapter: this.name,\n    };\n  }\n\n  private buildIncludes(includes: string[] | Record<string, unknown>): Includeable[] {\n    if (Array.isArray(includes)) {\n      return includes.map(relation => ({ association: relation }));\n    }\n\n    return Object.entries(includes).map(([relation, opts]) => {\n      if (typeof opts === 'boolean' && opts) {\n        return { association: relation };\n      }\n\n      if (typeof opts === 'object' && opts !== null) {\n        return {\n          association: relation,\n          ...opts,\n        };\n      }\n\n      return { association: relation };\n    });\n  }\n\n  private async findWithCustomQuery(\n    model: SequelizeModelStatic,\n    key: string,\n    value: unknown,\n    options: QueryOptions\n  ): Promise<Model | null> {\n    const findOptions: FindOptions = {\n      where: { [key]: value },\n    };\n\n    if (options.query) {\n      (options.query as QueryModifier<FindOptions>)(findOptions);\n    }\n\n    return await model.findOne(findOptions);\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/SequelizeAdapter.mjs

@@ -0,0 +1,260 @@
+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 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/SequelizeAdapter.ts
+function isSequelizeModel(model) {
+  if (!model || typeof model !== "function") {
+    return false;
+  }
+  const m = model;
+  return typeof m.findOne === "function" && typeof m.findAll === "function" && typeof m.rawAttributes === "object";
+}
+var SequelizeAdapter = class extends BaseAdapter {
+  constructor(sequelize) {
+    super();
+    this.sequelize = sequelize;
+    this.name = "sequelize";
+  }
+  getSequelize() {
+    return this.sequelize;
+  }
+  async findByKey(model, key, value, options = {}) {
+    this.validateModel(model);
+    try {
+      const transformedValue = this.transformValue(model, key, value);
+      const findOptions = {
+        where: { [key]: transformedValue }
+      };
+      if (options.select && options.select.length > 0) {
+        findOptions.attributes = options.select;
+      }
+      if (options.include) {
+        findOptions.include = this.buildIncludes(options.include);
+      }
+      if (options.where) {
+        findOptions.where = {
+          ...findOptions.where,
+          ...options.where
+        };
+      }
+      const isParanoid = model.options?.paranoid;
+      if (isParanoid) {
+        if (options.withTrashed) {
+          findOptions.paranoid = false;
+        } else if (options.onlyTrashed) {
+          findOptions.paranoid = false;
+          const { Op: SeqOp } = __require("sequelize");
+          const whereClause = findOptions.where;
+          whereClause.deletedAt = { [SeqOp.ne]: null };
+        }
+      }
+      if (options.lock === "forUpdate") {
+        findOptions.lock = true;
+      } else if (options.lock === "forShare") {
+        const { Transaction: SeqTransaction } = __require("sequelize");
+        findOptions.lock = SeqTransaction.LOCK.SHARE;
+      }
+      let result = await model.findOne(findOptions);
+      if (options.query && !result) {
+        result = await this.findWithCustomQuery(model, key, transformedValue, options);
+      }
+      return result;
+    } catch (error) {
+      throw new BindingError(
+        `Failed to fetch ${model.name}: ${error.message}`,
+        error
+      );
+    }
+  }
+  getPrimaryKeyName(model) {
+    return model.primaryKeyAttribute || "id";
+  }
+  isValidModel(model) {
+    return isSequelizeModel(model);
+  }
+  transformValue(model, key, value) {
+    const attributes = model.rawAttributes;
+    const attribute = attributes?.[key];
+    if (!attribute) {
+      if (isUUID(value)) {
+        return value;
+      }
+      const num = parseInt(value, 10);
+      if (!isNaN(num) && num.toString() === value) {
+        return num;
+      }
+      return value;
+    }
+    const attrType = attribute.type;
+    const type = attrType?.constructor?.name || String(attrType);
+    switch (type) {
+      case "INTEGER":
+      case "BIGINT":
+      case "SMALLINT": {
+        const intNum = parseInt(value, 10);
+        return isNaN(intNum) ? value : intNum;
+      }
+      case "FLOAT":
+      case "DOUBLE":
+      case "DECIMAL": {
+        const floatNum = parseFloat(value);
+        return isNaN(floatNum) ? value : floatNum;
+      }
+      case "BOOLEAN":
+        return value === "true" || value === "1";
+      case "UUID":
+        return value;
+      default:
+        return value;
+    }
+  }
+  supportsSoftDeletes(model) {
+    return !!model.options?.paranoid;
+  }
+  getModelMetadata(model) {
+    const tableName = model.tableName || model.name;
+    const associations = Object.keys(model.associations || {});
+    return {
+      name: model.name,
+      primaryKey: this.getPrimaryKeyName(model),
+      tableName,
+      softDeletes: this.supportsSoftDeletes(model),
+      relations: associations,
+      adapter: this.name
+    };
+  }
+  buildIncludes(includes) {
+    if (Array.isArray(includes)) {
+      return includes.map((relation) => ({ association: relation }));
+    }
+    return Object.entries(includes).map(([relation, opts]) => {
+      if (typeof opts === "boolean" && opts) {
+        return { association: relation };
+      }
+      if (typeof opts === "object" && opts !== null) {
+        return {
+          association: relation,
+          ...opts
+        };
+      }
+      return { association: relation };
+    });
+  }
+  async findWithCustomQuery(model, key, value, options) {
+    const findOptions = {
+      where: { [key]: value }
+    };
+    if (options.query) {
+      options.query(findOptions);
+    }
+    return await model.findOne(findOptions);
+  }
+};
+export {
+  SequelizeAdapter
+};
+//# sourceMappingURL=SequelizeAdapter.mjs.map

package/dist/adapters/SequelizeAdapter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/errors/index.ts","../../src/core/BaseAdapter.ts","../../src/utils/validators.ts","../../src/adapters/SequelizeAdapter.ts"],"sourcesContent":["/**\n * Base error class for model binding errors\n */\nexport class BindingError extends Error {\n  public readonly originalError?: Error;\n\n  constructor(message: string, originalError?: Error) {\n    super(message);\n    this.name = 'BindingError';\n    this.originalError = originalError;\n    Error.captureStackTrace(this, this.constructor);\n  }\n\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      message: this.message,\n      originalError: this.originalError?.message,\n    };\n  }\n}\n\n/**\n * Error thrown when a model is not found (404)\n */\nexport class ModelNotFoundError extends Error {\n  public readonly statusCode = 404;\n  public readonly paramName: string;\n  public readonly paramValue: string;\n  public readonly modelName: string;\n\n  constructor(paramName: string, paramValue: string, modelName: string, customMessage?: string) {\n    super(customMessage || `${modelName} not found with ${paramName} = ${paramValue}`);\n    this.name = 'ModelNotFoundError';\n    this.paramName = paramName;\n    this.paramValue = paramValue;\n    this.modelName = modelName;\n    Error.captureStackTrace(this, this.constructor);\n  }\n\n  toJSON(): Record<string, unknown> {\n    return {\n      error: 'Not Found',\n      message: this.message,\n      statusCode: this.statusCode,\n      param: this.paramName,\n      value: this.paramValue,\n      model: this.modelName,\n    };\n  }\n}\n\n/**\n * Error thrown when no adapter is configured\n */\nexport class AdapterNotSetError extends Error {\n  constructor(\n    message: string = 'No adapter set. Call ModelBinder.setAdapter() before using model binding.'\n  ) {\n    super(message);\n    this.name = 'AdapterNotSetError';\n    Error.captureStackTrace(this, this.constructor);\n  }\n\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      message: this.message,\n    };\n  }\n}\n\n/**\n * Error thrown when a model is invalid for an adapter\n */\nexport class InvalidModelError extends Error {\n  public readonly model: unknown;\n\n  constructor(message: string, model: unknown) {\n    super(message);\n    this.name = 'InvalidModelError';\n    this.model = model;\n    Error.captureStackTrace(this, this.constructor);\n  }\n\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      message: this.message,\n      model: typeof this.model === 'string' ? this.model : String(this.model),\n    };\n  }\n}\n\n/**\n * Error thrown when validation fails\n */\nexport class ValidationError extends Error {\n  public readonly statusCode: number;\n  public readonly details?: unknown;\n\n  constructor(message: string, statusCode: number = 400, details?: unknown) {\n    super(message);\n    this.name = 'ValidationError';\n    this.statusCode = statusCode;\n    this.details = details;\n    Error.captureStackTrace(this, this.constructor);\n  }\n\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      message: this.message,\n      statusCode: this.statusCode,\n      details: this.details,\n    };\n  }\n}\n","import { IORMAdapter, QueryOptions, ModelMetadata, QueryModifier } from './types';\nimport { InvalidModelError } from '../errors';\n\n/**\n * Abstract base class providing common adapter functionality.\n * Extend this class to implement ORM-specific adapters.\n *\n * @typeParam TModel - Model type accepted by this adapter\n * @typeParam TResult - Result type returned by queries\n * @typeParam TQueryBuilder - ORM-specific query builder type\n */\nexport abstract class BaseAdapter<\n  TModel = unknown,\n  TResult = unknown,\n  TQueryBuilder = unknown,\n> implements IORMAdapter<TModel, TResult> {\n  abstract readonly name: string;\n\n  abstract findByKey(\n    model: TModel,\n    key: string,\n    value: unknown,\n    options?: QueryOptions\n  ): Promise<TResult | null>;\n\n  abstract getPrimaryKeyName(model: TModel): string;\n\n  abstract isValidModel(model: unknown): model is TModel;\n\n  transformValue(_model: TModel, _key: string, value: string): unknown {\n    if (/^\\d+$/.test(value)) {\n      const num = parseInt(value, 10);\n      if (!isNaN(num) && Number.isSafeInteger(num)) {\n        return num;\n      }\n    }\n    return value;\n  }\n\n  supportsSoftDeletes(_model: TModel): boolean {\n    return false;\n  }\n\n  getModelMetadata(model: TModel): ModelMetadata {\n    return {\n      name: this.getModelName(model),\n      primaryKey: this.getPrimaryKeyName(model),\n      softDeletes: this.supportsSoftDeletes(model),\n      adapter: this.name,\n    };\n  }\n\n  protected validateModel(model: unknown): asserts model is TModel {\n    if (!this.isValidModel(model)) {\n      throw new InvalidModelError(`Invalid model for ${this.name} adapter`, model);\n    }\n  }\n\n  protected getModelName(model: TModel): string {\n    if (typeof model === 'string') {\n      return model;\n    }\n    if (model && typeof model === 'object') {\n      const obj = model as Record<string, unknown>;\n      if (typeof obj.name === 'string') return obj.name;\n      if (typeof obj.modelName === 'string') return obj.modelName;\n      if (typeof obj.tableName === 'string') return obj.tableName;\n    }\n    if (model && typeof model === 'function') {\n      return (model as { name: string }).name || 'Unknown';\n    }\n    return 'Unknown';\n  }\n\n  protected applySoftDeleteFilter(\n    queryBuilder: TQueryBuilder,\n    _options?: QueryOptions\n  ): TQueryBuilder {\n    return queryBuilder;\n  }\n\n  protected applyIncludes(\n    queryBuilder: TQueryBuilder,\n    _includes?: string[] | Record<string, unknown>\n  ): TQueryBuilder {\n    return queryBuilder;\n  }\n\n  protected applySelect(queryBuilder: TQueryBuilder, _select?: string[]): TQueryBuilder {\n    return queryBuilder;\n  }\n\n  protected applyWhereConditions(\n    queryBuilder: TQueryBuilder,\n    _where?: Record<string, unknown>\n  ): TQueryBuilder {\n    return queryBuilder;\n  }\n\n  protected applyCustomQuery(\n    queryBuilder: TQueryBuilder,\n    queryFn?: QueryModifier<TQueryBuilder>\n  ): TQueryBuilder {\n    if (queryFn) {\n      return queryFn(queryBuilder) as TQueryBuilder;\n    }\n    return queryBuilder;\n  }\n}\n","/**\n * UUID regex pattern\n */\nconst UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\n\n/**\n * MongoDB ObjectId regex pattern (24 hex characters)\n */\nconst OBJECT_ID_REGEX = /^[0-9a-f]{24}$/i;\n\n/**\n * Check if a value is a valid UUID\n */\nexport function isUUID(value: string): boolean {\n  return UUID_REGEX.test(value);\n}\n\n/**\n * Check if a value is a valid MongoDB ObjectId\n */\nexport function isObjectId(value: string): boolean {\n  return OBJECT_ID_REGEX.test(value);\n}\n\n/**\n * Check if a value is a numeric string\n */\nexport function isNumeric(value: string): boolean {\n  return /^-?\\d+$/.test(value);\n}\n\n/**\n * Check if a value is a valid positive integer\n */\nexport function isPositiveInteger(value: string): boolean {\n  return /^\\d+$/.test(value) && parseInt(value, 10) > 0;\n}\n\n/**\n * Check if a value is a valid slug (lowercase alphanumeric with hyphens)\n */\nexport function isSlug(value: string): boolean {\n  return /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(value);\n}\n\n/**\n * Check if a value is a valid email\n */\nexport function isEmail(value: string): boolean {\n  return /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(value);\n}\n\n/**\n * Validate that a value is not empty\n */\nexport function isNotEmpty(value: unknown): boolean {\n  if (value === null || value === undefined) {\n    return false;\n  }\n  if (typeof value === 'string') {\n    return value.trim().length > 0;\n  }\n  return true;\n}\n\n/**\n * Validate that a value is a non-empty string\n */\nexport function isNonEmptyString(value: unknown): value is string {\n  return typeof value === 'string' && value.trim().length > 0;\n}\n\n/**\n * Validate that a value is a plain object\n */\nexport function isPlainObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/**\n * Validate that a value is a function\n */\n// eslint-disable-next-line @typescript-eslint/ban-types\nexport function isFunction(value: unknown): value is Function {\n  return typeof value === 'function';\n}\n\n/**\n * Validate route parameter name\n */\nexport function isValidParamName(value: string): boolean {\n  return /^[a-zA-Z_][a-zA-Z0-9_]*$/.test(value);\n}\n","import type {\n  Sequelize,\n  Model,\n  ModelStatic,\n  FindOptions,\n  Includeable,\n  Transaction,\n} from 'sequelize';\nimport { BaseAdapter } from '../core/BaseAdapter';\nimport { QueryOptions, ModelMetadata, QueryModifier } from '../core/types';\nimport { BindingError } from '../errors';\nimport { isUUID } from '../utils/validators';\n\n/**\n * Sequelize model static type\n */\ntype SequelizeModelStatic = ModelStatic<Model>;\n\n/**\n * Type guard for Sequelize model\n */\nfunction isSequelizeModel(model: unknown): model is SequelizeModelStatic {\n  if (!model || typeof model !== 'function') {\n    return false;\n  }\n  const m = model as unknown as Record<string, unknown>;\n  return (\n    typeof m.findOne === 'function' &&\n    typeof m.findAll === 'function' &&\n    typeof m.rawAttributes === 'object'\n  );\n}\n\n/**\n * Adapter for Sequelize ORM supporting PostgreSQL, MySQL, SQLite, MSSQL\n */\nexport class SequelizeAdapter extends BaseAdapter<SequelizeModelStatic, Model, FindOptions> {\n  readonly name = 'sequelize';\n\n  constructor(private sequelize: Sequelize) {\n    super();\n  }\n\n  getSequelize(): Sequelize {\n    return this.sequelize;\n  }\n\n  async findByKey(\n    model: SequelizeModelStatic,\n    key: string,\n    value: unknown,\n    options: QueryOptions = {}\n  ): Promise<Model | null> {\n    this.validateModel(model);\n\n    try {\n      const transformedValue = this.transformValue(model, key, value as string);\n\n      const findOptions: FindOptions = {\n        where: { [key]: transformedValue },\n      };\n\n      if (options.select && options.select.length > 0) {\n        findOptions.attributes = options.select;\n      }\n\n      if (options.include) {\n        findOptions.include = this.buildIncludes(options.include);\n      }\n\n      if (options.where) {\n        findOptions.where = {\n          ...findOptions.where,\n          ...options.where,\n        };\n      }\n\n      const isParanoid = model.options?.paranoid;\n      if (isParanoid) {\n        if (options.withTrashed) {\n          findOptions.paranoid = false;\n        } else if (options.onlyTrashed) {\n          findOptions.paranoid = false;\n          // Sequelize Op must be loaded synchronously for query construction\n          // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires\n          const { Op: SeqOp } = require('sequelize');\n          const whereClause = findOptions.where as Record<string, unknown>;\n          whereClause.deletedAt = { [SeqOp.ne]: null };\n        }\n      }\n\n      if (options.lock === 'forUpdate') {\n        findOptions.lock = true;\n      } else if (options.lock === 'forShare') {\n        // Sequelize Transaction must be loaded synchronously for lock types\n        // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires\n        const { Transaction: SeqTransaction } = require('sequelize') as {\n          Transaction: typeof Transaction;\n        };\n        findOptions.lock = SeqTransaction.LOCK.SHARE;\n      }\n\n      let result = await model.findOne(findOptions);\n\n      if (options.query && !result) {\n        result = await this.findWithCustomQuery(model, key, transformedValue, options);\n      }\n\n      return result;\n    } catch (error) {\n      throw new BindingError(\n        `Failed to fetch ${model.name}: ${(error as Error).message}`,\n        error as Error\n      );\n    }\n  }\n\n  getPrimaryKeyName(model: SequelizeModelStatic): string {\n    return model.primaryKeyAttribute || 'id';\n  }\n\n  isValidModel(model: unknown): model is SequelizeModelStatic {\n    return isSequelizeModel(model);\n  }\n\n  transformValue(model: SequelizeModelStatic, key: string, value: string): unknown {\n    const attributes = model.rawAttributes;\n    const attribute = attributes?.[key];\n\n    if (!attribute) {\n      if (isUUID(value)) {\n        return value;\n      }\n      const num = parseInt(value, 10);\n      if (!isNaN(num) && num.toString() === value) {\n        return num;\n      }\n      return value;\n    }\n\n    const attrType = attribute.type;\n    const type = attrType?.constructor?.name || String(attrType);\n\n    switch (type) {\n      case 'INTEGER':\n      case 'BIGINT':\n      case 'SMALLINT': {\n        const intNum = parseInt(value, 10);\n        return isNaN(intNum) ? value : intNum;\n      }\n\n      case 'FLOAT':\n      case 'DOUBLE':\n      case 'DECIMAL': {\n        const floatNum = parseFloat(value);\n        return isNaN(floatNum) ? value : floatNum;\n      }\n\n      case 'BOOLEAN':\n        return value === 'true' || value === '1';\n\n      case 'UUID':\n        return value;\n\n      default:\n        return value;\n    }\n  }\n\n  supportsSoftDeletes(model: SequelizeModelStatic): boolean {\n    return !!model.options?.paranoid;\n  }\n\n  getModelMetadata(model: SequelizeModelStatic): ModelMetadata {\n    const tableName = model.tableName || model.name;\n    const associations = Object.keys(model.associations || {});\n\n    return {\n      name: model.name,\n      primaryKey: this.getPrimaryKeyName(model),\n      tableName: tableName,\n      softDeletes: this.supportsSoftDeletes(model),\n      relations: associations,\n      adapter: this.name,\n    };\n  }\n\n  private buildIncludes(includes: string[] | Record<string, unknown>): Includeable[] {\n    if (Array.isArray(includes)) {\n      return includes.map(relation => ({ association: relation }));\n    }\n\n    return Object.entries(includes).map(([relation, opts]) => {\n      if (typeof opts === 'boolean' && opts) {\n        return { association: relation };\n      }\n\n      if (typeof opts === 'object' && opts !== null) {\n        return {\n          association: relation,\n          ...opts,\n        };\n      }\n\n      return { association: relation };\n    });\n  }\n\n  private async findWithCustomQuery(\n    model: SequelizeModelStatic,\n    key: string,\n    value: unknown,\n    options: QueryOptions\n  ): Promise<Model | null> {\n    const findOptions: FindOptions = {\n      where: { [key]: value },\n    };\n\n    if (options.query) {\n      (options.query as QueryModifier<FindOptions>)(findOptions);\n    }\n\n    return await model.findOne(findOptions);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/adapters/TypeORMAdapter.d.mts

@@ -0,0 +1,26 @@
+import { EntityTarget, ObjectLiteral, SelectQueryBuilder, DataSource } from 'typeorm';
+import { b as BaseAdapter, Q as QueryOptions, d as ModelMetadata } from '../BaseAdapter-BjvLQijd.mjs';
+import 'express';
+
+/**
+ * TypeORM entity type alias for better readability
+ */
+type TypeORMEntity = EntityTarget<ObjectLiteral>;
+/**
+ * Adapter for TypeORM supporting SQL and NoSQL databases
+ */
+declare class TypeORMAdapter extends BaseAdapter<TypeORMEntity, ObjectLiteral, SelectQueryBuilder<ObjectLiteral>> {
+    private dataSource;
+    readonly name = "typeorm";
+    constructor(dataSource: DataSource);
+    getDataSource(): DataSource;
+    findByKey(entity: TypeORMEntity, key: string, value: unknown, options?: QueryOptions): Promise<ObjectLiteral | null>;
+    getPrimaryKeyName(entity: TypeORMEntity): string;
+    isValidModel(model: unknown): model is TypeORMEntity;
+    transformValue(entity: TypeORMEntity, key: string, value: string): unknown;
+    supportsSoftDeletes(entity: TypeORMEntity): boolean;
+    getModelMetadata(entity: TypeORMEntity): ModelMetadata;
+    private findWithQueryBuilder;
+}
+
+export { TypeORMAdapter, type TypeORMEntity };