@gala-chain/launchpad-sdk 3.5.2 → 3.6.0

package/dist/services/TradeService.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Trade Service
+ *
+ * Handles all trade-related operations including trade history queries.
+ *
+ * @category Services
+ * @since 3.6.0
+ */
+import { HttpClient } from '../utils/http';
+import { TradesResult } from '../types/trade.dto';
+import { FetchTradesOptions } from '../types/options.dto';
+/**
+ * Trade Service Class
+ *
+ * Provides methods for:
+ * - Fetching trade history with pagination
+ * - Filtering trades by token, user, type, date range
+ *
+ * @example
+ * ```typescript
+ * const tradeService = new TradeService(httpClient);
+ *
+ * // Get first page of trades for a token
+ * const trades = await tradeService.fetchTrades({ tokenName: "dragnrkti" });
+ *
+ * // Get specific page with custom limit
+ * const moreTrades = await tradeService.fetchTrades({
+ *   tokenName: "dragnrkti",
+ *   page: 2,
+ *   limit: 20
+ * });
+ * ```
+ */
+export declare class TradeService {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Gets trades for a token by its tokenName with pagination
+     *
+     * This method provides a clean, intuitive API for fetching token trades
+     * using the token name. Follows the same pattern as CommentAPI.
+     *
+     * @param options Trade fetching options
+     * @returns Promise<TradesResult> Clean trades with full pagination
+     * @throws ValidationError if token name is invalid or not found
+     */
+    fetchTrades(options: FetchTradesOptions): Promise<TradesResult>;
+    /**
+     * Validates pagination parameters
+     *
+     * @private
+     */
+    private validateTradePagination;
+}
+//# sourceMappingURL=TradeService.d.ts.map

package/dist/services/TradeService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TradeService.d.ts","sourceRoot":"","sources":["../../src/services/TradeService.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAK3C,OAAO,EAEL,YAAY,EAEb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAwB,MAAM,sBAAsB,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;;;;;;;;OASG;IACG,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IA2DrE;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;CAyBhC"}

package/dist/services/UserService.d.ts

@@ -0,0 +1,121 @@
+/**
+ * User Service
+ *
+ * Handles all user-related operations including profile management,
+ * token lists, and user data queries.
+ *
+ * @category Services
+ * @since 3.6.0
+ */
+import { HttpClient } from '../utils/http';
+import { GetTokenListOptions, UserTokenListResult, UpdateProfileData, UploadProfileImageOptions } from '../types/user.dto';
+/**
+ * User Service Class
+ *
+ * Provides methods for:
+ * - Profile management (fetch, update)
+ * - Profile image uploads
+ * - Token list queries (created, held)
+ *
+ * @example
+ * ```typescript
+ * const userService = new UserService(httpClient);
+ *
+ * // Get user profile
+ * const profile = await userService.fetchProfile();
+ *
+ * // Update profile
+ * await userService.updateProfile({
+ *   profileImage: "https://example.com/avatar.jpg",
+ *   fullName: "John Doe",
+ *   address: "eth|1234..."
+ * });
+ * ```
+ */
+export declare class UserService {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Fetches user profile information
+     *
+     * @param address Optional wallet address (defaults to SDK wallet address)
+     * @returns Promise<any> User profile information
+     * @throws ValidationError if input validation fails
+     */
+    fetchProfile(address?: string): Promise<any>;
+    /**
+     * Updates user profile information
+     *
+     * **Smart Image Preservation**: If profileImage is empty or not provided,
+     * the method automatically fetches and preserves the existing profile image
+     * to prevent accidental image loss.
+     *
+     * @param data Profile update data
+     * @returns Promise<void> No return data - throws on failure
+     * @throws ValidationError if input validation fails
+     * @throws Error if profile update fails
+     */
+    updateProfile(data: UpdateProfileData): Promise<void>;
+    /**
+     * Uploads a profile image and returns the image URL
+     *
+     * @param options Profile image upload options
+     * @returns Promise<string> Clean image URL
+     * @throws ValidationError if input validation fails
+     * @throws Error if upload fails
+     */
+    uploadProfileImage(options: UploadProfileImageOptions): Promise<string>;
+    /**
+     * Fetches user token list with optional filtering and pagination
+     *
+     * @param options Filtering and pagination options
+     * @returns Promise<UserTokenListResult> Clean token list with proper types
+     * @throws Error if request fails
+     */
+    fetchTokenList(options: GetTokenListOptions): Promise<UserTokenListResult>;
+    /**
+     * Fetches tokens held by user (balances)
+     *
+     * @param options Token held filtering options (address is optional)
+     * @returns Promise<UserTokenListResult> Clean tokens held with full pagination
+     * @throws ValidationError if input validation fails
+     */
+    fetchTokensHeld(options: GetTokenListOptions): Promise<UserTokenListResult>;
+    /**
+     * Fetches tokens created by user
+     *
+     * @param options Options including pagination
+     * @returns Promise<UserTokenListResult> Tokens created by the user
+     */
+    fetchTokensCreated(options?: {
+        page?: number;
+        limit?: number;
+        search?: string;
+        tokenName?: string;
+    }): Promise<UserTokenListResult>;
+    /**
+     * Validates get token list options
+     *
+     * @private
+     */
+    private validateGetTokenListOptions;
+    /**
+     * Validates user pagination parameters
+     *
+     * @private
+     */
+    private validateUserPagination;
+    /**
+     * Validates update profile data
+     *
+     * @private
+     */
+    private validateUpdateProfileData;
+    /**
+     * Validates upload profile image options
+     *
+     * @private
+     */
+    private validateUploadProfileImageOptions;
+}
+//# sourceMappingURL=UserService.d.ts.map

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

