@purespectrum1/purescore-client 0.7.0

package/lib/domain/models/crosscutting/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./device-intelligence"), exports);

package/lib/domain/protocols/cache/get-storage.d.ts

@@ -0,0 +1,8 @@
+export interface GetStorage {
+    /**
+     * Reads the value stored under `key`, or null when there is nothing usable
+     * there. An unreadable entry is indistinguishable from an absent one: both
+     * mean "nothing to resume from".
+     */
+    get: (key: string) => any;
+}

package/lib/domain/protocols/cache/get-storage.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/domain/protocols/cache/index.d.ts

@@ -0,0 +1,3 @@
+export * from './get-storage';
+export * from './set-storage';
+export * from './remove-storage';

package/lib/domain/protocols/cache/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./get-storage"), exports);
+__exportStar(require("./set-storage"), exports);
+__exportStar(require("./remove-storage"), exports);

package/lib/domain/protocols/cache/remove-storage.d.ts

@@ -0,0 +1,6 @@
+export interface RemoveStorage {
+    /**
+     * Drops the entry stored under `key`. Removing an absent key is a no-op.
+     */
+    remove: (key: string) => void;
+}

package/lib/domain/protocols/cache/remove-storage.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/domain/protocols/cache/set-storage.d.ts

@@ -0,0 +1,7 @@
+export interface SetStorage {
+    /**
+     * Stores `value` under `key`. Silently does nothing when the storage is
+     * unavailable — persistence is best-effort by nature.
+     */
+    set: (key: string, value: object) => void;
+}

package/lib/domain/protocols/cache/set-storage.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/domain/protocols/http/http-client.d.ts

@@ -0,0 +1,23 @@
+export type HttpRequest = {
+    url: string;
+    method: HttpMethod;
+    body?: any;
+    headers?: any;
+};
+export interface HttpClient<R = any> {
+    request: (data: HttpRequest) => Promise<HttpResponse<R>>;
+}
+export type HttpMethod = 'post' | 'get' | 'patch' | 'delete' | 'put';
+export declare enum HttpStatusCode {
+    ok = 200,
+    noContent = 204,
+    badRequest = 400,
+    unauthorized = 401,
+    forbidden = 403,
+    notFound = 404,
+    serverError = 500
+}
+export type HttpResponse<T = any> = {
+    statusCode: HttpStatusCode;
+    body?: T;
+};

package/lib/domain/protocols/http/http-client.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpStatusCode = void 0;
+var HttpStatusCode;
+(function (HttpStatusCode) {
+    HttpStatusCode[HttpStatusCode["ok"] = 200] = "ok";
+    HttpStatusCode[HttpStatusCode["noContent"] = 204] = "noContent";
+    HttpStatusCode[HttpStatusCode["badRequest"] = 400] = "badRequest";
+    HttpStatusCode[HttpStatusCode["unauthorized"] = 401] = "unauthorized";
+    HttpStatusCode[HttpStatusCode["forbidden"] = 403] = "forbidden";
+    HttpStatusCode[HttpStatusCode["notFound"] = 404] = "notFound";
+    HttpStatusCode[HttpStatusCode["serverError"] = 500] = "serverError";
+})(HttpStatusCode || (exports.HttpStatusCode = HttpStatusCode = {}));

package/lib/domain/protocols/services/behavioural-biometrics/cursor-behavior.d.ts

@@ -0,0 +1,63 @@
+export interface MousePoint {
+    x: number;
+    y: number;
+    timestamp: number;
+}
+export interface MouseVelocity {
+    vx: number;
+    vy: number;
+    speed: number;
+}
+export interface MouseAcceleration {
+    ax: number;
+    ay: number;
+    magnitude: number;
+}
+export interface MouseTrajectory {
+    angle: number;
+    curvature: number;
+    straightness: number;
+    jerkiness: number;
+}
+export interface ScrollEvent {
+    deltaX: number;
+    deltaY: number;
+    timestamp: number;
+    velocity: number;
+    type: 'wheel' | 'drag';
+}
+interface MovementMetrics {
+    averageSpeed: number | null;
+    maxSpeed: number | null;
+    minSpeed: number | null;
+    speedStdDev: number | null;
+}
+interface AccelerationMetrics {
+    averageAcceleration: number | null;
+    maxAcceleration: number | null;
+    decelerationCount: number;
+    accelerationCount: number;
+}
+interface TrajectoryMetrics {
+    averageCurvature: number | null;
+    straightLinePercentage: number | null;
+    averageJerkiness: number | null;
+    angleChanges: number;
+}
+interface ScrollMetrics {
+    totalScrollDistance: number;
+    averageScrollVelocity: number | null;
+    wheelScrollCount: number;
+    dragScrollCount: number;
+}
+interface SessionInfo {
+    totalMovements: number;
+}
+export interface CursorBehaviorMetrics {
+    movementMetrics: MovementMetrics;
+    accelerationMetrics: AccelerationMetrics;
+    trajectoryMetrics: TrajectoryMetrics;
+    scrollMetrics: ScrollMetrics;
+    sessionInfo: SessionInfo;
+}
+export {};

