@networkpro/web 1.25.0 → 1.25.1

package/CHANGELOG.md

@@ -22,6 +22,33 @@ This project attempts to follow [Keep a Changelog](https://keepachangelog.com/en
 
 ---
 
+## [1.25.1]
+
+### Added
+
+- Introduced new **environment diagnostics endpoint** at `src/routes/api/env-check/+server.js`.
+  - Returns resolved build and runtime environment data for verification.
+  - Useful for confirming `ENV_MODE` / `PUBLIC_ENV_MODE` propagation on Vercel builds.
+  - Helps troubleshoot environment mismatches between build-time and client-side contexts.
+
+### Changed
+
+- **vite.config.js**
+  - Enhanced configuration to log build mode and environment variables during bundling.
+  - Prints `mode`, `ENV_MODE`, `PUBLIC_ENV_MODE`, and `NODE_ENV` to aid CI/CD debugging.
+  - Uses color-coded console output for clear visibility in build logs.
+- **env.js**
+  - Simplified and stabilized environment detection logic for better cross-environment consistency.
+  - Removed redundant imports and corrected handling of static vs dynamic `BUILD_ENV_MODE`.
+  - Improved comments and type annotations for maintainability and IDE autocompletion.
+
+### Developer Experience
+
+- Build logs now clearly display environment information before bundling.
+- `env-check` API endpoint provides real-time environment inspection without rebuilding.
+
+---
+
 ## [1.25.0]
 
 ### Added
@@ -1583,7 +1610,8 @@ This enables analytics filtering and CSP hardening for the audit environment.
 
 <!-- Link references -->
 
-[Unreleased]: https://github.com/netwk-pro/netwk-pro.github.io/compare/v1.25.0...HEAD
+[Unreleased]: https://github.com/netwk-pro/netwk-pro.github.io/compare/v1.25.1...HEAD
+[1.25.1]: https://github.com/netwk-pro/netwk-pro.github.io/releases/tag/v1.25.1
 [1.25.0]: https://github.com/netwk-pro/netwk-pro.github.io/releases/tag/v1.25.0
 [1.24.5]: https://github.com/netwk-pro/netwk-pro.github.io/releases/tag/v1.24.5
 [1.24.4]: https://github.com/netwk-pro/netwk-pro.github.io/releases/tag/v1.24.4

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@networkpro/web",
   "private": false,
-  "version": "1.25.0",
+  "version": "1.25.1",
   "description": "Locking Down Networks, Unlocking Confidence™ | Security, Networking, Privacy — Network Pro Strategies",
   "keywords": [
     "advisory",

package/src/hooks.server.js

@@ -14,9 +14,9 @@ import { detectEnvironment } from '$lib/utils/env.js';
  */
 export async function handle({ event, resolve }) {
   const response = await resolve(event);
-  const { isAudit, isTest, isProd } = detectEnvironment();
 
-  console.log('[CSP Debug ENV]', detectEnvironment());
+  const { isAudit, isTest, isProd, effective, mode } = detectEnvironment();
+  console.log('[CSP Debug ENV]', { mode, effective, isProd, isAudit, isTest });
 
   // Determine report URI
   const reportUri =

package/src/lib/stores/posthog.js

@@ -45,15 +45,28 @@ let ph = null;
 export async function initPostHog() {
   if (initialized || typeof window === 'undefined') return;
 
-  const { isAudit, isDev, isTest, mode } = detectEnvironment();
+  const { isAudit, isDev, isTest, mode, effective } = detectEnvironment();
 
   // 🌐 Hybrid hostname + environment guard
   const host = window.location.hostname;
   const isAuditHost = /(^|\.)audit\.netwk\.pro$/i.test(host);
   const effectiveAudit = isAudit || isAuditHost;
 
+  // 🧭 Log environment context before any conditional logic
+  console.info('[PostHog ENV]', {
+    buildMode: mode,
+    effectiveMode: effective,
+    host,
+    effectiveAudit,
+    isDev,
+    isTest,
+  });
+
+  // 🚫 Skip analytics in audit context
   if (effectiveAudit) {
-    console.info(`[PostHog] Skipping analytics (${mode} mode, host: ${host}).`);
+    console.info(
+      `[PostHog] Skipping analytics (${effective} mode, host: ${host}).`,
+    );
     return;
   }
 

package/src/lib/utils/env.js

@@ -26,49 +26,56 @@ This file is part of Network Pro.
 
 /**
  * @typedef {object} EnvironmentInfo
- * @property {string} mode - The detected environment mode (`dev`, `prod`, `audit`, etc.).
- * @property {boolean} isDev - True when running in a development or local environment.
- * @property {boolean} isProd - True when running in production.
- * @property {boolean} isAudit - True when running in audit / staging environments.
- * @property {boolean} isCI - True when running in continuous integration (CI) pipelines.
- * @property {boolean} isTest - True when running under test or mock environments.
+ * @property {string} mode        - The build-time environment mode.
+ * @property {string} effective   - The environment actually being used (after host fallback).
+ * @property {boolean} isDev
+ * @property {boolean} isProd
+ * @property {boolean} isAudit
+ * @property {boolean} isCI
+ * @property {boolean} isTest
  */
 
 /**
- * Normalizes environment detection across client, SSR, and build contexts.
- * Uses `import.meta.env` for Vite build-time vars and `process.env` for runtime vars.
+ * Build-time mode injected by Vite.
+ * Always baked into the client bundle.
+ * Falls back to 'production' if nothing else is defined.
+ */
+export const BUILD_ENV_MODE =
+  import.meta.env.PUBLIC_ENV_MODE || import.meta.env.MODE || 'production';
+
+/**
+ * Detects the current environment, combining build-time
+ * and runtime (hostname-based) checks.
+ * Works safely in both Node and browser contexts.
  *
- * @returns {EnvironmentInfo} Normalized environment context flags.
+ * @returns {EnvironmentInfo}
  */
 export function detectEnvironment() {
-  /** @type {string | undefined} */
-  const viteMode = import.meta.env?.MODE;
-  /** @type {string | undefined} */
-  const publicEnvMode = import.meta.env?.PUBLIC_ENV_MODE;
+  const mode = BUILD_ENV_MODE;
+
+  // Client-side fallback for audit/netwk environments
+  const host = typeof window !== 'undefined' ? window.location.hostname : '';
+
+  const hostIsAudit = /(^|\.)audit\.netwk\.pro$/i.test(host);
 
-  /** @type {string | undefined} */
-  const nodeEnv =
-    typeof process !== 'undefined' && process?.env?.NODE_ENV
-      ? process.env.NODE_ENV
-      : undefined;
+  const isDev = ['development', 'dev'].includes(mode);
+  const isProd = ['production', 'prod'].includes(mode);
+  const isAudit = mode === 'audit' || hostIsAudit;
+  const isCI = mode === 'ci';
+  const isTest = mode === 'test';
 
-  /** @type {string | undefined} */
-  const envMode =
-    typeof process !== 'undefined' && process?.env?.ENV_MODE
-      ? process.env.ENV_MODE
-      : undefined;
+  // Prefer host-based detection if it disagrees with build-time
+  const effective = hostIsAudit && !isAudit ? 'audit(host)' : mode;
 
-  // Fallback order — guarantees a mode string even if nothing is set
-  /** @type {string} */
-  const mode = envMode || publicEnvMode || viteMode || nodeEnv || 'unknown';
+  if (typeof window === 'undefined') {
+    // Only log on server / build to avoid client noise
+    console.log('[detectEnvironment] Build mode:', mode);
+    if (hostIsAudit && mode !== 'audit') {
+      console.log(
+        '[detectEnvironment] Host suggests audit, overriding build-time mode.',
+      );
+    }
+  }
 
-  // Return a normalized, typed object
-  return {
-    mode,
-    isDev: ['development', 'dev'].includes(mode),
-    isProd: ['production', 'prod'].includes(mode),
-    isAudit: mode === 'audit',
-    isCI: mode === 'ci',
-    isTest: mode === 'test',
-  };
+  return { mode, effective, isDev, isProd, isAudit, isCI, isTest };
 }

package/src/routes/api/env-check/+server.js

@@ -0,0 +1,25 @@
+/* ==========================================================================
+src/routes/api/env-check/+server.js
+
+Copyright © 2025 Network Pro Strategies (Network Pro™)
+SPDX-License-Identifier: CC-BY-4.0 OR GPL-3.0-or-later
+This file is part of Network Pro.
+========================================================================== */
+
+/**
+ * @file Returns the current environment state (client + server vars)
+ * @type {import('@sveltejs/kit').RequestHandler}
+ */
+export async function GET() {
+  const data = {
+    NODE_ENV: process.env.NODE_ENV,
+    ENV_MODE: process.env.ENV_MODE,
+    PUBLIC_ENV_MODE: process.env.PUBLIC_ENV_MODE,
+    IMPORT_META_MODE: import.meta.env.MODE,
+    IMPORT_META_PUBLIC: import.meta.env.PUBLIC_ENV_MODE,
+  };
+
+  return new Response(JSON.stringify(data, null, 2), {
+    headers: { 'Content-Type': 'application/json' },
+  });
+}

package/vite.config.js

@@ -17,20 +17,42 @@ import tsconfigPaths from 'vite-tsconfig-paths'; // NEW: tsconfig/jsconfig alias
 // Compute absolute project root
 const projectRoot = fileURLToPath(new URL('.', import.meta.url));
 
-export default defineConfig({
-  plugins: [
-    tsconfigPaths(), // Insert before sveltekit()
-    devtoolsJson({
-      projectRoot: resolve(projectRoot), // Correct key name
-      normalizeForWindowsContainer: true, // optional, helps with path consistency on Windows or WSL
-      uuid: 'ad0db4f4-6172-4c1e-ae17-26b1bee53764',
-    }),
-    sveltekit(),
-    lightningcssPlugin({
-      minify: process.env.NODE_ENV === 'production',
-      pruneUnusedFontFaceRules: true,
-      pruneUnusedKeyframes: true,
-      removeUnusedFontFaces: true,
-    }),
-  ],
+export default defineConfig(({ mode }) => {
+  // --- 🧩 Log Build Environment Info -------------------------------------
+  console.log(
+    '\x1b[36m%s\x1b[0m',
+    '──────────────────────────────────────────────',
+  );
+  console.log('\x1b[33m%s\x1b[0m', `📦 Building Network Pro — mode: ${mode}`);
+  console.log(
+    '\x1b[36m%s\x1b[0m',
+    '──────────────────────────────────────────────',
+  );
+  console.log('ENV_MODE:', process.env.ENV_MODE);
+  console.log('PUBLIC_ENV_MODE:', process.env.PUBLIC_ENV_MODE);
+  console.log('NODE_ENV:', process.env.NODE_ENV);
+  console.log(
+    '\x1b[36m%s\x1b[0m',
+    '──────────────────────────────────────────────',
+  );
+
+  // -----------------------------------------------------------------------
+
+  return {
+    plugins: [
+      tsconfigPaths(),
+      devtoolsJson({
+        projectRoot: resolve(projectRoot),
+        normalizeForWindowsContainer: true,
+        uuid: 'ad0db4f4-6172-4c1e-ae17-26b1bee53764',
+      }),
+      sveltekit(),
+      lightningcssPlugin({
+        minify: process.env.NODE_ENV === 'production',
+        pruneUnusedFontFaceRules: true,
+        pruneUnusedKeyframes: true,
+        removeUnusedFontFaces: true,
+      }),
+    ],
+  };
 });