@degenerate/endpoints 0.0.5 → 0.0.6

package/dist/generic/src/authorization/safe/validation/jwt/verify-token-payload.js

@@ -1,30 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.verifyTokenPayload = void 0;
-const authorization_errors_1 = require("../../../../errors/authorization/authorization-errors");
-const verify_authorization_issuer_1 = require("./payload/verify-authorization-issuer");
-const verify_authorization_subject_1 = require("./payload/verify-authorization-subject");
-const verify_authorization_audience_1 = require("./payload/verify-authorization-audience");
-const verify_authorization_not_before_time_1 = require("./payload/verify-authorization-not-before-time");
-const verify_authorization_expiration_time_1 = require("./payload/verify-authorization-expiration-time");
-const verify_authorization_issued_at_time_1 = require("./payload/verify-authorization-issued-at-time");
-/**
- * This function verifies the payload of the token to have the minimum token information from the decoded token payload.
- *
- * @param payload the payload to verify
- * @returns void (throws an error if the payload is not valid)
- */
-const verifyTokenPayload = (payload) => {
-    if (!payload || typeof payload !== 'object') {
-        throw new authorization_errors_1.SafeAuthorizationPayloadNotValidError();
-    }
-    // make sure the issued at time is a valid
-    (0, verify_authorization_issued_at_time_1.verifyAuthorizationIssuedAtTime)(payload.iat);
-    (0, verify_authorization_not_before_time_1.verifyAuthorizationNotBeforeTime)(payload.nbf);
-    (0, verify_authorization_expiration_time_1.verifyAuthorizationExpirationTime)(payload.exp);
-    (0, verify_authorization_subject_1.verifyAuthorizationSubject)(payload.sub);
-    (0, verify_authorization_audience_1.verifyAuthorizationAudience)(payload.aud);
-    (0, verify_authorization_issuer_1.verifyAuthorizationIssuer)(payload.iss);
-    return true;
-};
-exports.verifyTokenPayload = verifyTokenPayload;

package/dist/generic/src/helpers/crypto/cryptography-helpers.d.ts

@@ -1,37 +0,0 @@
-/**
- * this function converts a hex string to a base64 string.
- *
- * @param hex the hex string to convert to base64
- * @returns
- */
-declare const hexToBase64: (hexString: string) => string;
-/**
- * this function converts a base64 string to a hex string.
- *
- * @param base64 the base64 string to convert to hex
- * @returns
- */
-declare const base64ToHex: (base64String: string) => string;
-/**
- * this function converts a base64 string to a PEM string for a public key.
- *
- * @param base64 the base64 string to convert to PEM format.
- * @returns
- */
-declare const base64ToPublicPEM: (base64: string) => string;
-/**
- * this function converts a base64 string to a PEM string for an elliptical curve private key.
- *
- * @param base64 the base64 string to convert to PEM format.
- * @returns
- */
-declare const base64ToPrivateECPEM: (base64: string) => string;
-/**
- * this function converts a base64 string to a PEM string for a private key.
- *
- * @param base64 the base64 string to convert to PEM format.
- * @returns
- */
-declare const base64ToPrivatePEM: (base64: string) => string;
-export { base64ToHex, base64ToPublicPEM, base64ToPrivateECPEM, base64ToPrivatePEM, hexToBase64, };
-//# sourceMappingURL=cryptography-helpers.d.ts.map

package/dist/generic/src/helpers/crypto/cryptography-helpers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cryptography-helpers.d.ts","sourceRoot":"","sources":["../../../../../../generic/src/helpers/crypto/cryptography-helpers.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,QAAA,MAAM,WAAW,cAAe,MAAM,KAAG,MAExC,CAAC;AAEF;;;;;GAKG;AACH,QAAA,MAAM,WAAW,iBAAkB,MAAM,KAAG,MAE3C,CAAC;AAIF;;;;;GAKG;AACH,QAAA,MAAM,iBAAiB,WAAY,MAAM,KAAG,MAK3C,CAAC;AAEF;;;;;GAKG;AACH,QAAA,MAAM,oBAAoB,WAAY,MAAM,KAAG,MAK9C,CAAC;AAEF;;;;;GAKG;AACH,QAAA,MAAM,kBAAkB,WAAY,MAAM,KAAG,MAK5C,CAAC;AAIF,OAAO,EACH,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,WAAW,GACd,CAAC"}

