@contrail/util 2.0.1-alpha.5 → 2.1.0

package/CHANGELOG.md

@@ -7,6 +7,13 @@ Versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+### Added
+
+- `lambda-util` — AWS Lambda response-size helpers shared across services.
+  - `MAX_LAMBDA_RESPONSE_MB` / `RESPONSE_SIZE_BUFFER_MB` — the 6MB Lambda response cap and the safety buffer held below it.
+  - `RESPONSE_BYTE_LIMIT` — the cap minus the buffer, in bytes, for size checks that work in bytes.
+  - `getSerializedByteSize` — serialized byte size of any value. Treats `undefined` as `null`, since `JSON.stringify(undefined)` returns `undefined` rather than a string and `Buffer.byteLength` throws on it.
+
 ## [1.2.1] - 2026-03-25
 
 ### Added

package/lib/index.d.ts

@@ -1,6 +1,7 @@
 export * from './app-util/app-util';
 export * from './compression-util';
 export * from './date-util/date-util';
+export * from './lambda-util/lambda-util';
 export * from './map-util/map-util';
 export * from './object-util/object-util';
 export * from './order-util/order-util';

package/lib/index.js

@@ -17,6 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./app-util/app-util"), exports);
 __exportStar(require("./compression-util"), exports);
 __exportStar(require("./date-util/date-util"), exports);
+__exportStar(require("./lambda-util/lambda-util"), exports);
 __exportStar(require("./map-util/map-util"), exports);
 __exportStar(require("./object-util/object-util"), exports);
 __exportStar(require("./order-util/order-util"), exports);

package/lib/lambda-util/lambda-util.d.ts

@@ -0,0 +1,4 @@
+export declare const MAX_LAMBDA_RESPONSE_MB = 6;
+export declare const RESPONSE_SIZE_BUFFER_MB = 0.5;
+export declare const RESPONSE_BYTE_LIMIT: number;
+export declare function getSerializedByteSize(value: unknown): number;

package/lib/lambda-util/lambda-util.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RESPONSE_BYTE_LIMIT = exports.RESPONSE_SIZE_BUFFER_MB = exports.MAX_LAMBDA_RESPONSE_MB = void 0;
+exports.getSerializedByteSize = getSerializedByteSize;
+exports.MAX_LAMBDA_RESPONSE_MB = 6;
+exports.RESPONSE_SIZE_BUFFER_MB = 0.5;
+exports.RESPONSE_BYTE_LIMIT = (exports.MAX_LAMBDA_RESPONSE_MB - exports.RESPONSE_SIZE_BUFFER_MB) * 1024 * 1024;
+function getSerializedByteSize(value) {
+    return Buffer.byteLength(JSON.stringify(value !== null && value !== void 0 ? value : null));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contrail/util",
-  "version": "2.0.1-alpha.5",
+  "version": "2.1.0",
   "description": "General JavaScript utilities",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -39,7 +39,7 @@
     "testEnvironment": "node"
   },
   "dependencies": {
-    "@contrail/types": "^4.0.1-alpha.1",
+    "@contrail/types": "^4.0.0",
     "fflate": "^0.8.2",
     "lodash": "^4.17.21",
     "p-limit": "^3.1.0"