feat MET-12: Generate TypeScript type definitions from jsonschema (#45)

* Generate TypeScript type definitions from jsonschema

* Drop old type definitions

Cargo.toml

@@ -1,5 +1,11 @@
 [workspace]
-members = ["typegate/native", "meta-cli", "libs/common", "libs/xtask"]
+members = [
+  "typegate/native",
+  "meta-cli",
+  "libs/common",
+  "libs/typescript",
+  "libs/xtask",
+]
 
 [patch.crates-io]
 # https://github.com/prisma/quaint/issues/392

libs/common/src/typegraph.rs

@@ -12,10 +12,8 @@ use std::collections::HashMap;
 #[derive(Serialize, Deserialize, Debug)]
 pub struct Typegraph {
     pub types: Vec<TypeNode>,
-    #[serde(default)]
     pub materializers: Vec<Materializer>,
     pub runtimes: Vec<TGRuntime>,
-    #[serde(default)]
     pub policies: Vec<Policy>,
     pub meta: TypeMeta,
 }
@@ -26,15 +24,26 @@ pub struct Cors {
     pub allow_origin: Vec<String>,
     pub allow_headers: Vec<String>,
     pub expose_headers: Vec<String>,
+    #[serde(default)]
+    pub allow_methods: Vec<String>,
     pub allow_credentials: bool,
     pub max_age: Option<u32>,
 }
 
+#[cfg_attr(feature = "codegen", derive(JsonSchema))]
+#[derive(Serialize, Deserialize, Debug)]
+#[serde(rename_all = "lowercase")]
+pub enum AuthProtocol {
+    OAuth2,
+    Jwk,
+    Basic,
+}
+
 #[cfg_attr(feature = "codegen", derive(JsonSchema))]
 #[derive(Serialize, Deserialize, Debug)]
 pub struct Auth {
     pub name: String,
-    pub protocol: String,
+    pub protocol: AuthProtocol,
     pub auth_data: HashMap<String, Value>,
 }
 
@@ -69,10 +78,10 @@ pub struct TypeNodeBase {
     pub description: Option<String>,
     #[serde(default)]
     pub injection: Option<String>,
-    #[serde(default)]
-    pub inject: Option<serde_json::Value>,
+    #[serde(default, skip_serializing_if = "serde_json::Value::is_null")]
+    pub inject: Value,
     #[serde(default, rename = "enum")]
-    pub enum_: Option<Vec<serde_json::Value>>,
+    pub enum_: Option<Vec<Value>>,
     #[serde(default)]
     pub config: HashMap<String, serde_json::Value>,
 }

libs/typescript/Cargo.toml

@@ -0,0 +1,20 @@
+[package]
+name = "typescript"
+version = "0.0.3-dev.0"
+edition = "2021"
+
+[dependencies]
+anyhow = "1.0.68"
+swc_common = { version = "0.29.10", features = ["tty-emitter"] }
+swc_ecma_ast = "0.94.14"
+swc_ecmascript = { version = "0.205.47", features = [
+  "visit",
+  "transforms",
+  "typescript-parser",
+  "parser",
+  "codegen",
+] }
+swc_ecma_transforms = { version = "0.198.26", features = ["typescript"] }
+string_cache = "0.8.4"
+dprint-plugin-typescript = "0.80.2"
+lazy_static = "1.4.0"

libs/typescript/src/lib.rs

@@ -0,0 +1,32 @@
+// Copyright Metatype OÜ under the Elastic License 2.0 (ELv2). See LICENSE.md for usage.
+
+pub mod parser;
+
+pub use dprint_plugin_typescript as dprint_plugin;
+pub use string_cache;
+pub use swc_common;
+pub use swc_ecma_ast as ast;
+pub use swc_ecmascript::*;
+
+use anyhow::Result;
+use dprint_plugin::configuration::Configuration;
+use lazy_static::lazy_static;
+use std::path::Path;
+
+lazy_static! {
+    static ref TS_FORMAT_CONFIG: Configuration = {
+        use dprint_plugin_typescript::configuration::*;
+        ConfigurationBuilder::new()
+            .line_width(80)
+            .prefer_hanging(true)
+            .prefer_single_line(false)
+            .next_control_flow_position(NextControlFlowPosition::SameLine)
+            .union_and_intersection_type_prefer_hanging(false)
+            .union_and_intersection_type_prefer_single_line(false)
+            .build()
+    };
+}
+
+pub fn format_text<P: AsRef<Path>>(path: P, source: &str) -> Result<String> {
+    Ok(dprint_plugin::format_text(path.as_ref(), source, &TS_FORMAT_CONFIG)?.unwrap())
+}

meta-cli/src/ts/parser.rs → libs/typescript/src/parser.rs

@@ -226,7 +226,7 @@ where
 
 /// Parses a string as a TypeScript module and
 /// generates its [`Module`] and [`SourceMap`].
-fn parse_module_source(source: String) -> Result<(Module, Lrc<SourceMap>)> {
+pub fn parse_module_source(source: String) -> Result<(Module, Lrc<SourceMap>)> {
     let cm: Lrc<SourceMap> = Default::default();
     let handler = Handler::with_tty_emitter(ColorConfig::Auto, true, false, Some(cm.clone()));
 

libs/xtask/Cargo.toml

@@ -3,11 +3,11 @@ name = "xtask"
 version = "0.0.3-dev.0"
 edition = "2021"
 
-# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
-
 [dependencies]
 anyhow = "1.0.68"
 clap = { version = "4.0.32", features = ["derive"] }
 common = { path = "../common", features = ["codegen"] }
+typescript = { path = "../typescript" }
 schemars = { version = "0.8.11", features = [] }
 serde_json = "1.0.91"
+project-root = "0.2.2"

libs/xtask/src/codegen/jsonschema.rs

@@ -21,6 +21,7 @@ pub fn run() -> Result<()> {
         .create(true)
         .open(path)
         .context("Opening the output file")?;
+    file.set_len(0)?;
     let schema = schema_for!(Typegraph);
     serde_json::to_writer_pretty(&mut file, &schema)?;
     writeln!(file)?;

libs/xtask/src/codegen/mod.rs

@@ -1,6 +1,7 @@
 // Copyright Metatype OÜ under the Elastic License 2.0 (ELv2). See LICENSE.md for usage.
 
 mod jsonschema;
+mod typescript;
 
 use anyhow::Result;
 use clap::Parser;
@@ -12,7 +13,10 @@ pub struct Codegen {
 
 type CodegenEntry = (&'static str, fn() -> Result<()>);
 
-const CODEGEN_ENTRIES: &[CodegenEntry] = &[("jsonschema", jsonschema::run)];
+const CODEGEN_ENTRIES: &[CodegenEntry] = &[
+    ("jsonschema", jsonschema::run),
+    ("typescript", typescript::run),
+];
 
 impl Codegen {
     pub fn run(&self) -> Result<()> {