- add FileEntity, ScenarioFileEntity, ScenarioRunFileEntity with UUID-sharded disk tree - FileStorageService: write/sha256/expiry, paginated listing, dynamic cleanup cron via SchedulerRegistry - expose getScenarioFiles() and downloadFile() on ScriptContext for use in exec code - wire scenarioId, runId, fileService into ExecContextBuilder and scenario scheduler - add file upload and listing endpoints to ScenarioController - add FILES_DIR, FILE_RUN_EXPIRATION_DAYS, FILE_CLEANUP_CRON to AppConfig
352 lines
12 KiB
TypeScript
352 lines
12 KiB
TypeScript
import {
|
|
Body,
|
|
Controller,
|
|
Delete,
|
|
Get,
|
|
HttpCode,
|
|
Param,
|
|
ParseUUIDPipe,
|
|
Patch,
|
|
Post,
|
|
Query,
|
|
Res,
|
|
UseInterceptors,
|
|
UploadedFile,
|
|
} from "@nestjs/common";
|
|
import { FileInterceptor } from "@nestjs/platform-express";
|
|
import { ApiOperation, ApiResponse, ApiTags } from "@nestjs/swagger";
|
|
import { Response } from "express";
|
|
import type { File as MulterFile } from "multer";
|
|
import { stringify as yamlStringify } from "yaml";
|
|
import { AddScenarioCredentialDto } from "./dto/add-scenario-credential.dto";
|
|
import { CreateScenarioRunDto } from "./dto/create-scenario-run.dto";
|
|
import { CreateScenarioStepDto } from "./dto/create-scenario-step.dto";
|
|
import { CreateScenarioDto } from "./dto/create-scenario.dto";
|
|
import { ScenarioQueryDto } from "./dto/pagination-query.dto";
|
|
import { RunsQueryDto } from "./dto/runs-query.dto";
|
|
import { ExportEntity } from "./dto/scenario-export.dto";
|
|
import { UpdateScenarioStepDto } from "./dto/update-scenario-step.dto";
|
|
import { UpdateScenarioDto } from "./dto/update-scenario.dto";
|
|
import { ScenarioService } from "./scenario.service";
|
|
|
|
@ApiTags("scenarios")
|
|
@Controller("scenarios")
|
|
export class ScenarioController {
|
|
constructor(private readonly scenarioService: ScenarioService) {}
|
|
|
|
// ── Scenarios ─────────────────────────────────────────────────────────────
|
|
|
|
@Post()
|
|
@ApiOperation({ summary: "Create a scenario" })
|
|
@ApiResponse({ status: 201, description: "Scenario created" })
|
|
create(@Body() dto: CreateScenarioDto) {
|
|
return this.scenarioService.create(dto);
|
|
}
|
|
|
|
@Post("import")
|
|
@ApiOperation({ summary: "Import a scenario from an export payload (single object or array)" })
|
|
@ApiResponse({ status: 201, description: "Scenario imported" })
|
|
importScenario(@Body() payload: unknown) {
|
|
return this.scenarioService.importScenario(payload as any);
|
|
}
|
|
|
|
@Get()
|
|
@ApiOperation({ summary: "List all scenarios (paginated)" })
|
|
@ApiResponse({ status: 200 })
|
|
findAll(@Query() query: ScenarioQueryDto) {
|
|
return this.scenarioService.findAll(query);
|
|
}
|
|
|
|
@Get("runs")
|
|
@ApiOperation({
|
|
summary: "List runs across all scenarios (paginated, filterable by status)",
|
|
})
|
|
@ApiResponse({ status: 200 })
|
|
findAllRuns(@Query() query: RunsQueryDto) {
|
|
return this.scenarioService.findAllRuns(query);
|
|
}
|
|
|
|
@Get(":id")
|
|
@ApiOperation({ summary: "Get a scenario with its steps" })
|
|
@ApiResponse({ status: 200 })
|
|
@ApiResponse({ status: 404, description: "Scenario not found" })
|
|
findOne(@Param("id", ParseUUIDPipe) id: string) {
|
|
return this.scenarioService.findOne(id);
|
|
}
|
|
|
|
@Patch(":id")
|
|
@ApiOperation({ summary: "Update a scenario" })
|
|
@ApiResponse({ status: 200 })
|
|
@ApiResponse({ status: 404, description: "Scenario not found" })
|
|
update(
|
|
@Param("id", ParseUUIDPipe) id: string,
|
|
@Body() dto: UpdateScenarioDto,
|
|
) {
|
|
return this.scenarioService.update(id, dto);
|
|
}
|
|
|
|
@Delete(":id")
|
|
@HttpCode(204)
|
|
@ApiOperation({ summary: "Delete a scenario and all its steps" })
|
|
@ApiResponse({ status: 204 })
|
|
@ApiResponse({ status: 404, description: "Scenario not found" })
|
|
remove(@Param("id", ParseUUIDPipe) id: string) {
|
|
return this.scenarioService.remove(id);
|
|
}
|
|
|
|
@Get(":id/export")
|
|
@ApiOperation({ summary: "Export a scenario as portable YAML" })
|
|
@ApiResponse({ status: 200 })
|
|
@ApiResponse({ status: 404, description: "Scenario not found" })
|
|
async exportScenario(
|
|
@Param("id", ParseUUIDPipe) id: string,
|
|
@Query("includeEnvironment") includeEnvironment: string,
|
|
@Query("credentialIds") credentialIds: string | string[] | undefined,
|
|
@Res({ passthrough: true }) res: Response,
|
|
) {
|
|
const credIds: string[] = credentialIds
|
|
? Array.isArray(credentialIds)
|
|
? credentialIds
|
|
: credentialIds.split(",").filter(Boolean)
|
|
: [];
|
|
const entities = await this.scenarioService.exportScenario(id, {
|
|
includeEnvironment: includeEnvironment === "true",
|
|
credentialIds: credIds,
|
|
});
|
|
res.setHeader("Content-Type", "application/yaml; charset=utf-8");
|
|
// Serialize as YAML stream: each entity separated by a comment header
|
|
const kindLabels: Record<string, string> = {
|
|
environment: "Environment",
|
|
credential: "Credential",
|
|
scenario: "Scenario",
|
|
};
|
|
const parts = (entities as ExportEntity[]).map((entity) => {
|
|
const label = kindLabels[entity.kind ?? ""] ?? entity.kind ?? "Entity";
|
|
const comment = `# --- ${label}: ${
|
|
(entity as any).name ?? (entity as any).id ?? ""
|
|
} ---`;
|
|
return `${comment}\n${yamlStringify(entity)}`;
|
|
});
|
|
return parts.join("\n");
|
|
}
|
|
|
|
// ── Steps ─────────────────────────────────────────────────────────────────
|
|
|
|
@Post(":id/steps")
|
|
@ApiOperation({ summary: "Add a step to a scenario" })
|
|
@ApiResponse({ status: 201, description: "Step created" })
|
|
@ApiResponse({ status: 404, description: "Scenario not found" })
|
|
createStep(
|
|
@Param("id", ParseUUIDPipe) id: string,
|
|
@Body() dto: CreateScenarioStepDto,
|
|
) {
|
|
return this.scenarioService.createStep(id, dto);
|
|
}
|
|
|
|
@Get(":id/steps/:stepId")
|
|
@ApiOperation({ summary: "Get a single step" })
|
|
@ApiResponse({ status: 200 })
|
|
@ApiResponse({ status: 404, description: "Scenario or step not found" })
|
|
findStep(
|
|
@Param("id", ParseUUIDPipe) id: string,
|
|
@Param("stepId", ParseUUIDPipe) stepId: string,
|
|
) {
|
|
return this.scenarioService.findStep(id, stepId);
|
|
}
|
|
|
|
@Patch(":id/steps/:stepId")
|
|
@ApiOperation({ summary: "Update a step" })
|
|
@ApiResponse({ status: 200 })
|
|
@ApiResponse({ status: 404, description: "Scenario or step not found" })
|
|
updateStep(
|
|
@Param("id", ParseUUIDPipe) id: string,
|
|
@Param("stepId", ParseUUIDPipe) stepId: string,
|
|
@Body() dto: UpdateScenarioStepDto,
|
|
) {
|
|
return this.scenarioService.updateStep(id, stepId, dto);
|
|
}
|
|
|
|
@Delete(":id/steps/:stepId")
|
|
@HttpCode(204)
|
|
@ApiOperation({ summary: "Delete a step" })
|
|
@ApiResponse({ status: 204 })
|
|
@ApiResponse({ status: 404, description: "Scenario or step not found" })
|
|
removeStep(
|
|
@Param("id", ParseUUIDPipe) id: string,
|
|
@Param("stepId", ParseUUIDPipe) stepId: string,
|
|
) {
|
|
return this.scenarioService.removeStep(id, stepId);
|
|
}
|
|
|
|
// ── Credentials ───────────────────────────────────────────────────────────
|
|
|
|
@Get(":id/credentials")
|
|
@ApiOperation({ summary: "List credentials assigned to a scenario" })
|
|
@ApiResponse({ status: 200 })
|
|
@ApiResponse({ status: 404, description: "Scenario not found" })
|
|
findScenarioCredentials(@Param("id", ParseUUIDPipe) id: string) {
|
|
return this.scenarioService.findScenarioCredentials(id);
|
|
}
|
|
|
|
@Post(":id/credentials")
|
|
@ApiOperation({ summary: "Add a credential to a scenario with an alias" })
|
|
@ApiResponse({ status: 201, description: "Credential added" })
|
|
@ApiResponse({ status: 404, description: "Scenario or credential not found" })
|
|
@ApiResponse({
|
|
status: 409,
|
|
description: "Alias already used in this scenario",
|
|
})
|
|
addScenarioCredential(
|
|
@Param("id", ParseUUIDPipe) id: string,
|
|
@Body() dto: AddScenarioCredentialDto,
|
|
) {
|
|
return this.scenarioService.addScenarioCredential(id, dto);
|
|
}
|
|
|
|
@Delete(":id/credentials/:scCredId")
|
|
@HttpCode(204)
|
|
@ApiOperation({ summary: "Remove a credential from a scenario" })
|
|
@ApiResponse({ status: 204 })
|
|
@ApiResponse({
|
|
status: 404,
|
|
description: "Scenario or credential assignment not found",
|
|
})
|
|
removeScenarioCredential(
|
|
@Param("id", ParseUUIDPipe) id: string,
|
|
@Param("scCredId", ParseUUIDPipe) scCredId: string,
|
|
) {
|
|
return this.scenarioService.removeScenarioCredential(id, scCredId);
|
|
}
|
|
|
|
// ── Runs ──────────────────────────────────────────────────────────────────
|
|
|
|
@Get(":id/runs")
|
|
@ApiOperation({
|
|
summary: "List runs for a scenario (paginated, filterable by status)",
|
|
})
|
|
@ApiResponse({ status: 200 })
|
|
@ApiResponse({ status: 404, description: "Scenario not found" })
|
|
findRuns(
|
|
@Param("id", ParseUUIDPipe) id: string,
|
|
@Query() query: RunsQueryDto,
|
|
) {
|
|
return this.scenarioService.findRuns(id, query);
|
|
}
|
|
|
|
@Post(":id/run")
|
|
@ApiOperation({ summary: "Create a new run for a scenario" })
|
|
@ApiResponse({ status: 201, description: "Run created with step runs" })
|
|
@ApiResponse({ status: 404, description: "Scenario not found" })
|
|
createRun(
|
|
@Param("id", ParseUUIDPipe) id: string,
|
|
@Body() dto: CreateScenarioRunDto,
|
|
) {
|
|
return this.scenarioService.createRun(
|
|
id,
|
|
dto.environmentId,
|
|
dto.saveSession,
|
|
);
|
|
}
|
|
|
|
@Get(":id/run/:runId")
|
|
@ApiOperation({ summary: "Get a specific run with step runs and logs" })
|
|
@ApiResponse({ status: 200 })
|
|
@ApiResponse({ status: 404, description: "Scenario or run not found" })
|
|
findRun(
|
|
@Param("id", ParseUUIDPipe) id: string,
|
|
@Param("runId", ParseUUIDPipe) runId: string,
|
|
@Query("q") q?: string,
|
|
) {
|
|
return this.scenarioService.findRun(id, runId, q);
|
|
}
|
|
|
|
@Post(":id/run/:runId/wait")
|
|
@HttpCode(200)
|
|
@ApiOperation({
|
|
summary:
|
|
"Block until the run reaches pass or fail (max 5 min), then return run with logs",
|
|
})
|
|
@ApiResponse({ status: 200 })
|
|
@ApiResponse({ status: 404, description: "Scenario or run not found" })
|
|
waitForRun(
|
|
@Param("id", ParseUUIDPipe) id: string,
|
|
@Param("runId", ParseUUIDPipe) runId: string,
|
|
) {
|
|
return this.scenarioService.waitForRun(id, runId);
|
|
}
|
|
|
|
// ── Files ─────────────────────────────────────────────────────────────────
|
|
|
|
@Post(":id/files")
|
|
@UseInterceptors(FileInterceptor("file"))
|
|
@ApiOperation({ summary: "Upload a file to a scenario" })
|
|
@ApiResponse({ status: 201, description: "File uploaded" })
|
|
@ApiResponse({ status: 404, description: "Scenario not found" })
|
|
uploadFile(
|
|
@Param("id", ParseUUIDPipe) id: string,
|
|
@UploadedFile() file: MulterFile,
|
|
@Body() body: { expiresAt?: string },
|
|
) {
|
|
return this.scenarioService.uploadFile(id, file, body.expiresAt);
|
|
}
|
|
|
|
@Get(":id/files")
|
|
@ApiOperation({ summary: "List files attached to a scenario" })
|
|
@ApiResponse({ status: 200 })
|
|
@ApiResponse({ status: 404, description: "Scenario not found" })
|
|
listScenarioFiles(
|
|
@Param("id", ParseUUIDPipe) id: string,
|
|
@Query("limit") limit?: string,
|
|
@Query("offset") offset?: string,
|
|
) {
|
|
return this.scenarioService.listScenarioFiles(
|
|
id,
|
|
limit ? parseInt(limit, 10) : undefined,
|
|
offset ? parseInt(offset, 10) : undefined,
|
|
);
|
|
}
|
|
|
|
@Get(":id/files/:fileId/content")
|
|
@ApiOperation({ summary: "Download file content" })
|
|
@ApiResponse({ status: 200, description: "File content" })
|
|
@ApiResponse({ status: 404, description: "Scenario or file not found" })
|
|
async getScenarioFileContent(
|
|
@Param("id", ParseUUIDPipe) id: string,
|
|
@Param("fileId", ParseUUIDPipe) fileId: string,
|
|
@Res() res: Response,
|
|
) {
|
|
return this.scenarioService.getScenarioFileContent(id, fileId, res);
|
|
}
|
|
|
|
@Get(":id/runs/:runId/files")
|
|
@ApiOperation({ summary: "List files created during a run" })
|
|
@ApiResponse({ status: 200 })
|
|
@ApiResponse({ status: 404, description: "Scenario or run not found" })
|
|
listRunFiles(
|
|
@Param("id", ParseUUIDPipe) id: string,
|
|
@Param("runId", ParseUUIDPipe) runId: string,
|
|
@Query("limit") limit?: string,
|
|
@Query("offset") offset?: string,
|
|
) {
|
|
return this.scenarioService.listRunFiles(
|
|
id,
|
|
runId,
|
|
limit ? parseInt(limit, 10) : undefined,
|
|
offset ? parseInt(offset, 10) : undefined,
|
|
);
|
|
}
|
|
|
|
@Get(":id/runs/:runId/files/:fileId/content")
|
|
@ApiOperation({ summary: "Download run artifact file content" })
|
|
@ApiResponse({ status: 200, description: "File content" })
|
|
@ApiResponse({ status: 404, description: "Scenario, run, or file not found" })
|
|
async getRunFileContent(
|
|
@Param("id", ParseUUIDPipe) id: string,
|
|
@Param("runId", ParseUUIDPipe) runId: string,
|
|
@Param("fileId", ParseUUIDPipe) fileId: string,
|
|
@Res() res: Response,
|
|
) {
|
|
return this.scenarioService.getRunFileContent(id, runId, fileId, res);
|
|
}
|
|
}
|