github-issue-tower-defence-management 1.90.0 → 1.91.1

package/src/adapter/entry-points/console/ui/src/features/console/hooks/useConsoleOverlay.ts

@@ -0,0 +1,71 @@
+import { useCallback, useState } from 'react';
+import { overlayStorageKey, writeOverlayEntry } from '../logic/overlay';
+import type {
+  ConsoleOverlay,
+  ConsoleOverlayEntry,
+  ConsoleTabName,
+} from '../logic/types';
+
+const isOverlayEntry = (value: unknown): value is ConsoleOverlayEntry =>
+  value !== null &&
+  typeof value === 'object' &&
+  typeof (value as { ts?: unknown }).ts === 'number';
+
+const readOverlay = (pjcode: string): ConsoleOverlay => {
+  if (typeof localStorage === 'undefined') {
+    return {};
+  }
+  const raw = localStorage.getItem(overlayStorageKey(pjcode));
+  if (raw === null) {
+    return {};
+  }
+  const parsed: unknown = JSON.parse(raw);
+  if (parsed === null || typeof parsed !== 'object') {
+    return {};
+  }
+  const overlay: ConsoleOverlay = {};
+  for (const [key, value] of Object.entries(parsed)) {
+    if (isOverlayEntry(value)) {
+      overlay[key] = value;
+    }
+  }
+  return overlay;
+};
+
+const persistOverlay = (pjcode: string, overlay: ConsoleOverlay): void => {
+  if (typeof localStorage !== 'undefined') {
+    localStorage.setItem(overlayStorageKey(pjcode), JSON.stringify(overlay));
+  }
+};
+
+export type ConsoleOverlayState = {
+  overlay: ConsoleOverlay;
+  patchOverlay: (
+    key: string,
+    patch: Partial<Omit<ConsoleOverlayEntry, 'ts' | 'mode'>>,
+    mode: ConsoleTabName,
+  ) => void;
+};
+
+export const useConsoleOverlay = (pjcode: string): ConsoleOverlayState => {
+  const [overlay, setOverlay] = useState<ConsoleOverlay>(() =>
+    readOverlay(pjcode),
+  );
+
+  const patchOverlay = useCallback(
+    (
+      key: string,
+      patch: Partial<Omit<ConsoleOverlayEntry, 'ts' | 'mode'>>,
+      mode: ConsoleTabName,
+    ) => {
+      setOverlay((current) => {
+        const next = writeOverlayEntry(current, key, patch, mode, Date.now());
+        persistOverlay(pjcode, next);
+        return next;
+      });
+    },
+    [pjcode],
+  );
+
+  return { overlay, patchOverlay };
+};

package/src/adapter/entry-points/console/ui/src/features/console/hooks/useConsoleResource.test.ts

@@ -0,0 +1,41 @@
+import { renderHook, waitFor } from '@testing-library/react';
+import { ResourceCache } from '../lib/resourceCache';
+import { useConsoleResource } from './useConsoleResource';
+
+describe('useConsoleResource', () => {
+  it('loads the resource and exposes loading then data', async () => {
+    const cache = new ResourceCache<string>(async () => 'loaded');
+    const { result } = renderHook(() =>
+      useConsoleResource(cache, 'k', 'u', 'fallback'),
+    );
+    expect(result.current.isLoading).toBe(true);
+    expect(result.current.data).toBe('fallback');
+    await waitFor(() => {
+      expect(result.current.isLoading).toBe(false);
+    });
+    expect(result.current.data).toBe('loaded');
+    expect(result.current.error).toBeNull();
+  });
+
+  it('stays idle with the fallback when the key is null', () => {
+    const cache = new ResourceCache<string>(async () => 'loaded');
+    const { result } = renderHook(() =>
+      useConsoleResource(cache, null, null, 'fallback'),
+    );
+    expect(result.current.isLoading).toBe(false);
+    expect(result.current.data).toBe('fallback');
+  });
+
+  it('surfaces a fetch error', async () => {
+    const cache = new ResourceCache<string>(async () => {
+      throw new Error('boom');
+    });
+    const { result } = renderHook(() =>
+      useConsoleResource(cache, 'k', 'u', 'fallback'),
+    );
+    await waitFor(() => {
+      expect(result.current.error).toBe('boom');
+    });
+    expect(result.current.isLoading).toBe(false);
+  });
+});

