@things-factory/shell 8.0.0-beta.9 → 8.0.0

package/server/utils/list-params-converter.ts

@@ -0,0 +1,200 @@
+import { Between, Equal, FindOperator, ILike, In, IsNull, Like, Not, Raw } from 'typeorm'
+
+import { Filter, ListParam, Pagination, Sorting } from '../service/common-types'
+import { Domain } from '../service/domain/domain'
+import { adjustFilters } from './list-param-adjuster'
+
+const OPERATION_FUNCTION_MAP: { [operator: string]: (value: any) => FindOperator<any> } = {
+  search: value => ILike(value),
+  eq: value => Equal(value),
+  noteq: value => Not(Equal(value)),
+  like: value => Like(value),
+  i_like: value => ILike(value),
+  nlike: value => Not(Like(value)),
+  i_nlike: value => Not(ILike(value)),
+  lt: value => Raw(alias => `${alias} < ${typeof value === 'string' ? "'" + value + "'" : value}`),
+  gt: value => Raw(alias => `${alias} > ${typeof value === 'string' ? "'" + value + "'" : value}`),
+  lte: value => Raw(alias => `${alias} <= ${typeof value === 'string' ? "'" + value + "'" : value}`),
+  gte: value => Raw(alias => `${alias} >= ${typeof value === 'string' ? "'" + value + "'" : value}`),
+  in: value => In(value),
+  notin: value => Not(In(value)),
+  is_null: () => IsNull(),
+  is_not_null: () => Not(IsNull()),
+  is_false: () => Raw(alias => `${alias} IS FALSE`),
+  in_true: () => Raw(alias => `${alias} IS TRUE`),
+  is_not_true: () => Raw(alias => `${alias} IS NOT TRUE`),
+  is_present: () => Raw(alias => `${alias} IS PRESENT`),
+  is_blank: () => Raw(alias => `${alias} IS BLANK`),
+  is_empty_num_id: () => Raw(alias => `${alias} IS EMPTY NUMERIC ID`),
+  between: value => Between(value[0], value[1])
+}
+
+/**
+ * Get the TypeORM FindOperator function for a given filter.
+ * @param {Filter} filter - The filter object containing operator and value.
+ * @returns {FindOperator<any>} - The corresponding FindOperator function.
+ */
+function getOperatorFunction({ operator, value }: Filter): FindOperator<any> {
+  return OPERATION_FUNCTION_MAP[operator](value)
+}
+
+/**
+ * Create pagination parameters for a TypeORM query.
+ * @param {Pagination} pagination - The pagination object.
+ * @returns {{ skip?: number; take?: number }} - The pagination parameters.
+ */
+function makePaginationParams(pagination: Pagination): { skip?: number; take?: number } {
+  var result = {} as { skip?: number; take?: number }
+  if (pagination) {
+    var { page = 0, limit = 0 } = pagination
+    var skip = 0
+    var take = 0
+
+    if (limit > 0) {
+      skip = Math.max(page - 1, 0) * limit
+      take = limit
+      Object.assign(result, {
+        skip,
+        take
+      })
+    }
+  }
+
+  return result
+}
+
+/**
+ * Create sorting parameters for a TypeORM query.
+ * @param {Sorting[]} sortings - The array of sorting objects.
+ * @returns {{ order?: { [name: string]: 'DESC' | 'ASC' } }} - The sorting parameters.
+ */
+function makeSortingParams(sortings: Sorting[]): { order?: { [name: string]: 'DESC' | 'ASC' } } {
+  var result = {} as { order?: { [name: string]: 'DESC' | 'ASC' } }
+  if (sortings) {
+    var order = {} as { [name: string]: 'DESC' | 'ASC' }
+    sortings.forEach(s => {
+      order[s.name] = s.desc ? 'DESC' : 'ASC'
+    })
+
+    Object.assign(result, {
+      order
+    })
+  }
+
+  return result
+}
+
+/**
+ * Create filter parameters for a TypeORM query.
+ * @param {Filter[]} filters - The array of filter objects.
+ * @param {string[]} searchables - The array of searchable field names.
+ * @returns {{ where: { [name: string]: FindOperator<any> } | { [name: string]: FindOperator<any> }[] }} - The filter parameters.
+ */
+function makeFilterParams(
+  filters: Filter[],
+  searchables?: string[]
+): {
+  where: { [name: string]: FindOperator<any> } | { [name: string]: FindOperator<any> }[]
+} {
+  /* for where AND clauses */
+  const columnFilters =
+    filters?.filter(filter => {
+      if (filter.operator === 'search') {
+        return false
+      }
+      if (filter.operator.toLowerCase().includes('like') && (!searchables || !searchables.includes(filter.name))) {
+        return false
+      }
+      return true
+    }) || []
+
+  const searchFilters =
+    searchables instanceof Array
+      ? filters?.filter(filter => {
+          if (filter.operator !== 'search') {
+            return false
+          }
+          if (!searchables.includes(filter.name)) {
+            console.warn('"searchables" setting is required for like searches with a heavy database query load', filter.name)
+            return false
+          }
+          return true
+        }) || []
+      : []
+
+  const columnWhere = columnFilters.reduce((where, f) => {
+    where[f.name] = getOperatorFunction(f)
+    return where
+  }, {} as { [name: string]: FindOperator<any> })
+
+  if (searchFilters.length === 0) {
+    return {
+      where: columnWhere
+    }
+  }
+
+  /* for fulltext searching ... OR-AND composition */
+  const searchWheres = searchFilters.map(f => {
+    return {
+      [f.name]: getOperatorFunction(f),
+      ...columnWhere
+    }
+  })
+
+  return {
+    where: searchWheres
+  }
+}
+
+/**
+ * Convert ListParam object to TypeORM query parameters.
+ * @param {ListParam} params - The ListParam object containing pagination, sorting, and filtering options.
+ * @param {string | { domain?: string | Domain; searchables?: string[] }} options - Optional domain and searchables parameters.
+ * @returns {{ where?: { [name: string]: FindOperator<any> }; order?: { [name: string]: 'DESC' | 'ASC' }; skip?: number; take?: number }} - The TypeORM query parameters.
+ */
+export function convertListParams(
+  params: ListParam,
+  options?:
+    | string
+    | {
+        domain?: string | Domain
+        searchables?: string[]
+      }
+): {
+  where?: { [name: string]: FindOperator<any> }
+  order?: {
+    [name: string]: 'DESC' | 'ASC'
+  }
+  skip?: number
+  take?: number
+} {
+  var domainId: string | undefined
+
+  if (options) {
+    if (typeof options === 'string' /* for 하위 호환성 */) {
+      var domainId = options
+    } else {
+      var { domain, searchables } = options
+      var domainId = typeof domain === 'string' ? domain : domain?.id
+    }
+  }
+
+  var { pagination, filters = [], sortings } = params
+  var result = {}
+
+  if (domainId) {
+    filters = adjustFilters(filters, [
+      {
+        name: 'domain',
+        operator: 'eq',
+        value: domainId
+      }
+    ])
+  }
+
+  if (pagination) Object.assign(result, makePaginationParams(pagination))
+  if (sortings) Object.assign(result, makeSortingParams(sortings))
+  if (filters) Object.assign(result, makeFilterParams(filters, searchables))
+
+  return result
+}

