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

package/dist/types/weekly-challenge.dto.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Weekly Challenge Types
+ *
+ * Types for the weekly challenge leaderboard feature that tracks
+ * token market cap increases week-over-week.
+ *
+ * @category Types
+ * @since 9.0.0
+ */
+/**
+ * Token data in the weekly challenge leaderboard
+ */
+export interface LeaderboardToken {
+    /** Token vault address */
+    vaultAddress: string;
+    /** Token name (lowercase) */
+    tokenName: string;
+    /** Token symbol (uppercase) */
+    symbol: string;
+    /** Token image URL */
+    image: string;
+    /** Token description */
+    description: string;
+    /** Website URL */
+    websiteUrl: string;
+    /** Twitter URL */
+    twitterUrl: string;
+    /** Telegram URL */
+    telegramUrl: string;
+    /** Creator wallet address */
+    creatorAddress: string;
+    /** Current market cap in GALA */
+    marketCapGala: string;
+    /** Current market cap in USD */
+    marketCapUsd: string;
+    /** Market cap increase since week start (GALA) */
+    marketCapIncreaseGala: number;
+    /** Current price in GALA */
+    galaPrice: string;
+    /** Current price in USD */
+    usdPrice: string;
+    /** Leaderboard rank (1-based) */
+    rank: number;
+}
+/**
+ * Weekly challenge leaderboard response
+ */
+export interface WeeklyChallengeLeaderboard {
+    /** Tokens ranked by market cap increase */
+    tokens: LeaderboardToken[];
+    /** Current snapshot date (ISO string) */
+    snapshotDate: string | null;
+    /** Week start date (Saturday, ISO string) */
+    weekStart: string | null;
+    /** Week end date (Friday, ISO string) */
+    weekEnd: string | null;
+    /** Total count of tokens in leaderboard */
+    count: number;
+}
+/**
+ * Historical snapshot for a token
+ */
+export interface TokenWeeklySnapshot {
+    /** Token vault address */
+    vaultAddress: string;
+    /** Snapshot date */
+    snapshotDate: string;
+    /** Week start date */
+    weekStart: string;
+    /** Week end date */
+    weekEnd: string;
+    /** Market cap in GALA at snapshot */
+    marketCapGala: string;
+    /** Market cap in USD at snapshot */
+    marketCapUsd: string;
+    /** Price in GALA at snapshot */
+    priceGala: string;
+    /** Price in USD at snapshot */
+    priceUsd: string;
+    /** Whether this snapshot is finalized (end of week) */
+    isFinalized: boolean;
+}
+/**
+ * Options for getting weekly challenge leaderboard
+ */
+export interface GetWeeklyChallengeOptions {
+    /**
+     * Number of tokens to return (1-50)
+     * @default 10
+     */
+    limit?: number;
+}
+/**
+ * Result type for weekly challenge leaderboard
+ */
+export interface GetWeeklyChallengeResult {
+    leaderboard: WeeklyChallengeLeaderboard;
+}
+/**
+ * Options for getting token weekly history
+ */
+export interface GetTokenWeeklyHistoryOptions {
+    /** Token vault address */
+    vaultAddress: string;
+}
+/**
+ * Result type for token weekly history
+ */
+export interface GetTokenWeeklyHistoryResult {
+    snapshots: TokenWeeklySnapshot[];
+}
+/**
+ * Internal API response for weekly challenge
+ */
+export interface InternalWeeklyChallengeResponse {
+    status: number;
+    error: boolean;
+    message?: string;
+    data: WeeklyChallengeLeaderboard;
+}
+/**
+ * Internal API response for token history
+ */
+export interface InternalTokenHistoryResponse {
+    status: number;
+    error: boolean;
+    message?: string;
+    data: TokenWeeklySnapshot[];
+}
+//# sourceMappingURL=weekly-challenge.dto.d.ts.map

