@btravstack/core 0.31.0 → 0.32.0

package/README.md

@@ -142,6 +142,14 @@ them and none should own a private copy:
   `ff` — so your runtime falls back to its own id instead of adopting one that
   means nothing. A higher version's extra fields are read rather than refused.
 
+## Application infrastructure exports
+
+`infrastructureExports(imports, provides)` returns the publicly available
+`Logger` and `HealthChecks` ports from imported modules and root providers.
+`InfrastructureExports<I, P>` describes those ports at the type level.
+It follows whole-module re-exports while keeping private providers and business
+ports hidden. Application starters use it alongside their own runtime exports.
+
 ## What you get
 
 - **A drain that survives Kubernetes.** On SIGTERM: readiness flips false, the

package/dist/index.cjs

@@ -1050,6 +1050,14 @@ const noObserverMember = _btravstack_di.Provider.member(Observers)({
 	value: noObserver
 });
 //#endregion
+//#region src/infrastructure-exports.ts
+const exportedPorts = (module) => module.exports.flatMap((entry) => "portId" in entry ? [entry] : exportedPorts(entry));
+/** Export visible Logger and HealthChecks ports without exposing private or business ports. */
+const infrastructureExports = (imports, provides) => {
+	const visible = /* @__PURE__ */ new Set([...imports.flatMap(exportedPorts).map((port) => port.portId), ...provides.map((provider) => provider.port.portId)]);
+	return [Logger, HealthChecks].filter((port) => visible.has(port.portId));
+};
+//#endregion
 exports.HealthCheckFailed = HealthCheckFailed;
 exports.HealthChecks = HealthChecks;
 exports.Instrumentations = Instrumentations;
@@ -1065,6 +1073,7 @@ exports.UnitOverrides = UnitOverrides;
 exports.composeByPrefix = composeByPrefix;
 exports.currentUnit = currentUnit;
 exports.dispatchUnit = dispatchUnit;
+exports.infrastructureExports = infrastructureExports;
 exports.mintPiece = mintPiece;
 exports.noObserver = noObserver;
 exports.noObserverMember = noObserverMember;

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { AsyncResult, FailureView, Result } from "unthrown";
-import { AnyPort, AnyProvider, Context, DependencyGate, Module, PortClass, PortInstance, Provider, Scope, SeedEntry, ServiceOf } from "@btravstack/di";
+import { AnyModule, AnyPort, AnyProvider, Context, DependencyGate, Module, PortClass, PortInstance, Provider, Scope, SeedEntry, ServiceOf } from "@btravstack/di";
 import { Env, Environment, EnvironmentFor } from "@btravstack/config";
 //#region src/instrumentation.d.ts
 /**
@@ -1014,4 +1014,14 @@ export declare const noObserverMember: Provider<Observers, never, never> & {
   readonly port: typeof Observers;
 };
 //#endregion
-export type { AnyUnitModule, Attributes, Clock, ComponentHealth, Counter, DrainReport, EventSink, ExitReport, HealthCheck, HealthReport, Histogram, InstrumentationLoader, KernelEnvironment, KernelEvent, Level, LoggerService, MeterService, Operation, Phase, Refuse, RunUnit, RunningApp, Runtime, RuntimeHost, RuntimeInfoOf, Serving, Settle, Settled, Span, SpanStatusCode, StartEnvironment, StartGate, StartOptions, TeardownError, TracerService, UnitExportsOf, UnitGate, UnitHost, UnitMeta, UnitNeedsOf, UnitOutcome, UnitRecord, UnitRecordOf, UnitRegistry, UnitWork };
+//#region src/infrastructure-exports.d.ts
+type ModuleExports<M> = M extends Module<infer X, infer _E, infer _N> ? X : never;
+type ProviderPorts<P> = P extends Provider<infer X, infer _E, infer _N> ? X : never;
+type Available<I extends readonly AnyModule[], P extends readonly AnyProvider[]> = ModuleExports<I[number]> | ProviderPorts<P[number]>;
+type VisibleInfrastructure<P, Visible> = P extends AnyPort ? InstanceType<P> extends Visible ? P : never : never;
+/** Kernel infrastructure publicly available through an application root. */
+type InfrastructureExports<I extends readonly AnyModule[], P extends readonly AnyProvider[]> = readonly VisibleInfrastructure<typeof Logger | typeof HealthChecks, Available<I, P>>[];
+/** Export visible Logger and HealthChecks ports without exposing private or business ports. */
+export declare const infrastructureExports: <const I extends readonly AnyModule[], const P extends readonly AnyProvider[]>(imports: I, provides: P) => InfrastructureExports<I, P>;
+//#endregion
+export type { AnyUnitModule, Attributes, Clock, ComponentHealth, Counter, DrainReport, EventSink, ExitReport, HealthCheck, HealthReport, Histogram, InfrastructureExports, InstrumentationLoader, KernelEnvironment, KernelEvent, Level, LoggerService, MeterService, Operation, Phase, Refuse, RunUnit, RunningApp, Runtime, RuntimeHost, RuntimeInfoOf, Serving, Settle, Settled, Span, SpanStatusCode, StartEnvironment, StartGate, StartOptions, TeardownError, TracerService, UnitExportsOf, UnitGate, UnitHost, UnitMeta, UnitNeedsOf, UnitOutcome, UnitRecord, UnitRecordOf, UnitRegistry, UnitWork };

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { AnyPort, AnyProvider, Context, DependencyGate, Module, PortClass, PortInstance, Provider, Scope, SeedEntry, ServiceOf } from "@btravstack/di";
+import { AnyModule, AnyPort, AnyProvider, Context, DependencyGate, Module, PortClass, PortInstance, Provider, Scope, SeedEntry, ServiceOf } from "@btravstack/di";
 import { AsyncResult, FailureView, Result } from "unthrown";
 import { Env, Environment, EnvironmentFor } from "@btravstack/config";
 //#region src/instrumentation.d.ts
