@t4dhg/mcp-factorial 7.1.0 → 9.0.0

package/dist/api/documents.js

@@ -0,0 +1,269 @@
+/**
+ * Document API endpoints: Folders, Documents, Downloads
+ */
+import { fetchList, fetchOne } from '../http-client.js';
+import { cached, CACHE_TTL } from '../cache.js';
+import { debug } from '../config.js';
+import { isOAuth2Configured, getOAuth2AccessToken } from '../oauth.js';
+import { buildPaginationParams, paginateResponse } from '../pagination.js';
+import { validateId, resolveSafeOutputPath, writeWithoutOverwriting } from '../utils.js';
+import { ENDPOINTS, endpointWithId } from '../endpoints.js';
+import { NotFoundError } from '../errors.js';
+/**
+ * List all folders
+ */
+export async function listFolders() {
+    return cached('folders:all', () => fetchList(ENDPOINTS.folders), CACHE_TTL.default);
+}
+/**
+ * Get a specific folder by ID
+ */
+export async function getFolder(id) {
+    validateId(id, 'folder');
+    return fetchOne(endpointWithId(ENDPOINTS.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;
+    // Handle employee_ids array parameter
+    // Factorial API expects: employee_ids[]=123&employee_ids[]=456
+    if (options?.employee_ids && options.employee_ids.length > 0) {
+        // We'll need to build the query string manually for array parameters
+        const employeeIdsParam = options.employee_ids.map(id => `employee_ids[]=${id}`).join('&');
+        const baseParams = new URLSearchParams(queryParams).toString();
+        const fullParams = baseParams ? `${baseParams}&${employeeIdsParam}` : employeeIdsParam;
+        // Make request with custom query string
+        const documents = await fetchList(`${ENDPOINTS.documents}?${fullParams}`);
+        debug(`listDocuments returned ${documents.length} documents`, {
+            sampleDocument: documents[0],
+            missingNames: documents.filter(d => !d.filename).length,
+        });
+        return paginateResponse(documents, params.page, params.limit);
+    }
+    const documents = await fetchList(ENDPOINTS.documents, { params: queryParams });
+    debug(`listDocuments returned ${documents.length} documents`, {
+        sampleDocument: documents[0],
+        missingNames: documents.filter(d => !d.filename).length,
+    });
+    return paginateResponse(documents, params.page, params.limit);
+}
+/**
+ * Get a specific document by ID
+ *
+ * Note: The Factorial API's individual document endpoint (/documents/documents/{id})
+ * can be unreliable, similar to the employee endpoint. This function implements a fallback
+ * to listing all documents and filtering if the direct endpoint fails or returns no data.
+ *
+ * IMPORTANT: Due to Factorial API limitations, this function may not find employee-specific
+ * documents that were returned by listDocuments({ employee_ids: [...] }). This is because
+ * the fallback query cannot access all employee documents. For download operations,
+ * prefer using the document object directly (from listDocuments) rather than re-fetching by ID.
+ *
+ * @param id - The document ID
+ * @returns The document object
+ * @throws Error if document is not found
+ */
+export async function getDocument(id) {
+    validateId(id, 'document');
+    // Try the direct endpoint first
+    try {
+        const document = await fetchOne(endpointWithId(ENDPOINTS.documents, id));
+        // If we got a valid document, return it
+        if (document) {
+            return document;
+        }
+    }
+    catch (error) {
+        // If direct fetch fails with NotFoundError, try fallback
+        if (!(error instanceof NotFoundError)) {
+            throw error;
+        }
+        debug(`getDocument(${id}) - direct endpoint failed, using fallback`);
+    }
+    // Fallback: Fetch all documents and filter by ID
+    // Note: This may not return employee-specific documents due to API access limitations
+    const allDocuments = await fetchList(ENDPOINTS.documents);
+    const document = allDocuments.find(doc => doc.id === String(id));
+    if (!document) {
+        throw new Error(`Document with ID ${id} not found.\n\n` +
+            'This may happen when trying to access employee-specific documents. ' +
+            'The Factorial API has limitations retrieving individual documents by ID.\n\n' +
+            'Workaround: Use list_documents with employee_ids filter to get document metadata, ' +
+            'then use download_payslips or download action with the document ID from that list.');
+    }
+    return document;
+}
+/**
+ * Get download URLs for documents using the bulk-create endpoint
+ *
+ * IMPORTANT: This endpoint requires OAuth2 authentication. API key authentication
+ * does not work for document downloads - this is a Factorial API limitation.
+ *
+ * @param documentIds - Array of document IDs to get download URLs for
+ * @returns Array of document IDs with their signed download URLs
+ * @throws Error if OAuth2 is not configured or authentication fails
+ */
+export async function getDocumentDownloadUrls(documentIds) {
+    // Check if OAuth2 is configured - required for downloads
+    if (!isOAuth2Configured()) {
+        throw new Error('Document download requires OAuth2 authentication.\n\n' +
+            'The Factorial API does not support document downloads with API key authentication.\n' +
+            'This is a Factorial API limitation, not an MCP server limitation.\n\n' +
+            'To enable document downloads:\n' +
+            '  1. Go to https://api.factorialhr.com/oauth/applications\n' +
+            '  2. Create an OAuth2 application\n' +
+            '  3. Complete the authorization flow to get a refresh token\n' +
+            '  4. Set environment variables:\n' +
+            '     - FACTORIAL_OAUTH_CLIENT_ID\n' +
+            '     - FACTORIAL_OAUTH_CLIENT_SECRET\n' +
+            '     - FACTORIAL_OAUTH_REFRESH_TOKEN\n\n' +
+            'See the README for detailed OAuth2 setup instructions.\n\n' +
+            `Document IDs requested: ${documentIds.join(', ')}`);
+    }
+    // Get OAuth2 access token
+    const accessToken = await getOAuth2AccessToken();
+    // The download-urls endpoint uses API version 2025-01-01, which predates the
+    // string-identifier migration and expects numeric ids on the wire, as this
+    // server sent before 2026-07-01 became the default. This request bypasses
+    // factorialRequest, so stringifyIdentifiers does not apply here.
+    const downloadUrlsEndpoint = 'https://api.factorialhr.com/api/2025-01-01/resources/documents/download-urls/bulk-create';
+    const wireDocumentIds = documentIds.map(Number);
+    debug('Requesting document download URLs with OAuth2', { documentIds });
+    const response = await fetch(downloadUrlsEndpoint, {
+        method: 'POST',
+        headers: {
+            Authorization: `Bearer ${accessToken}`,
+            'Content-Type': 'application/json',
+            Accept: 'application/json',
+        },
+        body: JSON.stringify({ document_ids: wireDocumentIds }),
+    });
+    if (!response.ok) {
+        const errorText = await response.text();
+        let errorData = null;
+        try {
+            errorData = JSON.parse(errorText);
+        }
+        catch {
+            // Ignore parse errors
+        }
+        // Handle specific errors
+        if (response.status === 401) {
+            throw new Error('OAuth2 authentication failed. The access token may have expired or been revoked.\n' +
+                'Try re-authorizing the OAuth2 application to get a new refresh token.');
+        }
+        if (errorData?.errors?.some(e => e.includes('not found'))) {
+            throw new Error(`Documents not found or not accessible. Document IDs: ${documentIds.join(', ')}`);
+        }
+        throw new Error(`Failed to get download URLs: ${response.status} ${errorText}`);
+    }
+    const data = (await response.json());
+    debug('Document download URLs retrieved successfully', { count: data.data.length });
+    return data.data;
+}
+/**
+ * Download a document by getting its signed URL and fetching the content
+ * @param idOrDocument - The document ID or a Document object (to avoid re-fetching metadata)
+ * @param outputDir - Directory to save the file to
+ * @returns Path to the downloaded file and metadata
+ */
+export async function downloadDocument(idOrDocument, outputDir) {
+    // Use provided document or fetch it
+    const document = typeof idOrDocument === 'number' ? await getDocument(idOrDocument) : idOrDocument;
+    const id = document.id;
+    // Get the signed download URL
+    const downloadUrls = await getDocumentDownloadUrls([id]);
+    const urlInfo = downloadUrls.find(u => String(u.document_id) === id);
+    if (!urlInfo?.url) {
+        throw new Error(`No download URL returned for document ${id}`);
+    }
+    // Ensure output directory exists
+    const fs = await import('fs/promises');
+    await fs.mkdir(outputDir, { recursive: true });
+    // Generate filename from document name or ID with appropriate extension.
+    // The document name is tenant-controlled metadata, so it is sanitized before
+    // being joined onto the output directory.
+    const ext = document.content_type === 'application/pdf' ? '.pdf' : '';
+    const fallbackName = `document-${id}${ext}`;
+    const outputPath = resolveSafeOutputPath(outputDir, document.filename || fallbackName, fallbackName);
+    // Download the file from the signed URL
+    const response = await fetch(urlInfo.url);
+    if (!response.ok) {
+        throw new Error(`Failed to download document: ${response.status} ${response.statusText}`);
+    }
+    const buffer = Buffer.from(await response.arrayBuffer());
+    // Never overwrite. The document name is tenant-controlled, so a download can
+    // otherwise land on an existing file the caller cares about, and two documents
+    // sharing a name would silently collapse into one. The `wx` flag fails if the
+    // path exists, so the loop settles on the first free "name (n).ext".
+    const writtenPath = await writeWithoutOverwriting(outputPath, buffer);
+    debug(`Downloaded document ${id} to ${writtenPath}`, {
+        size: buffer.length,
+        mime: document.content_type,
+    });
+    return { path: writtenPath, document };
+}
+/**
+ * Download all payslips for an employee
+ * @param employeeId - The employee ID
+ * @param outputDir - Directory to save files to
+ * @returns The payslips downloaded, and a description of any that failed
+ */
+export async function downloadEmployeePayslips(employeeId, outputDir) {
+    // Find the Nómina (payslip) folder
+    const folders = await listFolders();
+    const payslipFolder = folders.find(f => f.name.toLowerCase() === 'nómina' ||
+        f.name.toLowerCase() === 'nomina' ||
+        f.name.toLowerCase() === 'payslips');
+    if (!payslipFolder) {
+        throw new Error('Could not find payslip folder (Nómina) in Factorial');
+    }
+    // Get all documents for this employee in the payslip folder
+    const allDocs = await listDocuments({ employee_ids: [employeeId] });
+    const payslipDocs = allDocs.data.filter(d => d.folder_id === payslipFolder.id);
+    if (payslipDocs.length === 0) {
+        throw new Error(`No payslips found for employee ${employeeId}`);
+    }
+    // Download each payslip - pass the document object to avoid re-fetching metadata
+    const results = [];
+    const failures = [];
+    for (const doc of payslipDocs) {
+        try {
+            const result = await downloadDocument(doc, outputDir);
+            results.push(result);
+        }
+        catch (error) {
+            const reason = error instanceof Error ? error.message : 'Unknown error';
+            debug(`Failed to download payslip ${doc.id}: ${reason}`);
+            failures.push(`document ${doc.id}: ${reason}`);
+        }
+    }
+    // A partial download used to look identical to a complete one: failures went
+    // to debug(), which is silent unless DEBUG is set, and the missing payslips
+    // simply did not appear in the results.
+    if (failures.length > 0 && results.length === 0) {
+        throw new Error(`All ${failures.length} payslip downloads failed for employee ${employeeId}:\n${failures.join('\n')}`);
+    }
+    if (failures.length > 0) {
+        debug(`Partial payslip download for employee ${employeeId}`, { failures });
+    }
+    return { downloaded: results, failures };
+}
+/**
+ * Download any employee document by ID
+ * @param documentId - The document ID
+ * @param outputDir - Directory to save the file to
+ * @returns Path to the downloaded file and metadata
+ */
+export async function downloadEmployeeDocument(documentId, outputDir) {
+    return downloadDocument(documentId, outputDir);
+}
+//# sourceMappingURL=documents.js.map

package/dist/api/documents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.js","sourceRoot":"","sources":["../../src/api/documents.ts"],"names":[],"mappings":"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"}

package/dist/api/employees.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Employee API endpoints
+ */
+import { type PaginatedResponse } from '../pagination.js';
+import type { Employee, CreateEmployeeInput, UpdateEmployeeInput } from '../schemas.js';
+import type { ListEmployeesOptions } from '../types.js';
+/**
+ * List all employees with optional filtering and pagination
+ */
+export declare function listEmployees(options?: ListEmployeesOptions): Promise<PaginatedResponse<Employee>>;
+/**
+ * Get a specific employee by ID
+ *
+ * Note: The Factorial API's individual employee endpoint (/employees/employees/{id})
+ * can be unreliable. This function falls back to fetching all employees and filtering
+ * if the direct endpoint fails or returns no data.
+ */
+export declare function getEmployee(id: number): Promise<Employee>;
+/**
+ * Search employees by name or email
+ */
+export declare function searchEmployees(query: string): Promise<Employee[]>;
+/**
+ * Create a new employee
+ */
+export declare function createEmployee(input: CreateEmployeeInput): Promise<Employee>;
+/**
+ * Update an existing employee
+ */
+export declare function updateEmployee(id: number, input: UpdateEmployeeInput): Promise<Employee>;
+/**
+ * Terminate an employee (soft delete)
+ */
+export declare function terminateEmployee(id: number, terminatedOn: string, reason?: string): Promise<Employee>;
+//# sourceMappingURL=employees.d.ts.map

package/dist/api/employees.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"employees.d.ts","sourceRoot":"","sources":["../../src/api/employees.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,QAAQ,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAKxF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExD;;GAEG;AACH,wBAAsB,aAAa,CACjC,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CA+BtC;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAsC/D;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAoBxE;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAYlF;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAS9F;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,MAAM,EACV,YAAY,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,QAAQ,CAAC,CAiBnB"}

package/dist/api/employees.js

@@ -0,0 +1,116 @@
+/**
+ * Employee API endpoints
+ */
+import { fetchList, fetchOne, postOne, patchOne } 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';
+import { validateId } from '../utils.js';
+import { ENDPOINTS, endpointWithId } from '../endpoints.js';
+import { NotFoundError } from '../errors.js';
+/**
+ * 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(ENDPOINTS.employees), CACHE_TTL.employees);
+        let filtered = allEmployees;
+        // Note: team_id filtering requires fetching teams separately (not on Employee object)
+        // TODO: Implement team filtering via teams endpoint if needed
+        if (options.location_id) {
+            filtered = filtered.filter(e => e.location_id === String(options.location_id));
+        }
+        return sliceForPagination(filtered, params);
+    }
+    // Without filters, use pagination directly
+    const employees = await cached(cacheKey, () => fetchList(ENDPOINTS.employees, { params }), CACHE_TTL.employees);
+    return paginateResponse(employees, params.page, params.limit);
+}
+/**
+ * Get a specific employee by ID
+ *
+ * Note: The Factorial API's individual employee endpoint (/employees/employees/{id})
+ * can be unreliable. This function falls back to fetching all employees and filtering
+ * if the direct endpoint fails or returns no data.
+ */
+export async function getEmployee(id) {
+    validateId(id, 'employee');
+    // Try the direct endpoint first
+    try {
+        const employee = await cached(`employee:${id}`, () => fetchOne(endpointWithId(ENDPOINTS.employees, id)), CACHE_TTL.employees);
+        // If we got a valid employee, return it
+        if (employee) {
+            return employee;
+        }
+    }
+    catch (error) {
+        // If direct fetch fails with NotFoundError, try fallback
+        // (other errors will be re-thrown below)
+        if (!(error instanceof NotFoundError)) {
+            throw error;
+        }
+    }
+    // Fallback: Fetch all employees and filter (same approach as searchEmployees)
+    // This works around Factorial API limitations with the individual employee endpoint
+    const allEmployees = await cached('employees:all', () => fetchList(ENDPOINTS.employees), CACHE_TTL.employees);
+    const employee = allEmployees.find(emp => emp.id === String(id));
+    if (!employee) {
+        throw new Error(`Employee with ID ${id} not found.`);
+    }
+    return employee;
+}
+/**
+ * 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 allEmployees = await cached('employees:all', () => fetchList(ENDPOINTS.employees), CACHE_TTL.employees);
+    const lowerQuery = query.toLowerCase().trim();
+    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));
+}
+/**
+ * Create a new employee
+ */
+export async function createEmployee(input) {
+    return auditedOperation(AuditAction.CREATE, 'employee', undefined, async () => {
+        const employee = await postOne(ENDPOINTS.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) {
+    validateId(id, 'employee');
+    return auditedOperation(AuditAction.UPDATE, 'employee', id, async () => {
+        const employee = await patchOne(endpointWithId(ENDPOINTS.employees, id), input);
+        cache.invalidate(`employee:${id}`);
+        cache.invalidatePrefix('employees');
+        return employee;
+    });
+}
+/**
+ * Terminate an employee (soft delete)
+ */
+export async function terminateEmployee(id, terminatedOn, reason) {
+    validateId(id, 'employee');
+    return auditedOperation(AuditAction.TERMINATE, 'employee', id, async () => {
+        const employee = await patchOne(endpointWithId(ENDPOINTS.employees, id), {
+            terminated_on: terminatedOn,
+        });
+        cache.invalidate(`employee:${id}`);
+        cache.invalidatePrefix('employees');
+        return employee;
+    }, { terminated_on: { to: terminatedOn }, reason: { to: reason } });
+}
+//# sourceMappingURL=employees.js.map

package/dist/api/employees.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"employees.js","sourceRoot":"","sources":["../../src/api/employees.ts"],"names":[],"mappings":"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"}

package/dist/api/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * FactorialHR API Client
+ *
+ * Provides access to FactorialHR API endpoints with caching, pagination, and retry logic.
+ *
+ * This module re-exports all API functions from domain-specific files.
+ */
+export { clearCache, invalidateCache } from './shared.js';
+export { listEmployees, getEmployee, searchEmployees, createEmployee, updateEmployee, terminateEmployee, } from './employees.js';
+export { listTeams, getTeam, createTeam, updateTeam, deleteTeam } from './teams.js';
+export { listLocations, getLocation, createLocation, updateLocation, deleteLocation, } from './locations.js';
+export { listContracts, getLatestContract, getEmployeeWithContract, listEmployeesByJobRole, listEmployeesByJobLevel, type EmployeeWithContract, } from './contracts.js';
+export { listLeaves, getLeave, listLeaveTypes, getLeaveType, listAllowances, createLeave, updateLeave, cancelLeave, approveLeave, rejectLeave, } from './time-off.js';
+export { listShifts, getShift, createShift, updateShift, deleteShift } from './attendance.js';
+export { listFolders, getFolder, listDocuments, getDocument, getDocumentDownloadUrls, downloadDocument, downloadEmployeePayslips, downloadEmployeeDocument, } from './documents.js';
+export { listJobRoles, getJobRole, listJobLevels, getJobLevel } from './job-catalog.js';
+export { listProjects, getProject, listProjectTasks, getProjectTask, listProjectWorkers, getProjectWorker, listTimeRecords, getTimeRecord, createProject, updateProject, deleteProject, createProjectTask, updateProjectTask, deleteProjectTask, assignProjectWorker, removeProjectWorker, createTimeRecord, updateTimeRecord, deleteTimeRecord, } from './projects.js';
+export { listTrainings, getTraining, listTrainingSessions, getTrainingSession, listTrainingEnrollments, getTrainingEnrollment, createTraining, updateTraining, deleteTraining, createTrainingSession, updateTrainingSession, deleteTrainingSession, enrollInTraining, unenrollFromTraining, } from './training.js';
+export { listWorkAreas, getWorkArea, createWorkArea, updateWorkArea, archiveWorkArea, unarchiveWorkArea, } from './work-areas.js';
+export { listJobPostings, getJobPosting, listCandidates, getCandidate, listApplications, getApplication, listHiringStages, getHiringStage, createJobPosting, updateJobPosting, deleteJobPosting, createCandidate, updateCandidate, deleteCandidate, createApplication, updateApplication, deleteApplication, advanceApplication, } from './ats.js';
+export { listPayrollSupplements, getPayrollSupplement, listTaxIdentifiers, getTaxIdentifier, listFamilySituations, getFamilySituation, } from './payroll.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG1D,OAAO,EACL,aAAa,EACb,WAAW,EACX,eAAe,EACf,cAAc,EACd,cAAc,EACd,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGpF,OAAO,EACL,aAAa,EACb,WAAW,EACX,cAAc,EACd,cAAc,EACd,cAAc,GACf,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,KAAK,oBAAoB,GAC1B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,UAAU,EACV,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,cAAc,EACd,WAAW,EACX,WAAW,EACX,WAAW,EACX,YAAY,EACZ,WAAW,GACZ,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG9F,OAAO,EACL,WAAW,EACX,SAAS,EACT,aAAa,EACb,WAAW,EACX,uBAAuB,EACvB,gBAAgB,EAChB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGxF,OAAO,EACL,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,aAAa,EACb,WAAW,EACX,cAAc,EACd,cAAc,EACd,eAAe,EACf,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,eAAe,EACf,aAAa,EACb,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,cAAc,CAAC"}

package/dist/api/index.js

@@ -0,0 +1,36 @@
+/**
+ * FactorialHR API Client
+ *
+ * Provides access to FactorialHR API endpoints with caching, pagination, and retry logic.
+ *
+ * This module re-exports all API functions from domain-specific files.
+ */
+// Shared utilities
+export { clearCache, invalidateCache } from './shared.js';
+// Employees
+export { listEmployees, getEmployee, searchEmployees, createEmployee, updateEmployee, terminateEmployee, } from './employees.js';
+// Teams
+export { listTeams, getTeam, createTeam, updateTeam, deleteTeam } from './teams.js';
+// Locations
+export { listLocations, getLocation, createLocation, updateLocation, deleteLocation, } from './locations.js';
+// Contracts
+export { listContracts, getLatestContract, getEmployeeWithContract, listEmployeesByJobRole, listEmployeesByJobLevel, } from './contracts.js';
+// Time Off
+export { listLeaves, getLeave, listLeaveTypes, getLeaveType, listAllowances, createLeave, updateLeave, cancelLeave, approveLeave, rejectLeave, } from './time-off.js';
+// Attendance
+export { listShifts, getShift, createShift, updateShift, deleteShift } from './attendance.js';
+// Documents
+export { listFolders, getFolder, listDocuments, getDocument, getDocumentDownloadUrls, downloadDocument, downloadEmployeePayslips, downloadEmployeeDocument, } from './documents.js';
+// Job Catalog
+export { listJobRoles, getJobRole, listJobLevels, getJobLevel } from './job-catalog.js';
+// Projects
+export { listProjects, getProject, listProjectTasks, getProjectTask, listProjectWorkers, getProjectWorker, listTimeRecords, getTimeRecord, createProject, updateProject, deleteProject, createProjectTask, updateProjectTask, deleteProjectTask, assignProjectWorker, removeProjectWorker, createTimeRecord, updateTimeRecord, deleteTimeRecord, } from './projects.js';
+// Training
+export { listTrainings, getTraining, listTrainingSessions, getTrainingSession, listTrainingEnrollments, getTrainingEnrollment, createTraining, updateTraining, deleteTraining, createTrainingSession, updateTrainingSession, deleteTrainingSession, enrollInTraining, unenrollFromTraining, } from './training.js';
+// Work Areas
+export { listWorkAreas, getWorkArea, createWorkArea, updateWorkArea, archiveWorkArea, unarchiveWorkArea, } from './work-areas.js';
+// ATS (Recruiting)
+export { listJobPostings, getJobPosting, listCandidates, getCandidate, listApplications, getApplication, listHiringStages, getHiringStage, createJobPosting, updateJobPosting, deleteJobPosting, createCandidate, updateCandidate, deleteCandidate, createApplication, updateApplication, deleteApplication, advanceApplication, } from './ats.js';
+// Payroll
+export { listPayrollSupplements, getPayrollSupplement, listTaxIdentifiers, getTaxIdentifier, listFamilySituations, getFamilySituation, } from './payroll.js';
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,mBAAmB;AACnB,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE1D,YAAY;AACZ,OAAO,EACL,aAAa,EACb,WAAW,EACX,eAAe,EACf,cAAc,EACd,cAAc,EACd,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAExB,QAAQ;AACR,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEpF,YAAY;AACZ,OAAO,EACL,aAAa,EACb,WAAW,EACX,cAAc,EACd,cAAc,EACd,cAAc,GACf,MAAM,gBAAgB,CAAC;AAExB,YAAY;AACZ,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,GAExB,MAAM,gBAAgB,CAAC;AAExB,WAAW;AACX,OAAO,EACL,UAAU,EACV,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,cAAc,EACd,WAAW,EACX,WAAW,EACX,WAAW,EACX,YAAY,EACZ,WAAW,GACZ,MAAM,eAAe,CAAC;AAEvB,aAAa;AACb,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9F,YAAY;AACZ,OAAO,EACL,WAAW,EACX,SAAS,EACT,aAAa,EACb,WAAW,EACX,uBAAuB,EACvB,gBAAgB,EAChB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AAExB,cAAc;AACd,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAExF,WAAW;AACX,OAAO,EACL,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAEvB,WAAW;AACX,OAAO,EACL,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAEvB,aAAa;AACb,OAAO,EACL,aAAa,EACb,WAAW,EACX,cAAc,EACd,cAAc,EACd,eAAe,EACf,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAEzB,mBAAmB;AACnB,OAAO,EACL,eAAe,EACf,aAAa,EACb,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAElB,UAAU;AACV,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,cAAc,CAAC"}

package/dist/api/job-catalog.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Job Catalog API endpoints: Job Roles, Job Levels
+ */
+import type { JobRole, JobLevel } from '../schemas.js';
+/**
+ * List all job roles
+ */
+export declare function listJobRoles(): Promise<JobRole[]>;
+/**
+ * Get a specific job role by ID
+ */
+export declare function getJobRole(id: number): Promise<JobRole>;
+/**
+ * List all job levels
+ */
+export declare function listJobLevels(): Promise<JobLevel[]>;
+/**
+ * Get a specific job level by ID
+ */
+export declare function getJobLevel(id: number): Promise<JobLevel>;
+//# sourceMappingURL=job-catalog.d.ts.map

package/dist/api/job-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-catalog.d.ts","sourceRoot":"","sources":["../../src/api/job-catalog.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAIvD;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAEvD;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAI7D;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAMzD;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAI/D"}

package/dist/api/job-catalog.js

@@ -0,0 +1,34 @@
+/**
+ * Job Catalog API endpoints: Job Roles, Job Levels
+ */
+import { fetchList, fetchOne } from '../http-client.js';
+import { cached, CACHE_TTL } from '../cache.js';
+import { validateId } from '../utils.js';
+import { ENDPOINTS, endpointWithId } from '../endpoints.js';
+/**
+ * List all job roles
+ */
+export async function listJobRoles() {
+    return cached('job-roles:all', () => fetchList(ENDPOINTS.jobRoles), CACHE_TTL.default);
+}
+/**
+ * Get a specific job role by ID
+ */
+export async function getJobRole(id) {
+    validateId(id, 'job role');
+    return fetchOne(endpointWithId(ENDPOINTS.jobRoles, id));
+}
+/**
+ * List all job levels
+ */
+export async function listJobLevels() {
+    return cached('job-levels:all', () => fetchList(ENDPOINTS.jobLevels), CACHE_TTL.default);
+}
+/**
+ * Get a specific job level by ID
+ */
+export async function getJobLevel(id) {
+    validateId(id, 'job level');
+    return fetchOne(endpointWithId(ENDPOINTS.jobLevels, id));
+}
+//# sourceMappingURL=job-catalog.js.map

package/dist/api/job-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-catalog.js","sourceRoot":"","sources":["../../src/api/job-catalog.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE5D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,OAAO,MAAM,CAAC,eAAe,EAAE,GAAG,EAAE,CAAC,SAAS,CAAU,SAAS,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;AAClG,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,EAAU;IACzC,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IAE3B,OAAO,QAAQ,CAAU,cAAc,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;AACnE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,OAAO,MAAM,CACX,gBAAgB,EAChB,GAAG,EAAE,CAAC,SAAS,CAAW,SAAS,CAAC,SAAS,CAAC,EAC9C,SAAS,CAAC,OAAO,CAClB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,EAAU;IAC1C,UAAU,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;IAE5B,OAAO,QAAQ,CAAW,cAAc,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;AACrE,CAAC"}

package/dist/api/locations.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Location API endpoints
+ */
+import { type PaginatedResponse, type PaginationInput } from '../pagination.js';
+import type { Location, CreateLocationInput, UpdateLocationInput } from '../schemas.js';
+/**
+ * List all locations
+ */
+export declare function listLocations(options?: PaginationInput): Promise<PaginatedResponse<Location>>;
+/**
+ * Get a specific location by ID
+ */
+export declare function getLocation(id: number): Promise<Location>;
+/**
+ * Create a new location
+ */
+export declare function createLocation(input: CreateLocationInput): Promise<Location>;
+/**
+ * Update an existing location
+ */
+export declare function updateLocation(id: number, input: UpdateLocationInput): Promise<Location>;
+/**
+ * Delete a location
+ */
+export declare function deleteLocation(id: number): Promise<void>;
+//# sourceMappingURL=locations.d.ts.map

package/dist/api/locations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locations.d.ts","sourceRoot":"","sources":["../../src/api/locations.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,QAAQ,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAKxF;;GAEG;AACH,wBAAsB,aAAa,CACjC,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAWtC;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAQ/D;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAMlF;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAS9F;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ9D"}