@tuturuuu/utils 0.0.2 → 0.6.0

package/src/task-description-content.ts

@@ -0,0 +1,240 @@
+import type { JSONContent } from '@tiptap/core';
+import { Node as ProseMirrorNode, Schema } from 'prosemirror-model';
+import { getDescriptionText } from './text-helper';
+
+export const taskDescriptionSchema = new Schema({
+  nodes: {
+    doc: { content: 'block+' },
+    paragraph: {
+      group: 'block',
+      content: 'inline*',
+      attrs: { textAlign: { default: null } },
+    },
+    heading: {
+      group: 'block',
+      content: 'inline*',
+      attrs: {
+        level: { default: 1 },
+        textAlign: { default: null },
+      },
+    },
+    blockquote: {
+      group: 'block',
+      content: 'block+',
+    },
+    codeBlock: {
+      group: 'block',
+      content: 'text*',
+      marks: '',
+      attrs: { language: { default: null } },
+      code: true,
+    },
+    bulletList: {
+      group: 'block',
+      content: 'listItem+',
+    },
+    orderedList: {
+      group: 'block',
+      content: 'listItem+',
+      attrs: { start: { default: 1 } },
+    },
+    listItem: {
+      content: 'paragraph block*',
+      defining: true,
+    },
+    taskList: {
+      group: 'block',
+      content: 'taskItem+',
+    },
+    taskItem: {
+      content: 'paragraph block*',
+      attrs: { checked: { default: false } },
+      defining: true,
+    },
+    table: {
+      group: 'block',
+      content: 'tableRow+',
+    },
+    tableRow: {
+      content: '(tableCell | tableHeader)+',
+    },
+    tableCell: {
+      content: 'block+',
+      attrs: {
+        colspan: { default: 1 },
+        rowspan: { default: 1 },
+        colwidth: { default: null },
+      },
+    },
+    tableHeader: {
+      content: 'block+',
+      attrs: {
+        colspan: { default: 1 },
+        rowspan: { default: 1 },
+        colwidth: { default: null },
+      },
+    },
+    horizontalRule: {
+      group: 'block',
+    },
+    imageResize: {
+      group: 'block',
+      atom: true,
+      attrs: {
+        src: { default: null },
+        alt: { default: null },
+        title: { default: null },
+        width: { default: null },
+        height: { default: null },
+      },
+    },
+    video: {
+      group: 'block',
+      atom: true,
+      attrs: {
+        src: { default: null },
+      },
+    },
+    youtube: {
+      group: 'block',
+      atom: true,
+      attrs: {
+        src: { default: null },
+        videoId: { default: null },
+      },
+    },
+    mention: {
+      group: 'inline',
+      inline: true,
+      atom: true,
+      attrs: {
+        id: { default: null },
+        label: { default: null },
+        userId: { default: null },
+        displayName: { default: null },
+        entityId: { default: null },
+        entityType: { default: null },
+        avatarUrl: { default: null },
+        subtitle: { default: null },
+        priority: { default: null },
+        listColor: { default: null },
+        assignees: { default: null },
+        workspaceId: { default: null },
+      },
+    },
+    text: {
+      group: 'inline',
+    },
+    hardBreak: {
+      group: 'inline',
+      inline: true,
+      selectable: false,
+    },
+  },
+  marks: {
+    bold: {},
+    italic: {},
+    strike: {},
+    underline: {},
+    code: {},
+    subscript: {},
+    superscript: {},
+    textStyle: {
+      attrs: {
+        color: { default: null },
+      },
+    },
+    highlight: {
+      attrs: {
+        color: { default: null },
+      },
+    },
+    link: {
+      attrs: {
+        href: { default: null },
+        target: { default: null },
+        rel: { default: null },
+        class: { default: null },
+        title: { default: null },
+      },
+      inclusive: false,
+    },
+  },
+});
+
+/**
+ * Transforms legacy 'image' nodes to 'imageResize' nodes for schema compatibility.
+ * The web app uses tiptap-extension-resize-image which registers 'imageResize' only.
+ */
+function transformImageNodes(content: JSONContent): JSONContent {
+  if (typeof content !== 'object' || content === null) {
+    return content;
+  }
+
+  if (Array.isArray(content)) {
+    return content.map(transformImageNodes) as JSONContent;
+  }
+
+  const transformed: JSONContent = { ...content };
+
+  if (transformed.type === 'image') {
+    transformed.type = 'imageResize';
+  }
+
+  if (Array.isArray(transformed.content)) {
+    transformed.content = transformed.content.map(transformImageNodes);
+  }
+
+  return transformed;
+}
+
+export function parseTaskDescriptionContent(description: string): JSONContent {
+  try {
+    const parsed = JSON.parse(description);
+    if (
+      parsed &&
+      typeof parsed === 'object' &&
+      !Array.isArray(parsed) &&
+      parsed.type === 'doc'
+    ) {
+      return transformImageNodes(parsed as JSONContent);
+    }
+  } catch {
+    // Fall through to plain-text conversion.
+  }
+
+  return {
+    type: 'doc',
+    content: [
+      {
+        type: 'paragraph',
+        content: [{ type: 'text', text: description }],
+      },
+    ],
+  };
+}
+
+export function hasMeaningfulTaskDescriptionContent(
+  content: JSONContent
+): boolean {
+  return getDescriptionText(content).trim().length > 0;
+}
+
+export function isValidTaskDescriptionContent(
+  description: string | null | undefined
+): boolean {
+  const normalizedDescription = description?.trim();
+  if (!normalizedDescription) {
+    return true;
+  }
+
+  try {
+    ProseMirrorNode.fromJSON(
+      taskDescriptionSchema,
+      parseTaskDescriptionContent(normalizedDescription)
+    );
+    return true;
+  } catch {
+    return false;
+  }
+}

