@gala-chain/launchpad-sdk 3.5.2 → 3.6.0

package/dist/schemas/validators.d.ts

@@ -0,0 +1,243 @@
+/**
+ * Zod-Powered Validation Utilities
+ *
+ * Type-safe validation functions that replace manual type guards.
+ * These provide clean, backward-compatible wrappers around Zod schemas.
+ */
+import { z } from 'zod';
+import { launchTokenDataSchema, tokenUrlsSchema, imageUploadOptionsSchema, checkPoolOptionsSchema } from './launchpad.js';
+import { tokenListOptionsSchema, transferFaucetsDataSchema, fetchGalaBalanceOptionsSchema, updateProfileDataSchema, uploadProfileImageOptionsSchema, fetchTokenBalanceOptionsSchema } from './user.js';
+import { createTradeDataSchema, buyTokensDataSchema, sellTokensDataSchema, getTradeOptionsSchema, tradeListParamsSchema, getAmountOptionsSchema, calculatePreMintDataSchema, fetchPoolDetailsDataSchema } from './trade.js';
+/**
+ * Standard validation result
+ *
+ * Provides consistent interface for all validators with proper TypeScript
+ * strict mode compatibility.
+ *
+ * ## Design Rationale
+ *
+ * This interface uses explicit `T | undefined` instead of optional properties
+ * to ensure compatibility with TypeScript's `exactOptionalPropertyTypes` setting.
+ *
+ * ### TypeScript Configuration Context
+ *
+ * ```json
+ * // tsconfig.json
+ * {
+ *   "compilerOptions": {
+ *     "exactOptionalPropertyTypes": true
+ *   }
+ * }
+ * ```
+ *
+ * With `exactOptionalPropertyTypes: true`, TypeScript strictly enforces that
+ * optional properties (`property?: Type`) cannot be assigned `undefined` values.
+ * Only missing properties are allowed.
+ *
+ * ### Interface Design Choice
+ *
+ * ```typescript
+ * // ❌ INCORRECT - Breaks with exactOptionalPropertyTypes
+ * interface ValidationResult<T> {
+ *   success: boolean;
+ *   data?: T;          // Optional property
+ *   errors?: string[]; // Optional property
+ * }
+ *
+ * // ✅ CORRECT - Compatible with exactOptionalPropertyTypes
+ * interface ValidationResult<T> {
+ *   success: boolean;
+ *   data: T | undefined;       // Explicit undefined
+ *   errors: string[] | undefined;  // Explicit undefined
+ * }
+ * ```
+ *
+ * ### Usage Patterns
+ *
+ * ```typescript
+ * // Success case
+ * const successResult: ValidationResult<string> = {
+ *   success: true,
+ *   data: 'validated-value',
+ *   errors: undefined
+ * };
+ *
+ * // Failure case
+ * const failureResult: ValidationResult<string> = {
+ *   success: false,
+ *   data: undefined,
+ *   errors: ['Validation error message']
+ * };
+ *
+ * // Type-safe consumption
+ * function handleResult(result: ValidationResult<string>) {
+ *   if (result.success) {
+ *     // TypeScript knows result.data is string | undefined
+ *     console.log(result.data);
+ *   } else {
+ *     // TypeScript knows result.errors is string[] | undefined
+ *     console.error(result.errors);
+ *   }
+ * }
+ * ```
+ *
+ * ### Benefits
+ *
+ * 1. **Type Safety**: Explicit undefined makes intent clear
+ * 2. **Strict Mode**: Compatible with `exactOptionalPropertyTypes`
+ * 3. **Consistency**: All validators return same shape
+ * 4. **Backward Compatibility**: Maintains existing API surface
+ *
+ * @template T The type of the validated data
+ */
+export interface ValidationResult<T> {
+    /** Whether validation passed */
+    success: boolean;
+    /** Validated and transformed data (if successful) */
+    data: T | undefined;
+    /** Validation error messages (if failed) */
+    errors: string[] | undefined;
+}
+/**
+ * Validates token name format
+ * Replaces: isValidTokenName()
+ */
+export declare function validateTokenName(value: unknown): ValidationResult<string>;
+/**
+ * Validates token symbol format
+ * Replaces: isValidTokenSymbol()
+ */
+export declare function validateTokenSymbol(value: unknown): ValidationResult<string>;
+/**
+ * Validates token description
+ * Replaces: isValidTokenDescription()
+ */
+export declare function validateTokenDescription(value: unknown): ValidationResult<string>;
+/**
+ * Validates and normalizes address format
+ * Accepts both 0x... and eth|... formats, outputs eth|... format
+ * Replaces: isValidUserAddress(), normalizeAddressInput()
+ */
+export declare function validateAddress(value: unknown): ValidationResult<string>;
+/**
+ * Validates vault address format
+ * Supports both eth| and service| formats
+ * Replaces: isValidVaultAddress()
+ */
+export declare function validateVaultAddress(value: unknown): ValidationResult<string>;
+/**
+ * Validates positive decimal string
+ * Replaces: isValidAmountString()
+ */
+export declare function validateAmountString(value: unknown): ValidationResult<string>;
+/**
+ * Validates faucet amount (positive, non-zero)
+ * Replaces: isValidFaucetAmount()
+ */
+export declare function validateFaucetAmount(value: unknown): ValidationResult<string>;
+/**
+ * Validates full name format
+ * Replaces: isValidFullName()
+ */
+export declare function validateFullName(value: unknown): ValidationResult<string>;
+/**
+ * Validates search query
+ * Replaces: isValidSearchQuery()
+ */
+export declare function validateSearchQuery(value: unknown): ValidationResult<string>;
+/**
+ * Validates user token name (more permissive than creation token name)
+ * Replaces: isValidUserTokenName()
+ */
+export declare function validateUserTokenName(value: unknown): ValidationResult<string>;
+/**
+ * Validates launch token data
+ * Replaces: isLaunchTokenData()
+ */
+export declare function validateLaunchTokenData(value: unknown): ValidationResult<z.infer<typeof launchTokenDataSchema>>;
+/**
+ * Validates token social URLs
+ * Replaces manual URL validation
+ */
+export declare function validateTokenUrls(value: unknown): ValidationResult<z.infer<typeof tokenUrlsSchema>>;
+/**
+ * Validates image upload options
+ * Replaces: isImageUploadOptions()
+ */
+export declare function validateImageUploadOptions(value: unknown): ValidationResult<z.infer<typeof imageUploadOptionsSchema>>;
+/**
+ * Validates check pool options
+ * Replaces: isCheckPoolOptions()
+ */
+export declare function validateCheckPoolOptions(value: unknown): ValidationResult<z.infer<typeof checkPoolOptionsSchema>>;
+/**
+ * Validates token list options
+ * Replaces: isGetTokenListOptions()
+ */
+export declare function validateTokenListOptions(value: unknown): ValidationResult<z.infer<typeof tokenListOptionsSchema>>;
+/**
+ * Validates transfer faucets data
+ * Replaces: isTransferFaucetsData()
+ */
+export declare function validateTransferFaucetsData(value: unknown): ValidationResult<z.infer<typeof transferFaucetsDataSchema>>;
+/**
+ * Validates fetch GALA balance options
+ * Replaces: isFetchGalaBalanceOptions()
+ */
+export declare function validateFetchGalaBalanceOptions(value: unknown): ValidationResult<z.infer<typeof fetchGalaBalanceOptionsSchema>>;
+/**
+ * Validates update profile data
+ * Replaces: isUpdateProfileData()
+ */
+export declare function validateUpdateProfileData(value: unknown): ValidationResult<z.infer<typeof updateProfileDataSchema>>;
+/**
+ * Validates upload profile image options
+ * Replaces: isUploadProfileImageOptions()
+ */
+export declare function validateUploadProfileImageOptions(value: unknown): ValidationResult<z.infer<typeof uploadProfileImageOptionsSchema>>;
+/**
+ * Validates fetch token balance options
+ * Replaces: isFetchTokenBalanceOptions()
+ */
+export declare function validateFetchTokenBalanceOptions(value: unknown): ValidationResult<z.infer<typeof fetchTokenBalanceOptionsSchema>>;
+/**
+ * Validates create trade data
+ * Replaces: isCreateTradeData()
+ */
+export declare function validateCreateTradeData(value: unknown): ValidationResult<z.infer<typeof createTradeDataSchema>>;
+/**
+ * Validates buy tokens data
+ * Replaces: isBuyTokensData()
+ */
+export declare function validateBuyTokensData(value: unknown): ValidationResult<z.infer<typeof buyTokensDataSchema>>;
+/**
+ * Validates sell tokens data
+ * Replaces: isSellTokensData()
+ */
+export declare function validateSellTokensData(value: unknown): ValidationResult<z.infer<typeof sellTokensDataSchema>>;
+/**
+ * Validates get trade options
+ * Replaces: isGetTradeOptions()
+ */
+export declare function validateGetTradeOptions(value: unknown): ValidationResult<z.infer<typeof getTradeOptionsSchema>>;
+/**
+ * Validates trade list params
+ * Replaces: isTradeListParams()
+ */
+export declare function validateTradeListParams(value: unknown): ValidationResult<z.infer<typeof tradeListParamsSchema>>;
+/**
+ * Validates get amount options
+ * Replaces: isGetAmountOptions()
+ */
+export declare function validateGetAmountOptions(value: unknown): ValidationResult<z.infer<typeof getAmountOptionsSchema>>;
+/**
+ * Validates calculate pre-mint data
+ * Replaces: isCalculatePreMintData()
+ */
+export declare function validateCalculatePreMintData(value: unknown): ValidationResult<z.infer<typeof calculatePreMintDataSchema>>;
+/**
+ * Validates fetch pool details data
+ * Replaces: isFetchPoolDetailsData()
+ */
+export declare function validateFetchPoolDetailsData(value: unknown): ValidationResult<z.infer<typeof fetchPoolDetailsDataSchema>>;
+//# sourceMappingURL=validators.d.ts.map

