@geoalgeria/aviation 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yasser's Studio (https://yasser.studio)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,119 @@
+<div align="center">
+
+# @geoalgeria/aviation
+
+**Every civil airport in Algeria — as data you can install.**
+
+[![npm](https://img.shields.io/npm/v/@geoalgeria/aviation)](https://www.npmjs.com/package/@geoalgeria/aviation)
+[![npm downloads](https://img.shields.io/npm/dm/@geoalgeria/aviation)](https://www.npmjs.com/package/@geoalgeria/aviation)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+</div>
+
+33 civil airports across Algeria — with official names, **ICAO (OACI) codes**, postal
+addresses, phone numbers, websites, GPS coordinates, and wilaya linkage. Sourced from
+ANAC (the Autorité Nationale de l'Aviation Civile), shipped as JSON, CSV, and GeoJSON.
+Part of [GeoAlgeria](https://github.com/yasserstudio/geoalgeria).
+
+```bash
+npm install @geoalgeria/aviation
+```
+
+```js
+import aviation from "@geoalgeria/aviation";
+
+const all = aviation.airports();                 // 33
+const algiers = aviation.airportByIcao("DAAG");  // Houari Boumediene
+const inOran = aviation.airportsByWilaya(31);     // airports in wilaya 31
+
+// Everything has lat/lng — distance-sort, map, or nearest-airport in a few lines.
+```
+
+## What you can build
+
+- **Nearest-airport lookups** — coordinates on every record, ready for distance sorting.
+- **ICAO ↔ airport resolution** — map flight-data ICAO codes to names, contacts, and location.
+- **Travel & logistics** — match a wilaya or a point to its serving airport.
+- **Maps** — drop-in GeoJSON point layer for the whole civil-airport network.
+
+## What's inside
+
+| Dataset | Count | Notes |
+| --- | --- | --- |
+| Civil airports | **33** | official name, ICAO code, address, phone, website, coordinates |
+
+Spanning **31 wilayas**, every airport geocoded. `wilaya_code` is linked against the
+[`geoalgeria`](https://www.npmjs.com/package/geoalgeria) 69-wilaya model.
+
+## Formats
+
+The npm package ships the **JSON** (importable directly):
+
+```js
+import airports from "@geoalgeria/aviation/data/airports.json" with { type: "json" };
+// or via CDN, no install:
+// https://cdn.jsdelivr.net/npm/@geoalgeria/aviation/data/airports.json
+```
+
+The loaders and record shapes are fully **typed** — TypeScript definitions ship in the package:
+
+```ts
+import aviation, { type Airport } from "@geoalgeria/aviation";
+const airports: Airport[] = aviation.airports();
+```
+
+**CSV and GeoJSON** are in the repo under [`data/`](data) and bundled in every
+[GitHub Release](https://github.com/yasserstudio/geoalgeria/releases):
+
+```
+data/
+  airports.json            # 33 airports (array)
+  metadata.json            # source, counts, generated_at
+  csv/airports.csv         # repo + Release bundle (not in npm tarball)
+  geojson/airports.geojson # Point features (all 33 are geocoded)
+```
+
+## Record shape
+
+```json
+{
+  "id": "daag",
+  "name": "Aéroport d’Alger – Houari Boumediene",
+  "icao": "DAAG",
+  "iata": null,
+  "address": "Alger BP 164 DAR EL BEIDA",
+  "phone": "+21323199230",
+  "website": "https://www.aeroportalger.dz/",
+  "wilaya_code": "16",
+  "lat": 36.69951171485545,
+  "lng": 3.210846808533331,
+  "source": "https://www.anac.dz/en/carte-des-aeroports-3/"
+}
+```
+
+`id` is the ICAO code lowercased. `icao` always matches `DA__`. `iata` is `null` — ANAC
+publishes only ICAO codes (the slot is reserved for later enrichment). `wilaya_code` is
+zero-padded to two digits and joins GeoAlgeria's wilayas; a few records may have a `null`
+`phone` where ANAC lists none.
+
+## Need the administrative divisions too?
+
+If you also need wilayas, dairas, and communes to join against, use the main
+**[`geoalgeria`](https://www.npmjs.com/package/geoalgeria)** package — it ships the full
+69-wilaya division dataset that `wilaya_code` here links to. Use `@geoalgeria/aviation`
+when you *only* need airport data.
+
+## Source
+
+Data comes from **ANAC — Autorité Nationale de l'Aviation Civile**, via the public
+airports map (<https://www.anac.dz/en/carte-des-aeroports-3/>). Run `npm run fetch` to
+regenerate every output from the live map; the build follows the map's iframe so an ANAC
+version bump doesn't break it, and it fails loudly if the airport count or ICAO format
+changes. `wilaya_code` is resolved by nearest commune centroid from the `geoalgeria`
+dataset (the flagship ships centroids, not boundary polygons).
+
+## License & attribution
+
+Code is [MIT](LICENSE). The underlying data is © **ANAC**, redistributed for reference
+and to power [GeoAlgeria](https://geoalgeria.com). Verify against ANAC for authoritative,
+real-time information.

package/data/airports.json

@@ -0,0 +1,431 @@
+[
+  {
+    "id": "daad",
+    "name": "Aéroport de BOU SAADA/Ain Eddis",
+    "icao": "DAAD",
+    "iata": null,
+    "address": "BP 278/ BOU SAADA",
+    "phone": "+213 35 43 47 78",
+    "website": "https://aeroports-egsa-alger.dz/fr/1.html",
+    "wilaya_code": "68",
+    "lat": 35.32449005474226,
+    "lng": 4.200126110472756,
+    "source": "https://www.anac.dz/en/carte-des-aeroports-3/"
+  },
+  {
+    "id": "daae",
+    "name": "Aéroport de BEJAIA/Soummam ‐Abane Ramdane",
+    "icao": "DAAE",
+    "iata": null,
+    "address": "Soummam‐Abane Ramdane‐ Bejaia",
+    "phone": "+213 34183036",
+    "website": "https://aeroports-egsa-alger.dz/fr/11.html",
+    "wilaya_code": "06",
+    "lat": 36.7158254808996,
+    "lng": 5.071032952852189,
+    "source": "https://www.anac.dz/en/carte-des-aeroports-3/"
+  },
+  {
+    "id": "daag",
+    "name": "Aéroport d’Alger – Houari Boumediene",
+    "icao": "DAAG",
+    "iata": null,
+    "address": "Alger BP 164 DAR EL BEIDA",
+    "phone": "+21323199230",
+    "website": "https://www.aeroportalger.dz/",
+    "wilaya_code": "16",
+    "lat": 36.69951171485545,
+    "lng": 3.210846808533331,
+    "source": "https://www.anac.dz/en/carte-des-aeroports-3/"
+  },
+  {
+    "id": "daaj",
+    "name": "Aéroport de DJANET / Tiska-DJANET",
+    "icao": "DAAJ",
+    "iata": null,
+    "address": "Aéroport de DJANET / Tiska BP 29. ‐DJANET",
+    "phone": "+213 29481502",
+    "website": "https://aeroports-egsa-alger.dz/fr/13.html",
+    "wilaya_code": "56",
+    "lat": 24.28966075585949,
+    "lng": 9.46571858129957,
+    "source": "https://www.anac.dz/en/carte-des-aeroports-3/"
+  },
+  {
+    "id": "daap",
+    "name": "Aéroport de ILLIZI/TAKHAMALT",
+    "icao": "DAAP",
+    "iata": null,
+    "address": "Aéroport de ILLIZI/TAKHAMALT BP 39 ‐ILLIZI",
+    "phone": "+213 29413013",
+    "website": "https://aeroports-egsa-alger.dz/fr/5.html",
+    "wilaya_code": "33",
+    "lat": 26.71924934185029,
+    "lng": 8.618196725541447,
+    "source": "https://www.anac.dz/en/carte-des-aeroports-3/"
+  },
+  {
+    "id": "daas",
+    "name": "Aéroport de SETIF /8 Mai 45",
+    "icao": "DAAS",
+    "iata": null,
+    "address": "Aéroport de SETIF /8 Mai 45 ‐ BP 219 /Sétif",
+    "phone": "+213 36 543135",
+    "website": "https://www.egsa-constantine.dz/index.php/aeroports/aeroport-de-setif-08-mai-1945",
+    "wilaya_code": "19",
+    "lat": 36.17553448867715,
+    "lng": 5.330306679093995,
+    "source": "https://www.anac.dz/en/carte-des-aeroports-3/"
+  },
+  {
+    "id": "daat",
+    "name": "Aéroport de Tamanrasset – Aguenar – Hadj Bey Akhamok",
+    "icao": "DAAT",
+    "iata": null,
+    "address": "Aéroport de TAMENGHASSET/Aguenar-Hadj Bey Akhamok- BP 38/TAMENGHASSET",
+    "phone": "+21329330031",
+    "website": "https://aeroports-egsa-alger.dz/fr/16.html",
+    "wilaya_code": "11",
+    "lat": 22.81520178682999,
+    "lng": 5.448914008186444,
+    "source": "https://www.anac.dz/en/carte-des-aeroports-3/"
+  },
+  {
+    "id": "daav",
+    "name": "Aéroport de JIJEL/FERHAT ABBAS",
+    "icao": "DAAV",
+    "iata": null,
+    "address": "Aéroport de JIJEL/FERHAT ABBAS BP :37- TAHER / JIJEL",
+    "phone": "+213 34 544408",
+    "website": "https://www.egsa-constantine.dz/index.php/aeroports/aeroport-de-jijel-ferhat-abbas",
+    "wilaya_code": "18",
+    "lat": 36.79340595973765,
+    "lng": 5.877778649666695,
+    "source": "https://www.anac.dz/en/carte-des-aeroports-3/"
+  },
+  {
+    "id": "dabb",
+    "name": "Aéroport Annaba – Rabah Bitat",
+    "icao": "DABB",
+    "iata": null,
+    "address": "Rabah Bitat BP 296‐ Annaba",
+    "phone": "+21338529071",
+    "website": "https://www.egsa-constantine.dz/index.php/aeroports/aeroport-d-annaba-rabah-bitat",
+    "wilaya_code": "36",
+    "lat": 36.82441556514175,
+    "lng": 7.821324125869026,
+    "source": "https://www.anac.dz/en/carte-des-aeroports-3/"
+  },
+  {
+    "id": "dabc",
+    "name": "Aéroport de Constantine – Mohamed Boudiaf",
+    "icao": "DABC",
+    "iata": null,
+    "address": "AVA, Aéroport de CONSTANTINE",
+    "phone": "+21331810125",
+    "website": "https://www.egsa-constantine.dz/index.php/aeroports/aeroport-de-constantine-mohamed-boudiaf",
+    "wilaya_code": "25",
+    "lat": 36.28378418745162,
+    "lng": 6.621478825849163,
+    "source": "https://www.anac.dz/en/carte-des-aeroports-3/"
+  },
+  {
+    "id": "dabs",
+    "name": "Aéroport de Tébessa – Cheikh Larbi Tébessi",
+    "icao": "DABS",
+    "iata": null,
+    "address": "Aéroport de TEBESSA/Cheikh Larbi Tébessi BP 78‐Tebessa",
+    "phone": null,
+    "website": "https://www.egsa-constantine.dz/index.php/aeroports/aeroport-de-tebessa-cheikh-larbi-tebessi",
+    "wilaya_code": "12",
+    "lat": 35.42775621347607,
+    "lng": 8.118502895134583,
+    "source": "https://www.anac.dz/en/carte-des-aeroports-3/"
+  },
+  {
+    "id": "dabt",
+    "name": "Aéroport BATNA/ Mostepha Ben BOULAID",
+    "icao": "DABT",
+    "iata": null,
+    "address": "Batna-Mostepha Ben BOULAID aeroport",
+    "phone": "+213 33 870152",
+    "website": "https://www.egsa-constantine.dz/index.php/aeroports/aeroport-de-batna-mostefa-ben-boulaid",
+    "wilaya_code": "05",
+    "lat": 35.75767824581629,
+    "lng": 6.308248427678342,
+    "source": "https://www.anac.dz/en/carte-des-aeroports-3/"
+  },
+  {
+    "id": "daob",
+    "name": "Aéroport TIARET - Abdelhafid Boussouf Bou Chekif",
+    "icao": "DAOB",
+    "iata": null,
+    "address": "Aéroport TIARET / Abdelhafid Boussouf Bou Chekif ‐BP 12/Tiaret",
+    "phone": "+213 46240005",
+    "website": "https://egsa-oran.dz/index.php/aeroport-de-tiaret/",
+    "wilaya_code": "14",
+    "lat": 35.34579589348178,
+    "lng": 1.4698592674102533,
+    "source": "https://www.anac.dz/en/carte-des-aeroports-3/"
+  },
+  {
+    "id": "daof",
+    "name": "Aéroport de TINDOUF",
+    "icao": "DAOF",
+    "iata": null,
+    "address": "AVA, Direction de la Sécurité Aéronautique BP 72 /TINDOUF",
+    "phone": "+213 49370017",
+    "website": "https://egsa-oran.dz/index.php/aeroport-de-tindouf/",
+    "wilaya_code": "37",
+    "lat": 27.705212653326345,
+    "lng": -8.16543384744355,
+    "source": "https://www.anac.dz/en/carte-des-aeroports-3/"
+  },
+  {
+    "id": "daoi",
+    "name": "Aéroport de CHLEF",
+    "icao": "DAOI",
+    "iata": null,
+    "address": "Aboubakr Belkaid Airport, Chlef",
+    "phone": "+213 27728032",
+    "website": "https://aeroports-egsa-alger.dz/fr/15.html",
+    "wilaya_code": "02",
+    "lat": 36.21763410012118,
+    "lng": 1.3246854393403855,
+    "source": "https://www.anac.dz/en/carte-des-aeroports-3/"
+  },
+  {
+    "id": "daon",
+    "name": "Aéroport de Tlemcen – Zenata – Messali El Hadj",
+    "icao": "DAON",
+    "iata": null,
+    "address": "Aéroport de TLEMCEN/Zenata-Messali El Hadj/BP50- ZENATA/TLEMCEN",
+    "phone": "+21343403149",
+    "website": "https://egsa-oran.dz/index.php/nos-aeroports/",
+    "wilaya_code": "13",
+    "lat": 35.012480117143284,
+    "lng": -1.4480446913865919,
+    "source": "https://www.anac.dz/en/carte-des-aeroports-3/"
+  },
+  {
+    "id": "daoo",
+    "name": "Aéroport d’Oran – Ahmed Benbella",
+    "icao": "DAOO",
+    "iata": null,
+    "address": "Aéroportd’ORAN/Ahmed BenbellaBP13 -Oran",
+    "phone": "+21341591067",
+    "website": "https://egsa-oran.dz/index.php/aeroport-doran/",
+    "wilaya_code": "31",
+    "lat": 35.61833150995104,
+    "lng": -0.6109085969987015,
+    "source": "https://www.anac.dz/en/carte-des-aeroports-3/"
+  },
+  {
+    "id": "daor",
+    "name": "Aéroport de BECHAR/Boudghene Ben Ali Lotf",
+    "icao": "DAOR",
+    "iata": null,
+    "address": "Boudghene Ben Ali Lotfi‐ BP: 69/Bechar",
+    "phone": "+213 49221909",
+    "website": "https://egsa-oran.dz/index.php/aeroport-de-bechar/",
+    "wilaya_code": "08",
+    "lat": 31.651481919578377,
+    "lng": -2.2525513149111935,
+    "source": "https://www.anac.dz/en/carte-des-aeroports-3/"
+  },
+  {
+    "id": "daov",
+    "name": "Aéroport de GHRISS",
+    "icao": "DAOV",
+    "iata": null,
+    "address": "Aéroport de GHRISS BP 12 - GHRISS",
+    "phone": "+213 45715911",
+    "website": "https://egsa-oran.dz/index.php/aeroport-de-mascara/",
+    "wilaya_code": "29",
+    "lat": 35.204242738046425,
+    "lng": 0.15366508348121125,
+    "source": "https://www.anac.dz/en/carte-des-aeroports-3/"
+  },
+  {
+    "id": "daoy",
+    "name": "Aéroport d'EL BAYADH",
+    "icao": "DAOY",
+    "iata": null,
+    "address": "Aéroport d’El Bayadh BP 209 RP/ El Bayadh",
+    "phone": "+213 49667806",
+    "website": "https://egsa-oran.dz/index.php/aeroport-de-el-bayadh/",
+    "wilaya_code": "32",
+    "lat": 33.718310325446744,
+    "lng": 1.093221137403827,
+    "source": "https://www.anac.dz/en/carte-des-aeroports-3/"
+  },
+  {
+    "id": "datg",
+    "name": "Aéroport d’IN GUEZZAM",
+    "icao": "DATG",
+    "iata": null,
+    "address": "Aéroport d’IN GUEZZAM / IN GUEZZAM",
+    "phone": "+213 29 351123",
+    "website": "https://aeroports-egsa-alger.dz/fr/7.html",
+    "wilaya_code": "54",
+    "lat": 19.563939499098094,
+    "lng": 5.751815823519952,
+    "source": "https://www.anac.dz/en/carte-des-aeroports-3/"
+  },
+  {
+    "id": "datm",
+    "name": "Aéroport de BORDJ MOKHTAR –BORDJ MOKHTAR",
+    "icao": "DATM",
+    "iata": null,
+    "address": "BORDJ MOKHTAR",
+    "phone": "+213 49329304",
+    "website": "https://egsa-oran.dz/index.php/aeroport-de-bordj-badji-mokhtar/",
+    "wilaya_code": "50",
+    "lat": 21.371800375167478,
+    "lng": 0.9238537082170545,
+    "source": "https://www.anac.dz/en/carte-des-aeroports-3/"
+  },
+  {
+    "id": "daua",
+    "name": "Aéroport d’Adrar – Touat – Cheikh Sidi Mohamed Belkebir",
+    "icao": "DAUA",
+    "iata": null,
+    "address": "Touat‐Cheikh Sidi Mohamed Belkebir BP15‐Adrar",
+    "phone": "+21349358003",
+    "website": "https://egsa-oran.dz/index.php/aeroport-de-adrar/",
+    "wilaya_code": "01",
+    "lat": 27.842093213179865,
+    "lng": -0.1894002032622811,
+    "source": "https://www.anac.dz/en/carte-des-aeroports-3/"
+  },
+  {
+    "id": "daub",
+    "name": "Aéroport de BISKRA/ Mohamed KHIDER",
+    "icao": "DAUB",
+    "iata": null,
+    "address": "ENNA – Direction de la Sécurité Aéronautique BP 27 star Melouk BISKRA, Biskra",
+    "phone": "+213 33543005",
+    "website": "https://www.egsa-constantine.dz/index.php/aeroports/aeroport-de-biskra-mohamed-kheider",
+    "wilaya_code": "07",
+    "lat": 34.79160974695419,
+    "lng": 5.733631154631189,
+    "source": "https://www.anac.dz/en/carte-des-aeroports-3/"
+  },
+  {
+    "id": "daue",
+    "name": "Aéroport d’El GOLEA",
+    "icao": "DAUE",
+    "iata": null,
+    "address": "Aéroport d’El GOLEA BP 30- El GOLEA",
+    "phone": "+213 29210735",
+    "website": "https://aeroports-egsa-alger.dz/fr/6.html",
+    "wilaya_code": "58",
+    "lat": 30.571557198848183,
+    "lng": 2.8688732967150132,
+    "source": "https://www.anac.dz/en/carte-des-aeroports-3/"
+  },
+  {
+    "id": "daug",
+    "name": "Aéroport de Ghardaïa – Noumérat Moufdi Zakaria",
+    "icao": "DAUG",
+    "iata": null,
+    "address": "Aéroport de GHARDAIA/Noumérat‐Moufdi Zakaria BP 123/Ghardaia",
+    "phone": "+21329295555",
+    "website": "https://aeroports-egsa-alger.dz/fr/14.html",
+    "wilaya_code": "47",
+    "lat": 32.378608164328305,
+    "lng": 3.8015461545489084,
+    "source": "https://www.anac.dz/en/carte-des-aeroports-3/"
+  },
+  {
+    "id": "dauh",
+    "name": "Aéroport de Hassi Messaoud – Oued Irara – Krim Belkacem",
+    "icao": "DAUH",
+    "iata": null,
+    "address": "Aéroport de Hassi Messaoud/Oued Irara‐Krim Belkacem BP 130",
+    "phone": "+21329741885",
+    "website": "https://aeroports-egsa-alger.dz/fr/10.html",
+    "wilaya_code": "30",
+    "lat": 31.675453603011896,
+    "lng": 6.144544541032298,
+    "source": "https://www.anac.dz/en/carte-des-aeroports-3/"
+  },
+  {
+    "id": "daui",
+    "name": "Aéroport de In Salah BP 23 - IN SALAH",
+    "icao": "DAUI",
+    "iata": null,
+    "address": "Aéroport de In Salah BP 23 - IN SALAH",
+    "phone": "+213 29366103",
+    "website": "https://aeroports-egsa-alger.dz/fr/4.html",
+    "wilaya_code": "53",
+    "lat": 27.252139159419297,
+    "lng": 2.508766383227296,
+    "source": "https://www.anac.dz/en/carte-des-aeroports-3/"
+  },
+  {
+    "id": "dauk",
+    "name": "Aéroport de TOUGGOURT /Sidi Mahdi",
+    "icao": "DAUK",
+    "iata": null,
+    "address": "Aéroport de TOUGGOURT /Sidi Mahdi ‐BP 47 / TOUGGOURT",
+    "phone": "+213 29 69 31 45",
+    "website": "https://aeroports-egsa-alger.dz/fr/8.html",
+    "wilaya_code": "55",
+    "lat": 33.06679067003136,
+    "lng": 6.091777108546213,
+    "source": "https://www.anac.dz/en/carte-des-aeroports-3/"
+  },
+  {
+    "id": "dauo",
+    "name": "Aéroport d’El Oued/Guemar",
+    "icao": "DAUO",
+    "iata": null,
+    "address": "Aéroport d’El Oued/Guemar BP 110 / El Oued",
+    "phone": "+213 32101015",
+    "website": "https://aeroports-egsa-alger.dz/fr/17.html",
+    "wilaya_code": "39",
+    "lat": 33.507414582460555,
+    "lng": 6.784868996915831,
+    "source": "https://www.anac.dz/en/carte-des-aeroports-3/"
+  },
+  {
+    "id": "daut",
+    "name": "Aéroport de TIMIMOUN",
+    "icao": "DAUT",
+    "iata": null,
+    "address": "Aéroport de TIMIMOUN ‐ BP 440/ TIMIMOUN",
+    "phone": "+213 49305706",
+    "website": "https://egsa-oran.dz/index.php/aeroport-de-timimoun/",
+    "wilaya_code": "49",
+    "lat": 29.244465048530696,
+    "lng": 0.2812601237662405,
+    "source": "https://www.anac.dz/en/carte-des-aeroports-3/"
+  },
+  {
+    "id": "dauu",
+    "name": "Aéroport de Ouargla/Ain Beida",
+    "icao": "DAUU",
+    "iata": null,
+    "address": "Aéroport de Ouargla‐ BP 11 /OUARGLA",
+    "phone": "+213 29774906",
+    "website": "https://aeroports-egsa-alger.dz/fr/2.html",
+    "wilaya_code": "30",
+    "lat": 31.936205024205428,
+    "lng": 5.408429008410361,
+    "source": "https://www.anac.dz/en/carte-des-aeroports-3/"
+  },
+  {
+    "id": "dauz",
+    "name": "Aéroport de Zarzaitine – In Aménas",
+    "icao": "DAUZ",
+    "iata": null,
+    "address": "Aéroport de In Amenas B.P 51 /IN AMENAS",
+    "phone": "+213 29 45 13",
+    "website": "https://aeroports-egsa-alger.dz/fr/12.html",
+    "wilaya_code": "33",
+    "lat": 28.051765839675433,
+    "lng": 9.63789046606008,
+    "source": "https://www.anac.dz/en/carte-des-aeroports-3/"
+  }
+]

package/data/metadata.json

@@ -0,0 +1,8 @@
+{
+  "source": "ANAC — Autorité Nationale de l'Aviation Civile (anac.dz)",
+  "origin": "https://www.anac.dz/en/carte-des-aeroports-3/",
+  "license": "Data © ANAC; redistributed for reference. See README.",
+  "airports": 33,
+  "wilayas_covered": 31,
+  "generated_at": "2026-06-14"
+}

package/index.js

@@ -0,0 +1,18 @@
+// @geoalgeria/aviation — lightweight loaders for Algeria's civil airports (ANAC).
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+
+const DATA = join(dirname(fileURLToPath(import.meta.url)), "data");
+const load = (p) => JSON.parse(readFileSync(join(DATA, p), "utf-8"));
+
+export const airports = () => load("airports.json"); // 33 civil airports
+export const airportByIcao = (code) =>
+  airports().find((a) => a.icao === String(code).toUpperCase()) ?? null;
+export const airportsByWilaya = (code) => {
+  const w = String(code).padStart(2, "0"); // accepts "16", 16, or "01"
+  return airports().filter((a) => a.wilaya_code === w);
+};
+export const metadata = () => load("metadata.json");
+
+export default { airports, airportByIcao, airportsByWilaya, metadata };

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@geoalgeria/aviation",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Algeria's 33 civil airports — official names, ICAO (OACI) codes, addresses, phones, websites, coordinates, and wilaya linkage. Sourced from ANAC (anac.dz). JSON, CSV, GeoJSON, TypeScript.",
+  "main": "index.js",
+  "types": "types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./types/index.d.ts",
+      "default": "./index.js"
+    },
+    "./data/*": "./data/*"
+  },
+  "files": [
+    "data/**/*.json",
+    "types/",
+    "index.js"
+  ],
+  "scripts": {
+    "fetch": "node scripts/fetch.mjs",
+    "test": "node ../../scripts/validate-packages.mjs aviation"
+  },
+  "keywords": [
+    "algeria",
+    "airport",
+    "aeroport",
+    "aeroports",
+    "aviation",
+    "anac",
+    "icao",
+    "oaci",
+    "airports",
+    "geojson",
+    "geoalgeria",
+    "dz"
+  ],
+  "author": "Yasser's Studio (https://yasser.studio)",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bugs": {
+    "url": "https://github.com/yasserstudio/geoalgeria/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yasserstudio/geoalgeria.git",
+    "directory": "packages/aviation"
+  },
+  "homepage": "https://geoalgeria.com",
+  "engines": {
+    "node": ">=18"
+  }
+}

package/types/index.d.ts

@@ -0,0 +1,52 @@
+/** A civil airport, as published by ANAC. */
+export interface Airport {
+  /** Stable id — the ICAO code, lowercased (e.g. `"daag"`). */
+  id: string;
+  /** Official airport name in French (e.g. `"Aéroport d'Alger – Houari Boumediene"`). */
+  name: string;
+  /** ICAO (OACI) code — always matches `/^DA[A-Z]{2}$/` (e.g. `"DAAG"`). */
+  icao: string;
+  /** IATA code — not published by ANAC; always `null` (reserved for later enrichment). */
+  iata: string | null;
+  /** Postal address as listed by ANAC, or `null` if none is given. */
+  address: string | null;
+  /** Contact phone, or `null` if none is given. */
+  phone: string | null;
+  /** Official website URL, or `null` if none is given. */
+  website: string | null;
+  /** Wilaya code, zero-padded to 2 digits (`"01"`–`"69"`). Joins `geoalgeria` wilayas. */
+  wilaya_code: string;
+  /** Latitude (WGS84). */
+  lat: number;
+  /** Longitude (WGS84). */
+  lng: number;
+  /** ANAC source page the record was derived from. */
+  source: string;
+}
+
+/** Dataset provenance and counts. */
+export interface Metadata {
+  source: string;
+  origin: string;
+  license: string;
+  airports: number;
+  wilayas_covered: number;
+  generated_at: string;
+}
+
+/** All civil airports (33). */
+export function airports(): Airport[];
+/** One airport by ICAO code (case-insensitive), or `null` if none matches. */
+export function airportByIcao(code: string): Airport | null;
+/** Airports in a wilaya — accepts `"16"`, `16`, or `"01"`. */
+export function airportsByWilaya(code: string | number): Airport[];
+/** Dataset metadata (counts, source, generated_at). */
+export function metadata(): Metadata;
+
+declare const _default: {
+  airports: typeof airports;
+  airportByIcao: typeof airportByIcao;
+  airportsByWilaya: typeof airportsByWilaya;
+  metadata: typeof metadata;
+};
+export default _default;