refactor(errors): differentiate invalid edge-field errors

Add an `invalid_edge_field` error code, distinct from `invalid_field_value`.
The former flags a value naming an unregistered BC edge-field; the latter
flags a malformed metadata value. Apply across the explicit edge builders.

Author: michaelpporter

src/graph/builders/explicit/dataview_note.ts

@@ -43,7 +43,7 @@ function get_dataview_note_info(
 	} else if (!plugin.settings.edge_fields.find((f) => f.label === field)) {
 		return graph_build_fail({
 			path,
-			code: "invalid_field_value",
+			code: "invalid_edge_field",
 			message: `dataview-note-field is not a valid field: '${field}'`,
 		});
 	}

src/graph/builders/explicit/dendron_note.ts

@@ -45,7 +45,7 @@ function get_dendron_note_info(
 	} else if (!plugin.settings.edge_fields.find((f) => f.label === field)) {
 		return graph_build_fail({
 			path,
-			code: "invalid_field_value",
+			code: "invalid_edge_field",
 			message: `dendron-note-field is not a valid field: '${field}'`,
 		});
 	}

src/graph/builders/explicit/folder_note.ts

@@ -33,7 +33,7 @@ const get_folder_note_info = (
 	} else if (!plugin.settings.edge_fields.find((f) => f.label === field)) {
 		return graph_build_fail({
 			path,
-			code: "invalid_field_value",
+			code: "invalid_edge_field",
 			message: `folder-note-field is not a valid field: '${field}'`,
 		});
 	}

src/graph/builders/explicit/johnny_decimal_note.ts

@@ -36,7 +36,7 @@ const get_johnny_decimal_note_info = (
 	} else if (!plugin.settings.edge_fields.find((f) => f.label === field)) {
 		return graph_build_fail({
 			path,
-			code: "invalid_field_value",
+			code: "invalid_edge_field",
 			message: `johnny-decimal-note-field is not a valid BC field: '${field}'`,
 		});
 	}

src/graph/builders/explicit/list_note.ts

@@ -32,7 +32,7 @@ const get_list_note_info = (
 	} else if (!plugin.settings.edge_fields.find((f) => f.label === field)) {
 		return graph_build_fail({
 			path,
-			code: "invalid_field_value",
+			code: "invalid_edge_field",
 			message: `list-note-field is not a valid BC field: '${field}'`,
 		});
 	}
@@ -55,7 +55,7 @@ const get_list_note_info = (
 		) {
 			return graph_build_fail({
 				path,
-				code: "invalid_field_value",
+				code: "invalid_edge_field",
 				message: `list-note-neighbour-field is not a valid BC field: '${neighbour_field}'`,
 			});
 		}
@@ -93,7 +93,7 @@ const resolve_field_override = (
 	} else if (!plugin.settings.edge_fields.find((f) => f.label === field)) {
 		return graph_build_fail({
 			path,
-			code: "invalid_field_value",
+			code: "invalid_edge_field",
 			message: `Field override is not a valid BC field: ${field}. Line: ${list_item.position.start.line}`,
 		});
 	} else {

src/graph/builders/explicit/regex_note.ts

@@ -64,7 +64,7 @@ function get_regex_note_info(
 	} else if (!plugin.settings.edge_fields.find((f) => f.label === field)) {
 		return graph_build_fail({
 			path,
-			code: "invalid_field_value",
+			code: "invalid_edge_field",
 			message: `${META_ALIAS["regex-note-field"]} is not a valid field: '${field}'`,
 		});
 	}

src/graph/builders/explicit/tag_note.ts

@@ -64,7 +64,7 @@ const get_tag_note_info = (
 	} else if (!plugin.settings.edge_fields.find((f) => f.label === field)) {
 		return graph_build_fail({
 			path,
-			code: "invalid_field_value",
+			code: "invalid_edge_field",
 			message: `tag-note-field is not a valid BC field: '${field}'`,
 		});
 	}
@@ -88,7 +88,7 @@ const get_tag_note_info = (
 		) {
 			return graph_build_fail({
 				path,
-				code: "invalid_field_value",
+				code: "invalid_edge_field",
 				message: `tag-note-sibling-field is not a valid BC field: '${raw_sibling_field}'`,
 			});
 		}

src/interfaces/graph.ts

@@ -5,10 +5,11 @@ import type { GCEdgeData, GCNodeData } from "wasm/pkg/breadcrumbs_graph_wasm";
 import type { MaybePromise } from ".";
 
 export interface BreadcrumbsError {
-	// TODO: Differentiate between invalid edge-field and invalid metadata-field values
-	// BUT: Some errors might be a metadata field with an invalid edge-field value
+	// `invalid_edge_field`: a value names a BC edge-field that isn't registered.
+	// `invalid_field_value`: a metadata field holds a malformed/wrong-typed value.
 	code:
 		| "deprecated_field"
+		| "invalid_edge_field"
 		| "invalid_field_value"
 		| "invalid_setting_value"
 		| "invalid_yaml"