@mikoto_zero/minigame-open-mcp 1.2.0-beta.8 → 1.2.1

package/dist/core/utils/cache.js.map

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

package/dist/core/utils/docHelpers.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Documentation Helper Utilities
+ * Shared utilities for generating documentation across all features
+ */
+/**
+ * Generic API interface for documentation
+ */
+export interface APIDefinition {
+    name: string;
+    method: string;
+    description: string;
+    parameters?: Record<string, string>;
+    returnValue?: string;
+    example: string;
+}
+/**
+ * Generic category interface
+ */
+export interface APICategory {
+    title: string;
+    description: string;
+    apis: APIDefinition[];
+}
+/**
+ * Generic documentation structure
+ */
+export interface Documentation {
+    title: string;
+    description: string;
+    apiReference?: string;
+    categories: Record<string, APICategory>;
+}
+/**
+ * Generate API documentation in Markdown format
+ *
+ * @param documentation - The documentation structure
+ * @param categoryKey - The category key to look up
+ * @param apiName - The API name to find
+ * @returns Formatted Markdown documentation
+ *
+ * @example
+ * ```typescript
+ * const doc = generateAPIDoc(
+ *   LEADERBOARD_DOCUMENTATION,
+ *   'initialization',
+ *   'tap.getLeaderboardManager'
+ * );
+ * ```
+ */
+export declare function generateAPIDoc(documentation: Documentation, categoryKey: string, apiName: string): string;
+/**
+ * Generate category documentation (all APIs in a category)
+ *
+ * @param documentation - The documentation structure
+ * @param categoryKey - The category key to generate
+ * @returns Formatted Markdown documentation
+ */
+export declare function generateCategoryDoc(documentation: Documentation, categoryKey: string): string;
+/**
+ * Search documentation by keyword
+ *
+ * @param documentation - The documentation structure
+ * @param query - Search query
+ * @returns Array of matching API documentation strings
+ */
+export declare function searchDocumentation(documentation: Documentation, query: string): string[];
+/**
+ * Generate complete overview documentation
+ *
+ * @param documentation - The documentation structure
+ * @returns Formatted Markdown overview
+ */
+export declare function generateOverview(documentation: Documentation): string;
+/**
+ * Resource suggestion based on keywords
+ * Used when search returns no results
+ */
+export interface ResourceSuggestion {
+    keywords: string[];
+    uri: string;
+    description: string;
+}
+/**
+ * Generate search suggestions when no results found
+ *
+ * @param query - Search query
+ * @param suggestions - Array of resource suggestions
+ * @param overviewUri - URI of the overview resource
+ * @returns Formatted suggestion message
+ */
+export declare function generateSearchSuggestions(query: string, suggestions: ResourceSuggestion[], overviewUri?: string): string;
+//# sourceMappingURL=docHelpers.d.ts.map

package/dist/core/utils/docHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docHelpers.d.ts","sourceRoot":"","sources":["../../../src/core/utils/docHelpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,aAAa,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACzC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAC5B,aAAa,EAAE,aAAa,EAC5B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,MAAM,CA8BR;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,aAAa,EAC5B,WAAW,EAAE,MAAM,GAClB,MAAM,CAeR;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,aAAa,EAC5B,KAAK,EAAE,MAAM,GACZ,MAAM,EAAE,CAkBV;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,aAAa,GAAG,MAAM,CAuBrE;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,kBAAkB,EAAE,EACjC,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAoBR"}

package/dist/core/utils/docHelpers.js

