@backstage/backend-app-api 0.3.0-next.1 → 0.3.0

package/dist/index.d.ts

@@ -13,11 +13,16 @@ import { CorsOptions } from 'cors';
 import { ErrorRequestHandler } from 'express';
 import { Express as Express_2 } from 'express';
 import { ExtensionPoint } from '@backstage/backend-plugin-api';
+import { Format } from 'logform';
+import { Handler } from 'express';
 import { HelmetOptions } from 'helmet';
 import * as http from 'http';
 import { HttpRouterService } from '@backstage/backend-plugin-api';
+import { IdentityService } from '@backstage/backend-plugin-api';
 import { LifecycleService } from '@backstage/backend-plugin-api';
+import { LoadConfigOptionsRemote } from '@backstage/config-loader';
 import { LoggerService } from '@backstage/backend-plugin-api';
+import { LogMeta } from '@backstage/backend-plugin-api';
 import { PermissionsService } from '@backstage/backend-plugin-api';
 import { PluginCacheManager } from '@backstage/backend-common';
 import { PluginDatabaseManager } from '@backstage/backend-common';
@@ -32,6 +37,7 @@ import { ServiceFactory } from '@backstage/backend-plugin-api';
 import { ServiceFactoryOrFunction } from '@backstage/backend-plugin-api';
 import { ServiceRef } from '@backstage/backend-plugin-api';
 import { TokenManagerService } from '@backstage/backend-plugin-api';
+import { transport } from 'winston';
 import { UrlReader } from '@backstage/backend-common';
 
 /**
@@ -44,10 +50,28 @@ export declare interface Backend {
 }
 
 /** @public */
-export declare const cacheFactory: (options?: undefined) => ServiceFactory<PluginCacheManager>;
+export declare const cacheFactory: () => ServiceFactory<PluginCacheManager>;
 
 /** @public */
-export declare const configFactory: (options?: undefined) => ServiceFactory<ConfigService>;
+export declare const configFactory: () => ServiceFactory<ConfigService>;
+
+/** @public */
+export declare interface ConfigFactoryOptions {
+    /**
+     * Process arguments to use instead of the default `process.argv()`.
+     */
+    argv?: string[];
+    /**
+     * Enables and sets options for remote configuration loading.
+     */
+    remote?: LoadConfigOptionsRemote;
+}
+
+/** @public */
+export declare function createConfigSecretEnumerator(options: {
+    logger: LoggerService;
+    dir?: string;
+}): Promise<(config: Config) => Iterable<string>>;
 
 /**
  * Creates a Node.js HTTP or HTTPS server instance.
@@ -71,10 +95,37 @@ export declare interface CreateSpecializedBackendOptions {
 }
 
 /** @public */
-export declare const databaseFactory: (options?: undefined) => ServiceFactory<PluginDatabaseManager>;
+export declare const databaseFactory: () => ServiceFactory<PluginDatabaseManager>;
+
+/**
+ * The default implementation of the {@link @backstage/backend-plugin-api#RootHttpRouterService} interface for
+ * {@link @backstage/backend-plugin-api#coreServices.rootHttpRouter}.
+ *
+ * @public
+ */
+export declare class DefaultRootHttpRouter implements RootHttpRouterService {
+    #private;
+    static create(options?: DefaultRootHttpRouterOptions): DefaultRootHttpRouter;
+    private constructor();
+    use(path: string, handler: Handler): void;
+    handler(): Handler;
+}
+
+/**
+ * Options for the {@link DefaultRootHttpRouter} class.
+ *
+ * @public
+ */
+export declare interface DefaultRootHttpRouterOptions {
+    /**
+     * 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;
+}
 
 /** @public */
-export declare const discoveryFactory: (options?: undefined) => ServiceFactory<PluginEndpointDiscovery>;
+export declare const discoveryFactory: () => ServiceFactory<PluginEndpointDiscovery>;
 
 /**
  * An HTTP server extended with utility methods.
@@ -93,12 +144,12 @@ export declare const httpRouterFactory: (options?: HttpRouterFactoryOptions | un
 /**
  * @public
  */
-export declare type HttpRouterFactoryOptions = {
+export declare interface HttpRouterFactoryOptions {
     /**
      * A callback used to generate the path for each plugin, defaults to `/api/{pluginId}`.
      */
     getPath(pluginId: string): string;
-};
+}
 
 /**
  * Options for configuring HTTPS for an HTTP server.
@@ -129,13 +180,42 @@ export declare type HttpServerOptions = {
     };
 };
 
+/** @public */
+export declare const identityFactory: (options?: IdentityFactoryOptions | undefined) => ServiceFactory<IdentityService>;
+
+/**
+ * An identity client options object which allows extra configurations
+ *
+ * @public
+ */
+export declare 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[];
+};
+
 /**
  * Allows plugins to register shutdown hooks that are run when the process is about to exit.
  * @public */
