nodester 0.1.4 → 0.2.0

package/lib/queries/NodesterQueryParams.js

@@ -1,145 +0,0 @@
-/*!
- * /nodester
- * MIT Licensed
- */
-'use strict';
-
-// Dictionary of unsafe characters:
-const NOT_ALLOWED = [
-	'{',
-	'}',
-	// `\`,
-	'^',
-	'~',
-	'[',
-	']',
-	'`'
-];
-
-const util = require('util');
-
-/*
- * NodesterQueryParams is a ready-to-use replacement for URLSearchParams.
- * The only difference is that NodesterQueryParams
- * respects nested "&" during parsing.
- */
-module.exports = class NodesterQueryParams {
-	constructor(queryString='') {
-		// Type validateion:
-		if (typeof queryString !== 'string') {
-			const err = new TypeError(`'query' must be a String.`);
-			throw err;
-		}
-
-		// You never know if it's encoded or not.
-		const decoded = decodeURI(queryString);
-
-		// Indicates, how deep the char is inside different ().
-		let deep = 0;
-
-		const paramLevels = {};
-
-		// Current query parameter.
-		let param = '';
-
-		// Current query token.
-		let token = '';
-
-		this._map = new Map();
-
-		for (let i=0; i < decoded.length; i++) {
-			const char = decoded[i];
-
-			// Validate char:
-			if (NOT_ALLOWED.indexOf(char) > -1) {
-				const err = new TypeError(`Invalid query token at ${ i }: '${ char }'`);
-				throw err;
-			}
-
-			if (char === '(') {
-				// Error If there is nothing behind:
-				if (param.length === 0) {
-					const err = new TypeError(`Invalid query token at ${ i }: '${ char }'`);
-					throw err;
-				}
-
-				// If not special token, go deeper:
-				if (['and', 'or', 'xor', 'not', '!', '|', 'like'].indexOf(token) === -1) {
-					this.append(param, token);
-					deep++;
-				}
-
-				// will set ( in token later.
-			}
-
-			if (char === ')') {
-				// If sub-level:
-				if (deep > 0) {
-					deep--
-				}
-			}
-
-			// & can mean the end of key=value pair:
-			if (char === '&') {
-				// If top-level:
-				if (deep === 0) {
-					this.append(param, token);
-					param = '';
-					token = '';
-					continue;
-				}
-
-				// If sub-level do nothing.
-			}
-			
-			// = can mean the end of param name:
-			if (char === '=') {
-				// If top-level:
-				if (deep === 0) {
-					param = token;
-					token = '';
-				}
-			}
-			
-			// Continue building token:
-			if (char !== '=' || deep > 0 ) {
-				token += char;
-			}
-
-			// If last char:
-			if (i === decoded.length-1) {
-				// Validate:
-				if (deep > 0) {
-					const err = new TypeError(`Missing ')' at ${ i }`);
-					throw err;
-				}
-
-				this.append(param, token);
-			}
-		}
-	}
-
-	append(...args) {
-		return this._map.set(...args);
-	}
-
-	get(...args) {
-		return this._map.get(...args);
-	}
-
-	delete(...args) {
-		return this._map.delete(...args);
-	}
-
-	entries(...args) {
-		return this._map.entries(...args);
-	}
-
-	toString() {
-		return this._map.toString();
-	}
-
-	[util.inspect.custom](depth, opts) {
-		return this._map;
-	}
-}

package/lib/services/includes.service.js

@@ -1,79 +0,0 @@
-const {
-	splitByComma,
-	splitByDot
-} = require('nodester/utils/strings.util');
-// Query util.
-const {
-	hasSubIncludesQuery,
-	cutSubIncludesQuery,
-	parseSubIncludesQuery
-} = require('nodester/utils/queries.util');
-
-
-module.exports = {
-	parseIncludesQuery: _parseIncludesQuery
-}
-
-function _parseIncludesQuery(
-	modelDefinition,
-	includesQueryString
-) {
-	const associationAndSubs = splitByComma(includesQueryString);
-	const allowedAssociations = Object.keys(modelDefinition.associations);
-
-	associationAndSubs.forEach((a) => {
-		let association = a.split('.')[0];
-
-		if (hasSubIncludesQuery(association)) {
-			const [ nestedQuery, _association ] = cutSubIncludesQuery(association);
-			association = _association;
-		}
-
-		if (allowedAssociations.indexOf(association) === -1) {
-			const err = new Error(`Association with name "${ association }" doesn't exist on this model.`);
-			err.name = 'NotFound';
-			throw err;
-		}
-	});
-
-	const result = associationAndSubs.map(associationAndSubsString => _parseSubIncludes(associationAndSubsString));
-
-	return result;
-}
-
-function _parseSubIncludes(associationAndSubsString) {
-	const associationAndSubs = splitByDot(associationAndSubsString);
-
-	// If association has SubIncludes:
-	if (associationAndSubs?.length > 0) {
-		const clearAssociation = associationAndSubs[0];
-		const subs = associationAndSubs.splice(1, associationAndSubs.length - 1);
-
-		if (subs.length > 0) {
-			const result = {
-				association: clearAssociation,
-				include: [ _parseSubIncludes(subs.join('.')) ]
-			};
-
-			_parseSubIncludesQueryIfPresent(result);
-
-			return result;
-		}
-	}
-	
-	// By default just return association.
-	const result = { association: associationAndSubsString };
-	_parseSubIncludesQueryIfPresent(result);
-	return result;
-}
-
-function _parseSubIncludesQueryIfPresent(resultQuery) {
-	if (hasSubIncludesQuery(resultQuery.association)) {
-		const [ nestedQuery, clearAssociation ] = cutSubIncludesQuery(resultQuery.association);
-
-		resultQuery.association = clearAssociation;
-		parseSubIncludesQuery(clearAssociation, nestedQuery, resultQuery);
-	}
-
-	return resultQuery;
-}

