@cyanheads/noaa-marine-mcp-server 0.1.1

package/dist/services/coops/coops-service.js

@@ -0,0 +1,217 @@
+/**
+ * @fileoverview CO-OPS Tides & Currents API service — station list cache and data fetching.
+ * @module services/coops/coops-service
+ */
+import { serviceUnavailable } from '@cyanheads/mcp-ts-core/errors';
+import { fetchWithTimeout, withRetry } from '@cyanheads/mcp-ts-core/utils';
+const DATA_URL = 'https://api.tidesandcurrents.noaa.gov/api/prod/datagetter';
+const MDAPI_URL = 'https://api.tidesandcurrents.noaa.gov/mdapi/prod/webapi/stations.json';
+const CACHE_TTL_MS = 6 * 60 * 60 * 1000; // 6 hours
+export class CoopsService {
+    applicationId;
+    stationCache = new Map();
+    // AppConfig and StorageService accepted for init-pattern consistency; not used at runtime
+    constructor(_config, _storage, serverConfig) {
+        this.applicationId = serverConfig.applicationId;
+    }
+    /** Fetch (or return cached) station list for the given type. */
+    async getStations(type, ctx) {
+        const entry = this.stationCache.get(type);
+        if (entry && Date.now() - entry.fetchedAt < CACHE_TTL_MS) {
+            return entry.stations;
+        }
+        const stations = await withRetry(async () => {
+            const url = `${MDAPI_URL}?type=${type}&application=${encodeURIComponent(this.applicationId)}`;
+            const response = await fetchWithTimeout(url, 15_000, ctx, {
+                signal: ctx.signal,
+            });
+            const text = await response.text();
+            this.detectHtmlError(text);
+            const parsed = JSON.parse(text);
+            return parsed.stations ?? [];
+        }, {
+            operation: `CoopsService.getStations(${type})`,
+            context: ctx,
+            baseDelayMs: 2000,
+            maxRetries: 2,
+            signal: ctx.signal,
+        });
+        this.stationCache.set(type, { stations, fetchedAt: Date.now() });
+        ctx.log.debug('CO-OPS station list cached', { type, count: stations.length });
+        return stations;
+    }
+    /**
+     * Pre-warm the most-used station lists. Called during server setup.
+     * Errors are caught and logged — pre-warm is best-effort.
+     */
+    async preWarm(ctx) {
+        await Promise.allSettled([
+            this.getStations('tidepredictions', ctx),
+            this.getStations('currentpredictions', ctx),
+        ]);
+    }
+    /** Fetch tide predictions for a station over a date range. */
+    async fetchTidePredictions(params, ctx) {
+        return await withRetry(async () => {
+            const url = this.buildDataUrl({
+                station: params.station,
+                product: 'predictions',
+                begin_date: params.begin_date,
+                end_date: params.end_date,
+                datum: params.datum,
+                time_zone: params.time_zone,
+                units: params.units,
+                interval: params.interval,
+                format: 'json',
+            });
+            const response = await fetchWithTimeout(url, 20_000, ctx, {
+                signal: ctx.signal,
+            });
+            const text = await response.text();
+            this.detectHtmlError(text);
+            const parsed = JSON.parse(text);
+            this.checkCoopsError(parsed);
+            const predictions = parsed.predictions ?? [];
+            // Station name isn't in this response; caller handles it
+            return { predictions, stationName: parsed.metadata?.name ?? params.station };
+        }, {
+            operation: 'CoopsService.fetchTidePredictions',
+            context: ctx,
+            baseDelayMs: 1000,
+            maxRetries: 3,
+            signal: ctx.signal,
+        });
+    }
+    /** Fetch observed water levels for a station. */
+    async fetchWaterLevel(params, ctx) {
+        return await withRetry(async () => {
+            const url = this.buildDataUrl({
+                station: params.station,
+                product: 'water_level',
+                begin_date: params.begin_date,
+                end_date: params.end_date,
+                datum: params.datum,
+                time_zone: params.time_zone,
+                units: params.units,
+                format: 'json',
+            });
+            const response = await fetchWithTimeout(url, 20_000, ctx, {
+                signal: ctx.signal,
+            });
+            const text = await response.text();
+            this.detectHtmlError(text);
+            const parsed = JSON.parse(text);
+            this.checkCoopsError(parsed);
+            return { data: parsed.data ?? [], stationName: parsed.metadata?.name ?? params.station };
+        }, {
+            operation: 'CoopsService.fetchWaterLevel',
+            context: ctx,
+            baseDelayMs: 1000,
+            maxRetries: 3,
+            signal: ctx.signal,
+        });
+    }
+    /** Fetch water level predictions for the same date range as a water_level request (companion fetch). */
+    async fetchWaterLevelPredictions(params, ctx) {
+        return await withRetry(async () => {
+            const url = this.buildDataUrl({
+                station: params.station,
+                product: 'predictions',
+                begin_date: params.begin_date,
+                end_date: params.end_date,
+                datum: params.datum,
+                time_zone: params.time_zone,
+                units: params.units,
+                interval: '6',
+                format: 'json',
+            });
+            const response = await fetchWithTimeout(url, 20_000, ctx, {
+                signal: ctx.signal,
+            });
+            const text = await response.text();
+            this.detectHtmlError(text);
+            const parsed = JSON.parse(text);
+            // Predictions can fail for some stations — caller degrades gracefully
+            if (parsed.error)
+                return [];
+            return (parsed.predictions ?? []);
+        }, {
+            operation: 'CoopsService.fetchWaterLevelPredictions',
+            context: ctx,
+            baseDelayMs: 1000,
+            maxRetries: 2,
+            signal: ctx.signal,
+        });
+    }
+    /** Fetch current predictions for a station. */
+    async fetchCurrentPredictions(params, ctx) {
+        return await withRetry(async () => {
+            // CO-OPS currents_predictions API accepts "6" not "6min"; translate the user-facing enum.
+            const apiInterval = params.interval === '6min' ? '6' : params.interval;
+            const url = this.buildDataUrl({
+                station: params.station,
+                product: 'currents_predictions',
+                begin_date: params.begin_date,
+                end_date: params.end_date,
+                time_zone: params.time_zone,
+                units: params.units,
+                interval: apiInterval,
+                format: 'json',
+            });
+            const response = await fetchWithTimeout(url, 20_000, ctx, {
+                signal: ctx.signal,
+            });
+            const text = await response.text();
+            this.detectHtmlError(text);
+            const parsed = JSON.parse(text);
+            this.checkCoopsError(parsed);
+            // CO-OPS MAX_SLACK returns cp as a string (e.g. "Currents are weak and variable")
+            // instead of an array when there are no significant flood/ebb/slack events.
+            const rawCp = parsed.current_predictions?.cp;
+            const cp = Array.isArray(rawCp) ? rawCp : [];
+            const stationName = parsed.metadata?.name ?? params.station;
+            if (params.interval === 'MAX_SLACK') {
+                return { events: cp, stationName };
+            }
+            return { predictions: cp, stationName };
+        }, {
+            operation: 'CoopsService.fetchCurrentPredictions',
+            context: ctx,
+            baseDelayMs: 1000,
+            maxRetries: 3,
+            signal: ctx.signal,
+        });
+    }
+    buildDataUrl(params) {
+        const p = new URLSearchParams({
+            ...params,
+            application: this.applicationId,
+        });
+        return `${DATA_URL}?${p.toString()}`;
+    }
+    detectHtmlError(text) {
+        if (/^\s*<(!DOCTYPE\s+html|html[\s>])/i.test(text)) {
+            throw serviceUnavailable('CO-OPS API returned HTML instead of JSON — likely rate-limited or temporarily unavailable.');
+        }
+    }
+    checkCoopsError(parsed) {
+        const p = parsed;
+        if (p && typeof p === 'object' && 'error' in p && p.error) {
+            const errObj = p.error;
+            const message = errObj.message ?? 'Unknown CO-OPS error';
+            throw serviceUnavailable(`CO-OPS error: ${message}`);
+        }
+    }
+}
+// --- Init/accessor pattern ---
+let _service;
+export function initCoopsService(config, storage, serverConfig) {
+    _service = new CoopsService(config, storage, serverConfig);
+}
+export function getCoopsService() {
+    if (!_service) {
+        throw new Error('CoopsService not initialized — call initCoopsService() in setup()');
+    }
+    return _service;
+}
+//# sourceMappingURL=coops-service.js.map

