ogi-addon 2.3.0 → 2.3.2

package/build/SearchEngine.d.cts

@@ -2,6 +2,12 @@
 type BaseRequiredFields = {
   name: string;
   manifest?: Record<string, any>;
+  /**
+   * Update-only hint for OGI's setup stage.
+   * When false, OGI keeps existing files in place instead of moving them to `old_files`
+   * before running update setup. Defaults to true/undefined behavior.
+   */
+  clearOldFilesBeforeUpdate?: boolean;
 };
 type SearchResult = BaseRequiredFields & ({
   downloadType: 'torrent' | 'magnet';

package/build/SearchEngine.d.mts

@@ -2,6 +2,12 @@
 type BaseRequiredFields = {
   name: string;
   manifest?: Record<string, any>;
+  /**
+   * Update-only hint for OGI's setup stage.
+   * When false, OGI keeps existing files in place instead of moving them to `old_files`
+   * before running update setup. Defaults to true/undefined behavior.
+   */
+  clearOldFilesBeforeUpdate?: boolean;
 };
 type SearchResult = BaseRequiredFields & ({
   downloadType: 'torrent' | 'magnet';

package/build/main.cjs

@@ -15,7 +15,7 @@ let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);
 
 //#region package.json
-var version = "2.3.0";
+var version = "2.3.2";
 
 //#endregion
 //#region src/main.ts
@@ -441,6 +441,9 @@ var OGIAddonWSListener = class {
 		}));
 		return await this.waitForResponseFromServer(id);
 	}
+	/**
+	* Registers the message receiver for the socket. This is used to receive messages from the server and handle them.
+	*/
 	registerMessageReceiver() {
 		this.socket.on("message", async (data) => {
 			const message = JSON.parse(data);
@@ -454,10 +457,7 @@ var OGIAddonWSListener = class {
 					else this.respondToMessage(message.id, { success: true }, void 0);
 					break;
 				case "search":
-					let searchResultEvent = new require_EventResponse((screen, name, description) => this.userInputAsked(screen, name, description, this.socket));
-					this.eventEmitter.emit("search", message.args, searchResultEvent);
-					const searchResult = await this.waitForEventToRespond(searchResultEvent);
-					this.respondToMessage(message.id, searchResult.data, searchResultEvent);
+					await this.handleEventWithResponse(message, (event) => this.eventEmitter.emit("search", message.args, event));
 					break;
 				case "setup": {
 					let setupEvent = new require_EventResponse((screen, name, description) => this.userInputAsked(screen, name, description, this.socket));
@@ -479,26 +479,16 @@ var OGIAddonWSListener = class {
 					break;
 				}
 				case "library-search":
-					let librarySearchEvent = new require_EventResponse((screen, name, description) => this.userInputAsked(screen, name, description, this.socket));
-					this.eventEmitter.emit("library-search", message.args, librarySearchEvent);
-					const librarySearchResult = await this.waitForEventToRespond(librarySearchEvent);
-					this.respondToMessage(message.id, librarySearchResult.data, librarySearchEvent);
+					await this.handleEventWithResponse(message, (event) => this.eventEmitter.emit("library-search", message.args, event));
 					break;
 				case "game-details":
-					let gameDetailsEvent = new require_EventResponse((screen, name, description) => this.userInputAsked(screen, name, description, this.socket));
-					if (this.eventEmitter.listenerCount("game-details") === 0) {
-						this.respondToMessage(message.id, { error: "No event listener for game-details" }, gameDetailsEvent);
-						break;
-					}
-					this.eventEmitter.emit("game-details", message.args, gameDetailsEvent);
-					const gameDetailsResult = await this.waitForEventToRespond(gameDetailsEvent);
-					this.respondToMessage(message.id, gameDetailsResult.data, gameDetailsEvent);
+					await this.handleEventWithResponse(message, (event) => this.eventEmitter.emit("game-details", message.args, event), {
+						requireListener: "game-details",
+						noListenerError: "No event listener for game-details"
+					});
 					break;
 				case "check-for-updates":
-					let checkForUpdatesEvent = new require_EventResponse((screen, name, description) => this.userInputAsked(screen, name, description, this.socket));
-					this.eventEmitter.emit("check-for-updates", message.args, checkForUpdatesEvent);
-					const checkForUpdatesResult = await this.waitForEventToRespond(checkForUpdatesEvent);
-					this.respondToMessage(message.id, checkForUpdatesResult.data, checkForUpdatesEvent);
+					await this.handleEventWithResponse(message, (event) => this.eventEmitter.emit("check-for-updates", message.args, event));
 					break;
 				case "request-dl":
 					let requestDLEvent = new require_EventResponse((screen, name, description) => this.userInputAsked(screen, name, description, this.socket));
@@ -516,10 +506,7 @@ var OGIAddonWSListener = class {
 					this.respondToMessage(message.id, requestDLResult.data, requestDLEvent);
 					break;
 				case "catalog":
-					let catalogEvent = new require_EventResponse();
-					this.eventEmitter.emit("catalog", catalogEvent);
-					const catalogResult = await this.waitForEventToRespond(catalogEvent);
-					this.respondToMessage(message.id, catalogResult.data, catalogEvent);
+					await this.handleEventWithResponseNoInput(message, (event) => this.eventEmitter.emit("catalog", event));
 					break;
 				case "task-run": {
 					let taskRunEvent = new require_EventResponse((screen, name, description) => this.userInputAsked(screen, name, description, this.socket));
@@ -556,6 +543,9 @@ var OGIAddonWSListener = class {
 					this.respondToMessage(message.id, taskRunResult.data, taskRunEvent);
 					break;
 				}
+				case "launch-app":
+					await this.handleEventWithResponse(message, (event) => this.eventEmitter.emit("launch-app", message.args, event));
+					break;
 			}
 		});
 	}
@@ -580,6 +570,29 @@ var OGIAddonWSListener = class {
 			}, 5e3);
 		});
 	}
