import {
  buildPaginatedResult,
  DEFAULT_PAGE_SIZE,
  err,
  ok,
  type PaginationInput,
  type ReadonlyDB,
} from "@tailor-platform/erp-kit/core";
import type { DB } from "../generated/kysely-tailordb";
import { InvalidQueryParamsError } from "../lib/errors.generated";

type PunchOrderByField = "occurredAt";

export interface ListPunchesByAssignmentInput extends PaginationInput<PunchOrderByField> {
  assignmentId: string;
  startDate?: Date;
  endDate?: Date;
}

/**
 * Function: listPunchesByAssignment
 * Description: Lists an Assignment's TimeClockEvents over a date range, in
 * occurrence order, paginated — the raw punch trail view for a worker, e.g.
 * when investigating a discrepancy or reviewing the full audit history
 * behind a period. Includes voided events; void state lives in TimeClockEventVoid (ADR-023).
 */
export async function run(db: ReadonlyDB<DB>, input: ListPunchesByAssignmentInput) {
  if (!input.assignmentId) {
    return err(new InvalidQueryParamsError("assignmentId"));
  }

  if (
    input.startDate !== undefined &&
    input.endDate !== undefined &&
    input.endDate < input.startDate
  ) {
    return err(
      new InvalidQueryParamsError(
        `${input.startDate.toISOString()}..${input.endDate.toISOString()}`,
      ),
    );
  }

  const limit = input.limit ?? DEFAULT_PAGE_SIZE;
  const offset = input.offset ?? 0;
  const orderBy = input.orderBy ?? "occurredAt";
  const orderDirection = input.orderDirection ?? "asc";

  let query = db
    .selectFrom("TimeClockEvent")
    .selectAll()
    .where("assignmentId", "=", input.assignmentId);

  if (input.startDate !== undefined) {
    query = query.where("occurredAt", ">=", input.startDate);
  }
  if (input.endDate !== undefined) {
    query = query.where("occurredAt", "<=", input.endDate);
  }

  const punches = await query
    .orderBy(orderBy, orderDirection)
    .limit(limit + 1)
    .offset(offset)
    .execute();

  return ok(buildPaginatedResult(punches, limit));
}