h1v3 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Commonwealth Labs Ltd.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,2 @@
+# h1v3
+A firebase web platform

package/dist/browser/event-store/modular.js

@@ -0,0 +1,82 @@
+function newEventId(eventType) {
+
+    return `${Date.now()}-${Math.random().toString().substring(2)}-${eventType}`;
+
+}
+
+export function eventStore(firebase, path) {
+
+    const { db, ref, onValue, get, set } = firebase;
+    for (const required of ["db", "ref", "onValue", "get", "set"])
+        if (!firebase[required]) throw new Error(`Missing required firebase.${required}`);
+
+    const eventsPath = `${path}/events`;
+    const projectionsPath = `${path}/projections`;
+
+    const subscriptions = {};
+
+    async function unsubscribe(name) {
+
+        const unsubscribe = subscriptions[name];
+        if (unsubscribe) {
+
+            console.log("Unsubscribing from", name);
+            await unsubscribe();
+            delete subscriptions[name];
+
+        }
+
+    }
+
+    async function unsubscribeAll() {
+
+        while(Object.keys(subscriptions).length) {
+
+            await Promise.all(
+                Object.keys(subscriptions).map(unsubscribe)
+            );
+
+        }
+
+    }
+
+    return {
+
+        async record(eventType, payload) {
+
+            const eid = newEventId(eventType);
+            const data = { type: eventType, payload };
+            await set(ref(db, `${eventsPath}/${eid}`), data);
+
+        },
+
+        async getProjection(name) {
+
+            const snap = await get(ref(db, `${projectionsPath}/${name}`));
+            return snap.val();
+
+        },
+
+        onProjectionValue(name, callback) {
+
+            const query = ref(db, `${projectionsPath}/${name}`);
+            console.log("Subscribing to", query.toString());
+            subscriptions[name] = onValue(query, callback);
+
+        },
+
+        async offProjection(name) {
+
+            await unsubscribe(name);
+
+        },
+
+        async dispose() {
+
+           await unsubscribeAll();
+
+        }
+
+    };
+
+}

package/dist/browser/web/events.js

@@ -0,0 +1,7 @@
+export const EVENT_ERROR_OCCURRED = "h1v3:error-occurred";
+
+export const EVENT_SIGN_OUT_REQUESTED = "h1v3:sign-out-requested";
+
+export const EVENT_EMAIL_AUTH_REQUESTED = "h1v3:email-auth-requested";
+
+export const EVENT_GOOGLE_AUTH_REQUESTED = "h1v3:google-auth-requested";

package/dist/browser/web/login.js

@@ -0,0 +1,48 @@
+import { EVENT_EMAIL_AUTH_REQUESTED, EVENT_GOOGLE_AUTH_REQUESTED, EVENT_SIGN_OUT_REQUESTED } from "./events.js";
+
+export function registerLoginHandlers(bus, {
+    authentication: {
+        auth,
+        GoogleAuthProvider,
+        signInWithPopup,
+        signInWithEmailAndPassword,
+        signOut
+    }
+}) {
+
+    const googleAuth = new GoogleAuthProvider();
+
+    bus.addEventListener(EVENT_GOOGLE_AUTH_REQUESTED, () => {
+
+        signInWithPopup(auth, googleAuth);
+
+    });
+
+    bus.addEventListener(EVENT_EMAIL_AUTH_REQUESTED, async (e) => {
+
+        try {
+
+            await signInWithEmailAndPassword(auth, e.detail?.email, e.detail?.password);
+
+        } catch (err) {
+
+            switch (err?.code) {
+                case "auth/wrong-password":
+                    alert("Wrong password");
+                    break;
+                default:
+                    alert(err?.code || err?.message);
+                    break;
+            }
+
+        }
+
+    });
+
+    bus.addEventListener(EVENT_SIGN_OUT_REQUESTED, () => {
+
+        signOut(auth);
+
+    });
+
+}

