@things-factory/integration-base 7.0.0-alpha.8 → 7.0.1-alpha.0

package/helps/integration/concept/script-internal-variables.ja.md

@@ -17,8 +17,28 @@
     - email: ユーザーの電子メール
     - userType: ユーザータイプ
 
-  - lng: シナリオを開始するユーザーのブラウザで使用されている言語（例：en-US、ko-KR など）。 ユーザーのブラウザを介さないリクエストを処理する場合、この組み込み変数は提供されない場合があります。
+  - lng: シナリオを開始するユーザーのブラウザで使用されている言語（例：en-US、ko-KR など）。
+
+    - ユーザーのブラウザを介さないリクエストを処理する場合、この組み込み変数は提供されない場合があります。
 
   - variables: シナリオ呼び出し時に呼び出し元から受け取るオブジェクト。
 
   - data: シナリオの実行中に生成された各ステップの結果データ。
+
+  - logger (only for script)：スクリプト内で必要に応じてログを残すことができる
+    - ログレベル：info, warn, error
+
+```javascript
+// 組み込み変数と変数の使用例
+const username = user ? user.name : '不明なユーザー'
+const companyName = domain ? domain.name : '不明な会社'
+
+// info レベルのログを残す例（組み込み変数と変数を使用）
+logger.info(`ユーザー '${username}' が '${companyName}' からシステムにアクセスしました。`)
+
+// warn レベルのログを残す例（組み込み変数と変数を使用）
+logger.warn(`ユーザー '${username}' が許可されていない操作を試みました。`)
+
+// error レベルのログを残す例（組み込み変数と変数を使用）
+logger.error(`ユーザー '${username}' のデータ処理中にエラーが発生しました。`)
+```

package/helps/integration/concept/script-internal-variables.ko.md

@@ -16,3 +16,20 @@
     - 사용자 브라우저를 통하지 않은 요청을 처리할 때에는 이 내장변수가 제공되지 않을 수 있다.
   - variables : 시나리오 호출 시점에 호출자로부터 전달받은 오브젝트
   - data: 시나리오 실행과정에 생성된 각 스텝의 결과 데이타
+  - logger: 스크립트 내에서 필요시 로그를 남길 수 있도록 제공된다
+    - log levels : info, warn, error
+
+```javascript
+// 내장 변수와 변수 사용 예시
+const username = user ? user.name : 'Unknown User'
+const companyName = domain ? domain.name : 'Unknown Company'
+
+// info 레벨의 로그를 남기는 예시 (내장 변수 및 변수 사용)
+logger.info(`User '${username}' from '${companyName}' accessed the system.`)
+
+// warn 레벨의 로그를 남기는 예시 (내장 변수 및 변수 사용)
+logger.warn(`User '${username}' attempted an unauthorized action.`)
+
+// error 레벨의 로그를 남기는 예시 (내장 변수 및 변수 사용)
+logger.error(`An error occurred while processing data for user '${username}'.`)
+```

package/helps/integration/concept/script-internal-variables.md

@@ -22,3 +22,21 @@ In script-type task properties (Script, SQL, GraphQL Query/Mutation, Log, etc.),
   - variables: An object received from the caller at the time of scenario invocation.
 
   - data: Results data generated for each step during scenario execution.
+
+  - logger (only for script): Provided to leave logs as needed within the script
+    - log levels: info, warn, error
+
+```javascript
+// Example of using built-in variables and variables
+const username = user ? user.name : 'Unknown User'
+const companyName = domain ? domain.name : 'Unknown Company'
+
+// Example of leaving a log at the info level (using built-in variables and variables)
+logger.info(`User '${username}' from '${companyName}' accessed the system.`)
+
+// Example of leaving a log at the warn level (using built-in variables and variables)
+logger.warn(`User '${username}' attempted an unauthorized action.`)
+
+// Example of leaving a log at the error level (using built-in variables and variables)
+logger.error(`An error occurred while processing data for user '${username}'.`)
+```

package/helps/integration/concept/script-internal-variables.ms.md

@@ -17,4 +17,22 @@ Dalam sifat tugas jenis skrip (Skrip, SQL, Pertanyaan/Mutasi GraphQL, Log, dsb.)
     - email: E-mel pengguna
     - userType: Jenis pengguna
 
