@backstage/plugin-scaffolder-backend 1.12.0-next.2 → 1.12.0

package/dist/index.cjs.js

@@ -291,17 +291,31 @@ const examples$1 = [
         }
       ]
     })
+  },
+  {
+    description: "Fetch multiple entities by referencse",
+    example: yaml__default["default"].stringify({
+      steps: [
+        {
+          action: id$1,
+          id: "fetchMultiple",
+          name: "Fetch catalog entities",
+          input: {
+            entityRefs: ["component:default/name"]
+          }
+        }
+      ]
+    })
   }
 ];
 function createFetchCatalogEntityAction(options) {
   const { catalogClient } = options;
   return pluginScaffolderNode.createTemplateAction({
     id: id$1,
-    description: "Returns entity from the catalog by entity reference",
+    description: "Returns entity or entities from the catalog by entity reference(s)",
     examples: examples$1,
     schema: {
       input: {
-        required: ["entityRef"],
         type: "object",
         properties: {
           entityRef: {
@@ -309,9 +323,14 @@ function createFetchCatalogEntityAction(options) {
             title: "Entity reference",
             description: "Entity reference of the entity to get"
           },
+          entityRefs: {
+            type: "array",
+            title: "Entity references",
+            description: "Entity references of the entities to get"
+          },
           optional: {
             title: "Optional",
-            description: "Permit the entity to optionally exist. Default: false",
+            description: "Allow the entity or entities to optionally exist. Default: false",
             type: "boolean"
           }
         }
@@ -322,28 +341,50 @@ function createFetchCatalogEntityAction(options) {
           entity: {
             title: "Entity found by the entity reference",
             type: "object",
-            description: "Object containing same values used in the Entity schema."
+            description: "Object containing same values used in the Entity schema. Only when used with `entityRef` parameter."
+          },
+          entities: {
+            title: "Entities found by the entity references",
+            type: "array",
+            items: { type: "object" },
+            description: "Array containing objects with same values used in the Entity schema. Only when used with `entityRefs` parameter."
           }
         }
       }
     },
     async handler(ctx) {
-      var _a;
-      const { entityRef, optional } = ctx.input;
-      let entity;
-      try {
-        entity = await catalogClient.getEntityByRef(entityRef, {
+      var _a, _b;
+      const { entityRef, entityRefs, optional } = ctx.input;
+      if (!entityRef && !entityRefs) {
+        if (optional) {
+          return;
+        }
+        throw new Error("Missing entity reference or references");
+      }
+      if (entityRef) {
+        const entity = await catalogClient.getEntityByRef(entityRef, {
           token: (_a = ctx.secrets) == null ? void 0 : _a.backstageToken
         });
-      } catch (e) {
-        if (!optional) {
-          throw e;
+        if (!entity && !optional) {
+          throw new Error(`Entity ${entityRef} not found`);
         }
+        ctx.output("entity", entity != null ? entity : null);
       }
-      if (!entity && !optional) {
-        throw new Error(`Entity ${entityRef} not found`);
+      if (entityRefs) {
+        const entities = await catalogClient.getEntitiesByRefs(
+          { entityRefs },
+          {
+            token: (_b = ctx.secrets) == null ? void 0 : _b.backstageToken
+          }
+        );
+        const finalEntities = entities.items.map((e, i) => {
+          if (!e && !optional) {
+            throw new Error(`Entity ${entityRefs[i]} not found`);
+          }
+          return e != null ? e : null;
+        });
+        ctx.output("entities", finalEntities);
       }
-      ctx.output("entity", entity != null ? entity : null);
     }
   });
 }