package/dist/generic/src/helpers/crypto/cryptography-helpers.js

@@ -1,65 +0,0 @@
-"use strict";
-// This file contains the helper functions for cryptography in the application.
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.hexToBase64 = exports.base64ToPrivatePEM = exports.base64ToPrivateECPEM = exports.base64ToPublicPEM = exports.base64ToHex = void 0;
-//#region hex to base 64 functions
-/**
- * this function converts a hex string to a base64 string.
- *
- * @param hex the hex string to convert to base64
- * @returns
- */
-const hexToBase64 = (hexString) => {
-    return Buffer.from(hexString, 'hex').toString('base64');
-};
-exports.hexToBase64 = hexToBase64;
-/**
- * this function converts a base64 string to a hex string.
- *
- * @param base64 the base64 string to convert to hex
- * @returns
- */
-const base64ToHex = (base64String) => {
-    return Buffer.from(base64String, 'base64').toString('hex');
-};
-exports.base64ToHex = base64ToHex;
-//#region base 64 to PEM functions
-/**
- * this function converts a base64 string to a PEM string for a public key.
- *
- * @param base64 the base64 string to convert to PEM format.
- * @returns
- */
-const base64ToPublicPEM = (base64) => {
-    // split the base64 into 64 character chunks
-    const regex = /.{64}/g;
-    const formattedBase64 = base64.replace(regex, '$&\n');
-    return `-----BEGIN PUBLIC KEY-----\n${formattedBase64}\n-----END PUBLIC KEY-----`;
-};
-exports.base64ToPublicPEM = base64ToPublicPEM;
-/**
- * this function converts a base64 string to a PEM string for an elliptical curve private key.
- *
- * @param base64 the base64 string to convert to PEM format.
- * @returns
- */
-const base64ToPrivateECPEM = (base64) => {
-    // split the base64 into 64 character chunks
-    const regex = /.{64}/g;
-    const formattedBase64 = base64.replace(regex, '$&\n');
-    return `-----BEGIN EC PRIVATE KEY-----\n${formattedBase64}\n-----END EC PRIVATE KEY-----`;
-};
-exports.base64ToPrivateECPEM = base64ToPrivateECPEM;
-/**
- * this function converts a base64 string to a PEM string for a private key.
- *
- * @param base64 the base64 string to convert to PEM format.
- * @returns
- */
-const base64ToPrivatePEM = (base64) => {
-    // split the base64 into 64 character chunks
-    const regex = /.{64}/g;
-    const formattedBase64 = base64.replace(regex, '$&\n');
-    return `-----BEGIN PRIVATE KEY-----\n${formattedBase64}\n-----END PRIVATE KEY-----`;
-};
-exports.base64ToPrivatePEM = base64ToPrivatePEM;

package/dist/generic/src/helpers/object-validation-helpers.d.ts

