@backstage/frontend-test-utils 0.2.1-next.2 → 0.2.1

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # @backstage/frontend-test-utils
 
+## 0.2.1
+
+### Patch Changes
+
+- 666d5b1: Disable the built-in `SignInPage` in `createExtensionTester` in order to not mess with existing tests
+- e969dc7: Move `@types/react` to a peer dependency.
+- 873e424: Internal refactor of usage of opaque types.
+- 0801db6: Added an `ApiMock`, analogous to `ServiceMock` from the backend test utils.
+- 9cc7dd6: Added a `mockApis` export, which will replace the `MockX` API implementation classes and their related types. This is analogous with the backend's `mockServices`.
+
+  **DEPRECATED** several old helpers:
+
+  - Deprecated `MockAnalyticsApi`, please use `mockApis.analytics` instead.
+  - Deprecated `MockConfigApi`, please use `mockApis.config` instead.
+  - Deprecated `MockPermissionApi`, please use `mockApis.permission` instead.
+  - Deprecated `MockStorageApi`, please use `mockApis.storage` instead.
+  - Deprecated `MockTranslationApi`, please use `mockApis.translation` instead.
+
+- Updated dependencies
+  - @backstage/frontend-plugin-api@0.9.0
+  - @backstage/frontend-app-api@0.10.0
+  - @backstage/version-bridge@1.0.10
+  - @backstage/test-utils@1.7.0
+  - @backstage/plugin-app@0.1.1
+  - @backstage/config@1.2.0
+  - @backstage/types@1.1.1
+
 ## 0.2.1-next.2
 
 ### Patch Changes

package/dist/app/renderInTestApp.esm.js

