@ampless/mcp-server 1.0.0-alpha.19 → 1.0.0-alpha.20

package/dist/index.d.ts

@@ -33,13 +33,29 @@ interface StorageObject {
     /** ISO 8601 timestamp of the last write, when the backend supplies it. */
     lastModified?: string;
 }
+interface PutObjectResult {
+    /**
+     * Public URL of the stored object (same format both routes use:
+     * https://{bucket}.s3.{region}.amazonaws.com/{key}).
+     */
+    url: string;
+    /**
+     * S3 ETag of the stored bytes when the underlying client surfaces
+     * it. Captured at upload time so the Media DynamoDB row can record
+     * it and the media-proxy route can later passthrough it as a
+     * response header (enabling conditional GETs from CDN clients).
+     * Optional because not all `StorageClient` impls have access to
+     * the raw S3 response.
+     */
+    etag?: string;
+}
 interface StorageClient {
     /**
      * Upload `body` to the bucket at `key` with `contentType`. Returns
-     * the public URL of the stored object (same format both routes use:
-     * https://{bucket}.s3.{region}.amazonaws.com/{key}).
+     * the public URL and (when available) the S3 ETag of the stored
+     * object.
      */
-    putObject(key: string, body: Uint8Array, contentType: string): Promise<string>;
+    putObject(key: string, body: Uint8Array, contentType: string): Promise<PutObjectResult>;
     /**
      * Remove the object at `key`. Implementations should treat a missing
      * key as success (S3 DeleteObject is idempotent by default).

package/dist/index.js

@@ -288,6 +288,9 @@ async function deletePost(client, args) {
   return { deleted: data.deletePost };
 }
 
+// src/tools/upload-media.ts
+import { encodeAwsJson as encodeAwsJson3 } from "ampless";
+
 // src/tools/media-key.ts
 function sanitizeName(name) {
   return name.replace(/[\x00-\x1f\x7f]/g, "").replace(/[\\/:*?"<>|]/g, "_").replace(/\s+/g, "_").replace(/^\.+/, "_").slice(0, 200) || "upload";
@@ -310,6 +313,7 @@ var MUTATION4 = (
       mimeType
       size
       delivery
+      metadata
     }
   }
 `
@@ -332,7 +336,9 @@ var uploadMediaSchema = {
 async function uploadMedia(graphql, storage, args) {
   const body = Buffer.from(args.base64Data, "base64");
   const key = buildMediaKey(args.filename);
-  const url = await storage.putObject(key, body, args.mimeType);
+  const putResult = await storage.putObject(key, body, args.mimeType);
+  const metadata = {};
+  if (putResult.etag) metadata.etag = putResult.etag;
   const mediaId = `media-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
   const data = await graphql.query(MUTATION4, {
     input: {
@@ -340,10 +346,11 @@ async function uploadMedia(graphql, storage, args) {
       src: key,
       mimeType: args.mimeType,
       size: body.length,
-      delivery: "nextjs"
+      delivery: "nextjs",
+      metadata: encodeAwsJson3(metadata)
     }
   });
-  return { media: data.createMedia, url };
+  return { media: data.createMedia, url: putResult.url };
 }
 
 // src/tools/get-schema.ts
@@ -939,7 +946,7 @@ function decodeUtf8(data) {
 
 // src/tools/upsert-static-post.ts
 import {
-  encodeAwsJson as encodeAwsJson3
+  encodeAwsJson as encodeAwsJson4
 } from "ampless";
 var CREATE_MUTATION = (
   /* GraphQL */
@@ -969,7 +976,7 @@ async function upsertStaticPost(graphql, slug, body, fields) {
     const input2 = {
       postId: existing.postId,
       format: "static",
-      body: encodeAwsJson3(body)
+      body: encodeAwsJson4(body)
     };
     if (fields.title !== void 0) input2.title = fields.title;
     if (fields.excerpt !== void 0) input2.excerpt = fields.excerpt;
@@ -977,7 +984,7 @@ async function upsertStaticPost(graphql, slug, body, fields) {
     if (fields.publishedAt !== void 0) input2.publishedAt = fields.publishedAt;
     if (fields.tags !== void 0) input2.tags = fields.tags;
     if (fields.metadata !== void 0) {
-      input2.metadata = encodeAwsJson3(fields.metadata);
+      input2.metadata = encodeAwsJson4(fields.metadata);
     }
     const data2 = await graphql.query(UPDATE_MUTATION, { input: input2 });
     const updated = toCorePost(data2.updatePost);
@@ -996,13 +1003,13 @@ async function upsertStaticPost(graphql, slug, body, fields) {
     slug,
     title: fields.title,
     format: "static",
-    body: encodeAwsJson3(body),
+    body: encodeAwsJson4(body),
     status
   };
   if (fields.excerpt !== void 0) input.excerpt = fields.excerpt;
   if (publishedAt !== void 0) input.publishedAt = publishedAt;
   if (fields.tags !== void 0) input.tags = fields.tags;
-  if (fields.metadata !== void 0) input.metadata = encodeAwsJson3(fields.metadata);
+  if (fields.metadata !== void 0) input.metadata = encodeAwsJson4(fields.metadata);
   const data = await graphql.query(CREATE_MUTATION, { input });
   const created = toCorePost(data.createPost);
   return { post: created, created: true };
@@ -1074,8 +1081,11 @@ async function uploadStaticBundle(graphql, storage, args) {
     await storage.deleteObject(obj.key);
   }
   let uploadedFiles = 0;
+  const filesMeta = {};
   for (const f of files) {
-    await storage.putObject(`${prefix}${f.path}`, f.data, mimeTypeFor(f.path));
+    const mimeType = mimeTypeFor(f.path);
+    await storage.putObject(`${prefix}${f.path}`, f.data, mimeType);
+    filesMeta[f.path] = { size: f.data.byteLength, mimeType };
     uploadedFiles += 1;
   }
   const body = {
@@ -1083,6 +1093,10 @@ async function uploadStaticBundle(graphql, storage, args) {
     files: files.map((f) => f.path).sort(),
     uploadedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
+  const mergedMetadata = {
+    ...args.metadata ?? {},
+    files: filesMeta
+  };
   const { post } = await upsertStaticPost(graphql, slug, body, {
     title: args.title,
     postId: args.postId,
@@ -1090,7 +1104,7 @@ async function uploadStaticBundle(graphql, storage, args) {
     publishedAt: args.publishedAt,
     excerpt: args.excerpt,
     tags: args.tags,
-    metadata: args.metadata
+    metadata: mergedMetadata
   });
   return { post, bundle: body, uploadedFiles };
 }
@@ -1144,8 +1158,8 @@ async function uploadStaticFile(storage, args) {
   }
   const contentType = args.contentType ?? mimeTypeFor2(filename);
   const key = `${bundlePrefix2(args.slug)}${filename}`;
-  const url = await storage.putObject(key, body, contentType);
-  return { key, url, size: body.length };
+  const { url } = await storage.putObject(key, body, contentType);
+  return { key, url, size: body.length, contentType };
 }
 
 // src/tools/delete-static-file.ts
@@ -1180,6 +1194,7 @@ async function deleteStaticFile(storage, args) {
 // src/tools/commit-static-post.ts
 import {
   bundlePrefix as bundlePrefix4,
+  mimeTypeFor as mimeTypeFor3,
   pickDefaultEntrypoint as pickDefaultEntrypoint2
 } from "ampless";
 var commitStaticPostSchema = {
@@ -1219,7 +1234,15 @@ async function commitStaticPost(graphql, storage, args) {
       `commit_static_post: no files found under "${prefix}". Upload at least one file via upload_static_file or upload_static_bundle before committing.`
     );
   }
-  const relPaths = objects.map((o) => o.key.slice(prefix.length)).filter((p) => p !== "").sort();
+  const filesMeta = {};
+  const relPaths = [];
+  for (const obj of objects) {
+    const rel = obj.key.slice(prefix.length);
+    if (rel === "") continue;
+    relPaths.push(rel);
+    filesMeta[rel] = { size: obj.size, mimeType: mimeTypeFor3(rel) };
+  }
+  relPaths.sort();
   const entrypoint = args.entrypoint ?? pickDefaultEntrypoint2(relPaths.map((p) => ({ path: p })));
   if (!relPaths.includes(entrypoint)) {
     throw new Error(
@@ -1231,6 +1254,10 @@ async function commitStaticPost(graphql, storage, args) {
     files: relPaths,
     uploadedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
+  const mergedMetadata = {
+    ...args.metadata ?? {},
+    files: filesMeta
+  };
   const { post, created } = await upsertStaticPost(graphql, slug, body, {
     title: args.title,
     postId: args.postId,
@@ -1238,7 +1265,7 @@ async function commitStaticPost(graphql, storage, args) {
     status: args.status,
     publishedAt: args.publishedAt,
     tags: args.tags,
-    metadata: args.metadata
+    metadata: mergedMetadata
   });
   return { post, bundle: body, created };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ampless/mcp-server",
-  "version": "1.0.0-alpha.19",
+  "version": "1.0.0-alpha.20",
   "description": "MCP tool registry shared by @ampless/backend mcp-handler Lambda. Installed transitively via @ampless/admin / @ampless/backend; no direct install needed.",
   "publishConfig": {
     "access": "public"
@@ -26,7 +26,7 @@
   "bugs": "https://github.com/heavymoons/ampless/issues",
   "dependencies": {
     "fflate": "^0.8.3",
-    "ampless": "1.0.0-alpha.15"
+    "ampless": "1.0.0-alpha.16"
   },
   "keywords": [
     "ampless",