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

package/lib/jwt/expired-jwt-handling.js

@@ -0,0 +1,7 @@
+export var ExpiredJwtHandling;
+(function (ExpiredJwtHandling) {
+    ExpiredJwtHandling[ExpiredJwtHandling["RETURN_NULL"] = 0] = "RETURN_NULL";
+    ExpiredJwtHandling[ExpiredJwtHandling["THROW_EXCEPTION"] = 1] = "THROW_EXCEPTION";
+    ExpiredJwtHandling[ExpiredJwtHandling["ADD_FLAG"] = 2] = "ADD_FLAG";
+})(ExpiredJwtHandling || (ExpiredJwtHandling = {}));
+//# sourceMappingURL=expired-jwt-handling.js.map

package/lib/jwt/expired-jwt-handling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expired-jwt-handling.js","sourceRoot":"","sources":["../../src/jwt/expired-jwt-handling.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,kBAIX;AAJD,WAAY,kBAAkB;IAC5B,yEAAW,CAAA;IACX,iFAAe,CAAA;IACf,mEAAQ,CAAA;AACV,CAAC,EAJW,kBAAkB,KAAlB,kBAAkB,QAI7B"}

package/lib/jwt/jwt-ratchet-like.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=jwt-ratchet-like.js.map

package/lib/jwt/jwt-ratchet-like.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwt-ratchet-like.js","sourceRoot":"","sources":["../../src/jwt/jwt-ratchet-like.ts"],"names":[],"mappings":""}

package/lib/jwt/jwt-ratchet.js

