@things-factory/integration-data-go-kr 10.0.0-beta.62 → 10.0.0-beta.63

package/dist-server/engine/task/weather/grid-converter.js

@@ -0,0 +1,69 @@
+"use strict";
+/**
+ * KMA(기상청) 5km 격자좌표 ↔ 위경도 변환.
+ *
+ * 동네예보·초단기 시리즈는 위경도가 아닌 KMA 자체 격자(nx, ny) 로 호출하므로,
+ * 일반적으로 알고 있는 위경도 좌표를 격자로 바꿔주는 헬퍼가 필요하다.
+ *
+ * 변환식 출처: 기상청 공식 동네예보 격자 변환 문서 (Lambert Conformal Conic).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.latLonToGrid = latLonToGrid;
+exports.gridToLatLon = gridToLatLon;
+const RE = 6371.00877; /* 지구 반경 (km) */
+const GRID = 5.0; /* 격자 간격 (km) */
+const SLAT1 = 30.0; /* 표준 위도 1 (degree) */
+const SLAT2 = 60.0; /* 표준 위도 2 (degree) */
+const OLON = 126.0; /* 기준점 경도 (degree) */
+const OLAT = 38.0; /* 기준점 위도 (degree) */
+const XO = 43; /* 기준점 X좌표 (격자 단위) */
+const YO = 136; /* 기준점 Y좌표 (격자 단위) */
+const DEGRAD = Math.PI / 180.0;
+const RADDEG = 180.0 / Math.PI;
+const re = RE / GRID;
+const slat1 = SLAT1 * DEGRAD;
+const slat2 = SLAT2 * DEGRAD;
+const olon = OLON * DEGRAD;
+const olat = OLAT * DEGRAD;
+const sn = Math.log(Math.cos(slat1) / Math.cos(slat2)) /
+    Math.log(Math.tan(Math.PI * 0.25 + slat2 * 0.5) / Math.tan(Math.PI * 0.25 + slat1 * 0.5));
+const sf = (Math.pow(Math.tan(Math.PI * 0.25 + slat1 * 0.5), sn) * Math.cos(slat1)) / sn;
+const ro = (re * sf) / Math.pow(Math.tan(Math.PI * 0.25 + olat * 0.5), sn);
+/** 위경도 → KMA 5km 격자좌표 (nx, ny). */
+function latLonToGrid(input) {
+    const ra = (re * sf) / Math.pow(Math.tan(Math.PI * 0.25 + input.latitude * DEGRAD * 0.5), sn);
+    let theta = input.longitude * DEGRAD - olon;
+    if (theta > Math.PI)
+        theta -= 2.0 * Math.PI;
+    if (theta < -Math.PI)
+        theta += 2.0 * Math.PI;
+    theta *= sn;
+    const x = ra * Math.sin(theta) + XO;
+    const y = ro - ra * Math.cos(theta) + YO;
+    return { nx: Math.floor(x + 1.5), ny: Math.floor(y + 1.5) };
+}
+/** KMA 5km 격자좌표 → 위경도 (격자 중심점). */
+function gridToLatLon(input) {
+    const xn = input.nx - XO;
+    const yn = ro - (input.ny - YO);
+    let ra = Math.sqrt(xn * xn + yn * yn);
+    if (sn < 0.0)
+        ra = -ra;
+    let alat = Math.pow((re * sf) / ra, 1.0 / sn);
+    alat = 2.0 * Math.atan(alat) - Math.PI * 0.5;
+    let theta;
+    if (Math.abs(xn) <= 0.0) {
+        theta = 0.0;
+    }
+    else if (Math.abs(yn) <= 0.0) {
+        theta = Math.PI * 0.5;
+        if (xn < 0.0)
+            theta = -theta;
+    }
+    else {
+        theta = Math.atan2(xn, yn);
+    }
+    const alon = theta / sn + olon;
+    return { latitude: alat * RADDEG, longitude: alon * RADDEG };
+}
+//# sourceMappingURL=grid-converter.js.map

