@uniai-fe/ui-legacy 0.1.1

package/src/types/weather/korea.d.ts

@@ -0,0 +1,163 @@
+export type KMA_GridCoordinate = {
+  x: number;
+  y: number;
+};
+
+export type KMA_Req_Base = {
+  pageNo: string;
+  numOfRows: string;
+  authKey: string; // API_KEY
+  dataType: string; // JSON, XML
+};
+
+export type KMA_Req_BaseMoments = {
+  base_date: string; // YYYYMMDD
+  base_time: string; // HH00
+};
+
+export type KMA_Req_BaseGridCoordinate = {
+  nx: number;
+  ny: number;
+};
+
+export type KMA_Req_Weather = KMA_Req_Base &
+  KMA_Req_BaseMoments &
+  KMA_Req_BaseGridCoordinate;
+
+/**
+ * 기상청 API 응답; 예보변수
+ * @desc
+ * - SKY(하늘상태) 코드 - 1(맑음), 2(구름조금), 3(구름많음), 4(흐림)
+ * - PTY(강수형태) 코드 - 0(없음), 1(비), 2(비/눈), 3(눈), 4(소나기)
+ * - POP(강수확률) %
+ * - PCP(1시간 강수량) 1mm
+ * - SNO(1시간 신적설) 1cm
+ * - TMP(기온) ℃
+ * - TMX(최고기온) ℃
+ * - TMN(최저기온) ℃
+ * - REH(습도) %
+ * - UUU(풍속; 동서바람성분) m/s
+ * - VVV(풍속; 남북바람성분) m/s
+ * - VEC(풍향) deg
+ * - WSD(풍속) m/s
+ * - WAV(파고) m
+ */
+export type KMA_Res_WeatherVariablesCategory =
+  | "TMP"
+  | "TMX"
+  | "TMN"
+  | "UUU"
+  | "VVV"
+  | "VEC"
+  | "WSD"
+  | "SKY"
+  | "PTY"
+  | "POP"
+  | "PCP"
+  | "SNO"
+  | "REH"
+  | "WAV";
+
+/**
+ * 기상청 API 응답; 예보 데이터 base
+ */
+export type KMA_Res_WeatherItemBase = {
+  baseDate: string;
+  baseTime: string;
+  category: KMA_Res_WeatherVariablesCategory;
+} & KMA_Req_BaseGridCoordinate;
+
+/**
+ * 기상청 API 응답; 예보 데이터
+ */
+export type KMA_Res_WeatherItem = KMA_Res_WeatherItemBase & {
+  fcstDate: string;
+  fcstTime: string;
+  fcstValue: string;
+};
+
+// /**
+//  * 기상청 API 응답; 현재 날씨 데이터
+//  */
+// export type KMA_Res_WeatherItemNow = KMA_Res_WeatherItemBase & {
+//   obsrValue: string;
+// };
+
+/**
+ * 기상청 API 응답; Header 데이터
+ */
+export type KMA_Res_Header = {
+  resultCode: string;
+  resultMsg: string;
+};
+
+/**
+ * 기상청 API 응답; Body 데이터
+ */
+export type KMA_Res_Body<Item> = {
+  dataType: string;
+  items: { item: Item[] };
+  pageNo: number;
+  numOfRows: number;
+  totalCount: number;
+};
+
+/**
+ * 기상청 API 응답; 공통 구조
+ */
+export type KMA_Res_Base<Item> = {
+  response: {
+    header: KMA_Res_Header;
+    body: KMA_Res_Body<Item>;
+  };
+};
+
+/**
+ * 기상청 API 응답; 현재 날씨
+ */
+export type KMA_Res_WeatherNow = KMA_Res_Base<KMA_Res_WeatherItem>;
+
+/**
+ * 기상청 API 응답; 예보
+ */
+export type KMA_Res_WeatherForecast = KMA_Res_Base<KMA_Res_WeatherItem>;
+
+// export type KMA_Res_MetaRegionCodeItem = {
+//   warningAreaCode: string;
+//   korName: string;
+// };
+// export type KMA_Res_MetaRegionCodes = KMA_Res_Base<KMA_Res_MetaRegionCodeItem>;
+
+/**
+ * 기상청 API 응답; 특보 종류
+ * @see https://apihub.kma.go.kr/static/html/attach/wrn_table.html
+ */
+export type KMA_Res_AlertType =
+  | "강풍"
+  | "호우"
+  | "한파"
+  | "건조"
+  | "해일"
+  | "지진해일"
+  | "풍량"
+  | "태풍"
+  | "대설"
+  | "황사"
+  | "폭염";
+/**
+ * 기상청 API 응답; 특보 수준
+ * @see https://apihub.kma.go.kr/static/html/attach/wrn_table.html
+ */
+export type KMA_Res_AlertLevel = "예비특보" | "주의보" | "경보";
+/**
+ * 기상청 API 응답; 특보 명령
+ * @see https://apihub.kma.go.kr/static/html/attach/wrn_table.html
+ */
+export type KMA_Res_AlertCommand =
+  | "발표"
+  | "대치"
+  | "해제"
+  | "대치해제"
+  | "연장"
+  | "변경"
+  | "변경해제";

