alchemymvc 1.3.21 → 1.4.0-alpha.1

package/lib/class/field_value.js

@@ -3,12 +3,12 @@
  *
  * @constructor
  *
- * @author   Jelle De Loecker   <jelle@elevenways.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.1.0
  * @version  1.1.0
  *
  * @param    {Field}   field    The field definition
- * @param    {String}  path     The full path to the value (includes indexes)
+ * @param    {string}  path     The full path to the value (includes indexes)
  * @param    {*}       value
  */
 const FieldValue = Function.inherits(null, 'Alchemy', function FieldValue(field, path, value) {
@@ -22,7 +22,7 @@ const FieldValue = Function.inherits(null, 'Alchemy', function FieldValue(field,
 /**
  * Get the translated values, if possible
  *
- * @author   Jelle De Loecker   <jelle@elevenways.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.1.0
  * @version  1.1.4
  *
@@ -61,7 +61,7 @@ FieldValue.setMethod(function getTranslatedValues() {
 /**
  * Get the array values, if possible
  *
- * @author   Jelle De Loecker   <jelle@elevenways.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.1.0
  * @version  1.1.0
  *
@@ -131,7 +131,7 @@ FieldValue.setMethod(function unwind() {
 /**
  * Refine the values
  *
- * @author   Jelle De Loecker   <jelle@elevenways.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.1.0
  * @version  1.1.0
  *
@@ -170,7 +170,7 @@ FieldValue.setMethod(function refine(fields) {
 /**
  * Get subfield values
  *
- * @author   Jelle De Loecker   <jelle@elevenways.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.1.0
  * @version  1.1.0
  *

package/lib/class/helper.js

@@ -1,7 +1,7 @@
 /**
  * Custom alchemy helpers
  *
- * @author   Jelle De Loecker   <jelle@develry.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.0.0
  * @version  1.0.0
  *
@@ -14,12 +14,12 @@ var Helper = Function.inherits('Hawkejs.Helper', 'Alchemy.Helper', function Help
 /**
  * Add an error to the given element
  *
- * @author   Jelle De Loecker   <jelle@develry.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.1.0
  * @version  1.1.0
  *
  * @param    {Element}   element
- * @param    {String}    error
+ * @param    {string}    error
  */
 Helper.setMethod(function markElementError(element, error) {
 	element.setAttribute('data-alchemy-error', error);

package/lib/class/inode.js

@@ -6,7 +6,7 @@ const libpath = alchemy.use('path'),
  *
  * @constructor
  *
- * @author   Jelle De Loecker   <jelle@elevenways.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.1.0
  * @version  1.1.0
  *
@@ -29,11 +29,11 @@ var Inode = Function.inherits('Alchemy.Base', 'Alchemy.Inode', function Inode(pa
 /**
  * Get the correct Inode instance for the given path
  *
- * @author   Jelle De Loecker   <jelle@develry.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.3.0
  * @version  1.3.0
  * 
- * @param    {String}   path
+ * @param    {string}   path
  *
  * @return   {Pledge<Inode>}
  */
@@ -56,11 +56,11 @@ Inode.setStatic(function from(path) {
 /**
  * Process given path
  *
- * @author   Jelle De Loecker   <jelle@develry.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.1.0
  * @version  1.1.0
  *
- * @param    {String|Array}   full_path
+ * @param    {string|Array}   full_path
  */
 Inode.setStatic(function process(full_path, options, next) {
 
@@ -100,33 +100,33 @@ Inode.setStatic(function process(full_path, options, next) {
 /**
  * Things are not directories by default
  *
- * @author   Jelle De Loecker   <jelle@develry.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.1.0
  * @version  1.1.0
  *
- * @type     {Boolean}
+ * @type     {boolean}
  */
 Inode.setProperty('is_directory', false);
 
 /**
  * Things are not files by default
  *
- * @author   Jelle De Loecker   <jelle@develry.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.1.0
  * @version  1.1.0
  *
- * @type     {Boolean}
+ * @type     {boolean}
  */
 Inode.setProperty('is_file', false);
 
 /**
  * The extension of this inode
  *
- * @author   Jelle De Loecker   <jelle@develry.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.1.0
  * @version  1.1.0
  *
- * @type     {String}
+ * @type     {string}
  */
 Inode.setProperty(function extension() {
 	return libpath.extname(this.name);
@@ -135,11 +135,11 @@ Inode.setProperty(function extension() {
 /**
  * The basename of this inode
  *
- * @author   Jelle De Loecker   <jelle@develry.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.1.0
  * @version  1.1.0
  *
- * @type     {String}
+ * @type     {string}
  */
 Inode.setProperty(function basename() {
 	return libpath.basename(this.name);
@@ -149,11 +149,11 @@ Inode.setProperty(function basename() {
  * The rootname of this inode
  * (basename without extension)
  *
- * @author   Jelle De Loecker   <jelle@develry.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.1.0
  * @version  1.1.0
  *
- * @type     {String}
+ * @type     {string}
  */
 Inode.setProperty(function rootname() {
 
@@ -169,7 +169,7 @@ Inode.setProperty(function rootname() {
 /**
  * Get the stat object
  *
- * @author   Jelle De Loecker   <jelle@elevenways.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.1.8
  * @version  1.1.8
  *
@@ -201,7 +201,7 @@ Inode.setMethod(function getStats(refresh) {
 /**
  * Does this inode still exist?
  *
- * @author   Jelle De Loecker   <jelle@elevenways.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.1.8
  * @version  1.1.8
  *

package/lib/class/inode_dir.js

@@ -5,11 +5,11 @@ const libpath = alchemy.use('path');
  *
  * @constructor
  *
- * @author   Jelle De Loecker   <jelle@elevenways.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.1.0
  * @version  1.1.0
  *
- * @param    {String}   path   Path to the directory
+ * @param    {string}   path   Path to the directory
  */
 var Directory = Function.inherits('Alchemy.Inode', function Directory(path) {
 	Directory.super.call(this, path);
@@ -21,18 +21,18 @@ var Directory = Function.inherits('Alchemy.Inode', function Directory(path) {
 /**
  * Directories are obviously directories
  *
- * @author   Jelle De Loecker   <jelle@develry.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.1.0
  * @version  1.1.0
  *
- * @type     {Boolean}
+ * @type     {boolean}
  */
 Directory.setProperty('is_directory', true);
 
 /**
  * Load this directory's contents
  *
- * @author   Jelle De Loecker   <jelle@develry.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.1.0
  * @version  1.1.0
  *
@@ -68,13 +68,13 @@ Directory.setMethod(async function loadContents(options) {
 /**
  * See if this directory contains any entries matching the given name
  *
- * @author   Jelle De Loecker   <jelle@develry.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.1.0
  * @version  1.1.0
  *
- * @param    {String|Regex}   regex
+ * @param    {string|Regex}   regex
  *
- * @return   {Boolean}
+ * @return   {boolean}
  */
 Directory.setMethod(function contains(regex) {
 
@@ -98,7 +98,7 @@ Directory.setMethod(function contains(regex) {
 /**
  * Iterator over the contents of this directory
  *
- * @author   Jelle De Loecker   <jelle@develry.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.1.0
  * @version  1.1.0
  */
@@ -114,7 +114,7 @@ Directory.setMethod(Symbol.iterator, function* iterate() {
 /**
  * Get a file from this directory, or its subdirectory
  *
- * @author   Jelle De Loecker   <jelle@elevenways.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.1.8
  * @version  1.1.8
  *
@@ -165,7 +165,7 @@ Directory.setMethod(async function get(path) {
 /**
  * Return a list of all files
  *
- * @author   Jelle De Loecker   <jelle@elevenways.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.1.8
  * @version  1.1.8
  *
@@ -191,7 +191,7 @@ Directory.setMethod(async function flatten() {
 /**
  * Add all files to the given list
  *
- * @author   Jelle De Loecker   <jelle@elevenways.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.1.8
  * @version  1.1.8
  *

package/lib/class/inode_file.js

@@ -1,6 +1,6 @@
 const HASH = Symbol('hash'),
       ALGORITHM = Symbol('algorithm'),
-      LIBMAGIC = alchemy.use('mmmagic'),
+      LIBMAGIC = alchemy.use('@picturae/mmmagic'),
       LIBMIME = alchemy.use('mime'),
       fs = alchemy.use('fs');
 
@@ -11,11 +11,11 @@ let Magic;
  *
  * @constructor
  *
- * @author   Jelle De Loecker   <jelle@elevenways.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.1.0
  * @version  1.1.0
  *
- * @param    {String}   path   Path to the file
+ * @param    {string}   path   Path to the file
  */
 var File = Function.inherits('Alchemy.Inode', function File(path) {
 
@@ -32,24 +32,24 @@ var File = Function.inherits('Alchemy.Inode', function File(path) {
 /**
  * Files are obviously files
  *
- * @author   Jelle De Loecker   <jelle@develry.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.1.0
  * @version  1.1.0
  *
- * @type     {Boolean}
+ * @type     {boolean}
  */
 File.setProperty('is_file', true);
 
 /**
  * Detect the filetype of the given path
  *
- * @author   Jelle De Loecker   <jelle@elevenways.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.3.0
  * @version  1.3.0
  *
- * @param    {String}   path
+ * @param    {string}   path
  *
- * @return   {Pledge<String>}
+ * @return   {Pledge<string>}
  */
 File.setStatic(function getMimetype(path) {
 
@@ -82,14 +82,14 @@ File.setStatic(function getMimetype(path) {
 /**
  * Guess the mimetype from the path
  *
- * @author   Jelle De Loecker   <jelle@elevenways.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.3.0
- * @version  1.3.0
+ * @version  1.4.0
  *
- * @param    {String}   path
- * @param    {String}   fallback
+ * @param    {string}   path
+ * @param    {string}   fallback
  *
- * @return   {String}
+ * @return   {string}
  */
 File.setStatic(function guessMimetypeFromPath(path, fallback) {
 
@@ -105,14 +105,14 @@ File.setStatic(function guessMimetypeFromPath(path, fallback) {
 		}
 	}
 
-	return result;
+	return result || fallback;
 });
 
 /**
  * Create a File instance from the given variable
  * (From an untrusted source)
  *
- * @author   Jelle De Loecker   <jelle@elevenways.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.3.0
  * @version  1.3.0
  */
@@ -161,7 +161,7 @@ File.setStatic(function fromUntrusted(obj) {
 /**
  * Create a File instance from the given variable
  *
- * @author   Jelle De Loecker   <jelle@develry.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.1.0
  * @version  1.3.0
  */
@@ -224,11 +224,11 @@ File.setStatic(function from(obj) {
 /**
  * Get the mimetype of the file
  *
- * @author   Jelle De Loecker   <jelle@elevenways.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.3.0
  * @version  1.3.0
  *
- * @return   {String|Pledge<String>}
+ * @return   {string|Pledge<string>}
  */
 File.setMethod(function getMimetype() {
 
@@ -253,17 +253,17 @@ File.setMethod(function getMimetype() {
 /**
  * Get the SHA1 hash of the file
  *
- * @author   Jelle De Loecker   <jelle@elevenways.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.3.0
  * @version  1.3.0
  *
- * @param    {String}   algorithm
+ * @param    {string}   algorithm
  *
- * @return   {String|Pledge<String>}
+ * @return   {string|Pledge<string>}
  */
 File.setMethod(function getHash(algorithm) {
 
-	algorithm = algorithm || alchemy.settings.file_hash_algorithm;
+	algorithm = algorithm || alchemy.settings.data_management.file_hash_algorithm;
 
 	if (!this[HASH] || this[ALGORITHM] != algorithm) {
 		const options = {algorithm};
@@ -281,7 +281,7 @@ File.setMethod(function getHash(algorithm) {
 /**
  * Create a read stream
  *
- * @author   Jelle De Loecker   <jelle@elevenways.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.3.0
  * @version  1.3.0
  *
@@ -294,7 +294,7 @@ File.setMethod(function createReadStream(options) {
 /**
  * Read and return the contents
  *
- * @author   Jelle De Loecker   <jelle@develry.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.1.0
  * @version  1.3.16
  */
@@ -327,7 +327,7 @@ File.setMethod(function read(options) {
 /**
  * Read and return the contents as a string
  *
- * @author   Jelle De Loecker   <jelle@develry.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.1.0
  * @version  1.1.0
  */
@@ -338,4 +338,29 @@ File.setMethod(function readString(encoding) {
 	}
 
 	return this.read({encoding: encoding});
+});
+
+/**
+ * Write the given data to the file
+ *
+ * @author   Jelle De Loecker <jelle@elevenways.be>
+ * @since    1.3.22
+ * @version  1.3.22
+ */
+File.setMethod(function overwrite(contents, options = {}) {
+
+	let pledge = new Pledge();
+
+	options.flag = 'w';
+
+	fs.writeFile(this.path, contents, options, function done(err) {
+
+		if (err) {
+			return pledge.reject(err);
+		}
+
+		pledge.resolve();
+	});
+
+	return pledge;
 });

package/lib/class/inode_list.js

@@ -3,7 +3,7 @@
  *
  * @constructor
  *
- * @author   Jelle De Loecker   <jelle@elevenways.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.1.0
  * @version  1.1.0
  *
@@ -16,7 +16,7 @@ var List = Function.inherits(['Alchemy.Base', 'Array'], 'Alchemy.Inode', functio
 /**
  * Return the length of the entries
  *
- * @author   Jelle De Loecker   <jelle@elevenways.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.1.0
  * @version  1.1.0
  */
@@ -27,7 +27,7 @@ List.setProperty(function length() {
 /**
  * Iterator method
  *
- * @author   Jelle De Loecker   <jelle@elevenways.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.1.0
  * @version  1.1.0
  */
@@ -43,7 +43,7 @@ List.setMethod(Symbol.iterator, function* iterate() {
 /**
  * Load the contents of directories?
  *
- * @author   Jelle De Loecker   <jelle@develry.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.1.0
  * @version  1.1.0
  *

package/lib/class/migration.js

@@ -5,7 +5,7 @@ const libpath = alchemy.use('path');
  *
  * @constructor
  *
- * @author   Jelle De Loecker   <jelle@elevenways.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.2.0
  * @version  1.2.0
  */
@@ -18,13 +18,13 @@ const Migration = Function.inherits('Alchemy.Base', function Migration(document)
  *
  * @constructor
  *
- * @author   Jelle De Loecker   <jelle@elevenways.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.2.0
  * @version  1.2.0
  */
 Migration.setStatic(async function start() {
 
-	const AlchemyMigration = Model.get('AlchemyMigration');
+	const AlchemyMigration = Model.get('System.Migration');
 
 	console.log('Starting migration task...');
 
@@ -116,7 +116,7 @@ Migration.setStatic(async function start() {
  *
  * @constructor
  *
- * @author   Jelle De Loecker   <jelle@elevenways.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.2.0
  * @version  1.3.1
  */