refactor: 자동 생성된 preload 타입 개선

Author: frontend-leehaneul

package.json

@@ -25,9 +25,9 @@
     "electron-log": "^5.3.4",
     "electron-store": "^8",
     "electron-updater": "^6.6.2",
+    "es-toolkit": "^1.36.0",
     "i18next": "^25.0.1",
     "jsonc-parser": "^3.3.1",
-    "lodash": "^4.17.21",
     "path-to-regexp": "^8.2.0",
     "reflect-metadata": "^0.2.2",
     "rxjs": "^7.8.2",
@@ -37,7 +37,6 @@
     "@swc/core": "^1.11.22",
     "@trivago/prettier-plugin-sort-imports": "^5.2.2",
     "@types/auto-launch": "^5.0.5",
-    "@types/lodash": "^4.17.16",
     "@types/node": "^22.15.2",
     "@types/react": "^19.1.2",
     "@types/react-dom": "^19.1.2",
@@ -59,6 +58,7 @@
     "react-i18next": "^15.5.1",
     "react-router-dom": "^7.5.2",
     "swr": "^2.3.3",
+    "type-fest": "^4.40.1",
     "typescript": "^5.8.3",
     "vite": "^6.3.3"
   }

pnpm-lock.yaml

@@ -2,18 +2,24 @@ import { Injectable } from '@nestjs/common'
 
 import { ConfigService } from '@main/modules/config/config.service'
 import type { ConfigStoreValues } from '@main/modules/config/config.store'
-import { IPCHandle } from '@main/modules/electron/decorators/ipc-handle.decorator'
+import { IPCHandler } from '@main/modules/electron/decorators/ipc-handler.decorator'
 
 @Injectable()
 export class ConfigController {
   constructor(private readonly configService: ConfigService) {}
 
-  @IPCHandle()
+  /**
+   * 설정 값을 가져옵니다.
+   */
+  @IPCHandler()
   public getConfig() {
     return this.configService.getAll()
   }
 
-  @IPCHandle()
+  /**
+   * 설정 값을 저장합니다.
+   */
+  @IPCHandler()
   public setConfig(config: ConfigStoreValues) {
     return this.configService.setAll(config)
   }

src/main/modules/config/config.controller.ts

@@ -1,29 +1,41 @@
 import { Injectable } from '@nestjs/common'
 
 import { DeveloperService } from '@main/modules/developer/developer.service'
-import { IPCHandle } from '@main/modules/electron/decorators/ipc-handle.decorator'
+import { IPCHandler } from '@main/modules/electron/decorators/ipc-handler.decorator'
 
 @Injectable()
 export class DeveloperController {
   constructor(private readonly developerService: DeveloperService) {}
 
-  @IPCHandle()
+  /**
+   * 테스트 용도로 사용합니다.
+   */
+  @IPCHandler()
   public ping() {
     console.log('pong')
     return 'pong'
   }
 
-  @IPCHandle()
+  /**
+   * 저장소 경로를 가져옵니다.
+   */
+  @IPCHandler()
   public getStorePath() {
     return this.developerService.getStorePath()
   }
 
-  @IPCHandle()
+  /**
+   * 로그를 가져옵니다.
+   */
+  @IPCHandler()
   public getLogs() {
     return this.developerService.getLogs()
   }
 
-  @IPCHandle()
+  /**
+   * 로그 지우기
+   */
+  @IPCHandler()
   public clearLogs() {
     return this.developerService.clearLogs()
   }

src/main/modules/developer/developer.controller.ts

@@ -0,0 +1,13 @@
+export interface DeepLinkHandlerMetadata {
+  path: string
+  handler: (params: object) => void
+  target: any
+}
+
+export const DeepLinkHandlerMap = new Map<string, DeepLinkHandlerMetadata>()
+
+export function DeepLinkHandler(path: string) {
+  return function (target: any, _, descriptor: PropertyDescriptor) {
+    DeepLinkHandlerMap.set(path, { path, handler: descriptor.value, target: target.constructor })
+  }
+}

src/main/modules/electron/decorators/deep-link-handle.decorator.ts

@@ -0,0 +1,34 @@
+export interface IPCHandlerOptions {
+  channel?: string
+  type?: IPCHandlerType
+}
+
+export interface IPCHandlerMetadata {
+  channel: string
+  type: IPCHandlerType
+  handler: (...args: any[]) => any
+  target: any
+}
+
+export type IPCHandlerType = 'handle' | 'handleOnce' | 'on' | 'once'
+
+export const IPCHandlerMap = new Map<string, IPCHandlerMetadata>()
+
+/**
+ * Renderer > Main 방향의 IPC 데코레이터
+ *
+ * @description 렌더러에서 메인 프로세스에 있는 함수를 호출해야할 때 사용합니다.
+ * 메인 프로세스에서 메소드에 데코레이터를 붙이면 렌더러에서 해당 메소드를 호출할 수 있습니다.
+ */
+export function IPCHandler(options: IPCHandlerOptions = {}) {
+  return function (target: any, key: string, descriptor: PropertyDescriptor) {
+    const { channel = key, type = 'handle' } = options
+
+    IPCHandlerMap.set(channel, {
+      channel,
+      type,
+      handler: descriptor.value,
+      target: target.constructor,
+    })
+  }
+}