@@ -0,0 +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;AAK3C,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EAEjB,yBAAyB,EAO1B,MAAM,mBAAmB,CAAC;AAO3B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;;;;;OAMG;IACG,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAmBlD;;;;;;;;;;;OAWG;IACG,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmD3D;;;;;;;OAOG;IACG,kBAAkB,CACtB,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,MAAM,CAAC;IAoElB;;;;;;OAMG;IACG,cAAc,CAClB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,mBAAmB,CAAC;IA4C/B;;;;;;OAMG;IACG,eAAe,CACnB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,mBAAmB,CAAC;IA2C/B;;;;;OAKG;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;IAsB/B;;;;OAIG;IACH,OAAO,CAAC,2BAA2B;IAuCnC;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IA0B9B;;;;OAIG;IACH,OAAO,CAAC,yBAAyB;IAkBjC;;;;OAIG;IACH,OAAO,CAAC,iCAAiC;CAW1C"}

package/dist/types/launchpad.validation.d.ts

@@ -3,18 +3,21 @@
  *
  * These functions provide client-side validation to catch errors
  * before making API calls to the backend.
+ *
+ * MIGRATION NOTE: This file now uses Zod validators from schemas/validators.ts
+ * while maintaining backward-compatible API for legacy code.
  */
-import { LaunchTokenData } from './launchpad.dto';
+import type { LaunchTokenData } from './launchpad.dto.js';
 /**
- * Validates token name format
+ * Validates token name format using Zod schema
  */
 export declare function isValidTokenName(name: string): boolean;
 /**
- * Validates token symbol format
+ * Validates token symbol format using Zod schema
  */
 export declare function isValidTokenSymbol(symbol: string): boolean;
 /**
- * Validates token description format
+ * Validates token description format using Zod schema
  */
 export declare function isValidTokenDescription(description: string): boolean;
 /**
@@ -26,11 +29,11 @@ export declare function isValidUrl(url: string): boolean;
  */
 export declare function hasAtLeastOneSocialUrl(data: LaunchTokenData): boolean;
 /**
- * Type guard to check if an object is valid LaunchTokenData
+ * Type guard to check if an object is valid LaunchTokenData using Zod schema
  */
 export declare function isValidLaunchTokenData(obj: any): obj is LaunchTokenData;
 /**
- * Generates detailed validation error messages for LaunchTokenData
+ * Generates detailed validation error messages for LaunchTokenData using Zod
  */
 export declare function getLaunchTokenDataValidationErrors(obj: any): string[];
 /**

package/dist/types/launchpad.validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"launchpad.validation.d.ts","sourceRoot":"","sources":["../../src/types/launchpad.validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAyB,MAAM,iBAAiB,CAAC;AAMzE;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAUtD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAa1D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAQpE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAM/C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAarE;AAMD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,eAAe,CAmDvE;AAMD;;GAEG;AACH,wBAAgB,kCAAkC,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,EAAE,CA4DrE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,GAAG,GACR,OAAO,CAAC,IAAI,IAAI,eAAe,CAQjC"}
+{"version":3,"file":"launchpad.validation.d.ts","sourceRoot":"","sources":["../../src/types/launchpad.validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAM1D;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGtD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAG1D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAGpE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO/C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CASrE;AAMD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,eAAe,CAGvE;AAMD;;GAEG;AACH,wBAAgB,kCAAkC,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,EAAE,CAQrE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,GAAG,GACR,OAAO,CAAC,IAAI,IAAI,eAAe,CAQjC"}

package/dist/utils/multipart.d.ts

@@ -3,6 +3,9 @@
  *
  * This module provides cross-platform file upload support for both
  * browser and Node.js environments.
+ *
+ * MIGRATION NOTE: This file now uses Zod schemas for validation while maintaining
+ * backward-compatible API through FileValidationError throwing functions.
  */
 /**
  * Error thrown when file validation fails
@@ -13,7 +16,7 @@ export declare class FileValidationError extends Error {
     constructor(message: string, filename?: string | undefined, mimeType?: string | undefined);
 }
 /**
- * Validates a file against upload constraints
+ * Validates a file against upload constraints using Zod schemas
  *
  * @param file File or Buffer to validate
  * @param filename Original filename (required for Buffer validation)

package/dist/utils/multipart.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"multipart.d.ts","sourceRoot":"","sources":["../../src/utils/multipart.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAGnC,QAAQ,CAAC,EAAE,MAAM;IACjB,QAAQ,CAAC,EAAE,MAAM;gBAFxB,OAAO,EAAE,MAAM,EACR,QAAQ,CAAC,EAAE,MAAM,YAAA,EACjB,QAAQ,CAAC,EAAE,MAAM,YAAA;CAK3B;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,IAAI,GAAG,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI,CAmKN;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CASzD;AA0BD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,IAAI,EACV,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACzB,QAAQ,CAiBV;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACzB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CA0CnD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAuB9C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAM3C"}
+{"version":3,"file":"multipart.d.ts","sourceRoot":"","sources":["../../src/utils/multipart.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAGnC,QAAQ,CAAC,EAAE,MAAM;IACjB,QAAQ,CAAC,EAAE,MAAM;gBAFxB,OAAO,EAAE,MAAM,EACR,QAAQ,CAAC,EAAE,MAAM,YAAA,EACjB,QAAQ,CAAC,EAAE,MAAM,YAAA;CAK3B;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,IAAI,GAAG,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI,CAiGN;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CASzD;AA0BD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,IAAI,EACV,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACzB,QAAQ,CAiBV;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACzB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CA0CnD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAuB9C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAM3C"}

package/dist/utils/query-params.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Query Parameter Building Utilities
+ *
+ * Unified utilities for building backend query parameters.
+ * Replaces multiple duplicate query building methods with a single,
+ * type-safe, reusable utility.
+ *
+ * @category Utilities
+ * @since 3.6.0
+ */
+/**
+ * Configuration for field transformations
+ */
+export interface QueryParamConfig<T> {
+    /** Fields that should be converted to strings */
+    stringifyFields?: (keyof T)[];
+    /** Fields that should be excluded if undefined/empty */
+    optionalFields?: (keyof T)[];
+    /** Custom field name mappings (source -> backend) */
+    fieldMappings?: Partial<Record<keyof T, string>>;
+}
+/**
+ * Builds backend query parameters from typed options object
+ *
+ * This utility consolidates the logic from multiple query building methods:
+ * - buildGetCommentsQueryParams
+ * - buildTradeQueryParams
+ * - buildTokenListQueryParams
+ * - buildTokenHoldQueryParams
+ *
+ * @template T The type of the input options object
+ * @param options Input options to convert to query parameters
+ * @param config Configuration for field transformations
+ * @returns Query parameters ready for backend API
+ *
+ * @example
+ * ```typescript
+ * // Simple pagination
+ * const params = buildBackendQueryParams(
+ *   { page: 1, limit: 10 },
+ *   { stringifyFields: ['page', 'limit'] }
+ * );
+ * // Result: { page: '1', limit: '10' }
+ *
+ * // With optional fields
+ * const params = buildBackendQueryParams(
+ *   { page: 1, limit: 10, search: 'test', tokenName: undefined },
+ *   {
+ *     stringifyFields: ['page', 'limit'],
+ *     optionalFields: ['search', 'tokenName']
+ *   }
+ * );
+ * // Result: { page: '1', limit: '10', search: 'test' }
+ *
+ * // With field mappings
+ * const params = buildBackendQueryParams(
+ *   { walletAddress: 'eth|123', amount: '100' },
+ *   { fieldMappings: { walletAddress: 'userAddress' } }
+ * );
+ * // Result: { userAddress: 'eth|123', amount: '100' }
+ * ```
+ */
+export declare function buildBackendQueryParams<T extends Record<string, any>>(options: T, config?: QueryParamConfig<T>): Record<string, any>;
+/**
+ * Builds pagination query parameters (common pattern)
+ *
+ * Convenience function for the most common use case: pagination with page/limit.
+ *
+ * @param page Page number
+ * @param limit Items per page
+ * @returns Query parameters with stringified page and limit
+ *
+ * @example
+ * ```typescript
+ * const params = buildPaginationParams(2, 20);
+ * // Result: { page: '2', limit: '20' }
+ * ```
+ */
+export declare function buildPaginationParams(page: number, limit: number): Record<string, string>;
+/**
+ * Builds token query parameters with pagination
+ *
+ * Common pattern for token-related endpoints that support
+ * pagination plus optional filters.
+ *
+ * @param tokenName Token name to query
+ * @param page Page number
+ * @param limit Items per page
+ * @returns Query parameters ready for backend API
+ *
+ * @example
+ * ```typescript
+ * const params = buildTokenQueryParams('mytoken', 1, 10);
+ * // Result: { tokenName: 'mytoken', page: '1', limit: '10' }
+ * ```
+ */
+export declare function buildTokenQueryParams(tokenName: string, page: number, limit: number): Record<string, any>;
+//# sourceMappingURL=query-params.d.ts.map

