ogi-addon 3.0.0 → 4.0.0

package/src/main.ts

@@ -1,400 +1,85 @@
-import ws, { WebSocket } from 'ws';
+import { EventResponseSocket, randomMessageId } from '@ogi-sdk/connect';
+import type {
+  AddonClientToServerEventArgs,
+  AddonClientToServerEventName,
+  AddonClientToServerWebsocketMessage,
+  AddonNotificationMessage,
+  AddonProtocolEventListenerTypes,
+  AddonSDKLifecycleEventListenerTypes,
+  AddonServerToClientWebsocketMessage,
+  BasicLibraryInfo,
+  CatalogResponse,
+  LibraryInfo,
+  OGIAddonConfiguration,
+  OGIAddonSDKEventListener,
+  SearchResult,
+  SetupResponse,
+  StoreData,
+  AddonTaskRunEventArgs,
+} from '@ogi-sdk/connect';
 import events from 'node:events';
 import { ConfigurationBuilder } from './config/ConfigurationBuilder';
-import type { ConfigurationFile } from './config/ConfigurationBuilder';
-import { Configuration } from './config/Configuration';
+import { Configuration, DefiniteConfig } from './config/Configuration';
 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'
-  | '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.
- */
-export type OGIAddonClientSentEvent =
-  | 'response'
-  | 'authenticate'
-  | 'configure'
-  | 'defer-update'
-  | 'notification'
-  | 'input-asked'
-  | 'get-app-details'
-  | 'search-app-name'
-  | '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'
-  | 'library-search'
-  | 'check-for-updates'
-  | 'task-run'
-  | 'game-details'
-  | 'request-dl'
-  | 'catalog';
 export { ConfigurationBuilder, Configuration, EventResponse };
-export type { SearchResult };
+export { extraction };
 const defaultPort = 7654;
 import pjson from '../package.json';
-import { exec, spawn } from 'node:child_process';
-import fs from 'node:fs';
 import { z } from 'zod';
+import { extraction } from './extraction';
 export const VERSION = pjson.version;
 
