@goodsamsoftware/freshbooks-mcp 1.0.0

package/dist/tools/bill-payment/billpayment-list.js

@@ -0,0 +1,111 @@
+/**
+ * BillPayment List Tool
+ *
+ * List bill payments with pagination and optional filtering.
+ */
+import { BillPaymentListInputSchema, BillPaymentListOutputSchema } from "./schemas.js";
+import { ErrorHandler } from "../../errors/error-handler.js";
+import { logger } from "../../utils/logger.js";
+/**
+ * Tool definition for billpayment_list
+ */
+export const billpaymentListTool = {
+    name: "billpayment_list",
+    description: `List bill payments from FreshBooks with optional filtering and pagination.
+
+WHEN TO USE:
+- User asks to "see bill payments", "list payments made", "show vendor payments"
+- User wants to find payments for a specific bill
+- User needs to track payment history
+
+FILTERING OPTIONS:
+- billId: Filter by specific bill
+- startDate/endDate: Filter payments by date range
+
+PAGINATION:
+- Use page/perPage for large result sets
+- Default: 30 results per page
+- Maximum: 100 results per page
+
+EXAMPLE PROMPTS:
+- "Show me all bill payments"
+- "List payments for bill 123"
+- "Show payments made last month"
+- "What payments did I make to vendors?"
+
+RETURNS:
+Array of bill payments with amounts, dates, payment types, and associated bills.
+Includes pagination metadata for navigating large result sets.`,
+    inputSchema: BillPaymentListInputSchema,
+    outputSchema: BillPaymentListOutputSchema,
+    /**
+     * Execute the tool
+     */
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('billpayment_list', async (input, _context) => {
+            const { accountId, page, perPage, ...filters } = input;
+            logger.debug('Listing bill payments', {
+                accountId,
+                page,
+                perPage,
+                filters,
+            });
+            const result = await client.executeWithRetry('billpayment_list', async (fbClient) => {
+                // Dynamic import of query builders
+                const { PaginationQueryBuilder, SearchQueryBuilder } = await import('@freshbooks/api/dist/models/builders/index.js');
+                // Build query builders array
+                const queryBuilders = [];
+                // Add pagination if specified
+                if (page !== undefined || perPage !== undefined) {
+                    const pagination = new PaginationQueryBuilder();
+                    if (page !== undefined)
+                        pagination.page(page);
+                    if (perPage !== undefined)
+                        pagination.perPage(perPage);
+                    queryBuilders.push(pagination);
+                }
+                // Add search filters if any specified
+                if (Object.keys(filters).length > 0) {
+                    const search = new SearchQueryBuilder();
+                    if (filters.billId !== undefined) {
+                        search.equals("bill_id", filters.billId);
+                    }
+                    if (filters.startDate || filters.endDate) {
+                        const minDate = (filters.startDate ?? '1970-01-01');
+                        const maxDate = (filters.endDate ?? new Date().toISOString().split('T')[0]);
+                        search.between("paid_date", { min: minDate, max: maxDate });
+                    }
+                    queryBuilders.push(search);
+                }
+                const response = await fbClient.billPayments.list(accountId, queryBuilders);
+                if (!response.ok) {
+                    throw response.error;
+                }
+                return response.data;
+            });
+            // Extract data - FreshBooks returns: { bill_payments: [...], pages: {...} }
+            const billPayments = result.bill_payments || [];
+            const paginationData = result.pages || {
+                page: 1,
+                pages: 1,
+                total: billPayments.length,
+                per_page: 30,
+            };
+            logger.info('Bill payments listed successfully', {
+                count: billPayments.length,
+                total: paginationData.total,
+            });
+            return {
+                billPayments,
+                pagination: {
+                    page: paginationData.page,
+                    pages: paginationData.pages,
+                    perPage: paginationData.per_page || paginationData.perPage || 30,
+                    total: paginationData.total,
+                },
+            };
+        });
+        return handler(input, { accountId: input.accountId });
+    },
+};
+//# sourceMappingURL=billpayment-list.js.map

