@backstage/backend-test-utils 0.1.28 → 0.1.29-next.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @backstage/backend-test-utils
 
+## 0.1.29-next.0
+
+### Patch Changes
+
+- 72549952d1: Fixed handling of root scoped services in `startTestBackend`.
+- e91e8e9c55: Increased test database max connection pool size to reduce the risk of resource exhaustion.
+- Updated dependencies
+  - @backstage/backend-app-api@0.2.2-next.0
+  - @backstage/backend-plugin-api@0.1.3-next.0
+  - @backstage/cli@0.20.0-next.0
+  - @backstage/backend-common@0.15.2-next.0
+  - @backstage/config@1.0.3-next.0
+
 ## 0.1.28
 
 ### Patch Changes

package/alpha/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backstage/backend-test-utils",
-  "version": "0.1.28",
+  "version": "0.1.29-next.0",
   "main": "../dist/index.cjs.js",
   "types": "../dist/index.alpha.d.ts"
 }

package/dist/index.cjs.js

@@ -137,6 +137,12 @@ const allDatabases = Object.freeze({
   }
 });
 
+const LARGER_POOL_CONFIG = {
+  pool: {
+    min: 0,
+    max: 50
+  }
+};
 class TestDatabases {
   static create(options) {
     const defaultOptions = {
@@ -215,6 +221,7 @@ class TestDatabases {
             new config.ConfigReader({
               backend: {
                 database: {
+                  knexConfig: properties.driver.includes("sqlite") ? {} : LARGER_POOL_CONFIG,
                   client: properties.driver,
                   connection: connectionString
                 }
@@ -248,6 +255,7 @@ class TestDatabases {
       new config.ConfigReader({
         backend: {
           database: {
+            knexConfig: LARGER_POOL_CONFIG,
             client: "pg",
             connection: { host, port, user, password }
           }
@@ -268,6 +276,7 @@ class TestDatabases {
       new config.ConfigReader({
         backend: {
           database: {
+            knexConfig: LARGER_POOL_CONFIG,
             client: "mysql2",
             connection: { host, port, user, password }
           }
@@ -328,10 +337,18 @@ async function startTestBackend(options) {
   } = options;
   const factories = services.map((serviceDef) => {
     if (Array.isArray(serviceDef)) {
+      const [ref, impl] = serviceDef;
+      if (ref.scope === "plugin") {
+        return backendPluginApi.createServiceFactory({
+          service: ref,
+          deps: {},
+          factory: async () => async () => impl
+        });
+      }
       return backendPluginApi.createServiceFactory({
-        service: serviceDef[0],
+        service: ref,
         deps: {},
-        factory: async () => async () => serviceDef[1]
+        factory: async () => impl
       });
     }
     return serviceDef;

package/dist/index.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs.js","sources":["../src/util/isDockerDisabledForTests.ts","../src/database/startMysqlContainer.ts","../src/database/startPostgresContainer.ts","../src/database/types.ts","../src/database/TestDatabases.ts","../src/msw/setupRequestMockHandlers.ts","../src/next/wiring/TestBackend.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\n/** @public */\nexport function isDockerDisabledForTests() {\n  // If we are not running in continuous integration, the default is to skip\n  // the (relatively heavy, long running) docker based tests. If you want to\n  // still run local tests for all databases, just pass either the CI=1 env\n  // parameter to your test runner, or individual connection strings per\n  // database.\n  return (\n    Boolean(process.env.BACKSTAGE_TEST_DISABLE_DOCKER) ||\n    !Boolean(process.env.CI)\n  );\n}\n","/*\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 createConnection, { Knex } from 'knex';\nimport { v4 as uuid } from 'uuid';\n\nasync function waitForMysqlReady(\n  connection: Knex.MySqlConnectionConfig,\n): Promise<void> {\n  const startTime = Date.now();\n  const db = createConnection({ client: 'mysql2', connection });\n\n  try {\n    for (;;) {\n      try {\n        const result = await db.select(db.raw('version() AS version'));\n        if (result[0]?.version) {\n          return;\n        }\n      } catch (e) {\n        if (Date.now() - startTime > 30_000) {\n          throw new Error(\n            `Timed out waiting for the database to be ready for connections, ${e}`,\n          );\n        }\n      }\n\n      await new Promise(resolve => setTimeout(resolve, 100));\n    }\n  } finally {\n    db.destroy();\n  }\n}\n\nexport async function startMysqlContainer(image: string) {\n  const user = 'root';\n  const password = uuid();\n\n  // Lazy-load to avoid side-effect of importing testcontainers\n  const { GenericContainer } = await import('testcontainers');\n\n  const container = await new GenericContainer(image)\n    .withExposedPorts(3306)\n    .withEnv('MYSQL_ROOT_PASSWORD', password)\n    .withTmpFs({ '/var/lib/mysql': 'rw' })\n    .start();\n\n  const host = container.getHost();\n  const port = container.getMappedPort(3306);\n  const stop = async () => {\n    await container.stop({ timeout: 10_000 });\n  };\n\n  await waitForMysqlReady({ host, port, user, password });\n\n  return { host, port, user, password, stop };\n}\n","/*\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 createConnection, { Knex } from 'knex';\nimport { v4 as uuid } from 'uuid';\n\nasync function waitForPostgresReady(\n  connection: Knex.PgConnectionConfig,\n): Promise<void> {\n  const startTime = Date.now();\n  const db = createConnection({ client: 'pg', connection });\n\n  try {\n    for (;;) {\n      try {\n        const result = await db.select(db.raw('version()'));\n        if (Array.isArray(result) && result[0]?.version) {\n          return;\n        }\n      } catch (e) {\n        if (Date.now() - startTime > 30_000) {\n          throw new Error(\n            `Timed out waiting for the database to be ready for connections, ${e}`,\n          );\n        }\n      }\n\n      await new Promise(resolve => setTimeout(resolve, 100));\n    }\n  } finally {\n    db.destroy();\n  }\n}\n\nexport async function startPostgresContainer(image: string) {\n  const user = 'postgres';\n  const password = uuid();\n\n  // Lazy-load to avoid side-effect of importing testcontainers\n  const { GenericContainer } = await import('testcontainers');\n\n  const container = await new GenericContainer(image)\n    .withExposedPorts(5432)\n    .withEnv('POSTGRES_PASSWORD', password)\n    .withTmpFs({ '/var/lib/postgresql/data': 'rw' })\n    .start();\n\n  const host = container.getHost();\n  const port = container.getMappedPort(5432);\n  const stop = async () => {\n    await container.stop({ timeout: 10_000 });\n  };\n\n  await waitForPostgresReady({ host, port, user, password });\n\n  return { host, port, user, password, stop };\n}\n","/*\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 { DatabaseManager } from '@backstage/backend-common';\nimport { Knex } from 'knex';\n\n/**\n * The possible databases to test against.\n *\n * @public\n */\nexport type TestDatabaseId =\n  | 'POSTGRES_13'\n  | 'POSTGRES_9'\n  | 'MYSQL_8'\n  | 'SQLITE_3';\n\nexport type TestDatabaseProperties = {\n  name: string;\n  driver: string;\n  dockerImageName?: string;\n  connectionStringEnvironmentVariableName?: string;\n};\n\nexport type Instance = {\n  stopContainer?: () => Promise<void>;\n  databaseManager: DatabaseManager;\n  connections: Array<Knex>;\n};\n\nexport const allDatabases: Record<TestDatabaseId, TestDatabaseProperties> =\n  Object.freeze({\n    POSTGRES_13: {\n      name: 'Postgres 13.x',\n      driver: 'pg',\n      dockerImageName: 'postgres:13',\n      connectionStringEnvironmentVariableName:\n        'BACKSTAGE_TEST_DATABASE_POSTGRES13_CONNECTION_STRING',\n    },\n    POSTGRES_9: {\n      name: 'Postgres 9.x',\n      driver: 'pg',\n      dockerImageName: 'postgres:9',\n      connectionStringEnvironmentVariableName:\n        'BACKSTAGE_TEST_DATABASE_POSTGRES9_CONNECTION_STRING',\n    },\n    MYSQL_8: {\n      name: 'MySQL 8.x',\n      driver: 'mysql2',\n      dockerImageName: 'mysql:8',\n      connectionStringEnvironmentVariableName:\n        'BACKSTAGE_TEST_DATABASE_MYSQL8_CONNECTION_STRING',\n    },\n    SQLITE_3: {\n      name: 'SQLite 3.x',\n      driver: 'better-sqlite3',\n    },\n  });\n","/*\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 { DatabaseManager } from '@backstage/backend-common';\nimport { ConfigReader } from '@backstage/config';\nimport { randomBytes } from 'crypto';\nimport { Knex } from 'knex';\nimport { isDockerDisabledForTests } from '../util/isDockerDisabledForTests';\nimport { startMysqlContainer } from './startMysqlContainer';\nimport { startPostgresContainer } from './startPostgresContainer';\nimport {\n  allDatabases,\n  Instance,\n  TestDatabaseId,\n  TestDatabaseProperties,\n} from './types';\n\n/**\n * Encapsulates the creation of ephemeral test database instances for use\n * inside unit or integration tests.\n *\n * @public\n */\nexport class TestDatabases {\n  private readonly instanceById: Map<string, Instance>;\n  private readonly supportedIds: TestDatabaseId[];\n\n  /**\n   * Creates an empty `TestDatabases` instance, and sets up Jest to clean up\n   * all of its acquired resources after all tests finish.\n   *\n   * You typically want to create just a single instance like this at the top\n   * of your test file or `describe` block, and then call `init` many times on\n   * that instance inside the individual tests. Spinning up a \"physical\"\n   * database instance takes a considerable amount of time, slowing down tests.\n   * But initializing a new logical database inside that instance using `init`\n   * is very fast.\n   */\n  static create(options?: {\n    ids?: TestDatabaseId[];\n    disableDocker?: boolean;\n  }): TestDatabases {\n    const defaultOptions = {\n      ids: Object.keys(allDatabases) as TestDatabaseId[],\n      disableDocker: isDockerDisabledForTests(),\n    };\n\n    const { ids, disableDocker } = Object.assign(\n      {},\n      defaultOptions,\n      options ?? {},\n    );\n\n    const supportedIds = ids.filter(id => {\n      const properties = allDatabases[id];\n      if (!properties) {\n        return false;\n      }\n      // If the caller has set up the env with an explicit connection string,\n      // we'll assume that this database will work\n      if (\n        properties.connectionStringEnvironmentVariableName &&\n        process.env[properties.connectionStringEnvironmentVariableName]\n      ) {\n        return true;\n      }\n      // If the database doesn't require docker at all, there's nothing to worry\n      // about\n      if (!properties.dockerImageName) {\n        return true;\n      }\n      // If the database requires docker, but docker is disabled, we will fail.\n      if (disableDocker) {\n        return false;\n      }\n      return true;\n    });\n\n    const databases = new TestDatabases(supportedIds);\n\n    if (supportedIds.length > 0) {\n      afterAll(async () => {\n        await databases.shutdown();\n      });\n    }\n\n    return databases;\n  }\n\n  private constructor(supportedIds: TestDatabaseId[]) {\n    this.instanceById = new Map();\n    this.supportedIds = supportedIds;\n  }\n\n  supports(id: TestDatabaseId): boolean {\n    return this.supportedIds.includes(id);\n  }\n\n  eachSupportedId(): [TestDatabaseId][] {\n    return this.supportedIds.map(id => [id]);\n  }\n\n  /**\n   * Returns a fresh, unique, empty logical database on an instance of the\n   * given database ID platform.\n   *\n   * @param id - The ID of the database platform to use, e.g. 'POSTGRES_13'\n   * @returns A `Knex` connection object\n   */\n  async init(id: TestDatabaseId): Promise<Knex> {\n    const properties = allDatabases[id];\n    if (!properties) {\n      const candidates = Object.keys(allDatabases).join(', ');\n      throw new Error(\n        `Unknown test database ${id}, possible values are ${candidates}`,\n      );\n    }\n    if (!this.supportedIds.includes(id)) {\n      const candidates = this.supportedIds.join(', ');\n      throw new Error(\n        `Unsupported test database ${id} for this environment, possible values are ${candidates}`,\n      );\n    }\n\n    let instance: Instance | undefined = this.instanceById.get(id);\n\n    // Ensure that a testcontainers instance is up for this ID\n    if (!instance) {\n      instance = await this.initAny(properties);\n      this.instanceById.set(id, instance);\n    }\n\n    // Ensure that a unique logical database is created in the instance\n    const connection = await instance.databaseManager\n      .forPlugin(`db${randomBytes(16).toString('hex')}`)\n      .getClient();\n\n    instance.connections.push(connection);\n\n    return connection;\n  }\n\n  private async initAny(properties: TestDatabaseProperties): Promise<Instance> {\n    // Use the connection string if provided\n    if (properties.driver === 'pg' || properties.driver === 'mysql2') {\n      const envVarName = properties.connectionStringEnvironmentVariableName;\n      if (envVarName) {\n        const connectionString = process.env[envVarName];\n        if (connectionString) {\n          const databaseManager = DatabaseManager.fromConfig(\n            new ConfigReader({\n              backend: {\n                database: {\n                  client: properties.driver,\n                  connection: connectionString,\n                },\n              },\n            }),\n          );\n          return {\n            databaseManager,\n            connections: [],\n          };\n        }\n      }\n    }\n\n    // Otherwise start a container for the purpose\n    switch (properties.driver) {\n      case 'pg':\n        return this.initPostgres(properties);\n      case 'mysql2':\n        return this.initMysql(properties);\n      case 'better-sqlite3':\n      case 'sqlite3':\n        return this.initSqlite(properties);\n      default:\n        throw new Error(`Unknown database driver ${properties.driver}`);\n    }\n  }\n\n  private async initPostgres(\n    properties: TestDatabaseProperties,\n  ): Promise<Instance> {\n    const { host, port, user, password, stop } = await startPostgresContainer(\n      properties.dockerImageName!,\n    );\n\n    const databaseManager = DatabaseManager.fromConfig(\n      new ConfigReader({\n        backend: {\n          database: {\n            client: 'pg',\n            connection: { host, port, user, password },\n          },\n        },\n      }),\n    );\n\n    return {\n      stopContainer: stop,\n      databaseManager,\n      connections: [],\n    };\n  }\n\n  private async initMysql(\n    properties: TestDatabaseProperties,\n  ): Promise<Instance> {\n    const { host, port, user, password, stop } = await startMysqlContainer(\n      properties.dockerImageName!,\n    );\n\n    const databaseManager = DatabaseManager.fromConfig(\n      new ConfigReader({\n        backend: {\n          database: {\n            client: 'mysql2',\n            connection: { host, port, user, password },\n          },\n        },\n      }),\n    );\n\n    return {\n      stopContainer: stop,\n      databaseManager,\n      connections: [],\n    };\n  }\n\n  private async initSqlite(\n    properties: TestDatabaseProperties,\n  ): Promise<Instance> {\n    const databaseManager = DatabaseManager.fromConfig(\n      new ConfigReader({\n        backend: {\n          database: {\n            client: properties.driver,\n            connection: ':memory:',\n          },\n        },\n      }),\n    );\n\n    return {\n      databaseManager,\n      connections: [],\n    };\n  }\n\n  private async shutdown() {\n    const instances = [...this.instanceById.values()];\n    await Promise.all(\n      instances.map(async ({ stopContainer, connections }) => {\n        try {\n          await Promise.all(connections.map(c => c.destroy()));\n        } catch {\n          // ignore\n        }\n        try {\n          await stopContainer?.();\n        } catch {\n          // ignore\n        }\n      }),\n    );\n  }\n}\n","/*\n * Copyright 2020 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\n/**\n * Sets up handlers for request mocking\n * @public\n * @param worker - service worker\n */\nexport function setupRequestMockHandlers(worker: {\n  listen: (t: any) => void;\n  close: () => void;\n  resetHandlers: () => void;\n}) {\n  beforeAll(() => worker.listen({ onUnhandledRequest: 'error' }));\n  afterAll(() => worker.close());\n  afterEach(() => worker.resetHandlers());\n}\n","/*\n * Copyright 2022 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 { createSpecializedBackend } from '@backstage/backend-app-api';\nimport {\n  ServiceFactory,\n  ServiceRef,\n  createServiceFactory,\n  BackendFeature,\n  ExtensionPoint,\n} from '@backstage/backend-plugin-api';\n\n/** @alpha */\nexport interface TestBackendOptions<\n  TServices extends any[],\n  TExtensionPoints extends any[],\n> {\n  services?: readonly [\n    ...{\n      [index in keyof TServices]:\n        | ServiceFactory<TServices[index]>\n        | (() => ServiceFactory<TServices[index]>)\n        | [ServiceRef<TServices[index]>, Partial<TServices[index]>];\n    },\n  ];\n  extensionPoints?: readonly [\n    ...{\n      [index in keyof TExtensionPoints]: [\n        ExtensionPoint<TExtensionPoints[index]>,\n        Partial<TExtensionPoints[index]>,\n      ];\n    },\n  ];\n  features?: BackendFeature[];\n}\n\n/** @alpha */\nexport async function startTestBackend<\n  TServices extends any[],\n  TExtensionPoints extends any[],\n>(options: TestBackendOptions<TServices, TExtensionPoints>): Promise<void> {\n  const {\n    services = [],\n    extensionPoints = [],\n    features = [],\n    ...otherOptions\n  } = options;\n\n  const factories = services.map(serviceDef => {\n    if (Array.isArray(serviceDef)) {\n      // if type is ExtensionPoint?\n      // do something differently?\n      return createServiceFactory({\n        service: serviceDef[0],\n        deps: {},\n        factory: async () => async () => serviceDef[1],\n      });\n    }\n    return serviceDef as ServiceFactory;\n  });\n\n  const backend = createSpecializedBackend({\n    ...otherOptions,\n    services: factories,\n  });\n\n  backend.add({\n    id: `---test-extension-point-registrar`,\n    register(reg) {\n      for (const [ref, impl] of extensionPoints) {\n        reg.registerExtensionPoint(ref, impl);\n      }\n\n      reg.registerInit({ deps: {}, async init() {} });\n    },\n  });\n\n  for (const feature of features) {\n    backend.add(feature);\n  }\n\n  await backend.start();\n}\n"],"names":["createConnection","uuid","randomBytes","DatabaseManager","ConfigReader","createServiceFactory","createSpecializedBackend"],"mappings":"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"}
+{"version":3,"file":"index.cjs.js","sources":["../src/util/isDockerDisabledForTests.ts","../src/database/startMysqlContainer.ts","../src/database/startPostgresContainer.ts","../src/database/types.ts","../src/database/TestDatabases.ts","../src/msw/setupRequestMockHandlers.ts","../src/next/wiring/TestBackend.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\n/** @public */\nexport function isDockerDisabledForTests() {\n  // If we are not running in continuous integration, the default is to skip\n  // the (relatively heavy, long running) docker based tests. If you want to\n  // still run local tests for all databases, just pass either the CI=1 env\n  // parameter to your test runner, or individual connection strings per\n  // database.\n  return (\n    Boolean(process.env.BACKSTAGE_TEST_DISABLE_DOCKER) ||\n    !Boolean(process.env.CI)\n  );\n}\n","/*\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 createConnection, { Knex } from 'knex';\nimport { v4 as uuid } from 'uuid';\n\nasync function waitForMysqlReady(\n  connection: Knex.MySqlConnectionConfig,\n): Promise<void> {\n  const startTime = Date.now();\n  const db = createConnection({ client: 'mysql2', connection });\n\n  try {\n    for (;;) {\n      try {\n        const result = await db.select(db.raw('version() AS version'));\n        if (result[0]?.version) {\n          return;\n        }\n      } catch (e) {\n        if (Date.now() - startTime > 30_000) {\n          throw new Error(\n            `Timed out waiting for the database to be ready for connections, ${e}`,\n          );\n        }\n      }\n\n      await new Promise(resolve => setTimeout(resolve, 100));\n    }\n  } finally {\n    db.destroy();\n  }\n}\n\nexport async function startMysqlContainer(image: string) {\n  const user = 'root';\n  const password = uuid();\n\n  // Lazy-load to avoid side-effect of importing testcontainers\n  const { GenericContainer } = await import('testcontainers');\n\n  const container = await new GenericContainer(image)\n    .withExposedPorts(3306)\n    .withEnv('MYSQL_ROOT_PASSWORD', password)\n    .withTmpFs({ '/var/lib/mysql': 'rw' })\n    .start();\n\n  const host = container.getHost();\n  const port = container.getMappedPort(3306);\n  const stop = async () => {\n    await container.stop({ timeout: 10_000 });\n  };\n\n  await waitForMysqlReady({ host, port, user, password });\n\n  return { host, port, user, password, stop };\n}\n","/*\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 createConnection, { Knex } from 'knex';\nimport { v4 as uuid } from 'uuid';\n\nasync function waitForPostgresReady(\n  connection: Knex.PgConnectionConfig,\n): Promise<void> {\n  const startTime = Date.now();\n  const db = createConnection({ client: 'pg', connection });\n\n  try {\n    for (;;) {\n      try {\n        const result = await db.select(db.raw('version()'));\n        if (Array.isArray(result) && result[0]?.version) {\n          return;\n        }\n      } catch (e) {\n        if (Date.now() - startTime > 30_000) {\n          throw new Error(\n            `Timed out waiting for the database to be ready for connections, ${e}`,\n          );\n        }\n      }\n\n      await new Promise(resolve => setTimeout(resolve, 100));\n    }\n  } finally {\n    db.destroy();\n  }\n}\n\nexport async function startPostgresContainer(image: string) {\n  const user = 'postgres';\n  const password = uuid();\n\n  // Lazy-load to avoid side-effect of importing testcontainers\n  const { GenericContainer } = await import('testcontainers');\n\n  const container = await new GenericContainer(image)\n    .withExposedPorts(5432)\n    .withEnv('POSTGRES_PASSWORD', password)\n    .withTmpFs({ '/var/lib/postgresql/data': 'rw' })\n    .start();\n\n  const host = container.getHost();\n  const port = container.getMappedPort(5432);\n  const stop = async () => {\n    await container.stop({ timeout: 10_000 });\n  };\n\n  await waitForPostgresReady({ host, port, user, password });\n\n  return { host, port, user, password, stop };\n}\n","/*\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 { DatabaseManager } from '@backstage/backend-common';\nimport { Knex } from 'knex';\n\n/**\n * The possible databases to test against.\n *\n * @public\n */\nexport type TestDatabaseId =\n  | 'POSTGRES_13'\n  | 'POSTGRES_9'\n  | 'MYSQL_8'\n  | 'SQLITE_3';\n\nexport type TestDatabaseProperties = {\n  name: string;\n  driver: string;\n  dockerImageName?: string;\n  connectionStringEnvironmentVariableName?: string;\n};\n\nexport type Instance = {\n  stopContainer?: () => Promise<void>;\n  databaseManager: DatabaseManager;\n  connections: Array<Knex>;\n};\n\nexport const allDatabases: Record<TestDatabaseId, TestDatabaseProperties> =\n  Object.freeze({\n    POSTGRES_13: {\n      name: 'Postgres 13.x',\n      driver: 'pg',\n      dockerImageName: 'postgres:13',\n      connectionStringEnvironmentVariableName:\n        'BACKSTAGE_TEST_DATABASE_POSTGRES13_CONNECTION_STRING',\n    },\n    POSTGRES_9: {\n      name: 'Postgres 9.x',\n      driver: 'pg',\n      dockerImageName: 'postgres:9',\n      connectionStringEnvironmentVariableName:\n        'BACKSTAGE_TEST_DATABASE_POSTGRES9_CONNECTION_STRING',\n    },\n    MYSQL_8: {\n      name: 'MySQL 8.x',\n      driver: 'mysql2',\n      dockerImageName: 'mysql:8',\n      connectionStringEnvironmentVariableName:\n        'BACKSTAGE_TEST_DATABASE_MYSQL8_CONNECTION_STRING',\n    },\n    SQLITE_3: {\n      name: 'SQLite 3.x',\n      driver: 'better-sqlite3',\n    },\n  });\n","/*\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 { DatabaseManager } from '@backstage/backend-common';\nimport { ConfigReader } from '@backstage/config';\nimport { randomBytes } from 'crypto';\nimport { Knex } from 'knex';\nimport { isDockerDisabledForTests } from '../util/isDockerDisabledForTests';\nimport { startMysqlContainer } from './startMysqlContainer';\nimport { startPostgresContainer } from './startPostgresContainer';\nimport {\n  allDatabases,\n  Instance,\n  TestDatabaseId,\n  TestDatabaseProperties,\n} from './types';\n\nconst LARGER_POOL_CONFIG = {\n  pool: {\n    min: 0,\n    max: 50,\n  },\n};\n\n/**\n * Encapsulates the creation of ephemeral test database instances for use\n * inside unit or integration tests.\n *\n * @public\n */\nexport class TestDatabases {\n  private readonly instanceById: Map<string, Instance>;\n  private readonly supportedIds: TestDatabaseId[];\n\n  /**\n   * Creates an empty `TestDatabases` instance, and sets up Jest to clean up\n   * all of its acquired resources after all tests finish.\n   *\n   * You typically want to create just a single instance like this at the top\n   * of your test file or `describe` block, and then call `init` many times on\n   * that instance inside the individual tests. Spinning up a \"physical\"\n   * database instance takes a considerable amount of time, slowing down tests.\n   * But initializing a new logical database inside that instance using `init`\n   * is very fast.\n   */\n  static create(options?: {\n    ids?: TestDatabaseId[];\n    disableDocker?: boolean;\n  }): TestDatabases {\n    const defaultOptions = {\n      ids: Object.keys(allDatabases) as TestDatabaseId[],\n      disableDocker: isDockerDisabledForTests(),\n    };\n\n    const { ids, disableDocker } = Object.assign(\n      {},\n      defaultOptions,\n      options ?? {},\n    );\n\n    const supportedIds = ids.filter(id => {\n      const properties = allDatabases[id];\n      if (!properties) {\n        return false;\n      }\n      // If the caller has set up the env with an explicit connection string,\n      // we'll assume that this database will work\n      if (\n        properties.connectionStringEnvironmentVariableName &&\n        process.env[properties.connectionStringEnvironmentVariableName]\n      ) {\n        return true;\n      }\n      // If the database doesn't require docker at all, there's nothing to worry\n      // about\n      if (!properties.dockerImageName) {\n        return true;\n      }\n      // If the database requires docker, but docker is disabled, we will fail.\n      if (disableDocker) {\n        return false;\n      }\n      return true;\n    });\n\n    const databases = new TestDatabases(supportedIds);\n\n    if (supportedIds.length > 0) {\n      afterAll(async () => {\n        await databases.shutdown();\n      });\n    }\n\n    return databases;\n  }\n\n  private constructor(supportedIds: TestDatabaseId[]) {\n    this.instanceById = new Map();\n    this.supportedIds = supportedIds;\n  }\n\n  supports(id: TestDatabaseId): boolean {\n    return this.supportedIds.includes(id);\n  }\n\n  eachSupportedId(): [TestDatabaseId][] {\n    return this.supportedIds.map(id => [id]);\n  }\n\n  /**\n   * Returns a fresh, unique, empty logical database on an instance of the\n   * given database ID platform.\n   *\n   * @param id - The ID of the database platform to use, e.g. 'POSTGRES_13'\n   * @returns A `Knex` connection object\n   */\n  async init(id: TestDatabaseId): Promise<Knex> {\n    const properties = allDatabases[id];\n    if (!properties) {\n      const candidates = Object.keys(allDatabases).join(', ');\n      throw new Error(\n        `Unknown test database ${id}, possible values are ${candidates}`,\n      );\n    }\n    if (!this.supportedIds.includes(id)) {\n      const candidates = this.supportedIds.join(', ');\n      throw new Error(\n        `Unsupported test database ${id} for this environment, possible values are ${candidates}`,\n      );\n    }\n\n    let instance: Instance | undefined = this.instanceById.get(id);\n\n    // Ensure that a testcontainers instance is up for this ID\n    if (!instance) {\n      instance = await this.initAny(properties);\n      this.instanceById.set(id, instance);\n    }\n\n    // Ensure that a unique logical database is created in the instance\n    const connection = await instance.databaseManager\n      .forPlugin(`db${randomBytes(16).toString('hex')}`)\n      .getClient();\n\n    instance.connections.push(connection);\n\n    return connection;\n  }\n\n  private async initAny(properties: TestDatabaseProperties): Promise<Instance> {\n    // Use the connection string if provided\n    if (properties.driver === 'pg' || properties.driver === 'mysql2') {\n      const envVarName = properties.connectionStringEnvironmentVariableName;\n      if (envVarName) {\n        const connectionString = process.env[envVarName];\n        if (connectionString) {\n          const databaseManager = DatabaseManager.fromConfig(\n            new ConfigReader({\n              backend: {\n                database: {\n                  knexConfig: properties.driver.includes('sqlite')\n                    ? {}\n                    : LARGER_POOL_CONFIG,\n                  client: properties.driver,\n                  connection: connectionString,\n                },\n              },\n            }),\n          );\n          return {\n            databaseManager,\n            connections: [],\n          };\n        }\n      }\n    }\n\n    // Otherwise start a container for the purpose\n    switch (properties.driver) {\n      case 'pg':\n        return this.initPostgres(properties);\n      case 'mysql2':\n        return this.initMysql(properties);\n      case 'better-sqlite3':\n      case 'sqlite3':\n        return this.initSqlite(properties);\n      default:\n        throw new Error(`Unknown database driver ${properties.driver}`);\n    }\n  }\n\n  private async initPostgres(\n    properties: TestDatabaseProperties,\n  ): Promise<Instance> {\n    const { host, port, user, password, stop } = await startPostgresContainer(\n      properties.dockerImageName!,\n    );\n\n    const databaseManager = DatabaseManager.fromConfig(\n      new ConfigReader({\n        backend: {\n          database: {\n            knexConfig: LARGER_POOL_CONFIG,\n            client: 'pg',\n            connection: { host, port, user, password },\n          },\n        },\n      }),\n    );\n\n    return {\n      stopContainer: stop,\n      databaseManager,\n      connections: [],\n    };\n  }\n\n  private async initMysql(\n    properties: TestDatabaseProperties,\n  ): Promise<Instance> {\n    const { host, port, user, password, stop } = await startMysqlContainer(\n      properties.dockerImageName!,\n    );\n\n    const databaseManager = DatabaseManager.fromConfig(\n      new ConfigReader({\n        backend: {\n          database: {\n            knexConfig: LARGER_POOL_CONFIG,\n            client: 'mysql2',\n            connection: { host, port, user, password },\n          },\n        },\n      }),\n    );\n\n    return {\n      stopContainer: stop,\n      databaseManager,\n      connections: [],\n    };\n  }\n\n  private async initSqlite(\n    properties: TestDatabaseProperties,\n  ): Promise<Instance> {\n    const databaseManager = DatabaseManager.fromConfig(\n      new ConfigReader({\n        backend: {\n          database: {\n            client: properties.driver,\n            connection: ':memory:',\n          },\n        },\n      }),\n    );\n\n    return {\n      databaseManager,\n      connections: [],\n    };\n  }\n\n  private async shutdown() {\n    const instances = [...this.instanceById.values()];\n    await Promise.all(\n      instances.map(async ({ stopContainer, connections }) => {\n        try {\n          await Promise.all(connections.map(c => c.destroy()));\n        } catch {\n          // ignore\n        }\n        try {\n          await stopContainer?.();\n        } catch {\n          // ignore\n        }\n      }),\n    );\n  }\n}\n","/*\n * Copyright 2020 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\n/**\n * Sets up handlers for request mocking\n * @public\n * @param worker - service worker\n */\nexport function setupRequestMockHandlers(worker: {\n  listen: (t: any) => void;\n  close: () => void;\n  resetHandlers: () => void;\n}) {\n  beforeAll(() => worker.listen({ onUnhandledRequest: 'error' }));\n  afterAll(() => worker.close());\n  afterEach(() => worker.resetHandlers());\n}\n","/*\n * Copyright 2022 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 { createSpecializedBackend } from '@backstage/backend-app-api';\nimport {\n  ServiceFactory,\n  ServiceRef,\n  createServiceFactory,\n  BackendFeature,\n  ExtensionPoint,\n} from '@backstage/backend-plugin-api';\n\n/** @alpha */\nexport interface TestBackendOptions<\n  TServices extends any[],\n  TExtensionPoints extends any[],\n> {\n  services?: readonly [\n    ...{\n      [index in keyof TServices]:\n        | ServiceFactory<TServices[index]>\n        | (() => ServiceFactory<TServices[index]>)\n        | [ServiceRef<TServices[index]>, Partial<TServices[index]>];\n    },\n  ];\n  extensionPoints?: readonly [\n    ...{\n      [index in keyof TExtensionPoints]: [\n        ExtensionPoint<TExtensionPoints[index]>,\n        Partial<TExtensionPoints[index]>,\n      ];\n    },\n  ];\n  features?: BackendFeature[];\n}\n\n/** @alpha */\nexport async function startTestBackend<\n  TServices extends any[],\n  TExtensionPoints extends any[],\n>(options: TestBackendOptions<TServices, TExtensionPoints>): Promise<void> {\n  const {\n    services = [],\n    extensionPoints = [],\n    features = [],\n    ...otherOptions\n  } = options;\n\n  const factories = services.map(serviceDef => {\n    if (Array.isArray(serviceDef)) {\n      // if type is ExtensionPoint?\n      // do something differently?\n      const [ref, impl] = serviceDef;\n      if (ref.scope === 'plugin') {\n        return createServiceFactory({\n          service: ref,\n          deps: {},\n          factory: async () => async () => impl,\n        });\n      }\n      return createServiceFactory({\n        service: ref,\n        deps: {},\n        factory: async () => impl,\n      });\n    }\n    return serviceDef as ServiceFactory;\n  });\n\n  const backend = createSpecializedBackend({\n    ...otherOptions,\n    services: factories,\n  });\n\n  backend.add({\n    id: `---test-extension-point-registrar`,\n    register(reg) {\n      for (const [ref, impl] of extensionPoints) {\n        reg.registerExtensionPoint(ref, impl);\n      }\n\n      reg.registerInit({ deps: {}, async init() {} });\n    },\n  });\n\n  for (const feature of features) {\n    backend.add(feature);\n  }\n\n  await backend.start();\n}\n"],"names":["createConnection","uuid","randomBytes","DatabaseManager","ConfigReader","createServiceFactory","createSpecializedBackend"],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@backstage/backend-test-utils",
   "description": "Test helpers library for Backstage backends",
-  "version": "0.1.28",
+  "version": "0.1.29-next.0",
   "main": "dist/index.cjs.js",
   "types": "dist/index.d.ts",
   "publishConfig": {
@@ -34,11 +34,11 @@
     "start": "backstage-cli package start"
   },
   "dependencies": {
-    "@backstage/backend-app-api": "^0.2.1",
-    "@backstage/backend-common": "^0.15.1",
-    "@backstage/backend-plugin-api": "^0.1.2",
-    "@backstage/cli": "^0.19.0",
-    "@backstage/config": "^1.0.2",
+    "@backstage/backend-app-api": "^0.2.2-next.0",
+    "@backstage/backend-common": "^0.15.2-next.0",
+    "@backstage/backend-plugin-api": "^0.1.3-next.0",
+    "@backstage/cli": "^0.20.0-next.0",
+    "@backstage/config": "^1.0.3-next.0",
     "better-sqlite3": "^7.5.0",
     "knex": "^2.0.0",
     "msw": "^0.47.0",
@@ -48,11 +48,10 @@
     "uuid": "^8.0.0"
   },
   "devDependencies": {
-    "@backstage/cli": "^0.19.0"
+    "@backstage/cli": "^0.20.0-next.0"
   },
   "files": [
     "dist",
     "alpha"
-  ],
-  "gitHead": "25b94e63455f1fb170506f9e84e3f430f4b79406"
-}
+  ]
+}

package/LICENSE

@@ -1,201 +0,0 @@
-                              Apache License
-                        Version 2.0, January 2004
-                     http://www.apache.org/licenses/
-
-TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-1. Definitions.
-
-   "License" shall mean the terms and conditions for use, reproduction,
-   and distribution as defined by Sections 1 through 9 of this document.
-
-   "Licensor" shall mean the copyright owner or entity authorized by
-   the copyright owner that is granting the License.
-
-   "Legal Entity" shall mean the union of the acting entity and all
-   other entities that control, are controlled by, or are under common
-   control with that entity. For the purposes of this definition,
-   "control" means (i) the power, direct or indirect, to cause the
-   direction or management of such entity, whether by contract or
-   otherwise, or (ii) ownership of fifty percent (50%) or more of the
-   outstanding shares, or (iii) beneficial ownership of such entity.
-
-   "You" (or "Your") shall mean an individual or Legal Entity
-   exercising permissions granted by this License.
-
-   "Source" form shall mean the preferred form for making modifications,
-   including but not limited to software source code, documentation
-   source, and configuration files.
-
-   "Object" form shall mean any form resulting from mechanical
-   transformation or translation of a Source form, including but
-   not limited to compiled object code, generated documentation,
-   and conversions to other media types.
-
-   "Work" shall mean the work of authorship, whether in Source or
-   Object form, made available under the License, as indicated by a
-   copyright notice that is included in or attached to the work
-   (an example is provided in the Appendix below).
-
-   "Derivative Works" shall mean any work, whether in Source or Object
-   form, that is based on (or derived from) the Work and for which the
-   editorial revisions, annotations, elaborations, or other modifications
-   represent, as a whole, an original work of authorship. For the purposes
-   of this License, Derivative Works shall not include works that remain
-   separable from, or merely link (or bind by name) to the interfaces of,
-   the Work and Derivative Works thereof.
-
-   "Contribution" shall mean any work of authorship, including
-   the original version of the Work and any modifications or additions
-   to that Work or Derivative Works thereof, that is intentionally
-   submitted to Licensor for inclusion in the Work by the copyright owner
-   or by an individual or Legal Entity authorized to submit on behalf of
-   the copyright owner. For the purposes of this definition, "submitted"
-   means any form of electronic, verbal, or written communication sent
-   to the Licensor or its representatives, including but not limited to
-   communication on electronic mailing lists, source code control systems,
-   and issue tracking systems that are managed by, or on behalf of, the
-   Licensor for the purpose of discussing and improving the Work, but
-   excluding communication that is conspicuously marked or otherwise
-   designated in writing by the copyright owner as "Not a Contribution."
-
-   "Contributor" shall mean Licensor and any individual or Legal Entity
-   on behalf of whom a Contribution has been received by Licensor and
-   subsequently incorporated within the Work.
-
-2. Grant of Copyright License. Subject to the terms and conditions of
-   this License, each Contributor hereby grants to You a perpetual,
-   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-   copyright license to reproduce, prepare Derivative Works of,
-   publicly display, publicly perform, sublicense, and distribute the
-   Work and such Derivative Works in Source or Object form.
-
-3. Grant of Patent License. Subject to the terms and conditions of
-   this License, each Contributor hereby grants to You a perpetual,
-   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-   (except as stated in this section) patent license to make, have made,
-   use, offer to sell, sell, import, and otherwise transfer the Work,
-   where such license applies only to those patent claims licensable
-   by such Contributor that are necessarily infringed by their
-   Contribution(s) alone or by combination of their Contribution(s)
-   with the Work to which such Contribution(s) was submitted. If You
-   institute patent litigation against any entity (including a
-   cross-claim or counterclaim in a lawsuit) alleging that the Work
-   or a Contribution incorporated within the Work constitutes direct
-   or contributory patent infringement, then any patent licenses
-   granted to You under this License for that Work shall terminate
-   as of the date such litigation is filed.
-
-4. Redistribution. You may reproduce and distribute copies of the
-   Work or Derivative Works thereof in any medium, with or without
-   modifications, and in Source or Object form, provided that You
-   meet the following conditions:
-
-   (a) You must give any other recipients of the Work or
-       Derivative Works a copy of this License; and
-
-   (b) You must cause any modified files to carry prominent notices
-       stating that You changed the files; and
-
-   (c) You must retain, in the Source form of any Derivative Works
-       that You distribute, all copyright, patent, trademark, and
-       attribution notices from the Source form of the Work,
-       excluding those notices that do not pertain to any part of
-       the Derivative Works; and
-
-   (d) If the Work includes a "NOTICE" text file as part of its
-       distribution, then any Derivative Works that You distribute must
-       include a readable copy of the attribution notices contained
-       within such NOTICE file, excluding those notices that do not
-       pertain to any part of the Derivative Works, in at least one
-       of the following places: within a NOTICE text file distributed
-       as part of the Derivative Works; within the Source form or
-       documentation, if provided along with the Derivative Works; or,
-       within a display generated by the Derivative Works, if and
-       wherever such third-party notices normally appear. The contents
-       of the NOTICE file are for informational purposes only and
-       do not modify the License. You may add Your own attribution
-       notices within Derivative Works that You distribute, alongside
-       or as an addendum to the NOTICE text from the Work, provided
-       that such additional attribution notices cannot be construed
-       as modifying the License.
-
-   You may add Your own copyright statement to Your modifications and
-   may provide additional or different license terms and conditions
-   for use, reproduction, or distribution of Your modifications, or
-   for any such Derivative Works as a whole, provided Your use,
-   reproduction, and distribution of the Work otherwise complies with
-   the conditions stated in this License.
-
-5. Submission of Contributions. Unless You explicitly state otherwise,
-   any Contribution intentionally submitted for inclusion in the Work
-   by You to the Licensor shall be under the terms and conditions of
-   this License, without any additional terms or conditions.
-   Notwithstanding the above, nothing herein shall supersede or modify
-   the terms of any separate license agreement you may have executed
-   with Licensor regarding such Contributions.
-
-6. Trademarks. This License does not grant permission to use the trade
-   names, trademarks, service marks, or product names of the Licensor,
-   except as required for reasonable and customary use in describing the
-   origin of the Work and reproducing the content of the NOTICE file.
-
-7. Disclaimer of Warranty. Unless required by applicable law or
-   agreed to in writing, Licensor provides the Work (and each
-   Contributor provides its Contributions) on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-   implied, including, without limitation, any warranties or conditions
-   of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-   PARTICULAR PURPOSE. You are solely responsible for determining the
-   appropriateness of using or redistributing the Work and assume any
-   risks associated with Your exercise of permissions under this License.
-
-8. Limitation of Liability. In no event and under no legal theory,
-   whether in tort (including negligence), contract, or otherwise,
-   unless required by applicable law (such as deliberate and grossly
-   negligent acts) or agreed to in writing, shall any Contributor be
-   liable to You for damages, including any direct, indirect, special,
-   incidental, or consequential damages of any character arising as a
-   result of this License or out of the use or inability to use the
-   Work (including but not limited to damages for loss of goodwill,
-   work stoppage, computer failure or malfunction, or any and all
-   other commercial damages or losses), even if such Contributor
-   has been advised of the possibility of such damages.
-
-9. Accepting Warranty or Additional Liability. While redistributing
-   the Work or Derivative Works thereof, You may choose to offer,
-   and charge a fee for, acceptance of support, warranty, indemnity,
-   or other liability obligations and/or rights consistent with this
-   License. However, in accepting such obligations, You may act only
-   on Your own behalf and on Your sole responsibility, not on behalf
-   of any other Contributor, and only if You agree to indemnify,
-   defend, and hold each Contributor harmless for any liability
-   incurred by, or claims asserted against, such Contributor by reason
-   of your accepting any such warranty or additional liability.
-
-END OF TERMS AND CONDITIONS
-
-APPENDIX: How to apply the Apache License to your work.
-
-   To apply the Apache License to your work, attach the following
-   boilerplate notice, with the fields enclosed by brackets "[]"
-   replaced with your own identifying information. (Don't include
-   the brackets!)  The text should be enclosed in the appropriate
-   comment syntax for the file format. We also recommend that a
-   file or class name and description of purpose be included on the
-   same "printed page" as the copyright notice for easier
-   identification within third-party archives.
-
-Copyright 2020 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.