feat(router): add activated route provider (#2988)

Author: griest024

libs/router/src/activated-route/provider.ts

@@ -0,0 +1,26 @@
+import {
+  APP_INITIALIZER,
+  DestroyRef,
+  inject,
+  Provider,
+} from '@angular/core';
+import { takeUntilDestroyed } from '@angular/core/rxjs-interop';
+
+import { DaffRouterActivatedRoute } from './service';
+
+/**
+ * Provides the initializer for {@link DaffRouterActivatedRoute}.
+ */
+export const provideDaffRouterActivatedRoute = (): Provider => ({
+  provide: APP_INITIALIZER,
+  multi: true,
+  useFactory: () => {
+    const service = inject(DaffRouterActivatedRoute);
+    const destroyRef = inject(DestroyRef);
+    return () => {
+      service.route$.pipe(
+        takeUntilDestroyed(destroyRef),
+      ).subscribe();
+    };
+  },
+});

libs/router/src/activated-route/public_api.ts

@@ -1 +1,2 @@
 export * from './service';
+export * from './provider';

libs/router/src/activated-route/service.ts

@@ -27,6 +27,7 @@ const getActivatedRoute = (routerState: RouterState): ActivatedRoute => {
  * Note that this service operates by listening to router events. It is therefore recommended to
  * inject this service in the root and subscribe to `route$` on app init so that all routing events are captured.
  * The consumer can then subscribe at any later time (after all navigations) and the emission stream will be replayed.
+ * {@link provideDaffRouterActivatedRoute} is the recommended way to do this.
  */
 @Injectable({
   providedIn: 'root',