⭐️⭐️⭐️ Open-source, self-hosted alternative to Linear and Plane. Project management and issue tracking where teams and AI agents work side by side to plan and ship products.
TypeScript agenticagileai-agentsbug-reportingbug-trackerganttissue-trackerjirajira-alternativekanbanlinearlinear-alternativeopen-sourceproduct-managementproject-managementroadmapself-hostedsprint-planningteam-collaborationtrello-alternative
import { useQuery, useQueryClient } from '@tanstack/react-query';
import { useSession } from '@/lib/auth-client';
import { getProject } from '@/lib/api/endpoints/projects';
import { qk } from '@/services/queryKeys';
import { resolveLinkPreview } from './resolveLinkPreview';
import { linkPreviewDestination } from './linkPreviewDestination';
async function preloadImage(src: string, signal: AbortSignal) {
await new Promise<void>((resolve) => {
const image = new Image();
const finish = () => {
clearTimeout(timer);
signal.removeEventListener('abort', finish);
image.onload = null;
image.onerror = null;
if (signal.aborted) image.removeAttribute('src');
resolve();
};
const timer = setTimeout(finish, 800);
image.referrerPolicy = 'no-referrer';
image.onload = finish;
image.onerror = finish;
signal.addEventListener('abort', finish, { once: true });
image.src = src;
});
}
export function useLinkPreviewQuery(url: string | undefined) {
const queryClient = useQueryClient();
const { data: session, isPending: sessionPending } = useSession();
const origin = typeof window === 'undefined' ? undefined : window.location.origin;
const destination = url ? linkPreviewDestination(url, origin) : null;
const href = destination?.href;
const internal = !!destination && destination.origin === origin;
const enabled = !!href && !!session?.user.id && !sessionPending;
const queryKey = ['link-preview', session?.user.id, href];
if (internal) queryKey.push(session?.session?.id);
const query = useQuery({
queryKey,
enabled,
queryFn: async ({ signal }) => {
// Through the project query, links to several issues of one project that load at
// the same time share one request, and each load still checks access again.
const preview = await resolveLinkPreview(href!, window.location.origin, signal, (key) =>
queryClient.fetchQuery({ queryKey: qk.project(key), queryFn: () => getProject(key) }),
);
if (preview.image && !signal.aborted) {
await preloadImage(preview.image, signal);
}
signal.throwIfAborted();
return preview;
},
staleTime: (query) => {
if (internal) return 0;
const preview = query.state.data;
return preview?.title || preview?.description || preview?.image || preview?.siteName
? 5 * 60_000
: 15_000;
},
gcTime: internal ? 0 : 2 * 60_000,
retry: false,
refetchOnMount: internal ? 'always' : true,
refetchOnWindowFocus: false,
});
return {
...query,
data:
!enabled || query.isError || (internal && query.fetchStatus !== 'idle')
? undefined
: query.data,
isPending:
sessionPending ||
(enabled && (query.isPending || (internal && query.fetchStatus !== 'idle'))),
};
}