@mevdragon/vidfarm-devcli 0.2.3 → 0.2.5

package/README.md

@@ -51,7 +51,7 @@ The local CLI runs the same template contract used by the hosted platform, but w
 
 Use `vidfarm session` to print reusable auth headers and a sample `curl` request for the local REST API.
 
-For hosted preview-media uploads, use `vidfarm-devcli presign-preview-media`. It calls the authenticated Vidfarm API with `VIDFARM_API_KEY` and returns a presigned PUT URL under `developer/<user_id>/preview_media/*` plus the resulting Vidfarm media URL.
+For hosted preview-media uploads, use `vidfarm-devcli presign-preview-media`. It calls the authenticated Vidfarm API with `VIDFARM_API_KEY`, mints a presigned PUT URL under `developer/<user_id>/*`, stores each uploaded file under a UUID path segment while preserving the original filename, uploads the file automatically when `--file` is provided, and returns a public-read media URL for the uploaded object.
 
 ## What The Hosted Platform Expects From Templates
 

package/SKILL.developer.md

@@ -221,7 +221,7 @@ drafts/
 
 This is the preferred handoff shape for agent-driven template creation. A Vidfarm developer should be able to drag media into `drafts/preview/`, add rough notes to `drafts/source_notes.md`, then tell the agent to create a template from those relative paths.
 
-If the source media is not already present in the repo, upload it into the authenticated developer preview-media namespace first instead of inventing ad hoc external hosting. Use:
+If the source media is not already present in the repo, upload it into the authenticated developer storage namespace first instead of inventing ad hoc external hosting. An agent can take a developer-provided local file path and run this directly:
 
 ```bash
 npx @mevdragon/vidfarm-devcli presign-preview-media \
@@ -229,7 +229,7 @@ npx @mevdragon/vidfarm-devcli presign-preview-media \
   --directory drafts/preview
 ```
 
-That command calls the hosted Vidfarm API with the user's `VIDFARM_API_KEY`, mints a presigned PUT URL scoped under `developer/<user_id>/preview_media/*`, and returns both the `storage_key` and a Vidfarm `preview_media_url`. Agents should prefer that path for hosted preview uploads.
+That command calls the hosted Vidfarm API with the user's `VIDFARM_API_KEY`, mints a presigned PUT URL scoped under `developer/<user_id>/*`, stores each uploaded file under a UUID path segment while preserving the original filename, uploads the file automatically when `--file` is provided, and returns both the `storage_key` and a public-read `preview_media_url`. Objects under `developer/<user_id>/*` may be read directly by URL but should not be treated as listable or writable without authenticated API access. Agents should prefer that path for hosted preview uploads whenever the input is a local media file path.
 
 ### 2. Start local runtime
 

package/dist/src/app.js

@@ -1,3 +1,4 @@
+import { randomUUID } from "node:crypto";
 import { readFileSync, statSync } from "node:fs";
 import path from "node:path";
 import { Hono } from "hono";
@@ -979,17 +980,19 @@ app.post(`${USER_PREFIX}/me/developer/preview-media/presign`, async (c) => {
             return c.json({ error: `Unsupported preview media type: ${fileName}` }, 400);
         }
         const directory = sanitizeStorageSubpath(body.directory);
-        const storageKey = storage.developerPreviewMediaKey(customer.id, directory, createId("preview"), fileName);
+        const storageKey = storage.developerScopedKey(customer.id, directory, randomUUID(), fileName);
         const upload = await storage.createWriteUrl(storageKey, {
             contentType,
-            publicRead: false,
+            publicRead: true,
             expiresIn: 3600
         });
+        const publicUrl = storage.getPublicUrl(storageKey) ?? buildAbsoluteUrl(c, `/template-media?key=${encodeURIComponent(storageKey)}`);
         return c.json({
             file_name: fileName,
             content_type: contentType,
             storage_key: storageKey,
-            preview_media_url: buildAbsoluteUrl(c, `/template-media?key=${encodeURIComponent(storageKey)}`),
+            preview_media_url: publicUrl,
+            public_url: publicUrl,
             upload: {
                 method: upload.method,
                 url: upload.url,

package/dist/src/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { cpSync, existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
+import { cpSync, existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { execFile } from "node:child_process";
 import { randomUUID } from "node:crypto";
 import os from "node:os";
@@ -516,6 +516,25 @@ async function runPresignPreviewMediaCommand(argv) {
     if (!response.ok) {
         throw new Error(typeof payload.error === "string" ? payload.error : `Preview-media presign failed with ${response.status}.`);
     }
+    let uploadResult = null;
+    if (filePath) {
+        const body = readFileSync(filePath);
+        const uploadResponse = await fetch(String(payload.upload?.url), {
+            method: String(payload.upload?.method ?? "PUT"),
+            headers: payload.upload?.headers,
+            body
+        });
+        if (!uploadResponse.ok) {
+            const errorText = await uploadResponse.text().catch(() => "");
+            throw new Error(`Preview-media upload failed with ${uploadResponse.status}${errorText ? `: ${errorText}` : "."}`);
+        }
+        uploadResult = {
+            uploaded: true,
+            size_bytes: statSync(filePath).size,
+            method: payload.upload?.method ?? "PUT",
+            status: uploadResponse.status
+        };
+    }
     console.log(JSON.stringify({
         base_url: baseUrl,
         file_path: filePath,
@@ -523,6 +542,8 @@ async function runPresignPreviewMediaCommand(argv) {
         content_type: payload.content_type,
         storage_key: payload.storage_key,
         preview_media_url: payload.preview_media_url,
+        public_url: payload.public_url ?? payload.preview_media_url,
+        upload_result: uploadResult,
         upload: payload.upload,
         curl_upload_example: [
             `curl -X ${payload.upload.method} '${payload.upload.url}' \\`,

package/dist/src/services/storage.js

@@ -20,8 +20,8 @@ export class StorageService {
     developerAttachmentKey(customerId, attachmentId, fileName) {
         return joinStorageKey("developer", customerId, "attachments", attachmentId, fileName);
     }
-    developerPreviewMediaKey(customerId, ...parts) {
-        return joinStorageKey("developer", customerId, "preview_media", ...parts);
+    developerScopedKey(customerId, ...parts) {
+        return joinStorageKey("developer", customerId, ...parts);
     }
     templateJobPrefix(templateId, customerId, jobId) {
         return joinStorageKey("templates", templateId, "users", customerId, "jobs", jobId);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mevdragon/vidfarm-devcli",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "Developer CLI for running the Vidfarm local template platform.",
   "type": "module",
   "bin": {