@hexabot-ai/api 3.2.2-alpha.1 → 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/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/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[];
 }

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

@@ -4,6 +4,8 @@
  * Full terms: see LICENSE.md.
  */
 
+import { createRequire } from 'node:module';
+
 import { permissionSchema, permissionFullSchema } from '@hexabot-ai/types';
 import {
   Column,
@@ -22,8 +24,10 @@ import { PermissionDto } from '../dto/permission.dto';
 import { Action } from '../types/action.type';
 import { TRelation } from '../types/index.type';
 
-import { ModelOrmEntity } from './model.entity';
-import { RoleOrmEntity } from './role.entity';
+import type { ModelOrmEntity } from './model.entity';
+import type { RoleOrmEntity } from './role.entity';
+
+const requireEntity = createRequire(__filename);
 
 @Entity({ name: 'permissions' })
 @Index(['model', 'action', 'role', 'relation'], { unique: true })
@@ -32,9 +36,13 @@ export class PermissionOrmEntity extends BaseOrmEntity<PermissionDto> {
 
   fullCls = permissionFullSchema;
 
-  @ManyToOne(() => ModelOrmEntity, (model) => model.permissions, {
-    onDelete: 'CASCADE',
-  })
+  @ManyToOne(
+    () => requireEntity('./model.entity').ModelOrmEntity,
+    (model: ModelOrmEntity) => model.permissions,
+    {
+      onDelete: 'CASCADE',
+    },
+  )
   @JoinColumn({ name: 'model_id' })
   @AsRelation()
   model!: ModelOrmEntity;
@@ -45,9 +53,13 @@ export class PermissionOrmEntity extends BaseOrmEntity<PermissionDto> {
   @EnumColumn({ enum: Action })
   action!: Action;
 
-  @ManyToOne(() => RoleOrmEntity, (role) => role.permissions, {
-    onDelete: 'CASCADE',
-  })
+  @ManyToOne(
+    () => requireEntity('./role.entity').RoleOrmEntity,
+    (role: RoleOrmEntity) => role.permissions,
+    {
+      onDelete: 'CASCADE',
+    },
+  )
   @JoinColumn({ name: 'role_id' })
   @AsRelation()
   role!: RoleOrmEntity;
@@ -55,6 +67,6 @@ export class PermissionOrmEntity extends BaseOrmEntity<PermissionDto> {
   @RelationId((permission: PermissionOrmEntity) => permission.role)
   private readonly roleId!: string;
 
-  @Column({ default: 'role' })
+  @Column({ type: 'varchar', default: 'role' })
   relation!: TRelation;
 }

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

@@ -4,6 +4,8 @@
  * Full terms: see LICENSE.md.
  */
 
+import { createRequire } from 'node:module';
+
 import { roleSchema, roleFullSchema } from '@hexabot-ai/types';
 import { Column, Entity, Index, ManyToMany, OneToMany } from 'typeorm';
 
@@ -12,9 +14,11 @@ import { BaseOrmEntity } from '@/database/entities/base.entity';
 
 import { RoleDto } from '../dto/role.dto';
 
-import { PermissionOrmEntity } from './permission.entity';
+import type { PermissionOrmEntity } from './permission.entity';
 import { UserOrmEntity } from './user.entity';
 
+const requireEntity = createRequire(__filename);
+
 export type TRole = 'admin' | 'public';
 
 @Entity({ name: 'roles' })
@@ -31,9 +35,13 @@ export class RoleOrmEntity extends BaseOrmEntity<RoleDto> {
   @Column({ default: true })
   active!: boolean;
 
-  @OneToMany(() => PermissionOrmEntity, (permission) => permission.role, {
-    cascade: ['remove'],
-  })
+  @OneToMany(
+    () => requireEntity('./permission.entity').PermissionOrmEntity,
+    (permission: PermissionOrmEntity) => permission.role,
+    {
+      cascade: ['remove'],
+    },
+  )
   permissions?: PermissionOrmEntity[];
 
   @ManyToMany(() => UserOrmEntity, (user) => user.roles)

package/src/utils/generics/extension.ts

@@ -8,13 +8,11 @@ import { Inject, OnModuleInit } from '@nestjs/common';
 
 import { LoggerService } from '@/logger/logger.service';
 
-import { ExtensionName } from '../types/extension';
-
 export abstract class Extension implements OnModuleInit {
   @Inject(LoggerService)
   protected readonly logger: LoggerService;
 
-  constructor(public readonly name: ExtensionName) {}
+  constructor(public readonly name: string) {}
 
   getName() {
     return this.name;

package/src/utils/index.ts

@@ -62,8 +62,6 @@ export * from './pipes/zod.pipe';
 
 export * from './types/dto.types';
 
-export * from './types/extension';
-
 export * from './types/filter.types';
 
 export * from './types/format.types';

package/src/utils/pipes/uuid.pipe.ts

@@ -10,7 +10,7 @@ import {
   Injectable,
   PipeTransform,
 } from '@nestjs/common';
-import { validate as uuidValidate, version as uuidVersion } from 'uuid';
+import { isUUID } from 'class-validator';
 
 /**
  * Validates UUID route parameters by automatically checking parameters named `id`
@@ -56,13 +56,13 @@ export class UuidPipe implements PipeTransform {
 
   private ensureUuid(rawValue: string, paramName: string): void {
     const candidate = rawValue.trim();
-    if (!uuidValidate(candidate)) {
+    if (!isUUID(candidate)) {
       throw new BadRequestException(
         `Invalid UUID supplied for "${paramName}".`,
       );
     }
 
-    const version = uuidVersion(candidate);
+    const version = Number(candidate[14]);
     if (!this.allowedVersions.has(version)) {
       throw new BadRequestException(
         `Unsupported UUID version (${version}) supplied for "${paramName}".`,