Portable infrastructure · TypeScript
Infrastructure that tells you where its guarantees end.
Astilba builds portable infrastructure tools and libraries with explicit correctness boundaries. The documentation says what works, what it costs, and what remains incomplete.
@astilba/env 0.3.0 is a public alpha · Cache remains a development preview
- Read product:sku-123MISS
- Run loadProduct()ORIGIN
- Store encoded resultWRITE
- Read product:sku-123HIT
01 · Public alpha
Env
A local-first TypeScript configuration contract compiler with explicit lifecycles and physically separated browser and server projections.
| Guarantee | Boundary made visible |
|---|---|
| Every value belongs to a declared lifecycle. | Build, deployment, and request values are resolved where they become available. |
| Browser exposure is an explicit projection. | Generated browser modules contain no private names, bindings, values, or full-contract metadata. |
| Runtime browser configuration stays inert. | The application owns a same-origin JSON endpoint and its cache, trust, and failure policy. |
02 · Development preview
Cache
A server-side TypeScript cache for applications that need explicit invalidation, classified stale-on-error resilience, privacy-aware sharing, and portable runtime adapters.
| Guarantee | Boundary made visible |
|---|---|
| Uncertain invalidation knowledge never becomes false freshness. | Cache may perform extra origin work while distributed state reconverges. |
| Identity is part of storage safety. | Principal-derived values stay local unless the application declares a shareable scope. |
| Portability is a capability boundary. | The raw constructor requires storage, a clock, and a random source from the runtime. |
03 · One public corpus
For people and agents
The same public documentation is available as readable pages, authored Markdown, and a bounded read-only MCP service.