aver-lang 0.15.0

VM and transpiler for Aver, a statically-typed language designed for AI-assisted development
Documentation
use std::collections::HashMap;
use std::sync::Arc as Rc;

use aver_rt::{AverList, AverStr, HttpHeaders, HttpRequest, HttpResponse};

use crate::nan_value::{Arena, NanValue};
use crate::value::{RuntimeError, Value, list_from_vec, list_view};

pub fn register(global: &mut HashMap<String, Value>) {
    let mut members = HashMap::new();
    members.insert(
        "listen".to_string(),
        Value::Builtin("HttpServer.listen".to_string()),
    );
    members.insert(
        "listenWith".to_string(),
        Value::Builtin("HttpServer.listenWith".to_string()),
    );
    global.insert(
        "HttpServer".to_string(),
        Value::Namespace {
            name: "HttpServer".to_string(),
            members,
        },
    );
}

pub fn register_nv(global: &mut HashMap<String, NanValue>, arena: &mut Arena) {
    let mut members: Vec<(Rc<str>, NanValue)> = Vec::with_capacity(2);
    let idx1 = arena.push_builtin("HttpServer.listen");
    members.push((Rc::from("listen"), NanValue::new_builtin(idx1)));
    let idx2 = arena.push_builtin("HttpServer.listenWith");
    members.push((Rc::from("listenWith"), NanValue::new_builtin(idx2)));
    let ns_idx = arena.push(crate::nan_value::ArenaEntry::Namespace {
        name: Rc::from("HttpServer"),
        members,
    });
    global.insert("HttpServer".to_string(), NanValue::new_namespace(ns_idx));
}

pub const DECLARED_EFFECTS: &[&str] = &["HttpServer.listen", "HttpServer.listenWith"];

pub fn effects(name: &str) -> &'static [&'static str] {
    match name {
        "HttpServer.listen" => &["HttpServer.listen"],
        "HttpServer.listenWith" => &["HttpServer.listenWith"],
        "SelfHostRuntime.httpServerListen" => &["HttpServer.listen"],
        "SelfHostRuntime.httpServerListenWith" => &["HttpServer.listenWith"],
        _ => &[],
    }
}

pub fn call(_name: &str, _args: &[Value]) -> Option<Result<Value, RuntimeError>> {
    None
}

pub fn call_with_runtime<F>(
    name: &str,
    args: &[Value],
    mut invoke_handler: F,
    skip_server: bool,
) -> Option<Result<Value, RuntimeError>>
where
    F: FnMut(Value, Vec<Value>, String) -> Result<Value, RuntimeError>,
{
    match name {
        "HttpServer.listen" => Some(listen(args, false, &mut invoke_handler, skip_server)),
        "HttpServer.listenWith" => Some(listen(args, true, &mut invoke_handler, skip_server)),
        "SelfHostRuntime.httpServerListen" => {
            Some(listen(args, false, &mut invoke_handler, skip_server))
        }
        "SelfHostRuntime.httpServerListenWith" => {
            Some(listen(args, true, &mut invoke_handler, skip_server))
        }
        _ => None,
    }
}

fn listen<F>(
    args: &[Value],
    with_context: bool,
    invoke_handler: &mut F,
    skip_server: bool,
) -> Result<Value, RuntimeError>
where
    F: FnMut(Value, Vec<Value>, String) -> Result<Value, RuntimeError>,
{
    let expected = if with_context { 3 } else { 2 };
    if args.len() != expected {
        let sig = if with_context {
            "HttpServer.listenWith(port, context, handler)"
        } else {
            "HttpServer.listen(port, handler)"
        };
        return Err(RuntimeError::Error(format!(
            "{} expects {} arguments, got {}",
            sig,
            expected,
            args.len()
        )));
    }

    if skip_server {
        return Ok(Value::Unit);
    }

    let port = match &args[0] {
        Value::Int(n) if (0..=65535).contains(n) => *n,
        Value::Int(n) => {
            return Err(RuntimeError::Error(format!(
                "HttpServer.listen: port {} is out of range (0-65535)",
                n
            )));
        }
        _ => {
            return Err(RuntimeError::Error(
                "HttpServer.listen: port must be an Int".to_string(),
            ));
        }
    };
    let handler = if with_context {
        args[2].clone()
    } else {
        args[1].clone()
    };

    let result = if with_context {
        let context = args[1].clone();
        aver_rt::http_server::listen_with(port, context, |ctx, request| {
            dispatch_handler(&handler, Some(ctx), request, invoke_handler)
        })
    } else {
        aver_rt::http_server::listen(port, |request| {
            dispatch_handler(&handler, None, request, invoke_handler)
        })
    };

    result.map_err(RuntimeError::Error)?;
    Ok(Value::Unit)
}

