@hed-hog/core 0.0.350 → 0.0.351

package/src/mcp/tools/core-routes.mcp-tools.ts

@@ -0,0 +1,196 @@
+import { Injectable } from '@nestjs/common';
+import { PageOrderDirection } from '@hed-hog/api-pagination';
+import { RouteService } from '../../route/route.service';
+import { McpTool } from '../decorators/mcp-tool.decorator';
+import { McpContext } from '../types/mcp-context.type';
+
+@Injectable()
+export class CoreRoutesMcpTools {
+  constructor(private readonly routeService: RouteService) {}
+
+  @McpTool({
+    name: 'core.routes.list',
+    description: 'Lists all routes with optional pagination and search. Admin only.',
+    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' },
+        sortField: { type: 'string', description: 'Field to sort by' },
+        sortOrder: { type: 'string', enum: ['asc', 'desc'], description: 'Sort direction' },
+      },
+    },
+    readOnly: true,
+  })
+  async listRoutes(
+    args: { page?: number; pageSize?: number; search?: string; sortField?: string; sortOrder?: string },
+    _context: McpContext,
+  ): Promise<any> {
+    return this.routeService.list({
+      page: args.page ?? 1,
+      pageSize: args.pageSize ?? 20,
+      search: args.search ?? '',
+      sortField: args.sortField ?? 'id',
+      sortOrder: (args.sortOrder as any) ?? 'asc',
+      fields: '',
+    });
+  }
+
+  @McpTool({
+    name: 'core.routes.get',
+    description: 'Returns a single route by ID. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        routeId: { type: 'number', description: 'Route ID' },
+      },
+      required: ['routeId'],
+    },
+    readOnly: true,
+  })
+  async getRoute(args: { routeId: number }, context: McpContext): Promise<any> {
+    return this.routeService.get(args.routeId, context.locale);
+  }
+
+  @McpTool({
+    name: 'core.routes.create',
+    description: 'Creates a new HTTP or MCP route. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        url: { type: 'string', description: 'Route URL (for HTTP routes)' },
+        method: { type: 'string', description: 'HTTP method (GET, POST, PATCH, DELETE, PUT)' },
+        type: { type: 'string', enum: ['HTTP', 'MCP'], description: 'Route type (default: HTTP)' },
+        tool_name: { type: 'string', description: 'MCP tool name (for MCP routes)' },
+        name: { type: 'string', description: 'Display name' },
+      },
+    },
+  })
+  async createRoute(
+    args: { url?: string; method?: string; type?: string; tool_name?: string; name?: string },
+    context: McpContext,
+  ): Promise<any> {
+    return this.routeService.create(args as any, context.locale);
+  }
+
+  @McpTool({
+    name: 'core.routes.update',
+    description: 'Updates an existing route by ID. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        routeId: { type: 'number', description: 'Route ID' },
+        url: { type: 'string', description: 'New URL' },
+        method: { type: 'string', description: 'New HTTP method' },
+        tool_name: { type: 'string', description: 'New MCP tool name' },
+        name: { type: 'string', description: 'New display name' },
+      },
+      required: ['routeId'],
+    },
+  })
+  async updateRoute(
+    args: { routeId: number; url?: string; method?: string; tool_name?: string; name?: string },
+    context: McpContext,
+  ): Promise<any> {
+    const { routeId, ...data } = args;
+    return this.routeService.update({ id: routeId, data: data as any }, context.locale);
+  }
+
+  @McpTool({
+    name: 'core.routes.delete',
+    description: 'Deletes one or more routes by their IDs. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        ids: { type: 'array', items: { type: 'number' }, description: 'Route IDs to delete' },
+      },
+      required: ['ids'],
+    },
+  })
+  async deleteRoutes(args: { ids: number[] }, context: McpContext): Promise<any> {
+    return this.routeService.delete({ ids: args.ids }, context.locale);
+  }
+
+  @McpTool({
+    name: 'core.routes.roles.list',
+    description: 'Lists roles assigned to a route. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        routeId: { type: 'number', description: 'Route ID' },
+        page: { type: 'number', description: 'Page number (default: 1)' },
+        pageSize: { type: 'number', description: 'Items per page (default: 20)' },
+      },
+      required: ['routeId'],
+    },
+    readOnly: true,
+  })
+  async listRouteRoles(args: { routeId: number; page?: number; pageSize?: number }, context: McpContext): Promise<any> {
+    return this.routeService.listRoles(context.locale, args.routeId, {
+      page: args.page ?? 1,
+      pageSize: args.pageSize ?? 20,
+      search: '',
+      sortField: 'id',
+      sortOrder: PageOrderDirection.Asc,
+      fields: '',
+    });
+  }
+
+  @McpTool({
+    name: 'core.routes.roles.update',
+    description: 'Replaces all roles assigned to a route. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        routeId: { type: 'number', description: 'Route ID' },
+        ids: { type: 'array', items: { type: 'number' }, description: 'Role IDs to assign' },
+      },
+      required: ['routeId', 'ids'],
+    },
+  })
+  async updateRouteRoles(args: { routeId: number; ids: number[] }, _context: McpContext): Promise<any> {
+    return this.routeService.updateRoles(args.routeId, { ids: args.ids });
+  }
+
+  @McpTool({
+    name: 'core.routes.screens.list',
+    description: 'Lists screens assigned to a route. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        routeId: { type: 'number', description: 'Route ID' },
+        page: { type: 'number', description: 'Page number (default: 1)' },
+        pageSize: { type: 'number', description: 'Items per page (default: 20)' },
+      },
+      required: ['routeId'],
+    },
+    readOnly: true,
+  })
+  async listRouteScreens(args: { routeId: number; page?: number; pageSize?: number }, context: McpContext): Promise<any> {
+    return this.routeService.listScreens(context.locale, args.routeId, {
+      page: args.page ?? 1,
+      pageSize: args.pageSize ?? 20,
+      search: '',
+      sortField: 'id',
+      sortOrder: PageOrderDirection.Asc,
+      fields: '',
+    });
+  }
+
+  @McpTool({
+    name: 'core.routes.screens.update',
+    description: 'Replaces all screens assigned to a route. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        routeId: { type: 'number', description: 'Route ID' },
+        ids: { type: 'array', items: { type: 'number' }, description: 'Screen IDs to assign' },
+      },
+      required: ['routeId', 'ids'],
+    },
+  })
+  async updateRouteScreens(args: { routeId: number; ids: number[] }, _context: McpContext): Promise<any> {
+    return this.routeService.updateScreens(args.routeId, { ids: args.ids });
+  }
+}

