@reventlessdev/reventless-aws 3.0.0-alpha.214 → 3.0.0-alpha.216

package/CHANGELOG.md

@@ -3,6 +3,20 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# 3.0.0-alpha.216 (2026-07-17)
+
+### Bug Fixes
+
+* **plugin:** scale heartbeat disconnect grace and enforce single-source interval ([7ba8fb7](https://github.com/ReventlessDev/reventless-core/commit/7ba8fb7bfbe023aba7b538329d2489f939b7fcea))
+
+
+# 3.0.0-alpha.215 (2026-07-17)
+
+### Features
+
+* **runtime:** platform-supplied EP/task pod runtime floors ([37544d0](https://github.com/ReventlessDev/reventless-core/commit/37544d029d278bbcae6eeb0f583da07d6ce70f04))
+
+
 # 3.0.0-alpha.214 (2026-07-16)
 
 ### Features

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reventlessdev/reventless-aws",
-  "version": "3.0.0-alpha.214",
+  "version": "3.0.0-alpha.216",
   "description": "AWS adapters for Reventless",
   "license": "Apache-2.0",
   "dependencies": {
@@ -8,17 +8,17 @@
     "@aws-sdk/client-cloudfront": "3.970.0",
     "sury": "11.0.0-alpha.4",
     "uuid": "^13.0.0",
-    "@reventlessdev/rescript-effect": "0.1.0-alpha.28",
-    "@reventlessdev/rescript-aws-sdk": "2.2.0-alpha.22",
-    "@reventlessdev/rescript-jest": "1.0.0-alpha.8",
-    "@reventlessdev/rescript-pulumi-pulumi": "2.3.0-alpha.16",
-    "@reventlessdev/rescript-pulumi-aws": "2.4.0-alpha.54",
-    "@reventlessdev/rescript-uuid": "1.1.0-alpha.16",
-    "@reventlessdev/reventless-core": "3.0.0-alpha.170",
-    "@reventlessdev/reventless-infra": "3.0.0-alpha.101",
-    "@reventlessdev/reventless-interop": "3.0.0-alpha.27",
-    "@reventlessdev/reventless-postgres": "3.0.0-alpha.34",
-    "@reventlessdev/reventless-spec": "3.0.0-alpha.78"
+    "@reventlessdev/rescript-aws-sdk": "2.2.0-alpha.23",
+    "@reventlessdev/rescript-jest": "1.0.0-alpha.9",
+    "@reventlessdev/rescript-effect": "0.1.0-alpha.29",
+    "@reventlessdev/rescript-pulumi-aws": "2.4.0-alpha.55",
+    "@reventlessdev/rescript-pulumi-pulumi": "2.3.0-alpha.17",
+    "@reventlessdev/rescript-uuid": "1.1.0-alpha.17",
+    "@reventlessdev/reventless-core": "3.0.0-alpha.172",
+    "@reventlessdev/reventless-infra": "3.0.0-alpha.102",
+    "@reventlessdev/reventless-postgres": "3.0.0-alpha.36",
+    "@reventlessdev/reventless-spec": "3.0.0-alpha.79",
+    "@reventlessdev/reventless-interop": "3.0.0-alpha.28"
   },
   "devDependencies": {
     "rescript": "12.3.0",
@@ -56,7 +56,7 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ReventlessDev/reventless-core.git",
-    "directory": "reventless/reventless-aws"
+    "directory": "reventless/aws"
   },
   "scripts": {
     "build": "rescript build",

package/scripts/run-integration-tests.sh

@@ -5,7 +5,7 @@
 set -euo pipefail
 
 ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../../.." && pwd)"
-COMPOSE="$ROOT/reventless/reventless-aws/docker-compose.dynamodb-local.yml"
+COMPOSE="$ROOT/reventless/aws/docker-compose.dynamodb-local.yml"
 ENDPOINT="${AWS_ENDPOINT_URL_DYNAMODB:-http://localhost:8000}"
 
 if ! command -v docker >/dev/null 2>&1; then

package/scripts/run-pg-integration-tests.sh

@@ -9,7 +9,7 @@
 set -euo pipefail
 
 ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../../.." && pwd)"
-COMPOSE="$ROOT/reventless/reventless-aws/docker-compose.postgres.yml"
+COMPOSE="$ROOT/reventless/aws/docker-compose.postgres.yml"
 
 run_jest() {
   cd "$ROOT"

package/src/Platform.res

@@ -700,12 +700,13 @@ module MakeWithConfig = (
     // Heartbeat EP channel hook — extracts SQS queue URL for heartbeat Lambda handler
     // and records the calling plugin's id so the Lambda runtime can emit Connect commands
     // with a non-empty SQS MessageGroupId (FIFO requirement).
-    onHeartbeatEpChannelAvailable: (remoteChannelUnknown, ~pluginId) => {
+    onHeartbeatEpChannelAvailable: (remoteChannelUnknown, ~pluginId, ~heartbeatInterval) => {
       let remoteChannel = remoteChannelUnknown->asRemoteChannel
       switch remoteChannel.resources->Array.get(0) {
       | Some(resource) =>
         PluginRuntime_Builder.registerHeartbeatConfig(
           ~pluginId,
+          ~heartbeatTimeout=heartbeatInterval,
           ~epQueueUrl=resource.id->Pulumi.Output.make,
           (),
         )

package/src/Platform.res.mjs

@@ -495,10 +495,10 @@ function MakeWithConfig(Config) {
     StateViewSliceRuntime_Builder_Single$ReventlessAws.finishWithDcbEventLog(dcbEventLogUnknown);
     AutomationSliceRuntime_Builder_Single$ReventlessAws.finish();
   };
-  let hooks_onHeartbeatEpChannelAvailable = (remoteChannelUnknown, pluginId) => {
+  let hooks_onHeartbeatEpChannelAvailable = (remoteChannelUnknown, pluginId, heartbeatInterval) => {
     let resource = remoteChannelUnknown.resources[0];
     if (resource !== undefined) {
-      return PluginRuntime_Builder$ReventlessAws.registerHeartbeatConfig(pluginId, undefined, Pulumi.output(resource.id), undefined);
+      return PluginRuntime_Builder$ReventlessAws.registerHeartbeatConfig(pluginId, heartbeatInterval, Pulumi.output(resource.id), undefined);
     } else {
       return log.warn("Platform", undefined, "heartbeat EP channel has no resources");
     }
@@ -1467,10 +1467,10 @@ function Make($star) {
     StateViewSliceRuntime_Builder_Single$ReventlessAws.finishWithDcbEventLog(dcbEventLogUnknown);
     AutomationSliceRuntime_Builder_Single$ReventlessAws.finish();
   };
-  let hooks_onHeartbeatEpChannelAvailable = (remoteChannelUnknown, pluginId) => {
+  let hooks_onHeartbeatEpChannelAvailable = (remoteChannelUnknown, pluginId, heartbeatInterval) => {
     let resource = remoteChannelUnknown.resources[0];
     if (resource !== undefined) {
-      return PluginRuntime_Builder$ReventlessAws.registerHeartbeatConfig(pluginId, undefined, Pulumi.output(resource.id), undefined);
+      return PluginRuntime_Builder$ReventlessAws.registerHeartbeatConfig(pluginId, heartbeatInterval, Pulumi.output(resource.id), undefined);
     } else {
       return log.warn("Platform", undefined, "heartbeat EP channel has no resources");
     }

package/src/Platform_Casts.res

@@ -56,7 +56,7 @@ external asLambdaRuntime: ReventlessCore.Runtime.environment<unknown> => Reventl
 //   onDcbEventLogCreated?:       unknown => unit
 //   onDcbCommandTopicCreated?:   unknown => unit
 //   onDcbSlicesCreated?:         unknown => unit
-//   onHeartbeatEpChannelAvailable?: (unknown, ~pluginId: string) => unit
+//   onHeartbeatEpChannelAvailable?: (unknown, ~pluginId: string, ~heartbeatInterval: int) => unit
 //
 // are typed `unknown => unit` for the same dependency-inversion reason as above:
 // `reventless-core` cannot import `DcbEventLog.component`, `CommandTopic.component`,

package/src/components/ExtensionPoint_Builder.res

@@ -2,6 +2,13 @@ module CommandTopicChannel = CommandTopicChannel.SQS_Sync
 module RuntimeEnvironment = RuntimeEnvironment.Lambda
 module ExtensionPointRuntimeBuilder = ExtensionPointRuntime_Builder_PerExtensionPoint
 
+// Per-extension-point Lambda floor for AWS; a plugin.json `runtime` override
+// raises it via `RuntimeHints.resolveMemory`/`resolveTimeout`.
+module Defaults: ReventlessInfra.RuntimeDefaults.T = {
+  let memorySize = 1024
+  let timeout = 30
+}
+
 module Make = (
   Spec: ReventlessInfra.ExtensionPointMapping.Spec,
   Mappings: ReventlessInfra.ExtensionPoint.Mappings with module Spec := Spec,
@@ -13,4 +20,5 @@ module Make = (
     CommandTopicChannel,
     EventTopicPublisher.SNS,
     ExtensionPointRuntimeBuilder,
+    Defaults,
   )

package/src/components/ExtensionPoint_Builder.res.mjs

@@ -6,6 +6,11 @@ import * as RuntimeEnvironment_Lambda$ReventlessAws from "../adapter/Runtime/Run
 import * as CommandTopicChannel_SQS_Sync$ReventlessAws from "../adapter/CommandTopic/CommandTopicChannel_SQS_Sync.res.mjs";
 import * as ExtensionPointRuntime_Builder_PerExtensionPoint$ReventlessAws from "../adapter/Runtime/ExtensionPointRuntime_Builder_PerExtensionPoint.res.mjs";
 
+let Defaults = {
+  memorySize: 1024,
+  timeout: 30
+};
+
 function Make(Spec) {
   return Mappings => ExtensionPoint_Builder$ReventlessCore.Make(Spec)(Mappings)({
     make: RuntimeEnvironment_Lambda$ReventlessAws.make,
@@ -19,7 +24,7 @@ function Make(Spec) {
     make: EventTopicPublisher_SNS$ReventlessAws.make
   })({
     forCommandTopic: ExtensionPointRuntime_Builder_PerExtensionPoint$ReventlessAws.forCommandTopic
-  });
+  })(Defaults);
 }
 
 let CommandTopicChannel;
@@ -32,6 +37,7 @@ export {
   CommandTopicChannel,
   RuntimeEnvironment,
   ExtensionPointRuntimeBuilder,
+  Defaults,
   Make,
 }
 /* EventTopicPublisher_SNS-ReventlessAws Not a pure module */

package/src/components/Task_Builder.res.mjs

@@ -14,6 +14,8 @@ let TaskRuntimeBuilder = Task_Builder_PerBucket$ReventlessAws.TaskRuntimeBuilder
 
 let SideEffectHandler = Task_Builder_PerBucket$ReventlessAws.SideEffectHandler;
 
+let Defaults = Task_Builder_PerBucket$ReventlessAws.Defaults;
+
 let Make = Task_Builder_PerBucket$ReventlessAws.Make;
 
 export {
@@ -23,6 +25,7 @@ export {
   TaskBucket,
   TaskRuntimeBuilder,
   SideEffectHandler,
+  Defaults,
   Make,
 }
 /* Task_Builder_PerBucket-ReventlessAws Not a pure module */

package/src/components/Task_Builder_PerBucket.res

@@ -8,6 +8,13 @@ module TaskBucket = TaskBucket.S3
 module TaskRuntimeBuilder = TaskRuntime_Builder_PerBucket
 module SideEffectHandler = SideEffectHandler_PerSideEffectHandler
 
+// Per-bucket task Lambda floor for AWS (large envelope for bulk import/export);
+// a plugin.json `runtime` override raises it via `RuntimeHints`.
+module Defaults: ReventlessInfra.RuntimeDefaults.T = {
+  let memorySize = 4096
+  let timeout = 600
+}
+
 module Make = (Spec: ReventlessCore.Task.Spec): (
   ReventlessCore.Task.T with module Spec = Spec
 ) =>
@@ -19,4 +26,5 @@ module Make = (Spec: ReventlessCore.Task.Spec): (
     TaskRuntimeBuilder,
     TaskBucket,
     SideEffectHandler,
+    Defaults,
   )

package/src/components/Task_Builder_PerBucket.res.mjs

@@ -19,6 +19,11 @@ let EventCollectorRuntimeBuilder = EventCollectorRuntime_Builder_PerEventCollect
   connect: EventCollectorChannel_DynamoDbStream$ReventlessAws.connect
 });
 
+let Defaults = {
+  memorySize: 4096,
+  timeout: 600
+};
+
 function Make(Spec) {
   return Task_Builder$ReventlessCore.Make(Spec)({
     make: RuntimeEnvironment_Lambda$ReventlessAws.make,
@@ -38,7 +43,7 @@ function Make(Spec) {
     make: TaskBucket_S3$ReventlessAws.make
   })({
     make: SideEffectHandler_PerSideEffectHandler$ReventlessAws.make
-  });
+  })(Defaults);
 }
 
 let EventCollectorChannel;
@@ -58,6 +63,7 @@ export {
   TaskBucket,
   TaskRuntimeBuilder,
   SideEffectHandler,
+  Defaults,
   Make,
 }
 /* EventCollectorRuntimeBuilder Not a pure module */

package/src/plugin/runtime/PluginRuntime_Builder.res

@@ -74,7 +74,12 @@ let heartbeatConfigRef: ref<heartbeatConfig> = ref({
   epQueueUrl: None,
 })
 
-let registerHeartbeatConfig = (~pluginId, ~heartbeatTimeout=10, ~epQueueUrl=?, ()) =>
+// heartbeatTimeout is mandatory: it drives the HEARTBEAT_TIMEOUT env var (and thus
+// the Heartbeat(interval) command the bundled Lambda emits), which must match the
+// EventBridge schedule rate derived from the same heartbeatInterval. A default here
+// silently decoupled the two (schedule every 60min, Heartbeat(10) → 12min grace →
+// flapping); make callers supply it so the values can't diverge.
+let registerHeartbeatConfig = (~pluginId, ~heartbeatTimeout, ~epQueueUrl=?, ()) =>
   heartbeatConfigRef := {pluginId, heartbeatTimeout, epQueueUrl}
 
 // Per-flavor commandHandlerConfig override for the two DCB command-handler Lambdas

package/src/plugin/runtime/PluginRuntime_Builder.res.mjs

@@ -76,8 +76,7 @@ let heartbeatConfigRef = {
   }
 };
 
-function registerHeartbeatConfig(pluginId, heartbeatTimeoutOpt, epQueueUrl, param) {
-  let heartbeatTimeout = heartbeatTimeoutOpt !== undefined ? heartbeatTimeoutOpt : 10;
+function registerHeartbeatConfig(pluginId, heartbeatTimeout, epQueueUrl, param) {
   heartbeatConfigRef.contents = {
     pluginId: pluginId,
     heartbeatTimeout: heartbeatTimeout,

package/src/plugin/stack/Plugin_ExtensionPoint_Builder.res

@@ -20,6 +20,7 @@ module MakeWithConfig = (
   CommandTopicChannel,
   EventTopicPublisher.SNS,
   ExtensionPointRuntimeBuilder,
+  ExtensionPoint_Builder.Defaults,
 )
 
 module Make: ReventlessCore.ExtensionPoint.T = MakeWithConfig({

package/src/plugin/stack/Plugin_ExtensionPoint_Builder.res.mjs

@@ -1,6 +1,7 @@
 // Generated by ReScript, PLEASE EDIT WITH CARE
 
 import * as Stdlib_Option from "@rescript/runtime/lib/es6/Stdlib_Option.js";
+import * as ExtensionPoint_Builder$ReventlessAws from "../../components/ExtensionPoint_Builder.res.mjs";
 import * as EventTopicPublisher_SNS$ReventlessAws from "../../adapter/EventTopic/EventTopicPublisher_SNS.res.mjs";
 import * as PluginRuntimeOperations$ReventlessAws from "../runtime/PluginRuntimeOperations.res.mjs";
 import * as RuntimeEnvironment_Lambda$ReventlessAws from "../../adapter/Runtime/RuntimeEnvironment_Lambda.res.mjs";
@@ -27,7 +28,7 @@ function MakeWithConfig(Config) {
     make: EventTopicPublisher_SNS$ReventlessAws.make
   })({
     forCommandTopic: PluginExtensionPointRuntime_Builder$ReventlessAws.forCommandTopic
-  });
+  })(ExtensionPoint_Builder$ReventlessAws.Defaults);
 }
 
 let environment = Stdlib_Option.getOr(process.env.Environment, "unknown");
@@ -49,7 +50,7 @@ let Make = PluginExtensionPoint_Builder$ReventlessCore.Make({
   make: EventTopicPublisher_SNS$ReventlessAws.make
 })({
   forCommandTopic: PluginExtensionPointRuntime_Builder$ReventlessAws.forCommandTopic
-});
+})(ExtensionPoint_Builder$ReventlessAws.Defaults);
 
 let CommandTopicChannel;
 

package/tests/ComponentRuntimeDefaultsTest.res

@@ -0,0 +1,26 @@
+open JestGlobals
+
+// The per-kind EP/task pod floor is now supplied by each platform's `Defaults`
+// module (RuntimeDefaults.T) and fed into RuntimeHints.resolveMemory/resolveTimeout
+// by the core builders, replacing core's old hardcoded literals. These guard that
+// the AWS binding stays behavior-preserving: EP pods still floor at 1024 MiB / 30 s
+// and task pods at 4096 MiB / 600 s. A plugin.json `runtime` override still raises
+// memory (Math.Int.max) and replaces timeout on top of these — see RuntimeHintsTest.
+
+describe("AWS extension-point runtime defaults", () => {
+  testSync("memory floor is 1024 MiB", () => {
+    expect(ExtensionPoint_Builder.Defaults.memorySize)->toBe(1024)
+  })
+  testSync("timeout floor is 30 s", () => {
+    expect(ExtensionPoint_Builder.Defaults.timeout)->toBe(30)
+  })
+})
+
+describe("AWS task runtime defaults", () => {
+  testSync("memory floor is 4096 MiB", () => {
+    expect(Task_Builder_PerBucket.Defaults.memorySize)->toBe(4096)
+  })
+  testSync("timeout floor is 600 s", () => {
+    expect(Task_Builder_PerBucket.Defaults.timeout)->toBe(600)
+  })
+})

package/tests/ComponentRuntimeDefaultsTest.res.mjs

@@ -0,0 +1,24 @@
+// Generated by ReScript, PLEASE EDIT WITH CARE
+
+import * as ExtensionPoint_Builder$ReventlessAws from "../src/components/ExtensionPoint_Builder.res.mjs";
+import * as Task_Builder_PerBucket$ReventlessAws from "../src/components/Task_Builder_PerBucket.res.mjs";
+
+globalThis.describe("AWS extension-point runtime defaults", () => {
+  globalThis.test("memory floor is 1024 MiB", () => {
+    globalThis.expect(ExtensionPoint_Builder$ReventlessAws.Defaults.memorySize).toBe(1024);
+  });
+  globalThis.test("timeout floor is 30 s", () => {
+    globalThis.expect(ExtensionPoint_Builder$ReventlessAws.Defaults.timeout).toBe(30);
+  });
+});
+
+globalThis.describe("AWS task runtime defaults", () => {
+  globalThis.test("memory floor is 4096 MiB", () => {
+    globalThis.expect(Task_Builder_PerBucket$ReventlessAws.Defaults.memorySize).toBe(4096);
+  });
+  globalThis.test("timeout floor is 600 s", () => {
+    globalThis.expect(Task_Builder_PerBucket$ReventlessAws.Defaults.timeout).toBe(600);
+  });
+});
+
+/*  Not a pure module */