Merge pull request #30 from jeremyLabrado/feat/upgrade-nodejs-24-runtime

feat: Upgrade Lambda functions to Node.js 24 runtime

Author: Anthony Bernabeu

README.md

@@ -295,10 +295,18 @@ npm run dev
 
 ## Requirements
 
+- [Node.js 18+](https://nodejs.org/en/) must be installed on the deployment machine. ([Instructions](https://nodejs.org/en/download/))
 
-- [Node JS 18+](https://nodejs.org/en/) must be installed on the deployment machine. ([Instructions](https://nodejs.org/en/download/))
+- [AWS CLI 2+](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html) must be installed on the deployment machine. ([Instructions](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html))
 
-- [AWS CLI 2+](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html) must be installed on the deployment machine. ([Instructions](https://nodejs.org/en/download/))
+## Runtime Versions
+
+The application uses the following AWS Lambda runtimes:
+
+- **Node.js 24.x** - For TypeScript Lambda functions (product summary, recipe steps, authentication)
+- **Python 3.12** - For Python Lambda functions (barcode scanning, image analysis, recipe generation)
+
+The Node.js functions were upgraded to Node.js 24 in December 2025 to leverage the latest features including improved HTTP performance (Undici 7), explicit resource management, and enhanced async context handling. See [NODEJS_24_UPGRADE.md](./NODEJS_24_UPGRADE.md) for details.
 
 
 ## Resources

lambda/barcode_product_summary/index.ts

@@ -212,7 +212,7 @@ async function getProductSummary(productCode: string, paramsHash: string): Promi
     }
 }
 
-async function generateSummary(promptText, responseStream) {
+async function generateSummary(promptText: string, responseStream: NodeJS.WritableStream) {
 
     const payload = {
         messages: [
@@ -270,7 +270,7 @@ async function generateSummary(promptText, responseStream) {
     return completion;
 }
 
-async function simulateSummaryStreaming(content: string, responseStream): Promise<void> {
+async function simulateSummaryStreaming(content: string, responseStream: NodeJS.WritableStream): Promise<void> {
 
     const chunks = [];
     let remainingContent = content;
@@ -317,7 +317,7 @@ async function putProductSummaryToDynamoDB(product_code: string, params_hash: st
     }
 }
 
-async function messageHandler (event, responseStream) {
+async function messageHandler (event: APIGatewayProxyEventV2, responseStream: NodeJS.WritableStream) {
 
     try {
         logger.info(event as any);

lambda/recipe_step_by_step/index.ts

@@ -29,7 +29,7 @@ const bedrockRuntimeClient = new BedrockRuntimeClient({ region: process.env.REGI
 
 
 
-async function generateRecipeSteps(language: string, recipe, responseStream) {
+async function generateRecipeSteps(language: string, recipe: any, responseStream: NodeJS.WritableStream) {
 
     const systemPrompt = "Your task is to generate personalized recipe ideas based on the user's input of available ingredients and dietary preferences. Use this information to suggest a variety of creative and delicious recipes that can be made using the given ingredients while accommodating the user's dietary needs, if any are mentioned. For each recipe, provide a brief description, a list of required ingredients, and a simple set of instructions. Ensure that the recipes are easy to follow, nutritious, and can be prepared with minimal additional ingredients or equipment.";
 
@@ -155,7 +155,7 @@ async function generateRecipeSteps(language: string, recipe, responseStream) {
 
 
 
-async function messageHandler (event, responseStream) {
+async function messageHandler (event: APIGatewayProxyEventV2, responseStream: NodeJS.WritableStream) {
 
     try {
         logger.info(event as any);

lib/food-analyzer-stack.ts

@@ -423,7 +423,7 @@ export class FoodAnalyzerStack extends Stack {
           __dirname,
           "../lambda/barcode_product_summary/index.ts"
         ),
-        runtime: lambda.Runtime.NODEJS_22_X,
+        runtime: lambda.Runtime.NODEJS_24_X,
         role: basicLambdaRole,
         timeout: Duration.minutes(10),
         layers: [powerToolsTypeScriptLayer],
@@ -447,7 +447,7 @@ export class FoodAnalyzerStack extends Stack {
       "recipeStepByStepFunction",
       {
         entry: path.join(__dirname, "../lambda/recipe_step_by_step/index.ts"),
-        runtime: lambda.Runtime.NODEJS_22_X,
+        runtime: lambda.Runtime.NODEJS_24_X,
         role: basicLambdaRole,
         timeout: Duration.minutes(10),
         layers: [powerToolsTypeScriptLayer],
@@ -543,7 +543,7 @@ export class FoodAnalyzerStack extends Stack {
       `AuthFunctionAtEdge`,
       {
         handler: "index.handler",
-        runtime: lambda.Runtime.NODEJS_22_X,
+        runtime: lambda.Runtime.NODEJS_24_X,
         code: lambda.Code.fromAsset(path.join(__dirname, "../lambda/auth")),
       }
     );