hearald 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.1] - 2026-10-09
+
+### Fixed
+
+- The dashboard threw errors the first time it loaded with no data (`Cannot read properties of
+  undefined (reading 'map')` and `(reading 'users')`). It now shows zeros and empty menus when there
+  are no events, no metrics for the chosen chart context, or no `ui` layout.
+
+### Added
+
+- Tests that render the dashboard in a fake browser (happy-dom) against a real hearald router.
+
 ## [0.1.0] - 2026-10-07
 
 ### Security
@@ -117,7 +129,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Initial release of Hearald
 
-[Unreleased]: https://github.com/pariser/hearald/compare/v0.1.0...HEAD
+[Unreleased]: https://github.com/pariser/hearald/compare/v0.1.1...HEAD
+[0.1.1]: https://github.com/pariser/hearald/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/pariser/hearald/compare/v0.0.5...v0.1.0
 [0.0.5]: https://github.com/pariser/hearald/compare/v0.0.4...v0.0.5
 [0.0.4]: https://github.com/pariser/hearald/compare/v0.0.3...v0.0.4

package/dist/analytics.html

@@ -461,7 +461,7 @@ th {
       onLoadProgress(i, n);
 
       const json = await getDataFn({ n: 1, d: iso(day) });
-      const v = json.metrics[context][field] || 0;
+      const v = json?.metrics?.[context]?.[field] || 0;
 
       data.unshift({ date: iso(day), value: v });
       max = Math.max(max, v);
@@ -687,14 +687,14 @@ th {
       fetchStats: getJson,
     });
 
-  let UI = [];
+  let UI = {};
 
   async function fetchUI() {
     try {
       const res = await fetch(window.location.href + "/layout");
-      UI = await res.json();
+      UI = (await res.json()) || {};
     } catch (e) {
-      UI = [];
+      UI = {};
     }
   }
 
@@ -830,7 +830,7 @@ th {
                         name="context"
                         onchange=${(e) => this.changeChartContext(e)}
                       >
-                        ${UI.chartContexts.map(
+                        ${(UI.chartContexts || []).map(
                           ({ id, menuName }) =>
                             m`
                               <option
@@ -899,7 +899,7 @@ th {
                     `}
                   </div>
                 </section>
-                ${UI.sections.map((statsSection) => {
+                ${(UI.sections || []).map((statsSection) => {
                   return m`
                     <section class="analytics analytics--${statsSection.id}">
                       ${statsSection.menuName !== "" &&

package/dist/index.js

@@ -63,7 +63,7 @@
       onLoadProgress(i, n);
 
       const json = await getDataFn({ n: 1, d: iso(day) });
-      const v = json.metrics[context][field] || 0;
+      const v = json?.metrics?.[context]?.[field] || 0;
 
       data.unshift({ date: iso(day), value: v });
       max = Math.max(max, v);
@@ -289,14 +289,14 @@
       fetchStats: getJson,
     });
 
-  let UI = [];
+  let UI = {};
 
   async function fetchUI() {
     try {
       const res = await fetch(window.location.href + "/layout");
-      UI = await res.json();
+      UI = (await res.json()) || {};
     } catch (e) {
-      UI = [];
+      UI = {};
     }
   }
 
@@ -432,7 +432,7 @@
                         name="context"
                         onchange=${(e) => this.changeChartContext(e)}
                       >
-                        ${UI.chartContexts.map(
+                        ${(UI.chartContexts || []).map(
                           ({ id, menuName }) =>
                             m`
                               <option
@@ -501,7 +501,7 @@
                     `}
                   </div>
                 </section>
-                ${UI.sections.map((statsSection) => {
+                ${(UI.sections || []).map((statsSection) => {
                   return m`
                     <section class="analytics analytics--${statsSection.id}">
                       ${statsSection.menuName !== "" &&

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hearald",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "A single server drop-in file system based metrics and analytics library.",
   "main": "src/index.js",
   "exports": {
@@ -27,6 +27,7 @@
     "chalk": "^4.1.0"
   },
   "devDependencies": {
+    "@happy-dom/global-registrator": "^20.14.6",
     "@rollup/plugin-commonjs": "^15.1.0",
     "@rollup/plugin-json": "^4.1.0",
     "@rollup/plugin-node-resolve": "^13.3.0",
@@ -39,6 +40,7 @@
     "eslint-plugin-react-hooks": "^4.6.0",
     "express": "^5.2.1",
     "express4": "npm:express@^4.21.2",
+    "happy-dom": "^20.14.6",
     "htm": "^3.0.3",
     "preact": "^10.3.3",
     "prettier": "2.2.1",

package/src/public/js/App.js

@@ -75,14 +75,14 @@ const getDataFn = ({ n, d, q }) =>
     fetchStats: getJson,
   });
 
-let UI = [];
+let UI = {};
 
 async function fetchUI() {
   try {
     const res = await fetch(window.location.href + "/layout");
-    UI = await res.json();
+    UI = (await res.json()) || {};
   } catch (e) {
-    UI = [];
+    UI = {};
   }
 }
 
@@ -218,7 +218,7 @@ class App extends Component {
                         name="context"
                         onchange=${(e) => this.changeChartContext(e)}
                       >
-                        ${UI.chartContexts.map(
+                        ${(UI.chartContexts || []).map(
                           ({ id, menuName }) =>
                             html`
                               <option
@@ -287,7 +287,7 @@ class App extends Component {
                     `}
                   </div>
                 </section>
-                ${UI.sections.map((statsSection) => {
+                ${(UI.sections || []).map((statsSection) => {
                   return html`
                     <section class="analytics analytics--${statsSection.id}">
                       ${statsSection.menuName !== "" &&

package/src/public/js/util.js

@@ -48,7 +48,7 @@ export async function fetchChartData({
     onLoadProgress(i, n);
 
     const json = await getDataFn({ n: 1, d: iso(day) });
-    const v = json.metrics[context][field] || 0;
+    const v = json?.metrics?.[context]?.[field] || 0;
 
     data.unshift({ date: iso(day), value: v });
     max = Math.max(max, v);