@gala-chain/launchpad-sdk 5.0.4-beta.6 → 5.0.4-beta.60

package/dist/services/LaunchpadService.d.ts

@@ -0,0 +1,343 @@
+/**
+ * Launchpad Service (Facade)
+ *
+ * This service provides a unified interface for all launchpad-backend operations.
+ * It delegates to specialized service classes while maintaining backward compatibility.
+ *
+ * Architecture:
+ * - PoolService: Pool queries, distribution, badges, volume data
+ * - TradeService: Trade history and queries
+ * - UserService: Profile management and token lists
+ * - ImageService: Image uploads for tokens
+ *
+ * @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 (delegates to ImageService)
+ * const imageUrl = await service.uploadImageByTokenName({
+ *   tokenName: 'mytoken',
+ *   options: { file: imageFile, tokenName: 'mytoken' }
+ * });
+ *
+ * // Fetch pools (delegates to PoolService)
+ * const pools = await service.fetchPools({ type: 'recent', offset: 0, limit: 10 });
+ * ```
+ */
+import type { JwtAuth } from '../auth/JwtAuth';
+import type { FetchTokenStatsResult } from '../types/engagement-stats.dto';
+import type { CheckPoolOptions, GraphDataResult, PoolData, PoolsResult, TokenBadgesResult, TokenDistributionResult, UserHolderContext, ValidateTokenRequest, ValidateTokenResponse } from '../types/launchpad.dto';
+import type { UpdateTokenConfigOptions } from '../types/messages.dto';
+import type { FetchTradesOptions, FetchVolumeDataOptions, HasTokenBadgeOptions, UploadImageByTokenNameOptions } from '../types/options.dto';
+import type { TradesResult } from '../types/trade.dto';
+import type { GetTradesOptions, TradesQueryResult } from '../types/trades-query.dto';
+import type { FetchUserBalancesOptions, FetchUserBalancesResult, FetchUserReportOptions, FetchUserReportResult, GetManagedTokensOptions, GetTokenListOptions, ManagedTokensResult, UpdateProfileData, UploadProfileImageOptions, UserTokenListResult } from '../types/user.dto';
+import type { HttpClient } from '../utils/http';
+import { PoolService } from './PoolService';
+/**
+ * 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;
+    readonly poolService: PoolService;
+    private readonly tradeService;
+    private readonly userService;
+    private readonly imageService;
+    constructor(http: HttpClient, jwtAuth?: JwtAuth, debugMode?: boolean);
+    /**
+     * Set the JWT authentication manager for profile, image, and token config operations
+     *
+     * This allows dynamic configuration of JWT auth after service creation.
+     * Required for updateProfile, uploadProfileImage, uploadImageByTokenName, and updateTokenConfig.
+     *
+     * @param jwtAuth - JWT auth manager instance
+     */
+    setJwtAuth(jwtAuth: JwtAuth): void;
+    /**
+     * Uploads an image for a token pool
+     *
+     * @param options Upload configuration object
+     * @returns Promise that resolves to image URL string
+     * @since 2.0.0
+     */
+    uploadImageByTokenName(options: UploadImageByTokenNameOptions): Promise<string>;
+    /**
+     * Fetches pools with filtering and pagination
+     *
+     * Supports automatic multi-page fetching:
+     * - `limit <= 20`: Single API call (backward compatible)
+     * - `limit > 20`: Automatic concurrent multi-page fetching
+     * - `limit === 0`: Fetches all available pools
+     *
+     * @param options Fetch options including type, search, and pagination
+     * @returns Promise<PoolsResult> Clean pool data with full pagination
+     * @since 2.0.0
+     * @updated 3.11.0 - Added auto-pagination support
+     */
+    fetchPools(options?: {
+        search?: string;
+        tokenName?: string;
+        type?: 'recent' | 'popular' | 'recordings' | 'seconds_streamed';
+        hasUpcomingShows?: boolean;
+        language?: string;
+        recentlyStreamed?: number;
+        hasRecordings?: boolean;
+        offset?: number;
+        limit?: number;
+    }): Promise<PoolsResult>;
+    /**
+     * Fetches all available pools with automatic pagination
+     *
+     * Convenience method that fetches all available pools. Delegates to PoolService.
+     * Equivalent to `fetchPools({ ...options, limit: 0 })`.
+     *
+     * @param options Optional filters (type, tokenName, search)
+     * @returns Promise<PoolsResult> with all pools
+     * @since 3.11.0
+     */
+    fetchAllPools(options?: {
+        search?: string;
+        tokenName?: string;
+        type?: 'recent' | 'popular' | 'recordings' | 'seconds_streamed';
+        hasUpcomingShows?: boolean;
+        language?: string;
+        recentlyStreamed?: number;
+        hasRecordings?: boolean;
+    }): 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
+     * @since 2.0.0
+     */
+    checkPool(options: CheckPoolOptions): Promise<boolean>;
+    /**
+     * Checks if a pool exists for given token name or symbol (alias for checkPool)
+     *
+     * Convenience method that accepts tokenName and/or symbol parameters.
+     * At least one parameter is required.
+     *
+     * @param tokenName Optional token name to check
+     * @param symbol Optional token symbol to check
+     * @returns Promise<boolean> True if pool exists, false otherwise
+     * @since 6.x.0
+     */
+    checkPoolExists(tokenName?: string, symbol?: string): 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)
+     * @since 2.0.0
+     */
+    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)
+     * @since 2.0.0
+     */
+    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
+     * @since 2.0.0
+     */
+    fetchVolumeData(options: FetchVolumeDataOptions): Promise<GraphDataResult>;
+    /**
+     * Get token distribution showing top holders
+     *
+     * @param tokenName Token name to fetch distribution for
+     * @returns Promise resolving to token distribution data
+     * @since 2.0.0
+     */
+    fetchTokenDistribution(tokenName: string): Promise<TokenDistributionResult>;
+    /**
+     * Get a specific user's holder context for a token
+     *
+     * @param tokenName Token name to check holdings for
+     * @param userAddress User address to lookup
+     * @returns Promise resolving to user holder context data
+     * @since 3.7.0
+     */
+    fetchUserHolderContext(tokenName: string, userAddress: string): Promise<UserHolderContext>;
+    /**
+     * Gets badge achievements for a token
+     *
+     * @param tokenName The name of the token to get badges for
+     * @returns Promise<TokenBadgesResult> Badge information
+     * @since 2.0.0
+     */
+    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
+     * @since 2.0.0
+     */
+    hasTokenBadge(options: HasTokenBadgeOptions): Promise<boolean>;
+    /**
+     * Gets trades for a token by its tokenName with pagination
+     *
+     * @param options Trade fetching options
+     * @returns Promise<TradesResult> Clean trades with full pagination
+     * @since 2.0.0
+     */
+    fetchTrades(options: FetchTradesOptions): Promise<TradesResult>;
+    /**
+     * Gets trades with flexible filtering (v6.2.0+)
+     *
+     * Public endpoint - no authentication required.
+     * Filter by tokenName, userAddress, or both.
+     * At least one filter is required.
+     *
+     * @param options Query options with tokenName and/or userAddress
+     * @returns Paginated list of trades with metadata
+     * @since 6.2.0
+     */
+    getTrades(options: GetTradesOptions): Promise<TradesQueryResult>;
+    /**
+     * Fetches user profile information
+     *
+     * @param address Optional wallet address (defaults to SDK wallet address)
+     * @returns Promise<unknown> User profile information
+     * @since 2.0.0
+     */
+    fetchProfile(address?: string): Promise<unknown>;
+    /**
+     * Updates user profile information
+     *
+     * @param data Profile update data
+     * @returns Promise<void> No return data - throws on failure
+     * @since 2.0.0
+     */
+    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
+     * @since 2.0.0
+     */
+    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
+     * @since 2.0.0
+     */
+    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
+     * @since 2.0.0
+     */
+    fetchTokensHeld(options: GetTokenListOptions): Promise<UserTokenListResult>;
+    /**
+     * Fetches tokens created by user
+     *
+     * @param options Options including pagination
+     * @returns Promise<UserTokenListResult> Tokens created by the user
+     * @since 2.0.0
+     */
+    fetchTokensCreated(options?: {
+        offset?: number;
+        limit?: number;
+        search?: string;
+        tokenName?: string;
+    }): Promise<UserTokenListResult>;
+    /**
+     * Fetches all tokens the user can manage (owned + moderated + overseer status)
+     *
+     * @param options Optional pagination options
+     * @returns Promise<ManagedTokensResult> Managed tokens result
+     * @since 5.11.0
+     */
+    getManagedTokens(options?: GetManagedTokensOptions): Promise<ManagedTokensResult>;
+    /**
+     * Gets the authenticated user's address in backend format
+     *
+     * @returns Address in eth|{40-hex-chars} format
+     * @since 2.0.0
+     */
+    getAddress(): string;
+    /**
+     * Validates a token name (exposed for external validation)
+     *
+     * @param tokenName Token name to validate
+     * @throws ValidationError if validation fails
+     * @since 2.0.0
+     */
+    validateTokenName(tokenName: string): void;
+    /**
+     * Fetch full token pool data by token name
+     * @param tokenName The token name to fetch
+     * @returns The full PoolData object with all fields including streaming data
+     * @since 6.0.0
+     */
+    fetchToken(tokenName: string): Promise<PoolData>;
+    /**
+     * Validate if token name and/or symbol are available
+     * @param options Object containing optional tokenName and/or symbol to validate
+     * @returns Validation result with availability flags and errors
+     * @since 6.0.0
+     */
+    validateToken(options: ValidateTokenRequest): Promise<ValidateTokenResponse>;
+    /**
+     * Fetch engagement statistics for a token
+     *
+     * @param tokenName Token name to fetch stats for
+     * @returns Engagement statistics (chat count, comment count, etc.)
+     * @since 7.1.0
+     */
+    fetchTokenStats(tokenName: string): Promise<FetchTokenStatsResult>;
+    /**
+     * Update token configuration including chat/comments, streaming, and social media links
+     *
+     * @param tokenName Token name to configure
+     * @param config Configuration options including:
+     *   - chatEnabled: Enable/disable chat
+     *   - commentsEnabled: Enable/disable comments
+     *   - streamingEnabled: Enable/disable streaming
+     *   - nextLiveStreamAt: Next scheduled stream time
+     *   - streamLanguage: Stream language code (ISO 639-1)
+     *   - websiteUrl, telegramUrl, twitterUrl, instagramUrl, facebookUrl, redditUrl, tiktokUrl: Social media URLs
+     * @since 7.1.0
+     * @since 6.2.0 - Added support for social media URL updates and other streaming config
+     */
+    updateTokenConfig(tokenName: string, config: UpdateTokenConfigOptions): Promise<void>;
+    /**
+     * Fetch all token balances for a user
+     *
+     * @param options Options with user address (and optional pagination)
+     * @returns Array of user's token balances
+     * @since 7.1.0
+     */
+    fetchUserBalances(options: FetchUserBalancesOptions): Promise<FetchUserBalancesResult>;
+    /**
+     * Fetch comprehensive user report (Overseer only)
+     *
+     * @param options Options with user address to report on
+     * @returns Complete user report including profile, activity, and reputation
+     * @since 7.1.0
+     */
+    fetchUserReport(options: FetchUserReportOptions): Promise<FetchUserReportResult>;
+}
+//# sourceMappingURL=LaunchpadService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LaunchpadService.d.ts","sourceRoot":"","sources":["../../src/services/LaunchpadService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EACV,qBAAqB,EACtB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,QAAQ,EACR,WAAW,EACX,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EACV,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,6BAA6B,EAC9B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACrF,OAAO,KAAK,EACV,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,yBAAyB,EACzB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIhD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAI5C;;;;;;;GAOG;AACH,qBAAa,gBAAgB;IAQzB,OAAO,CAAC,QAAQ,CAAC,IAAI;IANvB,SAAgB,WAAW,EAAE,WAAW,CAAC;IACzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;gBAGzB,IAAI,EAAE,UAAU,EACjC,OAAO,CAAC,EAAE,OAAO,EACjB,SAAS,GAAE,OAAe;IAS5B;;;;;;;OAOG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAUlC;;;;;;OAMG;IACG,sBAAsB,CAC1B,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,MAAM,CAAC;IAQlB;;;;;;;;;;;;OAYG;IACG,UAAU,CACd,OAAO,GAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,kBAAkB,CAAC;QAChE,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KACX,GACL,OAAO,CAAC,WAAW,CAAC;IAIvB;;;;;;;;;OASG;IACG,aAAa,CACjB,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,kBAAkB,CAAC;QAChE,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB,GACA,OAAO,CAAC,WAAW,CAAC;IAIvB;;;;;;OAMG;IACG,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAI5D;;;;;;;;;;OAUG;IACG,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAW5E;;;;;;OAMG;IACG,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/D;;;;;;OAMG;IACG,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9D;;;;;;OAMG;IACG,eAAe,CACnB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,eAAe,CAAC;IAI3B;;;;;;OAMG;IACG,sBAAsB,CAC1B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,uBAAuB,CAAC;IAInC;;;;;;;OAOG;IACG,sBAAsB,CAC1B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,CAAC;IAI7B;;;;;;OAMG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIrE;;;;;;OAMG;IACG,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAQpE;;;;;;OAMG;IACG,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IAIrE;;;;;;;;;;OAUG;IACG,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAQtE;;;;;;OAMG;IAEG,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAItD;;;;;;OAMG;IACG,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3D;;;;;;OAMG;IACG,kBAAkB,CACtB,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,MAAM,CAAC;IAQlB;;;;;;OAMG;IACG,cAAc,CAClB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,mBAAmB,CAAC;IAI/B;;;;;;OAMG;IACG,eAAe,CACnB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,mBAAmB,CAAC;IAI/B;;;;;;OAMG;IACG,kBAAkB,CACtB,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GACrF,OAAO,CAAC,mBAAmB,CAAC;IAI/B;;;;;;OAMG;IACG,gBAAgB,CACpB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,mBAAmB,CAAC;IAQ/B;;;;;OAKG;IACH,UAAU,IAAI,MAAM;IAIpB;;;;;;OAMG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI1C;;;;;OAKG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAItD;;;;;OAKG;IACG,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAQlF;;;;;;OAMG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAIxE;;;;;;;;;;;;;OAaG;IACG,iBAAiB,CACrB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,IAAI,CAAC;IAQhB;;;;;;OAMG;IACG,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAI5F;;;;;;OAMG;IACG,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAGvF"}

