@mack1ch/fingerprint-js 0.1.3 → 0.2.0

package/dist/vnext/contracts.d.ts

@@ -0,0 +1,36 @@
+import type { CalibrationKind, ThresholdPolicy, VersionSet } from "./types.js";
+export interface VersionedEnvelope {
+    collectorVersion: string;
+    featureSchemaVersion: string;
+    modelVersion: string;
+    calibrationVersion: string;
+    thresholdPolicyVersion: string;
+}
+export interface ModelArtifact {
+    artifactType: "model";
+    modelKind: "logreg_baseline" | "gbdt_production";
+    modelVersion: string;
+    featureSchemaVersion: string;
+    featureList: string[];
+    payload: Record<string, unknown>;
+}
+export interface CalibrationArtifact {
+    artifactType: "calibration";
+    calibrationKind: CalibrationKind;
+    calibrationVersion: string;
+    expectedModelVersion: string;
+    payload: Record<string, unknown>;
+}
+export interface ThresholdArtifact {
+    artifactType: "threshold_policy";
+    thresholdPolicyVersion: string;
+    expectedModelVersion: string;
+    payload: ThresholdPolicy;
+}
+export interface CompatibilityResult {
+    ok: boolean;
+    errors: string[];
+}
+export declare function buildVersionSet(input?: Partial<VersionSet>): VersionSet;
+export declare function validateArtifactCompatibility(versions: VersionedEnvelope, model: ModelArtifact, calibration: CalibrationArtifact, threshold: ThresholdArtifact): CompatibilityResult;
+//# sourceMappingURL=contracts.d.ts.map

package/dist/vnext/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/vnext/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE/E,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,iBAAiB,GAAG,iBAAiB,CAAC;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,aAAa,CAAC;IAC5B,eAAe,EAAE,eAAe,CAAC;IACjC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,kBAAkB,CAAC;IACjC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,OAAO,EAAE,eAAe,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAgB,eAAe,CAAC,KAAK,GAAE,OAAO,CAAC,UAAU,CAAM,GAAG,UAAU,CAQ3E;AAED,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,iBAAiB,EAC3B,KAAK,EAAE,aAAa,EACpB,WAAW,EAAE,mBAAmB,EAChC,SAAS,EAAE,iBAAiB,GAC3B,mBAAmB,CAkCrB"}

package/dist/vnext/dataset.d.ts

@@ -0,0 +1,16 @@
+import type { FingerprintSnapshotVNext, PairwiseTrainingRow } from "./types.js";
+export interface SnapshotWithLabel {
+    snapshotId: string;
+    snapshot: FingerprintSnapshotVNext;
+    deviceId: string;
+    cohort: PairwiseTrainingRow["cohort"];
+}
+export declare function buildPairwiseTrainingDataset(positives: Array<{
+    left: SnapshotWithLabel;
+    right: SnapshotWithLabel;
+}>, negatives: Array<{
+    left: SnapshotWithLabel;
+    right: SnapshotWithLabel;
+    difficulty: "easy" | "medium" | "hard";
+}>): PairwiseTrainingRow[];
+//# sourceMappingURL=dataset.d.ts.map

package/dist/vnext/dataset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataset.d.ts","sourceRoot":"","sources":["../../src/vnext/dataset.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEhF,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,wBAAwB,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;CACvC;AAMD,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,CAAC,EACvE,SAAS,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAA;CAAE,CAAC,GAC9G,mBAAmB,EAAE,CA0CvB"}

package/dist/vnext/features.d.ts

@@ -0,0 +1,3 @@
+import type { FingerprintSnapshotVNext, PairwiseRow } from "./types.js";
+export declare function buildPairwiseFeatures(leftSnapshotId: string, left: FingerprintSnapshotVNext, rightSnapshotId: string, right: FingerprintSnapshotVNext, candidateType: string): PairwiseRow;
+//# sourceMappingURL=features.d.ts.map

package/dist/vnext/features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../../src/vnext/features.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAoCxE,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,wBAAwB,EAC9B,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,wBAAwB,EAC/B,aAAa,EAAE,MAAM,GACpB,WAAW,CA6Gb"}

