@solidxai/core 0.1.12 → 0.1.13-beta.2

package/src/controllers/workflow-execution-log.controller.ts

@@ -0,0 +1,93 @@
+import { Controller, Post, Body, Param, UploadedFiles, UseInterceptors, Put, Get, Query, Delete, Patch } from '@nestjs/common';
+import { AnyFilesInterceptor } from "@nestjs/platform-express";
+import { ApiBearerAuth, ApiQuery, ApiTags } from '@nestjs/swagger';
+import { WorkflowExecutionLogService } from '../services/workflow-execution-log.service';
+import { CreateWorkflowExecutionLogDto } from '../dtos/create-workflow-execution-log.dto';
+import { UpdateWorkflowExecutionLogDto } from '../dtos/update-workflow-execution-log.dto';
+
+enum ShowSoftDeleted {
+  INCLUSIVE = "inclusive",
+  EXCLUSIVE = "exclusive",
+}
+
+@ApiTags('Solid Core')
+@Controller('workflow-execution-log')
+export class WorkflowExecutionLogController {
+  constructor(private readonly service: WorkflowExecutionLogService) {}
+
+  @ApiBearerAuth("jwt")
+  @Post()
+  @UseInterceptors(AnyFilesInterceptor())
+  create(@Body() createDto: CreateWorkflowExecutionLogDto, @UploadedFiles() files: Array<Express.Multer.File>) {
+    return this.service.create(createDto, files);
+  }
+
+  @ApiBearerAuth("jwt")
+  @Post('/bulk')
+  @UseInterceptors(AnyFilesInterceptor())
+  insertMany(@Body() createDtos: CreateWorkflowExecutionLogDto[], @UploadedFiles() filesArray: Express.Multer.File[][] = []) {
+    return this.service.insertMany(createDtos, filesArray);
+  }
+
+
+  @ApiBearerAuth("jwt")
+  @Put(':id')
+  @UseInterceptors(AnyFilesInterceptor())
+  update(@Param('id') id: number, @Body() updateDto: UpdateWorkflowExecutionLogDto, @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: UpdateWorkflowExecutionLogDto, @UploadedFiles() files: Array<Express.Multer.File>) {
+    return this.service.update(id, updateDto, files, true);
+  }
+
+  @ApiBearerAuth("jwt")
+  @Post('/bulk-recover')
+  async recoverMany(@Body() ids: number[]) {
+    return this.service.recoverMany(ids);
+  }
+
+  @ApiBearerAuth("jwt")
+  @Get('/recover/:id')
+  async recover(@Param('id') id: number) {
+    return this.service.recover(id);
+  }
+    
+  @ApiBearerAuth("jwt")
+  @ApiQuery({ name: 'showSoftDeleted', required: false, enum: ShowSoftDeleted })
+  @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: 'groupBy', required: false, type: Array })
+  @ApiQuery({ name: 'populate', required: false, type: Array })
+  @ApiQuery({ name: 'populateMedia', required: false, type: Array })
+  @ApiQuery({ name: 'filters', required: false, type: Array })
+  @Get()
+  async findMany(@Query() query: any) { 
+    return this.service.find(query);  
+  }
+
+  @ApiBearerAuth("jwt")
+  @Get(':id')
+  async findOne(@Param('id') id: string, @Query() query: any) {
+    return this.service.findOne(+id, query);
+  }
+
+  @ApiBearerAuth("jwt")
+  @Delete('/bulk')
+  async deleteMany(@Body() ids: number[]) {
+    return this.service.deleteMany(ids);
+  }
+
+  @ApiBearerAuth("jwt")
+  @Delete(':id')
+  async delete(@Param('id') id: number) {
+    return this.service.delete(id);
+  }
+
+
+}

package/src/controllers/workflow-execution.controller.ts