package/dist/schemas/validators.d.ts.map

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

package/dist/services/CommentService.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Comment Service
+ *
+ * Handles all comment-related operations including fetching and posting comments.
+ *
+ * @category Services
+ * @since 3.6.0
+ */
+import { HttpClient } from '../utils/http';
+import { CommentsResult } from '../types/comment.dto';
+import { FetchCommentsOptions, PostCommentOptions } from '../types/options.dto';
+import { PoolService } from './PoolService';
+/**
+ * Comment Service Class
+ *
+ * Provides methods for:
+ * - Fetching comments for tokens
+ * - Posting comments on tokens
+ *
+ * @example
+ * ```typescript
+ * const commentService = new CommentService(httpClient, poolService);
+ *
+ * // Fetch first page of comments for a token
+ * const comments = await commentService.fetchComments({ tokenName: "dragnrkti" });
+ *
+ * // Post a comment
+ * await commentService.postComment({
+ *   tokenName: "dragnrkti",
+ *   content: "Great project!"
+ * });
+ * ```
+ */
+export declare class CommentService {
+    private readonly http;
+    private readonly poolService;
+    constructor(http: HttpClient, poolService: PoolService);
+    /**
+     * Fetches comments for a token by its tokenName
+     *
+     * This method provides a clean, intuitive API for fetching token comments
+     * using the token name. It automatically resolves the tokenName
+     * to the correct vault address internally.
+     *
+     * @param options Options for fetching comments
+     * @returns Promise<CommentsResult> Comments with pagination info
+     * @throws ValidationError if token name is invalid or not found
+     */
+    fetchComments(options: FetchCommentsOptions): Promise<CommentsResult>;
+    /**
+     * Posts a comment on a token by its tokenName
+     *
+     * This method provides a clean, intuitive API for posting comments on tokens
+     * using the token name. It automatically resolves the tokenName
+     * to the correct vault address and uses the authenticated user's wallet address.
+     *
+     * @param options Options for posting a comment
+     * @returns Promise<void> No return data
+     * @throws ValidationError if token name is invalid, not found, or content is invalid
+     */
+    postComment(options: PostCommentOptions): Promise<void>;
+    /**
+     * Resolves a token name to its vault address by querying PoolService
+     *
+     * @private
+     * @param tokenName Token name to resolve
+     * @returns Promise<string | null> Vault address if found, null otherwise
+     */
+    private resolveTokenNameToVault;
+}
+//# sourceMappingURL=CommentService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CommentService.d.ts","sourceRoot":"","sources":["../../src/services/CommentService.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAK3C,OAAO,EAEL,cAAc,EAMf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAGnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,WAAW;gBADX,IAAI,EAAE,UAAU,EAChB,WAAW,EAAE,WAAW;IAG3C;;;;;;;;;;OAUG;IACG,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;IA2E3E;;;;;;;;;;OAUG;IACG,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmE7D;;;;;;OAMG;YACW,uBAAuB;CAsBtC"}

