Lifecycles

Author: MADEVAL

README.md

@@ -13,7 +13,7 @@ npm run verify
 ### ESM
 
 ```js
-import { loadClient } from '@fingerprint-framework/core';
+import { hashComponents, loadClient } from '@fingerprint-framework/core';
 
 const client = await loadClient({
   namespace: 'my-product',
@@ -25,6 +25,12 @@ const result = await client.get({
 });
 
 console.log(result.visitorId, result.confidence.score);
+
+const recalculated = await hashComponents(result.components, {
+  namespace: 'my-product'
+});
+
+console.log(recalculated.visitorId);
 ```
 
 ### Standalone Browser Script
@@ -56,12 +62,14 @@ After building, include the generated file directly:
 - Collector API for custom signals.
 - Policy layer with allow/deny collectors, categories, sensitivity limits, and consent gates.
 - Deterministic canonical normalization before hashing.
-- Browser quirk detection for known unstable Safari, Firefox, iOS, Chromium, and Samsung Internet paths.
-- Expanded built-in collectors for client hints, screen frame, media preferences, touch, architecture, plugins, vendor flavors, PDF viewer, Apple Pay, Private Click Measurement, DOM blockers, fonts, audio, WebGL extensions, canvas, and math behavior.
+- Browser quirk detection for known unstable Safari, Firefox, Firefox iOS, iOS desktop mode, Chromium, and Samsung Internet paths.
+- Expanded built-in collectors for client hints, navigator properties, screen frame, media preferences, touch, architecture, storage capabilities, plugins, vendor flavors, PDF viewer, Apple Pay, Private Click Measurement, DOM blockers, iframe-isolated fonts, font preferences, audio base latency, audio fingerprinting, WebGL extensions, canvas, and math behavior.
 - SHA-256 via Web Crypto or Node Crypto, with fallback support for constrained runtimes.
 - Confidence scoring and collector error metadata.
 - Optional visit state storage through `localStorage` or a custom adapter.
-- `loadClient()` / `prepare()` / `get()` flow for startup warmup and faster later identification.
+- `loadClient()` / `prepare()` / `get()` flow with collector preparation, consent checks, and prepared values reused during later identification.
+- Passive collectors run in parallel, while active collectors run in declared order to reduce cross-source interference.
+- `hashComponents()` for recalculating a visitor ID after product-side component filtering.
 - `componentsToDebugString()` and `client.debug()` for human-readable diagnostics.
 - Script-tag global API: `FingerprintFramework`.
 

dist/browser/fingerprint-framework.js

@@ -12,21 +12,31 @@ export interface CollectorContext {
   now: () => number;
 }
 
-export interface CollectorDefinition<T = unknown> {
+export interface CollectorDefinition<T = unknown, Prepared = unknown> {
   id: string;
   version?: string;
   category?: string;
   sensitivity?: Sensitivity;
   mode?: CollectorMode;
   stability?: 'stable' | 'volatile' | string;
   weight?: number;
-  collect(context: CollectorContext): T | Promise<T>;
+  prepare?(context: CollectorContext): Prepared | Promise<Prepared>;
+  collect(context: CollectorContext, prepared?: Prepared): T | Promise<T>;
 }
 
-export interface Collector<T = unknown> extends Required<Omit<CollectorDefinition<T>, 'collect'>> {
-  collect(context: CollectorContext): T | Promise<T>;
+export interface Collector<T = unknown, Prepared = unknown> {
+  id: string;
+  version: string;
+  category: string;
+  sensitivity: Sensitivity;
+  mode: CollectorMode;
+  stability: string;
+  weight: number;
+  prepare: null | ((context: CollectorContext) => Prepared | Promise<Prepared>);
+  collect(context: CollectorContext, prepared?: Prepared): T | Promise<T>;
 }
 
-export function createCollector<T = unknown>(definition: CollectorDefinition<T>): Collector<T>;
+export function createCollector<T = unknown, Prepared = unknown>(definition: CollectorDefinition<T, Prepared>): Collector<T, Prepared>;
 export function createDefaultCollectors(): Collector[];
 export function createBrowserCollectorPack(): Collector[];
+export function createNavigatorPropertiesCollector(): Collector;