Fusion Core Services

/**
 * Fusion Apps API — TypeScript model definitions
 *
 * Source of truth: Fusion.Services.Apps/Controllers/
 * No published NuGet API-model package — models are service-internal.
 *
 * All property names use camelCase to match JSON serialization.
 */

// ---------------------------------------------------------------------------
// Enums (serialized as strings)
// ---------------------------------------------------------------------------

export type ApiAppType = string;

export type ApiGovernanceDocumentType =
  | "AccessOverview"
  | "Goal"
  | "DataSource"
  | "PrivacyStatement"
  | "LRA";

export type ApiDataClassificationLevel = string;

// ---------------------------------------------------------------------------
// Core response models
// ---------------------------------------------------------------------------

/** Returned by GET /apps and GET /apps/{appKey}. */
export interface ApiApp {
  appKey: string;
  id: string;
  displayName: string;
  description: string | null;
  type: string;
  category: ApiAppCategory | null;
  visualization: ApiAppVisualization | null;
  contexts: ApiAppContext[] | null;
  keywords: string[] | null;
  admins: ApiAppAdmin[] | null;
  owners: ApiAppOwner[] | null;
  build: ApiAppVersion | null;
  classification: ApiDataClassification | null;
}

export interface ApiAppListItem extends ApiApp {}

export interface ApiPersonApp extends ApiApp {
  isPinned: boolean;
}

export interface ApiPersonAppListItem extends ApiPersonApp {}

export interface ApiAppVersion {
  version: string;
  entryPoint: string;
  tags: string[];
  tag: string | null;
  assetPath: string;
  configUrl: string;
  timestamp: string | null;
  commitSha: string | null;
  githubRepo: string | null;
  projectPage: string | null;
  annotations: Record<string, unknown>;
  uploadedBy: ApiAccount | null;
  uploadedDate: string;
}

export interface ApiAppCategory {
  id: string;
  name: string;
  displayName: string;
  color: string | null;
  defaultIcon: string | null;
  sortOrder: number | null;
}

export interface ApiAppTag {
  tagName: string | null;
  version: string | null;
}

export interface ApiAppTagHistory {
  tagName: string;
  version: string;
  buildId: string;
  created: string;
  replaced: string | null;
  isCurrent: boolean;
  createdBy: ApiAccount;
  deletedBy: ApiAccount | null;
}

export interface ApiAppAdmin {
  id: string;
  azureUniqueId: string | null;
  displayName: string | null;
  mail: string | null;
  upn: string | null;
  accountType: string | null;
  accountClassification: string | null;
  isExpired: boolean;
}

export interface ApiAppOwner {
  id: string;
  azureUniqueId: string | null;
  displayName: string | null;
  mail: string | null;
  upn: string | null;
  accountType: string | null;
  accountClassification: string | null;
  isExpired: boolean;
}

export interface ApiAppVisualization {
  color: string | null;
  icon: string | null;
  sortOrder: number;
}

export interface ApiAppContext {
  type: string;
  isCustom: boolean;
}

export interface ApiContextType {
  id: string;
  name: string;
  isCustom: boolean;
  description: string | null;
}

export interface ApiDataClassification {
  level: string;
  description: string | null;
  impact: string;
  reason: string | null;
  updatedAt: string;
  updatedBy: ApiAccount;
}

export interface ApiDataClassificationDefinition {
  name: string;
  description: string;
  impact: string;
}

// ---------------------------------------------------------------------------
// Pinned apps
// ---------------------------------------------------------------------------

export interface ApiPinnedApp {
  key: string;
  name: string;
  description: string;
  icon: string | null;
  accentColor: string | null;
  appCategory: ApiPinnedAppCategory | null;
}

export interface ApiPinnedAppCategory {
  id: string;
  displayName: string;
  color: string | null;
  icon: string | null;
}

// ---------------------------------------------------------------------------
// Governance models
// ---------------------------------------------------------------------------

export interface ApiGovernanceApp {
  appKey: string;
  displayName: string;
  classification: ApiDataClassification | null;
  businessOwnerOrgUnit: ApiBusinessOwnerOrgUnit | null;
  confirmation: ApiGovernanceConfirmation | null;
  documents: ApiGovernanceDocument[];
  businessOwners: ApiBusinessOwner[];
  projectCategories: ApiProjectCategory[];
  projectPhases: ApiProjectPhase[];
  technologyProduct: ApiTechnologyProduct | null;
  supportsAllProjectPhases: boolean;
  supportsAllProjectCategories: boolean;
  updatedAt: string | null;
  properties: Record<string, unknown> | null;
}

export interface ApiGovernanceAppListItem extends ApiGovernanceApp {}

export interface ApiGovernanceDocument {
  id: string;
  content: string;
  type: ApiGovernanceDocumentType;
  typeDisplayName: string;
  createdBy: ApiAccount;
  createdAt: string;
  updatedBy: ApiAccount | null;
  updatedAt: string | null;
}

export interface ApiGovernanceDocumentListItem extends ApiGovernanceDocument {}

export interface ApiGovernanceConfirmation {
  comment: string | null;
  confirmedAt: string;
  confirmedBy: ApiAccount;
}

export interface ApiBusinessOwner {
  role: string;
  roleDisplayName: string;
  createdAt: string;
  azureUniqueId: string;
  mail: string | null;
  upn: string | null;
  isExpired: boolean;
  reason: string | null;
}

export interface ApiBusinessOwnerOrgUnit {
  sapId: string;
  fullDepartment: string | null;
}

export interface ApiProjectPhase {
  id: string;
  externalId: string;
  createdAt: string;
  name: string | null;
  description: string | null;
}

export interface ApiProjectCategory {
  id: string;
  externalId: string;
  createdAt: string;
  name: string | null;
  description: string | null;
}

export interface ApiTechnologyProduct {
  id: string;
  name: string;
  description: string;
  businessSolutionOwner: ApiAccount;
  technologyProductManager: ApiAccount;
  createdAt: string;
  updatedAt: string | null;
}

// ---------------------------------------------------------------------------
// Widgets
// ---------------------------------------------------------------------------

export interface ApiWidget {
  id: string;
  widgetKey: string;
  description: string;
  admins: ApiWidgetAdmin[] | null;
  build: ApiWidgetVersion | null;
}

export interface ApiWidgetVersion {
  version: string;
  entryPoint: string;
  tag: string | null;
  assetPath: string | null;
  configUrl: string | null;
  timestamp: string | null;
  commitSha: string | null;
  githubRepo: string | null;
  annotations: Record<string, unknown>;
}

export interface ApiWidgetAdmin {
  id: string;
  azureUniqueId: string | null;
  displayName: string | null;
  mail: string | null;
  upn: string | null;
  accountType: string | null;
  accountClassification: string | null;
}

export interface ApiWidgetTag {
  tagName: string | null;
  version: string | null;
}

// ---------------------------------------------------------------------------
// Shared models
// ---------------------------------------------------------------------------

export interface ApiAccount {
  azureUniqueId: string;
  displayName: string;
  mail: string | null;
  upn: string | null;
  accountType: string;
  accountClassification: string | null;
  isExpired: boolean;
}

export interface ApiChangelog {
  id: string;
  commandName: string;
  timestamp: string;
  appKey: string | null;
  appVersionIdentifier: string | null;
  categoryName: string | null;
  activityId: string | null;
  actorUpn: string | null;
  actorAzureUniqueId: string | null;
  payload: Record<string, unknown> | null;
  azureAppId: string | null;
}

