@gala-chain/launchpad-sdk 5.0.3 → 5.0.4-beta.1
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/constants/version.generated.d.ts.map +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,157 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Pagination Helpers
|
|
3
|
+
*
|
|
4
|
+
* Shared utilities for building pagination parameters and responses
|
|
5
|
+
* across multiple services. Eliminates duplicate pagination logic.
|
|
6
|
+
*
|
|
7
|
+
* @category Services
|
|
8
|
+
* @since 5.13.0
|
|
9
|
+
*/
|
|
10
|
+
/**
|
|
11
|
+
* Standard pagination metadata structure
|
|
12
|
+
* Used in ListResult<T> and paginated API responses
|
|
13
|
+
*/
|
|
14
|
+
export interface PaginationMeta {
|
|
15
|
+
page: number;
|
|
16
|
+
limit: number;
|
|
17
|
+
total: number;
|
|
18
|
+
totalPages: number;
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* Options for building pagination parameters
|
|
22
|
+
*/
|
|
23
|
+
export interface PaginationOptions {
|
|
24
|
+
page?: number;
|
|
25
|
+
limit?: number;
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* Build pagination query parameters with max limit enforcement
|
|
29
|
+
*
|
|
30
|
+
* Consolidates the common pagination building pattern used across services:
|
|
31
|
+
* - Converts page/limit to strings
|
|
32
|
+
* - Enforces max limit constraint
|
|
33
|
+
* - Only includes params that are defined
|
|
34
|
+
*
|
|
35
|
+
* @param options - Options object with optional page and limit
|
|
36
|
+
* @param maxLimit - Maximum allowed limit value
|
|
37
|
+
* @returns Query params object with stringified page and limit
|
|
38
|
+
*
|
|
39
|
+
* @example
|
|
40
|
+
* ```typescript
|
|
41
|
+
* const params = buildPaginationParams(
|
|
42
|
+
* { page: 1, limit: 50 },
|
|
43
|
+
* CONSTRAINTS.PAGINATION.MAX_LIMIT
|
|
44
|
+
* );
|
|
45
|
+
* // Result: { page: '1', limit: '20' } if max is 20
|
|
46
|
+
* ```
|
|
47
|
+
*/
|
|
48
|
+
export declare function buildPaginationParams(options: PaginationOptions, maxLimit: number): Record<string, string>;
|
|
49
|
+
/**
|
|
50
|
+
* Build pagination metadata from response data
|
|
51
|
+
*
|
|
52
|
+
* Creates standardized PaginationMeta from total count and request parameters.
|
|
53
|
+
* Handles edge cases like empty results and division by zero.
|
|
54
|
+
*
|
|
55
|
+
* @param total - Total item count from API response
|
|
56
|
+
* @param page - Current page number (default: 1)
|
|
57
|
+
* @param limit - Items per page (default: 20)
|
|
58
|
+
* @returns PaginationMeta object with calculated totalPages
|
|
59
|
+
*
|
|
60
|
+
* @example
|
|
61
|
+
* ```typescript
|
|
62
|
+
* const meta = buildPaginationMeta(total, page, actualLimit);
|
|
63
|
+
* return { items: pools, meta };
|
|
64
|
+
* ```
|
|
65
|
+
*/
|
|
66
|
+
export declare function buildPaginationMeta(total: number, page?: number, limit?: number): PaginationMeta;
|
|
67
|
+
/**
|
|
68
|
+
* Build pagination metadata for auto-paginated (all items) results
|
|
69
|
+
*
|
|
70
|
+
* Creates PaginationMeta for results where all items have been fetched.
|
|
71
|
+
* Sets page=1, totalPages=1, and limit=items.length for flattened results.
|
|
72
|
+
*
|
|
73
|
+
* @param items - Array of fetched items
|
|
74
|
+
* @param total - Total count (usually same as items.length for auto-paginated)
|
|
75
|
+
* @returns PaginationMeta for flattened result
|
|
76
|
+
*
|
|
77
|
+
* @example
|
|
78
|
+
* ```typescript
|
|
79
|
+
* // After auto-pagination fetches all items
|
|
80
|
+
* const allItems = await autoPaginate(fetchFn, options);
|
|
81
|
+
* return {
|
|
82
|
+
* items: allItems.items,
|
|
83
|
+
* meta: buildFlattenedPaginationMeta(allItems.items, allItems.total)
|
|
84
|
+
* };
|
|
85
|
+
* ```
|
|
86
|
+
*/
|
|
87
|
+
export declare function buildFlattenedPaginationMeta<T>(items: T[], total?: number): PaginationMeta;
|
|
88
|
+
/**
|
|
89
|
+
* Build endpoint URL with path parameters
|
|
90
|
+
*
|
|
91
|
+
* Replaces :param placeholders in URL templates with provided values.
|
|
92
|
+
* Values are lowercased and URI-encoded for safety.
|
|
93
|
+
*
|
|
94
|
+
* @param template - URL template with :param placeholders
|
|
95
|
+
* @param params - Parameters to substitute
|
|
96
|
+
* @returns Built URL with substituted parameters
|
|
97
|
+
*
|
|
98
|
+
* @example
|
|
99
|
+
* ```typescript
|
|
100
|
+
* const url = buildEndpoint('/api/:tokenName/status', { tokenName: 'MyToken' });
|
|
101
|
+
* // Returns: '/api/mytoken/status'
|
|
102
|
+
*
|
|
103
|
+
* const url = buildEndpoint('/api/:tokenName/assets/:assetId', {
|
|
104
|
+
* tokenName: 'MyToken',
|
|
105
|
+
* assetId: '12345'
|
|
106
|
+
* });
|
|
107
|
+
* // Returns: '/api/mytoken/assets/12345'
|
|
108
|
+
* ```
|
|
109
|
+
*/
|
|
110
|
+
export declare function buildEndpoint(template: string, params: Record<string, string>): string;
|
|
111
|
+
/**
|
|
112
|
+
* Calculate if there's a next page based on current pagination state
|
|
113
|
+
*
|
|
114
|
+
* @param currentPage - Current page number
|
|
115
|
+
* @param totalPages - Total number of pages
|
|
116
|
+
* @returns True if there are more pages after the current one
|
|
117
|
+
*/
|
|
118
|
+
export declare function hasNextPage(currentPage: number, totalPages: number): boolean;
|
|
119
|
+
/**
|
|
120
|
+
* Calculate if there's a previous page based on current pagination state
|
|
121
|
+
*
|
|
122
|
+
* @param currentPage - Current page number
|
|
123
|
+
* @returns True if there are pages before the current one
|
|
124
|
+
*/
|
|
125
|
+
export declare function hasPreviousPage(currentPage: number): boolean;
|
|
126
|
+
/**
|
|
127
|
+
* Common filter fields that can be added to query parameters
|
|
128
|
+
*/
|
|
129
|
+
export interface CommonFilterOptions {
|
|
130
|
+
search?: string;
|
|
131
|
+
name?: string;
|
|
132
|
+
userAddress?: string;
|
|
133
|
+
}
|
|
134
|
+
/**
|
|
135
|
+
* Add optional filter parameters to a query params object
|
|
136
|
+
*
|
|
137
|
+
* Consolidates the common pattern of conditionally adding filter params:
|
|
138
|
+
* - Only adds params that have truthy values
|
|
139
|
+
* - Mutates the params object in place for efficiency
|
|
140
|
+
*
|
|
141
|
+
* @param params - Query params object to add to (mutated)
|
|
142
|
+
* @param options - Options object containing filter values
|
|
143
|
+
* @param fields - Array of field names to extract from options
|
|
144
|
+
* @returns The mutated params object (for chaining)
|
|
145
|
+
*
|
|
146
|
+
* @example
|
|
147
|
+
* ```typescript
|
|
148
|
+
* const params = buildPaginationParams(options, MAX_LIMIT);
|
|
149
|
+
* addOptionalFilterParams(params, options, ['search', 'name', 'userAddress']);
|
|
150
|
+
* // Equivalent to:
|
|
151
|
+
* // if (options.search) params.search = options.search;
|
|
152
|
+
* // if (options.name) params.name = options.name;
|
|
153
|
+
* // if (options.userAddress) params.userAddress = options.userAddress;
|
|
154
|
+
* ```
|
|
155
|
+
*/
|
|
156
|
+
export declare function addOptionalFilterParams<T>(params: Record<string, string>, options: T, fields: (keyof T & string)[]): Record<string, string>;
|
|
157
|
+
//# sourceMappingURL=pagination-helpers.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"pagination-helpers.d.ts","sourceRoot":"","sources":["../../../../src/services/shared/pagination-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASxB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,MAAU,EAAE,KAAK,GAAE,MAAW,GAAG,cAAc,CAOvG;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,4BAA4B,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,GAAE,MAAqB,GAAG,cAAc,CAOxG;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAMtF;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAE5E;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EACvC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,OAAO,EAAE,CAAC,EACV,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,GAC3B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQxB"}
|
|
@@ -0,0 +1,137 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Service Validators
|
|
3
|
+
*
|
|
4
|
+
* Re-exports validation utilities from utils/service-validators.ts.
|
|
5
|
+
* Provides shared validation utilities used across multiple services to eliminate
|
|
6
|
+
* duplicated validation logic. These validators provide consistent error
|
|
7
|
+
* messages and validation behavior.
|
|
8
|
+
*
|
|
9
|
+
* This module serves as a compatibility layer for services that import from
|
|
10
|
+
* services/shared/service-validators.ts. All implementations are in utils/service-validators.ts.
|
|
11
|
+
*
|
|
12
|
+
* @category Services
|
|
13
|
+
* @since 5.13.0
|
|
14
|
+
*/
|
|
15
|
+
import type { TokenNameConstraint } from '../../types/common';
|
|
16
|
+
export { validatePositiveInteger as validatePositiveIntegerUtil, validateRequiredString as validateRequiredStringUtil, validateOptionalString as validateOptionalStringUtil, validateOptionalNumber as validateOptionalNumberUtil, validateTokenNameWithConstraints as validateTokenNameWithConstraintsUtil, validateStatusFilter as validateStatusFilterUtil, validateRequiredDate, validateOptionalDate as validateOptionalDateUtil, validateNonEmptyArray, validateArrayLength, validateOptionalObject, validateRequiredObject, validateStringLength, } from '../../utils/service-validators';
|
|
17
|
+
/**
|
|
18
|
+
* Validates that a value is a positive integer (for IDs)
|
|
19
|
+
*
|
|
20
|
+
* Wrapper for the utility function to provide the displayName parameter.
|
|
21
|
+
* This consolidates the duplicate `validatePositiveInteger` method
|
|
22
|
+
* found in both BaseService and StreamTokenServiceBase.
|
|
23
|
+
*
|
|
24
|
+
* @param value - Value to validate
|
|
25
|
+
* @param fieldName - Technical field name for error details
|
|
26
|
+
* @param displayName - Human-readable name for error message
|
|
27
|
+
* @throws {ValidationError} If value is not a positive integer
|
|
28
|
+
*
|
|
29
|
+
* @example
|
|
30
|
+
* ```typescript
|
|
31
|
+
* validatePositiveInteger(id, 'id', 'API key ID');
|
|
32
|
+
* validatePositiveInteger(inviteId, 'inviteId', 'Invite ID');
|
|
33
|
+
* validatePositiveInteger(commentId, 'commentId', 'Comment ID');
|
|
34
|
+
* ```
|
|
35
|
+
*/
|
|
36
|
+
export declare function validatePositiveInteger(value: number, fieldName: string, displayName: string): void;
|
|
37
|
+
/**
|
|
38
|
+
* Validates token name format against provided constraints
|
|
39
|
+
*
|
|
40
|
+
* This function consolidates the duplicate token name validation found
|
|
41
|
+
* across StreamTokenServiceBase and other services.
|
|
42
|
+
*
|
|
43
|
+
* @param tokenName - Token name to validate
|
|
44
|
+
* @param constraints - Token name validation constraints (pattern, min/max length)
|
|
45
|
+
* @throws {ValidationError} If token name is invalid
|
|
46
|
+
*
|
|
47
|
+
* @example
|
|
48
|
+
* ```typescript
|
|
49
|
+
* validateTokenNameWithConstraints(tokenName, STREAMING_CONSTRAINTS.TOKEN_NAME);
|
|
50
|
+
* validateTokenNameWithConstraints(tokenName, CHAT_CONSTRAINTS.TOKEN_NAME);
|
|
51
|
+
* ```
|
|
52
|
+
*/
|
|
53
|
+
export declare function validateTokenNameWithConstraints(tokenName: string, constraints: TokenNameConstraint): void;
|
|
54
|
+
/**
|
|
55
|
+
* Validates a required string parameter
|
|
56
|
+
*
|
|
57
|
+
* @param value - Value to validate
|
|
58
|
+
* @param fieldName - Technical field name for error details
|
|
59
|
+
* @param displayName - Human-readable name for error message
|
|
60
|
+
* @throws {ValidationError} If value is missing or not a string
|
|
61
|
+
*
|
|
62
|
+
* @example
|
|
63
|
+
* ```typescript
|
|
64
|
+
* validateRequiredString(assetId, 'assetId', 'Asset ID');
|
|
65
|
+
* validateRequiredString(content, 'content', 'Message content');
|
|
66
|
+
* ```
|
|
67
|
+
*/
|
|
68
|
+
export declare function validateRequiredString(value: string | undefined, fieldName: string, displayName: string): void;
|
|
69
|
+
/**
|
|
70
|
+
* Validates an optional string parameter with max length constraint
|
|
71
|
+
*
|
|
72
|
+
* @param value - Value to validate (undefined/null allowed)
|
|
73
|
+
* @param fieldName - Technical field name for error details
|
|
74
|
+
* @param displayName - Human-readable name for error message
|
|
75
|
+
* @param maxLength - Maximum allowed string length
|
|
76
|
+
* @throws {ValidationError} If value is not a string or exceeds maxLength
|
|
77
|
+
*
|
|
78
|
+
* @example
|
|
79
|
+
* ```typescript
|
|
80
|
+
* validateOptionalString(description, 'description', 'Description', 255);
|
|
81
|
+
* validateOptionalString(reason, 'reason', 'Reason', 500);
|
|
82
|
+
* ```
|
|
83
|
+
*/
|
|
84
|
+
export declare function validateOptionalString(value: string | undefined | null, fieldName: string, displayName: string, maxLength: number): void;
|
|
85
|
+
/**
|
|
86
|
+
* Validates an optional number parameter with min/max constraints
|
|
87
|
+
*
|
|
88
|
+
* @param value - Value to validate (undefined/null allowed)
|
|
89
|
+
* @param fieldName - Technical field name for error details
|
|
90
|
+
* @param displayName - Human-readable name for error message
|
|
91
|
+
* @param min - Minimum allowed value
|
|
92
|
+
* @param max - Maximum allowed value
|
|
93
|
+
* @param minMessage - Custom message suffix for minimum violation
|
|
94
|
+
* @param maxMessage - Custom message suffix for maximum violation
|
|
95
|
+
* @throws {ValidationError} If value is not a number or out of range
|
|
96
|
+
*
|
|
97
|
+
* @example
|
|
98
|
+
* ```typescript
|
|
99
|
+
* validateOptionalNumber(durationSeconds, 'durationSeconds', 'Duration', 60, 31536000, '1 minute', '1 year');
|
|
100
|
+
* ```
|
|
101
|
+
*/
|
|
102
|
+
export declare function validateOptionalNumber(value: number | undefined | null, fieldName: string, displayName: string, min: number, max: number, _minMessage?: string, _maxMessage?: string): void;
|
|
103
|
+
/**
|
|
104
|
+
* Validates an optional ISO 8601 date string
|
|
105
|
+
*
|
|
106
|
+
* @param value - Value to validate (undefined/null allowed)
|
|
107
|
+
* @param fieldName - Technical field name for error details
|
|
108
|
+
* @param displayName - Human-readable name for error message
|
|
109
|
+
* @throws {ValidationError} If value is not a valid ISO 8601 date
|
|
110
|
+
*
|
|
111
|
+
* @example
|
|
112
|
+
* ```typescript
|
|
113
|
+
* validateOptionalDate(expiresAt, 'expiresAt', 'Expiration date');
|
|
114
|
+
* ```
|
|
115
|
+
*/
|
|
116
|
+
export declare function validateOptionalDate(value: string | undefined | null, fieldName: string, displayName: string): void;
|
|
117
|
+
/**
|
|
118
|
+
* Validates a status filter against an enum object
|
|
119
|
+
*
|
|
120
|
+
* Generic validator for status filters used in list operations.
|
|
121
|
+
* Works with any enum-like const object.
|
|
122
|
+
*
|
|
123
|
+
* Uses enumValidationWithObjectValues for consistent enum validation.
|
|
124
|
+
*
|
|
125
|
+
* @param status - Status value to validate (undefined allowed)
|
|
126
|
+
* @param validStatusEnum - Enum-like const object to validate against
|
|
127
|
+
* @param fieldName - Field name for error message (default: 'status')
|
|
128
|
+
* @throws {ValidationError} If status is not a valid enum value
|
|
129
|
+
*
|
|
130
|
+
* @example
|
|
131
|
+
* ```typescript
|
|
132
|
+
* validateStatusFilter(options.status, OVERSEER_INVITE_STATUS);
|
|
133
|
+
* validateStatusFilter(options.status, OVERSEER_STATUS);
|
|
134
|
+
* ```
|
|
135
|
+
*/
|
|
136
|
+
export declare function validateStatusFilter<T extends Record<string, string>>(status: string | undefined, validStatusEnum: T, fieldName?: string): void;
|
|
137
|
+
//# sourceMappingURL=service-validators.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"service-validators.d.ts","sourceRoot":"","sources":["../../../../src/services/shared/service-validators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAcH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,EACL,uBAAuB,IAAI,2BAA2B,EACtD,sBAAsB,IAAI,0BAA0B,EACpD,sBAAsB,IAAI,0BAA0B,EACpD,sBAAsB,IAAI,0BAA0B,EACpD,gCAAgC,IAAI,oCAAoC,EACxE,oBAAoB,IAAI,wBAAwB,EAChD,oBAAoB,EACpB,oBAAoB,IAAI,wBAAwB,EAChD,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,gCAAgC,CAAC;AAExC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAOnG;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gCAAgC,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,mBAAmB,GAAG,IAAI,CAa1G;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAI9G;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAChC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,IAAI,CASN;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAChC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,WAAW,CAAC,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,GACnB,IAAI,CASN;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAChC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,IAAI,CAUN;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACnE,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,eAAe,EAAE,CAAC,EAClB,SAAS,GAAE,MAAiB,GAC3B,IAAI,CAIN"}
|
|
@@ -0,0 +1,158 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* WebSocket Helpers
|
|
3
|
+
*
|
|
4
|
+
* Shared utilities for WebSocket event buffering and lifecycle management.
|
|
5
|
+
* Eliminates duplicate patterns across WebSocketService and StreamWebSocketService.
|
|
6
|
+
*
|
|
7
|
+
* @category Services
|
|
8
|
+
* @since 6.5.0
|
|
9
|
+
*/
|
|
10
|
+
import type { Logger } from '../../utils/Logger';
|
|
11
|
+
/**
|
|
12
|
+
* Configuration for EventBuffer
|
|
13
|
+
*/
|
|
14
|
+
export interface EventBufferConfig {
|
|
15
|
+
/** Maximum number of events to buffer (default: 100) */
|
|
16
|
+
maxSize?: number;
|
|
17
|
+
/** Time-to-live for buffered events in ms (default: 30000) */
|
|
18
|
+
ttlMs?: number;
|
|
19
|
+
/** Logger instance for debug output */
|
|
20
|
+
logger?: Logger;
|
|
21
|
+
/** Prefix for log messages (e.g., 'Stream' or 'Transaction') */
|
|
22
|
+
logPrefix?: string;
|
|
23
|
+
}
|
|
24
|
+
/**
|
|
25
|
+
* Generic event buffer for WebSocket race condition prevention
|
|
26
|
+
*
|
|
27
|
+
* Buffers events that arrive before listeners are registered,
|
|
28
|
+
* preventing loss of events during the subscription window.
|
|
29
|
+
*
|
|
30
|
+
* @typeParam T - Event data type
|
|
31
|
+
*
|
|
32
|
+
* @example
|
|
33
|
+
* ```typescript
|
|
34
|
+
* const buffer = new EventBuffer<TransactionStatus>({
|
|
35
|
+
* maxSize: 1000,
|
|
36
|
+
* ttlMs: 30000,
|
|
37
|
+
* logger,
|
|
38
|
+
* logPrefix: 'Transaction'
|
|
39
|
+
* });
|
|
40
|
+
*
|
|
41
|
+
* // Buffer an event when received
|
|
42
|
+
* buffer.set('tx-123', eventData);
|
|
43
|
+
*
|
|
44
|
+
* // Later, when listener is registered, retrieve buffered event
|
|
45
|
+
* const buffered = buffer.consume('tx-123');
|
|
46
|
+
* if (buffered) {
|
|
47
|
+
* callback(buffered);
|
|
48
|
+
* }
|
|
49
|
+
* ```
|
|
50
|
+
*
|
|
51
|
+
* @since 6.5.0
|
|
52
|
+
*/
|
|
53
|
+
export declare class EventBuffer<T = unknown> {
|
|
54
|
+
private readonly buffer;
|
|
55
|
+
private readonly maxSize;
|
|
56
|
+
private readonly ttlMs;
|
|
57
|
+
private readonly logger;
|
|
58
|
+
private readonly logPrefix;
|
|
59
|
+
constructor(config?: EventBufferConfig);
|
|
60
|
+
/**
|
|
61
|
+
* Buffer an event for later retrieval
|
|
62
|
+
*
|
|
63
|
+
* If buffer is full, drops the oldest event (FIFO).
|
|
64
|
+
*
|
|
65
|
+
* @param key - Event identifier (e.g., transactionId, tokenName)
|
|
66
|
+
* @param data - Event data to buffer
|
|
67
|
+
*/
|
|
68
|
+
set(key: string, data: T): void;
|
|
69
|
+
/**
|
|
70
|
+
* Retrieve and remove a buffered event
|
|
71
|
+
*
|
|
72
|
+
* @param key - Event identifier
|
|
73
|
+
* @returns Buffered data or undefined if not found
|
|
74
|
+
*/
|
|
75
|
+
consume(key: string): T | undefined;
|
|
76
|
+
/**
|
|
77
|
+
* Get a buffered event without removing it
|
|
78
|
+
*
|
|
79
|
+
* @param key - Event identifier
|
|
80
|
+
* @returns Buffered data or undefined if not found
|
|
81
|
+
*/
|
|
82
|
+
get(key: string): T | undefined;
|
|
83
|
+
/**
|
|
84
|
+
* Check if an event is buffered
|
|
85
|
+
*
|
|
86
|
+
* @param key - Event identifier
|
|
87
|
+
* @returns True if event is buffered
|
|
88
|
+
*/
|
|
89
|
+
has(key: string): boolean;
|
|
90
|
+
/**
|
|
91
|
+
* Delete a buffered event
|
|
92
|
+
*
|
|
93
|
+
* @param key - Event identifier
|
|
94
|
+
*/
|
|
95
|
+
delete(key: string): void;
|
|
96
|
+
/**
|
|
97
|
+
* Delete all buffered events matching a predicate
|
|
98
|
+
*
|
|
99
|
+
* @param predicate - Function to test each key
|
|
100
|
+
*/
|
|
101
|
+
deleteWhere(predicate: (key: string) => boolean): void;
|
|
102
|
+
/**
|
|
103
|
+
* Clear all buffered events
|
|
104
|
+
*/
|
|
105
|
+
clear(): void;
|
|
106
|
+
/**
|
|
107
|
+
* Get current buffer size
|
|
108
|
+
*/
|
|
109
|
+
get size(): number;
|
|
110
|
+
}
|
|
111
|
+
/**
|
|
112
|
+
* Timeout manager for WebSocket operations
|
|
113
|
+
*
|
|
114
|
+
* Centralizes timeout handling for transaction monitoring, subscriptions, etc.
|
|
115
|
+
*
|
|
116
|
+
* @since 6.5.0
|
|
117
|
+
*/
|
|
118
|
+
export declare class TimeoutManager {
|
|
119
|
+
private readonly timeouts;
|
|
120
|
+
private readonly logger;
|
|
121
|
+
private readonly logPrefix;
|
|
122
|
+
constructor(logger?: Logger, logPrefix?: string);
|
|
123
|
+
/**
|
|
124
|
+
* Set a timeout for a key
|
|
125
|
+
*
|
|
126
|
+
* @param key - Identifier for this timeout
|
|
127
|
+
* @param callback - Function to call when timeout fires
|
|
128
|
+
* @param ms - Timeout duration in milliseconds
|
|
129
|
+
*/
|
|
130
|
+
set(key: string, callback: () => void, ms: number): void;
|
|
131
|
+
/**
|
|
132
|
+
* Clear a specific timeout
|
|
133
|
+
*
|
|
134
|
+
* @param key - Identifier of timeout to clear
|
|
135
|
+
*/
|
|
136
|
+
clear(key: string): void;
|
|
137
|
+
/**
|
|
138
|
+
* Clear all timeouts
|
|
139
|
+
*/
|
|
140
|
+
clearAll(): void;
|
|
141
|
+
/**
|
|
142
|
+
* Check if a timeout exists
|
|
143
|
+
*
|
|
144
|
+
* @param key - Identifier to check
|
|
145
|
+
*/
|
|
146
|
+
has(key: string): boolean;
|
|
147
|
+
/**
|
|
148
|
+
* Get count of active timeouts
|
|
149
|
+
*/
|
|
150
|
+
get size(): number;
|
|
151
|
+
}
|
|
152
|
+
/**
|
|
153
|
+
* Check if Socket.IO client is available in the current environment
|
|
154
|
+
*
|
|
155
|
+
* @returns True if Socket.IO io function is available
|
|
156
|
+
*/
|
|
157
|
+
export declare function checkSocketIOAvailability(): boolean;
|
|
158
|
+
//# sourceMappingURL=websocket-helpers.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"websocket-helpers.d.ts","sourceRoot":"","sources":["../../../../src/services/shared/websocket-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAcjD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,WAAW,CAAC,CAAC,GAAG,OAAO;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;IAC9D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,GAAE,iBAAsB;IAO1C;;;;;;;OAOG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;IAmC/B;;;;;OAKG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAcnC;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAI/B;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQzB;;;;OAIG;IACH,WAAW,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI;IAQtD;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAED;;;;;;GAMG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,GAAE,MAAkB;IAK1D;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAaxD;;;;OAIG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IASxB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAQhB;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,OAAO,CASnD"}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Time constants for tests
|
|
3
|
+
* Shared between SDK tests and MCP server tests
|
|
4
|
+
*
|
|
5
|
+
* These constants provide human-readable names for time duration values,
|
|
6
|
+
* eliminating magic numbers in test code and improving maintainability.
|
|
7
|
+
*
|
|
8
|
+
* Usage:
|
|
9
|
+
* ```typescript
|
|
10
|
+
* import { TIME_CONSTANTS } from '@gala-chain/launchpad-sdk';
|
|
11
|
+
*
|
|
12
|
+
* const expiryTime = Date.now() + TIME_CONSTANTS.ONE_WEEK_MS;
|
|
13
|
+
* ```
|
|
14
|
+
*/
|
|
15
|
+
export declare const TIME_CONSTANTS: {
|
|
16
|
+
/** 1 second in milliseconds */
|
|
17
|
+
readonly ONE_SECOND_MS: 1000;
|
|
18
|
+
/** 1 minute in milliseconds */
|
|
19
|
+
readonly ONE_MINUTE_MS: 60000;
|
|
20
|
+
/** 1 hour in milliseconds */
|
|
21
|
+
readonly ONE_HOUR_MS: 3600000;
|
|
22
|
+
/** 1 day in milliseconds */
|
|
23
|
+
readonly ONE_DAY_MS: 86400000;
|
|
24
|
+
/** 1 week in milliseconds */
|
|
25
|
+
readonly ONE_WEEK_MS: 604800000;
|
|
26
|
+
/** 1 month (30 days) in milliseconds */
|
|
27
|
+
readonly ONE_MONTH_MS: 2592000000;
|
|
28
|
+
};
|
|
29
|
+
//# sourceMappingURL=test-constants.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"test-constants.d.ts","sourceRoot":"","sources":["../../src/test-constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,eAAO,MAAM,cAAc;IACzB,+BAA+B;;IAE/B,+BAA+B;;IAE/B,6BAA6B;;IAE7B,4BAA4B;;IAE5B,6BAA6B;;IAE7B,wCAAwC;;CAEhC,CAAC"}
|