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

package/script/js/packages/trellis/npm/src/server/health.d.ts.map

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

package/script/js/packages/trellis/npm/src/server/health.js

@@ -0,0 +1,291 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+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;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServiceHealth = void 0;
+exports.runHealthCheck = runHealthCheck;
+exports.runServiceHealthCheck = runServiceHealthCheck;
+exports.runAllHealthChecks = runAllHealthChecks;
+exports.runAllServiceHealthChecks = runAllServiceHealthChecks;
+exports.createHealthHeartbeat = createHealthHeartbeat;
+/**
+ * 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
+ */
+const dntShim = __importStar(require("../_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.
+ *
+ * @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`);
+ * }
+ * ```
+ */
+async function runHealthCheck(name, check) {
+    return await runServiceHealthCheck(name, normalizeLegacyHealthCheck(check));
+}
+async function runServiceHealthCheck(name, check) {
+    const start = performance.now();
+    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,
+        };
+    }
+}
+/**
+ * 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");
+ * }
+ * ```
+ */
+async function runAllHealthChecks(service, checks) {
+    const normalizedChecks = Object.fromEntries(Object.entries(checks).map(([name, check]) => [name, normalizeLegacyHealthCheck(check)]));
+    return await runAllServiceHealthChecks(service, normalizedChecks);
+}
+async function runAllServiceHealthChecks(service, checks) {
+    const results = await Promise.all(Object.entries(checks).map(([name, fn]) => runServiceHealthCheck(name, fn)));
+    return {
+        status: summarizeHealthStatus(results),
+        service,
+        timestamp: new Date().toISOString(),
+        checks: results,
+    };
+}
+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,
+    };
+}
+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,
+        });
+    }
+}
+exports.ServiceHealth = ServiceHealth;
+_ServiceHealth_checks = new WeakMap(), _ServiceHealth_info = new WeakMap();

package/script/js/packages/trellis/npm/src/server/health_rpc.d.ts

@@ -0,0 +1,17 @@
+import type { TrellisAPI } from "@qlever-llc/trellis/contracts";
+import { type HealthCheckFn, type HealthResponse } from "./health.js";
+type HealthRpcServer = {
+    name: string;
+    api: TrellisAPI;
+    natsConnection: {
+        isClosed(): boolean;
+    };
+    mount<M extends keyof TrellisAPI["rpc"] & string>(method: M, handler: (...args: unknown[]) => unknown): Promise<unknown>;
+};
+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/script/js/packages/trellis/npm/src/server/health_rpc.d.ts.map

@@ -0,0 +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,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/script/js/packages/trellis/npm/src/server/health_rpc.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mountStandardHealthRpc = mountStandardHealthRpc;
+const result_1 = require("@qlever-llc/result");
+const health_js_1 = require("./health.js");
+function pascalCase(value) {
+    return value
+        .split(/[^A-Za-z0-9]+/)
+        .filter(Boolean)
+        .map((part) => part[0].toUpperCase() + part.slice(1))
+        .join("");
+}
+async function mountStandardHealthRpc(server, opts) {
+    const rpcName = opts?.rpcName ?? `${pascalCase(server.name)}.Health`;
+    const rpc = server.api.rpc?.[rpcName];
+    if (!rpc)
+        return;
+    const method = rpcName;
+    await server.mount(method, async () => {
+        const response = opts?.response
+            ? await opts.response()
+            : await (0, health_js_1.runAllHealthChecks)(server.name, {
+                nats: async () => result_1.Result.ok(!server.natsConnection.isClosed()),
+                ...(opts?.checks ?? {}),
+            });
+        return result_1.Result.ok(response);
+    });
+}

package/script/js/packages/trellis/npm/src/server/health_schemas.d.ts

@@ -0,0 +1,71 @@
+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<{
+    status: Type.TUnion<[Type.TLiteral<"healthy">, Type.TLiteral<"unhealthy">, Type.TLiteral<"degraded">]>;
+    service: Type.TString;
+    timestamp: 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;
+    }>>;
+}>;
+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;
+    }>>;
+}>;
+//# sourceMappingURL=health_schemas.d.ts.map

package/script/js/packages/trellis/npm/src/server/health_schemas.d.ts.map

