import test from 'node:test'; import assert from 'node:assert/strict'; import { ClientRequestError, requestJson, requestMayHaveCompleted, } from '../lib/client-request'; const never = () => new Promise(() => {}); const pause = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms)); void test('successful JSON preserves mutation body, version and credential options, with one fetch', async () => { let calls = 0; let signal: AbortSignal | null | undefined; const body = JSON.stringify({ version: 12, action: { type: 'ready' } }); const fetcher: typeof fetch = async (url, init) => { calls++; assert.equal(url, '/api/rooms/TEST2345'); assert.equal(init?.body, body); assert.equal(init?.credentials, 'same-origin'); assert.equal(init?.method, 'POST'); assert.deepEqual(init?.headers, { 'Content-Type': 'application/json' }); signal = init?.signal; return Response.json({ version: 13, me: 'private-seat' }); }; assert.deepEqual( await requestJson( '/api/rooms/TEST2345', { method: 'POST', body, credentials: 'same-origin', headers: { 'Content-Type': 'application/json' }, }, { fetcher, timeoutMs: 20 }, ), { version: 13, me: 'private-seat' }, ); await pause(30); assert.equal(calls, 1); assert.equal( signal?.aborted, false, 'completed requests have no lingering timeout', ); }); void test('a stalled fetch aborts by the deadline even if transport ignores the signal, without replaying POST', async () => { let calls = 0; let signal: AbortSignal | null | undefined; const fetcher: typeof fetch = async (_, init) => { calls++; signal = init?.signal; return never(); }; await assert.rejects( requestJson( '/api/rooms/TEST2345', { method: 'POST' }, { fetcher, timeoutMs: 10 }, ), (error: unknown) => error instanceof ClientRequestError && error.kind === 'timeout', ); assert.equal(signal?.aborted, true); await pause(20); assert.equal(calls, 1); }); void test('the request deadline includes a stalled JSON response body', async () => { let signal: AbortSignal | null | undefined; let bodyStarted = false; const fetcher: typeof fetch = async (_, init) => { signal = init?.signal; return { ok: true, status: 200, json: () => { bodyStarted = true; return never(); }, } as unknown as Response; }; await assert.rejects( requestJson('/api/rooms/TEST2345', {}, { fetcher, timeoutMs: 10 }), (error: unknown) => error instanceof ClientRequestError && error.kind === 'timeout', ); assert.equal(bodyStarted, true); assert.equal(signal?.aborted, true); }); void test('409 rejection retains the server message and HTTP status for reconciliation', async () => { const fetcher: typeof fetch = async () => Response.json( { error: 'The table changed. Refresh before trying again.' }, { status: 409 }, ); await assert.rejects( requestJson('/api/rooms/TEST2345', {}, { fetcher }), (error: unknown) => error instanceof ClientRequestError && error.kind === 'http' && error.status === 409 && error.message === 'The table changed. Refresh before trying again.', ); }); void test('non-JSON HTTP failures retain status without exposing returned HTML', async () => { const fetcher: typeof fetch = async () => new Response('internal server detail', { status: 502 }); await assert.rejects( requestJson('/api/rooms/TEST2345', {}, { fetcher }), (error: unknown) => error instanceof ClientRequestError && error.kind === 'http' && error.status === 502 && error.message === 'Request failed (502).', ); }); void test('invalid JSON in a successful response remains an uncertain-response error', async () => { const fetcher: typeof fetch = async () => new Response('truncated'); await assert.rejects( requestJson('/api/rooms/TEST2345', {}, { fetcher }), (error: unknown) => error instanceof ClientRequestError && error.kind === 'invalid-response' && error.status === 200, ); }); void test('network rejection is readable and never automatically retried', async () => { let calls = 0; const fetcher: typeof fetch = async () => { calls++; throw new TypeError('private transport details'); }; await assert.rejects( requestJson('/api/rooms', { method: 'POST' }, { fetcher }), (error: unknown) => error instanceof ClientRequestError && error.kind === 'network' && !error.message.includes('private transport'), ); assert.equal(calls, 1); }); void test('caller cancellation aborts an in-progress body without waiting for the deadline', async () => { const caller = new AbortController(); let transportSignal: AbortSignal | null | undefined; const fetcher: typeof fetch = async (_, init) => { transportSignal = init?.signal; return { ok: true, status: 200, json: () => never(), } as unknown as Response; }; const request = requestJson( '/api/rooms/TEST2345', { signal: caller.signal }, { fetcher }, ); caller.abort(); await assert.rejects( request, (error: unknown) => error instanceof ClientRequestError && error.kind === 'aborted', ); assert.equal(transportSignal?.aborted, true); }); void test('a request canceled before dispatch performs no fetch', async () => { const caller = new AbortController(); caller.abort(); let calls = 0; const fetcher: typeof fetch = async () => { calls++; return Response.json({}); }; await assert.rejects( requestJson('/api/rooms', { signal: caller.signal }, { fetcher }), (error: unknown) => error instanceof ClientRequestError && error.kind === 'aborted', ); assert.equal(calls, 0); }); void test('non-finite or non-positive deadlines are rejected before dispatch', async () => { let calls = 0; const fetcher: typeof fetch = async () => { calls++; return Response.json({}); }; for (const timeoutMs of [0, -1, Infinity, NaN]) await assert.rejects( requestJson('/api/rooms', {}, { fetcher, timeoutMs }), RangeError, ); assert.equal(calls, 0); }); void test('gateway and request-timeout HTTP errors remain uncertain mutation outcomes', () => { for (const status of [408, 500, 502, 503, 504]) assert.equal( requestMayHaveCompleted( new ClientRequestError('Server error', 'http', status), ), true, String(status), ); for (const status of [400, 401, 403, 404, 409, 413, 422, 429]) assert.equal( requestMayHaveCompleted( new ClientRequestError('Request rejected', 'http', status), ), false, String(status), ); for (const kind of [ 'timeout', 'network', 'invalid-response', 'aborted', ] as const) assert.equal( requestMayHaveCompleted(new ClientRequestError('Unconfirmed', kind)), true, kind, ); assert.equal(requestMayHaveCompleted(new Error('Unknown error')), true); }); void test('a failed gateway response keeps its status and requires reconciliation without replay', async () => { let calls = 0; const fetcher: typeof fetch = async () => { calls++; return new Response('Gateway timeout after the origin may have committed', { status: 504, }); }; await assert.rejects( requestJson('/api/rooms/TEST2345', { method: 'POST' }, { fetcher }), (error: unknown) => error instanceof ClientRequestError && error.status === 504 && requestMayHaveCompleted(error), ); assert.equal(calls, 1); });