@@ -0,0 +1,166 @@
+import jwt from 'jsonwebtoken';
+import { RequireRatchet } from '../lang/require-ratchet.js';
+import { Logger } from '../logger/logger.js';
+import { StringRatchet } from '../lang/string-ratchet.js';
+import { DurationRatchet } from '../lang/duration-ratchet.js';
+import { LoggerLevelName } from '../logger/logger-level-name.js';
+import { ExpiredJwtHandling } from './expired-jwt-handling.js';
+class JwtRatchet {
+    _encryptionKeyPromise;
+    _decryptKeysPromise;
+    _jtiGenerator;
+    _decryptOnlyKeyUseLogLevel;
+    _parseFailureLogLevel;
+    static EXPIRED_FLAG_NAME = '__jwtServiceExpiredFlag';
+    constructor(_encryptionKeyPromise, _decryptKeysPromise, _jtiGenerator = StringRatchet.createType4Guid, _decryptOnlyKeyUseLogLevel = LoggerLevelName.info, _parseFailureLogLevel = LoggerLevelName.debug) {
+        this._encryptionKeyPromise = _encryptionKeyPromise;
+        this._decryptKeysPromise = _decryptKeysPromise;
+        this._jtiGenerator = _jtiGenerator;
+        this._decryptOnlyKeyUseLogLevel = _decryptOnlyKeyUseLogLevel;
+        this._parseFailureLogLevel = _parseFailureLogLevel;
+        RequireRatchet.notNullOrUndefined(_encryptionKeyPromise, 'encryptionKeyPromise');
+    }
+    get encryptionKeyPromise() {
+        return this._encryptionKeyPromise;
+    }
+    get decryptKeysPromise() {
+        return this._decryptKeysPromise;
+    }
+    get jtiGenerator() {
+        return this._jtiGenerator;
+    }
+    get decryptOnlyKeyUseLogLevel() {
+        return this._decryptOnlyKeyUseLogLevel;
+    }
+    get parseFailureLogLevel() {
+        return this._parseFailureLogLevel;
+    }
+    static hasExpiredFlag(ob) {
+        return ob && ob[JwtRatchet.EXPIRED_FLAG_NAME] === true;
+    }
+    static async invalidSafeDecode(payloadString, decryptKey, logLevel = LoggerLevelName.silly) {
+        let rval = null;
+        try {
+            rval = jwt.verify(payloadString, decryptKey, { ignoreExpiration: true });
+        }
+        catch (err) {
+            Logger.logByLevel(logLevel, 'Caught %s - ignoring', err);
+        }
+        return rval;
+    }
+    static async secondsRemainingUntilExpiration(payloadString) {
+        let rval = null;
+        if (StringRatchet.trimToNull(payloadString)) {
+            const output = await JwtRatchet.decodeTokenNoVerify(payloadString);
+            const nowSecond = Math.floor(Date.now() / 1000);
+            if (output.exp) {
+                const expSeconds = output.exp > nowSecond * 100 ? Math.floor(output.exp / 1000) : output.exp;
+                rval = Math.max(0, expSeconds - nowSecond);
+            }
+        }
+        return rval;
+    }
+    static async msRemainingUntilExpiration(payloadString) {
+        const secs = await JwtRatchet.secondsRemainingUntilExpiration(payloadString);
+        let rval = null;
+        if (secs !== null && secs !== undefined) {
+            rval = secs * 1000;
+        }
+        return rval;
+    }
+    async decodeToken(payloadString, expiredHandling = ExpiredJwtHandling.RETURN_NULL) {
+        const encKeys = await this.encryptionKeyArray();
+        let decKeys = Object.assign([], encKeys);
+        if (this.decryptKeysPromise) {
+            decKeys = decKeys.concat(await this.decryptKeysPromise);
+        }
+        const keysTried = [];
+        let payload = null;
+        for (let i = 0; i < decKeys.length && !payload; i++) {
+            keysTried.push(StringRatchet.obscure(decKeys[i], 1, 1));
+            const logLevel = i === decKeys.length - 1 && this.parseFailureLogLevel ? this.parseFailureLogLevel : LoggerLevelName.silly;
+            payload = await JwtRatchet.invalidSafeDecode(payloadString, decKeys[i], logLevel);
+            if (payload && i >= encKeys.length) {
+                Logger.logByLevel(this.decryptOnlyKeyUseLogLevel, 'Used old key to decode token : %s', StringRatchet.obscure(decKeys[i], 2));
+            }
+        }
+        if (payload) {
+            const nowSeconds = Math.floor(Date.now() / 1000);
+            const expSeconds = payload?.exp && payload.exp > nowSeconds * 100 ? Math.floor(payload.exp / 1000) : payload?.exp;
+            const nbfSeconds = payload?.nbf && payload.nbf > nowSeconds * 100 ? Math.floor(payload.nbf / 1000) : payload?.nbf;
+            if ((expSeconds && nowSeconds >= expSeconds) || (nbfSeconds && nowSeconds <= nbfSeconds)) {
+                const age = nowSeconds - expSeconds;
+                Logger.debug('JWT token expired or before NBF : on %d, %s ago', payload.exp, DurationRatchet.formatMsDuration(age * 1000));
+                switch (expiredHandling) {
+                    case ExpiredJwtHandling.THROW_EXCEPTION:
+                        throw new Error('JWT Token was expired');
+                    case ExpiredJwtHandling.ADD_FLAG:
+                        payload[JwtRatchet.EXPIRED_FLAG_NAME] = true;
+                        break;
+                    default:
+                        payload = null;
+                        break;
+                }
+            }
+        }
+        else {
+            Logger.warn('Unable to parse a payload (Tried %j) from : %s', keysTried, payloadString);
+        }
+        return payload;
+    }
+    async encryptionKeyArray() {
+        const encKey = await this.encryptionKeyPromise;
+        const rval = Array.isArray(encKey) ? encKey : [encKey];
+        if (rval.length < 1) {
+            throw new Error('Cannot create JwtRatchet with empty encryption key set');
+        }
+        return rval;
+    }
+    async selectRandomEncryptionKey() {
+        const encKey = await this.encryptionKeyArray();
+        const rval = encKey[Math.floor(Math.random() * encKey.length)];
+        return rval;
+    }
+    async createTokenString(payload, expirationSeconds, overrideEncryptionKey) {
+        const encKey = StringRatchet.trimToNull(overrideEncryptionKey)
+            ? StringRatchet.trimToNull(overrideEncryptionKey)
+            : await this.selectRandomEncryptionKey();
+        RequireRatchet.notNullOrUndefined(payload, 'payload');
+        payload.jti = this.jtiGenerator ? this.jtiGenerator() : null;
+        if (expirationSeconds) {
+            const nowSeconds = Math.floor(Date.now() / 1000);
+            const expires = nowSeconds + expirationSeconds;
+            Logger.debug('Forcing expiration to %d', expires);
+            payload.exp = expires;
+        }
+        const token = jwt.sign(payload, encKey);
+        return token;
+    }
+    async refreshJWTString(tokenString, allowExpired, expirationSeconds) {
+        const handling = allowExpired ? ExpiredJwtHandling.ADD_FLAG : ExpiredJwtHandling.THROW_EXCEPTION;
+        const payload = await this.decodeToken(tokenString, handling);
+        const originalDurationSeconds = payload.exp && payload.iat ? payload.exp - payload.iat : null;
+        const newExpirationSeconds = expirationSeconds || originalDurationSeconds;
+        JwtRatchet.removeJwtFields(payload);
+        JwtRatchet.removeExpiredFlag(payload);
+        const token = await this.createTokenString(payload, newExpirationSeconds);
+        return token;
+    }
+    static decodeTokenNoVerify(token) {
+        return jwt.decode(token);
+    }
+    static removeJwtFields(ob) {
+        if (ob) {
+            ['iss', 'sub', 'aud', 'exp', 'nbf', 'iat', 'jti'].forEach((k) => {
+                delete ob[k];
+            });
+        }
+    }
+    static removeExpiredFlag(ob) {
+        if (ob) {
+            delete ob[JwtRatchet.EXPIRED_FLAG_NAME];
+        }
+    }
+}
+export { JwtRatchet };
+//# sourceMappingURL=jwt-ratchet.js.map