package/dist/vnext/index.d.ts

@@ -0,0 +1,18 @@
+export type { CalibrationKind, CandidateContext, CandidateItem, CohortMetrics, FingerprintSnapshotVNext, MatchDecision, PairwiseRow, PairwiseTrainingRow, RolloutMode, SnapshotComponentVNext, ThresholdPolicy, VersionSet } from "./types.js";
+export type { CalibrationArtifact, ModelArtifact, ThresholdArtifact, VersionedEnvelope } from "./contracts.js";
+export { retrieveCandidates } from "./retrieval.js";
+export { recallAtK } from "./retrieval.js";
+export { buildPairwiseFeatures } from "./features.js";
+export { LogisticRegressionBaselineModel, GBDTProductionModel } from "./models.js";
+export { ProbabilityCalibrator } from "./calibration.js";
+export { buildPairwiseTrainingDataset } from "./dataset.js";
+export { inferMatchDecisions } from "./inference.js";
+export { cohortMetrics, distributionDrift, quickMetrics } from "./monitoring.js";
+export { buildVersionSet, validateArtifactCompatibility } from "./contracts.js";
+export { loadArtifacts } from "./artifacts.js";
+export { InMemoryVNextLogger, toPairwiseLog, toRetrievalLog } from "./logging.js";
+export { InMemoryVNextStorage } from "./storage.js";
+export { buildLabels } from "./labeling.js";
+export { VNextRuntime } from "./runtime.js";
+export { groupQualityScore, resolveComponentQuality } from "./quality.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/vnext/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vnext/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,wBAAwB,EACxB,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,sBAAsB,EACtB,eAAe,EACf,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,+BAA+B,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAClF,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC"}

package/dist/vnext/inference.d.ts

@@ -0,0 +1,5 @@
+import type { PairwiseModel } from "./models.js";
+import type { CandidateItem, FingerprintSnapshotVNext, MatchDecision, ThresholdPolicy } from "./types.js";
+import type { ProbabilityCalibrator } from "./calibration.js";
+export declare function inferMatchDecisions(currentSnapshotId: string, current: FingerprintSnapshotVNext, candidates: CandidateItem[], model: PairwiseModel, calibrator: ProbabilityCalibrator, thresholds: ThresholdPolicy, calibrationVersion?: string): MatchDecision[];
+//# sourceMappingURL=inference.d.ts.map

package/dist/vnext/inference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inference.d.ts","sourceRoot":"","sources":["../../src/vnext/inference.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,wBAAwB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC1G,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAS9D,wBAAgB,mBAAmB,CACjC,iBAAiB,EAAE,MAAM,EACzB,OAAO,EAAE,wBAAwB,EACjC,UAAU,EAAE,aAAa,EAAE,EAC3B,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,qBAAqB,EACjC,UAAU,EAAE,eAAe,EAC3B,kBAAkB,SAAW,GAC5B,aAAa,EAAE,CA2BjB"}

package/dist/vnext/labeling.d.ts

@@ -0,0 +1,13 @@
+import type { PairwiseTrainingRow } from "./types.js";
+import type { PairwiseLogEvent, SnapshotLogEvent } from "./logging.js";
+export interface LabelAnchor {
+    anchorType: "confirmed_same_device" | "verified_business_link" | "same_entity_verified" | "manual_review_positive" | "manual_review_negative";
+    value: string;
+}
+export interface LabelingInput {
+    snapshots: SnapshotLogEvent[];
+    pairwiseLogs: PairwiseLogEvent[];
+    anchorsBySnapshotId: Record<string, LabelAnchor[]>;
+}
+export declare function buildLabels(input: LabelingInput): PairwiseTrainingRow[];
+//# sourceMappingURL=labeling.d.ts.map

package/dist/vnext/labeling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labeling.d.ts","sourceRoot":"","sources":["../../src/vnext/labeling.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEvE,MAAM,WAAW,WAAW;IAC1B,UAAU,EACN,uBAAuB,GACvB,wBAAwB,GACxB,sBAAsB,GACtB,wBAAwB,GACxB,wBAAwB,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;CACpD;AAoBD,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,mBAAmB,EAAE,CAsCvE"}