export interface ApiTaggedPerson {
  azureUniqueId: string;
  displayName: string;
  mail: string | null;
  upn: string | null;
  isPersonExpired: boolean;
  tagName: string;
}

export interface ApiEndpointConfig {
  url: string;
  scopes: string[];
}

export interface ApiAppVersionConfig {
  environment: Record<string, unknown>;
  endpoints: Record<string, ApiEndpointConfig>;
}

// ---------------------------------------------------------------------------
// Request models
// ---------------------------------------------------------------------------

/**
 * POST /apps — create a new app.
 *
 * Validation (FluentValidation):
 * @property appKey — Required, 3–50 chars, URL-safe (BeValidAppKey)
 * @property displayName — Required, 3–100 chars, no script tags
 * @property description — Optional, max 500 chars, no script tags
 * @property admins — Required, at least one valid account
 * @property owners — Each must be a valid account
 * @property keywords — Each max 50 chars
 */
export interface CreateAppRequest {
  /** @minLength 3  @maxLength 50 — must be URL-safe */
  appKey: string;
  /** @minLength 3  @maxLength 100 */
  displayName: string;
  /** @maxLength 500 */
  description?: string | null;
  type?: string;
  templateSource?: TemplateSourceRequest | null;
  category?: string | null;
  visualization?: ApiAppVisualization | null;
  contexts?: AppContextRequest[] | null;
  /** Each keyword max 50 chars */
  keywords?: string[] | null;
  admins: string[];
  owners?: string[] | null;
}

/**
 * PATCH /apps/{appKey} — update app fields.
 * Only properties present in the payload are applied.
 */
export interface PatchAppRequest {
  /** @maxLength 500 */
  description?: string | null;
  /** @minLength 3  @maxLength 100 */
  displayName?: string;
  type?: string;
  templateSource?: TemplateSourceRequest | null;
  keywords?: string[] | null;
  admins?: string[];
  owners?: string[] | null;
  visualization?: ApiAppVisualization | null;
  contexts?: AppContextRequest[] | null;
  category?: string | null;
}

/**
 * POST /apps/categories — create an app category.
 *
 * Validation:
 * @property name — Required, 3–50 chars (BeValidAppCategoryName)
 * @property displayName — Required, 3–100 chars
 * @property color — Max 20 chars
 */
export interface CreateAppCategoryRequest {
  /** @minLength 3  @maxLength 50 */
  name: string;
  /** @minLength 3  @maxLength 100 */
  displayName: string;
  /** @maxLength 20 */
  color?: string | null;
  defaultIcon?: string | null;
  sortOrder?: number | null;
}

/**
 * PATCH /apps/categories/{appCategoryIdentifier} — update an app category.
 * Only properties present in the payload are applied.
 */
export interface PatchCategoryRequest {
  /** @minLength 3  @maxLength 50 */
  displayName?: string | null;
  /** @maxLength 20 */
  color?: string | null;
  defaultIcon?: string | null;
  sortOrder?: number | null;
}

/**
 * POST /apps/{appKey}/tags/{tagName} — create an app tag.
 *
 * Validation:
 * @property version — Valid version format, max 250
 */
export interface CreateAppTagRequest {
  /** @maxLength 250 */
  version: string;
}

export interface CreatePinnedAppRequest {
  /** @maxLength 200 */
  appKey: string;
}

/**
 * POST /apps/context-types — create a context type.
 *
 * Validation:
 * @property name — Required, 2–50 chars, URL-safe
 * @property description — Required if isCustom, max 500
 */
export interface CreateContextTypeRequest {
  /** @minLength 2  @maxLength 50 */
  name: string;
  isCustom: boolean;
  /** @maxLength 500 */
  description?: string | null;
}

/**
 * PUT /apps/{appKey}/governance/classification — set classification.
 *
 * Validation:
 * @property level — Required, valid classification type
 * @property reason — Required if level is Confidential, max 255
 */
export interface DataClassificationRequest {
  level: string;
  /** @maxLength 255 */
  reason?: string | null;
}

export interface TemplateSourceRequest {
  appIdentifier: string;
  appVersionIdentifier: string;
}

export interface AppContextRequest {
  /** @maxLength 50 */
  type: string;
  /** @maxLength 500 */
  description?: string | null;
  isCustom?: boolean;
}

/**
 * PUT /apps/{appKey}/governance/technology-product.
 */
export interface CreateTechnologyProductRequest {
  /** @maxLength 100 */
  name: string;
  /** @maxLength 2000 */
  description: string;
  businessSolutionOwner: string;
  technicalProductManager: string;
}

/**
 * PUT /apps/{appKey}/governance/business-owners.
 */
export interface UpdateBusinessOwnerRequest {
  accountIdentifier: string;
  role: string;
  /** @maxLength 1000 */
  reason?: string | null;
}

/**
 * POST /apps/{appKey}/governance/documents.
 */
export interface AppGovernanceDocumentRequest {
  content?: string | null;
  type: ApiGovernanceDocumentType;
}

export interface PatchGovernanceDocumentRequest {
  content?: string | null;
}

export interface ConfirmGovernanceRequest {
  /** @maxLength 255 */
  comment?: string | null;
}

export interface CreatePersonAppTagRequest {
  tag?: string | null;
}

export interface CreateAppBuildConfigRequest {
  environment?: Record<string, unknown> | null;
  endpoints?: Record<string, ApiEndpointConfigRequest> | null;
}

export interface ApiEndpointConfigRequest {
  url: string;
  scopes?: string[] | null;
}

export interface PatchGovernanceAppRequest {
  businessOwners?: UpdateBusinessOwnerRequest[] | null;
  businessOwnerOrgUnit?: UpdateBusinessOwnerOrgUnitRequest | null;
  classification?: DataClassificationRequest | null;
  projectPhases?: UpdateProjectPhaseRequest[] | null;
  projectCategories?: UpdateProjectCategoryRequest[] | null;
  technologyProduct?: UpdateTechnologyProductForAppRequest | null;
  supportsAllProjectPhases?: boolean | null;
  supportsAllProjectCategories?: boolean | null;
  properties?: PropertiesCollection | null;
}

export interface UpdateBusinessOwnerOrgUnitRequest {
  sapId?: string | null;
}

export interface UpdateProjectPhaseRequest {
  externalId: string;
}

export interface UpdateProjectCategoryRequest {
  externalId: string;
}

export interface UpdateTechnologyProductForAppRequest {
  identifier?: string | null;
}

export interface PropertiesCollection {
  [key: string]: unknown;
}

/**
 * Fusion Bookmarks API — TypeScript model definitions
 *
 * Source of truth: Fusion.Services.Bookmarks/Controllers/
 * No published NuGet API-model package — models are service-internal.
 *
 * All property names use camelCase to match JSON serialization.
 */

// ---------------------------------------------------------------------------
// Enums (serialized as strings)
// ---------------------------------------------------------------------------

export type FusionAccountType =
  | "Employee"
  | "Consultant"
  | "External"
  | "Local"
  | "Unknown"
  | "Application";

export type AccountClassification =
  | "Unclassified"
  | "Internal"
  | "External";

// ---------------------------------------------------------------------------
// Response models
// ---------------------------------------------------------------------------

