Fix dev CI build failures

apps/dashboard/src/instrumentation-node.ts

@@ -0,0 +1,12 @@
+import "server-only";
+
+import { getEnvBoolean } from "@hexclave/shared/dist/utils/env";
+
+export async function startRemoteDevelopmentEnvironmentLifecycleIfNeeded(): Promise<void> {
+  if (!getEnvBoolean("NEXT_PUBLIC_STACK_IS_REMOTE_DEVELOPMENT_ENVIRONMENT")) {
+    return;
+  }
+
+  const { startRemoteDevelopmentEnvironmentLifecycle } = await import("./lib/remote-development-environment/manager");
+  startRemoteDevelopmentEnvironmentLifecycle();
+}

apps/dashboard/src/instrumentation.ts

@@ -1,58 +1,52 @@
 import * as Sentry from "@sentry/nextjs";
-import { getEnvBoolean, getEnvVariable, getNextRuntime, getNodeEnvironment } from "@hexclave/shared/dist/utils/env";
+import { getEnvBoolean, getEnvVariable, getNodeEnvironment } from "@hexclave/shared/dist/utils/env";
 import { sentryBaseConfig } from "@hexclave/shared/dist/utils/sentry";
 import { nicify } from "@hexclave/shared/dist/utils/strings";
 import "./polyfills";
 
