@botozap/mcp 0.1.0 → 0.2.0

package/dist/resources/events.js

@@ -0,0 +1,192 @@
+import { ErrorCode, McpError, SubscribeRequestSchema, UnsubscribeRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { ResourceTemplate, } from "@modelcontextprotocol/sdk/server/mcp.js";
+export const EVENTS_URI_TEMPLATE = "botozap://events{?after,limit}";
+const DEFAULT_LIMIT = 100;
+/**
+ * Tail de baixa latência ativo somente enquanto o cliente stdio mantém uma
+ * assinatura. A notification é apenas um sinal; o payload continua vindo do
+ * resource, que relê o stream durável da API pelo cursor informado na URI.
+ */
+class EventSubscriptions {
+    server;
+    client;
+    pollIntervalMs;
+    maxSubscriptions;
+    subscriptions = new Map();
+    pollAbortController;
+    timer;
+    polling = false;
+    signalPending = false;
+    closed = false;
+    unsubscribeEventSignal;
+    constructor(server, client, pollIntervalMs, maxSubscriptions, eventSignal) {
+        this.server = server;
+        this.client = client;
+        this.pollIntervalMs = pollIntervalMs;
+        this.maxSubscriptions = maxSubscriptions;
+        this.unsubscribeEventSignal = eventSignal?.subscribe(() => {
+            this.signalPending = true;
+            this.schedule(0);
+        });
+    }
+    subscribe(uri) {
+        const { after } = parseEventsUri(uri);
+        if (!this.subscriptions.has(uri)) {
+            if (this.subscriptions.size >= this.maxSubscriptions) {
+                throw new McpError(ErrorCode.InvalidRequest, `Limite de assinaturas de Eventos atingido (${this.maxSubscriptions}).`);
+            }
+            this.subscriptions.set(uri, { cursor: after });
+        }
+        this.schedule(0);
+    }
+    unsubscribe(uri) {
+        parseEventsUri(uri);
+        if (this.subscriptions.delete(uri) && this.polling) {
+            this.pollAbortController?.abort();
+            if (this.subscriptions.size > 0)
+                this.signalPending = true;
+        }
+        if (this.subscriptions.size === 0 && this.timer) {
+            clearTimeout(this.timer);
+            this.timer = undefined;
+            this.signalPending = false;
+        }
+    }
+    close() {
+        this.closed = true;
+        this.subscriptions.clear();
+        this.unsubscribeEventSignal?.();
+        this.pollAbortController?.abort();
+        if (this.timer)
+            clearTimeout(this.timer);
+        this.timer = undefined;
+    }
+    schedule(delayMs) {
+        if (this.closed || this.subscriptions.size === 0) {
+            return;
+        }
+        if (this.polling)
+            return;
+        if (this.timer) {
+            if (delayMs > 0)
+                return;
+            clearTimeout(this.timer);
+            this.timer = undefined;
+        }
+        this.timer = setTimeout(() => {
+            this.timer = undefined;
+            void this.poll();
+        }, delayMs);
+        this.timer.unref?.();
+    }
+    async poll() {
+        if (this.closed || this.polling || this.subscriptions.size === 0)
+            return;
+        this.polling = true;
+        this.signalPending = false;
+        const abortController = new AbortController();
+        this.pollAbortController = abortController;
+        try {
+            for (const [uri, subscription] of [...this.subscriptions]) {
+                try {
+                    const page = await this.client.events.list({
+                        after: subscription.cursor,
+                        limit: DEFAULT_LIMIT,
+                        signal: abortController.signal,
+                    });
+                    // A assinatura pode ter sido cancelada enquanto o fetch estava no ar.
+                    if (this.closed || this.subscriptions.get(uri) !== subscription)
+                        continue;
+                    if (page.data.length === 0)
+                        continue;
+                    await this.server.server.sendResourceUpdated({ uri });
+                    subscription.cursor = page.paging.cursor;
+                    if (page.paging.has_more)
+                        this.signalPending = true;
+                }
+                catch {
+                    // Falhas transitórias não encerram a sessão MCP. A leitura explícita
+                    // continua expondo o erro estruturado do SDK ao cliente.
+                }
+            }
+        }
+        finally {
+            if (this.pollAbortController === abortController) {
+                this.pollAbortController = undefined;
+            }
+            this.polling = false;
+            this.schedule(this.signalPending ? 0 : this.pollIntervalMs);
+        }
+    }
+}
+export function registerEventResources(server, client, options) {
+    const subscriptions = new EventSubscriptions(server, client, Math.max(1, options.pollIntervalMs), Math.max(1, options.maxSubscriptions ?? 8), options.eventSignal);
+    server.registerResource("events", new ResourceTemplate(EVENTS_URI_TEMPLATE, { list: undefined }), {
+        title: "Eventos do WhatsApp",
+        description: "Stream durável de Eventos da Conta e ambiente autenticados, lido em ordem crescente pelo cursor `after`.",
+        mimeType: "application/json",
+    }, async (uri) => {
+        const params = parseEventsUri(uri.href);
+        const page = await client.events.list(params);
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: "application/json",
+                    text: JSON.stringify(page),
+                },
+            ],
+        };
+    });
+    server.server.setRequestHandler(SubscribeRequestSchema, (request) => {
+        subscriptions.subscribe(request.params.uri);
+        return {};
+    });
+    server.server.setRequestHandler(UnsubscribeRequestSchema, (request) => {
+        subscriptions.unsubscribe(request.params.uri);
+        return {};
+    });
+    return () => subscriptions.close();
+}
+function parseEventsUri(uri) {
+    let parsed;
+    try {
+        parsed = new URL(uri);
+    }
+    catch {
+        throw invalidUri();
+    }
+    const keys = [...parsed.searchParams.keys()];
+    const hasUnknownParam = keys.some((key) => key !== "after" && key !== "limit");
+    const hasDuplicateParam = parsed.searchParams.getAll("after").length > 1 ||
+        parsed.searchParams.getAll("limit").length > 1;
+    if (parsed.protocol !== "botozap:" ||
+        parsed.hostname !== "events" ||
+        parsed.port !== "" ||
+        parsed.pathname !== "" ||
+        parsed.username !== "" ||
+        parsed.password !== "" ||
+        parsed.hash !== "" ||
+        hasUnknownParam ||
+        hasDuplicateParam) {
+        throw invalidUri();
+    }
+    const after = parsed.searchParams.get("after") ?? "0";
+    const afterNumber = Number(after);
+    if (!/^\d+$/.test(after) || !Number.isSafeInteger(afterNumber) || afterNumber < 0) {
+        throw invalidUri();
+    }
+    const rawLimit = parsed.searchParams.get("limit");
+    const limit = rawLimit === null ? DEFAULT_LIMIT : Number(rawLimit);
+    if ((rawLimit !== null && !/^\d+$/.test(rawLimit)) ||
+        !Number.isSafeInteger(limit) ||
+        limit < 1 ||
+        limit > 100) {
+        throw invalidUri();
+    }
+    return { after, limit };
+}
+function invalidUri() {
+    return new McpError(ErrorCode.InvalidParams, "URI de Eventos inválida. Use botozap://events?after=<cursor>&limit=<1..100>.");
+}
+//# sourceMappingURL=events.js.map

package/dist/resources/events.js.map

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