@tuturuuu/utils 0.25.2 → 0.25.3

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.25.3](https://github.com/tutur3u/platform/compare/utils-v0.25.2...utils-v0.25.3) (2026-08-20)
+
+
+### Bug Fixes
+
+* **tasks:** keep optimistic creates at top ([fed3be6](https://github.com/tutur3u/platform/commit/fed3be688b954ebae8153647609cf8710b99171a))
+* **tasks:** preserve cached ticket prefixes ([59a4b31](https://github.com/tutur3u/platform/commit/59a4b3109046f910bd586aee8af3200afffcd65f))
+
 ## [0.25.2](https://github.com/tutur3u/platform/compare/utils-v0.25.1...utils-v0.25.2) (2026-08-16)
 
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tuturuuu/utils",
   "license": "MIT",
-  "version": "0.25.2",
+  "version": "0.25.3",
   "repository": {
     "type": "git",
     "url": "https://github.com/tutur3u/platform",
@@ -24,7 +24,7 @@
     "@tiptap/react": "3.30.0",
     "@tuturuuu/google": "0.1.0",
     "@tuturuuu/icons": "0.1.0",
-    "@tuturuuu/internal-api": "0.31.0",
+    "@tuturuuu/internal-api": "0.31.1",
     "@tuturuuu/supabase": "0.5.0",
     "@upstash/ratelimit": "^2.0.8",
     "@upstash/redis": "^1.38.2",

package/src/__tests__/optimistic-task-cache.test.ts

@@ -7,7 +7,11 @@ import {
   removeOptimisticTaskFromBoardCaches,
 } from '../task-helper/optimistic-task-cache';
 
-function task(id: string, listId = 'list-1'): Task {
+function task(
+  id: string,
+  listId = 'list-1',
+  overrides: Partial<Task> = {}
+): Task {
   return {
     assignees: [],
     created_at: '2026-08-14T00:00:00.000Z',
@@ -16,6 +20,7 @@ function task(id: string, listId = 'list-1'): Task {
     list_id: listId,
     name: id,
     projects: [],
+    ...overrides,
   } as unknown as Task;
 }
 
@@ -23,7 +28,7 @@ describe('optimistic task creation cache lifecycle', () => {
   it('inserts the pending task into the board and every mounted full-task variant', () => {
     const queryClient = new QueryClient();
     const boardId = 'board-1';
-    const existingTask = task('existing');
+    const existingTask = task('existing', 'list-1', { sort_key: 1_000_000 });
     const optimisticTask = {
       ...task('optimistic-1'),
       _isOptimistic: true,
@@ -40,21 +45,78 @@ describe('optimistic task creation cache lifecycle', () => {
     insertOptimisticTaskIntoBoardCaches(queryClient, boardId, optimisticTask);
 
     expect(queryClient.getQueryData(['tasks', boardId])).toEqual([
+      expect.objectContaining({
+        id: optimisticTask.id,
+        sort_key: expect.any(Number),
+      }),
       existingTask,
-      optimisticTask,
     ]);
     expect(queryClient.getQueryData(['tasks-full', boardId])).toEqual([
+      expect.objectContaining({
+        id: optimisticTask.id,
+        sort_key: expect.any(Number),
+      }),
       existingTask,
-      optimisticTask,
     ]);
     expect(
       queryClient.getQueryData(['tasks-full', boardId, 'filtered'])
-    ).toEqual([existingTask, optimisticTask]);
+    ).toEqual([
+      expect.objectContaining({
+        id: optimisticTask.id,
+        sort_key: expect.any(Number),
+      }),
+      existingTask,
+    ]);
     expect(queryClient.getQueryData(['tasks-full', 'another-board'])).toEqual([
       existingTask,
     ]);
   });
 
+  it('orders consecutive optimistic creates above mixed local and placed external tasks', () => {
+    const queryClient = new QueryClient();
+    const boardId = 'board-1';
+    const localTask = task('local', 'list-1', { sort_key: 1_000_000 });
+    const externalTask = task('external', 'list-1', {
+      is_personal_external: true,
+      is_personal_external_default: false,
+      personal_sort_key: 500_000,
+      sort_key: 9_000_000,
+    });
+    const firstOptimisticTask = {
+      ...task('optimistic-1'),
+      _isOptimistic: true,
+    } as Task;
+    const secondOptimisticTask = {
+      ...task('optimistic-2'),
+      _isOptimistic: true,
+    } as Task;
+
+    queryClient.setQueryData(['tasks', boardId], [externalTask, localTask]);
+
+    insertOptimisticTaskIntoBoardCaches(
+      queryClient,
+      boardId,
+      firstOptimisticTask
+    );
+    insertOptimisticTaskIntoBoardCaches(
+      queryClient,
+      boardId,
+      secondOptimisticTask
+    );
+
+    const tasks = queryClient.getQueryData<Task[]>(['tasks', boardId]);
+    expect(tasks?.map(({ id }) => id)).toEqual([
+      'optimistic-2',
+      'optimistic-1',
+      'external',
+      'local',
+    ]);
+    expect(tasks?.[0]?.sort_key).toBeLessThan(tasks?.[1]?.sort_key ?? 0);
+    expect(tasks?.[1]?.sort_key).toBeLessThan(
+      externalTask.personal_sort_key ?? 0
+    );
+  });
+
   it('replaces the pending task without duplicating a realtime server task', () => {
     const queryClient = new QueryClient();
     const boardId = 'board-1';

package/src/platform-release.test.ts

@@ -7,7 +7,7 @@ import {
 
 describe('platform release metadata', () => {
   it('uses the centralized shared browser app version', () => {
-    expect(TUTURUUU_PLATFORM_VERSION).toBe('0.39.0'); // x-release-please-version
+    expect(TUTURUUU_PLATFORM_VERSION).toBe('0.40.0'); // x-release-please-version
   });
 
   it('preserves the source timestamp in builtAt and derives a short hash', () => {

package/src/platform-release.ts

@@ -1,6 +1,6 @@
 import { PLATFORM_BUILD_METADATA } from './generated/platform-build-metadata';
 
-export const TUTURUUU_PLATFORM_VERSION = '0.39.0'; // x-release-please-version
+export const TUTURUUU_PLATFORM_VERSION = '0.40.0'; // x-release-please-version
 
 export type PlatformBuildMetadataInput = {
   /** ISO timestamp of the source commit used for the build, not deployment time. */

package/src/task-helper/board.test.ts

@@ -0,0 +1,54 @@
+import { QueryClient } from '@tanstack/react-query';
+import type { WorkspaceTaskBoard } from '@tuturuuu/types';
+import { describe, expect, it } from 'vitest';
+import { getCachedBoardConfig, toBoardConfig } from './board';
+
+function board(overrides: Partial<WorkspaceTaskBoard> = {}) {
+  return {
+    id: 'board-1',
+    name: 'Roadmap',
+    ws_id: 'workspace-1',
+    ticket_prefix: 'VHP',
+    ...overrides,
+  } as WorkspaceTaskBoard;
+}
+
+describe('board config cache', () => {
+  it('derives the ticket prefix and estimation defaults from cached board metadata', () => {
+    expect(toBoardConfig(board())).toEqual({
+      id: 'board-1',
+      name: 'Roadmap',
+      ws_id: 'workspace-1',
+      ticket_prefix: 'VHP',
+      estimation_type: null,
+      extended_estimation: false,
+      allow_zero_estimates: false,
+      count_unestimated_issues: false,
+    });
+  });
+
+  it('finds a cached personal board by board id when its query scope uses an alias', () => {
+    const queryClient = new QueryClient();
+    queryClient.setQueryData(
+      ['task-board', 'personal', 'board-1'],
+      board({ ws_id: 'user-workspace-id' })
+    );
+
+    expect(
+      getCachedBoardConfig(queryClient, 'board-1', 'user-workspace-id')
+        ?.ticket_prefix
+    ).toBe('VHP');
+  });
+
+  it('does not reuse metadata from another board', () => {
+    const queryClient = new QueryClient();
+    queryClient.setQueryData(
+      ['task-board', 'workspace-1', 'board-2'],
+      board({ id: 'board-2' })
+    );
+
+    expect(
+      getCachedBoardConfig(queryClient, 'board-1', 'workspace-1')
+    ).toBeUndefined();
+  });
+});

package/src/task-helper/board.ts

@@ -1,4 +1,9 @@
-import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
+import {
+  type QueryClient,
+  useMutation,
+  useQuery,
+  useQueryClient,
+} from '@tanstack/react-query';
 import type { InternalApiClientOptions } from '@tuturuuu/internal-api/client';
 import {
   createWorkspaceTaskBoard,
@@ -162,10 +167,41 @@ export interface BoardConfig {
   ticket_prefix: string | null;
 }
 
+export function toBoardConfig(board: WorkspaceTaskBoard): BoardConfig {
+  return {
+    id: board.id,
+    name: board.name ?? null,
+    estimation_type: board.estimation_type ?? null,
+    extended_estimation: board.extended_estimation ?? false,
+    allow_zero_estimates: board.allow_zero_estimates ?? false,
+    count_unestimated_issues: board.count_unestimated_issues ?? false,
+    ws_id: board.ws_id,
+    ticket_prefix: board.ticket_prefix ?? null,
+  };
+}
+
+export function getCachedBoardConfig(
+  queryClient: Pick<QueryClient, 'getQueriesData'>,
+  boardId: string,
+  wsId: string
+): BoardConfig | undefined {
+  const boards = queryClient
+    .getQueriesData<WorkspaceTaskBoard>({ queryKey: ['task-board'] })
+    .map(([, cachedBoard]) => cachedBoard);
+  const board =
+    boards.find(
+      (cachedBoard) => cachedBoard?.id === boardId && cachedBoard.ws_id === wsId
+    ) ?? boards.find((cachedBoard) => cachedBoard?.id === boardId);
+
+  return board ? toBoardConfig(board) : undefined;
+}
+
 export function useBoardConfig(
   boardId: string | null | undefined,
   wsId: string | null | undefined
 ) {
+  const queryClient = useQueryClient();
+
   return useQuery({
     queryKey: ['board-config', wsId, boardId],
     queryFn: async () => {
@@ -179,18 +215,13 @@ export function useBoardConfig(
         return null;
       }
 
-      return {
-        id: board.id,
-        name: board.name ?? null,
-        estimation_type: board.estimation_type ?? null,
-        extended_estimation: board.extended_estimation ?? false,
-        allow_zero_estimates: board.allow_zero_estimates ?? false,
-        count_unestimated_issues: board.count_unestimated_issues ?? false,
-        ws_id: board.ws_id,
-        ticket_prefix: board.ticket_prefix ?? null,
-      } as BoardConfig;
+      return toBoardConfig(board);
     },
     enabled: Boolean(boardId && wsId),
+    placeholderData: () =>
+      boardId && wsId
+        ? getCachedBoardConfig(queryClient, boardId, wsId)
+        : undefined,
     staleTime: 10 * 60 * 1000,
     refetchOnWindowFocus: false,
   });

package/src/task-helper/optimistic-task-cache.ts

@@ -3,6 +3,58 @@ import type { Task } from '@tuturuuu/types/primitives/Task';
 
 export type OptimisticTask = Task & { _isOptimistic: true };
 
+const EMPTY_LIST_OPTIMISTIC_SORT_KEY = 1_000_000_000;
+
+function getEffectiveTaskSortKey(task: Task) {
+  if (
+    task.is_personal_external === true &&
+    task.is_personal_external_default !== true &&
+    typeof task.personal_sort_key === 'number' &&
+    Number.isFinite(task.personal_sort_key)
+  ) {
+    return task.personal_sort_key;
+  }
+
+  return typeof task.sort_key === 'number' && Number.isFinite(task.sort_key)
+    ? task.sort_key
+    : null;
+}
+
+function getOptimisticTopSortKey(
+  queryClient: QueryClient,
+  boardId: string,
+  optimisticTask: Task
+) {
+  const cachedTaskSets = queryClient.getQueriesData<Task[]>({
+    predicate: ({ queryKey }) =>
+      (queryKey[0] === 'tasks' || queryKey[0] === 'tasks-full') &&
+      queryKey[1] === boardId,
+  });
+  let minimumSortKey: number | null = null;
+
+  for (const [, tasks] of cachedTaskSets) {
+    for (const task of tasks ?? []) {
+      if (
+        task.id === optimisticTask.id ||
+        task.list_id !== optimisticTask.list_id
+      ) {
+        continue;
+      }
+
+      const sortKey = getEffectiveTaskSortKey(task);
+      if (
+        sortKey !== null &&
+        (minimumSortKey === null || sortKey < minimumSortKey)
+      ) {
+        minimumSortKey = sortKey;
+      }
+    }
+  }
+
+  if (minimumSortKey === null) return EMPTY_LIST_OPTIMISTIC_SORT_KEY;
+  return Math.max(Number.MIN_SAFE_INTEGER, minimumSortKey - 1);
+}
+
 function updateOptimisticTaskCaches(
   queryClient: QueryClient,
   boardId: string,
@@ -53,12 +105,17 @@ export function insertOptimisticTaskIntoBoardCaches(
     { revert: false }
   );
 
+  const taskAtTop = {
+    ...optimisticTask,
+    sort_key: getOptimisticTopSortKey(queryClient, boardId, optimisticTask),
+  };
+
   updateOptimisticTaskCaches(queryClient, boardId, (tasks) => {
     const currentTasks = tasks ?? [];
     if (currentTasks.some((task) => task.id === optimisticTask.id)) {
       return currentTasks;
     }
-    return [...currentTasks, optimisticTask];
+    return [taskAtTop, ...currentTasks];
   });
 }