package/src/types/weather/open-weather-map.d.ts

@@ -0,0 +1,181 @@
+export type OWM_Res_Coord = {
+  lat: number;
+  lon: number;
+};
+
+/**
+ * @see https://openweathermap.org/weather-conditions
+ */
+export type OWM_Res_Condition = {
+  /**
+   * 날씨 코드
+   * @see https://openweathermap.org/weather-conditions
+   * @desc
+   * - 800: 맑음
+   * - 801: 구름조금
+   * - 802: 구름많음
+   * - 803: 흐림
+   * - 804: 흐림
+   * - 7XX: 안개, 연무, 황사 등
+   * - 6XX: 눈
+   * - 5XX: 비
+   * - 3XX: 이슬비, 빗방울 등
+   * - 2XX: 천둥번개
+   */
+  id: number;
+  /**
+   * 개황 (영문)
+   */
+  main: string;
+  /**
+   * 개황 (한글)
+   */
+  description: string;
+  /**
+   * 아이콘 코드
+   * @see https://openweathermap.org/weather-conditions
+   * @desc
+   * - 01d: 맑음 (clear sky)
+   * - 02d: 구름조금 (few clouds)
+   * - 03d: 구름많음 (scattered clouds)
+   * - 04d: 흐림 (broken clouds)
+   * - 09d: 소나기 (shower rain)
+   * - 10d: 비 (rain)
+   * - 11d: 천둥번개 (thunderstorm)
+   * - 13d: 눈 (snow)
+   * - 50d: 안개 (mist)
+   */
+  icon: string;
+};
+
+/**
+ * 측정값
+ * - 온도: 섭씨온도 (°C)
+ * - 습도: 백분율 (%)
+ * - 기압: hPa
+ */
+export type OWM_Res_Weather_Degrees = {
+  /**
+   * 현재 온도 (°C)
+   */
+  temp: number;
+  /**
+   * 체감 온도 (°C)
+   */
+  feels_like: number;
+  /**
+   * 최저 온도 (°C)
+   */
+  temp_min: number;
+  /**
+   * 최고 온도 (°C)
+   */
+  temp_max: number;
+  /**
+   * 해면기압 (hPa)
+   */
+  pressure: number;
+  /**
+   * 습도 (%)
+   */
+  humidity: number;
+  /**
+   * 해면기압 (hPa)
+   */
+  sea_level: number;
+  /**
+   * 현지기압 (hPa)
+   */
+  grnd_level: number;
+};
+
+export type OWM_Res_Wind = {
+  /**
+   * 풍속 (m/s)
+   */
+  speed: number;
+  /**
+   * 풍향 (deg)
+   * - 0: 북쪽
+   * - 90: 동쪽
+   * - 180: 남쪽
+   * - 270: 서쪽
+   */
+  deg: number;
+  /**
+   * 돌풍 (m/s)
+   */
+  gust: number;
+};
+
+export type OWM_Res_Clouds = {
+  /**
+   * 구름량 (0-100, %)
+   */
+  all: number;
+};
+
+export type OWM_Res_Sun = {
+  country: string; // 국가 코드 "KR";
+  sunrise: number; // 일출 timestamp 1748290711;
+  sunset: number; // 일몰 timestamp 1748342383;
+};
+
+/**
+ * OpenWeatherMap API 응답; 현재 날씨
+ * @see https://openweathermap.org/current
+ */
+export type OWM_Res_Weather_Now = {
+  /**
+   * 위/경도 좌표
+   */
+  coord: OWM_Res_Coord;
+  /**
+   * 개황 정보
+   */
+  weather: OWM_Res_Condition[];
+  base: string; //  Internal parameter?? "stations";
+  /**
+   * 측정 정보
+   */
+  main: OWM_Res_Weather_Degrees;
+  /**
+   * 시정거리 (m)
+   */
+  visibility: number;
+  /**
+   * 바람 정보
+   */
+  wind: OWM_Res_Wind;
+  /**
+   * 구름량 정보
+   */
+  clouds: OWM_Res_Clouds;
+  /**
+   * 데이터 연산 시간 timestamp (UTC, sec)
+   */
+  dt: number;
+  /**
+   * 일출/일몰 정보
+   */
+  sys: OWM_Res_Sun;
+  /**
+   * UTC로부터 현지 시간 보정 (sec)
+   * - 한국 : 9시간 (3600 * 9 = 32400)
+   */
+  timezone: number;
+  /**
+   * 도시 ID
+   * @deprecated
+   */
+  id: number;
+  /**
+   * 도시 이름
+   * @deprecated
+   */
+  name: number;
+  /**
+   * API 응답 정보
+   */
+  cod: number; // Internal parameter
+};

