holosphere 1.1.7 → 1.1.9

package/examples/queryEnvironmentalData.js

@@ -1,147 +0,0 @@
-import HoloSphere from '../holosphere.js';
-import * as h3 from 'h3-js';
-
-/**
- * Example demonstrating how to query environmental data from HoloSphere
- * This shows how to access data across federated holons at different scales
- */
-async function queryEnvironmentalData() {
-  // Initialize HoloSphere with the same appname used to store the data
-  const holosphere = new HoloSphere('environmental-data');
-  
-  try {
-    // Example coordinates (Rome, Italy)
-    const lat = 41.9;
-    const lon = 12.5;
-    
-    // Get the holons at different resolutions
-    const cityHolon = await holosphere.getHolon(lat, lon, 7);  // City level
-    const regionHolon = await holosphere.getHolon(lat, lon, 5); // Region level
-    const countryHolon = await holosphere.getHolon(lat, lon, 3); // Country level
-    
-    console.log(`Querying environmental data for location (${lat}, ${lon})`);
-    console.log(`  - City: ${cityHolon}`);
-    console.log(`  - Region: ${regionHolon}`);
-    console.log(`  - Country: ${countryHolon}`);
-    
-    // Query 1: Get air quality data from the city level
-    console.log('\n=== CITY LEVEL: Air Quality Data ===');
-    const airQualityData = await holosphere.getAll(cityHolon, 'air-quality');
-    if (airQualityData.length > 0) {
-      const latest = airQualityData.sort((a, b) => b.timestamp - a.timestamp)[0];
-      console.log(`Latest Air Quality Index: ${latest.airQualityIndex}`);
-      console.log('Pollutant levels:');
-      Object.entries(latest.pollutants).forEach(([pollutant, value]) => {
-        console.log(`  - ${pollutant}: ${value}`);
-      });
-    } else {
-      console.log('No air quality data available for this location');
-    }
-    
-    // Query 2: Use federation to get soil data referenced at the region level
-    console.log('\n=== REGION LEVEL: Soil Carbon Data ===');
-    const soilData = await holosphere.getAll(regionHolon, 'soil-data');
-    if (soilData.length > 0) {
-      const latest = soilData.sort((a, b) => b.timestamp - a.timestamp)[0];
-      console.log(`Soil Carbon: ${latest.soilCarbon} g/kg`);
-      console.log(`Soil Type: ${latest.soilType}`);
-      console.log(`Soil Depth: ${latest.soilDepth}`);
-    } else {
-      console.log('No soil data available for this region');
-    }
-    
-    // Query 3: Get carbon sequestration data at region level
-    console.log('\n=== REGION LEVEL: Carbon Sequestration ===');
-    const carbonData = await holosphere.getAll(regionHolon, 'carbon-sequestration');
-    if (carbonData.length > 0) {
-      const latest = carbonData.sort((a, b) => b.timestamp - a.timestamp)[0];
-      console.log(`Carbon Sequestration: ${latest.carbonSequestration} tons/hectare/year`);
-      console.log(`Temperature: ${latest.temperature}°C`);
-      console.log(`Precipitation: ${latest.precipitation} mm`);
-    } else {
-      console.log('No carbon sequestration data available for this region');
-    }
-    
-    // Query 4: Get biodiversity data at country level
-    console.log('\n=== COUNTRY LEVEL: Biodiversity ===');
-    const biodiversityData = await holosphere.getAll(countryHolon, 'biodiversity');
-    if (biodiversityData.length > 0) {
-      const latest = biodiversityData.sort((a, b) => b.timestamp - a.timestamp)[0];
-      console.log(`Biodiversity Count: ${latest.biodiversityCount} species`);
-      console.log(`Country Code: ${latest.countryCode}`);
-      console.log(`Top 5 Species:`);
-      
-      // Sort species by count and show top 5
-      const topSpecies = latest.species.sort((a, b) => b.count - a.count).slice(0, 5);
-      topSpecies.forEach((species, index) => {
-        console.log(`  ${index + 1}. ${species.scientificName}: ${species.count} occurrences`);
-      });
-    } else {
-      console.log('No biodiversity data available for this country');
-    }
-    
-    // Query 5: Get federated data across all levels
-    console.log('\n=== FEDERATED DATA: Environmental Metrics ===');
-    const federatedData = await holosphere.getFederated(countryHolon, 'environmental-metrics', {
-      resolveReferences: true,
-      aggregate: true,
-      idField: 'id'
-    });
-    
-    if (federatedData.length > 0) {
-      console.log('Aggregated Environmental Metrics:');
-      federatedData.forEach(data => {
-        if (data.metrics) {
-          Object.entries(data.metrics).forEach(([metric, value]) => {
-            console.log(`  - ${metric}: ${value}`);
-          });
-        } else {
-          console.log('No metrics available in federated data');
-        }
-      });
-    } else {
-      console.log('No federated environmental metrics available');
-    }
-    
-    // Query 6: Get references to air quality data from the region level
-    // This demonstrates accessing data via federation references
-    console.log('\n=== FEDERATION REFERENCES: Air Quality Data from Region ===');
-    const airQualityRefs = await holosphere.getAll(regionHolon, 'air-quality');
-    if (airQualityRefs.length > 0) {
-      console.log(`Found ${airQualityRefs.length} air quality references in region`);
-      
-      // Get the first reference and resolve it
-      const ref = airQualityRefs[0];
-      console.log('Reference details:');
-      
-      if (ref.soul) {
-        console.log(`  - Soul path: ${ref.soul}`);
-        
-        // Resolve reference manually to show the process
-        const resolvedData = await holosphere.getNodeBySoul(ref.soul);
-        if (resolvedData) {
-          console.log('Successfully resolved reference to original air quality data:');
-          console.log(`  - Air Quality Index: ${resolvedData.airQualityIndex}`);
-          console.log(`  - Source Holon: ${resolvedData.holon}`);
-        } else {
-          console.log('Could not resolve reference - original data not found');
-        }
-      } else {
-        console.log('Not a soul reference:', ref);
-      }
-    } else {
-      console.log('No air quality references found at region level');
-    }
-    
-  } catch (error) {
-    console.error('Error querying environmental data:', error);
-  } finally {
-    // Always close the HoloSphere instance
-    await holosphere.close();
-  }
-}
-
-// Execute the example
-queryEnvironmentalData()
-  .then(() => console.log('\nEnvironmental data query example completed'))
-  .catch(error => console.error('Error in environmental data query example:', error)); 

