indas-ui 0.0.1 → 0.1.0

package/dist/lib/api/activity/audit/audit.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Audit API Client
+ *
+ * logAction: POST /api/auditlog — fire-and-forget business/security event logging
+ * getStats: GET /api/auditlog/stats — dashboard statistics
+ *
+ * The audit logs page fetches directly via APIClient — no wrapper needed.
+ */
+import type { APIResponse } from '../../core/types.js';
+import type { BackendAuditLogRequest } from '../../../../types/audit.js';
+declare class AuditAPI {
+    /**
+     * Log an audit event (business action or security event)
+     */
+    static logAction(request: BackendAuditLogRequest, session: any): Promise<APIResponse<{
+        auditLogId: number;
+    }>>;
+    /**
+     * Get audit log statistics
+     */
+    static getStats(startDate?: string, session?: any): Promise<APIResponse<{
+        TotalLogs: number;
+        LoginSuccesses: number;
+        LoginFailures: number;
+        Logouts: number;
+        RateLimitExceeded: number;
+        UnauthorizedAccess: number;
+        UniqueUsers: number;
+        UniqueIPAddresses: number;
+        BusinessActions: number;
+    }>>;
+}
+export default AuditAPI;
+export { AuditAPI, AuditAPI as BusinessAuditAPI };

package/dist/lib/api/activity/audit/audit.js

@@ -0,0 +1,44 @@
+'use client';
+/**
+ * Audit API Client
+ *
+ * logAction: POST /api/auditlog — fire-and-forget business/security event logging
+ * getStats: GET /api/auditlog/stats — dashboard statistics
+ *
+ * The audit logs page fetches directly via APIClient — no wrapper needed.
+ */
+import APIClient from '../../core/client.js';
+class AuditAPI {
+    /**
+     * Log an audit event (business action or security event)
+     */
+    static async logAction(request, session) {
+        try {
+            const response = await APIClient.post('/api/auditlog', request, session);
+            if (response.success && response.data) {
+                return { success: true, data: { auditLogId: response.data.auditLogId } };
+            }
+            return { success: false, error: response.error || 'Failed to log audit event' };
+        }
+        catch (error) {
+            // Silent — audit failure must never break business flows
+            return { success: false, error: error instanceof Error ? error.message : 'Unknown error' };
+        }
+    }
+    /**
+     * Get audit log statistics
+     */
+    static async getStats(startDate, session) {
+        try {
+            const queryParams = new URLSearchParams();
+            if (startDate)
+                queryParams.append('startDate', startDate);
+            return await APIClient.get(`/api/auditlog/stats?${queryParams.toString()}`, session);
+        }
+        catch (error) {
+            return { success: false, error: error instanceof Error ? error.message : 'Unknown error' };
+        }
+    }
+}
+export default AuditAPI;
+export { AuditAPI, AuditAPI as BusinessAuditAPI };

package/dist/lib/api/activity/audit/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Audit API Module
+ * Exports audit logging functionality
+ */
+export { default as AuditAPI, BusinessAuditAPI } from './audit.js';
+export * from './send.js';

package/dist/lib/api/activity/audit/index.js

@@ -0,0 +1,7 @@
+'use client';
+/**
+ * Audit API Module
+ * Exports audit logging functionality
+ */
+export { default as AuditAPI, BusinessAuditAPI } from './audit.js';
+export * from './send.js';