@@ -0,0 +1,126 @@
+import { Controller, Post, Body, Param, UploadedFiles, UseInterceptors, Put, Get, Query, Delete, Patch } from '@nestjs/common';
+import { AnyFilesInterceptor } from "@nestjs/platform-express";
+import { ApiBearerAuth, ApiQuery, ApiTags } from '@nestjs/swagger';
+import { WorkflowExecutionService } from '../services/workflow-execution.service';
+import { CreateWorkflowExecutionDto } from '../dtos/create-workflow-execution.dto';
+import { UpdateWorkflowExecutionDto } from '../dtos/update-workflow-execution.dto';
+import { WorkflowRuntimeService } from '../services/workflow/workflow-runtime.service';
+
+enum ShowSoftDeleted {
+  INCLUSIVE = "inclusive",
+  EXCLUSIVE = "exclusive",
+}
+
+@ApiTags('Solid Core')
+@Controller('workflow-execution')
+export class WorkflowExecutionController {
+  constructor(
+    private readonly service: WorkflowExecutionService,
+    private readonly workflowRuntimeService: WorkflowRuntimeService,
+  ) {}
+
+  @ApiBearerAuth("jwt")
+  @Post()
+  @UseInterceptors(AnyFilesInterceptor())
+  create(@Body() createDto: CreateWorkflowExecutionDto, @UploadedFiles() files: Array<Express.Multer.File>) {
+    return this.service.create(createDto, files);
+  }
+
+  @ApiBearerAuth("jwt")
+  @Post('/bulk')
+  @UseInterceptors(AnyFilesInterceptor())
+  insertMany(@Body() createDtos: CreateWorkflowExecutionDto[], @UploadedFiles() filesArray: Express.Multer.File[][] = []) {
+    return this.service.insertMany(createDtos, filesArray);
+  }
+
+
+  @ApiBearerAuth("jwt")
+  @Put(':id')
+  @UseInterceptors(AnyFilesInterceptor())
+  update(@Param('id') id: number, @Body() updateDto: UpdateWorkflowExecutionDto, @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: UpdateWorkflowExecutionDto, @UploadedFiles() files: Array<Express.Multer.File>) {
+    return this.service.update(id, updateDto, files, true);
+  }
+
+  @ApiBearerAuth("jwt")
+  @Post('/bulk-recover')
+  async recoverMany(@Body() ids: number[]) {
+    return this.service.recoverMany(ids);
+  }
+
+  @ApiBearerAuth("jwt")
+  @Get('/recover/:id')
+  async recover(@Param('id') id: number) {
+    return this.service.recover(id);
+  }
+
+  @ApiBearerAuth("jwt")
+  @Get(':id/status')
+  async getExecutionStatus(@Param('id') id: string) {
+    return this.workflowRuntimeService.getExecutionStatus(+id);
+  }
+
+  @ApiBearerAuth("jwt")
+  @Get(':id/output/last-step')
+  async getLastStepOutput(@Param('id') id: string) {
+    return this.workflowRuntimeService.getLastStepOutput(+id);
+  }
+
+  @ApiBearerAuth("jwt")
+  @ApiQuery({ name: 'latest', required: false, type: Boolean })
+  @ApiQuery({ name: 'limit', required: false, type: Number })
+  @ApiQuery({ name: 'offset', required: false, type: Number })
+  @Get(':id/output/step/:stepNameOrId')
+  async getStepOutput(
+    @Param('id') id: string,
+    @Param('stepNameOrId') stepNameOrId: string,
+    @Query() query: any,
+  ) {
+    return this.workflowRuntimeService.getStepOutput(+id, stepNameOrId, {
+      latest: query.latest !== undefined ? query.latest !== 'false' : undefined,
+      limit: query.limit !== undefined ? Number(query.limit) : undefined,
+      offset: query.offset !== undefined ? Number(query.offset) : undefined,
+    });
+  }
+    
+  @ApiBearerAuth("jwt")
+  @ApiQuery({ name: 'showSoftDeleted', required: false, enum: ShowSoftDeleted })
+  @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: 'groupBy', required: false, type: Array })
+  @ApiQuery({ name: 'populate', required: false, type: Array })
+  @ApiQuery({ name: 'populateMedia', required: false, type: Array })
+  @ApiQuery({ name: 'filters', required: false, type: Array })
+  @Get()
+  async findMany(@Query() query: any) { 
+    return this.service.find(query);  
+  }
+
+  @ApiBearerAuth("jwt")
+  @Get(':id')
+  async findOne(@Param('id') id: string, @Query() query: any) {
+    return this.service.findOne(+id, query);
+  }
+
+  @ApiBearerAuth("jwt")
+  @Delete('/bulk')
+  async deleteMany(@Body() ids: number[]) {
+    return this.service.deleteMany(ids);
+  }
+
+  @ApiBearerAuth("jwt")
+  @Delete(':id')
+  async delete(@Param('id') id: number) {
+    return this.service.delete(id);
+  }
+
+
+}

