@bitblit/ratchet-common 4.0.128-alpha → 4.0.130-alpha

package/lib/lang/promise-ratchet.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promise-ratchet.spec.js","sourceRoot":"","sources":["../../src/lang/promise-ratchet.spec.ts"],"names":[],"mappings":"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"}

package/lib/lang/require-ratchet.js

@@ -0,0 +1,56 @@
+export class RequireRatchet {
+    static isNullOrUndefined(ob) {
+        return ob === null || ob === undefined;
+    }
+    static notNullOrUndefined(ob, name = 'object') {
+        if (RequireRatchet.isNullOrUndefined(ob)) {
+            throw new Error(name + ' may not be null or undefined');
+        }
+    }
+    static notNullUndefinedOrOnlyWhitespaceString(ob, name = 'string') {
+        if (RequireRatchet.isNullOrUndefined(ob) || ob.trim() === '') {
+            throw new Error(name + ' may not be null or undefined or only whitespace string');
+        }
+    }
+    static notNullUndefinedOrEmptyArray(ob, name = 'string') {
+        if (RequireRatchet.isNullOrUndefined(ob) || ob.length === 0) {
+            throw new Error(name + ' may not be null or undefined or an empty array');
+        }
+    }
+    static equal(ob1, ob2, message = 'Values must be equal') {
+        if (ob1 !== ob2) {
+            throw new Error(message);
+        }
+    }
+    static true(ob, message = 'Value must be true') {
+        RequireRatchet.equal(ob, true, message);
+    }
+    static noNullOrUndefinedValuesInArray(arr, expectedLength = null, customMsg = null) {
+        RequireRatchet.notNullOrUndefined(arr, 'Source array may not be null');
+        if (expectedLength !== null && arr.length !== expectedLength) {
+            throw new Error(`Expected array of length ${expectedLength} but was ${arr.length} ${customMsg}`);
+        }
+        for (let i = 0; i < arr.length; i++) {
+            if (RequireRatchet.isNullOrUndefined(arr[i])) {
+                throw new Error(`Array index ${i} was null or undefined ${customMsg}`);
+            }
+        }
+    }
+    static noNullOrUndefinedValuesInRestArgs(expectedLength, ...restArgs) {
+        RequireRatchet.notNullOrUndefined(restArgs, 'Source array may not be null');
+        if (expectedLength !== null && restArgs.length !== expectedLength) {
+            throw new Error(`Expected array of length ${expectedLength} but was ${restArgs.length}`);
+        }
+        for (let i = 0; i < restArgs.length; i++) {
+            if (RequireRatchet.isNullOrUndefined(restArgs[i])) {
+                throw new Error(`Array index ${i} was null or undefined`);
+            }
+        }
+    }
+    static constructorArgumentsMatchLengthAndAreNonNull() {
+        const args = Array.from(arguments);
+        const len = this.constructor.length;
+        return RequireRatchet.noNullOrUndefinedValuesInArray(args, len);
+    }
+}
+//# sourceMappingURL=require-ratchet.js.map

package/lib/lang/require-ratchet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"require-ratchet.js","sourceRoot":"","sources":["../../src/lang/require-ratchet.ts"],"names":[],"mappings":"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"}

package/lib/lang/require-ratchet.spec.js

