45 lines
2.4 KiB
TypeScript
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 };
|
|
}
|