@augustdigital/sdk 4.17.0 → 4.17.1-alpha.0

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

@@ -0,0 +1,38 @@
+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';
+};
+export declare const METHOD_CATEGORIES: {
+  readonly read: readonly [
+    'getVaults',
+    'getVault',
+    'getVaultLoans',
+    'getVaultAllocations',
+    'getVaultApy',
+    'getVaultTvl',
+    'getVaultHistoricalTimeseries',
+    'getVaultPositions',
+    'getVaultUserHistory',
+    'getVaultUserTransfers',
+    'getVaultUserLifetimePnl',
+    'getVaultPnl',
+    'getVaultStakingPositions',
+    'getUserPoints',
+    'getPrice',
+    'getVaultAvailableRedemptions',
+    'getVaultBorrowerHealthFactor',
+    'fetchPointsLeaderboard',
+    'getVaultAnnualizedApy',
+    'getVaultSummary',
+    'getVaultWithdrawals',
+    'previewRedemption',
+    'getTotalDeposited',
+    'getYieldLastRealizedOn',
+  ];
+  readonly write: readonly ['vaultDeposit', 'registerUserForPoints'];
+  readonly state: readonly ['switchNetwork', 'updateWallet', 'clearWallet'];
+};
+export declare function getMethodCategory(methodName: string): string;

package/lib/core/analytics/constants.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.METHOD_CATEGORIES = exports.SENTRY_CONFIG = exports.SENTRY_DSN = void 0;
+exports.getMethodCategory = getMethodCategory;
+exports.SENTRY_DSN = 'https://d73b6a85fe14960b8dac8ac61a743a94@o4507215496609792.ingest.de.sentry.io/4510699327389776';
+exports.SENTRY_CONFIG = {
+    tracesSampleRate: 0.1,
+    enableTracing: true,
+    environment: 'production',
+};
+exports.METHOD_CATEGORIES = {
+    read: [
+        'getVaults',
+        'getVault',
+        'getVaultLoans',
+        'getVaultAllocations',
+        'getVaultApy',
+        'getVaultTvl',
+        'getVaultHistoricalTimeseries',
+        'getVaultPositions',
+        'getVaultUserHistory',
+        'getVaultUserTransfers',
+        'getVaultUserLifetimePnl',
+        'getVaultPnl',
+        'getVaultStakingPositions',
+        'getUserPoints',
+        'getPrice',
+        'getVaultAvailableRedemptions',
+        'getVaultBorrowerHealthFactor',
+        'fetchPointsLeaderboard',
+        'getVaultAnnualizedApy',
+        'getVaultSummary',
+        'getVaultWithdrawals',
+        'previewRedemption',
+        'getTotalDeposited',
+        'getYieldLastRealizedOn',
+    ],
+    write: ['vaultDeposit', 'registerUserForPoints'],
+    state: ['switchNetwork', 'updateWallet', 'clearWallet'],
+};
+function getMethodCategory(methodName) {
+    for (const [category, methods] of Object.entries(exports.METHOD_CATEGORIES)) {
+        if (methods.includes(methodName)) {
+            return category;
+        }
+    }
+    return 'other';
+}
+//# 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":";;;AA2DA,8CAOC;AA9DY,QAAA,UAAU,GACrB,iGAAiG,CAAC;AAKvF,QAAA,aAAa,GAAG;IAE3B,gBAAgB,EAAE,GAAG;IAErB,aAAa,EAAE,IAAI;IAEnB,WAAW,EAAE,YAAY;CACjB,CAAC;AAKE,QAAA,iBAAiB,GAAG;IAE/B,IAAI,EAAE;QACJ,WAAW;QACX,UAAU;QACV,eAAe;QACf,qBAAqB;QACrB,aAAa;QACb,aAAa;QACb,8BAA8B;QAC9B,mBAAmB;QACnB,qBAAqB;QACrB,uBAAuB;QACvB,yBAAyB;QACzB,aAAa;QACb,0BAA0B;QAC1B,eAAe;QACf,UAAU;QACV,8BAA8B;QAC9B,8BAA8B;QAC9B,wBAAwB;QACxB,uBAAuB;QACvB,iBAAiB;QACjB,qBAAqB;QACrB,mBAAmB;QACnB,mBAAmB;QACnB,wBAAwB;KACzB;IAED,KAAK,EAAE,CAAC,cAAc,EAAE,uBAAuB,CAAC;IAEhD,KAAK,EAAE,CAAC,eAAe,EAAE,cAAc,EAAE,aAAa,CAAC;CAC/C,CAAC;AAKX,SAAgB,iBAAiB,CAAC,UAAkB;IAClD,KAAK,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,yBAAiB,CAAC,EAAE,CAAC;QACpE,IAAK,OAA6B,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YACxD,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

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

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,7 @@
+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/browser"));
+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,21 @@
+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/browser"));
+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,17 @@
+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;