@aeroswarm/weather 0.1.2 → 0.1.3

package/dist/index.d.ts

@@ -5,6 +5,7 @@ export * from "./conditions.js";
 export * from "./grid.js";
 export * from "./metar.js";
 export * from "./taf.js";
+export * from "./store.js";
 export * from "./time.js";
 export * from "./types.js";
 /**

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAE3B;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,IAAiB,GAC3B,MAAM,EAAE,CAUV"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAE3B;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,IAAiB,GAC3B,MAAM,EAAE,CAUV"}

package/dist/index.js

@@ -766,6 +766,220 @@ function decodeGridJson(input, fallback) {
   throw new Error("Format medan tidak dikenal: harus grib2json, JSON grid {bounds,nx,ny,u,v|values}, atau respons banyak lokasi");
 }
 
+// src/store.ts
+var MAX_OBSERVATIONS_PER_STATION = 48;
+var MAX_FORECASTS_PER_STATION = 8;
+var rainRate = (intensity) => intensity * intensity * 15;
+var hhmm = (d) => `${String(d.getUTCHours()).padStart(2, "0")}:${String(d.getUTCMinutes()).padStart(2, "0")}`;
+var WeatherStore = class {
+  constructor(locate) {
+    this.locate = locate;
+  }
+  locate;
+  observations = /* @__PURE__ */ new Map();
+  forecasts = /* @__PURE__ */ new Map();
+  listeners = /* @__PURE__ */ new Set();
+  /** Naik tiap data berubah; berguna untuk memicu render ulang. */
+  version = 0;
+  /** Terima pesan mentah (laporan polos, buletin, atau pesan AFTN; boleh banyak laporan). */
+  ingest(message, options = {}) {
+    const receivedAt = options.receivedAt ?? /* @__PURE__ */ new Date();
+    const manual = options.manual === true;
+    const result = { metars: 0, tafs: 0, skipped: 0, stations: [] };
+    const touched = /* @__PURE__ */ new Set();
+    for (const raw of extractReports(message)) {
+      if (raw.kind === "TAF") {
+        const taf = parseTaf(raw.text, receivedAt);
+        if (!taf) {
+          result.skipped++;
+          continue;
+        }
+        this.add(this.forecasts, taf.station, { report: taf, manual, receivedAt }, MAX_FORECASTS_PER_STATION);
+        touched.add(taf.station);
+        result.tafs++;
+      } else {
+        const metar = parseMetar(raw.text, receivedAt);
+        if (!metar) {
+          result.skipped++;
+          continue;
+        }
+        this.add(this.observations, metar.station, { report: metar, manual, receivedAt }, MAX_OBSERVATIONS_PER_STATION);
+        touched.add(metar.station);
+        result.metars++;
+      }
+    }
+    result.stations = [...touched];
+    if (result.metars + result.tafs > 0) this.changed();
+    return result;
+  }
+  /** Hapus semua data manual (seluruh stasiun, atau satu stasiun). */
+  clearManual(station) {
+    let removed = false;
+    for (const store of [this.observations, this.forecasts]) {
+      for (const [icao, list] of store) {
+        if (station && icao !== station) continue;
+        const kept = list.filter((s) => !s.manual);
+        if (kept.length !== list.length) removed = true;
+        store.set(icao, kept);
+      }
+    }
+    if (removed) this.changed();
+  }
+  /** Hapus semua data (otomatis dan manual). */
+  clear() {
+    this.observations.clear();
+    this.forecasts.clear();
+    this.changed();
+  }
+  hasManual() {
+    for (const store of [this.observations, this.forecasts]) {
+      for (const list of store.values()) if (list.some((s) => s.manual)) return true;
+    }
+    return false;
+  }
+  stations() {
+    return [.../* @__PURE__ */ new Set([...this.observations.keys(), ...this.forecasts.keys()])].filter(
+      (icao) => (this.observations.get(icao)?.length ?? 0) + (this.forecasts.get(icao)?.length ?? 0) > 0
+    );
+  }
+  onChange(listener) {
+    this.listeners.add(listener);
+    return () => this.listeners.delete(listener);
+  }
+  /** Cuaca satu stasiun pada waktu `at`; null bila tidak ada data. */
+  snapshotAt(station, at, options = {}) {
+    return animationSnapshot({
+      observation: this.pickObservation(station, at, options.maxObservationAgeMs),
+      forecast: this.pickForecast(station, at),
+      at,
+      maxObservationAgeMs: options.maxObservationAgeMs,
+      includeProbable: options.includeProbable
+    });
+  }
+  /** Rentang waktu dan pembagian periode (BASE/BECMG/TEMPO/FM) dari TAF, untuk timeline. */
+  timeline() {
+    const segments = [];
+    const observations = [];
+    let from = null;
+    let to = null;
+    const widen = (a, b) => {
+      from = from === null ? a.getTime() : Math.min(from, a.getTime());
+      to = to === null ? b.getTime() : Math.max(to, b.getTime());
+    };
+    for (const [station, list] of this.forecasts) {
+      const taf = this.latest(list, (t) => t.issuedAt);
+      if (!taf || taf.cancelled) continue;
+      widen(taf.validFrom, taf.validTo);
+      for (const period of taf.periods) {
+        if (period.change === "BASE") continue;
+        const label = period.change === "FM" ? `FM ${hhmm(period.from)}` : `${period.probability ? `PROB${period.probability} ` : ""}${period.change} ${hhmm(period.from)}-${hhmm(period.to)}`;
+        segments.push({ station, change: period.change, from: period.from, to: period.to, label });
+      }
+    }
+    for (const list of this.observations.values()) {
+      for (const source of list) {
+        observations.push(source.report.observedAt);
+        widen(source.report.observedAt, source.report.observedAt);
+      }
+    }
+    if (from === null || to === null) return null;
+    observations.sort((a, b) => a.getTime() - b.getTime());
+    return { from: new Date(from), to: new Date(to), segments, observations };
+  }
+  /**
+   * Medan angin, awan, hujan, dan suhu pada waktu `at`, dari semua stasiun yang punya data dan
+   * koordinat, diinterpolasi ke grid. Mengembalikan null bila tidak ada stasiun yang bisa dipakai.
+   */
+  fieldsAt(at, grid, options = {}) {
+    const winds = [];
+    const clouds = [];
+    const rains = [];
+    const temperatures = [];
+    const used = [];
+    for (const station of this.stations()) {
+      const place = this.locate(station);
+      if (!place) continue;
+      const snapshot = this.snapshotAt(station, at, options);
+      if (!snapshot) continue;
+      used.push(station);
+      const { state } = snapshot;
+      winds.push({
+        lat: place.lat,
+        lon: place.lon,
+        speedKt: state.wind.speedKt,
+        directionDeg: state.wind.fromDeg
+      });
+      clouds.push({ lat: place.lat, lon: place.lon, value: state.clouds.total * 100 });
+      rains.push({
+        lat: place.lat,
+        lon: place.lon,
+        value: state.precipitation ? rainRate(state.precipitation.intensity) : 0
+      });
+      const observed = this.pickObservation(station, at);
+      if (observed?.temperatureC !== null && observed?.temperatureC !== void 0) {
+        temperatures.push({ lat: place.lat, lon: place.lon, value: observed.temperatureC });
+      }
+    }
+    if (used.length === 0) return null;
+    return {
+      at,
+      stations: used,
+      wind: windGridFromStations(winds, grid),
+      cloud: interpolateScalar(clouds, grid),
+      rain: interpolateScalar(rains, grid),
+      temperature: temperatures.length > 0 ? interpolateScalar(temperatures, grid) : null
+    };
+  }
+  // ---- internal -------------------------------------------------------------
+  changed() {
+    this.version++;
+    for (const listener of this.listeners) listener();
+  }
+  add(store, station, source, limit) {
+    const list = store.get(station) ?? [];
+    const key = (s) => {
+      const report = s.report;
+      return (report.observedAt ?? report.issuedAt)?.getTime() ?? 0;
+    };
+    const next = list.filter((s) => !(s.manual === source.manual && key(s) === key(source)));
+    next.push(source);
+    next.sort((a, b) => key(a) - key(b));
+    store.set(station, next.slice(-limit));
+  }
+  latest(list, timeOf) {
+    const pool = list.some((s) => s.manual) ? list.filter((s) => s.manual) : list;
+    let best = null;
+    for (const source of pool) {
+      if (!best || timeOf(source.report).getTime() >= timeOf(best.report).getTime()) best = source;
+    }
+    return best?.report ?? null;
+  }
+  pickObservation(station, at, maxAgeMs = 3 * 36e5) {
+    const list = this.observations.get(station) ?? [];
+    const usable = (s) => {
+      const age = at.getTime() - s.report.observedAt.getTime();
+      return age >= 0 && age <= maxAgeMs;
+    };
+    const manual = list.filter((s) => s.manual && usable(s));
+    const pool = manual.length > 0 ? manual : list.filter(usable);
+    let best = null;
+    for (const source of pool) {
+      if (!best || source.report.observedAt.getTime() >= best.report.observedAt.getTime()) best = source;
+    }
+    if (best) return best.report;
+    const before = list.filter((s) => s.report.observedAt.getTime() <= at.getTime());
+    return before.length > 0 ? before[before.length - 1].report : null;
+  }
+  pickForecast(station, at) {
+    const list = this.forecasts.get(station) ?? [];
+    const covers = (s) => !s.report.cancelled && at.getTime() >= s.report.validFrom.getTime() && at.getTime() < s.report.validTo.getTime();
+    const manual = list.filter((s) => s.manual && covers(s));
+    const pool = manual.length > 0 ? manual : list.filter(covers);
+    if (pool.length === 0) return null;
+    return this.latest(pool, (t) => t.issuedAt);
+  }
+};
+
 // src/index.ts
 function decodeWeatherMessage(message, reference = /* @__PURE__ */ new Date()) {
   const reports = [];
@@ -776,6 +990,7 @@ function decodeWeatherMessage(message, reference = /* @__PURE__ */ new Date()) {
   return reports;
 }
 export {
+  WeatherStore,
   animationFromConditions,
   animationSnapshot,
   blendConditions,

package/dist/store.d.ts

@@ -0,0 +1,91 @@
+import { type AnimationSnapshot } from "./animation.js";
+import { type GeoPoint, type GridBounds, type ScalarGrid, type WindGrid } from "./grid.js";
+import type { TafChange } from "./types.js";
+export type Locate = (icao: string) => GeoPoint | undefined;
+export interface IngestOptions {
+    /** Waktu pesan diterima (menentukan bulan/tahun laporan). Bawaan: sekarang. */
+    receivedAt?: Date;
+    /** Data manual selalu menimpa data otomatis untuk stasiun dan waktu yang sama. */
+    manual?: boolean;
+}
+export interface IngestResult {
+    metars: number;
+    tafs: number;
+    /** Laporan yang dikenali kata kuncinya tetapi tidak terbaca. */
+    skipped: number;
+    stations: string[];
+}
+export interface TimelineSegment {
+    station: string;
+    change: TafChange;
+    from: Date;
+    to: Date;
+    label: string;
+}
+export interface Timeline {
+    from: Date;
+    to: Date;
+    segments: TimelineSegment[];
+    /** Waktu pengamatan (METAR/SPECI) yang ada. */
+    observations: Date[];
+}
+export interface WeatherFields {
+    at: Date;
+    /** Stasiun yang punya data pada waktu itu. */
+    stations: string[];
+    wind: WindGrid;
+    /** Tutupan awan 0-100. */
+    cloud: ScalarGrid;
+    /** Curah hujan (mm/jam), perkiraan dari intensitas pada laporan. */
+    rain: ScalarGrid;
+    /** Suhu (°C); null bila tidak ada pengamatan bersuhu. */
+    temperature: ScalarGrid | null;
+}
+export interface FieldGridOptions {
+    bounds: GridBounds;
+    nx: number;
+    ny: number;
+    maxDistanceKm?: number;
+}
+/**
+ * Menampung laporan cuaca (METAR, SPECI, TAF) dari mana pun, lalu menjawab "bagaimana cuacanya di
+ * waktu T": per stasiun maupun sebagai medan grid. Data manual selalu menimpa data otomatis.
+ */
+export declare class WeatherStore {
+    private readonly locate;
+    private readonly observations;
+    private readonly forecasts;
+    private readonly listeners;
+    /** Naik tiap data berubah; berguna untuk memicu render ulang. */
+    version: number;
+    constructor(locate: Locate);
+    /** Terima pesan mentah (laporan polos, buletin, atau pesan AFTN; boleh banyak laporan). */
+    ingest(message: string, options?: IngestOptions): IngestResult;
+    /** Hapus semua data manual (seluruh stasiun, atau satu stasiun). */
+    clearManual(station?: string): void;
+    /** Hapus semua data (otomatis dan manual). */
+    clear(): void;
+    hasManual(): boolean;
+    stations(): string[];
+    onChange(listener: () => void): () => void;
+    /** Cuaca satu stasiun pada waktu `at`; null bila tidak ada data. */
+    snapshotAt(station: string, at: Date, options?: {
+        maxObservationAgeMs?: number;
+        includeProbable?: boolean;
+    }): AnimationSnapshot | null;
+    /** Rentang waktu dan pembagian periode (BASE/BECMG/TEMPO/FM) dari TAF, untuk timeline. */
+    timeline(): Timeline | null;
+    /**
+     * Medan angin, awan, hujan, dan suhu pada waktu `at`, dari semua stasiun yang punya data dan
+     * koordinat, diinterpolasi ke grid. Mengembalikan null bila tidak ada stasiun yang bisa dipakai.
+     */
+    fieldsAt(at: Date, grid: FieldGridOptions, options?: {
+        includeProbable?: boolean;
+    }): WeatherFields | null;
+    private changed;
+    private add;
+    private latest;
+    private pickObservation;
+    private pickForecast;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

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

package/dist/store.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=store.test.d.ts.map

package/dist/store.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.test.d.ts","sourceRoot":"","sources":["../src/store.test.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aeroswarm/weather",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Decode raw AFTN/METAR/SPECI/TAF messages and turn them into animation parameters.",
   "type": "module",
   "main": "./dist/index.js",