@readium/navigator-html-injectables 2.2.5 → 2.3.1-alpha.1

package/types/src/modules/snapper/WebPubSnapper.d.ts

@@ -2,11 +2,16 @@ import { Comms } from "../../comms/comms";
 import { ReadiumWindow } from "../../helpers/dom";
 import { ModuleName } from "../ModuleLibrary";
 import { Snapper } from "./Snapper";
+import { SuspiciousScrollingEvent } from "./ScrollSnapper";
+export type { SuspiciousScrollingEvent };
 export declare class WebPubSnapper extends Snapper {
     static readonly moduleName: ModuleName;
     private wnd;
     private comms;
     private resizeObserver;
+    private patternAnalyzer;
+    private lastScrollTime;
+    private isScrollProtectionEnabled;
     private initialScrollHandled;
     private isScrolling;
     private lastScrollTop;
@@ -15,6 +20,7 @@ export declare class WebPubSnapper extends Snapper {
     private doc;
     private reportProgress;
     private handleScroll;
+    private enableScrollProtection;
     mount(wnd: ReadiumWindow, comms: Comms): boolean;
     unmount(wnd: ReadiumWindow, comms: Comms): boolean;
 }

package/types/src/protection/BulkCopyProtector.d.ts

@@ -0,0 +1,20 @@
+import { ReadiumWindow } from "../helpers/dom";
+export interface BulkCopyProtectionOptions {
+    enabled: boolean;
+    maxSelectionPercent: number;
+    absoluteMaxChars: number;
+    minThreshold: number;
+    historySize: number;
+}
+export declare class BulkCopyProtector {
+    private readonly window;
+    private options;
+    private copyHistory;
+    private lastSelectionLength;
+    private lastSelectionTime;
+    constructor(window: ReadiumWindow, options: BulkCopyProtectionOptions);
+    private cleanupOldHistory;
+    private isSuspiciousPattern;
+    shouldAllowCopy(event: ClipboardEvent): boolean;
+    destroy(): void;
+}

package/types/src/protection/KeyCombinationManager.d.ts

@@ -0,0 +1,33 @@
+import { KeyCombo, KeyboardPeripheral } from "./KeyboardCombinations";
+import { BaseKeyboardPeripheralEvent, KeyboardEventData } from "../modules/Peripherals";
+import { ReadiumWindow } from "../helpers/dom";
+export type KeyHandler = (event: KeyboardEvent) => void;
+export type ActivityEventDispatcher = (event: KeyboardPeripheralEvent) => void;
+export interface KeyboardPeripheralEvent extends BaseKeyboardPeripheralEvent, KeyboardEventData {
+    type: string;
+}
+export interface KeyComboWithHandler extends KeyCombo {
+    handler?: (event: KeyboardEvent) => void;
+}
+export declare class KeyCombinationManager {
+    /**
+     * Checks if the given keyboard event matches any of the provided key combinations
+     */
+    match(event: KeyboardEvent, combos: KeyCombo[]): boolean;
+    /**
+     * Creates an event handler that will call the provided handler when any of the key combinations match
+     */
+    createKeyHandler(combos: KeyCombo[], handler: KeyHandler): (event: KeyboardEvent) => void;
+    /**
+     * Creates a standardized activity event for keyboard shortcuts
+     */
+    private createActivityEvent;
+    /**
+     * Creates handlers for keyboard shortcuts with centralized activity event dispatch
+     */
+    createKeyboardHandlers(targetFrameSrc: string, shortcuts: KeyboardPeripheral[], dispatcher: ActivityEventDispatcher, wnd?: ReadiumWindow): KeyComboWithHandler[];
+    /**
+     * Creates a unified keyboard event handler that processes all shortcuts
+     */
+    createUnifiedHandler(targetFrameSrc: string, shortcuts: KeyboardPeripheral[], dispatcher: ActivityEventDispatcher, wnd?: ReadiumWindow): (event: KeyboardEvent) => void;
+}

package/types/src/protection/KeyboardCombinations.d.ts

@@ -0,0 +1,15 @@
+export interface KeyCombo {
+    keyCode: number;
+    ctrl?: boolean;
+    shift?: boolean;
+    alt?: boolean;
+    meta?: boolean;
+}
+export interface KeyboardPeripheral {
+    type: string;
+    keyCombos: KeyCombo[];
+}
+export declare const DEV_TOOLS: KeyboardPeripheral;
+export declare const SELECT_ALL: KeyboardPeripheral;
+export declare const PRINT: KeyboardPeripheral;
+export declare const SAVE: KeyboardPeripheral;

package/types/src/protection/PatternAnalyzer.d.ts

@@ -0,0 +1,18 @@
+type Direction = "left" | "right" | "up" | "down";
+export interface PatternAnalyzerOptions {
+    maxVelocity: number;
+    minVariance: number;
+    historySize?: number;
+    minDirectionChanges?: number;
+    maxConsistentScrolls?: number;
+}
+export declare class PatternAnalyzer {
+    private options;
+    private history;
+    private consistentScrollCount;
+    constructor(options?: Partial<PatternAnalyzerOptions>);
+    analyze(direction: Direction, distance: number, timeDelta: number): boolean;
+    private resetAfterDetection;
+    clear(): void;
+}
+export {};

package/types/src/protection/PrintProtector.d.ts

@@ -0,0 +1,20 @@
+import { Comms } from "../comms";
+import { ReadiumWindow } from "../helpers/dom";
+import { Module } from "../modules/Module";
+import { ModuleName } from "../modules/ModuleLibrary";
+export interface PrintProtectionConfig {
+    disable?: boolean;
+    watermark?: string;
+}
+export declare class PrintProtector extends Module {
+    static readonly moduleName: ModuleName;
+    private comms;
+    private wnd;
+    private styleElement;
+    private beforePrintHandler;
+    private configApplied;
+    private setupPrintProtection;
+    private registerPrintHandlers;
+    mount(wnd: ReadiumWindow, comms: Comms): boolean;
+    unmount(wnd: ReadiumWindow, _comms: Comms): boolean;
+}

package/types/src/protection/SelectionAnalyzer.d.ts

@@ -0,0 +1,20 @@
+export interface SelectionAnalyzerOptions {
+    maxSelectionsPerSecond: number;
+    minVariance: number;
+    historySize: number;
+}
+export declare class SelectionAnalyzer {
+    private readonly options;
+    private events;
+    private selectionStartTime;
+    private lastSelectionTime;
+    private lastSelectionPosition;
+    private selectionPatterns;
+    private lastSelectedText;
+    constructor(options?: SelectionAnalyzerOptions);
+    analyze(selection: Selection | null): boolean;
+    private analyzeSelectionPattern;
+    private calculateVariance;
+    private cleanup;
+    clear(): void;
+}

package/types/src/protection/config.d.ts

@@ -0,0 +1,7 @@
+import { BulkCopyProtectionOptions } from "./BulkCopyProtector";
+import { PatternAnalyzerOptions } from "./PatternAnalyzer";
+import { SelectionAnalyzerOptions } from "./SelectionAnalyzer";
+export declare const DEFAULT_PATTERN_ANALYZER_CONFIG: PatternAnalyzerOptions;
+export declare const SCROLL_PROTECTION_CONFIG: PatternAnalyzerOptions;
+export declare const SELECTION_ANALYZER_CONFIG: SelectionAnalyzerOptions;
+export declare const BULK_COPY_CONFIG: BulkCopyProtectionOptions;

package/types/src/protection/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./BulkCopyProtector";
+export * from "./KeyCombinationManager";
+export * from "./KeyboardCombinations";
+export * from "./PatternAnalyzer";
+export * from "./SelectionAnalyzer";
+export * from "./PrintProtector";

package/src/types/protection.ts

@@ -1,16 +0,0 @@
-type SuspiciousActivityType = 
-    | "developer_tools_attempt"
-    | "select_all_attempt"
-    | "suspicious_selection"
-    | "suspicious_copy"
-    | "suspicious_scrolling"
-    | "suspicious_snapping"
-    | "drag_detected"
-    | "drop_detected"
-    | "context_menu";
-
-export interface SuspiciousActivityEvent {
-    timestamp: number;
-    type: SuspiciousActivityType;
-    event?: Event;
-}

package/types/src/types/protection.d.ts

@@ -1,7 +0,0 @@
-type SuspiciousActivityType = "developer_tools_attempt" | "select_all_attempt" | "suspicious_selection" | "suspicious_copy" | "suspicious_scrolling" | "suspicious_snapping" | "drag_detected" | "drop_detected" | "context_menu";
-export interface SuspiciousActivityEvent {
-    timestamp: number;
-    type: SuspiciousActivityType;
-    event?: Event;
-}
-export {};