-export interface ClientSentEventTypes {
-  response: any;
-  authenticate: {
-    name: string;
-    id: string;
-    description: string;
-    version: string;
-    author: string;
-  };
-  configure: ConfigurationFile;
-  'defer-update': {
-    logs: string[];
-    progress: number;
-  };
-  notification: Notification;
-  'input-asked': ConfigurationBuilder<
-    Record<string, string | number | boolean>
-  >;
-  'task-update': {
-    id: string;
-    progress: number;
-    logs: string[];
-    finished: boolean;
-    failed: string | undefined;
-  };
-  'get-app-details': {
-    appID: number;
-    storefront: string;
-  };
-  'search-app-name': {
-    query: string;
-    storefront: string;
-  };
-  flag: {
-    flag: string;
-    value: string | string[];
-  };
-}
-
-export type BasicLibraryInfo = {
-  name: string;
-  capsuleImage: string;
-  appID: number;
-  storefront: string;
-};
-
-export interface CatalogSection {
-  name: string;
-  description: string;
-  listings: BasicLibraryInfo[];
-}
-
-export interface CatalogCarouselItem {
-  name: string;
-  description: string;
-  carouselImage: string;
-  fullBannerImage?: string;
-  appID?: number;
-  storefront?: string;
-  capsuleImage?: string;
-}
-
-export interface CatalogWithCarousel {
-  sections: Record<string, CatalogSection>;
-  carousel?: Record<string, CatalogCarouselItem> | CatalogCarouselItem[];
-}
-
-export type CatalogResponse =
-  | Record<string, CatalogSection>
-  | CatalogWithCarousel;
-
-/**
- * UMU ID format: 'steam:${number}' or 'umu:${string | number}'
- * - steam:${number} → maps to umu-${number} for Steam games
- * - umu:${string | number} → maps to umu-${string | number} for non-Steam games
- */
-export type UmuId = `steam:${number}` | `umu:${string | number}`;
-
-export type SetupEventResponse = Omit<
+export type {
+  AddonClientToServerEventArgs,
+  AddonClientToServerEventName,
+  AddonClientToServerWebsocketMessage,
+  AddonNotificationMessage,
+  AddonServerToClientEventName,
+  AddonServerToClientWebsocketMessage,
+  BasicLibraryInfo,
+  CatalogCarouselItem,
+  CatalogResponse,
+  CatalogSection,
+  CatalogWithCarousel,
+  ConfigurationFile,
+  ConfigurationOptionType,
+  ConfigurationOptionWire,
   LibraryInfo,
-  | 'capsuleImage'
-  | 'coverImage'
-  | 'name'
-  | 'appID'
-  | 'storefront'
-  | 'addonsource'
-  | 'titleImage'
-> & {
-  redistributables?: {
-    name: string;
-    path: string;
-  }[];
-  /**
-   * UMU Proton integration configuration
-   */
-  umu?: {
-    /**
-     * UMU ID for the game. Format: 'steam:${number}' or 'umu:${string | number}'
-     * - steam:${number} → maps to umu-${number} for Steam games
-     * - umu:${string | number} → maps to umu-${string | number} for non-Steam games
-     */
-    umuId: UmuId;
-    /**
-     * Optional DLL overrides. Can be WINEDLLOVERRIDES-style (e.g. "dinput8=n,b") or bare DLL names.
-     * Bare names get "=n,b" inferred; entries that already include "=..." are used as-is.
-     */
-    dllOverrides?: string[];
-    /**
-     * Optional Proton version to use (e.g., 'GE-Proton9-5', 'GE-Proton')
-     * If not specified, uses latest UMU-Proton
-     */
-    protonVersion?: string;
-    /**
-     * Optional store identifier for protonfixes (e.g., 'gog', 'egs', 'none')
-     */
-    store?: string;
-    /**
-     * Cached Steam shortcut app ID after adding UMU game to Steam (avoids re-adding on each launch)
-     */
-    steamShortcutId?: number;
-  };
-};
-
-export interface EventListenerTypes {
-  /**
-   * This event is emitted when the addon connects to the OGI Addon Server. Addon does not need to resolve anything.
-   * @param event
-   * @returns
-   */
-  connect: (event: EventResponse<void>) => void;
-
-  /**
-   * 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.
-   * @param reason
-   * @returns
-   */
-  disconnect: (reason: string) => void;
-  /**
-   * 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)
-   * @param config
-   * @returns
-   */
-  configure: (config: ConfigurationBuilder) => ConfigurationBuilder;
-  /**
-   * This event is called when the client provides a response to any event. This should be treated as middleware.
-   * @param response
-   * @returns
-   */
-  response: (response: any) => void;
-
-  /**
-   * This event is called when the client requests for the addon to authenticate itself. You don't need to provide any info.
-   * @param config
-   * @returns
-   */
-  authenticate: (config: any) => void;
-  /**
-   * 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)
-   * @param query
-   * @param event
-   * @returns
-   */
-  search: (
-    query: {
-      storefront: string;
-      appID: number;
-    } & (
-      | {
-          for: 'game' | 'task' | 'all';
-        }
-      | {
-          for: 'update';
-          libraryInfo: LibraryInfo;
-        }
-    ),
-    event: EventResponse<SearchResult[]>
-  ) => void;
-  /**
-   * 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)
-   * @param data
-   * @param event
-   * @returns
-   */
-  setup: (
-    data: {
-      path: string;
-      type: 'direct' | 'torrent' | 'magnet' | 'empty';
-      name: string;
-      usedRealDebrid: boolean;
-      clearOldFilesBeforeUpdate?: boolean;
-      multiPartFiles?: {
-        name: string;
-        downloadURL: string;
-      }[];
-      appID: number;
-      storefront: string;
-      manifest?: Record<string, unknown>;
-    } & (
-      | {
-          for: 'game';
-        }
-      | {
-          for: 'update';
-          currentLibraryInfo: LibraryInfo;
-        }
-    ),
-    event: EventResponse<SetupEventResponse>
-  ) => void;
-
-  /**
-   * This event is emitted when the client requires for a search to be performed. Input is the search query.
-   * @param query
-   * @param event
-   * @returns
-   */
-  'library-search': (
-    query: string,
-    event: EventResponse<BasicLibraryInfo[]>
-  ) => void;
-
-  /**
-   * 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.
-   * @param appID
-   * @param event
-   * @returns
-   */
-  'game-details': (
-    details: { appID: number; storefront: string },
-    event: EventResponse<StoreData | undefined>
-  ) => void;
-
-  /**
-   * 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)`.
-   * @returns
-   */
-  exit: () => void;
-
-  /**
-   * 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.
-   * @param appID
-   * @param info
-   * @param event
-   * @returns
-   */
-  'request-dl': (
-    appID: number,
-    info: SearchResult,
-    event: EventResponse<SearchResult>
-  ) => void;
-
-  /**
-   * This event is emitted when the client requests for a catalog to be fetched. Addon should resolve the event with the catalog.
-   * @param event
-   * @returns
-   */
-  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.
-   * @param data
-   * @param event
-   * @returns
-   */
-  'check-for-updates': (
-    data: { appID: number; storefront: string; currentVersion: string },
-    event: EventResponse<
-      | {
-          available: true;
-          version: string;
-        }
-      | {
-          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;
-}
-
-export interface StoreData {
-  name: string;
-  publishers: string[];
-  developers: string[];
-  appID: number;
-  releaseDate: string;
-  capsuleImage: string;
-  coverImage: string;
-  basicDescription: string;
-  description: string;
-  headerImage: string;
-  latestVersion: string;
-}
-export interface WebsocketMessageClient {
-  event: OGIAddonClientSentEvent;
-  id?: string;
-  args: any;
-  statusError?: string;
-}
-export interface WebsocketMessageServer {
-  event: OGIAddonServerSentEvent;
-  id?: string;
-  args: any;
-  statusError?: string;
-}
+  OGIAddonConfiguration,
+  OGIAddonSDKEventListener,
+  SearchResult,
+  SetupResponse,
+  SetupEventResponse,
+  StoreData,
+  UmuId,
+  SetupCommandData,
+  AddonProtocolEventListenerTypes,
+  AddonSDKLifecycleEventListenerTypes,
+  AddonServerHostEventListeners,
+  AddonServerHostEventName,
+  AddonServerLifecycleEvent,
+} from '@ogi-sdk/connect';
+
+/** @deprecated Use {@link AddonNotificationMessage}. */
+export type Notification = AddonNotificationMessage;
 
 /**
- * The configuration for the addon. This is used to identify the addon and provide information about it.
- * Storefronts is an array of names of stores that the addon supports.
+ * Addon SDK listener signatures. Protocol commands come from `addonProtocol` in
+ * `@ogi-sdk/connect`; lifecycle and builder-specific hooks are merged below.
  */
-export interface OGIAddonConfiguration {
-  name: string;
-  id: string;
-  description: string;
-  version: string;
-
-  author: string;
-  repository: string;
-  storefronts: string[];
-}
+export type EventListenerTypes = AddonSDKLifecycleEventListenerTypes<
+  EventResponse<unknown>
+> &
+  AddonProtocolEventListenerTypes<
+    EventResponse<unknown>,
+    'authenticate' | 'configure' | 'catalog'
+  > & {
+    authenticate: (config: unknown) => void;
+    configure: (config: ConfigurationBuilder) => ConfigurationBuilder;
+    catalog: (event: Omit<EventResponse<CatalogResponse>, 'askForInput'>) => void;
+  };
 
 /**
  * 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.
@@ -416,7 +101,7 @@ export default class OGIAddon {
   public addonWSListener: OGIAddonWSListener;
   public addonInfo: OGIAddonConfiguration;
   public config: Configuration = new Configuration({});
-  private eventsAvailable: OGIAddonEvent[] = [];
+  private eventsAvailable: OGIAddonSDKEventListener[] = [];
   private registeredConnectEvent: boolean = false;
   private taskHandlers: Map<
     string,
@@ -438,10 +123,10 @@ export default class OGIAddon {
 
   /**
    * Register an event listener for the addon. (See EventListenerTypes)
-   * @param event {OGIAddonEvent}
-   * @param listener {EventListenerTypes[OGIAddonEvent]}
+   * @param event {OGIAddonSDKEventListener}
+   * @param listener {EventListenerTypes[OGIAddonSDKEventListener]}
    */
-  public on<T extends OGIAddonEvent>(
+  public on<T extends OGIAddonSDKEventListener>(
     event: T,
     listener: EventListenerTypes[T]
   ) {
@@ -459,7 +144,7 @@ export default class OGIAddon {
     }
   }
 
-  public emit<T extends OGIAddonEvent>(
+  public emit<T extends OGIAddonSDKEventListener>(
     event: T,
     ...args: Parameters<EventListenerTypes[T]>
   ) {
@@ -470,7 +155,7 @@ export default class OGIAddon {
    * Notify the client using a notification. Provide the type of notification, the message, and an ID.
    * @param notification {Notification}
    */
-  public notify(notification: Notification) {
+  public notify(notification: AddonNotificationMessage) {
     this.addonWSListener.send('notification', [notification]);
   }
 
@@ -481,23 +166,23 @@ export default class OGIAddon {
    * @returns {Promise<StoreData>}
    */
   public async getAppDetails(appID: number, storefront: string) {
-    const id = this.addonWSListener.send('get-app-details', {
-      appID,
-      storefront,
-    });
-    return await this.addonWSListener.waitForResponseFromServer<
-      StoreData | undefined
-    >(id);
+    return await this.addonWSListener.requestResponse<StoreData | undefined>(
+      'get-app-details',
+      {
+        appID,
+        storefront,
+      }
+    );
   }
 
   public async searchGame(query: string, storefront: string) {
-    const id = this.addonWSListener.send('search-app-name', {
-      query,
-      storefront,
-    });
-    return await this.addonWSListener.waitForResponseFromServer<
-      BasicLibraryInfo[]
-    >(id);
+    return await this.addonWSListener.requestResponse<BasicLibraryInfo[]>(
+      'search-app-name',
+      {
+        query,
+        storefront,
+      }
+    );
   }
 
   /**
@@ -581,117 +266,10 @@ export default class OGIAddon {
    * Extract a file using 7-Zip on Windows, unzip on Linux/Mac.
    * @param path {string}
    * @param outputPath {string}
-   * @param type {'unrar' | 'unzip'}
    * @returns {Promise<void>}
    */
-  public async extractFile(
-    path: string,
-    outputPath: string,
-    type: 'unrar' | 'unzip'
-  ) {
-    return new Promise<void>((resolve, reject) => {
-      // Ensure outputPath exists
-      if (!fs.existsSync(outputPath)) {
-        fs.mkdirSync(outputPath, { recursive: true });
-      }
-
-      if (type === 'unzip') {
-        // Prefer 7-Zip on Windows, unzip on Linux/Mac
-        if (process.platform === 'win32') {
-          // 7-Zip path (default install location)
-          const s7ZipPath = '"C:\\Program Files\\7-Zip\\7z.exe"';
-          exec(
-            `${s7ZipPath} x "${path}" -o"${outputPath}"`,
-            (err: any, stdout: any, stderr: any) => {
-              if (err) {
-                console.error(err);
-                console.log(stderr);
-                reject(new Error('Failed to extract ZIP file'));
-                return;
-              }
-              console.log(stdout);
-              console.log(stderr);
-              resolve();
-            }
-          );
-        } else {
-          // Use unzip on Linux/Mac
-          const unzipProcess = spawn(
-            'unzip',
-            [
-              '-o', // overwrite files without prompting
-              path,
-              '-d', // specify output directory
-              outputPath,
-            ],
-            {
-              env: {
-                ...process.env,
-                UNZIP_DISABLE_ZIPBOMB_DETECTION: 'TRUE',
-              },
-            }
-          );
-
-          unzipProcess.stdout.on('data', (data: Buffer) => {
-            console.log(`[unzip stdout]: ${data}`);
-          });
-
-          unzipProcess.stderr.on('data', (data: Buffer) => {
-            console.error(`[unzip stderr]: ${data}`);
-          });
-
-          unzipProcess.on('close', (code: number) => {
-            if (code !== 0) {
-              console.error(`unzip process exited with code ${code}`);
-              reject(new Error('Failed to extract ZIP file'));
-              return;
-            }
-            resolve();
-          });
-        }
-      } else if (type === 'unrar') {
-        if (process.platform === 'win32') {
-          // 7-Zip path (default install location)
-          const s7ZipPath = '"C:\\Program Files\\7-Zip\\7z.exe"';
-          exec(
-            `${s7ZipPath} x "${path}" -o"${outputPath}"`,
-            (err: any, stdout: any, stderr: any) => {
-              if (err) {
-                console.error(err);
-                console.log(stderr);
-                reject(new Error('Failed to extract RAR file'));
-                return;
-              }
-              console.log(stdout);
-              console.log(stderr);
-              resolve();
-            }
-          );
-        } else {
-          // Use unrar on Linux/Mac
-          const unrarProcess = spawn('unrar', ['x', '-y', path, outputPath]);
-
-          unrarProcess.stdout.on('data', (data: Buffer) => {
-            console.log(`[unrar stdout]: ${data}`);
-          });
-
-          unrarProcess.stderr.on('data', (data: Buffer) => {
-            console.error(`[unrar stderr]: ${data}`);
-          });
-
-          unrarProcess.on('close', (code: number) => {
-            if (code !== 0) {
-              console.error(`unrar process exited with code ${code}`);
-              reject(new Error('Failed to extract RAR file'));
-              return;
-            }
-            resolve();
-          });
-        }
-      } else {
-        reject(new Error('Unknown extraction type'));
-      }
-    });
+  public async extractFile(path: string, outputPath: string) {
+    return await extraction(path, outputPath);
   }
 }
 
@@ -879,7 +457,7 @@ export class SearchTool<T> {
 /**
  * Library Info is the metadata for a library entry after setting up a game.
  */
-export const ZodLibraryInfo = z.object({
+export const ZodLibraryInfo: z.ZodType<LibraryInfo> = z.object({
   name: z.string(),
   version: z.string(),
   cwd: z.string(),
@@ -922,36 +500,52 @@ export const ZodLibraryInfo = z.object({
     )
     .optional(),
 });
-export type LibraryInfo = z.infer<typeof ZodLibraryInfo>;
-interface Notification {
-  type: 'warning' | 'error' | 'info' | 'success';
-  message: string;
-  id: string;
-}
+
+export type { AddonTaskRunEventArgs as TaskRunMessageArgs } from '@ogi-sdk/connect';
+
 class OGIAddonWSListener {
-  private socket: WebSocket;
+  private socket: InstanceType<typeof globalThis.WebSocket>;
+  private transport: EventResponseSocket<
+    AddonServerToClientWebsocketMessage,
+    AddonClientToServerWebsocketMessage
+  >;
   public eventEmitter: events.EventEmitter;
   public addon: OGIAddon;
 
   constructor(ogiAddon: OGIAddon, eventEmitter: events.EventEmitter) {
-    if (
-      process.argv[process.argv.length - 1].split('=')[0] !== '--addonSecret'
-    ) {
+    const secret = process.argv
+      .find((arg) => arg.startsWith('--addonSecret='))
+      ?.split('=')[1];
+    if (!secret) {
       throw new Error(
         'No secret provided. This usually happens because the addon was not started by the OGI Addon Server.'
       );
     }
+
+    // get the port from the arguments
+    let port = process.argv
+      .find((arg) => arg.startsWith('--addonPort='))
+      ?.split('=')[1];
+    if (!port) {
+      port = defaultPort.toString();
+    }
+
     this.addon = ogiAddon;
     this.eventEmitter = eventEmitter;
-    this.socket = new ws('ws://localhost:' + defaultPort);
-    this.socket.on('open', () => {
+    const WebSocketConstructor = globalThis.WebSocket;
+    if (!WebSocketConstructor) {
+      throw new Error('WebSocket is not available in this runtime');
+    }
+    this.socket = new WebSocketConstructor('ws://localhost:' + port);
+    this.transport = new EventResponseSocket(this.socket);
+    this.socket.addEventListener('open', () => {
       console.log('Connected to OGI Addon Server');
       console.log('OGI Addon Server Version:', VERSION);
 
       // Authenticate with OGI Addon Server
-      this.send('authenticate', {
+      this.send('authenticate' as AddonClientToServerEventName, {
         ...this.addon.addonInfo,
-        secret: process.argv[process.argv.length - 1].split('=')[1],
+        secret,
         ogiVersion: VERSION,
       });
 
@@ -962,59 +556,44 @@ class OGIAddonWSListener {
       this.addon.config = new Configuration(configBuilder.build(true));
 
       // wait for the config-update to be received then send connect
-      const configListener = (event: ws.MessageEvent) => {
-        if (event === undefined) return;
-        // event can be a Buffer, string, ArrayBuffer, or Buffer[]
-        let data: string;
-        if (typeof event === 'string') {
-          data = event;
-        } else if (event instanceof Buffer) {
-          data = event.toString();
-        } else if (event && typeof (event as any).data === 'string') {
-          data = (event as any).data;
-        } else if (event && (event as any).data instanceof Buffer) {
-          data = (event as any).data.toString();
-        } else {
-          // fallback for other types
-          data = event.toString();
-        }
-        const message: WebsocketMessageServer = JSON.parse(data);
-        if (message.event === 'config-update') {
+      const unsubscribeConfigListener = this.transport.on(
+        'config-update',
+        () => {
           console.log('Config update received');
-          this.socket.off('message', configListener);
+          unsubscribeConfigListener();
           this.eventEmitter.emit(
             'connect',
             new EventResponse<void>((screen, name, description) => {
-              return this.userInputAsked(
-                screen,
-                name,
-                description,
-                this.socket
-              );
+              return this.userInputAsked(screen, name, description);
             })
           );
         }
-      };
-      this.socket.on('message', configListener);
+      );
     });
 
-    this.socket.on('error', (error) => {
-      if (error.message.includes('Failed to connect')) {
+    this.socket.addEventListener('error', (event) => {
+      this.transport.rejectPendingResponses('Websocket error');
+      const message =
+        event instanceof ErrorEvent
+          ? event.message
+          : event.type;
+      if (message.includes('Failed to connect')) {
         throw new Error(
           'OGI Addon Server is not running/is unreachable. Please start the server and try again.'
         );
       }
-      console.error('An error occurred:', error);
+      console.error('An error occurred:', event);
     });
 
-    this.socket.on('close', (code, reason) => {
-      if (code === 1008) {
-        console.error('Authentication failed:', reason);
+    this.socket.addEventListener('close', (event) => {
+      this.transport.rejectPendingResponses('Websocket closed');
+      if (event.code === 1008) {
+        console.error('Authentication failed:', event.reason);
         return;
       }
-      this.eventEmitter.emit('disconnect', reason);
+      this.eventEmitter.emit('disconnect', event.reason);
       console.log('Disconnected from OGI Addon Server');
-      console.error(reason.toString());
+      console.error(event.reason);
       this.eventEmitter.emit('exit');
       this.socket.close();
     });
@@ -1027,173 +606,188 @@ class OGIAddonWSListener {
   >(
     configBuilt: ConfigurationBuilder<U>,
     name: string,
-    description: string,
-    socket: WebSocket
+    description: string
   ): Promise<U> {
     const config = configBuilt.build(false);
-    const id = Math.random().toString(36).substring(7);
-    if (!socket) {
-      throw new Error('Socket is not connected');
-    }
-    socket.send(
-      JSON.stringify({
+    const response = await this.transport.send(
+      {
         event: 'input-asked',
         args: {
           config,
           name,
           description,
         },
-        id: id,
-      })
+      } as AddonClientToServerWebsocketMessage,
+      { expectResponse: true }
     );
-    return await this.waitForResponseFromServer<U>(id);
+    return response.args as U;
   }
 
   /**
    * 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);
-      switch (message.event) {
-        case 'config-update':
-          const result = this.addon.config.updateConfig(message.args);
-          if (!result[0]) {
-            this.respondToMessage(
-              message.id!!,
-              {
-                success: false,
-                error: result[1],
-              },
-              undefined
+    const events: AddonServerToClientWebsocketMessage['event'][] = [
+      'config-update',
+      'search',
+      'setup',
+      'library-search',
+      'game-details',
+      'check-for-updates',
+      'request-dl',
+      'catalog',
+      'task-run',
+      'launch-app',
+    ];
+
+    for (const event of events) {
+      this.transport.on(event, async (message) => {
+        switch (message.event) {
+          case 'config-update':
+            const result = this.addon.config.updateConfig(
+              message.args as DefiniteConfig
+            );
+            if (!result[0]) {
+              this.respondToMessage(
+                message.id!!,
+                {
+                  success: false,
+                  error: result[1],
+                },
+                undefined
+              );
+            } else {
+              this.respondToMessage(message.id!!, { success: true }, undefined);
+            }
+            break;
+          case 'search':
+            await this.handleEventWithResponse<SearchResult[]>(
+              message,
+              (event) => this.eventEmitter.emit('search', message.args, event)
             );
-          } else {
-            this.respondToMessage(message.id!!, { success: true }, undefined);
+            break;
+          case 'setup': {
+            let setupEvent = new EventResponse<SetupResponse>(
+              (screen, name, description) =>
+                this.userInputAsked(screen, name, description)
+            );
+            this.eventEmitter.emit('setup', message.args, setupEvent);
+            const interval = setInterval(() => {
+              if (setupEvent.resolved) {
+                clearInterval(interval);
+                return;
+              }
+              this.send('defer-update', {
+                logs: setupEvent.logs,
+                deferID:
+                  message.args as AddonClientToServerEventArgs['defer-update']['deferID'],
+                progress: setupEvent.progress,
+                failed: setupEvent.failed,
+              } as AddonClientToServerEventArgs['defer-update']);
+            }, 100);
+            const setupResult = await this.waitForEventToRespond(setupEvent);
+            this.respondToMessage(message.id!!, setupResult.data, setupEvent);
+            break;
           }
-          break;
-        case 'search':
-          await this.handleEventWithResponse<SearchResult[]>(message, (event) =>
-            this.eventEmitter.emit('search', message.args, event)
-          );
-          break;
-        case 'setup': {
-          let setupEvent = new EventResponse<SetupEventResponse>(
-            (screen, name, description) =>
-              this.userInputAsked(screen, name, description, this.socket)
-          );
-          this.eventEmitter.emit('setup', message.args, setupEvent);
-          const interval = setInterval(() => {
-            if (setupEvent.resolved) {
-              clearInterval(interval);
-              return;
+          case 'library-search':
+            await this.handleEventWithResponse<BasicLibraryInfo[]>(
+              message,
+              (event) =>
+                this.eventEmitter.emit('library-search', message.args, event)
+            );
+            break;
+          case 'game-details':
+            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':
+            await this.handleEventWithResponse<
+              { available: true; version: string } | { available: false }
+            >(message, (event) =>
+              this.eventEmitter.emit('check-for-updates', message.args, event)
+            );
+            break;
+          case 'request-dl':
+            let requestDLEvent = new EventResponse<SearchResult>(
+              (screen, name, description) =>
+                this.userInputAsked(screen, name, description)
+            );
+            if (this.eventEmitter.listenerCount('request-dl') === 0) {
+              this.respondToMessage(
+                message.id!!,
+                {
+                  error: 'No event listener for request-dl',
+                },
+                requestDLEvent
+              );
+              break;
             }
-            this.send('defer-update', {
-              logs: setupEvent.logs,
-              deferID: message.args.deferID,
-              progress: setupEvent.progress,
-              failed: setupEvent.failed,
-            } as ClientSentEventTypes['defer-update']);
-          }, 100);
-          const setupResult = await this.waitForEventToRespond(setupEvent);
-          this.respondToMessage(message.id!!, setupResult.data, setupEvent);
-          break;
-        }
-        case 'library-search':
-          await this.handleEventWithResponse<BasicLibraryInfo[]>(
-            message,
-            (event) =>
-              this.eventEmitter.emit('library-search', message.args, event)
-          );
-          break;
-        case 'game-details':
-          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',
+            const { appID, info } = message.args as {
+              appID: number;
+              info: SearchResult;
+            };
+            this.eventEmitter.emit(
+              'request-dl',
+              appID,
+              info,
+              requestDLEvent as EventResponse<SearchResult>
+            );
+            const requestDLResult =
+              await this.waitForEventToRespond(requestDLEvent);
+            if (requestDLEvent.failed) {
+              this.respondToMessage(message.id!!, undefined, requestDLEvent);
+              break;
+            }
+            if (
+              requestDLEvent.data === undefined ||
+              requestDLEvent.data?.downloadType === 'request'
+            ) {
+              throw new Error(
+                'Request DL event did not return a valid result. Please ensure that the event does not resolve with another `request` download type.'
+              );
             }
-          );
-          break;
-        case 'check-for-updates':
-          await this.handleEventWithResponse<
-            { available: true; version: string } | { available: false }
-          >(message, (event) =>
-            this.eventEmitter.emit('check-for-updates', message.args, event)
-          );
-          break;
-        case 'request-dl':
-          let requestDLEvent = new EventResponse<SearchResult>(
-            (screen, name, description) =>
-              this.userInputAsked(screen, name, description, this.socket)
-          );
-          if (this.eventEmitter.listenerCount('request-dl') === 0) {
             this.respondToMessage(
               message.id!!,
-              {
-                error: 'No event listener for request-dl',
-              },
+              requestDLResult.data,
               requestDLEvent
             );
             break;
-          }
-          this.eventEmitter.emit(
-            'request-dl',
-            message.args.appID,
-            message.args.info,
-            requestDLEvent
-          );
-          const requestDLResult =
-            await this.waitForEventToRespond(requestDLEvent);
-          if (requestDLEvent.failed) {
-            this.respondToMessage(message.id!!, undefined, requestDLEvent);
+          case 'catalog':
+            await this.handleEventWithResponseNoInput<CatalogResponse>(
+              message,
+              (event) => this.eventEmitter.emit('catalog', event)
+            );
             break;
-          }
-          if (
-            requestDLEvent.data === undefined ||
-            requestDLEvent.data?.downloadType === 'request'
-          ) {
-            throw new Error(
-              'Request DL event did not return a valid result. Please ensure that the event does not resolve with another `request` download type.'
+          case 'task-run': {
+            let taskRunEvent = new EventResponse<void>(
+              (screen, name, description) =>
+                this.userInputAsked(screen, name, description)
             );
-          }
-          this.respondToMessage(
-            message.id!!,
-            requestDLResult.data,
-            requestDLEvent
-          );
-          break;
-        case 'catalog':
-          await this.handleEventWithResponseNoInput<CatalogResponse>(
-            message,
-            (event) => this.eventEmitter.emit('catalog', event)
-          );
-          break;
-        case 'task-run': {
-          let taskRunEvent = new EventResponse<void>(
-            (screen, name, description) =>
-              this.userInputAsked(screen, name, description, this.socket)
-          );
-
-          // Check for taskName: first from args directly (from SearchResult), then from manifest.__taskName (for ActionOption)
-          const taskName =
-            message.args.taskName && typeof message.args.taskName === 'string'
-              ? message.args.taskName
-              : message.args.manifest &&
-                  typeof message.args.manifest === 'object'
-                ? (message.args.manifest as Record<string, unknown>).__taskName
-                : undefined;
-
-          if (
-            taskName &&
-            typeof taskName === 'string' &&
-            this.addon.hasTaskHandler(taskName)
-          ) {
-            // Use the registered task handler
-            const handler = this.addon.getTaskHandler(taskName)!;
-            const task = new Task(taskRunEvent);
-            try {
+            const args = message.args as AddonTaskRunEventArgs;
+
+            // Check for taskName: first from args directly (from SearchResult), then from manifest.__taskName (for ActionOption)
+            const taskName =
+              args.taskName && typeof args.taskName === 'string'
+                ? args.taskName
+                : args.manifest && typeof args.manifest === 'object'
+                  ? args.manifest.__taskName
+                  : undefined;
+
+            if (
+              taskName &&
+              typeof taskName === 'string' &&
+              this.addon.hasTaskHandler(taskName)
+            ) {
+              // Use the registered task handler
+              const handler = this.addon.getTaskHandler(taskName)!;
+              const task = new Task(taskRunEvent);
               const interval = setInterval(() => {
                 if (taskRunEvent.resolved) {
                   clearInterval(interval);
@@ -1201,48 +795,55 @@ class OGIAddonWSListener {
                 }
                 this.send('defer-update', {
                   logs: taskRunEvent.logs,
-                  deferID: message.args.deferID,
+                  deferID: args.deferID ?? '',
                   progress: taskRunEvent.progress,
                   failed: taskRunEvent.failed,
-                } as ClientSentEventTypes['defer-update']);
+                } as AddonClientToServerEventArgs['defer-update']);
               }, 100);
-              const result = handler(task, {
-                manifest: message.args.manifest || {},
-                downloadPath: message.args.downloadPath || '',
-                name: message.args.name || '',
-                libraryInfo: message.args.libraryInfo,
-              });
-              // If handler returns a promise, wait for it
-              if (result instanceof Promise) {
-                await result;
+              try {
+                const result = handler(task, {
+                  manifest: args.manifest || {},
+                  downloadPath: args.downloadPath || '',
+                  name: args.name || '',
+                  libraryInfo: args.libraryInfo,
+                });
+                // If handler returns a promise, wait for it
+                if (result instanceof Promise) {
+                  await result;
+                }
+              } catch (error) {
+                taskRunEvent.fail(
+                  error instanceof Error ? error.message : String(error)
+                );
+              } finally {
+                clearInterval(interval);
               }
-
-              clearInterval(interval);
-            } catch (error) {
+            } else {
+              // No handler found - fail the task
               taskRunEvent.fail(
-                error instanceof Error ? error.message : String(error)
+                taskName
+                  ? `No task handler registered for task name: ${taskName}`
+                  : 'No task name provided'
               );
             }
-          } else {
-            // No handler found - fail the task
-            taskRunEvent.fail(
-              taskName
-                ? `No task handler registered for task name: ${taskName}`
-                : 'No task name provided'
+
+            const taskRunResult =
+              await this.waitForEventToRespond(taskRunEvent);
+            this.respondToMessage(
+              message.id!!,
+              taskRunResult.data,
+              taskRunEvent
             );
+            break;
           }
-
-          const taskRunResult = await this.waitForEventToRespond(taskRunEvent);
-          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;
         }
-        case 'launch-app':
-          await this.handleEventWithResponse<void>(message, (event) =>
-            this.eventEmitter.emit('launch-app', message.args, event)
-          );
-          break;
-      }
-    });
+      });
+    }
   }
 
   private waitForEventToRespond<T>(
@@ -1278,12 +879,12 @@ class OGIAddonWSListener {
    * If options.requireListener is set and that event has no listeners, responds with options.noListenerError and returns.
    */
   private async handleEventWithResponse<T>(
-    message: WebsocketMessageServer,
+    message: AddonServerToClientWebsocketMessage,
     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)
+      this.userInputAsked(screen, name, description)
     );
     if (
       options &&
@@ -1305,7 +906,7 @@ class OGIAddonWSListener {
    * Same as handleEventWithResponse but for events that don't need userInputAsked (e.g. catalog).
    */
   private async handleEventWithResponseNoInput<T>(
-    message: WebsocketMessageServer,
+    message: AddonServerToClientWebsocketMessage,
     emit: (event: EventResponse<T>) => void
   ): Promise<void> {
     const event = new EventResponse<T>();
@@ -1319,49 +920,41 @@ class OGIAddonWSListener {
     response: any,
     originalEvent: EventResponse<any> | undefined
   ) {
-    this.socket.send(
-      JSON.stringify({
+    void this.transport.send(
+      {
         event: 'response',
         id: messageID,
         args: response,
         statusError: originalEvent ? originalEvent.failed : undefined,
-      })
+      } as AddonClientToServerWebsocketMessage,
+      { expectResponse: false }
     );
     console.log('dispatched response to ' + messageID);
   }
 
-  public waitForResponseFromServer<T>(messageID: string): Promise<T> {
-    return new Promise((resolve) => {
-      const waiter = (data: string) => {
-        const message: WebsocketMessageClient = JSON.parse(data);
-        if (message.event !== 'response') {
-          this.socket.once('message', waiter);
-          return;
-        }
-        console.log('received response from ' + messageID);
-
-        if (message.id === messageID) {
-          resolve(message.args);
-        } else {
-          this.socket.once('message', waiter);
-        }
-      };
-      this.socket.once('message', waiter);
-    });
+  public async requestResponse<T>(
+    event: AddonClientToServerEventName,
+    args: AddonClientToServerEventArgs[AddonClientToServerEventName]
+  ): Promise<T> {
+    const response = await this.transport.send(
+      { event, args } as AddonClientToServerWebsocketMessage,
+      { expectResponse: true }
+    );
+    return response.args as T;
   }
 
   public send(
-    event: OGIAddonClientSentEvent,
-    args: ClientSentEventTypes[OGIAddonClientSentEvent]
+    event: AddonClientToServerEventName,
+    args: AddonClientToServerEventArgs[AddonClientToServerEventName]
   ): string {
-    // generate a random id
-    const id = Math.random().toString(36).substring(7);
-    this.socket.send(
-      JSON.stringify({
+    const id = randomMessageId();
+    void this.transport.send(
+      {
         event,
         args,
         id,
-      })
+      } as AddonClientToServerWebsocketMessage,
+      { expectResponse: false }
     );
     return id;
   }