refactor: define routes and auto proxying routes

Author: louis-jan

core/src/api/index.ts

@@ -0,0 +1,60 @@
+/**
+ * App Route APIs
+ * @description Enum of all the routes exposed by the app
+ */
+export enum AppRoute {
+  setNativeThemeLight = 'setNativeThemeLight',
+  setNativeThemeDark = 'setNativeThemeDark',
+  setNativeThemeSystem = 'setNativeThemeSystem',
+  appDataPath = 'appDataPath',
+  appVersion = 'appVersion',
+  openExternalUrl = 'openExternalUrl',
+  relaunch = 'relaunch',
+  openAppDirectory = 'openAppDirectory',
+  openFileExplore = 'openFileExplorer',
+  getResourcePath = 'getResourcePath',
+}
+
+export enum AppEvent {
+  onAppUpdateDownloadUpdate = 'onAppUpdateDownloadUpdate',
+  onAppUpdateDownloadError = 'onAppUpdateDownloadError',
+  onAppUpdateDownloadSuccess = 'onAppUpdateDownloadSuccess',
+}
+
+export enum DownloadRoute {
+  downloadFile = 'downloadFile',
+  pauseDownload = 'pauseDownload',
+  resumeDownload = 'resumeDownload',
+  abortDownload = 'abortDownload',
+}
+
+export enum DownloadEvent {
+  onFileDownloadUpdate = 'onFileDownloadUpdate',
+  onFileDownloadError = 'onFileDownloadError',
+  onFileDownloadSuccess = 'onFileDownloadSuccess',
+}
+
+export enum ExtensionRoute {
+  installExtension = 'installExtension',
+  uninstallExtension = 'uninstallExtension',
+  getActiveExtensions = 'getActiveExtensions',
+  updateExtension = 'updateExtension',
+  invokeExtensionFunc = 'invokeExtensionFunc',
+  baseExtensions = 'baseExtensions',
+  extensionPath = 'extensionPath',
+}
+export enum FileSystemRoute {
+  deleteFile = 'deleteFile',
+  isDirectory = 'isDirectory',
+  getUserSpace = 'getUserSpace',
+  readFile = 'readFile',
+  writeFile = 'writeFile',
+  listFiles = 'listFiles',
+  appendFile = 'appendFile',
+  readLineByLine = 'readLineByLine',
+  mkdir = 'mkdir',
+  rmdir = 'rmdir',
+  copyFile = 'copyFile',
+  getResourcePath = 'getResourcePath',
+  exists = 'exists',
+}

core/src/index.ts

@@ -2,34 +2,39 @@
  * Export all types.
  * @module
  */
-export * from "./types/index";
+export * from './types/index'
+
+/**
+ * Export all routes
+ */
+export * from './api'
 
 /**
  * Export Core module
  * @module
  */
-export * from "./core";
+export * from './core'
 
 /**
  * Export Event module.
  * @module
  */
-export * from "./events";
+export * from './events'
 
 /**
  * Export Filesystem module.
  * @module
  */
-export * from "./fs";
+export * from './fs'
 
 /**
  * Export Extension module.
  * @module
  */
-export * from "./extension";
+export * from './extension'
 
 /**
  * Export all base extensions.
  * @module
  */
-export * from "./extensions/index";
+export * from './extensions/index'

electron/handlers/app.ts

@@ -1,17 +1,42 @@
-import { app, ipcMain, shell } from 'electron'
+import { app, ipcMain, shell, nativeTheme } from 'electron'
 import { ModuleManager } from './../managers/module'
 import { join } from 'path'
 import { ExtensionManager } from './../managers/extension'
 import { WindowManager } from './../managers/window'
 import { userSpacePath } from './../utils/path'
