barbacane-compiler 0.7.0

Compiles OpenAPI/AsyncAPI specs into .bca artifacts
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77

use serde::{Deserialize, Serialize};
use thiserror::Error;

/// A warning produced during compilation (non-blocking).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct CompileWarning {
    /// Warning code (e.g., "E1015").
    pub code: String,
    /// Warning message.
    pub message: String,
    /// Location in the spec (e.g., "GET /users in 'api.yaml'").
    pub location: Option<String>,
}

/// Errors produced during compilation.
#[derive(Debug, Error)]
pub enum CompileError {
    /// Spec parsing failed.
    #[error(transparent)]
    Parse(#[from] crate::spec_parser::ParseError),

    /// E1010: Routing conflict.
    #[error("E1010: routing conflict: {0}")]
    RoutingConflict(String),

    /// E1020: Operation has no dispatcher.
    #[error("E1020: operation has no x-barbacane-dispatch: {0}")]
    MissingDispatch(String),

    /// E1031: Plaintext HTTP upstream URL in production mode.
    #[error("E1031: plaintext HTTP upstream URL not allowed in production: {0}")]
    PlaintextUpstream(String),

    /// E1040: Plugin used in spec but not declared in manifest.
    #[error("E1040: plugin '{0}' used in spec but not declared in barbacane.yaml")]
    UndeclaredPlugin(String),

    /// E1011: Middleware entry missing required 'name' field.
    #[error("E1011: middleware missing 'name': {0}")]
    MissingMiddlewareName(String),

    /// E1050: Ambiguous route - paths are structurally equivalent but differ in parameter names.
    #[error("E1050: ambiguous route: {0}")]
    AmbiguousRoute(String),

    /// E1051: Schema exceeds maximum nesting depth.
    #[error("E1051: schema too deep: {0}")]
    SchemaTooDeep(String),

    /// E1052: Schema exceeds maximum property count.
    #[error("E1052: schema too complex: {0}")]
    SchemaTooComplex(String),

    /// E1054: Invalid path template syntax.
    #[error("E1054: invalid path template: {0}")]
    InvalidPathTemplate(String),

    /// E1055: Duplicate operationId across specs.
    #[error("E1055: duplicate operationId '{0}': {1}")]
    DuplicateOperationId(String, String),

    /// Manifest parsing or loading error.
    #[error("manifest error: {0}")]
    ManifestError(String),

    /// Plugin resolution error (loading WASM bytes).
    #[error("plugin resolution error: {0}")]
    PluginResolution(String),

    /// I/O error.
    #[error("I/O error: {0}")]
    Io(#[from] std::io::Error),

    /// JSON serialization error.
    #[error("JSON error: {0}")]
    Json(#[from] serde_json::Error),
}