nexus-shared 1.1.19 → 1.1.21

package/src/interfaces/user-interfaces.tsx

@@ -1,4 +1,5 @@
 import { EModules } from "./system-interfaces";
+import { UN } from "./type-interfaces";
 
 export enum EUserRoles {
   Guest = 0,
@@ -6,6 +7,12 @@ export enum EUserRoles {
   Admin = 2,
   SuperAdmin = 3,
 }
+export const IsAdmin = (userRole: EUserRoles | string | UN) => userRole === EUserRoles.Admin || EUserRoles[EUserRoles.Admin] === userRole;
+export const IsSuperAdmin = (userRole: EUserRoles | string | UN) => userRole === EUserRoles.SuperAdmin || EUserRoles[EUserRoles.SuperAdmin] === userRole;
+export const IsAdmin_SuperAdmin = (userRole: EUserRoles | string | UN) => IsAdmin(userRole) || IsSuperAdmin(userRole);
+export const IsUser = (userRole: EUserRoles | string | UN) => userRole === EUserRoles.User || EUserRoles[EUserRoles.User] === userRole;
+export const IsGuest = (userRole: EUserRoles | string | UN) => userRole === EUserRoles.Guest || EUserRoles[EUserRoles.Guest] === userRole;
+export const IsUser_Guest = (userRole: EUserRoles | string | UN) => IsUser(userRole) || IsGuest(userRole);
 
 export interface IUserValidationResponse {
   isValidUser: boolean;
@@ -15,3 +22,26 @@ export interface IUserValidationResponse {
   userRole: EUserRoles;
   assignedModules: EModules;
 }
+export interface ICurrentUser {
+  id: string;
+  fullname: string;
+  username: string;
+  roleName: string;
+  profilePicture: string | UN;
+  emailAddress: string | UN;
+  contactNumber: string | UN;
+  isImpersonating: boolean | UN;
+  isMultiTenant: boolean | UN;
+  enableAuditHistory: boolean | UN;
+  rootAccess: boolean | UN;
+  branchId: string | UN;
+  companyId: string | UN;
+  fiscalYearId: string | UN;
+  modules: EModules | UN;
+}
+export enum ESigninRequestMode {
+  DEFAULT = "0",
+  SIGN_OUT = "1",
+  SWITCH_BRANCH = "2",
+  SWITCH_FISCAL_YEAR = "3",
+}

package/src/nexus.environments.tsx

@@ -1,54 +1,66 @@
 import { EModules } from "./interfaces/system-interfaces";
 import { EBackgrounds } from "./interfaces/theme-interfaces";
 
+// @ts-ignore
+const processEnv = process.env;
+
 export const APIS = {
-  DRIVE: process.env.API_DRIVE as string,
-  AUTHENTICATION: process.env.API_AUTHENTICATION as string,
-  CONFIGURATION: process.env.API_CONFIGURATION as string,
-  CURRENT: process.env.API_CURRENT as string,
-  ENTERPRISE: process.env.API_ENTERPRISE as string,
-  MESSAGE: process.env.API_MESSAGE as string,
-  ACCOUNTING: process.env.API_ACCOUNTING as string,
-  REPORT: process.env.API_REPORT as string,
+  DRIVE: processEnv.API_DRIVE as string,
+  AUTHENTICATION: processEnv.API_AUTHENTICATION as string,
+  CONFIGURATION: processEnv.API_CONFIGURATION as string,
+  CURRENT: processEnv.API_CURRENT as string,
+  ENTERPRISE: processEnv.API_ENTERPRISE as string,
+  MESSAGE: processEnv.API_MESSAGE as string,
+  ACCOUNTING: processEnv.API_ACCOUNTING as string,
+  REPORT: processEnv.API_REPORT as string,
 };
 
 export const URLS = {
-  CURRENT: process.env.URL_CURRENT as string,
-  AUTHENTICATION: process.env.URL_AUTHENTICATION as string,
-  SIGN_IN: process.env.URL_AUTHENTICATION_SIGN_IN as string,
-  ALLOWED_ORIGINS: (process.env.ALLOWED_ORIGINS ?? "")
+  GLOBAL_SIGNIN: `${processEnv.URL_AUTHENTICATION}/api/auth/redirect-context`,
+  CURRENT: processEnv.URL_CURRENT as string,
+  AUTHENTICATION: processEnv.URL_AUTHENTICATION as string,
+  SIGN_IN: processEnv.URL_AUTHENTICATION_SIGN_IN as string,
+  ALLOWED_ORIGINS: (processEnv.ALLOWED_ORIGINS ?? "")
     .split(",")
-    .map((origin) => origin.trim())
+    .map((origin: string) => origin.trim())
     .filter(Boolean),
 };
-const FILE = (apiName: string, filePath: string, fileName: string) => `${process.env.API_RESOURCES_BASE_PATH ?? `/api/app/${EModules.Drive}/Resources`}/${apiName}/${encodeURIComponent(filePath)}/${encodeURIComponent(fileName)}`;
+const FILE = (apiName: string, filePath: string, fileName: string) => `${processEnv.API_RESOURCES_BASE_PATH ?? `/api/app/${EModules.Drive}/Resources`}/${apiName}/${encodeURIComponent(filePath)}/${encodeURIComponent(fileName)}`;
 export const FILES = {
   LOGO: {
     ICON: FILE("Image", "logos", "icon-logo"),
     FULL: FILE("Image", "logos", "full-logo"),
     FULL_TEXT: FILE("Image", "logos", "full-text-logo"),
   },
+  ICONS: {
+    USER: FILE("Image", "icons", "user"),
+    NO_IMAGE: FILE("Image", "icons", "no-image"),
+  },
   SCRIPT: (fileName: string, isStyles: boolean = false) => FILE("Script", isStyles ? "css" : "js", fileName),
 };
 export const NEXUS_INFO = {
-  IS_ADMIN_MODULE: process.env.IS_ADMIN_MODULE !== "false",
-  CURRENT_MODULE: process.env.CURRENT_MODULE !== undefined ? (parseInt(process.env.CURRENT_MODULE) as EModules) : undefined,
-  CURRENT_MODULE_NAME: process.env.CURRENT_MODULE_NAME as string,
-  CURRENT_MODULE_SHORT_NAME: process.env.CURRENT_MODULE_SHORT_NAME as string,
-  IS_PRODUCTION: process.env.NODE_ENV === "production",
-  SOFTWARE_COMPANY_SHORT_NAME: process.env.SOFTWARE_COMPANY_SHORT_NAME as string,
-  SOFTWARE_COMPANY_FULL_NAME: process.env.SOFTWARE_COMPANY_FULL_NAME as string,
-  SOFTWARE_VERSION: process.env.SOFTWARE_VERSION as string,
-  SOFTWARE_LAST_UPDATE_DATE: process.env.SOFTWARE_LAST_UPDATE_DATE as string,
-  SOFTWARE_COMPANY_WEBSITE: process.env.SOFTWARE_COMPANY_WEBSITE as string,
-  IS_PROXY_SERVER: process.env.IS_PROXY_SERVER !== "false",
+  IS_ADMIN_MODULE: processEnv.IS_ADMIN_MODULE !== "false",
+  CURRENT_MODULE: processEnv.CURRENT_MODULE !== undefined ? (parseInt(processEnv.CURRENT_MODULE) as EModules) : undefined,
+  CURRENT_MODULE_NAME: processEnv.CURRENT_MODULE_NAME as string,
+  CURRENT_MODULE_SHORT_NAME: processEnv.CURRENT_MODULE_SHORT_NAME as string,
+  IS_PRODUCTION: processEnv.NODE_ENV === "production",
+  SOFTWARE_COMPANY_SHORT_NAME: processEnv.SOFTWARE_COMPANY_SHORT_NAME as string,
+  SOFTWARE_COMPANY_FULL_NAME: processEnv.SOFTWARE_COMPANY_FULL_NAME as string,
+  SOFTWARE_VERSION: processEnv.SOFTWARE_VERSION as string,
+  SOFTWARE_LAST_UPDATE_DATE: processEnv.SOFTWARE_LAST_UPDATE_DATE as string,
+  SOFTWARE_COMPANY_WEBSITE: processEnv.SOFTWARE_COMPANY_WEBSITE as string,
+  IS_PROXY_SERVER: processEnv.IS_PROXY_SERVER !== "false",
 };
 export const NEXUS_CONFIG = {
   /** Default revalidate time for static generation (in minutes) */
   DEFAULT_REVALIDATE_TIME: NEXUS_INFO.IS_PRODUCTION ? 60 * 24 : 0,
-
+  DEFAULT_REVALIDATE_TIME_ONE_HOUR: NEXUS_INFO.IS_PRODUCTION ? 60 : 0,
+  DEFAULT_REVALIDATE_TIME_ONE_DAY: NEXUS_INFO.IS_PRODUCTION ? 60 * 24 : 0,
+  DEFAULT_REVALIDATE_TIME_ONE_WEEK: NEXUS_INFO.IS_PRODUCTION ? 60 * 24 * 7 : 0,
+  DEFAULT_REVALIDATE_TIME_ONE_MONTH: NEXUS_INFO.IS_PRODUCTION ? 60 * 24 * 30 : 0,
+  DEFAULT_REVALIDATE_TIME_ONE_YEAR: NEXUS_INFO.IS_PRODUCTION ? 60 * 24 * 365 : 0,
   /** Default timeout for HTTP requests (in milliseconds) */
   DEFAULT_HTTP_REQUEST_TIMEOUT: NEXUS_INFO.IS_PRODUCTION ? 60000 : 1000000,
 
-  DEFAULT_BACKGROUND: (process.env.DEFAULT_BACKGROUND as EBackgrounds) ?? EBackgrounds.Background1,
+  DEFAULT_BACKGROUND: (processEnv.DEFAULT_BACKGROUND as EBackgrounds) ?? EBackgrounds.Background1,
 };

package/src/services/http-services.tsx

@@ -3,7 +3,7 @@
  * For browser/client components use `http-client-services` (`Post`, `Get`, …) via `nexus-shared/client`.
  */
 import { Delay } from "../helpers/utility-helpers";
-import { EActions, EBody, EModules, GetMethod, IErrorRespose, ISuccessResponse, UN } from "../interface";
+import { EActions, EBody, EModules, GetMethod, GetResponse, IErrorRespose, ISuccessResponse, UN } from "../interface";
 import { EErrorCodes, EExceptionCategories } from "../interfaces/exception-interfaces";
 import { APIS, NEXUS_CONFIG, NEXUS_INFO } from "../nexus.environments";
 
@@ -15,7 +15,7 @@ export const BuildApiHeader = (formdata?: any, httpMethod?: EActions | string, b
   bodyType = bodyType ?? EBody.JSON;
 
   const headers = new Headers();
-  if (token && token.length > 50) headers.append("authorization", `${token}`);
+  if (token && token.length > 50) headers.append("authorization", token.startsWith("Bearer ") ? token : `Bearer ${token}`);
   if (browserId) headers.append("bid", browserId);
   headers.append("Content-Type", bodyType);
 
@@ -115,8 +115,9 @@ const handleResponse = async (response: Response): Promise<IErrorRespose> => {
   const status = response.status;
   try {
     const errorData = await response.json();
-    return handleError({ ...errorData, status });
-  } catch {
+
+    return handleError({ ...errorData, code: status, status: status });
+  } catch (error: any) {
     let message = "Unexpected server error.";
     switch (status) {
       case 401:
@@ -131,7 +132,7 @@ const handleResponse = async (response: Response): Promise<IErrorRespose> => {
         message = "Method not allowed.";
         break;
     }
-    return handleError({ status, message });
+    return handleError(GetResponse.ERROR(message, "GENERIC_ERROR", EExceptionCategories.Application, EErrorCodes.Unknown, undefined, undefined, status));
   }
 };
 export const handleError = (error: any): IErrorRespose => {
@@ -148,7 +149,6 @@ export const handleError = (error: any): IErrorRespose => {
   };
 };
 const handleNetworkError = (error: any): IErrorRespose => {
-  console.error("\n\nNetwork error encountered:", error);
   return handleError({
     status: 503,
     message: "Unable to connect to the server. Please check your network or backend status.",

package/src/services/loader-service.tsx

@@ -36,17 +36,17 @@ const _findExistingLoader = (parent: HTMLElement): HTMLElement | null => {
   const loaderElement = FindChildElement(parent, `#${LOADER_IDENTITY}`);
   return loaderElement as HTMLElement | null;
 };
-const _updateLoaderProperties = (loaderElement: HTMLElement, type: EAnimationClasses, size: ESizes) => {
+const _updateLoaderProperties = (loaderElement: HTMLElement, type: EAnimationClasses, size: ESizes, isInputLoader: boolean) => {
   if (type === EAnimationClasses.SPIN) {
     if (size === ESizes.VeryTiny) {
-      loaderElement.style.setProperty("--SPIN_BOX_SIZE", "2.5rem");
-      loaderElement.style.setProperty("--SPIN_BOX_BORDER_SIZE", "0.34rem");
+      loaderElement.style.setProperty("--SPIN_BOX_SIZE", isInputLoader ? "1.5rem" : "2.5rem");
+      loaderElement.style.setProperty("--SPIN_BOX_BORDER_SIZE", isInputLoader ? "0.28rem" : "0.34rem");
     } else if (size === ESizes.Tiny) {
-      loaderElement.style.setProperty("--SPIN_BOX_SIZE", "2.8rem");
-      loaderElement.style.setProperty("--SPIN_BOX_BORDER_SIZE", "0.36rem");
+      loaderElement.style.setProperty("--SPIN_BOX_SIZE", isInputLoader ? "2.0rem" : "2.8rem");
+      loaderElement.style.setProperty("--SPIN_BOX_BORDER_SIZE", isInputLoader ? "0.31rem" : "0.36rem");
     } else if (size === ESizes.VerySmall) {
-      loaderElement.style.setProperty("--SPIN_BOX_SIZE", "3rem");
-      loaderElement.style.setProperty("--SPIN_BOX_BORDER_SIZE", "0.38rem");
+      loaderElement.style.setProperty("--SPIN_BOX_SIZE", isInputLoader ? "2.4rem" : "3rem");
+      loaderElement.style.setProperty("--SPIN_BOX_BORDER_SIZE", isInputLoader ? "0.34rem" : "0.38rem");
     } else if (size === ESizes.Small) {
       loaderElement.style.setProperty("--SPIN_BOX_SIZE", "3.5rem");
       loaderElement.style.setProperty("--SPIN_BOX_BORDER_SIZE", "0.45rem");
@@ -68,26 +68,30 @@ const _updateLoaderProperties = (loaderElement: HTMLElement, type: EAnimationCla
     }
   }
 };
-const _updateLoaderAttributes = (loaderElement: HTMLElement, type: EAnimationClasses, size: ESizes, disabledInputs: boolean, count: number) => {
+const _updateLoaderAttributes = (loaderElement: HTMLElement, type: EAnimationClasses, size: ESizes, disabledInputs: boolean, count: number, isInputLoader: boolean) => {
   loaderElement.setAttribute(LOADER_DATA_COUNT_ATTRIBUTE, count.toString());
   loaderElement.setAttribute(LOADER_DATA_TYPE_ATTRIBUTE, type);
   loaderElement.setAttribute(LOADER_DATA_SIZE_ATTRIBUTE, size);
   loaderElement.setAttribute(LOADER_DATA_DISABLED_INPUTS_ATTRIBUTE, disabledInputs ? "true" : "false");
 };
-const _createLoaderElement = (parent: HTMLElement, type: EAnimationClasses, size: ESizes, showLogo: boolean, disabledInputs: boolean, background: EBackgrounds, defaultClass?: string | UN): HTMLElement | null => {
+const _createLoaderElement = (parent: HTMLElement, type: EAnimationClasses, size: ESizes, showLogo: boolean, disabledInputs: boolean, background: EBackgrounds, defaultClass?: string | UN, isInputLoader?: boolean): HTMLElement | null => {
   const loaderElement = _findExistingLoader(parent);
   if (loaderElement && !loaderElement.classList.contains(DISPOSED_LOADER_CLASS)) {
     const count = parseInt(loaderElement.getAttribute(LOADER_DATA_COUNT_ATTRIBUTE) ?? "0") + 1;
-    _updateLoaderAttributes(loaderElement, type, size, disabledInputs, count);
-    _updateLoaderProperties(loaderElement, type, size);
+    _updateLoaderAttributes(loaderElement, type, size, disabledInputs, count, isInputLoader ?? false);
+    _updateLoaderProperties(loaderElement, type, size, isInputLoader ?? false);
     return loaderElement as HTMLElement;
   }
 
   const newLoaderElement = document.createElement("div");
   newLoaderElement.id = LOADER_IDENTITY;
   newLoaderElement.classList.add("nexus-container", "o0", EAnimationClasses.FADE_IN, background);
-  if (defaultClass) newLoaderElement.classList.add(defaultClass);
-  _updateLoaderAttributes(newLoaderElement, type, size, disabledInputs, 1);
+  if (defaultClass) newLoaderElement.classList.add(...defaultClass.split(" "));
+  _updateLoaderAttributes(newLoaderElement, type, size, disabledInputs, 1, isInputLoader ?? false);
+  _updateLoaderProperties(newLoaderElement, type, size, isInputLoader ?? false);
+
+  newLoaderElement.style.maxHeight = "100%!important";
+  newLoaderElement.style.maxWidth = "100%!important";
 
   const loader = document.createElement("div");
   newLoaderElement.appendChild(loader);
@@ -99,8 +103,6 @@ const _createLoaderElement = (parent: HTMLElement, type: EAnimationClasses, size
     loader.classList.add("tx52");
     loader.style.fontSize = "1.5rem";
   } else if (showLogo && type !== EAnimationClasses.SLIDE_BAR && type !== EAnimationClasses.BOUNCE_BAR) {
-    _updateLoaderProperties(newLoaderElement, type, size);
-
     const logoElement = document.createElement("img");
     logoElement.src = FILES.LOGO.ICON;
     logoElement.alt = "Logo";
@@ -124,7 +126,7 @@ const _createLoaderElement = (parent: HTMLElement, type: EAnimationClasses, size
   return newLoaderElement;
 };
 
-export const ShowLoader = async (parent?: String | HTMLElement | UN, type?: EAnimationClasses | UN, disabledInputs?: boolean | UN, size?: ESizes | UN, delay?: number | UN, showLogo?: boolean | UN, background?: EBackgrounds | UN, defaultClass?: string | UN): Promise<HTMLElement | null> => {
+export const ShowLoader = async (parent?: String | HTMLElement | UN, type?: EAnimationClasses | UN, disabledInputs?: boolean | UN, size?: ESizes | UN, delay?: number | UN, showLogo?: boolean | UN, background?: EBackgrounds | UN, defaultClass?: string | UN, isInputLoader?: boolean | UN): Promise<HTMLElement | null> => {
   if (!IsBrowser()) return Promise.resolve(null);
   type = type ?? DEFAULT_LOADER_TYPE;
   size = size ?? DEFAULT_LOADER_SIZE;
@@ -134,7 +136,7 @@ export const ShowLoader = async (parent?: String | HTMLElement | UN, type?: EAni
     const timeout = setTimeout(() => {
       clearTimeout(timeout);
       const parentElement = _findParentElement(parent);
-      const loaderElement = _createLoaderElement(parentElement, type, size, showLogo ?? true, disabledInputs ?? false, background, defaultClass);
+      const loaderElement = _createLoaderElement(parentElement, type, size, showLogo ?? true, disabledInputs ?? false, background, defaultClass, isInputLoader ?? false);
       resolve(loaderElement);
     }, delay ?? DEFAULT_LOADER_DELAY);
   });
@@ -167,3 +169,17 @@ export const HideLoader = (parent?: String | HTMLElement | UN, force?: boolean |
     }, delay ?? DEFAULT_LOADER_DELAY);
   });
 };
+
+export const InputLoader = async (parent: String | HTMLElement, isShow: boolean, defaultClass?: string | UN): Promise<HTMLElement | null> => {
+  if (isShow !== false) {
+    const loaderElement = await ShowLoader(parent, EAnimationClasses.SPIN, false, ESizes.VeryTiny, null, false, EBackgrounds.None, defaultClass, true);
+    if (loaderElement) {
+      loaderElement.style.width = "100%";
+      loaderElement.style.height = "100%";
+    }
+    return loaderElement;
+  }
+
+  HideLoader(parent);
+  return null;
+};

package/src/services/localstorage-service.tsx

@@ -1,7 +1,7 @@
 import { CreateUpdatePreference } from "../api-services/preference-service";
 import { IsBrowser } from "../helpers/browser-helpers";
 import { Debounce } from "../helpers/utility-helpers";
-import { EFlexPositions } from "../interface";
+import { EFlexPositions, UN } from "../interface";
 import { LOCAL_STORAGE_KEYS } from "../interfaces/storage-interfaces";
 import { EPreferenceTargets } from "../interfaces/system-interfaces";
 import { IThemeInformation } from "../interfaces/theme-interfaces";
@@ -24,10 +24,10 @@ const _createUpdatePreferenceDebounce = Debounce(CreateUpdatePreference, 1000);
  * @param isSyncWithServer Whether to sync with the server
  * @param target The target of the local storage
  */
-const _syncStorageToServer = async (key: string, value: string | null, isSyncWithServer?: boolean, target?: EPreferenceTargets) => {
+const _syncStorageToServer = async (key: string, value: string | UN, isSyncWithServer?: boolean | UN, target?: EPreferenceTargets | UN) => {
   if (!IsBrowser() || !isSyncWithServer || !target) return;
 
-  await _createUpdatePreferenceDebounce(target, key, value);
+  await _createUpdatePreferenceDebounce(target, key, value ?? null);
 };
 
 /**
@@ -38,11 +38,28 @@ const _syncStorageToServer = async (key: string, value: string | null, isSyncWit
  * @param isSyncWithServer Whether to sync with the server
  * @param target The target of the local storage
  */
-export const SetLocalStorage = (key: string, value: string, isSyncWithServer?: boolean, target?: EPreferenceTargets) => {
+export const SetLocalStorage = (key: string, value: string | UN, isSyncWithServer?: boolean | UN, target?: EPreferenceTargets | UN) => {
   if (!IsBrowser()) return;
 
   _syncStorageToServer(key, value, isSyncWithServer, target);
-  localStorage.setItem(key, value);
+
+  if (value === null || value === undefined) RemoveLocalStorage(key, isSyncWithServer, target);
+  else localStorage.setItem(key, value);
+};
+export const SetSessionStorage = (key: string, value: string | UN) => {
+  if (!IsBrowser()) return;
+  if (value === null || value === undefined) RemoveSessionStorage(key);
+  else sessionStorage.setItem(key, value);
+};
+export const GetSessionStorage = (key: string): string | null => {
+  if (!IsBrowser()) return null;
+  const data = sessionStorage.getItem(key);
+  if (!data) return null;
+  return data;
+};
+export const RemoveSessionStorage = (key: string) => {
+  if (!IsBrowser()) return;
+  sessionStorage.removeItem(key);
 };
 /**
  * Remove the value of the local storage
@@ -51,7 +68,7 @@ export const SetLocalStorage = (key: string, value: string, isSyncWithServer?: b
  * @param isSyncWithServer Whether to sync with the server
  * @param target The target of the local storage
  */
-export const RemoveLocalStorage = (key: string, isSyncWithServer?: boolean, target?: EPreferenceTargets) => {
+export const RemoveLocalStorage = (key: string, isSyncWithServer?: boolean | UN, target?: EPreferenceTargets | UN) => {
   _syncStorageToServer(key, null, isSyncWithServer, target);
   localStorage.removeItem(key);
 };

package/src/services/message-services.tsx

@@ -157,7 +157,7 @@ const _showMessage = (title: string, message: string, messageType: EMessageTypes
     messageContentElement.appendChild(messageElement);
 
     const dismiss = () => dismissMessage(messageRootElement, callback);
-    CreateIconBox(EIcons.CLOSE, titleElement, null, null, EIconTypes.FILLED, EBackgrounds.Background1, ESizes.VeryTiny, ESizes.Tiny, null, null, null, null, EOpacity.O05, "Clear Message", null, null, null, dismiss);
+    CreateIconBox(EIcons.CLOSE, titleElement, null, null, EIconTypes.OUTLINED, EBackgrounds.Background1, ESizes.VeryTiny, ESizes.Tiny, null, null, null, null, EOpacity.O05, "Clear Message", null, null, null, dismiss);
 
     activeMessages.unshift(messageRootElement);
     scheduleReflow();

package/src/services/theme-service.tsx

@@ -1,10 +1,21 @@
 import { DEFAULT_SMALL_ICON_BOX_SIZE } from "../interfaces/icon-interfaces";
 import { DEFAULT_FONT_WEIGHTS } from "../interfaces/layout-interfaces";
 import { O } from "../nexus-client";
-import { IThemeColors, IThemeInformation } from "./../interfaces/theme-interfaces";
+import { EBackgroundColors, EColorTypes, ETextColors, IThemeInformation } from "./../interfaces/theme-interfaces";
 import { GetCurrentTheme, SetCurrentTheme } from "./localstorage-service";
 
 const I = "!important;";
+export const ICON_BOX_SCALES = {
+  xxs: 1 / 1.7,
+  xs: 1 / 1.5,
+  sm: DEFAULT_SMALL_ICON_BOX_SIZE,
+  ssm: 1 / 1.35,
+  lg: 1.25,
+  med: 1.1,
+  xl: 1.5,
+  xxl: 1.8,
+};
+export const THEME_KEYS = ["c1", "c2", "c3", "c10", "c11", "c12", "c13", "c20", "c30", "c41", "c51", "c52", "c100", "c200", "c400", "c600", "c800", "c950"];
 
 const _setVariable = (key: string, value: string | null) => {
   if (value) document.documentElement.style.setProperty(key, value);
@@ -22,13 +33,12 @@ const _initializeTheme = (theme: IThemeInformation): boolean => {
   if (!theme) return false;
   SetCurrentTheme(theme.systemName);
 
-  const THEME_KEYS = Object.keys(theme.themeColors);
   for (const key of THEME_KEYS) {
-    const color = theme.themeColors[key as keyof IThemeColors];
+    const color = theme[key as keyof IThemeInformation] as string;
     const [background, hover, focus, text] = color.split("|");
 
     if (!background) continue;
-    const keyNumber = key.replace("C", "");
+    const keyNumber = key.replace("c", "");
 
     if (background !== "NULL") _setVariable(`--B${keyNumber}`, background);
     if (hover !== "NULL") _setVariable(`--H${keyNumber}`, hover);
@@ -96,9 +106,8 @@ export const InitializeStyles = () => {
     _setRule(sheet, `.bat${s}`, `border: var(--BRD${s}) solid transparent`);
   });
 
-  const THEME_KEYS = Object.keys(themeInformations[0].themeColors);
   for (const key of THEME_KEYS) {
-    const keyNumber = key.replace("C", "");
+    const keyNumber = key.replace("c", "");
     _setRule(sheet, `.bg${keyNumber}`, `background-color: var(--B${keyNumber}) ${I}; color: var(--T${keyNumber});`);
     _setRule(sheet, `.h.bg${keyNumber}:hover`, `background-color: var(--H${keyNumber}) ${I}`);
     _setRule(sheet, `.h.bg${keyNumber}:focus`, `background-color: var(--F${keyNumber}) ${I}`);
@@ -118,16 +127,6 @@ export const InitializeStyles = () => {
     fs: 2.85,
   };
 
-  const ICON_BOX_SCALES = {
-    xxs: 1 / 1.7,
-    xs: 1 / 1.5,
-    sm: DEFAULT_SMALL_ICON_BOX_SIZE,
-    ssm: 1 / 1.35,
-    lg: 1.25,
-    med: 1.1,
-    xl: 1.5,
-    xxl: 1.8,
-  };
   Object.entries(ICON_SIZES).forEach(([k, v]) => _setRule(sheet, `.icon.${k}`, `font-size: ${v}rem;`));
 
   Object.entries(ICON_BOX_SCALES).forEach(([k, s]) => {
@@ -135,6 +134,8 @@ export const InitializeStyles = () => {
     const css = `min-width: ${size} ${I}; min-height: ${size} ${I}; max-width: ${size} ${I}; max-height: ${size} ${I};`;
     _setRule(sheet, `.ib.${k}`, css);
   });
+
+  _setVariable(`--TOP_HEIGHT`, `calc(var(--IH) * ${ICON_BOX_SCALES.sm})`);
 };
 export const SwitchTheme = (themeCode: string): boolean => {
   const themeInformations = O.systemThemes;
@@ -145,3 +146,18 @@ export const SwitchTheme = (themeCode: string): boolean => {
   SetCurrentTheme(theme.systemName);
   return _initializeTheme(theme);
 };
+export const GetColorCode = (colorCode: string | EBackgroundColors | ETextColors): number | null => {
+  if (colorCode) {
+    const match = colorCode.match(/\d+/);
+    return match ? parseInt(match[0], 10) : 0;
+  }
+
+  return null;
+};
+export const GetDynamicColor = (colorCode: string | EBackgroundColors | ETextColors, colorType: EColorTypes): string | null => {
+  if (colorCode) {
+    const code = GetColorCode(colorCode);
+    if (code) return `var(${colorType}${code})`;
+  }
+  return null;
+};

package/src/services/user-services.tsx

@@ -0,0 +1,10 @@
+import { EUserRoles, ICurrentUser, UN } from "../interface";
+
+let CURRENT_USER: ICurrentUser | null = null;
+export const SetCurrentUser = (user: ICurrentUser | UN) => (CURRENT_USER = user ?? null);
+export const GetCurrentUser = (): ICurrentUser | null => CURRENT_USER;
+export const GetCurrentUserRole = (): EUserRoles | null => {
+  const roleName = CURRENT_USER?.roleName;
+  if (!roleName) return null;
+  return EUserRoles[roleName as keyof typeof EUserRoles];
+};

package/src/sso-config/auth-token-validation.ts

@@ -9,12 +9,8 @@ import { SSO_CONFIG } from "./sso-config";
  */
 export async function VerifyAccessToken(token: string): Promise<boolean> {
   if (!token?.trim()) return false;
-  try {
-    const response = await HttpGet(SSO_CONFIG.BACKEND_ENDPOINTS.VERIFY, token);
-    if (!response.isSuccess) return false;
-    const validationResponse = response.result as IUserValidationResponse;
-    return validationResponse.isValidUser;
-  } catch {
-    return false;
-  }
+  const response = await HttpGet(SSO_CONFIG.BACKEND_ENDPOINTS.VERIFY, token, 0);
+  const validationResponse = response.result as IUserValidationResponse;
+  if (!response.isSuccess) return false;
+  return validationResponse.isValidUser;
 }

package/src/sso-config/callback-route.tsx

@@ -2,9 +2,9 @@ import { NextRequest, NextResponse } from "next/server";
 import { URLS } from "../nexus.environments";
 import { SetAuthCookies } from "./cookie-helpers";
 import { DecodeOAuthCallbackState } from "./oauth-callback-state";
-import { SanitizeReturnPath } from "./redirect-context-helpers";
-import { BuildAuthenticationSignInUrl, SSO_CONFIG } from "./sso-config";
+import { ClearRedirectContextCookie, SanitizeReturnPath } from "./redirect-context-helpers";
 import { ExchangeAuthorizationCode } from "./sso-backend-flow";
+import { BuildAuthenticationSignInUrl, SSO_CONFIG } from "./sso-config";
 
 export async function CallbackRoute(req: NextRequest) {
   const code = req.nextUrl.searchParams.get("code");
@@ -27,6 +27,7 @@ export async function CallbackRoute(req: NextRequest) {
     const redirectTarget = new URL(SanitizeReturnPath(tokenData.returnPath ?? callbackState.returnPath), URLS.CURRENT!);
     const response = NextResponse.redirect(redirectTarget);
     SetAuthCookies(response, tokenData);
+    ClearRedirectContextCookie(response);
     return response;
   } catch {
     return NextResponse.redirect(new URL(BuildAuthenticationSignInUrl(callbackState?.returnPath)));

package/src/sso-config/cookie-helpers.tsx

@@ -3,6 +3,7 @@ import { NextRequest, NextResponse } from "next/server";
 import { VerifyAccessToken } from "./auth-token-validation";
 import { DecryptCookieValue, EncryptCookieValue } from "./cookie-encryption";
 import { GetAuthCookieOptions } from "./redirect-context-helpers";
+import { SSO_CONFIG } from "./sso-config";
 import { CookieInfo, SSOAuthResponse } from "./sso-interfaces";
 
 export const AUTH_COOKIES = {
@@ -24,11 +25,7 @@ export function SetSsoSessionCookie(response: NextResponse, ssoSession: string,
 export function ClearAuthCookies(response: NextResponse) {
   response.cookies.set(AUTH_COOKIES.accessToken, "", GetAuthCookieOptions(0));
   response.cookies.set(AUTH_COOKIES.refreshToken, "", GetAuthCookieOptions(0));
-}
-
-export function ClearAllAuthCookies(response: NextResponse) {
   response.cookies.set(AUTH_COOKIES.ssoSession, "", GetAuthCookieOptions(0));
-  ClearAuthCookies(response);
 }
 
 /**
@@ -44,34 +41,62 @@ export function GetDecryptedRequestCookie(req: NextRequest, name: string): strin
 export async function GetCookieInfo(): Promise<CookieInfo | null> {
   const cookieStore = await cookies();
 
+  const rawRefreshToken = cookieStore.get(AUTH_COOKIES.refreshToken)?.value;
+  const refreshToken = rawRefreshToken ? (DecryptCookieValue(rawRefreshToken) ?? undefined) : undefined;
+
   const rawSsoSession = cookieStore.get(AUTH_COOKIES.ssoSession)?.value;
-  if (!rawSsoSession) return null;
-  const ssoSession = DecryptCookieValue(rawSsoSession);
-  if (!ssoSession) return null;
+  const ssoSession = rawSsoSession ? (DecryptCookieValue(rawSsoSession) ?? undefined) : undefined;
 
   const rawAccessToken = cookieStore.get(AUTH_COOKIES.accessToken)?.value;
-  const rawRefreshToken = cookieStore.get(AUTH_COOKIES.refreshToken)?.value;
+  const accessToken = rawAccessToken ? (DecryptCookieValue(rawAccessToken) ?? undefined) : undefined;
+
+  if (!refreshToken && !ssoSession) return null;
 
   return {
     ssoSession,
-    accessToken: rawAccessToken ? (DecryptCookieValue(rawAccessToken) ?? undefined) : undefined,
-    refreshToken: rawRefreshToken ? (DecryptCookieValue(rawRefreshToken) ?? undefined) : undefined,
+    accessToken,
+    refreshToken,
   };
 }
 
-/** True when this client app has a valid access token (use on all non-auth client sites). */
-export async function HasAccessToken(): Promise<boolean> {
-  const cookieStore = await cookies();
-  const raw = cookieStore.get(AUTH_COOKIES.accessToken)?.value;
-  if (!raw) return false;
-  const token = DecryptCookieValue(raw);
-  if (!token) return false;
-  return VerifyAccessToken(token);
+/** Where to send the browser after credentials or provider sign-in succeeds. */
+export function ResolvePostLoginRedirectUrl(hasRedirectContext: boolean): string {
+  return hasRedirectContext ? SSO_CONFIG.FRONTEND_ENDPOINTS.SSO_COMPLETE : SSO_CONFIG.FRONTEND_ENDPOINTS.SIGN_IN;
 }
 
-/** True on the central auth app when user has SSO session or a valid local access token. */
-export async function HasAuthSession(): Promise<boolean> {
+/**
+ * When the user already has auth cookies, returns the next URL (or null to show sign-in).
+ * - refresh token → home or SSO complete for an external client
+ * - sso session only → token exchange (GET sign-in) or SSO complete
+ */
+export async function ResolveAuthenticatedRedirect(redirectContextUri?: string | null): Promise<string | null> {
+  const cookieInfo = await GetCookieInfo();
+  if (!cookieInfo) return null;
+
+  if (cookieInfo.refreshToken) {
+    return redirectContextUri ? SSO_CONFIG.FRONTEND_ENDPOINTS.SSO_COMPLETE : "/home";
+  }
+
+  if (cookieInfo.ssoSession) {
+    return redirectContextUri ? SSO_CONFIG.FRONTEND_ENDPOINTS.SSO_COMPLETE : SSO_CONFIG.FRONTEND_ENDPOINTS.SIGN_IN;
+  }
+
+  return null;
+}
+
+/** True when this client app has a valid access token (use on all non-auth client sites). */
+export async function HasAccessToken(backendValidation: boolean = false): Promise<boolean> {
   const cookieStore = await cookies();
-  const rawSsoSession = cookieStore.get(AUTH_COOKIES.ssoSession)?.value;
-  return !!(rawSsoSession && DecryptCookieValue(rawSsoSession));
+  const rawRefreshToken = cookieStore.get(AUTH_COOKIES.refreshToken)?.value;
+  const refreshToken = rawRefreshToken ? DecryptCookieValue(rawRefreshToken) : null;
+  if (!refreshToken) return false;
+
+  const rawAccessToken = cookieStore.get(AUTH_COOKIES.accessToken)?.value;
+  const accessToken = rawAccessToken ? DecryptCookieValue(rawAccessToken) : null;
+
+  if (!accessToken && !backendValidation) return true;
+
+  if (!accessToken) return false;
+
+  return VerifyAccessToken(accessToken);
 }

package/src/sso-config/oauth-callback-state.ts

@@ -8,11 +8,14 @@ type EncodedCallbackState = {
   t: number;
 };
 
+// @ts-ignore
+const processEnv = process.env;
+
 function getCookieSecret(): string {
-  const ssoSecret = process.env.SSO_COOKIE_SECRET?.trim();
+  const ssoSecret = processEnv.SSO_COOKIE_SECRET?.trim();
   const secret = ssoSecret && !ssoSecret.startsWith("$") ? ssoSecret : undefined;
   if (secret) return secret;
-  if (process.env.NODE_ENV === "development") return "NexusDevAuthSecretKey2026MustBe32CharsLong!";
+  if (processEnv.NODE_ENV === "development") return "NexusDevAuthSecretKey2026MustBe32CharsLong!";
   throw new Error("SSO_COOKIE_SECRET must be configured.");
 }
 

package/src/sso-config/pkce-helpers.ts

@@ -1,12 +1,5 @@
-import { randomBytes, createHash } from "crypto";
-
-export const PKCE_METHOD_S256 = "S256";
-
-export type PkcePair = {
-  verifier: string;
-  challenge: string;
-  method: typeof PKCE_METHOD_S256;
-};
+import { createHash, randomBytes } from "crypto";
+import { PKCE_METHOD_S256, PkcePair } from "./sso-interfaces";
 
 /** Creates an OAuth PKCE pair (RFC 7636) using S256. */
 export function CreatePkcePair(): PkcePair {