@mikoto_zero/minigame-open-mcp 1.0.0 → 1.0.2

package/bin/minigame-open-mcp

@@ -2,33 +2,31 @@
 
 /**
  * TapTap Minigame Open API MCP Server
+ * Entry point for NPM executable
  */
 
-const path = require('path');
-const fs = require('fs');
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import { existsSync } from 'node:fs';
+
+// Get current file path and directory (ES Module equivalent of __dirname)
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
 
 // Get package root directory
-const packageRoot = path.join(__dirname, '..');
+const packageRoot = join(__dirname, '..');
 
 // Check if compiled version exists
-const distPath = path.join(packageRoot, 'dist', 'server.js');
-const srcPath = path.join(packageRoot, 'src', 'server.ts');
+const distPath = join(packageRoot, 'dist', 'server.js');
 
-if (fs.existsSync(distPath)) {
-    // Use compiled version
-    require(distPath);
-} else if (fs.existsSync(srcPath)) {
-    // Development mode, use ts-node
-    try {
-        require('ts-node/register');
-        require(srcPath);
-    } catch (error) {
-        console.error('❌ Please install dependencies or build the project:');
-        console.error('   npm install');
-        console.error('   npm run build');
+if (existsSync(distPath)) {
+    // Use compiled version (ES Module dynamic import)
+    import(distPath).catch(error => {
+        console.error('❌ Failed to start server:', error);
         process.exit(1);
-    }
+    });
 } else {
-    console.error('❌ Server file not found');
+    console.error('❌ Server file not found. Please build the project first:');
+    console.error('   npm run build');
     process.exit(1);
 }

package/dist/config/toolDefinitions.d.ts

@@ -0,0 +1,10 @@
+/**
+ * MCP Tool Definitions
+ * Centralized tool definitions for the MCP server
+ */
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Get all tool definitions
+ */
+export declare function getToolDefinitions(): Tool[];
+//# sourceMappingURL=toolDefinitions.d.ts.map

package/dist/config/toolDefinitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolDefinitions.d.ts","sourceRoot":"","sources":["../../src/config/toolDefinitions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE1D;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,EAAE,CA8O3C"}

package/dist/config/toolDefinitions.js

@@ -0,0 +1,241 @@
+/**
+ * MCP Tool Definitions
+ * Centralized tool definitions for the MCP server
+ */
+/**
+ * Get all tool definitions
+ */
+export function getToolDefinitions() {
+    return [
+        // 🎯 Workflow Guidance Tool
+        {
+            name: 'start_leaderboard_integration',
+            description: 'START HERE when user asks about integrating leaderboards, implementing rankings, or "接入排行榜". This tool guides the complete workflow: check existing leaderboards, create if needed, then provide implementation docs. Use this as the first step for any leaderboard integration request.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    purpose: {
+                        type: 'string',
+                        description: 'What the user wants to do with leaderboards (optional, for context)'
+                    }
+                }
+            }
+        },
+        // 📖 Core LeaderboardManager API Documentation Tools (one tool per API)
+        {
+            name: 'get_leaderboard_manager',
+            description: 'Get documentation for tap.getLeaderboardManager() - how to obtain the LeaderboardManager instance. Use this when user asks how to initialize or access the leaderboard system.',
+            inputSchema: {
+                type: 'object',
+                properties: {}
+            }
+        },
+        {
+            name: 'open_leaderboard',
+            description: 'Get documentation for leaderboardManager.openLeaderboard() - how to display the TapTap leaderboard UI. Use this when user wants to show leaderboard interface to players.',
+            inputSchema: {
+                type: 'object',
+                properties: {}
+            }
+        },
+        {
+            name: 'submit_scores',
+            description: 'Get documentation for leaderboardManager.submitScores() - how to submit player scores to leaderboards. Use this when user wants to upload scores or update rankings.',
+            inputSchema: {
+                type: 'object',
+                properties: {}
+            }
+        },
+        {
+            name: 'load_leaderboard_scores',
+            description: 'Get documentation for leaderboardManager.loadLeaderboardScores() - how to retrieve paginated leaderboard data. Use this when user wants to fetch top scores or implement custom leaderboard UI.',
+            inputSchema: {
+                type: 'object',
+                properties: {}
+            }
+        },
+        {
+            name: 'load_current_player_score',
+            description: 'Get documentation for leaderboardManager.loadCurrentPlayerLeaderboardScore() - how to get current player\'s score and rank. Use this when user wants to show player their own ranking.',
+            inputSchema: {
+                type: 'object',
+                properties: {}
+            }
+        },
+        {
+            name: 'load_player_centered_scores',
+            description: 'Get documentation for leaderboardManager.loadPlayerCenteredScores() - how to load scores of players near current user. Use this when user wants to display surrounding competitors.',
+            inputSchema: {
+                type: 'object',
+                properties: {}
+            }
+        },
+        // 🔍 Helper Tools
+        {
+            name: 'search_leaderboard_docs',
+            description: 'Search all leaderboard documentation by keyword. Use this when user asks a general question or you\'re not sure which specific API they need.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    query: {
+                        type: 'string',
+                        description: 'Search keyword, such as: leaderboard, score, ranking, submission, etc.'
+                    }
+                },
+                required: ['query']
+            }
+        },
+        {
+            name: 'get_leaderboard_overview',
+            description: 'Get comprehensive overview of all TapTap leaderboard APIs and features. Use this when user wants to understand what leaderboard functionality is available.',
+            inputSchema: {
+                type: 'object',
+                properties: {}
+            }
+        },
+        {
+            name: 'get_leaderboard_patterns',
+            description: 'Get complete implementation examples and best practices for leaderboards. Use this when user wants to see full integration code or common usage patterns.',
+            inputSchema: {
+                type: 'object',
+                properties: {}
+            }
+        },
+        // 🔧 Environment Check Tool
+        {
+            name: 'check_environment',
+            description: 'Check environment configuration and user authentication status. Use this to verify if TAPTAP_MAC_TOKEN and TAPTAP_CLIENT_ID are configured.',
+            inputSchema: {
+                type: 'object',
+                properties: {}
+            }
+        },
+        // 📱 Developer & App Management Tools
+        {
+            name: 'list_developers_and_apps',
+            description: 'List all developers and their apps/games for the current user. Use this when multiple developers or apps exist and you need to let user/AI choose which one to use.',
+            inputSchema: {
+                type: 'object',
+                properties: {}
+            }
+        },
+        {
+            name: 'select_app',
+            description: 'Select a specific developer and app to use for subsequent operations. This will cache the selection. Use this after listing developers and apps with list_developers_and_apps.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    developer_id: {
+                        type: 'number',
+                        description: 'Developer ID to select (required)'
+                    },
+                    app_id: {
+                        type: 'number',
+                        description: 'App/Game ID to select (required)'
+                    }
+                },
+                required: ['developer_id', 'app_id']
+            }
+        },
+        // ⚙️ Leaderboard Management Tools (requires TAPTAP_MAC_TOKEN, TAPTAP_CLIENT_ID, TAPTAP_CLIENT_SECRET)
+        {
+            name: 'create_leaderboard',
+            description: 'Create a new leaderboard on TapTap server. Use this AFTER checking existing leaderboards with list_leaderboards or start_leaderboard_integration. Auto-fetches developer_id and app_id if not provided. Returns the leaderboard_id needed for client-side APIs.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    developer_id: {
+                        type: 'number',
+                        description: 'Developer ID (optional, will be auto-fetched if not provided)'
+                    },
+                    app_id: {
+                        type: 'number',
+                        description: 'Application/Game ID (optional, will be auto-fetched if not provided)'
+                    },
+                    title: {
+                        type: 'string',
+                        description: 'Leaderboard title/name (required)'
+                    },
+                    period_type: {
+                        type: 'number',
+                        description: 'Period type: 0=Daily, 1=Weekly, 2=Monthly, 3=Always, 4=Custom (required)',
+                        enum: [0, 1, 2, 3, 4]
+                    },
+                    score_type: {
+                        type: 'number',
+                        description: 'Score type: 0=Integer, 1=Float, 2=Time (required)',
+                        enum: [0, 1, 2]
+                    },
+                    score_order: {
+                        type: 'number',
+                        description: 'Score order: 0=Ascending (lower is better), 1=Descending (higher is better), 2=None (required)',
+                        enum: [0, 1, 2]
+                    },
+                    calc_type: {
+                        type: 'number',
+                        description: 'Calculation type: 0=Best, 1=Latest, 2=Sum, 3=First (required)',
+                        enum: [0, 1, 2, 3]
+                    },
+                    display_limit: {
+                        type: 'number',
+                        description: 'Display limit for leaderboard entries (optional, default 100)'
+                    },
+                    period_time: {
+                        type: 'string',
+                        description: 'Period reset time in HH:MM:SS format (optional, for periodic leaderboards)'
+                    },
+                    score_unit: {
+                        type: 'string',
+                        description: 'Score unit display text (optional, e.g., "points", "seconds")'
+                    }
+                },
+                required: ['title', 'period_type', 'score_type', 'score_order', 'calc_type']
+            }
+        },
+        {
+            name: 'list_leaderboards',
+            description: 'List all leaderboards created for the current app/game. Use this to check existing leaderboards before creating new ones or when user asks "我有哪些排行榜" or wants to see leaderboard IDs. Auto-fetches developer_id and app_id if not provided.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    developer_id: {
+                        type: 'number',
+                        description: 'Developer ID (optional, will be auto-fetched if not provided)'
+                    },
+                    app_id: {
+                        type: 'number',
+                        description: 'Application/Game ID (optional, will be auto-fetched if not provided)'
+                    },
+                    page: {
+                        type: 'number',
+                        description: 'Page number, starts from 1 (optional, default 1)'
+                    },
+                    page_size: {
+                        type: 'number',
+                        description: 'Results per page (optional, default 10)'
+                    }
+                }
+            }
+        },
+        // 🔑 User Data Tools (requires TAPTAP_MAC_TOKEN)
+        {
+            name: 'get_user_leaderboard_scores',
+            description: 'Get actual user leaderboard score data from TapTap API (requires user login). Use this when user wants to see their own scores or ranking positions. Falls back to documentation mode if token is not provided.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    leaderboardId: {
+                        type: 'string',
+                        description: 'The specific leaderboard ID to query. Leave empty to get all leaderboards associated with the user.'
+                    },
+                    limit: {
+                        type: 'number',
+                        description: 'Maximum number of score entries to return. Default is 10.',
+                        default: 10
+                    }
+                }
+            }
+        }
+    ];
+}
+//# sourceMappingURL=toolDefinitions.js.map

