jobber-mcp-server 1.0.0

package/dist/tools/requests.js

@@ -0,0 +1,117 @@
+/**
+ * MCP tools for Jobber service request operations.
+ */
+import { z } from "zod";
+import { jobberRequest, CREATE_REQUEST, LIST_REQUESTS, GET_REQUEST, CREATE_REQUEST_NOTE, } from "../graphql/queries.js";
+import { extractUserErrors, formatErrorForMCP } from "../utils/errors.js";
+export function registerRequestTools(server) {
+    // ── Create Request ───────────────────────────────────────────────
+    server.tool("jobber_create_request", "Create a new service request in Jobber. A request represents an incoming inquiry from a customer that hasn't been converted to a job yet. Optionally attach a note with details about the issue.", {
+        client_id: z
+            .string()
+            .describe("The Jobber client ID to create the request for. Search for or create the client first."),
+        title: z
+            .string()
+            .max(255)
+            .describe("Short title for the request (max 255 chars). E.g. 'Leaking kitchen faucet', 'Annual furnace maintenance'."),
+        details: z
+            .string()
+            .optional()
+            .describe("Detailed description of the service request. This gets added as a note on the request since Jobber doesn't have a details field on requests directly."),
+        property_id: z
+            .string()
+            .optional()
+            .describe("The property ID if the request is for a specific service address. Get this from the client's properties."),
+    }, async ({ client_id, title, details, property_id }) => {
+        try {
+            const input = {
+                clientId: client_id,
+                title,
+            };
+            if (property_id)
+                input.propertyId = property_id;
+            const data = await jobberRequest(CREATE_REQUEST, { input });
+            const result = data.requestCreate;
+            const userErr = extractUserErrors(result);
+            if (userErr) {
+                return {
+                    content: [{ type: "text", text: `Failed to create request: ${userErr}` }],
+                    isError: true,
+                };
+            }
+            const request = result.request;
+            // Add details as a note if provided
+            if (details && request.id) {
+                try {
+                    await jobberRequest(CREATE_REQUEST_NOTE, {
+                        requestId: request.id,
+                        message: details,
+                    });
+                }
+                catch {
+                    // Non-fatal — request was created, note just failed
+                    console.error("[jobber-mcp] Failed to add note to request");
+                }
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(request, null, 2) }],
+            };
+        }
+        catch (error) {
+            return formatErrorForMCP(error);
+        }
+    });
+    // ── List Requests ────────────────────────────────────────────────
+    server.tool("jobber_list_requests", "List service requests in Jobber. Returns requests with their status, client, and property info. Supports pagination for large result sets.", {
+        limit: z
+            .number()
+            .min(1)
+            .max(50)
+            .default(20)
+            .describe("Maximum number of requests to return. Default 20, max 50."),
+        after: z
+            .string()
+            .optional()
+            .describe("Pagination cursor — pass the endCursor from a previous response to get the next page."),
+    }, async ({ limit, after }) => {
+        try {
+            const variables = { first: limit };
+            if (after)
+                variables.after = after;
+            const data = await jobberRequest(LIST_REQUESTS, variables);
+            const requests = data.requests;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            total_count: requests.totalCount,
+                            requests: requests.nodes,
+                            page_info: requests.pageInfo,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return formatErrorForMCP(error);
+        }
+    });
+    // ── Get Request ──────────────────────────────────────────────────
+    server.tool("jobber_get_request", "Get full details for a specific service request by ID. Returns the request with client contact info and property address.", {
+        request_id: z.string().describe("The Jobber request ID"),
+    }, async ({ request_id }) => {
+        try {
+            const data = await jobberRequest(GET_REQUEST, { id: request_id });
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify(data.request, null, 2) },
+                ],
+            };
+        }
+        catch (error) {
+            return formatErrorForMCP(error);
+        }
+    });
+}
+//# sourceMappingURL=requests.js.map

package/dist/tools/requests.js.map

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

package/dist/tools/scheduling.d.ts