package/dist-server/engine/task/weather/grid-converter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid-converter.js","sourceRoot":"","sources":["../../../../server/engine/task/weather/grid-converter.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * KMA(기상청) 5km 격자좌표 ↔ 위경도 변환.\n *\n * 동네예보·초단기 시리즈는 위경도가 아닌 KMA 자체 격자(nx, ny) 로 호출하므로,\n * 일반적으로 알고 있는 위경도 좌표를 격자로 바꿔주는 헬퍼가 필요하다.\n *\n * 변환식 출처: 기상청 공식 동네예보 격자 변환 문서 (Lambert Conformal Conic).\n */\n\nconst RE = 6371.00877 /* 지구 반경 (km) */\nconst GRID = 5.0 /* 격자 간격 (km) */\nconst SLAT1 = 30.0 /* 표준 위도 1 (degree) */\nconst SLAT2 = 60.0 /* 표준 위도 2 (degree) */\nconst OLON = 126.0 /* 기준점 경도 (degree) */\nconst OLAT = 38.0 /* 기준점 위도 (degree) */\nconst XO = 43 /* 기준점 X좌표 (격자 단위) */\nconst YO = 136 /* 기준점 Y좌표 (격자 단위) */\n\nconst DEGRAD = Math.PI / 180.0\nconst RADDEG = 180.0 / Math.PI\n\nconst re = RE / GRID\nconst slat1 = SLAT1 * DEGRAD\nconst slat2 = SLAT2 * DEGRAD\nconst olon = OLON * DEGRAD\nconst olat = OLAT * DEGRAD\n\nconst sn =\n  Math.log(Math.cos(slat1) / Math.cos(slat2)) /\n  Math.log(Math.tan(Math.PI * 0.25 + slat2 * 0.5) / Math.tan(Math.PI * 0.25 + slat1 * 0.5))\nconst sf = (Math.pow(Math.tan(Math.PI * 0.25 + slat1 * 0.5), sn) * Math.cos(slat1)) / sn\nconst ro = (re * sf) / Math.pow(Math.tan(Math.PI * 0.25 + olat * 0.5), sn)\n\nexport interface LatLon {\n  /** 위도 (degree). */\n  latitude: number\n  /** 경도 (degree). */\n  longitude: number\n}\n\nexport interface KmaGrid {\n  /** 격자 X. */\n  nx: number\n  /** 격자 Y. */\n  ny: number\n}\n\n/** 위경도 → KMA 5km 격자좌표 (nx, ny). */\nexport function latLonToGrid(input: LatLon): KmaGrid {\n  const ra = (re * sf) / Math.pow(Math.tan(Math.PI * 0.25 + input.latitude * DEGRAD * 0.5), sn)\n  let theta = input.longitude * DEGRAD - olon\n  if (theta > Math.PI) theta -= 2.0 * Math.PI\n  if (theta < -Math.PI) theta += 2.0 * Math.PI\n  theta *= sn\n  const x = ra * Math.sin(theta) + XO\n  const y = ro - ra * Math.cos(theta) + YO\n  return { nx: Math.floor(x + 1.5), ny: Math.floor(y + 1.5) }\n}\n\n/** KMA 5km 격자좌표 → 위경도 (격자 중심점). */\nexport function gridToLatLon(input: KmaGrid): LatLon {\n  const xn = input.nx - XO\n  const yn = ro - (input.ny - YO)\n  let ra = Math.sqrt(xn * xn + yn * yn)\n  if (sn < 0.0) ra = -ra\n  let alat = Math.pow((re * sf) / ra, 1.0 / sn)\n  alat = 2.0 * Math.atan(alat) - Math.PI * 0.5\n  let theta: number\n  if (Math.abs(xn) <= 0.0) {\n    theta = 0.0\n  } else if (Math.abs(yn) <= 0.0) {\n    theta = Math.PI * 0.5\n    if (xn < 0.0) theta = -theta\n  } else {\n    theta = Math.atan2(xn, yn)\n  }\n  const alon = theta / sn + olon\n  return { latitude: alat * RADDEG, longitude: alon * RADDEG }\n}\n"]}

package/dist-server/engine/task/weather/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 기상청(KMA) 도메인 전용 태스크 그룹.
+ *
+ * 새 KMA 전용 태스크(예: AWS 자동수집, 특보 알림 등) 추가 시:
+ *  - 본 폴더에 `<variant>.ts` 파일 추가 → TaskRegistry 등록
+ *  - 본 index 에 `import './<variant>'` 한 줄 추가
+ *
+ * 단순 조회는 범용 `data-go-kr-call` + 스펙 레지스트리로 충분하므로,
+ * 이 폴더에는 입력 폼·헬퍼·도메인 가공이 가치 있는 태스크만 배치.
+ */
+import './short-term-forecast';
+export { latLonToGrid, gridToLatLon } from './grid-converter';
+export type { LatLon, KmaGrid } from './grid-converter';

