@hed-hog/lms 0.0.349 → 0.0.350

package/src/enterprise/enterprise.mcp-tools.ts

@@ -0,0 +1,403 @@
+import { McpContext, McpTool } from '@hed-hog/core';
+import { Injectable } from '@nestjs/common';
+import { EnterpriseService } from './enterprise.service';
+
+@Injectable()
+export class LmsEnterpriseMcpTools {
+  constructor(private readonly enterpriseService: EnterpriseService) {}
+
+  @McpTool({
+    name: 'lms.enterprise.list',
+    description: 'Lists enterprises with optional pagination and filters.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        page: { type: 'number', description: 'Page number (default: 1)' },
+        pageSize: { type: 'number', description: 'Items per page (default: 20)' },
+        search: { type: 'string', description: 'Search term' },
+        status: { type: 'string', description: 'Filter by status (active|trial|inactive|suspended)' },
+        crmPersonId: { type: 'number', description: 'Filter by CRM person ID' },
+      },
+    },
+    readOnly: true,
+  })
+  async listEnterprises(args: Record<string, any>, _context: McpContext): Promise<any> {
+    return this.enterpriseService.list(args);
+  }
+
+  @McpTool({
+    name: 'lms.enterprise.stats',
+    description: 'Returns aggregate statistics for enterprises.',
+    inputSchema: { type: 'object', properties: {} },
+    readOnly: true,
+  })
+  async getStats(_args: Record<string, any>, _context: McpContext): Promise<any> {
+    return this.enterpriseService.getStats();
+  }
+
+  @McpTool({
+    name: 'lms.enterprise.crm-options',
+    description: 'Returns CRM person options available for enterprise linking.',
+    inputSchema: { type: 'object', properties: {} },
+    readOnly: true,
+  })
+  async getCrmOptions(_args: Record<string, any>, _context: McpContext): Promise<any> {
+    return this.enterpriseService.getCrmOptions();
+  }
+
+  @McpTool({
+    name: 'lms.enterprise.get',
+    description: 'Returns a single enterprise by ID.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Enterprise ID' },
+      },
+      required: ['id'],
+    },
+    readOnly: true,
+  })
+  async getEnterprise(args: { id: number }, _context: McpContext): Promise<any> {
+    return this.enterpriseService.getById(args.id);
+  }
+
+  @McpTool({
+    name: 'lms.enterprise.overview',
+    description: 'Returns an overview summary of an enterprise (users, courses, classes, students, licenses).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Enterprise ID' },
+      },
+      required: ['id'],
+    },
+    readOnly: true,
+  })
+  async getOverview(args: { id: number }, _context: McpContext): Promise<any> {
+    return this.enterpriseService.getOverview(args.id);
+  }
+
+  @McpTool({
+    name: 'lms.enterprise.create',
+    description: 'Creates a new enterprise.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        name: { type: 'string', description: 'Enterprise name (required)' },
+        slug: { type: 'string', description: 'Unique slug' },
+        status: { type: 'string', description: 'Status (active|trial|inactive|suspended)' },
+        crmPersonId: { type: 'number', description: 'CRM person ID link' },
+        portalEnabled: { type: 'boolean', description: 'Whether the portal is enabled' },
+        licenseLimit: { type: 'number', description: 'License seat limit (null = unlimited)' },
+        notes: { type: 'string', description: 'Internal notes' },
+      },
+      required: ['name'],
+    },
+  })
+  async createEnterprise(args: Record<string, any>, _context: McpContext): Promise<any> {
+    return this.enterpriseService.create(args as any);
+  }
+
+  @McpTool({
+    name: 'lms.enterprise.update',
+    description: 'Updates an existing enterprise.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Enterprise ID' },
+        name: { type: 'string', description: 'Enterprise name' },
+        slug: { type: 'string', description: 'Unique slug' },
+        status: { type: 'string', description: 'Status (active|trial|inactive|suspended)' },
+        crmPersonId: { type: 'number', description: 'CRM person ID link' },
+        portalEnabled: { type: 'boolean', description: 'Whether the portal is enabled' },
+        licenseLimit: { type: 'number', description: 'License seat limit' },
+        notes: { type: 'string', description: 'Internal notes' },
+      },
+      required: ['id'],
+    },
+  })
+  async updateEnterprise(args: { id: number; [key: string]: any }, _context: McpContext): Promise<any> {
+    const { id, ...dto } = args;
+    return this.enterpriseService.update(id, dto as any);
+  }
+
+  @McpTool({
+    name: 'lms.enterprise.delete',
+    description: 'Deletes an enterprise by ID.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Enterprise ID' },
+      },
+      required: ['id'],
+    },
+  })
+  async deleteEnterprise(args: { id: number }, _context: McpContext): Promise<any> {
+    return this.enterpriseService.delete(args.id);
+  }
+
+  // ── Users ────────────────────────────────────────────────────────────────────
+
+  @McpTool({
+    name: 'lms.enterprise.users.list',
+    description: 'Lists users belonging to an enterprise.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Enterprise ID' },
+        page: { type: 'number', description: 'Page number' },
+        pageSize: { type: 'number', description: 'Items per page' },
+        search: { type: 'string', description: 'Search term' },
+        status: { type: 'string', description: 'Filter by status' },
+        role: { type: 'string', description: 'Filter by role' },
+      },
+      required: ['id'],
+    },
+    readOnly: true,
+  })
+  async listUsers(args: { id: number; [key: string]: any }, _context: McpContext): Promise<any> {
+    const { id, ...params } = args;
+    return this.enterpriseService.listUsers(id, params);
+  }
+
+  @McpTool({
+    name: 'lms.enterprise.users.add',
+    description: 'Adds a user to an enterprise.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Enterprise ID' },
+        userId: { type: 'number', description: 'User ID to add (required)' },
+        role: { type: 'string', description: 'User role within enterprise' },
+      },
+      required: ['id', 'userId'],
+    },
+  })
+  async addUser(args: { id: number; [key: string]: any }, _context: McpContext): Promise<any> {
+    const { id, ...dto } = args;
+    return this.enterpriseService.addUser(id, dto as any);
+  }
+
+  @McpTool({
+    name: 'lms.enterprise.users.update',
+    description: 'Updates a user within an enterprise (e.g., change role).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Enterprise ID' },
+        userId: { type: 'number', description: 'User ID' },
+        role: { type: 'string', description: 'New role' },
+      },
+      required: ['id', 'userId'],
+    },
+  })
+  async updateUser(args: { id: number; userId: number; [key: string]: any }, _context: McpContext): Promise<any> {
+    const { id, userId, ...dto } = args;
+    return this.enterpriseService.updateUser(id, userId, dto as any);
+  }
+
+  @McpTool({
+    name: 'lms.enterprise.users.remove',
+    description: 'Removes a user from an enterprise.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Enterprise ID' },
+        userId: { type: 'number', description: 'User ID to remove' },
+      },
+      required: ['id', 'userId'],
+    },
+  })
+  async removeUser(args: { id: number; userId: number }, _context: McpContext): Promise<any> {
+    return this.enterpriseService.removeUser(args.id, args.userId);
+  }
+
+  // ── Courses ──────────────────────────────────────────────────────────────────
+
+  @McpTool({
+    name: 'lms.enterprise.courses.list',
+    description: 'Lists courses assigned to an enterprise.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Enterprise ID' },
+        page: { type: 'number', description: 'Page number' },
+        pageSize: { type: 'number', description: 'Items per page' },
+        search: { type: 'string', description: 'Search term' },
+        status: { type: 'string', description: 'Filter by status' },
+      },
+      required: ['id'],
+    },
+    readOnly: true,
+  })
+  async listCourses(args: { id: number; [key: string]: any }, _context: McpContext): Promise<any> {
+    const { id, ...params } = args;
+    return this.enterpriseService.listCourses(id, params);
+  }
+
+  @McpTool({
+    name: 'lms.enterprise.courses.add',
+    description: 'Assigns a course to an enterprise.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Enterprise ID' },
+        courseId: { type: 'number', description: 'Course ID to assign (required)' },
+      },
+      required: ['id', 'courseId'],
+    },
+  })
+  async addCourse(args: { id: number; courseId: number }, _context: McpContext): Promise<any> {
+    return this.enterpriseService.addCourse(args.id, { courseId: args.courseId } as any);
+  }
+
+  @McpTool({
+    name: 'lms.enterprise.courses.remove',
+    description: 'Removes a course from an enterprise.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Enterprise ID' },
+        courseId: { type: 'number', description: 'Course ID to remove' },
+      },
+      required: ['id', 'courseId'],
+    },
+  })
+  async removeCourse(args: { id: number; courseId: number }, _context: McpContext): Promise<any> {
+    return this.enterpriseService.removeCourse(args.id, args.courseId);
+  }
+
+  // ── Class Groups ─────────────────────────────────────────────────────────────
+
+  @McpTool({
+    name: 'lms.enterprise.classes.list',
+    description: 'Lists class groups assigned to an enterprise.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Enterprise ID' },
+        page: { type: 'number', description: 'Page number' },
+        pageSize: { type: 'number', description: 'Items per page' },
+        search: { type: 'string', description: 'Search term' },
+        status: { type: 'string', description: 'Filter by status' },
+      },
+      required: ['id'],
+    },
+    readOnly: true,
+  })
+  async listClasses(args: { id: number; [key: string]: any }, _context: McpContext): Promise<any> {
+    const { id, ...params } = args;
+    return this.enterpriseService.listClassGroups(id, params);
+  }
+
+  @McpTool({
+    name: 'lms.enterprise.classes.add',
+    description: 'Assigns a class group to an enterprise.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Enterprise ID' },
+        classGroupId: { type: 'number', description: 'Class group ID to assign (required)' },
+      },
+      required: ['id', 'classGroupId'],
+    },
+  })
+  async addClass(args: { id: number; classGroupId: number }, _context: McpContext): Promise<any> {
+    return this.enterpriseService.addClassGroup(args.id, { classGroupId: args.classGroupId } as any);
+  }
+
+  @McpTool({
+    name: 'lms.enterprise.classes.remove',
+    description: 'Removes a class group from an enterprise.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Enterprise ID' },
+        classGroupId: { type: 'number', description: 'Class group ID to remove' },
+      },
+      required: ['id', 'classGroupId'],
+    },
+  })
+  async removeClass(args: { id: number; classGroupId: number }, _context: McpContext): Promise<any> {
+    return this.enterpriseService.removeClassGroup(args.id, args.classGroupId);
+  }
+
+  // ── Students ─────────────────────────────────────────────────────────────────
+
+  @McpTool({
+    name: 'lms.enterprise.students.list',
+    description: 'Lists students belonging to an enterprise.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Enterprise ID' },
+        page: { type: 'number', description: 'Page number' },
+        pageSize: { type: 'number', description: 'Items per page' },
+        search: { type: 'string', description: 'Search term' },
+        status: { type: 'string', description: 'Filter by status' },
+      },
+      required: ['id'],
+    },
+    readOnly: true,
+  })
+  async listStudents(args: { id: number; [key: string]: any }, _context: McpContext): Promise<any> {
+    const { id, ...params } = args;
+    return this.enterpriseService.listStudents(id, params);
+  }
+
+  @McpTool({
+    name: 'lms.enterprise.students.add',
+    description: 'Adds a student to an enterprise.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Enterprise ID' },
+        personId: { type: 'number', description: 'Person ID to add as student' },
+        name: { type: 'string', description: 'Student name (for new person creation)' },
+        email: { type: 'string', description: 'Student email' },
+        department: { type: 'string', description: 'Department' },
+      },
+      required: ['id'],
+    },
+  })
+  async addStudent(args: { id: number; [key: string]: any }, _context: McpContext): Promise<any> {
+    const { id, ...dto } = args;
+    return this.enterpriseService.addStudent(id, dto as any);
+  }
+
+  @McpTool({
+    name: 'lms.enterprise.students.update',
+    description: "Updates a student's data within an enterprise.",
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Enterprise ID' },
+        personId: { type: 'number', description: 'Person ID' },
+        name: { type: 'string', description: 'Student name' },
+        email: { type: 'string', description: 'Student email' },
+        department: { type: 'string', description: 'Department' },
+      },
+      required: ['id', 'personId'],
+    },
+  })
+  async updateStudent(args: { id: number; personId: number; [key: string]: any }, _context: McpContext): Promise<any> {
+    const { id, personId, ...dto } = args;
+    return this.enterpriseService.updateStudent(id, personId, dto as any);
+  }
+
+  @McpTool({
+    name: 'lms.enterprise.students.remove',
+    description: 'Removes a student from an enterprise.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'number', description: 'Enterprise ID' },
+        personId: { type: 'number', description: 'Person ID to remove' },
+      },
+      required: ['id', 'personId'],
+    },
+  })
+  async removeStudent(args: { id: number; personId: number }, _context: McpContext): Promise<any> {
+    return this.enterpriseService.removeStudent(args.id, args.personId);
+  }
+}

