@backstage/plugin-catalog-backend 3.2.1-next.0 → 3.3.0

package/CHANGELOG.md

@@ -1,5 +1,43 @@
 # @backstage/plugin-catalog-backend
 
+## 3.3.0
+
+### Minor Changes
+
+- dce1824: Added `ActionsRegistry` actions for `register-entity` and `unregister-entity`
+
+### Patch Changes
+
+- de96a60: chore(deps): bump `express` from 4.21.2 to 4.22.0
+- 8101ec1: Fixed default refresh service to go through the whole ancestry of the entity.
+- Updated dependencies
+  - @backstage/integration@1.19.0
+  - @backstage/backend-openapi-utils@0.6.4
+  - @backstage/plugin-events-node@0.4.18
+  - @backstage/plugin-permission-node@0.10.7
+  - @backstage/backend-plugin-api@1.6.0
+  - @backstage/plugin-catalog-node@1.20.1
+
+## 3.2.1-next.1
+
+### Patch Changes
+
+- de96a60: chore(deps): bump `express` from 4.21.2 to 4.22.0
+- Updated dependencies
+  - @backstage/backend-openapi-utils@0.6.4-next.1
+  - @backstage/plugin-events-node@0.4.18-next.1
+  - @backstage/plugin-permission-node@0.10.7-next.1
+  - @backstage/integration@1.18.3-next.1
+  - @backstage/backend-plugin-api@1.6.0-next.1
+  - @backstage/catalog-client@1.12.1
+  - @backstage/catalog-model@1.7.6
+  - @backstage/config@1.3.6
+  - @backstage/errors@1.2.7
+  - @backstage/types@1.2.2
+  - @backstage/plugin-catalog-common@1.1.7
+  - @backstage/plugin-catalog-node@1.20.1-next.1
+  - @backstage/plugin-permission-common@0.9.3
+
 ## 3.2.1-next.0
 
 ### Patch Changes

package/dist/actions/createRegisterCatalogEntitiesAction.cjs.js

@@ -0,0 +1,64 @@
+'use strict';
+
+var errors = require('@backstage/errors');
+
+const isValidUrl = (url) => {
+  try {
+    new URL(url);
+    return true;
+  } catch (error) {
+    return false;
+  }
+};
+const createRegisterCatalogEntitiesAction = ({
+  catalog,
+  actionsRegistry
+}) => {
+  actionsRegistry.register({
+    name: "register-entity",
+    title: "Register entity in the Catalog",
+    attributes: {
+      destructive: false,
+      readOnly: false,
+      idempotent: false
+    },
+    description: `Registers one or more entities in the Backstage catalog by creating a Location entity that points to a remote catalog-info.yaml file.
+
+This action is similar to the "Register existing component" flow in the Backstage UI, where you provide a URL to a catalog-info.yaml file describing catalog entities such as Components, Systems, Resources, APIs, Users, and Groups. The action will create a new Location entity that references the provided file; all entities defined within that file will be imported into the catalog.
+
+A unique identifier (locationId) will be returned for the newly created Location. You can use this identifier in the future to unregister or delete the Location and all entities it owns.
+`,
+    schema: {
+      input: (z) => z.object({
+        locationUrl: z.string().describe(
+          `URL reference to the catalog-info.yaml file that describes the entity to register. For example: https://github.com/backstage/demo/blob/master/catalog-info.yaml`
+        )
+      }),
+      output: (z) => z.object({
+        locationId: z.string().describe("The ID of the entity that was registered")
+      })
+    },
+    action: async ({ input, credentials }) => {
+      if (!isValidUrl(input.locationUrl)) {
+        throw new errors.InputError(`${input.locationUrl} is an invalid URL`);
+      }
+      const result = await catalog.addLocation(
+        {
+          type: "url",
+          target: input.locationUrl
+        },
+        {
+          credentials
+        }
+      );
+      return {
+        output: {
+          locationId: result.location.id
+        }
+      };
+    }
+  });
+};
+
+exports.createRegisterCatalogEntitiesAction = createRegisterCatalogEntitiesAction;
+//# sourceMappingURL=createRegisterCatalogEntitiesAction.cjs.js.map

