buoydata 0.1.2 → 0.1.3

package/dist/index.cjs

@@ -1,2 +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;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class w{constructor(e,r){this.maxSize=e,this.ttlMs=r,this.items=new Map}get(e){const r=this.items.get(e);if(!r)return;const n=Date.now();if(r.expiresAt<=n){this.items.delete(e);return}return this.items.delete(e),this.items.set(e,r),r.value}set(e,r){const n=Date.now();this.items.has(e)&&this.items.delete(e),this.items.set(e,{value:r,expiresAt:n+this.ttlMs}),this.prune(n)}prune(e){for(const[r,n]of this.items)n.expiresAt>e||this.items.delete(r);for(;this.items.size>this.maxSize;){const r=this.items.keys().next().value;if(r===void 0)break;this.items.delete(r)}}}function p(t={}){const e=new URLSearchParams;for(const[n,s]of Object.entries(t))if(s!=null){if(Array.isArray(s)){s.forEach(i=>{e.append(n,String(i))});continue}e.append(n,String(s))}const r=e.toString();return r?`?${r}`:""}function g(t,e="",r={}){const n=t.endsWith("/")?t:`${t}/`,s=new URL(e,n),i=p(r);return s.search=i,s.toString()}const T="https://www.ndbc.noaa.gov/data/realtime2/",A=5*60*1e3,M=256,h=new w(M,A);function S(t,e="txt",r=T){const n=`${t}.${e}`;return g(r,n)}async function P(t){const{buoyId:e,type:r="txt",fetch:n=fetch,requestInit:s,baseUrl:i=T}=t;if(!n)throw new Error("No fetch implementation available.");const a=`${i}|${e}|${r}`,o=h.get(a);if(o!==void 0)return o;const c=S(e,r,i),u=await n(c,s);if(!u.ok)throw new Error(`Failed to fetch ${c}: ${u.status}`);const l=await u.text();return h.set(a,l),l}const _="https://www.ndbc.noaa.gov/activestations.txt",R=4*60*60*1e3,v=4,b=new w(v,R);function I(t){const e=new Set;return t.split(/\r?\n/).map(r=>r.trim()).filter(r=>r.length>0).forEach(r=>{if(r.startsWith("#"))return;const[n]=r.split(/\s+/);if(!n)return;const s=n.toUpperCase();s==="STATION"||s==="STN"||/^[A-Z0-9]{3,10}$/.test(s)&&e.add(s)}),Array.from(e)}async function U(t={}){const{fetch:e=fetch,requestInit:r,url:n=_}=t;if(!e)throw new Error("No fetch implementation available.");const s=b.get(n);if(s!==void 0)return s;const i=await e(n,r);if(!i.ok)throw new Error(`Failed to fetch ${n}: ${i.status}`);const a=await i.text(),o=I(a);return b.set(n,o),o}const C=["MM"];function x(t,e){return!!(e.includes(t)||/^9{2,}(\.0+|\.9+)?$/.test(t))}function $(t,e){if(x(t,e.missingTokens))return e.missingValue;if(e.coerceNumbers){const r=Number(t);if(!Number.isNaN(r))return r}return t}function N(t,e={}){const r={coerceNumbers:e.coerceNumbers??!0,missingValue:e.missingValue??null,missingTokens:e.missingTokens??C};return t.trim().split(/\s+/).filter(Boolean).map(n=>$(n,r))}function k(t,e){return t.startsWith(`${e} `)}function V(t){return t.split(/\r?\n/).map(e=>e.trim()).filter(e=>e.length>0)}function y(t,e={}){const r=e.commentPrefix??"#",n=V(t).filter(m=>!k(m,r));if(n.length===0)return{headers:[],units:[],rows:[],rawRows:[]};const s=n[0]??"",i={coerceNumbers:!1,missingValue:null,missingTokens:[]},a=N(s,i).map(String);let o=[],c=1;const u=n[1];u&&u.startsWith(r)&&(o=N(u,i).map(m=>{const f=String(m);return f.startsWith(r)?f.slice(r.length):f}),c=2);const l={coerceNumbers:e.coerceNumbers,missingValue:e.missingValue,missingTokens:e.missingTokens},d=n.slice(c),L=d.map(m=>N(m,l));return{headers:a,units:o,rows:L,rawRows:d}}function D(t){const{headers:e,rows:r}=t;return r.map(n=>{const s={};return e.forEach((i,a)=>{s[i]=n[a]??null}),s})}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 W={"#YY":(t,e)=>{t.year=Number(e)},YY:(t,e)=>{t.year=Number(e)},MM:(t,e)=>{t.month=Number(e)},DD:(t,e)=>{t.day=Number(e)},hh:(t,e)=>{t.hour=Number(e)},mm:(t,e)=>{t.minute=Number(e)},APD:(t,e)=>{t.water.averagePeriod=Number(e)},ATMP:(t,e)=>{t.airTemperature=Number(e)},DEWP:(t,e)=>{t.dewpointTemperature=Number(e)},DPD:(t,e)=>{t.water.dominantPeriod=Number(e)},GST:(t,e)=>{t.wind.peakGustSpeed=Number(e)},MWD:(t,e)=>{t.water.dominantDirection=Number(e)},PRES:(t,e)=>{t.seaLevelPressure=Number(e)},PTDY:(t,e)=>{t.pressureTendancy=Number(e)},TIDE:(t,e)=>{t.water.tide=Number(e)},VIS:(t,e)=>{t.stationVisibility=Number(e)},WDIR:(t,e)=>{t.wind.direction=Number(e)},WSPD:(t,e)=>{t.wind.averageSpeed=Number(e)},WTMP:(t,e)=>{t.water.surfaceTemperature=Number(e)},WVHT:(t,e)=>{t.water.significantHeight=Number(e)}};function O(t){const e=E();return Object.entries(t).forEach(([r,n])=>{const s=W[r];s&&s(e,n)}),e}function B(t,e,r={}){const n=y(e,{...r,missingValue:r.missingValue??Number.NaN}),s=D(n),i=s.map(a=>O(a));if(r.includeUnknownFields){const a=i.map((o,c)=>{const u=s[c];return{...o,...u}});return{id:t,measurements:a}}return{id:t,measurements:i}}function H(t){const{year:e,month:r,day:n,hour:s,minute:i}=t;return new Date(Date.UTC(e,r-1,n,s,i))}exports.buildRealtimeUrl=S;exports.buildURL=g;exports.createMeasurement=E;exports.fetchBuoyList=U;exports.fetchRealtimeData=P;exports.formatQueryParams=p;exports.getMeasurementDate=H;exports.objectifyTable=D;exports.parseRealtimeData=B;exports.parseRealtimeTable=y;exports.parseRow=N;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +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":"gFAUO,SAASA,EAAkBC,EAAsB,GAAY,CAClE,MAAMC,EAAe,IAAI,gBAEzB,SAAW,CAACC,EAAKC,CAAK,IAAK,OAAO,QAAQH,CAAM,EAC9C,GAAIG,GAAU,KAId,IAAI,MAAM,QAAQA,CAAK,EAAG,CACxBA,EAAM,QAAQC,GAAQ,CACpBH,EAAa,OAAOC,EAAK,OAAOE,CAAI,CAAC,CACvC,CAAC,EACD,QACF,CAEAH,EAAa,OAAOC,EAAK,OAAOC,CAAK,CAAC,EAGxC,MAAME,EAAQJ,EAAa,SAAA,EAC3B,OAAOI,EAAQ,IAAIA,CAAK,GAAK,EAC/B,CAEO,SAASC,EACdC,EACAC,EAAO,GACPR,EAAsB,CAAA,EACd,CACR,MAAMS,EAAiBF,EAAK,SAAS,GAAG,EAAIA,EAAO,GAAGA,CAAI,IACpDG,EAAM,IAAI,IAAIF,EAAMC,CAAc,EAClCJ,EAAQN,EAAkBC,CAAM,EACtC,OAAAU,EAAI,OAASL,EACNK,EAAI,SAAA,CACb,CChCA,MAAMC,EAAmB,4CAElB,SAASC,EACdC,EACAC,EAAO,MACPC,EAAUJ,EACF,CACR,MAAMK,EAAW,GAAGH,CAAM,IAAIC,CAAI,GAClC,OAAOR,EAASS,EAASC,CAAQ,CACnC,CAEA,eAAsBC,EACpBC,EACiB,CACjB,KAAM,CACJ,OAAAL,EACA,KAAAC,EAAO,MACP,MAAOK,EAAY,MACnB,YAAAC,EACA,QAAAL,EAAUJ,CAAA,EACRO,EAEJ,GAAI,CAACC,EACH,MAAM,IAAI,MAAM,oCAAoC,EAGtD,MAAMT,EAAME,EAAiBC,EAAQC,EAAMC,CAAO,EAC5CM,EAAW,MAAMF,EAAUT,EAAKU,CAAW,EAEjD,GAAI,CAACC,EAAS,GACZ,MAAM,IAAI,MAAM,mBAAmBX,CAAG,KAAKW,EAAS,MAAM,EAAE,EAG9D,OAAOA,EAAS,KAAA,CAClB,CC3BA,MAAMC,EAAyB,CAAC,IAAI,EAEpC,SAASC,EAAepB,EAAeqB,EAAkC,CAMvE,MALI,GAAAA,EAAc,SAASrB,CAAK,GAK5B,sBAAsB,KAAKA,CAAK,EAKtC,CAEA,SAASsB,EACPC,EACAR,EACa,CACb,GAAIK,EAAeG,EAAKR,EAAQ,aAAa,EAC3C,OAAOA,EAAQ,aAGjB,GAAIA,EAAQ,cAAe,CACzB,MAAMS,EAAU,OAAOD,CAAG,EAC1B,GAAI,CAAC,OAAO,MAAMC,CAAO,EACvB,OAAOA,CAEX,CAEA,OAAOD,CACT,CAEO,SAASE,EACdC,EACAX,EAA2B,GACZ,CACf,MAAMY,EAAsC,CAC1C,cAAeZ,EAAQ,eAAiB,GACxC,aAAcA,EAAQ,cAAgB,KACtC,cAAeA,EAAQ,eAAiBI,CAAA,EAG1C,OAAOO,EACJ,KAAA,EACA,MAAM,KAAK,EACX,OAAO,OAAO,EACd,IAAI1B,GAASsB,EAAYtB,EAAO2B,CAAQ,CAAC,CAC9C,CAEA,SAASC,EAAcC,EAAcC,EAAgC,CACnE,OAAOD,EAAK,WAAW,GAAGC,CAAa,GAAG,CAC5C,CAEA,SAASC,EAAeC,EAA2B,CACjD,OAAOA,EACJ,MAAM,OAAO,EACb,IAAIH,GAAQA,EAAK,KAAA,CAAM,EACvB,OAAOA,GAAQA,EAAK,OAAS,CAAC,CACnC,CAEO,SAASI,EACdD,EACAjB,EAAqC,GACtB,CACf,MAAMe,EAAgBf,EAAQ,eAAiB,IACzCmB,EAAQH,EAAeC,CAAO,EAAE,OACpCH,GAAQ,CAACD,EAAcC,EAAMC,CAAa,CAAA,EAG5C,GAAII,EAAM,SAAW,EACnB,MAAO,CAAE,QAAS,CAAA,EAAI,MAAO,CAAA,EAAI,KAAM,CAAA,EAAI,QAAS,EAAC,EAGvD,MAAMC,EAAaD,EAAM,CAAC,GAAK,GACzBE,EAAiC,CACrC,cAAe,GACf,aAAc,KACd,cAAe,CAAA,CAAC,EAEZC,EAAUZ,EAASU,EAAYC,CAAa,EAAE,IAAI,MAAM,EAE9D,IAAIE,EAAkB,CAAA,EAClBC,EAAiB,EAErB,MAAMC,EAAWN,EAAM,CAAC,EACpBM,GAAYA,EAAS,WAAWV,CAAa,IAC/CQ,EAAQb,EAASe,EAAUJ,CAAa,EAAE,IAAIK,GAAS,CACrD,MAAMC,EAAO,OAAOD,CAAK,EACzB,OAAOC,EAAK,WAAWZ,CAAa,EAChCY,EAAK,MAAMZ,EAAc,MAAM,EAC/BY,CACN,CAAC,EACDH,EAAiB,GAGnB,MAAMI,EAA8B,CAClC,cAAe5B,EAAQ,cACvB,aAAcA,EAAQ,aACtB,cAAeA,EAAQ,aAAA,EAGnB6B,EAAWV,EAAM,MAAMK,CAAc,EACrCM,EAAOD,EAAS,OAAWnB,EAASqB,EAAKH,CAAU,CAAC,EAE1D,MAAO,CACL,QAAAN,EACA,MAAAC,EACA,KAAAO,EACA,QAASD,CAAA,CAEb,CAEO,SAASG,EAAeC,EAAwC,CACrE,KAAM,CAAE,QAAAX,EAAS,KAAAQ,CAAA,EAASG,EAC1B,OAAOH,EAAK,IAAIC,GAAO,CACrB,MAAMG,EAAyB,CAAA,EAC/B,OAAAZ,EAAQ,QAAQ,CAACa,EAAQC,IAAU,CACjCF,EAAOC,CAAM,EAAIJ,EAAIK,CAAK,GAAK,IACjC,CAAC,EACMF,CACT,CAAC,CACH,CAEO,SAASG,GAAiC,CAC/C,MAAO,CACL,eAAgB,OAAO,IACvB,IAAK,OAAO,IACZ,oBAAqB,OAAO,IAC5B,KAAM,OAAO,IACb,OAAQ,OAAO,IACf,MAAO,OAAO,IACd,iBAAkB,OAAO,IACzB,iBAAkB,OAAO,IACzB,kBAAmB,OAAO,IAC1B,MAAO,CACL,cAAe,OAAO,IACtB,kBAAmB,OAAO,IAC1B,eAAgB,OAAO,IACvB,kBAAmB,OAAO,IAC1B,mBAAoB,OAAO,IAC3B,KAAM,OAAO,GAAA,EAEf,KAAM,CACJ,aAAc,OAAO,IACrB,UAAW,OAAO,IAClB,cAAe,OAAO,GAAA,EAExB,KAAM,OAAO,GAAA,CAEjB,CAEA,MAAMC,EAA+E,CACnF,MAAO,CAACC,EAAGtD,IAAU,CACnBsD,EAAE,KAAO,OAAOtD,CAAK,CACvB,EACA,GAAI,CAACsD,EAAGtD,IAAU,CAChBsD,EAAE,KAAO,OAAOtD,CAAK,CACvB,EACA,GAAI,CAACsD,EAAGtD,IAAU,CAChBsD,EAAE,MAAQ,OAAOtD,CAAK,CACxB,EACA,GAAI,CAACsD,EAAGtD,IAAU,CAChBsD,EAAE,IAAM,OAAOtD,CAAK,CACtB,EACA,GAAI,CAACsD,EAAGtD,IAAU,CAChBsD,EAAE,KAAO,OAAOtD,CAAK,CACvB,EACA,GAAI,CAACsD,EAAGtD,IAAU,CAChBsD,EAAE,OAAS,OAAOtD,CAAK,CACzB,EACA,IAAK,CAACsD,EAAGtD,IAAU,CACjBsD,EAAE,MAAM,cAAgB,OAAOtD,CAAK,CACtC,EACA,KAAM,CAACsD,EAAGtD,IAAU,CAClBsD,EAAE,eAAiB,OAAOtD,CAAK,CACjC,EACA,KAAM,CAACsD,EAAGtD,IAAU,CAClBsD,EAAE,oBAAsB,OAAOtD,CAAK,CACtC,EACA,IAAK,CAACsD,EAAGtD,IAAU,CACjBsD,EAAE,MAAM,eAAiB,OAAOtD,CAAK,CACvC,EACA,IAAK,CAACsD,EAAGtD,IAAU,CACjBsD,EAAE,KAAK,cAAgB,OAAOtD,CAAK,CACrC,EACA,IAAK,CAACsD,EAAGtD,IAAU,CACjBsD,EAAE,MAAM,kBAAoB,OAAOtD,CAAK,CAC1C,EACA,KAAM,CAACsD,EAAGtD,IAAU,CAClBsD,EAAE,iBAAmB,OAAOtD,CAAK,CACnC,EACA,KAAM,CAACsD,EAAGtD,IAAU,CAClBsD,EAAE,iBAAmB,OAAOtD,CAAK,CACnC,EACA,KAAM,CAACsD,EAAGtD,IAAU,CAClBsD,EAAE,MAAM,KAAO,OAAOtD,CAAK,CAC7B,EACA,IAAK,CAACsD,EAAGtD,IAAU,CACjBsD,EAAE,kBAAoB,OAAOtD,CAAK,CACpC,EACA,KAAM,CAACsD,EAAGtD,IAAU,CAClBsD,EAAE,KAAK,UAAY,OAAOtD,CAAK,CACjC,EACA,KAAM,CAACsD,EAAGtD,IAAU,CAClBsD,EAAE,KAAK,aAAe,OAAOtD,CAAK,CACpC,EACA,KAAM,CAACsD,EAAGtD,IAAU,CAClBsD,EAAE,MAAM,mBAAqB,OAAOtD,CAAK,CAC3C,EACA,KAAM,CAACsD,EAAGtD,IAAU,CAClBsD,EAAE,MAAM,kBAAoB,OAAOtD,CAAK,CAC1C,CACF,EAEA,SAASuD,EAAcN,EAAqC,CAC1D,MAAMO,EAAcJ,EAAA,EACpB,cAAO,QAAQH,CAAM,EAAE,QAAQ,CAAC,CAACQ,EAAOzD,CAAK,IAAM,CACjD,MAAM0D,EAASL,EAAeI,CAAK,EAC/BC,GACFA,EAAOF,EAAaxD,CAAK,CAE7B,CAAC,EACMwD,CACT,CAEO,SAASG,EACdjD,EACAsB,EACAjB,EAAoC,CAAA,EAC1B,CACV,MAAMiC,EAAQf,EAAmBD,EAAS,CACxC,GAAGjB,EACH,aAAcA,EAAQ,cAAgB,OAAO,GAAA,CAC9C,EACK6C,EAAUb,EAAeC,CAAK,EAE9Ba,EAAeD,EAAQ,IAAIX,GAAUM,EAAcN,CAAM,CAAC,EAEhE,GAAIlC,EAAQ,qBAAsB,CAChC,MAAM+C,EAA2BD,EAAa,IAAI,CAACL,EAAaL,IAAU,CACxE,MAAMF,EAASW,EAAQT,CAAK,EAC5B,MAAO,CAAE,GAAGK,EAAa,GAAGP,CAAA,CAC9B,CAAC,EAED,MAAO,CACL,GAAIvC,EACJ,aAAcoD,CAAA,CAElB,CAEA,MAAO,CACL,GAAIpD,EACJ,aAAAmD,CAAA,CAEJ,CC3QO,SAASE,EAAmBP,EAAgC,CACjE,KAAM,CAAE,KAAAQ,EAAM,MAAAC,EAAO,IAAAC,EAAK,KAAAC,EAAM,OAAAC,GAAWZ,EAC3C,OAAO,IAAI,KAAK,KAAK,IAAIQ,EAAMC,EAAQ,EAAGC,EAAKC,EAAMC,CAAM,CAAC,CAC9D"}
+{"version":3,"file":"index.cjs","sources":["../src/utils/lru.ts","../src/utils/url.ts","../src/realtime/fetch.ts","../src/stations/list.ts","../src/realtime/parser.ts","../src/utils/date.ts"],"sourcesContent":["export class LruCache<K, V> {\n  private readonly items = new Map<K, { value: V; expiresAt: number }>();\n\n  constructor(\n    private readonly maxSize: number,\n    private readonly ttlMs: number,\n  ) {}\n\n  get(key: K): V | undefined {\n    const entry = this.items.get(key);\n    if (!entry) {\n      return undefined;\n    }\n\n    const now = Date.now();\n    if (entry.expiresAt <= now) {\n      this.items.delete(key);\n      return undefined;\n    }\n\n    this.items.delete(key);\n    this.items.set(key, entry);\n    return entry.value;\n  }\n\n  set(key: K, value: V): void {\n    const now = Date.now();\n    if (this.items.has(key)) {\n      this.items.delete(key);\n    }\n\n    this.items.set(key, { value, expiresAt: now + this.ttlMs });\n    this.prune(now);\n  }\n\n  private prune(now: number): void {\n    for (const [key, entry] of this.items) {\n      if (entry.expiresAt > now) {\n        continue;\n      }\n      this.items.delete(key);\n    }\n\n    while (this.items.size > this.maxSize) {\n      const oldestKey = this.items.keys().next().value as K | undefined;\n      if (oldestKey === undefined) {\n        break;\n      }\n      this.items.delete(oldestKey);\n    }\n  }\n}\n","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 { LruCache } from '../utils/lru';\nimport { 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/';\nconst CACHE_TTL_MS = 5 * 60 * 1000;\nconst CACHE_MAX_SIZE = 256;\nconst REALTIME_CACHE = new LruCache<string, string>(\n  CACHE_MAX_SIZE,\n  CACHE_TTL_MS,\n);\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 cacheKey = `${baseUrl}|${buoyId}|${type}`;\n  const cached = REALTIME_CACHE.get(cacheKey);\n  if (cached !== undefined) {\n    return cached;\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  const body = await response.text();\n  REALTIME_CACHE.set(cacheKey, body);\n  return body;\n}\n","import { LruCache } from '../utils/lru';\n\nexport interface FetchBuoyListOptions {\n  fetch?: typeof fetch;\n  requestInit?: RequestInit;\n  url?: string;\n}\n\nconst DEFAULT_BUOY_LIST_URL = 'https://www.ndbc.noaa.gov/activestations.txt';\nconst BUOY_LIST_CACHE_TTL_MS = 4 * 60 * 60 * 1000;\nconst BUOY_LIST_CACHE_MAX_SIZE = 4;\nconst BUOY_LIST_CACHE = new LruCache<string, string[]>(\n  BUOY_LIST_CACHE_MAX_SIZE,\n  BUOY_LIST_CACHE_TTL_MS,\n);\n\nfunction parseBuoyList(rawText: string): string[] {\n  const ids = new Set<string>();\n\n  rawText\n    .split(/\\r?\\n/)\n    .map(line => line.trim())\n    .filter(line => line.length > 0)\n    .forEach(line => {\n      if (line.startsWith('#')) {\n        return;\n      }\n\n      const [token] = line.split(/\\s+/);\n      if (!token) {\n        return;\n      }\n\n      const normalized = token.toUpperCase();\n      if (normalized === 'STATION' || normalized === 'STN') {\n        return;\n      }\n\n      if (!/^[A-Z0-9]{3,10}$/.test(normalized)) {\n        return;\n      }\n\n      ids.add(normalized);\n    });\n\n  return Array.from(ids);\n}\n\nexport async function fetchBuoyList(\n  options: FetchBuoyListOptions = {},\n): Promise<string[]> {\n  const { fetch: fetchImpl = fetch, requestInit, url = DEFAULT_BUOY_LIST_URL } =\n    options;\n\n  if (!fetchImpl) {\n    throw new Error('No fetch implementation available.');\n  }\n\n  const cached = BUOY_LIST_CACHE.get(url);\n  if (cached !== undefined) {\n    return cached;\n  }\n\n  const response = await fetchImpl(url, requestInit);\n  if (!response.ok) {\n    throw new Error(`Failed to fetch ${url}: ${response.status}`);\n  }\n\n  const body = await response.text();\n  const list = parseBuoyList(body);\n  BUOY_LIST_CACHE.set(url, list);\n  return list;\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":["LruCache","maxSize","ttlMs","key","entry","now","value","oldestKey","formatQueryParams","params","searchParams","item","query","buildURL","base","path","normalizedBase","url","DEFAULT_BASE_URL","CACHE_TTL_MS","CACHE_MAX_SIZE","REALTIME_CACHE","buildRealtimeUrl","buoyId","type","baseUrl","filename","fetchRealtimeData","options","fetchImpl","requestInit","cacheKey","cached","response","body","DEFAULT_BUOY_LIST_URL","BUOY_LIST_CACHE_TTL_MS","BUOY_LIST_CACHE_MAX_SIZE","BUOY_LIST_CACHE","parseBuoyList","rawText","ids","line","token","normalized","fetchBuoyList","list","DEFAULT_MISSING_TOKENS","isMissingToken","missingTokens","coerceValue","raw","numeric","parseRow","rawRow","resolved","isCommentLine","commentPrefix","normalizeLines","parseRealtimeTable","lines","headerLine","headerOptions","headers","units","dataStartIndex","unitLine","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":"gFAAO,MAAMA,CAAe,CAG1B,YACmBC,EACAC,EACjB,CAFiB,KAAA,QAAAD,EACA,KAAA,MAAAC,EAJnB,KAAiB,UAAY,GAK1B,CAEH,IAAIC,EAAuB,CACzB,MAAMC,EAAQ,KAAK,MAAM,IAAID,CAAG,EAChC,GAAI,CAACC,EACH,OAGF,MAAMC,EAAM,KAAK,IAAA,EACjB,GAAID,EAAM,WAAaC,EAAK,CAC1B,KAAK,MAAM,OAAOF,CAAG,EACrB,MACF,CAEA,YAAK,MAAM,OAAOA,CAAG,EACrB,KAAK,MAAM,IAAIA,EAAKC,CAAK,EAClBA,EAAM,KACf,CAEA,IAAID,EAAQG,EAAgB,CAC1B,MAAMD,EAAM,KAAK,IAAA,EACb,KAAK,MAAM,IAAIF,CAAG,GACpB,KAAK,MAAM,OAAOA,CAAG,EAGvB,KAAK,MAAM,IAAIA,EAAK,CAAE,MAAAG,EAAO,UAAWD,EAAM,KAAK,MAAO,EAC1D,KAAK,MAAMA,CAAG,CAChB,CAEQ,MAAMA,EAAmB,CAC/B,SAAW,CAACF,EAAKC,CAAK,IAAK,KAAK,MAC1BA,EAAM,UAAYC,GAGtB,KAAK,MAAM,OAAOF,CAAG,EAGvB,KAAO,KAAK,MAAM,KAAO,KAAK,SAAS,CACrC,MAAMI,EAAY,KAAK,MAAM,KAAA,EAAO,OAAO,MAC3C,GAAIA,IAAc,OAChB,MAEF,KAAK,MAAM,OAAOA,CAAS,CAC7B,CACF,CACF,CCzCO,SAASC,EAAkBC,EAAsB,GAAY,CAClE,MAAMC,EAAe,IAAI,gBAEzB,SAAW,CAACP,EAAKG,CAAK,IAAK,OAAO,QAAQG,CAAM,EAC9C,GAAIH,GAAU,KAId,IAAI,MAAM,QAAQA,CAAK,EAAG,CACxBA,EAAM,QAAQK,GAAQ,CACpBD,EAAa,OAAOP,EAAK,OAAOQ,CAAI,CAAC,CACvC,CAAC,EACD,QACF,CAEAD,EAAa,OAAOP,EAAK,OAAOG,CAAK,CAAC,EAGxC,MAAMM,EAAQF,EAAa,SAAA,EAC3B,OAAOE,EAAQ,IAAIA,CAAK,GAAK,EAC/B,CAEO,SAASC,EACdC,EACAC,EAAO,GACPN,EAAsB,CAAA,EACd,CACR,MAAMO,EAAiBF,EAAK,SAAS,GAAG,EAAIA,EAAO,GAAGA,CAAI,IACpDG,EAAM,IAAI,IAAIF,EAAMC,CAAc,EAClCJ,EAAQJ,EAAkBC,CAAM,EACtC,OAAAQ,EAAI,OAASL,EACNK,EAAI,SAAA,CACb,CC/BA,MAAMC,EAAmB,4CACnBC,EAAe,EAAI,GAAK,IACxBC,EAAiB,IACjBC,EAAiB,IAAIrB,EACzBoB,EACAD,CACF,EAEO,SAASG,EACdC,EACAC,EAAO,MACPC,EAAUP,EACF,CACR,MAAMQ,EAAW,GAAGH,CAAM,IAAIC,CAAI,GAClC,OAAOX,EAASY,EAASC,CAAQ,CACnC,CAEA,eAAsBC,EACpBC,EACiB,CACjB,KAAM,CACJ,OAAAL,EACA,KAAAC,EAAO,MACP,MAAOK,EAAY,MACnB,YAAAC,EACA,QAAAL,EAAUP,CAAA,EACRU,EAEJ,GAAI,CAACC,EACH,MAAM,IAAI,MAAM,oCAAoC,EAGtD,MAAME,EAAW,GAAGN,CAAO,IAAIF,CAAM,IAAIC,CAAI,GACvCQ,EAASX,EAAe,IAAIU,CAAQ,EAC1C,GAAIC,IAAW,OACb,OAAOA,EAGT,MAAMf,EAAMK,EAAiBC,EAAQC,EAAMC,CAAO,EAC5CQ,EAAW,MAAMJ,EAAUZ,EAAKa,CAAW,EAEjD,GAAI,CAACG,EAAS,GACZ,MAAM,IAAI,MAAM,mBAAmBhB,CAAG,KAAKgB,EAAS,MAAM,EAAE,EAG9D,MAAMC,EAAO,MAAMD,EAAS,KAAA,EAC5B,OAAAZ,EAAe,IAAIU,EAAUG,CAAI,EAC1BA,CACT,CCnDA,MAAMC,EAAwB,+CACxBC,EAAyB,EAAI,GAAK,GAAK,IACvCC,EAA2B,EAC3BC,EAAkB,IAAItC,EAC1BqC,EACAD,CACF,EAEA,SAASG,EAAcC,EAA2B,CAChD,MAAMC,MAAU,IAEhB,OAAAD,EACG,MAAM,OAAO,EACb,IAAIE,GAAQA,EAAK,KAAA,CAAM,EACvB,UAAeA,EAAK,OAAS,CAAC,EAC9B,QAAQA,GAAQ,CACf,GAAIA,EAAK,WAAW,GAAG,EACrB,OAGF,KAAM,CAACC,CAAK,EAAID,EAAK,MAAM,KAAK,EAChC,GAAI,CAACC,EACH,OAGF,MAAMC,EAAaD,EAAM,YAAA,EACrBC,IAAe,WAAaA,IAAe,OAI1C,mBAAmB,KAAKA,CAAU,GAIvCH,EAAI,IAAIG,CAAU,CACpB,CAAC,EAEI,MAAM,KAAKH,CAAG,CACvB,CAEA,eAAsBI,EACpBjB,EAAgC,GACb,CACnB,KAAM,CAAE,MAAOC,EAAY,MAAO,YAAAC,EAAa,IAAAb,EAAMkB,GACnDP,EAEF,GAAI,CAACC,EACH,MAAM,IAAI,MAAM,oCAAoC,EAGtD,MAAMG,EAASM,EAAgB,IAAIrB,CAAG,EACtC,GAAIe,IAAW,OACb,OAAOA,EAGT,MAAMC,EAAW,MAAMJ,EAAUZ,EAAKa,CAAW,EACjD,GAAI,CAACG,EAAS,GACZ,MAAM,IAAI,MAAM,mBAAmBhB,CAAG,KAAKgB,EAAS,MAAM,EAAE,EAG9D,MAAMC,EAAO,MAAMD,EAAS,KAAA,EACtBa,EAAOP,EAAcL,CAAI,EAC/B,OAAAI,EAAgB,IAAIrB,EAAK6B,CAAI,EACtBA,CACT,CCvDA,MAAMC,EAAyB,CAAC,IAAI,EAEpC,SAASC,EAAe1C,EAAe2C,EAAkC,CAMvE,MALI,GAAAA,EAAc,SAAS3C,CAAK,GAK5B,sBAAsB,KAAKA,CAAK,EAKtC,CAEA,SAAS4C,EACPC,EACAvB,EACa,CACb,GAAIoB,EAAeG,EAAKvB,EAAQ,aAAa,EAC3C,OAAOA,EAAQ,aAGjB,GAAIA,EAAQ,cAAe,CACzB,MAAMwB,EAAU,OAAOD,CAAG,EAC1B,GAAI,CAAC,OAAO,MAAMC,CAAO,EACvB,OAAOA,CAEX,CAEA,OAAOD,CACT,CAEO,SAASE,EACdC,EACA1B,EAA2B,GACZ,CACf,MAAM2B,EAAsC,CAC1C,cAAe3B,EAAQ,eAAiB,GACxC,aAAcA,EAAQ,cAAgB,KACtC,cAAeA,EAAQ,eAAiBmB,CAAA,EAG1C,OAAOO,EACJ,KAAA,EACA,MAAM,KAAK,EACX,OAAO,OAAO,EACd,IAAIhD,GAAS4C,EAAY5C,EAAOiD,CAAQ,CAAC,CAC9C,CAEA,SAASC,EAAcd,EAAce,EAAgC,CACnE,OAAOf,EAAK,WAAW,GAAGe,CAAa,GAAG,CAC5C,CAEA,SAASC,EAAelB,EAA2B,CACjD,OAAOA,EACJ,MAAM,OAAO,EACb,IAAIE,GAAQA,EAAK,KAAA,CAAM,EACvB,OAAOA,GAAQA,EAAK,OAAS,CAAC,CACnC,CAEO,SAASiB,EACdnB,EACAZ,EAAqC,GACtB,CACf,MAAM6B,EAAgB7B,EAAQ,eAAiB,IACzCgC,EAAQF,EAAelB,CAAO,EAAE,OACpCE,GAAQ,CAACc,EAAcd,EAAMe,CAAa,CAAA,EAG5C,GAAIG,EAAM,SAAW,EACnB,MAAO,CAAE,QAAS,CAAA,EAAI,MAAO,CAAA,EAAI,KAAM,CAAA,EAAI,QAAS,EAAC,EAGvD,MAAMC,EAAaD,EAAM,CAAC,GAAK,GACzBE,EAAiC,CACrC,cAAe,GACf,aAAc,KACd,cAAe,CAAA,CAAC,EAEZC,EAAUV,EAASQ,EAAYC,CAAa,EAAE,IAAI,MAAM,EAE9D,IAAIE,EAAkB,CAAA,EAClBC,EAAiB,EAErB,MAAMC,EAAWN,EAAM,CAAC,EACpBM,GAAYA,EAAS,WAAWT,CAAa,IAC/CO,EAAQX,EAASa,EAAUJ,CAAa,EAAE,IAAInB,GAAS,CACrD,MAAMwB,EAAO,OAAOxB,CAAK,EACzB,OAAOwB,EAAK,WAAWV,CAAa,EAChCU,EAAK,MAAMV,EAAc,MAAM,EAC/BU,CACN,CAAC,EACDF,EAAiB,GAGnB,MAAMG,EAA8B,CAClC,cAAexC,EAAQ,cACvB,aAAcA,EAAQ,aACtB,cAAeA,EAAQ,aAAA,EAGnByC,EAAWT,EAAM,MAAMK,CAAc,EACrCK,EAAOD,EAAS,OAAWhB,EAASkB,EAAKH,CAAU,CAAC,EAE1D,MAAO,CACL,QAAAL,EACA,MAAAC,EACA,KAAAM,EACA,QAASD,CAAA,CAEb,CAEO,SAASG,EAAeC,EAAwC,CACrE,KAAM,CAAE,QAAAV,EAAS,KAAAO,CAAA,EAASG,EAC1B,OAAOH,EAAK,IAAIC,GAAO,CACrB,MAAMG,EAAyB,CAAA,EAC/B,OAAAX,EAAQ,QAAQ,CAACY,EAAQC,IAAU,CACjCF,EAAOC,CAAM,EAAIJ,EAAIK,CAAK,GAAK,IACjC,CAAC,EACMF,CACT,CAAC,CACH,CAEO,SAASG,GAAiC,CAC/C,MAAO,CACL,eAAgB,OAAO,IACvB,IAAK,OAAO,IACZ,oBAAqB,OAAO,IAC5B,KAAM,OAAO,IACb,OAAQ,OAAO,IACf,MAAO,OAAO,IACd,iBAAkB,OAAO,IACzB,iBAAkB,OAAO,IACzB,kBAAmB,OAAO,IAC1B,MAAO,CACL,cAAe,OAAO,IACtB,kBAAmB,OAAO,IAC1B,eAAgB,OAAO,IACvB,kBAAmB,OAAO,IAC1B,mBAAoB,OAAO,IAC3B,KAAM,OAAO,GAAA,EAEf,KAAM,CACJ,aAAc,OAAO,IACrB,UAAW,OAAO,IAClB,cAAe,OAAO,GAAA,EAExB,KAAM,OAAO,GAAA,CAEjB,CAEA,MAAMC,EAA+E,CACnF,MAAO,CAACC,EAAGzE,IAAU,CACnByE,EAAE,KAAO,OAAOzE,CAAK,CACvB,EACA,GAAI,CAACyE,EAAGzE,IAAU,CAChByE,EAAE,KAAO,OAAOzE,CAAK,CACvB,EACA,GAAI,CAACyE,EAAGzE,IAAU,CAChByE,EAAE,MAAQ,OAAOzE,CAAK,CACxB,EACA,GAAI,CAACyE,EAAGzE,IAAU,CAChByE,EAAE,IAAM,OAAOzE,CAAK,CACtB,EACA,GAAI,CAACyE,EAAGzE,IAAU,CAChByE,EAAE,KAAO,OAAOzE,CAAK,CACvB,EACA,GAAI,CAACyE,EAAGzE,IAAU,CAChByE,EAAE,OAAS,OAAOzE,CAAK,CACzB,EACA,IAAK,CAACyE,EAAGzE,IAAU,CACjByE,EAAE,MAAM,cAAgB,OAAOzE,CAAK,CACtC,EACA,KAAM,CAACyE,EAAGzE,IAAU,CAClByE,EAAE,eAAiB,OAAOzE,CAAK,CACjC,EACA,KAAM,CAACyE,EAAGzE,IAAU,CAClByE,EAAE,oBAAsB,OAAOzE,CAAK,CACtC,EACA,IAAK,CAACyE,EAAGzE,IAAU,CACjByE,EAAE,MAAM,eAAiB,OAAOzE,CAAK,CACvC,EACA,IAAK,CAACyE,EAAGzE,IAAU,CACjByE,EAAE,KAAK,cAAgB,OAAOzE,CAAK,CACrC,EACA,IAAK,CAACyE,EAAGzE,IAAU,CACjByE,EAAE,MAAM,kBAAoB,OAAOzE,CAAK,CAC1C,EACA,KAAM,CAACyE,EAAGzE,IAAU,CAClByE,EAAE,iBAAmB,OAAOzE,CAAK,CACnC,EACA,KAAM,CAACyE,EAAGzE,IAAU,CAClByE,EAAE,iBAAmB,OAAOzE,CAAK,CACnC,EACA,KAAM,CAACyE,EAAGzE,IAAU,CAClByE,EAAE,MAAM,KAAO,OAAOzE,CAAK,CAC7B,EACA,IAAK,CAACyE,EAAGzE,IAAU,CACjByE,EAAE,kBAAoB,OAAOzE,CAAK,CACpC,EACA,KAAM,CAACyE,EAAGzE,IAAU,CAClByE,EAAE,KAAK,UAAY,OAAOzE,CAAK,CACjC,EACA,KAAM,CAACyE,EAAGzE,IAAU,CAClByE,EAAE,KAAK,aAAe,OAAOzE,CAAK,CACpC,EACA,KAAM,CAACyE,EAAGzE,IAAU,CAClByE,EAAE,MAAM,mBAAqB,OAAOzE,CAAK,CAC3C,EACA,KAAM,CAACyE,EAAGzE,IAAU,CAClByE,EAAE,MAAM,kBAAoB,OAAOzE,CAAK,CAC1C,CACF,EAEA,SAAS0E,EAAcN,EAAqC,CAC1D,MAAMO,EAAcJ,EAAA,EACpB,cAAO,QAAQH,CAAM,EAAE,QAAQ,CAAC,CAACQ,EAAO5E,CAAK,IAAM,CACjD,MAAM6E,EAASL,EAAeI,CAAK,EAC/BC,GACFA,EAAOF,EAAa3E,CAAK,CAE7B,CAAC,EACM2E,CACT,CAEO,SAASG,EACd7D,EACAiB,EACAZ,EAAoC,CAAA,EAC1B,CACV,MAAM6C,EAAQd,EAAmBnB,EAAS,CACxC,GAAGZ,EACH,aAAcA,EAAQ,cAAgB,OAAO,GAAA,CAC9C,EACKyD,EAAUb,EAAeC,CAAK,EAE9Ba,EAAeD,EAAQ,IAAIX,GAAUM,EAAcN,CAAM,CAAC,EAEhE,GAAI9C,EAAQ,qBAAsB,CAChC,MAAM2D,EAA2BD,EAAa,IAAI,CAACL,EAAaL,IAAU,CACxE,MAAMF,EAASW,EAAQT,CAAK,EAC5B,MAAO,CAAE,GAAGK,EAAa,GAAGP,CAAA,CAC9B,CAAC,EAED,MAAO,CACL,GAAInD,EACJ,aAAcgE,CAAA,CAElB,CAEA,MAAO,CACL,GAAIhE,EACJ,aAAA+D,CAAA,CAEJ,CC3QO,SAASE,EAAmBP,EAAgC,CACjE,KAAM,CAAE,KAAAQ,EAAM,MAAAC,EAAO,IAAAC,EAAK,KAAAC,EAAM,OAAAC,GAAWZ,EAC3C,OAAO,IAAI,KAAK,KAAK,IAAIQ,EAAMC,EAAQ,EAAGC,EAAKC,EAAMC,CAAM,CAAC,CAC9D"}

package/dist/index.d.ts

@@ -1,8 +1,10 @@
 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 { FetchBuoyListOptions } from './stations/list';
 export type { ParseRowOptions, ParseRealtimeTableOptions, ParseRealtimeDataOptions, } from './realtime/parser';
 export { fetchRealtimeData, buildRealtimeUrl } from './realtime/fetch';
+export { fetchBuoyList } from './stations/list';
 export { parseRealtimeData, parseRealtimeTable, parseRow, objectifyTable, createMeasurement, } from './realtime/parser';
 export { getMeasurementDate } from './utils/date';
 export { buildURL, formatQueryParams } from './utils/url';

package/dist/index.js

@@ -1,109 +1,175 @@
-function g(r = {}) {
+class w {
+  constructor(e, r) {
+    this.maxSize = e, this.ttlMs = r, this.items = /* @__PURE__ */ new Map();
+  }
+  get(e) {
+    const r = this.items.get(e);
+    if (!r)
+      return;
+    const n = Date.now();
+    if (r.expiresAt <= n) {
+      this.items.delete(e);
+      return;
+    }
+    return this.items.delete(e), this.items.set(e, r), r.value;
+  }
+  set(e, r) {
+    const n = Date.now();
+    this.items.has(e) && this.items.delete(e), this.items.set(e, { value: r, expiresAt: n + this.ttlMs }), this.prune(n);
+  }
+  prune(e) {
+    for (const [r, n] of this.items)
+      n.expiresAt > e || this.items.delete(r);
+    for (; this.items.size > this.maxSize; ) {
+      const r = this.items.keys().next().value;
+      if (r === void 0)
+        break;
+      this.items.delete(r);
+    }
+  }
+}
+function T(t = {}) {
   const e = new URLSearchParams();
-  for (const [n, a] of Object.entries(r))
-    if (a != null) {
-      if (Array.isArray(a)) {
-        a.forEach((i) => {
+  for (const [n, s] of Object.entries(t))
+    if (s != null) {
+      if (Array.isArray(s)) {
+        s.forEach((i) => {
           e.append(n, String(i));
         });
         continue;
       }
-      e.append(n, String(a));
+      e.append(n, String(s));
     }
-  const t = e.toString();
-  return t ? `?${t}` : "";
+  const r = e.toString();
+  return r ? `?${r}` : "";
 }
-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();
+function S(t, e = "", r = {}) {
+  const n = t.endsWith("/") ? t : `${t}/`, s = new URL(e, n), i = T(r);
+  return s.search = i, s.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);
+const p = "https://www.ndbc.noaa.gov/data/realtime2/", y = 5 * 60 * 1e3, E = 256, h = new w(
+  E,
+  y
+);
+function L(t, e = "txt", r = p) {
+  const n = `${t}.${e}`;
+  return S(r, n);
 }
-async function V(r) {
+async function W(t) {
   const {
     buoyId: e,
-    type: t = "txt",
+    type: r = "txt",
     fetch: n = fetch,
-    requestInit: a,
-    baseUrl: i = d
-  } = r;
+    requestInit: s,
+    baseUrl: i = p
+  } = t;
   if (!n)
     throw new Error("No fetch implementation available.");
-  const s = w(e, t, i), u = await n(s, a);
+  const a = `${i}|${e}|${r}`, o = h.get(a);
+  if (o !== void 0)
+    return o;
+  const c = L(e, r, i), u = await n(c, s);
   if (!u.ok)
-    throw new Error(`Failed to fetch ${s}: ${u.status}`);
-  return u.text();
+    throw new Error(`Failed to fetch ${c}: ${u.status}`);
+  const N = await u.text();
+  return h.set(a, N), N;
+}
+const A = "https://www.ndbc.noaa.gov/activestations.txt", D = 4 * 60 * 60 * 1e3, _ = 4, b = new w(
+  _,
+  D
+);
+function M(t) {
+  const e = /* @__PURE__ */ new Set();
+  return t.split(/\r?\n/).map((r) => r.trim()).filter((r) => r.length > 0).forEach((r) => {
+    if (r.startsWith("#"))
+      return;
+    const [n] = r.split(/\s+/);
+    if (!n)
+      return;
+    const s = n.toUpperCase();
+    s === "STATION" || s === "STN" || /^[A-Z0-9]{3,10}$/.test(s) && e.add(s);
+  }), Array.from(e);
+}
+async function O(t = {}) {
+  const { fetch: e = fetch, requestInit: r, url: n = A } = t;
+  if (!e)
+    throw new Error("No fetch implementation available.");
+  const s = b.get(n);
+  if (s !== void 0)
+    return s;
+  const i = await e(n, r);
+  if (!i.ok)
+    throw new Error(`Failed to fetch ${n}: ${i.status}`);
+  const a = await i.text(), o = M(a);
+  return b.set(n, o), o;
 }
-const T = ["MM"];
-function D(r, e) {
-  return !!(e.includes(r) || /^9{2,}(\.0+|\.9+)?$/.test(r));
+const P = ["MM"];
+function v(t, e) {
+  return !!(e.includes(t) || /^9{2,}(\.0+|\.9+)?$/.test(t));
 }
-function P(r, e) {
-  if (D(r, e.missingTokens))
+function I(t, e) {
+  if (v(t, e.missingTokens))
     return e.missingValue;
   if (e.coerceNumbers) {
-    const t = Number(r);
-    if (!Number.isNaN(t))
-      return t;
+    const r = Number(t);
+    if (!Number.isNaN(r))
+      return r;
   }
-  return r;
+  return t;
 }
-function l(r, e = {}) {
-  const t = {
+function f(t, e = {}) {
+  const r = {
     coerceNumbers: e.coerceNumbers ?? !0,
     missingValue: e.missingValue ?? null,
-    missingTokens: e.missingTokens ?? T
+    missingTokens: e.missingTokens ?? P
   };
-  return r.trim().split(/\s+/).filter(Boolean).map((n) => P(n, t));
+  return t.trim().split(/\s+/).filter(Boolean).map((n) => I(n, r));
 }
-function S(r, e) {
-  return r.startsWith(`${e} `);
+function U(t, e) {
+  return t.startsWith(`${e} `);
 }
-function y(r) {
-  return r.split(/\r?\n/).map((e) => e.trim()).filter((e) => e.length > 0);
+function x(t) {
+  return t.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)
+function C(t, e = {}) {
+  const r = e.commentPrefix ?? "#", n = x(t).filter(
+    (m) => !U(m, r)
   );
   if (n.length === 0)
     return { headers: [], units: [], rows: [], rawRows: [] };
-  const a = n[0] ?? "", i = {
+  const s = 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;
+  }, a = f(s, i).map(String);
+  let o = [], c = 1;
+  const u = n[1];
+  u && u.startsWith(r) && (o = f(u, i).map((m) => {
+    const l = String(m);
+    return l.startsWith(r) ? l.slice(r.length) : l;
   }), c = 2);
-  const f = {
+  const N = {
     coerceNumbers: e.coerceNumbers,
     missingValue: e.missingValue,
     missingTokens: e.missingTokens
-  }, b = n.slice(c), h = b.map((o) => l(o, f));
+  }, d = n.slice(c), g = d.map((m) => f(m, N));
   return {
-    headers: s,
-    units: u,
-    rows: h,
-    rawRows: b
+    headers: a,
+    units: o,
+    rows: g,
+    rawRows: d
   };
 }
-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 R(t) {
+  const { headers: e, rows: r } = t;
+  return r.map((n) => {
+    const s = {};
+    return e.forEach((i, a) => {
+      s[i] = n[a] ?? null;
+    }), s;
   });
 }
-function E() {
+function $() {
   return {
     airTemperature: Number.NaN,
     day: Number.NaN,
@@ -130,109 +196,110 @@ function E() {
     year: Number.NaN
   };
 }
-const L = {
-  "#YY": (r, e) => {
-    r.year = Number(e);
+const k = {
+  "#YY": (t, e) => {
+    t.year = Number(e);
   },
-  YY: (r, e) => {
-    r.year = Number(e);
+  YY: (t, e) => {
+    t.year = Number(e);
   },
-  MM: (r, e) => {
-    r.month = Number(e);
+  MM: (t, e) => {
+    t.month = Number(e);
   },
-  DD: (r, e) => {
-    r.day = Number(e);
+  DD: (t, e) => {
+    t.day = Number(e);
   },
-  hh: (r, e) => {
-    r.hour = Number(e);
+  hh: (t, e) => {
+    t.hour = Number(e);
   },
-  mm: (r, e) => {
-    r.minute = Number(e);
+  mm: (t, e) => {
+    t.minute = Number(e);
   },
-  APD: (r, e) => {
-    r.water.averagePeriod = Number(e);
+  APD: (t, e) => {
+    t.water.averagePeriod = Number(e);
   },
-  ATMP: (r, e) => {
-    r.airTemperature = Number(e);
+  ATMP: (t, e) => {
+    t.airTemperature = Number(e);
   },
-  DEWP: (r, e) => {
-    r.dewpointTemperature = Number(e);
+  DEWP: (t, e) => {
+    t.dewpointTemperature = Number(e);
   },
-  DPD: (r, e) => {
-    r.water.dominantPeriod = Number(e);
+  DPD: (t, e) => {
+    t.water.dominantPeriod = Number(e);
   },
-  GST: (r, e) => {
-    r.wind.peakGustSpeed = Number(e);
+  GST: (t, e) => {
+    t.wind.peakGustSpeed = Number(e);
   },
-  MWD: (r, e) => {
-    r.water.dominantDirection = Number(e);
+  MWD: (t, e) => {
+    t.water.dominantDirection = Number(e);
   },
-  PRES: (r, e) => {
-    r.seaLevelPressure = Number(e);
+  PRES: (t, e) => {
+    t.seaLevelPressure = Number(e);
   },
-  PTDY: (r, e) => {
-    r.pressureTendancy = Number(e);
+  PTDY: (t, e) => {
+    t.pressureTendancy = Number(e);
   },
-  TIDE: (r, e) => {
-    r.water.tide = Number(e);
+  TIDE: (t, e) => {
+    t.water.tide = Number(e);
   },
-  VIS: (r, e) => {
-    r.stationVisibility = Number(e);
+  VIS: (t, e) => {
+    t.stationVisibility = Number(e);
   },
-  WDIR: (r, e) => {
-    r.wind.direction = Number(e);
+  WDIR: (t, e) => {
+    t.wind.direction = Number(e);
   },
-  WSPD: (r, e) => {
-    r.wind.averageSpeed = Number(e);
+  WSPD: (t, e) => {
+    t.wind.averageSpeed = Number(e);
   },
-  WTMP: (r, e) => {
-    r.water.surfaceTemperature = Number(e);
+  WTMP: (t, e) => {
+    t.water.surfaceTemperature = Number(e);
   },
-  WVHT: (r, e) => {
-    r.water.significantHeight = Number(e);
+  WVHT: (t, e) => {
+    t.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);
+function V(t) {
+  const e = $();
+  return Object.entries(t).forEach(([r, n]) => {
+    const s = k[r];
+    s && s(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 };
+function B(t, e, r = {}) {
+  const n = C(e, {
+    ...r,
+    missingValue: r.missingValue ?? Number.NaN
+  }), s = R(n), i = s.map((a) => V(a));
+  if (r.includeUnknownFields) {
+    const a = i.map((o, c) => {
+      const u = s[c];
+      return { ...o, ...u };
     });
     return {
-      id: r,
-      measurements: s
+      id: t,
+      measurements: a
     };
   }
   return {
-    id: r,
+    id: t,
     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));
+function H(t) {
+  const { year: e, month: r, day: n, hour: s, minute: i } = t;
+  return new Date(Date.UTC(e, r - 1, n, s, 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
+  L as buildRealtimeUrl,
+  S as buildURL,
+  $ as createMeasurement,
+  O as fetchBuoyList,
+  W as fetchRealtimeData,
+  T as formatQueryParams,
+  H as getMeasurementDate,
+  R as objectifyTable,
+  B as parseRealtimeData,
+  C as parseRealtimeTable,
+  f as parseRow
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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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"}
+{"version":3,"file":"index.js","sources":["../src/utils/lru.ts","../src/utils/url.ts","../src/realtime/fetch.ts","../src/stations/list.ts","../src/realtime/parser.ts","../src/utils/date.ts"],"sourcesContent":["export class LruCache<K, V> {\n  private readonly items = new Map<K, { value: V; expiresAt: number }>();\n\n  constructor(\n    private readonly maxSize: number,\n    private readonly ttlMs: number,\n  ) {}\n\n  get(key: K): V | undefined {\n    const entry = this.items.get(key);\n    if (!entry) {\n      return undefined;\n    }\n\n    const now = Date.now();\n    if (entry.expiresAt <= now) {\n      this.items.delete(key);\n      return undefined;\n    }\n\n    this.items.delete(key);\n    this.items.set(key, entry);\n    return entry.value;\n  }\n\n  set(key: K, value: V): void {\n    const now = Date.now();\n    if (this.items.has(key)) {\n      this.items.delete(key);\n    }\n\n    this.items.set(key, { value, expiresAt: now + this.ttlMs });\n    this.prune(now);\n  }\n\n  private prune(now: number): void {\n    for (const [key, entry] of this.items) {\n      if (entry.expiresAt > now) {\n        continue;\n      }\n      this.items.delete(key);\n    }\n\n    while (this.items.size > this.maxSize) {\n      const oldestKey = this.items.keys().next().value as K | undefined;\n      if (oldestKey === undefined) {\n        break;\n      }\n      this.items.delete(oldestKey);\n    }\n  }\n}\n","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 { LruCache } from '../utils/lru';\nimport { 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/';\nconst CACHE_TTL_MS = 5 * 60 * 1000;\nconst CACHE_MAX_SIZE = 256;\nconst REALTIME_CACHE = new LruCache<string, string>(\n  CACHE_MAX_SIZE,\n  CACHE_TTL_MS,\n);\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 cacheKey = `${baseUrl}|${buoyId}|${type}`;\n  const cached = REALTIME_CACHE.get(cacheKey);\n  if (cached !== undefined) {\n    return cached;\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  const body = await response.text();\n  REALTIME_CACHE.set(cacheKey, body);\n  return body;\n}\n","import { LruCache } from '../utils/lru';\n\nexport interface FetchBuoyListOptions {\n  fetch?: typeof fetch;\n  requestInit?: RequestInit;\n  url?: string;\n}\n\nconst DEFAULT_BUOY_LIST_URL = 'https://www.ndbc.noaa.gov/activestations.txt';\nconst BUOY_LIST_CACHE_TTL_MS = 4 * 60 * 60 * 1000;\nconst BUOY_LIST_CACHE_MAX_SIZE = 4;\nconst BUOY_LIST_CACHE = new LruCache<string, string[]>(\n  BUOY_LIST_CACHE_MAX_SIZE,\n  BUOY_LIST_CACHE_TTL_MS,\n);\n\nfunction parseBuoyList(rawText: string): string[] {\n  const ids = new Set<string>();\n\n  rawText\n    .split(/\\r?\\n/)\n    .map(line => line.trim())\n    .filter(line => line.length > 0)\n    .forEach(line => {\n      if (line.startsWith('#')) {\n        return;\n      }\n\n      const [token] = line.split(/\\s+/);\n      if (!token) {\n        return;\n      }\n\n      const normalized = token.toUpperCase();\n      if (normalized === 'STATION' || normalized === 'STN') {\n        return;\n      }\n\n      if (!/^[A-Z0-9]{3,10}$/.test(normalized)) {\n        return;\n      }\n\n      ids.add(normalized);\n    });\n\n  return Array.from(ids);\n}\n\nexport async function fetchBuoyList(\n  options: FetchBuoyListOptions = {},\n): Promise<string[]> {\n  const { fetch: fetchImpl = fetch, requestInit, url = DEFAULT_BUOY_LIST_URL } =\n    options;\n\n  if (!fetchImpl) {\n    throw new Error('No fetch implementation available.');\n  }\n\n  const cached = BUOY_LIST_CACHE.get(url);\n  if (cached !== undefined) {\n    return cached;\n  }\n\n  const response = await fetchImpl(url, requestInit);\n  if (!response.ok) {\n    throw new Error(`Failed to fetch ${url}: ${response.status}`);\n  }\n\n  const body = await response.text();\n  const list = parseBuoyList(body);\n  BUOY_LIST_CACHE.set(url, list);\n  return list;\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":["LruCache","maxSize","ttlMs","key","entry","now","value","oldestKey","formatQueryParams","params","searchParams","item","query","buildURL","base","path","normalizedBase","url","DEFAULT_BASE_URL","CACHE_TTL_MS","CACHE_MAX_SIZE","REALTIME_CACHE","buildRealtimeUrl","buoyId","type","baseUrl","filename","fetchRealtimeData","options","fetchImpl","requestInit","cacheKey","cached","response","body","DEFAULT_BUOY_LIST_URL","BUOY_LIST_CACHE_TTL_MS","BUOY_LIST_CACHE_MAX_SIZE","BUOY_LIST_CACHE","parseBuoyList","rawText","ids","line","token","normalized","fetchBuoyList","list","DEFAULT_MISSING_TOKENS","isMissingToken","missingTokens","coerceValue","raw","numeric","parseRow","rawRow","resolved","isCommentLine","commentPrefix","normalizeLines","parseRealtimeTable","lines","headerLine","headerOptions","headers","units","dataStartIndex","unitLine","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/stations/list.d.ts

@@ -0,0 +1,6 @@
+export interface FetchBuoyListOptions {
+    fetch?: typeof fetch;
+    requestInit?: RequestInit;
+    url?: string;
+}
+export declare function fetchBuoyList(options?: FetchBuoyListOptions): Promise<string[]>;

package/dist/utils/lru.d.ts

@@ -0,0 +1,9 @@
+export declare class LruCache<K, V> {
+    private readonly maxSize;
+    private readonly ttlMs;
+    private readonly items;
+    constructor(maxSize: number, ttlMs: number);
+    get(key: K): V | undefined;
+    set(key: K, value: V): void;
+    private prune;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "buoydata",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Modern TypeScript SDK for NDBC realtime buoy data.",
   "type": "module",
   "main": "./dist/index.cjs",