refactor: simplify authHandler type and standardize IterableAuthFailureReason enum values

Author: lposen

src/core/classes/IterableConfig.ts

@@ -204,9 +204,7 @@ export class IterableConfig {
    * @returns A promise that resolves to an `IterableAuthResponse`, a `string`,
    * or `undefined`.
    */
-  authHandler?: () => Promise<
-    IterableAuthResponse | IterableAuthFailure | string | undefined
-  >;
+  authHandler?: () => Promise<IterableAuthResponse | string | undefined>;
 
   /**
    * A callback function that is called when the SDK encounters an error while

src/core/enums/IterableAuthFailureReason.ts

@@ -8,32 +8,32 @@ export enum IterableAuthFailureReason {
    * An auth token's expiration must be less than one year from its issued-at
    * time.
    */
-  AUTH_TOKEN_EXPIRATION_INVALID,
+  AUTH_TOKEN_EXPIRATION_INVALID = 'AUTH_TOKEN_EXPIRATION_INVALID',
   /** The token has expired. */
-  AUTH_TOKEN_EXPIRED,
+  AUTH_TOKEN_EXPIRED = 'AUTH_TOKEN_EXPIRED',
   /** Token has an invalid format (failed a regular expression check). */
-  AUTH_TOKEN_FORMAT_INVALID,
+  AUTH_TOKEN_FORMAT_INVALID = 'AUTH_TOKEN_FORMAT_INVALID',
   /** `onAuthTokenRequested` threw an exception. */
-  AUTH_TOKEN_GENERATION_ERROR,
+  AUTH_TOKEN_GENERATION_ERROR = 'AUTH_TOKEN_GENERATION_ERROR',
   /** Any other error not captured by another constant. */
-  AUTH_TOKEN_GENERIC_ERROR,
+  AUTH_TOKEN_GENERIC_ERROR = 'AUTH_TOKEN_GENERIC_ERROR',
   /** Iterable has invalidated this token and it cannot be used. */
-  AUTH_TOKEN_INVALIDATED,
+  AUTH_TOKEN_INVALIDATED = 'AUTH_TOKEN_INVALIDATED',
   /** The request to Iterable's API did not include a JWT authorization header. */
-  AUTH_TOKEN_MISSING,
+  AUTH_TOKEN_MISSING = 'AUTH_TOKEN_MISSING',
   /** `onAuthTokenRequested` returned a null JWT token. */
-  AUTH_TOKEN_NULL,
+  AUTH_TOKEN_NULL = 'AUTH_TOKEN_NULL',
   /**
    * Iterable could not decode the token's payload (`iat`, `exp`, `email`,
    * or `userId`).
    */
-  AUTH_TOKEN_PAYLOAD_INVALID,
+  AUTH_TOKEN_PAYLOAD_INVALID = 'AUTH_TOKEN_PAYLOAD_INVALID',
   /** Iterable could not validate the token's authenticity. */
-  AUTH_TOKEN_SIGNATURE_INVALID,
+  AUTH_TOKEN_SIGNATURE_INVALID = 'AUTH_TOKEN_SIGNATURE_INVALID',
   /**
    * The token doesn't include an `email` or a `userId`. Or, one of these
    * values is included, but it references a user that isn't in the Iterable
    * project.
    */
-  AUTH_TOKEN_USER_KEY_INVALID,
+  AUTH_TOKEN_USER_KEY_INVALID = 'AUTH_TOKEN_USER_KEY_INVALID',
 }