package/dist/actions/createRegisterCatalogEntitiesAction.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createRegisterCatalogEntitiesAction.cjs.js","sources":["../../src/actions/createRegisterCatalogEntitiesAction.ts"],"sourcesContent":["/*\n * Copyright 2025 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport { ActionsRegistryService } from '@backstage/backend-plugin-api/alpha';\nimport { InputError } from '@backstage/errors';\nimport { CatalogService } from '@backstage/plugin-catalog-node';\n\nconst isValidUrl = (url: string) => {\n  try {\n    // eslint-disable-next-line no-new\n    new URL(url);\n    return true;\n  } catch (error) {\n    return false;\n  }\n};\n\nexport const createRegisterCatalogEntitiesAction = ({\n  catalog,\n  actionsRegistry,\n}: {\n  catalog: CatalogService;\n  actionsRegistry: ActionsRegistryService;\n}) => {\n  actionsRegistry.register({\n    name: 'register-entity',\n    title: 'Register entity in the Catalog',\n    attributes: {\n      destructive: false,\n      readOnly: false,\n      idempotent: false,\n    },\n    description: `Registers one or more entities in the Backstage catalog by creating a Location entity that points to a remote catalog-info.yaml file.\n\nThis action is similar to the \"Register existing component\" flow in the Backstage UI, where you provide a URL to a catalog-info.yaml file describing catalog entities such as Components, Systems, Resources, APIs, Users, and Groups. The action will create a new Location entity that references the provided file; all entities defined within that file will be imported into the catalog.\n\nA unique identifier (locationId) will be returned for the newly created Location. You can use this identifier in the future to unregister or delete the Location and all entities it owns.\n`,\n    schema: {\n      input: z =>\n        z.object({\n          locationUrl: z\n            .string()\n            .describe(\n              `URL reference to the catalog-info.yaml file that describes the entity to register. For example: https://github.com/backstage/demo/blob/master/catalog-info.yaml`,\n            ),\n        }),\n      output: z =>\n        z.object({\n          locationId: z\n            .string()\n            .describe('The ID of the entity that was registered'),\n        }),\n    },\n    action: async ({ input, credentials }) => {\n      if (!isValidUrl(input.locationUrl)) {\n        throw new InputError(`${input.locationUrl} is an invalid URL`);\n      }\n\n      const result = await catalog.addLocation(\n        {\n          type: 'url',\n          target: input.locationUrl,\n        },\n        {\n          credentials,\n        },\n      );\n\n      return {\n        output: {\n          locationId: result.location.id,\n        },\n      };\n    },\n  });\n};\n"],"names":["InputError"],"mappings":";;;;AAmBA,MAAM,UAAA,GAAa,CAAC,GAAA,KAAgB;AAClC,EAAA,IAAI;AAEF,IAAA,IAAI,IAAI,GAAG,CAAA;AACX,IAAA,OAAO,IAAA;AAAA,EACT,SAAS,KAAA,EAAO;AACd,IAAA,OAAO,KAAA;AAAA,EACT;AACF,CAAA;AAEO,MAAM,sCAAsC,CAAC;AAAA,EAClD,OAAA;AAAA,EACA;AACF,CAAA,KAGM;AACJ,EAAA,eAAA,CAAgB,QAAA,CAAS;AAAA,IACvB,IAAA,EAAM,iBAAA;AAAA,IACN,KAAA,EAAO,gCAAA;AAAA,IACP,UAAA,EAAY;AAAA,MACV,WAAA,EAAa,KAAA;AAAA,MACb,QAAA,EAAU,KAAA;AAAA,MACV,UAAA,EAAY;AAAA,KACd;AAAA,IACA,WAAA,EAAa,CAAA;;AAAA;;AAAA;AAAA,CAAA;AAAA,IAMb,MAAA,EAAQ;AAAA,MACN,KAAA,EAAO,CAAA,CAAA,KACL,CAAA,CAAE,MAAA,CAAO;AAAA,QACP,WAAA,EAAa,CAAA,CACV,MAAA,EAAO,CACP,QAAA;AAAA,UACC,CAAA,+JAAA;AAAA;AACF,OACH,CAAA;AAAA,MACH,MAAA,EAAQ,CAAA,CAAA,KACN,CAAA,CAAE,MAAA,CAAO;AAAA,QACP,UAAA,EAAY,CAAA,CACT,MAAA,EAAO,CACP,SAAS,0CAA0C;AAAA,OACvD;AAAA,KACL;AAAA,IACA,MAAA,EAAQ,OAAO,EAAE,KAAA,EAAO,aAAY,KAAM;AACxC,MAAA,IAAI,CAAC,UAAA,CAAW,KAAA,CAAM,WAAW,CAAA,EAAG;AAClC,QAAA,MAAM,IAAIA,iBAAA,CAAW,CAAA,EAAG,KAAA,CAAM,WAAW,CAAA,kBAAA,CAAoB,CAAA;AAAA,MAC/D;AAEA,MAAA,MAAM,MAAA,GAAS,MAAM,OAAA,CAAQ,WAAA;AAAA,QAC3B;AAAA,UACE,IAAA,EAAM,KAAA;AAAA,UACN,QAAQ,KAAA,CAAM;AAAA,SAChB;AAAA,QACA;AAAA,UACE;AAAA;AACF,OACF;AAEA,MAAA,OAAO;AAAA,QACL,MAAA,EAAQ;AAAA,UACN,UAAA,EAAY,OAAO,QAAA,CAAS;AAAA;AAC9B,OACF;AAAA,IACF;AAAA,GACD,CAAA;AACH;;;;"}

package/dist/actions/createUnregisterCatalogEntitiesAction.cjs.js

@@ -0,0 +1,73 @@
+'use strict';
+
+var errors = require('@backstage/errors');
+
+const createUnregisterCatalogEntitiesAction = ({
+  catalog,
+  actionsRegistry
+}) => {
+  actionsRegistry.register({
+    name: "unregister-entity",
+    title: "Unregister entity from the Catalog",
+    attributes: {
+      destructive: true,
+      readOnly: false,
+      idempotent: true
+    },
+    description: `Unregisters a Location entity and all entities it owns from the Backstage catalog.
+
+This action is similar to the "Unregister location" function in the Backstage UI, where you provide the unique identifier (locationId) of a Location entity. Alternatively, you can provide the URL used to register the location. The action will remove the specified Location from the catalog as well as all entities that were created when the Location was imported.
+
+Once completed, all entities associated with the Location will be deleted from the catalog.
+`,
+    schema: {
+      input: (z) => z.object({
+        type: z.union([
+          z.object({
+            locationId: z.string().describe(`Location ID of the Entity to unregister`)
+          }),
+          z.object({
+            locationUrl: z.string().describe(
+              `URL of the catalog-info.yaml file to unregister for example: https://github.com/backstage/demo/blob/master/catalog-info.yaml`
+            )
+          })
+        ])
+      }).describe(
+        "The type to the unregister-entity action. Either locationId or locationUrl must be provided."
+      ),
+      output: (z) => z.object({})
+    },
+    action: async ({ input: { type }, credentials }) => {
+      if ("locationId" in type) {
+        await catalog.removeLocationById(type.locationId, {
+          credentials
+        });
+      } else {
+        const locations = await catalog.getLocations(
+          {},
+          {
+            credentials
+          }
+        ).then(
+          (response) => response.items.filter(
+            (location) => location.target.toLowerCase() === type.locationUrl.toLowerCase()
+          )
+        );
+        if (locations.length === 0) {
+          throw new errors.NotFoundError(
+            `Location with URL ${type.locationUrl} not found`
+          );
+        }
+        for (const location of locations) {
+          await catalog.removeLocationById(location.id, {
+            credentials
+          });
+        }
+      }
+      return { output: {} };
+    }
+  });
+};
+
+exports.createUnregisterCatalogEntitiesAction = createUnregisterCatalogEntitiesAction;
+//# sourceMappingURL=createUnregisterCatalogEntitiesAction.cjs.js.map

package/dist/actions/createUnregisterCatalogEntitiesAction.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createUnregisterCatalogEntitiesAction.cjs.js","sources":["../../src/actions/createUnregisterCatalogEntitiesAction.ts"],"sourcesContent":["/*\n * Copyright 2025 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport { ActionsRegistryService } from '@backstage/backend-plugin-api/alpha';\nimport { NotFoundError } from '@backstage/errors';\nimport { CatalogService } from '@backstage/plugin-catalog-node';\n\nexport const createUnregisterCatalogEntitiesAction = ({\n  catalog,\n  actionsRegistry,\n}: {\n  catalog: CatalogService;\n  actionsRegistry: ActionsRegistryService;\n}) => {\n  actionsRegistry.register({\n    name: 'unregister-entity',\n    title: 'Unregister entity from the Catalog',\n    attributes: {\n      destructive: true,\n      readOnly: false,\n      idempotent: true,\n    },\n    description: `Unregisters a Location entity and all entities it owns from the Backstage catalog.\n\nThis action is similar to the \"Unregister location\" function in the Backstage UI, where you provide the unique identifier (locationId) of a Location entity. Alternatively, you can provide the URL used to register the location. The action will remove the specified Location from the catalog as well as all entities that were created when the Location was imported.\n\nOnce completed, all entities associated with the Location will be deleted from the catalog.\n`,\n    schema: {\n      input: z =>\n        z\n          .object({\n            type: z.union([\n              z.object({\n                locationId: z\n                  .string()\n                  .describe(`Location ID of the Entity to unregister`),\n              }),\n              z.object({\n                locationUrl: z\n                  .string()\n                  .describe(\n                    `URL of the catalog-info.yaml file to unregister for example: https://github.com/backstage/demo/blob/master/catalog-info.yaml`,\n                  ),\n              }),\n            ]),\n          })\n          .describe(\n            'The type to the unregister-entity action. Either locationId or locationUrl must be provided.',\n          ),\n      output: z => z.object({}),\n    },\n    action: async ({ input: { type }, credentials }) => {\n      if ('locationId' in type) {\n        await catalog.removeLocationById(type.locationId, {\n          credentials,\n        });\n      } else {\n        const locations = await catalog\n          .getLocations(\n            {},\n            {\n              credentials,\n            },\n          )\n          .then(response =>\n            response.items.filter(\n              location =>\n                location.target.toLowerCase() ===\n                type.locationUrl.toLowerCase(),\n            ),\n          );\n\n        if (locations.length === 0) {\n          throw new NotFoundError(\n            `Location with URL ${type.locationUrl} not found`,\n          );\n        }\n\n        for (const location of locations) {\n          await catalog.removeLocationById(location.id, {\n            credentials,\n          });\n        }\n      }\n\n      return { output: {} };\n    },\n  });\n};\n"],"names":["NotFoundError"],"mappings":";;;;AAmBO,MAAM,wCAAwC,CAAC;AAAA,EACpD,OAAA;AAAA,EACA;AACF,CAAA,KAGM;AACJ,EAAA,eAAA,CAAgB,QAAA,CAAS;AAAA,IACvB,IAAA,EAAM,mBAAA;AAAA,IACN,KAAA,EAAO,oCAAA;AAAA,IACP,UAAA,EAAY;AAAA,MACV,WAAA,EAAa,IAAA;AAAA,MACb,QAAA,EAAU,KAAA;AAAA,MACV,UAAA,EAAY;AAAA,KACd;AAAA,IACA,WAAA,EAAa,CAAA;;AAAA;;AAAA;AAAA,CAAA;AAAA,IAMb,MAAA,EAAQ;AAAA,MACN,KAAA,EAAO,CAAA,CAAA,KACL,CAAA,CACG,MAAA,CAAO;AAAA,QACN,IAAA,EAAM,EAAE,KAAA,CAAM;AAAA,UACZ,EAAE,MAAA,CAAO;AAAA,YACP,UAAA,EAAY,CAAA,CACT,MAAA,EAAO,CACP,SAAS,CAAA,uCAAA,CAAyC;AAAA,WACtD,CAAA;AAAA,UACD,EAAE,MAAA,CAAO;AAAA,YACP,WAAA,EAAa,CAAA,CACV,MAAA,EAAO,CACP,QAAA;AAAA,cACC,CAAA,4HAAA;AAAA;AACF,WACH;AAAA,SACF;AAAA,OACF,CAAA,CACA,QAAA;AAAA,QACC;AAAA,OACF;AAAA,MACJ,MAAA,EAAQ,CAAA,CAAA,KAAK,CAAA,CAAE,MAAA,CAAO,EAAE;AAAA,KAC1B;AAAA,IACA,MAAA,EAAQ,OAAO,EAAE,KAAA,EAAO,EAAE,IAAA,EAAK,EAAG,aAAY,KAAM;AAClD,MAAA,IAAI,gBAAgB,IAAA,EAAM;AACxB,QAAA,MAAM,OAAA,CAAQ,kBAAA,CAAmB,IAAA,CAAK,UAAA,EAAY;AAAA,UAChD;AAAA,SACD,CAAA;AAAA,MACH,CAAA,MAAO;AACL,QAAA,MAAM,SAAA,GAAY,MAAM,OAAA,CACrB,YAAA;AAAA,UACC,EAAC;AAAA,UACD;AAAA,YACE;AAAA;AACF,SACF,CACC,IAAA;AAAA,UAAK,CAAA,QAAA,KACJ,SAAS,KAAA,CAAM,MAAA;AAAA,YACb,cACE,QAAA,CAAS,MAAA,CAAO,aAAY,KAC5B,IAAA,CAAK,YAAY,WAAA;AAAY;AACjC,SACF;AAEF,QAAA,IAAI,SAAA,CAAU,WAAW,CAAA,EAAG;AAC1B,UAAA,MAAM,IAAIA,oBAAA;AAAA,YACR,CAAA,kBAAA,EAAqB,KAAK,WAAW,CAAA,UAAA;AAAA,WACvC;AAAA,QACF;AAEA,QAAA,KAAA,MAAW,YAAY,SAAA,EAAW;AAChC,UAAA,MAAM,OAAA,CAAQ,kBAAA,CAAmB,QAAA,CAAS,EAAA,EAAI;AAAA,YAC5C;AAAA,WACD,CAAA;AAAA,QACH;AAAA,MACF;AAEA,MAAA,OAAO,EAAE,MAAA,EAAQ,EAAC,EAAE;AAAA,IACtB;AAAA,GACD,CAAA;AACH;;;;"}

package/dist/actions/index.cjs.js

@@ -2,10 +2,14 @@
 
 var createGetCatalogEntityAction = require('./createGetCatalogEntityAction.cjs.js');
 var createValidateEntityAction = require('./createValidateEntityAction.cjs.js');
+var createRegisterCatalogEntitiesAction = require('./createRegisterCatalogEntitiesAction.cjs.js');
+var createUnregisterCatalogEntitiesAction = require('./createUnregisterCatalogEntitiesAction.cjs.js');
 
 const createCatalogActions = (options) => {
   createGetCatalogEntityAction.createGetCatalogEntityAction(options);
   createValidateEntityAction.createValidateEntityAction(options);
+  createRegisterCatalogEntitiesAction.createRegisterCatalogEntitiesAction(options);
+  createUnregisterCatalogEntitiesAction.createUnregisterCatalogEntitiesAction(options);
 };
 
 exports.createCatalogActions = createCatalogActions;

package/dist/actions/index.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs.js","sources":["../../src/actions/index.ts"],"sourcesContent":["/*\n * Copyright 2025 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport { ActionsRegistryService } from '@backstage/backend-plugin-api/alpha';\nimport { CatalogService } from '@backstage/plugin-catalog-node';\nimport { createGetCatalogEntityAction } from './createGetCatalogEntityAction.ts';\nimport { createValidateEntityAction } from './createValidateEntityAction.ts';\n\nexport const createCatalogActions = (options: {\n  actionsRegistry: ActionsRegistryService;\n  catalog: CatalogService;\n}) => {\n  createGetCatalogEntityAction(options);\n  createValidateEntityAction(options);\n};\n"],"names":["createGetCatalogEntityAction","createValidateEntityAction"],"mappings":";;;;;AAoBO,MAAM,oBAAA,GAAuB,CAAC,OAAA,KAG/B;AACJ,EAAAA,yDAAA,CAA6B,OAAO,CAAA;AACpC,EAAAC,qDAAA,CAA2B,OAAO,CAAA;AACpC;;;;"}
+{"version":3,"file":"index.cjs.js","sources":["../../src/actions/index.ts"],"sourcesContent":["/*\n * Copyright 2025 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport { ActionsRegistryService } from '@backstage/backend-plugin-api/alpha';\nimport { CatalogService } from '@backstage/plugin-catalog-node';\nimport { createGetCatalogEntityAction } from './createGetCatalogEntityAction.ts';\nimport { createValidateEntityAction } from './createValidateEntityAction.ts';\nimport { createRegisterCatalogEntitiesAction } from './createRegisterCatalogEntitiesAction.ts';\nimport { createUnregisterCatalogEntitiesAction } from './createUnregisterCatalogEntitiesAction.ts';\n\nexport const createCatalogActions = (options: {\n  actionsRegistry: ActionsRegistryService;\n  catalog: CatalogService;\n}) => {\n  createGetCatalogEntityAction(options);\n  createValidateEntityAction(options);\n  createRegisterCatalogEntitiesAction(options);\n  createUnregisterCatalogEntitiesAction(options);\n};\n"],"names":["createGetCatalogEntityAction","createValidateEntityAction","createRegisterCatalogEntitiesAction","createUnregisterCatalogEntitiesAction"],"mappings":";;;;;;;AAsBO,MAAM,oBAAA,GAAuB,CAAC,OAAA,KAG/B;AACJ,EAAAA,yDAAA,CAA6B,OAAO,CAAA;AACpC,EAAAC,qDAAA,CAA2B,OAAO,CAAA;AAClC,EAAAC,uEAAA,CAAoC,OAAO,CAAA;AAC3C,EAAAC,2EAAA,CAAsC,OAAO,CAAA;AAC/C;;;;"}

package/dist/alpha.d.ts

@@ -118,4 +118,5 @@ declare const permissionRules: {
     }>;
 };
 
-export { type CatalogPermissionRule, catalogConditions, createCatalogConditionalDecision, createCatalogPermissionRule, permissionRules };
+export { catalogConditions, createCatalogConditionalDecision, createCatalogPermissionRule, permissionRules };
+export type { CatalogPermissionRule };

package/dist/index.d.ts

@@ -113,4 +113,5 @@ declare const CATALOG_CONFLICTS_TOPIC = "experimental.catalog.conflict";
 /** @public */
 declare const CATALOG_ERRORS_TOPIC = "experimental.catalog.errors";
 
