Add API for standalone and functional approaches (#445)

Author: frederikprijck

projects/auth0-angular/src/lib/functional.ts

@@ -0,0 +1,35 @@
+import { HttpEvent, HttpRequest } from '@angular/common/http';
+import { inject } from '@angular/core';
+import { ActivatedRouteSnapshot, RouterStateSnapshot } from '@angular/router';
+import { Observable } from 'rxjs';
+import { AuthGuard } from './auth.guard';
+import { AuthHttpInterceptor } from './auth.interceptor';
+
+/**
+ * Functional AuthGuard to ensure routes can only be accessed when authenticated.
+ *
+ * Note: Should only be used as of Angular 15
+ *
+ * @param route Contains the information about a route associated with a component loaded in an outlet at a particular moment in time.
+ * @param state Represents the state of the router at a moment in time.
+ * @returns An Observable<Boolean>, indicating if the route can be accessed or not
+ */
+export const authGuardFn = (
+  route: ActivatedRouteSnapshot,
+  state: RouterStateSnapshot
+) => inject(AuthGuard).canActivate(route, state);
+
+/**
+ * Functional AuthHttpInterceptor to include the access token in matching requests.
+ *
+ * Note: Should only be used as of Angular 15
+ *
+ * @param req An outgoing HTTP request with an optional typed body.
+ * @param handle Represents the next interceptor in an interceptor chain, or the real backend if there are no
+ * further interceptors.
+ * @returns An Observable<HttpEvent<any>>, representing the intercepted HttpRequest
+ */
+export const authHttpInterceptorFn = (
+  req: HttpRequest<any>,
+  handle: (req: HttpRequest<unknown>) => Observable<HttpEvent<unknown>>
+) => inject(AuthHttpInterceptor).intercept(req, { handle });

projects/auth0-angular/src/lib/provide.ts

@@ -0,0 +1,38 @@
+import { Provider } from '@angular/core';
+import { Auth0ClientService, Auth0ClientFactory } from './auth.client';
+import { AuthConfig, AuthConfigService, AuthClientConfig } from './auth.config';
+import { AuthGuard } from './auth.guard';
+import { AuthHttpInterceptor } from './auth.interceptor';
+import { AuthService } from './auth.service';
+
+/**
+ * Initialize the authentication system. Configuration can either be specified here,
+ * or by calling AuthClientConfig.set (perhaps from an APP_INITIALIZER factory function).
+ *
+ * Note: Should only be used as of Angular 15, and should not be added to a component's providers.
+ *
+ * @param config The optional configuration for the SDK.
+ *
+ * @example
+ * bootstrapApplication(AppComponent, {
+ *   providers: [
+ *     provideAuth0(),
+ *   ],
+ * });
+ */
+export function provideAuth0(config?: AuthConfig): Provider[] {
+  return [
+    AuthService,
+    AuthHttpInterceptor,
+    AuthGuard,
+    {
+      provide: AuthConfigService,
+      useValue: config,
+    },
+    {
+      provide: Auth0ClientService,
+      useFactory: Auth0ClientFactory.createClient,
+      deps: [AuthClientConfig],
+    },
+  ];
+}

projects/auth0-angular/src/public-api.ts

@@ -10,6 +10,8 @@ export * from './lib/auth.config';
 export * from './lib/auth.client';
 export * from './lib/auth.state';
 export * from './lib/interfaces';
+export * from './lib/provide';
+export * from './lib/functional';
 
 export {
   AuthorizationParams,