@hed-hog/operations 0.0.331 → 0.0.332

package/hedhog/frontend/app/_lib/api.ts.ejs

@@ -1,480 +1,631 @@
-type RequestFn = (input: {
-  url: string;
-  method: string;
-  data?: unknown;
-}) => Promise<{ data: unknown }>;
-
-export function getOperationsErrorMessage(error: unknown, fallback: string) {
-  if (error && typeof error === 'object') {
-    const requestError = error as {
-      message?: string;
-      response?: {
-        data?: {
-          message?: string | string[];
-        };
-      };
-    };
-
-    const message =
-      requestError.response?.data?.message ?? requestError.message;
-
-    if (Array.isArray(message)) {
-      const combined = message.filter(Boolean).join(' ');
-      if (combined.trim()) {
-        return combined;
-      }
-    }
-
-    if (typeof message === 'string' && message.trim()) {
-      return message;
-    }
-  }
-
-  return fallback;
-}
-
-export async function fetchOperations<T>(request: RequestFn, url: string) {
-  const response = await request({
-    url,
-    method: 'GET',
-  });
-
-  return response.data as T;
-}
-
-export async function mutateOperations<T>(
-  request: RequestFn,
-  url: string,
-  method: 'POST' | 'PATCH' | 'DELETE',
-  data?: unknown
-) {
-  const response = await request({
-    url,
-    method,
-    data,
-  });
-
-  return response.data as T;
-}
-
-// ─── Cost Types ───────────────────────────────────────────────────────────────
-
-export type CostType = {
-  id: number;
-  slug: string;
-  name: string;
-  code?: string | null;
-  category?: string | null;
-  description?: string | null;
-  defaultRecurrence?: 'monthly' | 'one_time' | 'yearly' | null;
-  isAllocatable?: boolean | null;
-  isDepreciable?: boolean | null;
-  isActive: boolean;
-};
-
-export function fetchCostTypes(
-  request: RequestFn,
-  args: {
-    search?: string;
-    active?: boolean;
-    page?: number;
-    pageSize?: number;
-  } = {}
-) {
-  const { search, active, page, pageSize } = args;
-  const params = new URLSearchParams();
-  if (search?.trim()) {
-    params.set('search', search.trim());
-  }
-  if (active !== undefined) {
-    params.set('active', String(active));
-  }
-  if (page !== undefined) {
-    params.set('page', String(page));
-  }
-  if (pageSize !== undefined) {
-    params.set('pageSize', String(pageSize));
-  }
-  const qs = params.toString();
-  return fetchOperations<CostType[]>(
-    request,
-    qs ? `/operations/cost-types?${qs}` : '/operations/cost-types'
-  );
-}
-
-export function createCostType(
-  request: RequestFn,
-  data: {
-    name: string;
-    slug?: string | null;
-    code?: string | null;
-    category?: string | null;
-    description?: string | null;
-    defaultRecurrence?: string | null;
-    isAllocatable?: boolean | null;
-    isDepreciable?: boolean | null;
-    isActive?: boolean;
-  }
-) {
-  return mutateOperations<CostType>(
-    request,
-    '/operations/cost-types',
-    'POST',
-    data
-  );
-}
-
-// ─── Collaborators ────────────────────────────────────────────────────────────
-
-export function fetchCollaborators(request: RequestFn) {
-  return fetchOperations<import('./types').OperationsCollaborator[]>(
-    request,
-    '/operations/collaborators'
-  );
-}
-
-// ─── Collaborator Costs ───────────────────────────────────────────────────────
-
-export type CollaboratorCost = {
-  id: number;
-  collaboratorId: number;
-  costTypeId: number;
-  costTypeName: string;
-  costTypeSlug: string;
-  amount: string;
-  currency: string;
-  recurrence: 'one_time' | 'monthly' | 'yearly';
-  allocatable?: boolean;
-  /** ISO date string — mapped to startDate going forward */
-  referenceDate: string | null;
-  startDate?: string | null;
-  endDate?: string | null;
-  depreciationMonths?: number | null;
-  description: string | null;
-  notes?: string | null;
-  createdAt: string;
-};
-
-export function fetchCollaboratorCosts(
-  request: RequestFn,
-  collaboratorId: number
-) {
-  return fetchOperations<CollaboratorCost[]>(
-    request,
-    `/operations/collaborators/${collaboratorId}/costs`
-  );
-}
-
-export function createCollaboratorCost(
-  request: RequestFn,
-  collaboratorId: number,
-  data: {
-    costTypeId: number;
-    amount: number;
-    currency?: string;
-    recurrence?: string;
-    allocatable?: boolean;
-    referenceDate?: string | null;
-    startDate?: string | null;
-    endDate?: string | null;
-    depreciationMonths?: number | null;
-    description?: string | null;
-    notes?: string | null;
-  }
-) {
-  return mutateOperations<CollaboratorCost>(
-    request,
-    `/operations/collaborators/${collaboratorId}/costs`,
-    'POST',
-    data
-  );
-}
-
-export function updateCollaboratorCost(
-  request: RequestFn,
-  collaboratorId: number,
-  costId: number,
-  data: Partial<{
-    costTypeId: number;
-    amount: number;
-    currency: string;
-    recurrence: string;
-    allocatable: boolean;
-    referenceDate: string | null;
-    startDate: string | null;
-    endDate: string | null;
-    depreciationMonths: number | null;
-    description: string | null;
-    notes: string | null;
-  }>
-) {
-  return mutateOperations<CollaboratorCost>(
-    request,
-    `/operations/collaborators/${collaboratorId}/costs/${costId}`,
-    'PATCH',
-    data
-  );
-}
-
-export function deleteCollaboratorCost(
-  request: RequestFn,
-  collaboratorId: number,
-  costId: number
-) {
-  return mutateOperations<{ success: boolean }>(
-    request,
-    `/operations/collaborators/${collaboratorId}/costs/${costId}`,
-    'DELETE'
-  );
-}
-
-// ─── Currencies ───────────────────────────────────────────────────────────────
-
-export type Currency = Record<string, unknown> & {
-  id: number;
-  code: string;
-  name: string;
-  symbol: string;
-  status: 'active' | 'inactive';
-};
-
-export function listCurrencies(
-  request: RequestFn,
-  params?: Record<string, string>
-) {
-  const qs = params ? new URLSearchParams(params).toString() : '';
-  return fetchOperations<Currency[]>(
-    request,
-    qs ? `/finance/currencies?${qs}` : '/finance/currencies'
-  );
-}
-
-// ─── Project Cost Categories ──────────────────────────────────────────────────
-
-export function listProjectCostCategories(
-  request: RequestFn,
-  params?: Record<string, string>
-) {
-  const qs = params ? new URLSearchParams(params).toString() : '';
-  return fetchOperations(
-    request,
-    qs
-      ? `/operations/project-cost-categories?${qs}`
-      : '/operations/project-cost-categories'
-  );
-}
-
-export function createProjectCostCategory(request: RequestFn, data: unknown) {
-  return mutateOperations(
-    request,
-    '/operations/project-cost-categories',
-    'POST',
-    data
-  );
-}
-
-export function updateProjectCostCategory(
-  request: RequestFn,
-  id: number,
-  data: unknown
-) {
-  return mutateOperations(
-    request,
-    `/operations/project-cost-categories/${id}`,
-    'PATCH',
-    data
-  );
-}
-
-export function deleteProjectCostCategory(request: RequestFn, id: number) {
-  return mutateOperations(
-    request,
-    `/operations/project-cost-categories/${id}`,
-    'DELETE'
-  );
-}
-
-// ─── Project Cost Types ───────────────────────────────────────────────────────
-
-export function listProjectCostTypes(
-  request: RequestFn,
-  params?: Record<string, string>
-) {
-  const qs = params ? new URLSearchParams(params).toString() : '';
-  return fetchOperations(
-    request,
-    qs
-      ? `/operations/project-cost-types?${qs}`
-      : '/operations/project-cost-types'
-  );
-}
-
-export function createProjectCostType(request: RequestFn, data: unknown) {
-  return mutateOperations(
-    request,
-    '/operations/project-cost-types',
-    'POST',
-    data
-  );
-}
-
-export function updateProjectCostType(
-  request: RequestFn,
-  id: number,
-  data: unknown
-) {
-  return mutateOperations(
-    request,
-    `/operations/project-cost-types/${id}`,
-    'PATCH',
-    data
-  );
-}
-
-export function deleteProjectCostType(request: RequestFn, id: number) {
-  return mutateOperations(
-    request,
-    `/operations/project-cost-types/${id}`,
-    'DELETE'
-  );
-}
-
-// ─── Project Costs ────────────────────────────────────────────────────────────
-
-export function listProjectCosts(
-  request: RequestFn,
-  projectId: number,
-  params?: Record<string, string>
-) {
-  const qs = params ? new URLSearchParams(params).toString() : '';
-  return fetchOperations(
-    request,
-    qs
-      ? `/operations/projects/${projectId}/costs?${qs}`
-      : `/operations/projects/${projectId}/costs`
-  );
-}
-
-export function getProjectCostsSummary(request: RequestFn, projectId: number) {
-  return fetchOperations(
-    request,
-    `/operations/projects/${projectId}/costs/summary`
-  );
-}
-
-export function getFullProjectCostSummary(
-  request: RequestFn,
-  projectId: number
-) {
-  return fetchOperations(
-    request,
-    `/operations/projects/${projectId}/cost-summary`
-  );
-}
-
-export function createProjectCost(
-  request: RequestFn,
-  projectId: number,
-  data: unknown
-) {
-  return mutateOperations(
-    request,
-    `/operations/projects/${projectId}/costs`,
-    'POST',
-    data
-  );
-}
-
-export function updateProjectCost(
-  request: RequestFn,
-  projectId: number,
-  costId: number,
-  data: unknown
-) {
-  return mutateOperations(
-    request,
-    `/operations/projects/${projectId}/costs/${costId}`,
-    'PATCH',
-    data
-  );
-}
-
-export function deleteProjectCost(
-  request: RequestFn,
-  projectId: number,
-  costId: number
-) {
-  return mutateOperations(
-    request,
-    `/operations/projects/${projectId}/costs/${costId}`,
-    'DELETE'
-  );
-}
-
-export function getProjectCostReport(
-  request: RequestFn,
-  projectId: number,
-  filters?: Record<string, unknown>
-) {
-  const params = filters
-    ? '?' +
-      new URLSearchParams(
-        Object.entries(filters)
-          .filter(([, v]) => v !== undefined && v !== null)
-          .map(([k, v]) => [k, String(v)])
-      ).toString()
-    : '';
-  return fetchOperations(
-    request,
-    `/operations/projects/${projectId}/costs/report${params}`
-  );
-}
-
-// ─── Task Comments ────────────────────────────────────────────────────────────
-
-export function fetchTaskActivities(request: RequestFn, taskId: number) {
-  return fetchOperations(request, `/operations/tasks/${taskId}/activities`);
-}
-
-export function fetchTaskComments(request: RequestFn, taskId: number) {
-  return fetchOperations(request, `/operations/tasks/${taskId}/comments`);
-}
-
-export function createTaskComment(
-  request: RequestFn,
-  taskId: number,
-  content: string
-) {
-  return mutateOperations(
-    request,
-    `/operations/tasks/${taskId}/comments`,
-    'POST',
-    { content }
-  );
-}
-
-export function updateTaskComment(
-  request: RequestFn,
-  taskId: number,
-  commentId: number,
-  content: string
-) {
-  return mutateOperations(
-    request,
-    `/operations/tasks/${taskId}/comments/${commentId}`,
-    'PATCH',
-    { content }
-  );
-}
-
-export function deleteTaskComment(
-  request: RequestFn,
-  taskId: number,
-  commentId: number
-) {
-  return mutateOperations(
-    request,
-    `/operations/tasks/${taskId}/comments/${commentId}`,
-    'DELETE'
-  );
-}
+type RequestFn = (input: {
+  url: string;
+  method: string;
+  data?: unknown;
+}) => Promise<{ data: unknown }>;
+
+export function getOperationsErrorMessage(error: unknown, fallback: string) {
+  if (error && typeof error === 'object') {
+    const requestError = error as {
+      message?: string;
+      response?: {
+        data?: {
+          message?: string | string[];
+        };
+      };
+    };
+
+    const message =
+      requestError.response?.data?.message ?? requestError.message;
+
+    if (Array.isArray(message)) {
+      const combined = message.filter(Boolean).join(' ');
+      if (combined.trim()) {
+        return combined;
+      }
+    }
+
+    if (typeof message === 'string' && message.trim()) {
+      return message;
+    }
+  }
+
+  return fallback;
+}
+
+export async function fetchOperations<T>(request: RequestFn, url: string) {
+  const response = await request({
+    url,
+    method: 'GET',
+  });
+
+  return response.data as T;
+}
+
+export async function mutateOperations<T>(
+  request: RequestFn,
+  url: string,
+  method: 'POST' | 'PATCH' | 'DELETE',
+  data?: unknown
+) {
+  const response = await request({
+    url,
+    method,
+    data,
+  });
+
+  return response.data as T;
+}
+
+// ─── Cost Types ───────────────────────────────────────────────────────────────
+
+export type CostType = {
+  id: number;
+  slug: string;
+  name: string;
+  code?: string | null;
+  category?: string | null;
+  description?: string | null;
+  defaultRecurrence?: 'monthly' | 'one_time' | 'yearly' | null;
+  isAllocatable?: boolean | null;
+  isDepreciable?: boolean | null;
+  isActive: boolean;
+};
+
+export function fetchCostTypes(
+  request: RequestFn,
+  args: {
+    search?: string;
+    active?: boolean;
+    page?: number;
+    pageSize?: number;
+  } = {}
+) {
+  const { search, active, page, pageSize } = args;
+  const params = new URLSearchParams();
+  if (search?.trim()) {
+    params.set('search', search.trim());
+  }
+  if (active !== undefined) {
+    params.set('active', String(active));
+  }
+  if (page !== undefined) {
+    params.set('page', String(page));
+  }
+  if (pageSize !== undefined) {
+    params.set('pageSize', String(pageSize));
+  }
+  const qs = params.toString();
+  return fetchOperations<CostType[]>(
+    request,
+    qs ? `/operations/cost-types?${qs}` : '/operations/cost-types'
+  );
+}
+
+export function createCostType(
+  request: RequestFn,
+  data: {
+    name: string;
+    slug?: string | null;
+    code?: string | null;
+    category?: string | null;
+    description?: string | null;
+    defaultRecurrence?: string | null;
+    isAllocatable?: boolean | null;
+    isDepreciable?: boolean | null;
+    isActive?: boolean;
+  }
+) {
+  return mutateOperations<CostType>(
+    request,
+    '/operations/cost-types',
+    'POST',
+    data
+  );
+}
+
+// ─── Collaborators ────────────────────────────────────────────────────────────
+
+export function fetchCollaborators(request: RequestFn) {
+  return fetchOperations<import('./types').OperationsCollaborator[]>(
+    request,
+    '/operations/collaborators'
+  );
+}
+
+// ─── Collaborator Costs ───────────────────────────────────────────────────────
+
+export type CollaboratorCost = {
+  id: number;
+  collaboratorId: number;
+  costTypeId: number;
+  costTypeName: string;
+  costTypeSlug: string;
+  amount: string;
+  currency: string;
+  recurrence: 'one_time' | 'monthly' | 'yearly';
+  allocatable?: boolean;
+  /** ISO date string — mapped to startDate going forward */
+  referenceDate: string | null;
+  startDate?: string | null;
+  endDate?: string | null;
+  depreciationMonths?: number | null;
+  description: string | null;
+  notes?: string | null;
+  createdAt: string;
+};
+
+export function fetchCollaboratorCosts(
+  request: RequestFn,
+  collaboratorId: number
+) {
+  return fetchOperations<CollaboratorCost[]>(
+    request,
+    `/operations/collaborators/${collaboratorId}/costs`
+  );
+}
+
+export function createCollaboratorCost(
+  request: RequestFn,
+  collaboratorId: number,
+  data: {
+    costTypeId: number;
+    amount: number;
+    currency?: string;
+    recurrence?: string;
+    allocatable?: boolean;
+    referenceDate?: string | null;
+    startDate?: string | null;
+    endDate?: string | null;
+    depreciationMonths?: number | null;
+    description?: string | null;
+    notes?: string | null;
+  }
+) {
+  return mutateOperations<CollaboratorCost>(
+    request,
+    `/operations/collaborators/${collaboratorId}/costs`,
+    'POST',
+    data
+  );
+}
+
+export function updateCollaboratorCost(
+  request: RequestFn,
+  collaboratorId: number,
+  costId: number,
+  data: Partial<{
+    costTypeId: number;
+    amount: number;
+    currency: string;
+    recurrence: string;
+    allocatable: boolean;
+    referenceDate: string | null;
+    startDate: string | null;
+    endDate: string | null;
+    depreciationMonths: number | null;
+    description: string | null;
+    notes: string | null;
+  }>
+) {
+  return mutateOperations<CollaboratorCost>(
+    request,
+    `/operations/collaborators/${collaboratorId}/costs/${costId}`,
+    'PATCH',
+    data
+  );
+}
+
+export function deleteCollaboratorCost(
+  request: RequestFn,
+  collaboratorId: number,
+  costId: number
+) {
+  return mutateOperations<{ success: boolean }>(
+    request,
+    `/operations/collaborators/${collaboratorId}/costs/${costId}`,
+    'DELETE'
+  );
+}
+
+// ─── Currencies ───────────────────────────────────────────────────────────────
+
+export type Currency = Record<string, unknown> & {
+  id: number;
+  code: string;
+  name: string;
+  symbol: string;
+  status: 'active' | 'inactive';
+};
+
+export function listCurrencies(
+  request: RequestFn,
+  params?: Record<string, string>
+) {
+  const qs = params ? new URLSearchParams(params).toString() : '';
+  return fetchOperations<Currency[]>(
+    request,
+    qs ? `/finance/currencies?${qs}` : '/finance/currencies'
+  );
+}
+
+// ─── Project Cost Categories ──────────────────────────────────────────────────
+
+export function listProjectCostCategories(
+  request: RequestFn,
+  params?: Record<string, string>
+) {
+  const qs = params ? new URLSearchParams(params).toString() : '';
+  return fetchOperations(
+    request,
+    qs
+      ? `/operations/project-cost-categories?${qs}`
+      : '/operations/project-cost-categories'
+  );
+}
+
+export function createProjectCostCategory(request: RequestFn, data: unknown) {
+  return mutateOperations(
+    request,
+    '/operations/project-cost-categories',
+    'POST',
+    data
+  );
+}
+
+export function updateProjectCostCategory(
+  request: RequestFn,
+  id: number,
+  data: unknown
+) {
+  return mutateOperations(
+    request,
+    `/operations/project-cost-categories/${id}`,
+    'PATCH',
+    data
+  );
+}
+
+export function deleteProjectCostCategory(request: RequestFn, id: number) {
+  return mutateOperations(
+    request,
+    `/operations/project-cost-categories/${id}`,
+    'DELETE'
+  );
+}
+
+// ─── Project Cost Types ───────────────────────────────────────────────────────
+
+export function listProjectCostTypes(
+  request: RequestFn,
+  params?: Record<string, string>
+) {
+  const qs = params ? new URLSearchParams(params).toString() : '';
+  return fetchOperations(
+    request,
+    qs
+      ? `/operations/project-cost-types?${qs}`
+      : '/operations/project-cost-types'
+  );
+}
+
+export function createProjectCostType(request: RequestFn, data: unknown) {
+  return mutateOperations(
+    request,
+    '/operations/project-cost-types',
+    'POST',
+    data
+  );
+}
+
+export function updateProjectCostType(
+  request: RequestFn,
+  id: number,
+  data: unknown
+) {
+  return mutateOperations(
+    request,
+    `/operations/project-cost-types/${id}`,
+    'PATCH',
+    data
+  );
+}
+
+export function deleteProjectCostType(request: RequestFn, id: number) {
+  return mutateOperations(
+    request,
+    `/operations/project-cost-types/${id}`,
+    'DELETE'
+  );
+}
+
+// ─── Project Costs ────────────────────────────────────────────────────────────
+
+export function listProjectCosts(
+  request: RequestFn,
+  projectId: number,
+  params?: Record<string, string>
+) {
+  const qs = params ? new URLSearchParams(params).toString() : '';
+  return fetchOperations(
+    request,
+    qs
+      ? `/operations/projects/${projectId}/costs?${qs}`
+      : `/operations/projects/${projectId}/costs`
+  );
+}
+
+export function getProjectCostsSummary(request: RequestFn, projectId: number) {
+  return fetchOperations(
+    request,
+    `/operations/projects/${projectId}/costs/summary`
+  );
+}
+
+export function getFullProjectCostSummary(
+  request: RequestFn,
+  projectId: number
+) {
+  return fetchOperations(
+    request,
+    `/operations/projects/${projectId}/cost-summary`
+  );
+}
+
+export function createProjectCost(
+  request: RequestFn,
+  projectId: number,
+  data: unknown
+) {
+  return mutateOperations(
+    request,
+    `/operations/projects/${projectId}/costs`,
+    'POST',
+    data
+  );
+}
+
+export function updateProjectCost(
+  request: RequestFn,
+  projectId: number,
+  costId: number,
+  data: unknown
+) {
+  return mutateOperations(
+    request,
+    `/operations/projects/${projectId}/costs/${costId}`,
+    'PATCH',
+    data
+  );
+}
+
+export function deleteProjectCost(
+  request: RequestFn,
+  projectId: number,
+  costId: number
+) {
+  return mutateOperations(
+    request,
+    `/operations/projects/${projectId}/costs/${costId}`,
+    'DELETE'
+  );
+}
+
+export function getProjectCostReport(
+  request: RequestFn,
+  projectId: number,
+  filters?: Record<string, unknown>
+) {
+  const params = filters
+    ? '?' +
+      new URLSearchParams(
+        Object.entries(filters)
+          .filter(([, v]) => v !== undefined && v !== null)
+          .map(([k, v]) => [k, String(v)])
+      ).toString()
+    : '';
+  return fetchOperations(
+    request,
+    `/operations/projects/${projectId}/costs/report${params}`
+  );
+}
+
+// ─── Task Comments ────────────────────────────────────────────────────────────
+
+export function fetchTaskActivities(request: RequestFn, taskId: number) {
+  return fetchOperations(request, `/operations/tasks/${taskId}/activities`);
+}
+
+export function fetchTaskComments(request: RequestFn, taskId: number) {
+  return fetchOperations(request, `/operations/tasks/${taskId}/comments`);
+}
+
+export function createTaskComment(
+  request: RequestFn,
+  taskId: number,
+  content: string
+) {
+  return mutateOperations(
+    request,
+    `/operations/tasks/${taskId}/comments`,
+    'POST',
+    { content }
+  );
+}
+
+export function updateTaskComment(
+  request: RequestFn,
+  taskId: number,
+  commentId: number,
+  content: string
+) {
+  return mutateOperations(
+    request,
+    `/operations/tasks/${taskId}/comments/${commentId}`,
+    'PATCH',
+    { content }
+  );
+}
+
+export function deleteTaskComment(
+  request: RequestFn,
+  taskId: number,
+  commentId: number
+) {
+  return mutateOperations(
+    request,
+    `/operations/tasks/${taskId}/comments/${commentId}`,
+    'DELETE'
+  );
+}
+
+// ─── Collaborator Payments ────────────────────────────────────────────────────
+
+export type CollaboratorPayment = {
+  id: number;
+  collaboratorId: number;
+  amount: string;
+  paymentDate: string;
+  referenceMonth: string | null;
+  paymentMethod: string;
+  notes: string | null;
+  createdAt: string;
+};
+
+export function fetchCollaboratorPayments(
+  request: RequestFn,
+  collaboratorId: number
+) {
+  return fetchOperations<CollaboratorPayment[]>(
+    request,
+    `/operations/collaborators/${collaboratorId}/payment-history`
+  );
+}
+
+export function createCollaboratorPayment(
+  request: RequestFn,
+  collaboratorId: number,
+  data: {
+    amount: number;
+    paymentDate: string;
+    referenceMonth?: string | null;
+    paymentMethod?: string;
+    notes?: string | null;
+  }
+) {
+  return mutateOperations<CollaboratorPayment>(
+    request,
+    `/operations/collaborators/${collaboratorId}/payment-history`,
+    'POST',
+    data
+  );
+}
+
+export function updateCollaboratorPayment(
+  request: RequestFn,
+  collaboratorId: number,
+  paymentId: number,
+  data: Partial<{
+    amount: number;
+    paymentDate: string;
+    referenceMonth: string | null;
+    paymentMethod: string;
+    notes: string | null;
+  }>
+) {
+  return mutateOperations<CollaboratorPayment>(
+    request,
+    `/operations/collaborators/${collaboratorId}/payment-history/${paymentId}`,
+    'PATCH',
+    data
+  );
+}
+
+export function deleteCollaboratorPayment(
+  request: RequestFn,
+  collaboratorId: number,
+  paymentId: number
+) {
+  return mutateOperations<{ success: boolean }>(
+    request,
+    `/operations/collaborators/${collaboratorId}/payment-history/${paymentId}`,
+    'DELETE'
+  );
+}
+
+// ─── Collaborator Invoices ────────────────────────────────────────────────────
+
+export type CollaboratorInvoice = {
+  id: number;
+  collaboratorId: number;
+  invoiceNumber: string | null;
+  amount: string;
+  issueDate: string;
+  dueDate: string | null;
+  status: string;
+  description: string | null;
+  createdAt: string;
+};
+
+export function fetchCollaboratorInvoices(
+  request: RequestFn,
+  collaboratorId: number
+) {
+  return fetchOperations<CollaboratorInvoice[]>(
+    request,
+    `/operations/collaborators/${collaboratorId}/invoices`
+  );
+}
+
+export function createCollaboratorInvoice(
+  request: RequestFn,
+  collaboratorId: number,
+  data: {
+    invoiceNumber?: string | null;
+    amount: number;
+    issueDate: string;
+    dueDate?: string | null;
+    status?: string;
+    description?: string | null;
+  }
+) {
+  return mutateOperations<CollaboratorInvoice>(
+    request,
+    `/operations/collaborators/${collaboratorId}/invoices`,
+    'POST',
+    data
+  );
+}
+
+export function updateCollaboratorInvoice(
+  request: RequestFn,
+  collaboratorId: number,
+  invoiceId: number,
+  data: Partial<{
+    invoiceNumber: string | null;
+    amount: number;
+    issueDate: string;
+    dueDate: string | null;
+    status: string;
+    description: string | null;
+  }>
+) {
+  return mutateOperations<CollaboratorInvoice>(
+    request,
+    `/operations/collaborators/${collaboratorId}/invoices/${invoiceId}`,
+    'PATCH',
+    data
+  );
+}
+
+export function deleteCollaboratorInvoice(
+  request: RequestFn,
+  collaboratorId: number,
+  invoiceId: number
+) {
+  return mutateOperations<{ success: boolean }>(
+    request,
+    `/operations/collaborators/${collaboratorId}/invoices/${invoiceId}`,
+    'DELETE'
+  );
+}