package/dist-server/engine/task/weather/index.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.gridToLatLon = exports.latLonToGrid = void 0;
+/**
+ * 기상청(KMA) 도메인 전용 태스크 그룹.
+ *
+ * 새 KMA 전용 태스크(예: AWS 자동수집, 특보 알림 등) 추가 시:
+ *  - 본 폴더에 `<variant>.ts` 파일 추가 → TaskRegistry 등록
+ *  - 본 index 에 `import './<variant>'` 한 줄 추가
+ *
+ * 단순 조회는 범용 `data-go-kr-call` + 스펙 레지스트리로 충분하므로,
+ * 이 폴더에는 입력 폼·헬퍼·도메인 가공이 가치 있는 태스크만 배치.
+ */
+require("./short-term-forecast");
+var grid_converter_1 = require("./grid-converter");
+Object.defineProperty(exports, "latLonToGrid", { enumerable: true, get: function () { return grid_converter_1.latLonToGrid; } });
+Object.defineProperty(exports, "gridToLatLon", { enumerable: true, get: function () { return grid_converter_1.gridToLatLon; } });
+//# sourceMappingURL=index.js.map

package/dist-server/engine/task/weather/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../server/engine/task/weather/index.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;GASG;AACH,iCAA8B;AAE9B,mDAA6D;AAApD,8GAAA,YAAY,OAAA;AAAE,8GAAA,YAAY,OAAA","sourcesContent":["/**\n * 기상청(KMA) 도메인 전용 태스크 그룹.\n *\n * 새 KMA 전용 태스크(예: AWS 자동수집, 특보 알림 등) 추가 시:\n *  - 본 폴더에 `<variant>.ts` 파일 추가 → TaskRegistry 등록\n *  - 본 index 에 `import './<variant>'` 한 줄 추가\n *\n * 단순 조회는 범용 `data-go-kr-call` + 스펙 레지스트리로 충분하므로,\n * 이 폴더에는 입력 폼·헬퍼·도메인 가공이 가치 있는 태스크만 배치.\n */\nimport './short-term-forecast'\n\nexport { latLonToGrid, gridToLatLon } from './grid-converter'\nexport type { LatLon, KmaGrid } from './grid-converter'\n"]}

package/dist-server/engine/task/weather/short-term-forecast.d.ts

@@ -0,0 +1,38 @@
+import { Context } from '@things-factory/integration-base';
+/**
+ * 기상청 단기예보 (`getVilageFcst`) 조회 태스크.
+ *
+ * 입력 폼이 명시된 전용 태스크. 위경도 입력 시 KMA 격자로 자동 변환.
+ *
+ * 입력 (둘 중 하나):
+ *  - `nx`, `ny`             : KMA 5km 격자좌표
+ *  - `latitude`, `longitude`: 위경도 (자동으로 nx/ny 로 변환)
+ *
+ * 추가:
+ *  - `baseDate`  : 발표일자 YYYYMMDD (필수)
+ *  - `baseTime`  : 발표시각 HHMM (필수, 0200/0500/0800/1100/1400/1700/2000/2300)
+ *  - `numOfRows` : 페이지당 결과수 (기본 1000 — 3일치 카테고리×시점 합계 약 800+)
+ *
+ * 다른 단기예보 오퍼레이션(getUltraSrtFcst, getUltraSrtNcst) 은 동일 서비스 안에 있으므로
+ * 범용 `data-go-kr-call` 로 호출 권장.
+ */
+declare function ShortTermForecastTask(step: any, context: Context): Promise<{
+    data: {
+        items: any[];
+    };
+}>;
+declare namespace ShortTermForecastTask {
+    var parameterSpec: ({
+        type: string;
+        name: string;
+        label: string;
+        placeholder: string;
+    } | {
+        type: string;
+        name: string;
+        label: string;
+        placeholder?: undefined;
+    })[];
+    var help: string;
+}
+export default ShortTermForecastTask;

