getweather-app 1.0.0

package/Example/run.js

@@ -0,0 +1,23 @@
+import getWeatherInfo from '../Index.js';
+
+async function testLocation(location) {
+    console.log(`\n--- Testing Location: ${location} ---`);
+
+    try {
+        const data = await getWeatherInfo(location);
+
+        console.log(`Success: Found weather for ${location}.`);
+        console.log('Result:', JSON.stringify(data, null, 2));
+    } catch (error) {
+        console.error(`Failure for ${location}: ${error.message}`);
+    }
+}
+
+async function runSimpleTests() {
+
+    await testLocation('Marrakech');
+    await testLocation('France');
+    await testLocation('ZZZ_Invalid_City_Name');
+}
+
+runSimpleTests();

package/Index.js

@@ -0,0 +1,39 @@
+import {
+    fetchWeatherByCity
+} from './lib/Weather-check.js';
+import {
+    parseWeatherData
+} from './lib/data-parser.js';
+import 'dotenv/config';
+
+const API_KEY = process.env.OPENWEATHER_API_KEY;
+
+async function getWeatherInfo(input) {
+    if (!input || typeof input !== 'string' || input.trim() === '') {
+        throw new Error("Input must be a non-empty string (City or Country name).");
+    }
+    if (!API_KEY) {
+        throw new Error("API Key is missing. Check your .env file.");
+    }
+    const location = input.trim();
+
+    // Try City 
+    try {
+        const rawData = await fetchWeatherByCity(location, API_KEY);
+
+        console.log("after fetch")
+
+        const cleanData = parseWeatherData(rawData);
+
+        console.log(`Successfully retrieved weather for city: ${cleanData.location.city}`);
+        return cleanData;
+
+    } catch (error) {
+        if (error.message.toLowerCase().includes('network error')) {
+            throw error;
+        }
+        throw new Error(`Location not found: Could not find city or country "${location}".`);
+    }
+}
+
+export default getWeatherInfo;

package/README.md

@@ -0,0 +1,113 @@
+# getweather-app
+
+A simple and lightweight Node.js library for fetching weather information by **city** or **country**.  
+Environment variables (including your `API_KEY`) are loaded via **dotenv**, keeping your credentials secure.
+
+---
+
+## Features
+
+- :white_sun_rain_cloud: Fetch weather data by **city** or **country**
+- :closed_lock_with_key: Uses `dotenv` for environment variable management
+- :zap: Minimal, easy-to-use API
+- :package: Zero configuration required
+
+---
+
+## Installation
+
+Run the following command in your project:
+
+```bash
+npm install getweather-app
+```
+
+Create a `.env` file in your project root and add:
+
+```bash
+OPENWEATHER_API_KEY=your_api_key_here
+```
+
+---
+
+## Usage
+
+Import the library and call it with either a city or country:
+
+```javascript
+import getWeatherInfo from "getweather-app";
+
+async function run() {
+  const result = await getWeatherInfo("Berlin");
+  console.log(result);
+}
+
+run();
+```
+
+You may also pass a country name:
+
+```javascript
+await getWeatherInfo("Germany");
+await getWeatherInfo("London");
+```
+
+---
+
+## API
+
+### `getWeatherInfo(input: string): Promise<any>`
+
+Fetches weather data for the given input.
+
+#### Parameters
+
+| Name  | Type   | Description          |
+| ----- | ------ | -------------------- |
+| input | string | City or country name |
+
+#### Returns
+
+A `Promise` resolving with the weather data returned by the upstream API.
+
+---
+
+## Environment Variables
+
+Ensure your project loads dotenv before using the library:
+
+```javascript
+import "dotenv/config";
+```
+
+or
+
+```javascript
+require("dotenv").config();
+```
+
+---
+
+## Example Output
+
+```json
+{
+  "type": "city",
+  "location": {
+    "city": "Marrakesh",
+    "countryCode": "MA"
+  },
+  "weather": {
+    "description": "clear sky",
+    "iconCode": "01n"
+  },
+  "temperature": {
+    "current": 16.04,
+    "feelsLike": 14.64,
+    "min": 16.04,
+    "max": 16.04,
+    "unit": "C"
+  },
+  "humidity": 36
+}
+```

package/lib/Weather-check.js

@@ -0,0 +1,32 @@
+import axios from 'axios';
+
+
+
+const BASE_URL = 'https://api.openweathermap.org/data/2.5/';
+
+function handleApiError(error) {
+  if (error.response) {
+    const message = error.response.data.message || 'Unknown API issue';
+    throw new Error(`API Error: ${message}`);
+  }
+  throw new Error(`Network Error: Failed to connect to the weather service.`);
+}
+
+export async function fetchWeatherByCity(locationName, apiKey) {
+
+  try {
+    const url = `${BASE_URL}weather`;
+
+    const response = await axios.get(url, {
+      params: {
+        q: locationName,
+        appid: apiKey,
+        units: 'metric'
+      }
+    });
+
+    return response.data;
+  } catch (error) {
+    handleApiError(error);
+  }
+}

package/lib/data-parser.js

@@ -0,0 +1,37 @@
+export function parseWeatherData(rawData) {
+    if (!rawData || !rawData.main || !rawData.weather) {
+        throw new Error("Invalid or incomplete data received for city weather.");
+    }
+
+    const {
+        temp,
+        feels_like,
+        temp_min,
+        temp_max,
+        humidity
+    } = rawData.main;
+    const weatherDescription = rawData.weather[0].description;
+    const weatherIcon = rawData.weather[0].icon;
+
+    const cleanData = {
+        type: 'city',
+        location: {
+            city: rawData.name,
+            countryCode: rawData.sys.country,
+        },
+        weather: {
+            description: weatherDescription,
+            iconCode: weatherIcon,
+        },
+        temperature: {
+            current: temp,
+            feelsLike: feels_like,
+            min: temp_min,
+            max: temp_max,
+            unit: 'C'
+        },
+        humidity: humidity,
+    };
+
+    return cleanData;
+}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "getweather-app",
+  "version": "1.0.0",
+  "description": "",
+  "main": "Index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "project": "node Example/run.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Ichigoo/getWeather-app.git"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "type": "module",
+  "bugs": {
+    "url": "https://github.com/Ichigoo/getWeather-app/issues"
+  },
+  "homepage": "https://github.com/Ichigoo/getWeather-app#readme",
+  "dependencies": {
+    "axios": "^1.13.2",
+    "dotenv": "^17.2.3",
+    "express": "^5.1.0"
+  }
+}