package/dist/browser/web/system.js

@@ -0,0 +1,67 @@
+// vendor: firebase
+import { initializeApp } from "https://www.gstatic.com/firebasejs/12.3.0/firebase-app.js";
+import {
+    connectAuthEmulator,
+    getAuth,
+    onAuthStateChanged,
+    signInWithPopup,
+    signInWithEmailAndPassword,
+    signOut,
+    GoogleAuthProvider
+} from "https://www.gstatic.com/firebasejs/12.3.0/firebase-auth.js";
+import {
+    child,
+    connectDatabaseEmulator,
+    get,
+    getDatabase,
+    off,
+    onValue,
+    ref,
+    set,
+    update,
+} from "https://www.gstatic.com/firebasejs/12.3.0/firebase-database.js";
+
+// init firebase
+import firebaseConfig from "/firebase.config.js";
+const app = initializeApp(firebaseConfig);
+const auth = getAuth(app);
+const db = getDatabase(app);
+
+// firebase emulator support
+const useEmulator = location?.hostname === "localhost" || location?.hostname === "127.0.0.1";
+if (useEmulator) {
+
+    const resp = await fetch("http://127.0.0.1:4400/emulators");
+    const emulators = await resp.json();
+    connectAuthEmulator(auth, `http://${emulators.auth.host}:${emulators.auth.port}`);
+    connectDatabaseEmulator(db, emulators.database.host, emulators.database.port);
+
+}
+
+// controlled export of firebase
+export const firebase = {
+    authentication: {
+        auth,
+        onAuthStateChanged,
+        signInWithEmailAndPassword,
+        signInWithPopup,
+        signOut,
+        GoogleAuthProvider
+    },
+    database: {
+        child,
+        db,
+        ref,
+        get,
+        set,
+        update,
+        onValue,
+        off
+    }
+}
+
+export const bus = document;
+
+// h1v3
+import { registerLoginHandlers } from "./login.js";
+registerLoginHandlers(bus, firebase);

package/dist/browser/web-ui/components/login.html.js

@@ -0,0 +1,44 @@
+import { html } from "../system.js";
+import { dialog } from "./partials/wa-utils.js";
+
+export const loginButton = () => html`<wa-button class="open-login">Login</wa-button>`;
+
+export const loginDialog = () => dialog("Login", html`
+<div class="wa-stack">
+
+    <wa-input label="Email" type="email"></wa-input>
+    <wa-input label="Password" type="password"></wa-input>
+    <a href="#">Having trouble signing in?</a>
+    <wa-button class="login-with-email">Sign in</wa-button>
+    <wa-divider></wa-divider>
+    <p>Or sign in with:</p>
+    <div class="wa-grid" style="--min-column-size: 12ch;">
+
+        <wa-button appearance="outlined" class="login-with-google">
+
+            <wa-icon slot="start" name="google" family="brands"></wa-icon>
+            Google
+
+        </wa-button>
+        <wa-button appearance="outlined" disabled>
+
+            <wa-icon slot="start" name="apple" family="brands"></wa-icon>
+            Apple ID
+
+        </wa-button>
+        <wa-button appearance="outlined" disabled>
+
+            <wa-icon slot="start" name="facebook" family="brands"></wa-icon>
+            Facebook
+
+        </wa-button>
+
+    </div>
+    <p>Don't have an account? <a href="#">Create one</a></p>
+
+</div>
+`);
+
+export const signOutButton = () => html`<wa-button class="sign-out">Sign out</wa-button>`;
+
+export const hello = ({ displayName, email }) => html`<strong>${displayName}</strong> (${email}) `;

package/dist/browser/web-ui/components/login.js