@@ -0,0 +1,81 @@
+import { RequireRatchet } from './require-ratchet.js';
+import { fail } from 'assert';
+import { Logger } from '../logger/logger.js';
+describe('#standardCases', function () {
+    it('should throw exception on null value', function () {
+        try {
+            RequireRatchet.notNullOrUndefined(null, 'test1');
+            fail('Should have thrown exception');
+        }
+        catch (err) {
+            Logger.debug('Correctly threw exception : %s', err);
+        }
+        try {
+            RequireRatchet.notNullOrUndefined(undefined, 'test2');
+            fail('Should have thrown exception');
+        }
+        catch (err) {
+            Logger.debug('Correctly threw exception : %s', err);
+        }
+    });
+    it('should throw exception on whitespace value', function () {
+        try {
+            RequireRatchet.notNullUndefinedOrOnlyWhitespaceString('', 'test1');
+            fail('Should have thrown exception');
+        }
+        catch (err) {
+            Logger.debug('Correctly threw exception : %s', err);
+        }
+        try {
+            RequireRatchet.notNullUndefinedOrOnlyWhitespaceString('    ', 'test2');
+            fail('Should have thrown exception');
+        }
+        catch (err) {
+            Logger.debug('Correctly threw exception : %s', err);
+        }
+    });
+});
+describe('#noNullOrUndefinedValuesInArray', function () {
+    it('should throw exception on null value', function () {
+        const arr = [1, null, 'a'];
+        try {
+            RequireRatchet.noNullOrUndefinedValuesInArray(arr);
+            fail('Should have thrown exception');
+        }
+        catch (err) {
+            Logger.debug('Correctly threw exception : %s', err);
+        }
+    });
+    it('throw exception on bad length', function () {
+        const arr = [1, 2, 'a'];
+        try {
+            RequireRatchet.noNullOrUndefinedValuesInArray(arr, 4);
+            fail('Should have thrown exception');
+        }
+        catch (err) {
+            Logger.debug('Correctly threw exception : %s', err);
+        }
+    });
+    it('should not throw exception on good values', function () {
+        const arr = [1, 2, 'a'];
+        RequireRatchet.noNullOrUndefinedValuesInArray(arr, 3);
+    });
+    it('should not throw exception on good constructor values', function () {
+        const test = new ConstructorTester('a', 'b');
+    });
+    it('throw exception on null constructor param', function () {
+        try {
+            const test = new ConstructorTester('a', null);
+            fail('Should have thrown exception');
+        }
+        catch (err) {
+            Logger.debug('Correctly threw exception : %s', err);
+        }
+    });
+});
+export class ConstructorTester {
+    constructor(testVal1, testVal2) {
+        Logger.info('Args : %j', this.constructor);
+    }
+}
+//# sourceMappingURL=require-ratchet.spec.js.map

package/lib/lang/require-ratchet.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"require-ratchet.spec.js","sourceRoot":"","sources":["../../src/lang/require-ratchet.spec.ts"],"names":[],"mappings":"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"}

package/lib/lang/stop-watch.js

