@augustdigital/sdk 4.15.5-alpha.0 → 4.17.0-alpha.0

package/lib/core/analytics/index.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.instrumentClass = exports.withMethodTracking = exports.resetCacheStats = exports.getCacheStats = exports.trackNetworkSwitch = exports.trackApiCall = exports.trackCacheOperation = exports.resetAnalytics = exports.getSentry = exports.isAnalyticsEnabled = exports.clearUser = exports.updateUser = exports.initializeSentry = exports.resetSession = exports.getUserId = exports.createUserIdentity = exports.generateFingerprint = exports.getSessionId = exports.hashApiKey = exports.getMethodCategory = exports.METHOD_CATEGORIES = exports.SENTRY_CONFIG = void 0;
+var constants_1 = require("./constants");
+Object.defineProperty(exports, "SENTRY_CONFIG", { enumerable: true, get: function () { return constants_1.SENTRY_CONFIG; } });
+Object.defineProperty(exports, "METHOD_CATEGORIES", { enumerable: true, get: function () { return constants_1.METHOD_CATEGORIES; } });
+Object.defineProperty(exports, "getMethodCategory", { enumerable: true, get: function () { return constants_1.getMethodCategory; } });
+var user_identity_1 = require("./user-identity");
+Object.defineProperty(exports, "hashApiKey", { enumerable: true, get: function () { return user_identity_1.hashApiKey; } });
+Object.defineProperty(exports, "getSessionId", { enumerable: true, get: function () { return user_identity_1.getSessionId; } });
+Object.defineProperty(exports, "generateFingerprint", { enumerable: true, get: function () { return user_identity_1.generateFingerprint; } });
+Object.defineProperty(exports, "createUserIdentity", { enumerable: true, get: function () { return user_identity_1.createUserIdentity; } });
+Object.defineProperty(exports, "getUserId", { enumerable: true, get: function () { return user_identity_1.getUserId; } });
+Object.defineProperty(exports, "resetSession", { enumerable: true, get: function () { return user_identity_1.resetSession; } });
+var sentry_1 = require("./sentry");
+Object.defineProperty(exports, "initializeSentry", { enumerable: true, get: function () { return sentry_1.initializeSentry; } });
+Object.defineProperty(exports, "updateUser", { enumerable: true, get: function () { return sentry_1.updateUser; } });
+Object.defineProperty(exports, "clearUser", { enumerable: true, get: function () { return sentry_1.clearUser; } });
+Object.defineProperty(exports, "isAnalyticsEnabled", { enumerable: true, get: function () { return sentry_1.isAnalyticsEnabled; } });
+Object.defineProperty(exports, "getSentry", { enumerable: true, get: function () { return sentry_1.getSentry; } });
+Object.defineProperty(exports, "resetAnalytics", { enumerable: true, get: function () { return sentry_1.resetAnalytics; } });
+var metrics_1 = require("./metrics");
+Object.defineProperty(exports, "trackCacheOperation", { enumerable: true, get: function () { return metrics_1.trackCacheOperation; } });
+Object.defineProperty(exports, "trackApiCall", { enumerable: true, get: function () { return metrics_1.trackApiCall; } });
+Object.defineProperty(exports, "trackNetworkSwitch", { enumerable: true, get: function () { return metrics_1.trackNetworkSwitch; } });
+Object.defineProperty(exports, "getCacheStats", { enumerable: true, get: function () { return metrics_1.getCacheStats; } });
+Object.defineProperty(exports, "resetCacheStats", { enumerable: true, get: function () { return metrics_1.resetCacheStats; } });
+var instrumentation_1 = require("./instrumentation");
+Object.defineProperty(exports, "withMethodTracking", { enumerable: true, get: function () { return instrumentation_1.withMethodTracking; } });
+Object.defineProperty(exports, "instrumentClass", { enumerable: true, get: function () { return instrumentation_1.instrumentClass; } });
+//# sourceMappingURL=index.js.map

