@t4dhg/mcp-factorial 7.1.0 → 8.2.0

package/dist/api/ats.js

@@ -0,0 +1,173 @@
+/**
+ * ATS (Applicant Tracking System) API endpoints
+ */
+import { fetchList, fetchOne, postOne, patchOne, deleteOne, postAction } from '../http-client.js';
+import { cache, cached, CACHE_TTL, CacheManager } from '../cache.js';
+import { buildPaginationParams, sliceForPagination, } from '../pagination.js';
+import { AuditAction, auditedOperation } from '../audit.js';
+import { validateId } from '../utils.js';
+import { ENDPOINTS, endpointWithId, endpointWithAction } from '../endpoints.js';
+// ============================================================================
+// ATS - 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(ENDPOINTS.jobPostings), CACHE_TTL.default);
+    return sliceForPagination(postings, params);
+}
+/**
+ * Get a specific job posting by ID
+ */
+export async function getJobPosting(id) {
+    validateId(id, 'job posting');
+    return cached(`job_posting:${id}`, () => fetchOne(endpointWithId(ENDPOINTS.jobPostings, id)), CACHE_TTL.default);
+}
+/**
+ * List all candidates
+ */
+export async function listCandidates(options) {
+    const params = buildPaginationParams(options);
+    const candidates = await fetchList(ENDPOINTS.candidates);
+    return sliceForPagination(candidates, params);
+}
+/**
+ * Get a specific candidate by ID
+ */
+export async function getCandidate(id) {
+    validateId(id, 'candidate');
+    return fetchOne(endpointWithId(ENDPOINTS.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(ENDPOINTS.applications, {
+        params: queryParams,
+    });
+    return sliceForPagination(applications, params);
+}
+/**
+ * Get a specific application by ID
+ */
+export async function getApplication(id) {
+    validateId(id, 'application');
+    return fetchOne(endpointWithId(ENDPOINTS.applications, id));
+}
+/**
+ * List all hiring stages
+ */
+export async function listHiringStages() {
+    return cached('hiring_stages:all', () => fetchList(ENDPOINTS.hiringStages), CACHE_TTL.default);
+}
+/**
+ * Get a specific hiring stage by ID
+ */
+export async function getHiringStage(id) {
+    validateId(id, 'hiring stage');
+    return fetchOne(endpointWithId(ENDPOINTS.hiringStages, id));
+}
+// ============================================================================
+// ATS - WRITE endpoints
+// ============================================================================
+/**
+ * Create a job posting
+ */
+export async function createJobPosting(input) {
+    return auditedOperation(AuditAction.CREATE, 'job_posting', undefined, async () => {
+        const posting = await postOne(ENDPOINTS.jobPostings, input);
+        cache.invalidatePrefix('job_postings');
+        return posting;
+    });
+}
+/**
+ * Update a job posting
+ */
+export async function updateJobPosting(id, input) {
+    validateId(id, 'job posting');
+    return auditedOperation(AuditAction.UPDATE, 'job_posting', id, async () => {
+        const posting = await patchOne(endpointWithId(ENDPOINTS.jobPostings, id), input);
+        cache.invalidate(`job_posting:${id}`);
+        cache.invalidatePrefix('job_postings');
+        return posting;
+    });
+}
+/**
+ * Delete a job posting
+ */
+export async function deleteJobPosting(id) {
+    validateId(id, 'job posting');
+    return auditedOperation(AuditAction.DELETE, 'job_posting', id, async () => {
+        await deleteOne(endpointWithId(ENDPOINTS.jobPostings, 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(ENDPOINTS.candidates, input);
+    });
+}
+/**
+ * Update a candidate
+ */
+export async function updateCandidate(id, input) {
+    validateId(id, 'candidate');
+    return auditedOperation(AuditAction.UPDATE, 'candidate', id, async () => {
+        return patchOne(endpointWithId(ENDPOINTS.candidates, id), input);
+    });
+}
+/**
+ * Delete a candidate
+ */
+export async function deleteCandidate(id) {
+    validateId(id, 'candidate');
+    return auditedOperation(AuditAction.DELETE, 'candidate', id, async () => {
+        await deleteOne(endpointWithId(ENDPOINTS.candidates, id));
+    });
+}
+/**
+ * Create an application
+ */
+export async function createApplication(input) {
+    return auditedOperation(AuditAction.CREATE, 'application', undefined, async () => {
+        return postOne(ENDPOINTS.applications, input);
+    });
+}
+/**
+ * Update an application
+ */
+export async function updateApplication(id, input) {
+    validateId(id, 'application');
+    return auditedOperation(AuditAction.UPDATE, 'application', id, async () => {
+        return patchOne(endpointWithId(ENDPOINTS.applications, id), input);
+    });
+}
+/**
+ * Delete an application
+ */
+export async function deleteApplication(id) {
+    validateId(id, 'application');
+    return auditedOperation(AuditAction.DELETE, 'application', id, async () => {
+        await deleteOne(endpointWithId(ENDPOINTS.applications, id));
+    });
+}
+/**
+ * Advance an application to the next stage
+ */
+export async function advanceApplication(id) {
+    validateId(id, 'application');
+    return auditedOperation(AuditAction.UPDATE, 'application', id, async () => {
+        return postAction(endpointWithAction(ENDPOINTS.applications, id, 'apply'));
+    });
+}
+//# sourceMappingURL=ats.js.map

package/dist/api/ats.js.map

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

package/dist/api/attendance.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Attendance API endpoints: Shifts
+ */
+import { type PaginatedResponse } from '../pagination.js';
+import type { Shift, CreateShiftInput, UpdateShiftInput } from '../schemas.js';
+import type { ListShiftsOptions } from '../types.js';
+/**
+ * List shifts with optional filtering
+ */
+export declare function listShifts(options?: ListShiftsOptions): Promise<PaginatedResponse<Shift>>;
+/**
+ * Get a specific shift by ID
+ */
+export declare function getShift(id: number): Promise<Shift>;
+/**
+ * Create a new shift
+ */
+export declare function createShift(input: CreateShiftInput): Promise<Shift>;
+/**
+ * Update a shift
+ */
+export declare function updateShift(id: number, input: UpdateShiftInput): Promise<Shift>;
+/**
+ * Delete a shift
+ */
+export declare function deleteShift(id: number): Promise<void>;
+//# sourceMappingURL=attendance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"attendance.d.ts","sourceRoot":"","sources":["../../src/api/attendance.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAA2C,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACnG,OAAO,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAI/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAe/F;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAIzD;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC,CAKzE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC,CAOrF;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM3D"}

package/dist/api/attendance.js

@@ -0,0 +1,62 @@
+/**
+ * Attendance API endpoints: Shifts
+ */
+import { fetchList, fetchOne, postOne, patchOne, deleteOne } from '../http-client.js';
+import { buildPaginationParams, paginateResponse } from '../pagination.js';
+import { AuditAction, auditedOperation } from '../audit.js';
+import { validateId } from '../utils.js';
+import { ENDPOINTS, endpointWithId } from '../endpoints.js';
+/**
+ * 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(ENDPOINTS.shifts, { params: queryParams });
+    return paginateResponse(shifts, params.page, params.limit);
+}
+/**
+ * Get a specific shift by ID
+ */
+export async function getShift(id) {
+    validateId(id, 'shift');
+    return fetchOne(endpointWithId(ENDPOINTS.shifts, id));
+}
+/**
+ * Create a new shift
+ */
+export async function createShift(input) {
+    return auditedOperation(AuditAction.CREATE, 'shift', undefined, async () => {
+        const shift = await postOne(ENDPOINTS.shifts, input);
+        return shift;
+    });
+}
+/**
+ * Update a shift
+ */
+export async function updateShift(id, input) {
+    validateId(id, 'shift');
+    return auditedOperation(AuditAction.UPDATE, 'shift', id, async () => {
+        const shift = await patchOne(endpointWithId(ENDPOINTS.shifts, id), input);
+        return shift;
+    });
+}
+/**
+ * Delete a shift
+ */
+export async function deleteShift(id) {
+    validateId(id, 'shift');
+    return auditedOperation(AuditAction.DELETE, 'shift', id, async () => {
+        await deleteOne(endpointWithId(ENDPOINTS.shifts, id));
+    });
+}
+//# sourceMappingURL=attendance.js.map

package/dist/api/attendance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attendance.js","sourceRoot":"","sources":["../../src/api/attendance.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACtF,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAA0B,MAAM,kBAAkB,CAAC;AAEnG,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAG5D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAA2B;IAC1D,MAAM,MAAM,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAE9C,MAAM,WAAW,GAAgD;QAC/D,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC;IAEF,IAAI,OAAO,EAAE,WAAW;QAAE,WAAW,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IACxE,IAAI,OAAO,EAAE,YAAY;QAAE,WAAW,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAC3E,IAAI,OAAO,EAAE,YAAY;QAAE,WAAW,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAE3E,MAAM,MAAM,GAAG,MAAM,SAAS,CAAQ,SAAS,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IAEjF,OAAO,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,EAAU;IACvC,UAAU,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAExB,OAAO,QAAQ,CAAQ,cAAc,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAuB;IACvD,OAAO,gBAAgB,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,KAAK,GAAG,MAAM,OAAO,CAAQ,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC5D,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,EAAU,EAAE,KAAuB;IACnE,UAAU,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAExB,OAAO,gBAAgB,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,IAAI,EAAE;QAClE,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAQ,cAAc,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;QACjF,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,EAAU;IAC1C,UAAU,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAExB,OAAO,gBAAgB,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,IAAI,EAAE;QAClE,MAAM,SAAS,CAAC,cAAc,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/api/contracts.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Contract API endpoints
+ */
+import { type PaginatedResponse, type PaginationInput } from '../pagination.js';
+import type { Employee, Contract } from '../schemas.js';
+/**
+ * List contracts, optionally filtered by employee ID
+ */
+export declare function listContracts(employeeId?: number, options?: PaginationInput): Promise<PaginatedResponse<Contract>>;
+/**
+ * Get the latest contract for an employee
+ * Returns the most recent contract based on effective_on date
+ */
+export declare function getLatestContract(employeeId: number): Promise<Contract | null>;
+/**
+ * Employee with their latest contract data
+ */
+export interface EmployeeWithContract {
+    employee: Employee;
+    contract: Contract | null;
+}
+/**
+ * Get an employee with their latest contract
+ * Combines employee data with compensation/job role info from their contract
+ */
+export declare function getEmployeeWithContract(employeeId: number): Promise<EmployeeWithContract>;
+/**
+ * List employees by job role ID
+ * Uses contract data to find employees assigned to a specific job role
+ *
+ * Note: Job role assignment is stored in contracts (job_catalog_role_id),
+ * not on the employee object itself. This is an API design choice by Factorial.
+ */
+export declare function listEmployeesByJobRole(jobRoleId: number, options?: PaginationInput): Promise<PaginatedResponse<EmployeeWithContract>>;
+/**
+ * List employees by job level ID
+ * Uses contract data to find employees at a specific job level
+ */
+export declare function listEmployeesByJobLevel(jobLevelId: number, options?: PaginationInput): Promise<PaginatedResponse<EmployeeWithContract>>;
+//# sourceMappingURL=contracts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/api/contracts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAKxD;;GAEG;AACH,wBAAsB,aAAa,CACjC,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAqBtC;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAuBpF;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAU/F;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,iBAAiB,CAAC,oBAAoB,CAAC,CAAC,CAqDlD;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,iBAAiB,CAAC,oBAAoB,CAAC,CAAC,CAoDlD"}

package/dist/api/contracts.js

@@ -0,0 +1,146 @@
+/**
+ * Contract API endpoints
+ */
+import { fetchList } from '../http-client.js';
+import { cached, CACHE_TTL } from '../cache.js';
+import { buildPaginationParams, sliceForPagination, } from '../pagination.js';
+import { validateId } from '../utils.js';
+import { ENDPOINTS } from '../endpoints.js';
+import { getEmployee } from './employees.js';
+/**
+ * List contracts, optionally filtered by employee ID
+ */
+export async function listContracts(employeeId, options) {
+    if (employeeId !== undefined) {
+        validateId(employeeId, 'employee');
+    }
+    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 allContracts = await cached('contracts:all', () => fetchList(ENDPOINTS.contracts), CACHE_TTL.contracts);
+    const filtered = employeeId !== undefined
+        ? allContracts.filter(c => c.employee_id === employeeId)
+        : allContracts;
+    return sliceForPagination(filtered, params);
+}
+/**
+ * Get the latest contract for an employee
+ * Returns the most recent contract based on effective_on date
+ */
+export async function getLatestContract(employeeId) {
+    validateId(employeeId, 'employee');
+    const allContracts = await cached('contracts:all', () => fetchList(ENDPOINTS.contracts), CACHE_TTL.contracts);
+    const employeeContracts = allContracts.filter(c => c.employee_id === employeeId);
+    if (employeeContracts.length === 0) {
+        return null;
+    }
+    // Sort by effective_on descending (most recent first)
+    employeeContracts.sort((a, b) => {
+        const dateA = a.effective_on ? new Date(a.effective_on).getTime() : 0;
+        const dateB = b.effective_on ? new Date(b.effective_on).getTime() : 0;
+        return dateB - dateA;
+    });
+    return employeeContracts[0];
+}
+/**
+ * Get an employee with their latest contract
+ * Combines employee data with compensation/job role info from their contract
+ */
+export async function getEmployeeWithContract(employeeId) {
+    validateId(employeeId, 'employee');
+    // Fetch employee and contract in parallel
+    const [employee, contract] = await Promise.all([
+        getEmployee(employeeId),
+        getLatestContract(employeeId),
+    ]);
+    return { employee, contract };
+}
+/**
+ * List employees by job role ID
+ * Uses contract data to find employees assigned to a specific job role
+ *
+ * Note: Job role assignment is stored in contracts (job_catalog_role_id),
+ * not on the employee object itself. This is an API design choice by Factorial.
+ */
+export async function listEmployeesByJobRole(jobRoleId, options) {
+    validateId(jobRoleId, 'job role');
+    const params = buildPaginationParams(options);
+    // Get all contracts and filter by job role
+    const allContracts = await cached('contracts:all', () => fetchList(ENDPOINTS.contracts), CACHE_TTL.contracts);
+    // Find contracts with this job role, grouped by employee (latest contract per employee)
+    const latestContractsByEmployee = new Map();
+    for (const contract of allContracts) {
+        if (contract.job_catalog_role_id === jobRoleId) {
+            const existing = latestContractsByEmployee.get(contract.employee_id);
+            if (!existing) {
+                latestContractsByEmployee.set(contract.employee_id, contract);
+            }
+            else {
+                // Keep the more recent contract
+                const existingDate = existing.effective_on ? new Date(existing.effective_on).getTime() : 0;
+                const contractDate = contract.effective_on ? new Date(contract.effective_on).getTime() : 0;
+                if (contractDate > existingDate) {
+                    latestContractsByEmployee.set(contract.employee_id, contract);
+                }
+            }
+        }
+    }
+    const employeeIds = Array.from(latestContractsByEmployee.keys());
+    if (employeeIds.length === 0) {
+        return { data: [], meta: { page: params.page, limit: params.limit, total: 0 } };
+    }
+    // Get all employees
+    const allEmployees = await cached('employees:all', () => fetchList(ENDPOINTS.employees), CACHE_TTL.employees);
+    // Match employees with their contracts
+    const results = [];
+    for (const emp of allEmployees) {
+        const contract = latestContractsByEmployee.get(emp.id);
+        if (contract) {
+            results.push({ employee: emp, contract });
+        }
+    }
+    return sliceForPagination(results, params);
+}
+/**
+ * List employees by job level ID
+ * Uses contract data to find employees at a specific job level
+ */
+export async function listEmployeesByJobLevel(jobLevelId, options) {
+    validateId(jobLevelId, 'job level');
+    const params = buildPaginationParams(options);
+    // Get all contracts and filter by job level
+    const allContracts = await cached('contracts:all', () => fetchList(ENDPOINTS.contracts), CACHE_TTL.contracts);
+    // Find contracts with this job level, grouped by employee (latest contract per employee)
+    const latestContractsByEmployee = new Map();
+    for (const contract of allContracts) {
+        if (contract.job_catalog_level_id === jobLevelId) {
+            const existing = latestContractsByEmployee.get(contract.employee_id);
+            if (!existing) {
+                latestContractsByEmployee.set(contract.employee_id, contract);
+            }
+            else {
+                const existingDate = existing.effective_on ? new Date(existing.effective_on).getTime() : 0;
+                const contractDate = contract.effective_on ? new Date(contract.effective_on).getTime() : 0;
+                if (contractDate > existingDate) {
+                    latestContractsByEmployee.set(contract.employee_id, contract);
+                }
+            }
+        }
+    }
+    const employeeIds = Array.from(latestContractsByEmployee.keys());
+    if (employeeIds.length === 0) {
+        return { data: [], meta: { page: params.page, limit: params.limit, total: 0 } };
+    }
+    // Get all employees
+    const allEmployees = await cached('employees:all', () => fetchList(ENDPOINTS.employees), CACHE_TTL.employees);
+    // Match employees with their contracts
+    const results = [];
+    for (const emp of allEmployees) {
+        const contract = latestContractsByEmployee.get(emp.id);
+        if (contract) {
+            results.push({ employee: emp, contract });
+        }
+    }
+    return sliceForPagination(results, params);
+}
+//# sourceMappingURL=contracts.js.map

package/dist/api/contracts.js.map

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

package/dist/api/documents.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Document API endpoints: Folders, Documents, Downloads
+ */
+import { type PaginatedResponse } from '../pagination.js';
+import type { Folder, Document } from '../schemas.js';
+import type { ListDocumentsOptions } from '../types.js';
+/**
+ * List all folders
+ */
+export declare function listFolders(): Promise<Folder[]>;
+/**
+ * Get a specific folder by ID
+ */
+export declare function getFolder(id: number): Promise<Folder>;
+/**
+ * List documents with optional filtering by folder
+ */
+export declare function listDocuments(options?: ListDocumentsOptions): Promise<PaginatedResponse<Document>>;
+/**
+ * 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 declare function getDocument(id: number): Promise<Document>;
+/**
+ * Response from the download-urls/bulk-create endpoint
+ */
+interface DownloadUrlResponse {
+    document_id: number;
+    url: string;
+}
+/**
+ * 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 declare function getDocumentDownloadUrls(documentIds: number[]): Promise<DownloadUrlResponse[]>;
+/**
+ * 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 declare function downloadDocument(idOrDocument: number | Document, outputDir: string): Promise<{
+    path: string;
+    document: Document;
+}>;
+/**
+ * Outcome of a bulk payslip download
+ *
+ * Failures are returned rather than swallowed, so a partial download cannot be
+ * reported as a complete one.
+ */
+export interface PayslipDownloadResult {
+    downloaded: Array<{
+        path: string;
+        document: Document;
+    }>;
+    failures: string[];
+}
+/**
+ * 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 declare function downloadEmployeePayslips(employeeId: number, outputDir: string): Promise<PayslipDownloadResult>;
+/**
+ * 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 declare function downloadEmployeeDocument(documentId: number, outputDir: string): Promise<{
+    path: string;
+    document: Document;
+}>;
+export {};
+//# sourceMappingURL=documents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../src/api/documents.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAA2C,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACnG,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAItD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExD;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAErD;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI3D;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAqCtC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAoC/D;AAED;;GAEG;AACH,UAAU,mBAAmB;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;GASG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAoEhC;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,MAAM,GAAG,QAAQ,EAC/B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,CAAC,CA6C/C;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAA;KAAE,CAAC,CAAC;IACxD,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,qBAAqB,CAAC,CAmDhC;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,CAAC,CAE/C"}