Skip to content

Beautiful, AI-native markdown IDE and LLM wiki

7.4 KB
Raw Blame
import type { ShareFreshness } from '@inkeep/open-knowledge-core/schemas/api';
import { Trans, useLingui } from '@lingui/react/macro';
import { ArrowUpRight, Check, Info, RefreshCw, TriangleAlert } from 'lucide-react';
import { useEffect, useRef, useState } from 'react';
import { Button } from '@/components/ui/button';
import { Spinner } from '@/components/ui/spinner';
import {
  useEnableSyncWithConfirm,
  useSyncEnabledWriter,
} from '@/hooks/use-enable-sync-with-confirm';
import type { GitSyncStatus } from '@/hooks/use-git-sync-status';
import { dispatchExternalLinkClick } from '@/lib/external-link';
import { triggerSync } from '@/lib/trigger-sync';
import { cn } from '@/lib/utils';
import { EnableSyncConfirmDialog } from './EnableSyncConfirmDialog';
import {
  displayState,
  isSyncDisablingPausedReason,
  PausedReasonNotice,
  SyncRefusedSymlinks,
} from './SyncStatusBadge';

type ShareKind = 'doc' | 'folder';

const PUSH_DOCS_URL = 'https://git-scm.com/docs/git-push';

export function shareFreshnessRowVisible(
  freshness: ShareFreshness | undefined,
  status: GitSyncStatus | null,
): boolean {
  if (freshness === 'empty') return true;
  if (freshness !== 'stale' && freshness !== 'absent') return false;
  if (freshness === 'stale' && status?.syncEnabled === true) return false;
  return true;
}

export function syncNowActionable(status: GitSyncStatus | null): boolean {
  if (!status) return false;
  const state = displayState(status);
  return (
    state !== 'dormant' && state !== 'disabled' && state !== 'auth-error' && state !== 'conflict'
  );
}

export function SyncNowPausedNotice({
  status,
  className,
}: {
  status: GitSyncStatus | null;
  className?: string;
}) {
  const reason = status?.pausedReason;
  if (!isSyncDisablingPausedReason(reason)) return null;
  return (
    <div
      className={cn('flex min-w-0 flex-col gap-1.5', className)}
      data-testid="sync-now-paused-notice"
    >
      <span>
        <PausedReasonNotice reason={reason} />
      </span>
      {reason === 'unsafe-incoming-symlinks' ? (
        <SyncRefusedSymlinks paths={status?.refusedSymlinkPaths} />
      ) : null}
    </div>
  );
}

export interface ShareFreshnessWarningProps {
  freshness: ShareFreshness | undefined;
  status: GitSyncStatus | null;
  kind: ShareKind;
}

