@btravstack/core 0.13.0 → 0.14.0

package/dist/index.d.cts

@@ -31,7 +31,7 @@ declare const Instrumentations_base: import("@btravstack/di").ManyPortClass<"Ins
  * without it registers nothing and pays nothing — the Spring Boot starter
  * shape, in one port.
  */
-declare class Instrumentations extends Instrumentations_base<InstrumentationLoader> {}
+export declare class Instrumentations extends Instrumentations_base<InstrumentationLoader> {}
 //#endregion
 //#region src/health.d.ts
 declare const HealthCheckFailed_base: import("unthrown").TaggedErrorConstructor<"HealthCheckFailed">;
@@ -40,7 +40,7 @@ declare const HealthCheckFailed_base: import("unthrown").TaggedErrorConstructor<
  * a health check that throws is a bug in the check; one that fails is the news
  * `/healthz` exists to carry.
  */
-declare class HealthCheckFailed extends HealthCheckFailed_base<{
+export declare class HealthCheckFailed extends HealthCheckFailed_base<{
   readonly reason: string;
 }> {}
 /** One contribution: what to call the component, and how to ask it. */
@@ -57,7 +57,7 @@ declare const HealthChecks_base: import("@btravstack/di").ManyPortClass<"HealthC
  * application never composed contributes nothing — no registration call to
  * forget, and no order to get wrong.
  */
-declare class HealthChecks extends HealthChecks_base<HealthCheck> {}
+export declare class HealthChecks extends HealthChecks_base<HealthCheck> {}
 type ComponentHealth = {
   readonly name: string;
   readonly status: "healthy" | "unhealthy";
@@ -81,7 +81,7 @@ type HealthReport = {
  * escaped, the first would reach the kernel's own `uncaughtException` handler
  * and the second would leave `/healthz` hanging with nothing written.
  */
-declare const runHealthChecks: (checks: readonly HealthCheck[]) => AsyncResult<HealthReport, never>;
+export declare const runHealthChecks: (checks: readonly HealthCheck[]) => AsyncResult<HealthReport, never>;
 //#endregion
 //#region src/observability.d.ts
 /**
@@ -91,7 +91,7 @@ declare const runHealthChecks: (checks: readonly HealthCheck[]) => AsyncResult<H
  */
 type Level = "trace" | "debug" | "info" | "warn" | "error" | "fatal";
 /** The levels in order, least severe first — what `isEnabled` compares through. */
-declare const LEVELS: readonly Level[];
+export declare const LEVELS: readonly Level[];
 /**
  * What a line, a span or a measurement carries besides itself: a flat record of
  * scalars.
@@ -137,9 +137,9 @@ declare const Logger_base: import("@btravstack/di").PortClass<"Logger">;
  * problem into an outage. Synchronous `void`, not an `AsyncResult` — thesis 6's
  * one deliberate exemption, since a lost line is not a modeled error.
  */
-declare class Logger extends Logger_base<LoggerService> {}
+export declare class Logger extends Logger_base<LoggerService> {}
 /** A span's outcome: unset until something says otherwise, then `ok` or `error`. */
-declare const SPAN_STATUS: {
+export declare const SPAN_STATUS: {
   readonly unset: 0;
   readonly ok: 1;
   readonly error: 2;
@@ -169,7 +169,7 @@ declare const Tracer_base: import("@btravstack/di").PortClass<"Tracer">;
  * because a port typed as a vendor's type points the dependency arrow outwards
  * and makes the whole family install that vendor.
  */
-declare class Tracer extends Tracer_base<TracerService> {}
+export declare class Tracer extends Tracer_base<TracerService> {}
 /** A monotonic count. */
 type Counter = {
   readonly add: (value: number, attributes?: Attributes) => void;
@@ -196,7 +196,7 @@ type MeterService = {
 };
 declare const Meter_base: import("@btravstack/di").PortClass<"Meter">;
 /** The application's meter, as a port. See {@link Tracer} for why it does not name a vendor. */
-declare class Meter extends Meter_base<MeterService> {}
+export declare class Meter extends Meter_base<MeterService> {}
 //#endregion
 //#region src/observation.d.ts
 /**
@@ -277,9 +277,9 @@ declare const Observers_base: import("@btravstack/di").ManyPortClass<"Observers"
  * NOTHING provides is an unmet dependency, at plan time and in `Needs` alike.
  * Several no-ops in one graph cost a call each and nothing else.
  */
-declare class Observers extends Observers_base<(operation: Operation) => Settle> {}
+export declare class Observers extends Observers_base<(operation: Operation) => Settle> {}
 /** The no-op member every reader of {@link Observers} contributes, so the set is never empty. */
-declare const noObserver: () => Settle;
+export declare const noObserver: () => Settle;
 /**
  * Run every observer around one operation, and hand back the one finisher that
  * settles them all.
@@ -291,14 +291,14 @@ declare const noObserver: () => Settle;
  * `tapFailure` on the same chain, or a retry, is exactly the shape that fires
  * twice and doubles a failure count.
  */
-declare const observe: (observers: readonly ((operation: Operation) => Settle)[], operation: Operation) => Settle;
+export declare const observe: (observers: readonly ((operation: Operation) => Settle)[], operation: Operation) => Settle;
 //#endregion
 //#region src/clock.d.ts
 type Clock = {
   readonly now: () => number;
   readonly sleep: (ms: number, signal?: AbortSignal) => AsyncResult<void, never>;
 };
-declare const systemClock: Clock;
+export declare const systemClock: Clock;
 //#endregion
 //#region src/units.d.ts
 /**
@@ -317,7 +317,7 @@ type UnitRecord = {
   readonly tenantId: string | undefined;
   readonly signal: AbortSignal;
 };
-declare const currentUnit: () => UnitRecord | undefined;
+export declare const currentUnit: () => UnitRecord | undefined;
 /**
  * What a runtime says about one piece of work as it submits it. `kind` is the
  * category (`"http"`, `"tick"`, `"job"`); `id` identifies **this** unit.
@@ -350,7 +350,7 @@ type UnitRegistry = {
 //#endregion
 //#region src/runtime.d.ts
 declare const RuntimeStartFailed_base: import("unthrown").TaggedErrorConstructor<"RuntimeStartFailed">;
-declare class RuntimeStartFailed extends RuntimeStartFailed_base<{
+export declare class RuntimeStartFailed extends RuntimeStartFailed_base<{
   readonly runtime: string;
   readonly cause: unknown;
 }> {
@@ -442,7 +442,7 @@ type Runtime<Resolves extends AnyPort = never, Info = never> = {
  * process boots exactly one, while each carries its own `Resolves`/`Info` in
  * the type.
  */
-declare const RuntimePort: PortClass<"Runtime">;
+export declare const RuntimePort: PortClass<"Runtime">;
 /** The instance type every runtime port shares — `Extract` this from a module's exports to find its runtime. */
 type RuntimeInstance = InstanceType<PortClass<"Runtime">>;
 /** The `Runtime<Resolves, Info>` a module exports, or `never` when it exports none. */
@@ -480,7 +480,7 @@ type RuntimeInfoOf<X> = RuntimeOf<X> extends {
  * const traceId = typeof parent === "string" ? traceIdOfTraceparent(parent) : undefined;
  * ```
  */
-declare const traceIdOfTraceparent: (header: string) => string | undefined;
+export declare const traceIdOfTraceparent: (header: string) => string | undefined;
 /**
  * `running`, but no later than the kernel's drain deadline — the primitive a
  * `Serving.drain` needs when the work it awaits settles on somebody else's
@@ -500,7 +500,7 @@ declare const traceIdOfTraceparent: (header: string) => string | undefined;
  * (`drain.ts` uses `clock.sleep` for exactly that, so a fake clock can control
  * it) — do not fold the two together.
  */
-declare const releasedBy: (signal: AbortSignal, running: AsyncResult<void, never>) => AsyncResult<void, never>;
+export declare const releasedBy: (signal: AbortSignal, running: AsyncResult<void, never>) => AsyncResult<void, never>;
 //#endregion
 //#region src/drain.d.ts
 type DrainReport = {
@@ -560,7 +560,7 @@ type KernelEvent = {
   readonly cause: unknown;
 };
 type EventSink = (event: KernelEvent) => void;
-declare const stderrSink: EventSink;
+export declare const stderrSink: EventSink;
 //#endregion
 //#region src/phase.d.ts
 type Phase = "building" | "starting" | "serving" | "draining" | "stopping" | "exited";
@@ -668,7 +668,7 @@ type PortIdOf<P> = P extends PortInstance<infer Id, infer _Service> ? Id : P;
 type StartGate<X, N = never> = [Exclude<N, Scope | Env>] extends [never] ? [Extract<X, RuntimeInstance>] extends [never] ? "NO RUNTIME — the module exports no port declared over RuntimePort" : [InstanceType<RuntimeResolvesOf<X>>] extends [X] ? unknown : "UNSATISFIED RUNTIME PORTS — the runtime resolves a port the module does not export" : {
   readonly "UNSATISFIED DEPENDENCIES — nothing provides": PortIdOf<Exclude<N, Scope | Env>>;
 };
-declare const start: <X, E, N>(module: Module<X, E, N> & StartGate<X, N>, options?: StartOptions) => RunningApp<E, RuntimeInfoOf<X>>;
+export declare const start: <X, E, N>(module: Module<X, E, N> & StartGate<X, N>, options?: StartOptions) => RunningApp<E, RuntimeInfoOf<X>>;
 //#endregion
 //#region src/run-main.d.ts
 /**
@@ -703,6 +703,6 @@ declare const start: <X, E, N>(module: Module<X, E, N> & StartGate<X, N>, option
  * await runMain(OrderApi);
  * ```
  */
-declare const runMain: <X, E, N>(module: Module<X, E, N> & StartGate<X, N>, options?: StartOptions, exit?: (code: number) => void) => Promise<void>;
+export declare const runMain: <X, E, N>(module: Module<X, E, N> & StartGate<X, N>, options?: StartOptions, exit?: (code: number) => void) => Promise<void>;
 //#endregion
-export { type Attributes, type Clock, type ComponentHealth, type Counter, type DrainReport, type EventSink, type ExitReport, type HealthCheck, HealthCheckFailed, HealthChecks, type HealthReport, type Histogram, type InstrumentationLoader, Instrumentations, type KernelEvent, LEVELS, type Level, Logger, type LoggerService, Meter, type MeterService, Observers, type Operation, type Phase, type RunUnit, type RunningApp, type Runtime, type RuntimeHost, type RuntimeInfoOf, RuntimePort, RuntimeStartFailed, SPAN_STATUS, type Serving, type Settle, type Settled, type Span, type SpanStatusCode, type StartGate, type StartOptions, type TeardownError, Tracer, type TracerService, type UnitHost, type UnitMeta, type UnitRecord, type UnitRegistry, type UnitWork, currentUnit, noObserver, observe, releasedBy, runHealthChecks, runMain, start, stderrSink, systemClock, traceIdOfTraceparent };
+export type { Attributes, Clock, ComponentHealth, Counter, DrainReport, EventSink, ExitReport, HealthCheck, HealthReport, Histogram, InstrumentationLoader, KernelEvent, Level, LoggerService, MeterService, Operation, Phase, RunUnit, RunningApp, Runtime, RuntimeHost, RuntimeInfoOf, Serving, Settle, Settled, Span, SpanStatusCode, StartGate, StartOptions, TeardownError, TracerService, UnitHost, UnitMeta, UnitRecord, UnitRegistry, UnitWork };

package/dist/index.d.mts

@@ -31,7 +31,7 @@ declare const Instrumentations_base: import("@btravstack/di").ManyPortClass<"Ins
  * without it registers nothing and pays nothing — the Spring Boot starter
  * shape, in one port.
  */
-declare class Instrumentations extends Instrumentations_base<InstrumentationLoader> {}
+export declare class Instrumentations extends Instrumentations_base<InstrumentationLoader> {}
 //#endregion
 //#region src/health.d.ts
 declare const HealthCheckFailed_base: import("unthrown").TaggedErrorConstructor<"HealthCheckFailed">;
@@ -40,7 +40,7 @@ declare const HealthCheckFailed_base: import("unthrown").TaggedErrorConstructor<
  * a health check that throws is a bug in the check; one that fails is the news
  * `/healthz` exists to carry.
  */
-declare class HealthCheckFailed extends HealthCheckFailed_base<{
+export declare class HealthCheckFailed extends HealthCheckFailed_base<{
   readonly reason: string;
 }> {}
 /** One contribution: what to call the component, and how to ask it. */
@@ -57,7 +57,7 @@ declare const HealthChecks_base: import("@btravstack/di").ManyPortClass<"HealthC
  * application never composed contributes nothing — no registration call to
  * forget, and no order to get wrong.
  */
-declare class HealthChecks extends HealthChecks_base<HealthCheck> {}
+export declare class HealthChecks extends HealthChecks_base<HealthCheck> {}
 type ComponentHealth = {
   readonly name: string;
   readonly status: "healthy" | "unhealthy";
@@ -81,7 +81,7 @@ type HealthReport = {
  * escaped, the first would reach the kernel's own `uncaughtException` handler
  * and the second would leave `/healthz` hanging with nothing written.
  */
-declare const runHealthChecks: (checks: readonly HealthCheck[]) => AsyncResult<HealthReport, never>;
+export declare const runHealthChecks: (checks: readonly HealthCheck[]) => AsyncResult<HealthReport, never>;
 //#endregion
 //#region src/observability.d.ts
 /**
@@ -91,7 +91,7 @@ declare const runHealthChecks: (checks: readonly HealthCheck[]) => AsyncResult<H
  */
 type Level = "trace" | "debug" | "info" | "warn" | "error" | "fatal";
 /** The levels in order, least severe first — what `isEnabled` compares through. */
-declare const LEVELS: readonly Level[];
+export declare const LEVELS: readonly Level[];
 /**
  * What a line, a span or a measurement carries besides itself: a flat record of
  * scalars.
@@ -137,9 +137,9 @@ declare const Logger_base: import("@btravstack/di").PortClass<"Logger">;
  * problem into an outage. Synchronous `void`, not an `AsyncResult` — thesis 6's
  * one deliberate exemption, since a lost line is not a modeled error.
  */
-declare class Logger extends Logger_base<LoggerService> {}
+export declare class Logger extends Logger_base<LoggerService> {}
 /** A span's outcome: unset until something says otherwise, then `ok` or `error`. */
-declare const SPAN_STATUS: {
+export declare const SPAN_STATUS: {
   readonly unset: 0;
   readonly ok: 1;
   readonly error: 2;
@@ -169,7 +169,7 @@ declare const Tracer_base: import("@btravstack/di").PortClass<"Tracer">;
  * because a port typed as a vendor's type points the dependency arrow outwards
  * and makes the whole family install that vendor.
  */
-declare class Tracer extends Tracer_base<TracerService> {}
+export declare class Tracer extends Tracer_base<TracerService> {}
 /** A monotonic count. */
 type Counter = {
   readonly add: (value: number, attributes?: Attributes) => void;
@@ -196,7 +196,7 @@ type MeterService = {
 };
 declare const Meter_base: import("@btravstack/di").PortClass<"Meter">;
 /** The application's meter, as a port. See {@link Tracer} for why it does not name a vendor. */
-declare class Meter extends Meter_base<MeterService> {}
+export declare class Meter extends Meter_base<MeterService> {}
 //#endregion
 //#region src/observation.d.ts
 /**
@@ -277,9 +277,9 @@ declare const Observers_base: import("@btravstack/di").ManyPortClass<"Observers"
  * NOTHING provides is an unmet dependency, at plan time and in `Needs` alike.
  * Several no-ops in one graph cost a call each and nothing else.
  */
-declare class Observers extends Observers_base<(operation: Operation) => Settle> {}
+export declare class Observers extends Observers_base<(operation: Operation) => Settle> {}
 /** The no-op member every reader of {@link Observers} contributes, so the set is never empty. */
-declare const noObserver: () => Settle;
+export declare const noObserver: () => Settle;
 /**
  * Run every observer around one operation, and hand back the one finisher that
  * settles them all.
@@ -291,14 +291,14 @@ declare const noObserver: () => Settle;
  * `tapFailure` on the same chain, or a retry, is exactly the shape that fires
  * twice and doubles a failure count.
  */
-declare const observe: (observers: readonly ((operation: Operation) => Settle)[], operation: Operation) => Settle;
+export declare const observe: (observers: readonly ((operation: Operation) => Settle)[], operation: Operation) => Settle;
 //#endregion
 //#region src/clock.d.ts
 type Clock = {
   readonly now: () => number;
   readonly sleep: (ms: number, signal?: AbortSignal) => AsyncResult<void, never>;
 };
-declare const systemClock: Clock;
+export declare const systemClock: Clock;
 //#endregion
 //#region src/units.d.ts
 /**
@@ -317,7 +317,7 @@ type UnitRecord = {
   readonly tenantId: string | undefined;
   readonly signal: AbortSignal;
 };
-declare const currentUnit: () => UnitRecord | undefined;
+export declare const currentUnit: () => UnitRecord | undefined;
 /**
  * What a runtime says about one piece of work as it submits it. `kind` is the
  * category (`"http"`, `"tick"`, `"job"`); `id` identifies **this** unit.
@@ -350,7 +350,7 @@ type UnitRegistry = {
 //#endregion
 //#region src/runtime.d.ts
 declare const RuntimeStartFailed_base: import("unthrown").TaggedErrorConstructor<"RuntimeStartFailed">;
-declare class RuntimeStartFailed extends RuntimeStartFailed_base<{
+export declare class RuntimeStartFailed extends RuntimeStartFailed_base<{
   readonly runtime: string;
   readonly cause: unknown;
 }> {
@@ -442,7 +442,7 @@ type Runtime<Resolves extends AnyPort = never, Info = never> = {
  * process boots exactly one, while each carries its own `Resolves`/`Info` in
  * the type.
  */
-declare const RuntimePort: PortClass<"Runtime">;
+export declare const RuntimePort: PortClass<"Runtime">;
 /** The instance type every runtime port shares — `Extract` this from a module's exports to find its runtime. */
 type RuntimeInstance = InstanceType<PortClass<"Runtime">>;
 /** The `Runtime<Resolves, Info>` a module exports, or `never` when it exports none. */
@@ -480,7 +480,7 @@ type RuntimeInfoOf<X> = RuntimeOf<X> extends {
  * const traceId = typeof parent === "string" ? traceIdOfTraceparent(parent) : undefined;
  * ```
  */
-declare const traceIdOfTraceparent: (header: string) => string | undefined;
+export declare const traceIdOfTraceparent: (header: string) => string | undefined;
 /**
  * `running`, but no later than the kernel's drain deadline — the primitive a
  * `Serving.drain` needs when the work it awaits settles on somebody else's
@@ -500,7 +500,7 @@ declare const traceIdOfTraceparent: (header: string) => string | undefined;
  * (`drain.ts` uses `clock.sleep` for exactly that, so a fake clock can control
  * it) — do not fold the two together.
  */
-declare const releasedBy: (signal: AbortSignal, running: AsyncResult<void, never>) => AsyncResult<void, never>;
+export declare const releasedBy: (signal: AbortSignal, running: AsyncResult<void, never>) => AsyncResult<void, never>;
 //#endregion
 //#region src/drain.d.ts
 type DrainReport = {
@@ -560,7 +560,7 @@ type KernelEvent = {
   readonly cause: unknown;
 };
 type EventSink = (event: KernelEvent) => void;
-declare const stderrSink: EventSink;
+export declare const stderrSink: EventSink;
 //#endregion
 //#region src/phase.d.ts
 type Phase = "building" | "starting" | "serving" | "draining" | "stopping" | "exited";
@@ -668,7 +668,7 @@ type PortIdOf<P> = P extends PortInstance<infer Id, infer _Service> ? Id : P;
 type StartGate<X, N = never> = [Exclude<N, Scope | Env>] extends [never] ? [Extract<X, RuntimeInstance>] extends [never] ? "NO RUNTIME — the module exports no port declared over RuntimePort" : [InstanceType<RuntimeResolvesOf<X>>] extends [X] ? unknown : "UNSATISFIED RUNTIME PORTS — the runtime resolves a port the module does not export" : {
   readonly "UNSATISFIED DEPENDENCIES — nothing provides": PortIdOf<Exclude<N, Scope | Env>>;
 };
-declare const start: <X, E, N>(module: Module<X, E, N> & StartGate<X, N>, options?: StartOptions) => RunningApp<E, RuntimeInfoOf<X>>;
+export declare const start: <X, E, N>(module: Module<X, E, N> & StartGate<X, N>, options?: StartOptions) => RunningApp<E, RuntimeInfoOf<X>>;
 //#endregion
 //#region src/run-main.d.ts
 /**
@@ -703,6 +703,6 @@ declare const start: <X, E, N>(module: Module<X, E, N> & StartGate<X, N>, option
  * await runMain(OrderApi);
  * ```
  */
-declare const runMain: <X, E, N>(module: Module<X, E, N> & StartGate<X, N>, options?: StartOptions, exit?: (code: number) => void) => Promise<void>;
+export declare const runMain: <X, E, N>(module: Module<X, E, N> & StartGate<X, N>, options?: StartOptions, exit?: (code: number) => void) => Promise<void>;
 //#endregion
-export { type Attributes, type Clock, type ComponentHealth, type Counter, type DrainReport, type EventSink, type ExitReport, type HealthCheck, HealthCheckFailed, HealthChecks, type HealthReport, type Histogram, type InstrumentationLoader, Instrumentations, type KernelEvent, LEVELS, type Level, Logger, type LoggerService, Meter, type MeterService, Observers, type Operation, type Phase, type RunUnit, type RunningApp, type Runtime, type RuntimeHost, type RuntimeInfoOf, RuntimePort, RuntimeStartFailed, SPAN_STATUS, type Serving, type Settle, type Settled, type Span, type SpanStatusCode, type StartGate, type StartOptions, type TeardownError, Tracer, type TracerService, type UnitHost, type UnitMeta, type UnitRecord, type UnitRegistry, type UnitWork, currentUnit, noObserver, observe, releasedBy, runHealthChecks, runMain, start, stderrSink, systemClock, traceIdOfTraceparent };
+export type { Attributes, Clock, ComponentHealth, Counter, DrainReport, EventSink, ExitReport, HealthCheck, HealthReport, Histogram, InstrumentationLoader, KernelEvent, Level, LoggerService, MeterService, Operation, Phase, RunUnit, RunningApp, Runtime, RuntimeHost, RuntimeInfoOf, Serving, Settle, Settled, Span, SpanStatusCode, StartGate, StartOptions, TeardownError, TracerService, UnitHost, UnitMeta, UnitRecord, UnitRegistry, UnitWork };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@btravstack/core",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "The application kernel: boot a di module into a running process, and stop it without losing work",
   "keywords": [
     "application",
@@ -46,20 +46,20 @@
   },
   "devDependencies": {
     "@btravstack/tsconfig": "0.4.0",
-    "@types/node": "26.4.0",
-    "@unthrown/vitest": "5.7.0",
+    "@types/node": "26.4.1",
+    "@unthrown/vitest": "5.8.0",
     "@vitest/coverage-v8": "4.1.11",
-    "tsdown": "0.22.14",
+    "tsdown": "0.23.0",
     "typescript": "7.0.2",
-    "unthrown": "5.7.0",
+    "unthrown": "5.8.0",
     "vitest": "4.1.11",
-    "@btravstack/config": "0.13.0",
-    "@btravstack/di": "0.13.0"
+    "@btravstack/config": "0.14.0",
+    "@btravstack/di": "0.14.0"
   },
   "peerDependencies": {
     "unthrown": "^5.0.0",
-    "@btravstack/config": "^0.13.0",
-    "@btravstack/di": "^0.13.0"
+    "@btravstack/config": "^0.14.0",
+    "@btravstack/di": "^0.14.0"
   },
   "engines": {
     "node": ">=22"