package/lib/domain/protocols/services/behavioural-biometrics/cursor-behavior.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/domain/protocols/services/behavioural-biometrics/index.d.ts

@@ -0,0 +1,3 @@
+export * from './cursor-behavior';
+export * from './keystorke-metrics';
+export * from './touch-behavior';

package/lib/domain/protocols/services/behavioural-biometrics/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./cursor-behavior"), exports);
+__exportStar(require("./keystorke-metrics"), exports);
+__exportStar(require("./touch-behavior"), exports);

package/lib/domain/protocols/services/behavioural-biometrics/keystorke-metrics.d.ts

@@ -0,0 +1,35 @@
+export interface KeyLog {
+    key: string;
+    pressTime: number;
+    releaseTime: number;
+    duration: number;
+}
+export interface DwellTime {
+    key: string;
+    averageDuration: number;
+    duration: number;
+    count: number;
+}
+export interface FlightTime {
+    fromKey: string;
+    toKey: string;
+    averageDuration: number;
+    duration: number;
+    count: number;
+}
+export interface KeyboardMetric {
+    dwellTimes: DwellTime[];
+    flightTimes: FlightTime[];
+    statistics: {
+        backspaceCount: number;
+        shiftKeyUsage: number;
+        deleteKeyCount: number;
+    };
+    errors: {
+        totalErrors: number;
+        quickCorrections: number;
+        errorRate: number | null;
+        correctionRate: number | null;
+    };
+    typingSpeed: number | null;
+}

package/lib/domain/protocols/services/behavioural-biometrics/keystorke-metrics.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/domain/protocols/services/behavioural-biometrics/touch-behavior.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Interface for touch pressure data
+ */
+export interface TouchPressureData {
+    /** Average pressure across all recorded touches (0.0 to 1.0). `null` when no pressure events were captured. */
+    averagePressure: number | null;
+    /** Maximum pressure recorded. `null` when no pressure events were captured. */
+    maxPressure: number | null;
+    /** Minimum pressure recorded. `null` when no pressure events were captured. */
+    minPressure: number | null;
+    /** Standard deviation of pressure values (indicates variability). `null` when no pressure events were captured. */
+    pressureVariability: number | null;
+}
+/**
+ * Interface for a single swipe gesture
+ */
+export interface SwipeGesture {
+    /** Speed of the swipe in pixels per millisecond */
+    speed: number;
+    /** Angle of the swipe in degrees (0-360) */
+    angle: number;
+    /** Length of the swipe in pixels */
+    length: number;
+    /** Duration of the swipe in milliseconds */
+    duration: number;
+    /** Timestamp when swipe started */
+    timestamp: number;
+}
+/** Cardinal direction of a swipe */
+export type SwipeDirection = 'up' | 'down' | 'left' | 'right';
+/**
+ * Interface for a single swipe movement with coordinates and direction
+ */
+export interface SwipeMovement {
+    /** Direction of the swipe */
+    direction: SwipeDirection;
+    /** Start coordinates [x, y] */
+    start: [number, number];
+    /** End coordinates [x, y] */
+    end: [number, number];
+}
+/**
+ * Interface for aggregated swipe metrics
+ */
+export interface SwipeMetrics {
+    /** Average speed across all swipes. `null` when no swipes were captured. */
+    averageSpeed: number | null;
+    /** Average angle across all swipes. `null` when no swipes were captured. */
+    averageAngle: number | null;
+    /** Average length across all swipes. `null` when no swipes were captured. */
+    averageLength: number | null;
+    /** Average duration across all swipes. `null` when no swipes were captured. */
+    averageDuration: number | null;
+    /** Speed consistency (lower = more consistent). `null` when no swipes were captured. */
+    speedVariability: number | null;
+    /** Angle consistency (lower = more consistent). `null` when no swipes were captured. */
+    angleVariability: number | null;
+    /** Number of swipe gestures recorded (always a real count — 0 means "no swipes"). */
+    swipeCount: number;
+    /** Individual swipe movements with direction and coordinates */
+    swipes: SwipeMovement[];
+}
+/**
+ * Interface for finger size/contact area data
+ */
+export interface FingerSizeData {
+    /** Average touch radius in pixels. `null` when no touch-size events were captured. */
+    averageTouchRadius: number | null;
+    /** Maximum touch radius recorded. `null` when no touch-size events were captured. */
+    maxTouchRadius: number | null;
+    /** Minimum touch radius recorded. `null` when no touch-size events were captured. */
+    minTouchRadius: number | null;
+    /** Variability in touch size. `null` when no touch-size events were captured. */
+    sizeVariability: number | null;
+    /** Average touch area (radiusX * radiusY). `null` when no touch-size events were captured. */
+    averageTouchArea: number | null;
+}
+/**
+ * Complete touch behavioral biometrics
+ */
+export interface TouchBehaviorBiometrics {
+    /** Pressure-related metrics */
+    pressure: TouchPressureData;
+    /** Swipe gesture metrics */
+    swipe: SwipeMetrics;
+    /** Finger size/contact area metrics */
+    fingerSize: FingerSizeData;
+}