+	/**
+	* Common flow for events that use EventResponse with userInputAsked: create event, emit via callback, wait, respond.
+	* If options.requireListener is set and that event has no listeners, responds with options.noListenerError and returns.
+	*/
+	async handleEventWithResponse(message, emit, options) {
+		const event = new require_EventResponse((screen, name, description) => this.userInputAsked(screen, name, description, this.socket));
+		if (options && this.eventEmitter.listenerCount(options.requireListener) === 0) {
+			this.respondToMessage(message.id, { error: options.noListenerError }, event);
+			return;
+		}
+		emit(event);
+		const result = await this.waitForEventToRespond(event);
+		this.respondToMessage(message.id, result.data, event);
+	}
+	/**
+	* Same as handleEventWithResponse but for events that don't need userInputAsked (e.g. catalog).
+	*/
+	async handleEventWithResponseNoInput(message, emit) {
+		const event = new require_EventResponse();
+		emit(event);
+		const result = await this.waitForEventToRespond(event);
+		this.respondToMessage(message.id, result.data, event);
+	}
 	respondToMessage(messageID, response, originalEvent) {
 		this.socket.send(JSON.stringify({
 			event: "response",

package/build/main.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"main.cjs","names":["pjson.version","events","Configuration","fs","EventResponse","Fuse","z","ConfigurationBuilder"],"sources":["../package.json","../src/main.ts"],"sourcesContent":["","import ws, { WebSocket } from 'ws';\nimport events from 'node:events';\nimport { ConfigurationBuilder } from './config/ConfigurationBuilder';\nimport type { ConfigurationFile } from './config/ConfigurationBuilder';\nimport { Configuration } from './config/Configuration';\nimport EventResponse from './EventResponse';\nimport type { SearchResult } from './SearchEngine';\nimport Fuse, { IFuseOptions } from 'fuse.js';\n\nexport type OGIAddonEvent =\n  | 'connect'\n  | 'disconnect'\n  | 'configure'\n  | 'authenticate'\n  | 'search'\n  | 'setup'\n  | 'library-search'\n  | 'game-details'\n  | 'exit'\n  | 'check-for-updates'\n  | 'request-dl'\n  | 'catalog';\n\nexport type OGIAddonClientSentEvent =\n  | 'response'\n  | 'authenticate'\n  | 'configure'\n  | 'defer-update'\n  | 'notification'\n  | 'input-asked'\n  | 'get-app-details'\n  | 'search-app-name'\n  | 'flag'\n  | 'task-update';\n\nexport type OGIAddonServerSentEvent =\n  | 'authenticate'\n  | 'configure'\n  | 'config-update'\n  | 'search'\n  | 'setup'\n  | 'response'\n  | 'library-search'\n  | 'check-for-updates'\n  | 'task-run'\n  | 'game-details'\n  | 'request-dl'\n  | 'catalog';\nexport { ConfigurationBuilder, Configuration, EventResponse };\nexport type { SearchResult };\nconst defaultPort = 7654;\nimport pjson from '../package.json';\nimport { exec, spawn } from 'node:child_process';\nimport fs from 'node:fs';\nimport { z } from 'zod';\nexport const VERSION = pjson.version;\n\nexport interface ClientSentEventTypes {\n  response: any;\n  authenticate: {\n    name: string;\n    id: string;\n    description: string;\n    version: string;\n    author: string;\n  };\n  configure: ConfigurationFile;\n  'defer-update': {\n    logs: string[];\n    progress: number;\n  };\n  notification: Notification;\n  'input-asked': ConfigurationBuilder<\n    Record<string, string | number | boolean>\n  >;\n  'task-update': {\n    id: string;\n    progress: number;\n    logs: string[];\n    finished: boolean;\n    failed: string | undefined;\n  };\n  'get-app-details': {\n    appID: number;\n    storefront: string;\n  };\n  'search-app-name': {\n    query: string;\n    storefront: string;\n  };\n  flag: {\n    flag: string;\n    value: string | string[];\n  };\n}\n\nexport type BasicLibraryInfo = {\n  name: string;\n  capsuleImage: string;\n  appID: number;\n  storefront: string;\n};\n\nexport interface CatalogSection {\n  name: string;\n  description: string;\n  listings: BasicLibraryInfo[];\n}\n\nexport interface CatalogCarouselItem {\n  name: string;\n  description: string;\n  carouselImage: string;\n  fullBannerImage?: string;\n  appID?: number;\n  storefront?: string;\n  capsuleImage?: string;\n}\n\nexport interface CatalogWithCarousel {\n  sections: Record<string, CatalogSection>;\n  carousel?: Record<string, CatalogCarouselItem> | CatalogCarouselItem[];\n}\n\nexport type CatalogResponse = Record<string, CatalogSection> | CatalogWithCarousel;\n\nexport type SetupEventResponse = Omit<\n  LibraryInfo,\n  | 'capsuleImage'\n  | 'coverImage'\n  | 'name'\n  | 'appID'\n  | 'storefront'\n  | 'addonsource'\n  | 'titleImage'\n> & {\n  redistributables?: {\n    name: string;\n    path: string;\n  }[];\n};\n\nexport interface EventListenerTypes {\n  /**\n   * This event is emitted when the addon connects to the OGI Addon Server. Addon does not need to resolve anything.\n   * @param event\n   * @returns\n   */\n  connect: (event: EventResponse<void>) => void;\n\n  /**\n   * This event is emitted when the client requests for the addon to disconnect. Addon does not need to resolve this event, but we recommend `process.exit(0)` so the addon can exit gracefully instead of by force by the addon server.\n   * @param reason\n   * @returns\n   */\n  disconnect: (reason: string) => void;\n  /**\n   * This event is emitted when the client requests for the addon to configure itself. Addon should resolve the event with the internal configuration. (See ConfigurationBuilder)\n   * @param config\n   * @returns\n   */\n  configure: (config: ConfigurationBuilder) => ConfigurationBuilder;\n  /**\n   * This event is called when the client provides a response to any event. This should be treated as middleware.\n   * @param response\n   * @returns\n   */\n  response: (response: any) => void;\n\n  /**\n   * This event is called when the client requests for the addon to authenticate itself. You don't need to provide any info.\n   * @param config\n   * @returns\n   */\n  authenticate: (config: any) => void;\n  /**\n   * This event is emitted when the client requests for a torrent/direct download search to be performed. Addon is given the gameID (could be a steam appID or custom store appID), along with the storefront type. Addon should resolve the event with the search results. (See SearchResult)\n   * @param query\n   * @param event\n   * @returns\n   */\n  search: (\n    query: {\n      storefront: string;\n      appID: number;\n    } & (\n      | {\n          for: 'game' | 'task' | 'all';\n        }\n      | {\n          for: 'update';\n          libraryInfo: LibraryInfo;\n        }\n    ),\n    event: EventResponse<SearchResult[]>\n  ) => void;\n  /**\n   * This event is emitted when the client requests for app setup to be performed. Addon should resolve the event with the metadata for the library entry. (See LibraryInfo)\n   * @param data\n   * @param event\n   * @returns\n   */\n  setup: (\n    data: {\n      path: string;\n      type: 'direct' | 'torrent' | 'magnet' | 'empty';\n      name: string;\n      usedRealDebrid: boolean;\n      multiPartFiles?: {\n        name: string;\n        downloadURL: string;\n      }[];\n      appID: number;\n      storefront: string;\n      manifest?: Record<string, unknown>;\n    } & (\n      | {\n          for: 'game';\n        }\n      | {\n          for: 'update';\n          currentLibraryInfo: LibraryInfo;\n        }\n    ),\n    event: EventResponse<SetupEventResponse>\n  ) => void;\n\n  /**\n   * This event is emitted when the client requires for a search to be performed. Input is the search query.\n   * @param query\n   * @param event\n   * @returns\n   */\n  'library-search': (\n    query: string,\n    event: EventResponse<BasicLibraryInfo[]>\n  ) => void;\n\n  /**\n   * This event is emitted when the client requests for a game details to be fetched. Addon should resolve the event with the game details. This is used to generate a store page for the game.\n   * @param appID\n   * @param event\n   * @returns\n   */\n  'game-details': (\n    details: { appID: number; storefront: string },\n    event: EventResponse<StoreData | undefined>\n  ) => void;\n\n  /**\n   * This event is emitted when the client requests for the addon to exit. Use this to perform any cleanup tasks, ending with a `process.exit(0)`.\n   * @returns\n   */\n  exit: () => void;\n\n  /**\n   * This event is emitted when the client requests for a download to be performed with the 'request' type. Addon should resolve the event with a SearchResult containing the actual download info.\n   * @param appID\n   * @param info\n   * @param event\n   * @returns\n   */\n  'request-dl': (\n    appID: number,\n    info: SearchResult,\n    event: EventResponse<SearchResult>\n  ) => void;\n\n  /**\n   * This event is emitted when the client requests for a catalog to be fetched. Addon should resolve the event with the catalog.\n   * @param event\n   * @returns\n   */\n  catalog: (\n    event: Omit<\n      EventResponse<CatalogResponse>,\n      'askForInput'\n    >\n  ) => void;\n\n  /**\n   * This event is emitted when the client requests for an addon to check for updates. Addon should resolve the event with the update information.\n   * @param data\n   * @param event\n   * @returns\n   */\n  'check-for-updates': (\n    data: { appID: number; storefront: string; currentVersion: string },\n    event: EventResponse<\n      | {\n          available: true;\n          version: string;\n        }\n      | {\n          available: false;\n        }\n    >\n  ) => void;\n}\n\nexport interface StoreData {\n  name: string;\n  publishers: string[];\n  developers: string[];\n  appID: number;\n  releaseDate: string;\n  capsuleImage: string;\n  coverImage: string;\n  basicDescription: string;\n  description: string;\n  headerImage: string;\n  latestVersion: string;\n}\nexport interface WebsocketMessageClient {\n  event: OGIAddonClientSentEvent;\n  id?: string;\n  args: any;\n  statusError?: string;\n}\nexport interface WebsocketMessageServer {\n  event: OGIAddonServerSentEvent;\n  id?: string;\n  args: any;\n  statusError?: string;\n}\n\n/**\n * The configuration for the addon. This is used to identify the addon and provide information about it.\n * Storefronts is an array of names of stores that the addon supports.\n */\nexport interface OGIAddonConfiguration {\n  name: string;\n  id: string;\n  description: string;\n  version: string;\n\n  author: string;\n  repository: string;\n  storefronts: string[];\n}\n\n/**\n * The main class for the OGI Addon. This class is used to interact with the OGI Addon Server. The OGI Addon Server provides a `--addonSecret` to the addon so it can securely connect.\n * @example\n * ```typescript\n * const addon = new OGIAddon({\n *  name: 'Test Addon',\n *   id: 'test-addon',\n *  description: 'A test addon',\n *  version: '1.0.0',\n *  author: 'OGI Developers',\n *  repository: ''\n * });\n * ```\n *\n */\nexport default class OGIAddon {\n  public eventEmitter = new events.EventEmitter();\n  public addonWSListener: OGIAddonWSListener;\n  public addonInfo: OGIAddonConfiguration;\n  public config: Configuration = new Configuration({});\n  private eventsAvailable: OGIAddonEvent[] = [];\n  private registeredConnectEvent: boolean = false;\n  private taskHandlers: Map<\n    string,\n    (\n      task: Task,\n      data: {\n        manifest: Record<string, unknown>;\n        downloadPath: string;\n        name: string;\n        libraryInfo: LibraryInfo;\n      }\n    ) => Promise<void> | void\n  > = new Map();\n\n  constructor(addonInfo: OGIAddonConfiguration) {\n    this.addonInfo = addonInfo;\n    this.addonWSListener = new OGIAddonWSListener(this, this.eventEmitter);\n  }\n\n  /**\n   * Register an event listener for the addon. (See EventListenerTypes)\n   * @param event {OGIAddonEvent}\n   * @param listener {EventListenerTypes[OGIAddonEvent]}\n   */\n  public on<T extends OGIAddonEvent>(\n    event: T,\n    listener: EventListenerTypes[T]\n  ) {\n    this.eventEmitter.on(event, listener);\n    this.eventsAvailable.push(event);\n    // wait for the addon to be connected\n    if (!this.registeredConnectEvent) {\n      this.addonWSListener.eventEmitter.once('connect', () => {\n        this.addonWSListener.send('flag', {\n          flag: 'events-available',\n          value: this.eventsAvailable,\n        });\n      });\n      this.registeredConnectEvent = true;\n    }\n  }\n\n  public emit<T extends OGIAddonEvent>(\n    event: T,\n    ...args: Parameters<EventListenerTypes[T]>\n  ) {\n    this.eventEmitter.emit(event, ...args);\n  }\n\n  /**\n   * Notify the client using a notification. Provide the type of notification, the message, and an ID.\n   * @param notification {Notification}\n   */\n  public notify(notification: Notification) {\n    this.addonWSListener.send('notification', [notification]);\n  }\n\n  /**\n   * Get the app details for a given appID and storefront.\n   * @param appID {number}\n   * @param storefront {string}\n   * @returns {Promise<StoreData>}\n   */\n  public async getAppDetails(appID: number, storefront: string) {\n    const id = this.addonWSListener.send('get-app-details', {\n      appID,\n      storefront,\n    });\n    return await this.addonWSListener.waitForResponseFromServer<\n      StoreData | undefined\n    >(id);\n  }\n\n  public async searchGame(query: string, storefront: string) {\n    const id = this.addonWSListener.send('search-app-name', {\n      query,\n      storefront,\n    });\n    return await this.addonWSListener.waitForResponseFromServer<\n      BasicLibraryInfo[]\n    >(id);\n  }\n\n  /**\n   * Notify the OGI Addon Server that you are performing a background task. This can be used to help users understand what is happening in the background.\n   * @returns {Promise<Task>} A Task instance for managing the background task.\n   */\n  public async task(): Promise<Task> {\n    const id = Math.random().toString(36).substring(7);\n    const progress = 0;\n    const logs: string[] = [];\n    const task = new Task(this.addonWSListener, id, progress, logs);\n    this.addonWSListener.send('task-update', {\n      id,\n      progress,\n      logs,\n      finished: false,\n      failed: undefined,\n    });\n    return task;\n  }\n\n  /**\n   * Register a task handler for a specific task name. The task name should match the taskName field in SearchResult or ActionOption.\n   * @param taskName {string} The name of the task (should match taskName in SearchResult or ActionOption.setTaskName()).\n   * @param handler {(task: Task, data: { manifest: Record<string, unknown>; downloadPath: string; name: string; libraryInfo: LibraryInfo }) => Promise<void> | void} The handler function.\n   * @example\n   * ```typescript\n   * addon.onTask('clearCache', async (task) => {\n   *   task.log('Clearing cache...');\n   *   task.setProgress(50);\n   *   await clearCacheFiles();\n   *   task.setProgress(100);\n   *   task.complete();\n   * });\n   * ```\n   */\n  public onTask(\n    taskName: string,\n    handler: (\n      task: Task,\n      data: {\n        manifest: Record<string, unknown>;\n        downloadPath: string;\n        name: string;\n        libraryInfo: LibraryInfo;\n      }\n    ) => Promise<void> | void\n  ): void {\n    this.taskHandlers.set(taskName, handler);\n  }\n\n  /**\n   * Check if a task handler is registered for the given task name.\n   * @param taskName {string} The task name to check.\n   * @returns {boolean} True if a handler is registered.\n   */\n  public hasTaskHandler(taskName: string): boolean {\n    return this.taskHandlers.has(taskName);\n  }\n\n  /**\n   * Get a task handler for the given task name.\n   * @param taskName {string} The task name.\n   * @returns The handler function or undefined if not found.\n   */\n  public getTaskHandler(taskName: string):\n    | ((\n        task: Task,\n        data: {\n          manifest: Record<string, unknown>;\n          downloadPath: string;\n          name: string;\n          libraryInfo?: LibraryInfo;\n        }\n      ) => Promise<void> | void)\n    | undefined {\n    return this.taskHandlers.get(taskName);\n  }\n\n  /**\n   * Extract a file using 7-Zip on Windows, unzip on Linux/Mac.\n   * @param path {string}\n   * @param outputPath {string}\n   * @param type {'unrar' | 'unzip'}\n   * @returns {Promise<void>}\n   */\n  public async extractFile(\n    path: string,\n    outputPath: string,\n    type: 'unrar' | 'unzip'\n  ) {\n    return new Promise<void>((resolve, reject) => {\n      // Ensure outputPath exists\n      if (!fs.existsSync(outputPath)) {\n        fs.mkdirSync(outputPath, { recursive: true });\n      }\n\n      if (type === 'unzip') {\n        // Prefer 7-Zip on Windows, unzip on Linux/Mac\n        if (process.platform === 'win32') {\n          // 7-Zip path (default install location)\n          const s7ZipPath = '\"C:\\\\Program Files\\\\7-Zip\\\\7z.exe\"';\n          exec(\n            `${s7ZipPath} x \"${path}\" -o\"${outputPath}\"`,\n            (err: any, stdout: any, stderr: any) => {\n              if (err) {\n                console.error(err);\n                console.log(stderr);\n                reject(new Error('Failed to extract ZIP file'));\n                return;\n              }\n              console.log(stdout);\n              console.log(stderr);\n              resolve();\n            }\n          );\n        } else {\n          // Use unzip on Linux/Mac\n          const unzipProcess = spawn(\n            'unzip',\n            [\n              '-o', // overwrite files without prompting\n              path,\n              '-d', // specify output directory\n              outputPath,\n            ],\n            {\n              env: {\n                ...process.env,\n                UNZIP_DISABLE_ZIPBOMB_DETECTION: 'TRUE',\n              },\n            }\n          );\n\n          unzipProcess.stdout.on('data', (data: Buffer) => {\n            console.log(`[unzip stdout]: ${data}`);\n          });\n\n          unzipProcess.stderr.on('data', (data: Buffer) => {\n            console.error(`[unzip stderr]: ${data}`);\n          });\n\n          unzipProcess.on('close', (code: number) => {\n            if (code !== 0) {\n              console.error(`unzip process exited with code ${code}`);\n              reject(new Error('Failed to extract ZIP file'));\n              return;\n            }\n            resolve();\n          });\n        }\n      } else if (type === 'unrar') {\n        if (process.platform === 'win32') {\n          // 7-Zip path (default install location)\n          const s7ZipPath = '\"C:\\\\Program Files\\\\7-Zip\\\\7z.exe\"';\n          exec(\n            `${s7ZipPath} x \"${path}\" -o\"${outputPath}\"`,\n            (err: any, stdout: any, stderr: any) => {\n              if (err) {\n                console.error(err);\n                console.log(stderr);\n                reject(new Error('Failed to extract RAR file'));\n                return;\n              }\n              console.log(stdout);\n              console.log(stderr);\n              resolve();\n            }\n          );\n        } else {\n          // Use unrar on Linux/Mac\n          const unrarProcess = spawn('unrar', ['x', '-y', path, outputPath]);\n\n          unrarProcess.stdout.on('data', (data: Buffer) => {\n            console.log(`[unrar stdout]: ${data}`);\n          });\n\n          unrarProcess.stderr.on('data', (data: Buffer) => {\n            console.error(`[unrar stderr]: ${data}`);\n          });\n\n          unrarProcess.on('close', (code: number) => {\n            if (code !== 0) {\n              console.error(`unrar process exited with code ${code}`);\n              reject(new Error('Failed to extract RAR file'));\n              return;\n            }\n            resolve();\n          });\n        }\n      } else {\n        reject(new Error('Unknown extraction type'));\n      }\n    });\n  }\n}\n\n/**\n * A unified task API for both server-initiated tasks (via onTask handlers)\n * and addon-initiated background tasks (via addon.task()).\n * Provides chainable methods for logging, progress updates, and completion.\n */\nexport class Task {\n  // EventResponse-based mode (for onTask handlers)\n  private event: EventResponse<void> | undefined;\n\n  // WebSocket-based mode (for addon.task())\n  private ws: OGIAddonWSListener | undefined;\n  private readonly id: string | undefined;\n  private progress: number = 0;\n  private logs: string[] = [];\n  private finished: boolean = false;\n  private failed: string | undefined = undefined;\n\n  /**\n   * Construct a Task from an EventResponse (for onTask handlers).\n   * @param event {EventResponse<void>} The event response to wrap.\n   */\n  constructor(event: EventResponse<void>);\n\n  /**\n   * Construct a Task from WebSocket listener (for addon.task()).\n   * @param ws {OGIAddonWSListener} The WebSocket listener.\n   * @param id {string} The task ID.\n   * @param progress {number} Initial progress (0-100).\n   * @param logs {string[]} Initial logs array.\n   */\n  constructor(\n    ws: OGIAddonWSListener,\n    id: string,\n    progress: number,\n    logs: string[]\n  );\n\n  constructor(\n    eventOrWs: EventResponse<void> | OGIAddonWSListener,\n    id?: string,\n    progress?: number,\n    logs?: string[]\n  ) {\n    if (eventOrWs instanceof EventResponse) {\n      // EventResponse-based mode\n      this.event = eventOrWs;\n      this.event.defer();\n    } else {\n      // WebSocket-based mode\n      this.ws = eventOrWs;\n      this.id = id!;\n      this.progress = progress ?? 0;\n      this.logs = logs ?? [];\n    }\n  }\n\n  /**\n   * Log a message to the task. Returns this for chaining.\n   * @param message {string} The message to log.\n   */\n  log(message: string): this {\n    if (this.event) {\n      this.event.log(message);\n    } else {\n      this.logs.push(message);\n      this.update();\n    }\n    return this;\n  }\n\n  /**\n   * Set the progress of the task (0-100). Returns this for chaining.\n   * @param progress {number} The progress value (0-100).\n   */\n  setProgress(progress: number): this {\n    if (this.event) {\n      this.event.progress = progress;\n    } else {\n      this.progress = progress;\n      this.update();\n    }\n    return this;\n  }\n\n  /**\n   * Complete the task successfully.\n   */\n  complete(): void {\n    if (this.event) {\n      this.event.complete();\n    } else {\n      this.finished = true;\n      this.update();\n    }\n  }\n\n  /**\n   * Fail the task with an error message.\n   * @param message {string} The error message.\n   */\n  fail(message: string): void {\n    if (this.event) {\n      this.event.fail(message);\n    } else {\n      this.failed = message;\n      this.update();\n    }\n  }\n\n  /**\n   * Ask the user for input using a ConfigurationBuilder screen.\n   * Only available for EventResponse-based tasks (onTask handlers).\n   * The return type is inferred from the ConfigurationBuilder's accumulated option types.\n   * @param name {string} The name/title of the input prompt.\n   * @param description {string} The description of what input is needed.\n   * @param screen {ConfigurationBuilder<U>} The configuration builder for the input form.\n   * @returns {Promise<U>} The user's input with types matching the configuration options.\n   * @throws {Error} If called on a WebSocket-based task.\n   */\n  async askForInput<U extends Record<string, string | number | boolean>>(\n    name: string,\n    description: string,\n    screen: ConfigurationBuilder<U>\n  ): Promise<U> {\n    if (!this.event) {\n      throw new Error(\n        'askForInput() is only available for EventResponse-based tasks (onTask handlers)'\n      );\n    }\n    return this.event.askForInput(name, description, screen);\n  }\n\n  /**\n   * Update the task state (for WebSocket-based tasks only).\n   * Called automatically when using log(), setProgress(), complete(), or fail().\n   */\n  private update(): void {\n    if (this.ws && this.id !== undefined) {\n      this.ws.send('task-update', {\n        id: this.id,\n        progress: this.progress,\n        logs: this.logs,\n        finished: this.finished,\n        failed: this.failed,\n      });\n    }\n  }\n}\n/**\n * A search tool wrapper over Fuse.js for the OGI Addon. This tool is used to search for items in the library.\n * @example\n * ```typescript\n * const searchTool = new SearchTool<LibraryInfo>([{ name: 'test', appID: 123 }, { name: 'test2', appID: 124 }], ['name']);\n * const results = searchTool.search('test', 10);\n * ```\n */\nexport class SearchTool<T> {\n  private fuse: Fuse<T>;\n  constructor(\n    items: T[],\n    keys: string[],\n    options: Omit<IFuseOptions<T>, 'keys'> = {\n      threshold: 0.3,\n      includeScore: true,\n    }\n  ) {\n    this.fuse = new Fuse(items, {\n      keys,\n      ...options,\n    });\n  }\n  public search(query: string, limit: number = 10): T[] {\n    return this.fuse\n      .search(query)\n      .slice(0, limit)\n      .map((result) => result.item);\n  }\n  public addItems(items: T[]) {\n    items.map((item) => this.fuse.add(item));\n  }\n}\n/**\n * Library Info is the metadata for a library entry after setting up a game.\n */\nexport const ZodLibraryInfo = z.object({\n  name: z.string(),\n  version: z.string(),\n  cwd: z.string(),\n  appID: z.number(),\n  launchExecutable: z.string(),\n  launchArguments: z.string().optional(),\n  capsuleImage: z.string(),\n  storefront: z.string(),\n  addonsource: z.string(),\n  coverImage: z.string(),\n  titleImage: z.string().optional(),\n});\nexport type LibraryInfo = z.infer<typeof ZodLibraryInfo>;\ninterface Notification {\n  type: 'warning' | 'error' | 'info' | 'success';\n  message: string;\n  id: string;\n}\nclass OGIAddonWSListener {\n  private socket: WebSocket;\n  public eventEmitter: events.EventEmitter;\n  public addon: OGIAddon;\n\n  constructor(ogiAddon: OGIAddon, eventEmitter: events.EventEmitter) {\n    if (\n      process.argv[process.argv.length - 1].split('=')[0] !== '--addonSecret'\n    ) {\n      throw new Error(\n        'No secret provided. This usually happens because the addon was not started by the OGI Addon Server.'\n      );\n    }\n    this.addon = ogiAddon;\n    this.eventEmitter = eventEmitter;\n    this.socket = new ws('ws://localhost:' + defaultPort);\n    this.socket.on('open', () => {\n      console.log('Connected to OGI Addon Server');\n      console.log('OGI Addon Server Version:', VERSION);\n\n      // Authenticate with OGI Addon Server\n      this.send('authenticate', {\n        ...this.addon.addonInfo,\n        secret: process.argv[process.argv.length - 1].split('=')[1],\n        ogiVersion: VERSION,\n      });\n\n      // send a configuration request\n      let configBuilder = new ConfigurationBuilder();\n      this.eventEmitter.emit('configure', configBuilder);\n      this.send('configure', configBuilder.build(false));\n      this.addon.config = new Configuration(configBuilder.build(true));\n\n      // wait for the config-update to be received then send connect\n      const configListener = (event: ws.MessageEvent) => {\n        if (event === undefined) return;\n        // event can be a Buffer, string, ArrayBuffer, or Buffer[]\n        let data: string;\n        if (typeof event === 'string') {\n          data = event;\n        } else if (event instanceof Buffer) {\n          data = event.toString();\n        } else if (event && typeof (event as any).data === 'string') {\n          data = (event as any).data;\n        } else if (event && (event as any).data instanceof Buffer) {\n          data = (event as any).data.toString();\n        } else {\n          // fallback for other types\n          data = event.toString();\n        }\n        const message: WebsocketMessageServer = JSON.parse(data);\n        if (message.event === 'config-update') {\n          console.log('Config update received');\n          this.socket.off('message', configListener);\n          this.eventEmitter.emit(\n            'connect',\n            new EventResponse<void>((screen, name, description) => {\n              return this.userInputAsked(\n                screen,\n                name,\n                description,\n                this.socket\n              );\n            })\n          );\n        }\n      };\n      this.socket.on('message', configListener);\n    });\n\n    this.socket.on('error', (error) => {\n      if (error.message.includes('Failed to connect')) {\n        throw new Error(\n          'OGI Addon Server is not running/is unreachable. Please start the server and try again.'\n        );\n      }\n      console.error('An error occurred:', error);\n    });\n\n    this.socket.on('close', (code, reason) => {\n      if (code === 1008) {\n        console.error('Authentication failed:', reason);\n        return;\n      }\n      this.eventEmitter.emit('disconnect', reason);\n      console.log('Disconnected from OGI Addon Server');\n      console.error(reason.toString());\n      this.eventEmitter.emit('exit');\n      this.socket.close();\n    });\n\n    this.registerMessageReceiver();\n  }\n\n  private async userInputAsked<\n    U extends Record<string, string | number | boolean>,\n  >(\n    configBuilt: ConfigurationBuilder<U>,\n    name: string,\n    description: string,\n    socket: WebSocket\n  ): Promise<U> {\n    const config = configBuilt.build(false);\n    const id = Math.random().toString(36).substring(7);\n    if (!socket) {\n      throw new Error('Socket is not connected');\n    }\n    socket.send(\n      JSON.stringify({\n        event: 'input-asked',\n        args: {\n          config,\n          name,\n          description,\n        },\n        id: id,\n      })\n    );\n    return await this.waitForResponseFromServer<U>(id);\n  }\n\n  private registerMessageReceiver() {\n    this.socket.on('message', async (data: string) => {\n      const message: WebsocketMessageServer = JSON.parse(data);\n      switch (message.event) {\n        case 'config-update':\n          const result = this.addon.config.updateConfig(message.args);\n          if (!result[0]) {\n            this.respondToMessage(\n              message.id!!,\n              {\n                success: false,\n                error: result[1],\n              },\n              undefined\n            );\n          } else {\n            this.respondToMessage(message.id!!, { success: true }, undefined);\n          }\n          break;\n        case 'search':\n          let searchResultEvent = new EventResponse<SearchResult[]>(\n            (screen, name, description) =>\n              this.userInputAsked(screen, name, description, this.socket)\n          );\n          this.eventEmitter.emit('search', message.args, searchResultEvent);\n          const searchResult =\n            await this.waitForEventToRespond(searchResultEvent);\n          this.respondToMessage(\n            message.id!!,\n            searchResult.data,\n            searchResultEvent\n          );\n          break;\n        case 'setup': {\n          let setupEvent = new EventResponse<SetupEventResponse>(\n            (screen, name, description) =>\n              this.userInputAsked(screen, name, description, this.socket)\n          );\n          this.eventEmitter.emit('setup', message.args, setupEvent);\n          const interval = setInterval(() => {\n            if (setupEvent.resolved) {\n              clearInterval(interval);\n              return;\n            }\n            this.send('defer-update', {\n              logs: setupEvent.logs,\n              deferID: message.args.deferID,\n              progress: setupEvent.progress,\n              failed: setupEvent.failed,\n            } as ClientSentEventTypes['defer-update']);\n          }, 100);\n          const setupResult = await this.waitForEventToRespond(setupEvent);\n          this.respondToMessage(message.id!!, setupResult.data, setupEvent);\n          break;\n        }\n        case 'library-search':\n          let librarySearchEvent = new EventResponse<BasicLibraryInfo[]>(\n            (screen, name, description) =>\n              this.userInputAsked(screen, name, description, this.socket)\n          );\n          this.eventEmitter.emit(\n            'library-search',\n            message.args,\n            librarySearchEvent\n          );\n          const librarySearchResult =\n            await this.waitForEventToRespond(librarySearchEvent);\n          this.respondToMessage(\n            message.id!!,\n            librarySearchResult.data,\n            librarySearchEvent\n          );\n          break;\n        case 'game-details':\n          let gameDetailsEvent = new EventResponse<StoreData | undefined>(\n            (screen, name, description) =>\n              this.userInputAsked(screen, name, description, this.socket)\n          );\n          if (this.eventEmitter.listenerCount('game-details') === 0) {\n            this.respondToMessage(\n              message.id!!,\n              {\n                error: 'No event listener for game-details',\n              },\n              gameDetailsEvent\n            );\n            break;\n          }\n          this.eventEmitter.emit(\n            'game-details',\n            message.args,\n            gameDetailsEvent\n          );\n          const gameDetailsResult =\n            await this.waitForEventToRespond(gameDetailsEvent);\n          this.respondToMessage(\n            message.id!!,\n            gameDetailsResult.data,\n            gameDetailsEvent\n          );\n          break;\n        case 'check-for-updates':\n          let checkForUpdatesEvent = new EventResponse<\n            | {\n                available: true;\n                version: string;\n              }\n            | {\n                available: false;\n              }\n          >((screen, name, description) =>\n            this.userInputAsked(screen, name, description, this.socket)\n          );\n          this.eventEmitter.emit(\n            'check-for-updates',\n            message.args,\n            checkForUpdatesEvent\n          );\n          const checkForUpdatesResult =\n            await this.waitForEventToRespond(checkForUpdatesEvent);\n          this.respondToMessage(\n            message.id!!,\n            checkForUpdatesResult.data,\n            checkForUpdatesEvent\n          );\n          break;\n        case 'request-dl':\n          let requestDLEvent = new EventResponse<SearchResult>(\n            (screen, name, description) =>\n              this.userInputAsked(screen, name, description, this.socket)\n          );\n          if (this.eventEmitter.listenerCount('request-dl') === 0) {\n            this.respondToMessage(\n              message.id!!,\n              {\n                error: 'No event listener for request-dl',\n              },\n              requestDLEvent\n            );\n            break;\n          }\n          this.eventEmitter.emit(\n            'request-dl',\n            message.args.appID,\n            message.args.info,\n            requestDLEvent\n          );\n          const requestDLResult =\n            await this.waitForEventToRespond(requestDLEvent);\n          if (requestDLEvent.failed) {\n            this.respondToMessage(message.id!!, undefined, requestDLEvent);\n            break;\n          }\n          if (\n            requestDLEvent.data === undefined ||\n            requestDLEvent.data?.downloadType === 'request'\n          ) {\n            throw new Error(\n              'Request DL event did not return a valid result. Please ensure that the event does not resolve with another `request` download type.'\n            );\n          }\n          this.respondToMessage(\n            message.id!!,\n            requestDLResult.data,\n            requestDLEvent\n          );\n          break;\n        case 'catalog':\n          let catalogEvent = new EventResponse<CatalogResponse>();\n          this.eventEmitter.emit('catalog', catalogEvent);\n          const catalogResult = await this.waitForEventToRespond(catalogEvent);\n          this.respondToMessage(message.id!!, catalogResult.data, catalogEvent);\n          break;\n        case 'task-run': {\n          let taskRunEvent = new EventResponse<void>(\n            (screen, name, description) =>\n              this.userInputAsked(screen, name, description, this.socket)\n          );\n\n          // Check for taskName: first from args directly (from SearchResult), then from manifest.__taskName (for ActionOption)\n          const taskName =\n            message.args.taskName && typeof message.args.taskName === 'string'\n              ? message.args.taskName\n              : message.args.manifest &&\n                  typeof message.args.manifest === 'object'\n                ? (message.args.manifest as Record<string, unknown>).__taskName\n                : undefined;\n\n          if (\n            taskName &&\n            typeof taskName === 'string' &&\n            this.addon.hasTaskHandler(taskName)\n          ) {\n            // Use the registered task handler\n            const handler = this.addon.getTaskHandler(taskName)!;\n            const task = new Task(taskRunEvent);\n            try {\n              const interval = setInterval(() => {\n                if (taskRunEvent.resolved) {\n                  clearInterval(interval);\n                  return;\n                }\n                this.send('defer-update', {\n                  logs: taskRunEvent.logs,\n                  deferID: message.args.deferID,\n                  progress: taskRunEvent.progress,\n                  failed: taskRunEvent.failed,\n                } as ClientSentEventTypes['defer-update']);\n              }, 100);\n              const result = handler(task, {\n                manifest: message.args.manifest || {},\n                downloadPath: message.args.downloadPath || '',\n                name: message.args.name || '',\n                libraryInfo: message.args.libraryInfo,\n              });\n              // If handler returns a promise, wait for it\n              if (result instanceof Promise) {\n                await result;\n              }\n\n              clearInterval(interval);\n            } catch (error) {\n              taskRunEvent.fail(\n                error instanceof Error ? error.message : String(error)\n              );\n            }\n          } else {\n            // No handler found - fail the task\n            taskRunEvent.fail(\n              taskName\n                ? `No task handler registered for task name: ${taskName}`\n                : 'No task name provided'\n            );\n          }\n\n          const taskRunResult = await this.waitForEventToRespond(taskRunEvent);\n          this.respondToMessage(message.id!!, taskRunResult.data, taskRunEvent);\n          break;\n        }\n      }\n    });\n  }\n\n  private waitForEventToRespond<T>(\n    event: EventResponse<T>\n  ): Promise<EventResponse<T>> {\n    // check the handlers to see if there even is any\n    return new Promise((resolve, reject) => {\n      const dataGet = setInterval(() => {\n        if (event.resolved) {\n          resolve(event);\n          clearTimeout(timeout);\n        }\n      }, 5);\n\n      const timeout = setTimeout(() => {\n        if (event.deffered) {\n          clearInterval(dataGet);\n          const interval = setInterval(() => {\n            if (event.resolved) {\n              clearInterval(interval);\n              resolve(event);\n            }\n          }, 100);\n        } else {\n          reject('Event did not respond in time');\n        }\n      }, 5000);\n    });\n  }\n\n  public respondToMessage(\n    messageID: string,\n    response: any,\n    originalEvent: EventResponse<any> | undefined\n  ) {\n    this.socket.send(\n      JSON.stringify({\n        event: 'response',\n        id: messageID,\n        args: response,\n        statusError: originalEvent ? originalEvent.failed : undefined,\n      })\n    );\n    console.log('dispatched response to ' + messageID);\n  }\n\n  public waitForResponseFromServer<T>(messageID: string): Promise<T> {\n    return new Promise((resolve) => {\n      const waiter = (data: string) => {\n        const message: WebsocketMessageClient = JSON.parse(data);\n        if (message.event !== 'response') {\n          this.socket.once('message', waiter);\n          return;\n        }\n        console.log('received response from ' + messageID);\n\n        if (message.id === messageID) {\n          resolve(message.args);\n        } else {\n          this.socket.once('message', waiter);\n        }\n      };\n      this.socket.once('message', waiter);\n    });\n  }\n\n  public send(\n    event: OGIAddonClientSentEvent,\n    args: ClientSentEventTypes[OGIAddonClientSentEvent]\n  ): string {\n    // generate a random id\n    const id = Math.random().toString(36).substring(7);\n    this.socket.send(\n      JSON.stringify({\n        event,\n        args,\n        id,\n      })\n    );\n    return id;\n  }\n\n  public close() {\n    this.socket.close();\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;ACkDA,MAAM,cAAc;AAKpB,MAAa,UAAUA;;;;;;;;;;;;;;;;AA6SvB,IAAqB,WAArB,MAA8B;CAC5B,AAAO,eAAe,IAAIC,oBAAO,cAAc;CAC/C,AAAO;CACP,AAAO;CACP,AAAO,SAAwB,IAAIC,2CAAc,EAAE,CAAC;CACpD,AAAQ,kBAAmC,EAAE;CAC7C,AAAQ,yBAAkC;CAC1C,AAAQ,+BAWJ,IAAI,KAAK;CAEb,YAAY,WAAkC;AAC5C,OAAK,YAAY;AACjB,OAAK,kBAAkB,IAAI,mBAAmB,MAAM,KAAK,aAAa;;;;;;;CAQxE,AAAO,GACL,OACA,UACA;AACA,OAAK,aAAa,GAAG,OAAO,SAAS;AACrC,OAAK,gBAAgB,KAAK,MAAM;AAEhC,MAAI,CAAC,KAAK,wBAAwB;AAChC,QAAK,gBAAgB,aAAa,KAAK,iBAAiB;AACtD,SAAK,gBAAgB,KAAK,QAAQ;KAChC,MAAM;KACN,OAAO,KAAK;KACb,CAAC;KACF;AACF,QAAK,yBAAyB;;;CAIlC,AAAO,KACL,OACA,GAAG,MACH;AACA,OAAK,aAAa,KAAK,OAAO,GAAG,KAAK;;;;;;CAOxC,AAAO,OAAO,cAA4B;AACxC,OAAK,gBAAgB,KAAK,gBAAgB,CAAC,aAAa,CAAC;;;;;;;;CAS3D,MAAa,cAAc,OAAe,YAAoB;EAC5D,MAAM,KAAK,KAAK,gBAAgB,KAAK,mBAAmB;GACtD;GACA;GACD,CAAC;AACF,SAAO,MAAM,KAAK,gBAAgB,0BAEhC,GAAG;;CAGP,MAAa,WAAW,OAAe,YAAoB;EACzD,MAAM,KAAK,KAAK,gBAAgB,KAAK,mBAAmB;GACtD;GACA;GACD,CAAC;AACF,SAAO,MAAM,KAAK,gBAAgB,0BAEhC,GAAG;;;;;;CAOP,MAAa,OAAsB;EACjC,MAAM,KAAK,KAAK,QAAQ,CAAC,SAAS,GAAG,CAAC,UAAU,EAAE;EAClD,MAAM,WAAW;EACjB,MAAM,OAAiB,EAAE;EACzB,MAAM,OAAO,IAAI,KAAK,KAAK,iBAAiB,IAAI,UAAU,KAAK;AAC/D,OAAK,gBAAgB,KAAK,eAAe;GACvC;GACA;GACA;GACA,UAAU;GACV,QAAQ;GACT,CAAC;AACF,SAAO;;;;;;;;;;;;;;;;;CAkBT,AAAO,OACL,UACA,SASM;AACN,OAAK,aAAa,IAAI,UAAU,QAAQ;;;;;;;CAQ1C,AAAO,eAAe,UAA2B;AAC/C,SAAO,KAAK,aAAa,IAAI,SAAS;;;;;;;CAQxC,AAAO,eAAe,UAUR;AACZ,SAAO,KAAK,aAAa,IAAI,SAAS;;;;;;;;;CAUxC,MAAa,YACX,MACA,YACA,MACA;AACA,SAAO,IAAI,SAAe,SAAS,WAAW;AAE5C,OAAI,CAACC,gBAAG,WAAW,WAAW,CAC5B,iBAAG,UAAU,YAAY,EAAE,WAAW,MAAM,CAAC;AAG/C,OAAI,SAAS,QAEX,KAAI,QAAQ,aAAa,QAGvB,8BACE,yCAAmB,KAAK,OAAO,WAAW,KACzC,KAAU,QAAa,WAAgB;AACtC,QAAI,KAAK;AACP,aAAQ,MAAM,IAAI;AAClB,aAAQ,IAAI,OAAO;AACnB,4BAAO,IAAI,MAAM,6BAA6B,CAAC;AAC/C;;AAEF,YAAQ,IAAI,OAAO;AACnB,YAAQ,IAAI,OAAO;AACnB,aAAS;KAEZ;QACI;IAEL,MAAM,6CACJ,SACA;KACE;KACA;KACA;KACA;KACD,EACD,EACE,KAAK;KACH,GAAG,QAAQ;KACX,iCAAiC;KAClC,EACF,CACF;AAED,iBAAa,OAAO,GAAG,SAAS,SAAiB;AAC/C,aAAQ,IAAI,mBAAmB,OAAO;MACtC;AAEF,iBAAa,OAAO,GAAG,SAAS,SAAiB;AAC/C,aAAQ,MAAM,mBAAmB,OAAO;MACxC;AAEF,iBAAa,GAAG,UAAU,SAAiB;AACzC,SAAI,SAAS,GAAG;AACd,cAAQ,MAAM,kCAAkC,OAAO;AACvD,6BAAO,IAAI,MAAM,6BAA6B,CAAC;AAC/C;;AAEF,cAAS;MACT;;YAEK,SAAS,QAClB,KAAI,QAAQ,aAAa,QAGvB,8BACE,yCAAmB,KAAK,OAAO,WAAW,KACzC,KAAU,QAAa,WAAgB;AACtC,QAAI,KAAK;AACP,aAAQ,MAAM,IAAI;AAClB,aAAQ,IAAI,OAAO;AACnB,4BAAO,IAAI,MAAM,6BAA6B,CAAC;AAC/C;;AAEF,YAAQ,IAAI,OAAO;AACnB,YAAQ,IAAI,OAAO;AACnB,aAAS;KAEZ;QACI;IAEL,MAAM,6CAAqB,SAAS;KAAC;KAAK;KAAM;KAAM;KAAW,CAAC;AAElE,iBAAa,OAAO,GAAG,SAAS,SAAiB;AAC/C,aAAQ,IAAI,mBAAmB,OAAO;MACtC;AAEF,iBAAa,OAAO,GAAG,SAAS,SAAiB;AAC/C,aAAQ,MAAM,mBAAmB,OAAO;MACxC;AAEF,iBAAa,GAAG,UAAU,SAAiB;AACzC,SAAI,SAAS,GAAG;AACd,cAAQ,MAAM,kCAAkC,OAAO;AACvD,6BAAO,IAAI,MAAM,6BAA6B,CAAC;AAC/C;;AAEF,cAAS;MACT;;OAGJ,wBAAO,IAAI,MAAM,0BAA0B,CAAC;IAE9C;;;;;;;;AASN,IAAa,OAAb,MAAkB;CAEhB,AAAQ;CAGR,AAAQ;CACR,AAAiB;CACjB,AAAQ,WAAmB;CAC3B,AAAQ,OAAiB,EAAE;CAC3B,AAAQ,WAAoB;CAC5B,AAAQ,SAA6B;CAsBrC,YACE,WACA,IACA,UACA,MACA;AACA,MAAI,qBAAqBC,uBAAe;AAEtC,QAAK,QAAQ;AACb,QAAK,MAAM,OAAO;SACb;AAEL,QAAK,KAAK;AACV,QAAK,KAAK;AACV,QAAK,WAAW,YAAY;AAC5B,QAAK,OAAO,QAAQ,EAAE;;;;;;;CAQ1B,IAAI,SAAuB;AACzB,MAAI,KAAK,MACP,MAAK,MAAM,IAAI,QAAQ;OAClB;AACL,QAAK,KAAK,KAAK,QAAQ;AACvB,QAAK,QAAQ;;AAEf,SAAO;;;;;;CAOT,YAAY,UAAwB;AAClC,MAAI,KAAK,MACP,MAAK,MAAM,WAAW;OACjB;AACL,QAAK,WAAW;AAChB,QAAK,QAAQ;;AAEf,SAAO;;;;;CAMT,WAAiB;AACf,MAAI,KAAK,MACP,MAAK,MAAM,UAAU;OAChB;AACL,QAAK,WAAW;AAChB,QAAK,QAAQ;;;;;;;CAQjB,KAAK,SAAuB;AAC1B,MAAI,KAAK,MACP,MAAK,MAAM,KAAK,QAAQ;OACnB;AACL,QAAK,SAAS;AACd,QAAK,QAAQ;;;;;;;;;;;;;CAcjB,MAAM,YACJ,MACA,aACA,QACY;AACZ,MAAI,CAAC,KAAK,MACR,OAAM,IAAI,MACR,kFACD;AAEH,SAAO,KAAK,MAAM,YAAY,MAAM,aAAa,OAAO;;;;;;CAO1D,AAAQ,SAAe;AACrB,MAAI,KAAK,MAAM,KAAK,OAAO,OACzB,MAAK,GAAG,KAAK,eAAe;GAC1B,IAAI,KAAK;GACT,UAAU,KAAK;GACf,MAAM,KAAK;GACX,UAAU,KAAK;GACf,QAAQ,KAAK;GACd,CAAC;;;;;;;;;;;AAYR,IAAa,aAAb,MAA2B;CACzB,AAAQ;CACR,YACE,OACA,MACA,UAAyC;EACvC,WAAW;EACX,cAAc;EACf,EACD;AACA,OAAK,OAAO,IAAIC,gBAAK,OAAO;GAC1B;GACA,GAAG;GACJ,CAAC;;CAEJ,AAAO,OAAO,OAAe,QAAgB,IAAS;AACpD,SAAO,KAAK,KACT,OAAO,MAAM,CACb,MAAM,GAAG,MAAM,CACf,KAAK,WAAW,OAAO,KAAK;;CAEjC,AAAO,SAAS,OAAY;AAC1B,QAAM,KAAK,SAAS,KAAK,KAAK,IAAI,KAAK,CAAC;;;;;;AAM5C,MAAa,iBAAiBC,MAAE,OAAO;CACrC,MAAMA,MAAE,QAAQ;CAChB,SAASA,MAAE,QAAQ;CACnB,KAAKA,MAAE,QAAQ;CACf,OAAOA,MAAE,QAAQ;CACjB,kBAAkBA,MAAE,QAAQ;CAC5B,iBAAiBA,MAAE,QAAQ,CAAC,UAAU;CACtC,cAAcA,MAAE,QAAQ;CACxB,YAAYA,MAAE,QAAQ;CACtB,aAAaA,MAAE,QAAQ;CACvB,YAAYA,MAAE,QAAQ;CACtB,YAAYA,MAAE,QAAQ,CAAC,UAAU;CAClC,CAAC;AAOF,IAAM,qBAAN,MAAyB;CACvB,AAAQ;CACR,AAAO;CACP,AAAO;CAEP,YAAY,UAAoB,cAAmC;AACjE,MACE,QAAQ,KAAK,QAAQ,KAAK,SAAS,GAAG,MAAM,IAAI,CAAC,OAAO,gBAExD,OAAM,IAAI,MACR,sGACD;AAEH,OAAK,QAAQ;AACb,OAAK,eAAe;AACpB,OAAK,SAAS,IAAI,WAAG,oBAAoB,YAAY;AACrD,OAAK,OAAO,GAAG,cAAc;AAC3B,WAAQ,IAAI,gCAAgC;AAC5C,WAAQ,IAAI,6BAA6B,QAAQ;AAGjD,QAAK,KAAK,gBAAgB;IACxB,GAAG,KAAK,MAAM;IACd,QAAQ,QAAQ,KAAK,QAAQ,KAAK,SAAS,GAAG,MAAM,IAAI,CAAC;IACzD,YAAY;IACb,CAAC;GAGF,IAAI,gBAAgB,IAAIC,0DAAsB;AAC9C,QAAK,aAAa,KAAK,aAAa,cAAc;AAClD,QAAK,KAAK,aAAa,cAAc,MAAM,MAAM,CAAC;AAClD,QAAK,MAAM,SAAS,IAAIL,2CAAc,cAAc,MAAM,KAAK,CAAC;GAGhE,MAAM,kBAAkB,UAA2B;AACjD,QAAI,UAAU,OAAW;IAEzB,IAAI;AACJ,QAAI,OAAO,UAAU,SACnB,QAAO;aACE,iBAAiB,OAC1B,QAAO,MAAM,UAAU;aACd,SAAS,OAAQ,MAAc,SAAS,SACjD,QAAQ,MAAc;aACb,SAAU,MAAc,gBAAgB,OACjD,QAAQ,MAAc,KAAK,UAAU;QAGrC,QAAO,MAAM,UAAU;AAGzB,QADwC,KAAK,MAAM,KAAK,CAC5C,UAAU,iBAAiB;AACrC,aAAQ,IAAI,yBAAyB;AACrC,UAAK,OAAO,IAAI,WAAW,eAAe;AAC1C,UAAK,aAAa,KAChB,WACA,IAAIE,uBAAqB,QAAQ,MAAM,gBAAgB;AACrD,aAAO,KAAK,eACV,QACA,MACA,aACA,KAAK,OACN;OACD,CACH;;;AAGL,QAAK,OAAO,GAAG,WAAW,eAAe;IACzC;AAEF,OAAK,OAAO,GAAG,UAAU,UAAU;AACjC,OAAI,MAAM,QAAQ,SAAS,oBAAoB,CAC7C,OAAM,IAAI,MACR,yFACD;AAEH,WAAQ,MAAM,sBAAsB,MAAM;IAC1C;AAEF,OAAK,OAAO,GAAG,UAAU,MAAM,WAAW;AACxC,OAAI,SAAS,MAAM;AACjB,YAAQ,MAAM,0BAA0B,OAAO;AAC/C;;AAEF,QAAK,aAAa,KAAK,cAAc,OAAO;AAC5C,WAAQ,IAAI,qCAAqC;AACjD,WAAQ,MAAM,OAAO,UAAU,CAAC;AAChC,QAAK,aAAa,KAAK,OAAO;AAC9B,QAAK,OAAO,OAAO;IACnB;AAEF,OAAK,yBAAyB;;CAGhC,MAAc,eAGZ,aACA,MACA,aACA,QACY;EACZ,MAAM,SAAS,YAAY,MAAM,MAAM;EACvC,MAAM,KAAK,KAAK,QAAQ,CAAC,SAAS,GAAG,CAAC,UAAU,EAAE;AAClD,MAAI,CAAC,OACH,OAAM,IAAI,MAAM,0BAA0B;AAE5C,SAAO,KACL,KAAK,UAAU;GACb,OAAO;GACP,MAAM;IACJ;IACA;IACA;IACD;GACG;GACL,CAAC,CACH;AACD,SAAO,MAAM,KAAK,0BAA6B,GAAG;;CAGpD,AAAQ,0BAA0B;AAChC,OAAK,OAAO,GAAG,WAAW,OAAO,SAAiB;GAChD,MAAM,UAAkC,KAAK,MAAM,KAAK;AACxD,WAAQ,QAAQ,OAAhB;IACE,KAAK;KACH,MAAM,SAAS,KAAK,MAAM,OAAO,aAAa,QAAQ,KAAK;AAC3D,SAAI,CAAC,OAAO,GACV,MAAK,iBACH,QAAQ,IACR;MACE,SAAS;MACT,OAAO,OAAO;MACf,EACD,OACD;SAED,MAAK,iBAAiB,QAAQ,IAAM,EAAE,SAAS,MAAM,EAAE,OAAU;AAEnE;IACF,KAAK;KACH,IAAI,oBAAoB,IAAIA,uBACzB,QAAQ,MAAM,gBACb,KAAK,eAAe,QAAQ,MAAM,aAAa,KAAK,OAAO,CAC9D;AACD,UAAK,aAAa,KAAK,UAAU,QAAQ,MAAM,kBAAkB;KACjE,MAAM,eACJ,MAAM,KAAK,sBAAsB,kBAAkB;AACrD,UAAK,iBACH,QAAQ,IACR,aAAa,MACb,kBACD;AACD;IACF,KAAK,SAAS;KACZ,IAAI,aAAa,IAAIA,uBAClB,QAAQ,MAAM,gBACb,KAAK,eAAe,QAAQ,MAAM,aAAa,KAAK,OAAO,CAC9D;AACD,UAAK,aAAa,KAAK,SAAS,QAAQ,MAAM,WAAW;KACzD,MAAM,WAAW,kBAAkB;AACjC,UAAI,WAAW,UAAU;AACvB,qBAAc,SAAS;AACvB;;AAEF,WAAK,KAAK,gBAAgB;OACxB,MAAM,WAAW;OACjB,SAAS,QAAQ,KAAK;OACtB,UAAU,WAAW;OACrB,QAAQ,WAAW;OACpB,CAAyC;QACzC,IAAI;KACP,MAAM,cAAc,MAAM,KAAK,sBAAsB,WAAW;AAChE,UAAK,iBAAiB,QAAQ,IAAM,YAAY,MAAM,WAAW;AACjE;;IAEF,KAAK;KACH,IAAI,qBAAqB,IAAIA,uBAC1B,QAAQ,MAAM,gBACb,KAAK,eAAe,QAAQ,MAAM,aAAa,KAAK,OAAO,CAC9D;AACD,UAAK,aAAa,KAChB,kBACA,QAAQ,MACR,mBACD;KACD,MAAM,sBACJ,MAAM,KAAK,sBAAsB,mBAAmB;AACtD,UAAK,iBACH,QAAQ,IACR,oBAAoB,MACpB,mBACD;AACD;IACF,KAAK;KACH,IAAI,mBAAmB,IAAIA,uBACxB,QAAQ,MAAM,gBACb,KAAK,eAAe,QAAQ,MAAM,aAAa,KAAK,OAAO,CAC9D;AACD,SAAI,KAAK,aAAa,cAAc,eAAe,KAAK,GAAG;AACzD,WAAK,iBACH,QAAQ,IACR,EACE,OAAO,sCACR,EACD,iBACD;AACD;;AAEF,UAAK,aAAa,KAChB,gBACA,QAAQ,MACR,iBACD;KACD,MAAM,oBACJ,MAAM,KAAK,sBAAsB,iBAAiB;AACpD,UAAK,iBACH,QAAQ,IACR,kBAAkB,MAClB,iBACD;AACD;IACF,KAAK;KACH,IAAI,uBAAuB,IAAIA,uBAQ5B,QAAQ,MAAM,gBACf,KAAK,eAAe,QAAQ,MAAM,aAAa,KAAK,OAAO,CAC5D;AACD,UAAK,aAAa,KAChB,qBACA,QAAQ,MACR,qBACD;KACD,MAAM,wBACJ,MAAM,KAAK,sBAAsB,qBAAqB;AACxD,UAAK,iBACH,QAAQ,IACR,sBAAsB,MACtB,qBACD;AACD;IACF,KAAK;KACH,IAAI,iBAAiB,IAAIA,uBACtB,QAAQ,MAAM,gBACb,KAAK,eAAe,QAAQ,MAAM,aAAa,KAAK,OAAO,CAC9D;AACD,SAAI,KAAK,aAAa,cAAc,aAAa,KAAK,GAAG;AACvD,WAAK,iBACH,QAAQ,IACR,EACE,OAAO,oCACR,EACD,eACD;AACD;;AAEF,UAAK,aAAa,KAChB,cACA,QAAQ,KAAK,OACb,QAAQ,KAAK,MACb,eACD;KACD,MAAM,kBACJ,MAAM,KAAK,sBAAsB,eAAe;AAClD,SAAI,eAAe,QAAQ;AACzB,WAAK,iBAAiB,QAAQ,IAAM,QAAW,eAAe;AAC9D;;AAEF,SACE,eAAe,SAAS,UACxB,eAAe,MAAM,iBAAiB,UAEtC,OAAM,IAAI,MACR,sIACD;AAEH,UAAK,iBACH,QAAQ,IACR,gBAAgB,MAChB,eACD;AACD;IACF,KAAK;KACH,IAAI,eAAe,IAAIA,uBAAgC;AACvD,UAAK,aAAa,KAAK,WAAW,aAAa;KAC/C,MAAM,gBAAgB,MAAM,KAAK,sBAAsB,aAAa;AACpE,UAAK,iBAAiB,QAAQ,IAAM,cAAc,MAAM,aAAa;AACrE;IACF,KAAK,YAAY;KACf,IAAI,eAAe,IAAIA,uBACpB,QAAQ,MAAM,gBACb,KAAK,eAAe,QAAQ,MAAM,aAAa,KAAK,OAAO,CAC9D;KAGD,MAAM,WACJ,QAAQ,KAAK,YAAY,OAAO,QAAQ,KAAK,aAAa,WACtD,QAAQ,KAAK,WACb,QAAQ,KAAK,YACX,OAAO,QAAQ,KAAK,aAAa,WAChC,QAAQ,KAAK,SAAqC,aACnD;AAER,SACE,YACA,OAAO,aAAa,YACpB,KAAK,MAAM,eAAe,SAAS,EACnC;MAEA,MAAM,UAAU,KAAK,MAAM,eAAe,SAAS;MACnD,MAAM,OAAO,IAAI,KAAK,aAAa;AACnC,UAAI;OACF,MAAM,WAAW,kBAAkB;AACjC,YAAI,aAAa,UAAU;AACzB,uBAAc,SAAS;AACvB;;AAEF,aAAK,KAAK,gBAAgB;SACxB,MAAM,aAAa;SACnB,SAAS,QAAQ,KAAK;SACtB,UAAU,aAAa;SACvB,QAAQ,aAAa;SACtB,CAAyC;UACzC,IAAI;OACP,MAAM,SAAS,QAAQ,MAAM;QAC3B,UAAU,QAAQ,KAAK,YAAY,EAAE;QACrC,cAAc,QAAQ,KAAK,gBAAgB;QAC3C,MAAM,QAAQ,KAAK,QAAQ;QAC3B,aAAa,QAAQ,KAAK;QAC3B,CAAC;AAEF,WAAI,kBAAkB,QACpB,OAAM;AAGR,qBAAc,SAAS;eAChB,OAAO;AACd,oBAAa,KACX,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,CACvD;;WAIH,cAAa,KACX,WACI,6CAA6C,aAC7C,wBACL;KAGH,MAAM,gBAAgB,MAAM,KAAK,sBAAsB,aAAa;AACpE,UAAK,iBAAiB,QAAQ,IAAM,cAAc,MAAM,aAAa;AACrE;;;IAGJ;;CAGJ,AAAQ,sBACN,OAC2B;AAE3B,SAAO,IAAI,SAAS,SAAS,WAAW;GACtC,MAAM,UAAU,kBAAkB;AAChC,QAAI,MAAM,UAAU;AAClB,aAAQ,MAAM;AACd,kBAAa,QAAQ;;MAEtB,EAAE;GAEL,MAAM,UAAU,iBAAiB;AAC/B,QAAI,MAAM,UAAU;AAClB,mBAAc,QAAQ;KACtB,MAAM,WAAW,kBAAkB;AACjC,UAAI,MAAM,UAAU;AAClB,qBAAc,SAAS;AACvB,eAAQ,MAAM;;QAEf,IAAI;UAEP,QAAO,gCAAgC;MAExC,IAAK;IACR;;CAGJ,AAAO,iBACL,WACA,UACA,eACA;AACA,OAAK,OAAO,KACV,KAAK,UAAU;GACb,OAAO;GACP,IAAI;GACJ,MAAM;GACN,aAAa,gBAAgB,cAAc,SAAS;GACrD,CAAC,CACH;AACD,UAAQ,IAAI,4BAA4B,UAAU;;CAGpD,AAAO,0BAA6B,WAA+B;AACjE,SAAO,IAAI,SAAS,YAAY;GAC9B,MAAM,UAAU,SAAiB;IAC/B,MAAM,UAAkC,KAAK,MAAM,KAAK;AACxD,QAAI,QAAQ,UAAU,YAAY;AAChC,UAAK,OAAO,KAAK,WAAW,OAAO;AACnC;;AAEF,YAAQ,IAAI,4BAA4B,UAAU;AAElD,QAAI,QAAQ,OAAO,UACjB,SAAQ,QAAQ,KAAK;QAErB,MAAK,OAAO,KAAK,WAAW,OAAO;;AAGvC,QAAK,OAAO,KAAK,WAAW,OAAO;IACnC;;CAGJ,AAAO,KACL,OACA,MACQ;EAER,MAAM,KAAK,KAAK,QAAQ,CAAC,SAAS,GAAG,CAAC,UAAU,EAAE;AAClD,OAAK,OAAO,KACV,KAAK,UAAU;GACb;GACA;GACA;GACD,CAAC,CACH;AACD,SAAO;;CAGT,AAAO,QAAQ;AACb,OAAK,OAAO,OAAO"}
+{"version":3,"file":"main.cjs","names":["pjson.version","events","Configuration","fs","EventResponse","Fuse","z","ConfigurationBuilder"],"sources":["../package.json","../src/main.ts"],"sourcesContent":["","import ws, { WebSocket } from 'ws';\nimport events from 'node:events';\nimport { ConfigurationBuilder } from './config/ConfigurationBuilder';\nimport type { ConfigurationFile } from './config/ConfigurationBuilder';\nimport { Configuration } from './config/Configuration';\nimport EventResponse from './EventResponse';\nimport type { SearchResult } from './SearchEngine';\nimport Fuse, { IFuseOptions } from 'fuse.js';\n\n/**\n * Exposed events that the programmer can use to listen to and emit events.\n */\nexport type OGIAddonEvent =\n  | 'connect'\n  | 'disconnect'\n  | 'configure'\n  | 'authenticate'\n  | 'search'\n  | 'setup'\n  | 'library-search'\n  | 'game-details'\n  | 'exit'\n  | 'check-for-updates'\n  | 'request-dl'\n  | 'catalog'\n  | 'launch-app';\n\n/**\n * The events that the client can send to the server and are handled by the server.\n */\nexport type OGIAddonClientSentEvent =\n  | 'response'\n  | 'authenticate'\n  | 'configure'\n  | 'defer-update'\n  | 'notification'\n  | 'input-asked'\n  | 'get-app-details'\n  | 'search-app-name'\n  | 'flag'\n  | 'task-update';\n\n/**\n * The events that the server sends to the client\n * This is the events that the server can send to the client and are handled by the client.\n */\nexport type OGIAddonServerSentEvent =\n  | 'authenticate'\n  | 'configure'\n  | 'config-update'\n  | 'launch-app'\n  | 'search'\n  | 'setup'\n  | 'response'\n  | 'library-search'\n  | 'check-for-updates'\n  | 'task-run'\n  | 'game-details'\n  | 'request-dl'\n  | 'catalog';\nexport { ConfigurationBuilder, Configuration, EventResponse };\nexport type { SearchResult };\nconst defaultPort = 7654;\nimport pjson from '../package.json';\nimport { exec, spawn } from 'node:child_process';\nimport fs from 'node:fs';\nimport { z } from 'zod';\nexport const VERSION = pjson.version;\n\nexport interface ClientSentEventTypes {\n  response: any;\n  authenticate: {\n    name: string;\n    id: string;\n    description: string;\n    version: string;\n    author: string;\n  };\n  configure: ConfigurationFile;\n  'defer-update': {\n    logs: string[];\n    progress: number;\n  };\n  notification: Notification;\n  'input-asked': ConfigurationBuilder<\n    Record<string, string | number | boolean>\n  >;\n  'task-update': {\n    id: string;\n    progress: number;\n    logs: string[];\n    finished: boolean;\n    failed: string | undefined;\n  };\n  'get-app-details': {\n    appID: number;\n    storefront: string;\n  };\n  'search-app-name': {\n    query: string;\n    storefront: string;\n  };\n  flag: {\n    flag: string;\n    value: string | string[];\n  };\n}\n\nexport type BasicLibraryInfo = {\n  name: string;\n  capsuleImage: string;\n  appID: number;\n  storefront: string;\n};\n\nexport interface CatalogSection {\n  name: string;\n  description: string;\n  listings: BasicLibraryInfo[];\n}\n\nexport interface CatalogCarouselItem {\n  name: string;\n  description: string;\n  carouselImage: string;\n  fullBannerImage?: string;\n  appID?: number;\n  storefront?: string;\n  capsuleImage?: string;\n}\n\nexport interface CatalogWithCarousel {\n  sections: Record<string, CatalogSection>;\n  carousel?: Record<string, CatalogCarouselItem> | CatalogCarouselItem[];\n}\n\nexport type CatalogResponse =\n  | Record<string, CatalogSection>\n  | CatalogWithCarousel;\n\nexport type SetupEventResponse = Omit<\n  LibraryInfo,\n  | 'capsuleImage'\n  | 'coverImage'\n  | 'name'\n  | 'appID'\n  | 'storefront'\n  | 'addonsource'\n  | 'titleImage'\n> & {\n  redistributables?: {\n    name: string;\n    path: string;\n  }[];\n};\n\nexport interface EventListenerTypes {\n  /**\n   * This event is emitted when the addon connects to the OGI Addon Server. Addon does not need to resolve anything.\n   * @param event\n   * @returns\n   */\n  connect: (event: EventResponse<void>) => void;\n\n  /**\n   * This event is emitted when the client requests for the addon to disconnect. Addon does not need to resolve this event, but we recommend `process.exit(0)` so the addon can exit gracefully instead of by force by the addon server.\n   * @param reason\n   * @returns\n   */\n  disconnect: (reason: string) => void;\n  /**\n   * This event is emitted when the client requests for the addon to configure itself. Addon should resolve the event with the internal configuration. (See ConfigurationBuilder)\n   * @param config\n   * @returns\n   */\n  configure: (config: ConfigurationBuilder) => ConfigurationBuilder;\n  /**\n   * This event is called when the client provides a response to any event. This should be treated as middleware.\n   * @param response\n   * @returns\n   */\n  response: (response: any) => void;\n\n  /**\n   * This event is called when the client requests for the addon to authenticate itself. You don't need to provide any info.\n   * @param config\n   * @returns\n   */\n  authenticate: (config: any) => void;\n  /**\n   * This event is emitted when the client requests for a torrent/direct download search to be performed. Addon is given the gameID (could be a steam appID or custom store appID), along with the storefront type. Addon should resolve the event with the search results. (See SearchResult)\n   * @param query\n   * @param event\n   * @returns\n   */\n  search: (\n    query: {\n      storefront: string;\n      appID: number;\n    } & (\n      | {\n          for: 'game' | 'task' | 'all';\n        }\n      | {\n          for: 'update';\n          libraryInfo: LibraryInfo;\n        }\n    ),\n    event: EventResponse<SearchResult[]>\n  ) => void;\n  /**\n   * This event is emitted when the client requests for app setup to be performed. Addon should resolve the event with the metadata for the library entry. (See LibraryInfo)\n   * @param data\n   * @param event\n   * @returns\n   */\n  setup: (\n    data: {\n      path: string;\n      type: 'direct' | 'torrent' | 'magnet' | 'empty';\n      name: string;\n      usedRealDebrid: boolean;\n      clearOldFilesBeforeUpdate?: boolean;\n      multiPartFiles?: {\n        name: string;\n        downloadURL: string;\n      }[];\n      appID: number;\n      storefront: string;\n      manifest?: Record<string, unknown>;\n    } & (\n      | {\n          for: 'game';\n        }\n      | {\n          for: 'update';\n          currentLibraryInfo: LibraryInfo;\n        }\n    ),\n    event: EventResponse<SetupEventResponse>\n  ) => void;\n\n  /**\n   * This event is emitted when the client requires for a search to be performed. Input is the search query.\n   * @param query\n   * @param event\n   * @returns\n   */\n  'library-search': (\n    query: string,\n    event: EventResponse<BasicLibraryInfo[]>\n  ) => void;\n\n  /**\n   * This event is emitted when the client requests for a game details to be fetched. Addon should resolve the event with the game details. This is used to generate a store page for the game.\n   * @param appID\n   * @param event\n   * @returns\n   */\n  'game-details': (\n    details: { appID: number; storefront: string },\n    event: EventResponse<StoreData | undefined>\n  ) => void;\n\n  /**\n   * This event is emitted when the client requests for the addon to exit. Use this to perform any cleanup tasks, ending with a `process.exit(0)`.\n   * @returns\n   */\n  exit: () => void;\n\n  /**\n   * This event is emitted when the client requests for a download to be performed with the 'request' type. Addon should resolve the event with a SearchResult containing the actual download info.\n   * @param appID\n   * @param info\n   * @param event\n   * @returns\n   */\n  'request-dl': (\n    appID: number,\n    info: SearchResult,\n    event: EventResponse<SearchResult>\n  ) => void;\n\n  /**\n   * This event is emitted when the client requests for a catalog to be fetched. Addon should resolve the event with the catalog.\n   * @param event\n   * @returns\n   */\n  catalog: (event: Omit<EventResponse<CatalogResponse>, 'askForInput'>) => void;\n\n  /**\n   * This event is emitted when the client requests for an addon to check for updates. Addon should resolve the event with the update information.\n   * @param data\n   * @param event\n   * @returns\n   */\n  'check-for-updates': (\n    data: { appID: number; storefront: string; currentVersion: string },\n    event: EventResponse<\n      | {\n          available: true;\n          version: string;\n        }\n      | {\n          available: false;\n        }\n    >\n  ) => void;\n\n  /**\n   * This event is emitted when the client is going to launch an app. Addon should use this to perform any pre or post launch tasks.\n   * @param data {LibraryInfo} The library information for the app to be launched.\n   * @param launchType { 'pre' | 'post' } The type of launch task to perform.\n   * @param event {EventResponse<void>} The event response from the server.\n   */\n  'launch-app': (\n    data: { libraryInfo: LibraryInfo; launchType: 'pre' | 'post' },\n    event: EventResponse<void>\n  ) => void;\n}\n\nexport interface StoreData {\n  name: string;\n  publishers: string[];\n  developers: string[];\n  appID: number;\n  releaseDate: string;\n  capsuleImage: string;\n  coverImage: string;\n  basicDescription: string;\n  description: string;\n  headerImage: string;\n  latestVersion: string;\n}\nexport interface WebsocketMessageClient {\n  event: OGIAddonClientSentEvent;\n  id?: string;\n  args: any;\n  statusError?: string;\n}\nexport interface WebsocketMessageServer {\n  event: OGIAddonServerSentEvent;\n  id?: string;\n  args: any;\n  statusError?: string;\n}\n\n/**\n * The configuration for the addon. This is used to identify the addon and provide information about it.\n * Storefronts is an array of names of stores that the addon supports.\n */\nexport interface OGIAddonConfiguration {\n  name: string;\n  id: string;\n  description: string;\n  version: string;\n\n  author: string;\n  repository: string;\n  storefronts: string[];\n}\n\n/**\n * The main class for the OGI Addon. This class is used to interact with the OGI Addon Server. The OGI Addon Server provides a `--addonSecret` to the addon so it can securely connect.\n * @example\n * ```typescript\n * const addon = new OGIAddon({\n *  name: 'Test Addon',\n *   id: 'test-addon',\n *  description: 'A test addon',\n *  version: '1.0.0',\n *  author: 'OGI Developers',\n *  repository: ''\n * });\n * ```\n *\n */\nexport default class OGIAddon {\n  public eventEmitter = new events.EventEmitter();\n  public addonWSListener: OGIAddonWSListener;\n  public addonInfo: OGIAddonConfiguration;\n  public config: Configuration = new Configuration({});\n  private eventsAvailable: OGIAddonEvent[] = [];\n  private registeredConnectEvent: boolean = false;\n  private taskHandlers: Map<\n    string,\n    (\n      task: Task,\n      data: {\n        manifest: Record<string, unknown>;\n        downloadPath: string;\n        name: string;\n        libraryInfo: LibraryInfo;\n      }\n    ) => Promise<void> | void\n  > = new Map();\n\n  constructor(addonInfo: OGIAddonConfiguration) {\n    this.addonInfo = addonInfo;\n    this.addonWSListener = new OGIAddonWSListener(this, this.eventEmitter);\n  }\n\n  /**\n   * Register an event listener for the addon. (See EventListenerTypes)\n   * @param event {OGIAddonEvent}\n   * @param listener {EventListenerTypes[OGIAddonEvent]}\n   */\n  public on<T extends OGIAddonEvent>(\n    event: T,\n    listener: EventListenerTypes[T]\n  ) {\n    this.eventEmitter.on(event, listener);\n    this.eventsAvailable.push(event);\n    // wait for the addon to be connected\n    if (!this.registeredConnectEvent) {\n      this.addonWSListener.eventEmitter.once('connect', () => {\n        this.addonWSListener.send('flag', {\n          flag: 'events-available',\n          value: this.eventsAvailable,\n        });\n      });\n      this.registeredConnectEvent = true;\n    }\n  }\n\n  public emit<T extends OGIAddonEvent>(\n    event: T,\n    ...args: Parameters<EventListenerTypes[T]>\n  ) {\n    this.eventEmitter.emit(event, ...args);\n  }\n\n  /**\n   * Notify the client using a notification. Provide the type of notification, the message, and an ID.\n   * @param notification {Notification}\n   */\n  public notify(notification: Notification) {\n    this.addonWSListener.send('notification', [notification]);\n  }\n\n  /**\n   * Get the app details for a given appID and storefront.\n   * @param appID {number}\n   * @param storefront {string}\n   * @returns {Promise<StoreData>}\n   */\n  public async getAppDetails(appID: number, storefront: string) {\n    const id = this.addonWSListener.send('get-app-details', {\n      appID,\n      storefront,\n    });\n    return await this.addonWSListener.waitForResponseFromServer<\n      StoreData | undefined\n    >(id);\n  }\n\n  public async searchGame(query: string, storefront: string) {\n    const id = this.addonWSListener.send('search-app-name', {\n      query,\n      storefront,\n    });\n    return await this.addonWSListener.waitForResponseFromServer<\n      BasicLibraryInfo[]\n    >(id);\n  }\n\n  /**\n   * Notify the OGI Addon Server that you are performing a background task. This can be used to help users understand what is happening in the background.\n   * @returns {Promise<Task>} A Task instance for managing the background task.\n   */\n  public async task(): Promise<Task> {\n    const id = Math.random().toString(36).substring(7);\n    const progress = 0;\n    const logs: string[] = [];\n    const task = new Task(this.addonWSListener, id, progress, logs);\n    this.addonWSListener.send('task-update', {\n      id,\n      progress,\n      logs,\n      finished: false,\n      failed: undefined,\n    });\n    return task;\n  }\n\n  /**\n   * Register a task handler for a specific task name. The task name should match the taskName field in SearchResult or ActionOption.\n   * @param taskName {string} The name of the task (should match taskName in SearchResult or ActionOption.setTaskName()).\n   * @param handler {(task: Task, data: { manifest: Record<string, unknown>; downloadPath: string; name: string; libraryInfo: LibraryInfo }) => Promise<void> | void} The handler function.\n   * @example\n   * ```typescript\n   * addon.onTask('clearCache', async (task) => {\n   *   task.log('Clearing cache...');\n   *   task.setProgress(50);\n   *   await clearCacheFiles();\n   *   task.setProgress(100);\n   *   task.complete();\n   * });\n   * ```\n   */\n  public onTask(\n    taskName: string,\n    handler: (\n      task: Task,\n      data: {\n        manifest: Record<string, unknown>;\n        downloadPath: string;\n        name: string;\n        libraryInfo: LibraryInfo;\n      }\n    ) => Promise<void> | void\n  ): void {\n    this.taskHandlers.set(taskName, handler);\n  }\n\n  /**\n   * Check if a task handler is registered for the given task name.\n   * @param taskName {string} The task name to check.\n   * @returns {boolean} True if a handler is registered.\n   */\n  public hasTaskHandler(taskName: string): boolean {\n    return this.taskHandlers.has(taskName);\n  }\n\n  /**\n   * Get a task handler for the given task name.\n   * @param taskName {string} The task name.\n   * @returns The handler function or undefined if not found.\n   */\n  public getTaskHandler(taskName: string):\n    | ((\n        task: Task,\n        data: {\n          manifest: Record<string, unknown>;\n          downloadPath: string;\n          name: string;\n          libraryInfo?: LibraryInfo;\n        }\n      ) => Promise<void> | void)\n    | undefined {\n    return this.taskHandlers.get(taskName);\n  }\n\n  /**\n   * Extract a file using 7-Zip on Windows, unzip on Linux/Mac.\n   * @param path {string}\n   * @param outputPath {string}\n   * @param type {'unrar' | 'unzip'}\n   * @returns {Promise<void>}\n   */\n  public async extractFile(\n    path: string,\n    outputPath: string,\n    type: 'unrar' | 'unzip'\n  ) {\n    return new Promise<void>((resolve, reject) => {\n      // Ensure outputPath exists\n      if (!fs.existsSync(outputPath)) {\n        fs.mkdirSync(outputPath, { recursive: true });\n      }\n\n      if (type === 'unzip') {\n        // Prefer 7-Zip on Windows, unzip on Linux/Mac\n        if (process.platform === 'win32') {\n          // 7-Zip path (default install location)\n          const s7ZipPath = '\"C:\\\\Program Files\\\\7-Zip\\\\7z.exe\"';\n          exec(\n            `${s7ZipPath} x \"${path}\" -o\"${outputPath}\"`,\n            (err: any, stdout: any, stderr: any) => {\n              if (err) {\n                console.error(err);\n                console.log(stderr);\n                reject(new Error('Failed to extract ZIP file'));\n                return;\n              }\n              console.log(stdout);\n              console.log(stderr);\n              resolve();\n            }\n          );\n        } else {\n          // Use unzip on Linux/Mac\n          const unzipProcess = spawn(\n            'unzip',\n            [\n              '-o', // overwrite files without prompting\n              path,\n              '-d', // specify output directory\n              outputPath,\n            ],\n            {\n              env: {\n                ...process.env,\n                UNZIP_DISABLE_ZIPBOMB_DETECTION: 'TRUE',\n              },\n            }\n          );\n\n          unzipProcess.stdout.on('data', (data: Buffer) => {\n            console.log(`[unzip stdout]: ${data}`);\n          });\n\n          unzipProcess.stderr.on('data', (data: Buffer) => {\n            console.error(`[unzip stderr]: ${data}`);\n          });\n\n          unzipProcess.on('close', (code: number) => {\n            if (code !== 0) {\n              console.error(`unzip process exited with code ${code}`);\n              reject(new Error('Failed to extract ZIP file'));\n              return;\n            }\n            resolve();\n          });\n        }\n      } else if (type === 'unrar') {\n        if (process.platform === 'win32') {\n          // 7-Zip path (default install location)\n          const s7ZipPath = '\"C:\\\\Program Files\\\\7-Zip\\\\7z.exe\"';\n          exec(\n            `${s7ZipPath} x \"${path}\" -o\"${outputPath}\"`,\n            (err: any, stdout: any, stderr: any) => {\n              if (err) {\n                console.error(err);\n                console.log(stderr);\n                reject(new Error('Failed to extract RAR file'));\n                return;\n              }\n              console.log(stdout);\n              console.log(stderr);\n              resolve();\n            }\n          );\n        } else {\n          // Use unrar on Linux/Mac\n          const unrarProcess = spawn('unrar', ['x', '-y', path, outputPath]);\n\n          unrarProcess.stdout.on('data', (data: Buffer) => {\n            console.log(`[unrar stdout]: ${data}`);\n          });\n\n          unrarProcess.stderr.on('data', (data: Buffer) => {\n            console.error(`[unrar stderr]: ${data}`);\n          });\n\n          unrarProcess.on('close', (code: number) => {\n            if (code !== 0) {\n              console.error(`unrar process exited with code ${code}`);\n              reject(new Error('Failed to extract RAR file'));\n              return;\n            }\n            resolve();\n          });\n        }\n      } else {\n        reject(new Error('Unknown extraction type'));\n      }\n    });\n  }\n}\n\n/**\n * A unified task API for both server-initiated tasks (via onTask handlers)\n * and addon-initiated background tasks (via addon.task()).\n * Provides chainable methods for logging, progress updates, and completion.\n */\nexport class Task {\n  // EventResponse-based mode (for onTask handlers)\n  private event: EventResponse<void> | undefined;\n\n  // WebSocket-based mode (for addon.task())\n  private ws: OGIAddonWSListener | undefined;\n  private readonly id: string | undefined;\n  private progress: number = 0;\n  private logs: string[] = [];\n  private finished: boolean = false;\n  private failed: string | undefined = undefined;\n\n  /**\n   * Construct a Task from an EventResponse (for onTask handlers).\n   * @param event {EventResponse<void>} The event response to wrap.\n   */\n  constructor(event: EventResponse<void>);\n\n  /**\n   * Construct a Task from WebSocket listener (for addon.task()).\n   * @param ws {OGIAddonWSListener} The WebSocket listener.\n   * @param id {string} The task ID.\n   * @param progress {number} Initial progress (0-100).\n   * @param logs {string[]} Initial logs array.\n   */\n  constructor(\n    ws: OGIAddonWSListener,\n    id: string,\n    progress: number,\n    logs: string[]\n  );\n\n  constructor(\n    eventOrWs: EventResponse<void> | OGIAddonWSListener,\n    id?: string,\n    progress?: number,\n    logs?: string[]\n  ) {\n    if (eventOrWs instanceof EventResponse) {\n      // EventResponse-based mode\n      this.event = eventOrWs;\n      this.event.defer();\n    } else {\n      // WebSocket-based mode\n      this.ws = eventOrWs;\n      this.id = id!;\n      this.progress = progress ?? 0;\n      this.logs = logs ?? [];\n    }\n  }\n\n  /**\n   * Log a message to the task. Returns this for chaining.\n   * @param message {string} The message to log.\n   */\n  log(message: string): this {\n    if (this.event) {\n      this.event.log(message);\n    } else {\n      this.logs.push(message);\n      this.update();\n    }\n    return this;\n  }\n\n  /**\n   * Set the progress of the task (0-100). Returns this for chaining.\n   * @param progress {number} The progress value (0-100).\n   */\n  setProgress(progress: number): this {\n    if (this.event) {\n      this.event.progress = progress;\n    } else {\n      this.progress = progress;\n      this.update();\n    }\n    return this;\n  }\n\n  /**\n   * Complete the task successfully.\n   */\n  complete(): void {\n    if (this.event) {\n      this.event.complete();\n    } else {\n      this.finished = true;\n      this.update();\n    }\n  }\n\n  /**\n   * Fail the task with an error message.\n   * @param message {string} The error message.\n   */\n  fail(message: string): void {\n    if (this.event) {\n      this.event.fail(message);\n    } else {\n      this.failed = message;\n      this.update();\n    }\n  }\n\n  /**\n   * Ask the user for input using a ConfigurationBuilder screen.\n   * Only available for EventResponse-based tasks (onTask handlers).\n   * The return type is inferred from the ConfigurationBuilder's accumulated option types.\n   * @param name {string} The name/title of the input prompt.\n   * @param description {string} The description of what input is needed.\n   * @param screen {ConfigurationBuilder<U>} The configuration builder for the input form.\n   * @returns {Promise<U>} The user's input with types matching the configuration options.\n   * @throws {Error} If called on a WebSocket-based task.\n   */\n  async askForInput<U extends Record<string, string | number | boolean>>(\n    name: string,\n    description: string,\n    screen: ConfigurationBuilder<U>\n  ): Promise<U> {\n    if (!this.event) {\n      throw new Error(\n        'askForInput() is only available for EventResponse-based tasks (onTask handlers)'\n      );\n    }\n    return this.event.askForInput(name, description, screen);\n  }\n\n  /**\n   * Update the task state (for WebSocket-based tasks only).\n   * Called automatically when using log(), setProgress(), complete(), or fail().\n   */\n  private update(): void {\n    if (this.ws && this.id !== undefined) {\n      this.ws.send('task-update', {\n        id: this.id,\n        progress: this.progress,\n        logs: this.logs,\n        finished: this.finished,\n        failed: this.failed,\n      });\n    }\n  }\n}\n/**\n * A search tool wrapper over Fuse.js for the OGI Addon. This tool is used to search for items in the library.\n * @example\n * ```typescript\n * const searchTool = new SearchTool<LibraryInfo>([{ name: 'test', appID: 123 }, { name: 'test2', appID: 124 }], ['name']);\n * const results = searchTool.search('test', 10);\n * ```\n */\nexport class SearchTool<T> {\n  private fuse: Fuse<T>;\n  constructor(\n    items: T[],\n    keys: string[],\n    options: Omit<IFuseOptions<T>, 'keys'> = {\n      threshold: 0.3,\n      includeScore: true,\n    }\n  ) {\n    this.fuse = new Fuse(items, {\n      keys,\n      ...options,\n    });\n  }\n  public search(query: string, limit: number = 10): T[] {\n    return this.fuse\n      .search(query)\n      .slice(0, limit)\n      .map((result) => result.item);\n  }\n  public addItems(items: T[]) {\n    items.map((item) => this.fuse.add(item));\n  }\n}\n/**\n * Library Info is the metadata for a library entry after setting up a game.\n */\nexport const ZodLibraryInfo = z.object({\n  name: z.string(),\n  version: z.string(),\n  cwd: z.string(),\n  appID: z.number(),\n  launchExecutable: z.string(),\n  launchArguments: z.string().optional(),\n  capsuleImage: z.string(),\n  storefront: z.string(),\n  addonsource: z.string(),\n  coverImage: z.string(),\n  titleImage: z.string().optional(),\n});\nexport type LibraryInfo = z.infer<typeof ZodLibraryInfo>;\ninterface Notification {\n  type: 'warning' | 'error' | 'info' | 'success';\n  message: string;\n  id: string;\n}\nclass OGIAddonWSListener {\n  private socket: WebSocket;\n  public eventEmitter: events.EventEmitter;\n  public addon: OGIAddon;\n\n  constructor(ogiAddon: OGIAddon, eventEmitter: events.EventEmitter) {\n    if (\n      process.argv[process.argv.length - 1].split('=')[0] !== '--addonSecret'\n    ) {\n      throw new Error(\n        'No secret provided. This usually happens because the addon was not started by the OGI Addon Server.'\n      );\n    }\n    this.addon = ogiAddon;\n    this.eventEmitter = eventEmitter;\n    this.socket = new ws('ws://localhost:' + defaultPort);\n    this.socket.on('open', () => {\n      console.log('Connected to OGI Addon Server');\n      console.log('OGI Addon Server Version:', VERSION);\n\n      // Authenticate with OGI Addon Server\n      this.send('authenticate', {\n        ...this.addon.addonInfo,\n        secret: process.argv[process.argv.length - 1].split('=')[1],\n        ogiVersion: VERSION,\n      });\n\n      // send a configuration request\n      let configBuilder = new ConfigurationBuilder();\n      this.eventEmitter.emit('configure', configBuilder);\n      this.send('configure', configBuilder.build(false));\n      this.addon.config = new Configuration(configBuilder.build(true));\n\n      // wait for the config-update to be received then send connect\n      const configListener = (event: ws.MessageEvent) => {\n        if (event === undefined) return;\n        // event can be a Buffer, string, ArrayBuffer, or Buffer[]\n        let data: string;\n        if (typeof event === 'string') {\n          data = event;\n        } else if (event instanceof Buffer) {\n          data = event.toString();\n        } else if (event && typeof (event as any).data === 'string') {\n          data = (event as any).data;\n        } else if (event && (event as any).data instanceof Buffer) {\n          data = (event as any).data.toString();\n        } else {\n          // fallback for other types\n          data = event.toString();\n        }\n        const message: WebsocketMessageServer = JSON.parse(data);\n        if (message.event === 'config-update') {\n          console.log('Config update received');\n          this.socket.off('message', configListener);\n          this.eventEmitter.emit(\n            'connect',\n            new EventResponse<void>((screen, name, description) => {\n              return this.userInputAsked(\n                screen,\n                name,\n                description,\n                this.socket\n              );\n            })\n          );\n        }\n      };\n      this.socket.on('message', configListener);\n    });\n\n    this.socket.on('error', (error) => {\n      if (error.message.includes('Failed to connect')) {\n        throw new Error(\n          'OGI Addon Server is not running/is unreachable. Please start the server and try again.'\n        );\n      }\n      console.error('An error occurred:', error);\n    });\n\n    this.socket.on('close', (code, reason) => {\n      if (code === 1008) {\n        console.error('Authentication failed:', reason);\n        return;\n      }\n      this.eventEmitter.emit('disconnect', reason);\n      console.log('Disconnected from OGI Addon Server');\n      console.error(reason.toString());\n      this.eventEmitter.emit('exit');\n      this.socket.close();\n    });\n\n    this.registerMessageReceiver();\n  }\n\n  private async userInputAsked<\n    U extends Record<string, string | number | boolean>,\n  >(\n    configBuilt: ConfigurationBuilder<U>,\n    name: string,\n    description: string,\n    socket: WebSocket\n  ): Promise<U> {\n    const config = configBuilt.build(false);\n    const id = Math.random().toString(36).substring(7);\n    if (!socket) {\n      throw new Error('Socket is not connected');\n    }\n    socket.send(\n      JSON.stringify({\n        event: 'input-asked',\n        args: {\n          config,\n          name,\n          description,\n        },\n        id: id,\n      })\n    );\n    return await this.waitForResponseFromServer<U>(id);\n  }\n\n  /**\n   * Registers the message receiver for the socket. This is used to receive messages from the server and handle them.\n   */\n  private registerMessageReceiver() {\n    this.socket.on('message', async (data: string) => {\n      const message: WebsocketMessageServer = JSON.parse(data);\n      switch (message.event) {\n        case 'config-update':\n          const result = this.addon.config.updateConfig(message.args);\n          if (!result[0]) {\n            this.respondToMessage(\n              message.id!!,\n              {\n                success: false,\n                error: result[1],\n              },\n              undefined\n            );\n          } else {\n            this.respondToMessage(message.id!!, { success: true }, undefined);\n          }\n          break;\n        case 'search':\n          await this.handleEventWithResponse<SearchResult[]>(message, (event) =>\n            this.eventEmitter.emit('search', message.args, event)\n          );\n          break;\n        case 'setup': {\n          let setupEvent = new EventResponse<SetupEventResponse>(\n            (screen, name, description) =>\n              this.userInputAsked(screen, name, description, this.socket)\n          );\n          this.eventEmitter.emit('setup', message.args, setupEvent);\n          const interval = setInterval(() => {\n            if (setupEvent.resolved) {\n              clearInterval(interval);\n              return;\n            }\n            this.send('defer-update', {\n              logs: setupEvent.logs,\n              deferID: message.args.deferID,\n              progress: setupEvent.progress,\n              failed: setupEvent.failed,\n            } as ClientSentEventTypes['defer-update']);\n          }, 100);\n          const setupResult = await this.waitForEventToRespond(setupEvent);\n          this.respondToMessage(message.id!!, setupResult.data, setupEvent);\n          break;\n        }\n        case 'library-search':\n          await this.handleEventWithResponse<BasicLibraryInfo[]>(\n            message,\n            (event) =>\n              this.eventEmitter.emit('library-search', message.args, event)\n          );\n          break;\n        case 'game-details':\n          await this.handleEventWithResponse<StoreData | undefined>(\n            message,\n            (event) =>\n              this.eventEmitter.emit('game-details', message.args, event),\n            {\n              requireListener: 'game-details',\n              noListenerError: 'No event listener for game-details',\n            }\n          );\n          break;\n        case 'check-for-updates':\n          await this.handleEventWithResponse<\n            { available: true; version: string } | { available: false }\n          >(message, (event) =>\n            this.eventEmitter.emit('check-for-updates', message.args, event)\n          );\n          break;\n        case 'request-dl':\n          let requestDLEvent = new EventResponse<SearchResult>(\n            (screen, name, description) =>\n              this.userInputAsked(screen, name, description, this.socket)\n          );\n          if (this.eventEmitter.listenerCount('request-dl') === 0) {\n            this.respondToMessage(\n              message.id!!,\n              {\n                error: 'No event listener for request-dl',\n              },\n              requestDLEvent\n            );\n            break;\n          }\n          this.eventEmitter.emit(\n            'request-dl',\n            message.args.appID,\n            message.args.info,\n            requestDLEvent\n          );\n          const requestDLResult =\n            await this.waitForEventToRespond(requestDLEvent);\n          if (requestDLEvent.failed) {\n            this.respondToMessage(message.id!!, undefined, requestDLEvent);\n            break;\n          }\n          if (\n            requestDLEvent.data === undefined ||\n            requestDLEvent.data?.downloadType === 'request'\n          ) {\n            throw new Error(\n              'Request DL event did not return a valid result. Please ensure that the event does not resolve with another `request` download type.'\n            );\n          }\n          this.respondToMessage(\n            message.id!!,\n            requestDLResult.data,\n            requestDLEvent\n          );\n          break;\n        case 'catalog':\n          await this.handleEventWithResponseNoInput<CatalogResponse>(\n            message,\n            (event) => this.eventEmitter.emit('catalog', event)\n          );\n          break;\n        case 'task-run': {\n          let taskRunEvent = new EventResponse<void>(\n            (screen, name, description) =>\n              this.userInputAsked(screen, name, description, this.socket)\n          );\n\n          // Check for taskName: first from args directly (from SearchResult), then from manifest.__taskName (for ActionOption)\n          const taskName =\n            message.args.taskName && typeof message.args.taskName === 'string'\n              ? message.args.taskName\n              : message.args.manifest &&\n                  typeof message.args.manifest === 'object'\n                ? (message.args.manifest as Record<string, unknown>).__taskName\n                : undefined;\n\n          if (\n            taskName &&\n            typeof taskName === 'string' &&\n            this.addon.hasTaskHandler(taskName)\n          ) {\n            // Use the registered task handler\n            const handler = this.addon.getTaskHandler(taskName)!;\n            const task = new Task(taskRunEvent);\n            try {\n              const interval = setInterval(() => {\n                if (taskRunEvent.resolved) {\n                  clearInterval(interval);\n                  return;\n                }\n                this.send('defer-update', {\n                  logs: taskRunEvent.logs,\n                  deferID: message.args.deferID,\n                  progress: taskRunEvent.progress,\n                  failed: taskRunEvent.failed,\n                } as ClientSentEventTypes['defer-update']);\n              }, 100);\n              const result = handler(task, {\n                manifest: message.args.manifest || {},\n                downloadPath: message.args.downloadPath || '',\n                name: message.args.name || '',\n                libraryInfo: message.args.libraryInfo,\n              });\n              // If handler returns a promise, wait for it\n              if (result instanceof Promise) {\n                await result;\n              }\n\n              clearInterval(interval);\n            } catch (error) {\n              taskRunEvent.fail(\n                error instanceof Error ? error.message : String(error)\n              );\n            }\n          } else {\n            // No handler found - fail the task\n            taskRunEvent.fail(\n              taskName\n                ? `No task handler registered for task name: ${taskName}`\n                : 'No task name provided'\n            );\n          }\n\n          const taskRunResult = await this.waitForEventToRespond(taskRunEvent);\n          this.respondToMessage(message.id!!, taskRunResult.data, taskRunEvent);\n          break;\n        }\n        case 'launch-app':\n          await this.handleEventWithResponse<void>(message, (event) =>\n            this.eventEmitter.emit('launch-app', message.args, event)\n          );\n          break;\n      }\n    });\n  }\n\n  private waitForEventToRespond<T>(\n    event: EventResponse<T>\n  ): Promise<EventResponse<T>> {\n    // check the handlers to see if there even is any\n    return new Promise((resolve, reject) => {\n      const dataGet = setInterval(() => {\n        if (event.resolved) {\n          resolve(event);\n          clearTimeout(timeout);\n        }\n      }, 5);\n\n      const timeout = setTimeout(() => {\n        if (event.deffered) {\n          clearInterval(dataGet);\n          const interval = setInterval(() => {\n            if (event.resolved) {\n              clearInterval(interval);\n              resolve(event);\n            }\n          }, 100);\n        } else {\n          reject('Event did not respond in time');\n        }\n      }, 5000);\n    });\n  }\n\n  /**\n   * Common flow for events that use EventResponse with userInputAsked: create event, emit via callback, wait, respond.\n   * If options.requireListener is set and that event has no listeners, responds with options.noListenerError and returns.\n   */\n  private async handleEventWithResponse<T>(\n    message: WebsocketMessageServer,\n    emit: (event: EventResponse<T>) => void,\n    options?: { requireListener: string; noListenerError: string }\n  ): Promise<void> {\n    const event = new EventResponse<T>((screen, name, description) =>\n      this.userInputAsked(screen, name, description, this.socket)\n    );\n    if (\n      options &&\n      this.eventEmitter.listenerCount(options.requireListener) === 0\n    ) {\n      this.respondToMessage(\n        message.id!!,\n        { error: options.noListenerError },\n        event\n      );\n      return;\n    }\n    emit(event);\n    const result = await this.waitForEventToRespond(event);\n    this.respondToMessage(message.id!!, result.data, event);\n  }\n\n  /**\n   * Same as handleEventWithResponse but for events that don't need userInputAsked (e.g. catalog).\n   */\n  private async handleEventWithResponseNoInput<T>(\n    message: WebsocketMessageServer,\n    emit: (event: EventResponse<T>) => void\n  ): Promise<void> {\n    const event = new EventResponse<T>();\n    emit(event);\n    const result = await this.waitForEventToRespond(event);\n    this.respondToMessage(message.id!!, result.data, event);\n  }\n\n  public respondToMessage(\n    messageID: string,\n    response: any,\n    originalEvent: EventResponse<any> | undefined\n  ) {\n    this.socket.send(\n      JSON.stringify({\n        event: 'response',\n        id: messageID,\n        args: response,\n        statusError: originalEvent ? originalEvent.failed : undefined,\n      })\n    );\n    console.log('dispatched response to ' + messageID);\n  }\n\n  public waitForResponseFromServer<T>(messageID: string): Promise<T> {\n    return new Promise((resolve) => {\n      const waiter = (data: string) => {\n        const message: WebsocketMessageClient = JSON.parse(data);\n        if (message.event !== 'response') {\n          this.socket.once('message', waiter);\n          return;\n        }\n        console.log('received response from ' + messageID);\n\n        if (message.id === messageID) {\n          resolve(message.args);\n        } else {\n          this.socket.once('message', waiter);\n        }\n      };\n      this.socket.once('message', waiter);\n    });\n  }\n\n  public send(\n    event: OGIAddonClientSentEvent,\n    args: ClientSentEventTypes[OGIAddonClientSentEvent]\n  ): string {\n    // generate a random id\n    const id = Math.random().toString(36).substring(7);\n    this.socket.send(\n      JSON.stringify({\n        event,\n        args,\n        id,\n      })\n    );\n    return id;\n  }\n\n  public close() {\n    this.socket.close();\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AC8DA,MAAM,cAAc;AAKpB,MAAa,UAAUA;;;;;;;;;;;;;;;;AAsTvB,IAAqB,WAArB,MAA8B;CAC5B,AAAO,eAAe,IAAIC,oBAAO,cAAc;CAC/C,AAAO;CACP,AAAO;CACP,AAAO,SAAwB,IAAIC,2CAAc,EAAE,CAAC;CACpD,AAAQ,kBAAmC,EAAE;CAC7C,AAAQ,yBAAkC;CAC1C,AAAQ,+BAWJ,IAAI,KAAK;CAEb,YAAY,WAAkC;AAC5C,OAAK,YAAY;AACjB,OAAK,kBAAkB,IAAI,mBAAmB,MAAM,KAAK,aAAa;;;;;;;CAQxE,AAAO,GACL,OACA,UACA;AACA,OAAK,aAAa,GAAG,OAAO,SAAS;AACrC,OAAK,gBAAgB,KAAK,MAAM;AAEhC,MAAI,CAAC,KAAK,wBAAwB;AAChC,QAAK,gBAAgB,aAAa,KAAK,iBAAiB;AACtD,SAAK,gBAAgB,KAAK,QAAQ;KAChC,MAAM;KACN,OAAO,KAAK;KACb,CAAC;KACF;AACF,QAAK,yBAAyB;;;CAIlC,AAAO,KACL,OACA,GAAG,MACH;AACA,OAAK,aAAa,KAAK,OAAO,GAAG,KAAK;;;;;;CAOxC,AAAO,OAAO,cAA4B;AACxC,OAAK,gBAAgB,KAAK,gBAAgB,CAAC,aAAa,CAAC;;;;;;;;CAS3D,MAAa,cAAc,OAAe,YAAoB;EAC5D,MAAM,KAAK,KAAK,gBAAgB,KAAK,mBAAmB;GACtD;GACA;GACD,CAAC;AACF,SAAO,MAAM,KAAK,gBAAgB,0BAEhC,GAAG;;CAGP,MAAa,WAAW,OAAe,YAAoB;EACzD,MAAM,KAAK,KAAK,gBAAgB,KAAK,mBAAmB;GACtD;GACA;GACD,CAAC;AACF,SAAO,MAAM,KAAK,gBAAgB,0BAEhC,GAAG;;;;;;CAOP,MAAa,OAAsB;EACjC,MAAM,KAAK,KAAK,QAAQ,CAAC,SAAS,GAAG,CAAC,UAAU,EAAE;EAClD,MAAM,WAAW;EACjB,MAAM,OAAiB,EAAE;EACzB,MAAM,OAAO,IAAI,KAAK,KAAK,iBAAiB,IAAI,UAAU,KAAK;AAC/D,OAAK,gBAAgB,KAAK,eAAe;GACvC;GACA;GACA;GACA,UAAU;GACV,QAAQ;GACT,CAAC;AACF,SAAO;;;;;;;;;;;;;;;;;CAkBT,AAAO,OACL,UACA,SASM;AACN,OAAK,aAAa,IAAI,UAAU,QAAQ;;;;;;;CAQ1C,AAAO,eAAe,UAA2B;AAC/C,SAAO,KAAK,aAAa,IAAI,SAAS;;;;;;;CAQxC,AAAO,eAAe,UAUR;AACZ,SAAO,KAAK,aAAa,IAAI,SAAS;;;;;;;;;CAUxC,MAAa,YACX,MACA,YACA,MACA;AACA,SAAO,IAAI,SAAe,SAAS,WAAW;AAE5C,OAAI,CAACC,gBAAG,WAAW,WAAW,CAC5B,iBAAG,UAAU,YAAY,EAAE,WAAW,MAAM,CAAC;AAG/C,OAAI,SAAS,QAEX,KAAI,QAAQ,aAAa,QAGvB,8BACE,yCAAmB,KAAK,OAAO,WAAW,KACzC,KAAU,QAAa,WAAgB;AACtC,QAAI,KAAK;AACP,aAAQ,MAAM,IAAI;AAClB,aAAQ,IAAI,OAAO;AACnB,4BAAO,IAAI,MAAM,6BAA6B,CAAC;AAC/C;;AAEF,YAAQ,IAAI,OAAO;AACnB,YAAQ,IAAI,OAAO;AACnB,aAAS;KAEZ;QACI;IAEL,MAAM,6CACJ,SACA;KACE;KACA;KACA;KACA;KACD,EACD,EACE,KAAK;KACH,GAAG,QAAQ;KACX,iCAAiC;KAClC,EACF,CACF;AAED,iBAAa,OAAO,GAAG,SAAS,SAAiB;AAC/C,aAAQ,IAAI,mBAAmB,OAAO;MACtC;AAEF,iBAAa,OAAO,GAAG,SAAS,SAAiB;AAC/C,aAAQ,MAAM,mBAAmB,OAAO;MACxC;AAEF,iBAAa,GAAG,UAAU,SAAiB;AACzC,SAAI,SAAS,GAAG;AACd,cAAQ,MAAM,kCAAkC,OAAO;AACvD,6BAAO,IAAI,MAAM,6BAA6B,CAAC;AAC/C;;AAEF,cAAS;MACT;;YAEK,SAAS,QAClB,KAAI,QAAQ,aAAa,QAGvB,8BACE,yCAAmB,KAAK,OAAO,WAAW,KACzC,KAAU,QAAa,WAAgB;AACtC,QAAI,KAAK;AACP,aAAQ,MAAM,IAAI;AAClB,aAAQ,IAAI,OAAO;AACnB,4BAAO,IAAI,MAAM,6BAA6B,CAAC;AAC/C;;AAEF,YAAQ,IAAI,OAAO;AACnB,YAAQ,IAAI,OAAO;AACnB,aAAS;KAEZ;QACI;IAEL,MAAM,6CAAqB,SAAS;KAAC;KAAK;KAAM;KAAM;KAAW,CAAC;AAElE,iBAAa,OAAO,GAAG,SAAS,SAAiB;AAC/C,aAAQ,IAAI,mBAAmB,OAAO;MACtC;AAEF,iBAAa,OAAO,GAAG,SAAS,SAAiB;AAC/C,aAAQ,MAAM,mBAAmB,OAAO;MACxC;AAEF,iBAAa,GAAG,UAAU,SAAiB;AACzC,SAAI,SAAS,GAAG;AACd,cAAQ,MAAM,kCAAkC,OAAO;AACvD,6BAAO,IAAI,MAAM,6BAA6B,CAAC;AAC/C;;AAEF,cAAS;MACT;;OAGJ,wBAAO,IAAI,MAAM,0BAA0B,CAAC;IAE9C;;;;;;;;AASN,IAAa,OAAb,MAAkB;CAEhB,AAAQ;CAGR,AAAQ;CACR,AAAiB;CACjB,AAAQ,WAAmB;CAC3B,AAAQ,OAAiB,EAAE;CAC3B,AAAQ,WAAoB;CAC5B,AAAQ,SAA6B;CAsBrC,YACE,WACA,IACA,UACA,MACA;AACA,MAAI,qBAAqBC,uBAAe;AAEtC,QAAK,QAAQ;AACb,QAAK,MAAM,OAAO;SACb;AAEL,QAAK,KAAK;AACV,QAAK,KAAK;AACV,QAAK,WAAW,YAAY;AAC5B,QAAK,OAAO,QAAQ,EAAE;;;;;;;CAQ1B,IAAI,SAAuB;AACzB,MAAI,KAAK,MACP,MAAK,MAAM,IAAI,QAAQ;OAClB;AACL,QAAK,KAAK,KAAK,QAAQ;AACvB,QAAK,QAAQ;;AAEf,SAAO;;;;;;CAOT,YAAY,UAAwB;AAClC,MAAI,KAAK,MACP,MAAK,MAAM,WAAW;OACjB;AACL,QAAK,WAAW;AAChB,QAAK,QAAQ;;AAEf,SAAO;;;;;CAMT,WAAiB;AACf,MAAI,KAAK,MACP,MAAK,MAAM,UAAU;OAChB;AACL,QAAK,WAAW;AAChB,QAAK,QAAQ;;;;;;;CAQjB,KAAK,SAAuB;AAC1B,MAAI,KAAK,MACP,MAAK,MAAM,KAAK,QAAQ;OACnB;AACL,QAAK,SAAS;AACd,QAAK,QAAQ;;;;;;;;;;;;;CAcjB,MAAM,YACJ,MACA,aACA,QACY;AACZ,MAAI,CAAC,KAAK,MACR,OAAM,IAAI,MACR,kFACD;AAEH,SAAO,KAAK,MAAM,YAAY,MAAM,aAAa,OAAO;;;;;;CAO1D,AAAQ,SAAe;AACrB,MAAI,KAAK,MAAM,KAAK,OAAO,OACzB,MAAK,GAAG,KAAK,eAAe;GAC1B,IAAI,KAAK;GACT,UAAU,KAAK;GACf,MAAM,KAAK;GACX,UAAU,KAAK;GACf,QAAQ,KAAK;GACd,CAAC;;;;;;;;;;;AAYR,IAAa,aAAb,MAA2B;CACzB,AAAQ;CACR,YACE,OACA,MACA,UAAyC;EACvC,WAAW;EACX,cAAc;EACf,EACD;AACA,OAAK,OAAO,IAAIC,gBAAK,OAAO;GAC1B;GACA,GAAG;GACJ,CAAC;;CAEJ,AAAO,OAAO,OAAe,QAAgB,IAAS;AACpD,SAAO,KAAK,KACT,OAAO,MAAM,CACb,MAAM,GAAG,MAAM,CACf,KAAK,WAAW,OAAO,KAAK;;CAEjC,AAAO,SAAS,OAAY;AAC1B,QAAM,KAAK,SAAS,KAAK,KAAK,IAAI,KAAK,CAAC;;;;;;AAM5C,MAAa,iBAAiBC,MAAE,OAAO;CACrC,MAAMA,MAAE,QAAQ;CAChB,SAASA,MAAE,QAAQ;CACnB,KAAKA,MAAE,QAAQ;CACf,OAAOA,MAAE,QAAQ;CACjB,kBAAkBA,MAAE,QAAQ;CAC5B,iBAAiBA,MAAE,QAAQ,CAAC,UAAU;CACtC,cAAcA,MAAE,QAAQ;CACxB,YAAYA,MAAE,QAAQ;CACtB,aAAaA,MAAE,QAAQ;CACvB,YAAYA,MAAE,QAAQ;CACtB,YAAYA,MAAE,QAAQ,CAAC,UAAU;CAClC,CAAC;AAOF,IAAM,qBAAN,MAAyB;CACvB,AAAQ;CACR,AAAO;CACP,AAAO;CAEP,YAAY,UAAoB,cAAmC;AACjE,MACE,QAAQ,KAAK,QAAQ,KAAK,SAAS,GAAG,MAAM,IAAI,CAAC,OAAO,gBAExD,OAAM,IAAI,MACR,sGACD;AAEH,OAAK,QAAQ;AACb,OAAK,eAAe;AACpB,OAAK,SAAS,IAAI,WAAG,oBAAoB,YAAY;AACrD,OAAK,OAAO,GAAG,cAAc;AAC3B,WAAQ,IAAI,gCAAgC;AAC5C,WAAQ,IAAI,6BAA6B,QAAQ;AAGjD,QAAK,KAAK,gBAAgB;IACxB,GAAG,KAAK,MAAM;IACd,QAAQ,QAAQ,KAAK,QAAQ,KAAK,SAAS,GAAG,MAAM,IAAI,CAAC;IACzD,YAAY;IACb,CAAC;GAGF,IAAI,gBAAgB,IAAIC,0DAAsB;AAC9C,QAAK,aAAa,KAAK,aAAa,cAAc;AAClD,QAAK,KAAK,aAAa,cAAc,MAAM,MAAM,CAAC;AAClD,QAAK,MAAM,SAAS,IAAIL,2CAAc,cAAc,MAAM,KAAK,CAAC;GAGhE,MAAM,kBAAkB,UAA2B;AACjD,QAAI,UAAU,OAAW;IAEzB,IAAI;AACJ,QAAI,OAAO,UAAU,SACnB,QAAO;aACE,iBAAiB,OAC1B,QAAO,MAAM,UAAU;aACd,SAAS,OAAQ,MAAc,SAAS,SACjD,QAAQ,MAAc;aACb,SAAU,MAAc,gBAAgB,OACjD,QAAQ,MAAc,KAAK,UAAU;QAGrC,QAAO,MAAM,UAAU;AAGzB,QADwC,KAAK,MAAM,KAAK,CAC5C,UAAU,iBAAiB;AACrC,aAAQ,IAAI,yBAAyB;AACrC,UAAK,OAAO,IAAI,WAAW,eAAe;AAC1C,UAAK,aAAa,KAChB,WACA,IAAIE,uBAAqB,QAAQ,MAAM,gBAAgB;AACrD,aAAO,KAAK,eACV,QACA,MACA,aACA,KAAK,OACN;OACD,CACH;;;AAGL,QAAK,OAAO,GAAG,WAAW,eAAe;IACzC;AAEF,OAAK,OAAO,GAAG,UAAU,UAAU;AACjC,OAAI,MAAM,QAAQ,SAAS,oBAAoB,CAC7C,OAAM,IAAI,MACR,yFACD;AAEH,WAAQ,MAAM,sBAAsB,MAAM;IAC1C;AAEF,OAAK,OAAO,GAAG,UAAU,MAAM,WAAW;AACxC,OAAI,SAAS,MAAM;AACjB,YAAQ,MAAM,0BAA0B,OAAO;AAC/C;;AAEF,QAAK,aAAa,KAAK,cAAc,OAAO;AAC5C,WAAQ,IAAI,qCAAqC;AACjD,WAAQ,MAAM,OAAO,UAAU,CAAC;AAChC,QAAK,aAAa,KAAK,OAAO;AAC9B,QAAK,OAAO,OAAO;IACnB;AAEF,OAAK,yBAAyB;;CAGhC,MAAc,eAGZ,aACA,MACA,aACA,QACY;EACZ,MAAM,SAAS,YAAY,MAAM,MAAM;EACvC,MAAM,KAAK,KAAK,QAAQ,CAAC,SAAS,GAAG,CAAC,UAAU,EAAE;AAClD,MAAI,CAAC,OACH,OAAM,IAAI,MAAM,0BAA0B;AAE5C,SAAO,KACL,KAAK,UAAU;GACb,OAAO;GACP,MAAM;IACJ;IACA;IACA;IACD;GACG;GACL,CAAC,CACH;AACD,SAAO,MAAM,KAAK,0BAA6B,GAAG;;;;;CAMpD,AAAQ,0BAA0B;AAChC,OAAK,OAAO,GAAG,WAAW,OAAO,SAAiB;GAChD,MAAM,UAAkC,KAAK,MAAM,KAAK;AACxD,WAAQ,QAAQ,OAAhB;IACE,KAAK;KACH,MAAM,SAAS,KAAK,MAAM,OAAO,aAAa,QAAQ,KAAK;AAC3D,SAAI,CAAC,OAAO,GACV,MAAK,iBACH,QAAQ,IACR;MACE,SAAS;MACT,OAAO,OAAO;MACf,EACD,OACD;SAED,MAAK,iBAAiB,QAAQ,IAAM,EAAE,SAAS,MAAM,EAAE,OAAU;AAEnE;IACF,KAAK;AACH,WAAM,KAAK,wBAAwC,UAAU,UAC3D,KAAK,aAAa,KAAK,UAAU,QAAQ,MAAM,MAAM,CACtD;AACD;IACF,KAAK,SAAS;KACZ,IAAI,aAAa,IAAIA,uBAClB,QAAQ,MAAM,gBACb,KAAK,eAAe,QAAQ,MAAM,aAAa,KAAK,OAAO,CAC9D;AACD,UAAK,aAAa,KAAK,SAAS,QAAQ,MAAM,WAAW;KACzD,MAAM,WAAW,kBAAkB;AACjC,UAAI,WAAW,UAAU;AACvB,qBAAc,SAAS;AACvB;;AAEF,WAAK,KAAK,gBAAgB;OACxB,MAAM,WAAW;OACjB,SAAS,QAAQ,KAAK;OACtB,UAAU,WAAW;OACrB,QAAQ,WAAW;OACpB,CAAyC;QACzC,IAAI;KACP,MAAM,cAAc,MAAM,KAAK,sBAAsB,WAAW;AAChE,UAAK,iBAAiB,QAAQ,IAAM,YAAY,MAAM,WAAW;AACjE;;IAEF,KAAK;AACH,WAAM,KAAK,wBACT,UACC,UACC,KAAK,aAAa,KAAK,kBAAkB,QAAQ,MAAM,MAAM,CAChE;AACD;IACF,KAAK;AACH,WAAM,KAAK,wBACT,UACC,UACC,KAAK,aAAa,KAAK,gBAAgB,QAAQ,MAAM,MAAM,EAC7D;MACE,iBAAiB;MACjB,iBAAiB;MAClB,CACF;AACD;IACF,KAAK;AACH,WAAM,KAAK,wBAET,UAAU,UACV,KAAK,aAAa,KAAK,qBAAqB,QAAQ,MAAM,MAAM,CACjE;AACD;IACF,KAAK;KACH,IAAI,iBAAiB,IAAIA,uBACtB,QAAQ,MAAM,gBACb,KAAK,eAAe,QAAQ,MAAM,aAAa,KAAK,OAAO,CAC9D;AACD,SAAI,KAAK,aAAa,cAAc,aAAa,KAAK,GAAG;AACvD,WAAK,iBACH,QAAQ,IACR,EACE,OAAO,oCACR,EACD,eACD;AACD;;AAEF,UAAK,aAAa,KAChB,cACA,QAAQ,KAAK,OACb,QAAQ,KAAK,MACb,eACD;KACD,MAAM,kBACJ,MAAM,KAAK,sBAAsB,eAAe;AAClD,SAAI,eAAe,QAAQ;AACzB,WAAK,iBAAiB,QAAQ,IAAM,QAAW,eAAe;AAC9D;;AAEF,SACE,eAAe,SAAS,UACxB,eAAe,MAAM,iBAAiB,UAEtC,OAAM,IAAI,MACR,sIACD;AAEH,UAAK,iBACH,QAAQ,IACR,gBAAgB,MAChB,eACD;AACD;IACF,KAAK;AACH,WAAM,KAAK,+BACT,UACC,UAAU,KAAK,aAAa,KAAK,WAAW,MAAM,CACpD;AACD;IACF,KAAK,YAAY;KACf,IAAI,eAAe,IAAIA,uBACpB,QAAQ,MAAM,gBACb,KAAK,eAAe,QAAQ,MAAM,aAAa,KAAK,OAAO,CAC9D;KAGD,MAAM,WACJ,QAAQ,KAAK,YAAY,OAAO,QAAQ,KAAK,aAAa,WACtD,QAAQ,KAAK,WACb,QAAQ,KAAK,YACX,OAAO,QAAQ,KAAK,aAAa,WAChC,QAAQ,KAAK,SAAqC,aACnD;AAER,SACE,YACA,OAAO,aAAa,YACpB,KAAK,MAAM,eAAe,SAAS,EACnC;MAEA,MAAM,UAAU,KAAK,MAAM,eAAe,SAAS;MACnD,MAAM,OAAO,IAAI,KAAK,aAAa;AACnC,UAAI;OACF,MAAM,WAAW,kBAAkB;AACjC,YAAI,aAAa,UAAU;AACzB,uBAAc,SAAS;AACvB;;AAEF,aAAK,KAAK,gBAAgB;SACxB,MAAM,aAAa;SACnB,SAAS,QAAQ,KAAK;SACtB,UAAU,aAAa;SACvB,QAAQ,aAAa;SACtB,CAAyC;UACzC,IAAI;OACP,MAAM,SAAS,QAAQ,MAAM;QAC3B,UAAU,QAAQ,KAAK,YAAY,EAAE;QACrC,cAAc,QAAQ,KAAK,gBAAgB;QAC3C,MAAM,QAAQ,KAAK,QAAQ;QAC3B,aAAa,QAAQ,KAAK;QAC3B,CAAC;AAEF,WAAI,kBAAkB,QACpB,OAAM;AAGR,qBAAc,SAAS;eAChB,OAAO;AACd,oBAAa,KACX,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,CACvD;;WAIH,cAAa,KACX,WACI,6CAA6C,aAC7C,wBACL;KAGH,MAAM,gBAAgB,MAAM,KAAK,sBAAsB,aAAa;AACpE,UAAK,iBAAiB,QAAQ,IAAM,cAAc,MAAM,aAAa;AACrE;;IAEF,KAAK;AACH,WAAM,KAAK,wBAA8B,UAAU,UACjD,KAAK,aAAa,KAAK,cAAc,QAAQ,MAAM,MAAM,CAC1D;AACD;;IAEJ;;CAGJ,AAAQ,sBACN,OAC2B;AAE3B,SAAO,IAAI,SAAS,SAAS,WAAW;GACtC,MAAM,UAAU,kBAAkB;AAChC,QAAI,MAAM,UAAU;AAClB,aAAQ,MAAM;AACd,kBAAa,QAAQ;;MAEtB,EAAE;GAEL,MAAM,UAAU,iBAAiB;AAC/B,QAAI,MAAM,UAAU;AAClB,mBAAc,QAAQ;KACtB,MAAM,WAAW,kBAAkB;AACjC,UAAI,MAAM,UAAU;AAClB,qBAAc,SAAS;AACvB,eAAQ,MAAM;;QAEf,IAAI;UAEP,QAAO,gCAAgC;MAExC,IAAK;IACR;;;;;;CAOJ,MAAc,wBACZ,SACA,MACA,SACe;EACf,MAAM,QAAQ,IAAIA,uBAAkB,QAAQ,MAAM,gBAChD,KAAK,eAAe,QAAQ,MAAM,aAAa,KAAK,OAAO,CAC5D;AACD,MACE,WACA,KAAK,aAAa,cAAc,QAAQ,gBAAgB,KAAK,GAC7D;AACA,QAAK,iBACH,QAAQ,IACR,EAAE,OAAO,QAAQ,iBAAiB,EAClC,MACD;AACD;;AAEF,OAAK,MAAM;EACX,MAAM,SAAS,MAAM,KAAK,sBAAsB,MAAM;AACtD,OAAK,iBAAiB,QAAQ,IAAM,OAAO,MAAM,MAAM;;;;;CAMzD,MAAc,+BACZ,SACA,MACe;EACf,MAAM,QAAQ,IAAIA,uBAAkB;AACpC,OAAK,MAAM;EACX,MAAM,SAAS,MAAM,KAAK,sBAAsB,MAAM;AACtD,OAAK,iBAAiB,QAAQ,IAAM,OAAO,MAAM,MAAM;;CAGzD,AAAO,iBACL,WACA,UACA,eACA;AACA,OAAK,OAAO,KACV,KAAK,UAAU;GACb,OAAO;GACP,IAAI;GACJ,MAAM;GACN,aAAa,gBAAgB,cAAc,SAAS;GACrD,CAAC,CACH;AACD,UAAQ,IAAI,4BAA4B,UAAU;;CAGpD,AAAO,0BAA6B,WAA+B;AACjE,SAAO,IAAI,SAAS,YAAY;GAC9B,MAAM,UAAU,SAAiB;IAC/B,MAAM,UAAkC,KAAK,MAAM,KAAK;AACxD,QAAI,QAAQ,UAAU,YAAY;AAChC,UAAK,OAAO,KAAK,WAAW,OAAO;AACnC;;AAEF,YAAQ,IAAI,4BAA4B,UAAU;AAElD,QAAI,QAAQ,OAAO,UACjB,SAAQ,QAAQ,KAAK;QAErB,MAAK,OAAO,KAAK,WAAW,OAAO;;AAGvC,QAAK,OAAO,KAAK,WAAW,OAAO;IACnC;;CAGJ,AAAO,KACL,OACA,MACQ;EAER,MAAM,KAAK,KAAK,QAAQ,CAAC,SAAS,GAAG,CAAC,UAAU,EAAE;AAClD,OAAK,OAAO,KACV,KAAK,UAAU;GACb;GACA;GACA;GACD,CAAC,CACH;AACD,SAAO;;CAGT,AAAO,QAAQ;AACb,OAAK,OAAO,OAAO"}

package/build/main.d.cts

@@ -7,9 +7,19 @@ import { IFuseOptions } from "fuse.js";
 import { z } from "zod";
 
 //#region src/main.d.ts
-type OGIAddonEvent = 'connect' | 'disconnect' | 'configure' | 'authenticate' | 'search' | 'setup' | 'library-search' | 'game-details' | 'exit' | 'check-for-updates' | 'request-dl' | 'catalog';
+/**
+ * Exposed events that the programmer can use to listen to and emit events.
+ */
+type OGIAddonEvent = 'connect' | 'disconnect' | 'configure' | 'authenticate' | 'search' | 'setup' | 'library-search' | 'game-details' | 'exit' | 'check-for-updates' | 'request-dl' | 'catalog' | 'launch-app';
+/**
+ * The events that the client can send to the server and are handled by the server.
+ */
 type OGIAddonClientSentEvent = 'response' | 'authenticate' | 'configure' | 'defer-update' | 'notification' | 'input-asked' | 'get-app-details' | 'search-app-name' | 'flag' | 'task-update';
-type OGIAddonServerSentEvent = 'authenticate' | 'configure' | 'config-update' | 'search' | 'setup' | 'response' | 'library-search' | 'check-for-updates' | 'task-run' | 'game-details' | 'request-dl' | 'catalog';
+/**
+ * The events that the server sends to the client
+ * This is the events that the server can send to the client and are handled by the client.
+ */
+type OGIAddonServerSentEvent = 'authenticate' | 'configure' | 'config-update' | 'launch-app' | 'search' | 'setup' | 'response' | 'library-search' | 'check-for-updates' | 'task-run' | 'game-details' | 'request-dl' | 'catalog';
 declare const VERSION: string;
 interface ClientSentEventTypes {
   response: any;
@@ -135,6 +145,7 @@ interface EventListenerTypes {
     type: 'direct' | 'torrent' | 'magnet' | 'empty';
     name: string;
     usedRealDebrid: boolean;
+    clearOldFilesBeforeUpdate?: boolean;
     multiPartFiles?: {
       name: string;
       downloadURL: string;
@@ -200,6 +211,16 @@ interface EventListenerTypes {
   } | {
     available: false;
   }>) => void;
+  /**
+   * This event is emitted when the client is going to launch an app. Addon should use this to perform any pre or post launch tasks.
+   * @param data {LibraryInfo} The library information for the app to be launched.
+   * @param launchType { 'pre' | 'post' } The type of launch task to perform.
+   * @param event {EventResponse<void>} The event response from the server.
+   */
+  'launch-app': (data: {
+    libraryInfo: LibraryInfo;
+    launchType: 'pre' | 'post';
+  }, event: EventResponse<void>) => void;
 }
 interface StoreData {
   name: string;
@@ -463,8 +484,20 @@ declare class OGIAddonWSListener {
   addon: OGIAddon;
   constructor(ogiAddon: OGIAddon, eventEmitter: events.EventEmitter);
   private userInputAsked;
+  /**
+   * Registers the message receiver for the socket. This is used to receive messages from the server and handle them.
+   */
   private registerMessageReceiver;
   private waitForEventToRespond;
+  /**
+   * Common flow for events that use EventResponse with userInputAsked: create event, emit via callback, wait, respond.
+   * If options.requireListener is set and that event has no listeners, responds with options.noListenerError and returns.
+   */
+  private handleEventWithResponse;
+  /**
+   * Same as handleEventWithResponse but for events that don't need userInputAsked (e.g. catalog).
+   */
+  private handleEventWithResponseNoInput;
   respondToMessage(messageID: string, response: any, originalEvent: EventResponse<any> | undefined): void;
   waitForResponseFromServer<T>(messageID: string): Promise<T>;
   send(event: OGIAddonClientSentEvent, args: ClientSentEventTypes[OGIAddonClientSentEvent]): string;

package/build/main.d.mts

@@ -7,9 +7,19 @@ import { z as z$1 } from "zod";
 import { IFuseOptions } from "fuse.js";
 
 //#region src/main.d.ts
-type OGIAddonEvent = 'connect' | 'disconnect' | 'configure' | 'authenticate' | 'search' | 'setup' | 'library-search' | 'game-details' | 'exit' | 'check-for-updates' | 'request-dl' | 'catalog';
+/**
+ * Exposed events that the programmer can use to listen to and emit events.
+ */
+type OGIAddonEvent = 'connect' | 'disconnect' | 'configure' | 'authenticate' | 'search' | 'setup' | 'library-search' | 'game-details' | 'exit' | 'check-for-updates' | 'request-dl' | 'catalog' | 'launch-app';
+/**
+ * The events that the client can send to the server and are handled by the server.
+ */
 type OGIAddonClientSentEvent = 'response' | 'authenticate' | 'configure' | 'defer-update' | 'notification' | 'input-asked' | 'get-app-details' | 'search-app-name' | 'flag' | 'task-update';
-type OGIAddonServerSentEvent = 'authenticate' | 'configure' | 'config-update' | 'search' | 'setup' | 'response' | 'library-search' | 'check-for-updates' | 'task-run' | 'game-details' | 'request-dl' | 'catalog';
+/**
+ * The events that the server sends to the client
+ * This is the events that the server can send to the client and are handled by the client.
+ */
+type OGIAddonServerSentEvent = 'authenticate' | 'configure' | 'config-update' | 'launch-app' | 'search' | 'setup' | 'response' | 'library-search' | 'check-for-updates' | 'task-run' | 'game-details' | 'request-dl' | 'catalog';
 declare const VERSION: string;
 interface ClientSentEventTypes {
   response: any;
@@ -135,6 +145,7 @@ interface EventListenerTypes {
     type: 'direct' | 'torrent' | 'magnet' | 'empty';
     name: string;
     usedRealDebrid: boolean;
+    clearOldFilesBeforeUpdate?: boolean;
     multiPartFiles?: {
       name: string;
       downloadURL: string;
@@ -200,6 +211,16 @@ interface EventListenerTypes {
   } | {
     available: false;
   }>) => void;
+  /**
+   * This event is emitted when the client is going to launch an app. Addon should use this to perform any pre or post launch tasks.
+   * @param data {LibraryInfo} The library information for the app to be launched.
+   * @param launchType { 'pre' | 'post' } The type of launch task to perform.
+   * @param event {EventResponse<void>} The event response from the server.
+   */
+  'launch-app': (data: {
+    libraryInfo: LibraryInfo;
+    launchType: 'pre' | 'post';
+  }, event: EventResponse<void>) => void;
 }
 interface StoreData {
   name: string;
@@ -463,8 +484,20 @@ declare class OGIAddonWSListener {
   addon: OGIAddon;
   constructor(ogiAddon: OGIAddon, eventEmitter: events.EventEmitter);
   private userInputAsked;
+  /**
+   * Registers the message receiver for the socket. This is used to receive messages from the server and handle them.
+   */
   private registerMessageReceiver;
   private waitForEventToRespond;
+  /**
+   * Common flow for events that use EventResponse with userInputAsked: create event, emit via callback, wait, respond.
+   * If options.requireListener is set and that event has no listeners, responds with options.noListenerError and returns.
+   */
+  private handleEventWithResponse;
+  /**
+   * Same as handleEventWithResponse but for events that don't need userInputAsked (e.g. catalog).
+   */
+  private handleEventWithResponseNoInput;
   respondToMessage(messageID: string, response: any, originalEvent: EventResponse<any> | undefined): void;
   waitForResponseFromServer<T>(messageID: string): Promise<T>;
   send(event: OGIAddonClientSentEvent, args: ClientSentEventTypes[OGIAddonClientSentEvent]): string;

package/build/main.mjs

@@ -9,7 +9,7 @@ import { exec, spawn } from "node:child_process";
 import fs from "node:fs";
 
 //#region package.json
-var version = "2.3.0";
+var version = "2.3.2";
 
 //#endregion
 //#region src/main.ts
@@ -435,6 +435,9 @@ var OGIAddonWSListener = class {
 		}));
 		return await this.waitForResponseFromServer(id);
 	}
+	/**
+	* Registers the message receiver for the socket. This is used to receive messages from the server and handle them.
+	*/
 	registerMessageReceiver() {
 		this.socket.on("message", async (data) => {
 			const message = JSON.parse(data);
@@ -448,10 +451,7 @@ var OGIAddonWSListener = class {
 					else this.respondToMessage(message.id, { success: true }, void 0);
 					break;
 				case "search":
-					let searchResultEvent = new EventResponse((screen, name, description) => this.userInputAsked(screen, name, description, this.socket));
-					this.eventEmitter.emit("search", message.args, searchResultEvent);
-					const searchResult = await this.waitForEventToRespond(searchResultEvent);
-					this.respondToMessage(message.id, searchResult.data, searchResultEvent);
+					await this.handleEventWithResponse(message, (event) => this.eventEmitter.emit("search", message.args, event));
 					break;
 				case "setup": {
 					let setupEvent = new EventResponse((screen, name, description) => this.userInputAsked(screen, name, description, this.socket));
@@ -473,26 +473,16 @@ var OGIAddonWSListener = class {
 					break;
 				}
 				case "library-search":
-					let librarySearchEvent = new EventResponse((screen, name, description) => this.userInputAsked(screen, name, description, this.socket));
-					this.eventEmitter.emit("library-search", message.args, librarySearchEvent);
-					const librarySearchResult = await this.waitForEventToRespond(librarySearchEvent);
-					this.respondToMessage(message.id, librarySearchResult.data, librarySearchEvent);
+					await this.handleEventWithResponse(message, (event) => this.eventEmitter.emit("library-search", message.args, event));
 					break;
 				case "game-details":
-					let gameDetailsEvent = new EventResponse((screen, name, description) => this.userInputAsked(screen, name, description, this.socket));
-					if (this.eventEmitter.listenerCount("game-details") === 0) {
-						this.respondToMessage(message.id, { error: "No event listener for game-details" }, gameDetailsEvent);
-						break;
-					}
-					this.eventEmitter.emit("game-details", message.args, gameDetailsEvent);
-					const gameDetailsResult = await this.waitForEventToRespond(gameDetailsEvent);
-					this.respondToMessage(message.id, gameDetailsResult.data, gameDetailsEvent);
+					await this.handleEventWithResponse(message, (event) => this.eventEmitter.emit("game-details", message.args, event), {
+						requireListener: "game-details",
+						noListenerError: "No event listener for game-details"
+					});
 					break;
 				case "check-for-updates":
-					let checkForUpdatesEvent = new EventResponse((screen, name, description) => this.userInputAsked(screen, name, description, this.socket));
-					this.eventEmitter.emit("check-for-updates", message.args, checkForUpdatesEvent);
-					const checkForUpdatesResult = await this.waitForEventToRespond(checkForUpdatesEvent);
-					this.respondToMessage(message.id, checkForUpdatesResult.data, checkForUpdatesEvent);
+					await this.handleEventWithResponse(message, (event) => this.eventEmitter.emit("check-for-updates", message.args, event));
 					break;
 				case "request-dl":
 					let requestDLEvent = new EventResponse((screen, name, description) => this.userInputAsked(screen, name, description, this.socket));
@@ -510,10 +500,7 @@ var OGIAddonWSListener = class {
 					this.respondToMessage(message.id, requestDLResult.data, requestDLEvent);
 					break;
 				case "catalog":
-					let catalogEvent = new EventResponse();
-					this.eventEmitter.emit("catalog", catalogEvent);
-					const catalogResult = await this.waitForEventToRespond(catalogEvent);
-					this.respondToMessage(message.id, catalogResult.data, catalogEvent);
+					await this.handleEventWithResponseNoInput(message, (event) => this.eventEmitter.emit("catalog", event));
 					break;
 				case "task-run": {
 					let taskRunEvent = new EventResponse((screen, name, description) => this.userInputAsked(screen, name, description, this.socket));
@@ -550,6 +537,9 @@ var OGIAddonWSListener = class {
 					this.respondToMessage(message.id, taskRunResult.data, taskRunEvent);
 					break;
 				}
+				case "launch-app":
+					await this.handleEventWithResponse(message, (event) => this.eventEmitter.emit("launch-app", message.args, event));
+					break;
 			}
 		});
 	}
@@ -574,6 +564,29 @@ var OGIAddonWSListener = class {
 			}, 5e3);
 		});
 	}
+	/**
+	* Common flow for events that use EventResponse with userInputAsked: create event, emit via callback, wait, respond.
+	* If options.requireListener is set and that event has no listeners, responds with options.noListenerError and returns.
+	*/
+	async handleEventWithResponse(message, emit, options) {
+		const event = new EventResponse((screen, name, description) => this.userInputAsked(screen, name, description, this.socket));
+		if (options && this.eventEmitter.listenerCount(options.requireListener) === 0) {
+			this.respondToMessage(message.id, { error: options.noListenerError }, event);
+			return;
+		}
+		emit(event);
+		const result = await this.waitForEventToRespond(event);
+		this.respondToMessage(message.id, result.data, event);
+	}
+	/**
+	* Same as handleEventWithResponse but for events that don't need userInputAsked (e.g. catalog).
+	*/
+	async handleEventWithResponseNoInput(message, emit) {
+		const event = new EventResponse();
+		emit(event);
+		const result = await this.waitForEventToRespond(event);
+		this.respondToMessage(message.id, result.data, event);
+	}
 	respondToMessage(messageID, response, originalEvent) {
 		this.socket.send(JSON.stringify({
 			event: "response",

package/build/main.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"main.mjs","names":["pjson.version","z"],"sources":["../package.json","../src/main.ts"],"sourcesContent":["","import ws, { WebSocket } from 'ws';\nimport events from 'node:events';\nimport { ConfigurationBuilder } from './config/ConfigurationBuilder';\nimport type { ConfigurationFile } from './config/ConfigurationBuilder';\nimport { Configuration } from './config/Configuration';\nimport EventResponse from './EventResponse';\nimport type { SearchResult } from './SearchEngine';\nimport Fuse, { IFuseOptions } from 'fuse.js';\n\nexport type OGIAddonEvent =\n  | 'connect'\n  | 'disconnect'\n  | 'configure'\n  | 'authenticate'\n  | 'search'\n  | 'setup'\n  | 'library-search'\n  | 'game-details'\n  | 'exit'\n  | 'check-for-updates'\n  | 'request-dl'\n  | 'catalog';\n\nexport type OGIAddonClientSentEvent =\n  | 'response'\n  | 'authenticate'\n  | 'configure'\n  | 'defer-update'\n  | 'notification'\n  | 'input-asked'\n  | 'get-app-details'\n  | 'search-app-name'\n  | 'flag'\n  | 'task-update';\n\nexport type OGIAddonServerSentEvent =\n  | 'authenticate'\n  | 'configure'\n  | 'config-update'\n  | 'search'\n  | 'setup'\n  | 'response'\n  | 'library-search'\n  | 'check-for-updates'\n  | 'task-run'\n  | 'game-details'\n  | 'request-dl'\n  | 'catalog';\nexport { ConfigurationBuilder, Configuration, EventResponse };\nexport type { SearchResult };\nconst defaultPort = 7654;\nimport pjson from '../package.json';\nimport { exec, spawn } from 'node:child_process';\nimport fs from 'node:fs';\nimport { z } from 'zod';\nexport const VERSION = pjson.version;\n\nexport interface ClientSentEventTypes {\n  response: any;\n  authenticate: {\n    name: string;\n    id: string;\n    description: string;\n    version: string;\n    author: string;\n  };\n  configure: ConfigurationFile;\n  'defer-update': {\n    logs: string[];\n    progress: number;\n  };\n  notification: Notification;\n  'input-asked': ConfigurationBuilder<\n    Record<string, string | number | boolean>\n  >;\n  'task-update': {\n    id: string;\n    progress: number;\n    logs: string[];\n    finished: boolean;\n    failed: string | undefined;\n  };\n  'get-app-details': {\n    appID: number;\n    storefront: string;\n  };\n  'search-app-name': {\n    query: string;\n    storefront: string;\n  };\n  flag: {\n    flag: string;\n    value: string | string[];\n  };\n}\n\nexport type BasicLibraryInfo = {\n  name: string;\n  capsuleImage: string;\n  appID: number;\n  storefront: string;\n};\n\nexport interface CatalogSection {\n  name: string;\n  description: string;\n  listings: BasicLibraryInfo[];\n}\n\nexport interface CatalogCarouselItem {\n  name: string;\n  description: string;\n  carouselImage: string;\n  fullBannerImage?: string;\n  appID?: number;\n  storefront?: string;\n  capsuleImage?: string;\n}\n\nexport interface CatalogWithCarousel {\n  sections: Record<string, CatalogSection>;\n  carousel?: Record<string, CatalogCarouselItem> | CatalogCarouselItem[];\n}\n\nexport type CatalogResponse = Record<string, CatalogSection> | CatalogWithCarousel;\n\nexport type SetupEventResponse = Omit<\n  LibraryInfo,\n  | 'capsuleImage'\n  | 'coverImage'\n  | 'name'\n  | 'appID'\n  | 'storefront'\n  | 'addonsource'\n  | 'titleImage'\n> & {\n  redistributables?: {\n    name: string;\n    path: string;\n  }[];\n};\n\nexport interface EventListenerTypes {\n  /**\n   * This event is emitted when the addon connects to the OGI Addon Server. Addon does not need to resolve anything.\n   * @param event\n   * @returns\n   */\n  connect: (event: EventResponse<void>) => void;\n\n  /**\n   * This event is emitted when the client requests for the addon to disconnect. Addon does not need to resolve this event, but we recommend `process.exit(0)` so the addon can exit gracefully instead of by force by the addon server.\n   * @param reason\n   * @returns\n   */\n  disconnect: (reason: string) => void;\n  /**\n   * This event is emitted when the client requests for the addon to configure itself. Addon should resolve the event with the internal configuration. (See ConfigurationBuilder)\n   * @param config\n   * @returns\n   */\n  configure: (config: ConfigurationBuilder) => ConfigurationBuilder;\n  /**\n   * This event is called when the client provides a response to any event. This should be treated as middleware.\n   * @param response\n   * @returns\n   */\n  response: (response: any) => void;\n\n  /**\n   * This event is called when the client requests for the addon to authenticate itself. You don't need to provide any info.\n   * @param config\n   * @returns\n   */\n  authenticate: (config: any) => void;\n  /**\n   * This event is emitted when the client requests for a torrent/direct download search to be performed. Addon is given the gameID (could be a steam appID or custom store appID), along with the storefront type. Addon should resolve the event with the search results. (See SearchResult)\n   * @param query\n   * @param event\n   * @returns\n   */\n  search: (\n    query: {\n      storefront: string;\n      appID: number;\n    } & (\n      | {\n          for: 'game' | 'task' | 'all';\n        }\n      | {\n          for: 'update';\n          libraryInfo: LibraryInfo;\n        }\n    ),\n    event: EventResponse<SearchResult[]>\n  ) => void;\n  /**\n   * This event is emitted when the client requests for app setup to be performed. Addon should resolve the event with the metadata for the library entry. (See LibraryInfo)\n   * @param data\n   * @param event\n   * @returns\n   */\n  setup: (\n    data: {\n      path: string;\n      type: 'direct' | 'torrent' | 'magnet' | 'empty';\n      name: string;\n      usedRealDebrid: boolean;\n      multiPartFiles?: {\n        name: string;\n        downloadURL: string;\n      }[];\n      appID: number;\n      storefront: string;\n      manifest?: Record<string, unknown>;\n    } & (\n      | {\n          for: 'game';\n        }\n      | {\n          for: 'update';\n          currentLibraryInfo: LibraryInfo;\n        }\n    ),\n    event: EventResponse<SetupEventResponse>\n  ) => void;\n\n  /**\n   * This event is emitted when the client requires for a search to be performed. Input is the search query.\n   * @param query\n   * @param event\n   * @returns\n   */\n  'library-search': (\n    query: string,\n    event: EventResponse<BasicLibraryInfo[]>\n  ) => void;\n\n  /**\n   * This event is emitted when the client requests for a game details to be fetched. Addon should resolve the event with the game details. This is used to generate a store page for the game.\n   * @param appID\n   * @param event\n   * @returns\n   */\n  'game-details': (\n    details: { appID: number; storefront: string },\n    event: EventResponse<StoreData | undefined>\n  ) => void;\n\n  /**\n   * This event is emitted when the client requests for the addon to exit. Use this to perform any cleanup tasks, ending with a `process.exit(0)`.\n   * @returns\n   */\n  exit: () => void;\n\n  /**\n   * This event is emitted when the client requests for a download to be performed with the 'request' type. Addon should resolve the event with a SearchResult containing the actual download info.\n   * @param appID\n   * @param info\n   * @param event\n   * @returns\n   */\n  'request-dl': (\n    appID: number,\n    info: SearchResult,\n    event: EventResponse<SearchResult>\n  ) => void;\n\n  /**\n   * This event is emitted when the client requests for a catalog to be fetched. Addon should resolve the event with the catalog.\n   * @param event\n   * @returns\n   */\n  catalog: (\n    event: Omit<\n      EventResponse<CatalogResponse>,\n      'askForInput'\n    >\n  ) => void;\n\n  /**\n   * This event is emitted when the client requests for an addon to check for updates. Addon should resolve the event with the update information.\n   * @param data\n   * @param event\n   * @returns\n   */\n  'check-for-updates': (\n    data: { appID: number; storefront: string; currentVersion: string },\n    event: EventResponse<\n      | {\n          available: true;\n          version: string;\n        }\n      | {\n          available: false;\n        }\n    >\n  ) => void;\n}\n\nexport interface StoreData {\n  name: string;\n  publishers: string[];\n  developers: string[];\n  appID: number;\n  releaseDate: string;\n  capsuleImage: string;\n  coverImage: string;\n  basicDescription: string;\n  description: string;\n  headerImage: string;\n  latestVersion: string;\n}\nexport interface WebsocketMessageClient {\n  event: OGIAddonClientSentEvent;\n  id?: string;\n  args: any;\n  statusError?: string;\n}\nexport interface WebsocketMessageServer {\n  event: OGIAddonServerSentEvent;\n  id?: string;\n  args: any;\n  statusError?: string;\n}\n\n/**\n * The configuration for the addon. This is used to identify the addon and provide information about it.\n * Storefronts is an array of names of stores that the addon supports.\n */\nexport interface OGIAddonConfiguration {\n  name: string;\n  id: string;\n  description: string;\n  version: string;\n\n  author: string;\n  repository: string;\n  storefronts: string[];\n}\n\n/**\n * The main class for the OGI Addon. This class is used to interact with the OGI Addon Server. The OGI Addon Server provides a `--addonSecret` to the addon so it can securely connect.\n * @example\n * ```typescript\n * const addon = new OGIAddon({\n *  name: 'Test Addon',\n *   id: 'test-addon',\n *  description: 'A test addon',\n *  version: '1.0.0',\n *  author: 'OGI Developers',\n *  repository: ''\n * });\n * ```\n *\n */\nexport default class OGIAddon {\n  public eventEmitter = new events.EventEmitter();\n  public addonWSListener: OGIAddonWSListener;\n  public addonInfo: OGIAddonConfiguration;\n  public config: Configuration = new Configuration({});\n  private eventsAvailable: OGIAddonEvent[] = [];\n  private registeredConnectEvent: boolean = false;\n  private taskHandlers: Map<\n    string,\n    (\n      task: Task,\n      data: {\n        manifest: Record<string, unknown>;\n        downloadPath: string;\n        name: string;\n        libraryInfo: LibraryInfo;\n      }\n    ) => Promise<void> | void\n  > = new Map();\n\n  constructor(addonInfo: OGIAddonConfiguration) {\n    this.addonInfo = addonInfo;\n    this.addonWSListener = new OGIAddonWSListener(this, this.eventEmitter);\n  }\n\n  /**\n   * Register an event listener for the addon. (See EventListenerTypes)\n   * @param event {OGIAddonEvent}\n   * @param listener {EventListenerTypes[OGIAddonEvent]}\n   */\n  public on<T extends OGIAddonEvent>(\n    event: T,\n    listener: EventListenerTypes[T]\n  ) {\n    this.eventEmitter.on(event, listener);\n    this.eventsAvailable.push(event);\n    // wait for the addon to be connected\n    if (!this.registeredConnectEvent) {\n      this.addonWSListener.eventEmitter.once('connect', () => {\n        this.addonWSListener.send('flag', {\n          flag: 'events-available',\n          value: this.eventsAvailable,\n        });\n      });\n      this.registeredConnectEvent = true;\n    }\n  }\n\n  public emit<T extends OGIAddonEvent>(\n    event: T,\n    ...args: Parameters<EventListenerTypes[T]>\n  ) {\n    this.eventEmitter.emit(event, ...args);\n  }\n\n  /**\n   * Notify the client using a notification. Provide the type of notification, the message, and an ID.\n   * @param notification {Notification}\n   */\n  public notify(notification: Notification) {\n    this.addonWSListener.send('notification', [notification]);\n  }\n\n  /**\n   * Get the app details for a given appID and storefront.\n   * @param appID {number}\n   * @param storefront {string}\n   * @returns {Promise<StoreData>}\n   */\n  public async getAppDetails(appID: number, storefront: string) {\n    const id = this.addonWSListener.send('get-app-details', {\n      appID,\n      storefront,\n    });\n    return await this.addonWSListener.waitForResponseFromServer<\n      StoreData | undefined\n    >(id);\n  }\n\n  public async searchGame(query: string, storefront: string) {\n    const id = this.addonWSListener.send('search-app-name', {\n      query,\n      storefront,\n    });\n    return await this.addonWSListener.waitForResponseFromServer<\n      BasicLibraryInfo[]\n    >(id);\n  }\n\n  /**\n   * Notify the OGI Addon Server that you are performing a background task. This can be used to help users understand what is happening in the background.\n   * @returns {Promise<Task>} A Task instance for managing the background task.\n   */\n  public async task(): Promise<Task> {\n    const id = Math.random().toString(36).substring(7);\n    const progress = 0;\n    const logs: string[] = [];\n    const task = new Task(this.addonWSListener, id, progress, logs);\n    this.addonWSListener.send('task-update', {\n      id,\n      progress,\n      logs,\n      finished: false,\n      failed: undefined,\n    });\n    return task;\n  }\n\n  /**\n   * Register a task handler for a specific task name. The task name should match the taskName field in SearchResult or ActionOption.\n   * @param taskName {string} The name of the task (should match taskName in SearchResult or ActionOption.setTaskName()).\n   * @param handler {(task: Task, data: { manifest: Record<string, unknown>; downloadPath: string; name: string; libraryInfo: LibraryInfo }) => Promise<void> | void} The handler function.\n   * @example\n   * ```typescript\n   * addon.onTask('clearCache', async (task) => {\n   *   task.log('Clearing cache...');\n   *   task.setProgress(50);\n   *   await clearCacheFiles();\n   *   task.setProgress(100);\n   *   task.complete();\n   * });\n   * ```\n   */\n  public onTask(\n    taskName: string,\n    handler: (\n      task: Task,\n      data: {\n        manifest: Record<string, unknown>;\n        downloadPath: string;\n        name: string;\n        libraryInfo: LibraryInfo;\n      }\n    ) => Promise<void> | void\n  ): void {\n    this.taskHandlers.set(taskName, handler);\n  }\n\n  /**\n   * Check if a task handler is registered for the given task name.\n   * @param taskName {string} The task name to check.\n   * @returns {boolean} True if a handler is registered.\n   */\n  public hasTaskHandler(taskName: string): boolean {\n    return this.taskHandlers.has(taskName);\n  }\n\n  /**\n   * Get a task handler for the given task name.\n   * @param taskName {string} The task name.\n   * @returns The handler function or undefined if not found.\n   */\n  public getTaskHandler(taskName: string):\n    | ((\n        task: Task,\n        data: {\n          manifest: Record<string, unknown>;\n          downloadPath: string;\n          name: string;\n          libraryInfo?: LibraryInfo;\n        }\n      ) => Promise<void> | void)\n    | undefined {\n    return this.taskHandlers.get(taskName);\n  }\n\n  /**\n   * Extract a file using 7-Zip on Windows, unzip on Linux/Mac.\n   * @param path {string}\n   * @param outputPath {string}\n   * @param type {'unrar' | 'unzip'}\n   * @returns {Promise<void>}\n   */\n  public async extractFile(\n    path: string,\n    outputPath: string,\n    type: 'unrar' | 'unzip'\n  ) {\n    return new Promise<void>((resolve, reject) => {\n      // Ensure outputPath exists\n      if (!fs.existsSync(outputPath)) {\n        fs.mkdirSync(outputPath, { recursive: true });\n      }\n\n      if (type === 'unzip') {\n        // Prefer 7-Zip on Windows, unzip on Linux/Mac\n        if (process.platform === 'win32') {\n          // 7-Zip path (default install location)\n          const s7ZipPath = '\"C:\\\\Program Files\\\\7-Zip\\\\7z.exe\"';\n          exec(\n            `${s7ZipPath} x \"${path}\" -o\"${outputPath}\"`,\n            (err: any, stdout: any, stderr: any) => {\n              if (err) {\n                console.error(err);\n                console.log(stderr);\n                reject(new Error('Failed to extract ZIP file'));\n                return;\n              }\n              console.log(stdout);\n              console.log(stderr);\n              resolve();\n            }\n          );\n        } else {\n          // Use unzip on Linux/Mac\n          const unzipProcess = spawn(\n            'unzip',\n            [\n              '-o', // overwrite files without prompting\n              path,\n              '-d', // specify output directory\n              outputPath,\n            ],\n            {\n              env: {\n                ...process.env,\n                UNZIP_DISABLE_ZIPBOMB_DETECTION: 'TRUE',\n              },\n            }\n          );\n\n          unzipProcess.stdout.on('data', (data: Buffer) => {\n            console.log(`[unzip stdout]: ${data}`);\n          });\n\n          unzipProcess.stderr.on('data', (data: Buffer) => {\n            console.error(`[unzip stderr]: ${data}`);\n          });\n\n          unzipProcess.on('close', (code: number) => {\n            if (code !== 0) {\n              console.error(`unzip process exited with code ${code}`);\n              reject(new Error('Failed to extract ZIP file'));\n              return;\n            }\n            resolve();\n          });\n        }\n      } else if (type === 'unrar') {\n        if (process.platform === 'win32') {\n          // 7-Zip path (default install location)\n          const s7ZipPath = '\"C:\\\\Program Files\\\\7-Zip\\\\7z.exe\"';\n          exec(\n            `${s7ZipPath} x \"${path}\" -o\"${outputPath}\"`,\n            (err: any, stdout: any, stderr: any) => {\n              if (err) {\n                console.error(err);\n                console.log(stderr);\n                reject(new Error('Failed to extract RAR file'));\n                return;\n              }\n              console.log(stdout);\n              console.log(stderr);\n              resolve();\n            }\n          );\n        } else {\n          // Use unrar on Linux/Mac\n          const unrarProcess = spawn('unrar', ['x', '-y', path, outputPath]);\n\n          unrarProcess.stdout.on('data', (data: Buffer) => {\n            console.log(`[unrar stdout]: ${data}`);\n          });\n\n          unrarProcess.stderr.on('data', (data: Buffer) => {\n            console.error(`[unrar stderr]: ${data}`);\n          });\n\n          unrarProcess.on('close', (code: number) => {\n            if (code !== 0) {\n              console.error(`unrar process exited with code ${code}`);\n              reject(new Error('Failed to extract RAR file'));\n              return;\n            }\n            resolve();\n          });\n        }\n      } else {\n        reject(new Error('Unknown extraction type'));\n      }\n    });\n  }\n}\n\n/**\n * A unified task API for both server-initiated tasks (via onTask handlers)\n * and addon-initiated background tasks (via addon.task()).\n * Provides chainable methods for logging, progress updates, and completion.\n */\nexport class Task {\n  // EventResponse-based mode (for onTask handlers)\n  private event: EventResponse<void> | undefined;\n\n  // WebSocket-based mode (for addon.task())\n  private ws: OGIAddonWSListener | undefined;\n  private readonly id: string | undefined;\n  private progress: number = 0;\n  private logs: string[] = [];\n  private finished: boolean = false;\n  private failed: string | undefined = undefined;\n\n  /**\n   * Construct a Task from an EventResponse (for onTask handlers).\n   * @param event {EventResponse<void>} The event response to wrap.\n   */\n  constructor(event: EventResponse<void>);\n\n  /**\n   * Construct a Task from WebSocket listener (for addon.task()).\n   * @param ws {OGIAddonWSListener} The WebSocket listener.\n   * @param id {string} The task ID.\n   * @param progress {number} Initial progress (0-100).\n   * @param logs {string[]} Initial logs array.\n   */\n  constructor(\n    ws: OGIAddonWSListener,\n    id: string,\n    progress: number,\n    logs: string[]\n  );\n\n  constructor(\n    eventOrWs: EventResponse<void> | OGIAddonWSListener,\n    id?: string,\n    progress?: number,\n    logs?: string[]\n  ) {\n    if (eventOrWs instanceof EventResponse) {\n      // EventResponse-based mode\n      this.event = eventOrWs;\n      this.event.defer();\n    } else {\n      // WebSocket-based mode\n      this.ws = eventOrWs;\n      this.id = id!;\n      this.progress = progress ?? 0;\n      this.logs = logs ?? [];\n    }\n  }\n\n  /**\n   * Log a message to the task. Returns this for chaining.\n   * @param message {string} The message to log.\n   */\n  log(message: string): this {\n    if (this.event) {\n      this.event.log(message);\n    } else {\n      this.logs.push(message);\n      this.update();\n    }\n    return this;\n  }\n\n  /**\n   * Set the progress of the task (0-100). Returns this for chaining.\n   * @param progress {number} The progress value (0-100).\n   */\n  setProgress(progress: number): this {\n    if (this.event) {\n      this.event.progress = progress;\n    } else {\n      this.progress = progress;\n      this.update();\n    }\n    return this;\n  }\n\n  /**\n   * Complete the task successfully.\n   */\n  complete(): void {\n    if (this.event) {\n      this.event.complete();\n    } else {\n      this.finished = true;\n      this.update();\n    }\n  }\n\n  /**\n   * Fail the task with an error message.\n   * @param message {string} The error message.\n   */\n  fail(message: string): void {\n    if (this.event) {\n      this.event.fail(message);\n    } else {\n      this.failed = message;\n      this.update();\n    }\n  }\n\n  /**\n   * Ask the user for input using a ConfigurationBuilder screen.\n   * Only available for EventResponse-based tasks (onTask handlers).\n   * The return type is inferred from the ConfigurationBuilder's accumulated option types.\n   * @param name {string} The name/title of the input prompt.\n   * @param description {string} The description of what input is needed.\n   * @param screen {ConfigurationBuilder<U>} The configuration builder for the input form.\n   * @returns {Promise<U>} The user's input with types matching the configuration options.\n   * @throws {Error} If called on a WebSocket-based task.\n   */\n  async askForInput<U extends Record<string, string | number | boolean>>(\n    name: string,\n    description: string,\n    screen: ConfigurationBuilder<U>\n  ): Promise<U> {\n    if (!this.event) {\n      throw new Error(\n        'askForInput() is only available for EventResponse-based tasks (onTask handlers)'\n      );\n    }\n    return this.event.askForInput(name, description, screen);\n  }\n\n  /**\n   * Update the task state (for WebSocket-based tasks only).\n   * Called automatically when using log(), setProgress(), complete(), or fail().\n   */\n  private update(): void {\n    if (this.ws && this.id !== undefined) {\n      this.ws.send('task-update', {\n        id: this.id,\n        progress: this.progress,\n        logs: this.logs,\n        finished: this.finished,\n        failed: this.failed,\n      });\n    }\n  }\n}\n/**\n * A search tool wrapper over Fuse.js for the OGI Addon. This tool is used to search for items in the library.\n * @example\n * ```typescript\n * const searchTool = new SearchTool<LibraryInfo>([{ name: 'test', appID: 123 }, { name: 'test2', appID: 124 }], ['name']);\n * const results = searchTool.search('test', 10);\n * ```\n */\nexport class SearchTool<T> {\n  private fuse: Fuse<T>;\n  constructor(\n    items: T[],\n    keys: string[],\n    options: Omit<IFuseOptions<T>, 'keys'> = {\n      threshold: 0.3,\n      includeScore: true,\n    }\n  ) {\n    this.fuse = new Fuse(items, {\n      keys,\n      ...options,\n    });\n  }\n  public search(query: string, limit: number = 10): T[] {\n    return this.fuse\n      .search(query)\n      .slice(0, limit)\n      .map((result) => result.item);\n  }\n  public addItems(items: T[]) {\n    items.map((item) => this.fuse.add(item));\n  }\n}\n/**\n * Library Info is the metadata for a library entry after setting up a game.\n */\nexport const ZodLibraryInfo = z.object({\n  name: z.string(),\n  version: z.string(),\n  cwd: z.string(),\n  appID: z.number(),\n  launchExecutable: z.string(),\n  launchArguments: z.string().optional(),\n  capsuleImage: z.string(),\n  storefront: z.string(),\n  addonsource: z.string(),\n  coverImage: z.string(),\n  titleImage: z.string().optional(),\n});\nexport type LibraryInfo = z.infer<typeof ZodLibraryInfo>;\ninterface Notification {\n  type: 'warning' | 'error' | 'info' | 'success';\n  message: string;\n  id: string;\n}\nclass OGIAddonWSListener {\n  private socket: WebSocket;\n  public eventEmitter: events.EventEmitter;\n  public addon: OGIAddon;\n\n  constructor(ogiAddon: OGIAddon, eventEmitter: events.EventEmitter) {\n    if (\n      process.argv[process.argv.length - 1].split('=')[0] !== '--addonSecret'\n    ) {\n      throw new Error(\n        'No secret provided. This usually happens because the addon was not started by the OGI Addon Server.'\n      );\n    }\n    this.addon = ogiAddon;\n    this.eventEmitter = eventEmitter;\n    this.socket = new ws('ws://localhost:' + defaultPort);\n    this.socket.on('open', () => {\n      console.log('Connected to OGI Addon Server');\n      console.log('OGI Addon Server Version:', VERSION);\n\n      // Authenticate with OGI Addon Server\n      this.send('authenticate', {\n        ...this.addon.addonInfo,\n        secret: process.argv[process.argv.length - 1].split('=')[1],\n        ogiVersion: VERSION,\n      });\n\n      // send a configuration request\n      let configBuilder = new ConfigurationBuilder();\n      this.eventEmitter.emit('configure', configBuilder);\n      this.send('configure', configBuilder.build(false));\n      this.addon.config = new Configuration(configBuilder.build(true));\n\n      // wait for the config-update to be received then send connect\n      const configListener = (event: ws.MessageEvent) => {\n        if (event === undefined) return;\n        // event can be a Buffer, string, ArrayBuffer, or Buffer[]\n        let data: string;\n        if (typeof event === 'string') {\n          data = event;\n        } else if (event instanceof Buffer) {\n          data = event.toString();\n        } else if (event && typeof (event as any).data === 'string') {\n          data = (event as any).data;\n        } else if (event && (event as any).data instanceof Buffer) {\n          data = (event as any).data.toString();\n        } else {\n          // fallback for other types\n          data = event.toString();\n        }\n        const message: WebsocketMessageServer = JSON.parse(data);\n        if (message.event === 'config-update') {\n          console.log('Config update received');\n          this.socket.off('message', configListener);\n          this.eventEmitter.emit(\n            'connect',\n            new EventResponse<void>((screen, name, description) => {\n              return this.userInputAsked(\n                screen,\n                name,\n                description,\n                this.socket\n              );\n            })\n          );\n        }\n      };\n      this.socket.on('message', configListener);\n    });\n\n    this.socket.on('error', (error) => {\n      if (error.message.includes('Failed to connect')) {\n        throw new Error(\n          'OGI Addon Server is not running/is unreachable. Please start the server and try again.'\n        );\n      }\n      console.error('An error occurred:', error);\n    });\n\n    this.socket.on('close', (code, reason) => {\n      if (code === 1008) {\n        console.error('Authentication failed:', reason);\n        return;\n      }\n      this.eventEmitter.emit('disconnect', reason);\n      console.log('Disconnected from OGI Addon Server');\n      console.error(reason.toString());\n      this.eventEmitter.emit('exit');\n      this.socket.close();\n    });\n\n    this.registerMessageReceiver();\n  }\n\n  private async userInputAsked<\n    U extends Record<string, string | number | boolean>,\n  >(\n    configBuilt: ConfigurationBuilder<U>,\n    name: string,\n    description: string,\n    socket: WebSocket\n  ): Promise<U> {\n    const config = configBuilt.build(false);\n    const id = Math.random().toString(36).substring(7);\n    if (!socket) {\n      throw new Error('Socket is not connected');\n    }\n    socket.send(\n      JSON.stringify({\n        event: 'input-asked',\n        args: {\n          config,\n          name,\n          description,\n        },\n        id: id,\n      })\n    );\n    return await this.waitForResponseFromServer<U>(id);\n  }\n\n  private registerMessageReceiver() {\n    this.socket.on('message', async (data: string) => {\n      const message: WebsocketMessageServer = JSON.parse(data);\n      switch (message.event) {\n        case 'config-update':\n          const result = this.addon.config.updateConfig(message.args);\n          if (!result[0]) {\n            this.respondToMessage(\n              message.id!!,\n              {\n                success: false,\n                error: result[1],\n              },\n              undefined\n            );\n          } else {\n            this.respondToMessage(message.id!!, { success: true }, undefined);\n          }\n          break;\n        case 'search':\n          let searchResultEvent = new EventResponse<SearchResult[]>(\n            (screen, name, description) =>\n              this.userInputAsked(screen, name, description, this.socket)\n          );\n          this.eventEmitter.emit('search', message.args, searchResultEvent);\n          const searchResult =\n            await this.waitForEventToRespond(searchResultEvent);\n          this.respondToMessage(\n            message.id!!,\n            searchResult.data,\n            searchResultEvent\n          );\n          break;\n        case 'setup': {\n          let setupEvent = new EventResponse<SetupEventResponse>(\n            (screen, name, description) =>\n              this.userInputAsked(screen, name, description, this.socket)\n          );\n          this.eventEmitter.emit('setup', message.args, setupEvent);\n          const interval = setInterval(() => {\n            if (setupEvent.resolved) {\n              clearInterval(interval);\n              return;\n            }\n            this.send('defer-update', {\n              logs: setupEvent.logs,\n              deferID: message.args.deferID,\n              progress: setupEvent.progress,\n              failed: setupEvent.failed,\n            } as ClientSentEventTypes['defer-update']);\n          }, 100);\n          const setupResult = await this.waitForEventToRespond(setupEvent);\n          this.respondToMessage(message.id!!, setupResult.data, setupEvent);\n          break;\n        }\n        case 'library-search':\n          let librarySearchEvent = new EventResponse<BasicLibraryInfo[]>(\n            (screen, name, description) =>\n              this.userInputAsked(screen, name, description, this.socket)\n          );\n          this.eventEmitter.emit(\n            'library-search',\n            message.args,\n            librarySearchEvent\n          );\n          const librarySearchResult =\n            await this.waitForEventToRespond(librarySearchEvent);\n          this.respondToMessage(\n            message.id!!,\n            librarySearchResult.data,\n            librarySearchEvent\n          );\n          break;\n        case 'game-details':\n          let gameDetailsEvent = new EventResponse<StoreData | undefined>(\n            (screen, name, description) =>\n              this.userInputAsked(screen, name, description, this.socket)\n          );\n          if (this.eventEmitter.listenerCount('game-details') === 0) {\n            this.respondToMessage(\n              message.id!!,\n              {\n                error: 'No event listener for game-details',\n              },\n              gameDetailsEvent\n            );\n            break;\n          }\n          this.eventEmitter.emit(\n            'game-details',\n            message.args,\n            gameDetailsEvent\n          );\n          const gameDetailsResult =\n            await this.waitForEventToRespond(gameDetailsEvent);\n          this.respondToMessage(\n            message.id!!,\n            gameDetailsResult.data,\n            gameDetailsEvent\n          );\n          break;\n        case 'check-for-updates':\n          let checkForUpdatesEvent = new EventResponse<\n            | {\n                available: true;\n                version: string;\n              }\n            | {\n                available: false;\n              }\n          >((screen, name, description) =>\n            this.userInputAsked(screen, name, description, this.socket)\n          );\n          this.eventEmitter.emit(\n            'check-for-updates',\n            message.args,\n            checkForUpdatesEvent\n          );\n          const checkForUpdatesResult =\n            await this.waitForEventToRespond(checkForUpdatesEvent);\n          this.respondToMessage(\n            message.id!!,\n            checkForUpdatesResult.data,\n            checkForUpdatesEvent\n          );\n          break;\n        case 'request-dl':\n          let requestDLEvent = new EventResponse<SearchResult>(\n            (screen, name, description) =>\n              this.userInputAsked(screen, name, description, this.socket)\n          );\n          if (this.eventEmitter.listenerCount('request-dl') === 0) {\n            this.respondToMessage(\n              message.id!!,\n              {\n                error: 'No event listener for request-dl',\n              },\n              requestDLEvent\n            );\n            break;\n          }\n          this.eventEmitter.emit(\n            'request-dl',\n            message.args.appID,\n            message.args.info,\n            requestDLEvent\n          );\n          const requestDLResult =\n            await this.waitForEventToRespond(requestDLEvent);\n          if (requestDLEvent.failed) {\n            this.respondToMessage(message.id!!, undefined, requestDLEvent);\n            break;\n          }\n          if (\n            requestDLEvent.data === undefined ||\n            requestDLEvent.data?.downloadType === 'request'\n          ) {\n            throw new Error(\n              'Request DL event did not return a valid result. Please ensure that the event does not resolve with another `request` download type.'\n            );\n          }\n          this.respondToMessage(\n            message.id!!,\n            requestDLResult.data,\n            requestDLEvent\n          );\n          break;\n        case 'catalog':\n          let catalogEvent = new EventResponse<CatalogResponse>();\n          this.eventEmitter.emit('catalog', catalogEvent);\n          const catalogResult = await this.waitForEventToRespond(catalogEvent);\n          this.respondToMessage(message.id!!, catalogResult.data, catalogEvent);\n          break;\n        case 'task-run': {\n          let taskRunEvent = new EventResponse<void>(\n            (screen, name, description) =>\n              this.userInputAsked(screen, name, description, this.socket)\n          );\n\n          // Check for taskName: first from args directly (from SearchResult), then from manifest.__taskName (for ActionOption)\n          const taskName =\n            message.args.taskName && typeof message.args.taskName === 'string'\n              ? message.args.taskName\n              : message.args.manifest &&\n                  typeof message.args.manifest === 'object'\n                ? (message.args.manifest as Record<string, unknown>).__taskName\n                : undefined;\n\n          if (\n            taskName &&\n            typeof taskName === 'string' &&\n            this.addon.hasTaskHandler(taskName)\n          ) {\n            // Use the registered task handler\n            const handler = this.addon.getTaskHandler(taskName)!;\n            const task = new Task(taskRunEvent);\n            try {\n              const interval = setInterval(() => {\n                if (taskRunEvent.resolved) {\n                  clearInterval(interval);\n                  return;\n                }\n                this.send('defer-update', {\n                  logs: taskRunEvent.logs,\n                  deferID: message.args.deferID,\n                  progress: taskRunEvent.progress,\n                  failed: taskRunEvent.failed,\n                } as ClientSentEventTypes['defer-update']);\n              }, 100);\n              const result = handler(task, {\n                manifest: message.args.manifest || {},\n                downloadPath: message.args.downloadPath || '',\n                name: message.args.name || '',\n                libraryInfo: message.args.libraryInfo,\n              });\n              // If handler returns a promise, wait for it\n              if (result instanceof Promise) {\n                await result;\n              }\n\n              clearInterval(interval);\n            } catch (error) {\n              taskRunEvent.fail(\n                error instanceof Error ? error.message : String(error)\n              );\n            }\n          } else {\n            // No handler found - fail the task\n            taskRunEvent.fail(\n              taskName\n                ? `No task handler registered for task name: ${taskName}`\n                : 'No task name provided'\n            );\n          }\n\n          const taskRunResult = await this.waitForEventToRespond(taskRunEvent);\n          this.respondToMessage(message.id!!, taskRunResult.data, taskRunEvent);\n          break;\n        }\n      }\n    });\n  }\n\n  private waitForEventToRespond<T>(\n    event: EventResponse<T>\n  ): Promise<EventResponse<T>> {\n    // check the handlers to see if there even is any\n    return new Promise((resolve, reject) => {\n      const dataGet = setInterval(() => {\n        if (event.resolved) {\n          resolve(event);\n          clearTimeout(timeout);\n        }\n      }, 5);\n\n      const timeout = setTimeout(() => {\n        if (event.deffered) {\n          clearInterval(dataGet);\n          const interval = setInterval(() => {\n            if (event.resolved) {\n              clearInterval(interval);\n              resolve(event);\n            }\n          }, 100);\n        } else {\n          reject('Event did not respond in time');\n        }\n      }, 5000);\n    });\n  }\n\n  public respondToMessage(\n    messageID: string,\n    response: any,\n    originalEvent: EventResponse<any> | undefined\n  ) {\n    this.socket.send(\n      JSON.stringify({\n        event: 'response',\n        id: messageID,\n        args: response,\n        statusError: originalEvent ? originalEvent.failed : undefined,\n      })\n    );\n    console.log('dispatched response to ' + messageID);\n  }\n\n  public waitForResponseFromServer<T>(messageID: string): Promise<T> {\n    return new Promise((resolve) => {\n      const waiter = (data: string) => {\n        const message: WebsocketMessageClient = JSON.parse(data);\n        if (message.event !== 'response') {\n          this.socket.once('message', waiter);\n          return;\n        }\n        console.log('received response from ' + messageID);\n\n        if (message.id === messageID) {\n          resolve(message.args);\n        } else {\n          this.socket.once('message', waiter);\n        }\n      };\n      this.socket.once('message', waiter);\n    });\n  }\n\n  public send(\n    event: OGIAddonClientSentEvent,\n    args: ClientSentEventTypes[OGIAddonClientSentEvent]\n  ): string {\n    // generate a random id\n    const id = Math.random().toString(36).substring(7);\n    this.socket.send(\n      JSON.stringify({\n        event,\n        args,\n        id,\n      })\n    );\n    return id;\n  }\n\n  public close() {\n    this.socket.close();\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"main.mjs","names":["pjson.version","z"],"sources":["../package.json","../src/main.ts"],"sourcesContent":["","import ws, { WebSocket } from 'ws';\nimport events from 'node:events';\nimport { ConfigurationBuilder } from './config/ConfigurationBuilder';\nimport type { ConfigurationFile } from './config/ConfigurationBuilder';\nimport { Configuration } from './config/Configuration';\nimport EventResponse from './EventResponse';\nimport type { SearchResult } from './SearchEngine';\nimport Fuse, { IFuseOptions } from 'fuse.js';\n\n/**\n * Exposed events that the programmer can use to listen to and emit events.\n */\nexport type OGIAddonEvent =\n  | 'connect'\n  | 'disconnect'\n  | 'configure'\n  | 'authenticate'\n  | 'search'\n  | 'setup'\n  | 'library-search'\n  | 'game-details'\n  | 'exit'\n  | 'check-for-updates'\n  | 'request-dl'\n  | 'catalog'\n  | 'launch-app';\n\n/**\n * The events that the client can send to the server and are handled by the server.\n */\nexport type OGIAddonClientSentEvent =\n  | 'response'\n  | 'authenticate'\n  | 'configure'\n  | 'defer-update'\n  | 'notification'\n  | 'input-asked'\n  | 'get-app-details'\n  | 'search-app-name'\n  | 'flag'\n  | 'task-update';\n\n/**\n * The events that the server sends to the client\n * This is the events that the server can send to the client and are handled by the client.\n */\nexport type OGIAddonServerSentEvent =\n  | 'authenticate'\n  | 'configure'\n  | 'config-update'\n  | 'launch-app'\n  | 'search'\n  | 'setup'\n  | 'response'\n  | 'library-search'\n  | 'check-for-updates'\n  | 'task-run'\n  | 'game-details'\n  | 'request-dl'\n  | 'catalog';\nexport { ConfigurationBuilder, Configuration, EventResponse };\nexport type { SearchResult };\nconst defaultPort = 7654;\nimport pjson from '../package.json';\nimport { exec, spawn } from 'node:child_process';\nimport fs from 'node:fs';\nimport { z } from 'zod';\nexport const VERSION = pjson.version;\n\nexport interface ClientSentEventTypes {\n  response: any;\n  authenticate: {\n    name: string;\n    id: string;\n    description: string;\n    version: string;\n    author: string;\n  };\n  configure: ConfigurationFile;\n  'defer-update': {\n    logs: string[];\n    progress: number;\n  };\n  notification: Notification;\n  'input-asked': ConfigurationBuilder<\n    Record<string, string | number | boolean>\n  >;\n  'task-update': {\n    id: string;\n    progress: number;\n    logs: string[];\n    finished: boolean;\n    failed: string | undefined;\n  };\n  'get-app-details': {\n    appID: number;\n    storefront: string;\n  };\n  'search-app-name': {\n    query: string;\n    storefront: string;\n  };\n  flag: {\n    flag: string;\n    value: string | string[];\n  };\n}\n\nexport type BasicLibraryInfo = {\n  name: string;\n  capsuleImage: string;\n  appID: number;\n  storefront: string;\n};\n\nexport interface CatalogSection {\n  name: string;\n  description: string;\n  listings: BasicLibraryInfo[];\n}\n\nexport interface CatalogCarouselItem {\n  name: string;\n  description: string;\n  carouselImage: string;\n  fullBannerImage?: string;\n  appID?: number;\n  storefront?: string;\n  capsuleImage?: string;\n}\n\nexport interface CatalogWithCarousel {\n  sections: Record<string, CatalogSection>;\n  carousel?: Record<string, CatalogCarouselItem> | CatalogCarouselItem[];\n}\n\nexport type CatalogResponse =\n  | Record<string, CatalogSection>\n  | CatalogWithCarousel;\n\nexport type SetupEventResponse = Omit<\n  LibraryInfo,\n  | 'capsuleImage'\n  | 'coverImage'\n  | 'name'\n  | 'appID'\n  | 'storefront'\n  | 'addonsource'\n  | 'titleImage'\n> & {\n  redistributables?: {\n    name: string;\n    path: string;\n  }[];\n};\n\nexport interface EventListenerTypes {\n  /**\n   * This event is emitted when the addon connects to the OGI Addon Server. Addon does not need to resolve anything.\n   * @param event\n   * @returns\n   */\n  connect: (event: EventResponse<void>) => void;\n\n  /**\n   * This event is emitted when the client requests for the addon to disconnect. Addon does not need to resolve this event, but we recommend `process.exit(0)` so the addon can exit gracefully instead of by force by the addon server.\n   * @param reason\n   * @returns\n   */\n  disconnect: (reason: string) => void;\n  /**\n   * This event is emitted when the client requests for the addon to configure itself. Addon should resolve the event with the internal configuration. (See ConfigurationBuilder)\n   * @param config\n   * @returns\n   */\n  configure: (config: ConfigurationBuilder) => ConfigurationBuilder;\n  /**\n   * This event is called when the client provides a response to any event. This should be treated as middleware.\n   * @param response\n   * @returns\n   */\n  response: (response: any) => void;\n\n  /**\n   * This event is called when the client requests for the addon to authenticate itself. You don't need to provide any info.\n   * @param config\n   * @returns\n   */\n  authenticate: (config: any) => void;\n  /**\n   * This event is emitted when the client requests for a torrent/direct download search to be performed. Addon is given the gameID (could be a steam appID or custom store appID), along with the storefront type. Addon should resolve the event with the search results. (See SearchResult)\n   * @param query\n   * @param event\n   * @returns\n   */\n  search: (\n    query: {\n      storefront: string;\n      appID: number;\n    } & (\n      | {\n          for: 'game' | 'task' | 'all';\n        }\n      | {\n          for: 'update';\n          libraryInfo: LibraryInfo;\n        }\n    ),\n    event: EventResponse<SearchResult[]>\n  ) => void;\n  /**\n   * This event is emitted when the client requests for app setup to be performed. Addon should resolve the event with the metadata for the library entry. (See LibraryInfo)\n   * @param data\n   * @param event\n   * @returns\n   */\n  setup: (\n    data: {\n      path: string;\n      type: 'direct' | 'torrent' | 'magnet' | 'empty';\n      name: string;\n      usedRealDebrid: boolean;\n      clearOldFilesBeforeUpdate?: boolean;\n      multiPartFiles?: {\n        name: string;\n        downloadURL: string;\n      }[];\n      appID: number;\n      storefront: string;\n      manifest?: Record<string, unknown>;\n    } & (\n      | {\n          for: 'game';\n        }\n      | {\n          for: 'update';\n          currentLibraryInfo: LibraryInfo;\n        }\n    ),\n    event: EventResponse<SetupEventResponse>\n  ) => void;\n\n  /**\n   * This event is emitted when the client requires for a search to be performed. Input is the search query.\n   * @param query\n   * @param event\n   * @returns\n   */\n  'library-search': (\n    query: string,\n    event: EventResponse<BasicLibraryInfo[]>\n  ) => void;\n\n  /**\n   * This event is emitted when the client requests for a game details to be fetched. Addon should resolve the event with the game details. This is used to generate a store page for the game.\n   * @param appID\n   * @param event\n   * @returns\n   */\n  'game-details': (\n    details: { appID: number; storefront: string },\n    event: EventResponse<StoreData | undefined>\n  ) => void;\n\n  /**\n   * This event is emitted when the client requests for the addon to exit. Use this to perform any cleanup tasks, ending with a `process.exit(0)`.\n   * @returns\n   */\n  exit: () => void;\n\n  /**\n   * This event is emitted when the client requests for a download to be performed with the 'request' type. Addon should resolve the event with a SearchResult containing the actual download info.\n   * @param appID\n   * @param info\n   * @param event\n   * @returns\n   */\n  'request-dl': (\n    appID: number,\n    info: SearchResult,\n    event: EventResponse<SearchResult>\n  ) => void;\n\n  /**\n   * This event is emitted when the client requests for a catalog to be fetched. Addon should resolve the event with the catalog.\n   * @param event\n   * @returns\n   */\n  catalog: (event: Omit<EventResponse<CatalogResponse>, 'askForInput'>) => void;\n\n  /**\n   * This event is emitted when the client requests for an addon to check for updates. Addon should resolve the event with the update information.\n   * @param data\n   * @param event\n   * @returns\n   */\n  'check-for-updates': (\n    data: { appID: number; storefront: string; currentVersion: string },\n    event: EventResponse<\n      | {\n          available: true;\n          version: string;\n        }\n      | {\n          available: false;\n        }\n    >\n  ) => void;\n\n  /**\n   * This event is emitted when the client is going to launch an app. Addon should use this to perform any pre or post launch tasks.\n   * @param data {LibraryInfo} The library information for the app to be launched.\n   * @param launchType { 'pre' | 'post' } The type of launch task to perform.\n   * @param event {EventResponse<void>} The event response from the server.\n   */\n  'launch-app': (\n    data: { libraryInfo: LibraryInfo; launchType: 'pre' | 'post' },\n    event: EventResponse<void>\n  ) => void;\n}\n\nexport interface StoreData {\n  name: string;\n  publishers: string[];\n  developers: string[];\n  appID: number;\n  releaseDate: string;\n  capsuleImage: string;\n  coverImage: string;\n  basicDescription: string;\n  description: string;\n  headerImage: string;\n  latestVersion: string;\n}\nexport interface WebsocketMessageClient {\n  event: OGIAddonClientSentEvent;\n  id?: string;\n  args: any;\n  statusError?: string;\n}\nexport interface WebsocketMessageServer {\n  event: OGIAddonServerSentEvent;\n  id?: string;\n  args: any;\n  statusError?: string;\n}\n\n/**\n * The configuration for the addon. This is used to identify the addon and provide information about it.\n * Storefronts is an array of names of stores that the addon supports.\n */\nexport interface OGIAddonConfiguration {\n  name: string;\n  id: string;\n  description: string;\n  version: string;\n\n  author: string;\n  repository: string;\n  storefronts: string[];\n}\n\n/**\n * The main class for the OGI Addon. This class is used to interact with the OGI Addon Server. The OGI Addon Server provides a `--addonSecret` to the addon so it can securely connect.\n * @example\n * ```typescript\n * const addon = new OGIAddon({\n *  name: 'Test Addon',\n *   id: 'test-addon',\n *  description: 'A test addon',\n *  version: '1.0.0',\n *  author: 'OGI Developers',\n *  repository: ''\n * });\n * ```\n *\n */\nexport default class OGIAddon {\n  public eventEmitter = new events.EventEmitter();\n  public addonWSListener: OGIAddonWSListener;\n  public addonInfo: OGIAddonConfiguration;\n  public config: Configuration = new Configuration({});\n  private eventsAvailable: OGIAddonEvent[] = [];\n  private registeredConnectEvent: boolean = false;\n  private taskHandlers: Map<\n    string,\n    (\n      task: Task,\n      data: {\n        manifest: Record<string, unknown>;\n        downloadPath: string;\n        name: string;\n        libraryInfo: LibraryInfo;\n      }\n    ) => Promise<void> | void\n  > = new Map();\n\n  constructor(addonInfo: OGIAddonConfiguration) {\n    this.addonInfo = addonInfo;\n    this.addonWSListener = new OGIAddonWSListener(this, this.eventEmitter);\n  }\n\n  /**\n   * Register an event listener for the addon. (See EventListenerTypes)\n   * @param event {OGIAddonEvent}\n   * @param listener {EventListenerTypes[OGIAddonEvent]}\n   */\n  public on<T extends OGIAddonEvent>(\n    event: T,\n    listener: EventListenerTypes[T]\n  ) {\n    this.eventEmitter.on(event, listener);\n    this.eventsAvailable.push(event);\n    // wait for the addon to be connected\n    if (!this.registeredConnectEvent) {\n      this.addonWSListener.eventEmitter.once('connect', () => {\n        this.addonWSListener.send('flag', {\n          flag: 'events-available',\n          value: this.eventsAvailable,\n        });\n      });\n      this.registeredConnectEvent = true;\n    }\n  }\n\n  public emit<T extends OGIAddonEvent>(\n    event: T,\n    ...args: Parameters<EventListenerTypes[T]>\n  ) {\n    this.eventEmitter.emit(event, ...args);\n  }\n\n  /**\n   * Notify the client using a notification. Provide the type of notification, the message, and an ID.\n   * @param notification {Notification}\n   */\n  public notify(notification: Notification) {\n    this.addonWSListener.send('notification', [notification]);\n  }\n\n  /**\n   * Get the app details for a given appID and storefront.\n   * @param appID {number}\n   * @param storefront {string}\n   * @returns {Promise<StoreData>}\n   */\n  public async getAppDetails(appID: number, storefront: string) {\n    const id = this.addonWSListener.send('get-app-details', {\n      appID,\n      storefront,\n    });\n    return await this.addonWSListener.waitForResponseFromServer<\n      StoreData | undefined\n    >(id);\n  }\n\n  public async searchGame(query: string, storefront: string) {\n    const id = this.addonWSListener.send('search-app-name', {\n      query,\n      storefront,\n    });\n    return await this.addonWSListener.waitForResponseFromServer<\n      BasicLibraryInfo[]\n    >(id);\n  }\n\n  /**\n   * Notify the OGI Addon Server that you are performing a background task. This can be used to help users understand what is happening in the background.\n   * @returns {Promise<Task>} A Task instance for managing the background task.\n   */\n  public async task(): Promise<Task> {\n    const id = Math.random().toString(36).substring(7);\n    const progress = 0;\n    const logs: string[] = [];\n    const task = new Task(this.addonWSListener, id, progress, logs);\n    this.addonWSListener.send('task-update', {\n      id,\n      progress,\n      logs,\n      finished: false,\n      failed: undefined,\n    });\n    return task;\n  }\n\n  /**\n   * Register a task handler for a specific task name. The task name should match the taskName field in SearchResult or ActionOption.\n   * @param taskName {string} The name of the task (should match taskName in SearchResult or ActionOption.setTaskName()).\n   * @param handler {(task: Task, data: { manifest: Record<string, unknown>; downloadPath: string; name: string; libraryInfo: LibraryInfo }) => Promise<void> | void} The handler function.\n   * @example\n   * ```typescript\n   * addon.onTask('clearCache', async (task) => {\n   *   task.log('Clearing cache...');\n   *   task.setProgress(50);\n   *   await clearCacheFiles();\n   *   task.setProgress(100);\n   *   task.complete();\n   * });\n   * ```\n   */\n  public onTask(\n    taskName: string,\n    handler: (\n      task: Task,\n      data: {\n        manifest: Record<string, unknown>;\n        downloadPath: string;\n        name: string;\n        libraryInfo: LibraryInfo;\n      }\n    ) => Promise<void> | void\n  ): void {\n    this.taskHandlers.set(taskName, handler);\n  }\n\n  /**\n   * Check if a task handler is registered for the given task name.\n   * @param taskName {string} The task name to check.\n   * @returns {boolean} True if a handler is registered.\n   */\n  public hasTaskHandler(taskName: string): boolean {\n    return this.taskHandlers.has(taskName);\n  }\n\n  /**\n   * Get a task handler for the given task name.\n   * @param taskName {string} The task name.\n   * @returns The handler function or undefined if not found.\n   */\n  public getTaskHandler(taskName: string):\n    | ((\n        task: Task,\n        data: {\n          manifest: Record<string, unknown>;\n          downloadPath: string;\n          name: string;\n          libraryInfo?: LibraryInfo;\n        }\n      ) => Promise<void> | void)\n    | undefined {\n    return this.taskHandlers.get(taskName);\n  }\n\n  /**\n   * Extract a file using 7-Zip on Windows, unzip on Linux/Mac.\n   * @param path {string}\n   * @param outputPath {string}\n   * @param type {'unrar' | 'unzip'}\n   * @returns {Promise<void>}\n   */\n  public async extractFile(\n    path: string,\n    outputPath: string,\n    type: 'unrar' | 'unzip'\n  ) {\n    return new Promise<void>((resolve, reject) => {\n      // Ensure outputPath exists\n      if (!fs.existsSync(outputPath)) {\n        fs.mkdirSync(outputPath, { recursive: true });\n      }\n\n      if (type === 'unzip') {\n        // Prefer 7-Zip on Windows, unzip on Linux/Mac\n        if (process.platform === 'win32') {\n          // 7-Zip path (default install location)\n          const s7ZipPath = '\"C:\\\\Program Files\\\\7-Zip\\\\7z.exe\"';\n          exec(\n            `${s7ZipPath} x \"${path}\" -o\"${outputPath}\"`,\n            (err: any, stdout: any, stderr: any) => {\n              if (err) {\n                console.error(err);\n                console.log(stderr);\n                reject(new Error('Failed to extract ZIP file'));\n                return;\n              }\n              console.log(stdout);\n              console.log(stderr);\n              resolve();\n            }\n          );\n        } else {\n          // Use unzip on Linux/Mac\n          const unzipProcess = spawn(\n            'unzip',\n            [\n              '-o', // overwrite files without prompting\n              path,\n              '-d', // specify output directory\n              outputPath,\n            ],\n            {\n              env: {\n                ...process.env,\n                UNZIP_DISABLE_ZIPBOMB_DETECTION: 'TRUE',\n              },\n            }\n          );\n\n          unzipProcess.stdout.on('data', (data: Buffer) => {\n            console.log(`[unzip stdout]: ${data}`);\n          });\n\n          unzipProcess.stderr.on('data', (data: Buffer) => {\n            console.error(`[unzip stderr]: ${data}`);\n          });\n\n          unzipProcess.on('close', (code: number) => {\n            if (code !== 0) {\n              console.error(`unzip process exited with code ${code}`);\n              reject(new Error('Failed to extract ZIP file'));\n              return;\n            }\n            resolve();\n          });\n        }\n      } else if (type === 'unrar') {\n        if (process.platform === 'win32') {\n          // 7-Zip path (default install location)\n          const s7ZipPath = '\"C:\\\\Program Files\\\\7-Zip\\\\7z.exe\"';\n          exec(\n            `${s7ZipPath} x \"${path}\" -o\"${outputPath}\"`,\n            (err: any, stdout: any, stderr: any) => {\n              if (err) {\n                console.error(err);\n                console.log(stderr);\n                reject(new Error('Failed to extract RAR file'));\n                return;\n              }\n              console.log(stdout);\n              console.log(stderr);\n              resolve();\n            }\n          );\n        } else {\n          // Use unrar on Linux/Mac\n          const unrarProcess = spawn('unrar', ['x', '-y', path, outputPath]);\n\n          unrarProcess.stdout.on('data', (data: Buffer) => {\n            console.log(`[unrar stdout]: ${data}`);\n          });\n\n          unrarProcess.stderr.on('data', (data: Buffer) => {\n            console.error(`[unrar stderr]: ${data}`);\n          });\n\n          unrarProcess.on('close', (code: number) => {\n            if (code !== 0) {\n              console.error(`unrar process exited with code ${code}`);\n              reject(new Error('Failed to extract RAR file'));\n              return;\n            }\n            resolve();\n          });\n        }\n      } else {\n        reject(new Error('Unknown extraction type'));\n      }\n    });\n  }\n}\n\n/**\n * A unified task API for both server-initiated tasks (via onTask handlers)\n * and addon-initiated background tasks (via addon.task()).\n * Provides chainable methods for logging, progress updates, and completion.\n */\nexport class Task {\n  // EventResponse-based mode (for onTask handlers)\n  private event: EventResponse<void> | undefined;\n\n  // WebSocket-based mode (for addon.task())\n  private ws: OGIAddonWSListener | undefined;\n  private readonly id: string | undefined;\n  private progress: number = 0;\n  private logs: string[] = [];\n  private finished: boolean = false;\n  private failed: string | undefined = undefined;\n\n  /**\n   * Construct a Task from an EventResponse (for onTask handlers).\n   * @param event {EventResponse<void>} The event response to wrap.\n   */\n  constructor(event: EventResponse<void>);\n\n  /**\n   * Construct a Task from WebSocket listener (for addon.task()).\n   * @param ws {OGIAddonWSListener} The WebSocket listener.\n   * @param id {string} The task ID.\n   * @param progress {number} Initial progress (0-100).\n   * @param logs {string[]} Initial logs array.\n   */\n  constructor(\n    ws: OGIAddonWSListener,\n    id: string,\n    progress: number,\n    logs: string[]\n  );\n\n  constructor(\n    eventOrWs: EventResponse<void> | OGIAddonWSListener,\n    id?: string,\n    progress?: number,\n    logs?: string[]\n  ) {\n    if (eventOrWs instanceof EventResponse) {\n      // EventResponse-based mode\n      this.event = eventOrWs;\n      this.event.defer();\n    } else {\n      // WebSocket-based mode\n      this.ws = eventOrWs;\n      this.id = id!;\n      this.progress = progress ?? 0;\n      this.logs = logs ?? [];\n    }\n  }\n\n  /**\n   * Log a message to the task. Returns this for chaining.\n   * @param message {string} The message to log.\n   */\n  log(message: string): this {\n    if (this.event) {\n      this.event.log(message);\n    } else {\n      this.logs.push(message);\n      this.update();\n    }\n    return this;\n  }\n\n  /**\n   * Set the progress of the task (0-100). Returns this for chaining.\n   * @param progress {number} The progress value (0-100).\n   */\n  setProgress(progress: number): this {\n    if (this.event) {\n      this.event.progress = progress;\n    } else {\n      this.progress = progress;\n      this.update();\n    }\n    return this;\n  }\n\n  /**\n   * Complete the task successfully.\n   */\n  complete(): void {\n    if (this.event) {\n      this.event.complete();\n    } else {\n      this.finished = true;\n      this.update();\n    }\n  }\n\n  /**\n   * Fail the task with an error message.\n   * @param message {string} The error message.\n   */\n  fail(message: string): void {\n    if (this.event) {\n      this.event.fail(message);\n    } else {\n      this.failed = message;\n      this.update();\n    }\n  }\n\n  /**\n   * Ask the user for input using a ConfigurationBuilder screen.\n   * Only available for EventResponse-based tasks (onTask handlers).\n   * The return type is inferred from the ConfigurationBuilder's accumulated option types.\n   * @param name {string} The name/title of the input prompt.\n   * @param description {string} The description of what input is needed.\n   * @param screen {ConfigurationBuilder<U>} The configuration builder for the input form.\n   * @returns {Promise<U>} The user's input with types matching the configuration options.\n   * @throws {Error} If called on a WebSocket-based task.\n   */\n  async askForInput<U extends Record<string, string | number | boolean>>(\n    name: string,\n    description: string,\n    screen: ConfigurationBuilder<U>\n  ): Promise<U> {\n    if (!this.event) {\n      throw new Error(\n        'askForInput() is only available for EventResponse-based tasks (onTask handlers)'\n      );\n    }\n    return this.event.askForInput(name, description, screen);\n  }\n\n  /**\n   * Update the task state (for WebSocket-based tasks only).\n   * Called automatically when using log(), setProgress(), complete(), or fail().\n   */\n  private update(): void {\n    if (this.ws && this.id !== undefined) {\n      this.ws.send('task-update', {\n        id: this.id,\n        progress: this.progress,\n        logs: this.logs,\n        finished: this.finished,\n        failed: this.failed,\n      });\n    }\n  }\n}\n/**\n * A search tool wrapper over Fuse.js for the OGI Addon. This tool is used to search for items in the library.\n * @example\n * ```typescript\n * const searchTool = new SearchTool<LibraryInfo>([{ name: 'test', appID: 123 }, { name: 'test2', appID: 124 }], ['name']);\n * const results = searchTool.search('test', 10);\n * ```\n */\nexport class SearchTool<T> {\n  private fuse: Fuse<T>;\n  constructor(\n    items: T[],\n    keys: string[],\n    options: Omit<IFuseOptions<T>, 'keys'> = {\n      threshold: 0.3,\n      includeScore: true,\n    }\n  ) {\n    this.fuse = new Fuse(items, {\n      keys,\n      ...options,\n    });\n  }\n  public search(query: string, limit: number = 10): T[] {\n    return this.fuse\n      .search(query)\n      .slice(0, limit)\n      .map((result) => result.item);\n  }\n  public addItems(items: T[]) {\n    items.map((item) => this.fuse.add(item));\n  }\n}\n/**\n * Library Info is the metadata for a library entry after setting up a game.\n */\nexport const ZodLibraryInfo = z.object({\n  name: z.string(),\n  version: z.string(),\n  cwd: z.string(),\n  appID: z.number(),\n  launchExecutable: z.string(),\n  launchArguments: z.string().optional(),\n  capsuleImage: z.string(),\n  storefront: z.string(),\n  addonsource: z.string(),\n  coverImage: z.string(),\n  titleImage: z.string().optional(),\n});\nexport type LibraryInfo = z.infer<typeof ZodLibraryInfo>;\ninterface Notification {\n  type: 'warning' | 'error' | 'info' | 'success';\n  message: string;\n  id: string;\n}\nclass OGIAddonWSListener {\n  private socket: WebSocket;\n  public eventEmitter: events.EventEmitter;\n  public addon: OGIAddon;\n\n  constructor(ogiAddon: OGIAddon, eventEmitter: events.EventEmitter) {\n    if (\n      process.argv[process.argv.length - 1].split('=')[0] !== '--addonSecret'\n    ) {\n      throw new Error(\n        'No secret provided. This usually happens because the addon was not started by the OGI Addon Server.'\n      );\n    }\n    this.addon = ogiAddon;\n    this.eventEmitter = eventEmitter;\n    this.socket = new ws('ws://localhost:' + defaultPort);\n    this.socket.on('open', () => {\n      console.log('Connected to OGI Addon Server');\n      console.log('OGI Addon Server Version:', VERSION);\n\n      // Authenticate with OGI Addon Server\n      this.send('authenticate', {\n        ...this.addon.addonInfo,\n        secret: process.argv[process.argv.length - 1].split('=')[1],\n        ogiVersion: VERSION,\n      });\n\n      // send a configuration request\n      let configBuilder = new ConfigurationBuilder();\n      this.eventEmitter.emit('configure', configBuilder);\n      this.send('configure', configBuilder.build(false));\n      this.addon.config = new Configuration(configBuilder.build(true));\n\n      // wait for the config-update to be received then send connect\n      const configListener = (event: ws.MessageEvent) => {\n        if (event === undefined) return;\n        // event can be a Buffer, string, ArrayBuffer, or Buffer[]\n        let data: string;\n        if (typeof event === 'string') {\n          data = event;\n        } else if (event instanceof Buffer) {\n          data = event.toString();\n        } else if (event && typeof (event as any).data === 'string') {\n          data = (event as any).data;\n        } else if (event && (event as any).data instanceof Buffer) {\n          data = (event as any).data.toString();\n        } else {\n          // fallback for other types\n          data = event.toString();\n        }\n        const message: WebsocketMessageServer = JSON.parse(data);\n        if (message.event === 'config-update') {\n          console.log('Config update received');\n          this.socket.off('message', configListener);\n          this.eventEmitter.emit(\n            'connect',\n            new EventResponse<void>((screen, name, description) => {\n              return this.userInputAsked(\n                screen,\n                name,\n                description,\n                this.socket\n              );\n            })\n          );\n        }\n      };\n      this.socket.on('message', configListener);\n    });\n\n    this.socket.on('error', (error) => {\n      if (error.message.includes('Failed to connect')) {\n        throw new Error(\n          'OGI Addon Server is not running/is unreachable. Please start the server and try again.'\n        );\n      }\n      console.error('An error occurred:', error);\n    });\n\n    this.socket.on('close', (code, reason) => {\n      if (code === 1008) {\n        console.error('Authentication failed:', reason);\n        return;\n      }\n      this.eventEmitter.emit('disconnect', reason);\n      console.log('Disconnected from OGI Addon Server');\n      console.error(reason.toString());\n      this.eventEmitter.emit('exit');\n      this.socket.close();\n    });\n\n    this.registerMessageReceiver();\n  }\n\n  private async userInputAsked<\n    U extends Record<string, string | number | boolean>,\n  >(\n    configBuilt: ConfigurationBuilder<U>,\n    name: string,\n    description: string,\n    socket: WebSocket\n  ): Promise<U> {\n    const config = configBuilt.build(false);\n    const id = Math.random().toString(36).substring(7);\n    if (!socket) {\n      throw new Error('Socket is not connected');\n    }\n    socket.send(\n      JSON.stringify({\n        event: 'input-asked',\n        args: {\n          config,\n          name,\n          description,\n        },\n        id: id,\n      })\n    );\n    return await this.waitForResponseFromServer<U>(id);\n  }\n\n  /**\n   * Registers the message receiver for the socket. This is used to receive messages from the server and handle them.\n   */\n  private registerMessageReceiver() {\n    this.socket.on('message', async (data: string) => {\n      const message: WebsocketMessageServer = JSON.parse(data);\n      switch (message.event) {\n        case 'config-update':\n          const result = this.addon.config.updateConfig(message.args);\n          if (!result[0]) {\n            this.respondToMessage(\n              message.id!!,\n              {\n                success: false,\n                error: result[1],\n              },\n              undefined\n            );\n          } else {\n            this.respondToMessage(message.id!!, { success: true }, undefined);\n          }\n          break;\n        case 'search':\n          await this.handleEventWithResponse<SearchResult[]>(message, (event) =>\n            this.eventEmitter.emit('search', message.args, event)\n          );\n          break;\n        case 'setup': {\n          let setupEvent = new EventResponse<SetupEventResponse>(\n            (screen, name, description) =>\n              this.userInputAsked(screen, name, description, this.socket)\n          );\n          this.eventEmitter.emit('setup', message.args, setupEvent);\n          const interval = setInterval(() => {\n            if (setupEvent.resolved) {\n              clearInterval(interval);\n              return;\n            }\n            this.send('defer-update', {\n              logs: setupEvent.logs,\n              deferID: message.args.deferID,\n              progress: setupEvent.progress,\n              failed: setupEvent.failed,\n            } as ClientSentEventTypes['defer-update']);\n          }, 100);\n          const setupResult = await this.waitForEventToRespond(setupEvent);\n          this.respondToMessage(message.id!!, setupResult.data, setupEvent);\n          break;\n        }\n        case 'library-search':\n          await this.handleEventWithResponse<BasicLibraryInfo[]>(\n            message,\n            (event) =>\n              this.eventEmitter.emit('library-search', message.args, event)\n          );\n          break;\n        case 'game-details':\n          await this.handleEventWithResponse<StoreData | undefined>(\n            message,\n            (event) =>\n              this.eventEmitter.emit('game-details', message.args, event),\n            {\n              requireListener: 'game-details',\n              noListenerError: 'No event listener for game-details',\n            }\n          );\n          break;\n        case 'check-for-updates':\n          await this.handleEventWithResponse<\n            { available: true; version: string } | { available: false }\n          >(message, (event) =>\n            this.eventEmitter.emit('check-for-updates', message.args, event)\n          );\n          break;\n        case 'request-dl':\n          let requestDLEvent = new EventResponse<SearchResult>(\n            (screen, name, description) =>\n              this.userInputAsked(screen, name, description, this.socket)\n          );\n          if (this.eventEmitter.listenerCount('request-dl') === 0) {\n            this.respondToMessage(\n              message.id!!,\n              {\n                error: 'No event listener for request-dl',\n              },\n              requestDLEvent\n            );\n            break;\n          }\n          this.eventEmitter.emit(\n            'request-dl',\n            message.args.appID,\n            message.args.info,\n            requestDLEvent\n          );\n          const requestDLResult =\n            await this.waitForEventToRespond(requestDLEvent);\n          if (requestDLEvent.failed) {\n            this.respondToMessage(message.id!!, undefined, requestDLEvent);\n            break;\n          }\n          if (\n            requestDLEvent.data === undefined ||\n            requestDLEvent.data?.downloadType === 'request'\n          ) {\n            throw new Error(\n              'Request DL event did not return a valid result. Please ensure that the event does not resolve with another `request` download type.'\n            );\n          }\n          this.respondToMessage(\n            message.id!!,\n            requestDLResult.data,\n            requestDLEvent\n          );\n          break;\n        case 'catalog':\n          await this.handleEventWithResponseNoInput<CatalogResponse>(\n            message,\n            (event) => this.eventEmitter.emit('catalog', event)\n          );\n          break;\n        case 'task-run': {\n          let taskRunEvent = new EventResponse<void>(\n            (screen, name, description) =>\n              this.userInputAsked(screen, name, description, this.socket)\n          );\n\n          // Check for taskName: first from args directly (from SearchResult), then from manifest.__taskName (for ActionOption)\n          const taskName =\n            message.args.taskName && typeof message.args.taskName === 'string'\n              ? message.args.taskName\n              : message.args.manifest &&\n                  typeof message.args.manifest === 'object'\n                ? (message.args.manifest as Record<string, unknown>).__taskName\n                : undefined;\n\n          if (\n            taskName &&\n            typeof taskName === 'string' &&\n            this.addon.hasTaskHandler(taskName)\n          ) {\n            // Use the registered task handler\n            const handler = this.addon.getTaskHandler(taskName)!;\n            const task = new Task(taskRunEvent);\n            try {\n              const interval = setInterval(() => {\n                if (taskRunEvent.resolved) {\n                  clearInterval(interval);\n                  return;\n                }\n                this.send('defer-update', {\n                  logs: taskRunEvent.logs,\n                  deferID: message.args.deferID,\n                  progress: taskRunEvent.progress,\n                  failed: taskRunEvent.failed,\n                } as ClientSentEventTypes['defer-update']);\n              }, 100);\n              const result = handler(task, {\n                manifest: message.args.manifest || {},\n                downloadPath: message.args.downloadPath || '',\n                name: message.args.name || '',\n                libraryInfo: message.args.libraryInfo,\n              });\n              // If handler returns a promise, wait for it\n              if (result instanceof Promise) {\n                await result;\n              }\n\n              clearInterval(interval);\n            } catch (error) {\n              taskRunEvent.fail(\n                error instanceof Error ? error.message : String(error)\n              );\n            }\n          } else {\n            // No handler found - fail the task\n            taskRunEvent.fail(\n              taskName\n                ? `No task handler registered for task name: ${taskName}`\n                : 'No task name provided'\n            );\n          }\n\n          const taskRunResult = await this.waitForEventToRespond(taskRunEvent);\n          this.respondToMessage(message.id!!, taskRunResult.data, taskRunEvent);\n          break;\n        }\n        case 'launch-app':\n          await this.handleEventWithResponse<void>(message, (event) =>\n            this.eventEmitter.emit('launch-app', message.args, event)\n          );\n          break;\n      }\n    });\n  }\n\n  private waitForEventToRespond<T>(\n    event: EventResponse<T>\n  ): Promise<EventResponse<T>> {\n    // check the handlers to see if there even is any\n    return new Promise((resolve, reject) => {\n      const dataGet = setInterval(() => {\n        if (event.resolved) {\n          resolve(event);\n          clearTimeout(timeout);\n        }\n      }, 5);\n\n      const timeout = setTimeout(() => {\n        if (event.deffered) {\n          clearInterval(dataGet);\n          const interval = setInterval(() => {\n            if (event.resolved) {\n              clearInterval(interval);\n              resolve(event);\n            }\n          }, 100);\n        } else {\n          reject('Event did not respond in time');\n        }\n      }, 5000);\n    });\n  }\n\n  /**\n   * Common flow for events that use EventResponse with userInputAsked: create event, emit via callback, wait, respond.\n   * If options.requireListener is set and that event has no listeners, responds with options.noListenerError and returns.\n   */\n  private async handleEventWithResponse<T>(\n    message: WebsocketMessageServer,\n    emit: (event: EventResponse<T>) => void,\n    options?: { requireListener: string; noListenerError: string }\n  ): Promise<void> {\n    const event = new EventResponse<T>((screen, name, description) =>\n      this.userInputAsked(screen, name, description, this.socket)\n    );\n    if (\n      options &&\n      this.eventEmitter.listenerCount(options.requireListener) === 0\n    ) {\n      this.respondToMessage(\n        message.id!!,\n        { error: options.noListenerError },\n        event\n      );\n      return;\n    }\n    emit(event);\n    const result = await this.waitForEventToRespond(event);\n    this.respondToMessage(message.id!!, result.data, event);\n  }\n\n  /**\n   * Same as handleEventWithResponse but for events that don't need userInputAsked (e.g. catalog).\n   */\n  private async handleEventWithResponseNoInput<T>(\n    message: WebsocketMessageServer,\n    emit: (event: EventResponse<T>) => void\n  ): Promise<void> {\n    const event = new EventResponse<T>();\n    emit(event);\n    const result = await this.waitForEventToRespond(event);\n    this.respondToMessage(message.id!!, result.data, event);\n  }\n\n  public respondToMessage(\n    messageID: string,\n    response: any,\n    originalEvent: EventResponse<any> | undefined\n  ) {\n    this.socket.send(\n      JSON.stringify({\n        event: 'response',\n        id: messageID,\n        args: response,\n        statusError: originalEvent ? originalEvent.failed : undefined,\n      })\n    );\n    console.log('dispatched response to ' + messageID);\n  }\n\n  public waitForResponseFromServer<T>(messageID: string): Promise<T> {\n    return new Promise((resolve) => {\n      const waiter = (data: string) => {\n        const message: WebsocketMessageClient = JSON.parse(data);\n        if (message.event !== 'response') {\n          this.socket.once('message', waiter);\n          return;\n        }\n        console.log('received response from ' + messageID);\n\n        if (message.id === messageID) {\n          resolve(message.args);\n        } else {\n          this.socket.once('message', waiter);\n        }\n      };\n      this.socket.once('message', waiter);\n    });\n  }\n\n  public send(\n    event: OGIAddonClientSentEvent,\n    args: ClientSentEventTypes[OGIAddonClientSentEvent]\n  ): string {\n    // generate a random id\n    const id = Math.random().toString(36).substring(7);\n    this.socket.send(\n      JSON.stringify({\n        event,\n        args,\n        id,\n      })\n    );\n    return id;\n  }\n\n  public close() {\n    this.socket.close();\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -3,7 +3,7 @@
   "module": "./build/main.mjs",
   "type": "module",
   "main": "./build/main.cjs",
-  "version": "2.3.0",
+  "version": "2.3.2",
   "exports": {
     ".": {
       "import": {

package/src/SearchEngine.ts

@@ -1,6 +1,12 @@
 type BaseRequiredFields = {
   name: string;
   manifest?: Record<string, any>;
+  /**
+   * Update-only hint for OGI's setup stage.
+   * When false, OGI keeps existing files in place instead of moving them to `old_files`
+   * before running update setup. Defaults to true/undefined behavior.
+   */
+  clearOldFilesBeforeUpdate?: boolean;
 };
 
 export type SearchResult = BaseRequiredFields &

package/src/main.ts

@@ -7,6 +7,9 @@ import EventResponse from './EventResponse';
 import type { SearchResult } from './SearchEngine';
 import Fuse, { IFuseOptions } from 'fuse.js';
 
+/**
+ * Exposed events that the programmer can use to listen to and emit events.
+ */
 export type OGIAddonEvent =
   | 'connect'
   | 'disconnect'
@@ -19,8 +22,12 @@ export type OGIAddonEvent =
   | 'exit'
   | 'check-for-updates'
   | 'request-dl'
-  | 'catalog';
+  | 'catalog'
+  | 'launch-app';
 
+/**
+ * The events that the client can send to the server and are handled by the server.
+ */
 export type OGIAddonClientSentEvent =
   | 'response'
   | 'authenticate'
@@ -33,10 +40,15 @@ export type OGIAddonClientSentEvent =
   | 'flag'
   | 'task-update';
 
+/**
+ * The events that the server sends to the client
+ * This is the events that the server can send to the client and are handled by the client.
+ */
 export type OGIAddonServerSentEvent =
   | 'authenticate'
   | 'configure'
   | 'config-update'
+  | 'launch-app'
   | 'search'
   | 'setup'
   | 'response'
@@ -122,7 +134,9 @@ export interface CatalogWithCarousel {
   carousel?: Record<string, CatalogCarouselItem> | CatalogCarouselItem[];
 }
 
-export type CatalogResponse = Record<string, CatalogSection> | CatalogWithCarousel;
+export type CatalogResponse =
+  | Record<string, CatalogSection>
+  | CatalogWithCarousel;
 
 export type SetupEventResponse = Omit<
   LibraryInfo,
@@ -206,6 +220,7 @@ export interface EventListenerTypes {
       type: 'direct' | 'torrent' | 'magnet' | 'empty';
       name: string;
       usedRealDebrid: boolean;
+      clearOldFilesBeforeUpdate?: boolean;
       multiPartFiles?: {
         name: string;
         downloadURL: string;
@@ -271,12 +286,7 @@ export interface EventListenerTypes {
    * @param event
    * @returns
    */
-  catalog: (
-    event: Omit<
-      EventResponse<CatalogResponse>,
-      'askForInput'
-    >
-  ) => void;
+  catalog: (event: Omit<EventResponse<CatalogResponse>, 'askForInput'>) => void;
 
   /**
    * This event is emitted when the client requests for an addon to check for updates. Addon should resolve the event with the update information.
@@ -296,6 +306,17 @@ export interface EventListenerTypes {
         }
     >
   ) => void;
+
+  /**
+   * This event is emitted when the client is going to launch an app. Addon should use this to perform any pre or post launch tasks.
+   * @param data {LibraryInfo} The library information for the app to be launched.
+   * @param launchType { 'pre' | 'post' } The type of launch task to perform.
+   * @param event {EventResponse<void>} The event response from the server.
+   */
+  'launch-app': (
+    data: { libraryInfo: LibraryInfo; launchType: 'pre' | 'post' },
+    event: EventResponse<void>
+  ) => void;
 }
 
 export interface StoreData {
@@ -962,6 +983,9 @@ class OGIAddonWSListener {
     return await this.waitForResponseFromServer<U>(id);
   }
 
+  /**
+   * Registers the message receiver for the socket. This is used to receive messages from the server and handle them.
+   */
   private registerMessageReceiver() {
     this.socket.on('message', async (data: string) => {
       const message: WebsocketMessageServer = JSON.parse(data);
@@ -982,17 +1006,8 @@ class OGIAddonWSListener {
           }
           break;
         case 'search':
-          let searchResultEvent = new EventResponse<SearchResult[]>(
-            (screen, name, description) =>
-              this.userInputAsked(screen, name, description, this.socket)
-          );
-          this.eventEmitter.emit('search', message.args, searchResultEvent);
-          const searchResult =
-            await this.waitForEventToRespond(searchResultEvent);
-          this.respondToMessage(
-            message.id!!,
-            searchResult.data,
-            searchResultEvent
+          await this.handleEventWithResponse<SearchResult[]>(message, (event) =>
+            this.eventEmitter.emit('search', message.args, event)
           );
           break;
         case 'setup': {
@@ -1018,74 +1033,28 @@ class OGIAddonWSListener {
           break;
         }
         case 'library-search':
-          let librarySearchEvent = new EventResponse<BasicLibraryInfo[]>(
-            (screen, name, description) =>
-              this.userInputAsked(screen, name, description, this.socket)
-          );
-          this.eventEmitter.emit(
-            'library-search',
-            message.args,
-            librarySearchEvent
-          );
-          const librarySearchResult =
-            await this.waitForEventToRespond(librarySearchEvent);
-          this.respondToMessage(
-            message.id!!,
-            librarySearchResult.data,
-            librarySearchEvent
+          await this.handleEventWithResponse<BasicLibraryInfo[]>(
+            message,
+            (event) =>
+              this.eventEmitter.emit('library-search', message.args, event)
           );
           break;
         case 'game-details':
-          let gameDetailsEvent = new EventResponse<StoreData | undefined>(
-            (screen, name, description) =>
-              this.userInputAsked(screen, name, description, this.socket)
-          );
-          if (this.eventEmitter.listenerCount('game-details') === 0) {
-            this.respondToMessage(
-              message.id!!,
-              {
-                error: 'No event listener for game-details',
-              },
-              gameDetailsEvent
-            );
-            break;
-          }
-          this.eventEmitter.emit(
-            'game-details',
-            message.args,
-            gameDetailsEvent
-          );
-          const gameDetailsResult =
-            await this.waitForEventToRespond(gameDetailsEvent);
-          this.respondToMessage(
-            message.id!!,
-            gameDetailsResult.data,
-            gameDetailsEvent
+          await this.handleEventWithResponse<StoreData | undefined>(
+            message,
+            (event) =>
+              this.eventEmitter.emit('game-details', message.args, event),
+            {
+              requireListener: 'game-details',
+              noListenerError: 'No event listener for game-details',
+            }
           );
           break;
         case 'check-for-updates':
-          let checkForUpdatesEvent = new EventResponse<
-            | {
-                available: true;
-                version: string;
-              }
-            | {
-                available: false;
-              }
-          >((screen, name, description) =>
-            this.userInputAsked(screen, name, description, this.socket)
-          );
-          this.eventEmitter.emit(
-            'check-for-updates',
-            message.args,
-            checkForUpdatesEvent
-          );
-          const checkForUpdatesResult =
-            await this.waitForEventToRespond(checkForUpdatesEvent);
-          this.respondToMessage(
-            message.id!!,
-            checkForUpdatesResult.data,
-            checkForUpdatesEvent
+          await this.handleEventWithResponse<
+            { available: true; version: string } | { available: false }
+          >(message, (event) =>
+            this.eventEmitter.emit('check-for-updates', message.args, event)
           );
           break;
         case 'request-dl':
@@ -1130,10 +1099,10 @@ class OGIAddonWSListener {
           );
           break;
         case 'catalog':
-          let catalogEvent = new EventResponse<CatalogResponse>();
-          this.eventEmitter.emit('catalog', catalogEvent);
-          const catalogResult = await this.waitForEventToRespond(catalogEvent);
-          this.respondToMessage(message.id!!, catalogResult.data, catalogEvent);
+          await this.handleEventWithResponseNoInput<CatalogResponse>(
+            message,
+            (event) => this.eventEmitter.emit('catalog', event)
+          );
           break;
         case 'task-run': {
           let taskRunEvent = new EventResponse<void>(
@@ -1201,6 +1170,11 @@ class OGIAddonWSListener {
           this.respondToMessage(message.id!!, taskRunResult.data, taskRunEvent);
           break;
         }
+        case 'launch-app':
+          await this.handleEventWithResponse<void>(message, (event) =>
+            this.eventEmitter.emit('launch-app', message.args, event)
+          );
+          break;
       }
     });
   }
@@ -1233,6 +1207,47 @@ class OGIAddonWSListener {
     });
   }
 
+  /**
+   * Common flow for events that use EventResponse with userInputAsked: create event, emit via callback, wait, respond.
+   * If options.requireListener is set and that event has no listeners, responds with options.noListenerError and returns.
+   */
+  private async handleEventWithResponse<T>(
+    message: WebsocketMessageServer,
+    emit: (event: EventResponse<T>) => void,
+    options?: { requireListener: string; noListenerError: string }
+  ): Promise<void> {
+    const event = new EventResponse<T>((screen, name, description) =>
+      this.userInputAsked(screen, name, description, this.socket)
+    );
+    if (
+      options &&
+      this.eventEmitter.listenerCount(options.requireListener) === 0
+    ) {
+      this.respondToMessage(
+        message.id!!,
+        { error: options.noListenerError },
+        event
+      );
+      return;
+    }
+    emit(event);
+    const result = await this.waitForEventToRespond(event);
+    this.respondToMessage(message.id!!, result.data, event);
+  }
+
+  /**
+   * Same as handleEventWithResponse but for events that don't need userInputAsked (e.g. catalog).
+   */
+  private async handleEventWithResponseNoInput<T>(
+    message: WebsocketMessageServer,
+    emit: (event: EventResponse<T>) => void
+  ): Promise<void> {
+    const event = new EventResponse<T>();
+    emit(event);
+    const result = await this.waitForEventToRespond(event);
+    this.respondToMessage(message.id!!, result.data, event);
+  }
+
   public respondToMessage(
     messageID: string,
     response: any,