package/lib/core/analytics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src.ts/core/analytics/index.ts"],"names":[],"mappings":";;;AAmCA,yCAIqB;AAHnB,0GAAA,aAAa,OAAA;AACb,8GAAA,iBAAiB,OAAA;AACjB,8GAAA,iBAAiB,OAAA;AAInB,iDAOyB;AANvB,2GAAA,UAAU,OAAA;AACV,6GAAA,YAAY,OAAA;AACZ,oHAAA,mBAAmB,OAAA;AACnB,mHAAA,kBAAkB,OAAA;AAClB,0GAAA,SAAS,OAAA;AACT,6GAAA,YAAY,OAAA;AAId,mCAOkB;AANhB,0GAAA,gBAAgB,OAAA;AAChB,oGAAA,UAAU,OAAA;AACV,mGAAA,SAAS,OAAA;AACT,4GAAA,kBAAkB,OAAA;AAClB,mGAAA,SAAS,OAAA;AACT,wGAAA,cAAc,OAAA;AAIhB,qCAMmB;AALjB,8GAAA,mBAAmB,OAAA;AACnB,uGAAA,YAAY,OAAA;AACZ,6GAAA,kBAAkB,OAAA;AAClB,wGAAA,aAAa,OAAA;AACb,0GAAA,eAAe,OAAA;AAIjB,qDAAwE;AAA/D,qHAAA,kBAAkB,OAAA;AAAE,kHAAA,eAAe,OAAA"}

package/lib/core/analytics/instrumentation.d.ts

@@ -0,0 +1,2 @@
+export declare function withMethodTracking<T extends (...args: unknown[]) => Promise<unknown>>(methodName: string, method: T, getChainId?: () => number | undefined): T;
+export declare function instrumentClass<T extends object>(instance: T, getChainId: () => number | undefined): T;

package/lib/core/analytics/instrumentation.js

@@ -0,0 +1,150 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withMethodTracking = withMethodTracking;
+exports.instrumentClass = instrumentClass;
+const Sentry = __importStar(require("@sentry/node"));
+const constants_1 = require("./constants");
+const sentry_1 = require("./sentry");
+function withMethodTracking(methodName, method, getChainId) {
+    return async function trackedMethod(...args) {
+        if (!(0, sentry_1.isAnalyticsEnabled)()) {
+            return method(...args);
+        }
+        const startTime = performance.now();
+        const chainId = getChainId?.();
+        const category = (0, constants_1.getMethodCategory)(methodName);
+        try {
+            return await Sentry.startSpan({
+                op: 'sdk.method',
+                name: methodName,
+                attributes: {
+                    category,
+                    chainId: chainId?.toString() || 'unknown',
+                },
+            }, async (span) => {
+                try {
+                    const result = await method(...args);
+                    const duration = performance.now() - startTime;
+                    span?.setAttribute('duration', Math.round(duration));
+                    span?.setAttribute('success', true);
+                    trackMethodCall(methodName, {
+                        method: methodName,
+                        chainId,
+                        duration,
+                        success: true,
+                        category,
+                    });
+                    span?.setStatus({ code: 1 });
+                    return result;
+                }
+                catch (error) {
+                    const duration = performance.now() - startTime;
+                    const errorType = error instanceof Error ? error.name : 'UnknownError';
+                    span?.setAttribute('duration', Math.round(duration));
+                    span?.setAttribute('success', false);
+                    span?.setAttribute('error', error instanceof Error ? error.message : String(error));
+                    trackMethodCall(methodName, {
+                        method: methodName,
+                        chainId,
+                        duration,
+                        success: false,
+                        category,
+                        errorType,
+                    });
+                    span?.setStatus({ code: 2, message: errorType });
+                    throw error;
+                }
+            });
+        }
+        catch (error) {
+            if (error instanceof Error && error.message?.includes('Sentry')) {
+                return method(...args);
+            }
+            throw error;
+        }
+    };
+}
+function trackMethodCall(methodName, metrics) {
+    try {
+        Sentry.addBreadcrumb({
+            category: 'sdk.method',
+            message: methodName,
+            level: metrics.success ? 'info' : 'error',
+            data: {
+                chainId: metrics.chainId,
+                duration: Math.round(metrics.duration),
+                category: metrics.category,
+                errorType: metrics.errorType,
+            },
+        });
+        Sentry.setMeasurement('sdk.method.duration', metrics.duration, 'millisecond');
+        Sentry.setTag('sdk.last_method', methodName);
+        Sentry.setTag('sdk.last_category', metrics.category);
+        if (metrics.chainId) {
+            Sentry.setTag('sdk.last_chainId', metrics.chainId.toString());
+        }
+    }
+    catch {
+    }
+}
+function isAsyncMethod(fn) {
+    if (fn.constructor.name === 'AsyncFunction') {
+        return true;
+    }
+    const fnString = fn.toString();
+    return fnString.includes('__awaiter') || fnString.startsWith('async');
+}
+function instrumentClass(instance, getChainId) {
+    try {
+        const proto = Object.getPrototypeOf(instance);
+        const methodNames = Object.getOwnPropertyNames(proto).filter((name) => {
+            if (name === 'constructor' || name.startsWith('_'))
+                return false;
+            const descriptor = Object.getOwnPropertyDescriptor(proto, name);
+            return typeof descriptor?.value === 'function';
+        });
+        for (const methodName of methodNames) {
+            const original = instance[methodName];
+            if (typeof original === 'function' && isAsyncMethod(original)) {
+                instance[methodName] = withMethodTracking(methodName, original.bind(instance), getChainId);
+            }
+        }
+    }
+    catch {
+    }
+    return instance;
+}
+//# sourceMappingURL=instrumentation.js.map

