@gala-chain/launchpad-sdk 5.0.3 → 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.
Files changed (406) hide show
  1. package/EXAMPLES.md +141 -7
  2. package/README.md +68 -36
  3. package/dist/ai-docs.json +7357 -0
  4. package/dist/index.cjs.js +1 -1
  5. package/dist/index.d.ts +70 -11
  6. package/dist/index.d.ts.map +1 -1
  7. package/dist/index.esm.js +1 -1
  8. package/dist/index.js +1 -1
  9. package/dist/src/LaunchpadSDK.d.ts +3288 -214
  10. package/dist/src/LaunchpadSDK.d.ts.map +1 -1
  11. package/dist/src/api/LaunchpadAPI.d.ts +21 -41
  12. package/dist/src/api/LaunchpadAPI.d.ts.map +1 -1
  13. package/dist/src/api/dto/BurnTokensDto.d.ts.map +1 -1
  14. package/dist/src/api/dto/LockTokenDto.d.ts.map +1 -1
  15. package/dist/src/api/dto/TransferTokenDto.d.ts.map +1 -1
  16. package/dist/src/api/dto/UnlockTokenDto.d.ts.map +1 -1
  17. package/dist/src/auth/JwtAuth.d.ts +145 -0
  18. package/dist/src/auth/JwtAuth.d.ts.map +1 -0
  19. package/dist/src/auth/SessionAuthService.d.ts +146 -0
  20. package/dist/src/auth/SessionAuthService.d.ts.map +1 -0
  21. package/dist/src/auth/SignatureAuth.d.ts.map +1 -1
  22. package/dist/src/bridge/BridgeService.d.ts.map +1 -1
  23. package/dist/src/bridge/GalaConnectClient.d.ts.map +1 -1
  24. package/dist/src/bridge/constants/tokens.d.ts +4 -3
  25. package/dist/src/bridge/constants/tokens.d.ts.map +1 -1
  26. package/dist/src/bridge/index.d.ts +1 -0
  27. package/dist/src/bridge/index.d.ts.map +1 -1
  28. package/dist/src/bridge/strategies/BridgeStrategy.d.ts.map +1 -1
  29. package/dist/src/bridge/strategies/EthereumBridgeStrategy.d.ts +1 -38
  30. package/dist/src/bridge/strategies/EthereumBridgeStrategy.d.ts.map +1 -1
  31. package/dist/src/bridge/strategies/SolanaBridgeStrategy.d.ts +1 -21
  32. package/dist/src/bridge/strategies/SolanaBridgeStrategy.d.ts.map +1 -1
  33. package/dist/src/bridge/types/bridge.dto.d.ts +15 -2
  34. package/dist/src/bridge/types/bridge.dto.d.ts.map +1 -1
  35. package/dist/src/bridge/utils/RateLimiter.d.ts +1 -1
  36. package/dist/src/bridge/utils/RateLimiter.d.ts.map +1 -1
  37. package/dist/src/bridge/utils/address-formatter.d.ts +25 -0
  38. package/dist/src/bridge/utils/address-formatter.d.ts.map +1 -0
  39. package/dist/src/bridge/utils/addressValidation.d.ts +200 -0
  40. package/dist/src/bridge/utils/addressValidation.d.ts.map +1 -0
  41. package/dist/src/bridge/utils/balanceHelpers.d.ts +215 -0
  42. package/dist/src/bridge/utils/balanceHelpers.d.ts.map +1 -0
  43. package/dist/src/bridge/utils/bridgeErrors.d.ts +98 -0
  44. package/dist/src/bridge/utils/bridgeErrors.d.ts.map +1 -0
  45. package/dist/src/bridge/utils/bridgeOutHelpers.d.ts +68 -0
  46. package/dist/src/bridge/utils/bridgeOutHelpers.d.ts.map +1 -0
  47. package/dist/src/bridge/utils/bridgePayload.d.ts +107 -0
  48. package/dist/src/bridge/utils/bridgePayload.d.ts.map +1 -0
  49. package/dist/src/bridge/utils/bridgeStatusParser.d.ts +75 -0
  50. package/dist/src/bridge/utils/bridgeStatusParser.d.ts.map +1 -0
  51. package/dist/src/bridge/utils/eip712Helpers.d.ts +66 -0
  52. package/dist/src/bridge/utils/eip712Helpers.d.ts.map +1 -0
  53. package/dist/src/bridge/utils/index.d.ts +9 -0
  54. package/dist/src/bridge/utils/index.d.ts.map +1 -1
  55. package/dist/src/bridge/utils/retry.d.ts +16 -0
  56. package/dist/src/bridge/utils/retry.d.ts.map +1 -1
  57. package/dist/src/bridge/utils/strategyDelegation.d.ts +69 -0
  58. package/dist/src/bridge/utils/strategyDelegation.d.ts.map +1 -0
  59. package/dist/src/bridge/utils/tokenIdUtils.d.ts +7 -0
  60. package/dist/src/bridge/utils/tokenIdUtils.d.ts.map +1 -1
  61. package/dist/src/bridge/utils/tokenMath.d.ts.map +1 -1
  62. package/dist/src/bridge/utils/tokenMetadataResolver.d.ts +97 -0
  63. package/dist/src/bridge/utils/tokenMetadataResolver.d.ts.map +1 -0
  64. package/dist/src/constants/endpoints.d.ts +453 -0
  65. package/dist/src/constants/endpoints.d.ts.map +1 -1
  66. package/dist/src/constants/error-messages.d.ts +1 -1
  67. package/dist/src/constants/error-messages.d.ts.map +1 -1
  68. package/dist/src/constants/jwt.d.ts +41 -0
  69. package/dist/src/constants/jwt.d.ts.map +1 -0
  70. package/dist/src/constants/sdk-defaults.d.ts +37 -0
  71. package/dist/src/constants/sdk-defaults.d.ts.map +1 -0
  72. package/dist/src/constants/version.generated.d.ts +1 -1
  73. package/dist/src/constants/version.generated.d.ts.map +1 -1
  74. package/dist/src/helpers/sdk.d.ts.map +1 -1
  75. package/dist/src/helpers/wallet.d.ts +4 -3
  76. package/dist/src/helpers/wallet.d.ts.map +1 -1
  77. package/dist/src/index.d.ts +70 -11
  78. package/dist/src/index.d.ts.map +1 -1
  79. package/dist/src/schemas/files.d.ts +2 -2
  80. package/dist/src/schemas/launchpad.d.ts +40 -8
  81. package/dist/src/schemas/launchpad.d.ts.map +1 -1
  82. package/dist/src/schemas/pagination.d.ts +7 -7
  83. package/dist/src/schemas/primitives.d.ts.map +1 -1
  84. package/dist/src/schemas/trade.d.ts +6 -6
  85. package/dist/src/schemas/user.d.ts +4 -4
  86. package/dist/src/schemas/validators.d.ts +15 -7
  87. package/dist/src/schemas/validators.d.ts.map +1 -1
  88. package/dist/src/services/AbstractCacheService.d.ts +227 -0
  89. package/dist/src/services/AbstractCacheService.d.ts.map +1 -0
  90. package/dist/src/services/AbstractTokenFetchService.d.ts +150 -0
  91. package/dist/src/services/AbstractTokenFetchService.d.ts.map +1 -0
  92. package/dist/src/services/ApiKeyService.d.ts +205 -0
  93. package/dist/src/services/ApiKeyService.d.ts.map +1 -0
  94. package/dist/src/services/BanService.d.ts +195 -0
  95. package/dist/src/services/BanService.d.ts.map +1 -0
  96. package/dist/src/services/BaseService.d.ts +50 -3
  97. package/dist/src/services/BaseService.d.ts.map +1 -1
  98. package/dist/src/services/BatchedCacheService.d.ts +132 -0
  99. package/dist/src/services/BatchedCacheService.d.ts.map +1 -0
  100. package/dist/src/services/BridgeableTokenCache.d.ts +32 -98
  101. package/dist/src/services/BridgeableTokenCache.d.ts.map +1 -1
  102. package/dist/src/services/BridgeableTokenService.d.ts +18 -13
  103. package/dist/src/services/BridgeableTokenService.d.ts.map +1 -1
  104. package/dist/src/services/BundleService.d.ts.map +1 -1
  105. package/dist/src/services/BundlerClientFactory.d.ts +32 -0
  106. package/dist/src/services/BundlerClientFactory.d.ts.map +1 -0
  107. package/dist/src/services/ChatMessagesService.d.ts +152 -0
  108. package/dist/src/services/ChatMessagesService.d.ts.map +1 -0
  109. package/dist/src/services/CommentService.d.ts +119 -0
  110. package/dist/src/services/CommentService.d.ts.map +1 -0
  111. package/dist/src/services/CommentsService.d.ts +155 -0
  112. package/dist/src/services/CommentsService.d.ts.map +1 -0
  113. package/dist/src/services/ContentFlagService.d.ts +212 -0
  114. package/dist/src/services/ContentFlagService.d.ts.map +1 -0
  115. package/dist/src/services/ContentReactionService.d.ts +175 -0
  116. package/dist/src/services/ContentReactionService.d.ts.map +1 -0
  117. package/dist/src/services/DexBackendClient.d.ts.map +1 -1
  118. package/dist/src/services/DexPoolService.d.ts +3 -3
  119. package/dist/src/services/DexPoolService.d.ts.map +1 -1
  120. package/dist/src/services/DexQuoteService.d.ts.map +1 -1
  121. package/dist/src/services/DexService.d.ts +2 -5
  122. package/dist/src/services/DexService.d.ts.map +1 -1
  123. package/dist/src/services/GSwapAssetService.d.ts +80 -0
  124. package/dist/src/services/GSwapAssetService.d.ts.map +1 -0
  125. package/dist/src/services/GSwapLiquidityMutationService.d.ts +140 -0
  126. package/dist/src/services/GSwapLiquidityMutationService.d.ts.map +1 -0
  127. package/dist/src/services/GSwapLiquidityQueryService.d.ts +87 -0
  128. package/dist/src/services/GSwapLiquidityQueryService.d.ts.map +1 -0
  129. package/dist/src/services/GSwapPoolCalculationService.d.ts +200 -0
  130. package/dist/src/services/GSwapPoolCalculationService.d.ts.map +1 -0
  131. package/dist/src/services/GSwapPoolQueryService.d.ts +116 -0
  132. package/dist/src/services/GSwapPoolQueryService.d.ts.map +1 -0
  133. package/dist/src/services/GSwapService.d.ts +14 -0
  134. package/dist/src/services/GSwapService.d.ts.map +1 -1
  135. package/dist/src/services/GSwapSwapService.d.ts +68 -0
  136. package/dist/src/services/GSwapSwapService.d.ts.map +1 -0
  137. package/dist/src/services/GalaChainBalanceService.d.ts +155 -0
  138. package/dist/src/services/GalaChainBalanceService.d.ts.map +1 -0
  139. package/dist/src/services/GalaChainGatewayClient.d.ts +32 -1
  140. package/dist/src/services/GalaChainGatewayClient.d.ts.map +1 -1
  141. package/dist/src/services/GalaChainLockService.d.ts +144 -0
  142. package/dist/src/services/GalaChainLockService.d.ts.map +1 -0
  143. package/dist/src/services/GalaChainService.d.ts +23 -106
  144. package/dist/src/services/GalaChainService.d.ts.map +1 -1
  145. package/dist/src/services/GalaChainTokenService.d.ts +108 -0
  146. package/dist/src/services/GalaChainTokenService.d.ts.map +1 -0
  147. package/dist/src/services/GalaChainTransferService.d.ts +205 -0
  148. package/dist/src/services/GalaChainTransferService.d.ts.map +1 -0
  149. package/dist/src/services/ImageService.d.ts +24 -8
  150. package/dist/src/services/ImageService.d.ts.map +1 -1
  151. package/dist/src/services/LaunchpadService.d.ts +77 -5
  152. package/dist/src/services/LaunchpadService.d.ts.map +1 -1
  153. package/dist/src/services/ModeratorService.d.ts +269 -0
  154. package/dist/src/services/ModeratorService.d.ts.map +1 -0
  155. package/dist/src/services/MultiPoolStateManager.d.ts +4 -6
  156. package/dist/src/services/MultiPoolStateManager.d.ts.map +1 -1
  157. package/dist/src/services/NetworkKeyedCacheService.d.ts +185 -0
  158. package/dist/src/services/NetworkKeyedCacheService.d.ts.map +1 -0
  159. package/dist/src/services/OverseerService.d.ts +322 -0
  160. package/dist/src/services/OverseerService.d.ts.map +1 -0
  161. package/dist/src/services/PoolCacheManager.d.ts +2 -2
  162. package/dist/src/services/PoolCacheManager.d.ts.map +1 -1
  163. package/dist/src/services/PoolService.d.ts +61 -7
  164. package/dist/src/services/PoolService.d.ts.map +1 -1
  165. package/dist/src/services/PoolStateManager.d.ts +2 -2
  166. package/dist/src/services/PoolStateManager.d.ts.map +1 -1
  167. package/dist/src/services/PriceHistoryService.d.ts.map +1 -1
  168. package/dist/src/services/SignatureService.d.ts.map +1 -1
  169. package/dist/src/services/StreamChatService.d.ts +378 -0
  170. package/dist/src/services/StreamChatService.d.ts.map +1 -0
  171. package/dist/src/services/StreamTokenServiceBase.d.ts +371 -0
  172. package/dist/src/services/StreamTokenServiceBase.d.ts.map +1 -0
  173. package/dist/src/services/StreamWebSocketService.d.ts +268 -0
  174. package/dist/src/services/StreamWebSocketService.d.ts.map +1 -0
  175. package/dist/src/services/StreamingEventService.d.ts +431 -0
  176. package/dist/src/services/StreamingEventService.d.ts.map +1 -0
  177. package/dist/src/services/StreamingService.d.ts +547 -0
  178. package/dist/src/services/StreamingService.d.ts.map +1 -0
  179. package/dist/src/services/SwapEventQueue.d.ts +2 -2
  180. package/dist/src/services/SwapEventQueue.d.ts.map +1 -1
  181. package/dist/src/services/TokenBanService.d.ts +214 -0
  182. package/dist/src/services/TokenBanService.d.ts.map +1 -0
  183. package/dist/src/services/TokenClassKeyService.d.ts.map +1 -1
  184. package/dist/src/services/TokenMetadataCache.d.ts +36 -27
  185. package/dist/src/services/TokenMetadataCache.d.ts.map +1 -1
  186. package/dist/src/services/TokenMetadataService.d.ts +24 -4
  187. package/dist/src/services/TokenMetadataService.d.ts.map +1 -1
  188. package/dist/src/services/TokenResolverService.d.ts.map +1 -1
  189. package/dist/src/services/TradeService.d.ts +73 -0
  190. package/dist/src/services/TradeService.d.ts.map +1 -1
  191. package/dist/src/services/UserService.d.ts +56 -3
  192. package/dist/src/services/UserService.d.ts.map +1 -1
  193. package/dist/src/services/WebSocketService.d.ts +3 -3
  194. package/dist/src/services/WebSocketService.d.ts.map +1 -1
  195. package/dist/src/services/WrapService.d.ts +18 -5
  196. package/dist/src/services/WrapService.d.ts.map +1 -1
  197. package/dist/src/services/WrappableTokenCache.d.ts +8 -36
  198. package/dist/src/services/WrappableTokenCache.d.ts.map +1 -1
  199. package/dist/src/services/WrappableTokenService.d.ts +18 -12
  200. package/dist/src/services/WrappableTokenService.d.ts.map +1 -1
  201. package/dist/src/services/shared/cache-helpers.d.ts +188 -0
  202. package/dist/src/services/shared/cache-helpers.d.ts.map +1 -0
  203. package/dist/src/services/shared/http-helpers.d.ts +146 -0
  204. package/dist/src/services/shared/http-helpers.d.ts.map +1 -0
  205. package/dist/src/services/shared/pagination-helpers.d.ts +157 -0
  206. package/dist/src/services/shared/pagination-helpers.d.ts.map +1 -0
  207. package/dist/src/services/shared/service-validators.d.ts +137 -0
  208. package/dist/src/services/shared/service-validators.d.ts.map +1 -0
  209. package/dist/src/services/shared/websocket-helpers.d.ts +158 -0
  210. package/dist/src/services/shared/websocket-helpers.d.ts.map +1 -0
  211. package/dist/src/test-constants.d.ts +29 -0
  212. package/dist/src/test-constants.d.ts.map +1 -0
  213. package/dist/src/types/api-key.dto.d.ts +300 -0
  214. package/dist/src/types/api-key.dto.d.ts.map +1 -0
  215. package/dist/src/types/backend-responses.d.ts +12 -0
  216. package/dist/src/types/backend-responses.d.ts.map +1 -1
  217. package/dist/src/types/ban.dto.d.ts +413 -0
  218. package/dist/src/types/ban.dto.d.ts.map +1 -0
  219. package/dist/src/types/burn.dto.d.ts +21 -0
  220. package/dist/src/types/burn.dto.d.ts.map +1 -1
  221. package/dist/src/types/chat-messages.dto.d.ts +193 -0
  222. package/dist/src/types/chat-messages.dto.d.ts.map +1 -0
  223. package/dist/src/types/comment.dto.d.ts +180 -0
  224. package/dist/src/types/comment.dto.d.ts.map +1 -0
  225. package/dist/src/types/comments.dto.d.ts +210 -0
  226. package/dist/src/types/comments.dto.d.ts.map +1 -0
  227. package/dist/src/types/common.d.ts +369 -0
  228. package/dist/src/types/common.d.ts.map +1 -1
  229. package/dist/src/types/constraints.d.ts +374 -0
  230. package/dist/src/types/constraints.d.ts.map +1 -0
  231. package/dist/src/types/content-flag.dto.d.ts +310 -0
  232. package/dist/src/types/content-flag.dto.d.ts.map +1 -0
  233. package/dist/src/types/content-reactions.dto.d.ts +132 -0
  234. package/dist/src/types/content-reactions.dto.d.ts.map +1 -0
  235. package/dist/src/types/dex-pool.dto.d.ts +13 -37
  236. package/dist/src/types/dex-pool.dto.d.ts.map +1 -1
  237. package/dist/src/types/dto.d.ts +8 -0
  238. package/dist/src/types/dto.d.ts.map +1 -1
  239. package/dist/src/types/galachain-api.types.d.ts +30 -0
  240. package/dist/src/types/galachain-api.types.d.ts.map +1 -1
  241. package/dist/src/types/gswap-responses.types.d.ts.map +1 -1
  242. package/dist/src/types/launchpad.dto.d.ts +234 -131
  243. package/dist/src/types/launchpad.dto.d.ts.map +1 -1
  244. package/dist/src/types/launchpad.validation.d.ts.map +1 -1
  245. package/dist/src/types/lock.dto.d.ts +20 -35
  246. package/dist/src/types/lock.dto.d.ts.map +1 -1
  247. package/dist/src/types/moderator.dto.d.ts +581 -0
  248. package/dist/src/types/moderator.dto.d.ts.map +1 -0
  249. package/dist/src/types/options.dto.d.ts +25 -115
  250. package/dist/src/types/options.dto.d.ts.map +1 -1
  251. package/dist/src/types/overseer.dto.d.ts +420 -0
  252. package/dist/src/types/overseer.dto.d.ts.map +1 -0
  253. package/dist/src/types/pool.dto.d.ts +106 -0
  254. package/dist/src/types/pool.dto.d.ts.map +1 -0
  255. package/dist/src/types/result.types.d.ts +3 -2
  256. package/dist/src/types/result.types.d.ts.map +1 -1
  257. package/dist/src/types/session-auth.dto.d.ts +91 -0
  258. package/dist/src/types/session-auth.dto.d.ts.map +1 -0
  259. package/dist/src/types/stream-chat.dto.d.ts +815 -0
  260. package/dist/src/types/stream-chat.dto.d.ts.map +1 -0
  261. package/dist/src/types/streaming-events.dto.d.ts +586 -0
  262. package/dist/src/types/streaming-events.dto.d.ts.map +1 -0
  263. package/dist/src/types/streaming.dto.d.ts +1141 -0
  264. package/dist/src/types/streaming.dto.d.ts.map +1 -0
  265. package/dist/src/types/token-ban.dto.d.ts +195 -0
  266. package/dist/src/types/token-ban.dto.d.ts.map +1 -0
  267. package/dist/src/types/trade.dto.d.ts +21 -61
  268. package/dist/src/types/trade.dto.d.ts.map +1 -1
  269. package/dist/src/types/trades-query.dto.d.ts +127 -0
  270. package/dist/src/types/trades-query.dto.d.ts.map +1 -0
  271. package/dist/src/types/transfer.dto.d.ts +20 -15
  272. package/dist/src/types/transfer.dto.d.ts.map +1 -1
  273. package/dist/src/types/user.dto.d.ts +185 -73
  274. package/dist/src/types/user.dto.d.ts.map +1 -1
  275. package/dist/src/types/wrappable-token.dto.d.ts +6 -2
  276. package/dist/src/types/wrappable-token.dto.d.ts.map +1 -1
  277. package/dist/src/utils/LiquidityEventExtractor.d.ts.map +1 -1
  278. package/dist/src/utils/Logger.d.ts.map +1 -1
  279. package/dist/src/utils/MonitoringMetrics.d.ts.map +1 -1
  280. package/dist/src/utils/PoolKeyNormalizer.d.ts.map +1 -1
  281. package/dist/src/utils/ReconnectionManager.d.ts +142 -0
  282. package/dist/src/utils/ReconnectionManager.d.ts.map +1 -0
  283. package/dist/src/utils/SignatureHelper.d.ts +9 -0
  284. package/dist/src/utils/SignatureHelper.d.ts.map +1 -1
  285. package/dist/src/utils/SwapEventExtractor.d.ts.map +1 -1
  286. package/dist/src/utils/adapters.d.ts.map +1 -1
  287. package/dist/src/utils/address-formatter.d.ts +317 -0
  288. package/dist/src/utils/address-formatter.d.ts.map +1 -0
  289. package/dist/src/utils/agent-config.d.ts.map +1 -1
  290. package/dist/src/utils/amount-validator.d.ts +268 -0
  291. package/dist/src/utils/amount-validator.d.ts.map +1 -0
  292. package/dist/src/utils/api-patterns.d.ts +347 -0
  293. package/dist/src/utils/api-patterns.d.ts.map +1 -0
  294. package/dist/src/utils/array-helpers.d.ts +115 -0
  295. package/dist/src/utils/array-helpers.d.ts.map +1 -0
  296. package/dist/src/utils/async-patterns.d.ts +272 -0
  297. package/dist/src/utils/async-patterns.d.ts.map +1 -0
  298. package/dist/src/utils/auto-pagination.d.ts +195 -2
  299. package/dist/src/utils/auto-pagination.d.ts.map +1 -1
  300. package/dist/src/utils/bignumber-helpers.d.ts +119 -13
  301. package/dist/src/utils/bignumber-helpers.d.ts.map +1 -1
  302. package/dist/src/utils/bignumber-pool-cache.d.ts.map +1 -1
  303. package/dist/src/utils/bondingCurveCalculations.d.ts.map +1 -1
  304. package/dist/src/utils/cacheWarmingHelpers.d.ts +2 -2
  305. package/dist/src/utils/cacheWarmingHelpers.d.ts.map +1 -1
  306. package/dist/src/utils/data-transform-patterns.d.ts +393 -0
  307. package/dist/src/utils/data-transform-patterns.d.ts.map +1 -0
  308. package/dist/src/utils/date-utils.d.ts +166 -0
  309. package/dist/src/utils/date-utils.d.ts.map +1 -1
  310. package/dist/src/utils/delimiter-parser.d.ts +139 -0
  311. package/dist/src/utils/delimiter-parser.d.ts.map +1 -0
  312. package/dist/src/utils/error-factories.d.ts +346 -1
  313. package/dist/src/utils/error-factories.d.ts.map +1 -1
  314. package/dist/src/utils/error-handling-patterns.d.ts +390 -0
  315. package/dist/src/utils/error-handling-patterns.d.ts.map +1 -0
  316. package/dist/src/utils/error-patterns.d.ts +360 -0
  317. package/dist/src/utils/error-patterns.d.ts.map +1 -0
  318. package/dist/src/utils/error-utils.d.ts +250 -0
  319. package/dist/src/utils/error-utils.d.ts.map +1 -1
  320. package/dist/src/utils/error-wrapper.d.ts +208 -0
  321. package/dist/src/utils/error-wrapper.d.ts.map +1 -0
  322. package/dist/src/utils/errors.d.ts +70 -0
  323. package/dist/src/utils/errors.d.ts.map +1 -1
  324. package/dist/src/utils/http-factory.d.ts +36 -0
  325. package/dist/src/utils/http-factory.d.ts.map +1 -0
  326. package/dist/src/utils/http.d.ts.map +1 -1
  327. package/dist/src/utils/load-env.d.ts.map +1 -1
  328. package/dist/src/utils/multipart.d.ts.map +1 -1
  329. package/dist/src/utils/numeric-patterns.d.ts +289 -0
  330. package/dist/src/utils/numeric-patterns.d.ts.map +1 -0
  331. package/dist/src/utils/numeric-wrappers.d.ts +146 -0
  332. package/dist/src/utils/numeric-wrappers.d.ts.map +1 -0
  333. package/dist/src/utils/object-extractors.d.ts +115 -0
  334. package/dist/src/utils/object-extractors.d.ts.map +1 -0
  335. package/dist/src/utils/object-patterns.d.ts +81 -0
  336. package/dist/src/utils/object-patterns.d.ts.map +1 -0
  337. package/dist/src/utils/pagination-helpers.d.ts +230 -0
  338. package/dist/src/utils/pagination-helpers.d.ts.map +1 -0
  339. package/dist/src/utils/pool-pair-parser.d.ts +3 -1
  340. package/dist/src/utils/pool-pair-parser.d.ts.map +1 -1
  341. package/dist/src/utils/pool-state-validator.d.ts.map +1 -1
  342. package/dist/src/utils/position-filters.d.ts +1 -2
  343. package/dist/src/utils/position-filters.d.ts.map +1 -1
  344. package/dist/src/utils/query-params.d.ts +0 -16
  345. package/dist/src/utils/query-params.d.ts.map +1 -1
  346. package/dist/src/utils/response-handlers.d.ts +149 -20
  347. package/dist/src/utils/response-handlers.d.ts.map +1 -1
  348. package/dist/src/utils/response-helpers.d.ts +28 -0
  349. package/dist/src/utils/response-helpers.d.ts.map +1 -0
  350. package/dist/src/utils/response-normalizers.d.ts +27 -49
  351. package/dist/src/utils/response-normalizers.d.ts.map +1 -1
  352. package/dist/src/utils/safe-parsers.d.ts +487 -0
  353. package/dist/src/utils/safe-parsers.d.ts.map +1 -0
  354. package/dist/src/utils/service-validators.d.ts +268 -0
  355. package/dist/src/utils/service-validators.d.ts.map +1 -0
  356. package/dist/src/utils/slippage-utils.d.ts.map +1 -1
  357. package/dist/src/utils/string-patterns.d.ts +404 -0
  358. package/dist/src/utils/string-patterns.d.ts.map +1 -0
  359. package/dist/src/utils/string-transforms.d.ts +89 -0
  360. package/dist/src/utils/string-transforms.d.ts.map +1 -0
  361. package/dist/src/utils/string-utils.d.ts +108 -0
  362. package/dist/src/utils/string-utils.d.ts.map +1 -0
  363. package/dist/src/utils/swap-delta-calculator.d.ts.map +1 -1
  364. package/dist/src/utils/tick-crossing-handler.d.ts.map +1 -1
  365. package/dist/src/utils/token-format-converter.d.ts +22 -8
  366. package/dist/src/utils/token-format-converter.d.ts.map +1 -1
  367. package/dist/src/utils/token-parser.d.ts +2 -2
  368. package/dist/src/utils/token-parser.d.ts.map +1 -1
  369. package/dist/src/utils/token-stringification.d.ts +168 -0
  370. package/dist/src/utils/token-stringification.d.ts.map +1 -0
  371. package/dist/src/utils/tokenNameNormalizer.d.ts +96 -0
  372. package/dist/src/utils/tokenNameNormalizer.d.ts.map +1 -0
  373. package/dist/src/utils/tokenNormalizer.d.ts +8 -45
  374. package/dist/src/utils/tokenNormalizer.d.ts.map +1 -1
  375. package/dist/src/utils/transfer-validation.d.ts +1 -1
  376. package/dist/src/utils/transfer-validation.d.ts.map +1 -1
  377. package/dist/src/utils/type-guard-factory.d.ts +260 -0
  378. package/dist/src/utils/type-guard-factory.d.ts.map +1 -0
  379. package/dist/src/utils/unique-key-generator.d.ts +148 -0
  380. package/dist/src/utils/unique-key-generator.d.ts.map +1 -0
  381. package/dist/src/utils/validation-helpers.d.ts +906 -183
  382. package/dist/src/utils/validation-helpers.d.ts.map +1 -1
  383. package/dist/src/utils/validation-patterns.d.ts +745 -0
  384. package/dist/src/utils/validation-patterns.d.ts.map +1 -0
  385. package/dist/src/utils/validation.d.ts +2 -30
  386. package/dist/src/utils/validation.d.ts.map +1 -1
  387. package/dist/src/utils/wallet.d.ts +12 -1
  388. package/dist/src/utils/wallet.d.ts.map +1 -1
  389. package/dist/src/utils/websocket-patterns.d.ts +681 -0
  390. package/dist/src/utils/websocket-patterns.d.ts.map +1 -0
  391. package/dist/src/utils/websocket-validators.d.ts.map +1 -1
  392. package/package.json +86 -19
  393. package/dist/src/bridge/strategies/index.d.ts +0 -9
  394. package/dist/src/bridge/strategies/index.d.ts.map +0 -1
  395. package/dist/src/constants/counts.d.ts +0 -66
  396. package/dist/src/constants/counts.d.ts.map +0 -1
  397. package/dist/src/services/WebSocketManager.d.ts +0 -99
  398. package/dist/src/services/WebSocketManager.d.ts.map +0 -1
  399. package/dist/src/types/eip712-types.d.ts +0 -140
  400. package/dist/src/types/eip712-types.d.ts.map +0 -1
  401. package/dist/src/types/pool-state-manager-config.dto.d.ts +0 -103
  402. package/dist/src/types/pool-state-manager-config.dto.d.ts.map +0 -1
  403. package/dist/src/utils/number-utils.d.ts +0 -94
  404. package/dist/src/utils/number-utils.d.ts.map +0 -1
  405. package/dist/src/utils/precision-math.d.ts +0 -37
  406. 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":"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"}