@goodsamsoftware/freshbooks-mcp 1.0.0

package/dist/utils/pagination.js

@@ -0,0 +1,62 @@
+/**
+ * Pagination utilities for FreshBooks API
+ */
+import { z } from 'zod';
+/**
+ * Standard pagination schema for tool inputs
+ */
+export const PaginationSchema = z.object({
+    page: z.number().int().min(1).default(1).describe('Page number (1-indexed)'),
+    perPage: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .default(30)
+        .describe('Number of results per page (max 100)'),
+});
+/**
+ * Extract pagination parameters from input
+ */
+export function getPaginationParams(input) {
+    const parsed = PaginationSchema.safeParse(input || {});
+    if (parsed.success) {
+        return parsed.data;
+    }
+    // Return defaults if parsing fails
+    return {
+        page: 1,
+        perPage: 30,
+    };
+}
+/**
+ * Create pagination metadata for responses
+ */
+export function createPaginationMetadata(page, perPage, total) {
+    const pages = Math.ceil(total / perPage);
+    return {
+        page,
+        pages,
+        perPage,
+        total,
+    };
+}
+/**
+ * Check if there are more pages available
+ */
+export function hasMorePages(pagination) {
+    return pagination.page < pagination.pages;
+}
+/**
+ * Get next page number, or null if no more pages
+ */
+export function getNextPage(pagination) {
+    return hasMorePages(pagination) ? pagination.page + 1 : null;
+}
+/**
+ * Get previous page number, or null if on first page
+ */
+export function getPreviousPage(pagination) {
+    return pagination.page > 1 ? pagination.page - 1 : null;
+}
+//# sourceMappingURL=pagination.js.map

package/dist/utils/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../src/utils/pagination.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IAC5E,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,sCAAsC,CAAC;CACpD,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAEvD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,mCAAmC;IACnC,OAAO;QACL,IAAI,EAAE,CAAC;QACP,OAAO,EAAE,EAAE;KACZ,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,IAAY,EACZ,OAAe,EACf,KAAa;IAEb,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,CAAC;IAEzC,OAAO;QACL,IAAI;QACJ,KAAK;QACL,OAAO;QACP,KAAK;KACN,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,UAA8B;IACzD,OAAO,UAAU,CAAC,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,UAA8B;IACxD,OAAO,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,UAA8B;IAC5D,OAAO,UAAU,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1D,CAAC"}

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "@goodsamsoftware/freshbooks-mcp",
+  "version": "1.0.0",
+  "description": "FreshBooks MCP server providing 1:1 parity with the FreshBooks Node.js SDK",
+  "type": "module",
+  "main": "dist/server.js",
+  "types": "dist/server.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js",
+      "require": "./dist/server.js"
+    },
+    "./tools": {
+      "types": "./dist/tools/index.d.ts",
+      "import": "./dist/tools/index.js",
+      "require": "./dist/tools/index.js"
+    },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "import": "./dist/client/index.js",
+      "require": "./dist/client/index.js"
+    },
+    "./auth": {
+      "types": "./dist/auth/index.d.ts",
+      "import": "./dist/auth/index.js",
+      "require": "./dist/auth/index.js"
+    },
+    "./errors": {
+      "types": "./dist/errors/index.d.ts",
+      "import": "./dist/errors/index.js",
+      "require": "./dist/errors/index.js"
+    },
+    "./utils": {
+      "types": "./dist/utils/index.d.ts",
+      "import": "./dist/utils/index.js",
+      "require": "./dist/utils/index.js"
+    }
+  },
+  "bin": {
+    "freshbooks-mcp": "./dist/server.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/server.js",
+    "dev": "tsx watch src/server.ts",
+    "test": "vitest",
+    "test:coverage": "vitest --coverage",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "freshbooks",
+    "mcp",
+    "model-context-protocol",
+    "time-tracking",
+    "invoicing"
+  ],
+  "author": "Chadwick Posey <chadwick.posey@goodsamsoftware.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mcsei/freshbooks-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/mcsei/freshbooks-mcp/issues"
+  },
+  "homepage": "https://github.com/mcsei/freshbooks-mcp#readme",
+  "dependencies": {
+    "@freshbooks/api": "^4.1.0",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "@faker-js/faker": "^8.3.1",
+    "@types/node": "^20.0.0",
+    "@vitest/coverage-v8": "^4.0.16",
+    "eslint": "^8.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^4.0.16"
+  }
+}