@muze-nl/assert 0.4.2 → 0.5.1

package/dist/{browser.js → assert.js}

@@ -1,30 +1,5 @@
 (() => {
-  var __defProp = Object.defineProperty;
-  var __export = (target, all) => {
-    for (var name in all)
-      __defProp(target, name, { get: all[name], enumerable: true });
-  };
-
   // src/assert.mjs
-  var assert_exports = {};
-  __export(assert_exports, {
-    Optional: () => Optional,
-    Recommended: () => Recommended,
-    Required: () => Required,
-    allOf: () => allOf,
-    anyOf: () => anyOf,
-    assert: () => assert,
-    disable: () => disable,
-    enable: () => enable,
-    error: () => error,
-    fails: () => fails,
-    instanceOf: () => instanceOf,
-    not: () => not,
-    oneOf: () => oneOf,
-    validEmail: () => validEmail,
-    validURL: () => validURL,
-    warn: () => warn
-  });
   globalThis.assertEnabled = false;
   function enable() {
     globalThis.assertEnabled = true;
@@ -245,7 +220,22 @@
   function warn(message, data, pattern, path) {
     console.warn("\u{1F170}\uFE0F  Assert: " + path, message, pattern, data);
   }
-
-  // src/browser.mjs
-  globalThis.assert = assert_exports;
+  globalThis.assert = {
+    warn,
+    error,
+    assert,
+    enable,
+    disable,
+    Required,
+    Recommended,
+    Optional,
+    oneOf,
+    anyOf,
+    allOf,
+    validURL,
+    validEmail,
+    instanceOf,
+    not,
+    fails
+  };
 })();

package/dist/assert.min.js

@@ -0,0 +1,2 @@
+(()=>{globalThis.assertEnabled=!1;function b(){globalThis.assertEnabled=!0}function m(){globalThis.assertEnabled=!1}function x(e,o){if(globalThis.assertEnabled){let n=l(e,o);if(n)throw console.error("\u{1F170}\uFE0F  Assertions failed because of:",n,"in this source:",e),new Error("Assertions failed",{cause:{problems:n,source:e}})}}function d(e){return function(n,r,i){if(typeof n<"u"&&n!=null&&typeof e<"u")return l(n,e,r,i)}}function h(e){return function(n,r,i){return n==null||typeof n>"u"?s("data is required",n,e||"any value",i):typeof e<"u"?l(n,e,r,i):!1}}function A(e){return function(n,r,i){return n==null||typeof n>"u"?(y("data does not contain recommended value",n,e,i),!1):l(n,e,r,i)}}function c(...e){return function(n,r,i){for(let f of e)if(!l(n,f,r,i))return!1;return s("data does not match oneOf patterns",n,e,i)}}function O(...e){return function(n,r,i){if(!Array.isArray(n))return s("data is not an array",n,"anyOf",i);for(let f of n)if(c(...e)(f))return s("data does not match anyOf patterns",f,e,i);return!1}}function g(...e){return function(n,r,i){let f=[];for(let t of e)f=f.concat(l(n,t,r,i));if(f=f.filter(Boolean),f.length)return s("data does not match all given patterns",n,e,i,f)}}function v(e,o,n){try{e instanceof URL&&(e=e.href);let r=new URL(e);if(r.href!=e&&!(r.href+"/"==e||r.href==e+"/"))return s("data is not a valid url",e,"validURL",n)}catch{return s("data is not a valid url",e,"validURL",n)}}function R(e,o,n){if(!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(e))return s("data is not a valid email",e,"validEmail",n)}function E(e){return function(n,r,i){if(!(n instanceof e))return s("data is not an instanceof pattern",n,e,i)}}function p(e){return function(n,r,i){if(!l(n,e,r,i))return s("data matches pattern, when required not to",n,e,i)}}function l(e,o,n,r=""){n||(n=e);let i=[];if(o===Boolean)typeof e!="boolean"&&!(e instanceof Boolean)&&i.push(s("data is not a boolean",e,o,r));else if(o===Number)typeof e!="number"&&!(e instanceof Number)&&i.push(s("data is not a number",e,o,r));else if(o===String)typeof e!="string"&&!(e instanceof String)&&i.push(s("data is not a string",e,o,r)),e==""&&i.push(s("data is an empty string, which is not allowed",e,o,r));else if(o instanceof RegExp)if(Array.isArray(e)){let f=e.findIndex((t,u)=>l(t,o,n,r+"["+u+"]"));f>-1&&i.push(s("data["+f+"] does not match pattern",e[f],o,r+"["+f+"]"))}else typeof e>"u"?i.push(s("data is undefined, should match pattern",e,o,r)):o.test(e)||i.push(s("data does not match pattern",e,o,r));else if(o instanceof Function){let f=o(e,n,r);f&&(Array.isArray(f)?i=i.concat(f):i.push(f))}else if(Array.isArray(o)){Array.isArray(e)||i.push(s("data is not an array",e,[],r));for(let f of o)for(let t of e.keys()){let u=l(e[t],f,n,r+"["+t+"]");Array.isArray(u)?i=i.concat(u):u&&i.push(u)}}else if(o&&typeof o=="object")if(Array.isArray(e)){let f=e.findIndex((t,u)=>l(t,o,n,r+"["+u+"]"));f>-1&&i.push(s("data["+f+"] does not match pattern",e[f],o,r+"["+f+"]"))}else if(!e||typeof e!="object")i.push(s("data is not an object, pattern is",e,o,r));else if(e instanceof URLSearchParams&&(e=Object.fromEntries(e)),o instanceof Function){let f=l(e,o,n,r);f&&(i=i.concat(f))}else for(let[f,t]of Object.entries(o)){let u=l(e[f],t,n,r+"."+f);u&&(i=i.concat(u))}else o!=e&&i.push(s("data and pattern are not equal",e,o,r));return i.length?i:!1}function s(e,o,n,r,i){let f={path:r,message:e,found:o,expected:n};return i&&(f.problems=i),f}function y(e,o,n,r){console.warn("\u{1F170}\uFE0F  Assert: "+r,e,n,o)}globalThis.assert={warn:y,error:s,assert:x,enable:b,disable:m,Required:h,Recommended:A,Optional:d,oneOf:c,anyOf:O,allOf:g,validURL:v,validEmail:R,instanceOf:E,not:p,fails:l};})();
+//# sourceMappingURL=assert.min.js.map

package/dist/{browser.min.js.map → assert.min.js.map}

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../src/assert.mjs", "../src/browser.mjs"],
-  "sourcesContent": ["/*\nTODO: add assertExplain global flag, so that if assert() fails, you can call explain() with\n  the same pattern and it will return text explanation of why it failed, each assertion function must \n  then check assertExplain, and return a text explanation of what fails or succeeds\n  top level can then filter to show only the failures\n  (so that not(x) can show the succeeds message of x)\n*/\n\n/**\n * assertEnabled (Boolean) used to toggle whether the assert()\n * method should test assertions or not.\n */\nglobalThis.assertEnabled = false\n\n/**\n * Enables assertion testing with assert()\n */\nexport function enable() {\n\tglobalThis.assertEnabled = true\n}\n\n/**\n * Disables assertion testing with assert()\n */\nexport function disable() {\n\tglobalThis.assertEnabled = false\n}\n\n/**\n * This function will check the source for the assertions in test, if\n * assertion checking is enabled globally.\n * If it is, and any assertion fails, it will throw an assertError\n * with a list of problems and other details.\n */\nexport function assert(source, test) {\n\tif (globalThis.assertEnabled) {\n\t\tlet problems = fails(source,test)\n\t\tif (problems) {\n\t\t\tconsole.error('\uD83C\uDD70\uFE0F  Assertions failed because of:', problems, 'in this source:', source)\n\t\t\tthrow new Error('Assertions failed', {\n\t\t\t\tcause: { problems, source } \n\t\t\t})\n\t\t}\n\t}\n}\n\n/**\n * Tests a given value against a pattern, only if the value is not null or undefined\n */\nexport function Optional(pattern) {\n\treturn function _Optional(data, root, path) {\n\t\tif (typeof data != 'undefined' && data!=null && typeof pattern != 'undefined' ) {\n\t\t\treturn fails(data, pattern, root, path)\n\t\t}\n\t}\n}\n\n/**\n * Tests a given value against a pattern, always.\n */\nexport function Required(pattern) {\n\treturn function _Required(data, root, path) {\n\t\tif (data==null || typeof data == 'undefined') {\n\t\t\treturn error('data is required', data, pattern || 'any value', path)\n\t\t} else if (typeof pattern != 'undefined') {\n\t\t\treturn fails(data, pattern, root, path)\n\t\t} else {\n\t\t\treturn false\n\t\t}\n\t}\n}\n\n/**\n * Tests a given value against a pattern, only if the value is not null or undefined\n * If null or undefined, it does print a warning to the console.\n */\nexport function Recommended(pattern) {\n\treturn function _Recommended(data, root, path) {\n\t\tif (data==null || typeof data == 'undefined') {\n\t\t\twarn('data does not contain recommended value', data, pattern, path)\n\t\t\treturn false\n\t\t} else {\n\t\t\treturn fails(data, pattern, root, path)\n\t\t}\n\t}\n}\n\n/**\n * Tests a given value against a set of patterns, untill one succeeds\n * Returns an error if none succeed\n */\nexport function oneOf(...patterns) { \n\treturn function _oneOf(data, root, path) {\n\t\tfor(let pattern of patterns) {\n\t\t\tif (!fails(data, pattern, root, path)) {\n\t\t\t\treturn false\n\t\t\t}\n\t\t}\n\t\treturn error('data does not match oneOf patterns', data, patterns, path)\n\t}\n}\n\n/**\n * Tests a given array of values against a set of patterns\n * If any value does not match one of the patterns, it will return an error\n * If not given an array to test, it will return an error\n */\nexport function anyOf(...patterns) {\n\treturn function _anyOf(data, root, path) {\n\t\tif (!Array.isArray(data)) {\n\t\t\treturn error('data is not an array',data,'anyOf',path)\n\t\t}\n\t\tfor (let value of data) {\n\t\t\tif (oneOf(...patterns)(value)) {\n\t\t\t\treturn error('data does not match anyOf patterns',value,patterns,path)\n\t\t\t}\n\t\t}\n\t\treturn false\n\t}\n}\n\nexport function allOf(...patterns) {\n\treturn function _allOf(data, root, path) {\n\t\tlet problems = []\n\t\tfor (let pattern of patterns) {\n\t\t\tproblems = problems.concat(fails(data, pattern, root, path))\n\t\t}\n\t\tproblems = problems.filter(Boolean)\n\t\tif (problems.length) {\n\t\t\treturn error('data does not match all given patterns', data, patterns, path, problems)\n\t\t}\n\t}\n}\n\n/**\n * Tests a given value to see if it is a valid (and absolute) URL, by\n * parsing it with the URL() constructor, and then testing the href\n * value to be equal to the initial value.\n */\nexport function validURL(data, root, path) {\n\ttry {\n\t\tif (data instanceof URL) {\n\t\t\tdata = data.href\n\t\t}\n\t\tlet url = new URL(data)\n\t\tif (url.href!=data) {\n\t\t\tif (!(url.href+'/'==data || url.href==data+'/')) {\n\t\t\t\t// new URL() always adds a / as path\n\t\t\t\treturn error('data is not a valid url',data,'validURL',path)\n\t\t\t}\n\t\t}\n\t} catch(e) {\n\t\treturn error('data is not a valid url',data,'validURL',path)\n\t}\n}\n\n/**\n * Tests a given value to see if it looks like a valid email address, by\n * testing it against a regular expression. So there are no guarantees that\n * it is an actual working email address, just that it looks like one.\n */\nexport function validEmail(data, root, path) {\n\tif (!/^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(data)) {\n\t\treturn error('data is not a valid email',data,'validEmail',path)\n\t}\n}\n\n/**\n * Tests a given value to see if it is an object which is an instance of the given\n * constructor\n */\nexport function instanceOf(constructor) {\n\treturn function _instanceOf(data, root, path) {\n\t\tif (!(data instanceof constructor)) {\n\t\t\treturn error('data is not an instanceof pattern',data,constructor,path)\n\t\t}\n\t}\n}\n\n/**\n * Runs the given test pattern on a value, if the test succeeds, it fails\n * the not() test.\n */\nexport function not(pattern) {\n\treturn function _not(data, root, path) {\n\t\tif (!fails(data, pattern, root, path)) {\n\t\t\treturn error('data matches pattern, when required not to', data, pattern, path)\n\t\t}\n\t}\n}\n\n/**\n * returns an array of problems if the data fails to satisfy \n * the assertions in the given pattern, false otherwise\n * @param {any} data    The data to match\n * @param {any} pattern The pattern to match\n * @param {any} root    Root object for assertions, set to data by default\n * @return {Array|false} Array with problems if the pattern fails, false otherwise\n */\nexport function fails(data, pattern, root, path='') {\n\tif (!root) {\n\t\troot = data\n\t}\n\tlet problems = []\n\tif (pattern === Boolean) {\n\t\tif (typeof data != 'boolean' && !(data instanceof Boolean)) {\n\t\t\tproblems.push(error('data is not a boolean', data, pattern, path))\n\t\t}\t\t\n\t} else if (pattern === Number) {\n\t\tif (typeof data != 'number' && !(data instanceof Number)) {\n\t\t\tproblems.push(error('data is not a number', data, pattern, path))\n\t\t}\n\t} else if (pattern === String) {\n\t\tif (typeof data != 'string' && !(data instanceof String)) {\n\t\t\tproblems.push(error('data is not a string', data, pattern, path))\n\t\t}\n\t\tif (data == \"\") {\n\t\t\tproblems.push(error('data is an empty string, which is not allowed', data, pattern, path))\n\t\t}\n\t} else if (pattern instanceof RegExp) {\n    \tif (Array.isArray(data)) {\n\t\t\tlet index = data.findIndex((element,index) => fails(element,pattern,root,path+'['+index+']'))\n            if (index>-1) {\n            \tproblems.push(error('data['+index+'] does not match pattern', data[index], pattern, path+'['+index+']'))\n            }\n        } else if (typeof data == 'undefined') {\n        \tproblems.push(error('data is undefined, should match pattern', data, pattern, path))\n    \t} else if (!pattern.test(data)) {\n        \tproblems.push(error('data does not match pattern', data, pattern, path))\n        }\n    } else if (pattern instanceof Function) {\n        let problem = pattern(data, root, path)\n        if (problem) {\n        \tif (Array.isArray(problem)) {\n        \t\tproblems = problems.concat(problem)\n        \t} else {\n\t        \tproblems.push(problem)\n\t        }\n        }\n    } else if (Array.isArray(pattern)) {\n\t\tif (!Array.isArray(data)) {\n\t\t\tproblems.push(error('data is not an array',data,[],path))\n\t\t}\n\t\tfor (let p of pattern) {\n\t\t\tfor (let index of data.keys()) {\n\t\t\t\tlet problem = fails(data[index], p, root, path+'['+index+']')\n\t\t\t\tif (Array.isArray(problem)) {\n\t\t\t\t\tproblems = problems.concat(problem)\n\t\t\t\t} else if (problem) {\n\t\t\t\t\tproblems.push(problem)\n\t\t\t\t}\n\t\t\t}\n    \t}\n    } else if (pattern && typeof pattern == 'object') {\n        if (Array.isArray(data)) {\n            let index = data.findIndex((element,index) => fails(element,pattern,root,path+'['+index+']'))\n            if (index>-1) {\n            \tproblems.push(error('data['+index+'] does not match pattern', data[index], pattern, path+'['+index+']'))\n            }\n        } else if (!data || typeof data != 'object') {\n        \tproblems.push(error('data is not an object, pattern is', data, pattern, path))\n        } else {\n        \tif (data instanceof URLSearchParams) {\n        \t\tdata = Object.fromEntries(data)\n        \t}\n        \tif (pattern instanceof Function) {\n        \t\tlet result = fails(data, pattern, root, path)\n\t            if (result) {\n\t            \tproblems = problems.concat(result)\n\t            }\n        \t} else {\n\t\t        for (const [patternKey, subpattern] of Object.entries(pattern)) {\n\t\t            let result = fails(data[patternKey], subpattern, root, path+'.'+patternKey)\n\t\t            if (result) {\n\t\t            \tproblems = problems.concat(result)\n\t\t            }\n\t\t        }\n\t\t    }\n\t    }\n    } else {\n    \tif (pattern!=data) {\n    \t\tproblems.push(error('data and pattern are not equal', data, pattern, path))\n    \t}\n    }\n    if (problems.length) {\n    \treturn problems\n    }\n    return false\n}\n\n/**\n * Returns an object with message, found and expected properties\n */ \nexport function error(message, found, expected, path, problems) {\n\tlet result = {\n\t\tpath,\n\t\tmessage,\n\t\tfound,\n\t\texpected\n\t}\n\tif (problems) {\n\t\tresult.problems = problems\n\t}\n\treturn result\n}\n\nexport function warn(message, data, pattern, path) {\n\tconsole.warn('\uD83C\uDD70\uFE0F  Assert: '+path, message, pattern, data)\n}", "import * as assert from './assert.mjs'\n\nglobalThis.assert = assert\n"],
-  "mappings": "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",
-  "names": ["assert_exports", "__export", "Optional", "Recommended", "Required", "allOf", "anyOf", "assert", "disable", "enable", "error", "fails", "instanceOf", "not", "oneOf", "validEmail", "validURL", "warn", "source", "test", "problems", "pattern", "data", "root", "path", "patterns", "value", "url", "constructor", "index", "element", "problem", "p", "result", "patternKey", "subpattern", "message", "found", "expected", "assert_exports"]
+  "sources": ["../src/assert.mjs"],
+  "sourcesContent": ["/*\nTODO: add assertExplain global flag, so that if assert() fails, you can call explain() with\n  the same pattern and it will return text explanation of why it failed, each assertion function must \n  then check assertExplain, and return a text explanation of what fails or succeeds\n  top level can then filter to show only the failures\n  (so that not(x) can show the succeeds message of x)\n*/\n\n/**\n * assertEnabled (Boolean) used to toggle whether the assert()\n * method should test assertions or not.\n */\nglobalThis.assertEnabled = false\n\n/**\n * Enables assertion testing with assert()\n */\nexport function enable() {\n\tglobalThis.assertEnabled = true\n}\n\n/**\n * Disables assertion testing with assert()\n */\nexport function disable() {\n\tglobalThis.assertEnabled = false\n}\n\n/**\n * This function will check the source for the assertions in test, if\n * assertion checking is enabled globally.\n * If it is, and any assertion fails, it will throw an assertError\n * with a list of problems and other details.\n */\nexport function assert(source, test) {\n\tif (globalThis.assertEnabled) {\n\t\tlet problems = fails(source,test)\n\t\tif (problems) {\n\t\t\tconsole.error('\uD83C\uDD70\uFE0F  Assertions failed because of:', problems, 'in this source:', source)\n\t\t\tthrow new Error('Assertions failed', {\n\t\t\t\tcause: { problems, source } \n\t\t\t})\n\t\t}\n\t}\n}\n\n/**\n * Tests a given value against a pattern, only if the value is not null or undefined\n */\nexport function Optional(pattern) {\n\treturn function _Optional(data, root, path) {\n\t\tif (typeof data != 'undefined' && data!=null && typeof pattern != 'undefined' ) {\n\t\t\treturn fails(data, pattern, root, path)\n\t\t}\n\t}\n}\n\n/**\n * Tests a given value against a pattern, always.\n */\nexport function Required(pattern) {\n\treturn function _Required(data, root, path) {\n\t\tif (data==null || typeof data == 'undefined') {\n\t\t\treturn error('data is required', data, pattern || 'any value', path)\n\t\t} else if (typeof pattern != 'undefined') {\n\t\t\treturn fails(data, pattern, root, path)\n\t\t} else {\n\t\t\treturn false\n\t\t}\n\t}\n}\n\n/**\n * Tests a given value against a pattern, only if the value is not null or undefined\n * If null or undefined, it does print a warning to the console.\n */\nexport function Recommended(pattern) {\n\treturn function _Recommended(data, root, path) {\n\t\tif (data==null || typeof data == 'undefined') {\n\t\t\twarn('data does not contain recommended value', data, pattern, path)\n\t\t\treturn false\n\t\t} else {\n\t\t\treturn fails(data, pattern, root, path)\n\t\t}\n\t}\n}\n\n/**\n * Tests a given value against a set of patterns, untill one succeeds\n * Returns an error if none succeed\n */\nexport function oneOf(...patterns) { \n\treturn function _oneOf(data, root, path) {\n\t\tfor(let pattern of patterns) {\n\t\t\tif (!fails(data, pattern, root, path)) {\n\t\t\t\treturn false\n\t\t\t}\n\t\t}\n\t\treturn error('data does not match oneOf patterns', data, patterns, path)\n\t}\n}\n\n/**\n * Tests a given array of values against a set of patterns\n * If any value does not match one of the patterns, it will return an error\n * If not given an array to test, it will return an error\n */\nexport function anyOf(...patterns) {\n\treturn function _anyOf(data, root, path) {\n\t\tif (!Array.isArray(data)) {\n\t\t\treturn error('data is not an array',data,'anyOf',path)\n\t\t}\n\t\tfor (let value of data) {\n\t\t\tif (oneOf(...patterns)(value)) {\n\t\t\t\treturn error('data does not match anyOf patterns',value,patterns,path)\n\t\t\t}\n\t\t}\n\t\treturn false\n\t}\n}\n\nexport function allOf(...patterns) {\n\treturn function _allOf(data, root, path) {\n\t\tlet problems = []\n\t\tfor (let pattern of patterns) {\n\t\t\tproblems = problems.concat(fails(data, pattern, root, path))\n\t\t}\n\t\tproblems = problems.filter(Boolean)\n\t\tif (problems.length) {\n\t\t\treturn error('data does not match all given patterns', data, patterns, path, problems)\n\t\t}\n\t}\n}\n\n/**\n * Tests a given value to see if it is a valid (and absolute) URL, by\n * parsing it with the URL() constructor, and then testing the href\n * value to be equal to the initial value.\n */\nexport function validURL(data, root, path) {\n\ttry {\n\t\tif (data instanceof URL) {\n\t\t\tdata = data.href\n\t\t}\n\t\tlet url = new URL(data)\n\t\tif (url.href!=data) {\n\t\t\tif (!(url.href+'/'==data || url.href==data+'/')) {\n\t\t\t\t// new URL() always adds a / as path\n\t\t\t\treturn error('data is not a valid url',data,'validURL',path)\n\t\t\t}\n\t\t}\n\t} catch(e) {\n\t\treturn error('data is not a valid url',data,'validURL',path)\n\t}\n}\n\n/**\n * Tests a given value to see if it looks like a valid email address, by\n * testing it against a regular expression. So there are no guarantees that\n * it is an actual working email address, just that it looks like one.\n */\nexport function validEmail(data, root, path) {\n\tif (!/^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(data)) {\n\t\treturn error('data is not a valid email',data,'validEmail',path)\n\t}\n}\n\n/**\n * Tests a given value to see if it is an object which is an instance of the given\n * constructor\n */\nexport function instanceOf(constructor) {\n\treturn function _instanceOf(data, root, path) {\n\t\tif (!(data instanceof constructor)) {\n\t\t\treturn error('data is not an instanceof pattern',data,constructor,path)\n\t\t}\n\t}\n}\n\n/**\n * Runs the given test pattern on a value, if the test succeeds, it fails\n * the not() test.\n */\nexport function not(pattern) {\n\treturn function _not(data, root, path) {\n\t\tif (!fails(data, pattern, root, path)) {\n\t\t\treturn error('data matches pattern, when required not to', data, pattern, path)\n\t\t}\n\t}\n}\n\n/**\n * returns an array of problems if the data fails to satisfy \n * the assertions in the given pattern, false otherwise\n * @param {any} data    The data to match\n * @param {any} pattern The pattern to match\n * @param {any} root    Root object for assertions, set to data by default\n * @return {Array|false} Array with problems if the pattern fails, false otherwise\n */\nexport function fails(data, pattern, root, path='') {\n\tif (!root) {\n\t\troot = data\n\t}\n\tlet problems = []\n\tif (pattern === Boolean) {\n\t\tif (typeof data != 'boolean' && !(data instanceof Boolean)) {\n\t\t\tproblems.push(error('data is not a boolean', data, pattern, path))\n\t\t}\t\t\n\t} else if (pattern === Number) {\n\t\tif (typeof data != 'number' && !(data instanceof Number)) {\n\t\t\tproblems.push(error('data is not a number', data, pattern, path))\n\t\t}\n\t} else if (pattern === String) {\n\t\tif (typeof data != 'string' && !(data instanceof String)) {\n\t\t\tproblems.push(error('data is not a string', data, pattern, path))\n\t\t}\n\t\tif (data == \"\") {\n\t\t\tproblems.push(error('data is an empty string, which is not allowed', data, pattern, path))\n\t\t}\n\t} else if (pattern instanceof RegExp) {\n    \tif (Array.isArray(data)) {\n\t\t\tlet index = data.findIndex((element,index) => fails(element,pattern,root,path+'['+index+']'))\n            if (index>-1) {\n            \tproblems.push(error('data['+index+'] does not match pattern', data[index], pattern, path+'['+index+']'))\n            }\n        } else if (typeof data == 'undefined') {\n        \tproblems.push(error('data is undefined, should match pattern', data, pattern, path))\n    \t} else if (!pattern.test(data)) {\n        \tproblems.push(error('data does not match pattern', data, pattern, path))\n        }\n    } else if (pattern instanceof Function) {\n        let problem = pattern(data, root, path)\n        if (problem) {\n        \tif (Array.isArray(problem)) {\n        \t\tproblems = problems.concat(problem)\n        \t} else {\n\t        \tproblems.push(problem)\n\t        }\n        }\n    } else if (Array.isArray(pattern)) {\n\t\tif (!Array.isArray(data)) {\n\t\t\tproblems.push(error('data is not an array',data,[],path))\n\t\t}\n\t\tfor (let p of pattern) {\n\t\t\tfor (let index of data.keys()) {\n\t\t\t\tlet problem = fails(data[index], p, root, path+'['+index+']')\n\t\t\t\tif (Array.isArray(problem)) {\n\t\t\t\t\tproblems = problems.concat(problem)\n\t\t\t\t} else if (problem) {\n\t\t\t\t\tproblems.push(problem)\n\t\t\t\t}\n\t\t\t}\n    \t}\n    } else if (pattern && typeof pattern == 'object') {\n        if (Array.isArray(data)) {\n            let index = data.findIndex((element,index) => fails(element,pattern,root,path+'['+index+']'))\n            if (index>-1) {\n            \tproblems.push(error('data['+index+'] does not match pattern', data[index], pattern, path+'['+index+']'))\n            }\n        } else if (!data || typeof data != 'object') {\n        \tproblems.push(error('data is not an object, pattern is', data, pattern, path))\n        } else {\n        \tif (data instanceof URLSearchParams) {\n        \t\tdata = Object.fromEntries(data)\n        \t}\n        \tif (pattern instanceof Function) {\n        \t\tlet result = fails(data, pattern, root, path)\n\t            if (result) {\n\t            \tproblems = problems.concat(result)\n\t            }\n        \t} else {\n\t\t        for (const [patternKey, subpattern] of Object.entries(pattern)) {\n\t\t            let result = fails(data[patternKey], subpattern, root, path+'.'+patternKey)\n\t\t            if (result) {\n\t\t            \tproblems = problems.concat(result)\n\t\t            }\n\t\t        }\n\t\t    }\n\t    }\n    } else {\n    \tif (pattern!=data) {\n    \t\tproblems.push(error('data and pattern are not equal', data, pattern, path))\n    \t}\n    }\n    if (problems.length) {\n    \treturn problems\n    }\n    return false\n}\n\n/**\n * Returns an object with message, found and expected properties\n */ \nexport function error(message, found, expected, path, problems) {\n\tlet result = {\n\t\tpath,\n\t\tmessage,\n\t\tfound,\n\t\texpected\n\t}\n\tif (problems) {\n\t\tresult.problems = problems\n\t}\n\treturn result\n}\n\nexport function warn(message, data, pattern, path) {\n\tconsole.warn('\uD83C\uDD70\uFE0F  Assert: '+path, message, pattern, data)\n}\n\nglobalThis.assert = {\n\twarn,\n\terror,\n\tassert,\n\tenable,\n\tdisable,\n\tRequired,\n\tRecommended,\n\tOptional,\n\toneOf,\n\tanyOf,\n\tallOf,\n\tvalidURL,\n\tvalidEmail,\n\tinstanceOf,\n\tnot,\n\tfails\n}"],
+  "mappings": "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",
+  "names": ["enable", "disable", "assert", "source", "test", "problems", "fails", "Optional", "pattern", "data", "root", "path", "Required", "error", "Recommended", "warn", "oneOf", "patterns", "anyOf", "value", "allOf", "validURL", "url", "validEmail", "instanceOf", "constructor", "not", "index", "element", "problem", "p", "result", "patternKey", "subpattern", "message", "found", "expected"]
 }

