terms.service.ts

const axios = import("axios").then((m) => m.default);
import memoize from "lodash/memoize";
import type {
  QlitCollection,
  QlitCollectionRaw,
  QlitName,
  QlitTerm,
  QlitTermRaw,
} from "./qlit.types";

/**
 * Location of the thesaurus backend service.
 *
 * See https://github.com/gu-gridh/queerlit-terms for API and more information.
 */
const QLIT_BASE =
  import.meta.env.VITE_QLIT_BASE || "https://queerlit.dh.gu.se/qlit/v1/api/";

/** Get a single term. */
async function qlitGet<T = any>(
  endpoint: string,
  params?: Record<string, any>,
): Promise<T> {
  const response = await (await axios).get(QLIT_BASE + endpoint, { params });
  return response.data;
}

/** Get multiple terms and sort alphabetically. */
async function qlitList(endpoint: string, params?: Record<string, any>) {
  const data: QlitTermRaw[] = await qlitGet(endpoint, params);
  const terms = data.map(processTerm);
  return terms;
}

export const getTerm = memoize(async (name: QlitName) => {
  const data = await qlitGet<QlitTermRaw>("term/" + name);
  return processTerm(data);
});

export const getParents = memoize(async (narrower: QlitName) =>
  qlitList("broader", { narrower }),
);

export const getChildren = memoize(async (broader: QlitName) =>
  qlitList("narrower", { broader }),
);

export const getRelated = memoize(async (other: QlitName) =>
  qlitList("related", { other }),
);

export const getRoots = memoize(async () => qlitList("roots"));

export async function searchTerms(s: string) {
  return qlitList("search", { s });
}

export const getCollections = memoize(async (): Promise<QlitCollection[]> => {
  const collections = await qlitGet<QlitCollectionRaw[]>("collections");
  return collections.map((collection) => ({
    ...collection,
    id: collection.uri,
    label: collection.prefLabel
      .replace("Tema: ", "")
      .replace(/ \(HBTQI\)/i, ""),
  }));
});

export const getCollection = memoize(async (name: QlitName) =>
  qlitList("collections/" + name),
);

export const getLabels = memoize(async () =>
  qlitGet<Readonly<Record<QlitName, string>>>("labels"),
);

function processTerm(term: QlitTermRaw): QlitTerm {
  return {
    id: term.uri,
    label: term.prefLabel,
    scheme: "https://queerlit.dh.gu.se/qlit/v1",
    name: term.name,
    altLabels: term.altLabels,
    hiddenLabels: term.hiddenLabels,
    scopeNote: term.scopeNote,
    broader: term.broader,
    narrower: term.narrower,
    related: term.related,
    exactMatch: term.exactMatch,
    closeMatch: term.closeMatch,
  };
}