From 04392071bc1e69e1da0bb0d495cb5cea9b8ffc9b Mon Sep 17 00:00:00 2001
From: Hein <hein@bitechsystems.co.za>
Date: Tue, 29 Apr 2025 17:03:47 +0200
Subject: [PATCH] docs(changeset): Added tryFromBaseN and tryToBaseN

---
 .changeset/orange-tigers-develop.md |  5 ++++
 src/strings/baseNumber.ts           | 37 +++++++++++++++++++++++++++++
 2 files changed, 42 insertions(+)
 create mode 100644 .changeset/orange-tigers-develop.md

diff --git a/.changeset/orange-tigers-develop.md b/.changeset/orange-tigers-develop.md
new file mode 100644
index 0000000..807c3e1
--- /dev/null
+++ b/.changeset/orange-tigers-develop.md
@@ -0,0 +1,5 @@
+---
+"@warkypublic/artemis-kit": patch
+---
+
+Added tryFromBaseN and tryToBaseN
diff --git a/src/strings/baseNumber.ts b/src/strings/baseNumber.ts
index 4b91d9b..57d5f2e 100644
--- a/src/strings/baseNumber.ts
+++ b/src/strings/baseNumber.ts
@@ -82,4 +82,41 @@ export function toBaseN(num: number | bigint, base: number = 36): string {
 
   // Add negative sign if necessary
   return bigNum < BigInt(0) ? '-' + result : result;
+}
+
+
+/**
+ * Convert a string in a given base to a decimal number, if it fails, returns fallback
+ * This implementation targets ES6+ and uses BigInt for large number support
+ * 
+ * @param str The string to convert
+ * @param base The base to convert from (2-36)
+ * @returns The decimal number as BigInt
+ */
+export function tryFromBaseN(str: string, base: number = 36, fallback: bigint | number = 0): bigint| number {
+  try {
+    return fromBaseN(str, base)
+  } catch(_e) {
+    console.warn("tryFromBaseN",str,base,_e)
+    return fallback
+  }
+
+}
+
+/**
+ * Convert a decimal number to a string in a given base, it it fails, use fallback
+ * This implementation targets ES6+ and uses BigInt for large number support
+ * 
+ * @param num The decimal number to convert
+ * @param base The base to convert to (2-36)
+ * @returns The string representation in the specified base
+ */
+export function tryToBaseN(num: number | bigint, base: number = 36, fallback: string = ""): string {
+  try {
+    return toBaseN(num, base)
+  } catch(_e) {
+    console.warn("tryToBaseN",num,base,_e)
+    return fallback
+  }
+
 }
\ No newline at end of file