@@ -0,0 +1,115 @@
+import { DurationRatchet } from './duration-ratchet.js';
+import { StringRatchet } from './string-ratchet.js';
+import { RequireRatchet } from './require-ratchet.js';
+import { LoggerLevelName } from '../logger/logger-level-name.js';
+import { Logger } from '../logger/logger.js';
+export class StopWatch {
+    label;
+    starts = new Map();
+    ends = new Map();
+    createTime = Date.now();
+    constructor(label = StringRatchet.createRandomHexString(4)) {
+        this.label = label;
+    }
+    start(name) {
+        RequireRatchet.notNullUndefinedOrOnlyWhitespaceString(name, 'name');
+        const now = Date.now();
+        this.starts.set(StringRatchet.trimToNull(name), now);
+        return now;
+    }
+    stop(name) {
+        RequireRatchet.notNullUndefinedOrOnlyWhitespaceString(name, 'name');
+        const now = Date.now();
+        this.ends.set(StringRatchet.trimToNull(name), now);
+        return now;
+    }
+    reset(name) {
+        RequireRatchet.notNullUndefinedOrOnlyWhitespaceString(name, 'name');
+        this.starts.delete(StringRatchet.trimToNull(name));
+        this.ends.delete(StringRatchet.trimToNull(name));
+    }
+    hasTimer(name) {
+        RequireRatchet.notNullUndefinedOrOnlyWhitespaceString(name, 'name');
+        return this.starts.has(name);
+    }
+    log(name, shortForm, logLevel = LoggerLevelName.info) {
+        Logger.logByLevel(logLevel, this.dump(name, shortForm));
+    }
+    logExpected(pctComplete, name, shortForm, logLevel = LoggerLevelName.info) {
+        Logger.logByLevel(logLevel, this.dumpExpected(pctComplete, name, shortForm));
+    }
+    dump(name, shortForm) {
+        let rval = this.label + ' ';
+        const cleanName = StringRatchet.trimToNull(name);
+        if (cleanName && !this.hasTimer(cleanName)) {
+            rval += 'No such timer : ' + cleanName;
+        }
+        else {
+            const start = name ? this.starts.get(cleanName) : this.createTime;
+            const end = name ? this.ends.get(cleanName) : Date.now();
+            rval += (cleanName || 'Default') + ' ';
+            if (!!start && !!end) {
+                rval += 'completed in ' + DurationRatchet.formatMsDuration(end - start, !shortForm);
+            }
+            else if (!!start) {
+                rval += 'running for ' + DurationRatchet.formatMsDuration(Date.now() - start, !shortForm);
+            }
+        }
+        return rval;
+    }
+    dumpExpected(pctComplete, name, shortForm) {
+        let rval = this.label + ' ';
+        const cleanName = StringRatchet.trimToNull(name);
+        if (cleanName && !this.hasTimer(cleanName)) {
+            rval += 'No such timer : ' + cleanName;
+        }
+        else {
+            if (!pctComplete || pctComplete <= 0) {
+                rval += 'Cannot generate output for 0 percent complete';
+            }
+            else if (pctComplete > 1) {
+                rval += 'Cannot generate output for percent > 1';
+            }
+            else {
+                rval += (cleanName || 'Default') + ' ';
+                const start = name ? this.starts.get(cleanName) : this.createTime;
+                const end = name ? this.ends.get(cleanName) : Date.now();
+                if (!!start && !!end) {
+                    rval += 'completed in ' + DurationRatchet.formatMsDuration(end - start, !shortForm);
+                }
+                else if (!!start) {
+                    const now = Date.now();
+                    const elapsedMS = now - start;
+                    const expectedTotalMS = elapsedMS / pctComplete;
+                    const remainMS = expectedTotalMS - elapsedMS;
+                    rval +=
+                        'running for ' +
+                            DurationRatchet.formatMsDuration(elapsedMS, !shortForm) +
+                            ' approx ' +
+                            DurationRatchet.formatMsDuration(remainMS, !shortForm) +
+                            ' remaining';
+                }
+            }
+        }
+        return rval;
+    }
+    elapsedMS(name) {
+        let rval = null;
+        const cleanName = StringRatchet.trimToNull(name);
+        if (cleanName && !this.hasTimer(cleanName)) {
+            rval = null;
+        }
+        else {
+            const start = name ? this.starts.get(cleanName) : this.createTime;
+            const end = name ? this.ends.get(cleanName) : Date.now();
+            if (!!start && !!end) {
+                rval = end - start;
+            }
+            else if (!!start) {
+                rval = Date.now() - start;
+            }
+        }
+        return rval;
+    }
+}
+//# sourceMappingURL=stop-watch.js.map

package/lib/lang/stop-watch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-watch.js","sourceRoot":"","sources":["../../src/lang/stop-watch.ts"],"names":[],"mappings":"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"}

package/lib/lang/string-ratchet.js

