@degenerate/generic 0.1.3 → 0.1.4

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

@@ -0,0 +1,30 @@
+"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/crypto/index.d.ts

@@ -3,6 +3,7 @@ export * from './calculate-combined-hash';
 export * from './private-public-keys/generation/create-256-private-key-from-mnemonic';
 export * from './private-public-keys/generation/create-entropy-for-elliptical-curve';
 export * from './private-public-keys/generation/create-random-256-private-key';
+export * from './private-public-keys/generation/create-random-512-key-pair';
 export * from './private-public-keys/generation/generate-key-pair';
 export * from './private-public-keys/generation/get-private-public-key-from-keypair';
 export * from './private-public-keys/create-key-pair-from-private-key';

package/dist/crypto/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/crypto/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAK1C,cAAc,uEAAuE,CAAC;AACtF,cAAc,sEAAsE,CAAC;AACrF,cAAc,gEAAgE,CAAC;AAC/E,cAAc,oDAAoD,CAAC;AACnE,cAAc,sEAAsE,CAAC;AAGrF,cAAc,wDAAwD,CAAC;AACvE,cAAc,qDAAqD,CAAC;AAMpE,cAAc,qCAAqC,CAAC;AACpD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,6CAA6C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/crypto/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAK1C,cAAc,uEAAuE,CAAC;AACtF,cAAc,sEAAsE,CAAC;AACrF,cAAc,gEAAgE,CAAC;AAC/E,cAAc,6DAA6D,CAAC;AAC5E,cAAc,oDAAoD,CAAC;AACnE,cAAc,sEAAsE,CAAC;AAGrF,cAAc,wDAAwD,CAAC;AACvE,cAAc,qDAAqD,CAAC;AAMpE,cAAc,qCAAqC,CAAC;AACpD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,6CAA6C,CAAC"}

package/dist/crypto/index.js

@@ -21,6 +21,7 @@ __exportStar(require("./calculate-combined-hash"), exports);
 __exportStar(require("./private-public-keys/generation/create-256-private-key-from-mnemonic"), exports);
 __exportStar(require("./private-public-keys/generation/create-entropy-for-elliptical-curve"), exports);
 __exportStar(require("./private-public-keys/generation/create-random-256-private-key"), exports);
+__exportStar(require("./private-public-keys/generation/create-random-512-key-pair"), exports);
 __exportStar(require("./private-public-keys/generation/generate-key-pair"), exports);
 __exportStar(require("./private-public-keys/generation/get-private-public-key-from-keypair"), exports);
 //#endregion folder generation

package/dist/crypto/private-public-keys/create-key-pair-from-private-key.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-key-pair-from-private-key.d.ts","sourceRoot":"","sources":["../../../src/crypto/private-public-keys/create-key-pair-from-private-key.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,MAAM,uCAAuC,CAAC;AAE5G;;;;;GAKG;AACH,QAAA,MAAM,2BAA2B,UAAW,uBAAuB,GAAG,0BAA0B,cAChF,MAAM,KAAG,QAAQ,CAAC,EAAE,CAAC,OAMpC,CAAC;AAEF,OAAO,EAAE,2BAA2B,EAAE,CAAC"}
+{"version":3,"file":"create-key-pair-from-private-key.d.ts","sourceRoot":"","sources":["../../../src/crypto/private-public-keys/create-key-pair-from-private-key.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,MAAM,uCAAuC,CAAC;AAE5G;;;;;GAKG;AACH,QAAA,MAAM,2BAA2B,UAAW,uBAAuB,GAAG,0BAA0B,cAChF,MAAM,KAAG,QAAQ,CAAC,EAAE,CAAC,OAKpC,CAAC;AAEF,OAAO,EAAE,2BAA2B,EAAE,CAAC"}

package/dist/crypto/private-public-keys/generation/create-256-private-key-from-mnemonic.d.ts

@@ -1,5 +1,5 @@
 /**
- * Generates a random private key from the mnemonic phrase.
+ * This function generates a random mnemonic phrase and creates a private key from it. (256 Bits)
  *
  * @returns A random private key as a hexadecimal string.
  */

package/dist/crypto/private-public-keys/generation/create-256-private-key-from-mnemonic.js

@@ -28,7 +28,7 @@ const crypto = __importStar(require("crypto"));
 const bip39 = __importStar(require("bip39"));
 const cryptography_settings_1 = require("../../../_settings/cryptography-settings");
 /**
- * Generates a random private key from the mnemonic phrase.
+ * This function generates a random mnemonic phrase and creates a private key from it. (256 Bits)
  *
  * @returns A random private key as a hexadecimal string.
  */

package/dist/crypto/private-public-keys/generation/create-entropy-for-elliptical-curve.d.ts

@@ -3,7 +3,7 @@ import { EllipticalCurvesEncryption, EllipticalCurvesSigning } from '../../../_s
  * Creates entropy for an elliptical curve.
  *
  * @param signingCurve - The elliptical curve to create entropy for.
- * @returns The entropy for the elliptical curve.
+ * @returns The entropy for the elliptical curve. string in hexadecimal format.
  */
 declare const createEntropyForEllipitalCurve: (curve: EllipticalCurvesSigning | EllipticalCurvesEncryption) => string;
 export { createEntropyForEllipitalCurve };

package/dist/crypto/private-public-keys/generation/create-entropy-for-elliptical-curve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-entropy-for-elliptical-curve.d.ts","sourceRoot":"","sources":["../../../../src/crypto/private-public-keys/generation/create-entropy-for-elliptical-curve.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AAG/G;;;;;GAKG;AACH,QAAA,MAAM,8BAA8B,UAAW,uBAAuB,GAAG,0BAA0B,KAAG,MAOrG,CAAC;AAEF,OAAO,EAAE,8BAA8B,EAAE,CAAC"}
+{"version":3,"file":"create-entropy-for-elliptical-curve.d.ts","sourceRoot":"","sources":["../../../../src/crypto/private-public-keys/generation/create-entropy-for-elliptical-curve.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AAG/G;;;;;GAKG;AACH,QAAA,MAAM,8BAA8B,UAAW,uBAAuB,GAAG,0BAA0B,KAAG,MAQrG,CAAC;AAEF,OAAO,EAAE,8BAA8B,EAAE,CAAC"}

package/dist/crypto/private-public-keys/generation/create-entropy-for-elliptical-curve.js

@@ -29,12 +29,13 @@ const Elliptic = __importStar(require("elliptic"));
  * Creates entropy for an elliptical curve.
  *
  * @param signingCurve - The elliptical curve to create entropy for.
- * @returns The entropy for the elliptical curve.
+ * @returns The entropy for the elliptical curve. string in hexadecimal format.
  */
 const createEntropyForEllipitalCurve = (curve) => {
     const ecKey = new Elliptic.ec(curve);
     const hashStrength = ecKey.hash.hmacStrength;
     const entropy = Elliptic.rand(hashStrength);
-    return entropy;
+    const entropyHex = entropy.toString('hex');
+    return entropyHex;
 };
 exports.createEntropyForEllipitalCurve = createEntropyForEllipitalCurve;

package/dist/crypto/private-public-keys/generation/create-random-512-key-pair.d.ts

@@ -0,0 +1,9 @@
+import { IPublicPrivateKeyDerPair } from '../../../models/crypto/crypto-models';
+/**
+ * This function creates a random key pair using the crypto library for the P521 curve.
+ *
+ * @returns the private and public key in DER format.
+ */
+declare const createRandom512KeyPair: () => IPublicPrivateKeyDerPair;
+export { createRandom512KeyPair };
+//# sourceMappingURL=create-random-512-key-pair.d.ts.map

package/dist/crypto/private-public-keys/generation/create-random-512-key-pair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-random-512-key-pair.d.ts","sourceRoot":"","sources":["../../../../src/crypto/private-public-keys/generation/create-random-512-key-pair.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAGhF;;;;GAIG;AACH,QAAA,MAAM,sBAAsB,QAAO,wBAelC,CAAC;AAEF,OAAO,EAAE,sBAAsB,EAAE,CAAC"}

package/dist/crypto/private-public-keys/generation/create-random-512-key-pair.js

@@ -0,0 +1,46 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRandom512KeyPair = void 0;
+const crypto = __importStar(require("crypto"));
+const cryptography_settings_1 = require("../../../_settings/cryptography-settings");
+/**
+ * This function creates a random key pair using the crypto library for the P521 curve.
+ *
+ * @returns the private and public key in DER format.
+ */
+const createRandom512KeyPair = () => {
+    const curve = 'secp521r1'; // P521 curve
+    const { publicKey, privateKey } = crypto.generateKeyPairSync('ec', { namedCurve: curve }); // Generate the key pair
+    const privateKeyDer = privateKey.export({ format: cryptography_settings_1.keyExportFormatDer, type: cryptography_settings_1.sec1KeyExportType })
+        .toString(cryptography_settings_1.base64Encoding); // Export the private key to base64
+    const publicKeyDer = publicKey.export({ format: cryptography_settings_1.keyExportFormatDer, type: cryptography_settings_1.spkiKeyExportType })
+        .toString(cryptography_settings_1.base64Encoding); // Export the public key to base64
+    return {
+        privateKeyDer,
+        publicKeyDer,
+    };
+};
+exports.createRandom512KeyPair = createRandom512KeyPair;

package/dist/errors/authorization/authorization-errors.d.ts

@@ -0,0 +1,106 @@
+import { AuthorityValidationType } from '../../models/authorization/authorization-models';
+import { BaseError } from '../base-error';
+/**
+ * This is thrown when the removal of a IJWTAuthority fails because it does not exist.
+ */
+export declare class SafeAuthorizationIssuerDoesNotExistError extends BaseError {
+    constructor(issuer: string);
+}
+/**
+ * This is thrown when a authority validation request is received the type of validation requested is unknown.
+ * (this should not happen).
+ */
+export declare class SafeAuthorizationAuthorityValidationTypeNotValidError extends BaseError {
+    constructor(validationType: AuthorityValidationType);
+}
+/**
+ * This is throw when a database records is not found.
+ */
+export declare class SafeAuthorizationSubjectNotValidError extends BaseError {
+    constructor(subjectType: string, subjectId: string);
+}
+/**
+ * This is thrown when the public key given for the issuer is not valid.
+ */
+export declare class SafeAuthorizationIssuerPublicKeyNotValidError extends BaseError {
+    constructor(issuerName: string, publicKey: string);
+}
+/**
+ * This is thrown when the issuer is not valid.
+ */
+export declare class SafeAuthorizationIssuerNotValidError extends BaseError {
+    constructor(issuer: string);
+}
+/**
+ * This is thrown when the JWT token is not the corrent base64 encoding
+ */
+export declare class SafeAuthorizationTokenNotBase64Error extends BaseError {
+    constructor();
+}
+/**
+ * This is thrown when the secret key or public key is not included for token verification.
+ */
+export declare class SafeAuthorizationKeyNotIncludedForVerificationError extends BaseError {
+    constructor();
+}
+/**
+ * This is thrown when the authorization payload is not valid.
+ */
+export declare class SafeAuthorizationPayloadNotValidError extends BaseError {
+    constructor();
+}
+/**
+ * This is thrown when the type of data in a token is not valid
+ */
+export declare class SafeAuthorizationTokenPropertyDataTypeNotValidError extends BaseError {
+    constructor(property: string, propertyValue: any, expectedDataType: string);
+}
+/**
+ * This is thrown when the authorization payload is missing a property
+ */
+export declare class SafeAuthorizationMissingPropertyError extends BaseError {
+    constructor(property: string);
+}
+/**
+ * This is thrown when the issued at time is before the current time
+ */
+export declare class SafeAuthorizationTokenIssuedAtTimeNotValidError extends BaseError {
+    constructor();
+}
+/**
+ * This is thrown not authorization exists on the request.
+ */
+export declare class SafeAuthorizationNotExistsError extends BaseError {
+    constructor();
+}
+/**
+ * This is thrown when the bearer token is not found
+ */
+export declare class SafeAuthorizationBearerTokenNotFound extends BaseError {
+    constructor();
+}
+/**
+ * This is thrown when the authorization request headers are not found.
+ */
+export declare class SafeRequestAuthorizationHeadersNotFound extends BaseError {
+    constructor();
+}
+/**
+ * This is thrown when the authorization is not found in the request headers.
+ */
+export declare class SafeRequestAuthorizationHeaderNotFound extends BaseError {
+    constructor();
+}
+/**
+ * This is thrown when the Issuer does not match the expected issuer.
+ */
+export declare class SafeAuthorizationIssuerNotMatchingExpectedError extends BaseError {
+    constructor(expectedIssuer: string, actualIssuer: string);
+}
+/**
+ * This is thrown when the decoded token null or a string (not an object)
+ */
+export declare class SafeAuthorizationTokenNotObjectError extends BaseError {
+    constructor();
+}
+//# sourceMappingURL=authorization-errors.d.ts.map

package/dist/errors/authorization/authorization-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authorization-errors.d.ts","sourceRoot":"","sources":["../../../src/errors/authorization/authorization-errors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iDAAiD,CAAC;AAC1F,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C;;GAEG;AACH,qBAAa,wCAAyC,SAAQ,SAAS;gBACvD,MAAM,EAAE,MAAM;CAG7B;AAED;;;GAGG;AACH,qBAAa,qDAAsD,SAAQ,SAAS;gBACpE,cAAc,EAAE,uBAAuB;CAGtD;AAED;;GAEG;AACH,qBAAa,qCAAsC,SAAQ,SAAS;gBACpD,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAGrD;AAED;;GAEG;AACH,qBAAa,6CAA8C,SAAQ,SAAS;gBAC5D,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAGpD;AAED;;GAEG;AACH,qBAAa,oCAAqC,SAAQ,SAAS;gBACnD,MAAM,EAAE,MAAM;CAG7B;AAED;;GAEG;AACH,qBAAa,oCAAqC,SAAQ,SAAS;;CAIlE;AAED;;GAEG;AACH,qBAAa,mDAAoD,SAAQ,SAAS;;CAIjF;AAED;;GAEG;AACH,qBAAa,qCAAsC,SAAQ,SAAS;;CAInE;AAED;;GAEG;AACH,qBAAa,mDAAoD,SAAQ,SAAS;gBAClE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,gBAAgB,EAAE,MAAM;CAG7E;AAED;;GAEG;AACH,qBAAa,qCAAsC,SAAQ,SAAS;gBACpD,QAAQ,EAAE,MAAM;CAG/B;AAED;;GAEG;AACH,qBAAa,+CAAgD,SAAQ,SAAS;;CAI7E;AAED;;GAEG;AACH,qBAAa,+BAAgC,SAAQ,SAAS;;CAI7D;AAED;;GAEG;AACH,qBAAa,oCAAqC,SAAQ,SAAS;;CAIlE;AAKD;;GAEG;AACH,qBAAa,uCAAwC,SAAQ,SAAS;;CAIrE;AAED;;GAEG;AACH,qBAAa,sCAAuC,SAAQ,SAAS;;CAIpE;AAED;;GAEG;AACH,qBAAa,+CAAgD,SAAQ,SAAS;gBAC9D,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM;CAG3D;AAED;;GAEG;AACH,qBAAa,oCAAqC,SAAQ,SAAS;;CAIlE"}

package/dist/errors/authorization/authorization-errors.js

@@ -0,0 +1,160 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SafeAuthorizationTokenNotObjectError = exports.SafeAuthorizationIssuerNotMatchingExpectedError = exports.SafeRequestAuthorizationHeaderNotFound = exports.SafeRequestAuthorizationHeadersNotFound = exports.SafeAuthorizationBearerTokenNotFound = exports.SafeAuthorizationNotExistsError = exports.SafeAuthorizationTokenIssuedAtTimeNotValidError = exports.SafeAuthorizationMissingPropertyError = exports.SafeAuthorizationTokenPropertyDataTypeNotValidError = exports.SafeAuthorizationPayloadNotValidError = exports.SafeAuthorizationKeyNotIncludedForVerificationError = exports.SafeAuthorizationTokenNotBase64Error = exports.SafeAuthorizationIssuerNotValidError = exports.SafeAuthorizationIssuerPublicKeyNotValidError = exports.SafeAuthorizationSubjectNotValidError = exports.SafeAuthorizationAuthorityValidationTypeNotValidError = exports.SafeAuthorizationIssuerDoesNotExistError = void 0;
+const base_error_1 = require("../base-error");
+/**
+ * This is thrown when the removal of a IJWTAuthority fails because it does not exist.
+ */
+class SafeAuthorizationIssuerDoesNotExistError extends base_error_1.BaseError {
+    constructor(issuer) {
+        super(`The authorization issuer ${issuer} does not exist`);
+    }
+}
+exports.SafeAuthorizationIssuerDoesNotExistError = SafeAuthorizationIssuerDoesNotExistError;
+/**
+ * This is thrown when a authority validation request is received the type of validation requested is unknown.
+ * (this should not happen).
+ */
+class SafeAuthorizationAuthorityValidationTypeNotValidError extends base_error_1.BaseError {
+    constructor(validationType) {
+        super(`The authority validation type is not valid, the type is ${validationType}`);
+    }
+}
+exports.SafeAuthorizationAuthorityValidationTypeNotValidError = SafeAuthorizationAuthorityValidationTypeNotValidError;
+/**
+ * This is throw when a database records is not found.
+ */
+class SafeAuthorizationSubjectNotValidError extends base_error_1.BaseError {
+    constructor(subjectType, subjectId) {
+        super(`The authorization subject ${subjectType} with id ${subjectId} is not valid`);
+    }
+}
+exports.SafeAuthorizationSubjectNotValidError = SafeAuthorizationSubjectNotValidError;
+/**
+ * This is thrown when the public key given for the issuer is not valid.
+ */
+class SafeAuthorizationIssuerPublicKeyNotValidError extends base_error_1.BaseError {
+    constructor(issuerName, publicKey) {
+        super(`The authorization issuer ${issuerName} with public key ${publicKey} is not valid`);
+    }
+}
+exports.SafeAuthorizationIssuerPublicKeyNotValidError = SafeAuthorizationIssuerPublicKeyNotValidError;
+/**
+ * This is thrown when the issuer is not valid.
+ */
+class SafeAuthorizationIssuerNotValidError extends base_error_1.BaseError {
+    constructor(issuer) {
+        super(`The authorization issuer ${issuer} is not valid`);
+    }
+}
+exports.SafeAuthorizationIssuerNotValidError = SafeAuthorizationIssuerNotValidError;
+/**
+ * This is thrown when the JWT token is not the corrent base64 encoding
+ */
+class SafeAuthorizationTokenNotBase64Error extends base_error_1.BaseError {
+    constructor() {
+        super('The authorization token is not a valid base64 encoding');
+    }
+}
+exports.SafeAuthorizationTokenNotBase64Error = SafeAuthorizationTokenNotBase64Error;
+/**
+ * This is thrown when the secret key or public key is not included for token verification.
+ */
+class SafeAuthorizationKeyNotIncludedForVerificationError extends base_error_1.BaseError {
+    constructor() {
+        super('The secret of public key is not included for token verification');
+    }
+}
+exports.SafeAuthorizationKeyNotIncludedForVerificationError = SafeAuthorizationKeyNotIncludedForVerificationError;
+/**
+ * This is thrown when the authorization payload is not valid.
+ */
+class SafeAuthorizationPayloadNotValidError extends base_error_1.BaseError {
+    constructor() {
+        super('The authorization payload is not valid');
+    }
+}
+exports.SafeAuthorizationPayloadNotValidError = SafeAuthorizationPayloadNotValidError;
+/**
+ * This is thrown when the type of data in a token is not valid
+ */
+class SafeAuthorizationTokenPropertyDataTypeNotValidError extends base_error_1.BaseError {
+    constructor(property, propertyValue, expectedDataType) {
+        super(`The property ${property} with value ${propertyValue} is not a valid ${expectedDataType}`);
+    }
+}
+exports.SafeAuthorizationTokenPropertyDataTypeNotValidError = SafeAuthorizationTokenPropertyDataTypeNotValidError;
+/**
+ * This is thrown when the authorization payload is missing a property
+ */
+class SafeAuthorizationMissingPropertyError extends base_error_1.BaseError {
+    constructor(property) {
+        super(`The authorization payload is missing the property ${property}`);
+    }
+}
+exports.SafeAuthorizationMissingPropertyError = SafeAuthorizationMissingPropertyError;
+/**
+ * This is thrown when the issued at time is before the current time
+ */
+class SafeAuthorizationTokenIssuedAtTimeNotValidError extends base_error_1.BaseError {
+    constructor() {
+        super('The issued at time of the token is not valid: ');
+    }
+}
+exports.SafeAuthorizationTokenIssuedAtTimeNotValidError = SafeAuthorizationTokenIssuedAtTimeNotValidError;
+/**
+ * This is thrown not authorization exists on the request.
+ */
+class SafeAuthorizationNotExistsError extends base_error_1.BaseError {
+    constructor() {
+        super('The authorization does not exist');
+    }
+}
+exports.SafeAuthorizationNotExistsError = SafeAuthorizationNotExistsError;
+/**
+ * This is thrown when the bearer token is not found
+ */
+class SafeAuthorizationBearerTokenNotFound extends base_error_1.BaseError {
+    constructor() {
+        super('The bearer token is not found');
+    }
+}
+exports.SafeAuthorizationBearerTokenNotFound = SafeAuthorizationBearerTokenNotFound;
+//#region Safe Request Authorization Errors
+/**
+ * This is thrown when the authorization request headers are not found.
+ */
+class SafeRequestAuthorizationHeadersNotFound extends base_error_1.BaseError {
+    constructor() {
+        super('The authorization request headers are not found');
+    }
+}
+exports.SafeRequestAuthorizationHeadersNotFound = SafeRequestAuthorizationHeadersNotFound;
+/**
+ * This is thrown when the authorization is not found in the request headers.
+ */
+class SafeRequestAuthorizationHeaderNotFound extends base_error_1.BaseError {
+    constructor() {
+        super('The authorization header is not found');
+    }
+}
+exports.SafeRequestAuthorizationHeaderNotFound = SafeRequestAuthorizationHeaderNotFound;
+/**
+ * This is thrown when the Issuer does not match the expected issuer.
+ */
+class SafeAuthorizationIssuerNotMatchingExpectedError extends base_error_1.BaseError {
+    constructor(expectedIssuer, actualIssuer) {
+        super(`The expected issuer ${expectedIssuer} does not match the actual issuer ${actualIssuer}`);
+    }
+}
+exports.SafeAuthorizationIssuerNotMatchingExpectedError = SafeAuthorizationIssuerNotMatchingExpectedError;
+/**
+ * This is thrown when the decoded token null or a string (not an object)
+ */
+class SafeAuthorizationTokenNotObjectError extends base_error_1.BaseError {
+    constructor() {
+        super('The decoded token is not an object');
+    }
+}
+exports.SafeAuthorizationTokenNotObjectError = SafeAuthorizationTokenNotObjectError;
+//#endregion Safe Request Authorization Errors

package/dist/errors/index.d.ts

@@ -1,4 +1,5 @@
 export * from './audit-log/audit-log-errors';
+export * from './authorization/authorization-errors';
 export * from './database/database-errors';
 export * from './generic/generic-errors';
 export * from './request/request-errors';

package/dist/errors/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAG/C,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sCAAsC,CAAC;AACrD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAG/C,cAAc,cAAc,CAAC"}

package/dist/errors/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./audit-log/audit-log-errors"), exports);
+__exportStar(require("./authorization/authorization-errors"), exports);
 __exportStar(require("./database/database-errors"), exports);
 __exportStar(require("./generic/generic-errors"), exports);
 __exportStar(require("./request/request-errors"), exports);

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

@@ -0,0 +1,37 @@
+/**
+ * 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/helpers/crypto/cryptography-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cryptography-helpers.d.ts","sourceRoot":"","sources":["../../../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/helpers/crypto/cryptography-helpers.js

@@ -0,0 +1,65 @@
+"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/helpers/index.d.ts

@@ -5,6 +5,7 @@ export * from './request/params-object-helpers';
 export * from './request/query-object-helpers';
 export * from './request/request-object-helpers';
 export * from './array/array-helpers';
+export * from './crypto/cryptography-helpers';
 export * from './data/data-helpers';
 export * from './file/file-helpers';
 export * from './lodash/lodash-helpers';

package/dist/helpers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AACA,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAM5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AAKjD,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AACA,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAM5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC;AAKjD,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC"}

package/dist/helpers/index.js

@@ -26,6 +26,7 @@ __exportStar(require("./request/request-object-helpers"), exports);
 //#endregion request exports
 // additional
 __exportStar(require("./array/array-helpers"), exports);
+__exportStar(require("./crypto/cryptography-helpers"), exports);
 __exportStar(require("./data/data-helpers"), exports);
 __exportStar(require("./file/file-helpers"), exports);
 __exportStar(require("./lodash/lodash-helpers"), exports);

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

@@ -47,6 +47,13 @@ declare const validateNumber: (incomingObject: unknown, min?: number, max?: numb
  * @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.
  *
@@ -55,5 +62,5 @@ declare const validateString: (incomingObject: unknown, hasNoSpaces?: boolean, u
  * @returns wether it is a valid URL or not
  */
 declare const validateUrl: (incomingUrl: unknown, undefinedValid?: boolean) => boolean;
-export { validateArray, validateBoolean, validateDate, validateNumber, validateString, validateUrl, };
+export { validateArray, validateBoolean, validateDate, validateNumber, validateString, validateStringHex, validateUrl, };
 //# sourceMappingURL=object-validation-helpers.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"object-validation-helpers.d.ts","sourceRoot":"","sources":["../../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;;;;;;GAMG;AACH,QAAA,MAAM,WAAW,gBAAiB,OAAO,+BAA2B,OAqBnE,CAAC;AA+CF,OAAO,EACH,aAAa,EACb,eAAe,EACf,YAAY,EACZ,cAAc,EACd,cAAc,EACd,WAAW,GACd,CAAC"}
+{"version":3,"file":"object-validation-helpers.d.ts","sourceRoot":"","sources":["../../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"}