@fourtheraio/observability

Shared Sentry init + heartbeat + tag taxonomy for Fourth Era backend services.

Install

npm install @fourtheraio/observability

Usage

import {
  initObservability,
  withHeartbeat,
  setRequestTags,
  observabilityMiddleware,
  sanitizeRequestId,
} from "@fourtheraio/observability";

initObservability({
  service: "my-service",
  environment: process.env.FOURTHERA_ENV as "production" | "staging" | "development",
  release: process.env.GIT_SHA,
});

// Hono:
app.use("*", observabilityMiddleware({
  userExtractor: (c) => c.get("affiliate")?.id ?? c.get("adminUser")?.id,
  marketExtractor: (c) => parseMarket(c.req.header("host")),
}));

// Wrap money-path:
await withHeartbeat("commission.compute", async () => { /* ... */ });

Spec: architecture-strategy/docs/superpowers/specs/2026-05-15-fourthera-observability-design.md.