@t4dhg/mcp-factorial 7.1.0 → 8.2.0

package/README.md

@@ -1,6 +1,10 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/t4dhg/mcp-factorial/main/assets/factorial-logo.svg" alt="FactorialHR" height="48">
+</p>
+
 # MCP FactorialHR
 
-> **The definitive Model Context Protocol server for FactorialHR**
+> **The definitive Model Context Protocol server for [FactorialHR](https://factorialhr.com)**
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 [![CI](https://github.com/t4dhg/mcp-factorial/actions/workflows/ci.yml/badge.svg)](https://github.com/t4dhg/mcp-factorial/actions/workflows/ci.yml)
@@ -10,37 +14,82 @@
 [![Node.js](https://img.shields.io/badge/Node.js-18%2B-brightgreen.svg)](https://nodejs.org/)
 [![npm version](https://img.shields.io/npm/v/@t4dhg/mcp-factorial.svg)](https://www.npmjs.com/package/@t4dhg/mcp-factorial)
 [![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-green.svg)](https://modelcontextprotocol.io/)
-[![smithery badge](https://smithery.ai/badge/@t4dhg/mcp-factorial)](https://smithery.ai/server/@t4dhg/mcp-factorial)
 
 A comprehensive Model Context Protocol (MCP) server that provides AI assistants like Claude with full access to FactorialHR. Manage employees, teams, time off, projects, training, recruiting, and more - all with built-in safety guardrails.
 
 ## Why This MCP Server?
 
-- **Comprehensive Coverage**: 85+ tools spanning employees, teams, time off, attendance, projects, training, recruiting (ATS), and payroll
+- **Context-Optimized**: 14 hierarchical tools (117 operations) with 88% less context usage than individual tools
 - **Full CRUD Operations**: Create, read, update, and delete across all major entities
 - **Safety Guardrails**: High-risk operations require explicit confirmation
-- **Audit Logging**: All write operations are logged for compliance
+- **Audit Logging**: All write operations are logged with timestamps and context for debugging
 - **Enterprise Ready**: Built for companies who need AI integration with proper controls
 
 ## Features
 
-### 85+ Tools
-
-| Category        | Tools | Operations                                                              |
-| --------------- | ----- | ----------------------------------------------------------------------- |
-| **Employees**   | 6     | List, get, search, create, update, terminate                            |
-| **Teams**       | 5     | List, get, create, update, delete                                       |
-| **Locations**   | 5     | List, get, create, update, delete                                       |
-| **Time Off**    | 10    | List leaves/types/allowances, create, update, cancel, approve, reject   |
-| **Attendance**  | 5     | List shifts, create, update, delete                                     |
-| **Projects**    | 17    | Full CRUD for projects, tasks, workers, time records                    |
-| **Training**    | 14    | Full CRUD for trainings, sessions, enrollments                          |
-| **Work Areas**  | 6     | List, get, create, update, archive, unarchive                           |
-| **ATS**         | 16    | Job postings, candidates, applications, hiring stages, advance workflow |
-| **Payroll**     | 6     | List/get supplements, tax identifiers, family situations (read-only)    |
-| **Documents**   | 5     | List/get/search folders and documents (read-only)                       |
-| **Job Catalog** | 3     | List/get job roles and levels (read-only)                               |
-| **Contracts**   | 4     | Get contracts, employee with contract, by job role/level (read-only)    |
+### Hierarchical Tool Discovery (v8.0.0+)
+
+The MCP server uses a hierarchical tool structure for optimal context usage. Instead of 117 individual tools, you get 14 category-based tools with an `action` parameter.
+
+| Tool                    | Description                   | Actions                                            |
+| ----------------------- | ----------------------------- | -------------------------------------------------- |
+| `factorial_discover`    | Discover available categories | -                                                  |
+| `factorial_employees`   | Employee management           | list, get, search, create, update, terminate       |
+| `factorial_teams`       | Team management               | list, get, create, update, delete                  |
+| `factorial_locations`   | Location management           | list, get, create, update, delete                  |
+| `factorial_contracts`   | Contract/salary data          | list, get_with_employee, by_job_role, by_job_level |
+| `factorial_time_off`    | Leave management              | 10 actions                                         |
+| `factorial_attendance`  | Shift management              | list, get, create, update, delete                  |
+| `factorial_documents`   | Document management           | 8 actions (downloads require OAuth2 - see below)   |
+| `factorial_job_catalog` | Job roles/levels              | list_roles, get_role, list_levels                  |
+| `factorial_projects`    | Project management            | 16 actions for projects, tasks, workers, time      |
+| `factorial_training`    | Training management           | 12 actions for trainings, sessions, enrollments    |
+| `factorial_work_areas`  | Work area management          | list, get, create, update, archive, unarchive      |
+| `factorial_ats`         | Applicant tracking            | 17 actions for recruiting                          |
+| `factorial_payroll`     | Payroll data (read-only)      | 6 actions                                          |
+
+**Example Usage:**
+
+```typescript
+// List all employees
+factorial_employees({ action: 'list', page: 1, limit: 50 });
+
+// Get a specific employee
+factorial_employees({ action: 'get', id: 123 });
+
+// Search employees
+factorial_employees({ action: 'search', query: 'john' });
+
+// Create a leave request
+factorial_time_off({
+  action: 'create',
+  employee_id: 123,
+  leave_type_id: 1,
+  start_on: '2026-02-01',
+  finish_on: '2026-02-05',
+});
+
+// Discover available actions for a category
+factorial_discover({ category: 'employees' });
+```
+
+### 117 Operations Across 14 Categories
+
+| Category        | Operations                                                                                             |
+| --------------- | ------------------------------------------------------------------------------------------------------ |
+| **Employees**   | list, get, search, create, update, terminate                                                           |
+| **Teams**       | list, get, create, update, delete                                                                      |
+| **Locations**   | list, get, create, update, delete                                                                      |
+| **Time Off**    | list_leaves, get_leave, list_types, get_type, list_allowances, create, update, cancel, approve, reject |
+| **Attendance**  | list, get, create, update, delete                                                                      |
+| **Projects**    | 16 operations for projects, tasks, workers, time records                                               |
+| **Training**    | 12 operations for trainings, sessions, enrollments                                                     |
+| **Work Areas**  | list, get, create, update, archive, unarchive                                                          |
+| **ATS**         | 17 operations for job postings, candidates, applications, hiring stages                                |
+| **Payroll**     | list/get supplements, tax identifiers, family situations (read-only)                                   |
+| **Documents**   | 8 operations for folders, documents, and downloads (⚠️ downloads require OAuth2)                       |
+| **Job Catalog** | list_roles, get_role, list_levels (read-only)                                                          |
+| **Contracts**   | list, get_with_employee, by_job_role, by_job_level (read-only)                                         |
 
 ### 5 MCP Resources
 
@@ -64,7 +113,7 @@ A comprehensive Model Context Protocol (MCP) server that provides AI assistants
 ### Architecture Features
 
 - **Safety Guardrails**: High-risk operations (terminate, delete) marked for confirmation
-- **Audit Logging**: All write operations logged with timestamps and context
+- **Audit Logging**: All write operations logged in-process with timestamps and context
 - **Caching**: In-memory TTL-based caching (configurable by resource type)
 - **Pagination**: All list operations support pagination
 - **Retry Logic**: Exponential backoff with rate limit handling
@@ -135,6 +184,87 @@ You'll need a FactorialHR API key to use this MCP server. Here's how to get one:
 
 > **Important**: API keys have full access to your FactorialHR data and never expire. Store them securely, never commit them to version control, and rotate them periodically.
 
+## OAuth2 Setup (Required for Document Downloads)
+
+Document download actions (`download_payslips`, `download`) **require OAuth2 authentication**. This is a Factorial API limitation - the download endpoint does not accept API key authentication.
+
+> **Note**: You need admin access in Factorial to create OAuth applications.
+
+### Step 1: Create an OAuth2 Application
+
+1. Go to: **https://api.factorialhr.com/oauth/applications**
+2. Click **"New application"**
+3. Fill in:
+   - **Redirect URI**: `http://localhost:8080/callback` (or any URL you can access)
+   - **Confidentiality**: Yes (server application)
+   - **Scopes**: Select the scopes you need:
+     - **Required for downloads**: Documents, Employees
+     - **Recommended for full MCP functionality**: Contracts, Payroll, Payroll supplements, Time off, Shift management, Trainings, Recruitment, Company locations, Job catalog
+4. Save and note your **Client ID** and **Client Secret**
+
+### Step 2: Get Authorization Code
+
+Open this URL in your browser (replace `YOUR_CLIENT_ID`):
+
+```
+https://api.factorialhr.com/oauth/authorize?client_id=YOUR_CLIENT_ID&redirect_uri=http://localhost:8080/callback&response_type=code
+```
+
+- Log in and authorize the app
+- You'll be redirected to your callback URL with `?code=AUTHORIZATION_CODE`
+- Copy that code from the URL (it expires quickly, so proceed to step 3 immediately)
+
+### Step 3: Exchange Code for Tokens
+
+Run this curl command (replace placeholders):
+
+```bash
+curl -X POST 'https://api.factorialhr.com/oauth/token' \
+  -d 'client_id=YOUR_CLIENT_ID' \
+  -d 'client_secret=YOUR_CLIENT_SECRET' \
+  -d 'code=AUTHORIZATION_CODE' \
+  -d 'grant_type=authorization_code' \
+  -d 'redirect_uri=http://localhost:8080/callback'
+```
+
+You'll get a response with `access_token` and `refresh_token`. Save the **refresh_token**.
+
+### Step 4: Configure MCP Server
+
+Add OAuth2 credentials to your MCP configuration:
+
+```json
+{
+  "mcpServers": {
+    "factorial": {
+      "command": "npx",
+      "args": ["-y", "@t4dhg/mcp-factorial"],
+      "env": {
+        "FACTORIAL_API_KEY": "your-api-key",
+        "FACTORIAL_OAUTH_CLIENT_ID": "your-client-id",
+        "FACTORIAL_OAUTH_CLIENT_SECRET": "your-client-secret",
+        "FACTORIAL_OAUTH_REFRESH_TOKEN": "your-refresh-token"
+      }
+    }
+  }
+}
+```
+
+Or add to your `.env` file:
+
+```env
+FACTORIAL_API_KEY=your-api-key
+FACTORIAL_OAUTH_CLIENT_ID=your-client-id
+FACTORIAL_OAUTH_CLIENT_SECRET=your-client-secret
+FACTORIAL_OAUTH_REFRESH_TOKEN=your-refresh-token
+```
+
+### Important Notes
+
+- **Refresh tokens expire after 1 week** - you'll need to repeat steps 2-3 if it expires
+- The MCP server automatically refreshes access tokens using the refresh token
+- If document downloads suddenly stop working, your refresh token has likely expired
+
 ## Use Cases
 
 ### For Managers
@@ -162,60 +292,86 @@ You'll need a FactorialHR API key to use this MCP server. Here's how to get one:
 
 ## Configuration Options
 
-| Environment Variable    | Description              | Default      |
-| ----------------------- | ------------------------ | ------------ |
-| `FACTORIAL_API_KEY`     | Your FactorialHR API key | Required     |
-| `FACTORIAL_API_VERSION` | API version              | `2025-10-01` |
-| `FACTORIAL_TIMEOUT_MS`  | Request timeout (ms)     | `30000`      |
-| `FACTORIAL_MAX_RETRIES` | Max retry attempts       | `3`          |
-| `DEBUG`                 | Enable debug logging     | `false`      |
+| Environment Variable            | Description                          | Default      |
+| ------------------------------- | ------------------------------------ | ------------ |
+| `FACTORIAL_API_KEY`             | Your FactorialHR API key             | Required     |
+| `FACTORIAL_API_VERSION`         | API version                          | `2025-10-01` |
+| `FACTORIAL_TIMEOUT_MS`          | Request timeout (ms)                 | `30000`      |
+| `FACTORIAL_MAX_RETRIES`         | Max retry attempts                   | `3`          |
+| `DEBUG`                         | Enable debug logging                 | `false`      |
+| `FACTORIAL_OAUTH_CLIENT_ID`     | OAuth2 client ID (for downloads)     | -            |
+| `FACTORIAL_OAUTH_CLIENT_SECRET` | OAuth2 client secret (for downloads) | -            |
+| `FACTORIAL_OAUTH_REFRESH_TOKEN` | OAuth2 refresh token (for downloads) | -            |
 
 ## Safety & Security
 
-### High-Risk Operations
+### Operations That Require Confirmation
 
-The following operations are marked as high-risk and should be used with care:
+The following operations require explicit confirmation (`confirm: true`). Called without it, the tool returns a warning describing the impact and makes no change. Risk is classified per operation in `src/write-safety.ts`; everything below is gated regardless of whether it is rated high or medium:
 
-- `terminate_employee` - Terminates an employee (sets termination date)
-- `delete_team` - Permanently deletes a team
-- `delete_location` - Permanently deletes a location
-- `delete_project` - Permanently deletes a project
-- `delete_candidate` - Permanently deletes a candidate
+- `factorial_employees({ action: 'terminate' })` - Terminates an employee
+- `factorial_teams({ action: 'delete' })` - Permanently deletes a team
+- `factorial_locations({ action: 'delete' })` - Permanently deletes a location
+- `factorial_projects({ action: 'delete' })` - Permanently deletes a project
+- `factorial_projects({ action: 'delete_task' })` - Deletes a project task
+- `factorial_projects({ action: 'delete_time' })` - Deletes a time record
+- `factorial_projects({ action: 'remove_worker' })` - Deletes an employee's assignment to a project
+- `factorial_attendance({ action: 'delete' })` - Deletes a shift record
+- `factorial_time_off({ action: 'cancel' })` - Cancels a leave request
+- `factorial_time_off({ action: 'reject' })` - Rejects a leave request
+- `factorial_training({ action: 'delete' })` - Deletes a training program and its enrollments
+- `factorial_training({ action: 'delete_session' })` - Deletes a training session
+- `factorial_training({ action: 'unenroll' })` - Deletes an employee's training enrollment
+- `factorial_ats({ action: 'delete_posting' })` - Deletes a job posting and its applications
+- `factorial_ats({ action: 'delete_candidate' })` - Permanently deletes a candidate
+- `factorial_ats({ action: 'delete_application' })` - Permanently deletes an application
+
+### Document Downloads
+
+Document names come from Factorial metadata rather than from the caller, so downloads treat them as untrusted:
+
+- The name is reduced to a single path segment, so a name containing path separators cannot redirect the download outside `output_dir`.
+- Control characters are dropped and over-long names are shortened, keeping the extension.
+- **Nothing is ever overwritten.** If the target name is already taken, the file is saved as `name (1).ext`, `name (2).ext` and so on. This protects existing files in `output_dir` and stops two documents that share a name from collapsing into one.
+
+Downloads still write wherever you point `output_dir`, so point it at a directory meant for downloads rather than a source tree or your home directory.
 
 ### Read-Only Categories
 
 Some categories are intentionally read-only for security:
 
 - **Payroll**: Supplements, tax identifiers, family situations
-- **Documents**: Folder and document metadata only
+- **Documents**: Folder and document metadata (download tools available for payslips and documents)
 - **Contracts**: Historical contract data
 
-### Response Optimization for Employee Collections
+### Response Optimization
 
-Employee collection tools (`get_employee_documents`, `get_employee_contracts`) return **summary format** by default to prevent token overflow:
+Document and contract list operations return **summary format** by default to prevent token overflow:
 
-**Documents** (`get_employee_documents`):
+**Documents** (`factorial_documents({ action: 'list' })`):
 
-- Returns: `id`, `name`, `folder_id`, `employee_id`, `author_id`, `mime_type`, `size_bytes` (7 fields)
-- Default limit: 20 documents per page
-- For full details: Use `get_document(id)` to retrieve complete document metadata including `file_url`, timestamps, etc.
+- Returns: `id`, `name`, `folder_id`, `employee_id`, `mime_type` (5 fields)
+- Default limit: 100 documents per page
+- For full details: Use `factorial_documents({ action: 'get', id: X })` for complete metadata
 
-**Contracts** (`get_employee_contracts`):
+**Contracts** (`factorial_contracts({ action: 'list' })`):
 
 - Returns: `id`, `employee_id`, `job_title`, `effective_on` (4 fields)
-- Default limit: 20 contracts per page
-- For full details: Timestamps (`created_at`, `updated_at`) excluded from summary
+- Default limit: 100 contracts per page
 
-Both tools accept `page` and `limit` parameters (max: 100) for pagination control.
+All list operations accept `page` and `limit` parameters for pagination control.
 
 ### Audit Logging
 
-All write operations (create, update, delete, approve, reject) are logged with:
+All write operations (create, update, delete, approve, reject) are recorded with:
 
 - Timestamp
 - Operation type
 - Entity type and ID
 - Changes made
+- Success or failure, and duration
+
+**Scope of this log.** The trail is held in memory in the running server process, capped at the most recent 1000 entries, and is not exposed through any tool or resource. It is lost when the process exits. Set `DEBUG=true` to have each entry written to the server's stderr, which is the only way to retain it today. It is a debugging aid, not a compliance record: if you need a durable, queryable audit trail, use FactorialHR's own activity log as the system of record.
 
 ## Development
 
@@ -249,6 +405,42 @@ FACTORIAL_API_KEY=your-key npm start
 npx @modelcontextprotocol/inspector
 ```
 
+### Project Structure
+
+The codebase is organized into domain-based modules for maintainability:
+
+```
+src/
+├── schemas/           # Zod schemas by domain
+│   ├── employees.ts   # Employee, Team, Location, Contract schemas
+│   ├── time-off.ts    # Leave, LeaveType, Allowance, Shift schemas
+│   ├── projects.ts    # Project, Task, Worker, TimeRecord schemas
+│   ├── training.ts    # Training, Session, Membership schemas
+│   ├── ats.ts         # JobPosting, Candidate, Application schemas
+│   └── ...
+├── api/               # API functions by domain
+│   ├── employees.ts   # listEmployees, getEmployee, createEmployee, etc.
+│   ├── time-off.ts    # listLeaves, createLeave, approveLeave, etc.
+│   ├── projects.ts    # listProjects, createProject, etc.
+│   └── ...
+├── tools/             # MCP tool registrations by domain
+│   ├── employees.ts   # factorial_employees tool registration
+│   ├── time-off.ts    # factorial_time_off tool registration
+│   ├── index.ts       # Server setup, discovery tool, resources, prompts
+│   └── ...
+├── index.ts           # Entry point (re-exports from tools/)
+├── api.ts             # Re-exports from api/
+└── schemas.ts         # Re-exports from schemas/
+```
+
+**Adding a new feature:**
+
+1. Add schemas to `src/schemas/{domain}.ts`
+2. Add API functions to `src/api/{domain}.ts`
+3. Add tool actions to `src/tools/{domain}.ts`
+4. Update `src/schemas/index.ts`, `src/api/index.ts` exports if needed
+5. Run `npm test` to verify
+
 ## Troubleshooting
 
 ### API Key Not Working
@@ -271,6 +463,36 @@ The server implements exponential backoff for rate limits. If you're hitting lim
 - **Team membership**: Some employees may not be assigned to teams
 - **Empty responses**: Check if the resource exists in your Factorial account
 
+### Document Downloads Not Working
+
+Document downloads **require OAuth2 authentication**. This is a Factorial API limitation - the download endpoint does not accept API key authentication.
+
+If you see an error like:
+
+> "Document download requires OAuth2 authentication"
+
+You need to set up OAuth2 credentials. See [OAuth2 Setup](#oauth2-setup-required-for-document-downloads) above.
+
+**Note**: OAuth2 refresh tokens expire after 1 week. If downloads suddenly stop working, re-authorize and get a new refresh token.
+
+### "Document with ID X not found" Error
+
+The Factorial API's individual document endpoint (`GET /documents/{id}`) has limitations accessing employee-specific documents. This happens because:
+
+1. `list_documents` with `employee_ids` filter correctly returns all employee documents
+2. `get_document` by ID cannot access those same documents individually
+
+**Workaround**: Use `download_payslips` action instead of `download` action. The `download_payslips` action uses the document metadata from the list operation directly, bypassing the problematic individual GET endpoint:
+
+```typescript
+// This works - uses document list internally
+factorial_documents({
+  action: 'download_payslips',
+  employee_id: 123,
+  output_dir: '/path/to/downloads',
+});
+```
+
 ## FAQ
 
 **Q: Does this expose salary/payroll data?**
@@ -286,7 +508,7 @@ A: Data is cached in-memory with TTLs: employees (5 min), teams (10 min), locati
 A: Version `2025-10-01` by default. Override with `FACTORIAL_API_VERSION` environment variable.
 
 **Q: Are write operations logged?**
-A: Yes, all write operations are logged via the audit module for compliance and debugging.
+A: Yes, every write is recorded by the audit module with a timestamp, entity, changes, and outcome. The log lives in memory in the running process (last 1000 entries) and is not retrievable through the MCP interface, so treat it as a debugging aid rather than a compliance record. See [Audit Logging](#audit-logging).
 
 ## Factorial API Quirks and Limitations
 
@@ -303,12 +525,13 @@ The FactorialHR API has some design patterns that differ from typical REST APIs.
 
 ### Endpoint Quirks
 
-| Endpoint                       | Quirk                                                | Workaround                                     |
-| ------------------------------ | ---------------------------------------------------- | ---------------------------------------------- |
-| `GET /employees/{id}`          | May return 404 for valid employees                   | Server falls back to listing all and filtering |
-| `GET /documents/{id}`          | May return 404 for valid documents                   | Server falls back to listing all and filtering |
-| `GET /contracts?employee_id=X` | Filtering unreliable                                 | Server fetches all and filters client-side     |
-| Empty results                  | Returns `{"errors": null}` instead of `{"data": []}` | Server handles both formats                    |
+| Endpoint                       | Quirk                                               | Workaround                                     |
+| ------------------------------ | --------------------------------------------------- | ---------------------------------------------- |
+| `GET /employees/{id}`          | May return 404 for valid employees                  | Server falls back to listing all and filtering |
+| `GET /documents/{id}`          | May return 404 for employee-specific documents      | Use `download_payslips` which bypasses this    |
+| `GET /contracts?employee_id=X` | Filtering unreliable                                | Server fetches all and filters client-side     |
+| Empty results                  | Returns `{"errors": null}` instead of `{"data": []} | Server handles both formats                    |
+| Document download URLs         | Requires OAuth2 (API key does not work)             | Configure OAuth2 credentials for downloads     |
 
 ### Field Availability
 

package/dist/api/ats.d.ts

@@ -0,0 +1,78 @@
+/**
+ * ATS (Applicant Tracking System) API endpoints
+ */
+import { type PaginatedResponse, type PaginationInput } from '../pagination.js';
+import type { JobPosting, Candidate, Application, HiringStage, CreateJobPostingInput, UpdateJobPostingInput, CreateCandidateInput, UpdateCandidateInput, CreateApplicationInput, UpdateApplicationInput } from '../schemas.js';
+/**
+ * List all job postings
+ */
+export declare function listJobPostings(options?: PaginationInput): Promise<PaginatedResponse<JobPosting>>;
+/**
+ * Get a specific job posting by ID
+ */
+export declare function getJobPosting(id: number): Promise<JobPosting>;
+/**
+ * List all candidates
+ */
+export declare function listCandidates(options?: PaginationInput): Promise<PaginatedResponse<Candidate>>;
+/**
+ * Get a specific candidate by ID
+ */
+export declare function getCandidate(id: number): Promise<Candidate>;
+/**
+ * List all applications
+ */
+export declare function listApplications(jobPostingId?: number, options?: PaginationInput): Promise<PaginatedResponse<Application>>;
+/**
+ * Get a specific application by ID
+ */
+export declare function getApplication(id: number): Promise<Application>;
+/**
+ * List all hiring stages
+ */
+export declare function listHiringStages(): Promise<HiringStage[]>;
+/**
+ * Get a specific hiring stage by ID
+ */
+export declare function getHiringStage(id: number): Promise<HiringStage>;
+/**
+ * Create a job posting
+ */
+export declare function createJobPosting(input: CreateJobPostingInput): Promise<JobPosting>;
+/**
+ * Update a job posting
+ */
+export declare function updateJobPosting(id: number, input: UpdateJobPostingInput): Promise<JobPosting>;
+/**
+ * Delete a job posting
+ */
+export declare function deleteJobPosting(id: number): Promise<void>;
+/**
+ * Create a candidate
+ */
+export declare function createCandidate(input: CreateCandidateInput): Promise<Candidate>;
+/**
+ * Update a candidate
+ */
+export declare function updateCandidate(id: number, input: UpdateCandidateInput): Promise<Candidate>;
+/**
+ * Delete a candidate
+ */
+export declare function deleteCandidate(id: number): Promise<void>;
+/**
+ * Create an application
+ */
+export declare function createApplication(input: CreateApplicationInput): Promise<Application>;
+/**
+ * Update an application
+ */
+export declare function updateApplication(id: number, input: UpdateApplicationInput): Promise<Application>;
+/**
+ * Delete an application
+ */
+export declare function deleteApplication(id: number): Promise<void>;
+/**
+ * Advance an application to the next stage
+ */
+export declare function advanceApplication(id: number): Promise<Application>;
+//# sourceMappingURL=ats.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ats.d.ts","sourceRoot":"","sources":["../../src/api/ats.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACV,UAAU,EACV,SAAS,EACT,WAAW,EACX,WAAW,EACX,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,eAAe,CAAC;AASvB;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC,CAQxC;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAOnE;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAIvC;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAGjE;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,YAAY,CAAC,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC,CASzC;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAGrE;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAM/D;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAGrE;AAMD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC,CAMxF;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,UAAU,CAAC,CASrB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQhE;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,CAAC,CAIrF;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,CAAC,CAMjG;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM/D;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,WAAW,CAAC,CAI3F;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,WAAW,CAAC,CAMtB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMjE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAMzE"}