indas-ui 0.0.1 → 0.1.0

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

@@ -0,0 +1,252 @@
+'use client';
+/**
+ * Notification Trigger Helpers
+ *
+ * Fire-and-forget functions that send notifications after business events.
+ * These NEVER block the calling flow — errors are silently swallowed.
+ *
+ * Usage:
+ *   import { notifyApprovalStatusChanged, notifyEnquiryConverted } from './send.js'
+ *   // After successful API response:
+ *   notifyApprovalStatusChanged({ ... }, session)
+ */
+import { NotificationsAPI } from './notifications.js';
+/**
+ * Fire-and-forget: send a notification without blocking the caller.
+ * Uses the default APIClient base URL (api.indusanalytics.co.in).
+ */
+function fireNotification(request, session) {
+    NotificationsAPI.create(request, session).catch(() => {
+        // Silent — notification failure must never break business flows
+    });
+}
+const APPROVAL_ACTION_MAP = {
+    Approve: {
+        title: (bkNo, actor) => `Quotation ${bkNo} Approved`,
+        message: (bkNo, remarks) => `Quotation ${bkNo} has been internally approved${remarks ? `. Remarks: ${remarks}` : ''}`,
+        type: 'Approval',
+        category: 'Update',
+        priority: 'Normal'
+    },
+    Reject: {
+        title: (bkNo, actor) => `Quotation ${bkNo} Rejected`,
+        message: (bkNo, remarks) => `Quotation ${bkNo} has been rejected${remarks ? `. Reason: ${remarks}` : ''}`,
+        type: 'Warning',
+        category: 'Escalation',
+        priority: 'High'
+    },
+    Rework: {
+        title: (bkNo, actor) => `Quotation ${bkNo} — Rework Required`,
+        message: (bkNo, remarks) => `Quotation ${bkNo} requires rework${remarks ? `. Remarks: ${remarks}` : ''}`,
+        type: 'Warning',
+        category: 'Pending',
+        priority: 'High'
+    },
+    Pending: {
+        title: (bkNo, actor) => `Quotation ${bkNo} — Approval Needed`,
+        message: (bkNo, remarks) => `Quotation ${bkNo} has been sent for internal approval${remarks ? `. Remarks: ${remarks}` : ''}`,
+        type: 'Approval',
+        category: 'Pending',
+        priority: 'Urgent'
+    }
+};
+export function notifyApprovalStatusChanged(params, session) {
+    const config = APPROVAL_ACTION_MAP[params.action];
+    if (!config)
+        return;
+    const request = {
+        title: config.title(params.bookingNo, params.actorUserName),
+        message: config.message(params.bookingNo, params.remarks),
+        type: config.type,
+        module: 'Quotation',
+        priority: config.priority,
+        category: config.category,
+        targetUserId: params.targetUserId,
+        targetUserName: params.targetUserName,
+        documentName: 'Quotation',
+        documentId: typeof params.bookingId === 'string' ? parseInt(params.bookingId) || undefined : params.bookingId,
+        documentNo: params.bookingNo,
+        actionUrl: `/costing/quote-panel`
+    };
+    fireNotification(request, session);
+}
+export function notifyCostApproved(params, session) {
+    const clientPart = params.clientName ? ` for ${params.clientName}` : '';
+    const jobPart = params.jobName ? ` (${params.jobName})` : '';
+    fireNotification({
+        title: `Price Approval ${params.approvalNo} Saved`,
+        message: `Price approval ${params.approvalNo}${jobPart}${clientPart} has been approved by ${params.actorUserName}`,
+        type: 'Success',
+        module: 'Approval',
+        priority: 'Normal',
+        category: 'Update',
+        targetUserId: params.targetUserId,
+        documentName: 'Price Approval',
+        documentNo: params.approvalNo,
+        actionUrl: `/costing/price-approval`
+    }, session);
+}
+export function notifyEnquiryConverted(params, session) {
+    const quotePart = params.bookingNo ? ` → Quotation ${params.bookingNo}` : '';
+    const jobPart = params.jobName ? ` (${params.jobName})` : '';
+    const request = {
+        title: `Enquiry ${params.enquiryNo} Converted${quotePart}`,
+        message: `Enquiry ${params.enquiryNo}${jobPart} has been converted to a quotation by ${params.actorUserName}`,
+        type: 'Success',
+        module: 'Enquiry',
+        priority: 'Normal',
+        category: 'Update',
+        targetUserId: params.targetUserId,
+        targetUserName: params.targetUserName,
+        documentName: 'Enquiry',
+        documentId: params.enquiryId,
+        documentNo: params.enquiryNo,
+        actionUrl: `/costing/estimation`
+    };
+    fireNotification(request, session);
+}
+export function notifyQuotationSaved(params, session) {
+    const action = params.mode === 'clone' ? 'Cloned' : 'Created';
+    const clientPart = params.clientName ? ` for ${params.clientName}` : '';
+    fireNotification({
+        title: `Quotation ${params.bookingNo} ${action}`,
+        message: `Quotation ${params.bookingNo}${clientPart} has been ${action.toLowerCase()} by ${params.actorUserName}`,
+        type: 'Success',
+        module: 'Quotation',
+        priority: 'Normal',
+        category: 'Update',
+        targetUserId: params.targetUserId,
+        documentName: 'Quotation',
+        documentNo: params.bookingNo,
+        actionUrl: `/costing/quote-panel`
+    }, session);
+}
+export function notifyQuotationMailSent(params, session) {
+    const clientPart = params.clientName ? ` to ${params.clientName}` : '';
+    fireNotification({
+        title: `Quotation ${params.bookingNo} Sent${clientPart}`,
+        message: `Quotation ${params.bookingNo} has been emailed${clientPart} by ${params.actorUserName}`,
+        type: 'Info',
+        module: 'Quotation',
+        priority: 'Normal',
+        category: 'Update',
+        targetUserId: params.targetUserId,
+        documentName: 'Quotation',
+        documentNo: params.bookingNo,
+        actionUrl: `/costing/quote-panel`
+    }, session);
+}
+export function notifyQuotationDeleted(params, session) {
+    fireNotification({
+        title: `Quotation ${params.quoteNo} Deleted`,
+        message: `Quotation ${params.quoteNo}${params.jobName ? ` (${params.jobName})` : ''} was deleted by ${params.actorUserName}`,
+        type: 'Warning',
+        module: 'Quotation',
+        priority: 'Normal',
+        category: 'Update',
+        targetUserId: params.targetUserId,
+        documentName: 'Quotation',
+        documentNo: params.quoteNo,
+        actionUrl: `/costing/quote-panel`
+    }, session);
+}
+export function notifyEnquiryCreated(params, session) {
+    const clientPart = params.clientName ? ` from ${params.clientName}` : '';
+    fireNotification({
+        title: `New Enquiry ${params.enquiryNo}`,
+        message: `Enquiry ${params.enquiryNo}${clientPart}${params.jobName ? ` — ${params.jobName}` : ''} created by ${params.actorUserName}`,
+        type: 'Info',
+        module: 'Enquiry',
+        priority: 'Normal',
+        category: 'Update',
+        targetUserId: params.targetUserId,
+        documentName: 'Enquiry',
+        documentNo: params.enquiryNo,
+        actionUrl: `/enquiry/sales`
+    }, session);
+}
+export function notifyEnquiryAssigned(params, session) {
+    fireNotification({
+        title: `Enquiry${params.enquiryNo ? ` ${params.enquiryNo}` : ''} Assigned to You`,
+        message: `You have been assigned an enquiry by ${params.actorUserName}`,
+        type: 'Approval',
+        module: 'Enquiry',
+        priority: 'High',
+        category: 'Pending',
+        targetUserId: params.assignedToUserId,
+        targetUserName: params.assignedToUserName,
+        documentName: 'Enquiry',
+        documentId: params.enquiryId,
+        documentNo: params.enquiryNo,
+        actionUrl: `/enquiry/sales`
+    }, session);
+}
+export function notifyEnquiryUpdated(params, session) {
+    const clientPart = params.clientName ? ` from ${params.clientName}` : '';
+    fireNotification({
+        title: `Enquiry ${params.enquiryNo} Updated`,
+        message: `Enquiry ${params.enquiryNo}${clientPart}${params.jobName ? ` — ${params.jobName}` : ''} updated by ${params.actorUserName}`,
+        type: 'Info',
+        module: 'Enquiry',
+        priority: 'Normal',
+        category: 'Update',
+        targetUserId: params.targetUserId,
+        documentName: 'Enquiry',
+        documentNo: params.enquiryNo,
+        actionUrl: `/enquiry/sales`
+    }, session);
+}
+export function notifyEnquiryDeleted(params, session) {
+    fireNotification({
+        title: `Enquiry ${params.enquiryNo} Deleted`,
+        message: `Enquiry ${params.enquiryNo}${params.jobName ? ` (${params.jobName})` : ''} was deleted by ${params.actorUserName}`,
+        type: 'Warning',
+        module: 'Enquiry',
+        priority: 'Normal',
+        category: 'Update',
+        targetUserId: params.targetUserId,
+        documentName: 'Enquiry',
+        documentNo: params.enquiryNo,
+        actionUrl: `/enquiry/sales`
+    }, session);
+}
+export function notifyUserCrud(params, session) {
+    fireNotification({
+        title: `User ${params.userName} ${params.action}`,
+        message: `User ${params.userName}${params.loginUserName ? ` (${params.loginUserName})` : ''} has been ${params.action.toLowerCase()} by ${params.actorUserName}`,
+        type: params.action === 'Deleted' ? 'Warning' : 'Info',
+        module: 'User',
+        priority: 'Normal',
+        category: 'Update',
+        targetUserId: params.targetUserId,
+        documentName: 'User',
+        actionUrl: `/master/user`
+    }, session);
+}
+export function notifyPasswordChanged(params, session) {
+    fireNotification({
+        title: 'Password Changed',
+        message: `Password has been changed by ${params.actorUserName}`,
+        type: 'Warning',
+        module: 'User',
+        priority: 'High',
+        category: 'Escalation',
+        targetUserId: params.targetUserId,
+        documentName: 'User',
+        actionUrl: `/settings`
+    }, session);
+}
+export function notifyMasterCrud(params, session) {
+    const codePart = params.code ? ` (${params.code})` : '';
+    fireNotification({
+        title: `${params.masterType} ${params.name} ${params.action}`,
+        message: `${params.masterType} ${params.name}${codePart} has been ${params.action.toLowerCase()} by ${params.actorUserName}`,
+        type: params.action === 'Deleted' ? 'Warning' : 'Info',
+        module: 'System',
+        priority: 'Normal',
+        category: 'Update',
+        targetUserId: params.targetUserId,
+        documentName: params.masterType,
+        actionUrl: `/master/${params.masterType.toLowerCase()}`
+    }, session);
+}

