@ryancardin/noaa-tides-currents-mcp-server 2.0.0 → 2.1.0

package/dist/schemas/dpapi.d.ts

@@ -1,198 +0,0 @@
-import { z } from 'zod';
-export declare const AffiliationSchema: z.ZodOptional<z.ZodEnum<["Global", "US"]>>;
-export declare const ScenarioSchema: z.ZodOptional<z.ZodEnum<["all", "low", "intermediate-low", "intermediate", "intermediate-high", "high", "extreme"]>>;
-export declare const SeasonSchema: z.ZodOptional<z.ZodEnum<["DJF", "MAM", "JJA", "SON"]>>;
-export declare const DpapiDatumSchema: z.ZodOptional<z.ZodEnum<["STND", "MLLW", "MHHW", "GT", "MSL", "MLW", "MHW"]>>;
-export declare const ThresholdSchema: z.ZodOptional<z.ZodEnum<["minor", "moderate", "major"]>>;
-export declare const DecadeSchema: z.ZodOptional<z.ZodString>;
-export declare const YearSchema: z.ZodOptional<z.ZodString>;
-export declare const YearRangeSchema: z.ZodOptional<z.ZodString>;
-export declare const SeaLevelTrendsSchema: z.ZodObject<{
-    station: z.ZodString;
-    affil: z.ZodOptional<z.ZodEnum<["Global", "US"]>>;
-    format: z.ZodOptional<z.ZodEnum<["json", "xml", "csv"]>>;
-}, "strip", z.ZodTypeAny, {
-    station: string;
-    format?: "json" | "xml" | "csv" | undefined;
-    affil?: "Global" | "US" | undefined;
-}, {
-    station: string;
-    format?: "json" | "xml" | "csv" | undefined;
-    affil?: "Global" | "US" | undefined;
-}>;
-export declare const ExtremeWaterLevelsSchema: z.ZodObject<{
-    station: z.ZodString;
-    units: z.ZodOptional<z.ZodEnum<["english", "metric"]>>;
-    format: z.ZodOptional<z.ZodEnum<["json", "xml", "csv"]>>;
-}, "strip", z.ZodTypeAny, {
-    station: string;
-    format?: "json" | "xml" | "csv" | undefined;
-    units?: "english" | "metric" | undefined;
-}, {
-    station: string;
-    format?: "json" | "xml" | "csv" | undefined;
-    units?: "english" | "metric" | undefined;
-}>;
-export declare const HighTideFloodingDailySchema: z.ZodObject<{
-    station: z.ZodString;
-    format: z.ZodOptional<z.ZodEnum<["json", "xml", "csv"]>>;
-    datum: z.ZodOptional<z.ZodEnum<["STND", "MLLW", "MHHW", "GT", "MSL", "MLW", "MHW"]>>;
-    threshold: z.ZodOptional<z.ZodEnum<["minor", "moderate", "major"]>>;
-    begin_date: z.ZodOptional<z.ZodString>;
-    end_date: z.ZodOptional<z.ZodString>;
-    year: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    station: string;
-    threshold?: "minor" | "moderate" | "major" | undefined;
-    year?: string | undefined;
-    format?: "json" | "xml" | "csv" | undefined;
-    end_date?: string | undefined;
-    begin_date?: string | undefined;
-    datum?: "MHHW" | "MHW" | "MSL" | "MLW" | "MLLW" | "STND" | "GT" | undefined;
-}, {
-    station: string;
-    threshold?: "minor" | "moderate" | "major" | undefined;
-    year?: string | undefined;
-    format?: "json" | "xml" | "csv" | undefined;
-    end_date?: string | undefined;
-    begin_date?: string | undefined;
-    datum?: "MHHW" | "MHW" | "MSL" | "MLW" | "MLLW" | "STND" | "GT" | undefined;
-}>;
-export declare const HighTideFloodingMonthlySchema: z.ZodObject<{
-    station: z.ZodString;
-    format: z.ZodOptional<z.ZodEnum<["json", "xml", "csv"]>>;
-    datum: z.ZodOptional<z.ZodEnum<["STND", "MLLW", "MHHW", "GT", "MSL", "MLW", "MHW"]>>;
-    threshold: z.ZodOptional<z.ZodEnum<["minor", "moderate", "major"]>>;
-    begin_date: z.ZodOptional<z.ZodString>;
-    end_date: z.ZodOptional<z.ZodString>;
-    year: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    station: string;
-    threshold?: "minor" | "moderate" | "major" | undefined;
-    year?: string | undefined;
-    format?: "json" | "xml" | "csv" | undefined;
-    end_date?: string | undefined;
-    begin_date?: string | undefined;
-    datum?: "MHHW" | "MHW" | "MSL" | "MLW" | "MLLW" | "STND" | "GT" | undefined;
-}, {
-    station: string;
-    threshold?: "minor" | "moderate" | "major" | undefined;
-    year?: string | undefined;
-    format?: "json" | "xml" | "csv" | undefined;
-    end_date?: string | undefined;
-    begin_date?: string | undefined;
-    datum?: "MHHW" | "MHW" | "MSL" | "MLW" | "MLLW" | "STND" | "GT" | undefined;
-}>;
-export declare const HighTideFloodingSeasonalSchema: z.ZodObject<{
-    station: z.ZodString;
-    format: z.ZodOptional<z.ZodEnum<["json", "xml", "csv"]>>;
-    datum: z.ZodOptional<z.ZodEnum<["STND", "MLLW", "MHHW", "GT", "MSL", "MLW", "MHW"]>>;
-    threshold: z.ZodOptional<z.ZodEnum<["minor", "moderate", "major"]>>;
-    season_months: z.ZodOptional<z.ZodEnum<["DJF", "MAM", "JJA", "SON"]>>;
-    begin_date: z.ZodOptional<z.ZodString>;
-    end_date: z.ZodOptional<z.ZodString>;
-    year: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    station: string;
-    threshold?: "minor" | "moderate" | "major" | undefined;
-    year?: string | undefined;
-    format?: "json" | "xml" | "csv" | undefined;
-    end_date?: string | undefined;
-    begin_date?: string | undefined;
-    datum?: "MHHW" | "MHW" | "MSL" | "MLW" | "MLLW" | "STND" | "GT" | undefined;
-    season_months?: "DJF" | "MAM" | "JJA" | "SON" | undefined;
-}, {
-    station: string;
-    threshold?: "minor" | "moderate" | "major" | undefined;
-    year?: string | undefined;
-    format?: "json" | "xml" | "csv" | undefined;
-    end_date?: string | undefined;
-    begin_date?: string | undefined;
-    datum?: "MHHW" | "MHW" | "MSL" | "MLW" | "MLLW" | "STND" | "GT" | undefined;
-    season_months?: "DJF" | "MAM" | "JJA" | "SON" | undefined;
-}>;
-export declare const HighTideFloodingAnnualSchema: z.ZodObject<{
-    station: z.ZodString;
-    format: z.ZodOptional<z.ZodEnum<["json", "xml", "csv"]>>;
-    datum: z.ZodOptional<z.ZodEnum<["STND", "MLLW", "MHHW", "GT", "MSL", "MLW", "MHW"]>>;
-    threshold: z.ZodOptional<z.ZodEnum<["minor", "moderate", "major"]>>;
-    begin_date: z.ZodOptional<z.ZodString>;
-    end_date: z.ZodOptional<z.ZodString>;
-    year_range: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    station: string;
-    threshold?: "minor" | "moderate" | "major" | undefined;
-    format?: "json" | "xml" | "csv" | undefined;
-    end_date?: string | undefined;
-    begin_date?: string | undefined;
-    datum?: "MHHW" | "MHW" | "MSL" | "MLW" | "MLLW" | "STND" | "GT" | undefined;
-    year_range?: string | undefined;
-}, {
-    station: string;
-    threshold?: "minor" | "moderate" | "major" | undefined;
-    format?: "json" | "xml" | "csv" | undefined;
-    end_date?: string | undefined;
-    begin_date?: string | undefined;
-    datum?: "MHHW" | "MHW" | "MSL" | "MLW" | "MLLW" | "STND" | "GT" | undefined;
-    year_range?: string | undefined;
-}>;
-export declare const HighTideFloodingProjectionsSchema: z.ZodObject<{
-    station: z.ZodString;
-    format: z.ZodOptional<z.ZodEnum<["json", "xml", "csv"]>>;
-    scenario: z.ZodOptional<z.ZodEnum<["all", "low", "intermediate-low", "intermediate", "intermediate-high", "high", "extreme"]>>;
-    datum: z.ZodOptional<z.ZodEnum<["STND", "MLLW", "MHHW", "GT", "MSL", "MLW", "MHW"]>>;
-    threshold: z.ZodOptional<z.ZodEnum<["minor", "moderate", "major"]>>;
-    decade: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    station: string;
-    threshold?: "minor" | "moderate" | "major" | undefined;
-    format?: "json" | "xml" | "csv" | undefined;
-    scenario?: "all" | "high" | "low" | "intermediate-low" | "intermediate" | "intermediate-high" | "extreme" | undefined;
-    datum?: "MHHW" | "MHW" | "MSL" | "MLW" | "MLLW" | "STND" | "GT" | undefined;
-    decade?: string | undefined;
-}, {
-    station: string;
-    threshold?: "minor" | "moderate" | "major" | undefined;
-    format?: "json" | "xml" | "csv" | undefined;
-    scenario?: "all" | "high" | "low" | "intermediate-low" | "intermediate" | "intermediate-high" | "extreme" | undefined;
-    datum?: "MHHW" | "MHW" | "MSL" | "MLW" | "MLLW" | "STND" | "GT" | undefined;
-    decade?: string | undefined;
-}>;
-export declare const HighTideFloodingLikelihoodsSchema: z.ZodObject<{
-    station: z.ZodString;
-    format: z.ZodOptional<z.ZodEnum<["json", "xml", "csv"]>>;
-    datum: z.ZodOptional<z.ZodEnum<["STND", "MLLW", "MHHW", "GT", "MSL", "MLW", "MHW"]>>;
-    threshold: z.ZodOptional<z.ZodEnum<["minor", "moderate", "major"]>>;
-    date: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    station: string;
-    threshold?: "minor" | "moderate" | "major" | undefined;
-    date?: string | undefined;
-    format?: "json" | "xml" | "csv" | undefined;
-    datum?: "MHHW" | "MHW" | "MSL" | "MLW" | "MLLW" | "STND" | "GT" | undefined;
-}, {
-    station: string;
-    threshold?: "minor" | "moderate" | "major" | undefined;
-    date?: string | undefined;
-    format?: "json" | "xml" | "csv" | undefined;
-    datum?: "MHHW" | "MHW" | "MSL" | "MLW" | "MLLW" | "STND" | "GT" | undefined;
-}>;
-export declare const TopTenWaterLevelsSchema: z.ZodObject<{
-    station: z.ZodString;
-    format: z.ZodOptional<z.ZodEnum<["json", "xml", "csv"]>>;
-    datum: z.ZodOptional<z.ZodEnum<["STND", "MLLW", "MHHW", "GT", "MSL", "MLW", "MHW"]>>;
-    units: z.ZodOptional<z.ZodEnum<["english", "metric"]>>;
-    analysis_type: z.ZodOptional<z.ZodEnum<["highest", "lowest"]>>;
-}, "strip", z.ZodTypeAny, {
-    station: string;
-    format?: "json" | "xml" | "csv" | undefined;
-    units?: "english" | "metric" | undefined;
-    datum?: "MHHW" | "MHW" | "MSL" | "MLW" | "MLLW" | "STND" | "GT" | undefined;
-    analysis_type?: "highest" | "lowest" | undefined;
-}, {
-    station: string;
-    format?: "json" | "xml" | "csv" | undefined;
-    units?: "english" | "metric" | undefined;
-    datum?: "MHHW" | "MHW" | "MSL" | "MLW" | "MLLW" | "STND" | "GT" | undefined;
-    analysis_type?: "highest" | "lowest" | undefined;
-}>;

