truflow 1.3.1 → 1.52.0

package/src/ISchedule.ts

@@ -5,7 +5,7 @@ export interface IScheduleFilterCondition {
   field: "product" | "attribute";
   productId?: number;
   attributeName?: string;
-  operator: "equals" | "notEquals" | "contains" | "greaterThan" | "lessThan" | "greaterThanOrEqual" | "lessThanOrEqual";
+  operator: "equals" | "notEquals" | "contains" | "greaterThan" | "lessThan" | "greaterThanOrEqual" | "lessThanOrEqual" | "exists" | "doesNotExist";
   value: string;
 }
 
@@ -39,6 +39,7 @@ export interface ISavedViewFilter {
 
 // A filter group - conditions are combined based on conditionOperator
 export interface IScheduleFilterGroup {
+  name?: string;  // Optional display name for this filter group (used when combining groups)
   conditions: IScheduleFilterCondition[];
   conditionOperator?: "and" | "or";
 }
@@ -50,11 +51,12 @@ export interface IScheduleColumn {
   machineId: mongoose.Types.ObjectId;
   offsetDays: number; // Days offset from the base date (ship date or start date)
   order: number; // Display order of this column
+  disableCondition?: IFieldDisableCondition;  // When set, the stage cell is read-only if the condition is met
 }
 
 // Display column configuration - controls order and visibility of all columns
 export interface IScheduleDisplayColumn {
-  type: "orderNumber" | "company" | "product" | "quantity" | "shipDate" | "startDate" | "status" | "attribute" | "stage" | "customField";
+  type: "orderNumber" | "company" | "product" | "quantity" | "shipDate" | "startDate" | "status" | "attribute" | "stage" | "customField" | "shipDateStage";
   stageColumnId?: mongoose.Types.ObjectId;  // Reference to the stage column if type is "stage"
   attributeName?: string;  // Reference to the attribute if type is "attribute"
   customFieldName?: string;  // Reference to the custom field name if type is "customField"
@@ -64,7 +66,7 @@ export interface IScheduleDisplayColumn {
 
 // Additional attribute with optional display condition
 export interface IScheduleAdditionalAttribute {
-  attributeName: string;
+  attributeNames: string[];  // Array of attribute names - will use the first one with a value
   label?: string;  // Optional custom label for display
   // Optional condition - if specified, attribute only displays when condition is met
   displayCondition?: {
@@ -88,6 +90,8 @@ export interface IScheduleView {
   combineAdditionalAttributes?: boolean;  // Whether to show all additional attributes in one column (like matched attributes)
   // Product grouping configuration
   groupByMatchingAttributes?: boolean;  // Whether to group products with matching filter attributes in the same order
+  combineByAttributes?: string[];  // When groupByMatchingAttributes is true, only use these specific attribute names for the grouping key (empty/undefined = use all filter-condition attributes)
+  combineFilterGroups?: boolean;  // Whether to combine products from different named filter groups into a single row (requires groupByMatchingAttributes and named filter groups)
   isDefault?: boolean;  // Whether this is the default view
   // Saved filters for this view
   savedFilters?: ISavedViewFilter[];
@@ -97,6 +101,15 @@ export interface IScheduleView {
   activeFilterId?: mongoose.Types.ObjectId;
 }
 
+// Condition that determines when a stage or custom field should be disabled (read-only)
+export interface IFieldDisableCondition {
+  fieldType: "attribute" | "customField";  // Where to look for the value
+  fieldName: string;                       // Attribute name or custom field name to evaluate
+  operator: "equals" | "notEquals" | "contains" | "greaterThan" | "lessThan" | "greaterThanOrEqual" | "lessThanOrEqual" | "isEmpty" | "isNotEmpty";
+  value?: string;                          // Comparison value (not used for isEmpty/isNotEmpty)
+  disabledPlaceholder?: string;            // Text shown in the cell when the field is disabled (e.g. "No Finish")
+}
+
 // Custom field definition for schedule entries
 export interface IScheduleCustomField {
   _id?: mongoose.Types.ObjectId;
@@ -107,6 +120,7 @@ export interface IScheduleCustomField {
   defaultValue?: string | boolean | number;        // Default value for new entries
   required?: boolean;                     // Whether field is required
   order?: number;                         // Display order
+  disableCondition?: IFieldDisableCondition;  // When set, the field is read-only if the condition is met
 }
 
 // The main Schedule configuration
@@ -126,12 +140,16 @@ export interface ILeanSchedule {
   customFields?: IScheduleCustomField[];
   // Base date field to calculate offsets from
   baseDateField: "shipDate" | "startDate";
+  // Completed status configuration
+  completedStatuses?: string[];
+  hideCompletedOrders?: boolean;
   // Legacy fields (kept for backward compatibility, will be migrated to default view)
   displayColumns?: IScheduleDisplayColumn[];
   hidePastShipDates?: boolean;
   hideShippedOrders?: boolean;
   showShipDate?: boolean;
   showStartDate?: boolean;
+  showShipDateStage?: boolean;
   defaultSortField?: string;
   defaultSortDirection?: "asc" | "desc";
   createdAt?: Date;
@@ -146,6 +164,15 @@ export interface IScheduleEntryDate {
   date: string; // ISO date string
 }
 
+export interface IScheduleEntryHistory {
+  fieldType: "date" | "status" | "customField";
+  fieldName: string;
+  oldValue?: string | number | boolean | null;
+  newValue?: string | number | boolean | null;
+  changedAt: Date;
+  changedBy?: string;
+}
+
 export interface ILeanScheduleEntry {
   _id: mongoose.Types.ObjectId;
   scheduleId: mongoose.Types.ObjectId;
@@ -155,6 +182,7 @@ export interface ILeanScheduleEntry {
   notes?: string;
   status?: string;                        // Legacy status field
   customStatus?: { [key: string]: any }; // Custom status fields (key-value pairs)
+  history?: IScheduleEntryHistory[];     // Audit trail
   createdAt?: Date;
   updatedAt?: Date;
 }

package/src/IUser.ts

@@ -12,12 +12,19 @@ export interface ILeanUser {
   permissions: any[];
   groups: any[];
   pushSubscriptions?: PushSubscription[];
+  expoPushTokens?: ExpoPushToken[];        // Expo push tokens for the native mobile app
   pushNotificationTags?: NotificationTag[]; // Tags user wants to receive push notifications for
   // Employee fields
   enableSignin?: boolean; // If true, this person can sign in (user), if false they're employee-only
   position?: string; // Job title/position
-  department?: mongoose.Types.ObjectId | string; // Department reference (ObjectId) or populated name
+  department?: mongoose.Types.ObjectId | string; // Deprecated — kept for backward compat; use departments[]
+  departments?: (mongoose.Types.ObjectId | string)[]; // Department memberships (can belong to multiple)
   employeeId?: string; // Employee ID number (optional)
+  startupPage?: string; // Default page to load after login (e.g., "/quality-control")
+  jobRoleId?: mongoose.Types.ObjectId | string;
+  isOrgRoot?: boolean;
+  reportsTo?: mongoose.Types.ObjectId | string; // Direct reporting relationship for org chart
+  hideFromOrgChartUnassigned?: boolean; // If true, exclude from org chart unassigned section
 }
 
 export interface PushSubscription {
@@ -29,3 +36,9 @@ export interface PushSubscription {
   device?: string;
   createdAt?: Date;
 }
+
+export interface ExpoPushToken {
+  token: string;      // The Expo push token (ExponentPushToken[xxx])
+  device?: string;    // Optional device label
+  createdAt?: Date;
+}

package/src/index.ts

@@ -40,3 +40,6 @@ export * from "./ISchedule";
 export * from "./IAutomation";
 export * from "./IEmailTemplate";
 export * from "./ISOP";
+export * from "./IDocumentType";
+export * from "./ISMTPServerConfig";
+export * from "./IJobRole";