@networkpro/web 1.10.1 → 1.11.0

package/cspell.json

@@ -30,6 +30,7 @@
     "linksheet",
     "Maricopa",
     "mdsvex",
+    "navigations",
     "neteng",
     "netpro",
     "netwk",
@@ -43,6 +44,8 @@
     "ntfy",
     "obtainium",
     "posthog",
+    "prefs",
+    "reconsent",
     "SIEM",
     "SPDY",
     "stylelintignore",

package/jsconfig.json

@@ -1,11 +1,3 @@
-/* =========================================================================
-jsconfig.json
-
-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.
-========================================================================= */
-
 {
   "extends": "./.svelte-kit/tsconfig.json",
   "compilerOptions": {
@@ -19,12 +11,6 @@ This file is part of Network Pro.
     "strict": true,
     "moduleResolution": "bundler"
   },
-  "exclude": ["vite.config.js"], // Exclude the config file if needed
+  "exclude": ["vite.config.js"],
   "include": ["src", "src/global.d.ts", "src/service-worker.js"]
-
-  // Path aliases are handled by https://svelte.dev/docs/kit/configuration#alias
-  // except $lib which is handled by https://svelte.dev/docs/kit/configuration#files
-
-  // If you want to overwrite includes/excludes, make sure to copy over the relevant includes/excludes
-  // from the referenced tsconfig.json - TypeScript does not merge them in
 }

package/jsconfig.template.jsonc

@@ -0,0 +1,32 @@
+/* =========================================================================
+jsconfig.template.jsonc
+
+NOTE: This file is for reference only and is not actively used by SvelteKit or tooling. SvelteKit uses the jsconfig.json file without comments for actual configuration.
+
+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.
+========================================================================= */
+
+{
+  "extends": "./.svelte-kit/tsconfig.json",
+  "compilerOptions": {
+    "allowJs": true,
+    "checkJs": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "skipLibCheck": true,
+    "sourceMap": true,
+    "strict": true,
+    "moduleResolution": "bundler"
+  },
+  "exclude": ["vite.config.js"], // Exclude the config file if needed
+  "include": ["src", "src/global.d.ts", "src/service-worker.js"]
+
+  // Path aliases are handled by https://svelte.dev/docs/kit/configuration#alias
+  // except $lib which is handled by https://svelte.dev/docs/kit/configuration#files
+
+  // If you want to overwrite includes/excludes, make sure to copy over the relevant includes/excludes
+  // from the referenced tsconfig.json - TypeScript does not merge them in
+}

package/netlify.toml

@@ -1,6 +1,5 @@
 [build]
   command = "npm run build"
-  publish = "build"
 
 [build.environment]
   NODE_VERSION = "22"

package/package.json

