@things-factory/integration-juso 10.0.0-beta.63

package/README.md

@@ -0,0 +1,63 @@
+# @things-factory/integration-juso
+
+행정안전부 **도로명주소 안내시스템 (juso.go.kr)** Open API 를 Things-Factory 통합 엔진에서 호출하기 위한 커넥터 + 태스크.
+
+## 핵심 기능
+
+도로명/지번 주소 문자열 → **PNU 5요소 + 법정동코드 + 우편번호** 변환. 한국 공공·부동산 API 들이 요구하는 표준 식별자를 한 번의 호출로 추출합니다.
+
+## 제공 컴포넌트
+
+### Connector
+- `juso-connector` — confmKey 기반 클라이언트 (활용신청 후 무료 발급)
+
+### Tasks
+- `juso-resolve-address` — 주소 → 표준 식별자 + 행정구역명 통합 변환
+
+### 출력 형태 (백엔드 호환)
+
+```jsonc
+{
+  "address": { "road": "...", "jibun": "...", "buildingName": "...", "siNm": "...", "sggNm": "...", "emdNm": "..." },
+  "pnu":     { "sigunguCd": "...", "bjdongCd": "...", "platGbCd": "...", "bun": "...", "ji": "..." },
+  "admCd":   "1168010300",
+  "bdMgtSn": "...",
+  "rnMgtSn": "...",
+  "zipNo":   "06168",
+  "raw":     { /* 원본 */ }
+}
+```
+
+이 형태는 향후 다른 resolver(예: `vworld-resolve-address`) 가 추가될 때 동일하게 사용할 표준 출력입니다. 소비자는 백엔드를 바꿔도 매핑 변경이 필요 없습니다.
+
+## 빠른 시작
+
+```
+1. https://business.juso.go.kr 가입 + OPEN API 활용신청 (~1영업일)
+2. 마이페이지에서 confmKey 복사
+3. Things-Factory 통합 UI → Connection 생성 (type=juso-connector)
+4. Scenario → Step 추가 (juso-resolve-address)
+```
+
+자세한 가이드는 [helps/integration/connector/juso-connector.md](./helps/integration/connector/juso-connector.md) 참조.
+
+## 사용 예시 — 건축물대장 조회 체인
+
+```
+[juso-resolve-address] (주소 → PNU)
+    ↓ ${data.pnu.*}
+[data-go-kr-building-ledger] (PNU → 표제부)
+    ↓ items
+[data-mapper / 도메인 task] (4속성 → KPI 등)
+```
+
+dkpi 같은 소비자에서는 **현장 등록 시 1회** resolve → 결과를 엔티티에 저장 → KPI 호출 시는 저장된 PNU 직접 사용. resolve 반복 호출 불필요.
+
+## 향후 — VWorld 등 다른 resolver 와 호환
+
+위경도까지 필요하면 별도 `@things-factory/integration-vworld` 패키지의 `vworld-resolve-address` 태스크 추가 예정 (동일 출력 형태). 소비자는 임포트만 바꾸면 됨.
+
+## 레퍼런스
+
+- [도로명주소 안내시스템 OPEN API](https://business.juso.go.kr/addrlink/openApi/apiReqstRule.do)
+- 행정안전부 표준 행정구역코드 / 법정동코드 [code.go.kr](https://www.code.go.kr)

package/dist-server/engine/connector/index.d.ts

@@ -0,0 +1 @@
+import './juso-connector';

package/dist-server/engine/connector/index.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+require("./juso-connector");
+//# sourceMappingURL=index.js.map

package/dist-server/engine/connector/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/engine/connector/index.ts"],"names":[],"mappings":";;AAAA,4BAAyB","sourcesContent":["import './juso-connector'\n"]}

package/dist-server/engine/connector/juso-client.d.ts

@@ -0,0 +1,20 @@
+import { JusoItem } from '../types';
+export interface JusoClientOptions {
+    confmKey: string;
+    origin?: string;
+}
+export interface JusoSearchOptions {
+    /** 검색어 (도로명주소 또는 지번주소). */
+    keyword: string;
+    /** 페이지당 결과수 (기본 10). */
+    countPerPage?: number;
+    /** 현재 페이지 (기본 1). */
+    currentPage?: number;
+}
+export declare class JusoClient {
+    private readonly confmKey;
+    private readonly origin;
+    constructor(options: JusoClientOptions);
+    /** 도로명/지번 주소 검색. 응답의 juso 배열을 반환 (없으면 빈 배열). */
+    search(options: JusoSearchOptions): Promise<JusoItem[]>;
+}

package/dist-server/engine/connector/juso-client.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JusoClient = void 0;
+/**
+ * juso.go.kr (도로명주소 안내시스템) Open API 호출 클라이언트.
+ *
+ * - 엔드포인트: `https://business.juso.go.kr/addrlink/addrLinkApi.do`
+ * - 인증: `confmKey` 쿼리 파라미터 (활용신청 후 발급)
+ * - 응답: JSON (기본은 XML 이라 `resultType=json` 필수)
+ */
+const DEFAULT_ORIGIN = 'https://business.juso.go.kr';
+const SEARCH_PATH = '/addrlink/addrLinkApi.do';
+class JusoClient {
+    constructor(options) {
+        if (!options.confmKey) {
+            throw new Error('JusoClient requires confmKey');
+        }
+        this.confmKey = options.confmKey.trim();
+        this.origin = resolveOrigin(options.origin);
+    }
+    /** 도로명/지번 주소 검색. 응답의 juso 배열을 반환 (없으면 빈 배열). */
+    async search(options) {
+        const url = new URL(`${this.origin}${SEARCH_PATH}`);
+        url.searchParams.set('confmKey', this.confmKey);
+        url.searchParams.set('resultType', 'json');
+        url.searchParams.set('keyword', options.keyword);
+        url.searchParams.set('currentPage', String(options.currentPage ?? 1));
+        url.searchParams.set('countPerPage', String(options.countPerPage ?? 10));
+        const response = await fetch(url.toString(), {
+            method: 'GET',
+            headers: {
+                'User-Agent': '@things-factory/integration-juso',
+                Accept: 'application/json'
+            }
+        });
+        const raw = await response.text();
+        if (!response.ok) {
+            throw new Error(`juso.go.kr search failed (${response.status}): ${raw.slice(0, 300)}`);
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch (err) {
+            throw new Error(`juso.go.kr search returned non-JSON: ${raw.slice(0, 300)}`);
+        }
+        const common = parsed?.results?.common;
+        if (!common) {
+            throw new Error('juso.go.kr response missing results.common');
+        }
+        if (common.errorCode !== '0') {
+            throw new Error(`juso.go.kr error: code=${common.errorCode} msg=${common.errorMessage} keyword='${options.keyword}'`);
+        }
+        return parsed.results.juso || [];
+    }
+}
+exports.JusoClient = JusoClient;
+function resolveOrigin(value) {
+    if (!value || !value.trim())
+        return DEFAULT_ORIGIN;
+    const trimmed = value.trim();
+    try {
+        const parsed = new URL(trimmed);
+        if (!parsed.protocol.startsWith('http')) {
+            throw new Error('protocol must be http or https');
+        }
+        return trimmed.replace(/\/$/, '');
+    }
+    catch (err) {
+        throw new Error(`Invalid Connection.endpoint value '${value}': must be a full URL (예: https://business.juso.go.kr) ` +
+            `or empty (기본값 ${DEFAULT_ORIGIN} 사용). Reason: ${err.message}`);
+    }
+}
+//# sourceMappingURL=juso-client.js.map

package/dist-server/engine/connector/juso-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"juso-client.js","sourceRoot":"","sources":["../../../server/engine/connector/juso-client.ts"],"names":[],"mappings":"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","sourcesContent":["import { JusoItem, JusoResponse } from '../types'\n\n/**\n * juso.go.kr (도로명주소 안내시스템) Open API 호출 클라이언트.\n *\n * - 엔드포인트: `https://business.juso.go.kr/addrlink/addrLinkApi.do`\n * - 인증: `confmKey` 쿼리 파라미터 (활용신청 후 발급)\n * - 응답: JSON (기본은 XML 이라 `resultType=json` 필수)\n */\n\nconst DEFAULT_ORIGIN = 'https://business.juso.go.kr'\nconst SEARCH_PATH = '/addrlink/addrLinkApi.do'\n\nexport interface JusoClientOptions {\n  confmKey: string\n  origin?: string\n}\n\nexport interface JusoSearchOptions {\n  /** 검색어 (도로명주소 또는 지번주소). */\n  keyword: string\n  /** 페이지당 결과수 (기본 10). */\n  countPerPage?: number\n  /** 현재 페이지 (기본 1). */\n  currentPage?: number\n}\n\nexport class JusoClient {\n  private readonly confmKey: string\n  private readonly origin: string\n\n  constructor(options: JusoClientOptions) {\n    if (!options.confmKey) {\n      throw new Error('JusoClient requires confmKey')\n    }\n    this.confmKey = options.confmKey.trim()\n    this.origin = resolveOrigin(options.origin)\n  }\n\n  /** 도로명/지번 주소 검색. 응답의 juso 배열을 반환 (없으면 빈 배열). */\n  async search(options: JusoSearchOptions): Promise<JusoItem[]> {\n    const url = new URL(`${this.origin}${SEARCH_PATH}`)\n    url.searchParams.set('confmKey', this.confmKey)\n    url.searchParams.set('resultType', 'json')\n    url.searchParams.set('keyword', options.keyword)\n    url.searchParams.set('currentPage', String(options.currentPage ?? 1))\n    url.searchParams.set('countPerPage', String(options.countPerPage ?? 10))\n\n    const response = await fetch(url.toString(), {\n      method: 'GET',\n      headers: {\n        'User-Agent': '@things-factory/integration-juso',\n        Accept: 'application/json'\n      }\n    })\n    const raw = await response.text()\n\n    if (!response.ok) {\n      throw new Error(`juso.go.kr search failed (${response.status}): ${raw.slice(0, 300)}`)\n    }\n\n    let parsed: JusoResponse\n    try {\n      parsed = JSON.parse(raw) as JusoResponse\n    } catch (err) {\n      throw new Error(`juso.go.kr search returned non-JSON: ${raw.slice(0, 300)}`)\n    }\n\n    const common = parsed?.results?.common\n    if (!common) {\n      throw new Error('juso.go.kr response missing results.common')\n    }\n    if (common.errorCode !== '0') {\n      throw new Error(\n        `juso.go.kr error: code=${common.errorCode} msg=${common.errorMessage} keyword='${options.keyword}'`\n      )\n    }\n\n    return parsed.results.juso || []\n  }\n}\n\nfunction resolveOrigin(value: string | undefined): string {\n  if (!value || !value.trim()) return DEFAULT_ORIGIN\n  const trimmed = value.trim()\n  try {\n    const parsed = new URL(trimmed)\n    if (!parsed.protocol.startsWith('http')) {\n      throw new Error('protocol must be http or https')\n    }\n    return trimmed.replace(/\\/$/, '')\n  } catch (err) {\n    throw new Error(\n      `Invalid Connection.endpoint value '${value}': must be a full URL (예: https://business.juso.go.kr) ` +\n        `or empty (기본값 ${DEFAULT_ORIGIN} 사용). Reason: ${(err as Error).message}`\n    )\n  }\n}\n"]}

package/dist-server/engine/connector/juso-connector.d.ts

@@ -0,0 +1,26 @@
+import { Connector } from '@things-factory/integration-base';
+import { JusoClient } from './juso-client';
+/**
+ * juso.go.kr (행정안전부 도로명주소 안내시스템) Open API 커넥터.
+ *
+ * - 활용신청: https://business.juso.go.kr/addrlink/openApi/apiReqstRule.do
+ * - confmKey (승인키) 발급 후 본 커넥터 params 에 입력.
+ * - Connection 의 `endpoint` 필드는 API 오리진 오버라이드용 (비우면 기본 `https://business.juso.go.kr`).
+ */
+export interface JusoConnectionInstance {
+    client: JusoClient;
+}
+export declare class JusoConnector implements Connector {
+    ready(connectionConfigs: any): Promise<void>;
+    connect(connection: any): Promise<void>;
+    disconnect(connection: any): Promise<void>;
+    get parameterSpec(): {
+        type: string;
+        name: string;
+        label: string;
+        useDomainAttribute: boolean;
+    }[];
+    get taskPrefixes(): string[];
+    get help(): string;
+    get description(): string;
+}

package/dist-server/engine/connector/juso-connector.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JusoConnector = void 0;
+const integration_base_1 = require("@things-factory/integration-base");
+const juso_client_1 = require("./juso-client");
+class JusoConnector {
+    async ready(connectionConfigs) {
+        await Promise.all(connectionConfigs.map(this.connect.bind(this)));
+        integration_base_1.ConnectionManager.logger.info('juso-connector connections are ready');
+    }
+    async connect(connection) {
+        const { endpoint, params } = connection;
+        try {
+            const client = new juso_client_1.JusoClient({ confmKey: params.confmKey, origin: endpoint });
+            const instance = { client };
+            integration_base_1.ConnectionManager.addConnectionInstance(connection, instance);
+            integration_base_1.ConnectionManager.logger.info(`juso-connector connection(${connection.name}) is connected (endpoint: ${endpoint || '(default)'})`);
+        }
+        catch (ex) {
+            integration_base_1.ConnectionManager.logger.error(`juso-connector connection(${connection.name}) failed`, ex);
+            throw ex;
+        }
+    }
+    async disconnect(connection) {
+        integration_base_1.ConnectionManager.removeConnectionInstance(connection);
+        integration_base_1.ConnectionManager.logger.info(`juso-connector connection(${connection.name}) is disconnected`);
+    }
+    get parameterSpec() {
+        return [
+            {
+                type: 'secret',
+                name: 'confmKey',
+                label: 'label.confm-key',
+                useDomainAttribute: true
+            }
+        ];
+    }
+    get taskPrefixes() {
+        return ['juso'];
+    }
+    get help() {
+        return 'integration/connector/juso-connector';
+    }
+    get description() {
+        return '도로명주소 안내시스템 (juso.go.kr) Connector';
+    }
+}
+exports.JusoConnector = JusoConnector;
+integration_base_1.ConnectionManager.registerConnector('juso-connector', new JusoConnector());
+//# sourceMappingURL=juso-connector.js.map

package/dist-server/engine/connector/juso-connector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"juso-connector.js","sourceRoot":"","sources":["../../../server/engine/connector/juso-connector.ts"],"names":[],"mappings":";;;AAAA,uEAA+E;AAE/E,+CAA0C;AAa1C,MAAa,aAAa;IACxB,KAAK,CAAC,KAAK,CAAC,iBAAiB;QAC3B,MAAM,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjE,oCAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAA;IACvE,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,UAAU;QACtB,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,UAAU,CAAA;QACvC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,wBAAU,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAA;YAC9E,MAAM,QAAQ,GAA2B,EAAE,MAAM,EAAE,CAAA;YACnD,oCAAiB,CAAC,qBAAqB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAA;YAC7D,oCAAiB,CAAC,MAAM,CAAC,IAAI,CAC3B,6BAA6B,UAAU,CAAC,IAAI,6BAA6B,QAAQ,IAAI,WAAW,GAAG,CACpG,CAAA;QACH,CAAC;QAAC,OAAO,EAAE,EAAE,CAAC;YACZ,oCAAiB,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA6B,UAAU,CAAC,IAAI,UAAU,EAAE,EAAE,CAAC,CAAA;YAC1F,MAAM,EAAE,CAAA;QACV,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,UAAU;QACzB,oCAAiB,CAAC,wBAAwB,CAAC,UAAU,CAAC,CAAA;QACtD,oCAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,6BAA6B,UAAU,CAAC,IAAI,mBAAmB,CAAC,CAAA;IAChG,CAAC;IAED,IAAI,aAAa;QACf,OAAO;YACL;gBACE,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,UAAU;gBAChB,KAAK,EAAE,iBAAiB;gBACxB,kBAAkB,EAAE,IAAI;aACzB;SACF,CAAA;IACH,CAAC;IAED,IAAI,YAAY;QACd,OAAO,CAAC,MAAM,CAAC,CAAA;IACjB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,sCAAsC,CAAA;IAC/C,CAAC;IAED,IAAI,WAAW;QACb,OAAO,oCAAoC,CAAA;IAC7C,CAAC;CACF;AAhDD,sCAgDC;AAED,oCAAiB,CAAC,iBAAiB,CAAC,gBAAgB,EAAE,IAAI,aAAa,EAAE,CAAC,CAAA","sourcesContent":["import { ConnectionManager, Connector } from '@things-factory/integration-base'\n\nimport { JusoClient } from './juso-client'\n\n/**\n * juso.go.kr (행정안전부 도로명주소 안내시스템) Open API 커넥터.\n *\n * - 활용신청: https://business.juso.go.kr/addrlink/openApi/apiReqstRule.do\n * - confmKey (승인키) 발급 후 본 커넥터 params 에 입력.\n * - Connection 의 `endpoint` 필드는 API 오리진 오버라이드용 (비우면 기본 `https://business.juso.go.kr`).\n */\nexport interface JusoConnectionInstance {\n  client: JusoClient\n}\n\nexport class JusoConnector implements Connector {\n  async ready(connectionConfigs) {\n    await Promise.all(connectionConfigs.map(this.connect.bind(this)))\n    ConnectionManager.logger.info('juso-connector connections are ready')\n  }\n\n  async connect(connection) {\n    const { endpoint, params } = connection\n    try {\n      const client = new JusoClient({ confmKey: params.confmKey, origin: endpoint })\n      const instance: JusoConnectionInstance = { client }\n      ConnectionManager.addConnectionInstance(connection, instance)\n      ConnectionManager.logger.info(\n        `juso-connector connection(${connection.name}) is connected (endpoint: ${endpoint || '(default)'})`\n      )\n    } catch (ex) {\n      ConnectionManager.logger.error(`juso-connector connection(${connection.name}) failed`, ex)\n      throw ex\n    }\n  }\n\n  async disconnect(connection) {\n    ConnectionManager.removeConnectionInstance(connection)\n    ConnectionManager.logger.info(`juso-connector connection(${connection.name}) is disconnected`)\n  }\n\n  get parameterSpec() {\n    return [\n      {\n        type: 'secret',\n        name: 'confmKey',\n        label: 'label.confm-key',\n        useDomainAttribute: true\n      }\n    ]\n  }\n\n  get taskPrefixes() {\n    return ['juso']\n  }\n\n  get help() {\n    return 'integration/connector/juso-connector'\n  }\n\n  get description() {\n    return '도로명주소 안내시스템 (juso.go.kr) Connector'\n  }\n}\n\nConnectionManager.registerConnector('juso-connector', new JusoConnector())\n"]}

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

@@ -0,0 +1,2 @@
+import './connector';
+import './task';

package/dist-server/engine/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+require("./connector");
+require("./task");
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../server/engine/index.ts"],"names":[],"mappings":";;AAAA,uBAAoB;AACpB,kBAAe","sourcesContent":["import './connector'\nimport './task'\n"]}

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

@@ -0,0 +1,7 @@
+/**
+ * 주소 도메인 태스크 그룹.
+ *
+ * 새 변형(예: 좌표→주소 reverse, 우편번호 단독 검색 등) 추가 시 본 폴더에 파일 한 개 +
+ * 본 index 의 import 한 줄. 폴더 구조 자체가 확장 포인트.
+ */
+import './resolve';

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

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * 주소 도메인 태스크 그룹.
+ *
+ * 새 변형(예: 좌표→주소 reverse, 우편번호 단독 검색 등) 추가 시 본 폴더에 파일 한 개 +
+ * 본 index 의 import 한 줄. 폴더 구조 자체가 확장 포인트.
+ */
+require("./resolve");
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../server/engine/task/address/index.ts"],"names":[],"mappings":";;AAAA;;;;;GAKG;AACH,qBAAkB","sourcesContent":["/**\n * 주소 도메인 태스크 그룹.\n *\n * 새 변형(예: 좌표→주소 reverse, 우편번호 단독 검색 등) 추가 시 본 폴더에 파일 한 개 +\n * 본 index 의 import 한 줄. 폴더 구조 자체가 확장 포인트.\n */\nimport './resolve'\n"]}

package/dist-server/engine/task/address/resolve.d.ts

@@ -0,0 +1,50 @@
+import { Context } from '@things-factory/integration-base';
+import { JusoItem, ResolvedAddress } from '../../types';
+/**
+ * 도로명/지번 주소 → 표준 식별자 (PNU 5요소 + 법정동코드 + 우편번호) 변환 태스크.
+ *
+ * 다른 백엔드 (VWorld 등) 가 이 task 와 **같은 출력 형태(`ResolvedAddress`)** 를 반환하면
+ * 소비자 시나리오는 백엔드 교체 시 매핑 변경이 필요 없도록 설계됨.
+ *
+ * 입력:
+ *  - `query`        : 검색할 주소 문자열 (도로명 또는 지번 모두 가능)
+ *  - `pickFirst`    : 다수 매칭 시 첫 결과 선택 (기본 true). false 면 결과가 둘 이상일 때 에러.
+ *
+ * 출력 (`data`):
+ *  - `ResolvedAddress` (단건). 매칭 0건이면 에러.
+ */
+declare function JusoResolveAddressTask(step: any, context: Context): Promise<{
+    data: ResolvedAddress;
+}>;
+declare namespace JusoResolveAddressTask {
+    var parameterSpec: ({
+        type: string;
+        name: string;
+        label: string;
+        placeholder: string;
+        property?: undefined;
+    } | {
+        type: string;
+        name: string;
+        label: string;
+        property: {
+            options: {
+                value: string;
+                display: string;
+            }[];
+        };
+        placeholder?: undefined;
+    })[];
+    var help: string;
+}
+/**
+ * juso 단일 결과 → 표준 ResolvedAddress.
+ *
+ * 매핑 규칙:
+ *  - sigunguCd = admCd[0..4], bjdongCd = admCd[5..9]
+ *  - platGbCd = mtYn === '1' ? '1' : '0' (산 지번 여부)
+ *  - bun = lnbrMnnm, ji = lnbrSlno
+ *  - 좌표는 juso 응답에 없으므로 undefined
+ */
+export declare function mapToResolvedAddress(item: JusoItem): ResolvedAddress;
+export default JusoResolveAddressTask;

package/dist-server/engine/task/address/resolve.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapToResolvedAddress = mapToResolvedAddress;
+const integration_base_1 = require("@things-factory/integration-base");
+/**
+ * 도로명/지번 주소 → 표준 식별자 (PNU 5요소 + 법정동코드 + 우편번호) 변환 태스크.
+ *
+ * 다른 백엔드 (VWorld 등) 가 이 task 와 **같은 출력 형태(`ResolvedAddress`)** 를 반환하면
+ * 소비자 시나리오는 백엔드 교체 시 매핑 변경이 필요 없도록 설계됨.
+ *
+ * 입력:
+ *  - `query`        : 검색할 주소 문자열 (도로명 또는 지번 모두 가능)
+ *  - `pickFirst`    : 다수 매칭 시 첫 결과 선택 (기본 true). false 면 결과가 둘 이상일 때 에러.
+ *
+ * 출력 (`data`):
+ *  - `ResolvedAddress` (단건). 매칭 0건이면 에러.
+ */
+async function JusoResolveAddressTask(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(`juso 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(`juso-resolve-address: failed to evaluate parameter: ${err.message}`);
+        }
+    };
+    const query = evalString(params.query);
+    if (!query) {
+        throw new Error('juso-resolve-address: query is required (address string).');
+    }
+    const pickFirst = params.pickFirst === undefined ? true : Boolean(params.pickFirst);
+    logger?.info?.(`[juso] search keyword='${query}'`);
+    const items = await instance.client.search({ keyword: query, countPerPage: pickFirst ? 1 : 10 });
+    if (items.length === 0) {
+        throw new Error(`juso-resolve-address: no match for '${query}'. 도로명/지번 표기가 정확한지 확인.`);
+    }
+    if (!pickFirst && items.length > 1) {
+        throw new Error(`juso-resolve-address: '${query}' 매칭 ${items.length}건. pickFirst=true 로 강제 선택 또는 query 더 구체적으로 입력.`);
+    }
+    const resolved = mapToResolvedAddress(items[0]);
+    logger?.info?.(`[juso] resolved → admCd=${resolved.admCd} pnu=${resolved.pnu.sigunguCd}-${resolved.pnu.bjdongCd}-${resolved.pnu.platGbCd}-${resolved.pnu.bun}-${resolved.pnu.ji}`);
+    return { data: resolved };
+}
+/**
+ * juso 단일 결과 → 표준 ResolvedAddress.
+ *
+ * 매핑 규칙:
+ *  - sigunguCd = admCd[0..4], bjdongCd = admCd[5..9]
+ *  - platGbCd = mtYn === '1' ? '1' : '0' (산 지번 여부)
+ *  - bun = lnbrMnnm, ji = lnbrSlno
+ *  - 좌표는 juso 응답에 없으므로 undefined
+ */
+function mapToResolvedAddress(item) {
+    const admCd = (item.admCd || '').padEnd(10, '0').slice(0, 10);
+    const sigunguCd = admCd.slice(0, 5);
+    const bjdongCd = admCd.slice(5, 10);
+    const platGbCd = item.mtYn === '1' ? '1' : '0';
+    const bun = String(item.lnbrMnnm ?? '').replace(/^0+/, '') || '0';
+    const ji = String(item.lnbrSlno ?? '').replace(/^0+/, '') || '0';
+    return {
+        address: {
+            road: item.roadAddrPart1 || item.roadAddr,
+            jibun: item.jibunAddr,
+            buildingName: item.bdNm || undefined,
+            siNm: item.siNm,
+            sggNm: item.sggNm,
+            emdNm: item.emdNm
+        },
+        pnu: { sigunguCd, bjdongCd, platGbCd, bun, ji },
+        admCd,
+        bdMgtSn: item.bdMgtSn,
+        rnMgtSn: item.rnMgtSn,
+        zipNo: item.zipNo,
+        raw: item
+    };
+}
+JusoResolveAddressTask.parameterSpec = [
+    { type: 'string', name: 'query', label: 'label.address-query', placeholder: '예) 서울특별시 강남구 테헤란로 223' },
+    {
+        type: 'select',
+        name: 'pickFirst',
+        label: 'label.pick-first',
+        property: {
+            options: [
+                { value: 'true', display: '첫 결과 자동 선택' },
+                { value: 'false', display: '다중 매칭 시 에러' }
+            ]
+        }
+    }
+];
+JusoResolveAddressTask.help = 'integration/task/juso-resolve-address';
+integration_base_1.TaskRegistry.registerTaskHandler('juso-resolve-address', JusoResolveAddressTask);
+exports.default = JusoResolveAddressTask;
+//# sourceMappingURL=resolve.js.map

package/dist-server/engine/task/address/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../../../server/engine/task/address/resolve.ts"],"names":[],"mappings":"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","sourcesContent":["import { ConnectionManager, Context, TaskRegistry, evaluateTemplate } from '@things-factory/integration-base'\n\nimport { JusoConnectionInstance } from '../../connector/juso-connector'\nimport { JusoItem, ResolvedAddress } from '../../types'\n\n/**\n * 도로명/지번 주소 → 표준 식별자 (PNU 5요소 + 법정동코드 + 우편번호) 변환 태스크.\n *\n * 다른 백엔드 (VWorld 등) 가 이 task 와 **같은 출력 형태(`ResolvedAddress`)** 를 반환하면\n * 소비자 시나리오는 백엔드 교체 시 매핑 변경이 필요 없도록 설계됨.\n *\n * 입력:\n *  - `query`        : 검색할 주소 문자열 (도로명 또는 지번 모두 가능)\n *  - `pickFirst`    : 다수 매칭 시 첫 결과 선택 (기본 true). false 면 결과가 둘 이상일 때 에러.\n *\n * 출력 (`data`):\n *  - `ResolvedAddress` (단건). 매칭 0건이면 에러.\n */\nasync function JusoResolveAddressTask(step, context: Context): Promise<{ data: ResolvedAddress }> {\n  const { connection: connectionName, params } = step\n  const { domain, user, data, variables, lng, logger } = context\n\n  const instance: JusoConnectionInstance = await ConnectionManager.getConnectionInstanceByName(\n    domain,\n    connectionName\n  )\n  if (!instance?.client) {\n    throw new Error(`juso 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(`juso-resolve-address: failed to evaluate parameter: ${(err as Error).message}`)\n    }\n  }\n\n  const query = evalString(params.query)\n  if (!query) {\n    throw new Error('juso-resolve-address: query is required (address string).')\n  }\n\n  const pickFirst = params.pickFirst === undefined ? true : Boolean(params.pickFirst)\n\n  logger?.info?.(`[juso] search keyword='${query}'`)\n\n  const items = await instance.client.search({ keyword: query, countPerPage: pickFirst ? 1 : 10 })\n\n  if (items.length === 0) {\n    throw new Error(`juso-resolve-address: no match for '${query}'. 도로명/지번 표기가 정확한지 확인.`)\n  }\n  if (!pickFirst && items.length > 1) {\n    throw new Error(\n      `juso-resolve-address: '${query}' 매칭 ${items.length}건. pickFirst=true 로 강제 선택 또는 query 더 구체적으로 입력.`\n    )\n  }\n\n  const resolved = mapToResolvedAddress(items[0])\n\n  logger?.info?.(\n    `[juso] resolved → admCd=${resolved.admCd} pnu=${resolved.pnu.sigunguCd}-${resolved.pnu.bjdongCd}-${resolved.pnu.platGbCd}-${resolved.pnu.bun}-${resolved.pnu.ji}`\n  )\n\n  return { data: resolved }\n}\n\n/**\n * juso 단일 결과 → 표준 ResolvedAddress.\n *\n * 매핑 규칙:\n *  - sigunguCd = admCd[0..4], bjdongCd = admCd[5..9]\n *  - platGbCd = mtYn === '1' ? '1' : '0' (산 지번 여부)\n *  - bun = lnbrMnnm, ji = lnbrSlno\n *  - 좌표는 juso 응답에 없으므로 undefined\n */\nexport function mapToResolvedAddress(item: JusoItem): ResolvedAddress {\n  const admCd = (item.admCd || '').padEnd(10, '0').slice(0, 10)\n  const sigunguCd = admCd.slice(0, 5)\n  const bjdongCd = admCd.slice(5, 10)\n  const platGbCd = item.mtYn === '1' ? '1' : '0'\n  const bun = String(item.lnbrMnnm ?? '').replace(/^0+/, '') || '0'\n  const ji = String(item.lnbrSlno ?? '').replace(/^0+/, '') || '0'\n\n  return {\n    address: {\n      road: item.roadAddrPart1 || item.roadAddr,\n      jibun: item.jibunAddr,\n      buildingName: item.bdNm || undefined,\n      siNm: item.siNm,\n      sggNm: item.sggNm,\n      emdNm: item.emdNm\n    },\n    pnu: { sigunguCd, bjdongCd, platGbCd, bun, ji },\n    admCd,\n    bdMgtSn: item.bdMgtSn,\n    rnMgtSn: item.rnMgtSn,\n    zipNo: item.zipNo,\n    raw: item\n  }\n}\n\nJusoResolveAddressTask.parameterSpec = [\n  { type: 'string', name: 'query', label: 'label.address-query', placeholder: '예) 서울특별시 강남구 테헤란로 223' },\n  {\n    type: 'select',\n    name: 'pickFirst',\n    label: 'label.pick-first',\n    property: {\n      options: [\n        { value: 'true', display: '첫 결과 자동 선택' },\n        { value: 'false', display: '다중 매칭 시 에러' }\n      ]\n    }\n  }\n]\n\nJusoResolveAddressTask.help = 'integration/task/juso-resolve-address'\n\nTaskRegistry.registerTaskHandler('juso-resolve-address', JusoResolveAddressTask)\n\nexport default JusoResolveAddressTask\n"]}

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