@@ -16,6 +16,9 @@ const NavItem = (props) => {
 };
 const appPluginOverride = appPlugin.withOverrides({
   extensions: [
+    appPlugin.getExtension("sign-in-page:app").override({
+      disabled: true
+    }),
     appPlugin.getExtension("app/nav").override({
       output: [coreExtensionData.reactElement],
       factory(_originalFactory, { inputs }) {

package/dist/app/renderInTestApp.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"renderInTestApp.esm.js","sources":["../../src/app/renderInTestApp.tsx"],"sourcesContent":["/*\n * Copyright 2023 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 React from 'react';\nimport { Link, MemoryRouter } from 'react-router-dom';\nimport {\n  createSpecializedApp,\n  FrontendFeature,\n} from '@backstage/frontend-app-api';\nimport { RenderResult, render } from '@testing-library/react';\nimport { ConfigReader } from '@backstage/config';\nimport { JsonObject } from '@backstage/types';\nimport {\n  createExtension,\n  ExtensionDefinition,\n  coreExtensionData,\n  RouteRef,\n  useRouteRef,\n  IconComponent,\n  RouterBlueprint,\n  NavItemBlueprint,\n  createFrontendPlugin,\n} from '@backstage/frontend-plugin-api';\nimport appPlugin from '@backstage/plugin-app';\n\n/**\n * Options to customize the behavior of the test app.\n * @public\n */\nexport type TestAppOptions = {\n  /**\n   * An object of paths to mount route ref on, with the key being the path and the value\n   * being the RouteRef that the path will be bound to. This allows the route refs to be\n   * used by `useRouteRef` in the rendered elements.\n   *\n   * @example\n   * ```ts\n   * renderInTestApp(<MyComponent />, {\n   *   mountedRoutes: {\n   *     '/my-path': myRouteRef,\n   *   }\n   * })\n   * // ...\n   * const link = useRouteRef(myRouteRef)\n   * ```\n   */\n  mountedRoutes?: { [path: string]: RouteRef };\n\n  /**\n   * Additional configuration passed to the app when rendering elements inside it.\n   */\n  config?: JsonObject;\n\n  /**\n   * Additional extensions to add to the test app.\n   */\n  extensions?: ExtensionDefinition<any>[];\n\n  /**\n   * Additional features to add to the test app.\n   */\n  features?: FrontendFeature[];\n};\n\nconst NavItem = (props: {\n  routeRef: RouteRef<undefined>;\n  title: string;\n  icon: IconComponent;\n}) => {\n  const { routeRef, title, icon: Icon } = props;\n  const link = useRouteRef(routeRef);\n  if (!link) {\n    return null;\n  }\n  return (\n    <li>\n      <Link to={link()}>\n        <Icon /> {title}\n      </Link>\n    </li>\n  );\n};\n\nconst appPluginOverride = appPlugin.withOverrides({\n  extensions: [\n    appPlugin.getExtension('app/nav').override({\n      output: [coreExtensionData.reactElement],\n      factory(_originalFactory, { inputs }) {\n        return [\n          coreExtensionData.reactElement(\n            <nav>\n              <ul>\n                {inputs.items.map((item, index) => {\n                  const { icon, title, routeRef } = item.get(\n                    NavItemBlueprint.dataRefs.target,\n                  );\n\n                  return (\n                    <NavItem\n                      key={index}\n                      icon={icon}\n                      title={title}\n                      routeRef={routeRef}\n                    />\n                  );\n                })}\n              </ul>\n            </nav>,\n          ),\n        ];\n      },\n    }),\n  ],\n});\n\n/**\n * @public\n * Renders the given element in a test app, for use in unit tests.\n */\nexport function renderInTestApp(\n  element: JSX.Element,\n  options?: TestAppOptions,\n): RenderResult {\n  const extensions: Array<ExtensionDefinition> = [\n    createExtension({\n      attachTo: { id: 'app/routes', input: 'routes' },\n      output: [coreExtensionData.reactElement, coreExtensionData.routePath],\n      factory: () => {\n        return [\n          coreExtensionData.reactElement(element),\n          coreExtensionData.routePath('/'),\n        ];\n      },\n    }),\n    RouterBlueprint.make({\n      params: {\n        Component: ({ children }) => <MemoryRouter>{children}</MemoryRouter>,\n      },\n    }),\n  ];\n\n  if (options?.mountedRoutes) {\n    for (const [path, routeRef] of Object.entries(options.mountedRoutes)) {\n      // TODO(Rugvip): add support for external route refs\n      extensions.push(\n        createExtension({\n          kind: 'test-route',\n          name: path,\n          attachTo: { id: 'app/root', input: 'elements' },\n          output: [\n            coreExtensionData.reactElement,\n            coreExtensionData.routePath,\n            coreExtensionData.routeRef,\n          ],\n          factory: () => [\n            coreExtensionData.reactElement(<React.Fragment />),\n            coreExtensionData.routePath(path),\n            coreExtensionData.routeRef(routeRef),\n          ],\n        }),\n      );\n    }\n  }\n\n  if (options?.extensions) {\n    extensions.push(...options.extensions);\n  }\n\n  const features: FrontendFeature[] = [\n    createFrontendPlugin({\n      id: 'test',\n      extensions,\n    }),\n    appPluginOverride,\n  ];\n\n  if (options?.features) {\n    features.push(...options.features);\n  }\n\n  const app = createSpecializedApp({\n    features,\n    config: ConfigReader.fromConfigs([\n      { context: 'render-config', data: options?.config ?? {} },\n    ]),\n  });\n\n  return render(app.createRoot());\n}\n"],"names":[],"mappings":";;;;;;;;AA6EA,MAAM,OAAA,GAAU,CAAC,KAIX,KAAA;AACJ,EAAA,MAAM,EAAE,QAAA,EAAU,KAAO,EAAA,IAAA,EAAM,MAAS,GAAA,KAAA,CAAA;AACxC,EAAM,MAAA,IAAA,GAAO,YAAY,QAAQ,CAAA,CAAA;AACjC,EAAA,IAAI,CAAC,IAAM,EAAA;AACT,IAAO,OAAA,IAAA,CAAA;AAAA,GACT;AACA,EAAA,uBACG,KAAA,CAAA,aAAA,CAAA,IAAA,EAAA,IAAA,kBACE,KAAA,CAAA,aAAA,CAAA,IAAA,EAAA,EAAK,EAAI,EAAA,IAAA,EACR,EAAA,kBAAA,KAAA,CAAA,aAAA,CAAC,IAAK,EAAA,IAAA,CAAA,EAAE,GAAE,EAAA,KACZ,CACF,CAAA,CAAA;AAEJ,CAAA,CAAA;AAEA,MAAM,iBAAA,GAAoB,UAAU,aAAc,CAAA;AAAA,EAChD,UAAY,EAAA;AAAA,IACV,SAAU,CAAA,YAAA,CAAa,SAAS,CAAA,CAAE,QAAS,CAAA;AAAA,MACzC,MAAA,EAAQ,CAAC,iBAAA,CAAkB,YAAY,CAAA;AAAA,MACvC,OAAQ,CAAA,gBAAA,EAAkB,EAAE,MAAA,EAAU,EAAA;AACpC,QAAO,OAAA;AAAA,UACL,iBAAkB,CAAA,YAAA;AAAA,4BAChB,KAAA,CAAA,aAAA,CAAC,6BACE,KAAA,CAAA,aAAA,CAAA,IAAA,EAAA,IAAA,EACE,OAAO,KAAM,CAAA,GAAA,CAAI,CAAC,IAAA,EAAM,KAAU,KAAA;AACjC,cAAA,MAAM,EAAE,IAAA,EAAM,KAAO,EAAA,QAAA,KAAa,IAAK,CAAA,GAAA;AAAA,gBACrC,iBAAiB,QAAS,CAAA,MAAA;AAAA,eAC5B,CAAA;AAEA,cACE,uBAAA,KAAA,CAAA,aAAA;AAAA,gBAAC,OAAA;AAAA,gBAAA;AAAA,kBACC,GAAK,EAAA,KAAA;AAAA,kBACL,IAAA;AAAA,kBACA,KAAA;AAAA,kBACA,QAAA;AAAA,iBAAA;AAAA,eACF,CAAA;AAAA,aAEH,CACH,CACF,CAAA;AAAA,WACF;AAAA,SACF,CAAA;AAAA,OACF;AAAA,KACD,CAAA;AAAA,GACH;AACF,CAAC,CAAA,CAAA;AAMe,SAAA,eAAA,CACd,SACA,OACc,EAAA;AACd,EAAA,MAAM,UAAyC,GAAA;AAAA,IAC7C,eAAgB,CAAA;AAAA,MACd,QAAU,EAAA,EAAE,EAAI,EAAA,YAAA,EAAc,OAAO,QAAS,EAAA;AAAA,MAC9C,MAAQ,EAAA,CAAC,iBAAkB,CAAA,YAAA,EAAc,kBAAkB,SAAS,CAAA;AAAA,MACpE,SAAS,MAAM;AACb,QAAO,OAAA;AAAA,UACL,iBAAA,CAAkB,aAAa,OAAO,CAAA;AAAA,UACtC,iBAAA,CAAkB,UAAU,GAAG,CAAA;AAAA,SACjC,CAAA;AAAA,OACF;AAAA,KACD,CAAA;AAAA,IACD,gBAAgB,IAAK,CAAA;AAAA,MACnB,MAAQ,EAAA;AAAA,QACN,WAAW,CAAC,EAAE,UAAe,qBAAA,KAAA,CAAA,aAAA,CAAC,oBAAc,QAAS,CAAA;AAAA,OACvD;AAAA,KACD,CAAA;AAAA,GACH,CAAA;AAEA,EAAA,IAAI,SAAS,aAAe,EAAA;AAC1B,IAAW,KAAA,MAAA,CAAC,MAAM,QAAQ,CAAA,IAAK,OAAO,OAAQ,CAAA,OAAA,CAAQ,aAAa,CAAG,EAAA;AAEpE,MAAW,UAAA,CAAA,IAAA;AAAA,QACT,eAAgB,CAAA;AAAA,UACd,IAAM,EAAA,YAAA;AAAA,UACN,IAAM,EAAA,IAAA;AAAA,UACN,QAAU,EAAA,EAAE,EAAI,EAAA,UAAA,EAAY,OAAO,UAAW,EAAA;AAAA,UAC9C,MAAQ,EAAA;AAAA,YACN,iBAAkB,CAAA,YAAA;AAAA,YAClB,iBAAkB,CAAA,SAAA;AAAA,YAClB,iBAAkB,CAAA,QAAA;AAAA,WACpB;AAAA,UACA,SAAS,MAAM;AAAA,YACb,kBAAkB,YAAa,iBAAA,KAAA,CAAA,aAAA,CAAC,KAAM,CAAA,QAAA,EAAN,IAAe,CAAE,CAAA;AAAA,YACjD,iBAAA,CAAkB,UAAU,IAAI,CAAA;AAAA,YAChC,iBAAA,CAAkB,SAAS,QAAQ,CAAA;AAAA,WACrC;AAAA,SACD,CAAA;AAAA,OACH,CAAA;AAAA,KACF;AAAA,GACF;AAEA,EAAA,IAAI,SAAS,UAAY,EAAA;AACvB,IAAW,UAAA,CAAA,IAAA,CAAK,GAAG,OAAA,CAAQ,UAAU,CAAA,CAAA;AAAA,GACvC;AAEA,EAAA,MAAM,QAA8B,GAAA;AAAA,IAClC,oBAAqB,CAAA;AAAA,MACnB,EAAI,EAAA,MAAA;AAAA,MACJ,UAAA;AAAA,KACD,CAAA;AAAA,IACD,iBAAA;AAAA,GACF,CAAA;AAEA,EAAA,IAAI,SAAS,QAAU,EAAA;AACrB,IAAS,QAAA,CAAA,IAAA,CAAK,GAAG,OAAA,CAAQ,QAAQ,CAAA,CAAA;AAAA,GACnC;AAEA,EAAA,MAAM,MAAM,oBAAqB,CAAA;AAAA,IAC/B,QAAA;AAAA,IACA,MAAA,EAAQ,aAAa,WAAY,CAAA;AAAA,MAC/B,EAAE,OAAS,EAAA,eAAA,EAAiB,MAAM,OAAS,EAAA,MAAA,IAAU,EAAG,EAAA;AAAA,KACzD,CAAA;AAAA,GACF,CAAA,CAAA;AAED,EAAO,OAAA,MAAA,CAAO,GAAI,CAAA,UAAA,EAAY,CAAA,CAAA;AAChC;;;;"}
+{"version":3,"file":"renderInTestApp.esm.js","sources":["../../src/app/renderInTestApp.tsx"],"sourcesContent":["/*\n * Copyright 2023 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 React from 'react';\nimport { Link, MemoryRouter } from 'react-router-dom';\nimport {\n  createSpecializedApp,\n  FrontendFeature,\n} from '@backstage/frontend-app-api';\nimport { RenderResult, render } from '@testing-library/react';\nimport { ConfigReader } from '@backstage/config';\nimport { JsonObject } from '@backstage/types';\nimport {\n  createExtension,\n  ExtensionDefinition,\n  coreExtensionData,\n  RouteRef,\n  useRouteRef,\n  IconComponent,\n  RouterBlueprint,\n  NavItemBlueprint,\n  createFrontendPlugin,\n} from '@backstage/frontend-plugin-api';\nimport appPlugin from '@backstage/plugin-app';\n\n/**\n * Options to customize the behavior of the test app.\n * @public\n */\nexport type TestAppOptions = {\n  /**\n   * An object of paths to mount route ref on, with the key being the path and the value\n   * being the RouteRef that the path will be bound to. This allows the route refs to be\n   * used by `useRouteRef` in the rendered elements.\n   *\n   * @example\n   * ```ts\n   * renderInTestApp(<MyComponent />, {\n   *   mountedRoutes: {\n   *     '/my-path': myRouteRef,\n   *   }\n   * })\n   * // ...\n   * const link = useRouteRef(myRouteRef)\n   * ```\n   */\n  mountedRoutes?: { [path: string]: RouteRef };\n\n  /**\n   * Additional configuration passed to the app when rendering elements inside it.\n   */\n  config?: JsonObject;\n\n  /**\n   * Additional extensions to add to the test app.\n   */\n  extensions?: ExtensionDefinition<any>[];\n\n  /**\n   * Additional features to add to the test app.\n   */\n  features?: FrontendFeature[];\n};\n\nconst NavItem = (props: {\n  routeRef: RouteRef<undefined>;\n  title: string;\n  icon: IconComponent;\n}) => {\n  const { routeRef, title, icon: Icon } = props;\n  const link = useRouteRef(routeRef);\n  if (!link) {\n    return null;\n  }\n  return (\n    <li>\n      <Link to={link()}>\n        <Icon /> {title}\n      </Link>\n    </li>\n  );\n};\n\nconst appPluginOverride = appPlugin.withOverrides({\n  extensions: [\n    appPlugin.getExtension('sign-in-page:app').override({\n      disabled: true,\n    }),\n    appPlugin.getExtension('app/nav').override({\n      output: [coreExtensionData.reactElement],\n      factory(_originalFactory, { inputs }) {\n        return [\n          coreExtensionData.reactElement(\n            <nav>\n              <ul>\n                {inputs.items.map((item, index) => {\n                  const { icon, title, routeRef } = item.get(\n                    NavItemBlueprint.dataRefs.target,\n                  );\n\n                  return (\n                    <NavItem\n                      key={index}\n                      icon={icon}\n                      title={title}\n                      routeRef={routeRef}\n                    />\n                  );\n                })}\n              </ul>\n            </nav>,\n          ),\n        ];\n      },\n    }),\n  ],\n});\n\n/**\n * @public\n * Renders the given element in a test app, for use in unit tests.\n */\nexport function renderInTestApp(\n  element: JSX.Element,\n  options?: TestAppOptions,\n): RenderResult {\n  const extensions: Array<ExtensionDefinition> = [\n    createExtension({\n      attachTo: { id: 'app/routes', input: 'routes' },\n      output: [coreExtensionData.reactElement, coreExtensionData.routePath],\n      factory: () => {\n        return [\n          coreExtensionData.reactElement(element),\n          coreExtensionData.routePath('/'),\n        ];\n      },\n    }),\n    RouterBlueprint.make({\n      params: {\n        Component: ({ children }) => <MemoryRouter>{children}</MemoryRouter>,\n      },\n    }),\n  ];\n\n  if (options?.mountedRoutes) {\n    for (const [path, routeRef] of Object.entries(options.mountedRoutes)) {\n      // TODO(Rugvip): add support for external route refs\n      extensions.push(\n        createExtension({\n          kind: 'test-route',\n          name: path,\n          attachTo: { id: 'app/root', input: 'elements' },\n          output: [\n            coreExtensionData.reactElement,\n            coreExtensionData.routePath,\n            coreExtensionData.routeRef,\n          ],\n          factory: () => [\n            coreExtensionData.reactElement(<React.Fragment />),\n            coreExtensionData.routePath(path),\n            coreExtensionData.routeRef(routeRef),\n          ],\n        }),\n      );\n    }\n  }\n\n  if (options?.extensions) {\n    extensions.push(...options.extensions);\n  }\n\n  const features: FrontendFeature[] = [\n    createFrontendPlugin({\n      id: 'test',\n      extensions,\n    }),\n    appPluginOverride,\n  ];\n\n  if (options?.features) {\n    features.push(...options.features);\n  }\n\n  const app = createSpecializedApp({\n    features,\n    config: ConfigReader.fromConfigs([\n      { context: 'render-config', data: options?.config ?? {} },\n    ]),\n  });\n\n  return render(app.createRoot());\n}\n"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,8 +1,7 @@
-/// <reference types="jest" />
 /// <reference types="react" />
-export { ErrorWithContext, MockConfigApi, MockErrorApi, MockErrorApiOptions, MockFetchApi, MockFetchApiOptions, MockPermissionApi, MockStorageApi, MockStorageBucket, TestApiProvider, TestApiProviderProps, TestApiRegistry, registerMswTestHooks, withLogCollector } from '@backstage/test-utils';
+export { ApiMock, ErrorWithContext, MockConfigApi, MockErrorApi, MockErrorApiOptions, MockFetchApi, MockFetchApiOptions, MockPermissionApi, MockStorageApi, MockStorageBucket, TestApiProvider, TestApiProviderProps, TestApiRegistry, mockApis, registerMswTestHooks, withLogCollector } from '@backstage/test-utils';
 import * as _backstage_frontend_plugin_api from '@backstage/frontend-plugin-api';
-import { ApiFactory, AnalyticsApi, AnalyticsEvent, AnyExtensionDataRef, AppNode, ExtensionDataRef, ExtensionDefinitionParameters, ExtensionDefinition, RouteRef } from '@backstage/frontend-plugin-api';
+import { AnalyticsApi, AnalyticsEvent, AnyExtensionDataRef, AppNode, ExtensionDataRef, ExtensionDefinitionParameters, ExtensionDefinition, RouteRef } from '@backstage/frontend-plugin-api';
 import { FrontendFeature } from '@backstage/frontend-app-api';
 import { RenderResult } from '@testing-library/react';
 import { JsonObject } from '@backstage/types';
@@ -17,19 +16,6 @@ declare function setupRequestMockHandlers(worker: {
     resetHandlers: () => void;
 }): void;
 
-/**
- * Represents a mocked version of an API, where you automatically have access to
- * the mocked versions of all of its methods along with a factory that returns
- * that same mock.
- *
- * @public
- */
-type ApiMock<TApi> = {
-    factory: ApiFactory<TApi, TApi, {}>;
-} & {
-    [Key in keyof TApi]: TApi[Key] extends (...args: infer Args) => infer Return ? TApi[Key] & jest.MockInstance<Return, Args> : TApi[Key];
-};
-
 /**
  * Mock implementation of {@link frontend-plugin-api#AnalyticsApi} with helpers to ensure that events are sent correctly.
  * Use getEvents in tests to verify captured events.
@@ -108,4 +94,4 @@ type TestAppOptions = {
  */
 declare function renderInTestApp(element: JSX.Element, options?: TestAppOptions): RenderResult;
 
-export { type ApiMock, ExtensionQuery, ExtensionTester, MockAnalyticsApi, type TestAppOptions, createExtensionTester, renderInTestApp, setupRequestMockHandlers };
+export { ExtensionQuery, ExtensionTester, MockAnalyticsApi, type TestAppOptions, createExtensionTester, renderInTestApp, setupRequestMockHandlers };

package/dist/index.esm.js

@@ -1,5 +1,5 @@
 export { setupRequestMockHandlers } from './deprecated.esm.js';
-export { MockConfigApi, MockErrorApi, MockFetchApi, MockPermissionApi, MockStorageApi, TestApiProvider, TestApiRegistry, registerMswTestHooks, withLogCollector } from '@backstage/test-utils';
+export { MockConfigApi, MockErrorApi, MockFetchApi, MockPermissionApi, MockStorageApi, TestApiProvider, TestApiRegistry, mockApis, registerMswTestHooks, withLogCollector } from '@backstage/test-utils';
 export { MockAnalyticsApi } from './apis/AnalyticsApi/MockAnalyticsApi.esm.js';
 export { createExtensionTester } from './app/createExtensionTester.esm.js';
 export { renderInTestApp } from './app/renderInTestApp.esm.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backstage/frontend-test-utils",
-  "version": "0.2.1-next.2",
+  "version": "0.2.1",
   "backstage": {
     "role": "web-library"
   },
@@ -31,17 +31,17 @@
     "test": "backstage-cli package test"
   },
   "dependencies": {
-    "@backstage/config": "1.2.0",
-    "@backstage/frontend-app-api": "0.10.0-next.2",
-    "@backstage/frontend-plugin-api": "0.9.0-next.2",
-    "@backstage/plugin-app": "0.1.1-next.2",
-    "@backstage/test-utils": "1.6.1-next.2",
-    "@backstage/types": "1.1.1",
-    "@backstage/version-bridge": "1.0.10-next.0",
+    "@backstage/config": "^1.2.0",
+    "@backstage/frontend-app-api": "^0.10.0",
+    "@backstage/frontend-plugin-api": "^0.9.0",
+    "@backstage/plugin-app": "^0.1.1",
+    "@backstage/test-utils": "^1.7.0",
+    "@backstage/types": "^1.1.1",
+    "@backstage/version-bridge": "^1.0.10",
     "zod": "^3.22.4"
   },
   "devDependencies": {
-    "@backstage/cli": "0.28.0-next.2",
+    "@backstage/cli": "^0.28.0",
     "@testing-library/jest-dom": "^6.0.0",
     "@types/react": "^18.0.0",
     "react": "^18.0.2",
@@ -50,7 +50,6 @@
   },
   "peerDependencies": {
     "@testing-library/react": "^16.0.0",
-    "@types/jest": "*",
     "@types/react": "^16.13.1 || ^17.0.0 || ^18.0.0",
     "react": "^16.13.1 || ^17.0.0 || ^18.0.0",
     "react-dom": "^16.13.1 || ^17.0.0 || ^18.0.0",