@goodsamsoftware/freshbooks-mcp 1.0.0

package/dist/tools/bill-vendor/billvendor-update.d.ts

@@ -0,0 +1,142 @@
+/**
+ * BillVendor Update Tool
+ *
+ * Update an existing vendor in FreshBooks.
+ */
+import { z } from "zod";
+import { BillVendorUpdateInputSchema, BillVendorSingleOutputSchema } from "./schemas.js";
+import { FreshBooksClientWrapper } from "../../client/index.js";
+/**
+ * Tool definition for billvendor_update
+ */
+export declare const billvendorUpdateTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        accountId: z.ZodString;
+        vendorId: z.ZodNumber;
+        vendorName: z.ZodOptional<z.ZodString>;
+        contactName: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+        phone: z.ZodOptional<z.ZodString>;
+        website: z.ZodOptional<z.ZodString>;
+        address: z.ZodOptional<z.ZodString>;
+        city: z.ZodOptional<z.ZodString>;
+        province: z.ZodOptional<z.ZodString>;
+        postalCode: z.ZodOptional<z.ZodString>;
+        country: z.ZodOptional<z.ZodString>;
+        currencyCode: z.ZodOptional<z.ZodString>;
+        accountNumber: z.ZodOptional<z.ZodString>;
+        taxNumber: z.ZodOptional<z.ZodString>;
+        note: z.ZodOptional<z.ZodString>;
+        is1099: z.ZodOptional<z.ZodBoolean>;
+        language: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        accountId: string;
+        vendorId: number;
+        email?: string | undefined;
+        note?: string | undefined;
+        currencyCode?: string | undefined;
+        language?: string | undefined;
+        address?: string | undefined;
+        city?: string | undefined;
+        province?: string | undefined;
+        country?: string | undefined;
+        vendorName?: string | undefined;
+        contactName?: string | undefined;
+        phone?: string | undefined;
+        website?: string | undefined;
+        postalCode?: string | undefined;
+        accountNumber?: string | undefined;
+        taxNumber?: string | undefined;
+        is1099?: boolean | undefined;
+    }, {
+        accountId: string;
+        vendorId: number;
+        email?: string | undefined;
+        note?: string | undefined;
+        currencyCode?: string | undefined;
+        language?: string | undefined;
+        address?: string | undefined;
+        city?: string | undefined;
+        province?: string | undefined;
+        country?: string | undefined;
+        vendorName?: string | undefined;
+        contactName?: string | undefined;
+        phone?: string | undefined;
+        website?: string | undefined;
+        postalCode?: string | undefined;
+        accountNumber?: string | undefined;
+        taxNumber?: string | undefined;
+        is1099?: boolean | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        id: z.ZodNumber;
+        vendorName: z.ZodString;
+        contactName: z.ZodNullable<z.ZodString>;
+        email: z.ZodNullable<z.ZodString>;
+        phone: z.ZodNullable<z.ZodString>;
+        website: z.ZodNullable<z.ZodString>;
+        address: z.ZodNullable<z.ZodString>;
+        city: z.ZodNullable<z.ZodString>;
+        province: z.ZodNullable<z.ZodString>;
+        postalCode: z.ZodNullable<z.ZodString>;
+        country: z.ZodNullable<z.ZodString>;
+        currencyCode: z.ZodString;
+        accountNumber: z.ZodNullable<z.ZodString>;
+        taxNumber: z.ZodNullable<z.ZodString>;
+        note: z.ZodNullable<z.ZodString>;
+        is1099: z.ZodOptional<z.ZodBoolean>;
+        language: z.ZodOptional<z.ZodString>;
+        visState: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        email: string | null;
+        createdAt: string;
+        id: number;
+        note: string | null;
+        updatedAt: string;
+        currencyCode: string;
+        address: string | null;
+        city: string | null;
+        province: string | null;
+        country: string | null;
+        vendorName: string;
+        contactName: string | null;
+        phone: string | null;
+        website: string | null;
+        postalCode: string | null;
+        accountNumber: string | null;
+        taxNumber: string | null;
+        visState?: 0 | 1 | 2 | undefined;
+        language?: string | undefined;
+        is1099?: boolean | undefined;
+    }, {
+        email: string | null;
+        createdAt: string;
+        id: number;
+        note: string | null;
+        updatedAt: string;
+        currencyCode: string;
+        address: string | null;
+        city: string | null;
+        province: string | null;
+        country: string | null;
+        vendorName: string;
+        contactName: string | null;
+        phone: string | null;
+        website: string | null;
+        postalCode: string | null;
+        accountNumber: string | null;
+        taxNumber: string | null;
+        visState?: 0 | 1 | 2 | undefined;
+        language?: string | undefined;
+        is1099?: boolean | undefined;
+    }>;
+    /**
+     * Execute the tool
+     */
+    execute(input: z.infer<typeof BillVendorUpdateInputSchema>, client: FreshBooksClientWrapper): Promise<z.infer<typeof BillVendorSingleOutputSchema>>;
+};
+//# sourceMappingURL=billvendor-update.d.ts.map