package/dist/vnext/logging.d.ts

@@ -0,0 +1,53 @@
+import type { CandidateItem, FingerprintSnapshotVNext, MatchDecision, VersionSet } from "./types.js";
+import type { PairwiseRow } from "./types.js";
+export interface SnapshotLogEvent {
+    snapshotId: string;
+    collectedAt: string;
+    schemaVersion: string;
+    versions: VersionSet;
+    ids: FingerprintSnapshotVNext["ids"];
+    cohortTags: Record<string, string | boolean | null>;
+    componentMetadata: Record<string, unknown>;
+    qualityMetadata: Record<string, unknown>;
+    businessAnchors: Record<string, string | undefined>;
+}
+export interface RetrievalLogEvent {
+    snapshotId: string;
+    retrievalSources: string[];
+    candidates: Array<{
+        candidateSnapshotId: string;
+        candidateRank: number;
+        candidateSource: string;
+        retrievalReason: string;
+    }>;
+}
+export interface PairwiseLogEvent {
+    pairId: string;
+    snapshotId: string;
+    candidateSnapshotId: string;
+    features: Record<string, number>;
+    rawScore: number;
+    calibratedProbability: number;
+    decision: MatchDecision["decision"];
+    reasons: string[];
+    versions: VersionSet;
+}
+export interface VNextLogger {
+    enabled: boolean;
+    logSnapshot(event: SnapshotLogEvent): void;
+    logRetrieval(event: RetrievalLogEvent): void;
+    logPairwise(event: PairwiseLogEvent): void;
+}
+export declare class InMemoryVNextLogger implements VNextLogger {
+    enabled: boolean;
+    readonly snapshotEvents: SnapshotLogEvent[];
+    readonly retrievalEvents: RetrievalLogEvent[];
+    readonly pairwiseEvents: PairwiseLogEvent[];
+    constructor(enabled?: boolean);
+    logSnapshot(event: SnapshotLogEvent): void;
+    logRetrieval(event: RetrievalLogEvent): void;
+    logPairwise(event: PairwiseLogEvent): void;
+}
+export declare function toRetrievalLog(snapshotId: string, candidates: CandidateItem[]): RetrievalLogEvent;
+export declare function toPairwiseLog(pair: PairwiseRow, rawScore: number, calibratedProbability: number, decision: MatchDecision, versions: VersionSet): PairwiseLogEvent;
+//# sourceMappingURL=logging.d.ts.map

package/dist/vnext/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/vnext/logging.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,wBAAwB,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACrG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,UAAU,CAAC;IACrB,GAAG,EAAE,wBAAwB,CAAC,KAAK,CAAC,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;IACpD,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,EAAE,KAAK,CAAC;QAChB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,aAAa,EAAE,MAAM,CAAC;QACtB,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACpC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,UAAU,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC3C,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC7C,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAC5C;AAED,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,cAAc,EAAE,gBAAgB,EAAE,CAAM;IACjD,QAAQ,CAAC,eAAe,EAAE,iBAAiB,EAAE,CAAM;IACnD,QAAQ,CAAC,cAAc,EAAE,gBAAgB,EAAE,CAAM;gBAErC,OAAO,UAAO;IAI1B,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAK1C,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAK5C,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;CAI3C;AAED,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,GAAG,iBAAiB,CAWjG;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,MAAM,EAChB,qBAAqB,EAAE,MAAM,EAC7B,QAAQ,EAAE,aAAa,EACvB,QAAQ,EAAE,UAAU,GACnB,gBAAgB,CAYlB"}

package/dist/vnext/models.d.ts

