@reventlessdev/reventless-aws 3.0.0-alpha.269 → 3.0.0-alpha.271

package/CHANGELOG.md

@@ -3,6 +3,21 @@
 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.271 (2026-08-08)
+
+**Note:** Version bump only for package @reventlessdev/reventless-aws
+
+
+
+
+
+# 3.0.0-alpha.270 (2026-08-08)
+
+### Features
+
+* **core,aws,local:** add the RuntimeExtension cold-start seam ([143e30e](https://github.com/ReventlessDev/reventless-core/commit/143e30eeded6232ce7f0fcc18328939b2917bb31))
+
+
 # 3.0.0-alpha.269 (2026-08-07)
 
 ### Features

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reventlessdev/reventless-aws",
-  "version": "3.0.0-alpha.269",
+  "version": "3.0.0-alpha.271",
   "description": "AWS adapters for Reventless",
   "license": "Apache-2.0",
   "dependencies": {
@@ -12,17 +12,17 @@
     "sury": "11.0.0-alpha.4",
     "uuid": "^13.0.0",
     "@reventlessdev/rescript-aws-sdk": "3.0.0-alpha.4",
-    "@reventlessdev/rescript-effect": "0.1.0-alpha.32",
     "@reventlessdev/rescript-jest": "1.0.0-alpha.10",
-    "@reventlessdev/rescript-pulumi-aws": "2.4.0-alpha.66",
     "@reventlessdev/rescript-node": "2.0.0-alpha.2",
-    "@reventlessdev/rescript-pulumi-pulumi": "2.3.0-alpha.18",
-    "@reventlessdev/rescript-uuid": "2.0.0-alpha.0",
-    "@reventlessdev/reventless-core": "3.0.0-alpha.214",
+    "@reventlessdev/rescript-pulumi-aws": "2.4.0-alpha.66",
+    "@reventlessdev/rescript-effect": "0.1.0-alpha.32",
+    "@reventlessdev/reventless-core": "3.0.0-alpha.216",
     "@reventlessdev/reventless-interop": "3.0.0-alpha.30",
-    "@reventlessdev/reventless-postgres": "3.0.0-alpha.78",
-    "@reventlessdev/reventless-spec": "3.0.0-alpha.101",
-    "@reventlessdev/reventless-infra": "3.0.0-alpha.127"
+    "@reventlessdev/rescript-uuid": "2.0.0-alpha.0",
+    "@reventlessdev/reventless-postgres": "3.0.0-alpha.80",
+    "@reventlessdev/reventless-infra": "3.0.0-alpha.128",
+    "@reventlessdev/rescript-pulumi-pulumi": "2.3.0-alpha.18",
+    "@reventlessdev/reventless-spec": "3.0.0-alpha.102"
   },
   "devDependencies": {
     "rescript": "12.3.0",

package/src/adapter/Api/Platform_ComponentDefinitions_Lambda.res

@@ -123,6 +123,7 @@ let make = (
   let {code, sourceCodeHash} = Util_Bundle.buildCodeArchive(
     ~entryPointModule="@reventlessdev/reventless-aws/src/adapter/Api/Platform_ComponentDefinitions_Lambda_Ops.res.mjs",
     ~packageDirs,
+    ~bundleRuntimeExtensions=false,
   )
 
   let layers =

package/src/adapter/Api/Platform_ComponentDefinitions_Lambda.res.mjs

@@ -75,7 +75,7 @@ function make(api, pluginReadModelTableName, offloadBucketName, schemaReady, opt
       "@reventlessdev/reventless-aws",
       Util_Bundle$ReventlessAws.resolvePackageRoot(undefined, "@reventlessdev/reventless-aws")
     ]]);
-  let match = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Api/Platform_ComponentDefinitions_Lambda_Ops.res.mjs", packageDirs, undefined);
+  let match = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Api/Platform_ComponentDefinitions_Lambda_Ops.res.mjs", packageDirs, undefined, false);
   let layers = Stdlib_Option.getOr(Stdlib_Option.map(Lambda$PulumiAws.reventlessLayerArn, arn => [arn]), []);
   let lambda = new (Aws.lambda.Function)(name + "Lambda", {
     handler: "index.handler",

package/src/adapter/Api/Platform_UIFragments_Lambda.res

@@ -84,6 +84,7 @@ let make = (
   let {code, sourceCodeHash} = Util_Bundle.buildCodeArchive(
     ~entryPointModule="@reventlessdev/reventless-aws/src/adapter/Api/Platform_UIFragments_Lambda_Ops.res.mjs",
     ~packageDirs,
+    ~bundleRuntimeExtensions=false,
   )
 
   let layers =

package/src/adapter/Api/Platform_UIFragments_Lambda.res.mjs

@@ -52,7 +52,7 @@ function make(api, uiFragmentRegistryTableName, schemaReady, opts) {
       "@reventlessdev/reventless-aws",
       Util_Bundle$ReventlessAws.resolvePackageRoot(undefined, "@reventlessdev/reventless-aws")
     ]]);
-  let match = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Api/Platform_UIFragments_Lambda_Ops.res.mjs", packageDirs, undefined);
+  let match = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Api/Platform_UIFragments_Lambda_Ops.res.mjs", packageDirs, undefined, false);
   let layers = Stdlib_Option.getOr(Stdlib_Option.map(Lambda$PulumiAws.reventlessLayerArn, arn => [arn]), []);
   let lambda = new (Aws.lambda.Function)(name + "Lambda", {
     handler: "index.handler",

package/src/adapter/Counter/CounterHandler_DynamoDbStream.res.mjs

@@ -34,7 +34,7 @@ function make(name, referencesName, referencesDb, countsName, countsDb, param, s
   let mappingsPkg = Util_Bundle$ReventlessAws.extractPackageName(mappingsModulePath);
   packageDirs[specPkg] = Util_Bundle$ReventlessAws.resolvePackageRoot(undefined, specPkg);
   packageDirs[mappingsPkg] = Util_Bundle$ReventlessAws.resolvePackageRoot(undefined, mappingsPkg);
-  let match = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/CounterEntryPoint.mjs", packageDirs, undefined);
+  let match = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/CounterEntryPoint.mjs", packageDirs, undefined, undefined);
   let componentOpts_parent = opts.parent;
   let componentOpts = {
     parent: componentOpts_parent

package/src/adapter/EventLogSubscription/EventLogSubscription_AppSync.res

@@ -170,6 +170,7 @@ let make = (
   let {code, sourceCodeHash} = Util_Bundle.buildCodeArchive(
     ~entryPointModule="@reventlessdev/reventless-aws/src/adapter/EventLogSubscription/EventLogSubscription_AppSync_Ops.res.mjs",
     ~packageDirs,
+    ~bundleRuntimeExtensions=false,
   )
 
   let layers =

package/src/adapter/EventLogSubscription/EventLogSubscription_AppSync.res.mjs

@@ -89,7 +89,7 @@ function make(name, topicName, eventTopicOutputs, eventsApi, opts) {
       "@reventlessdev/reventless-aws",
       Util_Bundle$ReventlessAws.resolvePackageRoot(undefined, "@reventlessdev/reventless-aws")
     ]]);
-  let match = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/EventLogSubscription/EventLogSubscription_AppSync_Ops.res.mjs", packageDirs, undefined);
+  let match = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/EventLogSubscription/EventLogSubscription_AppSync_Ops.res.mjs", packageDirs, undefined, false);
   let layers = Stdlib_Option.getOr(Stdlib_Option.map(Lambda$PulumiAws.reventlessLayerArn, arn => [arn]), []);
   let appsyncEndpoint = AppSync_EventsApi$ReventlessAws.httpEndpoint(eventsApi);
   let lambda = new (Aws.lambda.Function)(name + "EventLogSubscriber", {

package/src/adapter/Geocoder/Geocoder_AwsLocation_Resolver.res

@@ -109,6 +109,7 @@ let make = (
   let {code, sourceCodeHash} = Util_Bundle.buildCodeArchive(
     ~entryPointModule="@reventlessdev/reventless-aws/src/adapter/Geocoder/Geocoder_AwsLocation_Resolver_Ops.res.mjs",
     ~packageDirs,
+    ~bundleRuntimeExtensions=false,
   )
 
   let layers =

package/src/adapter/Geocoder/Geocoder_AwsLocation_Resolver.res.mjs

@@ -56,7 +56,7 @@ function make(api, placeIndexName, nameOpt, opts) {
       "@reventlessdev/reventless-aws",
       Util_Bundle$ReventlessAws.resolvePackageRoot(undefined, "@reventlessdev/reventless-aws")
     ]]);
-  let match = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Geocoder/Geocoder_AwsLocation_Resolver_Ops.res.mjs", packageDirs, undefined);
+  let match = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Geocoder/Geocoder_AwsLocation_Resolver_Ops.res.mjs", packageDirs, undefined, false);
   let layers = Stdlib_Option.getOr(Stdlib_Option.map(Lambda$PulumiAws.reventlessLayerArn, arn => [arn]), []);
   let lambda = new (Aws.lambda.Function)(name + "Lambda", {
     handler: "index.handler",

package/src/adapter/Postgres/PgChangeFeedRelay_Builder.res.mjs

@@ -23,7 +23,7 @@ import * as RuntimeEnvironment_Lambda$ReventlessAws from "../Runtime/RuntimeEnvi
 function make(name, logs, securityGroupId, subnetIds, intervalMinutesOpt, opts) {
   let intervalMinutes = intervalMinutesOpt !== undefined ? intervalMinutesOpt : 1;
   let customOpts = Stdlib_Option.map(opts, Util_Pulumi$ReventlessCore.ComponentResourceOptions.toCustomResourceOptions);
-  let match = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/PgChangeFeedRelayEntryPoint.res.mjs", {}, undefined);
+  let match = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/PgChangeFeedRelayEntryPoint.res.mjs", {}, undefined, undefined);
   let logJsonOutputs = logs.map(l => Pulumi.all([
     l.connectionConfig,
     l.targetQueueUrl

package/src/adapter/Postgres/PgMigration_Builder.res.mjs

@@ -11,7 +11,7 @@ import * as Util_Bundle$ReventlessAws from "../../util/Util_Bundle.res.mjs";
 import * as RuntimeEnvironment_Lambda$ReventlessAws from "../Runtime/RuntimeEnvironment_Lambda.res.mjs";
 
 function make(name, handlerConfig, secretArn, securityGroupId, subnetIds, opts) {
-  let match = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/PgMigrationEntryPoint.res.mjs", {}, undefined);
+  let match = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/PgMigrationEntryPoint.res.mjs", {}, undefined, undefined);
   let sourceCodeHash = match.sourceCodeHash;
   let envVars = Object.fromEntries([[
       "HANDLER_CONFIG",

package/src/adapter/QueryDb/PgQueryResolver_Builder.res.mjs

@@ -84,7 +84,7 @@ function provision(api, selection, opts) {
   let envVars = {};
   envVars["QUERY_RESOLVER_CONFIG"] = queryResolverConfig;
   envVars["Environment"] = Pulumi.getStack();
-  let match = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/PgQueryResolverEntryPoint.mjs", packageDirs, undefined);
+  let match = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/PgQueryResolverEntryPoint.mjs", packageDirs, undefined, undefined);
   let vpcConfig = selection.securityGroupId.apply(sgId => ({
     subnetIds: selection.subnetIds,
     securityGroupIds: [sgId]

package/src/adapter/Runtime/AggregateEntryPoint.mjs

@@ -12,6 +12,7 @@ import {
   extractMetaField,
   extractSentTimestamp,
   extractRetryCount,
+  runtimeExtensionsReady,
 } from "./HandlerFactoryHelpers.mjs";
 import { Make as eventLogOperationsMake } from "@reventlessdev/reventless-core/src/components/EventLog/EventLog_Operations.res.mjs";
 import { Make as aggregateCallbackMake } from "@reventlessdev/reventless-core/src/components/Aggregate/Aggregate_Callback.res.mjs";
@@ -256,6 +257,11 @@ export async function buildHandlersForConfig(config, opts = {}) {
 }
 
 async function buildAllHandlers() {
+  // Runtime extension seam: any registered out-of-tree extension gets its
+  // onColdStart before a single handler is built, which is what makes the
+  // framework's interception/publish hooks reachable here. No-op unless the
+  // deployment registered one.
+  await runtimeExtensionsReady;
   const configStr = process.env["HANDLER_CONFIG"] || '{"handlers":[]}';
   return buildHandlersForConfig(JSON.parse(configStr));
 }

package/src/adapter/Runtime/AggregateRuntime_Builder_Micro.res.mjs

@@ -173,7 +173,7 @@ function finish() {
       ]).apply(param => `{"handlers":[{"specModule":` + specModule + `,"behaviorModule":` + behaviorModule + `,"eventLogTable":"` + param[0] + `","queueUrl":"` + param[1] + `","queueArn":"` + param[2] + `"` + pluginFragment + `}]}`);
       let cmdTopicEnvVars = {};
       cmdTopicEnvVars["HANDLER_CONFIG"] = cmdTopicHandlerConfigOutput;
-      let match = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/AggregateEntryPoint.mjs", packageDirs, undefined);
+      let match = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/AggregateEntryPoint.mjs", packageDirs, undefined, undefined);
       let cmdTopicName = baseName + "CmdHandler";
       let cmdTopicRuntime = RuntimeEnvironment_Lambda$ReventlessAws.makeFromCodeAsset(cmdTopicName, "CommandHandler", "Aggregate", match.code, match.sourceCodeHash, cmdTopicEnvVars, Math.max(spec.commandTopicMemorySize, 1024), Math.max(spec.commandTopicTimeout, 30), undefined, undefined, undefined, undefined, undefined, aggregateOpts);
       spec.commandTopicConnects.forEach(connect => connect(cmdTopicRuntime));
@@ -186,7 +186,7 @@ function finish() {
         ]).apply(param => `{"handlers":[{"specModule":` + specModule + `,"behaviorModule":` + behaviorModule + `,"eventLogTable":"` + param[0] + `","queueUrl":"` + param[1] + `","queueArn":"` + param[2] + `"` + pluginFragment$1 + `}]}`);
         let cmdGenEnvVars = {};
         cmdGenEnvVars["HANDLER_CONFIG"] = cmdGenHandlerConfigOutput;
-        let match$1 = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/AggregateEntryPoint.mjs", packageDirs, undefined);
+        let match$1 = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/AggregateEntryPoint.mjs", packageDirs, undefined, undefined);
         let cmdGenName = baseName + "CmdGen";
         let cmdGenRuntime = RuntimeEnvironment_Lambda$ReventlessAws.makeFromCodeAsset(cmdGenName, "CommandHandler", "Aggregate", match$1.code, match$1.sourceCodeHash, cmdGenEnvVars, Math.max(spec.commandGeneratorMemorySize, 1024), Math.max(spec.commandGeneratorTimeout, 30), undefined, undefined, undefined, undefined, undefined, aggregateOpts);
         spec.commandGeneratorConnects.forEach(connect => connect(cmdGenRuntime));
@@ -209,7 +209,7 @@ function finish() {
       let mappingsPkg = Util_Bundle$ReventlessAws.extractPackageName(match$3);
       evtMapperPackageDirs[specPkg$1] = Util_Bundle$ReventlessAws.resolvePackageRoot(undefined, specPkg$1);
       evtMapperPackageDirs[mappingsPkg] = Util_Bundle$ReventlessAws.resolvePackageRoot(undefined, mappingsPkg);
-      let match$4 = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/EventMapperEntryPoint.mjs", evtMapperPackageDirs, undefined);
+      let match$4 = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/EventMapperEntryPoint.mjs", evtMapperPackageDirs, undefined, undefined);
       let evtMapperName = baseName + "EventMapper";
       let evtMapperRuntime = RuntimeEnvironment_Lambda$ReventlessAws.makeFromCodeAsset(evtMapperName, "CommandHandler", "Aggregate", match$4.code, match$4.sourceCodeHash, evtMapperEnvVars, Math.max(spec.eventCollectorMemorySize, 2048), Math.max(spec.eventCollectorTimeout, 180), undefined, undefined, undefined, undefined, undefined, aggregateOpts);
       EventCollectorChannel_DynamoDbStream$ReventlessAws.connect(evtMapperName, [match$2], evtMapperRuntime, aggregateOpts);

package/src/adapter/Runtime/AggregateRuntime_Builder_Micro_Async.res.mjs

@@ -173,7 +173,7 @@ function finish() {
       ]).apply(param => `{"handlers":[{"specModule":` + specModule + `,"behaviorModule":` + behaviorModule + `,"eventLogTable":"` + param[0] + `","queueUrl":"` + param[1] + `","queueArn":"` + param[2] + `"` + pluginFragment + `}]}`);
       let cmdTopicEnvVars = {};
       cmdTopicEnvVars["HANDLER_CONFIG"] = cmdTopicHandlerConfigOutput;
-      let match = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/AggregateEntryPoint.mjs", packageDirs, undefined);
+      let match = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/AggregateEntryPoint.mjs", packageDirs, undefined, undefined);
       let cmdTopicName = baseName + "CmdHandler";
       let cmdTopicRuntime = RuntimeEnvironment_Lambda$ReventlessAws.makeFromCodeAsset(cmdTopicName, "CommandHandler", "Aggregate", match.code, match.sourceCodeHash, cmdTopicEnvVars, Math.max(spec.commandTopicMemorySize, 1024), Math.max(spec.commandTopicTimeout, 30), undefined, undefined, undefined, undefined, undefined, aggregateOpts);
       spec.commandTopicConnects.forEach(connect => connect(cmdTopicRuntime));
@@ -187,7 +187,7 @@ function finish() {
         let cmdGenEnvVars = {};
         cmdGenEnvVars["HANDLER_CONFIG"] = cmdGenHandlerConfigOutput;
         cmdGenEnvVars["DISPATCH_MODE"] = "async";
-        let match$1 = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/AggregateEntryPoint.mjs", packageDirs, undefined);
+        let match$1 = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/AggregateEntryPoint.mjs", packageDirs, undefined, undefined);
         let cmdGenName = baseName + "CmdGen";
         let cmdGenRuntime = RuntimeEnvironment_Lambda$ReventlessAws.makeFromCodeAsset(cmdGenName, "CommandHandler", "Aggregate", match$1.code, match$1.sourceCodeHash, cmdGenEnvVars, Math.max(spec.commandGeneratorMemorySize, 1024), Math.max(spec.commandGeneratorTimeout, 30), undefined, undefined, undefined, undefined, undefined, aggregateOpts);
         spec.commandGeneratorConnects.forEach(connect => connect(cmdGenRuntime));
@@ -210,7 +210,7 @@ function finish() {
       let mappingsPkg = Util_Bundle$ReventlessAws.extractPackageName(match$3);
       evtMapperPackageDirs[specPkg$1] = Util_Bundle$ReventlessAws.resolvePackageRoot(undefined, specPkg$1);
       evtMapperPackageDirs[mappingsPkg] = Util_Bundle$ReventlessAws.resolvePackageRoot(undefined, mappingsPkg);
-      let match$4 = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/EventMapperEntryPoint.mjs", evtMapperPackageDirs, undefined);
+      let match$4 = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/EventMapperEntryPoint.mjs", evtMapperPackageDirs, undefined, undefined);
       let evtMapperName = baseName + "EventMapper";
       let evtMapperRuntime = RuntimeEnvironment_Lambda$ReventlessAws.makeFromCodeAsset(evtMapperName, "CommandHandler", "Aggregate", match$4.code, match$4.sourceCodeHash, evtMapperEnvVars, Math.max(spec.eventCollectorMemorySize, 2048), Math.max(spec.eventCollectorTimeout, 180), undefined, undefined, undefined, undefined, undefined, aggregateOpts);
       EventCollectorChannel_DynamoDbStream$ReventlessAws.connect(evtMapperName, [match$2], evtMapperRuntime, aggregateOpts);

package/src/adapter/Runtime/AggregateRuntime_Builder_PerAggregate.res.mjs

@@ -153,7 +153,7 @@ function finish() {
       let behaviorPkg = Util_Bundle$ReventlessAws.extractPackageName(info.behaviorModulePath);
       packageDirs[specPkg] = Util_Bundle$ReventlessAws.resolvePackageRoot(undefined, specPkg);
       packageDirs[behaviorPkg] = Util_Bundle$ReventlessAws.resolvePackageRoot(undefined, behaviorPkg);
-      let match = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/AggregateEntryPoint.mjs", packageDirs, undefined);
+      let match = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/AggregateEntryPoint.mjs", packageDirs, undefined, undefined);
       let runtime = RuntimeEnvironment_Lambda$ReventlessAws.makeFromCodeAsset(lambdaName, "CommandHandler", "Aggregate", match.code, match.sourceCodeHash, envVars, spec.memorySize, spec.timeout, undefined, undefined, undefined, undefined, undefined, aggregateOpts);
       spec.connects.forEach(connect => connect(runtime));
       let channelSpecs = Stdlib_Option.mapOr(spec.eventCollectorChannelSpec, [], cs => [cs]);

package/src/adapter/Runtime/AggregateRuntime_Builder_PerAggregate_Async.res.mjs

@@ -153,7 +153,7 @@ function finish() {
       let behaviorPkg = Util_Bundle$ReventlessAws.extractPackageName(info.behaviorModulePath);
       packageDirs[specPkg] = Util_Bundle$ReventlessAws.resolvePackageRoot(undefined, specPkg);
       packageDirs[behaviorPkg] = Util_Bundle$ReventlessAws.resolvePackageRoot(undefined, behaviorPkg);
-      let match = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/AggregateEntryPoint.mjs", packageDirs, undefined);
+      let match = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/AggregateEntryPoint.mjs", packageDirs, undefined, undefined);
       let runtime = RuntimeEnvironment_Lambda$ReventlessAws.makeFromCodeAsset(name, "CommandHandler", "Aggregate", match.code, match.sourceCodeHash, envVars, spec.memorySize, spec.timeout, undefined, undefined, undefined, undefined, undefined, aggregateOpts);
       spec.connects.forEach(connect => connect(runtime));
       let channelSpecs = Stdlib_Option.mapOr(spec.eventCollectorChannelSpec, [], cs => [cs]);

package/src/adapter/Runtime/AggregateRuntime_Builder_Single.res.mjs

@@ -200,7 +200,7 @@ function finish() {
       Stdlib_Option.forEach(cfg.logLevel, level => {
         envVars["LOG_LEVEL"] = Pulumi.output(level);
       });
-      let match = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/AggregateEntryPoint.mjs", packageDirs, undefined);
+      let match = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/AggregateEntryPoint.mjs", packageDirs, undefined, undefined);
       Stdlib_Option.forEach(cfg.sqsBatchSize, CommandTopicChannel_SQS_Sync$ReventlessAws.setBatchSize);
       let vpcConfig = pgSelection !== undefined ? pgSelection.securityGroupId.apply(sgId => ({
           subnetIds: pgSelection.subnetIds,

package/src/adapter/Runtime/AggregateRuntime_Builder_Single_Async.res.mjs

@@ -189,7 +189,7 @@ function finish() {
       Stdlib_Option.forEach(cfg.logLevel, level => {
         envVars["LOG_LEVEL"] = Pulumi.output(level);
       });
-      let match = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/AggregateEntryPoint.mjs", packageDirs, undefined);
+      let match = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/AggregateEntryPoint.mjs", packageDirs, undefined, undefined);
       Stdlib_Option.forEach(cfg.sqsBatchSize, CommandTopicChannel_SQS_Async$ReventlessAws.setBatchSize);
       let vpcConfig = pgSelection !== undefined ? pgSelection.securityGroupId.apply(sgId => ({
           subnetIds: pgSelection.subnetIds,

package/src/adapter/Runtime/AutomationSliceEntryPoint.mjs

@@ -17,10 +17,16 @@ import { Make as automationSliceCallbackMake } from "@reventlessdev/reventless-c
 import { Make as outboundTranslationSliceCallbackMake } from "@reventlessdev/reventless-core/src/components/OutboundTranslationSlice/OutboundTranslationSlice_Callback.res.mjs";
 import * as StreamOps from "./StreamRoutedEntryPoint_Ops.res.mjs";
 import * as Ops from "./AutomationSliceEntryPoint_Ops.res.mjs";
+import { runtimeExtensionsReady } from "./HandlerFactoryHelpers.mjs";
 
 const dynamicImport = (specifier) => import('/var/task/node_modules/' + specifier);
 
 async function buildAllHandlers() {
+  // Runtime extension seam: any registered out-of-tree extension gets its
+  // onColdStart before a single handler is built, which is what makes the
+  // framework's interception/publish hooks reachable here. No-op unless the
+  // deployment registered one.
+  await runtimeExtensionsReady;
   const handlers = {};
   const sweeps = [];
   const entries = Ops.parseHandlerConfig(process.env["HANDLER_CONFIG"] || "");

package/src/adapter/Runtime/AutomationSliceRuntime_Builder_Single.res.mjs

@@ -206,7 +206,7 @@ function finish() {
       PluginRuntime_Builder$ReventlessAws.capabilityEnv().forEach(param => {
         envVars[param[0]] = param[1];
       });
-      let match$1 = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/AutomationSliceEntryPoint.mjs", packageDirs, undefined);
+      let match$1 = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/AutomationSliceEntryPoint.mjs", packageDirs, undefined, undefined);
       let runtime = RuntimeEnvironment_Lambda$ReventlessAws.makeFromCodeAsset("AllAutomationSlices", "Reactor", "AutomationSlice", match$1.code, match$1.sourceCodeHash, envVars, match[0], match[1], undefined, undefined, undefined, undefined, undefined, opts);
       let channelSpecs = storedSpecs.map(param => param.channelSpec);
       EventCollectorChannel_DynamoDbStream$ReventlessAws.connect("AllAutomationSlices", channelSpecs, runtime, opts);
@@ -318,7 +318,7 @@ function finishWithDcbEventLog(dcbEventLog) {
       PluginRuntime_Builder$ReventlessAws.capabilityEnv().forEach(param => {
         envVars[param[0]] = param[1];
       });
-      let match = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/AutomationSliceEntryPoint.mjs", packageDirs, undefined);
+      let match = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/AutomationSliceEntryPoint.mjs", packageDirs, undefined, undefined);
       let runtime = RuntimeEnvironment_Lambda$ReventlessAws.makeFromCodeAsset("AllAutomationSlices", "Reactor", "AutomationSlice", match.code, match.sourceCodeHash, envVars, 1024, 30, undefined, undefined, undefined, undefined, undefined, opts);
       EventCollectorChannel_DynamoDbStream$ReventlessAws.connect("AllAutomationSlices", [{
           channel: channel,

package/src/adapter/Runtime/CounterEntryPoint.mjs

@@ -12,13 +12,18 @@
 // references/counts stream routing live type-checked in
 // CounterEntryPoint_Ops.res.
 
-import { patchSpecId } from "./HandlerFactoryHelpers.mjs";
+import { patchSpecId, runtimeExtensionsReady } from "./HandlerFactoryHelpers.mjs";
 import { MakeCounterHandler } from "@reventlessdev/reventless-core/src/components/EventMapper/EventMapper_Callback.res.mjs";
 import * as Ops from "./CounterEntryPoint_Ops.res.mjs";
 
 const dynamicImport = (specifier) => import('/var/task/node_modules/' + specifier);
 
 async function build() {
+  // Runtime extension seam: any registered out-of-tree extension gets its
+  // onColdStart before a single handler is built, which is what makes the
+  // framework's interception/publish hooks reachable here. No-op unless the
+  // deployment registered one.
+  await runtimeExtensionsReady;
   const config = Ops.parseHandlerConfig(process.env["HANDLER_CONFIG"] || "{}");
 
   const targetSpecModule = await dynamicImport(config.targetSpecModule);

package/src/adapter/Runtime/DcbCommandTopicEntryPoint.mjs

@@ -15,6 +15,7 @@ import {
   extractMetaField,
   extractSentTimestamp,
   extractRetryCount,
+  runtimeExtensionsReady,
 } from "./HandlerFactoryHelpers.mjs";
 import { Make as dcbEventLogOperationsMake } from "@reventlessdev/reventless-core/src/components/DcbEventLog/DcbEventLog_Operations.res.mjs";
 import { makeCommandGenerator } from "./CommandGeneratorEntryPoint_Ops.res.mjs";
@@ -233,6 +234,11 @@ export async function buildHandlersForConfig(config, opts = {}) {
 }
 
 async function buildHandler() {
+  // Runtime extension seam: any registered out-of-tree extension gets its
+  // onColdStart before a single handler is built, which is what makes the
+  // framework's interception/publish hooks reachable here. No-op unless the
+  // deployment registered one.
+  await runtimeExtensionsReady;
   const configStr = process.env["HANDLER_CONFIG"];
   // Importing this module without HANDLER_CONFIG (e.g. from a test that drives
   // `buildHandlersForConfig` directly) must not crash module evaluation.

package/src/adapter/Runtime/EventCollectorEntryPoint.mjs

@@ -66,7 +66,7 @@
 
 import { createRequire } from "node:module";
 import { pathToFileURL } from "node:url";
-import { patchSpecId } from "./HandlerFactoryHelpers.mjs";
+import { patchSpecId, runtimeExtensionsReady } from "./HandlerFactoryHelpers.mjs";
 import { Make as extensionPointOperationsMake } from "@reventlessdev/reventless-core/src/components/ExtensionPoint/ExtensionPoint_Operations.res.mjs";
 import { Make as extensionOperationsMake } from "@reventlessdev/reventless-core/src/components/Extension/Extension_Operations.res.mjs";
 import { Make as extensionMappingMake } from "@reventlessdev/reventless-infra/src/types/ExtensionMapping.res.mjs";
@@ -93,6 +93,11 @@ const importFromAsset = (() => {
 })();
 
 async function buildHandler() {
+  // Runtime extension seam: any registered out-of-tree extension gets its
+  // onColdStart before a single handler is built, which is what makes the
+  // framework's interception/publish hooks reachable here. No-op unless the
+  // deployment registered one.
+  await runtimeExtensionsReady;
   const config = Ops.parseHandlerConfig(process.env["HANDLER_CONFIG"] || "");
   const pluginDefinition = Ops.loadPluginDefinition();
 

package/src/adapter/Runtime/EventCollectorRuntime_Builder_PerEventCollector.res.mjs

@@ -62,7 +62,7 @@ function forEventCollector(param, eventTopics, resources, memorySizeOpt, timeout
   let mappingsPkg = Util_Bundle$ReventlessAws.extractPackageName(info.mappingsModulePath);
   packageDirs[specPkg] = Util_Bundle$ReventlessAws.resolvePackageRoot(undefined, specPkg);
   packageDirs[mappingsPkg] = Util_Bundle$ReventlessAws.resolvePackageRoot(undefined, mappingsPkg);
-  let match = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/ReadModelEntryPoint.mjs", packageDirs, undefined);
+  let match = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/ReadModelEntryPoint.mjs", packageDirs, undefined, undefined);
   let runtime = RuntimeEnvironment_Lambda$ReventlessAws.makeFromCodeAsset(name, "EventCollector", "EventCollector", match.code, match.sourceCodeHash, envVars, memorySize, timeout, undefined, undefined, undefined, undefined, undefined, opts);
   EventCollectorChannel_DynamoDbStream$ReventlessAws.connect(name, [{
       channel: channel,

package/src/adapter/Runtime/EventCollectorRuntime_Builder_Single.res.mjs

@@ -156,7 +156,7 @@ function finish() {
       if (pgStreamConfig !== undefined) {
         envVars["APPSYNC_ENDPOINT"] = pgStreamConfig.endpoint;
       }
-      let match$1 = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/ReadModelEntryPoint.mjs", packageDirs, undefined);
+      let match$1 = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/ReadModelEntryPoint.mjs", packageDirs, undefined, undefined);
       let vpcConfig = qdbSelection !== undefined && anyPgBacked ? qdbSelection.securityGroupId.apply(sgId => ({
           subnetIds: qdbSelection.subnetIds,
           securityGroupIds: [sgId]

package/src/adapter/Runtime/EventMapperEntryPoint.mjs

@@ -13,7 +13,7 @@
 // EventMapperEntryPoint_Ops.res.
 
 import { $$String as IdString } from "@reventlessdev/reventless-spec/src/types/Id.res.mjs";
-import { patchSpecId } from "./HandlerFactoryHelpers.mjs";
+import { patchSpecId, runtimeExtensionsReady } from "./HandlerFactoryHelpers.mjs";
 import { MakeCounterHandler } from "@reventlessdev/reventless-core/src/components/EventMapper/EventMapper_Callback.res.mjs";
 import * as Ops from "./EventMapperEntryPoint_Ops.res.mjs";
 
@@ -34,6 +34,11 @@ function patchMappingsSourceIds(mappingsModule) {
 }
 
 async function build() {
+  // Runtime extension seam: any registered out-of-tree extension gets its
+  // onColdStart before a single handler is built, which is what makes the
+  // framework's interception/publish hooks reachable here. No-op unless the
+  // deployment registered one.
+  await runtimeExtensionsReady;
   const config = Ops.parseHandlerConfig(process.env["HANDLER_CONFIG"] || "{}");
 
   const targetSpecModule = await dynamicImport(config.targetSpecModule);

package/src/adapter/Runtime/ExtensionPointEntryPoint.mjs

@@ -11,7 +11,7 @@
 // HANDLER_CONFIG parsing, and the SQS dispatch boundary live type-checked in
 // ExtensionPointEntryPoint_Ops.res.
 
-import { patchSpecId } from "./HandlerFactoryHelpers.mjs";
+import { patchSpecId, runtimeExtensionsReady } from "./HandlerFactoryHelpers.mjs";
 import { Make as extensionPointCallbackMake } from "@reventlessdev/reventless-core/src/components/ExtensionPoint/ExtensionPoint_Callback.res.mjs";
 import { Make as commandTopicCallbackMake } from "@reventlessdev/reventless-core/src/components/CommandTopic/CommandTopic_Callback.res.mjs";
 import * as Ops from "./ExtensionPointEntryPoint_Ops.res.mjs";
@@ -19,6 +19,11 @@ import * as Ops from "./ExtensionPointEntryPoint_Ops.res.mjs";
 const dynamicImport = (specifier) => import('/var/task/node_modules/' + specifier);
 
 async function build() {
+  // Runtime extension seam: any registered out-of-tree extension gets its
+  // onColdStart before a single handler is built, which is what makes the
+  // framework's interception/publish hooks reachable here. No-op unless the
+  // deployment registered one.
+  await runtimeExtensionsReady;
   const config = Ops.parseHandlerConfig(process.env["HANDLER_CONFIG"] || "{}");
 
   const specModule = await dynamicImport(config.specModule);

package/src/adapter/Runtime/ExtensionPointRuntime_Builder_PerExtensionPoint.res.mjs

@@ -38,7 +38,7 @@ function forCommandTopic(param, connect, memorySizeOpt, timeoutOpt, specModuleUr
   let mappingsPkg = Util_Bundle$ReventlessAws.extractPackageName(mappingsModulePath);
   packageDirs[specPkg] = Util_Bundle$ReventlessAws.resolvePackageRoot(undefined, specPkg);
   packageDirs[mappingsPkg] = Util_Bundle$ReventlessAws.resolvePackageRoot(undefined, mappingsPkg);
-  let match = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/ExtensionPointEntryPoint.mjs", packageDirs, undefined);
+  let match = Util_Bundle$ReventlessAws.buildCodeArchive("@reventlessdev/reventless-aws/src/adapter/Runtime/ExtensionPointEntryPoint.mjs", packageDirs, undefined, undefined);
   return connect(RuntimeEnvironment_Lambda$ReventlessAws.makeFromCodeAsset(name, "CommandHandler", "ExtensionPoint", match.code, match.sourceCodeHash, envVars, memorySize, timeout, undefined, undefined, undefined, undefined, undefined, opts));
 }
 

package/src/adapter/Runtime/HandlerFactoryHelpers.mjs

@@ -8,6 +8,11 @@ import {
 } from "@reventlessdev/reventless-core/src/RequestContext.res.mjs";
 import { DynamoDBClient } from "@aws-sdk/client-dynamodb";
 import { DynamoDBDocumentClient, ScanCommand } from "@aws-sdk/lib-dynamodb";
+import {
+  parseConfig as parseRuntimeExtensionConfig,
+  fire as fireRuntimeExtensions,
+  reportLoadFailure as reportRuntimeExtensionLoadFailure,
+} from "./RuntimeExtensionEntryPoint_Ops.res.mjs";
 
 // ─── Structured logging from the .mjs entry-point shims ─────────────────────
 // Mirrors ReScript's Logger.t API and Logger.emit's JSON sink shape (time,
@@ -192,6 +197,48 @@ export function extractRetryCount(records) {
   return Number.isFinite(count) && count > 0 ? count : 1;
 }
 
+// ─── Runtime extension cold start ───────────────────────────────────────────
+// Extension packages are bundled into the code archive next to the spec and
+// behavior packages, so they resolve from /var/task/node_modules by the same
+// absolute path every shell uses for user modules.
+const dynamicImport = (specifier) => import("/var/task/node_modules/" + specifier);
+
+// The framework ships four runtime callback hooks (command interception, query
+// interception, before/after publish) whose registrars are module-level refs.
+// They are only reachable if something calls them in this process before the
+// first request, and the entry shells import framework and domain modules only —
+// so an out-of-tree extension had no way in. RUNTIME_EXTENSIONS closes that: it
+// names the extension modules the archive carries (see
+// ReventlessCore.RuntimeExtension and Util_Bundle.addRuntimeExtensionPackages),
+// and each one's `onColdStart` runs here, once, before any handler is built.
+//
+// This is the seam's one untyped step: the modules are named at deploy time and
+// their types are unknowable here. Parsing and invocation live in the typed
+// RuntimeExtensionEntryPoint_Ops.res, so the call's arity is compiler-checked.
+//
+// Started at module load and exported as a promise every entry shell awaits in
+// its own cold-start init — that is what makes "before the first request" a fact
+// rather than a hope, and it holds for the shells that build handlers lazily.
+// Absent env var ⇒ resolves immediately, having done nothing.
+export const runtimeExtensionsReady = (async () => {
+  const config = parseRuntimeExtensionConfig(process.env["RUNTIME_EXTENSIONS"]);
+  if (config === undefined) return;
+  const hooks = [];
+  for (const specifier of config.modules) {
+    try {
+      const mod = await dynamicImport(specifier);
+      if (typeof mod.onColdStart === "function") {
+        hooks.push(mod.onColdStart);
+      } else {
+        reportRuntimeExtensionLoadFailure(specifier, "module exports no onColdStart function");
+      }
+    } catch (err) {
+      reportRuntimeExtensionLoadFailure(specifier, err?.message ?? String(err));
+    }
+  }
+  fireRuntimeExtensions(config, hooks);
+})();
+
 // Patch a spec module's Id field to use IdString if undefined.
 // Workaround for `module Id = Id.String` not producing an ESM export.
 export const patchSpecId = (specModule) => ({ ...specModule, Id: specModule.Id || IdString });

package/src/adapter/Runtime/HeartbeatEntryPoint.res

@@ -26,7 +26,16 @@ let publishJsons = queue->CommandTopicChannel_SQS_Runtime.publishJsons(AWS.SQS_F
 
 // === Exported handler ===
 
+// Runtime extension seam: HandlerFactoryHelpers loads and fires any registered
+// out-of-tree extension once, at module load. Awaiting its promise before this
+// handler does any work is what makes "before the first request" a fact rather
+// than a hope; it is already resolved on every invocation after the first, and
+// resolves immediately when nothing is registered.
+@module("./HandlerFactoryHelpers.mjs")
+external runtimeExtensionsReady: promise<unit> = "runtimeExtensionsReady"
+
 let handler = async (_event: JSON.t, _context: PulumiAws.Lambda.context) => {
+  await runtimeExtensionsReady
   let message: ReventlessCore.Message.commandJson = {
     id: pluginId,
     meta: ReventlessCore.Message.generateMeta(

package/src/adapter/Runtime/HeartbeatEntryPoint.res.mjs

@@ -4,6 +4,7 @@ import * as S from "sury/src/S.res.mjs";
 import * as Stdlib_Int from "@rescript/runtime/lib/es6/Stdlib_Int.js";
 import * as Stdlib_Option from "@rescript/runtime/lib/es6/Stdlib_Option.js";
 import * as Message$ReventlessCore from "@reventlessdev/reventless-core/src/Message.res.mjs";
+import * as HandlerFactoryHelpersMjs from "./HandlerFactoryHelpers.mjs";
 import * as PluginExtensionPointSpec$ReventlessInfra from "@reventlessdev/reventless-infra/src/types/PluginExtensionPointSpec.res.mjs";
 import * as CommandTopicChannel_SQS_Runtime$ReventlessAws from "../CommandTopic/CommandTopicChannel_SQS_Runtime.res.mjs";
 
@@ -21,7 +22,10 @@ let queue = {
 
 let publishJsons = CommandTopicChannel_SQS_Runtime$ReventlessAws.publishJsons(queue, "SQS_FIFO");
 
+let runtimeExtensionsReady = HandlerFactoryHelpersMjs.runtimeExtensionsReady;
+
 async function handler(_event, _context) {
+  await runtimeExtensionsReady;
   let message_meta = Message$ReventlessCore.generateMeta(PluginExtensionPointSpec$ReventlessInfra.name, "", "Heartbeat", undefined, undefined, undefined, undefined, undefined);
   let message_commandJson = S.reverseConvertToJsonOrThrow({
     TAG: "Heartbeat",
@@ -42,6 +46,7 @@ export {
   timeout,
   queue,
   publishJsons,
+  runtimeExtensionsReady,
   handler,
 }
 /* epQueueUrl Not a pure module */

package/src/adapter/Runtime/PgChangeFeedRelayEntryPoint.res

@@ -86,7 +86,16 @@ let relayLog = async (l: relayLogConfig): unit => {
   }
 }
 
+// Runtime extension seam: HandlerFactoryHelpers loads and fires any registered
+// out-of-tree extension once, at module load. Awaiting its promise before this
+// handler does any work is what makes "before the first request" a fact rather
+// than a hope; it is already resolved on every invocation after the first, and
+// resolves immediately when nothing is registered.
+@module("./HandlerFactoryHelpers.mjs")
+external runtimeExtensionsReady: promise<unit> = "runtimeExtensionsReady"
+
 let handler = async (_event: JSON.t, _context: PulumiAws.Lambda.context) => {
+  await runtimeExtensionsReady
   let config =
     NodeProcess.env->Dict.get("HANDLER_CONFIG")->Option.getOr(`{"logs":[]}`)->parseHandlerConfig
   let logs = config.logs->Option.getOr([])