/**
 * Shipment Counter Port
 *
 * Counts total shipments (bookings + CSV bookings) for an organization
 * within a given year. Used to enforce the Bronze plan's 12 shipments/year limit.
 */

export const SHIPMENT_COUNTER_PORT = 'SHIPMENT_COUNTER_PORT';

export interface ShipmentCounterPort {
  /**
   * Count all shipments (bookings + CSV bookings) created by an organization in a given year.
   */
  countShipmentsForOrganizationInYear(organizationId: string, year: number): Promise<number>;

  /**
   * Count only PAID shipments (fee paid / payment declared / accepted) created by
   * an organization in a given year. Unpaid drafts (PENDING_PAYMENT), rejected and
   * cancelled bookings are excluded.
   */
  countPaidShipmentsForOrganizationInYear(
    organizationId: string,
    year: number
  ): Promise<number>;
}