@things-factory/integration-base 10.0.0-beta.10 → 10.0.0-beta.108

package/dist-server/controllers/scenario-controller.js

@@ -9,18 +9,20 @@ const auth_base_1 = require("@things-factory/auth-base");
 const cache_service_1 = require("@things-factory/cache-service");
 const scenario_engine_1 = require("../engine/scenario-engine");
 const scenario_1 = require("../service/scenario/scenario");
+const domain_inheritance_1 = require("../utils/domain-inheritance");
 const debug = require('debug')('things-factory:integration-base:controller:run-scenario');
 async function findScenario(scenarioName, domain) {
     var repository = (0, shell_1.getRepository)(scenario_1.Scenario);
-    var scenario = await repository.findOne({
-        where: { domain: { id: domain.id }, name: scenarioName },
-        relations: ['domain', 'steps', 'role', 'creator', 'updater']
-    });
-    if (!scenario && domain.parentId) {
+    // ancestor 도메인을 closest-first 로 순회하여 first hit 사용
+    const domainIds = await (0, domain_inheritance_1.getDomainIdsWithAncestors)(domain);
+    var scenario = null;
+    for (const did of domainIds) {
         scenario = await repository.findOne({
-            where: { domain: { id: domain.parentId }, name: scenarioName },
+            where: { domain: { id: did }, name: scenarioName },
             relations: ['domain', 'steps', 'role', 'creator', 'updater']
         });
+        if (scenario)
+            break;
     }
     return scenario;
 }

package/dist-server/controllers/scenario-controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"scenario-controller.js","sourceRoot":"","sources":["../../server/controllers/scenario-controller.ts"],"names":[],"mappings":"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","sourcesContent":["import { getRepository, Domain, GraphqlLocalClient } from '@things-factory/shell'\nimport { checkUserHasRole } from '@things-factory/auth-base'\nimport { cacheService } from '@things-factory/cache-service'\n\nimport { ScenarioEngine } from '../engine/scenario-engine'\nimport { Scenario } from '../service/scenario/scenario'\nimport {\n  ScenarioInstance,\n  ScenarioInstanceRunResult,\n  ScenarioInstanceStartResult\n} from '../service/scenario-instance/scenario-instance-type'\nimport { Step } from '../service/step/step-type'\n\nconst debug = require('debug')('things-factory:integration-base:controller:run-scenario')\n\nasync function findScenario(\n  scenarioName: string,\n  domain: Domain\n): Promise<{\n  id: string\n  ttl: number\n  name: string\n  steps: Step[]\n  domain: Domain\n}> {\n  var repository = getRepository(Scenario)\n\n  var scenario = await repository.findOne({\n    where: { domain: { id: domain.id }, name: scenarioName },\n    relations: ['domain', 'steps', 'role', 'creator', 'updater']\n  })\n\n  if (!scenario && domain.parentId) {\n    scenario = await repository.findOne({\n      where: { domain: { id: domain.parentId }, name: scenarioName },\n      relations: ['domain', 'steps', 'role', 'creator', 'updater']\n    })\n  }\n\n  return scenario as any\n}\n\nexport async function checkHasRole(scenario: Partial<Scenario>, context: ResolverContext): Promise<void> {\n  const { domain, user } = context.state\n  if (!(await checkUserHasRole(scenario.roleId, domain, user))) {\n    throw new Error(\n      context.t('error.scenario run unauthorized', {\n        scenario: scenario.name\n      })\n    )\n  }\n}\n\nexport async function runScenario(\n  instanceName: string,\n  scenarioName: string,\n  variables: any,\n  context: ResolverContext\n): Promise<ScenarioInstanceRunResult> {\n  const { domain, user, lng } = context.state\n\n  debug('runScenario', scenarioName, instanceName, variables)\n\n  var scenario = await findScenario(scenarioName, domain)\n\n  if (!scenario) {\n    throw new Error(\n      context.t('error.scenario not found', {\n        scenario: scenarioName\n      })\n    )\n  }\n\n  await checkHasRole(scenario, context)\n\n  if (scenario.ttl > 0) {\n    const cachedValue = await cacheService.getFromCache(scenario.id, { domain: domain.id, variables: variables || {} })\n    if (cachedValue) {\n      return cachedValue.value\n    }\n  }\n\n  /* 시나리오 인스턴스를 생성한다. */\n  instanceName = instanceName || scenarioName + '-' + String(Date.now())\n\n  try {\n    return await ScenarioEngine.run(instanceName, scenario, { domain, user, lng, variables })\n  } catch (err) {\n    console.error(err)\n\n    throw new Error(\n      context.t('error.scenario run error', {\n        scenario: scenarioName\n      })\n    )\n  }\n}\n\nexport async function startScenario(\n  instanceName: string,\n  scenarioName: string,\n  variables: any,\n  context: ResolverContext\n): Promise<ScenarioInstanceStartResult> {\n  const { domain, user, lng } = context.state\n\n  debug('startScenario', instanceName, scenarioName, variables)\n\n  var scenario = await findScenario(scenarioName, domain)\n\n  if (!scenario) {\n    throw new Error(\n      context.t('error.scenario not found', {\n        scenario: scenarioName\n      })\n    )\n  }\n\n  await checkHasRole(scenario, context)\n\n  instanceName = instanceName || scenarioName\n  return await ScenarioEngine.loadIteration(instanceName, scenario, { domain, user, lng, variables })\n}\n\nexport async function stopScenario(\n  instanceName: string,\n  context: ResolverContext\n): Promise<ScenarioInstance | undefined> {\n  const { domain, user, unsafeIP, prohibitedPrivileges } = context.state\n\n  debug('stopScenario', instanceName)\n\n  var scenarioInstance = ScenarioEngine.getScenarioInstance(domain, instanceName)\n\n  if (!scenarioInstance) {\n    debug('stopScenario', `ScenarioInstance(${instanceName}) Not Found.`)\n    throw new Error(\n      context.t('error.scenario instance not found', {\n        instance: instanceName\n      })\n    )\n  }\n\n  var scenario = await findScenario(scenarioInstance.scenarioName, domain)\n\n  await checkHasRole(scenario, context)\n\n  await ScenarioEngine.unload(domain, instanceName)\n\n  return scenarioInstance\n}\n"]}
+{"version":3,"file":"scenario-controller.js","sourceRoot":"","sources":["../../server/controllers/scenario-controller.ts"],"names":[],"mappings":"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","sourcesContent":["import { getRepository, Domain, GraphqlLocalClient } from '@things-factory/shell'\nimport { checkUserHasRole } from '@things-factory/auth-base'\nimport { cacheService } from '@things-factory/cache-service'\n\nimport { ScenarioEngine } from '../engine/scenario-engine'\nimport { Scenario } from '../service/scenario/scenario'\nimport { getDomainIdsWithAncestors } from '../utils/domain-inheritance'\nimport {\n  ScenarioInstance,\n  ScenarioInstanceRunResult,\n  ScenarioInstanceStartResult\n} from '../service/scenario-instance/scenario-instance-type'\nimport { Step } from '../service/step/step-type'\n\nconst debug = require('debug')('things-factory:integration-base:controller:run-scenario')\n\nasync function findScenario(\n  scenarioName: string,\n  domain: Domain\n): Promise<{\n  id: string\n  ttl: number\n  name: string\n  steps: Step[]\n  domain: Domain\n}> {\n  var repository = getRepository(Scenario)\n\n  // ancestor 도메인을 closest-first 로 순회하여 first hit 사용\n  const domainIds = await getDomainIdsWithAncestors(domain)\n  var scenario: Scenario | null = null\n  for (const did of domainIds) {\n    scenario = await repository.findOne({\n      where: { domain: { id: did }, name: scenarioName },\n      relations: ['domain', 'steps', 'role', 'creator', 'updater']\n    })\n    if (scenario) break\n  }\n\n  return scenario as any\n}\n\nexport async function checkHasRole(scenario: Partial<Scenario>, context: ResolverContext): Promise<void> {\n  const { domain, user } = context.state\n  if (!(await checkUserHasRole(scenario.roleId, domain, user))) {\n    throw new Error(\n      context.t('error.scenario run unauthorized', {\n        scenario: scenario.name\n      })\n    )\n  }\n}\n\nexport async function runScenario(\n  instanceName: string,\n  scenarioName: string,\n  variables: any,\n  context: ResolverContext\n): Promise<ScenarioInstanceRunResult> {\n  const { domain, user, lng } = context.state\n\n  debug('runScenario', scenarioName, instanceName, variables)\n\n  var scenario = await findScenario(scenarioName, domain)\n\n  if (!scenario) {\n    throw new Error(\n      context.t('error.scenario not found', {\n        scenario: scenarioName\n      })\n    )\n  }\n\n  await checkHasRole(scenario, context)\n\n  if (scenario.ttl > 0) {\n    const cachedValue = await cacheService.getFromCache(scenario.id, { domain: domain.id, variables: variables || {} })\n    if (cachedValue) {\n      return cachedValue.value\n    }\n  }\n\n  /* 시나리오 인스턴스를 생성한다. */\n  instanceName = instanceName || scenarioName + '-' + String(Date.now())\n\n  try {\n    return await ScenarioEngine.run(instanceName, scenario, { domain, user, lng, variables })\n  } catch (err) {\n    console.error(err)\n\n    throw new Error(\n      context.t('error.scenario run error', {\n        scenario: scenarioName\n      })\n    )\n  }\n}\n\nexport async function startScenario(\n  instanceName: string,\n  scenarioName: string,\n  variables: any,\n  context: ResolverContext\n): Promise<ScenarioInstanceStartResult> {\n  const { domain, user, lng } = context.state\n\n  debug('startScenario', instanceName, scenarioName, variables)\n\n  var scenario = await findScenario(scenarioName, domain)\n\n  if (!scenario) {\n    throw new Error(\n      context.t('error.scenario not found', {\n        scenario: scenarioName\n      })\n    )\n  }\n\n  await checkHasRole(scenario, context)\n\n  instanceName = instanceName || scenarioName\n  return await ScenarioEngine.loadIteration(instanceName, scenario, { domain, user, lng, variables })\n}\n\nexport async function stopScenario(\n  instanceName: string,\n  context: ResolverContext\n): Promise<ScenarioInstance | undefined> {\n  const { domain, user, unsafeIP, prohibitedPrivileges } = context.state\n\n  debug('stopScenario', instanceName)\n\n  var scenarioInstance = ScenarioEngine.getScenarioInstance(domain, instanceName)\n\n  if (!scenarioInstance) {\n    debug('stopScenario', `ScenarioInstance(${instanceName}) Not Found.`)\n    throw new Error(\n      context.t('error.scenario instance not found', {\n        instance: instanceName\n      })\n    )\n  }\n\n  var scenario = await findScenario(scenarioInstance.scenarioName, domain)\n\n  await checkHasRole(scenario, context)\n\n  await ScenarioEngine.unload(domain, instanceName)\n\n  return scenarioInstance\n}\n"]}