-export { AnnotateLocationEntityProcessor, AnnotateScmSlugEntityProcessor, BuiltinKindsEntityProcessor, CATALOG_CONFLICTS_TOPIC, CATALOG_ERRORS_TOPIC, CodeOwnersProcessor, FileReaderProcessor, PlaceholderProcessor, type PlaceholderProcessorOptions, UrlReaderProcessor, catalogPlugin as default, transformLegacyPolicyToProcessor };
+export { AnnotateLocationEntityProcessor, AnnotateScmSlugEntityProcessor, BuiltinKindsEntityProcessor, CATALOG_CONFLICTS_TOPIC, CATALOG_ERRORS_TOPIC, CodeOwnersProcessor, FileReaderProcessor, PlaceholderProcessor, UrlReaderProcessor, catalogPlugin as default, transformLegacyPolicyToProcessor };
+export type { PlaceholderProcessorOptions };

package/dist/service/DefaultRefreshService.cjs.js

@@ -10,17 +10,13 @@ class DefaultRefreshService {
       const { entityRefs } = await this.database.listAncestors(tx, {
         entityRef: options.entityRef
       });
-      const locationAncestor = entityRefs.find(
+      const locationAncestors = entityRefs.filter(
         (ref) => ref.startsWith("location:")
       );
-      if (locationAncestor) {
-        await this.database.refresh(tx, {
-          entityRef: locationAncestor
-        });
+      for (const locationAncestor of locationAncestors) {
+        await this.database.refresh(tx, { entityRef: locationAncestor });
       }
-      await this.database.refresh(tx, {
-        entityRef: options.entityRef
-      });
+      await this.database.refresh(tx, { entityRef: options.entityRef });
     });
   }
 }