package/src/task-helper/board.ts

@@ -0,0 +1,193 @@
+import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
+import type { InternalApiClientOptions } from '@tuturuuu/internal-api/client';
+import {
+  createWorkspaceTaskBoard,
+  getWorkspaceTaskBoard as getWorkspaceTaskBoardFromApi,
+  listWorkspaceLabels,
+  updateWorkspaceTaskBoard,
+  updateWorkspaceTaskList,
+} from '@tuturuuu/internal-api/tasks';
+import type { Database, WorkspaceTaskBoard } from '@tuturuuu/types';
+import { getMutationApiOptions } from './shared';
+
+export async function getTaskBoard(
+  boardId: string,
+  workspaceId?: string,
+  options?: InternalApiClientOptions
+) {
+  if (!workspaceId) {
+    return null;
+  }
+
+  const payload = await getWorkspaceTaskBoardFromApi(
+    workspaceId,
+    boardId,
+    options
+  );
+
+  return (payload.board ?? null) as WorkspaceTaskBoard | null;
+}
+
+export async function createBoardWithTemplate(
+  wsId: string,
+  name: string,
+  templateId?: string,
+  icon?: Database['public']['Enums']['platform_icon'] | null,
+  options?: InternalApiClientOptions
+) {
+  const payload = await createWorkspaceTaskBoard(
+    wsId,
+    {
+      name,
+      template_id: templateId,
+      icon: icon ?? null,
+    },
+    options
+  );
+
+  return payload.board as WorkspaceTaskBoard;
+}
+
+export async function deleteTaskList(
+  wsId: string,
+  boardId: string,
+  listId: string
+) {
+  const options = await getMutationApiOptions();
+  const { list } = await updateWorkspaceTaskList(
+    wsId,
+    boardId,
+    listId,
+    { deleted: true },
+    options
+  );
+
+  return list;
+}
+
+export function useCreateBoardWithTemplate(wsId: string) {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({
+      name,
+      templateId,
+      icon,
+    }: {
+      name: string;
+      templateId?: string;
+      icon?: Database['public']['Enums']['platform_icon'] | null;
+    }) => {
+      const baseUrl =
+        typeof window !== 'undefined' ? window.location.origin : undefined;
+      return createBoardWithTemplate(wsId, name, templateId, icon, {
+        baseUrl: baseUrl ?? undefined,
+      });
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ['boards', wsId] });
+    },
+    onError: (error) => {
+      console.error('Error creating board:', error);
+    },
+  });
+}
+
+export function useUpdateBoardWithTemplate(wsId: string) {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({
+      boardId,
+      name,
+      icon,
+    }: {
+      boardId: string;
+      name: string;
+      icon: string | null;
+    }) => {
+      return updateWorkspaceTaskBoard(
+        wsId,
+        boardId,
+        {
+          name,
+          icon: icon as Database['public']['Enums']['platform_icon'] | null,
+        },
+        {
+          baseUrl:
+            typeof window !== 'undefined' ? window.location.origin : undefined,
+        }
+      );
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ['boards', wsId] });
+    },
+    onError: (error) => {
+      console.error('Error updating board:', error);
+    },
+  });
+}
+
+export interface WorkspaceLabel {
+  id: string;
+  name: string;
+  color: string;
+  created_at: string;
+  ws_id: string;
+}
+
+export function useWorkspaceLabels(wsId: string | null | undefined) {
+  return useQuery({
+    queryKey: ['workspace-labels', wsId],
+    queryFn: async () => {
+      if (!wsId) return [];
+
+      const labels = await listWorkspaceLabels(wsId);
+      return labels as WorkspaceLabel[];
+    },
+    enabled: Boolean(wsId),
+    staleTime: 5 * 60 * 1000,
+    refetchOnWindowFocus: false,
+  });
+}
+
+export interface BoardConfig {
+  id: string;
+  estimation_type: string | null;
+  extended_estimation: boolean;
+  allow_zero_estimates: boolean;
+  ws_id: string;
+  ticket_prefix: string | null;
+}
+
+export function useBoardConfig(
+  boardId: string | null | undefined,
+  wsId: string | null | undefined
+) {
+  return useQuery({
+    queryKey: ['board-config', wsId, boardId],
+    queryFn: async () => {
+      if (!boardId || !wsId) {
+        return null;
+      }
+
+      const payload = await getWorkspaceTaskBoardFromApi(wsId, boardId);
+      const board = payload.board;
+      if (!board) {
+        return null;
+      }
+
+      return {
+        id: board.id,
+        estimation_type: board.estimation_type ?? null,
+        extended_estimation: board.extended_estimation ?? false,
+        allow_zero_estimates: board.allow_zero_estimates ?? false,
+        ws_id: board.ws_id,
+        ticket_prefix: board.ticket_prefix ?? null,
+      } as BoardConfig;
+    },
+    enabled: Boolean(boardId && wsId),
+    staleTime: 10 * 60 * 1000,
+    refetchOnWindowFocus: false,
+  });
+}