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

package/script/js/packages/trellis/operations.d.ts

@@ -0,0 +1,103 @@
+import type { InferSchemaType } from "./contracts.ts";
+import { type Result } from "@qlever-llc/result";
+import type { JsonValue } from "./codec.ts";
+import { TransferError, UnexpectedError } from "./errors/index.ts";
+import type { FileInfo, TransferBody, UploadTransferGrant } from "./transfer.ts";
+export type OperationState = "pending" | "running" | "completed" | "failed" | "cancelled";
+export type OperationRefData = {
+    id: string;
+    service: string;
+    operation: string;
+};
+export type OperationSnapshot<TProgress = unknown, TOutput = unknown> = {
+    id: string;
+    service: string;
+    operation: string;
+    revision: number;
+    state: OperationState;
+    createdAt: string;
+    updatedAt: string;
+    completedAt?: string;
+    progress?: TProgress;
+    transfer?: OperationTransferProgress;
+    output?: TOutput;
+    error?: {
+        type: string;
+        message: string;
+    };
+};
+export type OperationTransferProgress = {
+    chunkIndex: number;
+    chunkBytes: number;
+    transferredBytes: number;
+};
+export type TerminalOperation<TProgress = unknown, TOutput = unknown> = OperationSnapshot<TProgress, TOutput> & {
+    state: "completed" | "failed" | "cancelled";
+};
+export type OperationEvent<TProgress = unknown, TOutput = unknown> = {
+    type: "accepted";
+    snapshot: OperationSnapshot<TProgress, TOutput>;
+} | {
+    type: "started";
+    snapshot: OperationSnapshot<TProgress, TOutput>;
+} | {
+    type: "transfer";
+    snapshot: OperationSnapshot<TProgress, TOutput>;
+    transfer: OperationTransferProgress;
+} | {
+    type: "progress";
+    snapshot: OperationSnapshot<TProgress, TOutput>;
+} | {
+    type: "completed";
+    snapshot: TerminalOperation<TProgress, TOutput>;
+} | {
+    type: "failed";
+    snapshot: TerminalOperation<TProgress, TOutput>;
+} | {
+    type: "cancelled";
+    snapshot: TerminalOperation<TProgress, TOutput>;
+};
+type OperationShape = {
+    subject: string;
+    input: unknown;
+    progress?: unknown;
+    output?: unknown;
+    transfer?: {
+        store: string;
+        key: `/${string}`;
+        contentType?: `/${string}`;
+        metadata?: `/${string}`;
+        expiresInMs?: number;
+        maxBytes?: number;
+    };
+    cancel?: boolean;
+};
+type OperationInputOf<TDesc extends OperationShape> = InferSchemaType<TDesc["input"]>;
+type OperationProgressOf<TDesc extends OperationShape> = TDesc["progress"] extends undefined ? unknown : InferSchemaType<NonNullable<TDesc["progress"]>>;
+type OperationOutputOf<TDesc extends OperationShape> = TDesc["output"] extends undefined ? unknown : InferSchemaType<NonNullable<TDesc["output"]>>;
+export interface OperationTransport {
+    requestJson(subject: string, body: JsonValue): Promise<Result<JsonValue, UnexpectedError>>;
+    watchJson(subject: string, body: JsonValue): Promise<Result<AsyncIterable<Result<JsonValue, UnexpectedError>>, UnexpectedError>>;
+    putTransfer(grant: UploadTransferGrant, body: TransferBody): Promise<Result<FileInfo, TransferError>>;
+}
+export declare function controlSubject(subject: string): string;
+export declare class OperationRef<TDesc extends OperationShape, TProgress = OperationProgressOf<TDesc>, TOutput = OperationOutputOf<TDesc>> {
+    #private;
+    readonly id: string;
+    readonly service: string;
+    readonly operation: string;
+    readonly transfer: TDesc["transfer"] extends undefined ? undefined : (body: TransferBody) => Promise<Result<FileInfo, TransferError>>;
+    constructor(transport: OperationTransport, descriptor: TDesc, ref: OperationRefData, acceptedTransfer?: UploadTransferGrant);
+    get(): Promise<Result<OperationSnapshot<TProgress, TOutput>, UnexpectedError>>;
+    wait(): Promise<Result<TerminalOperation<TProgress, TOutput>, UnexpectedError>>;
+    cancel(): Promise<Result<OperationSnapshot<TProgress, TOutput>, UnexpectedError>>;
+    watch(): Promise<Result<AsyncIterable<OperationEvent<TProgress, TOutput>>, UnexpectedError>>;
+}
+export declare class OperationInvoker<TDesc extends OperationShape, TInput = OperationInputOf<TDesc>, TProgress = OperationProgressOf<TDesc>, TOutput = OperationOutputOf<TDesc>> {
+    #private;
+    constructor(transport: OperationTransport, descriptor: TDesc);
+    resume(ref: OperationRefData): OperationRef<TDesc, TProgress, TOutput>;
+    start(input: TInput): Promise<Result<OperationRef<TDesc, TProgress, TOutput>, UnexpectedError>>;
+}
+export {};
+//# sourceMappingURL=operations.d.ts.map