package/lib/domain/protocols/services/behavioural-biometrics/touch-behavior.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/domain/protocols/services/device-fingerprint/display.d.ts

@@ -0,0 +1,22 @@
+export interface DisplayChecks {
+    resolution: [number, number];
+    width: number;
+    width1: number;
+    width2: number;
+    height1: number;
+    height2: number;
+    isWider: boolean;
+    isTaller: boolean;
+    aspectRatio: number;
+}
+export interface DisplayChecksInput {
+    colorDepth: number;
+    height: number;
+    width: number;
+    availHeight: number;
+    availWidth: number;
+    innerHeight: number;
+    innerWidth: number;
+    outerHeight: number;
+    outerWidth: number;
+}

package/lib/domain/protocols/services/device-fingerprint/display.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/domain/protocols/services/device-fingerprint/index.d.ts

@@ -0,0 +1,3 @@
+export * from './display';
+export * from './navigator';
+export * from './utils';

package/lib/domain/protocols/services/device-fingerprint/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./display"), exports);
+__exportStar(require("./navigator"), exports);
+__exportStar(require("./utils"), exports);

package/lib/domain/protocols/services/device-fingerprint/navigator.d.ts

@@ -0,0 +1,63 @@
+export interface Language {
+    language: string;
+    systemLanguage: string;
+    userLanguage: string;
+}
+export interface NavigatorUABrandVersion {
+    brand: string;
+    version: string;
+}
+export interface UADataValues {
+    brands?: NavigatorUABrandVersion[];
+    mobile?: boolean;
+    platform?: string;
+    architecture?: string;
+    bitness?: string;
+    model?: string;
+    platformVersion?: string;
+    uaFullVersion?: string;
+    fullVersionList?: NavigatorUABrandVersion[];
+}
+export interface NavigatorUAData {
+    brands: NavigatorUABrandVersion[];
+    mobile: boolean;
+    platform: string;
+    getHighEntropyValues(hints: string[]): Promise<UADataValues>;
+    toJSON(): UADataValues;
+}
+export interface NetworkInformation {
+    rtt?: number;
+}
+declare global {
+    interface Navigator {
+        userAgentData?: NavigatorUAData;
+        connection?: NetworkInformation;
+    }
+}
+export interface UAParserDeviceType {
+    ua: string;
+    browser: {
+        name?: string;
+        version?: string;
+        major?: string;
+    };
+    engine: {
+        name?: string;
+        version?: string;
+    };
+    os: {
+        name?: string;
+        version?: string;
+    };
+    device: {
+        vendor?: string;
+        model?: string;
+        type?: string;
+    };
+    cpu: {
+        architecture?: string;
+    };
+    isMobile: boolean;
+    isTablet: boolean;
+    isDesktop: boolean;
+}

package/lib/domain/protocols/services/device-fingerprint/navigator.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/domain/protocols/services/device-fingerprint/utils.d.ts

@@ -0,0 +1,40 @@
+export interface NavigationTiming {
+    responseEnd: number;
+    fetchStart: number;
+    domainLookupEnd: number;
+    domainLookupStart: number;
+    connectEnd: number;
+    connectStart: number;
+    responseStart: number;
+    requestStart: number;
+    loadEventEnd: number;
+}
+/**
+ * Interface for network timing data.
+ */
+export interface NetworkTimes {
+    /**
+     * Total network time in seconds.
+     */
+    networkTime: number;
+    /**
+     * DNS lookup time in seconds.
+     */
+    dnsLookupTime: number;
+    /**
+     * TCP connection time in seconds.
+     */
+    tcpConnectionTime: number;
+    /**
+     * Server response time in seconds.
+     */
+    serverResponseTime: number;
+    /**
+     * Page download time in seconds.
+     */
+    pageDownloadTime: number;
+    /**
+     * Browser time in seconds.
+     */
+    browserTime: number;
+}