package/dist/services/FaucetService.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Faucet Service
+ *
+ * Handles faucet-related operations for transferring test tokens.
+ *
+ * @category Services
+ * @since 3.6.0
+ */
+import { HttpClient } from '../utils/http';
+import { TransferFaucetsData } from '../types/user.dto';
+/**
+ * Faucet Service Class
+ *
+ * Provides methods for:
+ * - Transferring faucet tokens to users
+ *
+ * @example
+ * ```typescript
+ * const faucetService = new FaucetService(httpClient);
+ *
+ * // Transfer 1 token from faucet
+ * await faucetService.transferFaucets({
+ *   walletAddress: "eth|1234567890abcdef1234567890abcdef12345678",
+ *   amount: "1"
+ * });
+ * ```
+ */
+export declare class FaucetService {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Transfers faucets to a user address
+     *
+     * @param data Transfer faucets data
+     * @returns Promise<void> No return data - throws on failure
+     * @throws ValidationError if input validation fails
+     * @throws Error if transfer fails
+     *
+     * @example
+     * ```typescript
+     * await service.transferFaucets({
+     *   walletAddress: "eth|1234567890abcdef1234567890abcdef12345678",
+     *   amount: "1" // 1 token
+     * });
+     * ```
+     */
+    transferFaucets(data: TransferFaucetsData): Promise<void>;
+    /**
+     * Validates transfer faucets data
+     *
+     * @private
+     */
+    private validateTransferFaucetsData;
+}
+//# sourceMappingURL=FaucetService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FaucetService.d.ts","sourceRoot":"","sources":["../../src/services/FaucetService.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,OAAO,EACL,mBAAmB,EAIpB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;;;;;;;;;;;;;;OAeG;IACG,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB/D;;;;OAIG;IACH,OAAO,CAAC,2BAA2B;CAiBpC"}

