feat(openapi): complete upload preview and UI evidence

This commit is contained in:
2026-08-28 15:38:14 +03:00
parent d2849ea3fe
commit 2c94af6791
35 changed files with 3655 additions and 537 deletions
+6 -1
View File
@@ -4,6 +4,7 @@ use axum::{
middleware,
routing::{delete, get, post},
};
use crank_artifacts::MAX_ARTIFACT_BYTES;
use crate::{
auth::{
@@ -48,7 +49,11 @@ use crate::{
pub fn build_app(state: AppState) -> Router {
let workspace_router = Router::new()
.route("/operations", get(list_operations).post(create_operation))
.route("/imports/openapi/preview", post(preview_openapi_import))
.route(
"/imports/openapi/preview",
post(preview_openapi_import)
.layer(DefaultBodyLimit::max(MAX_ARTIFACT_BYTES + 32 * 1024)),
)
.route(
"/imports/openapi/{job_id}/create",
post(create_openapi_import),
+11 -3
View File
@@ -524,9 +524,17 @@ pub struct LegacyYamlOperationDocument {
pub operation: RegistryOperation,
}
#[derive(Clone, Debug, Deserialize)]
pub struct OpenApiImportPreviewPayload {
pub document: String,
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub enum OpenApiUploadLocale {
En,
Ru,
}
#[derive(Clone, Debug)]
pub struct OpenApiUpload {
pub bytes: Vec<u8>,
pub mime_type: String,
pub locale: OpenApiUploadLocale,
}
#[derive(Clone, Debug, Serialize)]
+109 -4
View File
@@ -11,6 +11,7 @@ use serde_json::{Value, json};
use thiserror::Error;
use tracing::{error, warn};
use crate::dto::OpenApiUploadLocale;
use crate::storage::StorageError;
#[derive(Debug, Error)]
@@ -96,6 +97,112 @@ impl ApiError {
}
}
pub(crate) fn openapi_upload(locale: OpenApiUploadLocale, code: &'static str) -> Self {
let russian = locale == OpenApiUploadLocale::Ru;
let message = match (russian, code) {
(_, "file_too_large") => {
if russian {
"файл OpenAPI превышает лимит 256 КиБ"
} else {
"OpenAPI file exceeds the 256 KiB limit"
}
}
(_, "empty_file") => {
if russian {
"файл OpenAPI не должен быть пустым"
} else {
"OpenAPI file must not be empty"
}
}
(_, "invalid_utf8") => {
if russian {
"файл OpenAPI должен быть в UTF-8"
} else {
"OpenAPI file must be UTF-8"
}
}
(_, "invalid_media_type") => {
if russian {
"тип файла OpenAPI не поддерживается"
} else {
"OpenAPI file type is not supported"
}
}
(_, "invalid_document") => {
if russian {
"некорректный или неподдерживаемый документ OpenAPI"
} else {
"OpenAPI document is invalid or unsupported"
}
}
(_, "no_methods") => {
if russian {
"документ OpenAPI не содержит поддерживаемых методов"
} else {
"OpenAPI document contains no supported methods"
}
}
(_, "source_integrity") => {
if russian {
"проверка целостности источника OpenAPI не пройдена"
} else {
"OpenAPI source integrity verification failed"
}
}
(_, "source_unavailable") => {
if russian {
"источник OpenAPI недоступен"
} else {
"OpenAPI source is unavailable"
}
}
(_, "parser_unavailable") | (_, "storage_unavailable") => {
if russian {
"обработка OpenAPI временно недоступна"
} else {
"OpenAPI processing is temporarily unavailable"
}
}
_ => {
if russian {
"некорректная multipart-загрузка OpenAPI"
} else {
"invalid OpenAPI multipart upload"
}
}
};
let context = json!({ "error_code": format!("openapi_upload.{code}") });
if code == "file_too_large" {
Self::PayloadTooLarge {
message: message.to_owned(),
context: Some(context),
}
} else if matches!(code, "storage_unavailable" | "parser_unavailable") {
Self::Internal {
message: message.to_owned(),
context: Some(context),
}
} else if matches!(code, "source_integrity" | "source_unavailable") {
Self::Unprocessable {
message: message.to_owned(),
context: Some(context),
}
} else {
Self::Validation {
message: message.to_owned(),
context: Some(context),
}
}
}
pub(crate) fn source_unavailable() -> Self {
Self::openapi_upload(OpenApiUploadLocale::En, "source_unavailable")
}
pub(crate) fn source_integrity() -> Self {
Self::openapi_upload(OpenApiUploadLocale::En, "source_integrity")
}
pub(crate) fn rate_limited_with_context(message: impl Into<String>, context: Value) -> Self {
Self::RateLimited {
message: message.into(),
@@ -588,17 +695,15 @@ impl From<RegistryError> for ApiError {
format!("import job {job_id} was already applied with different parameters"),
json!({ "job_id": job_id }),
),
RegistryError::SourceNotFound { source_id } => Self::not_found_with_context(
RegistryError::SourceNotFound { .. } => Self::not_found_with_context(
"artifact source was not found",
json!({
"source_id": source_id,
"error_code": "artifact_source_not_found"
}),
),
RegistryError::SourceConflict { source_id } => Self::conflict_with_context(
RegistryError::SourceConflict { .. } => Self::conflict_with_context(
"artifact source metadata or lifecycle conflicts with the request",
json!({
"source_id": source_id,
"error_code": "artifact_source_conflict",
"recovery": "reload"
}),
+2
View File
@@ -204,6 +204,7 @@ async fn run(
verified_startup_secret_crypto(&registry, config.runtime.master_key.expose_secret())
.await?;
let artifact_store = open_reconciliation_store(config.storage_root.clone()).await?;
registry.delete_expired_import_jobs().await?;
let outbound_http_policy = crank_runtime::OutboundHttpPolicy::try_new_with_limits(
config.runtime.outbound.allowed_hosts.clone(),
config.runtime.outbound.denied_hosts.clone(),
@@ -224,6 +225,7 @@ async fn run(
secret_crypto,
runtime,
)
.with_artifact_store(artifact_store.clone())
.with_public_base_url(base_url)
.with_outbound_http_policy(outbound_http_policy)
.with_identity_provider(std::sync::Arc::new(identity_provider))
+110 -4
View File
@@ -1,13 +1,16 @@
use axum::{
Json,
extract::{Path, State},
extract::{Multipart, Path, State, multipart::MultipartRejection},
http::HeaderMap,
response::IntoResponse,
};
use crank_artifacts::MAX_ARTIFACT_BYTES;
use serde::Deserialize;
use serde_json::{Value, json};
use crate::{
error::ApiError,
service::{OpenApiImportCreatePayload, OpenApiImportPreviewPayload},
service::{OpenApiImportCreatePayload, OpenApiUpload, OpenApiUploadLocale},
state::AppState,
};
@@ -25,15 +28,118 @@ pub struct WorkspaceImportPath {
pub async fn preview_openapi_import(
Path(path): Path<WorkspacePath>,
State(state): State<AppState>,
Json(payload): Json<OpenApiImportPreviewPayload>,
headers: HeaderMap,
multipart: Result<Multipart, MultipartRejection>,
) -> Result<Json<Value>, ApiError> {
let locale = openapi_upload_locale(&headers);
let upload = parse_openapi_upload(
multipart.map_err(|rejection| multipart_rejection(locale, rejection))?,
locale,
)
.await?;
let preview = state
.service
.preview_openapi_import(&path.workspace_id.as_str().into(), payload)
.preview_openapi_import(&path.workspace_id.as_str().into(), upload)
.await?;
Ok(Json(json!(preview)))
}
fn multipart_rejection(locale: OpenApiUploadLocale, rejection: MultipartRejection) -> ApiError {
if rejection.into_response().status() == axum::http::StatusCode::PAYLOAD_TOO_LARGE {
ApiError::openapi_upload(locale, "file_too_large")
} else {
ApiError::openapi_upload(locale, "malformed_multipart")
}
}
async fn parse_openapi_upload(
mut multipart: Multipart,
locale: OpenApiUploadLocale,
) -> Result<OpenApiUpload, ApiError> {
let mut upload = None;
while let Some(field) = multipart
.next_field()
.await
.map_err(|_| ApiError::openapi_upload(locale, "malformed_multipart"))?
{
if upload.is_some() || field.name() != Some("file") {
return Err(ApiError::openapi_upload(locale, "malformed_multipart"));
}
let filename = field
.file_name()
.ok_or_else(|| ApiError::openapi_upload(locale, "invalid_filename"))?;
let mime_type = field
.content_type()
.map(ToString::to_string)
.ok_or_else(|| ApiError::openapi_upload(locale, "invalid_media_type"))?;
if !valid_upload_type(filename, &mime_type) {
return Err(ApiError::openapi_upload(locale, "invalid_media_type"));
}
let mut bytes = Vec::with_capacity(8 * 1024);
let mut field = field;
while let Some(chunk) = field
.chunk()
.await
.map_err(|_| ApiError::openapi_upload(locale, "malformed_multipart"))?
{
if bytes.len().saturating_add(chunk.len()) > MAX_ARTIFACT_BYTES {
return Err(ApiError::openapi_upload(locale, "file_too_large"));
}
bytes.extend_from_slice(&chunk);
}
if bytes.is_empty() {
return Err(ApiError::openapi_upload(locale, "empty_file"));
}
if std::str::from_utf8(&bytes).is_err() {
return Err(ApiError::openapi_upload(locale, "invalid_utf8"));
}
upload = Some(OpenApiUpload {
bytes,
mime_type,
locale,
});
}
upload.ok_or_else(|| ApiError::openapi_upload(locale, "missing_file"))
}
fn valid_upload_type(filename: &str, mime_type: &str) -> bool {
let filename = filename.to_ascii_lowercase();
let mime_type = mime_type.to_ascii_lowercase();
match filename.rsplit_once('.') {
Some((_, "yaml" | "yml")) => matches!(
mime_type.as_str(),
"application/yaml"
| "application/x-yaml"
| "text/yaml"
| "text/x-yaml"
| "application/octet-stream"
),
Some((_, "json")) => matches!(
mime_type.as_str(),
"application/json" | "application/openapi+json" | "application/octet-stream"
),
_ => false,
}
}
fn openapi_upload_locale(headers: &HeaderMap) -> OpenApiUploadLocale {
let prefers_russian = headers
.get("accept-language")
.and_then(|value| value.to_str().ok())
.is_some_and(|value| {
value.split(',').any(|range| {
let language = range.split(';').next().unwrap_or_default().trim();
language.eq_ignore_ascii_case("ru")
|| language.to_ascii_lowercase().starts_with("ru-")
})
});
if prefers_russian {
OpenApiUploadLocale::Ru
} else {
OpenApiUploadLocale::En
}
}
pub async fn create_openapi_import(
Path(path): Path<WorkspaceImportPath>,
State(state): State<AppState>,
+16
View File
@@ -3,6 +3,7 @@ use std::path::PathBuf;
use std::sync::Arc;
use base64::{Engine as _, engine::general_purpose::URL_SAFE_NO_PAD};
use crank_artifacts::ArtifactStore;
use crank_core::{
AuditActor, AuditEvent, AuditEventId, AuditSink, AuditTarget, AuditTargetKind, AuthProfile,
CapabilityProfile, CommunityCapabilityProfile, CorrelationContext, EditionCapabilities,
@@ -57,6 +58,7 @@ use operation_validation::{
#[derive(Clone)]
pub struct AdminService {
registry: PostgresRegistry,
artifact_store: Arc<ArtifactStore>,
runtime: RuntimeExecutor,
storage: LocalArtifactStorage,
auth_settings: AuthSettings,
@@ -72,6 +74,7 @@ pub struct AdminService {
pub struct AdminServiceBuilder {
registry: PostgresRegistry,
storage_root: PathBuf,
artifact_store: Option<ArtifactStore>,
auth_settings: AuthSettings,
secret_crypto: SecretCrypto,
runtime: RuntimeExecutor,
@@ -201,6 +204,7 @@ impl AdminServiceBuilder {
Self {
registry,
storage_root,
artifact_store: None,
auth_settings,
secret_crypto,
runtime,
@@ -223,6 +227,14 @@ impl AdminServiceBuilder {
self
}
/// Reuses the process-wide immutable artifact authority for OpenAPI
/// ingress and reconciliation. Tests may omit this and use their private
/// storage root instead.
pub fn with_artifact_store(mut self, artifact_store: ArtifactStore) -> Self {
self.artifact_store = Some(artifact_store);
self
}
pub fn with_public_base_url(mut self, public_base_url: String) -> Self {
self.public_base_url = public_base_url.trim_end_matches('/').to_owned();
self
@@ -252,6 +264,10 @@ impl AdminServiceBuilder {
pub fn build(self) -> AdminService {
AdminService {
registry: self.registry,
artifact_store: Arc::new(
self.artifact_store
.unwrap_or_else(|| ArtifactStore::new(&self.storage_root)),
),
runtime: self.runtime,
storage: LocalArtifactStorage::new(self.storage_root),
auth_settings: self.auth_settings,
+288 -67
View File
@@ -1,5 +1,6 @@
use std::collections::{BTreeMap, BTreeSet};
use crank_artifacts::{ArtifactError, MAX_ARTIFACT_BYTES};
use crank_core::{
ExecutionConfig, OperationSecurityLevel, Protocol, ToolQualityFinding, ToolQualitySeverity,
WorkspaceId,
@@ -8,8 +9,10 @@ use crank_import::rest::{
ImportFinding, ImportFindingSeverity, ImportOperationCandidate, operation_draft_from_candidate,
};
use crank_registry::{
ApplyImportJobRequest, CreateImportJobRequest, ImportConflictMode, ImportJobId, ImportJobKind,
ImportJobStatus, ImportOperationDraft,
ApplyImportJobRequest, ArtifactSourceId, ArtifactSourceSensitivity,
CreateArtifactSourceRequest, CreateImportJobRequest, DetachArtifactSourceRequest,
ImportConflictMode, ImportJobApplyResult, ImportJobId, ImportJobKind, ImportJobSourceEnvelope,
ImportJobStatus, ImportOperationDraft, RegistryError,
};
use serde_json::json;
use sha2::{Digest, Sha256};
@@ -20,30 +23,83 @@ use crate::{
error::ApiError,
service::{
AdminService, OpenApiImportCreatePayload, OpenApiImportCreateResponse,
OpenApiImportCreatedOperation, OpenApiImportPreviewPayload, OpenApiImportPreviewResponse,
OpenApiImportSkippedOperation, OperationPayload, new_prefixed_id,
OpenApiImportCreatedOperation, OpenApiImportPreviewResponse, OpenApiImportSkippedOperation,
OpenApiUpload, OpenApiUploadLocale, OperationPayload, new_prefixed_id,
},
};
const IMPORT_JOB_TTL_HOURS: i64 = 24;
impl AdminService {
#[instrument(skip(self, payload), fields(workspace_id = %workspace_id.as_str()))]
#[instrument(skip(self, upload), fields(workspace_id = %workspace_id.as_str()))]
pub async fn preview_openapi_import(
&self,
workspace_id: &WorkspaceId,
payload: OpenApiImportPreviewPayload,
upload: OpenApiUpload,
) -> Result<OpenApiImportPreviewResponse, ApiError> {
self.ensure_workspace_exists(workspace_id).await?;
let _ = self.registry.delete_expired_import_jobs().await;
self.registry.delete_expired_import_jobs().await?;
let preview = crank_import::rest::preview_document(&payload.document)
.map_err(|error| ApiError::validation(error.to_string()))?;
validate_openapi_upload(&upload)?;
let OpenApiUpload {
bytes,
mime_type,
locale,
} = upload;
let store = self.artifact_store.clone();
let artifact = tokio::task::spawn_blocking(move || store.put_registered(&bytes))
.await
.map_err(|_| ApiError::openapi_upload(locale, "storage_unavailable"))?
.map_err(|error| artifact_error(locale, error))?;
let now = OffsetDateTime::now_utc();
let expires_at = now + Duration::hours(IMPORT_JOB_TTL_HOURS);
let job_id = ImportJobId::new(new_prefixed_id("imp"));
let preview_payload = serde_json::to_value(&preview)
let source_id = ArtifactSourceId::new(new_prefixed_id("src_openapi"));
let source = self
.registry
.create_artifact_source(CreateArtifactSourceRequest {
workspace_id,
source_id: &source_id,
artifact: &artifact,
mime_type: &mime_type,
sensitivity: ArtifactSourceSensitivity::Internal,
created_at: now,
})
.await?;
let mut detach_guard = SourceDetachGuard::new(
self.registry.clone(),
workspace_id.clone(),
source_id.clone(),
source.updated_at,
);
let verified = self
.registry
.read_artifact_source(&self.artifact_store, workspace_id, &source_id)
.await?;
if verified.source.blob.artifact_ref != *artifact.artifact_ref() {
return Err(ApiError::openapi_upload(locale, "source_integrity"));
}
let preview = parse_verified_preview(verified.bytes, locale).await?;
if preview
.groups
.iter()
.all(|group| group.operations.is_empty())
{
return Err(ApiError::openapi_upload(locale, "no_methods"));
}
let source_envelope = ImportJobSourceEnvelope {
source_id,
digest: artifact.artifact_ref().clone(),
};
let preview_value = serde_json::to_value(&preview)
.map_err(|error| ApiError::internal(error.to_string()))?;
let preview_payload = json!({
"source": {
"source_id": source_envelope.source_id.as_str(),
"digest": source_envelope.digest.as_str(),
},
"preview": preview_value,
});
self.registry
.create_import_job(CreateImportJobRequest {
@@ -53,11 +109,13 @@ impl AdminService {
source_format: &preview.source.format,
source_version: preview.source.version.as_deref(),
status: ImportJobStatus::Pending,
source: &source_envelope,
preview_payload: &preview_payload,
created_at: &now,
expires_at: &expires_at,
})
.await?;
detach_guard.disarm();
Ok(OpenApiImportPreviewResponse {
job_id: job_id.as_str().to_owned(),
@@ -76,7 +134,7 @@ impl AdminService {
payload: OpenApiImportCreatePayload,
) -> Result<OpenApiImportCreateResponse, ApiError> {
self.ensure_workspace_exists(workspace_id).await?;
let _ = self.registry.delete_expired_import_jobs().await;
self.registry.delete_expired_import_jobs().await?;
if !matches!(payload.conflict_mode.as_str(), "skip" | "rename") {
return Err(ApiError::validation(
@@ -101,13 +159,6 @@ impl AdminService {
return Err(ApiError::validation("import job kind is not openapi"));
}
let stored_preview = job
.preview_payload
.get("preview")
.cloned()
.unwrap_or_else(|| job.preview_payload.clone());
let preview: crank_import::rest::ImportPreview = serde_json::from_value(stored_preview)
.map_err(|error| ApiError::internal(error.to_string()))?;
let selected = payload
.selected_operation_keys
.iter()
@@ -118,7 +169,38 @@ impl AdminService {
"selected_operation_keys must contain at least one operation",
));
}
let finished_at = OffsetDateTime::now_utc();
let application_key = openapi_application_key(&payload)?;
let conflict_mode = if payload.conflict_mode == "skip" {
ImportConflictMode::Skip
} else {
ImportConflictMode::Rename
};
if job.status == ImportJobStatus::Completed {
let applied = self
.registry
.apply_import_job(ApplyImportJobRequest {
id: job_id,
workspace_id,
application_key: &application_key,
conflict_mode,
operations: &[],
finished_at: &finished_at,
})
.await?;
return Ok(openapi_import_response(applied, Vec::new()));
}
let source = import_job_source(&job.preview_payload)?;
let verified = self
.registry
.read_artifact_source(&self.artifact_store, workspace_id, &source.source_id)
.await
.map_err(openapi_source_error)?;
if verified.source.blob.artifact_ref != source.digest {
return Err(ApiError::source_integrity());
}
let preview = parse_verified_preview(verified.bytes, OpenApiUploadLocale::En).await?;
let mut candidates = BTreeMap::new();
for group in &preview.groups {
for operation in &group.operations {
@@ -171,13 +253,6 @@ impl AdminService {
});
}
let finished_at = OffsetDateTime::now_utc();
let application_key = openapi_application_key(&payload)?;
let conflict_mode = if payload.conflict_mode == "skip" {
ImportConflictMode::Skip
} else {
ImportConflictMode::Rename
};
let applied = self
.registry
.apply_import_job(ApplyImportJobRequest {
@@ -190,20 +265,31 @@ impl AdminService {
})
.await?;
let created = applied
.created
.iter()
.map(|operation| OpenApiImportCreatedOperation {
operation_id: operation.operation_id.as_str().to_owned(),
name: operation.name.clone(),
version: operation.version,
})
.collect::<Vec<_>>();
let mut findings = applied
.created
.iter()
.filter_map(|operation| {
operation.renamed_from.as_ref().map(|previous_name| ImportFinding {
Ok(openapi_import_response(applied, skipped))
}
}
fn openapi_import_response(
applied: ImportJobApplyResult,
mut skipped: Vec<OpenApiImportSkippedOperation>,
) -> OpenApiImportCreateResponse {
let created = applied
.created
.iter()
.map(|operation| OpenApiImportCreatedOperation {
operation_id: operation.operation_id.as_str().to_owned(),
name: operation.name.clone(),
version: operation.version,
})
.collect::<Vec<_>>();
let mut findings = applied
.created
.iter()
.filter_map(|operation| {
operation
.renamed_from
.as_ref()
.map(|previous_name| ImportFinding {
code: "operation_name_renamed".to_owned(),
severity: ImportFindingSeverity::Info,
message: format!(
@@ -212,36 +298,171 @@ impl AdminService {
),
operation_key: Some(operation.operation_key.clone()),
})
})
.collect::<Vec<_>>();
for operation in applied.skipped {
skipped.push(OpenApiImportSkippedOperation {
operation_key: operation.operation_key.clone(),
name: operation.name.clone(),
reason: "operation with this name already exists".to_owned(),
});
findings.push(ImportFinding {
code: operation.reason,
severity: ImportFindingSeverity::Warning,
message: format!(
"Операция {} уже существует и была пропущена.",
operation.name
),
operation_key: Some(operation.operation_key),
})
.collect::<Vec<_>>();
for operation in applied.skipped {
skipped.push(OpenApiImportSkippedOperation {
operation_key: operation.operation_key.clone(),
name: operation.name.clone(),
reason: "operation with this name already exists".to_owned(),
});
findings.push(ImportFinding {
code: operation.reason,
severity: ImportFindingSeverity::Warning,
message: format!(
"Операция {} уже существует и была пропущена.",
operation.name
),
operation_key: Some(operation.operation_key),
});
}
info!(
name: "admin.openapi_import.completed",
created = created.len(),
skipped = skipped.len(),
"openapi import created drafts"
);
OpenApiImportCreateResponse {
created,
skipped,
findings,
}
}
fn validate_openapi_upload(upload: &OpenApiUpload) -> Result<(), ApiError> {
if upload.bytes.is_empty() {
return Err(ApiError::openapi_upload(upload.locale, "empty_file"));
}
if upload.bytes.len() > MAX_ARTIFACT_BYTES {
return Err(ApiError::openapi_upload(upload.locale, "file_too_large"));
}
if !matches!(
upload.mime_type.as_str(),
"application/yaml"
| "application/x-yaml"
| "text/yaml"
| "text/x-yaml"
| "application/json"
| "application/openapi+json"
| "application/octet-stream"
) {
return Err(ApiError::openapi_upload(
upload.locale,
"invalid_media_type",
));
}
if std::str::from_utf8(&upload.bytes).is_err() {
return Err(ApiError::openapi_upload(upload.locale, "invalid_utf8"));
}
Ok(())
}
async fn parse_verified_preview(
bytes: Vec<u8>,
locale: OpenApiUploadLocale,
) -> Result<crank_import::rest::ImportPreview, ApiError> {
tokio::task::spawn_blocking(move || {
let document = std::str::from_utf8(&bytes)
.map_err(|_| ApiError::openapi_upload(locale, "invalid_utf8"))?;
crank_import::rest::preview_document(document)
.map_err(|_| ApiError::openapi_upload(locale, "invalid_document"))
})
.await
.map_err(|_| ApiError::openapi_upload(locale, "parser_unavailable"))?
}
fn artifact_error(locale: OpenApiUploadLocale, error: ArtifactError) -> ApiError {
match error {
ArtifactError::EmptySource => ApiError::openapi_upload(locale, "empty_file"),
ArtifactError::SourceTooLarge => ApiError::openapi_upload(locale, "file_too_large"),
ArtifactError::Integrity => ApiError::openapi_upload(locale, "source_integrity"),
ArtifactError::Storage
| ArtifactError::NotFound
| ArtifactError::InvalidReference
| ArtifactError::UnsafeRoot => ApiError::openapi_upload(locale, "storage_unavailable"),
}
}
fn openapi_source_error(error: RegistryError) -> ApiError {
match error {
RegistryError::SourceNotFound { .. } | RegistryError::SourceUnavailable => {
ApiError::source_unavailable()
}
RegistryError::SourceIntegrity => ApiError::source_integrity(),
other => ApiError::from(other),
}
}
fn import_job_source(payload: &serde_json::Value) -> Result<ImportJobSourceEnvelope, ApiError> {
let source = payload
.get("source")
.ok_or_else(ApiError::source_unavailable)?;
let source_id = source
.get("source_id")
.and_then(serde_json::Value::as_str)
.filter(|value| value.len() <= 132)
.ok_or_else(ApiError::source_unavailable)?;
let digest = source
.get("digest")
.and_then(serde_json::Value::as_str)
.and_then(|value| value.parse().ok())
.ok_or_else(ApiError::source_integrity)?;
Ok(ImportJobSourceEnvelope {
source_id: ArtifactSourceId::new(source_id),
digest,
})
}
struct SourceDetachGuard {
registry: crank_registry::PostgresRegistry,
workspace_id: WorkspaceId,
source_id: ArtifactSourceId,
expected_updated_at: OffsetDateTime,
armed: bool,
}
impl SourceDetachGuard {
fn new(
registry: crank_registry::PostgresRegistry,
workspace_id: WorkspaceId,
source_id: ArtifactSourceId,
expected_updated_at: OffsetDateTime,
) -> Self {
Self {
registry,
workspace_id,
source_id,
expected_updated_at,
armed: true,
}
}
fn disarm(&mut self) {
self.armed = false;
}
}
impl Drop for SourceDetachGuard {
fn drop(&mut self) {
if !self.armed {
return;
}
let registry = self.registry.clone();
let workspace_id = self.workspace_id.clone();
let source_id = self.source_id.clone();
let expected_updated_at = Some(self.expected_updated_at);
if let Ok(handle) = tokio::runtime::Handle::try_current() {
handle.spawn(async move {
let _ = registry
.detach_artifact_source(DetachArtifactSourceRequest {
workspace_id: &workspace_id,
source_id: &source_id,
expected_updated_at,
detached_at: OffsetDateTime::now_utc(),
})
.await;
});
}
info!(
name: "admin.openapi_import.completed",
created = created.len(),
skipped = skipped.len(),
"openapi import created drafts"
);
Ok(OpenApiImportCreateResponse {
created,
skipped,
findings,
})
}
}
+1
View File
@@ -7,6 +7,7 @@ mod integration {
mod logs_usage;
mod onboarding;
mod openapi_import;
mod openapi_source;
mod operation_lifecycle;
mod operations_agents;
mod request_context;
+6 -2
View File
@@ -328,14 +328,18 @@ pub(super) async fn test_registry() -> PostgresRegistry {
}
pub(super) fn test_storage_root(name: &str) -> std::path::PathBuf {
env::temp_dir().join(format!(
let root = env::temp_dir().join(format!(
"crank_admin_api_{name}_{}_{}",
std::process::id(),
SystemTime::now()
.duration_since(UNIX_EPOCH)
.unwrap()
.as_nanos()
))
));
std::fs::create_dir_all(&root).unwrap();
#[cfg(unix)]
std::fs::set_permissions(&root, std::os::unix::fs::PermissionsExt::from_mode(0o700)).unwrap();
root
}
pub(super) fn test_auth_settings() -> AuthSettings {
@@ -1,4 +1,4 @@
use admin_api::service::{OpenApiImportCreatePayload, OpenApiImportPreviewPayload};
use admin_api::service::{OpenApiImportCreatePayload, OpenApiUpload, OpenApiUploadLocale};
use crank_core::WorkspaceId;
use crank_registry::ImportJobStatus;
use serial_test::serial;
@@ -51,12 +51,7 @@ async fn previews_openapi_and_creates_draft_operations() {
let workspace_id = WorkspaceId::new("ws_default");
let preview = service
.preview_openapi_import(
&workspace_id,
OpenApiImportPreviewPayload {
document: OPENAPI3.to_owned(),
},
)
.preview_openapi_import(&workspace_id, openapi_upload())
.await
.unwrap();
@@ -89,6 +84,24 @@ async fn previews_openapi_and_creates_draft_operations() {
assert_eq!(created.created[0].name, "latest_rates");
assert!(created.skipped.is_empty());
let replayed = service
.create_openapi_import(
&workspace_id,
&preview.job_id.as_str().into(),
OpenApiImportCreatePayload {
selected_operation_keys: vec!["GET /v2/latest".to_owned()],
server_url: Some("https://api.frankfurter.dev".to_owned()),
conflict_mode: "skip".to_owned(),
},
)
.await
.unwrap();
assert_eq!(replayed.created.len(), 1);
assert_eq!(
replayed.created[0].operation_id,
created.created[0].operation_id
);
let operations = service.list_operations(&workspace_id).await.unwrap();
assert!(
operations
@@ -120,12 +133,7 @@ async fn previews_openapi_and_creates_draft_operations() {
);
let skip_preview = service
.preview_openapi_import(
&workspace_id,
OpenApiImportPreviewPayload {
document: OPENAPI3.to_owned(),
},
)
.preview_openapi_import(&workspace_id, openapi_upload())
.await
.unwrap();
let skipped = service
@@ -147,12 +155,7 @@ async fn previews_openapi_and_creates_draft_operations() {
assert_eq!(skipped.findings[0].code, "operation_name_conflict");
let rename_preview = service
.preview_openapi_import(
&workspace_id,
OpenApiImportPreviewPayload {
document: OPENAPI3.to_owned(),
},
)
.preview_openapi_import(&workspace_id, openapi_upload())
.await
.unwrap();
let renamed = service
@@ -185,12 +188,7 @@ async fn concurrent_openapi_import_replays_the_same_atomic_result() {
);
let workspace_id = WorkspaceId::new("ws_default");
let preview = service
.preview_openapi_import(
&workspace_id,
OpenApiImportPreviewPayload {
document: OPENAPI3.to_owned(),
},
)
.preview_openapi_import(&workspace_id, openapi_upload())
.await
.unwrap();
let job_id = preview.job_id.as_str().into();
@@ -232,3 +230,11 @@ async fn concurrent_openapi_import_replays_the_same_atomic_result() {
.await;
assert!(conflicting_replay.is_err());
}
fn openapi_upload() -> OpenApiUpload {
OpenApiUpload {
bytes: OPENAPI3.as_bytes().to_vec(),
mime_type: "application/yaml".to_owned(),
locale: OpenApiUploadLocale::En,
}
}
@@ -0,0 +1,937 @@
use std::{
io,
sync::{Arc, Mutex},
};
use admin_api::service::{OpenApiImportCreatePayload, OpenApiUpload, OpenApiUploadLocale};
use crank_artifacts::MAX_ARTIFACT_BYTES;
use crank_core::{Workspace, WorkspaceId, WorkspaceStatus};
use crank_registry::{ArtifactSourceId, ArtifactSourceLifecycle, CreateWorkspaceRequest};
use metrics_util::debugging::DebuggingRecorder;
use opentelemetry::trace::TracerProvider as _;
use opentelemetry_sdk::{
error::OTelSdkResult,
trace::{SdkTracerProvider, SpanData, SpanExporter},
};
use reqwest::multipart::{Form, Part};
use serde_json::Value;
use serial_test::serial;
use time::{Duration, OffsetDateTime};
use tracing_subscriber::{fmt::MakeWriter, layer::SubscriberExt};
use super::common::{
authorized_client, build_test_app, spawn_admin_api, test_auth_settings, test_registry,
test_secret_crypto, test_service, test_storage_root,
};
mod apply_failures;
const OPENAPI: &str = r#"
openapi: 3.0.3
info: { title: Source authority }
servers:
- url: https://example.test
paths:
/health:
get:
operationId: sourceHealth
responses:
'200': { description: OK }
"#;
#[tokio::test(flavor = "multi_thread")]
#[serial]
async fn multipart_accepts_valid_yaml_and_json_through_the_outer_router() {
let registry = test_registry().await;
let app = build_test_app(registry, test_storage_root("openapi_valid_multipart"));
let server = spawn_admin_api(app).await;
let client = authorized_client(&server).await;
for (document, filename, mime_type) in [
(OPENAPI.as_bytes(), "openapi.yaml", "application/yaml"),
(
br#"{"openapi":"3.0.3","info":{"title":"JSON"},"paths":{"/health":{"get":{"responses":{"200":{"description":"OK"}}}}}}"#
.as_slice(),
"openapi.json",
"application/json",
),
] {
let response = client
.post(format!("{server}/imports/openapi/preview"))
.multipart(Form::new().part(
"file",
file_part(document, filename, mime_type),
))
.send()
.await
.unwrap();
let status = response.status();
let body = response.json::<Value>().await.unwrap();
assert_eq!(status, reqwest::StatusCode::OK, "{body}");
assert!(body["job_id"].is_string());
assert!(!body.to_string().contains("source_id"));
assert!(!body.to_string().contains("digest"));
}
}
#[tokio::test(flavor = "multi_thread")]
#[serial]
async fn multipart_requires_an_owner_membership_before_reading_the_file() {
let registry = test_registry().await;
let now = OffsetDateTime::now_utc();
let foreign_workspace = WorkspaceId::new("ws_openapi_unauthorized");
registry
.create_workspace(CreateWorkspaceRequest {
workspace: &Workspace {
id: foreign_workspace.clone(),
slug: "openapi-unauthorized".to_owned(),
display_name: "OpenAPI Unauthorized".to_owned(),
status: WorkspaceStatus::Active,
settings: serde_json::json!({}),
created_at: now,
updated_at: now,
},
})
.await
.unwrap();
let app = build_test_app(
registry.clone(),
test_storage_root("openapi_upload_authorization"),
);
let server = spawn_admin_api(app).await;
let endpoint = format!("{server}/imports/openapi/preview");
let anonymous = reqwest::Client::new()
.post(&endpoint)
.header("content-type", "multipart/form-data; boundary=broken")
.body("this body must not be parsed before authentication")
.send()
.await
.unwrap();
assert_eq!(anonymous.status(), reqwest::StatusCode::UNAUTHORIZED);
let authorized = authorized_client(&server).await;
let foreign_endpoint = endpoint.replace("ws_default", foreign_workspace.as_str());
let forbidden = authorized
.post(foreign_endpoint)
.header("content-type", "multipart/form-data; boundary=broken")
.body("this body must not be parsed before workspace authorization")
.send()
.await
.unwrap();
assert_eq!(forbidden.status(), reqwest::StatusCode::FORBIDDEN);
assert_eq!(
sqlx::query_scalar::<_, i64>("select count(*) from artifact_sources")
.fetch_one(registry.pool())
.await
.unwrap(),
0
);
assert_eq!(
sqlx::query_scalar::<_, i64>("select count(*) from import_jobs")
.fetch_one(registry.pool())
.await
.unwrap(),
0
);
}
#[tokio::test(flavor = "multi_thread")]
#[serial]
async fn parser_canary_never_reaches_diagnostics_logs_traces_or_metrics() {
const CANARY: &str = "openapi-telemetry-secret-canary";
let recorder = DebuggingRecorder::new();
let snapshotter = recorder.snapshotter();
recorder
.install()
.expect("isolated integration test metrics recorder");
let writer = SharedLogWriter::default();
let exported = Arc::new(Mutex::new(Vec::new()));
let provider = SdkTracerProvider::builder()
.with_simple_exporter(CapturingExporter(Arc::clone(&exported)))
.build();
let tracer = provider.tracer("admin-openapi-source-test");
let subscriber = tracing_subscriber::registry()
.with(tracing_subscriber::fmt::layer().with_writer(writer.clone()))
.with(tracing_opentelemetry::layer().with_tracer(tracer));
let dispatch = tracing::Dispatch::new(subscriber);
tracing::dispatcher::set_global_default(dispatch)
.expect("isolated integration test tracing subscriber");
let registry = test_registry().await;
let app = build_test_app(registry, test_storage_root("openapi_telemetry_canary"));
let server = spawn_admin_api(app).await;
let client = authorized_client(&server).await;
let document = format!(
"openapi: 3.0.3\ninfo: {{ title: Canary }}\npaths:\n /broken:\n get:\n description: {CANARY}\n responses: ["
);
let response = client
.post(format!("{server}/imports/openapi/preview"))
.multipart(Form::new().part(
"file",
file_part(document.as_bytes(), "openapi.yaml", "application/yaml"),
))
.send()
.await
.unwrap();
assert_eq!(response.status(), reqwest::StatusCode::BAD_REQUEST);
let trace_id = response
.headers()
.get("x-trace-id")
.unwrap()
.to_str()
.unwrap()
.to_owned();
let body = response.text().await.unwrap();
assert!(!body.contains(CANARY));
let diagnostics: Value = serde_json::from_str(&body).unwrap();
assert_eq!(diagnostics["error"]["trace_id"], trace_id);
provider.force_flush().unwrap();
let logs = writer.output();
assert!(!logs.contains(CANARY));
assert!(logs.contains(&trace_id));
let spans = exported.lock().unwrap();
let rendered_spans = format!("{spans:?}");
assert!(!rendered_spans.contains(CANARY));
drop(spans);
for (key, _, _, _) in snapshotter.snapshot().into_vec() {
assert!(!key.key().name().contains(CANARY));
assert!(
!key.key()
.labels()
.any(|label| { label.key().contains(CANARY) || label.value().contains(CANARY) })
);
}
provider.shutdown().unwrap();
}
#[tokio::test(flavor = "multi_thread")]
#[serial]
async fn multipart_boundary_rejections_are_localized_and_leave_no_entities() {
let registry = test_registry().await;
let app = build_test_app(
registry.clone(),
test_storage_root("openapi_multipart_boundary"),
);
let server = spawn_admin_api(app).await;
let client = authorized_client(&server).await;
assert_rejected(
&client,
&server,
Form::new().part(
"file",
file_part(b"sensitive-openapi-body", "openapi.txt", "text/plain"),
),
"ru-RU",
reqwest::StatusCode::BAD_REQUEST,
"openapi_upload.invalid_media_type",
Some("тип"),
)
.await;
assert_rejected(
&client,
&server,
Form::new().part(
"file",
file_part(OPENAPI.as_bytes(), "openapi.txt", "application/yaml"),
),
"en-US",
reqwest::StatusCode::BAD_REQUEST,
"openapi_upload.invalid_media_type",
Some("not supported"),
)
.await;
assert_rejected(
&client,
&server,
Form::new().part(
"file",
file_part(OPENAPI.as_bytes(), "openapi.yaml", "application/json"),
),
"en-US",
reqwest::StatusCode::BAD_REQUEST,
"openapi_upload.invalid_media_type",
Some("not supported"),
)
.await;
assert_rejected(
&client,
&server,
Form::new(),
"en-US",
reqwest::StatusCode::BAD_REQUEST,
"openapi_upload.malformed_multipart",
Some("multipart"),
)
.await;
assert_eq!(
sqlx::query_scalar::<_, i64>("select count(*) from import_jobs")
.fetch_one(registry.pool())
.await
.unwrap(),
0
);
assert_eq!(
sqlx::query_scalar::<_, i64>("select count(*) from operations")
.fetch_one(registry.pool())
.await
.unwrap(),
0
);
assert_rejected(
&client,
&server,
Form::new().part(
"other",
file_part(OPENAPI.as_bytes(), "openapi.yaml", "application/yaml"),
),
"en-US",
reqwest::StatusCode::BAD_REQUEST,
"openapi_upload.malformed_multipart",
Some("multipart"),
)
.await;
assert_rejected(
&client,
&server,
Form::new()
.part(
"file",
file_part(OPENAPI.as_bytes(), "one.yaml", "application/yaml"),
)
.part(
"file",
file_part(OPENAPI.as_bytes(), "two.yaml", "application/yaml"),
),
"en-US",
reqwest::StatusCode::BAD_REQUEST,
"openapi_upload.malformed_multipart",
Some("multipart"),
)
.await;
assert_rejected(
&client,
&server,
Form::new().part("file", file_part(b"", "openapi.yaml", "application/yaml")),
"en-US",
reqwest::StatusCode::BAD_REQUEST,
"openapi_upload.empty_file",
Some("empty"),
)
.await;
assert_rejected(
&client,
&server,
Form::new().part(
"file",
file_part([0xff, 0xfe], "openapi.yaml", "application/yaml"),
),
"en-US",
reqwest::StatusCode::BAD_REQUEST,
"openapi_upload.invalid_utf8",
Some("UTF-8"),
)
.await;
assert_rejected(
&client,
&server,
Form::new().part(
"file",
file_part(
vec![b'x'; MAX_ARTIFACT_BYTES + 1],
"openapi.yaml",
"application/yaml",
),
),
"en-US",
reqwest::StatusCode::PAYLOAD_TOO_LARGE,
"openapi_upload.file_too_large",
Some("256 KiB"),
)
.await;
assert_eq!(
sqlx::query_scalar::<_, i64>("select count(*) from import_jobs")
.fetch_one(registry.pool())
.await
.unwrap(),
0
);
assert_eq!(
sqlx::query_scalar::<_, i64>("select count(*) from artifact_sources")
.fetch_one(registry.pool())
.await
.unwrap(),
0
);
assert_rejected(
&client,
&server,
Form::new().part(
"file",
file_part(
b"openapi: 3.0.3\ninfo: { title: Empty }\npaths: {}\n",
"openapi.yaml",
"application/yaml",
),
),
"en-US",
reqwest::StatusCode::BAD_REQUEST,
"openapi_upload.no_methods",
Some("no supported methods"),
)
.await;
assert_rejected(
&client,
&server,
Form::new().part("file", file_part(b"", "openapi.yaml", "application/yaml")),
"ru-RU",
reqwest::StatusCode::BAD_REQUEST,
"openapi_upload.empty_file",
Some("пуст"),
)
.await;
assert_rejected(
&client,
&server,
Form::new().part(
"file",
file_part(b"openapi: [", "openapi.yaml", "application/yaml"),
),
"ru-RU",
reqwest::StatusCode::BAD_REQUEST,
"openapi_upload.invalid_document",
Some("документ"),
)
.await;
wait_for_source_lifecycle(&registry, ArtifactSourceLifecycle::Detached).await;
let mut exact_limit = OPENAPI.as_bytes().to_vec();
let padding = MAX_ARTIFACT_BYTES
.checked_sub(exact_limit.len())
.expect("OpenAPI fixture must fit inside the exact-size boundary");
exact_limit.extend(std::iter::repeat_n(b'#', padding));
let response = client
.post(format!("{server}/imports/openapi/preview"))
.multipart(Form::new().part(
"file",
file_part(&exact_limit, "openapi.yaml", "application/yaml"),
))
.send()
.await
.unwrap();
assert_eq!(response.status(), reqwest::StatusCode::OK);
let body = response.json::<Value>().await.unwrap();
let rendered = body.to_string();
assert!(body["job_id"].is_string());
assert!(!rendered.contains("source_id"));
assert!(!rendered.contains("digest"));
}
async fn wait_for_source_lifecycle(
registry: &crank_registry::PostgresRegistry,
lifecycle: ArtifactSourceLifecycle,
) {
let expected = match lifecycle {
ArtifactSourceLifecycle::Active => "active",
ArtifactSourceLifecycle::Detached => "detached",
};
for _ in 0..100 {
let found = sqlx::query_scalar::<_, bool>(
"select exists(select 1 from artifact_sources where lifecycle = $1)",
)
.bind(expected)
.fetch_one(registry.pool())
.await
.unwrap();
if found {
return;
}
tokio::time::sleep(std::time::Duration::from_millis(10)).await;
}
panic!("artifact source did not reach {expected}");
}
fn file_part(bytes: impl AsRef<[u8]>, filename: &str, mime_type: &str) -> Part {
Part::bytes(bytes.as_ref().to_vec())
.file_name(filename.to_owned())
.mime_str(mime_type)
.unwrap()
}
async fn assert_rejected(
client: &reqwest::Client,
server: &impl AsRef<str>,
form: Form,
language: &str,
expected_status: reqwest::StatusCode,
expected_code: &str,
message_fragment: Option<&str>,
) {
let response = client
.post(format!("{}/imports/openapi/preview", server.as_ref()))
.header("accept-language", language)
.multipart(form)
.send()
.await
.unwrap();
let status = response.status();
let body = response.json::<Value>().await.unwrap();
assert_eq!(
status, expected_status,
"unexpected status while checking {expected_code}: {body}"
);
assert_eq!(body["error"]["code"], expected_code);
assert!(body["error"]["request_id"].is_string());
assert!(body["error"]["trace_id"].is_string());
if let Some(fragment) = message_fragment {
assert!(
body["error"]["message"]
.as_str()
.unwrap()
.contains(fragment)
);
}
}
#[tokio::test(flavor = "multi_thread")]
#[serial]
async fn apply_rereads_the_scoped_verified_source_and_expiry_detaches_it() {
let registry = test_registry().await;
let service = test_service(
registry.clone(),
test_storage_root("openapi_verified_source"),
test_auth_settings(),
test_secret_crypto(),
);
let service = service.clone();
let workspace_id = WorkspaceId::new("ws_default");
let preview = service
.preview_openapi_import(
&workspace_id,
OpenApiUpload {
bytes: OPENAPI.as_bytes().to_vec(),
mime_type: "application/yaml".to_owned(),
locale: OpenApiUploadLocale::En,
},
)
.await
.unwrap();
let job_id = preview.job_id.as_str().into();
let job = registry
.get_import_job(&workspace_id, &job_id)
.await
.unwrap()
.unwrap();
let source_id = job.preview_payload["source"]["source_id"]
.as_str()
.unwrap()
.to_owned();
let source = registry
.get_artifact_source(&workspace_id, &source_id.as_str().into())
.await
.unwrap();
assert_eq!(source.lifecycle, ArtifactSourceLifecycle::Active);
// The stored preview is presentation data only. A forged candidate cannot
// create a Draft because apply reparses the source bytes.
sqlx::query("update import_jobs set preview_payload = jsonb_set(preview_payload, '{preview}', '{\"groups\":[]}') where id = $1")
.bind(job_id.as_str())
.execute(registry.pool())
.await
.unwrap();
let imported = service
.create_openapi_import(
&workspace_id,
&job_id,
OpenApiImportCreatePayload {
selected_operation_keys: vec!["GET /health".to_owned()],
server_url: None,
conflict_mode: "skip".to_owned(),
},
)
.await
.unwrap();
assert_eq!(imported.created.len(), 1);
let detached = registry
.get_artifact_source(&workspace_id, &source_id.as_str().into())
.await
.unwrap();
assert_eq!(detached.lifecycle, ArtifactSourceLifecycle::Detached);
let second_preview = service
.preview_openapi_import(
&workspace_id,
OpenApiUpload {
bytes: OPENAPI.as_bytes().to_vec(),
mime_type: "application/yaml".to_owned(),
locale: OpenApiUploadLocale::En,
},
)
.await
.unwrap();
let second_job_id = second_preview.job_id.as_str().into();
let second_job = registry
.get_import_job(&workspace_id, &second_job_id)
.await
.unwrap()
.unwrap();
let second_source_id = second_job.preview_payload["source"]["source_id"]
.as_str()
.unwrap()
.to_owned();
sqlx::query("update import_jobs set expires_at = $1 where id = $2")
.bind(OffsetDateTime::now_utc() - Duration::minutes(1))
.bind(second_job_id.as_str())
.execute(registry.pool())
.await
.unwrap();
registry.delete_expired_import_jobs().await.unwrap();
let expired_job_source = registry
.get_artifact_source(&workspace_id, &second_source_id.as_str().into())
.await
.unwrap();
assert_eq!(
expired_job_source.lifecycle,
ArtifactSourceLifecycle::Detached
);
let legacy_preview = service
.preview_openapi_import(
&workspace_id,
OpenApiUpload {
bytes: format!("{OPENAPI}\n# legacy-upgrade").into_bytes(),
mime_type: "application/yaml".to_owned(),
locale: OpenApiUploadLocale::En,
},
)
.await
.unwrap();
let legacy_job_id: crank_registry::ImportJobId = legacy_preview.job_id.as_str().into();
let legacy_job = registry
.get_import_job(&workspace_id, &legacy_job_id)
.await
.unwrap()
.unwrap();
let legacy_source_id = legacy_job.preview_payload["source"]["source_id"]
.as_str()
.unwrap()
.to_owned();
sqlx::query(
"update import_jobs
set preview_payload = jsonb_set(
preview_payload,
'{source}',
'{\"format\":\"openapi\",\"version\":\"3.0.3\"}'::jsonb
),
expires_at = now() - interval '1 minute'
where id = $1",
)
.bind(legacy_job_id.as_str())
.execute(registry.pool())
.await
.unwrap();
sqlx::query(
"update artifact_sources
set created_at = now() - interval '10 minutes',
updated_at = now() - interval '10 minutes'
where workspace_id = $1 and source_id = $2",
)
.bind(workspace_id.as_str())
.bind(&legacy_source_id)
.execute(registry.pool())
.await
.unwrap();
registry.delete_expired_import_jobs().await.unwrap();
assert!(
registry
.get_import_job(&workspace_id, &legacy_job_id)
.await
.unwrap()
.is_none()
);
assert_eq!(
registry
.get_artifact_source(&workspace_id, &legacy_source_id.as_str().into())
.await
.unwrap()
.lifecycle,
ArtifactSourceLifecycle::Detached
);
}
#[tokio::test(flavor = "multi_thread")]
#[serial]
async fn cancellation_detaches_and_restart_cleanup_recovers_a_dangling_source() {
let registry = test_registry().await;
let service = test_service(
registry.clone(),
test_storage_root("openapi_cancel_restart"),
test_auth_settings(),
test_secret_crypto(),
);
let schema = sqlx::query_scalar::<_, String>("select current_schema()")
.fetch_one(registry.pool())
.await
.unwrap();
let observer = sqlx::postgres::PgPoolOptions::new()
.max_connections(1)
.connect(crank_test_support::postgres_database_url().await)
.await
.unwrap();
let lock_pool = sqlx::postgres::PgPoolOptions::new()
.max_connections(1)
.connect(crank_test_support::postgres_database_url().await)
.await
.unwrap();
sqlx::query("select set_config('search_path', $1, false)")
.bind(&schema)
.execute(&observer)
.await
.unwrap();
sqlx::query("select set_config('search_path', $1, false)")
.bind(&schema)
.execute(&lock_pool)
.await
.unwrap();
sqlx::query(
"create function block_openapi_import_insert() returns trigger language plpgsql as $$
begin
perform pg_advisory_xact_lock(2147483001);
return new;
end $$",
)
.execute(registry.pool())
.await
.unwrap();
sqlx::query(
"create trigger block_openapi_import_insert
before insert on import_jobs
for each row execute function block_openapi_import_insert()",
)
.execute(registry.pool())
.await
.unwrap();
let mut lock_connection = lock_pool.acquire().await.unwrap();
sqlx::query("select pg_advisory_lock(2147483001)")
.execute(&mut *lock_connection)
.await
.unwrap();
let workspace_id = WorkspaceId::new("ws_default");
let preview_task = tokio::spawn({
let service = service.clone();
let workspace_id = workspace_id.clone();
async move {
service
.preview_openapi_import(
&workspace_id,
OpenApiUpload {
bytes: OPENAPI.as_bytes().to_vec(),
mime_type: "application/yaml".to_owned(),
locale: OpenApiUploadLocale::En,
},
)
.await
}
});
let cancelled_source_id =
wait_for_source_lifecycle_in_pool(&observer, ArtifactSourceLifecycle::Active).await;
assert!(!preview_task.is_finished());
preview_task.abort();
let cancellation = preview_task.await.unwrap_err();
assert!(cancellation.is_cancelled());
wait_for_blocked_import_insert_to_stop(&observer).await;
sqlx::query("select pg_advisory_unlock(2147483001)")
.execute(&mut *lock_connection)
.await
.unwrap();
wait_for_specific_source_lifecycle(
&registry,
&cancelled_source_id,
ArtifactSourceLifecycle::Detached,
)
.await;
assert_eq!(
sqlx::query_scalar::<_, i64>("select count(*) from import_jobs")
.fetch_one(registry.pool())
.await
.unwrap(),
0
);
sqlx::query("drop trigger block_openapi_import_insert on import_jobs")
.execute(registry.pool())
.await
.unwrap();
let preview = service
.preview_openapi_import(
&workspace_id,
OpenApiUpload {
bytes: format!("{OPENAPI}\n# restart-window").into_bytes(),
mime_type: "application/yaml".to_owned(),
locale: OpenApiUploadLocale::En,
},
)
.await
.unwrap();
let job_id: crank_registry::ImportJobId = preview.job_id.as_str().into();
let job = registry
.get_import_job(&workspace_id, &job_id)
.await
.unwrap()
.unwrap();
let source_id = job.preview_payload["source"]["source_id"]
.as_str()
.unwrap()
.to_owned();
sqlx::query("delete from import_jobs where id = $1")
.bind(job_id.as_str())
.execute(registry.pool())
.await
.unwrap();
sqlx::query(
"update artifact_sources
set created_at = now() - interval '10 minutes',
updated_at = now() - interval '10 minutes'
where workspace_id = $1 and source_id = $2",
)
.bind(workspace_id.as_str())
.bind(&source_id)
.execute(registry.pool())
.await
.unwrap();
registry.delete_expired_import_jobs().await.unwrap();
let recovered = registry
.get_artifact_source(&workspace_id, &source_id.as_str().into())
.await
.unwrap();
assert_eq!(recovered.lifecycle, ArtifactSourceLifecycle::Detached);
}
async fn wait_for_source_lifecycle_in_pool(
pool: &sqlx::PgPool,
lifecycle: ArtifactSourceLifecycle,
) -> ArtifactSourceId {
let expected = match lifecycle {
ArtifactSourceLifecycle::Active => "active",
ArtifactSourceLifecycle::Detached => "detached",
};
for _ in 0..100 {
let found = sqlx::query_scalar::<_, Option<String>>(
"select min(source_id) from artifact_sources where lifecycle = $1",
)
.bind(expected)
.fetch_one(pool)
.await
.unwrap();
if let Some(source_id) = found {
return ArtifactSourceId::new(source_id);
}
tokio::time::sleep(std::time::Duration::from_millis(10)).await;
}
panic!("artifact source did not reach {expected}");
}
async fn wait_for_blocked_import_insert_to_stop(pool: &sqlx::PgPool) {
for _ in 0..100 {
let active = sqlx::query_scalar::<_, bool>(
"select exists(
select 1
from pg_stat_activity
where state = 'active'
and query like 'insert into import_jobs%'
)",
)
.fetch_one(pool)
.await
.unwrap();
if !active {
return;
}
tokio::time::sleep(std::time::Duration::from_millis(10)).await;
}
panic!("cancelled import insert remained active in PostgreSQL");
}
async fn wait_for_specific_source_lifecycle(
registry: &crank_registry::PostgresRegistry,
source_id: &ArtifactSourceId,
lifecycle: ArtifactSourceLifecycle,
) {
let expected = match lifecycle {
ArtifactSourceLifecycle::Active => "active",
ArtifactSourceLifecycle::Detached => "detached",
};
for _ in 0..100 {
let found = sqlx::query_scalar::<_, bool>(
"select exists(
select 1
from artifact_sources
where source_id = $1 and lifecycle = $2
)",
)
.bind(source_id.as_str())
.bind(expected)
.fetch_one(registry.pool())
.await
.unwrap();
if found {
return;
}
tokio::time::sleep(std::time::Duration::from_millis(10)).await;
}
panic!("artifact source {source_id:?} did not reach {expected}");
}
#[derive(Clone, Default)]
struct SharedLogWriter {
buffer: Arc<Mutex<Vec<u8>>>,
}
impl SharedLogWriter {
fn output(&self) -> String {
String::from_utf8(self.buffer.lock().unwrap().clone()).unwrap()
}
}
impl<'a> MakeWriter<'a> for SharedLogWriter {
type Writer = SharedLogGuard;
fn make_writer(&'a self) -> Self::Writer {
SharedLogGuard {
buffer: Arc::clone(&self.buffer),
}
}
}
struct SharedLogGuard {
buffer: Arc<Mutex<Vec<u8>>>,
}
impl io::Write for SharedLogGuard {
fn write(&mut self, bytes: &[u8]) -> io::Result<usize> {
self.buffer.lock().unwrap().extend_from_slice(bytes);
Ok(bytes.len())
}
fn flush(&mut self) -> io::Result<()> {
Ok(())
}
}
#[derive(Clone, Debug)]
struct CapturingExporter(Arc<Mutex<Vec<SpanData>>>);
impl SpanExporter for CapturingExporter {
async fn export(&self, batch: Vec<SpanData>) -> OTelSdkResult {
self.0.lock().unwrap().extend(batch);
Ok(())
}
}
@@ -0,0 +1,253 @@
use crank_artifacts::ArtifactRef;
use super::*;
#[tokio::test(flavor = "multi_thread")]
#[serial]
async fn public_http_contract_is_safe_for_source_failures() {
const SOURCE_CANARY: &str = "openapi-apply-source-secret-canary";
let registry = test_registry().await;
let storage_root = test_storage_root("openapi_apply_source_errors");
let app = build_test_app(registry.clone(), storage_root.clone());
let server = spawn_admin_api(app).await;
let client = authorized_client(&server).await;
let workspace_id = WorkspaceId::new("ws_default");
for (marker, expected_code, corrupt) in [
("missing", "openapi_upload.source_unavailable", false),
("corrupt", "openapi_upload.source_integrity", true),
] {
let document = format!("{OPENAPI}\n# {marker} {SOURCE_CANARY}");
let preview_response = client
.post(format!("{server}/imports/openapi/preview"))
.multipart(Form::new().part(
"file",
file_part(document.as_bytes(), "openapi.yaml", "application/yaml"),
))
.send()
.await
.unwrap();
assert_eq!(preview_response.status(), reqwest::StatusCode::OK);
let preview = preview_response.json::<Value>().await.unwrap();
let job_id: crank_registry::ImportJobId = preview["job_id"].as_str().unwrap().into();
let job = registry
.get_import_job(&workspace_id, &job_id)
.await
.unwrap()
.unwrap();
let artifact_ref: ArtifactRef = job.preview_payload["source"]["digest"]
.as_str()
.unwrap()
.parse()
.unwrap();
let path = artifact_path(&storage_root, &artifact_ref);
if corrupt {
std::fs::set_permissions(&path, std::os::unix::fs::PermissionsExt::from_mode(0o600))
.unwrap();
std::fs::write(&path, b"corrupt").unwrap();
std::fs::set_permissions(&path, std::os::unix::fs::PermissionsExt::from_mode(0o400))
.unwrap();
} else {
std::fs::remove_file(path).unwrap();
}
let response = client
.post(format!(
"{server}/imports/openapi/{}/create",
job_id.as_str()
))
.json(&serde_json::json!({
"selected_operation_keys": ["GET /health"],
"conflict_mode": "skip"
}))
.send()
.await
.unwrap();
let status = response.status();
let body = response.json::<Value>().await.unwrap();
assert_eq!(status, reqwest::StatusCode::UNPROCESSABLE_ENTITY, "{body}");
assert_eq!(body["error"]["code"], expected_code);
assert!(body["error"]["request_id"].is_string());
assert!(body["error"]["trace_id"].is_string());
let rendered = body.to_string();
assert!(!rendered.contains(SOURCE_CANARY));
assert!(!rendered.contains("source_id"));
assert!(!rendered.contains("digest"));
}
assert_eq!(
sqlx::query_scalar::<_, i64>("select count(*) from operations where workspace_id = $1")
.bind(workspace_id.as_str())
.fetch_one(registry.pool())
.await
.unwrap(),
0,
"source failures must not create operations"
);
}
#[tokio::test(flavor = "multi_thread")]
#[serial]
async fn missing_corrupt_changed_and_foreign_sources_create_no_drafts() {
let registry = test_registry().await;
let storage_root = test_storage_root("openapi_source_fail_closed");
let service = test_service(
registry.clone(),
storage_root.clone(),
test_auth_settings(),
test_secret_crypto(),
);
let workspace_id = WorkspaceId::new("ws_default");
let (missing_job, _, missing_ref) =
preview_job_source(&registry, &service, &workspace_id, "missing").await;
std::fs::remove_file(artifact_path(&storage_root, &missing_ref)).unwrap();
assert!(
apply_health_operation(&service, &workspace_id, &missing_job)
.await
.is_err()
);
let (corrupt_job, _, corrupt_ref) =
preview_job_source(&registry, &service, &workspace_id, "corrupt").await;
let corrupt_path = artifact_path(&storage_root, &corrupt_ref);
std::fs::set_permissions(
&corrupt_path,
std::os::unix::fs::PermissionsExt::from_mode(0o600),
)
.unwrap();
std::fs::write(&corrupt_path, b"corrupt-openapi-canary").unwrap();
std::fs::set_permissions(
&corrupt_path,
std::os::unix::fs::PermissionsExt::from_mode(0o400),
)
.unwrap();
assert!(
apply_health_operation(&service, &workspace_id, &corrupt_job)
.await
.is_err()
);
let (changed_job, _, _) =
preview_job_source(&registry, &service, &workspace_id, "changed").await;
sqlx::query(
"update import_jobs
set preview_payload = jsonb_set(
preview_payload,
'{source,digest}',
to_jsonb($1::text)
)
where id = $2",
)
.bind(format!("sha256:{}", "0".repeat(64)))
.bind(changed_job.as_str())
.execute(registry.pool())
.await
.unwrap();
assert!(
apply_health_operation(&service, &workspace_id, &changed_job)
.await
.is_err()
);
let now = OffsetDateTime::now_utc();
let foreign_workspace = WorkspaceId::new("ws_openapi_foreign");
registry
.create_workspace(CreateWorkspaceRequest {
workspace: &Workspace {
id: foreign_workspace.clone(),
slug: "openapi-foreign".to_owned(),
display_name: "OpenAPI Foreign".to_owned(),
status: WorkspaceStatus::Active,
settings: serde_json::json!({}),
created_at: now,
updated_at: now,
},
})
.await
.unwrap();
let (foreign_job, _, _) =
preview_job_source(&registry, &service, &workspace_id, "foreign").await;
sqlx::query("update import_jobs set workspace_id = $1 where id = $2")
.bind(foreign_workspace.as_str())
.bind(foreign_job.as_str())
.execute(registry.pool())
.await
.unwrap();
assert!(
apply_health_operation(&service, &foreign_workspace, &foreign_job)
.await
.is_err()
);
assert!(
service
.list_operations(&workspace_id)
.await
.unwrap()
.is_empty()
);
assert!(
service
.list_operations(&foreign_workspace)
.await
.unwrap()
.is_empty()
);
}
async fn preview_job_source(
registry: &crank_registry::PostgresRegistry,
service: &admin_api::service::AdminService,
workspace_id: &WorkspaceId,
marker: &str,
) -> (crank_registry::ImportJobId, ArtifactSourceId, ArtifactRef) {
let preview = service
.preview_openapi_import(
workspace_id,
OpenApiUpload {
bytes: format!("{OPENAPI}\n# {marker}").into_bytes(),
mime_type: "application/yaml".to_owned(),
locale: OpenApiUploadLocale::En,
},
)
.await
.unwrap();
let job_id: crank_registry::ImportJobId = preview.job_id.as_str().into();
let job = registry
.get_import_job(workspace_id, &job_id)
.await
.unwrap()
.unwrap();
let source = &job.preview_payload["source"];
(
job_id,
ArtifactSourceId::new(source["source_id"].as_str().unwrap()),
source["digest"].as_str().unwrap().parse().unwrap(),
)
}
fn artifact_path(root: &std::path::Path, artifact_ref: &ArtifactRef) -> std::path::PathBuf {
root.join("sha256")
.join(&artifact_ref.digest_hex()[..2])
.join(artifact_ref.digest_hex())
}
async fn apply_health_operation(
service: &admin_api::service::AdminService,
workspace_id: &WorkspaceId,
job_id: &crank_registry::ImportJobId,
) -> Result<admin_api::service::OpenApiImportCreateResponse, admin_api::error::ApiError> {
service
.create_openapi_import(
workspace_id,
job_id,
OpenApiImportCreatePayload {
selected_operation_keys: vec!["GET /health".to_owned()],
server_url: None,
conflict_mode: "skip".to_owned(),
},
)
.await
}
+14 -14
View File
@@ -87,20 +87,6 @@
font-weight: 600;
}
#openapi-import-document {
min-height: 132px;
max-height: 34vh;
resize: vertical;
padding: 14px;
border: 1px solid var(--border);
border-radius: 14px;
background: #0d1117;
color: var(--text-primary);
font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
font-size: 12px;
line-height: 1.55;
}
#openapi-import-file {
position: absolute;
width: 1px;
@@ -154,6 +140,20 @@
color: var(--red);
}
.openapi-import-status:focus-visible,
.openapi-file-button:focus-visible {
outline: 2px solid var(--accent);
outline-offset: 3px;
}
@media (prefers-reduced-motion: reduce) {
.openapi-import-modal,
.openapi-import-dialog {
scroll-behavior: auto;
transition: none;
}
}
.openapi-import-preview {
display: grid;
gap: 16px;
+27 -26
View File
@@ -92,7 +92,7 @@
<div class="page-header-actions">
<button class="btn-secondary openapi-import-trigger" @click="handleOpenApiImport()">
<svg width="13" height="13"><use href="icons/wizard/upload.svg#icon"/></svg>
<span>Импорт OpenAPI</span>
<span data-i18n="openapi.trigger">Импорт OpenAPI</span>
</button>
<button class="btn-new" @click="handleNewOperation()">
<svg width="13" height="13"><use href="icons/general/plus.svg#icon"/></svg>
@@ -382,10 +382,10 @@
<section class="openapi-import-dialog" role="dialog" aria-modal="true" aria-labelledby="openapi-import-title">
<div class="openapi-import-header">
<div>
<h2 id="openapi-import-title">Импорт OpenAPI</h2>
<p>Загрузите OpenAPI/Swagger документ, выберите методы и создайте черновики MCP-инструментов.</p>
<h2 id="openapi-import-title" data-i18n="openapi.title">Импорт OpenAPI</h2>
<p data-i18n="openapi.subtitle">Загрузите один OpenAPI/Swagger файл, выберите методы и создайте черновики MCP-инструментов.</p>
</div>
<button class="modal-close" type="button" data-openapi-close aria-label="Закрыть">
<button class="modal-close" type="button" data-openapi-close data-i18n-aria-label="openapi.close" aria-label="Закрыть">
<svg width="12" height="12" viewBox="0 0 12 12" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round">
<line x1="1" y1="1" x2="11" y2="11"></line><line x1="11" y1="1" x2="1" y2="11"></line>
</svg>
@@ -393,56 +393,57 @@
</div>
<div class="openapi-import-body">
<div class="openapi-import-upload">
<label class="openapi-file-label">
<span>Файл OpenAPI/Swagger</span>
<div class="openapi-file-label">
<span id="openapi-import-file-label" data-i18n="openapi.file.label">Файл OpenAPI/Swagger</span>
<span class="openapi-file-control">
<span class="btn-secondary openapi-file-button">Выбрать файл</span>
<button class="btn-secondary openapi-file-button" id="openapi-import-file-select" type="button" data-i18n="openapi.file.choose">Выбрать файл</button>
<span class="openapi-file-name" id="openapi-import-file-name">Файл не выбран</span>
</span>
<input id="openapi-import-file" type="file" accept=".yaml,.yml,.json,application/json,text/yaml">
</label>
<textarea id="openapi-import-document" spellcheck="false" placeholder="Вставьте openapi.yaml или swagger.json"></textarea>
<input id="openapi-import-file" type="file" aria-labelledby="openapi-import-file-label" accept=".yaml,.yml,.json,application/json,application/openapi+json,application/yaml,application/x-yaml,text/yaml,text/x-yaml" tabindex="-1">
</div>
<div class="openapi-import-actions">
<button class="btn-primary" id="openapi-import-preview" type="button">Разобрать документ</button>
<button class="btn-secondary" id="openapi-import-reset" type="button">Сбросить</button>
<button class="btn-primary" id="openapi-import-preview" type="button" data-i18n="openapi.preview">Разобрать документ</button>
<button class="btn-secondary" id="openapi-import-cancel" type="button" hidden data-i18n="openapi.cancel">Отменить</button>
<button class="btn-secondary" id="openapi-import-retry" type="button" hidden data-i18n="openapi.retry">Повторить</button>
<button class="btn-secondary" id="openapi-import-reset" type="button" data-i18n="openapi.reset">Сбросить</button>
</div>
</div>
<div class="openapi-import-status" id="openapi-import-status"></div>
<div class="openapi-import-status" id="openapi-import-status" role="status" aria-live="polite" aria-atomic="true" tabindex="-1"></div>
<div class="openapi-import-preview" id="openapi-import-preview-panel" hidden>
<div class="openapi-import-source" id="openapi-import-source"></div>
<div class="openapi-import-server-row">
<label for="openapi-import-server">Base URL</label>
<label for="openapi-import-server" data-i18n="openapi.server.label">Base URL</label>
<select id="openapi-import-server"></select>
<input id="openapi-import-server-custom" class="openapi-import-server-custom" type="url" placeholder="Или укажите свой base URL, например https://api.example.com">
<input id="openapi-import-server-custom" class="openapi-import-server-custom" type="url" data-i18n-aria-label="openapi.server.custom_aria" aria-label="Свой Base URL" data-i18n-ph="openapi.server.placeholder" placeholder="Или укажите свой base URL, например https://api.example.com">
</div>
<div class="openapi-import-server-row">
<label for="openapi-import-conflict-mode">Если операция уже существует</label>
<label for="openapi-import-conflict-mode" data-i18n="openapi.conflict.label">Если операция уже существует</label>
<select id="openapi-import-conflict-mode">
<option value="rename" selected>Создать копию с новым именем</option>
<option value="skip">Пропустить</option>
<option value="rename" selected data-i18n="openapi.conflict.rename">Создать копию с новым именем</option>
<option value="skip" data-i18n="openapi.conflict.skip">Пропустить</option>
</select>
</div>
<div class="openapi-import-toolbar">
<div class="openapi-import-filter">
<label for="openapi-import-search">Поиск методов</label>
<input id="openapi-import-search" type="search" placeholder="Название, operationId или путь">
<label for="openapi-import-search" data-i18n="openapi.search.label">Поиск методов</label>
<input id="openapi-import-search" type="search" data-i18n-ph="openapi.search.placeholder" placeholder="Название, operationId или путь">
</div>
<div class="openapi-import-filter">
<label for="openapi-import-method-filter">HTTP-метод</label>
<label for="openapi-import-method-filter" data-i18n="openapi.method.label">HTTP-метод</label>
<select id="openapi-import-method-filter">
<option value="">Все методы</option>
<option value="" data-i18n="openapi.method.all">Все методы</option>
</select>
</div>
<div class="openapi-import-bulk-actions">
<button class="btn-secondary" id="openapi-import-select-visible" type="button">Выбрать видимые</button>
<button class="btn-secondary" id="openapi-import-clear-visible" type="button">Снять видимые</button>
<button class="btn-secondary" id="openapi-import-select-visible" type="button" data-i18n="openapi.select_visible">Выбрать видимые</button>
<button class="btn-secondary" id="openapi-import-clear-visible" type="button" data-i18n="openapi.clear_visible">Снять видимые</button>
</div>
</div>
<div class="openapi-import-groups" id="openapi-import-groups"></div>
<div class="openapi-import-footer">
<span id="openapi-import-selection">Выбрано: 0</span>
<button class="btn-primary" id="openapi-import-create" type="button">Создать черновики</button>
<span id="openapi-import-selection" data-i18n="openapi.selection.empty">Выбрано: 0</span>
<button class="btn-primary" id="openapi-import-create" type="button" data-i18n="openapi.create">Создать черновики</button>
</div>
<div class="openapi-import-result" id="openapi-import-result" hidden></div>
</div>
+22 -6
View File
@@ -409,13 +409,29 @@
}
return result;
},
previewOpenApiImport: function(workspaceId, documentText) {
return post('/workspaces/' + encodeURIComponent(workspaceId) + '/imports/openapi/preview', {
document: documentText,
});
previewOpenApiImport: function(workspaceId, file, options) {
var form = new FormData();
form.append('file', file, file.name);
return request(
API_BASE + '/workspaces/' + encodeURIComponent(workspaceId) + '/imports/openapi/preview',
{
method: 'POST',
// Do not set Content-Type here: the browser owns the multipart boundary.
headers: headers({
'Accept-Language': localStorage.getItem('crank_lang') === 'ru' ? 'ru' : 'en',
}),
body: form,
signal: options && options.signal,
}
);
},
createOpenApiImport: function(workspaceId, jobId, payload) {
return post('/workspaces/' + encodeURIComponent(workspaceId) + '/imports/openapi/' + encodeURIComponent(jobId) + '/create', payload);
createOpenApiImport: function(workspaceId, jobId, payload, options) {
return request(API_BASE + '/workspaces/' + encodeURIComponent(workspaceId) + '/imports/openapi/' + encodeURIComponent(jobId) + '/create', {
method: 'POST',
headers: headers({ 'Content-Type': 'application/json' }),
body: JSON.stringify(payload),
signal: options && options.signal,
});
},
listAgents: function(workspaceId) {
return get('/workspaces/' + encodeURIComponent(workspaceId) + '/agents');
+160 -1
View File
@@ -2068,7 +2068,86 @@ var TRANSLATIONS = {
};
Object.assign(TRANSLATIONS.en, {
'openapi.trigger': 'Import OpenAPI',
'openapi.title': 'Import OpenAPI',
'openapi.subtitle': 'Upload one OpenAPI/Swagger file, select methods, and create MCP tool drafts.',
'openapi.close': 'Close',
'openapi.file.label': 'OpenAPI/Swagger file',
'openapi.file.choose': 'Choose file',
'openapi.file.none': 'No file selected',
'openapi.preview': 'Preview document',
'openapi.cancel': 'Cancel request',
'openapi.retry': 'Retry',
'openapi.reset': 'Reset',
'openapi.server.label': 'Base URL',
'openapi.server.custom_aria': 'Custom Base URL',
'openapi.server.placeholder': 'Or provide a base URL, for example https://api.example.com',
'openapi.server.later': 'Specify later',
'openapi.conflict.label': 'If an operation already exists',
'openapi.conflict.rename': 'Create a copy with a new name',
'openapi.conflict.skip': 'Skip it',
'openapi.search.label': 'Search methods',
'openapi.search.placeholder': 'Name, operationId, or path',
'openapi.method.label': 'HTTP method',
'openapi.method.all': 'All methods',
'openapi.select_visible': 'Select visible',
'openapi.clear_visible': 'Clear visible',
'openapi.create': 'Create drafts',
'openapi.selection.empty': 'Selected: 0',
'openapi.selection': 'Selected: {selected} of {total}, shown: {visible}',
'openapi.group.selection': 'selected {selected} of {total}, shown {visible}',
'openapi.group.select': 'Select group',
'openapi.operation.fields': 'inputs: {input} · outputs: {output}',
'openapi.mapping.path': 'Path',
'openapi.mapping.query': 'Query',
'openapi.mapping.header': 'Header',
'openapi.mapping.body': 'Body',
'openapi.mapping.response': 'Response',
'openapi.source.summary': '{name} · {size} · methods: {count}',
'openapi.status.file_ready': 'File is ready for preview.',
'openapi.status.previewing': 'Uploading and parsing the document…',
'openapi.status.preview_ready': 'Document is ready. Select methods to import.',
'openapi.status.creating': 'Creating drafts…',
'openapi.status.created': 'Created: {created}; skipped: {skipped}.',
'openapi.status.cancelled': 'Request cancelled.',
'openapi.status.context_changed': 'The request was cancelled because the context changed.',
'openapi.error.file_required': 'Choose an OpenAPI/Swagger file first.',
'openapi.error.file_type': 'Choose one .yaml, .yml, or .json file with a matching type.',
'openapi.error.file_empty': 'The selected file is empty.',
'openapi.error.file_large': 'The selected file is larger than 256 KiB.',
'openapi.error.no_methods': 'The document does not contain importable methods.',
'openapi.error.workspace': 'No workspace is selected.',
'openapi.error.preview': 'The document could not be previewed.',
'openapi.error.create': 'Drafts could not be created.',
'openapi.error.selection': 'Select at least one method.',
'openapi.error.preview_required': 'Preview the current file first.',
'openapi.error.server': 'Provide a base URL for the drafts.',
'openapi.error.malformed_multipart': 'The upload request is malformed. Choose the file again and retry.',
'openapi.error.invalid_utf8': 'The document must use UTF-8 encoding.',
'openapi.error.invalid_document': 'The selected file is not a valid OpenAPI document.',
'openapi.error.parser_unavailable': 'Document parsing is temporarily unavailable. Retry shortly.',
'openapi.error.storage_unavailable': 'Temporary import storage is unavailable. Retry shortly.',
'openapi.error.source_integrity': 'The uploaded document could not be verified. Choose the file again.',
'openapi.error.source_unavailable': 'The uploaded document is no longer available. Choose it again.',
'openapi.finding.missing_servers': 'No base URL was found in the document.',
'openapi.finding.multiple_servers': 'Several base URLs are available; choose one before creating drafts.',
'openapi.finding.unsupported_request_body': 'This request body needs review in the wizard.',
'openapi.finding.operation_name_renamed': 'The operation name was adjusted to keep it unique.',
'openapi.finding.operation_name_conflict': 'An operation with this name already exists.',
'openapi.finding.weak_tool_description': 'The tool description is too short.',
'openapi.finding.generic': 'This imported item needs review in the wizard.',
'openapi.correlation.request_id': 'Request ID: {id}',
'openapi.correlation.trace_id': 'Trace ID: {id}',
'openapi.result.title': 'Import result',
'openapi.result.open_first': 'Open first draft in the wizard',
'openapi.result.draft': 'Draft',
'openapi.result.findings': 'Findings',
'openapi.result.action': 'Action',
'openapi.result.no_findings': 'No critical findings',
'openapi.result.more': '+{count} more',
'openapi.result.fix': 'Fix in wizard',
'openapi.result.open': 'Open in wizard',
'openapi.result.skipped': 'Skipped',
});
@@ -2103,6 +2182,86 @@ Object.assign(TRANSLATIONS.ru, {
'execution.error.idempotency_in_progress': 'Операция с этим ключом уже выполняется.',
'execution.error.idempotency_conflict': 'Ключ идемпотентности использован с другими параметрами.',
'execution.error.idempotency_outcome_unknown': 'Результат предыдущего выполнения неизвестен; автоматический повтор запрещён.',
'openapi.trigger': 'Импорт OpenAPI',
'openapi.title': 'Импорт OpenAPI',
'openapi.subtitle': 'Загрузите один OpenAPI/Swagger файл, выберите методы и создайте черновики MCP-инструментов.',
'openapi.close': 'Закрыть',
'openapi.file.label': 'Файл OpenAPI/Swagger',
'openapi.file.choose': 'Выбрать файл',
'openapi.file.none': 'Файл не выбран',
'openapi.preview': 'Разобрать документ',
'openapi.cancel': 'Отменить запрос',
'openapi.retry': 'Повторить',
'openapi.reset': 'Сбросить',
'openapi.server.label': 'Base URL',
'openapi.server.custom_aria': 'Свой Base URL',
'openapi.server.placeholder': 'Или укажите свой base URL, например https://api.example.com',
'openapi.server.later': 'Указать позже',
'openapi.conflict.label': 'Если операция уже существует',
'openapi.conflict.rename': 'Создать копию с новым именем',
'openapi.conflict.skip': 'Пропустить',
'openapi.search.label': 'Поиск методов',
'openapi.search.placeholder': 'Название, operationId или путь',
'openapi.method.label': 'HTTP-метод',
'openapi.method.all': 'Все методы',
'openapi.select_visible': 'Выбрать видимые',
'openapi.clear_visible': 'Снять видимые',
'openapi.create': 'Создать черновики',
'openapi.selection.empty': 'Выбрано: 0',
'openapi.selection': 'Выбрано: {selected} из {total}, показано: {visible}',
'openapi.group.selection': 'выбрано {selected} из {total}, показано {visible}',
'openapi.group.select': 'Выбрать группу',
'openapi.operation.fields': 'входов: {input} · выходов: {output}',
'openapi.mapping.path': 'Path',
'openapi.mapping.query': 'Query',
'openapi.mapping.header': 'Header',
'openapi.mapping.body': 'Body',
'openapi.mapping.response': 'Ответ',
'openapi.source.summary': '{name} · {size} · методов: {count}',
'openapi.status.file_ready': 'Файл готов к разбору.',
'openapi.status.previewing': 'Загружаю и разбираю документ…',
'openapi.status.preview_ready': 'Документ готов. Выберите методы для импорта.',
'openapi.status.creating': 'Создаю черновики…',
'openapi.status.created': 'Создано: {created}; пропущено: {skipped}.',
'openapi.status.cancelled': 'Запрос отменён.',
'openapi.status.context_changed': 'Запрос отменён из-за изменения контекста.',
'openapi.error.file_required': 'Сначала выберите файл OpenAPI/Swagger.',
'openapi.error.file_type': 'Выберите один файл .yaml, .yml или .json с подходящим типом.',
'openapi.error.file_empty': 'Выбранный файл пуст.',
'openapi.error.file_large': 'Размер выбранного файла больше 256 KiB.',
'openapi.error.no_methods': 'В документе нет методов для импорта.',
'openapi.error.workspace': 'Не выбран workspace.',
'openapi.error.preview': 'Не удалось разобрать документ.',
'openapi.error.create': 'Не удалось создать черновики.',
'openapi.error.selection': 'Выберите хотя бы один метод.',
'openapi.error.preview_required': 'Сначала разберите текущий файл.',
'openapi.error.server': 'Укажите base URL для черновиков.',
'openapi.error.malformed_multipart': 'Запрос загрузки повреждён. Выберите файл заново и повторите попытку.',
'openapi.error.invalid_utf8': 'Документ должен быть в кодировке UTF-8.',
'openapi.error.invalid_document': 'Выбранный файл не является корректным документом OpenAPI.',
'openapi.error.parser_unavailable': 'Разбор документа временно недоступен. Повторите попытку позже.',
'openapi.error.storage_unavailable': 'Временное хранилище импорта недоступно. Повторите попытку позже.',
'openapi.error.source_integrity': 'Не удалось проверить загруженный документ. Выберите файл заново.',
'openapi.error.source_unavailable': 'Загруженный документ больше недоступен. Выберите его заново.',
'openapi.finding.missing_servers': 'В документе не найден base URL.',
'openapi.finding.multiple_servers': 'В документе несколько base URL; выберите один перед созданием черновиков.',
'openapi.finding.unsupported_request_body': 'Тело этого запроса нужно проверить в мастере.',
'openapi.finding.operation_name_renamed': 'Имя операции изменено, чтобы сохранить уникальность.',
'openapi.finding.operation_name_conflict': 'Операция с таким именем уже существует.',
'openapi.finding.weak_tool_description': 'Описание инструмента слишком короткое.',
'openapi.finding.generic': 'Этот импортированный элемент нужно проверить в мастере.',
'openapi.correlation.request_id': 'Request ID: {id}',
'openapi.correlation.trace_id': 'Trace ID: {id}',
'openapi.result.title': 'Результат импорта',
'openapi.result.open_first': 'Открыть первый черновик в мастере',
'openapi.result.draft': 'Черновик',
'openapi.result.findings': 'Замечания',
'openapi.result.action': 'Действие',
'openapi.result.no_findings': 'Критичных замечаний нет',
'openapi.result.more': '+{count} еще',
'openapi.result.fix': 'Исправить в мастере',
'openapi.result.open': 'Открыть в мастере',
'openapi.result.skipped': 'Пропущено',
});
File diff suppressed because it is too large Load Diff
+1
View File
@@ -5,6 +5,7 @@
"build": "node scripts/build.js",
"e2e:install": "playwright install chromium",
"e2e": "playwright test",
"e2e:openapi": "playwright test tests/e2e/operations.spec.js --workers=1",
"e2e:headed": "playwright test --headed"
},
"dependencies": {
+9 -3
View File
@@ -2,6 +2,14 @@ const { defineConfig, devices } = require('@playwright/test');
const baseURL = process.env.PLAYWRIGHT_BASE_URL || 'http://127.0.0.1:3300';
const skipWebServer = process.env.PLAYWRIGHT_SKIP_WEB_SERVER === '1';
const jsonOutput = process.env.PLAYWRIGHT_JSON_OUTPUT;
const reporters = process.env.CI
? [['github'], ['html', { open: 'never' }]]
: [['list'], ['html', { open: 'never' }]];
if (jsonOutput) {
reporters.push(['json', { outputFile: jsonOutput }]);
}
module.exports = defineConfig({
testDir: './tests/e2e',
@@ -12,9 +20,7 @@ module.exports = defineConfig({
timeout: 10_000,
},
retries: process.env.CI ? 1 : 0,
reporter: process.env.CI
? [['github'], ['html', { open: 'never' }]]
: [['list'], ['html', { open: 'never' }]],
reporter: reporters,
use: {
baseURL,
trace: 'on-first-retry',
+2 -1
View File
@@ -132,7 +132,8 @@ export CRANK_SESSION_TTL_HOURS="24"
export CRANK_BOOTSTRAP_ADMIN_EMAIL="$ADMIN_EMAIL"
export CRANK_BOOTSTRAP_ADMIN_DISPLAY_NAME="Crank E2E"
export CRANK_BASE_URL="http://127.0.0.1:$UI_PORT"
mkdir -p "$CRANK_STORAGE_ROOT"
mkdir -p -m 700 "$CRANK_STORAGE_ROOT"
chmod 700 "$CRANK_STORAGE_ROOT"
(
cd "$ROOT_DIR/apps/ui"
+374 -9
View File
@@ -1,6 +1,16 @@
const { test, expect } = require('@playwright/test');
const { login, localized, uniqueName } = require('./helpers');
async function dismissOnboardingIfOpen(page) {
await page.locator('#crank-onboarding-panel').waitFor({ state: 'attached' });
await page.locator('[data-testid="onboarding-dismiss"]').waitFor({ state: 'attached' });
await page.evaluate(() => {
const dismiss = document.querySelector('[data-testid="onboarding-dismiss"]');
if (dismiss) dismiss.click();
});
await expect(page.locator('#crank-onboarding-panel')).toBeHidden();
}
test('operations page shows demo catalog and filter works', async ({ page }) => {
await login(page);
await expect(page.locator('.page-heading')).toHaveText(localized('Operations', 'Операции'));
@@ -15,14 +25,20 @@ test('operations page shows demo catalog and filter works', async ({ page }) =>
test('operations page imports OpenAPI methods as drafts', async ({ page }) => {
await login(page);
await dismissOnboardingIfOpen(page);
const operationId = uniqueName('get_rates');
const statusOperationId = `${operationId}_status`;
await page.getByRole('button', { name: /Импорт OpenAPI/i }).click();
await page.getByRole('button', { name: localized('Import OpenAPI', 'Импорт OpenAPI') }).click();
await expect(page.locator('#openapi-import-modal')).toBeVisible();
await page.locator('#openapi-import-document').fill(`
const sourceCanary = 'openapi-source-canary-not-for-dom';
await page.locator('#openapi-import-file').setInputFiles({
name: 'demo-openapi.yaml',
mimeType: 'application/octet-stream',
buffer: Buffer.from(`
openapi: 3.0.3
info:
title: Demo Import API
description: ${sourceCanary}
servers:
paths:
/v1/rates/{date}:
@@ -76,8 +92,13 @@ paths:
type: object
properties:
status: { type: string }
`);
`),
});
const previewRequest = page.waitForRequest((request) => request.method() === 'POST'
&& request.url().includes('/imports/openapi/preview'));
await page.locator('#openapi-import-preview').click();
const request = await previewRequest;
expect(request.headers()['content-type']).toMatch(/^multipart\/form-data; boundary=/i);
await expect(page.locator('#openapi-import-preview-panel')).toBeVisible();
await expect(page.locator('.openapi-import-document-findings')).toContainText(/base URL/i);
await expect(page.locator('.openapi-import-group').filter({ hasText: 'currency' })).toBeVisible();
@@ -92,13 +113,13 @@ paths:
await expect(importedOperation.locator('.openapi-import-mapping-preview')).toContainText('X-API-Version');
await expect(importedOperation.locator('.openapi-import-mapping-preview')).toContainText('Body');
await expect(importedOperation.locator('.openapi-import-mapping-preview')).toContainText('symbols');
await expect(importedOperation.locator('.openapi-import-mapping-preview')).toContainText('Ответ');
await expect(page.locator('#openapi-import-selection')).toContainText('Выбрано: 2');
await expect(importedOperation.locator('.openapi-import-mapping-preview')).toContainText(localized('Response', 'Ответ'));
await expect(page.locator('#openapi-import-selection')).toContainText(localized('Selected: 2', 'Выбрано: 2'));
await page.locator('#openapi-import-search').fill('status');
await expect(page.locator('.openapi-import-operation:visible')).toHaveCount(1);
await expect(page.locator('.openapi-import-operation:visible').filter({ hasText: 'Проверить статус' })).toBeVisible();
await page.locator('#openapi-import-clear-visible').click();
await expect(page.locator('#openapi-import-selection')).toContainText('Выбрано: 1');
await expect(page.locator('#openapi-import-selection')).toContainText(localized('Selected: 1', 'Выбрано: 1'));
await page.locator('#openapi-import-search').fill('');
await page.locator('#openapi-import-method-filter').selectOption('POST');
await expect(page.locator('.openapi-import-operation:visible')).toHaveCount(1);
@@ -106,15 +127,359 @@ paths:
await page.locator('#openapi-import-method-filter').selectOption('');
await page.locator('#openapi-import-server-custom').fill('https://api.example.test');
await page.locator('#openapi-import-create').click();
await expect(page.locator('#openapi-import-result')).toContainText('Результат импорта');
await expect(page.locator('#openapi-import-result')).toContainText(localized('Import result', 'Результат импорта'));
await expect(page.locator('.openapi-import-result-table')).toBeVisible();
await expect(page.locator('.openapi-import-result-row').filter({ hasText: operationId })).toContainText('POST /v1/rates/{date}');
await expect(page.locator('.openapi-import-result-row').filter({ hasText: operationId })).toContainText(/Описание инструмента слишком короткое/);
await expect(page.locator('.openapi-import-result-row').filter({ hasText: operationId })).toContainText('Исправить в мастере');
await expect(page.locator('.openapi-import-result-row').filter({ hasText: operationId })).toContainText(localized('tool description is too short', 'Описание инструмента слишком короткое'));
await expect(page.locator('.openapi-import-result-row').filter({ hasText: operationId })).toContainText(localized('Fix in wizard', 'Исправить в мастере'));
await expect(page.locator('.openapi-import-primary-result a')).toHaveAttribute(
'href',
/\/wizard\/\?mode=edit&operationId=op_/
);
await expect(page.locator('tbody')).toContainText(new RegExp(operationId, 'i'));
await expect(page.locator('tbody')).not.toContainText(new RegExp(statusOperationId, 'i'));
await expect(page.locator('body')).not.toContainText(sourceCanary);
});
test('OpenAPI upload rejects invalid files locally and restores focus after Escape', async ({ page }) => {
await login(page);
await dismissOnboardingIfOpen(page);
const trigger = page.getByRole('button', { name: localized('Import OpenAPI', 'Импорт OpenAPI') });
await trigger.focus();
await trigger.click();
await expect(page.locator('#openapi-import-file-select')).toBeFocused();
await page.keyboard.press('Shift+Tab');
await expect(page.locator('[data-openapi-close]').last()).toBeFocused();
await page.keyboard.press('Shift+Tab');
await expect(page.locator('#openapi-import-reset')).toBeFocused();
await page.locator('#openapi-import-file-select').focus();
await expect(page.locator('#openapi-import-status')).toHaveAttribute('role', 'status');
await expect(page.locator('#openapi-import-status')).toHaveAttribute('aria-live', 'polite');
let previewRequests = 0;
page.on('request', (request) => {
if (request.url().includes('/imports/openapi/preview')) previewRequests += 1;
});
await page.locator('#openapi-import-preview').click();
expect(previewRequests).toBe(0);
const longFileName = `${'a'.repeat(130)}.yaml`;
await page.locator('#openapi-import-file').setInputFiles({
name: longFileName,
mimeType: 'application/yaml',
buffer: Buffer.from('openapi: 3.0.3'),
});
await expect(page.locator('#openapi-import-file-name')).toContainText('… · 14 B');
await page.evaluate(() => window.setLang('en'));
await expect(page.locator('#openapi-import-file-name')).toContainText('… · 14 B');
await expect(page.locator('#openapi-import-server-custom')).toHaveAttribute('aria-label', 'Custom Base URL');
await page.evaluate(() => window.setLang('ru'));
await expect(page.locator('#openapi-import-file-name')).toContainText('… · 14 B');
await expect(page.locator('#openapi-import-server-custom')).toHaveAttribute('aria-label', 'Свой Base URL');
const invalidFiles = [
{
file: { name: 'wrong-extension.txt', mimeType: 'application/yaml', buffer: Buffer.from('openapi: 3.0.3') },
message: localized('Choose one .yaml', 'Выберите один файл'),
},
{
file: { name: 'wrong-type.yaml', mimeType: 'text/plain', buffer: Buffer.from('openapi: 3.0.3') },
message: localized('matching type', 'подходящим типом'),
},
{
file: { name: 'empty.yaml', mimeType: 'application/yaml', buffer: Buffer.alloc(0) },
message: localized('file is empty', 'файл пуст'),
},
{
file: { name: 'too-large.yaml', mimeType: 'application/yaml', buffer: Buffer.alloc(256 * 1024 + 1, 'x') },
message: localized('larger than 256 KiB', 'больше 256 KiB'),
},
];
for (const invalid of invalidFiles) {
await page.locator('#openapi-import-file').setInputFiles(invalid.file);
await expect(page.locator('#openapi-import-status')).toContainText(invalid.message);
await expect(page.locator('#openapi-import-status')).toBeFocused();
await page.locator('#openapi-import-preview').click();
expect(previewRequests).toBe(0);
}
await page.keyboard.press('Escape');
await expect(trigger).toBeFocused();
});
test('OpenAPI upload recovers from pagehide and a preview server error', async ({ page }) => {
await login(page);
await dismissOnboardingIfOpen(page);
await page.getByRole('button', { name: localized('Import OpenAPI', 'Импорт OpenAPI') }).click();
let releasePreview;
const pendingPreview = new Promise((resolve) => {
releasePreview = resolve;
});
await page.route('**/imports/openapi/preview', async (route) => {
await pendingPreview;
try {
await route.fulfill({ status: 503, contentType: 'application/json', body: '{}' });
} catch (_error) {
// pagehide aborts the active request before the delayed route settles.
}
});
await page.locator('#openapi-import-file').setInputFiles({
name: 'resume.yaml',
mimeType: 'application/yaml',
buffer: Buffer.from('openapi: 3.0.3'),
});
await page.locator('#openapi-import-preview').click();
await expect(page.locator('#openapi-import-status')).toContainText(localized('Uploading and parsing', 'Загружаю и разбираю'));
await page.evaluate(() => window.dispatchEvent(new PageTransitionEvent('pagehide', { persisted: true })));
await expect(page.locator('#openapi-import-status')).toHaveText('');
await expect(page.locator('#openapi-import-cancel')).toBeHidden();
await page.evaluate(() => window.dispatchEvent(new PageTransitionEvent('pageshow', { persisted: true })));
await expect(page.locator('#openapi-import-retry')).toBeHidden();
await expect(page.locator('#openapi-import-file-name')).toContainText(localized('No file selected', 'Файл не выбран'));
await expect(page.locator('#openapi-import-status')).toContainText(localized('context changed', 'контекст изменился'));
releasePreview();
});
test('OpenAPI upload invalidates active draft creation after language or workspace changes', async ({ page }) => {
await login(page);
await dismissOnboardingIfOpen(page);
await page.getByRole('button', { name: localized('Import OpenAPI', 'Импорт OpenAPI') }).click();
await page.route('**/imports/openapi/preview', async (route) => {
await route.fulfill({
contentType: 'application/json',
body: JSON.stringify({
job_id: 'job_active_apply',
preview: {
source: { servers: ['https://api.example.test'] },
findings: [],
groups: [{
title: 'active apply',
operations: [{
key: 'get:/active', method: 'GET', path: '/active', suggested_name: 'active',
suggested_display_name: 'Active', input_fields: 0, output_fields: 0,
draft: { input_mapping: { rules: [] }, output_mapping: { rules: [] } }, findings: [],
}],
}],
},
}),
});
});
const releases = [];
await page.route('**/imports/openapi/*/create', async (route) => {
await new Promise((resolve) => releases.push(resolve));
try {
await route.fulfill({
contentType: 'application/json',
body: JSON.stringify({ created: [{ name: 'stale draft', operation_id: 'op_stale', version: 1 }], skipped: [], findings: [] }),
});
} catch (_error) {
// The invalidation aborts a request that must not update the modal afterwards.
}
});
async function beginApply(name) {
await page.locator('#openapi-import-file').setInputFiles({
name,
mimeType: 'application/yaml',
buffer: Buffer.from('openapi: 3.0.3'),
});
await page.locator('#openapi-import-preview').click();
await expect(page.locator('#openapi-import-preview-panel')).toBeVisible();
await page.locator('#openapi-import-server-custom').fill('https://api.example.test');
await page.locator('#openapi-import-create').click();
await expect(page.locator('#openapi-import-cancel')).toBeVisible();
await expect.poll(() => releases.length).toBeGreaterThan(0);
}
await beginApply('language-change.yaml');
await page.evaluate(() => {
window.dispatchEvent(new StorageEvent('storage', { key: 'crank_lang', newValue: 'en' }));
});
releases.shift()();
await expect(page.locator('#openapi-import-preview-panel')).toBeHidden();
await expect(page.locator('#openapi-import-result')).toBeHidden();
await expect(page.locator('#openapi-import-create')).toBeEnabled();
await beginApply('workspace-change.yaml');
await page.evaluate(() => {
window.dispatchEvent(new CustomEvent('crank:workspacechange', { detail: { id: 'workspace-after-apply' } }));
});
releases.shift()();
await expect(page.locator('#openapi-import-preview-panel')).toBeHidden();
await expect(page.locator('#openapi-import-result')).toBeHidden();
await expect(page.locator('#openapi-import-file-name')).toContainText('No file selected');
await expect(page.locator('#openapi-import-create')).toBeEnabled();
});
test('OpenAPI upload only renders the latest selected file and clears reset or close races', async ({ page }) => {
await login(page);
await dismissOnboardingIfOpen(page);
await page.getByRole('button', { name: localized('Import OpenAPI', 'Импорт OpenAPI') }).click();
await page.route('**/imports/openapi/preview', async (route) => {
const isFirst = route.request().postData().includes('first.yaml');
await new Promise((resolve) => setTimeout(resolve, isFirst ? 180 : 10));
try {
await route.fulfill({
contentType: 'application/json',
body: JSON.stringify({
job_id: isFirst ? 'job_first' : 'job_second',
preview: {
source: { servers: ['https://api.example.test'] },
findings: [],
groups: [{
title: isFirst ? 'first-only' : 'second-only',
operations: [{
key: isFirst ? 'get:/first' : 'get:/second',
method: 'GET',
path: isFirst ? '/first' : '/second',
suggested_name: isFirst ? 'first' : 'second',
suggested_display_name: isFirst ? 'First only' : 'Second only',
input_fields: 0,
output_fields: 0,
draft: { input_mapping: { rules: [] }, output_mapping: { rules: [] } },
findings: [],
}],
}],
},
}),
});
} catch (_error) {
// The browser intentionally aborts stale requests before this response settles.
}
});
await page.locator('#openapi-import-file').setInputFiles({
name: 'first.yaml',
mimeType: 'application/yaml',
buffer: Buffer.from('openapi: 3.0.3'),
});
await page.locator('#openapi-import-preview').click();
await expect(page.locator('#openapi-import-preview-panel')).toBeVisible();
await page.locator('#openapi-import-server-custom').fill('https://stale.example.test');
await page.locator('#openapi-import-file').setInputFiles({
name: 'second.yaml',
mimeType: 'application/yaml',
buffer: Buffer.from('openapi: 3.0.3'),
});
await expect(page.locator('#openapi-import-server-custom')).toHaveValue('');
await expect(page.locator('#openapi-import-server option')).toHaveCount(0);
await page.locator('#openapi-import-preview').click();
await expect(page.locator('.openapi-import-group')).toContainText('second-only');
await page.waitForTimeout(220);
await expect(page.locator('.openapi-import-group')).not.toContainText('first-only');
await page.locator('#openapi-import-file').setInputFiles({
name: 'third.yaml',
mimeType: 'application/yaml',
buffer: Buffer.from('openapi: 3.0.3'),
});
await page.locator('#openapi-import-preview').click();
await page.locator('#openapi-import-reset').click();
await page.waitForTimeout(220);
await expect(page.locator('#openapi-import-preview-panel')).toBeHidden();
await expect(page.locator('#openapi-import-file-name')).toContainText(localized('No file selected', 'Файл не выбран'));
await page.locator('#openapi-import-file').setInputFiles({
name: 'fourth.yaml',
mimeType: 'application/yaml',
buffer: Buffer.from('openapi: 3.0.3'),
});
await page.locator('#openapi-import-preview').click();
await page.keyboard.press('Escape');
await page.waitForTimeout(220);
await expect(page.locator('#openapi-import-modal')).toBeHidden();
});
test('OpenAPI upload ignores a stale failure and renders only correlation identifiers', async ({ page }) => {
await login(page);
await dismissOnboardingIfOpen(page);
await page.getByRole('button', { name: localized('Import OpenAPI', 'Импорт OpenAPI') }).click();
const sourceCanary = 'do-not-render-openapi-source-canary';
await page.locator('#openapi-import-file').setInputFiles({
name: 'safe.yaml',
mimeType: 'application/yaml',
buffer: Buffer.from(`openapi: 3.0.3\ninfo: { title: Safe, description: ${sourceCanary} }\npaths: { /health: { get: { responses: { '200': { description: OK } } } } }\n`),
});
let releaseStaleFailure;
const staleFailure = new Promise((resolve) => {
releaseStaleFailure = resolve;
});
await page.route('**/imports/openapi/preview', async (route) => {
await staleFailure;
await route.fulfill({
status: 400,
contentType: 'application/json',
headers: {
'x-request-id': 'req_ui_evidence_1',
'x-trace-id': '0123456789abcdef0123456789abcdef',
},
body: JSON.stringify({ error: { code: 'openapi_upload.invalid_document', message: 'Safe upload failure' } }),
});
});
await page.locator('#openapi-import-preview').click();
await expect(page.locator('#openapi-import-cancel')).toBeVisible();
await page.locator('#openapi-import-cancel').click({ force: true });
releaseStaleFailure();
await page.waitForTimeout(100);
await expect(page.locator('#openapi-import-status')).toContainText(localized('Request cancelled', 'Запрос отменён'));
await expect(page.locator('body')).not.toContainText(sourceCanary);
await page.unroute('**/imports/openapi/preview');
await page.route('**/imports/openapi/preview', async (route) => {
await route.fulfill({
status: 400,
contentType: 'application/json',
headers: {
'x-request-id': 'req_ui_evidence_2',
'x-trace-id': 'abcdef0123456789abcdef0123456789',
},
body: JSON.stringify({ error: { code: 'openapi_upload.invalid_document', message: 'Safe upload failure' } }),
});
});
await page.locator('#openapi-import-retry').click();
await expect(page.locator('#openapi-import-status')).toContainText(localized('not a valid OpenAPI document', 'не является корректным документом OpenAPI'));
await expect(page.locator('#openapi-import-status')).toBeFocused();
await expect(page.locator('#openapi-import-status')).toContainText('Request ID: req_ui_evidence_2');
await expect(page.locator('#openapi-import-status')).toContainText('Trace ID: abcdef0123456789abcdef0123456789');
await page.evaluate(() => window.setLang('en'));
await expect(page.locator('#openapi-import-title')).toHaveText('Import OpenAPI');
await page.unroute('**/imports/openapi/preview');
await page.route('**/imports/openapi/preview', async (route) => {
await route.fulfill({
contentType: 'application/json',
body: JSON.stringify({
job_id: 'job_ui_evidence',
preview: {
source: { servers: ['https://api.example.test'] },
findings: [],
groups: [{
title: 'evidence',
operations: [{
key: 'get:/health', method: 'GET', path: '/health', suggested_name: 'health',
suggested_display_name: 'Health', input_fields: 0, output_fields: 0,
draft: { input_mapping: { rules: [] }, output_mapping: { rules: [] } }, findings: [],
}],
}],
},
}),
});
});
await page.locator('#openapi-import-retry').click();
await expect(page.locator('#openapi-import-preview-panel')).toBeVisible();
let createRequests = 0;
await page.route('**/imports/openapi/*/create', async (route) => {
createRequests += 1;
await new Promise((resolve) => setTimeout(resolve, 100));
await route.fulfill({ contentType: 'application/json', body: JSON.stringify({ created: [], skipped: [], findings: [] }) });
});
await page.locator('#openapi-import-create').click();
await page.locator('#openapi-import-create').evaluate((button) => button.click());
await expect(page.locator('#openapi-import-status')).toContainText('Created: 0; skipped: 0.');
expect(createRequests).toBe(1);
});