blitzreels 0.1.7 → 0.1.9

package/dist/commands/media-assets.js

@@ -1,10 +1,20 @@
+import { CliUsageError } from "../cli-errors.js";
 import { commandSpec } from "../command-metadata.js";
 import { requireDeleteConfirmation, } from "../preview-first-edit.js";
+import { assertBulkDeleteSucceeded, requireExactlyOneDeleteSelector, } from "./bulk-delete-runtime.js";
 export const MEDIA_ASSET_COMMAND_SPECS = [
     commandSpec({
         command: ["media", "list"],
-        usage: "blitzreels media list [--folder-id ID] [--asset-type video|audio|image|document] [--search QUERY] [--limit 100] [--offset 0] [--json]",
-        flags: ["folder-id", "asset-type", "search", "limit", "offset"],
+        usage: "blitzreels media list [--folder-id ID] [--asset-type video|audio|image|document] [--search QUERY] [--min-duration 1] [--orientation landscape|portrait|square] [--limit 100] [--offset 0] [--json]",
+        flags: [
+            "folder-id",
+            "asset-type",
+            "search",
+            "min-duration",
+            "orientation",
+            "limit",
+            "offset",
+        ],
     }),
     commandSpec({
         command: ["media", "get"],
@@ -13,8 +23,18 @@ export const MEDIA_ASSET_COMMAND_SPECS = [
     }),
     commandSpec({
         command: ["media", "delete"],
-        usage: "blitzreels media delete --asset-id ID --confirm-delete",
-        flags: ["asset-id", "confirm-delete"],
+        usage: "blitzreels media delete (--asset-id ID|--asset-ids ID1,ID2|--search QUERY|--name-prefix PREFIX) --confirm-delete --reason TEXT --idempotency-key KEY [--delete-generated-clips true] [--delete-linked-projects true]",
+        flags: [
+            "asset-id",
+            "asset-ids",
+            "search",
+            "name-prefix",
+            "confirm-delete",
+            "reason",
+            "idempotency-key",
+            "delete-generated-clips",
+            "delete-linked-projects",
+        ],
     }),
     commandSpec({
         command: ["media", "upload"],
@@ -83,11 +103,24 @@ export const MEDIA_ASSET_COMMAND_SPECS = [
     }),
     commandSpec({
         command: ["media", "shorts", "generate"],
-        usage: "blitzreels media shorts generate --asset-id ID [--content-profile auto|podcast|tutorial|generic] [--auto-trim-silence true]",
-        flags: ["asset-id", "content-profile", "auto-trim-silence"],
+        usage: "blitzreels media shorts generate --asset-id ID --idempotency-key KEY [--content-profile auto|podcast|tutorial|generic] [--auto-trim-silence true]",
+        flags: [
+            "asset-id",
+            "idempotency-key",
+            "content-profile",
+            "auto-trim-silence",
+        ],
         description: "Start short suggestion generation for a media asset.",
         dryRunSupported: false,
     }),
+    commandSpec({
+        command: ["media", "shorts", "refresh-thumbnail"],
+        usage: "blitzreels media shorts refresh-thumbnail --asset-id ID --suggestion-id ID --idempotency-key KEY [--dry-run] [--json]",
+        flags: ["asset-id", "suggestion-id", "idempotency-key"],
+        description: "Queue thumbnail regeneration for one short suggestion.",
+        mutates: true,
+        dryRunSupported: true,
+    }),
     commandSpec({
         command: ["media", "shorts", "apply"],
         usage: "blitzreels media shorts apply --asset-id ID --suggestion-id ID --project-id ID [--caption-style-id ID|null] [--mark-saved true] [--automatic-layout-json JSON]",
@@ -102,6 +135,59 @@ export const MEDIA_ASSET_COMMAND_SPECS = [
         description: "Apply a short suggestion to a project timeline.",
         dryRunSupported: false,
     }),
+    commandSpec({
+        command: ["media", "reframe", "status"],
+        usage: "blitzreels media reframe status --asset-id ID [--json]",
+        flags: ["asset-id"],
+        description: "Inspect automatic layout analysis for a media asset.",
+    }),
+    commandSpec({
+        command: ["media", "reframe", "analyze"],
+        usage: "blitzreels media reframe analyze --asset-id ID --idempotency-key KEY [--json]",
+        flags: ["asset-id", "idempotency-key"],
+        description: "Queue or reuse automatic layout analysis for a media asset.",
+        mutates: true,
+        dryRunSupported: false,
+    }),
+    commandSpec({
+        command: ["media", "reframe", "apply"],
+        usage: "blitzreels media reframe apply --asset-id ID --project-id ID --idempotency-key KEY [--replace-timeline-item-id ID|null] [--trim-start 0 --trim-end 60] [--aspect-ratio 9:16|null] [--content-type-hint auto|podcast|tutorial|generic] [--layout-strategy auto|demo|letterbox|split|focus|speaker_grid|webinar|webinar_stack|gameplay] [--dry-run] [--json]",
+        flags: [
+            "asset-id",
+            "project-id",
+            { name: "trim-start", type: "number" },
+            { name: "trim-end", type: "number" },
+            "idempotency-key",
+            "replace-timeline-item-id",
+            {
+                name: "aspect-ratio",
+                enum: ["9:16", "16:9", "1:1", "4:5", "null"],
+            },
+            {
+                name: "content-type-hint",
+                enum: ["auto", "podcast", "tutorial", "generic"],
+                default: "auto",
+            },
+            {
+                name: "layout-strategy",
+                enum: [
+                    "auto",
+                    "demo",
+                    "letterbox",
+                    "split",
+                    "focus",
+                    "speaker_grid",
+                    "webinar",
+                    "webinar_stack",
+                    "gameplay",
+                ],
+                default: "auto",
+            },
+        ],
+        description: "Apply the managed automatic layout plan to a project.",
+        mutates: true,
+        dryRunSupported: true,
+    }),
     commandSpec({
         command: ["media", "folders", "list"],
         usage: "blitzreels media folders list [--parent-folder-id ID] [--json]",
@@ -133,6 +219,14 @@ export const MEDIA_ASSET_COMMAND_SPECS = [
         usage: "blitzreels media folders delete --folder-id ID --confirm-delete [--cascade true]",
         flags: ["folder-id", "confirm-delete", "cascade"],
     }),
+    commandSpec({
+        command: ["media", "folders", "empty"],
+        usage: "blitzreels media folders empty --folder-id ID --confirm-delete --reason TEXT --idempotency-key KEY [--dry-run] [--json]",
+        flags: ["folder-id", "confirm-delete", "reason", "idempotency-key"],
+        description: "Delete media inside a folder while retaining the folder.",
+        mutates: true,
+        dryRunSupported: true,
+    }),
 ];
 export function createMediaAssetCommandOperation({ helpers, }) {
     return {
@@ -155,6 +249,13 @@ async function handleMediaAssetCommand({ context, helpers, }) {
                 value: helpers.getStringFlag({ flags, name: "asset-type" }),
             }),
             search: helpers.getStringFlag({ flags, name: "search" }),
+            minDurationSeconds: helpers.getNumberFlag({
+                flags,
+                name: "min-duration",
+            }),
+            orientation: parseMediaOrientation({
+                value: helpers.getStringFlag({ flags, name: "orientation" }),
+            }),
             limit: helpers.getNumberFlag({ flags, name: "limit" }),
             offset: helpers.getNumberFlag({ flags, name: "offset" }),
         });
@@ -201,15 +302,61 @@ async function handleMediaAssetCommand({ context, helpers, }) {
         requireDeleteConfirmation({
             confirmed: helpers.getBooleanFlag({ flags, name: "confirm-delete" }),
         });
-        const result = await context.client.media.delete({
-            assetId: helpers.requireStringFlag({ flags, name: "asset-id" }),
-        });
-        helpers.printResult({
-            json: context.json,
-            value: result,
-            human: ["Media asset deleted."],
+        const assetIdsFlag = helpers.getStringFlag({ flags, name: "asset-ids" });
+        const search = helpers.getStringFlag({ flags, name: "search" });
+        const namePrefix = helpers.getStringFlag({ flags, name: "name-prefix" });
+        requireExactlyOneDeleteSelector({
+            selectors: [
+                helpers.getStringFlag({ flags, name: "asset-id" }),
+                assetIdsFlag,
+                search,
+                namePrefix,
+            ],
         });
-        return true;
+        {
+            const singleAssetId = helpers.getStringFlag({
+                flags,
+                name: "asset-id",
+            });
+            const result = await context.client.media.deleteMany({
+                ids: singleAssetId === undefined
+                    ? parseCommaSeparatedAssetIds({ value: assetIdsFlag })
+                    : [singleAssetId],
+                search: search ?? null,
+                namePrefix: namePrefix ?? null,
+                confirmDelete: true,
+                dryRun: false,
+                reason: helpers.requireStringFlag({ flags, name: "reason" }),
+                idempotencyKey: helpers.requireStringFlag({
+                    flags,
+                    name: "idempotency-key",
+                }),
+                deleteGeneratedClips: helpers.getBooleanFlag({
+                    flags,
+                    name: "delete-generated-clips",
+                }),
+                deleteLinkedProjects: helpers.getBooleanFlag({
+                    flags,
+                    name: "delete-linked-projects",
+                }),
+            });
+            helpers.printResult({
+                json: context.json,
+                value: result,
+                human: [
+                    `Deleted ${result.deleted_count}/${result.selected_count} media assets.`,
+                    ...(result.failed_count > 0
+                        ? [`Failed: ${result.failed_count}.`]
+                        : []),
+                ],
+            });
+            assertBulkDeleteSucceeded({
+                failedCount: result.failed_count,
+                failedItems: result.failed_items,
+                resourceLabel: "media assets",
+            });
+            return true;
+        }
     }
     if (action === "upload") {
         const result = await helpers.uploadMediaFile({ context });
@@ -218,6 +365,8 @@ async function handleMediaAssetCommand({ context, helpers, }) {
             value: result,
             human: [
                 `Media uploaded: ${result.id} ${result.name} (${result.asset_type}, ${result.processing_status})`,
+                `Processing run: ${result.processing_run_id ?? "none"}`,
+                `Follow-ups: transcription=${result.follow_up.transcription_requested ? "yes" : "no"}, description=${result.follow_up.description_requested ? "yes" : "no"}, short suggestions=${result.follow_up.short_suggestions_requested ? "yes" : "no"}`,
             ],
         });
         return true;
@@ -316,6 +465,11 @@ async function handleMediaAssetCommand({ context, helpers, }) {
                 ...(result.asset.processingError
                     ? [`Processing error: ${result.asset.processingError}`]
                     : []),
+                ...(result.short_suggestions_outcome?.no_clip_reason
+                    ? [
+                        `Short suggestions: ${String(result.short_suggestions_outcome.no_clip_reason)}`,
+                    ]
+                    : []),
             ],
         });
         return true;
@@ -323,11 +477,149 @@ async function handleMediaAssetCommand({ context, helpers, }) {
     if (action === "shorts") {
         return handleMediaShortsCommand({ context, helpers, subaction });
     }
+    if (action === "reframe" && subaction === "status") {
+        const result = await context.client.media.reframe.status({
+            assetId: helpers.requireStringFlag({ flags, name: "asset-id" }),
+        });
+        helpers.printResult({
+            json: context.json,
+            value: result,
+            human: [
+                `Reframe analysis: ${result.status}${result.analysis_version === null ? "" : ` v${result.analysis_version}`}.`,
+            ],
+        });
+        return true;
+    }
+    if (action === "reframe" && subaction === "analyze") {
+        const result = await context.client.media.reframe.analyze({
+            assetId: helpers.requireStringFlag({ flags, name: "asset-id" }),
+            idempotencyKey: helpers.requireStringFlag({
+                flags,
+                name: "idempotency-key",
+            }),
+        });
+        helpers.printResult({
+            json: context.json,
+            value: result,
+            human: [
+                `Reframe analysis: ${result.status}${result.triggered ? " queued" : " reused"}.`,
+            ],
+        });
+        return true;
+    }
+    if (action === "reframe" && subaction === "apply") {
+        const result = await context.client.media.reframe.apply({
+            assetId: helpers.requireStringFlag({ flags, name: "asset-id" }),
+            projectId: helpers.requireStringFlag({ flags, name: "project-id" }),
+            replaceTimelineItemId: helpers.parseNullableStringFlag({
+                flags,
+                name: "replace-timeline-item-id",
+            }) ?? null,
+            aspectRatio: parseReframeAspectRatio({
+                value: helpers.parseNullableStringFlag({
+                    flags,
+                    name: "aspect-ratio",
+                }),
+            }),
+            trimStartSeconds: helpers.getNumberFlag({ flags, name: "trim-start" }) ?? null,
+            trimEndSeconds: helpers.getNumberFlag({ flags, name: "trim-end" }) ?? null,
+            contentTypeHint: parseReframeContentTypeHint({
+                value: helpers.getStringFlag({ flags, name: "content-type-hint" }),
+            }),
+            layoutStrategy: parseReframeLayoutStrategy({
+                value: helpers.getStringFlag({ flags, name: "layout-strategy" }),
+            }),
+            idempotencyKey: helpers.requireStringFlag({
+                flags,
+                name: "idempotency-key",
+            }),
+        });
+        helpers.printResult({
+            json: context.json,
+            value: result,
+            human: [
+                `Reframe applied: ${result.timeline_item_ids.length} timeline item(s) in ${result.project_id}.`,
+            ],
+        });
+        return true;
+    }
     if (action === "folders") {
         return handleMediaFoldersCommand({ context, helpers, subaction });
     }
     return false;
 }
+function parseMediaOrientation({ value, }) {
+    if (value === undefined)
+        return undefined;
+    if (value === "landscape" || value === "portrait" || value === "square") {
+        return value;
+    }
+    throw new CliUsageError({
+        code: "invalid_arguments",
+        message: "--orientation must be landscape, portrait, or square.",
+    });
+}
+function parseReframeContentTypeHint({ value, }) {
+    if (value === undefined ||
+        value === "auto" ||
+        value === "podcast" ||
+        value === "tutorial" ||
+        value === "generic") {
+        return value ?? "auto";
+    }
+    throw new CliUsageError({
+        code: "invalid_arguments",
+        message: "--content-type-hint must be auto, podcast, tutorial, or generic.",
+    });
+}
+function parseReframeLayoutStrategy({ value, }) {
+    const resolved = value ?? "auto";
+    if (resolved === "auto" ||
+        resolved === "demo" ||
+        resolved === "letterbox" ||
+        resolved === "split" ||
+        resolved === "focus" ||
+        resolved === "speaker_grid" ||
+        resolved === "webinar" ||
+        resolved === "webinar_stack" ||
+        resolved === "gameplay") {
+        return resolved;
+    }
+    throw new CliUsageError({
+        code: "invalid_arguments",
+        message: "Unsupported --layout-strategy value.",
+    });
+}
+function parseReframeAspectRatio({ value, }) {
+    if (value === null || value === undefined) {
+        return null;
+    }
+    if (value === "9:16" ||
+        value === "16:9" ||
+        value === "1:1" ||
+        value === "4:5") {
+        return value;
+    }
+    throw new CliUsageError({
+        code: "invalid_arguments",
+        message: "--aspect-ratio must be 9:16, 16:9, 1:1, 4:5, or null.",
+    });
+}
+function parseCommaSeparatedAssetIds({ value, }) {
+    if (value === undefined)
+        return [];
+    const ids = value
+        .split(",")
+        .map((id) => id.trim())
+        .filter(Boolean);
+    if (ids.length === 0) {
+        throw new CliUsageError({
+            code: "invalid_arguments",
+            message: "--asset-ids must contain at least one ID.",
+        });
+    }
+    return Array.from(new Set(ids));
+}
 async function handleMediaShortsCommand({ context, helpers, subaction, }) {
     const flags = context.args.flags;
     if (subaction === "list") {
@@ -362,6 +654,10 @@ async function handleMediaShortsCommand({ context, helpers, subaction, }) {
                 flags,
                 name: "auto-trim-silence",
             }),
+            idempotencyKey: helpers.requireStringFlag({
+                flags,
+                name: "idempotency-key",
+            }),
         });
         helpers.printResult({
             json: context.json,
@@ -370,6 +666,25 @@ async function handleMediaShortsCommand({ context, helpers, subaction, }) {
         });
         return true;
     }
+    if (subaction === "refresh-thumbnail") {
+        const result = await context.client.media.shorts.refreshThumbnail({
+            assetId: helpers.requireStringFlag({ flags, name: "asset-id" }),
+            suggestionId: helpers.requireStringFlag({
+                flags,
+                name: "suggestion-id",
+            }),
+            idempotencyKey: helpers.requireStringFlag({
+                flags,
+                name: "idempotency-key",
+            }),
+        });
+        helpers.printResult({
+            json: context.json,
+            value: result,
+            human: [`Thumbnail regeneration queued: ${result.run_id}`],
+        });
+        return true;
+    }
     if (subaction === "apply") {
         const result = await context.client.media.shorts.apply({
             assetId: helpers.requireStringFlag({ flags, name: "asset-id" }),
@@ -497,6 +812,34 @@ async function handleMediaFoldersCommand({ context, helpers, subaction, }) {
         });
         return true;
     }
+    if (subaction === "empty") {
+        requireDeleteConfirmation({
+            confirmed: helpers.getBooleanFlag({ flags, name: "confirm-delete" }),
+        });
+        const result = await context.client.media.folders.empty({
+            folderId: helpers.requireStringFlag({ flags, name: "folder-id" }),
+            confirmDelete: true,
+            dryRun: false,
+            reason: helpers.requireStringFlag({ flags, name: "reason" }),
+            idempotencyKey: helpers.requireStringFlag({
+                flags,
+                name: "idempotency-key",
+            }),
+        });
+        helpers.printResult({
+            json: context.json,
+            value: result,
+            human: [
+                `Deleted ${result.deleted_count}/${result.selected_count} media assets; folder retained.`,
+            ],
+        });
+        assertBulkDeleteSucceeded({
+            failedCount: result.failed_count,
+            failedItems: result.failed_items,
+            resourceLabel: "media assets",
+        });
+        return true;
+    }
     return false;
 }
 function buildMediaAssetDryRun({ context, spec, helpers, }) {
@@ -509,12 +852,46 @@ function buildMediaAssetDryRun({ context, spec, helpers, }) {
         requireDeleteConfirmation({
             confirmed: helpers.getBooleanFlag({ flags, name: "confirm-delete" }),
         });
-        return helpers.dryRunRequest({
-            spec,
-            method: "POST",
-            path: `/workspace/media/assets/${encodeURIComponent(helpers.requireStringFlag({ flags, name: "asset-id" }))}/delete`,
-            body: {},
+        const assetIdsFlag = helpers.getStringFlag({ flags, name: "asset-ids" });
+        const search = helpers.getStringFlag({ flags, name: "search" });
+        const namePrefix = helpers.getStringFlag({ flags, name: "name-prefix" });
+        requireExactlyOneDeleteSelector({
+            selectors: [
+                helpers.getStringFlag({ flags, name: "asset-id" }),
+                assetIdsFlag,
+                search,
+                namePrefix,
+            ],
         });
+        {
+            const singleAssetId = helpers.getStringFlag({
+                flags,
+                name: "asset-id",
+            });
+            return helpers.dryRunRequest({
+                spec,
+                method: "POST",
+                path: "/workspace/media/assets/batch-delete",
+                body: {
+                    ids: singleAssetId === undefined
+                        ? parseCommaSeparatedAssetIds({ value: assetIdsFlag })
+                        : [singleAssetId],
+                    search: search ?? null,
+                    name_prefix: namePrefix ?? null,
+                    confirm_delete: false,
+                    dry_run: true,
+                    reason: helpers.requireStringFlag({ flags, name: "reason" }),
+                    delete_generated_clips: helpers.getBooleanFlag({
+                        flags,
+                        name: "delete-generated-clips",
+                    }),
+                    delete_linked_projects: helpers.getBooleanFlag({
+                        flags,
+                        name: "delete-linked-projects",
+                    }),
+                },
+            });
+        }
     }
     if (action === "update" || action === "rename") {
         return helpers.dryRunRequest({
@@ -570,6 +947,60 @@ function buildMediaAssetDryRun({ context, spec, helpers, }) {
             },
         });
     }
+    if (action === "shorts" && subaction === "refresh-thumbnail") {
+        const assetId = helpers.requireStringFlag({ flags, name: "asset-id" });
+        const suggestionId = helpers.requireStringFlag({
+            flags,
+            name: "suggestion-id",
+        });
+        return helpers.dryRunRequest({
+            spec,
+            method: "POST",
+            path: `/workspace/media/assets/${encodeURIComponent(assetId)}/short-suggestions/${encodeURIComponent(suggestionId)}/thumbnail`,
+            headers: {
+                "Idempotency-Key": helpers.requireStringFlag({
+                    flags,
+                    name: "idempotency-key",
+                }),
+            },
+            body: {},
+        });
+    }
+    if (action === "reframe" && subaction === "apply") {
+        const assetId = helpers.requireStringFlag({ flags, name: "asset-id" });
+        return helpers.dryRunRequest({
+            spec,
+            method: "POST",
+            path: `/workspace/media/assets/${encodeURIComponent(assetId)}/reframe-plan/apply`,
+            headers: {
+                "Idempotency-Key": helpers.requireStringFlag({
+                    flags,
+                    name: "idempotency-key",
+                }),
+            },
+            body: {
+                project_id: helpers.requireStringFlag({ flags, name: "project-id" }),
+                replace_timeline_item_id: helpers.parseNullableStringFlag({
+                    flags,
+                    name: "replace-timeline-item-id",
+                }) ?? null,
+                aspect_ratio: parseReframeAspectRatio({
+                    value: helpers.parseNullableStringFlag({
+                        flags,
+                        name: "aspect-ratio",
+                    }),
+                }),
+                trim_start_seconds: helpers.getNumberFlag({ flags, name: "trim-start" }) ?? null,
+                trim_end_seconds: helpers.getNumberFlag({ flags, name: "trim-end" }) ?? null,
+                content_type_hint: parseReframeContentTypeHint({
+                    value: helpers.getStringFlag({ flags, name: "content-type-hint" }),
+                }),
+                layout_strategy: parseReframeLayoutStrategy({
+                    value: helpers.getStringFlag({ flags, name: "layout-strategy" }),
+                }),
+            },
+        });
+    }
     if (action === "folders" &&
         (subaction === "rename" || subaction === "update")) {
         const folderId = helpers.requireStringFlag({ flags, name: "folder-id" });
@@ -608,6 +1039,28 @@ function buildMediaAssetDryRun({ context, spec, helpers, }) {
             body: undefined,
         });
     }
+    if (action === "folders" && subaction === "empty") {
+        requireDeleteConfirmation({
+            confirmed: helpers.getBooleanFlag({ flags, name: "confirm-delete" }),
+        });
+        const folderId = helpers.requireStringFlag({ flags, name: "folder-id" });
+        return helpers.dryRunRequest({
+            spec,
+            method: "POST",
+            path: `/workspace/media/folders/${encodeURIComponent(folderId)}/empty`,
+            headers: {
+                "Idempotency-Key": helpers.requireStringFlag({
+                    flags,
+                    name: "idempotency-key",
+                }),
+            },
+            body: {
+                confirm_delete: false,
+                dry_run: true,
+                reason: helpers.requireStringFlag({ flags, name: "reason" }),
+            },
+        });
+    }
     return undefined;
 }
 function matchesMediaAssetCommand({ command }) {
@@ -619,14 +1072,21 @@ function matchesMediaAssetCommand({ command }) {
         return false;
     }
     if (action === "shorts") {
-        return (subaction === "list" || subaction === "generate" || subaction === "apply");
+        return (subaction === "list" ||
+            subaction === "generate" ||
+            subaction === "apply" ||
+            subaction === "refresh-thumbnail");
+    }
+    if (action === "reframe") {
+        return (subaction === "status" || subaction === "analyze" || subaction === "apply");
     }
     if (action === "folders") {
         return (subaction === "list" ||
             subaction === "create" ||
             subaction === "rename" ||
             subaction === "update" ||
-            subaction === "delete");
+            subaction === "delete" ||
+            subaction === "empty");
     }
     return [
         "list",