subfork 0.1.0 → 0.1.2

package/README.md

@@ -5,7 +5,13 @@ Javascript client library used to connect to [Subfork](https://subfork.com) site
 Usage:
 
 ```html
-<script src="https://cdn.jsdelivr.net/gh/subforkdev/subfork.js/subfork.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/subfork@latest/dist/subfork.min.js"></script>
+```
+
+To use the latest unstable dev version:
+
+```html
+<script src="https://code.fork.io/subfork.js"></script>
 ```
 
 Instantiate [Subfork](https://subfork.com) client:
@@ -53,3 +59,13 @@ subfork.task("test").create({
 
 See the [test.fork.io](https://github.com/subforkdev/test.fork.io) project for more
 usage examples.
+
+## badge.js
+
+Used for displaying [Subfork](https://subfork.com) attribution badge on sites.
+
+Usage:
+
+```html
+<script src="https://cdn.jsdelivr.net/npm/subfork@latest/dist/badge.min.js"></script>
+```

package/dist/badge.js

@@ -0,0 +1,55 @@
+/*
+Copyright (c) Subfork. All rights reserved.
+
+To use, simply include this file at the bottom of your html:
+
+<script src="https://code.subfork.com/badge.js"></script>
+*/
+
+(function() {
+    function createAttributionBadge() {
+        // Create the badge container
+        const badge = document.createElement("div");
+        badge.className = "attribution-badge";
+
+        // Create the image element
+        const image = document.createElement("img");
+        image.src = "https://subfork.com/static/logo.png";
+        image.title = "Built with Subfork";
+        image.alt = "Subfork";
+        image.className = "attribution-image";
+
+        // Add click event listener
+        image.addEventListener("click", () => {
+            window.open("https://subfork.com", "_blank");
+        });
+
+        // Append the image to the badge container
+        badge.appendChild(image);
+
+        // Append the badge container to the body
+        document.body.appendChild(badge);
+
+        // Style the badge using CSS
+        const style = document.createElement("style");
+        style.textContent = `
+            .attribution-badge {
+                position: fixed;
+                bottom: 10px;
+                right: 10px;
+                background-color: rgba(0.2, 0.2, 0.25, 0.25);
+                padding: 5px 10px 2px 10px;
+                border-radius: 12px;
+                z-index: 1000;
+            }
+            .attribution-image {
+                width: 80px;
+                cursor: pointer;
+            }
+        `;
+        document.head.appendChild(style);
+    }
+
+    // Automatically create the badge when loaded
+    document.addEventListener("DOMContentLoaded", createAttributionBadge);
+})();

package/dist/badge.min.js

@@ -0,0 +1 @@
+document.addEventListener("DOMContentLoaded",(function(){const t=document.createElement("div");t.className="attribution-badge";const n=document.createElement("img");n.src="https://subfork.com/static/logo.png",n.title="Built with Subfork",n.alt="Subfork",n.className="attribution-image",n.addEventListener("click",(()=>{window.open("https://subfork.com","_blank")})),t.appendChild(n),document.body.appendChild(t);const e=document.createElement("style");e.textContent="\n            .attribution-badge {\n                position: fixed;\n                bottom: 10px;\n                right: 10px;\n                background-color: rgba(0.2, 0.2, 0.25, 0.25);\n                padding: 5px 10px 2px 10px;\n                border-radius: 12px;\n                z-index: 1000;\n            }\n            .attribution-image {\n                width: 80px;\n                cursor: pointer;\n            }\n        ",document.head.appendChild(e)}));

package/dist/subfork.js

@@ -2,6 +2,7 @@
 Copyright (c) Subfork. All rights reserved.
 
 TODO:
+- use webpack to bundle client side dependencies
 - replace post-request with non-jquery function
 - refactor to immediately-invoked function expression (IIFE)
 
@@ -47,19 +48,19 @@ Set on "done" callback when creating task:
 */
 
 // define some constants
-const version = "0.1.0";
+const version = "0.1.2";
 const api_version = "api";
 const hostname = window.location.hostname;
 const port = window.location.port;
 const protocol = window.location.protocol;
-const socket_loaded = false;
-const socket_script = "https://code.subfork.com/socket.io.min.js";
+const socket_script = "https://cdn.jsdelivr.net/npm/socket.io@4.5.4/client-dist/socket.io.min.js";
 const wait_time = 100;
 
 // init some variables
 var message;
 var server;
 var socket;
+var socket_loaded = false;
 
 // async returns a sha256 string (only works with https)
 async function sha256(message) {

package/dist/subfork.min.js

@@ -1 +1 @@
-const version="0.1.0",api_version="api",hostname=window.location.hostname,port=window.location.port,protocol=window.location.protocol,socket_loaded=!1,socket_script="https://code.subfork.com/socket.io.min.js",wait_time=100;var message,server,socket;async function sha256(t){const e=new TextEncoder("utf-8").encode(t),s=await window.crypto.subtle.digest("SHA-256",e);return Array.from(new Uint8Array(s)).map((t=>("00"+t.toString(16)).slice(-2))).join("")}function load_socket_library(t,e){if(socket_loaded)e(t);else{var s=document.createElement("script");s.src=socket_script,document.head.appendChild(s),s.onload=function(){socket_loaded=!0,e(t)}}}function wait_for(t,e){t()?e():window.setTimeout(wait_for.bind(null,t,e),100)}function build_url(t){return"/api/"+t}function is_local(){return!("http:"!==protocol||"localhost"!==hostname&&"0.0.0.0"!==hostname&&"127.0.0.1"!==hostname||"8000"!==port&&"8080"!==port)}function post_request(t,e={},s=null,o=!0){$.ajax({type:"POST",contentType:"application/json; charset=utf-8",url:t,async:o,data:JSON.stringify(e),success:function(t){s?s(t):console.debug("no callback")},dataType:"json"})}class Datatype{constructor(t){this.name=t}create(t,e=null){let s={collection:this.name,data:t,version:"0.1.0"};return post_request(build_url("data/create"),t=s,(function(t){e&&e(t)})),!1}delete(t,e=null){let s={collection:this.name,params:t,version:"0.1.0"};return post_request(build_url("data/delete"),s,(function(t){e&&e(t)})),!1}find(t,e=null,s=!1,o=!0){let a={collection:this.name,expand:s,params:t,version:"0.1.0"};return post_request(build_url("data/get"),a,(function(t){e&&e(t)}),o),!1}update(t,e,s=null){let o={collection:this.name,id:t,data:e,version:"0.1.0"};return post_request(build_url("data/update"),e=o,(function(t){s&&s(t)})),!1}}class SubforkEvent{constructor(t,e){this.name=t,this.type=e.type,this.message=e.message,this.event_data=e}data(){if("data"==this.type)return new Datatype(this.name)}task(){if("task"==this.type){let t=new SubforkTaskQueue(this.event_data.queue);return new SubforkTask(t,this.event_data.task)}}user(){if("user"==this.type)return new SubforkUser(queue,this.event_data.task)}}class SubforkTask{constructor(t,e){this.queue=t,this.data=e}get_error(){return this.data.error}get_results(){try{return JSON.parse(this.data.results)}catch{return this.data.results}}on(t,e){return this.queue.on(t,e)}}class SubforkTaskQueue{constructor(t,e){this.conn=t,this.name=e}create(t){var e=new SubforkTask(this,t);if(this.enqueue(e))return e}enqueue(t){let e={queue:this.name,data:t.data,version:"0.1.0"},s=!1;return post_request(build_url("task/create"),e,(function(t){t.success&&(s=!0)})),s}get(t){let e={queue:this.name,taskid:t,version:"0.1.0"};var s;return post_request(build_url("task/get"),e,(function(t){t.success?s=new SubforkTask(this,t.data):console.error(t.error)}),async=!1),s}on(t,e){let s=this.conn.session.sessionid+":task:"+this.name+":"+t;return socket.on(s,(function(s,o){let a=new SubforkEvent(t,s);e(a)})),!0}}class SubforkUser{constructor(t){this.data=t}}class SubforkCache{constructor(t){this.parent=t,this._cache={}}add(t,e,s){t in this._cache||(this._cache[t]={}),this._cache[t][e]=s}clear(){Object.keys(this._cache).forEach((t=>{delete this._cache[t]}))}del(t,e){t in this._cache&&e in this._cache[t]&&delete this._cache[t][e]}get(t,e){if(t in this._cache&&e in this._cache[t])return this._cache[t][e]}update(t,e){t in this._cache||(this._cache[t]={}),Object.assign(this._cache[t],e)}}class Subfork{constructor(t={}){this.cache=new SubforkCache(this),this.session={},this.set_config(t),this.connect()}set_config(t){this.config=t,this.config.host=this.config.host??window.location.hostname,this.config.port=this.config.port??window.location.port}connect(){this.session=this.get_session_data(),console.debug("sessionid",this.session.sessionid),load_socket_library(this.config.host,(function(t){socket=io("https://events.fork.io"),console.debug("connected to event server")}))}get_session_data(){let t={source:this.config.host,version:"api"},e={};return post_request(build_url("get_session_data"),t,(function(t){t.success&&t.data?e=t.data:console.error(t.error)}),!1),e}data(t){if(!this.cache.get("data",t)){var e=new Datatype(t);this.cache.add("data",t,e)}return this.cache.get("data",t)}is_connected(){return socket_loaded&&socket.connected}ready(t){wait_for((()=>window.socket),(()=>t()))}task(t){if(!this.cache.get("task",t)){var e=new SubforkTaskQueue(this,t);this.cache.add("task",t,e)}return this.cache.get("task",t)}user(t){if(!this.cache.get("user",t)){let s={username:t,version:"0.1.0"};var e;post_request(build_url("user/get"),s,(function(t){t.success&&(e=new SubforkUser(t.data))}),!1),this.cache.add("user",t,e)}return this.cache.get("user",t)}}
+const version="0.1.2",api_version="api",hostname=window.location.hostname,port=window.location.port,protocol=window.location.protocol,socket_script="https://cdn.jsdelivr.net/npm/socket.io@4.5.4/client-dist/socket.io.min.js",wait_time=100;var message,server,socket,socket_loaded=!1;async function sha256(t){const e=new TextEncoder("utf-8").encode(t),s=await window.crypto.subtle.digest("SHA-256",e);return Array.from(new Uint8Array(s)).map((t=>("00"+t.toString(16)).slice(-2))).join("")}function load_socket_library(t,e){if(socket_loaded)e(t);else{var s=document.createElement("script");s.src=socket_script,document.head.appendChild(s),s.onload=function(){socket_loaded=!0,e(t)}}}function wait_for(t,e){t()?e():window.setTimeout(wait_for.bind(null,t,e),100)}function build_url(t){return"/api/"+t}function is_local(){return!("http:"!==protocol||"localhost"!==hostname&&"0.0.0.0"!==hostname&&"127.0.0.1"!==hostname||"8000"!==port&&"8080"!==port)}function post_request(t,e={},s=null,n=!0){$.ajax({type:"POST",contentType:"application/json; charset=utf-8",url:t,async:n,data:JSON.stringify(e),success:function(t){s?s(t):console.debug("no callback")},dataType:"json"})}class Datatype{constructor(t){this.name=t}create(t,e=null){let s={collection:this.name,data:t,version:"0.1.2"};return post_request(build_url("data/create"),t=s,(function(t){e&&e(t)})),!1}delete(t,e=null){let s={collection:this.name,params:t,version:"0.1.2"};return post_request(build_url("data/delete"),s,(function(t){e&&e(t)})),!1}find(t,e=null,s=!1,n=!0){let a={collection:this.name,expand:s,params:t,version:"0.1.2"};return post_request(build_url("data/get"),a,(function(t){e&&e(t)}),n),!1}update(t,e,s=null){let n={collection:this.name,id:t,data:e,version:"0.1.2"};return post_request(build_url("data/update"),e=n,(function(t){s&&s(t)})),!1}}class SubforkEvent{constructor(t,e){this.name=t,this.type=e.type,this.message=e.message,this.event_data=e}data(){if("data"==this.type)return new Datatype(this.name)}task(){if("task"==this.type){let t=new SubforkTaskQueue(this.event_data.queue);return new SubforkTask(t,this.event_data.task)}}user(){if("user"==this.type)return new SubforkUser(queue,this.event_data.task)}}class SubforkTask{constructor(t,e){this.queue=t,this.data=e}get_error(){return this.data.error}get_results(){try{return JSON.parse(this.data.results)}catch{return this.data.results}}on(t,e){return this.queue.on(t,e)}}class SubforkTaskQueue{constructor(t,e){this.conn=t,this.name=e}create(t){var e=new SubforkTask(this,t);if(this.enqueue(e))return e}enqueue(t){let e={queue:this.name,data:t.data,version:"0.1.2"},s=!1;return post_request(build_url("task/create"),e,(function(t){t.success&&(s=!0)})),s}get(t){let e={queue:this.name,taskid:t,version:"0.1.2"};var s;return post_request(build_url("task/get"),e,(function(t){t.success?s=new SubforkTask(this,t.data):console.error(t.error)}),async=!1),s}on(t,e){let s=this.conn.session.sessionid+":task:"+this.name+":"+t;return socket.on(s,(function(s,n){let a=new SubforkEvent(t,s);e(a)})),!0}}class SubforkUser{constructor(t){this.data=t}}class SubforkCache{constructor(t){this.parent=t,this._cache={}}add(t,e,s){t in this._cache||(this._cache[t]={}),this._cache[t][e]=s}clear(){Object.keys(this._cache).forEach((t=>{delete this._cache[t]}))}del(t,e){t in this._cache&&e in this._cache[t]&&delete this._cache[t][e]}get(t,e){if(t in this._cache&&e in this._cache[t])return this._cache[t][e]}update(t,e){t in this._cache||(this._cache[t]={}),Object.assign(this._cache[t],e)}}class Subfork{constructor(t={}){this.cache=new SubforkCache(this),this.session={},this.set_config(t),this.connect()}set_config(t){this.config=t,this.config.host=this.config.host??window.location.hostname,this.config.port=this.config.port??window.location.port}connect(){this.session=this.get_session_data(),console.debug("sessionid",this.session.sessionid),load_socket_library(this.config.host,(function(t){socket=io("https://events.fork.io"),console.debug("connected to event server")}))}get_session_data(){let t={source:this.config.host,version:"api"},e={};return post_request(build_url("get_session_data"),t,(function(t){t.success&&t.data?e=t.data:console.error(t.error)}),!1),e}data(t){if(!this.cache.get("data",t)){var e=new Datatype(t);this.cache.add("data",t,e)}return this.cache.get("data",t)}is_connected(){return socket_loaded&&socket.connected}ready(t){wait_for((()=>window.socket),(()=>t()))}task(t){if(!this.cache.get("task",t)){var e=new SubforkTaskQueue(this,t);this.cache.add("task",t,e)}return this.cache.get("task",t)}user(t){if(!this.cache.get("user",t)){let s={username:t,version:"0.1.2"};var e;post_request(build_url("user/get"),s,(function(t){t.success&&(e=new SubforkUser(t.data))}),!1),this.cache.add("user",t,e)}return this.cache.get("user",t)}}

package/package.json

@@ -1,12 +1,13 @@
 {
     "name": "subfork",
-    "version": "0.1.0",
-    "description": "Subfork Javascript client",
+    "version": "0.1.2",
+    "description": "Subfork Javascript libraries",
     "main": "dist/subfork.js",
     "scripts": {
-        "build": "mkdir -p dist && cp subfork.js dist/subfork.js && terser subfork.js -o dist/subfork.min.js --compress --mangle",
-        "prepublishOnly": "npm run build",
-        "test": "echo \"Error: no test specified\" && exit 1"
+        "build": "npm run clean && npm run copy && npm run minify",
+        "clean": "shx rm -rf dist",
+        "copy": "shx mkdir -p dist && shx cp src/*.js dist/",
+        "minify": "for file in src/*.js; do terser \"$file\" -o \"dist/$(basename \"$file\" .js).min.js\" --compress --mangle; done"
     },
     "repository": {
         "type": "git",
@@ -19,6 +20,10 @@
     },
     "homepage": "https://subfork.com",
     "devDependencies": {
+        "shx": "^0.3.4",
         "terser": "^5.31.3"
-    }
+    },
+    "files": [
+        "dist/"
+    ]
 }

package/subfork.js

@@ -1,442 +0,0 @@
-/*
-Copyright (c) Subfork. All rights reserved.
-
-TODO:
-- replace post-request with non-jquery function
-- refactor to immediately-invoked function expression (IIFE)
-
-    const Subfork = (() => {
-        ...
-        return {
-            subfork: Subfork
-        }
-    })();
-
-Instantiate client:
-
-    const subfork = Subfork();
-
-or pass in some config values:
-
-    const subfork = Subfork({
-        host: "test.fork.io",
-        on: {
-            "message": function(msg) {
-                console.log(msg);
-            },
-        }
-    });
-
-Connect "test" task "done" event callback:
-
-    subfork.task("test").on("done", function(e) {
-        console.log(e.message + ": " + e.task.results);
-    });
-
-Create a "test" task with some data:
-
-    subfork.task("test").create({t:2});
-
-Set on "done" callback when creating task:
-
-    subfork.task("test").create({
-        "t": 3
-    }).on("done", function(event) {
-        console.log(event);
-    });
-*/
-
-// define some constants
-const version = "0.1.0";
-const api_version = "api";
-const hostname = window.location.hostname;
-const port = window.location.port;
-const protocol = window.location.protocol;
-const socket_loaded = false;
-const socket_script = "https://code.subfork.com/socket.io.min.js";
-const wait_time = 100;
-
-// init some variables
-var message;
-var server;
-var socket;
-
-// async returns a sha256 string (only works with https)
-async function sha256(message) {
-    const msgBuffer = new TextEncoder("utf-8").encode(message);
-    // hash the message
-    const hashBuffer = await window.crypto.subtle.digest("SHA-256", msgBuffer);
-    // convert ArrayBuffer to Array
-    const hashArray = Array.from(new Uint8Array(hashBuffer));
-    // convert bytes to hex string
-    const hashHex = hashArray.map(b => ("00" + b.toString(16)).slice(-2)).join("");
-    return hashHex;
-};
-
-// load socket library (required for events)
-function load_socket_library(host, callback) {
-    if (socket_loaded) {
-        callback(host);
-    } else {
-        var script = document.createElement("script");
-        script.src = socket_script;
-        document.head.appendChild(script);
-        script.onload = function () {
-            socket_loaded = true;
-            callback(host);
-        };
-    };
-};
-
-// waits for condition to be true
-function wait_for(condition, callback) {
-    if(!condition()) {
-        window.setTimeout(wait_for.bind(null, condition, callback), wait_time);
-    } else {
-        callback();
-    };
-};
-
-// returns a local api url, e.g.: /api/task/create
-function build_url(endpoint) {
-    return "/" + api_version + "/" + endpoint;
-};
-
-// returns true if is running locally
-function is_local() {
-    return (
-        (protocol === "http:") &&
-        (hostname === "localhost" || hostname === "0.0.0.0" || hostname === "127.0.0.1") &&
-        (port === "8000" || port === "8080")
-    );
-};
-
-// post request to server
-// function _request(url, data={}) {
-//     fetch(url, {
-//         method: "POST",
-//         headers: {
-//             "Accept": "application/json",
-//             "Content-Type': 'application/json"
-//         },
-//         body: JSON.stringify(data)
-//     })
-//     .then(response => response.json())
-//     .then(response => console.log(JSON.stringify(response)))
-// };
-function post_request(url, data={}, func=null, async=true) {
-    $.ajax({
-        type: "POST",
-        contentType: "application/json; charset=utf-8",
-        url: url,
-        async: async,
-        data: JSON.stringify(data),
-        success: function (resp) {
-            if (func) {
-                func(resp);
-            } else {
-                console.debug("no callback");
-            };
-        },
-        dataType: "json"
-    });
-};
-
-// datatype class
-class Datatype {
-    constructor(name) {
-        this.name = name;
-    }
-    create(data, callback=null) {
-        let row_data = {
-            "collection": this.name,
-            "data": data,
-            "version": version,
-        };
-        let success = false;
-        let url = build_url("data/create");
-        post_request(url, data=row_data, function(resp) {
-            if (callback) {
-                callback(resp);
-            };
-        })
-        return success;
-    }
-    delete(params, callback=null) {
-        let data = {
-            "collection": this.name,
-            "params": params,
-            "version": version,
-        };
-        let success = false;
-        let url = build_url("data/delete");
-        post_request(url, data=data, function(resp) {
-            if (callback) {
-                callback(resp);
-            };
-        })
-        return success;
-    }
-    find(params, callback=null, expand=false, async=true) {
-        let data = {
-            "collection": this.name,
-            "expand": expand,
-            "params": params,
-            "version": version,
-        };
-        let success = false;
-        let url = build_url("data/get");
-        post_request(url, data=data, function(resp) {
-            if (callback) {
-                callback(resp);
-            };
-        }, async=async)
-        return success;
-    }
-    update(id, data, callback=null) {
-        let row_data = {
-            "collection": this.name,
-            "id": id,
-            "data": data,
-            "version": version,
-        };
-        let success = false;
-        let url = build_url("data/update");
-        post_request(url, data=row_data, function(resp) {
-            if (callback) {
-                callback(resp);
-            };
-        })
-        return success;
-    }
-};
-
-// event class
-class SubforkEvent {
-    constructor(event_name, event_data) {
-        this.name = event_name;
-        this.type = event_data.type;
-        this.message = event_data.message;
-        this.event_data = event_data;
-    }
-    data() {
-        if (this.type == "data") {
-            return new Datatype(this.name);
-        }
-    }
-    task() {
-        if (this.type == "task") {
-            let queue = new SubforkTaskQueue(this.event_data.queue);
-            return new SubforkTask(queue, this.event_data.task);
-        }
-    }
-    user() {
-        if (this.type == "user") {
-            return new SubforkUser(queue, this.event_data.task);
-        }
-    }
-};
-
-// task class
-class SubforkTask {
-    constructor(queue, data) {
-        this.queue = queue;
-        this.data = data;
-    }
-    get_error() {
-        return this.data.error;
-    }
-    get_results() {
-        try {
-            return JSON.parse(this.data.results);
-        } catch {
-            return this.data.results;
-        };
-    }
-    // TODO: hash the event signature
-    on(event_name, callback) {
-        return this.queue.on(event_name, callback);
-    }
-};
-
-// task queue class
-class SubforkTaskQueue {
-    constructor(conn, name) {
-        this.conn = conn;
-        this.name = name;
-    }
-    // create and enqueue new task
-    create(data) {
-        var t = new SubforkTask(this, data);
-        if (this.enqueue(t)) {
-            return t;
-        }
-    }
-    // enqueue a task
-    enqueue(task) {
-        let data = {
-            "queue": this.name,
-            "data": task.data,
-            "version": version,
-        };
-        let success = false;
-        let url = build_url("task/create");
-        post_request(url, data=data, function(resp) {
-            if (resp.success) {
-                success = true;
-            };
-        })
-        return success;
-    }
-    // find and return a task by id
-    get(taskid) {
-        let data = {
-            "queue": this.name,
-            "taskid": taskid,
-            "version": version,
-        };
-        let url = build_url("task/get");
-        var task;
-        post_request(url, data=data, function(resp) {
-            if (resp.success) {
-                task = new SubforkTask(this, resp.data);
-            } else {
-                console.error(resp.error);
-            };
-        }, async=false);
-        return task;
-    }
-    // listen for task events
-    // TODO: hash the event signature
-    on(event_name, callback) {
-        let sig = this.conn.session.sessionid + ":task:" + this.name + ":" + event_name;
-        socket.on(sig, function(event_data, cb) {
-            let event = new SubforkEvent(event_name, event_data);
-            callback(event);
-        });
-        return true;
-    }
-};
-
-// user class
-class SubforkUser {
-    constructor(data) {
-        this.data = data;
-    }
-};
-
-// in-memory only data cache class
-class SubforkCache {
-    constructor(parent) {
-        this.parent = parent;
-        this._cache = {};
-    }
-    add(type, name, value) {
-        if (!(type in this._cache)) {
-            this._cache[type] = {};
-        };
-        this._cache[type][name] = value;
-    }
-    clear() {
-        Object.keys(this._cache).forEach(key => {
-            delete this._cache[key];
-        });
-    }
-    del(type, name) {
-        if (type in this._cache && name in this._cache[type]) {
-            delete this._cache[type][name];
-        }
-    }
-    get(type, name) {
-        if (type in this._cache && name in this._cache[type]) {
-            return this._cache[type][name];
-        };
-    }
-    update(type, other) {
-        if (!(type in this._cache)) {
-            this._cache[type] = {};
-        };
-        Object.assign(this._cache[type], other);
-    }
-}
-
-// subfork client class
-class Subfork {
-    constructor(config={}) {
-        this.cache = new SubforkCache(this);
-        this.session = {};
-        this.set_config(config);
-        this.connect();
-    }
-    // checks config values for default overrides
-    set_config(config) {
-        this.config = config;
-        this.config.host = this.config["host"] ?? window.location.hostname;
-        this.config.port = this.config["port"] ?? window.location.port;
-    }
-    // connect to event server
-    connect() {
-        this.session = this.get_session_data();
-        console.debug("sessionid", this.session.sessionid);
-        load_socket_library(this.config.host, function(host) {
-            socket = io("https://events.fork.io");
-            console.debug("connected to event server");
-        });
-    }
-    // get session data from the server
-    get_session_data() {
-        let data = {"source": this.config.host, "version": api_version};
-        let session_data = {};
-        let url = build_url("get_session_data");
-        post_request(url, data, function(resp) {
-            if (resp.success && resp.data) {
-                session_data = resp.data;
-            } else {
-                console.error(resp.error);
-            };
-        }, false);
-        return session_data;
-    };
-    // datatype accessor
-    data(name) {
-        if (!(this.cache.get("data", name))) {
-            var dt = new Datatype(name);
-            this.cache.add("data", name, dt);
-        };
-        return this.cache.get("data", name);
-    }
-    // return true if connected to event server
-    is_connected() {
-        return (socket_loaded && socket.connected);
-    }
-    // on ready wait for socket connection
-    ready(callback) {
-        wait_for(() => window.socket, () => callback());
-    }
-    // task queue accessor
-    task(name) {
-        if (!(this.cache.get("task", name))) {
-            var q = new SubforkTaskQueue(this, name);
-            this.cache.add("task", name, q);
-        };
-        return this.cache.get("task", name);
-    }
-    // user accessor
-    user(username) {
-        if (!(this.cache.get("user", username))) {
-            let data = {
-                "username": username,
-                "version": version,
-            };
-            let url = build_url("user/get");
-            var user;
-            post_request(url, data=data, function(resp) {
-                if (resp.success) {
-                    user = new SubforkUser(resp.data);
-                };
-            }, false);
-            this.cache.add("user", username, user);
-        };
-        return this.cache.get("user", username);
-    }
-};