@middy/util 7.1.1 → 7.1.3

package/README.md

@@ -30,6 +30,23 @@
 <p>You can read the documentation at: <a href="https://middy.js.org/docs/intro/utilities">https://middy.js.org/docs/intro/utilities</a></p>
 </div>
 
+## Install
+
+```bash
+npm install --save @middy/util
+```
+
+
+## Documentation and examples
+
+For documentation and examples, refer to the main [Middy monorepo on GitHub](https://github.com/middyjs/middy) or [Middy official website](https://middy.js.org/docs/intro/utilities).
+
+
+## Contributing
+
+Everyone is very welcome to contribute to this repository. Feel free to [raise issues](https://github.com/middyjs/middy/issues) or to [submit Pull Requests](https://github.com/middyjs/middy/pulls).
+
+
 ## License
 
 Licensed under [MIT License](LICENSE). Copyright (c) 2017-2026 [will Farrell](https://github.com/willfarrell), [Luciano Mammino](https://github.com/lmammino), and [Middy contributors](https://github.com/middyjs/middy/graphs/contributors).

package/index.d.ts

@@ -12,7 +12,7 @@ import type {
 } from "./type-utils.d.ts";
 
 export interface Options<Client, ClientOptions> {
-	AwsClient?: new (...[config]: [any] | any) => Client;
+	AwsClient?: new (config: ClientOptions) => Client;
 	awsClientOptions?: Partial<ClientOptions>;
 	awsClientAssumeRole?: string;
 	awsClientCapture?: (service: Client) => Client;
@@ -20,6 +20,7 @@ export interface Options<Client, ClientOptions> {
 	disablePrefetch?: boolean;
 	cacheKey?: string;
 	cacheExpiry?: number;
+	cacheKeyExpiry?: Record<string, number>;
 	setToContext?: boolean;
 }
 
@@ -27,8 +28,8 @@ export declare class HttpError extends Error {
 	status: number;
 	statusCode: number;
 	expose: boolean;
-	[key: string]: any;
-	[key: number]: any;
+	[key: string]: unknown;
+	[key: number]: unknown;
 }
 
 declare function createPrefetchClient<Client, ClientOptions>(
@@ -118,43 +119,48 @@ declare function sanitizeKey<T extends string>(key: T): SanitizeKey<T>;
 
 declare function processCache<Client, ClientOptions>(
 	options: Options<Client, ClientOptions>,
-	fetch: (request: middy.Request, cachedValues: any) => any,
+	fetch: (request: middy.Request, cachedValues: unknown) => unknown,
 	request?: middy.Request,
-): { value: any; expiry: number };
+): { value: unknown; expiry: number };
 
-declare function getCache(keys: string): any;
+declare function getCache(keys: string): unknown;
 
 declare function clearCache(keys?: string | string[] | null): void;
 
 declare function jsonSafeParse(
 	string: string,
-	reviver?: (key: string, value: any) => any,
-): any;
+	reviver?: (key: string, value: unknown) => unknown,
+): unknown;
 
 declare function normalizeHttpResponse(
-	request: any,
-	fallbackResponse?: any,
-): any;
+	request: middy.Request,
+	fallbackResponse?: Record<string, unknown>,
+): Record<string, unknown>;
 
 declare function createError(
 	code: number,
 	message: string,
-	properties?: Record<string, any>,
+	properties?: Record<string, unknown>,
 ): HttpError;
 
-declare function modifyCache(cacheKey: string, value: any): void;
+declare function modifyCache(cacheKey: string, value: unknown): void;
 
 declare function catchInvalidSignatureException<Client, Command>(
 	e: Error & { __type?: string },
 	client: Client,
 	command: Command,
-): Promise<any>;
+): Promise<unknown>;
 
 declare function jsonSafeStringify(
-	value: any,
-	replacer?: (key: string, value: any) => any,
+	value: unknown,
+	replacer?: (key: string, value: unknown) => unknown,
 	space?: string | number,
-): string | any;
+): string | unknown;
+
+declare function decodeBody(event: {
+	body?: string | null;
+	isBase64Encoded?: boolean;
+}): string | null | undefined;
 
 declare const lambdaContextKeys: string[];
 
@@ -166,12 +172,12 @@ declare function executionContext(
 	request: middy.Request,
 	key: string,
 	context: LambdaContext,
-): any;
+): unknown;
 
 declare function lambdaContext(
 	request: middy.Request,
 	key: string,
 	context: LambdaContext,
-): any;
+): unknown;
 
 declare const httpErrorCodes: Record<number, string>;

package/index.js

@@ -61,6 +61,36 @@ export const getInternal = async (variables, request) => {
 		keys = Object.keys(variables);
 		values = Object.values(variables);
 	}
