refactor: improve shutdown cleanup

apps/server/src/utils/withTimeout.ts

@@ -0,0 +1,15 @@
+/**
+ * Resolves or rejects with the provided promise, but fails if it does not settle within `timeoutMs`.
+ */
+export const withTimeout = <T>(promise: Promise<T>, timeoutMs: number): Promise<T> => {
+  let timer: NodeJS.Timeout | null = null;
+  const timeout = new Promise<T>((_, reject) => {
+    timer = setTimeout(() => reject(new Error('Operation timed out')), timeoutMs);
+  });
+
+  return Promise.race([promise, timeout]).finally(() => {
+    if (timer) {
+      clearTimeout(timer);
+    }
+  });
+};