qlcodes 1.0.0

package/references/ORACLE_errors.csv

@@ -0,0 +1,171 @@
+0;successful completion;ORA-00000;;;;
+1000;warning;;;;;
+1001;cursor operation conflict;;;;;
+1002;disconnect error;;;;;
+1003;null value eliminated in set function;;;;;
+1004;string data - right truncation;;;;;
+1005;insufficient item descriptor areas;;;;;
+1006;privilege not revoked;;;;;
+1007;privilege not granted;;;;;
+1008;implicit zero-bit padding;;;;;
+1009;search condition too long for info schema;;;;;
+0100A;query expression too long for info schema;;;;;
+2000;no data;"ORA-01095
+ORA-01403";;;;
+7000;dynamic SQL error;;;;;
+7001;using clause does not match parameter specs;;;;;
+7002;using clause does not match target specs;;;;;
+7003;cursor specification cannot be executed;;;;;
+7004;using clause required for dynamic parameters;;;;;
+7005;prepared statement not a cursor specification;;;;;
+7006;restricted datatype attribute violation;;;;;
+7007;using clause required for result fields;;;;;
+7008;invalid descriptor count;SQL-02126;;;;
+7009;invalid descriptor index;;;;;
+8000;connection exception;;;;;
+8001;SQL client unable to establish SQL connection;;;;;
+8002;connection name in use;;;;;
+8003;connection does not exist;SQL-02121;;;;
+8004;SQL server rejected SQL connection;;;;;
+8006;connection failure;;;;;
+8007;transaction resolution unknown;;;;;
+0A000;feature not supported;ORA-03000 .. 03099;;;;
+0A001;multiple server transactions;;;;;
+21000;cardinality violation;"ORA-01427
+SQL-02112";;;;
+22000;data exception;;;;;
+22001;string data - right truncation;"ORA-01401
+ORA-01406";;;;
+22002;null value - no indicator parameter;"ORA-01405
+SQL-02124";;;;
+22003;numeric value out of range;"ORA-01426
+ORA-01438
+ORA-01455
+ORA-01457";;;;
+22005;error in assignment;;;;;
+22007;invalid date-time format;;;;;
+22008;date-time field overflow;ORA-01800 .. 01899;;;;
+22009;invalid time zone displacement value;;;;;
+22011;substring error;;;;;
+22012;division by zero;ORA-01476;;;;
+22015;interval field overflow;;;;;
+22018;invalid character value for cast;;;;;
+22019;invalid escape character;"ORA-00911
+ORA-01425";;;;
+22021;character not in repertoire;;;;;
+22022;indicator overflow;ORA-01411;;;;
+22023;invalid parameter value;"ORA-01025
+ORA-01488
+ORA-04000 .. 04019";;;;
+22024;unterminated C string;ORA-01479 .. 01480;;;;
+22025;invalid escape sequence;ORA-01424;;;;
+22026;string data - length mismatch;;;;;
+22027;trim error;;;;;
+23000;integrity constraint violation;"ORA-00001
+ORA-02290 .. 02299";;;;
+24000;invalid cursor state;"ORA-01001 .. 01003
+ORA-01410
+ORA-08006
+SQL-02114
+SQL-02117
+SQL-02118
+SQL-02122";;;;
+25000;invalid transaction state;;;;;
+26000;invalid SQL statement name;;;;;
+27000;triggered data change violation;;;;;
+28000;invalid authorization specification;;;;;
+2A000;direct SQL syntax error or access rule violation;;;;;
+2B000;dependent privilege descriptors still exist;;;;;
+2C000;invalid character set name;;;;;
+2D000;invalid transaction termination;;;;;
+"2E000";invalid connection name;;;;;
+33000;invalid SQL descriptor name;;;;;
+34000;invalid cursor name;;;;;
+35000;invalid condition number;;;;;
+37000;dynamic SQL syntax error or access rule violation;;;;;
+3C000;ambiguous cursor name;;;;;
+3D000;invalid catalog name;;;;;
+3F000;invalid schema name;;;;;
+40000;transaction rollback;ORA-02091 .. 02092;;;;
+40001;serialization failure;;;;;
+40002;integrity constraint violation;;;;;
+40003;statement completion unknown;;;;;
+42000;syntax error or access rule violation;"ORA-00022
+ORA-00251
+ORA-00900 .. 00999
+ORA-01031
+ORA-01490 .. 01493
+ORA-01700 .. 01799
+ORA-01900 .. 02099
+ORA-02140 .. 02289
+ORA-02420 .. 02424
+ORA-02450 .. 02499
+ORA-03276 .. 03299
+ORA-04040 .. 04059
+ORA-04070 .. 04099";;;;
+44000;with check option violation;ORA-01402;;;;
+60000;system errors;"ORA-00370 .. 00429
+ORA-00600 .. 00899
+ORA-06430 .. 06449
+ORA-07200 .. 07999
+ORA-09700 .. 09999";;;;
+61000;resource error;"ORA-00018 .. 00035
+ORA-00050 .. 00068
+ORA-02376 .. 02399
+ORA-04020 .. 04039";;;;
+62000;path name server and detached process errors;"ORA-00100 .. 00120
+ORA-00440 .. 00569";;;;
+63000;Oracle*XA and two-task interface errors;"ORA-00150 .. 00159
+SQL-02128
+ORA-02700 .. 02899
+ORA-03100 .. 03199
+ORA-06200 .. 06249";;;;
+64000;"control file, database file, and redo file errors;
+archival and media recovery errors";"ORA-00200 .. 00369
+ORA-01100 .. 01250";;;;
+65000;PL/SQL errors;ORA-06500 .. 06599;;;;
+66000;SQL*Net driver errors;"ORA-06000 .. 06149
+ORA-06250 .. 06429
+ORA-06600 .. 06999
+ORA-12100 .. 12299
+ORA-12500 .. 12599";;;;
+67000;licensing errors;ORA-00430 .. 00439;;;;
+69000;SQL*Connect errors;"ORA-00570 .. 00599
+ORA-07000 .. 07199";;;;
+72000;SQL execute phase errors;"ORA-01000 .. 01099
+ORA-01400 .. 01489
+ORA-01495 .. 01499
+ORA-01500 .. 01699
+ORA-02400 .. 02419
+ORA-02425 .. 02449
+ORA-04060 .. 04069
+ORA-08000 .. 08190
+ORA-12000 .. 12019
+ORA-12300 .. 12499
+ORA-12700 .. 21999";;;;
+82100;out of memory (could not allocate);SQL-02100;;;;
+82101;inconsistent cursor cache: unit cursor/global cursor mismatch;SQL-02101;;;;
+82102;inconsistent cursor cache: no global cursor entry;SQL-02102;;;;
+82103;inconsistent cursor cache: out of range cursor cache reference;SQL-02103;;;;
+82104;inconsistent host cache: no cursor cache available;SQL-02104;;;;
+82105;inconsistent cursor cache: global cursor not found;SQL-02105;;;;
+82106;inconsistent cursor cache: invalid Oracle cursor number;SQL-02106;;;;
+82107;program too old for runtime library;SQL-02107;;;;
+82108;invalid descriptor passed to runtime library;SQL-02108;;;;
+82109;inconsistent host cache: host reference is out of range;SQL-02109;;;;
+82110;inconsistent host cache: invalid host cache entry type;SQL-02110;;;;
+82111;heap consistency error;SQL-02111;;;;
+82112;unable to open message file;SQL-02113;;;;
+82113;code generation internal consistency failed;SQL-02115;;;;
+82114;reentrant code generator gave invalid context;SQL-02116;;;;
+82115;invalid hstdef argument;SQL-02119;;;;
+82116;first and second arguments to sqlrcn both null;SQL-02120;;;;
+82117;invalid OPEN or PREPARE for this connection;SQL-02122;;;;
+82118;application context not found;SQL-02123;;;;
+82119;"connect error; can't get error text";SQL-02125;;;;
+82120;precompiler/SQLLIB version mismatch.;SQL-02127;;;;
+82121;FETCHed number of bytes is odd;SQL-02129;;;;
+82122;EXEC TOOLS interface is not available;SQL-02130;;;;
+90000;debug events;ORA-10000 .. 10999;;;;
+99999;catch all;all others;;;;
+HZ000;remote database access;;;;;

