@serve.zone/dcrouter 11.0.40 → 11.0.44
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist_serve/bundle.js +1 -1
- package/dist_ts_web/00_commitinfo_data.js +1 -1
- package/package.json +2 -2
- package/ts/00_commitinfo_data.ts +1 -1
- package/ts_web/00_commitinfo_data.ts +1 -1
- package/dist_ts/config/classes.api-token-manager.d.ts +0 -46
- package/dist_ts/config/classes.api-token-manager.js +0 -150
- package/dist_ts/config/classes.route-config-manager.d.ts +0 -35
- package/dist_ts/config/classes.route-config-manager.js +0 -231
- package/dist_ts/config/index.d.ts +0 -3
- package/dist_ts/config/index.js +0 -5
- package/dist_ts/config/validator.d.ts +0 -104
- package/dist_ts/config/validator.js +0 -152
- package/dist_ts/errors/base.errors.d.ts +0 -224
- package/dist_ts/errors/base.errors.js +0 -320
- package/dist_ts/errors/error.codes.d.ts +0 -115
- package/dist_ts/errors/error.codes.js +0 -136
- package/dist_ts/monitoring/classes.metricsmanager.d.ts +0 -178
- package/dist_ts/monitoring/classes.metricsmanager.js +0 -642
- package/dist_ts/monitoring/index.d.ts +0 -1
- package/dist_ts/monitoring/index.js +0 -2
- package/dist_ts/opsserver/classes.opsserver.d.ts +0 -37
- package/dist_ts/opsserver/classes.opsserver.js +0 -85
- package/dist_ts/opsserver/handlers/api-token.handler.d.ts +0 -6
- package/dist_ts/opsserver/handlers/api-token.handler.js +0 -62
- package/dist_ts/opsserver/handlers/certificate.handler.d.ts +0 -32
- package/dist_ts/opsserver/handlers/certificate.handler.js +0 -421
- package/dist_ts/opsserver/handlers/email-ops.handler.d.ts +0 -30
- package/dist_ts/opsserver/handlers/email-ops.handler.js +0 -227
- package/dist_ts/opsserver/handlers/index.d.ts +0 -11
- package/dist_ts/opsserver/handlers/index.js +0 -12
- package/dist_ts/opsserver/handlers/radius.handler.d.ts +0 -6
- package/dist_ts/opsserver/handlers/radius.handler.js +0 -295
- package/dist_ts/opsserver/handlers/remoteingress.handler.d.ts +0 -6
- package/dist_ts/opsserver/handlers/remoteingress.handler.js +0 -156
- package/dist_ts/opsserver/handlers/route-management.handler.d.ts +0 -14
- package/dist_ts/opsserver/handlers/route-management.handler.js +0 -117
- package/dist_ts/opsserver/handlers/security.handler.d.ts +0 -9
- package/dist_ts/opsserver/handlers/security.handler.js +0 -231
- package/dist_ts/opsserver/handlers/stats.handler.d.ts +0 -11
- package/dist_ts/opsserver/handlers/stats.handler.js +0 -399
- package/dist_ts/opsserver/helpers/guards.d.ts +0 -27
- package/dist_ts/opsserver/helpers/guards.js +0 -43
- package/dist_ts/opsserver/index.d.ts +0 -1
- package/dist_ts/opsserver/index.js +0 -2
- package/dist_ts/radius/classes.accounting.manager.d.ts +0 -218
- package/dist_ts/radius/classes.accounting.manager.js +0 -417
- package/dist_ts/radius/classes.radius.server.d.ts +0 -171
- package/dist_ts/radius/classes.radius.server.js +0 -385
- package/dist_ts/radius/classes.vlan.manager.d.ts +0 -128
- package/dist_ts/radius/classes.vlan.manager.js +0 -279
- package/dist_ts/radius/index.d.ts +0 -13
- package/dist_ts/radius/index.js +0 -14
- package/dist_ts/remoteingress/classes.remoteingress-manager.d.ts +0 -82
- package/dist_ts/remoteingress/classes.remoteingress-manager.js +0 -227
- package/dist_ts/remoteingress/classes.tunnel-manager.d.ts +0 -59
- package/dist_ts/remoteingress/classes.tunnel-manager.js +0 -165
- package/dist_ts/remoteingress/index.d.ts +0 -2
- package/dist_ts/remoteingress/index.js +0 -3
|
@@ -1,152 +0,0 @@
|
|
|
1
|
-
import * as plugins from '../plugins.js';
|
|
2
|
-
import { ValidationError } from '../errors/base.errors.js';
|
|
3
|
-
/**
|
|
4
|
-
* Configuration validator
|
|
5
|
-
* Validates configuration objects against schemas and provides default values
|
|
6
|
-
*/
|
|
7
|
-
export class ConfigValidator {
|
|
8
|
-
/**
|
|
9
|
-
* Validate a configuration object against a schema
|
|
10
|
-
*
|
|
11
|
-
* @param config Configuration object to validate
|
|
12
|
-
* @param schema Validation schema
|
|
13
|
-
* @returns Validation result
|
|
14
|
-
*/
|
|
15
|
-
static validate(config, schema) {
|
|
16
|
-
const errors = [];
|
|
17
|
-
const validatedConfig = { ...config };
|
|
18
|
-
// Validate each field against the schema
|
|
19
|
-
for (const [key, rules] of Object.entries(schema)) {
|
|
20
|
-
const value = config[key];
|
|
21
|
-
// Check if required
|
|
22
|
-
if (rules.required && (value === undefined || value === null)) {
|
|
23
|
-
errors.push(`${key} is required`);
|
|
24
|
-
continue;
|
|
25
|
-
}
|
|
26
|
-
// If not present and not required, apply default if available
|
|
27
|
-
if ((value === undefined || value === null)) {
|
|
28
|
-
if (rules.default !== undefined) {
|
|
29
|
-
validatedConfig[key] = rules.default;
|
|
30
|
-
}
|
|
31
|
-
continue;
|
|
32
|
-
}
|
|
33
|
-
// Type validation
|
|
34
|
-
if (value !== undefined && value !== null) {
|
|
35
|
-
const valueType = Array.isArray(value) ? 'array' : typeof value;
|
|
36
|
-
if (valueType !== rules.type) {
|
|
37
|
-
errors.push(`${key} must be of type ${rules.type}, got ${valueType}`);
|
|
38
|
-
continue;
|
|
39
|
-
}
|
|
40
|
-
// Type-specific validations
|
|
41
|
-
switch (rules.type) {
|
|
42
|
-
case 'number':
|
|
43
|
-
if (rules.min !== undefined && value < rules.min) {
|
|
44
|
-
errors.push(`${key} must be at least ${rules.min}`);
|
|
45
|
-
}
|
|
46
|
-
if (rules.max !== undefined && value > rules.max) {
|
|
47
|
-
errors.push(`${key} must be at most ${rules.max}`);
|
|
48
|
-
}
|
|
49
|
-
break;
|
|
50
|
-
case 'string':
|
|
51
|
-
if (rules.minLength !== undefined && value.length < rules.minLength) {
|
|
52
|
-
errors.push(`${key} must be at least ${rules.minLength} characters`);
|
|
53
|
-
}
|
|
54
|
-
if (rules.maxLength !== undefined && value.length > rules.maxLength) {
|
|
55
|
-
errors.push(`${key} must be at most ${rules.maxLength} characters`);
|
|
56
|
-
}
|
|
57
|
-
if (rules.pattern && !rules.pattern.test(value)) {
|
|
58
|
-
errors.push(`${key} must match pattern ${rules.pattern}`);
|
|
59
|
-
}
|
|
60
|
-
break;
|
|
61
|
-
case 'array':
|
|
62
|
-
if (rules.minLength !== undefined && value.length < rules.minLength) {
|
|
63
|
-
errors.push(`${key} must have at least ${rules.minLength} items`);
|
|
64
|
-
}
|
|
65
|
-
if (rules.maxLength !== undefined && value.length > rules.maxLength) {
|
|
66
|
-
errors.push(`${key} must have at most ${rules.maxLength} items`);
|
|
67
|
-
}
|
|
68
|
-
if (rules.items && value.length > 0) {
|
|
69
|
-
for (let i = 0; i < value.length; i++) {
|
|
70
|
-
const itemType = Array.isArray(value[i]) ? 'array' : typeof value[i];
|
|
71
|
-
if (itemType !== rules.items.type) {
|
|
72
|
-
errors.push(`${key}[${i}] must be of type ${rules.items.type}, got ${itemType}`);
|
|
73
|
-
}
|
|
74
|
-
else if (rules.items.schema && itemType === 'object') {
|
|
75
|
-
const itemResult = this.validate(value[i], rules.items.schema);
|
|
76
|
-
if (!itemResult.valid) {
|
|
77
|
-
errors.push(...itemResult.errors.map(err => `${key}[${i}].${err}`));
|
|
78
|
-
}
|
|
79
|
-
}
|
|
80
|
-
}
|
|
81
|
-
}
|
|
82
|
-
break;
|
|
83
|
-
case 'object':
|
|
84
|
-
if (rules.schema) {
|
|
85
|
-
const nestedResult = this.validate(value, rules.schema);
|
|
86
|
-
if (!nestedResult.valid) {
|
|
87
|
-
errors.push(...nestedResult.errors.map(err => `${key}.${err}`));
|
|
88
|
-
}
|
|
89
|
-
validatedConfig[key] = nestedResult.config;
|
|
90
|
-
}
|
|
91
|
-
break;
|
|
92
|
-
}
|
|
93
|
-
// Enum validation
|
|
94
|
-
if (rules.enum && !rules.enum.includes(value)) {
|
|
95
|
-
errors.push(`${key} must be one of [${rules.enum.join(', ')}]`);
|
|
96
|
-
}
|
|
97
|
-
// Custom validation
|
|
98
|
-
if (rules.validate) {
|
|
99
|
-
const result = rules.validate(value);
|
|
100
|
-
if (result !== true) {
|
|
101
|
-
errors.push(typeof result === 'string' ? result : `${key} failed custom validation`);
|
|
102
|
-
}
|
|
103
|
-
}
|
|
104
|
-
}
|
|
105
|
-
}
|
|
106
|
-
return {
|
|
107
|
-
valid: errors.length === 0,
|
|
108
|
-
errors: errors.length > 0 ? errors : undefined,
|
|
109
|
-
config: validatedConfig
|
|
110
|
-
};
|
|
111
|
-
}
|
|
112
|
-
/**
|
|
113
|
-
* Apply defaults to a configuration object based on a schema
|
|
114
|
-
*
|
|
115
|
-
* @param config Configuration object to apply defaults to
|
|
116
|
-
* @param schema Validation schema with defaults
|
|
117
|
-
* @returns Configuration with defaults applied
|
|
118
|
-
*/
|
|
119
|
-
static applyDefaults(config, schema) {
|
|
120
|
-
const result = { ...config };
|
|
121
|
-
for (const [key, rules] of Object.entries(schema)) {
|
|
122
|
-
if (result[key] === undefined && rules.default !== undefined) {
|
|
123
|
-
result[key] = rules.default;
|
|
124
|
-
}
|
|
125
|
-
// Apply defaults to nested objects
|
|
126
|
-
if (result[key] && rules.type === 'object' && rules.schema) {
|
|
127
|
-
result[key] = this.applyDefaults(result[key], rules.schema);
|
|
128
|
-
}
|
|
129
|
-
// Apply defaults to array items
|
|
130
|
-
if (result[key] && rules.type === 'array' && rules.items && rules.items.schema) {
|
|
131
|
-
result[key] = result[key].map(item => typeof item === 'object' ? this.applyDefaults(item, rules.items.schema) : item);
|
|
132
|
-
}
|
|
133
|
-
}
|
|
134
|
-
return result;
|
|
135
|
-
}
|
|
136
|
-
/**
|
|
137
|
-
* Throw a validation error if the configuration is invalid
|
|
138
|
-
*
|
|
139
|
-
* @param config Configuration to validate
|
|
140
|
-
* @param schema Validation schema
|
|
141
|
-
* @returns Validated configuration with defaults
|
|
142
|
-
* @throws ValidationError if validation fails
|
|
143
|
-
*/
|
|
144
|
-
static validateOrThrow(config, schema) {
|
|
145
|
-
const result = this.validate(config, schema);
|
|
146
|
-
if (!result.valid) {
|
|
147
|
-
throw new ValidationError(`Configuration validation failed: ${result.errors.join(', ')}`, 'CONFIG_VALIDATION_ERROR', { data: { errors: result.errors } });
|
|
148
|
-
}
|
|
149
|
-
return result.config;
|
|
150
|
-
}
|
|
151
|
-
}
|
|
152
|
-
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidmFsaWRhdG9yLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vdHMvY29uZmlnL3ZhbGlkYXRvci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGVBQWUsQ0FBQztBQUN6QyxPQUFPLEVBQUUsZUFBZSxFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUEwRjNEOzs7R0FHRztBQUNILE1BQU0sT0FBTyxlQUFlO0lBRTFCOzs7Ozs7T0FNRztJQUNJLE1BQU0sQ0FBQyxRQUFRLENBQUksTUFBUyxFQUFFLE1BQXdCO1FBQzNELE1BQU0sTUFBTSxHQUFhLEVBQUUsQ0FBQztRQUM1QixNQUFNLGVBQWUsR0FBRyxFQUFFLEdBQUcsTUFBTSxFQUFFLENBQUM7UUFFdEMseUNBQXlDO1FBQ3pDLEtBQUssTUFBTSxDQUFDLEdBQUcsRUFBRSxLQUFLLENBQUMsSUFBSSxNQUFNLENBQUMsT0FBTyxDQUFDLE1BQU0sQ0FBQyxFQUFFLENBQUM7WUFDbEQsTUFBTSxLQUFLLEdBQUcsTUFBTSxDQUFDLEdBQUcsQ0FBQyxDQUFDO1lBRTFCLG9CQUFvQjtZQUNwQixJQUFJLEtBQUssQ0FBQyxRQUFRLElBQUksQ0FBQyxLQUFLLEtBQUssU0FBUyxJQUFJLEtBQUssS0FBSyxJQUFJLENBQUMsRUFBRSxDQUFDO2dCQUM5RCxNQUFNLENBQUMsSUFBSSxDQUFDLEdBQUcsR0FBRyxjQUFjLENBQUMsQ0FBQztnQkFDbEMsU0FBUztZQUNYLENBQUM7WUFFRCw4REFBOEQ7WUFDOUQsSUFBSSxDQUFDLEtBQUssS0FBSyxTQUFTLElBQUksS0FBSyxLQUFLLElBQUksQ0FBQyxFQUFFLENBQUM7Z0JBQzVDLElBQUksS0FBSyxDQUFDLE9BQU8sS0FBSyxTQUFTLEVBQUUsQ0FBQztvQkFDaEMsZUFBZSxDQUFDLEdBQUcsQ0FBQyxHQUFHLEtBQUssQ0FBQyxPQUFPLENBQUM7Z0JBQ3ZDLENBQUM7Z0JBQ0QsU0FBUztZQUNYLENBQUM7WUFFRCxr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
|
|
@@ -1,224 +0,0 @@
|
|
|
1
|
-
import { ErrorSeverity, ErrorCategory, ErrorRecoverability } from './error.codes.js';
|
|
2
|
-
/**
|
|
3
|
-
* Context information added to structured errors
|
|
4
|
-
*/
|
|
5
|
-
export interface IErrorContext {
|
|
6
|
-
/** Component or service where the error occurred */
|
|
7
|
-
component?: string;
|
|
8
|
-
/** Operation that was being performed */
|
|
9
|
-
operation?: string;
|
|
10
|
-
/** Unique request ID if available */
|
|
11
|
-
requestId?: string;
|
|
12
|
-
/** Error occurred at timestamp */
|
|
13
|
-
timestamp?: number;
|
|
14
|
-
/** User-visible message (safe to display to end-users) */
|
|
15
|
-
userMessage?: string;
|
|
16
|
-
/** Additional structured data for debugging */
|
|
17
|
-
data?: Record<string, any>;
|
|
18
|
-
/** Related entity IDs if applicable */
|
|
19
|
-
entity?: {
|
|
20
|
-
type: string;
|
|
21
|
-
id: string | number;
|
|
22
|
-
};
|
|
23
|
-
/** Stack trace (if enabled in configuration) */
|
|
24
|
-
stack?: string;
|
|
25
|
-
/** Retry information if applicable */
|
|
26
|
-
retry?: {
|
|
27
|
-
/** Maximum number of retries allowed */
|
|
28
|
-
maxRetries?: number;
|
|
29
|
-
/** Current retry count */
|
|
30
|
-
currentRetry?: number;
|
|
31
|
-
/** Next retry timestamp */
|
|
32
|
-
nextRetryAt?: number;
|
|
33
|
-
/** Delay between retries (in ms) */
|
|
34
|
-
retryDelay?: number;
|
|
35
|
-
};
|
|
36
|
-
}
|
|
37
|
-
/**
|
|
38
|
-
* Base class for all errors in the Platform Service
|
|
39
|
-
* Adds structured error information, logging, and error tracking
|
|
40
|
-
*/
|
|
41
|
-
export declare class PlatformError extends Error {
|
|
42
|
-
/** Error code identifying the specific error type */
|
|
43
|
-
readonly code: string;
|
|
44
|
-
/** Error severity level */
|
|
45
|
-
readonly severity: ErrorSeverity;
|
|
46
|
-
/** Error category for grouping related errors */
|
|
47
|
-
readonly category: ErrorCategory;
|
|
48
|
-
/** Whether the error can be recovered from automatically */
|
|
49
|
-
readonly recoverability: ErrorRecoverability;
|
|
50
|
-
/** Additional context information */
|
|
51
|
-
readonly context: IErrorContext;
|
|
52
|
-
/**
|
|
53
|
-
* Creates a new PlatformError
|
|
54
|
-
*
|
|
55
|
-
* @param message Error message
|
|
56
|
-
* @param code Error code from error.codes.ts
|
|
57
|
-
* @param severity Error severity level
|
|
58
|
-
* @param category Error category
|
|
59
|
-
* @param recoverability Error recoverability indication
|
|
60
|
-
* @param context Additional context information
|
|
61
|
-
*/
|
|
62
|
-
constructor(message: string, code: string, severity?: ErrorSeverity, category?: ErrorCategory, recoverability?: ErrorRecoverability, context?: IErrorContext);
|
|
63
|
-
/**
|
|
64
|
-
* Logs the error using the platform logger
|
|
65
|
-
*/
|
|
66
|
-
private logError;
|
|
67
|
-
/**
|
|
68
|
-
* Maps severity levels to log levels
|
|
69
|
-
*/
|
|
70
|
-
private getLogLevelFromSeverity;
|
|
71
|
-
/**
|
|
72
|
-
* Returns a JSON representation of the error
|
|
73
|
-
*/
|
|
74
|
-
toJSON(): Record<string, any>;
|
|
75
|
-
/**
|
|
76
|
-
* Creates an instance with retry information
|
|
77
|
-
*
|
|
78
|
-
* @param maxRetries Maximum number of retries
|
|
79
|
-
* @param currentRetry Current retry count
|
|
80
|
-
* @param retryDelay Delay between retries in ms
|
|
81
|
-
*/
|
|
82
|
-
withRetry(maxRetries: number, currentRetry?: number, retryDelay?: number): PlatformError;
|
|
83
|
-
/**
|
|
84
|
-
* Protected method to create a new instance with updated context
|
|
85
|
-
* Subclasses can override this to handle their own constructor signatures
|
|
86
|
-
*/
|
|
87
|
-
protected createWithContext(context: IErrorContext): PlatformError;
|
|
88
|
-
/**
|
|
89
|
-
* Checks if the error should be retried based on retry information
|
|
90
|
-
*/
|
|
91
|
-
shouldRetry(): boolean;
|
|
92
|
-
/**
|
|
93
|
-
* Returns a user-friendly message that is safe to display to end users
|
|
94
|
-
*/
|
|
95
|
-
getUserMessage(): string;
|
|
96
|
-
}
|
|
97
|
-
/**
|
|
98
|
-
* Error class for validation errors
|
|
99
|
-
*/
|
|
100
|
-
export declare class ValidationError extends PlatformError {
|
|
101
|
-
/**
|
|
102
|
-
* Creates a new validation error
|
|
103
|
-
*
|
|
104
|
-
* @param message Error message
|
|
105
|
-
* @param code Error code
|
|
106
|
-
* @param context Additional context
|
|
107
|
-
*/
|
|
108
|
-
constructor(message: string, code: string, context?: IErrorContext);
|
|
109
|
-
/**
|
|
110
|
-
* Creates a new instance with updated context
|
|
111
|
-
* Overrides the base implementation to handle ValidationError's constructor signature
|
|
112
|
-
*/
|
|
113
|
-
protected createWithContext(context: IErrorContext): PlatformError;
|
|
114
|
-
}
|
|
115
|
-
/**
|
|
116
|
-
* Error class for configuration errors
|
|
117
|
-
*/
|
|
118
|
-
export declare class ConfigurationError extends PlatformError {
|
|
119
|
-
/**
|
|
120
|
-
* Creates a new configuration error
|
|
121
|
-
*
|
|
122
|
-
* @param message Error message
|
|
123
|
-
* @param code Error code
|
|
124
|
-
* @param context Additional context
|
|
125
|
-
*/
|
|
126
|
-
constructor(message: string, code: string, context?: IErrorContext);
|
|
127
|
-
/**
|
|
128
|
-
* Creates a new instance with updated context
|
|
129
|
-
* Overrides the base implementation to handle ConfigurationError's constructor signature
|
|
130
|
-
*/
|
|
131
|
-
protected createWithContext(context: IErrorContext): PlatformError;
|
|
132
|
-
}
|
|
133
|
-
/**
|
|
134
|
-
* Error class for network-related errors
|
|
135
|
-
*/
|
|
136
|
-
export declare class NetworkError extends PlatformError {
|
|
137
|
-
/**
|
|
138
|
-
* Creates a new network error
|
|
139
|
-
*
|
|
140
|
-
* @param message Error message
|
|
141
|
-
* @param code Error code
|
|
142
|
-
* @param context Additional context
|
|
143
|
-
*/
|
|
144
|
-
constructor(message: string, code: string, context?: IErrorContext);
|
|
145
|
-
/**
|
|
146
|
-
* Creates a new instance with updated context
|
|
147
|
-
* Overrides the base implementation to handle NetworkError's constructor signature
|
|
148
|
-
*/
|
|
149
|
-
protected createWithContext(context: IErrorContext): PlatformError;
|
|
150
|
-
}
|
|
151
|
-
/**
|
|
152
|
-
* Error class for resource availability errors (rate limits, quotas)
|
|
153
|
-
*/
|
|
154
|
-
export declare class ResourceError extends PlatformError {
|
|
155
|
-
/**
|
|
156
|
-
* Creates a new resource error
|
|
157
|
-
*
|
|
158
|
-
* @param message Error message
|
|
159
|
-
* @param code Error code
|
|
160
|
-
* @param context Additional context
|
|
161
|
-
*/
|
|
162
|
-
constructor(message: string, code: string, context?: IErrorContext);
|
|
163
|
-
/**
|
|
164
|
-
* Creates a new instance with updated context
|
|
165
|
-
* Overrides the base implementation to handle ResourceError's constructor signature
|
|
166
|
-
*/
|
|
167
|
-
protected createWithContext(context: IErrorContext): PlatformError;
|
|
168
|
-
}
|
|
169
|
-
/**
|
|
170
|
-
* Error class for authentication/authorization errors
|
|
171
|
-
*/
|
|
172
|
-
export declare class AuthenticationError extends PlatformError {
|
|
173
|
-
/**
|
|
174
|
-
* Creates a new authentication error
|
|
175
|
-
*
|
|
176
|
-
* @param message Error message
|
|
177
|
-
* @param code Error code
|
|
178
|
-
* @param context Additional context
|
|
179
|
-
*/
|
|
180
|
-
constructor(message: string, code: string, context?: IErrorContext);
|
|
181
|
-
/**
|
|
182
|
-
* Creates a new instance with updated context
|
|
183
|
-
* Overrides the base implementation to handle AuthenticationError's constructor signature
|
|
184
|
-
*/
|
|
185
|
-
protected createWithContext(context: IErrorContext): PlatformError;
|
|
186
|
-
}
|
|
187
|
-
/**
|
|
188
|
-
* Error class for operation errors (API calls, processing)
|
|
189
|
-
*/
|
|
190
|
-
export declare class OperationError extends PlatformError {
|
|
191
|
-
/**
|
|
192
|
-
* Creates a new operation error
|
|
193
|
-
*
|
|
194
|
-
* @param message Error message
|
|
195
|
-
* @param code Error code
|
|
196
|
-
* @param context Additional context
|
|
197
|
-
*/
|
|
198
|
-
constructor(message: string, code: string, context?: IErrorContext);
|
|
199
|
-
/**
|
|
200
|
-
* Creates a new instance with updated context
|
|
201
|
-
* Overrides the base implementation to handle OperationError's constructor signature
|
|
202
|
-
*/
|
|
203
|
-
protected createWithContext(context: IErrorContext): PlatformError;
|
|
204
|
-
}
|
|
205
|
-
/**
|
|
206
|
-
* Error class for critical system errors
|
|
207
|
-
*/
|
|
208
|
-
export declare class SystemError extends PlatformError {
|
|
209
|
-
/**
|
|
210
|
-
* Creates a new system error
|
|
211
|
-
*
|
|
212
|
-
* @param message Error message
|
|
213
|
-
* @param code Error code
|
|
214
|
-
* @param context Additional context
|
|
215
|
-
*/
|
|
216
|
-
constructor(message: string, code: string, context?: IErrorContext);
|
|
217
|
-
}
|
|
218
|
-
/**
|
|
219
|
-
* Helper to get the appropriate error class based on error category
|
|
220
|
-
*
|
|
221
|
-
* @param category Error category
|
|
222
|
-
* @returns The appropriate error class
|
|
223
|
-
*/
|
|
224
|
-
export declare function getErrorClassForCategory(category: ErrorCategory): any;
|