/** Returned by GET /persons/me/bookmarks (v1) and GET /bookmarks/{id} (v1). */
export interface ApiBookmark {
  id: string;
  name: string;
  description: string | null;
  isShared: boolean;
  payload: unknown | null;
  appKey: string;
  context: ApiFusionContext | null;
  createdBy: ApiPerson;
  updatedBy: ApiPerson | null;
  created: string;
  updated: string | null;
  sourceSystem: ApiSourceSystem | null;
  isFavourite: boolean | null;
}

/** Same as ApiBookmark but without payload. */
export interface ApiBookmarkV2 {
  id: string;
  name: string;
  description: string | null;
  isShared: boolean;
  appKey: string;
  context: ApiFusionContext | null;
  createdBy: ApiPerson;
  updatedBy: ApiPerson | null;
  created: string;
  updated: string | null;
  sourceSystem: ApiSourceSystem | null;
  isFavourite: boolean | null;
}

/** Returned by GET /bookmarks/{id}/apply. */
export interface ApiBookmarkPayload {
  id: string;
  payload: unknown;
  context: ApiFusionContext | null;
}

export interface ApiSourceSystem {
  /** @maxLength 50 — Required when source system is provided. */
  identifier: string;
  /** @maxLength 100 */
  name: string | null;
  /** @maxLength 100 */
  subSystem: string | null;
}

export interface ApiFusionContext {
  id: string;
  name: string;
  type: string;
}

export interface ApiPerson {
  azureUniqueId: string | null;
  mail: string | null;
  name: string;
  phoneNumber: string | null;
  jobTitle: string | null;
  accountType: FusionAccountType;
  accountClassification: AccountClassification | null;
}

// ---------------------------------------------------------------------------
// Request models
// ---------------------------------------------------------------------------

/**
 * POST /bookmarks — create a bookmark.
 *
 * Validation (FluentValidation):
 * @property name — Required, valid name format
 * @property appKey — Required, valid app key format
 * @property description — Valid format when present
 * @property contextId — Valid Fusion context when present
 * @property payload — Required, must not be null
 * @property sourceSystem.identifier — Required, max 50, no script tags
 * @property sourceSystem.name — Max 100, no script tags
 * @property sourceSystem.subSystem — Max 100, no script tags
 */
export interface CreateBookmarkRequest {
  name: string;
  appKey: string;
  description?: string | null;
  contextId?: string | null;
  payload: unknown;
  isShared?: boolean;
  sourceSystem?: ApiSourceSystem | null;
}

/**
 * PATCH /bookmarks/{id} — update bookmark fields.
 * Only properties present in the payload are applied.
 */
export interface PatchBookmarkRequest {
  name?: string;
  appKey?: string;
  description?: string | null;
  contextId?: string | null;
  payload?: unknown;
  isShared?: boolean;
  sourceSystem?: ApiSourceSystem | null;
}

/**
 * POST /persons/me/bookmarks/favourites — add a bookmark favourite for the current user.
 */
export interface AddFavouriteRequest {
  bookmarkId: string;
}

/**
 * Fusion Context API — TypeScript model definitions
 *
 * Source of truth: Fusion.Services.Context/Controllers/ViewModels/
 * No published NuGet API-model package — models are service-internal.
 *
 * All property names use camelCase to match JSON serialization.
 */

// ---------------------------------------------------------------------------
// Response models
// ---------------------------------------------------------------------------

/** Returned by GET /contexts and GET /contexts/{id}. */
export interface ApiContextEntity {
  id: string;
  externalId: string;
  type: ApiContextType;
  value: Record<string, unknown> | null;
  title: string;
  source: string | null;
  isActive: boolean;
  isDeleted: boolean;
  created: string;
  updated: string | null;
}

export interface ApiContextType {
  id: string;
  isChildType: boolean;
  parentTypeIds: string[];
}

/** Returned by GET /contexts/types — includes JSON schema for the value shape. */
export interface ApiContextTypeDetails {
  id: string;
  isChildType: boolean;
  parentTypeIds: string[];
  /** JSON schema describing the expected context value structure. Omitted when null. */
  valueSchema: Record<string, unknown> | null;
}

/** Returned by GET /contexts/{id}/relations. */
export interface ApiRelatedContextEntity extends ApiContextEntity {
  relationSource: string | null;
  relationType: string | null;
}

/** Returned by GET /relations. */
export interface ApiContextEntityRef {
  type: string | null;
  source: string | null;
  targetId: string;
  parentId: string;
}

export interface ApiPersonIdentifier {
  uniqueId: string;
  mail: string | null;
}

// ---------------------------------------------------------------------------
// Request models
// ---------------------------------------------------------------------------

/**
 * POST /contexts — create a new context.
 *
 * Validation (FluentValidation):
 * @property type.id — Required, must be an existing context type
 * @property title — Required, max 200 chars, no script tags
 * @property externalId — Required, max 100 chars, no script tags
 * @property source — Optional, max 100 chars, no script tags
 */
export interface NewContextRequest {
  type: ApiContextType;
  value: Record<string, unknown>;
  /** @maxLength 200 */
  title: string;
  /** @maxLength 100 */
  source?: string | null;
  isActive: boolean;
  /** @maxLength 100 */
  externalId: string;
}

/**
 * PUT /contexts/{id} — replace a context.
 *
 * Validation (FluentValidation):
 * Same rules as NewContextRequest, plus:
 * @property id — Must match the route parameter
 */
export interface UpdateContextRequest {
  id: string;
  /** @maxLength 100 */
  externalId: string;
  type: ApiContextType;
  value: Record<string, unknown>;
  /** @maxLength 200 */
  title: string;
  /** @maxLength 100 */
  source?: string | null;
  isActive: boolean;
}

/**
 * PUT /contexts/{parentId}/relations/{targetId} — create or update a relation.
 *
 * Validation (FluentValidation):
 * @property source — Optional, max 100 chars, no script tags
 * @property type — Optional, max 150 chars, no script tags
 */
export interface ContextRelationRequest {
  /** @maxLength 100 */
  source?: string | null;
  /** @maxLength 150 */
  type?: string | null;
}

/**
 * Fusion Contract Personnel API — TypeScript model definitions
 *
 * Source of truth: Fusion.Services.ContractPersonnel/Controllers/
 * No published NuGet API-model package — models are service-internal.
 *
 * Version scope: V2 where available (V1 ApiContract is obsolete; use ApiContractV2).
 * All property names use camelCase to match JSON serialization.
 */

// ---------------------------------------------------------------------------
// Enums (serialized as strings)
// ---------------------------------------------------------------------------

export type ApiDelegateClassification = "Unknown" | "Internal" | "External";

export type ApiAzureAccountStatus = "Available" | "Deleted";

export type ApiRequestState = "Created" | "ApprovedByCompany" | "RejectedByCompany";

export type ApiRequestCategory = "NewRequest" | "ChangeRequest";

export type ApiWorkflowState = "Running" | "Canceled" | "Error" | "Completed" | "Unknown";

export type ApiWorkflowStepState = "Pending" | "Approved" | "Rejected" | "Skipped" | "Unknown";

// ---------------------------------------------------------------------------
// Core response models
// ---------------------------------------------------------------------------

/** Contract (V2) — returned by GET /projects/{projectIdentifier}/contracts/{contractIdentifier}. */
export interface ApiContractV2 {
  id: string;
  name: string;
  contractNumber: string;
  projectMasters: ApiProjectMasterV2[];
  company: ApiCompany;
  startDate: string;
  endDate: string;
  /** Expandable — omitted when null. */
  equinorCompanyRepresentative: ApiPerson | null;
  /** Expandable — omitted when null. */
  equinorContractResponsible: ApiPerson | null;
  /** Expandable — omitted when null. */
  companyRepresentative: ApiPerson | null;
  /** Expandable — omitted when null. */
  contractResponsible: ApiPerson | null;
  /** Expandable — omitted when null. */
  personnel: ApiPersonnel[] | null;
  /** Expandable — omitted when null. */
  delegates: ApiDelegate[] | null;
}

