@t4dhg/mcp-factorial 1.1.0 → 3.0.0

package/dist/api.js

@@ -1,141 +1,1197 @@
-// FactorialHR API Client
-const FACTORIAL_BASE_URL = 'https://api.factorialhr.com/api/2025-10-01/resources';
-const DEFAULT_TIMEOUT = 30000; // 30 seconds
-const DEBUG = process.env.DEBUG === 'true';
-function debug(message, data) {
-    if (DEBUG) {
-        const timestamp = new Date().toISOString();
-        if (data) {
-            console.error(`[${timestamp}] [mcp-factorial] ${message}`, JSON.stringify(data, null, 2));
-        }
-        else {
-            console.error(`[${timestamp}] [mcp-factorial] ${message}`);
-        }
-    }
-}
-function getApiKey() {
-    const apiKey = process.env.FACTORIAL_API_KEY;
-    if (!apiKey) {
-        throw new Error('FACTORIAL_API_KEY is not set. ' +
-            'Please add it to your .env file or pass it via the MCP configuration. ' +
-            'See https://github.com/t4dhg/mcp-factorial for setup instructions.');
-    }
-    return apiKey;
-}
-async function factorialFetch(endpoint, params) {
-    const url = new URL(`${FACTORIAL_BASE_URL}${endpoint}`);
-    if (params) {
-        Object.entries(params).forEach(([key, value]) => {
-            if (value !== undefined) {
-                url.searchParams.append(key, String(value));
-            }
-        });
-    }
-    debug(`Fetching: ${url.toString()}`);
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), DEFAULT_TIMEOUT);
-    try {
-        const response = await fetch(url.toString(), {
-            method: 'GET',
-            headers: {
-                'x-api-key': getApiKey(),
-                'Accept': 'application/json',
-            },
-            signal: controller.signal,
-        });
-        clearTimeout(timeoutId);
-        if (!response.ok) {
-            const errorText = await response.text();
-            debug(`API error (${response.status}):`, errorText);
-            // Provide user-friendly error messages
-            if (response.status === 401) {
-                throw new Error('Invalid API key. Please check your FACTORIAL_API_KEY.');
-            }
-            if (response.status === 403) {
-                throw new Error('Access denied. Your API key may not have permission for this operation.');
-            }
-            if (response.status === 404) {
-                throw new Error('Resource not found. The requested employee, team, or location may not exist.');
-            }
-            if (response.status === 429) {
-                throw new Error('Rate limit exceeded. Please wait a moment before trying again.');
-            }
-            throw new Error(`FactorialHR API error (${response.status}): ${errorText}`);
+/**
+ * FactorialHR API Client
+ *
+ * Provides access to FactorialHR API endpoints with caching, pagination, and retry logic.
+ */
+import { fetchList, fetchOne, postOne, patchOne, deleteOne, postAction } from './http-client.js';
+import { cache, cached, CACHE_TTL, CacheManager } from './cache.js';
+import { buildPaginationParams, paginateResponse, sliceForPagination, } from './pagination.js';
+import { AuditAction, auditedOperation } from './audit.js';
+// ============================================================================
+// Employee endpoints
+// ============================================================================
+/**
+ * List all employees with optional filtering and pagination
+ */
+export async function listEmployees(options) {
+    const params = buildPaginationParams(options);
+    const cacheKey = CacheManager.key('employees', options);
+    // For filtered requests, we need to fetch all and filter client-side
+    // because the API doesn't reliably filter
+    if (options?.team_id || options?.location_id) {
+        const allEmployees = await cached('employees:all', () => fetchList('/employees/employees'), CACHE_TTL.employees);
+        let filtered = allEmployees;
+        if (options.team_id) {
+            filtered = filtered.filter(e => e.team_ids?.includes(options.team_id));
         }
-        const data = await response.json();
-        debug('Response received', { endpoint, itemCount: Array.isArray(data) ? data.length : 1 });
-        return data;
-    }
-    catch (error) {
-        clearTimeout(timeoutId);
-        if (error instanceof Error) {
-            if (error.name === 'AbortError') {
-                throw new Error(`Request timed out after ${DEFAULT_TIMEOUT / 1000} seconds. Please try again.`);
-            }
-            throw error;
+        if (options.location_id) {
+            filtered = filtered.filter(e => e.location_id === options.location_id);
         }
-        throw new Error('An unexpected error occurred while fetching data from FactorialHR.');
+        return sliceForPagination(filtered, params);
     }
+    // Without filters, use pagination directly
+    const employees = await cached(cacheKey, () => fetchList('/employees/employees', { params }), CACHE_TTL.employees);
+    return paginateResponse(employees, params.page, params.limit);
 }
-// Employee endpoints
-export async function listEmployees(options) {
-    const data = await factorialFetch('/employees/employees', options);
-    return data.data || [];
-}
+/**
+ * Get a specific employee by ID
+ */
 export async function getEmployee(id) {
     if (!id || id <= 0) {
         throw new Error('Invalid employee ID. Please provide a positive number.');
     }
-    const data = await factorialFetch(`/employees/employees/${id}`);
-    return data.data;
+    return cached(`employee:${id}`, () => fetchOne(`/employees/employees/${id}`), CACHE_TTL.employees);
 }
+/**
+ * Search employees by name or email
+ */
 export async function searchEmployees(query) {
     if (!query || query.trim().length < 2) {
         throw new Error('Search query must be at least 2 characters long.');
     }
-    const employees = await listEmployees();
+    const allEmployees = await cached('employees:all', () => fetchList('/employees/employees'), CACHE_TTL.employees);
     const lowerQuery = query.toLowerCase().trim();
-    return employees.filter(emp => emp.full_name?.toLowerCase().includes(lowerQuery) ||
+    return allEmployees.filter(emp => emp.full_name?.toLowerCase().includes(lowerQuery) ||
         emp.email?.toLowerCase().includes(lowerQuery) ||
         emp.first_name?.toLowerCase().includes(lowerQuery) ||
         emp.last_name?.toLowerCase().includes(lowerQuery));
 }
+// ============================================================================
 // Team endpoints
-export async function listTeams() {
-    const data = await factorialFetch('/teams/teams');
-    return data.data || [];
+// ============================================================================
+/**
+ * List all teams
+ */
+export async function listTeams(options) {
+    const params = buildPaginationParams(options);
+    const cacheKey = CacheManager.key('teams', options);
+    const teams = await cached(cacheKey, () => fetchList('/teams/teams'), CACHE_TTL.teams);
+    return sliceForPagination(teams, params);
 }
+/**
+ * Get a specific team by ID
+ */
 export async function getTeam(id) {
     if (!id || id <= 0) {
         throw new Error('Invalid team ID. Please provide a positive number.');
     }
-    const data = await factorialFetch(`/teams/teams/${id}`);
-    return data.data;
+    return cached(`team:${id}`, () => fetchOne(`/teams/teams/${id}`), CACHE_TTL.teams);
 }
+// ============================================================================
 // Location endpoints
-export async function listLocations() {
-    const data = await factorialFetch('/locations/locations');
-    return data.data || [];
+// ============================================================================
+/**
+ * List all locations
+ */
+export async function listLocations(options) {
+    const params = buildPaginationParams(options);
+    const cacheKey = CacheManager.key('locations', options);
+    const locations = await cached(cacheKey, () => fetchList('/locations/locations'), CACHE_TTL.locations);
+    return sliceForPagination(locations, params);
 }
+/**
+ * Get a specific location by ID
+ */
 export async function getLocation(id) {
     if (!id || id <= 0) {
         throw new Error('Invalid location ID. Please provide a positive number.');
     }
-    const data = await factorialFetch(`/locations/locations/${id}`);
-    return data.data;
+    return cached(`location:${id}`, () => fetchOne(`/locations/locations/${id}`), CACHE_TTL.locations);
 }
+// ============================================================================
 // Contract endpoints
-export async function listContracts(employeeId) {
+// ============================================================================
+/**
+ * List contracts, optionally filtered by employee ID
+ */
+export async function listContracts(employeeId, options) {
     if (employeeId !== undefined && employeeId <= 0) {
         throw new Error('Invalid employee ID. Please provide a positive number.');
     }
+    const params = buildPaginationParams(options);
     // Note: The API doesn't reliably filter by employee_id query param,
     // so we fetch all contracts and filter client-side
-    const data = await factorialFetch('/contracts/contract-versions');
-    const contracts = data.data || [];
-    if (employeeId !== undefined) {
-        return contracts.filter(c => c.employee_id === employeeId);
+    const allContracts = await cached('contracts:all', () => fetchList('/contracts/contract-versions'), CACHE_TTL.contracts);
+    const filtered = employeeId !== undefined
+        ? allContracts.filter(c => c.employee_id === employeeId)
+        : allContracts;
+    return sliceForPagination(filtered, params);
+}
+// ============================================================================
+// Time Off / Leave endpoints
+// ============================================================================
+/**
+ * List leaves with optional filtering
+ */
+export async function listLeaves(options) {
+    const params = buildPaginationParams(options);
+    const queryParams = {
+        page: params.page,
+        limit: params.limit,
+    };
+    if (options?.employee_id)
+        queryParams.employee_id = options.employee_id;
+    if (options?.status)
+        queryParams.status = options.status;
+    if (options?.start_on_gte)
+        queryParams.start_on_gte = options.start_on_gte;
+    if (options?.start_on_lte)
+        queryParams.start_on_lte = options.start_on_lte;
+    const leaves = await fetchList('/timeoff/leaves', { params: queryParams });
+    return paginateResponse(leaves, params.page, params.limit);
+}
+/**
+ * Get a specific leave by ID
+ */
+export async function getLeave(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid leave ID. Please provide a positive number.');
+    }
+    return fetchOne(`/timeoff/leaves/${id}`);
+}
+/**
+ * List all leave types
+ */
+export async function listLeaveTypes() {
+    return cached('leave-types:all', () => fetchList('/timeoff/leave-types'), CACHE_TTL.leaves);
+}
+/**
+ * Get a specific leave type by ID
+ */
+export async function getLeaveType(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid leave type ID. Please provide a positive number.');
+    }
+    return fetchOne(`/timeoff/leave-types/${id}`);
+}
+/**
+ * List allowances with optional filtering by employee
+ */
+export async function listAllowances(options) {
+    const params = buildPaginationParams(options);
+    const queryParams = {
+        page: params.page,
+        limit: params.limit,
+    };
+    if (options?.employee_id)
+        queryParams.employee_id = options.employee_id;
+    const allowances = await fetchList('/timeoff/allowances', { params: queryParams });
+    return paginateResponse(allowances, params.page, params.limit);
+}
+// ============================================================================
+// Attendance / Shifts endpoints
+// ============================================================================
+/**
+ * List shifts with optional filtering
+ */
+export async function listShifts(options) {
+    const params = buildPaginationParams(options);
+    const queryParams = {
+        page: params.page,
+        limit: params.limit,
+    };
+    if (options?.employee_id)
+        queryParams.employee_id = options.employee_id;
+    if (options?.clock_in_gte)
+        queryParams.clock_in_gte = options.clock_in_gte;
+    if (options?.clock_in_lte)
+        queryParams.clock_in_lte = options.clock_in_lte;
+    const shifts = await fetchList('/attendance/shifts', { params: queryParams });
+    return paginateResponse(shifts, params.page, params.limit);
+}
+/**
+ * Get a specific shift by ID
+ */
+export async function getShift(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid shift ID. Please provide a positive number.');
+    }
+    return fetchOne(`/attendance/shifts/${id}`);
+}
+// ============================================================================
+// Document endpoints (Read-only)
+// ============================================================================
+/**
+ * List all folders
+ */
+export async function listFolders() {
+    return cached('folders:all', () => fetchList('/documents/folders'), CACHE_TTL.default);
+}
+/**
+ * Get a specific folder by ID
+ */
+export async function getFolder(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid folder ID. Please provide a positive number.');
+    }
+    return fetchOne(`/documents/folders/${id}`);
+}
+/**
+ * List documents with optional filtering by folder
+ */
+export async function listDocuments(options) {
+    const params = buildPaginationParams(options);
+    const queryParams = {
+        page: params.page,
+        limit: params.limit,
+    };
+    if (options?.folder_id)
+        queryParams.folder_id = options.folder_id;
+    const documents = await fetchList('/documents/documents', { params: queryParams });
+    return paginateResponse(documents, params.page, params.limit);
+}
+/**
+ * Get a specific document by ID
+ */
+export async function getDocument(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid document ID. Please provide a positive number.');
+    }
+    return fetchOne(`/documents/documents/${id}`);
+}
+// ============================================================================
+// Job Catalog endpoints
+// ============================================================================
+/**
+ * List all job roles
+ */
+export async function listJobRoles() {
+    return cached('job-roles:all', () => fetchList('/job_catalog/roles'), CACHE_TTL.default);
+}
+/**
+ * Get a specific job role by ID
+ */
+export async function getJobRole(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid job role ID. Please provide a positive number.');
+    }
+    return fetchOne(`/job_catalog/roles/${id}`);
+}
+/**
+ * List all job levels
+ */
+export async function listJobLevels() {
+    return cached('job-levels:all', () => fetchList('/job_catalog/levels'), CACHE_TTL.default);
+}
+/**
+ * Get a specific job level by ID
+ */
+export async function getJobLevel(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid job level ID. Please provide a positive number.');
+    }
+    return fetchOne(`/job_catalog/levels/${id}`);
+}
+// ============================================================================
+// Cache utilities
+// ============================================================================
+/**
+ * Invalidate all cached data
+ */
+export function clearCache() {
+    cache.clear();
+}
+/**
+ * Invalidate cached data for a specific resource type
+ */
+export function invalidateCache(resourceType) {
+    cache.invalidatePrefix(resourceType);
+}
+// ============================================================================
+// WRITE OPERATIONS - Employee endpoints
+// ============================================================================
+/**
+ * Create a new employee
+ */
+export async function createEmployee(input) {
+    return auditedOperation(AuditAction.CREATE, 'employee', undefined, async () => {
+        const employee = await postOne('/employees/employees', input);
+        cache.invalidatePrefix('employees');
+        return employee;
+    }, Object.fromEntries(Object.entries(input).map(([k, v]) => [k, { to: v }])));
+}
+/**
+ * Update an existing employee
+ */
+export async function updateEmployee(id, input) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid employee ID. Please provide a positive number.');
+    }
+    return auditedOperation(AuditAction.UPDATE, 'employee', id, async () => {
+        const employee = await patchOne(`/employees/employees/${id}`, input);
+        cache.invalidate(`employee:${id}`);
+        cache.invalidatePrefix('employees');
+        return employee;
+    });
+}
+/**
+ * Terminate an employee (soft delete)
+ */
+export async function terminateEmployee(id, terminatedOn, reason) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid employee ID. Please provide a positive number.');
+    }
+    return auditedOperation(AuditAction.TERMINATE, 'employee', id, async () => {
+        const employee = await patchOne(`/employees/employees/${id}`, {
+            terminated_on: terminatedOn,
+        });
+        cache.invalidate(`employee:${id}`);
+        cache.invalidatePrefix('employees');
+        return employee;
+    }, { terminated_on: { to: terminatedOn }, reason: { to: reason } });
+}
+// ============================================================================
+// WRITE OPERATIONS - Team endpoints
+// ============================================================================
+/**
+ * Create a new team
+ */
+export async function createTeam(input) {
+    return auditedOperation(AuditAction.CREATE, 'team', undefined, async () => {
+        const team = await postOne('/teams/teams', input);
+        cache.invalidatePrefix('teams');
+        return team;
+    });
+}
+/**
+ * Update an existing team
+ */
+export async function updateTeam(id, input) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid team ID. Please provide a positive number.');
+    }
+    return auditedOperation(AuditAction.UPDATE, 'team', id, async () => {
+        const team = await patchOne(`/teams/teams/${id}`, input);
+        cache.invalidate(`team:${id}`);
+        cache.invalidatePrefix('teams');
+        return team;
+    });
+}
+/**
+ * Delete a team
+ */
+export async function deleteTeam(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid team ID. Please provide a positive number.');
+    }
+    return auditedOperation(AuditAction.DELETE, 'team', id, async () => {
+        await deleteOne(`/teams/teams/${id}`);
+        cache.invalidate(`team:${id}`);
+        cache.invalidatePrefix('teams');
+    });
+}
+// ============================================================================
+// WRITE OPERATIONS - Location endpoints
+// ============================================================================
+/**
+ * Create a new location
+ */
+export async function createLocation(input) {
+    return auditedOperation(AuditAction.CREATE, 'location', undefined, async () => {
+        const location = await postOne('/locations/locations', input);
+        cache.invalidatePrefix('locations');
+        return location;
+    });
+}
+/**
+ * Update an existing location
+ */
+export async function updateLocation(id, input) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid location ID. Please provide a positive number.');
+    }
+    return auditedOperation(AuditAction.UPDATE, 'location', id, async () => {
+        const location = await patchOne(`/locations/locations/${id}`, input);
+        cache.invalidate(`location:${id}`);
+        cache.invalidatePrefix('locations');
+        return location;
+    });
+}
+/**
+ * Delete a location
+ */
+export async function deleteLocation(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid location ID. Please provide a positive number.');
+    }
+    return auditedOperation(AuditAction.DELETE, 'location', id, async () => {
+        await deleteOne(`/locations/locations/${id}`);
+        cache.invalidate(`location:${id}`);
+        cache.invalidatePrefix('locations');
+    });
+}
+// ============================================================================
+// WRITE OPERATIONS - Leave endpoints
+// ============================================================================
+/**
+ * Create a new leave request
+ */
+export async function createLeave(input) {
+    return auditedOperation(AuditAction.CREATE, 'leave', undefined, async () => {
+        const leave = await postOne('/timeoff/leaves', input);
+        return leave;
+    });
+}
+/**
+ * Update a leave request
+ */
+export async function updateLeave(id, input) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid leave ID. Please provide a positive number.');
+    }
+    return auditedOperation(AuditAction.UPDATE, 'leave', id, async () => {
+        const leave = await patchOne(`/timeoff/leaves/${id}`, input);
+        return leave;
+    });
+}
+/**
+ * Cancel a leave request
+ */
+export async function cancelLeave(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid leave ID. Please provide a positive number.');
+    }
+    return auditedOperation(AuditAction.DELETE, 'leave', id, async () => {
+        await deleteOne(`/timeoff/leaves/${id}`);
+    });
+}
+/**
+ * Approve a leave request
+ */
+export async function approveLeave(id, input) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid leave ID. Please provide a positive number.');
+    }
+    return auditedOperation(AuditAction.APPROVE, 'leave', id, async () => {
+        const leave = await postAction(`/timeoff/leaves/${id}/approve`, input || {});
+        return leave;
+    });
+}
+/**
+ * Reject a leave request
+ */
+export async function rejectLeave(id, input) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid leave ID. Please provide a positive number.');
+    }
+    return auditedOperation(AuditAction.REJECT, 'leave', id, async () => {
+        const leave = await postAction(`/timeoff/leaves/${id}/reject`, input || {});
+        return leave;
+    });
+}
+// ============================================================================
+// WRITE OPERATIONS - Shift endpoints
+// ============================================================================
+/**
+ * Create a new shift
+ */
+export async function createShift(input) {
+    return auditedOperation(AuditAction.CREATE, 'shift', undefined, async () => {
+        const shift = await postOne('/attendance/shifts', input);
+        return shift;
+    });
+}
+/**
+ * Update a shift
+ */
+export async function updateShift(id, input) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid shift ID. Please provide a positive number.');
+    }
+    return auditedOperation(AuditAction.UPDATE, 'shift', id, async () => {
+        const shift = await patchOne(`/attendance/shifts/${id}`, input);
+        return shift;
+    });
+}
+/**
+ * Delete a shift
+ */
+export async function deleteShift(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid shift ID. Please provide a positive number.');
+    }
+    return auditedOperation(AuditAction.DELETE, 'shift', id, async () => {
+        await deleteOne(`/attendance/shifts/${id}`);
+    });
+}
+// ============================================================================
+// Projects & Time Tracking - READ endpoints
+// ============================================================================
+/**
+ * List all projects
+ */
+export async function listProjects(options) {
+    const params = buildPaginationParams(options);
+    const projects = await cached(CacheManager.key('projects', options), () => fetchList('/project_management/projects'), CACHE_TTL.default);
+    return sliceForPagination(projects, params);
+}
+/**
+ * Get a specific project by ID
+ */
+export async function getProject(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid project ID. Please provide a positive number.');
+    }
+    return cached(`project:${id}`, () => fetchOne(`/project_management/projects/${id}`), CACHE_TTL.default);
+}
+/**
+ * List project tasks
+ */
+export async function listProjectTasks(projectId, options) {
+    const params = buildPaginationParams(options);
+    const queryParams = {};
+    if (projectId)
+        queryParams.project_ids = projectId;
+    const tasks = await fetchList('/project_management/project_tasks', {
+        params: queryParams,
+    });
+    return sliceForPagination(tasks, params);
+}
+/**
+ * Get a specific project task by ID
+ */
+export async function getProjectTask(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid task ID. Please provide a positive number.');
+    }
+    return fetchOne(`/project_management/project_tasks/${id}`);
+}
+/**
+ * List project workers
+ */
+export async function listProjectWorkers(projectId, options) {
+    const params = buildPaginationParams(options);
+    const queryParams = {};
+    if (projectId)
+        queryParams.project_ids = projectId;
+    const workers = await fetchList('/project_management/project_workers', {
+        params: queryParams,
+    });
+    return sliceForPagination(workers, params);
+}
+/**
+ * Get a specific project worker by ID
+ */
+export async function getProjectWorker(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid project worker ID. Please provide a positive number.');
+    }
+    return fetchOne(`/project_management/project_workers/${id}`);
+}
+/**
+ * List time records
+ */
+export async function listTimeRecords(projectWorkerId, options) {
+    const params = buildPaginationParams(options);
+    const queryParams = {};
+    if (projectWorkerId)
+        queryParams.project_workers_ids = projectWorkerId;
+    const records = await fetchList('/project_management/time_records', {
+        params: queryParams,
+    });
+    return sliceForPagination(records, params);
+}
+/**
+ * Get a specific time record by ID
+ */
+export async function getTimeRecord(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid time record ID. Please provide a positive number.');
+    }
+    return fetchOne(`/project_management/time_records/${id}`);
+}
+// ============================================================================
+// Projects & Time Tracking - WRITE endpoints
+// ============================================================================
+/**
+ * Create a new project
+ */
+export async function createProject(input) {
+    return auditedOperation(AuditAction.CREATE, 'project', undefined, async () => {
+        const project = await postOne('/project_management/projects', input);
+        cache.invalidatePrefix('projects');
+        return project;
+    });
+}
+/**
+ * Update a project
+ */
+export async function updateProject(id, input) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid project ID. Please provide a positive number.');
+    }
+    return auditedOperation(AuditAction.UPDATE, 'project', id, async () => {
+        const project = await patchOne(`/project_management/projects/${id}`, input);
+        cache.invalidate(`project:${id}`);
+        cache.invalidatePrefix('projects');
+        return project;
+    });
+}
+/**
+ * Delete a project
+ */
+export async function deleteProject(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid project ID. Please provide a positive number.');
+    }
+    return auditedOperation(AuditAction.DELETE, 'project', id, async () => {
+        await deleteOne(`/project_management/projects/${id}`);
+        cache.invalidate(`project:${id}`);
+        cache.invalidatePrefix('projects');
+    });
+}
+/**
+ * Create a project task
+ */
+export async function createProjectTask(input) {
+    return auditedOperation(AuditAction.CREATE, 'project_task', undefined, async () => {
+        return postOne('/project_management/project_tasks', input);
+    });
+}
+/**
+ * Update a project task
+ */
+export async function updateProjectTask(id, input) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid task ID. Please provide a positive number.');
+    }
+    return auditedOperation(AuditAction.UPDATE, 'project_task', id, async () => {
+        return patchOne(`/project_management/project_tasks/${id}`, input);
+    });
+}
+/**
+ * Delete a project task
+ */
+export async function deleteProjectTask(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid task ID. Please provide a positive number.');
+    }
+    return auditedOperation(AuditAction.DELETE, 'project_task', id, async () => {
+        await deleteOne(`/project_management/project_tasks/${id}`);
+    });
+}
+/**
+ * Assign a worker to a project
+ */
+export async function assignProjectWorker(input) {
+    return auditedOperation(AuditAction.ASSIGN, 'project_worker', undefined, async () => {
+        return postOne('/project_management/project_workers', input);
+    });
+}
+/**
+ * Remove a worker from a project
+ */
+export async function removeProjectWorker(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid project worker ID. Please provide a positive number.');
+    }
+    return auditedOperation(AuditAction.UNASSIGN, 'project_worker', id, async () => {
+        await deleteOne(`/project_management/project_workers/${id}`);
+    });
+}
+/**
+ * Create a time record
+ */
+export async function createTimeRecord(input) {
+    return auditedOperation(AuditAction.CREATE, 'time_record', undefined, async () => {
+        return postOne('/project_management/time_records', input);
+    });
+}
+/**
+ * Update a time record
+ */
+export async function updateTimeRecord(id, input) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid time record ID. Please provide a positive number.');
+    }
+    return auditedOperation(AuditAction.UPDATE, 'time_record', id, async () => {
+        return patchOne(`/project_management/time_records/${id}`, input);
+    });
+}
+/**
+ * Delete a time record
+ */
+export async function deleteTimeRecord(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid time record ID. Please provide a positive number.');
+    }
+    return auditedOperation(AuditAction.DELETE, 'time_record', id, async () => {
+        await deleteOne(`/project_management/time_records/${id}`);
+    });
+}
+// ============================================================================
+// Training & Development - READ endpoints
+// ============================================================================
+/**
+ * List all trainings
+ */
+export async function listTrainings(options) {
+    const params = buildPaginationParams(options);
+    const trainings = await cached(CacheManager.key('trainings', options), () => fetchList('/trainings/trainings'), CACHE_TTL.default);
+    return sliceForPagination(trainings, params);
+}
+/**
+ * Get a specific training by ID
+ */
+export async function getTraining(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid training ID. Please provide a positive number.');
+    }
+    return cached(`training:${id}`, () => fetchOne(`/trainings/trainings/${id}`), CACHE_TTL.default);
+}
+/**
+ * List training sessions
+ */
+export async function listTrainingSessions(trainingId, options) {
+    const params = buildPaginationParams(options);
+    const queryParams = {};
+    if (trainingId)
+        queryParams.training_id = trainingId;
+    const sessions = await fetchList('/trainings/sessions', { params: queryParams });
+    return sliceForPagination(sessions, params);
+}
+/**
+ * Get a specific training session by ID
+ */
+export async function getTrainingSession(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid session ID. Please provide a positive number.');
+    }
+    return fetchOne(`/trainings/sessions/${id}`);
+}
+/**
+ * List training enrollments
+ */
+export async function listTrainingEnrollments(trainingId, options) {
+    const params = buildPaginationParams(options);
+    const queryParams = {};
+    if (trainingId)
+        queryParams.training_id = trainingId;
+    const enrollments = await fetchList('/trainings/memberships', {
+        params: queryParams,
+    });
+    return sliceForPagination(enrollments, params);
+}
+/**
+ * Get a specific training enrollment by ID
+ */
+export async function getTrainingEnrollment(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid enrollment ID. Please provide a positive number.');
+    }
+    return fetchOne(`/trainings/memberships/${id}`);
+}
+// ============================================================================
+// Training & Development - WRITE endpoints
+// ============================================================================
+/**
+ * Create a training program
+ */
+export async function createTraining(input) {
+    return auditedOperation(AuditAction.CREATE, 'training', undefined, async () => {
+        const training = await postOne('/trainings/trainings', input);
+        cache.invalidatePrefix('trainings');
+        return training;
+    });
+}
+/**
+ * Update a training program
+ */
+export async function updateTraining(id, input) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid training ID. Please provide a positive number.');
+    }
+    return auditedOperation(AuditAction.UPDATE, 'training', id, async () => {
+        const training = await patchOne(`/trainings/trainings/${id}`, input);
+        cache.invalidate(`training:${id}`);
+        cache.invalidatePrefix('trainings');
+        return training;
+    });
+}
+/**
+ * Delete a training program
+ */
+export async function deleteTraining(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid training ID. Please provide a positive number.');
+    }
+    return auditedOperation(AuditAction.DELETE, 'training', id, async () => {
+        await deleteOne(`/trainings/trainings/${id}`);
+        cache.invalidate(`training:${id}`);
+        cache.invalidatePrefix('trainings');
+    });
+}
+/**
+ * Create a training session
+ */
+export async function createTrainingSession(input) {
+    return auditedOperation(AuditAction.CREATE, 'training_session', undefined, async () => {
+        return postOne('/trainings/sessions', input);
+    });
+}
+/**
+ * Update a training session
+ */
+export async function updateTrainingSession(id, input) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid session ID. Please provide a positive number.');
+    }
+    return auditedOperation(AuditAction.UPDATE, 'training_session', id, async () => {
+        return patchOne(`/trainings/sessions/${id}`, input);
+    });
+}
+/**
+ * Delete a training session
+ */
+export async function deleteTrainingSession(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid session ID. Please provide a positive number.');
+    }
+    return auditedOperation(AuditAction.DELETE, 'training_session', id, async () => {
+        await deleteOne(`/trainings/sessions/${id}`);
+    });
+}
+/**
+ * Enroll an employee in a training
+ */
+export async function enrollInTraining(input) {
+    return auditedOperation(AuditAction.ASSIGN, 'training_enrollment', undefined, async () => {
+        return postOne('/trainings/memberships', input);
+    });
+}
+/**
+ * Remove enrollment from a training
+ */
+export async function unenrollFromTraining(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid enrollment ID. Please provide a positive number.');
+    }
+    return auditedOperation(AuditAction.UNASSIGN, 'training_enrollment', id, async () => {
+        await deleteOne(`/trainings/memberships/${id}`);
+    });
+}
+// ============================================================================
+// Work Areas - READ/WRITE endpoints
+// ============================================================================
+/**
+ * List all work areas
+ */
+export async function listWorkAreas(options) {
+    const params = buildPaginationParams(options);
+    const workAreas = await cached(CacheManager.key('work_areas', options), () => fetchList('/locations/work_areas'), CACHE_TTL.locations);
+    return sliceForPagination(workAreas, params);
+}
+/**
+ * Get a specific work area by ID
+ */
+export async function getWorkArea(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid work area ID. Please provide a positive number.');
+    }
+    return cached(`work_area:${id}`, () => fetchOne(`/locations/work_areas/${id}`), CACHE_TTL.locations);
+}
+/**
+ * Create a work area
+ */
+export async function createWorkArea(input) {
+    return auditedOperation(AuditAction.CREATE, 'work_area', undefined, async () => {
+        const workArea = await postOne('/locations/work_areas', input);
+        cache.invalidatePrefix('work_areas');
+        return workArea;
+    });
+}
+/**
+ * Update a work area
+ */
+export async function updateWorkArea(id, input) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid work area ID. Please provide a positive number.');
+    }
+    return auditedOperation(AuditAction.UPDATE, 'work_area', id, async () => {
+        const workArea = await patchOne(`/locations/work_areas/${id}`, input);
+        cache.invalidate(`work_area:${id}`);
+        cache.invalidatePrefix('work_areas');
+        return workArea;
+    });
+}
+/**
+ * Archive a work area
+ */
+export async function archiveWorkArea(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid work area ID. Please provide a positive number.');
+    }
+    return auditedOperation(AuditAction.ARCHIVE, 'work_area', id, async () => {
+        const workArea = await postAction(`/locations/work_areas/${id}/archive`);
+        cache.invalidate(`work_area:${id}`);
+        cache.invalidatePrefix('work_areas');
+        return workArea;
+    });
+}
+/**
+ * Unarchive a work area
+ */
+export async function unarchiveWorkArea(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid work area ID. Please provide a positive number.');
+    }
+    return auditedOperation(AuditAction.UNARCHIVE, 'work_area', id, async () => {
+        const workArea = await postAction(`/locations/work_areas/${id}/unarchive`);
+        cache.invalidate(`work_area:${id}`);
+        cache.invalidatePrefix('work_areas');
+        return workArea;
+    });
+}
+// ============================================================================
+// ATS (Recruiting) - READ endpoints
+// ============================================================================
+/**
+ * List all job postings
+ */
+export async function listJobPostings(options) {
+    const params = buildPaginationParams(options);
+    const postings = await cached(CacheManager.key('job_postings', options), () => fetchList('/ats/job_postings'), CACHE_TTL.default);
+    return sliceForPagination(postings, params);
+}
+/**
+ * Get a specific job posting by ID
+ */
+export async function getJobPosting(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid job posting ID. Please provide a positive number.');
+    }
+    return cached(`job_posting:${id}`, () => fetchOne(`/ats/job_postings/${id}`), CACHE_TTL.default);
+}
+/**
+ * List all candidates
+ */
+export async function listCandidates(options) {
+    const params = buildPaginationParams(options);
+    const candidates = await fetchList('/ats/candidates');
+    return sliceForPagination(candidates, params);
+}
+/**
+ * Get a specific candidate by ID
+ */
+export async function getCandidate(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid candidate ID. Please provide a positive number.');
+    }
+    return fetchOne(`/ats/candidates/${id}`);
+}
+/**
+ * List all applications
+ */
+export async function listApplications(jobPostingId, options) {
+    const params = buildPaginationParams(options);
+    const queryParams = {};
+    if (jobPostingId)
+        queryParams.job_posting_id = jobPostingId;
+    const applications = await fetchList('/ats/applications', { params: queryParams });
+    return sliceForPagination(applications, params);
+}
+/**
+ * Get a specific application by ID
+ */
+export async function getApplication(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid application ID. Please provide a positive number.');
+    }
+    return fetchOne(`/ats/applications/${id}`);
+}
+/**
+ * List all hiring stages
+ */
+export async function listHiringStages() {
+    return cached('hiring_stages:all', () => fetchList('/ats/hiring_stages'), CACHE_TTL.default);
+}
+/**
+ * Get a specific hiring stage by ID
+ */
+export async function getHiringStage(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid hiring stage ID. Please provide a positive number.');
+    }
+    return fetchOne(`/ats/hiring_stages/${id}`);
+}
+// ============================================================================
+// ATS (Recruiting) - WRITE endpoints
+// ============================================================================
+/**
+ * Create a job posting
+ */
+export async function createJobPosting(input) {
+    return auditedOperation(AuditAction.CREATE, 'job_posting', undefined, async () => {
+        const posting = await postOne('/ats/job_postings', input);
+        cache.invalidatePrefix('job_postings');
+        return posting;
+    });
+}
+/**
+ * Update a job posting
+ */
+export async function updateJobPosting(id, input) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid job posting ID. Please provide a positive number.');
+    }
+    return auditedOperation(AuditAction.UPDATE, 'job_posting', id, async () => {
+        const posting = await patchOne(`/ats/job_postings/${id}`, input);
+        cache.invalidate(`job_posting:${id}`);
+        cache.invalidatePrefix('job_postings');
+        return posting;
+    });
+}
+/**
+ * Delete a job posting
+ */
+export async function deleteJobPosting(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid job posting ID. Please provide a positive number.');
+    }
+    return auditedOperation(AuditAction.DELETE, 'job_posting', id, async () => {
+        await deleteOne(`/ats/job_postings/${id}`);
+        cache.invalidate(`job_posting:${id}`);
+        cache.invalidatePrefix('job_postings');
+    });
+}
+/**
+ * Create a candidate
+ */
+export async function createCandidate(input) {
+    return auditedOperation(AuditAction.CREATE, 'candidate', undefined, async () => {
+        return postOne('/ats/candidates', input);
+    });
+}
+/**
+ * Update a candidate
+ */
+export async function updateCandidate(id, input) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid candidate ID. Please provide a positive number.');
+    }
+    return auditedOperation(AuditAction.UPDATE, 'candidate', id, async () => {
+        return patchOne(`/ats/candidates/${id}`, input);
+    });
+}
+/**
+ * Delete a candidate
+ */
+export async function deleteCandidate(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid candidate ID. Please provide a positive number.');
+    }
+    return auditedOperation(AuditAction.DELETE, 'candidate', id, async () => {
+        await deleteOne(`/ats/candidates/${id}`);
+    });
+}
+/**
+ * Create an application
+ */
+export async function createApplication(input) {
+    return auditedOperation(AuditAction.CREATE, 'application', undefined, async () => {
+        return postOne('/ats/applications', input);
+    });
+}
+/**
+ * Update an application
+ */
+export async function updateApplication(id, input) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid application ID. Please provide a positive number.');
+    }
+    return auditedOperation(AuditAction.UPDATE, 'application', id, async () => {
+        return patchOne(`/ats/applications/${id}`, input);
+    });
+}
+/**
+ * Delete an application
+ */
+export async function deleteApplication(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid application ID. Please provide a positive number.');
+    }
+    return auditedOperation(AuditAction.DELETE, 'application', id, async () => {
+        await deleteOne(`/ats/applications/${id}`);
+    });
+}
+/**
+ * Advance an application to the next stage
+ */
+export async function advanceApplication(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid application ID. Please provide a positive number.');
+    }
+    return auditedOperation(AuditAction.UPDATE, 'application', id, async () => {
+        return postAction(`/ats/applications/${id}/apply`);
+    });
+}
+// ============================================================================
+// Payroll - READ-ONLY endpoints (sensitive data)
+// ============================================================================
+/**
+ * List payroll supplements for an employee
+ */
+export async function listPayrollSupplements(employeeId, options) {
+    const params = buildPaginationParams(options);
+    const queryParams = {};
+    if (employeeId)
+        queryParams.employee_id = employeeId;
+    const supplements = await fetchList('/payroll/supplements', {
+        params: queryParams,
+    });
+    return sliceForPagination(supplements, params);
+}
+/**
+ * Get a specific payroll supplement by ID
+ */
+export async function getPayrollSupplement(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid supplement ID. Please provide a positive number.');
+    }
+    return fetchOne(`/payroll/supplements/${id}`);
+}
+/**
+ * List tax identifiers
+ */
+export async function listTaxIdentifiers(employeeId, options) {
+    const params = buildPaginationParams(options);
+    const queryParams = {};
+    if (employeeId)
+        queryParams.employee_id = employeeId;
+    const identifiers = await fetchList('/payroll_employees/identifiers', {
+        params: queryParams,
+    });
+    return sliceForPagination(identifiers, params);
+}
+/**
+ * Get a specific tax identifier by ID
+ */
+export async function getTaxIdentifier(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid tax identifier ID. Please provide a positive number.');
+    }
+    return fetchOne(`/payroll_employees/identifiers/${id}`);
+}
+/**
+ * List family situations
+ */
+export async function listFamilySituations(employeeId, options) {
+    const params = buildPaginationParams(options);
+    const queryParams = {};
+    if (employeeId)
+        queryParams.employee_id = employeeId;
+    const situations = await fetchList('/payroll/family_situations', {
+        params: queryParams,
+    });
+    return sliceForPagination(situations, params);
+}
+/**
+ * Get a specific family situation by ID
+ */
+export async function getFamilySituation(id) {
+    if (!id || id <= 0) {
+        throw new Error('Invalid family situation ID. Please provide a positive number.');
     }
-    return contracts;
+    return fetchOne(`/payroll/family_situations/${id}`);
 }
 //# sourceMappingURL=api.js.map