@mikoto_zero/minigame-open-mcp 1.0.0

package/dist/data/leaderboardDocs.js

@@ -0,0 +1,576 @@
+/**
+ * TapTap Minigame Leaderboard API Documentation
+ * Based on: https://developer.taptap.cn/minigameapidoc/dev/api/open-api/leaderboard/
+ */
+export const LEADERBOARD_DOCUMENTATION = {
+    title: "TapTap Minigame Leaderboard API",
+    description: "Complete leaderboard functionality for TapTap minigames, including score submission, ranking queries, and leaderboard display.",
+    apiReference: "https://developer.taptap.cn/minigameapidoc/dev/api/open-api/leaderboard/",
+    categories: {
+        initialization: {
+            title: "Initialization",
+            description: "Get the LeaderboardManager instance",
+            apis: [
+                {
+                    name: "tap.getLeaderboardManager",
+                    method: "tap.getLeaderboardManager()",
+                    description: "Get the LeaderboardManager instance to access leaderboard functionality",
+                    returnValue: "LeaderboardManager - The leaderboard manager instance",
+                    example: `// Get LeaderboardManager instance
+const leaderboardManager = tap.getLeaderboardManager();
+
+// Now you can use leaderboardManager to call various methods
+leaderboardManager.openLeaderboard();`
+                }
+            ]
+        },
+        display: {
+            title: "Display Leaderboard",
+            description: "Open and display the leaderboard UI page",
+            apis: [
+                {
+                    name: "openLeaderboard",
+                    method: "leaderboardManager.openLeaderboard(leaderboardId, collection, callback)",
+                    description: "Opens TapTap's leaderboard page, displaying total and friend leaderboards for the specified leaderboard ID",
+                    parameters: {
+                        "leaderboardId": "string (required) - Unique identifier for the leaderboard",
+                        "collection": "string (optional) - Leaderboard type: 'friends' for friend rankings or 'public' (default) for global rankings",
+                        "callback.onSuccess": "function (optional) - Success callback function",
+                        "callback.onFailure": "function (optional) - Failure callback with (code, message) parameters"
+                    },
+                    returnValue: "void - Opens native leaderboard UI",
+                    example: `// Open leaderboard UI
+const leaderboardManager = tap.getLeaderboardManager();
+
+// Open global leaderboard
+leaderboardManager.openLeaderboard({
+  leaderboardId: "weekly_high_score",
+  collection: "public",
+  callback: {
+    onSuccess: function(res) {
+      console.log("Leaderboard opened successfully:", res);
+    },
+    onFailure: function(code, message) {
+      console.error(\`Failed to open leaderboard: code=\${code}, message=\${message}\`);
+      // Error codes:
+      // 500001: Leaderboard ID not found
+      // 1025: Friend relationship permissions not declared
+      // 104/103: User privacy/authorization issues
+    }
+  }
+});
+
+// Open friend leaderboard
+leaderboardManager.openLeaderboard({
+  leaderboardId: "friend_ranking",
+  collection: "friends",
+  callback: {
+    onSuccess: function(res) {
+      console.log("Friend leaderboard opened");
+    },
+    onFailure: function(code, message) {
+      console.error("Failed:", message);
+    }
+  }
+});`
+                }
+            ]
+        },
+        score_submission: {
+            title: "Score Submission",
+            description: "Submit player scores to leaderboards",
+            apis: [
+                {
+                    name: "submitScores",
+                    method: "leaderboardManager.submitScores(scores, callback)",
+                    description: "Batch submit user leaderboard scores. Maximum of 5 scores can be submitted at once.",
+                    parameters: {
+                        "scores": "Array<ScoreEntry> (required) - Array of score entries to submit, maximum 5 entries",
+                        "scores[].leaderboardId": "string (required) - Unique identifier for the leaderboard",
+                        "scores[].score": "number (required) - Integer score value to submit",
+                        "callback.onSuccess": "function (optional) - Success callback function",
+                        "callback.onFailure": "function (optional) - Failure callback with (code, message) parameters"
+                    },
+                    returnValue: "void - Submission result is returned via callback",
+                    example: `// Submit scores to multiple leaderboards
+const leaderboardManager = tap.getLeaderboardManager();
+
+leaderboardManager.submitScores({
+  scores: [
+    {
+      leaderboardId: "leaderboard_1",
+      score: 1000
+    },
+    {
+      leaderboardId: "leaderboard_2",
+      score: 2000
+    }
+  ],
+  callback: {
+    onSuccess: function(res) {
+      console.log("submitScores success:", res);
+    },
+    onFailure: function(code, message) {
+      console.error(\`submitScores failed: \${code}, \${message}\`);
+      // Error codes:
+      // 500001: Leaderboard ID not found
+      // 500002: Leaderboard parameter error
+      // 500199: Invalid number of score entries (exceeds 5)
+    }
+  }
+});
+
+// Submit single score
+leaderboardManager.submitScores({
+  scores: [
+    {
+      leaderboardId: "weekly_high_score",
+      score: 15000
+    }
+  ],
+  callback: {
+    onSuccess: function(res) {
+      console.log("Score submitted successfully");
+    },
+    onFailure: function(code, message) {
+      console.error("Failed to submit score:", message);
+    }
+  }
+});`
+                }
+            ]
+        },
+        score_query: {
+            title: "Score Query",
+            description: "Query leaderboard scores and rankings",
+            apis: [
+                {
+                    name: "loadLeaderboardScores",
+                    method: "leaderboardManager.loadLeaderboardScores(leaderboardId, collection, maxSize, continuationToken, periodToken, callback)",
+                    description: "Retrieve paginated leaderboard data with support for friend and public rankings",
+                    parameters: {
+                        "leaderboardId": "string (required) - Unique identifier for the leaderboard",
+                        "collection": "string (optional) - Leaderboard type: 'friends' or 'public' (default)",
+                        "maxSize": "number (optional) - Limit results between 1-200 entries, default 200",
+                        "continuationToken": "string (optional) - Token for pagination to get next page",
+                        "periodToken": "string (optional) - Time period identifier for the leaderboard",
+                        "callback.onSuccess": "function (optional) - Success callback function",
+                        "callback.onFailure": "function (optional) - Failure callback with (code, message) parameters"
+                    },
+                    returnValue: "void - Leaderboard data is returned via callback including scores list and pagination details",
+                    example: `// Load top scores from a leaderboard
+const leaderboardManager = tap.getLeaderboardManager();
+
+leaderboardManager.loadLeaderboardScores({
+  leaderboardId: "your_leaderboardId",
+  collection: "friends",
+  maxSize: 10,
+  callback: {
+    onSuccess: function(res) {
+      console.log("Leaderboard scores:", res);
+      // res contains:
+      // - leaderboard info
+      // - scores list
+      // - next continuation token for pagination
+      // - isTruncated flag
+    },
+    onFailure: function(code, message) {
+      console.error("Load failed:", message);
+    }
+  }
+});
+
+// Load global leaderboard with pagination
+let continuationToken = null;
+
+function loadNextPage() {
+  leaderboardManager.loadLeaderboardScores({
+    leaderboardId: "weekly_high_score",
+    collection: "public",
+    maxSize: 50,
+    continuationToken: continuationToken,
+    callback: {
+      onSuccess: function(res) {
+        console.log("Page loaded:", res.scores.length, "entries");
+
+        // Check if there are more pages
+        if (res.isTruncated) {
+          continuationToken = res.continuationToken;
+          // Can load next page with the new token
+        }
+      },
+      onFailure: function(code, message) {
+        console.error("Failed to load page:", message);
+      }
+    }
+  });
+}`
+                },
+                {
+                    name: "loadCurrentPlayerLeaderboardScore",
+                    method: "leaderboardManager.loadCurrentPlayerLeaderboardScore(leaderboardId, collection, periodToken, callback)",
+                    description: "Get the current user's score and ranking position in the specified leaderboard. Requires user to have submitted a score to this leaderboard.",
+                    parameters: {
+                        "leaderboardId": "string (required) - Unique identifier for the leaderboard",
+                        "collection": "string (optional) - Leaderboard type: 'friends' or 'public' (default)",
+                        "periodToken": "string (optional) - Time period identifier for the leaderboard",
+                        "callback.onSuccess": "function (optional) - Success callback function",
+                        "callback.onFailure": "function (optional) - Failure callback with (code, message) parameters"
+                    },
+                    returnValue: "void - Current player's score data is returned via callback",
+                    example: `// Get current player's ranking
+const leaderboardManager = tap.getLeaderboardManager();
+
+leaderboardManager.loadCurrentPlayerLeaderboardScore({
+  leaderboardId: "weekly_high_score",
+  collection: "public",
+  callback: {
+    onSuccess: function(res) {
+      console.log("Your score:", res.score);
+      console.log("Your rank:", res.rank);
+      console.log("Leaderboard:", res.leaderboard);
+    },
+    onFailure: function(code, message) {
+      console.error("Failed to load player score:", message);
+    }
+  }
+});
+
+// Get friend leaderboard ranking
+leaderboardManager.loadCurrentPlayerLeaderboardScore({
+  leaderboardId: "friend_ranking",
+  collection: "friends",
+  callback: {
+    onSuccess: function(res) {
+      console.log("Your rank among friends:", res.rank);
+    },
+    onFailure: function(code, message) {
+      console.error("Failed:", message);
+    }
+  }
+});`
+                },
+                {
+                    name: "loadPlayerCenteredScores",
+                    method: "leaderboardManager.loadPlayerCenteredScores(leaderboardId, collection, maxCount, periodToken, callback)",
+                    description: "Retrieve scores for the current user and nearby players on a leaderboard, useful for showing surrounding competitors",
+                    parameters: {
+                        "leaderboardId": "string (required) - Unique identifier for the leaderboard",
+                        "collection": "string (optional) - Leaderboard type: 'friends' or 'public' (default)",
+                        "maxCount": "number (optional) - Limit results between 1-25 players",
+                        "periodToken": "string (optional) - Time period identifier for the leaderboard",
+                        "callback.onSuccess": "function (optional) - Success callback function",
+                        "callback.onFailure": "function (optional) - Failure callback with (code, message) parameters"
+                    },
+                    returnValue: "void - Nearby players' scores are returned via callback",
+                    example: `// Load nearby players' scores
+const leaderboardManager = tap.getLeaderboardManager();
+
+leaderboardManager.loadPlayerCenteredScores({
+  leaderboardId: "your_leaderboardId",
+  collection: "friends",
+  maxCount: 10,
+  callback: {
+    onSuccess: function(res) {
+      console.log("Players around you:", res);
+      // res contains current player and nearby players' scores
+      res.scores.forEach(score => {
+        const marker = score.isCurrentPlayer ? '👉' : '  ';
+        console.log(\`\${marker} Rank #\${score.rank}: \${score.playerName} - \${score.score}\`);
+      });
+    },
+    onFailure: function(code, message) {
+      console.error("Failed to load nearby scores:", message);
+    }
+  }
+});
+
+// Load surrounding players on global leaderboard
+leaderboardManager.loadPlayerCenteredScores({
+  leaderboardId: "global_ranking",
+  collection: "public",
+  maxCount: 20,
+  callback: {
+    onSuccess: function(res) {
+      console.log("Loaded", res.scores.length, "players around you");
+    },
+    onFailure: function(code, message) {
+      console.error("Failed:", message);
+    }
+  }
+});`
+                }
+            ]
+        },
+        common_scenarios: {
+            title: "Common Implementation Scenarios",
+            description: "Complete examples for typical use cases",
+            apis: [
+                {
+                    name: "Complete Game Flow",
+                    method: "N/A",
+                    description: "Example of integrating leaderboard into a complete game flow",
+                    example: `// Complete leaderboard integration example
+const leaderboardManager = tap.getLeaderboardManager();
+
+// 1. After game ends, submit score
+async function submitGameScore(finalScore) {
+  try {
+    await leaderboardManager.submitScores([{
+      leaderboardName: 'daily_ranking',
+      score: finalScore,
+      extraInfo: JSON.stringify({
+        timestamp: Date.now(),
+        gameMode: 'classic'
+      })
+    }]);
+    console.log('Score submitted!');
+    return true;
+  } catch (error) {
+    console.error('Submit failed:', error);
+    return false;
+  }
+}
+
+// 2. Show player's ranking after submission
+async function showPlayerRanking() {
+  try {
+    const playerScore = await leaderboardManager.loadCurrentPlayerLeaderboardScore('daily_ranking');
+
+    // Display ranking to player
+    showMessage(\`Your rank: #\${playerScore.rank}\`);
+    showMessage(\`Your score: \${playerScore.score}\`);
+
+    // Show if player improved
+    if (playerScore.previousRank && playerScore.rank < playerScore.previousRank) {
+      showMessage(\`🎉 You moved up \${playerScore.previousRank - playerScore.rank} positions!\`);
+    }
+  } catch (error) {
+    console.error('Failed to get ranking:', error);
+  }
+}
+
+// 3. Display nearby competitors
+async function showNearbyPlayers() {
+  try {
+    const nearby = await leaderboardManager.loadPlayerCenteredScores('daily_ranking', {
+      before: 3,
+      after: 3
+    });
+
+    // Render leaderboard UI
+    renderLeaderboard(nearby.entries);
+  } catch (error) {
+    console.error('Failed to load nearby players:', error);
+  }
+}
+
+// 4. Open full leaderboard when player clicks "View All"
+function openFullLeaderboard() {
+  leaderboardManager.openLeaderboard();
+}
+
+// Complete flow
+async function handleGameEnd(finalScore) {
+  const submitted = await submitGameScore(finalScore);
+  if (submitted) {
+    await showPlayerRanking();
+    await showNearbyPlayers();
+  }
+}
+`
+                },
+                {
+                    name: "Pagination Example",
+                    method: "N/A",
+                    description: "Example of implementing paginated leaderboard browsing",
+                    example: `// Paginated leaderboard implementation
+class LeaderboardView {
+  constructor() {
+    this.leaderboardManager = tap.getLeaderboardManager();
+    this.currentPage = 0;
+    this.pageSize = 20;
+    this.leaderboardName = 'global_ranking';
+  }
+
+  async loadPage(page) {
+    try {
+      const offset = page * this.pageSize;
+      const data = await this.leaderboardManager.loadLeaderboardScores(
+        this.leaderboardName,
+        {
+          offset: offset,
+          limit: this.pageSize
+        }
+      );
+
+      this.renderPage(data);
+      this.currentPage = page;
+
+      // Calculate total pages
+      const totalPages = Math.ceil(data.total / this.pageSize);
+      this.updatePagination(page, totalPages);
+
+      return data;
+    } catch (error) {
+      console.error('Failed to load page:', error);
+      throw error;
+    }
+  }
+
+  async nextPage() {
+    await this.loadPage(this.currentPage + 1);
+  }
+
+  async previousPage() {
+    if (this.currentPage > 0) {
+      await this.loadPage(this.currentPage - 1);
+    }
+  }
+
+  renderPage(data) {
+    // Render leaderboard entries
+    const listElement = document.getElementById('leaderboard-list');
+    listElement.innerHTML = data.entries.map(entry => \`
+      <div class="leaderboard-entry">
+        <span class="rank">#\${entry.rank}</span>
+        <span class="player">\${entry.playerName}</span>
+        <span class="score">\${entry.score}</span>
+      </div>
+    \`).join('');
+  }
+
+  updatePagination(current, total) {
+    document.getElementById('page-info').textContent = \`Page \${current + 1} of \${total}\`;
+    document.getElementById('prev-btn').disabled = current === 0;
+    document.getElementById('next-btn').disabled = current === total - 1;
+  }
+}
+
+// Usage
+const leaderboardView = new LeaderboardView();
+leaderboardView.loadPage(0);
+`
+                }
+            ]
+        }
+    }
+};
+/**
+ * Search leaderboard documentation by keyword
+ */
+export function searchLeaderboardDocs(query, category) {
+    const results = [];
+    const lowerQuery = query.toLowerCase();
+    const categoriesToSearch = category
+        ? [LEADERBOARD_DOCUMENTATION.categories[category]]
+        : Object.values(LEADERBOARD_DOCUMENTATION.categories);
+    for (const cat of categoriesToSearch) {
+        if (!cat)
+            continue;
+        for (const api of cat.apis) {
+            const searchText = `${api.name} ${api.description} ${api.example}`.toLowerCase();
+            if (searchText.includes(lowerQuery)) {
+                results.push(`
+### ${api.name}
+
+**Method:** \`${api.method}\`
+
+**Description:** ${api.description}
+
+${api.parameters ? `**Parameters:**
+${Object.entries(api.parameters).map(([key, value]) => `- \`${key}\`: ${value}`).join('\n')}
+` : ''}
+
+${api.returnValue ? `**Returns:** ${api.returnValue}\n` : ''}
+
+**Example:**
+\`\`\`javascript
+${api.example}
+\`\`\`
+`);
+            }
+        }
+    }
+    return results;
+}
+/**
+ * Get overview of leaderboard system
+ */
+export function getLeaderboardOverview() {
+    return `# ${LEADERBOARD_DOCUMENTATION.title}
+
+${LEADERBOARD_DOCUMENTATION.description}
+
+**Official API Reference:** ${LEADERBOARD_DOCUMENTATION.apiReference}
+
+## Available Categories
+
+${Object.entries(LEADERBOARD_DOCUMENTATION.categories).map(([key, cat]) => `
+### ${cat.title}
+${cat.description}
+
+Available methods: ${cat.apis.map(api => `\`${api.name}\``).join(', ')}
+`).join('\n')}
+
+## Quick Start
+
+\`\`\`javascript
+// 1. Get LeaderboardManager instance
+const leaderboardManager = tap.getLeaderboardManager();
+
+// 2. Submit a score
+await leaderboardManager.submitScores([{
+  leaderboardName: 'my_leaderboard',
+  score: 1000
+}]);
+
+// 3. Query current player's rank
+const playerScore = await leaderboardManager.loadCurrentPlayerLeaderboardScore('my_leaderboard');
+console.log('Your rank:', playerScore.rank);
+
+// 4. Open leaderboard UI
+leaderboardManager.openLeaderboard();
+\`\`\`
+`;
+}
+/**
+ * Get detailed documentation for a specific category
+ */
+export function getCategoryDocs(category) {
+    const cat = LEADERBOARD_DOCUMENTATION.categories[category];
+    if (!cat) {
+        return `Category "${category}" not found. Available categories: ${Object.keys(LEADERBOARD_DOCUMENTATION.categories).join(', ')}`;
+    }
+    return `# ${cat.title}
+
+${cat.description}
+
+${cat.apis.map(api => `
+## ${api.name}
+
+**Method:** \`${api.method}\`
+
+**Description:** ${api.description}
+
+${api.parameters ? `### Parameters
+
+${Object.entries(api.parameters).map(([key, value]) => `- **\`${key}\`**: ${value}`).join('\n')}
+` : ''}
+
+${api.returnValue ? `### Returns
+
+${api.returnValue}
+` : ''}
+
+### Example
+
+\`\`\`javascript
+${api.example}
+\`\`\`
+
+---
+`).join('\n')}
+`;
+}
+//# sourceMappingURL=leaderboardDocs.js.map

package/dist/data/leaderboardDocs.js.map

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

package/dist/network/httpClient.d.ts

@@ -0,0 +1,80 @@
+/**
+ * HTTP Client for TapTap API Requests
+ * Handles authentication, request signing, headers, and error responses
+ */
+/**
+ * Environment configuration
+ */
+export declare class ApiConfig {
+    private static instance;
+    readonly userToken: string;
+    readonly clientId: string;
+    readonly clientSecret: string;
+    readonly apiBaseUrl: string;
+    readonly environment: 'rnd' | 'production';
+    private constructor();
+    private validateConfig;
+    static getInstance(): ApiConfig;
+    isConfigured(): boolean;
+    getConfigStatus(): Record<string, string>;
+}
+/**
+ * HTTP request options
+ */
+export interface RequestOptions {
+    headers?: Record<string, string>;
+    body?: unknown;
+    params?: Record<string, string>;
+    timeout?: number;
+}
+/**
+ * HTTP response wrapper
+ */
+export interface ApiResponse<T = unknown> {
+    success: boolean;
+    data?: T;
+    message?: string;
+    error?: string;
+}
+/**
+ * Generic HTTP Client for TapTap API
+ */
+export declare class HttpClient {
+    private config;
+    constructor();
+    /**
+     * Make a GET request
+     */
+    get<T = unknown>(path: string, options?: RequestOptions): Promise<T>;
+    /**
+     * Make a POST request
+     */
+    post<T = unknown>(path: string, options?: RequestOptions): Promise<T>;
+    /**
+     * Generic request method with signature
+     */
+    private request;
+    /**
+     * Generate request signature
+     * Format: HMAC-SHA256(method + url + headers + body, CLIENT_SECRET)
+     */
+    private generateSignature;
+    /**
+     * Get headers part for signature
+     * Only includes X-Tap-* headers (excluding X-Tap-Sign)
+     */
+    private getHeadersPart;
+    /**
+     * Generate random string
+     */
+    private generateRandomString;
+    /**
+     * Get current environment
+     */
+    getEnvironment(): string;
+    /**
+     * Get API base URL
+     */
+    getBaseUrl(): string;
+}
+//# sourceMappingURL=httpClient.d.ts.map

package/dist/network/httpClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpClient.d.ts","sourceRoot":"","sources":["../../src/network/httpClient.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAY;IAEnC,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,YAAY,EAAE,MAAM,CAAC;IACrC,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,WAAW,EAAE,KAAK,GAAG,YAAY,CAAC;IAElD,OAAO;IAkBP,OAAO,CAAC,cAAc;WAsBR,WAAW,IAAI,SAAS;IAO/B,YAAY,IAAI,OAAO;IAIvB,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAQjD;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAY;;IAM1B;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,CAAC,CAAC;IAI9E;;OAEG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,CAAC,CAAC;IAI/E;;OAEG;YACW,OAAO;IAyHrB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAsBzB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAuBtB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAS5B;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,UAAU,IAAI,MAAM;CAGrB"}