+import { AppRoute } from '@janhq/core'
+import { getResourcePath } from './../utils/path'
 
 export function handleAppIPCs() {
+  /**
+   * Handles the "setNativeThemeLight" IPC message by setting the native theme source to "light".
+   * This will change the appearance of the app to the light theme.
+   */
+  ipcMain.handle(AppRoute.setNativeThemeLight, () => {
+    nativeTheme.themeSource = 'light'
+  })
+
+  /**
+   * Handles the "setNativeThemeDark" IPC message by setting the native theme source to "dark".
+   * This will change the appearance of the app to the dark theme.
+   */
+  ipcMain.handle(AppRoute.setNativeThemeDark, () => {
+    nativeTheme.themeSource = 'dark'
+  })
+
+  /**
+   * Handles the "setNativeThemeSystem" IPC message by setting the native theme source to "system".
+   * This will change the appearance of the app to match the system's current theme.
+   */
+  ipcMain.handle(AppRoute.setNativeThemeSystem, () => {
+    nativeTheme.themeSource = 'system'
+  })
   /**
    * Retrieves the path to the app data directory using the `coreAPI` object.
    * If the `coreAPI` object is not available, the function returns `undefined`.
    * @returns A Promise that resolves with the path to the app data directory, or `undefined` if the `coreAPI` object is not available.
    */
-  ipcMain.handle('appDataPath', async (_event) => {
+  ipcMain.handle(AppRoute.appDataPath, async (_event) => {
     return app.getPath('userData')
   })
 
@@ -20,7 +45,7 @@ export function handleAppIPCs() {
    * @param _event - The IPC event object.
    * @returns The version of the app.
    */
-  ipcMain.handle('appVersion', async (_event) => {
+  ipcMain.handle(AppRoute.appVersion, async (_event) => {
     return app.getVersion()
   })
 
@@ -29,16 +54,20 @@ export function handleAppIPCs() {
    * The `shell.openPath` method is used to open the directory in the user's default file explorer.
    * @param _event - The IPC event object.
    */
-  ipcMain.handle('openAppDirectory', async (_event) => {
+  ipcMain.handle(AppRoute.openAppDirectory, async (_event) => {
     shell.openPath(userSpacePath)
   })
 
+  ipcMain.handle(AppRoute.getResourcePath, async (_event) => {
+    return getResourcePath()
+  })
+
   /**
    * Opens a URL in the user's default browser.
    * @param _event - The IPC event object.
    * @param url - The URL to open.
    */
-  ipcMain.handle('openExternalUrl', async (_event, url) => {
+  ipcMain.handle(AppRoute.openExternalUrl, async (_event, url) => {
     shell.openExternal(url)
   })
 
@@ -47,7 +76,7 @@ export function handleAppIPCs() {
    * @param _event - The IPC event object.
    * @param url - The URL to reload.
    */
-  ipcMain.handle('relaunch', async (_event, url) => {
+  ipcMain.handle(AppRoute.relaunch, async (_event, url) => {
     ModuleManager.instance.clearImportedModules()
 
     if (app.isPackaged) {
@@ -56,9 +85,7 @@ export function handleAppIPCs() {
     } else {
       for (const modulePath in ModuleManager.instance.requiredModules) {
         delete require.cache[
-          require.resolve(
-            join(userSpacePath, 'extensions', modulePath)
-          )
+          require.resolve(join(userSpacePath, 'extensions', modulePath))
         ]
       }
       ExtensionManager.instance.setupExtensions()

electron/handlers/download.ts

@@ -4,7 +4,7 @@ import { resolve, join } from 'path'
 import { WindowManager } from './../managers/window'
 import request from 'request'
 import { createWriteStream } from 'fs'
-import { getResourcePath } from './../utils/path'
+import { DownloadEvent, DownloadRoute } from '@janhq/core'
 const progress = require('request-progress')
 
 export function handleDownloaderIPCs() {
@@ -13,7 +13,7 @@ export function handleDownloaderIPCs() {
    * @param _event - The IPC event object.
    * @param fileName - The name of the file being downloaded.
    */
-  ipcMain.handle('pauseDownload', async (_event, fileName) => {
+  ipcMain.handle(DownloadRoute.pauseDownload, async (_event, fileName) => {
     DownloadManager.instance.networkRequests[fileName]?.pause()
   })
 
@@ -22,7 +22,7 @@ export function handleDownloaderIPCs() {
    * @param _event - The IPC event object.
    * @param fileName - The name of the file being downloaded.
    */
-  ipcMain.handle('resumeDownload', async (_event, fileName) => {
+  ipcMain.handle(DownloadRoute.resumeDownload, async (_event, fileName) => {
     DownloadManager.instance.networkRequests[fileName]?.resume()
   })
 
@@ -32,31 +32,27 @@ export function handleDownloaderIPCs() {
    * @param _event - The IPC event object.
    * @param fileName - The name of the file being downloaded.
    */
-  ipcMain.handle('abortDownload', async (_event, fileName) => {
+  ipcMain.handle(DownloadRoute.abortDownload, async (_event, fileName) => {
     const rq = DownloadManager.instance.networkRequests[fileName]
     DownloadManager.instance.networkRequests[fileName] = undefined
     rq?.abort()
   })
 
-  ipcMain.handle('getResourcePath', async (_event) => {
-    return getResourcePath()
-  })
-
   /**
    * Downloads a file from a given URL.
    * @param _event - The IPC event object.
    * @param url - The URL to download the file from.
    * @param fileName - The name to give the downloaded file.
    */
-  ipcMain.handle('downloadFile', async (_event, url, fileName) => {
+  ipcMain.handle(DownloadRoute.downloadFile, async (_event, url, fileName) => {
     const userDataPath = join(app.getPath('home'), 'jan')
     const destination = resolve(userDataPath, fileName)
     const rq = request(url)
 
     progress(rq, {})
       .on('progress', function (state: any) {
         WindowManager?.instance.currentWindow?.webContents.send(
-          'onFileDownloadUpdate',
+          DownloadEvent.onFileDownloadUpdate,
           {
             ...state,
             fileName,
@@ -65,7 +61,7 @@ export function handleDownloaderIPCs() {
       })
       .on('error', function (err: Error) {
         WindowManager?.instance.currentWindow?.webContents.send(
-          'onFileDownloadError',
+          DownloadEvent.onFileDownloadError,
           {
             fileName,
             err,
@@ -75,15 +71,15 @@ export function handleDownloaderIPCs() {
       .on('end', function () {
         if (DownloadManager.instance.networkRequests[fileName]) {
           WindowManager?.instance.currentWindow?.webContents.send(
-            'onFileDownloadSuccess',
+            DownloadEvent.onFileDownloadSuccess,
             {
               fileName,
             }
           )
           DownloadManager.instance.setRequest(fileName, undefined)
         } else {
           WindowManager?.instance.currentWindow?.webContents.send(
-            'onFileDownloadError',
+            DownloadEvent.onFileDownloadError,
             {
               fileName,
               err: 'Download cancelled',