@@ -0,0 +1,203 @@
+import { RequireRatchet } from './require-ratchet.js';
+class StringRatchet {
+    static RFC_3986_RESERVED = ['!', '*', "'", '(', ')', ';', ':', '@', '&', '=', '+', '$', ',', '/', '?', '#', '[', ']', '%'];
+    static stringToUint8Array(val) {
+        return val ? new TextEncoder().encode(val) : null;
+    }
+    static uint8ArrayToString(val) {
+        return val ? new TextDecoder().decode(val) : null;
+    }
+    static attemptJsonParse(val) {
+        let rval = null;
+        if (StringRatchet.trimToNull(val)) {
+            try {
+                rval = JSON.parse(val);
+            }
+            catch (err) {
+                rval = null;
+            }
+        }
+        return rval;
+    }
+    static canParseAsJson(val) {
+        return !!StringRatchet.attemptJsonParse(val);
+    }
+    static allUnique(input) {
+        let rval = true;
+        if (input) {
+            const check = new Set();
+            for (let i = 0; i < input.length && rval; i++) {
+                const test = input.charAt(i);
+                rval = !check.has(test);
+                check.add(test);
+            }
+        }
+        return rval;
+    }
+    static allPermutationsOfLength(len, alphabet) {
+        const rval = [];
+        if (len > 0 && alphabet && alphabet.length > 0) {
+            RequireRatchet.true(StringRatchet.allUnique(alphabet), 'Alphabet must be unique');
+            const step = len === 1 ? [''] : StringRatchet.allPermutationsOfLength(len - 1, alphabet);
+            for (let i = 0; i < alphabet.length; i++) {
+                step.forEach((s) => rval.push(alphabet.charAt(i) + s));
+            }
+        }
+        return rval;
+    }
+    static createType4Guid() {
+        return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function (c) {
+            const r = (Math.random() * 16) | 0, v = c == 'x' ? r : (r & 0x3) | 0x8;
+            return v.toString(16);
+        });
+    }
+    static createRandomHexString(len = 10) {
+        let r = '';
+        for (let i = 0; i < len; i++) {
+            r += Math.floor(Math.random() * 16).toString(16);
+        }
+        return r;
+    }
+    static canonicalize(value) {
+        let rval = value ? value.toLowerCase() : '';
+        rval = rval.replace(' ', '-');
+        StringRatchet.RFC_3986_RESERVED.forEach((s) => {
+            rval = rval.replace(s, '');
+        });
+        return rval;
+    }
+    static formatBytes(bytes, decimals = 2) {
+        if (bytes == 0)
+            return '0 Bytes';
+        const k = 1024, dm = decimals || 2, sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'], i = Math.floor(Math.log(bytes) / Math.log(k));
+        return parseFloat((bytes / Math.pow(k, i)).toFixed(dm)) + ' ' + sizes[i];
+    }
+    static safeString(input) {
+        let rval = null;
+        if (input != null) {
+            const type = typeof input;
+            if (type == 'string') {
+                rval = input;
+            }
+            else {
+                rval = String(input);
+            }
+        }
+        return rval;
+    }
+    static stringContainsOnlyNumbers(input) {
+        const rval = /^[0-9]+$/.test(input);
+        return rval;
+    }
+    static stringContainsOnlyAlphanumeric(input) {
+        const rval = /^[0-9a-zA-Z]+$/.test(input);
+        return rval;
+    }
+    static stringContainsOnlyHex(input) {
+        const rval = /^[0-9a-fA-F]+$/.test(input);
+        return rval;
+    }
+    static stringContainsOnly(inVal, validCharsIn) {
+        const input = !inVal ? '' : inVal;
+        const validChars = !validCharsIn ? '' : validCharsIn;
+        let rval = true;
+        for (let i = 0; i < input.length && rval; i++) {
+            rval = validChars.indexOf(input.charAt(i)) >= 0;
+        }
+        return rval;
+    }
+    static obscure(input, prefixLength = 2, suffixLength = 2) {
+        if (!input) {
+            return input;
+        }
+        const len = input.length;
+        let pl = prefixLength;
+        let sl = suffixLength;
+        while (len > 0 && len < pl + sl + 1) {
+            pl = Math.max(0, pl - 1);
+            sl = Math.max(0, sl - 1);
+        }
+        const rem = len - (pl + sl);
+        let rval = '';
+        rval += input.substring(0, pl);
+        for (let i = 0; i < rem; i++) {
+            rval += '*';
+        }
+        rval += input.substring(len - sl);
+        return rval;
+    }
+    static leadingZeros(inVal, size) {
+        const pad = '00000000000000000000000000000000000000000000000000';
+        let negative = false;
+        let sVal = String(inVal);
+        if (sVal.startsWith('-')) {
+            negative = true;
+            sVal = sVal.substring(1);
+        }
+        if (size > pad.length) {
+            throw new Error('Cannot format number that large');
+        }
+        let rval = (pad + sVal).slice(-1 * size);
+        if (negative) {
+            rval = '-' + rval;
+        }
+        return rval;
+    }
+    static trimToEmpty(input) {
+        const t = input ? StringRatchet.safeString(input) : '';
+        return t.trim();
+    }
+    static trimToNull(input) {
+        const x = StringRatchet.trimToEmpty(input);
+        return x.length > 0 ? x : null;
+    }
+    static trimAllStringPropertiesToNullInPlace(input) {
+        return StringRatchet.trimAllStringPropertiesInPlace(input, false);
+    }
+    static trimAllStringPropertiesToEmptyInPlace(input) {
+        return StringRatchet.trimAllStringPropertiesInPlace(input, true);
+    }
+    static trimAllStringPropertiesInPlace(input, toEmpty) {
+        const dealKeys = Object.keys(input);
+        dealKeys.forEach((key) => {
+            const val = input[key];
+            if (val != null && typeof val === 'string') {
+                input[key] = toEmpty ? StringRatchet.trimToEmpty(input[key]) : StringRatchet.trimToNull(input[key]);
+            }
+        });
+        return input;
+    }
+    static stripNonNumeric(input) {
+        let rval = input;
+        if (input != null && !StringRatchet.stringContainsOnlyNumbers(input)) {
+            rval = '';
+            for (let i = 0; i < input.length; i++) {
+                const c = input.charAt(i);
+                if (StringRatchet.stringContainsOnlyNumbers(c) || (i === 0 && c === '-')) {
+                    rval += c;
+                }
+            }
+        }
+        return rval;
+    }
+    static csvSafe(input) {
+        let rval = StringRatchet.trimToEmpty(StringRatchet.safeString(input));
+        rval.split('"').join('\\"');
+        if (rval.indexOf(',') !== -1 || rval.indexOf('"') !== -1 || rval.indexOf("'") !== -1) {
+            rval = '"' + rval + '"';
+        }
+        return rval;
+    }
+    static stripNonAscii(value) {
+        const reduced = [...value].reduce((previousValue, currentValue) => {
+            const charCode = currentValue.charCodeAt(0);
+            if (charCode > 127) {
+                return previousValue;
+            }
+            return previousValue + currentValue;
+        });
+        return reduced;
+    }
+}
+export { StringRatchet };
+//# sourceMappingURL=string-ratchet.js.map