package/references/PSQL_errors.csv

@@ -0,0 +1,284 @@
+Error Code;Condition Name
+Class 00 — Successful Completion;
+0;successful_completion
+Class 01 — Warning;
+1000;warning
+0100C;dynamic_result_sets_returned
+1008;implicit_zero_bit_padding
+1003;null_value_eliminated_in_set_function
+1007;privilege_not_granted
+1006;privilege_not_revoked
+1004;string_data_right_truncation
+01P01;deprecated_feature
+Class 02 — No Data (this is also a warning class per the SQL standard);
+2000;no_data
+2001;no_additional_dynamic_result_sets_returned
+Class 03 — SQL Statement Not Yet Complete;
+3000;sql_statement_not_yet_complete
+Class 08 — Connection Exception;
+8000;connection_exception
+8003;connection_does_not_exist
+8006;connection_failure
+8001;sqlclient_unable_to_establish_sqlconnection
+8004;sqlserver_rejected_establishment_of_sqlconnection
+8007;transaction_resolution_unknown
+08P01;protocol_violation
+Class 09 — Triggered Action Exception;
+9000;triggered_action_exception
+Class 0A — Feature Not Supported;
+0A000;feature_not_supported
+Class 0B — Invalid Transaction Initiation;
+0B000;invalid_transaction_initiation
+Class 0F — Locator Exception;
+0F000;locator_exception
+0F001;invalid_locator_specification
+Class 0L — Invalid Grantor;
+0L000;invalid_grantor
+0LP01;invalid_grant_operation
+Class 0P — Invalid Role Specification;
+0P000;invalid_role_specification
+Class 0Z — Diagnostics Exception;
+0Z000;diagnostics_exception
+0Z002;stacked_diagnostics_accessed_without_active_handler
+Class 20 — Case Not Found;
+20000;case_not_found
+Class 21 — Cardinality Violation;
+21000;cardinality_violation
+Class 22 — Data Exception;
+22000;data_exception
+2202E;array_subscript_error
+22021;character_not_in_repertoire
+22008;datetime_field_overflow
+22012;division_by_zero
+22005;error_in_assignment
+2200B;escape_character_conflict
+22022;indicator_overflow
+22015;interval_field_overflow
+2201E;invalid_argument_for_logarithm
+22014;invalid_argument_for_ntile_function
+22016;invalid_argument_for_nth_value_function
+2201F;invalid_argument_for_power_function
+2201G;invalid_argument_for_width_bucket_function
+22018;invalid_character_value_for_cast
+22007;invalid_datetime_format
+22019;invalid_escape_character
+2200D;invalid_escape_octet
+22025;invalid_escape_sequence
+22P06;nonstandard_use_of_escape_character
+22010;invalid_indicator_parameter_value
+22023;invalid_parameter_value
+2201B;invalid_regular_expression
+2201W;invalid_row_count_in_limit_clause
+2201X;invalid_row_count_in_result_offset_clause
+2202H;invalid_tablesample_argument
+2202G;invalid_tablesample_repeat
+22009;invalid_time_zone_displacement_value
+2200C;invalid_use_of_escape_character
+2200G;most_specific_type_mismatch
+22004;null_value_not_allowed
+22002;null_value_no_indicator_parameter
+22003;numeric_value_out_of_range
+2200H;sequence_generator_limit_exceeded
+22026;string_data_length_mismatch
+22001;string_data_right_truncation
+22011;substring_error
+22027;trim_error
+22024;unterminated_c_string
+2200F;zero_length_character_string
+22P01;floating_point_exception
+22P02;invalid_text_representation
+22P03;invalid_binary_representation
+22P04;bad_copy_file_format
+22P05;untranslatable_character
+2200L;not_an_xml_document
+2200M;invalid_xml_document
+2200N;invalid_xml_content
+2200S;invalid_xml_comment
+2200T;invalid_xml_processing_instruction
+Class 23 — Integrity Constraint Violation;
+23000;integrity_constraint_violation
+23001;restrict_violation
+23502;not_null_violation
+23503;foreign_key_violation
+23505;unique_violation
+23514;check_violation
+23P01;exclusion_violation
+Class 24 — Invalid Cursor State;
+24000;invalid_cursor_state
+Class 25 — Invalid Transaction State;
+25000;invalid_transaction_state
+25001;active_sql_transaction
+25002;branch_transaction_already_active
+25008;held_cursor_requires_same_isolation_level
+25003;inappropriate_access_mode_for_branch_transaction
+25004;inappropriate_isolation_level_for_branch_transaction
+25005;no_active_sql_transaction_for_branch_transaction
+25006;read_only_sql_transaction
+25007;schema_and_data_statement_mixing_not_supported
+25P01;no_active_sql_transaction
+25P02;in_failed_sql_transaction
+25P03;idle_in_transaction_session_timeout
+Class 26 — Invalid SQL Statement Name;
+26000;invalid_sql_statement_name
+Class 27 — Triggered Data Change Violation;
+27000;triggered_data_change_violation
+Class 28 — Invalid Authorization Specification;
+28000;invalid_authorization_specification
+28P01;invalid_password
+Class 2B — Dependent Privilege Descriptors Still Exist;
+2B000;dependent_privilege_descriptors_still_exist
+2BP01;dependent_objects_still_exist
+Class 2D — Invalid Transaction Termination;
+2D000;invalid_transaction_termination
+Class 2F — SQL Routine Exception;
+2F000;sql_routine_exception
+2F005;function_executed_no_return_statement
+2F002;modifying_sql_data_not_permitted
+2F003;prohibited_sql_statement_attempted
+2F004;reading_sql_data_not_permitted
+Class 34 — Invalid Cursor Name;
+34000;invalid_cursor_name
+Class 38 — External Routine Exception;
+38000;external_routine_exception
+38001;containing_sql_not_permitted
+38002;modifying_sql_data_not_permitted
+38003;prohibited_sql_statement_attempted
+38004;reading_sql_data_not_permitted
+Class 39 — External Routine Invocation Exception;
+39000;external_routine_invocation_exception
+39001;invalid_sqlstate_returned
+39004;null_value_not_allowed
+39P01;trigger_protocol_violated
+39P02;srf_protocol_violated
+39P03;event_trigger_protocol_violated
+Class 3B — Savepoint Exception;
+3B000;savepoint_exception
+3B001;invalid_savepoint_specification
+Class 3D — Invalid Catalog Name;
+3D000;invalid_catalog_name
+Class 3F — Invalid Schema Name;
+3F000;invalid_schema_name
+Class 40 — Transaction Rollback;
+40000;transaction_rollback
+40002;transaction_integrity_constraint_violation
+40001;serialization_failure
+40003;statement_completion_unknown
+40P01;deadlock_detected
+Class 42 — Syntax Error or Access Rule Violation;
+42000;syntax_error_or_access_rule_violation
+42601;syntax_error
+42501;insufficient_privilege
+42846;cannot_coerce
+42803;grouping_error
+42P20;windowing_error
+42P19;invalid_recursion
+42830;invalid_foreign_key
+42602;invalid_name
+42622;name_too_long
+42939;reserved_name
+42804;datatype_mismatch
+42P18;indeterminate_datatype
+42P21;collation_mismatch
+42P22;indeterminate_collation
+42809;wrong_object_type
+428C9;generated_always
+42703;undefined_column
+42883;undefined_function
+42P01;undefined_table
+42P02;undefined_parameter
+42704;undefined_object
+42701;duplicate_column
+42P03;duplicate_cursor
+42P04;duplicate_database
+42723;duplicate_function
+42P05;duplicate_prepared_statement
+42P06;duplicate_schema
+42P07;duplicate_table
+42712;duplicate_alias
+42710;duplicate_object
+42702;ambiguous_column
+42725;ambiguous_function
+42P08;ambiguous_parameter
+42P09;ambiguous_alias
+42P10;invalid_column_reference
+42611;invalid_column_definition
+42P11;invalid_cursor_definition
+42P12;invalid_database_definition
+42P13;invalid_function_definition
+42P14;invalid_prepared_statement_definition
+42P15;invalid_schema_definition
+42P16;invalid_table_definition
+42P17;invalid_object_definition
+Class 44 — WITH CHECK OPTION Violation;
+44000;with_check_option_violation
+Class 53 — Insufficient Resources;
+53000;insufficient_resources
+53100;disk_full
+53200;out_of_memory
+53300;too_many_connections
+53400;configuration_limit_exceeded
+Class 54 — Program Limit Exceeded;
+54000;program_limit_exceeded
+54001;statement_too_complex
+54011;too_many_columns
+54023;too_many_arguments
+Class 55 — Object Not In Prerequisite State;
+55000;object_not_in_prerequisite_state
+55006;object_in_use
+55P02;cant_change_runtime_param
+55P03;lock_not_available
+Class 57 — Operator Intervention;
+57000;operator_intervention
+57014;query_canceled
+57P01;admin_shutdown
+57P02;crash_shutdown
+57P03;cannot_connect_now
+57P04;database_dropped
+Class 58 — System Error (errors external to PostgreSQL itself);
+58000;system_error
+58030;io_error
+58P01;undefined_file
+58P02;duplicate_file
+Class 72 — Snapshot Failure;
+72000;snapshot_too_old
+Class F0 — Configuration File Error;
+F0000;config_file_error
+F0001;lock_file_exists
+Class HV — Foreign Data Wrapper Error (SQL/MED);
+HV000;fdw_error
+HV005;fdw_column_name_not_found
+HV002;fdw_dynamic_parameter_value_needed
+HV010;fdw_function_sequence_error
+HV021;fdw_inconsistent_descriptor_information
+HV024;fdw_invalid_attribute_value
+HV007;fdw_invalid_column_name
+HV008;fdw_invalid_column_number
+HV004;fdw_invalid_data_type
+HV006;fdw_invalid_data_type_descriptors
+HV091;fdw_invalid_descriptor_field_identifier
+HV00B;fdw_invalid_handle
+HV00C;fdw_invalid_option_index
+HV00D;fdw_invalid_option_name
+HV090;fdw_invalid_string_length_or_buffer_length
+HV00A;fdw_invalid_string_format
+HV009;fdw_invalid_use_of_null_pointer
+HV014;fdw_too_many_handles
+HV001;fdw_out_of_memory
+HV00P;fdw_no_schemas
+HV00J;fdw_option_name_not_found
+HV00K;fdw_reply_handle
+HV00Q;fdw_schema_not_found
+HV00R;fdw_table_not_found
+HV00L;fdw_unable_to_create_execution
+HV00M;fdw_unable_to_create_reply
+HV00N;fdw_unable_to_establish_connection
+Class P0 — PL/pgSQL Error;
+P0000;plpgsql_error
+P0001;raise_exception
+P0002;no_data_found
+P0003;too_many_rows
+P0004;assert_failure
+Class XX — Internal Error;
+XX000;internal_error
+XX001;data_corrupted
+XX002;index_corrupted

