@gzl10/nexus-sdk 0.9.0 → 0.10.0

package/dist/cli/index.js

@@ -150,6 +150,6 @@ New file: ${path}`));
 }
 
 // src/cli/index.ts
-var program = new Command2().name("nexus-sdk").description("Nexus SDK CLI - Code generation from EntityDefinitions").version("0.9.0");
+var program = new Command2().name("nexus-sdk").description("Nexus SDK CLI - Code generation from EntityDefinitions").version("0.10.0");
 program.addCommand(createGenerateCommand());
 program.parse();

package/dist/index.d.ts

@@ -839,6 +839,64 @@ interface ActionEntityService<T = unknown> {
     execute(data: Partial<T>): Promise<unknown>;
     readonly definition: EntityDefinition;
 }
+/**
+ * Hooks para personalizar comportamiento de servicios de entidad
+ * Permite a plugins añadir lógica sin necesitar herencia
+ */
+interface EntityServiceHooks<T = unknown> {
+    /**
+     * Ejecutado antes de crear un registro
+     * @param data Datos a insertar
+     * @returns Datos modificados
+     */
+    beforeCreate?: (data: Partial<T>) => Promise<Partial<T>> | Partial<T>;
+    /**
+     * Ejecutado después de crear un registro
+     * @param record Registro creado
+     */
+    afterCreate?: (record: T) => Promise<void> | void;
+    /**
+     * Ejecutado antes de actualizar un registro
+     * @param id ID del registro
+     * @param data Datos a actualizar
+     * @returns Datos modificados
+     */
+    beforeUpdate?: (id: string, data: Partial<T>) => Promise<Partial<T>> | Partial<T>;
+    /**
+     * Ejecutado después de actualizar un registro
+     * @param record Registro actualizado
+     */
+    afterUpdate?: (record: T) => Promise<void> | void;
+    /**
+     * Ejecutado antes de eliminar un registro
+     * @param id ID del registro
+     */
+    beforeDelete?: (id: string) => Promise<void> | void;
+    /**
+     * Ejecutado después de eliminar un registro
+     * @param id ID eliminado
+     */
+    afterDelete?: (id: string) => Promise<void> | void;
+    /**
+     * Ejecutado después de obtener un registro por ID
+     * @param record Registro obtenido (o null)
+     * @returns Registro modificado
+     */
+    afterFindById?: (record: T | null) => Promise<T | null> | T | null;
+    /**
+     * Ejecutado después de obtener lista paginada
+     * @param result Resultado paginado
+     * @returns Resultado modificado
+     */
+    afterFindAll?: (result: PaginatedResult<T>) => Promise<PaginatedResult<T>> | PaginatedResult<T>;
+}
+/**
+ * Opciones para createEntityService
+ */
+interface CreateEntityServiceOptions<T = unknown> {
+    /** Hooks para personalizar comportamiento */
+    hooks?: EntityServiceHooks<T>;
+}
 /**
  * Handler de entidad para Express
  */
@@ -881,7 +939,7 @@ interface ModuleContext {
     /** Servicios de módulos (inyectados por backend) */
     services: CoreServices;
     /** Factory para crear servicios de entidades (detecta tipo automáticamente) */
-    createEntityService<T = unknown>(definition: EntityDefinition): BaseEntityService<T>;
+    createEntityService<T = unknown>(definition: EntityDefinition, options?: CreateEntityServiceOptions<T>): BaseEntityService<T>;
     /** Factory para crear controller de entidad con CASL y validación */
     createEntityController(service: BaseEntityService, definition: EntityDefinition): EntityController;
     /** Factory para crear router de entidad con rutas CRUD */
@@ -948,4 +1006,4 @@ interface PluginManifest {
     modules: ModuleManifest[];
 }
 
-export { type AbilityLike, type ActionEntityDefinition, type ActionEntityService, type AuthRequest, type BaseEntityService, type BaseMailService, type BaseRolesService, type BaseUser, type BaseUsersService, type CaslAction, type CollectionEntityDefinition, type CollectionEntityService, type ComputedEntityDefinition, type ComputedEntityService, type ConfigEntityDefinition, type ConfigEntityService, type ContextHelpers, type CoreServices, type DbType, type EntityCaslConfig, type EntityController, type EntityDefinition, type EntityHandler, type EntityIndex, type EntityQuery, type EntityType, type EventEmitterLike, type EventEntityDefinition, type EventEntityService, type ExternalEntityDefinition, type ExternalEntityService, type FieldCaslAccess, type FieldDbConfig, type FieldDefinition, type FieldMeta, type FieldOptions, type FieldRelation, type FieldStorageConfig, type FieldValidationConfig, type ForbiddenErrorConstructor, type ForbiddenErrorInstance, GENERATED_DIR, type InputType, type KnexAlterTableBuilder, type KnexCreateTableBuilder, type KnexTransaction, type LoggerReporter, type ModuleAbilities, type ModuleContext, type ModuleManifest, type ModuleMiddlewares, type ModuleRequirements, type NonPersistentEntityDefinition, type OwnershipCondition, type PaginatedResult, type PaginationParams, type PersistentEntityDefinition, type PluginAuthRequest, type PluginCategory, type PluginManifest, type ReferenceEntityDefinition, type ReferenceEntityService, type RolePermission, type SendMailOptions, type SendMailResult, type SingleEntityDefinition, type SingleEntityService, type TempEntityDefinition, type TempEntityService, type ValidateSchemas, type ValidationSchema, type ViewEntityDefinition, type ViewEntityService, type VirtualEntityDefinition, type VirtualEntityService, generateModel, generateModelsFile, generateReadOnlyModel, getEntityName, getEntitySubject, hasTable, isPersistentEntity, isSingletonEntity };
+export { type AbilityLike, type ActionEntityDefinition, type ActionEntityService, type AuthRequest, type BaseEntityService, type BaseMailService, type BaseRolesService, type BaseUser, type BaseUsersService, type CaslAction, type CollectionEntityDefinition, type CollectionEntityService, type ComputedEntityDefinition, type ComputedEntityService, type ConfigEntityDefinition, type ConfigEntityService, type ContextHelpers, type CoreServices, type CreateEntityServiceOptions, type DbType, type EntityCaslConfig, type EntityController, type EntityDefinition, type EntityHandler, type EntityIndex, type EntityQuery, type EntityServiceHooks, type EntityType, type EventEmitterLike, type EventEntityDefinition, type EventEntityService, type ExternalEntityDefinition, type ExternalEntityService, type FieldCaslAccess, type FieldDbConfig, type FieldDefinition, type FieldMeta, type FieldOptions, type FieldRelation, type FieldStorageConfig, type FieldValidationConfig, type ForbiddenErrorConstructor, type ForbiddenErrorInstance, GENERATED_DIR, type InputType, type KnexAlterTableBuilder, type KnexCreateTableBuilder, type KnexTransaction, type LoggerReporter, type ModuleAbilities, type ModuleContext, type ModuleManifest, type ModuleMiddlewares, type ModuleRequirements, type NonPersistentEntityDefinition, type OwnershipCondition, type PaginatedResult, type PaginationParams, type PersistentEntityDefinition, type PluginAuthRequest, type PluginCategory, type PluginManifest, type ReferenceEntityDefinition, type ReferenceEntityService, type RolePermission, type SendMailOptions, type SendMailResult, type SingleEntityDefinition, type SingleEntityService, type TempEntityDefinition, type TempEntityService, type ValidateSchemas, type ValidationSchema, type ViewEntityDefinition, type ViewEntityService, type VirtualEntityDefinition, type VirtualEntityService, generateModel, generateModelsFile, generateReadOnlyModel, getEntityName, getEntitySubject, hasTable, isPersistentEntity, isSingletonEntity };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gzl10/nexus-sdk",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "SDK types for creating Nexus plugins and modules",
   "type": "module",
   "main": "./dist/index.js",