Isomorphic Toolchain
What it is
Section titled “What it is”The Isomorphic Toolchain (Aether-Lens) is a Visual Studio Code extension that turns the editor into a workbench for AetheriusDB development. Type-aware code completion, inline error squiggles, and a sidebar tree that mirrors the live database catalog all come from a built-in language server. You can drag a table from the sidebar straight into your script and have its columns inserted and type-checked against the catalog as you type.
Behind the editor sits the isomorphic compiler: a single tool that takes one piece of business logic and emits two targets — a server-side cell that runs inside the database engine, and a client-side reactive handler that runs inside the Luminous Container. You write the rules once and the compiler handles partitioning, packaging, and deployment.
Why it matters
Section titled “Why it matters”- Save-to-deploy — saving the file compiles and ships the script as a versioned change.
- Catalog-aware completion — column names, types, and dimensions auto-complete from the live schema, not a stale stub.
- One source, two targets — the compiler splits server logic from client reactivity automatically.
- Reproducible packages — the output is a content-addressed bundle you can ship through normal release pipelines.
The deploy is transactional: either the new version is live everywhere, or nothing changed. Because every package ties the running cell to a specific source revision, you can always answer “which code produced this row?”.
How you use it
Section titled “How you use it”Install the extension, point it at a development cluster, and open any .aes
file. The sidebar populates with the live catalog and completion is type-aware
from the first keystroke.
// Illustrative — a single source file the compiler splits into two// targets. Server logic filters and joins; the on_render hook is// extracted into the client-side handler.
cell trending_products(region: TEXT) { let rows = scan(sales) .filter(r => r.region == region) .top(10, by: -r.revenue);
on_render(rows) { // extracted to the client chart.refresh(rows); }}# Illustrative: compile and deploy the packageaether-pack build trending.aesaether-pack deploy trending.aep --to dev-clusterKey concepts
Section titled “Key concepts”| Concept | What it does |
|---|---|
| Aether-Lens | The VS Code extension. Provides completion, diagnostics, and the live-catalog sidebar. |
| Language server | Resolves catalog references in the background so completion stays in sync with the live schema. |
| Isomorphic compiler | Splits a single source into a server-side cell and a client-side handler. |
| App package | The compiler’s output: a versioned, content-addressed bundle you deploy as a unit. |
flowchart LR V[VS Code +<br/>Aether-Lens] --> C[Isomorphic compiler] V -. introspect .-> DB[(Catalog)] C --> S[Server cell] --> DB C --> F[Client handler] --> R[Luminous Container]