package/package.json

@@ -1,15 +1,14 @@
 {
   "name": "@muze-nl/assert",
-  "version": "0.4.2",
+  "version": "0.5.1",
   "description": "light optional assert library",
   "type": "module",
-  "sideEffects": false,
   "main": "src/assert.mjs",
   "scripts": {
     "test": "tap test/*.mjs",
     "tap": "tap",
-    "build": "npx esbuild --bundle src/browser.mjs --outfile=dist/browser.min.js --minify --sourcemap",
-    "build-dev": "npx esbuild --bundle src/browser.mjs --outfile=dist/browser.js"
+    "build": "npx esbuild --bundle src/assert.mjs --outfile=dist/assert.min.js --minify --sourcemap",
+    "build-dev": "npx esbuild --bundle src/assert.mjs --outfile=dist/assert.js"
   },
   "repository": {
     "type": "git",

package/src/assert.mjs

@@ -306,4 +306,23 @@ export function error(message, found, expected, path, problems) {
 
 export function warn(message, data, pattern, path) {
 	console.warn('🅰️  Assert: '+path, message, pattern, data)
+}
+
+globalThis.assert = {
+	warn,
+	error,
+	assert,
+	enable,
+	disable,
+	Required,
+	Recommended,
+	Optional,
+	oneOf,
+	anyOf,
+	allOf,
+	validURL,
+	validEmail,
+	instanceOf,
+	not,
+	fails
 }

package/src/assert.mjs~

@@ -0,0 +1,309 @@
+/*
+TODO: add assertExplain global flag, so that if assert() fails, you can call explain() with
+  the same pattern and it will return text explanation of why it failed, each assertion function must 
+  then check assertExplain, and return a text explanation of what fails or succeeds
+  top level can then filter to show only the failures
+  (so that not(x) can show the succeeds message of x)
+*/
+
+/**
+ * assertEnabled (Boolean) used to toggle whether the assert()
+ * method should test assertions or not.
+ */
+globalThis.assertEnabled = false
+
+/**
+ * Enables assertion testing with assert()
+ */
+export function enable() {
+	globalThis.assertEnabled = true
+}
+
+/**
+ * Disables assertion testing with assert()
+ */
+export function disable() {
+	globalThis.assertEnabled = false
+}
+
+/**
+ * This function will check the source for the assertions in test, if
+ * assertion checking is enabled globally.
+ * If it is, and any assertion fails, it will throw an assertError
+ * with a list of problems and other details.
+ */
+export function assert(source, test) {
+	if (globalThis.assertEnabled) {
+		let problems = fails(source,test)
+		if (problems) {
+			console.error('🅰️  Assertions failed because of:', problems, 'in this source:', source)
+			throw new Error('Assertions failed', {
+				cause: { problems, source } 
+			})
+		}
+	}
+}
+
+/**
+ * Tests a given value against a pattern, only if the value is not null or undefined
+ */
+export function Optional(pattern) {
+	return function _Optional(data, root, path) {
+		if (typeof data != 'undefined' && data!=null && typeof pattern != 'undefined' ) {
+			return fails(data, pattern, root, path)
+		}
+	}
+}
+
+/**
+ * Tests a given value against a pattern, always.
+ */
+export function Required(pattern) {
+	return function _Required(data, root, path) {
+		if (data==null || typeof data == 'undefined') {
+			return error('data is required', data, pattern || 'any value', path)
+		} else if (typeof pattern != 'undefined') {
+			return fails(data, pattern, root, path)
+		} else {
+			return false
+		}
+	}
+}
+
+/**
+ * Tests a given value against a pattern, only if the value is not null or undefined
+ * If null or undefined, it does print a warning to the console.
+ */
+export function Recommended(pattern) {
+	return function _Recommended(data, root, path) {
+		if (data==null || typeof data == 'undefined') {
+			warn('data does not contain recommended value', data, pattern, path)
+			return false
+		} else {
+			return fails(data, pattern, root, path)
+		}
+	}
+}
+
+/**
+ * Tests a given value against a set of patterns, untill one succeeds
+ * Returns an error if none succeed
+ */
+export function oneOf(...patterns) { 
+	return function _oneOf(data, root, path) {
+		for(let pattern of patterns) {
+			if (!fails(data, pattern, root, path)) {
+				return false
+			}
+		}
+		return error('data does not match oneOf patterns', data, patterns, path)
+	}
+}
+
+/**
+ * Tests a given array of values against a set of patterns
+ * If any value does not match one of the patterns, it will return an error
+ * If not given an array to test, it will return an error
+ */
+export function anyOf(...patterns) {
+	return function _anyOf(data, root, path) {
+		if (!Array.isArray(data)) {
+			return error('data is not an array',data,'anyOf',path)
+		}
+		for (let value of data) {
+			if (oneOf(...patterns)(value)) {
+				return error('data does not match anyOf patterns',value,patterns,path)
+			}
+		}
+		return false
+	}
+}
+
+export function allOf(...patterns) {
+	return function _allOf(data, root, path) {
+		let problems = []
+		for (let pattern of patterns) {
+			problems = problems.concat(fails(data, pattern, root, path))
+		}
+		problems = problems.filter(Boolean)
+		if (problems.length) {
+			return error('data does not match all given patterns', data, patterns, path, problems)
+		}
+	}
+}
+
+/**
+ * Tests a given value to see if it is a valid (and absolute) URL, by
+ * parsing it with the URL() constructor, and then testing the href
+ * value to be equal to the initial value.
+ */
+export function validURL(data, root, path) {
+	try {
+		if (data instanceof URL) {
+			data = data.href
+		}
+		let url = new URL(data)
+		if (url.href!=data) {
+			if (!(url.href+'/'==data || url.href==data+'/')) {
+				// new URL() always adds a / as path
+				return error('data is not a valid url',data,'validURL',path)
+			}
+		}
+	} catch(e) {
+		return error('data is not a valid url',data,'validURL',path)
+	}
+}
+
+/**
+ * Tests a given value to see if it looks like a valid email address, by
+ * testing it against a regular expression. So there are no guarantees that
+ * it is an actual working email address, just that it looks like one.
+ */
+export function validEmail(data, root, path) {
+	if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(data)) {
+		return error('data is not a valid email',data,'validEmail',path)
+	}
+}
+
+/**
+ * Tests a given value to see if it is an object which is an instance of the given
+ * constructor
+ */
+export function instanceOf(constructor) {
+	return function _instanceOf(data, root, path) {
+		if (!(data instanceof constructor)) {
+			return error('data is not an instanceof pattern',data,constructor,path)
+		}
+	}
+}
+
+/**
+ * Runs the given test pattern on a value, if the test succeeds, it fails
+ * the not() test.
+ */
+export function not(pattern) {
+	return function _not(data, root, path) {
+		if (!fails(data, pattern, root, path)) {
+			return error('data matches pattern, when required not to', data, pattern, path)
+		}
+	}
+}
+
+/**
+ * returns an array of problems if the data fails to satisfy 
+ * the assertions in the given pattern, false otherwise
+ * @param {any} data    The data to match
+ * @param {any} pattern The pattern to match
+ * @param {any} root    Root object for assertions, set to data by default
+ * @return {Array|false} Array with problems if the pattern fails, false otherwise
+ */
+export function fails(data, pattern, root, path='') {
+	if (!root) {
+		root = data
+	}
+	let problems = []
+	if (pattern === Boolean) {
+		if (typeof data != 'boolean' && !(data instanceof Boolean)) {
+			problems.push(error('data is not a boolean', data, pattern, path))
+		}		
+	} else if (pattern === Number) {
+		if (typeof data != 'number' && !(data instanceof Number)) {
+			problems.push(error('data is not a number', data, pattern, path))
+		}
+	} else if (pattern === String) {
+		if (typeof data != 'string' && !(data instanceof String)) {
+			problems.push(error('data is not a string', data, pattern, path))
+		}
+		if (data == "") {
+			problems.push(error('data is an empty string, which is not allowed', data, pattern, path))
+		}
+	} else if (pattern instanceof RegExp) {
+    	if (Array.isArray(data)) {
+			let index = data.findIndex((element,index) => fails(element,pattern,root,path+'['+index+']'))
+            if (index>-1) {
+            	problems.push(error('data['+index+'] does not match pattern', data[index], pattern, path+'['+index+']'))
+            }
+        } else if (typeof data == 'undefined') {
+        	problems.push(error('data is undefined, should match pattern', data, pattern, path))
+    	} else if (!pattern.test(data)) {
+        	problems.push(error('data does not match pattern', data, pattern, path))
+        }
+    } else if (pattern instanceof Function) {
+        let problem = pattern(data, root, path)
+        if (problem) {
+        	if (Array.isArray(problem)) {
+        		problems = problems.concat(problem)
+        	} else {
+	        	problems.push(problem)
+	        }
+        }
+    } else if (Array.isArray(pattern)) {
+		if (!Array.isArray(data)) {
+			problems.push(error('data is not an array',data,[],path))
+		}
+		for (let p of pattern) {
+			for (let index of data.keys()) {
+				let problem = fails(data[index], p, root, path+'['+index+']')
+				if (Array.isArray(problem)) {
+					problems = problems.concat(problem)
+				} else if (problem) {
+					problems.push(problem)
+				}
+			}
+    	}
+    } else if (pattern && typeof pattern == 'object') {
+        if (Array.isArray(data)) {
+            let index = data.findIndex((element,index) => fails(element,pattern,root,path+'['+index+']'))
+            if (index>-1) {
+            	problems.push(error('data['+index+'] does not match pattern', data[index], pattern, path+'['+index+']'))
+            }
+        } else if (!data || typeof data != 'object') {
+        	problems.push(error('data is not an object, pattern is', data, pattern, path))
+        } else {
+        	if (data instanceof URLSearchParams) {
+        		data = Object.fromEntries(data)
+        	}
+        	if (pattern instanceof Function) {
+        		let result = fails(data, pattern, root, path)
+	            if (result) {
+	            	problems = problems.concat(result)
+	            }
+        	} else {
+		        for (const [patternKey, subpattern] of Object.entries(pattern)) {
+		            let result = fails(data[patternKey], subpattern, root, path+'.'+patternKey)
+		            if (result) {
+		            	problems = problems.concat(result)
+		            }
+		        }
+		    }
+	    }
+    } else {
+    	if (pattern!=data) {
+    		problems.push(error('data and pattern are not equal', data, pattern, path))
+    	}
+    }
+    if (problems.length) {
+    	return problems
+    }
+    return false
+}
+
+/**
+ * Returns an object with message, found and expected properties
+ */ 
+export function error(message, found, expected, path, problems) {
+	let result = {
+		path,
+		message,
+		found,
+		expected
+	}
+	if (problems) {
+		result.problems = problems
+	}
+	return result
+}
+
+export function warn(message, data, pattern, path) {
+	console.warn('🅰️  Assert: '+path, message, pattern, data)
+}

package/dist/browser.min.js

@@ -1,2 +0,0 @@
-(()=>{var b=Object.defineProperty;var x=(e,o)=>{for(var n in o)b(e,n,{get:o[n],enumerable:!0})};var c={};x(c,{Optional:()=>O,Recommended:()=>v,Required:()=>g,allOf:()=>a,anyOf:()=>R,assert:()=>A,disable:()=>h,enable:()=>d,error:()=>s,fails:()=>l,instanceOf:()=>w,not:()=>_,oneOf:()=>y,validEmail:()=>E,validURL:()=>p,warn:()=>m});globalThis.assertEnabled=!1;function d(){globalThis.assertEnabled=!0}function h(){globalThis.assertEnabled=!1}function A(e,o){if(globalThis.assertEnabled){let n=l(e,o);if(n)throw console.error("\u{1F170}\uFE0F  Assertions failed because of:",n,"in this source:",e),new Error("Assertions failed",{cause:{problems:n,source:e}})}}function O(e){return function(n,r,i){if(typeof n<"u"&&n!=null&&typeof e<"u")return l(n,e,r,i)}}function g(e){return function(n,r,i){return n==null||typeof n>"u"?s("data is required",n,e||"any value",i):typeof e<"u"?l(n,e,r,i):!1}}function v(e){return function(n,r,i){return n==null||typeof n>"u"?(m("data does not contain recommended value",n,e,i),!1):l(n,e,r,i)}}function y(...e){return function(n,r,i){for(let f of e)if(!l(n,f,r,i))return!1;return s("data does not match oneOf patterns",n,e,i)}}function R(...e){return function(n,r,i){if(!Array.isArray(n))return s("data is not an array",n,"anyOf",i);for(let f of n)if(y(...e)(f))return s("data does not match anyOf patterns",f,e,i);return!1}}function a(...e){return function(n,r,i){let f=[];for(let t of e)f=f.concat(l(n,t,r,i));if(f=f.filter(Boolean),f.length)return s("data does not match all given patterns",n,e,i,f)}}function p(e,o,n){try{e instanceof URL&&(e=e.href);let r=new URL(e);if(r.href!=e&&!(r.href+"/"==e||r.href==e+"/"))return s("data is not a valid url",e,"validURL",n)}catch{return s("data is not a valid url",e,"validURL",n)}}function E(e,o,n){if(!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(e))return s("data is not a valid email",e,"validEmail",n)}function w(e){return function(n,r,i){if(!(n instanceof e))return s("data is not an instanceof pattern",n,e,i)}}function _(e){return function(n,r,i){if(!l(n,e,r,i))return s("data matches pattern, when required not to",n,e,i)}}function l(e,o,n,r=""){n||(n=e);let i=[];if(o===Boolean)typeof e!="boolean"&&!(e instanceof Boolean)&&i.push(s("data is not a boolean",e,o,r));else if(o===Number)typeof e!="number"&&!(e instanceof Number)&&i.push(s("data is not a number",e,o,r));else if(o===String)typeof e!="string"&&!(e instanceof String)&&i.push(s("data is not a string",e,o,r)),e==""&&i.push(s("data is an empty string, which is not allowed",e,o,r));else if(o instanceof RegExp)if(Array.isArray(e)){let f=e.findIndex((t,u)=>l(t,o,n,r+"["+u+"]"));f>-1&&i.push(s("data["+f+"] does not match pattern",e[f],o,r+"["+f+"]"))}else typeof e>"u"?i.push(s("data is undefined, should match pattern",e,o,r)):o.test(e)||i.push(s("data does not match pattern",e,o,r));else if(o instanceof Function){let f=o(e,n,r);f&&(Array.isArray(f)?i=i.concat(f):i.push(f))}else if(Array.isArray(o)){Array.isArray(e)||i.push(s("data is not an array",e,[],r));for(let f of o)for(let t of e.keys()){let u=l(e[t],f,n,r+"["+t+"]");Array.isArray(u)?i=i.concat(u):u&&i.push(u)}}else if(o&&typeof o=="object")if(Array.isArray(e)){let f=e.findIndex((t,u)=>l(t,o,n,r+"["+u+"]"));f>-1&&i.push(s("data["+f+"] does not match pattern",e[f],o,r+"["+f+"]"))}else if(!e||typeof e!="object")i.push(s("data is not an object, pattern is",e,o,r));else if(e instanceof URLSearchParams&&(e=Object.fromEntries(e)),o instanceof Function){let f=l(e,o,n,r);f&&(i=i.concat(f))}else for(let[f,t]of Object.entries(o)){let u=l(e[f],t,n,r+"."+f);u&&(i=i.concat(u))}else o!=e&&i.push(s("data and pattern are not equal",e,o,r));return i.length?i:!1}function s(e,o,n,r,i){let f={path:r,message:e,found:o,expected:n};return i&&(f.problems=i),f}function m(e,o,n,r){console.warn("\u{1F170}\uFE0F  Assert: "+r,e,n,o)}globalThis.assert=c;})();
-//# sourceMappingURL=browser.min.js.map

package/src/browser.mjs

@@ -1,3 +0,0 @@
-import * as assert from './assert.mjs'
-
-globalThis.assert = assert