package/src/controllers/workflow-secret.controller.ts

@@ -0,0 +1,90 @@
+import { Controller, Post, Body, Param, UploadedFiles, UseInterceptors, Put, Get, Query, Delete, Patch } from '@nestjs/common';
+import { AnyFilesInterceptor } from "@nestjs/platform-express";
+import { ApiBearerAuth, ApiQuery, ApiTags } from '@nestjs/swagger';
+import { WorkflowSecretService } from '../services/workflow-secret.service';
+import { CreateWorkflowSecretDto } from '../dtos/create-workflow-secret.dto';
+import { UpdateWorkflowSecretDto } from '../dtos/update-workflow-secret.dto';
+
+enum ShowSoftDeleted {
+  INCLUSIVE = "inclusive",
+  EXCLUSIVE = "exclusive",
+}
+
+@ApiTags('Solid Core')
+@Controller('workflow-secret')
+export class WorkflowSecretController {
+  constructor(private readonly service: WorkflowSecretService) {}
+
+  @ApiBearerAuth("jwt")
+  @Post()
+  @UseInterceptors(AnyFilesInterceptor())
+  create(@Body() createDto: CreateWorkflowSecretDto, @UploadedFiles() files: Array<Express.Multer.File>) {
+    return this.service.create(createDto, files);
+  }
+
+  @ApiBearerAuth("jwt")
+  @Post('/bulk')
+  @UseInterceptors(AnyFilesInterceptor())
+  insertMany(@Body() createDtos: CreateWorkflowSecretDto[], @UploadedFiles() filesArray: Express.Multer.File[][] = []) {
+    return this.service.insertMany(createDtos, filesArray);
+  }
+
+  @ApiBearerAuth("jwt")
+  @Put(':id')
+  @UseInterceptors(AnyFilesInterceptor())
+  update(@Param('id') id: number, @Body() updateDto: UpdateWorkflowSecretDto, @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: UpdateWorkflowSecretDto, @UploadedFiles() files: Array<Express.Multer.File>) {
+    return this.service.update(id, updateDto, files, true);
+  }
+
+  @ApiBearerAuth("jwt")
+  @Post('/bulk-recover')
+  async recoverMany(@Body() ids: number[]) {
+    return this.service.recoverMany(ids);
+  }
+
+  @ApiBearerAuth("jwt")
+  @Get('/recover/:id')
+  async recover(@Param('id') id: number) {
+    return this.service.recover(id);
+  }
+
+  @ApiBearerAuth("jwt")
+  @ApiQuery({ name: 'showSoftDeleted', required: false, enum: ShowSoftDeleted })
+  @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: 'groupBy', required: false, type: Array })
+  @ApiQuery({ name: 'populate', required: false, type: Array })
+  @ApiQuery({ name: 'populateMedia', required: false, type: Array })
+  @ApiQuery({ name: 'filters', required: false, type: Array })
+  @Get()
+  async findMany(@Query() query: any) {
+    return this.service.find(query);
+  }
+
+  @ApiBearerAuth("jwt")
+  @Get(':id')
+  async findOne(@Param('id') id: string, @Query() query: any) {
+    return this.service.findOne(+id, query);
+  }
+
+  @ApiBearerAuth("jwt")
+  @Delete('/bulk')
+  async deleteMany(@Body() ids: number[]) {
+    return this.service.deleteMany(ids);
+  }
+
+  @ApiBearerAuth("jwt")
+  @Delete(':id')
+  async delete(@Param('id') id: number) {
+    return this.service.delete(id);
+  }
+}

package/src/controllers/workflow-step-execution.controller.ts

