@augustdigital/sdk 4.18.0 → 4.19.0-alpha.0

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

@@ -0,0 +1,6 @@
+export declare const SENTRY_DSN = "https://d73b6a85fe14960b8dac8ac61a743a94@o4507215496609792.ingest.de.sentry.io/4510699327389776";
+export declare const SENTRY_CONFIG: {
+    readonly tracesSampleRate: 0.1;
+    readonly enableTracing: true;
+    readonly environment: "production";
+};

package/lib/core/analytics/constants.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SENTRY_CONFIG = exports.SENTRY_DSN = void 0;
+exports.SENTRY_DSN = 'https://d73b6a85fe14960b8dac8ac61a743a94@o4507215496609792.ingest.de.sentry.io/4510699327389776';
+exports.SENTRY_CONFIG = {
+    tracesSampleRate: 0.1,
+    enableTracing: true,
+    environment: 'production',
+};
+//# sourceMappingURL=constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src.ts/core/analytics/constants.ts"],"names":[],"mappings":";;;AAIa,QAAA,UAAU,GACrB,iGAAiG,CAAC;AAKvF,QAAA,aAAa,GAAG;IAE3B,gBAAgB,EAAE,GAAG;IAErB,aAAa,EAAE,IAAI;IAEnB,WAAW,EAAE,YAAY;CACjB,CAAC"}

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

@@ -0,0 +1,7 @@
+export type { IAnalyticsConfig, IUserIdentity, IMethodCallMetrics, } from './types';
+export { SENTRY_CONFIG } from './constants';
+export { hashApiKey, getSessionId, generateFingerprint, createUserIdentity, getUserId, } from './user-identity';
+export { initializeSentry, updateUser, clearUser, isAnalyticsEnabled, getSentry, resetAnalytics, } from './sentry';
+export { trackApiCall, trackNetworkSwitch, getCacheStats, resetCacheStats, } from './metrics';
+export { sanitizeArgs, sanitizeObject } from './sanitize';
+export { withMethodTracking, withSyncMethodTracking, instrumentClass, } from './instrumentation';

package/lib/core/analytics/index.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.instrumentClass = exports.withSyncMethodTracking = exports.withMethodTracking = exports.sanitizeObject = exports.sanitizeArgs = exports.resetCacheStats = exports.getCacheStats = exports.trackNetworkSwitch = exports.trackApiCall = exports.resetAnalytics = exports.getSentry = exports.isAnalyticsEnabled = exports.clearUser = exports.updateUser = exports.initializeSentry = exports.getUserId = exports.createUserIdentity = exports.generateFingerprint = exports.getSessionId = exports.hashApiKey = exports.SENTRY_CONFIG = void 0;
+var constants_1 = require("./constants");
+Object.defineProperty(exports, "SENTRY_CONFIG", { enumerable: true, get: function () { return constants_1.SENTRY_CONFIG; } });
+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; } });
+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, "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 sanitize_1 = require("./sanitize");
+Object.defineProperty(exports, "sanitizeArgs", { enumerable: true, get: function () { return sanitize_1.sanitizeArgs; } });
+Object.defineProperty(exports, "sanitizeObject", { enumerable: true, get: function () { return sanitize_1.sanitizeObject; } });
+var instrumentation_1 = require("./instrumentation");
+Object.defineProperty(exports, "withMethodTracking", { enumerable: true, get: function () { return instrumentation_1.withMethodTracking; } });
+Object.defineProperty(exports, "withSyncMethodTracking", { enumerable: true, get: function () { return instrumentation_1.withSyncMethodTracking; } });
+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,yCAA4C;AAAnC,0GAAA,aAAa,OAAA;AAGtB,iDAMyB;AALvB,2GAAA,UAAU,OAAA;AACV,6GAAA,YAAY,OAAA;AACZ,oHAAA,mBAAmB,OAAA;AACnB,mHAAA,kBAAkB,OAAA;AAClB,0GAAA,SAAS,OAAA;AAIX,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,qCAKmB;AAJjB,uGAAA,YAAY,OAAA;AACZ,6GAAA,kBAAkB,OAAA;AAClB,wGAAA,aAAa,OAAA;AACb,0GAAA,eAAe,OAAA;AAIjB,uCAA0D;AAAjD,wGAAA,YAAY,OAAA;AAAE,0GAAA,cAAc,OAAA;AAGrC,qDAI2B;AAHzB,qHAAA,kBAAkB,OAAA;AAClB,yHAAA,sBAAsB,OAAA;AACtB,kHAAA,eAAe,OAAA"}

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