package/dist/services/ImageService.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Image Service
+ *
+ * Handles all image upload operations for tokens and profiles.
+ *
+ * @category Services
+ * @since 3.6.0
+ */
+import { HttpClient } from '../utils/http';
+import { UploadImageByTokenNameOptions } from '../types/options.dto';
+/**
+ * Image Service Class
+ *
+ * Provides methods for:
+ * - Uploading token images
+ * - Image validation and processing
+ *
+ * @example
+ * ```typescript
+ * const imageService = new ImageService(httpClient);
+ *
+ * // Upload token image
+ * const imageUrl = await imageService.uploadImageByTokenName({
+ *   tokenName: 'mytoken',
+ *   options: { file: imageFile, tokenName: 'mytoken' }
+ * });
+ * ```
+ */
+export declare class ImageService {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Uploads an image for a token pool
+     *
+     * Uploads a token image that will be used for branding and display purposes.
+     * Supports both browser File objects and Node.js Buffer objects for maximum
+     * compatibility across environments.
+     *
+     * File Requirements:
+     * - Format: PNG, JPG, JPEG, WebP
+     * - Size: Maximum 5MB
+     * - Dimensions: Recommended 512x512px or higher
+     * - Aspect ratio: Square (1:1) recommended
+     *
+     * @param options Upload configuration object
+     * @param options.file Image file as File object (browser) or Buffer (Node.js)
+     * @param options.tokenName Token name for the image (must be valid token name format)
+     * @returns Promise that resolves to image URL string
+     * @throws {ValidationError} If token name format is invalid
+     * @throws {FileValidationError} If file doesn't meet requirements
+     * @throws {Error} If upload fails due to network or server issues
+     *
+     * @example Browser file upload
+     * ```typescript
+     * const fileInput = document.querySelector('#image-upload') as HTMLInputElement;
+     * const file = fileInput.files?.[0];
+     *
+     * if (file) {
+     *   const imageUrl = await service.uploadImageByTokenName({
+     *     file,
+     *     tokenName: 'mytoken'
+     *   });
+     *   console.log('Image uploaded:', imageUrl);
+     * }
+     * ```
+     *
+     * @example Node.js buffer upload
+     * ```typescript
+     * import * as fs from 'fs';
+     *
+     * const imageBuffer = fs.readFileSync('./token-image.png');
+     * const imageUrl = await service.uploadImageByTokenName({
+     *   file: imageBuffer,
+     *   tokenName: 'mytoken'
+     * });
+     * console.log('Image URL:', imageUrl);
+     * ```
+     */
+    uploadImageByTokenName(options: UploadImageByTokenNameOptions): Promise<string>;
+}
+//# sourceMappingURL=ImageService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ImageService.d.ts","sourceRoot":"","sources":["../../src/services/ImageService.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAK3C,OAAO,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AAErE;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8CG;IACG,sBAAsB,CAC1B,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,MAAM,CAAC;CA6DnB"}