@@ -0,0 +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,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/script/js/packages/trellis/npm/src/server/health_schemas.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HealthHeartbeatSchema = exports.HealthHeartbeatServiceSchema = exports.HealthHeartbeatHeaderSchema = exports.HealthResponseSchema = exports.HealthCheckResultSchema = exports.HealthInfoSchema = exports.HealthRpcSchema = void 0;
+const typebox_1 = require("typebox");
+exports.HealthRpcSchema = typebox_1.Type.Object({});
+exports.HealthInfoSchema = typebox_1.Type.Record(typebox_1.Type.String(), typebox_1.Type.Unknown());
+exports.HealthCheckResultSchema = typebox_1.Type.Object({
+    name: typebox_1.Type.String(),
+    status: typebox_1.Type.Union([typebox_1.Type.Literal("ok"), typebox_1.Type.Literal("failed")]),
+    error: typebox_1.Type.Optional(typebox_1.Type.String()),
+    summary: typebox_1.Type.Optional(typebox_1.Type.String()),
+    info: typebox_1.Type.Optional(exports.HealthInfoSchema),
+    latencyMs: typebox_1.Type.Number(),
+});
+exports.HealthResponseSchema = typebox_1.Type.Object({
+    status: typebox_1.Type.Union([
+        typebox_1.Type.Literal("healthy"),
+        typebox_1.Type.Literal("unhealthy"),
+        typebox_1.Type.Literal("degraded"),
+    ]),
+    service: typebox_1.Type.String(),
+    timestamp: typebox_1.Type.String({ format: "date-time" }),
+    checks: typebox_1.Type.Array(exports.HealthCheckResultSchema),
+});
+exports.HealthHeartbeatHeaderSchema = typebox_1.Type.Object({
+    id: typebox_1.Type.String(),
+    time: typebox_1.Type.String({ format: "date-time" }),
+});
+exports.HealthHeartbeatServiceSchema = typebox_1.Type.Object({
+    name: typebox_1.Type.String(),
+    kind: typebox_1.Type.Union([typebox_1.Type.Literal("service"), typebox_1.Type.Literal("device")]),
+    instanceId: typebox_1.Type.String(),
+    contractId: typebox_1.Type.String(),
+    contractDigest: typebox_1.Type.String(),
+    startedAt: typebox_1.Type.String({ format: "date-time" }),
+    publishIntervalMs: typebox_1.Type.Integer({ minimum: 1 }),
+    runtime: typebox_1.Type.Union([
+        typebox_1.Type.Literal("deno"),
+        typebox_1.Type.Literal("node"),
+        typebox_1.Type.Literal("rust"),
+        typebox_1.Type.Literal("unknown"),
+    ]),
+    runtimeVersion: typebox_1.Type.Optional(typebox_1.Type.String()),
+    version: typebox_1.Type.Optional(typebox_1.Type.String()),
+    info: typebox_1.Type.Optional(exports.HealthInfoSchema),
+});
+exports.HealthHeartbeatSchema = typebox_1.Type.Object({
+    header: exports.HealthHeartbeatHeaderSchema,
+    service: exports.HealthHeartbeatServiceSchema,
+    status: typebox_1.Type.Union([
+        typebox_1.Type.Literal("healthy"),
+        typebox_1.Type.Literal("unhealthy"),
+        typebox_1.Type.Literal("degraded"),
+    ]),
+    summary: typebox_1.Type.Optional(typebox_1.Type.String()),
+    checks: typebox_1.Type.Array(exports.HealthCheckResultSchema),
+});

package/script/js/packages/trellis/npm/src/server/mod.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Trellis host package entry point.
+ *
+ * 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 "../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 { 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/script/js/packages/trellis/npm/src/server/mod.d.ts.map