@@ -0,0 +1,93 @@
+import { Controller, Post, Body, Param, UploadedFiles, UseInterceptors, Put, Get, Query, Delete, Patch } from '@nestjs/common';
+import { AnyFilesInterceptor } from "@nestjs/platform-express";
+import { ApiBearerAuth, ApiQuery, ApiTags } from '@nestjs/swagger';
+import { WorkflowStepExecutionService } from '../services/workflow-step-execution.service';
+import { CreateWorkflowStepExecutionDto } from '../dtos/create-workflow-step-execution.dto';
+import { UpdateWorkflowStepExecutionDto } from '../dtos/update-workflow-step-execution.dto';
+
+enum ShowSoftDeleted {
+  INCLUSIVE = "inclusive",
+  EXCLUSIVE = "exclusive",
+}
+
+@ApiTags('Solid Core')
+@Controller('workflow-step-execution')
+export class WorkflowStepExecutionController {
+  constructor(private readonly service: WorkflowStepExecutionService) {}
+
+  @ApiBearerAuth("jwt")
+  @Post()
+  @UseInterceptors(AnyFilesInterceptor())
+  create(@Body() createDto: CreateWorkflowStepExecutionDto, @UploadedFiles() files: Array<Express.Multer.File>) {
+    return this.service.create(createDto, files);
+  }
+
+  @ApiBearerAuth("jwt")
+  @Post('/bulk')
+  @UseInterceptors(AnyFilesInterceptor())
+  insertMany(@Body() createDtos: CreateWorkflowStepExecutionDto[], @UploadedFiles() filesArray: Express.Multer.File[][] = []) {
+    return this.service.insertMany(createDtos, filesArray);
+  }
+
+
+  @ApiBearerAuth("jwt")
+  @Put(':id')
+  @UseInterceptors(AnyFilesInterceptor())
+  update(@Param('id') id: number, @Body() updateDto: UpdateWorkflowStepExecutionDto, @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: UpdateWorkflowStepExecutionDto, @UploadedFiles() files: Array<Express.Multer.File>) {
+    return this.service.update(id, updateDto, files, true);
+  }
+
+  @ApiBearerAuth("jwt")
+  @Post('/bulk-recover')
+  async recoverMany(@Body() ids: number[]) {
+    return this.service.recoverMany(ids);
+  }
+
+  @ApiBearerAuth("jwt")
+  @Get('/recover/:id')
+  async recover(@Param('id') id: number) {
+    return this.service.recover(id);
+  }
+    
+  @ApiBearerAuth("jwt")
+  @ApiQuery({ name: 'showSoftDeleted', required: false, enum: ShowSoftDeleted })
+  @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: 'groupBy', required: false, type: Array })
+  @ApiQuery({ name: 'populate', required: false, type: Array })
+  @ApiQuery({ name: 'populateMedia', required: false, type: Array })
+  @ApiQuery({ name: 'filters', required: false, type: Array })
+  @Get()
+  async findMany(@Query() query: any) { 
+    return this.service.find(query);  
+  }
+
+  @ApiBearerAuth("jwt")
+  @Get(':id')
+  async findOne(@Param('id') id: string, @Query() query: any) {
+    return this.service.findOne(+id, query);
+  }
+
+  @ApiBearerAuth("jwt")
+  @Delete('/bulk')
+  async deleteMany(@Body() ids: number[]) {
+    return this.service.deleteMany(ids);
+  }
+
+  @ApiBearerAuth("jwt")
+  @Delete(':id')
+  async delete(@Param('id') id: number) {
+    return this.service.delete(id);
+  }
+
+
+}

package/src/controllers/workflow-trigger-execution.controller.ts

