@gzl10/nexus-sdk 0.4.0 → 0.4.1

package/dist/index.d.ts

@@ -11,6 +11,8 @@ import { Logger } from 'pino';
  * que pueden ser escritos a archivos o usados en runtime.
  */
 
+/** Directorio estándar para código generado */
+declare const GENERATED_DIR = "__generated__";
 /**
  * Entidades que persisten en BD local con tabla propia
  * Excluye: action, external, virtual, computed, single (usa tabla compartida)
@@ -130,6 +132,15 @@ declare function generateSchemasFile(definitions: EntityDefinition[]): string;
  * writeFileSync('users.models.ts', code)
  */
 declare function generateModelsFile(definitions: EntityDefinition[]): string;
+/**
+ * Genera archivo completo de migración Knex para múltiples entidades
+ * Consolida todas las entidades de un módulo en un solo archivo de migración
+ *
+ * @example
+ * const code = generateMigrationsFile([userEntity, roleEntity])
+ * writeFileSync('users.migrate.ts', code)
+ */
+declare function generateMigrationsFile(definitions: EntityDefinition[]): string;
 
 /**
  * @gzl10/nexus-sdk
@@ -634,21 +645,6 @@ interface ModuleAbilities {
  * 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
- */
-interface UsersResolver {
-    findById: (id: string) => Promise<BaseUser | null>;
-    findByIds: (ids: string[]) => Promise<BaseUser[]>;
-}
-/**
- * Servicios core inyectados por el backend
- * Los plugins acceden a estos servicios via ctx.services
- */
-interface CoreServices {
-    users?: UsersResolver;
-}
 /**
  * Helpers para migraciones de base de datos
  */
@@ -713,8 +709,8 @@ interface ModuleContext {
             data?: Record<string, unknown>;
         }) => Promise<unknown>;
     };
-    /** Servicios de módulos core (users, etc.) */
-    services: CoreServices & Record<string, unknown>;
+    /** Servicios de módulos (inyectados por backend) */
+    services: Record<string, unknown>;
 }
 /**
  * Manifest de un módulo Nexus
@@ -722,8 +718,6 @@ interface ModuleContext {
 interface ModuleManifest {
     /** Identificador único del módulo (ej: 'users', 'posts') */
     name: string;
-    /** Código único del módulo (ej: 'USR', 'PST'). Opcional si pertenece a un plugin */
-    code?: string;
     /** Nombre para mostrar en UI. Opcional si pertenece a un plugin */
     label?: string;
     /** Icono del módulo (Iconify MDI: 'mdi:account-group') */
