airport-utils 1.0.28 → 1.3.0

package/.editorconfig

@@ -0,0 +1,12 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_style = space
+indent_size = 2
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false

package/.github/workflows/ci.yml

@@ -5,9 +5,11 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v3
-      - uses: actions/setup-node@v3
+      - uses: actions/setup-node@v4
         with:
-          node-version: '20'
+          node-version-file: '.nvmrc'
       - run: npm ci
+      - run: npm run lint
+      - run: npm run format:check
       - run: npm run build
-      - run: npm test
+      - run: npm test

package/.github/workflows/publish.yml

@@ -10,6 +10,7 @@ jobs:
     runs-on: ubuntu-latest
     permissions:
       contents: write
+      id-token: write
 
     steps:
       - name: Check out code
@@ -34,6 +35,12 @@ jobs:
       - name: Install dependencies
         run: npm ci
 
+      - name: Lint
+        run: npm run lint
+
+      - name: Format check
+        run: npm run format:check
+
       - name: Build
         run: npm run build
 
@@ -44,4 +51,4 @@ jobs:
         env:
           NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: npx semantic-release
+        run: npx semantic-release

package/.github/workflows/update-mapping.yml

@@ -30,7 +30,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '20'
+          node-version-file: '.nvmrc'
 
       - name: Install dependencies
         run: npm ci

package/.prettierrc.json

@@ -0,0 +1,6 @@
+{
+  "singleQuote": true,
+  "semi": true,
+  "trailingComma": "none",
+  "printWidth": 100
+}

package/README.md

@@ -6,7 +6,7 @@ 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
+- Built-in airport geo-data: latitude, longitude, name, city, country, country name
 - TypeScript support, Node 20+
 - Synchronous API with custom error classes
 - Day.js (UTC & Timezone plugins) under the hood
@@ -58,11 +58,18 @@ try {
   //   longitude: -73.7781,
   //   name: 'John F. Kennedy International Airport',
   //   city: 'New York',
-  //   country: 'US'
+  //   country: 'US',
+  //   countryName: 'United States',
+  //   continent: 'North America'
   // }
 } catch (err) {
   // handle UnknownAirportError
 }