package/src/mcp/tools/core-screens.mcp-tools.ts

@@ -0,0 +1,186 @@
+import { Injectable } from '@nestjs/common';
+import { PageOrderDirection } from '@hed-hog/api-pagination';
+import { ScreenService } from '../../screen/screen.service';
+import { McpTool } from '../decorators/mcp-tool.decorator';
+import { McpContext } from '../types/mcp-context.type';
+
+@Injectable()
+export class CoreScreensMcpTools {
+  constructor(private readonly screenService: ScreenService) {}
+
+  @McpTool({
+    name: 'core.screens.list',
+    description: 'Lists all screens with optional pagination and search. Admin only.',
+    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' },
+        sortField: { type: 'string', description: 'Field to sort by' },
+        sortOrder: { type: 'string', enum: ['asc', 'desc'], description: 'Sort direction' },
+      },
+    },
+    readOnly: true,
+  })
+  async listScreens(
+    args: { page?: number; pageSize?: number; search?: string; sortField?: string; sortOrder?: string },
+    context: McpContext,
+  ): Promise<any> {
+    return this.screenService.list(context.locale, {
+      page: args.page ?? 1,
+      pageSize: args.pageSize ?? 20,
+      search: args.search ?? '',
+      sortField: args.sortField ?? 'id',
+      sortOrder: (args.sortOrder as any) ?? 'asc',
+      fields: '',
+    });
+  }
+
+  @McpTool({
+    name: 'core.screens.get',
+    description: 'Returns a single screen by ID. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        screenId: { type: 'number', description: 'Screen ID' },
+      },
+      required: ['screenId'],
+    },
+    readOnly: true,
+  })
+  async getScreen(args: { screenId: number }, _context: McpContext): Promise<any> {
+    return this.screenService.get(args.screenId);
+  }
+
+  @McpTool({
+    name: 'core.screens.create',
+    description: 'Creates a new screen. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        slug: { type: 'string', description: 'Screen slug (unique identifier)' },
+        locale: { type: 'object', description: 'Locale translations, e.g. {"en": {"name": "Dashboard"}}' },
+      },
+      required: ['slug'],
+    },
+  })
+  async createScreen(args: { slug: string; locale?: Record<string, any> }, _context: McpContext): Promise<any> {
+    return this.screenService.create(args as any);
+  }
+
+  @McpTool({
+    name: 'core.screens.update',
+    description: 'Updates an existing screen by ID. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        screenId: { type: 'number', description: 'Screen ID' },
+        slug: { type: 'string', description: 'New slug' },
+        locale: { type: 'object', description: 'Updated locale translations' },
+      },
+      required: ['screenId'],
+    },
+  })
+  async updateScreen(args: { screenId: number; slug?: string; locale?: Record<string, any> }, _context: McpContext): Promise<any> {
+    const { screenId, ...data } = args;
+    return this.screenService.update({ id: screenId, data: data as any });
+  }
+
+  @McpTool({
+    name: 'core.screens.delete',
+    description: 'Deletes one or more screens by their IDs. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        ids: { type: 'array', items: { type: 'number' }, description: 'Screen IDs to delete' },
+      },
+      required: ['ids'],
+    },
+  })
+  async deleteScreens(args: { ids: number[] }, _context: McpContext): Promise<any> {
+    return this.screenService.delete({ ids: args.ids });
+  }
+
+  @McpTool({
+    name: 'core.screens.roles.list',
+    description: 'Lists roles assigned to a screen. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        screenId: { type: 'number', description: 'Screen ID' },
+        page: { type: 'number', description: 'Page number (default: 1)' },
+        pageSize: { type: 'number', description: 'Items per page (default: 20)' },
+      },
+      required: ['screenId'],
+    },
+    readOnly: true,
+  })
+  async listScreenRoles(args: { screenId: number; page?: number; pageSize?: number }, context: McpContext): Promise<any> {
+    return this.screenService.listRoles(context.locale, args.screenId, {
+      page: args.page ?? 1,
+      pageSize: args.pageSize ?? 20,
+      search: '',
+      sortField: 'id',
+      sortOrder: PageOrderDirection.Asc,
+      fields: '',
+    });
+  }
+
+  @McpTool({
+    name: 'core.screens.roles.update',
+    description: 'Replaces all roles assigned to a screen. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        screenId: { type: 'number', description: 'Screen ID' },
+        ids: { type: 'array', items: { type: 'number' }, description: 'Role IDs to assign' },
+      },
+      required: ['screenId', 'ids'],
+    },
+  })
+  async updateScreenRoles(args: { screenId: number; ids: number[] }, _context: McpContext): Promise<any> {
+    return this.screenService.updateRoles(args.screenId, { ids: args.ids });
+  }
+
+  @McpTool({
+    name: 'core.screens.routes.list',
+    description: 'Lists routes assigned to a screen. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        screenId: { type: 'number', description: 'Screen ID' },
+        page: { type: 'number', description: 'Page number (default: 1)' },
+        pageSize: { type: 'number', description: 'Items per page (default: 20)' },
+      },
+      required: ['screenId'],
+    },
+    readOnly: true,
+  })
+  async listScreenRoutes(args: { screenId: number; page?: number; pageSize?: number }, _context: McpContext): Promise<any> {
+    return this.screenService.listRoutes(args.screenId, {
+      page: args.page ?? 1,
+      pageSize: args.pageSize ?? 20,
+      search: '',
+      sortField: 'id',
+      sortOrder: PageOrderDirection.Asc,
+      fields: '',
+    });
+  }
+
+  @McpTool({
+    name: 'core.screens.routes.update',
+    description: 'Replaces all routes assigned to a screen. Admin only.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        screenId: { type: 'number', description: 'Screen ID' },
+        ids: { type: 'array', items: { type: 'number' }, description: 'Route IDs to assign' },
+      },
+      required: ['screenId', 'ids'],
+    },
+  })
+  async updateScreenRoutes(args: { screenId: number; ids: number[] }, _context: McpContext): Promise<any> {
+    return this.screenService.updateRoutes(args.screenId, { ids: args.ids });
+  }
+}