package/src/weather/apis/index.ts

@@ -0,0 +1,4 @@
+export * from "./korea/client";
+export * from "./korea/server";
+export * from "./open-weather-map/client";
+export * from "./open-weather-map/server";

package/src/weather/apis/korea/client.ts

@@ -0,0 +1,93 @@
+"use client";
+
+import { useQuery, type UseQueryResult } from "@tanstack/react-query";
+import { getQueryString } from "@uniai-fe/util-functions";
+import type {
+  API_Req_WeatherKorea,
+  API_Req_WeatherKoreaAlert,
+  API_Res_WeatherKoreaAlert,
+  API_Res_WeatherKoreaForecast,
+  API_Res_WeatherKoreaNow,
+} from "../../../types";
+import { isValidGridCoordinate } from "../../utils/validate";
+
+/**
+ * 기상청 API; 현재날씨 fetch
+ * @method GET
+ * @param {API_Req_WeatherKorea} params - API 요청 파라미터
+ * @param {number} params.nx - X 좌표
+ * @param {number} params.ny - Y 좌표
+ * @param {string} [params.base_date] - 기준 날짜
+ * @param {string} [params.base_time] - 기준 시간
+ */
+export const getWeatherKoreaNow = async (params: API_Req_WeatherKorea) =>
+  await (await fetch(`/api/weather/korea/now${getQueryString(params)}`)).json();
+
+/**
+ * 기상청 API; 내일/모레 예보 fetch
+ * @method GET
+ * @param {API_Req_WeatherKorea} params - API 요청 파라미터
+ * @param {number} params.nx - X 좌표
+ * @param {string} params.ny - Y 좌표
+ * @param {string} [params.base_date] - 기준 날짜
+ * @param {string} [params.base_time] - 기준 시간
+ */
+export const getWeatherKoreaForecast = async (params: API_Req_WeatherKorea) =>
+  await (
+    await fetch(`/api/weather/korea/forecast${getQueryString(params)}`)
+  ).json();
+
+/**
+ * 기상청 API; 특보 fetch
+ * @method GET
+ * @param {API_Req_WeatherKoreaAlert} params - API 요청 파라미터
+ * @param {number} params.farm_idx - 농장 ID
+ */
+export const getWeatherKoreaAlert = async (params: API_Req_WeatherKoreaAlert) =>
+  await (
+    await fetch(`/api/weather/korea/alert${getQueryString(params)}`)
+  ).json();
+
+/**
+ * 기상청 API; 현재 날씨 react query
+ * @method GET
+ */
+export const useQueryWeatherKoreaNow = (
+  params: API_Req_WeatherKorea,
+): UseQueryResult<API_Res_WeatherKoreaNow> =>
+  useQuery({
+    queryKey: ["weather_korea_now", ...Object.values(params)],
+    queryFn: () => getWeatherKoreaNow(params),
+    enabled: isValidGridCoordinate({ nx: params.nx, ny: params.ny }),
+    staleTime: 10 * 60 * 1000, // 10분
+    refetchInterval: 5 * 60 * 1000, // 5분
+    refetchOnWindowFocus: true,
+  });
+
+/**
+ * 기상청 API; 내일/모레 예보 react query
+ * @method GET
+ */
+export const useQueryWeatherKoreaForecast = (
+  params: API_Req_WeatherKorea,
+): UseQueryResult<API_Res_WeatherKoreaForecast> =>
+  useQuery({
+    queryKey: ["weather_korea_forecast", ...Object.values(params)],
+    queryFn: () => getWeatherKoreaForecast(params),
+    enabled: isValidGridCoordinate({ nx: params.nx, ny: params.ny }),
+    staleTime: 30 * 60 * 1000, // 30분
+  });
+
+/**
+ * 기상청 API; 특보 react query
+ * @method GET
+ */
+export const useQueryWeatherKoreaAlert = (
+  params: API_Req_WeatherKoreaAlert,
+): UseQueryResult<API_Res_WeatherKoreaAlert> =>
+  useQuery({
+    queryKey: ["weather_korea_alert", ...Object.values(params)],
+    queryFn: () => getWeatherKoreaAlert(params),
+    enabled: typeof params.farm_idx === "number" && params.farm_idx > 0,
+    staleTime: 60 * 60 * 1000, // 1시간
+  });