@@ -0,0 +1,6 @@
+/**
+ * juso 도메인 태스크 배럴.
+ *
+ * 새 도메인 추가 시: 폴더 + 본 index 의 import 한 줄.
+ */
+import './address';

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

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * juso 도메인 태스크 배럴.
+ *
+ * 새 도메인 추가 시: 폴더 + 본 index 의 import 한 줄.
+ */
+require("./address");
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/engine/task/index.ts"],"names":[],"mappings":";;AAAA;;;;GAIG;AACH,qBAAkB","sourcesContent":["/**\n * juso 도메인 태스크 배럴.\n *\n * 새 도메인 추가 시: 폴더 + 본 index 의 import 한 줄.\n */\nimport './address'\n"]}

package/dist-server/engine/types.d.ts

@@ -0,0 +1,86 @@
+/**
+ * juso.go.kr (도로명주소 안내시스템) Open API 응답 타입.
+ *
+ * 본 패키지는 행정안전부 도로명주소조회 API 의 결과를 받아 우리 표준 결과 형태로
+ * 매핑한다. 다른 주소 resolver (예: VWorld) 와 호환되는 통일된 출력 형태를 사용해
+ * 소비자가 백엔드를 바꿔 끼울 수 있도록 한다.
+ */
+/** juso.go.kr 도로명주소 단일 항목 (응답의 results.juso 배열 원소). */
+export interface JusoItem {
+    roadAddr: string;
+    roadAddrPart1: string;
+    roadAddrPart2?: string;
+    jibunAddr: string;
+    engAddr?: string;
+    zipNo?: string;
+    admCd: string;
+    rnMgtSn?: string;
+    bdMgtSn?: string;
+    bdNm?: string;
+    bdKdcd?: string;
+    siNm?: string;
+    sggNm?: string;
+    emdNm?: string;
+    liNm?: string;
+    rn?: string;
+    udrtYn?: string;
+    buldMnnm?: string;
+    buldSlno?: string;
+    mtYn?: string;
+    lnbrMnnm: string;
+    lnbrSlno: string;
+    emdNo?: string;
+    [key: string]: any;
+}
+/** juso.go.kr 응답 봉투. */
+export interface JusoResponse {
+    results: {
+        common: {
+            errorMessage: string;
+            countPerPage: string;
+            totalCount: string;
+            errorCode: string;
+            currentPage: string;
+        };
+        juso: JusoItem[] | null;
+    };
+}
+/**
+ * 주소 resolver 의 통일 출력 형태.
+ *
+ * 다른 백엔드 (juso, VWorld 등) 가 동일 형태로 반환해 소비자가 자유롭게 교체 가능.
+ * coord 는 백엔드에 따라 누락 가능 (juso 는 별도 변환 없이는 WGS84 좌표를 못 줌).
+ */
+export interface ResolvedAddress {
+    address: {
+        road?: string;
+        jibun?: string;
+        buildingName?: string;
+        siNm?: string;
+        sggNm?: string;
+        emdNm?: string;
+    };
+    /** 건축물대장 등 부동산 API 호출용 PNU 5요소. */
+    pnu: {
+        sigunguCd: string;
+        bjdongCd: string;
+        platGbCd: string;
+        bun: string;
+        ji: string;
+    };
+    /** 법정동코드 10자리. */
+    admCd: string;
+    /** 건물관리번호 25자리. */
+    bdMgtSn?: string;
+    /** 도로명관리번호. */
+    rnMgtSn?: string;
+    /** 우편번호 5자리. */
+    zipNo?: string;
+    /** WGS84 위경도 (백엔드가 줄 때만). */
+    coord?: {
+        latitude: number;
+        longitude: number;
+    };
+    /** 백엔드 원본 응답 (디버깅·확장용). */
+    raw?: unknown;
+}

