docs: refine code comment

[poolifier.git] / src / worker / task-functions.ts

/**
 * Task synchronous function that can be executed.
 *
 * @param data - Data sent to the worker.
 * @returns Execution response.
 *
 * @typeParam Data - Type of data sent to the worker. This can only be structured-cloneable data.
 * @typeParam Response - Type of execution response. This can only be structured-cloneable data.
 */
export type TaskSyncFunction<Data = unknown, Response = unknown> = (
  data?: Data
) => Response

/**
 * Task asynchronous function that can be executed.
 * This function must return a promise.
 *
 * @param data - Data sent to the worker.
 * @returns Execution response promise.
 *
 * @typeParam Data - Type of data sent to the worker. This can only be structured-cloneable data.
 * @typeParam Response - Type of execution response. This can only be structured-cloneable data.
 */
export type TaskAsyncFunction<Data = unknown, Response = unknown> = (
  data?: Data
) => Promise<Response>

/**
 * Task function that can be executed.
 * This function can be synchronous or asynchronous.
 *
 * @typeParam Data - Type of data sent to the worker. This can only be structured-cloneable data.
 * @typeParam Response - Type of execution response. This can only be structured-cloneable data.
 */
export type TaskFunction<Data = unknown, Response = unknown> =
  | TaskSyncFunction<Data, Response>
  | TaskAsyncFunction<Data, Response>

/**
 * Tasks functions that can be executed.
 * This object can contain synchronous or asynchronous functions.
 * The key is the name of the function.
 * The value is the function itself.
 *
 * @typeParam Data - Type of data sent to the worker. This can only be structured-cloneable data.
 * @typeParam Response - Type of execution response. This can only be structured-cloneable data.
 */
export type TaskFunctions<Data = unknown, Response = unknown> = Record<
string,
TaskFunction<Data, Response>
>

/**
 * Task function operation result.
 */
export interface TaskFunctionOperationResult {
  status: boolean
  error?: Error
}