@@ -0,0 +1,93 @@
+import { Controller, Post, Body, Param, UploadedFiles, UseInterceptors, Put, Get, Query, Delete, Patch } from '@nestjs/common';
+import { AnyFilesInterceptor } from "@nestjs/platform-express";
+import { ApiBearerAuth, ApiQuery, ApiTags } from '@nestjs/swagger';
+import { WorkflowTriggerExecutionService } from '../services/workflow-trigger-execution.service';
+import { CreateWorkflowTriggerExecutionDto } from '../dtos/create-workflow-trigger-execution.dto';
+import { UpdateWorkflowTriggerExecutionDto } from '../dtos/update-workflow-trigger-execution.dto';
+
+enum ShowSoftDeleted {
+  INCLUSIVE = "inclusive",
+  EXCLUSIVE = "exclusive",
+}
+
+@ApiTags('Solid Core')
+@Controller('workflow-trigger-execution')
+export class WorkflowTriggerExecutionController {
+  constructor(private readonly service: WorkflowTriggerExecutionService) {}
+
+  @ApiBearerAuth("jwt")
+  @Post()
+  @UseInterceptors(AnyFilesInterceptor())
+  create(@Body() createDto: CreateWorkflowTriggerExecutionDto, @UploadedFiles() files: Array<Express.Multer.File>) {
+    return this.service.create(createDto, files);
+  }
+
+  @ApiBearerAuth("jwt")
+  @Post('/bulk')
+  @UseInterceptors(AnyFilesInterceptor())
+  insertMany(@Body() createDtos: CreateWorkflowTriggerExecutionDto[], @UploadedFiles() filesArray: Express.Multer.File[][] = []) {
+    return this.service.insertMany(createDtos, filesArray);
+  }
+
+
+  @ApiBearerAuth("jwt")
+  @Put(':id')
+  @UseInterceptors(AnyFilesInterceptor())
+  update(@Param('id') id: number, @Body() updateDto: UpdateWorkflowTriggerExecutionDto, @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: UpdateWorkflowTriggerExecutionDto, @UploadedFiles() files: Array<Express.Multer.File>) {
+    return this.service.update(id, updateDto, files, true);
+  }
+
+  @ApiBearerAuth("jwt")
+  @Post('/bulk-recover')
+  async recoverMany(@Body() ids: number[]) {
+    return this.service.recoverMany(ids);
+  }
+
+  @ApiBearerAuth("jwt")
+  @Get('/recover/:id')
+  async recover(@Param('id') id: number) {
+    return this.service.recover(id);
+  }
+    
+  @ApiBearerAuth("jwt")
+  @ApiQuery({ name: 'showSoftDeleted', required: false, enum: ShowSoftDeleted })
+  @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: 'groupBy', required: false, type: Array })
+  @ApiQuery({ name: 'populate', required: false, type: Array })
+  @ApiQuery({ name: 'populateMedia', required: false, type: Array })
+  @ApiQuery({ name: 'filters', required: false, type: Array })
+  @Get()
+  async findMany(@Query() query: any) { 
+    return this.service.find(query);  
+  }
+
+  @ApiBearerAuth("jwt")
+  @Get(':id')
+  async findOne(@Param('id') id: string, @Query() query: any) {
+    return this.service.findOne(+id, query);
+  }
+
+  @ApiBearerAuth("jwt")
+  @Delete('/bulk')
+  async deleteMany(@Body() ids: number[]) {
+    return this.service.deleteMany(ids);
+  }
+
+  @ApiBearerAuth("jwt")
+  @Delete(':id')
+  async delete(@Param('id') id: number) {
+    return this.service.delete(id);
+  }
+
+
+}

package/src/decorators/workflow-field-data-provider.decorator.ts

@@ -0,0 +1,7 @@
+export const IS_WORKFLOW_FIELD_DATA_PROVIDER = 'IS_WORKFLOW_FIELD_DATA_PROVIDER';
+
+export const WorkflowFieldDataProvider = () => {
+    return (target: Function) => {
+        Reflect.defineMetadata(IS_WORKFLOW_FIELD_DATA_PROVIDER, true, target);
+    };
+};

package/src/decorators/workflow-node-provider.decorator.ts

@@ -0,0 +1,14 @@
+import { Injectable } from '@nestjs/common';
+import { WorkflowNodeProviderMetadata } from '../types/workflow-dsl.types';
+
+export const WORKFLOW_NODE_PROVIDER_METADATA =
+  'WORKFLOW_NODE_PROVIDER_METADATA';
+
+export const WorkflowNodeProvider = (
+  metadata: WorkflowNodeProviderMetadata,
+): ClassDecorator => {
+  return (target) => {
+    Injectable()(target as any);
+    Reflect.defineMetadata(WORKFLOW_NODE_PROVIDER_METADATA, metadata, target);
+  };
+};

package/src/dtos/create-workflow-definition.dto.ts

