ogi-addon 1.9.4 → 2.0.0

package/build/config/ConfigurationBuilder.cjs

@@ -1,10 +1,12 @@
-const require_ConfigurationBuilder = require('../ConfigurationBuilder-BSuJ4rSI.cjs');
+const require_ConfigurationBuilder = require('../ConfigurationBuilder-CFXi6UwU.cjs');
 
+exports.ActionOption = require_ConfigurationBuilder.ActionOption;
 exports.BooleanOption = require_ConfigurationBuilder.BooleanOption;
 exports.ConfigurationBuilder = require_ConfigurationBuilder.ConfigurationBuilder;
 exports.ConfigurationOption = require_ConfigurationBuilder.ConfigurationOption;
 exports.NumberOption = require_ConfigurationBuilder.NumberOption;
 exports.StringOption = require_ConfigurationBuilder.StringOption;
+exports.isActionOption = require_ConfigurationBuilder.isActionOption;
 exports.isBooleanOption = require_ConfigurationBuilder.isBooleanOption;
 exports.isNumberOption = require_ConfigurationBuilder.isNumberOption;
 exports.isStringOption = require_ConfigurationBuilder.isStringOption;

package/build/config/ConfigurationBuilder.d.cts

@@ -1,2 +1,2 @@
-import { a as ConfigurationOptionType, c as isBooleanOption, i as ConfigurationOption, l as isNumberOption, n as ConfigurationBuilder, o as NumberOption, r as ConfigurationFile, s as StringOption, t as BooleanOption, u as isStringOption } from "../ConfigurationBuilder-CfHLKMTO.cjs";
-export { BooleanOption, ConfigurationBuilder, ConfigurationFile, ConfigurationOption, ConfigurationOptionType, NumberOption, StringOption, isBooleanOption, isNumberOption, isStringOption };
+import { a as ConfigurationOption, c as StringOption, d as isNumberOption, f as isStringOption, i as ConfigurationFile, l as isActionOption, n as BooleanOption, o as ConfigurationOptionType, r as ConfigurationBuilder, s as NumberOption, t as ActionOption, u as isBooleanOption } from "../ConfigurationBuilder-C83EP5v2.cjs";
+export { ActionOption, BooleanOption, ConfigurationBuilder, ConfigurationFile, ConfigurationOption, ConfigurationOptionType, NumberOption, StringOption, isActionOption, isBooleanOption, isNumberOption, isStringOption };

package/build/config/ConfigurationBuilder.d.mts

@@ -1,2 +1,2 @@
-import { a as ConfigurationOptionType, c as isBooleanOption, i as ConfigurationOption, l as isNumberOption, n as ConfigurationBuilder, o as NumberOption, r as ConfigurationFile, s as StringOption, t as BooleanOption, u as isStringOption } from "../ConfigurationBuilder-BbZDA_xx.mjs";
-export { BooleanOption, ConfigurationBuilder, ConfigurationFile, ConfigurationOption, ConfigurationOptionType, NumberOption, StringOption, isBooleanOption, isNumberOption, isStringOption };
+import { a as ConfigurationOption, c as StringOption, d as isNumberOption, f as isStringOption, i as ConfigurationFile, l as isActionOption, n as BooleanOption, o as ConfigurationOptionType, r as ConfigurationBuilder, s as NumberOption, t as ActionOption, u as isBooleanOption } from "../ConfigurationBuilder-lzKf9gHw.mjs";
+export { ActionOption, BooleanOption, ConfigurationBuilder, ConfigurationFile, ConfigurationOption, ConfigurationOptionType, NumberOption, StringOption, isActionOption, isBooleanOption, isNumberOption, isStringOption };

package/build/config/ConfigurationBuilder.mjs

