brass-runtime 1.16.1 → 1.17.0

package/dist/perf/cli.cjs

@@ -15,7 +15,7 @@
 
 
 
-var _chunkVN44DYYTcjs = require('../chunk-VN44DYYT.cjs');
+var _chunk7ZPEZ57Lcjs = require('../chunk-7ZPEZ57L.cjs');
 require('../chunk-PD4EJTQC.cjs');
 require('../chunk-KQLYONSE.cjs');
 require('../chunk-5EC274J5.cjs');
@@ -24,8 +24,8 @@ require('../chunk-KZJQ723N.cjs');
 require('../chunk-SA6HUJVI.cjs');
 require('../chunk-AGR5B2BC.cjs');
 require('../chunk-JF5WGYJJ.cjs');
-require('../chunk-76YMRMH2.cjs');
-require('../chunk-ENKODRU3.cjs');
+require('../chunk-F6XWZQY4.cjs');
+require('../chunk-WBGRHGBP.cjs');
 require('../chunk-52PPNNI4.cjs');
 require('../chunk-3LOYJFRR.cjs');
 require('../chunk-GLE2WY7Z.cjs');
@@ -37,22 +37,22 @@ require('../chunk-OBGZSXTJ.cjs');
 async function main(argv) {
   const cli = parseArgs(argv);
   if (cli.profile === "runtime-ab") {
-    const report2 = await _chunkVN44DYYTcjs.profileRuntimeAb.call(void 0, cli.runtimeAb);
-    await printReport(cli, report2, _chunkVN44DYYTcjs.formatRuntimeAbReport.call(void 0, report2));
+    const report2 = await _chunk7ZPEZ57Lcjs.profileRuntimeAb.call(void 0, cli.runtimeAb);
+    await printReport(cli, report2, _chunk7ZPEZ57Lcjs.formatRuntimeAbReport.call(void 0, report2));
     return;
   }
   if (cli.profile === "runtime-soak") {
-    const report2 = await _chunkVN44DYYTcjs.profileRuntimeSoak.call(void 0, cli.runtimeSoak);
-    await printReport(cli, report2, _chunkVN44DYYTcjs.formatRuntimeSoakReport.call(void 0, report2));
+    const report2 = await _chunk7ZPEZ57Lcjs.profileRuntimeSoak.call(void 0, cli.runtimeSoak);
+    await printReport(cli, report2, _chunk7ZPEZ57Lcjs.formatRuntimeSoakReport.call(void 0, report2));
     return;
   }
   if (cli.profile === "http-memory") {
-    const report2 = await _chunkVN44DYYTcjs.profileHttpMemoryLab.call(void 0, cli.httpMemory);
-    await printReport(cli, report2, _chunkVN44DYYTcjs.formatHttpMemoryLabReport.call(void 0, report2));
+    const report2 = await _chunk7ZPEZ57Lcjs.profileHttpMemoryLab.call(void 0, cli.httpMemory);
+    await printReport(cli, report2, _chunk7ZPEZ57Lcjs.formatHttpMemoryLabReport.call(void 0, report2));
     return;
   }
-  const report = await _chunkVN44DYYTcjs.runBrassPerformanceProfile.call(void 0, cli.options);
-  await printReport(cli, report, _chunkVN44DYYTcjs.formatPerformanceReport.call(void 0, report));
+  const report = await _chunk7ZPEZ57Lcjs.runBrassPerformanceProfile.call(void 0, cli.options);
+  await printReport(cli, report, _chunk7ZPEZ57Lcjs.formatPerformanceReport.call(void 0, report));
 }
 function parseArgs(argv) {
   let json = envBool("BRASS_PERF_JSON", false);
@@ -295,14 +295,14 @@ async function maybeHandleHistory(cli, report) {
       cliProfile: cli.profile
     }
   };
-  const entry = _chunkVN44DYYTcjs.createPerfHistoryEntry.call(void 0, cli.profile, report, storeOptions);
-  const historyPath = config.recordHistory ? await _chunkVN44DYYTcjs.writePerfHistoryEntry.call(void 0, entry, storeOptions) : void 0;
-  const savedBaseline = config.saveBaseline ? await _chunkVN44DYYTcjs.savePerfBaseline.call(void 0, config.saveBaseline, entry, storeOptions) : void 0;
-  const loadedBaseline = config.compareBaseline ? await _chunkVN44DYYTcjs.loadPerfBaseline.call(void 0, config.compareBaseline, storeOptions) : void 0;
+  const entry = _chunk7ZPEZ57Lcjs.createPerfHistoryEntry.call(void 0, cli.profile, report, storeOptions);
+  const historyPath = config.recordHistory ? await _chunk7ZPEZ57Lcjs.writePerfHistoryEntry.call(void 0, entry, storeOptions) : void 0;
+  const savedBaseline = config.saveBaseline ? await _chunk7ZPEZ57Lcjs.savePerfBaseline.call(void 0, config.saveBaseline, entry, storeOptions) : void 0;
+  const loadedBaseline = config.compareBaseline ? await _chunk7ZPEZ57Lcjs.loadPerfBaseline.call(void 0, config.compareBaseline, storeOptions) : void 0;
   if (config.compareBaseline && !loadedBaseline) {
     throw new Error(`Perf baseline '${config.compareBaseline}' was not found`);
   }
