@clue-ai/browser-sdk 0.0.1

package/dist/authoring/recording.js

@@ -0,0 +1,481 @@
+const MAX_RECORDED_ACTION_UNITS = 200;
+const EVENT_TITLE_LABELS = {
+    page_view: "ページ表示",
+    page_leave: "ページ離脱",
+    route_change: "画面遷移",
+    element_clicked: "要素クリック",
+    input_committed: "入力確定",
+    form_submitted: "フォーム送信",
+    toggle_changed: "切替変更",
+    selection_committed: "選択確定",
+    file_selected: "ファイル選択",
+    drag_drop_completed: "ドラッグ&ドロップ",
+    request_started: "リクエスト開始",
+    request_finished: "リクエスト完了",
+    request_failed: "リクエスト失敗",
+    error_raised: "エラー発生",
+    session_started: "セッション開始",
+    session_ended: "セッション終了",
+    flow_started: "フロー開始",
+    flow_finished: "フロー完了",
+    flow_failed: "フロー失敗",
+    dead_click_detected: "無効クリック",
+    error_click_detected: "エラークリック",
+    rage_click_detected: "連続クリック",
+    custom_emitted: "カスタムイベント",
+    unknown_observed: "未分類イベント",
+};
+const EVENT_CATEGORY_LABELS = {
+    session: "セッション",
+    navigation: "画面",
+    action: "操作",
+    request: "リクエスト",
+    error: "エラー",
+    flow: "フロー",
+    support: "補助",
+    custom: "カスタム",
+};
+const ACTION_UNIT_TYPE_LABELS = {
+    user_action: "ユーザー操作",
+    custom_action: "カスタム操作",
+};
+const ACTION_UNIT_STATUS_LABELS = {
+    completed: "完了",
+    failed: "失敗",
+    abandoned: "中断",
+};
+const ACTION_UNIT_ROLE_LABELS = {
+    action: "起点",
+    outcome: "結果",
+    context: "文脈",
+    support: "補助",
+    anchor: "起点",
+    continuation: "継続",
+    secondary: "補助",
+    noise: "ノイズ",
+};
+const REQUEST_STATUS_LABELS = {
+    finished: "成功",
+    failed: "失敗",
+    success: "成功",
+    failure: "失敗",
+    canceled: "中断",
+};
+const toTitleCase = (value) => {
+    return value
+        .split(/[\s._:/-]+/)
+        .filter(Boolean)
+        .map((segment) => {
+        if (segment.length <= 2 && segment === segment.toUpperCase()) {
+            return segment;
+        }
+        return segment.charAt(0).toUpperCase() + segment.slice(1).toLowerCase();
+    })
+        .join(" ");
+};
+const HUMAN_TOKEN_MAP = {
+    api: "API",
+    drafts: "Drafts",
+    quicklink: "Quicklink",
+    quicklinks: "Quicklinks",
+    url: "URL",
+    ui: "UI",
+};
+const normalizeTechnicalLabel = (value) => {
+    const trimmed = value.trim();
+    if (!trimmed) {
+        return null;
+    }
+    const stripped = trimmed
+        .replace(/^(?:id|name|aria|dtid|dqa|fp|struct):/i, "")
+        .replace(/^[^:]+:/, (prefix) => /^fp:/i.test(prefix) ? "" : prefix.length <= 6 ? "" : prefix);
+    if (!stripped || /^([a-f0-9]{12,}|p\d+-t\d+)$/i.test(stripped)) {
+        return null;
+    }
+    const tokens = stripped
+        .split(/[\s/_:.-]+/)
+        .flatMap((token) => token.split(/(?=[A-Z])/))
+        .map((token) => token.trim())
+        .filter(Boolean)
+        .filter((token) => !/^[a-f0-9]{12,}$/i.test(token))
+        .filter((token) => !/^(?:headlessui|radix|react|button|input|div|span|struct|none|na)$/i.test(token));
+    if (tokens.length === 0) {
+        return null;
+    }
+    return tokens
+        .map((token) => HUMAN_TOKEN_MAP[token.toLowerCase()] ?? toTitleCase(token))
+        .filter((token, index, all) => token.length > 0 && all.indexOf(token) === index)
+        .join(" ");
+};
+const readRawPropertyString = (rawProperties, keys) => {
+    for (const key of keys) {
+        const value = rawProperties?.[key];
+        if (typeof value === "string" && value.trim().length > 0) {
+            return value.trim();
+        }
+    }
+    return null;
+};
+const buildRequestLabelFromEndpoint = (endpoint) => {
+    const pathname = endpoint
+        .split("?")[0]
+        ?.split("/")
+        .map((segment) => segment.trim())
+        .filter(Boolean)
+        .filter((segment) => segment !== "api")
+        .filter((segment) => !segment.startsWith(":"))
+        .filter((segment) => !/^[a-f0-9-]{8,}$/i.test(segment));
+    const lastSegment = pathname && pathname.length > 0 ? pathname[pathname.length - 1] ?? null : null;
+    const normalized = lastSegment ? normalizeTechnicalLabel(lastSegment) : null;
+    return normalized ? `${normalized} API` : "API リクエスト";
+};
+const buildAtomDetailLabel = (atom, requestSpans) => {
+    const explicitLabel = atom.element_label_candidate ??
+        atom.aria_label_candidate ??
+        atom.field_name_candidate ??
+        atom.placeholder_candidate ??
+        readRawPropertyString(atom.raw_properties_json, [
+            "target_label",
+            "ui_target_display_name",
+            "field_label",
+            "button_text",
+            "visible_text",
+            "accessibility_label",
+            "placeholder",
+            "placeholder_text",
+        ]) ??
+        normalizeTechnicalLabel(atom.ui_target_id ?? "") ??
+        normalizeTechnicalLabel(atom.stable_key ?? "") ??
+        normalizeTechnicalLabel(atom.form_key ?? "");
+    if (atom.event_name === "request_finished" ||
+        atom.event_name === "request_failed") {
+        const requestSummary = requestSpans.find((requestSpan) => typeof requestSpan.summary_title === "string" &&
+            requestSpan.summary_title.trim().length > 0)?.summary_title ?? null;
+        return requestSummary ?? buildRequestLabelFromEndpoint(requestSpans[0]?.endpoint_canonical ?? atom.backend_scope ?? atom.service_key ?? "");
+    }
+    if (explicitLabel) {
+        const descriptor = atom.event_name === "input_committed" || atom.field_type
+            ? "入力欄"
+            : atom.event_name === "element_clicked"
+                ? "ボタン"
+                : null;
+        return descriptor && !explicitLabel.endsWith(descriptor)
+            ? `${explicitLabel} ${descriptor}`
+            : explicitLabel;
+    }
+    return null;
+};
+const formatEventTitle = (eventName) => {
+    return EVENT_TITLE_LABELS[eventName] ?? toTitleCase(eventName);
+};
+const formatEventCategoryLabel = (eventCategory) => {
+    if (!eventCategory) {
+        return "イベント";
+    }
+    const normalized = eventCategory.trim().toLowerCase();
+    return (EVENT_CATEGORY_LABELS[normalized] ??
+        EVENT_CATEGORY_LABELS[eventCategory] ??
+        toTitleCase(eventCategory));
+};
+const formatActionUnitTypeLabel = (unitType) => {
+    if (!unitType || unitType.trim().length === 0) {
+        return "操作";
+    }
+    const normalized = unitType.trim().toLowerCase();
+    return (ACTION_UNIT_TYPE_LABELS[normalized] ??
+        ACTION_UNIT_TYPE_LABELS[unitType] ??
+        toTitleCase(unitType));
+};
+const formatActionUnitStatusLabel = (status) => {
+    if (!status || status.trim().length === 0) {
+        return "完了";
+    }
+    const normalized = status.trim().toLowerCase();
+    return (ACTION_UNIT_STATUS_LABELS[normalized] ??
+        ACTION_UNIT_STATUS_LABELS[status] ??
+        toTitleCase(status));
+};
+const formatActionUnitRoleLabel = (role) => {
+    if (!role || role.trim().length === 0) {
+        return "補助";
+    }
+    const normalized = role.trim().toLowerCase();
+    return (ACTION_UNIT_ROLE_LABELS[normalized] ??
+        ACTION_UNIT_ROLE_LABELS[role] ??
+        toTitleCase(role));
+};
+const formatRequestStatusLabel = (status) => {
+    if (!status || status.trim().length === 0) {
+        return "結果不明";
+    }
+    const normalized = status.trim().toLowerCase();
+    return (REQUEST_STATUS_LABELS[normalized] ??
+        REQUEST_STATUS_LABELS[status] ??
+        toTitleCase(status));
+};
+const formatOccurredAtLabel = (occurredAt) => {
+    const parsed = new Date(occurredAt);
+    if (Number.isNaN(parsed.getTime())) {
+        return "";
+    }
+    return new Intl.DateTimeFormat(undefined, {
+        hour: "2-digit",
+        minute: "2-digit",
+        second: "2-digit",
+    }).format(parsed);
+};
+const formatDurationLabel = (durationMs) => {
+    if (durationMs < 1000) {
+        return `${durationMs}ms`;
+    }
+    return `${(durationMs / 1000).toFixed(1)}s`;
+};
+const formatScreenLabelFromScreenKey = (screenKey) => {
+    if (!screenKey) {
+        return null;
+    }
+    const segments = screenKey
+        .split("/")
+        .map((segment) => segment.trim())
+        .filter((segment) => segment.length > 0)
+        .filter((segment) => !segment.startsWith("{") &&
+        !segment.startsWith(":") &&
+        !segment.startsWith("<"));
+    if (segments.length <= 1) {
+        return "ホーム画面";
+    }
+    const lastSegment = segments[segments.length - 1];
+    if (!lastSegment) {
+        return null;
+    }
+    const label = toTitleCase(lastSegment);
+    return `${label}画面`;
+};
+const formatActionUnitSubtitle = (actionUnit) => {
+    const humanLabel = actionUnit.primary_target_label ?? actionUnit.primary_screen_label ?? null;
+    if (humanLabel && humanLabel.length > 0) {
+        return humanLabel;
+    }
+    return `${actionUnit.atom_count} atoms / ${actionUnit.request_span_count} request spans / ${formatActionUnitStatusLabel(actionUnit.status)}`;
+};
+const toRecordedAtom = (atom, requestSpans) => {
+    const roleLabel = formatActionUnitRoleLabel(atom.event_role);
+    return {
+        id: atom.atom_id,
+        title: `【${roleLabel}】${formatEventTitle(atom.event_name)}`,
+        subtitle: null,
+        detailLabel: buildAtomDetailLabel(atom, requestSpans),
+        occurredAtLabel: formatOccurredAtLabel(atom.occurred_at),
+        badgeLabel: formatEventCategoryLabel(atom.event_category),
+        roleLabel,
+    };
+};
+const toRecordedRequestSpan = (requestSpan) => ({
+    id: requestSpan.request_span_id,
+    title: requestSpan.summary_title,
+    subtitle: requestSpan.endpoint_canonical,
+    statusLabel: formatRequestStatusLabel(requestSpan.status_kind),
+    durationLabel: formatDurationLabel(requestSpan.duration_ms),
+});
+const toRecordedEvent = (actionUnit) => ({
+    id: actionUnit.action_unit_id,
+    actionUnit,
+    occurredAtLabel: formatOccurredAtLabel(actionUnit.start_at),
+    title: actionUnit.summary_label,
+    subtitle: formatActionUnitSubtitle(actionUnit),
+    screenLabel: formatActionUnitSectionTitle(actionUnit),
+    badgeLabel: formatActionUnitTypeLabel(actionUnit.unit_type),
+    atoms: actionUnit.atoms.map((atom) => toRecordedAtom(atom, actionUnit.request_spans)),
+    requestSpans: actionUnit.request_spans.map(toRecordedRequestSpan),
+});
+export const formatActionUnitSectionTitle = (actionUnit) => {
+    const startScreenKey = actionUnit.atoms.find((atom) => atom.screen_key && atom.screen_key.length > 0)
+        ?.screen_key ?? null;
+    return (formatScreenLabelFromScreenKey(startScreenKey) ??
+        actionUnit.primary_screen_label ??
+        "イベント");
+};
+const isWithinAnyWindow = (occurredAtMs, windows) => {
+    return windows.some((window) => {
+        if (occurredAtMs < window.startMs) {
+            return false;
+        }
+        if (window.endMs !== null && occurredAtMs > window.endMs) {
+            return false;
+        }
+        return true;
+    });
+};
+export const createAuthoringRecordingController = () => {
+    let isRecording = false;
+    let windows = [];
+    let entries = [];
+    const selectedEventIds = new Set();
+    const pendingRemovalEventIds = new Set();
+    const highlightTraces = new Map();
+    const listeners = new Set();
+    const buildSnapshot = () => ({
+        isRecording,
+        hasRecordedWindow: windows.length > 0,
+        entries: entries.map((entry) => ({
+            ...entry,
+            selected: selectedEventIds.has(entry.id) && !pendingRemovalEventIds.has(entry.id),
+            pendingRemoval: pendingRemovalEventIds.has(entry.id),
+            highlightTrace: highlightTraces.get(entry.id) ?? null,
+        })),
+        selectedCount: [...selectedEventIds].filter((eventId) => !pendingRemovalEventIds.has(eventId)).length,
+        saveTargetCount: entries.filter((entry) => !pendingRemovalEventIds.has(entry.id)).length,
+    });
+    const emit = () => {
+        const snapshot = buildSnapshot();
+        for (const listener of listeners) {
+            listener(snapshot);
+        }
+    };
+    return {
+        getSnapshot() {
+            return buildSnapshot();
+        },
+        subscribe(listener) {
+            listeners.add(listener);
+            listener(buildSnapshot());
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+        syncSession(session) {
+            isRecording = session.status === "recording";
+            windows = session.recording_windows
+                .map((window) => ({
+                startMs: Date.parse(window.start_at),
+                endMs: window.end_at ? Date.parse(window.end_at) : null,
+            }))
+                .filter((window) => Number.isFinite(window.startMs) &&
+                (window.endMs === null || Number.isFinite(window.endMs)));
+            emit();
+        },
+        toggleSelected(eventId) {
+            const hasEntry = entries.some((entry) => entry.id === eventId);
+            if (!hasEntry || pendingRemovalEventIds.has(eventId)) {
+                return;
+            }
+            if (selectedEventIds.has(eventId)) {
+                selectedEventIds.delete(eventId);
+            }
+            else {
+                selectedEventIds.clear();
+                selectedEventIds.add(eventId);
+            }
+            emit();
+        },
+        markPendingRemoval(eventId) {
+            const hasEntry = entries.some((entry) => entry.id === eventId);
+            if (!hasEntry) {
+                return;
+            }
+            pendingRemovalEventIds.add(eventId);
+            selectedEventIds.delete(eventId);
+            emit();
+        },
+        restorePendingRemoval(eventId) {
+            if (!pendingRemovalEventIds.has(eventId)) {
+                return;
+            }
+            pendingRemovalEventIds.delete(eventId);
+            emit();
+        },
+        setHighlightTrace(eventId, trace) {
+            const hasEntry = entries.some((entry) => entry.id === eventId);
+            if (!hasEntry) {
+                return;
+            }
+            if (trace) {
+                highlightTraces.set(eventId, trace);
+            }
+            else {
+                highlightTraces.delete(eventId);
+            }
+            emit();
+        },
+        replaceActionUnits(actionUnits) {
+            if (windows.length === 0) {
+                if (entries.length > 0) {
+                    entries = [];
+                    selectedEventIds.clear();
+                    emit();
+                }
+                return;
+            }
+            const nextEntries = [...actionUnits]
+                .filter((actionUnit) => {
+                const occurredAtMs = Date.parse(actionUnit.start_at);
+                return (!Number.isNaN(occurredAtMs) &&
+                    isWithinAnyWindow(occurredAtMs, windows));
+            })
+                .sort((left, right) => {
+                const occurredDelta = Date.parse(left.start_at) - Date.parse(right.start_at);
+                if (occurredDelta !== 0) {
+                    return occurredDelta;
+                }
+                return left.action_unit_id.localeCompare(right.action_unit_id);
+            })
+                .slice(-MAX_RECORDED_ACTION_UNITS)
+                .map(toRecordedEvent);
+            const nextEntryIds = new Set(nextEntries.map((entry) => entry.id));
+            for (const selectedId of selectedEventIds) {
+                if (!nextEntryIds.has(selectedId)) {
+                    selectedEventIds.delete(selectedId);
+                }
+            }
+            for (const removedId of pendingRemovalEventIds) {
+                if (!nextEntryIds.has(removedId)) {
+                    pendingRemovalEventIds.delete(removedId);
+                }
+            }
+            for (const eventId of highlightTraces.keys()) {
+                if (!nextEntryIds.has(eventId)) {
+                    highlightTraces.delete(eventId);
+                }
+            }
+            entries = nextEntries;
+            emit();
+        },
+        upsertActionUnit(actionUnit) {
+            if (windows.length === 0) {
+                return;
+            }
+            const occurredAtMs = Date.parse(actionUnit.start_at);
+            if (Number.isNaN(occurredAtMs) ||
+                !isWithinAnyWindow(occurredAtMs, windows)) {
+                return;
+            }
+            const nextEntry = toRecordedEvent(actionUnit);
+            const currentEntries = entries.filter((entry) => entry.id !== actionUnit.action_unit_id);
+            currentEntries.push(nextEntry);
+            currentEntries.sort((left, right) => {
+                const occurredDelta = Date.parse(left.actionUnit.start_at) -
+                    Date.parse(right.actionUnit.start_at);
+                if (occurredDelta !== 0) {
+                    return occurredDelta;
+                }
+                return left.id.localeCompare(right.id);
+            });
+            entries = currentEntries.slice(-MAX_RECORDED_ACTION_UNITS);
+            for (const eventId of highlightTraces.keys()) {
+                if (!entries.some((entry) => entry.id === eventId)) {
+                    highlightTraces.delete(eventId);
+                }
+            }
+            emit();
+        },
+        reset() {
+            isRecording = false;
+            windows = [];
+            entries = [];
+            selectedEventIds.clear();
+            pendingRemovalEventIds.clear();
+            highlightTraces.clear();
+            emit();
+        },
+    };
+};

package/dist/authoring/service-logo.d.ts

@@ -0,0 +1 @@
+export { SERVICE_LOGO_URL } from "./service-logo.generated";

package/dist/authoring/service-logo.generated.d.ts

@@ -0,0 +1 @@
+export declare const SERVICE_LOGO_URL = "data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMTMwIiBoZWlnaHQ9IjEzMCIgdmlld0JveD0iMCAwIDEzMCAxMzAiIGZpbGw9Im5vbmUiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+CjxnIGNsaXAtcGF0aD0idXJsKCNjbGlwMF8yNzBfMTIxMikiPgo8cGF0aCBkPSJNMjkuNzY1MiA1Mi42MDI3QzMxLjIxOTUgNDkuMTcwNCAzNS41NTU5IDQ4LjA4NjUgMzguNDU0MiA1MC40MzA3TDExNS42NjggMTEyLjg4M0MxMTkuNzc3IDExNi4yMDcgMTE3LjQyNyAxMjIuODUgMTEyLjE0MiAxMjIuODVIOC40NjU2NUM0LjQ1MDA2IDEyMi44NSAxLjczNjE2IDExOC43NTIgMy4zMDI4MiAxMTUuMDU1TDI5Ljc2NTIgNTIuNjAyN1oiIGZpbGw9ImJsYWNrIi8+CjxwYXRoIGQ9Ik05Ny4wNTEyIDczLjc0NTlDOTUuNTk2OSA3Ny4xNzgyIDkxLjI2MDUgNzguMjYyMiA4OC4zNjIyIDc1LjkxOEwxMS4xNDg2IDEzLjQ2NTdDNy4wMzkyMSAxMC4xNDIgOS4zODk0NiAzLjQ5ODkyIDE0LjY3NDggMy40OTg5MkwxMTguMzUxIDMuNDk4OTNDMTIyLjM2NiAzLjQ5ODkzIDEyNS4wOCA3LjU5NjM0IDEyMy41MTQgMTEuMjkzN0w5Ny4wNTEyIDczLjc0NTlaIiBmaWxsPSJibGFjayIvPgo8L2c+CjxkZWZzPgo8Y2xpcFBhdGggaWQ9ImNsaXAwXzI3MF8xMjEyIj4KPHJlY3Qgd2lkdGg9IjEzMCIgaGVpZ2h0PSIxMzAiIGZpbGw9IndoaXRlIi8+CjwvY2xpcFBhdGg+CjwvZGVmcz4KPC9zdmc+Cg==";

package/dist/authoring/service-logo.generated.js

@@ -0,0 +1,3 @@
+// This file is generated from src/authoring/service-logo.svg.
+// Run `pnpm --filter @clue-ai/browser-sdk build` after updating the SVG.
+export const SERVICE_LOGO_URL = "data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMTMwIiBoZWlnaHQ9IjEzMCIgdmlld0JveD0iMCAwIDEzMCAxMzAiIGZpbGw9Im5vbmUiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+CjxnIGNsaXAtcGF0aD0idXJsKCNjbGlwMF8yNzBfMTIxMikiPgo8cGF0aCBkPSJNMjkuNzY1MiA1Mi42MDI3QzMxLjIxOTUgNDkuMTcwNCAzNS41NTU5IDQ4LjA4NjUgMzguNDU0MiA1MC40MzA3TDExNS42NjggMTEyLjg4M0MxMTkuNzc3IDExNi4yMDcgMTE3LjQyNyAxMjIuODUgMTEyLjE0MiAxMjIuODVIOC40NjU2NUM0LjQ1MDA2IDEyMi44NSAxLjczNjE2IDExOC43NTIgMy4zMDI4MiAxMTUuMDU1TDI5Ljc2NTIgNTIuNjAyN1oiIGZpbGw9ImJsYWNrIi8+CjxwYXRoIGQ9Ik05Ny4wNTEyIDczLjc0NTlDOTUuNTk2OSA3Ny4xNzgyIDkxLjI2MDUgNzguMjYyMiA4OC4zNjIyIDc1LjkxOEwxMS4xNDg2IDEzLjQ2NTdDNy4wMzkyMSAxMC4xNDIgOS4zODk0NiAzLjQ5ODkyIDE0LjY3NDggMy40OTg5MkwxMTguMzUxIDMuNDk4OTNDMTIyLjM2NiAzLjQ5ODkzIDEyNS4wOCA3LjU5NjM0IDEyMy41MTQgMTEuMjkzN0w5Ny4wNTEyIDczLjc0NTlaIiBmaWxsPSJibGFjayIvPgo8L2c+CjxkZWZzPgo8Y2xpcFBhdGggaWQ9ImNsaXAwXzI3MF8xMjEyIj4KPHJlY3Qgd2lkdGg9IjEzMCIgaGVpZ2h0PSIxMzAiIGZpbGw9IndoaXRlIi8+CjwvY2xpcFBhdGg+CjwvZGVmcz4KPC9zdmc+Cg==";

package/dist/authoring/service-logo.js

@@ -0,0 +1 @@
+export { SERVICE_LOGO_URL } from "./service-logo.generated";

package/dist/authoring/session.d.ts

@@ -0,0 +1,23 @@
+export declare const BUSINESS_EVENT_AUTHORING_WINDOW_NAME_PREFIX = "__clue_business_event_authoring__:";
+export type BusinessEventAuthoringSession = {
+    type: "clue-business-event-authoring-session";
+    session_id: string;
+    issued_at: string;
+    expires_at: string;
+    clue_origin: string;
+    project_id: string;
+    project_key: string;
+    target_origin: string;
+    target_url: string;
+    status: "paused" | "recording" | "ended";
+    recording_windows: Array<{
+        start_at: string;
+        end_at: string | null;
+    }>;
+    algorithm_version: number;
+};
+export declare function parseBusinessEventAuthoringToken(windowName: string): string | null;
+export declare function persistBusinessEventAuthoringToken(token: string): void;
+export declare function readPersistedBusinessEventAuthoringToken(): string | null;
+export declare function clearPersistedBusinessEventAuthoringToken(): void;
+export declare function isBusinessEventAuthoringSession(value: unknown): value is BusinessEventAuthoringSession;

package/dist/authoring/session.js

@@ -0,0 +1,127 @@
+export const BUSINESS_EVENT_AUTHORING_WINDOW_NAME_PREFIX = "__clue_business_event_authoring__:";
+const BUSINESS_EVENT_AUTHORING_STORAGE_KEY = "__clue_business_event_authoring_token__";
+function isHttpUrl(value) {
+    try {
+        const parsed = new URL(value);
+        return parsed.protocol === "http:" || parsed.protocol === "https:";
+    }
+    catch {
+        return false;
+    }
+}
+export function parseBusinessEventAuthoringToken(windowName) {
+    if (!windowName.startsWith(BUSINESS_EVENT_AUTHORING_WINDOW_NAME_PREFIX)) {
+        return null;
+    }
+    const token = windowName
+        .slice(BUSINESS_EVENT_AUTHORING_WINDOW_NAME_PREFIX.length)
+        .trim();
+    return token.length > 0 ? token : null;
+}
+function getAuthoringStorage() {
+    try {
+        return window.localStorage;
+    }
+    catch {
+        return null;
+    }
+}
+function decodeBusinessEventAuthoringToken(token) {
+    const [payloadSegment] = token.split(".", 1);
+    if (!payloadSegment) {
+        return null;
+    }
+    try {
+        const normalizedSegment = payloadSegment.replace(/-/g, "+").replace(/_/g, "/");
+        const padding = normalizedSegment.length % 4 === 0
+            ? ""
+            : "=".repeat(4 - (normalizedSegment.length % 4));
+        const decoded = JSON.parse(atob(`${normalizedSegment}${padding}`));
+        if (decoded &&
+            typeof decoded === "object" &&
+            typeof decoded.expires_at === "string") {
+            return decoded;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+function isTokenExpired(token) {
+    const payload = decodeBusinessEventAuthoringToken(token);
+    if (!payload || typeof payload.expires_at !== "string") {
+        return false;
+    }
+    const expiresAtMs = Date.parse(payload.expires_at);
+    return Number.isFinite(expiresAtMs) && expiresAtMs <= Date.now();
+}
+export function persistBusinessEventAuthoringToken(token) {
+    const normalizedToken = token.trim();
+    if (normalizedToken.length === 0) {
+        return;
+    }
+    window.name = `${BUSINESS_EVENT_AUTHORING_WINDOW_NAME_PREFIX}${normalizedToken}`;
+    getAuthoringStorage()?.setItem(BUSINESS_EVENT_AUTHORING_STORAGE_KEY, normalizedToken);
+}
+export function readPersistedBusinessEventAuthoringToken() {
+    const windowToken = parseBusinessEventAuthoringToken(window.name);
+    if (windowToken) {
+        if (isTokenExpired(windowToken)) {
+            clearPersistedBusinessEventAuthoringToken();
+            return null;
+        }
+        getAuthoringStorage()?.setItem(BUSINESS_EVENT_AUTHORING_STORAGE_KEY, windowToken);
+        return windowToken;
+    }
+    const storageToken = getAuthoringStorage()?.getItem(BUSINESS_EVENT_AUTHORING_STORAGE_KEY);
+    if (!storageToken) {
+        return null;
+    }
+    const normalizedToken = storageToken.trim();
+    if (normalizedToken.length === 0) {
+        return null;
+    }
+    if (isTokenExpired(normalizedToken)) {
+        clearPersistedBusinessEventAuthoringToken();
+        return null;
+    }
+    window.name = `${BUSINESS_EVENT_AUTHORING_WINDOW_NAME_PREFIX}${normalizedToken}`;
+    return normalizedToken;
+}
+export function clearPersistedBusinessEventAuthoringToken() {
+    if (window.name.startsWith(BUSINESS_EVENT_AUTHORING_WINDOW_NAME_PREFIX)) {
+        window.name = "";
+    }
+    getAuthoringStorage()?.removeItem(BUSINESS_EVENT_AUTHORING_STORAGE_KEY);
+}
+export function isBusinessEventAuthoringSession(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return false;
+    }
+    const session = value;
+    const recordingWindows = session.recording_windows;
+    return (session.type === "clue-business-event-authoring-session" &&
+        typeof session.session_id === "string" &&
+        typeof session.issued_at === "string" &&
+        typeof session.expires_at === "string" &&
+        typeof session.project_id === "string" &&
+        typeof session.project_key === "string" &&
+        typeof session.target_url === "string" &&
+        typeof session.target_origin === "string" &&
+        typeof session.clue_origin === "string" &&
+        (session.status === "paused" ||
+            session.status === "recording" ||
+            session.status === "ended") &&
+        Array.isArray(recordingWindows) &&
+        recordingWindows.every((window) => window &&
+            typeof window === "object" &&
+            !Array.isArray(window) &&
+            typeof window.start_at === "string" &&
+            (window.end_at === null ||
+                typeof window.end_at === "string")) &&
+        typeof session.algorithm_version === "number" &&
+        isHttpUrl(session.target_origin) &&
+        isHttpUrl(session.clue_origin) &&
+        isHttpUrl(session.target_url));
+}

package/dist/authoring/surface.d.ts

@@ -0,0 +1,11 @@
+export declare const AUTHORING_ROOT_ATTRIBUTE = "data-clue-authoring-root";
+export declare const AUTHORING_ROOT_ATTRIBUTE_VALUE = "true";
+export declare const AUTHORING_INTERNAL_REQUEST_HEADER = "x-clue-authoring-request";
+export declare const AUTHORING_INTERNAL_REQUEST_HEADER_VALUE = "true";
+export declare const AUTHORING_INTERNAL_REQUEST_PATH_SEGMENT = "/business-events/authoring";
+export declare function markAuthoringRoot(element: HTMLElement): void;
+export declare function resolveAuthoringSurfaceRoot(target: EventTarget | Element | null | undefined): HTMLElement | null;
+export declare function isWithinAuthoringSurface(target: EventTarget | Element | null | undefined): boolean;
+export declare function hasAuthoringInternalRequestHeader(headers: Record<string, string>): boolean;
+export declare function isAuthoringInternalRequestUrl(rawUrl: string): boolean;
+export declare function logAuthoringRequestExclusion(matchedRequestRule: "request_header" | "path_segment" | "ignore_url_prefix"): void;