package/src/mcp/tools/core-sessions.mcp-tools.ts

@@ -0,0 +1,97 @@
+import { Injectable } from '@nestjs/common';
+import { PageOrderDirection } from '@hed-hog/api-pagination';
+import { SessionService } from '../../session/session.service';
+import { McpTool } from '../decorators/mcp-tool.decorator';
+import { McpContext } from '../types/mcp-context.type';
+
+@Injectable()
+export class CoreSessionsMcpTools {
+  constructor(private readonly sessionService: SessionService) {}
+
+  @McpTool({
+    name: 'core.sessions.active',
+    description: 'Returns active sessions for the authenticated user.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        page: { type: 'number', description: 'Page number (default: 1)' },
+        pageSize: { type: 'number', description: 'Items per page (default: 20)' },
+      },
+    },
+    readOnly: true,
+  })
+  async getActiveSessions(args: { page?: number; pageSize?: number }, context: McpContext): Promise<any> {
+    return this.sessionService.getUserSessionsActive(
+      {
+        page: args.page ?? 1,
+        pageSize: args.pageSize ?? 20,
+        search: '',
+        sortField: 'id',
+        sortOrder: PageOrderDirection.Asc,
+        fields: '',
+      },
+      context.userId,
+      context.locale,
+    );
+  }
+
+  @McpTool({
+    name: 'core.sessions.all',
+    description: 'Returns all sessions (active and revoked) for the authenticated user.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        page: { type: 'number', description: 'Page number (default: 1)' },
+        pageSize: { type: 'number', description: 'Items per page (default: 20)' },
+      },
+    },
+    readOnly: true,
+  })
+  async getAllSessions(args: { page?: number; pageSize?: number }, context: McpContext): Promise<any> {
+    return this.sessionService.getUserSessions(
+      {
+        page: args.page ?? 1,
+        pageSize: args.pageSize ?? 20,
+        search: '',
+        sortField: 'id',
+        sortOrder: PageOrderDirection.Asc,
+        fields: '',
+      },
+      context.userId,
+      context.locale,
+    );
+  }
+
+  @McpTool({
+    name: 'core.sessions.revoke',
+    description: 'Revokes a specific session for the authenticated user.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        sessionId: { type: 'number', description: 'Session ID to revoke' },
+      },
+      required: ['sessionId'],
+    },
+  })
+  async revokeSession(args: { sessionId: number }, context: McpContext): Promise<any> {
+    return this.sessionService.revokeUserSession(context.userId, args.sessionId, context.locale);
+  }
+
+  @McpTool({
+    name: 'core.sessions.revoke-all',
+    description: 'Revokes all sessions for the authenticated user.',
+    inputSchema: { type: 'object', properties: {} },
+  })
+  async revokeAllSessions(_args: Record<string, any>, context: McpContext): Promise<any> {
+    return this.sessionService.revokeAllSessions(context.userId);
+  }
+
+  @McpTool({
+    name: 'core.sessions.revoke-all-other',
+    description: 'Revokes all sessions except the current one for the authenticated user.',
+    inputSchema: { type: 'object', properties: {} },
+  })
+  async revokeAllOtherSessions(_args: Record<string, any>, context: McpContext): Promise<any> {
+    return this.sessionService.revokeAllOtherSessions(context.userId, Number(context.sessionId));
+  }
+}