ecwt 0.2.0-beta.2 → 0.2.0-beta.3

package/dist/ecwt.cjs

@@ -410,6 +410,36 @@ var EcwtFactory = class {
     }
     return ecwt;
   }
+  /**
+   * Parses token without throwing errors.
+   * @async
+   * @param {string} token String representation of token.
+   * @returns {Promise<{ success: boolean, ecwt: Ecwt | null }>} Returns whether token was parsed and verified successfully and Ecwt if parsed.
+   */
+  async safeVerify(token) {
+    let ecwt;
+    try {
+      ecwt = await this.verify(token);
+      return {
+        success: true,
+        ecwt
+      };
+    } catch (error) {
+      if (error instanceof EcwtParseError) {
+        return {
+          success: false,
+          ecwt: null
+        };
+      }
+      if (error instanceof EcwtInvalidError) {
+        return {
+          success: false,
+          ecwt
+        };
+      }
+      throw error;
+    }
+  }
   /**
    * Revokes token.
    * @async

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "ecwt",
-	"version": "0.2.0-beta.2",
+	"version": "0.2.0-beta.3",
 	"description": "Encrypted CBOR-encoded Web Token",
 	"main": "src/main.js",
 	"type": "module",

package/src/factory.js

@@ -13,6 +13,7 @@ import { Ecwt }                   from './token.js';
 import { base62 }                 from './utils/base62.js';
 import {
 	InvalidPackageInstanceError,
+	EcwtInvalidError,
 	EcwtExpiredError,
 	EcwtRevokedError,
     EcwtParseError }              from './utils/errors.js';
@@ -299,6 +300,41 @@ export class EcwtFactory {
 		return ecwt;
 	}
 
+	/**
+	 * Parses token without throwing errors.
+	 * @async
+	 * @param {string} token String representation of token.
+	 * @returns {Promise<{ success: boolean, ecwt: Ecwt | null }>} Returns whether token was parsed and verified successfully and Ecwt if parsed.
+	 */
+	async safeVerify(token) {
+		let ecwt;
+		try {
+			ecwt = await this.verify(token);
+
+			return {
+				success: true,
+				ecwt,
+			};
+		}
+		catch (error) {
+			if (error instanceof EcwtParseError) {
+				return {
+					success: false,
+					ecwt: null,
+				};
+			}
+
+			if (error instanceof EcwtInvalidError) {
+				return {
+					success: false,
+					ecwt,
+				};
+			}
+
+			throw error;
+		}
+	}
+
 	/**
 	 * Revokes token.
 	 * @async

package/src/utils/errors.js

@@ -5,12 +5,18 @@ export class InvalidPackageInstanceError extends TypeError {
 	}
 }
 
+/**
+ * Error thrown when string token cannot be parsed to Ecwt.
+ */
 export class EcwtParseError extends Error {
 	constructor() {
 		super('Cannot parse data to Ecwt token.');
 	}
 }
 
+/**
+ * Error thrown when parsed Ecwt is invalid.
+ */
 export class EcwtInvalidError extends Error {
 	constructor(ecwt) {
 		super('Ecwt token is invalid.');
@@ -19,6 +25,9 @@ export class EcwtInvalidError extends Error {
 	}
 }
 
+/**
+ * Error thrown when parsed Ecwt is expired.
+ */
 export class EcwtExpiredError extends EcwtInvalidError {
 	constructor(ecwt) {
 		super();
@@ -28,6 +37,9 @@ export class EcwtExpiredError extends EcwtInvalidError {
 	}
 }
 
+/**
+ * Error thrown when parsed Ecwt is revoked.
+ */
 export class EcwtRevokedError extends EcwtInvalidError {
 	constructor(ecwt) {
 		super();