@backstage/backend-app-api 0.7.6-next.3 → 0.7.7

package/dist/index.d.ts

@@ -1,31 +1,37 @@
 /// <reference types="node" />
 import * as _backstage_backend_plugin_api from '@backstage/backend-plugin-api';
-import { LoggerService, RootConfigService, RootLoggerService, BackendFeature, ServiceFactoryOrFunction, DiscoveryService, HttpAuthService, LifecycleService, RootHttpRouterService, RootLifecycleService, UserInfoService } from '@backstage/backend-plugin-api';
-import { ConfigSchema, LoadConfigOptionsRemote, RemoteConfigSourceOptions } from '@backstage/config-loader';
+import { LoggerService, RootConfigService, RootLoggerService, BackendFeature, ServiceFactoryOrFunction, DiscoveryService, LifecycleService, RootLifecycleService, RootHttpRouterService } from '@backstage/backend-plugin-api';
 import { Config, AppConfig } from '@backstage/config';
+import { ConfigSchema, LoadConfigOptionsRemote, RemoteConfigSourceOptions } from '@backstage/config-loader';
+import { RequestHandler, ErrorRequestHandler, Express, Handler } from 'express';
 import * as http from 'http';
 import { RequestListener } from 'http';
-import { RequestHandler, ErrorRequestHandler, Express, Handler } from 'express';
 import { CorsOptions } from 'cors';
 import { HelmetOptions } from 'helmet';
 import { JsonObject, HumanDuration } from '@backstage/types';
 import { Format } from 'logform';
 import { transport } from 'winston';
-import * as _backstage_backend_common from '@backstage/backend-common';
 import { Server } from 'node:http';
 
 /** @public */
