@augustdigital/sdk 6.0.1 → 7.0.1

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

@@ -1,6 +1,10 @@
 export type { IAnalyticsConfig, IUserIdentity, IMethodCallMetrics, } from './types';
 export { hashApiKey, getSessionId, generateFingerprint, createUserIdentity, getUserId, } from './user-identity';
-export { initializeSentry, updateUser, clearUser, isAnalyticsEnabled, getSentry, resetAnalytics, } from './sentry';
+export { initializeSentry, updateUser, clearUser, isAnalyticsEnabled, getSentry, resetAnalytics, captureSdkException, } from './sentry';
+export { getSentrySDK, getSentryRuntime } from './sentry-runtime';
+export { readEnv, isAnalyticsDisabledViaEnv, isAnalyticsForcedOnViaEnv, isNodeDevOrTestEnv, } from './env';
 export { trackApiCall, trackNetworkSwitch, getCacheStats, resetCacheStats, } from './metrics';
-export { sanitizeArgs, sanitizeObject } from './sanitize';
+export { sanitizeArgs, sanitizeObject, computeArgShape } from './sanitize';
 export { withMethodTracking, withSyncMethodTracking, instrumentClass, } from './instrumentation';
+export { METHOD_CATEGORIES, getMethodCategory, type MethodCategory, } from './method-taxonomy';
+export { chainIdToTagValue } from './chain-name';

package/lib/core/analytics/index.js

@@ -1,6 +1,6 @@
 "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 = void 0;
+exports.chainIdToTagValue = exports.getMethodCategory = exports.METHOD_CATEGORIES = exports.instrumentClass = exports.withSyncMethodTracking = exports.withMethodTracking = exports.computeArgShape = exports.sanitizeObject = exports.sanitizeArgs = exports.resetCacheStats = exports.getCacheStats = exports.trackNetworkSwitch = exports.trackApiCall = exports.isNodeDevOrTestEnv = exports.isAnalyticsForcedOnViaEnv = exports.isAnalyticsDisabledViaEnv = exports.readEnv = exports.getSentryRuntime = exports.getSentrySDK = exports.captureSdkException = exports.resetAnalytics = exports.getSentry = exports.isAnalyticsEnabled = exports.clearUser = exports.updateUser = exports.initializeSentry = exports.getUserId = exports.createUserIdentity = exports.generateFingerprint = exports.getSessionId = exports.hashApiKey = void 0;
 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; } });
@@ -14,6 +14,15 @@ Object.defineProperty(exports, "clearUser", { enumerable: true, get: function ()
 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; } });
+Object.defineProperty(exports, "captureSdkException", { enumerable: true, get: function () { return sentry_1.captureSdkException; } });
+var sentry_runtime_1 = require("./sentry-runtime");
+Object.defineProperty(exports, "getSentrySDK", { enumerable: true, get: function () { return sentry_runtime_1.getSentrySDK; } });
+Object.defineProperty(exports, "getSentryRuntime", { enumerable: true, get: function () { return sentry_runtime_1.getSentryRuntime; } });
+var env_1 = require("./env");
+Object.defineProperty(exports, "readEnv", { enumerable: true, get: function () { return env_1.readEnv; } });
+Object.defineProperty(exports, "isAnalyticsDisabledViaEnv", { enumerable: true, get: function () { return env_1.isAnalyticsDisabledViaEnv; } });
+Object.defineProperty(exports, "isAnalyticsForcedOnViaEnv", { enumerable: true, get: function () { return env_1.isAnalyticsForcedOnViaEnv; } });
+Object.defineProperty(exports, "isNodeDevOrTestEnv", { enumerable: true, get: function () { return env_1.isNodeDevOrTestEnv; } });
 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; } });
@@ -22,8 +31,14 @@ Object.defineProperty(exports, "resetCacheStats", { enumerable: true, get: funct
 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; } });
+Object.defineProperty(exports, "computeArgShape", { enumerable: true, get: function () { return sanitize_1.computeArgShape; } });
 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; } });
+var method_taxonomy_1 = require("./method-taxonomy");
+Object.defineProperty(exports, "METHOD_CATEGORIES", { enumerable: true, get: function () { return method_taxonomy_1.METHOD_CATEGORIES; } });
+Object.defineProperty(exports, "getMethodCategory", { enumerable: true, get: function () { return method_taxonomy_1.getMethodCategory; } });
+var chain_name_1 = require("./chain-name");
+Object.defineProperty(exports, "chainIdToTagValue", { enumerable: true, get: function () { return chain_name_1.chainIdToTagValue; } });
 //# sourceMappingURL=index.js.map

