Files
n8n-enterprise-unlocked/packages/cli/test/integration/insights/insights.api.test.ts

328 lines
10 KiB
TypeScript

import type { InsightsDateRange } from '@n8n/api-types';
import { mockInstance, createWorkflow, createTeamProject, testDb } from '@n8n/backend-test-utils';
import { DateTime } from 'luxon';
import { Telemetry } from '@/telemetry';
import { createCompactedInsightsEvent } from '@/modules/insights/database/entities/__tests__/db-utils';
import { createUser } from '../shared/db/users';
import type { SuperAgentTest } from '../shared/types';
import * as utils from '../shared/utils';
mockInstance(Telemetry);
const agents: Record<string, SuperAgentTest> = {};
const testServer = utils.setupTestServer({
endpointGroups: ['insights', 'license', 'auth'],
enabledFeatures: ['feat:insights:viewSummary', 'feat:insights:viewDashboard'],
quotas: { 'quota:insights:maxHistoryDays': 365 },
modules: ['insights'],
});
beforeAll(async () => {
const owner = await createUser({ role: 'global:owner' });
const admin = await createUser({ role: 'global:admin' });
const member = await createUser({ role: 'global:member' });
agents.owner = testServer.authAgentFor(owner);
agents.admin = testServer.authAgentFor(admin);
agents.member = testServer.authAgentFor(member);
});
describe('GET /insights routes work for owner and admins for server with dashboard license', () => {
test.each(['owner', 'admin', 'member'])(
'Call should work and return empty summary for user %s',
async (agentName: string) => {
const authAgent = agents[agentName];
await authAgent.get('/insights/summary').expect(agentName.includes('member') ? 403 : 200);
await authAgent.get('/insights/by-time').expect(agentName.includes('member') ? 403 : 200);
await authAgent
.get('/insights/by-time/time-saved')
.expect(agentName.includes('member') ? 403 : 200);
await authAgent.get('/insights/by-workflow').expect(agentName.includes('member') ? 403 : 200);
},
);
});
describe('GET /insights routes return 403 for dashboard routes when summary license only', () => {
beforeAll(() => {
testServer.license.setDefaults({ features: ['feat:insights:viewSummary'] });
});
test.each(['owner', 'admin', 'member'])(
'Call should work and return empty summary for user %s',
async (agentName: string) => {
const authAgent = agents[agentName];
await authAgent.get('/insights/summary').expect(agentName.includes('member') ? 403 : 200);
await authAgent.get('/insights/by-time').expect(403);
await authAgent
.get('/insights/by-time/time-saved')
.expect(agentName.includes('member') ? 403 : 200);
await authAgent.get('/insights/by-workflow').expect(403);
},
);
});
describe('GET /insights routes return 403 if date range outside license limits', () => {
beforeAll(() => {
testServer.license.setDefaults({ quotas: { 'quota:insights:maxHistoryDays': 3 } });
});
test('Call should throw forbidden for default week insights', async () => {
const authAgent = agents.admin;
await authAgent.get('/insights/summary').expect(403);
await authAgent.get('/insights/by-time').expect(403);
await authAgent.get('/insights/by-time/time-saved').expect(403);
await authAgent.get('/insights/by-workflow').expect(403);
});
test('Call should throw forbidden for daily data without viewHourlyData enabled', async () => {
const authAgent = agents.admin;
await authAgent.get('/insights/summary?dateRange=day').expect(403);
await authAgent.get('/insights/by-time?dateRange=day').expect(403);
await authAgent.get('/insights/by-time/time-saved?dateRange=day').expect(403);
await authAgent.get('/insights/by-workflow?dateRange=day').expect(403);
});
});
describe('GET /insights routes return 200 if date range inside license limits', () => {
beforeAll(() => {
testServer.license.setDefaults({
features: [
'feat:insights:viewSummary',
'feat:insights:viewDashboard',
'feat:insights:viewHourlyData',
],
quotas: { 'quota:insights:maxHistoryDays': 365 },
});
});
test.each<InsightsDateRange['key']>([
'day',
'week',
'2weeks',
'month',
'quarter',
'6months',
'year',
])('Call should work for date range %s', async (dateRange) => {
const authAgent = agents.admin;
await authAgent.get(`/insights/summary?dateRange=${dateRange}`).expect(200);
await authAgent.get(`/insights/by-time?dateRange=${dateRange}`).expect(200);
await authAgent.get(`/insights/by-time/time-saved?dateRange=${dateRange}`).expect(200);
await authAgent.get(`/insights/by-workflow?dateRange=${dateRange}`).expect(200);
});
});
describe('GET /insights/by-workflow', () => {
beforeAll(() => {
testServer.license.setDefaults({
features: ['feat:insights:viewSummary', 'feat:insights:viewDashboard'],
});
});
test.each([
{
skip: '10',
take: '20',
sortBy: 'total:desc',
},
{
skip: '1',
take: '25',
sortBy: 'workflowName:asc',
},
])('Call should work with valid query parameters: %s', async (queryParams) => {
await agents.owner.get('/insights/by-workflow').query(queryParams).expect(200);
});
test.each<{ skip: string; take?: string; sortBy?: string }>([
{
skip: 'not_a_number',
take: '20',
},
{
skip: '1',
take: 'not_a_number',
},
])(
'Call should return bad request with invalid pagination query parameters',
async (queryParams) => {
await agents.owner.get('/insights/by-workflow').query(queryParams).expect(400);
},
);
test('Call should return bad request with invalid sortby query parameters', async () => {
await agents.owner
.get('/insights/by-workflow')
.query({
skip: '1',
take: '20',
sortBy: 'not_a_sortby',
})
.expect(400);
});
test.each([
'total:asc',
'total:desc',
'succeeded:asc',
'succeeded:desc',
'failed:asc',
'failed:desc',
'failureRate:asc',
'failureRate:desc',
'timeSaved:asc',
'timeSaved:desc',
'runTime:asc',
'runTime:desc',
'averageRunTime:asc',
'averageRunTime:desc',
'workflowName:asc',
'workflowName:desc',
])('Call should return 200 with valid sortBy option: %s', async (sortBy) => {
const response = await agents.owner.get('/insights/by-workflow').query({ sortBy }).expect(200);
expect(response.body).toHaveProperty('data');
expect(response.body.data).toHaveProperty('count');
expect(Array.isArray(response.body.data.data)).toBe(true);
});
describe('sorting order verification', () => {
afterEach(async () => {
await testDb.truncate([
'InsightsRaw',
'InsightsByPeriod',
'InsightsMetadata',
'SharedWorkflow',
'WorkflowEntity',
'Project',
]);
});
test('should return workflows sorted by total:desc', async () => {
const project = await createTeamProject('Test Project 1');
const testData = [
{ name: 'Workflow A', total: 10 },
{ name: 'Workflow B', total: 5 },
{ name: 'Workflow C', total: 15 },
];
const workflows = await Promise.all(
testData.map(async (data) => await createWorkflow({ name: data.name }, project)),
);
const periodStart = DateTime.utc().startOf('day');
await Promise.all(
workflows.map(
async (workflow, index) =>
await createCompactedInsightsEvent(workflow, {
type: 'success',
value: testData[index].total,
periodUnit: 'day',
periodStart,
}),
),
);
const response = await agents.owner
.get('/insights/by-workflow')
.query({ sortBy: 'total:desc' })
.expect(200);
expect(response.body.data.count).toBe(3);
expect(response.body.data.data).toHaveLength(3);
// Verify descending order by total
const expectedOrder = [15, 10, 5];
response.body.data.data.forEach((item: any, index: number) => {
expect(item.total).toBe(expectedOrder[index]);
});
});
test('should return workflows sorted by workflowName:asc', async () => {
const project = await createTeamProject('Test Project A');
const workflowNames = ['Zebra Workflow', 'Alpha Workflow', 'Beta Workflow'];
const workflows = await Promise.all(
workflowNames.map(async (name) => await createWorkflow({ name }, project)),
);
const periodStart = DateTime.utc().startOf('day');
await Promise.all(
workflows.map(
async (workflow) =>
await createCompactedInsightsEvent(workflow, {
type: 'success',
value: 5,
periodUnit: 'day',
periodStart,
}),
),
);
const response = await agents.owner
.get('/insights/by-workflow')
.query({ sortBy: 'workflowName:asc' })
.expect(200);
expect(response.body.data.count).toBe(3);
expect(response.body.data.data).toHaveLength(3);
// Verify ascending order by workflow name
const expectedOrder = ['Alpha Workflow', 'Beta Workflow', 'Zebra Workflow'];
response.body.data.data.forEach((item: any, index: number) => {
expect(item.workflowName).toBe(expectedOrder[index]);
});
});
test('should return workflows sorted by failureRate:asc', async () => {
const project = await createTeamProject('Another Test Project');
const testData = [
{ name: 'Low Failure', success: 9, failure: 1 }, // 10% failure rate
{ name: 'High Failure', success: 2, failure: 8 }, // 80% failure rate
{ name: 'Medium Failure', success: 5, failure: 5 }, // 50% failure rate
];
const workflows = await Promise.all(
testData.map(async (data) => await createWorkflow({ name: data.name }, project)),
);
const periodStart = DateTime.utc().startOf('day');
// Create insights events for each workflow individually to avoid race conditions
for (const [index, workflow] of workflows.entries()) {
const data = testData[index];
await createCompactedInsightsEvent(workflow, {
type: 'success',
value: data.success,
periodUnit: 'day',
periodStart,
});
await createCompactedInsightsEvent(workflow, {
type: 'failure',
value: data.failure,
periodUnit: 'day',
periodStart,
});
}
const response = await agents.owner
.get('/insights/by-workflow')
.query({ sortBy: 'failureRate:asc' })
.expect(200);
expect(response.body.data.count).toBe(3);
expect(response.body.data.data).toHaveLength(3);
// Verify ascending order by failure rate
const expectedOrder = [0.1, 0.5, 0.8]; // 10%, 50%, 80%
response.body.data.data.forEach((item: any, index: number) => {
expect(item.failureRate).toBe(expectedOrder[index]);
});
});
});
});