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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hexabot-ai/api",
   "private": false,
-  "version": "3.2.2-alpha.0",
+  "version": "3.2.2-alpha.10",
   "description": "Hexabot is a solution for creating and managing chatbots across multiple channels, leveraging AI for advanced conversational capabilities. It provides a user-friendly interface for building, training, and deploying chatbots with integrated support for various messaging platforms.",
   "author": "Hexastack",
   "license": "FCL-1.0-ALv2",
@@ -31,32 +31,34 @@
     "@keyv/redis": "^5.1.3",
     "@llamaindex/openai": "0.4.22",
     "@llamaindex/postgres": "0.0.65",
-    "@nestjs-modules/mailer": "^2.0.2",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "@nestjs/axios": "^4.0.1",
-    "@nestjs/cache-manager": "^3.0.1",
-    "@nestjs/common": "^11.1.6",
-    "@nestjs/core": "^11.1.6",
-    "@nestjs/event-emitter": "^3.0.1",
+    "@nestjs/cache-manager": "^3.1.2",
+    "@nestjs/common": "^11.1.19",
+    "@nestjs/core": "^11.1.19",
+    "@nestjs/event-emitter": "^3.1.0",
     "@nestjs/jwt": "^11.0.1",
     "@nestjs/mapped-types": "^2.1.0",
     "@nestjs/passport": "^11.0.5",
-    "@nestjs/platform-express": "^11.1.6",
-    "@nestjs/platform-socket.io": "^11.1.6",
+    "@nestjs/platform-express": "^11.1.19",
+    "@nestjs/platform-socket.io": "^11.1.19",
     "@nestjs/schedule": "^6.1.3",
-    "@nestjs/serve-static": "^5.0.4",
-    "@nestjs/swagger": "^11.2.0",
-    "@nestjs/typeorm": "^11.0.0",
-    "@nestjs/websockets": "^11.1.6",
+    "@nestjs/serve-static": "^5.0.5",
+    "@nestjs/swagger": "^11.4.2",
+    "@nestjs/typeorm": "^11.0.1",
+    "@nestjs/websockets": "^11.1.19",
+    "@rekog/mcp-nest": "^1.9.9",
     "@resvg/resvg-js": "^2.6.2",
     "@socket.io/redis-adapter": "^8.3.0",
-    "@types/uuid": "^10.0.0",
     "ai": "^6.0.17",
     "async-mutex": "^0.5.0",
-    "axios": "^1.12.2",
+    "axios": "^1.15.2",
     "bcryptjs": "^3.0.2",
+    "better-sqlite3": "^12.9.0",
     "cache-manager": "^7.2.4",
     "cacheable": "^2.1.0",
     "class-transformer": "^0.5.1",
+    "class-validator": "^0.15.1",
     "connect-typeorm": "^2.0.0",
     "cookie-parser": "^1.4.7",
     "csrf-sync": "^4.2.1",
@@ -66,12 +68,14 @@
     "keyv": "^5.5.3",
     "llamaindex": "0.12.1",
     "mime": "^1.6.0",
+    "mjml": "^5.1.0",
     "module-alias": "2.2.3",
     "nest-commander": "^3.20.1",
     "nestjs-auditlog": "^1.5.6",
     "nestjs-cls": "^6.2.0",
     "nestjs-dynamic-providers": "^0.3.7",
     "nestjs-i18n": "^10.5.1",
+    "nodemailer": "^8.0.7",
     "p-limit": "^3.1.0",
     "papaparse": "^5.5.3",
     "passport": "^0.7.0",
@@ -85,19 +89,19 @@
     "rxjs": "^7.8.2",
     "sanitize-filename": "^1.6.3",
     "slug": "^11.0.0",
-    "sqlite3": "^5.1.7",
-    "typeorm": "^0.3.27",
-    "uuid": "^9.0.1",
-    "yaml": "^2.5.0",
+    "typeorm": "^0.3.28",
+    "yaml": "^2.8.3",
     "zod": "^4.3.6",
