@exileum/meta-mcp 6.0.0 → 8.0.0

package/dist/utils/logger.d.ts

@@ -0,0 +1,28 @@
+export type LogLevel = "debug" | "info" | "warning" | "error";
+export interface Logger {
+    debug(data: unknown): void;
+    info(data: unknown): void;
+    warning(data: unknown): void;
+    error(data: unknown): void;
+}
+export interface LoggingServer {
+    sendLoggingMessage(params: {
+        level: LogLevel;
+        logger?: string;
+        data: unknown;
+    }): Promise<void>;
+}
+export declare const NOOP_LOGGER: Logger;
+/**
+ * Build a {@link Logger} that forwards each call to the MCP structured-logging
+ * channel via `server.sendLoggingMessage()` (emitted as a `notifications/message`
+ * event). Requires the server to have declared `capabilities: { logging: {} }`;
+ * without it the SDK drops the message silently. The SDK also filters out levels
+ * below any client-set `logging/setLevel`, so callers don't gate by level here.
+ *
+ * Emission is fire-and-forget with a swallowed rejection: a closed transport
+ * (client disconnect, cancelled request) must never turn a successful API
+ * operation into a failure — same contract as `makeProgressNotifier`.
+ */
+export declare function createMcpLogger(server: LoggingServer, name?: string): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAE9D,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7B,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;CAC5B;AAID,MAAM,WAAW,aAAa;IAC5B,kBAAkB,CAAC,MAAM,EAAE;QACzB,KAAK,EAAE,QAAQ,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,OAAO,CAAC;KACf,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnB;AAGD,eAAO,MAAM,WAAW,EAAE,MAKzB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,SAAa,GAAG,MAAM,CAYhF"}

package/dist/utils/logger.js

