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

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

@@ -0,0 +1,52 @@
+/**
+ * Shared Logging Utility for Examples
+ *
+ * Provides consistent, colorful console output across all demo scripts.
+ * Import this instead of defining `log` object in each file.
+ *
+ * @example
+ * ```typescript
+ * import { log } from '../utils/logger';
+ *
+ * log.section('My Demo Section');
+ * log.info('Processing...');
+ * log.success('Done!');
+ * log.json('Result', { foo: 'bar' });
+ * ```
+ *
+ * @since 5.0.2
+ */
+/**
+ * Enhanced logging with emoji indicators and formatted output
+ */
+export declare const log: {
+    /** Major section header with === borders */
+    readonly section: (title: string) => void;
+    /** Named section header with indented title (centered visual emphasis) */
+    readonly namedSection: (title: string) => void;
+    /** Subsection header with --- borders */
+    readonly subsection: (title: string) => void;
+    /** Informational message */
+    readonly info: (msg: string) => void;
+    /** Success message */
+    readonly success: (msg: string) => void;
+    /** Labeled result output */
+    readonly result: (label: string, value: unknown) => void;
+    /** Error message */
+    readonly error: (msg: string) => void;
+    /** Warning message */
+    readonly warn: (msg: string) => void;
+    /** Warning message (alias for warn) */
+    readonly warning: (msg: string) => void;
+    /** Pretty-printed JSON with label */
+    readonly json: (label: string, obj: unknown) => void;
+    /** Empty line for spacing */
+    readonly divider: () => void;
+    /** Table output */
+    readonly table: (data: Record<string, unknown>[]) => void;
+};
+/**
+ * Type for the log object methods
+ */
+export type Logger = typeof log;
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../examples/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;GAEG;AACH,eAAO,MAAM,GAAG;IACd,4CAA4C;8BAC3B,MAAM;IAGvB,0EAA0E;mCACpD,MAAM;IAG5B,yCAAyC;iCACrB,MAAM;IAG1B,4BAA4B;yBAChB,MAAM;IAElB,sBAAsB;4BACP,MAAM;IAErB,4BAA4B;6BACZ,MAAM,SAAS,OAAO;IAGtC,oBAAoB;0BACP,MAAM;IAEnB,sBAAsB;yBACV,MAAM;IAElB,uCAAuC;4BACxB,MAAM;IAErB,qCAAqC;2BACvB,MAAM,OAAO,OAAO;IAKlC,6BAA6B;;IAG7B,mBAAmB;2BACL,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;CAC/B,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,OAAO,GAAG,CAAC"}

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

@@ -0,0 +1,226 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,104 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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"}