package/src/enterprise/enterprise.module.ts

@@ -2,12 +2,13 @@ import { FileModule } from '@hed-hog/core';
 import { PrismaModule } from '@hed-hog/api-prisma';
 import { forwardRef, Module } from '@nestjs/common';
 import { EnterpriseController } from './enterprise.controller';
+import { LmsEnterpriseMcpTools } from './enterprise.mcp-tools';
 import { EnterpriseService } from './enterprise.service';
 
 @Module({
   imports: [forwardRef(() => PrismaModule), forwardRef(() => FileModule)],
   controllers: [EnterpriseController],
-  providers: [EnterpriseService],
+  providers: [EnterpriseService, LmsEnterpriseMcpTools],
   exports: [forwardRef(() => EnterpriseService)],
 })
 export class EnterpriseModule {}

package/src/enterprise/training/enterprise-training.module.ts

@@ -2,10 +2,13 @@ import { PrismaModule } from '@hed-hog/api-prisma';
 import { FileModule } from '@hed-hog/core';
 import { forwardRef, Module } from '@nestjs/common';
 import { TrainingAdminController } from './training-admin.controller';
+import { LmsTrainingAdminMcpTools } from './training-admin.mcp-tools';
 import { TrainingAdminService } from './training-admin.service';
 import { TrainingInstructorController } from './training-instructor.controller';
+import { LmsTrainingInstructorMcpTools } from './training-instructor.mcp-tools';
 import { TrainingInstructorService } from './training-instructor.service';
 import { TrainingStudentController } from './training-student.controller';
+import { LmsTrainingStudentMcpTools } from './training-student.mcp-tools';
 import { TrainingStudentService } from './training-student.service';
 import { TrainingViewerController } from './training-viewer.controller';
 
@@ -17,7 +20,14 @@ import { TrainingViewerController } from './training-viewer.controller';
     TrainingInstructorController,
     TrainingStudentController,
   ],
-  providers: [TrainingAdminService, TrainingInstructorService, TrainingStudentService],
+  providers: [
+    TrainingAdminService,
+    TrainingInstructorService,
+    TrainingStudentService,
+    LmsTrainingAdminMcpTools,
+    LmsTrainingInstructorMcpTools,
+    LmsTrainingStudentMcpTools,
+  ],
   exports: [
     forwardRef(() => TrainingAdminService),
     forwardRef(() => TrainingInstructorService),