@ereo/data

Data loading and caching for the EreoJS framework. One pattern, not four - simple and explicit data fetching with automatic parallelization.

Installation

bun add @ereo/data

Quick Start

import { createLoader, createAction, cached } from '@ereo/data';

// Create a loader for fetching data
export const loader = createLoader(async ({ params }) => {
  const user = await fetchUser(params.id);
  return { user };
});

// Create an action for mutations
export const action = createAction(async ({ request }) => {
  const formData = await request.formData();
  await updateUser(formData);
  return redirect('/users');
});

Key Features

• Loaders - Fetch data with createLoader, support for deferred data with defer
• Actions - Handle mutations with createAction, typedAction, and jsonAction
• Caching - Built-in memory cache with cached, getCache, setCache
• Cache Control - Fine-grained cache headers with buildCacheControl
• Revalidation - On-demand revalidation with revalidateTag and revalidatePath
• Data Pipelines - Auto-parallelization with createPipeline and dataSource
• Response Helpers - redirect, json, and error utilities

Caching Example

import { cached, cacheKey, revalidateTag } from '@ereo/data';

// cached(key, fetchFn, options) — key is required, fetchFn takes no arguments
const user = await cached(
  cacheKey('user', id),
  () => fetchUser(id),
  { maxAge: 60, tags: ['users', `user-${id}`] }
);

// Revalidate when user is updated
await revalidateTag('users');

Data Pipeline

import { createPipeline, dataSource, cachedSource } from '@ereo/data';

const pipeline = createPipeline({
  loaders: {
    user: dataSource(() => fetchUser(id)),
    posts: cachedSource(() => fetchPosts(id), { ttl: 300 }),
    // comments depends on posts — declare via dependencies, not function args
    comments: dataSource(() => fetchComments(id)),
  },
  dependencies: {
    comments: ['posts'], // comments waits for posts to finish first
  },
});

const result = await pipeline.execute(loaderArgs);
// result.data = { user, posts, comments } — independent loaders run in parallel

Documentation

For full documentation, visit https://ereojs.dev/docs/data

Part of EreoJS

This package is part of the EreoJS monorepo - a modern full-stack framework built for Bun.

License

MIT