@gala-chain/launchpad-sdk 6.0.0 → 7.0.0-beta.2

package/dist/examples/utils/pool-helpers.d.ts

@@ -1,226 +0,0 @@
-/**
- * Pool Discovery and Selection Helpers for Examples
- *
- * Provides reusable utilities for finding and selecting pools:
- * - Find pools by criteria (TVL, volume, holders)
- * - Select random active pools for testing
- * - Pool metrics display
- *
- * @example Find a high-TVL pool
- * ```typescript
- * import { findPoolByTVL, displayPoolMetrics } from '../utils/pool-helpers';
- *
- * const pool = await findPoolByTVL(sdk, 1000); // Min $1000 TVL
- * if (pool != null) {
- *   displayPoolMetrics([pool], 'Selected Pool');
- * }
- * ```
- *
- * @since 5.13.0
- */
-import type { LaunchpadSDK } from '../../src';
-import type { PoolData } from '../../src/types/launchpad.dto';
-/**
- * Extended pool data with commonly accessed computed properties
- */
-export interface ExtendedPoolData extends PoolData {
-    currentPrice?: string;
-    marketCap?: string;
-    volume24h?: string;
-    holders?: number;
-    saleStatus?: string;
-}
-/**
- * Criteria for pool selection
- */
-export interface PoolSelectionCriteria {
-    /** Minimum TVL (default: 0) */
-    minTVL?: number;
-    /** Maximum TVL (default: Infinity) */
-    maxTVL?: number;
-    /** Minimum 24h volume (default: 0) */
-    minVolume?: number;
-    /** Minimum holder count (default: 0) */
-    minHolders?: number;
-    /** Exclude graduated pools (default: false) */
-    excludeGraduated?: boolean;
-    /** Only include graduated pools (default: false) */
-    onlyGraduated?: boolean;
-    /** Token name contains (case-insensitive) */
-    nameContains?: string;
-}
-/**
- * Fetch and filter pools by selection criteria.
- *
- * @param sdk - Configured LaunchpadSDK instance
- * @param criteria - Pool selection criteria
- * @param limit - Maximum pools to return (default: 10)
- * @returns Array of pools matching criteria
- *
- * @example
- * ```typescript
- * const pools = await findPools(sdk, {
- *   minTVL: 1000,
- *   minHolders: 5,
- *   excludeGraduated: true,
- * });
- * ```
- */
-export declare function findPools(sdk: LaunchpadSDK, criteria?: PoolSelectionCriteria, limit?: number): Promise<ExtendedPoolData[]>;
-/**
- * Find a single pool with minimum TVL.
- *
- * @param sdk - Configured LaunchpadSDK instance
- * @param minTVL - Minimum TVL required (default: 0)
- * @returns First pool matching criteria, or null
- *
- * @example
- * ```typescript
- * const pool = await findPoolByTVL(sdk, 5000); // $5k minimum
- * if (pool != null) {
- *   log.result('Found pool', pool.tokenName);
- * }
- * ```
- */
-export declare function findPoolByTVL(sdk: LaunchpadSDK, minTVL?: number): Promise<ExtendedPoolData | null>;
-/**
- * Find an active (non-graduated) pool for trading.
- *
- * @param sdk - Configured LaunchpadSDK instance
- * @param minTVL - Minimum TVL (default: 100)
- * @returns Active pool or null
- *
- * @example
- * ```typescript
- * const pool = await findActivePool(sdk);
- * if (pool != null) {
- *   await executeBuy(sdk, { tokenName: pool.tokenName, galaAmount: '10' });
- * }
- * ```
- */
-export declare function findActivePool(sdk: LaunchpadSDK, minTVL?: number): Promise<ExtendedPoolData | null>;
-/**
- * Find multiple active pools for diversified trading.
- *
- * @param sdk - Configured LaunchpadSDK instance
- * @param count - Number of pools to find (default: 3)
- * @param minTVL - Minimum TVL per pool (default: 100)
- * @returns Array of active pools
- *
- * @example
- * ```typescript
- * const pools = await findActivePools(sdk, 3, 500);
- * for (const pool of pools) {
- *   log.result('Pool', pool.tokenName);
- * }
- * ```
- */
-export declare function findActivePools(sdk: LaunchpadSDK, count?: number, minTVL?: number): Promise<ExtendedPoolData[]>;
-/**
- * Find a random pool from available pools.
- *
- * @param sdk - Configured LaunchpadSDK instance
- * @param criteria - Optional selection criteria
- * @returns Random pool matching criteria, or null
- *
- * @example
- * ```typescript
- * const randomPool = await findRandomPool(sdk, { minTVL: 100 });
- * if (randomPool != null) {
- *   log.result('Random pool', randomPool.tokenName);
- * }
- * ```
- */
-export declare function findRandomPool(sdk: LaunchpadSDK, criteria?: PoolSelectionCriteria): Promise<ExtendedPoolData | null>;
-/**
- * Display pool metrics in a formatted table.
- *
- * @param pools - Array of pools to display
- * @param title - Optional table title
- *
- * @example
- * ```typescript
- * const pools = await findActivePools(sdk, 5);
- * displayPoolMetrics(pools, 'Top Active Pools');
- * ```
- */
-export declare function displayPoolMetrics(pools: ExtendedPoolData[], title?: string): void;
-/**
- * Display detailed information for a single pool.
- *
- * @param pool - Pool to display
- *
- * @example
- * ```typescript
- * const pool = await findPoolByTVL(sdk, 1000);
- * if (pool != null) {
- *   displayPoolDetails(pool);
- * }
- * ```
- */
-export declare function displayPoolDetails(pool: ExtendedPoolData): void;
-/**
- * Require at least one pool matching criteria or exit.
- *
- * @param sdk - Configured LaunchpadSDK instance
- * @param criteria - Pool selection criteria
- * @param errorMessage - Custom error message (optional)
- * @returns Pool matching criteria
- * @throws Exits process if no pool found
- *
- * @example
- * ```typescript
- * const pool = await requirePool(sdk, { minTVL: 100 });
- * // Guaranteed to have a pool here, or process exits
- * ```
- */
-export declare function requirePool(sdk: LaunchpadSDK, criteria?: PoolSelectionCriteria, errorMessage?: string): Promise<ExtendedPoolData>;
-/**
- * Ensure a pool exists or create a test token.
- *
- * @param sdk - Configured LaunchpadSDK instance
- * @param criteria - Pool selection criteria
- * @param createIfMissing - Create test token if no pool found (default: false)
- * @returns Pool or newly created token info
- *
- * @example
- * ```typescript
- * const pool = await ensurePool(sdk, { minTVL: 100 }, true);
- * log.result('Using pool', pool.tokenName);
- * ```
- */
-export declare function ensurePool(sdk: LaunchpadSDK, criteria?: PoolSelectionCriteria, createIfMissing?: boolean): Promise<ExtendedPoolData>;
-/**
- * Calculate aggregate statistics for a set of pools.
- *
- * @param pools - Array of pools to analyze
- * @returns Aggregate statistics
- *
- * @example
- * ```typescript
- * const pools = await findActivePools(sdk, 10);
- * const stats = calculatePoolStats(pools);
- * log.result('Total TVL', formatNumber(stats.totalTVL));
- * ```
- */
-export declare function calculatePoolStats(pools: ExtendedPoolData[]): {
-    totalTVL: number;
-    totalVolume24h: number;
-    totalHolders: number;
-    avgPrice: number;
-    poolCount: number;
-};
-/**
- * Display aggregate pool statistics.
- *
- * @param pools - Array of pools to analyze
- * @param title - Optional title
- *
- * @example
- * ```typescript
- * const pools = await findActivePools(sdk, 10);
- * displayPoolStats(pools, 'Market Overview');
- * ```
- */
-export declare function displayPoolStats(pools: ExtendedPoolData[], title?: string): void;
-//# sourceMappingURL=pool-helpers.d.ts.map