package/src/adapter/entry-points/console/ui/src/features/console/hooks/useConsoleResource.ts

@@ -0,0 +1,57 @@
+import { useEffect, useState } from 'react';
+import type { ResourceCache } from '../lib/resourceCache';
+
+export type ConsoleResourceState<T> = {
+  data: T;
+  isLoading: boolean;
+  error: string | null;
+};
+
+export const useConsoleResource = <T>(
+  cache: ResourceCache<T>,
+  key: string | null,
+  url: string | null,
+  fallback: T,
+): ConsoleResourceState<T> => {
+  const cached = key !== null ? cache.peek(key) : undefined;
+  const [data, setData] = useState<T>(cached ?? fallback);
+  const [isLoading, setIsLoading] = useState<boolean>(
+    key !== null && cached === undefined,
+  );
+  const [error, setError] = useState<string | null>(null);
+
+  useEffect(() => {
+    if (key === null || url === null) {
+      return;
+    }
+    const existing = cache.peek(key);
+    if (existing !== undefined) {
+      setData(existing);
+      setIsLoading(false);
+      setError(null);
+      return;
+    }
+    let cancelled = false;
+    setIsLoading(true);
+    setError(null);
+    cache
+      .load(key, url)
+      .then((value) => {
+        if (!cancelled) {
+          setData(value);
+          setIsLoading(false);
+        }
+      })
+      .catch((cause: unknown) => {
+        if (!cancelled) {
+          setError(cause instanceof Error ? cause.message : String(cause));
+          setIsLoading(false);
+        }
+      });
+    return () => {
+      cancelled = true;
+    };
+  }, [cache, key, url]);
+
+  return { data, isLoading, error };
+};

package/src/adapter/entry-points/console/ui/src/features/console/hooks/useConsoleTabData.test.ts

@@ -0,0 +1,63 @@
+import { renderHook, waitFor } from '@testing-library/react';
+import { useConsoleTabData } from './useConsoleTabData';
+
+describe('useConsoleTabData', () => {
+  beforeEach(() => {
+    localStorage.clear();
+    window.history.replaceState({}, '', '/?k=token');
+  });
+
+  it('fetches every tab once at startup and parses snapshots', async () => {
+    const fetchMock = jest.fn(async (url: string) => ({
+      ok: true,
+      status: 200,
+      json: async () => ({
+        pjcode: 'umino',
+        generatedAt: '2026-06-19T00:00:00.000Z',
+        statusOptions: [{ id: 's1', name: 'Unread', color: 'ORANGE' }],
+        storyColors: {},
+        items: url.includes('/prs/')
+          ? [{ number: 1, itemId: 'PVTI_1', projectItemId: 'PVTI_1' }]
+          : [],
+      }),
+    }));
+    global.fetch = fetchMock as unknown as typeof fetch;
+
+    const { result } = renderHook(() => useConsoleTabData('umino'));
+    await waitFor(() => {
+      expect(result.current.isLoading).toBe(false);
+    });
+    expect(fetchMock).toHaveBeenCalledTimes(5);
+    expect(fetchMock).toHaveBeenCalledWith(
+      expect.stringContaining('/projects/umino/prs/list.json'),
+    );
+    expect(result.current.snapshots.prs?.items.length).toBe(1);
+    expect(result.current.snapshots.prs?.generatedAt).toBe(
+      '2026-06-19T00:00:00.000Z',
+    );
+  });
+
+  it('surfaces an error when a tab fetch fails', async () => {
+    const fetchMock = jest.fn(async () => ({
+      ok: false,
+      status: 500,
+      json: async () => ({}),
+    }));
+    global.fetch = fetchMock as unknown as typeof fetch;
+    const { result } = renderHook(() => useConsoleTabData('umino'));
+    await waitFor(() => {
+      expect(result.current.error).toBe('HTTP 500');
+    });
+  });
+
+  it('reports an error and fetches nothing when no pjcode is in the URL', async () => {
+    const fetchMock = jest.fn();
+    global.fetch = fetchMock as unknown as typeof fetch;
+    const { result } = renderHook(() => useConsoleTabData(null));
+    await waitFor(() => {
+      expect(result.current.isLoading).toBe(false);
+    });
+    expect(result.current.error).toBe('No project specified in the URL path.');
+    expect(fetchMock).not.toHaveBeenCalled();
+  });
+});