export function ShareFreshnessWarning({ freshness, status, kind }: ShareFreshnessWarningProps) {
  const { t } = useLingui();
  const enableSyncWriter = useSyncEnabledWriter();
  const { confirmOpen, setConfirmOpen, onToggleRequest, onConfirm } =
    useEnableSyncWithConfirm(enableSyncWriter);
  const [syncNow, setSyncNow] = useState<'idle' | 'pending' | 'synced'>('idle');
  const lastSyncAtClick = useRef<string | null>(null);

  useEffect(() => {
    if (syncNow !== 'pending' || !status) return;
    if (status.pushError || status.pushErrorCode) {
      setSyncNow('idle');
      return;
    }
    if ((status.lastSyncUtc ?? null) !== lastSyncAtClick.current) {
      setSyncNow('synced');
    }
  }, [syncNow, status]);

  if (!shareFreshnessRowVisible(freshness, status)) return null;

  const rowClass =
    'flex items-start gap-2 rounded-md border border-dashed border-border bg-muted/40 p-2 text-xs text-muted-foreground';

  if (freshness === 'empty') {
    return (
      <div className={rowClass} data-testid="share-freshness-row">
        <TriangleAlert className="mt-0.5 size-3.5 shrink-0" aria-hidden="true" />
        <span>
          {t`Git can't track this folder — it's empty or contains only ignored files. The link won't work until you add a tracked document.`}
        </span>
      </div>
    );
  }

  if (syncNow === 'synced') {
    return (
      <div className={rowClass} data-testid="share-freshness-row">
        <Check className="mt-0.5 size-3.5 shrink-0" aria-hidden="true" />
        <span>
          <Trans>Synced. The link is up to date.</Trans>
        </span>
      </div>
    );
  }

  const syncEnabled = status?.syncEnabled === true;
  const pushDenied = status?.pushPermission?.checkStatus === 'denied';
  const activePushError = Boolean(status?.pushError || status?.pushErrorCode);
  const degraded = pushDenied || activePushError;
  const strong = freshness === 'absent' && !syncEnabled;

  let factLine: string;
  if (freshness === 'absent' && !syncEnabled) {
    factLine =
      kind === 'folder'
        ? t`This folder isn't on GitHub yet. The link won't work until it's pushed.`
        : t`This doc isn't on GitHub yet. The link won't work until it's pushed.`;
  } else if (freshness === 'stale') {
    factLine =
      kind === 'folder'
        ? t`This folder has unpushed changes. Recipients will see the last pushed version.`
        : t`This doc has unpushed changes. Recipients will see the last pushed version.`;
  } else {
    factLine =
      kind === 'folder'
        ? t`This folder hasn't synced to GitHub yet. The link will work after the next sync.`
        : t`This doc hasn't synced to GitHub yet. The link will work after the next sync.`;
  }

  const degradedLine = pushDenied
    ? t`You don't have write access to this repo.`
    : activePushError
      ? t`Sync is failing. See the sync status for details.`
      : null;

  const handleSyncNow = () => {
    lastSyncAtClick.current = status?.lastSyncUtc ?? null;
    setSyncNow('pending');
    triggerSync('sync').catch((err) => {
      console.warn(
        '[share-freshness] sync trigger failed',
        err instanceof Error ? err.message : err,
      );
      setSyncNow('idle');
    });
  };

  const Icon = strong ? TriangleAlert : Info;

  return (
    <>
      <div className={rowClass} data-testid="share-freshness-row">
        <Icon className="mt-0.5 size-3.5 shrink-0" aria-hidden="true" />
        <div className="flex min-w-0 flex-col gap-1.5">
          <span>{factLine}</span>
          {degradedLine ? <span>{degradedLine}</span> : null}
          {degraded ? null : syncEnabled ? (
            syncNowActionable(status) ? (
              <div>
                {syncNow === 'pending' ? (
                  <Button variant="outline" size="xs" disabled>
                    <Spinner icon={RefreshCw} className="size-3 shrink-0" aria-hidden="true" />
                    <Trans>Syncing</Trans>
                  </Button>
                ) : (
                  <Button variant="outline" size="xs" onClick={handleSyncNow}>
                    <Trans>Sync now</Trans>
                  </Button>
                )}
              </div>
            ) : (
              <SyncNowPausedNotice status={status} />
            )
          ) : (
            <div className="flex flex-wrap items-center gap-x-3 gap-y-1.5">
              <Button variant="outline" size="xs" onClick={() => onToggleRequest(true)}>
                <Trans>Enable Auto (Pull and Push)</Trans>
              </Button>
              <a
                href={PUSH_DOCS_URL}
                target="_blank"
                rel="noopener noreferrer"
                onClick={(e) => dispatchExternalLinkClick(e, PUSH_DOCS_URL)}
                onAuxClick={(e) => dispatchExternalLinkClick(e, PUSH_DOCS_URL)}
                className="inline-flex items-center gap-1 transition-colors hover:text-primary"
              >
                <Trans>How to push manually</Trans>
                <ArrowUpRight className="size-3 shrink-0" aria-hidden="true" />
              </a>
            </div>
          )}
        </div>
      </div>
      <EnableSyncConfirmDialog
        open={confirmOpen}
        onOpenChange={setConfirmOpen}
        onConfirm={onConfirm}
      />
    </>
  );
}