package/dist/types/weekly-challenge.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weekly-challenge.dto.d.ts","sourceRoot":"","sources":["../../src/types/weekly-challenge.dto.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0BAA0B;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,qBAAqB,EAAE,MAAM,CAAC;IAC9B,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,2CAA2C;IAC3C,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,yCAAyC;IACzC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,6CAA6C;IAC7C,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,yCAAyC;IACzC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,0BAA0B;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,0BAA0B,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,0BAA0B;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,mBAAmB,EAAE,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,0BAA0B,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,mBAAmB,EAAE,CAAC;CAC7B"}

package/dist/types/wrappable-token.dto.d.ts

@@ -0,0 +1,305 @@
+/**
+ * Wrappable Token Types
+ *
+ * Type definitions for dynamically fetched wrappable tokens from DEX API.
+ * Wrappable tokens are token pairs where one can be wrapped/unwrapped into
+ * the other (e.g., MUSIC ↔ GMUSIC).
+ *
+ * @category Types
+ * @since 4.0.18
+ */
+import type { BaseCacheStats } from '../services/AbstractCacheService.js';
+import type { TokenId } from './common.js';
+/**
+ * Current USD price information from API response
+ */
+export interface WrappableTokenPrices {
+    /** Current USD price */
+    usd?: number;
+    /** 24-hour price change percentage */
+    usd24hChange?: number;
+    /** 24-hour trading volume in USD */
+    usd24hVol?: number;
+    /** Market cap in USD */
+    usdMarketCap?: number;
+    /** Timestamp of last price update */
+    lastUpdatedAt?: string;
+}
+/**
+ * Raw wrappable token response from DEX API /v1/tokens?wrappable=true
+ *
+ * This is the structure returned directly from the API.
+ */
+export interface WrappableTokenApiResponse {
+    /** Token symbol on GalaChain (e.g., "MUSIC", "GMUSIC") */
+    symbol: string;
+    /** Token display name */
+    name: string;
+    /** Token decimals */
+    decimals: number;
+    /** Token description */
+    description?: string;
+    /** Token image URL */
+    image?: string;
+    /** Pipe-delimited token class key (e.g., "$MUSIC|Unit|none|none") */
+    stringifiedTokenClassKey: string;
+    /** Token collection */
+    collection: string;
+    /** Token category */
+    category: string;
+    /** Token type */
+    type: string;
+    /** Additional key */
+    additionalKey: string;
+    /** Network (always "GC" for GalaChain) */
+    network: string;
+    /** Whether the token is verified */
+    verified: boolean;
+    /** Whether the token is swappable on DEX */
+    swappable: boolean;
+    /** Token channel (e.g., "music", "asset") */
+    channel?: string;
+    /** Whether the token is trending */
+    trending?: boolean;
+    /** Bridge destination chain ID (if bridgeable) */
+    bridgeDestinationChainId?: number;
+    /** Whether bridging is disabled */
+    disableBridge?: boolean;
+    /** Price symbol for external price sources */
+    priceSymbol?: string;
+    /** Whether price is known to external sources */
+    priceIsKnownToExternalPriceSource?: boolean;
+    /** Counterpart token's stringified TokenClassKey (e.g., "$GMUSIC|Unit|none|none") */
+    wrap: string;
+    /** Current USD prices (optional) */
+    currentPrices?: WrappableTokenPrices;
+    /** User's balance (only when address param provided) */
+    balance?: string;
+}
+/**
+ * Paginated response from /v1/tokens?wrappable=true API
+ */
+export interface WrappableTokensApiResponse {
+    /** Array of wrappable tokens */
+    tokens: WrappableTokenApiResponse[];
+}
+/**
+ * Processed wrappable token for SDK use
+ *
+ * This is the normalized structure used internally by the SDK.
+ */
+export interface WrappableToken {
+    /** Token symbol on GalaChain (e.g., "MUSIC", "GMUSIC") */
+    symbol: string;
+    /** Token display name */
+    name: string;
+    /** Token decimals */
+    decimals: number;
+    /** GalaChain token descriptor */
+    galaChainDescriptor: {
+        collection: string;
+        category: string;
+        type: string;
+        additionalKey: string;
+    };
+    /** Pipe-delimited token class key */
+    stringifiedTokenClassKey: string;
+    /** Counterpart token's stringified TokenClassKey */
+    wrapCounterpart: string;
+    /** Whether the token is swappable on DEX */
+    swappable: boolean;
+    /** Whether the token is verified */
+    verified: boolean;
+    /** Token channel (e.g., "music", "asset") */
+    channel?: string;
+    /** Whether the token is trending */
+    trending?: boolean;
+    /** Token image URL */
+    image?: string;
+    /** Token description */
+    description?: string;
+    /** Current USD prices */
+    currentPrices?: WrappableTokenPrices;
+}
+/**
+ * Options for fetching wrappable tokens (metadata only, no balance)
+ */
+export interface FetchWrappableTokensOptions {
+    /** Pagination offset (default: 0) */
+    offset?: number;
+    /** Results per page (max: 1000, default: 1000) */
+    limit?: number;
+}
+/**
+ * Result of fetching wrappable tokens (metadata only, no balance)
+ */
+export interface FetchWrappableTokensResult {
+    /** Array of wrappable tokens */
+    tokens: WrappableToken[];
+    /** Timestamp when data was fetched */
+    fetchedAt: number;
+    /** Number of tokens returned */
+    tokenCount: number;
+}
+/**
+ * Options for getting a wrappable token by tokenId
+ */
+export interface GetWrappableTokenOptions {
+    /**
+     * Token identifier in flexible format.
+     *
+     * Accepts:
+     * - Pipe-delimited string: "$MUSIC|Unit|none|none"
+     * - TokenClassKey object: { collection: '$MUSIC', category: 'Unit', type: 'none', additionalKey: 'none' }
+     *
+     * @example "$MUSIC|Unit|none|none"
+     * @example { collection: '$MUSIC', category: 'Unit', type: 'none', additionalKey: 'none' }
+     */
+    tokenId: TokenId;
+}
+/**
+ * Result of checking if a token is wrappable
+ */
+export interface IsTokenWrappableResult {
+    /** Whether the token is wrappable */
+    isWrappable: boolean;
+    /** The queried token's stringified TokenClassKey */
+    tokenId: string;
+    /** Counterpart token's stringified TokenClassKey (if wrappable) */
+    wrapCounterpart?: string;
+}
+/**
+ * Cache statistics for wrappable tokens
+ *
+ * Note: Uses `totalItems` from BaseCacheStats for token count.
+ * The `tokenCount` alias is provided for convenience.
+ */
+export interface WrappableTokenCacheStats extends BaseCacheStats {
+    /** Number of tokens in cache (alias for totalItems) */
+    tokenCount: number;
+    /** Whether cache is populated */
+    isPopulated: boolean;
+    /** Timestamp when cache was last updated */
+    lastFetchedAt: number | null;
+}
+/**
+ * Options for wrapping a token (e.g., MUSIC → GMUSIC)
+ *
+ * Wrapping transfers a token from its native channel to the asset channel,
+ * converting it to its wrapped counterpart. This is required for tokens
+ * like MUSIC to be traded on the DEX.
+ *
+ * @example
+ * ```typescript
+ * const result = await sdk.wrapToken({
+ *   tokenId: 'MUSIC',
+ *   amount: '100.5',
+ * });
+ * ```
+ */
+export interface WrapTokenOptions {
+    /**
+     * Token to wrap (source token on native channel).
+     *
+     * Accepts:
+     * - Symbol: "MUSIC"
+     * - Pipe-delimited: "$MUSIC|Unit|none|none"
+     * - TokenClassKey object: { collection: '$MUSIC', ... }
+     */
+    tokenId: TokenId;
+    /** Amount to wrap (decimal string, e.g., "100.5") */
+    amount: string;
+    /** Optional recipient address (defaults to sender) */
+    recipient?: string;
+    /** Optional memo for the transaction */
+    memo?: string;
+}
+/**
+ * Options for unwrapping a token (e.g., GMUSIC → MUSIC)
+ *
+ * Unwrapping transfers a token from the asset channel back to its native
+ * channel, converting it from the wrapped version to the original.
+ *
+ * @example
+ * ```typescript
+ * const result = await sdk.unwrapToken({
+ *   tokenId: 'GMUSIC',
+ *   amount: '50',
+ * });
+ * ```
+ */
+export interface UnwrapTokenOptions {
+    /**
+     * Token to unwrap (wrapped token on asset channel).
+     *
+     * Accepts:
+     * - Symbol: "GMUSIC"
+     * - Pipe-delimited: "$GMUSIC|Unit|none|none"
+     * - TokenClassKey object: { collection: '$GMUSIC', ... }
+     */
+    tokenId: TokenId;
+    /** Amount to unwrap (decimal string, e.g., "50") */
+    amount: string;
+    /** Optional recipient address (defaults to sender) */
+    recipient?: string;
+    /** Optional memo for the transaction */
+    memo?: string;
+}
+/**
+ * Result of a wrap or unwrap operation
+ */
+export interface WrapUnwrapResult {
+    /** Whether the operation succeeded */
+    success: boolean;
+    /** Transaction hash/ID for tracking */
+    transactionId?: string;
+    /** Source token symbol (e.g., "MUSIC" for wrap, "GMUSIC" for unwrap) */
+    fromToken: string;
+    /** Destination token symbol (e.g., "GMUSIC" for wrap, "MUSIC" for unwrap) */
+    toToken: string;
+    /** Amount transferred (decimal string) */
+    amount: string;
+    /** Source channel name (e.g., "music", "asset") */
+    fromChannel: string;
+    /** Destination channel name (e.g., "asset", "music") */
+    toChannel: string;
+    /** Fee paid for the operation (if any) */
+    fee?: string;
+    /** Timestamp when the operation completed (epoch ms) */
+    completedAt?: number;
+    /** Error message if operation failed */
+    error?: string;
+}
+/**
+ * Fee estimation for wrap/unwrap operations
+ *
+ * Wrap and unwrap operations may have different fee authorization types:
+ * - Wrap (→ asset): Uses `cross_channel_authorization` on source channel
+ * - Unwrap (→ native): Uses `automatic` authorization on asset channel
+ */
+export interface WrapUnwrapFeeEstimate {
+    /** Estimated fee amount (decimal string) */
+    fee: string;
+    /** Fee token symbol (usually "GALA") */
+    feeToken: string;
+    /** Fee authorization type used by the backend */
+    authorizationType: 'cross_channel_authorization' | 'automatic';
+    /** Channel where the fee is authorized/charged */
+    feeChannel: string;
+}
+/**
+ * Status of a wrap/unwrap operation
+ */
+export type WrapUnwrapStatus = 'pending' | 'processing' | 'completed' | 'failed';
+/**
+ * Extended result with status polling information
+ */
+export interface WrapUnwrapStatusResult extends WrapUnwrapResult {
+    /** Current status of the operation */
+    status: WrapUnwrapStatus;
+    /** Number of confirmations (if applicable) */
+    confirmations?: number;
+    /** Estimated time remaining in ms (if available) */
+    estimatedTimeRemainingMs?: number;
+}
+//# sourceMappingURL=wrappable-token.dto.d.ts.map