package/src/compose.mjs

@@ -0,0 +1,113 @@
+import fs from "fs";
+import { onStdIn } from "./utils/io.mjs";
+import { CODE_RE, CLASS_RE, COMMENT_RE } from "./regex.mjs";
+import { reargv } from "./utils/args.mjs";
+const argv = reargv();
+function flushBuffer(buffer, currentClass, currentCode) {
+	if (!buffer.length) return buffer;
+
+	const reason = buffer.join("\n").trim();
+	if (currentCode && !/(\w+_)+/.test(reason)) {
+		currentCode.reason = reason;
+	} else if (currentClass && !/(\w+_)+/.test(reason)) {
+		currentClass.reason = reason;
+	}
+	return [];
+}
+
+const apply = (text, errors = {}) => {
+	let buffer = [];
+	let currentClass = null;
+	let currentCode = null;
+
+	for (const rawLine of text.split(/\r?\n/)) {
+		const line = rawLine.trimEnd();
+
+		// Ignore comment lines entirely
+		if (COMMENT_RE.test(line)) {
+			continue;
+		}
+
+		// Class line
+		const classMatch = line.match(CLASS_RE);
+		if (classMatch) {
+			buffer = flushBuffer(buffer, currentClass, currentCode);
+
+			const { classCode, label } = classMatch.groups;
+
+			currentClass = errors[classCode]
+				? errors[classCode]
+				: {
+						label,
+						errorSet: [],
+				  };
+			errors[classCode] = currentClass;
+			currentCode = null;
+			continue;
+		}
+
+		// Error code line
+		const codeMatch = line.match(CODE_RE);
+		if (codeMatch) {
+			buffer = flushBuffer(buffer, currentClass, currentCode);
+
+			let { code, key, flags } = codeMatch.groups;
+			const foundCode = currentClass.errorSet.find((x) => x.code == code);
+			const use = flags.split(":").filter((x) => x);
+
+			key = key.substring(1);
+			currentCode = foundCode || {
+				code,
+				keys: [],
+				use,
+			};
+
+			if (key != "_" && !currentCode.keys.includes(key)) {
+				currentCode.keys.push(key);
+			}
+			if (foundCode) {
+				currentCode.use = [...foundCode.use, ...use];
+			}
+			if (!foundCode) {
+				currentClass.errorSet.push(currentCode);
+			}
+			continue;
+		}
+
+		// reason line (non-empty, non-comment)
+		if (line !== "") {
+			buffer.push(line);
+		}
+	}
+
+	// Flush trailing reason
+	buffer = flushBuffer(buffer, currentClass, currentCode);
+	return errors;
+};
+
+const debugInFile = (file, data = null) => {
+	const isDebug = process.env.DEBUG;
+	if (isDebug) {
+		const fileName = file.replaceAll("../", "");
+		fs.writeFileSync(fileName + ".debug.json", data);
+	}
+};
+if (argv.options.file || argv.files.length) {
+	const file = argv.options.file || argv.files[0];
+
+	onStdIn((content) => {
+		const isDebug = process.env.DEBUG;
+		let errors;
+		try {
+			errors = JSON.parse(content ? content : "{}");
+		} catch {
+			errors = {};
+		}
+
+		debugInFile(file, JSON.stringify(errors, null, isDebug ? 2 : 0));
+
+		console.log(
+			JSON.stringify(apply(fs.readFileSync(file, "utf8"), errors), null, 2)
+		);
+	});
+}

