Resolve merge conflicts in common.ts with envVars + emulator support

Merge upstream envVars abstraction (replacing raw process.env reads) with local emulator support additions. Add new NEXT_PUBLIC_STACK_LOCAL_EMULATOR_CONFIG_FILE_PATH to envVars.
hexclave · BilalG1 · Apr 14, 2026 · Mar 13, 2026 · Mar 19, 2026 · Apr 9, 2026
commit 51e71cfade528106993adee4241c042b42dd6bd1
diff --git a/packages/template/src/lib/env.ts b/packages/template/src/lib/env.ts
@@ -14,6 +14,9 @@ export const envVars = {
   get STACK_PROJECT_ID() {
     return (typeof process !== "undefined" ? process.env.STACK_PROJECT_ID : undefined) ?? undefined;
   },
+  get NEXT_PUBLIC_STACK_LOCAL_EMULATOR_CONFIG_FILE_PATH() {
+    return (typeof process !== "undefined" ? process.env.NEXT_PUBLIC_STACK_LOCAL_EMULATOR_CONFIG_FILE_PATH : undefined) ?? undefined;
+  },
   get NEXT_PUBLIC_STACK_PUBLISHABLE_CLIENT_KEY() {
     return (typeof process !== "undefined" ? process.env.NEXT_PUBLIC_STACK_PUBLISHABLE_CLIENT_KEY : undefined) ?? undefined;
   },

diff --git a/packages/template/src/lib/stack-app/apps/implementations/common.ts b/packages/template/src/lib/stack-app/apps/implementations/common.ts
@@ -67,7 +67,7 @@ export const LOCAL_EMULATOR_INTERNAL_SECRET_SERVER_KEY = "local-emulator-secret-
 export const LOCAL_EMULATOR_INTERNAL_SUPER_SECRET_ADMIN_KEY = "local-emulator-super-secret-admin-key";
 
 export function getLocalEmulatorConfigFilePath(explicitOption?: string): string | undefined {
-  return explicitOption || process.env.NEXT_PUBLIC_STACK_LOCAL_EMULATOR_CONFIG_FILE_PATH || undefined;
+  return explicitOption || envVars.NEXT_PUBLIC_STACK_LOCAL_EMULATOR_CONFIG_FILE_PATH || undefined;
 }
 
 export function fetchEmulatorProjectCredentials(emulatorConfigFilePath: string): Promise<{
@@ -96,9 +96,9 @@ export function fetchEmulatorProjectCredentials(emulatorConfigFilePath: string):
 
 export function getDefaultProjectId(options?: { isEmulator?: boolean }) {
   if (options?.isEmulator) {
-    return process.env.NEXT_PUBLIC_STACK_PROJECT_ID || process.env.STACK_PROJECT_ID || "internal";
+    return envVars.NEXT_PUBLIC_STACK_PROJECT_ID || envVars.STACK_PROJECT_ID || "internal";
   }
-  return process.env.NEXT_PUBLIC_STACK_PROJECT_ID || process.env.STACK_PROJECT_ID || throwErr(new Error("Welcome to Stack Auth! It seems that you haven't provided a project ID. Please create a project on the Stack dashboard at https://app.stack-auth.com and put it in the NEXT_PUBLIC_STACK_PROJECT_ID environment variable."));
+  return envVars.NEXT_PUBLIC_STACK_PROJECT_ID || envVars.STACK_PROJECT_ID || throwErr(new Error("Welcome to Stack Auth! It seems that you haven't provided a project ID. Please create a project on the Stack dashboard at https://app.stack-auth.com and put it in the NEXT_PUBLIC_STACK_PROJECT_ID environment variable."));
 }
 
 export function getDefaultPublishableClientKey() {
@@ -107,16 +107,16 @@ export function getDefaultPublishableClientKey() {
 
 export function getDefaultSecretServerKey(options?: { isEmulator?: boolean }) {
   if (options?.isEmulator) {
-    return process.env.STACK_SECRET_SERVER_KEY || LOCAL_EMULATOR_INTERNAL_SECRET_SERVER_KEY;
+    return envVars.STACK_SECRET_SERVER_KEY || LOCAL_EMULATOR_INTERNAL_SECRET_SERVER_KEY;
   }
-  return process.env.STACK_SECRET_SERVER_KEY || throwErr(new Error("No secret server key provided. Please copy your key from the Stack dashboard and put it in the STACK_SECRET_SERVER_KEY environment variable."));
+  return envVars.STACK_SECRET_SERVER_KEY || throwErr(new Error("No secret server key provided. Please copy your key from the Stack dashboard and put it in the STACK_SECRET_SERVER_KEY environment variable."));
 }
 
 export function getDefaultSuperSecretAdminKey(options?: { isEmulator?: boolean }) {
   if (options?.isEmulator) {
-    return process.env.STACK_SUPER_SECRET_ADMIN_KEY || LOCAL_EMULATOR_INTERNAL_SUPER_SECRET_ADMIN_KEY;
+    return envVars.STACK_SUPER_SECRET_ADMIN_KEY || LOCAL_EMULATOR_INTERNAL_SUPER_SECRET_ADMIN_KEY;
   }
-  return process.env.STACK_SUPER_SECRET_ADMIN_KEY || throwErr(new Error("No super secret admin key provided. Please copy your key from the Stack dashboard and put it in the STACK_SUPER_SECRET_ADMIN_KEY environment variable."));
+  return envVars.STACK_SUPER_SECRET_ADMIN_KEY || throwErr(new Error("No super secret admin key provided. Please copy your key from the Stack dashboard and put it in the STACK_SUPER_SECRET_ADMIN_KEY environment variable."));
 }
 
 export function getDefaultExtraRequestHeaders() {
@@ -160,7 +160,7 @@ export function getBaseUrl(userSpecifiedBaseUrl: string | { browser: string, ser
     } else {
       url = envVars.NEXT_PUBLIC_SERVER_STACK_API_URL || envVars.NEXT_PUBLIC_STACK_API_URL_SERVER || envVars.STACK_API_URL_SERVER;
     }
-    url = url || process.env.NEXT_PUBLIC_STACK_API_URL || process.env.STACK_API_URL || process.env.NEXT_PUBLIC_STACK_URL || (options?.isEmulator ? localEmulatorBaseUrl : defaultBaseUrl);
+    url = url || envVars.NEXT_PUBLIC_STACK_API_URL || envVars.STACK_API_URL || envVars.NEXT_PUBLIC_STACK_URL || (options?.isEmulator ? localEmulatorBaseUrl : defaultBaseUrl);
   }
 
   return replaceStackPortPrefix(url.endsWith('/') ? url.slice(0, -1) : url);