add back the alpha entrypoint and update new service to Root...

Signed-off-by: aramissennyeydd <aramis.sennyey@doordash.com>

packages/backend-plugin-api/src/alpha/InstanceMetadataService.ts

@@ -0,0 +1,32 @@
+/*
+ * Copyright 2025 The Backstage Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/** @alpha */
+export type BackendFeatureMeta =
+  | {
+      type: 'plugin';
+      pluginId: string;
+    }
+  | {
+      type: 'module';
+      pluginId: string;
+      moduleId: string;
+    };
+
+/** @alpha */
+export interface InstanceMetadataService {
+  getInstalledFeatures: () => BackendFeatureMeta[];
+}

packages/backend-plugin-api/src/alpha/index.ts

@@ -14,6 +14,11 @@
  * limitations under the License.
  */
 
+export type {
+  BackendFeatureMeta,
+  InstanceMetadataService,
+} from './InstanceMetadataService';
+
 export type {
   ActionsRegistryService,
   ActionsRegistryActionOptions,
@@ -22,4 +27,8 @@ export type {
 
 export type { ActionsService, ActionsServiceAction } from './ActionsService';
 
-export { actionsRegistryServiceRef, actionsServiceRef } from './refs';
+export {
+  actionsRegistryServiceRef,
+  actionsServiceRef,
+  instanceMetadataServiceRef,
+} from './refs';

packages/backend-plugin-api/src/alpha/refs.ts

@@ -16,6 +16,15 @@
 
 import { createServiceRef } from '@backstage/backend-plugin-api';
 
+/**
+ * @alpha
+ */
+export const instanceMetadataServiceRef = createServiceRef<
+  import('./InstanceMetadataService').InstanceMetadataService
+>({
+  id: 'core.instanceMetadata',
+});
+
 /**
  * Service for calling distributed actions
  *

packages/backend-plugin-api/src/services/definitions/RootInstanceMetadataService.ts

@@ -15,7 +15,7 @@
  */
 
 /** @public */
-export interface InstanceMetadataServicePluginInfo {
+export interface RootInstanceMetadataServicePluginInfo {
   readonly pluginId: string;
   readonly modules: ReadonlyArray<{
     moduleId: string;
@@ -23,8 +23,8 @@ export interface InstanceMetadataServicePluginInfo {
 }
 
 /** @public */
-export interface InstanceMetadataService {
+export interface RootInstanceMetadataService {
   getInstalledPlugins: () => Promise<
-    ReadonlyArray<InstanceMetadataServicePluginInfo>
+    ReadonlyArray<RootInstanceMetadataServicePluginInfo>
   >;
 }

packages/backend-plugin-api/src/services/definitions/coreServices.ts

@@ -283,9 +283,9 @@ export namespace coreServices {
    *
    * @public
    */
-  export const instanceMetadata = createServiceRef<
-    import('./InstanceMetadataService').InstanceMetadataService
+  export const rootInstanceMetadata = createServiceRef<
+    import('./RootInstanceMetadataService').RootInstanceMetadataService
   >({
-    id: 'core.instanceMetadata',
+    id: 'core.rootInstanceMetadata',
   });
 }

packages/backend-plugin-api/src/services/definitions/index.ts

@@ -86,7 +86,7 @@ export type {
 } from './UrlReaderService';
 export type { BackstageUserInfo, UserInfoService } from './UserInfoService';
 export type {
-  InstanceMetadataService,
-  InstanceMetadataServicePluginInfo,
-} from './InstanceMetadataService';
+  RootInstanceMetadataService,
+  RootInstanceMetadataServicePluginInfo,
+} from './RootInstanceMetadataService';
 export { coreServices } from './coreServices';