create-volt 0.26.0 → 0.28.0

package/CHANGELOG.md

@@ -4,6 +4,25 @@ All notable changes to `create-volt` are documented here. The format follows
 [Keep a Changelog](https://keepachangelog.com/), and this project adheres to
 [Semantic Versioning](https://semver.org/).
 
+## [0.28.0] - 2026-06-29
+
+### Fixed
+- Wizard **Test connection** now installs the selected DB driver on demand
+  (mongodb / mysql2 / pg, at the pinned version) before testing — it used to fail
+  with "<driver> isn't installed" because the package is only added on Apply.
+  Also adds the missing `spawnSync` import.
+
+## [0.27.0] - 2026-06-29
+
+### Fixed
+- **Reactive crash on conditional re-render** (`volt.js`) — a signal write
+  notified a *snapshot* of subscribers, so a parent reactive block that disposed
+  a nested one mid-update would still run the stale nested effect on detached DOM
+  ("Cannot read properties of null (reading 'insertBefore')"). Disposed effects
+  now skip their queued run, and `renderRange` guards against a detached range.
+  Fixes the **setup wizard** crashing when toggling add-ons or changing the DB
+  driver. Regression-tested in the headless-browser suite.
+
 ## [0.26.0] - 2026-06-29
 
 ### Added
@@ -370,6 +389,8 @@ All notable changes to `create-volt` are documented here. The format follows
   watching and full-page hot reload. Supports `--skip-install` and `--force`,
   and auto-detects npm / pnpm / yarn / bun for the install step.
 
+[0.28.0]: https://github.com/MIR-2025/volt/releases/tag/v0.28.0
+[0.27.0]: https://github.com/MIR-2025/volt/releases/tag/v0.27.0
 [0.26.0]: https://github.com/MIR-2025/volt/releases/tag/v0.26.0
 [0.25.0]: https://github.com/MIR-2025/volt/releases/tag/v0.25.0
 [0.24.0]: https://github.com/MIR-2025/volt/releases/tag/v0.24.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-volt",
-  "version": "0.26.0",
+  "version": "0.28.0",
   "description": "Scaffold a new Volt app — no-build, signals-based UI with Socket.io hot reload.",
   "type": "module",
   "bin": {

package/templates/default/public/volt.js

@@ -47,7 +47,11 @@ export function effect(fn) {
     deps: new Set(),
     children: new Set(),
     parent: activeEffect,
+    disposed: false,
     run() {
+      // A signal write notifies a *snapshot* of subscribers; a parent re-render
+      // can dispose this effect before its turn in that snapshot — so skip if so.
+      if (eff.disposed) return;
       disposeChildren(eff);
       cleanupDeps(eff);
       const prev = activeEffect;
@@ -59,6 +63,7 @@ export function effect(fn) {
       }
     },
     dispose() {
+      eff.disposed = true;
       disposeChildren(eff);
       cleanupDeps(eff);
       if (eff.parent) eff.parent.children.delete(eff);
@@ -152,6 +157,7 @@ function appendChild(parent, child) {
 
 // Replace everything between the start/end anchors with `value`'s nodes.
 function renderRange(start, end, value) {
+  if (!end.parentNode) return; // range detached (parent re-rendered) — nothing to do
   let n = start.nextSibling;
   while (n && n !== end) {
     const t = n.nextSibling;

package/templates/default/server.js

@@ -11,7 +11,7 @@
 import http from "node:http";
 import fs from "node:fs";
 import path from "node:path";
-import { spawn } from "node:child_process";
+import { spawn, spawnSync } from "node:child_process";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import express from "express";
 import { Server as SocketServer } from "socket.io";
@@ -208,6 +208,15 @@ function neededPackages(env) {
   return want.filter((p) => !deps[p]);
 }
 
+// Install a DB driver's package on demand (pinned), so the wizard's "Test
+// connection" works before Apply has installed it.
+function ensureDriverInstalled(driver) {
+  const pkg = { mongodb: "mongodb", mongo: "mongodb", mysql: "mysql2", postgres: "pg", postgresql: "pg", pg: "pg" }[String(driver || "").toLowerCase()];
+  if (!pkg || fs.existsSync(path.join(__dirname, "node_modules", pkg))) return;
+  console.log(`[volt] installing ${pkg} for the connection test…`);
+  spawnSync("npm", ["install", `${pkg}@${PKG_VERSIONS[pkg] || "latest"}`], { cwd: __dirname, stdio: "inherit", shell: process.platform === "win32" });
+}
+
 // --- the disposable setup wizard (localhost only) ---
 function startSetup() {
   const PORT = Number(process.env.PORT) || Number(readEnvFile().PORT) || DEFAULT_PORT;
@@ -244,6 +253,7 @@ function startSetup() {
             if (env[k]) process.env[k] = env[k];
             else delete process.env[k];
           }
+          ensureDriverInstalled(process.env.DB_DRIVER); // install the driver first, so the test can connect
           const store = await (await addonMod("db")).createStore();
           await store.collection("__voltcheck").all();
           res.setHeader("Content-Type", "application/json");

package/templates/guestbook/public/volt.js

@@ -47,7 +47,11 @@ export function effect(fn) {
     deps: new Set(),
     children: new Set(),
     parent: activeEffect,
+    disposed: false,
     run() {
+      // A signal write notifies a *snapshot* of subscribers; a parent re-render
+      // can dispose this effect before its turn in that snapshot — so skip if so.
+      if (eff.disposed) return;
       disposeChildren(eff);
       cleanupDeps(eff);
       const prev = activeEffect;
@@ -59,6 +63,7 @@ export function effect(fn) {
       }
     },
     dispose() {
+      eff.disposed = true;
       disposeChildren(eff);
       cleanupDeps(eff);
       if (eff.parent) eff.parent.children.delete(eff);
@@ -152,6 +157,7 @@ function appendChild(parent, child) {
 
 // Replace everything between the start/end anchors with `value`'s nodes.
 function renderRange(start, end, value) {
+  if (!end.parentNode) return; // range detached (parent re-rendered) — nothing to do
   let n = start.nextSibling;
   while (n && n !== end) {
     const t = n.nextSibling;

package/templates/starter/public/volt.js

@@ -47,7 +47,11 @@ export function effect(fn) {
     deps: new Set(),
     children: new Set(),
     parent: activeEffect,
+    disposed: false,
     run() {
+      // A signal write notifies a *snapshot* of subscribers; a parent re-render
+      // can dispose this effect before its turn in that snapshot — so skip if so.
+      if (eff.disposed) return;
       disposeChildren(eff);
       cleanupDeps(eff);
       const prev = activeEffect;
@@ -59,6 +63,7 @@ export function effect(fn) {
       }
     },
     dispose() {
+      eff.disposed = true;
       disposeChildren(eff);
       cleanupDeps(eff);
       if (eff.parent) eff.parent.children.delete(eff);
@@ -152,6 +157,7 @@ function appendChild(parent, child) {
 
 // Replace everything between the start/end anchors with `value`'s nodes.
 function renderRange(start, end, value) {
+  if (!end.parentNode) return; // range detached (parent re-rendered) — nothing to do
   let n = start.nextSibling;
   while (n && n !== end) {
     const t = n.nextSibling;

package/templates/starter/server.js

@@ -12,7 +12,7 @@ import http from "node:http";
 import fs from "node:fs";
 import path from "node:path";
 import crypto from "node:crypto";
-import { spawn } from "node:child_process";
+import { spawn, spawnSync } from "node:child_process";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import express from "express";
 import { Server as SocketServer } from "socket.io";
@@ -234,6 +234,15 @@ function neededPackages(env) {
   return want.filter((p) => !deps[p]);
 }
 
+// Install a DB driver's package on demand (pinned), so the wizard's "Test
+// connection" works before Apply has installed it.
+function ensureDriverInstalled(driver) {
+  const pkg = { mongodb: "mongodb", mongo: "mongodb", mysql: "mysql2", postgres: "pg", postgresql: "pg", pg: "pg" }[String(driver || "").toLowerCase()];
+  if (!pkg || fs.existsSync(path.join(__dirname, "node_modules", pkg))) return;
+  console.log(`[volt] installing ${pkg} for the connection test…`);
+  spawnSync("npm", ["install", `${pkg}@${PKG_VERSIONS[pkg] || "latest"}`], { cwd: __dirname, stdio: "inherit", shell: process.platform === "win32" });
+}
+
 // --- the disposable setup wizard (localhost only) ---
 function startSetup() {
   const PORT = Number(process.env.PORT) || Number(readEnvFile().PORT) || DEFAULT_PORT;
@@ -270,6 +279,7 @@ function startSetup() {
             if (env[k]) process.env[k] = env[k];
             else delete process.env[k];
           }
+          ensureDriverInstalled(process.env.DB_DRIVER); // install the driver first, so the test can connect
           const store = await (await addonMod("db")).createStore();
           await store.collection("__voltcheck").all();
           res.setHeader("Content-Type", "application/json");