@gala-chain/launchpad-sdk 3.5.2 → 3.6.0

package/dist/services/LaunchpadService.d.ts

@@ -1,121 +1,75 @@
 /**
- * Launchpad Service
+ * Launchpad Service (Facade)
  *
- * This service consolidates all launchpad-backend operations from multiple API classes.
- * It provides a unified interface for:
- * - Image upload operations
- * - Token launch/creation
- * - Pool queries and data fetching
- * - Calculation methods
- * - Trade history
- * - Comment operations
- * - User profile management
- * - User token list operations
- * - Faucet transfers
+ * This service provides a unified interface for all launchpad-backend operations.
+ * It delegates to specialized service classes while maintaining backward compatibility.
  *
- * All methods use the launchpad-backend HTTP client exclusively.
- */
-import { HttpClient } from '../utils/http';
-import { PoolsResult, CheckPoolOptions, GraphDataResult, TokenDistributionResult, TokenBadgesResult } from '../types/launchpad.dto';
-import { UploadImageByTokenNameOptions, FetchVolumeDataOptions, HasTokenBadgeOptions } from '../types/options.dto';
-import { CommentsResult } from '../types/comment.dto';
-import { FetchCommentsOptions, PostCommentOptions } from '../types/options.dto';
-import { TradesResult } from '../types/trade.dto';
-import { FetchTradesOptions } from '../types/options.dto';
-import { GetTokenListOptions, UserTokenListResult, TransferFaucetsData, UpdateProfileData, UploadProfileImageOptions } from '../types/user.dto';
-/**
- * Launchpad Service
- *
- * Consolidated service for all launchpad-backend operations including:
- * - Image uploads for token branding
- * - Pool queries and data fetching
- * - Token distribution and badge retrieval
- * - Comment operations
- * - Trade history
- * - User profile management
- * - User token lists
- * - Faucet transfers
+ * Architecture:
+ * - PoolService: Pool queries, distribution, badges, volume data
+ * - TradeService: Trade history and queries
+ * - CommentService: Comments with vault resolution
+ * - UserService: Profile management and token lists
+ * - ImageService: Image uploads for tokens
+ * - FaucetService: Faucet transfers
  *
  * @category Services
  * @since 2.0.0
+ * @refactored 3.6.0 - Decomposed into specialized services
  *
  * @example Basic usage
  * ```typescript
  * const service = new LaunchpadService(httpClient);
  *
- * // Upload token image
+ * // Upload token image (delegates to ImageService)
  * const imageUrl = await service.uploadImageByTokenName({
  *   tokenName: 'mytoken',
  *   options: { file: imageFile, tokenName: 'mytoken' }
  * });
  *
- * // Fetch pools
+ * // Fetch pools (delegates to PoolService)
  * const pools = await service.fetchPools({ type: 'recent', page: 1, limit: 10 });
  *
- * // Get comments
+ * // Get comments (delegates to CommentService)
  * const comments = await service.fetchComments({ tokenName: 'mytoken' });
  * ```
  */