package/dist/service/DefaultRefreshService.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"DefaultRefreshService.cjs.js","sources":["../../src/service/DefaultRefreshService.ts"],"sourcesContent":["/*\n * Copyright 2021 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { DefaultCatalogDatabase } from '../database/DefaultCatalogDatabase';\nimport { RefreshOptions, RefreshService } from './types';\n\nexport class DefaultRefreshService implements RefreshService {\n  private database: DefaultCatalogDatabase;\n\n  constructor(options: { database: DefaultCatalogDatabase }) {\n    this.database = options.database;\n  }\n\n  async refresh(options: RefreshOptions) {\n    await this.database.transaction(async tx => {\n      const { entityRefs } = await this.database.listAncestors(tx, {\n        entityRef: options.entityRef,\n      });\n      const locationAncestor = entityRefs.find(ref =>\n        ref.startsWith('location:'),\n      );\n\n      // TODO: Refreshes are currently scheduled(as soon as possible) for execution and will therefore happen in the future.\n      // There's room for improvements here where the refresh could potentially hang or return an ID so that the user can check progress.\n      if (locationAncestor) {\n        await this.database.refresh(tx, {\n          entityRef: locationAncestor,\n        });\n      }\n      await this.database.refresh(tx, {\n        entityRef: options.entityRef,\n      });\n    });\n  }\n}\n"],"names":[],"mappings":";;AAmBO,MAAM,qBAAA,CAAgD;AAAA,EACnD,QAAA;AAAA,EAER,YAAY,OAAA,EAA+C;AACzD,IAAA,IAAA,CAAK,WAAW,OAAA,CAAQ,QAAA;AAAA,EAC1B;AAAA,EAEA,MAAM,QAAQ,OAAA,EAAyB;AACrC,IAAA,MAAM,IAAA,CAAK,QAAA,CAAS,WAAA,CAAY,OAAM,EAAA,KAAM;AAC1C,MAAA,MAAM,EAAE,UAAA,EAAW,GAAI,MAAM,IAAA,CAAK,QAAA,CAAS,cAAc,EAAA,EAAI;AAAA,QAC3D,WAAW,OAAA,CAAQ;AAAA,OACpB,CAAA;AACD,MAAA,MAAM,mBAAmB,UAAA,CAAW,IAAA;AAAA,QAAK,CAAA,GAAA,KACvC,GAAA,CAAI,UAAA,CAAW,WAAW;AAAA,OAC5B;AAIA,MAAA,IAAI,gBAAA,EAAkB;AACpB,QAAA,MAAM,IAAA,CAAK,QAAA,CAAS,OAAA,CAAQ,EAAA,EAAI;AAAA,UAC9B,SAAA,EAAW;AAAA,SACZ,CAAA;AAAA,MACH;AACA,MAAA,MAAM,IAAA,CAAK,QAAA,CAAS,OAAA,CAAQ,EAAA,EAAI;AAAA,QAC9B,WAAW,OAAA,CAAQ;AAAA,OACpB,CAAA;AAAA,IACH,CAAC,CAAA;AAAA,EACH;AACF;;;;"}
+{"version":3,"file":"DefaultRefreshService.cjs.js","sources":["../../src/service/DefaultRefreshService.ts"],"sourcesContent":["/*\n * Copyright 2021 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { DefaultCatalogDatabase } from '../database/DefaultCatalogDatabase';\nimport { RefreshOptions, RefreshService } from './types';\n\nexport class DefaultRefreshService implements RefreshService {\n  private database: DefaultCatalogDatabase;\n\n  constructor(options: { database: DefaultCatalogDatabase }) {\n    this.database = options.database;\n  }\n\n  async refresh(options: RefreshOptions) {\n    await this.database.transaction(async tx => {\n      const { entityRefs } = await this.database.listAncestors(tx, {\n        entityRef: options.entityRef,\n      });\n\n      const locationAncestors = entityRefs.filter(ref =>\n        ref.startsWith('location:'),\n      );\n\n      // TODO: Refreshes are currently scheduled(as soon as possible) for execution and will therefore happen in the future.\n      // There's room for improvements here where the refresh could potentially hang or return an ID so that the user can check progress.\n      for (const locationAncestor of locationAncestors) {\n        await this.database.refresh(tx, { entityRef: locationAncestor });\n      }\n      await this.database.refresh(tx, { entityRef: options.entityRef });\n    });\n  }\n}\n"],"names":[],"mappings":";;AAmBO,MAAM,qBAAA,CAAgD;AAAA,EACnD,QAAA;AAAA,EAER,YAAY,OAAA,EAA+C;AACzD,IAAA,IAAA,CAAK,WAAW,OAAA,CAAQ,QAAA;AAAA,EAC1B;AAAA,EAEA,MAAM,QAAQ,OAAA,EAAyB;AACrC,IAAA,MAAM,IAAA,CAAK,QAAA,CAAS,WAAA,CAAY,OAAM,EAAA,KAAM;AAC1C,MAAA,MAAM,EAAE,UAAA,EAAW,GAAI,MAAM,IAAA,CAAK,QAAA,CAAS,cAAc,EAAA,EAAI;AAAA,QAC3D,WAAW,OAAA,CAAQ;AAAA,OACpB,CAAA;AAED,MAAA,MAAM,oBAAoB,UAAA,CAAW,MAAA;AAAA,QAAO,CAAA,GAAA,KAC1C,GAAA,CAAI,UAAA,CAAW,WAAW;AAAA,OAC5B;AAIA,MAAA,KAAA,MAAW,oBAAoB,iBAAA,EAAmB;AAChD,QAAA,MAAM,KAAK,QAAA,CAAS,OAAA,CAAQ,IAAI,EAAE,SAAA,EAAW,kBAAkB,CAAA;AAAA,MACjE;AACA,MAAA,MAAM,IAAA,CAAK,SAAS,OAAA,CAAQ,EAAA,EAAI,EAAE,SAAA,EAAW,OAAA,CAAQ,WAAW,CAAA;AAAA,IAClE,CAAC,CAAA;AAAA,EACH;AACF;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backstage/plugin-catalog-backend",
-  "version": "3.2.1-next.0",
+  "version": "3.3.0",
   "description": "The Backstage backend plugin that provides the Backstage catalog",
   "backstage": {
     "role": "backend-plugin",
@@ -73,23 +73,23 @@
     "test": "backstage-cli package test"
   },
   "dependencies": {
-    "@backstage/backend-openapi-utils": "0.6.4-next.0",
-    "@backstage/backend-plugin-api": "1.5.1-next.0",
-    "@backstage/catalog-client": "1.12.1",
-    "@backstage/catalog-model": "1.7.6",
-    "@backstage/config": "1.3.6",
-    "@backstage/errors": "1.2.7",
-    "@backstage/integration": "1.18.3-next.0",
-    "@backstage/plugin-catalog-common": "1.1.7",
-    "@backstage/plugin-catalog-node": "1.20.1-next.0",
-    "@backstage/plugin-events-node": "0.4.18-next.0",
-    "@backstage/plugin-permission-common": "0.9.3",
-    "@backstage/plugin-permission-node": "0.10.7-next.0",
-    "@backstage/types": "1.2.2",
+    "@backstage/backend-openapi-utils": "^0.6.4",
+    "@backstage/backend-plugin-api": "^1.6.0",
+    "@backstage/catalog-client": "^1.12.1",
+    "@backstage/catalog-model": "^1.7.6",
+    "@backstage/config": "^1.3.6",
+    "@backstage/errors": "^1.2.7",
+    "@backstage/integration": "^1.19.0",
+    "@backstage/plugin-catalog-common": "^1.1.7",
+    "@backstage/plugin-catalog-node": "^1.20.1",
+    "@backstage/plugin-events-node": "^0.4.18",
+    "@backstage/plugin-permission-common": "^0.9.3",
+    "@backstage/plugin-permission-node": "^0.10.7",
+    "@backstage/types": "^1.2.2",
     "@opentelemetry/api": "^1.9.0",
     "codeowners-utils": "^1.0.2",
     "core-js": "^3.6.5",
-    "express": "^4.17.1",
+    "express": "^4.22.0",
     "fast-json-stable-stringify": "^2.1.0",
     "fs-extra": "^11.2.0",
     "git-url-parse": "^15.0.0",
@@ -106,11 +106,11 @@
     "zod": "^3.22.4"
   },
   "devDependencies": {
-    "@backstage/backend-defaults": "0.14.0-next.0",
-    "@backstage/backend-test-utils": "1.10.1-next.0",
-    "@backstage/cli": "0.34.6-next.0",
-    "@backstage/plugin-permission-common": "0.9.3",
-    "@backstage/repo-tools": "0.16.1-next.0",
+    "@backstage/backend-defaults": "^0.14.0",
+    "@backstage/backend-test-utils": "^1.10.2",
+    "@backstage/cli": "^0.35.0",
+    "@backstage/plugin-permission-common": "^0.9.3",
+    "@backstage/repo-tools": "^0.16.1",
     "@types/core-js": "^2.5.4",
     "@types/express": "^4.17.6",
     "@types/git-url-parse": "^9.0.0",