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

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

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const integration_base_1 = require("@things-factory/integration-base");
+const spec_1 = require("../spec");
+/**
+ * 범용 공공데이터포털 호출 태스크.
+ *
+ * 하나의 태스크가 등록된 레지스트리의 **모든 오퍼레이션** 을 커버한다. TaskRegistry 가
+ * 수백 개 태스크로 폭발하는 것을 방지하는 핵심 설계.
+ *
+ * 입력:
+ *  - `operationRef` : `"<serviceId>.<operationId>"` 형식 (예: `"1613000/BldRgstService_v2.getBrTitleInfo"`)
+ *  - `params`       : 오퍼레이션 파라미터 객체. 스펙 등록된 오퍼레이션이면 자동 검증·기본값·zero-pad 적용
+ *
+ * 레지스트리에 없는 오퍼레이션도 호출 가능 (스펙 없음 → 검증 스킵). 새 data.go.kr 서비스가
+ * 등장해도 스펙 추가 전까지 범용 호출로 즉시 사용 가능하다는 장점.
+ */
+async function DataGoKrCall(step, context) {
+    const { connection: connectionName, params: stepParams } = 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 operationRef = stepParams?.operationRef;
+    if (!operationRef || typeof operationRef !== 'string') {
+        throw new Error('data-go-kr-call: operationRef is required (format: "<serviceId>.<operationId>")');
+    }
+    const resolved = spec_1.SpecRegistry.resolve(operationRef);
+    const rawParams = stepParams?.params || {};
+    const scope = { domain, user, lng, data, variables, console };
+    const evalValue = (value) => {
+        if (value === undefined || value === null)
+            return value;
+        if (typeof value !== 'string')
+            return value;
+        try {
+            return (0, integration_base_1.evaluateTemplate)(value, scope);
+        }
+        catch (err) {
+            throw new Error(`data-go-kr-call: failed to evaluate parameter: ${err.message}`);
+        }
+    };
+    const evaluatedParams = {};
+    for (const [k, v] of Object.entries(rawParams)) {
+        evaluatedParams[k] = evalValue(v);
+    }
+    const { service, operation } = resolved || { service: null, operation: null };
+    const finalParams = operation
+        ? normalizeAndValidateParams(operation, evaluatedParams)
+        : evaluatedParams;
+    const servicePath = resolved
+        ? `${service.serviceId}/${operation.operationId}`
+        : operationRef.replace('.', '/');
+    logger?.info?.(`[data-go-kr] call ${servicePath} params=${JSON.stringify(finalParams)}`);
+    const response = await instance.client.get(servicePath, finalParams);
+    return { data: response };
+}
+/**
+ * 스펙 기반 파라미터 정규화·검증.
+ *
+ *  1. required 필수값 체크
+ *  2. default 기본값 주입
+ *  3. pad zero-padding (예: bun=6 → "0006")
+ *  4. length 정확 길이 검증
+ *  5. enum 허용 값 검증
+ */
+function normalizeAndValidateParams(operation, input) {
+    const output = {};
+    const errors = [];
+    for (const p of operation.params) {
+        let value = input[p.name];
+        if (value === undefined || value === null || value === '') {
+            if (p.default !== undefined) {
+                value = p.default;
+            }
+            else if (p.required) {
+                errors.push(`'${p.name}' is required (${p.description})`);
+                continue;
+            }
+            else {
+                continue;
+            }
+        }
+        value = String(value);
+        if (p.pad && value.length < p.pad) {
+            value = '0'.repeat(p.pad - value.length) + value;
+        }
+        if (p.length !== undefined && value.length !== p.length) {
+            errors.push(`'${p.name}' must be exactly ${p.length} characters (got "${value}", length ${value.length})`);
+            continue;
+        }
+        if (p.enum && !p.enum.some(e => e.value === value)) {
+            errors.push(`'${p.name}' must be one of [${p.enum.map(e => e.value).join(', ')}] (got "${value}")`);
+            continue;
+        }
+        output[p.name] = value;
+    }
+    /* 스펙에 없는 파라미터도 pass-through (미등록 필드 허용) */
+    for (const [k, v] of Object.entries(input)) {
+        if (!(k in output) && !operation.params.find(p => p.name === k)) {
+            if (v !== undefined && v !== null && v !== '') {
+                output[k] = v;
+            }
+        }
+    }
+    if (errors.length > 0) {
+        throw new Error(`data-go-kr-call parameter validation failed for ${operation.operationId}:\n  - ${errors.join('\n  - ')}`);
+    }
+    return output;
+}
+DataGoKrCall.parameterSpec = [
+    {
+        type: 'string',
+        name: 'operationRef',
+        label: 'label.operation-ref',
+        placeholder: '<serviceId>.<operationId> (예: 1613000/BldRgstService_v2.getBrTitleInfo)'
+    },
+    {
+        type: 'scenario-step-input',
+        name: 'params',
+        label: 'label.operation-params'
+    }
+];
+DataGoKrCall.help = 'integration/task/data-go-kr-call';
+integration_base_1.TaskRegistry.registerTaskHandler('data-go-kr-call', DataGoKrCall);
+exports.default = DataGoKrCall;
+//# sourceMappingURL=call.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"call.js","sourceRoot":"","sources":["../../../server/engine/task/call.ts"],"names":[],"mappings":";;AAAA,uEAA6G;AAI7G,kCAAqD;AAErD;;;;;;;;;;;;GAYG;AACH,KAAK,UAAU,YAAY,CAAC,IAAI,EAAE,OAAgB;IAChD,MAAM,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAAA;IAC/D,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAA;IAE9D,MAAM,QAAQ,GAA+B,MAAM,oCAAiB,CAAC,2BAA2B,CAC9F,MAAM,EACN,cAAc,CACf,CAAA;IACD,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,0BAA0B,cAAc,uBAAuB,CAAC,CAAA;IAClF,CAAC;IAED,MAAM,YAAY,GAAG,UAAU,EAAE,YAAY,CAAA;IAC7C,IAAI,CAAC,YAAY,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,iFAAiF,CAAC,CAAA;IACpG,CAAC;IAED,MAAM,QAAQ,GAAG,mBAAY,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA;IACnD,MAAM,SAAS,GAAG,UAAU,EAAE,MAAM,IAAI,EAAE,CAAA;IAE1C,MAAM,KAAK,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAA;IAC7D,MAAM,SAAS,GAAG,CAAC,KAAU,EAAE,EAAE;QAC/B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,KAAK,CAAA;QACvD,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAA;QAC3C,IAAI,CAAC;YACH,OAAO,IAAA,mCAAgB,EAAC,KAAK,EAAE,KAAK,CAAC,CAAA;QACvC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,kDAAmD,GAAa,CAAC,OAAO,EAAE,CAAC,CAAA;QAC7F,CAAC;IACH,CAAC,CAAA;IAED,MAAM,eAAe,GAAwB,EAAE,CAAA;IAC/C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/C,eAAe,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAA;IACnC,CAAC;IAED,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,QAAQ,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAA;IAC7E,MAAM,WAAW,GAAG,SAAS;QAC3B,CAAC,CAAC,0BAA0B,CAAC,SAAS,EAAE,eAAe,CAAC;QACxD,CAAC,CAAC,eAAe,CAAA;IAEnB,MAAM,WAAW,GAAG,QAAQ;QAC1B,CAAC,CAAC,GAAG,OAAQ,CAAC,SAAS,IAAI,SAAU,CAAC,WAAW,EAAE;QACnD,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;IAElC,MAAM,EAAE,IAAI,EAAE,CAAC,qBAAqB,WAAW,WAAW,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;IAExF,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,WAAW,CAAC,CAAA;IACpE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;AAC3B,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,0BAA0B,CAAC,SAAwB,EAAE,KAA0B;IACtF,MAAM,MAAM,GAAwB,EAAE,CAAA;IACtC,MAAM,MAAM,GAAa,EAAE,CAAA;IAE3B,KAAK,MAAM,CAAC,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;QACjC,IAAI,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QAEzB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YAC1D,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC5B,KAAK,GAAG,CAAC,CAAC,OAAO,CAAA;YACnB,CAAC;iBAAM,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;gBACtB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,kBAAkB,CAAC,CAAC,WAAW,GAAG,CAAC,CAAA;gBACzD,SAAQ;YACV,CAAC;iBAAM,CAAC;gBACN,SAAQ;YACV,CAAC;QACH,CAAC;QAED,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;QAErB,IAAI,CAAC,CAAC,GAAG,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;YAClC,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,CAAA;QAClD,CAAC;QAED,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;YACxD,MAAM,CAAC,IAAI,CACT,IAAI,CAAC,CAAC,IAAI,qBAAqB,CAAC,CAAC,MAAM,qBAAqB,KAAK,aAAa,KAAK,CAAC,MAAM,GAAG,CAC9F,CAAA;YACD,SAAQ;QACV,CAAC;QAED,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,EAAE,CAAC;YACnD,MAAM,CAAC,IAAI,CACT,IAAI,CAAC,CAAC,IAAI,qBAAqB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,KAAK,IAAI,CACvF,CAAA;YACD,SAAQ;QACV,CAAC;QAED,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,KAAK,CAAA;IACxB,CAAC;IAED,2CAA2C;IAC3C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3C,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC;YAChE,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;gBAC9C,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;YACf,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,mDAAmD,SAAS,CAAC,WAAW,UAAU,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAC1G,CAAA;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED,YAAY,CAAC,aAAa,GAAG;IAC3B;QACE,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE,yEAAyE;KACvF;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,wBAAwB;KAChC;CACF,CAAA;AAED,YAAY,CAAC,IAAI,GAAG,kCAAkC,CAAA;AAEtD,+BAAY,CAAC,mBAAmB,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAA;AAEjE,kBAAe,YAAY,CAAA","sourcesContent":["import { ConnectionManager, Context, TaskRegistry, evaluateTemplate } from '@things-factory/integration-base'\n\nimport { DataGoKrConnectionInstance } from '../connector/data-go-kr-connector'\nimport { DataGoKrResponse } from '../types'\nimport { OperationSpec, SpecRegistry } from '../spec'\n\n/**\n * 범용 공공데이터포털 호출 태스크.\n *\n * 하나의 태스크가 등록된 레지스트리의 **모든 오퍼레이션** 을 커버한다. TaskRegistry 가\n * 수백 개 태스크로 폭발하는 것을 방지하는 핵심 설계.\n *\n * 입력:\n *  - `operationRef` : `\"<serviceId>.<operationId>\"` 형식 (예: `\"1613000/BldRgstService_v2.getBrTitleInfo\"`)\n *  - `params`       : 오퍼레이션 파라미터 객체. 스펙 등록된 오퍼레이션이면 자동 검증·기본값·zero-pad 적용\n *\n * 레지스트리에 없는 오퍼레이션도 호출 가능 (스펙 없음 → 검증 스킵). 새 data.go.kr 서비스가\n * 등장해도 스펙 추가 전까지 범용 호출로 즉시 사용 가능하다는 장점.\n */\nasync function DataGoKrCall(step, context: Context): Promise<{ data: DataGoKrResponse<any> }> {\n  const { connection: connectionName, params: stepParams } = 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 operationRef = stepParams?.operationRef\n  if (!operationRef || typeof operationRef !== 'string') {\n    throw new Error('data-go-kr-call: operationRef is required (format: \"<serviceId>.<operationId>\")')\n  }\n\n  const resolved = SpecRegistry.resolve(operationRef)\n  const rawParams = stepParams?.params || {}\n\n  const scope = { domain, user, lng, data, variables, console }\n  const evalValue = (value: any) => {\n    if (value === undefined || value === null) return value\n    if (typeof value !== 'string') return value\n    try {\n      return evaluateTemplate(value, scope)\n    } catch (err) {\n      throw new Error(`data-go-kr-call: failed to evaluate parameter: ${(err as Error).message}`)\n    }\n  }\n\n  const evaluatedParams: Record<string, any> = {}\n  for (const [k, v] of Object.entries(rawParams)) {\n    evaluatedParams[k] = evalValue(v)\n  }\n\n  const { service, operation } = resolved || { service: null, operation: null }\n  const finalParams = operation\n    ? normalizeAndValidateParams(operation, evaluatedParams)\n    : evaluatedParams\n\n  const servicePath = resolved\n    ? `${service!.serviceId}/${operation!.operationId}`\n    : operationRef.replace('.', '/')\n\n  logger?.info?.(`[data-go-kr] call ${servicePath} params=${JSON.stringify(finalParams)}`)\n\n  const response = await instance.client.get(servicePath, finalParams)\n  return { data: response }\n}\n\n/**\n * 스펙 기반 파라미터 정규화·검증.\n *\n *  1. required 필수값 체크\n *  2. default 기본값 주입\n *  3. pad zero-padding (예: bun=6 → \"0006\")\n *  4. length 정확 길이 검증\n *  5. enum 허용 값 검증\n */\nfunction normalizeAndValidateParams(operation: OperationSpec, input: Record<string, any>): Record<string, any> {\n  const output: Record<string, any> = {}\n  const errors: string[] = []\n\n  for (const p of operation.params) {\n    let value = input[p.name]\n\n    if (value === undefined || value === null || value === '') {\n      if (p.default !== undefined) {\n        value = p.default\n      } else if (p.required) {\n        errors.push(`'${p.name}' is required (${p.description})`)\n        continue\n      } else {\n        continue\n      }\n    }\n\n    value = String(value)\n\n    if (p.pad && value.length < p.pad) {\n      value = '0'.repeat(p.pad - value.length) + value\n    }\n\n    if (p.length !== undefined && value.length !== p.length) {\n      errors.push(\n        `'${p.name}' must be exactly ${p.length} characters (got \"${value}\", length ${value.length})`\n      )\n      continue\n    }\n\n    if (p.enum && !p.enum.some(e => e.value === value)) {\n      errors.push(\n        `'${p.name}' must be one of [${p.enum.map(e => e.value).join(', ')}] (got \"${value}\")`\n      )\n      continue\n    }\n\n    output[p.name] = value\n  }\n\n  /* 스펙에 없는 파라미터도 pass-through (미등록 필드 허용) */\n  for (const [k, v] of Object.entries(input)) {\n    if (!(k in output) && !operation.params.find(p => p.name === k)) {\n      if (v !== undefined && v !== null && v !== '') {\n        output[k] = v\n      }\n    }\n  }\n\n  if (errors.length > 0) {\n    throw new Error(\n      `data-go-kr-call parameter validation failed for ${operation.operationId}:\\n  - ${errors.join('\\n  - ')}`\n    )\n  }\n\n  return output\n}\n\nDataGoKrCall.parameterSpec = [\n  {\n    type: 'string',\n    name: 'operationRef',\n    label: 'label.operation-ref',\n    placeholder: '<serviceId>.<operationId> (예: 1613000/BldRgstService_v2.getBrTitleInfo)'\n  },\n  {\n    type: 'scenario-step-input',\n    name: 'params',\n    label: 'label.operation-params'\n  }\n]\n\nDataGoKrCall.help = 'integration/task/data-go-kr-call'\n\nTaskRegistry.registerTaskHandler('data-go-kr-call', DataGoKrCall)\n\nexport default DataGoKrCall\n"]}

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

