@solidxai/core 0.1.12 → 0.1.13-beta.2

package/src/dtos/update-workflow-execution-log.dto.ts

@@ -0,0 +1,87 @@
+import { IsInt,IsOptional, IsString, IsNotEmpty, IsDate, IsJSON } from 'class-validator';
+import { ApiProperty } from '@nestjs/swagger';
+
+export class UpdateWorkflowExecutionLogDto {
+    @IsOptional()
+    @IsInt()
+    id: number;
+
+    @IsNotEmpty()
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Stable unique key for this workflow execution log entry." })
+    logKey: string;
+
+    @IsOptional()
+    @IsInt()
+    @ApiProperty({ description: "Workflow execution this log entry belongs to." })
+    workflowExecutionId: number;
+
+    @IsString()
+    @IsOptional()
+    @ApiProperty({ description: "Workflow execution this log entry belongs to." })
+    workflowExecutionUserKey: string;
+
+    @IsOptional()
+    @IsInt()
+    @ApiProperty({ description: "Optional step execution this log entry belongs to when the log is node-scoped." })
+    workflowStepExecutionId: number;
+
+    @IsString()
+    @IsOptional()
+    @ApiProperty({ description: "Optional step execution this log entry belongs to when the log is node-scoped." })
+    workflowStepExecutionUserKey: string;
+
+    @IsNotEmpty()
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Log severity level." })
+    level: string;
+
+    @IsNotEmpty()
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Human-readable log message." })
+    message: string;
+
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Structured event type such as execution.started, step.failed, or retry.scheduled." })
+    eventType: string;
+
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Source component or runtime subsystem that emitted the log entry." })
+    source: string;
+
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Workflow node id associated with this log entry, when applicable." })
+    nodeId: string;
+
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Registered node type associated with this log entry, when applicable." })
+    nodeType: string;
+
+    @IsOptional()
+    @IsInt()
+    @ApiProperty({ description: "Monotonic ordering number for log entries within the execution." })
+    sequenceNumber: number;
+
+    @IsNotEmpty()
+    @IsOptional()
+    @IsDate()
+    @ApiProperty({ description: "Timestamp when the log entry was emitted." })
+    occurredAt: Date;
+
+    @IsOptional()
+    @IsJSON()
+    @ApiProperty({ description: "Structured context for this log entry." })
+    context: any;
+
+    @IsOptional()
+    @IsJSON()
+    @ApiProperty({ description: "Additional metadata captured with this log entry." })
+    metadata: any;
+}

package/src/dtos/update-workflow-execution.dto.ts

