@palmgrove/nefdb 1.0.0

package/dist/index.js

@@ -0,0 +1,2071 @@
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+
+// src/api/aviation.ts
+var exports_aviation = {};
+__export(exports_aviation, {
+  route: () => route
+});
+
+// src/factors/aviation.ts
+var aviationFactors = [
+  {
+    id: "ng.aviation.domestic.los_abv",
+    category: "aviation",
+    subcategory: "domestic_route",
+    description: "Domestic aviation emission factor for Lagos (LOS) to Abuja (ABV) routes, per passenger-km",
+    value: 0.1962,
+    unit: "kgCO2e_per_passenger_km",
+    gas: null,
+    gwp_basis: "AR5",
+    scope: 1,
+    data_year: 2022,
+    published_year: 2026,
+    country: "NG",
+    source: {
+      id: "ICAO_ICEC_V13",
+      title: "ICAO Carbon Emissions Calculator Methodology v13.1",
+      publisher: "ICAO",
+      year: 2023,
+      page: "Boeing 737-500, 9% uplift, 3.16 kg CO2/kg fuel, 114 seats, 72% load factor, 84.32% Intra-Africa passenger-to-cargo factor"
+    },
+    additional_sources: [
+      {
+        id: "NCAA_EXEC_2022",
+        title: "NCAA Executive Summary Jan-Dec 2022",
+        publisher: "NCAA",
+        year: 2023
+      }
+    ],
+    uncertainty_pct: 20,
+    confidence: "medium",
+    methodology_note: "Derived from ICAO ICEC v13.1 using Boeing 737-500 fuel burn with 9% uplift, 3.16 kg CO2/kg fuel, 114 seats, 72% load factor and 84.32% Intra-Africa passenger-to-cargo factor. Rounded to four decimal places.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.aviation.domestic.los_phc",
+    category: "aviation",
+    subcategory: "domestic_route",
+    description: "Domestic aviation emission factor for Lagos (LOS) to Port Harcourt (PHC) routes, per passenger-km",
+    value: 0.2168,
+    unit: "kgCO2e_per_passenger_km",
+    gas: null,
+    gwp_basis: "AR5",
+    scope: 1,
+    data_year: 2022,
+    published_year: 2026,
+    country: "NG",
+    source: {
+      id: "ICAO_ICEC_V13",
+      title: "ICAO Carbon Emissions Calculator Methodology v13.1",
+      publisher: "ICAO",
+      year: 2023,
+      page: "Boeing 737-500, 9% uplift, 3.16 kg CO2/kg fuel, 114 seats, 72% load factor, 84.32% Intra-Africa passenger-to-cargo factor"
+    },
+    additional_sources: [
+      {
+        id: "NCAA_EXEC_2022",
+        title: "NCAA Executive Summary Jan-Dec 2022",
+        publisher: "NCAA",
+        year: 2023
+      }
+    ],
+    uncertainty_pct: 20,
+    confidence: "medium",
+    methodology_note: "Derived from ICAO ICEC v13.1 using Boeing 737-500 fuel burn with 9% uplift, 3.16 kg CO2/kg fuel, 114 seats, 72% load factor and 84.32% Intra-Africa passenger-to-cargo factor. Rounded to four decimal places.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.aviation.domestic.los_kan",
+    category: "aviation",
+    subcategory: "domestic_route",
+    description: "Domestic aviation emission factor for Lagos (LOS) to Kano (KAN) routes, per passenger-km",
+    value: 0.1489,
+    unit: "kgCO2e_per_passenger_km",
+    gas: null,
+    gwp_basis: "AR5",
+    scope: 1,
+    data_year: 2022,
+    published_year: 2026,
+    country: "NG",
+    source: {
+      id: "ICAO_ICEC_V13",
+      title: "ICAO Carbon Emissions Calculator Methodology v13.1",
+      publisher: "ICAO",
+      year: 2023,
+      page: "Boeing 737-500, 9% uplift, 3.16 kg CO2/kg fuel, 114 seats, 72% load factor, 84.32% Intra-Africa passenger-to-cargo factor"
+    },
+    additional_sources: [
+      {
+        id: "NCAA_EXEC_2022",
+        title: "NCAA Executive Summary Jan-Dec 2022",
+        publisher: "NCAA",
+        year: 2023
+      }
+    ],
+    uncertainty_pct: 20,
+    confidence: "medium",
+    methodology_note: "Derived from ICAO ICEC v13.1 using Boeing 737-500 fuel burn with 9% uplift, 3.16 kg CO2/kg fuel, 114 seats, 72% load factor and 84.32% Intra-Africa passenger-to-cargo factor. Rounded to four decimal places.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.aviation.domestic.abv_phc",
+    category: "aviation",
+    subcategory: "domestic_route",
+    description: "Domestic aviation emission factor for Abuja (ABV) to Port Harcourt (PHC) routes, per passenger-km",
+    value: 0.2143,
+    unit: "kgCO2e_per_passenger_km",
+    gas: null,
+    gwp_basis: "AR5",
+    scope: 1,
+    data_year: 2022,
+    published_year: 2026,
+    country: "NG",
+    source: {
+      id: "ICAO_ICEC_V13",
+      title: "ICAO Carbon Emissions Calculator Methodology v13.1",
+      publisher: "ICAO",
+      year: 2023,
+      page: "Boeing 737-500, 9% uplift, 3.16 kg CO2/kg fuel, 114 seats, 72% load factor, 84.32% Intra-Africa passenger-to-cargo factor"
+    },
+    additional_sources: [
+      {
+        id: "NCAA_EXEC_2022",
+        title: "NCAA Executive Summary Jan-Dec 2022",
+        publisher: "NCAA",
+        year: 2023
+      }
+    ],
+    uncertainty_pct: 20,
+    confidence: "medium",
+    methodology_note: "Derived from ICAO ICEC v13.1 using Boeing 737-500 fuel burn with 9% uplift, 3.16 kg CO2/kg fuel, 114 seats, 72% load factor and 84.32% Intra-Africa passenger-to-cargo factor. Rounded to four decimal places.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.aviation.domestic.generic",
+    category: "aviation",
+    subcategory: "domestic_route",
+    description: "Generic domestic aviation emission factor for Nigeria, arithmetic mean of four domestic routes, per passenger-km",
+    value: 0.194,
+    unit: "kgCO2e_per_passenger_km",
+    gas: null,
+    gwp_basis: "AR5",
+    scope: 1,
+    data_year: 2022,
+    published_year: 2026,
+    country: "NG",
+    source: {
+      id: "ICAO_ICEC_V13",
+      title: "ICAO Carbon Emissions Calculator Methodology v13.1",
+      publisher: "ICAO",
+      year: 2023,
+      page: "Boeing 737-500, 9% uplift, 3.16 kg CO2/kg fuel, 114 seats, 72% load factor, 84.32% Intra-Africa passenger-to-cargo factor"
+    },
+    additional_sources: [
+      {
+        id: "NCAA_EXEC_2022",
+        title: "NCAA Executive Summary Jan-Dec 2022",
+        publisher: "NCAA",
+        year: 2023
+      }
+    ],
+    uncertainty_pct: 20,
+    confidence: "medium",
+    methodology_note: "Arithmetic mean of ng.aviation.domestic.los_abv, ng.aviation.domestic.los_phc, ng.aviation.domestic.los_kan and ng.aviation.domestic.abv_phc. Derived from ICAO ICEC v13.1 using Boeing 737-500 fuel burn with 9% uplift, 3.16 kg CO2/kg fuel, 114 seats, 72% load factor and 84.32% Intra-Africa passenger-to-cargo factor.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.aviation.domestic.rf_multiplier",
+    category: "aviation",
+    subcategory: "rf_multiplier",
+    description: "Radiative forcing multiplier for domestic aviation non-CO2 climate effects in Nigeria",
+    value: 1.9,
+    unit: "multiplier",
+    gas: null,
+    gwp_basis: "AR5",
+    scope: 1,
+    data_year: 2022,
+    published_year: 2026,
+    country: "NG",
+    source: {
+      id: "LEE_ET_AL_2021",
+      title: "Contribution of global aviation to anthropogenic climate forcing",
+      publisher: "Atmospheric Environment",
+      year: 2021
+    },
+    uncertainty_pct: 30,
+    confidence: "medium",
+    methodology_note: "Radiative forcing multiplier from Lee et al. (2021) applied to domestic aviation CO2 factors to account for contrails and other non-CO2 effects. Use via nefdb.aviation.route(origin, destination, { rf: true }).",
+    nefdb_version: "1.0.0"
+  }
+];
+
+// src/factors/fuel_combustion.ts
+var fuelCombustionFactors = [
+  {
+    id: "ng.fuel.diesel.stationary",
+    category: "fuel_combustion",
+    subcategory: "diesel_stationary",
+    description: "Stationary combustion emission factor for diesel fuel, applicable to generators, boilers, and other fixed equipment in Nigeria.",
+    value: 2.662,
+    unit: "kgCO2e_per_litre",
+    gas: null,
+    gwp_basis: "AR5",
+    scope: 1,
+    data_year: 2024,
+    published_year: 2026,
+    country: "NG",
+    region: "NG",
+    source: {
+      id: "IPCC_2006_VOL2_CH2",
+      title: "IPCC 2006 Guidelines Vol 2 Ch 2 Stationary Combustion",
+      publisher: "IPCC",
+      year: 2006,
+      page: "Table 2.2 (gas/diesel oil)"
+    },
+    additional_sources: [
+      {
+        id: "DEFRA_2024_FULL",
+        title: "UK DESNZ/DEFRA 2024 GHG Conversion Factors Full Set",
+        publisher: "UK DESNZ",
+        year: 2024
+      },
+      {
+        id: "EPA_GHG_HUB_2024",
+        title: "EPA GHG Emission Factors Hub 2024",
+        publisher: "US EPA",
+        year: 2024
+      }
+    ],
+    uncertainty_pct: 10,
+    confidence: "high",
+    methodology_note: "DEFRA 2024 100% mineral diesel factor adopted as primary; IPCC 2006 Table 2.2 gas/diesel oil factor corroborates within 1%. AR5 GWP.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.fuel.diesel.stationary.kwh.rated",
+    category: "fuel_combustion",
+    subcategory: "diesel_stationary_kwh",
+    description: "Rated-efficiency diesel emission factor per kilowatt-hour of generated electricity, derived for modern generator performance assumptions.",
+    value: 0.813,
+    unit: "kgCO2e_per_kWh",
+    gas: null,
+    gwp_basis: "AR5",
+    scope: 1,
+    data_year: 2024,
+    published_year: 2026,
+    country: "NG",
+    region: "NG",
+    source: {
+      id: "IPCC_2006_VOL2_CH2",
+      title: "IPCC 2006 Guidelines Vol 2 Ch 2 Stationary Combustion",
+      publisher: "IPCC",
+      year: 2006,
+      page: "Table 2.2 (gas/diesel oil)"
+    },
+    additional_sources: [
+      {
+        id: "DEFRA_2024_FULL",
+        title: "UK DESNZ/DEFRA 2024 GHG Conversion Factors Full Set",
+        publisher: "UK DESNZ",
+        year: 2024
+      },
+      {
+        id: "SOMORIN_2017",
+        title: "Life cycle assessment of self-generated electricity in Nigeria",
+        publisher: "Somorin et al., Renewable Energy",
+        year: 2017
+      }
+    ],
+    uncertainty_pct: 15,
+    confidence: "medium",
+    methodology_note: "Derived from stationary diesel factor using standard generator conversion: 2.662 / (9.927 kWh thermal per litre x 0.33) = 0.813. 33% rated efficiency is a NEFDB assumption.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.fuel.diesel.stationary.kwh.field",
+    category: "fuel_combustion",
+    subcategory: "diesel_stationary_kwh",
+    description: "Field-efficiency diesel emission factor per kilowatt-hour of generated electricity, recommended default for Nigeria's aged generator fleet.",
+    value: 0.958,
+    unit: "kgCO2e_per_kWh",
+    gas: null,
+    gwp_basis: "AR5",
+    scope: 1,
+    data_year: 2024,
+    published_year: 2026,
+    country: "NG",
+    region: "NG",
+    source: {
+      id: "IPCC_2006_VOL2_CH2",
+      title: "IPCC 2006 Guidelines Vol 2 Ch 2 Stationary Combustion",
+      publisher: "IPCC",
+      year: 2006,
+      page: "Table 2.2 (gas/diesel oil)"
+    },
+    additional_sources: [
+      {
+        id: "DEFRA_2024_FULL",
+        title: "UK DESNZ/DEFRA 2024 GHG Conversion Factors Full Set",
+        publisher: "UK DESNZ",
+        year: 2024
+      },
+      {
+        id: "SOMORIN_2017",
+        title: "Life cycle assessment of self-generated electricity in Nigeria",
+        publisher: "Somorin et al., Renewable Energy",
+        year: 2017
+      }
+    ],
+    uncertainty_pct: 18,
+    confidence: "medium",
+    methodology_note: "2.662 / (9.927 x 0.28) = 0.958. 28% field efficiency is a NEFDB assumption for Nigeria's aged genset fleet, informed by Somorin et al. 2017. This is the recommended default.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.fuel.petrol.stationary",
+    category: "fuel_combustion",
+    subcategory: "petrol_stationary",
+    description: "Stationary combustion emission factor for petrol fuel, applicable to stationary engines and generators in Nigeria.",
+    value: 2.354,
+    unit: "kgCO2e_per_litre",
+    gas: null,
+    gwp_basis: "AR5",
+    scope: 1,
+    data_year: 2024,
+    published_year: 2026,
+    country: "NG",
+    region: "NG",
+    source: {
+      id: "IPCC_2006_VOL2_CH2",
+      title: "IPCC 2006 Guidelines Vol 2 Ch 2 Stationary Combustion",
+      publisher: "IPCC",
+      year: 2006,
+      page: "Table 2.2 (motor gasoline)"
+    },
+    additional_sources: [
+      {
+        id: "DEFRA_2024_FULL",
+        title: "UK DESNZ/DEFRA 2024 GHG Conversion Factors Full Set",
+        publisher: "UK DESNZ",
+        year: 2024
+      },
+      {
+        id: "EPA_GHG_HUB_2024",
+        title: "EPA GHG Emission Factors Hub 2024",
+        publisher: "US EPA",
+        year: 2024
+      }
+    ],
+    uncertainty_pct: 10,
+    confidence: "high",
+    methodology_note: "DEFRA 2024 100% mineral petrol; IPCC 2006 Table 2.2 motor gasoline corroborates.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.fuel.lpg.stationary",
+    category: "fuel_combustion",
+    subcategory: "lpg_stationary",
+    description: "Stationary combustion emission factor for liquefied petroleum gas (LPG) in Nigeria.",
+    value: 1.557,
+    unit: "kgCO2e_per_litre",
+    gas: null,
+    gwp_basis: "AR5",
+    scope: 1,
+    data_year: 2024,
+    published_year: 2026,
+    country: "NG",
+    region: "NG",
+    source: {
+      id: "IPCC_2006_VOL2_CH2",
+      title: "IPCC 2006 Guidelines Vol 2 Ch 2 Stationary Combustion",
+      publisher: "IPCC",
+      year: 2006,
+      page: "Table 2.2 (liquefied petroleum gas)"
+    },
+    additional_sources: [
+      {
+        id: "DEFRA_2024_FULL",
+        title: "UK DESNZ/DEFRA 2024 GHG Conversion Factors Full Set",
+        publisher: "UK DESNZ",
+        year: 2024
+      },
+      {
+        id: "EPA_GHG_HUB_2024",
+        title: "EPA GHG Emission Factors Hub 2024",
+        publisher: "US EPA",
+        year: 2024
+      }
+    ],
+    uncertainty_pct: 10,
+    confidence: "high",
+    methodology_note: "DEFRA 2024 LPG factor.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.fuel.cng.stationary",
+    category: "fuel_combustion",
+    subcategory: "cng_stationary",
+    description: "Stationary combustion emission factor for compressed natural gas (CNG), expressed per kilogram of fuel in Nigeria.",
+    value: 2.568,
+    unit: "kgCO2e_per_kg",
+    gas: null,
+    gwp_basis: "AR5",
+    scope: 1,
+    data_year: 2024,
+    published_year: 2026,
+    country: "NG",
+    region: "NG",
+    source: {
+      id: "IPCC_2006_VOL2_CH2",
+      title: "IPCC 2006 Guidelines Vol 2 Ch 2 Stationary Combustion",
+      publisher: "IPCC",
+      year: 2006,
+      page: "Table 2.2 (natural gas)"
+    },
+    additional_sources: [
+      {
+        id: "DEFRA_2024_FULL",
+        title: "UK DESNZ/DEFRA 2024 GHG Conversion Factors Full Set",
+        publisher: "UK DESNZ",
+        year: 2024
+      }
+    ],
+    uncertainty_pct: 15,
+    confidence: "medium",
+    methodology_note: "DEFRA 2024 CNG per-kg factor. Per-kg value is pressure-independent; per-litre values require a density assumption.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.fuel.naturalgas.stationary",
+    category: "fuel_combustion",
+    subcategory: "natural_gas_stationary",
+    description: "Stationary combustion emission factor for natural gas, expressed per cubic metre of grid gas in Nigeria.",
+    value: 2.045,
+    unit: "kgCO2e_per_m3",
+    gas: null,
+    gwp_basis: "AR5",
+    scope: 1,
+    data_year: 2024,
+    published_year: 2026,
+    country: "NG",
+    region: "NG",
+    source: {
+      id: "IPCC_2006_VOL2_CH2",
+      title: "IPCC 2006 Guidelines Vol 2 Ch 2 Stationary Combustion",
+      publisher: "IPCC",
+      year: 2006,
+      page: "Table 2.2 (natural gas)"
+    },
+    additional_sources: [
+      {
+        id: "DEFRA_2024_FULL",
+        title: "UK DESNZ/DEFRA 2024 GHG Conversion Factors Full Set",
+        publisher: "UK DESNZ",
+        year: 2024
+      },
+      {
+        id: "NNPC_STATS_2023",
+        title: "NNPC Annual Statistics Bulletin S3",
+        publisher: "NNPC",
+        year: 2023
+      }
+    ],
+    uncertainty_pct: 10,
+    confidence: "high",
+    methodology_note: "DEFRA 2024 natural gas per-m3 factor. Assumes grid-gas density; Nigeria-specific gas spec may differ.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.fuel.hfo.stationary",
+    category: "fuel_combustion",
+    subcategory: "hfo_stationary",
+    description: "Stationary combustion emission factor for heavy fuel oil (HFO) in Nigeria.",
+    value: 3.175,
+    unit: "kgCO2e_per_litre",
+    gas: null,
+    gwp_basis: "AR5",
+    scope: 1,
+    data_year: 2024,
+    published_year: 2026,
+    country: "NG",
+    region: "NG",
+    source: {
+      id: "IPCC_2006_VOL2_CH2",
+      title: "IPCC 2006 Guidelines Vol 2 Ch 2 Stationary Combustion",
+      publisher: "IPCC",
+      year: 2006,
+      page: "Table 2.2 (residual fuel oil)"
+    },
+    additional_sources: [
+      {
+        id: "DEFRA_2024_FULL",
+        title: "UK DESNZ/DEFRA 2024 GHG Conversion Factors Full Set",
+        publisher: "UK DESNZ",
+        year: 2024
+      },
+      {
+        id: "EPA_GHG_HUB_2024",
+        title: "EPA GHG Emission Factors Hub 2024",
+        publisher: "US EPA",
+        year: 2024
+      }
+    ],
+    uncertainty_pct: 15,
+    confidence: "medium",
+    methodology_note: "DEFRA 2024 fuel oil; IPCC 2006 Table 2.2 residual fuel oil corroborates.",
+    nefdb_version: "1.0.0"
+  }
+];
+
+// src/factors/grid_electricity.ts
+var gridElectricityFactors = [
+  {
+    id: "ng.grid.national.om.2021",
+    category: "grid_electricity",
+    subcategory: "national_grid_operating_margin",
+    description: "West African Power Pool (WAPP) grid operating margin CO2 emission factor, applicable to Nigeria as a WAPP member country",
+    value: 0.578,
+    unit: "kgCO2e_per_kWh",
+    gas: { CO2: 0.578, CH4: 0, N2O: 0 },
+    gwp_basis: "AR6",
+    scope: 2,
+    data_year: 2019,
+    published_year: 2021,
+    country: "NG",
+    region: "WAPP",
+    source: {
+      id: "WAPP_ASB0034_2021",
+      title: "Standardized Baseline for WAPP including Nigeria (ASB0034-2021)",
+      publisher: "UNFCCC / WAPP",
+      year: 2021,
+      page: "Section 7, Table 1"
+    },
+    additional_sources: [
+      {
+        id: "WAPP_ASB0034_ASSESSMENT",
+        title: "Assessment Report ASU006 ASB0034 WAPP",
+        publisher: "UNFCCC / WAPP",
+        year: 2021,
+        page: "Section B, Step 4"
+      },
+      {
+        id: "UNFCCC_CDM_TOOL07",
+        title: "UNFCCC CDM Methodological Tool 07 v7.0",
+        publisher: "UNFCCC",
+        year: 2021,
+        page: "Section 6.4.1, Simple OM"
+      }
+    ],
+    uncertainty_pct: 10,
+    confidence: "high",
+    methodology_note: "Operating margin extracted directly from ASB0034-2021 Table 1 as 0.578 tCO2/MWh. Unit conversion to kgCO2e/kWh is 1:1 because 1 tCO2/MWh equals 1 kgCO2/kWh. The OM is a 2017-2019 generation-weighted average using the simple operating margin method; low-cost/must-run generation was below 50% of total generation.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.grid.national.bm.2021",
+    category: "grid_electricity",
+    subcategory: "national_grid_build_margin",
+    description: "West African Power Pool (WAPP) grid build margin CO2 emission factor, applicable to Nigeria as a WAPP member country",
+    value: 0.556,
+    unit: "kgCO2e_per_kWh",
+    gas: { CO2: 0.556, CH4: 0, N2O: 0 },
+    gwp_basis: "AR6",
+    scope: 2,
+    data_year: 2019,
+    published_year: 2021,
+    country: "NG",
+    region: "WAPP",
+    source: {
+      id: "WAPP_ASB0034_2021",
+      title: "Standardized Baseline for WAPP including Nigeria (ASB0034-2021)",
+      publisher: "UNFCCC / WAPP",
+      year: 2021,
+      page: "Section 7, Table 1"
+    },
+    additional_sources: [
+      {
+        id: "WAPP_ASB0034_ASSESSMENT",
+        title: "Assessment Report ASU006 ASB0034 WAPP",
+        publisher: "UNFCCC / WAPP",
+        year: 2021,
+        page: "Section B, Step 5"
+      },
+      {
+        id: "UNFCCC_CDM_TOOL07",
+        title: "UNFCCC CDM Methodological Tool 07 v7.0",
+        publisher: "UNFCCC",
+        year: 2021,
+        page: "Section 6.5, Step 5 / Equation 15"
+      }
+    ],
+    uncertainty_pct: 10,
+    confidence: "high",
+    methodology_note: "Build margin extracted directly from ASB0034-2021 Table 1 as 0.556 tCO2/MWh. Unit conversion to kgCO2e/kWh is 1:1. The BM represents the most-recent dispatchable capacity additions (2015-2019) comprising the 20% generation sample set, using 2019 generation data.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.grid.national.cm.2021",
+    category: "grid_electricity",
+    subcategory: "national_grid_combined_margin",
+    description: "West African Power Pool (WAPP) grid combined margin CO2 emission factor for wind and solar power generation project activities, first crediting period",
+    value: 0.573,
+    unit: "kgCO2e_per_kWh",
+    gas: { CO2: 0.573, CH4: 0, N2O: 0 },
+    gwp_basis: "AR6",
+    scope: 2,
+    data_year: 2019,
+    published_year: 2021,
+    country: "NG",
+    region: "WAPP",
+    source: {
+      id: "WAPP_ASB0034_2021",
+      title: "Standardized Baseline for WAPP including Nigeria (ASB0034-2021)",
+      publisher: "UNFCCC / WAPP",
+      year: 2021,
+      page: "Section 7, Table 1 (wind and solar row)"
+    },
+    additional_sources: [
+      {
+        id: "WAPP_ASB0034_ASSESSMENT",
+        title: "Assessment Report ASU006 ASB0034 WAPP",
+        publisher: "UNFCCC / WAPP",
+        year: 2021,
+        page: "Section B, Step 6"
+      },
+      {
+        id: "UNFCCC_CDM_TOOL07",
+        title: "UNFCCC CDM Methodological Tool 07 v7.0",
+        publisher: "UNFCCC",
+        year: 2021,
+        page: "Section 6.6.1, Equation 16"
+      }
+    ],
+    uncertainty_pct: 10,
+    confidence: "high",
+    methodology_note: "Combined margin extracted from ASB0034-2021 Table 1 as 0.573 tCO2/MWh for wind/solar project activities. Cross-check with TOOL07: CM = OM x 0.75 + BM x 0.25 = 0.578 x 0.75 + 0.556 x 0.25 = 0.5725, rounded to 0.573 tCO2/MWh. The general/other-projects first-crediting-period value is 0.567 tCO2/MWh (50/50 weights). Unit conversion to kgCO2e/kWh is 1:1.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.grid.national.location.2024",
+    category: "grid_electricity",
+    subcategory: "national_grid",
+    description: "Nigeria national grid location-based Scope 2 emission factor for 2024, derived from the NEFDB reconciled generation mix and IPCC 2006 default stationary-combustion emission factors.",
+    value: 0.138611,
+    unit: "kgCO2e_per_kWh",
+    gas: { CO2: 0.138477, CH4: 0.000069, N2O: 0.000065 },
+    gwp_basis: "AR5",
+    scope: 2,
+    data_year: 2024,
+    published_year: 2026,
+    country: "NG",
+    source: {
+      id: "NEFDB_RECONCILED_GENERATION_2024",
+      title: "Nigeria Generation Mix Reconciled 2024",
+      publisher: "NEFDB",
+      year: 2024,
+      page: "datasets/grid_electricity/derived/nigeria_generation_mix_reconciled.csv"
+    },
+    additional_sources: [
+      {
+        id: "IPCC_2006_VOL2_CH2",
+        title: "IPCC 2006 Guidelines Vol 2 Ch 2 Stationary Combustion",
+        publisher: "IPCC",
+        year: 2006,
+        page: "Table 2.2 (energy industries); Natural Gas CO2 56,100, CH4 1, N2O 0.1 kg/TJ; Residual Fuel Oil CO2 77,400, CH4 3, N2O 0.6 kg/TJ"
+      },
+      {
+        id: "GUARDIAN_NERC_2024",
+        title: "Guardian Nigeria summary of NERC 2024 annual statistics",
+        publisher: "Guardian Nigeria / NERC",
+        year: 2024
+      },
+      {
+        id: "EMBER_OWID_2024",
+        title: "Ember Yearly Electricity Data / Our World in Data energy dataset",
+        publisher: "Ember / OWID",
+        year: 2024
+      }
+    ],
+    uncertainty_pct: 15,
+    confidence: "medium",
+    methodology_note: "Calculated as a generation-weighted average: EF = (gas_generation_gwh * gas_ef_kgco2e_per_kwh + oil_generation_gwh * oil_ef_kgco2e_per_kwh) / total_generation_gwh. Gas EF = 0.202156 kgCO2e/kWh from IPCC Table 2.2 natural-gas defaults (CO2 56,100 + CH4 1*28 + N2O 0.1*265 kgCO2e/TJ, AR5 GWP) at 3.6 MJ/kWh. Oil EF = 0.279515 kgCO2e/kWh from IPCC Table 2.2 residual fuel oil defaults (CO2 77,400 + CH4 3*28 + N2O 0.6*265 kgCO2e/TJ). Hydro, solar, wind, biomass and other generation are treated as zero-emission. 2024 oil generation is zero, so the factor is driven entirely by gas-fired generation.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.grid.disco.aedc.2024",
+    category: "grid_electricity",
+    subcategory: "disco_location_based",
+    description: "DisCo-level location-based grid emission factor for AEDC based on Q2 2024 billed energy and a 2024 national generation mix with regional adjustment.",
+    value: 0.118396,
+    unit: "kgCO2e_per_kWh",
+    gas: { CO2: 0.1182809, CH4: 0.00005908, N2O: 0.00005565 },
+    gwp_basis: "AR5",
+    scope: 2,
+    data_year: 2024,
+    published_year: 2026,
+    country: "NG",
+    region: "North-Central (Abuja/FCT, Niger, Nasarawa, Kogi)",
+    disco: "AEDC",
+    source: {
+      id: "NBS_ELECTRICITY_DATA_2015_Q2_2024",
+      title: "Nigeria Electricity Data 2015–Q2 2024",
+      publisher: "NBS",
+      year: 2024
+    },
+    additional_sources: [
+      {
+        id: "NIGERIA_GENERATION_MIX_2024",
+        title: "Nigeria Generation Mix 2024 (NERC / Guardian Nigeria / NEFDB reconciled)",
+        publisher: "NERC / NEFDB",
+        year: 2024
+      },
+      {
+        id: "IPCC_2006_VOL2_CH2",
+        title: "IPCC 2006 Guidelines Vol 2 Ch 2 Stationary Combustion",
+        publisher: "IPCC",
+        year: 2006,
+        page: "Table 2.2"
+      }
+    ],
+    uncertainty_pct: 20,
+    confidence: "medium",
+    methodology_note: "Derived by applying a 58.57% gas / 40.92% hydro / 0.51% other regional generation mix to AEDC Q2 2024 billed energy (301.000 GWh) and IPCC 2006 stationary-combustion EFs for natural gas (CO2=56,100, CH4=1, N2O=0.1 kg/TJ) converted with AR5 GWP (CH4=28, N2O=265). Oil share is zero. Hydro/solar/wind/biomass treated as zero-emission. EF excludes T&D losses and upstream fugitive emissions.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.grid.disco.bedc.2024",
+    category: "grid_electricity",
+    subcategory: "disco_location_based",
+    description: "DisCo-level location-based grid emission factor for BEDC based on Q2 2024 billed energy and a 2024 national generation mix with regional adjustment.",
+    value: 0.142655,
+    unit: "kgCO2e_per_kWh",
+    gas: { CO2: 0.1425161, CH4: 0.00007112, N2O: 0.00006625 },
+    gwp_basis: "AR5",
+    scope: 2,
+    data_year: 2024,
+    published_year: 2026,
+    country: "NG",
+    region: "South-South/East (Edo, Delta, Ondo, Ekiti)",
+    disco: "BEDC",
+    source: {
+      id: "NBS_ELECTRICITY_DATA_2015_Q2_2024",
+      title: "Nigeria Electricity Data 2015–Q2 2024",
+      publisher: "NBS",
+      year: 2024
+    },
+    additional_sources: [
+      {
+        id: "NIGERIA_GENERATION_MIX_2024",
+        title: "Nigeria Generation Mix 2024 (NERC / Guardian Nigeria / NEFDB reconciled)",
+        publisher: "NERC / NEFDB",
+        year: 2024
+      },
+      {
+        id: "IPCC_2006_VOL2_CH2",
+        title: "IPCC 2006 Guidelines Vol 2 Ch 2 Stationary Combustion",
+        publisher: "IPCC",
+        year: 2006,
+        page: "Table 2.2"
+      }
+    ],
+    uncertainty_pct: 20,
+    confidence: "medium",
+    methodology_note: "Derived by applying a 70.57% gas / 28.92% hydro / 0.51% other regional generation mix to BEDC Q2 2024 billed energy (179.794 GWh) and IPCC 2006 stationary-combustion EFs for natural gas (CO2=56,100, CH4=1, N2O=0.1 kg/TJ) converted with AR5 GWP (CH4=28, N2O=265). Oil share is zero. Hydro/solar/wind/biomass treated as zero-emission. EF excludes T&D losses and upstream fugitive emissions.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.grid.disco.eedc.2024",
+    category: "grid_electricity",
+    subcategory: "disco_location_based",
+    description: "DisCo-level location-based grid emission factor for EEDC based on Q2 2024 billed energy and a 2024 national generation mix with regional adjustment.",
+    value: 0.16287,
+    unit: "kgCO2e_per_kWh",
+    gas: { CO2: 0.1627121, CH4: 0.0000812, N2O: 0.00007685 },
+    gwp_basis: "AR5",
+    scope: 2,
+    data_year: 2024,
+    published_year: 2026,
+    country: "NG",
+    region: "South-East (Enugu, Anambra, Abia, Imo, Ebonyi)",
+    disco: "EEDC",
+    source: {
+      id: "NBS_ELECTRICITY_DATA_2015_Q2_2024",
+      title: "Nigeria Electricity Data 2015–Q2 2024",
+      publisher: "NBS",
+      year: 2024
+    },
+    additional_sources: [
+      {
+        id: "NIGERIA_GENERATION_MIX_2024",
+        title: "Nigeria Generation Mix 2024 (NERC / Guardian Nigeria / NEFDB reconciled)",
+        publisher: "NERC / NEFDB",
+        year: 2024
+      },
+      {
+        id: "IPCC_2006_VOL2_CH2",
+        title: "IPCC 2006 Guidelines Vol 2 Ch 2 Stationary Combustion",
+        publisher: "IPCC",
+        year: 2006,
+        page: "Table 2.2"
+      }
+    ],
+    uncertainty_pct: 20,
+    confidence: "medium",
+    methodology_note: "Derived by applying a 80.57% gas / 18.92% hydro / 0.51% other regional generation mix to EEDC Q2 2024 billed energy (159.799 GWh) and IPCC 2006 stationary-combustion EFs for natural gas (CO2=56,100, CH4=1, N2O=0.1 kg/TJ) converted with AR5 GWP (CH4=28, N2O=265). Oil share is zero. Hydro/solar/wind/biomass treated as zero-emission. EF excludes T&D losses and upstream fugitive emissions.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.grid.disco.ekedc.2024",
+    category: "grid_electricity",
+    subcategory: "disco_location_based",
+    description: "DisCo-level location-based grid emission factor for EKEDC based on Q2 2024 billed energy and a 2024 national generation mix with regional adjustment.",
+    value: 0.16287,
+    unit: "kgCO2e_per_kWh",
+    gas: { CO2: 0.1627121, CH4: 0.0000812, N2O: 0.00007685 },
+    gwp_basis: "AR5",
+    scope: 2,
+    data_year: 2024,
+    published_year: 2026,
+    country: "NG",
+    region: "South (Lagos)",
+    disco: "EKEDC",
+    source: {
+      id: "NBS_ELECTRICITY_DATA_2015_Q2_2024",
+      title: "Nigeria Electricity Data 2015–Q2 2024",
+      publisher: "NBS",
+      year: 2024
+    },
+    additional_sources: [
+      {
+        id: "NIGERIA_GENERATION_MIX_2024",
+        title: "Nigeria Generation Mix 2024 (NERC / Guardian Nigeria / NEFDB reconciled)",
+        publisher: "NERC / NEFDB",
+        year: 2024
+      },
+      {
+        id: "IPCC_2006_VOL2_CH2",
+        title: "IPCC 2006 Guidelines Vol 2 Ch 2 Stationary Combustion",
+        publisher: "IPCC",
+        year: 2006,
+        page: "Table 2.2"
+      }
+    ],
+    uncertainty_pct: 20,
+    confidence: "medium",
+    methodology_note: "Derived by applying a 80.57% gas / 18.92% hydro / 0.51% other regional generation mix to EKEDC Q2 2024 billed energy (317.000 GWh) and IPCC 2006 stationary-combustion EFs for natural gas (CO2=56,100, CH4=1, N2O=0.1 kg/TJ) converted with AR5 GWP (CH4=28, N2O=265). Oil share is zero. Hydro/solar/wind/biomass treated as zero-emission. EF excludes T&D losses and upstream fugitive emissions.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.grid.disco.ibedc.2024",
+    category: "grid_electricity",
+    subcategory: "disco_location_based",
+    description: "DisCo-level location-based grid emission factor for IBEDC based on Q2 2024 billed energy and a 2024 national generation mix with regional adjustment.",
+    value: 0.142655,
+    unit: "kgCO2e_per_kWh",
+    gas: { CO2: 0.1425161, CH4: 0.00007112, N2O: 0.00006625 },
+    gwp_basis: "AR5",
+    scope: 2,
+    data_year: 2024,
+    published_year: 2026,
+    country: "NG",
+    region: "South-West (Oyo, Ogun, Osun, Kwara)",
+    disco: "IBEDC",
+    source: {
+      id: "NBS_ELECTRICITY_DATA_2015_Q2_2024",
+      title: "Nigeria Electricity Data 2015–Q2 2024",
+      publisher: "NBS",
+      year: 2024
+    },
+    additional_sources: [
+      {
+        id: "NIGERIA_GENERATION_MIX_2024",
+        title: "Nigeria Generation Mix 2024 (NERC / Guardian Nigeria / NEFDB reconciled)",
+        publisher: "NERC / NEFDB",
+        year: 2024
+      },
+      {
+        id: "IPCC_2006_VOL2_CH2",
+        title: "IPCC 2006 Guidelines Vol 2 Ch 2 Stationary Combustion",
+        publisher: "IPCC",
+        year: 2006,
+        page: "Table 2.2"
+      }
+    ],
+    uncertainty_pct: 20,
+    confidence: "medium",
+    methodology_note: "Derived by applying a 70.57% gas / 28.92% hydro / 0.51% other regional generation mix to IBEDC Q2 2024 billed energy (269.530 GWh) and IPCC 2006 stationary-combustion EFs for natural gas (CO2=56,100, CH4=1, N2O=0.1 kg/TJ) converted with AR5 GWP (CH4=28, N2O=265). Oil share is zero. Hydro/solar/wind/biomass treated as zero-emission. EF excludes T&D losses and upstream fugitive emissions.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.grid.disco.iedc.2024",
+    category: "grid_electricity",
+    subcategory: "disco_location_based",
+    description: "DisCo-level location-based grid emission factor for IEDC based on Q2 2024 billed energy and a 2024 national generation mix with regional adjustment.",
+    value: 0.142655,
+    unit: "kgCO2e_per_kWh",
+    gas: { CO2: 0.1425161, CH4: 0.00007112, N2O: 0.00006625 },
+    gwp_basis: "AR5",
+    scope: 2,
+    data_year: 2024,
+    published_year: 2026,
+    country: "NG",
+    region: "South-West (Lagos)",
+    disco: "IEDC",
+    source: {
+      id: "NBS_ELECTRICITY_DATA_2015_Q2_2024",
+      title: "Nigeria Electricity Data 2015–Q2 2024",
+      publisher: "NBS",
+      year: 2024
+    },
+    additional_sources: [
+      {
+        id: "NIGERIA_GENERATION_MIX_2024",
+        title: "Nigeria Generation Mix 2024 (NERC / Guardian Nigeria / NEFDB reconciled)",
+        publisher: "NERC / NEFDB",
+        year: 2024
+      },
+      {
+        id: "IPCC_2006_VOL2_CH2",
+        title: "IPCC 2006 Guidelines Vol 2 Ch 2 Stationary Combustion",
+        publisher: "IPCC",
+        year: 2006,
+        page: "Table 2.2"
+      }
+    ],
+    uncertainty_pct: 20,
+    confidence: "medium",
+    methodology_note: "Derived by applying a 70.57% gas / 28.92% hydro / 0.51% other regional generation mix to IEDC Q2 2024 billed energy (360.322 GWh) and IPCC 2006 stationary-combustion EFs for natural gas (CO2=56,100, CH4=1, N2O=0.1 kg/TJ) converted with AR5 GWP (CH4=28, N2O=265). Oil share is zero. Hydro/solar/wind/biomass treated as zero-emission. EF excludes T&D losses and upstream fugitive emissions.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.grid.disco.jedc.2024",
+    category: "grid_electricity",
+    subcategory: "disco_location_based",
+    description: "DisCo-level location-based grid emission factor for JEDC based on Q2 2024 billed energy and a 2024 national generation mix with regional adjustment.",
+    value: 0.118396,
+    unit: "kgCO2e_per_kWh",
+    gas: { CO2: 0.1182809, CH4: 0.00005908, N2O: 0.00005565 },
+    gwp_basis: "AR5",
+    scope: 2,
+    data_year: 2024,
+    published_year: 2026,
+    country: "NG",
+    region: "North (Plateau, Bauchi, Benue, Gombe)",
+    disco: "JEDC",
+    source: {
+      id: "NBS_ELECTRICITY_DATA_2015_Q2_2024",
+      title: "Nigeria Electricity Data 2015–Q2 2024",
+      publisher: "NBS",
+      year: 2024
+    },
+    additional_sources: [
+      {
+        id: "NIGERIA_GENERATION_MIX_2024",
+        title: "Nigeria Generation Mix 2024 (NERC / Guardian Nigeria / NEFDB reconciled)",
+        publisher: "NERC / NEFDB",
+        year: 2024
+      },
+      {
+        id: "IPCC_2006_VOL2_CH2",
+        title: "IPCC 2006 Guidelines Vol 2 Ch 2 Stationary Combustion",
+        publisher: "IPCC",
+        year: 2006,
+        page: "Table 2.2"
+      }
+    ],
+    uncertainty_pct: 20,
+    confidence: "medium",
+    methodology_note: "Derived by applying a 58.57% gas / 40.92% hydro / 0.51% other regional generation mix to JEDC Q2 2024 billed energy (105.606 GWh) and IPCC 2006 stationary-combustion EFs for natural gas (CO2=56,100, CH4=1, N2O=0.1 kg/TJ) converted with AR5 GWP (CH4=28, N2O=265). Oil share is zero. Hydro/solar/wind/biomass treated as zero-emission. EF excludes T&D losses and upstream fugitive emissions.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.grid.disco.kdedc.2024",
+    category: "grid_electricity",
+    subcategory: "disco_location_based",
+    description: "DisCo-level location-based grid emission factor for KDEDC based on Q2 2024 billed energy and a 2024 national generation mix with regional adjustment.",
+    value: 0.118396,
+    unit: "kgCO2e_per_kWh",
+    gas: { CO2: 0.1182809, CH4: 0.00005908, N2O: 0.00005565 },
+    gwp_basis: "AR5",
+    scope: 2,
+    data_year: 2024,
+    published_year: 2026,
+    country: "NG",
+    region: "North-West (Kaduna, Kebbi, Sokoto, Zamfara, Katsina)",
+    disco: "KDEDC",
+    source: {
+      id: "NBS_ELECTRICITY_DATA_2015_Q2_2024",
+      title: "Nigeria Electricity Data 2015–Q2 2024",
+      publisher: "NBS",
+      year: 2024
+    },
+    additional_sources: [
+      {
+        id: "NIGERIA_GENERATION_MIX_2024",
+        title: "Nigeria Generation Mix 2024 (NERC / Guardian Nigeria / NEFDB reconciled)",
+        publisher: "NERC / NEFDB",
+        year: 2024
+      },
+      {
+        id: "IPCC_2006_VOL2_CH2",
+        title: "IPCC 2006 Guidelines Vol 2 Ch 2 Stationary Combustion",
+        publisher: "IPCC",
+        year: 2006,
+        page: "Table 2.2"
+      }
+    ],
+    uncertainty_pct: 20,
+    confidence: "medium",
+    methodology_note: "Derived by applying a 58.57% gas / 40.92% hydro / 0.51% other regional generation mix to KDEDC Q2 2024 billed energy (83.220 GWh) and IPCC 2006 stationary-combustion EFs for natural gas (CO2=56,100, CH4=1, N2O=0.1 kg/TJ) converted with AR5 GWP (CH4=28, N2O=265). Oil share is zero. Hydro/solar/wind/biomass treated as zero-emission. EF excludes T&D losses and upstream fugitive emissions.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.grid.disco.kedc.2024",
+    category: "grid_electricity",
+    subcategory: "disco_location_based",
+    description: "DisCo-level location-based grid emission factor for KEDC based on Q2 2024 billed energy and a 2024 national generation mix with regional adjustment.",
+    value: 0.118396,
+    unit: "kgCO2e_per_kWh",
+    gas: { CO2: 0.1182809, CH4: 0.00005908, N2O: 0.00005565 },
+    gwp_basis: "AR5",
+    scope: 2,
+    data_year: 2024,
+    published_year: 2026,
+    country: "NG",
+    region: "North (Kano, Jigawa, Katsina)",
+    disco: "KEDC",
+    source: {
+      id: "NBS_ELECTRICITY_DATA_2015_Q2_2024",
+      title: "Nigeria Electricity Data 2015–Q2 2024",
+      publisher: "NBS",
+      year: 2024
+    },
+    additional_sources: [
+      {
+        id: "NIGERIA_GENERATION_MIX_2024",
+        title: "Nigeria Generation Mix 2024 (NERC / Guardian Nigeria / NEFDB reconciled)",
+        publisher: "NERC / NEFDB",
+        year: 2024
+      },
+      {
+        id: "IPCC_2006_VOL2_CH2",
+        title: "IPCC 2006 Guidelines Vol 2 Ch 2 Stationary Combustion",
+        publisher: "IPCC",
+        year: 2006,
+        page: "Table 2.2"
+      }
+    ],
+    uncertainty_pct: 20,
+    confidence: "medium",
+    methodology_note: "Derived by applying a 58.57% gas / 40.92% hydro / 0.51% other regional generation mix to KEDC Q2 2024 billed energy (124.576 GWh) and IPCC 2006 stationary-combustion EFs for natural gas (CO2=56,100, CH4=1, N2O=0.1 kg/TJ) converted with AR5 GWP (CH4=28, N2O=265). Oil share is zero. Hydro/solar/wind/biomass treated as zero-emission. EF excludes T&D losses and upstream fugitive emissions.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.grid.disco.pedc.2024",
+    category: "grid_electricity",
+    subcategory: "disco_location_based",
+    description: "DisCo-level location-based grid emission factor for PEDC based on Q2 2024 billed energy and a 2024 national generation mix with regional adjustment.",
+    value: 0.16287,
+    unit: "kgCO2e_per_kWh",
+    gas: { CO2: 0.1627121, CH4: 0.0000812, N2O: 0.00007685 },
+    gwp_basis: "AR5",
+    scope: 2,
+    data_year: 2024,
+    published_year: 2026,
+    country: "NG",
+    region: "South-South (Rivers, Cross River, Akwa Ibom)",
+    disco: "PEDC",
+    source: {
+      id: "NBS_ELECTRICITY_DATA_2015_Q2_2024",
+      title: "Nigeria Electricity Data 2015–Q2 2024",
+      publisher: "NBS",
+      year: 2024
+    },
+    additional_sources: [
+      {
+        id: "NIGERIA_GENERATION_MIX_2024",
+        title: "Nigeria Generation Mix 2024 (NERC / Guardian Nigeria / NEFDB reconciled)",
+        publisher: "NERC / NEFDB",
+        year: 2024
+      },
+      {
+        id: "IPCC_2006_VOL2_CH2",
+        title: "IPCC 2006 Guidelines Vol 2 Ch 2 Stationary Combustion",
+        publisher: "IPCC",
+        year: 2006,
+        page: "Table 2.2"
+      }
+    ],
+    uncertainty_pct: 20,
+    confidence: "medium",
+    methodology_note: "Derived by applying a 80.57% gas / 18.92% hydro / 0.51% other regional generation mix to PEDC Q2 2024 billed energy (149.914 GWh) and IPCC 2006 stationary-combustion EFs for natural gas (CO2=56,100, CH4=1, N2O=0.1 kg/TJ) converted with AR5 GWP (CH4=28, N2O=265). Oil share is zero. Hydro/solar/wind/biomass treated as zero-emission. EF excludes T&D losses and upstream fugitive emissions.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.grid.disco.yedc.2024",
+    category: "grid_electricity",
+    subcategory: "disco_location_based",
+    description: "DisCo-level location-based grid emission factor for YEDC based on Q2 2024 billed energy and a 2024 national generation mix with regional adjustment.",
+    value: 0.118396,
+    unit: "kgCO2e_per_kWh",
+    gas: { CO2: 0.1182809, CH4: 0.00005908, N2O: 0.00005565 },
+    gwp_basis: "AR5",
+    scope: 2,
+    data_year: 2024,
+    published_year: 2026,
+    country: "NG",
+    region: "North-East (Adamawa, Taraba, Yobe, Borno)",
+    disco: "YEDC",
+    source: {
+      id: "NBS_ELECTRICITY_DATA_2015_Q2_2024",
+      title: "Nigeria Electricity Data 2015–Q2 2024",
+      publisher: "NBS",
+      year: 2024
+    },
+    additional_sources: [
+      {
+        id: "NIGERIA_GENERATION_MIX_2024",
+        title: "Nigeria Generation Mix 2024 (NERC / Guardian Nigeria / NEFDB reconciled)",
+        publisher: "NERC / NEFDB",
+        year: 2024
+      },
+      {
+        id: "IPCC_2006_VOL2_CH2",
+        title: "IPCC 2006 Guidelines Vol 2 Ch 2 Stationary Combustion",
+        publisher: "IPCC",
+        year: 2006,
+        page: "Table 2.2"
+      }
+    ],
+    uncertainty_pct: 20,
+    confidence: "medium",
+    methodology_note: "Derived by applying a 58.57% gas / 40.92% hydro / 0.51% other regional generation mix to YEDC Q2 2024 billed energy (93.852 GWh) and IPCC 2006 stationary-combustion EFs for natural gas (CO2=56,100, CH4=1, N2O=0.1 kg/TJ) converted with AR5 GWP (CH4=28, N2O=265). Oil share is zero. Hydro/solar/wind/biomass treated as zero-emission. EF excludes T&D losses and upstream fugitive emissions.",
+    nefdb_version: "1.0.0"
+  }
+];
+
+// src/factors/transport.ts
+var transportFactors = [
+  {
+    id: "ng.transport.road.petrol.per_litre",
+    category: "transport",
+    subcategory: "road_fuel_petrol",
+    description: "Nigeria fuel-based Scope 1 emission factor for petrol combustion in road transport, expressed per litre",
+    value: 2.354,
+    unit: "kgCO2e_per_litre",
+    gas: null,
+    gwp_basis: "AR5",
+    scope: 1,
+    data_year: 2024,
+    published_year: 2026,
+    country: "NG",
+    source: {
+      id: "IPCC_2006_VOL2_CH3",
+      title: "IPCC 2006 Guidelines Vol 2 Ch 3 Mobile Combustion",
+      publisher: "IPCC",
+      year: 2006,
+      page: "Table 3.2.1 (road vehicles, gasoline default CO2; converted with AR5 GWP)"
+    },
+    additional_sources: [
+      {
+        id: "DEFRA_2024_FULL",
+        title: "UK DESNZ/DEFRA 2024 GHG Conversion Factors Full Set",
+        publisher: "UK DESNZ",
+        year: 2024
+      },
+      {
+        id: "EPA_GHG_HUB_2024",
+        title: "EPA GHG Emission Factors Hub 2024",
+        publisher: "US EPA",
+        year: 2024
+      }
+    ],
+    uncertainty_pct: 10,
+    confidence: "high",
+    methodology_note: "DEFRA 2024 100% mineral petrol; IPCC 2006 Vol2 Ch3 corroborates. Primary fuel-based road factor.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.transport.road.diesel.per_litre",
+    category: "transport",
+    subcategory: "road_fuel_diesel",
+    description: "Nigeria fuel-based Scope 1 emission factor for diesel combustion in road transport, expressed per litre",
+    value: 2.662,
+    unit: "kgCO2e_per_litre",
+    gas: null,
+    gwp_basis: "AR5",
+    scope: 1,
+    data_year: 2024,
+    published_year: 2026,
+    country: "NG",
+    source: {
+      id: "IPCC_2006_VOL2_CH3",
+      title: "IPCC 2006 Guidelines Vol 2 Ch 3 Mobile Combustion",
+      publisher: "IPCC",
+      year: 2006,
+      page: "Table 3.2.1 (road vehicles, diesel oil default CO2; converted with AR5 GWP)"
+    },
+    additional_sources: [
+      {
+        id: "DEFRA_2024_FULL",
+        title: "UK DESNZ/DEFRA 2024 GHG Conversion Factors Full Set",
+        publisher: "UK DESNZ",
+        year: 2024
+      },
+      {
+        id: "EPA_GHG_HUB_2024",
+        title: "EPA GHG Emission Factors Hub 2024",
+        publisher: "US EPA",
+        year: 2024
+      }
+    ],
+    uncertainty_pct: 10,
+    confidence: "high",
+    methodology_note: "DEFRA 2024 100% mineral diesel; IPCC 2006 Vol2 Ch3 corroborates. Primary fuel-based road factor.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.transport.road.petrol.car",
+    category: "transport",
+    subcategory: "road_petrol_car",
+    description: "Distance-based Scope 1 emission factor for average petrol passenger car in Nigeria",
+    value: 0.165,
+    unit: "kgCO2e_per_km",
+    gas: null,
+    gwp_basis: "AR5",
+    scope: 1,
+    data_year: 2024,
+    published_year: 2026,
+    country: "NG",
+    source: {
+      id: "IPCC_2006_VOL2_CH3",
+      title: "IPCC 2006 Guidelines Vol 2 Ch 3 Mobile Combustion",
+      publisher: "IPCC",
+      year: 2006,
+      page: "Table 3.2.1 default fuel EF, applied to DEFRA 2024 fuel consumption"
+    },
+    additional_sources: [
+      {
+        id: "DEFRA_2024_FULL",
+        title: "UK DESNZ/DEFRA 2024 GHG Conversion Factors Full Set",
+        publisher: "UK DESNZ",
+        year: 2024
+      },
+      {
+        id: "WB_LOW_CARBON_DEVELOPMENT_NIGERIA_2013",
+        title: "Assessing Low-Carbon Development in Nigeria: An Analysis of Four Sectors",
+        publisher: "World Bank",
+        year: 2013
+      }
+    ],
+    uncertainty_pct: 20,
+    confidence: "medium",
+    methodology_note: "DEFRA 2024 average petrol car per-km factor (0.1645 kgCO2e/km) used as a Nigeria proxy, rounded to 0.165. UK fuel-consumption proxy (6.954 L/100km) is shown for reference. Flagged medium confidence because Nigeria-specific VKT/fuel-economy data is unavailable.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.transport.road.diesel.car",
+    category: "transport",
+    subcategory: "road_diesel_car",
+    description: "Distance-based Scope 1 emission factor for average diesel passenger car in Nigeria",
+    value: 0.17,
+    unit: "kgCO2e_per_km",
+    gas: null,
+    gwp_basis: "AR5",
+    scope: 1,
+    data_year: 2024,
+    published_year: 2026,
+    country: "NG",
+    source: {
+      id: "IPCC_2006_VOL2_CH3",
+      title: "IPCC 2006 Guidelines Vol 2 Ch 3 Mobile Combustion",
+      publisher: "IPCC",
+      year: 2006,
+      page: "Table 3.2.1 default fuel EF, applied to DEFRA 2024 fuel consumption"
+    },
+    additional_sources: [
+      {
+        id: "DEFRA_2024_FULL",
+        title: "UK DESNZ/DEFRA 2024 GHG Conversion Factors Full Set",
+        publisher: "UK DESNZ",
+        year: 2024
+      },
+      {
+        id: "WB_LOW_CARBON_DEVELOPMENT_NIGERIA_2013",
+        title: "Assessing Low-Carbon Development in Nigeria: An Analysis of Four Sectors",
+        publisher: "World Bank",
+        year: 2013
+      }
+    ],
+    uncertainty_pct: 20,
+    confidence: "medium",
+    methodology_note: "DEFRA 2024 average diesel car per-km factor (0.16984 kgCO2e/km) used as a Nigeria proxy, rounded to 0.170. UK fuel-consumption proxy (6.316 L/100km) is shown for reference.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.transport.road.petrol.motorcycle",
+    category: "transport",
+    subcategory: "road_petrol_motorcycle",
+    description: "Distance-based Scope 1 emission factor for petrol motorcycle in Nigeria",
+    value: 0.114,
+    unit: "kgCO2e_per_km",
+    gas: null,
+    gwp_basis: "AR5",
+    scope: 1,
+    data_year: 2024,
+    published_year: 2026,
+    country: "NG",
+    source: {
+      id: "IPCC_2006_VOL2_CH3",
+      title: "IPCC 2006 Guidelines Vol 2 Ch 3 Mobile Combustion",
+      publisher: "IPCC",
+      year: 2006,
+      page: "Table 3.2.1 default fuel EF, applied to DEFRA 2024 fuel consumption"
+    },
+    additional_sources: [
+      {
+        id: "DEFRA_2024_FULL",
+        title: "UK DESNZ/DEFRA 2024 GHG Conversion Factors Full Set",
+        publisher: "UK DESNZ",
+        year: 2024
+      },
+      {
+        id: "WB_LOW_CARBON_DEVELOPMENT_NIGERIA_2013",
+        title: "Assessing Low-Carbon Development in Nigeria: An Analysis of Four Sectors",
+        publisher: "World Bank",
+        year: 2013
+      }
+    ],
+    uncertainty_pct: 30,
+    confidence: "low",
+    methodology_note: "DEFRA 2024 average motorbike per-km factor (0.11367 kgCO2e/km) used as a Nigeria proxy, rounded to 0.114. Nigeria-specific data unavailable.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.transport.road.diesel.bus",
+    category: "transport",
+    subcategory: "road_diesel_bus",
+    description: "Distance-based Scope 1 emission factor for diesel bus in Nigeria, expressed per vehicle-km",
+    value: 3.254,
+    unit: "kgCO2e_per_km",
+    gas: null,
+    gwp_basis: "AR5",
+    scope: 1,
+    data_year: 2024,
+    published_year: 2026,
+    country: "NG",
+    source: {
+      id: "IPCC_2006_VOL2_CH3",
+      title: "IPCC 2006 Guidelines Vol 2 Ch 3 Mobile Combustion",
+      publisher: "IPCC",
+      year: 2006,
+      page: "Table 3.2.1 default fuel EF, applied to DEFRA 2024 passenger-km factor and occupancy assumption"
+    },
+    additional_sources: [
+      {
+        id: "ICCT_SOOTFREE_2019",
+        title: "Soot-Free Transport for Nigeria",
+        publisher: "ICCT",
+        year: 2019
+      },
+      {
+        id: "DEFRA_2024_FULL",
+        title: "UK DESNZ/DEFRA 2024 GHG Conversion Factors Full Set",
+        publisher: "UK DESNZ",
+        year: 2024
+      },
+      {
+        id: "WB_LOW_CARBON_DEVELOPMENT_NIGERIA_2013",
+        title: "Assessing Low-Carbon Development in Nigeria: An Analysis of Four Sectors",
+        publisher: "World Bank",
+        year: 2013
+      }
+    ],
+    uncertainty_pct: 35,
+    confidence: "low",
+    methodology_note: "Derived from DEFRA 2024 average local bus passenger-km factor and a 30-passenger occupancy assumption to convert to vehicle-km. Highly sensitive to occupancy; flagged low confidence.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.transport.road.diesel.truck.small",
+    category: "transport",
+    subcategory: "road_diesel_light_truck",
+    description: "Distance-based Scope 1 emission factor for small diesel truck/van in Nigeria",
+    value: 0.25,
+    unit: "kgCO2e_per_km",
+    gas: null,
+    gwp_basis: "AR5",
+    scope: 1,
+    data_year: 2024,
+    published_year: 2026,
+    country: "NG",
+    source: {
+      id: "IPCC_2006_VOL2_CH3",
+      title: "IPCC 2006 Guidelines Vol 2 Ch 3 Mobile Combustion",
+      publisher: "IPCC",
+      year: 2006,
+      page: "Table 3.2.1 default fuel EF, applied to DEFRA 2024 fuel consumption"
+    },
+    additional_sources: [
+      {
+        id: "DEFRA_2024_FULL",
+        title: "UK DESNZ/DEFRA 2024 GHG Conversion Factors Full Set",
+        publisher: "UK DESNZ",
+        year: 2024
+      },
+      {
+        id: "WB_LOW_CARBON_DEVELOPMENT_NIGERIA_2013",
+        title: "Assessing Low-Carbon Development in Nigeria: An Analysis of Four Sectors",
+        publisher: "World Bank",
+        year: 2013
+      }
+    ],
+    uncertainty_pct: 20,
+    confidence: "medium",
+    methodology_note: "DEFRA 2024 average diesel van per-km factor (0.25023 kgCO2e/km) used as a Nigeria proxy, rounded to 0.250. UK fuel-consumption proxy (9.306 L/100km) is shown for reference.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.transport.road.diesel.truck.heavy",
+    category: "transport",
+    subcategory: "road_diesel_heavy_truck",
+    description: "Distance-based Scope 1 emission factor for heavy diesel goods vehicle in Nigeria",
+    value: 0.873,
+    unit: "kgCO2e_per_km",
+    gas: null,
+    gwp_basis: "AR5",
+    scope: 1,
+    data_year: 2024,
+    published_year: 2026,
+    country: "NG",
+    source: {
+      id: "IPCC_2006_VOL2_CH3",
+      title: "IPCC 2006 Guidelines Vol 2 Ch 3 Mobile Combustion",
+      publisher: "IPCC",
+      year: 2006,
+      page: "Table 3.2.1 default fuel EF, applied to DEFRA 2024 fuel consumption"
+    },
+    additional_sources: [
+      {
+        id: "DEFRA_2024_FULL",
+        title: "UK DESNZ/DEFRA 2024 GHG Conversion Factors Full Set",
+        publisher: "UK DESNZ",
+        year: 2024
+      },
+      {
+        id: "WB_LOW_CARBON_DEVELOPMENT_NIGERIA_2013",
+        title: "Assessing Low-Carbon Development in Nigeria: An Analysis of Four Sectors",
+        publisher: "World Bank",
+        year: 2013
+      }
+    ],
+    uncertainty_pct: 20,
+    confidence: "medium",
+    methodology_note: "DEFRA 2024 average diesel HGV per-km factor (0.87296 kgCO2e/km) used as a Nigeria proxy, rounded to 0.873. UK fuel-consumption proxy (32.464 L/100km) is shown for reference.",
+    nefdb_version: "1.0.0"
+  }
+];
+
+// src/factors/waste.ts
+var wasteFactors = [
+  {
+    id: "ng.waste.msw.landfill.managed",
+    category: "waste",
+    subcategory: "msw_landfill_managed",
+    description: "Scope 1 emission factor for managed municipal solid waste (MSW) landfill disposal in Nigeria, per tonne of waste",
+    value: 1260,
+    unit: "kgCO2e_per_tonne",
+    gas: null,
+    gwp_basis: "AR5",
+    scope: 1,
+    data_year: 2024,
+    published_year: 2026,
+    country: "NG",
+    region: "NG",
+    source: {
+      id: "IPCC_2006_VOL5_CH3",
+      title: "IPCC 2006 Guidelines Vol 5 Ch 3 Solid Waste Disposal",
+      publisher: "IPCC",
+      year: 2006,
+      page: "Tier 1 mass-balance potential (Eq. 3.1–3.5)"
+    },
+    additional_sources: [
+      {
+        id: "NIGERIA_NIR1",
+        title: "Nigeria First National Inventory Report 2000-2017",
+        publisher: "Federal Republic of Nigeria",
+        year: 2021
+      }
+    ],
+    uncertainty_pct: 20,
+    confidence: "high",
+    methodology_note: "IPCC 2006 Vol5 Ch3 Tier 1 mass-balance potential with Lagos metropolis mean composition, DOCf=0.5, F=0.5, OX=0.1, MCF=1.0; 1,262 kgCO2e/t → 1,260. Olusosun deep-dump MCF=0.8 is noted as a site-specific cross-check.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.waste.msw.open_dump",
+    category: "waste",
+    subcategory: "msw_open_dump",
+    description: "Scope 1 emission factor for unmanaged MSW open dumping in Nigeria, per tonne of waste",
+    value: 561,
+    unit: "kgCO2e_per_tonne",
+    gas: null,
+    gwp_basis: "AR5",
+    scope: 1,
+    data_year: 2024,
+    published_year: 2026,
+    country: "NG",
+    region: "NG",
+    source: {
+      id: "IPCC_2006_VOL5_CH3",
+      title: "IPCC 2006 Guidelines Vol 5 Ch 3 Solid Waste Disposal",
+      publisher: "IPCC",
+      year: 2006,
+      page: "Tier 1 mass-balance potential; unmanaged deep dump MCF default"
+    },
+    additional_sources: [
+      {
+        id: "NIGERIA_NIR1",
+        title: "Nigeria First National Inventory Report 2000-2017",
+        publisher: "Federal Republic of Nigeria",
+        year: 2021
+      }
+    ],
+    uncertainty_pct: 25,
+    confidence: "medium",
+    methodology_note: "Same composition as managed landfill; OX=0, MCF=0.4 (NIR1 / IPCC default for unmanaged deep dump).",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.waste.msw.open_burning",
+    category: "waste",
+    subcategory: "msw_open_burning",
+    description: "Scope 1 emission factor for MSW open burning in Nigeria, per tonne of waste burned",
+    value: 268,
+    unit: "kgCO2e_per_tonne",
+    gas: null,
+    gwp_basis: "AR5",
+    scope: 1,
+    data_year: 2024,
+    published_year: 2026,
+    country: "NG",
+    region: "NG",
+    source: {
+      id: "IPCC_2006_VOL5_CH5",
+      title: "IPCC 2006 Guidelines Vol 5 Ch 5 Incineration and Open Burning of Waste",
+      publisher: "IPCC",
+      year: 2006,
+      page: "Table 5.7 (open burning defaults)"
+    },
+    additional_sources: [
+      {
+        id: "NIGERIA_OPEN_BURNING",
+        title: "Nigeria Open Burning Factsheet",
+        publisher: "regulatory_mrv datasets",
+        year: 2021
+      }
+    ],
+    uncertainty_pct: 35,
+    confidence: "medium",
+    methodology_note: "IPCC 2006 Vol5 Ch5 Table 5.7 defaults: fossil CO2=33 kg/t, CH4=6.5 kg/t, N2O=0.2 kg/t; CO2e = 33 + 6.5×28 + 0.2×265 = 268.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.waste.organic.composting",
+    category: "waste",
+    subcategory: "organic_composting",
+    description: "Scope 1 emission factor for aerobic composting of organic waste in Nigeria, per tonne of input waste",
+    value: 176,
+    unit: "kgCO2e_per_tonne",
+    gas: null,
+    gwp_basis: "AR5",
+    scope: 1,
+    data_year: 2024,
+    published_year: 2026,
+    country: "NG",
+    region: "NG",
+    source: {
+      id: "IPCC_2006_VOL5_CH4",
+      title: "IPCC 2006 Guidelines Vol 5 Ch 4 Biological Treatment of Solid Waste",
+      publisher: "IPCC",
+      year: 2006,
+      page: "Table 4.1 (CH4 and N2O defaults)"
+    },
+    uncertainty_pct: 25,
+    confidence: "high",
+    methodology_note: "IPCC 2006 Vol5 Ch4 Table 4.1: CH4=4 kg/t, N2O=0.24 kg/t.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.waste.wastewater.domestic",
+    category: "waste",
+    subcategory: "wastewater_domestic",
+    description: "Scope 1 emission factor for domestic wastewater treatment and discharge in Nigeria, per cubic metre of wastewater",
+    value: 0.758,
+    unit: "kgCO2e_per_m3",
+    gas: null,
+    gwp_basis: "AR5",
+    scope: 1,
+    data_year: 2017,
+    published_year: 2026,
+    country: "NG",
+    region: "NG",
+    source: {
+      id: "IPCC_2006_VOL5_CH6",
+      title: "IPCC 2006 Guidelines Vol 5 Ch 6 Wastewater Treatment and Discharge",
+      publisher: "IPCC",
+      year: 2006,
+      page: "Eq. 6.1–6.3 (domestic wastewater Tier 1)"
+    },
+    additional_sources: [
+      {
+        id: "NIGERIA_NIR1",
+        title: "Nigeria First National Inventory Report 2000-2017",
+        publisher: "Federal Republic of Nigeria",
+        year: 2021
+      },
+      {
+        id: "OKE_AFA_WWTP_2021",
+        title: "Oke-Afa Wastewater Treatment Plant Characterisation Study",
+        publisher: "Lagos State Wastewater Management Office / NEFDB",
+        year: 2021
+      }
+    ],
+    uncertainty_pct: 30,
+    confidence: "medium",
+    methodology_note: "Bo=0.6 kg CH4/kg BOD; weighted national MCF=0.354 derived from NIR1 2017 emissions/TOW; influent BOD 0.1275 kg/m3 from Oke-Afa WWTP; per m3 = 0.6×0.354×0.1275×28 = 0.758.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.waste.wastewater.industrial",
+    category: "waste",
+    subcategory: "wastewater_industrial",
+    description: "Scope 1 emission factor for industrial wastewater treatment and discharge in Nigeria, per kilogram of COD removed/treated",
+    value: 2.1,
+    unit: "kgCO2e_per_kg",
+    gas: null,
+    gwp_basis: "AR5",
+    scope: 1,
+    data_year: 2024,
+    published_year: 2026,
+    country: "NG",
+    region: "NG",
+    source: {
+      id: "IPCC_2006_VOL5_CH6",
+      title: "IPCC 2006 Guidelines Vol 5 Ch 6 Wastewater Treatment and Discharge",
+      publisher: "IPCC",
+      year: 2006,
+      page: "Eq. 6.3 (industrial wastewater Tier 1)"
+    },
+    uncertainty_pct: 40,
+    confidence: "low",
+    methodology_note: "Bo=0.25 kg CH4/kg COD, conservative MCF=0.3; per kg COD = 0.25×0.3×28 = 2.10. The unit kgCO2e_per_kg is per kilogram of COD.",
+    nefdb_version: "1.0.0"
+  }
+];
+
+// src/factors/water.ts
+var waterFactors = [
+  {
+    id: "ng.water.treatment.supply",
+    category: "water",
+    subcategory: "water_supply",
+    description: "Scope 2 emission factor for treated water supply in Nigeria, per cubic metre supplied",
+    value: 0.103,
+    unit: "kgCO2e_per_m3",
+    gas: null,
+    gwp_basis: "AR5",
+    scope: 2,
+    data_year: 2024,
+    published_year: 2026,
+    country: "NG",
+    region: "NG",
+    source: {
+      id: "DEFRA_2024_FULL",
+      title: "UK DESNZ/DEFRA 2024 GHG Conversion Factors Full Set",
+      publisher: "UK DESNZ",
+      year: 2024
+    },
+    additional_sources: [
+      {
+        id: "NEFDB_RECONCILED_GENERATION_2024",
+        title: "Nigeria Generation Mix Reconciled 2024",
+        publisher: "NEFDB",
+        year: 2024
+      }
+    ],
+    uncertainty_pct: 30,
+    confidence: "medium",
+    methodology_note: "DEFRA 2024 water supply factor 0.15311 kgCO2e/m3 ÷ UK grid 0.20705 kgCO2e/kWh → 0.739 kWh/m3; × Nigeria grid ng.grid.national.location.2024 (0.138611) → 0.103.",
+    nefdb_version: "1.0.0"
+  },
+  {
+    id: "ng.water.treatment.wastewater",
+    category: "water",
+    subcategory: "water_wastewater_treatment",
+    description: "Scope 2 emission factor for wastewater treatment services in Nigeria, per cubic metre treated",
+    value: 0.124,
+    unit: "kgCO2e_per_m3",
+    gas: null,
+    gwp_basis: "AR5",
+    scope: 2,
+    data_year: 2024,
+    published_year: 2026,
+    country: "NG",
+    region: "NG",
+    source: {
+      id: "DEFRA_2024_FULL",
+      title: "UK DESNZ/DEFRA 2024 GHG Conversion Factors Full Set",
+      publisher: "UK DESNZ",
+      year: 2024
+    },
+    additional_sources: [
+      {
+        id: "NEFDB_RECONCILED_GENERATION_2024",
+        title: "Nigeria Generation Mix Reconciled 2024",
+        publisher: "NEFDB",
+        year: 2024
+      }
+    ],
+    uncertainty_pct: 30,
+    confidence: "medium",
+    methodology_note: "DEFRA 2024 water treatment factor 0.18574 kgCO2e/m3 ÷ UK grid 0.20705 → 0.897 kWh/m3; × Nigeria grid 0.138611 → 0.124.",
+    nefdb_version: "1.0.0"
+  }
+];
+
+// src/factors/index.ts
+var allFactors = [
+  ...aviationFactors,
+  ...gridElectricityFactors,
+  ...fuelCombustionFactors,
+  ...transportFactors,
+  ...wasteFactors,
+  ...waterFactors
+];
+
+// src/api/aviation.ts
+function toFactorView(factor, options) {
+  if (options?.full)
+    return factor;
+  if (options?.withSource) {
+    return {
+      id: factor.id,
+      value: factor.value,
+      unit: factor.unit,
+      source: factor.source
+    };
+  }
+  return { id: factor.id, value: factor.value, unit: factor.unit };
+}
+var RF_MULTIPLIER = 1.9;
+function route(origin, destination, options) {
+  const a = origin.toLowerCase();
+  const b = destination.toLowerCase();
+  const forwardId = `ng.aviation.domestic.${a}_${b}`;
+  const reverseId = `ng.aviation.domestic.${b}_${a}`;
+  const base = allFactors.find((f) => f.id === forwardId) ?? allFactors.find((f) => f.id === reverseId);
+  if (!base)
+    return;
+  if (!options?.rf) {
+    return toFactorView(base, options);
+  }
+  const adjustedValue = base.value * RF_MULTIPLIER;
+  if (options.full) {
+    return { ...base, value: adjustedValue };
+  }
+  if (options.withSource) {
+    return {
+      id: base.id,
+      value: adjustedValue,
+      unit: base.unit,
+      source: base.source
+    };
+  }
+  return {
+    id: base.id,
+    value: adjustedValue,
+    unit: base.unit
+  };
+}
+
+// src/api/fuel.ts
+var exports_fuel = {};
+__export(exports_fuel, {
+  petrol: () => petrol,
+  naturalGas: () => naturalGas,
+  lpg: () => lpg,
+  hfo: () => hfo,
+  diesel: () => diesel,
+  cng: () => cng
+});
+function toFactorView2(factor, options) {
+  if (options?.full)
+    return factor;
+  if (options?.withSource) {
+    return {
+      id: factor.id,
+      value: factor.value,
+      unit: factor.unit,
+      source: factor.source
+    };
+  }
+  return { id: factor.id, value: factor.value, unit: factor.unit };
+}
+function find(id, options) {
+  const factor = allFactors.find((f) => f.id === id);
+  return factor ? toFactorView2(factor, options) : undefined;
+}
+function petrol(options) {
+  return find("ng.fuel.petrol.stationary", options);
+}
+function lpg(options) {
+  return find("ng.fuel.lpg.stationary", options);
+}
+function cng(options) {
+  return find("ng.fuel.cng.stationary", options);
+}
+function naturalGas(options) {
+  return find("ng.fuel.naturalgas.stationary", options);
+}
+function hfo(options) {
+  return find("ng.fuel.hfo.stationary", options);
+}
+function diesel(options) {
+  const per_litre = find("ng.fuel.diesel.stationary", options);
+  if (!per_litre)
+    return;
+  return {
+    per_litre,
+    per_kwh: {
+      rated: find("ng.fuel.diesel.stationary.kwh.rated", options),
+      field: find("ng.fuel.diesel.stationary.kwh.field", options)
+    }
+  };
+}
+
+// src/api/grid.ts
+var exports_grid = {};
+__export(exports_grid, {
+  national: () => national,
+  disco: () => disco
+});
+function toFactorView3(factor, options) {
+  if (options?.full)
+    return factor;
+  if (options?.withSource) {
+    return {
+      id: factor.id,
+      value: factor.value,
+      unit: factor.unit,
+      source: factor.source
+    };
+  }
+  return { id: factor.id, value: factor.value, unit: factor.unit };
+}
+var NATIONAL_IDS = {
+  om: "ng.grid.national.om.2021",
+  bm: "ng.grid.national.bm.2021",
+  cm: "ng.grid.national.cm.2021",
+  location: "ng.grid.national.location.2024"
+};
+function national(marginOrOptions, options) {
+  const margin = typeof marginOrOptions === "string" ? marginOrOptions : "cm";
+  const opts = typeof marginOrOptions === "string" ? options : marginOrOptions;
+  const factor = allFactors.find((f) => f.id === NATIONAL_IDS[margin]);
+  return factor ? toFactorView3(factor, opts) : undefined;
+}
+function disco(name, options) {
+  const factor = allFactors.find((f) => f.disco === name && f.id.startsWith("ng.grid.disco.") && f.id.endsWith(".2024"));
+  return factor ? toFactorView3(factor, options) : undefined;
+}
+
+// src/api/transport.ts
+var exports_transport = {};
+__export(exports_transport, {
+  road: () => road
+});
+function toFactorView4(factor, options) {
+  if (options?.full)
+    return factor;
+  if (options?.withSource) {
+    return {
+      id: factor.id,
+      value: factor.value,
+      unit: factor.unit,
+      source: factor.source
+    };
+  }
+  return { id: factor.id, value: factor.value, unit: factor.unit };
+}
+function road(fuel, vehicle, options) {
+  if (!vehicle) {
+    const factor2 = allFactors.find((f) => f.id === `ng.transport.road.${fuel}.per_litre`);
+    return factor2 ? toFactorView4(factor2, options) : undefined;
+  }
+  const factor = allFactors.find((f) => f.id === `ng.transport.road.${fuel}.${vehicle}`);
+  return factor ? toFactorView4(factor, options) : undefined;
+}
+
+// src/api/waste.ts
+var exports_waste = {};
+__export(exports_waste, {
+  wastewater: () => wastewater,
+  msw: () => msw,
+  composting: () => composting
+});
+function toFactorView5(factor, options) {
+  if (options?.full)
+    return factor;
+  if (options?.withSource) {
+    return {
+      id: factor.id,
+      value: factor.value,
+      unit: factor.unit,
+      source: factor.source
+    };
+  }
+  return { id: factor.id, value: factor.value, unit: factor.unit };
+}
+function find2(id, options) {
+  const factor = allFactors.find((f) => f.id === id);
+  return factor ? toFactorView5(factor, options) : undefined;
+}
+function msw(type, options) {
+  const idMap = {
+    landfill_managed: "ng.waste.msw.landfill.managed",
+    open_dump: "ng.waste.msw.open_dump",
+    open_burning: "ng.waste.msw.open_burning"
+  };
+  return find2(idMap[type], options);
+}
+function composting(options) {
+  return find2("ng.waste.organic.composting", options);
+}
+function wastewater(type, options) {
+  if (type !== "domestic" && type !== "industrial")
+    return;
+  const id = type === "domestic" ? "ng.waste.wastewater.domestic" : "ng.waste.wastewater.industrial";
+  return find2(id, options);
+}
+
+// src/api/water.ts
+var exports_water = {};
+__export(exports_water, {
+  wastewater: () => wastewater2,
+  supply: () => supply
+});
+function toFactorView6(factor, options) {
+  if (options?.full)
+    return factor;
+  if (options?.withSource) {
+    return {
+      id: factor.id,
+      value: factor.value,
+      unit: factor.unit,
+      source: factor.source
+    };
+  }
+  return { id: factor.id, value: factor.value, unit: factor.unit };
+}
+function find3(id, options) {
+  const factor = allFactors.find((f) => f.id === id);
+  return factor ? toFactorView6(factor, options) : undefined;
+}
+function supply(options) {
+  return find3("ng.water.treatment.supply", options);
+}
+function wastewater2(options) {
+  return find3("ng.water.treatment.wastewater", options);
+}
+
+// src/query.ts
+function toFactorView7(factor, options) {
+  if (options?.full)
+    return factor;
+  if (options?.withSource) {
+    return {
+      id: factor.id,
+      value: factor.value,
+      unit: factor.unit,
+      source: factor.source
+    };
+  }
+  return { id: factor.id, value: factor.value, unit: factor.unit };
+}
+function get(id, options) {
+  const factor = allFactors.find((f) => f.id === id);
+  return factor ? toFactorView7(factor, options) : undefined;
+}
+function query(filter, options) {
+  const entries = Object.entries(filter);
+  const matches = allFactors.filter((factor) => {
+    for (const [key, value] of entries) {
+      if (key === "source" && value && typeof value === "object") {
+        const sourceId = value.id;
+        if (sourceId !== undefined && factor.source.id !== sourceId) {
+          return false;
+        }
+        continue;
+      }
+      if (factor[key] !== value) {
+        return false;
+      }
+    }
+    return true;
+  });
+  return matches.map((factor) => toFactorView7(factor, options));
+}
+function list(options) {
+  return allFactors.map((factor) => toFactorView7(factor, options));
+}
+
+// src/index.ts
+function usedSources() {
+  const seen = new Map;
+  for (const factor of allFactors) {
+    seen.set(factor.source.id, factor.source);
+    for (const source of factor.additional_sources ?? []) {
+      seen.set(source.id, source);
+    }
+  }
+  return Array.from(seen.values());
+}
+var nefdb = {
+  list,
+  get,
+  query,
+  aviation: exports_aviation,
+  fuel: exports_fuel,
+  grid: exports_grid,
+  transport: exports_transport,
+  waste: exports_waste,
+  water: exports_water,
+  version: () => "1.0.0",
+  sources: usedSources
+};
+export {
+  exports_water as water,
+  exports_waste as waste,
+  exports_transport as transport,
+  query,
+  nefdb,
+  list,
+  exports_grid as grid,
+  get,
+  exports_fuel as fuel,
+  exports_aviation as aviation
+};