package/dist/lib/api/activity/notifications/types.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Notification Types
+ */
+export type NotificationType = 'Info' | 'Success' | 'Warning' | 'Error' | 'Approval' | 'System';
+export type NotificationModule = 'Estimation' | 'Enquiry' | 'Quotation' | 'Approval' | 'User' | 'System';
+export type NotificationPriority = 'Low' | 'Normal' | 'High' | 'Urgent';
+export type NotificationCategory = 'Pending' | 'Escalation' | 'Update';
+/**
+ * Notification request for creating new notifications
+ * Maps to NotificationController.NotificationRequest
+ */
+export interface NotificationRequest {
+    title: string;
+    message?: string;
+    type?: NotificationType;
+    module?: NotificationModule;
+    priority?: NotificationPriority;
+    targetUserId?: number;
+    targetUserName?: string;
+    documentName?: string;
+    documentId?: number;
+    documentNo?: string;
+    actionUrl?: string;
+    metadata?: Record<string, any>;
+    category?: NotificationCategory;
+}
+/**
+ * Notification response — camelCase frontend format
+ * Used by components (useNotifications hook, top-header dropdown, etc.)
+ */
+export interface NotificationResponse {
+    notificationId: number;
+    title: string;
+    message?: string;
+    type: NotificationType;
+    module?: NotificationModule;
+    priority: NotificationPriority;
+    category: NotificationCategory;
+    UserID?: number;
+    UserName?: string;
+    documentName?: string;
+    DocumentID?: number;
+    DocumentNo?: string;
+    actionUrl?: string;
+    isRead: boolean;
+    readAt?: string;
+    CreatedDate?: string;
+    CreatedBy?: number;
+    CompanyID?: number;
+    ProductionUnitID?: number;
+    metadata?: Record<string, any>;
+    createdAt: string;
+}
+/**
+ * Backend notification response — matches DB column names exactly
+ * Columns returned by sp_GetNotifications (no aliases)
+ *
+ * DB Table: [dbo].[Notifications]
+ * NotificationID  BIGINT IDENTITY
+ * Title           NVARCHAR(255)
+ * Message         NVARCHAR(MAX)
+ * Type            NVARCHAR(50)
+ * Module          NVARCHAR(50)
+ * Priority        NVARCHAR(20)
+ * UserID          INT              -- target user
+ * UserName        NVARCHAR(100)
+ * DocumentName    NVARCHAR(50)
+ * DocumentID      INT
+ * ActionUrl       NVARCHAR(500)
+ * IsRead          BIT
+ * ReadAt          DATETIME
+ * CreatedDate     DATETIME
+ * CreatedBy       INT
+ * CompanyID       INT
+ * ProductionUnitID INT
+ * IsDeleted       BIT
+ * Metadata        NVARCHAR(MAX)
+ */
+export interface BackendNotificationResponse {
+    NotificationID: number;
+    Title: string;
+    Message?: string;
+    Type: string;
+    Module?: string;
+    Priority: string;
+    UserID?: number;
+    UserName?: string;
+    DocumentName?: string;
+    DocumentID?: number;
+    DocumentNo?: string;
+    ActionUrl?: string;
+    IsRead: boolean;
+    ReadAt?: string;
+    CreatedDate: string;
+    CreatedBy?: number;
+    CompanyID?: number;
+    ProductionUnitID?: number;
+    Metadata?: string;
+    Category?: string;
+}
+/**
+ * Notification filters for fetching
+ */
+export interface NotificationFilters {
+    limit?: number;
+    unreadOnly?: boolean;
+    type?: NotificationType;
+    module?: NotificationModule;
+    priority?: NotificationPriority;
+    category?: NotificationCategory;
+}
+/**
+ * Convert backend response (PascalCase DB columns) to frontend format
+ */
+export declare function fromBackendNotification(backend: BackendNotificationResponse): NotificationResponse;
+/**
+ * Convert frontend request to backend format (for POST /api/notifications)
+ */
+export declare function toBackendNotificationRequest(request: NotificationRequest): Record<string, any>;