@@ -0,0 +1,19 @@
+/**
+ * 태스크 배럴.
+ *
+ * 구성 규약:
+ *  - 범용 태스크 (여러 서비스에 공통 적용) 는 이 폴더 **최상단** 에 파일로 배치
+ *    예) call.ts → data-go-kr-call
+ *
+ *  - 특정 도메인/서비스의 전용 태스크는 **도메인 이름 폴더** 아래 배치
+ *    예) building-ledger/ , (향후) property-trade/ , address/ ...
+ *
+ * 새 서비스 지원 우선순위:
+ *  1) 먼저 SpecRegistry 에 서비스 스펙을 등록 → `data-go-kr-call` 로 즉시 호출 가능
+ *  2) 그래도 불충분한 경우(입력 폼 필요, 응답 구조가 비표준, 도메인 가공 필수 등)만
+ *     도메인 폴더를 새로 만들고 전용 태스크 작성
+ *
+ * 즉 이 폴더에 새 파일/폴더가 추가되는 것은 "공통 경로로 풀 수 없는 예외" 뿐이다.
+ */
+import './call';
+import './building-ledger';

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

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * 태스크 배럴.
+ *
+ * 구성 규약:
+ *  - 범용 태스크 (여러 서비스에 공통 적용) 는 이 폴더 **최상단** 에 파일로 배치
+ *    예) call.ts → data-go-kr-call
+ *
+ *  - 특정 도메인/서비스의 전용 태스크는 **도메인 이름 폴더** 아래 배치
+ *    예) building-ledger/ , (향후) property-trade/ , address/ ...
+ *
+ * 새 서비스 지원 우선순위:
+ *  1) 먼저 SpecRegistry 에 서비스 스펙을 등록 → `data-go-kr-call` 로 즉시 호출 가능
+ *  2) 그래도 불충분한 경우(입력 폼 필요, 응답 구조가 비표준, 도메인 가공 필수 등)만
+ *     도메인 폴더를 새로 만들고 전용 태스크 작성
+ *
+ * 즉 이 폴더에 새 파일/폴더가 추가되는 것은 "공통 경로로 풀 수 없는 예외" 뿐이다.
+ */
+require("./call");
+require("./building-ledger");
+//# 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;;;;;;;;;;;;;;;;GAgBG;AACH,kBAAe;AACf,6BAA0B","sourcesContent":["/**\n * 태스크 배럴.\n *\n * 구성 규약:\n *  - 범용 태스크 (여러 서비스에 공통 적용) 는 이 폴더 **최상단** 에 파일로 배치\n *    예) call.ts → data-go-kr-call\n *\n *  - 특정 도메인/서비스의 전용 태스크는 **도메인 이름 폴더** 아래 배치\n *    예) building-ledger/ , (향후) property-trade/ , address/ ...\n *\n * 새 서비스 지원 우선순위:\n *  1) 먼저 SpecRegistry 에 서비스 스펙을 등록 → `data-go-kr-call` 로 즉시 호출 가능\n *  2) 그래도 불충분한 경우(입력 폼 필요, 응답 구조가 비표준, 도메인 가공 필수 등)만\n *     도메인 폴더를 새로 만들고 전용 태스크 작성\n *\n * 즉 이 폴더에 새 파일/폴더가 추가되는 것은 \"공통 경로로 풀 수 없는 예외\" 뿐이다.\n */\nimport './call'\nimport './building-ledger'\n"]}

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

