@contrail/util 2.2.0-alpha.3804ed9 → 2.2.0-alpha.3b8e11b

package/CHANGELOG.md

@@ -18,10 +18,11 @@ Versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ### Added
 
-- `response-size-util` — measures whether a payload fits within AWS Lambda's 6MB response limit, so services can decide to offload to S3 based on actual serialized bytes rather than a row count.
+- `response-size-util` — measures whether a payload fits within the AWS Lambda response limit, so services can decide to offload to S3 based on actual serialized bytes rather than a row count.
   - `exceedsResponseBudget(value, options?)` — the decision helper. For arrays it serializes one element at a time and stops as soon as the budget is crossed, so the cost is bounded by the budget rather than by the size of the payload.
   - `getJsonByteLength(value)` / `getUtf8ByteLength(str)` — exact UTF-8 byte measurement.
-  - `getResponseBudgetBytes(options?)`, `LAMBDA_MAX_RESPONSE_BYTES`, `DEFAULT_RESPONSE_BUFFER_BYTES` — the budget and its defaults (6MB ceiling, 512KB buffer).
+  - `getResponseBudgetBytes(options?)` — the budget a measured payload must stay under.
+  - `LAMBDA_MAX_RESPONSE_BYTES`, `RESPONSE_GUARD_LIMIT_BYTES`, `DEFAULT_RESPONSE_BUFFER_BYTES`, `DEFAULT_RESPONSE_BUDGET_BYTES` — the ladder of thresholds a response crosses, each sitting below the one above it so a payload offloads before `core`'s response guard returns a 413, and the guard fires before Lambda rejects the invocation.
 
 ## [1.2.1] - 2026-03-25
 

package/lib/response-size-util/response-size-util.d.ts

@@ -1,7 +1,9 @@
-export declare const LAMBDA_MAX_RESPONSE_BYTES: number;
-export declare const DEFAULT_RESPONSE_BUFFER_BYTES: number;
+export declare const LAMBDA_MAX_RESPONSE_BYTES = 6000000;
+export declare const RESPONSE_GUARD_LIMIT_BYTES = 5500000;
+export declare const DEFAULT_RESPONSE_BUFFER_BYTES = 500000;
+export declare const DEFAULT_RESPONSE_BUDGET_BYTES: number;
 export interface ResponseBudgetOptions {
-    maxBytes?: number;
+    limitBytes?: number;
     bufferBytes?: number;
 }
 export declare function getResponseBudgetBytes(options?: ResponseBudgetOptions): number;

package/lib/response-size-util/response-size-util.js

@@ -1,17 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_RESPONSE_BUFFER_BYTES = exports.LAMBDA_MAX_RESPONSE_BYTES = void 0;
+exports.DEFAULT_RESPONSE_BUDGET_BYTES = exports.DEFAULT_RESPONSE_BUFFER_BYTES = exports.RESPONSE_GUARD_LIMIT_BYTES = exports.LAMBDA_MAX_RESPONSE_BYTES = void 0;
 exports.getResponseBudgetBytes = getResponseBudgetBytes;
 exports.getUtf8ByteLength = getUtf8ByteLength;
 exports.getJsonByteLength = getJsonByteLength;
 exports.exceedsResponseBudget = exceedsResponseBudget;
-exports.LAMBDA_MAX_RESPONSE_BYTES = 6 * 1024 * 1024;
-exports.DEFAULT_RESPONSE_BUFFER_BYTES = 0.5 * 1024 * 1024;
+exports.LAMBDA_MAX_RESPONSE_BYTES = 6000000;
+exports.RESPONSE_GUARD_LIMIT_BYTES = 5500000;
+exports.DEFAULT_RESPONSE_BUFFER_BYTES = 500000;
+exports.DEFAULT_RESPONSE_BUDGET_BYTES = exports.RESPONSE_GUARD_LIMIT_BYTES - exports.DEFAULT_RESPONSE_BUFFER_BYTES;
+const JSON_NULL_BYTES = 'null'.length;
 function getResponseBudgetBytes(options = {}) {
     var _a, _b;
-    const maxBytes = (_a = options.maxBytes) !== null && _a !== void 0 ? _a : exports.LAMBDA_MAX_RESPONSE_BYTES;
+    const limitBytes = (_a = options.limitBytes) !== null && _a !== void 0 ? _a : exports.RESPONSE_GUARD_LIMIT_BYTES;
     const bufferBytes = (_b = options.bufferBytes) !== null && _b !== void 0 ? _b : exports.DEFAULT_RESPONSE_BUFFER_BYTES;
-    return Math.max(0, maxBytes - bufferBytes);
+    return Math.max(0, limitBytes - bufferBytes);
 }
 function getUtf8ByteLength(str) {
     if (typeof Buffer !== 'undefined') {
@@ -34,13 +37,15 @@ function exceedsResponseBudget(value, options = {}) {
     if (value.length === 0) {
         return false;
     }
-    let totalBytes = 2 + (value.length - 1);
+    const bracketBytes = '[]'.length;
+    const separatorBytes = value.length - 1;
+    let totalBytes = bracketBytes + separatorBytes;
     for (const element of value) {
         if (totalBytes > budgetBytes) {
             return true;
         }
         const serialized = JSON.stringify(element);
-        totalBytes += serialized === undefined ? 4 : getUtf8ByteLength(serialized);
+        totalBytes += serialized === undefined ? JSON_NULL_BYTES : getUtf8ByteLength(serialized);
     }
     return totalBytes > budgetBytes;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contrail/util",
-  "version": "2.2.0-alpha.3804ed9",
+  "version": "2.2.0-alpha.3b8e11b",
   "description": "General JavaScript utilities",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",