buoydata 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Graham Eger
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,289 @@
+# buoydata
+
+Modern TypeScript SDK for NOAA NDBC realtime buoy data. The library provides a fetch layer, parsing helpers, and typed models for standard meteorological measurements while still supporting arbitrary realtime2 data types.
+
+## Installation
+
+```bash
+pnpm add buoydata
+```
+
+## Quickstart
+
+```ts
+import {
+  fetchRealtimeData,
+  parseRealtimeData,
+  parseRealtimeTable,
+} from 'buoydata';
+
+const raw = await fetchRealtimeData({ buoyId: '46026', type: 'txt' });
+const data = parseRealtimeData('46026', raw);
+
+console.log(data.measurements[0].wind.averageSpeed);
+
+const table = parseRealtimeTable(raw);
+console.log(table.headers);
+```
+
+## Browser usage
+
+```ts
+import { fetchRealtimeData, parseRealtimeTable } from 'buoydata';
+
+const raw = await fetchRealtimeData({ buoyId: '46026', type: 'spec' });
+const table = parseRealtimeTable(raw);
+```
+
+## Node usage
+
+Node 18+ includes `fetch` globally. If you need a custom client, pass it explicitly:
+
+```ts
+import { fetchRealtimeData } from 'buoydata';
+import fetch from 'node-fetch';
+
+const raw = await fetchRealtimeData({ buoyId: '46026', fetch });
+```
+
+## API
+
+### fetchRealtimeData
+
+Fetches realtime2 files from NDBC.
+
+```ts
+fetchRealtimeData({
+  buoyId: string,
+  type?: string,
+  fetch?: typeof fetch,
+  requestInit?: RequestInit,
+  baseUrl?: string,
+}): Promise<string>
+```
+
+### buildRealtimeUrl
+
+Builds the realtime2 URL for a buoy and file type.
+
+```ts
+buildRealtimeUrl(buoyId: string, type?: string, baseUrl?: string): string
+```
+
+### parseRealtimeData
+
+Parses a realtime2 text file into typed `Measurement` objects. Standard fields are mapped into structured measurement fields. Unknown columns are ignored unless `includeUnknownFields` is enabled.
+
+```ts
+parseRealtimeData(
+  buoyId: string,
+  rawText: string,
+  options?: {
+    coerceNumbers?: boolean;
+    missingValue?: number | null;
+    missingTokens?: string[];
+    commentPrefix?: string;
+    includeUnknownFields?: boolean;
+  },
+): BuoyData
+```
+
+### parseRealtimeTable
+
+Parses a realtime2 text file into a generic table representation with headers, units, and raw rows.
+
+```ts
+parseRealtimeTable(
+  rawText: string,
+  options?: {
+    coerceNumbers?: boolean;
+    missingValue?: number | null;
+    missingTokens?: string[];
+    commentPrefix?: string;
+  },
+): RealtimeTable
+```
+
+### parseRow
+
+Parses a single row into values using whitespace splitting and missing-data handling.
+
+```ts
+parseRow(
+  rawRow: string,
+  options?: {
+    coerceNumbers?: boolean;
+    missingValue?: number | null;
+    missingTokens?: string[];
+  },
+): ParsedValue[]
+```
+
+### objectifyTable
+
+Converts a `RealtimeTable` into an array of records keyed by header values.
+
+```ts
+objectifyTable(table: RealtimeTable): RealtimeRecord[]
+```
+
+### getMeasurementDate
+
+Creates a UTC `Date` instance from a `Measurement` (using year, month, day, hour, minute).
+
+```ts
+getMeasurementDate(measurement: Measurement): Date
+```
+
+### URL utilities
+
+```ts
+formatQueryParams(params: QueryParams): string
+buildURL(base: string, path?: string, params?: QueryParams): string
+```
+
+## Data models
+
+### Measurement
+
+Structured representation of standard meteorological data:
+
+- `year`, `month`, `day`, `hour`, `minute`
+- `airTemperature`, `dewpointTemperature`
+- `pressureTendancy`, `seaLevelPressure`, `stationVisibility`
+- `wind` (`direction`, `averageSpeed`, `peakGustSpeed`)
+- `water` (`averagePeriod`, `dominantDirection`, `dominantPeriod`, `significantHeight`, `surfaceTemperature`, `tide`)
+
+### BuoyData
+
+```ts
+{
+  id: string;
+  measurements: Measurement[];
+}
+```
+
+### RealtimeTable
+
+```ts
+{
+  headers: string[];
+  units: string[];
+  rows: (string | number | null)[][];
+  rawRows: string[];
+}
+```
+
+### RealtimeRecord
+
+```ts
+Record<string, string | number | null>
+```
+
+## Parsing behavior
+
+- Comment lines start with `# ` and are ignored for table parsing.
+- The units row (typically `#yr mo dy ...`) is parsed into `units`.
+- Missing data tokens default to `MM` and numeric 9s (e.g. `99`, `999`, `9999`, `99.0`).
+- `parseRealtimeTable` uses `null` as the default missing value; `parseRealtimeData` uses `NaN` by default to align with numeric measurement fields.
+- Numbers are coerced automatically unless `coerceNumbers` is set to `false`.
+
+## Code layout
+
+```
+src/
+  index.ts                Public exports
+  models/
+    measurement.ts        Typed data models for standard met data
+    table.ts              Generic table and record types
+  realtime/
+    fetch.ts              Fetch layer and realtime URL builder
+    parser.ts             Table parsing, objectification, and measurement mapping
+  utils/
+    date.ts               Measurement date helper
+    url.ts                URL and query param utilities
+
+tests/
+  fixtures/               Downloaded realtime2 sample files
+  parser.test.ts          Parsing tests across formats
+  fetch.test.ts           Fetch layer tests (mocked)
+  url.test.ts             URL/query param tests
+  date.test.ts            Measurement date utility test
+```
+
+## Architecture diagrams
+
+### High-level flow
+
+```
+                +----------------------+
+                |   NDBC realtime2     |
+                |  (https endpoint)    |
+                +----------+-----------+
+                           |
+                           | fetchRealtimeData
+                           v
+                    +------+------+
+                    | rawText     |
+                    +------+------+
+                           |
+           +---------------+----------------+
+           |                                |
+           v                                v
+  parseRealtimeTable                 parseRealtimeData
+           |                                |
+           v                                v
+   RealtimeTable                     BuoyData (typed)
+           |
+           v
+    objectifyTable
+           |
+           v
+    RealtimeRecord[]
+```
+
+### Parsing pipeline (parseRealtimeTable)
+
+```
+rawText
+  |
+  v
+normalizeLines (trim, drop blanks)
+  |
+  v
+filter comment lines ("# ")
+  |
+  v
+parse header row  --> headers[]
+  |
+  v
+parse units row   --> units[]
+  |
+  v
+parse data rows   --> rows[][]
+```
+
+### Measurement mapping (parseRealtimeData)
+
+```
+RealtimeTable
+  |
+  v
+objectifyTable -> RealtimeRecord[]
+  |
+  v
+toMeasurement
+  |
+  v
+Measurement[] (BuoyData.measurements)
+```
+
+## Testing
+
+```bash
+pnpm test
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function d(r={}){const e=new URLSearchParams;for(const[n,a]of Object.entries(r))if(a!=null){if(Array.isArray(a)){a.forEach(i=>{e.append(n,String(i))});continue}e.append(n,String(a))}const t=e.toString();return t?`?${t}`:""}function f(r,e="",t={}){const n=r.endsWith("/")?r:`${r}/`,a=new URL(e,n),i=d(t);return a.search=i,a.toString()}const h="https://www.ndbc.noaa.gov/data/realtime2/";function g(r,e="txt",t=h){const n=`${r}.${e}`;return f(t,n)}async function P(r){const{buoyId:e,type:t="txt",fetch:n=fetch,requestInit:a,baseUrl:i=h}=r;if(!n)throw new Error("No fetch implementation available.");const s=g(e,t,i),u=await n(s,a);if(!u.ok)throw new Error(`Failed to fetch ${s}: ${u.status}`);return u.text()}const S=["MM"];function R(r,e){return!!(e.includes(r)||/^9{2,}(\.0+|\.9+)?$/.test(r))}function M(r,e){if(R(r,e.missingTokens))return e.missingValue;if(e.coerceNumbers){const t=Number(r);if(!Number.isNaN(t))return t}return r}function N(r,e={}){const t={coerceNumbers:e.coerceNumbers??!0,missingValue:e.missingValue??null,missingTokens:e.missingTokens??S};return r.trim().split(/\s+/).filter(Boolean).map(n=>M(n,t))}function L(r,e){return r.startsWith(`${e} `)}function k(r){return r.split(/\r?\n/).map(e=>e.trim()).filter(e=>e.length>0)}function p(r,e={}){const t=e.commentPrefix??"#",n=k(r).filter(o=>!L(o,t));if(n.length===0)return{headers:[],units:[],rows:[],rawRows:[]};const a=n[0]??"",i={coerceNumbers:!1,missingValue:null,missingTokens:[]},s=N(a,i).map(String);let u=[],c=1;const m=n[1];m&&m.startsWith(t)&&(u=N(m,i).map(o=>{const l=String(o);return l.startsWith(t)?l.slice(t.length):l}),c=2);const y={coerceNumbers:e.coerceNumbers,missingValue:e.missingValue,missingTokens:e.missingTokens},b=n.slice(c),D=b.map(o=>N(o,y));return{headers:s,units:u,rows:D,rawRows:b}}function w(r){const{headers:e,rows:t}=r;return t.map(n=>{const a={};return e.forEach((i,s)=>{a[i]=n[s]??null}),a})}function T(){return{airTemperature:Number.NaN,day:Number.NaN,dewpointTemperature:Number.NaN,hour:Number.NaN,minute:Number.NaN,month:Number.NaN,pressureTendancy:Number.NaN,seaLevelPressure:Number.NaN,stationVisibility:Number.NaN,water:{averagePeriod:Number.NaN,dominantDirection:Number.NaN,dominantPeriod:Number.NaN,significantHeight:Number.NaN,surfaceTemperature:Number.NaN,tide:Number.NaN},wind:{averageSpeed:Number.NaN,direction:Number.NaN,peakGustSpeed:Number.NaN},year:Number.NaN}}const E={"#YY":(r,e)=>{r.year=Number(e)},YY:(r,e)=>{r.year=Number(e)},MM:(r,e)=>{r.month=Number(e)},DD:(r,e)=>{r.day=Number(e)},hh:(r,e)=>{r.hour=Number(e)},mm:(r,e)=>{r.minute=Number(e)},APD:(r,e)=>{r.water.averagePeriod=Number(e)},ATMP:(r,e)=>{r.airTemperature=Number(e)},DEWP:(r,e)=>{r.dewpointTemperature=Number(e)},DPD:(r,e)=>{r.water.dominantPeriod=Number(e)},GST:(r,e)=>{r.wind.peakGustSpeed=Number(e)},MWD:(r,e)=>{r.water.dominantDirection=Number(e)},PRES:(r,e)=>{r.seaLevelPressure=Number(e)},PTDY:(r,e)=>{r.pressureTendancy=Number(e)},TIDE:(r,e)=>{r.water.tide=Number(e)},VIS:(r,e)=>{r.stationVisibility=Number(e)},WDIR:(r,e)=>{r.wind.direction=Number(e)},WSPD:(r,e)=>{r.wind.averageSpeed=Number(e)},WTMP:(r,e)=>{r.water.surfaceTemperature=Number(e)},WVHT:(r,e)=>{r.water.significantHeight=Number(e)}};function U(r){const e=T();return Object.entries(r).forEach(([t,n])=>{const a=E[t];a&&a(e,n)}),e}function V(r,e,t={}){const n=p(e,{...t,missingValue:t.missingValue??Number.NaN}),a=w(n),i=a.map(s=>U(s));if(t.includeUnknownFields){const s=i.map((u,c)=>{const m=a[c];return{...u,...m}});return{id:r,measurements:s}}return{id:r,measurements:i}}function v(r){const{year:e,month:t,day:n,hour:a,minute:i}=r;return new Date(Date.UTC(e,t-1,n,a,i))}exports.buildRealtimeUrl=g;exports.buildURL=f;exports.createMeasurement=T;exports.fetchRealtimeData=P;exports.formatQueryParams=d;exports.getMeasurementDate=v;exports.objectifyTable=w;exports.parseRealtimeData=V;exports.parseRealtimeTable=p;exports.parseRow=N;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../src/utils/url.ts","../src/realtime/fetch.ts","../src/realtime/parser.ts","../src/utils/date.ts"],"sourcesContent":["export type QueryParamValue =\n  | string\n  | number\n  | boolean\n  | null\n  | undefined\n  | Array<string | number | boolean>;\n\nexport type QueryParams = Record<string, QueryParamValue>;\n\nexport function formatQueryParams(params: QueryParams = {}): string {\n  const searchParams = new URLSearchParams();\n\n  for (const [key, value] of Object.entries(params)) {\n    if (value === null || value === undefined) {\n      continue;\n    }\n\n    if (Array.isArray(value)) {\n      value.forEach(item => {\n        searchParams.append(key, String(item));\n      });\n      continue;\n    }\n\n    searchParams.append(key, String(value));\n  }\n\n  const query = searchParams.toString();\n  return query ? `?${query}` : '';\n}\n\nexport function buildURL(\n  base: string,\n  path = '',\n  params: QueryParams = {},\n): string {\n  const normalizedBase = base.endsWith('/') ? base : `${base}/`;\n  const url = new URL(path, normalizedBase);\n  const query = formatQueryParams(params);\n  url.search = query;\n  return url.toString();\n}\n","import { buildURL } from '../utils/url';\n\nexport interface FetchRealtimeOptions {\n  buoyId: string;\n  type?: string;\n  fetch?: typeof fetch;\n  requestInit?: RequestInit;\n  baseUrl?: string;\n}\n\nconst DEFAULT_BASE_URL = 'https://www.ndbc.noaa.gov/data/realtime2/';\n\nexport function buildRealtimeUrl(\n  buoyId: string,\n  type = 'txt',\n  baseUrl = DEFAULT_BASE_URL,\n): string {\n  const filename = `${buoyId}.${type}`;\n  return buildURL(baseUrl, filename);\n}\n\nexport async function fetchRealtimeData(\n  options: FetchRealtimeOptions,\n): Promise<string> {\n  const {\n    buoyId,\n    type = 'txt',\n    fetch: fetchImpl = fetch,\n    requestInit,\n    baseUrl = DEFAULT_BASE_URL,\n  } = options;\n\n  if (!fetchImpl) {\n    throw new Error('No fetch implementation available.');\n  }\n\n  const url = buildRealtimeUrl(buoyId, type, baseUrl);\n  const response = await fetchImpl(url, requestInit);\n\n  if (!response.ok) {\n    throw new Error(`Failed to fetch ${url}: ${response.status}`);\n  }\n\n  return response.text();\n}\n","import { BuoyData, Measurement } from '../models/measurement';\nimport { ParsedValue, RealtimeRecord, RealtimeTable } from '../models/table';\n\nexport interface ParseRowOptions {\n  coerceNumbers?: boolean;\n  missingValue?: number | null;\n  missingTokens?: string[];\n}\n\nexport interface ParseRealtimeTableOptions extends ParseRowOptions {\n  commentPrefix?: string;\n}\n\nexport interface ParseRealtimeDataOptions extends ParseRealtimeTableOptions {\n  includeUnknownFields?: boolean;\n}\n\nconst DEFAULT_MISSING_TOKENS = ['MM'];\n\nfunction isMissingToken(value: string, missingTokens: string[]): boolean {\n  if (missingTokens.includes(value)) {\n    return true;\n  }\n\n  // NDBC missing values are often 9s (e.g. 99, 999, 9999, 99.0).\n  if (/^9{2,}(\\.0+|\\.9+)?$/.test(value)) {\n    return true;\n  }\n\n  return false;\n}\n\nfunction coerceValue(\n  raw: string,\n  options: Required<ParseRowOptions>,\n): ParsedValue {\n  if (isMissingToken(raw, options.missingTokens)) {\n    return options.missingValue;\n  }\n\n  if (options.coerceNumbers) {\n    const numeric = Number(raw);\n    if (!Number.isNaN(numeric)) {\n      return numeric;\n    }\n  }\n\n  return raw;\n}\n\nexport function parseRow(\n  rawRow: string,\n  options: ParseRowOptions = {},\n): ParsedValue[] {\n  const resolved: Required<ParseRowOptions> = {\n    coerceNumbers: options.coerceNumbers ?? true,\n    missingValue: options.missingValue ?? null,\n    missingTokens: options.missingTokens ?? DEFAULT_MISSING_TOKENS,\n  };\n\n  return rawRow\n    .trim()\n    .split(/\\s+/)\n    .filter(Boolean)\n    .map(value => coerceValue(value, resolved));\n}\n\nfunction isCommentLine(line: string, commentPrefix: string): boolean {\n  return line.startsWith(`${commentPrefix} `);\n}\n\nfunction normalizeLines(rawText: string): string[] {\n  return rawText\n    .split(/\\r?\\n/)\n    .map(line => line.trim())\n    .filter(line => line.length > 0);\n}\n\nexport function parseRealtimeTable(\n  rawText: string,\n  options: ParseRealtimeTableOptions = {},\n): RealtimeTable {\n  const commentPrefix = options.commentPrefix ?? '#';\n  const lines = normalizeLines(rawText).filter(\n    line => !isCommentLine(line, commentPrefix),\n  );\n\n  if (lines.length === 0) {\n    return { headers: [], units: [], rows: [], rawRows: [] };\n  }\n\n  const headerLine = lines[0] ?? '';\n  const headerOptions: ParseRowOptions = {\n    coerceNumbers: false,\n    missingValue: null,\n    missingTokens: [],\n  };\n  const headers = parseRow(headerLine, headerOptions).map(String);\n\n  let units: string[] = [];\n  let dataStartIndex = 1;\n\n  const unitLine = lines[1];\n  if (unitLine && unitLine.startsWith(commentPrefix)) {\n    units = parseRow(unitLine, headerOptions).map(token => {\n      const text = String(token);\n      return text.startsWith(commentPrefix)\n        ? text.slice(commentPrefix.length)\n        : text;\n    });\n    dataStartIndex = 2;\n  }\n\n  const rowOptions: ParseRowOptions = {\n    coerceNumbers: options.coerceNumbers,\n    missingValue: options.missingValue,\n    missingTokens: options.missingTokens,\n  };\n\n  const dataRows = lines.slice(dataStartIndex);\n  const rows = dataRows.map(row => parseRow(row, rowOptions));\n\n  return {\n    headers,\n    units,\n    rows,\n    rawRows: dataRows,\n  };\n}\n\nexport function objectifyTable(table: RealtimeTable): RealtimeRecord[] {\n  const { headers, rows } = table;\n  return rows.map(row => {\n    const record: RealtimeRecord = {};\n    headers.forEach((header, index) => {\n      record[header] = row[index] ?? null;\n    });\n    return record;\n  });\n}\n\nexport function createMeasurement(): Measurement {\n  return {\n    airTemperature: Number.NaN,\n    day: Number.NaN,\n    dewpointTemperature: Number.NaN,\n    hour: Number.NaN,\n    minute: Number.NaN,\n    month: Number.NaN,\n    pressureTendancy: Number.NaN,\n    seaLevelPressure: Number.NaN,\n    stationVisibility: Number.NaN,\n    water: {\n      averagePeriod: Number.NaN,\n      dominantDirection: Number.NaN,\n      dominantPeriod: Number.NaN,\n      significantHeight: Number.NaN,\n      surfaceTemperature: Number.NaN,\n      tide: Number.NaN,\n    },\n    wind: {\n      averageSpeed: Number.NaN,\n      direction: Number.NaN,\n      peakGustSpeed: Number.NaN,\n    },\n    year: Number.NaN,\n  };\n}\n\nconst FIELD_MAPPINGS: Record<string, (m: Measurement, value: ParsedValue) => void> = {\n  '#YY': (m, value) => {\n    m.year = Number(value);\n  },\n  YY: (m, value) => {\n    m.year = Number(value);\n  },\n  MM: (m, value) => {\n    m.month = Number(value);\n  },\n  DD: (m, value) => {\n    m.day = Number(value);\n  },\n  hh: (m, value) => {\n    m.hour = Number(value);\n  },\n  mm: (m, value) => {\n    m.minute = Number(value);\n  },\n  APD: (m, value) => {\n    m.water.averagePeriod = Number(value);\n  },\n  ATMP: (m, value) => {\n    m.airTemperature = Number(value);\n  },\n  DEWP: (m, value) => {\n    m.dewpointTemperature = Number(value);\n  },\n  DPD: (m, value) => {\n    m.water.dominantPeriod = Number(value);\n  },\n  GST: (m, value) => {\n    m.wind.peakGustSpeed = Number(value);\n  },\n  MWD: (m, value) => {\n    m.water.dominantDirection = Number(value);\n  },\n  PRES: (m, value) => {\n    m.seaLevelPressure = Number(value);\n  },\n  PTDY: (m, value) => {\n    m.pressureTendancy = Number(value);\n  },\n  TIDE: (m, value) => {\n    m.water.tide = Number(value);\n  },\n  VIS: (m, value) => {\n    m.stationVisibility = Number(value);\n  },\n  WDIR: (m, value) => {\n    m.wind.direction = Number(value);\n  },\n  WSPD: (m, value) => {\n    m.wind.averageSpeed = Number(value);\n  },\n  WTMP: (m, value) => {\n    m.water.surfaceTemperature = Number(value);\n  },\n  WVHT: (m, value) => {\n    m.water.significantHeight = Number(value);\n  },\n};\n\nfunction toMeasurement(record: RealtimeRecord): Measurement {\n  const measurement = createMeasurement();\n  Object.entries(record).forEach(([field, value]) => {\n    const mapper = FIELD_MAPPINGS[field];\n    if (mapper) {\n      mapper(measurement, value);\n    }\n  });\n  return measurement;\n}\n\nexport function parseRealtimeData(\n  buoyId: string,\n  rawText: string,\n  options: ParseRealtimeDataOptions = {},\n): BuoyData {\n  const table = parseRealtimeTable(rawText, {\n    ...options,\n    missingValue: options.missingValue ?? Number.NaN,\n  });\n  const records = objectifyTable(table);\n\n  const measurements = records.map(record => toMeasurement(record));\n\n  if (options.includeUnknownFields) {\n    const measurementsWithUnknowns = measurements.map((measurement, index) => {\n      const record = records[index];\n      return { ...measurement, ...record } as Measurement;\n    });\n\n    return {\n      id: buoyId,\n      measurements: measurementsWithUnknowns,\n    };\n  }\n\n  return {\n    id: buoyId,\n    measurements,\n  };\n}\n","import { Measurement } from '../models/measurement';\n\n/**\n * Returns a UTC Date instance for a buoy measurement.\n */\nexport function getMeasurementDate(measurement: Measurement): Date {\n  const { year, month, day, hour, minute } = measurement;\n  return new Date(Date.UTC(year, month - 1, day, hour, minute));\n}\n"],"names":["formatQueryParams","params","searchParams","key","value","item","query","buildURL","base","path","normalizedBase","url","DEFAULT_BASE_URL","buildRealtimeUrl","buoyId","type","baseUrl","filename","fetchRealtimeData","options","fetchImpl","requestInit","response","DEFAULT_MISSING_TOKENS","isMissingToken","missingTokens","coerceValue","raw","numeric","parseRow","rawRow","resolved","isCommentLine","line","commentPrefix","normalizeLines","rawText","parseRealtimeTable","lines","headerLine","headerOptions","headers","units","dataStartIndex","unitLine","token","text","rowOptions","dataRows","rows","row","objectifyTable","table","record","header","index","createMeasurement","FIELD_MAPPINGS","m","toMeasurement","measurement","field","mapper","parseRealtimeData","records","measurements","measurementsWithUnknowns","getMeasurementDate","year","month","day","hour","minute"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export type { BuoyData, Measurement, WaterMeasurement, WindMeasurement } from './models/measurement';
+export type { ParsedValue, RealtimeRecord, RealtimeTable } from './models/table';
+export type { FetchRealtimeOptions, } from './realtime/fetch';
+export type { ParseRowOptions, ParseRealtimeTableOptions, ParseRealtimeDataOptions, } from './realtime/parser';
+export { fetchRealtimeData, buildRealtimeUrl } from './realtime/fetch';
+export { parseRealtimeData, parseRealtimeTable, parseRow, objectifyTable, createMeasurement, } from './realtime/parser';
+export { getMeasurementDate } from './utils/date';
+export { buildURL, formatQueryParams } from './utils/url';

package/dist/index.js

@@ -0,0 +1,238 @@
+function g(r = {}) {
+  const e = new URLSearchParams();
+  for (const [n, a] of Object.entries(r))
+    if (a != null) {
+      if (Array.isArray(a)) {
+        a.forEach((i) => {
+          e.append(n, String(i));
+        });
+        continue;
+      }
+      e.append(n, String(a));
+    }
+  const t = e.toString();
+  return t ? `?${t}` : "";
+}
+function p(r, e = "", t = {}) {
+  const n = r.endsWith("/") ? r : `${r}/`, a = new URL(e, n), i = g(t);
+  return a.search = i, a.toString();
+}
+const d = "https://www.ndbc.noaa.gov/data/realtime2/";
+function w(r, e = "txt", t = d) {
+  const n = `${r}.${e}`;
+  return p(t, n);
+}
+async function V(r) {
+  const {
+    buoyId: e,
+    type: t = "txt",
+    fetch: n = fetch,
+    requestInit: a,
+    baseUrl: i = d
+  } = r;
+  if (!n)
+    throw new Error("No fetch implementation available.");
+  const s = w(e, t, i), u = await n(s, a);
+  if (!u.ok)
+    throw new Error(`Failed to fetch ${s}: ${u.status}`);
+  return u.text();
+}
+const T = ["MM"];
+function D(r, e) {
+  return !!(e.includes(r) || /^9{2,}(\.0+|\.9+)?$/.test(r));
+}
+function P(r, e) {
+  if (D(r, e.missingTokens))
+    return e.missingValue;
+  if (e.coerceNumbers) {
+    const t = Number(r);
+    if (!Number.isNaN(t))
+      return t;
+  }
+  return r;
+}
+function l(r, e = {}) {
+  const t = {
+    coerceNumbers: e.coerceNumbers ?? !0,
+    missingValue: e.missingValue ?? null,
+    missingTokens: e.missingTokens ?? T
+  };
+  return r.trim().split(/\s+/).filter(Boolean).map((n) => P(n, t));
+}
+function S(r, e) {
+  return r.startsWith(`${e} `);
+}
+function y(r) {
+  return r.split(/\r?\n/).map((e) => e.trim()).filter((e) => e.length > 0);
+}
+function R(r, e = {}) {
+  const t = e.commentPrefix ?? "#", n = y(r).filter(
+    (o) => !S(o, t)
+  );
+  if (n.length === 0)
+    return { headers: [], units: [], rows: [], rawRows: [] };
+  const a = n[0] ?? "", i = {
+    coerceNumbers: !1,
+    missingValue: null,
+    missingTokens: []
+  }, s = l(a, i).map(String);
+  let u = [], c = 1;
+  const m = n[1];
+  m && m.startsWith(t) && (u = l(m, i).map((o) => {
+    const N = String(o);
+    return N.startsWith(t) ? N.slice(t.length) : N;
+  }), c = 2);
+  const f = {
+    coerceNumbers: e.coerceNumbers,
+    missingValue: e.missingValue,
+    missingTokens: e.missingTokens
+  }, b = n.slice(c), h = b.map((o) => l(o, f));
+  return {
+    headers: s,
+    units: u,
+    rows: h,
+    rawRows: b
+  };
+}
+function k(r) {
+  const { headers: e, rows: t } = r;
+  return t.map((n) => {
+    const a = {};
+    return e.forEach((i, s) => {
+      a[i] = n[s] ?? null;
+    }), a;
+  });
+}
+function E() {
+  return {
+    airTemperature: Number.NaN,
+    day: Number.NaN,
+    dewpointTemperature: Number.NaN,
+    hour: Number.NaN,
+    minute: Number.NaN,
+    month: Number.NaN,
+    pressureTendancy: Number.NaN,
+    seaLevelPressure: Number.NaN,
+    stationVisibility: Number.NaN,
+    water: {
+      averagePeriod: Number.NaN,
+      dominantDirection: Number.NaN,
+      dominantPeriod: Number.NaN,
+      significantHeight: Number.NaN,
+      surfaceTemperature: Number.NaN,
+      tide: Number.NaN
+    },
+    wind: {
+      averageSpeed: Number.NaN,
+      direction: Number.NaN,
+      peakGustSpeed: Number.NaN
+    },
+    year: Number.NaN
+  };
+}
+const L = {
+  "#YY": (r, e) => {
+    r.year = Number(e);
+  },
+  YY: (r, e) => {
+    r.year = Number(e);
+  },
+  MM: (r, e) => {
+    r.month = Number(e);
+  },
+  DD: (r, e) => {
+    r.day = Number(e);
+  },
+  hh: (r, e) => {
+    r.hour = Number(e);
+  },
+  mm: (r, e) => {
+    r.minute = Number(e);
+  },
+  APD: (r, e) => {
+    r.water.averagePeriod = Number(e);
+  },
+  ATMP: (r, e) => {
+    r.airTemperature = Number(e);
+  },
+  DEWP: (r, e) => {
+    r.dewpointTemperature = Number(e);
+  },
+  DPD: (r, e) => {
+    r.water.dominantPeriod = Number(e);
+  },
+  GST: (r, e) => {
+    r.wind.peakGustSpeed = Number(e);
+  },
+  MWD: (r, e) => {
+    r.water.dominantDirection = Number(e);
+  },
+  PRES: (r, e) => {
+    r.seaLevelPressure = Number(e);
+  },
+  PTDY: (r, e) => {
+    r.pressureTendancy = Number(e);
+  },
+  TIDE: (r, e) => {
+    r.water.tide = Number(e);
+  },
+  VIS: (r, e) => {
+    r.stationVisibility = Number(e);
+  },
+  WDIR: (r, e) => {
+    r.wind.direction = Number(e);
+  },
+  WSPD: (r, e) => {
+    r.wind.averageSpeed = Number(e);
+  },
+  WTMP: (r, e) => {
+    r.water.surfaceTemperature = Number(e);
+  },
+  WVHT: (r, e) => {
+    r.water.significantHeight = Number(e);
+  }
+};
+function M(r) {
+  const e = E();
+  return Object.entries(r).forEach(([t, n]) => {
+    const a = L[t];
+    a && a(e, n);
+  }), e;
+}
+function U(r, e, t = {}) {
+  const n = R(e, {
+    ...t,
+    missingValue: t.missingValue ?? Number.NaN
+  }), a = k(n), i = a.map((s) => M(s));
+  if (t.includeUnknownFields) {
+    const s = i.map((u, c) => {
+      const m = a[c];
+      return { ...u, ...m };
+    });
+    return {
+      id: r,
+      measurements: s
+    };
+  }
+  return {
+    id: r,
+    measurements: i
+  };
+}
+function W(r) {
+  const { year: e, month: t, day: n, hour: a, minute: i } = r;
+  return new Date(Date.UTC(e, t - 1, n, a, i));
+}
+export {
+  w as buildRealtimeUrl,
+  p as buildURL,
+  E as createMeasurement,
+  V as fetchRealtimeData,
+  g as formatQueryParams,
+  W as getMeasurementDate,
+  k as objectifyTable,
+  U as parseRealtimeData,
+  R as parseRealtimeTable,
+  l as parseRow
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/utils/url.ts","../src/realtime/fetch.ts","../src/realtime/parser.ts","../src/utils/date.ts"],"sourcesContent":["export type QueryParamValue =\n  | string\n  | number\n  | boolean\n  | null\n  | undefined\n  | Array<string | number | boolean>;\n\nexport type QueryParams = Record<string, QueryParamValue>;\n\nexport function formatQueryParams(params: QueryParams = {}): string {\n  const searchParams = new URLSearchParams();\n\n  for (const [key, value] of Object.entries(params)) {\n    if (value === null || value === undefined) {\n      continue;\n    }\n\n    if (Array.isArray(value)) {\n      value.forEach(item => {\n        searchParams.append(key, String(item));\n      });\n      continue;\n    }\n\n    searchParams.append(key, String(value));\n  }\n\n  const query = searchParams.toString();\n  return query ? `?${query}` : '';\n}\n\nexport function buildURL(\n  base: string,\n  path = '',\n  params: QueryParams = {},\n): string {\n  const normalizedBase = base.endsWith('/') ? base : `${base}/`;\n  const url = new URL(path, normalizedBase);\n  const query = formatQueryParams(params);\n  url.search = query;\n  return url.toString();\n}\n","import { buildURL } from '../utils/url';\n\nexport interface FetchRealtimeOptions {\n  buoyId: string;\n  type?: string;\n  fetch?: typeof fetch;\n  requestInit?: RequestInit;\n  baseUrl?: string;\n}\n\nconst DEFAULT_BASE_URL = 'https://www.ndbc.noaa.gov/data/realtime2/';\n\nexport function buildRealtimeUrl(\n  buoyId: string,\n  type = 'txt',\n  baseUrl = DEFAULT_BASE_URL,\n): string {\n  const filename = `${buoyId}.${type}`;\n  return buildURL(baseUrl, filename);\n}\n\nexport async function fetchRealtimeData(\n  options: FetchRealtimeOptions,\n): Promise<string> {\n  const {\n    buoyId,\n    type = 'txt',\n    fetch: fetchImpl = fetch,\n    requestInit,\n    baseUrl = DEFAULT_BASE_URL,\n  } = options;\n\n  if (!fetchImpl) {\n    throw new Error('No fetch implementation available.');\n  }\n\n  const url = buildRealtimeUrl(buoyId, type, baseUrl);\n  const response = await fetchImpl(url, requestInit);\n\n  if (!response.ok) {\n    throw new Error(`Failed to fetch ${url}: ${response.status}`);\n  }\n\n  return response.text();\n}\n","import { BuoyData, Measurement } from '../models/measurement';\nimport { ParsedValue, RealtimeRecord, RealtimeTable } from '../models/table';\n\nexport interface ParseRowOptions {\n  coerceNumbers?: boolean;\n  missingValue?: number | null;\n  missingTokens?: string[];\n}\n\nexport interface ParseRealtimeTableOptions extends ParseRowOptions {\n  commentPrefix?: string;\n}\n\nexport interface ParseRealtimeDataOptions extends ParseRealtimeTableOptions {\n  includeUnknownFields?: boolean;\n}\n\nconst DEFAULT_MISSING_TOKENS = ['MM'];\n\nfunction isMissingToken(value: string, missingTokens: string[]): boolean {\n  if (missingTokens.includes(value)) {\n    return true;\n  }\n\n  // NDBC missing values are often 9s (e.g. 99, 999, 9999, 99.0).\n  if (/^9{2,}(\\.0+|\\.9+)?$/.test(value)) {\n    return true;\n  }\n\n  return false;\n}\n\nfunction coerceValue(\n  raw: string,\n  options: Required<ParseRowOptions>,\n): ParsedValue {\n  if (isMissingToken(raw, options.missingTokens)) {\n    return options.missingValue;\n  }\n\n  if (options.coerceNumbers) {\n    const numeric = Number(raw);\n    if (!Number.isNaN(numeric)) {\n      return numeric;\n    }\n  }\n\n  return raw;\n}\n\nexport function parseRow(\n  rawRow: string,\n  options: ParseRowOptions = {},\n): ParsedValue[] {\n  const resolved: Required<ParseRowOptions> = {\n    coerceNumbers: options.coerceNumbers ?? true,\n    missingValue: options.missingValue ?? null,\n    missingTokens: options.missingTokens ?? DEFAULT_MISSING_TOKENS,\n  };\n\n  return rawRow\n    .trim()\n    .split(/\\s+/)\n    .filter(Boolean)\n    .map(value => coerceValue(value, resolved));\n}\n\nfunction isCommentLine(line: string, commentPrefix: string): boolean {\n  return line.startsWith(`${commentPrefix} `);\n}\n\nfunction normalizeLines(rawText: string): string[] {\n  return rawText\n    .split(/\\r?\\n/)\n    .map(line => line.trim())\n    .filter(line => line.length > 0);\n}\n\nexport function parseRealtimeTable(\n  rawText: string,\n  options: ParseRealtimeTableOptions = {},\n): RealtimeTable {\n  const commentPrefix = options.commentPrefix ?? '#';\n  const lines = normalizeLines(rawText).filter(\n    line => !isCommentLine(line, commentPrefix),\n  );\n\n  if (lines.length === 0) {\n    return { headers: [], units: [], rows: [], rawRows: [] };\n  }\n\n  const headerLine = lines[0] ?? '';\n  const headerOptions: ParseRowOptions = {\n    coerceNumbers: false,\n    missingValue: null,\n    missingTokens: [],\n  };\n  const headers = parseRow(headerLine, headerOptions).map(String);\n\n  let units: string[] = [];\n  let dataStartIndex = 1;\n\n  const unitLine = lines[1];\n  if (unitLine && unitLine.startsWith(commentPrefix)) {\n    units = parseRow(unitLine, headerOptions).map(token => {\n      const text = String(token);\n      return text.startsWith(commentPrefix)\n        ? text.slice(commentPrefix.length)\n        : text;\n    });\n    dataStartIndex = 2;\n  }\n\n  const rowOptions: ParseRowOptions = {\n    coerceNumbers: options.coerceNumbers,\n    missingValue: options.missingValue,\n    missingTokens: options.missingTokens,\n  };\n\n  const dataRows = lines.slice(dataStartIndex);\n  const rows = dataRows.map(row => parseRow(row, rowOptions));\n\n  return {\n    headers,\n    units,\n    rows,\n    rawRows: dataRows,\n  };\n}\n\nexport function objectifyTable(table: RealtimeTable): RealtimeRecord[] {\n  const { headers, rows } = table;\n  return rows.map(row => {\n    const record: RealtimeRecord = {};\n    headers.forEach((header, index) => {\n      record[header] = row[index] ?? null;\n    });\n    return record;\n  });\n}\n\nexport function createMeasurement(): Measurement {\n  return {\n    airTemperature: Number.NaN,\n    day: Number.NaN,\n    dewpointTemperature: Number.NaN,\n    hour: Number.NaN,\n    minute: Number.NaN,\n    month: Number.NaN,\n    pressureTendancy: Number.NaN,\n    seaLevelPressure: Number.NaN,\n    stationVisibility: Number.NaN,\n    water: {\n      averagePeriod: Number.NaN,\n      dominantDirection: Number.NaN,\n      dominantPeriod: Number.NaN,\n      significantHeight: Number.NaN,\n      surfaceTemperature: Number.NaN,\n      tide: Number.NaN,\n    },\n    wind: {\n      averageSpeed: Number.NaN,\n      direction: Number.NaN,\n      peakGustSpeed: Number.NaN,\n    },\n    year: Number.NaN,\n  };\n}\n\nconst FIELD_MAPPINGS: Record<string, (m: Measurement, value: ParsedValue) => void> = {\n  '#YY': (m, value) => {\n    m.year = Number(value);\n  },\n  YY: (m, value) => {\n    m.year = Number(value);\n  },\n  MM: (m, value) => {\n    m.month = Number(value);\n  },\n  DD: (m, value) => {\n    m.day = Number(value);\n  },\n  hh: (m, value) => {\n    m.hour = Number(value);\n  },\n  mm: (m, value) => {\n    m.minute = Number(value);\n  },\n  APD: (m, value) => {\n    m.water.averagePeriod = Number(value);\n  },\n  ATMP: (m, value) => {\n    m.airTemperature = Number(value);\n  },\n  DEWP: (m, value) => {\n    m.dewpointTemperature = Number(value);\n  },\n  DPD: (m, value) => {\n    m.water.dominantPeriod = Number(value);\n  },\n  GST: (m, value) => {\n    m.wind.peakGustSpeed = Number(value);\n  },\n  MWD: (m, value) => {\n    m.water.dominantDirection = Number(value);\n  },\n  PRES: (m, value) => {\n    m.seaLevelPressure = Number(value);\n  },\n  PTDY: (m, value) => {\n    m.pressureTendancy = Number(value);\n  },\n  TIDE: (m, value) => {\n    m.water.tide = Number(value);\n  },\n  VIS: (m, value) => {\n    m.stationVisibility = Number(value);\n  },\n  WDIR: (m, value) => {\n    m.wind.direction = Number(value);\n  },\n  WSPD: (m, value) => {\n    m.wind.averageSpeed = Number(value);\n  },\n  WTMP: (m, value) => {\n    m.water.surfaceTemperature = Number(value);\n  },\n  WVHT: (m, value) => {\n    m.water.significantHeight = Number(value);\n  },\n};\n\nfunction toMeasurement(record: RealtimeRecord): Measurement {\n  const measurement = createMeasurement();\n  Object.entries(record).forEach(([field, value]) => {\n    const mapper = FIELD_MAPPINGS[field];\n    if (mapper) {\n      mapper(measurement, value);\n    }\n  });\n  return measurement;\n}\n\nexport function parseRealtimeData(\n  buoyId: string,\n  rawText: string,\n  options: ParseRealtimeDataOptions = {},\n): BuoyData {\n  const table = parseRealtimeTable(rawText, {\n    ...options,\n    missingValue: options.missingValue ?? Number.NaN,\n  });\n  const records = objectifyTable(table);\n\n  const measurements = records.map(record => toMeasurement(record));\n\n  if (options.includeUnknownFields) {\n    const measurementsWithUnknowns = measurements.map((measurement, index) => {\n      const record = records[index];\n      return { ...measurement, ...record } as Measurement;\n    });\n\n    return {\n      id: buoyId,\n      measurements: measurementsWithUnknowns,\n    };\n  }\n\n  return {\n    id: buoyId,\n    measurements,\n  };\n}\n","import { Measurement } from '../models/measurement';\n\n/**\n * Returns a UTC Date instance for a buoy measurement.\n */\nexport function getMeasurementDate(measurement: Measurement): Date {\n  const { year, month, day, hour, minute } = measurement;\n  return new Date(Date.UTC(year, month - 1, day, hour, minute));\n}\n"],"names":["formatQueryParams","params","searchParams","key","value","item","query","buildURL","base","path","normalizedBase","url","DEFAULT_BASE_URL","buildRealtimeUrl","buoyId","type","baseUrl","filename","fetchRealtimeData","options","fetchImpl","requestInit","response","DEFAULT_MISSING_TOKENS","isMissingToken","missingTokens","coerceValue","raw","numeric","parseRow","rawRow","resolved","isCommentLine","line","commentPrefix","normalizeLines","rawText","parseRealtimeTable","lines","headerLine","headerOptions","headers","units","dataStartIndex","unitLine","token","text","rowOptions","dataRows","rows","row","objectifyTable","table","record","header","index","createMeasurement","FIELD_MAPPINGS","m","toMeasurement","measurement","field","mapper","parseRealtimeData","records","measurements","measurementsWithUnknowns","getMeasurementDate","year","month","day","hour","minute"],"mappings":"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"}

package/dist/models/measurement.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Real-time water measurement data.
+ */
+export interface WaterMeasurement {
+    /**
+     * Average wave period (seconds) of all waves during the 20-minute period.
+     */
+    averagePeriod: number;
+    /**
+     * The direction from which the waves at the dominant period (DPD) are coming.
+     * The units are degrees from true North, increasing clockwise, with North as 0 (zero) degrees and East as 90 degrees.
+     */
+    dominantDirection: number;
+    /**
+     * Dominant wave period (seconds) is the period with the maximum wave energy.
+     */
+    dominantPeriod: number;
+    /**
+     * Significant wave height (meters) is calculated as the average of the highest one-third of all of the wave heights
+     * during the 20-minute sampling period.
+     */
+    significantHeight: number;
+    /**
+     * Sea surface temperature (Celsius).
+     */
+    surfaceTemperature: number;
+    /**
+     * The water level in feet above or below Mean Lower Low Water (MLLW).
+     */
+    tide: number;
+}
+/**
+ * Real-time wind measurement data.
+ */
+export interface WindMeasurement {
+    /**
+     * Wind direction (degrees clockwise from true North).
+     */
+    direction: number;
+    /**
+     * Wind speed (m/s) averaged over the buoy reporting interval.
+     */
+    averageSpeed: number;
+    /**
+     * Peak gust speed (m/s) during the reporting interval.
+     */
+    peakGustSpeed: number;
+}
+/**
+ * A single real-time buoy data measurement.
+ */
+export interface Measurement {
+    year: number;
+    month: number;
+    day: number;
+    hour: number;
+    minute: number;
+    /**
+     * Air temperature (Celsius).
+     */
+    airTemperature: number;
+    /**
+     * Dewpoint temperature (Celsius).
+     */
+    dewpointTemperature: number;
+    /**
+     * Pressure tendency (hPa over the last three hours).
+     */
+    pressureTendancy: number;
+    /**
+     * Sea level pressure (hPa).
+     */
+    seaLevelPressure: number;
+    /**
+     * Station visibility (nautical miles).
+     */
+    stationVisibility: number;
+    water: WaterMeasurement;
+    wind: WindMeasurement;
+}
+export interface BuoyData {
+    id: string;
+    /**
+     * Measurements ordered from latest to oldest as reported by NDBC.
+     */
+    measurements: Measurement[];
+}

package/dist/models/table.d.ts

@@ -0,0 +1,8 @@
+export type ParsedValue = string | number | null;
+export interface RealtimeTable {
+    headers: string[];
+    units: string[];
+    rows: ParsedValue[][];
+    rawRows: string[];
+}
+export type RealtimeRecord = Record<string, ParsedValue>;

package/dist/realtime/fetch.d.ts

@@ -0,0 +1,9 @@
+export interface FetchRealtimeOptions {
+    buoyId: string;
+    type?: string;
+    fetch?: typeof fetch;
+    requestInit?: RequestInit;
+    baseUrl?: string;
+}
+export declare function buildRealtimeUrl(buoyId: string, type?: string, baseUrl?: string): string;
+export declare function fetchRealtimeData(options: FetchRealtimeOptions): Promise<string>;

package/dist/realtime/parser.d.ts

@@ -0,0 +1,18 @@
+import { BuoyData, Measurement } from '../models/measurement';
+import { ParsedValue, RealtimeRecord, RealtimeTable } from '../models/table';
+export interface ParseRowOptions {
+    coerceNumbers?: boolean;
+    missingValue?: number | null;
+    missingTokens?: string[];
+}
+export interface ParseRealtimeTableOptions extends ParseRowOptions {
+    commentPrefix?: string;
+}
+export interface ParseRealtimeDataOptions extends ParseRealtimeTableOptions {
+    includeUnknownFields?: boolean;
+}
+export declare function parseRow(rawRow: string, options?: ParseRowOptions): ParsedValue[];
+export declare function parseRealtimeTable(rawText: string, options?: ParseRealtimeTableOptions): RealtimeTable;
+export declare function objectifyTable(table: RealtimeTable): RealtimeRecord[];
+export declare function createMeasurement(): Measurement;
+export declare function parseRealtimeData(buoyId: string, rawText: string, options?: ParseRealtimeDataOptions): BuoyData;

package/dist/utils/date.d.ts

@@ -0,0 +1,5 @@
+import { Measurement } from '../models/measurement';
+/**
+ * Returns a UTC Date instance for a buoy measurement.
+ */
+export declare function getMeasurementDate(measurement: Measurement): Date;

package/dist/utils/url.d.ts

@@ -0,0 +1,4 @@
+export type QueryParamValue = string | number | boolean | null | undefined | Array<string | number | boolean>;
+export type QueryParams = Record<string, QueryParamValue>;
+export declare function formatQueryParams(params?: QueryParams): string;
+export declare function buildURL(base: string, path?: string, params?: QueryParams): string;

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "buoydata",
+  "version": "0.1.0",
+  "description": "Modern TypeScript SDK for NDBC realtime buoy data.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "devDependencies": {
+    "@typescript-eslint/eslint-plugin": "^8.4.0",
+    "@typescript-eslint/parser": "^8.4.0",
+    "@vitest/coverage-v8": "^2.1.1",
+    "eslint": "^9.9.0",
+    "eslint-config-prettier": "^9.1.0",
+    "prettier": "^3.3.3",
+    "typescript": "^5.5.4",
+    "vite": "^5.4.2",
+    "vitest": "^2.1.1"
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build && tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint . --ext .ts",
+    "format": "prettier -w ."
+  }
+}