-    "@hexabot-ai/agentic": "3.1.2-alpha.0",
-    "@hexabot-ai/types": "3.0.2-alpha.0"
+    "@hexabot-ai/agentic": "3.1.2-alpha.10",
+    "@hexabot-ai/types": "3.0.2-alpha.10"
   },
   "devDependencies": {
     "@compodoc/compodoc": "^1.1.31",
-    "@nestjs/cli": "^11.0.10",
-    "@nestjs/schematics": "^11.0.9",
-    "@nestjs/testing": "^11.1.6",
+    "@nestjs/cli": "^11.0.21",
+    "@nestjs/schematics": "^11.1.0",
+    "@nestjs/testing": "^11.1.19",
+    "@swc/core": "^1.15.32",
+    "@swc/jest": "^0.2.39",
     "@types/cookie-parser": "^1.4.9",
     "@types/cookie-signature": "^1.1.2",
     "@types/express": "^5.0.3",
@@ -105,10 +109,12 @@
     "@types/jest": "^30.0.0",
     "@types/json-schema": "^7.0.15",
     "@types/lodash": "^4.17.20",
+    "@types/mjml": "^5.0.0",
     "@types/module-alias": "^2.0.4",
     "@types/multer": "^2.0.0",
     "@types/node": "^20.3.1",
     "@types/node-fetch": "^2.6.13",
+    "@types/nodemailer": "^8.0.0",
     "@types/papaparse": "^5.3.16",
     "@types/passport-anonymous": "^1.0.5",
     "@types/passport-jwt": "^4.0.1",
@@ -133,13 +139,12 @@
     "socket.io-client": "^4.8.1",
     "source-map-support": "^0.5.21",
     "supertest": "^7.1.4",
-    "ts-jest": "^29.4.5",
     "ts-loader": "^9.4.3",
     "ts-node": "^10.9.2",
     "tsconfig-paths": "^4.2.0",
     "tsconfig-paths-jest": "^0.0.1",
     "typescript": "^5.1.3",
-    "@hexabot-ai/frontend": "3.2.2-alpha.0"
+    "@hexabot-ai/frontend": "3.2.2-alpha.10"
   },
   "optionalDependencies": {
     "@css-inline/css-inline-linux-arm64-musl": "^0.14.1",
@@ -163,7 +168,35 @@
     "rootDir": "src",
     "testRegex": ".*\\.spec\\.ts$",
     "transform": {
-      "^.+\\.(t|j)s$": "ts-jest"
+      "^.+\\.(t|j)s$": [
+        "@swc/jest",
+        {
+          "jsc": {
+            "parser": {
+              "syntax": "typescript",
+              "decorators": true,
+              "dynamicImport": true
+            },
+            "target": "es2021",
+            "transform": {
+              "legacyDecorator": true,
+              "decoratorMetadata": true
+            },
+            "keepClassNames": true,
+            "loose": true,
+            "baseUrl": ".",
+            "paths": {
+              "@/*": [
+                "src/*"
+              ]
+            }
+          },
+          "module": {
+            "type": "commonjs"
+          },
+          "sourceMaps": true
+        }
+      ]
     },
     "collectCoverageFrom": [
       "**/*.(t|j)s"
@@ -195,13 +228,13 @@
     "start:repl": "pnpm run start -- --entryFile repl",
     "lint": "eslint \"{src,apps,libs,test}/**/*.ts\"",
     "lint:fix": "eslint \"{src,apps,libs,test}/**/*.ts\" --fix",
-    "test": "jest --logHeapUsage --maxWorkers=50% --workerIdleMemoryLimit=1GB --testTimeout=10000",
-    "test:runInBand": "jest --runInBand --logHeapUsage --detectOpenHandles --forceExit",
-    "test:half": "jest --logHeapUsage --maxWorkers=50% --testTimeout=10000",
-    "test:full": "jest --logHeapUsage --maxWorkers=100% --testTimeout=10000",
+    "test": "NODE_OPTIONS=--expose-gc jest --logHeapUsage --maxWorkers=50% --workerIdleMemoryLimit=1500MB --testTimeout=10000",
+    "test:runInBand": "NODE_OPTIONS=--expose-gc jest --runInBand --logHeapUsage --detectOpenHandles --forceExit",
+    "test:half": "NODE_OPTIONS=--expose-gc jest --logHeapUsage --maxWorkers=50% --workerIdleMemoryLimit=1500MB --testTimeout=10000",
+    "test:full": "NODE_OPTIONS=--expose-gc jest --logHeapUsage --maxWorkers=100% --workerIdleMemoryLimit=1500MB --testTimeout=10000",
     "test:watch": "jest --watch --detectOpenHandles",
-    "test:cov": "jest --coverage --runInBand --detectOpenHandles --forceExit",
-    "test:debug": "node --inspect-brk -r tsconfig-paths/register -r ts-node/register node_modules/.bin/jest --runInBand",
+    "test:cov": "NODE_OPTIONS=--expose-gc jest --coverage --runInBand --detectOpenHandles --forceExit",
+    "test:debug": "node --expose-gc --inspect-brk -r tsconfig-paths/register -r ts-node/register node_modules/.bin/jest --runInBand",
     "test:e2e": "jest --config ./test/jest-e2e.json",
     "test:clear": "jest --clearCache",
     "typecheck": "tsc --noEmit -p tsconfig.typecheck.json",

package/src/app.controller.ts

@@ -33,6 +33,7 @@ export class AppController {
     return {
       apiUrl: config.apiBaseUrl,
       ssoEnabled: config.ssoEnabled,
+      mcpEnabled: config.mcp.enabled,
       maxUploadSize: config.parameters.maxUploadSize,
       hasUserSession: !!req.session.passport?.user,
     };

package/src/app.module.ts

@@ -5,6 +5,7 @@
  */
 
 import { existsSync } from 'fs';
+import { createRequire } from 'node:module';
 import path, { join } from 'path';
 
 import KeyvRedis from '@keyv/redis';
@@ -57,6 +58,18 @@ const workspaceFrontendPath = join(__dirname, '..', '..', 'frontend', 'dist');
 const frontendStaticPath = existsSync(compiledFrontendPath)
   ? compiledFrontendPath
   : workspaceFrontendPath;
+const requireModule = createRequire(__filename);
+const getMcpModuleImports = (): ModuleImports => {
+  if (!config.mcp.enabled) {
+    return [];
+  }
+
+  const { McpApiModule } = requireModule(
+    './mcp/mcp-api.module',
+  ) as typeof import('./mcp/mcp-api.module');
+
+  return [McpApiModule];
+};
 // I18N options
 const i18nOptions: I18nOptions = {
   fallbackLanguage: 'en',
@@ -68,7 +81,7 @@ const i18nOptions: I18nOptions = {
       path.join(__dirname, '/extensions/helpers/'),
       path.join(__dirname, '/extensions/channels/'),
     ],
-    watch: true,
+    watch: config.env.toLowerCase() !== 'test',
   },
   resolvers: [
     { use: QueryResolver, options: ['lang'] },
@@ -123,6 +136,7 @@ export const HEXABOT_MODULE_IMPORTS: ModuleImports = [
     ignoreErrors: false,
   }),
   I18nModule.forRoot(i18nOptions),
+  ...getMcpModuleImports(),
   CacheModule.registerAsync({
     isGlobal: true,
     useFactory: async () => ({

package/src/attachment/utilities/index.ts

@@ -4,13 +4,13 @@
  * Full terms: see LICENSE.md.
  */
 
+import { randomUUID } from 'crypto';
 import { createReadStream, existsSync } from 'fs';
 import { extname } from 'path';
 import { Readable } from 'stream';
 
 import { Logger, StreamableFile } from '@nestjs/common';
 import { StreamableFileOptions } from '@nestjs/common/file-stream/interfaces/streamable-options.interface';
-import { v4 as uuidv4 } from 'uuid';
 
 import { config } from '@/config';
 
@@ -80,7 +80,7 @@ export const generateUniqueFilename = (originalname: string) => {
   const extension = extname(originalname);
   const name = originalname.slice(0, -extension.length);
 
-  return `${name}-${uuidv4()}${extension}`;
+  return `${name}-${randomUUID()}${extension}`;
 };
 
 /**

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');
@@ -37,6 +43,9 @@ const isProductionEnv = (forced?: boolean): boolean => {
 
   return config.env.toLowerCase().includes('prod');
 };
+const normalizeLocalhostUrl = (url: string): string => {
+  return url.replace('://127.0.0.1', '://localhost');
+};
 
 export interface HexabotBootstrapOptions {
   listen?: {
@@ -54,6 +63,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 +144,8 @@ export async function bootstrapHexabotApp(
   const host = options.listen?.host ?? '0.0.0.0';
 
   await app.listen(port, host);
+  const appUrl = normalizeLocalhostUrl(await app.getUrl());
+  Logger.log(`Hexabot is running at ${appUrl}`, 'Hexabot');
 
   return app;
 }

package/src/channel/channel.service.ts

@@ -42,9 +42,12 @@ export class ChannelService implements OnApplicationBootstrap {
   ) {}
 
   async onApplicationBootstrap(): Promise<void> {
-    await this.sourceService.ensureDefaultSources(
-      this.getAll().map((handler) => handler.getName()),
+    const registeredChannelNames = this.getAll().map((handler) =>
+      handler.getName(),
     );
+
+    await this.sourceService.ensureDefaultSources(registeredChannelNames);
+    await this.sourceService.disableUnregisteredSources(registeredChannelNames);
   }
 
   public setChannel<T extends ChannelName, C extends ChannelHandler<T>>(

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/channel/lib/__test__/label.mock.ts

@@ -12,12 +12,6 @@ const baseLabel: Label = {
   ...modelInstance,
   title: '',
   name: '',
-  label_id: {
-    messenger: '',
-    web: '',
-    dimelo: '',
-    twitter: '',
-  },
   description: '',
   builtin: false,
   group: null,
@@ -27,12 +21,6 @@ export const labelMock: Label = {
   ...baseLabel,
   title: 'Label',
   name: 'label',
-  label_id: {
-    messenger: 'none',
-    web: 'none',
-    dimelo: 'none',
-    twitter: 'none',
-  },
 };
 
 export const customerLabelsMock: Label[] = [
@@ -40,22 +28,10 @@ export const customerLabelsMock: Label[] = [
     ...baseLabel,
     title: 'Client',
     name: 'client',
-    label_id: {
-      messenger: 'none',
-      web: 'none',
-      dimelo: 'none',
-      twitter: 'none',
-    },
   },
   {
     ...baseLabel,
     title: 'Professional',
     name: 'profressional',
-    label_id: {
-      messenger: 'none',
-      web: 'none',
-      dimelo: 'none',
-      twitter: 'none',
-    },
   },
 ];

package/src/channel/services/source.service.ts

@@ -11,7 +11,7 @@ import {
   MethodNotAllowedException,
   NotFoundException,
 } from '@nestjs/common';
-import { FindManyOptions, FindOneOptions } from 'typeorm';
+import { FindManyOptions, FindOneOptions, In, Not } from 'typeorm';
 import { DeleteResult } from 'typeorm/driver/mongodb/typings';
 import z from 'zod';
 
@@ -107,6 +107,12 @@ export class SourceService extends BaseOrmService<SourceOrmEntity> {
     return defaultWorkflow;
   }
 
+  private isStateOnlyDisablePayload(payload: SourceUpdateDto): boolean {
+    const keys = Object.keys(payload);
+
+    return keys.length === 1 && keys[0] === 'state' && payload.state === false;
+  }
+
   private async buildCreatePayload(
     payload: SourceCreateDto,
   ): Promise<SourceCreateDto> {
@@ -141,6 +147,16 @@ export class SourceService extends BaseOrmService<SourceOrmEntity> {
       throw new NotFoundException('Source not found');
     }
 
+    if (!this.channelRegistry.findChannel(existing.channel)) {
+      if (this.isStateOnlyDisablePayload(payload)) {
+        return await super.updateOne(idOrOptions, { state: false }, options);
+      }
+
+      throw new BadRequestException(
+        `Channel "${existing.channel}" is not registered`,
+      );
+    }
+
     const channel = payload.channel ?? existing.channel;
     const shouldResetSettings =
       payload.channel !== undefined && payload.settings === undefined;
@@ -167,6 +183,27 @@ export class SourceService extends BaseOrmService<SourceOrmEntity> {
     );
   }
 
+  async disableUnregisteredSources(
+    registeredChannelNames: string[],
+  ): Promise<Source[]> {
+    const uniqueRegisteredChannelNames = Array.from(
+      new Set(registeredChannelNames),
+    );
+
+    return await super.updateMany(
+      {
+        where:
+          uniqueRegisteredChannelNames.length > 0
+            ? {
+                state: true,
+                channel: Not(In(uniqueRegisteredChannelNames)),
+              }
+            : { state: true },
+      },
+      { state: false },
+    );
+  }
+
   async findActiveByRef(sourceRef: string): Promise<Source> {
     const normalizedSourceRef = sourceRef.trim();
     const source = await this.findOne(normalizedSourceRef);

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/dto/label.dto.ts

@@ -6,13 +6,7 @@
 
 import { labelFullSchema, labelSchema } from '@hexabot-ai/types';
 import { ApiProperty, ApiPropertyOptional, PartialType } from '@nestjs/swagger';
-import {
-  IsNotEmpty,
-  IsObject,
-  IsOptional,
-  IsString,
-  Matches,
-} from 'class-validator';
+import { IsNotEmpty, IsOptional, IsString, Matches } from 'class-validator';
 
 import { IsUUIDv4 } from '@/utils/decorators/is-uuid.decorator';
 import { TDto } from '@/utils/types/dto.types';
@@ -43,11 +37,6 @@ export class LabelCreateDto {
   @IsOptional()
   @IsString()
   description?: string;
-
-  @ApiPropertyOptional({ description: 'Label id', type: Object })
-  @IsOptional()
-  @IsObject()
-  label_id?: Record<string, any>;
 }
 
 export class LabelUpdateDto extends PartialType(LabelCreateDto) {}

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

@@ -16,7 +16,6 @@ import {
 } from 'typeorm';
 
 import { AuditLabel } from '@/audit/decorators/audit-label.decorator';
-import { JsonColumn } from '@/database/decorators/json-column.decorator';
 import { BaseOrmEntity } from '@/database/entities/base.entity';
 import { AsRelation } from '@/utils/decorators/relation-ref.decorator';
 
@@ -51,9 +50,6 @@ export class LabelOrmEntity extends BaseOrmEntity<LabelDto> {
   @RelationId((label: LabelOrmEntity) => label.group)
   private readonly groupId?: string | null;
 
-  @JsonColumn({ nullable: true })
-  label_id?: Record<string, any> | null;
-
   @Column({ type: 'text', nullable: true })
   description?: string | null;
 

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;