-declare function createConfigSecretEnumerator(options: {
+declare function createConfigSecretEnumerator$1(options: {
     logger: LoggerService;
     dir?: string;
     schema?: ConfigSchema;
 }): Promise<(config: Config) => Iterable<string>>;
+
+/**
+ * @public
+ * @deprecated Please import from `@backstage/backend-defaults/rootConfig` instead.
+ */
+declare const createConfigSecretEnumerator: typeof createConfigSecretEnumerator$1;
 /**
  * Load configuration for a Backend.
  *
  * This function should only be called once, during the initialization of the backend.
  *
  * @public
+ * @deprecated Please migrate to the new backend system and use `coreServices.rootConfig` instead, or the {@link @backstage/config-loader#ConfigSources} facilities if required.
  */
 declare function loadBackendConfig(options: {
     remote?: LoadConfigOptionsRemote;
@@ -41,7 +47,7 @@ declare function loadBackendConfig(options: {
  *
  * @public
  */
-interface ExtendedHttpServer extends http.Server {
+interface ExtendedHttpServer$1 extends http.Server {
     start(): Promise<void>;
     stop(): Promise<void>;
     port(): number;
@@ -51,13 +57,13 @@ interface ExtendedHttpServer extends http.Server {
  *
  * @public
  */
-type HttpServerOptions = {
+type HttpServerOptions$1 = {
     listen: {
         port: number;
         host: string;
     };
     https?: {
-        certificate: HttpServerCertificateOptions;
+        certificate: HttpServerCertificateOptions$1;
     };
 };
 /**
@@ -65,7 +71,7 @@ type HttpServerOptions = {
  *
  * @public
  */
-type HttpServerCertificateOptions = {
+type HttpServerCertificateOptions$1 = {
     type: 'pem';
     key: string;
     cert: string;
@@ -88,23 +94,23 @@ type HttpServerCertificateOptions = {
  * const opts = readHttpServerOptions(config.getConfig('backend'));
  * ```
  */
-declare function readHttpServerOptions(config?: Config): HttpServerOptions;
+declare function readHttpServerOptions$1(config?: Config): HttpServerOptions$1;
 
 /**
  * Creates a Node.js HTTP or HTTPS server instance.
  *
  * @public
  */
-declare function createHttpServer(listener: RequestListener, options: HttpServerOptions, deps: {
+declare function createHttpServer$1(listener: RequestListener, options: HttpServerOptions$1, deps: {
     logger: LoggerService;
-}): Promise<ExtendedHttpServer>;
+}): Promise<ExtendedHttpServer$1>;
 
 /**
  * Options used to create a {@link MiddlewareFactory}.
  *
  * @public
  */
-interface MiddlewareFactoryOptions {
+interface MiddlewareFactoryOptions$1 {
     config: RootConfigService;
     logger: LoggerService;
 }
@@ -113,7 +119,7 @@ interface MiddlewareFactoryOptions {
  *
  * @public
  */
-interface MiddlewareFactoryErrorOptions {
+interface MiddlewareFactoryErrorOptions$1 {
     /**
      * Whether error response bodies should show error stack traces or not.
      *
@@ -132,12 +138,12 @@ interface MiddlewareFactoryErrorOptions {
  *
  * @public
  */
-declare class MiddlewareFactory {
+declare class MiddlewareFactory$1 {
     #private;
     /**
      * Creates a new {@link MiddlewareFactory}.
      */
-    static create(options: MiddlewareFactoryOptions): MiddlewareFactory;
+    static create(options: MiddlewareFactoryOptions$1): MiddlewareFactory$1;
     private constructor();
     /**
      * Returns a middleware that unconditionally produces a 404 error response.
@@ -217,7 +223,7 @@ declare class MiddlewareFactory {
      *
      * @returns An Express error request handler
      */
-    error(options?: MiddlewareFactoryErrorOptions): ErrorRequestHandler;
+    error(options?: MiddlewareFactoryErrorOptions$1): ErrorRequestHandler;
 }
 
 /**
@@ -232,7 +238,7 @@ declare class MiddlewareFactory {
  * const corsOptions = readCorsOptions(config.getConfig('backend'));
  * ```
  */
-declare function readCorsOptions(config?: Config): CorsOptions;
+declare function readCorsOptions$1(config?: Config): CorsOptions;
 
 /**
  * Attempts to read Helmet options from the backend configuration object.
@@ -246,24 +252,168 @@ declare function readCorsOptions(config?: Config): CorsOptions;
  * const helmetOptions = readHelmetOptions(config.getConfig('backend'));
  * ```
  */
-declare function readHelmetOptions(config?: Config): HelmetOptions;
+declare function readHelmetOptions$1(config?: Config): HelmetOptions;
+
+/**
+ * @public
+ * @deprecated Please import from `@backstage/backend-defaults/rootHttpRouter` instead.
+ */
+declare const readHttpServerOptions: typeof readHttpServerOptions$1;
+/**
+ * @public
+ * @deprecated Please import from `@backstage/backend-defaults/rootHttpRouter` instead.
+ */
+declare const createHttpServer: typeof createHttpServer$1;
+/**
+ * @public
+ * @deprecated Please import from `@backstage/backend-defaults/rootHttpRouter` instead.
+ */
+declare const readCorsOptions: typeof readCorsOptions$1;
+/**
+ * @public
+ * @deprecated Please import from `@backstage/backend-defaults/rootHttpRouter` instead.
+ */
+declare const readHelmetOptions: typeof readHelmetOptions$1;
+/**
+ * @public
+ * @deprecated Please import from `@backstage/backend-defaults/rootHttpRouter` instead.
+ */
+declare class MiddlewareFactory {
+    private readonly impl;
+    /**
+     * Creates a new {@link MiddlewareFactory}.
+     */
+    static create(options: MiddlewareFactoryOptions): MiddlewareFactory$1;
+    private constructor();
+    /**
+     * Returns a middleware that unconditionally produces a 404 error response.
+     *
+     * @remarks
+     *
+     * Typically you want to place this middleware at the end of the chain, such
+     * that it's the last one attempted after no other routes matched.
+     *
+     * @returns An Express request handler
+     */
+    notFound(): RequestHandler;
+    /**
+     * Returns the compression middleware.
+     *
+     * @remarks
+     *
+     * The middleware will attempt to compress response bodies for all requests
+     * that traverse through the middleware.
+     */
+    compression(): RequestHandler;
+    /**
+     * Returns a request logging middleware.
+     *
+     * @remarks
+     *
+     * Typically you want to place this middleware at the start of the chain, such
+     * that it always logs requests whether they are "caught" by handlers farther
+     * down or not.
+     *
+     * @returns An Express request handler
+     */
+    logging(): RequestHandler;
+    /**
+     * Returns a middleware that implements the helmet library.
+     *
+     * @remarks
+     *
+     * This middleware applies security policies to incoming requests and outgoing
+     * responses. It is configured using config keys such as `backend.csp`.
+     *
+     * @see {@link https://helmetjs.github.io/}
+     *
+     * @returns An Express request handler
+     */
+    helmet(): RequestHandler;
+    /**
+     * Returns a middleware that implements the cors library.
+     *
+     * @remarks
+     *
+     * This middleware handles CORS. It is configured using the config key
+     * `backend.cors`.
+     *
+     * @see {@link https://github.com/expressjs/cors}
+     *
+     * @returns An Express request handler
+     */
+    cors(): RequestHandler;
+    /**
+     * Express middleware to handle errors during request processing.
+     *
+     * @remarks
+     *
+     * This is commonly the very last middleware in the chain.
+     *
+     * Its primary purpose is not to do translation of business logic exceptions,
+     * but rather to be a global catch-all for uncaught "fatal" errors that are
+     * expected to result in a 500 error. However, it also does handle some common
+     * error types (such as http-error exceptions, and the well-known error types
+     * in the `@backstage/errors` package) and returns the enclosed status code
+     * accordingly.
+     *
+     * It will also produce a response body with a serialized form of the error,
+     * unless a previous handler already did send a body. See
+     * {@link @backstage/errors#ErrorResponseBody} for the response shape used.
+     *
+     * @returns An Express error request handler
+     */
+    error(options?: MiddlewareFactoryErrorOptions): ErrorRequestHandler;
+}
+/**
+ * @public
+ * @deprecated Please import from `@backstage/backend-defaults/rootHttpRouter` instead.
+ */
+type MiddlewareFactoryErrorOptions = MiddlewareFactoryErrorOptions$1;
+/**
+ * @public
+ * @deprecated Please import from `@backstage/backend-defaults/rootHttpRouter` instead.
+ */
+type MiddlewareFactoryOptions = MiddlewareFactoryOptions$1;
+/**
+ * @public
+ * @deprecated Please import from `@backstage/backend-defaults/rootHttpRouter` instead.
+ */
+type ExtendedHttpServer = ExtendedHttpServer$1;
+/**
+ * @public
+ * @deprecated Please import from `@backstage/backend-defaults/rootHttpRouter` instead.
+ */
+type HttpServerCertificateOptions = HttpServerCertificateOptions$1;
+/**
+ * @public
+ * @deprecated Please import from `@backstage/backend-defaults/rootHttpRouter` instead.
+ */
+type HttpServerOptions = HttpServerOptions$1;
 
 /**
  * @public
  */
-interface WinstonLoggerOptions {
+interface WinstonLoggerOptions$1 {
     meta?: JsonObject;
     level?: string;
     format?: Format;
     transports?: transport[];
 }
+
+/**
+ * @public
+ * @deprecated Please import from `@backstage/backend-defaults/rootLogger` instead.
+ */
+type WinstonLoggerOptions = WinstonLoggerOptions$1;
 /**
  * A {@link @backstage/backend-plugin-api#LoggerService} implementation based on winston.
  *
  * @public
+ * @deprecated Please import from `@backstage/backend-defaults/rootLogger` instead.
  */
 declare class WinstonLogger implements RootLoggerService {
-    #private;
+    private readonly impl;
     /**
      * Creates a {@link WinstonLogger} instance.
      */
@@ -310,9 +460,6 @@ interface CreateSpecializedBackendOptions {
  */
 declare function createSpecializedBackend(options: CreateSpecializedBackendOptions): Backend;
 
-/** @public */
-declare const authServiceFactory: () => _backstage_backend_plugin_api.ServiceFactory<_backstage_backend_plugin_api.AuthService, "plugin">;
-
 /**
  * @public
  * @deprecated Please import from `@backstage/backend-defaults/cache` instead.
@@ -344,7 +491,7 @@ declare const rootConfigServiceFactory: (options?: RootConfigFactoryOptions | un
  * @public
  * @deprecated Please import from `@backstage/backend-defaults/database` instead.
  */
-declare const databaseServiceFactory: () => _backstage_backend_plugin_api.ServiceFactory<_backstage_backend_common.PluginDatabaseManager, "plugin">;
+declare const databaseServiceFactory: () => _backstage_backend_plugin_api.ServiceFactory<_backstage_backend_plugin_api.DatabaseService, "plugin">;
 
 /**
  * @public
@@ -364,9 +511,7 @@ declare const discoveryServiceFactory: () => _backstage_backend_plugin_api.Servi
  * @deprecated Please import from `@backstage/backend-defaults/discovery` instead.
  */
 declare class HostDiscovery implements DiscoveryService {
-    private readonly internalBaseUrl;
-    private readonly externalBaseUrl;
-    private readonly discoveryConfig;
+    private readonly impl;
     /**
      * Creates a new HostDiscovery discovery instance by reading
      * from the `backend` config section, specifically the `.baseUrl` for
@@ -395,31 +540,108 @@ declare class HostDiscovery implements DiscoveryService {
         basePath?: string;
     }): HostDiscovery;
     private constructor();
-    private getTargetFromConfig;
     getBaseUrl(pluginId: string): Promise<string>;
     getExternalBaseUrl(pluginId: string): Promise<string>;
 }
 
-/** @public */
-declare const httpAuthServiceFactory: () => _backstage_backend_plugin_api.ServiceFactory<HttpAuthService, "plugin">;
+/**
+ * An identity client options object which allows extra configurations
+ *
+ * @public
+ * @deprecated Please migrate to the new `coreServices.auth`, `coreServices.httpAuth`, and `coreServices.userInfo` services as needed instead
+ */
+type IdentityFactoryOptions = {
+    issuer?: string;
+    /**
+     * JWS "alg" (Algorithm) Header Parameter values. Defaults to an array containing just ES256.
+     * More info on supported algorithms: https://github.com/panva/jose
+     */
+    algorithms?: string[];
+};
+/**
+ * @public
+ * @deprecated Please migrate to the new `coreServices.auth`, `coreServices.httpAuth`, and `coreServices.userInfo` services as needed instead
+ */
+declare const identityServiceFactory: (options?: IdentityFactoryOptions | undefined) => _backstage_backend_plugin_api.ServiceFactory<_backstage_backend_plugin_api.IdentityService, "plugin">;
+
+/**
+ * Allows plugins to register shutdown hooks that are run when the process is about to exit.
+ *
+ * @public
+ * @deprecated Please import from `@backstage/backend-defaults/lifecycle` instead.
+ */
+declare const lifecycleServiceFactory: () => _backstage_backend_plugin_api.ServiceFactory<LifecycleService, "plugin">;
+
+/**
+ * @public
+ * @deprecated Please import from `@backstage/backend-defaults/permissions` instead.
+ */
+declare const permissionsServiceFactory: () => _backstage_backend_plugin_api.ServiceFactory<_backstage_backend_plugin_api.PermissionsService, "plugin">;
+
+/**
+ * Allows plugins to register shutdown hooks that are run when the process is about to exit.
+ *
+ * @public
+ * @deprecated Please import from `@backstage/backend-defaults/rootLifecycle` instead.
+ */
+declare const rootLifecycleServiceFactory: () => _backstage_backend_plugin_api.ServiceFactory<RootLifecycleService, "root">;
+
+/**
+ * @public
+ * @deprecated Please migrate to the new `coreServices.auth`, `coreServices.httpAuth`, and `coreServices.userInfo` services as needed instead
+ */
+declare const tokenManagerServiceFactory: () => _backstage_backend_plugin_api.ServiceFactory<_backstage_backend_plugin_api.TokenManagerService, "plugin">;
+
+/**
+ * @public
+ * @deprecated Please import from `@backstage/backend-defaults/urlReader` instead.
+ */
+declare const urlReaderServiceFactory: () => _backstage_backend_plugin_api.ServiceFactory<_backstage_backend_plugin_api.UrlReaderService, "plugin">;
+
+/**
+ * @public
+ * @deprecated Please import from `@backstage/backend-defaults/auth` instead.
+ */
+declare const authServiceFactory: () => _backstage_backend_plugin_api.ServiceFactory<_backstage_backend_plugin_api.AuthService, "plugin">;
+
+/**
+ * @public
+ * @deprecated Please import from `@backstage/backend-defaults/httpAuth` instead.
+ */
+declare const httpAuthServiceFactory: () => _backstage_backend_plugin_api.ServiceFactory<_backstage_backend_plugin_api.HttpAuthService, "plugin">;
 
 /**
  * @public
  */
-interface HttpRouterFactoryOptions {
+interface HttpRouterFactoryOptions$1 {
     /**
      * A callback used to generate the path for each plugin, defaults to `/api/{pluginId}`.
      */
     getPath?(pluginId: string): string;
 }
-/** @public */
-declare const httpRouterServiceFactory: (options?: HttpRouterFactoryOptions | undefined) => _backstage_backend_plugin_api.ServiceFactory<_backstage_backend_plugin_api.HttpRouterService, "plugin">;
+
+/**
+ * @public
+ * @deprecated Please import from `@backstage/backend-defaults/httpRouter` instead.
+ */
+type HttpRouterFactoryOptions = HttpRouterFactoryOptions$1;
+/**
+ * HTTP route registration for plugins.
+ *
+ * See {@link @backstage/code-plugin-api#HttpRouterService}
+ * and {@link https://backstage.io/docs/backend-system/core-services/http-router | the service docs}
+ * for more information.
+ *
+ * @public
+ * @deprecated Please import from `@backstage/backend-defaults/httpRouter` instead.
+ */
+declare const httpRouterServiceFactory: (options?: HttpRouterFactoryOptions$1 | undefined) => _backstage_backend_plugin_api.ServiceFactory<_backstage_backend_plugin_api.HttpRouterService, "plugin">;
 
 /**
  * Options for {@link createLifecycleMiddleware}.
  * @public
  */
-interface LifecycleMiddlewareOptions {
+interface LifecycleMiddlewareOptions$1 {
     lifecycle: LifecycleService;
     /**
      * The maximum time that paused requests will wait for the service to start, before returning an error.
@@ -442,52 +664,50 @@ interface LifecycleMiddlewareOptions {
  *
  * @public
  */
-declare function createLifecycleMiddleware(options: LifecycleMiddlewareOptions): RequestHandler;
+declare function createLifecycleMiddleware$1(options: LifecycleMiddlewareOptions$1): RequestHandler;
 
 /**
- * An identity client options object which allows extra configurations
- *
+ * Options for {@link createLifecycleMiddleware}.
  * @public
- * @deprecated Please migrate to the new `coreServices.auth`, `coreServices.httpAuth`, and `coreServices.userInfo` services as needed instead
+ * @deprecated Please import from `@backstage/backend-defaults/httpRouter` instead.
  */
-type IdentityFactoryOptions = {
-    issuer?: string;
-    /**
-     * JWS "alg" (Algorithm) Header Parameter values. Defaults to an array containing just ES256.
-     * More info on supported algorithms: https://github.com/panva/jose
-     */
-    algorithms?: string[];
-};
+type LifecycleMiddlewareOptions = LifecycleMiddlewareOptions$1;
 /**
+ * Creates a middleware that pauses requests until the service has started.
+ *
+ * @remarks
+ *
+ * Requests that arrive before the service has started will be paused until startup is complete.
+ * If the service does not start within the provided timeout, the request will be rejected with a
+ * {@link @backstage/errors#ServiceUnavailableError}.
+ *
+ * If the service is shutting down, all requests will be rejected with a
+ * {@link @backstage/errors#ServiceUnavailableError}.
+ *
  * @public
- * @deprecated Please migrate to the new `coreServices.auth`, `coreServices.httpAuth`, and `coreServices.userInfo` services as needed instead
+ * @deprecated Please import from `@backstage/backend-defaults/httpRouter` instead.
  */
-declare const identityServiceFactory: (options?: IdentityFactoryOptions | undefined) => _backstage_backend_plugin_api.ServiceFactory<_backstage_backend_plugin_api.IdentityService, "plugin">;
+declare const createLifecycleMiddleware: typeof createLifecycleMiddleware$1;
 
 /**
- * Allows plugins to register shutdown hooks that are run when the process is about to exit.
+ * Plugin-level logging.
+ *
+ * See {@link @backstage/code-plugin-api#LoggerService}
+ * and {@link https://backstage.io/docs/backend-system/core-services/logger | the service docs}
+ * for more information.
  *
  * @public
- * @deprecated Please import from `@backstage/backend-defaults/lifecycle` instead.
+ * @deprecated Please import from `@backstage/backend-defaults/logger` instead.
  */
-declare const lifecycleServiceFactory: () => _backstage_backend_plugin_api.ServiceFactory<LifecycleService, "plugin">;
-
-/** @public */
 declare const loggerServiceFactory: () => _backstage_backend_plugin_api.ServiceFactory<_backstage_backend_plugin_api.LoggerService, "plugin">;
 
-/**
- * @public
- * @deprecated Please import from `@backstage/backend-defaults/permissions` instead.
- */
-declare const permissionsServiceFactory: () => _backstage_backend_plugin_api.ServiceFactory<_backstage_backend_plugin_api.PermissionsService, "plugin">;
-
 /**
  * @public
  */
-interface RootHttpRouterConfigureContext {
+interface RootHttpRouterConfigureContext$1 {
     app: Express;
     server: Server;
-    middleware: MiddlewareFactory;
+    middleware: MiddlewareFactory$1;
     routes: RequestHandler;
     config: RootConfigService;
     logger: LoggerService;
@@ -495,39 +715,74 @@ interface RootHttpRouterConfigureContext {
     applyDefaults: () => void;
 }
 /**
+ * HTTP route registration for root services.
+ *
+ * See {@link @backstage/code-plugin-api#RootHttpRouterService}
+ * and {@link https://backstage.io/docs/backend-system/core-services/root-http-router | the service docs}
+ * for more information.
+ *
  * @public
  */
-type RootHttpRouterFactoryOptions = {
+type RootHttpRouterFactoryOptions$1 = {
     /**
      * The path to forward all unmatched requests to. Defaults to '/api/app' if
      * not given. Disables index path behavior if false is given.
      */
     indexPath?: string | false;
-    configure?(context: RootHttpRouterConfigureContext): void;
+    configure?(context: RootHttpRouterConfigureContext$1): void;
 };
-/** @public */
-declare const rootHttpRouterServiceFactory: (options?: RootHttpRouterFactoryOptions | undefined) => _backstage_backend_plugin_api.ServiceFactory<_backstage_backend_plugin_api.RootHttpRouterService, "root">;
+
+/**
+ * @public
+ * @deprecated Please import from `@backstage/backend-defaults/rootHttpRouter` instead.
+ */
+type RootHttpRouterConfigureContext = RootHttpRouterConfigureContext$1;
+/**
+ * HTTP route registration for root services.
+ *
+ * See {@link @backstage/code-plugin-api#RootHttpRouterService}
+ * and {@link https://backstage.io/docs/backend-system/core-services/root-http-router | the service docs}
+ * for more information.
+ *
+ * @public
+ * @deprecated Please import from `@backstage/backend-defaults/rootHttpRouter` instead.
+ */
+type RootHttpRouterFactoryOptions = RootHttpRouterFactoryOptions$1;
+/**
+ * @public
+ * @deprecated Please import from `@backstage/backend-defaults/rootHttpRouter` instead.
+ */
+declare const rootHttpRouterServiceFactory: (options?: RootHttpRouterFactoryOptions$1 | undefined) => _backstage_backend_plugin_api.ServiceFactory<_backstage_backend_plugin_api.RootHttpRouterService, "root">;
 
 /**
  * Options for the {@link DefaultRootHttpRouter} class.
  *
  * @public
  */
-interface DefaultRootHttpRouterOptions {
+interface DefaultRootHttpRouterOptions$1 {
     /**
      * The path to forward all unmatched requests to. Defaults to '/api/app' if
      * not given. Disables index path behavior if false is given.
      */
     indexPath?: string | false;
 }
+
+/**
+ * Options for the {@link DefaultRootHttpRouter} class.
+ *
+ * @public
+ * @deprecated Please import from `@backstage/backend-defaults/rootHttpRouter` instead.
+ */
+type DefaultRootHttpRouterOptions = DefaultRootHttpRouterOptions$1;
 /**
  * The default implementation of the {@link @backstage/backend-plugin-api#RootHttpRouterService} interface for
  * {@link @backstage/backend-plugin-api#coreServices.rootHttpRouter}.
  *
  * @public
+ * @deprecated Please import from `@backstage/backend-defaults/rootHttpRouter` instead.
  */
 declare class DefaultRootHttpRouter implements RootHttpRouterService {
-    #private;
+    private readonly impl;
     static create(options?: DefaultRootHttpRouterOptions): DefaultRootHttpRouter;
     private constructor();
     use(path: string, handler: Handler): void;
@@ -535,35 +790,27 @@ declare class DefaultRootHttpRouter implements RootHttpRouterService {
 }
 
 /**
- * Allows plugins to register shutdown hooks that are run when the process is about to exit.
+ * Root-level logging.
+ *
+ * See {@link @backstage/code-plugin-api#RootLoggerService}
+ * and {@link https://backstage.io/docs/backend-system/core-services/root-logger | the service docs}
+ * for more information.
  *
  * @public
- * @deprecated Please import from `@backstage/backend-defaults/rootLifecycle` instead.
+ * @deprecated Please import from `@backstage/backend-defaults/rootLogger` instead.
  */
-declare const rootLifecycleServiceFactory: () => _backstage_backend_plugin_api.ServiceFactory<RootLifecycleService, "root">;
-
-/** @public */
 declare const rootLoggerServiceFactory: () => _backstage_backend_plugin_api.ServiceFactory<_backstage_backend_plugin_api.RootLoggerService, "root">;
 
 /**
  * @public
- * @deprecated Please migrate to the new `coreServices.auth`, `coreServices.httpAuth`, and `coreServices.userInfo` services as needed instead
- */
-declare const tokenManagerServiceFactory: () => _backstage_backend_plugin_api.ServiceFactory<_backstage_backend_plugin_api.TokenManagerService, "plugin">;
-
-/**
- * @public
- * @deprecated Please import from `@backstage/backend-defaults/urlReader` instead.
+ * @deprecated Please import from `@backstage/backend-defaults/scheduler` instead.
  */
-declare const urlReaderServiceFactory: () => _backstage_backend_plugin_api.ServiceFactory<_backstage_backend_plugin_api.UrlReaderService, "plugin">;
-
-/** @public */
-declare const userInfoServiceFactory: () => _backstage_backend_plugin_api.ServiceFactory<UserInfoService, "plugin">;
+declare const schedulerServiceFactory: () => _backstage_backend_plugin_api.ServiceFactory<_backstage_backend_plugin_api.SchedulerService, "plugin">;
 
 /**
  * @public
- * @deprecated Please import from `@backstage/backend-defaults/scheduler` instead.
+ * @deprecated Please import from `@backstage/backend-defaults/userInfo` instead.
  */
-declare const schedulerServiceFactory: () => _backstage_backend_plugin_api.ServiceFactory<_backstage_backend_plugin_api.SchedulerService, "plugin">;
+declare const userInfoServiceFactory: () => _backstage_backend_plugin_api.ServiceFactory<_backstage_backend_plugin_api.UserInfoService, "plugin">;
 
 export { type Backend, type CreateSpecializedBackendOptions, DefaultRootHttpRouter, type DefaultRootHttpRouterOptions, type ExtendedHttpServer, HostDiscovery, type HttpRouterFactoryOptions, type HttpServerCertificateOptions, type HttpServerOptions, type IdentityFactoryOptions, type LifecycleMiddlewareOptions, MiddlewareFactory, type MiddlewareFactoryErrorOptions, type MiddlewareFactoryOptions, type RootConfigFactoryOptions, type RootHttpRouterConfigureContext, type RootHttpRouterFactoryOptions, WinstonLogger, type WinstonLoggerOptions, authServiceFactory, cacheServiceFactory, createConfigSecretEnumerator, createHttpServer, createLifecycleMiddleware, createSpecializedBackend, databaseServiceFactory, discoveryServiceFactory, httpAuthServiceFactory, httpRouterServiceFactory, identityServiceFactory, lifecycleServiceFactory, loadBackendConfig, loggerServiceFactory, permissionsServiceFactory, readCorsOptions, readHelmetOptions, readHttpServerOptions, rootConfigServiceFactory, rootHttpRouterServiceFactory, rootLifecycleServiceFactory, rootLoggerServiceFactory, schedulerServiceFactory, tokenManagerServiceFactory, urlReaderServiceFactory, userInfoServiceFactory };