frontpage-host 0.3.13 → 0.3.14

package/AGENTS.md

@@ -299,3 +299,19 @@ For a manual group, `groups.people` accepts `availability: "all" | "available" |
 Complete Store edits: use existing items update --file with changed fields and variantUpdates. stock requires expectedStock from a fresh items get. One transaction saves all changes or none. On 409 review current stock; never silently substitute it. firstVariant plus optionNames enables versions. Keep explicit stock/variant commands for single operations. Routines add accepts --request-id UUID; reuse that ID and exact schedule after a lost response. Ordinary form edits live only in the active task; Cancel keeps input, Discard loses unfinished input. Submitted payments, imports, builds, and API-key status are separate operations.
 
 Template history (frontpage-host 0.3.11+): read `mail template get ID` before editing. `mail template history ID --limit 20 --cursor CURSOR` pages saved copies; `mail template history-get ID --history-id COPY_ID` fetches full content. Edit any copy, then `mail template set ID --file content.json` with the stable template ID and content fields only to make a new latest copy. Last template save wins; past copies remain. Campaign and series conflict checks remain. Retry uncertain saves through `mail save` with the same requestKey and exact payload. History begins with content retained at launch; earlier overwritten edits are unavailable. History reads use the plan’s Rewind window and always include Latest, even when older. Older copies stay stored; lists and direct reads apply the same limit. Window metadata explains the limit and whether older copies exist. See MAIL.md.
+
+## Uploaded video preparation
+
+The current CLI attempts browser-compatible H.264 MP4 preparation after a local video
+upload. This applies to `frontpage media upload` and `frontpage prompt --attach ./clip.mov`.
+Use the returned `sitePath`; do not reconstruct a path from the original filename.
+A successful conversion returns `prepared:true` and the MP4's actual filename, size and
+URL. If preparation fails, the original remains usable as an upload with `prepared:false`
+and a compatibility warning. Warnings print on stderr and appear in JSON success data.
+An original's MP4/MOV extension does not establish browser compatibility.
+
+`frontpage media list` and the website agent's `list_site_assets` prefer a completed
+prepared copy over its exact original. Different uploads with the same display name
+remain distinct. Existing URLs and published videos are not converted automatically.
+Upgrade the CLI to receive upload-time preparation. Source path and access denials
+remain errors; they do not become original-file fallback successes.

package/README.md

@@ -122,3 +122,19 @@ GPT 6 Luna is the default for new website runs. Explicit site model preferences
 ### Template history
 
 Template history (0.3.11+): `frontpage mail template history ID` lists saved copies; `history-get ID --history-id COPY_ID` reads full content. Edit any copy and save with `template set ID --file content.json` to make it latest. Use the stable template ID, read current content before editing, and see [MAIL.md](./MAIL.md#template-history) for paging, access and retry-safe saves.
+
+## Uploaded video preparation
+
+The current CLI attempts browser-compatible H.264 MP4 preparation after a local video
+upload. This applies to `frontpage media upload` and `frontpage prompt --attach ./clip.mov`.
+Use the returned `sitePath`; do not reconstruct a path from the original filename.
+A successful conversion returns `prepared:true` and the MP4's actual filename, size and
+URL. If preparation fails, the original remains usable as an upload with `prepared:false`
+and a compatibility warning. Warnings print on stderr and appear in JSON success data.
+An original's MP4/MOV extension does not establish browser compatibility.
+
+`frontpage media list` and the website agent's `list_site_assets` prefer a completed
+prepared copy over its exact original. Different uploads with the same display name
+remain distinct. Existing URLs and published videos are not converted automatically.
+Upgrade the CLI to receive upload-time preparation. Source path and access denials
+remain errors; they do not become original-file fallback successes.

package/dist/commands/prompt-attach.d.ts

@@ -23,6 +23,7 @@ export type PromptAttachmentsPayload = {
         url: string;
         name?: string;
         sizeBytes?: number;
+        warning?: string;
     }>;
 };
 export type MediaUploadResult = UploadedMedia;

package/dist/commands/prompt-attach.js

@@ -101,8 +101,9 @@ export function addUploadResult(out, data) {
             if (!out.videos.some((x) => x.url === data.url)) {
                 out.videos.push({
                     url: data.url,
-                    name,
+                    name: data.prepared ? data.filename ?? name : name,
                     sizeBytes: data.sizeBytes,
+                    ...(data.warning ? { warning: data.warning } : {}),
                 });
             }
             return;
@@ -122,7 +123,7 @@ export async function uploadLocalForAttach(slug, filePath) {
     return uploadLocalMedia({ slug, filePath });
 }
 export async function resolveSitePathUrl(slug, sitePath) {
-    const data = await v1Get(`/api/v1/sites/${encodeURIComponent(slug)}/media`);
+    const data = await v1Get(`/api/v1/sites/${encodeURIComponent(slug)}/media?path=${encodeURIComponent(sitePath.replace(/\/+/g, "/").replace(/\/$/, ""))}`);
     const norm = (p) => p.replace(/\/+/g, "/").replace(/\/$/, "") || p;
     const want = norm(sitePath);
     const hit = data.assets.find((a) => a.sitePath === sitePath || norm(a.sitePath) === want);

package/dist/media/upload.d.ts

@@ -8,6 +8,8 @@ export type UploadedMedia = {
     contentType?: string;
     content?: string;
     transport?: "proxy" | "client";
+    prepared?: boolean;
+    warning?: string;
 };
 /** Upload a local file using the Phase E transport matrix. */
 export declare function uploadLocalMedia(args: {

package/dist/media/upload.js

@@ -5,7 +5,7 @@ import { randomUUID } from "node:crypto";
 import { readFile } from "node:fs/promises";
 import { basename } from "node:path";
 import { put } from "@vercel/blob/client";
-import { apiBase, CliHttpError, EXIT_AUTH, EXIT_UNEXPECTED, EXIT_USAGE, getBearerAuthHeader, httpErrorFromV1, v1PostMultipart, } from "../http/client.js";
+import { apiBase, CliHttpError, EXIT_AUTH, EXIT_UNEXPECTED, EXIT_USAGE, getBearerAuthHeader, httpErrorFromV1, v1PostMultipart, v1Post, } from "../http/client.js";
 import { contentTypeForExt, sitePathFromKey } from "./limits.js";
 import { selectMediaTransport } from "./select-transport.js";
 async function requestClientToken(args) {
@@ -81,7 +81,7 @@ async function uploadViaClient(args) {
             multipart,
         });
         const key = blob.pathname.replace(/^\//, "");
-        return {
+        const original = {
             kind: args.kind,
             url: blob.url,
             key,
@@ -91,8 +91,28 @@ async function uploadViaClient(args) {
             contentType: args.contentType || contentTypeForExt(args.ext),
             transport: "client",
         };
+        if (args.kind !== "video")
+            return original;
+        try {
+            const prepared = await v1Post(`/api/v1/sites/${encodeURIComponent(args.slug)}/media/prepare`, { key, filename: args.filename }, { timeoutMs: 110000 });
+            if (typeof prepared.url !== "string" || typeof prepared.sitePath !== "string" || typeof prepared.filename !== "string" || typeof prepared.prepared !== "boolean")
+                throw new Error("Invalid video preparation response");
+            const result = { ...prepared, transport: "client" };
+            if (result.warning)
+                console.error(result.warning);
+            return result;
+        }
+        catch (error) {
+            if (error instanceof CliHttpError && error.status >= 400 && error.status < 500 && ![408, 429].includes(error.status))
+                throw error;
+            const warning = "Uploaded original video. Some browsers may not play this format.";
+            console.error(warning);
+            return { ...original, prepared: false, warning };
+        }
     }
     catch (err) {
+        if (err instanceof CliHttpError)
+            throw err;
         const msg = err instanceof Error ? err.message : String(err);
         throw new CliHttpError(`Upload failed: ${msg}`, EXIT_UNEXPECTED, 500);
     }

package/dist/registry.js

@@ -407,6 +407,9 @@ export const COMMANDS = [
         ],
         flags: [
             "Auto-selects proxy (≤4 MB) vs direct-to-Blob for large rasters/PDFs and all video",
+            "Video uploads then attempt browser-compatible MP4 preparation; use the returned sitePath",
+            "Preparation failure keeps the original with a stderr warning and prepared:false in JSON",
+            "media list prefers an exact completed prepared video over its original",
             "Human success: sitePath first (markup-safe), then url: (blob URL for debugging)",
             "Use sitePath (/__media/uploads/<slug>/…) in markup — never raw blob hosts in pages",
             "Text/CSV upload is inline only — not a media-library asset (no /__media link); --json omits full content",

package/llms.txt

@@ -59,3 +59,5 @@ The workspace validates and saves unfinished group settings before opening email
 Complete Store edits: use existing items update --file with changed fields and variantUpdates. stock requires expectedStock from a fresh items get. One transaction saves all changes or none. On 409 review current stock; never silently substitute it. firstVariant plus optionNames enables versions. Keep explicit stock/variant commands for single operations. Routines add accepts --request-id UUID; reuse that ID and exact schedule after a lost response. Ordinary form edits live only in the active task; Cancel keeps input, Discard loses unfinished input. Submitted payments, imports, builds, and API-key status are separate operations.
 
 Template history (frontpage-host 0.3.11+): read `mail template get ID` before editing. `mail template history ID --limit 20 --cursor CURSOR` pages saved copies; `mail template history-get ID --history-id COPY_ID` fetches full content. Edit any copy, then `mail template set ID --file content.json` with the stable template ID and content fields only to make a new latest copy. Last template save wins; past copies remain. Campaign and series conflict checks remain. Retry uncertain saves through `mail save` with the same requestKey and exact payload. History begins with content retained at launch; earlier overwritten edits are unavailable. History reads use the plan’s Rewind window and always include Latest, even when older. Older copies stay stored; lists and direct reads apply the same limit. Window metadata explains the limit and whether older copies exist. See MAIL.md.
+
+Video uploads: the current CLI prepares a browser-compatible MP4 after uploading a local video, including prompt --attach. Use the returned sitePath and actual filename. prepared:false plus warning means the original was retained and playback compatibility is not assured. media list prefers an exact completed prepared copy. Existing video URLs are unchanged. See AGENTS.md for the upload and fallback contract.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "frontpage-host",
-  "version": "0.3.13",
+  "version": "0.3.14",
   "description": "Frontpage CLI — manage your site from the terminal",
   "type": "module",
   "bin": {