airport-utils 1.0.0 → 1.0.2

package/.github/dependabot.yml

@@ -8,3 +8,6 @@ updates:
     labels:
       - "dependencies"                    # Attach this label
     versioning-strategy: "auto"           # Allow patch, minor & major bumps
+    commit-message:
+      prefix: "chore(deps)"
+      include: scope

package/.github/workflows/ci.yml

@@ -1,5 +1,5 @@
 name: CI
-on: [push, pull_request]
+on: [pull_request]
 jobs:
   build-and-test:
     runs-on: ubuntu-latest

package/.github/workflows/pr-maintain.yml

@@ -0,0 +1,118 @@
+name: Maintain Bot PRs
+
+on:
+  pull_request_target:
+    types: [opened, reopened, synchronize, ready_for_review]
+  schedule:
+    - cron: "*/30 * * * *"
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: write
+
+concurrency:
+  group: bot-pr-maintenance
+  cancel-in-progress: false
+
+env:
+  BOT_TOKEN: ${{ secrets.BOT_MAINTAINER_TOKEN != '' && secrets.BOT_MAINTAINER_TOKEN || secrets.GITHUB_TOKEN }}
+  APPROVED_BOTS: '["dependabot[bot]","github-actions[bot]"]'
+
+jobs:
+  maintain:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Determine PR number (if event is a PR)
+        id: pr
+        run: |
+          if [ "${{ github.event.pull_request.number }}" != "" ]; then
+            echo "number=${{ github.event.pull_request.number }}" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Update the PR branch to latest base
+        if: ${{ steps.pr.outputs.number != '' || github.event_name == 'schedule' || github.event_name == 'workflow_dispatch' }}
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ env.BOT_TOKEN }}
+          script: |
+            const owner = context.repo.owner;
+            const repo = context.repo.repo;
+            const APPROVED_BOTS = JSON.parse(process.env.APPROVED_BOTS);
+
+            async function updateOne(number) {
+              const { data: pr } = await github.rest.pulls.get({ owner, repo, pull_number: number });
+              if (!APPROVED_BOTS.includes(pr.user.login) || pr.state !== 'open') return;
+              try {
+                await github.rest.pulls.updateBranch({ owner, repo, pull_number: number });
+                core.info(`Updated branch for PR #${number}`);
+              } catch (e) {
+                core.info(`UpdateBranch skipped for PR #${number}: ${e.message}`);
+              }
+            }
+
+            if (context.eventName === 'pull_request_target' && context.payload.pull_request) {
+              await updateOne(context.payload.pull_request.number);
+            } else {
+              const all = await github.paginate(github.rest.pulls.list, { owner, repo, state: 'open', per_page: 100 });
+              for (const pr of all.filter(p => APPROVED_BOTS.includes(p.user.login))) {
+                await updateOne(pr.number);
+              }
+            }
+
+      - name: Auto-approve bot PR(s) (skip if reviewer == author or already approved)
+        if: ${{ steps.pr.outputs.number != '' || github.event_name == 'schedule' || github.event_name == 'workflow_dispatch' }}
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ env.BOT_TOKEN }}
+          script: |
+            const owner = context.repo.owner;
+            const repo = context.repo.repo;
+            const APPROVED_BOTS = JSON.parse(process.env.APPROVED_BOTS);
+            const myLogin = process.env.GITHUB_ACTOR.toLowerCase();
+
+            async function approveOne(number) {
+              const { data: pr } = await github.rest.pulls.get({ owner, repo, pull_number: number });
+              const author = pr.user.login.toLowerCase();
+              if (!APPROVED_BOTS.includes(pr.user.login) || pr.state !== 'open') return;
+
+              // Skip if reviewer == author
+              if (author === myLogin) {
+                core.info(`Skipping PR #${number} - reviewer (${myLogin}) is the author.`);
+                return;
+              }
+
+              // Skip if already approved by this reviewer
+              const { data: reviews } = await github.rest.pulls.listReviews({ owner, repo, pull_number: number });
+              const hasApproval = reviews.some(r =>
+                r.user?.login?.toLowerCase() === myLogin &&
+                r.state?.toLowerCase() === 'approved'
+              );
+              if (hasApproval) {
+                core.info(`Skipping PR #${number} - already approved by ${myLogin}.`);
+                return;
+              }
+
+              await github.rest.pulls.createReview({
+                owner, repo, pull_number: number,
+                event: 'APPROVE'
+              });
+              core.info(`Approved PR #${number} from ${pr.user.login}`);
+            }
+
+            if (context.eventName === 'pull_request_target' && context.payload.pull_request) {
+              await approveOne(context.payload.pull_request.number);
+            } else {
+              const all = await github.paginate(github.rest.pulls.list, { owner, repo, state: 'open', per_page: 100 });
+              for (const pr of all.filter(p => APPROVED_BOTS.includes(p.user.login))) {
+                await approveOne(pr.number);
+              }
+            }
+
+      - name: Enable auto-merge (squash)
+        if: ${{ steps.pr.outputs.number != '' }}
+        uses: peter-evans/enable-pull-request-automerge@v3
+        with:
+          token: ${{ env.BOT_TOKEN }}
+          pull-request-number: ${{ steps.pr.outputs.number }}
+          merge-method: squash

