@apptimate/core-lib 5.3.0 → 5.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apptimate/core-lib",
-  "version": "5.3.0",
+  "version": "5.4.0",
   "main": "src/index.ts",
   "types": "src/index.ts",
   "publishConfig": {

package/src/api-services/email-services.client.ts

@@ -0,0 +1,94 @@
+import type { IApiResponse } from "../common/interfaces/ICommon";
+import { sendRequest } from "../utils/httpClient";
+
+const BASE = `${process.env.NEXT_PUBLIC_API_URL}/api`;
+
+export type EmailProvider = "smtp";
+export type EmailConnectionStatus = "draft" | "connected" | "verified" | "active" | "inactive" | "reauthorization_required" | "error" | "disconnected";
+
+export interface EmailConnection {
+  id: number;
+  connection_name: string;
+  provider: EmailProvider;
+  display_name?: string | null;
+  from_name: string;
+  from_email: string;
+  reply_to_email?: string | null;
+  status: EmailConnectionStatus;
+  is_default: boolean;
+  verified_at?: string | null;
+  last_health_status?: "healthy" | "degraded" | "unhealthy" | "unknown" | null;
+  last_error_code?: string | null;
+  routes_count?: number;
+  has_password?: boolean;
+  smtp?: {
+    host: string;
+    port: number;
+    encryption: "tls" | "ssl" | "none";
+    username: string;
+  } | null;
+}
+
+export interface EmailConnectionRoute {
+  id: number;
+  email_connection_id: number;
+  module_code?: string | null;
+  message_type?: string | null;
+  document_type?: string | null;
+  is_active: boolean;
+  connection?: Pick<EmailConnection, "id" | "connection_name" | "provider">;
+}
+
+export interface EmailDelivery {
+  id: number;
+  uuid: string;
+  email_connection_id?: number | null;
+  provider: EmailProvider | "system";
+  message_type?: string | null;
+  recipient_summary: string[] | Record<string, unknown>;
+  subject: string;
+  status: "queued" | "processing" | "retrying" | "accepted" | "failed" | "cancelled";
+  attempt_count: number;
+  queued_at?: string | null;
+  accepted_at?: string | null;
+  failed_at?: string | null;
+  connection?: Pick<EmailConnection, "id" | "connection_name">;
+}
+
+export interface SmtpConnectionPayload {
+  id?: number;
+  connection_name: string;
+  from_name: string;
+  from_email: string;
+  reply_to_email?: string;
+  host: string;
+  port: number;
+  encryption: "tls" | "ssl" | "none";
+  username: string;
+  password?: string;
+}
+
+async function request<T>(url: string, method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE", data?: unknown): Promise<IApiResponse<T>> {
+  const response = await sendRequest({ url, method, data });
+  return response.responseData as IApiResponse<T>;
+}
+
+export const listEmailConnections = () => request<EmailConnection[]>(`${BASE}/email-connections`, "GET");
+export const revealSmtpConnectionPassword = (id: number) =>
+  request<{ password: string }>(`${BASE}/email-connections/${id}/smtp-secret`, "GET");
+export const saveSmtpConnection = (data: SmtpConnectionPayload) => request<EmailConnection>(`${BASE}/email-connections/smtp`, "PUT", data);
+export const verifyEmailConnection = (id: number) => request<EmailConnection>(`${BASE}/email-connections/${id}/verify`, "POST");
+export const sendConnectionTest = (id: number, test_recipient: string) =>
+  request<null>(`${BASE}/email-connections/${id}/send-test`, "POST", { test_recipient });
+export const activateEmailConnection = (id: number) => request<EmailConnection>(`${BASE}/email-connections/${id}/activate`, "POST");
+export const deactivateEmailConnection = (id: number) => request<EmailConnection>(`${BASE}/email-connections/${id}/deactivate`, "POST");
+export const deleteEmailConnection = (id: number) => request<null>(`${BASE}/email-connections/${id}`, "DELETE");
+
+export const listEmailConnectionRoutes = () => request<EmailConnectionRoute[]>(`${BASE}/email-connection-routes`, "GET");
+export const saveEmailConnectionRoute = (data: Omit<EmailConnectionRoute, "id" | "connection"> & { id?: number }) =>
+  request<EmailConnectionRoute>(`${BASE}/email-connection-routes${data.id ? `/${data.id}` : ""}`, data.id ? "PUT" : "POST", data);
+export const deleteEmailConnectionRoute = (id: number) => request<null>(`${BASE}/email-connection-routes/${id}`, "DELETE");
+
+export const listEmailDeliveries = () => request<{ data: EmailDelivery[] } | EmailDelivery[]>(`${BASE}/email-deliveries`, "GET");
+export const retryEmailDelivery = (id: number, data?: { email_connection_id?: number; reason?: string }) =>
+  request<EmailDelivery>(`${BASE}/email-deliveries/${id}/retry`, "POST", data);

package/src/api-services/email-templates.client.ts

@@ -0,0 +1,130 @@
+import { IApiResponse } from "../common/interfaces/ICommon";
+import { sendRequest } from "../utils/httpClient";
+
+const BASE = `${process.env.NEXT_PUBLIC_API_URL}/api/email-templates`;
+
+export type EmailTemplateStatus = "active" | "inactive";
+export type EmailTemplateFormat = "html" | "plain_text";
+
+export interface EmailTemplate {
+  id: number;
+  organization_id: number;
+  name: string;
+  code: string;
+  description: string | null;
+  category: string;
+  subject: string;
+  html_body: string;
+  plain_text_body: string | null;
+  format: EmailTemplateFormat;
+  status: EmailTemplateStatus;
+  created_at: string;
+  updated_at: string;
+  creator?: { id: number; name: string } | null;
+  updater?: { id: number; name: string } | null;
+}
+
+export interface EmailTemplatePayload {
+  name: string;
+  code: string;
+  description?: string | null;
+  category: string;
+  subject: string;
+  html_body: string;
+  plain_text_body?: string | null;
+  format: EmailTemplateFormat;
+  status: EmailTemplateStatus;
+}
+
+export interface EmailTemplateListResult {
+  data: EmailTemplate[];
+  total: number;
+}
+
+export interface EmailTemplateToken {
+  key: string;
+  label: string;
+  data_type: string;
+  default_value: string | null;
+  sample_value: string;
+}
+
+export interface EmailTemplateTokenGroup {
+  key: string;
+  label: string;
+  tokens: EmailTemplateToken[];
+}
+
+export interface EmailTemplateCategoryTokens {
+  category: string;
+  groups: EmailTemplateTokenGroup[];
+}
+
+export interface RenderedEmailTemplate {
+  template_id: number;
+  subject: string;
+  html_body: string;
+  plain_text_body: string;
+  missing_tokens: string[];
+  unknown_tokens: string[];
+}
+
+export async function getEmailTemplates(
+  params: Record<string, string | number> = {},
+): Promise<IApiResponse<EmailTemplateListResult>> {
+  const query = new URLSearchParams(
+    Object.entries(params).reduce<Record<string, string>>((result, [key, value]) => {
+      result[key] = String(value);
+      return result;
+    }, {}),
+  ).toString();
+  const response = await sendRequest({ url: `${BASE}${query ? `?${query}` : ""}`, method: "GET" });
+  return response.responseData as IApiResponse<EmailTemplateListResult>;
+}
+
+export async function getEmailTemplate(id: number): Promise<IApiResponse<EmailTemplate>> {
+  const response = await sendRequest({ url: `${BASE}/${id}`, method: "GET" });
+  return response.responseData as IApiResponse<EmailTemplate>;
+}
+
+export async function createEmailTemplate(
+  data: EmailTemplatePayload,
+): Promise<IApiResponse<EmailTemplate>> {
+  const response = await sendRequest({ url: BASE, method: "POST", data });
+  return response.responseData as IApiResponse<EmailTemplate>;
+}
+
+export async function updateEmailTemplate(
+  id: number,
+  data: EmailTemplatePayload,
+): Promise<IApiResponse<EmailTemplate>> {
+  const response = await sendRequest({ url: `${BASE}/${id}`, method: "PUT", data });
+  return response.responseData as IApiResponse<EmailTemplate>;
+}
+
+export async function deleteEmailTemplate(id: number): Promise<IApiResponse<null>> {
+  const response = await sendRequest({ url: `${BASE}/${id}`, method: "DELETE" });
+  return response.responseData as IApiResponse<null>;
+}
+
+export async function getEmailTemplateCategoryTokens(
+  category: string,
+): Promise<IApiResponse<EmailTemplateCategoryTokens>> {
+  const response = await sendRequest({
+    url: `${process.env.NEXT_PUBLIC_API_URL}/api/email-template-categories/${encodeURIComponent(category)}/tokens`,
+    method: "GET",
+  });
+  return response.responseData as IApiResponse<EmailTemplateCategoryTokens>;
+}
+
+export async function previewEmailTemplate(
+  id: number,
+  tokenData: Record<string, string> = {},
+): Promise<IApiResponse<RenderedEmailTemplate>> {
+  const response = await sendRequest({
+    url: `${BASE}/${id}/preview`,
+    method: "POST",
+    data: { token_data: tokenData },
+  });
+  return response.responseData as IApiResponse<RenderedEmailTemplate>;
+}

package/src/api-services/hr-attendance-shifts.client.ts

@@ -0,0 +1,90 @@
+import { sendRequest } from "../utils/httpClient";
+import { IApiResponse } from "../common/interfaces/ICommon";
+
+const callApi = async (url: string, method: "GET" | "POST", data?: any) => {
+  const response = await sendRequest({ url, method, data });
+  return response.responseData as IApiResponse;
+};
+
+const BASE_URL = `${process.env.NEXT_PUBLIC_API_URL}/api/hr`;
+
+export const getEmployeeCalendar = async (employeeId: string | number, startDate: string, endDate: string, projectId?: string | number, workforceId?: string | number): Promise<IApiResponse> => {
+  const params: any = { start_date: startDate, end_date: endDate };
+  if (projectId) params.project_id = projectId;
+  if (workforceId) params.workforce_id = workforceId;
+  const queryParams = new URLSearchParams(params);
+  
+  const url = employeeId === 'me' 
+    ? `${BASE_URL}/ess/me/calendar?${queryParams.toString()}`
+    : employeeId === 0 
+      ? `${BASE_URL}/calendar?${queryParams.toString()}` // For construction gangs
+      : `${BASE_URL}/employees/${employeeId}/calendar?${queryParams.toString()}`;
+    
+  const response = await sendRequest({ url, method: "GET" });
+  return response.responseData as IApiResponse;
+};
+
+export const toggleSegmentCancellation = async (employeeId: string | number, data: { roster_date: string, segment_no: number, reason?: string }): Promise<IApiResponse> => {
+  const url = employeeId === 'me' 
+    ? `${BASE_URL}/ess/me/calendar/cancel-segment`
+    : `${BASE_URL}/employees/${employeeId}/calendar/cancel-segment`;
+  
+  return callApi(url, 'POST', { ...data, employee_id: employeeId === 'me' ? undefined : employeeId });
+};
+export const requestSegmentExchange = async (
+  employeeId: string | number, 
+  data: { roster_date: string, segment_no: number, requester_id: number, responder_id: number, reason?: string }
+): Promise<IApiResponse> => {
+  const url = employeeId === 'me' 
+    ? `${BASE_URL}/ess/me/calendar/exchange-segment`
+    : `${BASE_URL}/employees/${employeeId}/calendar/exchange-segment`;
+
+  return callApi(url, 'POST', { ...data, employee_id: employeeId === 'me' ? undefined : employeeId });
+};
+
+export const cancelSegmentExchange = async (employeeId: string | number, exchangeId: number): Promise<IApiResponse> => {
+  const url = employeeId === 'me' 
+    ? `${BASE_URL}/ess/me/calendar/exchange-segment/${exchangeId}`
+    : `${BASE_URL}/employees/${employeeId}/calendar/exchange-segment/${exchangeId}`;
+
+  const response = await sendRequest({ url, method: "DELETE" });
+  return response.responseData as IApiResponse;
+};
+
+export const getDailyOverview = async (date: string): Promise<IApiResponse> => {
+  const response = await sendRequest({ url: `${BASE_URL}/calendar/daily-overview?date=${date}`, method: "GET" });
+  return response.responseData as IApiResponse;
+};
+
+export const getCalendarSummary = async (employeeId: string | number, month: string): Promise<IApiResponse> => {
+  const url = employeeId === 'me'
+    ? `${BASE_URL}/ess/me/calendar/summary?month=${month}`
+    : `${BASE_URL}/employees/${employeeId}/calendar/summary?month=${month}`;
+
+  const response = await sendRequest({ url, method: "GET" });
+  return response.responseData as IApiResponse;
+};
+
+export const getAttendanceDays = async (employeeId: string | number, startDate: string, endDate: string, projectId?: string | number, workforceId?: string | number): Promise<IApiResponse> => {
+  const params: any = { start_date: startDate, end_date: endDate };
+  if (employeeId !== 0 && employeeId !== 'me') params.employee_id = employeeId;
+  if (projectId) params.project_id = projectId;
+  if (workforceId) params.workforce_id = workforceId;
+  const queryParams = new URLSearchParams(params);
+
+  const url = employeeId === 'me'
+    ? `${BASE_URL}/ess/me/attendance/days?${queryParams.toString()}`
+    : `${BASE_URL}/attendance/days?${queryParams.toString()}`;
+
+  const response = await sendRequest({ url, method: "GET" });
+  return response.responseData as IApiResponse;
+};
+
+export const getPendingActions = async (employeeId: string | number): Promise<IApiResponse> => {
+  const url = employeeId === 'me'
+    ? `${BASE_URL}/ess/me/calendar/pending-actions`
+    : `${BASE_URL}/employees/${employeeId}/calendar/pending-actions`;
+
+  const response = await sendRequest({ url, method: "GET" });
+  return response.responseData as IApiResponse;
+};

package/src/api-services/hr-attendance.client.ts

@@ -0,0 +1,19 @@
+import { sendRequest } from "../utils/httpClient";
+import { IApiResponse } from "../common/interfaces/ICommon";
+
+const BASE_URL = `${process.env.NEXT_PUBLIC_API_URL}/api/hr/attendance`;
+
+export async function punchAttendance(data: any): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE_URL}/punch`, method: "POST", data });
+  return response.responseData as IApiResponse;
+}
+
+export async function bulkPunchAttendance(data: { punches: any[] }): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE_URL}/punches/bulk`, method: "POST", data });
+  return response.responseData as IApiResponse;
+}
+
+export async function getWorkforceAttendanceLookup(): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${process.env.NEXT_PUBLIC_API_URL}/api/construction/workforce/attendance-lookup`, method: "GET" });
+  return response.responseData as IApiResponse;
+}

package/src/api-services/hr-employees.client.ts

@@ -0,0 +1,8 @@
+import { sendRequest, IApiResponse } from "../client";
+
+const BASE = `${process.env.NEXT_PUBLIC_API_URL}/api/hr/employees`;
+
+export async function getEmployeeLookup(): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE}/lookup`, method: "GET" });
+  return response.responseData as IApiResponse;
+}

