@joystick.js/test-canary 0.0.0-canary.3 → 0.0.0-canary.31

package/.build/index.js

@@ -10,7 +10,7 @@ const buildFile = (fileToBuild) => {
   return esbuild
     .build({
       entryPoints: [`src/${file}`],
-      bundle: true,
+      bundle: false,
       outfile: `./dist/${file}`,
       platform: "node",
       format: "esm",

package/_package.json

@@ -13,5 +13,15 @@
   },
   "keywords": [],
   "author": "",
-  "license": "SAUCR"
+  "license": "SAUCR",
+  "dependencies": {
+    "ava": "^5.3.1",
+    "chalk": "^5.3.0",
+    "dayjs": "^1.11.9",
+    "esbuild": "^0.18.17",
+    "linkedom": "^0.15.1",
+    "mongo-uri-tool": "^1.0.1",
+    "mongodb": "^5.7.0",
+    "pg": "^8.11.2"
+  }
 }

package/dist/helpers/component/event.js

@@ -0,0 +1 @@
+var o=(e="",t="",n={})=>{const p=n?.document?.querySelector("#app")?.querySelector(t),r=new Event(e);return p.dispatchEvent(r),!0};export{o as default};

package/dist/helpers/component/index.js

@@ -1 +1 @@
-var e={};export{e as default};
+import{parseHTML as a}from"linkedom";import c from"@joystick.js/ui-canary";import s from"./event.js";import d from"../load/index.js";const p=()=>{const o=a('<div id="app"></div>'),{window:t,document:e,Element:n,Event:r,HTMLElement:l}=o;return global.window=t,global.document=e,global.HTMLElement=l,global.Element=n,global.Event=r,global.console={log:console.log,warn:console.warn,error:console.error},o};var b=async(o="",t={})=>{const e=p();window.joystick={};const n=await d(o,{default:!0}),r=c.mount(n,t?.props||{},document.querySelector("#app"));return{...e,component:r,test:{event:(l="",m="")=>s(l,m,e)}}};export{b as default};

package/dist/helpers/databases/index.js

@@ -1 +1 @@
-var e={};export{e as default};
+import n from"../../lib/loadSettings.js";import p from"./mongodb/index.js";import i from"./postgresql/index.js";var l=async()=>{const r=(await n({environment:"test"}))?.parsed?.config?.databases?.map(e=>({provider:e?.provider,settings:e}));for(let e=0;e<r?.length;e+=1){const t=r[e],a=r?.filter(s=>s?.provider===s?.provider)?.length>1,o=parseInt(process.env.PORT,10)+10+e;if(t?.provider==="mongodb"){const s=await p(t?.settings,o);process.databases={...process.databases||{},mongodb:a?{...process?.databases?.mongodb||{},[t?.settings?.name||`mongodb_${o}`]:s}:s}}if(t?.provider==="postgresql"){const s=await i(t?.settings,o);process.databases={...process.databases||{},postgresql:a?{...process?.databases?.postgresql||{},[t?.settings?.name||`postgresql_${o}`]:{...s?.pool,query:s?.query}}:{...s?.pool,query:s?.query}}}}return process.databases};export{l as default};

package/dist/helpers/databases/mongodb/availableQueryParameters.js

@@ -0,0 +1 @@
+var e=["replicaSet","tls","ssl","tlsCertificateKeyFile","tlsCertificateKeyFilePassword","tlsCAFile","tlsAllowInvalidCertificates","tlsAllowInvalidHostnames","tlsInsecure","connectTimeoutMS","socketTimeoutMS","compressors","zlibCompressionLevel","maxPoolSize","minPoolSize","maxIdleTimeMS","waitQueueMultiple","waitQueueTimeoutMS","w","wtimeoutMS","journal","readConcernLevel","readPreference","maxStalenessSeconds","readPreferenceTags","authSource","authMechanism","authMechanismProperties","gssapiServiceName","localThresholdMS","serverSelectionTimeoutMS","serverSelectionTryOnce","heartbeatFrequencyMS","appName","retryReads","retryWrites","uuidRepresentation"];export{e as default};

package/dist/helpers/databases/mongodb/buildConnectionString.js

@@ -0,0 +1 @@
+import m from"./buildQueryParameters.js";import $ from"../../../lib/serializeQueryParameters.js";var p=(r={})=>{let s="mongodb://";r&&(r.username||r.password)&&(s=`${s}${r.username||r.password?`${r.username||""}${r.username&&r.password?":":""}${r.password||""}@`:""}`),r&&r.hosts&&Array.isArray(r.hosts)&&(s=`${s}${r.hosts.map(e=>`${e.hostname}:${e.port}`).join(",")}`),r&&r.database&&(s=`${s}/${r.database}`);const a=m(r);return Object.keys(a)?.length>0&&(s=`${s}?${$(a)}`),s};export{p as default};

package/dist/helpers/databases/mongodb/buildQueryParameters.js

@@ -0,0 +1 @@
+import l from"./availableQueryParameters.js";var f=(r={})=>{const t={};for(let a=0;a<l.length;a+=1){const e=l[a];r&&r[e]&&(t[e]=r[e])}return t};export{f as default};

package/dist/helpers/databases/mongodb/index.js

@@ -0,0 +1,6 @@
+import{MongoClient as s}from"mongodb";import c from"chalk";import a from"mongo-uri-tool";import p from"fs";import l from"./buildConnectionString.js";var b=async(o={},e=2610)=>{const r=o?.connection||{hosts:[{hostname:"127.0.0.1",port:e}],database:"app",replicaSet:`joystick_${e}`},t=l(r),i=a.parseUri(t);try{const n={useNewUrlParser:!0,useUnifiedTopology:!0,ssl:!["development","test"].includes(process.env.NODE_ENV),...o?.options||{}};return o?.options?.ca&&(n.ca=p.readFileSync(o?.options?.ca)),(await s.connect(t,n)).db(i.db)}catch(n){console.warn(c.yellowBright(`
+Failed to connect to MongoDB. Please double-check connection settings and try again.
+
+Error from MongoDB:
+
+${c.redBright(n?.message)}`))}};export{b as default};

package/dist/helpers/databases/postgresql/addColumnToTable.js

@@ -0,0 +1 @@
+var a=(e="",r="",s="")=>process.databases._users?.query(`ALTER TABLE ${e} ADD COLUMN ${r} ${s}`);export{a as default};

package/dist/helpers/databases/postgresql/createAccountsIndexes.js

@@ -0,0 +1 @@
+const a=async(s="",r="",_=[])=>process.databases._users?.query(`CREATE UNIQUE INDEX IF NOT EXISTS ${s} ON ${r}(${_.join(", ")})`),e=async(s="",r="",_=[])=>process.databases._users?.query(`CREATE INDEX IF NOT EXISTS ${s} ON ${r}(${_.join(", ")})`);var o=async()=>{await e("user_by_email","users",["email_address"]),await e("user_by_username","users",["username"]),await e("user_by_user_id","users",["user_id"]),await e("user_session_by_token","users_sessions",["token"]),await e("user_password_reset_token_by_token","users_password_reset_tokens",["token"]),await e("user_password_reset_token_by_user_id_token","users_password_reset_tokens",["user_id","token"]),await e("user_role","users_roles",["role"]),await e("user_roles_by_user_id_role","users_roles",["user_id","role"]),await e("role","roles",["role"]),await a("user_roles","users_roles",["user_id","role"])};export{o as default};

package/dist/helpers/databases/postgresql/createAccountsTables.js

@@ -0,0 +1 @@
+const e=async(t="",s=[])=>process.databases._users?.query(`CREATE TABLE IF NOT EXISTS ${t} (${s.join(", ")})`);var r=async()=>{await e("users",["id bigserial primary key","user_id text","email_address text","password text","username text","language text"]),await e("users_sessions",["id bigserial primary key","user_id text","token text","token_expires_at text"]),await e("users_password_reset_tokens",["id bigserial primary key","user_id text","token text","requested_at text"]),await e("users_verify_email_tokens",["id bigserial primary key","user_id text","token text"]),await e("roles",["id bigserial primary key","role text"]),await e("users_roles",["id bigserial primary key","user_id text","role text"])};export{r as default};

package/dist/helpers/databases/postgresql/index.js

@@ -0,0 +1,11 @@
+import l from"pg";import n from"chalk";import h from"os";const{Pool:i}=l;var u=async(r={},c=2610)=>{const o=r?.connection||{hosts:[{hostname:"127.0.0.1",port:c}],database:"app",username:(h.userInfo()||{}).username||"",password:""};try{const e=o.hosts&&o.hosts[0],a=new i({user:o?.username||"",database:o?.database,password:o?.password||"",host:e?.hostname,port:e?.port,...r?.options||{}});return{pool:a,query:(...t)=>a.query(...t).then(s=>s?.rows||[]).catch(s=>{throw console.log(n.redBright(`
+Failed SQL Statement:
+`)),console.log(t[0]),console.log(`
+`),console.log(n.redBright(`
+Failed Values:
+`)),console.log(t[1]),s})}}catch(e){console.warn(n.yellowBright(`
+Failed to connect to PostgreSQL. Please double-check connection settings and try again.
+
+Error from PostgreSQL:
+
+${n.redBright(e?.message)}`))}};export{u as default};

package/dist/helpers/load/index.js

@@ -1,17 +1 @@
-import J from"fs";var E=(r=0)=>e=>`\x1B[${e+r}m`,x=(r=0)=>e=>`\x1B[${38+r};5;${e}m`,v=(r=0)=>(e,t,o)=>`\x1B[${38+r};2;${e};${t};${o}m`,s={modifier:{reset:[0,0],bold:[1,22],dim:[2,22],italic:[3,23],underline:[4,24],overline:[53,55],inverse:[7,27],hidden:[8,28],strikethrough:[9,29]},color:{black:[30,39],red:[31,39],green:[32,39],yellow:[33,39],blue:[34,39],magenta:[35,39],cyan:[36,39],white:[37,39],blackBright:[90,39],gray:[90,39],grey:[90,39],redBright:[91,39],greenBright:[92,39],yellowBright:[93,39],blueBright:[94,39],magentaBright:[95,39],cyanBright:[96,39],whiteBright:[97,39]},bgColor:{bgBlack:[40,49],bgRed:[41,49],bgGreen:[42,49],bgYellow:[43,49],bgBlue:[44,49],bgMagenta:[45,49],bgCyan:[46,49],bgWhite:[47,49],bgBlackBright:[100,49],bgGray:[100,49],bgGrey:[100,49],bgRedBright:[101,49],bgGreenBright:[102,49],bgYellowBright:[103,49],bgBlueBright:[104,49],bgMagentaBright:[105,49],bgCyanBright:[106,49],bgWhiteBright:[107,49]}},X=Object.keys(s.modifier),_=Object.keys(s.color),j=Object.keys(s.bgColor),Z=[..._,...j];function P(){let r=new Map;for(let[e,t]of Object.entries(s)){for(let[o,n]of Object.entries(t))s[o]={open:`\x1B[${n[0]}m`,close:`\x1B[${n[1]}m`},t[o]=s[o],r.set(n[0],n[1]);Object.defineProperty(s,e,{value:t,enumerable:!1})}return Object.defineProperty(s,"codes",{value:r,enumerable:!1}),s.color.close="\x1B[39m",s.bgColor.close="\x1B[49m",s.color.ansi=E(),s.color.ansi256=x(),s.color.ansi16m=v(),s.bgColor.ansi=E(10),s.bgColor.ansi256=x(10),s.bgColor.ansi16m=v(10),Object.defineProperties(s,{rgbToAnsi256:{value(e,t,o){return e===t&&t===o?e<8?16:e>248?231:Math.round((e-8)/247*24)+232:16+36*Math.round(e/255*5)+6*Math.round(t/255*5)+Math.round(o/255*5)},enumerable:!1},hexToRgb:{value(e){let t=/[a-f\d]{6}|[a-f\d]{3}/i.exec(e.toString(16));if(!t)return[0,0,0];let[o]=t;o.length===3&&(o=[...o].map(l=>l+l).join(""));let n=Number.parseInt(o,16);return[n>>16&255,n>>8&255,n&255]},enumerable:!1},hexToAnsi256:{value:e=>s.rgbToAnsi256(...s.hexToRgb(e)),enumerable:!1},ansi256ToAnsi:{value(e){if(e<8)return 30+e;if(e<16)return 90+(e-8);let t,o,n;if(e>=232)t=((e-232)*10+8)/255,o=t,n=t;else{e-=16;let h=e%36;t=Math.floor(e/36)/5,o=Math.floor(h/6)/5,n=h%6/5}let l=Math.max(t,o,n)*2;if(l===0)return 30;let c=30+(Math.round(n)<<2|Math.round(o)<<1|Math.round(t));return l===2&&(c+=60),c},enumerable:!1},rgbToAnsi:{value:(e,t,o)=>s.ansi256ToAnsi(s.rgbToAnsi256(e,t,o)),enumerable:!1},hexToAnsi:{value:e=>s.ansi256ToAnsi(s.hexToAnsi256(e)),enumerable:!1}}),s}var L=P(),f=L;import T from"node:process";import G from"node:os";import $ from"node:tty";function u(r,e=globalThis.Deno?globalThis.Deno.args:T.argv){let t=r.startsWith("-")?"":r.length===1?"-":"--",o=e.indexOf(t+r),n=e.indexOf("--");return o!==-1&&(n===-1||o<n)}var{env:i}=T,p;u("no-color")||u("no-colors")||u("color=false")||u("color=never")?p=0:(u("color")||u("colors")||u("color=true")||u("color=always"))&&(p=1);function Y(){if("FORCE_COLOR"in i)return i.FORCE_COLOR==="true"?1:i.FORCE_COLOR==="false"?0:i.FORCE_COLOR.length===0?1:Math.min(Number.parseInt(i.FORCE_COLOR,10),3)}function D(r){return r===0?!1:{level:r,hasBasic:!0,has256:r>=2,has16m:r>=3}}function U(r,{streamIsTTY:e,sniffFlags:t=!0}={}){let o=Y();o!==void 0&&(p=o);let n=t?p:o;if(n===0)return 0;if(t){if(u("color=16m")||u("color=full")||u("color=truecolor"))return 3;if(u("color=256"))return 2}if("TF_BUILD"in i&&"AGENT_NAME"in i)return 1;if(r&&!e&&n===void 0)return 0;let l=n||0;if(i.TERM==="dumb")return l;if(T.platform==="win32"){let c=G.release().split(".");return Number(c[0])>=10&&Number(c[2])>=10586?Number(c[2])>=14931?3:2:1}if("CI"in i)return"GITHUB_ACTIONS"in i||"GITEA_ACTIONS"in i?3:["TRAVIS","CIRCLECI","APPVEYOR","GITLAB_CI","BUILDKITE","DRONE"].some(c=>c in i)||i.CI_NAME==="codeship"?1:l;if("TEAMCITY_VERSION"in i)return/^(9\.(0*[1-9]\d*)\.|\d{2,}\.)/.test(i.TEAMCITY_VERSION)?1:0;if(i.COLORTERM==="truecolor"||i.TERM==="xterm-kitty")return 3;if("TERM_PROGRAM"in i){let c=Number.parseInt((i.TERM_PROGRAM_VERSION||"").split(".")[0],10);switch(i.TERM_PROGRAM){case"iTerm.app":return c>=3?3:2;case"Apple_Terminal":return 2}}return/-256(color)?$/i.test(i.TERM)?2:/^screen|^xterm|^vt100|^vt220|^rxvt|color|ansi|cygwin|linux/i.test(i.TERM)||"COLORTERM"in i?1:l}function N(r,e={}){let t=U(r,{streamIsTTY:r&&r.isTTY,...e});return D(t)}var V={stdout:N({isTTY:$.isatty(1)}),stderr:N({isTTY:$.isatty(2)})},B=V;function I(r,e,t){let o=r.indexOf(e);if(o===-1)return r;let n=e.length,l=0,c="";do c+=r.slice(l,o)+e+t,l=o+n,o=r.indexOf(e,l);while(o!==-1);return c+=r.slice(l),c}function M(r,e,t,o){let n=0,l="";do{let c=r[o-1]==="\r";l+=r.slice(n,c?o-1:o)+e+(c?`\r
-`:`
-`)+t,n=o+1,o=r.indexOf(`
-`,n)}while(o!==-1);return l+=r.slice(n),l}var{stdout:S,stderr:F}=B,C=Symbol("GENERATOR"),d=Symbol("STYLER"),b=Symbol("IS_EMPTY"),w=["ansi","ansi","ansi256","ansi16m"],g=Object.create(null),W=(r,e={})=>{if(e.level&&!(Number.isInteger(e.level)&&e.level>=0&&e.level<=3))throw new Error("The `level` option should be an integer from 0 to 3");let t=S?S.level:0;r.level=e.level===void 0?t:e.level};var K=r=>{let e=(...t)=>t.join(" ");return W(e,r),Object.setPrototypeOf(e,m.prototype),e};function m(r){return K(r)}Object.setPrototypeOf(m.prototype,Function.prototype);for(let[r,e]of Object.entries(f))g[r]={get(){let t=O(this,R(e.open,e.close,this[d]),this[b]);return Object.defineProperty(this,r,{value:t}),t}};g.visible={get(){let r=O(this,this[d],!0);return Object.defineProperty(this,"visible",{value:r}),r}};var y=(r,e,t,...o)=>r==="rgb"?e==="ansi16m"?f[t].ansi16m(...o):e==="ansi256"?f[t].ansi256(f.rgbToAnsi256(...o)):f[t].ansi(f.rgbToAnsi(...o)):r==="hex"?y("rgb",e,t,...f.hexToRgb(...o)):f[t][r](...o),z=["rgb","hex","ansi256"];for(let r of z){g[r]={get(){let{level:t}=this;return function(...o){let n=R(y(r,w[t],"color",...o),f.color.close,this[d]);return O(this,n,this[b])}}};let e="bg"+r[0].toUpperCase()+r.slice(1);g[e]={get(){let{level:t}=this;return function(...o){let n=R(y(r,w[t],"bgColor",...o),f.bgColor.close,this[d]);return O(this,n,this[b])}}}}var H=Object.defineProperties(()=>{},{...g,level:{enumerable:!0,get(){return this[C].level},set(r){this[C].level=r}}}),R=(r,e,t)=>{let o,n;return t===void 0?(o=r,n=e):(o=t.openAll+r,n=e+t.closeAll),{open:r,close:e,openAll:o,closeAll:n,parent:t}},O=(r,e,t)=>{let o=(...n)=>Q(o,n.length===1?""+n[0]:n.join(" "));return Object.setPrototypeOf(o,H),o[C]=r,o[d]=e,o[b]=t,o},Q=(r,e)=>{if(r.level<=0||!e)return r[b]?"":e;let t=r[d];if(t===void 0)return e;let{openAll:o,closeAll:n}=t;if(e.includes("\x1B"))for(;t!==void 0;)e=I(e,t.close,t.open),t=t.parent;let l=e.indexOf(`
-`);return l!==-1&&(e=M(e,n,o,l)),o+e+n};Object.defineProperties(m.prototype,g);var q=m(),ae=m({level:F?F.level:0});var a=q;var A=()=>`${a.red("=")}${a.green("=")}${a.blue("=")}${a.red("=")}${a.green("=")}${a.blue("=")}`;var k=(r="",e={})=>{let t={info:"blue",success:"green",warning:"yellowBright",danger:"red"},o={info:"\u2771 Info",success:"\u2771 Ok",warning:"\u2771 Warning",danger:"\u2771 Error"},n=e.level?t[e.level]:"gray",l=e.level?o[e.level]:"Log",c=e.docs||"https://cheatcode.co/docs/joystick";console.log(`
-${e.padding||""}${A()}
-`),console.log(`${e.padding||""}${a[n](`${l}:`)}
-`),console.log(`${e.padding||""}${a.white(r)}
-`),console.log(`${e.padding||""}${a.grey("---")}
-`),console.log(`${e.padding||""}${a.white("Relevant Documentation:")}
-`),console.log(`${e.padding||""}${a.blue(c)}
-`),console.log(`${e.padding||""}${a.white("Stuck? Ask a Question:")}
-`),console.log(`${e.padding||""}${a.blue("https://github.com/cheatcode/joystick/discussions")}
-`),e.tools&&Array.isArray(e.tools)&&(console.log(`${e.padding||""}${a.white("Helpful Tools:")}
-`),e.tools.forEach(h=>{console.log(`${e.padding||""}${a.blue(`${h.title} \u2014 ${h.url}`)}
-`)})),console.log(`${e.padding||""}${A()}
-`)};var Oe=async(r="",e={})=>{let o=`.joystick/build/${r?.charAt(0)==="/"?r.substring(1,r.length):r}`;if(!J.existsSync(o))return k(`[test.load] Path at ${o} not found.`,{level:"warning",docs:"https://cheatcode.co/docs/joystick/test/load"}),null;let l=await import(o);return l?.default&&e?.default?l.default:l};export{Oe as default};
+import n from"fs";import a from"../../lib/CLILog.js";const c=async(o="",s={})=>{const t=await import(`${o}?update=${Date.now()}`);return t?.default&&s?.default?t.default:t};var u=async(o="",s={})=>{const e=o?.charAt(0)==="/"?o.substring(1,o.length):o,t=`${process.cwd()}/.joystick/build/${e}`;return n.existsSync(t)?c(t,s):(a(`[test.load] Path at ${t} not found.`,{level:"warning",docs:"https://cheatcode.co/docs/joystick/test/load"}),null)};export{u as default};

package/dist/helpers/queues/index.js

@@ -1 +1 @@
-var e={};export{e as default};
+var u={job:(e="",o={})=>{}};export{u as default};

package/dist/index.js

@@ -1,20 +1 @@
-var se=Object.create;var M=Object.defineProperty;var ie=Object.getOwnPropertyDescriptor;var ae=Object.getOwnPropertyNames;var ce=Object.getPrototypeOf,ue=Object.prototype.hasOwnProperty;var m=(r=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(r,{get:(e,t)=>(typeof require<"u"?require:e)[t]}):r)(function(r){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+r+'" is not supported')});var C=(r,e)=>()=>(e||r((e={exports:{}}).exports,e),e.exports);var fe=(r,e,t,o)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of ae(e))!ue.call(r,n)&&n!==t&&M(r,n,{get:()=>e[n],enumerable:!(o=ie(e,n))||o.enumerable});return r};var de=(r,e,t)=>(t=r!=null?se(ce(r)):{},fe(e||!r||!r.__esModule?M(t,"default",{value:r,enumerable:!0}):t,r));var w=C(y=>{"use strict";var ge=m("node:process"),{isMainThread:he}=m("node:worker_threads");y.isRunningInThread=he===!1;y.isRunningInChildProcess=typeof ge.send=="function"});var S=C(()=>{"use strict";var me=m("node:path"),x=m("node:process"),{isRunningInThread:pe,isRunningInChildProcess:be}=w();if(!be&&!pe)if(x.argv[1]){let r=me.relative(".",x.argv[1]);console.log(),console.error(`Test files must be run with the AVA CLI:
-
-    $ ava ${r}
-`),x.exit(1)}else throw new Error("The \u2019ava\u2019 module can only be imported in test files")});var F=C(p=>{"use strict";p.flags={loadedMain:!1};p.refs={runnerChain:null};p.sharedWorkerTeardowns=[];p.waitForReady=[]});var j=C((Ye,_)=>{"use strict";S();var Oe=m("node:assert"),{flags:Ce,refs:k}=F();Oe(k.runnerChain);Ce.loadedMain=!0;_.exports=k.runnerChain});var A=de(j(),1);var v=class{constructor(){}that(e="",t=null){return(0,A.default)(e,t)}},P=new v;var L={};var G={};var Y={};var D={};var q={};import ke from"fs";var U=(r=0)=>e=>`\x1B[${e+r}m`,V=(r=0)=>e=>`\x1B[${38+r};5;${e}m`,W=(r=0)=>(e,t,o)=>`\x1B[${38+r};2;${e};${t};${o}m`,s={modifier:{reset:[0,0],bold:[1,22],dim:[2,22],italic:[3,23],underline:[4,24],overline:[53,55],inverse:[7,27],hidden:[8,28],strikethrough:[9,29]},color:{black:[30,39],red:[31,39],green:[32,39],yellow:[33,39],blue:[34,39],magenta:[35,39],cyan:[36,39],white:[37,39],blackBright:[90,39],gray:[90,39],grey:[90,39],redBright:[91,39],greenBright:[92,39],yellowBright:[93,39],blueBright:[94,39],magentaBright:[95,39],cyanBright:[96,39],whiteBright:[97,39]},bgColor:{bgBlack:[40,49],bgRed:[41,49],bgGreen:[42,49],bgYellow:[43,49],bgBlue:[44,49],bgMagenta:[45,49],bgCyan:[46,49],bgWhite:[47,49],bgBlackBright:[100,49],bgGray:[100,49],bgGrey:[100,49],bgRedBright:[101,49],bgGreenBright:[102,49],bgYellowBright:[103,49],bgBlueBright:[104,49],bgMagentaBright:[105,49],bgCyanBright:[106,49],bgWhiteBright:[107,49]}},Qe=Object.keys(s.modifier),Te=Object.keys(s.color),Re=Object.keys(s.bgColor),Je=[...Te,...Re];function ye(){let r=new Map;for(let[e,t]of Object.entries(s)){for(let[o,n]of Object.entries(t))s[o]={open:`\x1B[${n[0]}m`,close:`\x1B[${n[1]}m`},t[o]=s[o],r.set(n[0],n[1]);Object.defineProperty(s,e,{value:t,enumerable:!1})}return Object.defineProperty(s,"codes",{value:r,enumerable:!1}),s.color.close="\x1B[39m",s.bgColor.close="\x1B[49m",s.color.ansi=U(),s.color.ansi256=V(),s.color.ansi16m=W(),s.bgColor.ansi=U(10),s.bgColor.ansi256=V(10),s.bgColor.ansi16m=W(10),Object.defineProperties(s,{rgbToAnsi256:{value(e,t,o){return e===t&&t===o?e<8?16:e>248?231:Math.round((e-8)/247*24)+232:16+36*Math.round(e/255*5)+6*Math.round(t/255*5)+Math.round(o/255*5)},enumerable:!1},hexToRgb:{value(e){let t=/[a-f\d]{6}|[a-f\d]{3}/i.exec(e.toString(16));if(!t)return[0,0,0];let[o]=t;o.length===3&&(o=[...o].map(l=>l+l).join(""));let n=Number.parseInt(o,16);return[n>>16&255,n>>8&255,n&255]},enumerable:!1},hexToAnsi256:{value:e=>s.rgbToAnsi256(...s.hexToRgb(e)),enumerable:!1},ansi256ToAnsi:{value(e){if(e<8)return 30+e;if(e<16)return 90+(e-8);let t,o,n;if(e>=232)t=((e-232)*10+8)/255,o=t,n=t;else{e-=16;let h=e%36;t=Math.floor(e/36)/5,o=Math.floor(h/6)/5,n=h%6/5}let l=Math.max(t,o,n)*2;if(l===0)return 30;let a=30+(Math.round(n)<<2|Math.round(o)<<1|Math.round(t));return l===2&&(a+=60),a},enumerable:!1},rgbToAnsi:{value:(e,t,o)=>s.ansi256ToAnsi(s.rgbToAnsi256(e,t,o)),enumerable:!1},hexToAnsi:{value:e=>s.ansi256ToAnsi(s.hexToAnsi256(e)),enumerable:!1}}),s}var xe=ye(),f=xe;import E from"node:process";import Ae from"node:os";import K from"node:tty";function u(r,e=globalThis.Deno?globalThis.Deno.args:E.argv){let t=r.startsWith("-")?"":r.length===1?"-":"--",o=e.indexOf(t+r),n=e.indexOf("--");return o!==-1&&(n===-1||o<n)}var{env:i}=E,T;u("no-color")||u("no-colors")||u("color=false")||u("color=never")?T=0:(u("color")||u("colors")||u("color=true")||u("color=always"))&&(T=1);function ve(){if("FORCE_COLOR"in i)return i.FORCE_COLOR==="true"?1:i.FORCE_COLOR==="false"?0:i.FORCE_COLOR.length===0?1:Math.min(Number.parseInt(i.FORCE_COLOR,10),3)}function Ee(r){return r===0?!1:{level:r,hasBasic:!0,has256:r>=2,has16m:r>=3}}function $e(r,{streamIsTTY:e,sniffFlags:t=!0}={}){let o=ve();o!==void 0&&(T=o);let n=t?T:o;if(n===0)return 0;if(t){if(u("color=16m")||u("color=full")||u("color=truecolor"))return 3;if(u("color=256"))return 2}if("TF_BUILD"in i&&"AGENT_NAME"in i)return 1;if(r&&!e&&n===void 0)return 0;let l=n||0;if(i.TERM==="dumb")return l;if(E.platform==="win32"){let a=Ae.release().split(".");return Number(a[0])>=10&&Number(a[2])>=10586?Number(a[2])>=14931?3:2:1}if("CI"in i)return"GITHUB_ACTIONS"in i||"GITEA_ACTIONS"in i?3:["TRAVIS","CIRCLECI","APPVEYOR","GITLAB_CI","BUILDKITE","DRONE"].some(a=>a in i)||i.CI_NAME==="codeship"?1:l;if("TEAMCITY_VERSION"in i)return/^(9\.(0*[1-9]\d*)\.|\d{2,}\.)/.test(i.TEAMCITY_VERSION)?1:0;if(i.COLORTERM==="truecolor"||i.TERM==="xterm-kitty")return 3;if("TERM_PROGRAM"in i){let a=Number.parseInt((i.TERM_PROGRAM_VERSION||"").split(".")[0],10);switch(i.TERM_PROGRAM){case"iTerm.app":return a>=3?3:2;case"Apple_Terminal":return 2}}return/-256(color)?$/i.test(i.TERM)?2:/^screen|^xterm|^vt100|^vt220|^rxvt|color|ansi|cygwin|linux/i.test(i.TERM)||"COLORTERM"in i?1:l}function z(r,e={}){let t=$e(r,{streamIsTTY:r&&r.isTTY,...e});return Ee(t)}var Ie={stdout:z({isTTY:K.isatty(1)}),stderr:z({isTTY:K.isatty(2)})},H=Ie;function Q(r,e,t){let o=r.indexOf(e);if(o===-1)return r;let n=e.length,l=0,a="";do a+=r.slice(l,o)+e+t,l=o+n,o=r.indexOf(e,l);while(o!==-1);return a+=r.slice(l),a}function J(r,e,t,o){let n=0,l="";do{let a=r[o-1]==="\r";l+=r.slice(n,a?o-1:o)+e+(a?`\r
-`:`
-`)+t,n=o+1,o=r.indexOf(`
-`,n)}while(o!==-1);return l+=r.slice(n),l}var{stdout:X,stderr:Z}=H,$=Symbol("GENERATOR"),d=Symbol("STYLER"),b=Symbol("IS_EMPTY"),ee=["ansi","ansi","ansi256","ansi16m"],g=Object.create(null),Ne=(r,e={})=>{if(e.level&&!(Number.isInteger(e.level)&&e.level>=0&&e.level<=3))throw new Error("The `level` option should be an integer from 0 to 3");let t=X?X.level:0;r.level=e.level===void 0?t:e.level};var Be=r=>{let e=(...t)=>t.join(" ");return Ne(e,r),Object.setPrototypeOf(e,O.prototype),e};function O(r){return Be(r)}Object.setPrototypeOf(O.prototype,Function.prototype);for(let[r,e]of Object.entries(f))g[r]={get(){let t=R(this,N(e.open,e.close,this[d]),this[b]);return Object.defineProperty(this,r,{value:t}),t}};g.visible={get(){let r=R(this,this[d],!0);return Object.defineProperty(this,"visible",{value:r}),r}};var I=(r,e,t,...o)=>r==="rgb"?e==="ansi16m"?f[t].ansi16m(...o):e==="ansi256"?f[t].ansi256(f.rgbToAnsi256(...o)):f[t].ansi(f.rgbToAnsi(...o)):r==="hex"?I("rgb",e,t,...f.hexToRgb(...o)):f[t][r](...o),Me=["rgb","hex","ansi256"];for(let r of Me){g[r]={get(){let{level:t}=this;return function(...o){let n=N(I(r,ee[t],"color",...o),f.color.close,this[d]);return R(this,n,this[b])}}};let e="bg"+r[0].toUpperCase()+r.slice(1);g[e]={get(){let{level:t}=this;return function(...o){let n=N(I(r,ee[t],"bgColor",...o),f.bgColor.close,this[d]);return R(this,n,this[b])}}}}var we=Object.defineProperties(()=>{},{...g,level:{enumerable:!0,get(){return this[$].level},set(r){this[$].level=r}}}),N=(r,e,t)=>{let o,n;return t===void 0?(o=r,n=e):(o=t.openAll+r,n=e+t.closeAll),{open:r,close:e,openAll:o,closeAll:n,parent:t}},R=(r,e,t)=>{let o=(...n)=>Se(o,n.length===1?""+n[0]:n.join(" "));return Object.setPrototypeOf(o,we),o[$]=r,o[d]=e,o[b]=t,o},Se=(r,e)=>{if(r.level<=0||!e)return r[b]?"":e;let t=r[d];if(t===void 0)return e;let{openAll:o,closeAll:n}=t;if(e.includes("\x1B"))for(;t!==void 0;)e=Q(e,t.close,t.open),t=t.parent;let l=e.indexOf(`
-`);return l!==-1&&(e=J(e,n,o,l)),o+e+n};Object.defineProperties(O.prototype,g);var Fe=O(),ir=O({level:Z?Z.level:0});var c=Fe;var B=()=>`${c.red("=")}${c.green("=")}${c.blue("=")}${c.red("=")}${c.green("=")}${c.blue("=")}`;var re=(r="",e={})=>{let t={info:"blue",success:"green",warning:"yellowBright",danger:"red"},o={info:"\u2771 Info",success:"\u2771 Ok",warning:"\u2771 Warning",danger:"\u2771 Error"},n=e.level?t[e.level]:"gray",l=e.level?o[e.level]:"Log",a=e.docs||"https://cheatcode.co/docs/joystick";console.log(`
-${e.padding||""}${B()}
-`),console.log(`${e.padding||""}${c[n](`${l}:`)}
-`),console.log(`${e.padding||""}${c.white(r)}
-`),console.log(`${e.padding||""}${c.grey("---")}
-`),console.log(`${e.padding||""}${c.white("Relevant Documentation:")}
-`),console.log(`${e.padding||""}${c.blue(a)}
-`),console.log(`${e.padding||""}${c.white("Stuck? Ask a Question:")}
-`),console.log(`${e.padding||""}${c.blue("https://github.com/cheatcode/joystick/discussions")}
-`),e.tools&&Array.isArray(e.tools)&&(console.log(`${e.padding||""}${c.white("Helpful Tools:")}
-`),e.tools.forEach(h=>{console.log(`${e.padding||""}${c.blue(`${h.title} \u2014 ${h.url}`)}
-`)})),console.log(`${e.padding||""}${B()}
-`)};var te=async(r="",e={})=>{let o=`.joystick/build/${r?.charAt(0)==="/"?r.substring(1,r.length):r}`;if(!ke.existsSync(o))return re(`[test.load] Path at ${o} not found.`,{level:"warning",docs:"https://cheatcode.co/docs/joystick/test/load"}),null;let l=await import(o);return l?.default&&e?.default?l.default:l};var oe={};var ne={};var le={};var Br={api:L,component:G,databases:Y,email:D,load:te,queues:q,routes:oe,that:P.that,uploaders:ne,websockets:le};export{Br as default};
+import o from"./test.js";import r from"./helpers/api/index.js";import t from"./helpers/component/index.js";import e from"./helpers/databases/index.js";import m from"./helpers/email/index.js";import f from"./helpers/queues/index.js";import a from"./helpers/load/index.js";import p from"./helpers/routes/index.js";import i from"./helpers/uploaders/index.js";import s from"./helpers/websockets/index.js";var w={after:o.after,afterEach:o.afterEach,api:r,before:o.before,beforeEach:o.beforeEach,component:t,databases:e,email:m,load:a,queues:f,routes:p,that:o.that,uploaders:i,websockets:s};export{w as default};

