mcp-google-map 0.4.0 → 0.5.0

package/dist/cli.d.ts

@@ -1,5 +1,69 @@
 #!/usr/bin/env node
-declare function startServer(port?: number, apiKey?: string, host?: string): Promise<void>;
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
+import { ToolAnnotations } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+
+interface ToolConfig {
+    name: string;
+    description: string;
+    schema: Record<string, z.ZodTypeAny>;
+    annotations?: ToolAnnotations;
+    action: (params: any) => Promise<any>;
+}
+declare class BaseMcpServer {
+    protected readonly server: McpServer;
+    private sessions;
+    private httpServer;
+    private serverName;
+    private tools;
+    constructor(name: string, tools: ToolConfig[]);
+    private createMcpServer;
+    connect(transport: Transport): Promise<void>;
+    startHttpServer(port: number, host?: string): Promise<void>;
+    startStdio(): Promise<void>;
+    stopHttpServer(): Promise<void>;
+}
+
+type RuntimeConfigSource = "flag" | "environment" | "default";
+interface ResolvedRuntimeConfig {
+    apiKey: string | undefined;
+    apiKeySource: "flag" | "environment" | "none";
+    host: string;
+    hostSource: RuntimeConfigSource;
+    port: number | undefined;
+    portRaw: string | undefined;
+    portSource: RuntimeConfigSource;
+    enabledToolsRaw: string | undefined;
+    enabledToolsSource: RuntimeConfigSource;
+    autoUpdateDisabled: boolean;
+    envFile: string | undefined;
+}
+
+type SnippetClient = "generic" | "claude" | "cursor" | "pi";
+type SnippetTransport = "stdio" | "http";
+type SnippetLauncher = "npx" | "node" | "bin";
+interface SnippetOptions {
+    client?: SnippetClient;
+    transport?: SnippetTransport;
+    launcher?: SnippetLauncher;
+    commandPath?: string;
+    host?: string;
+    port?: number;
+    envKey?: string;
+    serverName?: string;
+}
+
+declare function extractEnvFileOption(argv: readonly string[]): string | undefined;
+interface ServerStartupOutcome {
+    started: number;
+    failed: number;
+    servers: BaseMcpServer[];
+}
+declare function startServer(port?: number, apiKey?: string, host?: string): Promise<ServerStartupOutcome>;
+type ShutdownExitHook = (code: number) => void;
+declare function createShutdownHandler(servers: readonly BaseMcpServer[], exitHook?: ShutdownExitHook): (signal: string) => Promise<void>;
+declare function installShutdownHandlers(servers: readonly BaseMcpServer[]): void;
 declare const EXEC_TOOLS: readonly ["geocode", "reverse-geocode", "search-nearby", "search-places", "place-details", "directions", "distance-matrix", "elevation", "timezone", "weather", "explore-area", "plan-route", "compare-places", "air-quality", "static-map", "batch-geocode-tool", "search-along-route", "local-rank-tracker"];
 interface ExecOutput {
     write(chunk: string): unknown;
@@ -23,6 +87,67 @@ type DoctorReport = {
 type DoctorToolRunner = (toolName: string, params: any, apiKey: string) => Promise<unknown>;
 declare function execTool(toolName: string, params: any, apiKey: string): Promise<any>;
 declare function runExecCommand(toolName: string, params: any, apiKey: string, runner?: ExecToolRunner, streams?: ExecStreams): Promise<number>;
-declare function runDoctor(packageVersion: string, apiKey: string | undefined, live?: boolean, runner?: DoctorToolRunner): Promise<DoctorReport>;
+type DoctorProbeId = "geocoding" | "places-new" | "routes";
+interface DoctorLiveProbe {
+    readonly id: DoctorProbeId;
+    readonly name: string;
+    readonly tool: string;
+    readonly params: Record<string, unknown>;
+}
+declare const DOCTOR_PROBES: readonly DoctorLiveProbe[];
+interface DoctorProbesParseResult {
+    probes: DoctorProbeId[] | undefined;
+    error?: string;
+}
+declare function parseDoctorProbes(raw: string | undefined): DoctorProbesParseResult;
+interface DoctorOptions {
+    probes?: readonly DoctorProbeId[];
+    nodeVersion?: string;
+    config?: ResolvedRuntimeConfig;
+    allToolNames?: readonly string[];
+}
+declare function runDoctor(packageVersion: string, apiKey: string | undefined, live?: boolean, runner?: DoctorToolRunner, options?: DoctorOptions): Promise<DoctorReport>;
+interface SetupCheck {
+    name: string;
+    status: "pass" | "fail" | "skip";
+    detail: string;
+}
+interface SetupReport {
+    success: boolean;
+    created: boolean;
+    checks: SetupCheck[];
+}
+interface SetupFs {
+    existsSync(path: string): boolean;
+    readFileSync(path: string, encoding: "utf-8"): string;
+    writeFileSync(path: string, data: string, encoding: "utf-8"): void;
+}
+interface SetupDeps {
+    nodeVersion?: string;
+    config?: ResolvedRuntimeConfig;
+    fs?: SetupFs;
+}
+interface SetupOptions {
+    packageDir: string;
+    targetDir: string;
+    writeEnv: boolean;
+}
+declare function runSetup(options: SetupOptions, deps?: SetupDeps): Promise<SetupReport>;
+declare function runSnippetCommand(options: SnippetOptions, streams?: ExecStreams): number;
+declare function runEnableDisableCliCommand(name: string, enable: boolean, options?: {
+    home?: string;
+    streams?: ExecStreams;
+}): number;
+declare function runInstallUninstallCommand(operation: "install" | "uninstall", options: {
+    home?: string;
+    apiKey?: string;
+    resourcesRoot: string;
+    streams?: ExecStreams;
+}): number;
+declare function runShowCommand(options: {
+    home?: string;
+    resourcesRoot: string;
+    streams?: ExecStreams;
+}): number;
 
-export { type DoctorCheck, type DoctorReport, EXEC_TOOLS, execTool, runDoctor, runExecCommand, startServer };
+export { DOCTOR_PROBES, type DoctorCheck, type DoctorLiveProbe, type DoctorOptions, type DoctorProbeId, type DoctorProbesParseResult, type DoctorReport, EXEC_TOOLS, type ServerStartupOutcome, type SetupCheck, type SetupDeps, type SetupFs, type SetupOptions, type SetupReport, type ShutdownExitHook, createShutdownHandler, execTool, extractEnvFileOption, installShutdownHandlers, parseDoctorProbes, runDoctor, runEnableDisableCliCommand, runExecCommand, runInstallUninstallCommand, runSetup, runShowCommand, runSnippetCommand, startServer };