package/dist/lib/api/activity/notifications/types.js

@@ -0,0 +1,62 @@
+'use client';
+/**
+ * Notification Types
+ */
+/**
+ * Convert backend response (PascalCase DB columns) to frontend format
+ */
+export function fromBackendNotification(backend) {
+    let metadata;
+    if (backend.Metadata) {
+        try {
+            metadata = JSON.parse(backend.Metadata);
+        }
+        catch {
+            metadata = undefined;
+        }
+    }
+    return {
+        notificationId: backend.NotificationID,
+        title: backend.Title,
+        message: backend.Message,
+        type: backend.Type,
+        module: backend.Module,
+        priority: backend.Priority,
+        category: backend.Category,
+        UserID: backend.UserID,
+        UserName: backend.UserName,
+        documentName: backend.DocumentName,
+        DocumentID: backend.DocumentID,
+        DocumentNo: backend.DocumentNo,
+        actionUrl: backend.ActionUrl,
+        isRead: backend.IsRead,
+        readAt: backend.ReadAt,
+        CreatedDate: backend.CreatedDate,
+        CreatedBy: backend.CreatedBy,
+        CompanyID: backend.CompanyID,
+        ProductionUnitID: backend.ProductionUnitID,
+        metadata,
+        // Legacy compat — UI code reads createdAt
+        createdAt: backend.CreatedDate
+    };
+}
+/**
+ * Convert frontend request to backend format (for POST /api/notifications)
+ */
+export function toBackendNotificationRequest(request) {
+    return {
+        Title: request.title,
+        Message: request.message,
+        Type: request.type,
+        Module: request.module,
+        Priority: request.priority,
+        TargetUserID: request.targetUserId,
+        TargetUserName: request.targetUserName,
+        DocumentName: request.documentName,
+        DocumentID: request.documentId,
+        DocumentNo: request.documentNo,
+        ActionUrl: request.actionUrl,
+        Metadata: request.metadata,
+        Category: request.category
+    };
+}