package/server/utils/list-query-builder.ts

@@ -0,0 +1,120 @@
+import { Brackets } from 'typeorm'
+
+import { buildCondition } from './condition-builder'
+import { Filter, ListParam, InheritedValueType } from '../service/common-types/list-param'
+
+/**
+ * @deprecated This function is recommended to be replaced with the `getQueryBuilderFromListParams` function.
+ *
+ * Builds a TypeORM query using the provided parameters to filter, paginate, and sort the data.
+ *
+ * @param {QueryBuilder} queryBuilder - The TypeORM query builder to build the query on.
+ * @param {ListParam} params - The list parameters to apply to the query.
+ * @param {Object} context - The context object, typically containing information about the user's domain.
+ * @param {boolean|Object} options - Additional options for the query builder.
+ * @param {boolean} options.domainRef - Indicates whether to include domain reference in the query.
+ * @param {string[]} options.searchables - An array of searchable field names.
+ */
+export const buildQuery = function (
+  queryBuilder: any,
+  params: ListParam,
+  context: any,
+  options?:
+    | boolean
+    | {
+        domainRef?: boolean
+        searchables?: string[]
+      }
+) {
+  /* default value of domainRef is 'true' */
+  var domainRef = typeof options === 'boolean' ? options : true
+
+  /* for backwards compatibility of function spec */
+  if (typeof options === 'object') {
+    var { domainRef = true, searchables } = options
+  }
+
+  const columnFilters: Filter[] =
+    params.filters?.filter(filter => {
+      if (filter.operator === 'search') {
+        return false
+      }
+      if (filter.operator.toLowerCase().includes('like') && (!searchables || !searchables.includes(filter.name))) {
+        console.warn('"searchables" setting is required for like searches with a heavy database query load', filter.name)
+        return false
+      }
+      return true
+    }) || []
+
+  const searchFilters =
+    searchables instanceof Array
+      ? params.filters?.filter(filter => {
+          if (filter.operator !== 'search') {
+            return false
+          }
+          if (!searchables.includes(filter.name)) {
+            console.warn('"searchables" setting is required for like searches with a heavy database query load', filter.name)
+            return false
+          }
+          return true
+        }) || []
+      : []
+
+  const pagination = params.pagination
+  const sortings = params.sortings
+  const domain = context?.state.domain
+
+  if (columnFilters && columnFilters.length > 0) {
+    columnFilters.forEach(filter => {
+      const condition = buildCondition(queryBuilder.alias, filter.name, filter.operator, filter.value, filter.relation, Object.keys(queryBuilder.getParameters()).length)
+
+      if (condition?.clause) queryBuilder.andWhere(condition.clause)
+      if (condition?.parameters) queryBuilder.setParameters(condition.parameters)
+    })
+  }
+
+  if (searchFilters.length > 0) {
+    queryBuilder.andWhere(
+      new Brackets(qb => {
+        searchFilters.forEach((filter, index) => {
+          const clause = `${queryBuilder.alias}.${filter.name} LIKE :${filter.name}`
+          const parameters = { [filter.name]: filter.value }
+
+          index === 0 ? qb.where(clause, parameters) : qb.orWhere(clause, parameters)
+        })
+      })
+    )
+  }
+
+  if (domainRef) {
+    const inherited = params?.inherited || InheritedValueType.None
+
+    if (!inherited || inherited == InheritedValueType.None) {
+      queryBuilder.andWhere(`${queryBuilder.alias}.domain = :domain`, { domain: domain.id })
+    } else if (inherited == InheritedValueType.Include) {
+      queryBuilder.andWhere(`${queryBuilder.alias}.domain In(:...domains)`, {
+        domains: [domain.id, domain.parentId].filter(Boolean)
+      })
+    } else if (inherited == InheritedValueType.Only) {
+      queryBuilder.andWhere(`${queryBuilder.alias}.domain = :domain`, { domain: domain.parentId || 'Impossible' })
+    } else {
+      queryBuilder.andWhere(`${queryBuilder.alias}.domain = :domain`, { domain: 'Impossible' })
+    }
+  }
+
+  if (pagination && pagination.page > 0 && pagination.limit > 0) {
+    queryBuilder.skip(pagination.limit * (pagination.page - 1))
+    queryBuilder.take(pagination.limit)
+  }
+
+  if (sortings && sortings.length > 0) {
+    sortings.forEach((sorting, index) => {
+      const sortField = sorting.name.split('.').length > 1 ? sorting.name : `${queryBuilder.alias}.${sorting.name}`
+      if (index === 0) {
+        queryBuilder.orderBy(sortField, sorting.desc ? 'DESC' : 'ASC')
+      } else {
+        queryBuilder.addOrderBy(sortField, sorting.desc ? 'DESC' : 'ASC')
+      }
+    })
+  }
+}