package/src/fileTransformer/sanitize.mjs

@@ -0,0 +1,10 @@
+import { onStdIn } from "../utils/io.mjs";
+
+onStdIn((input) => {
+	console.log(
+		input
+			.replaceAll("SQLSTATE Value;Meaning", "")
+			.replaceAll(`"""`, "")
+			.replace(/;[^;\n]*$/gm, "")
+	);
+});

package/src/fileTransformer/sanitize2.mjs

@@ -0,0 +1,17 @@
+import { insertHeadersAndFormat } from "../utils/codeName.mjs";
+import { onStdIn } from "../utils/io.mjs";
+
+onStdIn((input) => {
+	console.log(
+		insertHeadersAndFormat(
+			input
+				.replaceAll(/\n/gm, "\\")
+				.replaceAll(/;".+"/gm, "")
+				.replaceAll(/(?:;+$)/gm, "")
+				.replaceAll(`"`, "")
+				.replaceAll("\\", "\n")
+				.replaceAll("\r", "")
+				.trim()
+		)
+	);
+});

package/src/fileTransformer/stopNamedKeys.mjs

@@ -0,0 +1,15 @@
+import { onStdIn } from "../utils/io.mjs";
+
+onStdIn((input) => {
+	console.log(
+		input
+			.replaceAll(/ use_of_| the_| an_| a_|for_the_|_the|of_the_/gm, "")
+			.replaceAll(/there_are_|there_is/gm, "")
+			.replaceAll(/in_|is_|are_/gm, "")
+			.replaceAll(/on_a_/gm, "")
+			.replaceAll(/has_been_/gm, "")
+			.replaceAll(/use_of_a_/gm, "")
+			.replaceAll(/_use_of_a|_use_of_an/gm, "")
+			.replaceAll(/_use_of_|_an_/gm, "_")
+	);
+});

