From 4087c3832a99e75d4b4691d7d7a3960523a57d21 Mon Sep 17 00:00:00 2001
From: Angel1945uwu <97724347+Angel1945uwu@users.noreply.github.com>
Date: Thu, 29 Jan 2026 19:59:43 +0100
Subject: [PATCH] tools: add runtime config sanity check helper

Added a small utility to validate required runtime configuration values early, preventing silent misconfiguration errors at startup.
---
 packages/utils/src/runtimeConfigCheck.ts | 26 ++++++++++++++++++++++++
 1 file changed, 26 insertions(+)
 create mode 100644 packages/utils/src/runtimeConfigCheck.ts

diff --git a/packages/utils/src/runtimeConfigCheck.ts b/packages/utils/src/runtimeConfigCheck.ts
new file mode 100644
index 00000000000..311e204c1e0
--- /dev/null
+++ b/packages/utils/src/runtimeConfigCheck.ts
@@ -0,0 +1,26 @@
+export type RuntimeConfigRequirement = {
+  key: string;
+  description: string;
+};
+
+export function assertRuntimeConfig(
+  config: Record<string, unknown>,
+  required: RuntimeConfigRequirement[],
+): void {
+  const missing: string[] = [];
+
+  for (const item of required) {
+    const value = config[item.key];
+    if (value === undefined || value === null || value === '') {
+      missing.push(`${item.key} (${item.description})`);
+    }
+  }
+
+  if (missing.length > 0) {
+    const message =
+      'Missing required runtime configuration values:\n' +
+      missing.map((m) => `- ${m}`).join('\n');
+
+    throw new Error(message);
+  }
+}