@hexabot-ai/api 3.2.2-alpha.8 → 3.2.2-beta.0

package/src/transfer/workflow-transfer.controller.ts

@@ -0,0 +1,86 @@
+/*
+ * Hexabot — Fair Core License (FCL-1.0-ALv2)
+ * Copyright (c) 2026 Hexastack.
+ * Full terms: see LICENSE.md.
+ */
+
+import { WorkflowImportResult } from '@hexabot-ai/types';
+import {
+  BadRequestException,
+  Controller,
+  Get,
+  Post,
+  Req,
+  Res,
+  UnauthorizedException,
+  UploadedFile,
+  UseInterceptors,
+} from '@nestjs/common';
+import { FileInterceptor } from '@nestjs/platform-express';
+import { Request, Response } from 'express';
+
+import { UuidParam } from '@/utils/decorators/uuid-param.decorator';
+
+import { WorkflowTransferService } from './workflow-transfer.service';
+
+@Controller('workflow')
+export class WorkflowTransferController {
+  constructor(
+    private readonly workflowTransferService: WorkflowTransferService,
+  ) {}
+
+  /**
+   * Imports a workflow bundle YAML file.
+   *
+   * @param file - Uploaded `.workflow.yml` bundle.
+   * @param req - Express request containing the authenticated session.
+   *
+   * @returns Imported workflow and resource mapping summary.
+   */
+  @Post('import')
+  @UseInterceptors(FileInterceptor('file'))
+  async importWorkflow(
+    @UploadedFile() file: Express.Multer.File,
+    @Req() req: Request,
+  ): Promise<WorkflowImportResult> {
+    const userId = req.session?.passport?.user?.id;
+    if (!userId) {
+      throw new UnauthorizedException(
+        'Only authenticated users can import workflows',
+      );
+    }
+
+    if (!file?.buffer) {
+      throw new BadRequestException('No workflow bundle file was selected');
+    }
+
+    return await this.workflowTransferService.importWorkflow(
+      file.buffer.toString('utf-8'),
+      userId,
+    );
+  }
+
+  /**
+   * Exports a workflow bundle YAML file.
+   *
+   * @param id - Workflow identifier.
+   * @param res - Express response used to attach download headers.
+   *
+   * @returns YAML bundle content.
+   */
+  @Get(':id/export')
+  async exportWorkflow(
+    @UuidParam('id') id: string,
+    @Res({ passthrough: true }) res: Response,
+  ): Promise<string> {
+    const exported = await this.workflowTransferService.exportWorkflow(id);
+
+    res.setHeader('Content-Type', 'application/x-yaml; charset=utf-8');
+    res.setHeader(
+      'Content-Disposition',
+      `attachment; filename="${exported.filename}"`,
+    );
+
+    return exported.content;
+  }
+}

package/src/transfer/workflow-transfer.module.ts

@@ -0,0 +1,46 @@
+/*
+ * Hexabot — Fair Core License (FCL-1.0-ALv2)
+ * Copyright (c) 2026 Hexastack.
+ * Full terms: see LICENSE.md.
+ */
+
+import { Module } from '@nestjs/common';
+import { DiscoveryModule } from '@nestjs/core';
+import { InjectDynamicProviders } from 'nestjs-dynamic-providers';
+
+import { ChatModule } from '@/chat/chat.module';
+import { CmsModule } from '@/cms/cms.module';
+import { UserModule } from '@/user/user.module';
+import { WorkflowModule } from '@/workflow/workflow.module';
+
+import { ContentTypeTransferAdapter } from './adapters/content-type-transfer.adapter';
+import { CredentialTransferAdapter } from './adapters/credential-transfer.adapter';
+import { LabelTransferAdapter } from './adapters/label-transfer.adapter';
+import { McpServerTransferAdapter } from './adapters/mcp-server-transfer.adapter';
+import { MemoryDefinitionTransferAdapter } from './adapters/memory-definition-transfer.adapter';
+import { WorkflowTransferAdapterRegistry } from './workflow-transfer-adapter.registry';
+import { WorkflowTransferDefinitionService } from './workflow-transfer-definition.service';
+import { WorkflowTransferController } from './workflow-transfer.controller';
+import { WorkflowTransferService } from './workflow-transfer.service';
+
+@InjectDynamicProviders(
+  'node_modules/@hexabot-ai/api/dist/extensions/**/*.workflow-transfer.adapter.js',
+  'node_modules/hexabot-*/**/*.workflow-transfer.adapter.js',
+  'dist/extensions/**/*.workflow-transfer.adapter.js',
+)
+@Module({
+  imports: [DiscoveryModule, WorkflowModule, UserModule, CmsModule, ChatModule],
+  controllers: [WorkflowTransferController],
+  providers: [
+    WorkflowTransferDefinitionService,
+    WorkflowTransferAdapterRegistry,
+    CredentialTransferAdapter,
+    MemoryDefinitionTransferAdapter,
+    ContentTypeTransferAdapter,
+    LabelTransferAdapter,
+    McpServerTransferAdapter,
+    WorkflowTransferService,
+  ],
+  exports: [WorkflowTransferService, WorkflowTransferAdapterRegistry],
+})
+export class WorkflowTransferModule {}