@@ -0,0 +1,44 @@
+import type { ModelKind } from "./types.js";
+export interface PairwiseModel {
+    kind: ModelKind;
+    modelVersion: string;
+    train(rows: Array<{
+        features: Record<string, number>;
+        label: 0 | 1;
+    }>): void;
+    score(features: Record<string, number>): number;
+    explain(features: Record<string, number>): {
+        positive: string[];
+        negative: string[];
+    };
+}
+export declare class LogisticRegressionBaselineModel implements PairwiseModel {
+    kind: ModelKind;
+    modelVersion: string;
+    private weights;
+    private bias;
+    train(rows: Array<{
+        features: Record<string, number>;
+        label: 0 | 1;
+    }>): void;
+    score(features: Record<string, number>): number;
+    explain(features: Record<string, number>): {
+        positive: string[];
+        negative: string[];
+    };
+}
+export declare class GBDTProductionModel implements PairwiseModel {
+    kind: ModelKind;
+    modelVersion: string;
+    private importance;
+    train(rows: Array<{
+        features: Record<string, number>;
+        label: 0 | 1;
+    }>): void;
+    score(features: Record<string, number>): number;
+    explain(features: Record<string, number>): {
+        positive: string[];
+        negative: string[];
+    };
+}
+//# sourceMappingURL=models.d.ts.map

package/dist/vnext/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/vnext/models.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAA;KAAE,CAAC,GAAG,IAAI,CAAC;IAC7E,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC;IAChD,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CACvF;AAMD,qBAAa,+BAAgC,YAAW,aAAa;IACnE,IAAI,EAAE,SAAS,CAAqB;IACpC,YAAY,SAAe;IAC3B,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,IAAI,CAAK;IAEjB,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAA;KAAE,CAAC,GAAG,IAAI;IAuB5E,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM;IAQ/C,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE;CAmBtF;AAED,qBAAa,mBAAoB,YAAW,aAAa;IACvD,IAAI,EAAE,SAAS,CAAqB;IACpC,YAAY,SAAa;IACzB,OAAO,CAAC,UAAU,CAA6B;IAE/C,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAA;KAAE,CAAC,GAAG,IAAI;IAY5E,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM;IAgB/C,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE;CAmBtF"}

package/dist/vnext/monitoring.d.ts

@@ -0,0 +1,10 @@
+import type { CohortMetrics, PairwiseTrainingRow } from "./types.js";
+export declare function quickMetrics(rows: PairwiseTrainingRow[], probabilities: number[]): {
+    prAuc: number;
+    rocAuc: number;
+    logLoss: number;
+    brier: number;
+};
+export declare function cohortMetrics(rows: PairwiseTrainingRow[], probabilities: number[], cohortKey: keyof PairwiseTrainingRow["cohort"]): CohortMetrics[];
+export declare function distributionDrift(reference: number[], current: number[]): number;
+//# sourceMappingURL=monitoring.d.ts.map

package/dist/vnext/monitoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitoring.d.ts","sourceRoot":"","sources":["../../src/vnext/monitoring.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAMrE,wBAAgB,YAAY,CAC1B,IAAI,EAAE,mBAAmB,EAAE,EAC3B,aAAa,EAAE,MAAM,EAAE,GACtB;IACD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf,CAgCA;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,mBAAmB,EAAE,EAC3B,aAAa,EAAE,MAAM,EAAE,EACvB,SAAS,EAAE,MAAM,mBAAmB,CAAC,QAAQ,CAAC,GAC7C,aAAa,EAAE,CAgBjB;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAoBhF"}

package/dist/vnext/quality.d.ts

@@ -0,0 +1,9 @@
+import type { FingerprintSnapshotVNext } from "./types.js";
+export type ComponentQualityStatus = "present" | "missing" | "unstable" | "privacy_reduced" | "collector_error";
+export interface ComponentQuality {
+    status: ComponentQualityStatus;
+    qualityScore: number;
+}
+export declare function resolveComponentQuality(snapshot: FingerprintSnapshotVNext): Record<string, ComponentQuality>;
+export declare function groupQualityScore(snapshot: FingerprintSnapshotVNext): number;
+//# sourceMappingURL=quality.d.ts.map

package/dist/vnext/quality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality.d.ts","sourceRoot":"","sources":["../../src/vnext/quality.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE3D,MAAM,MAAM,sBAAsB,GAC9B,SAAS,GACT,SAAS,GACT,UAAU,GACV,iBAAiB,GACjB,iBAAiB,CAAC;AAEtB,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,sBAAsB,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;CACtB;AAkBD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,wBAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAc5G;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,wBAAwB,GAAG,MAAM,CAK5E"}

