@goodsamsoftware/freshbooks-mcp 1.0.0

package/dist/auth/token-store.js.map

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

package/dist/auth/types.d.ts

@@ -0,0 +1,76 @@
+/**
+ * FreshBooks OAuth2 Authentication Types
+ *
+ * Type definitions for OAuth configuration, token management, and authentication status.
+ */
+/**
+ * OAuth2 configuration for FreshBooks API
+ */
+export interface OAuthConfig {
+    /** OAuth2 client ID from FreshBooks app registration */
+    clientId: string;
+    /** OAuth2 client secret from FreshBooks app registration */
+    clientSecret: string;
+    /** OAuth2 redirect URI (must match registered URI) */
+    redirectUri: string;
+    /** OAuth2 scopes (optional, FreshBooks uses default scopes) */
+    scopes?: string[];
+}
+/**
+ * OAuth2 token data stored and managed by the token store
+ */
+export interface TokenData {
+    /** Access token for API requests */
+    accessToken: string;
+    /** Refresh token for obtaining new access tokens */
+    refreshToken: string;
+    /** Unix timestamp when the access token expires */
+    expiresAt: number;
+    /** Token type (typically "Bearer") */
+    tokenType: string;
+    /** Active FreshBooks account ID (if selected) */
+    accountId?: string;
+    /** Active FreshBooks business ID (if selected) */
+    businessId?: number;
+}
+/**
+ * Authentication status information
+ */
+export interface AuthStatus {
+    /** Whether currently authenticated with valid token */
+    authenticated: boolean;
+    /** Seconds until token expires (if authenticated) */
+    expiresIn?: number;
+    /** Active account ID (if authenticated) */
+    accountId?: string;
+    /** Active business ID (if authenticated) */
+    businessId?: number;
+    /** Reason for not being authenticated (if not authenticated) */
+    reason?: 'no_token' | 'token_expired' | 'invalid_token';
+    /** Whether a refresh token is available to restore session */
+    canRefresh?: boolean;
+}
+/**
+ * OAuth error codes
+ */
+export type OAuthErrorCode = 'not_authenticated' | 'token_exchange_failed' | 'refresh_failed' | 'invalid_grant' | 'invalid_client' | 'invalid_request' | 'unauthorized_client' | 'unsupported_grant_type' | 'no_refresh_token' | 'session_expired';
+/**
+ * OAuth-specific error class
+ */
+export declare class OAuthError extends Error {
+    readonly code: OAuthErrorCode;
+    readonly details?: any | undefined;
+    constructor(code: OAuthErrorCode, message: string, details?: any | undefined);
+}
+/**
+ * Token store interface for persisting OAuth tokens
+ */
+export interface TokenStore {
+    /** Retrieve stored token data */
+    get(): Promise<TokenData | null>;
+    /** Save token data */
+    save(token: TokenData): Promise<void>;
+    /** Clear all stored tokens */
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/auth/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/auth/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IAEjB,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAC;IAErB,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IAEpB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IAEpB,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAC;IAErB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAElB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAElB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,aAAa,EAAE,OAAO,CAAC;IAEvB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,gEAAgE;IAChE,MAAM,CAAC,EAAE,UAAU,GAAG,eAAe,GAAG,eAAe,CAAC;IAExD,8DAA8D;IAC9D,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,mBAAmB,GACnB,uBAAuB,GACvB,gBAAgB,GAChB,eAAe,GACf,gBAAgB,GAChB,iBAAiB,GACjB,qBAAqB,GACrB,wBAAwB,GACxB,kBAAkB,GAClB,iBAAiB,CAAC;AAEtB;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;aAEjB,IAAI,EAAE,cAAc;aAEpB,OAAO,CAAC,EAAE,GAAG;gBAFb,IAAI,EAAE,cAAc,EACpC,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,GAAG,YAAA;CAMhC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,iCAAiC;IACjC,GAAG,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAEjC,sBAAsB;IACtB,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtC,8BAA8B;IAC9B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}

package/dist/auth/types.js

@@ -0,0 +1,20 @@
+/**
+ * FreshBooks OAuth2 Authentication Types
+ *
+ * Type definitions for OAuth configuration, token management, and authentication status.
+ */
+/**
+ * OAuth-specific error class
+ */
+export class OAuthError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'OAuthError';
+        Object.setPrototypeOf(this, OAuthError.prototype);
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/auth/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/auth/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAgFH;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,KAAK;IAEjB;IAEA;IAHlB,YACkB,IAAoB,EACpC,OAAe,EACC,OAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAgB;QAEpB,YAAO,GAAP,OAAO,CAAM;QAG7B,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF"}

