fleet/frontend/interfaces/label.ts

import PropTypes from "prop-types";

export default PropTypes.shape({
  created_at: PropTypes.string,
  updated_at: PropTypes.string,
  id: PropTypes.oneOfType([PropTypes.number]),
  name: PropTypes.string,
  query: PropTypes.string,
  label_type: PropTypes.oneOf(["regular", "builtin"]),
  label_membership_type: PropTypes.oneOf(["dynamic", "manual"]),
  hosts_count: PropTypes.number,
  display_text: PropTypes.string,
  count: PropTypes.number, // seems to be a repeat of hosts_count issue #1618
  host_ids: PropTypes.arrayOf(PropTypes.number),
});

export type LabelType = "regular" | "builtin";

// Valid platform values for a dynamic label, mirroring the server's
// ValidLabelPlatformVariants (server/fleet/labels.go). "" targets all
// platforms.
export const LABEL_PLATFORMS = [
  "",
  "darwin",
  "windows",
  "linux",
  "ubuntu",
  "centos",
] as const;
export type LabelPlatform = typeof LABEL_PLATFORMS[number];
export type LabelMembershipType = "dynamic" | "manual" | "host_vitals";
export const LabelMembershipTypeToDisplayCopy: Record<
  LabelMembershipType,
  string
> = {
  dynamic: "Dynamic",
  manual: "Manual",
  host_vitals: "Host vitals",
};

export type LabelHostVitalsIdpCriterion =
  | "end_user_idp_group"
  | "end_user_idp_department";

// A custom host vital is selected as a label criterion by referencing its
// definition id. The IdP enum values self-identify their vital; the custom path
// is a single sentinel, so the id (below) is what distinguishes one custom vital
// from another.
export const CUSTOM_HOST_VITAL_CRITERION = "custom_host_vital" as const;
export type LabelHostVitalsCustomCriterion = typeof CUSTOM_HOST_VITAL_CRITERION;

export type LabelHostVitalsCriterion =
  | LabelHostVitalsIdpCriterion
  | LabelHostVitalsCustomCriterion;

// An IdP-based leaf: the vital enum self-identifies which vital, so no id.
type LabelIdpLeafCriterion = {
  vital: LabelHostVitalsIdpCriterion;
  value: string; // from user input
  custom_host_vital_id?: never;
};

// A custom-host-vital leaf: the sentinel `vital` alone doesn't identify which
// vital, so `custom_host_vital_id` is required.
type LabelCustomLeafCriterion = {
  vital: LabelHostVitalsCustomCriterion;
  value: string; // from user input
  custom_host_vital_id: number;
};

export type LabelLeafCriterion =
  | LabelIdpLeafCriterion
  | LabelCustomLeafCriterion;

type LabelAndCriterion = {
  and: LabelHostVitalsCriteria[];
};

type LabelOrCriterion = {
  or: LabelHostVitalsCriteria[];
};

export type LabelHostVitalsCriteria =
  | LabelLeafCriterion
  | LabelAndCriterion
  | LabelOrCriterion;

export interface ILabelSummary {
  id: number;
  name: string;
  description?: string;
  label_type: LabelType;
}

export interface ILabelSoftwareTitle {
  id: number;
  name: string;
}

export interface ILabelQuery {
  id: number;
  name: string;
}

export interface ILabelPolicy {
  id: number;
  name: string;
}

export interface ILabel extends ILabelSummary {
  created_at: string;
  updated_at: string;
  uuid?: string;
  host_count?: number; // returned for built-in labels but not custom labels
  display_text: string;
  count: number; // seems to be a repeat of hosts_count issue #1618
  type?: "custom" | "platform" | "status" | "all";
  slug?: string; // e.g., "labels/13" | "online"
  target_type?: string; // e.g., "labels"
  author_id?: number;
  team_id: number | null;
  team_name?: string | null; // returned on individual label endpoints but not list endpoints

  label_membership_type: LabelMembershipType;

  // dynamic-specific
  query: string; // does return '""' for other types
  platform: LabelPlatform; // "" for non-dynamic label types, and for dynamic labels targeting all platforms

  // host_vitals-specific
  criteria: LabelHostVitalsCriteria | null;

  // manual-specific
  host_ids: number[] | null;
}

// corresponding to fleet>server>fleet>labels.go>LabelSpec
export interface ILabelSpecResponse {
  specs: {
    id: number;
    name: string;
    description: string;
    query: string;
    platform?: LabelPlatform;
    label_type?: LabelType;
    label_membership_type: LabelMembershipType;
    hosts?: string[];
  };
}