@@ -0,0 +1,74 @@
+import { LitElement, html, bus } from "../system.js";
+import { styled } from "./partials/wa-utils.js";
+import { hello, loginButton, loginDialog, signOutButton } from './login.html.js';
+import { EVENT_EMAIL_AUTH_REQUESTED, EVENT_GOOGLE_AUTH_REQUESTED, EVENT_SIGN_OUT_REQUESTED } from "../../web/events.js";
+
+class Login extends LitElement {
+
+    static get properties() {
+
+        return {
+
+            currentUser: { type: Object }
+
+        };
+
+    }
+
+    createRenderRoot() {
+
+        const root = super.createRenderRoot();
+        root.addEventListener("click", e => this.handleClick(e));
+        return root;
+
+    }
+
+    handleClick(e) {
+
+        switch(e.target.className) {
+
+            case "open-login":
+                this.shadowRoot.querySelector("wa-dialog").open = true;
+                break;
+            case "login-with-google":
+                bus.dispatchEvent(new CustomEvent(EVENT_GOOGLE_AUTH_REQUESTED));
+                break;
+            case "login-with-email":
+                const inputLogin = this.shadowRoot.querySelector("wa-input[type=email]");
+                const inputPassword = this.shadowRoot.querySelector("wa-input[type=password]");
+                bus.dispatchEvent(new CustomEvent(EVENT_EMAIL_AUTH_REQUESTED, { detail: { email: inputLogin.value, password: inputPassword.value }}));
+                break;
+            case "sign-out":
+                bus.dispatchEvent(new CustomEvent(EVENT_SIGN_OUT_REQUESTED));
+                break;
+        }
+
+    }
+
+    render() {
+
+        if (this.currentUser === undefined) {
+
+            return html`Initialising...`;
+
+        } else if(this.currentUser === null) {
+
+            return styled(
+                loginDialog(),
+                loginButton()
+            );
+
+        } else {
+
+            return styled(
+                hello(this.currentUser),
+                signOutButton()
+            );
+
+        }
+
+    }
+
+}
+customElements.define('h1v3-login', Login);
+

package/dist/browser/web-ui/components/notification.html.js

@@ -0,0 +1,12 @@
+import { html } from "../system.js";
+
+export const errorNotification = ({ message }) => html`
+
+    <wa-callout variant="danger" style="opacity: 1; margin: 0.5rem; zoom: 0.8;" role="alert">
+
+        <wa-icon slot="icon" name="circle-exclamation"></wa-icon>
+        <strong>${message}</strong>
+
+    </wa-callout>
+
+`;

package/dist/browser/web-ui/components/notification.js

@@ -0,0 +1,25 @@
+import { LitElement } from "../system.js";
+import { errorNotification } from "./notification.html.js";
+import { styled } from "./partials/wa-utils.js";
+
+class Notification extends LitElement {
+
+    static get properties() {
+
+        return {
+
+            err: { type: Object }
+
+        };
+
+    }
+
+    render() {
+
+        if (this.err)
+            return styled(errorNotification(this.err));
+
+    }
+
+}
+customElements.define("h1v3-notification", Notification);

package/dist/browser/web-ui/components/partials/wa-utils.js

@@ -0,0 +1,17 @@
+import { html, waDist } from "../../system.js";
+
+export const styled = (...children) => html`
+    <link rel="stylesheet" href="${waDist}/styles/webawesome.css" />
+    <link rel="stylesheet" href="${waDist}/styles/themes/premium.css" />
+    <div class="wa-cloak">
+        ${children}
+    </div>
+`;
+
+export const dialog = (title, ...children) => html`
+<wa-dialog label="${title}" light-dismiss class="dialog-light-dismiss">
+
+    ${children}
+
+</wa-dialog>
+`;

package/dist/browser/web-ui/errors.js