@@ -0,0 +1,63 @@
+/**
+ * 공공데이터포털(data.go.kr) 공용 응답 타입.
+ *
+ * 대부분의 data.go.kr 서비스가 동일한 봉투(envelope) 구조를 사용한다:
+ *   { response: { header: { resultCode, resultMsg }, body: { items: { item[] }, numOfRows, pageNo, totalCount } } }
+ */
+/** 공공데이터포털 공용 응답 봉투. */
+export interface DataGoKrResponse<T> {
+    response: {
+        header: {
+            resultCode: string;
+            resultMsg: string;
+        };
+        body: {
+            items?: {
+                item?: T | T[];
+            } | '';
+            numOfRows: number;
+            pageNo: number;
+            totalCount: number;
+        };
+    };
+}
+/**
+ * 건축물대장 서비스 표제부(`getBrTitleInfo`) 레코드.
+ *
+ * 총 30+ 필드이지만 도메인에서 자주 쓰는 필드만 명시하고 나머지는 인덱스 시그니처.
+ */
+export interface BrTitleItem {
+    mgmBldrgstPk: string;
+    platPlc?: string;
+    newPlatPlc?: string;
+    bldNm?: string;
+    dongNm?: string;
+    platArea?: string;
+    archArea?: string;
+    bcRat?: string;
+    totArea?: string;
+    vlRatEstmTotArea?: string;
+    vlRat?: string;
+    strctCd?: string;
+    strctCdNm?: string;
+    mainPurpsCd?: string;
+    mainPurpsCdNm?: string;
+    grndFlrCnt?: string;
+    ugrndFlrCnt?: string;
+    regstrKindCd?: string;
+    regstrGbCd?: string;
+    useAprDay?: string;
+    mainBldCnt?: string;
+    atchBldCnt?: string;
+    totPkngCnt?: string;
+    [key: string]: any;
+}
+/**
+ * 건축물대장 표제부(`getBrTitleInfo`) 조회 결과.
+ *
+ * 다동(多棟) 필지는 items 가 여러 건, 단동 필지는 1건.
+ * 집계·요약은 소비자 스텝(data-mapper / jsonata / 도메인 전용 태스크) 에서 수행한다.
+ */
+export interface BuildingLedgerResult {
+    items: BrTitleItem[];
+}