@@ -15,37 +15,58 @@ function isNumberOption(option) {
 function isBooleanOption(option) {
 	return option.type === "boolean";
 }
+function isActionOption(option) {
+	return option.type === "action";
+}
+/**
+* A builder for creating configuration screens. The generic type T accumulates
+* the types of all options added to the builder, enabling type-safe access to
+* the configuration values.
+* 
+* @template T - The accumulated type of all configuration options
+*/
 var ConfigurationBuilder = class {
 	options = [];
 	/**
 	* Add a number option to the configuration builder and return the builder for chaining. You must provide a name, display name, and description for the option.
-	* @param option { (option: NumberOption) => NumberOption }
-	* @returns
+	* @param option { (option: NumberOption) => NumberOption<K> }
+	* @returns A new ConfigurationBuilder with the number option's type added
 	*/
 	addNumberOption(option) {
-		let newOption = new NumberOption();
-		newOption = option(newOption);
-		this.options.push(newOption);
+		const configuredOption = option(new NumberOption());
+		this.options.push(configuredOption);
 		return this;
 	}
 	/**
 	* Add a string option to the configuration builder and return the builder for chaining. You must provide a name, display name, and description for the option.
-	* @param option { (option: StringOption) => StringOption }
+	* @param option { (option: StringOption) => StringOption<K> }
+	* @returns A new ConfigurationBuilder with the string option's type added
 	*/
 	addStringOption(option) {
-		let newOption = new StringOption();
-		newOption = option(newOption);
-		this.options.push(newOption);
+		const configuredOption = option(new StringOption());
+		this.options.push(configuredOption);
 		return this;
 	}
 	/**
 	* Add a boolean option to the configuration builder and return the builder for chaining. You must provide a name, display name, and description for the option.
-	* @param option { (option: BooleanOption) => BooleanOption }
+	* @param option { (option: BooleanOption) => BooleanOption<K> }
+	* @returns A new ConfigurationBuilder with the boolean option's type added
 	*/
 	addBooleanOption(option) {
-		let newOption = new BooleanOption();
-		newOption = option(newOption);
-		this.options.push(newOption);
+		const configuredOption = option(new BooleanOption());
+		this.options.push(configuredOption);
+		return this;
+	}
+	/**
+	* Add an action option to the configuration builder and return the builder for chaining. 
+	* Action options contribute a boolean to the return type (true if clicked, false if not).
+	* You must provide a name, display name, and description for the option.
+	* @param option { (option: ActionOption) => ActionOption<K> }
+	* @returns A new ConfigurationBuilder with the action option's type added as boolean
+	*/
+	addActionOption(option) {
+		const configuredOption = option(new ActionOption());
+		this.options.push(configuredOption);
 		return this;
 	}
 	build(includeFunctions) {
@@ -109,6 +130,14 @@ var StringOption = class extends ConfigurationOption {
 	inputType = "text";
 	type = "string";
 	/**
+	* Set the name of the option. **REQUIRED**
+	* @param name {string} The name of the option. This is used to reference the option in the configuration file.
+	*/
+	setName(name) {
+		this.name = name;
+		return this;
+	}
+	/**
 	* Set the allowed values for the string. If the array is empty, any value is allowed. When provided, the client will act like this option is a dropdown.
 	* @param allowedValues {string[]} An array of allowed values for the string. If the array is empty, any value is allowed.
 	*/
@@ -162,6 +191,14 @@ var NumberOption = class extends ConfigurationOption {
 	type = "number";
 	inputType = "number";
 	/**
+	* Set the name of the option. **REQUIRED**
+	* @param name {string} The name of the option. This is used to reference the option in the configuration file.
+	*/
+	setName(name) {
+		this.name = name;
+		return this;
+	}
+	/**
 	* Set the minimum value for the number. If the user provides a number that is less than this value, the validation will fail.
 	* @param min {number} The minimum value for the number.
 	*/
@@ -203,6 +240,14 @@ var BooleanOption = class extends ConfigurationOption {
 	type = "boolean";
 	defaultValue = false;
 	/**
+	* Set the name of the option. **REQUIRED**
+	* @param name {string} The name of the option. This is used to reference the option in the configuration file.
+	*/
+	setName(name) {
+		this.name = name;
+		return this;
+	}
+	/**
 	* Set the default value for the boolean. This value will be used if the user does not provide a value. **HIGHLY RECOMMENDED**
 	* @param defaultValue {boolean} The default value for the boolean.
 	*/
@@ -215,7 +260,48 @@ var BooleanOption = class extends ConfigurationOption {
 		return [true, ""];
 	}
 };
+var ActionOption = class extends ConfigurationOption {
+	type = "action";
+	manifest = {};
+	buttonText = "Run";
+	taskName = "";
+	/**
+	* Set the name of the option. **REQUIRED**
+	* @param name {string} The name of the option. This is used to reference the option in the configuration file.
+	*/
+	setName(name) {
+		this.name = name;
+		return this;
+	}
+	/**
+	* Set the task name that will be used to identify which task handler to run. This should match the name used in `addon.onTask()`.
+	* @param taskName {string} The task name to identify the handler.
+	*/
+	setTaskName(taskName) {
+		this.taskName = taskName;
+		return this;
+	}
+	/**
+	* Set the manifest object that will be passed to the task-run handler. The task name should be set via setTaskName() rather than in the manifest.
+	* @param manifest {Record<string, unknown>} The manifest object to pass to the task handler.
+	*/
+	setManifest(manifest) {
+		this.manifest = manifest;
+		return this;
+	}
+	/**
+	* Set the text displayed on the action button.
+	* @param text {string} The button text.
+	*/
+	setButtonText(text) {
+		this.buttonText = text;
+		return this;
+	}
+	validate(_input) {
+		return [true, ""];
+	}
+};
 
 //#endregion
-export { BooleanOption, ConfigurationBuilder, ConfigurationOption, NumberOption, StringOption, isBooleanOption, isNumberOption, isStringOption };
+export { ActionOption, BooleanOption, ConfigurationBuilder, ConfigurationOption, NumberOption, StringOption, isActionOption, isBooleanOption, isNumberOption, isStringOption };
 //# sourceMappingURL=ConfigurationBuilder.mjs.map

package/build/config/ConfigurationBuilder.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ConfigurationBuilder.mjs","names":[],"sources":["../../src/config/ConfigurationBuilder.ts"],"sourcesContent":["import z, { ZodError } from 'zod';\n\nexport interface ConfigurationFile {\n  [key: string]: ConfigurationOption;\n}\n\nconst configValidation = z.object({\n  name: z.string().min(1),\n  displayName: z.string().min(1),\n  description: z.string().min(1),\n});\n\nexport function isStringOption(\n  option: ConfigurationOption\n): option is StringOption {\n  return option.type === 'string';\n}\n\nexport function isNumberOption(\n  option: ConfigurationOption\n): option is NumberOption {\n  return option.type === 'number';\n}\n\nexport function isBooleanOption(\n  option: ConfigurationOption\n): option is BooleanOption {\n  return option.type === 'boolean';\n}\n\nexport class ConfigurationBuilder {\n  private options: ConfigurationOption[] = [];\n\n  /**\n   * Add a number option to the configuration builder and return the builder for chaining. You must provide a name, display name, and description for the option.\n   * @param option { (option: NumberOption) => NumberOption }\n   * @returns\n   */\n  public addNumberOption(\n    option: (option: NumberOption) => NumberOption\n  ): ConfigurationBuilder {\n    let newOption = new NumberOption();\n    newOption = option(newOption);\n    this.options.push(newOption);\n    return this;\n  }\n\n  /**\n   * Add a string option to the configuration builder and return the builder for chaining. You must provide a name, display name, and description for the option.\n   * @param option { (option: StringOption) => StringOption }\n   */\n  public addStringOption(option: (option: StringOption) => StringOption) {\n    let newOption = new StringOption();\n    newOption = option(newOption);\n    this.options.push(newOption);\n    return this;\n  }\n\n  /**\n   * Add a boolean option to the configuration builder and return the builder for chaining. You must provide a name, display name, and description for the option.\n   * @param option { (option: BooleanOption) => BooleanOption }\n   */\n  public addBooleanOption(option: (option: BooleanOption) => BooleanOption) {\n    let newOption = new BooleanOption();\n    newOption = option(newOption);\n    this.options.push(newOption);\n    return this;\n  }\n\n  public build(includeFunctions: boolean): ConfigurationFile {\n    let config: ConfigurationFile = {};\n    this.options.forEach((option) => {\n      // remove all functions from the option object\n      if (!includeFunctions) {\n        option = JSON.parse(JSON.stringify(option));\n        const optionData = configValidation.safeParse(option);\n        if (!optionData.success) {\n          throw new ZodError(optionData.error.errors);\n        }\n\n        config[option.name] = option;\n      } else {\n        config[option.name] = option;\n      }\n    });\n    return config;\n  }\n}\n\nexport type ConfigurationOptionType = 'string' | 'number' | 'boolean' | 'unset';\nexport class ConfigurationOption {\n  public name: string = '';\n  public defaultValue: unknown = '';\n  public displayName: string = '';\n  public description: string = '';\n  public type: ConfigurationOptionType = 'unset';\n\n  /**\n   * Set the name of the option. **REQUIRED**\n   * @param name {string} The name of the option. This is used to reference the option in the configuration file.\n   */\n  setName(name: string) {\n    this.name = name;\n    return this;\n  }\n\n  /**\n   * Set the display name of the option. This is used to show the user a human readable version of what the option is. **REQUIRED**\n   * @param displayName {string} The display name of the option.\n   * @returns\n   */\n  setDisplayName(displayName: string) {\n    this.displayName = displayName;\n    return this;\n  }\n\n  /**\n   * Set the description of the option. This is to show the user a brief description of what this option does. **REQUIRED**\n   * @param description {string} The description of the option.\n   * @returns\n   */\n  setDescription(description: string) {\n    this.description = description;\n    return this;\n  }\n\n  /**\n   * Validation code for the option. This is called when the user provides input to the option. If the validation fails, the user will be prompted to provide input again.\n   * @param input {unknown} The input to validate\n   */\n  validate(input: unknown): [boolean, string] {\n    throw new Error('Validation code not implemented. Value: ' + input);\n  }\n}\n\nexport class StringOption extends ConfigurationOption {\n  public allowedValues: string[] = [];\n  public minTextLength: number = 0;\n  public maxTextLength: number = Number.MAX_SAFE_INTEGER;\n  public defaultValue: string = '';\n  public inputType: 'text' | 'file' | 'password' | 'folder' = 'text';\n  public type: ConfigurationOptionType = 'string';\n\n  /**\n   * Set the allowed values for the string. If the array is empty, any value is allowed. When provided, the client will act like this option is a dropdown.\n   * @param allowedValues {string[]} An array of allowed values for the string. If the array is empty, any value is allowed.\n   */\n  setAllowedValues(allowedValues: string[]): this {\n    this.allowedValues = allowedValues;\n    return this;\n  }\n\n  /**\n   * Set the default value for the string. This value will be used if the user does not provide a value. **HIGHLY RECOMMENDED**\n   * @param defaultValue {string} The default value for the string.\n   */\n  setDefaultValue(defaultValue: string): this {\n    this.defaultValue = defaultValue;\n    return this;\n  }\n\n  /**\n   * Set the minimum text length for the string. If the user provides a string that is less than this value, the validation will fail.\n   * @param minTextLength {number} The minimum text length for the string.\n   */\n  setMinTextLength(minTextLength: number): this {\n    this.minTextLength = minTextLength;\n    return this;\n  }\n\n  /**\n   * Set the maximum text length for the string. If the user provides a string that is greater than this value, the validation will fail.\n   * @param maxTextLength {number} The maximum text length for the string.\n   */\n  setMaxTextLength(maxTextLength: number): this {\n    this.maxTextLength = maxTextLength;\n    return this;\n  }\n\n  /**\n   * Set the input type for the string. This will change how the client renders the input.\n   * @param inputType {'text' | 'file' | 'password' | 'folder'} The input type for the string.\n   */\n  setInputType(inputType: 'text' | 'file' | 'password' | 'folder'): this {\n    this.inputType = inputType;\n    return this;\n  }\n\n  override validate(input: unknown): [boolean, string] {\n    if (typeof input !== 'string') {\n      return [false, 'Input is not a string'];\n    }\n    if (this.allowedValues.length === 0 && input.length !== 0)\n      return [true, ''];\n    if (\n      input.length < this.minTextLength ||\n      input.length > this.maxTextLength\n    ) {\n      return [\n        false,\n        'Input is not within the text length ' +\n          this.minTextLength +\n          ' and ' +\n          this.maxTextLength +\n          ' characters (currently ' +\n          input.length +\n          ' characters)',\n      ];\n    }\n\n    return [\n      this.allowedValues.includes(input),\n      'Input is not an allowed value',\n    ];\n  }\n}\n\nexport class NumberOption extends ConfigurationOption {\n  public min: number = 0;\n  public max: number = Number.MAX_SAFE_INTEGER;\n  public defaultValue: number = 0;\n  public type: ConfigurationOptionType = 'number';\n  public inputType: 'range' | 'number' = 'number';\n\n  /**\n   * Set the minimum value for the number. If the user provides a number that is less than this value, the validation will fail.\n   * @param min {number} The minimum value for the number.\n   */\n  setMin(min: number): this {\n    this.min = min;\n    return this;\n  }\n\n  /**\n   * Set the input type for the number. This will change how the client renders the input.\n   * @param type {'range' | 'number'} The input type for the number.\n   */\n  setInputType(type: 'range' | 'number'): this {\n    this.inputType = type;\n    return this;\n  }\n\n  /**\n   * Set the maximum value for the number. If the user provides a number that is greater than this value, the validation will fail.\n   * @param max {number} The maximum value for the number.\n   */\n  setMax(max: number): this {\n    this.max = max;\n    return this;\n  }\n\n  /**\n   * Set the default value for the number. This value will be used if the user does not provide a value. **HIGHLY RECOMMENDED**\n   * @param defaultValue {number} The default value for the number.\n   */\n  setDefaultValue(defaultValue: number): this {\n    this.defaultValue = defaultValue;\n    return this;\n  }\n\n  override validate(input: unknown): [boolean, string] {\n    if (isNaN(Number(input))) {\n      return [false, 'Input is not a number'];\n    }\n    if (Number(input) < this.min || Number(input) > this.max) {\n      return [\n        false,\n        'Input is not within the range of ' + this.min + ' and ' + this.max,\n      ];\n    }\n    return [true, ''];\n  }\n}\n\nexport class BooleanOption extends ConfigurationOption {\n  public type: ConfigurationOptionType = 'boolean';\n  public defaultValue: boolean = false;\n\n  /**\n   * Set the default value for the boolean. This value will be used if the user does not provide a value. **HIGHLY RECOMMENDED**\n   * @param defaultValue {boolean} The default value for the boolean.\n   */\n  setDefaultValue(defaultValue: boolean): this {\n    this.defaultValue = defaultValue;\n    return this;\n  }\n\n  override validate(input: unknown): [boolean, string] {\n    if (typeof input !== 'boolean') {\n      return [false, 'Input is not a boolean'];\n    }\n    return [true, ''];\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"ConfigurationBuilder.mjs","names":[],"sources":["../../src/config/ConfigurationBuilder.ts"],"sourcesContent":["import z, { ZodError } from 'zod';\n\nexport interface ConfigurationFile {\n  [key: string]: ConfigurationOption<string>;\n}\n\nconst configValidation = z.object({\n  name: z.string().min(1),\n  displayName: z.string().min(1),\n  description: z.string().min(1),\n});\n\nexport function isStringOption<N extends string = string>(\n  option: ConfigurationOption<N>\n): option is StringOption<N> {\n  return option.type === 'string';\n}\n\nexport function isNumberOption<N extends string = string>(\n  option: ConfigurationOption<N>\n): option is NumberOption<N> {\n  return option.type === 'number';\n}\n\nexport function isBooleanOption<N extends string = string>(\n  option: ConfigurationOption<N>\n): option is BooleanOption<N> {\n  return option.type === 'boolean';\n}\n\nexport function isActionOption<N extends string = string>(\n  option: ConfigurationOption<N>\n): option is ActionOption<N> {\n  return option.type === 'action';\n}\n\n/**\n * A builder for creating configuration screens. The generic type T accumulates\n * the types of all options added to the builder, enabling type-safe access to\n * the configuration values.\n * \n * @template T - The accumulated type of all configuration options\n */\nexport class ConfigurationBuilder<\n  T extends Record<string, string | number | boolean> = {}\n> {\n  private options: ConfigurationOption<string>[] = [];\n\n  /**\n   * Add a number option to the configuration builder and return the builder for chaining. You must provide a name, display name, and description for the option.\n   * @param option { (option: NumberOption) => NumberOption<K> }\n   * @returns A new ConfigurationBuilder with the number option's type added\n   */\n  public addNumberOption<K extends string>(\n    option: (option: NumberOption) => NumberOption<K>\n  ): ConfigurationBuilder<T & { [P in K]: number }> {\n    let newOption = new NumberOption();\n    const configuredOption = option(newOption);\n    this.options.push(configuredOption);\n    return this as unknown as ConfigurationBuilder<T & { [P in K]: number }>;\n  }\n\n  /**\n   * Add a string option to the configuration builder and return the builder for chaining. You must provide a name, display name, and description for the option.\n   * @param option { (option: StringOption) => StringOption<K> }\n   * @returns A new ConfigurationBuilder with the string option's type added\n   */\n  public addStringOption<K extends string>(\n    option: (option: StringOption) => StringOption<K>\n  ): ConfigurationBuilder<T & { [P in K]: string }> {\n    let newOption = new StringOption();\n    const configuredOption = option(newOption);\n    this.options.push(configuredOption);\n    return this as unknown as ConfigurationBuilder<T & { [P in K]: string }>;\n  }\n\n  /**\n   * Add a boolean option to the configuration builder and return the builder for chaining. You must provide a name, display name, and description for the option.\n   * @param option { (option: BooleanOption) => BooleanOption<K> }\n   * @returns A new ConfigurationBuilder with the boolean option's type added\n   */\n  public addBooleanOption<K extends string>(\n    option: (option: BooleanOption) => BooleanOption<K>\n  ): ConfigurationBuilder<T & { [P in K]: boolean }> {\n    let newOption = new BooleanOption();\n    const configuredOption = option(newOption);\n    this.options.push(configuredOption);\n    return this as unknown as ConfigurationBuilder<T & { [P in K]: boolean }>;\n  }\n\n  /**\n   * Add an action option to the configuration builder and return the builder for chaining. \n   * Action options contribute a boolean to the return type (true if clicked, false if not).\n   * You must provide a name, display name, and description for the option.\n   * @param option { (option: ActionOption) => ActionOption<K> }\n   * @returns A new ConfigurationBuilder with the action option's type added as boolean\n   */\n  public addActionOption<K extends string>(\n    option: (option: ActionOption) => ActionOption<K>\n  ): ConfigurationBuilder<T & { [P in K]: boolean }> {\n    let newOption = new ActionOption();\n    const configuredOption = option(newOption);\n    this.options.push(configuredOption);\n    return this as unknown as ConfigurationBuilder<T & { [P in K]: boolean }>;\n  }\n\n  public build(includeFunctions: boolean): ConfigurationFile {\n    let config: ConfigurationFile = {};\n    this.options.forEach((option) => {\n      // remove all functions from the option object\n      if (!includeFunctions) {\n        option = JSON.parse(JSON.stringify(option));\n        const optionData = configValidation.safeParse(option);\n        if (!optionData.success) {\n          throw new ZodError(optionData.error.errors);\n        }\n\n        config[option.name] = option;\n      } else {\n        config[option.name] = option;\n      }\n    });\n    return config;\n  }\n}\n\nexport type ConfigurationOptionType =\n  | 'string'\n  | 'number'\n  | 'boolean'\n  | 'action'\n  | 'unset';\nexport class ConfigurationOption<N extends string = string> {\n  public name: N = '' as N;\n  public defaultValue: unknown = '';\n  public displayName: string = '';\n  public description: string = '';\n  public type: ConfigurationOptionType = 'unset';\n\n  /**\n   * Set the name of the option. **REQUIRED**\n   * @param name {string} The name of the option. This is used to reference the option in the configuration file.\n   */\n  setName<K extends string>(name: K): ConfigurationOption<K> {\n    this.name = name as unknown as N;\n    return this as unknown as ConfigurationOption<K>;\n  }\n\n  /**\n   * Set the display name of the option. This is used to show the user a human readable version of what the option is. **REQUIRED**\n   * @param displayName {string} The display name of the option.\n   * @returns\n   */\n  setDisplayName(displayName: string): this {\n    this.displayName = displayName;\n    return this;\n  }\n\n  /**\n   * Set the description of the option. This is to show the user a brief description of what this option does. **REQUIRED**\n   * @param description {string} The description of the option.\n   * @returns\n   */\n  setDescription(description: string): this {\n    this.description = description;\n    return this;\n  }\n\n  /**\n   * Validation code for the option. This is called when the user provides input to the option. If the validation fails, the user will be prompted to provide input again.\n   * @param input {unknown} The input to validate\n   */\n  validate(input: unknown): [boolean, string] {\n    throw new Error('Validation code not implemented. Value: ' + input);\n  }\n}\n\nexport class StringOption<N extends string = string> extends ConfigurationOption<N> {\n  public allowedValues: string[] = [];\n  public minTextLength: number = 0;\n  public maxTextLength: number = Number.MAX_SAFE_INTEGER;\n  public defaultValue: string = '';\n  public inputType: 'text' | 'file' | 'password' | 'folder' = 'text';\n  public type: ConfigurationOptionType = 'string';\n\n  /**\n   * Set the name of the option. **REQUIRED**\n   * @param name {string} The name of the option. This is used to reference the option in the configuration file.\n   */\n  override setName<K extends string>(name: K): StringOption<K> {\n    this.name = name as unknown as N;\n    return this as unknown as StringOption<K>;\n  }\n\n  /**\n   * Set the allowed values for the string. If the array is empty, any value is allowed. When provided, the client will act like this option is a dropdown.\n   * @param allowedValues {string[]} An array of allowed values for the string. If the array is empty, any value is allowed.\n   */\n  setAllowedValues(allowedValues: string[]): this {\n    this.allowedValues = allowedValues;\n    return this;\n  }\n\n  /**\n   * Set the default value for the string. This value will be used if the user does not provide a value. **HIGHLY RECOMMENDED**\n   * @param defaultValue {string} The default value for the string.\n   */\n  setDefaultValue(defaultValue: string): this {\n    this.defaultValue = defaultValue;\n    return this;\n  }\n\n  /**\n   * Set the minimum text length for the string. If the user provides a string that is less than this value, the validation will fail.\n   * @param minTextLength {number} The minimum text length for the string.\n   */\n  setMinTextLength(minTextLength: number): this {\n    this.minTextLength = minTextLength;\n    return this;\n  }\n\n  /**\n   * Set the maximum text length for the string. If the user provides a string that is greater than this value, the validation will fail.\n   * @param maxTextLength {number} The maximum text length for the string.\n   */\n  setMaxTextLength(maxTextLength: number): this {\n    this.maxTextLength = maxTextLength;\n    return this;\n  }\n\n  /**\n   * Set the input type for the string. This will change how the client renders the input.\n   * @param inputType {'text' | 'file' | 'password' | 'folder'} The input type for the string.\n   */\n  setInputType(inputType: 'text' | 'file' | 'password' | 'folder'): this {\n    this.inputType = inputType;\n    return this;\n  }\n\n  override validate(input: unknown): [boolean, string] {\n    if (typeof input !== 'string') {\n      return [false, 'Input is not a string'];\n    }\n    if (this.allowedValues.length === 0 && input.length !== 0)\n      return [true, ''];\n    if (\n      input.length < this.minTextLength ||\n      input.length > this.maxTextLength\n    ) {\n      return [\n        false,\n        'Input is not within the text length ' +\n          this.minTextLength +\n          ' and ' +\n          this.maxTextLength +\n          ' characters (currently ' +\n          input.length +\n          ' characters)',\n      ];\n    }\n\n    return [\n      this.allowedValues.includes(input),\n      'Input is not an allowed value',\n    ];\n  }\n}\n\nexport class NumberOption<N extends string = string> extends ConfigurationOption<N> {\n  public min: number = 0;\n  public max: number = Number.MAX_SAFE_INTEGER;\n  public defaultValue: number = 0;\n  public type: ConfigurationOptionType = 'number';\n  public inputType: 'range' | 'number' = 'number';\n\n  /**\n   * Set the name of the option. **REQUIRED**\n   * @param name {string} The name of the option. This is used to reference the option in the configuration file.\n   */\n  override setName<K extends string>(name: K): NumberOption<K> {\n    this.name = name as unknown as N;\n    return this as unknown as NumberOption<K>;\n  }\n\n  /**\n   * Set the minimum value for the number. If the user provides a number that is less than this value, the validation will fail.\n   * @param min {number} The minimum value for the number.\n   */\n  setMin(min: number): this {\n    this.min = min;\n    return this;\n  }\n\n  /**\n   * Set the input type for the number. This will change how the client renders the input.\n   * @param type {'range' | 'number'} The input type for the number.\n   */\n  setInputType(type: 'range' | 'number'): this {\n    this.inputType = type;\n    return this;\n  }\n\n  /**\n   * Set the maximum value for the number. If the user provides a number that is greater than this value, the validation will fail.\n   * @param max {number} The maximum value for the number.\n   */\n  setMax(max: number): this {\n    this.max = max;\n    return this;\n  }\n\n  /**\n   * Set the default value for the number. This value will be used if the user does not provide a value. **HIGHLY RECOMMENDED**\n   * @param defaultValue {number} The default value for the number.\n   */\n  setDefaultValue(defaultValue: number): this {\n    this.defaultValue = defaultValue;\n    return this;\n  }\n\n  override validate(input: unknown): [boolean, string] {\n    if (isNaN(Number(input))) {\n      return [false, 'Input is not a number'];\n    }\n    if (Number(input) < this.min || Number(input) > this.max) {\n      return [\n        false,\n        'Input is not within the range of ' + this.min + ' and ' + this.max,\n      ];\n    }\n    return [true, ''];\n  }\n}\n\nexport class BooleanOption<N extends string = string> extends ConfigurationOption<N> {\n  public type: ConfigurationOptionType = 'boolean';\n  public defaultValue: boolean = false;\n\n  /**\n   * Set the name of the option. **REQUIRED**\n   * @param name {string} The name of the option. This is used to reference the option in the configuration file.\n   */\n  override setName<K extends string>(name: K): BooleanOption<K> {\n    this.name = name as unknown as N;\n    return this as unknown as BooleanOption<K>;\n  }\n\n  /**\n   * Set the default value for the boolean. This value will be used if the user does not provide a value. **HIGHLY RECOMMENDED**\n   * @param defaultValue {boolean} The default value for the boolean.\n   */\n  setDefaultValue(defaultValue: boolean): this {\n    this.defaultValue = defaultValue;\n    return this;\n  }\n\n  override validate(input: unknown): [boolean, string] {\n    if (typeof input !== 'boolean') {\n      return [false, 'Input is not a boolean'];\n    }\n    return [true, ''];\n  }\n}\n\nexport class ActionOption<N extends string = string> extends ConfigurationOption<N> {\n  public type: ConfigurationOptionType = 'action';\n  public manifest: Record<string, unknown> = {};\n  public buttonText: string = 'Run';\n  public taskName: string = '';\n\n  /**\n   * Set the name of the option. **REQUIRED**\n   * @param name {string} The name of the option. This is used to reference the option in the configuration file.\n   */\n  override setName<K extends string>(name: K): ActionOption<K> {\n    this.name = name as unknown as N;\n    return this as unknown as ActionOption<K>;\n  }\n\n  /**\n   * Set the task name that will be used to identify which task handler to run. This should match the name used in `addon.onTask()`.\n   * @param taskName {string} The task name to identify the handler.\n   */\n  setTaskName(taskName: string): this {\n    this.taskName = taskName;\n    return this;\n  }\n\n  /**\n   * Set the manifest object that will be passed to the task-run handler. The task name should be set via setTaskName() rather than in the manifest.\n   * @param manifest {Record<string, unknown>} The manifest object to pass to the task handler.\n   */\n  setManifest(manifest: Record<string, unknown>): this {\n    this.manifest = manifest;\n    return this;\n  }\n\n  /**\n   * Set the text displayed on the action button.\n   * @param text {string} The button text.\n   */\n  setButtonText(text: string): this {\n    this.buttonText = text;\n    return this;\n  }\n\n  override validate(_input: unknown): [boolean, string] {\n    return [true, ''];\n  }\n}\n"],"mappings":"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"}

package/build/main.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, '__esModule', { value: true });
-const require_ConfigurationBuilder = require('./ConfigurationBuilder-BSuJ4rSI.cjs');
+const require_ConfigurationBuilder = require('./ConfigurationBuilder-CFXi6UwU.cjs');
 const require_EventResponse = require('./EventResponse.cjs');
 const require_config_Configuration = require('./config/Configuration.cjs');
 let ws = require("ws");
@@ -14,7 +14,7 @@ let node_fs = require("node:fs");
 node_fs = require_ConfigurationBuilder.__toESM(node_fs);
 
 //#region package.json
-var version = "1.9.4";
+var version = "2.0.0";
 
 //#endregion
 //#region src/main.ts
@@ -42,6 +42,7 @@ var OGIAddon = class {
 	config = new require_config_Configuration.Configuration({});
 	eventsAvailable = [];
 	registeredConnectEvent = false;
+	taskHandlers = /* @__PURE__ */ new Map();
 	constructor(addonInfo) {
 		this.addonInfo = addonInfo;
 		this.addonWSListener = new OGIAddonWSListener(this, this.eventEmitter);
@@ -115,6 +116,40 @@ var OGIAddon = class {
 		return task;
 	}
 	/**
+	* Register a task handler for a specific task name. The task name should match the taskName field in SearchResult or ActionOption.
+	* @param taskName {string} The name of the task (should match taskName in SearchResult or ActionOption.setTaskName()).
+	* @param handler {(task: Task, data: { manifest: Record<string, unknown>; downloadPath: string; name: string }) => Promise<void> | void} The handler function.
+	* @example
+	* ```typescript
+	* addon.onTask('clearCache', async (task) => {
+	*   task.log('Clearing cache...');
+	*   task.setProgress(50);
+	*   await clearCacheFiles();
+	*   task.setProgress(100);
+	*   task.complete();
+	* });
+	* ```
+	*/
+	onTask(taskName, handler) {
+		this.taskHandlers.set(taskName, handler);
+	}
+	/**
+	* Check if a task handler is registered for the given task name.
+	* @param taskName {string} The task name to check.
+	* @returns {boolean} True if a handler is registered.
+	*/
+	hasTaskHandler(taskName) {
+		return this.taskHandlers.has(taskName);
+	}
+	/**
+	* Get a task handler for the given task name.
+	* @param taskName {string} The task name.
+	* @returns The handler function or undefined if not found.
+	*/
+	getTaskHandler(taskName) {
+		return this.taskHandlers.get(taskName);
+	}
+	/**
 	* Extract a file using 7-Zip on Windows, unzip on Linux/Mac.
 	* @param path {string}
 	* @param outputPath {string}
@@ -237,6 +272,57 @@ var CustomTask = class {
 	}
 };
 /**
+* A cleaner API wrapper around EventResponse for task handlers.
+* Provides chainable methods for logging, progress updates, and completion.
+*/
+var Task = class {
+	event;
+	constructor(event) {
+		this.event = event;
+		this.event.defer();
+	}
+	/**
+	* Log a message to the task. Returns this for chaining.
+	* @param message {string} The message to log.
+	*/
+	log(message) {
+		this.event.log(message);
+		return this;
+	}
+	/**
+	* Set the progress of the task (0-100). Returns this for chaining.
+	* @param progress {number} The progress value (0-100).
+	*/
+	setProgress(progress) {
+		this.event.progress = progress;
+		return this;
+	}
+	/**
+	* Complete the task successfully.
+	*/
+	complete() {
+		this.event.complete();
+	}
+	/**
+	* Fail the task with an error message.
+	* @param message {string} The error message.
+	*/
+	fail(message) {
+		this.event.fail(message);
+	}
+	/**
+	* Ask the user for input using a ConfigurationBuilder screen.
+	* The return type is inferred from the ConfigurationBuilder's accumulated option types.
+	* @param name {string} The name/title of the input prompt.
+	* @param description {string} The description of what input is needed.
+	* @param screen {ConfigurationBuilder<U>} The configuration builder for the input form.
+	* @returns {Promise<U>} The user's input with types matching the configuration options.
+	*/
+	async askForInput(name, description, screen) {
+		return this.event.askForInput(name, description, screen);
+	}
+};
+/**
 * A search tool wrapper over Fuse.js for the OGI Addon. This tool is used to search for items in the library.
 * @example
 * ```typescript
@@ -337,7 +423,7 @@ var OGIAddonWSListener = class {
 	async userInputAsked(configBuilt, name, description, socket) {
 		const config = configBuilt.build(false);
 		const id = Math.random().toString(36).substring(7);
-		if (!socket) return {};
+		if (!socket) throw new Error("Socket is not connected");
 		socket.send(JSON.stringify({
 			event: "input-asked",
 			args: {
@@ -431,19 +517,34 @@ var OGIAddonWSListener = class {
 					break;
 				case "task-run": {
 					let taskRunEvent = new require_EventResponse((screen, name, description) => this.userInputAsked(screen, name, description, this.socket));
-					this.eventEmitter.emit("task-run", message.args, taskRunEvent);
-					const interval = setInterval(() => {
-						if (taskRunEvent.resolved) {
+					const taskName = message.args.taskName && typeof message.args.taskName === "string" ? message.args.taskName : message.args.manifest && typeof message.args.manifest === "object" ? message.args.manifest.__taskName : void 0;
+					if (taskName && typeof taskName === "string" && this.addon.hasTaskHandler(taskName)) {
+						const handler = this.addon.getTaskHandler(taskName);
+						const task = new Task(taskRunEvent);
+						try {
+							const interval = setInterval(() => {
+								if (taskRunEvent.resolved) {
+									clearInterval(interval);
+									return;
+								}
+								this.send("defer-update", {
+									logs: taskRunEvent.logs,
+									deferID: message.args.deferID,
+									progress: taskRunEvent.progress,
+									failed: taskRunEvent.failed
+								});
+							}, 100);
+							const result$1 = handler(task, {
+								manifest: message.args.manifest || {},
+								downloadPath: message.args.downloadPath || "",
+								name: message.args.name || ""
+							});
+							if (result$1 instanceof Promise) await result$1;
 							clearInterval(interval);
-							return;
+						} catch (error) {
+							taskRunEvent.fail(error instanceof Error ? error.message : String(error));
 						}
-						this.send("defer-update", {
-							logs: taskRunEvent.logs,
-							deferID: message.args.deferID,
-							progress: taskRunEvent.progress,
-							failed: taskRunEvent.failed
-						});
-					}, 100);
+					} else 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;
@@ -516,6 +617,7 @@ exports.ConfigurationBuilder = require_ConfigurationBuilder.ConfigurationBuilder
 exports.CustomTask = CustomTask;
 exports.EventResponse = require_EventResponse;
 exports.SearchTool = SearchTool;
+exports.Task = Task;
 exports.VERSION = VERSION;
 exports.ZodLibraryInfo = ZodLibraryInfo;
 exports.default = OGIAddon;