HarperFast / HarperFast/harper

Add support for Edge Side Includes (ESI)

Open
#675 0 comments 0 reactions 0 assignees View on GitHub
area:rest-api enhancement from-jira
Dominant language
JavaScript
Stars
89
Forks
10
Avg merge
2d 6h
Merged PRs (30d)
200

Description

Support [ESI (Edge Side Includes)](https://www.w3.org/TR/esi-lang/) in Harper's HTTP response layer. ESI enables HTML composition at the edge — sub-resources are fetched and injected inline when serving a response, allowing page fragments to be cached independently at different TTLs and assembled close to the data.

## Relevance to Harper

Harper's position as both a data layer and an HTTP server (with caching) makes it a natural host for ESI: fragments can be served directly from Harper data, composed server-side, and cached at the appropriate scope.

## Design considerations (Not Ready — needs scoping)

- Which ESI tags? At minimum `` and ``.
- Processing pipeline: pre-response transform pass over HTML bodies.
- Interaction with existing cache headers — fragment TTLs vs. page TTLs.
- Error handling: `/` support for resilient fallbacks.

---

🤖 Filed by Claude on behalf of Kris.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.