Error codes
Stable ADDONOVA_* diagnostics, grouped by area.
#Error codes are part of the public interface. Do not rename them in patch
releases. Diagnostics also carry a severity, message, optional location, and an
optional suggestion.
CLI
#
| Code |
Meaning |
ADDONOVA_CLI_INVALID_VALUE |
An option received an invalid value. |
ADDONOVA_CLI_MISSING_VALUE |
An option that requires a value was omitted. |
ADDONOVA_CLI_UNEXPECTED_ARGUMENT |
Unexpected positional argument. |
ADDONOVA_CLI_UNKNOWN_COMMAND |
Unknown command. |
ADDONOVA_CLI_UNKNOWN_OPTION |
Unknown option. |
Configuration
#
| Code |
Meaning |
ADDONOVA_CONFIG_NOT_FOUND |
Explicit configuration file does not exist. |
ADDONOVA_CONFIG_LOAD_FAILED |
Configuration threw during loading. |
ADDONOVA_CONFIG_INVALID |
Configuration shape is invalid. |
ADDONOVA_CONFIG_BROWSER |
Invalid browser target. |
ADDONOVA_CONFIG_BROWSER_API |
Invalid browser API configuration. |
ADDONOVA_CONFIG_ENTRYPOINTS |
Invalid entrypoints configuration. |
ADDONOVA_CONFIG_ENTRYPOINT_MISSING |
Entrypoint file is missing. |
ADDONOVA_CONFIG_DUPLICATE_ENTRYPOINT |
Duplicate output name. |
ADDONOVA_CONFIG_MANIFEST |
Invalid manifest configuration. |
ADDONOVA_CONFIG_HOOKS |
Invalid hooks configuration. |
ADDONOVA_CONFIG_MODULES |
Invalid modules configuration. |
ADDONOVA_CONFIG_PACK |
Invalid pack configuration. |
Build and bundler
#
| Code |
Meaning |
ADDONOVA_BUILD_NO_ENTRYPOINTS |
No entrypoints were found. |
ADDONOVA_BUNDLER_ENTRYPOINT_DUPLICATE |
Duplicate bundler entrypoint. |
ADDONOVA_BUNDLER_ENTRYPOINT_INVALID |
Invalid bundler entrypoint. |
ADDONOVA_BUNDLER_NO_ENTRYPOINTS |
Bundler received no entrypoints. |
ADDONOVA_BUNDLER_FAILED |
Build failed. |
ADDONOVA_BUNDLER_ERROR |
Bundler error. |
ADDONOVA_BUNDLER_WARNING |
Bundler warning. |
ADDONOVA_BUNDLER_SERVICE_FAILED |
Bundler service failed. |
ADDONOVA_GENERATED_ASSET_INVALID |
Hook-generated asset path is invalid. |
ADDONOVA_PUBLIC_SKIPPED |
Public file collided with generated output. |
ADDONOVA_PUBLIC_SYMLINK_SKIPPED |
Public symlink was skipped. |
Manifest
#
| Code |
Meaning |
ADDONOVA_MANIFEST_REQUIRED_FIELD |
Missing name or version. |
ADDONOVA_MANIFEST_INVALID_FIELD |
Invalid manifest field. |
ADDONOVA_MANIFEST_REFERENCE_MISSING |
Referenced file is missing. |
ADDONOVA_MANIFEST_REFERENCE_INVALID |
Referenced path is invalid. |
ADDONOVA_MANIFEST_VERSION |
Invalid or unsupported manifest version. |
ADDONOVA_MANIFEST_DEPRECATED_VERSION |
MV2 is deprecated for the target. |
ADDONOVA_MANIFEST_BACKGROUND_VERSION |
Background shape does not match the version. |
ADDONOVA_MANIFEST_ACTION_VERSION |
action/browser_action mismatch. |
ADDONOVA_MANIFEST_CONTENT_SCRIPT_MATCHES |
Missing or invalid matches. |
ADDONOVA_MANIFEST_CONTENT_SCRIPT_WORLD |
Invalid content script world. |
ADDONOVA_MANIFEST_PERMISSION |
Permission is not valid for the target. |
ADDONOVA_MANIFEST_TARGET_FIELD |
Field is browser-specific. |
ADDONOVA_MANIFEST_OVERRIDE_UNKNOWN |
Unknown URL override. |
ADDONOVA_MANIFEST_SIDEPANEL_UNSUPPORTED |
Side panel not supported by target. |
ADDONOVA_MANIFEST_EXTERNAL_REFERENCE |
External manifest reference. |
ADDONOVA_MANIFEST_CONVERTED |
Field was converted between versions. |
ADDONOVA_MANIFEST_ICON_DISCOVERY |
Icon discovery warning. |
Locales
#
| Code |
Meaning |
ADDONOVA_LOCALES_INVALID |
Locale source is invalid. |
ADDONOVA_LOCALES_DUPLICATE |
Locale is defined by both source layouts. |
ADDONOVA_MANIFEST_DEFAULT_LOCALE |
Missing or invalid default_locale. |
ADDONOVA_MANIFEST_LOCALES_MISSING |
Locales exist but default_locale is missing. |
ADDONOVA_MANIFEST_LOCALE_MESSAGE_MISSING |
__MSG_ key is missing. |
Hooks, modules, and plugins
#
| Code |
Meaning |
ADDONOVA_HOOK_FAILED |
A lifecycle hook threw. |
ADDONOVA_MODULE_LOAD_FAILED |
Module could not be imported. |
ADDONOVA_MODULE_INVALID |
Invalid module default export. |
ADDONOVA_MODULE_SETUP_FAILED |
Module setup threw. |
ADDONOVA_MODULE_DUPLICATE |
Duplicate module name. |
ADDONOVA_PLUGIN_INVALID |
Invalid plugin. |
ADDONOVA_PLUGIN_DUPLICATE_NAME |
Duplicate plugin name. |
ADDONOVA_PLUGIN_BUILD_START_FAILED |
Plugin buildStart failed. |
ADDONOVA_PLUGIN_TRANSFORM_FAILED |
Plugin transform failed. |
ADDONOVA_PLUGIN_BUILD_END_FAILED |
Plugin buildEnd failed. |
Development and browsers
#
| Code |
Meaning |
ADDONOVA_DEV_CONTEXT_UNSUPPORTED |
Dev context could not be created. |
ADDONOVA_DEV_RELOAD_CLIENT_UNAVAILABLE |
Reload client could not be injected. |
ADDONOVA_BROWSER_NOT_FOUND |
No browser executable found. |
ADDONOVA_BROWSER_LAUNCH_FAILED |
Browser failed to launch. |
ADDONOVA_BROWSER_EXTENSION_LOAD_FAILED |
Extension could not be loaded. |
ADDONOVA_BROWSER_ARG_IGNORED |
Conflicting browser argument ignored. |
ADDONOVA_BROWSER_API_NOT_FOUND |
@addonova/browser is missing in bundle mode. |
ADDONOVA_WEB_EXT_CONFIG_INVALID |
webExt configuration is invalid. |
Init
#
| Code |
Meaning |
ADDONOVA_INIT_DIRECTORY_INVALID |
Invalid target directory. |
ADDONOVA_INIT_DIRECTORY_NOT_EMPTY |
Target directory has files. |
ADDONOVA_INIT_TEMPLATE_INVALID |
Invalid template source. |
ADDONOVA_INIT_TEMPLATE_UNKNOWN |
Unknown template. |
ADDONOVA_INIT_TEMPLATES_MISSING |
Bundled templates are missing. |
ADDONOVA_INIT_DOWNLOAD_FAILED |
Remote template download failed. |
ADDONOVA_INIT_OFFLINE |
Remote template requested offline. |
Clean, pack, analyze, doctor
#
| Code |
Meaning |
ADDONOVA_CLEAN_UNSAFE_OUTDIR |
Output directory is unsafe to remove. |
ADDONOVA_PACK_EMPTY |
Nothing to pack. |
ADDONOVA_PACK_FAILED |
Packing failed. |
ADDONOVA_PACK_WARNING |
Packing warning. |
ADDONOVA_PACK_OUTPUT_MISSING |
Build output is missing. |
ADDONOVA_PACK_OUTPUT_EXISTS |
Archive exists and overwrite is off. |
ADDONOVA_PACK_MANIFEST_EXCLUDED |
Filters remove manifest.json. |
ADDONOVA_PACK_OUTFILE_AMBIGUOUS |
outFile used with multiple targets. |
ADDONOVA_PACK_SOURCES_EMPTY |
No source files matched. |
ADDONOVA_PACK_SOURCES_FAILED |
Source archive failed. |
ADDONOVA_PACK_SOURCES_MISSING |
Source root is missing. |
ADDONOVA_PACK_SOURCES_UNSUPPORTED |
Sources requested without Firefox. |
ADDONOVA_ANALYZE_FAILED |
Analysis failed. |
ADDONOVA_NODE_RANGE |
Node.js version is outside the supported range. |
ADDONOVA_UNKNOWN |
Unexpected error. |
Diagnostic shape
#interface Diagnostic {
code: string;
severity: 'error' | 'warning' | 'info';
message: string;
location?: { file?: string; line?: number; column?: number };
suggestion?: string;
}
Use isAddonovaError() and toDiagnostic() from addonova when handling
errors in integrations.
Edit this page on GitHub