modrinth/apps/app-frontend/src/helpers/events.js

/*
    Event listeners for interacting with the Rust api
    These are all async functions that return a promise that resolves to the payload object (whatever Rust is trying to deliver)
*/

/*
    callback is a function that takes a single argument, which is the payload object (whatever Rust is trying to deliver)

    You can call these to await any kind of emitted signal from Rust, and then do something with the payload object
    An example place to put this is at the start of main.js before the state is initialized- that way
    you can listen for any emitted signal from Rust and do something with it as the state is being initialized

    Example:
      import { loading_listener } from '@/helpers/events'
      await loading_listener((event) => {
        // event.event is the event name (useful if you want to use a single callback fn for multiple event types)
        // event.payload is the payload object
        console.log(event)
      })

    Putting that in a script will print any emitted signal from rust
*/
import { listen } from '@tauri-apps/api/event'

/// Payload for the 'loading' event
/*
    LoadingPayload {
        event: {
          type: string, one of  "StateInit", "PackDownload", etc
          (Optional fields depending on event type)
          pack_name: name of the pack
          pack_id, optional, the id of the modpack
          pack_version, optional, the version of the modpack
          instance_name: name of the instance
          instance_id: unique identification of the instance

        }
        loader_uuid: unique identification of the loading bar
        fraction: number, (as a fraction of 1, how much we've loaded so far). If null, by convention, loading is finished
        message: message to display to the user
    }
*/
export async function loading_listener(callback) {
	return await listen('loading', (event) => callback(event.payload))
}

/// Payload for the 'process' event
/*
    ProcessPayload {
        uuid: unique identification of the process in the state (currently identified by PID, but that will change)
        pid: process ID
        event: event type ("Launched", "Finished")
        message: message to display to the user
    }
*/
export async function process_listener(callback) {
	return await listen('process', (event) => callback(event.payload))
}

/// Payload for the 'instance' event
/*
    InstancePayload {
        instance_id: unique identification of the instance
        event: event type ("Created", "Added", "Edited", "Removed")
    }
*/
export async function instance_listener(callback) {
	return await listen('instance', (event) => callback(event.payload))
}

/// Payload for the 'instance_bulk_update_progress' event
/*
    InstanceBulkUpdateProgress {
        instanceId: string
        stage: "resolving_versions" | "downloading" | "finishing"
        current: number
        total: number
    }
*/
export async function instance_bulk_update_progress_listener(callback) {
	return await listen('instance_bulk_update_progress', (event) => callback(event.payload))
}

export async function install_job_listener(callback) {
	return await listen('install_job', (event) => callback(event.payload))
}

/// Payload for the 'command' event
/*
  CommandPayload {
    event: event type ("InstallMod", "InstallModpack", "InstallVersion"),
    id: string id of the mod/modpack/version to install
  }
*/
export async function command_listener(callback) {
	return await listen('command', (event) => {
		callback(event.payload)
	})
}

/// Payload for the 'warning' event
/*
    WarningPayload {
        message: message to display to the user
    }
*/
export async function warning_listener(callback) {
	return await listen('warning', (event) => callback(event.payload))
}

export async function friend_listener(callback) {
	return await listen('friend', (event) => callback(event.payload))
}

export async function notification_listener(callback) {
	return await listen('notification', (event) => callback(event.payload))
}

/// Payload for the 'log' event
/*
    LogPayload {
        instance_id: string,
        type: "log4j" | "legacy",
        // log4j fields (when type === "log4j"):
        timestamp_millis?: number,
        logger_name?: string,
        level?: string,
        thread_name?: string,
        message?: string,
        throwable?: string,
        // legacy fields (when type === "legacy"):
        message?: string,
    }
*/
export async function log_listener(callback) {
	return await listen('log', (event) => callback(event.payload))
}