package/dist/lib/CLILog.js

@@ -0,0 +1,13 @@
+import l from"chalk";import o from"./rainbowRoad.js";var t=(c="",e={})=>{const g={info:"blue",success:"green",warning:"yellowBright",danger:"red"},d={info:"\u2771 Info",success:"\u2771 Ok",warning:"\u2771 Warning",danger:"\u2771 Error"},a=e.level?g[e.level]:"gray",r=e.level?d[e.level]:"Log",$=e.docs||"https://github.com/cheatcode/joystick";console.log(`
+${e.padding||""}${o()}
+`),console.log(`${e.padding||""}${l[a](`${r}:`)}
+`),console.log(`${e.padding||""}${l.white(c)}
+`),console.log(`${e.padding||""}${l.grey("---")}
+`),console.log(`${e.padding||""}${l.white("Relevant Documentation:")}
+`),console.log(`${e.padding||""}${l.blue($)}
+`),console.log(`${e.padding||""}${l.white("Stuck? Ask a Question:")}
+`),console.log(`${e.padding||""}${l.blue("https://github.com/cheatcode/joystick/discussions")}
+`),e.tools&&Array.isArray(e.tools)&&(console.log(`${e.padding||""}${l.white("Helpful Tools:")}
+`),e.tools.forEach(n=>{console.log(`${e.padding||""}${l.blue(`${n.title} \u2014 ${n.url}`)}
+`)})),console.log(`${e.padding||""}${o()}
+`)};export{t as default};