package/dist/config/toolDefinitions.js.map

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

package/dist/handlers/appHandlers.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Application Management Handlers
+ * Handles developer and app selection operations
+ */
+/**
+ * Handler context for accessing environment variables
+ */
+export interface HandlerContext {
+    projectPath?: string;
+}
+/**
+ * List all developers and apps for the current user
+ */
+export declare function listDevelopersAndApps(context: HandlerContext): Promise<string>;
+/**
+ * Select a specific developer and app
+ */
+export declare function selectApp(args: {
+    developer_id: number;
+    app_id: number;
+}, context: HandlerContext): Promise<string>;
+//# sourceMappingURL=appHandlers.d.ts.map

package/dist/handlers/appHandlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appHandlers.d.ts","sourceRoot":"","sources":["../../src/handlers/appHandlers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAyCpF;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC9C,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,MAAM,CAAC,CAejB"}

package/dist/handlers/appHandlers.js

@@ -0,0 +1,66 @@
+/**
+ * Application Management Handlers
+ * Handles developer and app selection operations
+ */
+import { getAllDevelopersAndApps, selectApp as selectAppApi } from '../network/leaderboardApi.js';
+/**
+ * List all developers and apps for the current user
+ */
+export async function listDevelopersAndApps(context) {
+    try {
+        const result = await getAllDevelopersAndApps();
+        if (!result.list || result.list.length === 0) {
+            return `📋 暂无开发者或应用\n\n您还没有创建任何开发者账号或应用。请先在 TapTap 开放平台创建应用。`;
+        }
+        let output = `📋 开发者和应用列表\n\n`;
+        result.list.forEach((developer, devIndex) => {
+            output += `**开发者 ${devIndex + 1}: ${developer.developer_name}**\n`;
+            output += `- Developer ID: ${developer.developer_id}\n`;
+            if (!developer.crafts || developer.crafts.length === 0) {
+                output += `- 暂无应用\n\n`;
+            }
+            else {
+                output += `- 应用列表:\n`;
+                developer.crafts.forEach((app, appIndex) => {
+                    output += `  ${appIndex + 1}. **${app.app_title}** (App ID: ${app.app_id})\n`;
+                    if (app.category) {
+                        output += `     类别: ${app.category}\n`;
+                    }
+                    if (app.is_published !== undefined) {
+                        output += `     已发布: ${app.is_published ? '是' : '否'}\n`;
+                    }
+                });
+                output += `\n`;
+            }
+        });
+        output += `\n💡 **下一步:**\n`;
+        output += `使用 select_app 工具选择要使用的开发者和应用，例如:\n`;
+        output += `- developer_id: ${result.list[0].developer_id}\n`;
+        output += `- app_id: ${result.list[0].crafts[0]?.app_id || 'N/A'}\n`;
+        return output;
+    }
+    catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        return `❌ 获取开发者和应用列表失败:\n${errorMsg}`;
+    }
+}
+/**
+ * Select a specific developer and app
+ */
+export async function selectApp(args, context) {
+    try {
+        const result = await selectAppApi(args.developer_id, args.app_id, context.projectPath);
+        return `✅ 已选择应用!\n\n` +
+            `📱 应用信息:\n` +
+            `- 开发者: ${result.developer_name} (ID: ${result.developer_id})\n` +
+            `- 应用: ${result.app_title} (ID: ${result.app_id})\n\n` +
+            `💾 此选择已缓存，后续操作将默认使用此应用。\n\n` +
+            `🎮 下一步:\n` +
+            `您现在可以使用 create_leaderboard 或 list_leaderboards 等工具来管理排行榜了。`;
+    }
+    catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        return `❌ 选择应用失败:\n${errorMsg}\n\n请使用 list_developers_and_apps 查看可用的开发者和应用列表。`;
+    }
+}
+//# sourceMappingURL=appHandlers.js.map