@@ -0,0 +1,23 @@
+import { EVENT_ERROR_OCCURRED } from "../web/events.js";
+
+const container = document.createElement("ASIDE");
+container.style.position = "fixed";
+container.style.top = "0px";
+container.style.right = "0px";
+container.style.maxWidth = "40rem";
+container.style.zIndex = 9999;
+
+document.body.appendChild(container);
+
+document.addEventListener(EVENT_ERROR_OCCURRED, ({ detail: { err } }) => {
+
+    if (err) {
+
+        const notification = document.createElement("h1v3-notification");
+        container.appendChild(notification);
+        notification.err = err;
+        setTimeout(() => notification.remove(), 5000);
+
+    }
+
+});

package/dist/browser/web-ui/system.js

@@ -0,0 +1,20 @@
+export * from "../web/system.js";
+
+export const waDist = "/vendor/@shoelace-style/webawesome-pro@3.0.0-beta.6/dist";
+
+// vendor: webawesome
+import "/vendor/@shoelace-style/webawesome-pro@3.0.0-beta.6/dist/components/button/button.js";
+import "/vendor/@shoelace-style/webawesome-pro@3.0.0-beta.6/dist/components/input/input.js";
+import "/vendor/@shoelace-style/webawesome-pro@3.0.0-beta.6/dist/components/card/card.js";
+import "/vendor/@shoelace-style/webawesome-pro@3.0.0-beta.6/dist/components/divider/divider.js";
+import "/vendor/@shoelace-style/webawesome-pro@3.0.0-beta.6/dist/components/icon/icon.js";
+import "/vendor/@shoelace-style/webawesome-pro@3.0.0-beta.6/dist/components/dialog/dialog.js";
+import "/vendor/@shoelace-style/webawesome-pro@3.0.0-beta.6/dist/components/callout/callout.js";
+
+// vendor: lit
+export { html, LitElement } from "/vendor/lit@3.3.1/dist/lit-core.min.js";
+
+// h1v3
+import "./errors.js";
+import "./components/notification.js";
+import "./components/login.js";

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "h1v3",
+  "version": "0.1.0",
+  "description": "",
+  "license": "ISC",
+  "author": "",
+  "type": "module",
+  "exports": {
+    ".": "./src/index.js",
+    "./schema": "./src/schema.js",
+    "./client": "./src/client/index.js"
+  },
+  "bin": {
+    "eventstore": "./src/exec-eventstore.js"
+  },
+  "dependencies": {
+    "minimist": "^1.2.8"
+  },
+  "scripts": {
+    "dist:client": "node ./scripts/dist-client.js"
+  }
+}

package/scripts/dist-client.js

@@ -0,0 +1,31 @@
+import fs from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+const src = join(__dirname, "..", "src", "client");
+const dist = join(__dirname, "..", "dist", "browser");
+
+await fs.rm(dist, { recursive: true, force: true });
+async function distribute(subPath, path) {
+
+    const subDist = join(dist, subPath);
+    await fs.mkdir(subDist, { recursive: true });
+    await fs.cp(
+        join(src, path),
+        join(subDist, path),
+        { recursive: true, force: true }
+    );
+
+}
+
+const publishList = [
+    ["event-store", "modular.js"],
+    ["", "web/"],
+    ["", "web-ui/"]
+];
+
+await Promise.all(publishList.map(kv => distribute(...kv)));
+
+console.log("Published", publishList.map(x => x.map(y => y || ".").reverse().join(" > ")).join(", "));

package/src/client/index.js

@@ -0,0 +1,2 @@
+export * as node from "./node.js";
+export * as modular from "./modular.js";

package/src/client/modular.js

