@wootsup/mcp 0.1.0-rc.1

package/dist/modules/apimapper/cache.js

@@ -0,0 +1,71 @@
+import { z } from "zod";
+import { formatResult, readOnly, mutating } from "@getimo/mcp-toolkit";
+import { request, hintFor } from "./client.js";
+export function registerCacheTools(server) {
+    // ── apimapper_cache_invalidate ─────────────────────────────────────
+    server.registerTool("apimapper_cache_invalidate", {
+        title: "Invalidate Admin Cache",
+        description: "Trigger admin-cache invalidation via the event bus. Pushes events to all subscribers " +
+            "(Admin-UI BroadcastChannel + render cache). " +
+            'scope="all" clears everything; scope="connection"|"flow"|"library"|"credential" need id.' +
+            "\n\nExample:\n  apimapper_cache_invalidate({ scope: 'connection', id: 'con_abc123' })",
+        inputSchema: {
+            scope: z
+                .enum(["all", "connection", "flow", "library", "credential"])
+                .describe("Invalidation scope"),
+            id: z.string().optional().describe('Resource ID — required for non-"all" scopes'),
+        },
+        annotations: mutating(),
+    }, async ({ scope, id }) => {
+        if (scope !== "all" && !id) {
+            return formatResult({
+                error: `scope="${scope}" requires id`,
+                context: { scope },
+                hint: 'Pass id when scope is not "all", or use scope="all" to clear everything.',
+            }, true);
+        }
+        const r = await request("/cache/admin/invalidate", {
+            method: "POST",
+            body: JSON.stringify({ scope, id }),
+        });
+        if (!r.success) {
+            return formatResult({
+                error: r.error,
+                status: r.status,
+                errorCode: r.errorCode,
+                context: { scope, id },
+                hint: hintFor(r.errorCode),
+            }, true);
+        }
+        return formatResult({
+            invalidated: true,
+            scope,
+            id,
+            events_fired: r.data?.events?.length ?? 0,
+        }, false, { maxChars: 1500 });
+    });
+    // ── apimapper_cache_stats ──────────────────────────────────────────
+    server.registerTool("apimapper_cache_stats", {
+        title: "Get Cache Stats",
+        description: "Fetch cache observability stats (hits, misses, ttl distribution, sizes)." +
+            "\n\nExample:\n  apimapper_cache_stats({})",
+        inputSchema: {},
+        annotations: readOnly(),
+    }, async () => {
+        const r = await request("/cache-stats");
+        if (!r.success) {
+            return formatResult({ error: r.error, status: r.status, errorCode: r.errorCode, context: {}, hint: hintFor(r.errorCode) }, true);
+        }
+        const dataObj = (r.data && typeof r.data === "object") ? r.data : {};
+        return formatResult({
+            hits: dataObj.hits ?? 0,
+            misses: dataObj.misses ?? 0,
+            hit_rate: typeof dataObj.hits === "number" && typeof dataObj.misses === "number" && dataObj.hits + dataObj.misses > 0
+                ? `${((dataObj.hits / (dataObj.hits + dataObj.misses)) * 100).toFixed(1)}%`
+                : "n/a",
+            sizes: dataObj.sizes,
+            ttl: dataObj.ttl,
+        }, false, { maxChars: 3000 });
+    });
+}
+//# sourceMappingURL=cache.js.map

package/dist/modules/apimapper/cache.js.map

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

package/dist/modules/apimapper/client.d.ts

@@ -0,0 +1,85 @@
+import { type ApiResponse } from "@getimo/mcp-toolkit";
+import { type Platform } from "../../platform/index.js";
+export declare const WP_BASE: string;
+export declare const WP_USER: string;
+export declare const WP_APP_PASS: string;
+/**
+ * Sanitise an error string so it cannot leak the Basic-auth token, base64
+ * sequences, or upstream Authorization headers into MCP responses.
+ */
+export declare function sanitizeErrorString(s: string): string;
+/**
+ * Extended response with HTTP status (and a coarse error classification) so
+ * tools can branch on auth-vs-not-found-vs-server without re-parsing strings.
+ *
+ * The underlying toolkit `ApiResponse` only carries `{success, data?, error?}`.
+ * We wrap each call so we capture the HTTP code via `fetch` and merge.
+ */
+export type ApiErrorCode = "auth" | "not_found" | "rate_limit" | "server" | "network" | "unknown";
+export interface ExtApiResponse<T = unknown> extends ApiResponse<T> {
+    status?: number;
+    errorCode?: ApiErrorCode;
+    /** When true, response was 2xx but payload had `success: false` — semantically failed. */
+    payloadFailed?: boolean;
+}
+interface RequestOpts {
+    /**
+     * When true, response is sanitised through `sanitizeSecrets()` before being
+     * returned. Apply to ALL credential endpoints + any endpoint that may
+     * surface auth_data.
+     */
+    sanitize?: boolean;
+    /**
+     * When true and the response is `{success:true, data:{success:false,...}}`,
+     * convert to a structured error (status `200 semantic-fail`). Apply to
+     * endpoints that return business-level success/failure inside a 200 envelope:
+     * connection_test, license_activate, feedback_submit, etc.
+     */
+    unwrapInnerSuccess?: boolean;
+    /**
+     * Per-call timeout override in milliseconds. Default is 45_000.
+     * Use longer values for endpoints known to be slow (large-flow compile,
+     * detect-schema across many endpoints, library catalog sync).
+     * Clamped to [1_000, 300_000] (1s..5min).
+     */
+    timeoutMs?: number;
+}
+export interface PlatformClient {
+    readonly platform: Platform;
+    request<T = unknown>(action: string, init?: RequestInit, opts?: RequestOpts): Promise<ExtApiResponse<T>>;
+}
+/**
+ * Create a Platform-aware HTTP client. The Platform handles URL construction,
+ * auth header injection, and response envelope unwrap (e.g. Joomla's
+ * `{success, data, error}` shape).
+ *
+ * All errors are sanitised via `sanitizeErrorString()` before being returned.
+ */
+export declare function createPlatformClient(platform: Platform): PlatformClient;
+/**
+ * Issue a request through the toolkit HTTP client + capture HTTP status.
+ *
+ * Legacy signature: callers pass a path starting with "/" (e.g. "/connections")
+ * — we strip the leading slash and route through the Platform layer.
+ *
+ * Joomla routing: when APIMAPPER_PLATFORM=joomla, the WP-shape REST path is
+ * pre-translated to `{ action, params }` via JoomlaPlatform.translateRestPath
+ * BEFORE buildUrl runs. The translation table is pinned against the
+ * AjaxDispatcher match-arms.
+ *
+ * For new code, prefer `createPlatformClient(platform).request(action)`.
+ */
+export declare function request<T = unknown>(path: string, init?: RequestInit, opts?: RequestOpts): Promise<ExtApiResponse<T>>;
+/**
+ * Map an `errorCode` to a focused hint string for the caller.
+ * Falls back to the generic health-tool hint.
+ */
+export declare function hintFor(code?: ApiErrorCode): string;
+export declare const HEALTH_HINT = "Use apimapper_health to check connectivity and auth.";
+export declare function authConfigured(): boolean;
+export declare const api: {
+    request: <T>(path: string, init?: RequestInit, _retryCount?: number) => Promise<ApiResponse<T>>;
+    requestAll: <T>(path: string, params?: Record<string, string>) => Promise<ApiResponse<T[]>>;
+    acquireRateLimit: () => Promise<void>;
+};
+export {};