@@ -0,0 +1,144 @@
+import { IsInt,IsOptional, IsString, IsNotEmpty, IsDate, IsJSON, ValidateNested, IsArray } from 'class-validator';
+import { ApiProperty } from '@nestjs/swagger';
+import { Type } from 'class-transformer';
+import { UpdateWorkflowStepExecutionDto } from 'src/dtos/update-workflow-step-execution.dto';
+import { UpdateWorkflowExecutionLogDto } from 'src/dtos/update-workflow-execution-log.dto';
+import { UpdateWorkflowExecutionArtifactDto } from 'src/dtos/update-workflow-execution-artifact.dto';
+
+export class UpdateWorkflowExecutionDto {
+    @IsOptional()
+    @IsInt()
+    id: number;
+
+    @IsNotEmpty()
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "System-generated readable execution identifier." })
+    executionIdentifier: string;
+
+    @IsOptional()
+    @IsInt()
+    @ApiProperty({ description: "Workflow definition used to create this execution." })
+    workflowDefinitionId: number;
+
+    @IsString()
+    @IsOptional()
+    @ApiProperty({ description: "Workflow definition used to create this execution." })
+    workflowDefinitionUserKey: string;
+
+    @IsNotEmpty()
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Snapshot of the workflow definition key for easier querying." })
+    workflowKey: string;
+
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Snapshot of the workflow display name at execution time." })
+    workflowDisplayName: string;
+
+    @IsNotEmpty()
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Current workflow execution status." })
+    status: string;
+
+    @IsNotEmpty()
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Mechanism that started this workflow execution." })
+    triggerType: string;
+
+    @IsOptional()
+    @IsDate()
+    @ApiProperty({ description: "Execution start timestamp." })
+    startedAt: Date;
+
+    @IsOptional()
+    @IsDate()
+    @ApiProperty({ description: "Execution finish timestamp." })
+    finishedAt: Date;
+
+    @IsOptional()
+    @ApiProperty({ description: "Execution duration in milliseconds." })
+    durationMs: bigint;
+
+    @IsOptional()
+    @IsJSON()
+    @ApiProperty({ description: "Runtime inputs supplied to the workflow execution." })
+    inputPayload: any;
+
+    @IsOptional()
+    @IsJSON()
+    @ApiProperty({ description: "Flow-level outputs produced by the workflow execution." })
+    outputPayload: any;
+
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Definition version used by this execution." })
+    definitionVersion: string;
+
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Definition checksum used by this execution." })
+    definitionChecksum: string;
+
+    @IsNotEmpty()
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Exact workflow YAML definition used for this execution." })
+    definitionSnapshot: string;
+
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Human-readable execution failure summary." })
+    errorSummary: string;
+
+    @IsOptional()
+    @IsJSON()
+    @ApiProperty({ description: "Structured execution error payload." })
+    errorDetails: any;
+
+    @IsOptional()
+    @ApiProperty({ description: "User or actor id that requested the execution, if available." })
+    requestedByUserId: bigint;
+
+    @IsArray()
+    @ValidateNested({ each : true })
+    @Type(() => UpdateWorkflowStepExecutionDto)
+    @IsOptional()
+    workflowStepExecutions: UpdateWorkflowStepExecutionDto[];
+
+    @IsOptional()
+    @IsArray()
+    workflowStepExecutionIds: number[];
+
+    @IsOptional()
+    workflowStepExecutionCommand: string;
+
+    @IsArray()
+    @ValidateNested({ each : true })
+    @Type(() => UpdateWorkflowExecutionLogDto)
+    @IsOptional()
+    workflowExecutionLogs: UpdateWorkflowExecutionLogDto[];
+
+    @IsOptional()
+    @IsArray()
+    workflowExecutionLogIds: number[];
+
+    @IsOptional()
+    workflowExecutionLogCommand: string;
+
+    @IsArray()
+    @ValidateNested({ each : true })
+    @Type(() => UpdateWorkflowExecutionArtifactDto)
+    @IsOptional()
+    workflowExecutionArtifacts: UpdateWorkflowExecutionArtifactDto[];
+
+    @IsOptional()
+    @IsArray()
+    workflowExecutionArtifactIds: number[];
+
+    @IsOptional()
+    workflowExecutionArtifactCommand: string;
+}

package/src/dtos/update-workflow-secret.dto.ts

@@ -0,0 +1,53 @@
+import { ApiProperty } from '@nestjs/swagger';
+import { IsInt, IsOptional, IsString, IsNotEmpty, IsDate } from 'class-validator';
+
+export class UpdateWorkflowSecretDto {
+    @IsOptional()
+    @IsInt()
+    id: number;
+
+    @IsNotEmpty()
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Global secret key used in workflow expressions, for example smtp.password." })
+    key: string;
+
+    @IsNotEmpty()
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Human-facing secret name shown in the admin UI." })
+    displayName: string;
+
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Operational notes describing where this secret is used." })
+    description: string;
+
+    @IsNotEmpty()
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Plain value supplied by an admin. It is encrypted before storage." })
+    value: string;
+
+    @IsNotEmpty()
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "How the decrypted value should be coerced for workflow runtime usage." })
+    valueType: string;
+
+    @IsNotEmpty()
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Secret lifecycle status." })
+    status: string;
+
+    @IsOptional()
+    @IsDate()
+    @ApiProperty({ description: "When this secret was last rotated." })
+    lastRotatedAt: Date;
+
+    @IsOptional()
+    @IsDate()
+    @ApiProperty({ description: "When this secret was last resolved by workflow runtime." })
+    lastAccessedAt: Date;
+}

