@reventlessdev/reventless-aws 3.0.0-alpha.266 → 3.0.0-alpha.267

package/CHANGELOG.md

@@ -3,6 +3,13 @@
 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.267 (2026-08-04)
+
+### Features
+
+* **admin:** serve the complete plugin structure to developer tooling ([e99cda0](https://github.com/ReventlessDev/reventless-core/commit/e99cda02a2f862b36bcfdb018a0fb34bb7426a2b))
+
+
 # 3.0.0-alpha.266 (2026-08-04)
 
 ### Features

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reventlessdev/reventless-aws",
-  "version": "3.0.0-alpha.266",
+  "version": "3.0.0-alpha.267",
   "description": "AWS adapters for Reventless",
   "license": "Apache-2.0",
   "dependencies": {
@@ -13,16 +13,16 @@
     "uuid": "^13.0.0",
     "@reventlessdev/rescript-aws-sdk": "3.0.0-alpha.3",
     "@reventlessdev/rescript-effect": "0.1.0-alpha.32",
-    "@reventlessdev/rescript-node": "2.0.0-alpha.1",
     "@reventlessdev/rescript-jest": "1.0.0-alpha.10",
     "@reventlessdev/rescript-pulumi-aws": "2.4.0-alpha.65",
+    "@reventlessdev/rescript-node": "2.0.0-alpha.1",
     "@reventlessdev/rescript-pulumi-pulumi": "2.3.0-alpha.18",
-    "@reventlessdev/rescript-uuid": "2.0.0-alpha.0",
-    "@reventlessdev/reventless-core": "3.0.0-alpha.211",
     "@reventlessdev/reventless-infra": "3.0.0-alpha.126",
-    "@reventlessdev/reventless-spec": "3.0.0-alpha.100",
+    "@reventlessdev/reventless-core": "3.0.0-alpha.212",
     "@reventlessdev/reventless-interop": "3.0.0-alpha.30",
-    "@reventlessdev/reventless-postgres": "3.0.0-alpha.75"
+    "@reventlessdev/reventless-postgres": "3.0.0-alpha.76",
+    "@reventlessdev/rescript-uuid": "2.0.0-alpha.0",
+    "@reventlessdev/reventless-spec": "3.0.0-alpha.100"
   },
   "devDependencies": {
     "rescript": "12.3.0",

package/src/Platform.res

@@ -1452,6 +1452,7 @@ module MakeWithConfig = (
         ~api=platformApi,
         ~pluginReadModelTableName=tableName,
         ~offloadBucketName,
+        ~schemaReady=admin.adminSchemaPushed,
         ~opts={},
       )
     | None => ()

package/src/Platform.res.mjs

@@ -861,7 +861,7 @@ function MakeWithConfig(Config) {
     Pulumi$Pulumi.$$export("offloadBucket", offloadBucketName);
     if (pluginReadModelTableName !== undefined) {
       AggregateRuntime_Builder_Single$ReventlessAws.setPluginReadModelTable(pluginReadModelTableName);
-      Platform_ComponentDefinitions_Lambda$ReventlessAws.make(platformApi, pluginReadModelTableName, offloadBucketName, {});
+      Platform_ComponentDefinitions_Lambda$ReventlessAws.make(platformApi, pluginReadModelTableName, offloadBucketName, admin.adminSchemaPushed, {});
     }
     let rm = admin.stateViewSlicesOutputs["UiFragments"];
     if (rm !== undefined) {
@@ -2096,7 +2096,7 @@ function Make($star) {
     Pulumi$Pulumi.$$export("offloadBucket", offloadBucketName);
     if (pluginReadModelTableName !== undefined) {
       AggregateRuntime_Builder_Single$ReventlessAws.setPluginReadModelTable(pluginReadModelTableName);
-      Platform_ComponentDefinitions_Lambda$ReventlessAws.make(platformApi, pluginReadModelTableName, offloadBucketName, {});
+      Platform_ComponentDefinitions_Lambda$ReventlessAws.make(platformApi, pluginReadModelTableName, offloadBucketName, admin.adminSchemaPushed, {});
     }
     let rm = admin.stateViewSlicesOutputs["UiFragments"];
     if (rm !== undefined) {

package/src/adapter/Api/Platform_ComponentDefinitions_Lambda.res

@@ -24,10 +24,29 @@ export function response(ctx) {
 }
 `->Pulumi.Input.make
 
+// `Platform_PluginStructures` — the same scan, unfiltered. The `complete` flag is
+// the whole difference; see the handler's `toEntryWith`.
+let completeResolverCode = `
+import { util } from '@aws-appsync/utils';
+export function request(ctx) {
+  return { operation: 'Invoke', payload: { complete: true } };
+}
+export function response(ctx) {
+  if (ctx.error) util.error(ctx.error.message, ctx.error.type);
+  return ctx.result;
+}
+`->Pulumi.Input.make
+
 let make = (
   ~api: Pulumi.Output.t<AppSync.GraphQLApi.t>,
   ~pluginReadModelTableName: Pulumi.Output.t<string>,
   ~offloadBucketName: Pulumi.Output.t<string>,
+  // Resolves once the admin schema push is ACTIVE (Platform_Admin.adminSchemaPushed).
+  // Only the `Platform_PluginStructures` resolver is gated on it: that field is new,
+  // so CreateResolver would otherwise race StartSchemaCreation on the deploy that
+  // first ships it. `Platform_ComponentDefinitions` predates the gate and is left
+  // ungated so this change adds no dependency edge to an already-deployed resource.
+  ~schemaReady: Pulumi.Output.t<unit>,
   ~opts: Pulumi.ComponentResource.options,
 ) => {
   let opts = opts->ReventlessCore.Util.Pulumi.ComponentResourceOptions.toCustomResourceOptions
@@ -215,4 +234,21 @@ let make = (
     ~code=resolverCode,
     ~opts,
   )
+
+  // Second field, same DataSource and same Lambda — the developer-tooling read of
+  // the identical scan. Sharing the data source is what keeps the two answers from
+  // drifting: there is one place that decides what a deployed plugin's structure is.
+  // Created only after the schema carrying `Platform_PluginStructures` is ACTIVE.
+  let _structuresResolver =
+    schemaReady->Pulumi.Output.apply(() =>
+      AppSync_Resolver_Native.makeUnitJsResolver(
+        ~name=name ++ "StructuresResolver",
+        ~api,
+        ~dataSourceName=dataSource.name->Pulumi.Output.asInput,
+        ~type_="Query"->Pulumi.Input.make,
+        ~field="Platform_PluginStructures"->Pulumi.Input.make,
+        ~code=completeResolverCode,
+        ~opts,
+      )
+    )
 }

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

@@ -27,7 +27,18 @@ export function response(ctx) {
 }
 `;
 
-function make(api, pluginReadModelTableName, offloadBucketName, opts) {
+let completeResolverCode = `
+import { util } from '@aws-appsync/utils';
+export function request(ctx) {
+  return { operation: 'Invoke', payload: { complete: true } };
+}
+export function response(ctx) {
+  if (ctx.error) util.error(ctx.error.message, ctx.error.type);
+  return ctx.result;
+}
+`;
+
+function make(api, pluginReadModelTableName, offloadBucketName, schemaReady, opts) {
   let opts$1 = Util_Pulumi$ReventlessCore.ComponentResourceOptions.toCustomResourceOptions(opts);
   let name = "PlatformUIDefinitions";
   let lambdaRole = IAM$PulumiAws.Role.makeWithDefaultPolicy(name + "Lambda", Pulumi.output(AWS$ReventlessAws.Lambda.principal), AWS_Tags$ReventlessAws.make(name + "Lambda", "Platform", "Identity", "Platform", undefined, undefined, undefined, undefined), opts$1);
@@ -131,10 +142,12 @@ function make(api, pluginReadModelTableName, offloadBucketName, opts) {
     serviceRoleArn: dataSourceRole.arn
   }, opts$1);
   AppSync_Resolver_Native$ReventlessAws.makeUnitJsResolver(name + "Resolver", api, dataSource.name, "Query", "Platform_ComponentDefinitions", resolverCode, opts$1);
+  schemaReady.apply(() => AppSync_Resolver_Native$ReventlessAws.makeUnitJsResolver(name + "StructuresResolver", api, dataSource.name, "Query", "Platform_PluginStructures", completeResolverCode, opts$1));
 }
 
 export {
   resolverCode,
+  completeResolverCode,
   make,
 }
 /* @pulumi/aws Not a pure module */

package/src/adapter/Api/Platform_ComponentDefinitions_Lambda_Ops.res

@@ -43,11 +43,21 @@ let filterStructure = (structure: JSON.t): option<dict<JSON.t>> =>
     Some(out)
   }
 
-// `{pluginId: name, ...filterStructure(structure)}` — pluginId first so the
-// structure's fields win on the (never-expected) key collision, matching the JS
-// spread. Drops a row with no decodable structure (former `!item.structure`).
-let toEntry = (item: dict<JSON.t>, ~name: string): option<JSON.t> =>
-  switch item->Dict.get("structure")->Option.flatMap(filterStructure) {
+// `{pluginId: name, ...structure}` — pluginId first so the structure's fields win
+// on the (never-expected) key collision, matching the JS spread. Drops a row with
+// no decodable structure (former `!item.structure`).
+//
+// `~filter` is what separates the two fields this handler serves: AutoUI
+// (`Platform_ComponentDefinitions`) gets the public-queryable subset, developer
+// tooling (`Platform_PluginStructures`) gets the structure exactly as persisted,
+// including Internal components and the producer-side `extensionPoints` that the
+// AutoUI entry type does not declare.
+let toEntryWith = (~filter: bool, item: dict<JSON.t>, ~name: string): option<JSON.t> => {
+  let structure =
+    item
+    ->Dict.get("structure")
+    ->Option.flatMap(s => filter ? filterStructure(s) : s->JSON.Decode.object)
+  switch structure {
   | None => None
   | Some(structureObj) =>
     let entry = Dict.make()
@@ -55,10 +65,17 @@ let toEntry = (item: dict<JSON.t>, ~name: string): option<JSON.t> =>
     structureObj->Dict.toArray->Array.forEach(((k, v)) => entry->Dict.set(k, v))
     Some(JSON.Encode.object(entry))
   }
+}
+
 
 // The built-in Platform_Admin entry, injected at deploy time as the
 // ADMIN_ENTRY_JSON env var (the admin never Connects to itself, so its structure
 // never enters the Plugin read model).
+//
+// Shared by both fields. The admin structure has no Internal components and no
+// extension points, so its filtered and complete encodings carry the same
+// components; the structure-level fields the complete entry adds are absent from
+// this JSON and resolve to null, which is what `extensionPoints: None` means.
 let adminEntry: option<JSON.t> =
   switch NodeProcess.env->Dict.get("ADMIN_ENTRY_JSON") {
   | Some(s) if s != "" => Some(JSON.parseOrThrow(s))
@@ -94,7 +111,21 @@ let resolveStructure = (
     }
   }
 
-let handler = async (_event: JSON.t): array<JSON.t> => {
+// One Lambda serves both fields — the scan, the offload resolution and the
+// latest-version-per-plugin collapse are identical work, and duplicating them into
+// a second function would mean a second cold start and a second chance for the two
+// to disagree about what "the deployed structure" is. The resolver for
+// `Platform_PluginStructures` invokes with `{complete: true}`.
+let isComplete = (event: JSON.t): bool =>
+  event
+  ->JSON.Decode.object
+  ->Option.flatMap(o => o->Dict.get("complete"))
+  ->Option.flatMap(JSON.Decode.bool)
+  ->Option.getOr(false)
+
+let handler = async (event: JSON.t): array<JSON.t> => {
+  let complete = isComplete(event)
+  let toEntry = (item, ~name) => toEntryWith(~filter=!complete, item, ~name)
   let admin = adminEntry->Option.mapOr([], e => [e])
   switch NodeProcess.env->Dict.get("PLUGIN_RM_TABLE") {
   | None | Some("") =>

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

@@ -31,14 +31,20 @@ function filterStructure(structure) {
   return out;
 }
 
-function toEntry(item, name) {
-  let structureObj = Stdlib_Option.flatMap(item["structure"], filterStructure);
-  if (structureObj === undefined) {
+function toEntryWith(filter, item, name) {
+  let structure = Stdlib_Option.flatMap(item["structure"], s => {
+    if (filter) {
+      return filterStructure(s);
+    } else {
+      return Stdlib_JSON.Decode.object(s);
+    }
+  });
+  if (structure === undefined) {
     return;
   }
   let entry = {};
   entry["pluginId"] = name;
-  Object.entries(structureObj).forEach(param => {
+  Object.entries(structure).forEach(param => {
     entry[param[0]] = param[1];
   });
   return entry;
@@ -65,7 +71,13 @@ function resolveStructure(fetch, item) {
   }
 }
 
-async function handler(_event) {
+function isComplete(event) {
+  return Stdlib_Option.getOr(Stdlib_Option.flatMap(Stdlib_Option.flatMap(Stdlib_JSON.Decode.object(event), o => o["complete"]), Stdlib_JSON.Decode.bool), false);
+}
+
+async function handler(event) {
+  let complete = isComplete(event);
+  let toEntry = (item, name) => toEntryWith(!complete, item, name);
   let admin = Stdlib_Option.mapOr(adminEntry, [], e => [e]);
   let table = process.env["PLUGIN_RM_TABLE"];
   if (table !== undefined) {
@@ -94,9 +106,10 @@ export {
   str,
   isPublicQueryable,
   filterStructure,
-  toEntry,
+  toEntryWith,
   adminEntry,
   resolveStructure,
+  isComplete,
   handler,
 }
 /* s Not a pure module */