export interface ApiPersonnel {
  id: string;
  contract: ApiContractReference;
  person: ApiPersonnelPerson;
  /** Omitted when null. */
  roleAssignments: ApiRoleAssignment[] | null;
  startDate: string;
  endDate: string;
  created: string;
  createdBy: ApiPerson;
  /** Omitted when null. */
  updated: string | null;
  /** Omitted when null. */
  updatedBy: ApiPerson | null;
}

export interface ApiPersonnelPerson extends ApiPerson {
  /** Account-deletion metadata; omitted when null. */
  deleteInfo: ApiPersonDeleteInfo | null;
}

export interface ApiDelegate {
  id: string;
  classification: ApiDelegateClassification;
  created: string;
  validTo: string;
  /** Omitted when null. */
  recertifiedDate: string | null;
  person: ApiPerson;
  createdBy: ApiPerson;
  /** Omitted when null. */
  recertifiedBy: ApiPerson | null;
  contract: ApiContractReference;
}

export interface ApiPersonnelRequest {
  id: string;
  state: ApiRequestState;
  category: ApiRequestCategory;
  /** Omitted when null. */
  description: string | null;
  startDate: string;
  endDate: string;
  person: ApiPerson;
  /** Omitted when null. */
  originalPersonnel: ApiPersonnel | null;
  created: string;
  /** Omitted when null. */
  updated: string | null;
  createdBy: ApiPerson;
  /** Omitted when null. */
  updatedBy: ApiPerson | null;
  contract: ApiContractReference;
  workflow: ApiWorkflow;
}

// ---------------------------------------------------------------------------
// Workflow
// ---------------------------------------------------------------------------

export interface ApiWorkflow {
  state: ApiWorkflowState;
  steps: ApiWorkflowStep[];
}

export interface ApiWorkflowStep {
  id: string;
  name: string;
  isCompleted: boolean;
  state: ApiWorkflowStepState;
  /** Omitted when null. */
  started: string | null;
  /** Omitted when null. */
  completed: string | null;
  /** Omitted when null. */
  dueDate: string | null;
  /** Omitted when null. */
  completedBy: ApiPerson | null;
  /** Omitted when null. */
  description: string | null;
  /** Omitted when null. */
  reason: string | null;
  /** Omitted when null. */
  previousStep: string | null;
  /** Omitted when null. */
  nextStep: string | null;
}

// ---------------------------------------------------------------------------
// Supporting models
// ---------------------------------------------------------------------------

export interface ApiPerson {
  azureUniquePersonId: string | null;
  mail: string | null;
  name: string;
  phone: string | null;
  upn: string | null;
  accountType: string | null;
  accountStatus: ApiAzureAccountStatus | null;
  preferredContactMail: string | null;
}

export interface ApiPersonDeleteInfo {
  deletedDate: string | null;
  duplicateAzureUniqueId: string | null;
  duplicateUpn: string | null;
}

export interface ApiCompany {
  id: string;
  name: string;
}

export interface ApiContractReference {
  id: string;
  name: string;
  contractNumber: string;
}

export interface ApiProjectMaster {
  id: string;
  name: string;
  isPrimary: boolean;
}

export interface ApiProjectMasterV2 {
  id: string;
  name: string;
  isPrimary: boolean;
}

export interface ApiContractProjectMaster {
  externalId: string;
  name: string;
  contract: ApiContractReferenceV2;
  isPrimary: boolean;
}

export interface ApiContractReferenceV2 {
  id: string;
  name: string;
  contractNumber: string;
}

export interface ApiRole {
  id: string;
  name: string;
}

export interface ApiAccessRole {
  id: string;
  name: string;
}

export interface ApiRoleAssignment {
  id: string;
  role: ApiRole;
}

export interface ApiPersonRoleAssignment {
  id: string;
  person: ApiPerson;
  role: ApiRole;
}

export interface ApiAffiliateSponsor {
  affiliate: ApiPerson;
  sponsor: ApiPerson;
  created: string;
}

export interface ApiAvailableContract {
  name: string;
  contractNumber: string;
  companyName: string;
  startDate: string;
  endDate: string;
}

export interface ApiProjectReference {
  id: string;
  name: string;
  /** Deprecated on the service side; may be omitted. */
  equinorTask?: ApiEquinorTask | null;
}

export interface ApiEquinorTask {
  id?: string | null;
  title?: string | null;
}

// ---------------------------------------------------------------------------
// Change log
// ---------------------------------------------------------------------------

export interface ApiChangeLog {
  id: string;
  projectMaster: ApiProjectMaster;
  contract: ApiChangeLogContract;
  performedBy: ApiChangeLogPerformedBy;
  performed: string;
  action: string;
  description: string | null;
  data: unknown | null;
  source: string;
}

export interface ApiChangeLogContract {
  id: string;
  number: string;
  name: string;
  contractor: string;
}

export interface ApiChangeLogPerformedBy {
  azureUniqueId: string;
  name: string;
  mail: string | null;
  upn: string | null;
}

// ---------------------------------------------------------------------------
// Recertification
// ---------------------------------------------------------------------------

export interface ApiRecertification {
  rowKey: string | null;
  timestamp: string | null;
  contractId: string | null;
  contractNumber: string | null;
  contractName: string | null;
  projectMasterId: string | null;
  projectMasterName: string | null;
  recertifiedByAzureUniqueId: string | null;
  recertifiedForAzureUniqueId: string | null;
  status: string;
  validToDate: string | null;
}

export interface ApiRecertificationError {
  rowKey: string | null;
  timestamp: string | null;
  contractId: string | null;
  contractName: string | null;
  contractNumber: string | null;
  errorMessage: string | null;
  projectMasterId: string | null;
  projectMasterName: string | null;
  status: string;
}

// ---------------------------------------------------------------------------
// Misc
// ---------------------------------------------------------------------------

export interface ApiValidCompany {
  id: string;
  name: string;
}

export interface ApiValidDomain {
  id: string;
  name: string;
}

export interface ApiDeletedAccountInfo extends ApiPerson {
  deleteInfo: ApiPersonDeleteInfo | null;
}

export interface ApiPeopleMigration {
  migrationId: string;
  fromAzureUniqueId: string;
  toAzureUniqueId: string;
}

// ---------------------------------------------------------------------------
// Request/reference models
// ---------------------------------------------------------------------------

export interface PersonReference {
  azureUniquePersonId?: string | null;
  mail?: string | null;
}

export interface PersonnelReference {
  id: string;
}

export interface AllocateContractRequest {
  /** @maxLength 50 */
  contractNumber: string;
  equinorCompanyRepresentative?: PersonReference | null;
  equinorContractResponsible?: PersonReference | null;
  companyRepresentative?: PersonReference | null;
  contractResponsible?: PersonReference | null;
}

export interface PatchContractRequest {
  equinorCompanyRepresentative?: PersonReference | null;
  equinorContractResponsible?: PersonReference | null;
  companyRepresentative?: PersonReference | null;
  contractResponsible?: PersonReference | null;
}

