add logger warning for null/undefined inputs in hashSha256

Author: jaissica12

src/roktManager.ts

@@ -294,20 +294,21 @@ export default class RoktManager {
      * Hashes an attribute using SHA-256
      * 
      * @param {string | number | boolean | undefined | null} attribute - The value to hash
-     * @returns {Promise<string>} The SHA-256 hex digest of the normalized value
+     * @returns {Promise<string | undefined | null>} SHA-256 hashed value or undefined/null
      * 
      */
-    public async hashSha256(attribute: string | number | boolean | undefined | null): Promise<string> {
-        if (attribute === undefined || attribute === null) {
-            throw new Error('Value cannot be null or undefined');
+    public async hashSha256(attribute: string | number | boolean | undefined | null): Promise<string | undefined | null> {
+        if (attribute === null || attribute === undefined) {
+            this.logger.warning(`hashSha256 received ${attribute} as input`);
+            return attribute as null | undefined;
         }
 
         try {
             const normalizedValue = String(attribute).trim().toLocaleLowerCase();
             return await this.sha256Hex(normalizedValue);
         } catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);
-            this.logger.error('Failed hashSha256: ' + errorMessage);
+            this.logger.error('Failed to hash attribute: ' + errorMessage);
             throw error;
         }
     }

test/jest/roktManager.spec.ts

@@ -255,19 +255,25 @@ describe('RoktManager', () => {
             expect(emptyStringHash).toBe('e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855');
         });
 
-        it('should reject when value is null', async () => {
-            await expect(roktManager.hashSha256(null)).rejects.toThrow('Value cannot be null or undefined');
+        it('should return null and log warning when value is null', async () => {
+            const result = await roktManager.hashSha256(null);
+            
+            expect(result).toBeNull();
+            expect(mockMPInstance.Logger.warning).toHaveBeenCalledWith('hashSha256 received null as input');
         });
 
-        it('should reject when value is undefined', async () => {
-            await expect(roktManager.hashSha256(undefined)).rejects.toThrow('Value cannot be null or undefined');
+        it('should return undefined and log warning when value is undefined', async () => {
+            const result = await roktManager.hashSha256(undefined);
+            
+            expect(result).toBeUndefined();
+            expect(mockMPInstance.Logger.warning).toHaveBeenCalledWith('hashSha256 received undefined as input');
         });
 
         it('should log error when hashing fails', async () => {
             shaSpy.mockRejectedValue(new Error('Hash failed'));
 
             await expect(roktManager.hashSha256('[email protected]')).rejects.toThrow();
-            expect(mockMPInstance.Logger.error).toHaveBeenCalledWith(expect.stringContaining('Failed hashSha256'));
+            expect(mockMPInstance.Logger.error).toHaveBeenCalledWith(expect.stringContaining('Failed to hash attribute'));
         });
 
         it('should hash firstName to known SHA-256 value', async () => {