package/dist/examples/utils/pool-helpers.d.ts.map

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

package/dist/examples/utils/punchlist.d.ts

@@ -1,104 +0,0 @@
-/**
- * Failure Punchlist - Structured failure reporting and Serena memory integration
- *
- * Generates comprehensive failure reports with suggested debugging actions,
- * saves to Serena memory for immediate debugging, and manages cleanup of old reports.
- *
- * @since 5.15.0
- */
-import type { DemoRegistryEntry } from './demo-registry';
-/**
- * Single failure entry in the punchlist
- */
-export interface PunchlistFailure {
-    demoNumber: number;
-    id: string;
-    name: string;
-    category: string;
-    scriptPath: string;
-    error: string;
-    duration: string;
-    timestamp: string;
-    suggestedActions: string[];
-}
-/**
- * Category breakdown entry
- */
-export interface CategoryBreakdown {
-    total: number;
-    passed: number;
-    failed: number;
-    failedDemos: string[];
-}
-/**
- * Complete punchlist structure
- */
-export interface Punchlist {
-    runId: string;
-    summary: {
-        totalDemos: number;
-        completedDemos: number;
-        failed: number;
-        failureRate: string;
-        categoriesWithFailures: string[];
-    };
-    failures: PunchlistFailure[];
-    categoryBreakdown: Record<string, CategoryBreakdown>;
-}
-/**
- * Demo result for building punchlist
- */
-export interface DemoResultForPunchlist {
-    demo: DemoRegistryEntry;
-    demoNumber: number;
-    success: boolean;
-    error: string | undefined;
-    duration: number;
-}
-/**
- * Generate suggested debugging actions based on error patterns
- *
- * @param demo - Demo registry entry
- * @param error - Error message
- * @returns Array of suggested debugging actions
- */
-export declare function generateSuggestedActions(demo: DemoRegistryEntry, error: string): string[];
-/**
- * Build category breakdown from failure results
- *
- * @param results - All demo results
- * @param failures - Only failed demo results
- * @returns Category breakdown map
- */
-export declare function buildCategoryBreakdown(results: DemoResultForPunchlist[], failures: DemoResultForPunchlist[]): Record<string, CategoryBreakdown>;
-/**
- * Generate punchlist from demo execution results
- *
- * @param results - All demo execution results
- * @param totalDuration - Total execution duration in milliseconds
- * @returns Complete punchlist object
- */
-export declare function generatePunchlist(results: DemoResultForPunchlist[], totalDuration: number): Punchlist;
-/**
- * Format punchlist as markdown for Serena memory
- *
- * @param punchlist - Punchlist to format
- * @returns Markdown string
- */
-export declare function formatPunchlistMarkdown(punchlist: Punchlist): string;
-/**
- * Save punchlist to local file (fallback for Serena MCP unavailability)
- *
- * @param punchlist - Punchlist to save
- * @param outputDir - Output directory (default: ./demo-failures)
- * @returns Path to saved file
- */
-export declare function savePunchlistLocal(punchlist: Punchlist, outputDir?: string): string;
-/**
- * Cleanup old punchlist files (keep only the most recent ones)
- *
- * @param outputDir - Output directory containing punchlist files
- * @param keepCount - Number of most recent files to keep (default: 5)
- */
-export declare function cleanupOldPunchlists(outputDir?: string, keepCount?: number): void;
-//# sourceMappingURL=punchlist.d.ts.map

package/dist/examples/utils/punchlist.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"punchlist.d.ts","sourceRoot":"","sources":["../../../examples/utils/punchlist.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QACP,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,sBAAsB,EAAE,MAAM,EAAE,CAAC;KAClC,CAAC;IACF,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,iBAAiB,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,iBAAiB,EACvB,KAAK,EAAE,MAAM,GACZ,MAAM,EAAE,CAuFV;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,sBAAsB,EAAE,EACjC,QAAQ,EAAE,sBAAsB,EAAE,GACjC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CA4BnC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,sBAAsB,EAAE,EACjC,aAAa,EAAE,MAAM,GACpB,SAAS,CAqCX;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAsEpE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,SAAS,EACpB,SAAS,GAAE,MAA0B,GACpC,MAAM,CAkBR;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,GAAE,MAA0B,EACrC,SAAS,GAAE,MAAU,GACpB,IAAI,CAoBN"}