brass-runtime 1.17.0 → 1.18.1

package/docs/performance-profiler.md

@@ -128,6 +128,9 @@ HTTP layer profile:
 - `node-http-text`
 - `wire-raw`
 - `default-minimal-json`
+- `default-proxy-json`
+- `default-proxy-node-json`
+- `high-throughput-proxy-node-json`
 - `default-balanced-no-adaptive-json`
 - `default-balanced-json`
 - `default-json`
@@ -141,8 +144,9 @@ HTTP long-run memory lab:
 
 - defaults to `forceGc: true`, so use `node --expose-gc` for the strongest
   retained-memory signal
-- compares node transport, wire raw, minimal, balanced without adaptive,
-  balanced, default, and default+observability variants
+- compares node transport, wire raw, minimal, proxy, proxy+node transport,
+  high-throughput proxy+node transport, balanced without adaptive, balanced,
+  default, and default+observability variants
 - reports heap/rss totals, max p99, mean throughput, errors, and
   `heapDeltaPer10kRequestsMb`
 - highlights whether memory is `ok`, `watch`, `critical`, or `unknown-gc`

package/docs/recipes/layers.md

@@ -32,8 +32,9 @@ const RepoLayer = Layer.effect(Repo, (ctx: LayerContext) => {
 const AppLayer = Layer.compose(ConfigLayer, RepoLayer);
 
 const userUrl = await runPromise(
-  provideContext(AppLayer, (ctx) =>
-    asyncSucceed(ctx.unsafeGet(Repo).findUser("u1")),
+  provideContext(
+    AppLayer,
+    Layer.use(Repo, (repo) => asyncSucceed(repo.findUser("u1"))),
   ),
 );
 
@@ -42,3 +43,46 @@ console.log(userUrl);
 
 Missing services throw `MissingLayerServiceError`; use `formatLayerError` when
 surfacing the message.
+
+For independent layers, `Layer.all(...)` keeps composition readable. For
+ordered context graphs where later layers read earlier services, use
+`Layer.composeAll(...)`. `Layer.useAll(...)` reads multiple services without
+manual context access:
+
+```ts
+const Logger = defineService<{ readonly info: (message: string) => void }>("Logger");
+const LoggerLayer = Layer.value(Logger, console);
+
+const AppLayer2 = Layer.composeAll(ConfigLayer, RepoLayer, LoggerLayer);
+
+await runPromise(
+  provideContext(
+    AppLayer2,
+    Layer.useAll({ repo: Repo, logger: Logger }, ({ repo, logger }) => {
+      logger.info("loading user");
+      return asyncSucceed(repo.findUser("u1"));
+    }),
+  ),
+);
+```
+
+For app wiring, prefer the focused helpers:
+
+```ts
+import { RuntimeService, makeConfigLayer, makeRuntimeLayer, makeTestLayer } from "brass-runtime";
+import { s } from "brass-runtime/schema";
+
+const ConfigSchema = s.object({ baseUrl: s.url() });
+
+const ConfigLayer2 = makeConfigLayer(Config, ConfigSchema, {
+  baseUrl: "https://api.example.com",
+});
+
+const RuntimeLayer = makeRuntimeLayer((ctx) => ({
+  config: ctx.unsafeGet(Config),
+}));
+
+const TestConfigLayer = makeTestLayer(Config, {
+  baseUrl: "https://test.example.com",
+});
+```

package/docs/recipes/testing.md

@@ -33,6 +33,31 @@ const response = await runHttpEffect(client({ method: "GET", url: "/health" }));
 console.log(response.status);
 ```
 
+Layer-based applications can swap services with `makeTestLayer`,
+`makeTestLayers`, or a mock default HTTP client layer:
+
+```ts
+import { Layer, makeTestLayer } from "brass-runtime/core";
+import { HttpClientService } from "brass-runtime/http";
+import {
+  makeJsonHttpResponse,
+  makeMockDefaultHttpClientLayer,
+} from "brass-runtime/http/testing";
+
+const Config = Layer.tag<{ readonly baseUrl: string }>("Config");
+
+const TestLayer = Layer.composeAll(
+  makeTestLayer(Config, { baseUrl: "test://users" }),
+  makeMockDefaultHttpClientLayer((req) =>
+    makeJsonHttpResponse({ url: req.url }),
+  ),
+);
+
+const program = Layer.use(HttpClientService, (http) =>
+  http.getJson("/users/1"),
+);
+```
+
 For typed failures, assert on `Exit` instead of catching thrown values.
 
 ```ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brass-runtime",
-  "version": "1.17.0",
+  "version": "1.18.1",
   "description": "Effect runtime utilities for TypeScript",
   "license": "MIT",
   "author": "Augusto Vivaldelli",
@@ -116,6 +116,9 @@
     "benchmark:runtime": "tsx src/benchmarks/runner.ts runtime-performance-track",
     "benchmark:runtime:budget": "node scripts/check-runtime-benchmark-budget.mjs",
     "benchmark:http": "tsx src/benchmarks/runner.ts http-concurrent",
+    "benchmark:http:proxy": "BRASS_HTTP_BENCH_VARIANTS=node-http-text,default-minimal-json,default-proxy-json,default-proxy-node-json,default-json tsx src/benchmarks/runner.ts http-concurrent",
+    "benchmark:http:proxy:300tps": "BRASS_HTTP_RAMP_CLIENT=proxy BRASS_HTTP_RAMP_MAX_TPS=300 BRASS_HTTP_RAMP_STEP_TPS=300 BRASS_HTTP_RAMP_STEP_SECONDS=180 BRASS_HTTP_RAMP_CONCURRENCY=600 tsx src/benchmarks/runner.ts http-ramp-tps",
+    "benchmark:http:overhead": "tsx src/benchmarks/runner.ts http-local-overhead",
     "benchmark:http:soak": "BRASS_HTTP_BENCH_MODE=soak tsx src/benchmarks/runner.ts http-concurrent",
     "benchmark:http:budget": "node scripts/check-http-benchmark-budget.mjs",
     "benchmark:http:ramp": "tsx src/benchmarks/runner.ts http-ramp-tps",
@@ -124,7 +127,8 @@
     "benchmark:observability": "tsx src/benchmarks/runner.ts observability-overhead",
     "benchmark:observability:budget": "node scripts/check-observability-benchmark-budget.mjs",
     "benchmark:perf": "tsx src/perf/cli.ts --json",
-    "perf": "tsx src/perf/cli.ts",
+    "perf": "tsx src/perf/cli.ts && node --expose-gc --require tsx/cjs src/benchmarks/http-local-overhead-gate.ts",
+    "perf:profile": "tsx src/perf/cli.ts",
     "perf:json": "tsx src/perf/cli.ts --json",
     "perf:runtime:ab": "tsx src/perf/cli.ts --profile runtime-ab",
     "perf:runtime:soak": "tsx src/perf/cli.ts --profile runtime-soak",

package/dist/chunk-3LOYJFRR.cjs

@@ -1,300 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
-
-
-var _chunkMVGUEJ5Zcjs = require('./chunk-MVGUEJ5Z.cjs');
-
-// src/http/requestPolicy.ts
-var hasOwn = (value, key) => Object.prototype.hasOwnProperty.call(value, key);
-var isPolicyObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-var defineHttpPolicyPresets = (presets) => presets;
-var httpPolicy = Object.freeze({
-  preset: (preset, overrides = {}) => ({
-    preset,
-    ...overrides
-  }),
-  lane: (lane, overrides = {}) => ({
-    preset: lane,
-    lane,
-    ...overrides
-  }),
-  define: defineHttpPolicyPresets
-});
-var getHttpRequestPolicy = (req, options = {}) => {
-  const legacy = req;
-  const source = req.policy;
-  const sourcePolicy = resolvePolicySource(req, source, options.presets);
-  const policy = {
-    ...legacy.lane !== void 0 ? { lane: legacy.lane } : {},
-    ...legacy.dedupKey !== void 0 ? { dedupKey: legacy.dedupKey } : {},
-    ...legacy.priority !== void 0 ? { priority: legacy.priority } : {},
-    ...legacy.retry !== void 0 ? { retry: legacy.retry } : {},
-    ...req.poolKey !== void 0 ? { poolKey: req.poolKey } : {},
-    ...sourcePolicy
-  };
-  return policy;
-};
-var withHttpRequestPolicy = (req, patch) => {
-  const current = getHttpRequestPolicy(req);
-  const next = {
-    ...req,
-    policy: {
-      ...current,
-      ...patch
-    }
-  };
-  if (hasOwn(patch, "poolKey")) {
-    next.poolKey = patch.poolKey;
-  }
-  if (hasOwn(patch, "lane")) {
-    next.lane = patch.lane;
-  }
-  if (hasOwn(patch, "dedupKey")) {
-    next.dedupKey = patch.dedupKey;
-  }
-  if (hasOwn(patch, "priority")) {
-    next.priority = patch.priority;
-  }
-  if (hasOwn(patch, "retry")) {
-    next.retry = patch.retry;
-  }
-  return next;
-};
-var resolveHttpRequestPolicyPresets = (req, presets) => {
-  const policy = getHttpRequestPolicy(req, { presets });
-  return withHttpRequestPolicy({ ...req, policy }, policy);
-};
-var withHttpPolicyPresets = (presets) => {
-  return (next) => (req) => _chunkMVGUEJ5Zcjs.asyncFlatMap.call(void 0, 
-    _chunkMVGUEJ5Zcjs.asyncSync.call(void 0, () => resolveHttpRequestPolicyPresets(req, presets)),
-    (resolved) => next(resolved)
-  );
-};
-function resolvePolicySource(req, source, presets) {
-  if (typeof source === "string") {
-    return resolveNamedPolicy(req, source, {}, presets);
-  }
-  if (!isPolicyObject(source)) return {};
-  if (!source.preset) return source;
-  return resolveNamedPolicy(req, source.preset, source, presets);
-}
-function resolveNamedPolicy(req, presetName, overrides, presets) {
-  const named = _optionalChain([presets, 'optionalAccess', _ => _[presetName]]);
-  const resolved = typeof named === "function" ? named(req, presetName) : named;
-  return {
-    lane: presetName,
-    ...isPolicyObject(resolved) ? resolved : {},
-    ...overrides,
-    preset: presetName
-  };
-}
-
-// src/http/errors.ts
-var HTTP_ERROR_TAGS = /* @__PURE__ */ new Set([
-  "Abort",
-  "BadUrl",
-  "FetchError",
-  "Timeout",
-  "PoolRejected",
-  "PoolTimeout",
-  "PoolClosed",
-  "BatchSplitError"
-]);
-var RETRYABLE_STATUS = /* @__PURE__ */ new Set([408, 429, 500, 502, 503, 504]);
-var TIMEOUT_CODES = /* @__PURE__ */ new Set([
-  "ECONNABORTED",
-  "ETIMEDOUT",
-  "ESOCKETTIMEDOUT",
-  "UND_ERR_CONNECT_TIMEOUT",
-  "UND_ERR_HEADERS_TIMEOUT",
-  "UND_ERR_BODY_TIMEOUT"
-]);
-var ABORT_CODES = /* @__PURE__ */ new Set(["ERR_CANCELED", "ABORT_ERR"]);
-function isHttpError(error) {
-  return hasTag(error) && HTTP_ERROR_TAGS.has(error._tag);
-}
-function isValidationError(error) {
-  return hasTag(error) && error._tag === "ValidationError";
-}
-function isCircuitBreakerOpen(error) {
-  return hasTag(error) && error._tag === "CircuitBreakerOpen";
-}
-function isKnownHttpError(error) {
-  return isHttpError(error) || isValidationError(error) || isCircuitBreakerOpen(error);
-}
-function isAbortHttpError(error) {
-  return isHttpError(error) && error._tag === "Abort";
-}
-function isTimeoutHttpError(error) {
-  return isHttpError(error) && (error._tag === "Timeout" || error._tag === "PoolTimeout");
-}
-function isFetchHttpError(error) {
-  return isHttpError(error) && error._tag === "FetchError";
-}
-function httpErrorStatus(error) {
-  if (!isFetchHttpError(error)) return void 0;
-  return typeof error.status === "number" && Number.isFinite(error.status) ? error.status : void 0;
-}
-function isRetryableHttpStatus(status) {
-  return RETRYABLE_STATUS.has(status);
-}
-function isRetryableHttpError(error, options = {}) {
-  if (!isHttpError(error)) return false;
-  switch (error._tag) {
-    case "Timeout":
-    case "PoolTimeout":
-      return true;
-    case "FetchError": {
-      const status = httpErrorStatus(error);
-      if (status !== void 0) return (_nullishCoalesce(options.retryOnStatus, () => ( isRetryableHttpStatus)))(status);
-      return true;
-    }
-    default:
-      return false;
-  }
-}
-function isExternalAbortError(error) {
-  if (typeof error !== "object" || error === null) return false;
-  const record = error;
-  return record.name === "AbortError" || ABORT_CODES.has(String(_nullishCoalesce(record.code, () => ( ""))));
-}
-function isExternalTimeoutError(error) {
-  if (typeof error !== "object" || error === null) return false;
-  const record = error;
-  return record.name === "TimeoutError" || TIMEOUT_CODES.has(String(_nullishCoalesce(record.code, () => ( ""))));
-}
-function toHttpError(error, options = {}) {
-  if (isHttpError(error)) return error;
-  if (_optionalChain([options, 'access', _2 => _2.signal, 'optionalAccess', _3 => _3.aborted]) || isExternalAbortError(error)) {
-    return { _tag: "Abort" };
-  }
-  const status = externalStatus(error);
-  const statusText = externalStatusText(error);
-  const code = externalCode(error);
-  const message = resolveMessage(error, options.message);
-  if (isExternalTimeoutError(error)) {
-    return {
-      _tag: "Timeout",
-      timeoutMs: _nullishCoalesce(options.timeoutMs, () => ( 0)),
-      phase: _nullishCoalesce(options.phase, () => ( "request")),
-      message
-    };
-  }
-  return {
-    _tag: "FetchError",
-    message,
-    ...code !== void 0 ? { code } : {},
-    ...status !== void 0 ? { status } : {},
-    ...statusText !== void 0 ? { statusText } : {},
-    ...retryAfterMsFromExternal(error) !== void 0 ? { retryAfterMs: retryAfterMsFromExternal(error) } : {},
-    cause: error
-  };
-}
-function matchHttpError(error, handlers) {
-  if (isKnownHttpError(error)) {
-    const handler = handlers[error._tag];
-    if (handler) return handler(error);
-  }
-  return _optionalChain([handlers, 'access', _4 => _4.default, 'optionalCall', _5 => _5(error)]);
-}
-function formatHttpError(error) {
-  if (isValidationError(error)) {
-    const phase = error.phase ? `${error.phase} ` : "";
-    return `${phase}validation failed: ${error.message}`;
-  }
-  if (isCircuitBreakerOpen(error)) {
-    return `Circuit breaker is open after ${error.failures} failure(s)`;
-  }
-  if (!isHttpError(error)) {
-    return error instanceof Error ? error.message : String(error);
-  }
-  switch (error._tag) {
-    case "Abort":
-      return "HTTP request aborted";
-    case "BadUrl":
-    case "PoolRejected":
-    case "PoolTimeout":
-    case "PoolClosed":
-    case "BatchSplitError":
-      return error.message;
-    case "FetchError":
-      return formatFetchError(error);
-    case "Timeout":
-      return error.message;
-  }
-}
-function hasTag(error) {
-  return typeof error === "object" && error !== null && typeof error._tag === "string";
-}
-function externalCode(error) {
-  if (typeof error !== "object" || error === null) return void 0;
-  const code = error.code;
-  return typeof code === "string" && code.length > 0 ? code : void 0;
-}
-function externalStatus(error) {
-  if (typeof error !== "object" || error === null) return void 0;
-  const record = error;
-  const response = typeof record.response === "object" && record.response !== null ? record.response : void 0;
-  const status = _nullishCoalesce(_nullishCoalesce(_optionalChain([response, 'optionalAccess', _6 => _6.status]), () => ( record.status)), () => ( record.statusCode));
-  return typeof status === "number" && Number.isFinite(status) ? status : void 0;
-}
-function externalStatusText(error) {
-  if (typeof error !== "object" || error === null) return void 0;
-  const record = error;
-  const response = typeof record.response === "object" && record.response !== null ? record.response : void 0;
-  const statusText = _nullishCoalesce(_nullishCoalesce(_optionalChain([response, 'optionalAccess', _7 => _7.statusText]), () => ( record.statusText)), () => ( record.statusMessage));
-  return typeof statusText === "string" && statusText.length > 0 ? statusText : void 0;
-}
-function retryAfterMsFromExternal(error) {
-  if (typeof error !== "object" || error === null) return void 0;
-  const record = error;
-  const response = typeof record.response === "object" && record.response !== null ? record.response : void 0;
-  const headers = _nullishCoalesce(_optionalChain([response, 'optionalAccess', _8 => _8.headers]), () => ( record.headers));
-  if (typeof headers !== "object" || headers === null) return void 0;
-  const headerRecord = headers;
-  const raw = _nullishCoalesce(headerRecord["retry-after"], () => ( headerRecord["Retry-After"]));
-  if (raw === void 0 || raw === null) return void 0;
-  const seconds = Number(raw);
-  if (Number.isFinite(seconds)) return Math.max(0, Math.floor(seconds * 1e3));
-  const dateMs = Date.parse(String(raw));
-  return Number.isFinite(dateMs) ? Math.max(0, dateMs - Date.now()) : void 0;
-}
-function resolveMessage(error, message) {
-  if (typeof message === "function") return message(error);
-  if (typeof message === "string") return message;
-  if (error instanceof Error && error.message) return error.message;
-  if (typeof error === "object" && error !== null) {
-    const value = error.message;
-    if (typeof value === "string" && value.length > 0) return value;
-  }
-  return String(error);
-}
-function formatFetchError(error) {
-  const status = httpErrorStatus(error);
-  if (status === void 0) return error.message;
-  const statusText = error.statusText ? ` ${error.statusText}` : "";
-  return `HTTP ${status}${statusText}: ${error.message}`;
-}
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-exports.defineHttpPolicyPresets = defineHttpPolicyPresets; exports.httpPolicy = httpPolicy; exports.getHttpRequestPolicy = getHttpRequestPolicy; exports.withHttpRequestPolicy = withHttpRequestPolicy; exports.resolveHttpRequestPolicyPresets = resolveHttpRequestPolicyPresets; exports.withHttpPolicyPresets = withHttpPolicyPresets; exports.isHttpError = isHttpError; exports.isValidationError = isValidationError; exports.isCircuitBreakerOpen = isCircuitBreakerOpen; exports.isKnownHttpError = isKnownHttpError; exports.isAbortHttpError = isAbortHttpError; exports.isTimeoutHttpError = isTimeoutHttpError; exports.isFetchHttpError = isFetchHttpError; exports.httpErrorStatus = httpErrorStatus; exports.isRetryableHttpStatus = isRetryableHttpStatus; exports.isRetryableHttpError = isRetryableHttpError; exports.isExternalAbortError = isExternalAbortError; exports.isExternalTimeoutError = isExternalTimeoutError; exports.toHttpError = toHttpError; exports.matchHttpError = matchHttpError; exports.formatHttpError = formatHttpError;