writetrack 0.5.0 → 0.6.0

package/dist/esm/index.d.ts

@@ -2,7 +2,15 @@ import { K as KeystrokeEvent, C as ClipboardEvent, U as UndoRedoEvent, S as Sele
 export { D as DataQualityMetrics, M as ModifierState, b as SessionMetadata } from './index-ChEZuqzG.js';
 import { WriteTrackSink } from './pipes.js';
 export { DatadogClient, DatadogOptions, OTelSpan, OTelTracer, OpenTelemetryOptions, SegmentClient, SegmentOptions, WebhookOptions, datadog, opentelemetry, segment, webhook } from './pipes.js';
-import { S as SessionAnalysis, a as SessionReport, I as IndicatorOutput } from './analysis-types-CDTIp-v7.js';
+import { S as SessionAnalysis, a as SessionReport, I as IndicatorOutput } from './analysis-types-Crmvzq7z.js';
+
+interface PersistedSessionInfo {
+    contentId: string;
+    fieldId: string;
+    keystrokeCount: number;
+    lastSavedAt: number;
+    sessionId: string;
+}
 
 interface WriteTrackOptions {
     target: HTMLElement;
@@ -17,6 +25,11 @@ interface WriteTrackOptions {
     wasmUrl?: string;
     /** Enable IndexedDB session persistence and auto-resume. Requires contentId. */
     persist?: boolean;
+    /** Custom cursor position provider. Called on every keydown/keyup to get the current
+     *  cursor offset. Use this when the target is a rich text editor with its own document
+     *  model (e.g., ProseMirror, Quill, CKEditor). If not provided, falls back to
+     *  selectionStart (input/textarea) or Range-based offset (contenteditable). */
+    cursorPositionProvider?: () => number;
 }
 declare class WriteTrack {
     /** @internal */ keystrokeEvents: KeystrokeEvent[];
@@ -46,6 +59,7 @@ declare class WriteTrack {
     /** @internal */ readonly persist: boolean;
     private _analysis;
     private _persist;
+    private readonly cursorPositionProvider?;
     private _sinks;
     private _listeners;
     /**
@@ -61,6 +75,7 @@ declare class WriteTrack {
      */
     private setupTargetObserver;
     private isRecordingEnabled;
+    private getCursorPosition;
     private recordKeydown;
     private recordKeyup;
     private recordMouseActivity;
@@ -132,6 +147,16 @@ declare class WriteTrack {
     getSessionReport(): Promise<SessionReport>;
     getText(): string;
     getData(): WriteTrackDataSchema;
+    /**
+     * List all persisted sessions with summary metadata.
+     */
+    static listPersistedSessions(): Promise<PersistedSessionInfo[]>;
+    /**
+     * Delete persisted session data by contentId.
+     * If fieldId is provided, deletes only that specific session.
+     * If fieldId is omitted, deletes all sessions for the contentId.
+     */
+    static deletePersistedSession(contentId: string, fieldId?: string): Promise<void>;
 }
 
 /**
@@ -154,6 +179,12 @@ declare function formatIndicator(indicator: IndicatorOutput): string;
  * and returns a full SessionAnalysis without needing a DOM element.
  */
 
+interface AnalyzeEventsOptions {
+    /** Custom URL/path for the WASM binary */
+    wasmUrl?: string;
+    /** License key for WASM verification */
+    licenseKey?: string;
+}
 /**
  * Analyze a WriteTrackDataSchema object without needing a live DOM element.
  *
@@ -161,10 +192,9 @@ declare function formatIndicator(indicator: IndicatorOutput): string;
  * Returns null if WASM loading fails or input is invalid.
  *
  * @param rawEventData - Output of WriteTrack.getData() (WriteTrackDataSchema format)
- * @param wasmUrl - Optional custom URL/path for the WASM binary
- * @param licenseKey - Optional license key for WASM verification
+ * @param options - Optional configuration (wasmUrl, licenseKey)
  */
-declare function analyzeEvents(rawEventData: unknown, wasmUrl?: string, licenseKey?: string): Promise<SessionAnalysis | null>;
+declare function analyzeEvents(rawEventData: unknown, options?: AnalyzeEventsOptions): Promise<SessionAnalysis | null>;
 
 /**
  * Utility functions for timing and statistical calculations
@@ -174,4 +204,4 @@ declare function analyzeEvents(rawEventData: unknown, wasmUrl?: string, licenseK
  */
 declare function getHighResolutionTime(): number;
 
-export { ClipboardEvent, CompositionEvent, IndicatorOutput, KeystrokeEvent, ProgrammaticInsertionEvent, SelectionEvent, SessionAnalysis, SessionReport, UndoRedoEvent, WriteTrack, WriteTrackDataSchema, type WriteTrackOptions, WriteTrackSink, analyzeEvents, WriteTrack as default, formatIndicator, getHighResolutionTime };
+export { type AnalyzeEventsOptions, ClipboardEvent, CompositionEvent, IndicatorOutput, KeystrokeEvent, type PersistedSessionInfo, ProgrammaticInsertionEvent, SelectionEvent, SessionAnalysis, SessionReport, UndoRedoEvent, WriteTrack, WriteTrackDataSchema, type WriteTrackOptions, WriteTrackSink, analyzeEvents, WriteTrack as default, formatIndicator, getHighResolutionTime };