fn dispatch_handler<F>(
    handler: &Value,
    context: Option<Value>,
    request: HttpRequest,
    invoke_handler: &mut F,
) -> HttpResponse
where
    F: FnMut(Value, Vec<Value>, String) -> Result<Value, RuntimeError>,
{
    let callback_entry = format!("<HttpServer {} {}>", &*request.method, &*request.path);
    let mut callback_args = Vec::new();
    if let Some(ctx) = context {
        callback_args.push(ctx);
    }
    callback_args.push(http_request_to_value(request));

    let callback_result = invoke_handler(handler.clone(), callback_args, callback_entry);
    match callback_result {
        Ok(value) => match http_response_from_value(value) {
            Ok(resp) => resp,
            Err(e) => HttpResponse {
                status: 500,
                body: aver_rt::AverStr::from(format!("HttpServer handler return error: {}", e)),
                headers: HttpHeaders::default(),
            },
        },
        Err(e) => HttpResponse {
            status: 500,
            body: aver_rt::AverStr::from(format!("HttpServer handler execution error: {}", e)),
            headers: HttpHeaders::default(),
        },
    }
}

fn http_request_to_value(req: HttpRequest) -> Value {
    let mut headers = HashMap::new();
    for (name, values) in req.headers.iter() {
        let value_list: Vec<Value> = values.iter().map(|v| Value::Str(v.to_string())).collect();
        headers.insert(Value::Str(name.to_string()), list_from_vec(value_list));
    }

    Value::Record {
        type_name: "HttpRequest".to_string(),
        fields: vec![
            ("method".to_string(), Value::Str(req.method.to_string())),
            ("path".to_string(), Value::Str(req.path.to_string())),
            ("body".to_string(), Value::Str(req.body.to_string())),
            ("headers".to_string(), Value::Map(headers)),
        ]
        .into(),
    }
}

fn http_response_from_value(val: Value) -> Result<HttpResponse, RuntimeError> {
    let (type_name, fields) = match val {
        Value::Record { type_name, fields } => (type_name, fields),
        _ => {
            return Err(RuntimeError::Error(
                "HttpServer handler must return HttpResponse record".to_string(),
            ));
        }
    };

    if type_name != "HttpResponse" {
        return Err(RuntimeError::Error(format!(
            "HttpServer handler must return HttpResponse, got {}",
            type_name
        )));
    }

    let mut status = None;
    let mut body = None;
    let mut headers = HttpHeaders::default();

    for (name, value) in fields.iter() {
        match name.as_str() {
            "status" => {
                if let Value::Int(n) = value {
                    status = Some(*n);
                } else {
                    return Err(RuntimeError::Error(
                        "HttpResponse.status must be Int".to_string(),
                    ));
                }
            }
            "body" => {
                if let Value::Str(s) = value {
                    body = Some(aver_rt::AverStr::from(s.as_str()));
                } else {
                    return Err(RuntimeError::Error(
                        "HttpResponse.body must be String".to_string(),
                    ));
                }
            }
            "headers" => {
                headers = parse_http_response_headers(value.clone())?;
            }
            _ => {}
        }
    }

    Ok(HttpResponse {
        status: status
            .ok_or_else(|| RuntimeError::Error("HttpResponse.status is required".to_string()))?,
        body: body
            .ok_or_else(|| RuntimeError::Error("HttpResponse.body is required".to_string()))?,
        headers,
    })
}

fn parse_http_response_headers(val: Value) -> Result<HttpHeaders, RuntimeError> {
    let map = match val {
        Value::Map(m) => m,
        _ => {
            return Err(RuntimeError::Error(
                "HttpResponse.headers must be Map<String, List<String>>".to_string(),
            ));
        }
    };

    let mut out = HttpHeaders::default();
    for (k, v) in map.into_iter() {
        let name = match k {
            Value::Str(s) => s.to_ascii_lowercase(),
            _ => {
                return Err(RuntimeError::Error(
                    "HttpResponse.headers keys must be Strings".to_string(),
                ));
            }
        };
        let values = list_view(&v).ok_or_else(|| {
            RuntimeError::Error("HttpResponse.headers values must be List<String>".to_string())
        })?;
        let mut buf = Vec::new();
        for item in values.iter() {
            match item {
                Value::Str(s) => buf.push(AverStr::from(s.as_str())),
                _ => {
                    return Err(RuntimeError::Error(
                        "HttpResponse.headers values must be Strings".to_string(),
                    ));
                }
            }
        }
        out = out.insert(AverStr::from(name), AverList::from_vec(buf));
    }

    Ok(out)
}