kami-parse-server/spec/Utils.spec.js

const Utils = require('../lib/Utils');
const { createSanitizedError, createSanitizedHttpError } = require("../lib/Error")

describe('Utils', () => {
  describe('encodeForUrl', () => {
    it('should properly escape email with all special ASCII characters for use in URLs', async () => {
      const values = [
        { input: `!\"'),.:;<>?]^}`, output: '%21%22%27%29%2C%2E%3A%3B%3C%3E%3F%5D%5E%7D' },
      ]
      for (const value of values) {
        expect(Utils.encodeForUrl(value.input)).toBe(value.output);
      }
    });
  });

  describe('addNestedKeysToRoot', () => {
    it('should move the nested keys to root of object', async () => {
      const obj = {
        a: 1,
        b: {
          c: 2,
          d: 3
        },
        e: 4
      };
      Utils.addNestedKeysToRoot(obj, 'b');
      expect(obj).toEqual({
        a: 1,
        c: 2,
        d: 3,
        e: 4
      });
    });

    it('should not modify the object if the key does not exist', async () => {
      const obj = {
        a: 1,
        e: 4
      };
      Utils.addNestedKeysToRoot(obj, 'b');
      expect(obj).toEqual({
        a: 1,
        e: 4
      });
    });

    it('should not modify the object if the key is not an object', () => {
      const obj = {
        a: 1,
        b: 2,
        e: 4
      };
      Utils.addNestedKeysToRoot(obj, 'b');
      expect(obj).toEqual({
        a: 1,
        b: 2,
        e: 4
      });
    });
  });

  describe('getCircularReplacer', () => {
    it('should handle Map instances', () => {
      const obj = {
        name: 'test',
        mapData: new Map([
          ['key1', 'value1'],
          ['key2', 'value2']
        ])
      };
      const result = JSON.stringify(obj, Utils.getCircularReplacer());
      expect(result).toBe('{"name":"test","mapData":{"key1":"value1","key2":"value2"}}');
    });

    it('should handle Set instances', () => {
      const obj = {
        name: 'test',
        setData: new Set([1, 2, 3])
      };
      const result = JSON.stringify(obj, Utils.getCircularReplacer());
      expect(result).toBe('{"name":"test","setData":[1,2,3]}');
    });

    it('should handle circular references', () => {
      const obj = { name: 'test', value: 123 };
      obj.self = obj;
      const result = JSON.stringify(obj, Utils.getCircularReplacer());
      expect(result).toBe('{"name":"test","value":123,"self":"[Circular]"}');
    });

    it('should handle nested circular references', () => {
      const obj = {
        name: 'parent',
        child: {
          name: 'child'
        }
      };
      obj.child.parent = obj;
      const result = JSON.stringify(obj, Utils.getCircularReplacer());
      expect(result).toBe('{"name":"parent","child":{"name":"child","parent":"[Circular]"}}');
    });

    it('should handle mixed Map, Set, and circular references', () => {
      const obj = {
        mapData: new Map([['key', 'value']]),
        setData: new Set([1, 2]),
        regular: 'data'
      };
      obj.circular = obj;
      const result = JSON.stringify(obj, Utils.getCircularReplacer());
      expect(result).toBe('{"mapData":{"key":"value"},"setData":[1,2],"regular":"data","circular":"[Circular]"}');
    });

    it('should handle normal objects without modification', () => {
      const obj = {
        name: 'test',
        number: 42,
        nested: {
          key: 'value'
        }
      };
      const result = JSON.stringify(obj, Utils.getCircularReplacer());
      expect(result).toBe('{"name":"test","number":42,"nested":{"key":"value"}}');
    });
  });

  describe('getNestedProperty', () => {
    it('should get top-level property', () => {
      const obj = { foo: 'bar' };
      expect(Utils.getNestedProperty(obj, 'foo')).toBe('bar');
    });

    it('should get nested property with dot notation', () => {
      const obj = { database: { options: { enabled: true } } };
      expect(Utils.getNestedProperty(obj, 'database.options.enabled')).toBe(true);
    });

    it('should return undefined for non-existent property', () => {
      const obj = { foo: 'bar' };
      expect(Utils.getNestedProperty(obj, 'baz')).toBeUndefined();
    });

    it('should return undefined for non-existent nested property', () => {
      const obj = { database: { options: {} } };
      expect(Utils.getNestedProperty(obj, 'database.options.enabled')).toBeUndefined();
    });

    it('should return undefined when path traverses non-object', () => {
      const obj = { database: 'string' };
      expect(Utils.getNestedProperty(obj, 'database.options.enabled')).toBeUndefined();
    });

    it('should return undefined for null object', () => {
      expect(Utils.getNestedProperty(null, 'foo')).toBeUndefined();
    });

    it('should return undefined for empty path', () => {
      const obj = { foo: 'bar' };
      expect(Utils.getNestedProperty(obj, '')).toBeUndefined();
    });

    it('should handle value of 0', () => {
      const obj = { database: { timeout: 0 } };
      expect(Utils.getNestedProperty(obj, 'database.timeout')).toBe(0);
    });

    it('should handle value of false', () => {
      const obj = { database: { enabled: false } };
      expect(Utils.getNestedProperty(obj, 'database.enabled')).toBe(false);
    });

    it('should handle value of empty string', () => {
      const obj = { database: { name: '' } };
      expect(Utils.getNestedProperty(obj, 'database.name')).toBe('');
    });
  });

  describe('createSanitizedError', () => {
    it('should return "Permission denied" when enableSanitizedErrorResponse is true', () => {
      const config = { enableSanitizedErrorResponse: true };
      const error = createSanitizedError(Parse.Error.OPERATION_FORBIDDEN, 'Detailed error message', config);
      expect(error.message).toBe('Permission denied');
    });

    it('should not crash with config undefined', () => {
      const error = createSanitizedError(Parse.Error.OPERATION_FORBIDDEN, 'Detailed error message', undefined);
      expect(error.message).toBe('Permission denied');
    });

    it('should return the detailed message when enableSanitizedErrorResponse is false', () => {
      const config = { enableSanitizedErrorResponse: false };
      const error = createSanitizedError(Parse.Error.OPERATION_FORBIDDEN, 'Detailed error message', config);
      expect(error.message).toBe('Detailed error message');
    });
  });

  describe('createSanitizedHttpError', () => {
    it('should return "Permission denied" when enableSanitizedErrorResponse is true', () => {
      const config = { enableSanitizedErrorResponse: true };
      const error = createSanitizedHttpError(403, 'Detailed error message', config);
      expect(error.message).toBe('Permission denied');
    });

    it('should not crash with config undefined', () => {
      const error = createSanitizedHttpError(403, 'Detailed error message', undefined);
      expect(error.message).toBe('Permission denied');
    });

    it('should return the detailed message when enableSanitizedErrorResponse is false', () => {
      const config = { enableSanitizedErrorResponse: false };
      const error = createSanitizedHttpError(403, 'Detailed error message', config);
      expect(error.message).toBe('Detailed error message');
    });
  });
});