@qlever-llc/trellis 0.7.0-rc.5 → 0.7.0

package/esm/server/health.d.ts

@@ -1,14 +1,7 @@
-/**
- * Health check types and utility functions for Trellis services.
- *
- * This module provides a standardized way to implement health checks
- * for services, with support for individual check results and
- * aggregated health status (healthy, degraded, unhealthy).
- *
- * @module
- */
 import { type Result } from "@qlever-llc/result";
+import type { JsonValue } from "@qlever-llc/trellis/contracts";
 import { type TrellisError } from "@qlever-llc/trellis";
+type MaybePromise<T> = T | Promise<T>;
 /**
  * A health check function that returns a Result indicating health status.
  *
@@ -28,9 +21,47 @@ export type HealthCheckResult = {
     status: "ok" | "failed";
     /** Error message if the check failed with an error */
     error?: string;
+    /** Optional short human-readable summary */
+    summary?: string;
+    /** Optional structured metadata for the check */
+    info?: Record<string, JsonValue>;
     /** Time in milliseconds the check took to execute */
     latencyMs: number;
 };
+export type ServiceHealthInfo = {
+    version?: string;
+    info?: Record<string, JsonValue>;
+};
+export type ServiceHealthCheck = {
+    status: "ok" | "failed";
+    summary?: string;
+    info?: Record<string, JsonValue>;
+    error?: string;
+};
+export type ServiceHealthCheckFn = () => MaybePromise<ServiceHealthCheck>;
+export type ServiceHealthInfoFn = () => MaybePromise<ServiceHealthInfo | undefined>;
+export type HealthHeartbeat = {
+    header: {
+        id: string;
+        time: string;
+    };
+    service: {
+        name: string;
+        kind: "service" | "device";
+        instanceId: string;
+        contractId: string;
+        contractDigest: string;
+        startedAt: string;
+        publishIntervalMs: number;
+        runtime: "deno" | "node" | "rust" | "unknown";
+        runtimeVersion?: string;
+        version?: string;
+        info?: Record<string, JsonValue>;
+    };
+    status: HealthResponse["status"];
+    summary?: string;
+    checks: HealthCheckResult[];
+};
 /**
  * Aggregated health response for a service.
  */
