@backstage/core-app-api 0.1.24 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,51 @@
 # @backstage/core-app-api
 
+## 0.2.0
+
+### Minor Changes
+
+- a036b65c2f: **BREAKING CHANGE**
+
+  The app `SignInPage` component has been updated to switch out the `onResult` callback for a new `onSignInSuccess` callback. This is an immediate breaking change without any deprecation period, as it was deemed to be the way of making this change that had the lowest impact.
+
+  The new `onSignInSuccess` callback directly accepts an implementation of an `IdentityApi`, rather than a `SignInResult`. The `SignInPage` from `@backstage/core-component` has been updated to fit this new API, and as long as you pass on `props` directly you should not see any breakage.
+
+  However, if you implement your own custom `SignInPage`, then this will be a breaking change and you need to migrate over to using the new callback. While doing so you can take advantage of the `UserIdentity.fromLegacy` helper from `@backstage/core-components` to make the migration simpler by still using the `SignInResult` type. This helper is also deprecated though and is only provided for immediate migration. Long-term it will be necessary to build the `IdentityApi` using for example `UserIdentity.create` instead.
+
+  The following is an example of how you can migrate existing usage immediately using `UserIdentity.fromLegacy`:
+
+  ```ts
+  onResult(signInResult);
+  // becomes
+  onSignInSuccess(UserIdentity.fromLegacy(signInResult));
+  ```
+
+  The following is an example of how implement the new `onSignInSuccess` callback of the `SignInPage` using `UserIdentity.create`:
+
+  ```ts
+  const identityResponse = await authApi.getBackstageIdentity();
+  // Profile is optional and will be removed, but allows the
+  // synchronous getProfile method of the IdentityApi to be used.
+  const profile = await authApi.getProfile();
+  onSignInSuccess(
+    UserIdentity.create({
+      identity: identityResponse.identity,
+      authApi,
+      profile,
+    }),
+  );
+  ```
+
+### Patch Changes
+
+- cd450844f6: Moved React dependencies to `peerDependencies` and allow both React v16 and v17 to be used.
+- dcd1a0c3f4: Minor improvement to the API reports, by not unpacking arguments directly
+- Updated dependencies
+  - @backstage/core-components@0.8.0
+  - @backstage/core-plugin-api@0.3.0
+  - @backstage/app-defaults@0.1.2
+  - @backstage/version-bridge@0.1.1
+
 ## 0.1.24
 
 ### Patch Changes

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { ReactNode, PropsWithChildren, ComponentType } from 'react';
 import PropTypes from 'prop-types';
-import { ApiHolder, ApiRef, ApiFactory, AnyApiRef, ProfileInfo, BackstageIdentity, SessionState, OAuthRequestApi, DiscoveryApi, AuthProvider, OAuthApi, SessionApi, AuthRequestOptions, gitlabAuthApiRef, googleAuthApiRef, OpenIdConnectApi, ProfileInfoApi, BackstageIdentityApi, oktaAuthApiRef, auth0AuthApiRef, microsoftAuthApiRef, oneloginAuthApiRef, bitbucketAuthApiRef, atlassianAuthApiRef, AlertApi, AlertMessage, AnalyticsApi, AnalyticsEvent, AppThemeApi, AppTheme, ErrorApi, ErrorApiError, ErrorApiErrorContext, FeatureFlagsApi, FeatureFlag, FeatureFlagsSaveOptions, AuthRequesterOptions, AuthRequester, PendingAuthRequest, StorageApi, StorageValueChange, BackstagePlugin, IconComponent, ExternalRouteRef, PluginOutput, AnyApiFactory, RouteRef, SubRouteRef } from '@backstage/core-plugin-api';
+import { ApiHolder, ApiRef, ApiFactory, AnyApiRef, ProfileInfo, BackstageIdentity, SessionState, OAuthRequestApi, DiscoveryApi, AuthProvider, OAuthApi, SessionApi, AuthRequestOptions, gitlabAuthApiRef, googleAuthApiRef, OpenIdConnectApi, ProfileInfoApi, BackstageIdentityApi, oktaAuthApiRef, auth0AuthApiRef, microsoftAuthApiRef, oneloginAuthApiRef, bitbucketAuthApiRef, atlassianAuthApiRef, AlertApi, AlertMessage, AnalyticsApi, AnalyticsEvent, AppThemeApi, AppTheme, ErrorApi, ErrorApiError, ErrorApiErrorContext, FeatureFlagsApi, FeatureFlag, FeatureFlagsSaveOptions, AuthRequesterOptions, AuthRequester, PendingAuthRequest, StorageApi, StorageValueChange, IdentityApi, BackstagePlugin, IconComponent, ExternalRouteRef, PluginOutput, AnyApiFactory, RouteRef, SubRouteRef } from '@backstage/core-plugin-api';
 import * as _backstage_types from '@backstage/types';
 import { Observable } from '@backstage/types';
 import { AppConfig } from '@backstage/config';
