add links to docs for type BackstageSignInResult

Signed-off-by: Hasan Ozdemir <21654050+nodify-at@users.noreply.github.com>

plugins/auth-backend/api-report.md

@@ -549,8 +549,6 @@ export type OidcAuthResult = {
   userinfo: UserinfoResponse;
 };
 
-// Warning: (tsdoc-undefined-tag) The TSDoc tag "@BackstageSignInResult" is not defined in this configuration
-//
 // @public
 export type OidcProviderOptions = {
   authHandler?: AuthHandler<OidcAuthResult>;

plugins/auth-backend/src/providers/oidc/provider.ts

@@ -233,7 +233,7 @@ export const oAuth2DefaultSignInResolver: SignInResolver<OidcAuthResult> =
  * can be passed while creating a OIDC provider.
  *
  * authHandler : called after sign in was successful, a new object must be returned which includes a profile
- * signInResolver: called after sign in was successful, expects to return a new @BackstageSignInResult
+ * signInResolver: called after sign in was successful, expects to return a new {@link BackstageSignInResult}
  *
  * Both options are optional. There is fallback for authHandler where the default handler expect an e-mail explicitly
  * otherwise it throws an error

plugins/auth-backend/src/providers/types.ts

@@ -258,7 +258,7 @@ export type SignInInfo<AuthResult> = {
 
 /**
  * Sign in resolver type describes the function which handles the result of a successful authentication
- * and must return a valid BackStageSignInResult
+ * and it must return a valid {@link BackstageSignInResult}
  * @public
  */
 export type SignInResolver<AuthResult> = (