@@ -0,0 +1,82 @@
+function newEventId(eventType) {
+
+    return `${Date.now()}-${Math.random().toString().substring(2)}-${eventType}`;
+
+}
+
+export function eventStore(firebase, path) {
+
+    const { db, ref, onValue, get, set } = firebase;
+    for (const required of ["db", "ref", "onValue", "get", "set"])
+        if (!firebase[required]) throw new Error(`Missing required firebase.${required}`);
+
+    const eventsPath = `${path}/events`;
+    const projectionsPath = `${path}/projections`;
+
+    const subscriptions = {};
+
+    async function unsubscribe(name) {
+
+        const unsubscribe = subscriptions[name];
+        if (unsubscribe) {
+
+            console.log("Unsubscribing from", name);
+            await unsubscribe();
+            delete subscriptions[name];
+
+        }
+
+    }
+
+    async function unsubscribeAll() {
+
+        while(Object.keys(subscriptions).length) {
+
+            await Promise.all(
+                Object.keys(subscriptions).map(unsubscribe)
+            );
+
+        }
+
+    }
+
+    return {
+
+        async record(eventType, payload) {
+
+            const eid = newEventId(eventType);
+            const data = { type: eventType, payload };
+            await set(ref(db, `${eventsPath}/${eid}`), data);
+
+        },
+
+        async getProjection(name) {
+
+            const snap = await get(ref(db, `${projectionsPath}/${name}`));
+            return snap.val();
+
+        },
+
+        onProjectionValue(name, callback) {
+
+            const query = ref(db, `${projectionsPath}/${name}`);
+            console.log("Subscribing to", query.toString());
+            subscriptions[name] = onValue(query, callback);
+
+        },
+
+        async offProjection(name) {
+
+            await unsubscribe(name);
+
+        },
+
+        async dispose() {
+
+           await unsubscribeAll();
+
+        }
+
+    };
+
+}

package/src/client/node.js

@@ -0,0 +1,29 @@
+import { eventStore as eventStoreModular } from "./modular.js";
+
+function adapter(db) {
+
+    return {
+        db,
+        ref(_db, path) {
+            return db.ref(path);
+        },
+        async onValue(query, callback) {
+            query.on("value", callback);
+            return () => query.off("value", callback);
+        },
+        async get(query) {
+            return await query.get();
+        },
+        async set(ref, data) {
+            return await ref.set(data);
+        }
+    };
+
+}
+
+export function eventStore(db, path) {
+
+    const firebase = adapter(db);
+    return eventStoreModular(firebase, path);
+
+}

package/src/client/web/events.js

@@ -0,0 +1,7 @@
+export const EVENT_ERROR_OCCURRED = "h1v3:error-occurred";
+
+export const EVENT_SIGN_OUT_REQUESTED = "h1v3:sign-out-requested";
+
+export const EVENT_EMAIL_AUTH_REQUESTED = "h1v3:email-auth-requested";
+
+export const EVENT_GOOGLE_AUTH_REQUESTED = "h1v3:google-auth-requested";

package/src/client/web/login.js

@@ -0,0 +1,48 @@
+import { EVENT_EMAIL_AUTH_REQUESTED, EVENT_GOOGLE_AUTH_REQUESTED, EVENT_SIGN_OUT_REQUESTED } from "./events.js";
+
+export function registerLoginHandlers(bus, {
+    authentication: {
+        auth,
+        GoogleAuthProvider,
+        signInWithPopup,
+        signInWithEmailAndPassword,
+        signOut
+    }
+}) {
+
+    const googleAuth = new GoogleAuthProvider();
+
+    bus.addEventListener(EVENT_GOOGLE_AUTH_REQUESTED, () => {
+
+        signInWithPopup(auth, googleAuth);
+
+    });
+
+    bus.addEventListener(EVENT_EMAIL_AUTH_REQUESTED, async (e) => {
+
+        try {
+
+            await signInWithEmailAndPassword(auth, e.detail?.email, e.detail?.password);
+
+        } catch (err) {
+
+            switch (err?.code) {
+                case "auth/wrong-password":
+                    alert("Wrong password");
+                    break;
+                default:
+                    alert(err?.code || err?.message);
+                    break;
+            }
+
+        }
+
+    });
+
+    bus.addEventListener(EVENT_SIGN_OUT_REQUESTED, () => {
+
+        signOut(auth);
+
+    });
+
+}