@selinac887/weather-sdk 1.0.0

package/.github/workflows/publish.yml

@@ -0,0 +1,31 @@
+name: Publish to npm
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          registry-url: https://registry.npmjs.org/
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build package
+        run: npm run build
+
+      - name: Publish to npm
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/README.md

@@ -0,0 +1,49 @@
+# Weather SDK
+
+A lightweight TypeScript SDK for the [Open-Meteo](https://open-meteo.com/) API,
+providing access to current weather and forecast data.
+
+## Features
+
+- Current weather
+- Hourly and daily forecast
+
+## Installation
+
+```bash
+npm install @yourname/weather-sdk
+```
+
+## Usage
+
+### Get current weather
+
+```ts
+import { getCurrentWeather } from "@yourname/weather-sdk";
+
+const data = await getCurrentWeather({
+  latitude: -36.85,
+  longitude: 174.76,
+  current: [
+    "temperature_2m",
+    "wind_speed_10m",
+    "weather_code"
+  ]
+});
+
+console.log(data.current.temperature_2m);
+```
+
+### Get forecast weather
+
+```ts
+import { getForecast } from "@yourname/weather-sdk";
+
+const forecast = await getForecast({
+  latitude: -36.85,
+  longitude: 174.76,
+  hourly: ["temperature_2m", "relative_humidity_2m"],
+  daily: ["temperature_2m_max", "precipitation_sum"],
+  forecastDays: 3
+});
+```

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+export interface BaseLocationInput {
+    latitude: number;
+    longitude: number;
+    timezone?: string;
+}
+export interface CurrentWeather {
+    time: string;
+    interval: number;
+    [key: string]: number | string;
+}
+export interface GetCurrentWeatherInput extends BaseLocationInput {
+    current: string[];
+}
+export interface GetCurrentWeatherResponse {
+    current: CurrentWeather;
+}
+export declare function getCurrentWeather(input: GetCurrentWeatherInput): Promise<GetCurrentWeatherResponse>;
+export interface HourlyForecast {
+    time: string[];
+    [key: string]: any[];
+}
+export interface DailyForecast {
+    time: string[];
+    [key: string]: any[];
+}
+export interface GetForecastInput extends BaseLocationInput {
+    hourly?: string[];
+    daily?: string[];
+    forecastHours?: number;
+    forecastDays?: number;
+}
+export interface GetForecastResponse {
+    hourly?: HourlyForecast;
+    daily?: DailyForecast;
+}
+export declare function getForecast(input: GetForecastInput): Promise<GetForecastResponse>;

package/dist/index.js

@@ -0,0 +1,40 @@
+/*
+ * Shared Types
+ */
+export async function getCurrentWeather(input) {
+    const { latitude, longitude, timezone = "auto", current, } = input;
+    const url = new URL("https://api.open-meteo.com/v1/forecast");
+    url.searchParams.set("latitude", latitude.toString());
+    url.searchParams.set("longitude", longitude.toString());
+    url.searchParams.set("timezone", timezone);
+    url.searchParams.set("current", current.join(","));
+    const res = await fetch(url.toString());
+    if (!res.ok) {
+        throw new Error(`Open-Meteo API error: ${res.status}`);
+    }
+    return res.json();
+}
+export async function getForecast(input) {
+    const { latitude, longitude, timezone = "auto", hourly, daily, forecastHours, forecastDays, } = input;
+    const url = new URL("https://api.open-meteo.com/v1/forecast");
+    url.searchParams.set("latitude", latitude.toString());
+    url.searchParams.set("longitude", longitude.toString());
+    url.searchParams.set("timezone", timezone);
+    if (hourly?.length) {
+        url.searchParams.set("hourly", hourly.join(","));
+        if (forecastHours) {
+            url.searchParams.set("forecast_hours", forecastHours.toString());
+        }
+    }
+    if (daily?.length) {
+        url.searchParams.set("daily", daily.join(","));
+        if (forecastDays) {
+            url.searchParams.set("forecast_days", forecastDays.toString());
+        }
+    }
+    const res = await fetch(url.toString());
+    if (!res.ok) {
+        throw new Error(`Open-Meteo API error: ${res.status}`);
+    }
+    return res.json();
+}

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@selinac887/weather-sdk",
+  "version": "1.0.0",
+  "description": "",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "type": "commonjs",
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "typescript": "^5.9.3"
+  }
+}

package/src/index.ts

@@ -0,0 +1,117 @@
+/*
+ * Shared Types 
+ */
+
+export interface BaseLocationInput {
+  latitude: number;
+  longitude: number;
+  timezone?: string;
+}
+
+/* 
+ * Current Weather
+ */
+
+export interface CurrentWeather {
+  time: string;
+  interval: number;
+  [key: string]: number | string;
+}
+
+export interface GetCurrentWeatherInput extends BaseLocationInput {
+  current: string[];
+}
+
+export interface GetCurrentWeatherResponse {
+  current: CurrentWeather;
+}
+
+export async function getCurrentWeather(
+  input: GetCurrentWeatherInput
+): Promise<GetCurrentWeatherResponse> {
+  const {
+    latitude,
+    longitude,
+    timezone = "auto",
+    current,
+  } = input;
+
+  const url = new URL("https://api.open-meteo.com/v1/forecast");
+  url.searchParams.set("latitude", latitude.toString());
+  url.searchParams.set("longitude", longitude.toString());
+  url.searchParams.set("timezone", timezone);
+  url.searchParams.set("current", current.join(","));
+
+  const res = await fetch(url.toString());
+  if (!res.ok) {
+    throw new Error(`Open-Meteo API error: ${res.status}`);
+  }
+
+  return res.json();
+}
+
+/* 
+ * Forecast (Hourly / Daily)
+ */
+
+export interface HourlyForecast {
+  time: string[];
+  [key: string]: any[];
+}
+
+export interface DailyForecast {
+  time: string[];
+  [key: string]: any[];
+}
+
+export interface GetForecastInput extends BaseLocationInput {
+  hourly?: string[];
+  daily?: string[];
+  forecastHours?: number;
+  forecastDays?: number;
+}
+
+export interface GetForecastResponse {
+  hourly?: HourlyForecast;
+  daily?: DailyForecast;
+}
+
+export async function getForecast(
+  input: GetForecastInput
+): Promise<GetForecastResponse> {
+  const {
+    latitude,
+    longitude,
+    timezone = "auto",
+    hourly,
+    daily,
+    forecastHours,
+    forecastDays,
+  } = input;
+
+  const url = new URL("https://api.open-meteo.com/v1/forecast");
+  url.searchParams.set("latitude", latitude.toString());
+  url.searchParams.set("longitude", longitude.toString());
+  url.searchParams.set("timezone", timezone);
+
+  if (hourly?.length) {
+    url.searchParams.set("hourly", hourly.join(","));
+    if (forecastHours) {
+      url.searchParams.set("forecast_hours", forecastHours.toString());
+    }
+  }
+
+  if (daily?.length) {
+    url.searchParams.set("daily", daily.join(","));
+    if (forecastDays) {
+      url.searchParams.set("forecast_days", forecastDays.toString());
+    }
+  }
+
+  const res = await fetch(url.toString());
+  if (!res.ok) {
+    throw new Error(`Open-Meteo API error: ${res.status}`);
+  }
+
+  return res.json();
+}

package/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "declaration": true,
+    "outDir": "dist",
+    "esModuleInterop": true,
+    "moduleResolution": "node",
+    "strict": true,
+    "verbatimModuleSyntax": true
+  },
+  "include": ["src"]
+}