package/script/js/packages/trellis/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../../../../operations.ts"],"names":[],"mappings":"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"}

package/script/js/packages/trellis/operations.js

@@ -0,0 +1,235 @@
+"use strict";
+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 __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 _OperationRef_instances, _OperationRef_transport, _OperationRef_descriptor, _OperationRef_acceptedTransfer, _OperationRef_controlSnapshot, _OperationInvoker_transport, _OperationInvoker_descriptor;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OperationInvoker = exports.OperationRef = void 0;
+exports.controlSubject = controlSubject;
+const result_1 = require("@qlever-llc/result");
+const index_ts_1 = require("./errors/index.js");
+function controlSubject(subject) {
+    return `${subject}.control`;
+}
+function isTerminalState(state) {
+    return state === "completed" || state === "failed" || state === "cancelled";
+}
+function snapshotToEvent(snapshot) {
+    switch (snapshot.state) {
+        case "pending":
+            return { type: "accepted", snapshot };
+        case "running":
+            return { type: "started", snapshot };
+        case "completed":
+            return { type: "completed", snapshot: snapshot };
+        case "failed":
+            return { type: "failed", snapshot: snapshot };
+        case "cancelled":
+            return { type: "cancelled", snapshot: snapshot };
+    }
+}
+function isTerminalEvent(event) {
+    return event.type === "completed" || event.type === "failed" || event.type === "cancelled";
+}
+function decodeAcceptedEnvelope(value) {
+    try {
+        const envelope = value;
+        if (envelope?.kind !== "accepted" || !envelope.ref || !envelope.snapshot) {
+            throw new Error("Expected accepted operation envelope");
+        }
+        return (0, result_1.ok)(envelope);
+    }
+    catch (cause) {
+        return (0, result_1.err)(new index_ts_1.UnexpectedError({ cause }));
+    }
+}
+function decodeSnapshotFrame(value) {
+    try {
+        const frame = value;
+        if (frame?.kind !== "snapshot" || !frame.snapshot) {
+            throw new Error("Expected snapshot operation frame");
+        }
+        return (0, result_1.ok)(frame);
+    }
+    catch (cause) {
+        return (0, result_1.err)(new index_ts_1.UnexpectedError({ cause }));
+    }
+}
+class OperationRef {
+    constructor(transport, descriptor, ref, acceptedTransfer) {
+        _OperationRef_instances.add(this);
+        Object.defineProperty(this, "id", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "service", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "operation", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "transfer", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        _OperationRef_transport.set(this, void 0);
+        _OperationRef_descriptor.set(this, void 0);
+        _OperationRef_acceptedTransfer.set(this, void 0);
+        __classPrivateFieldSet(this, _OperationRef_transport, transport, "f");
+        __classPrivateFieldSet(this, _OperationRef_descriptor, descriptor, "f");
+        this.id = ref.id;
+        this.service = ref.service;
+        this.operation = ref.operation;
+        __classPrivateFieldSet(this, _OperationRef_acceptedTransfer, acceptedTransfer, "f");
+        this.transfer = (descriptor.transfer
+            ? async (body) => {
+                const grant = __classPrivateFieldGet(this, _OperationRef_acceptedTransfer, "f");
+                if (!grant) {
+                    return (0, result_1.err)(new index_ts_1.TransferError({
+                        operation: "transfer",
+                        context: { reason: "missing_transfer" },
+                    }));
+                }
+                return await __classPrivateFieldGet(this, _OperationRef_transport, "f").putTransfer(grant, body);
+            }
+            : undefined);
+    }
+    async get() {
+        return __classPrivateFieldGet(this, _OperationRef_instances, "m", _OperationRef_controlSnapshot).call(this, "get");
+    }
+    async wait() {
+        const snapshot = await __classPrivateFieldGet(this, _OperationRef_instances, "m", _OperationRef_controlSnapshot).call(this, "wait");
+        if (snapshot.isErr()) {
+            return snapshot;
+        }
+        const snapshotValue = snapshot.take();
+        if ((0, result_1.isErr)(snapshotValue)) {
+            return snapshotValue;
+        }
+        if (!isTerminalState(snapshotValue.state)) {
+            return (0, result_1.err)(new index_ts_1.UnexpectedError({ cause: new Error("wait returned non-terminal snapshot") }));
+        }
+        return (0, result_1.ok)(snapshotValue);
+    }
+    async cancel() {
+        return __classPrivateFieldGet(this, _OperationRef_instances, "m", _OperationRef_controlSnapshot).call(this, "cancel");
+    }
+    async watch() {
+        const response = await __classPrivateFieldGet(this, _OperationRef_transport, "f").watchJson(controlSubject(__classPrivateFieldGet(this, _OperationRef_descriptor, "f").subject), {
+            action: "watch",
+            operationId: this.id,
+        });
+        if (response.isErr()) {
+            return (0, result_1.err)(response.error);
+        }
+        const rawIterable = response.take();
+        if ((0, result_1.isErr)(rawIterable)) {
+            return (0, result_1.err)(rawIterable.error);
+        }
+        const iterable = rawIterable;
+        async function* events() {
+            for await (const frame of iterable) {
+                const frameValue = frame.take();
+                if ((0, result_1.isErr)(frameValue)) {
+                    throw frameValue.error;
+                }
+                const decoded = decodeWatchFrame(frameValue);
+                const decodedValue = decoded.take();
+                if ((0, result_1.isErr)(decodedValue)) {
+                    throw decodedValue.error;
+                }
+                if (decodedValue === null) {
+                    continue;
+                }
+                yield decodedValue;
+                if (isTerminalEvent(decodedValue)) {
+                    break;
+                }
+            }
+        }
+        return (0, result_1.ok)(events());
+    }
+}
+exports.OperationRef = OperationRef;
+_OperationRef_transport = new WeakMap(), _OperationRef_descriptor = new WeakMap(), _OperationRef_acceptedTransfer = new WeakMap(), _OperationRef_instances = new WeakSet(), _OperationRef_controlSnapshot = async function _OperationRef_controlSnapshot(action) {
+    const response = await __classPrivateFieldGet(this, _OperationRef_transport, "f").requestJson(controlSubject(__classPrivateFieldGet(this, _OperationRef_descriptor, "f").subject), {
+        action,
+        operationId: this.id,
+    });
+    if (response.isErr()) {
+        return response;
+    }
+    const responseValue = response.take();
+    if ((0, result_1.isErr)(responseValue)) {
+        return responseValue;
+    }
+    const frame = decodeSnapshotFrame(responseValue).take();
+    if ((0, result_1.isErr)(frame)) {
+        return frame;
+    }
+    return (0, result_1.ok)(frame.snapshot);
+};
+function decodeWatchFrame(value) {
+    try {
+        if (value && typeof value === "object" && value.kind === "keepalive") {
+            return (0, result_1.ok)(null);
+        }
+        const frame = value;
+        if (frame.kind === "snapshot" && "snapshot" in frame) {
+            return (0, result_1.ok)(snapshotToEvent(frame.snapshot));
+        }
+        if (frame.kind === "event" && "event" in frame) {
+            return (0, result_1.ok)(frame.event);
+        }
+        throw new Error("Expected snapshot, event, or keepalive frame");
+    }
+    catch (cause) {
+        return (0, result_1.err)(new index_ts_1.UnexpectedError({ cause }));
+    }
+}
+class OperationInvoker {
+    constructor(transport, descriptor) {
+        _OperationInvoker_transport.set(this, void 0);
+        _OperationInvoker_descriptor.set(this, void 0);
+        __classPrivateFieldSet(this, _OperationInvoker_transport, transport, "f");
+        __classPrivateFieldSet(this, _OperationInvoker_descriptor, descriptor, "f");
+    }
+    resume(ref) {
+        return new OperationRef(__classPrivateFieldGet(this, _OperationInvoker_transport, "f"), __classPrivateFieldGet(this, _OperationInvoker_descriptor, "f"), ref);
+    }
+    async start(input) {
+        const response = await __classPrivateFieldGet(this, _OperationInvoker_transport, "f").requestJson(__classPrivateFieldGet(this, _OperationInvoker_descriptor, "f").subject, input);
+        if (response.isErr()) {
+            return response;
+        }
+        const responseValue = response.take();
+        if ((0, result_1.isErr)(responseValue)) {
+            return responseValue;
+        }
+        const envelope = decodeAcceptedEnvelope(responseValue).take();
+        if ((0, result_1.isErr)(envelope)) {
+            return envelope;
+        }
+        return (0, result_1.ok)(new OperationRef(__classPrivateFieldGet(this, _OperationInvoker_transport, "f"), __classPrivateFieldGet(this, _OperationInvoker_descriptor, "f"), envelope.ref, envelope.transfer));
+    }
+}
+exports.OperationInvoker = OperationInvoker;
+_OperationInvoker_transport = new WeakMap(), _OperationInvoker_descriptor = new WeakMap();

package/script/js/packages/trellis/runtime_transport.d.ts

@@ -0,0 +1,21 @@
+import type { Authenticator, NatsConnection } from "@nats-io/nats-core";
+type RuntimeTransportEndpoints = {
+    natsServers: string[];
+};
+type RuntimeTransports = {
+    native?: RuntimeTransportEndpoints;
+    websocket?: RuntimeTransportEndpoints;
+};
+export type RuntimeTransportConnectOptions = {
+    servers: string | string[];
+    token?: string;
+    authenticator?: Authenticator | Authenticator[];
+    inboxPrefix?: string;
+};
+export type RuntimeTransport = {
+    connect(options: RuntimeTransportConnectOptions): Promise<NatsConnection>;
+};
+export declare function selectRuntimeTransportServers(transports: RuntimeTransports): string[];
+export declare function loadDefaultRuntimeTransport(): Promise<RuntimeTransport>;
+export {};
+//# sourceMappingURL=runtime_transport.d.ts.map

package/script/js/packages/trellis/runtime_transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime_transport.d.ts","sourceRoot":"","sources":["../../../../../runtime_transport.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAExE,KAAK,yBAAyB,GAAG;IAC/B,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,MAAM,CAAC,EAAE,yBAAyB,CAAC;IACnC,SAAS,CAAC,EAAE,yBAAyB,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,aAAa,GAAG,aAAa,EAAE,CAAC;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,CAAC,OAAO,EAAE,8BAA8B,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC3E,CAAC;AAEF,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAUrF;AAkBD,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,gBAAgB,CAAC,CA4B7E"}

package/script/js/packages/trellis/runtime_transport.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.selectRuntimeTransportServers = selectRuntimeTransportServers;
+exports.loadDefaultRuntimeTransport = loadDefaultRuntimeTransport;
+const nats_core_1 = require("@nats-io/nats-core");
+function selectRuntimeTransportServers(transports) {
+    if (isBrowserRuntime()) {
+        if (transports.websocket?.natsServers?.length)
+            return transports.websocket.natsServers;
+        if (transports.native?.natsServers?.length)
+            return transports.native.natsServers;
+    }
+    else {
+        if (transports.native?.natsServers?.length)
+            return transports.native.natsServers;
+        if (transports.websocket?.natsServers?.length)
+            return transports.websocket.natsServers;
+    }
+    throw new Error("No supported NATS transport endpoints available");
+}
+function isBrowserRuntime() {
+    return typeof window !== "undefined" && typeof document !== "undefined";
+}
+function usesWebSocketTransport(servers) {
+    const values = Array.isArray(servers) ? servers : [servers];
+    return values.some((server) => server.startsWith("ws://") || server.startsWith("wss://"));
+}
+function runtimeImport(specifier) {
+    const load = new Function("specifier", "return import(specifier);");
+    return load(specifier);
+}
+async function loadDefaultRuntimeTransport() {
+    if (isBrowserRuntime()) {
+        return {
+            connect: nats_core_1.wsconnect,
+        };
+    }
+    if ("Deno" in globalThis) {
+        return {
+            connect: async (options) => {
+                if (usesWebSocketTransport(options.servers)) {
+                    return await (0, nats_core_1.wsconnect)(options);
+                }
+                const mod = await runtimeImport(["@nats-io", "transport-deno"].join("/"));
+                return await mod.connect(options);
+            },
+        };
+    }
+    const mod = await runtimeImport(["@nats-io", "transport-node"].join("/"));
+    return {
+        connect: mod.connect,
+    };
+}

package/script/js/packages/trellis/sdk/core.d.ts

@@ -0,0 +1,3 @@
+export * from "../../../../generated/js/sdks/trellis-core/mod.ts";
+export { core } from "../../../../generated/js/sdks/trellis-core/mod.ts";
+//# sourceMappingURL=core.d.ts.map

package/script/js/packages/trellis/sdk/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../../../sdk/core.ts"],"names":[],"mappings":"AAAA,cAAc,mDAAmD,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,mDAAmD,CAAC"}

package/script/js/packages/trellis/sdk/core.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.core = void 0;
+__exportStar(require("../../../../generated/js/sdks/trellis-core/mod.js"), exports);
+var mod_ts_1 = require("../../../../generated/js/sdks/trellis-core/mod.js");
+Object.defineProperty(exports, "core", { enumerable: true, get: function () { return mod_ts_1.core; } });

package/script/js/packages/trellis/server/health.d.ts

@@ -0,0 +1,170 @@
+/**
+ * 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.
+ *
+ * The function should return:
+ * - `Result.ok(true)` when the check passes
+ * - `Result.ok(false)` when the check fails without an error
+ * - `Result.err(error)` when the check fails with an error
+ */
+export type HealthCheckFn = () => Promise<Result<boolean, TrellisError>>;
+/**
+ * Result of a single health check.
+ */
+export type HealthCheckResult = {
+    /** Name of the health check */
+    name: string;
+    /** Status of the check: "ok" if passed, "failed" if not */
+    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.
+ */
+export type HealthResponse = {
+    /** Overall status: "healthy" if all pass, "unhealthy" if all fail, "degraded" if mixed */
+    status: "healthy" | "unhealthy" | "degraded";
+    /** Name of the service */
+    service: string;
+    /** ISO timestamp of when the health check was performed */
+    timestamp: string;
+    /** Individual health check results */
+    checks: HealthCheckResult[];
+};
+/**
+ * Runs a single health check and returns the result.
+ *
+ * @param name - Name to identify this health check
+ * @param check - The health check function to run
+ * @returns A HealthCheckResult with status, latency, and optional error
+ *
+ * @example
+ * ```typescript
+ * const result = await runHealthCheck("database", async () => {
+ *   const connected = await db.ping();
+ *   return Result.ok(connected);
+ * });
+ *
+ * if (result.status === "ok") {
+ *   console.log(`Database check passed in ${result.latencyMs}ms`);
+ * }
+ * ```
+ */
+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.
+ *
+ * @param service - Name of the service being checked
+ * @param checks - Record of check names to check functions
+ * @returns A HealthResponse with overall status and individual check results
+ *
+ * @example
+ * ```typescript
+ * const health = await runAllHealthChecks("api-service", {
+ *   database: async () => Result.ok(await db.ping()),
+ *   cache: async () => Result.ok(await redis.ping()),
+ *   queue: async () => Result.ok(await rabbit.ping()),
+ * });
+ *
+ * if (health.status === "healthy") {
+ *   console.log("All systems operational");
+ * } else if (health.status === "degraded") {
+ *   console.warn("Some systems are failing");
+ * } else {
+ *   console.error("Service is unhealthy");
+ * }
+ * ```
+ */
+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/script/js/packages/trellis/server/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../../../../../server/health.ts"],"names":[],"mappings":"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"}