Transporter utilities for safely sending non-POJO values between server and client in SvelteKit.
npm install effective-transporterThis library is not yet ready for production.
---
A utility library that provides ready-to-use Transporter presets and registries for safely transferring non-POJO objects between the server and client in SvelteKit, with a strong focus on Effect / Effect-TS–style data structures.
SvelteKit supports custom serialization via the transport hook in hooks.server, but in real-world applications—especially those built on Effect—you often need to transfer many kinds of general, non-JSON-safe objects across the network.
effective-transporter exists to standardize and centralize that logic.
---
In SvelteKit, only plain JSON-serializable values can be sent between the server and client by default.
To transfer non-POJO values such as:
- Map, Set
- Date, BigInt, URL
- Error and custom error types
- Effect / Effect-TS ecosystem objects
you must explicitly register Transporter handlers.
This quickly becomes repetitive and error-prone in Effect-heavy codebases, where:
- many values are structural but non-POJO
- serialization rules must remain consistent across the app
- ad-hoc transport logic leads to fragmentation
effective-transporter solves this by providing:
- a shared transporter registry
- predefined handlers for common and Effect-related types
- a clean abstraction that plugs directly into SvelteKit