package/dist/services/MessagesService.d.ts

@@ -0,0 +1,251 @@
+/**
+ * Unified Messages Service (v7.0.0+)
+ *
+ * Full CRUD for messages (CHAT and COMMENT types) via the unified /v1/messages endpoint.
+ *
+ * This service replaces:
+ * - CommentsService (/v1/comments)
+ * - ChatMessagesService (/v1/chat-messages)
+ * - StreamChatService CRUD operations (/v1/tokens/:tokenName/messages)
+ *
+ * @category Services
+ * @since 7.0.0
+ */
+import type { JwtAuth } from '../auth/JwtAuth';
+import { type CreateMessageOptions, type CreateMessageResult, type DeleteMessageResult, type FetchMessagesOptions, type FetchMessagesResult, type GetPinnedMessageResult, type MessageStats, type PinMessageResult, type UpdateMessageOptions, type UpdateMessageResult } from '../types/messages.dto';
+import type { HttpClient } from '../utils/http';
+import { StreamTokenServiceBase } from './StreamTokenServiceBase';
+/**
+ * Unified Messages Service Class
+ *
+ * Provides methods for:
+ * - Fetching paginated messages with type filtering (public)
+ * - Creating messages (authenticated)
+ * - Updating messages (authenticated - author only)
+ * - Deleting messages (authenticated - author, moderator, or admin)
+ * - Getting/setting pinned messages (owner/moderator)
+ *
+ * @example
+ * ```typescript
+ * const messagesService = new MessagesService(httpClient, undefined, jwtAuth);
+ *
+ * // Fetch chat messages for a token (public)
+ * const chatResult = await messagesService.fetchMessages({
+ *   type: 'CHAT',
+ *   tokenName: 'anime'
+ * });
+ *
+ * // Fetch comments for a token (public)
+ * const commentResult = await messagesService.fetchMessages({
+ *   type: 'COMMENT',
+ *   tokenName: 'anime'
+ * });
+ *
+ * // Create a chat message (requires JWT)
+ * const created = await messagesService.createMessage({
+ *   type: 'CHAT',
+ *   tokenName: 'anime',
+ *   content: 'Hello world!'
+ * });
+ *
+ * // Pin a message (requires owner/moderator JWT)
+ * await messagesService.pinMessage(created.message.id);
+ * ```
+ */
+export declare class MessagesService extends StreamTokenServiceBase {
+    constructor(http: HttpClient, adminApiKey?: string, jwtAuth?: JwtAuth, debugMode?: boolean, userApiKey?: string);
+    /**
+     * Validate message content based on type
+     */
+    private validateContent;
+    /**
+     * Validate message ID format
+     */
+    private validateMessageId;
+    /**
+     * Validate message type
+     */
+    private validateMessageType;
+    /**
+     * Fetch messages with optional filtering
+     *
+     * Public endpoint - no authentication required.
+     * At least one of type, tokenName, or userAddress must be provided.
+     *
+     * @param options Query options including type/tokenName/userAddress and pagination
+     * @returns Paginated list of messages
+     * @throws ValidationError if no filter is provided or options are invalid
+     *
+     * @example
+     * ```typescript
+     * // Get chat messages for a token
+     * const { messages, pageInfo } = await messagesService.fetchMessages({
+     *   type: 'CHAT',
+     *   tokenName: 'anime'
+     * });
+     *
+     * // Get comments by a user
+     * const userComments = await messagesService.fetchMessages({
+     *   type: 'COMMENT',
+     *   userAddress: 'eth|0x123...'
+     * });
+     *
+     * // Get all messages for a token with pagination
+     * const all = await messagesService.fetchMessages({
+     *   tokenName: 'anime',
+     *   pageSize: 20,
+     *   cursor: 'next_cursor'
+     * });
+     * ```
+     */
+    fetchMessages(options: FetchMessagesOptions): Promise<FetchMessagesResult>;
+    /**
+     * Create a new message
+     *
+     * Requires JWT authentication.
+     *
+     * @param options Create options including type, tokenName, and content
+     * @returns The created message
+     * @throws ValidationError if options are invalid
+     * @throws ConfigurationError if JWT is not configured
+     *
+     * @example
+     * ```typescript
+     * // Create a chat message
+     * const result = await messagesService.createMessage({
+     *   type: 'CHAT',
+     *   tokenName: 'anime',
+     *   content: 'Hello world!'
+     * });
+     * console.log('Created message ID:', result.message.id);
+     *
+     * // Create a comment
+     * const comment = await messagesService.createMessage({
+     *   type: 'COMMENT',
+     *   tokenName: 'anime',
+     *   content: 'Great project!'
+     * });
+     * ```
+     */
+    createMessage(options: CreateMessageOptions): Promise<CreateMessageResult>;
+    /**
+     * Update a message's content
+     *
+     * Requires JWT authentication. Only the message author can update.
+     *
+     * @param id Message ID to update
+     * @param options Update options including new content
+     * @returns The updated message
+     * @throws ValidationError if ID or content is invalid
+     * @throws ConfigurationError if JWT is not configured
+     *
+     * @example
+     * ```typescript
+     * const result = await messagesService.updateMessage('msg-1234567890123-abc...', {
+     *   content: 'Updated message content'
+     * });
+     * console.log('Updated at:', result.message.updatedAt);
+     * ```
+     */
+    updateMessage(id: string, options: UpdateMessageOptions): Promise<UpdateMessageResult>;
+    /**
+     * Delete a message
+     *
+     * Requires authentication (JWT or API key).
+     * Authorization: message author, token owner, moderator, or admin.
+     *
+     * @param id Message ID to delete
+     * @returns Success indicator
+     * @throws ValidationError if ID is invalid
+     * @throws ConfigurationError if neither JWT nor API key is configured
+     *
+     * @example
+     * ```typescript
+     * await messagesService.deleteMessage('msg-1234567890123-abc...');
+     * console.log('Message deleted');
+     * ```
+     */
+    deleteMessage(id: string): Promise<DeleteMessageResult>;
+    /**
+     * Get the currently pinned message for a token
+     *
+     * Public endpoint - no authentication required.
+     *
+     * @param tokenName Token name to get pinned message for
+     * @returns The pinned message or null if none
+     *
+     * @example
+     * ```typescript
+     * const result = await messagesService.getPinnedMessage('anime');
+     * if (result.message) {
+     *   console.log('Pinned:', result.message.content);
+     * } else {
+     *   console.log('No message pinned');
+     * }
+     * ```
+     */
+    getPinnedMessage(tokenName: string): Promise<GetPinnedMessageResult>;
+    /**
+     * Pin a message
+     *
+     * Requires JWT authentication with owner or moderator role.
+     * Only one message can be pinned per token at a time.
+     *
+     * @param id Message ID to pin
+     * @returns Success indicator
+     * @throws ValidationError if ID is invalid
+     * @throws ConfigurationError if JWT is not configured
+     *
+     * @example
+     * ```typescript
+     * await messagesService.pinMessage('msg-1234567890123-abc...');
+     * console.log('Message pinned');
+     * ```
+     */
+    pinMessage(id: string): Promise<PinMessageResult>;
+    /**
+     * Unpin a message
+     *
+     * Requires JWT authentication with owner or moderator role.
+     *
+     * @param id Message ID to unpin
+     * @returns Success indicator
+     * @throws ValidationError if ID is invalid
+     * @throws ConfigurationError if JWT is not configured
+     *
+     * @example
+     * ```typescript
+     * await messagesService.unpinMessage('msg-1234567890123-abc...');
+     * console.log('Message unpinned');
+     * ```
+     */
+    unpinMessage(id: string): Promise<PinMessageResult>;
+    /**
+     * Get platform-wide message statistics
+     *
+     * Admin or Overseer endpoint - requires admin API key or overseer JWT.
+     *
+     * Returns aggregated message metrics including:
+     * - Total message count
+     * - Today's message count
+     * - Unique users and tokens
+     * - Message counts by type (CHAT_MESSAGE, COMMENT)
+     *
+     * @returns Platform-wide message statistics
+     * @throws ConfigurationError if neither admin API key nor JWT is configured
+     *
+     * @since 9.1.0
+     *
+     * @example
+     * ```typescript
+     * const stats = await messagesService.getMessageStats();
+     * console.log('Total messages:', stats.totalMessages);
+     * console.log('Today:', stats.todayMessages);
+     * console.log('Unique users:', stats.uniqueUsers);
+     * console.log('Unique tokens:', stats.uniqueTokens);
+     * console.log('By type:', stats.messagesByType);
+     * ```
+     */
+    getMessageStats(): Promise<MessageStats>;
+}
+//# sourceMappingURL=MessagesService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MessagesService.d.ts","sourceRoot":"","sources":["../../src/services/MessagesService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAQ/C,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAS3B,KAAK,YAAY,EAEjB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACzB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAKhD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBAAa,eAAgB,SAAQ,sBAAsB;gBAEvD,IAAI,EAAE,UAAU,EAChB,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,OAAO,EACjB,SAAS,GAAE,OAAe,EAC1B,UAAU,CAAC,EAAE,MAAM;IAKrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAkBvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAe3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACG,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAkEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACG,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAqBhF;;;;;;;;;;;;;;;;;;OAkBG;IACG,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAmB5F;;;;;;;;;;;;;;;;OAgBG;IACG,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAmB7D;;;;;;;;;;;;;;;;;OAiBG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAY1E;;;;;;;;;;;;;;;;OAgBG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAcvD;;;;;;;;;;;;;;;OAeG;IACG,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAkBzD;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACG,eAAe,IAAI,OAAO,CAAC,YAAY,CAAC;CAQ/C"}