package/dist/schemas/dpapi.js

@@ -1,89 +0,0 @@
-import { z } from 'zod';
-import { StationSchema, UnitsSchema, FormatSchema } from './common.js';
-// DPAPI-specific parameter schemas
-export const AffiliationSchema = z.enum(['Global', 'US']).optional().describe('Station affiliation (Global or US)');
-export const ScenarioSchema = z.enum(['all', 'low', 'intermediate-low', 'intermediate', 'intermediate-high', 'high', 'extreme']).optional().describe('Sea level rise scenario');
-export const SeasonSchema = z.enum(['DJF', 'MAM', 'JJA', 'SON']).optional().describe('Season months (DJF-Winter, MAM-Spring, JJA-Summer, SON-Fall)');
-export const DpapiDatumSchema = z.enum(['STND', 'MLLW', 'MHHW', 'GT', 'MSL', 'MLW', 'MHW']).optional().describe('Datum reference for DPAPI');
-export const ThresholdSchema = z.enum(['minor', 'moderate', 'major']).optional().describe('Flood threshold level');
-export const DecadeSchema = z.string().optional().describe('Decade for projections (e.g., "2050")');
-export const YearSchema = z.string().optional().describe('Year for analysis (YYYY format)');
-export const YearRangeSchema = z.string().optional().describe('Year range (YYYY-YYYY format)');
-// Sea Level Trends schema
-export const SeaLevelTrendsSchema = z.object({
-    station: StationSchema,
-    affil: AffiliationSchema,
-    format: FormatSchema
-}).describe('Get sea level trends for a station');
-// Extreme Water Levels schema
-export const ExtremeWaterLevelsSchema = z.object({
-    station: StationSchema,
-    units: UnitsSchema,
-    format: FormatSchema
-}).describe('Get extreme water levels for a station');
-// High Tide Flooding Daily schema
-export const HighTideFloodingDailySchema = z.object({
-    station: StationSchema,
-    format: FormatSchema,
-    datum: DpapiDatumSchema,
-    threshold: ThresholdSchema,
-    begin_date: z.string().optional().describe('Start date (YYYYMMDD format)'),
-    end_date: z.string().optional().describe('End date (YYYYMMDD format)'),
-    year: YearSchema
-}).describe('Get high tide flooding daily count data');
-// High Tide Flooding Monthly schema
-export const HighTideFloodingMonthlySchema = z.object({
-    station: StationSchema,
-    format: FormatSchema,
-    datum: DpapiDatumSchema,
-    threshold: ThresholdSchema,
-    begin_date: z.string().optional().describe('Start date (YYYYMMDD format)'),
-    end_date: z.string().optional().describe('End date (YYYYMMDD format)'),
-    year: YearSchema
-}).describe('Get high tide flooding monthly count data');
-// High Tide Flooding Seasonal schema
-export const HighTideFloodingSeasonalSchema = z.object({
-    station: StationSchema,
-    format: FormatSchema,
-    datum: DpapiDatumSchema,
-    threshold: ThresholdSchema,
-    season_months: SeasonSchema,
-    begin_date: z.string().optional().describe('Start date (YYYYMMDD format)'),
-    end_date: z.string().optional().describe('End date (YYYYMMDD format)'),
-    year: YearSchema
-}).describe('Get high tide flooding seasonal count data');
-// High Tide Flooding Annual schema
-export const HighTideFloodingAnnualSchema = z.object({
-    station: StationSchema,
-    format: FormatSchema,
-    datum: DpapiDatumSchema,
-    threshold: ThresholdSchema,
-    begin_date: z.string().optional().describe('Start date (YYYYMMDD format)'),
-    end_date: z.string().optional().describe('End date (YYYYMMDD format)'),
-    year_range: YearRangeSchema
-}).describe('Get high tide flooding annual count data');
-// High Tide Flooding Projections schema
-export const HighTideFloodingProjectionsSchema = z.object({
-    station: StationSchema,
-    format: FormatSchema,
-    scenario: ScenarioSchema,
-    datum: DpapiDatumSchema,
-    threshold: ThresholdSchema,
-    decade: DecadeSchema
-}).describe('Get high tide flooding decadal projections');
-// High Tide Flooding Likelihoods schema
-export const HighTideFloodingLikelihoodsSchema = z.object({
-    station: StationSchema,
-    format: FormatSchema,
-    datum: DpapiDatumSchema,
-    threshold: ThresholdSchema,
-    date: z.string().optional().describe('Specific date (YYYYMMDD format)')
-}).describe('Get high tide flooding daily likelihoods');
-// Top Ten Water Levels schema
-export const TopTenWaterLevelsSchema = z.object({
-    station: StationSchema,
-    format: FormatSchema,
-    datum: DpapiDatumSchema,
-    units: UnitsSchema,
-    analysis_type: z.enum(['highest', 'lowest']).optional().describe('Analysis type (highest or lowest)')
-}).describe('Get top ten water levels for a station');

