appstruct-codegen 0.2.0

Deterministic Rust, SQL, OpenAPI, TypeScript, and React generation for AppStruct
Documentation
use super::{error_response, response, schema_ref};
use serde_json::{Map, Value, json};

pub(super) fn add(
    paths: &mut Map<String, Value>,
    schemas: &mut Map<String, Value>,
    jobs_enabled: bool,
    webhooks_enabled: bool,
) {
    schemas.insert("AdminOverview".to_owned(), overview_schema());
    paths.insert("/api/admin/overview".to_owned(), overview_path());
    schemas.insert("AdminUser".to_owned(), user_schema());
    paths.insert("/api/admin/users".to_owned(), users_path());
    schemas.insert(
        "AdminSessionRevocation".to_owned(),
        session_revocation_schema(),
    );
    paths.insert(
        "/api/admin/users/{id}/revoke-sessions".to_owned(),
        revoke_sessions_path(),
    );
    if jobs_enabled {
        add_jobs(paths, schemas);
    }
    if webhooks_enabled {
        add_webhooks(paths, schemas);
    }
}

fn user_schema() -> Value {
    json!({
        "type": "object",
        "required": ["id", "email", "roles", "email_verified", "active_sessions", "created_at"],
        "properties": {
            "id": { "type": "string", "format": "uuid" },
            "email": { "type": "string", "format": "email" },
            "roles": { "type": "array", "items": { "type": "string" } },
            "email_verified": { "type": "boolean" },
            "active_sessions": { "type": "integer" },
            "created_at": { "type": "string", "format": "date-time" }
        }
    })
}

fn users_path() -> Value {
    json!({
        "get": {
            "operationId": "listAdminUsers", "tags": ["Admin"],
            "security": [{ "cookieSession": [] }, { "bearerToken": [] }],
            "parameters": [
                page_parameter(), page_size_parameter()
            ],
            "responses": {
                "200": response("Registered users", &admin_list_schema("AdminUser")),
                "400": error_response(), "401": error_response(), "403": error_response()
            }
        }
    })
}

fn session_revocation_schema() -> Value {
    json!({
        "type": "object",
        "required": ["revoked"],
        "properties": { "revoked": { "type": "integer", "minimum": 0 } }
    })
}

fn revoke_sessions_path() -> Value {
    json!({
        "post": {
            "operationId": "revokeAdminUserSessions", "tags": ["Admin"],
            "security": [{ "cookieSession": [] }, { "bearerToken": [] }],
            "parameters": [csrf_parameter(), { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }],
            "responses": {
                "200": response("User sessions revoked", &schema_ref("AdminSessionRevocation")),
                "400": error_response(), "401": error_response(), "403": error_response(), "404": error_response()
            }
        }
    })
}

fn overview_schema() -> Value {
    json!({
        "type": "object",
        "required": ["users", "organizations", "invitations", "sessions", "jobs_queued", "jobs_dead", "mail_deliveries", "files", "audit_events", "billing_events"],
        "properties": {
            "users": { "type": "integer" }, "organizations": { "type": "integer" },
            "invitations": { "type": "integer" }, "sessions": { "type": "integer" },
            "jobs_queued": { "type": "integer" }, "jobs_dead": { "type": "integer" },
            "mail_deliveries": { "type": "integer" }, "files": { "type": "integer" },
            "audit_events": { "type": "integer" }, "billing_events": { "type": "integer" }
        }
    })
}

fn overview_path() -> Value {
    json!({
        "get": {
            "operationId": "adminOverview", "tags": ["Admin"],
            "security": [{ "cookieSession": [] }, { "bearerToken": [] }],
            "responses": { "200": response("Operational overview", &schema_ref("AdminOverview")), "401": error_response(), "403": error_response() }
        }
    })
}

fn add_jobs(paths: &mut Map<String, Value>, schemas: &mut Map<String, Value>) {
    schemas.insert("AdminJob".to_owned(), job_schema());
    paths.insert("/api/admin/jobs".to_owned(), jobs_path());
    for (path, operation_id, description, status) in [
        (
            "/api/admin/jobs/{id}/retry",
            "retryAdminJob",
            "Dead job queued for retry",
            "200",
        ),
        (
            "/api/admin/jobs/{id}/replay",
            "replayAdminJob",
            "Terminal job copied into a new queued job",
            "201",
        ),
    ] {
        paths.insert(
            path.to_owned(),
            mutation_path(operation_id, description, status),
        );
    }
}

fn job_schema() -> Value {
    json!({
        "type": "object",
        "required": ["id", "queue", "kind", "status", "tenant_id", "attempts", "max_attempts", "run_at", "last_error", "created_at", "completed_at"],
        "properties": {
            "id": { "type": "string", "format": "uuid" },
            "queue": { "type": "string" }, "kind": { "type": "string" },
            "status": { "type": "string", "enum": ["queued", "running", "succeeded", "dead"] },
            "tenant_id": { "type": ["string", "null"], "format": "uuid" },
            "attempts": { "type": "integer" }, "max_attempts": { "type": "integer" },
            "run_at": { "type": "string", "format": "date-time" },
            "last_error": { "type": ["string", "null"] },
            "created_at": { "type": "string", "format": "date-time" },
            "completed_at": { "type": ["string", "null"], "format": "date-time" }
        }
    })
}