package/src/generate.cjs

@@ -0,0 +1,42 @@
+const fs = require("fs");
+const { ERROR_CODE_HEADER_RGX } = require("./regex.mjs");
+const { newCode } = require("./utils/codeName.mjs");
+const { reargv } = require("./utils/args.mjs");
+const { onStdIn } = require("./utils/io.mjs");
+
+const argv = reargv();
+
+const processCSVLines = (fileCSVText) => {
+	let output = [];
+	let currentClassCode = null;
+	for (const line of fileCSVText.split(/\r?\n/)) {
+		if (!line.trim()) continue;
+
+		const [code] = line.split(";", 2);
+
+		let match;
+		if ((match = ERROR_CODE_HEADER_RGX.exec(code))) {
+			let { label, class_code } = match.groups;
+
+			label = label.replace(/^Unqualified\s+/i, "");
+			output.push("", `Class ${class_code} — ${label}`);
+
+			currentClassCode = class_code;
+			continue;
+		}
+
+		if (!currentClassCode) continue;
+
+		output.push(...newCode(line, currentClassCode));
+	}
+	return output.join("\n");
+};
+
+if (argv.options.file || argv.files.length) {
+	const file = argv.options.file || argv.files[0];
+	console.log(processCSVLines(fs.readFileSync(file, "utf8")));
+} else {
+	onStdIn((csv) => {
+		console.log(processCSVLines(csv));
+	});
+}