@@ -0,0 +1,6 @@
+/**
+ * MCP tools for Jobber scheduling and calendar operations.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerSchedulingTools(server: McpServer): void;
+//# sourceMappingURL=scheduling.d.ts.map

package/dist/tools/scheduling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduling.d.ts","sourceRoot":"","sources":["../../src/tools/scheduling.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAoBpE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoP/D"}

package/dist/tools/scheduling.js

@@ -0,0 +1,197 @@
+/**
+ * MCP tools for Jobber scheduling and calendar operations.
+ */
+import { z } from "zod";
+import { jobberRequest, GET_SCHEDULE, CREATE_VISIT, LIST_USERS, } from "../graphql/queries.js";
+import { extractUserErrors, formatErrorForMCP } from "../utils/errors.js";
+export function registerSchedulingTools(server) {
+    // ── Get Schedule ─────────────────────────────────────────────────
+    server.tool("jobber_get_schedule", "Get the schedule of jobs and visits for a date range. Shows what's booked, who's assigned, and when. Essential for checking availability before booking new work.", {
+        start_date: z
+            .string()
+            .describe("Start date in ISO 8601 format (YYYY-MM-DD). E.g. '2026-03-28'."),
+        end_date: z
+            .string()
+            .describe("End date in ISO 8601 format (YYYY-MM-DD). E.g. '2026-04-04'."),
+        team_member_name: z
+            .string()
+            .optional()
+            .describe("Filter by team member name (partial match). Only shows visits assigned to this person."),
+        limit: z
+            .number()
+            .min(1)
+            .max(50)
+            .default(50)
+            .describe("Maximum number of jobs to return. Default 50."),
+    }, async ({ start_date, end_date, team_member_name, limit }) => {
+        try {
+            const data = await jobberRequest(GET_SCHEDULE, {
+                startAt: start_date,
+                endAt: end_date,
+                first: limit,
+            });
+            let jobs = (data.jobs?.nodes ?? []);
+            // Filter by team member if specified
+            if (team_member_name) {
+                const nameFilter = team_member_name.toLowerCase();
+                jobs = jobs.filter((job) => {
+                    const visits = job.visits?.nodes ?? [];
+                    return visits.some((v) => v.assignedUsers?.nodes?.some((u) => u.name.full.toLowerCase().includes(nameFilter)));
+                });
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            date_range: { start: start_date, end: end_date },
+                            total_jobs: jobs.length,
+                            jobs,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return formatErrorForMCP(error);
+        }
+    });
+    // ── Create Visit ─────────────────────────────────────────────────
+    server.tool("jobber_create_visit", "Schedule a visit (appointment) for an existing job. A visit is a specific time slot when a team member goes to do the work. The job must already exist — create it first with jobber_create_job.", {
+        job_id: z.string().describe("The Jobber job ID to schedule the visit for"),
+        start_at: z
+            .string()
+            .describe("Visit start time in ISO 8601 datetime format (e.g. '2026-03-28T09:00:00-04:00'). Include timezone offset."),
+        end_at: z
+            .string()
+            .describe("Visit end time in ISO 8601 datetime format (e.g. '2026-03-28T11:00:00-04:00'). Include timezone offset."),
+        team_member_ids: z
+            .array(z.string())
+            .optional()
+            .describe("Array of Jobber user IDs to assign to this visit. Get IDs from jobber_get_availability. Omit to leave unassigned."),
+        instructions: z
+            .string()
+            .optional()
+            .describe("Special instructions for this visit (shown to the assigned team member)"),
+    }, async ({ job_id, start_at, end_at, team_member_ids, instructions }) => {
+        try {
+            const input = {
+                jobId: job_id,
+                startAt: start_at,
+                endAt: end_at,
+            };
+            if (team_member_ids && team_member_ids.length > 0) {
+                input.assignedEntityIds = team_member_ids;
+            }
+            if (instructions) {
+                input.instructions = instructions;
+            }
+            const data = await jobberRequest(CREATE_VISIT, { input });
+            const result = data.visitCreate;
+            const userErr = extractUserErrors(result);
+            if (userErr) {
+                return {
+                    content: [
+                        { type: "text", text: `Failed to create visit: ${userErr}` },
+                    ],
+                    isError: true,
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(result.visit, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return formatErrorForMCP(error);
+        }
+    });
+    // ── Get Availability ─────────────────────────────────────────────
+    server.tool("jobber_get_availability", "Check available time slots for team members on a given date range. This derives availability by fetching the existing schedule and finding gaps. Returns team members and their booked/free time slots. Assumes a standard work day of 8:00-17:00.", {
+        start_date: z
+            .string()
+            .describe("Start date in YYYY-MM-DD format"),
+        end_date: z
+            .string()
+            .describe("End date in YYYY-MM-DD format"),
+        work_day_start: z
+            .string()
+            .default("08:00")
+            .describe("Work day start time in HH:MM format. Default '08:00'."),
+        work_day_end: z
+            .string()
+            .default("17:00")
+            .describe("Work day end time in HH:MM format. Default '17:00'."),
+    }, async ({ start_date, end_date, work_day_start, work_day_end }) => {
+        try {
+            // Fetch team members
+            const usersData = await jobberRequest(LIST_USERS, { first: 50 });
+            const users = (usersData.users?.nodes ??
+                []);
+            // Fetch schedule for the date range
+            const scheduleData = await jobberRequest(GET_SCHEDULE, {
+                startAt: start_date,
+                endAt: end_date,
+                first: 50,
+            });
+            const scheduledJobs = (scheduleData.jobs?.nodes ?? []);
+            // Build a map of team_member_id -> booked time slots
+            const bookedSlots = new Map();
+            for (const job of scheduledJobs) {
+                const visits = job.visits?.nodes ?? [];
+                for (const visit of visits) {
+                    const assignedUsers = visit.assignedUsers?.nodes ?? [];
+                    for (const user of assignedUsers) {
+                        if (!bookedSlots.has(user.id)) {
+                            bookedSlots.set(user.id, []);
+                        }
+                        bookedSlots.get(user.id).push({
+                            start: visit.startAt,
+                            end: visit.endAt,
+                            job_title: job.title ?? "Untitled",
+                        });
+                    }
+                }
+            }
+            // Build availability per team member
+            const availability = users
+                .filter((u) => u.role !== "ACCOUNT_OWNER" || users.length <= 2) // Include owner for small teams
+                .map((user) => {
+                const booked = bookedSlots.get(user.id) ?? [];
+                return {
+                    id: user.id,
+                    name: user.name.full,
+                    role: user.role,
+                    booked_slots: booked.sort((a, b) => new Date(a.start).getTime() - new Date(b.start).getTime()),
+                    work_hours: { start: work_day_start, end: work_day_end },
+                    total_booked_hours: booked.reduce((sum, slot) => {
+                        const dur = (new Date(slot.end).getTime() - new Date(slot.start).getTime()) /
+                            3_600_000;
+                        return sum + dur;
+                    }, 0),
+                };
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            date_range: { start: start_date, end: end_date },
+                            work_hours: { start: work_day_start, end: work_day_end },
+                            team_availability: availability,
+                            note: "Free time = work_hours minus booked_slots. Derive open windows from the gaps.",
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return formatErrorForMCP(error);
+        }
+    });
+}
+//# sourceMappingURL=scheduling.js.map

package/dist/tools/scheduling.js.map

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

package/dist/transport.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Transport configuration for stdio and streamable-http modes.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function startStdioTransport(server: McpServer): Promise<void>;
+export declare function startHttpTransport(server: McpServer): Promise<void>;
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAI1E;AAED,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAsEzE"}

package/dist/transport.js

@@ -0,0 +1,75 @@
+/**
+ * Transport configuration for stdio and streamable-http modes.
+ */
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import express from "express";
+import { randomUUID } from "crypto";
+export async function startStdioTransport(server) {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("[jobber-mcp] Server running on stdio transport");
+}
+export async function startHttpTransport(server) {
+    const app = express();
+    app.use(express.json());
+    // Store transports by session ID
+    const transports = new Map();
+    app.post("/mcp", async (req, res) => {
+        const sessionId = req.headers["mcp-session-id"];
+        if (sessionId && transports.has(sessionId)) {
+            // Existing session
+            const transport = transports.get(sessionId);
+            await transport.handleRequest(req, res, req.body);
+        }
+        else {
+            // New session
+            const newTransport = new StreamableHTTPServerTransport({
+                sessionIdGenerator: () => randomUUID(),
+            });
+            newTransport.onclose = () => {
+                const sid = newTransport.sessionId;
+                if (sid)
+                    transports.delete(sid);
+            };
+            await server.connect(newTransport);
+            await newTransport.handleRequest(req, res, req.body);
+            // Store the transport using its session ID
+            const sid = res.getHeader("mcp-session-id");
+            if (sid) {
+                transports.set(sid, newTransport);
+            }
+        }
+    });
+    app.get("/mcp", async (req, res) => {
+        const sessionId = req.headers["mcp-session-id"];
+        if (sessionId && transports.has(sessionId)) {
+            const transport = transports.get(sessionId);
+            await transport.handleRequest(req, res);
+        }
+        else {
+            res.status(400).json({ error: "No session. Send a POST to /mcp first." });
+        }
+    });
+    app.delete("/mcp", async (req, res) => {
+        const sessionId = req.headers["mcp-session-id"];
+        if (sessionId && transports.has(sessionId)) {
+            const transport = transports.get(sessionId);
+            await transport.handleRequest(req, res);
+            transports.delete(sessionId);
+        }
+        else {
+            res.status(400).json({ error: "No session found." });
+        }
+    });
+    // Health check
+    app.get("/health", (_req, res) => {
+        res.json({ status: "ok", transport: "streamable-http" });
+    });
+    const port = parseInt(process.env.HTTP_PORT ?? "3000", 10);
+    const host = process.env.HTTP_HOST ?? "localhost";
+    app.listen(port, host, () => {
+        console.error(`[jobber-mcp] Server running on streamable-http at http://${host}:${port}/mcp`);
+    });
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

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

package/dist/utils/errors.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Error handling utilities for Jobber GraphQL API responses.
+ *
+ * Maps raw GraphQL errors and userErrors into clear, actionable messages
+ * that Claude (or any MCP consumer) can understand and act on.
+ */
+export declare class JobberAPIError extends Error {
+    readonly statusCode: number | undefined;
+    readonly graphqlErrors: unknown[];
+    readonly userErrors: Array<{
+        message: string;
+        path?: string[];
+    }>;
+    constructor(message: string, opts?: {
+        statusCode?: number;
+        graphqlErrors?: unknown[];
+        userErrors?: Array<{
+            message: string;
+            path?: string[];
+        }>;
+    });
+}
+/**
+ * Extract a clean error message from a Jobber GraphQL response.
+ * Handles both top-level `errors` array and mutation-level `userErrors`.
+ */
+export declare function extractErrors(data: Record<string, unknown>): string | null;
+/**
+ * Check a mutation result for userErrors. Returns the error string or null.
+ */
+export declare function extractUserErrors(mutationResult: Record<string, unknown>): string | null;
+/**
+ * Format a JobberAPIError for MCP tool response.
+ */
+export declare function formatErrorForMCP(error: unknown): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError: true;
+};
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qBAAa,cAAe,SAAQ,KAAK;IACvC,SAAgB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/C,SAAgB,aAAa,EAAE,OAAO,EAAE,CAAC;IACzC,SAAgB,UAAU,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;gBAGtE,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;QACL,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC;QAC1B,UAAU,CAAC,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC,CAAC;KAC1D;CAQJ;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI,CAU1E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACtC,MAAM,GAAG,IAAI,CAaf;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG;IACjD,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,EAAE,IAAI,CAAC;CACf,CAqBA"}

package/dist/utils/errors.js

@@ -0,0 +1,72 @@
+/**
+ * Error handling utilities for Jobber GraphQL API responses.
+ *
+ * Maps raw GraphQL errors and userErrors into clear, actionable messages
+ * that Claude (or any MCP consumer) can understand and act on.
+ */
+export class JobberAPIError extends Error {
+    statusCode;
+    graphqlErrors;
+    userErrors;
+    constructor(message, opts) {
+        super(message);
+        this.name = "JobberAPIError";
+        this.statusCode = opts?.statusCode;
+        this.graphqlErrors = opts?.graphqlErrors ?? [];
+        this.userErrors = opts?.userErrors ?? [];
+    }
+}
+/**
+ * Extract a clean error message from a Jobber GraphQL response.
+ * Handles both top-level `errors` array and mutation-level `userErrors`.
+ */
+export function extractErrors(data) {
+    // Top-level GraphQL errors
+    if (Array.isArray(data.errors) && data.errors.length > 0) {
+        const messages = data.errors
+            .map((e) => e.message ?? "Unknown error")
+            .join("; ");
+        return messages;
+    }
+    return null;
+}
+/**
+ * Check a mutation result for userErrors. Returns the error string or null.
+ */
+export function extractUserErrors(mutationResult) {
+    const userErrors = mutationResult.userErrors;
+    if (!userErrors || userErrors.length === 0)
+        return null;
+    return userErrors
+        .map((e) => {
+        const path = e.path ? ` (${e.path.join(".")})` : "";
+        return `${e.message}${path}`;
+    })
+        .join("; ");
+}
+/**
+ * Format a JobberAPIError for MCP tool response.
+ */
+export function formatErrorForMCP(error) {
+    let message;
+    if (error instanceof JobberAPIError) {
+        message = error.message;
+        if (error.userErrors.length > 0) {
+            const details = error.userErrors
+                .map((e) => `- ${e.message}`)
+                .join("\n");
+            message += `\n\nDetails:\n${details}`;
+        }
+    }
+    else if (error instanceof Error) {
+        message = error.message;
+    }
+    else {
+        message = String(error);
+    }
+    return {
+        content: [{ type: "text", text: `Error: ${message}` }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvB,UAAU,CAAqB;IAC/B,aAAa,CAAY;IACzB,UAAU,CAA8C;IAExE,YACE,OAAe,EACf,IAIC;QAED,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,IAAI,EAAE,UAAU,CAAC;QACnC,IAAI,CAAC,aAAa,GAAG,IAAI,EAAE,aAAa,IAAI,EAAE,CAAC;QAC/C,IAAI,CAAC,UAAU,GAAG,IAAI,EAAE,UAAU,IAAI,EAAE,CAAC;IAC3C,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAA6B;IACzD,2BAA2B;IAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM;aACzB,GAAG,CAAC,CAAC,CAAuB,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,eAAe,CAAC;aAC9D,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,cAAuC;IAEvC,MAAM,UAAU,GAAG,cAAc,CAAC,UAErB,CAAC;IAEd,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAExD,OAAO,UAAU;SACd,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,OAAO,GAAG,CAAC,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC;IAC/B,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAI9C,IAAI,OAAe,CAAC;IAEpB,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;QACpC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QACxB,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU;iBAC7B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;iBAC5B,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,OAAO,IAAI,iBAAiB,OAAO,EAAE,CAAC;QACxC,CAAC;IACH,CAAC;SAAM,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAClC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;QACtD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}

package/dist/utils/pagination.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Cursor-based pagination helper for Jobber's GraphQL API.
+ *
+ * Jobber uses the `first` / `after` pattern with `pageInfo.hasNextPage`
+ * and `pageInfo.endCursor`.
+ */
+export interface PageInfo {
+    hasNextPage: boolean;
+    endCursor: string | null;
+}
+export interface PaginatedResult<T> {
+    nodes: T[];
+    totalCount: number | null;
+    pageInfo: PageInfo;
+}
+/**
+ * Fetch a single page from a paginated Jobber query.
+ *
+ * @param query - The GraphQL query string (must include $first and $after variables)
+ * @param variables - Query variables (first, after, plus any filters)
+ * @param rootField - The top-level field in the response (e.g. "clients", "jobs")
+ * @returns Parsed page with nodes, totalCount, and pageInfo
+ */
+export declare function fetchPage<T>(query: string, variables: Record<string, unknown>, rootField: string): Promise<PaginatedResult<T>>;
+/**
+ * Fetch all pages from a paginated query (up to maxPages to prevent runaway).
+ */
+export declare function fetchAllPages<T>(query: string, variables: Record<string, unknown>, rootField: string, maxPages?: number): Promise<T[]>;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/utils/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/utils/pagination.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAqB7B;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,CAAC,EACnC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,SAAS,EAAE,MAAM,EACjB,QAAQ,SAAK,GACZ,OAAO,CAAC,CAAC,EAAE,CAAC,CAmBd"}

package/dist/utils/pagination.js

@@ -0,0 +1,49 @@
+/**
+ * Cursor-based pagination helper for Jobber's GraphQL API.
+ *
+ * Jobber uses the `first` / `after` pattern with `pageInfo.hasNextPage`
+ * and `pageInfo.endCursor`.
+ */
+import { jobberRequest } from "../graphql/queries.js";
+/**
+ * Fetch a single page from a paginated Jobber query.
+ *
+ * @param query - The GraphQL query string (must include $first and $after variables)
+ * @param variables - Query variables (first, after, plus any filters)
+ * @param rootField - The top-level field in the response (e.g. "clients", "jobs")
+ * @returns Parsed page with nodes, totalCount, and pageInfo
+ */
+export async function fetchPage(query, variables, rootField) {
+    const data = await jobberRequest(query, variables);
+    const root = data[rootField];
+    if (!root) {
+        return {
+            nodes: [],
+            totalCount: null,
+            pageInfo: { hasNextPage: false, endCursor: null },
+        };
+    }
+    return {
+        nodes: root.nodes ?? [],
+        totalCount: root.totalCount ?? null,
+        pageInfo: root.pageInfo ?? { hasNextPage: false, endCursor: null },
+    };
+}
+/**
+ * Fetch all pages from a paginated query (up to maxPages to prevent runaway).
+ */
+export async function fetchAllPages(query, variables, rootField, maxPages = 10) {
+    const allNodes = [];
+    let cursor = null;
+    let page = 0;
+    while (page < maxPages) {
+        const result = await fetchPage(query, { ...variables, after: cursor }, rootField);
+        allNodes.push(...result.nodes);
+        if (!result.pageInfo.hasNextPage || !result.pageInfo.endCursor)
+            break;
+        cursor = result.pageInfo.endCursor;
+        page++;
+    }
+    return allNodes;
+}
+//# sourceMappingURL=pagination.js.map