package/dist/tools/bill-payment/billpayment-list.js.map

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

package/dist/tools/bill-payment/billpayment-single.d.ts

@@ -0,0 +1,76 @@
+/**
+ * BillPayment Single Tool
+ *
+ * Retrieve a single bill payment by ID.
+ */
+import { z } from "zod";
+import { BillPaymentSingleInputSchema, BillPaymentSingleOutputSchema } from "./schemas.js";
+import { FreshBooksClientWrapper } from "../../client/index.js";
+/**
+ * Tool definition for billpayment_single
+ */
+export declare const billpaymentSingleTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        accountId: z.ZodString;
+        billPaymentId: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        accountId: string;
+        billPaymentId: number;
+    }, {
+        accountId: string;
+        billPaymentId: number;
+    }>;
+    outputSchema: z.ZodObject<{
+        id: z.ZodNumber;
+        billId: z.ZodNumber;
+        amount: z.ZodObject<{
+            amount: z.ZodString;
+            code: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            amount: string;
+        }, {
+            code: string;
+            amount: string;
+        }>;
+        paymentType: z.ZodEnum<["check", "credit", "cash", "bank_transfer", "debit", "other"]>;
+        paidDate: z.ZodString;
+        note: z.ZodNullable<z.ZodString>;
+        matchedWithExpense: z.ZodOptional<z.ZodBoolean>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        createdAt: string;
+        id: number;
+        amount: {
+            code: string;
+            amount: string;
+        };
+        note: string | null;
+        updatedAt: string;
+        billId: number;
+        paymentType: "check" | "credit" | "cash" | "bank_transfer" | "debit" | "other";
+        paidDate: string;
+        matchedWithExpense?: boolean | undefined;
+    }, {
+        createdAt: string;
+        id: number;
+        amount: {
+            code: string;
+            amount: string;
+        };
+        note: string | null;
+        updatedAt: string;
+        billId: number;
+        paymentType: "check" | "credit" | "cash" | "bank_transfer" | "debit" | "other";
+        paidDate: string;
+        matchedWithExpense?: boolean | undefined;
+    }>;
+    /**
+     * Execute the tool
+     */
+    execute(input: z.infer<typeof BillPaymentSingleInputSchema>, client: FreshBooksClientWrapper): Promise<z.infer<typeof BillPaymentSingleOutputSchema>>;
+};
+//# sourceMappingURL=billpayment-single.d.ts.map

package/dist/tools/bill-payment/billpayment-single.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billpayment-single.d.ts","sourceRoot":"","sources":["../../../src/tools/bill-payment/billpayment-single.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,4BAA4B,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAG3F,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGhE;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAyBhC;;OAEG;mBAEM,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,UAC3C,uBAAuB,GAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;CAwC1D,CAAC"}

package/dist/tools/bill-payment/billpayment-single.js

