Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS
JavaScript ai-agentsdashboarddeveloper-toolsdigital-twinquantified-selfsecond-brainself-hostedtailscale
import { beforeEach, describe, expect, it, vi } from 'vitest';
import { act, fireEvent, render, screen, waitFor } from '@testing-library/react';
const api = vi.hoisted(() => ({
getSettings: vi.fn(),
updateSettings: vi.fn(),
getBeeperStatus: vi.fn(),
checkBeeperConnection: vi.fn(),
startBeeperOAuth: vi.fn(),
saveBeeperToken: vi.fn(),
disconnectBeeper: vi.fn(),
getBeeperAttachmentSummary: vi.fn(),
backfillBeeperAttachments: vi.fn(),
}));
const toast = vi.hoisted(() => Object.assign(vi.fn(), { error: vi.fn(), success: vi.fn() }));
vi.mock('../../../services/api', () => api);
vi.mock('../../ui/Toast', () => ({ default: toast }));
const BeeperSettingsPanel = (await import('./BeeperSettingsPanel')).default;
const BASE_SETTINGS = { beeper: { enabled: false, intervalMinutes: 5, baseUrl: 'http://127.0.0.1:23373', attachmentBudgetGb: 5 } };
// No router: the panel takes `realtime` as a prop and reads nothing off the
// URL — the OAuth outcome flag is the page shell's job, covered by the page's
// own suite.
const renderPanel = async (props = {}) => {
const result = render(<BeeperSettingsPanel {...props} />);
// The panel and its AttachmentMirrorCard both fetch on mount. Settle those
// promises here, or a test that finishes before they resolve leaves a
// setState to land outside act(...) — and src/test/setup.js throws it in
// whichever test's afterEach happens to be running by then, blaming a case
// that never touched the component.
await act(async () => {});
return result;
};
const BASE_ATTACHMENT_SUMMARY = {
budgetBytes: 5 * 1024 * 1024 * 1024,
usedBytes: 1024 * 1024,
storedFiles: 2,
pendingCount: 0,
pendingBytes: 0,
pendingUnknownCount: 0,
overCapCount: 0,
unavailableCount: 0,
keptCount: 0,
totalCount: 2,
maxBytes: 32 * 1024 * 1024,
};
beforeEach(() => {
vi.clearAllMocks();
api.getSettings.mockResolvedValue(BASE_SETTINGS);
api.getBeeperAttachmentSummary.mockResolvedValue(BASE_ATTACHMENT_SUMMARY);
});
// The three states decided at fork issue #11 and carried into #30's
// Acceptance criteria, plus the defensive fourth (absent-vs-empty sentinel).
describe('BeeperSettingsPanel — status card states', () => {
it('offers both connect paths and nothing else when no token is configured', async () => {
api.getBeeperStatus.mockResolvedValue({
tokenConfigured: false, reachable: null, lastProbeError: null, accounts: [],
});
await renderPanel();
expect(await screen.findByRole('heading', { name: 'Connect Beeper' })).toBeInTheDocument();
// Both paths are first-class (#11 decision 3), so both are on screen at once.
expect(screen.getByRole('button', { name: 'Connect Beeper' })).not.toBeDisabled();
expect(screen.getByLabelText('Or paste an access token')).toBeInTheDocument();
expect(screen.queryByText('Beeper Desktop unreachable')).toBeNull();
expect(screen.queryByText('Beeper Desktop connected')).toBeNull();
expect(screen.queryByText('Checking Beeper Desktop…')).toBeNull();
});
it('renders the actionable-fault card with a Retry when a token is present but unreachable', async () => {
api.getBeeperStatus.mockResolvedValue({
tokenConfigured: true, reachable: false, lastProbeError: 'Beeper request failed: connection refused', baseUrl: 'http://127.0.0.1:23373', accounts: [],
});
await renderPanel();
expect(await screen.findByText('Beeper Desktop unreachable')).toBeInTheDocument();
expect(screen.getByText('Beeper request failed: connection refused')).toBeInTheDocument();
expect(screen.getByRole('button', { name: /Retry/ })).toBeInTheDocument();
});
it('renders the connected state with an empty roster when the mirror holds no accounts', async () => {
api.getBeeperStatus.mockResolvedValue({
tokenConfigured: true, reachable: true, lastProbeError: null, appVersion: '4.3.73', accounts: [],
});
await renderPanel();
expect(await screen.findByText('Beeper Desktop connected')).toBeInTheDocument();
expect(screen.getByTestId('beeper-roster-empty')).toBeInTheDocument();
});
// Fork issue #78: the granted scopes render beside the expiry line, and a
// grant that includes `write` gets no read-only warning.
it('renders the granted scopes on the connected card', async () => {
api.getBeeperStatus.mockResolvedValue({
tokenConfigured: true, reachable: true, lastProbeError: null, accounts: [],
tokenScopes: ['read', 'write'],
});
await renderPanel();
expect(await screen.findByText('Beeper Desktop connected')).toBeInTheDocument();
expect(screen.getByText('Scopes: read, write')).toBeInTheDocument();
expect(screen.queryByText(/read-only grant/i)).toBeNull();
});
// A grant missing `write` is exactly the read-only-token case #78 exists to
// surface BEFORE a send fails, not after.
it('warns that sending will fail when the grant is missing the write scope', async () => {
api.getBeeperStatus.mockResolvedValue({
tokenConfigured: true, reachable: true, lastProbeError: null, accounts: [],
tokenScopes: ['read'],
});
await renderPanel();
expect(await screen.findByText('Scopes: read')).toBeInTheDocument();
expect(screen.getByText('Read-only grant — sending will fail.')).toBeInTheDocument();
});
// A pasted token (#11 decision 3) never carries scopes back from Beeper's
// own paste UI, so an empty array there is said out loud rather than
// rendered as if nothing were known.
it('says scopes are unknown for a pasted token with no scopes', async () => {
api.getBeeperStatus.mockResolvedValue({
tokenConfigured: true, tokenSource: 'pasted', reachable: true, lastProbeError: null, accounts: [],
tokenScopes: [],
});
await renderPanel();
expect(await screen.findByText('Beeper Desktop connected')).toBeInTheDocument();
expect(screen.getByText('Scopes unknown (pasted token).')).toBeInTheDocument();
});
// An empty scopes array from anywhere else (the legacy plaintext path) has
// nothing worth claiming — this must not render a bogus "no scopes" line.
it('renders nothing for an empty scopes list that is not a pasted token', async () => {
api.getBeeperStatus.mockResolvedValue({
tokenConfigured: true, tokenSource: 'legacy-settings', reachable: true, lastProbeError: null, accounts: [],
tokenScopes: [],
});
await renderPanel();
expect(await screen.findByText('Beeper Desktop connected')).toBeInTheDocument();
expect(screen.queryByText(/Scopes/)).toBeNull();
});
// The drawer card's own copy of the list header's sweep-visibility strip
// (#80) — same status payload, different surface.
it('shows a running sweep on the drawer card', async () => {
api.getBeeperStatus.mockResolvedValue({
tokenConfigured: true, reachable: true, lastProbeError: null, accounts: [],
sweep: {
running: true, startedAt: '2026-09-05T10:00:00.000Z', finishedAt: null, reason: 'scheduler',
accountsDone: 3, accountsTotal: 9, chats: 40, messages: 812,
},
});
await renderPanel();
expect(await screen.findByText('Syncing… 3 of 9 accounts')).toBeInTheDocument();
});
it('shows the last-synced time on the drawer card once idle', async () => {
api.getBeeperStatus.mockResolvedValue({
tokenConfigured: true, reachable: true, lastProbeError: null, accounts: [],
sweep: {
running: false, startedAt: '2026-09-05T10:00:00.000Z', finishedAt: '2026-09-05T10:04:00.000Z', reason: 'manual',
accountsDone: 9, accountsTotal: 9, chats: 210, messages: 4032,
},
});
await renderPanel();
expect(await screen.findByText(/Last synced \d{1,2}:\d{2}/)).toBeInTheDocument();
});
// The mirrored roster comes from `beeper_accounts`, not from a live call —
// which is why #27 stores it. Hiding it whenever the probe fails threw away
// what the install already knew and made an unreachable app look like an
// empty one, so reachability is stated on its own line and the roster stands
// beside it in every reachability state.
it('keeps the mirrored roster on screen while Beeper Desktop is unreachable', async () => {
api.getBeeperStatus.mockResolvedValue({
tokenConfigured: true,
reachable: false,
lastProbeError: 'Beeper request failed: connection refused',
baseUrl: 'http://127.0.0.1:23373',
accounts: [{ accountId: 'acc1', displayName: 'Example WhatsApp', network: 'whatsapp' }],
});
await renderPanel();
expect(await screen.findByText('Beeper Desktop unreachable')).toBeInTheDocument();
expect(screen.getByText('Example WhatsApp')).toBeInTheDocument();
expect(screen.getByText('whatsapp')).toBeInTheDocument();
});
it('keeps the mirrored roster on screen while the probe has not run yet', async () => {
api.getBeeperStatus.mockResolvedValue({
tokenConfigured: true,
reachable: null,
lastProbeError: null,
accounts: [{ accountId: 'acc1', displayName: 'Example WhatsApp', network: 'whatsapp' }],
});
await renderPanel();
expect(await screen.findByText('Checking Beeper Desktop…')).toBeInTheDocument();
expect(screen.getByText('Example WhatsApp')).toBeInTheDocument();
});
it('renders the connected state with the account roster when accounts are mirrored', async () => {
api.getBeeperStatus.mockResolvedValue({
tokenConfigured: true, reachable: true, lastProbeError: null, accounts: [
{ accountId: 'acc1', displayName: 'Example WhatsApp', network: 'whatsapp' },
],
});
await renderPanel();
expect(await screen.findByText('Example WhatsApp')).toBeInTheDocument();
expect(screen.getByText('whatsapp')).toBeInTheDocument();
});
it('renders the transport liveness dot from the status payload, with its actionable app.state remedy (#33)', async () => {
api.getBeeperStatus.mockResolvedValue({
tokenConfigured: true,
reachable: true,
lastProbeError: null,
accounts: [],
realtime: {
state: 'reconnecting', lastEventAt: null, lastPingAt: null, appState: 'needs-login', appStateActionable: true,
},
});
await renderPanel();
await screen.findByText('Beeper Desktop connected');
expect(screen.getByTestId('connection-status-dot')).toHaveAttribute('data-status', 'reconnecting');
expect(screen.getByText('Beeper Desktop needs you to sign in again.')).toBeInTheDocument();
});
it('renders the liveness row while Beeper Desktop is unreachable — the probe failing is when it matters', async () => {
// The HTTP probe and the WebSocket are different transports: hiding the dot
// and its remedy inside the reachable branch hid them exactly when a human
// needed them.
api.getBeeperStatus.mockResolvedValue({
tokenConfigured: true,
reachable: false,
lastProbeError: 'Beeper request failed: connection refused',
baseUrl: 'http://127.0.0.1:23373',
accounts: [],
realtime: {
state: 'connecting', lastEventAt: null, lastPingAt: null, appState: 'needs-login', appStateActionable: true,
},
});
await renderPanel();
await screen.findByText('Beeper Desktop unreachable');
expect(screen.getByTestId('connection-status-dot')).toHaveAttribute('data-status', 'connecting');
expect(screen.getByText('Beeper Desktop needs you to sign in again.')).toBeInTheDocument();
});
it('names the remedy when Beeper rejected the stored token (#33)', async () => {
api.getBeeperStatus.mockResolvedValue({
tokenConfigured: true,
reachable: null,
lastProbeError: null,
accounts: [],
realtime: {
state: 'down', lastEventAt: null, lastPingAt: null, appState: null, appStateActionable: false, authRejected: true,
},
});
await renderPanel();
await screen.findByText('Checking Beeper Desktop…');
expect(screen.getByTestId('connection-status-dot')).toHaveAttribute('data-status', 'down');
expect(screen.getByText('Beeper Desktop rejected the stored token — reconnect Beeper.')).toBeInTheDocument();
});
// #31's expired-token card and #33's 401 stand-down describe the same
// credential from two transports, so they have to read as one story: the dot
// corroborates that the socket is down for that reason (and not looping),
// while the "reconnect Beeper" instruction is said once, by the card.
it('shows the transport down on the expired-token card without repeating its remedy', async () => {
api.getBeeperStatus.mockResolvedValue({
tokenConfigured: true,
reachable: null,
lastProbeError: null,
accounts: [],
tokenExpired: true,
tokenExpiresAt: '2020-01-01T00:00:00.000Z',
realtime: {
state: 'down', lastEventAt: null, lastPingAt: null, appState: null, appStateActionable: false, authRejected: true,
},
});
await renderPanel();
await screen.findByText('Beeper token expired');
expect(screen.getByTestId('connection-status-dot')).toHaveAttribute('data-status', 'down');
expect(screen.getByRole('button', { name: 'Reconnect Beeper' })).toBeInTheDocument();
expect(screen.queryByText('Beeper Desktop rejected the stored token — reconnect Beeper.')).toBeNull();
});
it('renders no liveness row at all when the transport has never reported', async () => {
// `realtime` absent is not-yet-known, never "offline" — the same
// absent-vs-empty rule the `reachable` tri-state follows.
api.getBeeperStatus.mockResolvedValue({
tokenConfigured: true, reachable: true, lastProbeError: null, accounts: [],
});
await renderPanel();
await screen.findByText('Beeper Desktop connected');
expect(screen.queryByTestId('connection-status-dot')).toBeNull();
});
// The absent-vs-empty sentinel (#30 Acceptance): reachable:null must never
// render as offline, even in the (normally unreachable) case where a token
// is configured but the probe never ran.
it('never renders reachable:null as offline', async () => {
api.getBeeperStatus.mockResolvedValue({
tokenConfigured: true, reachable: null, lastProbeError: null, accounts: [],
});
await renderPanel();
expect(await screen.findByText('Checking Beeper Desktop…')).toBeInTheDocument();
expect(screen.queryByText('Beeper Desktop unreachable')).toBeNull();
});
// The absent-vs-empty rule (root AGENTS.md line 233): a status fetch that
// itself fails must never collapse into "no token configured" — an
// install with a working token whose status request errors would
// otherwise be silently told to connect.
it('never renders "Connect Beeper" when the status fetch itself rejects', async () => {
api.getBeeperStatus.mockRejectedValue(new Error('network down'));
await renderPanel();
expect(await screen.findByText('Could not read Beeper status')).toBeInTheDocument();
expect(screen.getByText('network down')).toBeInTheDocument();
expect(screen.queryByRole('heading', { name: 'Connect Beeper' })).toBeNull();
expect(screen.getByRole('button', { name: /Retry/ })).toBeInTheDocument();
});
// Fork issue #61, decision 7: a probe timeout shortly after a real Beeper
// success stays on the connected card with a latency note, never the
// unreachable/actionable-fault card, and never touches the empty-state
// ("Connect Beeper") or the Retry-button branch.
it('renders the slow probe state on the connected card, with its latency, instead of the unreachable card', async () => {
api.getBeeperStatus.mockResolvedValue({
tokenConfigured: true, reachable: true, probeState: 'slow', probeLatencyMs: 3000, lastProbeError: null, accounts: [],
});
await renderPanel();
expect(await screen.findByText('Beeper Desktop connected')).toBeInTheDocument();
expect(screen.getByText(/Slow to respond \(3000ms\)/)).toBeInTheDocument();
expect(screen.queryByText('Beeper Desktop unreachable')).toBeNull();
// The connected card's action is "Recheck", never the unreachable card's
// "Retry" — a slow probe must not borrow that copy or its gating.
expect(screen.queryByRole('button', { name: /Retry/ })).toBeNull();
expect(screen.getByRole('button', { name: /Recheck/ })).toBeInTheDocument();
});
it('renders the ordinary connected card with no slow note for probeState:ok', async () => {
api.getBeeperStatus.mockResolvedValue({
tokenConfigured: true, reachable: true, probeState: 'ok', probeLatencyMs: 8, lastProbeError: null, accounts: [],
});
await renderPanel();
expect(await screen.findByText('Beeper Desktop connected')).toBeInTheDocument();
expect(screen.queryByText(/Slow to respond/)).toBeNull();
});
// A failed accounts read is a different, unknown state from a legitimately
// empty roster — collapsing them would show "No accounts mirrored yet" for
// a DB hiccup.
it('shows the account roster as unknown, not empty, when the mirror read failed', async () => {
api.getBeeperStatus.mockResolvedValue({
tokenConfigured: true, reachable: true, lastProbeError: null, accounts: null, accountsError: 'Could not read the mirrored account roster',
});
await renderPanel();
expect(await screen.findByText('Beeper Desktop connected')).toBeInTheDocument();
expect(screen.getByTestId('beeper-roster-unknown')).toHaveTextContent('Could not read the mirrored account roster');
expect(screen.queryByTestId('beeper-roster-empty')).toBeNull();
});
});
/**
* Audit cluster 08 (A11Y-6): both inline error paragraphs on this panel
* carried no role, and the fetches behind them are silent, so a
* screen-reader user got no signal that the status read or the account
* roster read had failed.
*/
describe('BeeperSettingsPanel — inline errors are announced', () => {
it('exposes the status-fetch failure with role="alert"', async () => {
api.getBeeperStatus.mockRejectedValue(new Error('network down'));
await renderPanel();
expect(await screen.findByText('network down')).toHaveAttribute('role', 'alert');
});
it('exposes the account-roster failure with role="alert"', async () => {
api.getBeeperStatus.mockResolvedValue({
tokenConfigured: true, reachable: true, lastProbeError: null, accounts: null, accountsError: 'Could not read the mirrored account roster',
});
await renderPanel();
expect(await screen.findByTestId('beeper-roster-unknown')).toHaveAttribute('role', 'alert');
});
});
describe('BeeperSettingsPanel — settings', () => {
it('saves the complete settings slice and disables Save until dirty', async () => {
api.getBeeperStatus.mockResolvedValue({ tokenConfigured: false, reachable: null, accounts: [] });
api.updateSettings.mockResolvedValue({
beeper: {
enabled: true, intervalMinutes: 5, baseUrl: 'http://127.0.0.1:23373', attachmentBudgetGb: 5, allowNonLoopbackBaseUrl: false,
},
});
await renderPanel();
// Exact, not /Save/: the connect card's "Save token" is on screen too.
const saveButton = await screen.findByRole('button', { name: 'Save' });
expect(saveButton).toBeDisabled();
fireEvent.click(screen.getByLabelText('Enable scheduled Beeper sync'));
expect(saveButton).not.toBeDisabled();
fireEvent.click(saveButton);
await waitFor(() => expect(api.updateSettings).toHaveBeenCalledWith({
beeper: {
enabled: true, intervalMinutes: 5, baseUrl: 'http://127.0.0.1:23373', attachmentBudgetGb: 5, allowNonLoopbackBaseUrl: false, sendReadReceipts: false,
},
}));
expect(toast.success).toHaveBeenCalled();
});
// SEC-2: the opt-in is off by default and never inferred from the baseUrl
// text — it has to be an explicit, separate checkbox flip.
it('carries the non-loopback opt-in as its own explicit field', async () => {
api.getBeeperStatus.mockResolvedValue({ tokenConfigured: false, reachable: null, accounts: [] });
api.updateSettings.mockResolvedValue({
beeper: {
enabled: false, intervalMinutes: 5, baseUrl: 'http://127.0.0.1:23373', attachmentBudgetGb: 5, allowNonLoopbackBaseUrl: true,
},
});
await renderPanel();
const checkbox = await screen.findByLabelText(/Allow a non-loopback base URL/);
expect(checkbox).not.toBeChecked();
fireEvent.click(checkbox);
fireEvent.click(screen.getByRole('button', { name: 'Save' }));
await waitFor(() => expect(api.updateSettings).toHaveBeenCalledWith({
beeper: {
enabled: false, intervalMinutes: 5, baseUrl: 'http://127.0.0.1:23373', attachmentBudgetGb: 5, allowNonLoopbackBaseUrl: true, sendReadReceipts: false,
},
}));
});
// #9985: real read receipts are OFF by default and only turn on after an
// explicit consent step; cancelling the step changes nothing.
it('keeps read receipts off until the consent modal is confirmed, then saves the opt-in', async () => {
api.getBeeperStatus.mockResolvedValue({ tokenConfigured: false, reachable: null, accounts: [] });
api.updateSettings.mockResolvedValue({ beeper: {} });
await renderPanel();
const checkbox = await screen.findByLabelText(/Send read receipts to Beeper/);
expect(checkbox).not.toBeChecked();
fireEvent.click(checkbox);
expect(await screen.findByRole('heading', { name: 'Send read receipts?' })).toBeInTheDocument();
expect(checkbox).not.toBeChecked();
expect(screen.getByRole('button', { name: 'Save' })).toBeDisabled();
fireEvent.click(screen.getByRole('button', { name: 'Cancel' }));
expect(screen.queryByRole('heading', { name: 'Send read receipts?' })).toBeNull();
expect(checkbox).not.toBeChecked();
fireEvent.click(checkbox);
fireEvent.click(await screen.findByRole('button', { name: 'Enable read receipts' }));
expect(checkbox).toBeChecked();
fireEvent.click(screen.getByRole('button', { name: 'Save' }));
await waitFor(() => expect(api.updateSettings).toHaveBeenCalledWith({
beeper: expect.objectContaining({ sendReadReceipts: true }),
}));
});
it('turns read receipts off immediately without a consent step', async () => {
api.getSettings.mockResolvedValue({ beeper: { ...BASE_SETTINGS.beeper, sendReadReceipts: true } });
api.getBeeperStatus.mockResolvedValue({ tokenConfigured: false, reachable: null, accounts: [] });
await renderPanel();
const checkbox = await screen.findByLabelText(/Send read receipts to Beeper/);
expect(checkbox).toBeChecked();
fireEvent.click(checkbox);
expect(checkbox).not.toBeChecked();
expect(screen.queryByRole('heading', { name: 'Send read receipts?' })).toBeNull();
});
it('disables Retry while the form has unsaved edits, per the save-gating convention', async () => {
api.getBeeperStatus.mockResolvedValue({
tokenConfigured: true, reachable: false, lastProbeError: 'refused', baseUrl: 'http://127.0.0.1:23373', accounts: [],
});
await renderPanel();
await screen.findByText('Beeper Desktop unreachable');
const retryButton = screen.getByRole('button', { name: /Retry/ });
expect(retryButton).not.toBeDisabled();
fireEvent.click(screen.getByLabelText('Enable scheduled Beeper sync'));
expect(retryButton).toBeDisabled();
});
// The regression: a failed settings GET used to fall through to DEFAULTS
// silently, so the form rendered as though it had read this install's real
// config — and the next Save PUT those defaults over whatever was actually
// stored. The card must show the failure instead of the (wrong) form.
it('shows the load-failed card instead of the form when settings fail to load, and never offers Save', async () => {
api.getSettings.mockRejectedValue(new Error('network error'));
api.getBeeperStatus.mockResolvedValue({ tokenConfigured: false, reachable: null, accounts: [] });
await renderPanel();
expect(await screen.findByText('Could not load Beeper settings')).toBeInTheDocument();
expect(screen.queryByRole('button', { name: 'Save' })).toBeNull();
expect(screen.queryByLabelText('Enable scheduled Beeper sync')).toBeNull();
});
});
describe('BeeperSettingsPanel — the connect flow (#31)', () => {
beforeEach(() => {
api.getBeeperStatus.mockResolvedValue({
tokenConfigured: false, reachable: null, lastProbeError: null, accounts: [],
});
});
it('opens the authorization URL the server minted, rather than building one client-side', async () => {
const open = vi.spyOn(window, 'open').mockImplementation(() => null);
api.startBeeperOAuth.mockResolvedValue({ authorizationUrl: 'http://127.0.0.1:23373/oauth/authorize?state=s' });
await renderPanel();
fireEvent.click(await screen.findByRole('button', { name: 'Connect Beeper' }));
await waitFor(() => expect(open).toHaveBeenCalledWith('http://127.0.0.1:23373/oauth/authorize?state=s', '_blank', 'noopener'));
expect(api.startBeeperOAuth).toHaveBeenCalledWith({ silent: true });
open.mockRestore();
});
// Write paths never auto-retry (the connect exchange burns a single-use
// code): one call, one toast, and no second attempt.
it('reports a failed connect once and does not retry', async () => {
api.startBeeperOAuth.mockRejectedValue(new Error('Beeper authorization-server metadata unavailable (404)'));
await renderPanel();
fireEvent.click(await screen.findByRole('button', { name: 'Connect Beeper' }));
await waitFor(() => expect(toast.error).toHaveBeenCalledWith('Beeper authorization-server metadata unavailable (404)'));
expect(api.startBeeperOAuth).toHaveBeenCalledTimes(1);
});
it('posts a pasted token, clears the field, and refreshes status', async () => {
api.saveBeeperToken.mockResolvedValue({ tokenConfigured: true, tokenExpiresAt: null, tokenSource: 'pasted' });
await renderPanel();
const input = await screen.findByLabelText('Or paste an access token');
expect(input).toHaveAttribute('type', 'password');
fireEvent.change(input, { target: { value: 'example-beeper-token' } });
fireEvent.click(screen.getByRole('button', { name: /Save token/ }));
await waitFor(() => expect(api.saveBeeperToken).toHaveBeenCalledWith('example-beeper-token', { silent: true }));
await waitFor(() => expect(input).toHaveValue(''));
expect(api.getBeeperStatus).toHaveBeenCalledTimes(2);
});
it('keeps Save token disabled until something is typed', async () => {
await renderPanel();
const save = await screen.findByRole('button', { name: /Save token/ });
expect(save).toBeDisabled();
fireEvent.change(screen.getByLabelText('Or paste an access token'), { target: { value: 'example-beeper-token' } });
expect(save).not.toBeDisabled();
});
});
// An expired credential is its own state: Beeper issues no refresh grant, so
// the only action that helps is connecting again — never a generic error.
describe('BeeperSettingsPanel — expired token', () => {
it('renders the reconnect path rather than the unreachable or connected card', async () => {
api.getBeeperStatus.mockResolvedValue({
tokenConfigured: true, tokenSource: 'oauth', tokenExpired: true, tokenExpiringSoon: true,
tokenExpiresAt: '2026-01-01T00:00:00.000Z', tokenExpiresInDays: -3,
reachable: false, lastProbeError: 'connection refused', accounts: [],
});
await renderPanel();
expect(await screen.findByText('Beeper token expired')).toBeInTheDocument();
expect(screen.getByRole('button', { name: 'Reconnect Beeper' })).toBeInTheDocument();
expect(screen.queryByText('Beeper Desktop unreachable')).toBeNull();
});
});
describe('BeeperSettingsPanel — disconnect', () => {
beforeEach(() => {
api.getBeeperStatus.mockResolvedValue({
tokenConfigured: true, tokenSource: 'pasted', reachable: true, lastProbeError: null, accounts: [],
});
});
// No window.confirm anywhere in the client — the confirmation is inline.
it('confirms inline before disconnecting', async () => {
api.disconnectBeeper.mockResolvedValue({ deleted: true, tokenConfigured: false });
await renderPanel();
fireEvent.click(await screen.findByRole('button', { name: /Disconnect/ }));
expect(screen.getByText('Forget this Beeper credential?')).toBeInTheDocument();
expect(api.disconnectBeeper).not.toHaveBeenCalled();
fireEvent.click(screen.getByRole('button', { name: /Yes, disconnect/ }));
await waitFor(() => expect(api.disconnectBeeper).toHaveBeenCalledWith({ silent: true }));
await waitFor(() => expect(api.getBeeperStatus).toHaveBeenCalledTimes(2));
});
it('cancels without calling the API', async () => {
await renderPanel();
fireEvent.click(await screen.findByRole('button', { name: /Disconnect/ }));
fireEvent.click(screen.getByRole('button', { name: 'Cancel' }));
expect(screen.queryByText('Forget this Beeper credential?')).toBeNull();
expect(api.disconnectBeeper).not.toHaveBeenCalled();
});
});
// The attachment mirror card (#37). The bulk backfill is the one path here
// that moves gigabytes, so what is pinned is that it cannot start without a
// consent step that states the cost.
describe('BeeperSettingsPanel — attachment mirror', () => {
beforeEach(() => {
api.getBeeperStatus.mockResolvedValue({
tokenConfigured: true, tokenSource: 'pasted', reachable: true, lastProbeError: null, accounts: [],
});
});
it('renders the disk picture without starting anything', async () => {
await renderPanel();
expect(await screen.findByText('Attachment mirror')).toBeInTheDocument();
expect(screen.getByText(/of 5 GB/)).toBeInTheDocument();
expect(api.backfillBeeperAttachments).not.toHaveBeenCalled();
});
it('names the count and the byte size before the backfill runs, and only then runs it', async () => {
api.getBeeperAttachmentSummary.mockResolvedValue({
...BASE_ATTACHMENT_SUMMARY, pendingCount: 12, pendingBytes: 4 * 1024 * 1024, pendingUnknownCount: 3,
});
api.backfillBeeperAttachments.mockResolvedValue({ fetched: 12, failed: 0, bytes: 4194304, stoppedForBudget: false });
await renderPanel();
fireEvent.click(await screen.findByRole('button', { name: /Mirror all attachments/i }));
// The modal states BOTH numbers, and the unknown-size tail separately
// rather than folding it into the total as zero.
expect(await screen.findByText('Mirror all attachments?')).toBeInTheDocument();
expect(screen.getAllByText(/12 attachment\(s\)/).length).toBeGreaterThan(0);
expect(screen.getByText(/4 MB/)).toBeInTheDocument();
expect(screen.getByText(/3 whose size Beeper did not report/)).toBeInTheDocument();
expect(api.backfillBeeperAttachments).not.toHaveBeenCalled();
fireEvent.click(screen.getByRole('button', { name: /Mirror 12 attachment/i }));
await waitFor(() => expect(api.backfillBeeperAttachments).toHaveBeenCalledTimes(1));
});
it('cancels the consent modal without transferring anything', async () => {
api.getBeeperAttachmentSummary.mockResolvedValue({ ...BASE_ATTACHMENT_SUMMARY, pendingCount: 4, pendingBytes: 2048 });
await renderPanel();
fireEvent.click(await screen.findByRole('button', { name: /Mirror all attachments/i }));
fireEvent.click(await screen.findByRole('button', { name: /^Cancel$/ }));
await waitFor(() => expect(screen.queryByText(/Mirror all attachments\?/)).not.toBeInTheDocument());
expect(api.backfillBeeperAttachments).not.toHaveBeenCalled();
});
it('reports a failed summary read instead of rendering zeros as the truth', async () => {
api.getBeeperAttachmentSummary.mockRejectedValue(new Error('Database unavailable'));
await renderPanel();
expect(await screen.findByText('Database unavailable')).toBeInTheDocument();
expect(screen.queryByRole('button', { name: /Mirror all attachments/i })).not.toBeInTheDocument();
});
});