package/dist/server/config.d.ts

@@ -1,9 +0,0 @@
-import { FastMCP } from 'fastmcp';
-/**
- * Create and configure the FastMCP server
- */
-export declare function createServer(): FastMCP<undefined>;
-/**
- * Start the FastMCP server with configurable transport
- */
-export declare function startServer(server: FastMCP): void;

package/dist/server/config.js

@@ -1,40 +0,0 @@
-import { FastMCP } from 'fastmcp';
-/**
- * Create and configure the FastMCP server
- */
-export function createServer() {
-    // Create the MCP server with fixed configuration
-    const server = new FastMCP({
-        name: 'LocalTides',
-        version: '1.0.0'
-    });
-    return server;
-}
-/**
- * Start the FastMCP server with configurable transport
- */
-export function startServer(server) {
-    // Check command line arguments for transport type
-    const args = process.argv.slice(2);
-    const httpIndex = args.indexOf('--http');
-    const portIndex = args.indexOf('--port');
-    if (httpIndex !== -1) {
-        // HTTP transport mode
-        const port = portIndex !== -1 && args[portIndex + 1] ? parseInt(args[portIndex + 1]) : 3000;
-        console.log(`Starting NOAA MCP server on HTTP port ${port}`);
-        server.start({
-            transportType: 'httpStream',
-            httpStream: {
-                endpoint: '/sse',
-                port: port
-            }
-        });
-    }
-    else {
-        // Default stdio transport
-        console.log('Starting NOAA MCP server with stdio transport');
-        server.start({
-            transportType: 'stdio'
-        });
-    }
-}