package/lib/lang/string-ratchet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-ratchet.js","sourceRoot":"","sources":["../../src/lang/string-ratchet.ts"],"names":[],"mappings":"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"}

package/lib/lang/string-ratchet.spec.js

@@ -0,0 +1,159 @@
+import { StringRatchet } from './string-ratchet.js';
+describe('#formatBytes', function () {
+    it('should format 0 bytes correctly', function () {
+        const result = StringRatchet.formatBytes(0);
+        expect(result).toEqual('0 Bytes');
+    });
+    it('should format less than a Kb correctly', function () {
+        const result = StringRatchet.formatBytes(123);
+        expect(result).toEqual('123 Bytes');
+    });
+    it('should format less than a Mb correctly', function () {
+        const result = StringRatchet.formatBytes(1024);
+        expect(result).toEqual('1 KB');
+    });
+    it('should format less than a Mb correctly with 3 decimals', function () {
+        const result = StringRatchet.formatBytes(1234, 3);
+        expect(result).toEqual('1.205 KB');
+    });
+});
+describe('#safeToString', function () {
+    it('should return "asdf"', function () {
+        const result = StringRatchet.safeString('asdf');
+        expect(result).toEqual('asdf');
+    });
+    it('should return "55"', function () {
+        const result = StringRatchet.safeString(55);
+        expect(result).toEqual('55');
+    });
+});
+describe('#obscure', function () {
+    it('should return "pa****rd"', function () {
+        const result = StringRatchet.obscure('password', 2, 2);
+        expect(result).toEqual('pa****rd');
+    });
+    it('should return null', function () {
+        const result = StringRatchet.obscure(null, 2, 2);
+        expect(result).toBeNull();
+    });
+    it('should return "p**s"', function () {
+        const result = StringRatchet.obscure('pass', 2, 2);
+        expect(result).toEqual('p**s');
+    });
+    it('should return "****"', function () {
+        const result = StringRatchet.obscure('pass', 0, 0);
+        expect(result).toEqual('****');
+    });
+    it('should return "p***"', function () {
+        const result = StringRatchet.obscure('pass', 1, 0);
+        expect(result).toEqual('p***');
+    });
+    it('should return "***s"', function () {
+        const result = StringRatchet.obscure('pass', 0, 1);
+        expect(result).toEqual('***s');
+    });
+});
+describe('#guid', function () {
+    it('should generate a guid"', function () {
+        const result = StringRatchet.createType4Guid();
+        expect(result).toBeTruthy();
+    });
+});
+describe('#randomHexString', function () {
+    it('should generate a random hex string"', function () {
+        const result = StringRatchet.createRandomHexString(12);
+        expect(result).toBeTruthy();
+        expect(result.length).toEqual(12);
+    });
+});
+describe('#leadingZeros', function () {
+    it('should generate string with leading zeros"', function () {
+        const result = StringRatchet.leadingZeros(25, 4);
+        expect(result).toEqual('0025');
+    });
+    it('should generate string with leading zeros and a negative sign"', function () {
+        const result = StringRatchet.leadingZeros(-8, 2);
+        expect(result).toEqual('-08');
+    });
+});
+describe('#stripNonNumeric', function () {
+    it('should return a string containing only numbers"', function () {
+        const result = StringRatchet.stripNonNumeric('702-555-1212');
+        expect(result).toEqual('7025551212');
+    });
+});
+describe('#stringContainsOnly', function () {
+    it('should check string contains only valid chars"', function () {
+        expect(StringRatchet.stringContainsOnly('test', 'tes')).toBeTruthy();
+        expect(StringRatchet.stringContainsOnly('test', 'teg')).toBeFalsy();
+        expect(StringRatchet.stringContainsOnlyAlphanumeric('test')).toBeTruthy();
+        expect(StringRatchet.stringContainsOnlyAlphanumeric('tes-')).toBeFalsy();
+        expect(StringRatchet.stringContainsOnlyHex('1a3')).toBeTruthy();
+        expect(StringRatchet.stringContainsOnlyHex('test')).toBeFalsy();
+    });
+});
+describe('#stringCsvSafe', function () {
+    it('should make values safe to place in a CSV"', function () {
+        expect(StringRatchet.csvSafe('test')).toEqual('test');
+        expect(StringRatchet.csvSafe('test,and 1')).toEqual('"test,and 1"');
+        expect(StringRatchet.csvSafe(1)).toEqual('1');
+        expect(StringRatchet.csvSafe("test'blah")).toEqual('"test\'blah"');
+    });
+});
+describe('#trimToEmpty', function () {
+    it('should return an empty string for null"', function () {
+        const result = StringRatchet.trimToEmpty(null);
+        expect(result).toEqual('');
+    });
+    it('should return an empty string for undefined"', function () {
+        const result = StringRatchet.trimToEmpty(undefined);
+        expect(result).toEqual('');
+    });
+    it('should return an empty string"', function () {
+        const result = StringRatchet.trimToEmpty('     ');
+        expect(result).toEqual('');
+    });
+    it('should return an abc"', function () {
+        const result = StringRatchet.trimToEmpty('abc   ');
+        expect(result).toEqual('abc');
+    });
+    it('should return string "5"', function () {
+        const result = StringRatchet.trimToEmpty(5);
+        expect(result).toEqual('5');
+    });
+});
+describe('#trimStringPropertiesInPlace', function () {
+    it('should trim properties to null"', function () {
+        const test = {
+            a: 'test   ',
+            b: 1,
+            c: '    test',
+            d: null,
+            e: '     ',
+        };
+        const nullResult = StringRatchet.trimAllStringPropertiesToNullInPlace(test);
+        expect(nullResult).not.toBeNull();
+        expect(nullResult['a']).toEqual('test');
+        expect(nullResult['b']).toEqual(1);
+        expect(nullResult['c']).toEqual('test');
+        expect(nullResult['d']).toEqual(null);
+        expect(nullResult['e']).toEqual(null);
+    });
+    it('should trim properties to empty"', function () {
+        const test = {
+            a: 'test   ',
+            b: 1,
+            c: '    test',
+            d: null,
+            e: '     ',
+        };
+        const emptyResult = StringRatchet.trimAllStringPropertiesToEmptyInPlace(test);
+        expect(emptyResult).not.toBeNull();
+        expect(emptyResult['a']).toEqual('test');
+        expect(emptyResult['b']).toEqual(1);
+        expect(emptyResult['c']).toEqual('test');
+        expect(emptyResult['d']).toEqual(null);
+        expect(emptyResult['e']).toEqual('');
+    });
+});
+//# sourceMappingURL=string-ratchet.spec.js.map