@akc42/app-utils 3.1.5

package/dom-host.js

@@ -0,0 +1,31 @@
+/**
+@licence
+    Copyright (c) 2020 Alan Chandler, all rights reserved
+
+    This file is part of @akc42/app-utils.
+
+    @akc42/app-utils is free software: you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    @akc42/app-utils is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with @akc42/app-utils.  If not, see <http://www.gnu.org/licenses/>.
+*/
+
+
+
+function domHost(self) {
+  let parent = self.parentNode;
+  while (parent && parent.nodeType !== 11) {
+    parent = parent.parentNode;  //work up the hierarchy
+  }
+
+  return parent ? parent.host : self;
+}
+export default domHost;

package/master-tab-promise.js

@@ -0,0 +1,99 @@
+/**
+@licence
+    Copyright (c) 2020 Alan Chandler, all rights reserved
+
+    This file is part of @akc42/app-utils.
+
+    @akc42/app-utils is free software: you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    @akc42/app-utils is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with @akc42/app-utils.  If not, see <http://www.gnu.org/licenses/>.
+*/
+
+let master = false;
+let masterResolver;
+let masterPromise = new Promise(resolve => masterResolver = resolve);
+
+
+let otherTabs = new Set();
+let timer = 0.
+const tabId = Date.now().toString();
+const storageHandler = (e) => {
+  if (e.key === 'pageOpen') {
+    otherTabs.add(localStorage.getItem('pageOpen'))
+    localStorage.setItem('pageAvailable', tabId); //respond - so the ender knows he is not master.
+  }
+  if (e.key === 'pageAvailable') {
+    if (timer > 0) {
+      clearTimeout(timer);
+      master = false;
+      masterResolver(false);
+    }
+  }
+  if (e.key === 'pageClose') {
+    const closer = JSON.parse(localStorage.getItem('pageClose'));
+    if (master) {
+      otherTabs.delete(closer.id);
+    } else {
+      if (closer.master) {
+        otherTabs = new Set(closer.list); //Make a set from the list the closing master had
+        otherTabs.delete(tabId); //remove self  
+        masterPromise = new Promise(resolve => masterResolver = resolve);
+
+        if (closer.size === 1) {
+          //must be just me left, so I become master
+          master = true;
+          masterResolver(true);
+        } else {
+          //We need to wait a random time before trying to become master, but
+          timer = setTimeout(() => {
+            timer = setTimeout(() => {
+              master = true;
+              masterResolver(true);
+            }, 70); //wait 70 ms to see if our claim was refuted
+            localStorage.setItem('pageClaim', tabId); //try and claim storage
+          }, 70 * Math.floor((Math.random() * 40))); //wait random time between 70ms and about 3 seconds before trying to claim master
+        }
+        window.dispatchEvent(new CustomEvent('master-close', { composed: true, bubbles: true }));
+      }
+    }
+  }
+  if (e.key === 'pageClaim') {
+    if (timer > 0) {
+      clearTimeout(timer); //someone else has claimed master ship, kill of our attempt;
+      master = false;
+      masterResolver(false);
+    }
+  }
+}
+
+window.addEventListener('storage', storageHandler);
+const unloadHandler = () => {
+  localStorage.setItem('pageClose', JSON.stringify({
+    master: master,
+    id: tabId,
+    size: otherTabs.size,
+    list: Array.from(otherTabs)
+  }));
+  window.removeEventListener('storage', storageHandler);
+  window.removeEventListener('beforeunload', unloadHandler);
+};
+window.addEventListener('unload', unloadHandler);
+timer = setTimeout(() => {
+  timer = 0;  //prevent our assertion being overridden by a later try
+  master = true;
+  masterResolver(true);
+}, 70);
+localStorage.setItem('pageOpen', tabId);
+function getPromise() {
+  return masterPromise;
+};
+export default getPromise;

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@akc42/app-utils",
+  "version": "3.1.5",
+  "description": "General Utilities for SPAs",
+  "exports": {
+    ".": "./*.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/akc42/app-utils.git"
+  },
+  "keywords": [
+    "utilities"
+  ],
+  "author": "Alan Chandler",
+  "license": "GPL-3.0-or-later",
+  "bugs": {
+    "url": "https://github.com/akc42/app-utils/issues"
+  },
+  "homepage": "https://github.com/akc42/app-utils#readme"
+}

package/pdf.js

@@ -0,0 +1,23 @@
+/**
+@licence
+    Copyright (c) 2021 Alan Chandler, all rights reserved
+
+    This file is part of @akc42/app-utils.
+
+    @akc42/app-utils is free software: you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    @akc42/app-utils is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with @akc42/app-utils.  If not, see <http://www.gnu.org/licenses/>.
+*/
+import api from './post-api.js';
+export default (url,params) => {
+  api(`pdf/${url}`,params,true);
+}

package/post-api.js