package/dist-server/engine/connection-manager.d.ts

@@ -5,6 +5,12 @@ export declare class ConnectionManager {
     private static connectors;
     private static connections;
     private static entities;
+    /**
+     * Session 직렬화 mutex — connection name 단위 (도메인 무관 글로벌).
+     * sessionExclusive connector 의 acquireSessionPage 동시 호출이 외부 세션을 서로
+     * invalidate 하지 않도록 큐잉. release 호출 시 다음 대기자가 진행.
+     */
+    private static sessionLocks;
     private static logFormat;
     static logger: import("winston").Logger;
     static ready(): Promise<void>;
@@ -21,6 +27,19 @@ export declare class ConnectionManager {
     };
     static getEntities(): {};
     static getConnectionInstance(connection: Connection): any;
+    /**
+     * 세션 사용 패턴 (RAII).
+     *
+     * connector 가 sessionExclusive=true 로 선언한 경우 connection.name 단위 mutex 로
+     * 직렬화. 호출자는 acquireSessionPage / releasePage 의 lifecycle 을 신경 쓸 필요 없이
+     * `withSession(connection, async page => { ... })` 형태로 사용하면 됨.
+     *
+     * stateless connector (sessionExclusive=false) 는 mutex 없이 즉시 진행.
+     *
+     * @param connection 도메인 instance (connection.type 에서 connector 조회)
+     * @param fn         page 를 받아 데이터 작업하는 async 함수
+     */
+    static withSession<T>(connection: any, fn: (page: any) => Promise<T>): Promise<T>;
     static getConnectionInstanceByName(domain: Domain, name: string): Promise<any>;
     static getConnectionEntityByName(domain: Domain, name: string): Promise<Connection | null>;
     static getConnectionInstanceEntityByName(domain: Domain, name: string): any;

package/dist-server/engine/connection-manager.js

@@ -6,6 +6,7 @@ const moment_timezone_1 = tslib_1.__importDefault(require("moment-timezone"));
 const winston_1 = require("winston");
 const shell_1 = require("@things-factory/shell");
 const service_1 = require("../service");
+const domain_inheritance_1 = require("../utils/domain-inheritance");
 const proxy_connector_1 = require("./connector/proxy-connector");
 const { combine, splat, printf, errors } = winston_1.format;
 const debug = require('debug')('things-factory:integration-base:connections');
@@ -32,6 +33,12 @@ class ConnectionManager {
     static { this.connectors = {}; }
     static { this.connections = {}; }
     static { this.entities = {}; }
+    /**
+     * Session 직렬화 mutex — connection name 단위 (도메인 무관 글로벌).
+     * sessionExclusive connector 의 acquireSessionPage 동시 호출이 외부 세션을 서로
+     * invalidate 하지 않도록 큐잉. release 호출 시 다음 대기자가 진행.
+     */
+    static { this.sessionLocks = new Map(); }
     static { this.logFormat = printf(({ level, message, timestamp, stack }) => {
         return `${timestamp} ${level}: ${stack || message}`;
     }); }
@@ -114,20 +121,106 @@ class ConnectionManager {
         const { domain, name } = connection;
         return ConnectionManager.connections[domain.id]?.[name];
     }
+    /**
+     * 세션 사용 패턴 (RAII).
+     *
+     * connector 가 sessionExclusive=true 로 선언한 경우 connection.name 단위 mutex 로
+     * 직렬화. 호출자는 acquireSessionPage / releasePage 의 lifecycle 을 신경 쓸 필요 없이
+     * `withSession(connection, async page => { ... })` 형태로 사용하면 됨.
+     *
+     * stateless connector (sessionExclusive=false) 는 mutex 없이 즉시 진행.
+     *
+     * @param connection 도메인 instance (connection.type 에서 connector 조회)
+     * @param fn         page 를 받아 데이터 작업하는 async 함수
+     */
+    static async withSession(connection, fn) {
+        const connector = ConnectionManager.getConnector(connection.type);
+        const exclusive = !!connector?.sessionExclusive;
+        const run = async () => {
+            const page = await connection.acquireSessionPage();
+            try {
+                return await fn(page);
+            }
+            finally {
+                // releasePage 가 page 인자를 받음 — 누락 시 내부의 page.close() 와
+                // browser 풀 반환이 스킵되어 브라우저가 leak. 풀 고갈 → 정상 종료 hang 으로 이어짐.
+                try {
+                    await connection.releasePage?.(page);
+                }
+                catch (e) {
+                    ConnectionManager.logger.warn(`releasePage failed for '${connection.name}':`, e);
+                }
+            }
+        };
+        if (!exclusive)
+            return await run();
+        // mutex: connection name 단위로 직렬화 (도메인 무관, 같은 외부 계정 중복 로그인 방지)
+        const lockKey = connection.name;
+        const wasQueued = ConnectionManager.sessionLocks.has(lockKey);
+        const prev = ConnectionManager.sessionLocks.get(lockKey) || Promise.resolve();
+        let release;
+        const next = new Promise(r => (release = r));
+        // chain: 이전 작업이 끝난 뒤 next 가 끝날 때까지 pending — 다음 대기자가 이 chain 으로 await
+        const chain = prev.then(() => next);
+        ConnectionManager.sessionLocks.set(lockKey, chain);
+        // 큐 대기 진단 — 운영 중 "왜 작업이 stall 되는가" 추적용
+        const waitStartedAt = wasQueued ? Date.now() : 0;
+        if (wasQueued) {
+            ConnectionManager.logger.info(`[withSession] '${lockKey}' queued behind existing lock — waiting (domain='${connection.domain?.subdomain || connection.domainId}')`);
+        }
+        await prev;
+        if (wasQueued) {
+            const waited = Date.now() - waitStartedAt;
+            ConnectionManager.logger.info(`[withSession] '${lockKey}' lock acquired after ${waited}ms wait`);
+        }
+        try {
+            return await run();
+        }
+        finally {
+            release();
+            // 내가 latest 면 (이 chain 뒤로 새로 들어온 대기자 없음) cleanup
+            if (ConnectionManager.sessionLocks.get(lockKey) === chain) {
+                ConnectionManager.sessionLocks.delete(lockKey);
+            }
+        }
+    }
     static async getConnectionInstanceByName(domain, name) {
         const connections = ConnectionManager.connections[domain.id];
         const connection = connections?.[name];
         if (!connection) {
-            // on-demand 커넥션인지 확인하고 생성
+            // 자식 도메인에 instance 가 없을 때의 세 가지 자동 처리 분기:
+            //
+            //  (a) entity.__sharedFrom 있음 — SHARE 모드 inheritance
+            //      → 부모 도메인의 instance 를 그대로 lookup 해서 반환. 자식 도메인에는 instance 등록 안 함.
+            //         같은 instance 가 부모·자식 모두에게 서비스 됨.
+            //
+            //  (b) entity.__inheritedFrom 있음 — ISOLATE 모드 inheritance
+            //      → 자식 도메인 키 아래 새 instance 자동 생성. cookies/세션 격리.
+            //
+            //  (c) entity.onDemand=true — 명시적 lazy 생성 (자식 자체 record 인 경우에도 적용)
+            //      → 자식 도메인 키 아래 새 instance 생성.
+            //
+            //  나머지: 자식 record 도 없고 inherit 도 안 되는 경우 → throw.
             try {
                 const connectionEntity = await ConnectionManager.getConnectionEntityByName(domain, name);
-                if (connectionEntity?.onDemand) {
-                    // on-demand 커넥션 생성
-                    const onDemandInstance = await ConnectionManager.createOnDemandConnection(connectionEntity);
-                    return onDemandInstance;
+                if (connectionEntity?.__sharedFrom) {
+                    // SHARE: 부모 instance 직접 사용
+                    const parentInstance = ConnectionManager.connections[connectionEntity.__sharedFrom]?.[name];
+                    if (parentInstance)
+                        return parentInstance;
+                    throw `SHARE mode: parent instance for '${name}' (domain id '${connectionEntity.__sharedFrom}') not registered yet — startup ready() may have failed for parent`;
+                }
+                if (connectionEntity?.onDemand || connectionEntity?.__inheritedFrom) {
+                    const instance = await ConnectionManager.createOnDemandConnection(connectionEntity);
+                    return instance;
+                }
+                else if (connectionEntity) {
+                    // entity 는 찾았는데 instance 생성 trigger (onDemand/inherit) 없음 — 운영자가 record 자체 점검 필요
+                    throw `Connection '${name}' record exists but instance is not registered and no auto-create trigger (onDemand=false, no inheritance marker). Check whether parent record's active=true and ready() succeeded at startup.`;
                 }
                 else {
-                    throw `The connection with the given name(${name}) cannot be found`;
+                    // entity 자체 못 찾음 — 도메인 트리 어디에도 record 없음
+                    throw `Connection '${name}' not found in domain '${domain.subdomain || domain.id}' or any ancestor — verify the Connection record exists at the running domain or any of its ancestors.`;
                 }
             }
             catch (error) {
@@ -163,22 +256,61 @@ class ConnectionManager {
             //     return parentCachedEntity
             //   }
             // }
-            // 4. 부모 도메인에서 데이터베이스 조회 (fallback)
-            if (domain.parentId) {
-                connection = await (0, shell_1.getRepository)(service_1.Connection).findOne({
+            // 4. ancestor 도메인 트리 fallback (closest-first walk)
+            //
+            //    EnvVar inheritance 와 일관되게 모든 조상 도메인을 closest-first 로 탐색.
+            //    예: SYSTEM → 시공사 → 프로젝트 트리에서 시나리오가 프로젝트 도메인에서 실행될 때
+            //    Connection record 가 SYSTEM 또는 시공사 어디에 있어도 찾아냄.
+            //
+            //    매칭된 ancestor 의 inheritanceMode 에 따라 두 갈래:
+            //      ISOLATE (default): 자식 도메인용 clone 생성. cookies/세션 격리, 자식 컨텍스트에서
+            //                         EnvVar override 해소. __inheritedFrom marker 로 후속 자동 instance.
+            //      SHARE:             부모 entity 그대로 반환. params·세션·인스턴스 모두 부모 것 공유.
+            //                         __sharedFrom marker 로 instance lookup 이 부모 도메인을 가리키게 함.
+            //
+            //    호환성: inheritanceMode 미지정(NULL) → connector default → 폴백 ISOLATE.
+            //    기존 모든 Connection 은 이 column 추가 전 만들어졌으므로 NULL → ISOLATE = 기존 거동.
+            const ancestorIds = await (0, domain_inheritance_1.getDomainIdsWithAncestors)(domain);
+            // ancestorIds[0] = domain.id (이미 위 분기에서 시도), skip
+            const searchedAncestors = [];
+            for (let i = 1; i < ancestorIds.length; i++) {
+                const ancestorId = ancestorIds[i];
+                searchedAncestors.push(ancestorId);
+                const parentConn = await (0, shell_1.getRepository)(service_1.Connection).findOne({
                     where: {
-                        domain: { id: domain.parentId },
+                        domain: { id: ancestorId },
                         name: name
                     },
                     relations: ['domain', 'edge', 'creator', 'updater']
                 });
-                if (connection) {
-                    const resolvedParams = await connection.getResolvedParameters();
-                    connection.params = resolvedParams;
-                    connection.domain = domain;
-                    connection.domainId = domain.id;
-                    return connection;
+                if (!parentConn)
+                    continue; // 이 ancestor 에 없으면 다음 ancestor
+                ConnectionManager.logger.info(`[inheritance] '${name}' inherited by domain '${domain.subdomain || domain.id}' ` +
+                    `from ancestor '${parentConn.domain?.subdomain || ancestorId}' ` +
+                    `(walked ${i} ancestor(s))`);
+                const connectorDefault = ConnectionManager.connectors[parentConn.type]?.inheritanceMode;
+                const effectiveMode = parentConn.inheritanceMode || connectorDefault || service_1.ConnectionInheritanceMode.ISOLATE;
+                if (effectiveMode === service_1.ConnectionInheritanceMode.SHARE) {
+                    // SHARE — 부모 entity 그대로 반환 (mutation 최소화).
+                    const shared = parentConn;
+                    shared.__sharedFrom = parentConn.domainId;
+                    shared.params = await parentConn.getResolvedParameters();
+                    return shared;
                 }
+                // ISOLATE (default) — clone + marker
+                const inherited = Object.assign(Object.create(Object.getPrototypeOf(parentConn)), parentConn, {
+                    domain,
+                    domainId: domain.id,
+                    cookies: undefined,
+                    __inheritedFrom: parentConn.domainId
+                });
+                inherited.params = await inherited.getResolvedParameters();
+                return inherited;
+            }
+            // 어느 ancestor 에서도 못 찾음 — 운영자가 어디까지 찾았는지 알 수 있도록 진단 로그
+            if (searchedAncestors.length > 0) {
+                ConnectionManager.logger.warn(`[inheritance] '${name}' not found at any ancestor of domain '${domain.subdomain || domain.id}' ` +
+                    `— searched: [${searchedAncestors.join(', ')}]`);
             }
             return null;
         }

package/dist-server/engine/connection-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"connection-manager.js","sourceRoot":"","sources":["../../server/engine/connection-manager.ts"],"names":[],"mappings":"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","sourcesContent":["import moment from 'moment-timezone'\nimport { createLogger, format, transports } from 'winston'\n\nimport { Domain, getRepository, pubsub, PubSubLogTransport } from '@things-factory/shell'\n\nimport { Connection, ConnectionStatus } from '../service'\nimport { Connector } from './types'\nimport { ProxyConnector } from './connector/proxy-connector'\n\nconst { combine, splat, printf, errors } = format\nconst debug = require('debug')('things-factory:integration-base:connections')\n\nfunction getSystemTimeZone() {\n  try {\n    const timeZone = Intl.DateTimeFormat().resolvedOptions().timeZone\n    if (!timeZone) {\n      throw new Error('Unable to resolve timeZone')\n    }\n    return timeZone\n  } catch (e) {\n    console.warn('Failed to get system timeZone, falling back to UTC.', e)\n    return 'UTC'\n  }\n}\n\nconst SYSTEM_TZ = getSystemTimeZone()\nconst systemTimestamp = format((info, opts: { tz?: string }) => {\n  if (opts.tz) info.timestamp = moment().tz(opts.tz).format()\n  return info\n})\n\nexport class ConnectionManager {\n  private static connectors: { [propName: string]: Connector } = {}\n  private static connections: { [domainId: string]: { [name: string]: any } } = {}\n  private static entities = {}\n  private static logFormat = printf(({ level, message, timestamp, stack }) => {\n    return `${timestamp} ${level}: ${stack || message}`\n  })\n\n  public static logger = createLogger({\n    format: combine(errors({ stack: true }), systemTimestamp({ tz: SYSTEM_TZ }), splat(), ConnectionManager.logFormat),\n    transports: [\n      new (transports as any).DailyRotateFile({\n        filename: `logs/connections-%DATE%.log`,\n        datePattern: 'YYYY-MM-DD-HH',\n        zippedArchive: false,\n        maxSize: '20m',\n        maxFiles: '14d',\n        level: 'info'\n      }),\n      new PubSubLogTransport({\n        topic: 'connection-log'\n      })\n    ]\n  })\n\n  static async ready() {\n    const CONNECTIONS = await Promise.all(\n      (\n        await getRepository(Connection).find({\n          where: { active: true },\n          relations: ['domain', 'edge', 'creator', 'updater']\n        })\n      ).map(async connection => {\n        // 🔐 해결된 파라미터 사용\n        const resolvedParams = await connection.getResolvedParameters()\n\n        return {\n          ...connection,\n          params: resolvedParams\n        }\n      })\n    )\n\n    ConnectionManager.logger.info('Initializing ConnectionManager...')\n\n    return await Promise.all(\n      [...Object.keys(ConnectionManager.connectors), 'proxy-connector'].map(type => {\n        const connector = type == 'proxy-connector' ? ProxyConnector.instance : ConnectionManager.getConnector(type)\n\n        ConnectionManager.logger.info(`Connector '${type}' started to ready`)\n\n        return connector\n          .ready(\n            CONNECTIONS.filter(connection => {\n              if (type == 'proxy-connector') {\n                return !!connection.edge\n              } else {\n                return !connection.edge && connection.type == type\n              }\n            }) as any\n          )\n          .catch(error => {\n            ConnectionManager.logger.error(error)\n          })\n          .then(() => {\n            ConnectionManager.logger.info(`All connector for '${type}' ready`)\n          })\n      })\n    ).then(() => {\n      ConnectionManager.logger.info('ConnectionManager initialization done:')\n      Object.keys(ConnectionManager.connections).forEach(key => {\n        var connections = ConnectionManager.connections[key]\n        ConnectionManager.logger.info('For domain(%s) : %s', key, JSON.stringify(Object.keys(connections)))\n      })\n    })\n  }\n\n  static registerConnector(type: string, connector: Connector) {\n    ConnectionManager.connectors[type] = connector\n  }\n\n  static getConnector(type: string): Connector {\n    return ConnectionManager.connectors[type]\n  }\n\n  static getConnectors(): { [connectorName: string]: Connector } {\n    return {\n      ...ConnectionManager.connectors\n    }\n  }\n\n  static unregisterConnector(type: string) {\n    delete ConnectionManager.connectors[type]\n  }\n\n  static getConnections() {\n    return ConnectionManager.connections\n  }\n\n  static getEntities() {\n    return ConnectionManager.entities\n  }\n\n  static getConnectionInstance(connection: Connection): any {\n    const { domain, name } = connection\n    return ConnectionManager.connections[domain.id]?.[name]\n  }\n\n  static async getConnectionInstanceByName(domain: Domain, name: string) {\n    const connections = ConnectionManager.connections[domain.id]\n    const connection = connections?.[name]\n\n    if (!connection) {\n      // on-demand 커넥션인지 확인하고 생성\n      try {\n        const connectionEntity = await ConnectionManager.getConnectionEntityByName(domain, name)\n\n        if (connectionEntity?.onDemand) {\n          // on-demand 커넥션 생성\n          const onDemandInstance = await ConnectionManager.createOnDemandConnection(connectionEntity)\n          return onDemandInstance\n        } else {\n          throw `The connection with the given name(${name}) cannot be found`\n        }\n      } catch (error) {\n        throw `The connection with the given name(${name}) cannot be found: ${error}`\n      }\n    }\n\n    return connection\n  }\n\n  static async getConnectionEntityByName(domain: Domain, name: string): Promise<Connection | null> {\n    // 1. 현재 도메인에서 메모리 조회 (우선)\n    const cachedEntity = ConnectionManager.entities[domain.id]?.[name]\n    if (cachedEntity) {\n      return cachedEntity\n    }\n\n    // 2. 현재 도메인에서 데이터베이스 조회 (우선)\n    try {\n      let connection = await getRepository(Connection).findOne({\n        where: {\n          domain: { id: domain.id },\n          name: name\n        },\n        relations: ['domain', 'edge', 'creator', 'updater']\n      })\n\n      if (connection) {\n        const resolvedParams = await connection.getResolvedParameters()\n        connection.params = resolvedParams\n        return connection\n      }\n\n      // 3. 현재 도메인에서 못 찾으면 부모 도메인에서 메모리 조회 - 안된다. connection정보를 수정해야 하므로 사용할 수 없다.\n      // if (domain.parentId) {\n      //   const parentCachedEntity = ConnectionManager.entities[domain.parentId]?.[name]\n      //   if (parentCachedEntity) {\n      //     return parentCachedEntity\n      //   }\n      // }\n\n      // 4. 부모 도메인에서 데이터베이스 조회 (fallback)\n      if (domain.parentId) {\n        connection = await getRepository(Connection).findOne({\n          where: {\n            domain: { id: domain.parentId },\n            name: name\n          },\n          relations: ['domain', 'edge', 'creator', 'updater']\n        })\n\n        if (connection) {\n          const resolvedParams = await connection.getResolvedParameters()\n          connection.params = resolvedParams\n          connection.domain = domain\n          connection.domainId = domain.id\n\n          return connection\n        }\n      }\n\n      return null\n    } catch (error) {\n      ConnectionManager.logger.error(`Failed to get connection entity '${name}' from database:`, error)\n      return null\n    }\n  }\n\n  static getConnectionInstanceEntityByName(domain: Domain, name: string): any {\n    const connection = ConnectionManager.entities[domain.id]?.[name]\n    if (connection) {\n      return connection\n    }\n\n    if (domain.parentId) {\n      return ConnectionManager.entities[domain.parentId]?.[name]\n    }\n  }\n\n  /**\n   * Creates a connection on-demand and returns the instance.\n   * @param connection - The connection entity to create\n   * @returns The connection instance\n   */\n  static async createOnDemandConnection(connection: Connection): Promise<any> {\n    try {\n      // 커넥션 생성\n      await connection.connect()\n\n      ConnectionManager.logger.info(`On-demand connection '${connection.name}' created successfully`)\n      return ConnectionManager.getConnectionInstance(connection)\n    } catch (error) {\n      ConnectionManager.logger.error(`Failed to create on-demand connection '${connection.name}':`, error)\n      throw error\n    }\n  }\n\n  /**\n   * Disconnects an on-demand connection.\n   * @param connection - The connection entity to disconnect\n   */\n  static async disconnectOnDemandConnection(connection: Connection): Promise<void> {\n    try {\n      await connection.disconnect()\n      // ConnectionManager.removeConnectionInstance(connection)\n      ConnectionManager.logger.info(`On-demand connection '${connection.name}' disconnected successfully`)\n    } catch (error) {\n      ConnectionManager.logger.error(`Failed to disconnect on-demand connection '${connection.name}':`, error)\n    }\n  }\n\n  static getConnectionInstances(domain: Domain): { [connectionName: string]: any } {\n    const connections = ConnectionManager.connections[domain.id]\n    const parentConnections = domain.parentId && ConnectionManager.connections[domain.parentId]\n\n    return {\n      ...parentConnections,\n      ...connections\n    }\n  }\n\n  static getConnectionInstanceEntities(domain: Domain): { [connectionName: string]: any } {\n    const connections = ConnectionManager.entities[domain.id]\n\n    return {\n      ...connections\n    }\n  }\n\n  static addConnectionInstance(connection: Connection, instance: any) {\n    const { domain, name } = connection\n\n    var connections = ConnectionManager.connections[domain.id]\n    if (!connections) {\n      connections = ConnectionManager.connections[domain.id] = {}\n    }\n\n    var entities = ConnectionManager.entities[domain.id]\n    if (!entities) {\n      entities = ConnectionManager.entities[domain.id] = {}\n    }\n\n    connections[name] = instance\n    entities[name] = connection\n\n    ConnectionManager.publishState(connection, ConnectionStatus.CONNECTED)\n    debug('add-connection', domain.subdomain, name)\n  }\n\n  static removeConnectionInstance(connection: Connection): any {\n    const { domain, name } = connection\n    var connections = ConnectionManager.connections[domain.id]\n    var entities = ConnectionManager.entities[domain.id]\n\n    var instance = connections?.[name]\n\n    if (!connections || !instance) {\n      debug('remove-connection', `'${name}' connection not found in domain '${domain.subdomain}'`)\n      return\n    }\n\n    delete connections[name]\n    delete entities[name]\n\n    ConnectionManager.publishState(connection, ConnectionStatus.DISCONNECTED)\n    debug('remove-connection', `'${name}' connection is removed from domain '${domain.subdomain}'`)\n\n    return instance\n  }\n\n  private static async publishState(connection: Connection, state) {\n    const { domain, id, name, description, type, edge } = connection\n\n    pubsub.publish('connection-state', {\n      connectionState: {\n        domain,\n        id,\n        name,\n        description,\n        type,\n        edge,\n        state,\n        timestamp: new Date()\n      }\n    })\n  }\n}\n"]}
+{"version":3,"file":"connection-manager.js","sourceRoot":"","sources":["../../server/engine/connection-manager.ts"],"names":[],"mappings":"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","sourcesContent":["import moment from 'moment-timezone'\nimport { createLogger, format, transports } from 'winston'\n\nimport { Domain, getRepository, pubsub, PubSubLogTransport } from '@things-factory/shell'\n\nimport { Connection, ConnectionInheritanceMode, ConnectionStatus } from '../service'\nimport { getDomainIdsWithAncestors } from '../utils/domain-inheritance'\nimport { Connector } from './types'\nimport { ProxyConnector } from './connector/proxy-connector'\n\nconst { combine, splat, printf, errors } = format\nconst debug = require('debug')('things-factory:integration-base:connections')\n\nfunction getSystemTimeZone() {\n  try {\n    const timeZone = Intl.DateTimeFormat().resolvedOptions().timeZone\n    if (!timeZone) {\n      throw new Error('Unable to resolve timeZone')\n    }\n    return timeZone\n  } catch (e) {\n    console.warn('Failed to get system timeZone, falling back to UTC.', e)\n    return 'UTC'\n  }\n}\n\nconst SYSTEM_TZ = getSystemTimeZone()\nconst systemTimestamp = format((info, opts: { tz?: string }) => {\n  if (opts.tz) info.timestamp = moment().tz(opts.tz).format()\n  return info\n})\n\nexport class ConnectionManager {\n  private static connectors: { [propName: string]: Connector } = {}\n  private static connections: { [domainId: string]: { [name: string]: any } } = {}\n  private static entities = {}\n  /**\n   * Session 직렬화 mutex — connection name 단위 (도메인 무관 글로벌).\n   * sessionExclusive connector 의 acquireSessionPage 동시 호출이 외부 세션을 서로\n   * invalidate 하지 않도록 큐잉. release 호출 시 다음 대기자가 진행.\n   */\n  private static sessionLocks: Map<string, Promise<void>> = new Map()\n  private static logFormat = printf(({ level, message, timestamp, stack }) => {\n    return `${timestamp} ${level}: ${stack || message}`\n  })\n\n  public static logger = createLogger({\n    format: combine(errors({ stack: true }), systemTimestamp({ tz: SYSTEM_TZ }), splat(), ConnectionManager.logFormat),\n    transports: [\n      new (transports as any).DailyRotateFile({\n        filename: `logs/connections-%DATE%.log`,\n        datePattern: 'YYYY-MM-DD-HH',\n        zippedArchive: false,\n        maxSize: '20m',\n        maxFiles: '14d',\n        level: 'info'\n      }),\n      new PubSubLogTransport({\n        topic: 'connection-log'\n      })\n    ]\n  })\n\n  static async ready() {\n    const CONNECTIONS = await Promise.all(\n      (\n        await getRepository(Connection).find({\n          where: { active: true },\n          relations: ['domain', 'edge', 'creator', 'updater']\n        })\n      ).map(async connection => {\n        // 🔐 해결된 파라미터 사용\n        const resolvedParams = await connection.getResolvedParameters()\n\n        return {\n          ...connection,\n          params: resolvedParams\n        }\n      })\n    )\n\n    ConnectionManager.logger.info('Initializing ConnectionManager...')\n\n    return await Promise.all(\n      [...Object.keys(ConnectionManager.connectors), 'proxy-connector'].map(type => {\n        const connector = type == 'proxy-connector' ? ProxyConnector.instance : ConnectionManager.getConnector(type)\n\n        ConnectionManager.logger.info(`Connector '${type}' started to ready`)\n\n        return connector\n          .ready(\n            CONNECTIONS.filter(connection => {\n              if (type == 'proxy-connector') {\n                return !!connection.edge\n              } else {\n                return !connection.edge && connection.type == type\n              }\n            }) as any\n          )\n          .catch(error => {\n            ConnectionManager.logger.error(error)\n          })\n          .then(() => {\n            ConnectionManager.logger.info(`All connector for '${type}' ready`)\n          })\n      })\n    ).then(() => {\n      ConnectionManager.logger.info('ConnectionManager initialization done:')\n      Object.keys(ConnectionManager.connections).forEach(key => {\n        var connections = ConnectionManager.connections[key]\n        ConnectionManager.logger.info('For domain(%s) : %s', key, JSON.stringify(Object.keys(connections)))\n      })\n    })\n  }\n\n  static registerConnector(type: string, connector: Connector) {\n    ConnectionManager.connectors[type] = connector\n  }\n\n  static getConnector(type: string): Connector {\n    return ConnectionManager.connectors[type]\n  }\n\n  static getConnectors(): { [connectorName: string]: Connector } {\n    return {\n      ...ConnectionManager.connectors\n    }\n  }\n\n  static unregisterConnector(type: string) {\n    delete ConnectionManager.connectors[type]\n  }\n\n  static getConnections() {\n    return ConnectionManager.connections\n  }\n\n  static getEntities() {\n    return ConnectionManager.entities\n  }\n\n  static getConnectionInstance(connection: Connection): any {\n    const { domain, name } = connection\n    return ConnectionManager.connections[domain.id]?.[name]\n  }\n\n  /**\n   * 세션 사용 패턴 (RAII).\n   *\n   * connector 가 sessionExclusive=true 로 선언한 경우 connection.name 단위 mutex 로\n   * 직렬화. 호출자는 acquireSessionPage / releasePage 의 lifecycle 을 신경 쓸 필요 없이\n   * `withSession(connection, async page => { ... })` 형태로 사용하면 됨.\n   *\n   * stateless connector (sessionExclusive=false) 는 mutex 없이 즉시 진행.\n   *\n   * @param connection 도메인 instance (connection.type 에서 connector 조회)\n   * @param fn         page 를 받아 데이터 작업하는 async 함수\n   */\n  static async withSession<T>(connection: any, fn: (page: any) => Promise<T>): Promise<T> {\n    const connector = ConnectionManager.getConnector(connection.type)\n    const exclusive = !!connector?.sessionExclusive\n\n    const run = async (): Promise<T> => {\n      const page = await connection.acquireSessionPage()\n      try {\n        return await fn(page)\n      } finally {\n        // releasePage 가 page 인자를 받음 — 누락 시 내부의 page.close() 와\n        // browser 풀 반환이 스킵되어 브라우저가 leak. 풀 고갈 → 정상 종료 hang 으로 이어짐.\n        try {\n          await connection.releasePage?.(page)\n        } catch (e) {\n          ConnectionManager.logger.warn(`releasePage failed for '${connection.name}':`, e as any)\n        }\n      }\n    }\n\n    if (!exclusive) return await run()\n\n    // mutex: connection name 단위로 직렬화 (도메인 무관, 같은 외부 계정 중복 로그인 방지)\n    const lockKey = connection.name\n    const wasQueued = ConnectionManager.sessionLocks.has(lockKey)\n    const prev = ConnectionManager.sessionLocks.get(lockKey) || Promise.resolve()\n    let release!: () => void\n    const next = new Promise<void>(r => (release = r))\n    // chain: 이전 작업이 끝난 뒤 next 가 끝날 때까지 pending — 다음 대기자가 이 chain 으로 await\n    const chain = prev.then(() => next)\n    ConnectionManager.sessionLocks.set(lockKey, chain)\n\n    // 큐 대기 진단 — 운영 중 \"왜 작업이 stall 되는가\" 추적용\n    const waitStartedAt = wasQueued ? Date.now() : 0\n    if (wasQueued) {\n      ConnectionManager.logger.info(\n        `[withSession] '${lockKey}' queued behind existing lock — waiting (domain='${connection.domain?.subdomain || connection.domainId}')`\n      )\n    }\n    await prev\n    if (wasQueued) {\n      const waited = Date.now() - waitStartedAt\n      ConnectionManager.logger.info(\n        `[withSession] '${lockKey}' lock acquired after ${waited}ms wait`\n      )\n    }\n\n    try {\n      return await run()\n    } finally {\n      release()\n      // 내가 latest 면 (이 chain 뒤로 새로 들어온 대기자 없음) cleanup\n      if (ConnectionManager.sessionLocks.get(lockKey) === chain) {\n        ConnectionManager.sessionLocks.delete(lockKey)\n      }\n    }\n  }\n\n  static async getConnectionInstanceByName(domain: Domain, name: string) {\n    const connections = ConnectionManager.connections[domain.id]\n    const connection = connections?.[name]\n\n    if (!connection) {\n      // 자식 도메인에 instance 가 없을 때의 세 가지 자동 처리 분기:\n      //\n      //  (a) entity.__sharedFrom 있음 — SHARE 모드 inheritance\n      //      → 부모 도메인의 instance 를 그대로 lookup 해서 반환. 자식 도메인에는 instance 등록 안 함.\n      //         같은 instance 가 부모·자식 모두에게 서비스 됨.\n      //\n      //  (b) entity.__inheritedFrom 있음 — ISOLATE 모드 inheritance\n      //      → 자식 도메인 키 아래 새 instance 자동 생성. cookies/세션 격리.\n      //\n      //  (c) entity.onDemand=true — 명시적 lazy 생성 (자식 자체 record 인 경우에도 적용)\n      //      → 자식 도메인 키 아래 새 instance 생성.\n      //\n      //  나머지: 자식 record 도 없고 inherit 도 안 되는 경우 → throw.\n      try {\n        const connectionEntity = await ConnectionManager.getConnectionEntityByName(domain, name)\n\n        if (connectionEntity?.__sharedFrom) {\n          // SHARE: 부모 instance 직접 사용\n          const parentInstance = ConnectionManager.connections[connectionEntity.__sharedFrom]?.[name]\n          if (parentInstance) return parentInstance\n          throw `SHARE mode: parent instance for '${name}' (domain id '${connectionEntity.__sharedFrom}') not registered yet — startup ready() may have failed for parent`\n        }\n\n        if (connectionEntity?.onDemand || connectionEntity?.__inheritedFrom) {\n          const instance = await ConnectionManager.createOnDemandConnection(connectionEntity!)\n          return instance\n        } else if (connectionEntity) {\n          // entity 는 찾았는데 instance 생성 trigger (onDemand/inherit) 없음 — 운영자가 record 자체 점검 필요\n          throw `Connection '${name}' record exists but instance is not registered and no auto-create trigger (onDemand=false, no inheritance marker). Check whether parent record's active=true and ready() succeeded at startup.`\n        } else {\n          // entity 자체 못 찾음 — 도메인 트리 어디에도 record 없음\n          throw `Connection '${name}' not found in domain '${domain.subdomain || domain.id}' or any ancestor — verify the Connection record exists at the running domain or any of its ancestors.`\n        }\n      } catch (error) {\n        throw `The connection with the given name(${name}) cannot be found: ${error}`\n      }\n    }\n\n    return connection\n  }\n\n  static async getConnectionEntityByName(domain: Domain, name: string): Promise<Connection | null> {\n    // 1. 현재 도메인에서 메모리 조회 (우선)\n    const cachedEntity = ConnectionManager.entities[domain.id]?.[name]\n    if (cachedEntity) {\n      return cachedEntity\n    }\n\n    // 2. 현재 도메인에서 데이터베이스 조회 (우선)\n    try {\n      let connection = await getRepository(Connection).findOne({\n        where: {\n          domain: { id: domain.id },\n          name: name\n        },\n        relations: ['domain', 'edge', 'creator', 'updater']\n      })\n\n      if (connection) {\n        const resolvedParams = await connection.getResolvedParameters()\n        connection.params = resolvedParams\n        return connection\n      }\n\n      // 3. 현재 도메인에서 못 찾으면 부모 도메인에서 메모리 조회 - 안된다. connection정보를 수정해야 하므로 사용할 수 없다.\n      // if (domain.parentId) {\n      //   const parentCachedEntity = ConnectionManager.entities[domain.parentId]?.[name]\n      //   if (parentCachedEntity) {\n      //     return parentCachedEntity\n      //   }\n      // }\n\n      // 4. ancestor 도메인 트리 fallback (closest-first walk)\n      //\n      //    EnvVar inheritance 와 일관되게 모든 조상 도메인을 closest-first 로 탐색.\n      //    예: SYSTEM → 시공사 → 프로젝트 트리에서 시나리오가 프로젝트 도메인에서 실행될 때\n      //    Connection record 가 SYSTEM 또는 시공사 어디에 있어도 찾아냄.\n      //\n      //    매칭된 ancestor 의 inheritanceMode 에 따라 두 갈래:\n      //      ISOLATE (default): 자식 도메인용 clone 생성. cookies/세션 격리, 자식 컨텍스트에서\n      //                         EnvVar override 해소. __inheritedFrom marker 로 후속 자동 instance.\n      //      SHARE:             부모 entity 그대로 반환. params·세션·인스턴스 모두 부모 것 공유.\n      //                         __sharedFrom marker 로 instance lookup 이 부모 도메인을 가리키게 함.\n      //\n      //    호환성: inheritanceMode 미지정(NULL) → connector default → 폴백 ISOLATE.\n      //    기존 모든 Connection 은 이 column 추가 전 만들어졌으므로 NULL → ISOLATE = 기존 거동.\n      const ancestorIds = await getDomainIdsWithAncestors(domain)\n      // ancestorIds[0] = domain.id (이미 위 분기에서 시도), skip\n      const searchedAncestors: string[] = []\n      for (let i = 1; i < ancestorIds.length; i++) {\n        const ancestorId = ancestorIds[i]\n        searchedAncestors.push(ancestorId)\n        const parentConn = await getRepository(Connection).findOne({\n          where: {\n            domain: { id: ancestorId },\n            name: name\n          },\n          relations: ['domain', 'edge', 'creator', 'updater']\n        })\n\n        if (!parentConn) continue // 이 ancestor 에 없으면 다음 ancestor\n\n        ConnectionManager.logger.info(\n          `[inheritance] '${name}' inherited by domain '${domain.subdomain || domain.id}' ` +\n            `from ancestor '${parentConn.domain?.subdomain || ancestorId}' ` +\n            `(walked ${i} ancestor(s))`\n        )\n\n        const connectorDefault = ConnectionManager.connectors[parentConn.type]?.inheritanceMode\n        const effectiveMode =\n          parentConn.inheritanceMode || connectorDefault || ConnectionInheritanceMode.ISOLATE\n\n        if (effectiveMode === ConnectionInheritanceMode.SHARE) {\n          // SHARE — 부모 entity 그대로 반환 (mutation 최소화).\n          const shared: any = parentConn\n          shared.__sharedFrom = parentConn.domainId\n          shared.params = await parentConn.getResolvedParameters()\n          return shared\n        }\n\n        // ISOLATE (default) — clone + marker\n        const inherited: any = Object.assign(\n          Object.create(Object.getPrototypeOf(parentConn)),\n          parentConn,\n          {\n            domain,\n            domainId: domain.id,\n            cookies: undefined,\n            __inheritedFrom: parentConn.domainId\n          }\n        )\n        inherited.params = await inherited.getResolvedParameters()\n        return inherited\n      }\n\n      // 어느 ancestor 에서도 못 찾음 — 운영자가 어디까지 찾았는지 알 수 있도록 진단 로그\n      if (searchedAncestors.length > 0) {\n        ConnectionManager.logger.warn(\n          `[inheritance] '${name}' not found at any ancestor of domain '${domain.subdomain || domain.id}' ` +\n            `— searched: [${searchedAncestors.join(', ')}]`\n        )\n      }\n      return null\n    } catch (error) {\n      ConnectionManager.logger.error(`Failed to get connection entity '${name}' from database:`, error)\n      return null\n    }\n  }\n\n  static getConnectionInstanceEntityByName(domain: Domain, name: string): any {\n    const connection = ConnectionManager.entities[domain.id]?.[name]\n    if (connection) {\n      return connection\n    }\n\n    if (domain.parentId) {\n      return ConnectionManager.entities[domain.parentId]?.[name]\n    }\n  }\n\n  /**\n   * Creates a connection on-demand and returns the instance.\n   * @param connection - The connection entity to create\n   * @returns The connection instance\n   */\n  static async createOnDemandConnection(connection: Connection): Promise<any> {\n    try {\n      // 커넥션 생성\n      await connection.connect()\n\n      ConnectionManager.logger.info(`On-demand connection '${connection.name}' created successfully`)\n      return ConnectionManager.getConnectionInstance(connection)\n    } catch (error) {\n      ConnectionManager.logger.error(`Failed to create on-demand connection '${connection.name}':`, error)\n      throw error\n    }\n  }\n\n  /**\n   * Disconnects an on-demand connection.\n   * @param connection - The connection entity to disconnect\n   */\n  static async disconnectOnDemandConnection(connection: Connection): Promise<void> {\n    try {\n      await connection.disconnect()\n      // ConnectionManager.removeConnectionInstance(connection)\n      ConnectionManager.logger.info(`On-demand connection '${connection.name}' disconnected successfully`)\n    } catch (error) {\n      ConnectionManager.logger.error(`Failed to disconnect on-demand connection '${connection.name}':`, error)\n    }\n  }\n\n  static getConnectionInstances(domain: Domain): { [connectionName: string]: any } {\n    const connections = ConnectionManager.connections[domain.id]\n    const parentConnections = domain.parentId && ConnectionManager.connections[domain.parentId]\n\n    return {\n      ...parentConnections,\n      ...connections\n    }\n  }\n\n  static getConnectionInstanceEntities(domain: Domain): { [connectionName: string]: any } {\n    const connections = ConnectionManager.entities[domain.id]\n\n    return {\n      ...connections\n    }\n  }\n\n  static addConnectionInstance(connection: Connection, instance: any) {\n    const { domain, name } = connection\n\n    var connections = ConnectionManager.connections[domain.id]\n    if (!connections) {\n      connections = ConnectionManager.connections[domain.id] = {}\n    }\n\n    var entities = ConnectionManager.entities[domain.id]\n    if (!entities) {\n      entities = ConnectionManager.entities[domain.id] = {}\n    }\n\n    connections[name] = instance\n    entities[name] = connection\n\n    ConnectionManager.publishState(connection, ConnectionStatus.CONNECTED)\n    debug('add-connection', domain.subdomain, name)\n  }\n\n  static removeConnectionInstance(connection: Connection): any {\n    const { domain, name } = connection\n    var connections = ConnectionManager.connections[domain.id]\n    var entities = ConnectionManager.entities[domain.id]\n\n    var instance = connections?.[name]\n\n    if (!connections || !instance) {\n      debug('remove-connection', `'${name}' connection not found in domain '${domain.subdomain}'`)\n      return\n    }\n\n    delete connections[name]\n    delete entities[name]\n\n    ConnectionManager.publishState(connection, ConnectionStatus.DISCONNECTED)\n    debug('remove-connection', `'${name}' connection is removed from domain '${domain.subdomain}'`)\n\n    return instance\n  }\n\n  private static async publishState(connection: Connection, state) {\n    const { domain, id, name, description, type, edge } = connection\n\n    pubsub.publish('connection-state', {\n      connectionState: {\n        domain,\n        id,\n        name,\n        description,\n        type,\n        edge,\n        state,\n        timestamp: new Date()\n      }\n    })\n  }\n}\n"]}

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

@@ -1,5 +1,17 @@
 import { Connector } from '../types';
 export declare class HeadlessConnector implements Connector {
+    /**
+     * 외부 사이트 로그인 세션 보유 — 같은 connection name 의 동시 acquireSessionPage
+     * 호출이 같은 외부 계정 세션을 서로 invalidate 하지 않도록 ConnectionManager 가
+     * mutex 직렬화. 상속 connector (allbaro, kiscon 등) 자동 적용.
+     */
+    sessionExclusive: boolean;
+    /**
+     * 자식 도메인이 부모의 Connection 정의를 inherit 할 때 자식별 새 인스턴스 생성.
+     * cookies/세션·자격증명 격리. 헤드리스 사이트 connector 는 외부 자격증명이
+     * 자식 (테넌트) 마다 다를 수 있으므로 ISOLATE 가 자연 default.
+     */
+    inheritanceMode: "isolate";
     ready(connectionConfigs: any): Promise<void>;
     connect(connection: any): Promise<void>;
     setupPage(page: any, uri: any, timeout: any): Promise<void>;