Skip to content

armgit / kaneo

Public Imported from GitHub
0

⚡ Project management that doesn't become the project. Boards, Gantt charts, and GitHub integration. Self-host it or use Kaneo Cloud.

3.1 KB
Raw Blame
import { api } from "./endpoints";
import type { BoardColumn, BoardData, BoardTask, TaskLabel } from "./types";

function mergeLabels(a: TaskLabel[] = [], b: TaskLabel[] = []): TaskLabel[] {
  const byId = new Map<string, TaskLabel>();
  [...a, ...b].forEach((l) => byId.set(l.id, l));
  return [...byId.values()];
}

function appendTo(target: Map<string, BoardTask>, tasks: BoardTask[] = []) {
  for (const task of tasks) {
    const prior = target.get(task.id);
    target.set(
      task.id,
      prior
        ? { ...prior, labels: mergeLabels(prior.labels, task.labels) }
        : task,
    );
  }
}

/**
 * Loads every page of a board. The API pages tasks (100 at most) and, per task page, pages the
 * related labels separately; both are followed to completion and merged by id.
 */
export async function loadFullBoard(projectId: string): Promise<BoardData> {
  const first = await api.board(projectId, 1);
  const columnMeta = new Map<string, BoardColumn>();
  const columnTasks = new Map<string, Map<string, BoardTask>>();
  const archived = new Map<string, BoardTask>();
  const planned = new Map<string, BoardTask>();

  const merge = (data: BoardData) => {
    for (const column of data.columns ?? []) {
      if (!columnMeta.has(column.id))
        columnMeta.set(column.id, { ...column, tasks: [] });
      if (!columnTasks.has(column.id)) columnTasks.set(column.id, new Map());
      appendTo(columnTasks.get(column.id)!, column.tasks);
    }
    appendTo(archived, data.archivedTasks);
    appendTo(planned, data.plannedTasks);
  };

  const loadRelated = async (page: number, relatedTotal = 1) => {
    for (let related = 2; related <= relatedTotal; related++)
      merge((await api.board(projectId, page, related)).data);
  };

  merge(first.data);
  await loadRelated(1, first.pagination?.relatedTotalPages);
  for (let page = 2; page <= (first.pagination?.totalPages ?? 1); page++) {
    const next = await api.board(projectId, page);
    merge(next.data);
    await loadRelated(page, next.pagination?.relatedTotalPages);
  }

  const byPosition = (a: BoardTask, b: BoardTask) =>
    (a.position ?? Number.MAX_VALUE) - (b.position ?? Number.MAX_VALUE);
  return {
    ...first.data,
    columns: [...columnMeta.values()]
      .sort((a, b) => (a.position ?? 0) - (b.position ?? 0))
      .map((meta) => ({
        ...meta,
        tasks: [...(columnTasks.get(meta.id)?.values() ?? [])].sort(byPosition),
      })),
    archivedTasks: [...archived.values()],
    plannedTasks: [...planned.values()],
  };
}

/** Reads a task description, following description pages when the detail view defers a large body. */
export async function loadDescription(
  taskId: string,
  inline: string | null | undefined,
  deferred: boolean,
): Promise<string> {
  if (!deferred) return inline ?? "";
  let text = "";
  let offset: number | null | undefined = 0;
  let version: string | undefined;
  while (offset !== null && offset !== undefined) {
    const page = await api.descriptionPage(taskId, offset, version);
    version = page.version;
    text += page.content;
    offset = page.nextOffset;
  }
  return text;
}