blitzreels 0.1.4 → 0.1.6

package/dist/commands/media-assets.js

@@ -0,0 +1,644 @@
+import { commandSpec } from "../command-metadata.js";
+import { requireDeleteConfirmation, } from "../preview-first-edit.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"],
+    }),
+    commandSpec({
+        command: ["media", "get"],
+        usage: "blitzreels media get --asset-id ID [--json]",
+        flags: ["asset-id"],
+    }),
+    commandSpec({
+        command: ["media", "delete"],
+        usage: "blitzreels media delete --asset-id ID --confirm-delete",
+        flags: ["asset-id", "confirm-delete"],
+    }),
+    commandSpec({
+        command: ["media", "upload"],
+        usage: "blitzreels media upload --file ./video.mp4 [--name NAME] [--content-type video/mp4] [--auto-process true] [--auto-transcribe true] [--auto-describe true] [--auto-suggest-shorts true]",
+        flags: [
+            "file",
+            "name",
+            "content-type",
+            "auto-process",
+            "auto-transcribe",
+            "auto-describe",
+            "auto-suggest-shorts",
+        ],
+    }),
+    commandSpec({
+        command: ["media", "import-youtube"],
+        usage: "blitzreels media import-youtube --url URL [--folder-id ID|root] [--quality 1080p] [--fps 30] [--audio-language fr|null]",
+        flags: ["url", "folder-id", "quality", "fps", "audio-language"],
+    }),
+    commandSpec({
+        command: ["media", "import-google-drive"],
+        usage: "blitzreels media import-google-drive --url URL [--folder-id ID|root] [--content-profile auto|podcast] [--auto-trim-silence]",
+        flags: [
+            "url",
+            "folder-id",
+            {
+                name: "content-profile",
+                enum: ["auto", "podcast"],
+                description: "short suggestion content profile",
+            },
+            {
+                name: "auto-trim-silence",
+                type: "boolean",
+                description: "auto trim silence before suggesting shorts",
+            },
+        ],
+        description: "Import a shared Google Drive video into workspace media library.",
+        dryRunSupported: false,
+    }),
+    commandSpec({
+        command: ["media", "rename"],
+        usage: "blitzreels media rename --asset-id ID --name NAME",
+        flags: ["asset-id", "name"],
+    }),
+    commandSpec({
+        command: ["media", "update"],
+        usage: "blitzreels media update --asset-id ID [--name NAME] [--description TEXT|null] [--folder-id ID|root] [--allow-broll true]",
+        flags: ["asset-id", "name", "description", "folder-id", "allow-broll"],
+    }),
+    commandSpec({
+        command: ["media", "move"],
+        usage: "blitzreels media move --asset-id ID|--asset-ids ID1,ID2 --target-folder-id ID|root",
+        flags: ["asset-id", "asset-ids", "target-folder-id"],
+    }),
+    commandSpec({
+        command: ["media", "wait"],
+        usage: "blitzreels media wait --asset-id ID [--for processing|processed|transcription|description|shorts|all] [--project-id ID] [--interval-ms 3000] [--timeout-ms 600000] [--json]",
+        flags: ["asset-id", "for", "project-id", "interval-ms", "timeout-ms"],
+        description: "Poll a media asset until background processing or description metadata is ready.",
+    }),
+    commandSpec({
+        command: ["media", "shorts", "list"],
+        usage: "blitzreels media shorts list --asset-id ID [--limit 20] [--offset 0] [--json]",
+        flags: ["asset-id", "limit", "offset"],
+        description: "List saved and draft short suggestions for a media asset.",
+    }),
+    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"],
+        description: "Start short suggestion generation for a media asset.",
+        dryRunSupported: false,
+    }),
+    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]",
+        flags: [
+            "asset-id",
+            "suggestion-id",
+            "project-id",
+            "caption-style-id",
+            "mark-saved",
+            "automatic-layout-json",
+        ],
+        description: "Apply a short suggestion to a project timeline.",
+        dryRunSupported: false,
+    }),
+    commandSpec({
+        command: ["media", "folders", "list"],
+        usage: "blitzreels media folders list [--parent-folder-id ID] [--json]",
+        flags: ["parent-folder-id"],
+    }),
+    commandSpec({
+        command: ["media", "folders", "create"],
+        usage: "blitzreels media folders create --name NAME [--parent-folder-id ID] [--description TEXT|null] [--icon-type video]",
+        flags: ["name", "parent-folder-id", "description", "icon-type"],
+    }),
+    commandSpec({
+        command: ["media", "folders", "rename"],
+        usage: "blitzreels media folders rename --folder-id ID --name NAME",
+        flags: ["folder-id", "name"],
+    }),
+    commandSpec({
+        command: ["media", "folders", "update"],
+        usage: "blitzreels media folders update --folder-id ID [--name NAME] [--parent-folder-id ID|root] [--description TEXT|null] [--icon-type video]",
+        flags: [
+            "folder-id",
+            "name",
+            "parent-folder-id",
+            "description",
+            "icon-type",
+        ],
+    }),
+    commandSpec({
+        command: ["media", "folders", "delete"],
+        usage: "blitzreels media folders delete --folder-id ID --confirm-delete [--cascade true]",
+        flags: ["folder-id", "confirm-delete", "cascade"],
+    }),
+];
+export function createMediaAssetCommandOperation({ helpers, }) {
+    return {
+        name: "media-assets",
+        matches: ({ command }) => matchesMediaAssetCommand({ command }),
+        handle: ({ context }) => handleMediaAssetCommand({ context, helpers }),
+        buildDryRun: ({ context, spec }) => buildMediaAssetDryRun({ context, spec, helpers }),
+    };
+}
+async function handleMediaAssetCommand({ context, helpers, }) {
+    const [group, action, subaction] = context.args.command;
+    const flags = context.args.flags;
+    if (group !== "media") {
+        return false;
+    }
+    if (action === "list") {
+        const result = await context.client.media.list({
+            folderId: helpers.getStringFlag({ flags, name: "folder-id" }),
+            assetType: helpers.parseAssetType({
+                value: helpers.getStringFlag({ flags, name: "asset-type" }),
+            }),
+            search: helpers.getStringFlag({ flags, name: "search" }),
+            limit: helpers.getNumberFlag({ flags, name: "limit" }),
+            offset: helpers.getNumberFlag({ flags, name: "offset" }),
+        });
+        helpers.printResult({
+            json: context.json,
+            value: result,
+            human: result.assets.map((asset) => `${asset.id} ${asset.assetType} ${asset.name ?? ""} ${asset.durationSeconds ?? "-"}s`),
+        });
+        return true;
+    }
+    if (action === "get") {
+        const result = await context.client.media.get({
+            assetId: helpers.requireStringFlag({ flags, name: "asset-id" }),
+        });
+        helpers.printResult({
+            json: context.json,
+            value: result,
+            fields: readEffectiveFields({
+                fields: context.fields,
+                flags,
+                getStringFlag: helpers.getStringFlag,
+            }),
+            human: [
+                `${result.asset.id} ${result.asset.assetType} ${result.asset.name}`,
+                `Processing: ${result.asset.processingStatus ?? "unknown"}${result.asset.processingSubstage ? `/${result.asset.processingSubstage}` : ""}`,
+                ...(result.asset.processingError
+                    ? [`Processing error: ${result.asset.processingError}`]
+                    : []),
+                `Retryable: ${result.asset.retryable ? "yes" : "no"}`,
+                ...(result.asset.providerRequestIds.processJobRunId
+                    ? [`Process job: ${result.asset.providerRequestIds.processJobRunId}`]
+                    : []),
+                ...(result.asset.providerRequestIds.transcribeJobRunId
+                    ? [
+                        `Transcribe job: ${result.asset.providerRequestIds.transcribeJobRunId}`,
+                    ]
+                    : []),
+                `URL: ${result.asset.fileUrl ?? ""}`,
+            ],
+        });
+        return true;
+    }
+    if (action === "delete") {
+        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."],
+        });
+        return true;
+    }
+    if (action === "upload") {
+        const result = await helpers.uploadMediaFile({ context });
+        helpers.printResult({
+            json: context.json,
+            value: result,
+            human: [
+                `Media uploaded: ${result.id} ${result.name} (${result.asset_type}, ${result.processing_status})`,
+            ],
+        });
+        return true;
+    }
+    if (action === "import-youtube") {
+        const result = await context.client.media.importYoutube({
+            url: helpers.requireStringFlag({ flags, name: "url" }),
+            folderId: helpers.parseFolderIdFlag({ flags, name: "folder-id" }),
+            quality: helpers.parseYoutubeQuality({
+                value: helpers.getStringFlag({ flags, name: "quality" }),
+            }),
+            fps: helpers.getNumberFlag({ flags, name: "fps" }),
+            audioLanguage: helpers.parseNullableStringFlag({
+                flags,
+                name: "audio-language",
+            }),
+        });
+        helpers.printResult({
+            json: context.json,
+            value: result,
+            human: [`YouTube import queued: ${result.asset_id} ${result.status}`],
+        });
+        return true;
+    }
+    if (action === "import-google-drive") {
+        const result = await context.client.media.importGoogleDrive({
+            url: helpers.requireStringFlag({ flags, name: "url" }),
+            folderId: helpers.parseFolderIdFlag({ flags, name: "folder-id" }),
+            shortSuggestionContentProfile: parseGoogleDriveImportContentProfile({
+                value: helpers.getStringFlag({ flags, name: "content-profile" }),
+            }),
+            autoTrimSilence: helpers.getOptionalBooleanFlag({
+                flags,
+                name: "auto-trim-silence",
+            }),
+        });
+        helpers.printResult({
+            json: context.json,
+            value: result,
+            human: [
+                `Google Drive import queued: ${result.asset_id} ${result.status}`,
+            ],
+        });
+        return true;
+    }
+    if (action === "update" || action === "rename") {
+        const result = await context.client.media.update({
+            assetId: helpers.requireStringFlag({ flags, name: "asset-id" }),
+            name: action === "rename"
+                ? helpers.requireStringFlag({ flags, name: "name" })
+                : helpers.getStringFlag({ flags, name: "name" }),
+            description: action === "rename"
+                ? undefined
+                : helpers.parseNullableStringFlag({ flags, name: "description" }),
+            folderId: action === "rename"
+                ? undefined
+                : helpers.parseFolderIdFlag({ flags, name: "folder-id" }),
+            allowUsingAsBroll: action === "rename"
+                ? undefined
+                : helpers.getOptionalBooleanFlag({ flags, name: "allow-broll" }),
+        });
+        helpers.printResult({
+            json: context.json,
+            value: result,
+            human: [
+                action === "rename"
+                    ? `Media renamed: ${result.asset.id} ${result.asset.name}`
+                    : `Media updated: ${result.asset.id} ${result.asset.name}`,
+            ],
+        });
+        return true;
+    }
+    if (action === "move") {
+        const result = await context.client.media.move({
+            assetIds: helpers.parseAssetIds({ flags }),
+            targetFolderId: helpers.requireFolderIdFlag({
+                flags,
+                name: "target-folder-id",
+            }),
+        });
+        helpers.printResult({
+            json: context.json,
+            value: result,
+            human: [`Moved ${result.moved_count} media asset(s).`],
+        });
+        return true;
+    }
+    if (action === "wait") {
+        const result = await helpers.waitForMediaAsset({ context });
+        helpers.printResult({
+            json: context.json,
+            value: result,
+            human: [
+                `Media ready: ${result.asset.id} ${result.asset.name} (${result.ready_for.join(", ")})`,
+                `Processing: ${result.asset.processingStatus ?? "unknown"}${result.asset.processingSubstage ? `/${result.asset.processingSubstage}` : ""}`,
+                ...(result.asset.processingError
+                    ? [`Processing error: ${result.asset.processingError}`]
+                    : []),
+            ],
+        });
+        return true;
+    }
+    if (action === "shorts") {
+        return handleMediaShortsCommand({ context, helpers, subaction });
+    }
+    if (action === "folders") {
+        return handleMediaFoldersCommand({ context, helpers, subaction });
+    }
+    return false;
+}
+async function handleMediaShortsCommand({ context, helpers, subaction, }) {
+    const flags = context.args.flags;
+    if (subaction === "list") {
+        const result = await context.client.media.shorts.list({
+            assetId: helpers.requireStringFlag({ flags, name: "asset-id" }),
+            limit: helpers.getNumberFlag({ flags, name: "limit" }),
+            offset: helpers.getNumberFlag({ flags, name: "offset" }),
+        });
+        helpers.printResult({
+            json: context.json,
+            value: result,
+            fields: readEffectiveFields({
+                fields: context.fields,
+                flags,
+                getStringFlag: helpers.getStringFlag,
+            }),
+            human: [
+                `Saved: ${result.saved.length}`,
+                `Drafts: ${result.drafts.length}`,
+                ...[...result.saved, ...result.drafts].map((suggestion) => JSON.stringify(suggestion)),
+            ],
+        });
+        return true;
+    }
+    if (subaction === "generate") {
+        const result = await context.client.media.shorts.generate({
+            assetId: helpers.requireStringFlag({ flags, name: "asset-id" }),
+            contentProfile: helpers.parseShortContentProfile({
+                value: helpers.getStringFlag({ flags, name: "content-profile" }),
+            }),
+            autoTrimSilence: helpers.getOptionalBooleanFlag({
+                flags,
+                name: "auto-trim-silence",
+            }),
+        });
+        helpers.printResult({
+            json: context.json,
+            value: result,
+            human: [`Short suggestion generation queued: ${result.run_id}`],
+        });
+        return true;
+    }
+    if (subaction === "apply") {
+        const result = await context.client.media.shorts.apply({
+            assetId: helpers.requireStringFlag({ flags, name: "asset-id" }),
+            suggestionId: helpers.requireStringFlag({ flags, name: "suggestion-id" }),
+            projectId: helpers.requireStringFlag({ flags, name: "project-id" }),
+            captionStyleId: helpers.parseNullableStringFlag({
+                flags,
+                name: "caption-style-id",
+            }),
+            markSaved: helpers.getOptionalBooleanFlag({ flags, name: "mark-saved" }),
+            allowUnverifiedExport: false,
+            automaticLayout: helpers.parseJsonObjectFlag({
+                flags,
+                name: "automatic-layout-json",
+            }),
+        });
+        helpers.printResult({
+            json: context.json,
+            value: result,
+            human: [
+                `Short applied: ${result.timeline_item_id} in project ${result.project_id}`,
+            ],
+        });
+        return true;
+    }
+    return false;
+}
+function readEffectiveFields({ fields, flags, getStringFlag, }) {
+    if (fields && fields.length > 0) {
+        return fields;
+    }
+    const value = getStringFlag({ flags, name: "fields" });
+    if (value === undefined) {
+        return undefined;
+    }
+    return value
+        .split(",")
+        .map((item) => item.trim())
+        .filter((item) => item.length > 0);
+}
+function parseGoogleDriveImportContentProfile({ value, }) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (value === "auto" || value === "podcast") {
+        return value;
+    }
+    throw new Error("--content-profile must be auto or podcast.");
+}
+async function handleMediaFoldersCommand({ context, helpers, subaction, }) {
+    const flags = context.args.flags;
+    if (subaction === "list") {
+        const result = await context.client.media.folders.list({
+            parentFolderId: helpers.getStringFlag({
+                flags,
+                name: "parent-folder-id",
+            }),
+        });
+        helpers.printResult({
+            json: context.json,
+            value: result,
+            human: result.folders.map((folder) => `${folder.id} ${folder.name} (${folder.assetCount ?? 0} assets)`),
+        });
+        return true;
+    }
+    if (subaction === "create") {
+        const result = await context.client.media.folders.create({
+            name: helpers.requireStringFlag({ flags, name: "name" }),
+            parentFolderId: helpers.parseFolderIdFlag({
+                flags,
+                name: "parent-folder-id",
+            }),
+            description: helpers.parseNullableStringFlag({
+                flags,
+                name: "description",
+            }),
+            iconType: helpers.getStringFlag({ flags, name: "icon-type" }),
+        });
+        helpers.printResult({
+            json: context.json,
+            value: result,
+            human: [`Folder created: ${result.folder.id} ${result.folder.name}`],
+        });
+        return true;
+    }
+    if (subaction === "rename" || subaction === "update") {
+        const result = await context.client.media.folders.update({
+            folderId: helpers.requireStringFlag({ flags, name: "folder-id" }),
+            name: subaction === "rename"
+                ? helpers.requireStringFlag({ flags, name: "name" })
+                : helpers.getStringFlag({ flags, name: "name" }),
+            parentFolderId: subaction === "rename"
+                ? undefined
+                : helpers.parseFolderIdFlag({ flags, name: "parent-folder-id" }),
+            description: subaction === "rename"
+                ? undefined
+                : helpers.parseNullableStringFlag({ flags, name: "description" }),
+            iconType: subaction === "rename"
+                ? undefined
+                : helpers.getStringFlag({ flags, name: "icon-type" }),
+        });
+        helpers.printResult({
+            json: context.json,
+            value: result,
+            human: [
+                subaction === "rename"
+                    ? `Folder renamed: ${result.folder.id} ${result.folder.name}`
+                    : `Folder updated: ${result.folder.id} ${result.folder.name}`,
+            ],
+        });
+        return true;
+    }
+    if (subaction === "delete") {
+        requireDeleteConfirmation({
+            confirmed: helpers.getBooleanFlag({ flags, name: "confirm-delete" }),
+        });
+        const result = await context.client.media.folders.delete({
+            folderId: helpers.requireStringFlag({ flags, name: "folder-id" }),
+            cascade: helpers.getOptionalBooleanFlag({ flags, name: "cascade" }),
+        });
+        helpers.printResult({
+            json: context.json,
+            value: result,
+            human: ["Folder deleted."],
+        });
+        return true;
+    }
+    return false;
+}
+function buildMediaAssetDryRun({ context, spec, helpers, }) {
+    const [group, action, subaction] = context.args.command;
+    if (group !== "media") {
+        return undefined;
+    }
+    const flags = context.args.flags;
+    if (action === "delete") {
+        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: {},
+        });
+    }
+    if (action === "update" || action === "rename") {
+        return helpers.dryRunRequest({
+            spec,
+            method: "PATCH",
+            path: `/workspace/media/assets/${encodeURIComponent(helpers.requireStringFlag({ flags, name: "asset-id" }))}`,
+            body: {
+                name: action === "rename"
+                    ? helpers.requireStringFlag({ flags, name: "name" })
+                    : helpers.getStringFlag({ flags, name: "name" }),
+                description: action === "rename"
+                    ? undefined
+                    : helpers.parseNullableStringFlag({ flags, name: "description" }),
+                folder_id: action === "rename"
+                    ? undefined
+                    : helpers.parseFolderIdFlag({ flags, name: "folder-id" }),
+                allow_using_as_broll: action === "rename"
+                    ? undefined
+                    : helpers.getOptionalBooleanFlag({ flags, name: "allow-broll" }),
+            },
+        });
+    }
+    if (action === "move") {
+        return helpers.dryRunRequest({
+            spec,
+            method: "POST",
+            path: "/workspace/media/assets/move",
+            body: {
+                asset_ids: helpers.parseAssetIds({ flags }),
+                target_folder_id: helpers.requireFolderIdFlag({
+                    flags,
+                    name: "target-folder-id",
+                }),
+            },
+        });
+    }
+    if (action === "folders" && subaction === "create") {
+        return helpers.dryRunRequest({
+            spec,
+            method: "POST",
+            path: "/workspace/media/folders",
+            body: {
+                name: helpers.requireStringFlag({ flags, name: "name" }),
+                parent_folder_id: helpers.parseFolderIdFlag({
+                    flags,
+                    name: "parent-folder-id",
+                }),
+                description: helpers.parseNullableStringFlag({
+                    flags,
+                    name: "description",
+                }),
+                icon_type: helpers.getStringFlag({ flags, name: "icon-type" }),
+            },
+        });
+    }
+    if (action === "folders" &&
+        (subaction === "rename" || subaction === "update")) {
+        const folderId = helpers.requireStringFlag({ flags, name: "folder-id" });
+        return helpers.dryRunRequest({
+            spec,
+            method: "PATCH",
+            path: `/workspace/media/folders/${encodeURIComponent(folderId)}`,
+            body: {
+                name: subaction === "rename"
+                    ? helpers.requireStringFlag({ flags, name: "name" })
+                    : helpers.getStringFlag({ flags, name: "name" }),
+                parent_folder_id: subaction === "rename"
+                    ? undefined
+                    : helpers.parseFolderIdFlag({ flags, name: "parent-folder-id" }),
+                description: subaction === "rename"
+                    ? undefined
+                    : helpers.parseNullableStringFlag({ flags, name: "description" }),
+                icon_type: subaction === "rename"
+                    ? undefined
+                    : helpers.getStringFlag({ flags, name: "icon-type" }),
+            },
+        });
+    }
+    if (action === "folders" && subaction === "delete") {
+        requireDeleteConfirmation({
+            confirmed: helpers.getBooleanFlag({ flags, name: "confirm-delete" }),
+        });
+        const folderId = helpers.requireStringFlag({ flags, name: "folder-id" });
+        return helpers.dryRunRequest({
+            spec,
+            method: "DELETE",
+            path: `/workspace/media/folders/${encodeURIComponent(folderId)}`,
+            query: {
+                cascade: helpers.getOptionalBooleanFlag({ flags, name: "cascade" }),
+            },
+            body: undefined,
+        });
+    }
+    return undefined;
+}
+function matchesMediaAssetCommand({ command }) {
+    const [group, action, subaction] = command;
+    if (group !== "media") {
+        return false;
+    }
+    if (action === "attach" || action === "overlay") {
+        return false;
+    }
+    if (action === "shorts") {
+        return (subaction === "list" || subaction === "generate" || subaction === "apply");
+    }
+    if (action === "folders") {
+        return (subaction === "list" ||
+            subaction === "create" ||
+            subaction === "rename" ||
+            subaction === "update" ||
+            subaction === "delete");
+    }
+    return [
+        "list",
+        "get",
+        "delete",
+        "upload",
+        "import-youtube",
+        "import-google-drive",
+        "rename",
+        "update",
+        "move",
+        "wait",
+    ].includes(action ?? "");
+}
+//# sourceMappingURL=media-assets.js.map