-export declare const lifecycleFactory: (options?: undefined) => ServiceFactory<LifecycleService>;
+export declare const lifecycleFactory: () => ServiceFactory<LifecycleService>;
+
+/**
+ * Load configuration for a Backend.
+ *
+ * This function should only be called once, during the initialization of the backend.
+ *
+ * @public
+ */
+export declare function loadBackendConfig(options: {
+    remote?: LoadConfigOptionsRemote;
+    argv: string[];
+}): Promise<{
+    config: Config;
+}>;
 
 /** @public */
-export declare const loggerFactory: (options?: undefined) => ServiceFactory<LoggerService>;
+export declare const loggerFactory: () => ServiceFactory<LoggerService>;
 
 /**
  * A utility to configure common middleware.
@@ -261,7 +341,7 @@ export declare interface MiddlewareFactoryOptions {
 }
 
 /** @public */
-export declare const permissionsFactory: (options?: undefined) => ServiceFactory<PermissionsService>;
+export declare const permissionsFactory: () => ServiceFactory<PermissionsService>;
 
 /**
  * Attempts to read a CORS options object from the backend configuration object.
@@ -320,14 +400,15 @@ export declare interface RootHttpRouterConfigureOptions {
 }
 
 /** @public */
-export declare const rootHttpRouterFactory: (options?: RootHttpRouterFactoryOptions | undefined) => ServiceFactory<RootHttpRouterService>;
+export declare const rootHttpRouterFactory: () => ServiceFactory<RootHttpRouterService>;
 
 /**
  * @public
  */
 export declare type RootHttpRouterFactoryOptions = {
     /**
-     * The path to forward all unmatched requests to. Defaults to '/api/app'
+     * 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?(options: RootHttpRouterConfigureOptions): void;
@@ -336,13 +417,13 @@ export declare type RootHttpRouterFactoryOptions = {
 /**
  * Allows plugins to register shutdown hooks that are run when the process is about to exit.
  * @public */
-export declare const rootLifecycleFactory: (options?: undefined) => ServiceFactory<RootLifecycleService>;
+export declare const rootLifecycleFactory: () => ServiceFactory<RootLifecycleService>;
 
 /** @public */
-export declare const rootLoggerFactory: (options?: undefined) => ServiceFactory<RootLoggerService>;
+export declare const rootLoggerFactory: () => ServiceFactory<RootLoggerService>;
 
 /** @public */
-export declare const schedulerFactory: (options?: undefined) => ServiceFactory<SchedulerService>;
+export declare const schedulerFactory: () => ServiceFactory<SchedulerService>;
 
 /**
  * @public
@@ -350,9 +431,50 @@ export declare const schedulerFactory: (options?: undefined) => ServiceFactory<S
 export declare type ServiceOrExtensionPoint<T = unknown> = ExtensionPoint<T> | ServiceRef<T>;
 
 /** @public */
-export declare const tokenManagerFactory: (options?: undefined) => ServiceFactory<TokenManagerService>;
+export declare const tokenManagerFactory: () => ServiceFactory<TokenManagerService>;
 
 /** @public */
-export declare const urlReaderFactory: (options?: undefined) => ServiceFactory<UrlReader>;
+export declare const urlReaderFactory: () => ServiceFactory<UrlReader>;
+
+/**
+ * A {@link @backstage/backend-plugin-api#LoggerService} implementation based on winston.
+ *
+ * @public
+ */
+export declare class WinstonLogger implements RootLoggerService {
+    #private;
+    /**
+     * Creates a {@link WinstonLogger} instance.
+     */
+    static create(options: WinstonLoggerOptions): WinstonLogger;
+    /**
+     * Creates a winston log formatter for redacting secrets.
+     */
+    static redacter(): {
+        format: Format;
+        add: (redactions: Iterable<string>) => void;
+    };
+    /**
+     * Creates a pretty printed winston log formatter.
+     */
+    static colorFormat(): Format;
+    private constructor();
+    error(message: string, meta?: LogMeta): void;
+    warn(message: string, meta?: LogMeta): void;
+    info(message: string, meta?: LogMeta): void;
+    debug(message: string, meta?: LogMeta): void;
+    child(meta: LogMeta): LoggerService;
+    addRedactions(redactions: Iterable<string>): void;
+}
+
+/**
+ * @public
+ */
+export declare interface WinstonLoggerOptions {
+    meta?: LogMeta;
+    level: string;
+    format: Format;
+    transports: transport[];
+}
 
 export { }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@backstage/backend-app-api",
   "description": "Core API used by Backstage backend apps",
-  "version": "0.3.0-next.1",
+  "version": "0.3.0",
   "main": "dist/index.cjs.js",
   "types": "dist/index.d.ts",
   "publishConfig": {
@@ -33,12 +33,17 @@
     "start": "backstage-cli package start"
   },
   "dependencies": {
-    "@backstage/backend-common": "^0.18.0-next.1",
-    "@backstage/backend-plugin-api": "^0.3.0-next.1",
-    "@backstage/backend-tasks": "^0.4.1-next.1",
-    "@backstage/config": "^1.0.6-next.0",
+    "@backstage/backend-common": "^0.18.0",
+    "@backstage/backend-plugin-api": "^0.3.0",
+    "@backstage/backend-tasks": "^0.4.1",
+    "@backstage/cli-common": "^0.1.11",
+    "@backstage/config": "^1.0.6",
+    "@backstage/config-loader": "^1.1.8",
     "@backstage/errors": "^1.1.4",
-    "@backstage/plugin-permission-node": "^0.7.3-next.1",
+    "@backstage/plugin-auth-node": "^0.2.9",
+    "@backstage/plugin-permission-node": "^0.7.3",
+    "@backstage/types": "^1.0.2",
+    "@manypkg/get-packages": "^1.1.3",
     "@types/cors": "^2.8.6",
     "@types/express": "^4.17.6",
     "compression": "^1.7.4",
@@ -47,18 +52,23 @@
     "express-promise-router": "^4.1.0",
     "fs-extra": "10.1.0",
     "helmet": "^6.0.0",
+    "lodash": "^4.17.21",
+    "logform": "^2.3.2",
     "minimatch": "^5.0.0",
+    "minimist": "^1.2.5",
     "morgan": "^1.10.0",
     "node-forge": "^1.3.1",
     "selfsigned": "^2.0.0",
     "stoppable": "^1.1.0",
-    "winston": "^3.2.1"
+    "winston": "^3.2.1",
+    "winston-transport": "^4.5.0"
   },
   "devDependencies": {
-    "@backstage/cli": "^0.22.1-next.2",
+    "@backstage/cli": "^0.22.1",
     "@types/compression": "^1.7.0",
     "@types/fs-extra": "^9.0.3",
     "@types/http-errors": "^2.0.0",
+    "@types/minimist": "^1.2.0",
     "@types/morgan": "^1.9.0",
     "@types/node-forge": "^1.3.0",
     "@types/stoppable": "^1.1.0",