primate 0.3.1 → 0.5.1

package/README.md

@@ -1,8 +1,5 @@
 # Primate: a JavaScript framework
 
-⚠️ **This software is currently its initial development phase. It is not
-considered production-ready. Expect breakage.** ⚠️
-
 Primate is a server-client JavaScript framework for web applications aimed at
 relieving you of dealing with repetitive, error-prone tasks and letting you
 concentrate on writing effective, expressive code.
@@ -10,7 +7,7 @@ concentrate on writing effective, expressive code.
 ## Installing
 
 ```
-yarn add primate
+npm install primate
 ```
 
 ## Concepts
@@ -23,11 +20,12 @@ yarn add primate
 * **Correct** data verification using field definitions in domains
 * **Secure** serving hash-verified scripts on secure HTTP with a strong CSP
 * **Roles** access control with contexts
-* **Sessions** using cookies that are `HttpOnly`, `Secure` and `Path`-limited
+* **Sessions** using cookies that are `Secure`, `SameSite=Strict`, `HttpOnly`
+and `Path`-limited
 * **Sane defaults** minimally opinionated with good, overrideable defaults
 for most features
 * **Data linking** modeling `1:1`, `1:n` and `n:m` relationships on domains via
-ad-hoc getters
+cacheable ad-hoc getters
 
 ## Getting started
 
@@ -35,7 +33,10 @@ See the [getting started][getting-started] guide.
 
 ## Resources
 
-Coming soon.
+* [Source code][source-code]
+* [Issues][issues]
+
+A full guide is coming soon.
 
 ## Versioning
 
@@ -49,3 +50,5 @@ BSD-3-Clause
 
 [ws]: https://github.com/websockets/ws
 [getting-started]: https://primatejs.com/getting-started
+[source-code]: https://adaptivecloud.dev/primate/primate
+[issues]: https://adaptivecloud.dev/primate/primate/issues

package/debris.json

@@ -0,0 +1,5 @@
+{
+  "suites": "test/suites",
+  "fixtures": "test/fixtures",
+  "explicit": false
+}

package/jsconfig.json

@@ -0,0 +1,8 @@
+{
+  "compilerOptions": {
+    "baseUrl": ".",
+    "target": "esnext",
+    "module": "esnext"
+  },
+  "exclude": ["node_modules"]
+}

package/package.json

@@ -1,19 +1,31 @@
 {
   "name": "primate",
-  "version": "0.3.1",
+  "version": "0.5.1",
   "author": "Primate core team <core@primatejs.com>",
   "homepage": "https://primatejs.com",
+  "bugs": "https://adaptivecloud.dev/primate/primate/issues",
+  "repository": "https://adaptivecloud.dev/primate/primate",
   "description": "Server-client framework",
   "license": "BSD-3-Clause",
   "dependencies": {
-    "ws": "^8.4.0"
+    "ws": "^8.5.0"
   },
   "scripts": {
-    "test": "node --experimental-json-modules node_modules/stick stick.json"
+    "copy": "rm -rf output && mkdir output && cp source/* output -a",
+    "instrument": "nyc instrument source ./output",
+    "debris": "node --experimental-json-modules node_modules/debris debris.json",
+    "coverage": "npm run instrument && nyc npm run debris",
+    "test": "npm run copy && npm run debris"
+  },
+  "devDependencies": {
+    "debris": "^0.2.0",
+    "eslint": "^8.11.0",
+    "eslint-plugin-json": "^3.1.0",
+    "nyc": "^15.1.0"
   },
   "type": "module",
   "exports": "./source/server/exports.js",
   "engines": {
-    "node": ">=17.3.0"
+    "node": ">=17.7.2"
   }
 }

package/source/client/Action.js

@@ -1,19 +1,17 @@
 import Element from "../Element.js";
 import View from "./View.js";
-import Base from "./Base.js";
-import {origin_base} from "./document.js";
+import {origin_base, origin} from "./document.js";
 