package/dist/lib/generateId.js

@@ -0,0 +1 @@
+var l=(e=16)=>{let t=[],a=["0","1","2","3","4","5","6","7","8","9","a","b","c","d","e","f","g","h","i","j","k","l","m","n","o","p","q","r","s","t","u","v","w","x","y","z","A","B","C","D","E","F","G","H","I","J","K","L","M","N","O","P","Q","R","S","T","U","V","W","X","Y","Z"];for(let r=0;r<e;r++)t.push(a[Math.floor(Math.random()*16)]);return t.join("")};export{l as default};

package/dist/lib/isValidJSONString.js

@@ -0,0 +1 @@
+var t=(r="")=>{try{return JSON.parse(r)}catch{return!1}};export{t as default};

package/dist/lib/loadSettings.js

@@ -0,0 +1 @@
+import r from"fs";import i from"./CLILog.js";import c from"./isValidJSONString.js";const a=(e="")=>{try{const t=c(e),s=process.env.NODE_ENV==="test"?"test":"start";t||(i(`Failed to parse settings file. Double-check the syntax in your settings.${process.env.NODE_ENV}.json file at the root of your project and rerun joystick ${s}.`,{level:"danger",docs:"https://cheatcode.co/docs/joystick/environment-settings",tools:[{title:"JSON Linter",url:"https://jsonlint.com/"}]}),process.exit(0))}catch(t){throw new Error(`[loadSettings.warnIfInvalidJSONInSettings] ${t.message}`)}},d=(e="")=>{try{return r.readFileSync(e,"utf-8")}catch(t){throw new Error(`[loadSettings.getSettings] ${t.message}`)}},g=(e="")=>{try{const t=r.existsSync(e),s=process.env.NODE_ENV==="test"?"test":"start";t||(i(`A settings file could not be found for this environment (${process.env.NODE_ENV}). Create a settings.${process.env.NODE_ENV}.json file at the root of your project and rerun joystick ${s}.`,{level:"danger",docs:`https://cheatcode.co/docs/joystick/cli/${s}`}),process.exit(0))}catch(t){throw new Error(`[loadSettings.warnIfSettingsNotFound] ${t.message}`)}},l=e=>{try{if(!e)throw new Error("options object is required.");if(!e.environment)throw new Error("options.environment is required.")}catch(t){throw new Error(`[loadSettings.validateOptions] ${t.message}`)}},p=(e,{resolve:t,reject:s})=>{try{l(e);const o=`${process.cwd()}/settings.${e.environment}.json`;g(o);const n=d(o);a(n),process.env.JOYSTICK_SETTINGS=n,t({parsed:JSON.parse(n),unparsed:n})}catch(o){s(`[loadSettings] ${o.message}`)}};var N=e=>new Promise((t,s)=>{p(e,{resolve:t,reject:s})});export{N as default};

