@t4dhg/mcp-factorial 1.0.0 → 2.0.0

package/dist/cache.js

@@ -0,0 +1,169 @@
+/**
+ * Simple in-memory TTL cache for MCP FactorialHR
+ *
+ * Reduces API calls by caching frequently accessed data.
+ */
+import { debug } from './config.js';
+/**
+ * TTL values for different resource types (in milliseconds)
+ */
+export const CACHE_TTL = {
+    employees: 5 * 60 * 1000, // 5 minutes
+    teams: 10 * 60 * 1000, // 10 minutes
+    locations: 15 * 60 * 1000, // 15 minutes
+    contracts: 3 * 60 * 1000, // 3 minutes
+    leaves: 2 * 60 * 1000, // 2 minutes
+    shifts: 1 * 60 * 1000, // 1 minute
+    default: 5 * 60 * 1000, // 5 minutes default
+};
+/**
+ * Simple TTL-based cache manager
+ */
+export class CacheManager {
+    cache = new Map();
+    cleanupInterval = null;
+    constructor() {
+        // Run cleanup every minute
+        this.cleanupInterval = setInterval(() => this.cleanup(), 60000);
+    }
+    /**
+     * Generate a cache key from resource type and parameters
+     */
+    static key(resource, params) {
+        if (!params || Object.keys(params).length === 0) {
+            return resource;
+        }
+        // Sort params for consistent key generation
+        const record = params;
+        const sortedParams = Object.keys(record)
+            .sort()
+            .filter(k => record[k] !== undefined)
+            .map(k => `${k}=${JSON.stringify(record[k])}`)
+            .join('&');
+        return `${resource}:${sortedParams}`;
+    }
+    /**
+     * Get a value from the cache
+     * @returns The cached value or undefined if not found/expired
+     */
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            return undefined;
+        }
+        if (Date.now() > entry.expiresAt) {
+            this.cache.delete(key);
+            debug(`Cache miss (expired): ${key}`);
+            return undefined;
+        }
+        debug(`Cache hit: ${key}`);
+        return entry.data;
+    }
+    /**
+     * Set a value in the cache
+     * @param key - Cache key
+     * @param data - Data to cache
+     * @param ttlMs - Time to live in milliseconds
+     */
+    set(key, data, ttlMs = CACHE_TTL.default) {
+        this.cache.set(key, {
+            data,
+            expiresAt: Date.now() + ttlMs,
+        });
+        debug(`Cache set: ${key} (TTL: ${ttlMs}ms)`);
+    }
+    /**
+     * Invalidate a specific cache entry
+     */
+    invalidate(key) {
+        const deleted = this.cache.delete(key);
+        if (deleted) {
+            debug(`Cache invalidated: ${key}`);
+        }
+        return deleted;
+    }
+    /**
+     * Invalidate all cache entries matching a prefix
+     */
+    invalidatePrefix(prefix) {
+        let count = 0;
+        for (const key of this.cache.keys()) {
+            if (key.startsWith(prefix)) {
+                this.cache.delete(key);
+                count++;
+            }
+        }
+        if (count > 0) {
+            debug(`Cache invalidated ${count} entries with prefix: ${prefix}`);
+        }
+        return count;
+    }
+    /**
+     * Clear all cache entries
+     */
+    clear() {
+        const size = this.cache.size;
+        this.cache.clear();
+        debug(`Cache cleared (${size} entries)`);
+    }
+    /**
+     * Get cache statistics
+     */
+    stats() {
+        return {
+            size: this.cache.size,
+            keys: Array.from(this.cache.keys()),
+        };
+    }
+    /**
+     * Remove expired entries
+     */
+    cleanup() {
+        const now = Date.now();
+        let removed = 0;
+        for (const [key, entry] of this.cache.entries()) {
+            if (now > entry.expiresAt) {
+                this.cache.delete(key);
+                removed++;
+            }
+        }
+        if (removed > 0) {
+            debug(`Cache cleanup: removed ${removed} expired entries`);
+        }
+    }
+    /**
+     * Stop the cleanup interval (for testing/cleanup)
+     */
+    destroy() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = null;
+        }
+    }
+}
+/**
+ * Global cache instance
+ */
+export const cache = new CacheManager();
+/**
+ * Helper to get cached data or fetch it
+ * @param key - Cache key
+ * @param fetcher - Function to fetch data if not cached
+ * @param ttlMs - Time to live in milliseconds
+ */
+export async function cached(key, fetcher, ttlMs = CACHE_TTL.default) {
+    const cachedValue = cache.get(key);
+    if (cachedValue !== undefined) {
+        return cachedValue;
+    }
+    const data = await fetcher();
+    cache.set(key, data, ttlMs);
+    return data;
+}
+/**
+ * Get the TTL for a resource type
+ */
+export function getTTL(resourceType) {
+    return CACHE_TTL[resourceType] ?? CACHE_TTL.default;
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAUpC;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,YAAY;IACtC,KAAK,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,aAAa;IACpC,SAAS,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,aAAa;IACxC,SAAS,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,YAAY;IACtC,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,YAAY;IACnC,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,WAAW;IAClC,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,oBAAoB;CACpC,CAAC;AAOX;;GAEG;AACH,MAAM,OAAO,YAAY;IACf,KAAK,GAAG,IAAI,GAAG,EAA+B,CAAC;IAC/C,eAAe,GAA0C,IAAI,CAAC;IAEtE;QACE,2BAA2B;QAC3B,IAAI,CAAC,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,QAAgB,EAAE,MAAe;QAC1C,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChD,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,4CAA4C;QAC5C,MAAM,MAAM,GAAG,MAAiC,CAAC;QACjD,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;aACrC,IAAI,EAAE;aACN,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC;aACpC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;aAC7C,IAAI,CAAC,GAAG,CAAC,CAAC;QACb,OAAO,GAAG,QAAQ,IAAI,YAAY,EAAE,CAAC;IACvC,CAAC;IAED;;;OAGG;IACH,GAAG,CAAI,GAAW;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,KAAK,CAAC,yBAAyB,GAAG,EAAE,CAAC,CAAC;YACtC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,KAAK,CAAC,cAAc,GAAG,EAAE,CAAC,CAAC;QAC3B,OAAO,KAAK,CAAC,IAAS,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAI,GAAW,EAAE,IAAO,EAAE,QAAgB,SAAS,CAAC,OAAO;QAC5D,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;YAClB,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;SAC9B,CAAC,CAAC;QACH,KAAK,CAAC,cAAc,GAAG,UAAU,KAAK,KAAK,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,GAAW;QACpB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,CAAC,sBAAsB,GAAG,EAAE,CAAC,CAAC;QACrC,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,MAAc;QAC7B,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YACpC,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACvB,KAAK,EAAE,CAAC;YACV,CAAC;QACH,CAAC;QACD,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,KAAK,CAAC,qBAAqB,KAAK,yBAAyB,MAAM,EAAE,CAAC,CAAC;QACrE,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,KAAK;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,KAAK,CAAC,kBAAkB,IAAI,WAAW,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,KAAK;QACH,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;YACrB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SACpC,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,OAAO;QACb,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAChD,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;gBAC1B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACvB,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;QACD,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YAChB,KAAK,CAAC,0BAA0B,OAAO,kBAAkB,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED;;OAEG;IACH,OAAO;QACL,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,aAAa,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YACpC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAC9B,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,YAAY,EAAE,CAAC;AAExC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,GAAW,EACX,OAAyB,EACzB,QAAgB,SAAS,CAAC,OAAO;IAEjC,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAAI,GAAG,CAAC,CAAC;IACtC,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,OAAO,EAAE,CAAC;IAC7B,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAC5B,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,YAA0B;IAC/C,OAAO,SAAS,CAAC,YAAY,CAAC,IAAI,SAAS,CAAC,OAAO,CAAC;AACtD,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Configuration management for MCP FactorialHR
+ *
+ * Centralizes all configuration options and environment variable handling.
+ */
+/**
+ * Configuration interface for FactorialHR API client
+ */
+export interface FactorialConfig {
+    /** FactorialHR API key (required) */
+    apiKey: string;
+    /** API version (e.g., '2025-10-01') */
+    apiVersion: string;
+    /** Base URL for the Factorial API */
+    baseUrl: string;
+    /** Request timeout in milliseconds */
+    timeout: number;
+    /** Maximum number of retry attempts */
+    maxRetries: number;
+    /** Enable debug logging */
+    debug: boolean;
+}
+/**
+ * Load environment variables from .env file with priority:
+ * 1. ENV_FILE_PATH environment variable
+ * 2. Current working directory .env
+ * 3. Home directory .env
+ * 4. Common project locations
+ * 5. Default dotenv behavior
+ */
+export declare function loadEnv(): void;
+/**
+ * Get the Factorial API key from environment variables
+ * @throws Error if API key is not set
+ */
+export declare function getApiKey(): string;
+/**
+ * Get the API version from environment or default
+ */
+export declare function getApiVersion(): string;
+/**
+ * Get the base URL for the Factorial API
+ */
+export declare function getBaseUrl(): string;
+/**
+ * Get the complete configuration object
+ */
+export declare function getConfig(): FactorialConfig;
+/**
+ * Check if debug mode is enabled
+ */
+export declare function isDebugEnabled(): boolean;
+/**
+ * Debug logger - only logs when DEBUG=true
+ */
+export declare function debug(message: string, data?: unknown): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,KAAK,EAAE,OAAO,CAAC;CAChB;AAOD;;;;;;;GAOG;AACH,wBAAgB,OAAO,IAAI,IAAI,CAkC9B;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAUlC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAKnC;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,eAAe,CAS3C;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAS3D"}

package/dist/config.js

@@ -0,0 +1,112 @@
+/**
+ * Configuration management for MCP FactorialHR
+ *
+ * Centralizes all configuration options and environment variable handling.
+ */
+import { config } from 'dotenv';
+import { existsSync } from 'fs';
+import { join } from 'path';
+// Default configuration values
+const DEFAULT_API_VERSION = '2025-10-01';
+const DEFAULT_TIMEOUT = 30000; // 30 seconds
+const DEFAULT_MAX_RETRIES = 3;
+/**
+ * Load environment variables from .env file with priority:
+ * 1. ENV_FILE_PATH environment variable
+ * 2. Current working directory .env
+ * 3. Home directory .env
+ * 4. Common project locations
+ * 5. Default dotenv behavior
+ */
+export function loadEnv() {
+    // 1. Check if explicit path provided
+    if (process.env.ENV_FILE_PATH && existsSync(process.env.ENV_FILE_PATH)) {
+        config({ path: process.env.ENV_FILE_PATH });
+        return;
+    }
+    // 2. Check current working directory
+    const cwdEnv = join(process.cwd(), '.env');
+    if (existsSync(cwdEnv)) {
+        config({ path: cwdEnv });
+        return;
+    }
+    // 3. Check home directory
+    const homeDir = process.env.HOME || process.env.USERPROFILE || '';
+    const homeEnv = join(homeDir, '.env');
+    if (existsSync(homeEnv)) {
+        config({ path: homeEnv });
+        return;
+    }
+    // 4. Check common project locations
+    const commonPaths = [join(homeDir, 'turborepo', '.env'), join(homeDir, 'projects', '.env')];
+    for (const envPath of commonPaths) {
+        if (existsSync(envPath)) {
+            config({ path: envPath });
+            return;
+        }
+    }
+    // Fall back to default dotenv behavior
+    config();
+}
+/**
+ * Get the Factorial API key from environment variables
+ * @throws Error if API key is not set
+ */
+export 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;
+}
+/**
+ * Get the API version from environment or default
+ */
+export function getApiVersion() {
+    return process.env.FACTORIAL_API_VERSION || DEFAULT_API_VERSION;
+}
+/**
+ * Get the base URL for the Factorial API
+ */
+export function getBaseUrl() {
+    if (process.env.FACTORIAL_BASE_URL) {
+        return process.env.FACTORIAL_BASE_URL;
+    }
+    return `https://api.factorialhr.com/api/${getApiVersion()}/resources`;
+}
+/**
+ * Get the complete configuration object
+ */
+export function getConfig() {
+    return {
+        apiKey: getApiKey(),
+        apiVersion: getApiVersion(),
+        baseUrl: getBaseUrl(),
+        timeout: parseInt(process.env.FACTORIAL_TIMEOUT_MS || String(DEFAULT_TIMEOUT), 10),
+        maxRetries: parseInt(process.env.FACTORIAL_MAX_RETRIES || String(DEFAULT_MAX_RETRIES), 10),
+        debug: process.env.DEBUG === 'true',
+    };
+}
+/**
+ * Check if debug mode is enabled
+ */
+export function isDebugEnabled() {
+    return process.env.DEBUG === 'true';
+}
+/**
+ * Debug logger - only logs when DEBUG=true
+ */
+export function debug(message, data) {
+    if (isDebugEnabled()) {
+        const timestamp = new Date().toISOString();
+        if (data !== undefined) {
+            console.error(`[${timestamp}] [mcp-factorial] ${message}`, JSON.stringify(data, null, 2));
+        }
+        else {
+            console.error(`[${timestamp}] [mcp-factorial] ${message}`);
+        }
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Structured error types for MCP FactorialHR
+ *
+ * Provides a clear error hierarchy for better error handling and user messages.
+ */
+/**
+ * Base error class for all Factorial-related errors
+ */
+export declare class FactorialError extends Error {
+    readonly isRetryable: boolean;
+    readonly context?: Record<string, unknown>;
+    constructor(message: string, options?: {
+        isRetryable?: boolean;
+        context?: Record<string, unknown>;
+        cause?: Error;
+    });
+}
+/**
+ * HTTP-related errors with status code
+ */
+export declare class HttpError extends FactorialError {
+    readonly statusCode: number;
+    readonly endpoint: string;
+    constructor(statusCode: number, endpoint: string, message: string, options?: {
+        isRetryable?: boolean;
+        context?: Record<string, unknown>;
+    });
+}
+/**
+ * Authentication error (401)
+ */
+export declare class AuthenticationError extends HttpError {
+    constructor(endpoint: string, context?: Record<string, unknown>);
+}
+/**
+ * Authorization error (403)
+ */
+export declare class AuthorizationError extends HttpError {
+    constructor(endpoint: string, context?: Record<string, unknown>);
+}
+/**
+ * Resource not found error (404)
+ */
+export declare class NotFoundError extends HttpError {
+    constructor(endpoint: string, context?: Record<string, unknown>);
+}
+/**
+ * Rate limit error (429)
+ */
+export declare class RateLimitError extends HttpError {
+    readonly retryAfter?: number;
+    constructor(endpoint: string, retryAfter?: number, context?: Record<string, unknown>);
+}
+/**
+ * Validation error (400)
+ */
+export declare class ValidationError extends HttpError {
+    constructor(endpoint: string, message: string, context?: Record<string, unknown>);
+}
+/**
+ * Server error (5xx)
+ */
+export declare class ServerError extends HttpError {
+    constructor(statusCode: number, endpoint: string, message?: string, context?: Record<string, unknown>);
+}
+/**
+ * Request timeout error
+ */
+export declare class TimeoutError extends FactorialError {
+    readonly timeoutMs: number;
+    constructor(timeoutMs: number, endpoint?: string);
+}
+/**
+ * Network error (connection issues)
+ */
+export declare class NetworkError extends FactorialError {
+    constructor(message: string, cause?: Error);
+}
+/**
+ * Configuration error
+ */
+export declare class ConfigurationError extends FactorialError {
+    constructor(message: string);
+}
+/**
+ * Schema validation error (response doesn't match expected format)
+ */
+export declare class SchemaValidationError extends FactorialError {
+    readonly schemaName: string;
+    constructor(schemaName: string, message: string, context?: Record<string, unknown>);
+}
+/**
+ * Determine if an error is retryable
+ */
+export declare function isRetryableError(error: unknown): boolean;
+/**
+ * Get a user-friendly error message from any error
+ */
+export declare function getUserMessage(error: unknown): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,SAAgB,WAAW,EAAE,OAAO,CAAC;IACrC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAGhD,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,KAAK,CAAC,EAAE,KAAK,CAAC;KACf;CAUJ;AAED;;GAEG;AACH,qBAAa,SAAU,SAAQ,cAAc;IAC3C,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,QAAQ,EAAE,MAAM,CAAC;gBAG/B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC;CAOJ;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,SAAS;gBACpC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOhE;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,SAAS;gBACnC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAYhE;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,SAAS;gBAC9B,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAYhE;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,SAAS;IAC3C,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAExB,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAYrF;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,SAAS;gBAChC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOjF;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,SAAS;gBAEtC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAapC;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,cAAc;IAC9C,SAAgB,SAAS,EAAE,MAAM,CAAC;gBAEtB,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;CAQjD;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,cAAc;gBAClC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAO3C;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,cAAc;gBACxC,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,cAAc;IACvD,SAAgB,UAAU,EAAE,MAAM,CAAC;gBAEvB,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQnF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CASxD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQrD"}

package/dist/errors.js

@@ -0,0 +1,186 @@
+/**
+ * Structured error types for MCP FactorialHR
+ *
+ * Provides a clear error hierarchy for better error handling and user messages.
+ */
+/**
+ * Base error class for all Factorial-related errors
+ */
+export class FactorialError extends Error {
+    isRetryable;
+    context;
+    constructor(message, options) {
+        super(message);
+        this.name = 'FactorialError';
+        this.isRetryable = options?.isRetryable ?? false;
+        this.context = options?.context;
+        if (options?.cause) {
+            this.cause = options.cause;
+        }
+    }
+}
+/**
+ * HTTP-related errors with status code
+ */
+export class HttpError extends FactorialError {
+    statusCode;
+    endpoint;
+    constructor(statusCode, endpoint, message, options) {
+        super(message, options);
+        this.name = 'HttpError';
+        this.statusCode = statusCode;
+        this.endpoint = endpoint;
+    }
+}
+/**
+ * Authentication error (401)
+ */
+export class AuthenticationError extends HttpError {
+    constructor(endpoint, context) {
+        super(401, endpoint, 'Invalid API key. Please check your FACTORIAL_API_KEY.', {
+            isRetryable: false,
+            context,
+        });
+        this.name = 'AuthenticationError';
+    }
+}
+/**
+ * Authorization error (403)
+ */
+export class AuthorizationError extends HttpError {
+    constructor(endpoint, context) {
+        super(403, endpoint, 'Access denied. Your API key may not have permission for this operation.', {
+            isRetryable: false,
+            context,
+        });
+        this.name = 'AuthorizationError';
+    }
+}
+/**
+ * Resource not found error (404)
+ */
+export class NotFoundError extends HttpError {
+    constructor(endpoint, context) {
+        super(404, endpoint, 'Resource not found. The requested employee, team, or location may not exist.', {
+            isRetryable: false,
+            context,
+        });
+        this.name = 'NotFoundError';
+    }
+}
+/**
+ * Rate limit error (429)
+ */
+export class RateLimitError extends HttpError {
+    retryAfter;
+    constructor(endpoint, retryAfter, context) {
+        const message = retryAfter
+            ? `Rate limit exceeded. Please wait ${retryAfter} seconds before trying again.`
+            : 'Rate limit exceeded. Please wait a moment before trying again.';
+        super(429, endpoint, message, {
+            isRetryable: true,
+            context,
+        });
+        this.name = 'RateLimitError';
+        this.retryAfter = retryAfter;
+    }
+}
+/**
+ * Validation error (400)
+ */
+export class ValidationError extends HttpError {
+    constructor(endpoint, message, context) {
+        super(400, endpoint, message, {
+            isRetryable: false,
+            context,
+        });
+        this.name = 'ValidationError';
+    }
+}
+/**
+ * Server error (5xx)
+ */
+export class ServerError extends HttpError {
+    constructor(statusCode, endpoint, message, context) {
+        super(statusCode, endpoint, message || `Server error (${statusCode}). Please try again later.`, {
+            isRetryable: true,
+            context,
+        });
+        this.name = 'ServerError';
+    }
+}
+/**
+ * Request timeout error
+ */
+export class TimeoutError extends FactorialError {
+    timeoutMs;
+    constructor(timeoutMs, endpoint) {
+        super(`Request timed out after ${timeoutMs / 1000} seconds. Please try again.`, {
+            isRetryable: true,
+            context: { endpoint, timeoutMs },
+        });
+        this.name = 'TimeoutError';
+        this.timeoutMs = timeoutMs;
+    }
+}
+/**
+ * Network error (connection issues)
+ */
+export class NetworkError extends FactorialError {
+    constructor(message, cause) {
+        super(message, {
+            isRetryable: true,
+            cause,
+        });
+        this.name = 'NetworkError';
+    }
+}
+/**
+ * Configuration error
+ */
+export class ConfigurationError extends FactorialError {
+    constructor(message) {
+        super(message, { isRetryable: false });
+        this.name = 'ConfigurationError';
+    }
+}
+/**
+ * Schema validation error (response doesn't match expected format)
+ */
+export class SchemaValidationError extends FactorialError {
+    schemaName;
+    constructor(schemaName, message, context) {
+        super(`API response validation failed for ${schemaName}: ${message}`, {
+            isRetryable: false,
+            context,
+        });
+        this.name = 'SchemaValidationError';
+        this.schemaName = schemaName;
+    }
+}
+/**
+ * Determine if an error is retryable
+ */
+export function isRetryableError(error) {
+    if (error instanceof FactorialError) {
+        return error.isRetryable;
+    }
+    // Network errors are generally retryable
+    if (error instanceof Error && error.name === 'AbortError') {
+        return true;
+    }
+    return false;
+}
+/**
+ * Get a user-friendly error message from any error
+ */
+export function getUserMessage(error) {
+    if (error instanceof FactorialError) {
+        return error.message;
+    }
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return 'An unexpected error occurred';
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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