@salesforce/core 4.0.0 → 4.1.0

package/lib/schema/printer.js

@@ -5,13 +5,17 @@
  * Licensed under the BSD 3-Clause license.
  * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
  */
+/* eslint-disable class-methods-use-this */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SchemaPrinter = exports.SchemaPropertyRenderer = void 0;
 const ts_types_1 = require("@salesforce/ts-types");
-const sfdxError_1 = require("../sfdxError");
+const sfError_1 = require("../sfError");
 /**
  * Renders schema properties.  By default, this is simply an identity transform.  Subclasses may provide more
  * interesting decorations of each values, such as ANSI coloring.
+ *
+ * @deprecated
+ *
  */
 class SchemaPropertyRenderer {
     /**
@@ -51,6 +55,9 @@ exports.SchemaPropertyRenderer = SchemaPropertyRenderer;
 /**
  * Prints a JSON schema in a human-friendly format.
  *
+ * @deprecated
+ * remaining reference: https://github.com/salesforcecli/plugin-data/blob/cc1bdfa2c707f93a6da96beea8117b25f9612d4a/src/commands/data/import/tree.ts#L75
+ *
  * ```
  * import chalk from 'chalk';
  * class MyPropertyRenderer extends SchemaPropertyRenderer {
@@ -78,7 +85,7 @@ class SchemaPrinter {
             // No need to add to messages, since this should never happen. In fact,
             // this will cause a test failure if there is a command that uses a schema
             // with no properties defined.
-            throw new sfdxError_1.SfdxError('There is no purpose to print a schema with no properties or items');
+            throw new sfError_1.SfError('There is no purpose to print a schema with no properties or items');
         }
         const startLevel = 0;
         const add = this.addFn(startLevel);
@@ -178,40 +185,13 @@ class SchemaProperty {
         }
         const oneOfs = (0, ts_types_1.asJsonArray)(this.rawProperty.oneOf);
         if (oneOfs && !this.rawProperty.type) {
-            this.rawProperty.type = oneOfs
-                .map((value) => {
-                return (0, ts_types_1.isJsonMap)(value) ? value.type || value.$ref : value;
-            })
-                .join('|');
+            this.rawProperty.type = oneOfs.map((value) => ((0, ts_types_1.isJsonMap)(value) ? value.type ?? value.$ref : value)).join('|');
         }
         // Handle items references
         if ((0, ts_types_1.isJsonMap)(this.items) && this.items && this.items.$ref) {
             Object.assign(this.items, resolveRef(this.schema, this.items));
         }
     }
-    renderName() {
-        return this.propertyRenderer.renderName(this.name);
-    }
-    renderTitle() {
-        return this.propertyRenderer.renderTitle(this.title || '');
-    }
-    renderDescription() {
-        return this.propertyRenderer.renderDescription(this.description || '');
-    }
-    renderType() {
-        return this.propertyRenderer.renderType(this.type || '');
-    }
-    renderHeader() {
-        return `${this.renderName()}(${this.renderType()}) - ${this.renderTitle()}: ${this.renderDescription()}`;
-    }
-    renderArrayHeader() {
-        if (!this.items) {
-            return '';
-        }
-        const minItems = this.minItems ? ` - min ${this.minItems}` : '';
-        const prop = new SchemaProperty(this.logger, this.schema, 'items', this.items, this.propertyRenderer);
-        return `items(${prop.renderType()}${minItems}) - ${prop.renderTitle()}: ${prop.renderDescription()}`;
-    }
     get title() {
         return (0, ts_types_1.asString)(this.rawProperty.title);
     }
@@ -235,11 +215,34 @@ class SchemaProperty {
     }
     getProperty(key) {
         const properties = this.getProperties();
-        return (0, ts_types_1.asJsonMap)(properties && properties[key]);
+        return (0, ts_types_1.asJsonMap)(properties?.[key]);
     }
     getProperties() {
         return (0, ts_types_1.asJsonMap)(this.rawProperty.properties);
     }
+    renderName() {
+        return this.propertyRenderer.renderName(this.name);
+    }
+    renderTitle() {
+        return this.propertyRenderer.renderTitle(this.title ?? '');
+    }
+    renderDescription() {
+        return this.propertyRenderer.renderDescription(this.description ?? '');
+    }
+    renderType() {
+        return this.propertyRenderer.renderType(this.type ?? '');
+    }
+    renderHeader() {
+        return `${this.renderName()}(${this.renderType()}) - ${this.renderTitle()}: ${this.renderDescription()}`;
+    }
+    renderArrayHeader() {
+        if (!this.items) {
+            return '';
+        }
+        const minItems = this.minItems ? ` - min ${this.minItems}` : '';
+        const prop = new SchemaProperty(this.logger, this.schema, 'items', this.items, this.propertyRenderer);
+        return `items(${prop.renderType()}${minItems}) - ${prop.renderTitle()}: ${prop.renderDescription()}`;
+    }
 }
 /**
  * Get the referenced definition by following the reference path on the current schema.

package/lib/schema/validator.d.ts

@@ -27,8 +27,8 @@ export declare class SchemaValidator {
      * Performs validation of JSON data against the schema located at the `schemaPath` value provided
      * at instantiation.
      *
-     * **Throws** *{@link SfdxError}{ name: 'ValidationSchemaFieldError' }* If there are known validations errors.
-     * **Throws** *{@link SfdxError}{ name: 'ValidationSchemaUnknownError' }* If there are unknown validations errors.
+     * **Throws** *{@link SfError}{ name: 'ValidationSchemaFieldError' }* If there are known validations errors.
+     * **Throws** *{@link SfError}{ name: 'ValidationSchemaUnknownError' }* If there are unknown validations errors.
      *
      * @param json A JSON value to validate against this instance's target schema.
      * @returns The validated JSON data.
@@ -38,18 +38,20 @@ export declare class SchemaValidator {
      * Performs validation of JSON data against the schema located at the `schemaPath` value provided
      * at instantiation.
      *
-     * **Throws** *{@link SfdxError}{ name: 'ValidationSchemaFieldError' }* If there are known validations errors.
-     * **Throws** *{@link SfdxError}{ name: 'ValidationSchemaUnknownError' }* If there are unknown validations errors.
+     * **Throws** *{@link SfError}{ name: 'ValidationSchemaFieldError' }* If there are known validations errors.
+     * **Throws** *{@link SfError}{ name: 'ValidationSchemaUnknownError' }* If there are unknown validations errors.
      *
      * @param json A JSON value to validate against this instance's target schema.
      * @returns The validated JSON data.
      */
-    validateSync(json: AnyJson): AnyJson;
+    validateSync<T extends AnyJson>(json: T): T;
     /**
-     * Loads local, external schemas from URIs relative to the local schema file.  Does not support loading from
-     * remote URIs. Returns a map of external schema local URIs to loaded schema JSON objects.
+     * Loads local, external schemas from URIs in the same directory as the local schema file.
+     * Does not support loading from remote URIs.
+     * Returns a map of external schema local URIs to loaded schema JSON objects.
      *
-     * @param schema The main schema to validate against.
+     * @param schema The main schema to look up references ($ref) in.
+     * @returns An array of found referenced schemas.
      */
     private loadExternalSchemas;
     /**
@@ -60,9 +62,9 @@ export declare class SchemaValidator {
     private loadExternalSchema;
     /**
      * Get a string representation of the schema validation errors.
+     * Adds additional (human friendly) information to certain errors.
      *
-     * @param errors An array of JsenValidateError objects.
-     * @param schema The validation schema.
+     * @param errors An array of AJV (DefinedError) objects.
      */
     private getErrorsText;
 }