package/lib/domain/protocols/services/device-fingerprint/utils.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/domain/protocols/services/device-identifier.d.ts

@@ -0,0 +1,96 @@
+export interface DeviceIdentifierOptions {
+    /**
+     * Custom hash function.
+     *
+     * If provided, this function will be used to generate the hash instead of the default murmurhash3_32_gc.
+     */
+    hasher?: (value: string, seed: number) => number;
+    /**
+     * Whether to include screen resolution in the hash.
+     */
+    screen_resolution?: boolean;
+    /**
+     * Whether to include screen orientation in the hash.
+     */
+    screen_orientation?: boolean;
+    /**
+     * Whether to include canvas fingerprint in the hash.
+     */
+    canvas?: boolean;
+    /**
+     * Set by the `data-auto-init="true"` bootstrap. Sends
+     * `single_script_injection: true` on both Device-Intelligence calls.
+     */
+    singleScriptInjection?: boolean;
+}
+export interface DeviceIdentifierConfig {
+    token?: string;
+    env?: 'staging' | 'production';
+}
+/**
+ * Flushes the collected signals for a transaction to the Device-Intelligence
+ * service and resolves with its response.
+ */
+export interface TrackDetails {
+    trackDetails: (transactionId: string, metadata?: DeviceIdentifierMetadata, config?: DeviceIdentifierConfig, context?: TrackDetailsContext) => Promise<Record<string, any>>;
+}
+/**
+ * What a `trackDetails` call knows about the transaction beyond its id.
+ */
+export interface TrackDetailsContext {
+    surveyId?: string;
+}
+/**
+ * Survey details sent once to `POST /v1/transaction` at transaction start.
+ */
+export interface TransactionDetails {
+    surveyId: string;
+    expectedSurveyLOI: number;
+    surveyCountry: string;
+    surveyLanguage: string;
+    supplierId?: string;
+    supplierMemberId?: string;
+    emailHash?: string;
+    demographics?: {
+        age?: number;
+        gender?: string;
+        zip?: string;
+    };
+}
+/**
+ * Registers a transaction with the Device-Intelligence service.
+ */
+export interface CreateTransaction {
+    createTransaction: (details: TransactionDetails, config?: DeviceIdentifierConfig) => Promise<string | undefined>;
+}
+export interface DeviceIdentifierMetadata {
+    [key: string]: any;
+}
+export interface BehaviorBiometricsParams {
+    survey_id?: string;
+    qualification_id?: string;
+    qualification_type?: string;
+    PSID?: string;
+}
+export interface BehaviouralBiometricsOptions {
+    /**
+     * Maximum number of data points to retain in memory during cursor tracking.
+     * @default 500
+     */
+    cursorMaxDataPoints?: number;
+    /**
+     * Maximum number of data points to retain in memory during keystroke tracking.
+     * @default 1000
+     */
+    keystrokeMaxDataPoints?: number;
+    /**
+     * Minimum swipe length in pixels to be considered a valid swipe gesture.
+     * @default 15
+     */
+    minSwipeLength?: number;
+    /**
+     * Maximum swipe duration in milliseconds to be considered a valid swipe gesture.
+     * @default 2000
+     */
+    maxSwipeDuration?: number;
+}

package/lib/domain/protocols/services/device-identifier.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/domain/protocols/services/device-intelligence.d.ts

@@ -0,0 +1,5 @@
+import { DeviceIdentifierConfig } from "./device-identifier";
+import { HttpMethod } from "../http/http-client";
+export interface DeviceIntelligenceHTTPRequest {
+    performRequest: (path: string, method: HttpMethod, config: DeviceIdentifierConfig | undefined, data?: any) => Promise<any>;
+}

package/lib/domain/protocols/services/device-intelligence.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/domain/protocols/services/listeners.d.ts

@@ -0,0 +1,9 @@
+export interface StartDetection<TArgs extends unknown[] = []> {
+    startDetection(...args: TArgs): void;
+}
+export interface StopDetection<TArgs extends unknown[] = []> {
+    stopDetection(...args: TArgs): void;
+}
+export interface ResetData<TArgs extends unknown[] = []> {
+    resetData(...args: TArgs): void;
+}

package/lib/domain/protocols/services/listeners.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });