nodester 0.0.8 → 0.1.0

package/lib/_facades/Facade.js

@@ -1,388 +0,0 @@
-const Params = require('nodester/facades/FacadeParams');
-// Utils:
-const { lowerCaseFirstLetter } = require('nodester/utils/strings.util');
-const { parseIncludesQuery } = require('nodester/services/includes.service');
-const { parseQueryParams } = require('nodester/utils/queries.util');
-
-
-module.exports = class Facade {
-	constructor(modelDefinition) {
-		if (!modelDefinition)
-			throw new Error('"modelDefinition" argument is invalid.');
-
-		this.model = modelDefinition;
-		this.nameSingular = lowerCaseFirstLetter(modelDefinition?.options?.name?.singular);
-		this.namePlural = lowerCaseFirstLetter(modelDefinition?.options?.name?.plural);
-	}
-
-	/*
-	 * @param <Object> data
-	 */
-	async createOne(params) {
-		try {
-			const {
-				data,
-				includes,
-			} = Params(params, {
-				data: null,
-				includes: null,
-			});
-
-			// Parse includes string to array.
-			const _includes = typeof includes === 'string' ? parseIncludesQuery(this.model, includes) : null;
-
-			const instance = await this.model.create({ ...data }, {
-				include: this.model.getIncludesList(data)
-			});
-
-			// If includes are set, "find" this record with includes:
-			if (!!_includes && _includes?.length > 0) {
-				await instance.reload({ include: _includes });
-			}
-
-			const result = {
-				[this.nameSingular]: instance,
-				count: 1
-			};
-
-			// Call after create.
-			await this.afterCreate(instance, params, result);
-
-			// Send output.
-			return Promise.resolve(result);
-		}
-		catch(error) {
-			return Promise.reject(error);
-		}
-	}
-
-	/*
-	 * @param <Object> data
-	 */
-	async getOrCreateOne(params) {
-		try {
-			const {
-				id,
-				query,
-				data,
-				includes,
-			} = Params(params, {
-				id: null,
-				query: null,
-				data: null,
-				includes: null,
-			});
-
-			// Parse includes string to array.
-			const _includes = typeof includes === 'string' ? parseIncludesQuery(this.model, includes) : null;
-
-			let instance, isNewRecord;
-
-			if (!!id) {
-				const [ _instance, _isNewRecord ] = await this.model.findOrCreate({
-					where: {
-						id: parseInt(id)
-					},
-					defaults: data
-				});
-
-				// Find this model again with passed includes.
-				instance = await this.model.findById(id, _includes);
-
-				isNewRecord = _isNewRecord;
-			}
-			else if (!!query) {
-				// New sequilize query.
-				const modelQuery = {};
-
-				// If includes are set:
-				if (!!_includes) {
-					modelQuery.include = [ ..._includes ];
-				}
-
-				parseQueryParams(query, modelQuery);
-
-				let _instance = await this.model.findOne(modelQuery);
-
-				// Define "isNewRecord".
-				isNewRecord = !instance;
-
-				// If no record in DB, create new one:
-				if (!_instance) {
-					_instance = await this.model.create({ ...data }, {
-						include: this.model.getIncludesList(data)
-					});
-
-					instance = _instance;
-
-					// If includes are set, "find" this record with includes:
-					if (!!_includes && _includes?.length > 0) {
-						await instance.reload({ include: _includes });
-					}
-				}
-				else {
-					instance = _instance;
-				}
-			}
-
-			const result = {
-				[this.nameSingular]: instance,
-				count: 1,
-				isNewRecord: isNewRecord
-			};
-
-			// If new record, call "after create":
-			if (!!isNewRecord) {
-				await this.afterCreate(instance, params, result);
-			}
-
-			// Send output.
-			return Promise.resolve(result);
-		}
-		catch(error) {
-			return Promise.reject(error);
-		}
-	}
-
-	/*
-	 * @param <ModelInstance> instance
-	 * @param <Array> params
-	 */
-	async afterCreate(
-		instance,
-		params,
-		result
-	) {
-		// This method is empty, as it should be overwritten.
-		return Promise.resolve();
-	}
-
-	/*
-	 * @param <UInt> id
-	 * @param <Object> query
-	 * @param <Array> includes
-	 */
-	async getOne(params) {
-		try {
-			const {
-				id,
-				query,
-				includes,
-			} = Params(params, {
-				id: null,
-				query: null,
-				includes: null,
-			});
-			
-			// Parse includes string to array.
-			const _includes = typeof includes === 'string' ? parseIncludesQuery(this.model, includes) : null;
-
-			let instance = null;
-
-			if (!!id || !!query?.id) {
-				instance = await this.model.findById(( id ?? query.id ), _includes);
-			}
-			else if (!!query) {
-				// New sequilize query.
-				const modelQuery = {};
-
-				// If includes are set:
-				if (!!_includes) {
-					modelQuery.include = [ ..._includes ];
-				}
-
-				parseQueryParams(query, modelQuery);
-
-				instance = await this.model.findOne(modelQuery);
-			}
-
-			const result = {
-				[this.nameSingular]: instance,
-				count: !!instance ? 1 : 0
-			};
-
-			// Send output.
-			return Promise.resolve(result);
-		}
-		catch(error) {
-			return Promise.reject(error);
-		}
-	}
-
-	/*
-	 * @param <Object> query
-	 * @param <Array> includes
-	 */
-	async getMany(params) {
-		try {
-			const {
-				query,
-				includes,
-			} = Params(params, {
-				query: {},
-				includes: null
-			});
-
-			// Parse includes string to array.
-			const _includes = typeof includes === 'string' ? parseIncludesQuery(this.model, includes) : null;
-
-			// New sequilize query.
-			const modelQuery = {};
-
-			// If includes are set:
-			if (!!_includes) {
-				modelQuery.include = [ ..._includes ];
-			}
-
-			parseQueryParams(query, modelQuery);
-
-			// Get instances for current limits
-			// and total number (Int) of such instances.
-			const [
-				instances,
-				totalCount
-			] = await Promise.all([
-				this.model.findAll(modelQuery),
-				this.model.count(modelQuery)
-			]);
-
-			const result = {
-				[this.namePlural]: instances,
-				
-				count: instances.length,
-				total_count: totalCount,
-
-				limit: modelQuery.limit,
-				skip: modelQuery.offset
-			};
-
-			// Send output.
-			return Promise.resolve(result);
-		}
-		catch(error) {
-			return Promise.reject(error);
-		}
-	}
-
-	/*
-	 * @param <UInt> id
-	 * @param <Object> data
-	 * @param <Array> includes
-	 */
-	async updateOne(params) {
-		try {
-			const {
-				id,
-				query,
-				data,
-				includes,
-			} = Params(params, {
-				id: null,
-				query: {},
-				data: null,
-				includes: null,
-			});
-
-			// Parse includes string to array.
-			const _includes = typeof includes === 'string' ? parseIncludesQuery(this.model, includes) : null;
-
-			let updateResult = null;
-
-			if (!!id || !!query.id) {
-				updateResult  = await this.model.updateById(( id ?? query.id ), data, _includes);
-			}
-			else {
-				// New sequilize query.
-				const modelQuery = {};
-				parseQueryParams(query, modelQuery);
-
-				updateResult = await this.model.updateOne(modelQuery.where, data, _includes);
-			}
-
-			const [ isNewRecord, instance ] = updateResult;
-
-			const result = {
-				success: isNewRecord === false,
-				[this.nameSingular]: instance
-			};
-
-			// Send output.
-			return Promise.resolve(result);
-		}
-		catch(error) {
-			return Promise.reject(error);
-		}
-	}
-
-	// TODO: finish updateMany:
-	/*
-	 * @param <UInt> id
-	 * @param <Object> data
-	 * @param <Array> includes
-	 */
-	// async updateMany(params) {
-	// 	try {
-	// 		const {
-	// 			query,
-	// 			data,
-	// 			includes,
-	// 		} = Params(params, {
-	// 			query: {},
-	// 			data: null,
-	// 			includes: null,
-	// 		});
-
-	// 		const _includes = typeof includes === 'string' ? parseIncludesQuery(this.model, includes) : null;
-
-	// 		let updateResult = null;
-
-	// 		if (!!query.id) {
-	// 			updateResult  = await this.model.updateById(query.id, data, _includes);
-	// 		}
-	// 		else {
-	// 			// New sequilize query.
-	// 			const modelQuery = {};
-	// 			parseQueryParams(query, modelQuery);
-
-	// 			updateResult = await this.model.update(modelQuery.where, data, _includes);
-
-	// 			console.log({ updateResult });
-	// 		}
-
-	// 		const result = {
-	// 			success:isNewRecord === false,
-	// 			[this.nameSingular]:instance
-	// 		};
-
-	// 		// Send output.
-	// 		return Promise.resolve(result);
-	// 	}
-	// 	catch(error) {
-	// 		return Promise.reject(error);
-	// 	}
-	// }
-
-	/*
-	 * @param <UInt> id
-	 */
-	async deleteOne(params) {
-		try {
-			const { id } = Params(params, {
-				id: null
-			});
-
-			const count = await this.model.deleteById(id);
-
-			const result = {
-				success: count > 0,
-				count: count
-			};
-
-			// Send output.
-			return Promise.resolve(result);
-		}
-		catch(error) {
-			return Promise.reject(error);
-		}
-	}
-}