package/src/api-services/hr-shift-templates.client.ts

@@ -0,0 +1,68 @@
+import { sendRequest } from "../utils/httpClient";
+import { IApiResponse } from "../common/interfaces/ICommon";
+
+const BASE = `${process.env.NEXT_PUBLIC_API_URL}/api/hr/shift-templates`;
+const ASSIGN_BASE = `${process.env.NEXT_PUBLIC_API_URL}/api/hr/employees`;
+
+export const getShiftTemplates = async (page = 1, search = "", status = ""): Promise<IApiResponse> => {
+  const queryParams = new URLSearchParams({ page: page.toString() });
+  if (search) queryParams.append("search", search);
+  if (status) queryParams.append("status", status);
+  const response = await sendRequest({ url: `${BASE}?${queryParams.toString()}`, method: "GET" });
+  return response.responseData as IApiResponse;
+};
+
+export const getShiftTemplate = async (id: string | number): Promise<IApiResponse> => {
+  const response = await sendRequest({ url: `${BASE}/${id}`, method: "GET" });
+  return response.responseData as IApiResponse;
+};
+
+export const createShiftTemplate = async (data: any): Promise<IApiResponse> => {
+  const response = await sendRequest({ url: BASE, method: "POST", data });
+  return response.responseData as IApiResponse;
+};
+
+export const updateShiftTemplate = async (id: string | number, data: any): Promise<IApiResponse> => {
+  const response = await sendRequest({ url: `${BASE}/${id}`, method: "PUT", data });
+  return response.responseData as IApiResponse;
+};
+
+export const deleteShiftTemplate = async (id: string | number): Promise<IApiResponse> => {
+  const response = await sendRequest({ url: `${BASE}/${id}`, method: "DELETE" });
+  return response.responseData as IApiResponse;
+};
+
+export const getShiftTemplateLookup = async (): Promise<IApiResponse> => {
+  const response = await sendRequest({ url: `${BASE}/lookup`, method: "GET" });
+  return response.responseData as IApiResponse;
+};
+
+export const getEmployeeShiftAssignment = async (employeeId: string | number): Promise<IApiResponse> => {
+  const response = await sendRequest({ url: `${ASSIGN_BASE}/${employeeId}/shift-assignment`, method: "GET" });
+  return response.responseData as IApiResponse;
+};
+
+export const assignShiftToEmployee = async (employeeId: string | number, data: any): Promise<IApiResponse> => {
+  const response = await sendRequest({ url: `${ASSIGN_BASE}/${employeeId}/shift-assignment`, method: "POST", data });
+  return response.responseData as IApiResponse;
+};
+
+export const getTemplateAssignments = async (templateId: string | number): Promise<IApiResponse> => {
+  const response = await sendRequest({ url: `${BASE}/${templateId}/assignments`, method: "GET" });
+  return response.responseData as IApiResponse;
+};
+
+export async function assignEmployeesToTemplate(templateId: number, data: any): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE}/${templateId}/assignments`, method: "POST", data });
+  return response.responseData as IApiResponse;
+}
+
+export async function updateTemplateAssignment(templateId: number, assignmentId: number, data: any): Promise<IApiResponse> {
+  const response = await sendRequest({ url: `${BASE}/${templateId}/assignments/${assignmentId}`, method: "PUT", data });
+  return response.responseData as IApiResponse;
+}
+
+export const unassignEmployee = async (templateId: string | number, assignmentId: string | number): Promise<IApiResponse> => {
+  const response = await sendRequest({ url: `${BASE}/${templateId}/assignments/${assignmentId}`, method: "DELETE" });
+  return response.responseData as IApiResponse;
+};

package/src/api-services/inventory/brands.client.ts

@@ -1,4 +1,5 @@
-import { sendRequest, IApiResponse } from "@apptimate/core-lib";
+import { sendRequest } from "../../utils/httpClient";
+import { IApiResponse } from "../../common/interfaces/ICommon";
 
 const BASE = `${process.env.NEXT_PUBLIC_API_URL}/api/inventory/brands`;
 

package/src/api-services/inventory/categories.client.ts

@@ -1,4 +1,5 @@
-import { sendRequest, IApiResponse } from "@apptimate/core-lib";
+import { sendRequest } from "../../utils/httpClient";
+import { IApiResponse } from "../../common/interfaces/ICommon";
 
 const BASE = `${process.env.NEXT_PUBLIC_API_URL}/api/inventory/categories`;
 

package/src/api-services/inventory/inventory-settings.client.ts

@@ -1,6 +1,7 @@
 "use client";
 
-import { sendRequest, IApiResponse } from "@apptimate/core-lib";
+import { sendRequest } from "../../utils/httpClient";
+import { IApiResponse } from "../../common/interfaces/ICommon";
 
 const BASE_URL = process.env.NEXT_PUBLIC_API_URL || "http://localhost:8000";
 

package/src/api-services/inventory/items.client.ts

@@ -1,4 +1,5 @@
-import { sendRequest, IApiResponse } from "@apptimate/core-lib";
+import { sendRequest } from "../../utils/httpClient";
+import { IApiResponse } from "../../common/interfaces/ICommon";
 
 const BASE = `${process.env.NEXT_PUBLIC_API_URL}/api/inventory/items`;
 

package/src/api-services/inventory/parties.client.ts

@@ -1,4 +1,5 @@
-import { sendRequest, IApiResponse } from "@apptimate/core-lib";
+import { sendRequest } from "../../utils/httpClient";
+import { IApiResponse } from "../../common/interfaces/ICommon";
 
 const BASE = `${process.env.NEXT_PUBLIC_API_URL}/api/parties`;
 

package/src/api-services/inventory/transaction.client.ts

@@ -1,4 +1,5 @@
-import { sendRequest, IApiResponse } from "@apptimate/core-lib";
+import { sendRequest } from "../../utils/httpClient";
+import { IApiResponse } from "../../common/interfaces/ICommon";
 
 const INV_BASE = `${process.env.NEXT_PUBLIC_API_URL}/api/inventory`;
 const FIN_BASE = `${process.env.NEXT_PUBLIC_API_URL}/api/finance`;

package/src/api-services/inventory/uom-group.client.ts

@@ -1,4 +1,5 @@
-import { sendRequest, IApiResponse } from "@apptimate/core-lib";
+import { sendRequest } from "../../utils/httpClient";
+import { IApiResponse } from "../../common/interfaces/ICommon";
 
 const BASE = `${process.env.NEXT_PUBLIC_API_URL}/api/inventory/uom-groups`;
 

package/src/api-services/inventory/uom.client.ts

@@ -1,4 +1,5 @@
-import { sendRequest, IApiResponse } from "@apptimate/core-lib";
+import { sendRequest } from "../../utils/httpClient";
+import { IApiResponse } from "../../common/interfaces/ICommon";
 
 const BASE = `${process.env.NEXT_PUBLIC_API_URL}/api/inventory/uom`;
 

package/src/client.ts

@@ -13,4 +13,6 @@ export * from './utils/currencyService';
 
 export * from './api-services/procurement.client';
 export * from './api-services/printable-templates.client';
+export * from './api-services/email-templates.client';
+export * from './api-services/email-services.client';
 export * from './schemas/approvalWorkflowSchema';

package/src/constants/menus.ts

@@ -85,11 +85,13 @@ export const MENU_ITEM_REGISTRY: RegistryItem[] = [
   { key: 'core__feature_registry', label: 'Feature Registry', path: '/system/features', module: 'Core', defaultGroup: 'System Auditing', permission: 'feature.view' },
   { key: 'core__menu_config', label: 'Menu Configuration', path: '/menu-config', module: 'Core', defaultGroup: 'System', permission: 'menu_config.view' },
   { key: 'core__printables', label: 'Printable Templates', path: '/system/printables', module: 'Core', defaultGroup: 'System', permission: 'printable_template.view' },
+  { key: 'core__email_templates', label: 'Email Templates', path: '/system/email-templates', module: 'Core', defaultGroup: 'System', permission: 'email_template.view' },
   { key: 'core__template_groups', label: 'Template Groups', path: '/system/template-groups', module: 'Core', defaultGroup: 'System', permission: 'template_group.view' },
   { key: 'core__warehouses', label: 'Warehouses', path: '/warehouses', module: 'Core', defaultGroup: 'Resources', permission: 'warehouse.view' },
   { key: 'core__terminals', label: 'Terminals', path: '/terminals', module: 'Core', defaultGroup: 'Resources', permission: 'terminal.view' },
   { key: 'core__currencies', label: 'Currencies', path: '/currencies', module: 'Core', defaultGroup: 'Resources', permission: 'currency.view' },
   { key: 'core__settings', label: 'Settings', path: '/settings', module: 'Core', defaultGroup: 'Configuration', permission: 'core_setting.view' },
+  { key: 'core__email_services', label: 'Integrations', path: '/settings/integrations', module: 'Core', defaultGroup: 'Configuration', permission: 'email_connection.view' },
   { key: 'core__approval_workflows', label: 'Approval Workflows', path: '/settings/approvals', module: 'Core', defaultGroup: 'Configuration', permission: null },
 
   // ── Inventory Module ──
@@ -240,35 +242,38 @@ export const MENU_ITEM_REGISTRY: RegistryItem[] = [
   // ── Construction Module ──
   { key: 'construction__dashboard', label: 'Overview', path: '/construction', module: 'Construction', defaultGroup: 'Overview', permission: null },
 
-  { key: 'construction__projects', label: 'Projects', path: '/construction/projects', module: 'Construction', defaultGroup: 'Core Setup & Planning', permission: null },
-  { key: 'construction__rate_cards', label: 'Rate Cards', path: '/construction/rate-cards', module: 'Construction', defaultGroup: 'Core Setup & Planning', permission: null },
-  { key: 'construction__schedule_calendar', label: 'Resource Calendar', path: '/construction/scheduling/calendar', module: 'Construction', defaultGroup: 'Core Setup & Planning', permission: null },
-  { key: 'construction__hierarchy', label: 'Hierarchy', path: '/construction/hierarchy', module: 'Construction', defaultGroup: 'Core Setup & Planning', permission: null },
-  { key: 'construction__team', label: 'Team', path: '/construction/team', module: 'Construction', defaultGroup: 'Core Setup & Planning', permission: null },
-  { key: 'construction__budget', label: 'Budget', path: '/construction/budget', module: 'Construction', defaultGroup: 'Core Setup & Planning', permission: null },
+  // ── Client Portal Module ──
+  { key: 'client_portal__dashboard', label: 'Overview', path: '/construction-customers', module: 'Client Portal', defaultGroup: 'Overview', permission: null },
+  { key: 'construction__projects', label: 'Projects', path: '/construction/projects', module: 'Construction', defaultGroup: 'Project Planning', permission: null },
+  { key: 'construction__rate_cards', label: 'Rate Cards', path: '/construction/rate-cards', module: 'Construction', defaultGroup: 'Estimation & BOQ', permission: null },
+  { key: 'construction__schedule_calendar', label: 'Resource Calendar', path: '/construction/scheduling/calendar', module: 'Construction', defaultGroup: 'Project Planning', permission: null },
+  { key: 'construction__hierarchy', label: 'Hierarchy', path: '/construction/hierarchy', module: 'Construction', defaultGroup: 'Project Planning', permission: null },
+  { key: 'construction__team', label: 'Team', path: '/construction/team', module: 'Construction', defaultGroup: 'Project Planning', permission: null },
+  { key: 'construction__budget', label: 'Budget', path: '/construction/budget', module: 'Construction', defaultGroup: 'Project Planning', permission: null },
 
   { key: 'construction__main_contract', label: 'Main Contract', path: '/construction/contracts/main-contract', module: 'Construction', defaultGroup: 'Contracts & Billing', permission: null },
   { key: 'construction__subcontractors', label: 'Subcontractors', path: '/construction/contracts/subcontractors', module: 'Construction', defaultGroup: 'Contracts & Billing', permission: null },
   { key: 'construction__ipcs', label: 'Progress Billing', path: '/construction/contracts/progress-billing', module: 'Construction', defaultGroup: 'Contracts & Billing', permission: null },
   { key: 'construction__variations', label: 'Subcontractor Variations', path: '/construction/variations', module: 'Construction', defaultGroup: 'Contracts & Billing', permission: null },
-  { key: 'construction__boq', label: 'Bill of Quantities (BOQ)', path: '/construction/boq', module: 'Construction', defaultGroup: 'Commercials & BOQ', permission: null },
-  { key: 'construction__boq_revisions', label: 'BOQ Revisions', path: '/construction/boq/revisions', module: 'Construction', defaultGroup: 'Commercials & BOQ', permission: null },
-  { key: 'construction__assemblies', label: 'Assemblies', path: '/construction/assemblies', module: 'Construction', defaultGroup: 'Commercials & BOQ', permission: null },
-  { key: 'construction__assembly_groups', label: 'Assembly Groups', path: '/construction/assembly-groups', module: 'Construction', defaultGroup: 'Commercials & BOQ', permission: null },
+  { key: 'construction__boq', label: 'Bill of Quantities (BOQ)', path: '/construction/boq', module: 'Construction', defaultGroup: 'Estimation & BOQ', permission: null },
+  { key: 'construction__boq_revisions', label: 'BOQ Revisions', path: '/construction/boq/revisions', module: 'Construction', defaultGroup: 'Estimation & BOQ', permission: null },
+  { key: 'construction__assemblies', label: 'Assemblies', path: '/construction/assemblies', module: 'Construction', defaultGroup: 'Estimation & BOQ', permission: null },
+  { key: 'construction__assembly_groups', label: 'Assembly Groups', path: '/construction/assembly-groups', module: 'Construction', defaultGroup: 'Estimation & BOQ', permission: null },
 
 
 
-  { key: 'construction__workforce', label: 'Workforce Master', path: '/construction/workforce', module: 'Construction', defaultGroup: 'Workforce', permission: null },
-  { key: 'construction__workforce_allocation', label: 'Workforce Allocation', path: '/construction/workforce/allocation', module: 'Construction', defaultGroup: 'Workforce', permission: null },
-  { key: 'construction__shifts', label: 'Shift Master', path: '/construction/shifts', module: 'Construction', defaultGroup: 'Workforce', permission: null },
-  { key: 'construction__attendance', label: 'Attendance & Timesheets', path: '/construction/attendance', module: 'Construction', defaultGroup: 'Workforce', permission: null },
+  { key: 'construction__workforce', label: 'Workforce Master', path: '/construction/workforce', module: 'Construction', defaultGroup: 'Workforce Management', permission: null },
+  { key: 'construction__workforce_allocation', label: 'Workforce Allocation', path: '/construction/workforce/allocation', module: 'Construction', defaultGroup: 'Workforce Management', permission: null },
+  { key: 'construction__shifts', label: 'Shift Master', path: '/construction/shifts', module: 'Construction', defaultGroup: 'Workforce Management', permission: null },
+  { key: 'construction__attendance', label: 'Attendance & Timesheets', path: '/construction/attendance', module: 'Construction', defaultGroup: 'Workforce Management', permission: null },
 
-  { key: 'construction__equipment_types', label: 'Equipment Types', path: '/construction/equipment/types', module: 'Construction', defaultGroup: 'Equipment & Plant', permission: null },
-  { key: 'construction__equipment', label: 'Equipments', path: '/construction/equipment', module: 'Construction', defaultGroup: 'Equipment & Plant', permission: null },
-  { key: 'construction__equipment_allocation', label: 'Equipment Allocation', path: '/construction/equipment/allocation', module: 'Construction', defaultGroup: 'Equipment & Plant', permission: null },
-  { key: 'construction__fuel_logs', label: 'Fuel Logs', path: '/construction/equipment/fuel-logs', module: 'Construction', defaultGroup: 'Equipment & Plant', permission: null },
-  { key: 'construction__maintenance', label: 'Maintenance', path: '/construction/equipment/maintenance', module: 'Construction', defaultGroup: 'Equipment & Plant', permission: null },
+  { key: 'construction__equipment_types', label: 'Equipment Types', path: '/construction/equipment/types', module: 'Construction', defaultGroup: 'Plant & Equipment', permission: null },
+  { key: 'construction__equipment', label: 'Equipments', path: '/construction/equipment', module: 'Construction', defaultGroup: 'Plant & Equipment', permission: null },
+  { key: 'construction__equipment_allocation', label: 'Equipment Allocation', path: '/construction/equipment/allocation', module: 'Construction', defaultGroup: 'Plant & Equipment', permission: null },
+  { key: 'construction__fuel_logs', label: 'Fuel Logs', path: '/construction/equipment/fuel-logs', module: 'Construction', defaultGroup: 'Plant & Equipment', permission: null },
+  { key: 'construction__maintenance', label: 'Maintenance', path: '/construction/equipment/maintenance', module: 'Construction', defaultGroup: 'Plant & Equipment', permission: null },
 
+  { key: 'construction__site_engineer', label: 'Site Engineer', path: '/construction/dashboard/site-engineer', module: 'Construction', defaultGroup: 'Site Execution', permission: null },
   { key: 'construction__dsr', label: 'Daily Site Reports', path: '/construction/site-execution/dsr', module: 'Construction', defaultGroup: 'Site Execution', permission: null },
   { key: 'construction__progress', label: 'Progress Measurement', path: '/construction/site-execution/progress', module: 'Construction', defaultGroup: 'Site Execution', permission: null },
   { key: 'construction__subcontractor_progress', label: 'Subcontractor Progress', path: '/construction/site-execution/subcontractor-progress', module: 'Construction', defaultGroup: 'Site Execution', permission: null },
@@ -380,7 +385,7 @@ export const MENU_PRESETS: MenuPreset[] = [
           'core__warehouses', 'core__terminals',
           'core__activity_logs', 'core__api_requests', 'core__feature_access_logs',
           'core__issue_logs', 'core__feature_registry', 'core__menu_config',
-          'core__printables', 'core__template_groups', 'core__currencies', 'core__settings', 'core__approval_workflows',
+          'core__printables', 'core__email_templates', 'core__template_groups', 'core__currencies', 'core__settings', 'core__email_services', 'core__approval_workflows',
         ],
       },
       {
@@ -506,54 +511,65 @@ export const MENU_PRESETS: MenuPreset[] = [
       {
         id: 'construction',
         label: 'Construction',
-        iconName: 'Crane',
+        iconName: 'Hammer',
         secondaryItems: [
+          // 1. Overview
           'construction__dashboard',
+          // 2. Project Planning
           'construction__projects',
-          'construction__rate_cards',
+          'construction__schedule_calendar',
           'construction__hierarchy',
-          'construction__team',
           'construction__budget',
-          'construction__mtrs',
-          'construction__prs',
-          'construction__pos',
-          'construction__grns',
-          'construction__site_ledger',
-          'construction__site_issues',
-          'construction__wastage_returns',
-          'construction__variations',
+          'construction__team',
+          // 3. Estimation & BOQ
           'construction__boq',
           'construction__boq_revisions',
+          'construction__rate_cards',
           'construction__assemblies',
           'construction__assembly_groups',
+          // 4. Contracts & Billing
+          'construction__main_contract',
+          'construction__subcontractors',
+          'construction__ipcs',
+          'construction__variations',
+          // 5. Workforce Management
           'construction__workforce',
           'construction__workforce_allocation',
           'construction__shifts',
           'construction__attendance',
+          // 6. Plant & Equipment
           'construction__equipment_types',
           'construction__equipment',
           'construction__equipment_allocation',
           'construction__fuel_logs',
           'construction__maintenance',
-          'construction__schedule_calendar',
-          'construction__main_contract',
-          'construction__subcontractors',
-          'construction__ipcs',
+          // 7. Site Execution
+          'construction__site_engineer',
           'construction__dsr',
           'construction__progress',
           'construction__subcontractor_progress',
           'construction__change_orders',
+          'construction__mtrs',
+          'construction__prs',
+          'construction__pos',
+          'construction__grns',
+          'construction__site_ledger',
+          'construction__site_issues',
+          'construction__wastage_returns',
+          // 8. Document Control
           'construction__drawings',
-          'construction__transmittals',
           'construction__rfis',
+          'construction__transmittals',
+          // 9. Quality & Safety
           'construction__quality_ir',
           'construction__quality_ncr',
           'construction__punch_list',
           'construction__material_testing',
           'construction__safety_incidents',
           'construction__ptw',
-          'construction__test_types',
+          // 10. Configuration
           'construction__project_categories',
+          'construction__test_types',
           'construction__settings',
         ],
       },
@@ -564,6 +580,14 @@ export const MENU_PRESETS: MenuPreset[] = [
         secondaryItems: [
           ...CRM_SECONDARY_ITEM_KEYS,
         ],
+      },
+      {
+        id: 'site_engineer',
+        label: 'Site Engineer',
+        iconName: 'Wrench',
+        secondaryItems: [
+          'construction__site_engineer',
+        ],
       }
     ],
   },

package/src/constants/storageKeys.ts

@@ -11,5 +11,6 @@ export const cookie = {
 export const local_storage = {
     user_info: { name: 'user_info', secretName: 'USER_INFO_SECRET', encrypted: false } as IStorageOptions,
     selected_organization: { name: 'selected_organization', secretName: 'SELECTED_ORG', encrypted: false } as IStorageOptions,
-    sales_terminal: { name: 'sales_terminal', secretName: 'SALES_TERMINAL', encrypted: false } as IStorageOptions
+    sales_terminal: { name: 'sales_terminal', secretName: 'SALES_TERMINAL', encrypted: false } as IStorageOptions,
+    active_project: { name: 'active_project', secretName: 'ACTIVE_PROJECT', encrypted: false } as IStorageOptions
 };

package/src/index.ts

@@ -10,4 +10,8 @@ export * from './api-services/inventory/uom.client';
 export * from './api-services/inventory/uom-group.client';
 export * from './api-services/inventory/parties.client';
 export * from './api-services/inventory/transaction.client';
-export * from './utils/PriceCalculationService';
+export * from './utils/PriceCalculationService';
+export * from './api-services/hr-attendance.client';
+export * from './api-services/hr-attendance-shifts.client';
+export * from './api-services/hr-shift-templates.client';
+export * from './api-services/hr-employees.client';

package/src/server.ts

@@ -13,3 +13,4 @@ export * from './utils/bootstrapConfig';
 
 export * from './api-services/procurement.client';
 export * from './api-services/printable-templates.client';
+export * from './api-services/email-templates.client';