package/dist/utils/query-params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-params.d.ts","sourceRoot":"","sources":["../../src/utils/query-params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,iDAAiD;IACjD,eAAe,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;IAC9B,wDAAwD;IACxD,cAAc,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;IAC7B,qDAAqD;IACrD,aAAa,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;CAClD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACnE,OAAO,EAAE,CAAC,EACV,MAAM,GAAE,gBAAgB,CAAC,CAAC,CAAM,GAC/B,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAyCrB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKxB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAKrB"}

package/dist/utils/response-normalizers.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Response Normalization Utilities
+ *
+ * Utilities for normalizing backend API responses into consistent formats.
+ * Handles the various response structure variations from the backend API,
+ * reducing complexity in service methods.
+ *
+ * @category Utilities
+ * @since 3.6.0
+ */
+/**
+ * Normalizes pool response data into consistent array format
+ *
+ * The backend API returns pools in different formats depending on the query:
+ * - Single token: { tokens: {pool data} }
+ * - Multiple tokens: { tokens: [{pool data}] }
+ * - Legacy format: { pools: [{pool data}] }
+ *
+ * This normalizer ensures we always get an array of pools with proper Date objects.
+ *
+ * @param data Raw response data from backend
+ * @returns Normalized array of pools with Date objects
+ *
+ * @example
+ * ```typescript
+ * // Single token response
+ * const normalized = normalizePoolResponse({
+ *   tokens: { id: 1, created_at: '2024-01-01' }
+ * });
+ * // Result: [{ id: 1, createdAt: Date('2024-01-01') }]
+ *
+ * // Multiple tokens response
+ * const normalized = normalizePoolResponse({
+ *   tokens: [{ id: 1, created_at: '2024-01-01' }, { id: 2, created_at: '2024-01-02' }]
+ * });
+ * // Result: [{ id: 1, createdAt: Date('2024-01-01') }, { id: 2, createdAt: Date('2024-01-02') }]
+ * ```
+ */
+export declare function normalizePoolResponse(data: any): any[];
+/**
+ * Normalizes trade response data into consistent array format
+ *
+ * The backend API returns trades in different formats:
+ * - Direct array: [trade1, trade2]
+ * - Wrapped object: { trades: [trade1, trade2] }
+ *
+ * This normalizer ensures we always get an array of trades with proper Date objects.
+ *
+ * @param data Raw response data from backend
+ * @returns Normalized array of trades with Date objects
+ *
+ * @example
+ * ```typescript
+ * const normalized = normalizeTradeResponse({
+ *   trades: [
+ *     { id: 1, createdAt: '2024-01-01', updatedAt: '2024-01-01' }
+ *   ]
+ * });
+ * // Result: [{ id: 1, createdAt: Date(...), updatedAt: Date(...) }]
+ * ```
+ */
+export declare function normalizeTradeResponse(data: any): any[];
+/**
+ * Normalizes token list response data into consistent array format
+ *
+ * The backend API returns token lists in different formats:
+ * - Direct array: [token1, token2]
+ * - Wrapped object: { token: [token1, token2] }
+ *
+ * This normalizer ensures we always get an array of tokens with proper Date objects.
+ *
+ * @param data Raw response data from backend
+ * @returns Normalized array of tokens with Date objects
+ *
+ * @example
+ * ```typescript
+ * const normalized = normalizeTokenListResponse({
+ *   token: [
+ *     { id: 1, createdAt: '2024-01-01', updatedAt: '2024-01-01' }
+ *   ]
+ * });
+ * // Result: [{ id: 1, createdAt: Date(...), updatedAt: Date(...) }]
+ * ```
+ */
+export declare function normalizeTokenListResponse(data: any): any[];
+/**
+ * Extracts pagination metadata from backend response
+ *
+ * Safely extracts page, limit, and total from various response formats,
+ * providing defaults when fields are missing.
+ *
+ * @param response Raw backend response
+ * @param defaults Default values for page and limit
+ * @returns Normalized pagination metadata
+ *
+ * @example
+ * ```typescript
+ * const pagination = extractPaginationMetadata(
+ *   { page: '2', limit: '10', total: '100' },
+ *   { page: 1, limit: 10 }
+ * );
+ * // Result: { page: 2, limit: 10, total: 100, totalPages: 10 }
+ * ```
+ */
+export declare function extractPaginationMetadata(response: any, defaults: {
+    page: number;
+    limit: number;
+}): {
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
+};
+/**
+ * Creates pagination helper flags
+ *
+ * Calculates hasNext and hasPrevious flags based on current page and total pages.
+ *
+ * @param page Current page number
+ * @param totalPages Total number of pages
+ * @returns Pagination navigation flags
+ *
+ * @example
+ * ```typescript
+ * const flags = createPaginationFlags(2, 5);
+ * // Result: { hasNext: true, hasPrevious: true }
+ * ```
+ */
+export declare function createPaginationFlags(page: number, totalPages: number): {
+    hasNext: boolean;
+    hasPrevious: boolean;
+};
+//# sourceMappingURL=response-normalizers.d.ts.map

