@goodsamsoftware/freshbooks-mcp 1.0.0

package/dist/tools/callback/callback-update.js

@@ -0,0 +1,62 @@
+/**
+ * Callback Update Tool
+ *
+ * Update an existing webhook/callback configuration.
+ */
+import { CallbackUpdateInputSchema, CallbackSingleOutputSchema } from "./schemas.js";
+import { ErrorHandler } from "../../errors/error-handler.js";
+/**
+ * Tool definition for callback_update
+ */
+export const callbackUpdateTool = {
+    name: "callback_update",
+    description: `Update an existing webhook/callback in FreshBooks.
+
+WHEN TO USE:
+- User wants to change the event type for a webhook
+- User needs to update the webhook endpoint URL
+- User says "update webhook", "change callback URL"
+
+REQUIRED INFO:
+- Callback ID to update
+- Account ID
+
+OPTIONAL UPDATES:
+- event: Change the event type to listen for
+- uri: Update the webhook endpoint URL
+
+IMPORTANT NOTES:
+- If you change the URI, the webhook will need to be reverified
+- Changing the event type does not require reverification
+- Webhook URL must be HTTPS
+
+EXAMPLE PROMPTS:
+- "Update webhook 123 to use new URL https://newapp.com/webhooks"
+- "Change callback 456 to listen for payment.create instead"
+- "Update the endpoint for webhook 789"
+
+RETURNS:
+Updated webhook configuration with current verification status.`,
+    inputSchema: CallbackUpdateInputSchema,
+    outputSchema: CallbackSingleOutputSchema,
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('callback_update', async (input, _context) => {
+            const { accountId, callbackId, ...updates } = input;
+            // Validate HTTPS if URI is being updated
+            if (updates.uri && !updates.uri.startsWith('https://')) {
+                throw ErrorHandler.createValidationError('Webhook URI must use HTTPS protocol for security', { tool: 'callback_update', accountId, entityId: callbackId });
+            }
+            const result = await client.executeWithRetry('callback_update', async (fbClient) => {
+                const response = await fbClient.callbacks.update(updates, accountId, String(callbackId));
+                if (!response.ok) {
+                    throw response.error;
+                }
+                return response.data;
+            });
+            // Extract callback data
+            return result.callback;
+        });
+        return handler(input, { accountId: input.accountId });
+    },
+};
+//# sourceMappingURL=callback-update.js.map

package/dist/tools/callback/callback-update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callback-update.js","sourceRoot":"","sources":["../../../src/tools/callback/callback-update.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AACrF,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAI7D;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;gEA0BiD;IAE9D,WAAW,EAAE,yBAAyB;IACtC,YAAY,EAAE,0BAA0B;IAExC,KAAK,CAAC,OAAO,CACX,KAAgD,EAChD,MAA+B;QAE/B,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CACtC,iBAAiB,EACjB,KAAK,EAAE,KAAgD,EAAE,QAAqB,EAAE,EAAE;YAChF,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,OAAO,EAAE,GAAG,KAAK,CAAC;YAEpD,yCAAyC;YACzC,IAAI,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBACvD,MAAM,YAAY,CAAC,qBAAqB,CACtC,kDAAkD,EAClD,EAAE,IAAI,EAAE,iBAAiB,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,CAC7D,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;gBACjF,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,OAAc,EAAE,SAAS,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;gBAEhG,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,QAAQ,CAAC,KAAK,CAAC;gBACvB,CAAC;gBAED,OAAO,QAAQ,CAAC,IAAI,CAAC;YACvB,CAAC,CAAC,CAAC;YAEH,wBAAwB;YACxB,OAAQ,MAAc,CAAC,QAAQ,CAAC;QAClC,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/callback/callback-verify.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Callback Verify Tool
+ *
+ * Verify ownership of a webhook endpoint.
+ */
+import { z } from "zod";
+import { CallbackVerifyInputSchema, CallbackVerifyOutputSchema } from "./schemas.js";
+import { FreshBooksClientWrapper } from "../../client/index.js";
+/**
+ * Tool definition for callback_verify
+ */
+export declare const callbackVerifyTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        accountId: z.ZodString;
+        callbackId: z.ZodNumber;
+        verifier: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        accountId: string;
+        callbackId: number;
+        verifier: string;
+    }, {
+        accountId: string;
+        callbackId: number;
+        verifier: string;
+    }>;
+    outputSchema: z.ZodObject<{
+        success: z.ZodBoolean;
+        verified: z.ZodBoolean;
+        callbackId: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        success: boolean;
+        verified: boolean;
+        callbackId: number;
+    }, {
+        success: boolean;
+        verified: boolean;
+        callbackId: number;
+    }>;
+    execute(input: z.infer<typeof CallbackVerifyInputSchema>, client: FreshBooksClientWrapper): Promise<z.infer<typeof CallbackVerifyOutputSchema>>;
+};
+//# sourceMappingURL=callback-verify.d.ts.map

