qcobjects-sdk 2.3.24

package/index.rst

@@ -0,0 +1,398 @@
+.. figure:: qcobjects_01.png
+   :alt: logo
+
+   logo
+
+QCObjects
+=========
+
+Copyright (c) Jean Machuca and QuickCorp info@quickcorp.cl
+
+See a demo using Foundation components here:
+https://github.com/QuickCorp/quickobjects_sample1foundation
+
+Please fork this project or make a link to this project into your
+README.md file. Read the LICENSE.txt file before you use this code.
+
+Cross Browser Javascript Framework for MVC Patterns
+===================================================
+
+QCObjects is a javascript framework designed to make easier everything
+about the MVC patterns implementation into the pure javascript scope.
+You don’t need to use typescript nor any transpiler to run QCObjects. It
+runs directly on the browser and it uses pure javascript with no extra
+dependencies of code. You can make your own components expressed in real
+native javascript objects or extend a native DOM object to use in your
+own way. You can also use QCObjects in conjunction with CSS3 frameworks
+like [Foundation] (https://foundation.zurb.com), [Bootstrap]
+(http://getbootstrap.com) and mobile javascript frameworks like
+[PhoneGap] (https://phonegap.com) and OnsenUI (https://onsen.io)
+
+If you like this code please
+`DONATE <https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=UUTDBUQHCS4PU&source=url>`__!
+
+If you like more code samples feel free to write your questions to
+info@quickcorp.cl
+
+Installing with NPM:
+====================
+
+.. code:: shell
+
+    > npm install qcobjects
+
+Using the code in the straight way into HTML5:
+==============================================
+
+.. code:: html
+
+    <script type="text/javascript" src="https://quickcorp.github.io/QCObjects/QCObjects.js"></script>
+
+Step 1: Start creating a main import file and name it like: cl.quickcorp.js. Put it into packages/js/ file directory.
+=====================================================================================================================
+
+.. code:: javascript
+
+    "use strict";
+    /*
+    * QuickCorp/QCObjects is licensed under the
+    * GNU Lesser General Public License v3.0
+    * [LICENSE] (https://github.com/QuickCorp/QCObjects/blob/master/LICENSE.txt)
+    *
+    * Permissions of this copyleft license are conditioned on making available
+    * complete source code of licensed works and modifications under the same
+    * license or the GNU GPLv3. Copyright and license notices must be preserved.
+    * Contributors provide an express grant of patent rights. However, a larger
+    * work using the licensed work through interfaces provided by the licensed
+    * work may be distributed under different terms and without source code for
+    * the larger work.
+    *
+    * Copyright (C) 2015 Jean Machuca,<correojean@gmail.com>
+    *
+    * Everyone is permitted to copy and distribute verbatim copies of this
+    * license document, but changing it is not allowed.
+    */
+
+
+    Import ('external/libs');
+    Import ('cl.quickcorp.model');
+    Import ('cl.quickcorp.components');
+    Import ('cl.quickcorp.controller');
+    Import ('cl.quickcorp.view');
+
+    Package('cl.quickcorp',[
+      Class('FormValidator',Object,{
+
+      }),
+    ]);
+
+Step 2: Then create some services inhereting classes into the file js/packages/cl.quickcorp.services.js :
+=========================================================================================================
+
+.. code:: javascript
+
+    "use strict";
+    /*
+    * QuickCorp/QCObjects is licensed under the
+    * GNU Lesser General Public License v3.0
+    * [LICENSE] (https://github.com/QuickCorp/QCObjects/blob/master/LICENSE.txt)
+    *
+    * Permissions of this copyleft license are conditioned on making available
+    * complete source code of licensed works and modifications under the same
+    * license or the GNU GPLv3. Copyright and license notices must be preserved.
+    * Contributors provide an express grant of patent rights. However, a larger
+    * work using the licensed work through interfaces provided by the licensed
+    * work may be distributed under different terms and without source code for
+    * the larger work.
+    *
+    * Copyright (C) 2015 Jean Machuca,<correojean@gmail.com>
+    *
+    * Everyone is permitted to copy and distribute verbatim copies of this
+    * license document, but changing it is not allowed.
+    */
+
+
+    Package('cl.quickcorp.service',[
+      Class('JsonService',{
+        method:"GET",
+        cached:false,
+        headers: {
+            "Content-Type":"application/json",
+          "charset":"utf-8"
+        },
+        JSONresponse: null,
+        done:function(result){
+          console.log("***** RECEIVED RESPONSE:");
+          console.log(result.service.template);
+          this.JSONresponse = JSON.parse(result.service.template);
+          alert(this.template);
+        }
+      }),
+      Class('FormSubmitService',{
+        method:"POST",
+        cached:false,
+        headers: {
+          "Content-Type":"application/json"
+        },
+        JSONresponse: null,
+        done: function(result) {
+          console.log("***** CALLED FormSubmitService");
+          this.JSONresponse = JSON.parse(result.service.template);
+          //TODO success case
+          console.log("***** SUCCESS!")
+          console.log(this.JSONresponse);
+        },
+        fail: function(result) {
+          //TODO negative case
+          console.log("***** ERROR");
+        }
+
+      })
+
+    ])
+
+Step 3: Now it’s time to create the components (cl.quickcorp.components.js)
+===========================================================================
+
+.. code:: javascript
+
+    "use strict";
+    /*
+    * QuickCorp/QCObjects is licensed under the
+    * GNU Lesser General Public License v3.0
+    * [LICENSE] (https://github.com/QuickCorp/QCObjects/blob/master/LICENSE.txt)
+    *
+    * Permissions of this copyleft license are conditioned on making available
+    * complete source code of licensed works and modifications under the same
+    * license or the GNU GPLv3. Copyright and license notices must be preserved.
+    * Contributors provide an express grant of patent rights. However, a larger
+    * work using the licensed work through interfaces provided by the licensed
+    * work may be distributed under different terms and without source code for
+    * the larger work.
+    *
+    * Copyright (C) 2015 Jean Machuca,<correojean@gmail.com>
+    *
+    * Everyone is permitted to copy and distribute verbatim copies of this
+    * license document, but changing it is not allowed.
+    */
+    Package('cl.quickcorp.components',[
+      Class('FormField',Component,{
+        cached:false,
+        reload:true,
+        createBindingEvents:function (){
+            var _executeBinding = this.executeBinding;
+            var thisobj = this;
+            var _objList = this.body.querySelectorAll(this.fieldType);
+            for (var _datak=0;_datak<_objList.length;_datak++){
+                var _obj = _objList[_datak];
+                _obj.addEventListener('change',function(e){
+                    logger.debug('Executing change event binding');
+                    thisobj.executeBindings();
+                });
+                _obj.addEventListener('keydown',function(e){
+                    logger.debug('Executing keydown event binding');
+                        thisobj.executeBindings();
+                });
+            }
+        },
+        executeBinding:function (_obj){
+            var _datamodel = _obj.getAttribute('data-field');
+            logger.debug('Binding '+_datamodel+' for '+this.name);
+            this.data[_datamodel]=_obj.value;
+        },
+        executeBindings:function (){
+          var _objList = this.body.querySelectorAll(this.fieldType);
+            for (var _datak=0;_datak<_objList.length;_datak++){
+                var _obj = _objList[_datak];
+                var _datamodel = _obj.getAttribute('data-field');
+            logger.debug('Binding '+_datamodel+' for '+this.name);
+                this.data[_datamodel]=_obj.value;
+            }
+        },
+        done:function (){
+          var thisobj = this;
+          thisobj.executeBindings();
+            thisobj.createBindingEvents();
+          logger.debug('Field loaded: '+thisobj.fieldType+'[name='+thisobj.name+']');
+        }
+      }),
+      Class('ButtonField',FormField,{
+        fieldType:'button'
+      }),
+      Class('InputField',FormField,{
+        fieldType:'input'
+      }),
+      Class('TextField',FormField,{
+        fieldType:'textarea'
+      }),
+      Class('EmailField',FormField,{
+        fieldType:'input'
+      })
+    ]);
+
+Step 4: Once you have done the above components declaration, you will now want to code your controllers (cl.quickcorp.controller.js)
+====================================================================================================================================
+
+.. code:: javascript
+
+    "use strict";
+    /*
+    * QuickCorp/QCObjects is licensed under the
+    * GNU Lesser General Public License v3.0
+    * [LICENSE] (https://github.com/QuickCorp/QCObjects/blob/master/LICENSE.txt)
+    *
+    * Permissions of this copyleft license are conditioned on making available
+    * complete source code of licensed works and modifications under the same
+    * license or the GNU GPLv3. Copyright and license notices must be preserved.
+    * Contributors provide an express grant of patent rights. However, a larger
+    * work using the licensed work through interfaces provided by the licensed
+    * work may be distributed under different terms and without source code for
+    * the larger work.
+    *
+    * Copyright (C) 2015 Jean Machuca,<correojean@gmail.com>
+    *
+    * Everyone is permitted to copy and distribute verbatim copies of this
+    * license document, but changing it is not allowed.
+    */
+    "use strict";
+    Package('cl.quickcorp.controller',[
+        Class('MainController',Object,{
+            _new_:function (){
+                //TODO: Implement
+                logger.debug('MainController Element Initialized');
+            }
+        }),
+        Class('MyAccountController',Object,{
+            component: null,
+            done:function (){
+                var controller = this;
+
+
+
+                logger.debug('MyAccountController Element Initialized');
+                this.component.body.setAttribute('loaded',true);
+
+            },
+            _new_:function (o){
+                //TODO: Implement
+                this.component = o.component;
+
+            }
+        }),
+    ]);
+
+# Step 5: To use into the HTML5 code you only need to do some settings
+between
+
+.. raw:: html
+
+   <script> tags:
+
+   ```html
+   <script>
+   CONFIG.set('relativeImportPath','js/packages/');
+   CONFIG.set('componentsBasePath','templates/components/');
+   CONFIG.set('delayForReady',1); // delay to wait before executing the first ready event, it includes imports
+   CONFIG.set('preserveComponentBodyTag',false); // don't use <componentBody></componentBody> tag
+
+   Import('cl.quickcorp'); # this will import your main file: cl.quickcorp.js into js/packages/ file path
+   </script>
+
+\``\`
+
+Demo example: The simpliest demo example:
+=========================================
+
+.. code:: html
+
+    <!DOCTYPE html>
+    <html>
+        <head>
+            <title>Demo</title>
+            <script type="text/javascript" src="QCObjects.js"></script>
+            <script type="text/javascript">
+                var canvas1,canvas2,canvas3,container;
+            CONFIG.set('relativeImportPath','src/');
+
+                /**
+                 * Main import sentence.
+                 */
+                Import('cl.quickcorp',function (){
+
+                    /**
+                     * Super Container MyOwnBody
+                     */
+                    Class('MyOwnBody',HTMLBodyElement,{
+                        customAttr:'custom',
+                        body:document.body  // breakes default body element and replace with them
+                    });
+
+                    /**
+                     * Another custom class definition
+                     */
+                    Class('MyContainer',HTMLElement,{
+                        width:400,
+                        height:400,
+                        customAttr:'custom attr container'
+                    });
+
+
+                    /**
+                     * Another custom class definition
+                     */
+                    Class('canvas',HTMLCanvasElement,{
+                        customAttr:'custom'
+                    });
+
+                    /**
+                     * Another custom class definition
+                     */
+                    Class('MyCanvas2',HTMLCanvasElement,{});
+
+                    body = New(MyOwnBody); // binds to body
+                    body.css({backgroundColor:'#ccc'});
+
+                    container = document.getElementsByTagName('container')[0].Cast(MyContainer); // cast any javascript dom object to QC_Object class
+                    container.css({backgroundColor:'red'}); // access binding in two directions to dom objects
+
+                    /**
+                     * Instance a new custom canvas
+                     */
+                    canvas1 = New(canvas,{
+                width:100,
+                height:100,
+              });
+                    canvas2 = New(canvas,{
+                width:200,
+                        height:100,
+              });
+                    canvas3 = New(canvas,{
+                width:300,
+                        height:50,
+              });
+
+                    canvas1.css({backgroundColor:'#000000'}); // like jquery and another style access
+              canvas1.body.style.backgroundColor='#000000'; // standard javascript style access
+                    canvas2.body.style.backgroundColor='#0044AA'; // standard javascript style access
+                    canvas3.body.style.backgroundColor='green'; // standard javascript style access
+
+                    canvas1.append(); //append canvas1 to body
+                    canvas2.attachIn('container'); // attach or append to specific tag containers
+                    container.append(canvas3); // append canvas3 to custom tag binding
+
+    //              canvas1.body.remove(); // remove canvas1 from dom
+                    body.append(canvas3); // append canvas3 to body
+
+              // using components
+              var c1 = New(Component,{'templateURI':'templatesample.html',cached:false});
+              document.body.append(c1); // appends the c1 to the body
+
+
+                });
+
+            </script>
+        </head>
+        <body>
+            <container id="contentLoader" ></container>
+        </body>
+    </html>

package/js/org.qcobjects.cloud.auth.session.data.js

@@ -0,0 +1,72 @@
+/**
+ * QCObjects SDK 2.3
+ * ________________
+ *
+ * Author: Jean Machuca <correojean@gmail.com>
+ *
+ * Cross Browser Javascript Framework for MVC Patterns
+ * QuickCorp/QCObjects is licensed under the
+ * GNU Lesser General Public License v3.0
+ * [LICENSE] (https://github.com/QuickCorp/QCObjects/blob/master/LICENSE.txt)
+ *
+ * Permissions of this copyleft license are conditioned on making available
+ * complete source code of licensed works and modifications under the same
+ * license or the GNU GPLv3. Copyright and license notices must be preserved.
+ * Contributors provide an express grant of patent rights. However, a larger
+ * work using the licensed work through interfaces provided by the licensed
+ * work may be distributed under different terms and without source code for
+ * the larger work.
+ *
+ * Copyright (C) 2015 Jean Machuca,<correojean@gmail.com>
+ *
+ * Everyone is permitted to copy and distribute verbatim copies of this
+ * license document, but changing it is not allowed.
+*/
+(function() {
+"use strict";
+
+Package("org.qcobjects.cloud.auth.session.data",[
+  Class ("SessionData",Object, {
+    __session_container__: null,
+    setSessionContainer () {
+      this.__session_container__ = [...arguments];
+    },
+    getSessionContainer () {
+      if (typeof this.__session_container__ === "undefined" || this.__session_container__ === null){
+        throw new Error("You need to set a session container first: sessionData.setSessionContainer(...arguments)");
+      }
+      return this.__session_container__;
+    },
+    getSessionData () {
+      var __instance__ = this;
+      var s = sessionStorage.getItem(`${__instance__.index(...arguments)}`);
+      var sessionData = JSON.parse(s);
+      return sessionData;
+    },
+    index () {
+      if (typeof SessionUserToken === "undefined") {
+        throw new Error("You need to import SessionUserToken first: Import (\"org.qcobjects.cloud.auth.session.usertoken\")");
+      }
+      return `session_${btoa(SessionUserToken.getGlobalUserToken(...arguments))}`;
+    },
+    save () {
+      var __instance__ = this;
+      var s = _DataStringify(__instance__.sessionData);
+      sessionStorage.setItem(`${__instance__.index(...arguments)}`, s);
+    },
+    get (name) {
+      var __instance__ = this;
+      var sessionData = __instance__.getSessionData(__instance__.getSessionContainer());
+      return sessionData[name];
+    },
+    set (name, value) {
+      var __instance__ = this;
+      var __session_container__ = __instance__.getSessionContainer();
+      var sessionData = __instance__.getSessionData(__session_container__);
+      sessionData[name] = value;
+      __instance__.save(__session_container__);
+    }
+  })
+]);
+
+}).call(null);

package/js/org.qcobjects.cloud.auth.session.usertoken.js

@@ -0,0 +1,95 @@
+/**
+ * QCObjects SDK 2.3
+ * ________________
+ *
+ * Author: Jean Machuca <correojean@gmail.com>
+ *
+ * Cross Browser Javascript Framework for MVC Patterns
+ * QuickCorp/QCObjects is licensed under the
+ * GNU Lesser General Public License v3.0
+ * [LICENSE] (https://github.com/QuickCorp/QCObjects/blob/master/LICENSE.txt)
+ *
+ * Permissions of this copyleft license are conditioned on making available
+ * complete source code of licensed works and modifications under the same
+ * license or the GNU GPLv3. Copyright and license notices must be preserved.
+ * Contributors provide an express grant of patent rights. However, a larger
+ * work using the licensed work through interfaces provided by the licensed
+ * work may be distributed under different terms and without source code for
+ * the larger work.
+ *
+ * Copyright (C) 2015 Jean Machuca,<correojean@gmail.com>
+ *
+ * Everyone is permitted to copy and distribute verbatim copies of this
+ * license document, but changing it is not allowed.
+*/
+(function() {
+"use strict";
+
+Package("org.qcobjects.cloud.auth.session.usertoken",[
+  Class ("SessionUserToken",Object, {
+    user: {},
+    __cache__: null,
+    _new_ (o) {
+      var __instance__ = this;
+      this.__cache__ = new ComplexStorageCache(
+        {
+          index: __instance__.__instanceID.toString(),
+          load () {
+            var __token__;
+            if (typeof navigator !== "undefined" && typeof origin !== "undefined"){
+              __token__ = _Crypt.encrypt(`${navigator.userAgent}|${o.username}|${(+(new Date())).toString()}`,origin);
+            } else {
+              __token__ = _Crypt.encrypt(`${o.username}|${(+(new Date())).toString()}`,CONFIG.get("domain", "localhost"));
+            }
+            __instance__.user = {
+              priority:__instance__.__instanceID.toString(),
+              token: __token__
+            };
+            return __instance__.user;
+          },
+          alternate (cacheController) {
+            __instance__.user = cacheController.cache.getCached(__instance__.__instanceID.toString()); // setting dataObject with the cached value
+            return;
+          }
+        });
+    },
+    generateIndex (s) {
+      return (typeof Buffer !== "undefined")?(Buffer.from(s, "ascii").toString("base64")):(btoa(s));
+    },
+    getGlobalUser () {
+      var username = [...arguments].join("|");
+      var __index__ = "userToken_"+SessionUserToken.generateIndex(username);
+      if (typeof global.get(__index__) === "undefined" || global.get(__index__) === null){
+        global.set(__index__, New(SessionUserToken, {
+          username: username
+        }));
+      }
+      SessionUserToken.user = global.get(__index__).user;
+      return global.get(__index__).user;
+    },
+    getGlobalUserToken () {
+      return this.getGlobalUser(...arguments).token;
+    },
+    getGlobalUserId () {
+      return this.getGlobalUser(...arguments).id;
+    },
+    getGlobalUserPriority () {
+      return this.getGlobalUser(...arguments).priority;
+    },
+    getLoginCredentialsToken (username, password) {
+      return _Crypt.encrypt(`${username}${password}`, this.getGlobalUserToken(username));
+    },
+    closeGlobalSession () {
+      this.getGlobalUser(...arguments);
+      var username = [...arguments].join("|");
+      var __index__ = "userToken_"+SessionUserToken.generateIndex(username);
+      if (typeof global.get(__index__) !== "undefined"){
+        global.get(__index__).__cache__.clear();
+        global.set(__index__, null);
+        SessionUserToken.user = {};
+      }
+    }
+  })
+]);
+
+}).call(null);

package/js/org.qcobjects.components.grid.js

@@ -0,0 +1,59 @@
+/**
+ * QCObjects SDK 2.3
+ * ________________
+ *
+ * Author: Jean Machuca <correojean@gmail.com>
+ *
+ * Cross Browser Javascript Framework for MVC Patterns
+ * QuickCorp/QCObjects is licensed under the
+ * GNU Lesser General Public License v3.0
+ * [LICENSE] (https://github.com/QuickCorp/QCObjects/blob/master/LICENSE.txt)
+ *
+ * Permissions of this copyleft license are conditioned on making available
+ * complete source code of licensed works and modifications under the same
+ * license or the GNU GPLv3. Copyright and license notices must be preserved.
+ * Contributors provide an express grant of patent rights. However, a larger
+ * work using the licensed work through interfaces provided by the licensed
+ * work may be distributed under different terms and without source code for
+ * the larger work.
+ *
+ * Copyright (C) 2015 Jean Machuca,<correojean@gmail.com>
+ *
+ * Everyone is permitted to copy and distribute verbatim copies of this
+ * license document, but changing it is not allowed.
+*/
+(function() {
+"use strict";
+Package("org.qcobjects.components.grid",[
+  Class("GridItemComponent",Component,{
+    name:"grid-item",
+    shadowed: true,
+    tplsource: "inline",
+    template:`
+    <img src="{{image}}" />
+    <p>{{description}}</p>
+    `,
+    cached: false
+  }),
+  Class("GridComponent",Component,{
+    name:"grid",
+    cached:false,
+    view:null,
+    shadowed: true,
+    rows:3,
+    cols:3,
+    templateURI:"",
+    data:{},
+    tplsource: "inline",
+    template: "<p>Loading...</p>",
+    _new_ (o){
+      o.body.setAttribute("controllerClass","DataGridController");
+      var subcomponentClass = (o.body.getAttribute("subcomponentClass") !== null)?(o.body.getAttribute("subcomponentClass")):("GridItemComponent");
+      o.body.setAttribute("subcomponentClass",subcomponentClass);
+      _super_("Component","_new_").call(this,o);
+    }
+
+  })
+]);
+
+}).call(null);