From 7155c30a889b5f8ff45b6d401ee491b98e9ec33f Mon Sep 17 00:00:00 2001
From: Patrik Oldsberg <poldsberg@gmail.com>
Date: Fri, 19 Jan 2024 11:17:56 +0100
Subject: [PATCH] core-compat-api: added convertLegacyRouteRefs

Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
---
 .changeset/olive-singers-accept.md            |  5 +++
 packages/core-compat-api/api-report.md        | 21 +++++++++++
 .../src/convertLegacyRouteRef.ts              | 37 +++++++++++++++++++
 packages/core-compat-api/src/index.ts         |  6 ++-
 4 files changed, 68 insertions(+), 1 deletion(-)
 create mode 100644 .changeset/olive-singers-accept.md

diff --git a/.changeset/olive-singers-accept.md b/.changeset/olive-singers-accept.md
new file mode 100644
index 0000000000..7e8cf7ae8d
--- /dev/null
+++ b/.changeset/olive-singers-accept.md
@@ -0,0 +1,5 @@
+---
+'@backstage/core-compat-api': patch
+---
+
+Added `convertLegacyRouteRefs` for bulk conversion of plugin routes.
diff --git a/packages/core-compat-api/api-report.md b/packages/core-compat-api/api-report.md
index 494747be60..a7aae2b5b9 100644
--- a/packages/core-compat-api/api-report.md
+++ b/packages/core-compat-api/api-report.md
@@ -40,5 +40,26 @@ export function convertLegacyRouteRef<
   ref: ExternalRouteRef<TParams, TOptional>,
 ): ExternalRouteRef_2<TParams, TOptional>;
 
+// @public
+export function convertLegacyRouteRefs<
+  TRefs extends {
+    [name in string]: RouteRef | SubRouteRef | ExternalRouteRef;
+  },
+>(
+  refs: TRefs,
+): {
+  [KName in keyof TRefs]: ToNewRouteRef<TRefs[KName]>;
+};
+
+// @public
+export type ToNewRouteRef<T extends RouteRef | SubRouteRef | ExternalRouteRef> =
+  T extends RouteRef<infer IParams>
+    ? RouteRef_2<IParams>
+    : T extends SubRouteRef<infer IParams>
+    ? SubRouteRef_2<IParams>
+    : T extends ExternalRouteRef<infer IParams, infer IOptional>
+    ? ExternalRouteRef_2<IParams, IOptional>
+    : never;
+
 // (No @packageDocumentation comment for this package)
 ```
diff --git a/packages/core-compat-api/src/convertLegacyRouteRef.ts b/packages/core-compat-api/src/convertLegacyRouteRef.ts
index c5ee603722..36311dc081 100644
--- a/packages/core-compat-api/src/convertLegacyRouteRef.ts
+++ b/packages/core-compat-api/src/convertLegacyRouteRef.ts
@@ -40,6 +40,43 @@ import { toInternalSubRouteRef } from '../../frontend-plugin-api/src/routing/Sub
 // eslint-disable-next-line @backstage/no-relative-monorepo-imports
 import { toInternalExternalRouteRef } from '../../frontend-plugin-api/src/routing/ExternalRouteRef';
 
+/**
+ * Converts a legacy route ref type to the new system.
+ *
+ * @public
+ */
+export type ToNewRouteRef<
+  T extends LegacyRouteRef | LegacySubRouteRef | LegacyExternalRouteRef,
+> = T extends LegacyRouteRef<infer IParams>
+  ? RouteRef<IParams>
+  : T extends LegacySubRouteRef<infer IParams>
+  ? SubRouteRef<IParams>
+  : T extends LegacyExternalRouteRef<infer IParams, infer IOptional>
+  ? ExternalRouteRef<IParams, IOptional>
+  : never;
+
+/**
+ * Converts a collection of legacy route refs to the new system.
+ * This is particularly useful when defining plugin `routes` and `externalRoutes`.
+ *
+ * @public
+ */
+export function convertLegacyRouteRefs<
+  TRefs extends {
+    [name in string]:
+      | LegacyRouteRef
+      | LegacySubRouteRef
+      | LegacyExternalRouteRef;
+  },
+>(refs: TRefs): { [KName in keyof TRefs]: ToNewRouteRef<TRefs[KName]> } {
+  return Object.fromEntries(
+    Object.entries(refs).map(([name, ref]) => [
+      name,
+      convertLegacyRouteRef(ref as LegacyRouteRef),
+    ]),
+  ) as { [KName in keyof TRefs]: ToNewRouteRef<TRefs[KName]> };
+}
+
 /**
  * A temporary helper to convert a legacy route ref to the new system.
  *
diff --git a/packages/core-compat-api/src/index.ts b/packages/core-compat-api/src/index.ts
index 68e5d9cf19..b632bf8a57 100644
--- a/packages/core-compat-api/src/index.ts
+++ b/packages/core-compat-api/src/index.ts
@@ -16,4 +16,8 @@
 export * from './compatWrapper';
 
 export { convertLegacyApp } from './convertLegacyApp';
-export { convertLegacyRouteRef } from './convertLegacyRouteRef';
+export {
+  convertLegacyRouteRef,
+  convertLegacyRouteRefs,
+  type ToNewRouteRef,
+} from './convertLegacyRouteRef';