@thumbmarkjs/thumbmarkjs 1.1.3-rc.2 → 1.1.3-rc.4

package/dist/types/utils/imageDataToDataURL.d.ts

@@ -0,0 +1 @@
+export declare function imageDataToDataURL(imageData: ImageData): string;

package/dist/types/utils/log.d.ts

@@ -0,0 +1,8 @@
+import { componentInterface } from '../factory';
+import { optionsInterface } from '../options';
+/**
+ * Logs thumbmark data to remote logging endpoint (only once per session)
+ * You can disable this by setting options.logging to false.
+ * @internal
+ */
+export declare function logThumbmarkData(thisHash: string, thumbmarkData: componentInterface, options: optionsInterface): Promise<void>;

package/dist/types/utils/raceAll.d.ts

@@ -0,0 +1,9 @@
+type DelayedPromise<T> = Promise<T>;
+export declare function delay<T>(t: number, val: T): DelayedPromise<T>;
+export interface RaceResult<T> {
+    value: T;
+    elapsed?: number;
+}
+export declare function raceAllPerformance<T>(promises: Promise<T>[], timeoutTime: number, timeoutVal: T): Promise<RaceResult<T>[]>;
+export declare function raceAll<T>(promises: Promise<T>[], timeoutTime: number, timeoutVal: T): Promise<(T | undefined)[]>;
+export {};

package/dist/types/utils/sort.d.ts

@@ -0,0 +1,8 @@
+import { componentInterface } from '../factory';
+/**
+ * Recursively sorts the keys of a component object alphabetically.
+ * This ensures a consistent order for hashing.
+ * @param obj The component object to sort.
+ * @returns A new object with sorted keys.
+ */
+export declare function sortComponentKeys(obj: componentInterface): componentInterface;

package/dist/types/utils/version.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Returns the current package version
+ */
+export declare function getVersion(): string;

package/dist/types/utils/visitorId.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Visitor ID storage utilities - localStorage only, server generates IDs
+ */
+/**
+ * Gets visitor ID from localStorage, returns null if unavailable
+ */
+export declare function getVisitorId(): string | null;
+/**
+ * Sets visitor ID in localStorage
+ */
+export declare function setVisitorId(visitorId: string): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thumbmarkjs/thumbmarkjs",
-  "version": "1.1.3-rc.2",
+  "version": "1.1.3-rc.4",
   "description": "",
   "type": "module",
   "main": "./dist/thumbmark.cjs.js",

package/src/functions/index.ts

@@ -28,6 +28,7 @@ import { getVersion } from "../utils/version";
 import { filterThumbmarkData } from './filterComponents'
 import { logThumbmarkData } from '../utils/log';
 import { API_ENDPOINT } from "../options";
+import { getVisitorId, setVisitorId } from "../utils/visitorId";
 
 // ===================== Types & Interfaces =====================
 
@@ -58,10 +59,10 @@ interface infoInterface {
  * API response structure
  */
 interface apiResponse {
-    thumbmark?: string;
     info?: infoInterface;
     version?: string;
     components?: componentInterface;
+    visitorId?: string;
 }
 
 /**
@@ -72,6 +73,7 @@ interface thumbmarkResponse {
     info: { [key: string]: any },
     version: string,
     thumbmark: string,
+    visitorId?: string,
     /**
      * Only present if options.performance is true.
      */
@@ -105,6 +107,17 @@ export const getApiPromise = (
 
     // 3. Otherwise, initiate a new API call with timeout.
     const endpoint = `${API_ENDPOINT}/thumbmark`;
+    const visitorId = getVisitorId();
+    const requestBody: any = { 
+        components, 
+        options, 
+        clientHash: hash(JSON.stringify(components)), 
+        version: getVersion()
+    };
+    if (visitorId) {
+        requestBody.visitorId = visitorId;
+    }
+    
     const fetchPromise = fetch(endpoint, {
         method: 'POST',
         headers: {
@@ -112,7 +125,7 @@ export const getApiPromise = (
             'Authorization': 'custom-authorized',
             'Content-Type': 'application/json',
         },
-        body: JSON.stringify({ components, options, clientHash: hash(JSON.stringify(components)), version: getVersion()}),
+        body: JSON.stringify(requestBody),
     })
         .then(response => {
             // Handle HTTP errors that aren't network errors
@@ -122,6 +135,10 @@ export const getApiPromise = (
             return response.json();
         })
         .then(data => {
+            // Handle visitor ID from server response
+            if (data.visitorId && data.visitorId !== visitorId) {
+                setVisitorId(data.visitorId);
+            }
             apiPromiseResult = data;      // Cache the successful result
             currentApiPromise = null;     // Clear the in-flight promise
             return data;
@@ -138,7 +155,6 @@ export const getApiPromise = (
     const timeoutPromise = new Promise<apiResponse>((resolve) => {
         setTimeout(() => {
             resolve({
-                thumbmark: hash(JSON.stringify(components)),
                 info: { timed_out: true },
                 version: getVersion(),
             });
@@ -176,13 +192,20 @@ export async function getThumbmark(options?: optionsInterface): Promise<thumbmar
     const thumbmark = hash(JSON.stringify(components));
     const version = getVersion();
     logThumbmarkData(thumbmark, components, _options).catch(() => { /* do nothing */ });
-    return {
+    
+    const result: thumbmarkResponse = {
         thumbmark,
         components: components,
         info,
         version,
         ...maybeElapsed,
     };
+    
+    if (apiResult?.visitorId) {
+        result.visitorId = apiResult.visitorId;
+    }
+    
+    return result;
 }
 
 // ===================== Component Resolution & Performance =====================

package/src/utils/visitorId.ts

@@ -0,0 +1,27 @@
+/**
+ * Visitor ID storage utilities - localStorage only, server generates IDs
+ */
+
+const VISITOR_ID_KEY = 'thumbmark_visitor_id';
+
+/**
+ * Gets visitor ID from localStorage, returns null if unavailable
+ */
+export function getVisitorId(): string | null {
+    try {
+        return localStorage.getItem(VISITOR_ID_KEY);
+    } catch {
+        return null;
+    }
+}
+
+/**
+ * Sets visitor ID in localStorage
+ */
+export function setVisitorId(visitorId: string): void {
+    try {
+        localStorage.setItem(VISITOR_ID_KEY, visitorId);
+    } catch {
+        // Ignore storage errors
+    }
+}