package/.github/workflows/publish.yml

@@ -22,12 +22,8 @@ jobs:
         run: |
           # Public npm
           echo "//registry.npmjs.org/:_authToken=${NPM_TOKEN}" > ~/.npmrc
-          # GitHub
-          echo "@elipeF:registry=https://npm.pkg.github.com" >> ~/.npmrc
-          echo "//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}" >> ~/.npmrc
         env:
           NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Install dependencies
         run: npm ci

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

@@ -5,32 +5,68 @@ on:
     - cron: '0 0 * * *'   # every day at 00:00 UTC
   workflow_dispatch:
 
+permissions:
+  contents: write
+  pull-requests: write
+
+concurrency:
+  group: update-mapping
+  cancel-in-progress: false
+
+env:
+  # Single token for commits, PR creation, and auto-merge
+  BOT_TOKEN: ${{ secrets.BOT_MAINTAINER_TOKEN != '' && secrets.BOT_MAINTAINER_TOKEN || secrets.GITHUB_TOKEN }}
+
 jobs:
   refresh-mapping:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repo
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ env.BOT_TOKEN }}
+
       - name: Setup Node.js
-        uses: actions/setup-node@v3
+        uses: actions/setup-node@v4
         with:
           node-version: '20'
+
       - name: Install dependencies
         run: npm ci
+
       - name: Generate updated mapping
         run: npm run update:mapping