package/lib/services/jwt.service.js

@@ -1,147 +0,0 @@
-// Format of token: "Authorization: Bearer [token]".
-const ACCESS_TOKEN_NAME = 'Authorization';
-const REFRESH_TOKEN_NAME = 'x-refresh-token';
-// JWT module.
-const jwt = require('jsonwebtoken');
-// Utils.
-const { addSeconds } = require('nodester/utils/dates.util');
-
-
-module.exports = class JWTService {
-	constructor(
-		accessTokenConfigs,
-		refreshTokenConfigs
-	) {
-		if (!accessTokenConfigs || !refreshTokenConfigs){
-			throw new Error('"accessTokenConfigs" and "refreshTokenConfigs" are required arguments.');
-		}
-
-		this.accessTokenConfigs = { ...accessTokenConfigs };
-		this.refreshTokenConfigs = { ...refreshTokenConfigs };
-	}
-
-	extractTokenFromRequest(request) {
-		let token;
-
-		if (request.header(ACCESS_TOKEN_NAME)) {
-			token = this._parseAccessToken(
-								request.header(ACCESS_TOKEN_NAME)
-							);
-		}
-		else if (request.cookies[ACCESS_TOKEN_NAME]) {
-			token = this._parseAccessToken(
-								request.cookies[ACCESS_TOKEN_NAME]
-							);
-		}
-		// Check token in query:
-		else if (!!request.query.token) {
-			token = request.query.token;
-			delete request.body.token;
-		}
-		// Check token in body:
-		else if (!!request.body.token) {
-			token = request.body.token;
-			delete request.query.token;
-		} 
-		else {
-			const err = new Error(`No ${ACCESS_TOKEN_NAME} was found`);
-			err.name = 'NoToken';
-			err.details = { message:err.message };
-			throw err;
-		}
-
-		return token;
-	}
-
-	extractRefreshTokenFromRequest(request) {
-		let token;
-
-		if (request.header(REFRESH_TOKEN_NAME)) {
-			token = request.header(REFRESH_TOKEN_NAME);
-		}
-		else if (request.cookies[REFRESH_TOKEN_NAME]) {
-			token = request.cookies[REFRESH_TOKEN_NAME];
-		}
-		// Check token in query:
-		else if (!!request.query.token) {
-			token = request.query.token;
-			delete request.body.token;
-		}
-		// Check token in body:
-		else if (!!request.body.token) {
-			token = request.body.token;
-			delete request.query.token;
-		} 
-		else {
-			const err = new Error(`No ${REFRESH_TOKEN_NAME} was found`);
-			err.name = 'NoToken';
-			err.details = { message:err.message };
-			throw err;
-		}
-
-		return token;
-	}
-
-	issueAccessToken(payload) {
-		const { secret, expiresIn } = this.accessTokenConfigs;
-		return this._issueToken({ payload, secret, expiresIn });
-	}
-
-	issueRefreshToken(payload) {
-		const { secret, expiresIn } = this.refreshTokenConfigs;
-		return this._issueToken({ payload, secret, expiresIn });
-	}
-
-	verifyAccessToken(token) {
-		const { secret } = this.accessTokenConfigs;
-		return this._verifyToken({ token, secret });
-	}
-
-	verifyRefreshToken(token) {
-		const { secret } = this.refreshTokenConfigs;
-		return this._verifyToken({ token, secret });
-	}
-
-	async _issueToken({ payload, secret, expiresIn }) {
-		try {
-			const token = jwt.sign(payload, secret, { expiresIn });
-			const expirationDateValue = (addSeconds(new Date(), expiresIn/1000)).valueOf();
-
-			const fullToken = { token, expiresIn, expirationDateValue };
-			return Promise.resolve(fullToken);
-		}
-		catch(error) {
-			return Promise.reject(error);
-		}
-	}
-
-	async _verifyToken({ token, secret }) {
-		try {
-			const parsedToken = await jwt.verify(token, secret, {});
-			return Promise.resolve(parsedToken);
-		}
-		catch(error) {
-			const err = new Error('Invalid signature.');
-			err.name = 'ValidationError';
-			return Promise.reject(err);
-		}
-	}
-
-	_parseAccessToken(token) {
-		let parsed = '';
-
-		const parts = token.split(' ');
-
-		if (parts.length === 2 && /^Bearer$/.test(parts[0])) {
-			parsed = parts[1];
-		} 
-		else {
-			const err = new Error(`Format for ${ACCESS_TOKEN_NAME}: Bearer [token]`);
-			err.name = 'InvalidFormat';
-			err.details = { message: err.message };
-			throw err;
-		}
-
-		return parsed;
-	}
-}

package/lib/stacks/MiddlewareStack.js

@@ -1,159 +0,0 @@
-const finalhandler = require('finalhandler');
-const consl = require('nodester/loggers/console');
-const debug = require('debug')('nodester:MiddlewareStack');
-
-
-module.exports = class MiddlewareStack {
-	constructor(opts={}) {
-		// This array MUST stay flat!
-		this.middlewares = [];
-
-		// Indicates whether we can add more middlewares or no.
-		this.isLocked = false;
-		this.finalhandlerEnabled = !!opts.finalhandlerEnabled;
-
-
-		const env = process.env.NODE_ENV || 'development';
-		// Final middleware & error handler.
-		this.finalhandler = (req, res) => finalhandler(req, res, {
-			env: env,
-			onerror: consl.error.bind(this)
-		});
-	}
-
-
-	/**
-	 * Add the given middleware `fn` to the stack.
-	 *
-	 * @param {Function} fn
-	 * @param {Integer} index (0 or undefined)
-	 * @return {Integer} index of new middleware
-	 *
-	 * @api public
-	 */
-	add(fn, index) {
-		if (this.isLocked) {
-			const err = new Error(`Can't add more middlewares while stack is locked.`);
-			throw err;
-		}
-
-		if (typeof fn !== 'function') {
-			const err = new TypeError('middleware must be a function!');
-			throw err;
-		}
-
-		if (!!index && isNaN(index)) {
-			const err = new TypeError('"index" must be an Integer!');
-			throw err;
-		}
-
-		let pushedIndex = -1;
-
-		if (index === 0) {
-			this.middlewares.unshift(fn);
-			pushedIndex = 0;
-		}
-		else {
-			pushedIndex = this.middlewares.push(fn);
-		}
-
-		debug(`added middleware (${ pushedIndex })`);
-		return pushedIndex;
-	}
-
-
-	/**
-	 * Removes middleware at index.
-	 *
-	 * @param {Integer} index
-	 * @return {MiddlewareStack} self
-	 *
-	 * @api public
-	 */
-	remove(index=-1) {
-		if (this.isLocked) {
-			const err = new Error(`Can't remove middlewares while stack is locked.`);
-			throw err;
-		}
-
-		if (isNaN(index)) {
-			const err = new TypeError('"index" must be an Integer!');
-			throw err;
-		}
-
-		this.middlewares.splice(index, 1);
-		debug(`removed middleware (${ index })`);
-		return this;
-	}
-
-
-	/*
-	 * Prepare stack for processing.
-	 *
-	 * @api public
-	 */
-	lock() {
-		if (this.finalhandlerEnabled) {
-			// Add final handler to the stack.
-			this.add((req, res)=>this.finalhandler(req, res)());
-		}
-
-		// Stack is ready.
-		this.isLocked = true;
-
-		debug(`stack is locked`);
-	}
-
-
-	/*
-	 * Unlocks stack.
-	 *
-	 * @api public
-	 */
-	unlock() {
-		this.isLocked = false;
-		
-		if (this.finalhandlerEnabled) {
-			this.middlewares.pop();
-		}
-
-		debug(`stack is unlocked`);
-	}
-
-
-	/*
-	 * Start chain.
-	 *
-	 * @api public
-	 */
-	process(req, res, next) {
-		let middlewareOffset = -1;
-
-		const _next = (...args) => {
-			middlewareOffset += 1;
-			const fn = this.middlewares[middlewareOffset];
-
-			try {
-				if (!fn && !next) {
-					const err = new TypeError(`Handler for ${ req.method } ${ req.url } is not defined.`);
-					throw err;
-				}
-				else if (!fn && !!next) {
-					return next.call(null, req, res, next, ...args);
-				}
-
-				return fn.call(null, req, res, _next, ...args);
-			}
-			catch(error) {
-				return this.finalhandler(req, res)(error);
-			}
-		}
-
-		return _next();
-	}
-
-
-	get length() {
-		return this.middlewares.length;
-	}
-}