@@ -1,66 +0,0 @@
-/**
- * Checks that an object is an array and that it has the minimum number of items.
- *
- * @param incomingObject the object to check
- * @param minimumLength the minimum number of objects to match (zero by default)
- * @param maximumLength the maximum number of objects to match will default to the array length if not provided
- *
- * @returns whether the criteria matches.
- */
-declare const validateArray: (incomingObject: unknown, minimumLength?: number, maximumLength?: number) => boolean;
-/**
- * This validates an incoming shape of a boolean type data.
- *
- * @param incomingObject an object to validate as a boolean.
- * @param undefinedValid whether the item can be undefined or not (false by default)
- *
- * @returns whether the shape is valid.
- */
-declare const validateBoolean: (incomingObject: unknown, undefinedValid?: boolean) => boolean;
-/**
- * This validates a date object or a string that can be converted to a date object.
- * @param dateToValidate the date to validate
- * @param undefinedValid whether the item can be undefined or not (false by default)
- * @param allowFutureDated the date can be in the future (false by default)
- * @param ensureAtLeast18YearsAgo whether the date is at least 18 years ago (true by default)
- *
- * @returns
- */
-declare const validateDate: (dateToValidate: unknown, undefinedValid?: boolean, allowFutureDated?: boolean, ensureAtLeast18YearsAgo?: boolean) => boolean;
-/**
- * This validates that the incoming Object is a number and that it is in the range (if provided)
- *
- * @param incomingObject object to validate to a number
- * @param min (optional) minimum number
- * @param max (optional) maximum number
- * @returns
- */
-declare const validateNumber: (incomingObject: unknown, min?: number, max?: number) => boolean;
-/**
- * This validates an incoming shape of a set of files links to the data.
- *
- * @param incomingObject an object to validate as a string.
- * @param hasNoSpaces whether the item should have no spaces in it (false by default)
- * @param undefinedValid whether the item can be undefined or not (false by default)
- * @param emptyStringValid whether the item can be an empty string or not (false by default)
- *
- * @returns whether the shape is valid.
- */
-declare const validateString: (incomingObject: unknown, hasNoSpaces?: boolean, undefinedValid?: boolean, emptyStringValid?: boolean) => boolean;
-/**
- * This validates that an incoming object is a valid hex string without spaces.
- *
- * @param incomingObject the object to validate
- * @returns
- */
-declare const validateStringHex: (incomingObject: unknown) => boolean;
-/**
- * This validates that an incoming object is a valid URL.
- *
- * @param incomingUrl the URL to check
- * @param undefinedValid whether the item can be undefined or not (false by default)
- * @returns wether it is a valid URL or not
- */
-declare const validateUrl: (incomingUrl: unknown, undefinedValid?: boolean) => boolean;
-export { validateArray, validateBoolean, validateDate, validateNumber, validateString, validateStringHex, validateUrl, };
-//# sourceMappingURL=object-validation-helpers.d.ts.map

package/dist/generic/src/helpers/object-validation-helpers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"object-validation-helpers.d.ts","sourceRoot":"","sources":["../../../../../generic/src/helpers/object-validation-helpers.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,QAAA,MAAM,aAAa,mBAAoB,OAAO,0CAAqC,MAAM,KAAG,OAc3F,CAAC;AAEF;;;;;;;GAOG;AACH,QAAA,MAAM,eAAe,mBAAoB,OAAO,+BAA2B,OAS1E,CAAC;AAEF;;;;;;;;GAQG;AACH,QAAA,MAAM,YAAY,mBAAoB,OAAO,8FACP,OAoCrC,CAAC;AAEF;;;;;;;GAOG;AACH,QAAA,MAAM,cAAc,mBAAoB,OAAO,QAAQ,MAAM,QAAQ,MAAM,KAAG,OAU7E,CAAC;AAEF;;;;;;;;;GASG;AACH,QAAA,MAAM,cAAc,mBAAoB,OAAO,kFAA0E,OAiCxH,CAAC;AAEF;;;;;GAKG;AACH,QAAA,MAAM,iBAAiB,mBAAoB,OAAO,KAAG,OAepD,CAAC;AAEF;;;;;;GAMG;AACH,QAAA,MAAM,WAAW,gBAAiB,OAAO,+BAA2B,OAqBnE,CAAC;AA+CF,OAAO,EACH,aAAa,EACb,eAAe,EACf,YAAY,EACZ,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,WAAW,GACd,CAAC"}

package/dist/generic/src/helpers/object-validation-helpers.js