package/dist-server/engine/task/weather/short-term-forecast.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const integration_base_1 = require("@things-factory/integration-base");
+const short_term_forecast_1 = require("../../spec/weather/short-term-forecast");
+const grid_converter_1 = require("./grid-converter");
+/**
+ * 기상청 단기예보 (`getVilageFcst`) 조회 태스크.
+ *
+ * 입력 폼이 명시된 전용 태스크. 위경도 입력 시 KMA 격자로 자동 변환.
+ *
+ * 입력 (둘 중 하나):
+ *  - `nx`, `ny`             : KMA 5km 격자좌표
+ *  - `latitude`, `longitude`: 위경도 (자동으로 nx/ny 로 변환)
+ *
+ * 추가:
+ *  - `baseDate`  : 발표일자 YYYYMMDD (필수)
+ *  - `baseTime`  : 발표시각 HHMM (필수, 0200/0500/0800/1100/1400/1700/2000/2300)
+ *  - `numOfRows` : 페이지당 결과수 (기본 1000 — 3일치 카테고리×시점 합계 약 800+)
+ *
+ * 다른 단기예보 오퍼레이션(getUltraSrtFcst, getUltraSrtNcst) 은 동일 서비스 안에 있으므로
+ * 범용 `data-go-kr-call` 로 호출 권장.
+ */
+async function ShortTermForecastTask(step, context) {
+    const { connection: connectionName, params } = step;
+    const { domain, user, data, variables, lng, logger } = context;
+    const instance = await integration_base_1.ConnectionManager.getConnectionInstanceByName(domain, connectionName);
+    if (!instance?.client) {
+        throw new Error(`data-go-kr connection '${connectionName}' is not established.`);
+    }
+    const scope = { domain, user, lng, data, variables, console };
+    const evalString = (value) => {
+        if (value === undefined || value === null || value === '')
+            return undefined;
+        try {
+            return (0, integration_base_1.evaluateTemplate)(String(value), scope);
+        }
+        catch (err) {
+            throw new Error(`weather-short-term-forecast: failed to evaluate parameter: ${err.message}`);
+        }
+    };
+    const evalNumber = (value) => {
+        const s = evalString(value);
+        if (s === undefined)
+            return undefined;
+        const n = Number(s);
+        return Number.isFinite(n) ? n : undefined;
+    };
+    const baseDate = evalString(params.baseDate);
+    const baseTime = evalString(params.baseTime);
+    if (!baseDate)
+        throw new Error('weather-short-term-forecast: baseDate is required');
+    if (!baseTime)
+        throw new Error('weather-short-term-forecast: baseTime is required');
+    const explicitNx = evalNumber(params.nx);
+    const explicitNy = evalNumber(params.ny);
+    const lat = evalNumber(params.latitude);
+    const lon = evalNumber(params.longitude);
+    let nx;
+    let ny;
+    if (explicitNx !== undefined && explicitNy !== undefined) {
+        nx = explicitNx;
+        ny = explicitNy;
+    }
+    else if (lat !== undefined && lon !== undefined) {
+        const grid = (0, grid_converter_1.latLonToGrid)({ latitude: lat, longitude: lon });
+        nx = grid.nx;
+        ny = grid.ny;
+        logger?.info?.(`[data-go-kr] latLonToGrid lat=${lat} lon=${lon} → nx=${nx} ny=${ny}`);
+    }
+    else {
+        throw new Error('weather-short-term-forecast: provide either (nx, ny) or (latitude, longitude). 둘 다 비어있음.');
+    }
+    const servicePath = `${short_term_forecast_1.KmaShortTermForecastService.serviceId}/getVilageFcst`;
+    const queryParams = {
+        base_date: baseDate,
+        base_time: baseTime,
+        nx,
+        ny,
+        numOfRows: evalNumber(params.numOfRows) ?? 1000,
+        pageNo: evalNumber(params.pageNo) ?? 1
+    };
+    logger?.info?.(`[data-go-kr] ${servicePath} params=${JSON.stringify(queryParams)}`);
+    const items = await instance.client.getItems(servicePath, queryParams);
+    return { data: { items } };
+}
+ShortTermForecastTask.parameterSpec = [
+    { type: 'string', name: 'baseDate', label: 'label.base-date', placeholder: '예) 20260425' },
+    { type: 'string', name: 'baseTime', label: 'label.base-time', placeholder: '예) 1100' },
+    { type: 'string', name: 'nx', label: 'label.nx', placeholder: '예) 60' },
+    { type: 'string', name: 'ny', label: 'label.ny', placeholder: '예) 127' },
+    { type: 'string', name: 'latitude', label: 'label.latitude', placeholder: '위경도 입력 시 nx/ny 자동 계산' },
+    { type: 'string', name: 'longitude', label: 'label.longitude' },
+    { type: 'string', name: 'numOfRows', label: 'label.num-of-rows', placeholder: '기본 1000' },
+    { type: 'string', name: 'pageNo', label: 'label.page-no', placeholder: '기본 1' }
+];
+ShortTermForecastTask.help = 'integration/task/weather-short-term-forecast';
+integration_base_1.TaskRegistry.registerTaskHandler('data-go-kr-weather-short-term-forecast', ShortTermForecastTask);
+exports.default = ShortTermForecastTask;
+//# sourceMappingURL=short-term-forecast.js.map