package/dist/lib/rainbowRoad.js

@@ -1,5 +1 @@
-var y=(r=0)=>e=>`\x1B[${e+r}m`,E=(r=0)=>e=>`\x1B[${38+r};5;${e}m`,N=(r=0)=>(e,t,o)=>`\x1B[${38+r};2;${e};${t};${o}m`,l={modifier:{reset:[0,0],bold:[1,22],dim:[2,22],italic:[3,23],underline:[4,24],overline:[53,55],inverse:[7,27],hidden:[8,28],strikethrough:[9,29]},color:{black:[30,39],red:[31,39],green:[32,39],yellow:[33,39],blue:[34,39],magenta:[35,39],cyan:[36,39],white:[37,39],blackBright:[90,39],gray:[90,39],grey:[90,39],redBright:[91,39],greenBright:[92,39],yellowBright:[93,39],blueBright:[94,39],magentaBright:[95,39],cyanBright:[96,39],whiteBright:[97,39]},bgColor:{bgBlack:[40,49],bgRed:[41,49],bgGreen:[42,49],bgYellow:[43,49],bgBlue:[44,49],bgMagenta:[45,49],bgCyan:[46,49],bgWhite:[47,49],bgBlackBright:[100,49],bgGray:[100,49],bgGrey:[100,49],bgRedBright:[101,49],bgGreenBright:[102,49],bgYellowBright:[103,49],bgBlueBright:[104,49],bgMagentaBright:[105,49],bgCyanBright:[106,49],bgWhiteBright:[107,49]}},z=Object.keys(l.modifier),j=Object.keys(l.color),w=Object.keys(l.bgColor),J=[...j,...w];function k(){let r=new Map;for(let[e,t]of Object.entries(l)){for(let[o,n]of Object.entries(t))l[o]={open:`\x1B[${n[0]}m`,close:`\x1B[${n[1]}m`},t[o]=l[o],r.set(n[0],n[1]);Object.defineProperty(l,e,{value:t,enumerable:!1})}return Object.defineProperty(l,"codes",{value:r,enumerable:!1}),l.color.close="\x1B[39m",l.bgColor.close="\x1B[49m",l.color.ansi=y(),l.color.ansi256=E(),l.color.ansi16m=N(),l.bgColor.ansi=y(10),l.bgColor.ansi256=E(10),l.bgColor.ansi16m=N(10),Object.defineProperties(l,{rgbToAnsi256:{value(e,t,o){return e===t&&t===o?e<8?16:e>248?231:Math.round((e-8)/247*24)+232:16+36*Math.round(e/255*5)+6*Math.round(t/255*5)+Math.round(o/255*5)},enumerable:!1},hexToRgb:{value(e){let t=/[a-f\d]{6}|[a-f\d]{3}/i.exec(e.toString(16));if(!t)return[0,0,0];let[o]=t;o.length===3&&(o=[...o].map(i=>i+i).join(""));let n=Number.parseInt(o,16);return[n>>16&255,n>>8&255,n&255]},enumerable:!1},hexToAnsi256:{value:e=>l.rgbToAnsi256(...l.hexToRgb(e)),enumerable:!1},ansi256ToAnsi:{value(e){if(e<8)return 30+e;if(e<16)return 90+(e-8);let t,o,n;if(e>=232)t=((e-232)*10+8)/255,o=t,n=t;else{e-=16;let A=e%36;t=Math.floor(e/36)/5,o=Math.floor(A/6)/5,n=A%6/5}let i=Math.max(t,o,n)*2;if(i===0)return 30;let u=30+(Math.round(n)<<2|Math.round(o)<<1|Math.round(t));return i===2&&(u+=60),u},enumerable:!1},rgbToAnsi:{value:(e,t,o)=>l.ansi256ToAnsi(l.rgbToAnsi256(e,t,o)),enumerable:!1},hexToAnsi:{value:e=>l.ansi256ToAnsi(l.hexToAnsi256(e)),enumerable:!1}}),l}var L=k(),a=L;import O from"node:process";import P from"node:os";import x from"node:tty";function c(r,e=globalThis.Deno?globalThis.Deno.args:O.argv){let t=r.startsWith("-")?"":r.length===1?"-":"--",o=e.indexOf(t+r),n=e.indexOf("--");return o!==-1&&(n===-1||o<n)}var{env:s}=O,g;c("no-color")||c("no-colors")||c("color=false")||c("color=never")?g=0:(c("color")||c("colors")||c("color=true")||c("color=always"))&&(g=1);function G(){if("FORCE_COLOR"in s)return s.FORCE_COLOR==="true"?1:s.FORCE_COLOR==="false"?0:s.FORCE_COLOR.length===0?1:Math.min(Number.parseInt(s.FORCE_COLOR,10),3)}function $(r){return r===0?!1:{level:r,hasBasic:!0,has256:r>=2,has16m:r>=3}}function Y(r,{streamIsTTY:e,sniffFlags:t=!0}={}){let o=G();o!==void 0&&(g=o);let n=t?g:o;if(n===0)return 0;if(t){if(c("color=16m")||c("color=full")||c("color=truecolor"))return 3;if(c("color=256"))return 2}if("TF_BUILD"in s&&"AGENT_NAME"in s)return 1;if(r&&!e&&n===void 0)return 0;let i=n||0;if(s.TERM==="dumb")return i;if(O.platform==="win32"){let u=P.release().split(".");return Number(u[0])>=10&&Number(u[2])>=10586?Number(u[2])>=14931?3:2:1}if("CI"in s)return"GITHUB_ACTIONS"in s||"GITEA_ACTIONS"in s?3:["TRAVIS","CIRCLECI","APPVEYOR","GITLAB_CI","BUILDKITE","DRONE"].some(u=>u in s)||s.CI_NAME==="codeship"?1:i;if("TEAMCITY_VERSION"in s)return/^(9\.(0*[1-9]\d*)\.|\d{2,}\.)/.test(s.TEAMCITY_VERSION)?1:0;if(s.COLORTERM==="truecolor"||s.TERM==="xterm-kitty")return 3;if("TERM_PROGRAM"in s){let u=Number.parseInt((s.TERM_PROGRAM_VERSION||"").split(".")[0],10);switch(s.TERM_PROGRAM){case"iTerm.app":return u>=3?3:2;case"Apple_Terminal":return 2}}return/-256(color)?$/i.test(s.TERM)?2:/^screen|^xterm|^vt100|^vt220|^rxvt|color|ansi|cygwin|linux/i.test(s.TERM)||"COLORTERM"in s?1:i}function v(r,e={}){let t=Y(r,{streamIsTTY:r&&r.isTTY,...e});return $(t)}var D={stdout:v({isTTY:x.isatty(1)}),stderr:v({isTTY:x.isatty(2)})},B=D;function M(r,e,t){let o=r.indexOf(e);if(o===-1)return r;let n=e.length,i=0,u="";do u+=r.slice(i,o)+e+t,i=o+n,o=r.indexOf(e,i);while(o!==-1);return u+=r.slice(i),u}function I(r,e,t,o){let n=0,i="";do{let u=r[o-1]==="\r";i+=r.slice(n,u?o-1:o)+e+(u?`\r
-`:`
-`)+t,n=o+1,o=r.indexOf(`
-`,n)}while(o!==-1);return i+=r.slice(n),i}var{stdout:S,stderr:F}=B,C=Symbol("GENERATOR"),b=Symbol("STYLER"),d=Symbol("IS_EMPTY"),_=["ansi","ansi","ansi256","ansi16m"],h=Object.create(null),U=(r,e={})=>{if(e.level&&!(Number.isInteger(e.level)&&e.level>=0&&e.level<=3))throw new Error("The `level` option should be an integer from 0 to 3");let t=S?S.level:0;r.level=e.level===void 0?t:e.level};var V=r=>{let e=(...t)=>t.join(" ");return U(e,r),Object.setPrototypeOf(e,m.prototype),e};function m(r){return V(r)}Object.setPrototypeOf(m.prototype,Function.prototype);for(let[r,e]of Object.entries(a))h[r]={get(){let t=p(this,R(e.open,e.close,this[b]),this[d]);return Object.defineProperty(this,r,{value:t}),t}};h.visible={get(){let r=p(this,this[b],!0);return Object.defineProperty(this,"visible",{value:r}),r}};var T=(r,e,t,...o)=>r==="rgb"?e==="ansi16m"?a[t].ansi16m(...o):e==="ansi256"?a[t].ansi256(a.rgbToAnsi256(...o)):a[t].ansi(a.rgbToAnsi(...o)):r==="hex"?T("rgb",e,t,...a.hexToRgb(...o)):a[t][r](...o),K=["rgb","hex","ansi256"];for(let r of K){h[r]={get(){let{level:t}=this;return function(...o){let n=R(T(r,_[t],"color",...o),a.color.close,this[b]);return p(this,n,this[d])}}};let e="bg"+r[0].toUpperCase()+r.slice(1);h[e]={get(){let{level:t}=this;return function(...o){let n=R(T(r,_[t],"bgColor",...o),a.bgColor.close,this[b]);return p(this,n,this[d])}}}}var W=Object.defineProperties(()=>{},{...h,level:{enumerable:!0,get(){return this[C].level},set(r){this[C].level=r}}}),R=(r,e,t)=>{let o,n;return t===void 0?(o=r,n=e):(o=t.openAll+r,n=e+t.closeAll),{open:r,close:e,openAll:o,closeAll:n,parent:t}},p=(r,e,t)=>{let o=(...n)=>H(o,n.length===1?""+n[0]:n.join(" "));return Object.setPrototypeOf(o,W),o[C]=r,o[b]=e,o[d]=t,o},H=(r,e)=>{if(r.level<=0||!e)return r[d]?"":e;let t=r[b];if(t===void 0)return e;let{openAll:o,closeAll:n}=t;if(e.includes("\x1B"))for(;t!==void 0;)e=M(e,t.close,t.open),t=t.parent;let i=e.indexOf(`
-`);return i!==-1&&(e=I(e,n,o,i)),o+e+n};Object.defineProperties(m.prototype,h);var q=m(),se=m({level:F?F.level:0});var f=q;var ce=()=>`${f.red("=")}${f.green("=")}${f.blue("=")}${f.red("=")}${f.green("=")}${f.blue("=")}`;export{ce as default};
+import e from"chalk";var $=()=>`${e.red("=")}${e.green("=")}${e.blue("=")}${e.red("=")}${e.green("=")}${e.blue("=")}`;export{$ as default};

package/dist/lib/serializeQueryParameters.js

@@ -0,0 +1 @@
+var n=(e={})=>Object.entries(e).map(([r,t])=>`${r}=${t}`)?.join("&");export{n as default};

package/dist/test.js

@@ -1,4 +1 @@
-var C=Object.create;var f=Object.defineProperty;var v=Object.getOwnPropertyDescriptor;var I=Object.getOwnPropertyNames;var R=Object.getPrototypeOf,T=Object.prototype.hasOwnProperty;var t=(e=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(e,{get:(r,n)=>(typeof require<"u"?require:r)[n]}):e)(function(e){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+e+'" is not supported')});var o=(e,r)=>()=>(r||e((r={exports:{}}).exports,r),r.exports);var x=(e,r,n,d)=>{if(r&&typeof r=="object"||typeof r=="function")for(let s of I(r))!T.call(e,s)&&s!==n&&f(e,s,{get:()=>r[s],enumerable:!(d=v(r,s))||d.enumerable});return e};var y=(e,r,n)=>(n=e!=null?C(R(e)):{},x(r||!e||!e.__esModule?f(n,"default",{value:e,enumerable:!0}):n,e));var h=o(a=>{"use strict";var M=t("node:process"),{isMainThread:b}=t("node:worker_threads");a.isRunningInThread=b===!1;a.isRunningInChildProcess=typeof M.send=="function"});var p=o(()=>{"use strict";var A=t("node:path"),u=t("node:process"),{isRunningInThread:P,isRunningInChildProcess:$}=h();if(!$&&!P)if(u.argv[1]){let e=A.relative(".",u.argv[1]);console.log(),console.error(`Test files must be run with the AVA CLI:
-
-    $ ava ${e}
-`),u.exit(1)}else throw new Error("The \u2019ava\u2019 module can only be imported in test files")});var g=o(i=>{"use strict";i.flags={loadedMain:!1};i.refs={runnerChain:null};i.sharedWorkerTeardowns=[];i.waitForReady=[]});var w=o((z,m)=>{"use strict";p();var k=t("node:assert"),{flags:E,refs:q}=g();k(q.runnerChain);E.loadedMain=!0;m.exports=q.runnerChain});var l=y(w(),1);var c=class{constructor(){}that(r="",n=null){return(0,l.default)(r,n)}},G=new c;export{G as default};
+import e from"ava";class a{constructor(){}before(r=null){return e.serial.before(r)}beforeEach(r=null){return e.beforeEach(r)}after(r=null){return e.after.always(r)}afterEach(r=null){return e.afterEach.always(r)}that(r="",t=null){return e(r,t)}}var u=new a;export{u as default};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@joystick.js/test-canary",
   "type": "module",
-  "version": "0.0.0-canary.3",
+  "version": "0.0.0-canary.31",
   "description": "Isomorphic testing framework for the Joystick JavaScript framework.",
   "main": "dist/index.js",
   "scripts": {
@@ -13,5 +13,8 @@
   },
   "keywords": [],
   "author": "",
-  "license": "SAUCR"
+  "license": "SAUCR",
+  "dependencies": {
+    "ava": "^5.3.1"
+  }
 }

package/src/helpers/component/event.js

@@ -0,0 +1,9 @@
+export default (eventType = '', eventTarget = '', dom = {}) => {
+ const app = dom?.document?.querySelector('#app');
+ const target = app?.querySelector(eventTarget);
+ const eventToDispatch = new Event(eventType);
+ 
+ target.dispatchEvent(eventToDispatch);
+ 
+ return true;
+};

package/src/helpers/component/index.js

@@ -1 +1,44 @@
-export default {};
+
+import { parseHTML } from 'linkedom';
+import joystick from '@joystick.js/ui-canary';
+import event from './event.js';
+import load from "../load/index.js";
+
+const loadDOM = () => {
+  const dom = parseHTML(`<div id="app"></div>`);
+  const { window, document, Element, Event, HTMLElement } = dom;
+
+  global.window = window;
+  global.document = document;
+  global.HTMLElement = HTMLElement;
+  global.Element = Element;
+  global.Event = Event;
+  global.console = {
+   log: console.log,
+   warn: console.warn,
+   error: console.error,
+  };
+
+  return dom;
+};
+
+export default async (pathToComponent = '', options = {}) => {
+  const dom = loadDOM();
+
+  window.joystick = {};
+
+  // NOTE: Force default to true as that's the prescribed pattern for
+  // Joystick component files.
+  const Component = await load(pathToComponent, { default: true });
+  const component = joystick.mount(Component, options?.props || {}, document.querySelector('#app'));
+
+  return {
+    ...dom,
+    component,
+    test: {
+      event: (eventType = '', eventTarget = '') => {
+        return event(eventType, eventTarget, dom);
+      },
+    },
+  };
+};

package/src/helpers/databases/index.js

@@ -1 +1,58 @@
-export default {};
+import loadSettings from "../../lib/loadSettings.js";
+import connectMongoDB from './mongodb/index.js';
+import connectPostgreSQL from './postgresql/index.js';
+
+export default async () => {
+  const settings = (await loadSettings({ environment: 'test' }))?.parsed;
+
+  const databases = settings?.config?.databases?.map((database) => {
+    return {
+      provider: database?.provider,
+      settings: database,
+    };
+  });
+
+  for (
+    let databaseIndex = 0;
+    databaseIndex < databases?.length;
+    databaseIndex += 1
+    ) {
+    const database = databases[databaseIndex];
+    const hasMultipleOfProvider = (databases?.filter((database) => database?.provider === database?.provider))?.length > 1;
+    const databasePort = parseInt(process.env.PORT, 10) + 10 + databaseIndex;
+
+    if (database?.provider === "mongodb") {
+      const mongodb = await connectMongoDB(database?.settings, databasePort);
+      process.databases = {
+        ...(process.databases || {}),
+        mongodb: !hasMultipleOfProvider ? mongodb : {
+          ...(process?.databases?.mongodb || {}),
+          [database?.settings?.name || `mongodb_${databasePort}`]: mongodb,
+        },
+      };
+    }
+
+    if (database?.provider === "postgresql") {
+      const postgresql = await connectPostgreSQL(
+        database?.settings,
+        databasePort
+        );
+
+      process.databases = {
+        ...(process.databases || {}),
+        postgresql: !hasMultipleOfProvider ? {
+          ...postgresql?.pool,
+          query: postgresql?.query,
+        } : {
+          ...(process?.databases?.postgresql || {}),
+          [database?.settings?.name || `postgresql_${databasePort}`]: {
+            ...postgresql?.pool,
+            query: postgresql?.query,
+          },
+        },
+      };
+    }
+  }
+
+  return process.databases;
+};

package/src/helpers/databases/mongodb/availableQueryParameters.js

@@ -0,0 +1,39 @@
+export default [
+  "replicaSet",
+  "tls",
+  "ssl",
+  "tlsCertificateKeyFile",
+  "tlsCertificateKeyFilePassword",
+  "tlsCAFile",
+  "tlsAllowInvalidCertificates",
+  "tlsAllowInvalidHostnames",
+  "tlsInsecure",
+  "connectTimeoutMS",
+  "socketTimeoutMS",
+  "compressors",
+  "zlibCompressionLevel",
+  "maxPoolSize",
+  "minPoolSize",
+  "maxIdleTimeMS",
+  "waitQueueMultiple",
+  "waitQueueTimeoutMS",
+  "w",
+  "wtimeoutMS",
+  "journal",
+  "readConcernLevel",
+  "readPreference",
+  "maxStalenessSeconds",
+  "readPreferenceTags",
+  "authSource",
+  "authMechanism",
+  "authMechanismProperties",
+  "gssapiServiceName",
+  "localThresholdMS",
+  "serverSelectionTimeoutMS",
+  "serverSelectionTryOnce",
+  "heartbeatFrequencyMS",
+  "appName",
+  "retryReads",
+  "retryWrites",
+  "uuidRepresentation"
+];

package/src/helpers/databases/mongodb/buildConnectionString.js

@@ -0,0 +1,28 @@
+import buildQueryParameters from "./buildQueryParameters.js";
+import serializeQueryParameters from "../../../lib/serializeQueryParameters.js";
+
+export default (connection = {}) => {
+  let connectionString = "mongodb://";
+
+  if (connection && (connection.username || connection.password)) {
+    connectionString = `${connectionString}${connection.username || connection.password ? `${connection.username || ""}${!!connection.username && !!connection.password ? ':' : ''}${connection.password || ""}@` : ''}`;
+  }
+
+  if (connection && connection.hosts && Array.isArray(connection.hosts)) {
+    connectionString = `${connectionString}${connection.hosts
+      .map((host) => `${host.hostname}:${host.port}`)
+      .join(",")}`;
+  }
+
+  if (connection && connection.database) {
+    connectionString = `${connectionString}/${connection.database}`;
+  }
+
+  const queryParameters = buildQueryParameters(connection);
+
+  if (Object.keys(queryParameters)?.length > 0 ) {
+    connectionString = `${connectionString}?${serializeQueryParameters(queryParameters)}`;
+  }
+
+  return connectionString;
+};

package/src/helpers/databases/mongodb/buildQueryParameters.js

@@ -0,0 +1,15 @@
+import availableQueryParameters from "./availableQueryParameters.js";
+
+export default (connection = {}) => {
+  const queryParameters = {};
+
+  for (let i = 0; i < availableQueryParameters.length; i += 1) {
+    const availableParameter = availableQueryParameters[i];
+
+    if (connection && connection[availableParameter]) {
+      queryParameters[availableParameter] = connection[availableParameter];
+    }
+  }
+
+  return queryParameters;
+};

package/src/helpers/databases/mongodb/index.js

@@ -0,0 +1,43 @@
+import { MongoClient } from "mongodb";
+import chalk from "chalk";
+import mongoUri from "mongo-uri-tool";
+import fs from 'fs';
+import buildConnectionString from "./buildConnectionString.js";
+
+export default async (settings = {}, databasePort = 2610) => {
+  const connection = settings?.connection || {
+    hosts: [
+      // NOTE: By default, expect databases start from 2610 (assuming a PORT of 2600).
+      { hostname: "127.0.0.1", port: databasePort },
+    ],
+    database: "app",
+    replicaSet: `joystick_${databasePort}`,
+  };
+
+  const connectionString = buildConnectionString(connection);
+  const parsedURI = mongoUri.parseUri(connectionString);
+
+  try {
+    const connectionOptions = {
+      useNewUrlParser: true,
+      useUnifiedTopology: true,
+      ssl: !['development', 'test'].includes(process.env.NODE_ENV),
+      ...(settings?.options || {})
+    };
+
+    if (settings?.options?.ca) {
+      connectionOptions.ca = fs.readFileSync(settings?.options?.ca);
+    }
+
+    const client = await MongoClient.connect(connectionString, connectionOptions);
+    const db = client.db(parsedURI.db);
+
+    return db;
+  } catch (exception) {
+    console.warn(
+      chalk.yellowBright(
+        `\nFailed to connect to MongoDB. Please double-check connection settings and try again.\n\nError from MongoDB:\n\n${chalk.redBright(exception?.message)}`
+      ),
+    );
+  }
+};

package/src/helpers/databases/postgresql/addColumnToTable.js

@@ -0,0 +1,3 @@
+export default (table = '', columnName = '', columnSchema = '') => {
+  return process.databases._users?.query(`ALTER TABLE ${table} ADD COLUMN ${columnName} ${columnSchema}`);
+};

package/src/helpers/databases/postgresql/createAccountsIndexes.js

@@ -0,0 +1,29 @@
+const createUniqueIndex = async (indexName = '', tableName = '', tableColumns = []) => {
+  return process.databases._users?.query(`CREATE UNIQUE INDEX IF NOT EXISTS ${indexName} ON ${tableName}(${tableColumns.join(', ')})`);
+};
+
+const createIndex = async (indexName = '', tableName = '', tableColumns = []) => {
+  return process.databases._users?.query(`CREATE INDEX IF NOT EXISTS ${indexName} ON ${tableName}(${tableColumns.join(', ')})`);
+};
+
+export default async () => {
+  // users
+  await createIndex('user_by_email', 'users', ['email_address']);
+  await createIndex('user_by_username', 'users', ['username']);
+  await createIndex('user_by_user_id', 'users', ['user_id']);
+  
+  // users_sessions
+  await createIndex('user_session_by_token', 'users_sessions', ['token']);
+
+  // users_password_reset_tokens
+  await createIndex('user_password_reset_token_by_token', 'users_password_reset_tokens', ['token']);
+  await createIndex('user_password_reset_token_by_user_id_token', 'users_password_reset_tokens', ['user_id', 'token']);
+ 
+  // users_roles
+  await createIndex('user_role', 'users_roles', ['role']);
+  await createIndex('user_roles_by_user_id_role', 'users_roles', ['user_id', 'role']);
+  
+  // roles
+  await createIndex('role', 'roles', ['role']);
+  await createUniqueIndex('user_roles', 'users_roles', ['user_id', 'role']);
+};

package/src/helpers/databases/postgresql/createAccountsTables.js

@@ -0,0 +1,44 @@
+const createTable = async (table = "", tableColumns = []) => {
+  return process.databases._users?.query(
+    `CREATE TABLE IF NOT EXISTS ${table} (${tableColumns.join(", ")})`
+  );
+};
+
+export default async () => {
+  await createTable("users", [
+    "id bigserial primary key",
+    "user_id text",
+    "email_address text",
+    "password text",
+    "username text",
+    "language text",
+  ]);
+
+  await createTable("users_sessions", [
+    "id bigserial primary key",
+    "user_id text",
+    "token text",
+    "token_expires_at text",
+  ]);
+
+  await createTable("users_password_reset_tokens", [
+    "id bigserial primary key",
+    "user_id text",
+    "token text",
+    "requested_at text",
+  ]);
+
+  await createTable("users_verify_email_tokens", [
+    "id bigserial primary key",
+    "user_id text",
+    "token text",
+  ]);
+
+  await createTable("roles", ["id bigserial primary key", "role text"]);
+
+  await createTable("users_roles", [
+    "id bigserial primary key",
+    "user_id text",
+    "role text",
+  ]);
+};