package/lib/core/analytics/instrumentation.js.map

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

package/lib/core/analytics/metrics.d.ts

@@ -0,0 +1,12 @@
+import { ICacheOperation, ICacheType } from './types';
+declare let cacheStats: {
+    hits: number;
+    misses: number;
+    sets: number;
+};
+export declare function trackCacheOperation(operation: ICacheOperation, cacheType: ICacheType): void;
+export declare function trackApiCall(endpoint: string, method: string, startTime: number, status: number, server: string): void;
+export declare function trackNetworkSwitch(chainId: number): void;
+export declare function getCacheStats(): typeof cacheStats;
+export declare function resetCacheStats(): void;
+export {};

package/lib/core/analytics/metrics.js

@@ -0,0 +1,133 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trackCacheOperation = trackCacheOperation;
+exports.trackApiCall = trackApiCall;
+exports.trackNetworkSwitch = trackNetworkSwitch;
+exports.getCacheStats = getCacheStats;
+exports.resetCacheStats = resetCacheStats;
+const Sentry = __importStar(require("@sentry/node"));
+const sentry_1 = require("./sentry");
+let cacheStats = {
+    hits: 0,
+    misses: 0,
+    sets: 0,
+};
+function trackCacheOperation(operation, cacheType) {
+    if (!(0, sentry_1.isAnalyticsEnabled)())
+        return;
+    try {
+        switch (operation) {
+            case 'hit':
+                cacheStats.hits++;
+                break;
+            case 'miss':
+                cacheStats.misses++;
+                break;
+            case 'set':
+                cacheStats.sets++;
+                break;
+        }
+        const totalLookups = cacheStats.hits + cacheStats.misses;
+        const hitRate = totalLookups > 0 ? cacheStats.hits / totalLookups : 0;
+        Sentry.addBreadcrumb({
+            category: 'cache',
+            message: `${cacheType}:${operation}`,
+            level: 'debug',
+            data: {
+                cacheType,
+                operation,
+                hitRate: hitRate.toFixed(3),
+                totalOperations: cacheStats.hits + cacheStats.misses + cacheStats.sets,
+            },
+        });
+    }
+    catch {
+    }
+}
+function trackApiCall(endpoint, method, startTime, status, server) {
+    if (!(0, sentry_1.isAnalyticsEnabled)())
+        return;
+    try {
+        const duration = performance.now() - startTime;
+        const normalizedEndpoint = normalizeEndpoint(endpoint);
+        Sentry.addBreadcrumb({
+            category: 'api',
+            message: `${method} ${normalizedEndpoint}`,
+            level: status >= 400 || status === 0 ? 'error' : 'info',
+            data: {
+                endpoint: normalizedEndpoint,
+                method,
+                duration: Math.round(duration),
+                status,
+                server,
+            },
+        });
+        Sentry.setMeasurement('api.duration', duration, 'millisecond');
+        Sentry.setTag('api.last_endpoint', normalizedEndpoint);
+        Sentry.setTag('api.server', server);
+    }
+    catch {
+    }
+}
+function trackNetworkSwitch(chainId) {
+    if (!(0, sentry_1.isAnalyticsEnabled)())
+        return;
+    try {
+        Sentry.addBreadcrumb({
+            category: 'network',
+            message: `Switched to chain ${chainId}`,
+            level: 'info',
+            data: { chainId },
+        });
+        Sentry.setTag('active.chainId', chainId.toString());
+    }
+    catch {
+    }
+}
+function normalizeEndpoint(endpoint) {
+    return (endpoint
+        .replace(/0x[a-fA-F0-9]{40}/g, ':address')
+        .replace(/\/\d{5,}/g, '/:chainId')
+        .replace(/[a-f0-9-]{36}/gi, ':uuid')
+        .replace(/\/\d+(?=\/|$)/g, '/:id'));
+}
+function getCacheStats() {
+    return { ...cacheStats };
+}
+function resetCacheStats() {
+    cacheStats = { hits: 0, misses: 0, sets: 0 };
+}
+//# sourceMappingURL=metrics.js.map