package/lib/jwt/jwt-ratchet.js.map

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

package/lib/jwt/jwt-ratchet.spec.js

@@ -0,0 +1,50 @@
+import { JwtRatchet } from './jwt-ratchet.js';
+import { ExpiredJwtHandling } from './expired-jwt-handling.js';
+describe('#jwtRatchet', function () {
+    it('should test expiration flag for a token with millisecond expiration', async () => {
+        const jwt = new JwtRatchet(Promise.resolve('test1234'), Promise.resolve([]));
+        const token1 = await jwt.createTokenString({ test: 1, exp: Date.now() - 100 }, null);
+        const output = await jwt.decodeToken(token1, ExpiredJwtHandling.ADD_FLAG);
+        expect(output).not.toBeNull();
+        expect(JwtRatchet.hasExpiredFlag(output)).toBeTruthy();
+    });
+    it('should test expiration calculation for a token', async () => {
+        const jwt = new JwtRatchet(Promise.resolve('test1234'), Promise.resolve([]));
+        const token1 = await jwt.createTokenString({ test: 1 }, 120);
+        const output = await JwtRatchet.secondsRemainingUntilExpiration(token1);
+        expect(output).not.toBeNull();
+        expect(output).toBeLessThan(121);
+        expect(output).toBeGreaterThan(115);
+    });
+    it('should test round-trip for a token', async () => {
+        const jwt = new JwtRatchet(Promise.resolve('test1234'), Promise.resolve([]));
+        const token1 = await jwt.createTokenString({ test: 1 }, 120);
+        const output = await jwt.decodeToken(token1);
+        expect(output).not.toBeNull();
+        expect(output['test']).toEqual(1);
+    });
+    it('should test round-trip for a token with array enc keys', async () => {
+        const jwt = new JwtRatchet(Promise.resolve(['test1234', 'test5678']), Promise.resolve([]));
+        const token1 = await jwt.createTokenString({ test: 1 }, 120);
+        const token2 = await jwt.createTokenString({ test: 1 }, 120);
+        const token3 = await jwt.createTokenString({ test: 1 }, 120);
+        const output1 = await jwt.decodeToken(token1);
+        const output2 = await jwt.decodeToken(token2);
+        const output3 = await jwt.decodeToken(token3);
+        expect(output1).not.toBeNull();
+        expect(output1['test']).toEqual(1);
+        expect(output2).not.toBeNull();
+        expect(output2['test']).toEqual(1);
+        expect(output3).not.toBeNull();
+        expect(output3['test']).toEqual(1);
+    });
+    it('should decode with a decode key', async () => {
+        const jwtOld = new JwtRatchet(Promise.resolve('oldKey'), Promise.resolve([]));
+        const jwtNew = new JwtRatchet(Promise.resolve('newKey'), Promise.resolve(['oldKey']));
+        const token1 = await jwtOld.createTokenString({ test: 1 }, 120);
+        const output = await jwtNew.decodeToken(token1);
+        expect(output).not.toBeNull();
+        expect(output['test']).toEqual(1);
+    });
+});
+//# sourceMappingURL=jwt-ratchet.spec.js.map

