@contfu/server

User-hosted Bun HTTP Server for Contfu.

@contfu/server wraps the @contfu/contfu Local Runtime package: the Local Runtime uses the Connector to receive Sync Messages from the Cloud Service, applies them to the Local Store, processes Media Files, and the Server exposes HTTP query endpoints over that Local Store.

The synchronization implementation lives in @contfu/contfu; @contfu/server only hosts the HTTP API and observes Local Runtime events for status and live UI invalidation.

Usage

import serve from "@contfu/server";

serve({ port: 3000 });

Or compose with your own Bun.serve call:

import { createServeOptions } from "@contfu/server";

Bun.serve({
  ...createServeOptions(),
  port: 3000,
});

Prerequisites

Configure the Local Runtime through environment variables:

• CONTFU_KEY — authentication key for the Cloud Service. When unset, the Server can still query an existing Local Store but no synchronization runs.
• CONTFU_DB or DATABASE_URL — SQLite Local Store path.
• FILE_URL — optional file storage location for Media Files.

Basic auth

Optional HTTP basic auth can protect every request handled by @contfu/server.

Set CONTFU_BASIC_AUTH to user:password to enable it.

When set, requests must include the matching Authorization: Basic ... header or the Server responds with 401 Unauthorized and WWW-Authenticate: Basic realm="Contfu".

If CONTFU_BASIC_AUTH is unset or malformed, basic auth is disabled and behavior stays unchanged.