package/dist/services/coops/coops-service.js.map

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

package/dist/services/coops/types.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @fileoverview Type definitions for the CO-OPS Tides & Currents service.
+ * @module services/coops/types
+ */
+/** A station from the CO-OPS metadata API station list. */
+export interface CoopsStation {
+    id: string;
+    lat: number;
+    lng: number;
+    name: string;
+    state?: string;
+    /** Station type code — R=reference, T=subordinate, S=secondary, ACT-prefix for currents */
+    type?: string;
+}
+/** A tide/water-level data observation returned from the CO-OPS data endpoint. */
+export interface CoopsDataRow {
+    /** Quality flag: p=preliminary, v=verified */
+    q?: string;
+    /** Standard deviation / sigma (water level only) */
+    s?: string;
+    /** ISO datetime string */
+    t: string;
+    /** Numeric value (water level in feet or metric equivalent) */
+    v: string;
+}
+/** A tidal prediction row. */
+export interface CoopsPredictionRow {
+    t: string;
+    /** Tide type: H=high, L=low (hilo interval only) */
+    type?: string;
+    v: string;
+}
+/** A current prediction row (MAX_SLACK interval). */
+export interface CoopsCurrentRow {
+    /** True bearing direction in degrees */
+    meanEbbDir?: string;
+    meanFloodDir?: string;
+    /** Event datetime */
+    Time: string;
+    /** Event type: flood, ebb, slack */
+    Type: string;
+    /** Speed in knots or m/s */
+    Velocity_Major?: string;
+}
+/** A current prediction row (6-min interval). */
+export interface CoopsCurrent6MinRow {
+    /** Direction */
+    Direction?: string;
+    Time: string;
+    /** Speed */
+    Velocity_Major?: string;
+}
+/** CO-OPS data API error envelope shape. */
+export interface CoopsErrorResponse {
+    error: {
+        message: string;
+    };
+}
+/** CO-OPS mdapi station list response. */
+export interface CoopsStationListResponse {
+    count?: number;
+    stations: CoopsStation[];
+}
+/** Supported CO-OPS station list types for the metadata endpoint. */
+export type CoopsStationType = 'tidepredictions' | 'currentpredictions' | 'waterlevels';
+//# sourceMappingURL=types.d.ts.map