package/lib/jwt/jwt-ratchet.spec.js.map

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

package/lib/jwt/jwt-token-base.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=jwt-token-base.js.map

package/lib/jwt/jwt-token-base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwt-token-base.js","sourceRoot":"","sources":["../../src/jwt/jwt-token-base.ts"],"names":[],"mappings":""}

package/lib/lang/array-ratchet.js

@@ -0,0 +1,84 @@
+import { RequireRatchet } from './require-ratchet.js';
+import { MapRatchet } from './map-ratchet.js';
+export class ArrayRatchet {
+    static wrapElementsInArray(input) {
+        return input.map((i) => [i]);
+    }
+    static compareTwoArrays(ar1, ar2, fn) {
+        ar1.sort(fn);
+        ar2.sort(fn);
+        let id1 = 0;
+        let id2 = 0;
+        const rval = {
+            matching: [],
+            setOneOnly: [],
+            setTwoOnly: [],
+        };
+        while (id1 < ar1.length && id2 < ar2.length) {
+            const aVal = ar1[id1];
+            const pVal = ar2[id2];
+            const comp = fn(aVal, pVal);
+            if (comp === 0) {
+                rval.matching.push(aVal);
+                id1++;
+                id2++;
+            }
+            else if (comp < 0) {
+                rval.setOneOnly.push(aVal);
+                id1++;
+            }
+            else {
+                rval.setTwoOnly.push(pVal);
+                id2++;
+            }
+        }
+        if (id1 < ar1.length - 1) {
+            rval.setOneOnly = rval.setOneOnly.concat(ar1.slice(id1));
+        }
+        if (id2 < ar2.length - 1) {
+            rval.setTwoOnly = rval.setTwoOnly.concat(ar2.slice(id2));
+        }
+        return rval;
+    }
+    static extractSubarrayFromSortedByNumberField(input, fieldDotPath, minInclusive, maxExclusive) {
+        if (!input || input.length === 0) {
+            return input;
+        }
+        let bottomIdx = minInclusive === null ? 0 : ArrayRatchet.findSplit(input, fieldDotPath, minInclusive) || 0;
+        const topIdx = maxExclusive === null ? input.length : ArrayRatchet.findSplit(input, fieldDotPath, maxExclusive);
+        const bottomValue = MapRatchet.findValueDotPath(input[bottomIdx], fieldDotPath);
+        if (bottomIdx === input.length - 1 && bottomValue < minInclusive) {
+            return [];
+        }
+        if (bottomIdx < input.length && bottomIdx < topIdx && bottomValue < minInclusive) {
+            bottomIdx++;
+        }
+        return input.slice(bottomIdx, topIdx + 1);
+    }
+    static findSplit(input, fieldDotPath, target) {
+        RequireRatchet.notNullOrUndefined(input);
+        RequireRatchet.notNullOrUndefined(fieldDotPath);
+        RequireRatchet.notNullOrUndefined(target);
+        if (input.length === 0 || MapRatchet.findValueDotPath(input[0], fieldDotPath) > target) {
+            return null;
+        }
+        let min = 0;
+        let max = input.length;
+        let rval = null;
+        while (rval === null) {
+            const curIdx = Math.floor((min + max) / 2);
+            const curVal = MapRatchet.findValueDotPath(input[curIdx], fieldDotPath);
+            if (min === max || min === max - 1) {
+                rval = min;
+            }
+            else if (curVal <= target) {
+                min = curIdx;
+            }
+            else {
+                max = curIdx;
+            }
+        }
+        return rval;
+    }
+}
+//# sourceMappingURL=array-ratchet.js.map

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

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

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