package/src/dtos/update-workflow-step-execution.dto.ts

@@ -0,0 +1,132 @@
+import { IsInt,IsOptional, IsString, IsNotEmpty, IsDate, IsJSON } from 'class-validator';
+import { ApiProperty } from '@nestjs/swagger';
+
+export class UpdateWorkflowStepExecutionDto {
+    @IsOptional()
+    @IsInt()
+    id: number;
+
+    @IsNotEmpty()
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Stable unique key for this step execution, assigned by the runtime." })
+    stepExecutionKey: string;
+
+    @IsOptional()
+    @IsInt()
+    @ApiProperty({ description: "Parent workflow execution this step belongs to." })
+    workflowExecutionId: number;
+
+    @IsString()
+    @IsOptional()
+    @ApiProperty({ description: "Parent workflow execution this step belongs to." })
+    workflowExecutionUserKey: string;
+
+    @IsNotEmpty()
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Node id from the workflow definition DSL." })
+    nodeId: string;
+
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Human-readable node name captured at execution time." })
+    nodeName: string;
+
+    @IsNotEmpty()
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Broad node category." })
+    nodeKind: string;
+
+    @IsNotEmpty()
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Registered node type id such as log.write, http.request, if, forEach, or parallel." })
+    nodeType: string;
+
+    @IsNotEmpty()
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Current step execution status." })
+    status: string;
+
+    @IsNotEmpty()
+    @IsOptional()
+    @IsInt()
+    @ApiProperty({ description: "Current attempt number for this step execution." })
+    attemptNumber: number;
+
+    @IsOptional()
+    @IsInt()
+    @ApiProperty({ description: "Number of retries attempted for this step." })
+    retryCount: number;
+
+    @IsOptional()
+    @IsInt()
+    @ApiProperty({ description: "Maximum retry count resolved for this step." })
+    maxRetries: number;
+
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Parent control or subflow node id when this step is nested." })
+    parentNodeId: string;
+
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Parent step execution key for nested runtime structures." })
+    parentStepExecutionKey: string;
+
+    @IsOptional()
+    @IsInt()
+    @ApiProperty({ description: "Traversal or scheduling sequence number within the workflow execution." })
+    sequenceNumber: number;
+
+    @IsOptional()
+    @IsDate()
+    @ApiProperty({ description: "Step start timestamp." })
+    startedAt: Date;
+
+    @IsOptional()
+    @IsDate()
+    @ApiProperty({ description: "Step finish timestamp." })
+    finishedAt: Date;
+
+    @IsOptional()
+    @ApiProperty({ description: "Step duration in milliseconds." })
+    durationMs: bigint;
+
+    @IsOptional()
+    @ApiProperty({ description: "Timeout resolved for this step in milliseconds." })
+    timeoutMs: bigint;
+
+    @IsOptional()
+    @IsJSON()
+    @ApiProperty({ description: "Input payload resolved for this step execution." })
+    inputPayload: any;
+
+    @IsOptional()
+    @IsJSON()
+    @ApiProperty({ description: "Output payload produced by this step execution." })
+    outputPayload: any;
+
+    @IsOptional()
+    @IsJSON()
+    @ApiProperty({ description: "Scoped runtime context used while executing this step." })
+    runtimeContext: any;
+
+    @IsOptional()
+    @IsJSON()
+    @ApiProperty({ description: "Snapshot of the workflow node definition used for this step execution." })
+    nodeSnapshot: any;
+
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Short human-readable error summary for failed steps." })
+    errorSummary: string;
+
+    @IsOptional()
+    @IsJSON()
+    @ApiProperty({ description: "Structured error details captured for failed steps." })
+    errorDetails: any;
+}

package/src/dtos/update-workflow-trigger-execution.dto.ts

