Files
DataStack/app/api/events/route.ts
T
Team Dark Devil 043123dc21 feat: improve event tracking and SDK robustness
- Add specific error tracking for rate-limited and oversized events in API response
- Ensure runtime settings are applied on initial access in settings manager
- Exclude /api/health from middleware protection
- Update Python SDK to v2.2.0 with unified standalone implementation
- Add auto_prune_days setting to database schema retrieval
2026-11-18 02:51:04 +06:00

337 lines
11 KiB
TypeScript

import { SettingsManager } from '@/core/adminSettings/settingsManager';
import { verifyAdminSessionToken } from '@/core/auth/adminSession';
import { AuthService } from '@/core/auth/jwt';
import { DataBufferEngine } from '@/core/data/buffer';
import { SDKManager } from '@/core/sdk/sdkManager';
import { SecurityEngine } from '@/core/Security/security';
import { CSVStorageManager, type DataEvent } from '@/core/Storage/csvStorage';
import { parse } from 'csv-parse';
import { NextRequest, NextResponse } from 'next/server';
import { createReadStream } from 'node:fs';
const SESSION_COOKIE = 'datastack_admin_session';
async function getRecentStoredEvents(
limit: number,
clientId?: string,
): Promise<DataEvent[]> {
const files = CSVStorageManager.listAllFiles()
.filter((f) => !clientId || clientId === 'all' || f.clientId === clientId)
.slice(0, 5);
const collected: DataEvent[] = [];
for (const file of files) {
const fileEvents: DataEvent[] = [];
const parser = createReadStream(file.filePath).pipe(
parse({ columns: true, skip_empty_lines: true, bom: true }),
);
try {
for await (const record of parser as AsyncIterable<
Record<string, string>
>) {
if (!record.eventId) continue;
fileEvents.push({
clientId: record.clientId || file.clientId,
eventId: record.eventId,
timestamp: record.timestamp || `${file.date}T00:00:00.000Z`,
payload: record.payload || '',
});
}
} catch {
parser.destroy();
}
if (fileEvents.length > 0) {
collected.push(...fileEvents.slice(-limit));
}
}
return collected;
}
export async function GET(req: NextRequest) {
try {
const { searchParams } = new URL(req.url);
const clientId = searchParams.get('clientId') || undefined;
const limit = Math.min(200, Math.max(1, Number(searchParams.get('limit')) || 50));
const bufferedEvents = DataBufferEngine.getRecentEvents(limit, clientId);
const storedEvents = await getRecentStoredEvents(limit, clientId);
const seenIds = new Set<string>();
const merged: DataEvent[] = [];
for (const evt of [...bufferedEvents, ...storedEvents]) {
if (!evt.eventId || seenIds.has(evt.eventId)) continue;
seenIds.add(evt.eventId);
merged.push(evt);
}
merged.sort((a, b) => (b.timestamp > a.timestamp ? 1 : b.timestamp < a.timestamp ? -1 : 0));
const events = merged.slice(0, limit);
return NextResponse.json({ events, count: events.length });
} catch (err: unknown) {
const message = err instanceof Error ? err.message : 'Events retrieval failed';
return NextResponse.json({ error: message }, { status: 500 });
}
}
export async function POST(req: NextRequest) {
try {
const settings = await SettingsManager.getSettingsAsync();
// Verify either Client Bearer JWT or Admin Session Cookie
const authHeader = req.headers.get('authorization');
const sessionSecret =
process.env.DATASTACK_ADMIN_SESSION_SECRET ||
'datastack-admin-session-default-secret-32-chars';
const sessionCookie = req.cookies.get(SESSION_COOKIE)?.value;
let tokenClientId: string | null = null;
let tokenRateLimit: number | undefined;
let rawBearerToken: string | null = null;
if (authHeader && authHeader.toLowerCase().startsWith('bearer ')) {
rawBearerToken = authHeader.slice(7).trim();
const verified = AuthService.verifyClientToken(rawBearerToken);
if (!verified.valid || !verified.payload) {
return NextResponse.json(
{ error: verified.error || 'Invalid client JWT token.' },
{ status: 401 },
);
}
tokenClientId = verified.payload.clientId;
tokenRateLimit = verified.payload.rateLimit;
} else {
const isAdmin = Boolean(
sessionSecret &&
sessionCookie &&
(await verifyAdminSessionToken(sessionCookie, sessionSecret)),
);
if (!isAdmin) {
return NextResponse.json(
{ error: 'Authentication required. Provide a valid Client Bearer JWT or Admin Session.' },
{ status: 401 },
);
}
}
const body = await req.json();
const bodyObj =
body && typeof body === 'object' && !Array.isArray(body)
? (body as Record<string, unknown>)
: {};
const clientId = String(
tokenClientId || bodyObj.clientId || 'py_telemetry_agent_01',
)
.trim()
.toLowerCase()
.replace(/[^a-z0-9_-]/g, '_');
const registeredClient = await SDKManager.getClientAsync(clientId);
if (registeredClient) {
if (registeredClient.status === 'revoked') {
return NextResponse.json(
{
error: `CLIENT_REVOKED: Client '${clientId}' access has been revoked by administrator.`,
code: 'CLIENT_REVOKED',
},
{ status: 403 },
);
}
if (
rawBearerToken &&
registeredClient.token &&
registeredClient.token !== rawBearerToken
) {
return NextResponse.json(
{
error: 'TOKEN_ROTATED: Client credentials have been rotated. Use the latest token.',
code: 'TOKEN_ROTATED',
},
{ status: 401 },
);
}
}
const effectiveClientRate =
registeredClient?.rateLimit ||
tokenRateLimit ||
settings.maxEventsPerSec ||
100;
// Detect if this is a batch array or direct file-records ingestion request
const batchItems: unknown[] | null = Array.isArray(body)
? body
: Array.isArray(bodyObj.batch)
? (bodyObj.batch as unknown[])
: Array.isArray(bodyObj.records)
? (bodyObj.records as unknown[])
: null;
if (batchItems !== null) {
let processed = 0;
let rejected = 0;
let duplicates = 0;
let hitRateLimit = false;
let hitPayloadLimit = false;
const rateLimitedEventIds: string[] = [];
const oversizedEventIds: string[] = [];
const errors: string[] = [];
for (const item of batchItems) {
const safeItem =
item && typeof item === 'object' && !Array.isArray(item)
? (item as Record<string, unknown>)
: { value: item };
const itemEventId =
typeof safeItem.eventId === 'string' && safeItem.eventId.trim()
? safeItem.eventId.trim()
: `evt_${Date.now()}_${Math.random().toString(36).substring(2, 7)}`;
const itemTimestamp =
typeof safeItem.timestamp === 'string' && safeItem.timestamp.trim()
? safeItem.timestamp.trim()
: new Date().toISOString();
const itemData =
safeItem.data !== undefined ? safeItem.data : safeItem;
const val = SecurityEngine.validateEvent(
clientId,
itemEventId,
itemData,
effectiveClientRate,
);
if (!val.allowed) {
if (val.code === 'DUPLICATE_EVENT') {
duplicates += 1;
continue;
}
rejected += 1;
if (val.code === 'RATE_LIMIT_EXCEEDED') {
hitRateLimit = true;
rateLimitedEventIds.push(itemEventId);
}
if (val.code === 'PAYLOAD_TOO_LARGE') {
hitPayloadLimit = true;
oversizedEventIds.push(itemEventId);
}
if (errors.length < 5) {
errors.push(`${itemEventId}: ${val.code || 'REJECTED'} - ${val.reason}`);
}
continue;
}
const event: DataEvent = {
clientId,
eventId: itemEventId,
timestamp: itemTimestamp,
payload:
typeof itemData === 'string' ? itemData : JSON.stringify(itemData),
};
DataBufferEngine.push(event);
processed += 1;
}
if (processed > 0) {
SDKManager.incrementEventCount(clientId, processed);
}
// If zero items were processed or deduplicated and all failed due to payload or rate limit, return corresponding status
if (processed === 0 && duplicates === 0 && rejected > 0) {
const status = hitPayloadLimit ? 413 : hitRateLimit ? 429 : 400;
const code = hitPayloadLimit
? 'PAYLOAD_TOO_LARGE'
: hitRateLimit
? 'RATE_LIMIT_EXCEEDED'
: 'BATCH_REJECTED';
return NextResponse.json(
{
success: false,
processed,
rejected,
duplicates,
code,
error: errors[0] || 'Batch validation failed',
errors,
...(rateLimitedEventIds.length > 0 ? { rateLimitedEventIds } : {}),
...(oversizedEventIds.length > 0 ? { oversizedEventIds } : {}),
},
{ status },
);
}
return NextResponse.json({
success: true,
processed,
rejected,
duplicates,
...(typeof bodyObj.fileName === 'string'
? { fileName: bodyObj.fileName }
: {}),
...(rateLimitedEventIds.length > 0 ? { rateLimitedEventIds } : {}),
...(oversizedEventIds.length > 0 ? { oversizedEventIds } : {}),
...(errors.length > 0 ? { errors } : {}),
});
}
// Single Event Ingestion
const eventId =
typeof bodyObj.eventId === 'string' && bodyObj.eventId.trim()
? bodyObj.eventId.trim()
: `evt_${Date.now()}_${Math.random().toString(36).substring(2, 7)}`;
const timestamp =
typeof bodyObj.timestamp === 'string' && bodyObj.timestamp.trim()
? bodyObj.timestamp.trim()
: new Date().toISOString();
const data =
bodyObj.data !== undefined
? bodyObj.data
: Object.keys(bodyObj).length > 0
? bodyObj
: { sample: 'Realtime event via DataStack API', rand: Math.random() };
// Validate security (idempotency, rate limit, payload size)
const val = SecurityEngine.validateEvent(
clientId,
eventId,
data,
effectiveClientRate,
);
if (!val.allowed) {
if (val.code === 'DUPLICATE_EVENT') {
return NextResponse.json({
success: true,
eventId,
note: 'DUPLICATE_DROPPED',
});
}
const status = val.code === 'PAYLOAD_TOO_LARGE' ? 413 : 429;
return NextResponse.json({ error: val.reason, code: val.code }, { status });
}
const event = {
clientId,
eventId,
timestamp,
payload: typeof data === 'string' ? data : JSON.stringify(data),
};
DataBufferEngine.push(event);
SDKManager.incrementEventCount(clientId, 1);
return NextResponse.json({ success: true, eventId, event });
} catch (err: unknown) {
const message = err instanceof Error ? err.message : 'Event ingestion failed';
return NextResponse.json({ error: message }, { status: 500 });
}
}