package/server/utils/publish-progress.ts

@@ -0,0 +1,23 @@
+import { pubsub } from '../pubsub'
+
+/**
+ * Publishes a progress update message to the 'data' channel in the Pub/Sub system.
+ *
+ * @param {Object} param - The progress update parameters.
+ * @param {string} param.domain - The domain or category of the progress update.
+ * @param {string} param.tag - The tag or identifier for the progress update.
+ * @param {number} param.progress - The progress value indicating the completion percentage.
+ * @param {string} param.message - A message or description of the progress update.
+ */
+export function publishProgress({ domain, tag, progress, message }) {
+  pubsub.publish('data', {
+    data: {
+      domain,
+      tag,
+      data: {
+        progress,
+        message
+      }
+    }
+  })
+}

package/dist-server/process-cleaner.d.ts

@@ -1 +0,0 @@
-export declare function setupProcessExitHandlers(): void;

package/dist-server/process-cleaner.js

@@ -1,92 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.setupProcessExitHandlers = setupProcessExitHandlers;
-const tslib_1 = require("tslib");
-const fs = tslib_1.__importStar(require("fs"));
-const path = tslib_1.__importStar(require("path"));
-const os = tslib_1.__importStar(require("os"));
-const child_process_1 = require("child_process");
-const TEMP_DIR = os.tmpdir(); // OS별 임시 디렉토리 사용
-const PID_FILE = path.join(TEMP_DIR, `puppeteer-${process.pid}.pid`);
-// 🛠 **이전에 실행된 유령 프로세스 정리**
-function cleanupZombieProcesses() {
-    if (fs.existsSync(PID_FILE)) {
-        const pid = fs.readFileSync(PID_FILE, 'utf8').trim();
-        if (pid) {
-            console.log(`Cleaning up old Puppeteer process with PID: ${pid}`);
-            if (os.platform() === 'win32') {
-                (0, child_process_1.exec)(`taskkill /F /PID ${pid}`, (err, stdout, stderr) => {
-                    if (err)
-                        console.error(`Failed to kill process ${pid} on Windows:`, err);
-                    else
-                        console.log(`Process ${pid} killed on Windows.`);
-                });
-            }
-            else {
-                try {
-                    process.kill(Number(pid), 'SIGKILL');
-                    console.log(`Process ${pid} killed on Unix-like OS.`);
-                }
-                catch (err) {
-                    console.error(`Failed to kill process ${pid}:`, err);
-                }
-            }
-        }
-        fs.unlinkSync(PID_FILE); // 프로세스 종료 후 PID 파일 삭제
-    }
-}
-// **애플리케이션 시작 시 이전 프로세스 정리**
-cleanupZombieProcesses();
-// **현재 프로세스의 PID 저장**
-fs.writeFileSync(PID_FILE, process.pid.toString(), { flag: 'w' });
-async function cleanup() {
-    try {
-        if (fs.existsSync(PID_FILE)) {
-            fs.unlinkSync(PID_FILE); // 종료 시 PID 파일 삭제
-        }
-        console.log('Cleaning up resources...');
-        // **프로세스가 존재하는지 확인 후 종료 시도**
-        try {
-            process.kill(-process.pid, 'SIGTERM'); // 프로세스 그룹 전체 종료
-            console.log(`Successfully killed process group (-${process.pid})`);
-        }
-        catch (err) {
-            if (err.code === 'ESRCH') {
-                console.warn(`Warning: Process group (-${process.pid}) already terminated.`);
-            }
-            else {
-                console.error('Cleanup error:', err);
-            }
-        }
-    }
-    catch (err) {
-        console.error('Cleanup error:', err);
-    }
-}
-function setupProcessExitHandlers() {
-    process.once('exit', async () => {
-        console.log('Parent process is exiting, killing all child processes...');
-        await cleanup();
-    });
-    process.once('SIGINT', async () => {
-        console.log('\nReceived SIGINT, cleaning up...');
-        await cleanup();
-        process.exit(0);
-    });
-    process.once('SIGTERM', async () => {
-        console.log('\nReceived SIGTERM, cleaning up...');
-        await cleanup();
-        process.exit(0);
-    });
-    process.once('uncaughtException', async (err) => {
-        console.error('\nUncaught Exception:', err);
-        await cleanup();
-        process.exit(1);
-    });
-    process.once('unhandledRejection', async (reason) => {
-        console.error('\nUnhandled Rejection:', reason);
-        await cleanup();
-        process.exit(1);
-    });
-}
-//# sourceMappingURL=process-cleaner.js.map