@@ -0,0 +1,138 @@
+/**
+ * Documentation Helper Utilities
+ * Shared utilities for generating documentation across all features
+ */
+/**
+ * Generate API documentation in Markdown format
+ *
+ * @param documentation - The documentation structure
+ * @param categoryKey - The category key to look up
+ * @param apiName - The API name to find
+ * @returns Formatted Markdown documentation
+ *
+ * @example
+ * ```typescript
+ * const doc = generateAPIDoc(
+ *   LEADERBOARD_DOCUMENTATION,
+ *   'initialization',
+ *   'tap.getLeaderboardManager'
+ * );
+ * ```
+ */
+export function generateAPIDoc(documentation, categoryKey, apiName) {
+    const category = documentation.categories[categoryKey];
+    if (!category) {
+        return `Category "${categoryKey}" not found`;
+    }
+    const api = category.apis.find(a => a.name === apiName);
+    if (!api) {
+        return `API "${apiName}" not found in category "${categoryKey}"`;
+    }
+    let doc = `# ${api.name}\n\n`;
+    doc += `**Method Signature:**\n\`\`\`javascript\n${api.method}\n\`\`\`\n\n`;
+    doc += `**Description:** ${api.description}\n\n`;
+    if (api.parameters) {
+        doc += `## Parameters\n\n`;
+        for (const [param, desc] of Object.entries(api.parameters)) {
+            doc += `- **\`${param}\`**: ${desc}\n`;
+        }
+        doc += '\n';
+    }
+    if (api.returnValue) {
+        doc += `## Returns\n\n${api.returnValue}\n\n`;
+    }
+    doc += `## Code Example\n\n\`\`\`javascript\n${api.example}\n\`\`\`\n`;
+    return doc;
+}
+/**
+ * Generate category documentation (all APIs in a category)
+ *
+ * @param documentation - The documentation structure
+ * @param categoryKey - The category key to generate
+ * @returns Formatted Markdown documentation
+ */
+export function generateCategoryDoc(documentation, categoryKey) {
+    const category = documentation.categories[categoryKey];
+    if (!category) {
+        return `Category "${categoryKey}" not found`;
+    }
+    let doc = `# ${category.title}\n\n${category.description}\n\n`;
+    for (const api of category.apis) {
+        doc += `## ${api.name}\n\n`;
+        doc += `${api.description}\n\n`;
+        doc += `\`\`\`javascript\n${api.example}\n\`\`\`\n\n`;
+    }
+    return doc;
+}
+/**
+ * Search documentation by keyword
+ *
+ * @param documentation - The documentation structure
+ * @param query - Search query
+ * @returns Array of matching API documentation strings
+ */
+export function searchDocumentation(documentation, query) {
+    const results = [];
+    const queryLower = query.toLowerCase();
+    for (const [categoryKey, category] of Object.entries(documentation.categories)) {
+        for (const api of category.apis) {
+            // Search in name, method, and description
+            if (api.name.toLowerCase().includes(queryLower) ||
+                api.method.toLowerCase().includes(queryLower) ||
+                api.description.toLowerCase().includes(queryLower)) {
+                results.push(generateAPIDoc(documentation, categoryKey, api.name));
+            }
+        }
+    }
+    return results;
+}
+/**
+ * Generate complete overview documentation
+ *
+ * @param documentation - The documentation structure
+ * @returns Formatted Markdown overview
+ */
+export function generateOverview(documentation) {
+    let doc = `# ${documentation.title}\n\n`;
+    doc += `${documentation.description}\n\n`;
+    if (documentation.apiReference) {
+        doc += `**Official Documentation**: ${documentation.apiReference}\n\n`;
+    }
+    doc += `## 📚 API Categories\n\n`;
+    for (const [key, category] of Object.entries(documentation.categories)) {
+        doc += `### ${category.title}\n\n`;
+        doc += `${category.description}\n\n`;
+        doc += `**APIs:**\n`;
+        for (const api of category.apis) {
+            doc += `- \`${api.name}\` - ${api.description.split('\n')[0]}\n`;
+        }
+        doc += `\n`;
+    }
+    return doc;
+}
+/**
+ * Generate search suggestions when no results found
+ *
+ * @param query - Search query
+ * @param suggestions - Array of resource suggestions
+ * @param overviewUri - URI of the overview resource
+ * @returns Formatted suggestion message
+ */
+export function generateSearchSuggestions(query, suggestions, overviewUri) {
+    let message = `No results found for "${query}".\n\n`;
+    message += `💡 **建议：直接读取相关 Resources 获取完整文档**\n\n`;
+    const queryLower = query.toLowerCase();
+    let foundSuggestions = false;
+    for (const suggestion of suggestions) {
+        if (suggestion.keywords.some(keyword => queryLower.includes(keyword))) {
+            message += `- ${suggestion.uri} - ${suggestion.description}\n`;
+            foundSuggestions = true;
+        }
+    }
+    if (!foundSuggestions && overviewUri) {
+        message += `\n或查看完整概览：\n`;
+        message += `- ${overviewUri} - 完整功能概览\n`;
+    }
+    return message;
+}
+//# sourceMappingURL=docHelpers.js.map

package/dist/core/utils/docHelpers.js.map

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

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