package/dist/client/freshbooks-client.d.ts

@@ -0,0 +1,99 @@
+/**
+ * FreshBooks Client Wrapper
+ *
+ * Wraps the FreshBooks SDK with:
+ * - Automatic token refresh
+ * - Error normalization to MCP format
+ * - Rate limiting with exponential backoff
+ * - Request logging
+ * - Raw HTTP access for unsupported SDK operations (timers)
+ */
+import FreshBooksApi from '@freshbooks/api';
+declare const Client: typeof FreshBooksApi.Client;
+type Client = InstanceType<typeof Client>;
+import { FreshBooksOAuth } from '../auth/oauth.js';
+/**
+ * Raw HTTP response type
+ */
+export interface RawHttpResponse<T = unknown> {
+    ok: boolean;
+    status: number;
+    data?: T;
+    error?: Error;
+}
+/**
+ * HTTP method types
+ */
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE';
+/**
+ * Wrapper around FreshBooks SDK Client
+ *
+ * Provides automatic token refresh, error handling, and logging.
+ */
+export declare class FreshBooksClientWrapper {
+    private oauth;
+    private client;
+    private currentAccountId;
+    private static readonly MAX_RETRIES;
+    private static readonly BASE_BACKOFF_MS;
+    constructor(oauth: FreshBooksOAuth);
+    /**
+     * Get or create FreshBooks client with valid token
+     */
+    private getClient;
+    /**
+     * Execute an API call with automatic retry and error handling
+     *
+     * @param operation Name of the operation for logging
+     * @param apiCall Function that makes the API call
+     * @returns API response
+     */
+    executeWithRetry<T>(operation: string, apiCall: (client: Client) => Promise<T>): Promise<T>;
+    /**
+     * Set the active account ID for API calls
+     */
+    setAccountId(accountId: string): void;
+    /**
+     * Get the current account ID
+     */
+    getAccountId(): string | null;
+    /**
+     * Normalize API errors to MCP format
+     */
+    private normalizeError;
+    /**
+     * Determine if an error should be retried
+     */
+    private shouldRetry;
+    /**
+     * Sleep for specified milliseconds
+     */
+    private sleep;
+    /**
+     * Generate unique request ID for tracking
+     */
+    private generateRequestId;
+    /**
+     * Access the underlying FreshBooks client
+     * Use with caution - prefer executeWithRetry for automatic error handling
+     */
+    getUnderlyingClient(): Promise<Client>;
+    /**
+     * Execute a raw HTTP request to FreshBooks API
+     *
+     * Used for endpoints not supported by the SDK (e.g., /comments/business/.../timers)
+     * The SDK uses /timetracking/business/... but timer operations require /comments/business/...
+     *
+     * @param method HTTP method
+     * @param path API path (e.g., '/comments/business/123/timers')
+     * @param body Optional request body
+     * @param operation Operation name for logging
+     */
+    executeRawRequest<T = unknown>(method: HttpMethod, path: string, body?: Record<string, unknown>, operation?: string): Promise<RawHttpResponse<T>>;
+    /**
+     * Execute raw HTTP with retry logic
+     */
+    executeRawWithRetry<T = unknown>(method: HttpMethod, path: string, body?: Record<string, unknown>, operation?: string): Promise<RawHttpResponse<T>>;
+}
+export {};
+//# sourceMappingURL=freshbooks-client.d.ts.map

package/dist/client/freshbooks-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"freshbooks-client.d.ts","sourceRoot":"","sources":["../../src/client/freshbooks-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,aAAa,MAAM,iBAAiB,CAAC;AAC5C,QAAA,MAAQ,MAAM,6BAAkB,CAAC;AACjC,KAAK,MAAM,GAAG,YAAY,CAAC,OAAO,MAAM,CAAC,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAKnD;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE3D;;;;GAIG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,gBAAgB,CAAuB;IAG/C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAK;IACxC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAQ;gBAEnC,KAAK,EAAE,eAAe;IAIlC;;OAEG;YACW,SAAS;IAoBvB;;;;;;OAMG;IACG,gBAAgB,CAAC,CAAC,EACtB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GACtC,OAAO,CAAC,CAAC,CAAC;IAyDb;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKrC;;OAEG;IACH,YAAY,IAAI,MAAM,GAAG,IAAI;IAI7B;;OAEG;IACH,OAAO,CAAC,cAAc;IAatB;;OAEG;IACH,OAAO,CAAC,WAAW;IAsBnB;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;;OAGG;IACG,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC;IAI5C;;;;;;;;;;OAUG;IACG,iBAAiB,CAAC,CAAC,GAAG,OAAO,EACjC,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,SAAS,GAAE,MAAqB,GAC/B,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAgF9B;;OAEG;IACG,mBAAmB,CAAC,CAAC,GAAG,OAAO,EACnC,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,SAAS,GAAE,MAAqB,GAC/B,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;CAgC/B"}

