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

package/dist/services/ModeratorService.d.ts

@@ -0,0 +1,311 @@
+/**
+ * Moderator Invite Service
+ *
+ * Handles all moderator invite operations including creating/revoking invites,
+ * claiming invites, listing invites, and managing moderated tokens.
+ *
+ * @category Services
+ * @since 5.7.0
+ */
+import type { JwtAuth } from '../auth/JwtAuth';
+import type { ClaimModeratorInviteOptions, ClaimModeratorInviteResult, CreateModeratorInviteOptions, CreateModeratorInviteResult, GetModeratedTokensOptions, ListModeratorInvitesOptions, ModeratedTokensResult, ModeratorInviteListResult, PublicInviteInfo, UpdateInviteRoleOptions, UpdateInviteRoleResult, UpdateModeratorInviteOptions, UpdateModeratorInviteResult } from '../types/moderator.dto';
+import type { HttpClient } from '../utils/http';
+import { StreamTokenServiceBase } from './StreamTokenServiceBase';
+/**
+ * Moderator Invite Service Class
+ *
+ * Provides methods for:
+ * - Creating and revoking moderator invites (token owner)
+ * - Claiming invites (moderators)
+ * - Listing invites for a token (owner)
+ * - Getting tokens a user moderates (moderator /studio dashboard)
+ * - Getting invite details by code (public - for claim page)
+ *
+ * All endpoints require JWT authentication except getInviteByCode which is public.
+ *
+ * @remarks
+ * **Case Normalization**: Token names are automatically normalized to lowercase
+ * in all requests and responses for consistency.
+ *
+ * **Security**: This service uses JWT authentication via Authorization header.
+ * When using from browser clients, ensure tokens are stored securely
+ * (e.g., in memory, not localStorage) to prevent XSS token theft.
+ *
+ * @example
+ * ```typescript
+ * const moderatorService = new ModeratorService(httpClient, undefined, jwtAuth, true);
+ *
+ * // Create an invite (as token owner)
+ * const invite = await moderatorService.createInvite({
+ *   tokenName: 'mytoken',
+ *   role: 'MODERATOR',
+ *   description: 'John - Friday shows'
+ * });
+ * console.log('Share this link:', invite.invite.inviteUrl);
+ *
+ * // Claim an invite (as moderator)
+ * const claimed = await moderatorService.claimInvite({
+ *   inviteCode: 'abc123...'
+ * });
+ * console.log('Now moderating:', claimed.token.tokenName);
+ *
+ * // Get tokens user moderates (for /studio dashboard)
+ * const moderated = await moderatorService.getModeratedTokens({ pageSize: 20 });
+ * console.log('Moderating', moderated.items.length, 'tokens');
+ * ```
+ */
+export declare class ModeratorService extends StreamTokenServiceBase {
+    constructor(http: HttpClient, adminApiKey?: string, jwtAuth?: JwtAuth, debugMode?: boolean, userApiKey?: string);
+    /**
+     * Validate moderator role
+     */
+    private validateRole;
+    /**
+     * Validate invite code format
+     */
+    private validateInviteCodeFormat;
+    /**
+     * Validate invite scope
+     */
+    private validateInviteScope;
+    /**
+     * Create a moderator invite for a token
+     *
+     * JWT-authenticated endpoint - requires the authenticated user to be the token owner.
+     *
+     * Supports two invite scopes:
+     * - **TOKEN** (default): Access to a specific token only. `tokenName` is required.
+     * - **ALL_OWNER_TOKENS**: Blanket access to ALL tokens owned by the inviter.
+     *   The moderator gains access to current and future tokens. `tokenName` should be omitted.
+     *
+     * @param options Create options including inviteScope, tokenName (for TOKEN scope), role, and optional description/expiration
+     * @returns Created invite data including the invite URL for sharing
+     * @throws ValidationError if parameters are invalid
+     * @throws ConfigurationError if JWT is not configured
+     *
+     * @example
+     * ```typescript
+     * // Create a moderator invite for a specific token (TOKEN scope - default)
+     * const result = await moderatorService.createInvite({
+     *   tokenName: 'mytoken',
+     *   role: 'MODERATOR',
+     *   description: 'John - Friday evening shows'
+     * });
+     * console.log('Share link:', result.invite.inviteUrl);
+     *
+     * // Create a blanket invite for ALL tokens (ALL_OWNER_TOKENS scope)
+     * const blanketResult = await moderatorService.createInvite({
+     *   inviteScope: 'ALL_OWNER_TOKENS',
+     *   role: 'MANAGER',
+     *   description: 'Production team - full access'
+     * });
+     *
+     * // Create invite with expiration
+     * const result = await moderatorService.createInvite({
+     *   tokenName: 'mytoken',
+     *   role: 'TECHNICAL_PRODUCER',
+     *   expiresAt: '2025-12-31T23:59:59Z'
+     * });
+     * ```
+     */
+    createInvite(options: CreateModeratorInviteOptions): Promise<CreateModeratorInviteResult>;
+    /**
+     * List all invites for a token (owner only)
+     *
+     * JWT-authenticated endpoint - requires the authenticated user to be the token owner.
+     *
+     * @param options List options including tokenName and optional status filter/cursor-based pagination
+     * @returns Paginated list of invites
+     * @throws ValidationError if token name is invalid
+     * @throws ConfigurationError if JWT is not configured
+     * @updated 8.1.0 - Migrated to cursor-based pagination
+     *
+     * @example
+     * ```typescript
+     * // Get all invites
+     * const result = await moderatorService.listInvites({
+     *   tokenName: 'mytoken',
+     *   pageSize: 20
+     * });
+     * console.log('Total invites:', result.pageInfo.totalCount);
+     *
+     * // Filter by status
+     * const pending = await moderatorService.listInvites({
+     *   tokenName: 'mytoken',
+     *   status: 'PENDING',
+     *   pageSize: 20
+     * });
+     *
+     * // Paginate to next page (cursor-based)
+     * if (result.pageInfo.hasNextPage) {
+     *   const page2 = await moderatorService.listInvites({
+     *     tokenName: 'mytoken',
+     *     pageSize: 20,
+     *     cursor: result.pageInfo.nextCursor
+     *   });
+     * }
+     * ```
+     */
+    listInvites(options: ListModeratorInvitesOptions): Promise<ModeratorInviteListResult>;
+    /**
+     * Revoke a moderator invite (owner only)
+     *
+     * JWT-authenticated endpoint - requires the authenticated user to be the token owner.
+     * This revokes the invite, preventing it from being claimed. If already claimed,
+     * the moderator loses access.
+     *
+     * @param inviteId The ID of the invite to revoke
+     * @throws ValidationError if invite ID is invalid
+     * @throws ConfigurationError if JWT is not configured
+     * @throws Error if invite not found (404) or not authorized (403)
+     *
+     * @example
+     * ```typescript
+     * await moderatorService.revokeInvite(123);
+     * console.log('Invite revoked');
+     * ```
+     */
+    revokeInvite(inviteId: number): Promise<void>;
+    /**
+     * Update the role of a moderator invite (owner only)
+     *
+     * JWT-authenticated endpoint - requires the authenticated user to be the token owner.
+     * This changes the role granted by the invite. For claimed invites, the moderator's
+     * effective permissions change immediately (enforced at runtime).
+     *
+     * @param options Update options including inviteId and new role
+     * @returns Updated invite data
+     * @throws ValidationError if parameters are invalid
+     * @throws ConfigurationError if JWT is not configured
+     * @throws Error if invite not found (404) or not authorized (403)
+     *
+     * @example
+     * ```typescript
+     * // Upgrade a moderator to manager
+     * const result = await moderatorService.updateInviteRole({
+     *   inviteId: 123,
+     *   role: 'MANAGER'
+     * });
+     * console.log('Updated role:', result.invite.role);
+     *
+     * // Downgrade a manager to moderator
+     * await moderatorService.updateInviteRole({
+     *   inviteId: 456,
+     *   role: 'MODERATOR'
+     * });
+     * ```
+     */
+    updateInviteRole(options: UpdateInviteRoleOptions): Promise<UpdateInviteRoleResult>;
+    /**
+     * Update a moderator invite's role and/or description (owner only)
+     *
+     * JWT-authenticated endpoint - requires the authenticated user to be the token owner.
+     * At least one of role or description must be provided.
+     *
+     * @param options Update options including inviteId, and optional role and/or description
+     * @returns Updated invite data
+     * @throws ValidationError if parameters are invalid
+     * @throws ConfigurationError if JWT is not configured
+     *
+     * @example
+     * ```typescript
+     * // Update description only
+     * const result = await moderatorService.updateInvite({
+     *   inviteId: 123,
+     *   description: 'John - handles Friday evening streams'
+     * });
+     *
+     * // Update both role and description
+     * const result = await moderatorService.updateInvite({
+     *   inviteId: 123,
+     *   role: 'MANAGER',
+     *   description: 'Senior producer'
+     * });
+     * ```
+     */
+    updateInvite(options: UpdateModeratorInviteOptions): Promise<UpdateModeratorInviteResult>;
+    /**
+     * Claim a moderator invite
+     *
+     * JWT-authenticated endpoint - requires the user to be logged in.
+     * The authenticated user's wallet becomes the moderator for the token(s).
+     *
+     * Returns different result structure based on invite scope:
+     * - **TOKEN** scope: Returns `{ token }` with the specific token details
+     * - **ALL_OWNER_TOKENS** scope: Returns `{ blanketAccess }` with scope/role info
+     *
+     * @param options Claim options including the invite code
+     * @returns For TOKEN scope: `{ token }`. For ALL_OWNER_TOKENS: `{ blanketAccess }`
+     * @throws ValidationError if invite code is invalid or invite already claimed/revoked/expired
+     * @throws ConfigurationError if JWT is not configured
+     *
+     * @example
+     * ```typescript
+     * const result = await moderatorService.claimInvite({
+     *   inviteCode: 'abc123def456...'
+     * });
+     *
+     * // Check which type of invite was claimed
+     * if (result.token) {
+     *   // TOKEN scope - specific token access
+     *   console.log('Now moderating:', result.token.tokenName);
+     *   console.log('Role:', result.token.role);
+     * } else if (result.blanketAccess) {
+     *   // ALL_OWNER_TOKENS scope - blanket access to all owner's tokens
+     *   console.log('Granted blanket access as:', result.blanketAccess.role);
+     * }
+     * ```
+     */
+    claimInvite(options: ClaimModeratorInviteOptions): Promise<ClaimModeratorInviteResult>;
+    /**
+     * Get all tokens the current user moderates
+     *
+     * JWT-authenticated endpoint. Returns all tokens where the authenticated
+     * user has claimed a moderator invite and has active access.
+     * Used for the /studio dashboard.
+     *
+     * @param options Optional cursor-based pagination options
+     * @returns Paginated list of moderated tokens
+     * @throws ConfigurationError if JWT is not configured
+     * @updated 8.1.0 - Migrated to cursor-based pagination
+     *
+     * @example
+     * ```typescript
+     * const result = await moderatorService.getModeratedTokens({ pageSize: 20 });
+     * console.log('Moderating', result.pageInfo.totalCount, 'tokens');
+     *
+     * for (const token of result.items) {
+     *   console.log(`- ${token.tokenName} (${token.role})`);
+     * }
+     *
+     * // Load next page if available (cursor-based)
+     * if (result.pageInfo.hasNextPage) {
+     *   const nextPage = await moderatorService.getModeratedTokens({
+     *     pageSize: 20,
+     *     cursor: result.pageInfo.nextCursor
+     *   });
+     * }
+     * ```
+     */
+    getModeratedTokens(options?: GetModeratedTokensOptions): Promise<ModeratedTokensResult>;
+    /**
+     * Get invite details by code (public endpoint)
+     *
+     * This is a public endpoint used by the frontend claim page to display
+     * invite information before the user logs in to claim.
+     *
+     * @param inviteCode The invite code from the magic link URL
+     * @returns Public invite information (token name, role, inviter info)
+     * @throws ValidationError if invite code format is invalid
+     * @throws Error if invite not found (404)
+     *
+     * @example
+     * ```typescript
+     * const info = await moderatorService.getInviteByCode('abc123def456...');
+     * console.log(`Invited to moderate ${info.tokenName} as ${info.role}`);
+     * console.log(`Invited by: ${info.invitedBy.fullName || info.invitedBy.address}`);
+     * ```
+     */
+    getInviteByCode(inviteCode: string): Promise<PublicInviteInfo>;
+}
+//# sourceMappingURL=ModeratorService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ModeratorService.d.ts","sourceRoot":"","sources":["../../src/services/ModeratorService.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAO/C,OAAO,KAAK,EAEV,2BAA2B,EAC3B,0BAA0B,EAC1B,4BAA4B,EAC5B,2BAA2B,EAC3B,yBAAyB,EASzB,2BAA2B,EAC3B,qBAAqB,EACrB,yBAAyB,EACzB,gBAAgB,EAChB,uBAAuB,EACvB,sBAAsB,EACtB,4BAA4B,EAC5B,2BAA2B,EAAC,MAAM,wBAAwB,CAAC;AAW7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIhD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,qBAAa,gBAAiB,SAAQ,sBAAsB;gBAExD,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,YAAY;IASpB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAShC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAc3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuCG;IACG,YAAY,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAgE/F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACG,WAAW,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAmC3F;;;;;;;;;;;;;;;;;OAiBG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAuBzF;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACG,YAAY,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,2BAA2B,CAAC;IA8C/F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACG,WAAW,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,0BAA0B,CAAC;IA4B5F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACG,kBAAkB,CAAC,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA2B7F;;;;;;;;;;;;;;;;;OAiBG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAYrE"}