package/dist/lib/api/activity/notify-and-log.d.ts

@@ -0,0 +1,50 @@
+/**
+ * notifyAndLog — the standard one-call helper for module actions.
+ *
+ * Every create / update / delete / approve / etc. action in any module should
+ * call this so the app consistently:
+ *   1. writes an audit log (via logAction), and
+ *   2. fires an in-app notification to the relevant user (via NotificationsAPI).
+ *
+ * Both are fire-and-forget — failures never block the business flow.
+ *
+ * Usage:
+ *   import { notifyAndLog } from './notify-and-log.js'
+ *
+ *   notifyAndLog({
+ *     module: AuditModule.QUOTATION,
+ *     action: AuditAction.APPROVE,
+ *     documentName: bookingNo,
+ *     documentId: bookingId,
+ *     // notification (optional — omit to only audit-log):
+ *     notify: {
+ *       targetUserId: requesterId,
+ *       title: 'Quotation approved',
+ *       message: `${actor} approved ${bookingNo}`,
+ *       type: 'Success',
+ *       module: 'Quotation',
+ *       actionUrl: '/costing/quote-panel',
+ *     },
+ *   }, session)
+ */
+import type { NotificationType, NotificationModule, NotificationPriority, NotificationCategory } from './notifications/types.js';
+export interface NotifyAndLogParams {
+    module: string;
+    action: string;
+    documentName: string;
+    documentId?: number;
+    comments?: string;
+    metadata?: Record<string, any>;
+    notify?: {
+        targetUserId: number;
+        title: string;
+        message?: string;
+        type?: NotificationType;
+        module?: NotificationModule;
+        category?: NotificationCategory;
+        priority?: NotificationPriority;
+        documentNo?: string;
+        actionUrl?: string;
+    };
+}
+export declare function notifyAndLog(params: NotifyAndLogParams, session: any): void;