package/dist/types/wrappable-token.dto.d.ts.map

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

package/dist/utils/LiquidityEventExtractor.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Liquidity Event Extractor
+ *
+ * Parses WebSocket event payloads to extract liquidity transaction data.
+ * Handles recursive payload traversal for add/remove liquidity events.
+ *
+ * Follows the same pattern as SwapEventExtractor but adapted for liquidity operations.
+ *
+ * @packageDocumentation
+ */
+import type { LiquidityEventData } from '../types/liquidity-monitor.dto';
+import { Logger } from './Logger';
+/**
+ * Extracts liquidity event data from WebSocket payloads
+ *
+ * Recursively walks through event payloads to find liquidity transaction data
+ * in various possible locations (direct fields, nested objects, etc).
+ *
+ * @internal
+ */
+export declare class LiquidityEventExtractor {
+    private readonly logger;
+    constructor(logger?: Logger);
+    /**
+     * Recursively walk through a payload to find and extract liquidity events
+     *
+     * Returns all newly discovered events not in seenTransactions.
+     *
+     * Includes depth limiting to prevent DoS attacks from deeply nested payloads.
+     * Maximum nesting depth is 50 levels.
+     *
+     * Note: The backend broadcasts position change events without distinguishing
+     * between add and remove operations.
+     *
+     * @param payload - Event payload to search
+     * @param seenTransactions - Set-like object of transaction IDs already processed
+     * @returns Array of extracted liquidity events
+     */
+    walkPayloadForLiquidityEvents(payload: unknown, seenTransactions: {
+        has(id: string): boolean;
+        add(id: string): unknown;
+    }): LiquidityEventData[];
+    /**
+     * Try to extract a liquidity event from an object
+     *
+     * Checks for liquidity event structures from the backend:
+     * - Backend WebSocket format: { Data: {...liquidity fields}, transactionId: "..." }
+     * - Direct fields: positionId, poolHash, amounts, userAddress
+     *
+     * @param obj - Object to check
+     * @returns Extracted LiquidityEventData or null if not a liquidity event
+     */
+    private extractLiquidityFromObject;
+    /**
+     * Extract transaction ID from object
+     */
+    private extractTransactionId;
+    /**
+     * Extract position ID from object
+     */
+    private extractPositionId;
+    /**
+     * Extract pool hash from object
+     *
+     * Tries multiple field names for backward compatibility:
+     * - poolHash: Primary field from backend
+     * - pool_hash: Alternative snake_case format
+     * - pool: Generic pool identifier fallback
+     *
+     * Note: poolId was removed from backend contract and is no longer attempted.
+     */
+    private extractPoolHash;
+    /**
+     * Extract pool alias from object
+     */
+    private extractPoolAlias;
+    /**
+     * Extract amounts array [amount0, amount1] from object
+     */
+    private extractAmounts;
+    /**
+     * Extract user address from object
+     */
+    private extractUserAddress;
+    /**
+     * Extract pool fee from object
+     */
+    private extractPoolFee;
+    /**
+     * Normalize fee value to basis points
+     */
+    private normalizeFee;
+    /**
+     * Extract timestamp from object
+     */
+    private extractTimestamp;
+    /**
+     * Extract userBalanceDelta from object
+     */
+    private extractUserBalanceDelta;
+    /**
+     * Extract balance object from raw data
+     */
+    private extractBalanceObject;
+}
+//# sourceMappingURL=LiquidityEventExtractor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LiquidityEventExtractor.d.ts","sourceRoot":"","sources":["../../src/utils/LiquidityEventExtractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAIlC;;;;;;;GAOG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,CAAC,EAAE,MAAM;IAI3B;;;;;;;;;;;;;;OAcG;IACH,6BAA6B,CAC3B,OAAO,EAAE,OAAO,EAChB,gBAAgB,EAAE;QAAE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GACvE,kBAAkB,EAAE;IAsCvB;;;;;;;;;OASG;IACH,OAAO,CAAC,0BAA0B;IAyDlC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAa5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAazB;;;;;;;;;OASG;IACH,OAAO,CAAC,eAAe;IAavB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;OAEG;IACH,OAAO,CAAC,cAAc;IAuBtB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACH,OAAO,CAAC,cAAc;IAqBtB;;OAEG;IACH,OAAO,CAAC,YAAY;IAmBpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqBxB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAyB/B;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAsC7B"}

