gina 0.1.1-alpha.98 → 0.1.2-alpha.1

package/framework/v0.1.2-alpha.1/helpers/data/src/main.js

@@ -0,0 +1,295 @@
+/*
+ * This file is part of the gina package.
+ * Copyright (c) 2009-2023 Rhinostone <contact@gina.io>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+
+/**
+* DataHelper
+*
+* @package     Gina.Lib.Helpers
+* @author      Rhinostone <contact@gina.io>
+* @api public
+* */
+
+function DataHelper(){
+
+    /** imports */
+    var isGFFCtx        = ( ( typeof(module) !== 'undefined' ) && module.exports ) ? false : true;
+    // if (!isGFFCtx) {
+    //     var console = require('./../../../lib/logger');
+    // }
+
+    encodeRFC5987ValueChars = function(str) {
+        // return encodeURIComponent(str).
+        //   // Bien que la RFC 3986 réserve "!", RFC 5987 ne réserve pas ce caractère,
+        //   // il n'est donc pas nécessaire l'échapper
+        //   replace(/['()*]/g, c => '%' + c.charCodeAt(0).toString(16)). // i.e., %27 %28 %29 %2a
+        //   // on notera que l'encodage valide pour "*" est %2A et qui faut donc appeler toUpperCase()
+        //   // pour encoder exactement.
+
+        //   // Selon la RFC 5987 ce qui suit n'est pas nécessairement requis
+        //   // on peut donc bénéficier d'un peu plus de lisibilité : |`^
+        //   replace(/%(7C|60|5E)/g, (str, hex) => String.fromCharCode(parseInt(hex, 16)));
+
+        // return encodeURIComponent(str).replace(/[!'()*]/g, function(c) {
+        //     return '%' + c.charCodeAt(0).toString(16);
+        //   });
+
+        return encodeURIComponent(str).
+        // Bien que la RFC 3986 réserve "!", RFC 5987 ne réserve pas ce caractère,
+        // il n'est donc pas nécessaire l'échapper
+        replace(/['()]/g, escape). // c'est-à-dire %27 %28 %29
+        replace(/\*/g, '%2A').
+            // Selon la RFC 5987 ce qui suit n'est pas nécessairement requis
+            // on peut donc bénéficier d'un peu plus de lisibilité : |`^
+            replace(/%(?:7C|60|5E)/g, unescape);
+    };
+
+    /**
+     * Convert JSON string with structured keys to object
+     *
+     * @param {string} JSON string with structured keys
+     * */
+    formatDataFromString = function(bodyStr){
+
+        if ( typeof(bodyStr) == 'object' ) {
+            bodyStr = JSON.stringify(bodyStr)
+        }
+
+        try {
+            bodyStr = decodeURIComponent(bodyStr);
+        } catch (err) {
+            // Already decoded - ignoring
+        }
+
+        // false & true case
+        if ( /(\"false\"|\"true\"|\"on\")/.test(bodyStr) ) {
+            bodyStr = bodyStr.replace(/\"false\"/g, false).replace(/\"true\"/g, true).replace(/\"on\"/g, true);
+        }
+        if ( /(\"null\")/i.test(bodyStr) ) {
+            bodyStr = bodyStr.replace(/\"null\"/ig, null);
+        }
+
+        return parseBody(bodyStr);
+    }
+
+    var parseCollection = function (collection, obj) {
+
+        for(var i = 0, len = collection.length; i<len; ++i) {
+            obj[i] = parseObject(collection[i], obj);
+        }
+
+        return obj
+    }
+
+    var parseObject = function (tmp, obj) {
+        var el      = []
+            , key   = null
+        ;
+
+        if (!obj) {
+            obj = {}
+        }
+
+        for (let o in tmp) {
+
+            el[0]   = o;
+            el[1]   = tmp[o];
+
+            if ( /^(.*)\[(.*)\]/.test(el[0]) ) { // some[field] ?
+                key = el[0].replace(/\]/g, '').split(/\[/g);
+                obj = parseLocalObj(obj, key, 0, el[1])
+            } else {
+                obj[ el[0] ] = el[1]
+            }
+        }
+
+        return obj
+    }
+
+    var parseBody = function(body) {
+        var obj             = null
+            , tmp           = null
+            , arr           = null
+            , isArrayType   = null
+        ;
+        if ( /^(\{|\[|\%7B|\%5B)/.test(body) ) {
+            try {
+                isArrayType = ( /^(\{|\%7B)/.test(body) ) ? false : true;
+                obj = ( isArrayType ) ? [] : {};
+
+                if ( /^(\%7B|\%5B)/.test(body) ) {
+                    tmp = JSON.parse(decodeURIComponent(body))
+                } else {
+                    tmp = JSON.parse(body)
+                }
+
+                if ( Array.isArray(tmp) ) {
+                    obj = parseCollection(tmp, obj)
+                } else {
+                    obj = parseObject(tmp, obj)
+                }
+
+                return obj
+            } catch (err) {
+                console.error('[365] could not parse body:\n' + body)
+            }
+
+        } else {
+            obj = {};
+            arr = body.split(/&/g);
+            if ( /(\"false\"|\"true\"|\"on\")/.test(body) )
+                body = body.replace(/\"false\"/g, false).replace(/\"true\"/g, true).replace(/\"on\"/g, true);
+
+
+            var el      = {}
+                , value = null
+                , key   = null;
+
+            for (var i = 0, len = arr.length; i < len; ++i) {
+                if (!arr[i]) continue;
+
+                arr[i] = decodeURIComponent(arr[i]);
+
+                if ( /^\{/.test(arr[i]) || /\=\{/.test(arr[i]) || /\=\[/.test(arr[i]) ) {
+                    try {
+                        if (/^\{/.test(arr[i])) {
+                            obj = JSON.parse(arr[i]);
+                            break;
+                        } else {
+                            el = arr[i].match(/\=(.*)/);
+                            el[0] =  arr[i].split(/\=/)[0];
+                            obj[ el[0] ] = JSON.parse( el[1] );
+                        }
+
+
+                    } catch (err) {
+                        console.error('[parseBody#1] could not parse body:\n' + arr[i])
+                    }
+                } else {
+                    el = arr[i].split(/=/);
+                    if ( /\{\}\"\:/.test(el[1]) ) { //might be a json
+                        try {
+                            el[1] = JSON.parse(el[1])
+                        } catch (err) {
+                            console.error('[parseBody#2] could not parse body:\n' + el[1])
+                        }
+                    }
+
+                    if ( typeof(el[1]) == 'string' && !/\[object /.test(el[1])) {
+                        key     = null;
+                        el[0]   = decodeURIComponent(el[0]);
+                        el[1]   = decodeURIComponent(el[1]);
+
+                        if ( /^(.*)\[(.*)\]/.test(el[0]) ) { // some[field] ?
+                            key = el[0].replace(/\]/g, '').split(/\[/g);
+                            obj = parseLocalObj(obj, key, 0, el[1])
+                        } else {
+                            obj[ el[0] ] = el[1]
+                        }
+                    }
+                }
+            }
+
+            return obj
+        }
+    }
+
+    // var parseLocalObj = function(obj, key, k, value) {
+    //     if ( typeof(obj[ key[k] ]) == 'undefined' ) {
+    //         obj[ key[k] ] = {};
+    //     }
+
+    //     for (var prop in obj) {
+
+    //         if (k == key.length-1) {
+
+    //             if (prop == key[k]) {
+    //                 obj[prop] = ( typeof(value) != 'undefined' ) ? value : '';
+    //             }
+
+    //         } else if ( key.indexOf(prop) > -1 ) {
+    //             ++k;
+    //             if ( !obj[prop][ key[k] ] )
+    //                 obj[prop][ key[k] ] = {};
+
+
+    //             parseLocalObj(obj[prop], key, k, value)
+
+    //         }
+    //     }
+
+    //     return obj;
+    // }
+
+    var parseLocalObj = function(obj, key, k, value) {
+
+        for (let i=0,len=key.length; i<len; i++) {
+            // by default
+            let _key = key[k];
+            if (i == k) {
+                // Array or Object ?
+                if ( typeof(obj[ key[k] ]) == 'undefined' || typeof(obj[ key[k] ]) == 'string' ) {
+                    if ( Array.isArray(obj) ) {
+                        // index
+                        // _key = obj.length;
+                        _key = ~~key[k];
+                        obj[ _key ] = ( /^\d+$/.test(key[k+1]) ) ? [] : {};
+                    } else {
+                        obj[ key[k] ] = ( /^\d+$/.test(key[k+1]) ) ? [] : {};
+                    }
+                }
+
+                // Assinging value
+                if (k == key.length-1) {
+                    let _value = ( typeof(value) != 'undefined' ) ? value : '';
+                    if ( Array.isArray( obj[key[k]] ) ) {
+                        obj[key[k]].push(_value);
+                        // _key = (obj.length > 0) ? obj.length-1 : 0;
+                        // obj[ _key ] = _value;
+                    }
+                    else {
+                        obj[ key[k] ] = _value;
+                    }
+                    break;
+                }
+                // Assinging index or key
+                else {
+                    if ( /^\d+$/.test(key[k]) && !Array.isArray(obj) ) {
+                        obj = [];
+                        // _key = (obj.length > 0) ? obj.length-1 : 0;
+                    }
+                    // Handle unstructured array from object
+                    // E.G.: design[1][id] where design is starting with `1` index instead of `0`
+                    // if ( Array.isArray(obj) ) {
+                    //     // current Index
+                    //     _key = ~~key[k];
+                    //     // _key = (obj.length > 0) ? obj.length-1 : 0;
+                    // }
+                    // Init array or object
+                    if ( typeof(obj[ _key ]) == 'undefined' ) {
+                        // obj[ _key ] = ( /^\d+$/.test(key[k+1]) ) ? [] : {};
+                        obj[ _key ] = null;
+                    }
+
+                    parseLocalObj(obj[ _key ], key, k+1, value);
+                }
+            }
+        }
+
+        return obj;
+    }
+
+} //EO DataHelper
+
+if ( ( typeof(module) !== 'undefined' ) && module.exports ) {
+    // Publish as node.js module
+    module.exports  = DataHelper
+} else if ( typeof(define) === 'function' && define.amd) {
+    // Publish as AMD module
+    define(function(){ return DataHelper() })
+}

package/framework/{v0.1.1-alpha.98 → v0.1.2-alpha.1}/helpers/dateFormat.js

@@ -1,6 +1,6 @@
 /*
  * This file is part of the gina package.
- * Copyright (c) 2009-2022 Rhinostone <contact@gina.io>
+ * Copyright (c) 2009-2023 Rhinostone <contact@gina.io>
  *
  * For the full copyright and license information, please view the LICENSE
  * file that was distributed with this source code.
@@ -30,7 +30,7 @@
 function DateFormatHelper() {
 
     var isGFFCtx        = ( ( typeof(module) !== 'undefined' ) && module.exports ) ? false : true;
-    var merge           = (isGFFCtx) ? require('utils/merge') : require('./../lib/merge');
+    var merge           = (isGFFCtx) ? require('lib/merge') : require('./../lib/merge');
 
 
     // if ( typeof(define) === 'function' && define.amd ) {
@@ -65,6 +65,7 @@ function DateFormatHelper() {
         shortIsoTime:        "HH:MM",
         longIsoTime:        "HH:MM:ss TT",
         isoDateTime:    "yyyy-mm-dd'T'HH:MM:ss",
+        longIsoDateTime:    "yyyy-mm-dd'T'HH:MM:ss.L",
         isoUtcDateTime: "UTC:yyyy-mm-dd'T'HH:MM:ss'Z'"
     };
 
@@ -125,7 +126,7 @@ function DateFormatHelper() {
     var format = function(date, mask, utc) {
 
         // if ( typeof(merge) == 'undefined' || !merge ) {
-        //     merge = (isGFFCtx) ? require('utils/merge') : require('./../lib/merge');
+        //     merge = (isGFFCtx) ? require('lib/merge') : require('./../lib/merge');
 
         // }
 
@@ -140,7 +141,7 @@ function DateFormatHelper() {
         } catch( mergeErr) {
             // called from logger - redefinition needed for none-dev env: cache issue
             isGFFCtx        = ( ( typeof(module) !== 'undefined' ) && module.exports ) ? false : true;
-            merge           = (isGFFCtx) ? require('utils/merge') : require('./../lib/merge');
+            merge           = (isGFFCtx) ? require('lib/merge') : require('./../lib/merge');
             masksList = merge(i18n.masks, dF.masks);
         }
 
@@ -209,7 +210,8 @@ function DateFormatHelper() {
                 s:    s,
                 ss:   pad(s),
                 l:    pad(L, 3),
-                L:    pad(L > 99 ? Math.round(L / 10) : L),
+                // L:    pad(L > 99 ? Math.round(L / 10) : L),
+                L:    pad(L),
                 t:    H < 12 ? "a"  : "p",
                 tt:   H < 12 ? "am" : "pm",
                 T:    H < 12 ? "A"  : "P",
@@ -278,8 +280,8 @@ function DateFormatHelper() {
     /**
      *  Will give an array of dates between the current date to a targeted date
      *
-     *  TODO - add a closure to `ignoreWeekend()` based on Utils::Validator
-     *  TODO - add a closure to `ignoreFromList(array)` based on Utils::Validator
+     *  TODO - add a closure to `ignoreWeekend()` based on Lib::Validator
+     *  TODO - add a closure to `ignoreFromList(array)` based on Lib::Validator
      *
      *  @param {object} dateTo
      *  @param {string} [ mask ]

package/framework/{v0.1.1-alpha.98 → v0.1.2-alpha.1}/helpers/index.js

@@ -1,6 +1,6 @@
 /*
  * This file is part of the gina package.
- * Copyright (c) 2009-2022 Rhinostone <contact@gina.io>
+ * Copyright (c) 2009-2023 Rhinostone <contact@gina.io>
  *
  * For the full copyright and license information, please view the LICENSE
  * file that was distributed with this source code.
@@ -10,10 +10,10 @@ var fs = require('fs');
 /**
  * @module Helpers
  *
- * Gina Utils Helpers
+ * Gina Lib Helpers
  *
- * @package     Gina.Utils
- * @namespace   Gina.Utils.Helpers
+ * @package     Gina.Lib
+ * @namespace   Gina.Lib.Helpers
  * @author      Rhinostone <contact@gina.io>
  */
 var _require = function(path) {
@@ -43,7 +43,7 @@ var helpers         = {}
 
 var PrototypesHelper = null, PluginsHelper = null;
 // loading main helpers
-for (; f < len; ++f) {            
+for (; f < len; ++f) {
     if ( ! /^\./.test(files[f]) && files[f] != 'index.js') {
         helper          = files[f].replace(/.js/, '');
         if (/prototypes/i.test(helper)) {
@@ -63,11 +63,11 @@ new PrototypesHelper({
 });
 
 // loading plugins helpers
-if ( 
+if (
     typeof(getContext) != 'undefined'
-    && typeof(getContext().gina) != 'undefined' 
+    && typeof(getContext().gina) != 'undefined'
 ) {
-    new PluginsHelper(getContext('gina').plugins);    
+    new PluginsHelper(getContext('gina').plugins);
 }
 // adding ApiError to helper in case Validator plugin is not loaded
 if ( typeof(getContext) != 'undefined' && typeof(ApiError) == 'undefined' /*&& typeof(helpers.ApiError) == 'undefined'*/ ) {
@@ -75,5 +75,10 @@ if ( typeof(getContext) != 'undefined' && typeof(ApiError) == 'undefined' /*&& t
     ApiError = require('./plugins/src/api-error');
 }
 
+// loading `gina/utils/helper` if not yet loaded
+if ( typeof(getTmpDir) == 'undefined' ) {
+    _require(__dirname + '/../../../utils/helper')
+}
+
 // Publish as node.js module
 module.exports = helpers;

package/framework/v0.1.2-alpha.1/helpers/json/LICENSE

@@ -0,0 +1,9 @@
+License (MIT)
+
+Copyright © 2023 Martin-Luther ETOUMAN <martin-luther.etouman@gina.io>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/framework/v0.1.2-alpha.1/helpers/json/README.md

@@ -0,0 +1,12 @@
+# json()
+
+**Package:** gina.helpers
+**Name:** json
+
+
+
+## Debuging your test with nodeunit
+
+```tty
+ node --inspect-brk=6959 `which nodeunit` ./test/01-require_json.js
+```

package/framework/{v0.1.1-alpha.98/helpers/plugins → v0.1.2-alpha.1/helpers/json}/package.json

@@ -5,9 +5,9 @@
 
   "author": {
     "name": "Maritn-Luther ETOUMAN",
-    "email": "martinluther@gina.io"
+    "email": "martin-luther@gina.io"
   },
-  "copyright": "Copyright (c) 2009-2022 Rhinostone <contact@gina.io>",
+  "copyright": "Copyright (c) 2009-2023 Rhinostone <contact@gina.io>",
   "engines": {
     "node": ">=0.10.22"
   },

package/framework/{v0.1.1-alpha.98 → v0.1.2-alpha.1}/helpers/json/src/main.js

@@ -1,6 +1,6 @@
 /*
  * This file is part of the gina package.
- * Copyright (c) 2009-2022 Rhinostone <contact@gina.io>
+ * Copyright (c) 2009-2023 Rhinostone <contact@gina.io>
  *
  * For the full copyright and license information, please view the LICENSE
  * file that was distributed with this source code.
@@ -9,35 +9,40 @@
  var fs = require('fs');
  var console = require('./../../../lib/logger');
 /**
- * TextHelper
+ * JSONHelper
  *
- * @package     Gina.Utils.Helpers
+ * @package     Gina.Lib.Helpers
  * @author      Rhinostone <contact@gina.io>
  * @api public
  * */
 
 module.exports = function(){
 
-    // `JSON.clone()` is a prototype defined in `GINA_DIR//utils/prototypes.json_clone`
-    
+    // `JSON.clone()` is a prototype defined in `GINA_DIR//lib/prototypes.json_clone`
+
     /**
      * Load a json file and removing comments if found
      *
-     * @returns {string} filename - path
+     * @param {string} filename - path to json content
+     *
+     * @return {object} jsonObject
      * */
-    requireJSON = function(filename){        
-        
+    requireJSON = function(filename){
+
         //console.debug('[ Helpers ][ requireJSON ] ', filename);
-        
+
         var i                       = null
             , len                   = null
             , commentsWithSlashes = null
             , jsonStr               = null
         ;
-        
+
         try {
-            if ( typeof(process.env.NODE_ENV_IS_DEV) != 'undefined' && /true/i.test(process.env.NODE_ENV_IS_DEV) ) {
-                delete require.cache[filename];
+            if (
+                typeof(process.env.NODE_ENV_IS_DEV) != 'undefined'
+                && /true/i.test(process.env.NODE_ENV_IS_DEV)
+            ) {
+                delete require.cache[require.resolve(filename)];
             }
             jsonStr = fs.readFileSync(filename).toString();
         } catch (err) {
@@ -45,18 +50,18 @@ module.exports = function(){
                 console.emerg(err.stack);
                 process.exit(1);
             }
-            throw err            
+            throw err
         }
-        
-        
+
+
         /** block style comments */
         if ( /\/\*\*/.test(jsonStr) ) {
             jsonStr   = jsonStr.replace(/(\/\*([^*]|[\r\n]|(\*+([^*\/]|[\r\n])))*\*+\/)/g, '');
         }
-        
+
         // line style comments
-        commentsWithSlashes = jsonStr.match(/\/\/(.*)?/g);        
-                
+        commentsWithSlashes = jsonStr.match(/\/\/(.*)?/g);
+
         len = ( commentsWithSlashes) ? commentsWithSlashes.length : 0;
         if (commentsWithSlashes && len > 0) {
             i = 0;
@@ -64,12 +69,12 @@ module.exports = function(){
                 // ignore urls
                 if ( /(\:|\")/.test( jsonStr.substr(jsonStr.indexOf(commentsWithSlashes[i])-1,1) ) )
                     continue;
-                    
+
                 jsonStr = jsonStr.replace(commentsWithSlashes[i], '');
             }
-        }        
-        
-        try {      
+        }
+
+        try {
             return JSON.parse(jsonStr)
         } catch (err) {
             var pos     = null
@@ -78,20 +83,20 @@ module.exports = function(){
             ;
             var stack   = err.stack.match(/position(\s|\s+)\d+/);
             if ( Array.isArray(stack) && stack.length > 0) {
-                pos     = stack[0].replace(/[^\d+]/g, '');            
+                pos     = stack[0].replace(/[^\d+]/g, '');
                 jsonStr = jsonStr.substr(0, pos) + '--(ERROR !)--\n' + jsonStr.substr(pos);
                 msg     = (jsonStr.length > 400) ?  '...'+ jsonStr.substr(pos-200, 300) +'...' : jsonStr;
-                error = new Error('[ requireJSON ] could not parse `'+ filename +'`:' +'\n\rSomething is wrong around this portion:\n\r'+msg+'<strong style="color:red">"</strong>\n\rPlease check your file: `'+ filename +'`'+ '\n\r<strong style="color:red">'+err.stack+'</strong>\n');       
+                error = new Error('[ requireJSON ] could not parse `'+ filename +'`:' +'\n\rSomething is wrong around this portion:\n\r'+msg+'<strong style="color:red">"</strong>\n\rPlease check your file: `'+ filename +'`'+ '\n\r<strong style="color:red">'+err.stack+'</strong>\n');
             } else {
-                error = new Error('[ requireJSON ] could not parse `'+ filename +'`:' +'\n\rSomething is wrong with the content of your file.\n\rPlease check the syntax of your file : `'+ filename +'`'+ '\n\r<strong style="color:red">'+err.stack+'</strong>\n');       
+                error = new Error('[ requireJSON ] could not parse `'+ filename +'`:' +'\n\rSomething is wrong with the content of your file.\n\rPlease check the syntax of your file : `'+ filename +'`'+ '\n\r<strong style="color:red">'+err.stack+'</strong>\n');
             }
-            
+
             if ( !/\/controllers/i.test(err.stack) && typeof(console.emerg) != 'undefined' ) {
                 console.emerg(error.message);
                 process.exit(1);
-            }            
+            }
             throw error;
-        }               
+        }
     };
 
 };//EO JSONHelper.