+import { HttpClient } from '../utils/http';
+import { CheckPoolOptions, PoolsResult, GraphDataResult, TokenDistributionResult, TokenBadgesResult } from '../types/launchpad.dto';
+import { UploadImageByTokenNameOptions, FetchVolumeDataOptions, HasTokenBadgeOptions, FetchCommentsOptions, PostCommentOptions, FetchTradesOptions } from '../types/options.dto';
+import { CommentsResult } from '../types/comment.dto';
+import { TradesResult } from '../types/trade.dto';
+import { GetTokenListOptions, UserTokenListResult, TransferFaucetsData, UpdateProfileData, UploadProfileImageOptions } from '../types/user.dto';
+/**
+ * Launchpad Service (Facade Pattern)
+ *
+ * Consolidated facade for all launchpad-backend operations.
+ * Delegates to specialized services while maintaining backward compatibility.
+ *
+ * All public methods from v2.x remain unchanged for backward compatibility.
+ */
 export declare class LaunchpadService {
     private readonly http;
+    private readonly poolService;
+    private readonly tradeService;
+    private readonly commentService;
+    private readonly userService;
+    private readonly imageService;
+    private readonly faucetService;
     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
-     *
-     * @category File Operations
      * @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
      * @since 2.0.0
-     *
-     * @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>;
     /**
      * Fetches pools with filtering and pagination
      *
-     * ✅ VERIFIED: Real API payload confirmed - endpoint /launchpad/fetch-pool
-     *
      * @param options Fetch options including type, search, and pagination
      * @returns Promise<PoolsResult> Clean pool data with full pagination
+     * @since 2.0.0
      */
     fetchPools(options?: {
         search?: string;
@@ -129,6 +83,7 @@ export declare class LaunchpadService {
      *
      * @param options Check options with token name and/or symbol
      * @returns Promise<boolean> True if pool exists, false otherwise
+     * @since 2.0.0
      */
     checkPool(options: CheckPoolOptions): Promise<boolean>;
     /**
@@ -136,6 +91,7 @@ export declare class LaunchpadService {
      *
      * @param tokenName Token name to check
      * @returns Promise<boolean> True if available (pool doesn't exist)
+     * @since 2.0.0
      */
     isTokenNameAvailable(tokenName: string): Promise<boolean>;
     /**
@@ -143,228 +99,103 @@ export declare class LaunchpadService {
      *
      * @param symbol Token symbol to check
      * @returns Promise<boolean> True if available (pool doesn't exist)
+     * @since 2.0.0
      */
     isTokenSymbolAvailable(symbol: string): Promise<boolean>;
     /**
      * Fetches volume data for a token
      *
-     * ✅ VERIFIED: Real API payload confirmed - endpoint /launchpad/get-graph-data
-     *
      * @param options Volume data options
      * @returns Promise<GraphDataResult> Clean volume and price data points
+     * @since 2.0.0
      */
     fetchVolumeData(options: FetchVolumeDataOptions): Promise<GraphDataResult>;
     /**
      * Get token distribution showing top holders
      *
-     * Retrieves the list of top token holders for a specific token,
-     * along with their balances and percentage of total supply.
-     *
      * @param tokenName Token name to fetch distribution for
      * @returns Promise resolving to token distribution data
-     *
-     * @example
-     * ```typescript
-     * const distribution = await service.fetchTokenDistribution('mytoken');
-     * console.log('Top holders:', distribution.holders);
-     * ```
+     * @since 2.0.0
      */
     fetchTokenDistribution(tokenName: string): Promise<TokenDistributionResult>;
     /**
      * Gets badge achievements for a token
      *
-     * This endpoint retrieves volume and engagement badges for a specific token.
-     * Badges indicate milestones in trading volume and community engagement.
-     *
-     * **Note**: This endpoint does not require authentication.
-     *
      * @param tokenName The name of the token to get badges for
      * @returns Promise<TokenBadgesResult> Badge information
-     *
-     * @example
-     * ```typescript
-     * const badges = await service.fetchTokenBadges('mytoken');
-     * console.log('Volume badges:', badges.volumeBadges);
-     * console.log('Engagement badges:', badges.engagementBadges);
-     * ```
+     * @since 2.0.0
      */
     fetchTokenBadges(tokenName: string): Promise<TokenBadgesResult>;
     /**
      * Convenience method to check if a token has achieved a specific badge
      *
-     * @param tokenName The token name to check
-     * @param badgeType Type of badge to check ('volume' or 'engagement')
-     * @param badgeName Specific badge name to check for
+     * @param options Badge check options
      * @returns Promise<boolean> Whether the token has achieved this badge
-     *
-     * @example
-     * ```typescript
-     * const has10kVolume = await service.hasTokenBadge('mytoken', 'volume', '10k');
-     * const hasCrowdEngagement = await service.hasTokenBadge('mytoken', 'engagement', 'CROWD');
-     * ```
+     * @since 2.0.0
      */
     hasTokenBadge(options: HasTokenBadgeOptions): Promise<boolean>;
     /**
      * 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
-     *
-     * @example
-     * ```typescript
-     * // Get first page of trades for dragnrkti token
-     * const trades = await service.fetchTrades({ tokenName: "dragnrkti" });
-     *
-     * // Get specific page with custom limit
-     * const moreTrades = await service.fetchTrades({
-     *   tokenName: "dragnrkti",
-     *   page: 2,
-     *   limit: 20
-     * });
-     * ```
+     * @since 2.0.0
      */
     fetchTrades(options: FetchTradesOptions): Promise<TradesResult>;
     /**
      * 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
-     *
-     * @example
-     * ```typescript
-     * // Fetch first page of comments for dragnrkti token
-     * const comments = await service.fetchComments({ tokenName: "dragnrkti" });
-     *
-     * // Fetch specific page with more items
-     * const moreComments = await service.fetchComments({
-     *   tokenName: "dragnrkti",
-     *   page: 2,
-     *   limit: 20
-     * });
-     * ```
+     * @since 2.0.0
      */
     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
-     *
-     * @example
-     * ```typescript
-     * // Post comment on dragnrkti token
-     * await service.postComment({
-     *   tokenName: "dragnrkti",
-     *   content: "Great project with solid fundamentals!"
-     * });
-     * ```
+     * @since 2.0.0
      */
     postComment(options: PostCommentOptions): Promise<void>;
     /**
      * Fetches user profile information
      *
-     * ✅ VERIFIED: Real API payload confirmed - endpoint /user/profile (GET)
-     *
      * @param address Optional wallet address (defaults to SDK wallet address)
      * @returns Promise<any> User profile information
-     * @throws ValidationError if input validation fails
-     *
-     * @example
-     * ```typescript
-     * // Get current user's profile
-     * const profile = await service.fetchProfile();
-     *
-     * // Get specific user's profile
-     * const otherProfile = await service.fetchProfile("eth|1234567890abcdef1234567890abcdef12345678");
-     * ```
+     * @since 2.0.0
      */
     fetchProfile(address?: string): Promise<any>;
     /**
      * Updates user profile information
      *
-     * ✅ VERIFIED: Real API payload confirmed - endpoint /user/profile (PUT)
-     *
-     * **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
-     *
-     * @example
-     * ```typescript
-     * // Update with new image
-     * await service.updateProfile({
-     *   profileImage: "https://example.com/avatar.jpg",
-     *   fullName: "John Doe",
-     *   walletAddress: "eth|1234567890abcdef1234567890abcdef12345678"
-     * });
-     *
-     * // Update name only - existing image will be preserved automatically
-     * await service.updateProfile({
-     *   profileImage: "",
-     *   fullName: "Jane Doe",
-     *   walletAddress: "eth|1234567890abcdef1234567890abcdef12345678"
-     * });
-     * ```
+     * @since 2.0.0
      */
     updateProfile(data: UpdateProfileData): Promise<void>;
     /**
      * Uploads a profile image and returns the image URL
      *
-     * ✅ VERIFIED: Real API payload confirmed - endpoint /launchpad/upload-image (for profile)
-     *
      * @param options Profile image upload options
      * @returns Promise<string> Clean image URL
-     * @throws ValidationError if input validation fails
-     * @throws Error if upload fails
-     *
-     * @example
-     * ```typescript
-     * // Upload profile image file
-     * const fileInput = document.getElementById('avatar') as HTMLInputElement;
-     * const file = fileInput.files[0];
-     * const imageUrl = await service.uploadProfileImage({
-     *   file: file,
-     *   walletAddress: "eth|1234567890abcdef1234567890abcdef12345678"
-     * });
-     * ```
+     * @since 2.0.0
      */
     uploadProfileImage(options: UploadProfileImageOptions): Promise<string>;
     /**
      * Fetches user token list with optional filtering and pagination
      *
-     * ✅ VERIFIED: Real API payload confirmed - endpoint /user/token-list
-     *
      * @param options Filtering and pagination options
      * @returns Promise<UserTokenListResult> Clean token list with proper types
-     * @throws Error if request fails
+     * @since 2.0.0
      */
     fetchTokenList(options: GetTokenListOptions): Promise<UserTokenListResult>;
     /**
      * Fetches tokens held by user (balances)
      *
-     * ✅ VERIFIED: Real API payload confirmed - endpoint /user/token-hold
-     *
      * @param options Token held filtering options (address is optional)
      * @returns Promise<UserTokenListResult> Clean tokens held with full pagination
-     * @throws ValidationError if input validation fails
+     * @since 2.0.0
      */
     fetchTokensHeld(options: GetTokenListOptions): Promise<UserTokenListResult>;
     /**
@@ -372,32 +203,27 @@ export declare class LaunchpadService {
      *
      * @param options Options including pagination
      * @returns Promise<UserTokenListResult> Tokens created by the user
+     * @since 2.0.0
      */
     fetchTokensCreated(options?: {
         page?: number;
         limit?: number;
+        search?: string;
+        tokenName?: string;
     }): Promise<UserTokenListResult>;
     /**
      * 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
-     * });
-     * ```
+     * @since 2.0.0
      */
     transferFaucets(data: TransferFaucetsData): Promise<void>;
     /**
      * Gets the authenticated user's address in backend format
      *
      * @returns Address in eth|{40-hex-chars} format
+     * @since 2.0.0
      */
     getAddress(): string;
     /**
@@ -405,75 +231,8 @@ export declare class LaunchpadService {
      *
      * @param tokenName Token name to validate
      * @throws ValidationError if validation fails
+     * @since 2.0.0
      */
     validateTokenName(tokenName: string): void;
-    /**
-     * Resolves a token name to its vault address by fetching pool data
-     *
-     * @private
-     * @param tokenName Token name to resolve
-     * @returns Promise<string | null> Vault address if found, null otherwise
-     */
-    private resolveTokenNameToVault;
-    /**
-     * Builds query parameters for comment fetching
-     *
-     * @private
-     */
-    private buildGetCommentsQueryParams;
-    /**
-     * Builds query parameters for trade listing
-     *
-     * @private
-     */
-    private buildTradeQueryParams;
-    /**
-     * Builds query parameters for token list fetching
-     *
-     * @private
-     */
-    private buildTokenListQueryParams;
-    /**
-     * Builds query parameters for token hold endpoint
-     *
-     * @private
-     */
-    private buildTokenHoldQueryParams;
-    /**
-     * Validates pagination parameters
-     *
-     * @private
-     */
-    private validateTradePagination;
-    /**
-     * Validates get token list options
-     *
-     * @private
-     */
-    private validateGetTokenListOptions;
-    /**
-     * Validates user pagination parameters
-     *
-     * @private
-     */
-    private validateUserPagination;
-    /**
-     * Validates transfer faucets data
-     *
-     * @private
-     */
-    private validateTransferFaucetsData;
-    /**
-     * Validates update profile data
-     *
-     * @private
-     */
-    private validateUpdateProfileData;
-    /**
-     * Validates upload profile image options
-     *
-     * @private
-     */
-    private validateUploadProfileImageOptions;
 }
 //# sourceMappingURL=LaunchpadService.d.ts.map

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

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

package/dist/services/PoolService.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Pool Service
+ *
+ * Handles all pool-related operations including pool queries,
+ * token distribution, badges, and volume data.
+ *
+ * @category Services
+ * @since 3.6.0
+ */
+import { HttpClient } from '../utils/http';
+import { PoolsResult, CheckPoolOptions, GraphDataResult, TokenDistributionResult, TokenBadgesResult } from '../types/launchpad.dto';
+import { FetchVolumeDataOptions, HasTokenBadgeOptions } from '../types/options.dto';
+/**
+ * Pool Service Class
+ *
+ * Provides methods for:
+ * - Fetching and querying pools
+ * - Checking pool existence
+ * - Retrieving volume/graph data
+ * - Getting token distribution
+ * - Managing token badges
+ *
+ * @example
+ * ```typescript
+ * const poolService = new PoolService(httpClient);
+ *
+ * // Fetch recent pools
+ * const pools = await poolService.fetchPools({ type: 'recent', page: 1, limit: 10 });
+ *
+ * // Check if pool exists
+ * const exists = await poolService.checkPool({ tokenName: 'mytoken' });
+ * ```
+ */
+export declare class PoolService {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Fetches pools with filtering and pagination
+     *
+     * @param options Fetch options including type, search, and pagination
+     * @returns Promise<PoolsResult> Clean pool data with full pagination
+     */
+    fetchPools(options?: {
+        search?: string;
+        tokenName?: string;
+        type?: 'recent' | 'popular';
+        page?: number;
+        limit?: number;
+    }): Promise<PoolsResult>;
+    /**
+     * Checks if a pool exists for given token name or symbol
+     *
+     * @param options Check options with token name and/or symbol
+     * @returns Promise<boolean> True if pool exists, false otherwise
+     */
+    checkPool(options: CheckPoolOptions): Promise<boolean>;
+    /**
+     * Checks if a token name is available (convenience method)
+     *
+     * @param tokenName Token name to check
+     * @returns Promise<boolean> True if available (pool doesn't exist)
+     */
+    isTokenNameAvailable(tokenName: string): Promise<boolean>;
+    /**
+     * Checks if a token symbol is available (convenience method)
+     *
+     * @param symbol Token symbol to check
+     * @returns Promise<boolean> True if available (pool doesn't exist)
+     */
+    isTokenSymbolAvailable(symbol: string): Promise<boolean>;
+    /**
+     * Fetches volume data for a token
+     *
+     * @param options Volume data options
+     * @returns Promise<GraphDataResult> Clean volume and price data points
+     */
+    fetchVolumeData(options: FetchVolumeDataOptions): Promise<GraphDataResult>;
+    /**
+     * Get token distribution showing top holders
+     *
+     * Retrieves the list of top token holders for a specific token,
+     * along with their balances and percentage of total supply.
+     *
+     * @param tokenName Token name to fetch distribution for
+     * @returns Promise resolving to token distribution data
+     */
+    fetchTokenDistribution(tokenName: string): Promise<TokenDistributionResult>;
+    /**
+     * Gets badge achievements for a token
+     *
+     * This endpoint retrieves volume and engagement badges for a specific token.
+     * Badges indicate milestones in trading volume and community engagement.
+     *
+     * @param tokenName The name of the token to get badges for
+     * @returns Promise<TokenBadgesResult> Badge information
+     */
+    fetchTokenBadges(tokenName: string): Promise<TokenBadgesResult>;
+    /**
+     * Convenience method to check if a token has achieved a specific badge
+     *
+     * @param options Badge check options
+     * @returns Promise<boolean> Whether the token has achieved this badge
+     */
+    hasTokenBadge(options: HasTokenBadgeOptions): Promise<boolean>;
+    /**
+     * Resolves a token name to its vault address by fetching pool data
+     *
+     * @private
+     * @param tokenName Token name to resolve
+     * @returns Promise<string | null> Vault address if found, null otherwise
+     */
+    private resolveTokenNameToVault;
+}
+//# sourceMappingURL=PoolService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PoolService.d.ts","sourceRoot":"","sources":["../../src/services/PoolService.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAM3C,OAAO,EAGL,WAAW,EACX,gBAAgB,EAIhB,eAAe,EAEf,uBAAuB,EAEvB,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EAErB,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;;;;OAKG;IACG,UAAU,CACd,OAAO,GAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;KACX,GACL,OAAO,CAAC,WAAW,CAAC;IAmFvB;;;;;OAKG;IACG,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAuC5D;;;;;OAKG;IACG,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAW/D;;;;;OAKG;IACG,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAW9D;;;;;OAKG;IACG,eAAe,CACnB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,eAAe,CAAC;IAmD3B;;;;;;;;OAQG;IACG,sBAAsB,CAC1B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,uBAAuB,CAAC;IAkCnC;;;;;;;;OAQG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA0BrE;;;;;OAKG;IACG,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAkBpE;;;;;;OAMG;YACW,uBAAuB;CAsBtC"}