package/dist/services/coops/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/coops/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,2DAA2D;AAC3D,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2FAA2F;IAC3F,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,kFAAkF;AAClF,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,oDAAoD;IACpD,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,+DAA+D;IAC/D,CAAC,EAAE,MAAM,CAAC;CACX;AAED,8BAA8B;AAC9B,MAAM,WAAW,kBAAkB;IACjC,CAAC,EAAE,MAAM,CAAC;IACV,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,EAAE,MAAM,CAAC;CACX;AAED,qDAAqD;AACrD,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,iDAAiD;AACjD,MAAM,WAAW,mBAAmB;IAClC,gBAAgB;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY;IACZ,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,4CAA4C;AAC5C,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5B;AAED,0CAA0C;AAC1C,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,qEAAqE;AACrE,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,GAAG,oBAAoB,GAAG,aAAa,CAAC"}

package/dist/services/coops/types.js

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Type definitions for the CO-OPS Tides & Currents service.
+ * @module services/coops/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/services/coops/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/coops/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

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

@@ -0,0 +1,28 @@
+/**
+ * @fileoverview NDBC (National Data Buoy Center) service — active stations XML cache and realtime text parser.
+ * @module services/ndbc/ndbc-service
+ */
+import type { Context } from '@cyanheads/mcp-ts-core';
+import type { NdbcObservation, NdbcStation } from './types.js';
+export declare class NdbcService {
+    private stationCache;
+    /** Fetch (or return cached) NDBC active stations. */
+    getActiveStations(ctx: Context): Promise<NdbcStation[]>;
+    /** Pre-warm the active station cache. Called during server setup. */
+    preWarm(ctx: Context): Promise<void>;
+    /** Fetch the most recent observation for a buoy from the realtime2 text feed. */
+    fetchObservation(stationId: string, ctx: Context): Promise<NdbcObservation>;
+    /** Parse NDBC active stations XML into NdbcStation array. */
+    private parseActiveStationsXml;
+    /**
+     * Parse NDBC fixed-width realtime2 text file into a NdbcObservation.
+     * Line 1: header (# + column names)
+     * Line 2: units row (ignored)
+     * Lines 3+: data rows most recent first
+     * MM = missing sensor value → null
+     */
+    parseRealtimeText(text: string, stationId: string): NdbcObservation;
+}
+export declare function initNdbcService(): void;
+export declare function getNdbcService(): NdbcService;
+//# sourceMappingURL=ndbc-service.d.ts.map