@@ -736,7 +730,7 @@ interface ModuleManifest {
     dependencies?: string[];
     /** Requisitos para activar el módulo */
     required?: ModuleRequirements;
-    /** Función de migración de base de datos */
+    /** Función de migración de base de datos. Normalmente se genera desde definitions (EntityDefinition) */
     migrate?: (ctx: ModuleContext) => Promise<void>;
     /** Función de seed de datos iniciales */
     seed?: (ctx: ModuleContext) => Promise<void>;
@@ -781,4 +775,4 @@ interface PluginManifest {
     modules: ModuleManifest[];
 }
 
-export { type AbilityLike, type ActionEntityDefinition, type AuthRequest, type BaseUser, type CaslAction, type CollectionEntityDefinition, type ComputedEntityDefinition, type ConfigEntityDefinition, type CoreServices, type DbType, type EntityCaslConfig, type EntityDefinition, type EntityIndex, type EventEntityDefinition, type ExternalEntityDefinition, type FieldCaslAccess, type FieldDbConfig, type FieldDefinition, type FieldMeta, type FieldOptions, type FieldRelation, type FieldValidation, type FieldValidationConfig, type ForbiddenErrorConstructor, type ForbiddenErrorInstance, type FormField, type FormFieldType, type GeneratedPermission, type InputType, type KnexAlterTableBuilder, type KnexCreateTableBuilder, type KnexTransaction, type ListType, type MigrationHelpers, 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 RolePermission, type SingleEntityDefinition, type TempEntityDefinition, type UsersResolver, type ValidateSchemas, type ValidationSchema, type ViewEntityDefinition, type VirtualEntityDefinition, generateCaslPermissions, generateCaslSeed, generateMigration, generateModel, generateModelsFile, generateReadOnlyModel, generateReadOnlySchema, generateSchemasFile, generateZodSchema, getEntityName, getEntitySubject, hasTable, isPersistentEntity, isSingletonEntity };
+export { type AbilityLike, type ActionEntityDefinition, type AuthRequest, type BaseUser, type CaslAction, type CollectionEntityDefinition, type ComputedEntityDefinition, type ConfigEntityDefinition, type DbType, type EntityCaslConfig, type EntityDefinition, type EntityIndex, type EventEntityDefinition, type ExternalEntityDefinition, type FieldCaslAccess, type FieldDbConfig, type FieldDefinition, type FieldMeta, type FieldOptions, type FieldRelation, type FieldValidation, type FieldValidationConfig, type ForbiddenErrorConstructor, type ForbiddenErrorInstance, type FormField, type FormFieldType, GENERATED_DIR, type GeneratedPermission, type InputType, type KnexAlterTableBuilder, type KnexCreateTableBuilder, type KnexTransaction, type ListType, type MigrationHelpers, 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 RolePermission, type SingleEntityDefinition, type TempEntityDefinition, type ValidateSchemas, type ValidationSchema, type ViewEntityDefinition, type VirtualEntityDefinition, generateCaslPermissions, generateCaslSeed, generateMigration, generateMigrationsFile, generateModel, generateModelsFile, generateReadOnlyModel, generateReadOnlySchema, generateSchemasFile, generateZodSchema, getEntityName, getEntitySubject, hasTable, isPersistentEntity, isSingletonEntity };

package/dist/index.js

@@ -1,4 +1,5 @@
 // src/generators.ts
+var GENERATED_DIR = "__generated__";
 function isPersistentEntity(entity) {
   const withoutOwnTable = ["action", "external", "virtual", "computed", "single"];
   return !withoutOwnTable.includes(entity.type ?? "collection");
@@ -648,10 +649,148 @@ function generateModelsFile(definitions) {
   }
   return lines.join("\n");
 }
+function generateMigrationsFile(definitions) {
+  const persistentEntities = definitions.filter(isPersistentEntity);
+  if (persistentEntities.length === 0) {
+    return [
+      "/**",
+      " * AUTO-GENERATED - Do not edit manually",
+      " * Generated from EntityDefinition via @gzl10/nexus-sdk generators",
+      " */",
+      "",
+      "import type { ModuleContext } from '@gzl10/nexus-sdk'",
+      "",
+      "// No persistent entities to migrate",
+      "export async function migrate(_ctx: ModuleContext): Promise<void> {}",
+      ""
+    ].join("\n");
+  }
+  const lines = [
+    "/**",
+    " * AUTO-GENERATED - Do not edit manually",
+    " * Generated from EntityDefinition via @gzl10/nexus-sdk generators",
+    " */",
+    "",
+    "import type { ModuleContext, Knex } from '@gzl10/nexus-sdk'",
+    "",
+    "export async function migrate(ctx: ModuleContext): Promise<void> {",
+    "  const { db, logger, helpers } = ctx",
+    "  const { addTimestamps, addAuditFieldsIfMissing } = helpers",
+    ""
+  ];
+  for (const entity of persistentEntities) {
+    const { table, fields } = entity;
+    const timestamps = "timestamps" in entity ? entity.timestamps : false;
+    const audit = "audit" in entity ? entity.audit : false;
+    const indexes = "indexes" in entity ? entity.indexes : void 0;
+    const name = getEntityName(entity);
+    lines.push(`  // === ${name.toUpperCase()} ===`);
+    lines.push(`  if (!(await db.schema.hasTable('${table}'))) {`);
+    lines.push(`    await db.schema.createTable('${table}', (table: Knex.CreateTableBuilder) => {`);
+    for (const [fieldName, field] of Object.entries(fields)) {
+      const columnCode = generateColumnCodeInline(fieldName, field);
+      lines.push(`      ${columnCode}`);
+    }
+    if (timestamps) {
+      lines.push(`      addTimestamps(table, db)`);
+    }
+    if (indexes?.length) {
+      lines.push("");
+      for (const idx of indexes) {
+        if (idx.unique) {
+          lines.push(`      table.unique([${idx.columns.map((c) => `'${c}'`).join(", ")}])`);
+        } else {
+          lines.push(`      table.index([${idx.columns.map((c) => `'${c}'`).join(", ")}])`);
+        }
+      }
+    }
+    lines.push(`    })`);
+    lines.push(`    logger.info('Created table: ${table}')`);
+    lines.push(`  }`);
+    if (audit) {
+      lines.push(`  await addAuditFieldsIfMissing(db, '${table}')`);
+    }
+    lines.push("");
+  }
+  lines.push("}");
+  lines.push("");
+  return lines.join("\n");
+}
+function generateColumnCodeInline(name, field) {
+  const { db } = field;
+  let code = "";
+  switch (db.type) {
+    case "string":
+      code = db.size ? `table.string('${name}', ${db.size})` : `table.string('${name}')`;
+      break;
+    case "text":
+      code = `table.text('${name}')`;
+      break;
+    case "integer":
+      code = `table.integer('${name}')`;
+      break;
+    case "decimal":
+      if (db.precision) {
+        code = `table.decimal('${name}', ${db.precision[0]}, ${db.precision[1]})`;
+      } else {
+        code = `table.decimal('${name}')`;
+      }
+      break;
+    case "boolean":
+      code = `table.boolean('${name}')`;
+      break;
+    case "date":
+      code = `table.date('${name}')`;
+      break;
+    case "datetime":
+      code = `table.datetime('${name}')`;
+      break;
+    case "json":
+      code = `table.json('${name}')`;
+      break;
+    case "uuid":
+      code = `table.uuid('${name}')`;
+      break;
+    default:
+      code = `table.string('${name}')`;
+  }
+  if (name === "id") {
+    code += ".primary()";
+  }
+  if (!db.nullable) {
+    code += ".notNullable()";
+  } else {
+    code += ".nullable()";
+  }
+  if (db.unique) {
+    code += ".unique()";
+  }
+  if (db.default !== void 0) {
+    if (typeof db.default === "string") {
+      code += `.defaultTo('${db.default}')`;
+    } else if (typeof db.default === "boolean") {
+      code += `.defaultTo(${db.default})`;
+    } else {
+      code += `.defaultTo(${db.default})`;
+    }
+  }
+  if (db.index) {
+    code += ".index()";
+  }
+  if (field.relation) {
+    code += `.references('${field.relation.column ?? "id"}').inTable('${field.relation.table}')`;
+    if (field.relation.onDelete) {
+      code += `.onDelete('${field.relation.onDelete}')`;
+    }
+  }
+  return code;
+}
 export {
+  GENERATED_DIR,
   generateCaslPermissions,
   generateCaslSeed,
   generateMigration,
+  generateMigrationsFile,
   generateModel,
   generateModelsFile,
   generateReadOnlyModel,

package/package.json

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