joopjs 2.0.0

package/dist/observability/index.d.ts

@@ -0,0 +1,179 @@
+import { J as JoopObservable } from '../index-Dz0gOur2.js';
+
+declare class JoopCorrelationService {
+    private _correlationId;
+    private _requestId;
+    newCorrelation(): string;
+    newRequest(): string;
+    getCorrelationId(): string;
+    getRequestId(): string;
+    headers(): Record<string, string>;
+    clear(): void;
+}
+
+type JoopAuditAction = 'login' | 'logout' | 'session-timeout' | 'session-extended' | 'transfer-initiated' | 'transfer-confirmed' | 'transfer-failed' | 'profile-updated' | 'password-changed' | 'settings-changed' | 'document-viewed' | 'statement-downloaded' | 'otp-sent' | 'otp-verified' | 'biometric-registered' | 'biometric-authenticated' | string;
+interface JoopAuditEntry {
+    id: string;
+    action: JoopAuditAction;
+    timestamp: number;
+    userId?: string;
+    sessionId?: string;
+    correlationId?: string;
+    metadata?: Record<string, unknown>;
+    success: boolean;
+}
+type JoopAuditListener = (entry: JoopAuditEntry) => void;
+declare class JoopAuditLog {
+    private _maxEntries;
+    private _entries;
+    private _listeners;
+    constructor(_maxEntries?: number);
+    record(action: JoopAuditAction, options?: {
+        userId?: string;
+        sessionId?: string;
+        correlationId?: string;
+        metadata?: Record<string, unknown>;
+        success?: boolean;
+    }): JoopAuditEntry;
+    getAll(): JoopAuditEntry[];
+    getByAction(action: JoopAuditAction): JoopAuditEntry[];
+    getBySession(sessionId: string): JoopAuditEntry[];
+    getByUser(userId: string): JoopAuditEntry[];
+    onRecord(listener: JoopAuditListener): () => void;
+    clear(): void;
+    export(): string;
+}
+
+interface JoopPerfMark {
+    name: string;
+    startTime: number;
+    endTime?: number;
+    duration?: number;
+    metadata?: Record<string, unknown>;
+}
+declare class JoopPerformanceService {
+    private _marks;
+    private _completed;
+    mark(name: string, metadata?: Record<string, unknown>): void;
+    measure(name: string): JoopPerfMark | null;
+    timeAsync<T>(name: string, fn: () => Promise<T>): Promise<T>;
+    timeSync<T>(name: string, fn: () => T): T;
+    getCompleted(): JoopPerfMark[];
+    getByName(name: string): JoopPerfMark[];
+    getAverage(name: string): number | null;
+    clear(): void;
+}
+
+interface JoopErrorReport {
+    id: string;
+    message: string;
+    stack?: string;
+    context?: Record<string, unknown>;
+    timestamp: number;
+    userId?: string;
+    sessionId?: string;
+}
+type JoopErrorHandler = (report: JoopErrorReport) => void | Promise<void>;
+declare class JoopErrorReporter {
+    private _handlers;
+    private _userId;
+    private _sessionId;
+    private _context;
+    setUser(userId: string): void;
+    setSession(sessionId: string): void;
+    setContext(ctx: Record<string, unknown>): void;
+    addHandler(handler: JoopErrorHandler): () => void;
+    capture(error: unknown, extra?: Record<string, unknown>): JoopErrorReport;
+    captureMessage(message: string, extra?: Record<string, unknown>): JoopErrorReport;
+    clear(): void;
+}
+
+interface JoopVitalsSnapshot {
+    lcp: number | null;
+    fid: number | null;
+    inp: number | null;
+    cls: number | null;
+    ttfb: number | null;
+    fcp: number | null;
+    capturedAt: number;
+}
+interface JoopVitalUpdate {
+    metric: keyof Omit<JoopVitalsSnapshot, 'capturedAt'>;
+    value: number;
+    rating: 'good' | 'needs-improvement' | 'poor';
+}
+declare class JoopWebVitals {
+    private _vitals;
+    private _vitals$;
+    private _snapshot$;
+    private _observers;
+    private _running;
+    start(): void;
+    stop(): void;
+    snapshot(): JoopVitalsSnapshot;
+    vitals$(): JoopObservable<JoopVitalUpdate>;
+    snapshot$(): JoopObservable<JoopVitalsSnapshot>;
+    getLCP(): number | null;
+    getCLS(): number | null;
+    getINP(): number | null;
+    getTTFB(): number | null;
+    getFCP(): number | null;
+    getFID(): number | null;
+    getRating(metric: string): 'good' | 'needs-improvement' | 'poor';
+    private _record;
+    private _observe;
+    private _observeLCP;
+    private _observeFID;
+    private _observeINP;
+    private _observeCLS;
+    private _observeTTFB;
+    private _observeFCP;
+    private _buildSnapshot;
+}
+
+type JoopRecordedEventType = 'dom-mutation' | 'click' | 'input' | 'scroll' | 'resize' | 'navigation' | 'custom';
+interface JoopRecordedEvent {
+    type: JoopRecordedEventType;
+    timestamp: number;
+    selector?: string;
+    value?: string;
+    data?: Record<string, unknown>;
+}
+interface JoopSessionRecord {
+    startedAt: number;
+    stoppedAt: number;
+    events: JoopRecordedEvent[];
+    url: string;
+    userAgent: string;
+}
+interface JoopSessionRecorderOptions {
+    maskSelectors?: string[];
+    ignoreSelectors?: string[];
+    redactInputs?: boolean;
+    maxEvents?: number;
+    captureScroll?: boolean;
+    captureResize?: boolean;
+}
+declare class JoopSessionRecorder {
+    private _events;
+    private _running;
+    private _paused;
+    private _startedAt;
+    private _opts;
+    private _cleanup;
+    private _mutationObserver;
+    private _scrollTimer;
+    start(options?: JoopSessionRecorderOptions): void;
+    pause(): void;
+    resume(): void;
+    stop(): JoopSessionRecord;
+    events(): JoopRecordedEvent[];
+    export(format?: 'json' | 'compressed'): string;
+    addEvent(type: JoopRecordedEventType, data?: Record<string, unknown>): void;
+    private _push;
+    private _attachListeners;
+    private _detach;
+    private _shouldIgnore;
+}
+
+export { type JoopAuditAction, type JoopAuditEntry, type JoopAuditListener, JoopAuditLog, JoopCorrelationService, type JoopErrorHandler, type JoopErrorReport, JoopErrorReporter, type JoopPerfMark, JoopPerformanceService, type JoopRecordedEvent, type JoopSessionRecord, JoopSessionRecorder, type JoopSessionRecorderOptions, type JoopVitalUpdate, type JoopVitalsSnapshot, JoopWebVitals };