move to a top level service

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

packages/backend-plugin-api/report-alpha.api.md

@@ -6,6 +6,25 @@
 import { BackendFeature } from '@backstage/backend-plugin-api';
 import { ServiceRef } from '@backstage/backend-plugin-api';
 
+// @alpha (undocumented)
+export type BackendFeatureMeta =
+  | {
+      type: 'plugin';
+      pluginId: string;
+    }
+  | {
+      type: 'module';
+      pluginId: string;
+      moduleId: string;
+    };
+
+// @alpha
+export const EXPERIMENTAL_instanceMetadataServiceRef: ServiceRef<
+  InstanceMetadataService,
+  'plugin',
+  'singleton'
+>;
+
 // @alpha (undocumented)
 export interface FeatureDiscoveryService {
   // (undocumented)
@@ -21,5 +40,11 @@ export const featureDiscoveryServiceRef: ServiceRef<
   'singleton'
 >;
 
+// @alpha (undocumented)
+export interface InstanceMetadataService {
+  // (undocumented)
+  getInstalledFeatures: () => BackendFeatureMeta[];
+}
+
 // (No @packageDocumentation comment for this package)
 ```

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

@@ -35,5 +35,18 @@ export const featureDiscoveryServiceRef =
     scope: 'root',
   });
 
-export { experimentalServices } from './services/definitions/experimentalServices';
-export type { BackendFeatureMeta } from './services/definitions/InstanceMetadataService';
+/**
+ * EXPERIMENTAL: Instance metadata service.
+ *
+ * @alpha
+ */
+export const EXPERIMENTAL_instanceMetadataServiceRef = createServiceRef<
+  import('./services/definitions/InstanceMetadataService').InstanceMetadataService
+>({
+  id: 'experimental.instanceMetadata',
+});
+
+export type {
+  BackendFeatureMeta,
+  InstanceMetadataService,
+} from './services/definitions/InstanceMetadataService';

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

@@ -14,6 +14,7 @@
  * limitations under the License.
  */
 
+/** @alpha */
 export type BackendFeatureMeta =
   | {
       type: 'plugin';
@@ -25,6 +26,7 @@ export type BackendFeatureMeta =
       moduleId: string;
     };
 
+/** @alpha */
 export interface InstanceMetadataService {
   getInstalledFeatures: () => BackendFeatureMeta[];
 }

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

@@ -1,29 +0,0 @@
-/*
- * Copyright 2024 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.
- */
-import { createServiceRef } from '../system';
-
-export namespace experimentalServices {
-  /**
-   * EXPERIMENTAL: Instance metadata service.
-   *
-   * @public
-   */
-  export const EXPERIMENTAL_instanceMetadata = createServiceRef<
-    import('./InstanceMetadataService').InstanceMetadataService
-  >({
-    id: 'core.instanceMetadata',
-  });
-}