package/dist/server/mcp-server.d.ts

@@ -1,12 +0,0 @@
-import { NoaaService } from '../services/noaa-service.js';
-export declare class McpServer {
-    private tools;
-    private noaaService;
-    constructor(noaaService: NoaaService);
-    private initializeTools;
-    getTools(): {
-        name: string;
-        description: string;
-    }[];
-    executeTool(toolName: string, params: any): Promise<any>;
-}

package/dist/server/mcp-server.js

@@ -1,103 +0,0 @@
-import { GetWaterLevelsSchema, GetTidePredictionsSchema, GetCurrentsSchema, GetCurrentPredictionsSchema, GetMeteorologicalDataSchema, GetStationsSchema, GetStationDetailsSchema } from '../interfaces/noaa.js';
-// Class for the MCP server
-export class McpServer {
-    tools;
-    noaaService;
-    constructor(noaaService) {
-        this.noaaService = noaaService;
-        this.tools = this.initializeTools();
-    }
-    // Initialize the tools
-    initializeTools() {
-        // Water Levels tool
-        const getWaterLevels = {
-            name: "get_water_levels",
-            description: "Get water level data for a station",
-            inputSchema: GetWaterLevelsSchema,
-            handler: async (params) => {
-                return this.noaaService.getWaterLevels(params);
-            }
-        };
-        // Tide Predictions tool
-        const getTidePredictions = {
-            name: "get_tide_predictions",
-            description: "Get tide prediction data",
-            inputSchema: GetTidePredictionsSchema,
-            handler: async (params) => {
-                return this.noaaService.getTidePredictions(params);
-            }
-        };
-        // Currents tool
-        const getCurrents = {
-            name: "get_currents",
-            description: "Get currents data for a station",
-            inputSchema: GetCurrentsSchema,
-            handler: async (params) => {
-                return this.noaaService.getCurrents(params);
-            }
-        };
-        // Current Predictions tool
-        const getCurrentPredictions = {
-            name: "get_current_predictions",
-            description: "Get current predictions",
-            inputSchema: GetCurrentPredictionsSchema,
-            handler: async (params) => {
-                return this.noaaService.getCurrentPredictions(params);
-            }
-        };
-        // Meteorological Data tool
-        const getMeteorologicalData = {
-            name: "get_meteorological_data",
-            description: "Get meteorological data",
-            inputSchema: GetMeteorologicalDataSchema,
-            handler: async (params) => {
-                return this.noaaService.getMeteorologicalData(params);
-            }
-        };
-        // Stations tool
-        const getStations = {
-            name: "get_stations",
-            description: "Get list of stations",
-            inputSchema: GetStationsSchema,
-            handler: async (params) => {
-                return this.noaaService.getStations(params);
-            }
-        };
-        // Station Details tool
-        const getStationDetails = {
-            name: "get_station_details",
-            description: "Get detailed information about a station",
-            inputSchema: GetStationDetailsSchema,
-            handler: async (params) => {
-                return this.noaaService.getStationDetails(params);
-            }
-        };
-        return [
-            getWaterLevels,
-            getTidePredictions,
-            getCurrents,
-            getCurrentPredictions,
-            getMeteorologicalData,
-            getStations,
-            getStationDetails
-        ];
-    }
-    // Method to get all tools
-    getTools() {
-        return this.tools.map(tool => ({
-            name: tool.name,
-            description: tool.description
-        }));
-    }
-    // Method to handle tool execution
-    async executeTool(toolName, params) {
-        const tool = this.tools.find(t => t.name === toolName);
-        if (!tool) {
-            throw new Error(`Tool '${toolName}' not found`);
-        }
-        // Validate the parameters against the schema
-        const validatedParams = tool.inputSchema.parse(params);
-        // Execute the tool handler
-        return tool.handler(validatedParams);
-    }
-}