package/dist/vnext/retrieval.d.ts

@@ -0,0 +1,32 @@
+import type { CandidateContext, CandidateItem, FingerprintSnapshotVNext } from "./types.js";
+export interface CandidateRetrievalStore {
+    getAllSnapshots(): Array<{
+        snapshotId: string;
+        snapshot: FingerprintSnapshotVNext;
+    }>;
+    getByStableId(stableId: string): Array<{
+        snapshotId: string;
+        snapshot: FingerprintSnapshotVNext;
+    }>;
+    getByEnvironmentId(environmentId: string): Array<{
+        snapshotId: string;
+        snapshot: FingerprintSnapshotVNext;
+    }>;
+    getByBucket(bucket: string): Array<{
+        snapshotId: string;
+        snapshot: FingerprintSnapshotVNext;
+    }>;
+    getByContext(context: CandidateContext): Array<{
+        snapshotId: string;
+        snapshot: FingerprintSnapshotVNext;
+    }>;
+}
+export interface CandidateRetrievalConfig {
+    maxCandidates: number;
+    includeEnvironmentId: boolean;
+    includeBucketRetrieval: boolean;
+    includeContextRetrieval: boolean;
+}
+export declare function retrieveCandidates(current: FingerprintSnapshotVNext, store: CandidateRetrievalStore, context: CandidateContext, config: CandidateRetrievalConfig): CandidateItem[];
+export declare function recallAtK(retrievedCandidateIds: string[], trueMatchIds: string[], k: number): number;
+//# sourceMappingURL=retrieval.d.ts.map

package/dist/vnext/retrieval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieval.d.ts","sourceRoot":"","sources":["../../src/vnext/retrieval.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE5F,MAAM,WAAW,uBAAuB;IACtC,eAAe,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,wBAAwB,CAAA;KAAE,CAAC,CAAC;IACrF,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,wBAAwB,CAAA;KAAE,CAAC,CAAC;IACnG,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,wBAAwB,CAAA;KAAE,CAAC,CAAC;IAC7G,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,wBAAwB,CAAA;KAAE,CAAC,CAAC;IAC/F,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,wBAAwB,CAAA;KAAE,CAAC,CAAC;CAC5G;AAED,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,sBAAsB,EAAE,OAAO,CAAC;IAChC,uBAAuB,EAAE,OAAO,CAAC;CAClC;AAgDD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,wBAAwB,EACjC,KAAK,EAAE,uBAAuB,EAC9B,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,wBAAwB,GAC/B,aAAa,EAAE,CAmCjB;AAED,wBAAgB,SAAS,CAAC,qBAAqB,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAKpG"}

package/dist/vnext/runtime.d.ts

