Introduction

HTTP server utilities package for Effect.ts applications

ff-serv is a lightweight HTTP server utilities package built on Effect.ts. It provides composable handlers, built-in caching with SWR (stale-while-revalidate), logging, and integrations for modern web frameworks.

Features

• Composable HTTP Handlers: Build request handlers with Effect-based composition
• oRPC Integration: First-class support for @orpc/server
• Advanced Caching: In-memory cache with SWR and pluggable Redis adapters
• Effect.ts Native: Fully integrated with Effect’s type-safe error handling and context management
• TypeScript-First: Complete type safety with inference
• CLI Tools: Database utilities for pulling and dumping PostgreSQL databases

Installation

bun add ff-serv effect

Peer Dependencies

Depending on your use case, you may need:

# For oRPC integration
bun add @orpc/server

# For port utilities
bun add get-port

# For OpenTelemetry
bun add @effect/opentelemetry

# For Redis caching (optional)
bun add ioredis

Package Exports

ff-serv provides multiple entry points:

// Main exports
import { createFetchHandler, basicHandler, Logger, getPort } from 'ff-serv'

// oRPC integration
import { oRPCHandler } from 'ff-serv/orpc'

// Cache utilities
import { Cache, CacheAdapter } from 'ff-serv/cache'

// Redis adapters
import { ioredis } from 'ff-serv/cache/ioredis'
import { bunRedis } from 'ff-serv/cache/bun-redis'

Quick Start

Here’s a minimal HTTP server with Effect.ts:

import { createFetchHandler, basicHandler } from 'ff-serv'
import { Effect } from 'effect'

const program = Effect.gen(function* () {
  const fetch = yield* createFetchHandler([
    basicHandler('/health', () => new Response('OK')),
  ])

  Bun.serve({
    port: 3000,
    fetch,
  })

  yield* Effect.log('Server running on http://localhost:3000')
})

Effect.runPromise(program)

What’s Next?

Basic Server

Learn how to create HTTP handlers

Fetch Handler

Compose handlers with createFetchHandler

Cache

Add caching with SWR support

CLI

Database utilities and CLI tools