@@ -0,0 +1,69 @@
+import { ArrayRatchet } from './array-ratchet.js';
+const sortedArr = [
+    {
+        n: 'test1',
+        v: 1,
+    },
+    {
+        n: 'test1',
+        v: 2,
+    },
+    {
+        n: 'test1',
+        v: 4,
+    },
+    {
+        n: 'test1',
+        v: 4,
+    },
+    {
+        n: 'test1',
+        v: 7,
+    },
+    {
+        n: 'test1',
+        v: 12,
+    },
+    {
+        n: 'test1',
+        v: 25,
+    },
+    {
+        n: 'test1',
+        v: 30,
+    },
+];
+describe('#extractSubarrayFromSortedByNumberField', function () {
+    it('should extract the subarray', function () {
+        const subArr1 = ArrayRatchet.extractSubarrayFromSortedByNumberField(sortedArr, 'v', 5, 14);
+        expect(subArr1.length).toEqual(2);
+        const subArr2 = ArrayRatchet.extractSubarrayFromSortedByNumberField(sortedArr, 'v', null, 4);
+        expect(subArr2.length).toEqual(4);
+        const subArr3 = ArrayRatchet.extractSubarrayFromSortedByNumberField(sortedArr, 'v', 7, null);
+        expect(subArr3.length).toEqual(4);
+    });
+});
+describe('#compareTwoArrays', function () {
+    it('should create a match report', function () {
+        const arr1 = ['a', 'b', 'c'];
+        const arr2 = ['a', 'e', 'i', 'o', 'u'];
+        const report = ArrayRatchet.compareTwoArrays(arr1, arr2, (a, b) => a.localeCompare(b));
+        expect(report).toBeTruthy();
+        expect(report.setOneOnly.length).toEqual(2);
+        expect(report.setTwoOnly.length).toEqual(4);
+        expect(report.matching.length).toEqual(1);
+    });
+});
+describe('#findSplit', function () {
+    it('should find the split', function () {
+        const split10 = ArrayRatchet.findSplit(sortedArr, 'v', 10);
+        const split4 = ArrayRatchet.findSplit(sortedArr, 'v', 4);
+        const split0 = ArrayRatchet.findSplit(sortedArr, 'v', 0);
+        const split32 = ArrayRatchet.findSplit(sortedArr, 'v', 32);
+        expect(split10).toEqual(4);
+        expect(split4).toEqual(3);
+        expect(split0).toEqual(null);
+        expect(split32).toEqual(7);
+    });
+});
+//# sourceMappingURL=array-ratchet.spec.js.map

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

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

package/lib/lang/base64-ratchet.d.ts