package/dist/tools/callback/callback-verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"callback-verify.d.ts","sourceRoot":"","sources":["../../../src/tools/callback/callback-verify.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAGrF,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAwCpB,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,UACxC,uBAAuB,GAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;CA6BvD,CAAC"}

package/dist/tools/callback/callback-verify.js

@@ -0,0 +1,69 @@
+/**
+ * Callback Verify Tool
+ *
+ * Verify ownership of a webhook endpoint.
+ */
+import { CallbackVerifyInputSchema, CallbackVerifyOutputSchema } from "./schemas.js";
+import { ErrorHandler } from "../../errors/error-handler.js";
+/**
+ * Tool definition for callback_verify
+ */
+export const callbackVerifyTool = {
+    name: "callback_verify",
+    description: `Verify ownership of a webhook endpoint.
+
+WHEN TO USE:
+- After creating a new webhook (required to activate it)
+- User received a verification code at their webhook endpoint
+- User says "verify webhook", "activate callback"
+
+REQUIRED INFO:
+- Callback ID to verify
+- Verification code (received as POST to your webhook URL)
+- Account ID
+
+HOW IT WORKS:
+1. After creating a webhook, FreshBooks sends a POST to your URL with a verifier code
+2. Extract the verifier from the request body
+3. Call this tool with the callback ID and verifier code
+4. Once verified, webhook becomes active and events start flowing
+
+VERIFICATION REQUEST FORMAT:
+FreshBooks POSTs to your webhook URL:
+{
+  "object": "callback",
+  "action": "verify",
+  "verifier": "abc123xyz..."
+}
+
+EXAMPLE PROMPTS:
+- "Verify webhook 123 with code abc123xyz"
+- "Activate callback 456 using verifier def456"
+- "Complete webhook verification"
+
+RETURNS:
+Verification status and updated webhook configuration.`,
+    inputSchema: CallbackVerifyInputSchema,
+    outputSchema: CallbackVerifyOutputSchema,
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('callback_verify', async (input, _context) => {
+            const { accountId, callbackId, verifier } = input;
+            const result = await client.executeWithRetry('callback_verify', async (fbClient) => {
+                const response = await fbClient.callbacks.verify(accountId, String(callbackId), verifier);
+                if (!response.ok) {
+                    throw response.error;
+                }
+                return response.data;
+            });
+            // Extract callback data
+            const callback = result.callback;
+            return {
+                success: true,
+                verified: callback.verified,
+                callbackId,
+            };
+        });
+        return handler(input, { accountId: input.accountId });
+    },
+};
+//# sourceMappingURL=callback-verify.js.map

