writetrack 0.8.0 → 0.9.1

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.
 
-- **~115KB** gzipped (17KB JS + 94KB WASM)
+- **~118KB** gzipped (18KB JS + 100KB 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();
@@ -107,40 +107,49 @@ 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
+  inputSourceProvider?: () => InputSource | undefined; // Input source classification (set by editor integrations)
 }
 ```
 
 ### 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                 |
+
+### Static Methods
+
+| Method                                           | Returns                           | Description                              |
+| ------------------------------------------------ | --------------------------------- | ---------------------------------------- |
+| `WriteTrack.listPersistedSessions()`             | `Promise<PersistedSessionInfo[]>` | List all persisted sessions in IndexedDB |
+| `WriteTrack.deletePersistedSession(key, field?)` | `Promise<void>`                   | Delete persisted session data            |
 
 ### Properties
 
@@ -168,7 +177,7 @@ Full type definitions are included in the package:
 
 **Functions:** `analyzeEvents`, `createSessionReport`, `formatIndicator`, `getHighResolutionTime`
 
-**Types:** `KeystrokeEvent`, `ClipboardEvent`, `SelectionEvent`, `UndoRedoEvent`, `CompositionEvent`, `ProgrammaticInsertionEvent`, `ModifierState`, `WriteTrackDataSchema`, `DataQualityMetrics`, `SessionMetadata`, `SessionAnalysis`, `SessionReport`, `IndicatorOutput`, `AnalyzeEventsOptions`, `WriteTrackSink`
+**Types:** `WriteTrackOptions`, `PersistedSessionInfo`, `KeystrokeEvent`, `ClipboardEvent`, `SelectionEvent`, `UndoRedoEvent`, `CompositionEvent`, `ProgrammaticInsertionEvent`, `ModifierState`, `InputSource`, `WriteTrackDataSchema`, `DataQualityMetrics`, `SessionMetadata`, `SessionAnalysis`, `SessionReport`, `IndicatorOutput`, `ContentOriginAnalysis`, `TimingAuthenticityAnalysis`, `SessionContinuityAnalysis`, `PhysicalPlausibilityAnalysis`, `RevisionBehaviorAnalysis`, `TemporalPatternsAnalysis`, `AnalyzeEventsOptions`, `WriteTrackSink`, `WebhookOptions`, `DatadogOptions`, `DatadogClient`, `SegmentOptions`, `SegmentClient`, `OpenTelemetryOptions`, `OTelTracer`, `OTelSpan`
 
 ## Browser Support