writetrack 0.7.0 → 0.9.0

package/README.md

@@ -4,7 +4,7 @@ Detect AI-generated and pasted text through keystroke dynamics.
 
 WriteTrack analyzes _how_ text was entered, not what was written. Human typing has natural variation in timing, rhythm, and corrections. Pasted or AI-generated text arrives all at once with no behavioral fingerprint. WriteTrack captures the difference.
 
-- **~100KB** gzipped (15KB JS + 86KB WASM)
+- **~115KB** gzipped (17KB JS + 94KB WASM)
 - **0** runtime dependencies
 - **<1ms** per keystroke
 - **100%** client-side
@@ -29,7 +29,7 @@ import { WriteTrack } from 'writetrack';
 const responseField = document.getElementById('response-field')!;
 const tracker = new WriteTrack({
   target: responseField,
-  license: process.env.WRITETRACK_LICENSE_KEY, // omit for dev/demo mode
+  license: process.env.WRITETRACK_LICENSE_KEY, // omit for localhost evaluation
 });
 
 tracker.start();
@@ -56,6 +56,9 @@ import { WriteTrackExtension } from 'writetrack/tiptap';
 import { WriteTrackPlugin } from 'writetrack/ckeditor';
 import { WriteTrackPlugin } from 'writetrack/prosemirror';
 import { WriteTrackModule } from 'writetrack/quill';
+import { createWriteTrackLexical } from 'writetrack/lexical';
+import { createWriteTrackSlate } from 'writetrack/slate';
+import { createWriteTrackTinyMCE } from 'writetrack/tinymce';
 ```
 
 ## Output Sinks
@@ -104,39 +107,41 @@ new WriteTrack(options: WriteTrackOptions | HTMLElement)
 ```typescript
 interface WriteTrackOptions {
   target: HTMLElement;
-  license?: string; // Omit for development/demo mode
+  license?: string; // Omit for localhost evaluation
   userId?: string; // Opaque user identifier, included in output metadata
   contentId?: string; // Opaque document identifier, included in output metadata
   metadata?: Record<string, unknown>; // Arbitrary metadata, included in output
   wasmUrl?: string; // Custom URL for the WASM analysis binary
   persist?: boolean; // Enable IndexedDB persistence (requires contentId)
+  cursorPositionProvider?: () => number; // Custom cursor position for rich-text editors
 }
 ```
 
 ### Methods
 
-| Method                             | Returns                          | Description                            |
-| ---------------------------------- | -------------------------------- | -------------------------------------- |
-| `start()`                          | `void`                           | Begin capturing events                 |
-| `stop()`                           | `void`                           | Stop capturing and clean up            |
-| `getData()`                        | `WriteTrackDataSchema`           | Export full session data               |
-| `getText()`                        | `string`                         | Current text content                   |
-| `getRawEvents()`                   | `KeystrokeEvent[]`               | All captured keystroke events          |
-| `getClipboardEvents()`             | `ClipboardEvent[]`               | Paste/copy/cut events                  |
-| `getSelectionEvents()`             | `SelectionEvent[]`               | Text selection events                  |
-| `getUndoRedoEvents()`              | `UndoRedoEvent[]`                | Undo/redo events                       |
-| `getCompositionEvents()`           | `CompositionEvent[]`             | IME composition events                 |
-| `getProgrammaticInsertionEvents()` | `ProgrammaticInsertionEvent[]`   | Programmatic insertion events          |
-| `getSessionDuration()`             | `number`                         | Session duration in ms                 |
-| `getKeystrokeCount()`              | `number`                         | Total keystrokes captured              |
-| `getAnalysis()`                    | `Promise<SessionAnalysis\|null>` | WASM-powered session analysis          |
-| `getSessionReport()`               | `Promise<SessionReport>`         | Combined data + analysis               |
-| `pipe(sink)`                       | `this`                           | Register an output sink                |
-| `on(event, handler)`               | `this`                           | Register an event listener             |
-| `isLicenseValid()`                 | `boolean`                        | Whether license is valid               |
-| `isLicenseValidated()`             | `boolean`                        | Whether license check has completed    |
-| `isTargetDetached()`               | `boolean`                        | Whether the target element was removed |
-| `clearPersistedData()`             | `Promise<void>`                  | Clear IndexedDB persisted session      |
+| Method                             | Returns                          | Description                                       |
+| ---------------------------------- | -------------------------------- | ------------------------------------------------- |
+| `start()`                          | `void`                           | Begin capturing events                            |
+| `stop()`                           | `void`                           | Stop capturing and clean up                       |
+| `getData()`                        | `WriteTrackDataSchema`           | Export full session data                          |
+| `getText()`                        | `string`                         | Current text content                              |
+| `getRawEvents()`                   | `KeystrokeEvent[]`               | All captured keystroke events                     |
+| `getClipboardEvents()`             | `ClipboardEvent[]`               | Paste/copy/cut events                             |
+| `getSelectionEvents()`             | `SelectionEvent[]`               | Text selection events                             |
+| `getUndoRedoEvents()`              | `UndoRedoEvent[]`                | Undo/redo events                                  |
+| `getCompositionEvents()`           | `CompositionEvent[]`             | IME composition events                            |
+| `getProgrammaticInsertionEvents()` | `ProgrammaticInsertionEvent[]`   | Programmatic insertion events                     |
+| `getSessionDuration()`             | `number`                         | Session duration in ms                            |
+| `getActiveTime()`                  | `number`                         | Active (visible) session time in ms               |
+| `getKeystrokeCount()`              | `number`                         | Total keystrokes captured                         |
+| `getAnalysis()`                    | `Promise<SessionAnalysis\|null>` | WASM-powered session analysis                     |
+| `getSessionReport()`               | `Promise<SessionReport>`         | Combined data + analysis                          |
+| `pipe(sink)`                       | `this`                           | Register an output sink                           |
+| `on(event, handler)`               | `this`                           | Register an event listener (`tick`, `pipe:error`) |
+| `isLicenseValid()`                 | `boolean`                        | Whether license is valid                          |
+| `isLicenseValidated()`             | `boolean`                        | Whether license check has completed               |
+| `isTargetDetached()`               | `boolean`                        | Whether the target element was removed            |
+| `clearPersistedData()`             | `Promise<void>`                  | Clear IndexedDB persisted session                 |
 
 ### Properties
 
@@ -162,7 +167,7 @@ const analysis = await analyzeEvents(data, {
 
 Full type definitions are included in the package:
 
-**Functions:** `analyzeEvents`, `formatIndicator`, `getHighResolutionTime`
+**Functions:** `analyzeEvents`, `createSessionReport`, `formatIndicator`, `getHighResolutionTime`
 
 **Types:** `KeystrokeEvent`, `ClipboardEvent`, `SelectionEvent`, `UndoRedoEvent`, `CompositionEvent`, `ProgrammaticInsertionEvent`, `ModifierState`, `WriteTrackDataSchema`, `DataQualityMetrics`, `SessionMetadata`, `SessionAnalysis`, `SessionReport`, `IndicatorOutput`, `AnalyzeEventsOptions`, `WriteTrackSink`