package/dist/lib/api/activity/notify-and-log.js

@@ -0,0 +1,60 @@
+'use client';
+/**
+ * notifyAndLog — the standard one-call helper for module actions.
+ *
+ * Every create / update / delete / approve / etc. action in any module should
+ * call this so the app consistently:
+ *   1. writes an audit log (via logAction), and
+ *   2. fires an in-app notification to the relevant user (via NotificationsAPI).
+ *
+ * Both are fire-and-forget — failures never block the business flow.
+ *
+ * Usage:
+ *   import { notifyAndLog } from './notify-and-log.js'
+ *
+ *   notifyAndLog({
+ *     module: AuditModule.QUOTATION,
+ *     action: AuditAction.APPROVE,
+ *     documentName: bookingNo,
+ *     documentId: bookingId,
+ *     // notification (optional — omit to only audit-log):
+ *     notify: {
+ *       targetUserId: requesterId,
+ *       title: 'Quotation approved',
+ *       message: `${actor} approved ${bookingNo}`,
+ *       type: 'Success',
+ *       module: 'Quotation',
+ *       actionUrl: '/costing/quote-panel',
+ *     },
+ *   }, session)
+ */
+import { logAction } from './audit/send.js';
+import { NotificationsAPI } from './notifications/notifications.js';
+export function notifyAndLog(params, session) {
+    // 1. Audit log — always.
+    logAction({
+        module: params.module,
+        action: params.action,
+        documentName: params.documentName,
+        documentId: params.documentId,
+        comments: params.comments,
+        metadata: params.metadata,
+    }, session);
+    // 2. In-app notification — only when a target user is given, and never to self.
+    const n = params.notify;
+    const selfId = Number(session?.user?.UserID || session?.user?.userID || 0);
+    if (n && n.targetUserId && n.targetUserId !== selfId) {
+        NotificationsAPI.create({
+            title: n.title,
+            message: n.message,
+            type: n.type || 'Info',
+            module: n.module,
+            category: n.category,
+            priority: n.priority || 'Normal',
+            targetUserId: n.targetUserId,
+            documentNo: n.documentNo,
+            documentId: params.documentId,
+            actionUrl: n.actionUrl,
+        }, session).catch(() => { });
+    }
+}

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