package/lib/core/analytics/instrumentation.js

@@ -1,58 +1,36 @@
 "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 chain_name_1 = require("./chain-name");
+const method_taxonomy_1 = require("./method-taxonomy");
 const sanitize_1 = require("./sanitize");
+const sentry_runtime_1 = require("./sentry-runtime");
 const sentry_1 = require("./sentry");
 function withMethodTracking(methodName, method, getChainId) {
     return async function trackedMethod(...args) {
         if (!(0, sentry_1.isAnalyticsEnabled)()) {
             return method(...args);
         }
+        const sdk = (0, sentry_runtime_1.getSentrySDK)();
+        if (!sdk) {
+            return method(...args);
+        }
         const startTime = performance.now();
         const chainId = getChainId?.();
+        const category = (0, method_taxonomy_1.getMethodCategory)(methodName);
         const sanitizedArgs = (0, sanitize_1.sanitizeArgs)(args);
+        const argShape = (0, sanitize_1.computeArgShape)(args);
         try {
-            return await Sentry.startSpan({
+            return await sdk.startSpan({
                 op: 'sdk.method',
                 name: methodName,
                 attributes: {
                     chainId: chainId?.toString() || 'unknown',
+                    'sdk.chain': (0, chain_name_1.chainIdToTagValue)(chainId),
+                    'sdk.category': category,
+                    'sdk.argShape': argShape.join('|'),
                     ...sanitizedArgs,
                 },
             }, async (span) => {
@@ -63,10 +41,11 @@ function withMethodTracking(methodName, method, getChainId) {
                     span?.setAttribute('success', true);
                     trackMethodCall(methodName, {
                         method: methodName,
+                        category,
                         chainId,
                         duration,
                         success: true,
-                    }, sanitizedArgs);
+                    }, { ...sanitizedArgs, argShape: argShape.join('|') });
                     span?.setStatus({ code: 1 });
                     return result;
                 }
@@ -78,11 +57,12 @@ function withMethodTracking(methodName, method, getChainId) {
                     span?.setAttribute('error', error instanceof Error ? error.message : String(error));
                     trackMethodCall(methodName, {
                         method: methodName,
+                        category,
                         chainId,
                         duration,
                         success: false,
                         errorType,
-                    }, sanitizedArgs);
+                    }, { ...sanitizedArgs, argShape: argShape.join('|') });
                     span?.setStatus({ code: 2, message: errorType });
                     throw error;
                 }
@@ -98,21 +78,31 @@ function withMethodTracking(methodName, method, getChainId) {
 }
 function trackMethodCall(methodName, metrics, args) {
     try {
-        Sentry.addBreadcrumb({
+        const sdk = (0, sentry_runtime_1.getSentrySDK)();
+        if (!sdk)
+            return;
+        sdk.addBreadcrumb({
             category: 'sdk.method',
             message: methodName,
             level: metrics.success ? 'info' : 'error',
             data: {
                 chainId: metrics.chainId,
+                category: metrics.category,
                 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());
+        sdk.setMeasurement('sdk.method.duration', metrics.duration, 'millisecond');
+        sdk.setMeasurement('sdk.method.invocation', 1, 'none');
+        sdk.setMeasurement('sdk.method.error', metrics.success ? 0 : 1, 'none');
+        sdk.setTag('sdk.last_method', methodName);
+        if (metrics.category) {
+            sdk.setTag('sdk.category', metrics.category);
+        }
+        if (metrics.chainId !== undefined) {
+            sdk.setTag('sdk.chain', (0, chain_name_1.chainIdToTagValue)(metrics.chainId));
+            sdk.setTag('sdk.last_chainId', metrics.chainId.toString());
         }
     }
     catch {
@@ -130,18 +120,25 @@ function withSyncMethodTracking(methodName, method, getChainId) {
         if (!(0, sentry_1.isAnalyticsEnabled)()) {
             return method(...args);
         }
+        const sdk = (0, sentry_runtime_1.getSentrySDK)();
+        if (!sdk) {
+            return method(...args);
+        }
         const startTime = performance.now();
         const chainId = getChainId?.();
+        const category = (0, method_taxonomy_1.getMethodCategory)(methodName);
         const sanitizedArgs = (0, sanitize_1.sanitizeArgs)(args);
+        const argShape = (0, sanitize_1.computeArgShape)(args);
         try {
             const result = method(...args);
             const duration = performance.now() - startTime;
             trackSyncMethodCall(methodName, {
                 method: methodName,
+                category,
                 chainId,
                 duration,
                 success: true,
-            }, sanitizedArgs);
+            }, { ...sanitizedArgs, argShape: argShape.join('|') });
             return result;
         }
         catch (error) {
@@ -149,31 +146,42 @@ function withSyncMethodTracking(methodName, method, getChainId) {
             const errorType = error instanceof Error ? error.name : 'UnknownError';
             trackSyncMethodCall(methodName, {
                 method: methodName,
+                category,
                 chainId,
                 duration,
                 success: false,
                 errorType,
-            }, sanitizedArgs);
+            }, { ...sanitizedArgs, argShape: argShape.join('|') });
             throw error;
         }
     };
 }
 function trackSyncMethodCall(methodName, metrics, args) {
     try {
-        Sentry.addBreadcrumb({
+        const sdk = (0, sentry_runtime_1.getSentrySDK)();
+        if (!sdk)
+            return;
+        sdk.addBreadcrumb({
             category: 'sdk.sync_method',
             message: methodName,
             level: metrics.success ? 'info' : 'error',
             data: {
                 chainId: metrics.chainId,
+                category: metrics.category,
                 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());
+        sdk.setMeasurement('sdk.method.invocation', 1, 'none');
+        sdk.setMeasurement('sdk.method.error', metrics.success ? 0 : 1, 'none');
+        sdk.setTag('sdk.last_sync_method', methodName);
+        if (metrics.category) {
+            sdk.setTag('sdk.category', metrics.category);
+        }
+        if (metrics.chainId !== undefined) {
+            sdk.setTag('sdk.chain', (0, chain_name_1.chainIdToTagValue)(metrics.chainId));
+            sdk.setTag('sdk.last_chainId', metrics.chainId.toString());
         }
     }
     catch {

package/lib/core/analytics/method-taxonomy.d.ts

@@ -0,0 +1,3 @@
+export type MethodCategory = 'read.vault' | 'read.position' | 'read.redemption' | 'read.price' | 'read.points' | 'read.subaccount' | 'read.staking' | 'read.layerzero' | 'read.solana' | 'read.stellar' | 'read.sui' | 'read.evm' | 'write.deposit' | 'write.redeem' | 'write.approve' | 'write.points' | 'write.stellar' | 'network' | 'bridge' | 'unknown';
+export declare const METHOD_CATEGORIES: Readonly<Record<string, MethodCategory>>;
+export declare function getMethodCategory(methodName: string): MethodCategory;

package/lib/core/analytics/method-taxonomy.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.METHOD_CATEGORIES = void 0;
+exports.getMethodCategory = getMethodCategory;
+exports.METHOD_CATEGORIES = {
+    getVault: 'read.vault',
+    getVaults: 'read.vault',
+    getTotalDeposited: 'read.vault',
+    getVaultLoans: 'read.vault',
+    getVaultSubaccountLoans: 'read.vault',
+    getVaultAllocations: 'read.vault',
+    getVaultApy: 'read.vault',
+    getVaultAnnualizedApy: 'read.vault',
+    getVaultTvl: 'read.vault',
+    getVaultHistoricalTimeseries: 'read.vault',
+    getVaultSummary: 'read.vault',
+    getVaultPnl: 'read.vault',
+    getVaultBorrowerHealthFactor: 'read.vault',
+    getYieldLastRealizedOn: 'read.vault',
+    getVaultPositions: 'read.position',
+    getVaultUserHistory: 'read.position',
+    getUserHistory: 'read.position',
+    getVaultUserTransfers: 'read.position',
+    getUserTransfers: 'read.position',
+    getVaultUserLifetimePnl: 'read.position',
+    getVaultAvailableRedemptions: 'read.redemption',
+    getVaultRedemptionHistory: 'read.redemption',
+    getVaultPendingRedemptions: 'read.redemption',
+    getVaultWithdrawals: 'read.redemption',
+    getWithdrawalRequestsWithStatus: 'read.redemption',
+    previewRedemption: 'read.redemption',
+    getPrice: 'read.price',
+    getUserPoints: 'read.points',
+    fetchPointsLeaderboard: 'read.points',
+    getSubaccountHealthFactor: 'read.subaccount',
+    getSubaccountLoans: 'read.subaccount',
+    getSubaccountCefiPositions: 'read.subaccount',
+    getSubaccountOtcPositions: 'read.subaccount',
+    getSubaccountSummary: 'read.subaccount',
+    getStakingPositions: 'read.staking',
+    getVaultStakingPositions: 'read.staking',
+    getLayerZeroDeposits: 'read.layerzero',
+    getLayerZeroRedeems: 'read.layerzero',
+    getVaultState: 'read.solana',
+    getVaultStateReadOnly: 'read.solana',
+    getToken: 'read.solana',
+    getTokenSymbol: 'read.solana',
+    fetchUserTokenBalance: 'read.solana',
+    fetchUserShareBalance: 'read.solana',
+    fetchUserShareBalanceRaw: 'read.solana',
+    submitTransaction: 'write.stellar',
+    getUserPosition: 'read.stellar',
+    convertToShares: 'read.stellar',
+    getEmberVaults: 'read.sui',
+    getEmberTVL: 'read.sui',
+    vaultAllowance: 'read.evm',
+    sendersWhitelistAddress: 'read.evm',
+    isWhitelisted: 'read.evm',
+    getDeposited: 'read.evm',
+    getRemainingAllocations: 'read.evm',
+    previewDeposit: 'read.vault',
+    previewRedeem: 'read.redemption',
+    allowance: 'read.evm',
+    balanceOf: 'read.evm',
+    maxDeposit: 'read.vault',
+    vaultDeposit: 'write.deposit',
+    depositNative: 'write.deposit',
+    vaultRedeem: 'write.redeem',
+    vaultRequestRedeem: 'write.redeem',
+    rwaRedeemAsset: 'write.redeem',
+    vaultApprove: 'write.approve',
+    approve: 'write.approve',
+    registerUserForPoints: 'write.points',
+    switchNetwork: 'network',
+    updateWallet: 'network',
+    clearWallet: 'network',
+    setSigner: 'network',
+};
+function getMethodCategory(methodName) {
+    return exports.METHOD_CATEGORIES[methodName] ?? 'unknown';
+}
+//# sourceMappingURL=method-taxonomy.js.map

package/lib/core/analytics/metrics.js

@@ -1,43 +1,11 @@
 "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 chain_name_1 = require("./chain-name");
+const sentry_runtime_1 = require("./sentry-runtime");
 const sentry_1 = require("./sentry");
 let cacheStats = {
     hits: 0,
@@ -48,9 +16,12 @@ function trackApiCall(endpoint, method, startTime, status, server) {
     if (!(0, sentry_1.isAnalyticsEnabled)())
         return;
     try {
+        const sdk = (0, sentry_runtime_1.getSentrySDK)();
+        if (!sdk)
+            return;
         const duration = performance.now() - startTime;
         const normalizedEndpoint = normalizeEndpoint(endpoint);
-        Sentry.addBreadcrumb({
+        sdk.addBreadcrumb({
             category: 'api',
             message: `${method} ${normalizedEndpoint}`,
             level: status >= 400 || status === 0 ? 'error' : 'info',
@@ -62,9 +33,9 @@ function trackApiCall(endpoint, method, startTime, status, server) {
                 server,
             },
         });
-        Sentry.setMeasurement('api.duration', duration, 'millisecond');
-        Sentry.setTag('api.last_endpoint', normalizedEndpoint);
-        Sentry.setTag('api.server', server);
+        sdk.setMeasurement('api.duration', duration, 'millisecond');
+        sdk.setTag('api.last_endpoint', normalizedEndpoint);
+        sdk.setTag('api.server', server);
     }
     catch {
     }
@@ -73,13 +44,18 @@ function trackNetworkSwitch(chainId) {
     if (!(0, sentry_1.isAnalyticsEnabled)())
         return;
     try {
-        Sentry.addBreadcrumb({
+        const sdk = (0, sentry_runtime_1.getSentrySDK)();
+        if (!sdk)
+            return;
+        const chainLabel = (0, chain_name_1.chainIdToTagValue)(chainId);
+        sdk.addBreadcrumb({
             category: 'network',
-            message: `Switched to chain ${chainId}`,
+            message: `Switched to chain ${chainId} (${chainLabel})`,
             level: 'info',
-            data: { chainId },
+            data: { chainId, chain: chainLabel },
         });
-        Sentry.setTag('active.chainId', chainId.toString());
+        sdk.setTag('active.chainId', chainId.toString());
+        sdk.setTag('sdk.chain', chainLabel);
     }
     catch {
     }

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

@@ -1,5 +1,6 @@
 export declare function sanitizeString(input: string): string;
 export declare function sanitizeError(err: unknown): unknown;
 export declare function sanitizeForLogging(input: unknown, depth?: number): unknown;
+export declare function computeArgShape(args: unknown[]): string[];
 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

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.sanitizeString = sanitizeString;
 exports.sanitizeError = sanitizeError;
 exports.sanitizeForLogging = sanitizeForLogging;
+exports.computeArgShape = computeArgShape;
 exports.sanitizeArgs = sanitizeArgs;
 exports.sanitizeObject = sanitizeObject;
 const SENSITIVE_KEYS = [
@@ -91,6 +92,39 @@ function sanitizeForLogging(input, depth = 0) {
     }
     return `[${typeof input}]`;
 }
+function computeArgShape(args) {
+    return args.map((arg) => shapeOf(arg));
+}
+function shapeOf(value) {
+    if (value === null)
+        return 'null';
+    if (value === undefined)
+        return 'undefined';
+    const t = typeof value;
+    if (t === 'boolean' || t === 'number' || t === 'bigint' || t === 'function') {
+        return t;
+    }
+    if (t === 'string') {
+        const s = value;
+        if (/^0x[a-fA-F0-9]{40}$/.test(s))
+            return 'address';
+        if (/^0x[a-fA-F0-9]{64}$/.test(s))
+            return 'tx-hash';
+        if (/^0x[a-fA-F0-9]{6,}$/.test(s))
+            return 'hex';
+        return 'string';
+    }
+    if (Array.isArray(value)) {
+        return `array(${value.length})`;
+    }
+    if (t === 'object') {
+        const keys = Object.keys(value).sort();
+        const capped = keys.slice(0, 12);
+        const more = keys.length > 12 ? `,+${keys.length - 12}` : '';
+        return `options{${capped.join(',')}${more}}`;
+    }
+    return t;
+}
 function sanitizeArgs(args) {
     const sanitized = {};
     args.forEach((arg, index) => {

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

@@ -0,0 +1,4 @@
+import type * as SentryBrowser from '@sentry/browser';
+export declare function getSentrySDK(): typeof SentryBrowser | null;
+export declare function getSentryRuntime(): 'browser' | 'node' | 'unknown';
+export declare function resetSentryRuntime(): void;

package/lib/core/analytics/sentry-runtime.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSentrySDK = getSentrySDK;
+exports.getSentryRuntime = getSentryRuntime;
+exports.resetSentryRuntime = resetSentryRuntime;
+const logger_1 = require("../logger");
+let cachedSdk = null;
+let detectedRuntime = 'unknown';
+function detectRuntime() {
+    try {
+        if (typeof window !== 'undefined' &&
+            typeof window.document !== 'undefined') {
+            return 'browser';
+        }
+        if (typeof process !== 'undefined' &&
+            !!process.versions?.node &&
+            typeof window === 'undefined') {
+            return 'node';
+        }
+    }
+    catch {
+    }
+    return 'unknown';
+}
+function getNodeRequire() {
+    try {
+        const req = new Function('return typeof require === "function" ? require : null')();
+        return typeof req === 'function' ? req : null;
+    }
+    catch {
+        return null;
+    }
+}
+function loadSentrySDK() {
+    if (cachedSdk)
+        return cachedSdk;
+    detectedRuntime = detectRuntime();
+    if (detectedRuntime === 'node') {
+        const nodeRequire = getNodeRequire();
+        if (nodeRequire) {
+            try {
+                cachedSdk = nodeRequire('@sentry/node');
+                return cachedSdk;
+            }
+            catch (err) {
+                logger_1.Logger.log.warn('analytics.runtime.sentry-node-missing', {
+                    error: err instanceof Error ? err.message : String(err),
+                    hint: 'Add @sentry/node to your dependencies for full Node telemetry coverage.',
+                });
+            }
+        }
+    }
+    try {
+        cachedSdk = require('@sentry/browser');
+    }
+    catch (err) {
+        logger_1.Logger.log.warn('analytics.runtime.sentry-browser-missing', {
+            runtime: detectedRuntime,
+            error: err instanceof Error ? err.message : String(err),
+        });
+        cachedSdk = null;
+    }
+    return cachedSdk;
+}
+function getSentrySDK() {
+    return loadSentrySDK();
+}
+function getSentryRuntime() {
+    if (detectedRuntime === 'unknown') {
+        detectedRuntime = detectRuntime();
+    }
+    return detectedRuntime;
+}
+function resetSentryRuntime() {
+    cachedSdk = null;
+    detectedRuntime = 'unknown';
+}
+//# sourceMappingURL=sentry-runtime.js.map

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

@@ -1,4 +1,4 @@
-import * as Sentry from '@sentry/browser';
+import type * 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, appName?: string): void;
@@ -7,3 +7,9 @@ export declare function clearUser(): void;
 export declare function isAnalyticsEnabled(): boolean;
 export declare function getSentry(): typeof Sentry | null;
 export declare function resetAnalytics(): void;
+export declare function captureSdkException(error: unknown, options?: {
+    surface?: 'cli' | 'sdk' | 'react' | string;
+    tags?: Record<string, string>;
+    extra?: Record<string, unknown>;
+    flushTimeoutMs?: number;
+}): Promise<void>;