package/dist-server/engine/types.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * juso.go.kr (도로명주소 안내시스템) Open API 응답 타입.
+ *
+ * 본 패키지는 행정안전부 도로명주소조회 API 의 결과를 받아 우리 표준 결과 형태로
+ * 매핑한다. 다른 주소 resolver (예: VWorld) 와 호환되는 통일된 출력 형태를 사용해
+ * 소비자가 백엔드를 바꿔 끼울 수 있도록 한다.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist-server/engine/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../server/engine/types.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG","sourcesContent":["/**\n * juso.go.kr (도로명주소 안내시스템) Open API 응답 타입.\n *\n * 본 패키지는 행정안전부 도로명주소조회 API 의 결과를 받아 우리 표준 결과 형태로\n * 매핑한다. 다른 주소 resolver (예: VWorld) 와 호환되는 통일된 출력 형태를 사용해\n * 소비자가 백엔드를 바꿔 끼울 수 있도록 한다.\n */\n\n/** juso.go.kr 도로명주소 단일 항목 (응답의 results.juso 배열 원소). */\nexport interface JusoItem {\n  roadAddr: string\n  roadAddrPart1: string\n  roadAddrPart2?: string\n  jibunAddr: string\n  engAddr?: string\n  zipNo?: string\n  admCd: string /* 법정동코드 10자리 = sigunguCd 5 + bjdongCd 5 */\n  rnMgtSn?: string\n  bdMgtSn?: string /* 건물관리번호 25자리 (PNU 정보 인코딩됨) */\n  bdNm?: string /* 건물명 */\n  bdKdcd?: string\n  siNm?: string\n  sggNm?: string\n  emdNm?: string\n  liNm?: string\n  rn?: string\n  udrtYn?: string\n  buldMnnm?: string /* 도로명 건물 본번 */\n  buldSlno?: string\n  mtYn?: string /* 산 여부 ('1' 산, '0' 일반) */\n  lnbrMnnm: string /* 지번 본번 */\n  lnbrSlno: string /* 지번 부번 */\n  emdNo?: string\n  [key: string]: any\n}\n\n/** juso.go.kr 응답 봉투. */\nexport interface JusoResponse {\n  results: {\n    common: {\n      errorMessage: string\n      countPerPage: string\n      totalCount: string\n      errorCode: string\n      currentPage: string\n    }\n    juso: JusoItem[] | null\n  }\n}\n\n/**\n * 주소 resolver 의 통일 출력 형태.\n *\n * 다른 백엔드 (juso, VWorld 등) 가 동일 형태로 반환해 소비자가 자유롭게 교체 가능.\n * coord 는 백엔드에 따라 누락 가능 (juso 는 별도 변환 없이는 WGS84 좌표를 못 줌).\n */\nexport interface ResolvedAddress {\n  address: {\n    road?: string\n    jibun?: string\n    buildingName?: string\n    siNm?: string\n    sggNm?: string\n    emdNm?: string\n  }\n  /** 건축물대장 등 부동산 API 호출용 PNU 5요소. */\n  pnu: {\n    sigunguCd: string\n    bjdongCd: string\n    platGbCd: string\n    bun: string\n    ji: string\n  }\n  /** 법정동코드 10자리. */\n  admCd: string\n  /** 건물관리번호 25자리. */\n  bdMgtSn?: string\n  /** 도로명관리번호. */\n  rnMgtSn?: string\n  /** 우편번호 5자리. */\n  zipNo?: string\n  /** WGS84 위경도 (백엔드가 줄 때만). */\n  coord?: { latitude: number; longitude: number }\n  /** 백엔드 원본 응답 (디버깅·확장용). */\n  raw?: unknown\n}\n"]}