+
+// Get all airports
+import { getAllAirports } from 'airport-utils';
+const airports = getAllAirports();
+console.log(airports.length); // > 10000
 ```
 
 ### API
@@ -85,8 +92,22 @@ export function getAirportInfo(iata: string): {
   name: string;
   city: string;
   country: string;
+  countryName: string;
+  continent: string;
 };
 
+export function getAllAirports(): {
+  iata: string;
+  timezone: string;
+  latitude: number;
+  longitude: number;
+  name: string;
+  city: string;
+  country: string;
+  countryName: string;
+  continent: string;
+}[];
+
 export class UnknownAirportError extends Error {}
 export class InvalidTimestampError extends Error {}
 export class UnknownTimezoneError extends Error {}

package/dist/cjs/converter.js

@@ -1,78 +1,91 @@
 'use strict';
 
-var dateFns = require('date-fns');
 var tz = require('@date-fns/tz');
 var timezones = require('./mapping/timezones.js');
 var errors = require('./errors.js');
 
 const ISO_LOCAL_RE = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2})(?::(\d{2}))?$/;
-function parseLocalIso(localIso) {
+const VALID_TIMEZONE_CACHE = new Map();
+function isLeapYear(year) {
+    return (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
+}
+function daysInMonth(year, month) {
+    if (month === 1)
+        return isLeapYear(year) ? 29 : 28;
+    if (month === 3 || month === 5 || month === 8 || month === 10)
+        return 30;
+    return 31;
+}
+function parseLocalIsoStrict(localIso) {
     const m = ISO_LOCAL_RE.exec(localIso);
     if (!m)
         throw new errors.InvalidTimestampError(localIso);
     const [, Y, Mo, D, h, mi, s] = m;
-    return [
-        Number(Y),
-        Number(Mo) - 1,
-        Number(D),
-        Number(h),
-        Number(mi),
-        s ? Number(s) : 0
-    ];
-}
-/**
- * Convert a local ISO‐8601 string at an airport (IATA) into a UTC ISO string.
- * Always emits "YYYY-MM-DDTHH:mm:ssZ" (no milliseconds).
- */
-function convertToUTC(localIso, iata) {
-    const tz$1 = timezones.timezones[iata];
-    if (!tz$1)
-        throw new errors.UnknownAirportError(iata);
-    // Quick semantic check
-    const base = dateFns.parseISO(localIso);
-    if (isNaN(base.getTime()))
+    const year = Number(Y);
+    const month = Number(Mo) - 1;
+    const day = Number(D);
+    const hour = Number(h);
+    const minute = Number(mi);
+    const second = s ? Number(s) : 0;
+    if (month < 0 || month > 11)
         throw new errors.InvalidTimestampError(localIso);
-    const [year, month, day, hour, minute, second] = parseLocalIso(localIso);
-    let zoned;
-    try {
-        zoned = tz.TZDate.tz(tz$1, year, month, day, hour, minute, second);
-    }
-    catch {
+    if (day < 1 || day > daysInMonth(year, month))
         throw new errors.InvalidTimestampError(localIso);
-    }
-    if (isNaN(zoned.getTime()))
+    if (hour < 0 || hour > 23)
         throw new errors.InvalidTimestampError(localIso);
-    // Strip ".000" from the ISO string
-    return new Date(zoned.getTime()).toISOString().replace('.000Z', 'Z');
+    if (minute < 0 || minute > 59)
+        throw new errors.InvalidTimestampError(localIso);
+    if (second < 0 || second > 59)
+        throw new errors.InvalidTimestampError(localIso);
+    return [year, month, day, hour, minute, second];
 }
-/**
- * Convert a local ISO‐8601 string in any IANA timezone into a UTC ISO string.
- * Always emits "YYYY-MM-DDTHH:mm:ssZ" (no milliseconds).
- */
-function convertLocalToUTCByZone(localIso, timeZone) {
-    // Validate timezone
+function assertValidTimezone(timeZone) {
+    const cached = VALID_TIMEZONE_CACHE.get(timeZone);
+    if (cached === true)
+        return;
+    if (cached === false)
+        throw new errors.UnknownTimezoneError(timeZone);
     try {
         new Intl.DateTimeFormat('en-US', { timeZone }).format();
+        VALID_TIMEZONE_CACHE.set(timeZone, true);
     }
     catch {
+        VALID_TIMEZONE_CACHE.set(timeZone, false);
         throw new errors.UnknownTimezoneError(timeZone);
     }
-    // Quick semantic check
-    const base = dateFns.parseISO(localIso);
-    if (isNaN(base.getTime()))
-        throw new errors.InvalidTimestampError(localIso);
-    const [year, month, day, hour, minute, second] = parseLocalIso(localIso);
+}
+function toUtcIso(localIso, timeZone, onTimeZoneError) {
+    const [year, month, day, hour, minute, second] = parseLocalIsoStrict(localIso);
     let zoned;
     try {
         zoned = tz.TZDate.tz(timeZone, year, month, day, hour, minute, second);
     }
-    catch {
-        throw new errors.UnknownTimezoneError(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');
 }
+/**
+ * Convert a local ISO‐8601 string at an airport (IATA) into a UTC ISO string.
+ * Always emits "YYYY-MM-DDTHH:mm:ssZ" (no milliseconds).
+ */
+function convertToUTC(localIso, iata) {
+    const tz = timezones.timezones[iata];
+    if (!tz)
+        throw new errors.UnknownAirportError(iata);
+    return toUtcIso(localIso, tz, () => new errors.InvalidTimestampError(localIso));
+}
+/**
+ * Convert a local ISO‐8601 string in any IANA timezone into a UTC ISO string.
+ * Always emits "YYYY-MM-DDTHH:mm:ssZ" (no milliseconds).
+ */
+function convertLocalToUTCByZone(localIso, timeZone) {
+    assertValidTimezone(timeZone);
+    return toUtcIso(localIso, timeZone, () => new errors.UnknownTimezoneError(timeZone));
+}
 
 exports.convertLocalToUTCByZone = convertLocalToUTCByZone;
 exports.convertToUTC = convertToUTC;

package/dist/cjs/index.js

@@ -9,6 +9,7 @@ var errors = require('./errors.js');
 exports.convertLocalToUTCByZone = converter.convertLocalToUTCByZone;
 exports.convertToUTC = converter.convertToUTC;
 exports.getAirportInfo = info.getAirportInfo;
+exports.getAllAirports = info.getAllAirports;
 exports.InvalidTimestampError = errors.InvalidTimestampError;
 exports.UnknownAirportError = errors.UnknownAirportError;
 exports.UnknownTimezoneError = errors.UnknownTimezoneError;

package/dist/cjs/info.js

@@ -12,5 +12,17 @@ function getAirportInfo(iata) {
         throw new errors.UnknownAirportError(iata);
     return { timezone: tz, ...g };
 }
+function getAllAirports() {
+    const all = [];
+    for (const iata of Object.keys(geo.geo)) {
+        const tz = timezones.timezones[iata];
+        const g = geo.geo[iata];
+        if (!tz || !g)
+            continue;
+        all.push({ iata, timezone: tz, ...g });
+    }
+    return all;
+}
 
 exports.getAirportInfo = getAirportInfo;
+exports.getAllAirports = getAllAirports;