// CLARA Web v0.8 demo: typed routes, persistent storage, proof-bearing writes.
route GET "/api/info" -> info;
route GET "/api/hello" -> hello;
route GET "/api/notes" auth -> notes;
route GET "/api/notes/:id" auth -> note;
route POST "/api/notes" -> createNote;
route DELETE "/api/notes/:id" -> deleteNote;
route GET "/api/fibonacci/:n" -> fibEndpoint;
route GET "/api/preview" -> preview;
route POST "/api/measure" -> measure;
route GET "/api/version/:id" auth -> version;
route PUT "/api/version/:id" -> updateVersion;
template "preview" = "
CLARA safe HTML{{title}}
{{message}}
CLARA templates automatically escape interpolated data.";
fn info(req: Request): Response {
return json(200, {
name: "CLARA Web", version: "1.0.0-rc.1",
compiler: "typed bytecode", execution: "capability-bound virtual machine",
storage: "SQLite / IndexedDB"
});
}
fn hello(req: Request): Response {
let name: String = query(req, "name", "world");
return json(200, {message: "Hello, " + name + "!", language: "CLARA"});
}
fn notes(req: Request): Response {
let items: Array = storeList("notes/");
return json(200, {items: items, count: len(items)});
}
fn note(req: Request): Response {
let id: String = path(req, "id", "");
let result: Any = storeGet("notes/" + id);
if result == null {
return json(404, {error: "Note not found"});
}
return json(200, {id: id, item: result});
}
fn createNote(req: Request): Response {
let title: String = bodyString(req, "title", "");
let content: String = bodyString(req, "content", "");
require(len(title) > 0 && len(title) <= 120, "Invalid title");
require(len(content) <= 8000, "Content too long");
let id: String = sha256(now() + title + content);
let item: Object = {title: title, content: content, createdAt: now()};
storePut("notes/" + id, item);
return json(201, {ok: true, id: id, item: item});
}
fn deleteNote(req: Request): Response {
let id: String = path(req, "id", "");
let deleted: Bool = storeDelete("notes/" + id);
return json(200, {ok: deleted});
}
fn fibonacci(n: Int): Int {
mut a: Int = 0;
mut b: Int = 1;
mut i: Int = 0;
while i < n {
let next: Int = a + b;
a = b;
b = next;
i = i + 1;
}
return a;
}
fn fibEndpoint(req: Request): Response {
let n: Int = int(path(req, "n", "10"));
require(n >= 0 && n <= 20, "n must be 0..20");
return json(200, {n: n, result: fibonacci(n)});
}
// HTML output is trusted template structure with escaped user content.
fn preview(req: Request): Response {
let name: String = query(req, "name", "visitor");
return render(200, "preview", {title: "CLARA HTML", message: "Welcome, " + name});
}
// Typed JSON fields: invalid types reject with HTTP 422 rather than silent coercion.
fn measure(req: Request): Response {
let count: Int = bodyInt(req, "count", 0);
let enabled: Bool = bodyBool(req, "enabled", false);
require(count >= 0 && count <= 100000, "count must be 0..100000");
return json(200, {count: count, enabled: enabled, doubled: count * 2});
}
// Optimistic concurrency: clients must provide the current revision.
fn version(req: Request): Response {
let id: String = path(req, "id", "");
return json(200, storeGetVersion("documents/" + id));
}
fn updateVersion(req: Request): Response {
let id: String = path(req, "id", "");
let revision: Int = bodyInt(req, "revision", -1);
let value: String = bodyString(req, "value", "");
require(revision >= 0 && len(value) <= 8000, "Invalid revision or value");
let accepted: Bool = storeComparePut("documents/" + id, revision, value);
if !accepted {return json(409, {ok: false, error: "Revision conflict"});}
return json(200, {ok: true, revision: revision + 1});
}
// Cron-only function. No HTTP route. Read-only by default.
fn maintenance(req: Request): Response {
let records: Array = storeList("notes/");
return json(200, {ok: true, sampledNotes: len(records), slot: bodyInt(req, "slot", 0)});
}