package/dist-server/process-cleaner.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"process-cleaner.js","sourceRoot":"","sources":["../server/process-cleaner.ts"],"names":[],"mappings":";;AAiEA,4DA6BC;;AA9FD,+CAAwB;AACxB,mDAA4B;AAC5B,+CAAwB;AACxB,iDAAoC;AAEpC,MAAM,QAAQ,GAAG,EAAE,CAAC,MAAM,EAAE,CAAA,CAAC,iBAAiB;AAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,OAAO,CAAC,GAAG,MAAM,CAAC,CAAA;AAEpE,4BAA4B;AAC5B,SAAS,sBAAsB;IAC7B,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAA;QAEpD,IAAI,GAAG,EAAE,CAAC;YACR,OAAO,CAAC,GAAG,CAAC,+CAA+C,GAAG,EAAE,CAAC,CAAA;YAEjE,IAAI,EAAE,CAAC,QAAQ,EAAE,KAAK,OAAO,EAAE,CAAC;gBAC9B,IAAA,oBAAI,EAAC,oBAAoB,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;oBACtD,IAAI,GAAG;wBAAE,OAAO,CAAC,KAAK,CAAC,0BAA0B,GAAG,cAAc,EAAE,GAAG,CAAC,CAAA;;wBACnE,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,qBAAqB,CAAC,CAAA;gBACvD,CAAC,CAAC,CAAA;YACJ,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC;oBACH,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC,CAAA;oBACpC,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,0BAA0B,CAAC,CAAA;gBACvD,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,OAAO,CAAC,KAAK,CAAC,0BAA0B,GAAG,GAAG,EAAE,GAAG,CAAC,CAAA;gBACtD,CAAC;YACH,CAAC;QACH,CAAC;QAED,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAA,CAAC,sBAAsB;IAChD,CAAC;AACH,CAAC;AAED,6BAA6B;AAC7B,sBAAsB,EAAE,CAAA;AAExB,sBAAsB;AACtB,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAA;AAEjE,KAAK,UAAU,OAAO;IACpB,IAAI,CAAC;QACH,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAA,CAAC,iBAAiB;QAC3C,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAA;QAEvC,6BAA6B;QAC7B,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA,CAAC,gBAAgB;YACtD,OAAO,CAAC,GAAG,CAAC,uCAAuC,OAAO,CAAC,GAAG,GAAG,CAAC,CAAA;QACpE,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBACzB,OAAO,CAAC,IAAI,CAAC,4BAA4B,OAAO,CAAC,GAAG,uBAAuB,CAAC,CAAA;YAC9E,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAA;YACtC,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAA;IACtC,CAAC;AACH,CAAC;AAED,SAAgB,wBAAwB;IACtC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE;QAC9B,OAAO,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAA;QACxE,MAAM,OAAO,EAAE,CAAA;IACjB,CAAC,CAAC,CAAA;IAEF,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;QAChC,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAA;QAChD,MAAM,OAAO,EAAE,CAAA;QACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC,CAAC,CAAA;IAEF,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;QACjC,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAA;QACjD,MAAM,OAAO,EAAE,CAAA;QACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC,CAAC,CAAA;IAEF,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,KAAK,EAAC,GAAG,EAAC,EAAE;QAC5C,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAA;QAC3C,MAAM,OAAO,EAAE,CAAA;QACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC,CAAC,CAAA;IAEF,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,KAAK,EAAC,MAAM,EAAC,EAAE;QAChD,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,MAAM,CAAC,CAAA;QAC/C,MAAM,OAAO,EAAE,CAAA;QACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC,CAAC,CAAA;AACJ,CAAC","sourcesContent":["import * as fs from 'fs'\nimport * as path from 'path'\nimport * as os from 'os'\nimport { exec } from 'child_process'\n\nconst TEMP_DIR = os.tmpdir() // OS별 임시 디렉토리 사용\nconst PID_FILE = path.join(TEMP_DIR, `puppeteer-${process.pid}.pid`)\n\n// 🛠 **이전에 실행된 유령 프로세스 정리**\nfunction cleanupZombieProcesses() {\n  if (fs.existsSync(PID_FILE)) {\n    const pid = fs.readFileSync(PID_FILE, 'utf8').trim()\n\n    if (pid) {\n      console.log(`Cleaning up old Puppeteer process with PID: ${pid}`)\n\n      if (os.platform() === 'win32') {\n        exec(`taskkill /F /PID ${pid}`, (err, stdout, stderr) => {\n          if (err) console.error(`Failed to kill process ${pid} on Windows:`, err)\n          else console.log(`Process ${pid} killed on Windows.`)\n        })\n      } else {\n        try {\n          process.kill(Number(pid), 'SIGKILL')\n          console.log(`Process ${pid} killed on Unix-like OS.`)\n        } catch (err) {\n          console.error(`Failed to kill process ${pid}:`, err)\n        }\n      }\n    }\n\n    fs.unlinkSync(PID_FILE) // 프로세스 종료 후 PID 파일 삭제\n  }\n}\n\n// **애플리케이션 시작 시 이전 프로세스 정리**\ncleanupZombieProcesses()\n\n// **현재 프로세스의 PID 저장**\nfs.writeFileSync(PID_FILE, process.pid.toString(), { flag: 'w' })\n\nasync function cleanup() {\n  try {\n    if (fs.existsSync(PID_FILE)) {\n      fs.unlinkSync(PID_FILE) // 종료 시 PID 파일 삭제\n    }\n\n    console.log('Cleaning up resources...')\n\n    // **프로세스가 존재하는지 확인 후 종료 시도**\n    try {\n      process.kill(-process.pid, 'SIGTERM') // 프로세스 그룹 전체 종료\n      console.log(`Successfully killed process group (-${process.pid})`)\n    } catch (err: any) {\n      if (err.code === 'ESRCH') {\n        console.warn(`Warning: Process group (-${process.pid}) already terminated.`)\n      } else {\n        console.error('Cleanup error:', err)\n      }\n    }\n  } catch (err) {\n    console.error('Cleanup error:', err)\n  }\n}\n\nexport function setupProcessExitHandlers() {\n  process.once('exit', async () => {\n    console.log('Parent process is exiting, killing all child processes...')\n    await cleanup()\n  })\n\n  process.once('SIGINT', async () => {\n    console.log('\\nReceived SIGINT, cleaning up...')\n    await cleanup()\n    process.exit(0)\n  })\n\n  process.once('SIGTERM', async () => {\n    console.log('\\nReceived SIGTERM, cleaning up...')\n    await cleanup()\n    process.exit(0)\n  })\n\n  process.once('uncaughtException', async err => {\n    console.error('\\nUncaught Exception:', err)\n    await cleanup()\n    process.exit(1)\n  })\n\n  process.once('unhandledRejection', async reason => {\n    console.error('\\nUnhandled Rejection:', reason)\n    await cleanup()\n    process.exit(1)\n  })\n}\n"]}