package/src/helpers/databases/postgresql/index.js

@@ -0,0 +1,52 @@
+import postgresql from 'pg';
+import chalk from "chalk";
+import os from 'os';
+
+const { Pool } = postgresql;
+
+export default async (settings = {}, databasePort = 2610) => {
+  const connection = settings?.connection || {
+    hosts: [
+      { hostname: "127.0.0.1", port: databasePort },
+    ],
+    database: "app",
+    // NOTE: PostgreSQL creates a default superuser based on the OS username.
+    username: (os.userInfo() || {}).username || "",
+    password: "",
+  };
+
+  try {
+    const host = connection.hosts && connection.hosts[0];
+    const pool = new Pool({
+      user: connection?.username || '',
+      database: connection?.database,
+      password: connection?.password || '',
+      host: host?.hostname,
+      port: host?.port,
+      ...(settings?.options || {})
+    });
+  
+    return {
+      pool,
+      query: (...args) => {
+        return pool.query(...args).then((response) => {
+          return response?.rows || [];
+        }).catch((error) => {
+          console.log(chalk.redBright(`\nFailed SQL Statement:\n`));
+          console.log(args[0]);
+          console.log(`\n`);
+          console.log(chalk.redBright(`\nFailed Values:\n`));
+          console.log(args[1]);
+
+          throw error;
+        });
+      }
+    };
+  } catch (exception) {
+    console.warn(
+      chalk.yellowBright(
+        `\nFailed to connect to PostgreSQL. Please double-check connection settings and try again.\n\nError from PostgreSQL:\n\n${chalk.redBright(exception?.message)}`
+      ),
+    );
+  }
+};

package/src/helpers/load/index.js

@@ -1,13 +1,20 @@
 import fs from 'fs';
