pn-new-crm/src/lib/services/active-interest.ts

import { and, eq, isNull, type SQL } from 'drizzle-orm';

import { interests } from '@/lib/db/schema/interests';

/**
 * Canonical "active interest" predicate for SQL WHERE clauses.
 *
 * An interest is **active** when it is:
 *   - scoped to the given `portId`,
 *   - not soft-archived (`archived_at IS NULL`), and
 *   - not yet terminal (`outcome IS NULL` - i.e. not won, lost, or
 *     cancelled).
 *
 * "Won" deals are explicitly **not active** under this definition: a won
 * deal is closed business, distinct from in-flight pipeline. The 7-stage
 * pipeline carries deals through `contract` as the final motion stage;
 * setting an `outcome` (won/lost/cancelled) terminates the deal and
 * removes it from the active pool everywhere KPIs, kanban, hot deals,
 * pipeline value, and revenue forecast are computed.
 *
 * Pre-2026-05-14 the dashboard used a broader `outcome IS NULL OR
 * outcome = 'won'` predicate; the new pipeline overhaul collapsed
 * intermediate completion states into explicit stages, making the
 * stricter definition the correct one across every surface.
 *
 * Always combine with the table's own filters; this helper is a leaf
 * predicate, not a complete WHERE.
 */
export function activeInterestsWhere(portId: string): SQL {
  return and(
    eq(interests.portId, portId),
    isNull(interests.archivedAt),
    isNull(interests.outcome),
  ) as SQL;
}