-async function startRemoteDevelopmentEnvironmentLifecycleIfNeeded(): Promise<void> {
-  if (getNextRuntime() !== "nodejs" || getEnvVariable("NEXT_PUBLIC_STACK_IS_REMOTE_DEVELOPMENT_ENVIRONMENT", "") !== "true") {
+export async function register(): Promise<void> {
+  if (process.env.NEXT_RUNTIME !== "nodejs" && process.env.NEXT_RUNTIME !== "edge") {
     return;
   }
 
-  const { startRemoteDevelopmentEnvironmentLifecycle } = await import("./lib/remote-development-environment/manager");
-  startRemoteDevelopmentEnvironmentLifecycle();
-}
-
-export async function register() {
-  if (getNextRuntime() === "nodejs") {
+  if (process.env.NEXT_RUNTIME === "nodejs") {
     if (getEnvBoolean("NEXT_PUBLIC_STACK_IS_REMOTE_DEVELOPMENT_ENVIRONMENT")) {
       globalThis.process.title = `Hexclave — Development Server (port ${getEnvVariable("PORT", "?")})`;
     } else {
       globalThis.process.title = `stack-dashboard:${getEnvVariable("NEXT_PUBLIC_HEXCLAVE_PORT_PREFIX", "81")} (node/nextjs)`;
     }
+    const { startRemoteDevelopmentEnvironmentLifecycleIfNeeded } = await import("./instrumentation-node");
     await startRemoteDevelopmentEnvironmentLifecycleIfNeeded();
   }
 
-  if (getNextRuntime() === "nodejs" || getNextRuntime() === "edge") {
-    Sentry.init({
-      ...sentryBaseConfig,
-
-      dsn: getEnvVariable("NEXT_PUBLIC_SENTRY_DSN", ""),
-
-      enabled: getNodeEnvironment() !== "development" && !getEnvVariable("CI", ""),
-
-      // Add exception metadata to the event
-      beforeSend(event, hint) {
-        const error = hint.originalException;
-        let nicified;
-        try {
-          nicified = nicify(error, { maxDepth: 8 });
-        } catch (e) {
-          nicified = `Error occurred during nicification: ${e}`;
-        }
-        if (error instanceof Error) {
-          event.extra = {
-            ...event.extra,
-            cause: error.cause,
-            errorProps: {
-              ...error,
-            },
-            nicifiedError: nicified,
-          };
-        }
-        return event;
-      },
-    });
-
-  }
+  Sentry.init({
+    ...sentryBaseConfig,
+
+    dsn: getEnvVariable("NEXT_PUBLIC_SENTRY_DSN", ""),
+
+    enabled: getNodeEnvironment() !== "development" && !getEnvVariable("CI", ""),
+
+    beforeSend(event, hint) {
+      const error = hint.originalException;
+      let nicified;
+      try {
+        nicified = nicify(error, { maxDepth: 8 });
+      } catch (nicifyError: unknown) {
+        // Only nicify errors are converted to metadata; the original event still reports.
+        const nicifyErrorMessage = nicifyError instanceof Error ? nicifyError.message : String(nicifyError);
+        nicified = `Error occurred during nicification: ${nicifyErrorMessage}`;
+      }
+      if (error instanceof Error) {
+        event.extra = {
+          ...event.extra,
+          cause: error.cause,
+          errorProps: {
+            ...error,
+          },
+          nicifiedError: nicified,
+        };
+      }
+      return event;
+    },
+  });
 }

docs/src/stack.ts

@@ -1,13 +1,24 @@
 import { StackServerApp } from '@hexclave/next';
 import "server-only";
 
+const placeholderPrefix = "#";
+const replaceMePlaceholder = "REPLACE_ME";
+
+function envOrUndefined(value: string | undefined): string | undefined {
+  const normalized = value?.trim().replace(/^["']|["']$/g, "");
+  if (normalized == null || normalized === "" || normalized === replaceMePlaceholder || normalized.startsWith(placeholderPrefix) || normalized.startsWith("$(")) {
+    return undefined;
+  }
+  return normalized;
+}
+
 // Explicitly configure Stack Auth for docs app
 export const stackServerApp = new StackServerApp({
   tokenStore: "nextjs-cookie",
-  projectId: process.env.NEXT_PUBLIC_HEXCLAVE_PROJECT_ID ?? process.env.NEXT_PUBLIC_STACK_PROJECT_ID,
-  publishableClientKey: process.env.NEXT_PUBLIC_HEXCLAVE_PUBLISHABLE_CLIENT_KEY ?? process.env.NEXT_PUBLIC_STACK_PUBLISHABLE_CLIENT_KEY,
-  secretServerKey: process.env.HEXCLAVE_SECRET_SERVER_KEY ?? process.env.STACK_SECRET_SERVER_KEY,
-  baseUrl: process.env.NEXT_PUBLIC_HEXCLAVE_API_URL ?? process.env.NEXT_PUBLIC_STACK_API_URL,
+  projectId: envOrUndefined(process.env.NEXT_PUBLIC_HEXCLAVE_PROJECT_ID) ?? envOrUndefined(process.env.NEXT_PUBLIC_STACK_PROJECT_ID) ?? "internal",
+  publishableClientKey: envOrUndefined(process.env.NEXT_PUBLIC_HEXCLAVE_PUBLISHABLE_CLIENT_KEY) ?? envOrUndefined(process.env.NEXT_PUBLIC_STACK_PUBLISHABLE_CLIENT_KEY),
+  secretServerKey: envOrUndefined(process.env.HEXCLAVE_SECRET_SERVER_KEY) ?? envOrUndefined(process.env.STACK_SECRET_SERVER_KEY) ?? "this-secret-server-key-is-for-local-development-only",
+  baseUrl: envOrUndefined(process.env.NEXT_PUBLIC_HEXCLAVE_API_URL) ?? envOrUndefined(process.env.NEXT_PUBLIC_STACK_API_URL),
   analytics: {
     replays: {
       enabled: true,

packages/template/src/providers/stack-context.tsx

@@ -1,7 +1,7 @@
 "use client";
 
 import React from "react";
-import { createGlobal } from "@stackframe/stack-shared/dist/utils/globals";
+import { createGlobal } from "@hexclave/shared/dist/utils/globals";
 import type { StackClientApp } from "../lib/stack-app/apps/interfaces/client-app";
 
 type StackContextValue = {

packages/template/src/providers/translation-provider-client.tsx

@@ -1,7 +1,7 @@
 "use client";
 
 import React from "react";
-import { createGlobal } from "@stackframe/stack-shared/dist/utils/globals";
+import { createGlobal } from "@hexclave/shared/dist/utils/globals";
 
 type TranslationContextValue = {
   quetzalKeys: Map<string, string>,