export interface CreatePersonnelRequestRequest {
  description?: string | null;
  startDate: string;
  endDate: string;
  person: PersonReference;
  originalPersonnel?: PersonnelReference | null;
}

export interface RejectPersonnelRequestRequest {
  reason: string;
}

export interface CreateDelegateRequest {
  person: PersonReference;
  validTo: string;
  classification: ApiDelegateClassification;
}

export interface PatchDelegateRequest {
  validTo: string;
}

export interface AssignRoleRequest {
  id: string;
}

export interface PatchPersonRequest {
  preferredContactMail?: string | null;
}

export interface CreateAffiliateSponsorsRequest {
  affiliateId: string;
  sponsorIdentifiers: string[];
}

export interface CreateValidCompanyRequest {
  /** @maxLength 250 */
  name: string;
}

export interface CreateValidDomainRequest {
  /** @maxLength 250 */
  name: string;
}

/**
 * Fusion Mail API — TypeScript model definitions
 *
 * Source of truth: Fusion.Services.Mail/Controllers/
 * No published NuGet API-model package — models are service-internal.
 *
 * All property names use camelCase to match JSON serialization.
 */

// ---------------------------------------------------------------------------
// Enums (serialized as strings in JSON for request/response payloads)
// ---------------------------------------------------------------------------

/**
 * Mail delivery status.
 * Wire format uses the enum names because the request models apply StringEnumConverter.
 */
export type ApiMailStatus =
  | "Processing"
  | "Failed"
  | "PartiallySent"
  | "Sent"
  | "Blocked"
  | "Undelivered";

export const ApiMailStatusName = {
  Processing: "Processing",
  Failed: "Failed",
  PartiallySent: "PartiallySent",
  Sent: "Sent",
  Blocked: "Blocked",
  Undelivered: "Undelivered",
} as const;

// ---------------------------------------------------------------------------
// Response models
// ---------------------------------------------------------------------------

/** Returned by GET /mails/{id} and POST /mails. */
export interface ApiMail {
  id: string;
  subject: string;
  status: ApiMailStatus;
  fromDisplayName?: string | null;
  recipients: string[];
  body?: string | null;
}

/** Recipient delivery result (V3). */
export interface ApiMailV3 {
  recipient: string;
  succeeded: boolean;
  errorMessage: string | null;
}

export interface ApiMailTemplate {
  templateName: string;
  templateData?: ApiMailTemplateData[] | null;
}

export interface ApiMailTemplateData {
  fileName: string;
  fileContent: string;
}

export interface ApiUndeliveredMail {
  id: string;
  timestamp?: string | null;
  from?: string | null;
  recipients?: string[] | null;
  subject?: string | null;
  additionalInfo: ApiAdditionalInfo | null;
  body?: string | null;
  bodyPreview?: string | null;
  sentByApp?: ApiApplication | null;
  sentByPerson: ApiPerson;
}

export interface ApiWhitelist {
  expires: string;
  addedBy: ApiPerson;
  recipient: ApiPerson;
}

export interface ApiLog {
  mailId: string;
  sentByApp?: ApiApplication | null;
  recipients: string[];
  subject: string;
  status: ApiMailStatus;
  timestamp?: string | null;
}

export interface ApiApplication {
  applicationId: string;
}

export interface ApiAdditionalInfo {
  externalId?: string | null;
}

export interface ApiPerson {
  azureUniqueId?: string | null;
  email?: string | null;
}

// ---------------------------------------------------------------------------
// Request models
// ---------------------------------------------------------------------------

/**
 * POST /mails — create and queue a mail.
 *
 * Validation (FluentValidation):
 * @property recipients — Required, each must be a valid email address
 * @property subject — Required, not empty
 * @property body — Required, not empty
 * @property attachments — Total size max 3 MB (4,194,308 bytes base64)
 */
export interface NewMailRequest {
  recipients: string[];
  subject: string;
  body: string;
  fromDisplayName?: string | null;
  attachments?: MailAttachmentRequest[] | null;
}

/**
 * POST /mails/{id}/send — send a previously created mail.
 *
 * Validation:
 * @property messageId — Required, not empty GUID
 * @property senderAppId — Required, not empty GUID
 * @property senderAzureUniqueId — Required, not empty GUID
 */
export interface SendMailRequest {
  messageId: string;
  senderAppId: string;
  senderAzureUniqueId: string;
  recipients: string[];
  fromDisplayName?: string | null;
  subject: string;
  body: string;
}

/**
 * POST /management/send-mail (API v2).
 * Sends a previously created mail item.
 */
export interface SendMailRequestV2 {
  mailId: string;
  senderAppId: string;
  senderAzureUniqueId: string;
}

/**
 * POST /management/send-mail (API v3).
 * Sends a previously created mail item and returns per-recipient results.
 */
export interface SendMailRequestV3 {
  mailId: string;
  senderAppId: string;
  senderAzureUniqueId: string;
}

/**
 * POST /templates/{templateName}/mails — create and queue a mail from a named template.
 *
 * Validation: same recipient/subject rules as NewMailRequest.
 * @property mailBody.htmlContent — Required
 */
export interface NewTemplatedMailRequest {
  recipients: string[];
  subject: string;
  attachments?: MailAttachmentRequest[] | null;
  mailBody: MailBodyRequest;
}

/**
 * Email content template (positional record in C#).
 * @property htmlContent — Required
 */
export interface MailBodyRequest {
  htmlContent: string;
  htmlFooter?: string | null;
  headerTitle?: string | null;
}

/**
 * Mail attachment.
 *
 * Validation:
 * @property name — Required, max 255 chars
 * @property contentBytes — Required, base64-encoded, max ~4 MB
 */
export interface MailAttachmentRequest {
  /** @maxLength 255 */
  name: string;
  contentId?: string | null;
  contentType?: string | null;
  /** Base64-encoded file content. */
  contentBytes: string;
  isInline?: boolean | null;
  lastModifiedDateTime?: string | null;
  size?: number | null;
}

/**
 * PATCH /apps/{appId}/mails/{mailId} — update overall mail status.
 */
export interface UpdateMailStatusRequest {
  status: ApiMailStatus;
}

/**
 * PATCH /apps/{appId}/mails/{mailId}/recipients/{email} — update delivery status for a specific recipient.
 */
export interface UpdateMailDeliveryRequest {
  status: ApiMailStatus;
}

/**
 * POST /management/whitelist — whitelist a recipient.
 *
 * Validation:
 * @property person — Must resolve to a valid user (AzureUniqueId or Mail)
 * @property expiresIn — Optional, format "15d" (days)
 */
export interface WhitelistRequest {
  person: PersonReference;
  expiresIn?: string | null;
}

/**
 * Person lookup reference.
 * Either azureUniqueId or mail should be provided.
 */
export interface PersonReference {
  azureUniqueId?: string | null;
  mail?: string | null;
}

/**
 * Fusion Notification API — TypeScript model definitions
 *
 * Source of truth: Fusion.Services.Notification/Controllers/ViewModels/
 * No published NuGet API-model package — models are service-internal.
 *
 * All property names use camelCase to match JSON serialization.
 */

// ---------------------------------------------------------------------------
// Enums (serialized as strings)
// ---------------------------------------------------------------------------

export type ApiEmailPriorityV1 = "Unknown" | "High" | "Default" | "Low";

// ---------------------------------------------------------------------------
// Response models
// ---------------------------------------------------------------------------

