refactor: use generic auth cookie provider in techdocs

Signed-off-by: Camila Belo <camilaibs@gmail.com>
This commit is contained in:
Camila Belo
2024-03-12 13:58:41 +01:00
parent 81793abc0c
commit a992f86384
3 changed files with 8 additions and 108 deletions
@@ -1,103 +0,0 @@
/*
* Copyright 2024 The Backstage Authors
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
import React, { ReactNode, useEffect, useState, useCallback } from 'react';
import { ErrorPanel } from '@backstage/core-components';
import { techdocsApiRef } from '@backstage/plugin-techdocs-react';
import { useApi, useApp } from '@backstage/core-plugin-api';
import useAsyncRetry from 'react-use/lib/useAsyncRetry';
import Button from '@material-ui/core/Button';
type TechDocsRefreshCookieMessage = MessageEvent<{
action: string;
payload: {
expiresAt: string;
};
}>;
function useTechDocsCookie() {
const techdocsApi = useApi(techdocsApiRef);
const { retry, ...state } = useAsyncRetry(async () => {
return await techdocsApi.getCookie();
}, [techdocsApi]);
const refresh = useCallback(
(expiresAt: string) => {
// Randomize the refreshing margin to avoid all tabs refreshing at the same time
const refreshingMargin = (1 + 3 * Math.random()) * 60000;
const delay = Date.parse(expiresAt) - Date.now() - refreshingMargin;
const timeout = setTimeout(retry, delay);
return () => clearTimeout(timeout);
},
[retry],
);
return { ...state, retry, refresh };
}
export function TechDocsAuthProvider({ children }: { children: ReactNode }) {
const app = useApp();
const { Progress } = app.getComponents();
const [channel] = useState(
() => new BroadcastChannel('techdocs-cookie-refresh'),
);
const { loading, error, value, retry, refresh } = useTechDocsCookie();
useEffect(() => {
if (!value) return () => {};
channel.postMessage({
action: 'TECHDOCS_COOKIE_REFRESHED',
payload: value,
});
let cancel = refresh(value.expiresAt);
const handleMessage = (event: TechDocsRefreshCookieMessage): void => {
const { action, payload } = event.data;
if (action === 'TECHDOCS_COOKIE_REFRESHED') {
cancel();
cancel = refresh(payload.expiresAt);
}
};
channel.addEventListener('message', handleMessage);
return () => {
cancel();
channel.removeEventListener('message', handleMessage);
};
}, [value, refresh, channel]);
if (error) {
return (
<ErrorPanel error={error}>
<Button variant="outlined" onClick={retry}>
Retry
</Button>
</ErrorPanel>
);
}
if (loading) {
return <Progress />;
}
return children;
}
@@ -23,6 +23,7 @@ import {
TECHDOCS_ADDONS_WRAPPER_KEY,
TECHDOCS_ADDONS_KEY,
TechDocsReaderPageProvider,
techdocsApiRef,
} from '@backstage/plugin-techdocs-react';
import { TechDocsReaderPageRenderFunction } from '../../../types';
@@ -35,7 +36,8 @@ import {
getComponentData,
useRouteRefParams,
} from '@backstage/core-plugin-api';
import { TechDocsAuthProvider } from './TechDocsAuthProvider';
import { CookieAuthRefreshProvider } from '@backstage/plugin-auth-react';
/* An explanation for the multiple ways of customizing the TechDocs reader page
@@ -178,17 +180,17 @@ export const TechDocsReaderPage = (props: TechDocsReaderPageProps) => {
// As explained above, "page" is configuration 4 and <TechDocsReaderLayout> is 1
return (
<TechDocsAuthProvider>
<CookieAuthRefreshProvider apiRef={techdocsApiRef}>
<TechDocsReaderPageProvider entityRef={entityRef}>
{(page as JSX.Element) || <TechDocsReaderLayout />}
</TechDocsReaderPageProvider>
</TechDocsAuthProvider>
</CookieAuthRefreshProvider>
);
}
// As explained above, a render function is configuration 3 and React element is 2
return (
<TechDocsAuthProvider>
<CookieAuthRefreshProvider apiRef={techdocsApiRef}>
<TechDocsReaderPageProvider entityRef={entityRef}>
{({ metadata, entityMetadata, onReady }) => (
<div className="techdocs-reader-page">
@@ -205,6 +207,6 @@ export const TechDocsReaderPage = (props: TechDocsReaderPageProps) => {
</div>
)}
</TechDocsReaderPageProvider>
</TechDocsAuthProvider>
</CookieAuthRefreshProvider>
);
};