@gzl10/nexus-backend 0.1.5 → 0.11.1

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import http from 'node:http';
 import * as express_serve_static_core from 'express-serve-static-core';
 import knex, { Knex } from 'knex';
-import { ModuleManifest, PluginManifest, EntityQuery, PaginatedResult as PaginatedResult$1, EntityDefinition, ModuleContext, EntityServiceHooks, CollectionEntityDefinition, SingleEntityDefinition, ReferenceEntityDefinition, EventEntityDefinition, ConfigEntityDefinition, TempEntityDefinition, ViewEntityDefinition, ExternalEntityDefinition, VirtualEntityDefinition, ComputedEntityDefinition, ActionEntityDefinition, AuthRequest as AuthRequest$1 } from '@gzl10/nexus-sdk';
+import { ModuleManifest, PluginManifest, EntityQuery, PaginatedResult as PaginatedResult$1, EntityDefinition, ModuleContext, EntityServiceHooks, CollectionEntityDefinition, SingleEntityDefinition, ReferenceEntityDefinition, EventEntityDefinition, ConfigEntityDefinition, TempEntityDefinition, ViewEntityDefinition, ExternalEntityDefinition, VirtualEntityDefinition, ComputedEntityDefinition, ActionEntityDefinition, Request as Request$1, Response as Response$1, AuthRequest as AuthRequest$1 } from '@gzl10/nexus-sdk';
 export { Category, ContextHelpers, CookieOptions, EntityDefinition, EntityQuery, ModuleAbilities, ModuleContext, ModuleManifest, ModuleMiddlewares, ModuleRequirements, NextFunction, PluginManifest, Request, RequestHandler, Response, Router, ValidateSchemas } from '@gzl10/nexus-sdk';
 import { Request, Response, Router } from 'express';
 import pino from 'pino';
@@ -357,6 +357,27 @@ declare abstract class BaseEntityService<T = unknown> implements EntityService<T
      * Exclude sensitive fields from array of entities
      */
     protected excludeSensitiveFieldsFromArray<D extends Record<string, unknown>>(items: D[]): Partial<D>[];
+    /**
+     * Execute an action defined in this entity programmatically
+     *
+     * Allows invoking EntityActions from other services without HTTP context.
+     * NOTE: Does NOT verify CASL permissions - caller is responsible for authorization.
+     *
+     * @param actionKey - Key of the action to execute
+     * @param input - Input for the handler (without _record if recordId is provided)
+     * @param recordId - ID of the record (optional, loads automatically)
+     * @param options - Additional options
+     * @returns Result from the action handler
+     *
+     * @example
+     * // From another service
+     * const storageService = ctx.services['storage_files'] as CollectionService
+     * const result = await storageService.executeAction('thumbnail', { width: 200 }, fileId)
+     */
+    executeAction(actionKey: string, input?: Record<string, unknown>, recordId?: string, options?: {
+        userId?: string;
+        skipValidation?: boolean;
+    }): Promise<unknown>;
 }
 
 /**
@@ -583,6 +604,15 @@ declare class ConfigService<T extends Record<string, unknown> = Record<string, u
      * Reset config to defaults
      */
     resetToDefaults(id: string): Promise<T | null>;
+    /**
+     * Set a config as the default (only one can be default at a time)
+     */
+    setAsDefault(id: string): Promise<void>;
+    /**
+     * Get the default config record
+     * Fallback: first record ordered by created_at if no is_default: true
+     */
+    getDefault(): Promise<T | null>;
     /**
      * Merge entity with defaults
      */
@@ -854,8 +884,12 @@ declare class ActionService<T extends Record<string, unknown> = Record<string, u
     findById(_id: string): Promise<T | null>;
     /**
      * Execute the action
+     * @param input - Body data
+     * @param req - Express request (optional, for accessing files, params, etc.)
+     * @param res - Express response (optional, for streaming, custom headers, etc.)
+     * @returns Result to be sent as JSON, or undefined if handler controlled response
      */
-    execute(input: unknown): Promise<unknown>;
+    execute(input: unknown, req?: Request$1, res?: Response$1): Promise<unknown>;
     /**
      * Get action metadata
      */
@@ -921,7 +955,6 @@ interface Permission {
     created_by: string | null;
     updated_by: string | null;
 }
-
 /** User sin password para respuestas API */
 type UserWithoutPassword = Omit<User, 'password'>;
 /** Presencia del usuario (Socket.IO) */
@@ -988,9 +1021,6 @@ interface PaginatedResult<T> {
     hasNext: boolean;
 }
 
-/**
- * Tipos del módulo Auth
- */
 /**
  * Token de refresco para rotación de JWT
  */
@@ -999,6 +1029,8 @@ interface RefreshToken {
     token: string;
     user_id: string;
     expires_at: Date;
+    device_id?: string | null;
+    device_name?: string | null;
     created_at?: Date;
 }
 /**
@@ -1013,7 +1045,6 @@ interface AuthAudit {
     user_agent?: string | null;
     details?: Record<string, unknown> | null;
     created_at: Date;
-    updated_at: Date;
 }
 
 interface JwtPayload {
@@ -1161,14 +1192,14 @@ declare const sendNotificationInputSchema: z.ZodObject<{
     type: "error" | "info" | "warning" | "success";
     priority: "high" | "normal" | "low" | "urgent";
     title: string;
-    target_type: "all" | "user" | "authenticated" | "users" | "role";
+    target_type: "all" | "user" | "users" | "authenticated" | "role";
     link?: string | undefined;
     expires_at?: string | undefined;
     target_value?: string | undefined;
 }, {
     message: string;
     title: string;
-    target_type: "all" | "user" | "authenticated" | "users" | "role";
+    target_type: "all" | "user" | "users" | "authenticated" | "role";
     type?: "error" | "info" | "warning" | "success" | undefined;
     link?: string | undefined;
     expires_at?: string | undefined;
@@ -1211,6 +1242,11 @@ interface NotificationPayload {
 declare class NotificationService {
     private db;
     private logger;
+    private generateId;
+    private nowTimestamp;
+    private formatTimestamp;
+    private socket;
+    private events;
     constructor(ctx: ModuleContext);
     /**
      * Envía una notificación