/** Returned by GET /persons/{personIdentifier}/notifications and GET /notifications/{id}. */
export interface ApiNotificationV1 {
  id: string;
  /** Omitted when null. */
  appKey: string | null;
  emailPriority: ApiEmailPriorityV1;
  /** Fallback HTML content; omitted when null. Populated via $expand=fallbackHtml. */
  fallbackHtml: string | null;
  targetAzureUniqueId: string;
  title: string;
  /** Adaptive Card JSON; omitted when null. */
  card: Record<string, unknown> | null;
  created: string;
  /** Populated via $expand=createdBy. Omitted when null. */
  createdBy: ApiPerson | null;
  /** Populated via $expand=createdByApplication. Omitted when null. */
  createdByApplication: ApiApplication | null;
  seenByUser: boolean;
  seen: string | null;
  sourceSystem: ApiSourceSystem | null;
}

export interface ApiNotificationSettings {
  email: boolean;
  delayInMinutes: number;
  appConfig: ApiAppNotificationSetting[];
}

export interface ApiAppNotificationSetting {
  appKey: string;
  displayName: string;
  description: string;
  enabled: boolean;
}

export interface ApiApplication {
  id: string;
  title: string;
}

export interface ApiPerson {
  id: string;
  name: string;
  jobTitle: string | null;
  mail: string | null;
  accountType: string;
}

export interface ApiSourceSystem {
  name: string | null;
  subSystem: string | null;
  identifier: string | null;
}

// ---------------------------------------------------------------------------
// Request models
// ---------------------------------------------------------------------------

/**
 * POST /persons/{id}/notifications — create a notification.
 *
 * Validation (FluentValidation):
 * @property title — Required, no script tags
 * @property description — Required when card is null, no script tags
 * @property card — Must be valid Adaptive Card JSON when present
 * @property appKey — When not empty, must resolve to a valid Fusion app
 * @property sourceSystem.identifier — Required when sourceSystem provided, max 50
 * @property sourceSystem.name — Max 100, no script tags
 * @property sourceSystem.subSystem — Max 100, no script tags
 */
export interface NewFusionNotificationRequestV1 {
  appKey?: string | null;
  emailPriority?: ApiEmailPriorityV1 | null;
  /** Fallback HTML for email rendering. No script tags. */
  fallbackHtml?: string | null;
  title: string;
  /** Required when card is null. No script tags. */
  description?: string | null;
  /** Adaptive Card JSON payload. */
  card?: Record<string, unknown> | null;
  sourceSystem?: ApiSourceSystem | null;
  /** Override the creator identity. */
  originalCreatorUniqueId?: string | null;
}

/**
 * PUT /persons/{id}/notifications/settings — update notification settings.
 */
export interface NotificationSettingsRequest {
  email: boolean;
  delayInMinutes: number;
  appConfig: AppNotificationSettingsRequest[];
}

/**
 * Per-app notification setting request.
 *
 * Validation:
 * @property appKey — Required, max 50
 */
export interface AppNotificationSettingsRequest {
  /** @maxLength 50 */
  appKey: string;
  enabled: boolean;
}

/**
 * PATCH /notifications/{id} — mark seen.
 *
 * Validation:
 * @property seenByUser — Required (must not be null)
 */
export interface PatchFusionNotificationRequestV1 {
  seenByUser: boolean;
}

/**
 * Fusion People API — TypeScript model definitions
 *
 * Source of truth: Fusion.Services.People.ApiModels (NuGet package, multi-target net8.0/net9.0/net10.0)
 * and Fusion.Services.People controller view-models.
 *
 * Version scope: V3/V4 are the primary target, but legacy V1/V2 DTOs are included for compatibility with still-exposed routes.
 * All property names use camelCase to match the JSON serialization output.
 */

// ---------------------------------------------------------------------------
// Enums (serialized as strings)
// ---------------------------------------------------------------------------

export type ApiProfileAccountType =
  | "Employee"
  | "Consultant"
  | "External"
  | "Local"
  | "Unknown"
  | "Application"
  | "Admin"
  | "System";

export type ApiAccountClassification =
  | "Unclassified"
  | "Internal"
  | "External";

export type ApiInvitationStatus =
  | "Accepted"
  | "Pending"
  | "NotSent";

export type ApiGraphPresenceAvailability =
  | "Available"
  | "AvailableIdle"
  | "Away"
  | "BeRightBack"
  | "Busy"
  | "BusyIdle"
  | "DoNotDisturb"
  | "Offline"
  | "PresenceUnknown";

export type ApiGraphPresenceActivity =
  | "Available"
  | "Away"
  | "BeRightBack"
  | "Busy"
  | "DoNotDisturb"
  | "InACall"
  | "InAConferenceCall"
  | "Inactive"
  | "InAMeeting"
  | "Offline"
  | "OffWork"
  | "OutOfOffice"
  | "PresenceUnknown"
  | "Presenting"
  | "UrgentInterruptionsOnly";

export type ApiRoleType =
  | "Global"
  | "Scoped"
  | "GlobalScoped";

export type ApiPeoplePickerAccountType =
  | "Unknown"
  | "Person"
  | "SystemAccount";

export type ApiCompanyAccountType =
  | "Unknown"
  | "Employee"
  | "Consultant"
  | "Intern"
  | "OnContract"
  | "Extern"
  | "AcceptingGuest"
  | "ExternalHire";

export type ApiServicePrincipalType =
  | "Unknown"
  | "Application"
  | "ManagedIdentity"
  | "ServicePrincipal";

// ---------------------------------------------------------------------------
// Core person model (V3)
// ---------------------------------------------------------------------------

/** Returned by GET /persons/{id} (API v1.0). Legacy, but still used by some endpoints. */
export interface ApiPersonV1 {
  fusionPersonId: string;
  azureUniqueId?: string | null;
  mail?: string | null;
  name: string;
  department?: string | null;
  fullDepartment?: string | null;
  mobilePhone?: string | null;
  officeLocation?: string | null;
  upn?: string | null;
  sapId?: string | null;
  employeeId?: string | null;
  employeeType?: string | null;
  orgUnitId?: string | null;
  isResourceOwner?: boolean | null;
  isExpired?: boolean | null;
  expiredDate?: string | null;
  isPrimaryAccount?: boolean | null;
  preferredContactMail?: string | null;
  accountType: ApiProfileAccountType;
  invitationStatus?: ApiInvitationStatus | null;
  accountClassification: ApiAccountClassification;
  managerAzureUniqueId?: string | null;
  linkedAccounts?: ApiProfileAccountLink[] | null;
}

/** Returned by GET /persons/{id} (API v2.0). Legacy alias of the V1-compatible shape. */
export interface ApiPersonV2 extends ApiPersonV1 {
}

/** Returned by GET /persons/{id} (API version 3.0). */
export interface ApiPersonV3 {
  azureUniqueId: string | null;
  name: string;
  mail: string | null;
  jobTitle: string | null;
  department: string | null;
  fullDepartment: string | null;
  mobilePhone: string | null;
  officeLocation: string | null;
  upn: string | null;
  sapId: string | null;
  employeeId: string | null;
  orgUnitId: string | null;
  isPrimaryAccount: boolean | null;
  preferredContactMail: string | null;
  isResourceOwner: boolean | null;
  isExpired: boolean | null;
  expiredDate: string | null;
  accountType: ApiProfileAccountType;
  company: ApiCompanyInfo | null;
  invitationStatus: ApiInvitationStatus | null;
  accountClassification: ApiAccountClassification;
  managerAzureUniqueId: string | null;
  linkedAccounts: ApiProfileAccountLink[] | null;
  /** Expandable — only populated when $expand=roles is requested. */
  roles: ApiPersonRole[] | null;
  /** Expandable — only populated when $expand=positions is requested. */
  positions: ApiPersonPosition[] | null;
  /** Expandable — only populated when $expand=contracts is requested. */
  contracts: ApiPersonContract[] | null;
  /** Expandable — only populated when $expand=manager is requested. */
  manager: ApiManager | null;
}

