@techstream/quark-create-app 1.9.0 → 1.10.0

package/templates/ui/src/toast.test.js

@@ -0,0 +1,23 @@
+import assert from "node:assert";
+import { test } from "node:test";
+import { Toast, useToast } from "./toast.js";
+
+// Toast uses React hooks (useState, useEffect, useRef) and must be rendered
+// via a React renderer. Direct invocation in node --test is not supported.
+// Tests here verify the module exports correct types only.
+
+test("Toast - exports correctly", () => {
+	assert.strictEqual(typeof Toast, "function");
+});
+
+test("Toast - has expected function name", () => {
+	assert.strictEqual(Toast.name, "Toast");
+});
+
+test("useToast - exports correctly", () => {
+	assert.strictEqual(typeof useToast, "function");
+});
+
+test("useToast - has expected function name", () => {
+	assert.strictEqual(useToast.name, "useToast");
+});

package/templates/{base-project/apps/worker → worker}/package.json

@@ -20,10 +20,10 @@
 		"@techstream/quark-core": "^1.0.0",
 		"@techstream/quark-db": "workspace:*",
 		"@techstream/quark-jobs": "workspace:*",
-		"bullmq": "^5.70.2"
+		"bullmq": "^5.70.4"
 	},
 	"devDependencies": {
-		"@types/node": "^25.3.3",
+		"@types/node": "^25.3.5",
 		"tsx": "^4.21.0"
 	}
 }

package/templates/{base-project/apps/worker → worker}/src/index.js

@@ -9,15 +9,20 @@ import {
 	createLogger,
 	createQueue,
 	createWorker,
+	getRedisUrl,
 } from "@techstream/quark-core";
 import { prisma } from "@techstream/quark-db";
 import { JOB_NAMES, JOB_QUEUES } from "@techstream/quark-jobs";
 import { jobHandlers } from "./handlers/index.js";
 
 const logger = createLogger("worker");
+const isDevMode =
+	process.env.NODE_ENV !== "production" &&
+	process.env.npm_lifecycle_event === "dev";
 
 // Store workers for graceful shutdown
 const workers = [];
+let devDisabledKeepAlive = null;
 let isShuttingDown = false;
 
 // ============================================================================
@@ -40,6 +45,7 @@ export function isConnectionError(error) {
 		"EHOSTUNREACH", // Host unreachable
 		"ENETUNREACH", // Network unreachable
 		"Error: Redis connection failed", // Generic redis failure
+		"Redis unavailable at", // Final wrapped startup error
 		"Ready status is false", // BullMQ readiness
 	];
 	return connectionErrors.some((err) => message.includes(err));