+	// Fast synchronous path: when all internal values are already resolved
+	// (warm/cached invocations), skip all Promise machinery entirely
+	let allSync = true;
+	const syncResults = new Array(values.length);
+	for (let i = 0; i < values.length; i++) {
+		const internalKey = values[i];
+		const dotIndex = internalKey.indexOf(".");
+		const rootKey =
+			dotIndex === -1 ? internalKey : internalKey.substring(0, dotIndex);
+		let value = request.internal[rootKey];
+		if (isPromise(value)) {
+			allSync = false;
+			break;
+		}
+		if (dotIndex !== -1) {
+			for (const part of internalKey.substring(dotIndex + 1).split(".")) {
+				value = value?.[part];
+			}
+		}
+		syncResults[i] = value;
+	}
+	if (allSync) {
+		const obj = {};
+		for (let i = 0; i < keys.length; i++) {
+			obj[sanitizeKey(keys[i])] = syncResults[i];
+		}
+		return obj;
+	}
+
+	// Async fallback: for cold/first invocations with pending promises
 	const promises = [];
 	for (const internalKey of values) {
 		// 'internal.key.sub_value' -> { [key]: internal.key.sub_value }
@@ -79,18 +109,21 @@ export const getInternal = async (variables, request) => {
 	// ensure promise has resolved by the time it's needed
 	// If one of the promises throws it will bubble up to @middy/core
 	values = await Promise.allSettled(promises);
-	const errors = values
-		.filter((res) => res.status === "rejected")
-		.map((res) => res.reason);
-	if (errors.length) {
+	const obj = {};
+	let errors;
+	for (let i = 0; i < keys.length; i++) {
+		if (values[i].status === "rejected") {
+			errors ??= [];
+			errors.push(values[i].reason);
+		} else {
+			obj[sanitizeKey(keys[i])] = values[i].value;
+		}
+	}
+	if (errors) {
 		throw new Error("Failed to resolve internal values", {
 			cause: { package: "@middy/util", data: errors },
 		});
 	}
-	const obj = {};
-	for (let i = keys.length; i--; ) {
-		obj[sanitizeKey(keys[i])] = values[i].value;
-	}
 	return obj;
 };
 
@@ -125,7 +158,8 @@ export const processCache = (
 				cache[cacheKey] = { value: cached.value, expiry: cached.expiry };
 				return cache[cacheKey];
 			}
-			return { ...cached, cache: true };
+			cached.cache = true;
+			return cached;
 		}
 	}
 	const value = middlewareFetch(middlewareFetchRequest);
@@ -161,8 +195,9 @@ export const getCache = (key) => {
 // Used to remove parts of a cache
 export const modifyCache = (cacheKey, value) => {
 	if (!cache[cacheKey]) return;
-	clearTimeout(cache[cacheKey]?.refresh);
-	cache[cacheKey] = { ...cache[cacheKey], value, modified: true };
+	clearTimeout(cache[cacheKey].refresh);
+	cache[cacheKey].value = value;
+	cache[cacheKey].modified = true;
 };
 
 export const clearCache = (inputKeys = null) => {
@@ -192,18 +227,12 @@ export const lambdaContextKeys = [
 	"callbackWaitsForEmptyEventLoop",
 ];
 
-export const executionContextKeys = [
-	//'requestId',
-	"tenantId",
-];
+export const executionContextKeys = ["tenantId"];
 
 export const isExecutionModeDurable = (context) => {
 	// using `context instanceof DurableContextImpl` would be better
 	// but would require an extra dependency
-	if (context.constructor.name === "DurableContextImpl") {
-		return true;
-	}
-	return false;
+	return context.constructor.name === "DurableContextImpl";
 };
 
 export const executionContext = (request, key, context) => {
@@ -239,6 +268,12 @@ export const jsonSafeStringify = (value, replacer, space) => {
 	}
 };
 
+export const decodeBody = (event) => {
+	const { body, isBase64Encoded } = event;
+	if (typeof body === "undefined" || body === null) return body;
+	return isBase64Encoded ? Buffer.from(body, "base64").toString() : body;
+};
+
 export const normalizeHttpResponse = (request) => {
 	let { response } = request;
 	if (typeof response === "undefined") {
@@ -280,7 +315,7 @@ export const createError = (code, message, properties = {}) => {
 	return new HttpError(code, message, properties);
 };
 
-const httpErrorCodes = {
+export const httpErrorCodes = {
 	100: "Continue",
 	101: "Switching Protocols",
 	102: "Processing",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@middy/util",
-	"version": "7.1.1",
+	"version": "7.1.3",
 	"description": "🛵 The stylish Node.js middleware engine for AWS Lambda (util package)",
 	"type": "module",
 	"engines": {
@@ -60,7 +60,7 @@
 	},
 	"devDependencies": {
 		"@aws-sdk/client-ssm": "^3.0.0",
-		"@middy/core": "7.1.1",
+		"@middy/core": "7.1.3",
 		"@types/aws-lambda": "^8.0.0",
 		"@types/node": "^22.0.0",
 		"aws-xray-sdk": "^3.3.3"
@@ -69,6 +69,5 @@
 	"funding": {
 		"type": "github",
 		"url": "https://github.com/sponsors/willfarrell"
-	},
-	"gitHead": "7a6c0fbb8ab71d6a2171e678697de9f237568431"
+	}
 }