brass-runtime 1.19.1 → 1.20.0

package/CHANGELOG.md

@@ -1,5 +1,73 @@
 # Changelog
 
+## 1.19.0 - Bare-Metal HTTP Mode
+
+### Features
+
+- Added `makeBareMetalHttp` factory: a zero-overhead HTTP client that bypasses
+  all middleware layers (retry, dedup, cache, batch, priority, compression,
+  adaptive limiter, prewarm) and delegates directly to the wire transport.
+  Preserves typed errors, cancellation, pool/adaptive-limiter, and stats.
+- Added `makeBareMetalHttpStream` factory: streaming counterpart with the same
+  zero-overhead guarantees. Pool leases are released on headers received.
+- Added `preset: "bareMetal"` to `makeDefaultHttpClient` for easy opt-in via
+  the standard preset system. DX helpers (get, post, getJson, postJson, getText)
+  work identically. Lifecycle config keys are ignored with a construction-time
+  warning. User middleware is still applied.
+- Bare-metal clients expose `.with(mw)` escape hatch for composing observability
+  without pulling in the full lifecycle stack.
+- Exported `runDirectTransport`, `runPoolTransport`, and related wire-level
+  helpers from `src/http/client.ts` for advanced custom client composition.
+
+### Usage
+
+```typescript
+import { makeBareMetalHttp, makeDefaultHttpClient } from "brass-runtime/http";
+
+// Standalone factory
+const client = makeBareMetalHttp({ baseUrl: "https://api.internal" });
+
+// Via preset
+const defaultClient = makeDefaultHttpClient({ preset: "bareMetal" });
+
+// With custom transport (e.g., Axios adapter)
+const axiosClient = makeBareMetalHttp({ transport: myAxiosTransport });
+```
+
+## 1.18.3 - HTTP Pool/Timeout Fast Path
+
+### Performance
+
+- Connected the non-streaming HTTP wire client to the existing `runPoolTransport`
+  fast path whenever a request uses `pool`, `adaptiveLimiter`, or `timeoutMs`.
+  The uncontended pool path now uses synchronous `tryAcquireSync` before falling
+  back to queued async acquire, avoiding the generic `fromPromiseAbortable`
+  wrapper and extra promise/microtask boundaries on hot BFF/proxy paths.
+- Improved local HTTP overhead benchmark results for the proxy effect transport
+  path with 30k calls, 5k warmup, concurrency 32:
+  - `default-proxy-effect-timeout`: p99 `1.915ms` -> `1.559ms`,
+    throughput `70.9k/s` -> `101.5k/s`.
+  - `default-proxy-effect-pool`: p99 `1.564ms` -> `1.276ms`,
+    throughput `79.2k/s` -> `115.7k/s`.
+  - `default-proxy-effect-timeout-pool`: p99 `2.014ms` -> `1.209ms`,
+    throughput `70.2k/s` -> `103.1k/s`.
+
+### Fixed
+
+- Preserved real host-request cancellation on the pool/timeout fast path by
+  passing transports a request-scoped `AbortController` signal. Promise
+  transports such as Axios can now observe aborts on cancellation and timeout
+  while still benefiting from the pool fast path.
+- Added regression coverage ensuring uncontended pool transports run during
+  effect registration and that cancellation aborts the signal passed to the
+  transport.
+
+### Validation
+
+- `npm run test:types`
+- `npm test -- src/http/__tests__`
+- `BRASS_HTTP_OVERHEAD_CALLS=30000 BRASS_HTTP_OVERHEAD_WARMUP_CALLS=5000 BRASS_HTTP_OVERHEAD_CONCURRENCY=32 BRASS_HTTP_OVERHEAD_VARIANTS=default-proxy-effect-transport,default-proxy-effect-timeout,default-proxy-effect-pool,default-proxy-effect-timeout-pool npm run benchmark:http:overhead`
+
 ## 1.18.2 - Release Metadata Alignment
 
 ### Fixed

package/dist/{chunk-EZ76UNHP.cjs → chunk-62IBGQOU.cjs}

@@ -4,7 +4,7 @@
 var _chunkJQCQWO47cjs = require('./chunk-JQCQWO47.cjs');
 
 
-var _chunk67256TKFcjs = require('./chunk-67256TKF.cjs');
+var _chunkBDTBIYAMcjs = require('./chunk-BDTBIYAM.cjs');
 
 
 var _chunkZJC3JZIEcjs = require('./chunk-ZJC3JZIE.cjs');
@@ -14,7 +14,7 @@ var _chunkVXNWVAIGcjs = require('./chunk-VXNWVAIG.cjs');
 
 
 
-var _chunkLXNU3MRVcjs = require('./chunk-LXNU3MRV.cjs');
+var _chunkLA2PAO7Jcjs = require('./chunk-LA2PAO7J.cjs');
 
 
 
@@ -862,24 +862,24 @@ function baseHttpConfig(baseUrl, scenario) {
   };
 }
 function makeWireClient(baseUrl, scenario) {
-  return _chunkLXNU3MRVcjs.makeHttp.call(void 0, baseHttpConfig(baseUrl, scenario));
+  return _chunkLA2PAO7Jcjs.makeHttp.call(void 0, baseHttpConfig(baseUrl, scenario));
 }
 function makeMinimalClient(baseUrl, scenario) {
-  return _chunkLXNU3MRVcjs.makeDefaultHttpClient.call(void 0, {
+  return _chunkLA2PAO7Jcjs.makeDefaultHttpClient.call(void 0, {
     preset: "minimal",
     compression: false,
     ...baseHttpConfig(baseUrl, scenario)
   });
 }
 function makeDefaultClient(baseUrl, scenario, preset, disableAdaptiveLimiter, observability) {
-  return _chunkLXNU3MRVcjs.makeDefaultHttpClient.call(void 0, {
+  return _chunkLA2PAO7Jcjs.makeDefaultHttpClient.call(void 0, {
     preset,
     compression: false,
     ...baseHttpConfig(baseUrl, scenario),
     ...disableAdaptiveLimiter ? { adaptiveLimiter: false } : {},
     ...observability ? {
       middleware: [
-        _chunk67256TKFcjs.withHttpObservability.call(void 0, {
+        _chunkBDTBIYAMcjs.withHttpObservability.call(void 0, {
           metrics: observability.metrics,
           logs: false,
           spans: {},

package/dist/{chunk-U42YF6B2.js → chunk-6LF3M4JC.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-RZQK32C6.js";
 import {
   withHttpObservability
-} from "./chunk-XJSWDU2S.js";
+} from "./chunk-VXZIP3IU.js";
 import {
   makeObservability
 } from "./chunk-TAPB4NN5.js";
@@ -14,7 +14,7 @@ import {
 import {
   makeDefaultHttpClient,
   makeHttp
-} from "./chunk-IHXF6NQG.js";
+} from "./chunk-POH2WZBI.js";
 import {
   Runtime,
   Scheduler