package/dist/tools/bill-vendor/billvendor-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billvendor-update.d.ts","sourceRoot":"","sources":["../../../src/tools/bill-vendor/billvendor-update.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,2BAA2B,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AAGzF,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGhE;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAmC/B;;OAEG;mBAEM,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,UAC1C,uBAAuB,GAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;CAwCzD,CAAC"}

package/dist/tools/bill-vendor/billvendor-update.js

@@ -0,0 +1,72 @@
+/**
+ * BillVendor Update Tool
+ *
+ * Update an existing vendor in FreshBooks.
+ */
+import { BillVendorUpdateInputSchema, BillVendorSingleOutputSchema } from "./schemas.js";
+import { ErrorHandler } from "../../errors/error-handler.js";
+import { logger } from "../../utils/logger.js";
+/**
+ * Tool definition for billvendor_update
+ */
+export const billvendorUpdateTool = {
+    name: "billvendor_update",
+    description: `Update an existing vendor in FreshBooks.
+
+WHEN TO USE:
+- User wants to update vendor contact information
+- Vendor address or details have changed
+- User needs to correct vendor information
+
+REQUIRED:
+- accountId: FreshBooks account ID
+- vendorId: The vendor ID to update
+
+OPTIONAL (at least one should be provided):
+- vendorName: Updated vendor name
+- contactName: Updated contact person
+- email: Updated email address
+- phone: Updated phone number
+- address, city, province, postalCode, country: Updated address
+- accountNumber: Updated account number
+- taxNumber: Updated tax ID
+- note: Updated notes
+- is1099: Updated 1099 status
+
+EXAMPLE PROMPTS:
+- "Update vendor 123's email to newemail@vendor.com"
+- "Change the contact name for vendor 'Acme Supplies'"
+- "Update vendor address for supplier 456"
+
+RETURNS:
+Updated vendor with all current details.`,
+    inputSchema: BillVendorUpdateInputSchema,
+    outputSchema: BillVendorSingleOutputSchema,
+    /**
+     * Execute the tool
+     */
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('billvendor_update', async (input, _context) => {
+            const { accountId, vendorId, ...updateData } = input;
+            logger.debug('Updating vendor', {
+                accountId,
+                vendorId,
+            });
+            const result = await client.executeWithRetry('billvendor_update', async (fbClient) => {
+                const response = await fbClient.billVendors.update(updateData, accountId, vendorId);
+                if (!response.ok) {
+                    throw response.error;
+                }
+                return response.data;
+            });
+            // FreshBooks returns: { bill_vendor: { ... } }
+            const updatedVendor = result.bill_vendor ?? result;
+            logger.info('Vendor updated successfully', {
+                vendorId,
+            });
+            return updatedVendor;
+        });
+        return handler(input, { accountId: input.accountId });
+    },
+};
+//# sourceMappingURL=billvendor-update.js.map

package/dist/tools/bill-vendor/billvendor-update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billvendor-update.js","sourceRoot":"","sources":["../../../src/tools/bill-vendor/billvendor-update.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,2BAA2B,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAG7D,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;yCA4B0B;IAEvC,WAAW,EAAE,2BAA2B;IACxC,YAAY,EAAE,4BAA4B;IAE1C;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,KAAkD,EAClD,MAA+B;QAE/B,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CACtC,mBAAmB,EACnB,KAAK,EACH,KAAkD,EAClD,QAAqB,EACrB,EAAE;YACF,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,UAAU,EAAE,GAAG,KAAK,CAAC;YAErD,MAAM,CAAC,KAAK,CAAC,iBAAiB,EAAE;gBAC9B,SAAS;gBACT,QAAQ;aACT,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAC1C,mBAAmB,EACnB,KAAK,EAAE,QAAQ,EAAE,EAAE;gBACjB,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,UAAiB,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;gBAE3F,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,+CAA+C;YAC/C,MAAM,aAAa,GAAI,MAAoC,CAAC,WAAW,IAAI,MAAM,CAAC;YAElF,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE;gBACzC,QAAQ;aACT,CAAC,CAAC;YAEH,OAAO,aAA6D,CAAC;QACvE,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-vendor/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * BillVendor Tools - FreshBooks vendor management
+ *
+ * Exports all vendor-related MCP tools for managing suppliers and vendors.
+ */
+export { billvendorListTool } from "./billvendor-list.js";
+export { billvendorSingleTool } from "./billvendor-single.js";
+export { billvendorCreateTool } from "./billvendor-create.js";
+export { billvendorUpdateTool } from "./billvendor-update.js";
+export { billvendorDeleteTool } from "./billvendor-delete.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/bill-vendor/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * BillVendor Tools - FreshBooks vendor management
+ *
+ * Exports all vendor-related MCP tools for managing suppliers and vendors.
+ */
+// Export schemas
+// Export tool definitions
+export { billvendorListTool } from "./billvendor-list.js";
+export { billvendorSingleTool } from "./billvendor-single.js";
+export { billvendorCreateTool } from "./billvendor-create.js";
+export { billvendorUpdateTool } from "./billvendor-update.js";
+export { billvendorDeleteTool } from "./billvendor-delete.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/bill-vendor/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,iBAAiB;AAEjB,0BAA0B;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC"}