@goxtechnologies/connectwise-psa-mcp 1.1.0

package/dist/services/connectwise-api.js

@@ -0,0 +1,198 @@
+// ConnectWise PSA MCP Server — ConnectWise Manage REST API HTTP Client
+const DEFAULT_TIMEOUT_MS = 30_000;
+const PAGE_SIZE = 250;
+const DEFAULT_MAX_ITEMS = 5_000;
+const MAX_RETRIES = 3;
+const RATE_LIMIT_WARN_THRESHOLD = 10;
+// Delays in ms for retry attempts: 1s, 3s, 9s (exponential backoff)
+const RETRY_DELAYS_MS = [1_000, 3_000, 9_000];
+// HTTP status codes that warrant a retry
+const RETRYABLE_STATUSES = new Set([409, 429, 500]);
+export class ConnectWiseAPI {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Build the Basic auth header and required ConnectWise headers.
+     * Credentials: base64(authPrefix+publicKey:privateKey)
+     */
+    getAuthHeaders() {
+        const username = `${this.config.authPrefix}${this.config.publicKey}`;
+        const credentials = Buffer.from(`${username}:${this.config.privateKey}`).toString('base64');
+        return {
+            Authorization: `Basic ${credentials}`,
+            clientId: this.config.companyId,
+            'Content-Type': 'application/json',
+        };
+    }
+    /**
+     * Core HTTP request using native fetch (Node 18+).
+     * Builds the full URL from config.apiUrl + path. Query params are always
+     * appended to the URL as a query string. The request body is JSON-encoded
+     * for POST/PUT/PATCH. Emits a rate-limit warning when
+     * X-RateLimit-Remaining drops below 10. Does NOT truncate response data.
+     */
+    async request(options) {
+        const { path, method, params, body, timeout = DEFAULT_TIMEOUT_MS } = options;
+        const queryString = params
+            ? new URLSearchParams(Object.entries(params).map(([k, v]) => [k, String(v)])).toString()
+            : '';
+        const url = queryString
+            ? `${this.config.apiUrl}${path}?${queryString}`
+            : `${this.config.apiUrl}${path}`;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeout);
+        let response;
+        try {
+            response = await fetch(url, {
+                method,
+                headers: this.getAuthHeaders(),
+                body: body !== undefined ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+        // Rate-limit warning before body consumption
+        const remaining = response.headers.get('X-RateLimit-Remaining');
+        if (remaining !== null && Number(remaining) < RATE_LIMIT_WARN_THRESHOLD) {
+            console.warn(`[ConnectWiseAPI] Rate limit warning: X-RateLimit-Remaining=${remaining}`);
+        }
+        // Collect all response headers into a plain object
+        const headers = {};
+        response.headers.forEach((value, key) => {
+            headers[key] = value;
+        });
+        // Parse body — JSON when Content-Type indicates it, otherwise raw text
+        let data;
+        const contentType = response.headers.get('Content-Type') ?? '';
+        if (contentType.includes('application/json')) {
+            data = (await response.json());
+        }
+        else {
+            data = (await response.text());
+        }
+        if (!response.ok) {
+            throw new Error(`[ConnectWiseAPI] HTTP ${response.status} ${response.statusText} — ${url}\n${JSON.stringify(data)}`);
+        }
+        return { data, status: response.status, headers };
+    }
+    /**
+     * Retry wrapper around `request`. Retries up to MAX_RETRIES (3) times on
+     * HTTP 409, 429, or 500 with exponential backoff (1 s -> 3 s -> 9 s).
+     */
+    async requestWithRetry(options) {
+        let lastError;
+        for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+            try {
+                return await this.request(options);
+            }
+            catch (err) {
+                lastError = err;
+                const message = err instanceof Error ? err.message : String(err);
+                const statusMatch = /HTTP (\d{3})/.exec(message);
+                const status = statusMatch ? Number(statusMatch[1]) : null;
+                const isRetryable = status !== null && RETRYABLE_STATUSES.has(status);
+                if (!isRetryable || attempt === MAX_RETRIES) {
+                    break;
+                }
+                const delayMs = RETRY_DELAYS_MS[attempt] ?? RETRY_DELAYS_MS[RETRY_DELAYS_MS.length - 1];
+                console.warn(`[ConnectWiseAPI] Retryable error (HTTP ${status}), attempt ${attempt + 1}/${MAX_RETRIES}. Waiting ${delayMs}ms...`);
+                await new Promise((resolve) => setTimeout(resolve, delayMs));
+            }
+        }
+        throw lastError;
+    }
+    /**
+     * Auto-paginate through all pages of a collection endpoint.
+     * Pages are fetched with pageSize=250. Stops when a page returns fewer
+     * than 250 items. If accumulated items exceed maxItems (default 5000),
+     * stops early and sets truncated=true.
+     */
+    async paginatedFetch(path, conditions, fields, maxItems = DEFAULT_MAX_ITEMS) {
+        const items = [];
+        let page = 1;
+        let pagesFetched = 0;
+        let truncated = false;
+        while (true) {
+            const params = {
+                page,
+                pageSize: PAGE_SIZE,
+            };
+            if (conditions)
+                params['conditions'] = conditions;
+            if (fields)
+                params['fields'] = fields;
+            const response = await this.requestWithRetry({ path, method: 'GET', params });
+            const pageItems = response.data ?? [];
+            pagesFetched += 1;
+            for (const item of pageItems) {
+                if (items.length >= maxItems) {
+                    truncated = true;
+                    break;
+                }
+                items.push(item);
+            }
+            if (truncated || pageItems.length < PAGE_SIZE) {
+                break;
+            }
+            page += 1;
+        }
+        return { items, totalCount: items.length, pagesFetched, truncated };
+    }
+    /**
+     * Retrieve the total record count for a given path.
+     * Tries `${path}/count` first. Falls back to `${path}count` on 404.
+     * Expects the count endpoint to return { count: number }.
+     */
+    async count(path, conditions) {
+        const params = {};
+        if (conditions)
+            params['conditions'] = conditions;
+        const base = path.endsWith('/') ? path.slice(0, -1) : path;
+        try {
+            const res = await this.request({
+                path: `${base}/count`,
+                method: 'GET',
+                params,
+            });
+            return res.data.count;
+        }
+        catch (primaryErr) {
+            const message = primaryErr instanceof Error ? primaryErr.message : String(primaryErr);
+            if (/HTTP 404/.test(message)) {
+                const res = await this.request({
+                    path: `${base}count`,
+                    method: 'GET',
+                    params,
+                });
+                return res.data.count;
+            }
+            throw primaryErr;
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Singleton factory
+// ---------------------------------------------------------------------------
+let instance = null;
+/**
+ * Returns the shared ConnectWiseAPI singleton, initialised from environment
+ * variables on first call:
+ *   CW_API_URL, CW_COMPANY_ID, CW_PUBLIC_KEY, CW_PRIVATE_KEY, CW_AUTH_PREFIX
+ */
+export function getAPI() {
+    if (!instance) {
+        instance = new ConnectWiseAPI({
+            apiUrl: process.env['CW_API_URL'] ?? '',
+            companyId: process.env['CW_COMPANY_ID'] ?? '',
+            publicKey: process.env['CW_PUBLIC_KEY'] ?? '',
+            privateKey: process.env['CW_PRIVATE_KEY'] ?? '',
+            authPrefix: process.env['CW_AUTH_PREFIX'] ?? '',
+        });
+    }
+    return instance;
+}
+//# sourceMappingURL=connectwise-api.js.map

package/dist/services/connectwise-api.js.map

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

package/dist/services/db-builder.d.ts

@@ -0,0 +1,11 @@
+/**
+ * db-builder.ts
+ *
+ * Parses the ConnectWise OpenAPI spec (manage.json) and builds a SQLite
+ * database used at runtime for endpoint discovery.
+ *
+ * Run via: node dist/services/db-builder.js
+ * Invoked automatically by the `build:db` npm script after `tsc`.
+ */
+export declare function buildDatabase(): void;
+//# sourceMappingURL=db-builder.d.ts.map

package/dist/services/db-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-builder.d.ts","sourceRoot":"","sources":["../../src/services/db-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA8MH,wBAAgB,aAAa,IAAI,IAAI,CAoKpC"}

package/dist/services/db-builder.js

@@ -0,0 +1,237 @@
+/**
+ * db-builder.ts
+ *
+ * Parses the ConnectWise OpenAPI spec (manage.json) and builds a SQLite
+ * database used at runtime for endpoint discovery.
+ *
+ * Run via: node dist/services/db-builder.js
+ * Invoked automatically by the `build:db` npm script after `tsc`.
+ */
+import Database from 'better-sqlite3';
+import { existsSync, readFileSync, unlinkSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+// ---------------------------------------------------------------------------
+// ESM __dirname shim
+// ---------------------------------------------------------------------------
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+const HTTP_METHODS = ['get', 'post', 'put', 'patch', 'delete'];
+/**
+ * Safely JSON-stringify a value, returning an empty string on failure.
+ * Avoids crashing on circular references or non-serialisable values.
+ */
+function safeStringify(value) {
+    if (value === undefined || value === null)
+        return '';
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Pick the first media-type entry from a content map that carries a schema or
+ * example, preferring well-known types but accepting any key present.
+ */
+function pickMediaType(content) {
+    if (!content)
+        return undefined;
+    // Prefer standard JSON content types first.
+    const preferredKeys = [
+        'application/json',
+        'application/json; charset=utf-8',
+    ];
+    for (const key of preferredKeys) {
+        if (content[key])
+            return content[key];
+    }
+    // Fall back to the first available key (ConnectWise uses a versioned media
+    // type: "application/vnd.connectwise.com+json; version=2025.1").
+    const firstKey = Object.keys(content)[0];
+    return firstKey !== undefined ? content[firstKey] : undefined;
+}
+// ---------------------------------------------------------------------------
+// DDL — split into individual statements so each can be prepared and run
+// without needing the multi-statement exec() shortcut
+// ---------------------------------------------------------------------------
+const DDL_STATEMENTS = [
+    `CREATE TABLE endpoints (
+    id          INTEGER PRIMARY KEY AUTOINCREMENT,
+    path        TEXT    NOT NULL,
+    method      TEXT    NOT NULL,
+    description TEXT,
+    category    TEXT,
+    summary     TEXT,
+    tags        TEXT,
+    UNIQUE(path, method)
+  )`,
+    `CREATE TABLE parameters (
+    id          INTEGER PRIMARY KEY AUTOINCREMENT,
+    endpoint_id INTEGER NOT NULL,
+    name        TEXT    NOT NULL,
+    location    TEXT    NOT NULL,
+    required    INTEGER NOT NULL DEFAULT 0,
+    type        TEXT,
+    description TEXT,
+    FOREIGN KEY (endpoint_id) REFERENCES endpoints(id)
+  )`,
+    `CREATE TABLE request_bodies (
+    id          INTEGER PRIMARY KEY AUTOINCREMENT,
+    endpoint_id INTEGER NOT NULL,
+    schema      TEXT,
+    example     TEXT,
+    FOREIGN KEY (endpoint_id) REFERENCES endpoints(id)
+  )`,
+    `CREATE TABLE response_bodies (
+    id          INTEGER PRIMARY KEY AUTOINCREMENT,
+    endpoint_id INTEGER NOT NULL,
+    status_code TEXT    NOT NULL,
+    description TEXT,
+    schema      TEXT,
+    example     TEXT,
+    FOREIGN KEY (endpoint_id) REFERENCES endpoints(id)
+  )`,
+    'CREATE INDEX idx_endpoints_path     ON endpoints(path)',
+    'CREATE INDEX idx_endpoints_method   ON endpoints(method)',
+    'CREATE INDEX idx_endpoints_tags     ON endpoints(tags)',
+    'CREATE INDEX idx_endpoints_category ON endpoints(category)',
+];
+// ---------------------------------------------------------------------------
+// Core builder
+// ---------------------------------------------------------------------------
+export function buildDatabase() {
+    const manageJsonPath = join(__dirname, '../../data/manage.json');
+    const dbPath = join(__dirname, '../../data/connectwise_api.db');
+    // ---- Load spec ----------------------------------------------------------
+    if (!existsSync(manageJsonPath)) {
+        throw new Error(`manage.json not found at: ${manageJsonPath}`);
+    }
+    console.log(`Reading spec from: ${manageJsonPath}`);
+    const raw = readFileSync(manageJsonPath, 'utf-8');
+    const spec = JSON.parse(raw);
+    // ---- Destroy existing DB so we always rebuild cleanly -------------------
+    if (existsSync(dbPath)) {
+        console.log('Existing database found — deleting for fresh rebuild.');
+        unlinkSync(dbPath);
+    }
+    // ---- Create database & apply schema -------------------------------------
+    const db = new Database(dbPath);
+    // WAL mode for better write throughput during the bulk insert.
+    db.pragma('journal_mode = WAL');
+    db.pragma('synchronous = NORMAL');
+    // Run each DDL statement individually via prepare + run so that we avoid
+    // calling the multi-statement shorthand method.
+    for (const stmt of DDL_STATEMENTS) {
+        db.prepare(stmt).run();
+    }
+    // ---- Prepared statements ------------------------------------------------
+    const insertEndpoint = db.prepare(`
+    INSERT OR IGNORE INTO endpoints (path, method, description, category, summary, tags)
+    VALUES (@path, @method, @description, @category, @summary, @tags)
+  `);
+    const selectEndpointId = db.prepare(`
+    SELECT id FROM endpoints WHERE path = @path AND method = @method
+  `);
+    const insertParameter = db.prepare(`
+    INSERT INTO parameters (endpoint_id, name, location, required, type, description)
+    VALUES (@endpoint_id, @name, @location, @required, @type, @description)
+  `);
+    const insertRequestBody = db.prepare(`
+    INSERT INTO request_bodies (endpoint_id, schema, example)
+    VALUES (@endpoint_id, @schema, @example)
+  `);
+    const insertResponseBody = db.prepare(`
+    INSERT INTO response_bodies (endpoint_id, status_code, description, schema, example)
+    VALUES (@endpoint_id, @status_code, @description, @schema, @example)
+  `);
+    // ---- Counters -----------------------------------------------------------
+    let totalEndpoints = 0;
+    let totalParameters = 0;
+    // ---- Bulk insert wrapped in a single transaction for speed --------------
+    const runImport = db.transaction(() => {
+        for (const [path, pathItem] of Object.entries(spec.paths)) {
+            for (const method of HTTP_METHODS) {
+                const operation = pathItem[method];
+                if (!operation)
+                    continue;
+                // -- Endpoint fields ------------------------------------------------
+                const category = operation.tags?.[0] ?? '';
+                const summary = operation.summary ?? '';
+                const tags = operation.tags ? operation.tags.join(',') : '';
+                // Use operationId or summary as a fallback when description is absent.
+                const description = operation.description?.trim() ||
+                    operation.operationId?.trim() ||
+                    summary;
+                insertEndpoint.run({
+                    path,
+                    method: method.toUpperCase(),
+                    description,
+                    category,
+                    summary,
+                    tags,
+                });
+                // Retrieve the auto-assigned id (INSERT OR IGNORE means a duplicate
+                // silently skips; the SELECT still returns the existing row's id).
+                const row = selectEndpointId.get({ path, method: method.toUpperCase() });
+                // Guard: row should always exist after the insert-or-ignore above.
+                if (!row)
+                    continue;
+                const endpointId = row.id;
+                totalEndpoints++;
+                // -- Parameters -----------------------------------------------------
+                if (Array.isArray(operation.parameters)) {
+                    for (const param of operation.parameters) {
+                        const paramType = param.schema?.type ?? '';
+                        insertParameter.run({
+                            endpoint_id: endpointId,
+                            name: param.name ?? '',
+                            location: param.in ?? '',
+                            required: param.required === true ? 1 : 0,
+                            type: paramType,
+                            description: param.description ?? '',
+                        });
+                        totalParameters++;
+                    }
+                }
+                // -- Request body ---------------------------------------------------
+                if (operation.requestBody) {
+                    const mediaType = pickMediaType(operation.requestBody.content);
+                    insertRequestBody.run({
+                        endpoint_id: endpointId,
+                        schema: safeStringify(mediaType?.schema),
+                        example: safeStringify(mediaType?.example),
+                    });
+                }
+                // -- Response bodies ------------------------------------------------
+                if (operation.responses) {
+                    for (const [statusCode, response] of Object.entries(operation.responses)) {
+                        const mediaType = pickMediaType(response.content);
+                        insertResponseBody.run({
+                            endpoint_id: endpointId,
+                            status_code: statusCode,
+                            description: response.description ?? '',
+                            schema: safeStringify(mediaType?.schema),
+                            example: safeStringify(mediaType?.example),
+                        });
+                    }
+                }
+            }
+        }
+    });
+    runImport();
+    // ---- Housekeeping -------------------------------------------------------
+    db.pragma('wal_checkpoint(TRUNCATE)');
+    db.close();
+    console.log(`Built database: ${totalEndpoints} endpoints, ${totalParameters} parameters`);
+    console.log(`Database written to: ${dbPath}`);
+}
+// ---------------------------------------------------------------------------
+// Entry point — always runs when invoked as a script
+// ---------------------------------------------------------------------------
+buildDatabase();
+//# sourceMappingURL=db-builder.js.map

package/dist/services/db-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-builder.js","sourceRoot":"","sources":["../../src/services/db-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAkGtC,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,MAAM,YAAY,GAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;AAE7E;;;GAGG;AACH,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IACrD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,aAAa,CACpB,OAAqD;IAErD,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAE/B,4CAA4C;IAC5C,MAAM,aAAa,GAAG;QACpB,kBAAkB;QAClB,iCAAiC;KAClC,CAAC;IAEF,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;QAChC,IAAI,OAAO,CAAC,GAAG,CAAC;YAAE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;IACxC,CAAC;IAED,2EAA2E;IAC3E,iEAAiE;IACjE,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC,OAAO,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAChE,CAAC;AAED,8EAA8E;AAC9E,yEAAyE;AACzE,sDAAsD;AACtD,8EAA8E;AAE9E,MAAM,cAAc,GAAsB;IACxC;;;;;;;;;IASE;IACF;;;;;;;;;IASE;IACF;;;;;;IAME;IACF;;;;;;;;IAQE;IACF,wDAAwD;IACxD,0DAA0D;IAC1D,wDAAwD;IACxD,4DAA4D;CAC7D,CAAC;AAEF,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E,MAAM,UAAU,aAAa;IAC3B,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,EAAE,wBAAwB,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,+BAA+B,CAAC,CAAC;IAEhE,4EAA4E;IAE5E,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,6BAA6B,cAAc,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,sBAAsB,cAAc,EAAE,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,YAAY,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAgB,CAAC;IAE5C,4EAA4E;IAE5E,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,uDAAuD,CAAC,CAAC;QACrE,UAAU,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;IAED,4EAA4E;IAE5E,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEhC,+DAA+D;IAC/D,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;IAElC,yEAAyE;IACzE,gDAAgD;IAChD,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;IACzB,CAAC;IAED,4EAA4E;IAE5E,MAAM,cAAc,GAAG,EAAE,CAAC,OAAO,CAAc;;;GAG9C,CAAC,CAAC;IAEH,MAAM,gBAAgB,GAAG,EAAE,CAAC,OAAO,CAAmD;;GAErF,CAAC,CAAC;IAEH,MAAM,eAAe,GAAG,EAAE,CAAC,OAAO,CAAe;;;GAGhD,CAAC,CAAC;IAEH,MAAM,iBAAiB,GAAG,EAAE,CAAC,OAAO,CAAiB;;;GAGpD,CAAC,CAAC;IAEH,MAAM,kBAAkB,GAAG,EAAE,CAAC,OAAO,CAAkB;;;GAGtD,CAAC,CAAC;IAEH,4EAA4E;IAE5E,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,IAAI,eAAe,GAAG,CAAC,CAAC;IAExB,4EAA4E;IAE5E,MAAM,SAAS,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;QACpC,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1D,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;gBAClC,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACnC,IAAI,CAAC,SAAS;oBAAE,SAAS;gBAEzB,sEAAsE;gBAEtE,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC3C,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,IAAI,EAAE,CAAC;gBACxC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAE5D,uEAAuE;gBACvE,MAAM,WAAW,GACf,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE;oBAC7B,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE;oBAC7B,OAAO,CAAC;gBAEV,cAAc,CAAC,GAAG,CAAC;oBACjB,IAAI;oBACJ,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE;oBAC5B,WAAW;oBACX,QAAQ;oBACR,OAAO;oBACP,IAAI;iBACL,CAAC,CAAC;gBAEH,oEAAoE;gBACpE,mEAAmE;gBACnE,MAAM,GAAG,GAAG,gBAAgB,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;gBAEzE,mEAAmE;gBACnE,IAAI,CAAC,GAAG;oBAAE,SAAS;gBAEnB,MAAM,UAAU,GAAG,GAAG,CAAC,EAAE,CAAC;gBAC1B,cAAc,EAAE,CAAC;gBAEjB,sEAAsE;gBAEtE,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;oBACxC,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,UAAU,EAAE,CAAC;wBACzC,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC;wBAC3C,eAAe,CAAC,GAAG,CAAC;4BAClB,WAAW,EAAE,UAAU;4BACvB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE;4BACtB,QAAQ,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE;4BACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;4BACzC,IAAI,EAAE,SAAS;4BACf,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,EAAE;yBACrC,CAAC,CAAC;wBACH,eAAe,EAAE,CAAC;oBACpB,CAAC;gBACH,CAAC;gBAED,sEAAsE;gBAEtE,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;oBAC1B,MAAM,SAAS,GAAG,aAAa,CAAC,SAAS,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;oBAC/D,iBAAiB,CAAC,GAAG,CAAC;wBACpB,WAAW,EAAE,UAAU;wBACvB,MAAM,EAAE,aAAa,CAAC,SAAS,EAAE,MAAM,CAAC;wBACxC,OAAO,EAAE,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC;qBAC3C,CAAC,CAAC;gBACL,CAAC;gBAED,sEAAsE;gBAEtE,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;oBACxB,KAAK,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CACjD,SAAS,CAAC,SAAS,CACpB,EAAE,CAAC;wBACF,MAAM,SAAS,GAAG,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;wBAClD,kBAAkB,CAAC,GAAG,CAAC;4BACrB,WAAW,EAAE,UAAU;4BACvB,WAAW,EAAE,UAAU;4BACvB,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,EAAE;4BACvC,MAAM,EAAE,aAAa,CAAC,SAAS,EAAE,MAAM,CAAC;4BACxC,OAAO,EAAE,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC;yBAC3C,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,SAAS,EAAE,CAAC;IAEZ,4EAA4E;IAE5E,EAAE,CAAC,MAAM,CAAC,0BAA0B,CAAC,CAAC;IACtC,EAAE,CAAC,KAAK,EAAE,CAAC;IAEX,OAAO,CAAC,GAAG,CACT,mBAAmB,cAAc,eAAe,eAAe,aAAa,CAC7E,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,wBAAwB,MAAM,EAAE,CAAC,CAAC;AAChD,CAAC;AAED,8EAA8E;AAC9E,qDAAqD;AACrD,8EAA8E;AAE9E,aAAa,EAAE,CAAC"}

package/dist/services/fast-memory.d.ts

@@ -0,0 +1,39 @@
+import { SavedQuery } from '../types/index.js';
+export declare class FastMemory {
+    private db;
+    constructor(dbPath: string);
+    /**
+     * Ensure the saved_queries table exists. Safe to call multiple times.
+     */
+    private initialize;
+    /**
+     * Persist a query. Uses INSERT OR REPLACE (upsert) keyed on the
+     * UNIQUE constraint (path, method). Sets timestamp to Date.now().
+     *
+     * Returns the row id of the inserted or replaced record.
+     */
+    saveQuery(description: string, path: string, method: string, params?: string, data?: string): number;
+    /**
+     * Find a saved query by exact path and method match. If found, increments
+     * usage_count and updates timestamp to Date.now(), then returns the
+     * updated record. Returns null when no match exists.
+     */
+    findQuery(path: string, method: string): SavedQuery | null;
+    /**
+     * Search saved queries by keyword. When searchTerm is provided, performs a
+     * LIKE search on both description and path. Returns all records when
+     * searchTerm is absent or empty. Results are ordered by usage_count DESC.
+     */
+    searchQueries(searchTerm?: string): SavedQuery[];
+    /**
+     * Delete a saved query by its integer id.
+     * Returns true when a row was deleted, false when no row matched.
+     */
+    deleteQuery(id: number): boolean;
+    /**
+     * Delete all saved queries. Returns the number of rows removed.
+     */
+    clearAll(): number;
+    close(): void;
+}
+//# sourceMappingURL=fast-memory.d.ts.map

package/dist/services/fast-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fast-memory.d.ts","sourceRoot":"","sources":["../../src/services/fast-memory.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AA+C/C,qBAAa,UAAU;IACrB,OAAO,CAAC,EAAE,CAAoB;gBAElB,MAAM,EAAE,MAAM;IAO1B;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;;;;OAKG;IACH,SAAS,CACP,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,GACZ,MAAM;IAuBT;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IA8B1D;;;;OAIG;IACH,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE;IAmChD;;;OAGG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAOhC;;OAEG;IACH,QAAQ,IAAI,MAAM;IAKlB,KAAK,IAAI,IAAI;CAGd"}

package/dist/services/fast-memory.js

@@ -0,0 +1,147 @@
+// ConnectWise PSA MCP Server — SQLite Saved Query System
+import { fileURLToPath } from 'url';
+import { join, dirname } from 'path';
+import Database from 'better-sqlite3';
+// ---------------------------------------------------------------------------
+// Helper — resolve DB path relative to this compiled module
+// ---------------------------------------------------------------------------
+function resolveDbPath(dbPath) {
+    if (dbPath)
+        return dbPath;
+    // Default: same data directory used by APIDatabase
+    const scriptDir = dirname(fileURLToPath(import.meta.url));
+    return join(scriptDir, '..', '..', 'data', 'fast-memory.db');
+}
+// ---------------------------------------------------------------------------
+// DDL — schema guaranteed by initialize()
+// ---------------------------------------------------------------------------
+const CREATE_TABLE_SQL = `
+  CREATE TABLE IF NOT EXISTS saved_queries (
+    id          INTEGER PRIMARY KEY AUTOINCREMENT,
+    description TEXT    NOT NULL,
+    path        TEXT    NOT NULL,
+    method      TEXT    NOT NULL,
+    params      TEXT,
+    data        TEXT,
+    timestamp   INTEGER NOT NULL,
+    usage_count INTEGER NOT NULL DEFAULT 0,
+    UNIQUE (path, method)
+  )
+`;
+// ---------------------------------------------------------------------------
+// FastMemory
+// ---------------------------------------------------------------------------
+export class FastMemory {
+    db;
+    constructor(dbPath) {
+        const resolved = resolveDbPath(dbPath);
+        // Opened read-write so we can create the table and mutate rows
+        this.db = new Database(resolved);
+        this.initialize();
+    }
+    /**
+     * Ensure the saved_queries table exists. Safe to call multiple times.
+     */
+    initialize() {
+        this.db.prepare(CREATE_TABLE_SQL).run();
+    }
+    /**
+     * Persist a query. Uses INSERT OR REPLACE (upsert) keyed on the
+     * UNIQUE constraint (path, method). Sets timestamp to Date.now().
+     *
+     * Returns the row id of the inserted or replaced record.
+     */
+    saveQuery(description, path, method, params, data) {
+        const stmt = this.db.prepare(`
+      INSERT OR REPLACE INTO saved_queries (description, path, method, params, data, timestamp, usage_count)
+      VALUES (?, ?, ?, ?, ?, ?, COALESCE(
+        (SELECT usage_count FROM saved_queries WHERE path = ? AND method = ?), 0
+      ))
+    `);
+        const now = Date.now();
+        const result = stmt.run(description, path, method.toUpperCase(), params ?? null, data ?? null, now, path, method.toUpperCase());
+        return result.lastInsertRowid;
+    }
+    /**
+     * Find a saved query by exact path and method match. If found, increments
+     * usage_count and updates timestamp to Date.now(), then returns the
+     * updated record. Returns null when no match exists.
+     */
+    findQuery(path, method) {
+        const normalMethod = method.toUpperCase();
+        const row = this.db
+            .prepare('SELECT id, description, path, method, params, data, timestamp, usage_count FROM saved_queries WHERE path = ? AND method = ?')
+            .get(path, normalMethod);
+        if (!row)
+            return null;
+        const now = Date.now();
+        this.db
+            .prepare('UPDATE saved_queries SET usage_count = usage_count + 1, timestamp = ? WHERE id = ?')
+            .run(now, row.id);
+        return {
+            id: row.id,
+            description: row.description,
+            path: row.path,
+            method: row.method,
+            params: row.params,
+            data: row.data,
+            timestamp: now,
+            usage_count: row.usage_count + 1,
+        };
+    }
+    /**
+     * Search saved queries by keyword. When searchTerm is provided, performs a
+     * LIKE search on both description and path. Returns all records when
+     * searchTerm is absent or empty. Results are ordered by usage_count DESC.
+     */
+    searchQueries(searchTerm) {
+        let rows;
+        if (searchTerm && searchTerm.trim().length > 0) {
+            const pattern = `%${searchTerm.trim()}%`;
+            rows = this.db
+                .prepare(`SELECT id, description, path, method, params, data, timestamp, usage_count
+           FROM saved_queries
+           WHERE description LIKE ? OR path LIKE ?
+           ORDER BY usage_count DESC`)
+                .all(pattern, pattern);
+        }
+        else {
+            rows = this.db
+                .prepare(`SELECT id, description, path, method, params, data, timestamp, usage_count
+           FROM saved_queries
+           ORDER BY usage_count DESC`)
+                .all();
+        }
+        return rows.map((row) => ({
+            id: row.id,
+            description: row.description,
+            path: row.path,
+            method: row.method,
+            params: row.params,
+            data: row.data,
+            timestamp: row.timestamp,
+            usage_count: row.usage_count,
+        }));
+    }
+    /**
+     * Delete a saved query by its integer id.
+     * Returns true when a row was deleted, false when no row matched.
+     */
+    deleteQuery(id) {
+        const result = this.db
+            .prepare('DELETE FROM saved_queries WHERE id = ?')
+            .run(id);
+        return result.changes > 0;
+    }
+    /**
+     * Delete all saved queries. Returns the number of rows removed.
+     */
+    clearAll() {
+        const result = this.db.prepare('DELETE FROM saved_queries').run();
+        return result.changes;
+    }
+    close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=fast-memory.js.map