package/dist/utils/Logger.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Unified Logger Utility
+ *
+ * Provides standardized logging across all SDK services and components.
+ * Replaces three different logging patterns (console.log with debug checks,
+ * custom debug functions, and inline logging) with a single consistent approach.
+ *
+ * Features:
+ * - Standardized log format with timestamps and prefixes
+ * - Log level support (debug, info, warn, error)
+ * - Conditional logging based on debug flag
+ * - Contextual prefixes for different services
+ * - Zero overhead when debug is disabled
+ *
+ * @packageDocumentation
+ */
+/**
+ * Log levels supported by the Logger
+ */
+export declare enum LogLevel {
+    DEBUG = "DEBUG",
+    INFO = "INFO",
+    WARN = "WARN",
+    ERROR = "ERROR"
+}
+/**
+ * Logger configuration options
+ */
+export interface LoggerConfig {
+    /** Enable debug logging */
+    debug: boolean;
+    /** Context prefix for log messages (e.g., 'BundleService', 'WebSocket') */
+    context?: string;
+    /** Minimum log level to output (defaults to DEBUG when debug=true, INFO otherwise) */
+    minLevel?: LogLevel;
+}
+/**
+ * Unified Logger class for consistent logging across the SDK
+ *
+ * @example Basic usage
+ * ```typescript
+ * const logger = new Logger({ debug: true, context: 'BundleService' });
+ * logger.debug('Processing buy transaction', { tokenName: 'mytoken' });
+ * logger.info('Transaction submitted', { txId: '0x123' });
+ * logger.warn('High slippage detected', { slippage: 0.15 });
+ * logger.error('Transaction failed', error);
+ * ```
+ *
+ * @example Conditional logging
+ * ```typescript
+ * // With debug: false, only info/warn/error are logged
+ * const logger = new Logger({ debug: false, context: 'WebSocket' });
+ * logger.debug('Connection details', data); // Not logged
+ * logger.info('Connected to server'); // Logged
+ * ```
+ */
+export declare class Logger {
+    private readonly debugEnabled;
+    private readonly context;
+    private readonly minLevel;
+    private readonly levelPriority;
+    constructor(config: LoggerConfig);
+    /**
+     * Log a debug message
+     * Only logged when debug mode is enabled
+     *
+     * @param message Log message
+     * @param data Optional data object to log
+     */
+    debug(message: string, data?: unknown): void;
+    /**
+     * Log an info message
+     * Always logged (unless minLevel is higher)
+     *
+     * @param message Log message
+     * @param data Optional data object to log
+     */
+    info(message: string, data?: unknown): void;
+    /**
+     * Log a warning message
+     * Always logged (unless minLevel is higher)
+     *
+     * @param message Log message
+     * @param data Optional data object to log
+     */
+    warn(message: string, data?: unknown): void;
+    /**
+     * Log an error message
+     * Always logged
+     *
+     * @param message Log message
+     * @param error Optional error object or data
+     */
+    error(message: string, error?: unknown): void;
+    /**
+     * Internal logging implementation
+     * @private
+     */
+    private log;
+    /**
+     * Get appropriate console method for log level
+     * @private
+     */
+    private getConsoleMethod;
+    /**
+     * Create a child logger with a sub-context
+     * Useful for creating method-specific or operation-specific loggers
+     *
+     * @param subContext Additional context to append
+     * @returns New Logger instance with combined context
+     *
+     * @example
+     * ```typescript
+     * const serviceLogger = new Logger({ debug: true, context: 'BundleService' });
+     * const methodLogger = serviceLogger.child('buyToken');
+     * methodLogger.debug('Starting buy operation'); // [BundleService:buyToken] [DEBUG] Starting buy operation
+     * ```
+     */
+    child(subContext: string): Logger;
+    /**
+     * Check if debug logging is enabled
+     * Useful for avoiding expensive operations when debug is off
+     *
+     * @returns True if debug logging is enabled
+     *
+     * @example
+     * ```typescript
+     * if (logger.isDebugEnabled()) {
+     *   const expensiveData = computeExpensiveDebugInfo();
+     *   logger.debug('Debug info', expensiveData);
+     * }
+     * ```
+     */
+    isDebugEnabled(): boolean;
+}
+//# sourceMappingURL=Logger.d.ts.map