fn jobs_path() -> Value {
    json!({
        "get": {
            "operationId": "listAdminJobs", "tags": ["Admin"],
            "security": [{ "cookieSession": [] }, { "bearerToken": [] }],
            "parameters": [
                { "name": "status", "in": "query", "schema": { "type": "string", "enum": ["queued", "running", "succeeded", "dead"] } },
                page_parameter(), page_size_parameter()
            ],
            "responses": {
                "200": response("Recent jobs", &admin_list_schema("AdminJob")),
                "400": error_response(), "401": error_response(), "403": error_response(), "404": error_response()
            }
        }
    })
}

fn mutation_path(operation_id: &str, description: &str, status: &str) -> Value {
    json!({
        "post": {
            "operationId": operation_id, "tags": ["Admin"],
            "security": [{ "cookieSession": [] }, { "bearerToken": [] }],
            "parameters": [csrf_parameter(), { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }],
            "responses": {
                (status): response(description, &schema_ref("AdminJob")),
                "400": error_response(), "401": error_response(), "403": error_response(),
                "404": error_response(), "409": error_response()
            }
        }
    })
}

fn csrf_parameter() -> Value {
    json!({
        "name": "X-CSRF-Token", "in": "header", "required": true,
        "schema": { "type": "string" }
    })
}

fn add_webhooks(paths: &mut Map<String, Value>, schemas: &mut Map<String, Value>) {
    schemas.insert("AdminWebhookDelivery".to_owned(), webhook_schema());
    paths.insert("/api/admin/webhooks".to_owned(), webhooks_path());
    for (path, operation_id, description, status) in [
        (
            "/api/admin/webhooks/{id}/retry",
            "retryAdminWebhook",
            "Dead delivery queued for retry",
            "200",
        ),
        (
            "/api/admin/webhooks/{id}/replay",
            "replayAdminWebhook",
            "Terminal delivery copied into a new pending delivery",
            "201",
        ),
    ] {
        paths.insert(
            path.to_owned(),
            webhook_mutation_path(operation_id, description, status),
        );
    }
}

fn webhook_schema() -> Value {
    json!({
        "type": "object",
        "required": ["id", "endpoint", "event", "status", "tenant_id", "attempts", "max_attempts", "next_attempt_at", "response_status", "last_error", "created_at", "completed_at"],
        "properties": {
            "id": { "type": "string", "format": "uuid" },
            "endpoint": { "type": "string" }, "event": { "type": "string" },
            "status": { "type": "string", "enum": ["pending", "delivering", "succeeded", "dead"] },
            "tenant_id": { "type": ["string", "null"], "format": "uuid" },
            "attempts": { "type": "integer" }, "max_attempts": { "type": "integer" },
            "next_attempt_at": { "type": "string", "format": "date-time" },
            "response_status": { "type": ["integer", "null"] },
            "last_error": { "type": ["string", "null"] },
            "created_at": { "type": "string", "format": "date-time" },
            "completed_at": { "type": ["string", "null"], "format": "date-time" }
        }
    })
}

fn webhooks_path() -> Value {
    json!({
        "get": {
            "operationId": "listAdminWebhooks", "tags": ["Admin"],
            "security": [{ "cookieSession": [] }, { "bearerToken": [] }],
            "parameters": [
                { "name": "status", "in": "query", "schema": { "type": "string", "enum": ["pending", "delivering", "succeeded", "dead"] } },
                page_parameter(), page_size_parameter()
            ],
            "responses": {
                "200": response("Recent webhook deliveries", &admin_list_schema("AdminWebhookDelivery")),
                "400": error_response(), "401": error_response(), "403": error_response(), "404": error_response()
            }
        }
    })
}

fn page_parameter() -> Value {
    json!({ "name": "page", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 10000, "default": 1 } })
}

fn page_size_parameter() -> Value {
    json!({ "name": "page_size", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 25 } })
}

fn admin_list_schema(item: &str) -> Value {
    json!({
        "type": "object",
        "required": ["data", "meta"],
        "properties": {
            "data": { "type": "array", "items": schema_ref(item) },
            "meta": {
                "type": "object",
                "required": ["page", "page_size", "total"],
                "properties": {
                    "page": { "type": "integer", "minimum": 1 },
                    "page_size": { "type": "integer", "minimum": 1, "maximum": 100 },
                    "total": { "type": "integer", "minimum": 0 }
                }
            }
        }
    })
}

fn webhook_mutation_path(operation_id: &str, description: &str, status: &str) -> Value {
    json!({
        "post": {
            "operationId": operation_id, "tags": ["Admin"],
            "security": [{ "cookieSession": [] }, { "bearerToken": [] }],
            "parameters": [csrf_parameter(), { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }],
            "responses": {
                (status): response(description, &schema_ref("AdminWebhookDelivery")),
                "400": error_response(), "401": error_response(), "403": error_response(),
                "404": error_response(), "409": error_response()
            }
        }
    })
}