@@ -0,0 +1,32 @@
+// Default when no server-backed logger is injected (tests, sandbox); lets call sites skip null-checks.
+export const NOOP_LOGGER = {
+    debug() { },
+    info() { },
+    warning() { },
+    error() { },
+};
+/**
+ * Build a {@link Logger} that forwards each call to the MCP structured-logging
+ * channel via `server.sendLoggingMessage()` (emitted as a `notifications/message`
+ * event). Requires the server to have declared `capabilities: { logging: {} }`;
+ * without it the SDK drops the message silently. The SDK also filters out levels
+ * below any client-set `logging/setLevel`, so callers don't gate by level here.
+ *
+ * Emission is fire-and-forget with a swallowed rejection: a closed transport
+ * (client disconnect, cancelled request) must never turn a successful API
+ * operation into a failure — same contract as `makeProgressNotifier`.
+ */
+export function createMcpLogger(server, name = "meta-mcp") {
+    const emit = (level) => (data) => {
+        void server
+            .sendLoggingMessage({ level, logger: name, data })
+            .catch(() => { });
+    };
+    return {
+        debug: emit("debug"),
+        info: emit("info"),
+        warning: emit("warning"),
+        error: emit("error"),
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAoBA,uGAAuG;AACvG,MAAM,CAAC,MAAM,WAAW,GAAW;IACjC,KAAK,KAAI,CAAC;IACV,IAAI,KAAI,CAAC;IACT,OAAO,KAAI,CAAC;IACZ,KAAK,KAAI,CAAC;CACX,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,MAAqB,EAAE,IAAI,GAAG,UAAU;IACtE,MAAM,IAAI,GAAG,CAAC,KAAe,EAAE,EAAE,CAAC,CAAC,IAAa,EAAQ,EAAE;QACxD,KAAK,MAAM;aACR,kBAAkB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;aACjD,KAAK,CAAC,GAAG,EAAE,GAAiB,CAAC,CAAC,CAAC;IACpC,CAAC,CAAC;IACF,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC;QACpB,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;QAClB,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC;QACxB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC;KACrB,CAAC;AACJ,CAAC"}

package/dist/utils/params.d.ts

@@ -0,0 +1,3 @@
+import type { FormParamValue, FormParams } from "../services/meta-client.js";
+export declare function buildParams(required: FormParams, optional: Record<string, FormParamValue | undefined>): FormParams;
+//# sourceMappingURL=params.d.ts.map

package/dist/utils/params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../../src/utils/params.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAM7E,wBAAgB,WAAW,CACzB,QAAQ,EAAE,UAAU,EACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,CAAC,GACnD,UAAU,CAQZ"}

package/dist/utils/params.js

@@ -0,0 +1,14 @@
+// Skips only `undefined`, not the rest of the falsy set — `if (x)` checks
+// silently dropped `0` (#32 thumb_offset bug), `false`, and `""`. Note that
+// `null` and `""` survive here but are still dropped by `appendFormParams`
+// at the wire layer; use `undefined` as the canonical "omit this key" signal.
+export function buildParams(required, optional) {
+    const params = { ...required };
+    for (const [key, value] of Object.entries(optional)) {
+        if (value !== undefined) {
+            params[key] = value;
+        }
+    }
+    return params;
+}
+//# sourceMappingURL=params.js.map

package/dist/utils/params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.js","sourceRoot":"","sources":["../../src/utils/params.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,4EAA4E;AAC5E,2EAA2E;AAC3E,8EAA8E;AAC9E,MAAM,UAAU,WAAW,CACzB,QAAoB,EACpB,QAAoD;IAEpD,MAAM,MAAM,GAAe,EAAE,GAAG,QAAQ,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/utils/progress.d.ts

@@ -0,0 +1,42 @@
+import type { ContainerProgressCallback } from "./container.js";
+export interface ProgressExtra {
+    _meta?: {
+        progressToken?: string | number;
+    };
+    sendNotification: (notification: {
+        method: "notifications/progress";
+        params: {
+            progressToken: string | number;
+            progress: number;
+            total?: number;
+            message?: string;
+        };
+    }) => Promise<void>;
+}
+/**
+ * `ContainerProgressCallback` with an attached `.stop()` for lifecycle control.
+ * Calling `.stop()` makes subsequent invocations no-ops — required for the
+ * `Promise.all`-parallel carousel case, where a rejected child can leave its
+ * sibling polls running and emitting `notifications/progress` after the tool
+ * call has already returned (MCP forbids progress after request completion).
+ */
+export type ProgressNotifier = ContainerProgressCallback & {
+    stop: () => void;
+};
+/**
+ * Build a `ProgressNotifier` that forwards each poll-loop emission as an MCP
+ * `notifications/progress` event, or `undefined` when no progressToken was
+ * attached (lets callers pass the result straight to `{ onProgress }` without
+ * null-checking).
+ *
+ * `mode: "shared"` replaces the caller-supplied `progress`/`total` with an
+ * internal monotonically-increasing counter (and omits `total`) — required
+ * when multiple `pollContainerStatus` calls run in parallel via `Promise.all`,
+ * since MCP requires strictly increasing values per progressToken.
+ *
+ * Callers should invoke `.stop()` in a `finally` block once the tool call has
+ * completed (success or failure). For sequential single-poll tools this is a
+ * defensive no-op; for parallel carousel flows it prevents leaked emissions.
+ */
+export declare function makeProgressNotifier(extra: ProgressExtra | undefined, mode?: "single" | "shared"): ProgressNotifier | undefined;
+//# sourceMappingURL=progress.d.ts.map

package/dist/utils/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/utils/progress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAIhE,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE;QACN,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;KACjC,CAAC;IACF,gBAAgB,EAAE,CAAC,YAAY,EAAE;QAC/B,MAAM,EAAE,wBAAwB,CAAC;QACjC,MAAM,EAAE;YACN,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC;YAC/B,QAAQ,EAAE,MAAM,CAAC;YACjB,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,OAAO,CAAC,EAAE,MAAM,CAAC;SAClB,CAAC;KACH,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG,yBAAyB,GAAG;IAAE,IAAI,EAAE,MAAM,IAAI,CAAA;CAAE,CAAC;AAEhF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,GAAG,SAAS,EAChC,IAAI,GAAE,QAAQ,GAAG,QAAmB,GACnC,gBAAgB,GAAG,SAAS,CAiB9B"}

package/dist/utils/progress.js

@@ -0,0 +1,35 @@
+/**
+ * Build a `ProgressNotifier` that forwards each poll-loop emission as an MCP
+ * `notifications/progress` event, or `undefined` when no progressToken was
+ * attached (lets callers pass the result straight to `{ onProgress }` without
+ * null-checking).
+ *
+ * `mode: "shared"` replaces the caller-supplied `progress`/`total` with an
+ * internal monotonically-increasing counter (and omits `total`) — required
+ * when multiple `pollContainerStatus` calls run in parallel via `Promise.all`,
+ * since MCP requires strictly increasing values per progressToken.
+ *
+ * Callers should invoke `.stop()` in a `finally` block once the tool call has
+ * completed (success or failure). For sequential single-poll tools this is a
+ * defensive no-op; for parallel carousel flows it prevents leaked emissions.
+ */
+export function makeProgressNotifier(extra, mode = "single") {
+    const token = extra?._meta?.progressToken;
+    if (extra === undefined || token === undefined)
+        return undefined;
+    let counter = 0;
+    let alive = true;
+    const emit = (progress, total, message) => {
+        if (!alive)
+            return;
+        const params = mode === "shared"
+            ? { progressToken: token, progress: ++counter, message }
+            : { progressToken: token, progress, total, message };
+        // Transport may have closed (client disconnect, request cancelled) —
+        // a rejection must not propagate or it would fail a successful upload.
+        void extra.sendNotification({ method: "notifications/progress", params })
+            .catch(() => { });
+    };
+    return Object.assign(emit, { stop: () => { alive = false; } });
+}
+//# sourceMappingURL=progress.js.map

package/dist/utils/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../../src/utils/progress.ts"],"names":[],"mappings":"AA4BA;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAgC,EAChC,OAA4B,QAAQ;IAEpC,MAAM,KAAK,GAAG,KAAK,EAAE,KAAK,EAAE,aAAa,CAAC;IAC1C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAEjE,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,KAAK,GAAG,IAAI,CAAC;IACjB,MAAM,IAAI,GAA8B,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QACnE,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,MAAM,MAAM,GAAG,IAAI,KAAK,QAAQ;YAC9B,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE;YACxD,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QACvD,qEAAqE;QACrE,uEAAuE;QACvE,KAAK,KAAK,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,wBAAwB,EAAE,MAAM,EAAE,CAAC;aACtE,KAAK,CAAC,GAAG,EAAE,GAAiB,CAAC,CAAC,CAAC;IACpC,CAAC,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACjE,CAAC"}

package/dist/utils/response.d.ts

@@ -0,0 +1,11 @@
+import type { RateLimit } from "../services/meta-client.js";
+export interface McpToolResult {
+    [key: string]: unknown;
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: boolean;
+}
+export declare function formatResponse(data: Record<string, unknown>, rateLimit?: RateLimit): McpToolResult;
+//# sourceMappingURL=response.d.ts.map

package/dist/utils/response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../src/utils/response.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAE5D,MAAM,WAAW,aAAa;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,SAAS,CAAC,EAAE,SAAS,GACpB,aAAa,CAIf"}

package/dist/utils/response.js

@@ -0,0 +1,6 @@
+export function formatResponse(data, rateLimit) {
+    return {
+        content: [{ type: "text", text: JSON.stringify({ ...data, _rateLimit: rateLimit }, null, 2) }],
+    };
+}
+//# sourceMappingURL=response.js.map

package/dist/utils/response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../../src/utils/response.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,cAAc,CAC5B,IAA6B,EAC7B,SAAqB;IAErB,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KAC/F,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exileum/meta-mcp",
-  "version": "6.0.0",
+  "version": "8.0.0",
   "mcpName": "io.github.exileum/meta",
   "description": "Enables AI assistants to manage Instagram and Threads accounts — publish content, handle comments, view insights, search hashtags, and manage DMs through the Meta Graph API",
   "type": "module",
@@ -30,7 +30,8 @@
     "lint": "eslint . --max-warnings 0",
     "lint:fix": "eslint . --fix",
     "test": "vitest run",
-    "test:watch": "vitest"
+    "test:watch": "vitest",
+    "prepublishOnly": "node scripts/check-versions.mjs && npm run build"
   },
   "keywords": [
     "mcp",
@@ -64,9 +65,9 @@
     "ip-address": "^10.1.1"
   },
   "devDependencies": {
-    "@eslint/js": "^9.39.4",
+    "@eslint/js": "^10.0.1",
     "@types/node": "^25.6.0",
-    "eslint": "^9.39.4",
+    "eslint": "^10.4.0",
     "globals": "^17.6.0",
     "tsx": "^4.21.0",
     "typescript": "^6.0.3",