package/dist-server/engine/types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * 공공데이터포털(data.go.kr) 공용 응답 타입.
+ *
+ * 대부분의 data.go.kr 서비스가 동일한 봉투(envelope) 구조를 사용한다:
+ *   { response: { header: { resultCode, resultMsg }, body: { items: { item[] }, numOfRows, pageNo, totalCount } } }
+ */
+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;;;;;GAKG","sourcesContent":["/**\n * 공공데이터포털(data.go.kr) 공용 응답 타입.\n *\n * 대부분의 data.go.kr 서비스가 동일한 봉투(envelope) 구조를 사용한다:\n *   { response: { header: { resultCode, resultMsg }, body: { items: { item[] }, numOfRows, pageNo, totalCount } } }\n */\n\n/** 공공데이터포털 공용 응답 봉투. */\nexport interface DataGoKrResponse<T> {\n  response: {\n    header: {\n      resultCode: string /* '00' = 정상 */\n      resultMsg: string\n    }\n    body: {\n      items?: { item?: T | T[] } | ''\n      numOfRows: number\n      pageNo: number\n      totalCount: number\n    }\n  }\n}\n\n/**\n * 건축물대장 서비스 표제부(`getBrTitleInfo`) 레코드.\n *\n * 총 30+ 필드이지만 도메인에서 자주 쓰는 필드만 명시하고 나머지는 인덱스 시그니처.\n */\nexport interface BrTitleItem {\n  mgmBldrgstPk: string /* 관리건축물대장PK */\n  platPlc?: string /* 대지위치 */\n  newPlatPlc?: string /* 도로명대지위치 */\n  bldNm?: string /* 건물명 */\n  dongNm?: string /* 동명칭 */\n  platArea?: string /* 대지면적 */\n  archArea?: string /* 건축면적 */\n  bcRat?: string /* 건폐율(%) */\n  totArea?: string /* 연면적 ★ */\n  vlRatEstmTotArea?: string\n  vlRat?: string /* 용적률(%) ★ */\n  strctCd?: string\n  strctCdNm?: string\n  mainPurpsCd?: string\n  mainPurpsCdNm?: string\n  grndFlrCnt?: string /* 지상층수 ★ */\n  ugrndFlrCnt?: string /* 지하층수 ★ */\n  regstrKindCd?: string /* 2=일반 / 3=집합 */\n  regstrGbCd?: string\n  useAprDay?: string\n  mainBldCnt?: string\n  atchBldCnt?: string\n  totPkngCnt?: string\n  [key: string]: any\n}\n\n/**\n * 건축물대장 표제부(`getBrTitleInfo`) 조회 결과.\n *\n * 다동(多棟) 필지는 items 가 여러 건, 단동 필지는 1건.\n * 집계·요약은 소비자 스텝(data-mapper / jsonata / 도메인 전용 태스크) 에서 수행한다.\n */\nexport interface BuildingLedgerResult {\n  items: BrTitleItem[]\n}\n"]}

package/dist-server/index.d.ts

@@ -0,0 +1,4 @@
+import './engine';
+export * from './engine/types';
+export * from './engine/spec';
+export { DataGoKrClient } from './engine/connector/data-go-kr-client';

package/dist-server/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+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; } });
+//# 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,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"]}