@@ -0,0 +1,102 @@
+/**
+ * MCP-compliant Logger for TapTap Minigame MCP Server
+ * Supports RFC 5424 log levels and dual output mode (stderr + MCP notifications)
+ */
+import type { Server } from '@modelcontextprotocol/sdk/server/index.js';
+/**
+ * RFC 5424 log levels (syslog severity levels)
+ */
+export type LogLevel = 'debug' | 'info' | 'notice' | 'warning' | 'error' | 'critical' | 'alert' | 'emergency';
+/**
+ * MCP-compliant Logger class
+ */
+export declare class Logger {
+    private verbose;
+    private currentLevel;
+    private server?;
+    private transport?;
+    constructor();
+    /**
+     * Initialize logger with MCP server instance
+     */
+    initialize(server: Server, transport: 'stdio' | 'sse'): void;
+    /**
+     * Set log level (implements MCP logging/setLevel)
+     */
+    setLevel(level: LogLevel): void;
+    /**
+     * Get current log level
+     */
+    getLevel(): LogLevel;
+    /**
+     * Check if a message should be logged based on current level
+     */
+    private shouldLog;
+    /**
+     * Core logging method with dual output
+     * Pure dual-write: simple stderr + MCP notification
+     */
+    private log;
+    /**
+     * Log debug message
+     */
+    debug(message: string, data?: any, loggerName?: string): Promise<void>;
+    /**
+     * Log info message
+     */
+    info(message: string, data?: any, loggerName?: string): Promise<void>;
+    /**
+     * Log notice message
+     */
+    notice(message: string, data?: any, loggerName?: string): Promise<void>;
+    /**
+     * Log warning message
+     */
+    warning(message: string, data?: any, loggerName?: string): Promise<void>;
+    /**
+     * Log error message
+     */
+    error(message: string, error?: any, loggerName?: string): Promise<void>;
+    /**
+     * Log critical message
+     */
+    critical(message: string, data?: any, loggerName?: string): Promise<void>;
+    /**
+     * Log alert message
+     */
+    alert(message: string, data?: any, loggerName?: string): Promise<void>;
+    /**
+     * Log emergency message
+     */
+    emergency(message: string, data?: any, loggerName?: string): Promise<void>;
+    /**
+     * Log tool call with input arguments
+     */
+    logToolCall(toolName: string, args: any): Promise<void>;
+    /**
+     * Log tool response with output
+     */
+    logToolResponse(toolName: string, output: any, success?: boolean): Promise<void>;
+    /**
+     * Log HTTP request
+     */
+    logRequest(method: string, url: string, headers: Record<string, string>, body?: string): Promise<void>;
+    /**
+     * Log HTTP response
+     */
+    logResponse(method: string, url: string, status: number, statusText: string, body: any, success?: boolean, responseHeaders?: Record<string, string>): Promise<void>;
+    /**
+     * Log client connection event
+     */
+    logClientConnection(sessionId: string): Promise<void>;
+    /**
+     * Log client disconnection event
+     */
+    logClientDisconnection(sessionId: string): Promise<void>;
+    /**
+     * Check if verbose mode is enabled
+     */
+    isVerbose(): boolean;
+}
+export declare const logger: Logger;
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/core/utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAExE;;GAEG;AACH,MAAM,MAAM,QAAQ,GAChB,OAAO,GACP,MAAM,GACN,QAAQ,GACR,SAAS,GACT,OAAO,GACP,UAAU,GACV,OAAO,GACP,WAAW,CAAC;AAgEhB;;GAEG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,SAAS,CAAC,CAAkB;;IAMpC;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,KAAK,GAAG,IAAI;IAK5D;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAO/B;;OAEG;IACH,QAAQ,IAAI,QAAQ;IAIpB;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;;OAGG;YACW,GAAG;IAyCjB;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,UAAU,GAAE,MAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAItF;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,UAAU,GAAE,MAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrF;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,UAAU,GAAE,MAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvF;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,UAAU,GAAE,MAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxF;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,EAAE,UAAU,GAAE,MAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvF;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,UAAU,GAAE,MAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzF;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,UAAU,GAAE,MAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAItF;;OAEG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,UAAU,GAAE,MAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1F;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB7D;;OAEG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAE,OAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA6B5F;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuD5G;;OAEG;IACG,WAAW,CACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,GAAG,EACT,OAAO,GAAE,OAAc,EACvB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACvC,OAAO,CAAC,IAAI,CAAC;IA+ChB;;OAEG;IACG,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB3D;;OAEG;IACG,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB9D;;OAEG;IACH,SAAS,IAAI,OAAO;CAGrB;AAGD,eAAO,MAAM,MAAM,QAAe,CAAC"}