@hexabot-ai/api 3.2.2-alpha.0 → 3.2.2-alpha.2

package/src/bootstrap.ts

@@ -4,7 +4,7 @@
  * Full terms: see LICENSE.md.
  */
 
-import { Type, ValidationPipe } from '@nestjs/common';
+import { ConsoleLogger, Logger, Type, ValidationPipe } from '@nestjs/common';
 import { NestFactory } from '@nestjs/core';
 import type { NestExpressApplication } from '@nestjs/platform-express';
 import bodyParser from 'body-parser';
@@ -25,6 +25,12 @@ moduleAlias.addAliases({
   '@': __dirname,
 });
 
+class HexabotBootstrapLogger extends ConsoleLogger {
+  override log(message: unknown, context?: string) {
+    super.log(message, context === 'NestApplication' ? 'Hexabot' : context);
+  }
+}
+
 const rawBodyBuffer = (req, res, buf, encoding) => {
   if (buf?.length) {
     req.rawBody = buf.toString(encoding || 'utf8');
@@ -54,6 +60,7 @@ export async function createHexabotApplication<
   await resolveDynamicProviders();
   const app = await NestFactory.create<TApp>(moduleRef, {
     bodyParser: false,
+    logger: new HexabotBootstrapLogger(),
   });
 
   app.set('query parser', 'extended');
@@ -134,6 +141,8 @@ export async function bootstrapHexabotApp(
   const host = options.listen?.host ?? '0.0.0.0';
 
   await app.listen(port, host);
+  const appUrl = await app.getUrl();
+  Logger.log(`Hexabot is running at ${appUrl}`, 'Hexabot');
 
   return app;
 }

package/src/channel/lib/Handler.ts

@@ -4,6 +4,8 @@
  * Full terms: see LICENSE.md.
  */
 
+import { randomUUID } from 'crypto';
+
 import type {
   ActionOptions,
   Attachment,
@@ -16,7 +18,6 @@ import { Inject, Injectable, OnModuleInit, Type } from '@nestjs/common';
 import { ModuleRef } from '@nestjs/core';
 import { Request, Response } from 'express';
 import mime from 'mime';
-import { v4 as uuidv4 } from 'uuid';
 import z from 'zod';
 
 import { AttachmentService } from '@/attachment/services/attachment.service';
@@ -232,7 +233,7 @@ export default abstract class ChannelHandler<
     const attachments = await Promise.all(
       metadatas.map(({ file, name, type, size }) => {
         return this.attachmentService.store(file, {
-          name: `${name ? `${name}-` : ''}${uuidv4()}.${mime.extension(type)}`,
+          name: `${name ? `${name}-` : ''}${randomUUID()}.${mime.extension(type)}`,
           type,
           size,
           resourceRef: AttachmentResourceRef.MessageAttachment,

package/src/chat/chat.module.ts

@@ -45,7 +45,7 @@ import { ThreadService } from './services/thread.service';
       SubscriberOrmEntity,
       ThreadOrmEntity,
     ]),
-    CmsModule,
+    forwardRef(() => CmsModule),
     AttachmentModule,
     UserModule,
 

package/src/chat/entities/subscriber.entity.ts

@@ -4,6 +4,8 @@
  * Full terms: see LICENSE.md.
  */
 
+import { createRequire } from 'node:module';
+
 import { subscriberSchema, subscriberFullSchema } from '@hexabot-ai/types';
 import {
   Check,
@@ -30,6 +32,8 @@ import { SubscriberDto } from '../dto/subscriber.dto';
 
 import { LabelOrmEntity } from './label.entity';
 
+const requireEntity = createRequire(__filename);
+
 export class SubscriberChannel {
   @Column()
   name: string;
@@ -65,13 +69,16 @@ export class SubscriberOrmEntity<
   @Column({ type: 'varchar', length: 64 })
   foreignId: string;
 
-  @ManyToOne('SourceOrmEntity', {
-    // STI (`users` table) stores both subscribers and operators.
-    // Keep the column nullable at the DB level, and enforce non-null for
-    // Subscriber rows via `CHK_SUBSCRIBER_SOURCE_REQUIRED`.
-    nullable: true,
-    onDelete: 'CASCADE',
-  })
+  @ManyToOne(
+    () => requireEntity('../../channel/entities/source.entity').SourceOrmEntity,
+    {
+      // STI (`users` table) stores both subscribers and operators.
+      // Keep the column nullable at the DB level, and enforce non-null for
+      // Subscriber rows via `CHK_SUBSCRIBER_SOURCE_REQUIRED`.
+      nullable: true,
+      onDelete: 'CASCADE',
+    },
+  )
   @JoinColumn({ name: 'source_id' })
   @AsRelation()
   source: SourceOrmEntity;

package/src/chat/services/subscriber.service.ts

@@ -4,12 +4,13 @@
  * Full terms: see LICENSE.md.
  */
 
+import { randomUUID } from 'crypto';
+
 import { Subscriber } from '@hexabot-ai/types';
 import { Inject, Injectable, Optional, forwardRef } from '@nestjs/common';
 import { OnEvent } from '@nestjs/event-emitter';
 import mime from 'mime';
 import { In, IsNull, Not } from 'typeorm';
-import { v4 as uuidv4 } from 'uuid';
 
 import { AttachmentService } from '@/attachment/services/attachment.service';
 import {
@@ -159,7 +160,7 @@ export class SubscriberService extends BaseOrmService<SubscriberOrmEntity> {
     const { file, type, size } = avatar;
     const extension = mime.extension(type);
     const attachment = await this.attachmentService.store(file, {
-      name: `avatar-${uuidv4()}.${extension}`,
+      name: `avatar-${randomUUID()}.${extension}`,
       size,
       type,
       resourceRef: AttachmentResourceRef.SubscriberAvatar,

package/src/cms/entities/content-type.entity.ts

@@ -4,6 +4,8 @@
  * Full terms: see LICENSE.md.
  */
 
+import { createRequire } from 'node:module';
+
 import { contentTypeSchema, contentTypeFullSchema } from '@hexabot-ai/types';
 import { JSONSchema7 as JsonSchema } from 'json-schema';
 import { Column, Entity, Index, OneToMany } from 'typeorm';
@@ -14,7 +16,9 @@ import { BaseOrmEntity } from '@/database/entities/base.entity';
 
 import { ContentTypeDto } from '../dto/contentType.dto';
 
-import { ContentOrmEntity } from './content.entity';
+import type { ContentOrmEntity } from './content.entity';
+
+const requireEntity = createRequire(__filename);
 
 @Entity({ name: 'content_types' })
 @Index(['name'], { unique: true })
@@ -31,8 +35,12 @@ export class ContentTypeOrmEntity extends BaseOrmEntity<ContentTypeDto> {
   @JsonColumn({ nullable: true })
   schema!: JsonSchema;
 
-  @OneToMany(() => ContentOrmEntity, (content) => content.contentType, {
-    cascade: ['remove'],
-  })
+  @OneToMany(
+    () => requireEntity('./content.entity').ContentOrmEntity,
+    (content: ContentOrmEntity) => content.contentType,
+    {
+      cascade: ['remove'],
+    },
+  )
   contents?: ContentOrmEntity[];
 }

package/src/cms/entities/content.entity.ts

@@ -4,6 +4,8 @@
  * Full terms: see LICENSE.md.
  */
 
+import { createRequire } from 'node:module';
+
 import {
   contentSchema,
   contentFullSchema,
@@ -31,7 +33,9 @@ import { AsRelation } from '@/utils/decorators/relation-ref.decorator';
 
 import { ContentDto } from '../dto/content.dto';
 
-import { ContentTypeOrmEntity } from './content-type.entity';
+import type { ContentTypeOrmEntity } from './content-type.entity';
+
+const requireEntity = createRequire(__filename);
 
 @Entity({ name: 'contents' })
 @Index(['title'])
@@ -44,10 +48,14 @@ export class ContentOrmEntity extends BaseOrmEntity<ContentDto> {
   /**
    * The content type of this content.
    */
-  @ManyToOne(() => ContentTypeOrmEntity, (entity) => entity.contents, {
-    nullable: false,
-    onDelete: 'CASCADE',
-  })
+  @ManyToOne(
+    () => requireEntity('./content-type.entity').ContentTypeOrmEntity,
+    (entity: ContentTypeOrmEntity) => entity.contents,
+    {
+      nullable: false,
+      onDelete: 'CASCADE',
+    },
+  )
   @JoinColumn({ name: 'content_type_id' })
   @AsRelation()
   contentType!: ContentTypeOrmEntity;

package/src/extensions/actions/web/http-request.action.ts

@@ -110,6 +110,26 @@ function isJsonContentType(contentType?: string) {
   );
 }
 
+function normalizeHeaderValue(value: unknown): string | undefined {
+  if (value === undefined || value === null) {
+    return undefined;
+  }
+
+  if (Array.isArray(value)) {
+    return value.map(String).join(', ');
+  }
+
+  if (
+    typeof value === 'string' ||
+    typeof value === 'number' ||
+    typeof value === 'boolean'
+  ) {
+    return String(value);
+  }
+
+  return undefined;
+}
+
 function resolveFinalUrl(response: {
   request?: { res?: { responseUrl?: string }; responseUrl?: string };
 }) {
@@ -175,10 +195,9 @@ export const HttpRequestAction = createAction<
         validateStatus: () => true,
         ...(requestData !== undefined ? { data: requestData } : {}),
       });
-      const contentTypeHeader = response.headers?.['content-type'];
-      const contentType = Array.isArray(contentTypeHeader)
-        ? contentTypeHeader.join(', ')
-        : contentTypeHeader;
+      const contentType = normalizeHeaderValue(
+        response.headers?.['content-type'],
+      );
       const responseData = response.data;
       let body: HttpRequestOutput['body'] = '';
 

package/src/extensions/actions/web/i18n/en.translations.json

@@ -25,5 +25,14 @@
     "URL": "URL",
     "Whether the HTTP response status indicates success.": "Whether the HTTP response status indicates success.",
     "Whether the response body was truncated.": "Whether the response body was truncated."
+  },
+  "send_mail": {
+    "Sends an email using HTML content.": "Sends an email using HTML content.",
+    "To": "To",
+    "Recipient email address.": "Recipient email address.",
+    "Title": "Title",
+    "Email subject.": "Email subject.",
+    "Content (HTML)": "Content (HTML)",
+    "HTML email content.": "HTML email content."
   }
 }

package/src/extensions/actions/web/i18n/fr.translations.json

@@ -25,5 +25,14 @@
     "URL": "URL",
     "Whether the HTTP response status indicates success.": "Indique si le statut de la réponse HTTP signale un succès.",
     "Whether the response body was truncated.": "Indique si le corps de la réponse a été tronqué."
+  },
+  "send_mail": {
+    "Sends an email using HTML content.": "Envoie un e-mail en utilisant du contenu HTML.",
+    "To": "À",
+    "Recipient email address.": "Adresse e-mail du destinataire.",
+    "Title": "Titre",
+    "Email subject.": "Objet de l'e-mail.",
+    "Content (HTML)": "Contenu (HTML)",
+    "HTML email content.": "Contenu de l'e-mail en HTML."
   }
 }

package/src/extensions/actions/web/send-mail.action.ts

@@ -0,0 +1,89 @@
+/*
+ * Hexabot — Fair Core License (FCL-1.0-ALv2)
+ * Copyright (c) 2025 Hexastack.
+ * Full terms: see LICENSE.md.
+ */
+
+import { Injectable } from '@nestjs/common';
+import { z } from 'zod';
+
+import { BaseAction, ExecArgs } from '@/actions';
+import { ActionService } from '@/actions/actions.service';
+import { MailerService } from '@/mailer/mailer.service';
+import { WorkflowRuntimeContext } from '@/workflow/contexts/workflow-runtime.context';
+
+const sendMailInputSchema = z.object({
+  to: z.email().meta({
+    title: 'To',
+    description: 'Recipient email address.',
+  }),
+  title: z.string().min(1).meta({
+    title: 'Title',
+    description: 'Email subject.',
+  }),
+  content: z.string().min(1).meta({
+    title: 'Content (HTML)',
+    description: 'HTML email content.',
+  }),
+});
+const sendMailOutputSchema = z.union([
+  z.object({
+    success: z.literal(true),
+  }),
+  z.object({
+    success: z.literal(false),
+    error: z.string(),
+  }),
+]);
+type SendMailInput = z.infer<typeof sendMailInputSchema>;
+type SendMailOutput = z.infer<typeof sendMailOutputSchema>;
+
+@Injectable()
+export class SendMailAction extends BaseAction<
+  SendMailInput,
+  SendMailOutput,
+  WorkflowRuntimeContext
+> {
+  constructor(
+    actionService: ActionService,
+    private readonly mailerService: MailerService,
+  ) {
+    super(
+      {
+        name: 'send_mail',
+        description: 'Sends an email using HTML content.',
+        group: 'web',
+        icon: 'Mail',
+        color: '#68b1ff',
+        inputSchema: sendMailInputSchema,
+        outputSchema: sendMailOutputSchema,
+      },
+      actionService,
+    );
+  }
+
+  async execute({
+    input,
+    context,
+  }: ExecArgs<SendMailInput, WorkflowRuntimeContext>) {
+    try {
+      await this.mailerService.sendMail({
+        to: input.to,
+        subject: input.title,
+        html: input.content,
+      });
+
+      return { success: true } satisfies SendMailOutput;
+    } catch (error) {
+      const message =
+        error instanceof Error ? error.message : 'Could not send email';
+      context.services.logger.error('send_mail action failed', message, '', {
+        to: input.to,
+      });
+
+      return { success: false, error: message } satisfies SendMailOutput;
+    }
+  }
+}
+
+export default SendMailAction;

package/src/extensions/channels/web/base-web-channel.ts

@@ -4,6 +4,8 @@
  * Full terms: see LICENSE.md.
  */
 
+import { randomUUID } from 'crypto';
+
 import type {
   Attachment,
   Source,
@@ -25,7 +27,6 @@ import {
 import { OnEvent } from '@nestjs/event-emitter';
 import { Request, Response } from 'express';
 import { Socket } from 'socket.io';
-import { v4 as uuidv4 } from 'uuid';
 import type { z } from 'zod';
 
 import { AttachmentOrmEntity } from '@/attachment/entities/attachment.entity';
@@ -125,7 +126,7 @@ export default abstract class BaseWebChannelHandler<N extends ChannelName>
   }
 
   generateId(): string {
-    return `${this.name}-${uuidv4()}`;
+    return `${this.name}-${randomUUID()}`;
   }
 
   getChannelAttributes(

package/src/extensions/index.ts

@@ -41,3 +41,5 @@ export * from './actions/messaging/buttons.action';
 export * from './actions/messaging/attachment.action';
 
 export * from './actions/messaging/list.action';
+
+export * from './actions/web/send-mail.action';

package/src/global.d.ts

@@ -8,10 +8,4 @@ import '../types/event-emitter';
 import '../types/express-session';
 import './types/ai-sdk-mcp-stdio';
 
-declare global {
-  type HyphenToUnderscore<S extends string> = S extends `${infer P}-${infer Q}`
-    ? `${P}_${HyphenToUnderscore<Q>}`
-    : S;
-}
-
 export {};

package/src/license/services/lemon-squeezy.service.ts

@@ -4,10 +4,11 @@
  * Full terms: see LICENSE.md.
  */
 
+import { randomUUID } from 'crypto';
+
 import { HttpService } from '@nestjs/axios';
 import { Injectable } from '@nestjs/common';
 import { AxiosError } from 'axios';
-import { v4 as uuidv4 } from 'uuid';
 
 import {
   LemonSqueezyActivationResponse,
@@ -52,7 +53,7 @@ export class LemonSqueezyService {
         `${LEMON_SQUEEZY_API_BASE_URL}/v1/licenses/activate`,
         {
           license_key: licenseKey,
-          instance_name: uuidv4(),
+          instance_name: randomUUID(),
         },
         {
           headers: {

package/src/mailer/mailer.module.ts

@@ -4,66 +4,13 @@
  * Full terms: see LICENSE.md.
  */
 
-import path from 'path';
-
 import { Global, Module } from '@nestjs/common';
-import {
-  ISendMailOptions,
-  MAILER_OPTIONS,
-  MailerOptions,
-  MailerModule as NestjsMailerModule,
-} from '@nestjs-modules/mailer';
-import SMTPTransport from 'nodemailer/lib/smtp-transport';
-
-import { config } from '@/config';
 
 import { MailerService } from './mailer.service';
-import { MjmlAdapter } from './mjml-adapter.class';
-
-const mailerOptions: MailerOptions = {
-  transport: new SMTPTransport({
-    ...config.emails.smtp,
-    logger: true,
-    debug: false,
-  }),
-  template: {
-    adapter: new MjmlAdapter(),
-    dir: path.join(process.cwd(), 'dist', 'templates'),
-    options: {
-      context: {
-        appName: config.parameters.appName,
-        appUrl: config.uiBaseUrl,
-      },
-    },
-  },
-  defaults: { from: config.emails.from },
-};
 
 @Global()
 @Module({
-  imports: [
-    ...(config.emails.isEnabled
-      ? [NestjsMailerModule.forRoot(mailerOptions)]
-      : []),
-  ],
-  providers: [
-    {
-      provide: MAILER_OPTIONS,
-      useValue: mailerOptions,
-    },
-    ...(config.emails.isEnabled
-      ? [MailerService]
-      : [
-          {
-            provide: MailerService,
-            useValue: {
-              sendMail(_options: ISendMailOptions) {
-                throw new Error('Email Service is not enabled');
-              },
-            },
-          },
-        ]),
-  ],
+  providers: [MailerService],
   exports: [MailerService],
 })
 export class MailerModule {}

package/src/mailer/mailer.service.ts

@@ -4,6 +4,90 @@
  * Full terms: see LICENSE.md.
  */
 
-import { MailerService as NestjsMailerService } from '@nestjs-modules/mailer';
+import { readFile } from 'fs/promises';
+import path from 'path';
 
-export class MailerService extends NestjsMailerService {}
+import { Injectable } from '@nestjs/common';
+import Handlebars from 'handlebars';
+import mjml2html from 'mjml';
+import nodemailer, {
+  SendMailOptions as NodemailerSendMailOptions,
+  SentMessageInfo,
+  Transporter,
+} from 'nodemailer';
+import SMTPTransport from 'nodemailer/lib/smtp-transport';
+
+import { config } from '@/config';
+
+export type SendMailOptions = NodemailerSendMailOptions & {
+  template?: string;
+  context?: Record<string, unknown>;
+};
+
+@Injectable()
+export class MailerService {
+  private readonly transporter?: Transporter<SentMessageInfo>;
+
+  constructor() {
+    if (!config.emails.isEnabled) {
+      return;
+    }
+
+    this.transporter = nodemailer.createTransport(
+      new SMTPTransport({
+        ...config.emails.smtp,
+        logger: true,
+        debug: false,
+      }),
+    );
+  }
+
+  async sendMail({ template, context, ...options }: SendMailOptions) {
+    if (!this.transporter) {
+      throw new Error('Email Service is not enabled');
+    }
+
+    const html = template
+      ? await this.renderTemplate(template, context)
+      : options.html;
+
+    return await this.transporter.sendMail({
+      from: config.emails.from,
+      ...options,
+      html,
+    });
+  }
+
+  async verifyAllTransporters(): Promise<boolean> {
+    if (!this.transporter) {
+      return false;
+    }
+
+    return await this.transporter.verify();
+  }
+
+  private async renderTemplate(
+    template: string,
+    context: Record<string, unknown> = {},
+  ): Promise<string> {
+    const templatePath = path.join(
+      process.cwd(),
+      'dist',
+      'templates',
+      template,
+    );
+    const content = await readFile(templatePath, 'utf-8');
+    const compiledHandlebars = Handlebars.compile(content)({
+      appName: config.parameters.appName,
+      appUrl: config.uiBaseUrl,
+      ...context,
+    });
+    const { errors, html } = mjml2html(compiledHandlebars);
+
+    if (errors.length) {
+      throw new Error('Unable to compile mjml template');
+    }
+
+    return html;
+  }
+}

package/src/user/entities/model.entity.ts

@@ -4,6 +4,8 @@
  * Full terms: see LICENSE.md.
  */
 
+import { createRequire } from 'node:module';
+
 import { modelSchema, modelFullSchema } from '@hexabot-ai/types';
 import { Column, Entity, Index, OneToMany } from 'typeorm';
 
@@ -14,7 +16,9 @@ import { BaseOrmEntity } from '@/database/entities/base.entity';
 import { ModelDto } from '../dto/model.dto';
 import { TRelation } from '../types/index.type';
 
-import { PermissionOrmEntity } from './permission.entity';
+import type { PermissionOrmEntity } from './permission.entity';
+
+const requireEntity = createRequire(__filename);
 
 @Entity({ name: 'models' })
 @Index(['name'], { unique: true })
@@ -34,11 +38,15 @@ export class ModelOrmEntity extends BaseOrmEntity<ModelDto> {
   @JsonColumn({ default: '{}' })
   attributes: Record<string, unknown>;
 
-  @Column({ nullable: true })
+  @Column({ type: 'varchar', nullable: true })
   relation?: TRelation;
 
-  @OneToMany(() => PermissionOrmEntity, (permission) => permission.model, {
-    cascade: ['remove'],
-  })
+  @OneToMany(
+    () => requireEntity('./permission.entity').PermissionOrmEntity,
+    (permission: PermissionOrmEntity) => permission.model,
+    {
+      cascade: ['remove'],
+    },
+  )
   permissions?: PermissionOrmEntity[];
 }