package/lib/schema/validator.js

@@ -8,11 +8,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SchemaValidator = void 0;
 const path = require("path");
+const fs = require("fs");
+const ajv_1 = require("ajv");
 const kit_1 = require("@salesforce/kit");
-const ts_types_1 = require("@salesforce/ts-types");
-const validator = require("jsen");
-const sfdxError_1 = require("../sfdxError");
-const fs_1 = require("../util/fs");
+const sfError_1 = require("../sfError");
 /**
  * Loads a JSON schema and performs validations against JSON objects.
  */
@@ -33,7 +32,7 @@ class SchemaValidator {
      */
     async load() {
         if (!this.schema) {
-            this.schema = await fs_1.fs.readJsonMap(this.schemaPath);
+            this.schema = (0, kit_1.parseJsonMap)(await fs.promises.readFile(this.schemaPath, 'utf8'));
             this.logger.debug(`Schema loaded for ${this.schemaPath}`);
         }
         return this.schema;
@@ -43,7 +42,7 @@ class SchemaValidator {
      */
     loadSync() {
         if (!this.schema) {
-            this.schema = fs_1.fs.readJsonMapSync(this.schemaPath);
+            this.schema = (0, kit_1.parseJsonMap)(fs.readFileSync(this.schemaPath, 'utf8'));
             this.logger.debug(`Schema loaded for ${this.schemaPath}`);
         }
         return this.schema;
@@ -52,8 +51,8 @@ class SchemaValidator {
      * Performs validation of JSON data against the schema located at the `schemaPath` value provided
      * at instantiation.
      *
-     * **Throws** *{@link SfdxError}{ name: 'ValidationSchemaFieldError' }* If there are known validations errors.
-     * **Throws** *{@link SfdxError}{ name: 'ValidationSchemaUnknownError' }* If there are unknown validations errors.
+     * **Throws** *{@link SfError}{ name: 'ValidationSchemaFieldError' }* If there are known validations errors.
+     * **Throws** *{@link SfError}{ name: 'ValidationSchemaUnknownError' }* If there are unknown validations errors.
      *
      * @param json A JSON value to validate against this instance's target schema.
      * @returns The validated JSON data.
@@ -66,8 +65,8 @@ class SchemaValidator {
      * Performs validation of JSON data against the schema located at the `schemaPath` value provided
      * at instantiation.
      *
-     * **Throws** *{@link SfdxError}{ name: 'ValidationSchemaFieldError' }* If there are known validations errors.
-     * **Throws** *{@link SfdxError}{ name: 'ValidationSchemaUnknownError' }* If there are unknown validations errors.
+     * **Throws** *{@link SfError}{ name: 'ValidationSchemaFieldError' }* If there are known validations errors.
+     * **Throws** *{@link SfError}{ name: 'ValidationSchemaUnknownError' }* If there are unknown validations errors.
      *
      * @param json A JSON value to validate against this instance's target schema.
      * @returns The validated JSON data.
@@ -75,47 +74,58 @@ class SchemaValidator {
     validateSync(json) {
         const schema = this.loadSync();
         const externalSchemas = this.loadExternalSchemas(schema);
+        const ajv = new ajv_1.default({
+            allErrors: true,
+            allowUnionTypes: true,
+            schemas: externalSchemas,
+            useDefaults: true,
+            // TODO: We may someday want to enable strictSchema. This is disabled for now
+            // because the CLI team does not "own" the @salesforce/schemas repository.
+            // Invalid schema would cause errors wherever SchemaValidator is used.
+            strictSchema: false,
+            // If we end up getting an npm-shrinkwrap working in the future we could turn this back off.
+            // https://github.com/forcedotcom/cli/issues/1493
+            validateSchema: false,
+        });
+        // JSEN to AJV migration note - regarding the following "TODO":
+        // I don't think that AJV has a way to throw an error if an additional property exists in the data
+        // It does however have a top level option for `removeAdditional` https://ajv.js.org/options.html#removeadditional
+        // Regardless, this would be a breaking changes and I do not think it should be implemented.
         // TODO: We should default to throw an error when a property is specified
         // that is not in the schema, but the only option to do this right now is
         // to specify "removeAdditional: false" in every object.
-        const validate = validator(schema, {
-            greedy: true,
-            schemas: externalSchemas,
-        });
-        if (!validate(json)) {
+        const validate = ajv.compile(schema);
+        // AJV will modify the original json object. We need to make a clone of the
+        // json to keep this backwards compatible with JSEN functionality
+        const jsonClone = JSON.parse(JSON.stringify(json));
+        const valid = validate(jsonClone);
+        if (!valid) {
             if (validate.errors) {
-                const errors = this.getErrorsText(validate.errors, schema);
-                throw new sfdxError_1.SfdxError(`Validation errors:\n${errors}`, 'ValidationSchemaFieldError');
+                const errors = this.getErrorsText(validate.errors);
+                throw new sfError_1.SfError(`Validation errors:\n${errors}`, 'ValidationSchemaFieldError');
             }
             else {
-                throw new sfdxError_1.SfdxError('Unknown schema validation error', 'ValidationSchemaUnknownError');
+                throw new sfError_1.SfError('Unknown schema validation error', 'ValidationSchemaUnknownError');
             }
         }
-        return validate.build(json);
+        // We return the cloned JSON because it will have defaults included
+        // This is configured with the 'useDefaults' option above.
+        return jsonClone;
     }
     /**
-     * Loads local, external schemas from URIs relative to the local schema file.  Does not support loading from
-     * remote URIs. Returns a map of external schema local URIs to loaded schema JSON objects.
+     * Loads local, external schemas from URIs in the same directory as the local schema file.
+     * Does not support loading from remote URIs.
+     * Returns a map of external schema local URIs to loaded schema JSON objects.
      *
-     * @param schema The main schema to validate against.
+     * @param schema The main schema to look up references ($ref) in.
+     * @returns An array of found referenced schemas.
      */
     loadExternalSchemas(schema) {
-        const externalSchemas = {};
-        const schemas = (0, kit_1.getJsonValuesByName)(schema, '$ref')
-            // eslint-disable-next-line no-useless-escape
-            .map((ref) => ref && RegExp(/([\w\.]+)#/).exec(ref))
-            .map((match) => match && match[1])
+        return (0, kit_1.getJsonValuesByName)(schema, '$ref')
+            .map((ref) => ref && RegExp(/([\w\.]+)#/).exec(ref)) // eslint-disable-line no-useless-escape
+            .map((match) => match?.[1])
             .filter((uri) => !!uri)
             .map((uri) => this.loadExternalSchema(uri));
-        schemas.forEach((externalSchema) => {
-            if ((0, ts_types_1.isString)(externalSchema.id)) {
-                externalSchemas[externalSchema.id] = externalSchema;
-            }
-            else {
-                throw new sfdxError_1.SfdxError(`Unexpected external schema id type: ${typeof externalSchema.id}`, 'ValidationSchemaTypeError');
-            }
-        });
-        return externalSchemas;
     }
     /**
      * Load another schema relative to the primary schema when referenced.  Only supports local schema URIs.
@@ -125,63 +135,33 @@ class SchemaValidator {
     loadExternalSchema(uri) {
         const schemaPath = path.join(this.schemasDir, `${uri}.json`);
         try {
-            return fs_1.fs.readJsonMapSync(schemaPath);
+            return (0, kit_1.parseJsonMap)(fs.readFileSync(schemaPath, 'utf8'));
         }
         catch (err) {
             if (err.code === 'ENOENT') {
-                throw new sfdxError_1.SfdxError(`Schema not found: ${schemaPath}`, 'ValidationSchemaNotFound');
+                throw new sfError_1.SfError(`Schema not found: ${schemaPath}`, 'ValidationSchemaNotFound');
             }
             throw err;
         }
     }
     /**
      * Get a string representation of the schema validation errors.
+     * Adds additional (human friendly) information to certain errors.
      *
-     * @param errors An array of JsenValidateError objects.
-     * @param schema The validation schema.
+     * @param errors An array of AJV (DefinedError) objects.
      */
-    getErrorsText(errors, schema) {
+    // eslint-disable-next-line class-methods-use-this
+    getErrorsText(errors) {
         return errors
             .map((error) => {
-            // eslint-disable-next-line no-useless-escape
-            const property = RegExp(/^([a-zA-Z0-9\.]+)\.([a-zA-Z0-9]+)$/).exec(error.path);
-            const getPropValue = (prop) => {
-                const reducer = (obj, name) => {
-                    if (!(0, ts_types_1.isJsonMap)(obj))
-                        return;
-                    if ((0, ts_types_1.isJsonMap)(obj.properties))
-                        return obj.properties[name];
-                    if (name === '0')
-                        return (0, ts_types_1.asJsonArray)(obj.items);
-                    return obj[name] || obj[prop];
-                };
-                return error.path.split('.').reduce(reducer, schema);
-            };
-            const getEnumValues = () => {
-                const enumSchema = (0, ts_types_1.asJsonMap)(getPropValue('enum'));
-                return (enumSchema && (0, ts_types_1.getJsonArray)(enumSchema, 'enum', []).join(', ')) || '';
-            };
+            const msg = `${error.schemaPath}: ${error.message}`;
             switch (error.keyword) {
                 case 'additionalProperties':
-                    // Missing Typing
-                    // eslint-disable-next-line no-case-declarations
-                    const additionalProperties = (0, ts_types_1.get)(error, 'additionalProperties');
-                    return `${error.path} should NOT have additional properties '${additionalProperties}'`;
-                case 'required':
-                    if (property) {
-                        return `${property[1]} should have required property ${property[2]}`;
-                    }
-                    return `should have required property '${error.path}'`;
-                case 'oneOf':
-                    return `${error.path} should match exactly one schema in oneOf`;
+                    return `${msg} '${error.params.additionalProperty}'`;
                 case 'enum':
-                    return `${error.path} should be equal to one of the allowed values ${getEnumValues()}`;
-                case 'type': {
-                    const _path = error.path === '' ? 'Root of JSON object' : error.path;
-                    return `${_path} is an invalid type.  Expected type [${getPropValue('type')}]`;
-                }
+                    return `${msg} '${error.params.allowedValues.join(', ')}'`;
                 default:
-                    return `${error.path} invalid ${error.keyword}`;
+                    return msg;
             }
         })
             .join('\n');

package/lib/{sfdxError.d.ts → sfError.d.ts}

@@ -13,10 +13,11 @@ import { JsonMap } from '@salesforce/ts-types';
  * const messages = Messages.load('myPackageName', 'myBundleName');
  *
  * // To throw a non-bundle based error:
- * throw new SfdxError(message.getMessage('myError'), 'MyErrorName');
+ * throw new SfError(message.getMessage('myError'), 'MyErrorName');
  * ```
  */
-export declare class SfdxError extends NamedError {
+export declare class SfError extends NamedError {
+    #private;
     /**
      * Action messages. Hints to the users regarding what can be done to fix related issues.
      */
@@ -31,46 +32,37 @@ export declare class SfdxError extends NamedError {
     context?: string;
     data?: unknown;
     /**
-     * Some errors support `error.code` instead of `error.name`. This keeps backwards compatability.
-     */
-    private _code?;
-    /**
-     * Create an SfdxError.
+     * Create an SfError.
      *
      * @param message The error message.
-     * @param name The error name. Defaults to 'SfdxError'.
+     * @param name The error name. Defaults to 'SfError'.
      * @param actions The action message(s).
      * @param exitCodeOrCause The exit code which will be used by SfdxCommand or he underlying error that caused this error to be raised.
      * @param cause The underlying error that caused this error to be raised.
      */
     constructor(message: string, name?: string, actions?: string[], exitCodeOrCause?: number | Error, cause?: Error);
+    get code(): string | undefined | any;
+    set code(code: string);
     /**
-     * Convert an Error to an SfdxError.
+     * Convert an Error to an SfError.
      *
      * @param err The error to convert.
      */
-    static wrap(err: Error | string): SfdxError;
-    get code(): string | undefined | any;
-    set code(code: string);
+    static wrap(err: Error | string): SfError;
     /**
      * Sets the context of the error. For convenience `this` object is returned.
      *
      * @param context The command name.
      */
-    setContext(context: string): SfdxError;
+    setContext(context: string): SfError;
     /**
      * An additional payload for the error. For convenience `this` object is returned.
      *
      * @param data The payload data.
      */
-    setData(data: unknown): SfdxError;
+    setData(data: unknown): SfError;
     /**
-     * Convert an {@link SfdxError} state to an object. Returns a plain object representing the state of this error.
+     * Convert an {@link SfError} state to an object. Returns a plain object representing the state of this error.
      */
     toObject(): JsonMap;
-    /**
-     * @deprecated Does nothing. Do not use. This is kept around to support older versions of SfdxCommand.
-     * @param commandName
-     */
-    setCommandName(): void;
 }

package/lib/{sfdxError.js → sfError.js}

@@ -5,8 +5,20 @@
  * Licensed under the BSD 3-Clause license.
  * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
  */
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var _SfError_code;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SfdxError = void 0;
+exports.SfError = void 0;
 const kit_1 = require("@salesforce/kit");
 const ts_types_1 = require("@salesforce/ts-types");
 /**
@@ -22,22 +34,26 @@ const ts_types_1 = require("@salesforce/ts-types");
  * const messages = Messages.load('myPackageName', 'myBundleName');
  *
  * // To throw a non-bundle based error:
- * throw new SfdxError(message.getMessage('myError'), 'MyErrorName');
+ * throw new SfError(message.getMessage('myError'), 'MyErrorName');
  * ```
  */
-class SfdxError extends kit_1.NamedError {
+class SfError extends kit_1.NamedError {
     /**
-     * Create an SfdxError.
+     * Create an SfError.
      *
      * @param message The error message.
-     * @param name The error name. Defaults to 'SfdxError'.
+     * @param name The error name. Defaults to 'SfError'.
      * @param actions The action message(s).
      * @param exitCodeOrCause The exit code which will be used by SfdxCommand or he underlying error that caused this error to be raised.
      * @param cause The underlying error that caused this error to be raised.
      */
     constructor(message, name, actions, exitCodeOrCause, cause) {
         cause = exitCodeOrCause instanceof Error ? exitCodeOrCause : cause;
-        super(name || 'SfdxError', message || name, cause);
+        super(name ?? 'SfError', message || name, cause);
+        /**
+         * Some errors support `error.code` instead of `error.name`. This keeps backwards compatability.
+         */
+        _SfError_code.set(this, void 0);
         this.actions = actions;
         if (typeof exitCodeOrCause === 'number') {
             this.exitCode = exitCodeOrCause;
@@ -46,31 +62,31 @@ class SfdxError extends kit_1.NamedError {
             this.exitCode = 1;
         }
     }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    get code() {
+        return __classPrivateFieldGet(this, _SfError_code, "f") ?? this.name;
+    }
+    set code(code) {
+        __classPrivateFieldSet(this, _SfError_code, code, "f");
+    }
     /**
-     * Convert an Error to an SfdxError.
+     * Convert an Error to an SfError.
      *
      * @param err The error to convert.
      */
     static wrap(err) {
         if ((0, ts_types_1.isString)(err)) {
-            return new SfdxError(err);
+            return new SfError(err);
         }
-        if (err instanceof SfdxError) {
+        if (err instanceof SfError) {
             return err;
         }
-        const sfdxError = new SfdxError(err.message, err.name, undefined, err);
+        const sfError = new SfError(err.message, err.name, undefined, err);
         // If the original error has a code, use that instead of name.
         if ((0, ts_types_1.hasString)(err, 'code')) {
-            sfdxError.code = err.code;
+            sfError.code = err.code;
         }
-        return sfdxError;
-    }
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    get code() {
-        return this._code || this.name;
-    }
-    set code(code) {
-        this._code = code;
+        return sfError;
     }
     /**
      * Sets the context of the error. For convenience `this` object is returned.
@@ -91,7 +107,7 @@ class SfdxError extends kit_1.NamedError {
         return this;
     }
     /**
-     * Convert an {@link SfdxError} state to an object. Returns a plain object representing the state of this error.
+     * Convert an {@link SfError} state to an object. Returns a plain object representing the state of this error.
      */
     toObject() {
         const obj = {
@@ -104,18 +120,12 @@ class SfdxError extends kit_1.NamedError {
             obj.context = this.context;
         }
         if (this.data) {
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-assignment
             obj.data = this.data;
         }
         return obj;
     }
-    /**
-     * @deprecated Does nothing. Do not use. This is kept around to support older versions of SfdxCommand.
-     * @param commandName
-     */
-    setCommandName() {
-        /** Do nothing. */
-    }
 }
-exports.SfdxError = SfdxError;
-//# sourceMappingURL=sfdxError.js.map
+exports.SfError = SfError;
+_SfError_code = new WeakMap();
+//# sourceMappingURL=sfError.js.map