package/dist/services/dpapi-service.d.ts

@@ -1,72 +0,0 @@
-/**
- * Service for interacting with NOAA Derived Product API (DPAPI)
- */
-export declare class DpapiService {
-    /**
-     * Build parameters for the API request
-     * @param params Parameters for the request
-     * @returns URL-encoded parameters string
-     */
-    private buildParams;
-    /**
-     * Make a request to the DPAPI
-     * @param endpoint Endpoint path
-     * @param params Parameters for the request
-     * @returns Response data
-     */
-    fetchDpapi(endpoint: string, params?: Record<string, any>): Promise<any>;
-    /**
-     * Get sea level trends for a station
-     * @param params Parameters including station ID and affiliation
-     * @returns Sea level trend data
-     */
-    getSeaLevelTrends(params: Record<string, any>): Promise<any>;
-    /**
-     * Get extreme water levels for a station
-     * @param params Parameters including station ID and units
-     * @returns Extreme water level data
-     */
-    getExtremeWaterLevels(params: Record<string, any>): Promise<any>;
-    /**
-     * Get high tide flooding daily count data
-     * @param params Parameters including station ID, date range, and thresholds
-     * @returns Daily flood count data
-     */
-    getHighTideFloodingDaily(params: Record<string, any>): Promise<any>;
-    /**
-     * Get high tide flooding monthly count data
-     * @param params Parameters including station ID, date range, and thresholds
-     * @returns Monthly flood count data
-     */
-    getHighTideFloodingMonthly(params: Record<string, any>): Promise<any>;
-    /**
-     * Get high tide flooding seasonal count data
-     * @param params Parameters including station ID, seasons, and thresholds
-     * @returns Seasonal flood count data
-     */
-    getHighTideFloodingSeasonal(params: Record<string, any>): Promise<any>;
-    /**
-     * Get high tide flooding annual count data
-     * @param params Parameters including station ID, year range, and thresholds
-     * @returns Annual flood count data
-     */
-    getHighTideFloodingAnnual(params: Record<string, any>): Promise<any>;
-    /**
-     * Get high tide flooding decadal projections
-     * @param params Parameters including station ID, scenario, and decade
-     * @returns Decadal projection data
-     */
-    getHighTideFloodingProjections(params: Record<string, any>): Promise<any>;
-    /**
-     * Get high tide flooding daily likelihoods
-     * @param params Parameters including station ID and date
-     * @returns Daily likelihood data
-     */
-    getHighTideFloodingLikelihoods(params: Record<string, any>): Promise<any>;
-    /**
-     * Get top ten water levels for a station
-     * @param params Parameters including station ID and analysis type
-     * @returns Top ten water level data
-     */
-    getTopTenWaterLevels(params: Record<string, any>): Promise<any>;
-}