express-model-binding 1.0.0

package/dist/adapters/TypeORMAdapter.d.ts

@@ -0,0 +1,26 @@
+import { EntityTarget, ObjectLiteral, SelectQueryBuilder, DataSource } from 'typeorm';
+import { b as BaseAdapter, Q as QueryOptions, d as ModelMetadata } from '../BaseAdapter-BjvLQijd.js';
+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 };

package/dist/adapters/TypeORMAdapter.js

@@ -0,0 +1,294 @@
+"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/TypeORMAdapter.ts
+var TypeORMAdapter_exports = {};
+__export(TypeORMAdapter_exports, {
+  TypeORMAdapter: () => TypeORMAdapter
+});
+module.exports = __toCommonJS(TypeORMAdapter_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/TypeORMAdapter.ts
+var TypeORMAdapter = class extends BaseAdapter {
+  constructor(dataSource) {
+    super();
+    this.dataSource = dataSource;
+    this.name = "typeorm";
+  }
+  getDataSource() {
+    return this.dataSource;
+  }
+  async findByKey(entity, key, value, options = {}) {
+    this.validateModel(entity);
+    try {
+      const repository = this.dataSource.getRepository(entity);
+      const metadata = repository.metadata;
+      const transformedValue = this.transformValue(entity, key, value);
+      if (options.query || options.lock || options.onlyTrashed) {
+        return await this.findWithQueryBuilder(repository, key, transformedValue, options);
+      }
+      const findOptions = {
+        where: { [key]: transformedValue }
+      };
+      if (options.select && options.select.length > 0) {
+        findOptions.select = options.select.reduce((acc, field) => {
+          acc[field] = true;
+          return acc;
+        }, {});
+      }
+      if (options.include) {
+        findOptions.relations = Array.isArray(options.include) ? options.include : Object.keys(options.include);
+      }
+      if (options.where) {
+        findOptions.where = {
+          ...findOptions.where,
+          ...options.where
+        };
+      }
+      if (options.withTrashed && metadata.deleteDateColumn) {
+        findOptions.withDeleted = true;
+      }
+      const result = await repository.findOne(findOptions);
+      return result;
+    } catch (error) {
+      throw new BindingError(`Failed to fetch entity: ${error.message}`, error);
+    }
+  }
+  getPrimaryKeyName(entity) {
+    try {
+      const repository = this.dataSource.getRepository(entity);
+      const metadata = repository.metadata;
+      if (metadata.primaryColumns.length > 0) {
+        return metadata.primaryColumns[0].propertyName;
+      }
+    } catch {
+    }
+    return "id";
+  }
+  isValidModel(model) {
+    try {
+      this.dataSource.getRepository(model);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  transformValue(entity, key, value) {
+    try {
+      const repository = this.dataSource.getRepository(entity);
+      const metadata = repository.metadata;
+      const column = metadata.findColumnWithPropertyName(key);
+      if (!column) {
+        if (isUUID(value)) {
+          return value;
+        }
+        const num = parseInt(value, 10);
+        if (!isNaN(num) && num.toString() === value) {
+          return num;
+        }
+        return value;
+      }
+      const columnType = String(column.type).toLowerCase();
+      if (["int", "integer", "smallint", "bigint", "number"].includes(columnType)) {
+        const num = parseInt(value, 10);
+        return isNaN(num) ? value : num;
+      }
+      if (columnType === "uuid") {
+        return value;
+      }
+      if (columnType === "boolean" || columnType === "bool") {
+        return value === "true" || value === "1";
+      }
+      return value;
+    } catch {
+      return value;
+    }
+  }
+  supportsSoftDeletes(entity) {
+    try {
+      const repository = this.dataSource.getRepository(entity);
+      const metadata = repository.metadata;
+      return !!metadata.deleteDateColumn;
+    } catch {
+      return false;
+    }
+  }
+  getModelMetadata(entity) {
+    try {
+      const repository = this.dataSource.getRepository(entity);
+      const metadata = repository.metadata;
+      return {
+        name: metadata.name,
+        primaryKey: this.getPrimaryKeyName(entity),
+        tableName: metadata.tableName,
+        softDeletes: this.supportsSoftDeletes(entity),
+        relations: metadata.relations.map((r) => r.propertyName),
+        adapter: this.name
+      };
+    } catch {
+      return {
+        name: "Unknown",
+        primaryKey: "id",
+        softDeletes: false,
+        adapter: this.name
+      };
+    }
+  }
+  async findWithQueryBuilder(repository, key, value, options) {
+    const metadata = repository.metadata;
+    const alias = metadata.name.toLowerCase();
+    let queryBuilder = repository.createQueryBuilder(alias).where(`${alias}.${key} = :value`, { value });
+    if (options.include) {
+      const relations = Array.isArray(options.include) ? options.include : Object.keys(options.include);
+      relations.forEach((relation) => {
+        queryBuilder = queryBuilder.leftJoinAndSelect(`${alias}.${relation}`, relation);
+      });
+    }
+    if (options.where) {
+      Object.entries(options.where).forEach(([field, val]) => {
+        queryBuilder = queryBuilder.andWhere(`${alias}.${field} = :${field}`, { [field]: val });
+      });
+    }
+    if (options.select && options.select.length > 0) {
+      queryBuilder = queryBuilder.select(options.select.map((field) => `${alias}.${field}`));
+    }
+    if (options.withTrashed) {
+      queryBuilder = queryBuilder.withDeleted();
+    } else if (options.onlyTrashed && metadata.deleteDateColumn) {
+      queryBuilder = queryBuilder.withDeleted().andWhere(`${alias}.${metadata.deleteDateColumn.propertyName} IS NOT NULL`);
+    }
+    if (options.lock === "forUpdate") {
+      queryBuilder = queryBuilder.setLock("pessimistic_write");
+    } else if (options.lock === "forShare") {
+      queryBuilder = queryBuilder.setLock("pessimistic_read");
+    }
+    if (options.query) {
+      queryBuilder = this.applyCustomQuery(
+        queryBuilder,
+        options.query
+      );
+    }
+    return await queryBuilder.getOne();
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TypeORMAdapter
+});
+//# sourceMappingURL=TypeORMAdapter.js.map

package/dist/adapters/TypeORMAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/TypeORMAdapter.ts","../../src/errors/index.ts","../../src/core/BaseAdapter.ts","../../src/utils/validators.ts"],"sourcesContent":["import type {\n  DataSource,\n  Repository,\n  EntityTarget,\n  ObjectLiteral,\n  SelectQueryBuilder,\n} from 'typeorm';\nimport { BaseAdapter } from '../core/BaseAdapter';\nimport { QueryOptions, ModelMetadata, QueryModifier } from '../core/types';\nimport { BindingError } from '../errors';\nimport { isUUID } from '../utils/validators';\n\n/**\n * TypeORM entity type alias for better readability\n */\nexport type TypeORMEntity = EntityTarget<ObjectLiteral>;\n\n/**\n * TypeORM find options structure\n */\ninterface TypeORMFindOptions {\n  where: Record<string, unknown>;\n  select?: Record<string, boolean>;\n  relations?: string[];\n  withDeleted?: boolean;\n}\n\n/**\n * Adapter for TypeORM supporting SQL and NoSQL databases\n */\nexport class TypeORMAdapter extends BaseAdapter<\n  TypeORMEntity,\n  ObjectLiteral,\n  SelectQueryBuilder<ObjectLiteral>\n> {\n  readonly name = 'typeorm';\n\n  constructor(private dataSource: DataSource) {\n    super();\n  }\n\n  getDataSource(): DataSource {\n    return this.dataSource;\n  }\n\n  async findByKey(\n    entity: TypeORMEntity,\n    key: string,\n    value: unknown,\n    options: QueryOptions = {}\n  ): Promise<ObjectLiteral | null> {\n    this.validateModel(entity);\n\n    try {\n      const repository = this.dataSource.getRepository(entity);\n      const metadata = repository.metadata;\n\n      const transformedValue = this.transformValue(entity, key, value as string);\n\n      if (options.query || options.lock || options.onlyTrashed) {\n        return await this.findWithQueryBuilder(repository, key, transformedValue, options);\n      }\n\n      const findOptions: TypeORMFindOptions = {\n        where: { [key]: transformedValue },\n      };\n\n      if (options.select && options.select.length > 0) {\n        findOptions.select = options.select.reduce<Record<string, boolean>>((acc, field) => {\n          acc[field] = true;\n          return acc;\n        }, {});\n      }\n\n      if (options.include) {\n        findOptions.relations = Array.isArray(options.include)\n          ? options.include\n          : Object.keys(options.include);\n      }\n\n      if (options.where) {\n        findOptions.where = {\n          ...findOptions.where,\n          ...options.where,\n        };\n      }\n\n      if (options.withTrashed && metadata.deleteDateColumn) {\n        findOptions.withDeleted = true;\n      }\n\n      const result = await repository.findOne(findOptions);\n      return result;\n    } catch (error) {\n      throw new BindingError(`Failed to fetch entity: ${(error as Error).message}`, error as Error);\n    }\n  }\n\n  getPrimaryKeyName(entity: TypeORMEntity): string {\n    try {\n      const repository = this.dataSource.getRepository(entity);\n      const metadata = repository.metadata;\n\n      if (metadata.primaryColumns.length > 0) {\n        return metadata.primaryColumns[0].propertyName;\n      }\n    } catch {\n      // Fall through to default\n    }\n    return 'id';\n  }\n\n  isValidModel(model: unknown): model is TypeORMEntity {\n    try {\n      this.dataSource.getRepository(model as TypeORMEntity);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  transformValue(entity: TypeORMEntity, key: string, value: string): unknown {\n    try {\n      const repository = this.dataSource.getRepository(entity);\n      const metadata = repository.metadata;\n      const column = metadata.findColumnWithPropertyName(key);\n\n      if (!column) {\n        if (isUUID(value)) {\n          return value;\n        }\n        const num = parseInt(value, 10);\n        if (!isNaN(num) && num.toString() === value) {\n          return num;\n        }\n        return value;\n      }\n\n      const columnType = String(column.type).toLowerCase();\n\n      if (['int', 'integer', 'smallint', 'bigint', 'number'].includes(columnType)) {\n        const num = parseInt(value, 10);\n        return isNaN(num) ? value : num;\n      }\n\n      if (columnType === 'uuid') {\n        return value;\n      }\n\n      if (columnType === 'boolean' || columnType === 'bool') {\n        return value === 'true' || value === '1';\n      }\n\n      return value;\n    } catch {\n      return value;\n    }\n  }\n\n  supportsSoftDeletes(entity: TypeORMEntity): boolean {\n    try {\n      const repository = this.dataSource.getRepository(entity);\n      const metadata = repository.metadata;\n      return !!metadata.deleteDateColumn;\n    } catch {\n      return false;\n    }\n  }\n\n  getModelMetadata(entity: TypeORMEntity): ModelMetadata {\n    try {\n      const repository = this.dataSource.getRepository(entity);\n      const metadata = repository.metadata;\n\n      return {\n        name: metadata.name,\n        primaryKey: this.getPrimaryKeyName(entity),\n        tableName: metadata.tableName,\n        softDeletes: this.supportsSoftDeletes(entity),\n        relations: metadata.relations.map(r => r.propertyName),\n        adapter: this.name,\n      };\n    } catch {\n      return {\n        name: 'Unknown',\n        primaryKey: 'id',\n        softDeletes: false,\n        adapter: this.name,\n      };\n    }\n  }\n\n  private async findWithQueryBuilder(\n    repository: Repository<ObjectLiteral>,\n    key: string,\n    value: unknown,\n    options: QueryOptions\n  ): Promise<ObjectLiteral | null> {\n    const metadata = repository.metadata;\n    const alias = metadata.name.toLowerCase();\n\n    let queryBuilder = repository\n      .createQueryBuilder(alias)\n      .where(`${alias}.${key} = :value`, { value });\n\n    if (options.include) {\n      const relations = Array.isArray(options.include)\n        ? options.include\n        : Object.keys(options.include);\n\n      relations.forEach(relation => {\n        queryBuilder = queryBuilder.leftJoinAndSelect(`${alias}.${relation}`, relation);\n      });\n    }\n\n    if (options.where) {\n      Object.entries(options.where).forEach(([field, val]) => {\n        queryBuilder = queryBuilder.andWhere(`${alias}.${field} = :${field}`, { [field]: val });\n      });\n    }\n\n    if (options.select && options.select.length > 0) {\n      queryBuilder = queryBuilder.select(options.select.map(field => `${alias}.${field}`));\n    }\n\n    if (options.withTrashed) {\n      queryBuilder = queryBuilder.withDeleted();\n    } else if (options.onlyTrashed && metadata.deleteDateColumn) {\n      queryBuilder = queryBuilder\n        .withDeleted()\n        .andWhere(`${alias}.${metadata.deleteDateColumn.propertyName} IS NOT NULL`);\n    }\n\n    if (options.lock === 'forUpdate') {\n      queryBuilder = queryBuilder.setLock('pessimistic_write');\n    } else if (options.lock === 'forShare') {\n      queryBuilder = queryBuilder.setLock('pessimistic_read');\n    }\n\n    if (options.query) {\n      queryBuilder = this.applyCustomQuery(\n        queryBuilder,\n        options.query as QueryModifier<SelectQueryBuilder<ObjectLiteral>>\n      );\n    }\n\n    return await queryBuilder.getOne();\n  }\n}\n","/**\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/TypeORMAdapter.mjs

@@ -0,0 +1,267 @@
+// 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/TypeORMAdapter.ts
+var TypeORMAdapter = class extends BaseAdapter {
+  constructor(dataSource) {
+    super();
+    this.dataSource = dataSource;
+    this.name = "typeorm";
+  }
+  getDataSource() {
+    return this.dataSource;
+  }
+  async findByKey(entity, key, value, options = {}) {
+    this.validateModel(entity);
+    try {
+      const repository = this.dataSource.getRepository(entity);
+      const metadata = repository.metadata;
+      const transformedValue = this.transformValue(entity, key, value);
+      if (options.query || options.lock || options.onlyTrashed) {
+        return await this.findWithQueryBuilder(repository, key, transformedValue, options);
+      }
+      const findOptions = {
+        where: { [key]: transformedValue }
+      };
+      if (options.select && options.select.length > 0) {
+        findOptions.select = options.select.reduce((acc, field) => {
+          acc[field] = true;
+          return acc;
+        }, {});
+      }
+      if (options.include) {
+        findOptions.relations = Array.isArray(options.include) ? options.include : Object.keys(options.include);
+      }
+      if (options.where) {
+        findOptions.where = {
+          ...findOptions.where,
+          ...options.where
+        };
+      }
+      if (options.withTrashed && metadata.deleteDateColumn) {
+        findOptions.withDeleted = true;
+      }
+      const result = await repository.findOne(findOptions);
+      return result;
+    } catch (error) {
+      throw new BindingError(`Failed to fetch entity: ${error.message}`, error);
+    }
+  }
+  getPrimaryKeyName(entity) {
+    try {
+      const repository = this.dataSource.getRepository(entity);
+      const metadata = repository.metadata;
+      if (metadata.primaryColumns.length > 0) {
+        return metadata.primaryColumns[0].propertyName;
+      }
+    } catch {
+    }
+    return "id";
+  }
+  isValidModel(model) {
+    try {
+      this.dataSource.getRepository(model);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  transformValue(entity, key, value) {
+    try {
+      const repository = this.dataSource.getRepository(entity);
+      const metadata = repository.metadata;
+      const column = metadata.findColumnWithPropertyName(key);
+      if (!column) {
+        if (isUUID(value)) {
+          return value;
+        }
+        const num = parseInt(value, 10);
+        if (!isNaN(num) && num.toString() === value) {
+          return num;
+        }
+        return value;
+      }
+      const columnType = String(column.type).toLowerCase();
+      if (["int", "integer", "smallint", "bigint", "number"].includes(columnType)) {
+        const num = parseInt(value, 10);
+        return isNaN(num) ? value : num;
+      }
+      if (columnType === "uuid") {
+        return value;
+      }
+      if (columnType === "boolean" || columnType === "bool") {
+        return value === "true" || value === "1";
+      }
+      return value;
+    } catch {
+      return value;
+    }
+  }
+  supportsSoftDeletes(entity) {
+    try {
+      const repository = this.dataSource.getRepository(entity);
+      const metadata = repository.metadata;
+      return !!metadata.deleteDateColumn;
+    } catch {
+      return false;
+    }
+  }
+  getModelMetadata(entity) {
+    try {
+      const repository = this.dataSource.getRepository(entity);
+      const metadata = repository.metadata;
+      return {
+        name: metadata.name,
+        primaryKey: this.getPrimaryKeyName(entity),
+        tableName: metadata.tableName,
+        softDeletes: this.supportsSoftDeletes(entity),
+        relations: metadata.relations.map((r) => r.propertyName),
+        adapter: this.name
+      };
+    } catch {
+      return {
+        name: "Unknown",
+        primaryKey: "id",
+        softDeletes: false,
+        adapter: this.name
+      };
+    }
+  }
+  async findWithQueryBuilder(repository, key, value, options) {
+    const metadata = repository.metadata;
+    const alias = metadata.name.toLowerCase();
+    let queryBuilder = repository.createQueryBuilder(alias).where(`${alias}.${key} = :value`, { value });
+    if (options.include) {
+      const relations = Array.isArray(options.include) ? options.include : Object.keys(options.include);
+      relations.forEach((relation) => {
+        queryBuilder = queryBuilder.leftJoinAndSelect(`${alias}.${relation}`, relation);
+      });
+    }
+    if (options.where) {
+      Object.entries(options.where).forEach(([field, val]) => {
+        queryBuilder = queryBuilder.andWhere(`${alias}.${field} = :${field}`, { [field]: val });
+      });
+    }
+    if (options.select && options.select.length > 0) {
+      queryBuilder = queryBuilder.select(options.select.map((field) => `${alias}.${field}`));
+    }
+    if (options.withTrashed) {
+      queryBuilder = queryBuilder.withDeleted();
+    } else if (options.onlyTrashed && metadata.deleteDateColumn) {
+      queryBuilder = queryBuilder.withDeleted().andWhere(`${alias}.${metadata.deleteDateColumn.propertyName} IS NOT NULL`);
+    }
+    if (options.lock === "forUpdate") {
+      queryBuilder = queryBuilder.setLock("pessimistic_write");
+    } else if (options.lock === "forShare") {
+      queryBuilder = queryBuilder.setLock("pessimistic_read");
+    }
+    if (options.query) {
+      queryBuilder = this.applyCustomQuery(
+        queryBuilder,
+        options.query
+      );
+    }
+    return await queryBuilder.getOne();
+  }
+};
+export {
+  TypeORMAdapter
+};
+//# sourceMappingURL=TypeORMAdapter.mjs.map