Skip to main content
v0.2.3

API Reference

Complete documentation for the Lesan framework.
Explore server APIs, models, queries, types, and cross-platform guides.

⌘K
Explore

API Sections

Jump into any section of the API documentation.

🖥️

Server API

Server setup, actions, context, and CORS configuration.

Core
🗂️

Models & ODM

Schemas, relations, CRUD operations, and hooks.

Data
🔍

Queries & Projections

Client-driven projections, aggregation, and filtering.

Query
🔷

Type System

Generated types, Superstruct integration, and inference.

Types
🌐

Cross-Platform

Node.js, Bun, and Deno support with runtime adapters.

Runtime
🚀

Quick Start

Get up and running with Lesan in 5 minutes.

Guide
Example

Quick Start

Define models and actions in a few lines of code.

example.ts
import { lesan } from "@hemedani/lesan";
// Define a model
const user = core.odm.newModel("user", {
  name: string(),
  email: string(),
});
// Create an action
const createUser = core.acts.setAct("user", "create", {
  validator: user.schemaInp(),
  fn: async ({ body }) => {
    return await user.insertOne(body);
  },
});
// Run the server
await core.runServer({ port: 1366 });

Installation

Install Lesan via your preferred package manager.

bash
npm install @hemedani/lesan

Requirements

  • ✓ Node.js 18+ / Bun 1.0+ / Deno 1.35+
  • ✓ TypeScript 5.0+
  • ✓ MongoDB 5.0+

Latest Updates

v0.2.3New query engine, improved type inference, Deno Deploy support.
v1.9Bun adapter optimizations, relation hooks.
View full changelog →

Ready to dive deeper?

Start with the Quick Start guide or explore the full API reference.

Get StartedView on GitHub