@@ -0,0 +1,62 @@
+/**
+ * BillPayment Single Tool
+ *
+ * Retrieve a single bill payment by ID.
+ */
+import { BillPaymentSingleInputSchema, BillPaymentSingleOutputSchema } from "./schemas.js";
+import { ErrorHandler } from "../../errors/error-handler.js";
+import { logger } from "../../utils/logger.js";
+/**
+ * Tool definition for billpayment_single
+ */
+export const billpaymentSingleTool = {
+    name: "billpayment_single",
+    description: `Retrieve a single bill payment by ID from FreshBooks.
+
+WHEN TO USE:
+- User asks for details about a specific payment
+- User references a payment ID
+- User wants to see full payment information
+
+REQUIRED:
+- accountId: FreshBooks account ID
+- billPaymentId: The specific payment ID to retrieve
+
+EXAMPLE PROMPTS:
+- "Show me payment 12345"
+- "Get details for that bill payment"
+- "What was payment #BP-001?"
+
+RETURNS:
+Complete payment details including amount, date, payment type, associated bill,
+and any notes.`,
+    inputSchema: BillPaymentSingleInputSchema,
+    outputSchema: BillPaymentSingleOutputSchema,
+    /**
+     * Execute the tool
+     */
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('billpayment_single', async (input, _context) => {
+            const { accountId, billPaymentId } = input;
+            logger.debug('Retrieving bill payment', {
+                accountId,
+                billPaymentId,
+            });
+            const result = await client.executeWithRetry('billpayment_single', async (fbClient) => {
+                const response = await fbClient.billPayments.single(accountId, billPaymentId);
+                if (!response.ok) {
+                    throw response.error;
+                }
+                return response.data;
+            });
+            // FreshBooks returns: { bill_payment: { ... } }
+            const billPayment = result.bill_payment ?? result;
+            logger.info('Bill payment retrieved successfully', {
+                billPaymentId,
+            });
+            return billPayment;
+        });
+        return handler(input, { accountId: input.accountId });
+    },
+};
+//# sourceMappingURL=billpayment-single.js.map

package/dist/tools/bill-payment/billpayment-single.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billpayment-single.js","sourceRoot":"","sources":["../../../src/tools/bill-payment/billpayment-single.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,4BAA4B,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAC3F,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAG7D,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE;;;;;;;;;;;;;;;;;;eAkBA;IAEb,WAAW,EAAE,4BAA4B;IACzC,YAAY,EAAE,6BAA6B;IAE3C;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,KAAmD,EACnD,MAA+B;QAE/B,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CACtC,oBAAoB,EACpB,KAAK,EACH,KAAmD,EACnD,QAAqB,EACrB,EAAE;YACF,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,KAAK,CAAC;YAE3C,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE;gBACtC,SAAS;gBACT,aAAa;aACd,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAC1C,oBAAoB,EACpB,KAAK,EAAE,QAAQ,EAAE,EAAE;gBACjB,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;gBAE9E,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,QAAQ,CAAC,KAAK,CAAC;gBACvB,CAAC;gBAED,OAAO,QAAQ,CAAC,IAAI,CAAC;YACvB,CAAC,CACF,CAAC;YAEF,gDAAgD;YAChD,MAAM,WAAW,GAAI,MAAqC,CAAC,YAAY,IAAI,MAAM,CAAC;YAElF,MAAM,CAAC,IAAI,CAAC,qCAAqC,EAAE;gBACjD,aAAa;aACd,CAAC,CAAC;YAEH,OAAO,WAA4D,CAAC;QACtE,CAAC,CACF,CAAC;QAEF,OAAO,OAAO,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;IACxD,CAAC;CACF,CAAC"}

package/dist/tools/bill-payment/billpayment-update.d.ts

