@gzl10/nexus-sdk 0.1.8 → 0.1.9

package/dist/index.d.ts

@@ -108,6 +108,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
@@ -157,12 +194,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 +278,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, ListType, MigrationHelpers, ModuleAbilities, ModuleContext, ModuleEntity, ModuleManifest, ModuleMiddlewares, ModuleRequirements, PaginatedResult, PaginationParams, PluginAuthRequest, PluginCategory, PluginManifest, UsersResolver };

package/package.json

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