package/services/environmentalApi.js

@@ -1,415 +0,0 @@
-import axios from 'axios';
-import dotenv from 'dotenv';
-
-dotenv.config();
-
-const logError = (service, error) => {
-    const status = error.response?.status;
-    const message = error.response?.data?.message || error.message;
-    console.error(`${service} API Error:`, { status, message });
-};
-
-// Mock data responses (for testing without API keys)
-const mockData = {
-    airQuality: {
-        coord: { lat: 41.9, lon: 12.5 },
-        list: [
-            {
-                main: { aqi: 2 },
-                components: {
-                    co: 201.94,
-                    no2: 0.78,
-                    o3: 68.64,
-                    pm2_5: 0.5,
-                    pm10: 0.82,
-                    so2: 0.52
-                }
-            }
-        ]
-    },
-    carbonSequestration: {
-        properties: {
-            parameter: {
-                T2M: { '20230701': 28.5 },
-                PRECTOT: { '20230701': 1.2 },
-                PS: { '20230701': 1013.25 },
-                WS2M: { '20230701': 3.5 }
-            }
-        },
-        geometry: {
-            coordinates: [12.5, 41.9]
-        }
-    },
-    soilCarbon: {
-        properties: {
-            soilGrids: {
-                properties: {
-                    soc: { mean: 78.4 }
-                }
-            },
-            soilType: 'Clay Loam'
-        },
-        geometry: {
-            coordinates: [12.5, 41.9]
-        }
-    },
-    biodiversity: {
-        results: [
-            { scientificName: 'Quercus ilex', countryCode: 'ITA' },
-            { scientificName: 'Pinus pinea', countryCode: 'ITA' },
-            { scientificName: 'Olea europaea', countryCode: 'ITA' },
-            { scientificName: 'Quercus ilex', countryCode: 'ITA' },
-            { scientificName: 'Pinus pinea', countryCode: 'ITA' },
-            { scientificName: 'Laurus nobilis', countryCode: 'ITA' },
-            { scientificName: 'Quercus ilex', countryCode: 'ITA' },
-            { scientificName: 'Platanus orientalis', countryCode: 'ITA' },
-            { scientificName: 'Cupressus sempervirens', countryCode: 'ITA' },
-            { scientificName: 'Cupressus sempervirens', countryCode: 'ITA' }
-        ]
-    }
-};
-
-// Flag to use mock data instead of making real API calls
-const USE_MOCK_DATA = true;
-
-/**
- * Fetch Carbon Sequestration Data (Using NASA POWER API)
- */
-export async function getCarbonSequestration(lat = 41.9, lon = 12.5) {
-    // Return mock data if flag is set
-    if (USE_MOCK_DATA) {
-        console.log('Using mock carbon sequestration data');
-        return mockData.carbonSequestration;
-    }
-
-    try {
-        const response = await axios.default.get(
-            `https://power.larc.nasa.gov/api/temporal/daily/point?parameters=T2M,PRECTOT,PS,WS2M&community=RE&longitude=${lon}&latitude=${lat}&start=20230101&end=20231231&format=JSON`
-        );
-        return response.data;
-    } catch (error) {
-        logError('Carbon Sequestration', error);
-        return null;
-    }
-}
-
-/**
- * Fetch Soil Carbon Data (Using ISRIC World Soil Information)
- */
-export async function getSoilCarbon(lat = 41.9, lon = 12.5) {
-    // Return mock data if flag is set
-    if (USE_MOCK_DATA) {
-        console.log('Using mock soil carbon data');
-        return mockData.soilCarbon;
-    }
-
-    try {
-        const response = await axios.default.get(
-            `https://rest.isric.org/soilgrids/v2.0/properties/query?lat=${lat}&lon=${lon}&property=soc&depth=0-30cm&value=mean`
-        );
-        return response.data;
-    } catch (error) {
-        logError('Soil Carbon', error);
-        return null;
-    }
-}
-
-/**
- * Fetch Biodiversity Data (GBIF API)
- */
-export async function getBiodiversityData(countryCode = "ITA") {
-    // Return mock data if flag is set
-    if (USE_MOCK_DATA) {
-        console.log('Using mock biodiversity data');
-        return mockData.biodiversity;
-    }
-
-    try {
-        const response = await axios.default.get(`https://api.gbif.org/v1/occurrence/search?country=${countryCode}&limit=100`);
-        return response.data;
-    } catch (error) {
-        logError('Biodiversity', error);
-        return null;
-    }
-}
-
-/**
- * Fetch Vegetation Cover Data (Using NASA MODIS Vegetation Index)
- */
-export async function getVegetationCover(lat = 41.9, lon = 12.5) {
-    // Return mock data if flag is set
-    if (USE_MOCK_DATA) {
-        console.log('Using mock vegetation cover data');
-        return { ndvi: 0.75 };
-    }
-
-    try {
-        const response = await axios.default.get(
-            `https://modis.ornl.gov/rst/api/v1/MOD13Q1/subset?latitude=${lat}&longitude=${lon}&band=NDVI&startDate=2023-01-01&endDate=2023-12-31`,
-            {
-                headers: {
-                    'Accept': 'application/json'
-                }
-            }
-        );
-        return response.data;
-    } catch (error) {
-        logError('Vegetation Cover', error);
-        return null;
-    }
-}
-
-/**
- * Fetch Air Quality Data (OpenWeather API)
- */
-export async function getAirQuality(lat = 41.9, lon = 12.5) {
-    // Return mock data if flag is set
-    if (USE_MOCK_DATA) {
-        console.log('Using mock air quality data');
-        return mockData.airQuality;
-    }
-
-    try {
-        const response = await axios.default.get(
-            `https://api.openweathermap.org/data/2.5/air_pollution?lat=${lat}&lon=${lon}&appid=${process.env.OPENWEATHER_API_KEY}`
-        );
-        return response.data;
-    } catch (error) {
-        logError('Air Quality', error);
-        return null;
-    }
-}
-
-/**
- * Fetch Water Retention Data (Using USGS Water Services)
- */
-export async function getWaterRetention(lat = 41.9, lon = 12.5) {
-    // Return mock data if flag is set
-    if (USE_MOCK_DATA) {
-        console.log('Using mock water retention data');
-        return { waterRetention: 85.2 };
-    }
-
-    try {
-        const response = await axios.default.get(
-            `https://waterservices.usgs.gov/nwis/iv/?format=json&sites=11447650&siteStatus=active`,
-            {
-                headers: {
-                    'Accept': 'application/json'
-                }
-            }
-        );
-        return response.data;
-    } catch (error) {
-        logError('Water Retention', error);
-        return null;
-    }
-}
-
-/**
- * Fetch Deforestation Data (Using World Bank Forest Data)
- */
-export async function getDeforestationData(countryCode = "ITA") {
-    // Return mock data if flag is set
-    if (USE_MOCK_DATA) {
-        console.log('Using mock deforestation data');
-        return { forestAreaPercentage: 31.6, year: 2020 };
-    }
-
-    try {
-        const response = await axios.default.get(
-            `https://api.worldbank.org/v2/country/${countryCode}/indicator/AG.LND.FRST.ZS?format=json`
-        );
-        return response.data;
-    } catch (error) {
-        logError('Deforestation', error);
-        return null;
-    }
-}
-
-/**
- * Fetch Flood Risk Data (Using USGS Water Services)
- */
-export async function getFloodRisk(lat = 41.9, lon = 12.5) {
-    // Return mock data if flag is set
-    if (USE_MOCK_DATA) {
-        console.log('Using mock flood risk data');
-        return { floodRiskLevel: 'low', probability: 0.15 };
-    }
-
-    try {
-        const response = await axios.default.get(
-            `https://waterservices.usgs.gov/nwis/iv/?format=json&stateCd=CA&parameterCd=00065&siteStatus=active`,
-            {
-                headers: {
-                    'Accept': 'application/json'
-                }
-            }
-        );
-        return response.data;
-    } catch (error) {
-        logError('Flood Risk', error);
-        return null;
-    }
-}
-
-/**
- * Fetch Food Security Data (World Bank API)
- */
-export async function getFoodSecurity(countryCode = "ITA") {
-    // Return mock data if flag is set
-    if (USE_MOCK_DATA) {
-        console.log('Using mock food security data');
-        return { prevalenceOfUndernourishment: 2.5, year: 2020 };
-    }
-
-    try {
-        const response = await axios.default.get(
-            `https://api.worldbank.org/v2/country/${countryCode}/indicator/SN.ITK.DEFC.ZS?format=json`
-        );
-        return response.data;
-    } catch (error) {
-        logError('Food Security', error);
-        return null;
-    }
-}
-
-/**
- * Fetch Local Employment Rate (World Bank API)
- */
-export async function getEmploymentRate(countryCode = "ITA") {
-    // Return mock data if flag is set
-    if (USE_MOCK_DATA) {
-        console.log('Using mock employment rate data');
-        return { employmentRate: 58.2, year: 2020 };
-    }
-
-    try {
-        const response = await axios.default.get(
-            `https://api.worldbank.org/v2/country/${countryCode}/indicator/SL.EMP.TOTL.SP.ZS?format=json`
-        );
-        return response.data;
-    } catch (error) {
-        logError('Employment Rate', error);
-        return null;
-    }
-}
-
-/**
- * Fetch Governance Score (World Bank API)
- */
-export async function getTransparencyScore(countryCode = "ITA") {
-    // Return mock data if flag is set
-    if (USE_MOCK_DATA) {
-        console.log('Using mock transparency score data');
-        return { governanceEffectivenessScore: 0.45, year: 2020 };
-    }
-
-    try {
-        const response = await axios.default.get(
-            `https://api.worldbank.org/v2/country/${countryCode}/indicator/GE.EST?format=json`
-        );
-        return response.data;
-    } catch (error) {
-        logError('Transparency Score', error);
-        return null;
-    }
-}
-
-/**
- * Fetch Blockchain Transactions (Etherscan API)
- */
-export async function getBlockchainTransactions(address = "0x0000000000000000000000000000000000000000") {
-    // Return mock data if flag is set
-    if (USE_MOCK_DATA) {
-        console.log('Using mock blockchain transactions data');
-        return { 
-            result: [
-                { hash: '0x123...', value: '0.5', timeStamp: '1620000000' },
-                { hash: '0x456...', value: '1.2', timeStamp: '1620100000' }
-            ]
-        };
-    }
-
-    try {
-        const response = await axios.default.get(
-            `https://api.etherscan.io/api?module=account&action=txlist&address=${address}&startblock=0&endblock=99999999&sort=desc&apikey=${process.env.ETHERSCAN_API_KEY}`
-        );
-        return response.data;
-    } catch (error) {
-        logError('Blockchain Transactions', error);
-        return null;
-    }
-}
-
-/**
- * Fetch Circular Economy Data (Using World Bank Development Indicators)
- */
-export async function getCircularEconomyData(countryCode = "ITA") {
-    // Return mock data if flag is set
-    if (USE_MOCK_DATA) {
-        console.log('Using mock circular economy data');
-        return { recyclingRate: 51.3, wasteGeneration: 499.0, year: 2020 };
-    }
-
-    try {
-        const response = await axios.default.get(
-            `https://api.worldbank.org/v2/country/${countryCode}/indicator/EN.ATM.GHGT.KT.CE?format=json`
-        );
-        return response.data;
-    } catch (error) {
-        logError('Circular Economy', error);
-        return null;
-    }
-}
-
-/**
- * Fetch Renewable Energy Data (World Bank API)
- */
-export async function getRenewableEnergyData(countryCode = "ITA") {
-    // Return mock data if flag is set
-    if (USE_MOCK_DATA) {
-        console.log('Using mock renewable energy data');
-        return { renewableEnergyPercentage: 18.2, year: 2020 };
-    }
-
-    try {
-        const response = await axios.default.get(
-            `https://api.worldbank.org/v2/country/${countryCode}/indicator/EG.FEC.RNEW.ZS?format=json`
-        );
-        return response.data;
-    } catch (error) {
-        logError('Renewable Energy', error);
-        return null;
-    }
-}
-
-/**
- * Fetch Climate Change Data (NOAA Climate API)
- */
-export async function getClimateChangeData(lat = 41.9, lon = 12.5) {
-    // Return mock data if flag is set
-    if (USE_MOCK_DATA) {
-        console.log('Using mock climate change data');
-        return { 
-            temperatureTrend: '+1.2C over 50 years',
-            extremeWeatherEvents: 5,
-            year: 2020
-        };
-    }
-
-    try {
-        const response = await axios.default.get(
-            `https://www.ncdc.noaa.gov/cdo-web/api/v2/data?datasetid=GHCND&latitude=${lat}&longitude=${lon}&startdate=2023-01-01&enddate=2023-12-31&limit=1000`,
-            {
-                headers: {
-                    'token': process.env.NOAA_API_KEY
-                }
-            }
-        );
-        return response.data;
-    } catch (error) {
-        logError('Climate Change', error);
-        return null;
-    }
-}