@goxtechnologies/connectwise-psa-mcp 1.3.0 → 1.4.2

package/dist/types/reports.d.ts

@@ -0,0 +1,87 @@
+export interface ReportNavigation {
+    strategy: 'menu' | 'url';
+    path?: string[];
+    url?: string;
+}
+export interface ReportParameter {
+    name: string;
+    type: 'string' | 'date' | 'number' | 'boolean';
+    required: boolean;
+    selector: string;
+    default?: string;
+}
+export interface ExtractionConfig {
+    strategy: 'xhr_first' | 'export' | 'dom';
+    xhrPattern?: string;
+    exportSelector?: string;
+    tableSelector?: string;
+    waitFor: string;
+}
+export interface ReportCacheConfig {
+    ttlMinutes: number;
+    keepHistory: boolean;
+}
+export interface ReportDefinition {
+    id: string;
+    name: string;
+    module: string;
+    type: 'standard' | 'custom';
+    navigation: ReportNavigation;
+    url?: string;
+    parameters: ReportParameter[];
+    extraction: ExtractionConfig;
+    cache: ReportCacheConfig;
+}
+export interface ReportConfig {
+    reports: ReportDefinition[];
+}
+export interface ReportData {
+    columns: string[];
+    rows: Record<string, string | number | null>[];
+}
+export interface ReportResult {
+    report_id: string;
+    report_name: string;
+    columns: string[];
+    rows: Record<string, string | number | null>[];
+    source: 'xhr' | 'export' | 'dom' | 'cache';
+    fetched_at: string;
+    cached: boolean;
+    params: Record<string, unknown>;
+}
+export interface CachedReport {
+    report_id: string;
+    params_hash: string;
+    params_json: string;
+    data: ReportData;
+    fetched_at: number;
+    source: 'xhr' | 'export' | 'dom';
+}
+export interface HistoryEntry {
+    id: number;
+    report_id: string;
+    params_hash: string;
+    params_json: string;
+    data: ReportData;
+    fetched_at: number;
+    source: string;
+}
+export interface CalibrationEntry {
+    id: number;
+    report_id: string;
+    params_hash: string;
+    params_json: string;
+    web_value: string;
+    api_value: string;
+    match_type: 'scalar' | 'row_count' | 'full_compare';
+    drift: number | null;
+    logged_at: number;
+}
+export interface LoginStep {
+    name: string;
+    detect: string;
+    timeout?: number;
+}
+export type ScraperParams = Record<string, unknown>;
+export type ScraperHandler = (params: ScraperParams, reportDef: ReportDefinition) => Promise<ReportData>;
+//# sourceMappingURL=reports.d.ts.map

package/dist/types/reports.d.ts.map

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

package/dist/types/reports.js

@@ -0,0 +1,3 @@
+// ConnectWise PSA MCP Server — Web Report Types
+export {};
+//# sourceMappingURL=reports.js.map

package/dist/types/reports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reports.js","sourceRoot":"","sources":["../../src/types/reports.ts"],"names":[],"mappings":"AAAA,gDAAgD"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@goxtechnologies/connectwise-psa-mcp",
-  "version": "1.3.0",
-  "description": "ConnectWise PSA MCP server — 22 tools, 509 named operations, 72 analytics handlers",
+  "version": "1.4.2",
+  "description": "ConnectWise PSA MCP server — 25 tools, 510 named operations, 73 analytics handlers, optional web report scraping",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
@@ -21,18 +21,32 @@
     "test:validation": "node --import tsx --test tests/unit/validation.test.ts",
     "test:db": "node --import tsx --test tests/unit/database.test.ts",
     "test:integration": "node --import tsx --test tests/integration/*.test.ts",
-    "test:mcp": "node --import tsx --test tests/integration/mcp-protocol.test.ts"
+    "test:mcp": "node --import tsx --test tests/integration/mcp-protocol.test.ts",
+    "test:totp": "node --import tsx --test tests/unit/totp.test.ts",
+    "test:cache": "node --import tsx --test tests/unit/report-cache.test.ts",
+    "test:config": "node --import tsx --test tests/unit/report-config.test.ts",
+    "test:web": "node --import tsx --test tests/integration/web-scraper.test.ts",
+    "test:time-entry": "node --import tsx --test tests/unit/time-entry-prepare.test.ts"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.1",
-    "better-sqlite3": "^11.0.0"
+    "better-sqlite3": "^11.10.0"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.0",
     "@types/node": "^22.0.0",
+    "playwright": "^1.52.0",
     "tsx": "^4.21.0",
     "typescript": "^5.7.0"
   },
+  "peerDependencies": {
+    "playwright": ">=1.40.0"
+  },
+  "peerDependenciesMeta": {
+    "playwright": {
+      "optional": true
+    }
+  },
   "engines": {
     "node": ">=18.0.0"
   },