package/src/adapter/entry-points/console/ui/src/features/console/hooks/useConsoleTabData.ts

@@ -0,0 +1,129 @@
+import { useEffect, useState } from 'react';
+import type {
+  ConsoleFieldOption,
+  ConsoleListItem,
+  ConsoleStoryColorSource,
+  ConsoleTabName,
+} from '../logic/types';
+import { CONSOLE_TABS } from '../logic/types';
+import { useConsoleToken } from './useConsoleToken';
+
+export type ConsoleTabSnapshot = {
+  items: ConsoleListItem[];
+  generatedAt: string;
+  statusOptions: ConsoleFieldOption[];
+  storyOptions: ConsoleFieldOption[];
+  storyColors: ConsoleStoryColorSource;
+};
+
+export type ConsoleTabDataState = {
+  snapshots: Record<ConsoleTabName, ConsoleTabSnapshot | null>;
+  isLoading: boolean;
+  error: string | null;
+};
+
+const isRecord = (value: unknown): value is Record<string, unknown> =>
+  value !== null && typeof value === 'object' && !Array.isArray(value);
+
+const parseItems = (payload: unknown): ConsoleListItem[] => {
+  if (!isRecord(payload) || !Array.isArray(payload.items)) {
+    return [];
+  }
+  return payload.items.filter(isRecord) as unknown as ConsoleListItem[];
+};
+
+const parseOptions = (value: unknown): ConsoleFieldOption[] => {
+  if (!Array.isArray(value)) {
+    return [];
+  }
+  return value.filter(isRecord) as unknown as ConsoleFieldOption[];
+};
+
+const parseSnapshot = (payload: unknown): ConsoleTabSnapshot => ({
+  items: parseItems(payload),
+  generatedAt:
+    isRecord(payload) && typeof payload.generatedAt === 'string'
+      ? payload.generatedAt
+      : '',
+  statusOptions: isRecord(payload) ? parseOptions(payload.statusOptions) : [],
+  storyOptions: isRecord(payload) ? parseOptions(payload.storyOptions) : [],
+  storyColors:
+    isRecord(payload) && isRecord(payload.storyColors)
+      ? (payload.storyColors as ConsoleStoryColorSource)
+      : {},
+});
+
+const emptySnapshots = (): Record<
+  ConsoleTabName,
+  ConsoleTabSnapshot | null
+> => {
+  const result = {} as Record<ConsoleTabName, ConsoleTabSnapshot | null>;
+  for (const tab of CONSOLE_TABS) {
+    result[tab.name] = null;
+  }
+  return result;
+};
+
+const buildListUrl = (pjcode: string, tab: ConsoleTabName): string =>
+  `/projects/${pjcode}/${tab}/list.json`;
+
+export const useConsoleTabData = (
+  pjcode: string | null,
+): ConsoleTabDataState => {
+  const { appendToken } = useConsoleToken();
+  const [snapshots, setSnapshots] =
+    useState<Record<ConsoleTabName, ConsoleTabSnapshot | null>>(emptySnapshots);
+  const [isLoading, setIsLoading] = useState<boolean>(true);
+  const [error, setError] = useState<string | null>(null);
+
+  useEffect(() => {
+    let cancelled = false;
+    setIsLoading(true);
+    setError(null);
+
+    if (pjcode === null) {
+      setSnapshots(emptySnapshots());
+      setIsLoading(false);
+      setError('No project specified in the URL path.');
+      return () => {
+        cancelled = true;
+      };
+    }
+
+    Promise.all(
+      CONSOLE_TABS.map(async (tab) => {
+        const url = appendToken(buildListUrl(pjcode, tab.name));
+        const response = await fetch(url);
+        if (!response.ok) {
+          throw new Error(`HTTP ${response.status}`);
+        }
+        const payload: unknown = await response.json();
+        return [tab.name, parseSnapshot(payload)] as const;
+      }),
+    )
+      .then((entries) => {
+        if (cancelled) {
+          return;
+        }
+        const next = emptySnapshots();
+        for (const [name, snapshot] of entries) {
+          next[name] = snapshot;
+        }
+        setSnapshots(next);
+        setIsLoading(false);
+      })
+      .catch((cause: unknown) => {
+        if (cancelled) {
+          return;
+        }
+        setError(cause instanceof Error ? cause.message : String(cause));
+        setIsLoading(false);
+      });
+
+    return () => {
+      cancelled = true;
+    };
+  }, [pjcode, appendToken]);
+
+  return { snapshots, isLoading, error };
+};