package/lib/core/analytics/metrics.js.map

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

package/lib/core/analytics/sentry.d.ts

@@ -0,0 +1,9 @@
+import * as Sentry from '@sentry/node';
+import { IEnv } from '../../types';
+import { IAnalyticsConfig } from './types';
+export declare function initializeSentry(config: IAnalyticsConfig, environment: IEnv, walletAddress?: string, apiKey?: string): void;
+export declare function updateUser(walletAddress?: string, environment?: IEnv): void;
+export declare function clearUser(): void;
+export declare function isAnalyticsEnabled(): boolean;
+export declare function getSentry(): typeof Sentry | null;
+export declare function resetAnalytics(): void;

package/lib/core/analytics/sentry.js

@@ -0,0 +1,166 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initializeSentry = initializeSentry;
+exports.updateUser = updateUser;
+exports.clearUser = clearUser;
+exports.isAnalyticsEnabled = isAnalyticsEnabled;
+exports.getSentry = getSentry;
+exports.resetAnalytics = resetAnalytics;
+const Sentry = __importStar(require("@sentry/node"));
+const constants_1 = require("./constants");
+const user_identity_1 = require("./user-identity");
+let isInitialized = false;
+let isEnabled = true;
+let currentIdentity = null;
+let cachedApiKey;
+function getSDKVersion() {
+    try {
+        return require('./version').SDK_VERSION || 'development';
+    }
+    catch {
+        return 'development';
+    }
+}
+function safeSetTag(key, value) {
+    try {
+        Sentry.setTag(key, value);
+    }
+    catch {
+    }
+}
+function safeSetUser(user) {
+    try {
+        Sentry.setUser(user);
+    }
+    catch {
+    }
+}
+function initializeSentry(config, environment, walletAddress, apiKey) {
+    if (config.enabled === false) {
+        isEnabled = false;
+        console.log('August SDK: Analytics disabled');
+        return;
+    }
+    cachedApiKey = apiKey;
+    if (isInitialized) {
+        if (walletAddress !== currentIdentity?.walletAddress ||
+            environment !== currentIdentity?.environment) {
+            updateUser(walletAddress, environment);
+        }
+        return;
+    }
+    try {
+        Sentry.init({
+            dsn: constants_1.SENTRY_DSN,
+            tracesSampleRate: constants_1.SENTRY_CONFIG.tracesSampleRate,
+            environment: environment.toLowerCase(),
+            release: `august-sdk@${getSDKVersion()}`,
+            sendDefaultPii: true,
+            beforeSend(event) {
+                if (event.tags?.sdk !== 'august-digital') {
+                    return null;
+                }
+                return event;
+            },
+            beforeSendTransaction(transaction) {
+                return transaction;
+            },
+        });
+        updateUser(walletAddress, environment);
+        safeSetTag('sdk', 'august-digital');
+        safeSetTag('sdk.version', getSDKVersion());
+        isInitialized = true;
+        console.log('August SDK: Analytics initialized. Disable with { analytics: { enabled: false } }');
+    }
+    catch {
+        isEnabled = false;
+    }
+}
+function updateUser(walletAddress, environment = 'PROD') {
+    if (!isEnabled)
+        return;
+    try {
+        currentIdentity = (0, user_identity_1.createUserIdentity)(cachedApiKey, walletAddress, environment);
+        safeSetUser({
+            id: (0, user_identity_1.getUserId)(currentIdentity),
+            username: walletAddress || undefined,
+            data: {
+                sessionId: currentIdentity.sessionId,
+                fingerprint: currentIdentity.fingerprint,
+                hasWallet: !!walletAddress,
+                hasApiKey: !!currentIdentity.apiKeyHash,
+                environment: currentIdentity.environment,
+            },
+        });
+    }
+    catch {
+    }
+}
+function clearUser() {
+    if (!isEnabled)
+        return;
+    try {
+        const environment = currentIdentity?.environment || 'PROD';
+        currentIdentity = (0, user_identity_1.createUserIdentity)(cachedApiKey, undefined, environment);
+        safeSetUser({
+            id: (0, user_identity_1.getUserId)(currentIdentity),
+            data: {
+                sessionId: currentIdentity.sessionId,
+                fingerprint: currentIdentity.fingerprint,
+                hasWallet: false,
+                hasApiKey: !!currentIdentity.apiKeyHash,
+                environment: currentIdentity.environment,
+            },
+        });
+    }
+    catch {
+    }
+}
+function isAnalyticsEnabled() {
+    return isEnabled && isInitialized;
+}
+function getSentry() {
+    if (!isAnalyticsEnabled())
+        return null;
+    return Sentry;
+}
+function resetAnalytics() {
+    isInitialized = false;
+    isEnabled = true;
+    currentIdentity = null;
+    cachedApiKey = undefined;
+}
+//# sourceMappingURL=sentry.js.map

