Files
mtusi2026lab7/src/http/pagination.ts
T

45 lines
2.4 KiB
TypeScript

// Keyset-пагинация по (created_at, id) по возрастанию.
// Cursor непрозрачен для клиента: base64url("вид|область|created_at|id").
// Область привязывает cursor к конкретному чату (или пользователю для списка чатов): чужой cursor → 400.
import { badRequest } from './errors.ts';
import { UUID } from './request.ts';
const TIMESTAMP = /^\d{4}-\d\d-\d\dT\d\d:\d\d:\d\d\.\d{6}Z$/;
type Keyed = { created_at: string; id: string };
export function limitOf(url: URL): number {
const q = url.searchParams.get('limit');
if (q === null) return 50;
const n = Number(q);
if (!/^\d+$/.test(q) || n < 1 || n > 100) throw badRequest('limit должен быть целым 1–100');
return n;
}
// Позиция, после которой продолжать чтение. Без cursor — начало истории.
export function afterCursor(url: URL, kind: string, scope: string): [createdAt: string, id: string] {
const raw = url.searchParams.get('cursor');
if (raw === null) return ['-infinity', '00000000-0000-0000-0000-000000000000'];
const [k, s, ts, id, ...rest] = Buffer.from(raw, 'base64url').toString().split('|');
if (k !== kind || s !== scope || !isTimestamp(ts) || !UUID.test(id ?? '') || rest.length) {
throw badRequest('Некорректный cursor');
}
return [ts, id];
}
// Форма RFC 3339 и реальная дата: 2026-13-01 или 2026-02-30 иначе дошли бы до PostgreSQL и дали 500.
// Проверка круговым преобразованием: JS-дата без микросекунд должна совпасть с исходной строкой.
function isTimestamp(ts: string | undefined): ts is string {
if (!ts || !TIMESTAMP.test(ts)) return false;
const ms = Date.parse(ts.slice(0, 23) + 'Z');
return !Number.isNaN(ms) && new Date(ms).toISOString().slice(0, 23) === ts.slice(0, 23);
}
// Запрос выбирает limit + 1 строк: лишняя строка означает, что следующая страница есть.
export function page<T extends Keyed>(rows: T[], limit: number, kind: string, scope: string) {
const items = rows.slice(0, limit);
const last = items[limit - 1];
const next = rows.length > limit ? Buffer.from([kind, scope, last.created_at, last.id].join('|')).toString('base64url') : null;
return { items, next_cursor: next };
}