@bluenath/engage 1.0.0

package/dist/lib/fingerprint.d.ts

@@ -0,0 +1,11 @@
+export interface DeviceSignal {
+    userAgent: string;
+    screenRes: string;
+    colorDepth: number;
+    timezone: number;
+    language: string;
+    platform: string;
+    hardwareConcurrency: number;
+    deviceMemory?: number;
+}
+export declare const getDeviceFingerprint: () => string;

package/dist/lib/hash.d.ts

@@ -0,0 +1,6 @@
+/**
+ * FNV-1a Hash implementation
+ * Converts a string input into a 32-bit integer hash.
+ * Used for generating stable Device IDs and deduplication keys.
+ */
+export declare const hashFnv32a: (str: string) => string;

package/dist/lib/storage.d.ts

@@ -0,0 +1,24 @@
+export declare class StorageEngine {
+    private type;
+    private memoryStore;
+    private keyPrefix;
+    private domain;
+    constructor(type?: "local" | "cookie" | "memory");
+    /**
+     * Safe Getter that tries Memory -> Storage Strategy
+     */
+    getItem(key: string): string | null;
+    /**
+     * Safe Setter with Automatic Fallback
+     */
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+    private getCookie;
+    private setCookie;
+    /**
+     * Tries to find the highest level domain (e.g. .nike.com) to allow cross-subdomain tracking
+     */
+    private getCookieDomain;
+    private isBrowser;
+    private isQuotaError;
+}

package/dist/react/EngageProProvider.d.ts

@@ -0,0 +1,10 @@
+import { default as React } from 'react';
+import { EngagePro } from '../core/Analytics';
+import { EngageConfig } from '../types';
+
+export declare const useAnalytics: () => EngagePro;
+interface ProviderProps extends EngageConfig {
+    children: React.ReactNode;
+}
+export declare const EngageProProvider: React.FC<ProviderProps>;
+export {};

package/dist/types/index.d.ts

@@ -0,0 +1,63 @@
+export type StandardEvent = "ADD_TO_CART" | "INITIATE_CHECKOUT" | "PURCHASE" | "SEARCH" | "ORDER_CANCEL" | "ORDER_REFUND" | "REORDER" | "TRACK_PACKAGE" | "RATE_PRODUCT" | "SHARE_PRODUCT" | "REGISTER" | "LOGIN" | "VIEW_CONTENT" | "PAGE_VIEW" | "PERFORMANCE" | "RAGE_CLICK" | "FORM_START" | "FORM_SUBMIT" | "GENERIC";
+export type IntentType = "commerce" | "lifecycle" | "engagement" | "identity" | "search" | "frustration" | "performance" | "navigation" | "interaction" | "form" | "generic";
+export interface AnalyticsContext {
+    library: {
+        name: string;
+        version: string;
+    };
+    user: {
+        anonymousId: string;
+        id?: string | null;
+    };
+    session: {
+        id: string;
+        startTime: number;
+    };
+    page: {
+        path: string;
+        referrer: string;
+        title: string;
+        search: string;
+        url: string;
+    };
+    network: {
+        online: boolean;
+        downlink?: number;
+    };
+    screen: {
+        width: number;
+        height: number;
+        density: number;
+    };
+    device: {
+        fingerprint: string;
+        type: "mobile" | "tablet" | "desktop";
+        userAgent: string;
+    };
+    locale: string;
+    timezone: string;
+}
+export interface AnalyticsEvent {
+    event: string;
+    properties?: Record<string, any>;
+    standardEvent?: StandardEvent;
+    intent?: IntentType;
+    confidence?: number;
+    rawLabel?: string;
+    userId?: string;
+    anonymousId?: string;
+    timestamp?: string;
+    messageId?: string;
+    writeKey?: string;
+    context?: Partial<AnalyticsContext>;
+}
+export interface EngageConfig {
+    writeKey: string;
+    apiHost?: string;
+    tracking: {
+        useCookies: boolean;
+        fingerprint: boolean;
+        autoTrack: boolean;
+    };
+    debug?: boolean;
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@bluenath/engage",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc --noEmit && vite build",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "react": ">=16.8.0",
+    "react-dom": ">=16.8.0"
+  },
+  "dependencies": {
+    "uuid": "^9.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
+    "@types/uuid": "^9.0.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "terser": "^5.46.0",
+    "typescript": "^5.0.0",
+    "vite": "^5.0.0",
+    "vite-plugin-dts": "^3.0.0"
+  }
+}