@@ -0,0 +1,122 @@
+import { IsInt,IsOptional, IsString, IsNotEmpty, IsBoolean, IsDate, IsJSON } from 'class-validator';
+import { ApiProperty } from '@nestjs/swagger';
+
+export class UpdateWorkflowTriggerExecutionDto {
+    @IsOptional()
+    @IsInt()
+    id: number;
+
+    @IsNotEmpty()
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Stable unique key for this trigger execution attempt." })
+    triggerExecutionKey: string;
+
+    @IsOptional()
+    @IsInt()
+    @ApiProperty({ description: "Workflow definition whose trigger fired or was evaluated." })
+    workflowDefinitionId: number;
+
+    @IsString()
+    @IsOptional()
+    @ApiProperty({ description: "Workflow definition whose trigger fired or was evaluated." })
+    workflowDefinitionUserKey: string;
+
+    @IsOptional()
+    @IsInt()
+    @ApiProperty({ description: "Workflow execution created by this trigger, when a run was started." })
+    workflowExecutionId: number;
+
+    @IsString()
+    @IsOptional()
+    @ApiProperty({ description: "Workflow execution created by this trigger, when a run was started." })
+    workflowExecutionUserKey: string;
+
+    @IsNotEmpty()
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Trigger id from the workflow definition DSL." })
+    triggerId: string;
+
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Human-readable trigger name captured at execution time." })
+    triggerName: string;
+
+    @IsNotEmpty()
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Registered trigger type id or broad trigger category." })
+    triggerType: string;
+
+    @IsNotEmpty()
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Current trigger execution status." })
+    status: string;
+
+    @IsOptional()
+    @IsBoolean()
+    @ApiProperty({ description: "Whether this trigger evaluation matched and should start a workflow execution." })
+    matched: boolean;
+
+    @IsNotEmpty()
+    @IsOptional()
+    @IsDate()
+    @ApiProperty({ description: "Timestamp when the trigger fired or was received." })
+    firedAt: Date;
+
+    @IsOptional()
+    @IsDate()
+    @ApiProperty({ description: "Timestamp when trigger processing started." })
+    startedAt: Date;
+
+    @IsOptional()
+    @IsDate()
+    @ApiProperty({ description: "Timestamp when trigger processing finished." })
+    finishedAt: Date;
+
+    @IsOptional()
+    @ApiProperty({ description: "Trigger processing duration in milliseconds." })
+    durationMs: bigint;
+
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Source system, scheduler, webhook endpoint, or event bus that produced the trigger." })
+    source: string;
+
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "External correlation id for linking trigger attempts to upstream events." })
+    correlationId: string;
+
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Optional idempotency key used to prevent duplicate trigger handling." })
+    idempotencyKey: string;
+
+    @IsOptional()
+    @IsJSON()
+    @ApiProperty({ description: "Trigger payload, request body, schedule context, or event data." })
+    payload: any;
+
+    @IsOptional()
+    @IsJSON()
+    @ApiProperty({ description: "Snapshot of the trigger definition used for this trigger execution." })
+    triggerSnapshot: any;
+
+    @IsOptional()
+    @IsString()
+    @ApiProperty({ description: "Short human-readable error summary for failed trigger executions." })
+    errorSummary: string;
+
+    @IsOptional()
+    @IsJSON()
+    @ApiProperty({ description: "Structured error details captured for failed trigger executions." })
+    errorDetails: any;
+
+    @IsOptional()
+    @IsJSON()
+    @ApiProperty({ description: "Additional trigger execution metadata." })
+    metadata: any;
+}

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

@@ -0,0 +1,3 @@
+export class ValidateWorkflowDefinitionDto {
+  definitionYaml!: string;
+}

package/src/entities/saved-filters.entity.ts