package/src/weather/apis/korea/server.ts

@@ -0,0 +1,250 @@
+"use server";
+
+import { setDebugResponseHeaders } from "@uniai-fe/util-next";
+import type {
+  API_Res_WeatherKoreaAlert,
+  API_Res_WeatherKoreaForecast,
+  API_Res_WeatherKoreaNextDays,
+  API_Res_WeatherKoreaNow,
+  API_Res_WeatherKoreaToday,
+  KMA_Req_Weather,
+  KMA_Res_WeatherForecast,
+  KMA_Res_WeatherNow,
+} from "../../../types";
+import WEATHER_KOREA_RESPONSE from "../../data/response";
+import { getWeatherBaseMoments } from "../../utils/date-time";
+import { extractWeatherSummary } from "../../utils";
+import type { NextResponse } from "next/server";
+import {
+  generateBackendQueryUrl_GET,
+  nextAPILog,
+} from "@uniai-fe/util-functions";
+
+// const { generateBackendQueryUrl_GET } = weatherApi;
+// const weatherLog = weatherApi.logger;
+
+/**
+ * 기상청 API; base URL
+ * "본 저작물은 기상청에서 'OO년'작성하여 공공누리 제1유형으로 개방한 '저작물명(작성자:OOO)'을 이용하였으며, 해당 저작물은 '기상청 API허브(apihub.kma.go.kr)에서 무료로 다운받으실 수 있습니다."
+ */
+const API_BASE_PATH = "/typ02/openApi/VilageFcstInfoService_2.0";
+/**
+ * 기상청 API; 날씨정보 URL
+ */
+const API_WEATHER = API_BASE_PATH;
+
+const QUERY_URL = {
+  forecast: `${API_WEATHER}/getVilageFcst`,
+  now: `${API_WEATHER}/getUltraSrtFcst`,
+  alert: `/avic/weather-alert`,
+};
+
+const { API_RES_RAW, API_RES_BASE } = WEATHER_KOREA_RESPONSE;
+
+const getWeatherParams = ({
+  authKey,
+  category,
+  searchParams,
+}: {
+  authKey: string;
+  category: "now" | "forecast";
+  searchParams: URLSearchParams;
+}): KMA_Req_Weather => {
+  const { base_date, base_time } = getWeatherBaseMoments(category);
+
+  return {
+    pageNo: "1",
+    numOfRows: "1000",
+    authKey,
+    base_date,
+    base_time,
+    dataType: "JSON",
+    nx: 0,
+    ny: 0,
+    ...Object.fromEntries(searchParams.entries()),
+  };
+};
+
+/**
+ * 기상청 API; 현재 날씨
+ * @method GET
+ */
+export const routeWeatherKoreaNow = async ({
+  domain,
+  authKey,
+  routeUrl,
+  searchParams,
+}: {
+  domain: string;
+  authKey: string;
+  routeUrl: string;
+  searchParams: URLSearchParams;
+}): Promise<API_Res_WeatherKoreaNow> => {
+  const NOW_DATA: API_Res_WeatherKoreaToday = {
+    ...API_RES_BASE,
+    temperature: null,
+    humidity: null,
+  };
+  const resDefault: API_Res_WeatherKoreaNow = {
+    raw: API_RES_RAW as KMA_Res_WeatherNow,
+    today: NOW_DATA,
+  };
+
+  if (!authKey) {
+    nextAPILog("GET", routeUrl, "기상청 현재날씨 API", {
+      error: "API Key를 확인하세요.",
+    });
+    return resDefault;
+  }
+
+  const queryParams = Object.fromEntries(
+    Object.entries(
+      getWeatherParams({ authKey, category: "now", searchParams }),
+    ).map(([key, value]) => [key, String(value)]),
+  );
+
+  // 요청 URL 구성
+  const url = generateBackendQueryUrl_GET({
+    domain,
+    routeUrl,
+    queryUrl: QUERY_URL.now,
+    searchParams: new URLSearchParams(queryParams),
+  });
+
+  // nextAPILog("GET", routeUrl, url, { searchParams, queryParams });
+
+  try {
+    const res: KMA_Res_WeatherNow = await (await fetch(url)).json();
+    resDefault.raw = res;
+    return extractWeatherSummary.now(resDefault, res);
+  } catch (error) {
+    nextAPILog("GET", routeUrl, url, { error });
+
+    return resDefault;
+  }
+};
+
+/**
+ * 기상청 API; 내일, 모래 예보
+ * @method GET
+ */
+export const routeWeatherKoreaForecast = async ({
+  domain,
+  authKey,
+  routeUrl,
+  searchParams,
+}: {
+  domain: string;
+  authKey: string;
+  routeUrl: string;
+  searchParams: URLSearchParams;
+}): Promise<API_Res_WeatherKoreaForecast> => {
+  const FORECAST_DATA: API_Res_WeatherKoreaNextDays = {
+    ...API_RES_BASE,
+    max_temperature: null,
+    min_temperature: null,
+  };
+  const resDefault: API_Res_WeatherKoreaForecast = {
+    raw: API_RES_RAW as KMA_Res_WeatherForecast,
+    today: { ...API_RES_BASE, temperature: null, humidity: null },
+    day_1: FORECAST_DATA,
+    day_2: FORECAST_DATA,
+  };
+
+  if (!authKey) {
+    nextAPILog("GET", routeUrl, "기상청 예보날씨 API", {
+      error: "API Key를 확인하세요.",
+    });
+    return resDefault;
+  }
+
+  const queryParams = Object.fromEntries(
+    Object.entries(
+      getWeatherParams({ authKey, category: "forecast", searchParams }),
+    ).map(([key, value]) => [key, String(value)]),
+  );
+
+  // 요청 URL 구성
+  const url = generateBackendQueryUrl_GET({
+    domain,
+    routeUrl,
+    queryUrl: QUERY_URL.forecast,
+    searchParams: new URLSearchParams(queryParams),
+  });
+
+  // nextAPILog("GET", routeUrl, url, { searchParams, queryParams });
+
+  try {
+    const res: KMA_Res_WeatherForecast = await (await fetch(url)).json();
+    resDefault.raw = res;
+    return extractWeatherSummary.forecast(resDefault, res);
+  } catch (error) {
+    nextAPILog("GET", routeUrl, url, { error });
+
+    return resDefault;
+  }
+};
+
+/**
+ * 기상청 API; 특보 - 구역코드 조회
+ */
+// export const getWeatherKoreaAlertRegionCodes = async ({
+//   routeUrl,
+//   searchParams,
+// }: {
+//   routeUrl: string;
+//   searchParams: URLSearchParams;
+// }) => {
+//   const params = new URLSearchParams({
+//     authKey,
+//     dataType: "JSON",
+//     pageNo: "1",
+//     numOfRows: "1000",
+//     korName: "",
+//   });
+//   const url = `${QUERY_URL.alert}?${params.toString()}`;
+//   nextAPILog("GET", routeUrl, url, { params, searchParams });
+
+//   const regions = await (await fetch(url)).json();
+
+//   return regions;
+// };
+
+/**
+ * 기상청 API; 특보
+ */
+export const routeWeatherKoreaAlert = async ({
+  domain,
+  routeUrl,
+  searchParams,
+}: {
+  domain: string;
+  routeUrl: string;
+  searchParams: URLSearchParams;
+}): Promise<NextResponse<API_Res_WeatherKoreaAlert>> => {
+  const params = new URLSearchParams({
+    // authKey,
+    // dataType: "JSON",
+    // reg: "",
+    // wrn: "",
+    // disp: "0",
+    // fe: "f",
+    // tm: "",
+  });
+  const url = generateBackendQueryUrl_GET({
+    domain,
+    routeUrl,
+    queryUrl: QUERY_URL.alert,
+    searchParams,
+  });
+
+  nextAPILog("GET", routeUrl, url, { params, searchParams });
+  const info = await (await fetch(url)).json();
+
+  return setDebugResponseHeaders<API_Res_WeatherKoreaAlert>({
+    res: info,
+    domain,
+    queryUrl: QUERY_URL.alert,
+    searchParams,
+  });
+};