package/dist/lib/api/activity/audit/send.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Audit Log Trigger Helpers
+ *
+ * Fire-and-forget functions that log business actions after events.
+ * These NEVER block the calling flow — errors are silently swallowed.
+ *
+ * Usage:
+ *   import { logQuotationApproved, logMasterCrud } from './send.js'
+ *   logQuotationApproved({ bookingNo: 'BK-001', ... }, session)
+ */
+import { AuditModule, AuditAction } from '../../../../types/audit.js';
+/**
+ * Generic audit log — for any module/action not covered by a named helper.
+ * Fire-and-forget. Use via `notifyAndLog` for the standard notify+audit combo.
+ */
+export declare function logAction(params: {
+    module: AuditModule | string;
+    action: AuditAction | string;
+    documentName: string;
+    documentId?: number;
+    comments?: string;
+    metadata?: Record<string, any>;
+}, session: any): void;
+interface EstimationParams {
+    bookingNo?: string;
+    bookingId?: string | number;
+    jobName?: string;
+    clientName?: string;
+    actorUserName: string;
+}
+export declare function logEstimationCreated(params: EstimationParams, session: any): void;
+export declare function logEstimationUpdated(params: EstimationParams & {
+    changes?: string;
+}, session: any): void;
+export declare function logEstimationDeleted(params: EstimationParams, session: any): void;
+interface PlanningParams {
+    bookingNo?: string;
+    bookingId?: string | number;
+    columnId?: number;
+    machineName?: string;
+    actorUserName: string;
+}
+export declare function logPlanningApplied(params: PlanningParams, session: any): void;
+export declare function logPlanningCleared(params: PlanningParams, session: any): void;
+interface MaterialCostingParams {
+    bookingNo?: string;
+    bookingId?: string | number;
+    columnId?: number;
+    materialCount?: number;
+    actorUserName: string;
+}
+export declare function logMaterialCostingSaved(params: MaterialCostingParams, session: any): void;
+interface QuotationParams {
+    bookingNo: string;
+    bookingId: string | number;
+    actorUserName: string;
+    remarks?: string;
+}
+export declare function logQuotationSaved(params: QuotationParams, session: any): void;
+export declare function logQuotationApproved(params: QuotationParams, session: any): void;
+export declare function logQuotationRejected(params: QuotationParams, session: any): void;
+export declare function logQuotationDeleted(params: QuotationParams, session: any): void;
+interface EnquiryParams {
+    enquiryId: number;
+    enquiryNo: string;
+    jobName?: string;
+    clientName?: string;
+    actorUserName: string;
+}
+export declare function logEnquiryCreated(params: EnquiryParams, session: any): void;
+export declare function logEnquiryUpdated(params: EnquiryParams, session: any): void;
+export declare function logEnquirySavedAs(params: EnquiryParams, session: any): void;
+export declare function logEnquiryDeleted(params: EnquiryParams, session: any): void;
+export declare function logEnquiryConverted(params: EnquiryParams, session: any): void;
+interface MasterCrudParams {
+    masterType: string;
+    action: 'create' | 'update' | 'delete';
+    documentId?: number;
+    entityName?: string;
+    entityCode?: string;
+    actorUserName: string;
+}
+export declare function logMasterCrud(params: MasterCrudParams, session: any): void;
+interface ProcessParams {
+    bookingNo?: string;
+    bookingId?: string | number;
+    processName: string;
+    processId: number;
+    actorUserName: string;
+}
+export declare function logProcessSelected(params: ProcessParams, session: any): void;
+interface PriceApprovalParams {
+    bookingNo: string;
+    bookingId: string | number;
+    quotedCost?: number;
+    finalCost?: number;
+    actorUserName: string;
+    remarks?: string;
+}
+export declare function logPriceApprovalSaved(params: PriceApprovalParams, session: any): void;
+export declare function logPriceApprovalDeleted(params: {
+    bookingNo: string;
+    bookingId: string | number;
+    actorUserName: string;
+}, session: any): void;
+export declare function logSettingsChanged(params: {
+    settingName: string;
+    oldValue?: any;
+    newValue?: any;
+    actorUserName: string;
+}, session: any): void;
+export declare function logGridCostingImported(params: {
+    rowCount: number;
+    actorUserName: string;
+}, session: any): void;
+export declare function logGridCostingSaved(params: {
+    actorUserName: string;
+    rowCount?: number;
+}, session: any): void;
+export declare function logRateEnquiryCreated(params: {
+    requestNumber?: string;
+    actorUserName: string;
+}, session: any): void;
+export declare function logRateProvided(params: {
+    requestId: number;
+    requestNumber?: string;
+    actorUserName: string;
+}, session: any): void;
+export declare function logCompanyCrud(params: {
+    entityType: string;
+    action: 'create' | 'update' | 'delete';
+    entityName?: string;
+    documentId?: number;
+    actorUserName: string;
+}, session: any): void;
+export declare function logRateSettingsUpdated(params: {
+    settingType: string;
+    itemCount?: number;
+    actorUserName: string;
+}, session: any): void;
+export declare function logRateSettingsImported(params: {
+    settingType: string;
+    itemCount?: number;
+    actorUserName: string;
+}, session: any): void;
+export declare function logQuotationMailSent(params: {
+    bookingNo: string;
+    bookingId: string | number;
+    emailTo: string;
+    actorUserName: string;
+}, session: any): void;
+export {};

package/dist/lib/api/activity/audit/send.js

