Skip to content

Beautiful, AI-native markdown IDE and LLM wiki

2.9 KB
Raw Blame
import {
  type SkillFolderLinkPreview,
  type SkillScope,
  type SkillTargetsGetSuccess,
  SkillTargetsGetSuccessSchema,
} from '@inkeep/open-knowledge-core/schemas/api';
import { t } from '@lingui/core/macro';
import { useEffect, useState } from 'react';
import { emitSkillsChanged } from '@/lib/documents-events';
import { parseApiError } from '@/lib/parse-api-error';
import { putSkillFolderAction } from '@/lib/skills-api';
import type { AsyncState } from './use-folder-config';

export interface SkillTargetsHandle {
  state: AsyncState<SkillTargetsGetSuccess>;
  saving: boolean;
  folderAction: (action: {
    scope: SkillScope;
    root: string;
    action: 'link' | 'unlink' | 'add-root';
    target?: string;
    preview?: boolean;
  }) => Promise<SkillFolderLinkPreview | undefined>;
}

export function useSkillTargets(): SkillTargetsHandle {
  const [state, setState] = useState<AsyncState<SkillTargetsGetSuccess>>({ status: 'idle' });
  const [refreshKey, setRefreshKey] = useState(0);
  const [saving, setSaving] = useState(false);

  // biome-ignore lint/correctness/useExhaustiveDependencies: re-fetch trigger is the only purpose of refreshKey
  useEffect(() => {
    let cancelled = false;
    setState({ status: 'loading' });
    fetch('/api/skill-targets')
      .then(async (r) => {
        if (!r.ok) {
          const body = (await r.json().catch(() => null)) as unknown;
          throw new Error(parseApiError(body) ?? `HTTP ${r.status}`);
        }
        return r.json() as Promise<unknown>;
      })
      .then((payload) => {
        if (cancelled) return;
        const parsed = SkillTargetsGetSuccessSchema.safeParse(payload);
        if (!parsed.success) {
          console.error(
            '[ok-skills] /api/skill-targets response failed schema validation:',
            parsed.error.issues,
          );
          setState({
            status: 'error',
            message: t`Server returned an incomplete skill-targets response.`,
          });
          return;
        }
        setState({ status: 'ready', data: parsed.data });
      })
      .catch((err: unknown) => {
        if (cancelled) return;
        setState({ status: 'error', message: err instanceof Error ? err.message : String(err) });
      });
    return () => {
      cancelled = true;
    };
  }, [refreshKey]);

  const folderAction = async (action: {
    scope: SkillScope;
    root: string;
    action: 'link' | 'unlink' | 'add-root';
    target?: string;
    preview?: boolean;
  }): Promise<SkillFolderLinkPreview | undefined> => {
    setSaving(true);
    const result = await putSkillFolderAction(action);
    if (!result.ok) {
      setSaving(false);
      throw new Error(result.error);
    }
    if (action.preview) {
      setSaving(false);
      return result.preview;
    }
    emitSkillsChanged();
    setRefreshKey((k) => k + 1);
    setSaving(false);
    return undefined;
  };

  return { state, saving, folderAction };
}