-import log from "../../lib/log";
+import CLILog from "../../lib/CLILog.js";
+
+const uncachedImport = async (path = '', options = {}) => {
+  const modulePath = `${path}?update=${Date.now()}`
+  const contents = await import(modulePath);
+  return (contents?.default && options?.default) ? contents.default : contents;
+};
 
 export default async (path = '', options = {}) => {
   const sanitizedPath = path?.charAt(0) === '/' ? path.substring(1, path.length) : path;
-  const buildPath = `.joystick/build/${sanitizedPath}`;
+  // NOTE: Use timestamp to cache bust on import() below.
+  const buildPath = `${process.cwd()}/.joystick/build/${sanitizedPath}`;
   const pathExists = fs.existsSync(buildPath);
   
   if (!pathExists) {
-    log(`[test.load] Path at ${buildPath} not found.`, {
+    CLILog(`[test.load] Path at ${buildPath} not found.`, {
       level: 'warning',
       docs: 'https://cheatcode.co/docs/joystick/test/load',
     });
@@ -15,7 +22,5 @@ export default async (path = '', options = {}) => {
     return null;
   }
   
-  const contents = await import(buildPath);
-  
-  return (contents?.default && options?.default) ? contents.default : contents;
+  return uncachedImport(buildPath, options);
 };

package/src/helpers/queues/index.js

@@ -1 +1,9 @@
-export default {};
+export default {
+  job: (queueName = '', job = {}) => {
+    // TODO: Add a job of name to queueName.
+    // TODO: Run the job immediately.
+    // TODO: Return result of job.
+    // TODO: In test, either verify that response is as expected, or, test for known
+    // side-effects of the job in database.
+  },
+};

package/src/index.js

@@ -10,7 +10,11 @@ import uploaders from './helpers/uploaders/index.js';
 import websockets from './helpers/websockets/index.js';
 
 export default {
+  after: test.after,
+  afterEach: test.afterEach,
   api,
+  before: test.before,
+  beforeEach: test.beforeEach,
   component,
   databases,
   email,

package/src/lib/{log.js → CLILog.js}

@@ -18,7 +18,7 @@ export default (message = '', options = {}) => {
 
   const color = options.level ? colors[options.level] : 'gray';
   const title = options.level ? titles[options.level] : 'Log';
-  const docs = options.docs || 'https://cheatcode.co/docs/joystick';
+  const docs = options.docs || 'https://github.com/cheatcode/joystick';
 
   console.log(`\n${(options.padding || '')}${rainbowRoad()}\n`);
   console.log(`${(options.padding || '')}${chalk[color](`${title}:`)}\n`)

package/src/lib/generateId.js

@@ -0,0 +1,73 @@
+export default (length = 16) => {
+  let result = [];
+  let character = [
+    "0",
+    "1",
+    "2",
+    "3",
+    "4",
+    "5",
+    "6",
+    "7",
+    "8",
+    "9",
+    "a",
+    "b",
+    "c",
+    "d",
+    "e",
+    "f",
+    "g",
+    "h",
+    "i",
+    "j",
+    "k",
+    "l",
+    "m",
+    "n",
+    "o",
+    "p",
+    "q",
+    "r",
+    "s",
+    "t",
+    "u",
+    "v",
+    "w",
+    "x",
+    "y",
+    "z",
+    "A",
+    "B",
+    "C",
+    "D",
+    "E",
+    "F",
+    "G",
+    "H",
+    "I",
+    "J",
+    "K",
+    "L",
+    "M",
+    "N",
+    "O",
+    "P",
+    "Q",
+    "R",
+    "S",
+    "T",
+    "U",
+    "V",
+    "W",
+    "X",
+    "Y",
+    "Z",
+    ];
+
+  for (let n = 0; n < length; n++) {
+    result.push(character[Math.floor(Math.random() * 16)]);
+  }
+
+  return result.join("");
+};

package/src/lib/isValidJSONString.js

@@ -0,0 +1,7 @@
+export default (JSONString = "") => {
+  try {
+    return JSON.parse(JSONString);
+  } catch (error) {
+    return false;
+  }
+};

package/src/lib/loadSettings.js

@@ -0,0 +1,90 @@
+/* eslint-disable consistent-return */
+
+import fs from 'fs';
+import CLILog from "./CLILog.js";
+import isValidJSONString from "./isValidJSONString.js";
+
+const warnIfInvalidJSONInSettings = (settings = '') => {
+  try {
+    const isValidJSON = isValidJSONString(settings);
+    const context = process.env.NODE_ENV === 'test' ? 'test' : 'start';
+
+    if (!isValidJSON) {
+      CLILog(
+        `Failed to parse settings file. Double-check the syntax in your settings.${process.env.NODE_ENV}.json file at the root of your project and rerun joystick ${context}.`,
+        {
+          level: "danger",
+          docs: `https://cheatcode.co/docs/joystick/environment-settings`,
+          tools: [{ title: "JSON Linter", url: "https://jsonlint.com/" }],
+        }
+        );
+
+      process.exit(0);
+    }
+  } catch (exception) {
+    throw new Error(`[loadSettings.warnIfInvalidJSONInSettings] ${exception.message}`);
+  }
+};
+
+const getSettings = (settingsPath = '') => {
+  try {
+    return fs.readFileSync(settingsPath, 'utf-8');
+  } catch (exception) {
+    throw new Error(`[loadSettings.getSettings] ${exception.message}`);
+  }
+};
+
+const warnIfSettingsNotFound = (settingsPath = '') => {
+  try {
+    const hasSettingsFile = fs.existsSync(settingsPath);
+    const context = process.env.NODE_ENV === 'test' ? 'test' : 'start';
+
+    if (!hasSettingsFile) {
+      CLILog(
+        `A settings file could not be found for this environment (${process.env.NODE_ENV}). Create a settings.${process.env.NODE_ENV}.json file at the root of your project and rerun joystick ${context}.`,
+        {
+          level: "danger",
+          docs: `https://cheatcode.co/docs/joystick/cli/${context}`,
+        }
+        );
+
+      process.exit(0);
+    }
+  } catch (exception) {
+    throw new Error(`[loadSettings.warnIfSettingsNotFound] ${exception.message}`);
+  }
+};
+
+const validateOptions = (options) => {
+  try {
+    if (!options) throw new Error('options object is required.');
+    if (!options.environment) throw new Error('options.environment is required.');
+  } catch (exception) {
+    throw new Error(`[loadSettings.validateOptions] ${exception.message}`);
+  }
+};
+
+const loadSettings = (options, { resolve, reject }) => {
+  try {
+    validateOptions(options);
+
+    const settingsPath = `${process.cwd()}/settings.${options.environment}.json`;
+    warnIfSettingsNotFound(settingsPath);
+    const settings = getSettings(settingsPath);
+    warnIfInvalidJSONInSettings(settings);
+
+    process.env.JOYSTICK_SETTINGS = settings;
+
+    resolve({
+      parsed: JSON.parse(settings),
+      unparsed: settings,
+    });
+  } catch (exception) {
+    reject(`[loadSettings] ${exception.message}`);
+  }
+};
+
+export default (options) =>
+  new Promise((resolve, reject) => {
+    loadSettings(options, { resolve, reject });
+  });

package/src/lib/serializeQueryParameters.js

@@ -0,0 +1,5 @@
+export default (queryParameters = {}) => {
+  return Object.entries(queryParameters).map(([key, value]) => {
+    return `${key}=${value}`;
+  })?.join('&');
+};

package/src/test.js

@@ -4,7 +4,29 @@ class Test {
   constructor() {
 
   }
-
+  
+  before(callback = null) {
+    // NOTE: Prefer serial before to async to align better with
+    // expectations and avoid confusion.
+    return test.serial.before(callback);  
+  }
+  
+  beforeEach(callback = null) {
+    return test.beforeEach(callback);  
+  }
+  
+  after(callback = null) {
+    // NOTE: Prefer after always to guarantee cleanup and avoid
+    // messy test suites that may or may not cleanup due to failures.
+    return test.after.always(callback);  
+  }
+  
+  afterEach(callback = null) {
+    // NOTE: Prefer afterEach always to guarantee cleanup and avoid
+    // messy test suites that may or may not cleanup due to failures.
+    return test.afterEach.always(callback);  
+  }
+  
   that(description = '', callback = null) {
     return test(description, callback);
   }

package/dist/lib/log.js

@@ -1,17 +0,0 @@
-var E=(r=0)=>e=>`\x1B[${e+r}m`,v=(r=0)=>e=>`\x1B[${38+r};5;${e}m`,x=(r=0)=>(e,o,t)=>`\x1B[${38+r};2;${e};${o};${t}m`,l={modifier:{reset:[0,0],bold:[1,22],dim:[2,22],italic:[3,23],underline:[4,24],overline:[53,55],inverse:[7,27],hidden:[8,28],strikethrough:[9,29]},color:{black:[30,39],red:[31,39],green:[32,39],yellow:[33,39],blue:[34,39],magenta:[35,39],cyan:[36,39],white:[37,39],blackBright:[90,39],gray:[90,39],grey:[90,39],redBright:[91,39],greenBright:[92,39],yellowBright:[93,39],blueBright:[94,39],magentaBright:[95,39],cyanBright:[96,39],whiteBright:[97,39]},bgColor:{bgBlack:[40,49],bgRed:[41,49],bgGreen:[42,49],bgYellow:[43,49],bgBlue:[44,49],bgMagenta:[45,49],bgCyan:[46,49],bgWhite:[47,49],bgBlackBright:[100,49],bgGray:[100,49],bgGrey:[100,49],bgRedBright:[101,49],bgGreenBright:[102,49],bgYellowBright:[103,49],bgBlueBright:[104,49],bgMagentaBright:[105,49],bgCyanBright:[106,49],bgWhiteBright:[107,49]}},z=Object.keys(l.modifier),_=Object.keys(l.color),k=Object.keys(l.bgColor),J=[..._,...k];function j(){let r=new Map;for(let[e,o]of Object.entries(l)){for(let[t,n]of Object.entries(o))l[t]={open:`\x1B[${n[0]}m`,close:`\x1B[${n[1]}m`},o[t]=l[t],r.set(n[0],n[1]);Object.defineProperty(l,e,{value:o,enumerable:!1})}return Object.defineProperty(l,"codes",{value:r,enumerable:!1}),l.color.close="\x1B[39m",l.bgColor.close="\x1B[49m",l.color.ansi=E(),l.color.ansi256=v(),l.color.ansi16m=x(),l.bgColor.ansi=E(10),l.bgColor.ansi256=v(10),l.bgColor.ansi16m=x(10),Object.defineProperties(l,{rgbToAnsi256:{value(e,o,t){return e===o&&o===t?e<8?16:e>248?231:Math.round((e-8)/247*24)+232:16+36*Math.round(e/255*5)+6*Math.round(o/255*5)+Math.round(t/255*5)},enumerable:!1},hexToRgb:{value(e){let o=/[a-f\d]{6}|[a-f\d]{3}/i.exec(e.toString(16));if(!o)return[0,0,0];let[t]=o;t.length===3&&(t=[...t].map(s=>s+s).join(""));let n=Number.parseInt(t,16);return[n>>16&255,n>>8&255,n&255]},enumerable:!1},hexToAnsi256:{value:e=>l.rgbToAnsi256(...l.hexToRgb(e)),enumerable:!1},ansi256ToAnsi:{value(e){if(e<8)return 30+e;if(e<16)return 90+(e-8);let o,t,n;if(e>=232)o=((e-232)*10+8)/255,t=o,n=o;else{e-=16;let b=e%36;o=Math.floor(e/36)/5,t=Math.floor(b/6)/5,n=b%6/5}let s=Math.max(o,t,n)*2;if(s===0)return 30;let c=30+(Math.round(n)<<2|Math.round(t)<<1|Math.round(o));return s===2&&(c+=60),c},enumerable:!1},rgbToAnsi:{value:(e,o,t)=>l.ansi256ToAnsi(l.rgbToAnsi256(e,o,t)),enumerable:!1},hexToAnsi:{value:e=>l.ansi256ToAnsi(l.hexToAnsi256(e)),enumerable:!1}}),l}var L=j(),f=L;import T from"node:process";import P from"node:os";import N from"node:tty";function u(r,e=globalThis.Deno?globalThis.Deno.args:T.argv){let o=r.startsWith("-")?"":r.length===1?"-":"--",t=e.indexOf(o+r),n=e.indexOf("--");return t!==-1&&(n===-1||t<n)}var{env:i}=T,p;u("no-color")||u("no-colors")||u("color=false")||u("color=never")?p=0:(u("color")||u("colors")||u("color=true")||u("color=always"))&&(p=1);function G(){if("FORCE_COLOR"in i)return i.FORCE_COLOR==="true"?1:i.FORCE_COLOR==="false"?0:i.FORCE_COLOR.length===0?1:Math.min(Number.parseInt(i.FORCE_COLOR,10),3)}function Y(r){return r===0?!1:{level:r,hasBasic:!0,has256:r>=2,has16m:r>=3}}function D(r,{streamIsTTY:e,sniffFlags:o=!0}={}){let t=G();t!==void 0&&(p=t);let n=o?p:t;if(n===0)return 0;if(o){if(u("color=16m")||u("color=full")||u("color=truecolor"))return 3;if(u("color=256"))return 2}if("TF_BUILD"in i&&"AGENT_NAME"in i)return 1;if(r&&!e&&n===void 0)return 0;let s=n||0;if(i.TERM==="dumb")return s;if(T.platform==="win32"){let c=P.release().split(".");return Number(c[0])>=10&&Number(c[2])>=10586?Number(c[2])>=14931?3:2:1}if("CI"in i)return"GITHUB_ACTIONS"in i||"GITEA_ACTIONS"in i?3:["TRAVIS","CIRCLECI","APPVEYOR","GITLAB_CI","BUILDKITE","DRONE"].some(c=>c in i)||i.CI_NAME==="codeship"?1:s;if("TEAMCITY_VERSION"in i)return/^(9\.(0*[1-9]\d*)\.|\d{2,}\.)/.test(i.TEAMCITY_VERSION)?1:0;if(i.COLORTERM==="truecolor"||i.TERM==="xterm-kitty")return 3;if("TERM_PROGRAM"in i){let c=Number.parseInt((i.TERM_PROGRAM_VERSION||"").split(".")[0],10);switch(i.TERM_PROGRAM){case"iTerm.app":return c>=3?3:2;case"Apple_Terminal":return 2}}return/-256(color)?$/i.test(i.TERM)?2:/^screen|^xterm|^vt100|^vt220|^rxvt|color|ansi|cygwin|linux/i.test(i.TERM)||"COLORTERM"in i?1:s}function $(r,e={}){let o=D(r,{streamIsTTY:r&&r.isTTY,...e});return Y(o)}var U={stdout:$({isTTY:N.isatty(1)}),stderr:$({isTTY:N.isatty(2)})},B=U;function I(r,e,o){let t=r.indexOf(e);if(t===-1)return r;let n=e.length,s=0,c="";do c+=r.slice(s,t)+e+o,s=t+n,t=r.indexOf(e,s);while(t!==-1);return c+=r.slice(s),c}function M(r,e,o,t){let n=0,s="";do{let c=r[t-1]==="\r";s+=r.slice(n,c?t-1:t)+e+(c?`\r
-`:`
-`)+o,n=t+1,t=r.indexOf(`
-`,n)}while(t!==-1);return s+=r.slice(n),s}var{stdout:S,stderr:F}=B,C=Symbol("GENERATOR"),d=Symbol("STYLER"),h=Symbol("IS_EMPTY"),w=["ansi","ansi","ansi256","ansi16m"],g=Object.create(null),V=(r,e={})=>{if(e.level&&!(Number.isInteger(e.level)&&e.level>=0&&e.level<=3))throw new Error("The `level` option should be an integer from 0 to 3");let o=S?S.level:0;r.level=e.level===void 0?o:e.level};var W=r=>{let e=(...o)=>o.join(" ");return V(e,r),Object.setPrototypeOf(e,m.prototype),e};function m(r){return W(r)}Object.setPrototypeOf(m.prototype,Function.prototype);for(let[r,e]of Object.entries(f))g[r]={get(){let o=O(this,y(e.open,e.close,this[d]),this[h]);return Object.defineProperty(this,r,{value:o}),o}};g.visible={get(){let r=O(this,this[d],!0);return Object.defineProperty(this,"visible",{value:r}),r}};var R=(r,e,o,...t)=>r==="rgb"?e==="ansi16m"?f[o].ansi16m(...t):e==="ansi256"?f[o].ansi256(f.rgbToAnsi256(...t)):f[o].ansi(f.rgbToAnsi(...t)):r==="hex"?R("rgb",e,o,...f.hexToRgb(...t)):f[o][r](...t),K=["rgb","hex","ansi256"];for(let r of K){g[r]={get(){let{level:o}=this;return function(...t){let n=y(R(r,w[o],"color",...t),f.color.close,this[d]);return O(this,n,this[h])}}};let e="bg"+r[0].toUpperCase()+r.slice(1);g[e]={get(){let{level:o}=this;return function(...t){let n=y(R(r,w[o],"bgColor",...t),f.bgColor.close,this[d]);return O(this,n,this[h])}}}}var H=Object.defineProperties(()=>{},{...g,level:{enumerable:!0,get(){return this[C].level},set(r){this[C].level=r}}}),y=(r,e,o)=>{let t,n;return o===void 0?(t=r,n=e):(t=o.openAll+r,n=e+o.closeAll),{open:r,close:e,openAll:t,closeAll:n,parent:o}},O=(r,e,o)=>{let t=(...n)=>Q(t,n.length===1?""+n[0]:n.join(" "));return Object.setPrototypeOf(t,H),t[C]=r,t[d]=e,t[h]=o,t},Q=(r,e)=>{if(r.level<=0||!e)return r[h]?"":e;let o=r[d];if(o===void 0)return e;let{openAll:t,closeAll:n}=o;if(e.includes("\x1B"))for(;o!==void 0;)e=I(e,o.close,o.open),o=o.parent;let s=e.indexOf(`
-`);return s!==-1&&(e=M(e,n,t,s)),t+e+n};Object.defineProperties(m.prototype,g);var q=m(),ie=m({level:F?F.level:0});var a=q;var A=()=>`${a.red("=")}${a.green("=")}${a.blue("=")}${a.red("=")}${a.green("=")}${a.blue("=")}`;var ge=(r="",e={})=>{let o={info:"blue",success:"green",warning:"yellowBright",danger:"red"},t={info:"\u2771 Info",success:"\u2771 Ok",warning:"\u2771 Warning",danger:"\u2771 Error"},n=e.level?o[e.level]:"gray",s=e.level?t[e.level]:"Log",c=e.docs||"https://cheatcode.co/docs/joystick";console.log(`
-${e.padding||""}${A()}
-`),console.log(`${e.padding||""}${a[n](`${s}:`)}
-`),console.log(`${e.padding||""}${a.white(r)}
-`),console.log(`${e.padding||""}${a.grey("---")}
-`),console.log(`${e.padding||""}${a.white("Relevant Documentation:")}
-`),console.log(`${e.padding||""}${a.blue(c)}
-`),console.log(`${e.padding||""}${a.white("Stuck? Ask a Question:")}
-`),console.log(`${e.padding||""}${a.blue("https://github.com/cheatcode/joystick/discussions")}
-`),e.tools&&Array.isArray(e.tools)&&(console.log(`${e.padding||""}${a.white("Helpful Tools:")}
-`),e.tools.forEach(b=>{console.log(`${e.padding||""}${a.blue(`${b.title} \u2014 ${b.url}`)}
-`)})),console.log(`${e.padding||""}${A()}
-`)};export{ge as default};