feat: Allow skipping MAIL_HOST environment variable validation during build processes using SKIP_RUNTIME_ENV_VALIDATION.

Dockerfile

@@ -37,7 +37,7 @@ ENV NEXT_PUBLIC_TARGET=$NEXT_PUBLIC_TARGET
 ENV DIRECTUS_URL=$DIRECTUS_URL
 
 # Validate environment variables during build
-RUN npx tsx scripts/validate-env.ts
+RUN SKIP_RUNTIME_ENV_VALIDATION=true npx tsx scripts/validate-env.ts
 
 RUN --mount=type=cache,target=/app/.next/cache npm run build
 

lib/env.test.ts

@@ -57,4 +57,14 @@ describe('envSchema', () => {
     });
     expect(result.success).toBe(true);
   });
+
+  it('should skip MAIL_HOST requirement if SKIP_RUNTIME_ENV_VALIDATION is true', () => {
+    process.env.SKIP_RUNTIME_ENV_VALIDATION = 'true';
+    const result = envSchema.safeParse({
+      NEXT_PUBLIC_BASE_URL: 'https://example.com',
+      TARGET: 'production',
+    });
+    expect(result.success).toBe(true);
+    delete process.env.SKIP_RUNTIME_ENV_VALIDATION;
+  });
 });

lib/env.ts

@@ -57,8 +57,9 @@ export const envSchema = z
   .superRefine((data, ctx) => {
     const target = data.NEXT_PUBLIC_TARGET || data.TARGET;
     const isDev = target === 'development' || !target;
+    const isBuildTimeValidation = process.env.SKIP_RUNTIME_ENV_VALIDATION === 'true';
 
-    if (!isDev && !data.MAIL_HOST) {
+    if (!isDev && !isBuildTimeValidation && !data.MAIL_HOST) {
       ctx.addIssue({
         code: z.ZodIssueCode.custom,
         message: 'MAIL_HOST is required in non-development environments',