@buzzposter/mcp 0.3.6 → 0.3.7

package/dist/index.js

@@ -118,6 +118,79 @@ var BuzzPosterClient = class {
   async uploadFromUrl(data) {
     return this.request("POST", "/api/v1/media/upload-from-url", data);
   }
+  async uploadFile(filePath, filename) {
+    const fs4 = await import("fs");
+    const pathMod = await import("path");
+    const buffer = fs4.readFileSync(filePath);
+    const name = filename || pathMod.basename(filePath);
+    const ext = pathMod.extname(name).toLowerCase();
+    const mimeMap = {
+      ".jpg": "image/jpeg",
+      ".jpeg": "image/jpeg",
+      ".png": "image/png",
+      ".gif": "image/gif",
+      ".webp": "image/webp",
+      ".svg": "image/svg+xml",
+      ".mp4": "video/mp4",
+      ".mov": "video/quicktime",
+      ".webm": "video/webm"
+    };
+    const mime = mimeMap[ext] || "application/octet-stream";
+    const formData = new FormData();
+    formData.append("file", new Blob([buffer], { type: mime }), name);
+    const url = new URL(`${this.baseUrl}/api/v1/media/upload`);
+    const headers = {
+      Authorization: `Bearer ${this.apiKey}`
+    };
+    if (this.organizationId) {
+      headers["X-Organization-Id"] = this.organizationId;
+    }
+    const res = await fetch(url, { method: "POST", headers, body: formData });
+    if (!res.ok) {
+      const errorBody = await res.json().catch(() => ({ message: res.statusText }));
+      let message = `API error (${res.status})`;
+      if (errorBody && typeof errorBody === "object") {
+        const b = errorBody;
+        if (typeof b.message === "string" && b.message) message = b.message;
+        else if (typeof b.error === "string" && b.error) message = b.error;
+      }
+      throw new Error(`BuzzPoster API error (${res.status}): ${message}`);
+    }
+    const text = await res.text();
+    return text ? JSON.parse(text) : void 0;
+  }
+  async uploadBase64(data, filename, contentType) {
+    const buffer = Buffer.from(data, "base64");
+    const mime = contentType || "application/octet-stream";
+    const formData = new FormData();
+    formData.append("file", new Blob([buffer], { type: mime }), filename);
+    const url = new URL(`${this.baseUrl}/api/v1/media/upload`);
+    const headers = {
+      Authorization: `Bearer ${this.apiKey}`
+    };
+    if (this.organizationId) {
+      headers["X-Organization-Id"] = this.organizationId;
+    }
+    const res = await fetch(url, { method: "POST", headers, body: formData });
+    if (!res.ok) {
+      const errorBody = await res.json().catch(() => ({ message: res.statusText }));
+      let message = `API error (${res.status})`;
+      if (errorBody && typeof errorBody === "object") {
+        const b = errorBody;
+        if (typeof b.message === "string" && b.message) message = b.message;
+        else if (typeof b.error === "string" && b.error) message = b.error;
+      }
+      throw new Error(`BuzzPoster API error (${res.status}): ${message}`);
+    }
+    const text = await res.text();
+    return text ? JSON.parse(text) : void 0;
+  }
+  async presignUpload(filename, contentType) {
+    return this.request("POST", "/api/v1/media/presign", { filename, content_type: contentType });
+  }
+  async confirmUpload(key, filename, contentType) {
+    return this.request("POST", "/api/v1/media/confirm-upload", { key, filename, content_type: contentType });
+  }
   async listMedia() {
     return this.request("GET", "/api/v1/media");
   }
@@ -1258,14 +1331,17 @@ function registerMediaTools(server2, client2) {
     "manage_media",
     {
       title: "Manage Media",
-      description: "Browse assets gallery, upload from URL, list files, or delete media.",
+      description: "Browse assets gallery, upload from URL, local file, or base64 data, list files, or delete media.",
       inputSchema: {
-        action: z3.enum(["get_assets", "upload", "list", "delete"]),
+        action: z3.enum(["get_assets", "upload", "upload_file", "upload_base64", "presign", "confirm_upload", "list", "delete"]),
         limit: z3.number().optional().describe("Max assets to return (get_assets, default 10, max 20)"),
         url: z3.string().optional().describe("Public URL to upload (upload)"),
-        filename: z3.string().optional().describe("Filename override (upload)"),
+        file_path: z3.string().optional().describe("Local file path to upload (upload_file)"),
+        data: z3.string().optional().describe("Base64-encoded file contents (upload_base64)"),
+        content_type: z3.string().optional().describe("MIME type e.g. image/png (upload_base64, presign, confirm_upload)"),
+        filename: z3.string().optional().describe("Filename (upload, upload_file, upload_base64, presign, confirm_upload)"),
         folder: z3.string().optional().describe("Storage folder path (upload)"),
-        key: z3.string().optional().describe("Media file key/path (delete)"),
+        key: z3.string().optional().describe("Media file key/path (delete, confirm_upload)"),
         confirmed: z3.boolean().default(false).describe("Confirm deletion (delete)")
       },
       annotations: {
@@ -1342,6 +1418,92 @@ function registerMediaTools(server2, client2) {
           content: [{ type: "text", text: lines.join("\n") }]
         };
       }
+      if (args.action === "upload_file") {
+        if (!args.file_path) {
+          return { content: [{ type: "text", text: "file_path is required for upload_file." }], isError: true };
+        }
+        if (!fs2.existsSync(args.file_path)) {
+          return { content: [{ type: "text", text: `File not found: ${args.file_path}` }], isError: true };
+        }
+        const result = await client2.uploadFile(args.file_path, args.filename);
+        const lines = [];
+        lines.push("## Upload Complete");
+        lines.push("");
+        lines.push(`**URL:** ${result.url ?? "unknown"}`);
+        lines.push(`**Filename:** ${result.filename ?? "unknown"}`);
+        lines.push(`**Size:** ${formatSize(result.size)}`);
+        lines.push(`**Type:** ${result.mimeType ?? "unknown"}`);
+        return {
+          content: [{ type: "text", text: lines.join("\n") }]
+        };
+      }
+      if (args.action === "upload_base64") {
+        if (!args.data) {
+          return { content: [{ type: "text", text: "data (base64 string) is required for upload_base64." }], isError: true };
+        }
+        if (!args.filename) {
+          return { content: [{ type: "text", text: "filename is required for upload_base64." }], isError: true };
+        }
+        const result = await client2.uploadBase64(args.data, args.filename, args.content_type);
+        const lines = [];
+        lines.push("## Upload Complete");
+        lines.push("");
+        lines.push(`**URL:** ${result.url ?? "unknown"}`);
+        lines.push(`**Filename:** ${result.filename ?? "unknown"}`);
+        lines.push(`**Size:** ${formatSize(result.size)}`);
+        lines.push(`**Type:** ${result.mimeType ?? "unknown"}`);
+        return {
+          content: [{ type: "text", text: lines.join("\n") }]
+        };
+      }
+      if (args.action === "presign") {
+        if (!args.filename) {
+          return { content: [{ type: "text", text: "filename is required for presign." }], isError: true };
+        }
+        if (!args.content_type) {
+          return { content: [{ type: "text", text: "content_type is required for presign (e.g. image/png)." }], isError: true };
+        }
+        const result = await client2.presignUpload(args.filename, args.content_type);
+        const lines = [];
+        lines.push("## Presigned Upload URL");
+        lines.push("");
+        lines.push(`**Upload URL:** ${result.upload_url}`);
+        lines.push(`**CDN URL:** ${result.cdn_url}`);
+        lines.push(`**Key:** ${result.key}`);
+        lines.push(`**Expires:** ${result.expires_at}`);
+        lines.push("");
+        lines.push("**Step 1:** Upload the file:");
+        lines.push("```");
+        lines.push(`curl -X PUT -H "Content-Type: ${args.content_type}" --data-binary @${args.filename} "${result.upload_url}"`);
+        lines.push("```");
+        lines.push("");
+        lines.push(`**Step 2:** Register the upload by calling this tool with action=confirm_upload, key="${result.key}", filename="${args.filename}", content_type="${args.content_type}"`);
+        return {
+          content: [{ type: "text", text: lines.join("\n") }]
+        };
+      }
+      if (args.action === "confirm_upload") {
+        if (!args.key) {
+          return { content: [{ type: "text", text: "key is required for confirm_upload." }], isError: true };
+        }
+        if (!args.filename) {
+          return { content: [{ type: "text", text: "filename is required for confirm_upload." }], isError: true };
+        }
+        if (!args.content_type) {
+          return { content: [{ type: "text", text: "content_type is required for confirm_upload." }], isError: true };
+        }
+        const result = await client2.confirmUpload(args.key, args.filename, args.content_type);
+        const lines = [];
+        lines.push("## Upload Confirmed");
+        lines.push("");
+        lines.push(`**URL:** ${result.url}`);
+        lines.push(`**Filename:** ${result.filename}`);
+        lines.push(`**Size:** ${formatSize(result.size)}`);
+        lines.push(`**Type:** ${result.mimeType}`);
+        return {
+          content: [{ type: "text", text: lines.join("\n") }]
+        };
+      }
       if (args.action === "list") {
         const result = await client2.listMedia();
         const items = result?.media ?? [];

package/dist/tools.d.ts

@@ -32,6 +32,22 @@ declare class BuzzPosterClient {
         filename?: string;
         folder?: string;
     }): Promise<unknown>;
+    uploadFile(filePath: string, filename?: string): Promise<any>;
+    uploadBase64(data: string, filename: string, contentType?: string): Promise<any>;
+    presignUpload(filename: string, contentType: string): Promise<{
+        upload_url: string;
+        cdn_url: string;
+        key: string;
+        expires_at: string;
+    }>;
+    confirmUpload(key: string, filename: string, contentType: string): Promise<{
+        id: number;
+        key: string;
+        filename: string;
+        mimeType: string;
+        size: number;
+        url: string;
+    }>;
     listMedia(): Promise<unknown>;
     deleteMedia(key: string): Promise<unknown>;
     listSubscribers(params?: Record<string, string>): Promise<unknown>;

package/dist/tools.js

@@ -112,6 +112,79 @@ var BuzzPosterClient = class {
   async uploadFromUrl(data) {
     return this.request("POST", "/api/v1/media/upload-from-url", data);
   }
+  async uploadFile(filePath, filename) {
+    const fs4 = await import("fs");
+    const pathMod = await import("path");
+    const buffer = fs4.readFileSync(filePath);
+    const name = filename || pathMod.basename(filePath);
+    const ext = pathMod.extname(name).toLowerCase();
+    const mimeMap = {
+      ".jpg": "image/jpeg",
+      ".jpeg": "image/jpeg",
+      ".png": "image/png",
+      ".gif": "image/gif",
+      ".webp": "image/webp",
+      ".svg": "image/svg+xml",
+      ".mp4": "video/mp4",
+      ".mov": "video/quicktime",
+      ".webm": "video/webm"
+    };
+    const mime = mimeMap[ext] || "application/octet-stream";
+    const formData = new FormData();
+    formData.append("file", new Blob([buffer], { type: mime }), name);
+    const url = new URL(`${this.baseUrl}/api/v1/media/upload`);
+    const headers = {
+      Authorization: `Bearer ${this.apiKey}`
+    };
+    if (this.organizationId) {
+      headers["X-Organization-Id"] = this.organizationId;
+    }
+    const res = await fetch(url, { method: "POST", headers, body: formData });
+    if (!res.ok) {
+      const errorBody = await res.json().catch(() => ({ message: res.statusText }));
+      let message = `API error (${res.status})`;
+      if (errorBody && typeof errorBody === "object") {
+        const b = errorBody;
+        if (typeof b.message === "string" && b.message) message = b.message;
+        else if (typeof b.error === "string" && b.error) message = b.error;
+      }
+      throw new Error(`BuzzPoster API error (${res.status}): ${message}`);
+    }
+    const text = await res.text();
+    return text ? JSON.parse(text) : void 0;
+  }
+  async uploadBase64(data, filename, contentType) {
+    const buffer = Buffer.from(data, "base64");
+    const mime = contentType || "application/octet-stream";
+    const formData = new FormData();
+    formData.append("file", new Blob([buffer], { type: mime }), filename);
+    const url = new URL(`${this.baseUrl}/api/v1/media/upload`);
+    const headers = {
+      Authorization: `Bearer ${this.apiKey}`
+    };
+    if (this.organizationId) {
+      headers["X-Organization-Id"] = this.organizationId;
+    }
+    const res = await fetch(url, { method: "POST", headers, body: formData });
+    if (!res.ok) {
+      const errorBody = await res.json().catch(() => ({ message: res.statusText }));
+      let message = `API error (${res.status})`;
+      if (errorBody && typeof errorBody === "object") {
+        const b = errorBody;
+        if (typeof b.message === "string" && b.message) message = b.message;
+        else if (typeof b.error === "string" && b.error) message = b.error;
+      }
+      throw new Error(`BuzzPoster API error (${res.status}): ${message}`);
+    }
+    const text = await res.text();
+    return text ? JSON.parse(text) : void 0;
+  }
+  async presignUpload(filename, contentType) {
+    return this.request("POST", "/api/v1/media/presign", { filename, content_type: contentType });
+  }
+  async confirmUpload(key, filename, contentType) {
+    return this.request("POST", "/api/v1/media/confirm-upload", { key, filename, content_type: contentType });
+  }
   async listMedia() {
     return this.request("GET", "/api/v1/media");
   }
@@ -1252,14 +1325,17 @@ function registerMediaTools(server, client) {
     "manage_media",
     {
       title: "Manage Media",
-      description: "Browse assets gallery, upload from URL, list files, or delete media.",
+      description: "Browse assets gallery, upload from URL, local file, or base64 data, list files, or delete media.",
       inputSchema: {
-        action: z3.enum(["get_assets", "upload", "list", "delete"]),
+        action: z3.enum(["get_assets", "upload", "upload_file", "upload_base64", "presign", "confirm_upload", "list", "delete"]),
         limit: z3.number().optional().describe("Max assets to return (get_assets, default 10, max 20)"),
         url: z3.string().optional().describe("Public URL to upload (upload)"),
-        filename: z3.string().optional().describe("Filename override (upload)"),
+        file_path: z3.string().optional().describe("Local file path to upload (upload_file)"),
+        data: z3.string().optional().describe("Base64-encoded file contents (upload_base64)"),
+        content_type: z3.string().optional().describe("MIME type e.g. image/png (upload_base64, presign, confirm_upload)"),
+        filename: z3.string().optional().describe("Filename (upload, upload_file, upload_base64, presign, confirm_upload)"),
         folder: z3.string().optional().describe("Storage folder path (upload)"),
-        key: z3.string().optional().describe("Media file key/path (delete)"),
+        key: z3.string().optional().describe("Media file key/path (delete, confirm_upload)"),
         confirmed: z3.boolean().default(false).describe("Confirm deletion (delete)")
       },
       annotations: {
@@ -1336,6 +1412,92 @@ function registerMediaTools(server, client) {
           content: [{ type: "text", text: lines.join("\n") }]
         };
       }
+      if (args.action === "upload_file") {
+        if (!args.file_path) {
+          return { content: [{ type: "text", text: "file_path is required for upload_file." }], isError: true };
+        }
+        if (!fs2.existsSync(args.file_path)) {
+          return { content: [{ type: "text", text: `File not found: ${args.file_path}` }], isError: true };
+        }
+        const result = await client.uploadFile(args.file_path, args.filename);
+        const lines = [];
+        lines.push("## Upload Complete");
+        lines.push("");
+        lines.push(`**URL:** ${result.url ?? "unknown"}`);
+        lines.push(`**Filename:** ${result.filename ?? "unknown"}`);
+        lines.push(`**Size:** ${formatSize(result.size)}`);
+        lines.push(`**Type:** ${result.mimeType ?? "unknown"}`);
+        return {
+          content: [{ type: "text", text: lines.join("\n") }]
+        };
+      }
+      if (args.action === "upload_base64") {
+        if (!args.data) {
+          return { content: [{ type: "text", text: "data (base64 string) is required for upload_base64." }], isError: true };
+        }
+        if (!args.filename) {
+          return { content: [{ type: "text", text: "filename is required for upload_base64." }], isError: true };
+        }
+        const result = await client.uploadBase64(args.data, args.filename, args.content_type);
+        const lines = [];
+        lines.push("## Upload Complete");
+        lines.push("");
+        lines.push(`**URL:** ${result.url ?? "unknown"}`);
+        lines.push(`**Filename:** ${result.filename ?? "unknown"}`);
+        lines.push(`**Size:** ${formatSize(result.size)}`);
+        lines.push(`**Type:** ${result.mimeType ?? "unknown"}`);
+        return {
+          content: [{ type: "text", text: lines.join("\n") }]
+        };
+      }
+      if (args.action === "presign") {
+        if (!args.filename) {
+          return { content: [{ type: "text", text: "filename is required for presign." }], isError: true };
+        }
+        if (!args.content_type) {
+          return { content: [{ type: "text", text: "content_type is required for presign (e.g. image/png)." }], isError: true };
+        }
+        const result = await client.presignUpload(args.filename, args.content_type);
+        const lines = [];
+        lines.push("## Presigned Upload URL");
+        lines.push("");
+        lines.push(`**Upload URL:** ${result.upload_url}`);
+        lines.push(`**CDN URL:** ${result.cdn_url}`);
+        lines.push(`**Key:** ${result.key}`);
+        lines.push(`**Expires:** ${result.expires_at}`);
+        lines.push("");
+        lines.push("**Step 1:** Upload the file:");
+        lines.push("```");
+        lines.push(`curl -X PUT -H "Content-Type: ${args.content_type}" --data-binary @${args.filename} "${result.upload_url}"`);
+        lines.push("```");
+        lines.push("");
+        lines.push(`**Step 2:** Register the upload by calling this tool with action=confirm_upload, key="${result.key}", filename="${args.filename}", content_type="${args.content_type}"`);
+        return {
+          content: [{ type: "text", text: lines.join("\n") }]
+        };
+      }
+      if (args.action === "confirm_upload") {
+        if (!args.key) {
+          return { content: [{ type: "text", text: "key is required for confirm_upload." }], isError: true };
+        }
+        if (!args.filename) {
+          return { content: [{ type: "text", text: "filename is required for confirm_upload." }], isError: true };
+        }
+        if (!args.content_type) {
+          return { content: [{ type: "text", text: "content_type is required for confirm_upload." }], isError: true };
+        }
+        const result = await client.confirmUpload(args.key, args.filename, args.content_type);
+        const lines = [];
+        lines.push("## Upload Confirmed");
+        lines.push("");
+        lines.push(`**URL:** ${result.url}`);
+        lines.push(`**Filename:** ${result.filename}`);
+        lines.push(`**Size:** ${formatSize(result.size)}`);
+        lines.push(`**Type:** ${result.mimeType}`);
+        return {
+          content: [{ type: "text", text: lines.join("\n") }]
+        };
+      }
       if (args.action === "list") {
         const result = await client.listMedia();
         const items = result?.media ?? [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buzzposter/mcp",
-  "version": "0.3.6",
+  "version": "0.3.7",
   "description": "BuzzPoster MCP server - Social media, newsletters, and media hosting for any AI chatbot",
   "type": "module",
   "main": "dist/index.js",