package/dist/handlers/appHandlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appHandlers.js","sourceRoot":"","sources":["../../src/handlers/appHandlers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,uBAAuB,EAAE,SAAS,IAAI,YAAY,EAAE,MAAM,8BAA8B,CAAC;AASlG;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,OAAuB;IACjE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,uBAAuB,EAAE,CAAC;QAE/C,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7C,OAAO,sDAAsD,CAAC;QAChE,CAAC;QAED,IAAI,MAAM,GAAG,iBAAiB,CAAC;QAE/B,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE;YAC1C,MAAM,IAAI,SAAS,QAAQ,GAAG,CAAC,KAAK,SAAS,CAAC,cAAc,MAAM,CAAC;YACnE,MAAM,IAAI,mBAAmB,SAAS,CAAC,YAAY,IAAI,CAAC;YAExD,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,SAAS,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvD,MAAM,IAAI,YAAY,CAAC;YACzB,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,WAAW,CAAC;gBACtB,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE;oBACzC,MAAM,IAAI,KAAK,QAAQ,GAAG,CAAC,OAAO,GAAG,CAAC,SAAS,eAAe,GAAG,CAAC,MAAM,KAAK,CAAC;oBAC9E,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;wBACjB,MAAM,IAAI,YAAY,GAAG,CAAC,QAAQ,IAAI,CAAC;oBACzC,CAAC;oBACD,IAAI,GAAG,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;wBACnC,MAAM,IAAI,aAAa,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;oBAC1D,CAAC;gBACH,CAAC,CAAC,CAAC;gBACH,MAAM,IAAI,IAAI,CAAC;YACjB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,iBAAiB,CAAC;QAC5B,MAAM,IAAI,oCAAoC,CAAC;QAC/C,MAAM,IAAI,mBAAmB,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC;QAC7D,MAAM,IAAI,aAAa,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;QAErE,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxE,OAAO,oBAAoB,QAAQ,EAAE,CAAC;IACxC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,IAA8C,EAC9C,OAAuB;IAEvB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAEvF,OAAO,cAAc;YACd,YAAY;YACZ,UAAU,MAAM,CAAC,cAAc,SAAS,MAAM,CAAC,YAAY,KAAK;YAChE,SAAS,MAAM,CAAC,SAAS,SAAS,MAAM,CAAC,MAAM,OAAO;YACtD,6BAA6B;YAC7B,WAAW;YACX,4DAA4D,CAAC;IACtE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxE,OAAO,cAAc,QAAQ,iDAAiD,CAAC;IACjF,CAAC;AACH,CAAC"}