package/dist/tools/callback/callback-verify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callback-verify.js","sourceRoot":"","sources":["../../../src/tools/callback/callback-verify.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AACrF,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAI7D;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uDAgCwC;IAErD,WAAW,EAAE,yBAAyB;IACtC,YAAY,EAAE,0BAA0B;IAExC,KAAK,CAAC,OAAO,CACX,KAAgD,EAChD,MAA+B;QAE/B,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CACtC,iBAAiB,EACjB,KAAK,EAAE,KAAgD,EAAE,QAAqB,EAAE,EAAE;YAChF,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;YAElD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;gBACjF,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAC;gBAE1F,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,QAAQ,CAAC,KAAK,CAAC;gBACvB,CAAC;gBAED,OAAO,QAAQ,CAAC,IAAI,CAAC;YACvB,CAAC,CAAC,CAAC;YAEH,wBAAwB;YACxB,MAAM,QAAQ,GAAI,MAAc,CAAC,QAAQ,CAAC;YAE1C,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,UAAU;aACX,CAAC;QACJ,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/callback/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Callback Tools - FreshBooks webhook management
+ *
+ * Exports all callback/webhook-related MCP tools for event notifications.
+ */
+export { callbackListTool } from "./callback-list.js";
+export { callbackSingleTool } from "./callback-single.js";
+export { callbackCreateTool } from "./callback-create.js";
+export { callbackUpdateTool } from "./callback-update.js";
+export { callbackDeleteTool } from "./callback-delete.js";
+export { callbackVerifyTool } from "./callback-verify.js";
+export { callbackResendVerificationTool } from "./callback-resend-verification.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/callback/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/callback/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,8BAA8B,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/tools/callback/index.js

@@ -0,0 +1,15 @@
+/**
+ * Callback Tools - FreshBooks webhook management
+ *
+ * Exports all callback/webhook-related MCP tools for event notifications.
+ */
+// Export schemas
+// Export tool definitions
+export { callbackListTool } from "./callback-list.js";
+export { callbackSingleTool } from "./callback-single.js";
+export { callbackCreateTool } from "./callback-create.js";
+export { callbackUpdateTool } from "./callback-update.js";
+export { callbackDeleteTool } from "./callback-delete.js";
+export { callbackVerifyTool } from "./callback-verify.js";
+export { callbackResendVerificationTool } from "./callback-resend-verification.js";
+//# sourceMappingURL=index.js.map

package/dist/tools/callback/index.js.map

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

package/dist/tools/callback/schemas.d.ts