@@ -0,0 +1 @@
+{"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/script/js/packages/trellis/npm/src/server/mod.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * Trellis host package entry point.
+ *
+ * This package is host-side glue: it re-exports the RPC/event hosting runtime
+ * plus common service helpers (health checks, subscription types).
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isGroupedSubscription = exports.createEventContext = exports.TrellisService = exports.StoreHandle = exports.KVHandle = exports.HealthRpcSchema = exports.HealthResponseSchema = exports.HealthInfoSchema = exports.HealthCheckResultSchema = exports.HealthHeartbeatServiceSchema = exports.HealthHeartbeatSchema = exports.HealthHeartbeatHeaderSchema = exports.mountStandardHealthRpc = exports.ServiceHealth = exports.runServiceHealthCheck = exports.runHealthCheck = exports.runAllServiceHealthChecks = exports.runAllHealthChecks = exports.createHealthHeartbeat = exports.TrellisServer = void 0;
+var server_js_1 = require("../server.js");
+Object.defineProperty(exports, "TrellisServer", { enumerable: true, get: function () { return server_js_1.TrellisServer; } });
+// Re-export health types
+var health_js_1 = require("./health.js");
+Object.defineProperty(exports, "createHealthHeartbeat", { enumerable: true, get: function () { return health_js_1.createHealthHeartbeat; } });
+Object.defineProperty(exports, "runAllHealthChecks", { enumerable: true, get: function () { return health_js_1.runAllHealthChecks; } });
+Object.defineProperty(exports, "runAllServiceHealthChecks", { enumerable: true, get: function () { return health_js_1.runAllServiceHealthChecks; } });
+Object.defineProperty(exports, "runHealthCheck", { enumerable: true, get: function () { return health_js_1.runHealthCheck; } });
+Object.defineProperty(exports, "runServiceHealthCheck", { enumerable: true, get: function () { return health_js_1.runServiceHealthCheck; } });
+Object.defineProperty(exports, "ServiceHealth", { enumerable: true, get: function () { return health_js_1.ServiceHealth; } });
+var health_rpc_js_1 = require("./health_rpc.js");
+Object.defineProperty(exports, "mountStandardHealthRpc", { enumerable: true, get: function () { return health_rpc_js_1.mountStandardHealthRpc; } });
+var health_schemas_js_1 = require("./health_schemas.js");
+Object.defineProperty(exports, "HealthHeartbeatHeaderSchema", { enumerable: true, get: function () { return health_schemas_js_1.HealthHeartbeatHeaderSchema; } });
+Object.defineProperty(exports, "HealthHeartbeatSchema", { enumerable: true, get: function () { return health_schemas_js_1.HealthHeartbeatSchema; } });
+Object.defineProperty(exports, "HealthHeartbeatServiceSchema", { enumerable: true, get: function () { return health_schemas_js_1.HealthHeartbeatServiceSchema; } });
+Object.defineProperty(exports, "HealthCheckResultSchema", { enumerable: true, get: function () { return health_schemas_js_1.HealthCheckResultSchema; } });
+Object.defineProperty(exports, "HealthInfoSchema", { enumerable: true, get: function () { return health_schemas_js_1.HealthInfoSchema; } });
+Object.defineProperty(exports, "HealthResponseSchema", { enumerable: true, get: function () { return health_schemas_js_1.HealthResponseSchema; } });
+Object.defineProperty(exports, "HealthRpcSchema", { enumerable: true, get: function () { return health_schemas_js_1.HealthRpcSchema; } });
+var service_js_1 = require("./service.js");
+Object.defineProperty(exports, "KVHandle", { enumerable: true, get: function () { return service_js_1.KVHandle; } });
+Object.defineProperty(exports, "StoreHandle", { enumerable: true, get: function () { return service_js_1.StoreHandle; } });
+Object.defineProperty(exports, "TrellisService", { enumerable: true, get: function () { return service_js_1.TrellisService; } });
+// Re-export subscription types
+var subscription_js_1 = require("./subscription.js");
+Object.defineProperty(exports, "createEventContext", { enumerable: true, get: function () { return subscription_js_1.createEventContext; } });
+Object.defineProperty(exports, "isGroupedSubscription", { enumerable: true, get: function () { return subscription_js_1.isGroupedSubscription; } });

package/script/js/packages/trellis/npm/src/server/node.d.ts

@@ -0,0 +1,2 @@
+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/script/js/packages/trellis/npm/src/server/node.d.ts.map

@@ -0,0 +1 @@
+{"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"}

package/script/js/packages/trellis/npm/src/server/node.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TrellisService = exports.KVHandle = void 0;
+var service_js_1 = require("./service.js");
+Object.defineProperty(exports, "KVHandle", { enumerable: true, get: function () { return service_js_1.KVHandle; } });
+Object.defineProperty(exports, "TrellisService", { enumerable: true, get: function () { return service_js_1.TrellisService; } });

package/script/js/packages/trellis/npm/src/server/runtime.d.ts

@@ -0,0 +1,16 @@
+import type { NatsConnection } from "@nats-io/nats-core";
+export type NatsConnectOpts = {
+    servers: string | string[];
+    token?: string;
+    inboxPrefix?: string;
+    authenticator?: unknown;
+} & Record<string, unknown>;
+export type NatsConnectFn = (opts: NatsConnectOpts) => Promise<NatsConnection>;
+export type NatsCredsAuthenticatorFn = (creds: Uint8Array) => unknown;
+export type ReadFileSyncFn = (path: string) => Uint8Array;
+export type TrellisServiceRuntimeDeps = {
+    connect: NatsConnectFn;
+    credsAuthenticator?: NatsCredsAuthenticatorFn;
+    readFileSync?: ReadFileSyncFn;
+};
+//# sourceMappingURL=runtime.d.ts.map

package/script/js/packages/trellis/npm/src/server/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../../../../src/server/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAOzD,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5B,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,eAAe,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;AAE/E,MAAM,MAAM,wBAAwB,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC;AAEtE,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,UAAU,CAAC;AAE1D,MAAM,MAAM,yBAAyB,GAAG;IACtC,OAAO,EAAE,aAAa,CAAC;IACvB,kBAAkB,CAAC,EAAE,wBAAwB,CAAC;IAC9C,YAAY,CAAC,EAAE,cAAc,CAAC;CAC/B,CAAC"}

package/script/js/packages/trellis/npm/src/server/runtime.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });