@fjall/util 10.1.1 → 10.1.2

package/dist/.build-source-hash

@@ -9,7 +9,7 @@
     "package.json",
     "tsconfig.json"
   ],
-  "hash": "22380d353b56a1c1a3921a98da8b6ddf55ad74d713ca984cb2f9e7c59c15414b",
+  "hash": "bbdbacc3ff24fe60e8b272d2fae3be6b34b377dccd72015787d69025246230ff",
   "files": {
     "src/async/concurrency.ts": "3c7ebe0222a720f9",
     "src/async/singleton.ts": "7bcc21b0fb920561",
@@ -63,6 +63,7 @@
     "src/failure/extractErrorWindow.ts": "ca41f90946fa939c",
     "src/fsHelpers.ts": "0869d9739d523572",
     "src/fsScan.ts": "feb187758481443f",
+    "src/httpKeepAlive.ts": "c8fe4b118ef4c79f",
     "src/index.ts": "78390afd568e517a",
     "src/infra/backupVault.ts": "661678a6dfb0b648",
     "src/infra/connectionsWire.ts": "125c099da0e17ac1",
@@ -106,9 +107,9 @@
     "src/securityHelpers.ts": "ee2ab9ffd53119fb",
     "src/targets.ts": "126280f0a5762e21",
     "../scripts/minify-dist.mjs": "6b2e4b0df8aec601",
-    "package.json": "e1032fb657942835",
+    "package.json": "a2c0e36325985f2e",
     "tsconfig.json": "db759831ad95f396"
   },
-  "outputHash": "05e1db6e55226f186807b0354c7706834fe6b612131bc241901af1d9b0a28826",
-  "outputFileCount": 195
+  "outputHash": "2fbb62c936263ba0fed951492d8236364fa5cf422dd6afad9df45dec7746c16c",
+  "outputFileCount": 197
 }

package/dist/.minified

@@ -1 +1 @@
-97 files minified at 2026-08-11T22:31:58.152Z
+98 files minified at 2026-08-12T11:24:47.744Z

package/dist/httpKeepAlive.d.ts

@@ -0,0 +1,49 @@
+/**
+ * ALB ↔ Node HTTP keep-alive contract.
+ *
+ * An ALB holds idle keep-alive connections to its targets open for up to its
+ * idle timeout and freely reuses them. Node's default `server.keepAliveTimeout`
+ * is 5 seconds — far below the ALB's 60 — so the ALB routinely reuses a
+ * connection at the instant Node closes it, surfacing as intermittent
+ * ALB-generated 502s that never reach the application. The fix is server-side:
+ * the target's keep-alive timeout must exceed the ALB idle timeout, and
+ * `headersTimeout` must exceed `keepAliveTimeout` so a request that starts
+ * arriving just before the keep-alive deadline is not truncated mid-headers.
+ *
+ * The Fjall ECS construct pins the ALB idle timeout to
+ * `DEFAULT_ALB_IDLE_TIMEOUT_SECONDS` and injects that value into ALB-fronted
+ * containers as `FJALL_ALB_IDLE_TIMEOUT_SECONDS` (see
+ * `components/infrastructure/lib/resources/aws/compute/applicationLoadBalancer.ts`).
+ * This module is the consuming half of the contract: call
+ * `applyAlbKeepAliveTimeouts(server)` after `listen()`. When the env var is
+ * absent (local dev, containers deployed before the construct injected it) the
+ * AWS default of 60 seconds is assumed, which yields the same timeouts.
+ */
+export declare const FJALL_ALB_IDLE_TIMEOUT_ENV_VAR = "FJALL_ALB_IDLE_TIMEOUT_SECONDS";
+/**
+ * The ALB idle timeout every Fjall ALB is pinned to (also the AWS default,
+ * assumed when the env var is absent). The construct imports this constant so
+ * the ALB attribute, the injected env var, and this fallback cannot drift.
+ */
+export declare const DEFAULT_ALB_IDLE_TIMEOUT_SECONDS = 60;
+export interface AlbKeepAliveTimeouts {
+    albIdleTimeoutSeconds: number;
+    keepAliveTimeoutMs: number;
+    headersTimeoutMs: number;
+}
+/** Structural subset of `node:http.Server` this module tunes. */
+export interface KeepAliveTunableServer {
+    keepAliveTimeout: number;
+    headersTimeout: number;
+}
+/**
+ * Resolves the keep-alive timeouts for a server behind a Fjall ALB from
+ * `FJALL_ALB_IDLE_TIMEOUT_SECONDS`. Throws on a malformed value — a
+ * misconfigured contract must fail the boot loudly, not race the ALB.
+ */
+export declare function resolveAlbKeepAliveTimeouts(env?: Record<string, string | undefined>): AlbKeepAliveTimeouts;
+/**
+ * Applies the resolved timeouts to a Node HTTP(S) server and returns them so
+ * the caller can log what was applied.
+ */
+export declare function applyAlbKeepAliveTimeouts(server: KeepAliveTunableServer, env?: Record<string, string | undefined>): AlbKeepAliveTimeouts;

package/dist/httpKeepAlive.js

@@ -0,0 +1 @@
+var i=Object.defineProperty;var _=(o,e)=>i(o,"name",{value:e,configurable:!0});const E="FJALL_ALB_IDLE_TIMEOUT_SECONDS",T=60,r=5,u=1e3;function n(o=process.env){const e=o[E];let t=60;if(e!==void 0){if(!/^[0-9]+$/.test(e)||Number.parseInt(e,10)<=0)throw new Error(`${E} must be a positive integer number of seconds, got ${JSON.stringify(e)} \u2014 unset it to assume the AWS default of ${String(60)}`);t=Number.parseInt(e,10)}const s=(t+5)*1e3;return{albIdleTimeoutSeconds:t,keepAliveTimeoutMs:s,headersTimeoutMs:s+1e3}}_(n,"resolveAlbKeepAliveTimeouts");function I(o,e=process.env){const t=n(e);return o.keepAliveTimeout=t.keepAliveTimeoutMs,o.headersTimeout=t.headersTimeoutMs,t}_(I,"applyAlbKeepAliveTimeouts");export{T as DEFAULT_ALB_IDLE_TIMEOUT_SECONDS,E as FJALL_ALB_IDLE_TIMEOUT_ENV_VAR,I as applyAlbKeepAliveTimeouts,n as resolveAlbKeepAliveTimeouts};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fjall/util",
-  "version": "10.1.1",
+  "version": "10.1.2",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fjall-tech/fjall.git",
@@ -55,6 +55,10 @@
       "types": "./dist/fsHelpers.d.ts",
       "default": "./dist/fsHelpers.js"
     },
+    "./httpKeepAlive": {
+      "types": "./dist/httpKeepAlive.d.ts",
+      "default": "./dist/httpKeepAlive.js"
+    },
     "./cdkTmpdirCleanup": {
       "types": "./dist/cdkTmpdirCleanup.d.ts",
       "default": "./dist/cdkTmpdirCleanup.js"