package/src/adapter/entry-points/console/ui/src/features/console/hooks/useConsoleToken.test.ts

@@ -0,0 +1,41 @@
+import { act, renderHook } from '@testing-library/react';
+import { useConsoleToken } from './useConsoleToken';
+
+describe('useConsoleToken', () => {
+  beforeEach(() => {
+    localStorage.clear();
+    window.history.replaceState({}, '', '/');
+  });
+
+  it('reads the token from the query string and appends it to data urls', () => {
+    window.history.replaceState({}, '', '/?k=secret');
+    const { result } = renderHook(() => useConsoleToken());
+    expect(result.current.token).toBe('secret');
+    expect(result.current.appendToken('./prs/list.json')).toBe(
+      './prs/list.json?k=secret',
+    );
+    expect(result.current.appendToken('./api/itembody?url=x')).toBe(
+      './api/itembody?url=x&k=secret',
+    );
+  });
+
+  it('persists the token to localStorage', () => {
+    window.history.replaceState({}, '', '/?k=persisted');
+    renderHook(() => useConsoleToken());
+    expect(localStorage.getItem('tdpm-console-token')).toBe('persisted');
+  });
+
+  it('reads a persisted token when no query token exists', () => {
+    localStorage.setItem('tdpm-console-token', 'stored');
+    const { result } = renderHook(() => useConsoleToken());
+    expect(result.current.token).toBe('stored');
+  });
+
+  it('returns the url unchanged when there is no token', () => {
+    const { result } = renderHook(() => useConsoleToken());
+    act(() => {});
+    expect(result.current.appendToken('./prs/list.json')).toBe(
+      './prs/list.json',
+    );
+  });
+});

package/src/adapter/entry-points/console/ui/src/features/console/lib/consoleApi.test.ts