-      - name: Build
-        run: npm run build
-      - name: Test
-        run: npm test
-      - name: Commit & push if changed
+
+      - name: Commit changes (no push)
         run: |
           git config user.name "github-actions[bot]"
           git config user.email "github-actions[bot]@users.noreply.github.com"
           git add src/mapping/*
-          if ! git diff --cached --quiet; then
-            git commit -m "chore: daily update of mapping files"
-            git push
-          else
+          if git diff --cached --quiet; then
             echo "No changes in mapping files"
-          fi
+            echo "no_changes=true" >> $GITHUB_ENV
+          else
+            git commit -m "chore(mapping): daily update of mapping files"
+          fi
+
+      - name: Create or update PR
+        if: env.no_changes != 'true'
+        id: cpr
+        uses: peter-evans/create-pull-request@v6
+        with:
+          token: ${{ env.BOT_TOKEN }}
+          commit-message: "chore(mapping): daily update of mapping files"
+          branch: chore/mapping-auto
+          title: "chore(mapping): daily update of mapping files"
+          body: "Automated update of mapping files."
+          labels: dependencies
+          delete-branch: true
+
+      - name: Enable auto-merge (squash)
+        if: steps.cpr.outputs.pull-request-number
+        uses: peter-evans/enable-pull-request-automerge@v3
+        with:
+          token: ${{ env.BOT_TOKEN }}
+          pull-request-number: ${{ steps.cpr.outputs.pull-request-number }}
+          merge-method: squash

package/.releaserc.json

@@ -12,8 +12,7 @@
           { "type": "style",    "release": "patch" },
           { "type": "refactor", "release": "patch" },
           { "type": "perf",     "release": "patch" },
-          { "type": "test",     "release": "patch" },
-          { "type": "merge",    "release": "patch" }
+          { "type": "test",     "release": "patch" }
         ],
         "parserOpts": {
           "noteKeywords": ["BREAKING CHANGE", "BREAKING CHANGES"]

package/dist/cjs/converter.js

@@ -0,0 +1,78 @@
+'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 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()))
+        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 {
+        throw new errors.InvalidTimestampError(localIso);
+    }
+    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 in any IANA timezone into a UTC ISO string.
+ * Always emits "YYYY-MM-DDTHH:mm:ssZ" (no milliseconds).
+ */
+function convertLocalToUTCByZone(localIso, timeZone) {
+    // Validate timezone
+    try {
+        new Intl.DateTimeFormat('en-US', { timeZone }).format();
+    }
+    catch {
+        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);
+    let zoned;
+    try {
+        zoned = tz.TZDate.tz(timeZone, year, month, day, hour, minute, second);
+    }
+    catch {
+        throw new errors.UnknownTimezoneError(timeZone);
+    }
+    if (isNaN(zoned.getTime()))
+        throw new errors.InvalidTimestampError(localIso);
+    return new Date(zoned.getTime()).toISOString().replace('.000Z', 'Z');
+}
+
+exports.convertLocalToUTCByZone = convertLocalToUTCByZone;
+exports.convertToUTC = convertToUTC;

package/dist/cjs/errors.js

@@ -0,0 +1,24 @@
+'use strict';
+
+class UnknownAirportError extends Error {
+    constructor(iata) {
+        super(`Unknown airport IATA code: ${iata}`);
+        this.name = 'UnknownAirportError';
+    }
+}
+class InvalidTimestampError extends Error {
+    constructor(ts) {
+        super(`Invalid ISO 8601 timestamp: ${ts}`);
+        this.name = 'InvalidTimestampError';
+    }
+}
+class UnknownTimezoneError extends Error {
+    constructor(tz) {
+        super(`Unknown timezone: ${tz}`);
+        this.name = 'UnknownTimezoneError';
+    }
+}
+
+exports.InvalidTimestampError = InvalidTimestampError;
+exports.UnknownAirportError = UnknownAirportError;
+exports.UnknownTimezoneError = UnknownTimezoneError;

package/dist/cjs/index.js

@@ -0,0 +1,14 @@
+'use strict';
+
+var converter = require('./converter.js');
+var info = require('./info.js');
+var errors = require('./errors.js');
+
+
+
+exports.convertLocalToUTCByZone = converter.convertLocalToUTCByZone;
+exports.convertToUTC = converter.convertToUTC;
+exports.getAirportInfo = info.getAirportInfo;
+exports.InvalidTimestampError = errors.InvalidTimestampError;
+exports.UnknownAirportError = errors.UnknownAirportError;
+exports.UnknownTimezoneError = errors.UnknownTimezoneError;

package/dist/cjs/info.js

@@ -0,0 +1,16 @@
+'use strict';
+
+var timezones = require('./mapping/timezones.js');
+var geo = require('./mapping/geo.js');
+var errors = require('./errors.js');
+
+/** @throws UnknownAirportError */
+function getAirportInfo(iata) {
+    const tz = timezones.timezones[iata];
+    const g = geo.geo[iata];
+    if (!tz || !g)
+        throw new errors.UnknownAirportError(iata);
+    return { timezone: tz, ...g };
+}
+
+exports.getAirportInfo = getAirportInfo;