-  const comparison = loadedBaseline ? _chunkVN44DYYTcjs.comparePerfToBaseline.call(void 0, entry, loadedBaseline, config.thresholds) : void 0;
+  const comparison = loadedBaseline ? _chunk7ZPEZ57Lcjs.comparePerfToBaseline.call(void 0, entry, loadedBaseline, config.thresholds) : void 0;
   return Object.freeze({
     entry,
     ...historyPath !== void 0 ? { historyPath } : {},
@@ -317,7 +317,7 @@ function formatCliHistory(history) {
   if (history.savedBaselinePath) lines.push(`- baseline saved: ${history.savedBaselinePath}`);
   if (history.comparison) {
     lines.push("");
-    lines.push(_chunkVN44DYYTcjs.formatPerfBaselineComparison.call(void 0, history.comparison));
+    lines.push(_chunk7ZPEZ57Lcjs.formatPerfBaselineComparison.call(void 0, history.comparison));
   }
   return lines.join("\n");
 }
@@ -335,7 +335,7 @@ function parseRuntimeVariant(value) {
   throw new Error(`Invalid runtime variant: ${value}`);
 }
 function parseVariants(value) {
-  const allowed = new Set(_chunkVN44DYYTcjs.HTTP_PROFILE_VARIANTS);
+  const allowed = new Set(_chunk7ZPEZ57Lcjs.HTTP_PROFILE_VARIANTS);
   return Object.freeze(value.split(",").map((item) => item.trim()).filter(Boolean).map((item) => {
     if (!allowed.has(item)) {
       throw new Error(`Invalid HTTP profile variant: ${item}`);

package/dist/perf/cli.js

@@ -15,7 +15,7 @@ import {
   runBrassPerformanceProfile,
   savePerfBaseline,
   writePerfHistoryEntry
-} from "../chunk-BABBZK4Y.js";
+} from "../chunk-7X3K5RMS.js";
 import "../chunk-5QC7LRZ3.js";
 import "../chunk-74ZTY6CP.js";
 import "../chunk-MIIYDLGM.js";
@@ -24,8 +24,8 @@ import "../chunk-7JIJOVCT.js";
 import "../chunk-UCUBNWM2.js";
 import "../chunk-6IXXWIUM.js";
 import "../chunk-L2SYFEBS.js";
-import "../chunk-AVNQLJ5V.js";
-import "../chunk-CIZFIMK5.js";
+import "../chunk-VWIPB6I5.js";
+import "../chunk-BKK77SBA.js";
 import "../chunk-RKGKFN2A.js";
 import "../chunk-3Y2RIUMM.js";
 import "../chunk-FH2X7BVP.js";

package/dist/perf/cli.mjs

@@ -15,7 +15,7 @@ import {
   runBrassPerformanceProfile,
   savePerfBaseline,
   writePerfHistoryEntry
-} from "../chunk-HLWLMW2F.mjs";
+} from "../chunk-6RY2FFN4.mjs";
 import "../chunk-EOC4UHBS.mjs";
 import "../chunk-7CMJS3QE.mjs";
 import "../chunk-5VRJNBLZ.mjs";
@@ -24,8 +24,8 @@ import "../chunk-FHQGHPMO.mjs";
 import "../chunk-B5JD23U7.mjs";
 import "../chunk-2HQTDLHF.mjs";
 import "../chunk-A2OM6NEH.mjs";
-import "../chunk-DNFO2EIZ.mjs";
-import "../chunk-MT3OWDPC.mjs";
+import "../chunk-SK7UZRNI.mjs";
+import "../chunk-4P2HHGAX.mjs";
 import "../chunk-EJ6BPYVR.mjs";
 import "../chunk-PWC3RBQE.mjs";
 import "../chunk-GYM3LLGS.mjs";

package/dist/perf/index.cjs

@@ -30,7 +30,7 @@
 
 
 
-var _chunkVN44DYYTcjs = require('../chunk-VN44DYYT.cjs');
+var _chunk7ZPEZ57Lcjs = require('../chunk-7ZPEZ57L.cjs');
 require('../chunk-PD4EJTQC.cjs');
 require('../chunk-KQLYONSE.cjs');
 require('../chunk-5EC274J5.cjs');
@@ -39,8 +39,8 @@ require('../chunk-KZJQ723N.cjs');
 require('../chunk-SA6HUJVI.cjs');
 require('../chunk-AGR5B2BC.cjs');
 require('../chunk-JF5WGYJJ.cjs');
-require('../chunk-76YMRMH2.cjs');
-require('../chunk-ENKODRU3.cjs');
+require('../chunk-F6XWZQY4.cjs');
+require('../chunk-WBGRHGBP.cjs');
 require('../chunk-52PPNNI4.cjs');
 require('../chunk-3LOYJFRR.cjs');
 require('../chunk-GLE2WY7Z.cjs');
@@ -50,7 +50,7 @@ require('../chunk-OBGZSXTJ.cjs');
 
 // src/perf/budget.ts
 async function runRuntimePerfBudget(options = {}) {
-  const ab = await _chunkVN44DYYTcjs.profileRuntimeAb.call(void 0, {
+  const ab = await _chunk7ZPEZ57Lcjs.profileRuntimeAb.call(void 0, {
     ...options,
     thresholds: {
       maxRegressionPercent: _nullishCoalesce(_optionalChain([options, 'access', _ => _.thresholds, 'optionalAccess', _2 => _2.maxRegressionPercent]), () => ( 50)),
@@ -138,4 +138,4 @@ function positiveNumber(value, fallback) {
 
 
 
-exports.HTTP_PROFILE_VARIANTS = _chunkVN44DYYTcjs.HTTP_PROFILE_VARIANTS; exports.captureMemorySnapshot = _chunkVN44DYYTcjs.captureMemorySnapshot; exports.comparePerfToBaseline = _chunkVN44DYYTcjs.comparePerfToBaseline; exports.compareRuntimeProfiles = _chunkVN44DYYTcjs.compareRuntimeProfiles; exports.createPerfHistoryEntry = _chunkVN44DYYTcjs.createPerfHistoryEntry; exports.defaultPerfHistoryDirectory = _chunkVN44DYYTcjs.defaultPerfHistoryDirectory; exports.diagnoseRuntimeProfile = _chunkVN44DYYTcjs.diagnoseRuntimeProfile; exports.diffMemorySnapshots = _chunkVN44DYYTcjs.diffMemorySnapshots; exports.extractPerfMetrics = _chunkVN44DYYTcjs.extractPerfMetrics; exports.forceGc = _chunkVN44DYYTcjs.forceGc; exports.formatHttpMemoryLabReport = _chunkVN44DYYTcjs.formatHttpMemoryLabReport; exports.formatPerfBaselineComparison = _chunkVN44DYYTcjs.formatPerfBaselineComparison; exports.formatPerformanceReport = _chunkVN44DYYTcjs.formatPerformanceReport; exports.formatRuntimeAbReport = _chunkVN44DYYTcjs.formatRuntimeAbReport; exports.formatRuntimePerfBudgetReport = formatRuntimePerfBudgetReport; exports.formatRuntimeSoakReport = _chunkVN44DYYTcjs.formatRuntimeSoakReport; exports.hasGc = _chunkVN44DYYTcjs.hasGc; exports.loadPerfBaseline = _chunkVN44DYYTcjs.loadPerfBaseline; exports.makePerfRecorder = _chunkVN44DYYTcjs.makePerfRecorder; exports.profileHttpLayers = _chunkVN44DYYTcjs.profileHttpLayers; exports.profileHttpMemoryLab = _chunkVN44DYYTcjs.profileHttpMemoryLab; exports.profileMemoryRetention = _chunkVN44DYYTcjs.profileMemoryRetention; exports.profileRuntimeAb = _chunkVN44DYYTcjs.profileRuntimeAb; exports.profileRuntimePrimitives = _chunkVN44DYYTcjs.profileRuntimePrimitives; exports.profileRuntimeSoak = _chunkVN44DYYTcjs.profileRuntimeSoak; exports.readPerfHistory = _chunkVN44DYYTcjs.readPerfHistory; exports.recommendPerformance = _chunkVN44DYYTcjs.recommendPerformance; exports.recordPerfHistoryRun = _chunkVN44DYYTcjs.recordPerfHistoryRun; exports.runBrassPerformanceProfile = _chunkVN44DYYTcjs.runBrassPerformanceProfile; exports.runRuntimePerfBudget = runRuntimePerfBudget; exports.savePerfBaseline = _chunkVN44DYYTcjs.savePerfBaseline; exports.summarizePerfEvents = _chunkVN44DYYTcjs.summarizePerfEvents; exports.writePerfHistoryEntry = _chunkVN44DYYTcjs.writePerfHistoryEntry;
+exports.HTTP_PROFILE_VARIANTS = _chunk7ZPEZ57Lcjs.HTTP_PROFILE_VARIANTS; exports.captureMemorySnapshot = _chunk7ZPEZ57Lcjs.captureMemorySnapshot; exports.comparePerfToBaseline = _chunk7ZPEZ57Lcjs.comparePerfToBaseline; exports.compareRuntimeProfiles = _chunk7ZPEZ57Lcjs.compareRuntimeProfiles; exports.createPerfHistoryEntry = _chunk7ZPEZ57Lcjs.createPerfHistoryEntry; exports.defaultPerfHistoryDirectory = _chunk7ZPEZ57Lcjs.defaultPerfHistoryDirectory; exports.diagnoseRuntimeProfile = _chunk7ZPEZ57Lcjs.diagnoseRuntimeProfile; exports.diffMemorySnapshots = _chunk7ZPEZ57Lcjs.diffMemorySnapshots; exports.extractPerfMetrics = _chunk7ZPEZ57Lcjs.extractPerfMetrics; exports.forceGc = _chunk7ZPEZ57Lcjs.forceGc; exports.formatHttpMemoryLabReport = _chunk7ZPEZ57Lcjs.formatHttpMemoryLabReport; exports.formatPerfBaselineComparison = _chunk7ZPEZ57Lcjs.formatPerfBaselineComparison; exports.formatPerformanceReport = _chunk7ZPEZ57Lcjs.formatPerformanceReport; exports.formatRuntimeAbReport = _chunk7ZPEZ57Lcjs.formatRuntimeAbReport; exports.formatRuntimePerfBudgetReport = formatRuntimePerfBudgetReport; exports.formatRuntimeSoakReport = _chunk7ZPEZ57Lcjs.formatRuntimeSoakReport; exports.hasGc = _chunk7ZPEZ57Lcjs.hasGc; exports.loadPerfBaseline = _chunk7ZPEZ57Lcjs.loadPerfBaseline; exports.makePerfRecorder = _chunk7ZPEZ57Lcjs.makePerfRecorder; exports.profileHttpLayers = _chunk7ZPEZ57Lcjs.profileHttpLayers; exports.profileHttpMemoryLab = _chunk7ZPEZ57Lcjs.profileHttpMemoryLab; exports.profileMemoryRetention = _chunk7ZPEZ57Lcjs.profileMemoryRetention; exports.profileRuntimeAb = _chunk7ZPEZ57Lcjs.profileRuntimeAb; exports.profileRuntimePrimitives = _chunk7ZPEZ57Lcjs.profileRuntimePrimitives; exports.profileRuntimeSoak = _chunk7ZPEZ57Lcjs.profileRuntimeSoak; exports.readPerfHistory = _chunk7ZPEZ57Lcjs.readPerfHistory; exports.recommendPerformance = _chunk7ZPEZ57Lcjs.recommendPerformance; exports.recordPerfHistoryRun = _chunk7ZPEZ57Lcjs.recordPerfHistoryRun; exports.runBrassPerformanceProfile = _chunk7ZPEZ57Lcjs.runBrassPerformanceProfile; exports.runRuntimePerfBudget = runRuntimePerfBudget; exports.savePerfBaseline = _chunk7ZPEZ57Lcjs.savePerfBaseline; exports.summarizePerfEvents = _chunk7ZPEZ57Lcjs.summarizePerfEvents; exports.writePerfHistoryEntry = _chunk7ZPEZ57Lcjs.writePerfHistoryEntry;

package/dist/perf/index.js

@@ -30,7 +30,7 @@ import {
   savePerfBaseline,
   summarizePerfEvents,
   writePerfHistoryEntry
-} from "../chunk-BABBZK4Y.js";
+} from "../chunk-7X3K5RMS.js";
 import "../chunk-5QC7LRZ3.js";
 import "../chunk-74ZTY6CP.js";
 import "../chunk-MIIYDLGM.js";
@@ -39,8 +39,8 @@ import "../chunk-7JIJOVCT.js";
 import "../chunk-UCUBNWM2.js";
 import "../chunk-6IXXWIUM.js";
 import "../chunk-L2SYFEBS.js";
-import "../chunk-AVNQLJ5V.js";
-import "../chunk-CIZFIMK5.js";
+import "../chunk-VWIPB6I5.js";
+import "../chunk-BKK77SBA.js";
 import "../chunk-RKGKFN2A.js";
 import "../chunk-3Y2RIUMM.js";
 import "../chunk-FH2X7BVP.js";

package/dist/perf/index.mjs

@@ -30,7 +30,7 @@ import {
   savePerfBaseline,
   summarizePerfEvents,
   writePerfHistoryEntry
-} from "../chunk-HLWLMW2F.mjs";
+} from "../chunk-6RY2FFN4.mjs";
 import "../chunk-EOC4UHBS.mjs";
 import "../chunk-7CMJS3QE.mjs";
 import "../chunk-5VRJNBLZ.mjs";
@@ -39,8 +39,8 @@ import "../chunk-FHQGHPMO.mjs";
 import "../chunk-B5JD23U7.mjs";
 import "../chunk-2HQTDLHF.mjs";
 import "../chunk-A2OM6NEH.mjs";
-import "../chunk-DNFO2EIZ.mjs";
-import "../chunk-MT3OWDPC.mjs";
+import "../chunk-SK7UZRNI.mjs";
+import "../chunk-4P2HHGAX.mjs";
 import "../chunk-EJ6BPYVR.mjs";
 import "../chunk-PWC3RBQE.mjs";
 import "../chunk-GYM3LLGS.mjs";

package/dist/{server-GJPg8ZSG.d.ts → server-D6JZ15_e.d.ts}

@@ -412,6 +412,17 @@ type ObservabilityOtlpOptions = {
     readonly retry?: ExportRetryOptions;
     readonly pipeline?: ExportPipelineTuning;
 };
+type ObservabilityOtlpSignal = "metrics" | "traces" | "logs";
+type MakeOtlpOptionsInput = {
+    readonly endpoint: string;
+    readonly headers?: ObservabilityOtlpOptions["headers"];
+    readonly fetch?: ObservabilityOtlpOptions["fetch"];
+    readonly timeoutMs?: ObservabilityOtlpOptions["timeoutMs"];
+    readonly retry?: ObservabilityOtlpOptions["retry"];
+    readonly pipeline?: ObservabilityOtlpOptions["pipeline"];
+    readonly signals?: readonly ObservabilityOtlpSignal[];
+};
+declare function makeOtlpOptions(input: MakeOtlpOptionsInput): ObservabilityOtlpOptions;
 type ObservabilityOptions = {
     readonly serviceName?: string;
     readonly serviceVersion?: string;
@@ -672,4 +683,4 @@ type ObservedHttpServerResult<A> = {
 declare function runObservedHttpServerEffect<R extends object = {}, E = never, A = never>(observability: Observability, input: RequestObservabilityContextInput, effect: Async<R, E, A>, options?: HttpServerObservabilityOptions<A>, env?: R, runtimeOptions?: RequestObservabilityRuntimeOptions<R>): Promise<ObservedHttpServerResult<A>>;
 declare function observeHttpServerRequest<A>(observability: Observability, input: RequestObservabilityContextInput, handler: (ctx: RequestObservabilityContext) => Promise<A>, options?: HttpServerObservabilityOptions<A>): Promise<ObservedHttpServerResult<A>>;
 
-export { type RuntimeMetricsSinkOptions as $, type ObservabilityRuntimeEnv as A, type ObservabilityTraceExportResult as B, type CardinalityConfig as C, type ObservedHttpServerResult as D, type ExportBatchResult as E, type OtlpAttributeValue as F, type OtlpExportOptions as G, type HealthCheck as H, type InjectTraceContextOptions as I, type OtlpFetch as J, type OtlpHttpExportResult as K, type LogLevel as L, type OtlpHttpExporterOptions as M, type OtlpHttpResponse as N, type Observability as O, PROMETHEUS_CONTENT_TYPE as P, type PrometheusMetricsExporter as Q, type RequestObservabilityContextInput as R, type SpanAttributes as S, type TraceContextCarrier as T, type PrometheusMetricsOptions as U, type RedactionConfig as V, type RedactionOptions as W, type RequestObservabilityRuntimeOptions as X, type ResolvedTraceSampling as Y, type RuntimeHealthOptions as Z, type RuntimeHealthReport as _, type RequestObservabilityContext as a, toOtlpAttributes as a$, type SpanLink as a0, type SpanOptions as a1, type SpanSource as a2, type StructuredLogRecord as a3, type StructuredLogSinkOptions as a4, type StructuredLogSource as a5, type TraceContextHeaderValue as a6, type TraceSamplingConfig as a7, type TraceSamplingOptions as a8, type TraceSamplingRule as a9, makeRuntimeHealth as aA, makeRuntimeMetricsSink as aB, makeStructuredLogSink as aC, makeTraceSampler as aD, metricsSnapshotToOtlp as aE, normalizeHttpRoute as aF, normalizeSpanId as aG, normalizeTraceId as aH, observeHttpServerRequest as aI, otlpAnyValue as aJ, parseBaggage as aK, parseTraceparent as aL, postOtlpJson as aM, ratioSampler as aN, readiness as aO, resolveRequestBaggage as aP, resolveRequestTraceSeed as aQ, resolveTraceSampling as aR, runObservedHttpServerEffect as aS, runtimeHealth as aT, sanitizeHttpTarget as aU, shouldSampleWith as aV, snapshotRuntimeHealth as aW, spanEvent as aX, spanLink as aY, spansToOtlp as aZ, structuredLogsToOtlp as a_, alwaysOffSampler as aa, alwaysOnSampler as ab, currentBaggage as ac, currentSpanLink as ad, defaultStructuredLogWriter as ae, exemplarFromTraceContext as af, exportWithRetry as ag, extractBaggage as ah, extractTraceContext as ai, formatBaggage as aj, formatPrometheusMetrics as ak, formatStructuredLog as al, formatTraceparent as am, healthToHttpResponse as an, injectBaggage as ao, injectTraceContext as ap, logEffect as aq, makeCardinalityLimitedMetrics as ar, makeExportPipeline as as, makeObservability as at, makeObservabilityRedactor as au, makeOtlpHttpLogExporter as av, makeOtlpHttpMetricsExporter as aw, makeOtlpHttpSpanExporter as ax, makePrometheusMetricsExporter as ay, makeRequestObservabilityContext as az, type ObservabilityOptions as b, unixNanoFromMs as b0, withBaggage as b1, withLogContext as b2, withSpan as b3, withTimeout as b4, type CardinalityLimiterOptions as c, type ExportPipeline as d, type ExportPipelineFlushOptions as e, type ExportPipelineFlushResult as f, type ExportPipelineOptions as g, type ExportPipelineStats as h, type ExportPipelineTuning as i, type ExportRetryOptions as j, type ExportSignal as k, type HealthCheckResult as l, type HealthHttpResponse as m, type HealthStatus as n, type HttpServerObservabilityLogOptions as o, type HttpServerObservabilityOptions as p, type HttpServerObservabilitySpanOptions as q, type HttpServerOutcome as r, OTLP_JSON_CONTENT_TYPE as s, type ObservabilityExporters as t, type ObservabilityFlushError as u, type ObservabilityFlushResult as v, type ObservabilityLogExportResult as w, type ObservabilityOtlpOptions as x, type ObservabilityRedactor as y, type ObservabilityRequestEnvInput as z };
+export { type RuntimeHealthOptions as $, type ObservabilityRequestEnvInput as A, type ObservabilityRuntimeEnv as B, type CardinalityConfig as C, type ObservabilityTraceExportResult as D, type ExportBatchResult as E, type ObservedHttpServerResult as F, type OtlpAttributeValue as G, type HealthCheck as H, type InjectTraceContextOptions as I, type OtlpExportOptions as J, type OtlpFetch as K, type LogLevel as L, type MakeOtlpOptionsInput as M, type OtlpHttpExportResult as N, type Observability as O, type OtlpHttpExporterOptions as P, type OtlpHttpResponse as Q, type RequestObservabilityContextInput as R, type SpanAttributes as S, type TraceContextCarrier as T, PROMETHEUS_CONTENT_TYPE as U, type PrometheusMetricsExporter as V, type PrometheusMetricsOptions as W, type RedactionConfig as X, type RedactionOptions as Y, type RequestObservabilityRuntimeOptions as Z, type ResolvedTraceSampling as _, type RequestObservabilityContext as a, spanLink as a$, type RuntimeHealthReport as a0, type RuntimeMetricsSinkOptions as a1, type SpanLink as a2, type SpanOptions as a3, type SpanSource as a4, type StructuredLogRecord as a5, type StructuredLogSinkOptions as a6, type StructuredLogSource as a7, type TraceContextHeaderValue as a8, type TraceSamplingConfig as a9, makeOtlpOptions as aA, makePrometheusMetricsExporter as aB, makeRequestObservabilityContext as aC, makeRuntimeHealth as aD, makeRuntimeMetricsSink as aE, makeStructuredLogSink as aF, makeTraceSampler as aG, metricsSnapshotToOtlp as aH, normalizeHttpRoute as aI, normalizeSpanId as aJ, normalizeTraceId as aK, observeHttpServerRequest as aL, otlpAnyValue as aM, parseBaggage as aN, parseTraceparent as aO, postOtlpJson as aP, ratioSampler as aQ, readiness as aR, resolveRequestBaggage as aS, resolveRequestTraceSeed as aT, resolveTraceSampling as aU, runObservedHttpServerEffect as aV, runtimeHealth as aW, sanitizeHttpTarget as aX, shouldSampleWith as aY, snapshotRuntimeHealth as aZ, spanEvent as a_, type TraceSamplingOptions as aa, type TraceSamplingRule as ab, alwaysOffSampler as ac, alwaysOnSampler as ad, currentBaggage as ae, currentSpanLink as af, defaultStructuredLogWriter as ag, exemplarFromTraceContext as ah, exportWithRetry as ai, extractBaggage as aj, extractTraceContext as ak, formatBaggage as al, formatPrometheusMetrics as am, formatStructuredLog as an, formatTraceparent as ao, healthToHttpResponse as ap, injectBaggage as aq, injectTraceContext as ar, logEffect as as, makeCardinalityLimitedMetrics as at, makeExportPipeline as au, makeObservability as av, makeObservabilityRedactor as aw, makeOtlpHttpLogExporter as ax, makeOtlpHttpMetricsExporter as ay, makeOtlpHttpSpanExporter as az, type ObservabilityOptions as b, spansToOtlp as b0, structuredLogsToOtlp as b1, toOtlpAttributes as b2, unixNanoFromMs as b3, withBaggage as b4, withLogContext as b5, withSpan as b6, withTimeout as b7, type CardinalityLimiterOptions as c, type ExportPipeline as d, type ExportPipelineFlushOptions as e, type ExportPipelineFlushResult as f, type ExportPipelineOptions as g, type ExportPipelineStats as h, type ExportPipelineTuning as i, type ExportRetryOptions as j, type ExportSignal as k, type HealthCheckResult as l, type HealthHttpResponse as m, type HealthStatus as n, type HttpServerObservabilityLogOptions as o, type HttpServerObservabilityOptions as p, type HttpServerObservabilitySpanOptions as q, type HttpServerOutcome as r, OTLP_JSON_CONTENT_TYPE as s, type ObservabilityExporters as t, type ObservabilityFlushError as u, type ObservabilityFlushResult as v, type ObservabilityLogExportResult as w, type ObservabilityOtlpOptions as x, type ObservabilityOtlpSignal as y, type ObservabilityRedactor as z };

package/docs/README.md

@@ -6,6 +6,8 @@ Start here:
 - **[Architecture](./ARCHITECTURE.md)** — how the runtime is structured
 - **[Cancellation & interruption](./cancellation.md)** — interruption semantics, scopes, and cancellable `Async`
 - **[Observability](./observability.md)** — hooks, events, sinks, tracing, and HTTP policy context
+- **[Framework integrations](./framework-integrations.md)** — Vanilla, React, Next.js, Angular, Express, Fastify, and Nest patterns
+- **[NestJS integration](./frameworks/nestjs.md)** — Brass module, Grafana/OTLP observability, HTTP client DI, and inbound spans
 - **[HTTP client](./http.md)** — ZIO-style HTTP built on brass-runtime
 - **[HTTP recipes](./http-recipes.md)** — typed clients, custom transports, production adoption, observability, and config validation
 - **[Recipes](./recipes/README.md)** — copyable runtime, layer, HTTP server, testing, and performance paths

package/docs/ai/PUBLIC_API.md

@@ -234,6 +234,9 @@ Primary categories:
 - production hardening helpers for exporter pipelines, sampling, redaction,
   metric-cardinality limiting, environment presets, no-op setup, and inbound
   adapters for Fetch/Node/Express/Fastify-style request objects
+- `makeOtlpOptions` for turning a backend-neutral OTLP HTTP collector endpoint
+  into metrics/traces/logs URLs while forwarding headers, custom `fetch`,
+  timeout, retry, pipeline tuning, and optional signal selection
 - OTLP log export, server-side HTTP request metrics/spans, span retention
   pruning, single-flight flush behavior, collector smoke script, and
   observability benchmark budgets

package/docs/framework-integrations.md

@@ -0,0 +1,38 @@
+# Framework integrations
+
+These recipes show how to wire Brass into common TypeScript application
+frameworks without adding framework-specific dependencies to `brass-runtime`.
+
+The common shape is:
+
+- create one `Observability` instance near the application boundary;
+- create one `Runtime` when framework handlers need to run effects;
+- create one `makeDefaultHttpClient(...)` with `withHttpObservability(...)`;
+- keep collector/vendor config in the application;
+- shut down HTTP and observability queues from the host lifecycle when possible.
+
+For browser apps, never expose Grafana Cloud tokens or collector secrets. Send
+browser telemetry to a same-origin proxy such as `/api/otel`, then forward to
+Grafana, Alloy, AppDynamics, or OpenTelemetry Collector from a trusted server.
+
+## Recipes
+
+| Framework | Recipe | Covers |
+|-----------|--------|--------|
+| Vanilla | [`docs/frameworks/vanilla.md`](./frameworks/vanilla.md) | Browser and Node setup without a framework |
+| React | [`docs/frameworks/react.md`](./frameworks/react.md) | Context provider, hook, component usage |
+| Next.js | [`docs/frameworks/nextjs.md`](./frameworks/nextjs.md) | App Router, server singleton, OTLP proxy |
+| Angular | [`docs/frameworks/angular.md`](./frameworks/angular.md) | InjectionToken providers and services |
+| Express | [`docs/frameworks/express.md`](./frameworks/express.md) | Request spans, `/metrics`, shutdown |
+| Fastify | [`docs/frameworks/fastify.md`](./frameworks/fastify.md) | Request adapter, `/metrics`, shutdown |
+| NestJS | [`docs/frameworks/nestjs.md`](./frameworks/nestjs.md) | Module providers, DI tokens, shutdown hooks |
+
+Runnable dependency-optional examples live in:
+
+- `src/examples/observabilityExpress.ts`
+- `src/examples/observabilityFastify.ts`
+- `src/examples/observabilityNest.ts`
+
+See also [`docs/observability-framework-examples.md`](./observability-framework-examples.md)
+for commands that run those examples locally.
+

package/docs/frameworks/angular.md

@@ -0,0 +1,153 @@
+# Angular integration
+
+Angular apps should expose Brass through `InjectionToken`s. Browser telemetry
+should go to a same-origin proxy such as `/api/otel`; collector credentials
+belong on the server side.
+
+## Providers
+
+```ts
+// brass.providers.ts
+import { inject, InjectionToken, type Provider } from "@angular/core";
+import { Runtime } from "brass-runtime/core";
+import {
+  defineHttpPolicyPresets,
+  makeDefaultHttpClient,
+} from "brass-runtime/http";
+import {
+  makeObservability,
+  makeOtlpOptions,
+  withHttpObservability,
+} from "brass-runtime/observability";
+
+const policyPresets = defineHttpPolicyPresets({
+  readModel: {
+    lane: "read-model",
+    priority: 3,
+    retry: { maxRetries: 2, baseDelayMs: 100, maxDelayMs: 1_000 },
+  },
+  command: {
+    lane: "command",
+    priority: 1,
+    retry: false,
+  },
+});
+
+function makeAngularBrass() {
+  const observability = makeObservability({
+    serviceName: "shop-angular",
+    resource: { "deployment.environment": "browser" },
+    logs: false,
+    sampling: { ratio: 0.1, respectRemoteSampled: true, forceSampleOnError: true },
+    redaction: {},
+    cardinality: { maxValuesPerLabel: 100 },
+    otlp: makeOtlpOptions({
+      endpoint: "/api/otel",
+      timeoutMs: 10_000,
+      retry: { attempts: 2, initialDelayMs: 100, maxDelayMs: 1_000 },
+      pipeline: { maxQueueSize: 2_000, batchSize: 128, dropPolicy: "drop-oldest" },
+    }),
+    flushIntervalMs: 15_000,
+    autoStart: true,
+  });
+
+  const runtime = new Runtime({
+    env: observability.env,
+    hooks: observability.hooks,
+  });
+
+  const http = makeDefaultHttpClient({
+    baseUrl: "/api",
+    preset: "balanced",
+    timeoutMs: 5_000,
+    policyPresets,
+    middleware: [withHttpObservability(observability)],
+  });
+
+  return {
+    observability,
+    runtime,
+    http,
+    shutdown: async () => {
+      await http.shutdown();
+      await observability.shutdown();
+    },
+  };
+}
+
+export const BRASS = new InjectionToken<ReturnType<typeof makeAngularBrass>>("BRASS");
+
+export function provideBrass(): Provider[] {
+  return [
+    {
+      provide: BRASS,
+      useFactory: () => makeAngularBrass(),
+    },
+  ];
+}
+
+export function injectBrass() {
+  return inject(BRASS);
+}
+```
+
+Register the provider:
+
+```ts
+// app.config.ts
+import { type ApplicationConfig } from "@angular/core";
+import { provideBrass } from "./brass.providers";
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    ...provideBrass(),
+  ],
+};
+```
+
+## Service Usage
+
+```ts
+// users.service.ts
+import { Injectable } from "@angular/core";
+import { injectBrass } from "./brass.providers";
+
+type User = {
+  readonly id: string;
+  readonly name: string;
+};
+
+@Injectable({ providedIn: "root" })
+export class UsersService {
+  private readonly brass = injectBrass();
+
+  getUser(id: string): Promise<User> {
+    return this.brass.runtime
+      .toPromise(
+        this.brass.http.getJson<User>(`/users/${id}`, {
+          policy: "readModel",
+          timeoutMs: 2_000,
+        }),
+      )
+      .then((response) => response.body);
+  }
+}
+```
+
+## Shutdown
+
+Browser apps often do not have a reliable shutdown hook, but you can flush on
+page lifecycle events:
+
+```ts
+import { injectBrass } from "./brass.providers";
+
+export function installBrassBrowserShutdown() {
+  const brass = injectBrass();
+
+  window.addEventListener("pagehide", () => {
+    void brass.shutdown();
+  });
+}
+```
+

package/docs/frameworks/express.md

@@ -0,0 +1,125 @@
+# Express integration
+
+Express can wire Brass directly at process startup: one observability instance,
+one runtime, one HTTP client, and a shutdown handler.
+
+## App Setup
+
+```ts
+import express from "express";
+import { asyncFlatMap } from "brass-runtime/core";
+import {
+  defineHttpPolicyPresets,
+  makeDefaultHttpClient,
+} from "brass-runtime/http";
+import {
+  logEffect,
+  makeExpressRequestObservabilityContext,
+  makeObservability,
+  makeOtlpOptions,
+  withHttpObservability,
+} from "brass-runtime/observability";
+
+const policyPresets = defineHttpPolicyPresets({
+  readModel: {
+    lane: "read-model",
+    priority: 3,
+    retry: { maxRetries: 2, baseDelayMs: 100, maxDelayMs: 1_000 },
+  },
+  command: {
+    lane: "command",
+    priority: 1,
+    retry: false,
+  },
+});
+
+const observability = makeObservability({
+  serviceName: process.env.OTEL_SERVICE_NAME ?? "shop-express",
+  serviceVersion: process.env.OTEL_SERVICE_VERSION,
+  resource: {
+    "deployment.environment": process.env.NODE_ENV ?? "development",
+  },
+  logs: { minLevel: "info" },
+  sampling: { ratio: 0.25, respectRemoteSampled: true, forceSampleOnError: true },
+  redaction: {},
+  cardinality: { maxValuesPerLabel: 100 },
+  otlp: makeOtlpOptions({
+    endpoint: process.env.GRAFANA_OTLP_ENDPOINT ?? "http://grafana-alloy:4318",
+    headers: process.env.GRAFANA_OTLP_AUTHORIZATION
+      ? { Authorization: process.env.GRAFANA_OTLP_AUTHORIZATION }
+      : undefined,
+    timeoutMs: 10_000,
+    retry: { attempts: 3, initialDelayMs: 100, maxDelayMs: 2_000 },
+    pipeline: {
+      maxQueueSize: 10_000,
+      batchSize: 512,
+      dropPolicy: "drop-oldest",
+      shutdownTimeoutMs: 10_000,
+    },
+  }),
+  flushIntervalMs: 10_000,
+  autoStart: true,
+});
+
+const http = makeDefaultHttpClient({
+  baseUrl: process.env.USERS_API_BASE_URL ?? "https://users-api.internal",
+  preset: "production",
+  timeoutMs: 5_000,
+  policyPresets,
+  middleware: [withHttpObservability(observability)],
+});
+
+const app = express();
+```
+
+## Routes
+
+```ts
+app.get("/users/:id", async (req, res, next) => {
+  const ctx = makeExpressRequestObservabilityContext(observability, req, {
+    route: "/users/:id",
+  });
+
+  try {
+    const response = await ctx.run(
+      ctx.withRequestSpan(
+        asyncFlatMap(
+          logEffect("info", "users.lookup", {
+            userId: req.params.id,
+            authorization: req.headers.authorization,
+          }),
+          () =>
+            http.getJson(`/users/${req.params.id}`, {
+              policy: "readModel",
+              timeoutMs: 2_000,
+            }),
+        ),
+      ),
+    );
+
+    res.json(response.body);
+  } catch (error) {
+    next(error);
+  }
+});
+
+app.get("/metrics", (_req, res) => {
+  res
+    .type(observability.prometheus.contentType)
+    .send(observability.prometheus.export());
+});
+```
+
+## Shutdown
+
+```ts
+const server = app.listen(process.env.PORT ?? 3000);
+
+process.once("SIGTERM", async () => {
+  await new Promise<void>((resolve) => server.close(() => resolve()));
+  await http.shutdown();
+  await observability.shutdown();
+});
+```
+
+Runnable repo example: `src/examples/observabilityExpress.ts`.