package/dist/utils/response-normalizers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-normalizers.d.ts","sourceRoot":"","sources":["../../src/utils/response-normalizers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,EAAE,CAgCtD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,EAAE,CAkBvD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,EAAE,CAc3D;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,GAAG,EACb,QAAQ,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACxC;IACD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB,CAOA;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,GACjB;IACD,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;CACtB,CAKA"}

package/dist/utils/validation.d.ts

@@ -1,11 +1,14 @@
 /**
  * Validation utilities for Launchpad API operations
  *
- * This module provides input validation to catch issues before making API calls,
+ * This module provides input validation using Zod schemas to catch issues before making API calls,
  * improving error messages and reducing unnecessary network requests.
+ *
+ * MIGRATION NOTE: This file now uses Zod schemas for validation while maintaining
+ * backward-compatible API through ValidationError throwing functions.
  */
-import { TokenUrls, CheckPoolOptions, FetchPoolOptions, GetAmountOptions, GetGraphOptions } from '../types/launchpad.dto';
-import { AddressFormat } from '../types/common';
+import { FetchPoolOptions, GetAmountOptions, GetGraphOptions, CheckPoolOptions, TokenUrls } from '../types/launchpad.dto.js';
+import { AddressFormat } from '../types/common.js';
 /**
  * Error thrown when validation fails
  */
