@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.
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,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"}