@@ -62,10 +68,8 @@ export function throttledError(logger, windowMs = 5000) {
 
 		// Log if new error type or window expired
 		if (msg !== lastErrorMsg || now - lastErrorTime > windowMs) {
-			logger.error(`Connection error (will retry)`, {
-				error: msg,
-				code: error.code,
-				timestamp: new Date().toISOString(),
+			logger.warn("Waiting for Redis", {
+				reason: msg,
 			});
 			lastErrorTime = now;
 			lastErrorMsg = msg;
@@ -73,6 +77,14 @@ export function throttledError(logger, windowMs = 5000) {
 	};
 }
 
+function disableWorkerInDev() {
+	if (!devDisabledKeepAlive) {
+		// Keep the process alive so the dev session stays healthy even when the
+		// worker is intentionally disabled due to missing Redis.
+		devDisabledKeepAlive = setInterval(() => {}, 60_000);
+	}
+}
+
 /**
  * Waits for Redis to be ready with retries
  * @param {Function} healthCheck - Async function that returns boolean or throws
@@ -91,7 +103,6 @@ export async function waitForRedis(
 	} = config;
 
 	const reportThrottledError = throttledError(logger, 3000);
-	let lastError;
 
 	for (let attempt = 1; attempt <= maxRetries; attempt++) {
 		try {
@@ -103,30 +114,20 @@ export async function waitForRedis(
 				return true;
 			}
 		} catch (error) {
-			lastError = error;
 			if (isConnectionError(error)) {
 				reportThrottledError(error);
 				if (attempt < maxRetries) {
-					// Wait before retrying
 					await new Promise((resolve) => setTimeout(resolve, intervalMs));
 				}
 			} else {
-				// Non-connection error; don't retry
-				logger.error("Health check failed with non-network error", {
-					error: error.message,
-				});
-				throw error;
+				throw new Error(`Redis health check failed: ${error.message}`);
 			}
 		}
 	}
 
 	// All retries exhausted
-	logger.error("Redis health check failed after all retries", {
-		attempts: maxRetries,
-		lastError: lastError?.message,
-	});
 	throw new Error(
-		`Failed to connect to Redis after ${maxRetries} attempts: ${lastError?.message}`,
+		`Redis unavailable at ${getRedisUrl()} after ${maxRetries} attempts. Start Redis or check REDIS_URL/REDIS_HOST/REDIS_PORT.`,
 	);
 }
 
@@ -148,10 +149,7 @@ async function preflight() {
 	try {
 		// Check Redis
 		logger.info("Checking Redis connectivity...");
-		const redisReady = await checkQueueHealth();
-		if (!redisReady) {
-			throw new Error("Redis health check returned false");
-		}
+		await checkQueueHealth();
 		logger.info("✓ Redis connected");
 
 		// Check Database
@@ -256,8 +254,12 @@ async function startWorker() {
 	try {
 		// Pre-flight: Wait for Redis with health checks and retries
 		logger.info("Performing health checks...");
-		await waitForRedis();
+		await waitForRedis(
+			checkQueueHealth,
+			isDevMode ? { maxRetries: 3, intervalMs: 500 } : {},
+		);
 
+		logger.info("Redis connected", { address: getRedisUrl() });
 		// Register a worker for each queue
 		for (const queueName of Object.values(JOB_QUEUES)) {
 			createQueueWorker(queueName);
@@ -276,9 +278,17 @@ async function startWorker() {
 
 		logger.info("Worker service ready");
 	} catch (error) {
+		if (isDevMode && isConnectionError(error)) {
+			logger.warn("Redis unavailable — worker disabled in dev", {
+				action:
+					"Start Redis and restart the worker when background jobs are needed.",
+			});
+			disableWorkerInDev();
+			return;
+		}
+
 		logger.error("Failed to start worker service", {
 			error: error.message,
-			stack: error.stack,
 		});
 		process.exit(1);
 	}
@@ -297,6 +307,11 @@ async function shutdown(signal = "unknown") {
 	logger.info("Shutting down worker service", { signal });
 
 	try {
+		if (devDisabledKeepAlive) {
+			clearInterval(devDisabledKeepAlive);
+			devDisabledKeepAlive = null;
+		}
+
 		for (const worker of workers) {
 			await worker.close();
 		}

package/templates/{base-project/apps/worker → worker}/src/index.test.js

@@ -362,9 +362,9 @@ describe("throttledError", () => {
 
 		throttle(new Error("Redis unavailable"));
 
-		assert.strictEqual(logger.error.mock.callCount(), 1);
-		const call = logger.error.mock.calls[0];
-		assert.ok(call.arguments[0].includes("Connection error"));
+		assert.strictEqual(logger.warn.mock.callCount(), 1);
+		const call = logger.warn.mock.calls[0];
+		assert.ok(call.arguments[0].includes("Waiting for Redis"));
 	});
 
 	test("suppresses duplicate errors within window", () => {
@@ -372,15 +372,15 @@ describe("throttledError", () => {
 		const throttle = throttledError(logger, 100);
 
 		throttle(new Error("Redis unavailable"));
-		assert.strictEqual(logger.error.mock.callCount(), 1);
+		assert.strictEqual(logger.warn.mock.callCount(), 1);
 
 		// Same error within window — should be suppressed
 		throttle(new Error("Redis unavailable"));
-		assert.strictEqual(logger.error.mock.callCount(), 1);
+		assert.strictEqual(logger.warn.mock.callCount(), 1);
 
 		// Different error within window — should log
 		throttle(new Error("Redis timeout"));
-		assert.strictEqual(logger.error.mock.callCount(), 2);
+		assert.strictEqual(logger.warn.mock.callCount(), 2);
 	});
 
 	test("logs error again after window expires", async () => {
@@ -388,18 +388,18 @@ describe("throttledError", () => {
 		const throttle = throttledError(logger, 50); // 50ms window
 
 		throttle(new Error("Redis unavailable"));
-		assert.strictEqual(logger.error.mock.callCount(), 1);
+		assert.strictEqual(logger.warn.mock.callCount(), 1);
 
 		// Same error within window — suppressed
 		throttle(new Error("Redis unavailable"));
-		assert.strictEqual(logger.error.mock.callCount(), 1);
+		assert.strictEqual(logger.warn.mock.callCount(), 1);
 
 		// Wait for window to expire
 		await new Promise((resolve) => setTimeout(resolve, 60));
 
 		// Same error after window — logged again
 		throttle(new Error("Redis unavailable"));
-		assert.strictEqual(logger.error.mock.callCount(), 2);
+		assert.strictEqual(logger.warn.mock.callCount(), 2);
 	});
 
 	test("includes error details in log", () => {
@@ -410,11 +410,10 @@ describe("throttledError", () => {
 		error.code = "ECONNREFUSED";
 		throttle(error);
 
-		const call = logger.error.mock.calls[0];
+		const call = logger.warn.mock.calls[0];
 		const args = call.arguments;
-		assert.strictEqual(args[0], "Connection error (will retry)");
-		assert.ok(args[1].error.includes("ECONNREFUSED"));
-		assert.ok(args[1].timestamp); // Should have timestamp
+		assert.strictEqual(args[0], "Waiting for Redis");
+		assert.ok(args[1].reason.includes("ECONNREFUSED"));
 	});
 
 	test("uses default 5 second window if not specified", async () => {
@@ -422,14 +421,14 @@ describe("throttledError", () => {
 		const throttle = throttledError(logger); // No window specified
 
 		throttle(new Error("Test"));
-		assert.strictEqual(logger.error.mock.callCount(), 1);
+		assert.strictEqual(logger.warn.mock.callCount(), 1);
 
 		throttle(new Error("Test"));
-		assert.strictEqual(logger.error.mock.callCount(), 1); // Suppressed
+		assert.strictEqual(logger.warn.mock.callCount(), 1); // Suppressed
 
 		// 5 second default window hasn't expired
 		throttle(new Error("Test"));
-		assert.strictEqual(logger.error.mock.callCount(), 1); // Still suppressed
+		assert.strictEqual(logger.warn.mock.callCount(), 1); // Still suppressed
 	});
 });
 
@@ -479,7 +478,7 @@ describe("waitForRedis", () => {
 					maxRetries: 2,
 					intervalMs: 10,
 				}),
-			{ message: /Failed to connect to Redis after 2 attempts/ },
+			{ message: /Redis unavailable at .+ after 2 attempts/ },
 		);
 
 		assert.strictEqual(healthCheck.mock.callCount(), 2);
@@ -496,7 +495,7 @@ describe("waitForRedis", () => {
 					maxRetries: 5,
 					intervalMs: 10,
 				}),
-			{ message: "Invalid configuration" },
+			{ message: "Redis health check failed: Invalid configuration" },
 		);
 
 		// Should fail immediately, not retry 5 times
@@ -514,7 +513,7 @@ describe("waitForRedis", () => {
 					maxRetries: 4,
 					intervalMs: 10,
 				}),
-			/Failed to connect to Redis after 4 attempts/,
+			/Redis unavailable at .+ after 4 attempts/,
 		);
 
 		assert.strictEqual(healthCheck.mock.callCount(), 4);
@@ -565,7 +564,7 @@ describe("waitForRedis", () => {
 			// Call without explicit config — should use env defaults
 			await assert.rejects(
 				() => waitForRedis(healthCheck),
-				/Failed to connect to Redis after 2 attempts/,
+				/Redis unavailable at .+ after 2 attempts/,
 			);
 
 			assert.strictEqual(healthCheck.mock.callCount(), 2);

package/templates/base-project/apps/web/public/file.svg

@@ -1 +0,0 @@
-<svg fill="none" viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg"><path d="M14.5 13.5V5.41a1 1 0 0 0-.3-.7L9.8.29A1 1 0 0 0 9.08 0H1.5v13.5A2.5 2.5 0 0 0 4 16h8a2.5 2.5 0 0 0 2.5-2.5m-1.5 0v-7H8v-5H3v12a1 1 0 0 0 1 1h8a1 1 0 0 0 1-1M9.5 5V2.12L12.38 5zM5.13 5h-.62v1.25h2.12V5zm-.62 3h7.12v1.25H4.5zm.62 3h-.62v1.25h7.12V11z" clip-rule="evenodd" fill="#666" fill-rule="evenodd"/></svg>

package/templates/base-project/apps/web/public/globe.svg

@@ -1 +0,0 @@
-<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><g clip-path="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M10.27 14.1a6.5 6.5 0 0 0 3.67-3.45q-1.24.21-2.7.34-.31 1.83-.97 3.1M8 16A8 8 0 1 0 8 0a8 8 0 0 0 0 16m.48-1.52a7 7 0 0 1-.96 0H7.5a4 4 0 0 1-.84-1.32q-.38-.89-.63-2.08a40 40 0 0 0 3.92 0q-.25 1.2-.63 2.08a4 4 0 0 1-.84 1.31zm2.94-4.76q1.66-.15 2.95-.43a7 7 0 0 0 0-2.58q-1.3-.27-2.95-.43a18 18 0 0 1 0 3.44m-1.27-3.54a17 17 0 0 1 0 3.64 39 39 0 0 1-4.3 0 17 17 0 0 1 0-3.64 39 39 0 0 1 4.3 0m1.1-1.17q1.45.13 2.69.34a6.5 6.5 0 0 0-3.67-3.44q.65 1.26.98 3.1M8.48 1.5l.01.02q.41.37.84 1.31.38.89.63 2.08a40 40 0 0 0-3.92 0q.25-1.2.63-2.08a4 4 0 0 1 .85-1.32 7 7 0 0 1 .96 0m-2.75.4a6.5 6.5 0 0 0-3.67 3.44 29 29 0 0 1 2.7-.34q.31-1.83.97-3.1M4.58 6.28q-1.66.16-2.95.43a7 7 0 0 0 0 2.58q1.3.27 2.95.43a18 18 0 0 1 0-3.44m.17 4.71q-1.45-.12-2.69-.34a6.5 6.5 0 0 0 3.67 3.44q-.65-1.27-.98-3.1" fill="#666"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h16v16H0z"/></clipPath></defs></svg>

package/templates/base-project/apps/web/public/next.svg

@@ -1 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 394 80"><path fill="#000" d="M262 0h68.5v12.7h-27.2v66.6h-13.6V12.7H262V0ZM149 0v12.7H94v20.4h44.3v12.6H94v21h55v12.6H80.5V0h68.7zm34.3 0h-17.8l63.8 79.4h17.9l-32-39.7 32-39.6h-17.9l-23 28.6-23-28.6zm18.3 56.7-9-11-27.1 33.7h17.8l18.3-22.7z"/><path fill="#000" d="M81 79.3 17 0H0v79.3h13.6V17l50.2 62.3H81Zm252.6-.4c-1 0-1.8-.4-2.5-1s-1.1-1.6-1.1-2.6.3-1.8 1-2.5 1.6-1 2.6-1 1.8.3 2.5 1a3.4 3.4 0 0 1 .6 4.3 3.7 3.7 0 0 1-3 1.8zm23.2-33.5h6v23.3c0 2.1-.4 4-1.3 5.5a9.1 9.1 0 0 1-3.8 3.5c-1.6.8-3.5 1.3-5.7 1.3-2 0-3.7-.4-5.3-1s-2.8-1.8-3.7-3.2c-.9-1.3-1.4-3-1.4-5h6c.1.8.3 1.6.7 2.2s1 1.2 1.6 1.5c.7.4 1.5.5 2.4.5 1 0 1.8-.2 2.4-.6a4 4 0 0 0 1.6-1.8c.3-.8.5-1.8.5-3V45.5zm30.9 9.1a4.4 4.4 0 0 0-2-3.3 7.5 7.5 0 0 0-4.3-1.1c-1.3 0-2.4.2-3.3.5-.9.4-1.6 1-2 1.6a3.5 3.5 0 0 0-.3 4c.3.5.7.9 1.3 1.2l1.8 1 2 .5 3.2.8c1.3.3 2.5.7 3.7 1.2a13 13 0 0 1 3.2 1.8 8.1 8.1 0 0 1 3 6.5c0 2-.5 3.7-1.5 5.1a10 10 0 0 1-4.4 3.5c-1.8.8-4.1 1.2-6.8 1.2-2.6 0-4.9-.4-6.8-1.2-2-.8-3.4-2-4.5-3.5a10 10 0 0 1-1.7-5.6h6a5 5 0 0 0 3.5 4.6c1 .4 2.2.6 3.4.6 1.3 0 2.5-.2 3.5-.6 1-.4 1.8-1 2.4-1.7a4 4 0 0 0 .8-2.4c0-.9-.2-1.6-.7-2.2a11 11 0 0 0-2.1-1.4l-3.2-1-3.8-1c-2.8-.7-5-1.7-6.6-3.2a7.2 7.2 0 0 1-2.4-5.7 8 8 0 0 1 1.7-5 10 10 0 0 1 4.3-3.5c2-.8 4-1.2 6.4-1.2 2.3 0 4.4.4 6.2 1.2 1.8.8 3.2 2 4.3 3.4 1 1.4 1.5 3 1.5 5h-5.8z"/></svg>

package/templates/base-project/apps/web/public/vercel.svg

@@ -1 +0,0 @@
-<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1155 1000"><path d="m577.3 0 577.4 1000H0z" fill="#fff"/></svg>

package/templates/base-project/apps/web/public/window.svg

@@ -1 +0,0 @@
-<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M1.5 2.5h13v10a1 1 0 0 1-1 1h-11a1 1 0 0 1-1-1zM0 1h16v11.5a2.5 2.5 0 0 1-2.5 2.5h-11A2.5 2.5 0 0 1 0 12.5zm3.75 4.5a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5M7 4.75a.75.75 0 1 1-1.5 0 .75.75 0 0 1 1.5 0m1.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5" fill="#666"/></svg>