@@ -64,6 +95,7 @@ export type HealthResponse = {
  * ```
  */
 export declare function runHealthCheck(name: string, check: HealthCheckFn): Promise<HealthCheckResult>;
+export declare function runServiceHealthCheck(name: string, check: ServiceHealthCheckFn): Promise<HealthCheckResult>;
 /**
  * Runs all health checks and returns an aggregated health response.
  *
@@ -89,4 +121,41 @@ export declare function runHealthCheck(name: string, check: HealthCheckFn): Prom
  * ```
  */
 export declare function runAllHealthChecks(service: string, checks: Record<string, HealthCheckFn>): Promise<HealthResponse>;
+export declare function runAllServiceHealthChecks(service: string, checks: Record<string, ServiceHealthCheckFn>): Promise<HealthResponse>;
+export declare function createHealthHeartbeat(args: {
+    serviceName: string;
+    kind?: HealthHeartbeat["service"]["kind"];
+    instanceId: string;
+    contractId: string;
+    contractDigest: string;
+    startedAt: string;
+    publishIntervalMs: number;
+    checks: HealthCheckResult[];
+    info?: ServiceHealthInfo;
+}): Omit<HealthHeartbeat, "header">;
+export declare class ServiceHealth {
+    #private;
+    readonly serviceName: string;
+    readonly kind: HealthHeartbeat["service"]["kind"];
+    readonly instanceId: string;
+    readonly contractId: string;
+    readonly contractDigest: string;
+    readonly startedAt: string;
+    readonly publishIntervalMs: number;
+    constructor(args: {
+        serviceName: string;
+        kind?: HealthHeartbeat["service"]["kind"];
+        instanceId?: string;
+        contractId: string;
+        contractDigest: string;
+        publishIntervalMs: number;
+        checks?: Record<string, HealthCheckFn>;
+    });
+    setInfo(info: ServiceHealthInfo | ServiceHealthInfoFn): void;
+    add(name: string, check: ServiceHealthCheckFn): () => void;
+    checks(): Promise<HealthCheckResult[]>;
+    response(): Promise<HealthResponse>;
+    heartbeat(): Promise<Omit<HealthHeartbeat, "header">>;
+}
+export {};
 //# sourceMappingURL=health.d.ts.map

package/esm/server/health.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/server/health.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,MAAM,EAAE,IAAI,GAAG,QAAQ,CAAC;IACxB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,0FAA0F;IAC1F,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC;IAC7C,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,MAAM,EAAE,iBAAiB,EAAE,CAAC;CAC7B,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,iBAAiB,CAAC,CAY5B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GACpC,OAAO,CAAC,cAAc,CAAC,CAczB"}
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/server/health.ts"],"names":[],"mappings":"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"}

package/esm/server/health.js

@@ -1,3 +1,15 @@
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var _ServiceHealth_checks, _ServiceHealth_info;
 /**
  * Health check types and utility functions for Trellis services.
  *
@@ -7,6 +19,43 @@
  *
  * @module
  */
+import * as dntShim from "../_dnt.shims.js";
+function summarizeHealthStatus(results) {
+    const allOk = results.every((r) => r.status === "ok");
+    const anyOk = results.some((r) => r.status === "ok");
+    return allOk ? "healthy" : anyOk ? "degraded" : "unhealthy";
+}
+function summarizeHealthChecks(results) {
+    const failedCount = results.filter((r) => r.status === "failed").length;
+    if (failedCount === 0) {
+        return undefined;
+    }
+    return `${failedCount} check${failedCount === 1 ? "" : "s"} failing`;
+}
+function normalizeLegacyHealthCheck(check) {
+    return async () => {
+        const result = await check();
+        if (result.isErr()) {
+            return {
+                status: "failed",
+                error: result.error.message,
+                summary: result.error.message,
+            };
+        }
+        return { status: result.take() ? "ok" : "failed" };
+    };
+}
+function detectRuntime() {
+    const maybeDeno = Reflect.get(dntShim.dntGlobalThis, "Deno");
+    if (maybeDeno?.version?.deno) {
+        return { runtime: "deno", runtimeVersion: maybeDeno.version.deno };
+    }
+    const maybeProcess = Reflect.get(dntShim.dntGlobalThis, "process");
+    if (typeof maybeProcess?.version === "string") {
+        return { runtime: "node", runtimeVersion: maybeProcess.version };
+    }
+    return { runtime: "unknown" };
+}
 /**
  * Runs a single health check and returns the result.
  *
@@ -27,15 +76,33 @@
  * ```
  */
 export async function runHealthCheck(name, check) {
+    return await runServiceHealthCheck(name, normalizeLegacyHealthCheck(check));
+}
+export async function runServiceHealthCheck(name, check) {
     const start = performance.now();
-    const result = await check();
-    const latencyMs = performance.now() - start;
-    if (result.isErr()) {
-        return { name, status: "failed", error: result.error.message, latencyMs };
+    try {
+        const result = await check();
+        const latencyMs = performance.now() - start;
+        return {
+            name,
+            status: result.status,
+            error: result.error,
+            summary: result.summary,
+            info: result.info,
+            latencyMs,
+        };
+    }
+    catch (error) {
+        const latencyMs = performance.now() - start;
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            name,
+            status: "failed",
+            error: message,
+            summary: message,
+            latencyMs,
+        };
     }
-    // Use take() to extract the value after confirming it's not an error
-    const value = result.take();
-    return { name, status: value ? "ok" : "failed", latencyMs };
 }
 /**
  * Runs all health checks and returns an aggregated health response.
@@ -62,13 +129,131 @@ export async function runHealthCheck(name, check) {
  * ```
  */
 export async function runAllHealthChecks(service, checks) {
-    const results = await Promise.all(Object.entries(checks).map(([name, fn]) => runHealthCheck(name, fn)));
-    const allOk = results.every((r) => r.status === "ok");
-    const anyOk = results.some((r) => r.status === "ok");
+    const normalizedChecks = Object.fromEntries(Object.entries(checks).map(([name, check]) => [name, normalizeLegacyHealthCheck(check)]));
+    return await runAllServiceHealthChecks(service, normalizedChecks);
+}
+export async function runAllServiceHealthChecks(service, checks) {
+    const results = await Promise.all(Object.entries(checks).map(([name, fn]) => runServiceHealthCheck(name, fn)));
     return {
-        status: allOk ? "healthy" : anyOk ? "degraded" : "unhealthy",
+        status: summarizeHealthStatus(results),
         service,
         timestamp: new Date().toISOString(),
         checks: results,
     };
 }
+export function createHealthHeartbeat(args) {
+    const runtime = detectRuntime();
+    const summary = summarizeHealthChecks(args.checks);
+    return {
+        service: {
+            name: args.serviceName,
+            kind: args.kind ?? "service",
+            instanceId: args.instanceId,
+            contractId: args.contractId,
+            contractDigest: args.contractDigest,
+            startedAt: args.startedAt,
+            publishIntervalMs: args.publishIntervalMs,
+            runtime: runtime.runtime,
+            ...(runtime.runtimeVersion ? { runtimeVersion: runtime.runtimeVersion } : {}),
+            ...(args.info?.version ? { version: args.info.version } : {}),
+            ...(args.info?.info ? { info: args.info.info } : {}),
+        },
+        status: summarizeHealthStatus(args.checks),
+        ...(summary ? { summary } : {}),
+        checks: args.checks,
+    };
+}
+export class ServiceHealth {
+    constructor(args) {
+        Object.defineProperty(this, "serviceName", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "kind", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "instanceId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "contractId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "contractDigest", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "startedAt", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "publishIntervalMs", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        _ServiceHealth_checks.set(this, new Map());
+        _ServiceHealth_info.set(this, void 0);
+        this.serviceName = args.serviceName;
+        this.kind = args.kind ?? "service";
+        this.instanceId = args.instanceId ?? crypto.randomUUID();
+        this.contractId = args.contractId;
+        this.contractDigest = args.contractDigest;
+        this.startedAt = new Date().toISOString();
+        this.publishIntervalMs = args.publishIntervalMs;
+        for (const [name, check] of Object.entries(args.checks ?? {})) {
+            __classPrivateFieldGet(this, _ServiceHealth_checks, "f").set(name, normalizeLegacyHealthCheck(check));
+        }
+    }
+    setInfo(info) {
+        if (typeof info === "function") {
+            __classPrivateFieldSet(this, _ServiceHealth_info, info, "f");
+            return;
+        }
+        __classPrivateFieldSet(this, _ServiceHealth_info, () => info, "f");
+    }
+    add(name, check) {
+        __classPrivateFieldGet(this, _ServiceHealth_checks, "f").set(name, check);
+        return () => {
+            __classPrivateFieldGet(this, _ServiceHealth_checks, "f").delete(name);
+        };
+    }
+    async checks() {
+        return await Promise.all(Array.from(__classPrivateFieldGet(this, _ServiceHealth_checks, "f").entries()).map(([name, check]) => runServiceHealthCheck(name, check)));
+    }
+    async response() {
+        const checks = Object.fromEntries(__classPrivateFieldGet(this, _ServiceHealth_checks, "f").entries());
+        return await runAllServiceHealthChecks(this.serviceName, checks);
+    }
+    async heartbeat() {
+        const checks = await this.checks();
+        const info = __classPrivateFieldGet(this, _ServiceHealth_info, "f") ? await __classPrivateFieldGet(this, _ServiceHealth_info, "f").call(this) : undefined;
+        return createHealthHeartbeat({
+            serviceName: this.serviceName,
+            kind: this.kind,
+            instanceId: this.instanceId,
+            contractId: this.contractId,
+            contractDigest: this.contractDigest,
+            startedAt: this.startedAt,
+            publishIntervalMs: this.publishIntervalMs,
+            checks,
+            info,
+        });
+    }
+}
+_ServiceHealth_checks = new WeakMap(), _ServiceHealth_info = new WeakMap();

package/esm/server/health_rpc.d.ts

@@ -1,5 +1,5 @@
 import type { TrellisAPI } from "@qlever-llc/trellis/contracts";
-import { type HealthCheckFn } from "./health.js";
+import { type HealthCheckFn, type HealthResponse } from "./health.js";
 type HealthRpcServer = {
     name: string;
     api: TrellisAPI;
@@ -11,6 +11,7 @@ type HealthRpcServer = {
 export declare function mountStandardHealthRpc(server: HealthRpcServer, opts?: {
     rpcName?: string;
     checks?: Record<string, HealthCheckFn>;
+    response?: () => Promise<HealthResponse>;
 }): Promise<void>;
 export {};
 //# sourceMappingURL=health_rpc.d.ts.map

package/esm/server/health_rpc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"health_rpc.d.ts","sourceRoot":"","sources":["../../src/server/health_rpc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAGhE,OAAO,EAAE,KAAK,aAAa,EAAsB,MAAM,aAAa,CAAC;AAErE,KAAK,eAAe,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,UAAU,CAAC;IAChB,cAAc,EAAE;QAAE,QAAQ,IAAI,OAAO,CAAA;KAAE,CAAC;IACxC,KAAK,CAAC,CAAC,SAAS,MAAM,UAAU,CAAC,KAAK,CAAC,GAAG,MAAM,EAC9C,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GACvC,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB,CAAC;AAUF,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,eAAe,EACvB,IAAI,CAAC,EAAE;IACL,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CACxC,GACA,OAAO,CAAC,IAAI,CAAC,CAaf"}
+{"version":3,"file":"health_rpc.d.ts","sourceRoot":"","sources":["../../src/server/health_rpc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAGhE,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,cAAc,EAAsB,MAAM,aAAa,CAAC;AAE1F,KAAK,eAAe,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,UAAU,CAAC;IAChB,cAAc,EAAE;QAAE,QAAQ,IAAI,OAAO,CAAA;KAAE,CAAC;IACxC,KAAK,CAAC,CAAC,SAAS,MAAM,UAAU,CAAC,KAAK,CAAC,GAAG,MAAM,EAC9C,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GACvC,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB,CAAC;AAUF,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,eAAe,EACvB,IAAI,CAAC,EAAE;IACL,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACvC,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;CAC1C,GACA,OAAO,CAAC,IAAI,CAAC,CAef"}

package/esm/server/health_rpc.js

@@ -14,10 +14,12 @@ export async function mountStandardHealthRpc(server, opts) {
         return;
     const method = rpcName;
     await server.mount(method, async () => {
-        const response = await runAllHealthChecks(server.name, {
-            nats: async () => Result.ok(!server.natsConnection.isClosed()),
-            ...(opts?.checks ?? {}),
-        });
+        const response = opts?.response
+            ? await opts.response()
+            : await runAllHealthChecks(server.name, {
+                nats: async () => Result.ok(!server.natsConnection.isClosed()),
+                ...(opts?.checks ?? {}),
+            });
         return Result.ok(response);
     });
 }

package/esm/server/health_schemas.d.ts

@@ -1,9 +1,12 @@
 import { Type } from "typebox";
 export declare const HealthRpcSchema: Type.TObject<{}>;
+export declare const HealthInfoSchema: Type.TRecord<"^.*$", Type.TUnknown>;
 export declare const HealthCheckResultSchema: Type.TObject<{
     name: Type.TString;
     status: Type.TUnion<[Type.TLiteral<"ok">, Type.TLiteral<"failed">]>;
     error: Type.TOptional<Type.TString>;
+    summary: Type.TOptional<Type.TString>;
+    info: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
     latencyMs: Type.TNumber;
 }>;
 export declare const HealthResponseSchema: Type.TObject<{
@@ -14,6 +17,54 @@ export declare const HealthResponseSchema: Type.TObject<{
         name: Type.TString;
         status: Type.TUnion<[Type.TLiteral<"ok">, Type.TLiteral<"failed">]>;
         error: Type.TOptional<Type.TString>;
+        summary: Type.TOptional<Type.TString>;
+        info: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
+        latencyMs: Type.TNumber;
+    }>>;
+}>;
+export declare const HealthHeartbeatHeaderSchema: Type.TObject<{
+    id: Type.TString;
+    time: Type.TString;
+}>;
+export declare const HealthHeartbeatServiceSchema: Type.TObject<{
+    name: Type.TString;
+    kind: Type.TUnion<[Type.TLiteral<"service">, Type.TLiteral<"device">]>;
+    instanceId: Type.TString;
+    contractId: Type.TString;
+    contractDigest: Type.TString;
+    startedAt: Type.TString;
+    publishIntervalMs: Type.TInteger;
+    runtime: Type.TUnion<[Type.TLiteral<"deno">, Type.TLiteral<"node">, Type.TLiteral<"rust">, Type.TLiteral<"unknown">]>;
+    runtimeVersion: Type.TOptional<Type.TString>;
+    version: Type.TOptional<Type.TString>;
+    info: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
+}>;
+export declare const HealthHeartbeatSchema: Type.TObject<{
+    header: Type.TObject<{
+        id: Type.TString;
+        time: Type.TString;
+    }>;
+    service: Type.TObject<{
+        name: Type.TString;
+        kind: Type.TUnion<[Type.TLiteral<"service">, Type.TLiteral<"device">]>;
+        instanceId: Type.TString;
+        contractId: Type.TString;
+        contractDigest: Type.TString;
+        startedAt: Type.TString;
+        publishIntervalMs: Type.TInteger;
+        runtime: Type.TUnion<[Type.TLiteral<"deno">, Type.TLiteral<"node">, Type.TLiteral<"rust">, Type.TLiteral<"unknown">]>;
+        runtimeVersion: Type.TOptional<Type.TString>;
+        version: Type.TOptional<Type.TString>;
+        info: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
+    }>;
+    status: Type.TUnion<[Type.TLiteral<"healthy">, Type.TLiteral<"unhealthy">, Type.TLiteral<"degraded">]>;
+    summary: Type.TOptional<Type.TString>;
+    checks: Type.TArray<Type.TObject<{
+        name: Type.TString;
+        status: Type.TUnion<[Type.TLiteral<"ok">, Type.TLiteral<"failed">]>;
+        error: Type.TOptional<Type.TString>;
+        summary: Type.TOptional<Type.TString>;
+        info: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
         latencyMs: Type.TNumber;
     }>>;
 }>;

package/esm/server/health_schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"health_schemas.d.ts","sourceRoot":"","sources":["../../src/server/health_schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,eAAO,MAAM,eAAe,kBAAmD,CAAC;AAEhF,eAAO,MAAM,uBAAuB;;;;;EAKD,CAAC;AAEpC,eAAO,MAAM,oBAAoB;;;;;;;;;;EASE,CAAC"}
+{"version":3,"file":"health_schemas.d.ts","sourceRoot":"","sources":["../../src/server/health_schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,eAAO,MAAM,eAAe,kBAAkB,CAAC;AAE/C,eAAO,MAAM,gBAAgB,qCAA6C,CAAC;AAE3E,eAAO,MAAM,uBAAuB;;;;;;;EAOlC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAS/B,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;EAGtC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;EAiBvC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUhC,CAAC"}

package/esm/server/health_schemas.js

@@ -1,11 +1,14 @@
 import { Type } from "typebox";
-export const HealthRpcSchema = Type.Object({}, { additionalProperties: false });
+export const HealthRpcSchema = Type.Object({});
+export const HealthInfoSchema = Type.Record(Type.String(), Type.Unknown());
 export const HealthCheckResultSchema = Type.Object({
     name: Type.String(),
     status: Type.Union([Type.Literal("ok"), Type.Literal("failed")]),
     error: Type.Optional(Type.String()),
+    summary: Type.Optional(Type.String()),
+    info: Type.Optional(HealthInfoSchema),
     latencyMs: Type.Number(),
-}, { additionalProperties: false });
+});
 export const HealthResponseSchema = Type.Object({
     status: Type.Union([
         Type.Literal("healthy"),
@@ -15,4 +18,37 @@ export const HealthResponseSchema = Type.Object({
     service: Type.String(),
     timestamp: Type.String({ format: "date-time" }),
     checks: Type.Array(HealthCheckResultSchema),
-}, { additionalProperties: false });
+});
+export const HealthHeartbeatHeaderSchema = Type.Object({
+    id: Type.String(),
+    time: Type.String({ format: "date-time" }),
+});
+export const HealthHeartbeatServiceSchema = Type.Object({
+    name: Type.String(),
+    kind: Type.Union([Type.Literal("service"), Type.Literal("device")]),
+    instanceId: Type.String(),
+    contractId: Type.String(),
+    contractDigest: Type.String(),
+    startedAt: Type.String({ format: "date-time" }),
+    publishIntervalMs: Type.Integer({ minimum: 1 }),
+    runtime: Type.Union([
+        Type.Literal("deno"),
+        Type.Literal("node"),
+        Type.Literal("rust"),
+        Type.Literal("unknown"),
+    ]),
+    runtimeVersion: Type.Optional(Type.String()),
+    version: Type.Optional(Type.String()),
+    info: Type.Optional(HealthInfoSchema),
+});
+export const HealthHeartbeatSchema = Type.Object({
+    header: HealthHeartbeatHeaderSchema,
+    service: HealthHeartbeatServiceSchema,
+    status: Type.Union([
+        Type.Literal("healthy"),
+        Type.Literal("unhealthy"),
+        Type.Literal("degraded"),
+    ]),
+    summary: Type.Optional(Type.String()),
+    checks: Type.Array(HealthCheckResultSchema),
+});

package/esm/server/mod.d.ts

@@ -1,18 +1,15 @@
 /**
- * Trellis Server package entry point.
+ * Trellis host package entry point.
  *
- * This package is server-only glue: it re-exports the RPC/event server runtime
- * plus common server helpers (health checks, subscription types).
+ * This package is host-side glue: it re-exports the RPC/event hosting runtime
+ * plus common service helpers (health checks, subscription types).
  *
  * @module
  */
-export { TrellisServer } from "@qlever-llc/trellis/server/runtime";
-export { type HealthCheckFn, type HealthCheckResult, type HealthResponse, runAllHealthChecks, runHealthCheck, } from "./health.js";
+export { TrellisServer } from "../server.js";
+export { type HealthHeartbeat, type HealthCheckFn, type HealthCheckResult, type HealthResponse, type ServiceHealthInfoFn, type ServiceHealthCheck, type ServiceHealthCheckFn, type ServiceHealthInfo, createHealthHeartbeat, runAllHealthChecks, runAllServiceHealthChecks, runHealthCheck, runServiceHealthCheck, ServiceHealth, } from "./health.js";
 export { mountStandardHealthRpc } from "./health_rpc.js";
-export { HealthCheckResultSchema, HealthResponseSchema, HealthRpcSchema, } from "./health_schemas.js";
-export type { NatsConnectFn, NatsConnectOpts, ReadFileSyncFn, TrellisServiceRuntimeDeps, } from "./runtime.js";
-export { KVHandle, StoreHandle, type ResourceBindingKV, type ResourceBindingStore, type ResourceBindingStream, type ResourceBindings, type ServiceContract, type ServiceTrellis, TrellisService, type TrellisServiceConnectOpts, } from "./service.js";
-export { ServiceTransfer } from "./transfer.js";
-export type { InitiateDownloadArgs, InitiateUploadArgs, TransferStoreHandle, } from "./transfer.js";
+export { HealthHeartbeatHeaderSchema, HealthHeartbeatSchema, HealthHeartbeatServiceSchema, HealthCheckResultSchema, HealthInfoSchema, HealthResponseSchema, HealthRpcSchema, } from "./health_schemas.js";
+export { KVHandle, type ResourceBindingKV, type ResourceBindings, type ResourceBindingStore, type ResourceBindingStream, type ServiceContract, type ServiceHandlerTrellis, type ServiceRpcHandler, type ServiceTrellis, StoreHandle, TrellisService, type TrellisServiceConnectOpts, } from "./service.js";
 export { createEventContext, type EventContext, type EventHandler, type GroupedSubscription, isGroupedSubscription, type MultiEventSubscription, type MultiSubscribeOpts, type OrderingGroup, type SingleSubscription, type SubscribeOpts, } from "./subscription.js";
 //# sourceMappingURL=mod.d.ts.map

package/esm/server/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/server/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAEnE,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,kBAAkB,EAClB,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,aAAa,EACb,eAAe,EACf,cAAc,EACd,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,QAAQ,EACR,WAAW,EACX,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,cAAc,EACd,KAAK,yBAAyB,GAC/B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,YAAY,EACV,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,qBAAqB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,aAAa,GACnB,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/server/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,yBAAyB,EACzB,cAAc,EACd,qBAAqB,EACrB,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,EACrB,4BAA4B,EAC5B,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,QAAQ,EACR,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,WAAW,EACX,cAAc,EACd,KAAK,yBAAyB,GAC/B,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,qBAAqB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,aAAa,GACnB,MAAM,mBAAmB,CAAC"}

package/esm/server/mod.js

@@ -1,17 +1,16 @@
 /**
- * Trellis Server package entry point.
+ * Trellis host package entry point.
  *
- * This package is server-only glue: it re-exports the RPC/event server runtime
- * plus common server helpers (health checks, subscription types).
+ * This package is host-side glue: it re-exports the RPC/event hosting runtime
+ * plus common service helpers (health checks, subscription types).
  *
  * @module
  */
-export { TrellisServer } from "@qlever-llc/trellis/server/runtime";
+export { TrellisServer } from "../server.js";
 // Re-export health types
-export { runAllHealthChecks, runHealthCheck, } from "./health.js";
+export { createHealthHeartbeat, runAllHealthChecks, runAllServiceHealthChecks, runHealthCheck, runServiceHealthCheck, ServiceHealth, } from "./health.js";
 export { mountStandardHealthRpc } from "./health_rpc.js";
-export { HealthCheckResultSchema, HealthResponseSchema, HealthRpcSchema, } from "./health_schemas.js";
+export { HealthHeartbeatHeaderSchema, HealthHeartbeatSchema, HealthHeartbeatServiceSchema, HealthCheckResultSchema, HealthInfoSchema, HealthResponseSchema, HealthRpcSchema, } from "./health_schemas.js";
 export { KVHandle, StoreHandle, TrellisService, } from "./service.js";
-export { ServiceTransfer } from "./transfer.js";
 // Re-export subscription types
 export { createEventContext, isGroupedSubscription, } from "./subscription.js";

package/esm/server/node.d.ts

@@ -1,2 +1,2 @@
-export { KVHandle, type ResourceBindingKV, type ResourceBindingStream, type ResourceBindings, type ServiceContract, type ServiceTrellis, TrellisService, type TrellisServiceConnectOpts, } from "./service.js";
+export { KVHandle, type ResourceBindingKV, type ResourceBindings, type ResourceBindingStream, type ServiceContract, type ServiceHandlerTrellis, type ServiceRpcHandler, type ServiceTrellis, TrellisService, type TrellisServiceConnectOpts, } from "./service.js";
 //# sourceMappingURL=node.d.ts.map

package/esm/server/node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/server/node.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,cAAc,EACd,KAAK,yBAAyB,GAC/B,MAAM,cAAc,CAAC"}
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/server/node.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,cAAc,EACd,KAAK,yBAAyB,GAC/B,MAAM,cAAc,CAAC"}