package/lib/_facades/FacadeParams.js

@@ -1,11 +0,0 @@
-const Params = require('nodester/utils/params.util');
-
-
-module.exports = FacadeParams;
-
-function FacadeParams(
-	sourceObject={},
-	defaultValuesList={}
-) {
-	return Params(sourceObject, defaultValuesList);
-}

package/lib/_facades/ServiceFacade.js

@@ -1,17 +0,0 @@
-// Utils:
-const { lowerCaseFirstLetter } = require('nodester/utils/strings.util');
-
-
-module.exports = class ServiceFacade {
-	constructor(
-		nameSingular,
-		namePlural,
-	) {
-		if (!nameSingular || !namePlural) {
-			throw new Error('"nameSingular" and "namePlural" arguments must be set.');
-		}
-
-		this.nameSingular = lowerCaseFirstLetter(nameSingular);
-		this.namePlural = lowerCaseFirstLetter(namePlural);
-	}
-}

package/lib/_facades/jwt.facade.js

@@ -1,273 +0,0 @@
-// Access to database.
-const Sequelize = require('sequelize');
-// JWT service.
-const JWT = require('nodester/services/jwt.service');
-// Utils:
-const { lowerCaseFirstLetter } = require('nodester/utils/strings.util');
-const { addSeconds } = require('nodester/utils/dates.util');
-const Params = require('nodester/facades/FacadeParams');
-
-
-module.exports = class JWTFacade {
-	constructor(
-		disabledRefreshToken,
-		roleModels=[],
-		accessTokenConfigs=null,
-		refreshTokenConfigs=null
-	) {
-		if (!disabledRefreshToken)
-			throw new Erroror('"disabledRefreshToken" argument is invalid.');
-
-		this.disabledRefreshToken = disabledRefreshToken;
-
-		this.roleModels = {};
-		roleModels.forEach(model => {
-			const name = lowerCaseFirstLetter(model?.options?.name?.singular);
-			this.roleModels[name] = model;
-		});
-
-		this.service = new JWT(accessTokenConfigs, refreshTokenConfigs);
-	}
-
-	async login(params) {
-		try {
-			const {
-				email,
-				password,
-				role
-			} = Params(params, {
-				email: null,
-				password: null,
-				role: null
-			});
-
-			if (Object.keys(this.roleModels).indexOf(role) === -1)
-				throw new Error();
-
-			// Extract model difinition of this type.
-			const modelDefinition = this.roleModels[role];
-			const instance = await modelDefinition?.findOneByEmail(email);
-
-			if (!instance)
-				throw new Error();
-
-			const compareResult = await instance?.comparePasswords(password);
-
-			if (compareResult === false)
-				throw new Error();
-
-			const result = {
-				role: role,
-				[role]: instance.toJSON(),
-				tokens: await this.issueTokens({ modelInstance: instance, modelName: role })
-			}
-
-			// Send output.
-			return Promise.resolve(result);
-		}
-		catch(error) {
-			console.error(error);
-
-			// Unauthorized on any error:
-			const err = new Error();
-			err.name = 'Unauthorized';
-			return Promise.reject(err);
-		}
-	}
-
-	async issueAccessToken(params) {
-		try {
-			const {
-				parsedRefreshToken,
-				modelInstance,
-				modelName
-			} = Params(params, {
-				parsedRefreshToken: null,
-				modelInstance: null,
-				modelName: null,
-			});
-
-			let newAccessToken = null;
-
-			if (!modelName && !parsedRefreshToken.role) {
-				const err = new Error('No "modelName" provided for JWT issue.');
-				err.name = "ValidationError";
-				err.status = 403;
-				throw err;
-			}
-
-			// If parsed refresh token was provided:
-			if (!!parsedRefreshToken) {
-				const payload = {
-					id: parsedRefreshToken?.id,
-					role: parsedRefreshToken.role,
-				};
-				newAccessToken = await this.service.issueAccessToken(payload);
-			}
-			// If modelInstance was provided:
-			else if (!!modelInstance) {
-				const payload = {
-					id: modelInstance?.id,
-					role: modelName
-				};
-				newAccessToken = await this.service.issueAccessToken(payload);
-			}
-			else {
-				const err = new Error('No "modelInstance" or "parsedRefreshToken" provided for JWT issue.');
-				err.name = "ValidationError";
-				err.status = 403;
-				throw err;
-			}
-
-			// Check if issue was successful.
-			if (!newAccessToken) {
-				const err = new Error("Could not issue new access token.");
-				err.status = 401;
-				throw err;
-			}
-
-			// Send output.
-			return Promise.resolve(newAccessToken);
-		}
-		catch(error) {
-			return Promise.reject(error);
-		}
-	}
-
-	async issueTokens(params) {
-		try {
-			const {
-				modelInstance,
-				modelName,
-				noAccessToken,
-				noRefreshToken
-			} = Params(params, {
-				modelInstance: null,
-				modelName: null,
-				noAccessToken: false,
-				noRefreshToken: false
-			});
-
-			// Prepare payload container.
-			let payload = {};
-
-			if (!!modelInstance && !!modelName) {
-				payload = {
-					id: modelInstance?.id,
-					role: modelName
-				};
-			}
-			else {
-				const err = new Error('No "modelInstance" and "modelName" provided for JWT issue.');
-				err.name = "ValidationError";
-				err.status = 403;
-				throw err;
-			}
-
-			const accessToken = await this.service.issueAccessToken(payload);
-			const refreshToken = await this.service.issueRefreshToken(payload);
-
-			// Prepare output,
-			const tokens = {
-				accessToken,
-				refreshToken
-			};
-
-			if (noAccessToken)
-				delete tokens.accessToken;
-
-			if (noRefreshToken)
-				delete tokens.refreshToken;
-			
-			// Send output.
-			return Promise.resolve(tokens);
-		}
-		catch(error) {
-			return Promise.reject(error);
-		}
-	}
-
-	async refreshAccessToken(params) {
-		try {
-			const {
-				refreshToken,
-				parsedRefreshToken
-			} = Params(params, {
-				refreshToken: null,
-				parsedRefreshToken: null
-			});
-
-			// Check if token is not blocked:
-			const isActive = await this.isRefreshTokenActive({ refreshToken });
-			if (!isActive) {
-				const err = new Error('Invalid Token!');
-				err.name = 'InvalidToken';
-				throw err;
-			}
-
-			// Issue new access token, based on refresh token:
-			const accessToken = await this.issueAccessToken({ parsedRefreshToken });
-
-			// Send output.
-			return Promise.resolve(accessToken);
-		}
-		catch(error) {
-			return Promise.reject(error);
-		}
-	}
-
-	async isRefreshTokenActive(params) {
-		try {
-			const {
-				refreshToken
-			} = Params(params, {
-				refreshToken: null
-			});
-
-			const foundTokens = await this.disabledRefreshToken.selectAll({ token: refreshToken });
-
-			// Prepare output. Check if provided token was not disabled.
-			const isActive = foundTokens.length === 0;
-
-			// Send output.
-			return Promise.resolve(isActive);
-		}
-		catch(error) {
-			return Promise.reject(error);
-		}
-	}
-
-	async disableRefreshToken(params) {
-		try {
-			const {
-				refreshToken,
-				parsedToken
-			} = Params(params, {
-				refreshToken: null,
-				parsedToken: null
-			});
-
-			// Unwrap nessessary data.
-			const { id, role } = parsedToken;
-
-			// Find or create:
-			const cofParams = {
-				[`${ role }_id`]: id,
-				token: refreshToken
-			};
-			const [ disabledRefreshToken, created ] = await this.disabledRefreshToken.createOrFind(cofParams);
-
-			// Check result,
-			const createdStatus = created === true || !!disabledRefreshToken;
-
-			// Send output.
-			const result = {
-				status: createdStatus
-			}
-			return Promise.resolve(result);
-		}
-		catch(error) {
-			return Promise.reject(error);
-		}
-	}
-}