@okostream/mcp 0.12.2 → 0.12.4

package/dist/tools/formatting.js

@@ -1,216 +0,0 @@
-// Пагинация, курсоры и приведение данных к виду, который читает модель.
-//
-// Курсор — непрозрачная для клиента строка: пара `timestampCursorFrom` и
-// `parseTimestampCursor` обязана быть обратимой, иначе листание молча
-// зацикливается или теряет страницу.
-//
-// Отчёт по сессии собирается в Markdown здесь, а не в обработчике: модели
-// нужен текст, пригодный к пересказу, а не сырой документ.
-import { Timestamp } from "firebase/firestore";
-import { csvCell, safeString, serialize } from "../utils.js";
-import { detectAndNormalize, extractIframeSrc } from "../videoUrl.js";
-import { eventUrl, sessionReportUrl } from "./context.js";
-export function cursorMeta(count, max, hasMore, nextCursor) {
-    return {
-        count,
-        limit: max,
-        hasMore,
-        nextCursor,
-        has_more: hasMore,
-        next_cursor: nextCursor,
-    };
-}
-export function pickPage(items, max) {
-    return {
-        page: items.slice(0, max),
-        hasMore: items.length > max,
-    };
-}
-/**
- * Значение `video.embedUrl` попадает прямо в `<iframe src>` на публичной
- * странице события. Набор протоколов здесь строже, чем у кнопок
- * (`normalizeCardButtonUrl`): `mailto:` и `tel:` в кадре бессмысленны, а
- * `javascript:` — исполняемый код в контексте okostream.app у всех зрителей.
- * Для распознанного провайдера адрес строим мы сами, но проверяем всё равно
- * итоговое значение: так защита не зависит от того, какой ветвью оно пришло.
- */
-function assertEmbeddableUrl(value) {
-    let url;
-    try {
-        url = new URL(value);
-    }
-    catch {
-        throw new Error(`Invalid videoUrl "${value}". Provide an https:// link or a full <iframe> embed code.`);
-    }
-    if (url.protocol !== "https:" && url.protocol !== "http:") {
-        throw new Error(`Unsupported videoUrl protocol "${url.protocol}". Only http(s) links can be embedded.`);
-    }
-    return value;
-}
-export function normalizeVideo(videoUrl) {
-    const raw = videoUrl?.trim();
-    if (!raw)
-        return { originalUrl: null, embedUrl: null };
-    const effective = extractIframeSrc(raw) ?? raw;
-    const detected = detectAndNormalize(effective);
-    if (detected.provider !== "unknown" && !detected.normalizedUrl) {
-        throw new Error(`Could not extract a valid ${detected.provider} video id from videoUrl.`);
-    }
-    return { originalUrl: raw, embedUrl: assertEmbeddableUrl(detected.normalizedUrl ?? effective) };
-}
-export function csvRows(headers, rows) {
-    return [headers, ...rows].map((row) => row.map(csvCell).join(",")).join("\n");
-}
-export function toMillis(value) {
-    if (typeof value === "number" && Number.isFinite(value))
-        return value;
-    if (value && typeof value === "object" && typeof value.toMillis === "function") {
-        return value.toMillis();
-    }
-    return null;
-}
-export function parseTimestampCursor(cursor) {
-    const millis = Number(cursor);
-    if (Number.isFinite(millis) && millis > 0)
-        return Timestamp.fromMillis(millis);
-    const parsed = Date.parse(cursor);
-    if (Number.isFinite(parsed))
-        return Timestamp.fromMillis(parsed);
-    throw new Error("Invalid cursor. Use the nextCursor value returned by the previous page.");
-}
-export function timestampCursorFrom(value) {
-    const millis = toMillis(value);
-    return millis == null ? null : String(millis);
-}
-export function parseIsoBound(value, label) {
-    if (value === undefined)
-        return null;
-    const parsed = Date.parse(value);
-    if (!Number.isFinite(parsed)) {
-        throw new Error(`Invalid ${label}: expected an ISO timestamp such as 2026-08-28T00:00:00+03:00.`);
-    }
-    return Timestamp.fromMillis(parsed);
-}
-// Компактная карточка события из полного (сериализованного) документа —
-// той же формы, что grant-проекция в eventAccess.
-export function compactEventFromFullDoc(event) {
-    const meta = (event.meta && typeof event.meta === "object" ? event.meta : {});
-    const telegram = (event.telegram && typeof event.telegram === "object" ? event.telegram : {});
-    return {
-        id: event.id,
-        ownerId: event.ownerId ?? null,
-        workspaceId: event.workspaceId ?? null,
-        title: event.title ?? null,
-        createdAt: event.createdAt ?? null,
-        eventDate: meta.eventDate ?? null,
-        speakerName: meta.speakerName ?? null,
-        pinned: event.pinned === true,
-        telegramEnabled: telegram.enabled === true,
-        trashed: Boolean(event.trashedAt),
-        trashedAt: event.trashedAt ?? null,
-        activeAnalyticsSessionId: event.activeAnalyticsSessionId ?? null,
-    };
-}
-export function compactAnalyticsSession(raw, options) {
-    const session = serialize(raw);
-    const timeline = Array.isArray(session.timeline) ? session.timeline : null;
-    if (timeline) {
-        session.timelineBucketCount = timeline.length;
-        if (options.includeTimeline) {
-            const page = timeline.slice(-options.timelineLimit);
-            session.timeline = page;
-            session.timelineTruncated = timeline.length > page.length;
-            session.timelineReturned = page.length;
-        }
-        else {
-            delete session.timeline;
-            session.timelineOmitted = true;
-        }
-    }
-    if (!options.includeSnapshots) {
-        if (session.baselineSnapshot !== undefined) {
-            delete session.baselineSnapshot;
-            session.baselineSnapshotOmitted = true;
-        }
-        if (session.finalSnapshot !== undefined) {
-            delete session.finalSnapshot;
-            session.finalSnapshotOmitted = true;
-        }
-    }
-    delete session[["n", "moEvaluation"].join("")];
-    return session;
-}
-export function numberMetric(value) {
-    return typeof value === "number" && Number.isFinite(value) ? value : null;
-}
-export function formatSeconds(value) {
-    const seconds = numberMetric(value);
-    if (seconds == null)
-        return "n/a";
-    const total = Math.max(0, Math.round(seconds));
-    const h = Math.floor(total / 3600);
-    const m = Math.floor((total % 3600) / 60);
-    const s = total % 60;
-    if (h > 0)
-        return `${h}h ${String(m).padStart(2, "0")}m ${String(s).padStart(2, "0")}s`;
-    return `${m}m ${String(s).padStart(2, "0")}s`;
-}
-export function formatDateTime(value) {
-    const millis = toMillis(value);
-    if (millis == null)
-        return "n/a";
-    return new Date(millis).toISOString();
-}
-export function markdownMetric(label, value, suffix = "") {
-    const metric = value === null || value === undefined || value === "" ? "n/a" : String(value);
-    return `- ${label}: ${metric}${suffix}`;
-}
-export function sessionReportMarkdown({ eventId, event, sessionId, session, }) {
-    const lines = [
-        `# OKO session report`,
-        "",
-        `Event: ${safeString(event.title, eventId)}`,
-        `Event URL: ${eventUrl(eventId)}`,
-        `Report URL: ${sessionReportUrl(eventId, sessionId)}`,
-        `Session: ${sessionId}`,
-        "",
-        "## Timing",
-        markdownMetric("Started", formatDateTime(session.startedAt)),
-        markdownMetric("Ended", formatDateTime(session.endedAt)),
-        markdownMetric("Duration", formatSeconds(session.durationSec)),
-        "",
-        "## Audience",
-        markdownMetric("Peak viewers", session.peakViewers),
-        markdownMetric("Unique visitors", session.uniqueVisitors),
-        markdownMetric("Views", session.viewCount),
-        markdownMetric("Average watch time", formatSeconds(session.avgTimeSec)),
-        markdownMetric("Median watch time", formatSeconds(session.medianTimeSec)),
-        "",
-        "## Engagement",
-        markdownMetric("Chat messages", session.chatMessages),
-        markdownMetric("Banner impressions", session.bannerImpressions),
-        markdownMetric("Banner clicks", session.bannerClicks),
-        markdownMetric("Banner CTR", session.bannerCtr, session.bannerCtr == null ? "" : "%"),
-        markdownMetric("CTA clicks", session.ctaClicks),
-        markdownMetric("Cards clicks", session.cardsClicks),
-    ];
-    return lines.join("\n");
-}
-/**
- * Поля `telegram`, которые копируются в дубликат события.
- *
- * 🔴 Инвариант: копия не наследует server-owned маркеры. Их ставит сервер по
- * факту уже случившегося действия, и для нового события они ложны. Сейчас
- * такой маркер один — `reminderSent` (CF17 ставит после отправки напоминания
- * и навсегда пропускает события с ним), но список именно белый: новое
- * серверное поле не должно попасть в копию по умолчанию.
- */
-export const TELEGRAM_COPYABLE_KEYS = ["enabled", "channelIds", "autoReminder"];
-export function copyableTelegram(source) {
-    const out = {};
-    for (const key of TELEGRAM_COPYABLE_KEYS) {
-        if (source[key] !== undefined)
-            out[key] = source[key];
-    }
-    return out;
-}