/** Main person DTO returned by GET /persons/{id} (API version 4.0). */
export interface ApiPersonV4 {
  azureUniqueId?: string | null;
  mail?: string | null;
  name: string;
  jobTitle?: string | null;
  department?: string | null;
  fullDepartment?: string | null;
  mobilePhone?: string | null;
  officeLocation?: string | null;
  upn?: string | null;
  /** Unique identifier in SAP. */
  sapId?: string | null;
  /** Employee ID, aligned with AD model. */
  employeeId?: string | null;
  employeeType?: string | null;
  /** Unique identifier for org unit in SAP. */
  orgUnitId?: string | null;
  isResourceOwner?: boolean | null;
  isExpired?: boolean | null;
  expiredDate?: string | null;
  isPrimaryAccount?: boolean | null;
  preferredContactMail?: string | null;
  accountType: ApiProfileAccountType;
  invitationStatus?: ApiInvitationStatus | null;
  accountClassification: ApiAccountClassification;
  managerAzureUniqueId?: string | null;
  /** List of companies associated with person's contracts. Only populated when $expand=companies is requested. */
  companies?: ApiCompanyInfoV4[] | null;
  /** Expandable — only populated when $expand=roles is requested. */
  roles?: ApiPersonRoleV4[] | null;
  /** Expandable — only populated when $expand=positions is requested. */
  positions?: ApiPersonPositionV4[] | null;
  /** Expandable — only populated when $expand=contracts is requested. */
  contracts?: ApiPersonContractV4[] | null;
  manager?: ApiManager | null;
  linkedAccounts?: ApiProfileAccountLink[] | null;
}

// ---------------------------------------------------------------------------
// Supporting person models
// ---------------------------------------------------------------------------

export interface ApiCompanyInfo {
  id: string;
  name: string;
}

export interface ApiCompanyInfoV4 {
  id: string;
  name?: string | null;
}

export interface ApiProfileAccountLink {
  azureUniqueId: string;
  mail: string | null;
  isPrimaryAccount: boolean | null;
  preferredContactMail: string | null;
  isExpired: boolean | null;
  upn: string | null;
}

export interface ApiManager {
  azureUniqueId: string;
  name: string;
  mail: string | null;
  department: string | null;
  fullDepartment: string | null;
  upn: string | null;
  jobTitle: string | null;
  accountType: ApiProfileAccountType;
  accountClassification: ApiAccountClassification;
}

export interface ApiProfileRef {
  azureUniqueId: string | null;
  name: string;
  mail: string | null;
  jobTitle: string | null;
  department: string | null;
  fullDepartment: string | null;
  mobilePhone: string | null;
  officeLocation: string | null;
  upn: string | null;
  accountType: ApiProfileAccountType;
  accountClassification: ApiAccountClassification;
}

export interface ApiPersonLink {
  targetAzureUniqueId: string;
  createdByAzureUniqueId: string;
  description: string | null;
  created: string;
  target: ApiProfileRef | null;
  createdBy: ApiProfileRef | null;
}

export interface ApiExtendedProfile {
  preferredContactMail: string | null;
  isPrimaryAccount: boolean | null;
}

// ---------------------------------------------------------------------------
// Roles
// ---------------------------------------------------------------------------

export interface ApiPersonRole {
  name: string;
  displayName: string | null;
  sourceSystem: string | null;
  /** "Global" | "Scoped" | "GlobalScoped" */
  type: ApiRoleType;
  isActive: boolean;
  activeToUtc: string | null;
  onDemandSupport: boolean;
  scope: ApiPersonRoleScope | null;
}

export interface ApiPersonRoleScope {
  type: string;
  value: string | null;
  valueType: string | null;
}

export interface ApiRoleDefinition {
  name: string;
  displayName: string | null;
  type: ApiRoleType;
  scopeType: string | null;
  description: string | null;
  onDemandSupport: boolean;
  sourceSystem: string | null;
}

// ---------------------------------------------------------------------------
// V4-specific role and position models
// ---------------------------------------------------------------------------

/** Role model in V4 — supports aggregated scopes. */
export interface ApiPersonRoleV4 {
  name: string;
  displayName: string;
  sourceSystem?: string | null;
  type: string; // "Global" | "Scoped" | "GlobalScoped"
  isActive: boolean;
  activeToUtc?: string | null;
  onDemandSupport: boolean;
  scopes?: ApiPersonRoleScopeV4[] | null;
}

/** Role scope aggregation in V4. */
export interface ApiPersonRoleScopeV4 {
  type: string;
  values?: string[] | null;
  valueType?: string | null;
}

// ---------------------------------------------------------------------------
// Positions & contracts
// ---------------------------------------------------------------------------

export interface ApiPersonPosition {
  positionId: string;
  positionExternalId: string | null;
  id: string;
  parentPositionId: string | null;
  taskOwnerIds: string[] | null;
  name: string | null;
  obs: string | null;
  basePosition: ApiPersonBasePosition;
  project: ApiPersonProject;
  isTaskOwner: boolean;
  appliesFrom: string | null;
  appliesTo: string | null;
  workload: number | null;
}

export interface ApiPersonBasePosition {
  id: string;
  name: string;
  type: string;
  discipline: string | null;
}

export interface ApiPersonProject {
  id: string;
  name: string;
  domainId: string | null;
  type: string;
}

export interface ApiPersonContract {
  id: string;
  name: string;
  contractNumber: string;
  companyId: string | null;
  companyName: string;
  project: ApiPersonProject;
  projectMaster: ApiProjectMaster;
  positions: ApiContractPosition[];
}

export interface ApiContractPosition {
  positionId: string;
  id: string;
  name: string;
  externalPositionId: string | null;
  obs: string | null;
  appliesFrom: string | null;
  appliesTo: string | null;
  workload: number | null;
  basePosition: ApiPersonBasePosition;
}

export interface ApiProjectMaster {
  id: string;
  name: string;
}

// ---------------------------------------------------------------------------
// V4-specific position and contract models
// ---------------------------------------------------------------------------

/** Position model in V4 (enhanced with additional metadata). */
export interface ApiPersonPositionV4 {
  positionId: string;
  positionExternalId?: string | null;
  id: string;
  parentPositionId?: string | null;
  taskOwnerIds?: string[] | null;
  name: string;
  obs?: string | null;
  type: string;
  basePosition: ApiPersonBasePositionV4;
  project?: ApiPersonProjectV4 | null;
  isTaskOwner: boolean;
  isProjectManagementTeam: boolean;
  appliesFrom?: string | null;
  appliesTo?: string | null;
  workload?: number | null;
}

/** Base position model in V4. */
export interface ApiPersonBasePositionV4 {
  id: string;
  name?: string | null;
  type?: string | null;
  discipline?: string | null;
}

/** Project reference in V4. */
export interface ApiPersonProjectV4 {
  id: string;
  name: string;
  domainId?: string | null;
  type: string;
}

