Class PluginDependencyError

Tagged error for plugin-level dependency resolution failures.

context.id is the plugin id the manager was acting on. context.reason discriminates the failure mode:

'missing' — declared dep is neither registered nor in the catalog. context.missing lists offending ids.
'install-failed' — dep was found in the catalog but add() failed. cause carries the original error.
'cycle' — closure walk detected a cycle. context.path is the cycle path.
'core-dependent' — cascade-disable would have to disable a core plugin. context.coreDependent is the blocking id.

Hierarchy

{
    cause?: unknown;
    context: Record<string, unknown>;
    name: "PluginDependencyError";
    stack?: string;
    get _tag(): Name;
    get message(): string;
}
- PluginDependencyError

Index

Constructors

constructor

new PluginDependencyError(options?: BaseErrorOptions): PluginDependencyError
Parameters
- Optionaloptions: BaseErrorOptions
Returns PluginDependencyError
Inherited from BaseError.extend( 'PluginDependencyError', 'Plugin dependency resolution failed', ).constructor
- Defined in packages/common/errors/dist/types/src/base.d.ts:25

Properties

`Optional`cause

cause?: unknown

context

context: Record<string, unknown>

name

name: "PluginDependencyError"

`Optional`stack

stack?: string

`Static`name

name: "PluginDependencyError"

`Static` `Optional`prepareStackTrace

prepareStackTrace?: (err: Error, stackTraces: CallSite[]) => any

`Static`stackTraceLimit

stackTraceLimit: number

Accessors

_tag

get _tag(): Name
Returns Name
Inherited from BaseError.extend( 'PluginDependencyError', 'Plugin dependency resolution failed', )._tag
- Defined in packages/common/errors/dist/types/src/base.d.ts:32

message

get message(): string
Fallback message.

Returns string
Inherited from BaseError.extend( 'PluginDependencyError', 'Plugin dependency resolution failed', ).message
- Defined in packages/common/errors/dist/types/src/base.d.ts:31

Methods

`Static`captureStackTrace

captureStackTrace(targetObject: object, constructorOpt?: Function): void
Parameters
- targetObject: object
- OptionalconstructorOpt: Function
Returns void
Inherited from BaseError.extend( 'PluginDependencyError', 'Plugin dependency resolution failed', ).captureStackTrace
- Defined in packages/common/errors/dist/types/src/base.d.ts:58

`Static`extend

extend<Name extends string = string>(name: Name, message?: string): any
Type Parameters
- Name extends string = string
Parameters
- name: Name
- Optionalmessage: string
Returns any
Inherited from BaseError.extend( 'PluginDependencyError', 'Plugin dependency resolution failed', ).extend
- Defined in packages/common/errors/dist/types/src/base.d.ts:57

`Static`is

is(error: unknown): error is BaseError<string>
Name equality, not an instanceof, so an error rebuilt from the wire still matches. A subclass that renames itself therefore does NOT match its parent, so define siblings rather than a renaming subclass.
Parameters
- error: unknown
Returns error is BaseError<string>
Inherited from BaseError.extend( 'PluginDependencyError', 'Plugin dependency resolution failed', ).is
- Defined in packages/common/errors/dist/types/src/base.d.ts:41

`Static`isError

isError(error: unknown): error is Error
Parameters
- error: unknown
Returns error is Error
Inherited from BaseError.extend( 'PluginDependencyError', 'Plugin dependency resolution failed', ).isError
- Defined in packages/common/errors/dist/types/src/base.d.ts:34

`Static`wrap

wrap(
    options?: Omit<BaseErrorOptions, "cause"> & { ifTypeDiffers?: boolean },
): (
    error: unknown,
) => {
    cause?: unknown;
    context: Record<string, unknown>;
    name: "PluginDependencyError";
    stack?: string;
    get _tag(): Name;
    get message(): string;
}
Returns a catch/mapError callback that wraps a thrown value in this class.
Parameters
- Optionaloptions: Omit<BaseErrorOptions, "cause"> & { ifTypeDiffers?: boolean }
  - ifTypeDiffers
    Pass an error of this class through untouched.
  - OptionalifTypeDiffers?: boolean
    Pass an error of this class through untouched.
Returns (
    error: unknown,
) => {
    cause?: unknown;
    context: Record<string, unknown>;
    name: "PluginDependencyError";
    stack?: string;
    get _tag(): Name;
    get message(): string;
}
Inherited from BaseError.extend( 'PluginDependencyError', 'Plugin dependency resolution failed', ).wrap
- Defined in packages/common/errors/dist/types/src/base.d.ts:46

Class PluginDependencyError

Hierarchy

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns PluginDependencyError

Properties

Optionalcause

context

name

Optionalstack

Staticname

Static OptionalprepareStackTrace

StaticstackTraceLimit

Accessors

_tag

Returns Name

message

Returns string

Methods

StaticcaptureStackTrace

Parameters

Returns void

Staticextend

Type Parameters

Parameters

Returns any

Staticis

Parameters

Returns error is BaseError<string>

StaticisError

Parameters

Returns error is Error

Staticwrap

Parameters

ifTypeDiffers

OptionalifTypeDiffers?: boolean

Returns ( error: unknown,) => { cause?: unknown; context: Record<string, unknown>; name: "PluginDependencyError"; stack?: string; get _tag(): Name; get message(): string;}

Settings

On This Page

`Optional`cause

`Optional`stack

`Static`name

`Static` `Optional`prepareStackTrace

`Static`stackTraceLimit

`Static`captureStackTrace

`Static`extend

`Static`is

`Static`isError

`Static`wrap

`Optional`ifTypeDiffers?: boolean

Returns (
error: unknown,
) => {
cause?: unknown;
context: Record<string, unknown>;
name: "PluginDependencyError";
stack?: string;
get _tag(): Name;
get message(): string;
}