Files
umami/packages/api-client/src/client.test.ts
T

128 lines
4.2 KiB
TypeScript

import { describe, expect, test } from 'vitest';
import { UmamiClient } from './client';
import { operations } from './generated/operations';
interface Captured {
url: URL;
method: string;
headers: Record<string, string>;
body?: string;
}
function createClient(response: unknown = {}, options: Record<string, unknown> = {}) {
const calls: Captured[] = [];
const client = new UmamiClient({
baseUrl: 'https://example.com/api',
token: 'token',
...options,
fetch: async (url, init) => {
calls.push({
url: new URL(url.toString()),
method: init?.method ?? 'GET',
headers: init?.headers as Record<string, string>,
body: init?.body as string | undefined,
});
return new Response(JSON.stringify(response), {
status: 200,
headers: { 'content-type': 'application/json' },
});
},
});
return { client, calls };
}
describe('UmamiClient', () => {
test('exposes a method for every generated operation', () => {
const client = new UmamiClient({ fetch: async () => new Response('{}') });
for (const operationId of Object.keys(operations)) {
expect(typeof (client as unknown as Record<string, unknown>)[operationId]).toBe('function');
}
});
test('builds GET requests with path and query parameters', async () => {
const { client, calls } = createClient({ pageviews: 1 });
await client.getWebsiteStats({ websiteId: 'w1', startAt: 1, endAt: 2, browser: 'chrome' });
expect(calls[0].method).toBe('GET');
expect(calls[0].url.pathname).toBe('/api/websites/w1/stats');
expect(calls[0].url.searchParams.get('startAt')).toBe('1');
expect(calls[0].url.searchParams.get('browser')).toBe('chrome');
expect(calls[0].headers.authorization).toBe('Bearer token');
});
test('supports the legacy positional signature', async () => {
const { client, calls } = createClient([]);
await client.getWebsiteMetrics('w1', { startAt: 1, endAt: 2, type: 'url' });
await client.getWebsiteSession('w1', 's1');
expect(calls[0].url.pathname).toBe('/api/websites/w1/metrics');
expect(calls[0].url.searchParams.get('type')).toBe('url');
expect(calls[1].url.pathname).toBe('/api/websites/w1/sessions/s1');
});
test('sends JSON bodies for POST operations', async () => {
const { client, calls } = createClient([]);
await client.runFunnelReport({
websiteId: 'w1',
type: 'funnel',
filters: {},
parameters: { startDate: 'a', endDate: 'b', window: 60, steps: [] },
});
expect(calls[0].method).toBe('POST');
expect(calls[0].url.pathname).toBe('/api/reports/funnel');
expect(JSON.parse(calls[0].body as string)).toMatchObject({ websiteId: 'w1', type: 'funnel' });
});
test('uses the Cloud base URL and API key header by default', async () => {
const calls: Captured[] = [];
const client = new UmamiClient({
apiKey: 'api-key',
fetch: async (url, init) => {
calls.push({
url: new URL(url.toString()),
method: init?.method ?? 'GET',
headers: init?.headers as Record<string, string>,
});
return new Response('{"data":[]}', { headers: { 'content-type': 'application/json' } });
},
});
await client.listWebsites();
expect(calls[0].url.toString()).toBe('https://api.umami.is/v1/websites');
expect(calls[0].headers['x-umami-api-key']).toBe('api-key');
});
test('merges custom and per-request headers', async () => {
const { client, calls } = createClient({}, { headers: { 'x-a': '1' } });
await client.getMe(undefined, { headers: { 'x-b': '2' } });
expect(calls[0].headers).toMatchObject({ 'x-a': '1', 'x-b': '2' });
});
test('withToken returns a client using the new token', async () => {
const { client, calls } = createClient({});
await client.withToken('other').getMe();
expect(calls[0].headers.authorization).toBe('Bearer other');
});
test('call() invokes any operation by id', async () => {
const { client, calls } = createClient({ visitors: 3 });
const result = await client.call('getWebsiteActive', { websiteId: 'w1' });
expect(result).toEqual({ visitors: 3 });
expect(calls[0].url.pathname).toBe('/api/websites/w1/active');
});
});