[Feat] Find tasks by start and due dates filters

packages/common/src/utils/find-by-date-between.ts

@@ -0,0 +1,43 @@
+import { BadRequestException } from '@nestjs/common';
+import { SelectQueryBuilder } from 'typeorm';
+
+type AllowedFields = 'startDate' | 'dueDate' | 'createdAt';
+
+function isValidField(field: string): field is AllowedFields {
+	return ['startDate', 'dueDate', 'endDate', 'createdAt'].includes(field);
+}
+
+/**
+ * Adds a date range condition to a TypeORM query builder
+ * @param query - The TypeORM SelectQueryBuilder instance
+ * @param field - The date field to filter on
+ * @param from - Start date (inclusive, UTC)
+ * @param to - End date (inclusive, UTC)
+ * @param p - Optional transform function for the query string
+ * @returns Modified query builder instance
+ * @throws a BadRequestException if from date is after to date
+ */
+export function addBetween<T>(
+	query: SelectQueryBuilder<T>,
+	field: string,
+	from?: Date,
+	to?: Date,
+	p?: (queryStr: string) => string
+): SelectQueryBuilder<T> {
+	if (!isValidField(field)) {
+		throw new BadRequestException(`Invalid field name: ${field}`);
+	}
+
+	if (from && to) {
+		if (from > to) {
+			throw new BadRequestException('"From" date must not be after "to" date');
+		}
+
+		// Convert dates to UTC for consistent comparison
+		const utcFrom = from.toISOString();
+		const utcTo = to.toISOString();
+
+		query.andWhere(p(`"${query.alias}"."${field}" BETWEEN :from AND :to`), { from: utcFrom, to: utcTo });
+	}
+	return query;
+}

packages/common/src/utils/index.ts

@@ -3,3 +3,4 @@ export * from './deep-merge';
 export * from './shared-utils';
 export * from './to-hex-string';
 export * from './mixins';
+export * from './find-by-date-between';

packages/contracts/src/task.model.ts

@@ -1,13 +1,13 @@
 import { IBasePerTenantAndOrganizationEntityModel, IBaseRelationsEntityModel, ID } from './base-entity.model';
-import { IEmployee } from './employee.model';
+import { IEmployee, IEmployeeEntityInput } from './employee.model';
 import { IInvoiceItem } from './invoice-item.model';
 import { IRelationalOrganizationProject } from './organization-projects.model';
 import {
 	IOrganizationSprint,
 	IRelationalOrganizationSprint,
 	IOrganizationSprintTaskHistory
 } from './organization-sprint.model';
-import { IOrganizationTeam } from './organization-team.model';
+import { IOrganizationTeam, IRelationalOrganizationTeam } from './organization-team.model';
 import { ITag } from './tag.model';
 import { IUser } from './user.model';
 import { ITaskStatus, TaskStatusEnum } from './task-status.model';
@@ -104,3 +104,16 @@ export interface IGetTasksByViewFilters extends IBasePerTenantAndOrganizationEnt
 	// Relations
 	relations?: string[];
 }
+
+export interface ITaskDateFilterInput
+	extends IBasePerTenantAndOrganizationEntityModel,
+		IEmployeeEntityInput,
+		IRelationalOrganizationProject,
+		IRelationalOrganizationTeam,
+		IRelationalOrganizationSprint,
+		Pick<IGetTasksByViewFilters, 'relations'> {
+	startDateFrom?: Date;
+	startDateTo?: Date;
+	dueDateFrom?: Date;
+	dueDateTo?: Date;
+}

packages/core/src/tasks/dto/get-task-by-date-filter.dto.ts

@@ -0,0 +1,33 @@
+import { ApiPropertyOptional } from '@nestjs/swagger';
+import { IsDate, IsOptional, ValidateIf } from 'class-validator';
+import { Type } from 'class-transformer';
+import { ITaskDateFilterInput } from '@gauzy/contracts';
+import { TenantOrganizationBaseDTO } from '../../core/dto';
+
+export class TaskDateFilterInputDTO extends TenantOrganizationBaseDTO implements ITaskDateFilterInput {
+	@ApiPropertyOptional({ type: () => Date })
+	@Type(() => Date)
+	@IsOptional()
+	@IsDate()
+	startDateFrom?: Date;
+
+	@ApiPropertyOptional({ type: () => Date })
+	@Type(() => Date)
+	@IsOptional()
+	@IsDate()
+	@ValidateIf((o) => o.startDateFrom != null)
+	startDateTo?: Date;
+
+	@ApiPropertyOptional({ type: () => Date })
+	@Type(() => Date)
+	@IsOptional()
+	@IsDate()
+	dueDateFrom?: Date;
+
+	@ApiPropertyOptional({ type: () => Date })
+	@Type(() => Date)
+	@IsOptional()
+	@IsDate()
+	@ValidateIf((o) => o.dueDateFrom != null)
+	dueDateTo?: Date;
+}

packages/core/src/tasks/dto/index.ts

@@ -2,3 +2,4 @@ export * from './create-task.dto';
 export * from './task-max-number-query.dto';
 export * from './update-task.dto';
 export * from './get-task-by-id.dto';
+export * from './get-task-by-date-filter.dto';

packages/core/src/tasks/task.controller.ts

@@ -23,7 +23,7 @@ import { CrudController, PaginationParams } from './../core/crud';
 import { Task } from './task.entity';
 import { TaskService } from './task.service';
 import { TaskCreateCommand, TaskUpdateCommand } from './commands';
-import { CreateTaskDTO, GetTaskByIdDTO, TaskMaxNumberQueryDTO, UpdateTaskDTO } from './dto';
+import { CreateTaskDTO, GetTaskByIdDTO, TaskDateFilterInputDTO, TaskMaxNumberQueryDTO, UpdateTaskDTO } from './dto';
 
 @ApiTags('Tasks')
 @UseGuards(TenantPermissionGuard, PermissionGuard)
@@ -146,6 +146,22 @@ export class TaskController extends CrudController<Task> {
 		return this.taskService.findModuleTasks(params);
 	}
 
+	/**
+	 * Retrieves tasks based on the provided date filters for startDate and dueDate.
+	 *
+	 * @function getTasksByDateFilters
+	 * @param {TaskDateFilterInputDTO} params - The DTO containing the date filters for the tasks.
+	 */
+	@ApiOperation({ summary: 'Get tasks by start and due dates filters.' })
+	@ApiResponse({ status: HttpStatus.OK, description: 'Tasks retrieved successfully.' })
+	@ApiResponse({ status: HttpStatus.NOT_FOUND, description: 'No records found.' })
+	@Permissions(PermissionsEnum.ALL_ORG_VIEW, PermissionsEnum.ORG_TASK_VIEW)
+	@Get('/filter-by-date')
+	@UseValidationPipe({ transform: true })
+	async getTasksByDateFilters(@Query() params: TaskDateFilterInputDTO): Promise<IPagination<ITask>> {
+		return this.taskService.getTasksByDateFilters(params);
+	}
+
 	/**
 	 * GET view tasks
 	 *

packages/core/src/tasks/task.service.ts

@@ -22,9 +22,10 @@ import {
 	ITask,
 	ITaskUpdateInput,
 	PermissionsEnum,
-	ActionTypeEnum
+	ActionTypeEnum,
+	ITaskDateFilterInput
 } from '@gauzy/contracts';
-import { isEmpty, isNotEmpty } from '@gauzy/common';
+import { addBetween, isEmpty, isNotEmpty } from '@gauzy/common';
 import { isPostgres, isSqlite } from '@gauzy/config';
 import { PaginationParams, TenantAwareCrudService } from './../core/crud';
 import { RequestContext } from '../core/context';
@@ -837,4 +838,91 @@ export class TaskService extends TenantAwareCrudService<Task> {
 			throw new HttpException({ message: error?.message, error }, HttpStatus.BAD_REQUEST);
 		}
 	}
+
+	/**
+	 * Retrieves tasks based on the provided date filters for startDate and dueDate.
+	 *
+	 * @function getTasksByDateFilters
+	 * @param {ITaskDateFilterInput} params - The query params containing the date filters for the tasks.
+	 *
+	 * @returns {Promise<IPagination<ITask>>} A promise that resolves to an paginated tasks filtered by the provided dates.
+	 *
+	 * @throws {Error} Will throw an error if there is a problem with the database query.
+	 */
+	async getTasksByDateFilters(params: ITaskDateFilterInput): Promise<IPagination<ITask>> {
+		const tenantId = RequestContext.currentTenantId() || params.tenantId;
+
+		try {
+			const {
+				startDateFrom,
+				startDateTo,
+				dueDateFrom,
+				dueDateTo,
+				organizationId,
+				employeeId,
+				projectId,
+				organizationTeamId,
+				organizationSprintId,
+				relations
+			} = params;
+
+			let query = this.typeOrmRepository.createQueryBuilder(this.tableName);
+
+			query.andWhere(
+				new Brackets((qb: WhereExpressionBuilder) => {
+					qb.andWhere(p(`"${query.alias}"."tenantId" = :tenantId`), { tenantId });
+					qb.andWhere(p(`"${query.alias}"."organizationId" = :organizationId`), { organizationId });
+				})
+			);
+
+			// Apply the filters on startDate and dueDate
+			query = addBetween<Task>(query, 'startDate', startDateFrom, startDateTo, p);
+			query = addBetween<Task>(query, 'dueDate', dueDateFrom, dueDateTo, p);
+
+			// Add Optional additional filters by
+			query.andWhere(
+				new Brackets((web: WhereExpressionBuilder) => {
+					if (isNotEmpty(employeeId)) {
+						query.leftJoin(`${query.alias}.members`, 'members');
+						web.andWhere((qb: SelectQueryBuilder<Task>) => {
+							const subQuery = qb.subQuery();
+							subQuery.select(p('"task_employee"."taskId"')).from(p('task_employee'), p('task_employee'));
+							subQuery.andWhere(p('"task_employee"."employeeId" = :employeeId'), { employeeId });
+							return p(`"task_members"."taskId" IN (${subQuery.distinct(true).getQuery()})`);
+						});
+					}
+					if (isNotEmpty(organizationTeamId)) {
+						query.leftJoin(`${query.alias}.teams`, 'teams');
+						web.andWhere((qb: SelectQueryBuilder<Task>) => {
+							const subQuery = qb.subQuery();
+							subQuery.select(p('"task_team"."taskId"')).from(p('task_team'), p('task_team'));
+							subQuery.andWhere(p('"task_team"."organizationTeamId" = :organizationTeamId'), {
+								organizationTeamId
+							});
+							return p(`"task_teams"."taskId" IN (${subQuery.distinct(true).getQuery()})`);
+						});
+					}
+					if (isNotEmpty(projectId)) {
+						web.andWhere(p(`"${query.alias}"."projectId" = :projectId`), { projectId });
+					}
+					if (isNotEmpty(organizationSprintId)) {
+						web.andWhere(p(`"${query.alias}"."organizationSprintId" = :organizationSprintId`), {
+							organizationSprintId
+						});
+					}
+				})
+			);
+
+			// Check if relations were provided and include them
+			query.setFindOptions({
+				...(relations ? { relations } : {})
+			});
+
+			const [items, total] = await query.getManyAndCount();
+
+			return { items, total };
+		} catch (error) {
+			throw new BadRequestException(error);
+		}
+	}
 }