package/dist/services/MultiPoolStateManager.d.ts

@@ -0,0 +1,289 @@
+/**
+ * Multi-Pool State Manager
+ *
+ * Core coordinator for real-time DEX swap monitoring with offline price prediction.
+ * Manages WebSocket events, pool caching, delta application, and offline quotes.
+ *
+ * Architecture:
+ * - WebSocket listener for global swap broadcasts
+ * - Event extraction and recursive payload walking
+ * - Tiered LRU pool cache (hot/warm/cold)
+ * - Delta-based pool updates (~15-25ms vs full refetch ~200-400ms)
+ * - Offline quote calculation (~25-50ms)
+ * - Event filtering (position-independent tokens, order-independent pairs)
+ * - Metrics collection and health monitoring
+ *
+ * Performance Target: <50ms P50 latency for arbitrage bot use case
+ *
+ * @packageDocumentation
+ */
+import type { Socket } from 'socket.io-client';
+import type { CompositePoolDataResult } from '../types/composite-pool.dto';
+import type { CleanupFunction, SubscribeSwapOptions, SwapEventCallback, SwapMonitorConfig, SwapMonitorHealth } from '../types/swap-monitor.dto';
+import type { Logger } from '../utils/Logger';
+import { LoggerBase } from './BaseService';
+import type { DexQuoteService } from './DexQuoteService';
+/**
+ * Manages real-time DEX swap monitoring across multiple pools
+ *
+ * Coordinates event extraction, filtering, caching, delta application,
+ * and offline quote calculation for arbitrage bot use cases.
+ *
+ * @internal
+ */
+export declare class MultiPoolStateManager extends LoggerBase {
+    private socket;
+    private socketReady;
+    private readonly config;
+    private readonly metrics;
+    private readonly eventExtractor;
+    private readonly cacheManager;
+    private readonly eventQueue;
+    private seenTransactions;
+    private maxSeenTransactions;
+    private listeners;
+    private onErrorCallbacks;
+    private isActive;
+    private listenerRegistered;
+    /** Handler function for cleanup reference */
+    private handleSwapEvent;
+    /** Background warming loop interval handle */
+    private warmingIntervalHandle;
+    /** Reconnection manager for handling connection failures */
+    private reconnectionManager;
+    constructor(socket: Socket | Promise<Socket>, fetchPoolFn: (poolKey: string) => Promise<CompositePoolDataResult>, _quoteService: DexQuoteService, config?: SwapMonitorConfig, logger?: Logger);
+    /**
+     * Subscribe to swap events for real-time monitoring
+     *
+     * Sets up WebSocket listener for global swap broadcasts and event processing.
+     * Filters events based on options and calls callback for matching swaps.
+     * Automatically manages cache warming, offline quote calculation, and reconnection.
+     *
+     * **Performance:**
+     * - WebSocket connection: ~100-500ms initial setup
+     * - Event latency: <50ms P50 (25-50ms typical)
+     * - Delta application: 15-25ms (vs 200-400ms full refetch)
+     * - Offline quote: 25-50ms
+     *
+     * **Features:**
+     * - Position-independent token matching (GALA/USDC matches token0/token1 in any position)
+     * - Order-independent pair matching (GALA/USDC == USDC/GALA)
+     * - Tiered LRU cache with automatic background warming
+     * - Three-tier reconnection strategy for resilience
+     * - Delta-based pool updates for sub-50ms latency
+     *
+     * @param options - Subscription filter options
+     * @param options.tokenFilter - Token symbol to monitor (position-independent)
+     * @param options.pairFilter - Pair of tokens to monitor (order-independent, e.g., ['GALA', 'USDC'])
+     * @param options.feeFilter - Fee tier in basis points (e.g., 500, 3000, 10000)
+     * @param options.userFilter - User address to filter events
+     * @param options.onError - Error callback for connection/processing failures
+     *
+     * @param callback - Function called for each matching swap with signature:
+     *   `(event: SwapEventData, quote: OfflineQuote | null) => Promise<void>`
+     *
+     * @returns Cleanup function to unsubscribe and stop monitoring. Call this to:
+     *   - Remove the listener
+     *   - Unsubscribe from WebSocket if no other listeners exist
+     *   - Clean up background warming and metric collection
+     *
+     * @example
+     * ```typescript
+     * // Monitor GALA/USDC swaps for arbitrage opportunities
+     * const cleanup = monitor.subscribe(
+     *   {
+     *     pairFilter: ['GALA', 'USDC'],
+     *     feeFilter: 3000,
+     *     onError: (error) => console.error('Monitoring error:', error)
+     *   },
+     *   async (swap, quote) => {
+     *     if (quote && quote.priceImpact < 0.01) {
+     *       console.log(`Arbitrage opportunity: ${quote.priceImpact * 100}% impact`);
+     *       // Execute arbitrage logic
+     *     }
+     *   }
+     * );
+     *
+     * // Later, stop monitoring
+     * cleanup();
+     * ```
+     */
+    subscribe(options: SubscribeSwapOptions, callback: SwapEventCallback): CleanupFunction;
+    /**
+     * Get current health status with enhanced diagnostics
+     *
+     * Provides comprehensive health metrics including latency percentiles,
+     * cache performance trends, memory usage, and health recommendations.
+     *
+     * @returns Enhanced health object with detailed diagnostics
+     */
+    getHealth(): SwapMonitorHealth & {
+        recommendations?: string[];
+        detailedMetrics?: {
+            eventQueueUtilization: number;
+            cacheUtilization: number;
+            memoryUtilization: number;
+        };
+    };
+    /**
+     * Generate health recommendations based on current state
+     *
+     * @internal
+     */
+    private generateHealthRecommendations;
+    /**
+     * Get summary statistics
+     *
+     * @returns Summary with key metrics
+     */
+    getSummary(): {
+        eventsProcessed: number;
+        eventsDropped: number;
+        cacheHitRate: number;
+        averageLatency: number;
+        memoryUsedMB: number;
+        throughputPerSecond: number;
+        queueStats: {
+            queueSize: number;
+            eventsProcessed: number;
+            eventsDropped: number;
+            currentConcurrent: number;
+            maxConcurrentReached: number;
+            averageBatchSize: number;
+            totalBatchesProcessed: number;
+        };
+        cacheStats: {
+            totalCached: number;
+            hotCacheSize: number;
+            warmCacheSize: number;
+            coldCacheSize: number;
+            memoryUsedMB: number;
+        };
+    };
+    /**
+     * Start background cache warming loop
+     *
+     * Periodically refreshes hot and warm cached pools to keep data fresh.
+     * Helps prevent accumulated drift from delta-only updates.
+     *
+     * @internal
+     */
+    private startBackgroundWarming;
+    /**
+     * Stop background cache warming loop
+     *
+     * @internal
+     */
+    private stopBackgroundWarming;
+    /**
+     * Perform background cache warming
+     *
+     * Periodically refreshes pools in hot and warm tiers to prevent accumulated drift.
+     * This helps maintain cache accuracy during low-event periods.
+     *
+     * @internal
+     */
+    private performBackgroundWarming;
+    /**
+     * Shutdown gracefully
+     *
+     * Stops listening, processes remaining events, and cleans up resources.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Set up connection monitoring and error handling
+     *
+     * Implements three-tier reconnection strategy:
+     * - Tier 1 (Quick): Immediate reconnect for transient failures
+     * - Tier 2 (Exponential): Backoff with exponential delay after failures
+     * - Tier 3 (Reset): Full system reset after max retries
+     *
+     * @internal
+     */
+    private setupConnectionMonitoring;
+    /**
+     * Attempt to reconnect with three-tier strategy
+     *
+     * @internal
+     */
+    private attemptReconnection;
+    /**
+     * Perform full system reset after max reconnection failures
+     *
+     * Clears cache, resets metrics, and logs comprehensive diagnostic info.
+     *
+     * @internal
+     */
+    private performFullReset;
+    /**
+     * Set up WebSocket listener for swap events
+     *
+     * @internal
+     */
+    private setupWebSocketListener;
+    /**
+     * Unsubscribe from events
+     *
+     * @internal
+     */
+    private unsubscribe;
+    /**
+     * Filter swap based on subscription options
+     *
+     * Applies position-independent and order-independent matching.
+     *
+     * @internal
+     */
+    private filterSwap;
+    /**
+     * Process a single swap event
+     *
+     * Updates pool cache with delta, calculates offline quote, and calls listeners.
+     *
+     * @internal
+     */
+    private processSwapEvent;
+    /**
+     * Notify error handlers
+     *
+     * @internal
+     */
+    private notifyError;
+    /**
+     * Determine health status based on metrics
+     *
+     * @internal
+     */
+    private determineHealthStatus;
+    /**
+     * Get max memory based on profile
+     *
+     * @internal
+     */
+    private getMaxMemoryMB;
+    /**
+     * Apply configuration defaults
+     *
+     * @internal
+     */
+    private applyDefaults;
+}
+/**
+ * Bounded Set with LRU eviction for transaction deduplication
+ *
+ * Provides Set-like interface with automatic eviction of oldest entries
+ * when capacity is reached. Prevents unbounded memory growth in 24/7 bots.
+ *
+ * @internal
+ */
+export declare class BoundedTransactionSet {
+    private readonly map;
+    private readonly maxSize;
+    constructor(maxSize: number);
+    has(transactionId: string): boolean;
+    add(transactionId: string): this;
+    delete(transactionId: string): boolean;
+    clear(): void;
+    get size(): number;
+}
+//# sourceMappingURL=MultiPoolStateManager.d.ts.map

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

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