feat: enforce minimum runtime requirement for durable functions

Author: fossamagna

packages/backend-function/src/factory.test.ts

@@ -864,6 +864,7 @@ void describe('AmplifyFunctionFactory', () => {
     void it('sets valid durableConfig with executionTimeoutSeconds only', () => {
       const lambda = defineFunction({
         entry: './test-assets/default-lambda/handler.ts',
+        runtime: 22,
         durableConfig: {
           executionTimeoutSeconds: 3600, // 1 hour
         },
@@ -881,6 +882,7 @@ void describe('AmplifyFunctionFactory', () => {
     void it('sets valid durableConfig with both executionTimeoutSeconds and retentionPeriodDays', () => {
       const lambda = defineFunction({
         entry: './test-assets/default-lambda/handler.ts',
+        runtime: 22,
         durableConfig: {
           executionTimeoutSeconds: 86400, // 1 day
           retentionPeriodDays: 30,
@@ -899,6 +901,7 @@ void describe('AmplifyFunctionFactory', () => {
     void it('sets valid durableConfig with maximum values', () => {
       const lambda = defineFunction({
         entry: './test-assets/default-lambda/handler.ts',
+        runtime: 22,
         durableConfig: {
           executionTimeoutSeconds: 31_622_400, // 366 days
           retentionPeriodDays: 90,
@@ -917,6 +920,7 @@ void describe('AmplifyFunctionFactory', () => {
     void it('sets valid durableConfig with minimum values', () => {
       const lambda = defineFunction({
         entry: './test-assets/default-lambda/handler.ts',
+        runtime: 22,
         durableConfig: {
           executionTimeoutSeconds: 1,
           retentionPeriodDays: 1,
@@ -1043,6 +1047,39 @@ void describe('AmplifyFunctionFactory', () => {
         DurableConfig: Match.absent(),
       });
     });
+
+    void it('throws when durableConfig is used with runtime below 22', () => {
+      assert.throws(
+        () =>
+          defineFunction({
+            entry: './test-assets/default-lambda/handler.ts',
+            runtime: 20,
+            durableConfig: {
+              executionTimeoutSeconds: 3600,
+            },
+          }).getInstance(getInstanceProps),
+        new AmplifyUserError('UnsupportedDurableFunctionRuntimeError', {
+          message: `Durable functions require runtime 22 or higher. Current runtime is 20.`,
+          resolution: `Set the function runtime to 22 or higher to use durable functions.`,
+        }),
+      );
+    });
+
+    void it('throws when durableConfig is used with default runtime', () => {
+      assert.throws(
+        () =>
+          defineFunction({
+            entry: './test-assets/default-lambda/handler.ts',
+            durableConfig: {
+              executionTimeoutSeconds: 3600,
+            },
+          }).getInstance(getInstanceProps),
+        new AmplifyUserError('UnsupportedDurableFunctionRuntimeError', {
+          message: `Durable functions require runtime 22 or higher. Current runtime is 20.`,
+          resolution: `Set the function runtime to 22 or higher to use durable functions.`,
+        }),
+      );
+    });
   });
 
   void describe('provided function runtime property', () => {

packages/backend-function/src/factory.ts

@@ -568,6 +568,14 @@ class FunctionFactory implements ConstructFactory<AmplifyFunction> {
       }
     }
 
+    const runtime = this.resolveRuntime();
+    if (runtime < 22) {
+      throw new AmplifyUserError('UnsupportedDurableFunctionRuntimeError', {
+        message: `Durable functions require runtime 22 or higher. Current runtime is ${runtime}.`,
+        resolution: `Set the function runtime to 22 or higher to use durable functions.`,
+      });
+    }
+
     return {
       executionTimeoutSeconds: this.props.durableConfig.executionTimeoutSeconds,
       retentionPeriodDays: this.props.durableConfig.retentionPeriodDays ?? 14,