@@ -0,0 +1,284 @@
+/**
+ * Zod schemas for Callback (Webhook) entity
+ *
+ * Webhook/callback schemas for FreshBooks event notifications
+ */
+import { z } from 'zod';
+/**
+ * Full Callback schema with all properties
+ */
+export declare const CallbackSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    event: z.ZodString;
+    uri: z.ZodString;
+    verified: z.ZodBoolean;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    uri: string;
+    createdAt: string;
+    id: number;
+    updatedAt: string;
+    event: string;
+    verified: boolean;
+}, {
+    uri: string;
+    createdAt: string;
+    id: number;
+    updatedAt: string;
+    event: string;
+    verified: boolean;
+}>;
+/**
+ * Input schema for creating a callback
+ */
+export declare const CallbackCreateInputSchema: z.ZodObject<{
+    accountId: z.ZodString;
+    event: z.ZodString;
+    uri: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    accountId: string;
+    uri: string;
+    event: string;
+}, {
+    accountId: string;
+    uri: string;
+    event: string;
+}>;
+/**
+ * Input schema for updating a callback
+ */
+export declare const CallbackUpdateInputSchema: z.ZodObject<{
+    accountId: z.ZodString;
+    callbackId: z.ZodNumber;
+    event: z.ZodOptional<z.ZodString>;
+    uri: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    accountId: string;
+    callbackId: number;
+    uri?: string | undefined;
+    event?: string | undefined;
+}, {
+    accountId: string;
+    callbackId: number;
+    uri?: string | undefined;
+    event?: string | undefined;
+}>;
+/**
+ * Input schema for listing callbacks
+ */
+export declare const CallbackListInputSchema: z.ZodObject<{
+    accountId: z.ZodString;
+    page: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    perPage: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    accountId: string;
+    page?: number | undefined;
+    perPage?: number | undefined;
+}, {
+    accountId: string;
+    page?: number | undefined;
+    perPage?: number | undefined;
+}>;
+/**
+ * Input schema for getting a single callback
+ */
+export declare const CallbackSingleInputSchema: z.ZodObject<{
+    accountId: z.ZodString;
+    callbackId: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    accountId: string;
+    callbackId: number;
+}, {
+    accountId: string;
+    callbackId: number;
+}>;
+/**
+ * Input schema for deleting a callback
+ */
+export declare const CallbackDeleteInputSchema: z.ZodObject<{
+    accountId: z.ZodString;
+    callbackId: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    accountId: string;
+    callbackId: number;
+}, {
+    accountId: string;
+    callbackId: number;
+}>;
+/**
+ * Input schema for verifying a callback
+ */
+export declare const CallbackVerifyInputSchema: z.ZodObject<{
+    accountId: z.ZodString;
+    callbackId: z.ZodNumber;
+    verifier: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    accountId: string;
+    callbackId: number;
+    verifier: string;
+}, {
+    accountId: string;
+    callbackId: number;
+    verifier: string;
+}>;
+/**
+ * Input schema for resending verification
+ */
+export declare const CallbackResendVerificationInputSchema: z.ZodObject<{
+    accountId: z.ZodString;
+    callbackId: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    accountId: string;
+    callbackId: number;
+}, {
+    accountId: string;
+    callbackId: number;
+}>;
+/**
+ * Pagination metadata schema
+ */
+export declare const PaginationMetadataSchema: z.ZodObject<{
+    page: z.ZodNumber;
+    pages: z.ZodNumber;
+    perPage: z.ZodNumber;
+    total: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    total: number;
+    page: number;
+    perPage: number;
+    pages: number;
+}, {
+    total: number;
+    page: number;
+    perPage: number;
+    pages: number;
+}>;
+/**
+ * Output schema for callback list
+ */
+export declare const CallbackListOutputSchema: z.ZodObject<{
+    callbacks: z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        event: z.ZodString;
+        uri: z.ZodString;
+        verified: z.ZodBoolean;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        uri: string;
+        createdAt: string;
+        id: number;
+        updatedAt: string;
+        event: string;
+        verified: boolean;
+    }, {
+        uri: string;
+        createdAt: string;
+        id: number;
+        updatedAt: string;
+        event: string;
+        verified: boolean;
+    }>, "many">;
+    pagination: z.ZodObject<{
+        page: z.ZodNumber;
+        pages: z.ZodNumber;
+        perPage: z.ZodNumber;
+        total: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        total: number;
+        page: number;
+        perPage: number;
+        pages: number;
+    }, {
+        total: number;
+        page: number;
+        perPage: number;
+        pages: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    pagination: {
+        total: number;
+        page: number;
+        perPage: number;
+        pages: number;
+    };
+    callbacks: {
+        uri: string;
+        createdAt: string;
+        id: number;
+        updatedAt: string;
+        event: string;
+        verified: boolean;
+    }[];
+}, {
+    pagination: {
+        total: number;
+        page: number;
+        perPage: number;
+        pages: number;
+    };
+    callbacks: {
+        uri: string;
+        createdAt: string;
+        id: number;
+        updatedAt: string;
+        event: string;
+        verified: boolean;
+    }[];
+}>;
+/**
+ * Output schema for single callback operations
+ */
+export declare const CallbackSingleOutputSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    event: z.ZodString;
+    uri: z.ZodString;
+    verified: z.ZodBoolean;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    uri: string;
+    createdAt: string;
+    id: number;
+    updatedAt: string;
+    event: string;
+    verified: boolean;
+}, {
+    uri: string;
+    createdAt: string;
+    id: number;
+    updatedAt: string;
+    event: string;
+    verified: boolean;
+}>;
+/**
+ * Output schema for callback deletion
+ */
+export declare const CallbackDeleteOutputSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    callbackId: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    success: boolean;
+    callbackId: number;
+}, {
+    success: boolean;
+    callbackId: number;
+}>;
+/**
+ * Output schema for callback verification
+ */
+export declare const CallbackVerifyOutputSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    verified: z.ZodBoolean;
+    callbackId: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    success: boolean;
+    verified: boolean;
+    callbackId: number;
+}, {
+    success: boolean;
+    verified: boolean;
+    callbackId: number;
+}>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/tools/callback/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/tools/callback/schemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;EAOzB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;EAIpC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;EAKpC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;EAWlC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;EAGpC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;EAGpC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;EAIpC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,qCAAqC;;;;;;;;;EAGhD,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;EAKnC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGnC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;EAAiB,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;EAGrC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;EAIrC,CAAC"}

package/dist/tools/callback/schemas.js