@@ -0,0 +1,403 @@
+'use client';
+/**
+ * Audit Log Trigger Helpers
+ *
+ * Fire-and-forget functions that log business actions after events.
+ * These NEVER block the calling flow — errors are silently swallowed.
+ *
+ * Usage:
+ *   import { logQuotationApproved, logMasterCrud } from './send.js'
+ *   logQuotationApproved({ bookingNo: 'BK-001', ... }, session)
+ */
+import { AuditModule, AuditAction } from '../../../../types/audit.js';
+/**
+ * Resolve the current page's ModuleDisplayName from the navigation cache in localStorage.
+ * Falls back to the enum value if no match is found.
+ */
+function resolveModuleDisplayName(enumValue) {
+    try {
+        if (typeof window === 'undefined')
+            return enumValue;
+        const pathname = window.location.pathname;
+        // Find the navigation cache key (navigation_{companyId}_{userId})
+        for (let i = 0; i < localStorage.length; i++) {
+            const key = localStorage.key(i);
+            if (!key?.startsWith('navigation_') || key.endsWith('_time'))
+                continue;
+            const cached = localStorage.getItem(key);
+            if (!cached)
+                continue;
+            const groups = JSON.parse(cached);
+            for (const group of groups) {
+                for (const mod of group.modules || []) {
+                    const modPath = mod.ModuleName?.startsWith('/') ? mod.ModuleName : `/${(mod.ModuleName || '').toLowerCase().trim().replace(/\s+/g, '-')}`;
+                    if (pathname.startsWith(modPath))
+                        return mod.ModuleDisplayName || enumValue;
+                    for (const child of mod.children || []) {
+                        const childPath = child.ModuleName?.startsWith('/') ? child.ModuleName : `/${(child.ModuleName || '').toLowerCase().trim().replace(/\s+/g, '-')}`;
+                        if (pathname.startsWith(childPath))
+                            return child.ModuleDisplayName || enumValue;
+                    }
+                }
+            }
+            break; // Only check first matching cache entry
+        }
+    }
+    catch { /* silent */ }
+    return enumValue;
+}
+/**
+ * Fire-and-forget: POST directly to backend with all required headers.
+ * Bypasses APIClient to avoid config/init issues — audit must never block.
+ */
+function fireAudit(fields, session) {
+    try {
+        const baseUrl = process.env.NEXT_PUBLIC_API_BASE_URL || '';
+        const companyId = (session?.user?.CompanyID || session?.user?.companyID || '0').toString();
+        const userId = (session?.user?.UserID || session?.user?.userID || '0').toString();
+        const productionUnitId = (session?.user?.ProductionUnitID || session?.user?.productionUnitID || '0').toString();
+        const fYear = (session?.user?.FYear || session?.user?.fYear || '').toString();
+        const companyUsername = session?.user?.companyUsername || '';
+        const companyPassword = session?.user?.companyPassword || '';
+        let basicAuth = '';
+        if (companyUsername && companyPassword) {
+            try {
+                basicAuth = 'Basic ' + btoa(unescape(encodeURIComponent(`${companyUsername}:${companyPassword}`)));
+            }
+            catch {
+                basicAuth = '';
+            }
+        }
+        const body = JSON.stringify({
+            Event: 'BUSINESS_ACTION',
+            Username: session?.user?.UserName || '',
+            UserID: userId,
+            CompanyID: companyId,
+            UserAgent: typeof navigator !== 'undefined' ? navigator.userAgent : undefined,
+            Success: true,
+            Module: resolveModuleDisplayName(fields.module),
+            Action: fields.action,
+            DocumentName: fields.documentName,
+            DocumentID: fields.documentId?.toString(),
+            Comments: fields.comments,
+            Metadata: fields.metadata && Object.keys(fields.metadata).length > 0 ? fields.metadata : undefined,
+        });
+        const headers = {
+            'Content-Type': 'application/json',
+            'CompanyID': companyId,
+            'UserID': userId,
+            'ProductionUnitID': productionUnitId,
+            'FYear': fYear,
+        };
+        if (basicAuth)
+            headers['Authorization'] = basicAuth;
+        fetch(`${baseUrl}/api/auditlog`, { method: 'POST', headers, body }).catch(() => {
+            // Silent — audit failure must never break business flows
+        });
+    }
+    catch {
+        // Silent
+    }
+}
+/**
+ * Generic audit log — for any module/action not covered by a named helper.
+ * Fire-and-forget. Use via `notifyAndLog` for the standard notify+audit combo.
+ */
+export function logAction(params, session) {
+    fireAudit({
+        module: String(params.module),
+        action: String(params.action),
+        documentName: params.documentName,
+        documentId: params.documentId,
+        comments: params.comments,
+        metadata: params.metadata,
+    }, session);
+}
+export function logEstimationCreated(params, session) {
+    fireAudit({
+        module: AuditModule.ESTIMATION,
+        action: AuditAction.CREATE,
+        documentName: 'Estimation',
+        documentId: params.bookingId ? Number(params.bookingId) : undefined,
+        metadata: { bookingNo: params.bookingNo, jobName: params.jobName, clientName: params.clientName },
+        comments: `Created estimation ${params.bookingNo || ''} — ${params.jobName || ''}`
+    }, session);
+}
+export function logEstimationUpdated(params, session) {
+    fireAudit({
+        module: AuditModule.ESTIMATION,
+        action: AuditAction.UPDATE,
+        documentName: 'Estimation',
+        documentId: params.bookingId ? Number(params.bookingId) : undefined,
+        metadata: { bookingNo: params.bookingNo, jobName: params.jobName, clientName: params.clientName, changes: params.changes },
+        comments: `Updated estimation ${params.bookingNo || ''}`
+    }, session);
+}
+export function logEstimationDeleted(params, session) {
+    fireAudit({
+        module: AuditModule.ESTIMATION,
+        action: AuditAction.DELETE,
+        documentName: 'Estimation',
+        documentId: params.bookingId ? Number(params.bookingId) : undefined,
+        metadata: { bookingNo: params.bookingNo, jobName: params.jobName, clientName: params.clientName },
+        comments: `Deleted estimation ${params.bookingNo || ''}`
+    }, session);
+}
+export function logPlanningApplied(params, session) {
+    fireAudit({
+        module: AuditModule.PLANNING,
+        action: AuditAction.APPLY_PLANNING,
+        documentName: 'Planning',
+        documentId: params.bookingId ? Number(params.bookingId) : undefined,
+        metadata: { bookingNo: params.bookingNo, columnId: params.columnId, machineName: params.machineName },
+        comments: `Applied planning for ${params.bookingNo || ''} col ${params.columnId || ''}`
+    }, session);
+}
+export function logPlanningCleared(params, session) {
+    fireAudit({
+        module: AuditModule.PLANNING,
+        action: AuditAction.CLEAR_PLANNING,
+        documentName: 'Planning',
+        documentId: params.bookingId ? Number(params.bookingId) : undefined,
+        metadata: { bookingNo: params.bookingNo, columnId: params.columnId },
+        comments: `Cleared planning for ${params.bookingNo || ''} col ${params.columnId || ''}`
+    }, session);
+}
+export function logMaterialCostingSaved(params, session) {
+    fireAudit({
+        module: AuditModule.MATERIAL,
+        action: AuditAction.UPDATE,
+        documentName: 'MaterialCosting',
+        documentId: params.bookingId ? Number(params.bookingId) : undefined,
+        metadata: { bookingNo: params.bookingNo, columnId: params.columnId, materialCount: params.materialCount },
+        comments: `Saved material costing for ${params.bookingNo || ''} col ${params.columnId || ''} (${params.materialCount || 0} materials)`
+    }, session);
+}
+export function logQuotationSaved(params, session) {
+    fireAudit({
+        module: AuditModule.QUOTATION,
+        action: AuditAction.CREATE,
+        documentName: 'Quotation',
+        documentId: Number(params.bookingId),
+        metadata: { bookingNo: params.bookingNo, remarks: params.remarks },
+        comments: `Saved quotation ${params.bookingNo}`
+    }, session);
+}
+export function logQuotationApproved(params, session) {
+    fireAudit({
+        module: AuditModule.APPROVAL,
+        action: AuditAction.APPROVE,
+        documentName: 'Quotation',
+        documentId: Number(params.bookingId),
+        metadata: { bookingNo: params.bookingNo, remarks: params.remarks },
+        comments: `Approved quotation ${params.bookingNo}${params.remarks ? ` — ${params.remarks}` : ''}`
+    }, session);
+}
+export function logQuotationRejected(params, session) {
+    fireAudit({
+        module: AuditModule.APPROVAL,
+        action: AuditAction.REJECT,
+        documentName: 'Quotation',
+        documentId: Number(params.bookingId),
+        metadata: { bookingNo: params.bookingNo, remarks: params.remarks },
+        comments: `Rejected quotation ${params.bookingNo}${params.remarks ? ` — ${params.remarks}` : ''}`
+    }, session);
+}
+export function logQuotationDeleted(params, session) {
+    fireAudit({
+        module: AuditModule.QUOTATION,
+        action: AuditAction.DELETE,
+        documentName: 'Quotation',
+        documentId: Number(params.bookingId),
+        metadata: { bookingNo: params.bookingNo },
+        comments: `Deleted quotation ${params.bookingNo}`
+    }, session);
+}
+export function logEnquiryCreated(params, session) {
+    fireAudit({
+        module: 'Enquiry',
+        action: AuditAction.CREATE,
+        documentName: 'Enquiry',
+        documentId: params.enquiryId,
+        metadata: { enquiryNo: params.enquiryNo, jobName: params.jobName, clientName: params.clientName },
+        comments: `Created enquiry ${params.enquiryNo} — ${params.jobName || ''}`
+    }, session);
+}
+export function logEnquiryUpdated(params, session) {
+    fireAudit({
+        module: 'Enquiry',
+        action: AuditAction.UPDATE,
+        documentName: 'Enquiry',
+        documentId: params.enquiryId,
+        metadata: { enquiryNo: params.enquiryNo, jobName: params.jobName, clientName: params.clientName },
+        comments: `Updated enquiry ${params.enquiryNo}`
+    }, session);
+}
+export function logEnquirySavedAs(params, session) {
+    fireAudit({
+        module: 'Enquiry',
+        action: AuditAction.SAVE_AS,
+        documentName: 'Enquiry',
+        documentId: params.enquiryId,
+        metadata: { enquiryNo: params.enquiryNo, jobName: params.jobName, clientName: params.clientName },
+        comments: `Saved as new enquiry ${params.enquiryNo} — ${params.jobName || ''}`
+    }, session);
+}
+export function logEnquiryDeleted(params, session) {
+    fireAudit({
+        module: 'Enquiry',
+        action: AuditAction.DELETE,
+        documentName: 'Enquiry',
+        documentId: params.enquiryId,
+        metadata: { enquiryNo: params.enquiryNo },
+        comments: `Deleted enquiry ${params.enquiryNo}`
+    }, session);
+}
+export function logEnquiryConverted(params, session) {
+    fireAudit({
+        module: 'Enquiry',
+        action: AuditAction.EXPORT,
+        documentName: 'Enquiry',
+        documentId: params.enquiryId,
+        metadata: { enquiryNo: params.enquiryNo, jobName: params.jobName, clientName: params.clientName },
+        comments: `Converted enquiry ${params.enquiryNo} to estimation`
+    }, session);
+}
+export function logMasterCrud(params, session) {
+    const actionMap = {
+        create: AuditAction.CREATE,
+        update: AuditAction.UPDATE,
+        delete: AuditAction.DELETE
+    };
+    const verb = params.action === 'create' ? 'Created' : params.action === 'update' ? 'Updated' : 'Deleted';
+    fireAudit({
+        module: AuditModule.MASTER_DATA,
+        action: actionMap[params.action],
+        documentName: params.masterType,
+        documentId: params.documentId,
+        metadata: { masterType: params.masterType, entityName: params.entityName, entityCode: params.entityCode },
+        comments: `${verb} ${params.masterType}: ${params.entityName || params.entityCode || params.documentId || ''}`
+    }, session);
+}
+export function logProcessSelected(params, session) {
+    fireAudit({
+        module: AuditModule.PROCESS,
+        action: AuditAction.SELECT_PROCESS,
+        documentName: 'Process',
+        documentId: params.processId,
+        metadata: { bookingNo: params.bookingNo, processName: params.processName },
+        comments: `Selected process "${params.processName}" for ${params.bookingNo || ''}`
+    }, session);
+}
+export function logPriceApprovalSaved(params, session) {
+    fireAudit({
+        module: AuditModule.APPROVAL,
+        action: AuditAction.CREATE,
+        documentName: 'PriceApproval',
+        documentId: Number(params.bookingId),
+        metadata: { bookingNo: params.bookingNo, quotedCost: params.quotedCost, finalCost: params.finalCost, remarks: params.remarks },
+        comments: `Price approval saved for ${params.bookingNo}`
+    }, session);
+}
+export function logPriceApprovalDeleted(params, session) {
+    fireAudit({
+        module: AuditModule.APPROVAL,
+        action: AuditAction.DELETE,
+        documentName: 'PriceApproval',
+        documentId: Number(params.bookingId),
+        metadata: { bookingNo: params.bookingNo },
+        comments: `Price approval deleted for ${params.bookingNo}`
+    }, session);
+}
+// ─── Settings ────────────────────────────────────────────────────────────
+export function logSettingsChanged(params, session) {
+    fireAudit({
+        module: AuditModule.SETTINGS,
+        action: AuditAction.UPDATE,
+        documentName: 'Settings',
+        metadata: { settingName: params.settingName, oldValue: params.oldValue, newValue: params.newValue },
+        comments: `Changed setting: ${params.settingName}`
+    }, session);
+}
+// ─── Grid Costing ───────────────────────────────────────────────────────
+export function logGridCostingImported(params, session) {
+    fireAudit({
+        module: 'Grid Costing',
+        action: AuditAction.IMPORT,
+        documentName: 'Grid Costing',
+        metadata: { rowCount: params.rowCount },
+        comments: `Imported ${params.rowCount} grid costing rows`
+    }, session);
+}
+export function logGridCostingSaved(params, session) {
+    fireAudit({
+        module: 'Grid Costing',
+        action: AuditAction.UPDATE,
+        documentName: 'Grid Costing',
+        metadata: { rowCount: params.rowCount },
+        comments: `Saved grid costing (${params.rowCount || 0} rows)`
+    }, session);
+}
+// ─── Rate Enquiry ───────────────────────────────────────────────────────
+export function logRateEnquiryCreated(params, session) {
+    fireAudit({
+        module: 'Rate Enquiry',
+        action: AuditAction.CREATE,
+        documentName: 'Rate Enquiry',
+        metadata: { requestNumber: params.requestNumber },
+        comments: `Created rate enquiry ${params.requestNumber || ''}`
+    }, session);
+}
+export function logRateProvided(params, session) {
+    fireAudit({
+        module: 'Rate Enquiry',
+        action: AuditAction.UPDATE,
+        documentName: 'Rate Enquiry',
+        documentId: params.requestId,
+        metadata: { requestNumber: params.requestNumber },
+        comments: `Provided rate for ${params.requestNumber || params.requestId}`
+    }, session);
+}
+// ─── Company Master ─────────────────────────────────────────────────────
+export function logCompanyCrud(params, session) {
+    const actionMap = { create: AuditAction.CREATE, update: AuditAction.UPDATE, delete: AuditAction.DELETE };
+    const verb = params.action === 'create' ? 'Created' : params.action === 'update' ? 'Updated' : 'Deleted';
+    fireAudit({
+        module: 'Company',
+        action: actionMap[params.action],
+        documentName: params.entityType,
+        documentId: params.documentId,
+        metadata: { entityType: params.entityType, entityName: params.entityName },
+        comments: `${verb} ${params.entityType}: ${params.entityName || params.documentId || ''}`
+    }, session);
+}
+// ─── Rate Settings ──────────────────────────────────────────────────────
+export function logRateSettingsUpdated(params, session) {
+    fireAudit({
+        module: 'Rate Settings',
+        action: AuditAction.UPDATE,
+        documentName: params.settingType,
+        metadata: { settingType: params.settingType, itemCount: params.itemCount },
+        comments: `Updated ${params.settingType} (${params.itemCount || 0} items)`
+    }, session);
+}
+export function logRateSettingsImported(params, session) {
+    fireAudit({
+        module: 'Rate Settings',
+        action: AuditAction.IMPORT,
+        documentName: params.settingType,
+        metadata: { settingType: params.settingType, itemCount: params.itemCount },
+        comments: `Imported ${params.settingType} (${params.itemCount || 0} items)`
+    }, session);
+}
+// ─── Quotation Mail ─────────────────────────────────────────────────────
+export function logQuotationMailSent(params, session) {
+    fireAudit({
+        module: AuditModule.QUOTATION,
+        action: AuditAction.PRINT,
+        documentName: 'Quotation Mail',
+        documentId: Number(params.bookingId),
+        metadata: { bookingNo: params.bookingNo, emailTo: params.emailTo },
+        comments: `Sent quotation mail ${params.bookingNo} to ${params.emailTo}`
+    }, session);
+}