/** Contract model in V4 (with aggregated positions). */
export interface ApiPersonContractV4 {
  id: string;
  name: string;
  contractNumber: string;
  companyId?: string | null;
  companyName?: string | null;
  project: ApiPersonProjectV4;
  projectMaster?: ApiProjectMaster | null;
  positions: ApiContractPositionV4[];
}

/** Contract position model in V4. */
export interface ApiContractPositionV4 {
  positionId: string;
  id: string;
  name: string;
  externalPositionId?: string | null;
  obs?: string | null;
  appliesFrom?: string | null;
  appliesTo?: string | null;
  workload?: number | null;
  basePosition: ApiPersonBasePositionV4;
}

// ---------------------------------------------------------------------------
// Presence
// ---------------------------------------------------------------------------

/** Returned by GET /persons/{id}/presence (V1). */
export interface ApiPresenceV1 {
  id: string;
  availability: ApiGraphPresenceAvailability;
  activity: ApiGraphPresenceActivity | null;
}

// ---------------------------------------------------------------------------
// Search
// ---------------------------------------------------------------------------

/** Returned by GET /persons (search, V2). */
export interface ApiPersonSearchResultV2 {
  azureUniqueId: string | null;
  mail: string | null;
  preferredContactMail: string | null;
  name: string;
  jobTitle: string | null;
  department: string | null;
  fullDepartment: string | null;
  mobilePhone: string | null;
  officeLocation: string | null;
  upn: string | null;
  employeeId: string | null;
  orgUnitId: string | null;
  isResourceOwner: boolean;
  accountType: ApiProfileAccountType;
  accountClassification: ApiAccountClassification;
}

/** Returned by GET /persons (search, V1). OBSOLETE - use V2. */
export interface ApiPersonSearchResultV1 {
  fusionPersonId?: string | null;
  azureUniquePersonId?: string | null;
  name: string;
  jobTitle?: string | null;
  department?: string | null;
  fullDepartment?: string | null;
  mail?: string | null;
  preferredContactMail?: string | null;
  company?: string | null;
  mobilePhone?: string | null;
  officeLocation?: string | null;
  userPrincipalName?: string | null;
  employeeId?: string | null;
  employeeType?: string | null;
  orgUnitId?: string | null;
  isResourceOwner: boolean;
  accountType?: string | null;
  accountClassification?: string | null;
  isFusionLocal: boolean;
  isAffiliateAccess: boolean;
}

// ---------------------------------------------------------------------------
// Group membership
// ---------------------------------------------------------------------------

export interface ApiGroupMembership {
  azureAdGroupId: string | null;
  isMember: boolean;
}

// ---------------------------------------------------------------------------
// Batch operations - Ensure/Create/Validate
// ---------------------------------------------------------------------------

/** Result from POST /persons/ensure (v2 and v3). Batch response for ensure operation. */
export interface ApiPersonValidationResultV2 {
  success: boolean;
  statusCode: number;
  message?: string | null;
  identifier: string;
  person?: ApiPersonV1 | null;
}

/** Result from POST /persons (v1). Batch response for create local persons operation. */
export interface ApiCreatePersonResult {
  person?: ApiPersonV1 | null;
  success: boolean;
  statusCode: number;
  message?: string | null;
  identifier: string;
  index: number;
}

// ---------------------------------------------------------------------------
// Request models for person operations
// ---------------------------------------------------------------------------

/** Request for POST /persons/ensure — ensure multiple persons exist in the database. */
export interface ValidatePersonsRequest {
  /**
   * List of identifiers (Azure Unique ID, mail, or UPN) to resolve/ensure.
   */
  personIdentifiers: string[];
}

/** Request for POST /persons — create local (non-AD) persons in the database. */
export interface CreatePersonsRequest {
  persons: NewPersonRequest[];
}

export interface NewPersonRequest {
  mail: string;
  name: string;
  jobTitle?: string | null;
  mobilePhone?: string | null;
  officeLocation?: string | null;
}

/** Request for POST /persons/{personId}/linked-accounts — link two person accounts. */
export interface AccountLinkRequest {
  /**
   * The identifier to link to (mail or Azure Unique ID).
   * Must resolve to an Azure AD account.
   * Maximum 100 characters.
   */
  identifier: string;
  /**
   * Optional description for the link (max 1000 characters, no scripts).
   */
  description?: string | null;
  /**
   * Optional — Allow overriding the creator (applications only).
   */
  createdByAzureUniqueId?: string | null;
}

// ---------------------------------------------------------------------------
// People Picker — Search & resolve persons and service principals
// ---------------------------------------------------------------------------

/** Request for searching persons and service principals. */
export interface PeoplePickerQueryRequest {
  /** Query string for searching (required). */
  queryString?: string;
  /** Optional filter by account type (e.g., "Person", "SystemAccount"). */
  types?: string[];
}

/** Request for resolving persons and service principals by identifiers. */
export interface ResolveProfilesRequest {
  /**
   * List of Azure Unique IDs, Email addresses, or User Principal Names (UPNs) to resolve.
   * Maximum 100 identifiers per request.
   */
  identifiers: string[];
}

/** Account found in people picker search results. */
export interface ApiPeoplePickerAccount {
  azureUniqueId: string;
  name: string;
  accountType: ApiPeoplePickerAccountType;
  accountLabel: string;
  /** Person details (when accountType is "Person"). */
  person?: ApiPeoplePickerPerson | null;
  /** Application details (when accountType is "SystemAccount" and it's an app). */
  application?: ApiPeoplePickerApplication | null;
  avatarColor: string;
  avatarUrl: string;
  isExpired: boolean;
}

/** Person details from people picker search results. */
export interface ApiPeoplePickerPerson {
  accountType: ApiCompanyAccountType;
  jobTitle?: string | null;
  department?: string | null;
  fullDepartment?: string | null;
  employeeNumber?: string | null;
  employeeType?: string | null;
  managerAzureUniqueId?: string | null;
  mail?: string | null;
  preferredMail?: string | null;
  upn?: string | null;
  mobilePhone?: string | null;
}

/** Application details from people picker search results. */
export interface ApiPeoplePickerApplication {
  applicationId: string;
  applicationName?: string | null;
  servicePrincipalType: ApiServicePrincipalType;
}

/** Resolved account result from people picker resolve endpoint. */
export interface ApiPeoplePickerProfile {
  success: boolean;
  statusCode: number;
  errorMessage?: string | null;
  identifier: string;
  account?: ApiPeoplePickerResolvedAccount | null;
}

/** Resolved account details (similar to ApiPeoplePickerAccount but for resolve endpoint). */
export interface ApiPeoplePickerResolvedAccount {
  azureUniqueId?: string | null;
  name: string;
  accountType: ApiPeoplePickerAccountType;
  accountLabel: string;
  /** Person details (when accountType is "Person"). */
  person?: ApiPeoplePickerResolvedPerson | null;
  /** Application details (when accountType is "SystemAccount" and it's an app). */
  application?: ApiPeoplePickerApplication | null;
  avatarColor: string;
  avatarUrl: string;
  isExpired: boolean;
}

/** Person details from people picker resolve endpoint (same as ApiPeoplePickerPerson). */
export interface ApiPeoplePickerResolvedPerson {
  accountType: ApiCompanyAccountType;
  jobTitle?: string | null;
  department?: string | null;
  fullDepartment?: string | null;
  employeeNumber?: string | null;
  employeeType?: string | null;
  managerAzureUniqueId?: string | null;
  mail?: string | null;
  preferredMail?: string | null;
  upn?: string | null;
  mobilePhone?: string | null;
}