airport-utils 1.3.29 → 1.4.1

package/README.md

@@ -7,9 +7,9 @@ Convert local ISO 8601 timestamps to UTC using airport IATA codes, with airport
 - **Local → UTC** conversion only (ISO 8601 in, ISO 8601 UTC out)
 - Built-in IATA→IANA timezone mapping (OPTD)
 - Built-in airport geo-data: latitude, longitude, name, city, country, country name
-- TypeScript support, Node 20+
+- TypeScript support, Node 22+
 - Synchronous API with custom error classes
-- Day.js (UTC & Timezone plugins) under the hood
+- `@date-fns/tz` under the hood
 - Daily auto-updated mapping via GitHub Actions
 - Jest tests with 100% coverage
 - Automated releases via semantic-release
@@ -38,6 +38,7 @@ try {
   console.log(utc); // "2025-05-02T18:30:00Z"
 } catch (err) {
   // handle UnknownAirportError or InvalidTimestampError
+  // InvalidTimestampError is also thrown for nonexistent or ambiguous DST wall-clock times
 }
 
 // Convert local time by zone
@@ -46,6 +47,7 @@ try {
   console.log(utc2); // "2025-05-02T13:30:00Z"
 } catch (err) {
   // handle UnknownTimezoneError or InvalidTimestampError
+  // InvalidTimestampError is also thrown for nonexistent or ambiguous DST wall-clock times
 }
 
 // Get full airport info
@@ -69,7 +71,7 @@ try {
 // Get all airports
 import { getAllAirports } from 'airport-utils';
 const airports = getAllAirports();
-console.log(airports.length); // > 10000
+console.log(airports.length); // > 8000
 ```
 
 ### API
@@ -141,4 +143,4 @@ npm run update:mapping
 
 ## License
 
-MIT
+MIT

package/dist/cjs/converter.cjs

@@ -6,6 +6,7 @@ var errors = require('./errors.cjs');
 
 const ISO_LOCAL_RE = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2})(?::(\d{2}))?$/;
 const VALID_TIMEZONE_CACHE = new Map();
+const INVALID_LOCAL_INTERVAL_CACHE = new Map();
 function isLeapYear(year) {
     return (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
 }
@@ -54,19 +55,75 @@ function assertValidTimezone(timeZone) {
         throw new errors.UnknownTimezoneError(timeZone);
     }
 }
+function localPartsToNaiveUtcMs(parts) {
+    const [year, month, day, hour, minute, second] = parts;
+    return Date.UTC(year, month, day, hour, minute, second);
+}
+function resolveUtcMs(localNaiveMs, timeZone) {
+    let utcMs = localNaiveMs;
+    for (let i = 0; i < 4; i++) {
+        const offsetMinutes = tz.tzOffset(timeZone, new Date(utcMs));
+        if (!Number.isFinite(offsetMinutes)) {
+            throw new RangeError(`Invalid timezone offset for: ${timeZone}`);
+        }
+        const nextUtcMs = localNaiveMs - offsetMinutes * 60_000;
+        if (nextUtcMs === utcMs)
+            return utcMs;
+        utcMs = nextUtcMs;
+    }
+    return utcMs;
+}
+function getInvalidLocalIntervals(timeZone, year) {
+    const cacheKey = `${timeZone}:${year}`;
+    const cached = INVALID_LOCAL_INTERVAL_CACHE.get(cacheKey);
+    if (cached)
+        return cached;
+    const yearStart = Date.UTC(year, 0, 1, 0, 0, 0);
+    const yearEnd = Date.UTC(year + 1, 0, 1, 0, 0, 0);
+    const transitions = tz.tzScan(timeZone, {
+        start: new Date(Date.UTC(year - 1, 11, 31, 0, 0, 0)),
+        end: new Date(Date.UTC(year + 1, 0, 2, 0, 0, 0))
+    });
+    const intervals = transitions
+        .map((transition) => {
+        const previousOffset = transition.offset - transition.change;
+        if (transition.change < 0) {
+            return {
+                start: transition.date.getTime() + transition.offset * 60_000,
+                end: transition.date.getTime() + previousOffset * 60_000
+            };
+        }
+        return {
+            start: transition.date.getTime() + previousOffset * 60_000,
+            end: transition.date.getTime() + transition.offset * 60_000
+        };
+    })
+        .filter((interval) => interval.end > yearStart && interval.start < yearEnd);
+    INVALID_LOCAL_INTERVAL_CACHE.set(cacheKey, intervals);
+    return intervals;
+}
+function assertResolvableLocalTime(localIso, timeZone, year, localNaiveMs) {
+    const intervals = getInvalidLocalIntervals(timeZone, year);
+    for (const interval of intervals) {
+        if (localNaiveMs >= interval.start && localNaiveMs < interval.end) {
+            throw new errors.InvalidTimestampError(localIso);
+        }
+    }
+}
 function toUtcIso(localIso, timeZone, onTimeZoneError) {
-    const [year, month, day, hour, minute, second] = parseLocalIsoStrict(localIso);
-    let zoned;
+    const parts = parseLocalIsoStrict(localIso);
+    const [year] = parts;
+    const localNaiveMs = localPartsToNaiveUtcMs(parts);
+    assertResolvableLocalTime(localIso, timeZone, year, localNaiveMs);
+    let utcMs;
     try {
-        zoned = tz.TZDate.tz(timeZone, year, month, day, hour, minute, second);
+        utcMs = resolveUtcMs(localNaiveMs, timeZone);
     }
     catch (err) {
         throw onTimeZoneError(err);
     }
-    if (isNaN(zoned.getTime()))
-        throw new errors.InvalidTimestampError(localIso);
     // Strip ".000" from the ISO string
-    return new Date(zoned.getTime()).toISOString().replace('.000Z', 'Z');
+    return new Date(utcMs).toISOString().replace('.000Z', 'Z');
 }
 /**
  * Convert a local ISO‐8601 string at an airport (IATA) into a UTC ISO string.

package/dist/cjs/info.cjs

@@ -4,6 +4,7 @@ var timezones = require('./mapping/timezones.cjs');
 var geo = require('./mapping/geo.cjs');
 var errors = require('./errors.cjs');
 
+const GEO_IATAS = Object.keys(geo.geo);
 /** @throws UnknownAirportError */
 function getAirportInfo(iata) {
     const tz = timezones.timezones[iata];
@@ -14,7 +15,7 @@ function getAirportInfo(iata) {
 }
 function getAllAirports() {
     const all = [];
-    for (const iata of Object.keys(geo.geo)) {
+    for (const iata of GEO_IATAS) {
         const tz = timezones.timezones[iata];
         const g = geo.geo[iata];
         if (!tz || !g)