@@ -1,4 +1,4 @@
-/// <reference types="node" />
+/// <reference types="node" resolution-mode="require"/>
 export declare class Base64Ratchet {
     static safeObjectToBase64JSON(input: any): any;
     static safeBase64JSONParse(input: string): any;

package/lib/lang/base64-ratchet.js

@@ -0,0 +1,46 @@
+import { Logger } from '../logger/logger.js';
+export class Base64Ratchet {
+    static safeObjectToBase64JSON(input) {
+        return !!input ? Base64Ratchet.generateBase64VersionOfString(JSON.stringify(input)) : null;
+    }
+    static safeBase64JSONParse(input) {
+        let rval = {};
+        try {
+            if (input) {
+                rval = JSON.parse(Base64Ratchet.base64StringToString(input));
+            }
+        }
+        catch (err) {
+            Logger.warn('Error parsing b64/json : %s as json, got %s', input, err, err);
+            rval = {};
+        }
+        return rval;
+    }
+    static generateBase64VersionOfBlob(blob) {
+        return new Promise(function (resolve, reject) {
+            if (!blob || blob.size == 0) {
+                reject('Wont convert null or non-blob or empty blob');
+            }
+            else {
+                const reader = new FileReader();
+                reader.onloadend = function () {
+                    resolve(reader.result.toString());
+                };
+                reader.readAsDataURL(blob);
+            }
+        });
+    }
+    static generateBase64VersionOfString(input) {
+        return Base64Ratchet.generateBase64VersionOfBuffer(Buffer.from(input));
+    }
+    static generateBase64VersionOfBuffer(input) {
+        return input.toString('base64');
+    }
+    static base64StringToBuffer(input) {
+        return Buffer.from(input, 'base64');
+    }
+    static base64StringToString(input, encoding = 'utf8') {
+        return Buffer.from(input, 'base64').toString(encoding);
+    }
+}
+//# sourceMappingURL=base64-ratchet.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base64-ratchet.js","sourceRoot":"","sources":["../../src/lang/base64-ratchet.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,MAAM,OAAO,aAAa;IAEjB,MAAM,CAAC,sBAAsB,CAAC,KAAU;QAC7C,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,6BAA6B,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7F,CAAC;IAEM,MAAM,CAAC,mBAAmB,CAAC,KAAa;QAC7C,IAAI,IAAI,GAAQ,EAAE,CAAC;QACnB,IAAI;YACF,IAAI,KAAK,EAAE;gBACT,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC;aAC9D;SACF;QAAC,OAAO,GAAG,EAAE;YACZ,MAAM,CAAC,IAAI,CAAC,6CAA6C,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;YAC5E,IAAI,GAAG,EAAE,CAAC;SACX;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,MAAM,CAAC,2BAA2B,CAAC,IAAU;QAClD,OAAO,IAAI,OAAO,CAAC,UAAU,OAAO,EAAE,MAAM;YAC1C,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE;gBAC3B,MAAM,CAAC,6CAA6C,CAAC,CAAC;aACvD;iBAAM;gBACL,MAAM,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;gBAChC,MAAM,CAAC,SAAS,GAAG;oBACjB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;gBACpC,CAAC,CAAC;gBACF,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;aAC5B;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,MAAM,CAAC,6BAA6B,CAAC,KAAa;QACvD,OAAO,aAAa,CAAC,6BAA6B,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACzE,CAAC;IAEM,MAAM,CAAC,6BAA6B,CAAC,KAAa;QAEvD,OAAO,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAEM,MAAM,CAAC,oBAAoB,CAAC,KAAa;QAC9C,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC;IAEM,MAAM,CAAC,oBAAoB,CAAC,KAAa,EAAE,WAA2B,MAAM;QACjF,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACzD,CAAC;CACF"}

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

@@ -0,0 +1,29 @@
+import { Base64Ratchet } from './base64-ratchet.js';
+describe('#base64', function () {
+    it('should parse a buffer from base64', function () {
+        const result = Base64Ratchet.base64StringToBuffer('dGVzdHVzZXI6dGVzdHBhc3M=');
+        expect(result).toBeTruthy();
+        expect(result.length).toEqual(17);
+    });
+    it('should parse a string from base64', function () {
+        const result = Base64Ratchet.base64StringToString('dGVzdHVzZXI6dGVzdHBhc3M=');
+        expect(result).toBeTruthy();
+        expect(result.length).toEqual(17);
+    });
+    it('should round-trip a string', function () {
+        const testString = 'teststring';
+        const enc = Base64Ratchet.generateBase64VersionOfString(testString);
+        const result = Base64Ratchet.base64StringToString(enc);
+        expect(result).toBeTruthy();
+        expect(result).toEqual(testString);
+    });
+    it('should round-trip an object', function () {
+        const testOb = { a: 'teststring', b: 27 };
+        const enc = Base64Ratchet.safeObjectToBase64JSON(testOb);
+        const result = Base64Ratchet.safeBase64JSONParse(enc);
+        expect(result).toBeTruthy();
+        expect(result.a).toEqual(testOb.a);
+        expect(result.b).toEqual(testOb.b);
+    });
+});
+//# sourceMappingURL=base64-ratchet.spec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base64-ratchet.spec.js","sourceRoot":"","sources":["../../src/lang/base64-ratchet.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,QAAQ,CAAC,SAAS,EAAE;IAClB,EAAE,CAAC,mCAAmC,EAAE;QACtC,MAAM,MAAM,GAAW,aAAa,CAAC,oBAAoB,CAAC,0BAA0B,CAAC,CAAC;QACtF,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE;QACtC,MAAM,MAAM,GAAW,aAAa,CAAC,oBAAoB,CAAC,0BAA0B,CAAC,CAAC;QACtF,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE;QAC/B,MAAM,UAAU,GAAW,YAAY,CAAC;QACxC,MAAM,GAAG,GAAW,aAAa,CAAC,6BAA6B,CAAC,UAAU,CAAC,CAAC;QAC5E,MAAM,MAAM,GAAW,aAAa,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC;QAC/D,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE;QAChC,MAAM,MAAM,GAAQ,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;QAC/C,MAAM,GAAG,GAAW,aAAa,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC;QACjE,MAAM,MAAM,GAAQ,aAAa,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAC3D,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/lib/lang/boolean-ratchet.js

@@ -0,0 +1,46 @@
+import { NumberRatchet } from './number-ratchet.js';
+export class BooleanRatchet {
+    static allTrue(vals, emptyArraysReturn = false) {
+        let rval = null;
+        if (!!vals) {
+            if (vals.length > 0) {
+                rval = vals.reduce((a, i) => a && i, true);
+            }
+            else {
+                rval = emptyArraysReturn;
+            }
+        }
+        else {
+            rval = false;
+        }
+        return rval;
+    }
+    static anyTrue(vals, emptyArraysReturn = false) {
+        let rval = null;
+        if (!!vals) {
+            if (vals.length > 0) {
+                rval = vals.reduce((a, i) => a || i, false);
+            }
+            else {
+                rval = emptyArraysReturn;
+            }
+        }
+        else {
+            rval = false;
+        }
+        return rval;
+    }
+    static parseBool(val) {
+        return val === true || (val !== null && val !== undefined && typeof val === 'string' && val.toLowerCase() === 'true');
+    }
+    static intToBool(val) {
+        if (val === null || val === undefined) {
+            return false;
+        }
+        return NumberRatchet.safeNumber(val) !== 0;
+    }
+    static boolToInt(val) {
+        return BooleanRatchet.parseBool(val) ? 1 : 0;
+    }
+}
+//# sourceMappingURL=boolean-ratchet.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"boolean-ratchet.js","sourceRoot":"","sources":["../../src/lang/boolean-ratchet.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,OAAO,cAAc;IAClB,MAAM,CAAC,OAAO,CAAC,IAAe,EAAE,oBAA6B,KAAK;QACvE,IAAI,IAAI,GAAY,IAAI,CAAC;QACzB,IAAI,CAAC,CAAC,IAAI,EAAE;YACV,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE;gBACnB,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;aAC5C;iBAAM;gBACL,IAAI,GAAG,iBAAiB,CAAC;aAC1B;SACF;aAAM;YAEL,IAAI,GAAG,KAAK,CAAC;SACd;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,MAAM,CAAC,OAAO,CAAC,IAAe,EAAE,oBAA6B,KAAK;QACvE,IAAI,IAAI,GAAY,IAAI,CAAC;QACzB,IAAI,CAAC,CAAC,IAAI,EAAE;YACV,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE;gBACnB,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;aAC7C;iBAAM;gBACL,IAAI,GAAG,iBAAiB,CAAC;aAC1B;SACF;aAAM;YAEL,IAAI,GAAG,KAAK,CAAC;SACd;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAGM,MAAM,CAAC,SAAS,CAAC,GAAQ;QAC9B,OAAO,GAAG,KAAK,IAAI,IAAI,CAAC,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,CAAC;IACxH,CAAC;IAGM,MAAM,CAAC,SAAS,CAAC,GAAQ;QAC9B,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,EAAE;YACrC,OAAO,KAAK,CAAC;SACd;QACD,OAAO,aAAa,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;IAGM,MAAM,CAAC,SAAS,CAAC,GAAQ;QAC9B,OAAO,cAAc,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;CACF"}