@reactive-agents/health 0.7.6

package/dist/index.d.ts

@@ -0,0 +1,70 @@
+import { Context, Effect } from 'effect';
+import * as effect_Cause from 'effect/Cause';
+import * as effect_Types from 'effect/Types';
+
+/**
+ * Health check result from a registered probe.
+ */
+interface HealthCheckResult {
+    readonly name: string;
+    readonly healthy: boolean;
+    readonly message?: string;
+    readonly durationMs: number;
+}
+/**
+ * Full health response returned from /health and /ready endpoints.
+ */
+interface HealthResponse {
+    readonly status: "healthy" | "degraded" | "unhealthy";
+    readonly uptime: number;
+    readonly agent?: string;
+    readonly checks: readonly HealthCheckResult[];
+    readonly timestamp: string;
+}
+/**
+ * Configuration for the health server.
+ */
+interface HealthConfig {
+    /** Port to bind the health HTTP server. Default: 3000 */
+    readonly port: number;
+    /** Agent name to include in health responses. */
+    readonly agentName?: string;
+}
+/**
+ * Health service interface — manages an HTTP health server and registered probes.
+ */
+interface HealthService {
+    /** Start the HTTP health server on the configured port. */
+    readonly start: () => Effect.Effect<void, never>;
+    /** Stop the HTTP health server gracefully. */
+    readonly stop: () => Effect.Effect<void, never>;
+    /** Register a named health check probe. */
+    readonly registerCheck: (name: string, check: () => Effect.Effect<boolean, never>) => Effect.Effect<void, never>;
+    /** Run all registered checks and return the aggregate result. */
+    readonly check: () => Effect.Effect<HealthResponse, never>;
+}
+declare const Health_base: Context.TagClass<Health, "HealthService", HealthService>;
+/**
+ * Effect-TS Context Tag for HealthService.
+ */
+declare class Health extends Health_base {
+}
+
+declare const HealthServerError_base: new <A extends Record<string, any> = {}>(args: effect_Types.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => effect_Cause.YieldableError & {
+    readonly _tag: "HealthServerError";
+} & Readonly<A>;
+declare class HealthServerError extends HealthServerError_base<{
+    readonly message: string;
+    readonly cause?: unknown;
+}> {
+}
+
+/**
+ * Create a HealthService that runs a Bun.serve HTTP server
+ * with /health, /ready, and /metrics endpoints.
+ */
+declare const makeHealthService: (config: HealthConfig) => Effect.Effect<HealthService & {
+    readonly _port: number;
+}>;
+
+export { Health, type HealthCheckResult, type HealthConfig, type HealthResponse, HealthServerError, type HealthService, makeHealthService };

package/dist/index.js

@@ -0,0 +1,105 @@
+// src/types.ts
+import { Context } from "effect";
+var Health = class extends Context.Tag("HealthService")() {
+};
+
+// src/errors.ts
+import { Data } from "effect";
+var HealthServerError = class extends Data.TaggedError("HealthServerError") {
+};
+
+// src/service.ts
+import { Effect as Effect2, Ref } from "effect";
+var makeHealthService = (config) => Effect2.gen(function* () {
+  const checksRef = yield* Ref.make([]);
+  const startedAt = Date.now();
+  let server = null;
+  let boundPort = config.port;
+  const runChecks = () => Effect2.gen(function* () {
+    const checks = yield* Ref.get(checksRef);
+    const results = [];
+    for (const c of checks) {
+      const start = Date.now();
+      const healthy = yield* c.check();
+      results.push({
+        name: c.name,
+        healthy,
+        durationMs: Date.now() - start
+      });
+    }
+    return results;
+  });
+  const buildResponse = (checks) => {
+    const allHealthy = checks.every((c) => c.healthy);
+    const anyHealthy = checks.some((c) => c.healthy);
+    return {
+      status: checks.length === 0 || allHealthy ? "healthy" : anyHealthy ? "degraded" : "unhealthy",
+      uptime: Math.floor((Date.now() - startedAt) / 1e3),
+      agent: config.agentName,
+      checks,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    };
+  };
+  const metricsText = () => {
+    const uptime = ((Date.now() - startedAt) / 1e3).toFixed(1);
+    return [
+      `# HELP raxd_uptime_seconds Agent uptime in seconds`,
+      `# TYPE raxd_uptime_seconds gauge`,
+      `raxd_uptime_seconds ${uptime}`,
+      `# HELP raxd_health_status Health status (1=healthy, 0=unhealthy)`,
+      `# TYPE raxd_health_status gauge`,
+      `raxd_health_status 1`
+    ].join("\n") + "\n";
+  };
+  const handleRequest = async (req) => {
+    const url = new URL(req.url);
+    if (url.pathname === "/health") {
+      const checks = await Effect2.runPromise(runChecks());
+      const body = buildResponse(checks);
+      return Response.json(body, { status: 200 });
+    }
+    if (url.pathname === "/ready") {
+      const checks = await Effect2.runPromise(runChecks());
+      const body = buildResponse(checks);
+      const status = body.status === "unhealthy" ? 503 : 200;
+      return Response.json(body, { status });
+    }
+    if (url.pathname === "/metrics") {
+      return new Response(metricsText(), {
+        status: 200,
+        headers: { "content-type": "text/plain; charset=utf-8" }
+      });
+    }
+    return Response.json({ error: "Not found" }, { status: 404 });
+  };
+  const service = {
+    get _port() {
+      return boundPort;
+    },
+    start: () => Effect2.sync(() => {
+      server = Bun.serve({
+        port: config.port,
+        fetch: handleRequest
+      });
+      boundPort = server.port ?? config.port;
+    }),
+    stop: () => Effect2.sync(() => {
+      if (server) {
+        server.stop(true);
+        server = null;
+      }
+    }),
+    registerCheck: (name, check) => Ref.update(checksRef, (checks) => [...checks, { name, check }]),
+    check: () => Effect2.gen(function* () {
+      const checks = yield* runChecks();
+      return buildResponse(checks);
+    })
+  };
+  return service;
+});
+export {
+  Health,
+  HealthServerError,
+  makeHealthService
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/errors.ts","../src/service.ts"],"sourcesContent":["// packages/health/src/types.ts\nimport { Context, Effect } from \"effect\";\n\n/**\n * Health check result from a registered probe.\n */\nexport interface HealthCheckResult {\n  readonly name: string;\n  readonly healthy: boolean;\n  readonly message?: string;\n  readonly durationMs: number;\n}\n\n/**\n * Full health response returned from /health and /ready endpoints.\n */\nexport interface HealthResponse {\n  readonly status: \"healthy\" | \"degraded\" | \"unhealthy\";\n  readonly uptime: number;\n  readonly agent?: string;\n  readonly checks: readonly HealthCheckResult[];\n  readonly timestamp: string;\n}\n\n/**\n * Configuration for the health server.\n */\nexport interface HealthConfig {\n  /** Port to bind the health HTTP server. Default: 3000 */\n  readonly port: number;\n  /** Agent name to include in health responses. */\n  readonly agentName?: string;\n}\n\n/**\n * Health service interface — manages an HTTP health server and registered probes.\n */\nexport interface HealthService {\n  /** Start the HTTP health server on the configured port. */\n  readonly start: () => Effect.Effect<void, never>;\n  /** Stop the HTTP health server gracefully. */\n  readonly stop: () => Effect.Effect<void, never>;\n  /** Register a named health check probe. */\n  readonly registerCheck: (\n    name: string,\n    check: () => Effect.Effect<boolean, never>,\n  ) => Effect.Effect<void, never>;\n  /** Run all registered checks and return the aggregate result. */\n  readonly check: () => Effect.Effect<HealthResponse, never>;\n}\n\n/**\n * Effect-TS Context Tag for HealthService.\n */\nexport class Health extends Context.Tag(\"HealthService\")<\n  Health,\n  HealthService\n>() {}\n","// packages/health/src/errors.ts\nimport { Data } from \"effect\";\n\nexport class HealthServerError extends Data.TaggedError(\"HealthServerError\")<{\n  readonly message: string;\n  readonly cause?: unknown;\n}> {}\n","// packages/health/src/service.ts\nimport { Effect, Ref } from \"effect\";\nimport type {\n  HealthConfig,\n  HealthService,\n  HealthResponse,\n  HealthCheckResult,\n} from \"./types.js\";\n\ntype HealthCheck = {\n  readonly name: string;\n  readonly check: () => Effect.Effect<boolean, never>;\n};\n\n/**\n * Create a HealthService that runs a Bun.serve HTTP server\n * with /health, /ready, and /metrics endpoints.\n */\nexport const makeHealthService = (\n  config: HealthConfig,\n): Effect.Effect<HealthService & { readonly _port: number }> =>\n  Effect.gen(function* () {\n    const checksRef = yield* Ref.make<HealthCheck[]>([]);\n    const startedAt = Date.now();\n    let server: ReturnType<typeof Bun.serve> | null = null;\n    let boundPort = config.port;\n\n    const runChecks = (): Effect.Effect<HealthCheckResult[], never> =>\n      Effect.gen(function* () {\n        const checks = yield* Ref.get(checksRef);\n        const results: HealthCheckResult[] = [];\n        for (const c of checks) {\n          const start = Date.now();\n          const healthy = yield* c.check();\n          results.push({\n            name: c.name,\n            healthy,\n            durationMs: Date.now() - start,\n          });\n        }\n        return results;\n      });\n\n    const buildResponse = (checks: HealthCheckResult[]): HealthResponse => {\n      const allHealthy = checks.every((c) => c.healthy);\n      const anyHealthy = checks.some((c) => c.healthy);\n      return {\n        status:\n          checks.length === 0 || allHealthy\n            ? \"healthy\"\n            : anyHealthy\n              ? \"degraded\"\n              : \"unhealthy\",\n        uptime: Math.floor((Date.now() - startedAt) / 1000),\n        agent: config.agentName,\n        checks,\n        timestamp: new Date().toISOString(),\n      };\n    };\n\n    const metricsText = (): string => {\n      const uptime = ((Date.now() - startedAt) / 1000).toFixed(1);\n      return (\n        [\n          `# HELP raxd_uptime_seconds Agent uptime in seconds`,\n          `# TYPE raxd_uptime_seconds gauge`,\n          `raxd_uptime_seconds ${uptime}`,\n          `# HELP raxd_health_status Health status (1=healthy, 0=unhealthy)`,\n          `# TYPE raxd_health_status gauge`,\n          `raxd_health_status 1`,\n        ].join(\"\\n\") + \"\\n\"\n      );\n    };\n\n    const handleRequest = async (req: Request): Promise<Response> => {\n      const url = new URL(req.url);\n\n      if (url.pathname === \"/health\") {\n        const checks = await Effect.runPromise(runChecks());\n        const body = buildResponse(checks);\n        return Response.json(body, { status: 200 });\n      }\n\n      if (url.pathname === \"/ready\") {\n        const checks = await Effect.runPromise(runChecks());\n        const body = buildResponse(checks);\n        const status = body.status === \"unhealthy\" ? 503 : 200;\n        return Response.json(body, { status });\n      }\n\n      if (url.pathname === \"/metrics\") {\n        return new Response(metricsText(), {\n          status: 200,\n          headers: { \"content-type\": \"text/plain; charset=utf-8\" },\n        });\n      }\n\n      return Response.json({ error: \"Not found\" }, { status: 404 });\n    };\n\n    const service: HealthService & { readonly _port: number } = {\n      get _port() {\n        return boundPort;\n      },\n\n      start: () =>\n        Effect.sync(() => {\n          server = Bun.serve({\n            port: config.port,\n            fetch: handleRequest,\n          });\n          boundPort = server.port ?? config.port;\n        }),\n\n      stop: () =>\n        Effect.sync(() => {\n          if (server) {\n            server.stop(true);\n            server = null;\n          }\n        }),\n\n      registerCheck: (name, check) =>\n        Ref.update(checksRef, (checks) => [...checks, { name, check }]),\n\n      check: () =>\n        Effect.gen(function* () {\n          const checks = yield* runChecks();\n          return buildResponse(checks);\n        }),\n    };\n\n    return service;\n  });\n"],"mappings":"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","names":["Effect"]}

package/package.json

@@ -0,0 +1,44 @@
+{
+    "name": "@reactive-agents/health",
+    "version": "0.7.6",
+    "type": "module",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "scripts": {
+        "build": "tsup --config ../../tsup.config.base.ts",
+        "typecheck": "tsc --noEmit",
+        "test": "bun test"
+    },
+    "dependencies": {
+        "effect": "^3.10.0"
+    },
+    "devDependencies": {
+        "typescript": "^5.7.0",
+        "bun-types": "latest"
+    },
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js",
+            "default": "./dist/index.js"
+        }
+    },
+    "files": [
+        "dist",
+        "README.md",
+        "LICENSE"
+    ],
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/tylerjrbuell/reactive-agents-ts.git",
+        "directory": "packages/health"
+    },
+    "homepage": "https://docs.reactiveagents.dev/",
+    "bugs": {
+        "url": "https://github.com/tylerjrbuell/reactive-agents-ts/issues"
+    },
+    "publishConfig": {
+        "access": "public"
+    }
+}