@joystick.js/test-canary 0.0.0-canary.9 → 0.0.0-canary.90

package/_package.json

@@ -16,6 +16,13 @@
   "license": "SAUCR",
   "dependencies": {
     "ava": "^5.3.1",
-    "esbuild": "^0.18.17"
+    "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",
+    "node-fetch": "^3.3.2",
+    "pg": "^8.11.2"
   }
 }

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 +1 @@
-import a from"fs";import e from"../../lib/log.js";var r=async(t="",n={})=>{const s=`.joystick/build/${t?.charAt(0)==="/"?t.substring(1,t.length):t}`;if(!a.existsSync(s))return e(`[test.load] Path at ${s} not found.`,{level:"warning",docs:"https://cheatcode.co/docs/joystick/test/load"}),null;const o=await import(s);return o?.default&&n?.default?o.default:o};export{r 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/helpers/render/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/render/index.js

@@ -0,0 +1,9 @@
+import{parseHTML as l}from"linkedom";import d from"@joystick.js/ui-canary";import i from"node-fetch";import{URL as w,URLSearchParams as m}from"url";import p from"./event.js";import h from"../load/index.js";const u=async(e="")=>{const r=new w(`${window?.location?.origin}/api/_test/bootstrap`);r.search=new m({pathToComponent:e});const o=await i(r).then(async a=>a.json());window.joystick={},window.joystick.settings={},window.__joystick_data__=o?.data||{},window.__joystick_i18n__=o?.translations||{},window.__joystick_req__=o?.req},_=()=>{const e=l(`
+    <html>
+      <head></head>
+      <body>
+        <div id="app"></div>
+        <meta name="csrf" content="joystick_test" />
+      </body>
+    </html>
+  `),{window:r,document:o,Element:a,Event:n,HTMLElement:t}=e;return global.window=r,global.document=o,global.HTMLElement=t,global.Element=a,global.Event=n,global.console={log:console.log,warn:console.warn,error:console.error},e};var k=async(e="",r={})=>{const o=_();window.fetch=i,window.location={origin:`http://localhost:${process.env.PORT}`},await u(e);const a=await h(e,{default:!0}),n=d.mount(a,r?.props||{},o?.document.querySelector("#app"));return n.isTest=!0,{dom:o,instance:n,test:{data:async(t={})=>n?.data?.refetch(t),renderToHTML:()=>{const t=n?.renderToHTML(),s=new RegExp("<when>|</when>","g");return t?.wrapped?.replace(s,"")?.replace(/\n|\t/g," ")?.replace(/> *</g,"><")},method:(t="",...s)=>{const c=n?.methods[t];return c?c(...s):null},event:(t="",s="")=>p(t,s,o)}}};export{k as default};

package/dist/index.js

@@ -1 +1 @@
-import o from"./test.js";import r from"./helpers/api/index.js";import m from"./helpers/component/index.js";import t from"./helpers/databases/index.js";import p from"./helpers/email/index.js";import e from"./helpers/queues/index.js";import i from"./helpers/load/index.js";import f from"./helpers/routes/index.js";import a from"./helpers/uploaders/index.js";import s from"./helpers/websockets/index.js";var x={api:r,component:m,databases:t,email:p,load:i,queues:e,routes:f,that:o.that,uploaders:a,websockets:s};export{x as default};
+import r from"./test.js";import e from"./helpers/api/index.js";import o from"./helpers/render/index.js";import t from"./helpers/databases/index.js";import m from"./helpers/email/index.js";import a from"./helpers/queues/index.js";import f 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 k={accounts:{signup:r.signupUser,delete:r.deleteUser},after:r.after,afterEach:r.afterEach,api:e,before:r.before,beforeEach:r.beforeEach,render:o,databases:t,email:m,load:f,queues:a,routes:p,that:r.that,uploaders:i,websockets:s};export{k as default};

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

@@ -1,4 +1,4 @@
-import l from"chalk";import o from"./rainbowRoad.js";var t=(c="",e={})=>{const d={info:"blue",success:"green",warning:"yellowBright",danger:"red"},g={info:"\u2771 Info",success:"\u2771 Ok",warning:"\u2771 Warning",danger:"\u2771 Error"},a=e.level?d[e.level]:"gray",r=e.level?g[e.level]:"Log",$=e.docs||"https://cheatcode.co/docs/joystick";console.log(`
+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)}

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/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 +1 @@
-import e from"ava";class o{constructor(){}that(t="",r=null){return e(t,r)}}var n=new o;export{n as default};
+import t from"ava";import o from"node-fetch";let a=[];t.serial.after.always(async()=>{for(let s=0;s<a?.length;s+=1){const e=a[s];await(void 0).deleteUser(e?._id||e?.user_id)}});class i{constructor(){}async signupUser(e=[]){for(let r=0;r<e?.length;r+=1){const n=e[r],l=await o(`http://localhost:${process.env.PORT}/api/_test/accounts/signup`,{method:"POST",mode:"cors",headers:{"Content-Type":"application/json"},body:JSON.stringify(n)}).then(c=>c.json());a.push(l)}}deleteUser(e=""){return o(`http://localhost:${process.env.PORT}/api/_test/accounts`,{method:"DELETE",mode:"cors",headers:{"Content-Type":"application/json"},body:JSON.stringify({userId:e})})}before(e=null){return t.serial.before(e)}beforeEach(e=null){return t.beforeEach(e)}after(e=null){return t.after.always(e)}afterEach(e=null){return t.afterEach.always(e)}that(e="",r=null){return t.serial(e,r)}}var p=new i;export{p as default};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@joystick.js/test-canary",
   "type": "module",
-  "version": "0.0.0-canary.9",
+  "version": "0.0.0-canary.90",
   "description": "Isomorphic testing framework for the Joystick JavaScript framework.",
   "main": "dist/index.js",
   "scripts": {

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.js";
+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/helpers/render/event.js

@@ -0,0 +1,10 @@
+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/render/index.js

@@ -0,0 +1,92 @@
+
+import { parseHTML } from 'linkedom';
+import joystick from '@joystick.js/ui-canary';
+import fetch from 'node-fetch';
+import { URL, URLSearchParams } from 'url';
+import event from './event.js';
+import load from "../load/index.js";
+
+const bootstrapWindow = async (pathToComponent = '') => {
+  const url = new URL(`${window?.location?.origin}/api/_test/bootstrap`);
+  url.search = new URLSearchParams({ pathToComponent });
+
+  const bootstrap = await fetch(url).then(async (response) => response.json());
+
+  window.joystick = {};
+  window.joystick.settings = {}; // TODO
+  window.__joystick_data__ = bootstrap?.data || {};
+  window.__joystick_i18n__ = bootstrap?.translations || {};
+  window.__joystick_req__ = bootstrap?.req; // TODO
+};
+
+const loadDOM = () => {
+  const dom = parseHTML(`
+    <html>
+      <head></head>
+      <body>
+        <div id="app"></div>
+        <meta name="csrf" content="joystick_test" />
+      </body>
+    </html>
+  `);
+  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.fetch = fetch;
+  window.location = {
+    origin: `http://localhost:${process.env.PORT}`,
+  };
+
+  await bootstrapWindow(pathToComponent);
+
+  // 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 || {}, dom?.document.querySelector('#app'));
+
+  // NOTE: Used internally in @joystick.js/ui to control component behavior.
+  component.isTest = true;
+
+  return {
+    dom,
+    instance: component,
+    test: {
+      data: async (input = {}) => {
+        return component?.data?.refetch(input);
+      },
+      renderToHTML: () => {
+        const html = component?.renderToHTML();
+        const whenRegex = new RegExp('<when>|</when>', 'g');
+        return html?.wrapped?.replace(whenRegex, '')?.replace(/\n|\t/g, ' ')?.replace(/> *</g, '><');
+      },
+      method: (methodName = '', ...methodArgs) => {
+        const methodToCall = component?.methods[methodName];
+
+        if (!methodToCall) {
+          return null;
+        }
+
+        return methodToCall(...methodArgs);
+      },
+      event: (eventType = '', eventTarget = '') => {
+        return event(eventType, eventTarget, dom);
+      },
+    },
+  };
+};

package/src/index.js

@@ -1,6 +1,6 @@
 import test from './test.js';
 import api from './helpers/api/index.js';
-import component from './helpers/component/index.js';
+import render from './helpers/render/index.js';
 import databases from './helpers/databases/index.js';
 import email from './helpers/email/index.js';
 import queues from './helpers/queues/index.js';
@@ -10,8 +10,17 @@ import uploaders from './helpers/uploaders/index.js';
 import websockets from './helpers/websockets/index.js';
 
 export default {
+  accounts: {
+    // login: test.login,
+    signup: test.signupUser,
+    delete: test.deleteUser,
+  },
+  after: test.after,
+  afterEach: test.afterEach,
   api,
-  component,
+  before: test.before,
+  beforeEach: test.beforeEach,
+  render,
   databases,
   email,
   load,

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

@@ -1,12 +1,75 @@
 import test from 'ava';
+import fetch from 'node-fetch';
 
-class Test {
-  constructor() {
+let users = [];
+
+test.serial.after.always(async () => {
+  // NOTE: Nuke users who were created as part of the test run to avoid
+  // data collisions in other tests/suites.
 
+  for (let i = 0; i < users?.length; i += 1) {
+    const user = users[i];
+    await this.deleteUser(user?._id || user?.user_id); 
   }
+});
 
+class Test {
+  constructor() {
+  }
+  
+  async signupUser(usersToSignup = []) {
+    for (let i = 0; i < usersToSignup?.length; i += 1) {
+      const userToSignup = usersToSignup[i];
+      const user = await fetch(`http://localhost:${process.env.PORT}/api/_test/accounts/signup`, {
+        method: 'POST',
+        mode: "cors",
+        headers: {
+          "Content-Type": "application/json",
+        },
+        body: JSON.stringify(userToSignup)
+      }).then((response) => response.json());
+      
+      users.push(user);
+    }
+  }
+  
+  deleteUser(userId = '') {
+    return fetch(`http://localhost:${process.env.PORT}/api/_test/accounts`, {
+      method: 'DELETE',
+      mode: "cors",
+      headers: {
+        "Content-Type": "application/json",
+      },
+      body: JSON.stringify({ userId })
+    })
+  }
+  
+  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);
+    // NOTE: Always run serial so we don't have collisions on component instances
+    // for DOM tests.
+    return test.serial(description, callback);
   }
 }
 

package/dist/helpers/component/index.js

@@ -1 +0,0 @@
-var e={};export{e as default};

package/src/helpers/component/index.js

@@ -1 +0,0 @@
-export default {};