-export default class Action extends Base {
-  constructor(name, context) {
-    super();
+export default class Action {
+  constructor(name, session) {
     this.name = name;
-    this.context = context;
+    this.session = session;
     this.listeners = [];
   }
 
   before() {}
 
-  async enter(data) {
+  enter(data) {
     if (data.location) {
       location.href = data.location;
     } else {
@@ -23,20 +21,20 @@ export default class Action extends Base {
 
   create_view(data, root, save_history = true) {
     if (save_history) {
-      const pathname = data.pathname === "" ? "/" : data.pathname;
-      window.location.pathname !== pathname
-          && history.pushState({}, "", pathname);
+      if (data.url !== document.location.href.replace(origin, "")) {
+        history.pushState({}, "", data.url);
+      }
     }
     this.view = new View(data, this, root);
   }
 
-  create_and_return_view(data, root, save_history) {
+  create_and_return_view(data, root) {
     return new View(data, this, root);
   }
 
   get_form_data(target) {
     const payload = {};
-    const elements = target.elements;
+    const {elements} = target;
     for (let i = 0; i < elements.length; i++) {
       const element = elements[i];
       const type = Element.value(element, "type");
@@ -66,16 +64,16 @@ export default class Action extends Base {
   }
 
   async onsubmit(event) {
-    const target = event.target;
+    const {target} = event;
     const stop = this.fire("submit", event);
     if (stop) {
       return event.preventDefault();
     }
     event.preventDefault();
     const data = await this.write(target.action, this.get_form_data(target));
-    return data.pathname === document.location.href.replace(origin_base, "")
+    return data.type === "update"
       ? this.view.update(data.payload)
-      : this.context.run(data);
+      : this.session.run(data);
   }
 
   async onclick(event) {
@@ -96,8 +94,7 @@ export default class Action extends Base {
       if (event.button === 0 && url.href.startsWith(origin_base)) {
         event.preventDefault();
         if (href !== "") {
-          const data = await this.read(href);
-          await this.context.run(data);
+          await this.session.run(await this.read(href));
         }
       }
     }
@@ -111,13 +108,13 @@ export default class Action extends Base {
   }
 
   oninput() {
-    const stop = this.fire("input", event);
+    this.fire("input", event);
   }
 
   fire(type, event) {
     const listeners = this.listeners[type];
     if (listeners !== undefined) {
-      const target = event.target;
+      const {target} = event;
       for (const listener of listeners) {
         if (event.target.closest(listener.selector)) {
           listener.listener(event, target);
@@ -134,7 +131,8 @@ export default class Action extends Base {
     const index = this.listeners[event]
       .findIndex(listener => listener.selector === selector);
     const object = {selector, listener};
-    if (index === -1) {
+    const not_found = -1;
+    if (index === not_found) {
       this.listeners[event].push(object);
     } else {
       this.listeners[event].splice(index, 1, object);
@@ -150,10 +148,10 @@ export default class Action extends Base {
   }
 
   read(pathname) {
-    return this.context.read(pathname);
+    return this.session.read(pathname);
   }
 
   write(pathname, payload) {
-    return this.context.write(pathname, payload);
+    return this.session.write(pathname, payload);
   }
 }

package/source/client/Client.js

@@ -1,5 +1,4 @@
-import Context from "./Context.js";
-import {contexts} from "./exports.js";
+import Session from "./Session.js";
 import {base, host, origin_base} from "./document.js";
 
 const events = ["submit", "click", "change", "input"];
@@ -9,43 +8,37 @@ const location = `wss://${host}${base}`;
 export default class Client {
   constructor(conf) {
     this.conf = conf;
+    this.session = new Session(this);
 
     window.onpopstate = async event => {
       const {pathname, search} = event.target.location;
-      return this.execute(await this.read(pathname + search));
+      return this.session.run(await this.read(pathname + search));
     };
 
     for (const key of events) {
-      window.addEventListener(key, event => this.context.on(key, event));
+      window.addEventListener(key, event => this.session.on(key, event));
     }
   }
 
   open() {
     return this.connection?.readyState === 1 ? this
       : new Promise(resolve => {
-        const connection = new WebSocket(location);
-        connection.addEventListener("message", ({data}) => data === "open"
+        this.connection = new WebSocket(location);
+        this.connection.addEventListener("message", ({data}) => data === "open"
           ? resolve(this)
           : this.receive(JSON.parse(data)));
-        this.connection = connection;
       });
   }
 
   async receive(data) {
-    if (back !== undefined) {
+    if (back === undefined) {
+      await this.session.execute(data);
+    } else {
       back(data);
       back = undefined;
-    } else {
-      await this.execute(data);
     }
   }
 
-  async execute(data) {
-    const {context} = data;
-    this.context = new (contexts[context] ?? Context)(context, this);
-    await this.context.run(data);
-  }
-
   read(url) {
     return this.send("read", url);
   }
@@ -57,9 +50,12 @@ export default class Client {
   async send(type, url, payload = {}) {
     await this.open();
     const {pathname, search} = new URL(url, origin_base);
+    const _url = pathname + search;
     return new Promise(resolve => {
       back = data => resolve(data);
-      this.connection.send(JSON.stringify({type, pathname, search, payload}));
+      this.connection.send(JSON.stringify({
+        type, pathname, search, payload, "url": _url,
+      }));
     });
   }
 }

package/source/client/Context.js

@@ -1,24 +1,26 @@
-import Base from "./Base.js";
 import Action from "./Action.js";
 import {routes} from "./exports.js";
 
-export default class Context extends Base {
-  constructor(name, client) {
-    super();
+export default class Context {
+  constructor(name, session) {
     this.name = name;
     this.actions = {};
     this.used_actions = [];
-    this.client = client;
+    this.session = session;
+  }
+
+  get Class() {
+    return this.constructor;
   }
 
   async run(data) {
     const {namespace, action} = data;
     const route = `${namespace}/${action}`;
-    const module = routes?.[namespace]?.[action] ?? Action;
-    this.actions[route] = new module(action, this);
+    const Module = routes?.[namespace]?.[action] ?? Action;
+    this.actions[route] = new Module(action, this.session);
     const nextaction = this.actions[route];
     nextaction.enter(data);
-    await this.Class().before(nextaction);
+    await this.Class.before(nextaction);
     nextaction.before();
     this.action = nextaction;
   }
@@ -31,14 +33,6 @@ export default class Context extends Base {
     return data;
   }
 
-  read(pathname) {
-    return this.client.read(pathname);
-  }
-
-  write(pathname, payload) {
-    return this.client.write(pathname, payload);
-  }
-
   on(key, event) {
     this.action[`on${key}`](event);
   }

package/source/client/Element.js

@@ -1,5 +1,5 @@
-const file_listener = event => reader.readAsDataURL(event.target.files[0]);
 const reader = new FileReader();
+const file_listener = event => reader.readAsDataURL(event.target.files[0]);
 
 const replace = (attribute, source) => {
   if (attribute.includes(".")) {
@@ -20,11 +20,11 @@ const fulfill = (attribute, source) => {
   if (source === undefined) {
     return undefined;
   }
-  let value = attribute.value;
+  let {value} = attribute;
   const matches = [...value.matchAll(data_regex)];
   if (matches.length > 0) {
     for (const match of matches) {
-      const key = match[0];
+      const [key] = match;
       const new_value = replace(match[1], source);
       value = value.replace(key, new_value);
     }
@@ -34,7 +34,6 @@ const fulfill = (attribute, source) => {
   return value;
 };
 
-
 const $selector = Symbol("$selector");
 const $element = Symbol("$element");
 const $action = Symbol("$action");
@@ -47,13 +46,13 @@ const proxy_handler = {
     if (property === "on" || property === "insert") {
       return target[property].bind(target);
     }
-    if (target.element !== null) {
-      return (...args) => target[property] !== undefined
-        ? target[property](...args)
-        : receiver;
-    } else {
+    if (target.element === null) {
       return () => receiver;
     }
+
+    return (...args) => target[property] === undefined
+      ? receiver
+      : target[property](...args);
   },
 };
 
@@ -77,8 +76,7 @@ export default class Element {
   }
 
   static value(element, name) {
-    const attribute = element.attributes.getNamedItem(name);
-    return attribute === null ? null : attribute.value;
+    return element?.attributes.getNamedItem(name)?.value;
   }
 
   static evaluate(attribute, source, data) {
@@ -146,7 +144,7 @@ export default class Element {
   class(classes, set) {
     classes.split(" ").forEach(name => {
       this.element.classList.toggle(name, set !== false);
-    })
+    });
     return this;
   }
 
@@ -183,7 +181,8 @@ export default class Element {
 
   options(value) {
     value instanceof Array && value.forEach(option => {
-      if (this.element.children[option._id] === undefined) {
+      const children = [...this.element.children];
+      if (!children.find(child => child.value === option._id)) {
         const newElement = document.createElement("option");
         newElement.setAttribute("value", option._id);
         newElement.innerHTML = option.name;
@@ -203,11 +202,13 @@ export default class Element {
 
   select_value(value) {
     this.element.value = value === undefined ? "" : value;
+    return this;
   }
 
   input_value(value) {
     const type = Element.value(this.element, "type");
     this[`input_${type}_value`]?.(value) ?? this.input_input_value(value);
+    return this;
   }
 
   textarea_value(value) {
@@ -218,21 +219,24 @@ export default class Element {
     if (value === true) {
       this.element.checked = true;
     }
+    return this;
   }
 
   input_file_value(value) {
-    const element = this.element;
+    const {element} = this;
     if (value !== undefined) {
       element.setAttribute("base64", value);
     }
     reader.onload = ({target}) => element.setAttribute("base64", target.result);
     element.addEventListener("change", file_listener);
+    return this;
   }
 
   input_input_value(value) {
     if (value !== undefined) {
       this.element.value = value;
     }
+    return this;
   }
 
   default_value(value) {

package/source/client/Session.js

@@ -0,0 +1,27 @@
+import Context from "./Context.js";
+import {contexts} from "./exports.js";
+
+export default class Session {
+  constructor(client) {
+    this.client = client;
+  }
+
+  async run(data) {
+    const {context} = data;
+    this.context = new (contexts[context] ?? Context)(context, this);
+
+    await this.context.run(data);
+  }
+
+  on(key, event) {
+    this.context.on(key, event);
+  }
+
+  read(pathname) {
+    return this.client.read(pathname);
+  }
+
+  write(pathname, payload) {
+    return this.client.write(pathname, payload);
+  }
+}

package/source/client/View.js

@@ -3,8 +3,6 @@
 import Element from "../Element.js";
 import Node from "./Node.js";
 
-const data_regex = /\${([^}]*)}/g;
-
 export default class View {
   constructor(data, action, root) {
     this.sources = {};
@@ -87,4 +85,5 @@ export default class View {
   write(pathname, payload) {
     return this.action.write(pathname, payload);
   }
+
 }

package/source/client/document.js

@@ -3,4 +3,4 @@ const {host, href, origin} = document.location;
 const base = baseURI === href ? "/" : baseURI.replace(origin, "");
 const origin_base = `${origin}${base}`;
 
-export {base, origin_base, host};
+export {base, origin, origin_base, host};

package/source/preset/primate.json

@@ -2,10 +2,7 @@
   "base": "/",
   "debug": false,
   "defaults": {
-    "action": "index",
-    "context": "guest",
-    "namespace": "default",
-    "store": "default.js"
+    "context": "guest"
   },
   "files": {
     "index": "index.html"
@@ -20,10 +17,7 @@
   },
   "paths": {
     "client": "client",
-    "data": {
-      "domains": "domains",
-      "stores": "stores"
-    },
+    "domains": "domains",
     "public": "public",
     "server": "server",
     "static": "static"