package/lib/core/analytics/sentry.js.map

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

package/lib/core/analytics/types.d.ts

@@ -0,0 +1,21 @@
+import { IEnv } from '../../types';
+export interface IAnalyticsConfig {
+    enabled?: boolean;
+}
+export interface IUserIdentity {
+    apiKeyHash?: string;
+    walletAddress?: string;
+    sessionId: string;
+    fingerprint?: string;
+    environment: IEnv;
+}
+export interface IMethodCallMetrics {
+    method: string;
+    chainId?: number;
+    duration: number;
+    success: boolean;
+    category: string;
+    errorType?: string;
+}
+export type ICacheOperation = 'hit' | 'miss' | 'set';
+export type ICacheType = 'main' | 'price' | 'price_error';

package/lib/core/analytics/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/lib/core/analytics/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src.ts/core/analytics/types.ts"],"names":[],"mappings":""}

package/lib/core/analytics/user-identity.d.ts

@@ -0,0 +1,8 @@
+import { IEnv } from '../../types';
+import { IUserIdentity } from './types';
+export declare function hashApiKey(apiKey: string): string;
+export declare function getSessionId(): string;
+export declare function generateFingerprint(): string | undefined;
+export declare function createUserIdentity(apiKey?: string, walletAddress?: string, environment?: IEnv): IUserIdentity;
+export declare function getUserId(identity: IUserIdentity): string;
+export declare function resetSession(): void;

package/lib/core/analytics/user-identity.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hashApiKey = hashApiKey;
+exports.getSessionId = getSessionId;
+exports.generateFingerprint = generateFingerprint;
+exports.createUserIdentity = createUserIdentity;
+exports.getUserId = getUserId;
+exports.resetSession = resetSession;
+const crypto_1 = require("crypto");
+const uuid_1 = require("uuid");
+let sessionId = null;
+let cachedApiKeyHash = null;
+function hashApiKey(apiKey) {
+    if (!apiKey)
+        return '';
+    if (cachedApiKeyHash)
+        return cachedApiKeyHash;
+    const hash = (0, crypto_1.createHash)('sha256').update(apiKey).digest('hex');
+    cachedApiKeyHash = hash.substring(0, 16);
+    return cachedApiKeyHash;
+}
+function getSessionId() {
+    if (!sessionId) {
+        sessionId = (0, uuid_1.v4)();
+    }
+    return sessionId;
+}
+function generateFingerprint() {
+    try {
+        if (typeof window !== 'undefined' && typeof navigator !== 'undefined') {
+            const components = [
+                navigator.userAgent,
+                navigator.language,
+                new Date().getTimezoneOffset().toString(),
+                typeof screen !== 'undefined' ? screen.width?.toString() : '',
+                typeof screen !== 'undefined' ? screen.height?.toString() : '',
+                typeof screen !== 'undefined' ? screen.colorDepth?.toString() : '',
+            ].filter(Boolean);
+            const hash = (0, crypto_1.createHash)('sha256')
+                .update(components.join('|'))
+                .digest('hex');
+            return hash.substring(0, 32);
+        }
+        if (typeof process !== 'undefined' && process.platform) {
+            const components = [process.platform, process.arch, process.version];
+            const hash = (0, crypto_1.createHash)('sha256')
+                .update(components.join('|'))
+                .digest('hex');
+            return hash.substring(0, 32);
+        }
+    }
+    catch {
+        return undefined;
+    }
+    return undefined;
+}
+function createUserIdentity(apiKey, walletAddress, environment = 'PROD') {
+    return {
+        apiKeyHash: apiKey ? hashApiKey(apiKey) : undefined,
+        walletAddress: walletAddress?.toLowerCase(),
+        sessionId: getSessionId(),
+        fingerprint: generateFingerprint(),
+        environment,
+    };
+}
+function getUserId(identity) {
+    if (identity.apiKeyHash) {
+        return `apikey:${identity.apiKeyHash}`;
+    }
+    if (identity.walletAddress) {
+        return `wallet:${identity.walletAddress}`;
+    }
+    if (identity.fingerprint) {
+        return `fp:${identity.fingerprint}`;
+    }
+    return `session:${identity.sessionId}`;
+}
+function resetSession() {
+    sessionId = null;
+    cachedApiKeyHash = null;
+}
+//# sourceMappingURL=user-identity.js.map