package/dist/services/ndbc/ndbc-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ndbc-service.d.ts","sourceRoot":"","sources":["../../../src/services/ndbc/ndbc-service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAGtD,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAY/D,qBAAa,WAAW;IACtB,OAAO,CAAC,YAAY,CAA6B;IAEjD,qDAAqD;IAC/C,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAiC7D,qEAAqE;IAC/D,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1C,iFAAiF;IAC3E,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;IAyBjF,6DAA6D;IAC7D,OAAO,CAAC,sBAAsB;IA4C9B;;;;;;OAMG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe;CA+GpE;AAMD,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAED,wBAAgB,cAAc,IAAI,WAAW,CAK5C"}

package/dist/services/ndbc/ndbc-service.js

@@ -0,0 +1,213 @@
+/**
+ * @fileoverview NDBC (National Data Buoy Center) service — active stations XML cache and realtime text parser.
+ * @module services/ndbc/ndbc-service
+ */
+import { notFound, serviceUnavailable } from '@cyanheads/mcp-ts-core/errors';
+import { fetchWithTimeout, withRetry } from '@cyanheads/mcp-ts-core/utils';
+const ACTIVE_STATIONS_URL = 'https://www.ndbc.noaa.gov/activestations.xml';
+const REALTIME_URL = (id) => `https://www.ndbc.noaa.gov/data/realtime2/${id.toUpperCase()}.txt`;
+const CACHE_TTL_MS = 6 * 60 * 60 * 1000; // 6 hours
+export class NdbcService {
+    stationCache = null;
+    /** Fetch (or return cached) NDBC active stations. */
+    async getActiveStations(ctx) {
+        if (this.stationCache && Date.now() - this.stationCache.fetchedAt < CACHE_TTL_MS) {
+            return this.stationCache.stations;
+        }
+        const stations = await withRetry(async () => {
+            const response = await fetchWithTimeout(ACTIVE_STATIONS_URL, 20_000, ctx, { signal: ctx.signal });
+            const text = await response.text();
+            if (/^\s*<(!DOCTYPE\s+html|html[\s>])/i.test(text)) {
+                throw serviceUnavailable('NDBC active stations returned HTML — service may be down.');
+            }
+            return this.parseActiveStationsXml(text);
+        }, {
+            operation: 'NdbcService.getActiveStations',
+            context: ctx,
+            baseDelayMs: 2000,
+            maxRetries: 2,
+            signal: ctx.signal,
+        });
+        this.stationCache = { stations, fetchedAt: Date.now() };
+        ctx.log.debug('NDBC active stations cached', { count: stations.length });
+        return stations;
+    }
+    /** Pre-warm the active station cache. Called during server setup. */
+    async preWarm(ctx) {
+        await this.getActiveStations(ctx);
+    }
+    /** Fetch the most recent observation for a buoy from the realtime2 text feed. */
+    async fetchObservation(stationId, ctx) {
+        return await withRetry(async () => {
+            const url = REALTIME_URL(stationId);
+            const response = await fetchWithTimeout(url, 10_000, ctx, {
+                signal: ctx.signal,
+            });
+            const text = await response.text();
+            if (/^\s*<(!DOCTYPE\s+html|html[\s>])/i.test(text)) {
+                throw serviceUnavailable('NDBC realtime endpoint returned HTML — likely rate-limited.');
+            }
+            return this.parseRealtimeText(text, stationId);
+        }, {
+            operation: `NdbcService.fetchObservation(${stationId})`,
+            context: ctx,
+            baseDelayMs: 1000,
+            maxRetries: 2,
+            signal: ctx.signal,
+        });
+    }
+    /** Parse NDBC active stations XML into NdbcStation array. */
+    parseActiveStationsXml(xml) {
+        const stations = [];
+        // Match each <Station ...> element
+        const stationRegex = /<Station\s([^>]*?)(?:\/?>)/gi;
+        for (let matchResult = stationRegex.exec(xml); matchResult !== null; matchResult = stationRegex.exec(xml)) {
+            const attrs = matchResult[1] ?? '';
+            const get = (name) => {
+                const m = new RegExp(`${name}="([^"]*)"`, 'i').exec(attrs);
+                return m ? m[1] : undefined;
+            };
+            const id = get('ID') ?? get('id');
+            const lat = get('lat');
+            const lon = get('lon');
+            const name = get('name');
+            if (!id || lat === undefined || lon === undefined)
+                continue;
+            const latNum = Number.parseFloat(lat);
+            const lonNum = Number.parseFloat(lon);
+            if (Number.isNaN(latNum) || Number.isNaN(lonNum))
+                continue;
+            const stationType = get('type');
+            const stationOwner = get('owner');
+            stations.push({
+                id: id.toUpperCase(),
+                name: name ?? id,
+                lat: latNum,
+                lon: lonNum,
+                ...(stationType !== undefined && { type: stationType }),
+                ...(stationOwner !== undefined && { owner: stationOwner }),
+                hasMet: get('met') === 'y' || get('met') === '1',
+                hasCurrents: get('currents') === 'y' || get('currents') === '1',
+            });
+        }
+        return stations;
+    }
+    /**
+     * Parse NDBC fixed-width realtime2 text file into a NdbcObservation.
+     * Line 1: header (# + column names)
+     * Line 2: units row (ignored)
+     * Lines 3+: data rows most recent first
+     * MM = missing sensor value → null
+     */
+    parseRealtimeText(text, stationId) {
+        const lines = text
+            .split('\n')
+            .map((l) => l.trim())
+            .filter(Boolean);
+        // Find the header line
+        const headerLine = lines.find((l) => l.startsWith('#'));
+        if (!headerLine) {
+            throw serviceUnavailable(`NDBC file for ${stationId} has no header row.`);
+        }
+        const columns = headerLine
+            .replace(/^#+\s*/, '')
+            .split(/\s+/)
+            .map((c) => c.toUpperCase());
+        // Find first data row (not starting with #)
+        const dataLine = lines.find((l) => !l.startsWith('#'));
+        if (!dataLine) {
+            throw notFound(`NDBC buoy ${stationId} has no data rows — buoy may be offline.`, {
+                stationId,
+                reason: 'no_sensor_data',
+            });
+        }
+        const values = dataLine.split(/\s+/);
+        const get = (col) => {
+            const idx = columns.indexOf(col);
+            if (idx < 0 || idx >= values.length)
+                return null;
+            const v = values[idx];
+            return v === 'MM' || v === undefined ? null : v;
+        };
+        const toNum = (col) => {
+            const v = get(col);
+            if (v === null)
+                return null;
+            const n = Number.parseFloat(v);
+            return Number.isNaN(n) ? null : n;
+        };
+        // Build ISO timestamp from YY MM DD hh mm columns.
+        // NOTE: NDBC header uses lowercase 'mm' for minutes; after uppercasing, the
+        // columns array has 'MM' at index 1 (month) AND at index 4 (minute).
+        // indexOf returns the first match (month), so we use lastIndexOf for minutes.
+        const getMinute = () => {
+            const idx = columns.lastIndexOf('MM');
+            if (idx < 0 || idx >= values.length)
+                return null;
+            const v = values[idx];
+            return v === 'MM' || v === undefined ? null : v;
+        };
+        const yy = get('YY') ?? get('#YY');
+        const mo = get('MM');
+        const dd = get('DD');
+        const hh = get('HH');
+        const mn = getMinute();
+        // NDBC emits 4-digit years in the YY column despite the column name suggesting otherwise.
+        // Treat values ≥ 1000 as already-full years; add 2000 only for genuine 2-digit values.
+        const year = yy
+            ? (() => {
+                const n = Number.parseInt(yy, 10);
+                return n >= 1000 ? n : n < 50 ? 2000 + n : 1900 + n;
+            })()
+            : new Date().getFullYear();
+        const observedAt = yy && mo && dd && hh && mn
+            ? `${year}-${mo.padStart(2, '0')}-${dd.padStart(2, '0')}T${hh.padStart(2, '0')}:${mn.padStart(2, '0')}:00Z`
+            : new Date().toISOString();
+        // Check if all sensor fields are MM
+        const sensorCols = [
+            'WDIR',
+            'WSPD',
+            'GST',
+            'WVHT',
+            'DPD',
+            'APD',
+            'MWD',
+            'PRES',
+            'ATMP',
+            'WTMP',
+            'DEWP',
+        ];
+        const allMissing = sensorCols.every((col) => get(col) === null);
+        if (allMissing) {
+            throw notFound(`NDBC buoy ${stationId} has all sensor fields missing — buoy offline or sensor failure.`, { stationId, reason: 'no_sensor_data' });
+        }
+        return {
+            observedAt,
+            windDirectionDeg: toNum('WDIR'),
+            windSpeedMs: toNum('WSPD'),
+            gustSpeedMs: toNum('GST'),
+            waveHeightM: toNum('WVHT'),
+            dominantPeriodSec: toNum('DPD'),
+            averagePeriodSec: toNum('APD'),
+            meanWaveDirectionDeg: toNum('MWD'),
+            pressureHpa: toNum('PRES'),
+            airTempC: toNum('ATMP'),
+            waterTempC: toNum('WTMP'),
+            dewPointC: toNum('DEWP'),
+            visibilityNmi: toNum('VIS'),
+            tideFt: toNum('TIDE'),
+        };
+    }
+}
+// --- Init/accessor pattern ---
+let _service;
+export function initNdbcService() {
+    _service = new NdbcService();
+}
+export function getNdbcService() {
+    if (!_service) {
+        throw new Error('NdbcService not initialized — call initNdbcService() in setup()');
+    }
+    return _service;
+}
+//# sourceMappingURL=ndbc-service.js.map

package/dist/services/ndbc/ndbc-service.js.map

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

package/dist/services/ndbc/types.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @fileoverview Type definitions for the NDBC (National Data Buoy Center) service.
+ * @module services/ndbc/types
+ */
+/** A station from the NDBC active stations XML. */
+export interface NdbcStation {
+    /** Whether station reports current observations */
+    hasCurrents: boolean;
+    /** Whether station reports meteorological observations */
+    hasMet: boolean;
+    id: string;
+    lat: number;
+    lon: number;
+    name: string;
+    /** Owner/operator */
+    owner?: string;
+    /** NDBC station type (buoy, fixed, etc.) */
+    type?: string;
+}
+/**
+ * Parsed NDBC realtime observation.
+ * All sensor fields are null when the buoy did not report a value (MM in source).
+ */
+export interface NdbcObservation {
+    /** Air temperature °C — null if not reported */
+    airTempC: number | null;
+    /** Average period seconds — null if not reported */
+    averagePeriodSec: number | null;
+    /** Dew point temperature °C — null if not reported */
+    dewPointC: number | null;
+    /** Dominant period seconds — null if not reported */
+    dominantPeriodSec: number | null;
+    /** Wind gust m/s — null if not reported */
+    gustSpeedMs: number | null;
+    /** Mean wave direction degrees true — null if not reported */
+    meanWaveDirectionDeg: number | null;
+    /** ISO timestamp of the observation */
+    observedAt: string;
+    /** Atmospheric pressure hPa — null if not reported */
+    pressureHpa: number | null;
+    /**
+     * Tide in feet — null if not reported.
+     * NOTE: NDBC TIDE is always in feet regardless of other unit preferences.
+     */
+    tideFt: number | null;
+    /**
+     * Visibility in nautical miles — null if not reported.
+     * NOTE: NDBC VIS is always in nautical miles regardless of other unit preferences.
+     */
+    visibilityNmi: number | null;
+    /** Sea surface temperature °C — null if not reported */
+    waterTempC: number | null;
+    /** Significant wave height m — null if not reported */
+    waveHeightM: number | null;
+    /** Wind direction degrees true — null if not reported */
+    windDirectionDeg: number | null;
+    /** Wind speed m/s — null if not reported */
+    windSpeedMs: number | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/ndbc/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/ndbc/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mDAAmD;AACnD,MAAM,WAAW,WAAW;IAC1B,mDAAmD;IACnD,WAAW,EAAE,OAAO,CAAC;IACrB,0DAA0D;IAC1D,MAAM,EAAE,OAAO,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,oDAAoD;IACpD,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,sDAAsD;IACtD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,qDAAqD;IACrD,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,2CAA2C;IAC3C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,8DAA8D;IAC9D,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B;;;OAGG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;;;OAGG;IACH,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,wDAAwD;IACxD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,uDAAuD;IACvD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,yDAAyD;IACzD,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,4CAA4C;IAC5C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B"}

package/dist/services/ndbc/types.js

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Type definitions for the NDBC (National Data Buoy Center) service.
+ * @module services/ndbc/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/services/ndbc/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/ndbc/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}