@gzl10/nexus-sdk 0.1.8 → 0.1.10

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { Knex } from 'knex';
+export { Knex } from 'knex';
 import { Request, RequestHandler, Router } from 'express';
 export { CookieOptions, NextFunction, Request, RequestHandler, Response, Router } from 'express';
 import { Logger } from 'pino';
@@ -11,6 +12,9 @@ import { Logger } from 'pino';
  * depending on the full @gzl10/nexus-backend package.
  */
 
+type KnexCreateTableBuilder = Knex.CreateTableBuilder;
+type KnexAlterTableBuilder = Knex.AlterTableBuilder;
+type KnexTransaction = Knex.Transaction;
 /**
  * Request autenticado con usuario y abilities CASL
  * El backend especializa TUser y TAbility con tipos concretos
@@ -108,6 +112,43 @@ interface ModuleRequirements {
     env?: string[];
     modules?: string[];
 }
+/**
+ * Interfaz genérica para ability CASL
+ * Permite verificar permisos sin depender directamente de @casl/ability
+ */
+interface AbilityLike {
+    can: (action: string, subject: unknown) => boolean;
+    cannot: (action: string, subject: unknown) => boolean;
+}
+/**
+ * Error de forbidden con método throwUnlessCan
+ */
+interface ForbiddenErrorInstance {
+    throwUnlessCan: (action: string, subject: unknown) => void;
+}
+/**
+ * Constructor de ForbiddenError con método from()
+ */
+interface ForbiddenErrorConstructor {
+    from: (ability: AbilityLike) => ForbiddenErrorInstance;
+}
+/**
+ * Abilities CASL disponibles en el contexto
+ * Permite usar CASL en plugins sin importar @casl/ability directamente
+ */
+interface ModuleAbilities {
+    /** Wrapper para verificar permisos contra instancias */
+    subject: (type: string, object: unknown) => unknown;
+    /** Error de CASL para throwUnlessCan */
+    ForbiddenError: ForbiddenErrorConstructor;
+    /** Otros métodos que el backend pueda añadir */
+    [key: string]: unknown;
+}
+/**
+ * AuthRequest pre-tipado para uso en plugins
+ * Usa BaseUser y AbilityLike para tipado básico sin depender del backend
+ */
+type PluginAuthRequest = AuthRequest<BaseUser, AbilityLike>;
 /**
  * Resolver de usuarios para plugins
  * Permite acceder a usuarios sin conocer la implementación interna
@@ -131,16 +172,27 @@ interface MigrationHelpers {
     addAuditFieldsIfMissing: (db: Knex, tableName: string) => Promise<void>;
     addColumnIfMissing: (db: Knex, tableName: string, columnName: string, columnBuilder: (table: Knex.AlterTableBuilder) => void) => Promise<boolean>;
 }
+/**
+ * Schema de validación genérico (compatible con Zod sin depender de él)
+ * Cualquier objeto con método parse() es válido
+ */
+interface ValidationSchema {
+    parse: (data: unknown) => unknown;
+}
+/**
+ * Opciones para el middleware de validación
+ */
+interface ValidateSchemas {
+    body?: ValidationSchema;
+    query?: ValidationSchema;
+    params?: ValidationSchema;
+}
 /**
  * Middlewares disponibles en el contexto
  */
 interface ModuleMiddlewares {
-    validate: (schemas: {
-        body?: unknown;
-        query?: unknown;
-        params?: unknown;
-    }) => RequestHandler;
-    [key: string]: RequestHandler | ((...args: unknown[]) => RequestHandler) | undefined;
+    validate: (schemas: ValidateSchemas) => RequestHandler;
+    [key: string]: RequestHandler | ((...args: any[]) => RequestHandler) | undefined;
 }
 /**
  * Contexto inyectado a los módulos
@@ -157,12 +209,12 @@ interface ModuleContext {
     config: Record<string, unknown>;
     errors: {
         AppError: new (message: string, statusCode?: number) => Error;
-        NotFoundError: new (message: string) => Error;
-        UnauthorizedError: new (message: string) => Error;
-        ForbiddenError: new (message: string) => Error;
-        ConflictError: new (message: string) => Error;
+        NotFoundError: new (message?: string) => Error;
+        UnauthorizedError: new (message?: string) => Error;
+        ForbiddenError: new (message?: string) => Error;
+        ConflictError: new (message?: string) => Error;
     };
-    abilities: Record<string, unknown>;
+    abilities: ModuleAbilities;
     events: {
         emit: (event: string, ...args: unknown[]) => boolean;
         on: (event: string, listener: (...args: unknown[]) => void) => unknown;
@@ -241,4 +293,4 @@ interface PluginManifest {
     modules: ModuleManifest[];
 }
 
-export type { AuthRequest, BaseUser, CoreServices, FieldValidation, FormField, FormFieldType, ListType, MigrationHelpers, ModuleContext, ModuleEntity, ModuleManifest, ModuleMiddlewares, ModuleRequirements, PaginatedResult, PaginationParams, PluginCategory, PluginManifest, UsersResolver };
+export type { AbilityLike, AuthRequest, BaseUser, CoreServices, FieldValidation, ForbiddenErrorConstructor, ForbiddenErrorInstance, FormField, FormFieldType, KnexAlterTableBuilder, KnexCreateTableBuilder, KnexTransaction, ListType, MigrationHelpers, ModuleAbilities, ModuleContext, ModuleEntity, ModuleManifest, ModuleMiddlewares, ModuleRequirements, PaginatedResult, PaginationParams, PluginAuthRequest, PluginCategory, PluginManifest, UsersResolver, ValidateSchemas, ValidationSchema };

package/package.json

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