@@ -0,0 +1,60 @@
+import { ApiProperty } from '@nestjs/swagger';
+import { IsString } from 'class-validator';
+import { IsNotEmpty, IsInt, IsOptional, IsJSON } from 'class-validator';
+
+export class CreateWorkflowDefinitionDto {
+    @IsNotEmpty()
+    @IsString()
+    @ApiProperty({ description: "Stable workflow key used as the metadata identity and developer-facing workflow identifier." })
+    key: string;
+
+    @IsOptional()
+    @IsInt()
+    @ApiProperty({ description: "Owning SolidX module/package used for metadata persistence and distribution." })
+    moduleMetadataId: number;
+
+    @IsString()
+    @IsOptional()
+    @ApiProperty({ description: "Owning SolidX module/package used for metadata persistence and distribution." })
+    moduleMetadataUserKey: string;
+
+    @IsNotEmpty()
+    @IsString()
+    @ApiProperty({ description: "Human-facing workflow name shown in builder and execution screens." })
+    displayName: string;
+
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Optional dot-path grouping for workflows, such as ops.monitoring." })
+    namespace: string;
+
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Workflow description and operational notes." })
+    description: string;
+
+    @IsNotEmpty()
+    @IsString()
+    @ApiProperty({ description: "Workflow lifecycle status." })
+    status: string = "draft";
+
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Human-managed or seed-managed version string for the current workflow definition." })
+    definitionVersion: string;
+
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Checksum of the canonical definition YAML for change detection and execution traceability." })
+    definitionChecksum: string;
+
+    @IsNotEmpty()
+    @IsString()
+    @ApiProperty({ description: "Canonical workflow DSL YAML used for sharing, seeding, validation, and execution." })
+    definitionYaml: string;
+
+    @IsOptional()
+    @IsJSON()
+    @ApiProperty({ description: "Optional array of tags for categorizing and searching workflows." })
+    tags: any;
+}

package/src/dtos/create-workflow-execution-artifact.dto.ts

@@ -0,0 +1,99 @@
+import { ApiProperty } from '@nestjs/swagger';
+import { IsString } from 'class-validator';
+import { IsNotEmpty, IsInt, IsOptional, IsDate, IsJSON } from 'class-validator';
+
+export class CreateWorkflowExecutionArtifactDto {
+    @IsNotEmpty()
+    @IsString()
+    @ApiProperty({ description: "Stable unique key for this execution artifact." })
+    artifactKey: string;
+
+    @IsOptional()
+    @IsInt()
+    @ApiProperty({ description: "Workflow execution this artifact belongs to." })
+    workflowExecutionId: number;
+
+    @IsString()
+    @IsOptional()
+    @ApiProperty({ description: "Workflow execution this artifact belongs to." })
+    workflowExecutionUserKey: string;
+
+    @IsOptional()
+    @IsInt()
+    @ApiProperty({ description: "Optional step execution that produced this artifact." })
+    workflowStepExecutionId: number;
+
+    @IsString()
+    @IsOptional()
+    @ApiProperty({ description: "Optional step execution that produced this artifact." })
+    workflowStepExecutionUserKey: string;
+
+    @IsNotEmpty()
+    @IsString()
+    @ApiProperty({ description: "Human-readable artifact name." })
+    name: string;
+
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Optional artifact description." })
+    description: string;
+
+    @IsNotEmpty()
+    @IsString()
+    @ApiProperty({ description: "Artifact storage or payload category." })
+    artifactType: string = "payload";
+
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Workflow node id that produced this artifact, when applicable." })
+    nodeId: string;
+
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Registered node type that produced this artifact, when applicable." })
+    nodeType: string;
+
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Storage provider key when this artifact is stored outside the database." })
+    storageProviderKey: string;
+
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "External URI, storage path, or download URL for the artifact." })
+    uri: string;
+
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Original or generated file name for file artifacts." })
+    fileName: string;
+
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "MIME type for file or binary artifacts." })
+    mimeType: string;
+
+    @IsOptional()
+    @ApiProperty({ description: "Artifact size in bytes, when known." })
+    sizeBytes: bigint;
+
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Artifact checksum or content hash, when available." })
+    checksum: string;
+
+    @IsOptional()
+    @IsDate()
+    @ApiProperty({ description: "Timestamp when the artifact was produced." })
+    producedAt: Date;
+
+    @IsOptional()
+    @IsJSON()
+    @ApiProperty({ description: "Inline structured artifact payload for small DB-stored artifacts." })
+    payload: any;
+
+    @IsOptional()
+    @IsJSON()
+    @ApiProperty({ description: "Additional artifact metadata." })
+    metadata: any;
+}