package/dist-server/index.d.ts

@@ -0,0 +1,4 @@
+import './engine';
+export * from './engine/types';
+export { JusoClient } from './engine/connector/juso-client';
+export { mapToResolvedAddress } from './engine/task/address/resolve';

package/dist-server/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapToResolvedAddress = exports.JusoClient = void 0;
+const tslib_1 = require("tslib");
+require("./engine");
+tslib_1.__exportStar(require("./engine/types"), exports);
+var juso_client_1 = require("./engine/connector/juso-client");
+Object.defineProperty(exports, "JusoClient", { enumerable: true, get: function () { return juso_client_1.JusoClient; } });
+var resolve_1 = require("./engine/task/address/resolve");
+Object.defineProperty(exports, "mapToResolvedAddress", { enumerable: true, get: function () { return resolve_1.mapToResolvedAddress; } });
+//# sourceMappingURL=index.js.map

package/dist-server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../server/index.ts"],"names":[],"mappings":";;;;AAAA,oBAAiB;AAEjB,yDAA8B;AAC9B,8DAA2D;AAAlD,yGAAA,UAAU,OAAA;AACnB,yDAAoE;AAA3D,+GAAA,oBAAoB,OAAA","sourcesContent":["import './engine'\n\nexport * from './engine/types'\nexport { JusoClient } from './engine/connector/juso-client'\nexport { mapToResolvedAddress } from './engine/task/address/resolve'\n"]}