package/dist/handlers/environmentHandlers.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Environment Check Handlers
+ * Handles environment variable checking and validation
+ */
+/**
+ * Handler context for accessing environment variables
+ */
+export interface HandlerContext {
+    projectPath?: string;
+}
+/**
+ * Check environment configuration and authentication status
+ */
+export declare function checkEnvironment(context: HandlerContext): Promise<string>;
+//# sourceMappingURL=environmentHandlers.d.ts.map

package/dist/handlers/environmentHandlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environmentHandlers.d.ts","sourceRoot":"","sources":["../../src/handlers/environmentHandlers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAa/E"}

package/dist/handlers/environmentHandlers.js

@@ -0,0 +1,21 @@
+/**
+ * Environment Check Handlers
+ * Handles environment variable checking and validation
+ */
+import { ApiConfig } from '../network/httpClient.js';
+/**
+ * Check environment configuration and authentication status
+ */
+export async function checkEnvironment(context) {
+    const apiConfig = ApiConfig.getInstance();
+    const configStatus = apiConfig.getConfigStatus();
+    const envInfo = {
+        ...configStatus,
+        'TAPTAP_PROJECT_PATH': context.projectPath ? '✅ 已配置' : '❌ 未配置 (可选)'
+    };
+    const envResult = Object.entries(envInfo)
+        .map(([key, value]) => `${key}: ${value}`)
+        .join('\n');
+    return `🔧 环境配置检查结果:\n\n${envResult}\n\n✨ 所有必需配置已就绪，可以使用完整功能`;
+}
+//# sourceMappingURL=environmentHandlers.js.map