@@ -0,0 +1,103 @@
+/**
+ * BillPayment Update Tool
+ *
+ * Update an existing bill payment in FreshBooks.
+ */
+import { z } from "zod";
+import { BillPaymentUpdateInputSchema, BillPaymentSingleOutputSchema } from "./schemas.js";
+import { FreshBooksClientWrapper } from "../../client/index.js";
+/**
+ * Tool definition for billpayment_update
+ */
+export declare const billpaymentUpdateTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        accountId: z.ZodString;
+        billPaymentId: z.ZodNumber;
+        amount: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodString;
+            code: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            amount: string;
+        }, {
+            code: string;
+            amount: string;
+        }>>;
+        paymentType: z.ZodOptional<z.ZodEnum<["check", "credit", "cash", "bank_transfer", "debit", "other"]>>;
+        paidDate: z.ZodOptional<z.ZodString>;
+        note: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        accountId: string;
+        billPaymentId: number;
+        amount?: {
+            code: string;
+            amount: string;
+        } | undefined;
+        note?: string | undefined;
+        paymentType?: "check" | "credit" | "cash" | "bank_transfer" | "debit" | "other" | undefined;
+        paidDate?: string | undefined;
+    }, {
+        accountId: string;
+        billPaymentId: number;
+        amount?: {
+            code: string;
+            amount: string;
+        } | undefined;
+        note?: string | undefined;
+        paymentType?: "check" | "credit" | "cash" | "bank_transfer" | "debit" | "other" | undefined;
+        paidDate?: string | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        id: z.ZodNumber;
+        billId: z.ZodNumber;
+        amount: z.ZodObject<{
+            amount: z.ZodString;
+            code: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            amount: string;
+        }, {
+            code: string;
+            amount: string;
+        }>;
+        paymentType: z.ZodEnum<["check", "credit", "cash", "bank_transfer", "debit", "other"]>;
+        paidDate: z.ZodString;
+        note: z.ZodNullable<z.ZodString>;
+        matchedWithExpense: z.ZodOptional<z.ZodBoolean>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        createdAt: string;
+        id: number;
+        amount: {
+            code: string;
+            amount: string;
+        };
+        note: string | null;
+        updatedAt: string;
+        billId: number;
+        paymentType: "check" | "credit" | "cash" | "bank_transfer" | "debit" | "other";
+        paidDate: string;
+        matchedWithExpense?: boolean | undefined;
+    }, {
+        createdAt: string;
+        id: number;
+        amount: {
+            code: string;
+            amount: string;
+        };
+        note: string | null;
+        updatedAt: string;
+        billId: number;
+        paymentType: "check" | "credit" | "cash" | "bank_transfer" | "debit" | "other";
+        paidDate: string;
+        matchedWithExpense?: boolean | undefined;
+    }>;
+    /**
+     * Execute the tool
+     */
+    execute(input: z.infer<typeof BillPaymentUpdateInputSchema>, client: FreshBooksClientWrapper): Promise<z.infer<typeof BillPaymentSingleOutputSchema>>;
+};
+//# sourceMappingURL=billpayment-update.d.ts.map

package/dist/tools/bill-payment/billpayment-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billpayment-update.d.ts","sourceRoot":"","sources":["../../../src/tools/bill-payment/billpayment-update.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,4BAA4B,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAG3F,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGhE;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA8BhC;;OAEG;mBAEM,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,UAC3C,uBAAuB,GAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;CAwC1D,CAAC"}

package/dist/tools/bill-payment/billpayment-update.js

@@ -0,0 +1,67 @@
+/**
+ * BillPayment Update Tool
+ *
+ * Update an existing bill payment in FreshBooks.
+ */
+import { BillPaymentUpdateInputSchema, BillPaymentSingleOutputSchema } from "./schemas.js";
+import { ErrorHandler } from "../../errors/error-handler.js";
+import { logger } from "../../utils/logger.js";
+/**
+ * Tool definition for billpayment_update
+ */
+export const billpaymentUpdateTool = {
+    name: "billpayment_update",
+    description: `Update an existing bill payment in FreshBooks.
+
+WHEN TO USE:
+- User wants to correct payment details
+- Payment amount or date needs to be changed
+- Payment type or notes need updating
+
+REQUIRED:
+- accountId: FreshBooks account ID
+- billPaymentId: The payment ID to update
+
+OPTIONAL (at least one should be provided):
+- amount: Corrected payment amount
+- paymentType: Updated payment type
+- paidDate: Corrected payment date
+- note: Updated or additional notes
+
+EXAMPLE PROMPTS:
+- "Update payment 123 to $600"
+- "Change the payment date for bill payment 456"
+- "Correct payment type to bank_transfer for payment 789"
+
+RETURNS:
+Updated payment with all current details.`,
+    inputSchema: BillPaymentUpdateInputSchema,
+    outputSchema: BillPaymentSingleOutputSchema,
+    /**
+     * Execute the tool
+     */
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('billpayment_update', async (input, _context) => {
+            const { accountId, billPaymentId, ...updateData } = input;
+            logger.debug('Updating bill payment', {
+                accountId,
+                billPaymentId,
+            });
+            const result = await client.executeWithRetry('billpayment_update', async (fbClient) => {
+                const response = await fbClient.billPayments.update(updateData, accountId, billPaymentId);
+                if (!response.ok) {
+                    throw response.error;
+                }
+                return response.data;
+            });
+            // FreshBooks returns: { bill_payment: { ... } }
+            const updatedPayment = result.bill_payment ?? result;
+            logger.info('Bill payment updated successfully', {
+                billPaymentId,
+            });
+            return updatedPayment;
+        });
+        return handler(input, { accountId: input.accountId });
+    },
+};
+//# sourceMappingURL=billpayment-update.js.map