package/dist-server/engine/task/weather/short-term-forecast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"short-term-forecast.js","sourceRoot":"","sources":["../../../../server/engine/task/weather/short-term-forecast.ts"],"names":[],"mappings":"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","sourcesContent":["import { ConnectionManager, Context, TaskRegistry, evaluateTemplate } from '@things-factory/integration-base'\n\nimport { DataGoKrConnectionInstance } from '../../connector/data-go-kr-connector'\nimport { KmaShortTermForecastService } from '../../spec/weather/short-term-forecast'\nimport { latLonToGrid } from './grid-converter'\n\n/**\n * 기상청 단기예보 (`getVilageFcst`) 조회 태스크.\n *\n * 입력 폼이 명시된 전용 태스크. 위경도 입력 시 KMA 격자로 자동 변환.\n *\n * 입력 (둘 중 하나):\n *  - `nx`, `ny`             : KMA 5km 격자좌표\n *  - `latitude`, `longitude`: 위경도 (자동으로 nx/ny 로 변환)\n *\n * 추가:\n *  - `baseDate`  : 발표일자 YYYYMMDD (필수)\n *  - `baseTime`  : 발표시각 HHMM (필수, 0200/0500/0800/1100/1400/1700/2000/2300)\n *  - `numOfRows` : 페이지당 결과수 (기본 1000 — 3일치 카테고리×시점 합계 약 800+)\n *\n * 다른 단기예보 오퍼레이션(getUltraSrtFcst, getUltraSrtNcst) 은 동일 서비스 안에 있으므로\n * 범용 `data-go-kr-call` 로 호출 권장.\n */\nasync function ShortTermForecastTask(step, context: Context): Promise<{ data: { items: any[] } }> {\n  const { connection: connectionName, params } = step\n  const { domain, user, data, variables, lng, logger } = context\n\n  const instance: DataGoKrConnectionInstance = await ConnectionManager.getConnectionInstanceByName(\n    domain,\n    connectionName\n  )\n  if (!instance?.client) {\n    throw new Error(`data-go-kr connection '${connectionName}' is not established.`)\n  }\n\n  const scope = { domain, user, lng, data, variables, console }\n  const evalString = (value: string | undefined) => {\n    if (value === undefined || value === null || value === '') return undefined\n    try {\n      return evaluateTemplate(String(value), scope)\n    } catch (err) {\n      throw new Error(`weather-short-term-forecast: failed to evaluate parameter: ${(err as Error).message}`)\n    }\n  }\n  const evalNumber = (value: any): number | undefined => {\n    const s = evalString(value as string | undefined)\n    if (s === undefined) return undefined\n    const n = Number(s)\n    return Number.isFinite(n) ? n : undefined\n  }\n\n  const baseDate = evalString(params.baseDate)\n  const baseTime = evalString(params.baseTime)\n  if (!baseDate) throw new Error('weather-short-term-forecast: baseDate is required')\n  if (!baseTime) throw new Error('weather-short-term-forecast: baseTime is required')\n\n  const explicitNx = evalNumber(params.nx)\n  const explicitNy = evalNumber(params.ny)\n  const lat = evalNumber(params.latitude)\n  const lon = evalNumber(params.longitude)\n\n  let nx: number\n  let ny: number\n  if (explicitNx !== undefined && explicitNy !== undefined) {\n    nx = explicitNx\n    ny = explicitNy\n  } else if (lat !== undefined && lon !== undefined) {\n    const grid = latLonToGrid({ latitude: lat, longitude: lon })\n    nx = grid.nx\n    ny = grid.ny\n    logger?.info?.(`[data-go-kr] latLonToGrid lat=${lat} lon=${lon} → nx=${nx} ny=${ny}`)\n  } else {\n    throw new Error(\n      'weather-short-term-forecast: provide either (nx, ny) or (latitude, longitude). 둘 다 비어있음.'\n    )\n  }\n\n  const servicePath = `${KmaShortTermForecastService.serviceId}/getVilageFcst`\n  const queryParams = {\n    base_date: baseDate,\n    base_time: baseTime,\n    nx,\n    ny,\n    numOfRows: evalNumber(params.numOfRows) ?? 1000,\n    pageNo: evalNumber(params.pageNo) ?? 1\n  }\n\n  logger?.info?.(`[data-go-kr] ${servicePath} params=${JSON.stringify(queryParams)}`)\n\n  const items = await instance.client.getItems<any>(servicePath, queryParams)\n\n  return { data: { items } }\n}\n\nShortTermForecastTask.parameterSpec = [\n  { type: 'string', name: 'baseDate', label: 'label.base-date', placeholder: '예) 20260425' },\n  { type: 'string', name: 'baseTime', label: 'label.base-time', placeholder: '예) 1100' },\n  { type: 'string', name: 'nx', label: 'label.nx', placeholder: '예) 60' },\n  { type: 'string', name: 'ny', label: 'label.ny', placeholder: '예) 127' },\n  { type: 'string', name: 'latitude', label: 'label.latitude', placeholder: '위경도 입력 시 nx/ny 자동 계산' },\n  { type: 'string', name: 'longitude', label: 'label.longitude' },\n  { type: 'string', name: 'numOfRows', label: 'label.num-of-rows', placeholder: '기본 1000' },\n  { type: 'string', name: 'pageNo', label: 'label.page-no', placeholder: '기본 1' }\n]\n\nShortTermForecastTask.help = 'integration/task/weather-short-term-forecast'\n\nTaskRegistry.registerTaskHandler('data-go-kr-weather-short-term-forecast', ShortTermForecastTask)\n\nexport default ShortTermForecastTask\n"]}