@@ -0,0 +1,155 @@
+import { createConsoleApiClient, postConsoleOperation } from './consoleApi';
+
+const appendToken = (url: string): string =>
+  url.includes('?') ? `${url}&k=token` : `${url}?k=token`;
+
+const mockFetchOnce = (body: unknown, ok = true): jest.Mock => {
+  const fetchMock = jest.fn().mockResolvedValue({
+    ok,
+    status: ok ? 200 : 500,
+    json: async () => body,
+  });
+  global.fetch = fetchMock as unknown as typeof fetch;
+  return fetchMock;
+};
+
+describe('createConsoleApiClient', () => {
+  it('reads the item body and appends the token to the url query', async () => {
+    const fetchMock = mockFetchOnce({ body: '# Title' });
+    const client = createConsoleApiClient(appendToken);
+    const body = await client.fetchItemBody('https://github.com/o/r/issues/1');
+    expect(body).toBe('# Title');
+    const requested = fetchMock.mock.calls[0][0] as string;
+    expect(requested).toContain('./api/itembody?url=');
+    expect(requested).toContain('&k=token');
+  });
+
+  it('parses comments', async () => {
+    mockFetchOnce({
+      comments: [
+        { author: 'a', body: 'hello', createdAt: '2026-06-19T00:00:00.000Z' },
+      ],
+    });
+    const client = createConsoleApiClient(appendToken);
+    const comments = await client.fetchComments(
+      'https://github.com/o/r/issues/1',
+    );
+    expect(comments).toEqual([
+      { author: 'a', body: 'hello', createdAt: '2026-06-19T00:00:00.000Z' },
+    ]);
+  });
+
+  it('parses changed files supporting path and filename keys', async () => {
+    mockFetchOnce({
+      files: [
+        { path: 'a.ts', additions: 3, deletions: 1, status: 'modified' },
+        { filename: 'b.ts', additions: 9, deletions: 0, status: 'added' },
+      ],
+    });
+    const client = createConsoleApiClient(appendToken);
+    const files = await client.fetchPrFiles('https://github.com/o/r/pull/1');
+    expect(files.map((file) => file.path)).toEqual(['a.ts', 'b.ts']);
+  });
+
+  it('returns no files when the response files array is null', async () => {
+    mockFetchOnce({ files: null });
+    const client = createConsoleApiClient(appendToken);
+    expect(await client.fetchPrFiles('https://github.com/o/r/pull/1')).toEqual(
+      [],
+    );
+  });
+
+  it('parses the issue state', async () => {
+    mockFetchOnce({ state: 'closed', merged: true, isPullRequest: true });
+    const client = createConsoleApiClient(appendToken);
+    expect(
+      await client.fetchIssueState('https://github.com/o/r/pull/1'),
+    ).toEqual({ state: 'closed', merged: true, isPullRequest: true });
+  });
+
+  it('parses pull request commits', async () => {
+    mockFetchOnce({
+      commits: [
+        {
+          sha: 'abc1234',
+          message: 'fix: thing',
+          author: 'dev',
+          authoredAt: '2026-06-19T00:00:00.000Z',
+        },
+      ],
+    });
+    const client = createConsoleApiClient(appendToken);
+    const commits = await client.fetchPrCommits(
+      'https://github.com/o/r/pull/1',
+    );
+    expect(commits[0].sha).toBe('abc1234');
+  });
+
+  it('parses related pull requests with summaries', async () => {
+    mockFetchOnce({
+      relatedPullRequests: [
+        {
+          url: 'https://github.com/o/r/pull/9',
+          branchName: 'feat',
+          createdAt: '2026-06-19T00:00:00.000Z',
+          isDraft: false,
+          isConflicted: false,
+          isPassedAllCiJob: true,
+          isCiStateSuccess: true,
+          isResolvedAllReviewComments: true,
+          isBranchOutOfDate: false,
+          missingRequiredCheckNames: ['build'],
+          summary: {
+            title: 'Linked',
+            body: 'body',
+            additions: 10,
+            deletions: 2,
+            changedFiles: 3,
+          },
+        },
+      ],
+    });
+    const client = createConsoleApiClient(appendToken);
+    const related = await client.fetchRelatedPrs(
+      'https://github.com/o/r/issues/1',
+    );
+    expect(related[0].url).toBe('https://github.com/o/r/pull/9');
+    expect(related[0].summary?.changedFiles).toBe(3);
+    expect(related[0].missingRequiredCheckNames).toEqual(['build']);
+  });
+
+  it('throws on a non-ok response', async () => {
+    mockFetchOnce({}, false);
+    const client = createConsoleApiClient(appendToken);
+    await expect(
+      client.fetchComments('https://github.com/o/r/issues/1'),
+    ).rejects.toThrow('HTTP 500');
+  });
+});
+
+describe('postConsoleOperation', () => {
+  it('posts a JSON body and appends the token', async () => {
+    const fetchMock = mockFetchOnce({ ok: true });
+    await postConsoleOperation(appendToken, '/api/review', {
+      pjcode: 'umino',
+      action: 'approve',
+      prUrl: 'https://github.com/o/r/pull/1',
+      projectItemId: 'PVTI_1',
+    });
+    const [url, init] = fetchMock.mock.calls[0];
+    expect(url).toBe('/api/review?k=token');
+    expect(init).toMatchObject({ method: 'POST' });
+  });
+
+  it('throws on a failed operation', async () => {
+    mockFetchOnce({}, false);
+    await expect(
+      postConsoleOperation(appendToken, '/api/review', {
+        pjcode: 'umino',
+        action: 'approve',
+        prUrl: 'https://github.com/o/r/pull/1',
+        projectItemId: 'PVTI_1',
+      }),
+    ).rejects.toThrow('HTTP 500');
+  });
+});