package/dist/client/freshbooks-client.js

@@ -0,0 +1,283 @@
+/**
+ * FreshBooks Client Wrapper
+ *
+ * Wraps the FreshBooks SDK with:
+ * - Automatic token refresh
+ * - Error normalization to MCP format
+ * - Rate limiting with exponential backoff
+ * - Request logging
+ * - Raw HTTP access for unsupported SDK operations (timers)
+ */
+import FreshBooksApi from '@freshbooks/api';
+const { Client } = FreshBooksApi;
+import { handleError, MCPErrorCode } from '../errors/index.js';
+import { logger } from '../utils/logger.js';
+/**
+ * Wrapper around FreshBooks SDK Client
+ *
+ * Provides automatic token refresh, error handling, and logging.
+ */
+export class FreshBooksClientWrapper {
+    oauth;
+    client = null;
+    currentAccountId = null;
+    // Rate limiting configuration
+    static MAX_RETRIES = 3;
+    static BASE_BACKOFF_MS = 1000;
+    constructor(oauth) {
+        this.oauth = oauth;
+    }
+    /**
+     * Get or create FreshBooks client with valid token
+     */
+    async getClient() {
+        try {
+            // Get valid access token (auto-refreshes if needed)
+            const accessToken = await this.oauth.getValidToken();
+            // Always create a new client instance with the current token
+            // The FreshBooks SDK requires the token to be provided at construction
+            this.client = new Client(accessToken, {
+                apiUrl: 'https://api.freshbooks.com',
+            });
+            logger.debug('Created new FreshBooks client');
+            return this.client;
+        }
+        catch (error) {
+            logger.error('Failed to get FreshBooks client', error);
+            throw handleError(error, { operation: 'getClient' });
+        }
+    }
+    /**
+     * Execute an API call with automatic retry and error handling
+     *
+     * @param operation Name of the operation for logging
+     * @param apiCall Function that makes the API call
+     * @returns API response
+     */
+    async executeWithRetry(operation, apiCall) {
+        let lastError;
+        const requestId = this.generateRequestId();
+        for (let attempt = 1; attempt <= FreshBooksClientWrapper.MAX_RETRIES; attempt++) {
+            try {
+                logger.debug(`Executing ${operation}`, {
+                    requestId,
+                    attempt,
+                    accountId: this.currentAccountId,
+                });
+                const startTime = Date.now();
+                const client = await this.getClient();
+                const result = await apiCall(client);
+                const duration = Date.now() - startTime;
+                logger.info(`${operation} completed`, {
+                    requestId,
+                    duration,
+                    attempt,
+                });
+                return result;
+            }
+            catch (error) {
+                lastError = error;
+                // Check if error is recoverable and should be retried
+                const mcpError = this.normalizeError(error, operation, requestId);
+                const shouldRetry = this.shouldRetry(mcpError, attempt);
+                logger.warn(`${operation} failed`, {
+                    requestId,
+                    attempt,
+                    errorCode: mcpError.code,
+                    recoverable: mcpError.data.recoverable,
+                    willRetry: shouldRetry,
+                });
+                if (!shouldRetry) {
+                    throw mcpError;
+                }
+                // Exponential backoff before retry
+                const backoffMs = FreshBooksClientWrapper.BASE_BACKOFF_MS * Math.pow(2, attempt - 1);
+                await this.sleep(backoffMs);
+            }
+        }
+        // All retries exhausted
+        logger.error(`${operation} failed after ${FreshBooksClientWrapper.MAX_RETRIES} attempts`, lastError, {
+            requestId,
+        });
+        throw this.normalizeError(lastError, operation, requestId);
+    }
+    /**
+     * Set the active account ID for API calls
+     */
+    setAccountId(accountId) {
+        this.currentAccountId = accountId;
+        logger.debug('Set active account', { accountId });
+    }
+    /**
+     * Get the current account ID
+     */
+    getAccountId() {
+        return this.currentAccountId;
+    }
+    /**
+     * Normalize API errors to MCP format
+     */
+    normalizeError(error, operation, requestId) {
+        const context = {
+            operation,
+            requestId,
+        };
+        if (this.currentAccountId !== null) {
+            context.accountId = this.currentAccountId;
+        }
+        return handleError(error, context);
+    }
+    /**
+     * Determine if an error should be retried
+     */
+    shouldRetry(error, attempt) {
+        // Don't retry if we've exhausted attempts
+        if (attempt >= FreshBooksClientWrapper.MAX_RETRIES) {
+            return false;
+        }
+        // Only retry recoverable errors
+        if (!error.data.recoverable) {
+            return false;
+        }
+        // Retry rate limit and network errors
+        const retryableCodes = [
+            MCPErrorCode.RATE_LIMITED,
+            MCPErrorCode.NETWORK_ERROR,
+            MCPErrorCode.TIMEOUT,
+            MCPErrorCode.SERVICE_UNAVAILABLE,
+        ];
+        return retryableCodes.includes(error.code);
+    }
+    /**
+     * Sleep for specified milliseconds
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /**
+     * Generate unique request ID for tracking
+     */
+    generateRequestId() {
+        const timestamp = Date.now().toString(36);
+        const random = Math.random().toString(36).substring(2, 8);
+        return `req_${timestamp}_${random}`;
+    }
+    /**
+     * Access the underlying FreshBooks client
+     * Use with caution - prefer executeWithRetry for automatic error handling
+     */
+    async getUnderlyingClient() {
+        return this.getClient();
+    }
+    /**
+     * Execute a raw HTTP request to FreshBooks API
+     *
+     * Used for endpoints not supported by the SDK (e.g., /comments/business/.../timers)
+     * The SDK uses /timetracking/business/... but timer operations require /comments/business/...
+     *
+     * @param method HTTP method
+     * @param path API path (e.g., '/comments/business/123/timers')
+     * @param body Optional request body
+     * @param operation Operation name for logging
+     */
+    async executeRawRequest(method, path, body, operation = 'rawRequest') {
+        const requestId = this.generateRequestId();
+        try {
+            const accessToken = await this.oauth.getValidToken();
+            const url = `https://api.freshbooks.com${path}`;
+            logger.debug(`Executing raw ${method} ${path}`, {
+                requestId,
+                operation,
+            });
+            const startTime = Date.now();
+            const fetchOptions = {
+                method,
+                headers: {
+                    'Authorization': `Bearer ${accessToken}`,
+                    'Content-Type': 'application/json',
+                    'Api-Version': 'alpha',
+                },
+            };
+            if (body) {
+                fetchOptions.body = JSON.stringify(body);
+            }
+            const response = await fetch(url, fetchOptions);
+            const duration = Date.now() - startTime;
+            // Handle 204 No Content (e.g., successful DELETE)
+            if (response.status === 204) {
+                logger.info(`${operation} completed (no content)`, {
+                    requestId,
+                    duration,
+                    status: response.status,
+                });
+                return {
+                    ok: true,
+                    status: response.status,
+                };
+            }
+            const data = await response.json();
+            if (response.ok) {
+                logger.info(`${operation} completed`, {
+                    requestId,
+                    duration,
+                    status: response.status,
+                });
+                return {
+                    ok: true,
+                    status: response.status,
+                    data,
+                };
+            }
+            else {
+                logger.warn(`${operation} failed`, {
+                    requestId,
+                    status: response.status,
+                    data,
+                });
+                return {
+                    ok: false,
+                    status: response.status,
+                    data,
+                    error: new Error(`HTTP ${response.status}: ${JSON.stringify(data)}`),
+                };
+            }
+        }
+        catch (error) {
+            logger.error(`${operation} error`, error, { requestId });
+            return {
+                ok: false,
+                status: 0,
+                error: error instanceof Error ? error : new Error(String(error)),
+            };
+        }
+    }
+    /**
+     * Execute raw HTTP with retry logic
+     */
+    async executeRawWithRetry(method, path, body, operation = 'rawRequest') {
+        let lastResult = null;
+        const requestId = this.generateRequestId();
+        for (let attempt = 1; attempt <= FreshBooksClientWrapper.MAX_RETRIES; attempt++) {
+            const result = await this.executeRawRequest(method, path, body, operation);
+            lastResult = result;
+            if (result.ok) {
+                return result;
+            }
+            // Check if we should retry (rate limit or server error)
+            const shouldRetry = attempt < FreshBooksClientWrapper.MAX_RETRIES &&
+                (result.status === 429 || result.status >= 500);
+            if (!shouldRetry) {
+                return result;
+            }
+            logger.warn(`${operation} retrying`, {
+                requestId,
+                attempt,
+                status: result.status,
+            });
+            const backoffMs = FreshBooksClientWrapper.BASE_BACKOFF_MS * Math.pow(2, attempt - 1);
+            await this.sleep(backoffMs);
+        }
+        return lastResult;
+    }
+}
+//# sourceMappingURL=freshbooks-client.js.map