package/dist-server/index.d.ts

@@ -2,3 +2,5 @@ import './engine';
 export * from './engine/types';
 export * from './engine/spec';
 export { DataGoKrClient } from './engine/connector/data-go-kr-client';
+export { latLonToGrid, gridToLatLon } from './engine/task/weather';
+export type { LatLon, KmaGrid } from './engine/task/weather';

package/dist-server/index.js

@@ -1,10 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DataGoKrClient = void 0;
+exports.gridToLatLon = exports.latLonToGrid = exports.DataGoKrClient = void 0;
 const tslib_1 = require("tslib");
 require("./engine");
 tslib_1.__exportStar(require("./engine/types"), exports);
 tslib_1.__exportStar(require("./engine/spec"), exports);
 var data_go_kr_client_1 = require("./engine/connector/data-go-kr-client");
 Object.defineProperty(exports, "DataGoKrClient", { enumerable: true, get: function () { return data_go_kr_client_1.DataGoKrClient; } });
+var weather_1 = require("./engine/task/weather");
+Object.defineProperty(exports, "latLonToGrid", { enumerable: true, get: function () { return weather_1.latLonToGrid; } });
+Object.defineProperty(exports, "gridToLatLon", { enumerable: true, get: function () { return weather_1.gridToLatLon; } });
 //# sourceMappingURL=index.js.map

package/dist-server/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../server/index.ts"],"names":[],"mappings":";;;;AAAA,oBAAiB;AAEjB,yDAA8B;AAC9B,wDAA6B;AAC7B,0EAAqE;AAA5D,mHAAA,cAAc,OAAA","sourcesContent":["import './engine'\n\nexport * from './engine/types'\nexport * from './engine/spec'\nexport { DataGoKrClient } from './engine/connector/data-go-kr-client'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../server/index.ts"],"names":[],"mappings":";;;;AAAA,oBAAiB;AAEjB,yDAA8B;AAC9B,wDAA6B;AAC7B,0EAAqE;AAA5D,mHAAA,cAAc,OAAA;AACvB,iDAAkE;AAAzD,uGAAA,YAAY,OAAA;AAAE,uGAAA,YAAY,OAAA","sourcesContent":["import './engine'\n\nexport * from './engine/types'\nexport * from './engine/spec'\nexport { DataGoKrClient } from './engine/connector/data-go-kr-client'\nexport { latLonToGrid, gridToLatLon } from './engine/task/weather'\nexport type { LatLon, KmaGrid } from './engine/task/weather'\n"]}