@@ -0,0 +1,114 @@
+/**
+ * Zod schemas for Callback (Webhook) entity
+ *
+ * Webhook/callback schemas for FreshBooks event notifications
+ */
+import { z } from 'zod';
+/**
+ * Full Callback schema with all properties
+ */
+export const CallbackSchema = z.object({
+    id: z.number().describe('Unique callback identifier'),
+    event: z.string().describe('Event type to listen for (e.g., invoice.create, payment.create)'),
+    uri: z.string().url().describe('Webhook endpoint URL to POST events to'),
+    verified: z.boolean().describe('Whether webhook ownership has been verified'),
+    createdAt: z.string().datetime().describe('Creation timestamp (ISO 8601)'),
+    updatedAt: z.string().datetime().describe('Last update timestamp (ISO 8601)'),
+});
+/**
+ * Input schema for creating a callback
+ */
+export const CallbackCreateInputSchema = z.object({
+    accountId: z.string().describe('FreshBooks account ID'),
+    event: z.string().min(1).describe('Event type to listen for (e.g., invoice.create, payment.create, time_entry.create)'),
+    uri: z.string().url().describe('Your webhook endpoint URL (must be HTTPS and publicly accessible)'),
+});
+/**
+ * Input schema for updating a callback
+ */
+export const CallbackUpdateInputSchema = z.object({
+    accountId: z.string().describe('FreshBooks account ID'),
+    callbackId: z.number().describe('Callback ID to update'),
+    event: z.string().min(1).optional().describe('Event type to listen for'),
+    uri: z.string().url().optional().describe('Webhook endpoint URL'),
+});
+/**
+ * Input schema for listing callbacks
+ */
+export const CallbackListInputSchema = z.object({
+    accountId: z.string().describe('FreshBooks account ID'),
+    page: z.number().int().min(1).default(1).optional().describe('Page number (1-indexed)'),
+    perPage: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .default(30)
+        .optional()
+        .describe('Number of results per page (max 100)'),
+});
+/**
+ * Input schema for getting a single callback
+ */
+export const CallbackSingleInputSchema = z.object({
+    accountId: z.string().describe('FreshBooks account ID'),
+    callbackId: z.number().describe('Callback ID to retrieve'),
+});
+/**
+ * Input schema for deleting a callback
+ */
+export const CallbackDeleteInputSchema = z.object({
+    accountId: z.string().describe('FreshBooks account ID'),
+    callbackId: z.number().describe('Callback ID to delete'),
+});
+/**
+ * Input schema for verifying a callback
+ */
+export const CallbackVerifyInputSchema = z.object({
+    accountId: z.string().describe('FreshBooks account ID'),
+    callbackId: z.number().describe('Callback ID to verify'),
+    verifier: z.string().describe('Verification code received at your webhook endpoint'),
+});
+/**
+ * Input schema for resending verification
+ */
+export const CallbackResendVerificationInputSchema = z.object({
+    accountId: z.string().describe('FreshBooks account ID'),
+    callbackId: z.number().describe('Callback ID to resend verification for'),
+});
+/**
+ * Pagination metadata schema
+ */
+export const PaginationMetadataSchema = z.object({
+    page: z.number().describe('Current page number'),
+    pages: z.number().describe('Total number of pages'),
+    perPage: z.number().describe('Results per page'),
+    total: z.number().describe('Total number of results'),
+});
+/**
+ * Output schema for callback list
+ */
+export const CallbackListOutputSchema = z.object({
+    callbacks: z.array(CallbackSchema).describe('Array of callbacks'),
+    pagination: PaginationMetadataSchema.describe('Pagination information'),
+});
+/**
+ * Output schema for single callback operations
+ */
+export const CallbackSingleOutputSchema = CallbackSchema;
+/**
+ * Output schema for callback deletion
+ */
+export const CallbackDeleteOutputSchema = z.object({
+    success: z.boolean().describe('Whether deletion was successful'),
+    callbackId: z.number().describe('ID of deleted callback'),
+});
+/**
+ * Output schema for callback verification
+ */
+export const CallbackVerifyOutputSchema = z.object({
+    success: z.boolean().describe('Whether verification was successful'),
+    verified: z.boolean().describe('Current verification status'),
+    callbackId: z.number().describe('ID of verified callback'),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/tools/callback/schemas.js.map

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