@@ -189,7 +189,7 @@ declare type AuthApiCreateOptions = {
  */
 declare class GithubAuth implements OAuthApi, SessionApi {
     private readonly sessionManager;
-    static create({ discoveryApi, environment, provider, oauthRequestApi, defaultScopes, }: OAuthApiCreateOptions): GithubAuth;
+    static create(options: OAuthApiCreateOptions): GithubAuth;
     /**
      * @deprecated will be made private in the future. Use create method instead.
      */
@@ -209,7 +209,7 @@ declare class GithubAuth implements OAuthApi, SessionApi {
  * @public
  */
 declare class GitlabAuth {
-    static create({ discoveryApi, environment, provider, oauthRequestApi, defaultScopes, }: OAuthApiCreateOptions): typeof gitlabAuthApiRef.T;
+    static create(options: OAuthApiCreateOptions): typeof gitlabAuthApiRef.T;
 }
 
 /**
@@ -218,7 +218,7 @@ declare class GitlabAuth {
  * @public
  */
 declare class GoogleAuth {
-    static create({ discoveryApi, oauthRequestApi, environment, provider, defaultScopes, }: OAuthApiCreateOptions): typeof googleAuthApiRef.T;
+    static create(options: OAuthApiCreateOptions): typeof googleAuthApiRef.T;
 }
 
 /**
@@ -250,7 +250,7 @@ declare type OAuth2CreateOptions = OAuthApiCreateOptions & {
  * @public
  */
 declare class OAuth2 implements OAuthApi, OpenIdConnectApi, ProfileInfoApi, BackstageIdentityApi, SessionApi {
-    static create({ discoveryApi, environment, provider, oauthRequestApi, defaultScopes, scopeTransform, }: OAuth2CreateOptions): OAuth2;
+    static create(options: OAuth2CreateOptions): OAuth2;
     private readonly sessionManager;
     private readonly scopeTransform;
     /**
@@ -276,7 +276,7 @@ declare class OAuth2 implements OAuthApi, OpenIdConnectApi, ProfileInfoApi, Back
  * @public
  */
 declare class OktaAuth {
-    static create({ discoveryApi, environment, provider, oauthRequestApi, defaultScopes, }: OAuthApiCreateOptions): typeof oktaAuthApiRef.T;
+    static create(options: OAuthApiCreateOptions): typeof oktaAuthApiRef.T;
 }
 
 /**
@@ -297,7 +297,7 @@ declare type SamlSession = {
  */
 declare class SamlAuth implements ProfileInfoApi, BackstageIdentityApi, SessionApi {
     private readonly sessionManager;
-    static create({ discoveryApi, environment, provider, }: AuthApiCreateOptions): SamlAuth;
+    static create(options: AuthApiCreateOptions): SamlAuth;
     sessionState$(): Observable<SessionState>;
     /**
      * @deprecated will be made private in the future. Use create method instead.
@@ -315,7 +315,7 @@ declare class SamlAuth implements ProfileInfoApi, BackstageIdentityApi, SessionA
  * @public
  */
 declare class Auth0Auth {
-    static create({ discoveryApi, environment, provider, oauthRequestApi, defaultScopes, }: OAuthApiCreateOptions): typeof auth0AuthApiRef.T;
+    static create(options: OAuthApiCreateOptions): typeof auth0AuthApiRef.T;
 }
 
 /**
@@ -324,7 +324,7 @@ declare class Auth0Auth {
  * @public
  */
 declare class MicrosoftAuth {
-    static create({ environment, provider, oauthRequestApi, discoveryApi, defaultScopes, }: OAuthApiCreateOptions): typeof microsoftAuthApiRef.T;
+    static create(options: OAuthApiCreateOptions): typeof microsoftAuthApiRef.T;
 }
 
 /**
@@ -345,7 +345,7 @@ declare type OneLoginAuthCreateOptions = {
  * @public
  */
 declare class OneLoginAuth {
-    static create({ discoveryApi, environment, provider, oauthRequestApi, }: OneLoginAuthCreateOptions): typeof oneloginAuthApiRef.T;
+    static create(options: OneLoginAuthCreateOptions): typeof oneloginAuthApiRef.T;
 }
 
 /**
@@ -369,7 +369,7 @@ declare type BitbucketSession = {
  * @public
  */
 declare class BitbucketAuth {
-    static create({ discoveryApi, environment, provider, oauthRequestApi, defaultScopes, }: OAuthApiCreateOptions): typeof bitbucketAuthApiRef.T;
+    static create(options: OAuthApiCreateOptions): typeof bitbucketAuthApiRef.T;
 }
 
 /**
@@ -378,7 +378,7 @@ declare class BitbucketAuth {
  * @public
  */
 declare class AtlassianAuth {
-    static create({ discoveryApi, environment, provider, oauthRequestApi, }: OAuthApiCreateOptions): typeof atlassianAuthApiRef.T;
+    static create(options: OAuthApiCreateOptions): typeof atlassianAuthApiRef.T;
 }
 
 /**
@@ -553,6 +553,7 @@ declare type BootErrorPageProps = {
  * The outcome of signing in on the sign-in page.
  *
  * @public
+ * @deprecated replaced by passing the {@link @backstage/core-plugin-api#IdentityApi} to the {@link SignInPageProps.onSignInSuccess} instead.
  */
 declare type SignInResult = {
     /**
@@ -576,9 +577,9 @@ declare type SignInResult = {
  */
 declare type SignInPageProps = {
     /**
-     * Set the sign-in result for the app. This should only be called once.
+     * Set the IdentityApi on successful sign in. This should only be called once.
      */
-    onResult(result: SignInResult): void;
+    onSignInSuccess(identityApi: IdentityApi): void;
 };
 /**
  * Props for the fallback error boundary.