package/src/index.mjs

@@ -0,0 +1,31 @@
+import data from "../qlCodes.json" with { type : "json" };
+export const lens = (code) => {
+	let error = {
+		code: "-1",
+		keys: [],
+		use: [],
+		reason: `The code '${code}' does not match any entries in qlcodes. This may be a qlcode issue only to provide you with the correct information`,
+	};
+	try {
+		if (
+			code == "" ||
+			(!code && code != "0") ||
+			!/[A-Z0-9]{5}/.test(`${code}`.padStart(5, "0"))
+		)
+			throw "qlcodes_malformed";
+		const paddedCode = `${code}`.padStart(5, "0");
+		const search = Object.entries(data).find(([id]) =>
+			new RegExp(`^${id}`).test(paddedCode)
+		);
+		if (!search) {
+			throw "qlcodes_no_class_found";
+		}
+		const [_, foundClass] = search;
+		if (foundClass)
+			error = foundClass.errorSet.find((x) => (x.code = paddedCode));
+		else throw "qlcodes_no_code_found";
+	} catch (err) {
+		error.keys = [typeof err == "string" ? err : "qlcodes_unexpected_error"];
+	}
+	return error;
+};

package/src/pretty.mjs

@@ -0,0 +1,18 @@
+import fs from "fs";
+import { reargv } from "./utils/args.mjs";
+import { onStdIn } from "./utils/io.mjs";
+
+const isDebug = process.env.DEBUG === "true";
+const argv = reargv();
+
+if (argv.options.file || argv.files.length) {
+	const file = argv.options.file || argv.files[0];
+
+	onStdIn((content) => {
+		fs.writeFile(
+			file,
+			JSON.stringify(JSON.parse(content), null, isDebug ? 2 : undefined),
+			(_) => {}
+		);
+	});
+}