-  - lng: Bahasa yang digunakan oleh pelayar pengguna ketika memulakan senario (contohnya, en-US, ko
+  - lng: Bahasa yang digunakan oleh pelayar pengguna ketika memulakan senario (contohnya, en-US, ko-KR)
+
+  - logger (only for script): menyediakan kemampuan untuk meninggalkan log apabila diperlukan dalam skrip
+    - tahap log: info, warn, error
+
+```javascript
+// contoh penggunaan variable bawaan dan variable
+const username = user ? user.name : 'Pengguna Tidak Diketahui'
+const companyName = domain ? domain.name : 'Syarikat Tidak Diketahui'
+
+// contoh meninggalkan log tahap info (menggunakan variable bawaan dan variable)
+logger.info(`Pengguna '${username}' dari '${companyName}' mengakses sistem.`)
+
+// contoh meninggalkan log tahap warn (menggunakan variable bawaan dan variable)
+logger.warn(`Pengguna '${username}' mencuba tindakan yang tidak dibenarkan.`)
+
+// contoh meninggalkan log tahap error (menggunakan variable bawaan dan variable)
+logger.error(`Terjadi kesalahan semasa memproses data untuk pengguna '${username}'.`)
+```

package/helps/integration/concept/script-internal-variables.zh.md

@@ -22,3 +22,21 @@
   - variables: 在方案调用时从调用者那里接收的对象
 
   - data: 在方案执行过程中生成的每个步骤的结果数据
+
+  - logger(only for script)：在脚本中需要时可以留下日志
+    - 日志级别：info, warn, error
+
+```javascript
+// 内置变量和变量使用示例
+const username = user ? user.name : '未知用户'
+const companyName = domain ? domain.name : '未知公司'
+
+// 记录 info 级别日志的示例（使用内置变量和变量）
+logger.info(`用户 '${username}' 从 '${companyName}' 访问了系统。`)
+
+// 记录 warn 级别日志的示例（使用内置变量和变量）
+logger.warn(`用户 '${username}' 尝试了未授权的操作。`)
+
+// 记录 error 级别日志的示例（使用内置变量和变量）
+logger.error(`处理用户 '${username}' 的数据时发生错误。`)
+```

package/helps/integration/task/script.ja.md

@@ -6,7 +6,7 @@
 
 - script
   - JavaScript 構文で記述します。
-  - グローバルオブジェクトは、対応する[シナリオコンテキスト](../concept/scenario-context.md)からのデータと変数を含むシンプルなオブジェクトです。つまり、スクリプト内では、シナリオの[スクリプト内蔵変数](../concept/script-internal-variables.md)から特別な修飾子なしで、または`this`アクセサを介してデータ、変数、ドメイン、ユーザー、lng 変数を使用できます。
+  - グローバルオブジェクトは、対応する[シナリオコンテキスト](../concept/scenario-context.md)からのデータと変数を含むシンプルなオブジェクトです。つまり、スクリプト内では、シナリオの[スクリプト内蔵変数](../concept/script-internal-variables.md)から特別な修飾子なしで、または`this`アクセサを介して data, variables, domain, user, lng, logger 変数を使用できます。
   - タスクの実行結果は`return`構文を介して返されます。
   - スクリプト内のグ
 

package/helps/integration/task/script.ko.md

@@ -6,7 +6,7 @@ Javascript Syntax로 작성된 script를 실행하여 그 결과를 리턴하는
 
 - script
   - javascript systax로 작성한다.
-  - global 오브젝트는 해당된 [Scenario Context](../concept/scenario-context.md)중 data 와 variables 를 가진 단순한 오브젝트이다. 즉, 스크립트 내에서 해당된 시나리오의 [스크립트 내장변수](../concept/script-internal-variables.md)인 data, variables, domain, user, lng 변수를 특별한 수식자없이 또는 this 접근자를 통해서 사용할 수 있다.
+  - global 오브젝트는 해당된 [Scenario Context](../concept/scenario-context.md)중 data 와 variables 를 가진 단순한 오브젝트이다. 즉, 스크립트 내에서 해당된 시나리오의 [스크립트 내장변수](../concept/script-internal-variables.md)인 data, variables, domain, user, lng, logger 변수를 특별한 수식자없이 또는 this 접근자를 통해서 사용할 수 있다.
   - 태스크의 수행 결과는 return 신택스를 통해서 반환된다.
   - script 내에서는 global 오브젝트가 data와 variables 등 [스크립트 내장변수](../concept/script-internal-variables.md)로 한정되므로, 대부분의 시스템 관련된 기능은 사용할 수 없는 sandbox 환경이라고 이해하고, 단순한 연산정도의 기능을 구현하는 것을 권장한다.
     - [Node Sandbox](https://medium.com/@devnullnor/a-secure-node-sandbox-f23b9fc9f2b0)

package/helps/integration/task/script.md

@@ -6,7 +6,7 @@ This is a task that executes a script written in JavaScript syntax and returns t
 
 - script
   - Write in JavaScript syntax.
-  - The global object is a simple object that contains data and variables from the corresponding [Scenario Context](../concept/scenario-context.md). In other words, within the script, you can use the data, variables, domain, user, and lng variables from the scenario's [Script Built-in Variables](../concept/script-internal-variables.md) without any special modifiers or through the `this` accessor.
+  - The global object is a simple object that contains data and variables from the corresponding [Scenario Context](../concept/scenario-context.md). In other words, within the script, you can use the data, variables, domain, user, logger and lng variables from the scenario's [Script Built-in Variables](../concept/script-internal-variables.md) without any special modifiers or through the `this` accessor.
   - The task's execution result is returned through the `return` syntax.
   - Since the global object within the script is limited to data and variables, as well as other [Script Built-in Variables](../concept/script-internal-variables.md), consider it a sandbox environment where most system-related functionalities are unavailable. It's recommended to implement simple operations.
     - [Node Sandbox](https://medium.com/@devnullnor/a-secure-node-sandbox-f23b9fc9f2b0)

package/helps/integration/task/script.ms.md

@@ -6,7 +6,7 @@ Ini adalah tugas yang menjalankan skrip yang ditulis dalam sintaks JavaScript da
 
 - skrip
   - Ditulis dalam sintaks JavaScript.
-  - Objek global adalah objek sederhana yang mengandungi data dan pembolehubah dari [Konteks Senario](../concept/scenario-context.md) yang berkaitan. Dengan kata lain, dalam skrip ini, anda boleh menggunakan data, pembolehubah, domain, pengguna, dan pembolehubah lng dari [Pembolehubah Terbina Dalam Skrip](../concept/script-internal-variables.md) senario tanpa modifier khas atau melalui aksesori `this`.
+  - Objek global adalah objek sederhana yang mengandungi data dan pembolehubah dari [Konteks Senario](../concept/scenario-context.md) yang berkaitan. Dengan kata lain, dalam skrip ini, anda boleh menggunakan data, variables, domain, user, lng, logger dari [Pembolehubah Terbina Dalam Skrip](../concept/script-internal-variables.md) senario tanpa modifier khas atau melalui aksesori `this`.
   - Hasil pelaksanaan tugas dikembalikan melalui sintaks `return`.
   - Oleh kerana objek global dalam skrip terhad kepada data dan pembolehubah, serta Pembolehubah Terbina Dalam Skrip yang lain, pertimbangkan ia sebagai persekitaran sandbox di mana kebanyakan fungsi berkaitan sistem tidak tersedia. Disarankan untuk melaksanakan operasi yang ringkas.
     - [Node Sandbox](https://medium.com/@devnullnor/a-secure-node-sandbox-f23b9fc9f2b0)

package/helps/integration/task/script.zh.md

@@ -6,7 +6,7 @@
 
 - 脚本
   - 以 JavaScript 语法编写。
-  - 全局对象是一个简单的对象，包含来自相应[场景上下文](../concept/scenario-context.md)的数据和变量。换句话说，在脚本内部，您可以使用来自场景的[脚本内置变量](../concept/script-internal-variables.md)（例如 data、variables、domain、user 和 lng 变量）而无需任何特殊修饰符，或者通过`this`访问器。
+  - 全局对象是一个简单的对象，包含来自相应[场景上下文](../concept/scenario-context.md)的数据和变量。换句话说，在脚本内部，您可以使用来自场景的[脚本内置变量](../concept/script-internal-variables.md)（例如 data、variables、domain、user, logger 和 lng 变量）而无需任何特殊修饰符，或者通过`this`访问器。
   - 任务的执行结果通过`return`语法返回。
   - 由于脚本内的全局对象仅限于数据和变量以及其他[脚本内置变量](../concept/script-internal-variables.md)，请将其视为一个沙盒环境，在该环境中大多数与系统相关的功能不可用。建议实现简单的操作。
     - [Node Sandbox](https://medium.com/@devnullnor/a-secure-node-sandbox-f23b9fc9f2b0)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/integration-base",
-  "version": "7.0.0-alpha.8",
+  "version": "7.0.1-alpha.0",
   "main": "dist-server/index.js",
   "browser": "client/index.js",
   "things-factory": true,
@@ -26,13 +26,13 @@
   },
   "dependencies": {
     "@apollo/client": "^3.6.9",
-    "@things-factory/api": "^7.0.0-alpha.8",
-    "@things-factory/auth-base": "^7.0.0-alpha.8",
-    "@things-factory/env": "^7.0.0-alpha.0",
-    "@things-factory/oauth2-client": "^7.0.0-alpha.8",
-    "@things-factory/scheduler-client": "^7.0.0-alpha.8",
-    "@things-factory/shell": "^7.0.0-alpha.8",
-    "@things-factory/utils": "^7.0.0-alpha.0",
+    "@things-factory/api": "^7.0.1-alpha.0",
+    "@things-factory/auth-base": "^7.0.1-alpha.0",
+    "@things-factory/env": "^7.0.1-alpha.0",
+    "@things-factory/oauth2-client": "^7.0.1-alpha.0",
+    "@things-factory/scheduler-client": "^7.0.1-alpha.0",
+    "@things-factory/shell": "^7.0.1-alpha.0",
+    "@things-factory/utils": "^7.0.1-alpha.0",
     "async-mqtt": "^2.5.0",
     "chance": "^1.1.11",
     "cross-fetch": "^3.0.4",
@@ -41,7 +41,7 @@
     "node-fetch": "^2.6.0",
     "promise-socket": "^7.0.0",
     "readline": "^1.3.0",
-    "vm2": "3.9.11"
+    "vm2": "^3.9.11"
   },
-  "gitHead": "b4981ea2721e7eaf4dbd618b6c77316ebc000ee5"
+  "gitHead": "d18cdb7648bd2003f11278ec7bc8df74edbd31fc"
 }

package/server/engine/connection-manager.ts

@@ -5,6 +5,7 @@ import { Domain, getRepository, pubsub, PubSubLogTransport } from '@things-facto
 
 import { Connection, ConnectionStatus } from '../service'
 import { Connector } from './types'
+import { ProxyConnector } from './connector/proxy-connector'
 
 const { combine, timestamp, splat, printf } = format
 const debug = require('debug')('things-factory:integration-base:connections')
@@ -17,7 +18,8 @@ const systemTimestamp = format((info, opts) => {
 
 export class ConnectionManager {
   private static connectors: { [propName: string]: Connector } = {}
-  private static connections = {}
+  private static connections: { [domainId: string]: { [name: string]: any } } = {}
+  private static entities = {}
   private static logFormat = printf(({ level, message, timestamp }) => {
     return `${timestamp} ${level}: ${message}`
   })
@@ -43,7 +45,7 @@ export class ConnectionManager {
     const CONNECTIONS = (
       await getRepository(Connection).find({
         where: { active: true },
-        relations: ['domain', 'creator', 'updater']
+        relations: ['domain', 'edge', 'creator', 'updater']
       })
     ).map(connection => {
       var params = {}
@@ -63,12 +65,21 @@ export class ConnectionManager {
     ConnectionManager.logger.info('Initializing ConnectionManager...')
 
     return await Promise.all(
-      Object.keys(ConnectionManager.connectors).map(type => {
-        var connector = ConnectionManager.connectors[type]
+      [...Object.keys(ConnectionManager.connectors), 'proxy-connector'].map(type => {
+        const connector = 'proxy-connector' ? ProxyConnector.instance : ConnectionManager.getConnector(type)
+
         ConnectionManager.logger.info(`Connector '${type}' started to ready`)
 
         return connector
-          .ready(CONNECTIONS.filter(connection => connection.type == type) as any)
+          .ready(
+            CONNECTIONS.filter(connection => {
+              if (type == 'proxy-connector') {
+                return !!connection.edge
+              } else {
+                return !connection.edge && connection.type == type
+              }
+            }) as any
+          )
           .catch(error => {
             ConnectionManager.logger.error(error.message)
           })
@@ -103,6 +114,14 @@ export class ConnectionManager {
     delete ConnectionManager.connectors[type]
   }
 
+  static getConnections() {
+    return ConnectionManager.connections
+  }
+
+  static getEntities() {
+    return ConnectionManager.entities
+  }
+
   static getConnectionInstance(connection: Connection): any {
     const { domain, name } = connection
     return ConnectionManager.connections[domain.id]?.[name]
@@ -119,6 +138,11 @@ export class ConnectionManager {
     return connection
   }
 
+  static getConnectionInstanceEntityByName(domain: Domain, name: string): any {
+    const entities = ConnectionManager.entities[domain.id]
+    return entities?.[name]
+  }
+
   static getConnectionInstances(domain: Domain): { [connectionName: string]: any } {
     const connections = ConnectionManager.connections[domain.id]
 
@@ -127,6 +151,14 @@ export class ConnectionManager {
     }
   }
 
+  static getConnectionInstanceEntities(domain: Domain): { [connectionName: string]: any } {
+    const connections = ConnectionManager.entities[domain.id]
+
+    return {
+      ...connections
+    }
+  }
+
   static addConnectionInstance(connection: Connection, instance: any) {
     const { domain, name } = connection
 
@@ -135,7 +167,13 @@ export class ConnectionManager {
       connections = ConnectionManager.connections[domain.id] = {}
     }
 
+    var entities = ConnectionManager.entities[domain.id]
+    if (!entities) {
+      entities = ConnectionManager.entities[domain.id] = {}
+    }
+
     connections[name] = instance
+    entities[name] = connection
 
     ConnectionManager.publishState(connection, ConnectionStatus.CONNECTED)
     debug('add-connection', domain.subdomain, name)
@@ -144,6 +182,8 @@ export class ConnectionManager {
   static removeConnectionInstance(connection: Connection): any {
     const { domain, name } = connection
     var connections = ConnectionManager.connections[domain.id]
+    var entities = ConnectionManager.entities[domain.id]
+
     var instance = connections?.[name]
 
     if (!connections || !instance) {
@@ -152,6 +192,7 @@ export class ConnectionManager {
     }
 
     delete connections[name]
+    delete entities[name]
 
     ConnectionManager.publishState(connection, ConnectionStatus.DISCONNECTED)
     debug('remove-connection', `'${name}' connection is removed from domain '${domain.subdomain}'`)
@@ -159,8 +200,8 @@ export class ConnectionManager {
     return instance
   }
 
-  static publishState(connection: Connection, state) {
-    const { domain, id, name, description, type } = connection
+  private static async publishState(connection: Connection, state) {
+    const { domain, id, name, description, type, edge } = connection
 
     pubsub.publish('connection-state', {
       connectionState: {
@@ -169,6 +210,7 @@ export class ConnectionManager {
         name,
         description,
         type,
+        edge,
         state,
         timestamp: new Date()
       }

package/server/engine/connector/graphql-connector.ts

@@ -23,10 +23,6 @@ const defaultOptions: any = {
   }
 }
 
-const cache = new InMemoryCache({
-  addTypename: false
-})
-
 export class GraphqlConnector implements Connector {
   async ready(connectionConfigs: InputConnection[]) {
     await Promise.all(connectionConfigs.map(this.connect.bind(this)))
@@ -35,12 +31,12 @@ export class GraphqlConnector implements Connector {
   }
 
   async connect(connection: InputConnection) {
-    var {
+    const {
       endpoint: uri,
       params: { authClient }
     } = connection
 
-    var ERROR_HANDLER: any = ({ graphQLErrors, networkError }) => {
+    const ERROR_HANDLER: any = ({ graphQLErrors, networkError }) => {
       if (graphQLErrors)
         graphQLErrors.map(({ message, locations, path }) => {
           ConnectionManager.logger.error(`[GraphQL error] Message: ${message}, Location: ${locations}, Path: ${path}`)
@@ -65,6 +61,10 @@ export class GraphqlConnector implements Connector {
       return forward(operation)
     })
 
+    const cache = new InMemoryCache({
+      addTypename: false
+    })
+
     ConnectionManager.addConnectionInstance(
       connection,
       new ApolloClient({
@@ -81,13 +81,11 @@ export class GraphqlConnector implements Connector {
       })
     )
 
-    ConnectionManager.logger.info(
-      `graphql-connector connection(${connection.name}:${connection.endpoint}) is connected`
-    )
+    ConnectionManager.logger.info(`graphql-connector connection(${connection.name}:${connection.endpoint}) is connected`)
   }
 
   async disconnect(connection: InputConnection) {
-    var client = ConnectionManager.getConnectionInstance(connection)
+    const client = ConnectionManager.getConnectionInstance(connection)
     client.stop()
     ConnectionManager.removeConnectionInstance(connection)
 

package/server/engine/connector/operato-connector.ts

@@ -3,7 +3,6 @@ import 'cross-fetch/polyfill'
 import { ApolloClient, InMemoryCache, createHttpLink, split } from '@apollo/client/core'
 import { setContext } from '@apollo/client/link/context'
 
-// for subscription
 import WebSocket from 'ws'
 import { createClient } from 'graphql-ws'
 import { GraphQLWsLink } from '@apollo/client/link/subscriptions'
@@ -20,7 +19,7 @@ import { ScenarioInstance } from '../../service/scenario-instance/scenario-insta
 import { getRepository, GraphqlLocalClient, Domain } from '@things-factory/shell'
 import { User, checkPermission } from '@things-factory/auth-base'
 
-const debug = require('debug')('things-factory:integration-base:operato-connector-subscription')
+const debug = require('debug')('things-factory:integration-base:operato-connector')
 
 const defaultOptions: any = {
   watchQuery: {
@@ -36,10 +35,6 @@ const defaultOptions: any = {
   }
 }
 
-const cache = new InMemoryCache({
-  addTypename: false
-})
-
 export const GRAPHQL_URI = '/graphql'
 export const SUBSCRIPTION_URI = GRAPHQL_URI
 
@@ -48,7 +43,6 @@ interface SubscriberData {
   scenario: any
   subscriptionObserver: any
 }
-;``
 
 export class OperatoConnector implements Connector {
   private context: any
@@ -56,11 +50,11 @@ export class OperatoConnector implements Connector {
   async ready(connectionConfigs: InputConnection[]) {
     await Promise.all(connectionConfigs.map(this.connect.bind(this)))
 
-    ConnectionManager.logger.info('graphql-connector connections are ready')
+    ConnectionManager.logger.info('operato-connector connections are ready')
   }
 
   async connect(connection: InputConnection) {
-    var {
+    const {
       endpoint: uri,
       params: { authKey, domain, subscriptionHandlers = {} }
     } = connection
@@ -69,7 +63,7 @@ export class OperatoConnector implements Connector {
       throw new Error('some connection paramter missing.')
     }
 
-    var domainOwner = await getRepository(User).findOne({
+    const domainOwner = await getRepository(User).findOne({
       where: {
         id: connection.domain.owner
       }
@@ -125,20 +119,24 @@ export class OperatoConnector implements Connector {
       }).concat(httpLink)
     )
 
-    var client = new ApolloClient({
+    const cache = new InMemoryCache({
+      addTypename: false
+    })
+
+    const client = new ApolloClient({
       defaultOptions,
       cache,
       link: splitLink
     })
 
-    var subscriptions: SubscriberData[] = []
+    const subscriptions: SubscriberData[] = []
     Object.keys(subscriptionHandlers).forEach(async tag => {
       if (!tag || !subscriptionHandlers[tag]) return
 
-      let scenarioName = subscriptionHandlers[tag]
+      const scenarioName = subscriptionHandlers[tag]
 
       // fetch a scenario
-      var selectedScenario = await getRepository(Scenario).findOne({
+      const selectedScenario = await getRepository(Scenario).findOne({
         where: {
           name: scenarioName
         },
@@ -156,7 +154,7 @@ export class OperatoConnector implements Connector {
         `
       })
 
-      var subscriptionObserver = subscription.subscribe({
+      const subscriptionObserver = subscription.subscribe({
         next: async data => {
           debug('received pubsub msg.:', data?.data)
           await this.runScenario(subscriptions, data?.data?.data)
@@ -169,9 +167,7 @@ export class OperatoConnector implements Connector {
         }
       })
 
-      ConnectionManager.logger.info(
-        `(${connection.name}:${connection.endpoint}) subscription closed flag: ${subscriptionObserver.closed}`
-      )
+      ConnectionManager.logger.info(`(${connection.name}:${connection.endpoint}) subscription closed flag: ${subscriptionObserver.closed}`)
 
       subscriptions.push({
         tag,
@@ -184,19 +180,17 @@ export class OperatoConnector implements Connector {
     client['subscriptions'] = subscriptions
     ConnectionManager.addConnectionInstance(connection, client)
 
-    ConnectionManager.logger.info(
-      `graphql-connector connection(${connection.name}:${connection.endpoint}) is connected`
-    )
+    ConnectionManager.logger.info(`operato-connector connection(${connection.name}:${connection.endpoint}) is connected`)
   }
 
   async disconnect(connection: InputConnection) {
-    var client = ConnectionManager.getConnectionInstance(connection)
-    let subscriptions: SubscriberData[] = client['subscriptions']
+    const client = ConnectionManager.getConnectionInstance(connection)
+    const subscriptions: SubscriberData[] = client['subscriptions']
     subscriptions.forEach(subscription => subscription.subscriptionObserver.unsubscribe())
     client.stop()
     ConnectionManager.removeConnectionInstance(connection)
 
-    ConnectionManager.logger.info(`graphql-connector connection(${connection.name}) is disconnected`)
+    ConnectionManager.logger.info(`operato-connector connection(${connection.name}) is disconnected`)
   }
 
   async runScenario(subscriptions: SubscriberData[], variables: any): Promise<ScenarioInstance> {
@@ -207,23 +201,19 @@ export class OperatoConnector implements Connector {
       throw new Error(`tag is invalid - ${tag}`)
     }
 
-    var scenario = subscriptions.find(subscription => subscription.tag === tag)?.scenario
+    const scenario = subscriptions.find(subscription => subscription.tag === tag)?.scenario
     if (!scenario) {
       throw new Error(`scenario is not found - ${tag}`)
     }
 
     if (!(await checkPermission(scenario.privilege, user, domain, unsafeIP, prohibitedPrivileges))) {
       const { category, privilege } = scenario.privilege || {}
-      throw new Error(
-        `Unauthorized! ${
-          category && privilege ? category + ':' + privilege + ' privilege' : 'ownership granted'
-        } required`
-      )
+      throw new Error(`Unauthorized! ${category && privilege ? category + ':' + privilege + ' privilege' : 'ownership granted'} required`)
     }
 
     /* create a scenario instance */
-    let instanceName = scenario.name + '-' + String(Date.now())
-    var instance = new ScenarioInstance(instanceName, scenario, {
+    const instanceName = scenario.name + '-' + String(Date.now())
+    const instance = new ScenarioInstance(instanceName, scenario, {
       user,
       domain,
       variables,

package/server/engine/connector/proxy-connector.ts

@@ -0,0 +1,53 @@
+import { ConnectionManager } from '../connection-manager'
+import { Connector } from '../types'
+import { InputConnection } from '../../service/connection/connection-type'
+import { connectConnections, disconnectConnections } from '../edge-client'
+
+/**
+ * This connector is a proxy connector installed on the edge server to manage connections from the host.
+ * It interacts with connections established on the edge server and provides synchronization functionality.
+ */
+export class ProxyConnector implements Connector {
+  public static instance = new ProxyConnector()
+
+  async ready(connectionConfigs: InputConnection[]) {
+    await Promise.all(connectionConfigs.map(this.connect.bind(this)))
+
+    ConnectionManager.logger.info('proxy-connector connections are ready')
+  }
+
+  async connect(connection: InputConnection) {
+    // TODO 원래 커넥션과 에지설정을 참고하여, 에지 서버로 CONNECT/DISCONNECT 명령을 보낸다.
+    const proxy = {
+      disconnect: async () => {
+        ConnectionManager.logger.info('[proxy-connector] trying disconnect')
+        await disconnectConnections([connection])
+      }
+    }
+
+    await connectConnections([connection])
+
+    ConnectionManager.addConnectionInstance(connection, proxy)
+
+    ConnectionManager.logger.info(`proxy-connector connection(${connection.name}:${connection.endpoint}) is connected`)
+  }
+
+  async disconnect(connection: InputConnection) {
+    const proxy = ConnectionManager.removeConnectionInstance(connection)
+    await proxy.disconnect()
+
+    ConnectionManager.logger.info(`proxy-connector connection(${connection.name}) is disconnected`)
+  }
+
+  get parameterSpec() {
+    return []
+  }
+
+  get taskPrefixes() {
+    return []
+  }
+
+  get description() {
+    return 'Operato Proxy Connector'
+  }
+}