@@ -1014,4 +1014,14 @@ export declare const noObserverMember: Provider<Observers, never, never> & {
   readonly port: typeof Observers;
 };
 //#endregion
-export type { AnyUnitModule, Attributes, Clock, ComponentHealth, Counter, DrainReport, EventSink, ExitReport, HealthCheck, HealthReport, Histogram, InstrumentationLoader, KernelEnvironment, KernelEvent, Level, LoggerService, MeterService, Operation, Phase, Refuse, RunUnit, RunningApp, Runtime, RuntimeHost, RuntimeInfoOf, Serving, Settle, Settled, Span, SpanStatusCode, StartEnvironment, StartGate, StartOptions, TeardownError, TracerService, UnitExportsOf, UnitGate, UnitHost, UnitMeta, UnitNeedsOf, UnitOutcome, UnitRecord, UnitRecordOf, UnitRegistry, UnitWork };
+//#region src/infrastructure-exports.d.ts
+type ModuleExports<M> = M extends Module<infer X, infer _E, infer _N> ? X : never;
+type ProviderPorts<P> = P extends Provider<infer X, infer _E, infer _N> ? X : never;
+type Available<I extends readonly AnyModule[], P extends readonly AnyProvider[]> = ModuleExports<I[number]> | ProviderPorts<P[number]>;
+type VisibleInfrastructure<P, Visible> = P extends AnyPort ? InstanceType<P> extends Visible ? P : never : never;
+/** Kernel infrastructure publicly available through an application root. */
+type InfrastructureExports<I extends readonly AnyModule[], P extends readonly AnyProvider[]> = readonly VisibleInfrastructure<typeof Logger | typeof HealthChecks, Available<I, P>>[];
+/** Export visible Logger and HealthChecks ports without exposing private or business ports. */
+export declare const infrastructureExports: <const I extends readonly AnyModule[], const P extends readonly AnyProvider[]>(imports: I, provides: P) => InfrastructureExports<I, P>;
+//#endregion
+export type { AnyUnitModule, Attributes, Clock, ComponentHealth, Counter, DrainReport, EventSink, ExitReport, HealthCheck, HealthReport, Histogram, InfrastructureExports, InstrumentationLoader, KernelEnvironment, KernelEvent, Level, LoggerService, MeterService, Operation, Phase, Refuse, RunUnit, RunningApp, Runtime, RuntimeHost, RuntimeInfoOf, Serving, Settle, Settled, Span, SpanStatusCode, StartEnvironment, StartGate, StartOptions, TeardownError, TracerService, UnitExportsOf, UnitGate, UnitHost, UnitMeta, UnitNeedsOf, UnitOutcome, UnitRecord, UnitRecordOf, UnitRegistry, UnitWork };

package/dist/index.mjs

@@ -1049,4 +1049,12 @@ const noObserverMember = Provider.member(Observers)({
 	value: noObserver
 });
 //#endregion
-export { HealthCheckFailed, HealthChecks, Instrumentations, LEVELS, Logger, Meter, Observers, RuntimePort, RuntimeStartFailed, SPAN_STATUS, Tracer, UnitOverrides, composeByPrefix, currentUnit, dispatchUnit, mintPiece, noObserver, noObserverMember, observe, observed, releasedBy, runHealthChecks, runMain, start, stderrSink, systemClock, traceIdOfTraceparent, unitOutcome, withUnitRecord };
+//#region src/infrastructure-exports.ts
+const exportedPorts = (module) => module.exports.flatMap((entry) => "portId" in entry ? [entry] : exportedPorts(entry));
+/** Export visible Logger and HealthChecks ports without exposing private or business ports. */
+const infrastructureExports = (imports, provides) => {
+	const visible = /* @__PURE__ */ new Set([...imports.flatMap(exportedPorts).map((port) => port.portId), ...provides.map((provider) => provider.port.portId)]);
+	return [Logger, HealthChecks].filter((port) => visible.has(port.portId));
+};
+//#endregion
+export { HealthCheckFailed, HealthChecks, Instrumentations, LEVELS, Logger, Meter, Observers, RuntimePort, RuntimeStartFailed, SPAN_STATUS, Tracer, UnitOverrides, composeByPrefix, currentUnit, dispatchUnit, infrastructureExports, mintPiece, noObserver, noObserverMember, observe, observed, releasedBy, runHealthChecks, runMain, start, stderrSink, systemClock, traceIdOfTraceparent, unitOutcome, withUnitRecord };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@btravstack/core",
-  "version": "0.31.0",
+  "version": "0.32.0",
   "description": "The application kernel: boot a di module into a running process, and stop it without losing work",
   "keywords": [
     "application",
@@ -45,8 +45,8 @@
     "./package.json": "./package.json"
   },
   "devDependencies": {
-    "@btravstack/config": "0.31.0",
-    "@btravstack/di": "0.31.0",
+    "@btravstack/config": "0.32.0",
+    "@btravstack/di": "0.32.0",
     "@btravstack/tsconfig": "0.4.0",
     "@stryker-mutator/core": "10.0.0",
     "@stryker-mutator/vitest-runner": "10.0.0",
@@ -60,8 +60,8 @@
     "vitest": "5.0.3"
   },
   "peerDependencies": {
-    "@btravstack/config": "^0.31.0",
-    "@btravstack/di": "^0.31.0",
+    "@btravstack/config": "^0.32.0",
+    "@btravstack/di": "^0.32.0",
     "unthrown": "^5.0.0"
   },
   "engines": {