@tyndall/runtime

Overview

Runtime HTTP serving package for static routes, SSR execution, and route payload responses.

Responsibilities

• Start runtime server using generated artifacts
• Serve static assets and route payload responses
• Run SSR handlers when route metadata requires server rendering
• Stream SSR responses when server entries provide renderToStream
• Resolve client/server chunk files using manifest asset metadata (assets.assetsDir)
• Emit module or classic script tags based on manifest assets.scriptType
• Run init.server and getRouteData hooks to populate route data payloads for SSR and navigation
• Serve special routes (_404, _error) and custom document shells from _document when provided
• Emit redirect navigation payloads when route data hooks request redirects
• Emit build version markers and append ?v= to script URLs when manifest versioning is configured

Public API Highlights

• createServer
• createExpressHandler
• createFastifyPlugin

Development

• Build: bun run --filter @tyndall/runtime build
• Test (from workspace root): bun test

Documentation

• Package specification: spec.md
• Package architecture: architecture.md
• Package changes: CHANGELOG.md

Maintenance Rules

• Keep this document aligned with implemented package behavior.
• Update spec.md and architecture.md whenever package contracts or design boundaries change.
• Record user-visible package changes in CHANGELOG.md.