@@ -18,17 +18,17 @@ export class SavedFilters extends CommonEntity {
     isPrivate: boolean = false;
 
     @Index()
-    @ManyToOne(() => User, { nullable: true })
+    @ManyToOne(() => User, { onDelete: "CASCADE", nullable: true })
     @JoinColumn()
     user: User;
 
     @Index()
-    @ManyToOne(() => ModelMetadata, { nullable: false })
+    @ManyToOne(() => ModelMetadata, { onDelete: "CASCADE", nullable: false })
     @JoinColumn()
     model: ModelMetadata;
 
     @Index()
-    @ManyToOne(() => ViewMetadata, { nullable: false })
+    @ManyToOne(() => ViewMetadata, { onDelete: "CASCADE", nullable: false })
     @JoinColumn()
     view: ViewMetadata;
 

package/src/entities/workflow-definition.entity.ts

@@ -0,0 +1,43 @@
+import { CommonEntity } from 'src/entities/common.entity';
+import { ModuleMetadata } from 'src/entities/module-metadata.entity';
+import { Entity, Column, Index, JoinColumn, ManyToOne } from 'typeorm';
+
+@Entity('ss_workflow_definition')
+export class WorkflowDefinition extends CommonEntity {
+    @Index({ unique: true })
+    @Column({ type: "varchar" })
+    key: string;
+
+    @Index()
+    @ManyToOne(() => ModuleMetadata, { onDelete: "CASCADE", nullable: false })
+    @JoinColumn()
+    moduleMetadata: ModuleMetadata;
+
+    @Index()
+    @Column({ type: "varchar" })
+    displayName: string;
+
+    @Index()
+    @Column({ type: "varchar", nullable: true })
+    namespace: string;
+
+    @Column({ type: "text", nullable: true })
+    description: string;
+
+    @Index()
+    @Column({ type: "varchar", default: "draft" })
+    status: string = "draft";
+
+    @Column({ type: "varchar", nullable: true })
+    definitionVersion: string;
+
+    @Index()
+    @Column({ type: "varchar", nullable: true })
+    definitionChecksum: string;
+
+    @Column({ name: "definition_yaml", type: "text", nullable: true})
+    definitionYaml: string;
+
+    @Column({ type: "simple-json", nullable: true })
+    tags: any;
+}

package/src/entities/workflow-execution-artifact.entity.ts

@@ -0,0 +1,72 @@
+import { CommonEntity } from 'src/entities/common.entity';
+import { Entity, Column, Index, JoinColumn, ManyToOne } from 'typeorm';
+import { WorkflowExecution } from './workflow-execution.entity';
+import { WorkflowStepExecution } from './workflow-step-execution.entity'
+
+@Entity('ss_workflow_execution_artifact')
+export class WorkflowExecutionArtifact extends CommonEntity {
+    @Index({ unique: true })
+    @Column({ type: "varchar" })
+    artifactKey: string;
+
+    @Index()
+    @ManyToOne(() => WorkflowExecution, { onDelete: "CASCADE", nullable: false })
+    @JoinColumn()
+    workflowExecution: WorkflowExecution;
+
+    @Index()
+    @ManyToOne(() => WorkflowStepExecution, { onDelete: "CASCADE", nullable: true })
+    @JoinColumn()
+    workflowStepExecution: WorkflowStepExecution;
+
+    @Index()
+    @Column({ type: "varchar" })
+    name: string;
+
+    @Column({ type: "text", nullable: true })
+    description: string;
+
+    @Index()
+    @Column({ type: "varchar", default: "payload" })
+    artifactType: string = "payload";
+
+    @Index()
+    @Column({ type: "varchar", nullable: true })
+    nodeId: string;
+
+    @Index()
+    @Column({ type: "varchar", nullable: true })
+    nodeType: string;
+
+    @Index()
+    @Column({ type: "varchar", nullable: true })
+    storageProviderKey: string;
+
+    @Column({ type: "text", nullable: true })
+    uri: string;
+
+    @Index()
+    @Column({ type: "varchar", nullable: true })
+    fileName: string;
+
+    @Index()
+    @Column({ type: "varchar", nullable: true })
+    mimeType: string;
+
+    @Column({ type: "bigint", nullable: true })
+    sizeBytes: bigint;
+
+    @Index()
+    @Column({ type: "varchar", nullable: true })
+    checksum: string;
+
+    @Index()
+    @Column({ type: "timestamp", nullable: true })
+    producedAt: Date;
+
+    @Column({ type: "simple-json", nullable: true })
+    payload: any;
+
+    @Column({ type: "simple-json", nullable: true })
+    metadata: any;
+}