@hichchi/nest-crud 0.0.7 → 0.0.9

package/readme-top.md

@@ -300,7 +300,7 @@ npm install mongodb
 
 ### 🏗️ Ready-to-Use Base Classes
 - 🗂️ **BaseEntity** - Pre-configured entity with common fields (id, createdAt, updatedAt, etc.)
-- 👤 **BaseUserEntity** - Extended entity with user-specific fields and relationships
+- 👤 **BaseUserEntity** - Extended entity with user-specific fields, role/tenant references, and relationships
 - 🔧 **BaseEntityExtension** - Flexible entity extension for custom requirements
 - 📦 **BaseRepository** - Comprehensive repository with advanced CRUD operations
 
@@ -380,6 +380,10 @@ export class UserEntity extends HichchiUserEntity {
   // - fullName: string (automatically generated)
   // - email: string | null
   // - username: string | null
+  // - role: string | Role | null
+  // - roleId: EntityId | null
+  // - tenant: TenantSlug | Tenant | null
+  // - tenantId: EntityId | null
   // Plus all BaseEntity fields
 
   // Overriding email as only string if

package/responses/crud.error.responses.d.ts

@@ -95,6 +95,28 @@ declare const CrudErrorResponses: {
      * ```
      */
     E_400_QUERY: (entityName: string, field?: string, description?: string) => ErrorResponse;
+    /**
+     * Error response for empty required field values
+     *
+     * This error occurs when a required field is provided as empty during
+     * request validation. It's commonly used in create and update operations
+     * where specific fields must contain a non-empty value.
+     *
+     * @param {string} entityName - The name of the entity (e.g., 'user', 'product')
+     * @param {string} [field] - The name of the field that must not be empty
+     * @param {string} [description] - Optional additional context or details
+     * @returns {ErrorResponse} A formatted error response object
+     *
+     * @example
+     * ```typescript
+     * if (!dto.name?.trim()) {
+     *   throw new BadRequestException(
+     *     CrudErrorResponses.E_400_EMPTY('user', 'name')
+     *   );
+     * }
+     * ```
+     */
+    E_400_EMPTY: (entityName: string, field: string, description?: string) => ErrorResponse;
     /**
      * Error response for entity not found by ID
      *

package/responses/crud.error.responses.js

@@ -1,4 +1,5 @@
 "use strict";
+// noinspection JSUnusedGlobalSymbols
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CrudErrorResponses = void 0;
 const utils_1 = require("@hichchi/utils");
@@ -113,6 +114,33 @@ const CrudErrorResponses = {
         message: `Cannot find ${field ? `field with name '${field}'` : "a field provided as a filter or search"} in ${(0, utils_1.toLowerCaseBreak)(entityName)}!`,
         description,
     }),
+    /**
+     * Error response for empty required field values
+     *
+     * This error occurs when a required field is provided as empty during
+     * request validation. It's commonly used in create and update operations
+     * where specific fields must contain a non-empty value.
+     *
+     * @param {string} entityName - The name of the entity (e.g., 'user', 'product')
+     * @param {string} [field] - The name of the field that must not be empty
+     * @param {string} [description] - Optional additional context or details
+     * @returns {ErrorResponse} A formatted error response object
+     *
+     * @example
+     * ```typescript
+     * if (!dto.name?.trim()) {
+     *   throw new BadRequestException(
+     *     CrudErrorResponses.E_400_EMPTY('user', 'name')
+     *   );
+     * }
+     * ```
+     */
+    E_400_EMPTY: (entityName, field, description) => ({
+        statusCode: nest_connector_1.HttpClientErrorStatus.BAD_REQUEST,
+        code: `${(0, utils_1.toSnakeCase)(entityName, true)}_${nest_connector_1.HttpClientErrorStatus.BAD_REQUEST}_EMPTY_${(0, utils_1.toSnakeCase)(field, true)}`,
+        message: `${(0, utils_1.toFirstCaseBreak)(entityName)} ${(0, utils_1.toLowerCaseBreak)(field)} should not be empty!`,
+        description,
+    }),
     /**
      * Error response for entity not found by ID
      *

package/responses/crud.error.responses.js.map

@@ -1 +1 @@
-{"version":3,"file":"crud.error.responses.js","sourceRoot":"","sources":["../../../../libs/nest-crud/src/responses/crud.error.responses.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"crud.error.responses.js","sourceRoot":"","sources":["../../../../libs/nest-crud/src/responses/crud.error.responses.ts"],"names":[],"mappings":"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"}

package/services/crud.service.d.ts

@@ -4,6 +4,7 @@ import { TypeORMErrorHandler } from "../types";
 import { PaginatedResponse } from "@hichchi/nest-core";
 import { SuccessResponse } from "@hichchi/nest-connector";
 import { EntityDeepPartial, EntityId, Model, ModelExtension, Pagination, QueryDeepPartial, WithId } from "@hichchi/nest-connector/crud";
+import { EntityManager } from "typeorm";
 /**
  * Abstract base service providing CRUD operations for entities
  *
@@ -23,7 +24,7 @@ import { EntityDeepPartial, EntityId, Model, ModelExtension, Pagination, QueryDe
  * The service is designed to work with repositories that extend BaseRepository,
  * providing a consistent and type-safe way to interact with the database.
  *
- * @template BaseEntity - The entity type this service manages. This type parameter
+ * @template Entity - The entity type this service manages. This type parameter
  *                       represents the entity class that the service will work with.
  *                       It must extend the Model interface.
  *
@@ -76,12 +77,12 @@ export declare abstract class CrudService<Entity extends Model | ModelExtension>
      * The name of the entity this service manages
      * @private
      */
-    private readonly entityName;
+    protected readonly entityName: string;
     /**
      * Array of field names with unique constraints for the entity
      * @private
      */
-    private readonly uniqueFieldNames?;
+    protected readonly uniqueFieldNames?: string[];
     /**
      * Creates a new instance of CrudService
      *
@@ -90,7 +91,7 @@ export declare abstract class CrudService<Entity extends Model | ModelExtension>
      * includes the entity name and unique field names, which are used for error
      * handling and response generation.
      *
-     * @param {BaseRepository<BaseEntity>} repository - The repository for the entity
+     * @param {BaseRepository<Entity>} repository - The repository for the entity
      * @throws {ImplementationException} If no repository is provided
      *
      * @example
@@ -147,9 +148,10 @@ export declare abstract class CrudService<Entity extends Model | ModelExtension>
      * provided values. Use the `save` method to persist the entity.
      *
      * @template T - Type that extends DeepPartial of the base entity
+     * @template Entity - Type of the entity
      * @param {T} createDto - The data transfer object containing entity properties
      * @param {TypeORMErrorHandler} [eh] - Optional custom error handler
-     * @returns {BaseEntity} A new entity instance with the provided properties
+     * @returns {Entity} A new entity instance with the provided properties
      * @throws {HttpException} If an error occurs during entity creation
      *
      * @example
@@ -172,11 +174,12 @@ export declare abstract class CrudService<Entity extends Model | ModelExtension>
      * After saving, it retrieves the entity with any specified relations or options.
      *
      * @template T - Type that extends DeepPartial of the base entity
+     * @template Entity - Type of the entity
      * @param {T} createDto - The data transfer object containing entity properties
-     * @param {GetByIdOptions<BaseEntity>} [options] - Options for saving and retrieving the entity
-     * @param {UserInfo} [createdBy] - The user who created the entity (for audit tracking)
+     * @param {GetByIdOptions<Entity>} [options] - Options for saving and retrieving the entity
+     * @param {WithId} [createdBy] - The user who created the entity (for audit tracking)
      * @param {TypeORMErrorHandler} [eh] - Optional custom error handler
-     * @returns {Promise<BaseEntity | null>} The saved entity or null if not found
+     * @returns {Promise<Entity | null>} The saved entity or null if not found
      * @throws {HttpException} If an error occurs during entity creation or saving
      *
      * @example
@@ -212,11 +215,12 @@ export declare abstract class CrudService<Entity extends Model | ModelExtension>
      * property on each entity if a user is provided.
      *
      * @template T - Type that extends DeepPartial of the base entity
+     * @template Entity - Type of the entity
      * @param {T[]} createDtos - Array of data transfer objects containing entity properties
      * @param {SaveOptionsWithSkip} [options] - Options for saving entities, including skipCreate flag to control whether new entities should be created during save operations. When skipCreate is true, only updates existing entities. Defaults to false.
-     * @param {UserInfo} [createdBy] - The user who created the entities (for audit tracking)
+     * @param {WithId} [createdBy] - The user who created the entities (for audit tracking)
      * @param {TypeORMErrorHandler} [eh] - Optional custom error handler
-     * @returns {Promise<BaseEntity[]>} Array of saved entities
+     * @returns {Promise<Entity[]>} Array of saved entities
      * @throws {HttpException} If an error occurs during entity creation or saving
      *
      * @example
@@ -244,16 +248,17 @@ export declare abstract class CrudService<Entity extends Model | ModelExtension>
      * Updates an entity by its ID
      *
      * This method updates an entity with the specified ID using the provided data.
-     * It also sets the updatedBy property if a user is provided. After updating,
+     * It also sets the createdBy property if a user is provided. After updating,
      * it retrieves the updated entity with any specified relations or options.
      *
      * @template T - Type that extends QueryDeepPartial of the base entity
+     * @template Entity - Type of the entity
      * @param {EntityId} id - The ID of the entity to update
      * @param {T} updateDto - The data transfer object containing properties to update
-     * @param {GetByIdOptions<BaseEntity>} [options] - Options for retrieving the updated entity
-     * @param {UserInfo} [updatedBy] - The user who updated the entity (for audit tracking)
+     * @param {GetByIdOptions<Entity>} [options] - Options for retrieving the updated entity
+     * @param {WithId} [updatedBy] - The user who updated the entity (for audit tracking)
      * @param {TypeORMErrorHandler} [eh] - Optional custom error handler
-     * @returns {Promise<BaseEntity>} The updated entity
+     * @returns {Promise<Entity>} The updated entity
      * @throws {NotFoundException} If the entity with the given ID is not found or ID is invalid
      * @throws {InternalServerErrorException} If the update operation fails
      * @throws {HttpException} If any other error occurs during the update
@@ -291,16 +296,17 @@ export declare abstract class CrudService<Entity extends Model | ModelExtension>
      * Updates a single entity that matches the specified conditions
      *
      * This method updates the first entity that matches the given conditions.
-     * It also sets the updatedBy property if a user is provided. After updating,
+     * It also sets the createdBy property if a user is provided. After updating,
      * it retrieves the updated entity.
      *
      * @template T - Type that extends QueryDeepPartial of the base entity
-     * @param {QueryDeepPartial<BaseEntity>} where - Conditions to find the entity to update
+     * @template Entity - Type of the entity
+     * @param {QueryDeepPartial<Entity>} where - Conditions to find the entity to update
      * @param {T} updateDto - The data transfer object containing properties to update
-     * @param {Omit<GetOneOptions<BaseEntity>, "where">} options - Options for retrieving the updated entity, excluding the where condition
-     * @param {UserInfo} [updatedBy] - The user who updated the entity (for audit tracking)
+     * @param {Omit<GetOneOptions<Entity>, "where">} options - Options for retrieving the updated entity, excluding the where condition
+     * @param {WithId} [updatedBy] - The user who updated the entity (for audit tracking)
      * @param {TypeORMErrorHandler} [eh] - Optional custom error handler
-     * @returns {Promise<BaseEntity>} The updated entity
+     * @returns {Promise<Entity>} The updated entity
      * @throws {InternalServerErrorException} If the update operation fails
      * @throws {HttpException} If any other error occurs during the update
      *
@@ -325,18 +331,19 @@ export declare abstract class CrudService<Entity extends Model | ModelExtension>
      * @see {@link updateMany} Method to update multiple entities by conditions
      * @see {@link BaseRepository.updateOne} Repository method that performs the actual update operation
      */
-    updateOne<T extends EntityDeepPartial<Entity>>(where: QueryDeepPartial<Entity>, updateDto: T, options?: Omit<GetOneOptions<Entity>, "where">, updatedBy?: WithId, eh?: TypeORMErrorHandler): Promise<Entity>;
+    updateOne<T extends EntityDeepPartial<Entity>>(where: QueryDeepPartial<Entity> | QueryDeepPartial<Entity>[], updateDto: T, options?: Omit<GetOneOptions<Entity>, "where">, updatedBy?: WithId, eh?: TypeORMErrorHandler): Promise<Entity>;
     /**
      * Updates multiple entities that match the specified conditions
      *
      * This method updates all entities that match the given conditions.
-     * It also sets the updatedBy property if a user is provided. Unlike update and updateOne,
+     * It also sets the createdBy property if a user is provided. Unlike update and updateOne,
      * this method returns a success response rather than the updated entities.
      *
      * @template T - Type that extends QueryDeepPartial of the base entity
-     * @param {QueryDeepPartial<BaseEntity>} where - Conditions to find entities to update
+     * @template Entity - Type of the entity
+     * @param {QueryDeepPartial<Entity>} where - Conditions to find entities to update
      * @param {T} updateDto - The data transfer object containing properties to update
-     * @param {UserInfo} [updatedBy] - The user who updated the entities (for audit tracking)
+     * @param {WithId} [updatedBy] - The user who updated the entities (for audit tracking)
      * @param {TypeORMErrorHandler} [eh] - Optional custom error handler
      * @returns {Promise<SuccessResponse>} A success response indicating the update was successful
      * @throws {InternalServerErrorException} If the update operation fails
@@ -365,18 +372,18 @@ export declare abstract class CrudService<Entity extends Model | ModelExtension>
      * @see {@link BaseRepository.updateMany} Repository method that performs the actual update operation
      * @see {@link EntityUtils.handleSuccess} Utility method that generates the success response
      */
-    updateMany<T extends EntityDeepPartial<Entity>>(where: QueryDeepPartial<Entity>, updateDto: T, updatedBy?: WithId, eh?: TypeORMErrorHandler): Promise<SuccessResponse>;
+    updateMany<T extends EntityDeepPartial<Entity>>(where: QueryDeepPartial<Entity> | QueryDeepPartial<Entity>[], updateDto: T, updatedBy?: WithId, eh?: TypeORMErrorHandler): Promise<SuccessResponse>;
     /**
      * Updates multiple entities by their IDs
      *
      * This method updates all entities with the specified IDs using the provided data.
-     * It also sets the updatedBy property if a user is provided. Like updateMany,
+     * It also sets the createdBy property if a user is provided. Like updateMany,
      * this method returns a success response rather than the updated entities.
      *
      * @template T - Type that extends QueryDeepPartial of the base entity
      * @param {EntityId[]} ids - Array of entity IDs to update
      * @param {T} updateDto - The data transfer object containing properties to update
-     * @param {UserInfo} [updatedBy] - The user who updated the entities (for audit tracking)
+     * @param {WithId} [updatedBy] - The user who updated the entities (for audit tracking)
      * @param {TypeORMErrorHandler} [eh] - Optional custom error handler
      * @returns {Promise<SuccessResponse>} A success response indicating the update was successful
      * @throws {NotFoundException} If any of the IDs are invalid
@@ -414,9 +421,9 @@ export declare abstract class CrudService<Entity extends Model | ModelExtension>
      * entities if specified in the options.
      *
      * @param {EntityId} id - The ID of the entity to retrieve
-     * @param {GetByIdOptions<BaseEntity>} [options] - Options for retrieving the entity, such as relations to load
+     * @param {GetByIdOptions<Entity>} [options] - Options for retrieving the entity, such as relations to load
      * @param {TypeORMErrorHandler} [eh] - Optional custom error handler
-     * @returns {Promise<BaseEntity>} The retrieved entity
+     * @returns {Promise<Entity>} The retrieved entity
      * @throws {NotFoundException} If the entity with the given ID is not found or ID is invalid
      * @throws {HttpException} If any other error occurs during retrieval
      *
@@ -443,9 +450,9 @@ export declare abstract class CrudService<Entity extends Model | ModelExtension>
      * This method fetches all entities with the specified IDs. It can also load related
      * entities if specified in the options.
      *
-     * @param {GetByIdsOptions<BaseEntity>} getByIds - Options for retrieving entities, including the IDs and relations
+     * @param {GetByIdsOptions<Entity>} getByIds - Options for retrieving entities, including the IDs and relations
      * @param {TypeORMErrorHandler} [eh] - Optional custom error handler
-     * @returns {Promise<BaseEntity[]>} Array of retrieved entities
+     * @returns {Promise<Entity[]>} Array of retrieved entities
      * @throws {NotFoundException} If any of the IDs are invalid
      * @throws {HttpException} If any other error occurs during retrieval
      *
@@ -476,9 +483,9 @@ export declare abstract class CrudService<Entity extends Model | ModelExtension>
      * This method fetches the first entity that matches the given conditions.
      * It can also load related entities if specified in the options.
      *
-     * @param {GetOneOptions<BaseEntity>} getOne - Options for retrieving the entity, including conditions and relations
+     * @param {GetOneOptions<Entity>} getOne - Options for retrieving the entity, including conditions and relations
      * @param {TypeORMErrorHandler} [eh] - Optional custom error handler
-     * @returns {Promise<BaseEntity>} The retrieved entity
+     * @returns {Promise<Entity>} The retrieved entity
      * @throws {NotFoundException} If no entity matches the conditions
      * @throws {HttpException} If any other error occurs during retrieval
      *
@@ -510,9 +517,10 @@ export declare abstract class CrudService<Entity extends Model | ModelExtension>
      * information. Otherwise, it returns an array of entities.
      *
      * @template Options - Type that extends GetManyOptions for the base entity
+     * @template Entity - Type of the entity
      * @param {Options} getMany - Options for retrieving entities, including conditions, relations, and pagination
      * @param {TypeORMErrorHandler} [eh] - Optional custom error handler
-     * @returns {Promise<PaginatedResponse<BaseEntity> | BaseEntity[]>} Paginated response or array of entities
+     * @returns {Promise<PaginatedResponse<Entity> | Entity[]>} Paginated response or array of entities
      * @throws {HttpException} If any error occurs during retrieval
      *
      * @example
@@ -554,9 +562,10 @@ export declare abstract class CrudService<Entity extends Model | ModelExtension>
      * of entities.
      *
      * @template Options - Type that extends GetAllOptions for the base entity
+     * @template Entity - Type of the entity
      * @param {Options} [getAll] - Optional settings for retrieving entities, including relations and pagination
      * @param {TypeORMErrorHandler} [eh] - Optional custom error handler
-     * @returns {Promise<PaginatedResponse<BaseEntity> | BaseEntity[]>} Paginated response or array of entities
+     * @returns {Promise<PaginatedResponse<Entity> | Entity[]>} Paginated response or array of entities
      * @throws {HttpException} If any error occurs during retrieval
      *
      * @example
@@ -592,7 +601,7 @@ export declare abstract class CrudService<Entity extends Model | ModelExtension>
      * @param {EntityId} id - The ID of the entity to delete
      * @param {true} wipe - When true, performs a hard delete (permanent removal)
      * @param {TypeORMErrorHandler} [eh] - Optional custom error handler
-     * @returns {Promise<BaseEntity>} The deleted entity
+     * @returns {Promise<Entity>} The deleted entity
      * @throws {NotFoundException} If the entity with the given ID is not found or ID is invalid
      * @throws {HttpException} If any other error occurs during deletion
      */
@@ -603,9 +612,9 @@ export declare abstract class CrudService<Entity extends Model | ModelExtension>
      * This overload performs a soft delete and sets the deletedBy property for audit tracking.
      *
      * @param {EntityId} id - The ID of the entity to delete
-     * @param {UserInfo} deletedBy - The user who deleted the entity (for audit tracking)
+     * @param {WithId} deletedBy - The user who deleted the entity (for audit tracking)
      * @param {TypeORMErrorHandler} [eh] - Optional custom error handler
-     * @returns {Promise<BaseEntity>} The deleted entity
+     * @returns {Promise<Entity>} The deleted entity
      * @throws {NotFoundException} If the entity with the given ID is not found or ID is invalid
      * @throws {HttpException} If any other error occurs during deletion
      */
@@ -615,10 +624,10 @@ export declare abstract class CrudService<Entity extends Model | ModelExtension>
      *
      * This method supports both soft delete (default) and hard delete (permanent removal).
      *
-     * @param {QueryDeepPartial<BaseEntity>} where - Conditions to find the entity to delete
+     * @param {QueryDeepPartial<Entity>} where - Conditions to find the entity to delete
      * @param {true} wipe - When true, performs a hard delete (permanent removal)
      * @param {TypeORMErrorHandler} [eh] - Optional custom error handler
-     * @returns {Promise<BaseEntity>} The deleted entity
+     * @returns {Promise<Entity>} The deleted entity
      * @throws {NotFoundException} If no entity matches the conditions
      * @throws {HttpException} If any other error occurs during deletion
      */
@@ -628,10 +637,10 @@ export declare abstract class CrudService<Entity extends Model | ModelExtension>
      *
      * This overload performs a soft delete and sets the deletedBy property for audit tracking.
      *
-     * @param {QueryDeepPartial<BaseEntity>} where - Conditions to find the entity to delete
-     * @param {UserInfo} deletedBy - The user who deleted the entity (for audit tracking)
+     * @param {QueryDeepPartial<Entity>} where - Conditions to find the entity to delete
+     * @param {WithId} deletedBy - The user who deleted the entity (for audit tracking)
      * @param {TypeORMErrorHandler} [eh] - Optional custom error handler
-     * @returns {Promise<BaseEntity>} The deleted entity
+     * @returns {Promise<Entity>} The deleted entity
      * @throws {NotFoundException} If no entity matches the conditions
      * @throws {HttpException} If any other error occurs during deletion
      */
@@ -641,10 +650,10 @@ export declare abstract class CrudService<Entity extends Model | ModelExtension>
      *
      * This method supports both soft delete (default) and hard delete (permanent removal).
      *
-     * @param {QueryDeepPartial<BaseEntity>} where - Conditions to find entities to delete
+     * @param {QueryDeepPartial<Entity>} where - Conditions to find entities to delete
      * @param {true} wipe - When true, performs a hard delete (permanent removal)
      * @param {TypeORMErrorHandler} [eh] - Optional custom error handler
-     * @returns {Promise<BaseEntity[]>} Array of deleted entities
+     * @returns {Promise<Entity[]>} Array of deleted entities
      * @throws {NotFoundException} If no entities match the conditions
      * @throws {HttpException} If any other error occurs during deletion
      */
@@ -654,10 +663,10 @@ export declare abstract class CrudService<Entity extends Model | ModelExtension>
      *
      * This overload performs a soft delete and sets the deletedBy property for audit tracking.
      *
-     * @param {QueryDeepPartial<BaseEntity>} where - Conditions to find entities to delete
-     * @param {UserInfo} deletedBy - The user who deleted the entities (for audit tracking)
+     * @param {QueryDeepPartial<Entity>} where - Conditions to find entities to delete
+     * @param {WithId} deletedBy - The user who deleted the entities (for audit tracking)
      * @param {TypeORMErrorHandler} [eh] - Optional custom error handler
-     * @returns {Promise<BaseEntity[]>} Array of deleted entities
+     * @returns {Promise<Entity[]>} Array of deleted entities
      * @throws {NotFoundException} If no entities match the conditions
      * @throws {HttpException} If any other error occurs during deletion
      */
@@ -683,7 +692,7 @@ export declare abstract class CrudService<Entity extends Model | ModelExtension>
      * This overload performs a soft delete and sets the deletedBy property for audit tracking.
      *
      * @param {EntityId[]} ids - Array of entity IDs to delete
-     * @param {UserInfo} deletedBy - The user who deleted the entities (for audit tracking)
+     * @param {WithId} deletedBy - The user who deleted the entities (for audit tracking)
      * @param {TypeORMErrorHandler} [eh] - Optional custom error handler
      * @returns {Promise<SuccessResponse>} A success response indicating the deletion was successful
      * @throws {NotFoundException} If no entities with the given IDs are found
@@ -696,7 +705,7 @@ export declare abstract class CrudService<Entity extends Model | ModelExtension>
      * This method returns the number of entities that match the given conditions.
      * It's useful for getting counts without retrieving the actual entities.
      *
-     * @param {GetManyOptions<BaseEntity>} [getMany] - Options for filtering entities to count
+     * @param {GetManyOptions<Entity>} [getMany] - Options for filtering entities to count
      * @param {TypeORMErrorHandler} [eh] - Optional custom error handler
      * @returns {Promise<number>} The number of entities that match the conditions
      * @throws {HttpException} If any error occurs during the count operation
@@ -732,13 +741,14 @@ export declare abstract class CrudService<Entity extends Model | ModelExtension>
      * If an error occurs, the transaction is rolled back.
      *
      * @template T - The return type of the operation
+     * @param {(manager: EntityManager) => Promise<T>} operation - The operation to execute within the transaction
      * @returns {Promise<T>} The result of the operation
      * @throws {HttpException} If any error occurs during the transaction
      *
      * @example
      * ```typescript
      * // Execute multiple operations in a transaction
-     * const result = await userService.transaction(async (manager) => {
+     * const result = await userService.transaction(async (manager: EntityManager) => {
      *   // Create a user
      *   const user = await manager.getRepository(UserEntity).save({
      *     name: 'John Doe',
@@ -757,7 +767,7 @@ export declare abstract class CrudService<Entity extends Model | ModelExtension>
      *
      * @see {@link BaseRepository.transaction} Repository method that manages the transaction
      */
-    transaction<T>(operation: () => Promise<T>): Promise<T>;
+    transaction<T>(operation: (manager: EntityManager) => Promise<T>): Promise<T>;
     /**
      * Executes a function with error handling
      *