@gzl10/nexus-backend 0.11.0 → 0.12.0

package/dist/cli.js

@@ -1,12 +1,28 @@
 #!/usr/bin/env node
 
-// src/cli.ts
+// src/env-loader.ts
 import { existsSync } from "fs";
+import { join, dirname } from "path";
+import { config } from "dotenv";
+var dir = process.cwd();
+console.log("[env-loader] Starting search from cwd:", dir);
+for (let i = 0; i < 5; i++) {
+  const envPath = join(dir, ".env");
+  const exists = existsSync(envPath);
+  console.log(`[env-loader] Checking: ${envPath}`, exists ? "\u2713 FOUND" : "\u2717 not found");
+  if (exists) {
+    config({ path: envPath });
+    console.log("[env-loader] Loaded:", envPath);
+    break;
+  }
+  const parent = dirname(dir);
+  if (parent === dir) break;
+  dir = parent;
+}
+
+// src/cli.ts
 import { Command } from "commander";
 import { consola } from "consola";
-if (existsSync(".env")) {
-  process.loadEnvFile(".env");
-}
 var program = new Command();
 program.name("nexus").description("Nexus Backend CLI").version("0.1.0");
 program.command("ui").description("Open UI in browser").option("-p, --port <port>", "Nexus backend port").action(async (options) => {

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { existsSync } from 'fs'\nimport { Command } from 'commander'\nimport { consola } from 'consola'\n\n// Cargar .env si existe (Node 20+)\nif (existsSync('.env')) {\n  process.loadEnvFile('.env')\n}\n\nconst program = new Command()\n\nprogram\n  .name('nexus')\n  .description('Nexus Backend CLI')\n  .version('0.1.0')\n\nprogram\n  .command('ui')\n  .description('Open UI in browser')\n  .option('-p, --port <port>', 'Nexus backend port')\n  .action(async (options) => {\n    const port = parseInt(options.port || process.env['PORT'] || '3000', 10)\n    const baseUrl = (process.env['BACKEND_URL'] || `http://localhost:${port}`).replace(/\\/$/, '')\n    const url = `${baseUrl}/ui`\n\n    // Verificar que Nexus está corriendo\n    try {\n      const res = await fetch(`${baseUrl}/health`)\n      if (!res.ok) throw new Error()\n    } catch {\n      consola.error(`Nexus no está corriendo en ${baseUrl}`)\n      consola.info('Inicia el servidor primero con: pnpm dev')\n      process.exit(1)\n    }\n\n    // Abrir navegador\n    const { exec } = await import('child_process')\n    const cmd = process.platform === 'darwin' ? 'open'\n              : process.platform === 'win32' ? 'start'\n              : 'xdg-open'\n\n    exec(`${cmd} ${url}`)\n    consola.success(`Abriendo: ${url}`)\n  })\n\nprogram.parse()\n"],"mappings":";;;AACA,SAAS,kBAAkB;AAC3B,SAAS,eAAe;AACxB,SAAS,eAAe;AAGxB,IAAI,WAAW,MAAM,GAAG;AACtB,UAAQ,YAAY,MAAM;AAC5B;AAEA,IAAM,UAAU,IAAI,QAAQ;AAE5B,QACG,KAAK,OAAO,EACZ,YAAY,mBAAmB,EAC/B,QAAQ,OAAO;AAElB,QACG,QAAQ,IAAI,EACZ,YAAY,oBAAoB,EAChC,OAAO,qBAAqB,oBAAoB,EAChD,OAAO,OAAO,YAAY;AACzB,QAAM,OAAO,SAAS,QAAQ,QAAQ,QAAQ,IAAI,MAAM,KAAK,QAAQ,EAAE;AACvE,QAAM,WAAW,QAAQ,IAAI,aAAa,KAAK,oBAAoB,IAAI,IAAI,QAAQ,OAAO,EAAE;AAC5F,QAAM,MAAM,GAAG,OAAO;AAGtB,MAAI;AACF,UAAM,MAAM,MAAM,MAAM,GAAG,OAAO,SAAS;AAC3C,QAAI,CAAC,IAAI,GAAI,OAAM,IAAI,MAAM;AAAA,EAC/B,QAAQ;AACN,YAAQ,MAAM,iCAA8B,OAAO,EAAE;AACrD,YAAQ,KAAK,0CAA0C;AACvD,YAAQ,KAAK,CAAC;AAAA,EAChB;AAGA,QAAM,EAAE,KAAK,IAAI,MAAM,OAAO,eAAe;AAC7C,QAAM,MAAM,QAAQ,aAAa,WAAW,SAChC,QAAQ,aAAa,UAAU,UAC/B;AAEZ,OAAK,GAAG,GAAG,IAAI,GAAG,EAAE;AACpB,UAAQ,QAAQ,aAAa,GAAG,EAAE;AACpC,CAAC;AAEH,QAAQ,MAAM;","names":[]}
+{"version":3,"sources":["../src/env-loader.ts","../src/cli.ts"],"sourcesContent":["/**\n * Carga .env antes de cualquier otro import del proyecto\n * Este archivo SOLO importa de node/npm, nunca de archivos locales\n */\nimport { existsSync } from 'fs'\nimport { join, dirname } from 'path'\nimport { config } from 'dotenv'\n\nlet dir = process.cwd()\nconsole.log('[env-loader] Starting search from cwd:', dir)\n\nfor (let i = 0; i < 5; i++) {\n  const envPath = join(dir, '.env')\n  const exists = existsSync(envPath)\n  console.log(`[env-loader] Checking: ${envPath}`, exists ? '✓ FOUND' : '✗ not found')\n  if (exists) {\n    config({ path: envPath })\n    console.log('[env-loader] Loaded:', envPath)\n    break\n  }\n  const parent = dirname(dir)\n  if (parent === dir) break\n  dir = parent\n}\n","#!/usr/bin/env node\nimport './env-loader.js'\nimport { Command } from 'commander'\nimport { consola } from 'consola'\n\nconst program = new Command()\n\nprogram\n  .name('nexus')\n  .description('Nexus Backend CLI')\n  .version('0.1.0')\n\nprogram\n  .command('ui')\n  .description('Open UI in browser')\n  .option('-p, --port <port>', 'Nexus backend port')\n  .action(async (options) => {\n    const port = parseInt(options.port || process.env['PORT'] || '3000', 10)\n    const baseUrl = (process.env['BACKEND_URL'] || `http://localhost:${port}`).replace(/\\/$/, '')\n    const url = `${baseUrl}/ui`\n\n    // Verificar que Nexus está corriendo\n    try {\n      const res = await fetch(`${baseUrl}/health`)\n      if (!res.ok) throw new Error()\n    } catch {\n      consola.error(`Nexus no está corriendo en ${baseUrl}`)\n      consola.info('Inicia el servidor primero con: pnpm dev')\n      process.exit(1)\n    }\n\n    // Abrir navegador\n    const { exec } = await import('child_process')\n    const cmd = process.platform === 'darwin' ? 'open'\n              : process.platform === 'win32' ? 'start'\n              : 'xdg-open'\n\n    exec(`${cmd} ${url}`)\n    consola.success(`Abriendo: ${url}`)\n  })\n\nprogram.parse()\n"],"mappings":";;;AAIA,SAAS,kBAAkB;AAC3B,SAAS,MAAM,eAAe;AAC9B,SAAS,cAAc;AAEvB,IAAI,MAAM,QAAQ,IAAI;AACtB,QAAQ,IAAI,0CAA0C,GAAG;AAEzD,SAAS,IAAI,GAAG,IAAI,GAAG,KAAK;AAC1B,QAAM,UAAU,KAAK,KAAK,MAAM;AAChC,QAAM,SAAS,WAAW,OAAO;AACjC,UAAQ,IAAI,0BAA0B,OAAO,IAAI,SAAS,iBAAY,kBAAa;AACnF,MAAI,QAAQ;AACV,WAAO,EAAE,MAAM,QAAQ,CAAC;AACxB,YAAQ,IAAI,wBAAwB,OAAO;AAC3C;AAAA,EACF;AACA,QAAM,SAAS,QAAQ,GAAG;AAC1B,MAAI,WAAW,IAAK;AACpB,QAAM;AACR;;;ACrBA,SAAS,eAAe;AACxB,SAAS,eAAe;AAExB,IAAM,UAAU,IAAI,QAAQ;AAE5B,QACG,KAAK,OAAO,EACZ,YAAY,mBAAmB,EAC/B,QAAQ,OAAO;AAElB,QACG,QAAQ,IAAI,EACZ,YAAY,oBAAoB,EAChC,OAAO,qBAAqB,oBAAoB,EAChD,OAAO,OAAO,YAAY;AACzB,QAAM,OAAO,SAAS,QAAQ,QAAQ,QAAQ,IAAI,MAAM,KAAK,QAAQ,EAAE;AACvE,QAAM,WAAW,QAAQ,IAAI,aAAa,KAAK,oBAAoB,IAAI,IAAI,QAAQ,OAAO,EAAE;AAC5F,QAAM,MAAM,GAAG,OAAO;AAGtB,MAAI;AACF,UAAM,MAAM,MAAM,MAAM,GAAG,OAAO,SAAS;AAC3C,QAAI,CAAC,IAAI,GAAI,OAAM,IAAI,MAAM;AAAA,EAC/B,QAAQ;AACN,YAAQ,MAAM,iCAA8B,OAAO,EAAE;AACrD,YAAQ,KAAK,0CAA0C;AACvD,YAAQ,KAAK,CAAC;AAAA,EAChB;AAGA,QAAM,EAAE,KAAK,IAAI,MAAM,OAAO,eAAe;AAC7C,QAAM,MAAM,QAAQ,aAAa,WAAW,SAChC,QAAQ,aAAa,UAAU,UAC/B;AAEZ,OAAK,GAAG,GAAG,IAAI,GAAG,EAAE;AACpB,UAAQ,QAAQ,aAAa,GAAG,EAAE;AACpC,CAAC;AAEH,QAAQ,MAAM;","names":[]}

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
@@ -1265,5 +1301,10 @@ declare function getLibPath(): string;
  * - Lib: /proyecto-usuario/
  */
 declare function getProjectPath(): string;
+/**
+ * Busca .env subiendo desde cwd hasta encontrarlo (máx 5 niveles)
+ * Útil para monorepos donde el .env está en la raíz
+ */
+declare function findEnvFile(): string | null;
 
-export { ActionService, type Actions, type AppAbility, type AuthAudit, type AuthRequest, BaseEntityService, CollectionService, ComputedService, ConfigService, type DbEventPayload, type EntityController, type EntityHandler, type EntityRuntime, type EntityService, EventService, type ExternalAdapter, ExternalService, type JwtPayload, type NexusConfig, type NexusEventName, type NexusEventPayload, type NexusEvents, type Notification, type NotificationPayload, type NotificationPriority, NotificationService, type NotificationTarget, type NotificationType, type PaginatedResult, type PaginationParams, type Permission, ReferenceService, type RefreshToken, type ResolvedConfig, type Role, type RoleWithCounts, type RoleWithPermissions, type SendNotificationInput, SingleService, type SubjectRegistry, type SubjectStrings, type Subjects, TempService, type TokenPair, type User, type UserPresence, type UserWithRole, type UserWithoutPassword, ViewService, VirtualService, closeSocketIO, createApp, createEntityRuntime, createEntityService, createModuleRouters, createModuleServices, db, defineAbilityFor, destroyDb, getAdapter, getConfig, getConnectedUsers, getDatabaseType, getDb, getIO, getLibPath, getModule, getModules, getNotificationService, getOrderedModules, getPlugin, getPlugins, getProjectPath, getRegisteredSubjects, getServiceKey, getUserSocketCount, initNotificationService, initSocketIO, isRunning, isSocketIOInitialized, isUserConnected, isValidSubject, loadCoreModules, nexusEvents, packRules, registerAdapter, registerModule, registerPlugin, restart, start, stop, unpackRules };
+export { ActionService, type Actions, type AppAbility, type AuthAudit, type AuthRequest, BaseEntityService, CollectionService, ComputedService, ConfigService, type DbEventPayload, type EntityController, type EntityHandler, type EntityRuntime, type EntityService, EventService, type ExternalAdapter, ExternalService, type JwtPayload, type NexusConfig, type NexusEventName, type NexusEventPayload, type NexusEvents, type Notification, type NotificationPayload, type NotificationPriority, NotificationService, type NotificationTarget, type NotificationType, type PaginatedResult, type PaginationParams, type Permission, ReferenceService, type RefreshToken, type ResolvedConfig, type Role, type RoleWithCounts, type RoleWithPermissions, type SendNotificationInput, SingleService, type SubjectRegistry, type SubjectStrings, type Subjects, TempService, type TokenPair, type User, type UserPresence, type UserWithRole, type UserWithoutPassword, ViewService, VirtualService, closeSocketIO, createApp, createEntityRuntime, createEntityService, createModuleRouters, createModuleServices, db, defineAbilityFor, destroyDb, findEnvFile, getAdapter, getConfig, getConnectedUsers, getDatabaseType, getDb, getIO, getLibPath, getModule, getModules, getNotificationService, getOrderedModules, getPlugin, getPlugins, getProjectPath, getRegisteredSubjects, getServiceKey, getUserSocketCount, initNotificationService, initSocketIO, isRunning, isSocketIOInitialized, isUserConnected, isValidSubject, loadCoreModules, nexusEvents, packRules, registerAdapter, registerModule, registerPlugin, restart, start, stop, unpackRules };