package/dist/tools/bill-payment/billpayment-update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billpayment-update.js","sourceRoot":"","sources":["../../../src/tools/bill-payment/billpayment-update.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,4BAA4B,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAC3F,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAG7D,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;0CAuB2B;IAExC,WAAW,EAAE,4BAA4B;IACzC,YAAY,EAAE,6BAA6B;IAE3C;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,KAAmD,EACnD,MAA+B;QAE/B,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CACtC,oBAAoB,EACpB,KAAK,EACH,KAAmD,EACnD,QAAqB,EACrB,EAAE;YACF,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,UAAU,EAAE,GAAG,KAAK,CAAC;YAE1D,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE;gBACpC,SAAS;gBACT,aAAa;aACd,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAC1C,oBAAoB,EACpB,KAAK,EAAE,QAAQ,EAAE,EAAE;gBACjB,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,UAAiB,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;gBAEjG,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,QAAQ,CAAC,KAAK,CAAC;gBACvB,CAAC;gBAED,OAAO,QAAQ,CAAC,IAAI,CAAC;YACvB,CAAC,CACF,CAAC;YAEF,gDAAgD;YAChD,MAAM,cAAc,GAAI,MAAqC,CAAC,YAAY,IAAI,MAAM,CAAC;YAErF,MAAM,CAAC,IAAI,CAAC,mCAAmC,EAAE;gBAC/C,aAAa;aACd,CAAC,CAAC;YAEH,OAAO,cAA+D,CAAC;QACzE,CAAC,CACF,CAAC;QAEF,OAAO,OAAO,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;IACxD,CAAC;CACF,CAAC"}

package/dist/tools/bill-payment/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * BillPayment Tools - FreshBooks bill payment management
+ *
+ * Exports all bill payment-related MCP tools for tracking payments to vendors.
+ */
+export { billpaymentListTool } from "./billpayment-list.js";
+export { billpaymentSingleTool } from "./billpayment-single.js";
+export { billpaymentCreateTool } from "./billpayment-create.js";
+export { billpaymentUpdateTool } from "./billpayment-update.js";
+export { billpaymentDeleteTool } from "./billpayment-delete.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/bill-payment/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/bill-payment/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/tools/bill-payment/index.js

@@ -0,0 +1,13 @@
+/**
+ * BillPayment Tools - FreshBooks bill payment management
+ *
+ * Exports all bill payment-related MCP tools for tracking payments to vendors.
+ */
+// Export schemas
+// Export tool definitions
+export { billpaymentListTool } from "./billpayment-list.js";
+export { billpaymentSingleTool } from "./billpayment-single.js";
+export { billpaymentCreateTool } from "./billpayment-create.js";
+export { billpaymentUpdateTool } from "./billpayment-update.js";
+export { billpaymentDeleteTool } from "./billpayment-delete.js";
+//# sourceMappingURL=index.js.map

package/dist/tools/bill-payment/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/bill-payment/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,iBAAiB;AAEjB,0BAA0B;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC"}