@@ -0,0 +1,54 @@
+/**
+@licence
+    Copyright (c) 2020 Alan Chandler, all rights reserved
+
+    This file is part of @akc42/app-utils.
+
+    @akc42/app-utils is free software: you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    @akc42/app-utils is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with @akc42/app-utils.  If not, see <http://www.gnu.org/licenses/>.
+*/
+
+
+export default async function api(url, params, blob, signal) {
+  const options = {
+    credentials: 'same-origin',
+    method: 'post',
+    headers: new Headers({
+      'content-type': 'application/json'
+    }),
+    body: JSON.stringify(params ?? {})
+  };
+  if (signal) options.signal = signal;
+  let text;
+  try {
+    const response = await window.fetch('/api/' + url, options);
+    if (!response.ok) throw new CustomEvent('api-error', {composed: true, bubbles: true , detail:response.status});
+    if (blob) {
+      text = '---502---';  //Simulate a 502 (bad gateway) incase there is an error in following.
+      const b = await response.blob();
+      window.open(
+        URL.createObjectURL(b),
+        '_blank',
+        'chrome=yes,centerscreen,resizable,scrollbars,status,height=800,width=800');
+      return {};
+    } else {
+      text = await response.text();
+      if (text.length > 0) return JSON.parse(text);
+      return {};
+    }
+  } catch (err) {
+    if (err.type === 'api-error') throw err; //just throw whatever error we had
+    //we failed to parse the json - the actual code should be in the text near the end;
+    throw new CustomEvent('api-error', { composed: true, bubbles: true, detail: parseInt((text?? '---502---').substr(-6, 3), 10) });
+  }
+}

package/submit-function.js

@@ -0,0 +1,91 @@
+/**
+@licence
+    Copyright (c) 2020 Alan Chandler, all rights reserved
+
+    This file is part of @akc42/app-utils.
+
+    @akc42/app-utils is free software: you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    @akc42/app-utils is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with @akc42/app-utils.  If not, see <http://www.gnu.org/licenses/>.
+*/
+
+//handle the on submit event from a form and make it an api call 
+
+import api from './post-api.js';
+
+function checkNode(node, params) {
+
+  if (node.localName === 'input' || node.localName === 'select') {
+    if (node.type === 'radio' || node.type === 'checkbox') {
+      if (node.name !== undefined && node.value !== undefined && node.checked) params[node.name] = node.value;
+      return true;
+    }
+    if (node.name !== undefined && node.value !== undefined) params[node.name] = node.value;
+    return node.checkValidity() && node.dispatchEvent(new CustomEvent('validity-check', { bubbles: true, cancelable: true, composed: true, detail: node.value }));
+  }
+  if (node.localName === 'slot') {
+    const assignedNodes = node.assignedNodes();
+    if (assignedNodes.length > 0) {
+      //we have assigned nodes, so ignore the slots children
+      return assignedNodes.filter(n => n.nodeType === Node.ELEMENT_NODE).reduce((a, n) => checkNode(n, params) && a, true);
+    }
+  }
+  //even if node validator fails we want to carry on because the checkValidity calls will trigger the error messages.
+  if (customElements.get(node.localName)) {
+    /*
+      ignore the children of custom element, they will get picked up as a slot, or we don't care because it is pretending
+      itself to be an input element and so (if it needs it) it will have a checkValidity Function - and if it does that will
+      dispatch the 'validity check' event
+    */
+    if (node.name !== undefined && node.value !== undefined) {
+      params[node.name] = node.value;
+      if (typeof node.checkValidity === 'function') {
+        return node.checkValidity();
+      }
+      return node.dispatchEvent(new CustomEvent('validity-check', { bubbles: true, cancelable: true, composed: true, detail: node.value }));
+    }
+    return checkLevel(node.shadowRoot, params);
+  }
+
+  if (node.children.length > 0) return checkLevel(node, params);
+  return true
+}
+
+function checkLevel(target, params) {
+  return Array.prototype.filter.call(target.children, n => n.nodeType === Node.ELEMENT_NODE).reduce((acc, node) => checkNode(node, params) && acc, true);
+}
+
+export default function submit(e) {
+  let target;
+  if (e.currentTarget) {
+    e.stopPropagation();
+    e.preventDefault();
+    target = e.currentTarget;
+  } else {
+    target = e;
+  }
+  const params = {};
+  if (checkLevel(target, params)) {
+    const action = target.getAttribute('action')
+    if (target.dispatchEvent(new CustomEvent('form-submitting', { cancelable:true,  composed: true, bubbles: true, detail: params}))) {
+      document.body.dispatchEvent(new CustomEvent('wait-request', {detail: true }));
+      api(action, params).then(response => {
+        document.body.dispatchEvent(new CustomEvent('wait-request', {detail: false }));
+        target.dispatchEvent(new CustomEvent('form-response', { composed: true, bubbles: true, detail: response }));
+      });
+    }
+    return params;
+  } else {
+    target.dispatchEvent(new CustomEvent('form-response', { composed: true, bubbles: true, detail: null }));
+    return false;
+  }
+}

package/switch-path.js

@@ -0,0 +1,42 @@
+/**
+@licence
+    Copyright (c) 2020 Alan Chandler, all rights reserved
+
+    This file is part of @akc42/app-utils.
+
+    @akc42/app-utils is free software: you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    @akc42/app-utils is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with @akc42/app-utils.  If not, see <http://www.gnu.org/licenses/>.
+*/
+
+export function generateUri(path, params) {
+  var str = [];
+  if (params) {
+    for (var param in params) {
+      //eslint-disable-next-line no-prototype-builtins
+      if (params.hasOwnProperty(param)) {
+        str.push(encodeURIComponent(param) + '=' + encodeURIComponent(params[param]));
+      }
+    }
+    if (str.length > 0) {
+      return path + '?' + str.join('&');
+    }
+  }
+  return path;
+}
+
+export function switchPath(path, params) {
+  history.pushState({}, null, generateUri(path, params));
+  window.dispatchEvent(new CustomEvent('location-altered', { composed: true, bubbles: true }));
+}
+export default switchPath;
+