webcake-storefront-mcp 1.17.0 → 1.17.1

package/dist/changelog.json

@@ -1,4 +1,11 @@
 [
+  {
+    "v": "1.17.1",
+    "d": "25/06/2026",
+    "type": "Changed",
+    "en": "get_http_function and get_site_custom_code now include a \"File / media uploads\" section in the embedded HTTP function guide, documenting three ways…",
+    "vi": "get_http_function và get_site_custom_code nay bổ sung mục \"File / media uploads\" vào hướng dẫn HTTP function nhúng sẵn, tài liệu hóa ba cách tải…"
+  },
   {
     "v": "1.17.0",
     "d": "24/06/2026",
@@ -33,12 +40,5 @@
     "type": "Added",
     "en": "New list_events tool returns the authoritative interaction-events catalog: 9 triggers (click, hover, submit, success, ...) and 38 actions…",
     "vi": "Tool mới list_events trả về danh mục sự kiện tương tác đầy đủ: 9 trigger (click, hover, submit, success, ...) và 38 action (open_page, scroll_to,…"
-  },
-  {
-    "v": "1.13.0",
-    "d": "24/06/2026",
-    "type": "Added",
-    "en": "New restore_file_version tool rolls a CMS file back to a saved version in one step: it reads the chosen version's content (via get_file_versions)…",
-    "vi": "Tool mới restore_file_version khôi phục CMS file về một phiên bản đã lưu chỉ trong một bước: đọc nội dung phiên bản được chọn (qua…"
   }
 ]

package/dist/guides.js

@@ -95,6 +95,32 @@ they pick up site_id. Below is EXACTLY what each call sends to the backend + wha
         automation set up on the site — find it with the MCP tool list_automations.
         data is the payload passed into that automation/email template.
 
+## File / media uploads → CDN url
+Three ways, all returning a permanent CDN url:
+
+1) A client POSTs a real file (multipart/form-data) to your function — it is auto-stored on
+   the CDN and request.params.<field> / request.data.<field> is simply its CDN url (string).
+   Use it directly, no upload call needed. (A function never sees raw file bytes.)
+
+2) Upload from inside the function with '@webcake/media':
+       import { upload } from '@webcake/media';
+       const url = await upload(request, { url: someRemoteUrl });          // rehost a link
+       const url = await upload(request, { base64, content_type });        // bytes you hold
+   - { url }  — rehost a remote file (image/video/any); the SERVER fetches it (no base64).
+     Use for an AI-generated image url, an external API's file, etc.
+   - { base64, content_type } — content the function built/holds (data URI or raw base64;
+     content_type e.g. "image/png", "application/pdf"). Throws on failure.
+
+3) Direct call (admin/server, with the site's cms admin token):
+       POST /api/v1/cms_function/{site_id}/media/upload   (Authorization: Bearer <token>)
+       multipart field "file"  OR  JSON { url }  OR  JSON { base64, content_type }
+       → { success: true, data: "<cdn url>" }
+
+All three save the file into the site's media library under a dedicated, non-deletable
+folder ("API Uploads") and count toward the site's storage quota (BASIC < 3GB, STANDARD
+< 8GB, PRO unlimited). Over quota: upload() / the direct call return an error; a multipart
+file POSTed to a function comes through as null for that field.
+
 ## Sandbox globals (no import)
 - fetch(url, options)            — HTTP requests; response.ok/status/text()/json().
 - URLSearchParams                — build/parse query strings.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "webcake-storefront-mcp",
-  "version": "1.17.0",
+  "version": "1.17.1",
   "description": "MCP server for the WebCake/StoreCake storefront builder — page CRUD, page authoring, products, orders, and more",
   "mcpName": "io.github.vuluu2k/webcake-storefront-mcp",
   "license": "MIT",