@@ -0,0 +1,3 @@
+export declare function withMethodTracking<T extends (...args: unknown[]) => Promise<unknown>>(methodName: string, method: T, getChainId?: () => number | undefined): T;
+export declare function withSyncMethodTracking<T extends (...args: unknown[]) => 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,209 @@
+"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.withSyncMethodTracking = withSyncMethodTracking;
+exports.instrumentClass = instrumentClass;
+const Sentry = __importStar(require("@sentry/browser"));
+const sanitize_1 = require("./sanitize");
+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 sanitizedArgs = (0, sanitize_1.sanitizeArgs)(args);
+        try {
+            return await Sentry.startSpan({
+                op: 'sdk.method',
+                name: methodName,
+                attributes: {
+                    chainId: chainId?.toString() || 'unknown',
+                    ...sanitizedArgs,
+                },
+            }, 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,
+                    }, sanitizedArgs);
+                    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,
+                        errorType,
+                    }, sanitizedArgs);
+                    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, args) {
+    try {
+        Sentry.addBreadcrumb({
+            category: 'sdk.method',
+            message: methodName,
+            level: metrics.success ? 'info' : 'error',
+            data: {
+                chainId: metrics.chainId,
+                duration: Math.round(metrics.duration),
+                errorType: metrics.errorType,
+                ...args,
+            },
+        });
+        Sentry.setMeasurement('sdk.method.duration', metrics.duration, 'millisecond');
+        Sentry.setTag('sdk.last_method', methodName);
+        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 withSyncMethodTracking(methodName, method, getChainId) {
+    return function trackedSyncMethod(...args) {
+        if (!(0, sentry_1.isAnalyticsEnabled)()) {
+            return method(...args);
+        }
+        const startTime = performance.now();
+        const chainId = getChainId?.();
+        const sanitizedArgs = (0, sanitize_1.sanitizeArgs)(args);
+        try {
+            const result = method(...args);
+            const duration = performance.now() - startTime;
+            trackSyncMethodCall(methodName, {
+                method: methodName,
+                chainId,
+                duration,
+                success: true,
+            }, sanitizedArgs);
+            return result;
+        }
+        catch (error) {
+            const duration = performance.now() - startTime;
+            const errorType = error instanceof Error ? error.name : 'UnknownError';
+            trackSyncMethodCall(methodName, {
+                method: methodName,
+                chainId,
+                duration,
+                success: false,
+                errorType,
+            }, sanitizedArgs);
+            throw error;
+        }
+    };
+}
+function trackSyncMethodCall(methodName, metrics, args) {
+    try {
+        Sentry.addBreadcrumb({
+            category: 'sdk.sync_method',
+            message: methodName,
+            level: metrics.success ? 'info' : 'error',
+            data: {
+                chainId: metrics.chainId,
+                duration: Math.round(metrics.duration),
+                errorType: metrics.errorType,
+                ...args,
+            },
+        });
+        Sentry.setTag('sdk.last_sync_method', methodName);
+        if (metrics.chainId) {
+            Sentry.setTag('sdk.last_chainId', metrics.chainId.toString());
+        }
+    }
+    catch {
+    }
+}
+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') {
+                if (isAsyncMethod(original)) {
+                    instance[methodName] =
+                        withMethodTracking(methodName, original.bind(instance), getChainId);
+                }
+                else {
+                    instance[methodName] =
+                        withSyncMethodTracking(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,10 @@
+declare let cacheStats: {
+    hits: number;
+    misses: number;
+    sets: number;
+};
+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,100 @@
+"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.trackApiCall = trackApiCall;
+exports.trackNetworkSwitch = trackNetworkSwitch;
+exports.getCacheStats = getCacheStats;
+exports.resetCacheStats = resetCacheStats;
+const Sentry = __importStar(require("@sentry/browser"));
+const sentry_1 = require("./sentry");
+let cacheStats = {
+    hits: 0,
+    misses: 0,
+    sets: 0,
+};
+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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqBA,oCAsCC;AAOD,gDAeC;AA0BD,sCAEC;AAKD,0CAEC;AApHD,wDAA0C;AAC1C,qCAA8C;AAK9C,IAAI,UAAU,GAAG;IACf,IAAI,EAAE,CAAC;IACP,MAAM,EAAE,CAAC;IACT,IAAI,EAAE,CAAC;CACR,CAAC;AAWF,SAAgB,YAAY,CAC1B,QAAgB,EAChB,MAAc,EACd,SAAiB,EACjB,MAAc,EACd,MAAc;IAEd,IAAI,CAAC,IAAA,2BAAkB,GAAE;QAAE,OAAO;IAElC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAG/C,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAGvD,MAAM,CAAC,aAAa,CAAC;YACnB,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,GAAG,MAAM,IAAI,kBAAkB,EAAE;YAC1C,KAAK,EAAE,MAAM,IAAI,GAAG,IAAI,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;YACvD,IAAI,EAAE;gBACJ,QAAQ,EAAE,kBAAkB;gBAC5B,MAAM;gBACN,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;gBAC9B,MAAM;gBACN,MAAM;aACP;SACF,CAAC,CAAC;QAGH,MAAM,CAAC,cAAc,CAAC,cAAc,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;QAG/D,MAAM,CAAC,MAAM,CAAC,mBAAmB,EAAE,kBAAkB,CAAC,CAAC;QACvD,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;IAET,CAAC;AACH,CAAC;AAOD,SAAgB,kBAAkB,CAAC,OAAe;IAChD,IAAI,CAAC,IAAA,2BAAkB,GAAE;QAAE,OAAO;IAElC,IAAI,CAAC;QACH,MAAM,CAAC,aAAa,CAAC;YACnB,QAAQ,EAAE,SAAS;YACnB,OAAO,EAAE,qBAAqB,OAAO,EAAE;YACvC,KAAK,EAAE,MAAM;YACb,IAAI,EAAE,EAAE,OAAO,EAAE;SAClB,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,gBAAgB,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;IAET,CAAC;AACH,CAAC;AASD,SAAS,iBAAiB,CAAC,QAAgB;IACzC,OAAO,CACL,QAAQ;SAEL,OAAO,CAAC,oBAAoB,EAAE,UAAU,CAAC;SAEzC,OAAO,CAAC,WAAW,EAAE,WAAW,CAAC;SAEjC,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC;SAEnC,OAAO,CAAC,gBAAgB,EAAE,MAAM,CAAC,CACrC,CAAC;AACJ,CAAC;AAKD,SAAgB,aAAa;IAC3B,OAAO,EAAE,GAAG,UAAU,EAAE,CAAC;AAC3B,CAAC;AAKD,SAAgB,eAAe;IAC7B,UAAU,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAC/C,CAAC"}

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

@@ -0,0 +1,2 @@
+export declare function sanitizeArgs(args: unknown[]): Record<string, unknown>;
+export declare function sanitizeObject(obj: Record<string, unknown>, depth?: number): Record<string, unknown>;

package/lib/core/analytics/sanitize.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitizeArgs = sanitizeArgs;
+exports.sanitizeObject = sanitizeObject;
+const SENSITIVE_KEYS = [
+    'apikey',
+    'api_key',
+    'apiKey',
+    'password',
+    'secret',
+    'token',
+    'bearer',
+    'authorization',
+    'privatekey',
+    'private_key',
+    'privateKey',
+    'mnemonic',
+    'seed',
+];
+function sanitizeArgs(args) {
+    const sanitized = {};
+    args.forEach((arg, index) => {
+        const key = `arg${index}`;
+        if (arg === null || arg === undefined) {
+            sanitized[key] = arg;
+            return;
+        }
+        if (typeof arg === 'string') {
+            sanitized[key] = arg.length > 100 ? `${arg.substring(0, 100)}...` : arg;
+            return;
+        }
+        if (typeof arg === 'number' || typeof arg === 'boolean') {
+            sanitized[key] = arg;
+            return;
+        }
+        if (typeof arg === 'object') {
+            sanitized[key] = sanitizeObject(arg);
+            return;
+        }
+        sanitized[key] = `[${typeof arg}]`;
+    });
+    return sanitized;
+}
+function sanitizeObject(obj, depth = 0) {
+    if (depth > 3) {
+        return { _truncated: true };
+    }
+    const sanitized = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (SENSITIVE_KEYS.some((sk) => key.toLowerCase().includes(sk.toLowerCase()))) {
+            sanitized[key] = '[REDACTED]';
+            continue;
+        }
+        if (value === null || value === undefined) {
+            sanitized[key] = value;
+            continue;
+        }
+        if (typeof value === 'string') {
+            if (value.length > 64 && /^[a-fA-F0-9]+$/.test(value)) {
+                sanitized[key] = '[REDACTED_HEX]';
+                continue;
+            }
+            sanitized[key] =
+                value.length > 100 ? `${value.substring(0, 100)}...` : value;
+            continue;
+        }
+        if (typeof value === 'number' || typeof value === 'boolean') {
+            sanitized[key] = value;
+            continue;
+        }
+        if (Array.isArray(value)) {
+            sanitized[key] =
+                value.length > 10
+                    ? { _type: 'array', length: value.length, _truncated: true }
+                    : value
+                        .slice(0, 10)
+                        .map((v) => typeof v === 'object' && v !== null
+                        ? sanitizeObject(v, depth + 1)
+                        : v);
+            continue;
+        }
+        if (typeof value === 'object') {
+            sanitized[key] = sanitizeObject(value, depth + 1);
+            continue;
+        }
+        sanitized[key] = `[${typeof value}]`;
+    }
+    return sanitized;
+}
+//# sourceMappingURL=sanitize.js.map

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

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

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

@@ -0,0 +1,9 @@
+import * as Sentry from '@sentry/browser';
+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;