@@ -1,254 +0,0 @@
-"use strict";
-// This file contains the validation functions for objects.
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateUrl = exports.validateStringHex = exports.validateString = exports.validateNumber = exports.validateDate = exports.validateBoolean = exports.validateArray = void 0;
-/**
- * Checks that an object is an array and that it has the minimum number of items.
- *
- * @param incomingObject the object to check
- * @param minimumLength the minimum number of objects to match (zero by default)
- * @param maximumLength the maximum number of objects to match will default to the array length if not provided
- *
- * @returns whether the criteria matches.
- */
-const validateArray = (incomingObject, minimumLength = 0, maximumLength) => {
-    if (incomingObject && Array.isArray(incomingObject) && incomingObject.length >= minimumLength) {
-        if (!maximumLength) {
-            return true;
-        }
-        else {
-            if (incomingObject.length <= maximumLength) {
-                return true;
-            }
-            else {
-                return false;
-            }
-        }
-    }
-    else {
-        return false;
-    }
-};
-exports.validateArray = validateArray;
-/**
- * This validates an incoming shape of a boolean type data.
- *
- * @param incomingObject an object to validate as a boolean.
- * @param undefinedValid whether the item can be undefined or not (false by default)
- *
- * @returns whether the shape is valid.
- */
-const validateBoolean = (incomingObject, undefinedValid = false) => {
-    if (undefinedValid && typeof incomingObject === 'undefined') { // if undefined is valid and it"s undefined
-        return true;
-    }
-    if (typeof incomingObject === 'boolean') {
-        return true;
-    }
-    else {
-        return false;
-    }
-};
-exports.validateBoolean = validateBoolean;
-/**
- * This validates a date object or a string that can be converted to a date object.
- * @param dateToValidate the date to validate
- * @param undefinedValid whether the item can be undefined or not (false by default)
- * @param allowFutureDated the date can be in the future (false by default)
- * @param ensureAtLeast18YearsAgo whether the date is at least 18 years ago (true by default)
- *
- * @returns
- */
-const validateDate = (dateToValidate, undefinedValid = false, allowFutureDated = false, ensureAtLeast18YearsAgo = false) => {
-    if (undefinedValid && (typeof dateToValidate === 'undefined' || dateToValidate === '' || dateToValidate === null)) {
-        return true;
-    }
-    let date; // a placeholder for the date object
-    if (typeof dateToValidate === 'string') {
-        date = new Date(dateToValidate); // try to parse the date
-        if (isNaN(date.getTime())) { // if it's not a valid date
-            return false; // return false
-        }
-        return true;
-    }
-    else {
-        if (!(typeof dateToValidate === 'object' && dateToValidate !== null)) {
-            return false; // the date isn't an object
-        }
-        if (Object.prototype.toString.call(dateToValidate) !== '[object Date]') {
-            return false; // the date isn't a date object
-        }
-        // Check if the date is in the future and this is not allowed
-        if (!allowFutureDated && dateToValidate > new Date()) {
-            return false;
-        }
-        // determine if the date is newer than 18 years in the past
-        if (ensureAtLeast18YearsAgo) {
-            const today = new Date();
-            const eighteenYearsAgo = new Date(today.getFullYear() - 18, today.getMonth(), today.getDate());
-            return dateToValidate <= eighteenYearsAgo;
-        }
-        // otherwise the date is valid.
-        return true;
-    }
-};
-exports.validateDate = validateDate;
-/**
- * This validates that the incoming Object is a number and that it is in the range (if provided)
- *
- * @param incomingObject object to validate to a number
- * @param min (optional) minimum number
- * @param max (optional) maximum number
- * @returns
- */
-const validateNumber = (incomingObject, min, max) => {
-    if (typeof incomingObject === 'number') {
-        if (validateMin(incomingObject, min) && validateMax(incomingObject, max)) {
-            return true;
-        }
-        else {
-            return false;
-        }
-    }
-    else {
-        return false;
-    }
-};
-exports.validateNumber = validateNumber;
-/**
- * This validates an incoming shape of a set of files links to the data.
- *
- * @param incomingObject an object to validate as a string.
- * @param hasNoSpaces whether the item should have no spaces in it (false by default)
- * @param undefinedValid whether the item can be undefined or not (false by default)
- * @param emptyStringValid whether the item can be an empty string or not (false by default)
- *
- * @returns whether the shape is valid.
- */
-const validateString = (incomingObject, hasNoSpaces = false, undefinedValid = false, emptyStringValid = false) => {
-    // if undefined is valid and check if it's undefined and if so, return true
-    if (undefinedValid) {
-        if (typeof incomingObject === 'undefined') { // if undefined is valid and it"s undefined
-            return true;
-        }
-        if (incomingObject === null) { // include null values.
-            return true;
-        }
-    }
-    // Check if the string is empty and if it's valid to be empty
-    if (emptyStringValid) {
-        if (typeof incomingObject === 'string' && incomingObject.length === 0) {
-            return true;
-        }
-    }
-    // if it's a string and it's not empty
-    if (typeof incomingObject === 'string') {
-        // check that it is a string and that it is not empty
-        if (incomingObject.length === 0) {
-            return false;
-        }
-        // check if it has no spaces
-        if (hasNoSpaces) {
-            return incomingObject.indexOf(' ') === -1;
-        }
-        // otherwise it's a valid string
-        return true;
-    }
-    else {
-        return false;
-    }
-};
-exports.validateString = validateString;
-/**
- * This validates that an incoming object is a valid hex string without spaces.
- *
- * @param incomingObject the object to validate
- * @returns
- */
-const validateStringHex = (incomingObject) => {
-    // make sure its a string
-    const isStringWithoutSpaces = validateString(incomingObject, true, false, false);
-    // make sure its a valid hex string
-    if (!isStringWithoutSpaces) {
-        return false;
-    }
-    // check that it is a hex string
-    const hexStringRegexp = /^[0-9a-fA-F]+$/;
-    if (!hexStringRegexp.test(incomingObject)) {
-        return false;
-    }
-    return true;
-};
-exports.validateStringHex = validateStringHex;
-/**
- * This validates that an incoming object is a valid URL.
- *
- * @param incomingUrl the URL to check
- * @param undefinedValid whether the item can be undefined or not (false by default)
- * @returns wether it is a valid URL or not
- */
-const validateUrl = (incomingUrl, undefinedValid = false) => {
-    if (undefinedValid && (typeof incomingUrl === 'undefined' || incomingUrl === '')) { // if undefined is valid and it"s undefined
-        return true;
-    }
-    if (typeof incomingUrl !== 'string') {
-        return false;
-    }
-    if (incomingUrl.indexOf(' ') !== -1) {
-        return false;
-    }
-    //Is it recognized as a valid URL?
-    let givenURL;
-    try {
-        givenURL = new URL(incomingUrl);
-        //Is the domain name a valid one with TLD and using HTTP or HTTPS?
-        const validDomainRegexp = /^([a-z0-9]+(-[a-z0-9]+)*\.)+[a-z]{2,}$/im;
-        return validDomainRegexp.test(givenURL.host) && (givenURL.protocol === 'http:' || givenURL.protocol === 'https:');
-    }
-    catch (error) {
-        return false;
-    }
-};
-exports.validateUrl = validateUrl;
-//#endregion Public Functions
-//#region Internal Functions
-/**
- * validates that an incoming number is greater than the minimum if it was provided.
- *
- * @param incomingNumber the number to check
- * @param min the minimum value.
- * @returns
- */
-const validateMin = (incomingNumber, min) => {
-    if (typeof min === 'number') {
-        if (incomingNumber >= min) {
-            return true;
-        }
-        else {
-            return false;
-        }
-    }
-    else {
-        return true;
-    }
-};
-/**
- * validates that an incoming number is less than or equal to the mamimum if it was provided.
- *
- * @param incomingNumber the number to check
- * @param max the maximum value.
- * @returns
- */
-const validateMax = (incomingNumber, max) => {
-    if (typeof max === 'number') {
-        if (incomingNumber <= max) {
-            return true;
-        }
-        else {
-            return false;
-        }
-    }
-    else {
-        return true;
-    }
-};