vika-cli 1.4.0

Generate TypeScript types, Zod schemas, and Fetch-based API clients from OpenAPI/Swagger specifications
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

use serde::Serialize;

/// Context for Zod schema generation.
#[derive(Debug, Clone, Serialize)]
pub struct ZodContext {
    pub schema_name: String,
    pub zod_expr: String,
    pub is_enum: bool,
    pub enum_values: Option<Vec<String>>,
    pub description: Option<String>,
    pub needs_type_annotation: bool,
    /// Spec name (for multi-spec mode)
    pub spec_name: Option<String>,
}

impl ZodContext {
    /// Create a new ZodContext for a regular schema.
    pub fn schema(
        schema_name: String,
        zod_expr: String,
        description: Option<String>,
        spec_name: Option<String>,
    ) -> Self {
        Self {
            schema_name,
            zod_expr,
            is_enum: false,
            enum_values: None,
            description,
            needs_type_annotation: false,
            spec_name,
        }
    }

    /// Create a new ZodContext for a schema that needs type annotation (e.g., circular references).
    pub fn schema_with_annotation(
        schema_name: String,
        zod_expr: String,
        description: Option<String>,
        spec_name: Option<String>,
    ) -> Self {
        Self {
            schema_name,
            zod_expr,
            is_enum: false,
            enum_values: None,
            description,
            needs_type_annotation: true,
            spec_name,
        }
    }

    /// Create a new ZodContext for an enum schema.
    pub fn enum_schema(
        schema_name: String,
        enum_values: Vec<String>,
        spec_name: Option<String>,
    ) -> Self {
        let enum_values_str = enum_values
            .iter()
            .map(|v| format!("\"{}\"", v))
            .collect::<Vec<_>>()
            .join(", ");
        let zod_expr = format!("z.enum([{}])", enum_values_str);

        Self {
            schema_name,
            zod_expr,
            is_enum: true,
            enum_values: Some(enum_values),
            description: None,
            needs_type_annotation: false,
            spec_name,
        }
    }
}