@@ -0,0 +1,44 @@
+import { type CalibrationArtifact, type ModelArtifact, type ThresholdArtifact } from "./contracts.js";
+import { type VNextLogger } from "./logging.js";
+import type { CandidateContext, FingerprintSnapshotVNext, MatchDecision, RolloutMode, VersionSet } from "./types.js";
+import { type CandidateRetrievalConfig, type CandidateRetrievalStore } from "./retrieval.js";
+import type { InMemoryVNextStorage } from "./storage.js";
+export interface RuntimeConfig {
+    rolloutMode: RolloutMode;
+    versions: VersionSet;
+    retrievalConfig: CandidateRetrievalConfig;
+    logger?: VNextLogger;
+}
+export interface RuntimeContext {
+    candidateContext: CandidateContext;
+    cohortTags: Record<string, string | boolean | null>;
+    businessAnchors: Record<string, string | undefined>;
+}
+export interface RuntimeResult {
+    mode: RolloutMode;
+    decisions: MatchDecision[];
+    compareDiff?: {
+        previousDecision: string;
+        newDecision: string;
+    };
+}
+export declare class VNextRuntime {
+    private readonly config;
+    private readonly store;
+    private readonly logger;
+    private readonly retrievalStore;
+    private readonly modelArtifact;
+    private readonly calibrationArtifact;
+    private readonly thresholdArtifact;
+    constructor(args: {
+        config: RuntimeConfig;
+        storage: InMemoryVNextStorage;
+        retrievalStore: CandidateRetrievalStore;
+        modelArtifact: ModelArtifact;
+        calibrationArtifact: CalibrationArtifact;
+        thresholdArtifact: ThresholdArtifact;
+    });
+    processSnapshot(snapshotId: string, snapshot: FingerprintSnapshotVNext, context: RuntimeContext): RuntimeResult;
+    private scoreDeterministic;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/vnext/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/vnext/runtime.ts"],"names":[],"mappings":"AACA,OAAO,EAAiC,KAAK,mBAAmB,EAAE,KAAK,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAErI,OAAO,EAAsD,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AACpG,OAAO,KAAK,EAAE,gBAAgB,EAAiB,wBAAwB,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACpI,OAAO,EAAsB,KAAK,wBAAwB,EAAE,KAAK,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACjH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGzD,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,WAAW,CAAC;IACzB,QAAQ,EAAE,UAAU,CAAC;IACrB,eAAe,EAAE,wBAAwB,CAAC;IAC1C,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;IACpD,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,WAAW,CAAC,EAAE;QACZ,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA0B;IACzD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAsB;IAC1D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoB;gBAE1C,IAAI,EAAE;QAChB,MAAM,EAAE,aAAa,CAAC;QACtB,OAAO,EAAE,oBAAoB,CAAC;QAC9B,cAAc,EAAE,uBAAuB,CAAC;QACxC,aAAa,EAAE,aAAa,CAAC;QAC7B,mBAAmB,EAAE,mBAAmB,CAAC;QACzC,iBAAiB,EAAE,iBAAiB,CAAC;KACtC;IAUD,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,wBAAwB,EAAE,OAAO,EAAE,cAAc,GAAG,aAAa;IAuF/G,OAAO,CAAC,kBAAkB;CA6C3B"}

package/dist/vnext/storage.d.ts

@@ -0,0 +1,49 @@
+import type { CandidateItem, FingerprintSnapshotVNext, MatchDecision, PairwiseRow, VersionSet } from "./types.js";
+export interface SnapshotRecord {
+    snapshotId: string;
+    snapshot: FingerprintSnapshotVNext;
+    versions: VersionSet;
+    cohortTags: Record<string, string | boolean | null>;
+    createdAt: number;
+}
+export interface RetrievalLogRecord {
+    snapshotId: string;
+    createdAt: number;
+    candidates: CandidateItem[];
+    retrievalSources: string[];
+}
+export interface PairwiseLogRecord {
+    pair: PairwiseRow;
+    createdAt: number;
+    rawScore: number;
+    calibratedProbability: number;
+    decision: MatchDecision["decision"];
+    reasons: string[];
+    versions: VersionSet;
+}
+export interface DecisionRecord {
+    snapshotId: string;
+    decision: MatchDecision;
+    createdAt: number;
+}
+export interface DeviceProfileRecord {
+    deviceId: string;
+    snapshots: string[];
+    scoreHistory: number[];
+    stabilityHistory: number[];
+    updatedAt: number;
+}
+export declare class InMemoryVNextStorage {
+    readonly snapshots: Map<string, SnapshotRecord>;
+    readonly retrievalLogs: RetrievalLogRecord[];
+    readonly pairwiseLogs: PairwiseLogRecord[];
+    readonly decisions: DecisionRecord[];
+    readonly deviceProfiles: Map<string, DeviceProfileRecord>;
+    putSnapshot(record: SnapshotRecord): void;
+    getSnapshot(snapshotId: string): SnapshotRecord | undefined;
+    addRetrievalLog(record: RetrievalLogRecord): void;
+    addPairwiseLog(record: PairwiseLogRecord): void;
+    addDecision(record: DecisionRecord): void;
+    upsertDeviceProfile(deviceId: string, snapshotId: string, calibratedProbability: number, stabilityScore: number): void;
+}
+//# sourceMappingURL=storage.d.ts.map

package/dist/vnext/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/vnext/storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,wBAAwB,EACxB,aAAa,EACb,WAAW,EACX,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,wBAAwB,CAAC;IACnC,QAAQ,EAAE,UAAU,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;IACpD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACpC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,UAAU,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,aAAa,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,oBAAoB;IAC/B,QAAQ,CAAC,SAAS,8BAAqC;IACvD,QAAQ,CAAC,aAAa,EAAE,kBAAkB,EAAE,CAAM;IAClD,QAAQ,CAAC,YAAY,EAAE,iBAAiB,EAAE,CAAM;IAChD,QAAQ,CAAC,SAAS,EAAE,cAAc,EAAE,CAAM;IAC1C,QAAQ,CAAC,cAAc,mCAA0C;IAEjE,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAIzC,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI3D,eAAe,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAIjD,cAAc,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAI/C,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAIzC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI;CAiBvH"}

package/dist/vnext/types.d.ts

@@ -0,0 +1,103 @@
+export type ModelKind = "logreg_baseline" | "gbdt_production";
+export type CalibrationKind = "sigmoid" | "isotonic";
+export type RolloutMode = "shadow" | "compare" | "assist" | "enforcement";
+export interface SnapshotComponentVNext {
+    normalizedValue?: unknown;
+    hash?: string;
+    isPresent: boolean;
+    isStable?: boolean;
+    privacyReduced?: boolean;
+    errorCode?: string | null;
+    collectionTimeMs?: number;
+}
+export interface FingerprintSnapshotVNext {
+    schemaVersion: string;
+    sdkVersion: string;
+    collectedAt: string;
+    ids: {
+        fingerprintId: string;
+        stableId?: string;
+        environmentId: string;
+    };
+    meta: {
+        mode: "fast" | "balanced" | "strict";
+        totalCollectionTimeMs: number;
+    };
+    components: Record<string, SnapshotComponentVNext>;
+    topLevelFlags: {
+        webdriver: boolean | null;
+        automationLikely: boolean;
+        incognitoLikely: boolean | null;
+        uaSpoofLikely: boolean;
+        emulatorLikely: boolean;
+    };
+}
+export interface CandidateContext {
+    payerId?: string;
+    instrumentId?: string;
+    sessionId?: string;
+    accountId?: string;
+}
+export interface CandidateItem {
+    snapshotId: string;
+    snapshot: FingerprintSnapshotVNext;
+    retrievalReason: string;
+}
+export interface PairwiseRow {
+    pairId: string;
+    leftSnapshotId: string;
+    rightSnapshotId: string;
+    features: Record<string, number>;
+    metadata: {
+        candidateType: string;
+    };
+}
+export interface PairwiseTrainingRow {
+    pairId: string;
+    leftSnapshotId: string;
+    rightSnapshotId: string;
+    label: 0 | 1;
+    cohort: {
+        browserFamily?: string;
+        osFamily?: string;
+        mobileDesktop?: "mobile" | "desktop";
+        privateMode?: boolean | null;
+        spoofingLikely?: boolean;
+    };
+    features: Record<string, number | string | boolean | null>;
+}
+export interface CalibratedScore {
+    rawScore: number;
+    calibratedProbability: number;
+}
+export interface MatchDecision {
+    candidateSnapshotId: string;
+    rawScore: number;
+    calibratedProbability: number;
+    decision: "same_device" | "likely_same" | "review" | "different";
+    reasons: string[];
+    modelVersion: string;
+    calibrationVersion: string;
+    thresholdPolicyVersion: string;
+}
+export interface ThresholdPolicy {
+    thresholdPolicyVersion: string;
+    sameDeviceMin: number;
+    likelySameMin: number;
+    reviewMin: number;
+}
+export interface VersionSet {
+    collectorVersion: string;
+    featureSchemaVersion: string;
+    modelVersion: string;
+    calibrationVersion: string;
+    thresholdPolicyVersion: string;
+}
+export interface CohortMetrics {
+    cohort: string;
+    prAuc: number;
+    rocAuc: number;
+    logLoss: number;
+    brier: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/vnext/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/vnext/types.ts"],"names":[],"mappings":"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"}

package/docs/API.md

@@ -0,0 +1,26 @@
+# Справка по API
+
+## `FingerprintOptions`
+
+Поддерживает таймауты, выбор режима, включение/отключение collectors, debug/raw вывод, `salt` и пользовательские компоненты.
+
+Все методы Promise-based. Для каждого collector используется fail-soft поведение.
+
+## `FingerprintResult`
+
+- `fingerprintId`, `stableId`, `environmentId`
+- `confidenceScore` (`0..100`)
+- `riskScore` (`0..100`)
+- `flags` (индикаторы automation/tamper/privacy)
+- `components` (опциональные сырые данные)
+- `debug` (опциональная диагностика collectors + timings)
+
+## Коды ошибок
+
+- `ERR_UNSUPPORTED_API`
+- `ERR_TIMEOUT`
+- `ERR_SECURITY_RESTRICTED`
+- `ERR_PERMISSION_DENIED`
+- `ERR_RENDER_UNSTABLE`
+- `ERR_TAMPER_SUSPECTED`
+- `ERR_BROWSER_CONTEXT_REQUIRED`

package/docs/ARCHITECTURE.md

@@ -0,0 +1,48 @@
+# Архитектура
+
+## Слои
+
+1. Слой collectors (`src/collectors/*`)
+2. Слой нормализации (`src/normalizers/*`)
+3. Слой stability + anomaly (`src/risk/*`)
+4. Слой хэширования (`src/hash/*`)
+5. Оркестрация API (`src/index.ts`)
+
+## Collectors
+
+- navigator/browser identity
+- locale/timezone/Intl formats
+- screen + media queries
+- canvas (text + geometry + повторная проверка стабильности)
+- WebGL (renderer/extensions/caps/hash)
+- audio (OfflineAudioContext + повторная проверка стабильности)
+- fonts (безопасный detection + strict расширение)
+- storage capability
+- permissions (только query, без prompts)
+
+## Модель scoring
+
+- `confidenceScore` уменьшается при недоступных/нестабильных/ограниченных сигналах.
+- `riskScore` растет при automation/emulator/spoof/tamper индикаторах.
+
+## Модель деградации
+
+Недоступные API помечаются как `unsupported`/`restricted`/`timeout` и не ломают итоговый результат.
+
+## Архитектура апгрейда V2
+
+V2 расширяет v1 до единого browser + server antifraud контура:
+
+- Browser SDK: `src/v2/browser.ts`
+- Server SDK: `src/v2/server.ts`
+- Shared core: `src/v2/core.ts`
+- Shared types/contracts: `src/v2/types.ts`
+
+### План миграции
+
+1. Shadow mode: запуск v2 scoring/profile linking без влияния на решения.
+2. Compare mode: сравнение качества match/risk между v1 и v2.
+3. Assist mode: показ explainability v2 в админке.
+4. Enforcement mode: v2 сигналы влияют на прод-решения.
+
+Обратная совместимость реализована через `migrateV1PayloadToV2()`.

package/docs/BROWSER_SDK_V2.md

@@ -0,0 +1,18 @@
+# Руководство по Browser SDK (v2)
+
+## Lifecycle hooks
+
+- Stage A: `page_open` (fast)
+- Stage B: `pre_submit` (balanced/strict)
+- Stage C: `post_init` (after order/redirect)
+
+## Пример
+
+Используйте `BrowserFingerprintSession`:
+
+- `collectStage(...)` для формирования stage envelope
+- `registerSubmitAttempt()` при попытках submit
+
+Передавайте бизнес-контекст:
+
+- `partnerId`, `projectId`, `flowType`, `paymentType`, `userId`, `userData`, `shopUrl`, `lang`

package/docs/PAYMENT_FLOW_MAPPING_V2.md

@@ -0,0 +1,20 @@
+# Маппинг платежных флоу (v2)
+
+## card_form
+
+- page_open -> pre_submit -> payment init -> callback
+- token (если есть) связывает device <-> instrument profile
+
+## card_recurring
+
+- `tokenHash` — сильный сигнал exact-link
+- знакомый token + новое аномальное устройство повышают риск
+
+## sbp_form
+
+- `phone`/`email`/`pay_ttl` включаются в контекст
+- `redirect_url` может прийти позже через notify flow
+
+## sbp_gate
+
+- поддерживается отложенный `redirect_url` и post-init linking по `orderId`