@@ -1,10 +1,7 @@
 {
   "name": "@networkpro/web",
   "private": false,
-  "sideEffects": [
-    "./.netlify/shims.js"
-  ],
-  "version": "1.10.1",
+  "version": "1.11.0",
   "description": "Locking Down Networks, Unlocking Confidence | Security, Networking, Privacy — Network Pro Strategies",
   "keywords": [
     "advisory",
@@ -47,6 +44,8 @@
     "prepare": "svelte-kit sync || echo ''",
     "check": "svelte-kit sync && svelte-check --tsconfig ./jsconfig.json",
     "check:watch": "svelte-kit sync && svelte-check --tsconfig ./jsconfig.json --watch",
+    "type-check": "svelte-check --tsconfig ./jsconfig.json",
+    "lint:types": "npm run type-check",
     "check:env": "node scripts/checkEnv.js",
     "check:node": "node scripts/checkNode.js",
     "checkout": "npm run check:node && npm run test:all && npm run lint:all && npm run check",
@@ -78,7 +77,7 @@
   },
   "dependencies": {
     "dompurify": "^3.2.6",
-    "posthog-js": "^1.249.1",
+    "posthog-js": "^1.249.2",
     "semver": "^7.7.2",
     "svelte": "5.33.14"
   },
@@ -88,11 +87,11 @@
     "@lhci/cli": "^0.14.0",
     "@playwright/test": "^1.52.0",
     "@sveltejs/adapter-netlify": "^5.0.2",
-    "@sveltejs/kit": "2.21.1",
-    "@sveltejs/vite-plugin-svelte": "5.0.3",
+    "@sveltejs/kit": "2.21.2",
+    "@sveltejs/vite-plugin-svelte": "5.1.0",
     "@testing-library/jest-dom": "^6.6.3",
     "@testing-library/svelte": "^5.2.8",
-    "@vitest/coverage-v8": "^3.2.0",
+    "@vitest/coverage-v8": "^3.2.1",
     "autoprefixer": "^10.4.21",
     "browserslist": "^4.25.0",
     "eslint": "^9.28.0",
@@ -119,7 +118,8 @@
     "typescript": "^5.8.3",
     "vite": "^6.3.5",
     "vite-plugin-lightningcss": "^0.0.5",
-    "vitest": "^3.2.0"
+    "vite-tsconfig-paths": "^5.1.4",
+    "vitest": "^3.2.1"
   },
   "overrides": {
     "@sveltejs/kit": {

package/src/app.html

@@ -72,7 +72,7 @@
       content="bx4ham0zkpvzztzu213bhpt76m9siq" />
     <!-- cspell:enable -->
 
-    <meta name="generator" content="SvelteKit 2.21.1" />
+    <meta name="generator" content="SvelteKit 2.21.2" />
 
     <script src="/disableSw.js"></script>
 

package/src/hooks.server.js

@@ -91,3 +91,16 @@ export async function handle({ event, resolve }) {
 
   return response;
 }
+
+/**
+ * SvelteKit server-side error handler to log SSR errors.
+ * @type {import('@sveltejs/kit').HandleServerError}
+ */
+export function handleError({ error, event }) {
+  console.error("🔴 SSR Error in route:", event.url.pathname);
+  console.error(error);
+
+  return {
+    message: "A server-side error occurred",
+  };
+}

package/src/lib/components/Badges.svelte

@@ -10,10 +10,15 @@ This file is part of Network Pro.
   import { base } from "$app/paths";
   // Import badges for licenses
   import { ccBadge, gplBadge } from "$lib";
+  import { CONSTANTS } from "$lib";
 
   // Log the base path to verify its value
   //console.log("Base path:", base);
 
+  console.log(CONSTANTS.COMPANY_INFO.APP_NAME);
+
+  const { PAGE } = CONSTANTS;
+
   const ccbyLink = `${base}/license#cc-by`;
   const gplLink = `${base}/license#gnu-gpl`;
 
@@ -51,14 +56,13 @@ This file is part of Network Pro.
 </script>
 
 <!-- BEGIN BADGES -->
-<!-- Updated 2025-05-15 02:12:35 by SunDevil311 -->
 <div class="bnav2-wrap">
   <table class="bnav2">
     <tbody>
       <tr>
         {#each badges as badge}
           <td class="bnav2-nav">
-            <a href={badge.href} target="_self">
+            <a href={badge.href} target={PAGE.SELF}>
               <img
                 decoding="async"
                 loading="lazy"

package/src/lib/components/LegalNav.svelte

@@ -8,10 +8,15 @@ This file is part of Network Pro.
 
 <script>
   import { base } from "$app/paths";
+  import { CONSTANTS } from "$lib";
 
   // Log the base path to verify its value
   //console.log("Base path:", base);
 
+  console.log(CONSTANTS.COMPANY_INFO.APP_NAME);
+
+  const { PAGE } = CONSTANTS;
+
   const termsLink = `${base}/terms-of-use`;
   const privacyLink = `${base}/privacy`;
   const licenseLink = `${base}/license`;
@@ -62,7 +67,7 @@ This file is part of Network Pro.
           <tr>
             {#each row as link}
               <td class="bnav-cell" colspan={link.colspan || 1}>
-                <a href={link.href} target="_self">
+                <a href={link.href} target={PAGE.SELF}>
                   {link.text}
                 </a>
               </td>

package/src/lib/components/MetaTags.svelte

@@ -10,10 +10,16 @@ This file is part of Network Pro.
   export let title;
   export let description;
 
+  import { CONSTANTS } from "$lib";
+
+  console.log(CONSTANTS.COMPANY_INFO.APP_NAME);
+
+  const { COMPANY_INFO, LINKS } = CONSTANTS;
+
   // Static shared values
-  const ogUrl = "https://netwk.pro";
+  const ogUrl = LINKS.HOME;
   const ogImg = "/img/banner-og-1200x630.png";
-  const companyName = "Network Pro Strategies";
+  const companyName = COMPANY_INFO.NAME;
   const twitterAct = "@NetEng_Pro";
 </script>
 

package/src/lib/components/layout/Footer.svelte

@@ -149,14 +149,13 @@ This file is part of Network Pro.
       {:else}
         <a href={license.url} target={PAGE.SELF} rel={relLicense}>
           <strong>{license.type}</strong>
-        </a>
-        , as published by the
+        </a>, as published by the
         <a rel={PAGE.REL} href={license.externalUrl} target={PAGE.BLANK}
           >{license.description}</a
-        >, either version 3 of the License, or (at your option) any later
+        >, either version 3 of the License or (at your option) any later
         version.
       {/if}
-      {index < licenses.length - 1 ? ", and the " : ""}
+      {index < licenses.length - 1 ? " and the " : ""}
     {/each}
   </p>
 </div>

package/src/lib/index.js

@@ -13,7 +13,7 @@ This file is part of Network Pro.
  * @description Main export point for library components, utilities, and assets
  * @module src/lib
  * @author SunDevil311
- * @updated 2025-06-02
+ * @updated 2025-06-03
  */
 
 // Re-export images from dedicated images.js file
@@ -32,38 +32,8 @@ export * from "./images.js";
 // export { default as Button } from './components/Button.svelte';
 // export { default as Card } from './components/Card.svelte';
 
-/**
- * @typedef {{
- *   NAME: string,
- *   APP_NAME: string,
- *   YEAR: string
- * }} CompanyInfo
- *
- * @typedef {{
- *   EMAIL: string,
- *   SECURE: string,
- *   PRIVACY: string,
- *   PHONE: string
- * }} ContactInfo
- *
- * @typedef {{
- *   BLANK: string,
- *   SELF: string,
- *   REL: string
- * }} PageTargets
- *
- * @typedef {{
- *   BACKTOP: string,
- *   HREFTOP: string
- * }} NavigationLabels
- *
- * @typedef {{
- *   COMPANY_INFO: CompanyInfo,
- *   CONTACT: ContactInfo,
- *   PAGE: PageTargets,
- *   NAV: NavigationLabels
- * }} AppConstants
- */
+/** @typedef {import('./types/appConstants.js').AppConstants} AppConstants */
+
 
 /** @type {AppConstants} */
 export const CONSTANTS = {
@@ -87,4 +57,8 @@ export const CONSTANTS = {
     BACKTOP: "Back to top",
     HREFTOP: "#top",
   },
+  LINKS: {
+    HOME: "https://netwk.pro",
+    BLOG: "https://blog.netwk.pro",
+  },
 };

package/src/lib/pages/PrivacyContent.svelte

@@ -9,43 +9,45 @@ This file is part of Network Pro.
 <script>
   import { base } from "$app/paths";
   import { onMount } from "svelte";
-  import { getTrackingPreferences } from "$lib/utils/trackingStatus.js";
-  /** @type {(type: 'enable' | 'disable') => void} */
+  import { trackingStatus } from "$lib/stores/trackingStatus.js";
   import {
+    /** @type {(type: 'enable' | 'disable') => void} */
     setTrackingPreference,
+    /** @type {() => void} */
     clearTrackingPreferences,
   } from "$lib/utils/trackingCookies.js";
   import { CONSTANTS } from "$lib";
 
-  // Log the base path to verify its value
-  //console.log("Base path:", base);
-
   console.log(CONSTANTS.COMPANY_INFO.APP_NAME);
 
-  const { COMPANY_INFO, CONTACT, PAGE, NAV } = CONSTANTS;
+  /** @type {typeof CONSTANTS.COMPANY_INFO} */
+  const COMPANY_INFO = CONSTANTS.COMPANY_INFO;
 
-  /**
-   * URL to the Privacy Rights Request Form redirect route, using the base path
-   * URL to the Contact Form redirect route, using the base path
-   * URL to the Privacy Dashboard using the base path
-   * @type {string}
-   */
+  /** @type {typeof CONSTANTS.CONTACT} */
+  const CONTACT = CONSTANTS.CONTACT;
+
+  /** @type {typeof CONSTANTS.PAGE} */
+  const PAGE = CONSTANTS.PAGE;
+
+  /** @type {typeof CONSTANTS.NAV} */
+  const NAV = CONSTANTS.NAV;
+
+  /** @type {string} */
   const prightsLink = `${base}/privacy-rights`;
+
+  /** @type {string} */
   const contactLink = `${base}/contact`;
+
+  /** @type {string} */
   const pdashLink = `${base}/privacy-dashboard`;
 
-  /**
-   * URL to the privacy policy in Markdown format
-   * External URL to the GPC website
-   * @type {string}
-   */
+  /** @type {string} */
   const privacyLink = "https://docs.netwk.pro/privacy";
+
+  /** @type {string} */
   const gpcLink = "https://globalprivacycontrol.org/";
 
-  /**
-   * Table of Contents Links
-   * @type {{ id: string, text: string }[]}
-   */
+  /** @type {{ id: string, text: string }[]} */
   const tocLinks = [
     { id: "intro", text: "Introduction" },
     { id: "collect", text: "Information We Collect" },
@@ -67,21 +69,41 @@ This file is part of Network Pro.
   /** @type {string} */
   const classSmall = "small-text";
 
+  /** @type {boolean} */
   let optedOut = false;
+
+  /** @type {boolean} */
   let optedIn = false;
-  let trackingStatus = "";
 
-  onMount(() => {
-    const prefs = getTrackingPreferences();
+  /**
+   * Refreshes tracking preferences state and updates the reactive store.
+   * This function uses dynamic import to avoid SSR evaluation of browser-only code.
+   *
+   * @returns {Promise<void>}
+   */
+  async function refreshTrackingStatus() {
+    /** @type {typeof import("$lib/utils/trackingStatus.js")} */
+    const tracking = await import("$lib/utils/trackingStatus.js");
+
+    const prefs = tracking.getTrackingPreferences();
     optedOut = prefs.optedOut;
     optedIn = prefs.optedIn;
-    trackingStatus = prefs.status;
-    console.log("[Tracking] Status:", trackingStatus);
+    trackingStatus.set(prefs.status);
+  }
+
+  /**
+   * Runs tracking preference detection on client mount.
+   */
+  onMount(() => {
+    refreshTrackingStatus();
+    console.log("[Tracking] Status:", $trackingStatus);
   });
 
   /**
-   * Toggle tracking opt-out.
-   * @param {boolean} value
+   * Toggles user tracking opt-out setting and updates cookies + store.
+   *
+   * @param {boolean} value - Whether the user is opting out
+   * @returns {void}
    */
   function toggleTracking(value) {
     optedOut = value;
@@ -92,11 +114,14 @@ This file is part of Network Pro.
       console.log("[Tracking] User cleared opt-out");
       clearTrackingPreferences();
     }
+    refreshTrackingStatus();
   }
 
   /**
-   * Toggle tracking opt-in.
-   * @param {boolean} value
+   * Toggles user tracking opt-in setting and updates cookies + store.
+   *
+   * @param {boolean} value - Whether the user is opting in
+   * @returns {void}
    */
   function toggleOptIn(value) {
     optedIn = value;
@@ -107,6 +132,7 @@ This file is part of Network Pro.
       console.log("[Tracking] User cleared opt-in");
       clearTrackingPreferences();
     }
+    refreshTrackingStatus();
   }
 </script>
 
@@ -241,10 +267,17 @@ This file is part of Network Pro.
       <div class="spacer"></div>
 
       <h3>Tracking Preferences</h3>
-      <p id="tracking-status" aria-live="polite">
-        <strong>Tracking Status:</strong>
-        {trackingStatus}
-      </p>
+      {#if $trackingStatus !== "⏳ Checking tracking preferences..."}
+        <p id="tracking-status" aria-live="polite">
+          <strong>Tracking Status:</strong>
+          {$trackingStatus}
+        </p>
+      {:else}
+        <p id="tracking-status" aria-live="polite">
+          <strong>Tracking Status:</strong>
+          <em>Loading…</em>
+        </p>
+      {/if}
 
       <!-- Opt-out checkbox -->
       <label>
@@ -405,7 +438,7 @@ This file is part of Network Pro.
         For questions, please utilize our <a
           rel={PAGE.REL}
           href={contactLink}
-          target={PAGE.SELF}>Contact Form</a> or contact us directly:
+          target={PAGE.BLANK}>Contact Form</a> or contact us directly:
       </p>
       <p>
         <strong>{COMPANY_INFO.NAME}</strong><br />

package/src/lib/pages/PrivacyDashboard.svelte

@@ -9,52 +9,72 @@ This file is part of Network Pro.
 <script>
   import { base } from "$app/paths";
   import { onMount } from "svelte";
-  import { getTrackingPreferences } from "$lib/utils/trackingStatus.js";
-  /** @type {(type: 'enable' | 'disable') => void} */
+  import { trackingStatus } from "$lib/stores/trackingStatus.js";
   import {
+    /** @type {(type: 'enable' | 'disable') => void} */
     setTrackingPreference,
+    /** @type {() => void} */
     clearTrackingPreferences,
   } from "$lib/utils/trackingCookies.js";
   import { CONSTANTS } from "$lib";
 
-  // Log the base path to verify its value
-  //console.log("Base path:", base);
-
   console.log(CONSTANTS.COMPANY_INFO.APP_NAME);
 
-  const { CONTACT, PAGE, NAV } = CONSTANTS;
+  /** @type {typeof CONSTANTS.CONTACT} */
+  const CONTACT = CONSTANTS.CONTACT;
 
-  /**
-   * @type {string}
-   * Style class for the div element.
-   */
+  /** @type {typeof CONSTANTS.PAGE} */
+  const PAGE = CONSTANTS.PAGE;
+
+  /** @type {typeof CONSTANTS.NAV} */
+  const NAV = CONSTANTS.NAV;
+
+  /** @type {string} */
   const spaceStyle = "spacer";
 
-  /**
-   * URL to the full Privacy Policy using the base path
-   * @type {string}
-   */
+  /** @type {string} */
   const privacyPolicy = `${base}/privacy`;
+
+  /** @type {string} */
   const prightsLink = `${base}/privacy-rights`;
 
   /** @type {string} */
   const classSmall = "small-text";
 
+  /** @type {boolean} */
   let optedOut = false;
+
+  /** @type {boolean} */
   let optedIn = false;
-  let trackingStatus = "";
 
-  onMount(() => {
-    const prefs = getTrackingPreferences();
+  /**
+   * Refreshes tracking preferences state and updates the reactive store.
+   * Uses dynamic import to prevent SSR from loading browser-only dependencies.
+   *
+   * @returns {Promise<void>}
+   */
+  async function refreshTrackingStatus() {
+    /** @type {typeof import("$lib/utils/trackingStatus.js")} */
+    const tracking = await import("$lib/utils/trackingStatus.js");
+
+    const prefs = tracking.getTrackingPreferences();
     optedOut = prefs.optedOut;
     optedIn = prefs.optedIn;
-    trackingStatus = prefs.status;
-    console.log("[Tracking] Status:", trackingStatus);
+    trackingStatus.set(prefs.status);
+  }
+
+  /**
+   * Initializes tracking state on component mount (runs only in browser).
+   */
+  onMount(() => {
+    refreshTrackingStatus();
   });
 
   /**
-   * Toggle tracking opt-out.
-   * @param {boolean} value
+   * Toggles opt-out tracking state, updates cookie and tracking store.
+   *
+   * @param {boolean} value - Whether the user is opting out
+   * @returns {void}
    */
   function toggleTracking(value) {
     optedOut = value;
@@ -65,11 +85,14 @@ This file is part of Network Pro.
       console.log("[Tracking] User cleared opt-out");
       clearTrackingPreferences();
     }
+    refreshTrackingStatus();
   }
 
   /**
-   * Toggle tracking opt-in.
-   * @param {boolean} value
+   * Toggles opt-in tracking state, updates cookie and tracking store.
+   *
+   * @param {boolean} value - Whether the user is opting in
+   * @returns {void}
    */
   function toggleOptIn(value) {
     optedIn = value;
@@ -80,6 +103,7 @@ This file is part of Network Pro.
       console.log("[Tracking] User cleared opt-in");
       clearTrackingPreferences();
     }
+    refreshTrackingStatus();
   }
 </script>
 
@@ -143,10 +167,17 @@ This file is part of Network Pro.
 
   &nbsp;
 
-  <p id="tracking-status" aria-live="polite">
-    <strong>Tracking Status:</strong>
-    {trackingStatus}
-  </p>
+  {#if $trackingStatus !== "⏳ Checking tracking preferences..."}
+    <p id="tracking-status" aria-live="polite">
+      <strong>Tracking Status:</strong>
+      {$trackingStatus}
+    </p>
+  {:else}
+    <p id="tracking-status" aria-live="polite">
+      <strong>Tracking Status:</strong>
+      <em>Loading…</em>
+    </p>
+  {/if}
 
   <!-- Opt-out checkbox -->
   <label>

package/src/lib/stores/posthog.js

@@ -0,0 +1,115 @@
+/* ==========================================================================
+src/lib/stores/posthog.js
+
+Copyright © 2025 Network Pro Strategies (Network Pro™)
+SPDX-License-Identifier: CC-BY-4.0 OR GPL-3.0-or-later
+========================================================================== */
+
+/**
+ * @file posthog.js
+ * @description Privacy-aware PostHog tracking store with reactive state and safe API surface.
+ * @module src/lib/stores
+ */
+
+import {
+  shouldRemindUserToReconsent,
+  shouldTrackUser,
+} from "$lib/utils/privacy.js";
+import { get, writable } from "svelte/store";
+
+/**
+ * Tracks whether tracking is allowed based on cookies, DNT/GPC, and user preference.
+ * @type {import("svelte/store").Writable<boolean>}
+ */
+export const trackingEnabled = writable(false);
+
+/**
+ * Determines if the user should be reminded to re-consent (after 6 months).
+ * @type {import("svelte/store").Writable<boolean>}
+ */
+export const showReminder = writable(false);
+
+/** @type {boolean} Internal one-time init guard */
+let initialized = false;
+
+/** @type {import("posthog-js").PostHog | null} Loaded PostHog instance */
+let ph = null;
+
+/**
+ * Initializes the PostHog analytics client if tracking is permitted.
+ * Uses dynamic import to avoid SSR failures.
+ * @returns {Promise<void>}
+ */
+export async function initPostHog() {
+  if (initialized || typeof window === "undefined") return;
+  initialized = true;
+
+  const allowTracking = shouldTrackUser();
+  trackingEnabled.set(allowTracking);
+  showReminder.set(shouldRemindUserToReconsent());
+
+  if (!allowTracking) {
+    console.log("[PostHog] Tracking is disabled — skipping init.");
+    return;
+  }
+
+  const posthogModule = await import("posthog-js");
+  ph = posthogModule.default;
+
+  // cspell:disable-next-line
+  ph.init("phc_Qshfo6AXzh4pS7aPigfqyeo4qj1qlyh7gDuHDeVMSR0", {
+    api_host: "https://us.i.posthog.com",
+    autocapture: true,
+    capture_pageview: false,
+    person_profiles: "identified_only",
+    loaded: (phInstance) => {
+      if (!allowTracking) {
+        console.log(
+          "[PostHog] ⛔ User opted out — calling opt_out_capturing()",
+        );
+        phInstance.opt_out_capturing();
+      } else {
+        console.log("[PostHog] ✅ Tracking enabled");
+      }
+    },
+  });
+
+  ph.capture("$pageview");
+}
+
+/**
+ * Conditionally captures an event if tracking is enabled.
+ * @param {string} event - The event name to track
+ * @param {Record<string, any>} [properties={}] - Optional event properties
+ */
+export function capture(event, properties = {}) {
+  if (ph !== null && get(trackingEnabled)) {
+    ph.capture(event, properties);
+  }
+}
+
+/**
+ * Conditionally identifies a user if tracking is enabled.
+ * @param {string} id - Unique user identifier
+ * @param {Record<string, any>} [properties={}] - Optional user traits
+ */
+export function identify(id, properties = {}) {
+  if (ph !== null && get(trackingEnabled)) {
+    ph.identify(id, properties);
+  }
+}
+
+/**
+ * For test cleanup only — resets internal state.
+ * No-op in production.
+ * @returns {void}
+ */
+export function _resetPostHog() {
+  if (import.meta.env.MODE === "production") {
+    console.warn("[PostHog] _resetPostHog() called in production — no-op");
+    return;
+  }
+
+  initialized = false;
+  ph = null;
+}

package/src/lib/stores/trackingStatus.js

@@ -0,0 +1,30 @@
+/* ==========================================================================
+src/lib/stores/trackingStatus.js
+
+Copyright © 2025 Network Pro Strategies (Network Pro™)
+SPDX-License-Identifier: CC-BY-4.0 OR GPL-3.0-or-later
+========================================================================== */
+
+/**
+ * @file trackingStatus.js
+ * @description Tracks state of PostHog tracking status for instant updates
+ * in Privacy Policy and Privacy Dashboard.
+ * @module src/lib/stores
+ */
+
+import { writable } from "svelte/store";
+
+/**
+ * Writable tracking status store.
+ * Initialized with fallback value and updated in browser context.
+ * @type {import("svelte/store").Writable<string>}
+ */
+export const trackingStatus = writable("⏳ Checking tracking preferences...");
+
+// Dynamically import browser-only logic after mount
+if (typeof window !== "undefined") {
+  import("$lib/utils/trackingStatus.js").then(({ getTrackingPreferences }) => {
+    const prefs = getTrackingPreferences();
+    trackingStatus.set(prefs.status);
+  });
+}

package/src/lib/types/appConstants.js

@@ -0,0 +1,60 @@
+/* ==========================================================================
+src/lib/types/appConstants.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 appConstants.js
+ * @description Type definitions for app constants in src/lib/index.js
+ * @module src/lib/types
+ * @author SunDevil311
+ * @updated 2025-06-03
+ */
+
+/**
+ * @typedef {object} CompanyInfo
+ * @property {string} NAME - Full company name
+ * @property {string} APP_NAME - Application name
+ * @property {string} YEAR - Current copyright year
+ */
+
+/**
+ * @typedef {object} ContactInfo
+ * @property {string} EMAIL - Primary contact email
+ * @property {string} SECURE - Secure contact email
+ * @property {string} PRIVACY - Privacy policy email
+ * @property {string} PHONE - Support phone number
+ */
+
+/**
+ * @typedef {object} PageTargets
+ * @property {string} BLANK - Value for `target="_blank"`
+ * @property {string} SELF - Value for `target="_self"`
+ * @property {string} REL - Value for `rel="noopener noreferrer"`
+ */
+
+/**
+ * @typedef {object} NavigationLabels
+ * @property {string} BACKTOP
+ * @property {string} HREFTOP
+ */
+
+/**
+ * @typedef {object} Links
+ * @property {string} HOME - Main website URL
+ * @property {string} BLOG - External blog URL
+ */
+
+/**
+ * @typedef {object} AppConstants
+ * @property {CompanyInfo} COMPANY_INFO
+ * @property {ContactInfo} CONTACT
+ * @property {PageTargets} PAGE
+ * @property {NavigationLabels} NAV
+ * @property {Links} LINKS
+ */
+
+export {};

package/src/lib/types/fossTypes.js

@@ -1,3 +1,20 @@
+/* ==========================================================================
+src/lib/types/fossTypes.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 fossTypes.js
+ * @description Type definitions for `fossItem` in
+ * src/lib/components/foss/FossItemContent.svelte
+ * @module src/lib/types
+ * @author SunDevil311
+ * @updated 2025-06-03
+ */
+
 /**
  * @typedef {object} FossLink
  * @property {string} [label]

package/src/lib/utils/privacy.js

@@ -11,28 +11,71 @@ This file is part of Network Pro.
  * @description Determines whether the user allows tracking based on DNT, GPC, or manual opt-out.
  * @module src/lib/utils/
  * @author SunDevil311
- * @updated 2025-05-28
+ * @updated 2025-06-03
  */
 
 /**
+ * Check if user has manually set tracking preference.
+ * @returns {boolean}
+ */
+export function hasUserManuallySetTrackingPreference() {
+  if (typeof document === "undefined") return false;
+
+  const cookies = document.cookie;
+  return (
+    cookies.includes("enable_tracking=true") ||
+    cookies.includes("disable_tracking=true")
+  );
+}
+
+/**
+ * Determine if the user allows tracking based on cookies, DNT, and GPC.
  * @returns {boolean}
  */
 export function shouldTrackUser() {
+  if (
+    typeof window === "undefined" ||
+    typeof navigator === "undefined" ||
+    typeof document === "undefined"
+  ) {
+    return false;
+  }
+
+  const cookies = document.cookie;
   const windowDNT = /** @type {any} */ (window).doNotTrack;
   const navigatorGPC = /** @type {any} */ (navigator).globalPrivacyControl;
 
   const dnt = navigator.doNotTrack === "1" || windowDNT === "1";
   const gpc = navigatorGPC === true;
 
-  const manualOptOut = document.cookie.includes("disable_tracking=true");
-  const manualOptIn = document.cookie.includes("enable_tracking=true");
+  const manualOptOut = cookies.includes("disable_tracking=true");
+  const manualOptIn = cookies.includes("enable_tracking=true");
 
   console.log("[Privacy] Opt-in cookie present:", manualOptIn);
   console.log("[Privacy] Opt-out cookie present:", manualOptOut);
 
-  // Opt-in overrides everything; opt-out disables regardless of DNT/GPC
   if (manualOptIn) return true;
   if (manualOptOut) return false;
 
   return !dnt && !gpc;
 }
+
+/**
+ * Determines if user should be reminded to reconsent (after 6 months).
+ * @returns {boolean}
+ */
+export function shouldRemindUserToReconsent() {
+  if (typeof document === "undefined") return false;
+
+  if (!hasUserManuallySetTrackingPreference()) return false;
+
+  const match = document.cookie.match(/tracking_consent_timestamp=(\d+)/);
+  if (!match) return true;
+
+  const timestamp = Number(match[1]);
+  if (isNaN(timestamp)) return true;
+
+  const age = Date.now() - timestamp;
+
+  return age > 1000 * 60 * 60 * 24 * 180; // 6 months
+}

package/src/lib/utils/trackingCookies.js

@@ -11,30 +11,60 @@ This file is part of Network Pro.
  * @description Handles setting, clearing, and toggling tracking preference cookies.
  * @module src/lib/utils/
  * @author SunDevil311
- * @updated 2025-05-28
+ * @updated 2025-06-04
  */
 
+// 6 months (in seconds). Will be centralized later.
+const DEFAULT_COOKIE_MAX_AGE = 60 * 60 * 24 * 180;
+
+/**
+ * Builds a standard cookie string for use in all tracking cookies.
+ * @param {number} maxAge
+ * @returns {string}
+ */
+function buildCookieSettings(maxAge) {
+  return `path=/; max-age=${maxAge}; expires=${new Date(Date.now() + maxAge * 1000).toUTCString()}; SameSite=Lax; Secure`;
+}
+
 /**
- * Set a tracking preference cookie.
+ * Sets tracking preference cookies based on type.
  * @param {"enable" | "disable"} type
+ * @param {number} [maxAge=DEFAULT_COOKIE_MAX_AGE]
  */
-export function setTrackingPreference(type) {
-  const maxAge = 60 * 60 * 24 * 365 * 10; // 10 years
-  const cookieSettings = `path=/; max-age=${maxAge}; SameSite=Lax`;
+export function setTrackingPreference(type, maxAge = DEFAULT_COOKIE_MAX_AGE) {
+  if (typeof document === "undefined") return; // SSR guard
+
+  const cookieSettings = buildCookieSettings(maxAge);
+  const now = Date.now();
 
   if (type === "enable") {
     document.cookie = `enable_tracking=true; ${cookieSettings}`;
-    document.cookie = `disable_tracking=; path=/; max-age=0; SameSite=Lax`;
+    document.cookie = `tracking_consent_timestamp=${now}; ${cookieSettings}`;
+    clearCookie("disable_tracking");
   } else if (type === "disable") {
     document.cookie = `disable_tracking=true; ${cookieSettings}`;
-    document.cookie = `enable_tracking=; path=/; max-age=0; SameSite=Lax`;
+    document.cookie = `tracking_consent_timestamp=${now}; ${cookieSettings}`;
+    clearCookie("enable_tracking");
   }
 }
 
 /**
- * Clear both tracking cookies.
+ * Clears all tracking-related cookies.
  */
 export function clearTrackingPreferences() {
-  document.cookie = `enable_tracking=; path=/; max-age=0; SameSite=Lax`;
-  document.cookie = `disable_tracking=; path=/; max-age=0; SameSite=Lax`;
+  if (typeof document === "undefined") return; // SSR guard
+
+  clearCookie("enable_tracking");
+  clearCookie("disable_tracking");
+  clearCookie("tracking_consent_timestamp");
+}
+
+/**
+ * Clears an individual cookie.
+ * @param {string} name
+ */
+function clearCookie(name) {
+  if (typeof document === "undefined") return; // SSR guard
+
+  document.cookie = `${name}=; path=/; max-age=0; expires=Thu, 01 Jan 1970 00:00:00 GMT; SameSite=Lax; Secure`;
 }

package/src/lib/utils/trackingStatus.js

@@ -9,12 +9,16 @@ This file is part of Network Pro.
 /**
  * @file trackingStatus.js
  * @description Get tracking preferences based on cookies and browser privacy signals.
- * @module src/lib/utils/
+ * @module src/lib/utils
  * @author SunDevil311
  * @updated 2025-05-28
  */
 
+import { browser } from "$app/environment";
+
 /**
+ * Gets the current tracking preferences based on browser cookies and signals.
+ *
  * @returns {{
  *   optedOut: boolean,
  *   optedIn: boolean,
@@ -24,12 +28,23 @@ This file is part of Network Pro.
  * }}
  */
 export function getTrackingPreferences() {
+  // Prevent errors during SSR (no document or navigator)
+  if (!browser) {
+    return {
+      optedOut: false,
+      optedIn: false,
+      dnt: false,
+      gpc: false,
+      status: "⏳ Checking tracking preferences...",
+    };
+  }
+
   const cookies = document.cookie;
   const optedOut = cookies.includes("disable_tracking=true");
   const optedIn = cookies.includes("enable_tracking=true");
-  const dnt = navigator.doNotTrack === "1";
 
-  // @ts-expect-error: 'globalPrivacyControl' is a non-standard property
+  const dnt = navigator.doNotTrack === "1";
+  // @ts-expect-error: 'globalPrivacyControl' is non-standard
   const gpc = navigator.globalPrivacyControl === true;
 
   let status = "⚙️ Using default settings (tracking enabled)";

package/src/routes/+layout.js

@@ -42,5 +42,3 @@ export function load({ url }) {
     meta: currentMeta, // Return the meta data (either from the route or the fallback)
   };
 }
-
-// cspell:ignore posthog

package/src/routes/+layout.svelte

@@ -9,61 +9,61 @@ This file is part of Network Pro.
 <script>
   export let data;
 
+  import { onMount } from "svelte";
+  import { afterNavigate } from "$app/navigation";
+  import { initPostHog, showReminder, capture } from "$lib/stores/posthog";
+  import { registerServiceWorker } from "$lib/registerServiceWorker.js";
+  import { browser } from "$app/environment";
+  import { shouldTrackUser } from "$lib/utils/privacy.js";
+
   import ContainerSection from "$lib/components/ContainerSection.svelte";
   import Footer from "$lib/components/layout/Footer.svelte";
   import HeaderDefault from "$lib/components/layout/HeaderDefault.svelte";
   import HeaderHome from "$lib/components/layout/HeaderHome.svelte";
   import PWAInstallButton from "$lib/components/PWAInstallButton.svelte";
-  import { shouldTrackUser } from "$lib/utils/privacy.js";
-  import { onMount } from "svelte";
-  import { registerServiceWorker } from "$lib/registerServiceWorker.js";
-  import { browser } from "$app/environment";
+
   import "$lib/styles/global.min.css";
   import "$lib/styles/fa-global.css";
 
-  // Import favicon images
   import logoPng from "$lib/img/logo-web.png";
   import logoWbp from "$lib/img/logo-web.webp";
   import faviconSvg from "$lib/img/favicon.svg";
   import appleTouchIcon from "$lib/img/icon-180x180.png";
 
-  // Declare PostHog as null initially
-  /** @type {typeof import('$lib/components/PostHog.svelte').default | null} */
-  let PostHog = null;
+  $: shouldShowReminder = $showReminder;
 
-  if (browser) {
-    // Preload all core images (logos + apple touch)
-    [logoPng, logoWbp, appleTouchIcon].forEach((src) => {
-      const img = new Image();
-      img.src = src;
-    });
+  onMount(() => {
+    console.log("[APP] onMount triggered in +layout.svelte");
 
-    // Run setup when component mounts (only in browser)
-    onMount(() => {
-      console.log("[APP] onMount triggered in +layout.svelte");
-      registerServiceWorker();
+    registerServiceWorker();
+    initPostHog();
+
+    // Register navigation tracking only on client
+    afterNavigate(() => {
+      capture("$pageview");
+    });
 
+    if (browser) {
       const isDev = import.meta.env.MODE === "development";
 
-      console.log("ENV MODE =", import.meta.env.MODE); // Should be "development"
-      console.log("isDev =", isDev);
-      console.log("shouldTrackUser =", shouldTrackUser());
-
-      if (isDev || shouldTrackUser()) {
-        import("$lib/components/PostHog.svelte").then((module) => {
-          PostHog = module.default;
-
-          if (isDev) {
-            console.log("[Dev] ✅ PostHog component loaded (tracking enabled)");
-          }
-        });
-      } else {
-        console.log(
-          "[Privacy] ⛔ Skipping PostHog component due to DNT or GPC signal.",
-        );
+      // Check for ?debug=true in URL (no persistence)
+      const urlParams = new URLSearchParams(window.location.search);
+      const debug = urlParams.get("debug") === "true";
+
+      if (isDev || debug) {
+        console.log("ENV MODE =", import.meta.env.MODE);
+        console.log("isDev =", isDev);
+        console.log("debug param =", debug);
+        console.log("shouldTrackUser =", shouldTrackUser()); // Now called statically
       }
-    });
-  }
+
+      // Preload logo assets
+      [logoPng, logoWbp, appleTouchIcon].forEach((src) => {
+        const img = new Image();
+        img.src = src;
+      });
+    }
+  });
 
   // fallback values if data.meta not set
   const metaTitle =
@@ -103,10 +103,6 @@ This file is part of Network Pro.
 </header>
 <!-- END HEADER -->
 
-{#if PostHog}
-  <PostHog /> <!-- Add PostHog component when it's loaded -->
-{/if}
-
 <main>
   <slot />
 </main>

package/static/offline.min.css

@@ -1,7 +1,6 @@
 /*! ==========================================================================
-src/lib/styles/css/offline.css
-
+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.
 =========================================================================== */
-html,body{height:100%;margin:0;padding:0}body{color:#fafafa;text-align:center;background-color:#191919;flex-direction:column;justify-content:center;align-items:center;margin:10px;padding:0 1rem;font-family:Arial,Helvetica,sans-serif;display:flex}.container{max-width:600px;margin:0 auto}h1{color:#fafafa;margin-bottom:1rem;font-size:2rem}p{margin-bottom:1.5rem;font-size:1.1rem;line-height:1.5}.icon{color:#ff5252;margin-bottom:1rem;font-size:4rem}.retry-button{color:#fafafa;cursor:pointer;background-color:#2e7d32;border:none;border-radius:4px;margin-top:1rem;padding:12px 24px;font-family:Arial,Helvetica,sans-serif;font-size:1rem;transition:background-color .2s}.retry-button:hover{background-color:#388e3c}.status{color:#bdbdbd;background-color:#ffffff0d;border-radius:4px;margin:1rem 0;padding:1rem;font-size:.9rem}a{text-decoration:none}a:link{color:#ffc627}a:hover,a:active{color:#ffc627;text-decoration:underline}a:focus{color:#191919;background-color:#ffc627}a:visited,a:visited:hover{color:#7f6227}.help-text{color:#bdbdbd;margin-top:2rem;font-size:.9rem}
+html,body{height:100%;margin:0;padding:0}body{color:#fafafa;text-align:center;background-color:#191919;flex-direction:column;justify-content:center;align-items:center;margin:10px;padding:0 1rem;font-family:Arial,Helvetica,sans-serif;display:flex}.container{max-width:600px;margin:0 auto}h1{color:#fafafa;margin-bottom:1rem;font-size:2rem}p{margin-bottom:1.5rem;font-size:1.1rem;line-height:1.5}.icon{color:#ff5252;margin-bottom:1rem;font-size:4rem}.retry-button{color:#fafafa;cursor:pointer;background-color:#2e7d32;border:none;border-radius:4px;margin-top:1rem;padding:12px 24px;font-family:Arial,Helvetica,sans-serif;font-size:1rem;transition:background-color .2s}.retry-button:hover{background-color:#388e3c}.status{color:#bdbdbd;background-color:#ffffff0d;border-radius:4px;margin:1rem 0;padding:1rem;font-size:.9rem}a{text-decoration:none}a:link{color:#ffc627}a:hover,a:active{color:#ffc627;text-decoration:underline}a:focus{color:#191919;background-color:#ffc627}a:visited,a:visited:hover{color:#7f6227}.help-text{color:#bdbdbd;margin-top:2rem;font-size:.9rem}

package/svelte.config.js

@@ -23,13 +23,15 @@ const config = {
   kit: {
     // Netlify adapter configuration
     adapter: adapter({
-      edge: false, // Disable edge functions (optional, enable if needed)
-      split: false, // Disable splitting function files (optional, enable if needed),
+      edge: false, // Disable edge functions for site
+      split: false, // Disable splitting function files (optional, enable if needed)
     }),
+
     // Paths configuration for deployment
     paths: {
       base: "", // Always deploy to the root of the domain
     },
+
     prerender: {
       // Handle HTTP errors during prerendering
       handleHttpError: ({ path, _referrer, message }) => {
@@ -46,6 +48,7 @@ const config = {
       },
     },
   },
+
   // File extensions for Svelte and mdsvex
   extensions: [".svelte", ".svx", ".md"], // Added .md for Markdown support
 };

package/vite.config.js

@@ -9,19 +9,17 @@ This file is part of Network Pro.
 import { sveltekit } from "@sveltejs/kit/vite";
 import { defineConfig } from "vite";
 import lightningcssPlugin from "vite-plugin-lightningcss";
+import tsconfigPaths from "vite-tsconfig-paths"; // NEW: tsconfig/jsconfig alias support
 
 export default defineConfig({
   plugins: [
+    tsconfigPaths(), // Insert before sveltekit()
     sveltekit(),
     lightningcssPlugin({
       minify: process.env.NODE_ENV === "production",
       pruneUnusedFontFaceRules: true,
       pruneUnusedKeyframes: true,
       removeUnusedFontFaces: true,
-      // Enables nesting support in Lightning CSS
-      //drafts: {
-      //  nesting: true
-      //}
     }),
   ],
 });

package/src/lib/components/PostHog.svelte

@@ -1,36 +0,0 @@
-<!-- ==========================================================================
-src/lib/components/PostHog.svelte
-
-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.
-========================================================================== -->
-
-<script>
-  import posthog from "posthog-js";
-  import { onMount } from "svelte";
-  import { browser } from "$app/environment";
-  import { shouldTrackUser } from "$lib/utils/privacy.js";
-
-  onMount(() => {
-    if (!browser) return;
-
-    const allowTracking = shouldTrackUser();
-
-    // cspell:disable-next-line
-    posthog.init("phc_Qshfo6AXzh4pS7aPigfqyeo4qj1qlyh7gDuHDeVMSR0", {
-      api_host: "https://us.i.posthog.com",
-      loaded: (ph) => {
-        if (!allowTracking) {
-          console.log("[PostHog] ⛔ User opted out — disabling tracking");
-          ph.opt_out_capturing(); // Fully disable any tracking
-        } else {
-          console.log("[PostHog] ✅ Tracking enabled");
-        }
-      },
-      autocapture: allowTracking, // Optional: Disable autocapture
-      capture_pageview: allowTracking, // Optional: Disable initial pageview
-      person_profiles: "identified_only",
-    });
-  });
-</script>