@solidxai/core 0.1.10-beta.2 → 0.1.10-beta.22

package/src/commands/refresh-module.command.ts

@@ -4,7 +4,6 @@ import { ModuleMetadataService } from '../services/module-metadata.service';
 import { CommandError } from './helper';
 
 interface CommandOptions {
-  id: number;
   name: string;
   dryRun: boolean;
 }
@@ -28,7 +27,6 @@ export class RefreshModuleCommand extends CommandRunner {
       return;
     }
     const codeGenerationOptions = {
-      moduleId: options.id,
       moduleUserKey: options.name,
       dryRun: options.dryRun,
     };
@@ -36,16 +34,7 @@ export class RefreshModuleCommand extends CommandRunner {
   }
 
   @Option({
-    flags: '-i, --id [module ID]',
-    description: 'Module ID from the ss_module_metadata table',
-  })
-  parseId(val: string): number {
-    return +val;
-  }
-
-  // Accept the module name as an argument
-  @Option({
-    flags: '-n, --name [module name]',
+    flags: '-n, --name <module name>',
     description: 'Module Name from the ss_module_metadata table',
   })
   parseName(val: string): string {
@@ -61,11 +50,9 @@ export class RefreshModuleCommand extends CommandRunner {
     return (val === 'false') ? false : true;
   }
 
-
-  // Validate the options passed
   validate(options: CommandOptions): CommandError[] {
-    if (!options.id && !options.name) {
-      return [new CommandError('Module ID or Module Name is required')];
+    if (!options.name) {
+      return [new CommandError('Module Name is required')];
     }
     return [];
   }

package/src/commands/test-data.command.ts

@@ -7,6 +7,7 @@ interface TestDataCommandOptions {
   modulesToTest?: string;
   setup?: boolean;
   teardown?: boolean;
+  unlink?: boolean;
 }
 
 @SubCommand({
@@ -25,17 +26,18 @@ export class TestDataCommand extends CommandRunner {
       const load = Boolean(options?.load);
       const setup = Boolean(options?.setup);
       const teardown = Boolean(options?.teardown);
+      const unlink = Boolean(options?.unlink);
 
-      const selectedModes = [load, setup, teardown].filter(Boolean).length;
+      const selectedModes = [load, setup, teardown, unlink].filter(Boolean).length;
       if (selectedModes > 1) {
-        this.logger.error('Please specify only one of --load, --setup, or --teardown.');
-        console.log('Please specify only one of --load, --setup, or --teardown.');
+        this.logger.error('Please specify only one of --load, --setup, --teardown, or --unlink.');
+        console.log('Please specify only one of --load, --setup, --teardown, or --unlink.');
         return;
       }
 
-      if (!load && !setup && !teardown) {
-        this.logger.error('Please specify one of --load, --setup, or --teardown.');
-        console.log('Please specify one of --load, --setup, or --teardown.');
+      if (!load && !setup && !teardown && !unlink) {
+        this.logger.error('Please specify one of --load, --setup, --teardown, or --unlink.');
+        console.log('Please specify one of --load, --setup, --teardown, or --unlink.');
         return;
       }
 
@@ -65,6 +67,19 @@ export class TestDataCommand extends CommandRunner {
         await this.testDataService.setupTestData(modulesToTest ?? undefined);
         return;
       }
+
+      if (unlink) {
+        const modulesToTest = options?.modulesToTest ? options.modulesToTest.split(',').map((m) => m.trim()).filter(Boolean) : null;
+        if (modulesToTest?.length) {
+          this.logger.log(`Test data unlink for modules: ${modulesToTest.join(', ')}`);
+          console.log(`Test data unlink for modules: ${modulesToTest.join(', ')}`);
+        } else {
+          this.logger.log('Test data unlink for all modules.');
+          console.log('Test data unlink for all modules.');
+        }
+        await this.testDataService.removeTestData(modulesToTest ?? undefined);
+        return;
+      }
     } catch (err: any) {
       const message = err?.message ?? String(err);
       this.logger.error(message);
@@ -109,4 +124,12 @@ export class TestDataCommand extends CommandRunner {
     return val;
   }
 
+  @Option({
+    flags: '--unlink',
+    description: 'Delete test data from testing.data sections in reverse order',
+  })
+  parseUnlink(): boolean {
+    return true;
+  }
+
 }

package/src/controllers/action-metadata.controller.ts

@@ -7,7 +7,7 @@ import { UpdateActionMetadataDto } from '../dtos/update-action-metadata.dto';
 import { SolidRequestContextDto } from 'src/dtos/solid-request-context.dto';
 import { SolidRequestContextDecorator } from 'src/decorators/solid-request-context.decorator';
 
-@ApiTags('App Builder')
+@ApiTags('Solid Core')
 @Controller('action-metadata') //FIXME: Change this to the model plural name 
 export class ActionMetadataController {
   constructor(private readonly service: ActionMetadataService) { }

package/src/controllers/chatter-message.controller.ts

@@ -5,6 +5,7 @@ import { ChatterMessageService } from '../services/chatter-message.service';
 import { CreateChatterMessageDto } from '../dtos/create-chatter-message.dto';
 import { UpdateChatterMessageDto } from '../dtos/update-chatter-message.dto';
 import { PostChatterMessageDto } from '../dtos/post-chatter-message.dto';
+import { UpdateChatterNoteMessageDto } from '../dtos/update-chatter-note-message.dto';
 import { SolidRequestContextDecorator } from 'src/decorators/solid-request-context.decorator';
 import { SolidRequestContextDto } from 'src/dtos/solid-request-context.dto';
 import { Public } from 'src/decorators/public.decorator';
@@ -127,4 +128,15 @@ export class ChatterMessageController {
   async markCompleted(@Param('id') id: string) {
     return this.service.markCompleted(+id);
   }
+
+  @ApiBearerAuth("jwt")
+  @Patch(':id/note')
+  @UseInterceptors(AnyFilesInterceptor())
+  async updateCustomNoteMessage(
+    @Param('id') id: string,
+    @Body() updateDto: UpdateChatterNoteMessageDto,
+    @UploadedFiles() files: Array<Express.Multer.File>,
+  ) {
+    return this.service.updateCustomNoteMessage(+id, updateDto, files);
+  }
 }

package/src/controllers/facebook-authentication.controller.ts

@@ -24,7 +24,7 @@ import { UserService } from "../services/user.service";
 import type { SolidCoreSetting } from "../services/settings/default-settings-provider.service";
 
 @Auth(AuthType.None)
-@ApiTags("Iam")
+@ApiTags("Solid Core")
 @Controller("iam/facebook")
 export class FacebookAuthenticationController {
   constructor(

package/src/controllers/google-authentication.controller.ts

@@ -16,7 +16,7 @@ import type { SolidCoreSetting } from "src/services/settings/default-settings-pr
 
 @Auth(AuthType.None)
 @Controller('iam/google')
-@ApiTags("Iam")
+@ApiTags("Solid Core")
 // @UseGuards(ThrottlerGuard)
 // @SkipThrottle({ login: false, short: false, burst: true, sustained: true }) //Enable the login throttle only 
 export class GoogleAuthenticationController {

package/src/controllers/gupshup-webhook.controller.ts

@@ -0,0 +1,91 @@
+import {
+  Body,
+  Controller,
+  HttpCode,
+  HttpStatus,
+  Logger,
+  Post,
+  Req,
+} from "@nestjs/common";
+import { ApiTags } from "@nestjs/swagger";
+import { Request } from "express";
+import { Auth } from "src/decorators/auth.decorator";
+import { Public } from "src/decorators/public.decorator";
+import { AuthType } from "src/enums/auth-type.enum";
+
+@Auth(AuthType.None)
+@Controller("webhook/whatsapp/gupshup")
+@ApiTags("Solid Core")
+export class GupshupWebhookController {
+  private readonly logger = new Logger(GupshupWebhookController.name);
+
+  @Public()
+  @Post()
+  @HttpCode(HttpStatus.OK)
+  async receiveWebhook(@Req() req: Request, @Body() body: unknown) {
+    const userAgent = req.headers["user-agent"] ?? null;
+    this.logger.log(
+      `Received Gupshup WhatsApp webhook${userAgent ? ` from ${userAgent}` : ""}`,
+    );
+    this.logger.debug(`Gupshup webhook payload: ${JSON.stringify(body)}`);
+
+    const statusInfo = this.extractStatusInfo(body);
+    if (statusInfo) {
+      this.logger.log(
+        `Gupshup delivery update: status=${statusInfo.status ?? "unknown"}, messageId=${statusInfo.messageId ?? "n/a"}, destination=${statusInfo.destination ?? "n/a"}, reason=${statusInfo.reason ?? "n/a"}`,
+      );
+    }
+
+    return {
+      success: true,
+      message: "Webhook received",
+    };
+  }
+
+  private extractStatusInfo(body: unknown): {
+    status?: string;
+    messageId?: string;
+    destination?: string;
+    reason?: string;
+  } | null {
+    if (!body || typeof body !== "object") {
+      return null;
+    }
+
+    const payload = body as Record<string, unknown>;
+
+    const status =
+      this.asString(payload.status) ||
+      this.asString(payload.messageStatus) ||
+      this.asString((payload.payload as Record<string, unknown>)?.status) ||
+      this.asString((payload.payload as Record<string, unknown>)?.type);
+
+    const messageId =
+      this.asString(payload.messageId) ||
+      this.asString(payload.id) ||
+      this.asString((payload.payload as Record<string, unknown>)?.id) ||
+      this.asString((payload.payload as Record<string, unknown>)?.messageId);
+
+    const destination =
+      this.asString(payload.destination) ||
+      this.asString(payload.phone) ||
+      this.asString((payload.payload as Record<string, unknown>)?.destination) ||
+      this.asString((payload.payload as Record<string, unknown>)?.phone);
+
+    const reason =
+      this.asString(payload.reason) ||
+      this.asString(payload.error) ||
+      this.asString((payload.payload as Record<string, unknown>)?.reason) ||
+      this.asString((payload.payload as Record<string, unknown>)?.error);
+
+    if (!status && !messageId && !destination && !reason) {
+      return null;
+    }
+
+    return { status, messageId, destination, reason };
+  }
+
+  private asString(value: unknown): string | undefined {
+    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+  }
+}

package/src/controllers/mcp-audit-log.controller.ts

@@ -0,0 +1,70 @@
+import { Body, Controller, Delete, Get, Param, Patch, Post, Put, Query, UploadedFiles, UseInterceptors } from '@nestjs/common';
+import { AnyFilesInterceptor } from '@nestjs/platform-express';
+import { ApiBearerAuth, ApiQuery, ApiTags } from '@nestjs/swagger';
+import { CreateMcpAuditLogDto } from 'src/dtos/create-mcp-audit-log.dto';
+import { UpdateMcpAuditLogDto } from 'src/dtos/update-mcp-audit-log.dto';
+import { McpAuditLogService } from 'src/services/mcp-audit-log.service';
+
+@ApiTags('Solid Core')
+@Controller('mcp-audit-log')
+export class McpAuditLogController {
+  constructor(private readonly service: McpAuditLogService) {}
+
+  @ApiBearerAuth('jwt')
+  @Post()
+  @UseInterceptors(AnyFilesInterceptor())
+  create(@Body() createDto: CreateMcpAuditLogDto, @UploadedFiles() files: Array<Express.Multer.File>) {
+    return this.service.create(createDto, files);
+  }
+
+  @ApiBearerAuth('jwt')
+  @Post('/bulk')
+  @UseInterceptors(AnyFilesInterceptor())
+  insertMany(@Body() createDtos: CreateMcpAuditLogDto[], @UploadedFiles() filesArray: Express.Multer.File[][] = []) {
+    return this.service.insertMany(createDtos, filesArray);
+  }
+
+  @ApiBearerAuth('jwt')
+  @Put(':id')
+  @UseInterceptors(AnyFilesInterceptor())
+  update(@Param('id') id: number, @Body() updateDto: UpdateMcpAuditLogDto, @UploadedFiles() files: Array<Express.Multer.File>) {
+    return this.service.update(id, updateDto, files);
+  }
+
+  @ApiBearerAuth('jwt')
+  @Patch(':id')
+  @UseInterceptors(AnyFilesInterceptor())
+  partialUpdate(@Param('id') id: number, @Body() updateDto: UpdateMcpAuditLogDto, @UploadedFiles() files: Array<Express.Multer.File>) {
+    return this.service.update(id, updateDto, files, true);
+  }
+
+  @ApiBearerAuth('jwt')
+  @ApiQuery({ name: 'limit', required: false, type: Number })
+  @ApiQuery({ name: 'offset', required: false, type: Number })
+  @ApiQuery({ name: 'fields', required: false, type: Array })
+  @ApiQuery({ name: 'sort', required: false, type: Array })
+  @ApiQuery({ name: 'populate', required: false, type: Array })
+  @ApiQuery({ name: 'filters', required: false, type: Array })
+  @Get()
+  findMany(@Query() query: any) {
+    return this.service.find(query);
+  }
+
+  @ApiBearerAuth('jwt')
+  @Get(':id')
+  findOne(@Param('id') id: string, @Query() query: any) {
+    return this.service.findOne(+id, query);
+  }
+
+  @ApiBearerAuth('jwt')
+  @Delete('/bulk')
+  deleteMany(@Body() ids: number[]) {
+    return this.service.deleteMany(ids);
+  }
+
+  @ApiBearerAuth('jwt')
+  @Delete(':id')
+  delete(@Param('id') id: number) {
+    return this.service.delete(id);
+  }
+}

package/src/controllers/menu-item-metadata.controller.ts

@@ -9,7 +9,7 @@ import { ActiveUserData } from 'src/interfaces/active-user-data.interface';
 import { SolidRequestContextDto } from 'src/dtos/solid-request-context.dto';
 import { SolidRequestContextDecorator } from 'src/decorators/solid-request-context.decorator';
 
-@ApiTags('App Builder')
+@ApiTags('Solid Core')
 @Controller('menu-item-metadata') //FIXME: Change this to the model plural name 
 export class MenuItemMetadataController {
   constructor(private readonly service: MenuItemMetadataService) { }

package/src/controllers/meta-cloud-whatsapp-webhook.controller.ts

@@ -0,0 +1,155 @@
+import {
+  Body,
+  Controller,
+  Get,
+  HttpCode,
+  HttpStatus,
+  Logger,
+  Post,
+  Query,
+  Res,
+} from "@nestjs/common";
+import { ApiTags } from "@nestjs/swagger";
+import { Response } from "express";
+import { Auth } from "src/decorators/auth.decorator";
+import { Public } from "src/decorators/public.decorator";
+import { AuthType } from "src/enums/auth-type.enum";
+import { SettingService } from "src/services/setting.service";
+import type { SolidCoreSetting } from "src/services/settings/default-settings-provider.service";
+
+@Auth(AuthType.None)
+@Controller("webhook/whatsapp/meta-cloud")
+@ApiTags("Solid Core")
+export class MetaCloudWhatsappWebhookController {
+  private readonly logger = new Logger(MetaCloudWhatsappWebhookController.name);
+
+  constructor(private readonly settingService: SettingService) {}
+
+  @Public()
+  @Get()
+  verifyWebhook(@Query() query: Record<string, unknown>, @Res() res: Response) {
+    const mode = this.resolveQueryValue(query, "hub.mode", "hub_mode", "mode");
+    const verifyToken = this.resolveQueryValue(
+      query,
+      "hub.verify_token",
+      "hub_verify_token",
+      "verify_token",
+    );
+    const challenge = this.resolveQueryValue(
+      query,
+      "hub.challenge",
+      "hub_challenge",
+      "challenge",
+    );
+
+    const configuredVerifyToken =
+      this.settingService.getConfigValue<SolidCoreSetting>(
+        "metaWhatsappWebhookVerifyToken",
+      ) || process.env.COMMON_META_WHATSAPP_WEBHOOK_VERIFY_TOKEN;
+
+    const isVerificationCall = mode === "subscribe";
+    const tokenMatches =
+      !!configuredVerifyToken && verifyToken === configuredVerifyToken;
+
+    if (isVerificationCall && tokenMatches && challenge) {
+      this.logger.log("Meta Cloud WhatsApp webhook verified successfully.");
+      res.writeHead(HttpStatus.OK, {
+        "Content-Type": "text/plain",
+        "Content-Length": Buffer.byteLength(String(challenge)),
+      });
+      res.write(String(challenge));
+      return res.end();
+    }
+
+    this.logger.warn(
+      `Meta Cloud webhook verification failed. mode=${mode ?? "n/a"}, tokenMatch=${tokenMatches}`,
+    );
+
+    res.writeHead(HttpStatus.FORBIDDEN, { "Content-Type": "text/plain" });
+    return res.end("Webhook verification failed");
+  }
+
+  @Public()
+  @Post()
+  @HttpCode(HttpStatus.OK)
+  async receiveWebhook(@Body() body: unknown) {
+    this.logger.log("Received Meta Cloud WhatsApp webhook");
+    this.logger.debug(`Meta Cloud webhook payload: ${JSON.stringify(body)}`);
+
+    const statusInfo = this.extractStatusInfo(body);
+    if (statusInfo) {
+      this.logger.log(
+        `Meta Cloud delivery update: status=${statusInfo.status ?? "unknown"}, messageId=${statusInfo.messageId ?? "n/a"}, destination=${statusInfo.destination ?? "n/a"}, reason=${statusInfo.reason ?? "n/a"}`,
+      );
+    }
+
+    return {
+      success: true,
+      message: "Webhook received",
+    };
+  }
+
+  private extractStatusInfo(body: unknown): {
+    status?: string;
+    messageId?: string;
+    destination?: string;
+    reason?: string;
+  } | null {
+    if (!body || typeof body !== "object") {
+      return null;
+    }
+
+    const payload = body as Record<string, unknown>;
+    const entries = payload.entry as Array<Record<string, unknown>> | undefined;
+    const changes = entries?.[0]?.changes as Array<Record<string, unknown>> | undefined;
+    const value = changes?.[0]?.value as Record<string, unknown> | undefined;
+    const statuses = value?.statuses as Array<Record<string, unknown>> | undefined;
+    const status = statuses?.[0];
+
+    if (!status) {
+      return null;
+    }
+
+    const errors = status.errors as Array<Record<string, unknown>> | undefined;
+
+    return {
+      status: this.asString(status.status),
+      messageId: this.asString(status.id),
+      destination: this.asString(status.recipient_id),
+      reason:
+        this.asString(errors?.[0]?.title) || this.asString(errors?.[0]?.message),
+    };
+  }
+
+  private asString(value: unknown): string | undefined {
+    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+  }
+
+  private resolveQueryValue(
+    query: Record<string, unknown>,
+    ...keys: string[]
+  ): string | undefined {
+    for (const key of keys) {
+      const directValue = this.asString(query[key]);
+      if (directValue) {
+        return directValue;
+      }
+    }
+
+    const hubRaw = query.hub;
+    if (hubRaw && typeof hubRaw === "object" && !Array.isArray(hubRaw)) {
+      const hub = hubRaw as Record<string, unknown>;
+      for (const key of ["mode", "verify_token", "challenge"]) {
+        const value = this.asString(hub[key]);
+        if (
+          value &&
+          keys.some((candidate) => candidate.endsWith(key) || candidate === key)
+        ) {
+          return value;
+        }
+      }
+    }
+
+    return undefined;
+  }
+}

package/src/controllers/microsoft-authentication.controller.ts

@@ -24,7 +24,7 @@ import { UserService } from "../services/user.service";
 import type { SolidCoreSetting } from "../services/settings/default-settings-provider.service";
 
 @Auth(AuthType.None)
-@ApiTags("Iam")
+@ApiTags("Solid Core")
 @Controller("iam/microsoft")
 export class MicrosoftAuthenticationController {
   constructor(

package/src/controllers/model-metadata.controller.ts

@@ -92,7 +92,7 @@ export class ModelMetadataController {
     @ApiBearerAuth("jwt")
     @Post(':id/generate-code')
     generateCode(@Param('id', ParseIntPipe) id: number) {
-        return this.modelMetadataService.handleGenerateCode({ modelId: id });
+        return this.modelMetadataService.generateCodeViaCtl(id);
     }
 
     @ApiBearerAuth("jwt")

package/src/controllers/module-metadata.controller.ts

@@ -62,7 +62,7 @@ export class ModuleMetadataController {
   @ApiBearerAuth("jwt")
   @Post(':id/generate-code')
   generateCode(@Param('id', ParseIntPipe) id: number) {
-    return this.moduleMetadataService.generateCode({ moduleId: id });
+    return this.moduleMetadataService.generateCodeViaCtl(id);
   }
  
 

package/src/controllers/mq-message-queue.controller.ts

@@ -7,7 +7,7 @@ import { MqMessageQueueService } from '../services/mq-message-queue.service';
 import { SolidRequestContextDto } from 'src/dtos/solid-request-context.dto';
 import { SolidRequestContextDecorator } from 'src/decorators/solid-request-context.decorator';
 
-@ApiTags('Queues')
+@ApiTags('Solid Core')
 @Controller('mq-message-queue') //FIXME: Change this to the model plural name 
 export class MqMessageQueueController {
   constructor(protected readonly service: MqMessageQueueService) { }

package/src/controllers/mq-message.controller.ts

@@ -7,7 +7,7 @@ import { AnyFilesInterceptor } from '@nestjs/platform-express';
 import { SolidRequestContextDecorator } from 'src/decorators/solid-request-context.decorator';
 import { SolidRequestContextDto } from 'src/dtos/solid-request-context.dto';
 
-@ApiTags('Queues')
+@ApiTags('Solid Core')
 @Controller('mq-message') //FIXME: Change this to the model plural name 
 export class MqMessageController {
   constructor(protected readonly service: MqMessageService) { }

package/src/controllers/view-metadata.controller.ts

@@ -9,7 +9,7 @@ import { SolidRequestContextDto } from 'src/dtos/solid-request-context.dto';
 import { ActiveUser } from 'src/decorators/active-user.decorator';
 import { ActiveUserData } from 'src/interfaces/active-user-data.interface';
 
-@ApiTags('App Builder')
+@ApiTags('Solid Core')
 @Controller('view-metadata') //FIXME: Change this to the model plural name 
 export class ViewMetadataController {
   constructor(private readonly service: ViewMetadataService) { }

package/src/dtos/create-mcp-audit-log.dto.ts

@@ -0,0 +1,84 @@
+import { ApiProperty } from '@nestjs/swagger';
+import { IsDate, IsInt, IsNotEmpty, IsNumber, IsOptional, IsString } from 'class-validator';
+
+export class CreateMcpAuditLogDto {
+  @IsOptional()
+  @IsInt()
+  @ApiProperty()
+  userId: number;
+
+  @IsOptional()
+  @IsInt()
+  @ApiProperty()
+  apiKeyId: number;
+
+  @IsOptional()
+  @IsString()
+  @ApiProperty()
+  username: string;
+
+  @IsNotEmpty()
+  @IsString()
+  @ApiProperty()
+  transport: string;
+
+  @IsOptional()
+  @IsString()
+  @ApiProperty()
+  mcpSessionId: string;
+
+  @IsOptional()
+  @IsString()
+  @ApiProperty()
+  clientAddr: string;
+
+  @IsNotEmpty()
+  @IsString()
+  @ApiProperty()
+  method: string;
+
+  @IsOptional()
+  @IsString()
+  @ApiProperty()
+  requestId: string;
+
+  @IsOptional()
+  @IsString()
+  @ApiProperty()
+  toolName: string;
+
+  @IsOptional()
+  @IsString()
+  @ApiProperty()
+  requestParams: string;
+
+  @IsNotEmpty()
+  @IsString()
+  @ApiProperty()
+  status: string;
+
+  @IsOptional()
+  @IsString()
+  @ApiProperty()
+  responseResult: string;
+
+  @IsOptional()
+  @IsInt()
+  @ApiProperty()
+  errorCode: number;
+
+  @IsOptional()
+  @IsString()
+  @ApiProperty()
+  errorMessage: string;
+
+  @IsOptional()
+  @IsNumber()
+  @ApiProperty()
+  durationMs: number;
+
+  @IsOptional()
+  @IsDate()
+  @ApiProperty()
+  createdAt: Date;
+}

package/src/dtos/update-chatter-note-message.dto.ts

@@ -0,0 +1,14 @@
+import { ApiProperty } from '@nestjs/swagger';
+import { IsNotEmpty, IsOptional, IsString } from 'class-validator';
+
+export class UpdateChatterNoteMessageDto {
+    @IsString()
+    @IsOptional()
+    @ApiProperty()
+    messageBody: string;
+
+    @IsString()
+    @IsOptional()
+    @ApiProperty({ required: false, description: 'Comma-separated media IDs to remove from this note.' })
+    removeAttachmentIds?: string;
+}