feat: add better handlnig

Author: char0n

README.md

@@ -356,7 +356,7 @@ URIFragmentIdentifier.from('#/foo%22bar'); // => '/foo"bar'
 #### Errors
 
 `@swaggerexpert/json-pointer` provides a structured error class hierarchy,
-enabling precise error handling across JSON Pointer operations, including parsing, evaluation and compilation and validation.
+enabling precise error handling across JSON Pointer operations, including parsing, evaluation ,compilation and validation.
 
 ```js
 import {

src/compile.js

@@ -7,7 +7,14 @@ const compile = (referenceTokens) => {
       return '';
     }
 
-    return `/${referenceTokens.map(escape).join('/')}`;
+    return `/${referenceTokens
+      .map((referenceToken) => {
+        if (typeof referenceToken !== 'string' && typeof referenceToken !== 'number') {
+          throw new TypeError('Reference token must be a string or number');
+        }
+        return escape(String(referenceToken));
+      })
+      .join('/')}`;
   } catch (error) {
     throw new JSONPointerCompileError('Unknown error during JSON Pointer compilation', {
       cause: error,

src/errors/JSONPointerTypeError.js

@@ -2,7 +2,10 @@ import JSONPointerEvaluateError from './JSONPointerEvaluateError.js';
 
 class JSONPointerTypeError extends JSONPointerEvaluateError {
   constructor(referenceToken, options) {
-    super(`Invalid reference token: '${referenceToken}' (not an object/array)`, options);
+    super(
+      `Reference token '${referenceToken}' cannot be applied to non object/array value)`,
+      options,
+    );
   }
 }
 

src/escape.js

@@ -1,5 +1,9 @@
 const escape = (referenceToken) => {
-  return referenceToken.replace(/~/g, '~0').replace(/\//g, '~1');
+  if (typeof referenceToken !== 'string' && typeof referenceToken !== 'number') {
+    throw new TypeError('Reference token must be a string or number');
+  }
+
+  return String(referenceToken).replace(/~/g, '~0').replace(/\//g, '~1');
 };
 
 export default escape;

src/representation/uri-fragment-identifier.js

@@ -9,9 +9,8 @@ export const to = (jsonPointer) => {
 };
 
 export const from = (fragment) => {
-  const rfc3986Fragment = fragment.startsWith('#') ? fragment.slice(1) : fragment;
-
   try {
+    const rfc3986Fragment = fragment.startsWith('#') ? fragment.slice(1) : fragment;
     return decodeURIComponent(rfc3986Fragment);
   } catch {
     return fragment;