@gala-chain/launchpad-sdk 5.0.2-beta.1 → 5.0.4-beta.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/EXAMPLES.md +141 -7
- package/README.md +68 -36
- package/dist/ai-docs.json +7357 -0
- package/dist/index.cjs.js +1 -1
- package/dist/index.d.ts +70 -11
- package/dist/index.d.ts.map +1 -1
- package/dist/index.esm.js +1 -1
- package/dist/index.js +1 -1
- package/dist/src/LaunchpadSDK.d.ts +3288 -214
- package/dist/src/LaunchpadSDK.d.ts.map +1 -1
- package/dist/src/api/LaunchpadAPI.d.ts +21 -41
- package/dist/src/api/LaunchpadAPI.d.ts.map +1 -1
- package/dist/src/api/dto/BurnTokensDto.d.ts.map +1 -1
- package/dist/src/api/dto/LockTokenDto.d.ts.map +1 -1
- package/dist/src/api/dto/TransferTokenDto.d.ts.map +1 -1
- package/dist/src/api/dto/UnlockTokenDto.d.ts.map +1 -1
- package/dist/src/auth/JwtAuth.d.ts +145 -0
- package/dist/src/auth/JwtAuth.d.ts.map +1 -0
- package/dist/src/auth/SessionAuthService.d.ts +146 -0
- package/dist/src/auth/SessionAuthService.d.ts.map +1 -0
- package/dist/src/auth/SignatureAuth.d.ts.map +1 -1
- package/dist/src/bridge/BridgeService.d.ts.map +1 -1
- package/dist/src/bridge/GalaConnectClient.d.ts.map +1 -1
- package/dist/src/bridge/constants/tokens.d.ts +4 -3
- package/dist/src/bridge/constants/tokens.d.ts.map +1 -1
- package/dist/src/bridge/index.d.ts +1 -0
- package/dist/src/bridge/index.d.ts.map +1 -1
- package/dist/src/bridge/strategies/BridgeStrategy.d.ts.map +1 -1
- package/dist/src/bridge/strategies/EthereumBridgeStrategy.d.ts +1 -38
- package/dist/src/bridge/strategies/EthereumBridgeStrategy.d.ts.map +1 -1
- package/dist/src/bridge/strategies/SolanaBridgeStrategy.d.ts +1 -21
- package/dist/src/bridge/strategies/SolanaBridgeStrategy.d.ts.map +1 -1
- package/dist/src/bridge/types/bridge.dto.d.ts +15 -2
- package/dist/src/bridge/types/bridge.dto.d.ts.map +1 -1
- package/dist/src/bridge/utils/RateLimiter.d.ts +1 -1
- package/dist/src/bridge/utils/RateLimiter.d.ts.map +1 -1
- package/dist/src/bridge/utils/address-formatter.d.ts +25 -0
- package/dist/src/bridge/utils/address-formatter.d.ts.map +1 -0
- package/dist/src/bridge/utils/addressValidation.d.ts +200 -0
- package/dist/src/bridge/utils/addressValidation.d.ts.map +1 -0
- package/dist/src/bridge/utils/balanceHelpers.d.ts +215 -0
- package/dist/src/bridge/utils/balanceHelpers.d.ts.map +1 -0
- package/dist/src/bridge/utils/bridgeErrors.d.ts +98 -0
- package/dist/src/bridge/utils/bridgeErrors.d.ts.map +1 -0
- package/dist/src/bridge/utils/bridgeOutHelpers.d.ts +68 -0
- package/dist/src/bridge/utils/bridgeOutHelpers.d.ts.map +1 -0
- package/dist/src/bridge/utils/bridgePayload.d.ts +107 -0
- package/dist/src/bridge/utils/bridgePayload.d.ts.map +1 -0
- package/dist/src/bridge/utils/bridgeStatusParser.d.ts +75 -0
- package/dist/src/bridge/utils/bridgeStatusParser.d.ts.map +1 -0
- package/dist/src/bridge/utils/eip712Helpers.d.ts +66 -0
- package/dist/src/bridge/utils/eip712Helpers.d.ts.map +1 -0
- package/dist/src/bridge/utils/index.d.ts +9 -0
- package/dist/src/bridge/utils/index.d.ts.map +1 -1
- package/dist/src/bridge/utils/retry.d.ts +16 -0
- package/dist/src/bridge/utils/retry.d.ts.map +1 -1
- package/dist/src/bridge/utils/strategyDelegation.d.ts +69 -0
- package/dist/src/bridge/utils/strategyDelegation.d.ts.map +1 -0
- package/dist/src/bridge/utils/tokenIdUtils.d.ts +7 -0
- package/dist/src/bridge/utils/tokenIdUtils.d.ts.map +1 -1
- package/dist/src/bridge/utils/tokenMath.d.ts.map +1 -1
- package/dist/src/bridge/utils/tokenMetadataResolver.d.ts +97 -0
- package/dist/src/bridge/utils/tokenMetadataResolver.d.ts.map +1 -0
- package/dist/src/constants/endpoints.d.ts +453 -0
- package/dist/src/constants/endpoints.d.ts.map +1 -1
- package/dist/src/constants/error-messages.d.ts +1 -1
- package/dist/src/constants/error-messages.d.ts.map +1 -1
- package/dist/src/constants/jwt.d.ts +41 -0
- package/dist/src/constants/jwt.d.ts.map +1 -0
- package/dist/src/constants/sdk-defaults.d.ts +37 -0
- package/dist/src/constants/sdk-defaults.d.ts.map +1 -0
- package/dist/src/constants/version.generated.d.ts +1 -1
- package/dist/src/helpers/sdk.d.ts.map +1 -1
- package/dist/src/helpers/wallet.d.ts +4 -3
- package/dist/src/helpers/wallet.d.ts.map +1 -1
- package/dist/src/index.d.ts +70 -11
- package/dist/src/index.d.ts.map +1 -1
- package/dist/src/schemas/files.d.ts +2 -2
- package/dist/src/schemas/launchpad.d.ts +40 -8
- package/dist/src/schemas/launchpad.d.ts.map +1 -1
- package/dist/src/schemas/pagination.d.ts +7 -7
- package/dist/src/schemas/primitives.d.ts.map +1 -1
- package/dist/src/schemas/trade.d.ts +6 -6
- package/dist/src/schemas/user.d.ts +4 -4
- package/dist/src/schemas/validators.d.ts +15 -7
- package/dist/src/schemas/validators.d.ts.map +1 -1
- package/dist/src/services/AbstractCacheService.d.ts +227 -0
- package/dist/src/services/AbstractCacheService.d.ts.map +1 -0
- package/dist/src/services/AbstractTokenFetchService.d.ts +150 -0
- package/dist/src/services/AbstractTokenFetchService.d.ts.map +1 -0
- package/dist/src/services/ApiKeyService.d.ts +205 -0
- package/dist/src/services/ApiKeyService.d.ts.map +1 -0
- package/dist/src/services/BanService.d.ts +195 -0
- package/dist/src/services/BanService.d.ts.map +1 -0
- package/dist/src/services/BaseService.d.ts +50 -3
- package/dist/src/services/BaseService.d.ts.map +1 -1
- package/dist/src/services/BatchedCacheService.d.ts +132 -0
- package/dist/src/services/BatchedCacheService.d.ts.map +1 -0
- package/dist/src/services/BridgeableTokenCache.d.ts +32 -98
- package/dist/src/services/BridgeableTokenCache.d.ts.map +1 -1
- package/dist/src/services/BridgeableTokenService.d.ts +18 -13
- package/dist/src/services/BridgeableTokenService.d.ts.map +1 -1
- package/dist/src/services/BundleService.d.ts.map +1 -1
- package/dist/src/services/BundlerClientFactory.d.ts +32 -0
- package/dist/src/services/BundlerClientFactory.d.ts.map +1 -0
- package/dist/src/services/ChatMessagesService.d.ts +152 -0
- package/dist/src/services/ChatMessagesService.d.ts.map +1 -0
- package/dist/src/services/CommentService.d.ts +119 -0
- package/dist/src/services/CommentService.d.ts.map +1 -0
- package/dist/src/services/CommentsService.d.ts +155 -0
- package/dist/src/services/CommentsService.d.ts.map +1 -0
- package/dist/src/services/ContentFlagService.d.ts +212 -0
- package/dist/src/services/ContentFlagService.d.ts.map +1 -0
- package/dist/src/services/ContentReactionService.d.ts +175 -0
- package/dist/src/services/ContentReactionService.d.ts.map +1 -0
- package/dist/src/services/DexBackendClient.d.ts.map +1 -1
- package/dist/src/services/DexPoolService.d.ts +3 -3
- package/dist/src/services/DexPoolService.d.ts.map +1 -1
- package/dist/src/services/DexQuoteService.d.ts.map +1 -1
- package/dist/src/services/DexService.d.ts +2 -5
- package/dist/src/services/DexService.d.ts.map +1 -1
- package/dist/src/services/GSwapAssetService.d.ts +80 -0
- package/dist/src/services/GSwapAssetService.d.ts.map +1 -0
- package/dist/src/services/GSwapLiquidityMutationService.d.ts +140 -0
- package/dist/src/services/GSwapLiquidityMutationService.d.ts.map +1 -0
- package/dist/src/services/GSwapLiquidityQueryService.d.ts +87 -0
- package/dist/src/services/GSwapLiquidityQueryService.d.ts.map +1 -0
- package/dist/src/services/GSwapPoolCalculationService.d.ts +200 -0
- package/dist/src/services/GSwapPoolCalculationService.d.ts.map +1 -0
- package/dist/src/services/GSwapPoolQueryService.d.ts +116 -0
- package/dist/src/services/GSwapPoolQueryService.d.ts.map +1 -0
- package/dist/src/services/GSwapService.d.ts +14 -0
- package/dist/src/services/GSwapService.d.ts.map +1 -1
- package/dist/src/services/GSwapSwapService.d.ts +68 -0
- package/dist/src/services/GSwapSwapService.d.ts.map +1 -0
- package/dist/src/services/GalaChainBalanceService.d.ts +155 -0
- package/dist/src/services/GalaChainBalanceService.d.ts.map +1 -0
- package/dist/src/services/GalaChainGatewayClient.d.ts +32 -1
- package/dist/src/services/GalaChainGatewayClient.d.ts.map +1 -1
- package/dist/src/services/GalaChainLockService.d.ts +144 -0
- package/dist/src/services/GalaChainLockService.d.ts.map +1 -0
- package/dist/src/services/GalaChainService.d.ts +23 -106
- package/dist/src/services/GalaChainService.d.ts.map +1 -1
- package/dist/src/services/GalaChainTokenService.d.ts +108 -0
- package/dist/src/services/GalaChainTokenService.d.ts.map +1 -0
- package/dist/src/services/GalaChainTransferService.d.ts +205 -0
- package/dist/src/services/GalaChainTransferService.d.ts.map +1 -0
- package/dist/src/services/ImageService.d.ts +24 -8
- package/dist/src/services/ImageService.d.ts.map +1 -1
- package/dist/src/services/LaunchpadService.d.ts +77 -5
- package/dist/src/services/LaunchpadService.d.ts.map +1 -1
- package/dist/src/services/ModeratorService.d.ts +269 -0
- package/dist/src/services/ModeratorService.d.ts.map +1 -0
- package/dist/src/services/MultiPoolStateManager.d.ts +4 -6
- package/dist/src/services/MultiPoolStateManager.d.ts.map +1 -1
- package/dist/src/services/NetworkKeyedCacheService.d.ts +185 -0
- package/dist/src/services/NetworkKeyedCacheService.d.ts.map +1 -0
- package/dist/src/services/OverseerService.d.ts +322 -0
- package/dist/src/services/OverseerService.d.ts.map +1 -0
- package/dist/src/services/PoolCacheManager.d.ts +2 -2
- package/dist/src/services/PoolCacheManager.d.ts.map +1 -1
- package/dist/src/services/PoolService.d.ts +61 -7
- package/dist/src/services/PoolService.d.ts.map +1 -1
- package/dist/src/services/PoolStateManager.d.ts +2 -2
- package/dist/src/services/PoolStateManager.d.ts.map +1 -1
- package/dist/src/services/PriceHistoryService.d.ts.map +1 -1
- package/dist/src/services/SignatureService.d.ts.map +1 -1
- package/dist/src/services/StreamChatService.d.ts +378 -0
- package/dist/src/services/StreamChatService.d.ts.map +1 -0
- package/dist/src/services/StreamTokenServiceBase.d.ts +371 -0
- package/dist/src/services/StreamTokenServiceBase.d.ts.map +1 -0
- package/dist/src/services/StreamWebSocketService.d.ts +268 -0
- package/dist/src/services/StreamWebSocketService.d.ts.map +1 -0
- package/dist/src/services/StreamingEventService.d.ts +431 -0
- package/dist/src/services/StreamingEventService.d.ts.map +1 -0
- package/dist/src/services/StreamingService.d.ts +547 -0
- package/dist/src/services/StreamingService.d.ts.map +1 -0
- package/dist/src/services/SwapEventQueue.d.ts +2 -2
- package/dist/src/services/SwapEventQueue.d.ts.map +1 -1
- package/dist/src/services/TokenBanService.d.ts +214 -0
- package/dist/src/services/TokenBanService.d.ts.map +1 -0
- package/dist/src/services/TokenClassKeyService.d.ts.map +1 -1
- package/dist/src/services/TokenMetadataCache.d.ts +36 -27
- package/dist/src/services/TokenMetadataCache.d.ts.map +1 -1
- package/dist/src/services/TokenMetadataService.d.ts +24 -4
- package/dist/src/services/TokenMetadataService.d.ts.map +1 -1
- package/dist/src/services/TokenResolverService.d.ts.map +1 -1
- package/dist/src/services/TradeService.d.ts +73 -0
- package/dist/src/services/TradeService.d.ts.map +1 -1
- package/dist/src/services/UserService.d.ts +56 -3
- package/dist/src/services/UserService.d.ts.map +1 -1
- package/dist/src/services/WebSocketService.d.ts +3 -3
- package/dist/src/services/WebSocketService.d.ts.map +1 -1
- package/dist/src/services/WrapService.d.ts +18 -5
- package/dist/src/services/WrapService.d.ts.map +1 -1
- package/dist/src/services/WrappableTokenCache.d.ts +8 -36
- package/dist/src/services/WrappableTokenCache.d.ts.map +1 -1
- package/dist/src/services/WrappableTokenService.d.ts +18 -12
- package/dist/src/services/WrappableTokenService.d.ts.map +1 -1
- package/dist/src/services/shared/cache-helpers.d.ts +188 -0
- package/dist/src/services/shared/cache-helpers.d.ts.map +1 -0
- package/dist/src/services/shared/http-helpers.d.ts +146 -0
- package/dist/src/services/shared/http-helpers.d.ts.map +1 -0
- package/dist/src/services/shared/pagination-helpers.d.ts +157 -0
- package/dist/src/services/shared/pagination-helpers.d.ts.map +1 -0
- package/dist/src/services/shared/service-validators.d.ts +137 -0
- package/dist/src/services/shared/service-validators.d.ts.map +1 -0
- package/dist/src/services/shared/websocket-helpers.d.ts +158 -0
- package/dist/src/services/shared/websocket-helpers.d.ts.map +1 -0
- package/dist/src/test-constants.d.ts +29 -0
- package/dist/src/test-constants.d.ts.map +1 -0
- package/dist/src/types/api-key.dto.d.ts +300 -0
- package/dist/src/types/api-key.dto.d.ts.map +1 -0
- package/dist/src/types/backend-responses.d.ts +12 -0
- package/dist/src/types/backend-responses.d.ts.map +1 -1
- package/dist/src/types/ban.dto.d.ts +413 -0
- package/dist/src/types/ban.dto.d.ts.map +1 -0
- package/dist/src/types/burn.dto.d.ts +21 -0
- package/dist/src/types/burn.dto.d.ts.map +1 -1
- package/dist/src/types/chat-messages.dto.d.ts +193 -0
- package/dist/src/types/chat-messages.dto.d.ts.map +1 -0
- package/dist/src/types/comment.dto.d.ts +180 -0
- package/dist/src/types/comment.dto.d.ts.map +1 -0
- package/dist/src/types/comments.dto.d.ts +210 -0
- package/dist/src/types/comments.dto.d.ts.map +1 -0
- package/dist/src/types/common.d.ts +369 -0
- package/dist/src/types/common.d.ts.map +1 -1
- package/dist/src/types/constraints.d.ts +374 -0
- package/dist/src/types/constraints.d.ts.map +1 -0
- package/dist/src/types/content-flag.dto.d.ts +310 -0
- package/dist/src/types/content-flag.dto.d.ts.map +1 -0
- package/dist/src/types/content-reactions.dto.d.ts +132 -0
- package/dist/src/types/content-reactions.dto.d.ts.map +1 -0
- package/dist/src/types/dex-pool.dto.d.ts +13 -37
- package/dist/src/types/dex-pool.dto.d.ts.map +1 -1
- package/dist/src/types/dto.d.ts +8 -0
- package/dist/src/types/dto.d.ts.map +1 -1
- package/dist/src/types/galachain-api.types.d.ts +30 -0
- package/dist/src/types/galachain-api.types.d.ts.map +1 -1
- package/dist/src/types/gswap-responses.types.d.ts.map +1 -1
- package/dist/src/types/launchpad.dto.d.ts +234 -131
- package/dist/src/types/launchpad.dto.d.ts.map +1 -1
- package/dist/src/types/launchpad.validation.d.ts.map +1 -1
- package/dist/src/types/lock.dto.d.ts +20 -35
- package/dist/src/types/lock.dto.d.ts.map +1 -1
- package/dist/src/types/moderator.dto.d.ts +581 -0
- package/dist/src/types/moderator.dto.d.ts.map +1 -0
- package/dist/src/types/options.dto.d.ts +25 -115
- package/dist/src/types/options.dto.d.ts.map +1 -1
- package/dist/src/types/overseer.dto.d.ts +420 -0
- package/dist/src/types/overseer.dto.d.ts.map +1 -0
- package/dist/src/types/pool.dto.d.ts +106 -0
- package/dist/src/types/pool.dto.d.ts.map +1 -0
- package/dist/src/types/result.types.d.ts +3 -2
- package/dist/src/types/result.types.d.ts.map +1 -1
- package/dist/src/types/session-auth.dto.d.ts +91 -0
- package/dist/src/types/session-auth.dto.d.ts.map +1 -0
- package/dist/src/types/stream-chat.dto.d.ts +815 -0
- package/dist/src/types/stream-chat.dto.d.ts.map +1 -0
- package/dist/src/types/streaming-events.dto.d.ts +586 -0
- package/dist/src/types/streaming-events.dto.d.ts.map +1 -0
- package/dist/src/types/streaming.dto.d.ts +1141 -0
- package/dist/src/types/streaming.dto.d.ts.map +1 -0
- package/dist/src/types/token-ban.dto.d.ts +195 -0
- package/dist/src/types/token-ban.dto.d.ts.map +1 -0
- package/dist/src/types/trade.dto.d.ts +21 -61
- package/dist/src/types/trade.dto.d.ts.map +1 -1
- package/dist/src/types/trades-query.dto.d.ts +127 -0
- package/dist/src/types/trades-query.dto.d.ts.map +1 -0
- package/dist/src/types/transfer.dto.d.ts +20 -15
- package/dist/src/types/transfer.dto.d.ts.map +1 -1
- package/dist/src/types/user.dto.d.ts +185 -73
- package/dist/src/types/user.dto.d.ts.map +1 -1
- package/dist/src/types/wrappable-token.dto.d.ts +6 -2
- package/dist/src/types/wrappable-token.dto.d.ts.map +1 -1
- package/dist/src/utils/LiquidityEventExtractor.d.ts.map +1 -1
- package/dist/src/utils/Logger.d.ts.map +1 -1
- package/dist/src/utils/MonitoringMetrics.d.ts.map +1 -1
- package/dist/src/utils/PoolKeyNormalizer.d.ts.map +1 -1
- package/dist/src/utils/ReconnectionManager.d.ts +142 -0
- package/dist/src/utils/ReconnectionManager.d.ts.map +1 -0
- package/dist/src/utils/SignatureHelper.d.ts +9 -0
- package/dist/src/utils/SignatureHelper.d.ts.map +1 -1
- package/dist/src/utils/SwapEventExtractor.d.ts.map +1 -1
- package/dist/src/utils/adapters.d.ts.map +1 -1
- package/dist/src/utils/address-formatter.d.ts +317 -0
- package/dist/src/utils/address-formatter.d.ts.map +1 -0
- package/dist/src/utils/agent-config.d.ts.map +1 -1
- package/dist/src/utils/amount-validator.d.ts +268 -0
- package/dist/src/utils/amount-validator.d.ts.map +1 -0
- package/dist/src/utils/api-patterns.d.ts +347 -0
- package/dist/src/utils/api-patterns.d.ts.map +1 -0
- package/dist/src/utils/array-helpers.d.ts +115 -0
- package/dist/src/utils/array-helpers.d.ts.map +1 -0
- package/dist/src/utils/async-patterns.d.ts +272 -0
- package/dist/src/utils/async-patterns.d.ts.map +1 -0
- package/dist/src/utils/auto-pagination.d.ts +195 -2
- package/dist/src/utils/auto-pagination.d.ts.map +1 -1
- package/dist/src/utils/bignumber-helpers.d.ts +119 -13
- package/dist/src/utils/bignumber-helpers.d.ts.map +1 -1
- package/dist/src/utils/bignumber-pool-cache.d.ts.map +1 -1
- package/dist/src/utils/bondingCurveCalculations.d.ts.map +1 -1
- package/dist/src/utils/cacheWarmingHelpers.d.ts +2 -2
- package/dist/src/utils/cacheWarmingHelpers.d.ts.map +1 -1
- package/dist/src/utils/data-transform-patterns.d.ts +393 -0
- package/dist/src/utils/data-transform-patterns.d.ts.map +1 -0
- package/dist/src/utils/date-utils.d.ts +166 -0
- package/dist/src/utils/date-utils.d.ts.map +1 -1
- package/dist/src/utils/delimiter-parser.d.ts +139 -0
- package/dist/src/utils/delimiter-parser.d.ts.map +1 -0
- package/dist/src/utils/error-factories.d.ts +346 -1
- package/dist/src/utils/error-factories.d.ts.map +1 -1
- package/dist/src/utils/error-handling-patterns.d.ts +390 -0
- package/dist/src/utils/error-handling-patterns.d.ts.map +1 -0
- package/dist/src/utils/error-patterns.d.ts +360 -0
- package/dist/src/utils/error-patterns.d.ts.map +1 -0
- package/dist/src/utils/error-utils.d.ts +250 -0
- package/dist/src/utils/error-utils.d.ts.map +1 -1
- package/dist/src/utils/error-wrapper.d.ts +208 -0
- package/dist/src/utils/error-wrapper.d.ts.map +1 -0
- package/dist/src/utils/errors.d.ts +70 -0
- package/dist/src/utils/errors.d.ts.map +1 -1
- package/dist/src/utils/http-factory.d.ts +36 -0
- package/dist/src/utils/http-factory.d.ts.map +1 -0
- package/dist/src/utils/http.d.ts.map +1 -1
- package/dist/src/utils/load-env.d.ts.map +1 -1
- package/dist/src/utils/multipart.d.ts.map +1 -1
- package/dist/src/utils/numeric-patterns.d.ts +289 -0
- package/dist/src/utils/numeric-patterns.d.ts.map +1 -0
- package/dist/src/utils/numeric-wrappers.d.ts +146 -0
- package/dist/src/utils/numeric-wrappers.d.ts.map +1 -0
- package/dist/src/utils/object-extractors.d.ts +115 -0
- package/dist/src/utils/object-extractors.d.ts.map +1 -0
- package/dist/src/utils/object-patterns.d.ts +81 -0
- package/dist/src/utils/object-patterns.d.ts.map +1 -0
- package/dist/src/utils/pagination-helpers.d.ts +230 -0
- package/dist/src/utils/pagination-helpers.d.ts.map +1 -0
- package/dist/src/utils/pool-pair-parser.d.ts +3 -1
- package/dist/src/utils/pool-pair-parser.d.ts.map +1 -1
- package/dist/src/utils/pool-state-validator.d.ts.map +1 -1
- package/dist/src/utils/position-filters.d.ts +1 -2
- package/dist/src/utils/position-filters.d.ts.map +1 -1
- package/dist/src/utils/query-params.d.ts +0 -16
- package/dist/src/utils/query-params.d.ts.map +1 -1
- package/dist/src/utils/response-handlers.d.ts +149 -20
- package/dist/src/utils/response-handlers.d.ts.map +1 -1
- package/dist/src/utils/response-helpers.d.ts +28 -0
- package/dist/src/utils/response-helpers.d.ts.map +1 -0
- package/dist/src/utils/response-normalizers.d.ts +27 -49
- package/dist/src/utils/response-normalizers.d.ts.map +1 -1
- package/dist/src/utils/safe-parsers.d.ts +487 -0
- package/dist/src/utils/safe-parsers.d.ts.map +1 -0
- package/dist/src/utils/service-validators.d.ts +268 -0
- package/dist/src/utils/service-validators.d.ts.map +1 -0
- package/dist/src/utils/slippage-utils.d.ts.map +1 -1
- package/dist/src/utils/string-patterns.d.ts +404 -0
- package/dist/src/utils/string-patterns.d.ts.map +1 -0
- package/dist/src/utils/string-transforms.d.ts +89 -0
- package/dist/src/utils/string-transforms.d.ts.map +1 -0
- package/dist/src/utils/string-utils.d.ts +108 -0
- package/dist/src/utils/string-utils.d.ts.map +1 -0
- package/dist/src/utils/swap-delta-calculator.d.ts.map +1 -1
- package/dist/src/utils/tick-crossing-handler.d.ts.map +1 -1
- package/dist/src/utils/token-format-converter.d.ts +22 -8
- package/dist/src/utils/token-format-converter.d.ts.map +1 -1
- package/dist/src/utils/token-parser.d.ts +2 -2
- package/dist/src/utils/token-parser.d.ts.map +1 -1
- package/dist/src/utils/token-stringification.d.ts +168 -0
- package/dist/src/utils/token-stringification.d.ts.map +1 -0
- package/dist/src/utils/tokenNameNormalizer.d.ts +96 -0
- package/dist/src/utils/tokenNameNormalizer.d.ts.map +1 -0
- package/dist/src/utils/tokenNormalizer.d.ts +8 -45
- package/dist/src/utils/tokenNormalizer.d.ts.map +1 -1
- package/dist/src/utils/transfer-validation.d.ts +1 -1
- package/dist/src/utils/transfer-validation.d.ts.map +1 -1
- package/dist/src/utils/type-guard-factory.d.ts +260 -0
- package/dist/src/utils/type-guard-factory.d.ts.map +1 -0
- package/dist/src/utils/unique-key-generator.d.ts +148 -0
- package/dist/src/utils/unique-key-generator.d.ts.map +1 -0
- package/dist/src/utils/validation-helpers.d.ts +906 -183
- package/dist/src/utils/validation-helpers.d.ts.map +1 -1
- package/dist/src/utils/validation-patterns.d.ts +745 -0
- package/dist/src/utils/validation-patterns.d.ts.map +1 -0
- package/dist/src/utils/validation.d.ts +2 -30
- package/dist/src/utils/validation.d.ts.map +1 -1
- package/dist/src/utils/wallet.d.ts +12 -1
- package/dist/src/utils/wallet.d.ts.map +1 -1
- package/dist/src/utils/websocket-patterns.d.ts +681 -0
- package/dist/src/utils/websocket-patterns.d.ts.map +1 -0
- package/dist/src/utils/websocket-validators.d.ts.map +1 -1
- package/package.json +86 -19
- package/dist/src/bridge/strategies/index.d.ts +0 -9
- package/dist/src/bridge/strategies/index.d.ts.map +0 -1
- package/dist/src/constants/counts.d.ts +0 -66
- package/dist/src/constants/counts.d.ts.map +0 -1
- package/dist/src/services/WebSocketManager.d.ts +0 -99
- package/dist/src/services/WebSocketManager.d.ts.map +0 -1
- package/dist/src/types/eip712-types.d.ts +0 -140
- package/dist/src/types/eip712-types.d.ts.map +0 -1
- package/dist/src/types/pool-state-manager-config.dto.d.ts +0 -103
- package/dist/src/types/pool-state-manager-config.dto.d.ts.map +0 -1
- package/dist/src/utils/number-utils.d.ts +0 -94
- package/dist/src/utils/number-utils.d.ts.map +0 -1
- package/dist/src/utils/precision-math.d.ts +0 -37
- package/dist/src/utils/precision-math.d.ts.map +0 -1
|
@@ -0,0 +1,360 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Error Pattern Utilities
|
|
3
|
+
*
|
|
4
|
+
* Advanced error extraction and handling patterns that consolidate
|
|
5
|
+
* 7 frequently-repeated error handling idioms across 100+ files.
|
|
6
|
+
*
|
|
7
|
+
* @category Utilities
|
|
8
|
+
* @since 6.17.0
|
|
9
|
+
*/
|
|
10
|
+
/**
|
|
11
|
+
* Extract error message from any error type with safe fallbacks
|
|
12
|
+
*
|
|
13
|
+
* Handles multiple error formats and provides sensible defaults.
|
|
14
|
+
* Consolidates 47 occurrences of pattern: `error.message || String(error) || 'Unknown error'`.
|
|
15
|
+
*
|
|
16
|
+
* Supports:
|
|
17
|
+
* - Error instances (error.message)
|
|
18
|
+
* - Objects with message property ({ message: "..." })
|
|
19
|
+
* - String errors ("error message")
|
|
20
|
+
* - Other types (converted to string)
|
|
21
|
+
* - null/undefined (returns fallback)
|
|
22
|
+
*
|
|
23
|
+
* @param error Unknown error value from catch block
|
|
24
|
+
* @returns Safe string representation of the error, never null/undefined
|
|
25
|
+
*
|
|
26
|
+
* @example Basic usage
|
|
27
|
+
* ```typescript
|
|
28
|
+
* try {
|
|
29
|
+
* await operation();
|
|
30
|
+
* } catch (error: unknown) {
|
|
31
|
+
* const msg = extractErrorMessageFromUnknown(error);
|
|
32
|
+
* logger.error(`Failed: ${msg}`); // Safe - always a string
|
|
33
|
+
* }
|
|
34
|
+
* ```
|
|
35
|
+
*
|
|
36
|
+
* @example With custom fallback
|
|
37
|
+
* ```typescript
|
|
38
|
+
* try {
|
|
39
|
+
* await riskyOperation();
|
|
40
|
+
* } catch (error: unknown) {
|
|
41
|
+
* // Use default fallback
|
|
42
|
+
* const message = extractErrorMessageFromUnknown(error);
|
|
43
|
+
* console.log(message); // "Unknown error" if error is null
|
|
44
|
+
* }
|
|
45
|
+
* ```
|
|
46
|
+
*
|
|
47
|
+
* @example Multiple error types
|
|
48
|
+
* ```typescript
|
|
49
|
+
* // Error instance
|
|
50
|
+
* extractErrorMessageFromUnknown(new Error('Test')) // → "Test"
|
|
51
|
+
*
|
|
52
|
+
* // Object with message
|
|
53
|
+
* extractErrorMessageFromUnknown({ message: 'API error' }) // → "API error"
|
|
54
|
+
*
|
|
55
|
+
* // String error
|
|
56
|
+
* extractErrorMessageFromUnknown('Error string') // → "Error string"
|
|
57
|
+
*
|
|
58
|
+
* // null/undefined
|
|
59
|
+
* extractErrorMessageFromUnknown(null) // → "Unknown error"
|
|
60
|
+
* extractErrorMessageFromUnknown(undefined) // → "Unknown error"
|
|
61
|
+
* ```
|
|
62
|
+
*
|
|
63
|
+
* @since 6.17.0
|
|
64
|
+
*/
|
|
65
|
+
export declare function extractErrorMessageFromUnknown(error: unknown): string;
|
|
66
|
+
/**
|
|
67
|
+
* Generic GSwap error handler with fallback message
|
|
68
|
+
*
|
|
69
|
+
* Consolidates 18 occurrences of pattern:
|
|
70
|
+
* `if (isAxiosError) { extract status } else { generic message }`.
|
|
71
|
+
*
|
|
72
|
+
* Provides consistent error handling across GSwap service operations.
|
|
73
|
+
*
|
|
74
|
+
* @param error Unknown error from GSwap operation
|
|
75
|
+
* @param context Operation context for error message (e.g., "quote generation")
|
|
76
|
+
* @returns Error with context-prefixed message, preserving original error if HTTP error
|
|
77
|
+
*
|
|
78
|
+
* @example GSwap quote error
|
|
79
|
+
* ```typescript
|
|
80
|
+
* try {
|
|
81
|
+
* const quote = await gswapClient.getQuote(params);
|
|
82
|
+
* } catch (error: unknown) {
|
|
83
|
+
* throw handleGSwapErrorGeneric(error, 'quote generation');
|
|
84
|
+
* // Throws: Error("GSwap quote generation failed: ...")
|
|
85
|
+
* }
|
|
86
|
+
* ```
|
|
87
|
+
*
|
|
88
|
+
* @example GSwap pool error
|
|
89
|
+
* ```typescript
|
|
90
|
+
* try {
|
|
91
|
+
* const pool = await gswapClient.getPoolInfo('GALA', 'GUSDC');
|
|
92
|
+
* } catch (error: unknown) {
|
|
93
|
+
* throw handleGSwapErrorGeneric(error, 'pool info retrieval');
|
|
94
|
+
* // Throws: Error("GSwap pool info retrieval failed: ...")
|
|
95
|
+
* }
|
|
96
|
+
* ```
|
|
97
|
+
*
|
|
98
|
+
* @example HTTP error with status code
|
|
99
|
+
* ```typescript
|
|
100
|
+
* try {
|
|
101
|
+
* await gswapClient.executeSwap(params);
|
|
102
|
+
* } catch (error: unknown) {
|
|
103
|
+
* const err = handleGSwapErrorGeneric(error, 'swap execution');
|
|
104
|
+
* // If HTTP error (404): Error with additional context
|
|
105
|
+
* // If network error: Generic error with message
|
|
106
|
+
* }
|
|
107
|
+
* ```
|
|
108
|
+
*
|
|
109
|
+
* @since 6.17.0
|
|
110
|
+
*/
|
|
111
|
+
export declare function handleGSwapErrorGeneric(error: unknown, context: string): Error;
|
|
112
|
+
/**
|
|
113
|
+
* Log error with full stack trace and context
|
|
114
|
+
*
|
|
115
|
+
* Consolidates 11 occurrences of manual console.error + stack trace extraction.
|
|
116
|
+
* Side-effect function that logs to console or optional logger.
|
|
117
|
+
*
|
|
118
|
+
* @param error Unknown error to log
|
|
119
|
+
* @param context Operation context for log message
|
|
120
|
+
* @param logger Optional logger object (defaults to console)
|
|
121
|
+
* @returns void (side-effect function, does not return value)
|
|
122
|
+
*
|
|
123
|
+
* @example Basic logging
|
|
124
|
+
* ```typescript
|
|
125
|
+
* try {
|
|
126
|
+
* await operation();
|
|
127
|
+
* } catch (error: unknown) {
|
|
128
|
+
* logErrorWithStack(error, 'Operation failed');
|
|
129
|
+
* // Logs to console: "Operation failed: <message> <stack>"
|
|
130
|
+
* }
|
|
131
|
+
* ```
|
|
132
|
+
*
|
|
133
|
+
* @example With custom logger
|
|
134
|
+
* ```typescript
|
|
135
|
+
* try {
|
|
136
|
+
* await complexOperation();
|
|
137
|
+
* } catch (error: unknown) {
|
|
138
|
+
* logErrorWithStack(error, 'Complex operation', logger);
|
|
139
|
+
* // Logs via logger.error()
|
|
140
|
+
* }
|
|
141
|
+
* ```
|
|
142
|
+
*
|
|
143
|
+
* @example Without throwing
|
|
144
|
+
* ```typescript
|
|
145
|
+
* // Log but don't rethrow
|
|
146
|
+
* try {
|
|
147
|
+
* await nonCriticalOperation();
|
|
148
|
+
* } catch (error: unknown) {
|
|
149
|
+
* logErrorWithStack(error, 'Non-critical failed');
|
|
150
|
+
* // Continue execution
|
|
151
|
+
* }
|
|
152
|
+
* ```
|
|
153
|
+
*
|
|
154
|
+
* @since 6.17.0
|
|
155
|
+
*/
|
|
156
|
+
export declare function logErrorWithStack(error: unknown, context: string, logger?: {
|
|
157
|
+
error: (message: string) => void;
|
|
158
|
+
}): void;
|
|
159
|
+
/**
|
|
160
|
+
* Cast unknown error to object with guaranteed message property
|
|
161
|
+
*
|
|
162
|
+
* Consolidates 8 occurrences of unsafe type assertions like `(error as Error)`.
|
|
163
|
+
* Returns object with message property and all original properties.
|
|
164
|
+
*
|
|
165
|
+
* @param error Unknown error value
|
|
166
|
+
* @returns Object with guaranteed message property + any original properties
|
|
167
|
+
*
|
|
168
|
+
* @example Error instance
|
|
169
|
+
* ```typescript
|
|
170
|
+
* const err = castErrorToObject(new Error('test'));
|
|
171
|
+
* // → { message: "test", [Error properties] }
|
|
172
|
+
* ```
|
|
173
|
+
*
|
|
174
|
+
* @example Object without message
|
|
175
|
+
* ```typescript
|
|
176
|
+
* const err = castErrorToObject({ code: 500 });
|
|
177
|
+
* // → { message: "Unknown error", code: 500 }
|
|
178
|
+
* ```
|
|
179
|
+
*
|
|
180
|
+
* @example null/undefined
|
|
181
|
+
* ```typescript
|
|
182
|
+
* const err = castErrorToObject(null);
|
|
183
|
+
* // → { message: "Unknown error" }
|
|
184
|
+
* ```
|
|
185
|
+
*
|
|
186
|
+
* @example String error
|
|
187
|
+
* ```typescript
|
|
188
|
+
* const err = castErrorToObject('Network timeout');
|
|
189
|
+
* // → { message: "Network timeout" }
|
|
190
|
+
* ```
|
|
191
|
+
*
|
|
192
|
+
* @since 6.17.0
|
|
193
|
+
*/
|
|
194
|
+
export declare function castErrorToObject(error: unknown): {
|
|
195
|
+
message: string;
|
|
196
|
+
[key: string]: unknown;
|
|
197
|
+
};
|
|
198
|
+
/**
|
|
199
|
+
* Safely extract field from error response object
|
|
200
|
+
*
|
|
201
|
+
* Consolidates 7 occurrences of pattern: `error?.response?.data?.message`
|
|
202
|
+
* Supports nested field access with dot notation.
|
|
203
|
+
*
|
|
204
|
+
* @param error Unknown error object
|
|
205
|
+
* @param fieldPath Dot-notation path to field (e.g., "response.data.error.code")
|
|
206
|
+
* @returns Field value if found, undefined if not found or path invalid
|
|
207
|
+
*
|
|
208
|
+
* @example Extract status code
|
|
209
|
+
* ```typescript
|
|
210
|
+
* try {
|
|
211
|
+
* await api.get('/endpoint');
|
|
212
|
+
* } catch (error: unknown) {
|
|
213
|
+
* const status = getErrorResponseField(error, 'response.status');
|
|
214
|
+
* if (status === 404) {
|
|
215
|
+
* console.log('Not found');
|
|
216
|
+
* }
|
|
217
|
+
* }
|
|
218
|
+
* ```
|
|
219
|
+
*
|
|
220
|
+
* @example Extract nested error message
|
|
221
|
+
* ```typescript
|
|
222
|
+
* try {
|
|
223
|
+
* await operation();
|
|
224
|
+
* } catch (error: unknown) {
|
|
225
|
+
* const msg = getErrorResponseField(error, 'response.data.error.message');
|
|
226
|
+
* console.log(msg || 'Unknown error');
|
|
227
|
+
* }
|
|
228
|
+
* ```
|
|
229
|
+
*
|
|
230
|
+
* @example API error with code
|
|
231
|
+
* ```typescript
|
|
232
|
+
* try {
|
|
233
|
+
* await galachain.call();
|
|
234
|
+
* } catch (error: unknown) {
|
|
235
|
+
* const code = getErrorResponseField(error, 'response.data.code');
|
|
236
|
+
* const message = getErrorResponseField(error, 'response.data.Message');
|
|
237
|
+
* logError(`${code}: ${message}`);
|
|
238
|
+
* }
|
|
239
|
+
* ```
|
|
240
|
+
*
|
|
241
|
+
* @since 6.17.0
|
|
242
|
+
*/
|
|
243
|
+
export declare function getErrorResponseField(error: unknown, fieldPath: string): unknown;
|
|
244
|
+
/**
|
|
245
|
+
* Collect the last error from Promise.allSettled results
|
|
246
|
+
*
|
|
247
|
+
* Consolidates 6 occurrences of pattern: manual loop through results
|
|
248
|
+
* to find rejected promises and extract error.
|
|
249
|
+
*
|
|
250
|
+
* Returns the last (most recent) error from rejected promises,
|
|
251
|
+
* or undefined if all promises succeeded.
|
|
252
|
+
*
|
|
253
|
+
* @param results Array of Promise settlement results
|
|
254
|
+
* @returns Last error found in rejected promises, undefined if no errors
|
|
255
|
+
*
|
|
256
|
+
* @example Batch operation with error handling
|
|
257
|
+
* ```typescript
|
|
258
|
+
* const results = await Promise.allSettled([
|
|
259
|
+
* operation1(),
|
|
260
|
+
* operation2(),
|
|
261
|
+
* operation3(),
|
|
262
|
+
* ]);
|
|
263
|
+
*
|
|
264
|
+
* const lastError = collectLastError(results);
|
|
265
|
+
* if (lastError) {
|
|
266
|
+
* console.log('At least one operation failed:', lastError.message);
|
|
267
|
+
* }
|
|
268
|
+
* ```
|
|
269
|
+
*
|
|
270
|
+
* @example Parallel transfers with fallback
|
|
271
|
+
* ```typescript
|
|
272
|
+
* const transfers = await Promise.allSettled([
|
|
273
|
+
* sdk.transferToken({ to: addr1, amount: '100' }),
|
|
274
|
+
* sdk.transferToken({ to: addr2, amount: '200' }),
|
|
275
|
+
* sdk.transferToken({ to: addr3, amount: '150' }),
|
|
276
|
+
* ]);
|
|
277
|
+
*
|
|
278
|
+
* const error = collectLastError(transfers);
|
|
279
|
+
* if (error) {
|
|
280
|
+
* throw new Error(`Transfer batch failed: ${error.message}`);
|
|
281
|
+
* }
|
|
282
|
+
* ```
|
|
283
|
+
*
|
|
284
|
+
* @example All promises succeeded
|
|
285
|
+
* ```typescript
|
|
286
|
+
* const results = await Promise.allSettled([
|
|
287
|
+
* operation1(),
|
|
288
|
+
* operation2(),
|
|
289
|
+
* ]);
|
|
290
|
+
*
|
|
291
|
+
* const error = collectLastError(results);
|
|
292
|
+
* // error is undefined (all succeeded)
|
|
293
|
+
* ```
|
|
294
|
+
*
|
|
295
|
+
* @since 6.17.0
|
|
296
|
+
*/
|
|
297
|
+
export declare function collectLastError(results: PromiseSettledResult<unknown>[]): Error | undefined;
|
|
298
|
+
/**
|
|
299
|
+
* Type guard for errors matching specific error pattern
|
|
300
|
+
*
|
|
301
|
+
* Consolidates 4 occurrences of pattern: `error instanceof Error && error.name === 'X'`.
|
|
302
|
+
* Supports optional name and message pattern matching.
|
|
303
|
+
*
|
|
304
|
+
* @param error Unknown error value to check
|
|
305
|
+
* @param name Optional error constructor name to match
|
|
306
|
+
* @param messagePattern Optional regex pattern to match against error message
|
|
307
|
+
* @returns Type guard: true if error matches pattern, false otherwise
|
|
308
|
+
*
|
|
309
|
+
* @example Check for ValidationError
|
|
310
|
+
* ```typescript
|
|
311
|
+
* try {
|
|
312
|
+
* validate(data);
|
|
313
|
+
* } catch (error: unknown) {
|
|
314
|
+
* if (isErrorWithNameAndMessagePattern(error, 'ValidationError')) {
|
|
315
|
+
* console.log('Validation failed:', error.message);
|
|
316
|
+
* }
|
|
317
|
+
* }
|
|
318
|
+
* ```
|
|
319
|
+
*
|
|
320
|
+
* @example Check by name only
|
|
321
|
+
* ```typescript
|
|
322
|
+
* try {
|
|
323
|
+
* await operation();
|
|
324
|
+
* } catch (error: unknown) {
|
|
325
|
+
* if (isErrorWithNameAndMessagePattern(error, 'TimeoutError')) {
|
|
326
|
+
* console.log('Operation timed out');
|
|
327
|
+
* }
|
|
328
|
+
* }
|
|
329
|
+
* ```
|
|
330
|
+
*
|
|
331
|
+
* @example Check with message pattern
|
|
332
|
+
* ```typescript
|
|
333
|
+
* try {
|
|
334
|
+
* await galachain.call();
|
|
335
|
+
* } catch (error: unknown) {
|
|
336
|
+
* // Match GalaChain status errors
|
|
337
|
+
* if (isErrorWithNameAndMessagePattern(error, 'Error', /status indicates failure/i)) {
|
|
338
|
+
* console.log('GalaChain status check failed');
|
|
339
|
+
* }
|
|
340
|
+
* }
|
|
341
|
+
* ```
|
|
342
|
+
*
|
|
343
|
+
* @example No pattern (just type guard)
|
|
344
|
+
* ```typescript
|
|
345
|
+
* try {
|
|
346
|
+
* await operation();
|
|
347
|
+
* } catch (error: unknown) {
|
|
348
|
+
* if (isErrorWithNameAndMessagePattern(error)) {
|
|
349
|
+
* // Guaranteed that error is Error with message property
|
|
350
|
+
* console.log(error.message);
|
|
351
|
+
* }
|
|
352
|
+
* }
|
|
353
|
+
* ```
|
|
354
|
+
*
|
|
355
|
+
* @since 6.17.0
|
|
356
|
+
*/
|
|
357
|
+
export declare function isErrorWithNameAndMessagePattern(error: unknown, name?: string, messagePattern?: RegExp): error is Error & {
|
|
358
|
+
message: string;
|
|
359
|
+
};
|
|
360
|
+
//# sourceMappingURL=error-patterns.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"error-patterns.d.ts","sourceRoot":"","sources":["../../../src/utils/error-patterns.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAErE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,MAAM,GACd,KAAK,CAcP;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE;IAAE,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,GAC5C,IAAI,CAUN;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,GACb;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAc7C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CA0BT;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,oBAAoB,CAAC,OAAO,CAAC,EAAE,GACvC,KAAK,GAAG,SAAS,CAgBnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,OAAO,EACd,IAAI,CAAC,EAAE,MAAM,EACb,cAAc,CAAC,EAAE,MAAM,GACtB,KAAK,IAAI,KAAK,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAiBtC"}
|
|
@@ -205,4 +205,254 @@ export declare function isAxiosError(error: unknown): error is {
|
|
|
205
205
|
* ```
|
|
206
206
|
*/
|
|
207
207
|
export declare function getHttpStatusCode(error: unknown): number | undefined;
|
|
208
|
+
/**
|
|
209
|
+
* Validates and extracts response.data with comprehensive null/structure checks
|
|
210
|
+
*
|
|
211
|
+
* Performs combined validation of response object and extraction of its data property.
|
|
212
|
+
* Throws descriptive errors if response is invalid or missing data.
|
|
213
|
+
*
|
|
214
|
+
* @param response Unknown response object from API call
|
|
215
|
+
* @param operation Name of the operation for error messages
|
|
216
|
+
* @returns The data from response.data, strongly typed
|
|
217
|
+
* @throws Error if response is invalid or data is missing
|
|
218
|
+
*
|
|
219
|
+
* @example
|
|
220
|
+
* ```typescript
|
|
221
|
+
* try {
|
|
222
|
+
* const response = await api.get('/data');
|
|
223
|
+
* const data = validateAndExtractResponseData<UserData>(response, 'Fetch user');
|
|
224
|
+
* console.log(data.id); // TypeScript knows data is UserData
|
|
225
|
+
* } catch (error: unknown) {
|
|
226
|
+
* console.error('Failed to fetch user:', getErrorMessage(error));
|
|
227
|
+
* }
|
|
228
|
+
* ```
|
|
229
|
+
*/
|
|
230
|
+
export declare function validateAndExtractResponseData<T>(response: unknown, operation: string): T;
|
|
231
|
+
/**
|
|
232
|
+
* Wraps an error with operation context and message prefix for better error tracing
|
|
233
|
+
*
|
|
234
|
+
* Creates a new Error with a prefixed message that includes the operation context,
|
|
235
|
+
* preserving the original error information through the message.
|
|
236
|
+
*
|
|
237
|
+
* @param error Unknown error to wrap
|
|
238
|
+
* @param context Operation context string (e.g., "Swap delta calculation")
|
|
239
|
+
* @param prefix Optional custom prefix (defaults to context)
|
|
240
|
+
* @returns New Error with context-prefixed message
|
|
241
|
+
*
|
|
242
|
+
* @example
|
|
243
|
+
* ```typescript
|
|
244
|
+
* try {
|
|
245
|
+
* const result = await performSwap();
|
|
246
|
+
* return result;
|
|
247
|
+
* } catch (error: unknown) {
|
|
248
|
+
* throw wrapErrorWithContext(error, 'Swap calculation');
|
|
249
|
+
* // Throws: "Swap calculation: Original error message"
|
|
250
|
+
* }
|
|
251
|
+
* ```
|
|
252
|
+
*/
|
|
253
|
+
export declare function wrapErrorWithContext(error: unknown, context: string, prefix?: string): Error;
|
|
254
|
+
/**
|
|
255
|
+
* Validates response status and throws standardized error if response indicates failure
|
|
256
|
+
*
|
|
257
|
+
* Checks that response exists and has a Status property equal to 1 (success).
|
|
258
|
+
* Throws descriptive errors if response is invalid or indicates failure.
|
|
259
|
+
*
|
|
260
|
+
* @param response Unknown response object from API call
|
|
261
|
+
* @param operation Name of the operation for error messages
|
|
262
|
+
* @returns The response object if status check passes, strongly typed
|
|
263
|
+
* @throws Error if response is invalid or Status is not 1
|
|
264
|
+
*
|
|
265
|
+
* @example
|
|
266
|
+
* ```typescript
|
|
267
|
+
* try {
|
|
268
|
+
* const response = await this.http.post('/api/data');
|
|
269
|
+
* const validated = assertResponseSuccess(response, 'API request');
|
|
270
|
+
* console.log(validated); // TypeScript knows response is valid
|
|
271
|
+
* } catch (error: unknown) {
|
|
272
|
+
* console.error('API call failed:', getErrorMessage(error));
|
|
273
|
+
* }
|
|
274
|
+
* ```
|
|
275
|
+
*/
|
|
276
|
+
export declare function assertResponseSuccess(response: unknown, operation: string): Record<string, unknown>;
|
|
277
|
+
/**
|
|
278
|
+
* Safely extracts error details from HTTP error responses with fallbacks
|
|
279
|
+
*
|
|
280
|
+
* Use this to extract status codes, messages, and error data from axios or HTTP errors.
|
|
281
|
+
* Provides sensible defaults when properties are missing or malformed.
|
|
282
|
+
*
|
|
283
|
+
* @param error The error object to extract details from
|
|
284
|
+
* @returns Object with status, message, and optional data properties
|
|
285
|
+
*
|
|
286
|
+
* @example
|
|
287
|
+
* ```typescript
|
|
288
|
+
* try {
|
|
289
|
+
* const response = await api.get('/data');
|
|
290
|
+
* } catch (error: unknown) {
|
|
291
|
+
* const { status, message, data } = extractErrorResponse(error);
|
|
292
|
+
* console.log(`HTTP ${status}: ${message}`);
|
|
293
|
+
* if (data) {
|
|
294
|
+
* console.log('Error details:', data);
|
|
295
|
+
* }
|
|
296
|
+
* }
|
|
297
|
+
* ```
|
|
298
|
+
*
|
|
299
|
+
* @example
|
|
300
|
+
* ```typescript
|
|
301
|
+
* // Handles various error types gracefully
|
|
302
|
+
* const { status, message } = extractErrorResponse('string error');
|
|
303
|
+
* // → { status: 500, message: "string error", data: undefined }
|
|
304
|
+
*
|
|
305
|
+
* const { status, message } = extractErrorResponse(new Error('Network error'));
|
|
306
|
+
* // → { status: 500, message: "Network error", data: undefined }
|
|
307
|
+
*
|
|
308
|
+
* const { status, message, data } = extractErrorResponse(axiosError);
|
|
309
|
+
* // → { status: 404, message: "Not Found", data: { details: "..." } }
|
|
310
|
+
* ```
|
|
311
|
+
*
|
|
312
|
+
* @since 3.50.0
|
|
313
|
+
*/
|
|
314
|
+
export declare function extractErrorResponse(error: unknown): {
|
|
315
|
+
status: number;
|
|
316
|
+
message: string;
|
|
317
|
+
data?: unknown;
|
|
318
|
+
};
|
|
319
|
+
/**
|
|
320
|
+
* Extract error message from response object with optional context
|
|
321
|
+
*
|
|
322
|
+
* Safely extracts Message property from API response for error context
|
|
323
|
+
* without unsafe type casts or verbose inline conditionals.
|
|
324
|
+
*
|
|
325
|
+
* @param response Unknown response object
|
|
326
|
+
* @returns Error message suffix (empty string if no message found)
|
|
327
|
+
*
|
|
328
|
+
* @example
|
|
329
|
+
* ```typescript
|
|
330
|
+
* try {
|
|
331
|
+
* const result = await sdk.lockTokens(data);
|
|
332
|
+
* } catch (error) {
|
|
333
|
+
* const responseMsg = extractResponseMessage(response);
|
|
334
|
+
* throw new LockError(`${getErrorMessage(error)}${responseMsg}`);
|
|
335
|
+
* }
|
|
336
|
+
* ```
|
|
337
|
+
*/
|
|
338
|
+
export declare function extractResponseMessage(response: unknown): string;
|
|
339
|
+
/**
|
|
340
|
+
* Collects ValidationError messages from a function into an error array for batch validation reporting
|
|
341
|
+
*
|
|
342
|
+
* Simplifies the pattern of throwing validation errors in try-catch blocks and collecting messages.
|
|
343
|
+
* Catches ValidationError specifically and adds the message to the errors array, re-throws non-ValidationError exceptions.
|
|
344
|
+
*
|
|
345
|
+
* ## Replaces Pattern
|
|
346
|
+
*
|
|
347
|
+
* ### Before (Verbose try-catch for each validation):
|
|
348
|
+
* ```typescript
|
|
349
|
+
* const errors: string[] = [];
|
|
350
|
+
*
|
|
351
|
+
* try {
|
|
352
|
+
* throw createRequiredFieldError('role', 'Role');
|
|
353
|
+
* } catch (e) {
|
|
354
|
+
* if (e instanceof ValidationError) errors.push(e.message);
|
|
355
|
+
* }
|
|
356
|
+
*
|
|
357
|
+
* try {
|
|
358
|
+
* validateLaunchpadTokenName(options.tokenName ?? '', 'tokenName');
|
|
359
|
+
* } catch (e) {
|
|
360
|
+
* if (e instanceof ValidationError) errors.push(e.message);
|
|
361
|
+
* }
|
|
362
|
+
*
|
|
363
|
+
* try {
|
|
364
|
+
* throw createInvalidFormatError('address', 'valid Ethereum address');
|
|
365
|
+
* } catch (e) {
|
|
366
|
+
* if (e instanceof ValidationError) errors.push(e.message);
|
|
367
|
+
* }
|
|
368
|
+
* ```
|
|
369
|
+
*
|
|
370
|
+
* ### After (Concise with collectValidationErrors):
|
|
371
|
+
* ```typescript
|
|
372
|
+
* const errors: string[] = [];
|
|
373
|
+
*
|
|
374
|
+
* collectValidationErrors(errors, () => {
|
|
375
|
+
* throw createRequiredFieldError('role', 'Role');
|
|
376
|
+
* });
|
|
377
|
+
*
|
|
378
|
+
* collectValidationErrors(errors, () =>
|
|
379
|
+
* validateLaunchpadTokenName(options.tokenName ?? '', 'tokenName')
|
|
380
|
+
* );
|
|
381
|
+
*
|
|
382
|
+
* collectValidationErrors(errors, () => {
|
|
383
|
+
* throw createInvalidFormatError('address', 'valid Ethereum address');
|
|
384
|
+
* });
|
|
385
|
+
* ```
|
|
386
|
+
*
|
|
387
|
+
* @param errors Array to accumulate error messages into
|
|
388
|
+
* @param fn Function that may throw ValidationError
|
|
389
|
+
* @param errorPrefix Optional prefix to add to collected error messages for context
|
|
390
|
+
* @throws Non-ValidationError exceptions are re-thrown as-is
|
|
391
|
+
*
|
|
392
|
+
* @example Basic usage with error factory
|
|
393
|
+
* ```typescript
|
|
394
|
+
* const errors: string[] = [];
|
|
395
|
+
*
|
|
396
|
+
* collectValidationErrors(errors, () => {
|
|
397
|
+
* throw createRequiredFieldError('tokenName');
|
|
398
|
+
* });
|
|
399
|
+
*
|
|
400
|
+
* // errors is now: ['TokenName is required']
|
|
401
|
+
* ```
|
|
402
|
+
*
|
|
403
|
+
* @example With validation helper function
|
|
404
|
+
* ```typescript
|
|
405
|
+
* const errors: string[] = [];
|
|
406
|
+
*
|
|
407
|
+
* collectValidationErrors(errors, () =>
|
|
408
|
+
* validateLaunchpadTokenName(tokenName, 'tokenName')
|
|
409
|
+
* );
|
|
410
|
+
*
|
|
411
|
+
* if (errors.length > 0) {
|
|
412
|
+
* throw new ValidationError(errors.join('; '));
|
|
413
|
+
* }
|
|
414
|
+
* ```
|
|
415
|
+
*
|
|
416
|
+
* @example With optional error prefix for context
|
|
417
|
+
* ```typescript
|
|
418
|
+
* const errors: string[] = [];
|
|
419
|
+
*
|
|
420
|
+
* collectValidationErrors(
|
|
421
|
+
* errors,
|
|
422
|
+
* () => validateSwapAmount(amount),
|
|
423
|
+
* 'Swap validation failed: '
|
|
424
|
+
* );
|
|
425
|
+
*
|
|
426
|
+
* // If ValidationError thrown, message includes prefix
|
|
427
|
+
* // errors: ['Swap validation failed: Amount must be positive']
|
|
428
|
+
* ```
|
|
429
|
+
*
|
|
430
|
+
* @example Multiple validations with batch reporting
|
|
431
|
+
* ```typescript
|
|
432
|
+
* const errors: string[] = [];
|
|
433
|
+
*
|
|
434
|
+
* collectValidationErrors(errors, () => {
|
|
435
|
+
* if (!role) throw createRequiredFieldError('role', 'Role');
|
|
436
|
+
* });
|
|
437
|
+
*
|
|
438
|
+
* collectValidationErrors(errors, () => {
|
|
439
|
+
* if (!isValidEnum(scope)) throw createInvalidEnumError('scope', scope, SCOPES);
|
|
440
|
+
* });
|
|
441
|
+
*
|
|
442
|
+
* collectValidationErrors(errors, () => {
|
|
443
|
+
* if (description.length > 255) throw createStringTooLongError('description', 255);
|
|
444
|
+
* });
|
|
445
|
+
*
|
|
446
|
+
* if (errors.length > 0) {
|
|
447
|
+
* throw new ValidationError(
|
|
448
|
+
* `Validation failed: ${errors.join('; ')}`,
|
|
449
|
+
* 'batch',
|
|
450
|
+
* 'VALIDATION_BATCH_FAILED'
|
|
451
|
+
* );
|
|
452
|
+
* }
|
|
453
|
+
* ```
|
|
454
|
+
*
|
|
455
|
+
* @since 6.15.0
|
|
456
|
+
*/
|
|
457
|
+
export declare function collectValidationErrors(errors: string[], fn: () => void, errorPrefix?: string): void;
|
|
208
458
|
//# sourceMappingURL=error-utils.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"error-utils.d.ts","sourceRoot":"","sources":["../../../src/utils/error-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAEtD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAOvE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI;IAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAQ1E;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAetD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAehE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAMxE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAoBA;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE;QACT,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,OAAO,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAOA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAMpE"}
|
|
1
|
+
{"version":3,"file":"error-utils.d.ts","sourceRoot":"","sources":["../../../src/utils/error-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAEtD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAOvE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI;IAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAQ1E;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAetD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAehE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAMxE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAoBA;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE;QACT,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,OAAO,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAOA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAMpE;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,8BAA8B,CAAC,CAAC,EAC9C,QAAQ,EAAE,OAAO,EACjB,SAAS,EAAE,MAAM,GAChB,CAAC,CAyBH;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,GACd,KAAK,CAIP;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,OAAO,EACjB,SAAS,EAAE,MAAM,GAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiCzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CA2DA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAahE;AAuBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqHG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EAAE,EAChB,EAAE,EAAE,MAAM,IAAI,EACd,WAAW,CAAC,EAAE,MAAM,GACnB,IAAI,CAYN"}
|