@@ -71,6 +74,13 @@ export declare function validateGetGraphOptions(options: GetGraphOptions): void;
  * @throws ValidationError if validation fails
  */
 export declare function validateCreatePoolData(data: any): void;
+/**
+ * Validates launch token data (for bundle backend)
+ *
+ * @param data Token launch data to validate
+ * @throws ValidationError if validation fails
+ */
+export declare function validateLaunchTokenData(data: any): void;
 /**
  * Converts Ethereum address to backend format
  *
@@ -101,13 +111,6 @@ export declare function fromBackendAddressFormat(backendAddress: string): string
  * ```
  */
 export declare function normalizeAddressInput(address: string | undefined): AddressFormat | undefined;
-/**
- * Validates launch token data (for bundle backend)
- *
- * @param data Token launch data to validate
- * @throws ValidationError if validation fails
- */
-export declare function validateLaunchTokenData(data: any): void;
 export declare function isValidEthereumAddress(address: string): boolean;
 export declare function isValidAddressFormat(address: string): address is AddressFormat;
 /**

package/dist/utils/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAIL,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EAChB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IAG/B,KAAK,CAAC,EAAE,MAAM;IACd,IAAI,CAAC,EAAE,MAAM;gBAFpB,OAAO,EAAE,MAAM,EACR,KAAK,CAAC,EAAE,MAAM,YAAA,EACd,IAAI,CAAC,EAAE,MAAM,YAAA;CAKvB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAgCzD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CA4BlE;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,MAAkB,GAC5B,IAAI,CAkBN;AA8CD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CASxD;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAkCxE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAwExE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CA6EtE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAmJtD;AAgBD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,eAAe,EAAE,MAAM,GAAG,aAAa,CAsB7E;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAoBvE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,aAAa,GAAG,SAAS,CA6B3B;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CA8CvD;AAGD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAa/D;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,GACd,OAAO,IAAI,aAAa,CAQ1B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GACrB,MAAM,CAuBR;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,GACnB;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAkBxD"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAiBH,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,SAAS,EACV,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IAG/B,KAAK,CAAC,EAAE,MAAM;IACd,IAAI,CAAC,EAAE,MAAM;gBAFpB,OAAO,EAAE,MAAM,EACR,KAAK,CAAC,EAAE,MAAM,YAAA,EACd,IAAI,CAAC,EAAE,MAAM,YAAA;CAKvB;AAaD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAKzD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAKlE;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,MAAkB,GAC5B,IAAI,CAKN;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAKxD;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAKxE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAKxE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAKtE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAWtD;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAKvD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,eAAe,EAAE,MAAM,GAAG,aAAa,CAU7E;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAoBvE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,aAAa,GAAG,SAAS,CAe3B;AAGD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAG/D;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,GACd,OAAO,IAAI,aAAa,CAQ1B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GACrB,MAAM,CAuBR;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,GACnB;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAkBxD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gala-chain/launchpad-sdk",
-  "version": "3.5.2",
+  "version": "3.6.0",
   "description": "TypeScript SDK for Gala Launchpad Backend API - Production-ready DeFi token launchpad integration with wallet-based authentication, GalaChain trading, and comprehensive user operations. 100% tested (22/22 endpoints working).",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",
@@ -133,7 +133,9 @@
     "dotenv": "^17.2.3",
     "ethers": "^6.15.0",
     "socket.io-client": "^4.8.1",
-    "uuid": "^13.0.0"
+    "uuid": "^13.0.0",
+    "zod": "^3.25.76",
+    "zod-to-json-schema": "^3.24.6"
   },
   "size-limit": [
     {