package/dist/handlers/environmentHandlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environmentHandlers.js","sourceRoot":"","sources":["../../src/handlers/environmentHandlers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AASrD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAuB;IAC5D,MAAM,SAAS,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;IAC1C,MAAM,YAAY,GAAG,SAAS,CAAC,eAAe,EAAE,CAAC;IACjD,MAAM,OAAO,GAAG;QACd,GAAG,YAAY;QACf,qBAAqB,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY;KACpE,CAAC;IAEF,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;SACtC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,KAAK,EAAE,CAAC;SACzC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO,mBAAmB,SAAS,0BAA0B,CAAC;AAChE,CAAC"}

package/dist/handlers/leaderboardHandlers.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Leaderboard Management Handlers
+ * Handles leaderboard operations including creation, listing, and workflow guidance
+ */
+/**
+ * Handler context for accessing environment variables
+ */
+export interface HandlerContext {
+    projectPath?: string;
+    macToken?: any;
+}
+/**
+ * Start leaderboard integration workflow - guides user through the process
+ */
+export declare function startLeaderboardIntegration(args: {
+    purpose?: string;
+}, context: HandlerContext): Promise<string>;
+/**
+ * Create a new leaderboard
+ */
+export declare function createLeaderboard(args: {
+    developer_id?: number;
+    app_id?: number;
+    title: string;
+    period_type: number;
+    score_type: number;
+    score_order: number;
+    calc_type: number;
+    display_limit?: number;
+    period_time?: string;
+    score_unit?: string;
+}, context: HandlerContext): Promise<string>;
+/**
+ * List all leaderboards for the current app
+ */
+export declare function listLeaderboards(args: {
+    developer_id?: number;
+    app_id?: number;
+    page?: number;
+    page_size?: number;
+}, context: HandlerContext): Promise<string>;
+/**
+ * Get user leaderboard scores (requires user token)
+ */
+export declare function getUserLeaderboardScores(args: {
+    leaderboardId?: string;
+    limit?: number;
+}, context: HandlerContext): Promise<string>;
+//# sourceMappingURL=leaderboardHandlers.d.ts.map

package/dist/handlers/leaderboardHandlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leaderboardHandlers.d.ts","sourceRoot":"","sources":["../../src/handlers/leaderboardHandlers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAcH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,GAAG,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EAC1B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,MAAM,CAAC,CAuFjB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE;IACJ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,EACD,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,MAAM,CAAC,CAoEjB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE;IACJ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,EACD,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,MAAM,CAAC,CAiDjB;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAChD,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,MAAM,CAAC,CA8BjB"}