@@ -0,0 +1,2 @@
+export { RemarkIntelligenceAPI } from './remarks.js';
+export type { RemarkEntry, RemarkFile, RemarkRow, RemarkSavePayload, RemarkSummary } from './remarks.js';

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

@@ -0,0 +1,2 @@
+'use client';
+export { RemarkIntelligenceAPI } from './remarks.js';

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

@@ -0,0 +1,83 @@
+/**
+ * Remark Intelligence API client (remarkData)
+ *
+ * One row per document (Module + DocumentID); full trail in Metadata JSON.
+ * See docs/superpowers/specs/2026-06-05-remark-intelligence-design.md
+ */
+import type { APIResponse } from '../../core/types.js';
+export interface RemarkFile {
+    name: string;
+    url: string;
+}
+export interface RemarkEntry {
+    seq: number;
+    stage: string;
+    status: string;
+    text: string;
+    by: number | null;
+    byName: string;
+    at: string;
+    edited?: boolean;
+    editedAt?: string;
+    files?: RemarkFile[];
+}
+export interface RemarkRow {
+    RemarkID: number;
+    DocumentID: string;
+    DocumentName?: string;
+    DocumentNo?: string;
+    Module?: string;
+    ActionUrl?: string;
+    Stage?: string;
+    Status?: string;
+    LastRemark?: string;
+    LastRemarkBy?: number;
+    LastRemarkDate?: string;
+    RemarkCount?: number;
+    remarks: RemarkEntry[];
+}
+export interface RemarkSavePayload {
+    Module: string;
+    DocumentID: string | number;
+    DocumentIDName?: string;
+    DocumentName?: string;
+    DocumentNo?: string;
+    ActionUrl?: string;
+    stage: string;
+    status?: string;
+    text: string;
+    files?: RemarkFile[];
+}
+export interface RemarkSummary {
+    DocumentID: string;
+    Stage?: string;
+    Status?: string;
+    LastRemark?: string;
+    LastRemarkBy?: number;
+    LastRemarkDate?: string;
+    RemarkCount?: number;
+}
+export declare class RemarkIntelligenceAPI {
+    static getRemarkData(module: string, documentId: string | number, session: any): Promise<APIResponse<RemarkRow | null>>;
+    static getRemarkDataByBooking(bookingNo: string | number, session: any, enquiry?: {
+        enquiryNo?: string | number;
+        enquiryID?: string | number;
+    }): Promise<APIResponse<RemarkEntry[]>>;
+    static getRemarkDataBatch(module: string, documentIds: Array<string | number>, session: any): Promise<APIResponse<Record<string, RemarkSummary>>>;
+    static saveRemarkData(payload: RemarkSavePayload, session: any): Promise<APIResponse<string>>;
+    static saveAttachments(payload: {
+        Module: string;
+        DocumentID: string | number;
+        DocumentName?: string;
+        DocumentIDName?: string;
+        files: RemarkFile[];
+    }, session: any): Promise<APIResponse<string>>;
+    static getAttachments(module: string, documentId: string | number, session: any): Promise<APIResponse<Array<{
+        AttachementID: number;
+        FileName: string;
+        FilePath: string;
+        FileExtension: string;
+    }>>>;
+    static editRemarkData(module: string, documentId: string | number, seq: number, text: string, session: any): Promise<APIResponse<string>>;
+    static deleteRemarkData(module: string, documentId: string | number, seq: number, session: any): Promise<APIResponse<string>>;
+}