@gala-chain/launchpad-sdk 5.0.3 → 5.0.4-beta.0

package/dist/src/services/UserService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UserService.d.ts","sourceRoot":"","sources":["../../../src/services/UserService.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAU3C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EAEjB,yBAAyB,EAO1B,MAAM,mBAAmB,CAAC;AAQ3B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,WAAY,SAAQ,WAAW;gBAC9B,IAAI,EAAE,UAAU,EAAE,SAAS,GAAE,OAAe;IAIxD;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IAEG,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAyBlD;;;;;;;;;;;OAWG;IACG,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAyD3D;;;;;;;OAOG;IACG,kBAAkB,CACtB,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,MAAM,CAAC;IAqElB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACG,cAAc,CAClB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,mBAAmB,CAAC;IAO/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACG,eAAe,CACnB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,mBAAmB,CAAC;IAO/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACG,kBAAkB,CACtB,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GACnF,OAAO,CAAC,mBAAmB,CAAC;IA4B/B;;;;;;;;;;;;;;;;OAgBG;YACW,iBAAiB;IAwD/B;;;;OAIG;IACH,OAAO,CAAC,2BAA2B;IAuCnC;;;;OAIG;IACH,OAAO,CAAC,yBAAyB;IAkBjC;;;;OAIG;IACH,OAAO,CAAC,iCAAiC;CAW1C"}
+{"version":3,"file":"UserService.d.ts","sourceRoot":"","sources":["../../../src/services/UserService.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAa3C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAI5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EAEjB,yBAAyB,EAEzB,uBAAuB,EACvB,mBAAmB,EAQpB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,WAAY,SAAQ,WAAW;gBAC9B,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,SAAS,GAAE,OAAe;IAI3E;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IAEG,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAqBlD;;;;;;;;;;;;;;OAcG;IACG,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqC3D;;;;;;;;;;OAUG;IACG,kBAAkB,CACtB,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,MAAM,CAAC;IAgDlB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACG,cAAc,CAClB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,mBAAmB,CAAC;IAO/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACG,eAAe,CACnB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,mBAAmB,CAAC;IAO/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACG,kBAAkB,CACtB,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GACnF,OAAO,CAAC,mBAAmB,CAAC;IAgC/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4CG;IACG,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA4B3F;;;;;;;;;;;;;;;;OAgBG;YACW,iBAAiB;IAqD/B;;;;OAIG;IACH,OAAO,CAAC,2BAA2B;IAsCnC;;;;OAIG;IACH,OAAO,CAAC,yBAAyB;IAgBjC;;;;OAIG;IACH,OAAO,CAAC,iCAAiC;CAO1C"}

package/dist/src/services/WebSocketService.d.ts

@@ -94,7 +94,7 @@ export declare class WebSocketService extends LoggerBase {
     private config;
     private listeners;
     private timeouts;
-    private reconnectCount;
+    private reconnectionManager;
     private debug;
     private isSocketIOAvailable;
     private hasOnAnyListener;
@@ -109,12 +109,12 @@ export declare class WebSocketService extends LoggerBase {
      * 4. Event is lost forever, SDK hangs waiting for confirmation
      *
      * **The Solution:**
-     * Use a catch-all listener to buffer ALL bundler events, regardless of
+     * Use SimpleCache with 30s TTL to auto-clean orphaned events.
+     * Buffers ALL bundler events via catch-all listener, regardless of
      * when the specific transactionId listener is registered. This ensures
      * no events are ever lost, even if they arrive milliseconds early.
      */
     private eventBuffer;
-    private eventBufferTimeouts;
     private readonly MAX_BUFFER_SIZE;
     constructor(config: WebSocketConfig, debug?: boolean);
     /**

package/dist/src/services/WebSocketService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WebSocketService.d.ts","sourceRoot":"","sources":["../../../src/services/WebSocketService.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAM,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAEL,oBAAoB,EAErB,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,MAAM,WAAW,eAAe;IAC9B,sDAAsD;IACtD,GAAG,EAAE,MAAM,CAAC;IACZ,oEAAoE;IACpE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,0EAA0E;IAC1E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,SAAS,CACL;IACZ,OAAO,CAAC,QAAQ,CAA0C;IAC1D,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,KAAK,CAAU;IACvB,OAAO,CAAC,mBAAmB,CAAU;IACrC,OAAO,CAAC,gBAAgB,CAAS;IACjC;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,mBAAmB,CAA0C;IACrE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAQ;gBAE5B,MAAM,EAAE,eAAe,EAAE,KAAK,GAAE,OAAe;IAc3D;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IAiBjC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAiI9B;;;;;;;OAOG;IACG,kBAAkB,CACtB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,GAC5C,OAAO,CAAC,IAAI,CAAC;IA2FhB;;;;;;;;OAQG;IACH,OAAO,CAAC,uBAAuB;IA2F/B;;OAEG;IACG,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAY3E;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB;;OAEG;YACW,eAAe;IAmB7B;;OAEG;IACH,UAAU,IAAI,IAAI;IAoClB;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;;;;;;;;;;;OAYG;IACH,SAAS,IAAI,MAAM,GAAG,IAAI;CAG3B"}
+{"version":3,"file":"WebSocketService.d.ts","sourceRoot":"","sources":["../../../src/services/WebSocketService.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAM,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,EAEL,oBAAoB,EAErB,MAAM,0BAA0B,CAAC;AAMlC,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,MAAM,WAAW,eAAe;IAC9B,sDAAsD;IACtD,GAAG,EAAE,MAAM,CAAC;IACZ,oEAAoE;IACpE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,0EAA0E;IAC1E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,SAAS,CACL;IACZ,OAAO,CAAC,QAAQ,CAA0C;IAC1D,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,KAAK,CAAU;IACvB,OAAO,CAAC,mBAAmB,CAAU;IACrC,OAAO,CAAC,gBAAgB,CAAS;IACjC;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAQ;gBAE5B,MAAM,EAAE,eAAe,EAAE,KAAK,GAAE,OAAe;IAuB3D;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IAkBjC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgH9B;;;;;;;OAOG;IACG,kBAAkB,CACtB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,GAC5C,OAAO,CAAC,IAAI,CAAC;IAsFhB;;;;;;;;OAQG;IACH,OAAO,CAAC,uBAAuB;IA2F/B;;OAEG;IACG,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAY3E;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB;;OAEG;YACW,eAAe;IAmB7B;;OAEG;IACH,UAAU,IAAI,IAAI;IAiClB;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;;;;;;;;;;;OAYG;IACH,SAAS,IAAI,MAAM,GAAG,IAAI;CAG3B"}

package/dist/src/services/WrapService.d.ts

@@ -15,6 +15,7 @@ import type { Wallet } from 'ethers';
 import type { WrappableTokenService } from './WrappableTokenService.js';
 import type { GalaConnectClient } from '../bridge/GalaConnectClient.js';
 import { Logger } from '../utils/Logger.js';
+import { LoggerBase } from './BaseService.js';
 import type { TokenId } from '../types/common.js';
 import type { WrapTokenOptions, UnwrapTokenOptions, WrapUnwrapResult, WrapUnwrapFeeEstimate, WrapUnwrapStatusResult } from '../types/wrappable-token.dto.js';
 /**
@@ -53,12 +54,11 @@ export interface WrapServiceConfig {
  * });
  * ```
  */
-export declare class WrapService {
+export declare class WrapService extends LoggerBase {
     private readonly galaConnectClient;
     private readonly wrappableTokenService;
     private readonly wallet;
     private readonly walletAddress;
-    private readonly logger;
     constructor(config: WrapServiceConfig);
     /**
      * Wrap a token to its asset-channel counterpart
@@ -108,6 +108,7 @@ export declare class WrapService {
      * @param tokenId - Token to wrap
      * @param amount - Amount to wrap
      * @returns Promise<WrapUnwrapFeeEstimate> - Fee estimate
+     * @throws ValidationError if tokenId or amount is required but not provided
      */
     estimateWrapFee(tokenId: TokenId, _amount: string): Promise<WrapUnwrapFeeEstimate>;
     /**
@@ -116,15 +117,18 @@ export declare class WrapService {
      * @param tokenId - Token to unwrap
      * @param amount - Amount to unwrap
      * @returns Promise<WrapUnwrapFeeEstimate> - Fee estimate
+     * @throws ValidationError if tokenId or amount is required but not provided
      */
     estimateUnwrapFee(tokenId: TokenId, _amount: string): Promise<WrapUnwrapFeeEstimate>;
     /**
      * Get status of a wrap/unwrap transaction
      *
-     * Uses the same GetBridgeStatus endpoint as external bridges.
+     * Cross-channel wrapping completes immediately (synchronous on-chain).
+     * This method returns the completed status for the given transaction ID.
      *
      * @param transactionId - Transaction ID to check
-     * @returns Promise<WrapUnwrapStatusResult> - Current status
+     * @returns Promise<WrapUnwrapStatusResult> - Current status (always completed for wrap/unwrap)
+     * @throws ValidationError if transactionId is required but not provided
      */
     getWrapStatus(transactionId: string): Promise<WrapUnwrapStatusResult>;
     /**
@@ -139,6 +143,15 @@ export declare class WrapService {
      * @see docs/api-calls/swapBridgeOut.txt for working payload example
      */
     private executeChannelBridge;
+    /**
+     * Execute wrap bridge request with comprehensive error handling
+     *
+     * Uses direct try-catch (not withErrorHandling wrapper) because this method
+     * returns structured error responses (WrapUnwrapResult with success: false)
+     * rather than throwing. This is appropriate for a private helper method that
+     * normalizes errors into the return type.
+     */
+    private executeWrapBridgeRequest;
     /**
      * Determine channel routing for wrap/unwrap operation
      *
@@ -152,7 +165,7 @@ export declare class WrapService {
      */
     private requireWallet;
     /**
-     * Format tokenId for error messages
+     * Format tokenId for error messages using centralized stringification
      */
     private formatTokenId;
 }

package/dist/src/services/WrapService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WrapService.d.ts","sourceRoot":"","sources":["../../../src/services/WrapService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EAEvB,MAAM,iCAAiC,CAAC;AAoBzC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0EAA0E;IAC1E,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,+CAA+C;IAC/C,qBAAqB,EAAE,qBAAqB,CAAC;IAC7C,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA4CD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoB;IACtD,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAwB;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,iBAAiB;IAYrC;;;;;;;;;;;;;;;;;;;OAmBG;IACG,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAgDrE;;;;;;;;;;;;;;;;;;;OAmBG;IACG,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAgDzE;;;;;;OAMG;IACG,eAAe,CACnB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,qBAAqB,CAAC;IA8BjC;;;;;;OAMG;IACG,iBAAiB,CACrB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,qBAAqB,CAAC;IA8BjC;;;;;;;OAOG;IACG,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAmB3E;;;;;;;;;;OAUG;YACW,oBAAoB;IA4MlC;;;;;;OAMG;IACH,OAAO,CAAC,uBAAuB;IAwB/B;;OAEG;IACH,OAAO,CAAC,aAAa;IAUrB;;OAEG;IACH,OAAO,CAAC,aAAa;CAMtB"}
+{"version":3,"file":"WrapService.d.ts","sourceRoot":"","sources":["../../../src/services/WrapService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EAEvB,MAAM,iCAAiC,CAAC;AAuBzC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0EAA0E;IAC1E,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,+CAA+C;IAC/C,qBAAqB,EAAE,qBAAqB,CAAC;IAC7C,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA4CD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,WAAY,SAAQ,UAAU;IACzC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoB;IACtD,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAwB;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;gBAEvC,MAAM,EAAE,iBAAiB;IAYrC;;;;;;;;;;;;;;;;;;;OAmBG;IACG,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAgDrE;;;;;;;;;;;;;;;;;;;OAmBG;IACG,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAgDzE;;;;;;;OAOG;IACG,eAAe,CACnB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,qBAAqB,CAAC;IAqCjC;;;;;;;OAOG;IACG,iBAAiB,CACrB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,qBAAqB,CAAC;IAqCjC;;;;;;;;;OASG;IACG,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAsB3E;;;;;;;;;;OAUG;YACW,oBAAoB;IA6ElC;;;;;;;OAOG;YACW,wBAAwB;IA8JtC;;;;;;OAMG;IACH,OAAO,CAAC,uBAAuB;IAwB/B;;OAEG;IACH,OAAO,CAAC,aAAa;IAUrB;;OAEG;IACH,OAAO,CAAC,aAAa;CAMtB"}

package/dist/src/services/WrappableTokenCache.d.ts

@@ -3,7 +3,7 @@
  *
  * Permanent in-memory cache for wrappable tokens fetched from DEX API.
  * Wrappable tokens are GalaChain-internal token pairs that can be
- * wrapped/unwrapped into each other (e.g., MUSIC ↔ GMUSIC).
+ * wrapped/unwrapped into each other (e.g., MUSIC <-> GMUSIC).
  *
  * ## Cache Architecture
  * - **Primary Index**: Map<tokenId, token> - O(1) by stringifiedTokenClassKey
@@ -19,7 +19,7 @@
  * @since 4.0.18
  */
 import type { WrappableToken, WrappableTokenCacheStats } from '../types/wrappable-token.dto.js';
-import { LoggerBase } from './BaseService.js';
+import { BatchedCacheService } from './BatchedCacheService.js';
 /**
  * Wrappable Token Cache
  *
@@ -31,7 +31,7 @@ import { LoggerBase } from './BaseService.js';
  * const cache = new WrappableTokenCache();
  *
  * // Cache all tokens
- * cache.set(wrappableTokens);
+ * cache.setAll(wrappableTokens);
  *
  * // Check if cached
  * if (cache.has()) {
@@ -42,19 +42,15 @@ import { LoggerBase } from './BaseService.js';
  * const music = cache.getByTokenId('$MUSIC|Unit|none|none');
  * ```
  */
-export declare class WrappableTokenCache extends LoggerBase {
-    /** Primary index: tokenId (stringifiedTokenClassKey) → token */
-    private readonly cache;
-    /** Timestamp when cache was last populated */
-    private lastFetchedAt;
+export declare class WrappableTokenCache extends BatchedCacheService<WrappableToken, WrappableTokenCacheStats> {
     constructor(debugMode?: boolean);
     /**
-     * Normalize tokenId for consistent cache keys
+     * Extract the cache key from a wrappable token
      *
-     * @param tokenId - Stringified TokenClassKey (e.g., "$MUSIC|Unit|none|none")
-     * @returns Normalized tokenId (uppercase, trimmed)
+     * @param token - Wrappable token
+     * @returns The stringifiedTokenClassKey as the key
      */
-    private normalizeTokenId;
+    protected extractKey(token: WrappableToken): string;
     /**
      * Check if cache is populated
      *
@@ -74,36 +70,12 @@ export declare class WrappableTokenCache extends LoggerBase {
      * @returns Wrappable token or undefined if not found
      */
     getByTokenId(tokenId: string): WrappableToken | undefined;
-    /**
-     * Set all tokens (replaces existing cache)
-     *
-     * @param tokens - Array of wrappable tokens
-     */
-    set(tokens: WrappableToken[]): void;
-    /**
-     * Add tokens to cache (merges with existing)
-     *
-     * Used for pagination - adds new tokens without replacing existing.
-     *
-     * @param tokens - Array of wrappable tokens to add
-     */
-    merge(tokens: WrappableToken[]): void;
-    /**
-     * Get fetch timestamp
-     *
-     * @returns Timestamp when cache was last updated, or null if never fetched
-     */
-    getFetchTimestamp(): number | null;
     /**
      * Get cache statistics
      *
      * @returns Cache statistics including token count and timestamp
      */
     getStats(): WrappableTokenCacheStats;
-    /**
-     * Clear cache
-     */
-    clear(): void;
     /**
      * Get number of cached tokens
      *

package/dist/src/services/WrappableTokenCache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WrappableTokenCache.d.ts","sourceRoot":"","sources":["../../../src/services/WrappableTokenCache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAChG,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,mBAAoB,SAAQ,UAAU;IACjD,gEAAgE;IAChE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8B;IAEpD,8CAA8C;IAC9C,OAAO,CAAC,aAAa,CAAuB;gBAEhC,SAAS,GAAE,OAAe;IAKtC;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAIxB;;;;OAIG;IACH,GAAG,IAAI,OAAO;IAId;;;;OAIG;IACH,MAAM,IAAI,cAAc,EAAE;IAI1B;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAKzD;;;;OAIG;IACH,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI;IAYnC;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI;IAUrC;;;;OAIG;IACH,iBAAiB,IAAI,MAAM,GAAG,IAAI;IAIlC;;;;OAIG;IACH,QAAQ,IAAI,wBAAwB;IAQpC;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;;;OAIG;IACH,IAAI,IAAI,MAAM;IAId;;;;;OAKG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAI1C;;;;;OAKG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;CAMhE"}
+{"version":3,"file":"WrappableTokenCache.d.ts","sourceRoot":"","sources":["../../../src/services/WrappableTokenCache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAChG,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,mBAAoB,SAAQ,mBAAmB,CAAC,cAAc,EAAE,wBAAwB,CAAC;gBACxF,SAAS,GAAE,OAAe;IAItC;;;;;OAKG;IACH,SAAS,CAAC,UAAU,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM;IAInD;;;;OAIG;IACH,GAAG,IAAI,OAAO;IAId;;;;OAIG;IACH,MAAM,IAAI,cAAc,EAAE;IAI1B;;;;;OAKG;IACI,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIhE;;;;OAIG;IACI,QAAQ,IAAI,wBAAwB;IAQ3C;;;;OAIG;IACH,IAAI,IAAI,MAAM;IAId;;;;;OAKG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAI1C;;;;;OAKG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;CAMhE"}

package/dist/src/services/WrappableTokenService.d.ts

@@ -18,9 +18,10 @@
  * @category Services
  * @since 4.0.18
  */
-import { HttpClient } from '../utils/http.js';
+import type { HttpClient } from '../utils/http.js';
+import { AbstractTokenFetchService } from './AbstractTokenFetchService.js';
 import type { TokenId } from '../types/common.js';
-import type { WrappableToken, FetchWrappableTokensOptions, FetchWrappableTokensResult, IsTokenWrappableResult, WrappableTokenCacheStats } from '../types/wrappable-token.dto.js';
+import type { WrappableToken, WrappableTokenApiResponse, FetchWrappableTokensOptions, FetchWrappableTokensResult, IsTokenWrappableResult, WrappableTokenCacheStats } from '../types/wrappable-token.dto.js';
 /**
  * WrappableTokenService
  *
@@ -48,11 +49,23 @@ import type { WrappableToken, FetchWrappableTokensOptions, FetchWrappableTokensR
  * console.log(`MUSIC counterpart: ${counterpart?.symbol}`); // GMUSIC
  * ```
  */
-export declare class WrappableTokenService {
-    private readonly dexApiHttp;
-    private readonly logger;
+export declare class WrappableTokenService extends AbstractTokenFetchService<WrappableTokenApiResponse, WrappableToken> {
     private readonly cache;
     constructor(dexApiHttp: HttpClient, debugMode?: boolean);
+    /**
+     * Build API request parameters for wrappable tokens
+     *
+     * @param _context - Unused context parameter (required by base class)
+     * @returns Query parameters with wrappable filter
+     */
+    protected buildApiParams(_context?: Record<string, unknown>): Record<string, string | number | boolean>;
+    /**
+     * Transform API response tokens to SDK format
+     *
+     * @param apiTokens - Raw API response tokens
+     * @returns Array of transformed wrappable tokens
+     */
+    protected transformApiResponse(apiTokens: WrappableTokenApiResponse[]): WrappableToken[];
     /**
      * Fetch wrappable tokens with pagination (metadata only, cached)
      *
@@ -113,12 +126,5 @@ export declare class WrappableTokenService {
      * Clear cache
      */
     clearCache(): void;
-    /**
-     * Transform API response tokens to SDK format
-     *
-     * @param apiTokens - Raw API response tokens
-     * @returns Array of transformed wrappable tokens
-     */
-    private transformTokens;
 }
 //# sourceMappingURL=WrappableTokenService.d.ts.map

package/dist/src/services/WrappableTokenService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WrappableTokenService.d.ts","sourceRoot":"","sources":["../../../src/services/WrappableTokenService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAO9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EACV,cAAc,EAGd,2BAA2B,EAC3B,0BAA0B,EAC1B,sBAAsB,EACtB,wBAAwB,EACzB,MAAM,iCAAiC,CAAC;AAQzC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,qBAAqB;IAK9B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJ7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;gBAGzB,UAAU,EAAE,UAAU,EACvC,SAAS,GAAE,OAAe;IAU5B;;;;;;;;OAQG;IACG,oBAAoB,CACxB,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,0BAA0B,CAAC;IAuDtC;;;;;;;;OAQG;IACG,uBAAuB,IAAI,OAAO,CAAC,0BAA0B,CAAC;IA6DpE;;;;;;;OAOG;IACG,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAgB9E;;;;;;;;;;;;OAYG;IACG,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAO/E;;;;;OAKG;IACG,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAuBzE;;;;OAIG;IACH,aAAa,IAAI,wBAAwB;IAIzC;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;;;;OAKG;IACH,OAAO,CAAC,eAAe;CAwCxB"}
+{"version":3,"file":"WrappableTokenService.d.ts","sourceRoot":"","sources":["../../../src/services/WrappableTokenService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAInD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAG3E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EACV,cAAc,EACd,yBAAyB,EACzB,2BAA2B,EAC3B,0BAA0B,EAC1B,sBAAsB,EACtB,wBAAwB,EACzB,MAAM,iCAAiC,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,qBAAsB,SAAQ,yBAAyB,CAClE,yBAAyB,EACzB,cAAc,CACf;IACC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;gBAEhC,UAAU,EAAE,UAAU,EAAE,SAAS,GAAE,OAAe;IAK9D;;;;;OAKG;IACH,SAAS,CAAC,cAAc,CACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAI5C;;;;;OAKG;IACH,SAAS,CAAC,oBAAoB,CAAC,SAAS,EAAE,yBAAyB,EAAE,GAAG,cAAc,EAAE;IAwCxF;;;;;;;;OAQG;IACG,oBAAoB,CACxB,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,0BAA0B,CAAC;IAoCtC;;;;;;;;OAQG;IACG,uBAAuB,IAAI,OAAO,CAAC,0BAA0B,CAAC;IAqBpE;;;;;;;OAOG;IACG,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAqB9E;;;;;;;;;;;;OAYG;IACG,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAO/E;;;;;OAKG;IACG,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,sBAAsB,CAAC;IA6BzE;;;;OAIG;IACH,aAAa,IAAI,wBAAwB;IAIzC;;OAEG;IACH,UAAU,IAAI,IAAI;CAGnB"}

package/dist/src/services/shared/cache-helpers.d.ts

@@ -0,0 +1,188 @@
+/**
+ * Cache Helpers
+ *
+ * Shared utilities for caching operations across services.
+ * Eliminates duplicate cache-check-fetch-store patterns.
+ *
+ * @category Services
+ * @since 6.4.0
+ */
+import type { Logger } from '../../utils/Logger';
+/**
+ * Options for withCache wrapper
+ */
+export interface WithCacheOptions<K = string> {
+    /** Logger instance for debug output */
+    logger?: Logger;
+    /** Time-to-live in milliseconds (optional, for TTL-based caches) */
+    ttlMs?: number;
+    /** Key generator function (defaults to identity for string keys) */
+    keyGenerator?: (input: K) => string;
+    /** Whether to cache null/undefined results (default: false) */
+    cacheNullish?: boolean;
+}
+/**
+ * Simple in-memory cache with optional TTL support
+ *
+ * Used internally by cache helpers and can be used directly for
+ * custom caching scenarios.
+ *
+ * @typeParam V - Value type stored in cache
+ *
+ * @example
+ * ```typescript
+ * const cache = new SimpleCache<UserData>(60000); // 1 minute TTL
+ * cache.set('user:123', userData);
+ * const cached = cache.get('user:123'); // Returns userData or undefined if expired
+ * ```
+ *
+ * @since 6.4.0
+ */
+export declare class SimpleCache<V> {
+    private defaultTtlMs;
+    private cache;
+    /**
+     * Create a new SimpleCache
+     *
+     * @param defaultTtlMs - Default TTL in milliseconds (0 = no expiration)
+     */
+    constructor(defaultTtlMs?: number);
+    /**
+     * Get a value from cache
+     *
+     * @param key - Cache key
+     * @returns Cached value or undefined if not found/expired
+     */
+    get(key: string): V | undefined;
+    /**
+     * Set a value in cache
+     *
+     * @param key - Cache key
+     * @param value - Value to cache
+     * @param ttlMs - Optional TTL override (uses default if not specified)
+     */
+    set(key: string, value: V, ttlMs?: number): void;
+    /**
+     * Check if a key exists and is not expired
+     *
+     * @param key - Cache key
+     * @returns True if key exists and is not expired
+     */
+    has(key: string): boolean;
+    /**
+     * Delete a key from cache
+     *
+     * @param key - Cache key
+     */
+    delete(key: string): void;
+    /**
+     * Clear all cached entries
+     */
+    clear(): void;
+    /**
+     * Get cache size
+     */
+    get size(): number;
+}
+/**
+ * Wraps an async fetch operation with caching
+ *
+ * Handles the cache-check-fetch-store pattern in a single utility call.
+ *
+ * @typeParam V - The expected value type
+ * @param key - Cache key (string)
+ * @param fetcher - Async function that fetches the data if not cached
+ * @param cache - Cache instance (Map-like interface with get/set)
+ * @param options - Optional configuration
+ * @returns Promise resolving to cached or freshly fetched data
+ *
+ * @example Basic usage with Map
+ * ```typescript
+ * const cache = new Map<string, UserData>();
+ * const user = await withCache(
+ *   `user:${userId}`,
+ *   () => fetchUser(userId),
+ *   cache
+ * );
+ * ```
+ *
+ * @example With TTL-based cache
+ * ```typescript
+ * const cache = new SimpleCache<PoolData>(60000); // 1 minute TTL
+ * const pool = await withCache(
+ *   `pool:${tokenName}`,
+ *   () => fetchPool(tokenName),
+ *   cache,
+ *   { logger: this.logger }
+ * );
+ * ```
+ *
+ * @example With key generator
+ * ```typescript
+ * const user = await withCache(
+ *   { userId, includeProfile: true },
+ *   () => fetchUserWithProfile(userId),
+ *   cache,
+ *   { keyGenerator: (opts) => `user:${opts.userId}:${opts.includeProfile}` }
+ * );
+ * ```
+ *
+ * @since 6.4.0
+ */
+export declare function withCache<V, K = string>(key: K, fetcher: () => Promise<V>, cache: {
+    get: (key: string) => V | undefined;
+    set: (key: string, value: V) => void;
+}, options?: WithCacheOptions<K>): Promise<V>;
+/**
+ * Creates a memoized version of an async function with caching
+ *
+ * Useful for creating cached service methods without manual cache management.
+ *
+ * @typeParam A - Argument type (used for cache key generation)
+ * @typeParam R - Return type
+ * @param fn - Function to memoize
+ * @param keyFn - Function to generate cache key from arguments
+ * @param ttlMs - Time-to-live in milliseconds (0 = no expiration)
+ * @returns Memoized function
+ *
+ * @example
+ * ```typescript
+ * class UserService {
+ *   // Create memoized fetcher with 5 minute TTL
+ *   private fetchUserCached = memoizeAsync(
+ *     (userId: string) => this.fetchUserFromApi(userId),
+ *     (userId) => `user:${userId}`,
+ *     300000 // 5 minutes
+ *   );
+ *
+ *   async getUser(userId: string) {
+ *     return this.fetchUserCached(userId);
+ *   }
+ * }
+ * ```
+ *
+ * @since 6.4.0
+ */
+export declare function memoizeAsync<A, R>(fn: (arg: A) => Promise<R>, keyFn: (arg: A) => string, ttlMs?: number): (arg: A) => Promise<R>;
+/**
+ * Creates a cache key from multiple parts
+ *
+ * Utility for building consistent cache keys across services.
+ *
+ * @param parts - Key parts to join
+ * @param separator - Separator character (default: ':')
+ * @returns Joined cache key string
+ *
+ * @example
+ * ```typescript
+ * const key = buildCacheKey('user', userId, 'profile');
+ * // Result: 'user:abc123:profile'
+ *
+ * const key = buildCacheKey('pool', tokenName, 'stats', { separator: '/' });
+ * // Result: 'pool/mytoken/stats'
+ * ```
+ *
+ * @since 6.4.0
+ */
+export declare function buildCacheKey(...parts: (string | number | boolean)[]): string;
+//# sourceMappingURL=cache-helpers.d.ts.map

package/dist/src/services/shared/cache-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-helpers.d.ts","sourceRoot":"","sources":["../../../../src/services/shared/cache-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,MAAM;IAC1C,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC;IACpC,+DAA+D;IAC/D,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,WAAW,CAAC,CAAC;IAQZ,OAAO,CAAC,YAAY;IAPhC,OAAO,CAAC,KAAK,CAAuD;IAEpE;;;;OAIG;gBACiB,YAAY,GAAE,MAAU;IAE5C;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAa/B;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAShD;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,EAC3C,GAAG,EAAE,CAAC,EACN,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,KAAK,EAAE;IAAE,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,CAAC,GAAG,SAAS,CAAC;IAAC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,CAAA;CAAE,EACpF,OAAO,GAAE,gBAAgB,CAAC,CAAC,CAAM,GAChC,OAAO,CAAC,CAAC,CAAC,CAoCZ;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,EAC/B,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAC1B,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,EACzB,KAAK,GAAE,MAAU,GAChB,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAMxB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,aAAa,CAAC,GAAG,KAAK,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EAAE,GAAG,MAAM,CAE7E"}

package/dist/src/services/shared/http-helpers.d.ts

@@ -0,0 +1,146 @@
+/**
+ * HTTP Helpers
+ *
+ * Shared utilities for HTTP operations across services.
+ * Eliminates duplicate try/catch error handling patterns found in 30+ methods.
+ *
+ * @category Services
+ * @since 6.4.0
+ */
+import type { Logger } from '../../utils/Logger';
+/**
+ * Backend response shape accepted by error handling wrappers.
+ * More lenient than InternalApiResponse - accepts optional message field.
+ * @internal
+ */
+export interface BackendResponseLike<T = unknown> {
+    status: number;
+    error: boolean;
+    message?: string;
+    data?: T;
+}
+/**
+ * Options for withErrorHandling wrapper
+ */
+export interface WithErrorHandlingOptions {
+    /** Context message for error (e.g., "Failed to fetch pools") */
+    errorContext?: string;
+    /** Logger instance for debug output */
+    logger?: Logger;
+    /** Log level for operation start/end (debug only in debug mode) */
+    debugLogEnabled?: boolean;
+}
+/**
+ * Wraps an async HTTP operation with standardized error handling
+ *
+ * Handles try/catch pattern with optional logging in a single utility call.
+ *
+ * @typeParam T - The expected response data type
+ * @param operation - Async function that performs the HTTP operation
+ * @param options - Optional configuration for error handling
+ * @returns Promise resolving to the extracted data
+ *
+ * @example Basic usage
+ * ```typescript
+ * const data = await withErrorHandling(
+ *   () => this.http.get<InternalApiResponse<UserData>>(endpoint),
+ *   { errorContext: 'Failed to fetch user data' }
+ * );
+ * ```
+ *
+ * @example With logging
+ * ```typescript
+ * const data = await withErrorHandling(
+ *   () => this.http.post<InternalApiResponse<Result>>(endpoint, body),
+ *   { errorContext: 'Failed to create resource', logger: this.logger, debugLogEnabled: true }
+ * );
+ * ```
+ *
+ * @since 6.4.0
+ */
+export declare function withErrorHandling<T>(operation: () => Promise<BackendResponseLike<T>>, options?: WithErrorHandlingOptions): Promise<T>;
+/**
+ * Wraps an async HTTP operation that returns raw data (no API wrapper)
+ *
+ * For operations that don't use the InternalApiResponse wrapper.
+ *
+ * @typeParam T - The expected response data type
+ * @param operation - Async function that performs the HTTP operation
+ * @param options - Optional configuration for error handling
+ * @returns Promise resolving to the raw response data
+ *
+ * @example
+ * ```typescript
+ * const data = await withErrorHandlingRaw(
+ *   () => this.http.get<UserData>(endpoint),
+ *   { errorContext: 'Failed to fetch user data', logger: this.logger }
+ * );
+ * ```
+ *
+ * @since 6.4.0
+ */
+export declare function withErrorHandlingRaw<T>(operation: () => Promise<T>, options?: WithErrorHandlingOptions): Promise<T>;
+/**
+ * Wraps an async HTTP operation and returns the validated full response
+ *
+ * Unlike withErrorHandling which extracts response.data, this returns the full
+ * InternalApiResponse after validation. Useful when you need access to response
+ * properties like count, total, or status.
+ *
+ * @typeParam T - The expected response data type
+ * @param operation - Async function that performs the HTTP operation
+ * @param options - Optional configuration for error handling
+ * @returns Promise resolving to the full validated response
+ *
+ * @example
+ * ```typescript
+ * const response = await withResponseValidation(
+ *   () => this.http.get<InternalApiResponse<PoolsData>>(endpoint, params),
+ *   { errorContext: 'Failed to fetch pools' }
+ * );
+ * const pools = normalizePoolResponse(response.data!);
+ * const total = response.data!.count ?? 0;
+ * ```
+ *
+ * @since 6.5.0
+ */
+export declare function withResponseValidation<T>(operation: () => Promise<BackendResponseLike<T>>, options?: WithErrorHandlingOptions): Promise<BackendResponseLike<T>>;
+/**
+ * Type for HTTP method functions
+ */
+export type HttpMethod = 'get' | 'post' | 'put' | 'patch' | 'delete';
+/**
+ * Creates a type-safe HTTP request executor with error handling
+ *
+ * Factory function for creating reusable HTTP executors within services.
+ * Reduces boilerplate when services make many HTTP calls with similar patterns.
+ *
+ * @param http - HttpClient instance
+ * @param logger - Optional logger for debug output
+ * @returns Executor function for making HTTP requests
+ *
+ * @example
+ * ```typescript
+ * class MyService extends BaseService {
+ *   private execute = createHttpExecutor(this.http, this.logger);
+ *
+ *   async getUser(id: string) {
+ *     return this.execute<UserData>('get', `/users/${id}`, 'Failed to get user');
+ *   }
+ *
+ *   async createUser(data: UserInput) {
+ *     return this.execute<UserData>('post', '/users', 'Failed to create user', data);
+ *   }
+ * }
+ * ```
+ *
+ * @since 6.4.0
+ */
+export declare function createHttpExecutor(http: {
+    get: <T>(url: string, params?: Record<string, unknown>, headers?: Record<string, string>) => Promise<T>;
+    post: <T>(url: string, data?: unknown, headers?: Record<string, string>) => Promise<T>;
+    put: <T>(url: string, data?: unknown, headers?: Record<string, string>) => Promise<T>;
+    patch: <T>(url: string, data?: unknown, headers?: Record<string, string>) => Promise<T>;
+    delete: <T>(url: string, params?: Record<string, unknown> | undefined, headers?: Record<string, string>) => Promise<T>;
+}, logger?: Logger): <T>(method: HttpMethod, url: string, errorContext: string, dataOrParams?: unknown, headers?: Record<string, string>) => Promise<T>;
+//# sourceMappingURL=http-helpers.d.ts.map

package/dist/src/services/shared/http-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-helpers.d.ts","sourceRoot":"","sources":["../../../../src/services/shared/http-helpers.ts"],"names":[],"mappings":"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"}