package/dist/client/freshbooks-client.js.map

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

package/dist/client/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * FreshBooks client exports
+ */
+export { FreshBooksClientWrapper } from './freshbooks-client.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,5 @@
+/**
+ * FreshBooks client exports
+ */
+export { FreshBooksClientWrapper } from './freshbooks-client.js';
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/config/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Configuration management for FreshBooks MCP Server
+ */
+import type { ServerConfig } from '../types/index.js';
+/**
+ * Load and validate server configuration from environment variables
+ */
+export declare function loadConfig(): ServerConfig;
+/**
+ * Get the current configuration, loading it if necessary
+ */
+export declare function getConfig(): ServerConfig;
+/**
+ * Reset configuration (useful for testing)
+ */
+export declare function resetConfig(): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAY,MAAM,mBAAmB,CAAC;AAGhE;;GAEG;AACH,wBAAgB,UAAU,IAAI,YAAY,CA8DzC;AAOD;;GAEG;AACH,wBAAgB,SAAS,IAAI,YAAY,CAKxC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC"}

package/dist/config/index.js

@@ -0,0 +1,81 @@
+/**
+ * Configuration management for FreshBooks MCP Server
+ */
+import { logger } from '../utils/logger.js';
+/**
+ * Load and validate server configuration from environment variables
+ */
+export function loadConfig() {
+    // Load environment variables
+    const clientId = process.env.FRESHBOOKS_CLIENT_ID;
+    const clientSecret = process.env.FRESHBOOKS_CLIENT_SECRET;
+    const redirectUri = process.env.FRESHBOOKS_REDIRECT_URI || 'http://localhost:3000/oauth/callback';
+    const logLevel = (process.env.LOG_LEVEL || 'info');
+    const tokenStorePath = process.env.TOKEN_STORE_PATH || '.freshbooks-tokens.json';
+    const apiBaseUrl = process.env.FRESHBOOKS_API_BASE_URL || 'https://api.freshbooks.com';
+    // Validate required configuration
+    const missing = [];
+    if (!clientId) {
+        missing.push('FRESHBOOKS_CLIENT_ID');
+    }
+    if (!clientSecret) {
+        missing.push('FRESHBOOKS_CLIENT_SECRET');
+    }
+    if (missing.length > 0) {
+        const errorMessage = `Missing required environment variables: ${missing.join(', ')}`;
+        logger.error(errorMessage);
+        throw new Error(errorMessage);
+    }
+    // Validate log level
+    const validLogLevels = ['debug', 'info', 'warn', 'error'];
+    if (!validLogLevels.includes(logLevel)) {
+        logger.warn(`Invalid LOG_LEVEL "${logLevel}", defaulting to "info"`, {
+            validLevels: validLogLevels,
+        });
+    }
+    const config = {
+        freshbooks: {
+            clientId: clientId,
+            clientSecret: clientSecret,
+            redirectUri,
+            authorizationUrl: 'https://my.freshbooks.com/service/auth/oauth/authorize',
+            tokenUrl: 'https://api.freshbooks.com/auth/oauth/token',
+            revokeUrl: 'https://api.freshbooks.com/auth/oauth/revoke',
+            apiBaseUrl,
+        },
+        server: {
+            logLevel: validLogLevels.includes(logLevel) ? logLevel : 'info',
+            tokenStorePath,
+        },
+    };
+    // Set logger level
+    logger.setLevel(config.server.logLevel);
+    // Log configuration (sanitized)
+    logger.info('Configuration loaded successfully', {
+        redirectUri: config.freshbooks.redirectUri,
+        logLevel: config.server.logLevel,
+        tokenStorePath: config.server.tokenStorePath,
+        apiBaseUrl: config.freshbooks.apiBaseUrl,
+    });
+    return config;
+}
+/**
+ * Global configuration instance
+ */
+let configInstance = null;
+/**
+ * Get the current configuration, loading it if necessary
+ */
+export function getConfig() {
+    if (!configInstance) {
+        configInstance = loadConfig();
+    }
+    return configInstance;
+}
+/**
+ * Reset configuration (useful for testing)
+ */
+export function resetConfig() {
+    configInstance = null;
+}
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

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