@mux/cli 0.5.0 → 0.7.0

package/lib/index.d.ts

@@ -1 +1,2 @@
 export { run } from '@oclif/command';
+export { default as CommandBase } from './command-bases/base';

package/lib/index.js

@@ -1,5 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.run = void 0;
+exports.CommandBase = exports.run = void 0;
 var command_1 = require("@oclif/command");
 Object.defineProperty(exports, "run", { enumerable: true, get: function () { return command_1.run; } });
+var base_1 = require("./command-bases/base");
+Object.defineProperty(exports, "CommandBase", { enumerable: true, get: function () { return base_1.default; } });

package/oclif.manifest.json

@@ -1 +1 @@
-{"version":"0.5.0","commands":{"init":{"id":"init","description":"set up a user-level config","pluginName":"@mux/cli","pluginType":"core","aliases":[],"flags":{},"args":[{"name":"envFile","description":"path to a Mux access token .env file","required":false}]},"sign":{"id":"sign","description":"Creates a new signed URL token for a playback ID","pluginName":"@mux/cli","pluginType":"core","aliases":[],"flags":{"expiresIn":{"name":"expiresIn","type":"option","char":"e","description":"How long the signature is valid for. If no unit is specified, milliseconds is assumed.","default":"7d"},"type":{"name":"type","type":"option","char":"t","description":"What type of token this signature is for.","options":["video","thumbnail","gif"],"default":"video"}},"args":[{"name":"playback-id","description":"Playback ID to create a signed URL token for.","required":true}]},"assets:create":{"id":"assets:create","description":"Create a new asset in Mux using a file that's already available online","pluginName":"@mux/cli","pluginType":"core","aliases":[],"flags":{"private":{"name":"private","type":"boolean","char":"p","description":"add a private playback policy to the created asset","allowNo":false}},"args":[{"name":"input","description":"input URL for the file you'd like to create this asset from","required":true}]},"assets:upload":{"id":"assets:upload","description":"Create a new asset in Mux via a local file","pluginName":"@mux/cli","pluginType":"core","aliases":[],"flags":{"private":{"name":"private","type":"boolean","char":"p","description":"add a private playback policy to the created asset","allowNo":false},"filter":{"name":"filter","type":"option","char":"f","description":"regex that filters the selected destination if the provided path is a folder"},"concurrent":{"name":"concurrent","type":"option","char":"c","description":"max number of files to upload at once","default":3}},"args":[{"name":"path","description":"local path for the file (or folder) you'd like to upload","required":true}]},"live:complete":{"id":"live:complete","description":"Signal to Mux that a live stream has concluded and should be closed.","pluginName":"@mux/cli","pluginType":"core","aliases":[],"flags":{"streamId":{"name":"streamId","type":"option","char":"t","description":"the type of the provided reference name","options":["stream-id"],"default":"stream-id"},"disableAfterCompletion":{"name":"disableAfterCompletion","type":"boolean","char":"d","description":"If set, disables the stream upon completion.","allowNo":false}},"args":[{"name":"streamName","description":"the name (coupled with --reference-type) to look up in Mux to yield this livestream","required":true}]},"live:disable":{"id":"live:disable","description":"Disables a live stream and prevents encoders from streaming to it.","pluginName":"@mux/cli","pluginType":"core","aliases":[],"flags":{"streamId":{"name":"streamId","type":"option","char":"t","description":"the type of the provided reference name","options":["stream-id"],"default":"stream-id"}},"args":[{"name":"streamName","description":"the name (coupled with --reference-type) to look up in Mux to yield this livestream","required":true}]},"live:enable":{"id":"live:enable","description":"Enables a live stream, allowing encoders to streaming to it.","pluginName":"@mux/cli","pluginType":"core","aliases":[],"flags":{"streamId":{"name":"streamId","type":"option","char":"t","description":"the type of the provided reference name","options":["stream-id"],"default":"stream-id"}},"args":[{"name":"streamName","description":"the name (coupled with --reference-type) to look up in Mux to yield this livestream","required":true}]}}}
+{"version":"0.7.0","commands":{"init":{"id":"init","description":"set up a user-level config","pluginName":"@mux/cli","pluginType":"core","aliases":[],"flags":{"force":{"name":"force","type":"boolean","char":"f","description":"Will initialize a new file even if one already exists.","allowNo":false}},"args":[{"name":"envFile","description":"path to a Mux access token .env file","required":false}]},"sign":{"id":"sign","description":"Creates a new signed URL token for a playback ID","pluginName":"@mux/cli","pluginType":"core","aliases":[],"flags":{"expiresIn":{"name":"expiresIn","type":"option","char":"e","description":"How long the signature is valid for. If no unit is specified, milliseconds is assumed.","default":"7d"},"type":{"name":"type","type":"option","char":"t","description":"What type of token this signature is for.","options":["video","thumbnail","gif"],"default":"video"}},"args":[{"name":"playback-id","description":"Playback ID to create a signed URL token for.","required":true}]},"assets:create":{"id":"assets:create","description":"Create a new asset in Mux using a file that's already available online","pluginName":"@mux/cli","pluginType":"core","aliases":[],"flags":{"private":{"name":"private","type":"boolean","char":"p","description":"add a private playback policy to the created asset","allowNo":false}},"args":[{"name":"input","description":"input URL for the file you'd like to create this asset from","required":true}]},"assets:upload":{"id":"assets:upload","description":"Create a new asset in Mux via a local file","pluginName":"@mux/cli","pluginType":"core","aliases":[],"flags":{"private":{"name":"private","type":"boolean","char":"p","allowNo":false},"filter":{"name":"filter","type":"option","char":"f","description":"regex that filters the selected destination if the provided path is a folder"},"concurrent":{"name":"concurrent","type":"option","char":"c","description":"max number of files to upload at once","default":3}},"args":[{"name":"path","description":"local path for the file (or folder) you'd like to upload","required":true}]},"live:complete":{"id":"live:complete","description":"Signal to Mux that a live stream has concluded and should be closed.","pluginName":"@mux/cli","pluginType":"core","aliases":[],"flags":{"streamId":{"name":"streamId","type":"option","char":"t","description":"the type of the provided reference name","options":["stream-id"],"default":"stream-id"},"disableAfterCompletion":{"name":"disableAfterCompletion","type":"boolean","char":"d","description":"If set, disables the stream upon completion.","allowNo":false}},"args":[{"name":"streamName","description":"the name (coupled with --reference-type) to look up in Mux to yield this livestream","required":true}]},"live:disable":{"id":"live:disable","description":"Disables a live stream and prevents encoders from streaming to it.","pluginName":"@mux/cli","pluginType":"core","aliases":[],"flags":{"streamId":{"name":"streamId","type":"option","char":"t","description":"the type of the provided reference name","options":["stream-id"],"default":"stream-id"}},"args":[{"name":"streamName","description":"the name (coupled with --reference-type) to look up in Mux to yield this livestream","required":true}]},"live:enable":{"id":"live:enable","description":"Enables a live stream, allowing encoders to streaming to it.","pluginName":"@mux/cli","pluginType":"core","aliases":[],"flags":{"streamId":{"name":"streamId","type":"option","char":"t","description":"the type of the provided reference name","options":["stream-id"],"default":"stream-id"}},"args":[{"name":"streamName","description":"the name (coupled with --reference-type) to look up in Mux to yield this livestream","required":true}]}}}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mux/cli",
   "description": "Your friendly neighborhood Mux CLI tool!",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "author": {
     "name": "Mux",
     "email": "devex@mux.com",
@@ -16,52 +16,55 @@
   },
   "bugs": "https://github.com/muxinc/cli/issues",
   "dependencies": {
-    "@mux/mux-node": "^3.1.0",
-    "@oclif/command": "^1.8.0",
-    "@oclif/config": "^1.17.0",
-    "@oclif/plugin-autocomplete": "^0.2.0",
-    "@oclif/plugin-commands": "^1.3.0",
-    "@oclif/plugin-help": "^3.2.0",
-    "@oclif/plugin-not-found": "^1.2.4",
-    "@oclif/plugin-update": "^1.3.10",
-    "@oclif/plugin-warn-if-update-available": "^1.7.0",
-    "chalk": "^4.1.0",
+    "@mux/mux-node": "^4.0.0",
+    "@oclif/command": "^1.8.16",
+    "@oclif/config": "^1.18.2",
+    "@oclif/plugin-autocomplete": "^1.1.1",
+    "@oclif/plugin-commands": "^2.0.2",
+    "@oclif/plugin-help": "^5.1.10",
+    "@oclif/plugin-not-found": "^2.2.4",
+    "@oclif/plugin-plugins": "^2.0.12",
+    "@oclif/plugin-update": "^2.1.5",
+    "@oclif/plugin-warn-if-update-available": "^2.0.4",
+    "chalk": "4.1.2",
     "clipboardy": "^2.3.0",
     "dotenv": "^8.2.0",
-    "fs-extra": "^9.0.1",
-    "inquirer": "^7.3.3",
+    "fs-extra": "^10.0.0",
+    "inquirer": "^8.2.0",
     "listr": "^0.14.3",
     "request": "^2.88.2",
-    "rxjs": "^6.6.3"
+    "runtypes": "^6.5.0",
+    "rxjs": "^7.5.2"
   },
   "devDependencies": {
-    "@oclif/dev-cli": "^1.24.3",
-    "@oclif/test": "^1.2.8",
+    "@oclif/dev-cli": "^1.26.10",
+    "@oclif/test": "^2.0.3",
     "@oclif/tslint": "^3",
-    "@types/chai": "^4.2.14",
-    "@types/fs-extra": "^9.0.4",
-    "@types/inquirer": "^7.3.1",
-    "@types/listr": "^0.14.2",
-    "@types/mocha": "^8.0.4",
-    "@types/node": "^10",
-    "@types/request": "^2.48.5",
-    "chai": "^4",
-    "globby": "^11.0.1",
-    "mocha": "^8.2.1",
+    "@types/chai": "^4.3.0",
+    "@types/fs-extra": "^9.0.13",
+    "@types/inquirer": "^8.1.3",
+    "@types/listr": "^0.14.4",
+    "@types/mocha": "^9.1.0",
+    "@types/node": "^17.0.12",
+    "@types/request": "^2.48.8",
+    "chai": "^4.3.6",
+    "globby": "11.0.4",
+    "mocha": "6.2.3",
     "nyc": "^15.1.0",
-    "oclif": "^1.16.1",
-    "ts-node": "^9.0.0",
+    "oclif": "^2.4.0",
+    "ts-node": "^10.4.0",
     "tslint": "^6.1.3",
     "tslint-config-prettier": "^1.18.0",
-    "typescript": "^4.1.2"
+    "typescript": "^4.5.5"
   },
   "engines": {
-    "node": ">=8.0.0"
+    "node": ">=14.0.0"
   },
   "files": [
     "/bin",
     "/lib",
-    "/npm-shrinkwrap.json",
+    "/src",
+    "/yarn.lock",
     "/oclif.manifest.json"
   ],
   "homepage": "https://github.com/muxinc/cli",
@@ -79,7 +82,8 @@
       "@oclif/plugin-autocomplete",
       "@oclif/plugin-commands",
       "@oclif/plugin-update",
-      "@oclif/plugin-warn-if-update-available"
+      "@oclif/plugin-warn-if-update-available",
+      "@oclif/plugin-plugins"
     ],
     "macos": {
       "identifier": "com.mux.cli"
@@ -95,14 +99,16 @@
   },
   "repository": "muxinc/cli",
   "scripts": {
+    "clean": "rm -rf lib && rm -rf tsconfig.tsbuildinfo",
+    "build": "tsc -b",
     "postpack": "rm -f oclif.manifest.json",
     "posttest": "tslint -p test -t stylish",
-    "prepack": "rm -rf lib && tsc -b && oclif-dev manifest && oclif-dev readme",
+    "prepack": "yarn run -s clean && yarn run -s build && oclif-dev manifest && oclif-dev readme",
     "test": "nyc --extension .ts mocha --forbid-only \"test/**/*.test.ts\"",
     "version": "oclif-dev readme && git add README.md"
   },
   "types": "lib/index.d.ts",
   "volta": {
-    "node": "8.17.0"
+    "node": "14.16.1"
   }
 }

package/src/command-bases/asset-base.ts

@@ -0,0 +1,52 @@
+import { Asset } from '@mux/mux-node';
+import { flags } from '@oclif/command';
+import * as Parser from '@oclif/parser';
+import CommandBase from './base';
+
+export type AssetBaseFlags = {
+  private: Parser.flags.IBooleanFlag<boolean>;
+};
+
+export default abstract class AssetCommandBase extends CommandBase {
+  static flags: AssetBaseFlags = {
+    private: flags.boolean({
+      char: 'p',
+      description: 'add a private playback policy to the created asset',
+    }),
+  };
+
+  playbackUrl(asset: Asset) {
+    const publicPlaybackId = (asset.playback_ids ?? []).find(
+      p => p.policy === 'public'
+    );
+    if (!publicPlaybackId) {
+      return 'No public playback policies found!';
+    }
+
+    return `https://mux-playground.now.sh/videojs?playback_id=${
+      publicPlaybackId.id
+    }`;
+  }
+
+  pollAsset(assetId: string): Promise<Asset> {
+    return new Promise((resolve, reject) => {
+      const poll = () =>
+        setTimeout(async () => {
+          try {
+            const asset = await this.Video.Assets.get(assetId);
+            if (asset.status === 'ready') {
+              return resolve(asset);
+            } else if (asset.status === 'errored') {
+              return reject(asset);
+            }
+
+            poll();
+          } catch (err) {
+            reject(err);
+          }
+        }, 500);
+
+      poll();
+    });
+  }
+}

package/src/command-bases/base.ts

@@ -0,0 +1,71 @@
+import Mux, { Video as MuxVideo, Data as MuxData } from '@mux/mux-node';
+import Command from '@oclif/command';
+import * as chalk from 'chalk';
+import * as fs from 'fs-extra';
+import * as path from 'path';
+
+import { MuxCliConfigV1 } from '../config';
+
+export const MUX_API_BASE_URL = "https://api.mux.com";
+
+export default abstract class CommandBase extends Command {
+  configFile = path.join(this.config.configDir, 'config.json');
+
+  MuxConfig!: MuxCliConfigV1;
+  Mux!: Mux;
+  Video!: MuxVideo;
+  Data!: MuxData;
+  JWT: any;
+
+  async readConfigV1(): Promise<MuxCliConfigV1 | null> {
+    const configAlreadyExists = await fs.pathExists(this.configFile);
+    try {
+      const configRaw =
+        configAlreadyExists
+          ? await fs.readJSON(this.configFile)
+          : {};
+
+      // Mux SDK configuration options
+      configRaw.tokenId = process.env.MUX_TOKEN_ID ?? configRaw.tokenId;
+      configRaw.tokenSecret = process.env.MUX_TOKEN_SECRET ?? configRaw.tokenSecret;
+      configRaw.signingKeyId = process.env.MUX_SIGNING_KEY ?? configRaw.signingKeyId;
+      configRaw.signingKeySecret = process.env.MUX_PRIVATE_KEY ?? configRaw.signingKeySecret;
+
+      // Mux CLI specific configuration options
+      configRaw.configVersion = configRaw.configVersion ?? 1;
+      configRaw.baseUrl = process.env.MUX_CLI_BASE_URL ?? configRaw.baseUrl ?? MUX_API_BASE_URL;
+      return MuxCliConfigV1.check(configRaw);
+    } catch (err) {
+      if (configAlreadyExists) {
+        // we have a bad config file, and should say so
+        this.log(
+          chalk`{bold.underline.red Invalid Mux configuration file found at {bold.underline.cyan ${this.configFile}}:}\n\n` +
+          Object.entries((err as any).details).map(tup => " - " + chalk`{cyan ${tup[0]}}` + `: ${tup[1]}`) +
+          chalk`\n\nPlease fix the file or run {bold.magenta mux init --force} to create a new one.`
+        )
+      } else {
+        this.log(
+          chalk`{bold.underline.red No Mux configuration file found!} If you'd like to create ` +
+          chalk`one, run the {bold.magenta init} command. Otherwise, make sure to have the ` +
+          chalk`{bold.yellow MUX_TOKEN_ID} and {bold.yellow MUX_TOKEN_SECRET} environment variables set. 👋`
+        );
+      }
+
+      process.exit(1);
+    }
+  }
+
+  async init() {
+    if (this.id === 'init') return; // If we're initing we don't want any of this!
+
+    const config = await this.readConfigV1();
+    const mux = new Mux(config?.tokenId, config?.tokenSecret, {
+      baseUrl: config?.baseUrl,
+    });
+
+    this.Mux = mux;
+    this.Video = this.Mux.Video;
+    this.Data = this.Mux.Data;
+    this.JWT = Mux.JWT;
+  }
+}

package/src/command-bases/live-base.ts

@@ -0,0 +1,35 @@
+import { flags } from '@oclif/command';
+import { IFlag } from '@oclif/command/lib/flags';
+
+import CommandBase from './base';
+
+export default abstract class LiveCommandBase extends CommandBase {
+  static argsForSingleLiveStream = [
+    {
+      name: 'streamName',
+      description:
+        "the name (coupled with --reference-type) to look up in Mux to yield this livestream",
+      required: true,
+    },
+  ];
+
+  static flagsForSingleLiveStream: Record<string, IFlag<any>> = {
+    streamId: flags.string({
+      name: 'reference-type',
+      char: 't',
+      description: 'the type of the provided reference name',
+      options: ['stream-id'],
+      default: 'stream-id',
+    }),
+  }
+
+  protected getStreamId(flags: Record<string, any>, streamName: string): string {
+    switch (flags.streamId) {
+      case 'stream-id':
+        // just a pass-through
+        return streamName;
+    }
+
+    throw new Error("Could not derive a stream ID. Please pass one with --stream-id.");
+  }
+}

package/src/commands/assets/create.ts

@@ -0,0 +1,74 @@
+import * as chalk from 'chalk';
+import * as clipboard from 'clipboardy';
+import * as Listr from 'listr';
+
+import AssetCommandBase from '../../command-bases/asset-base';
+
+export default class AssetsCreate extends AssetCommandBase {
+  static description =
+    "Create a new asset in Mux using a file that's already available online";
+
+  static args = [
+    {
+      name: 'input',
+      description:
+        "input URL for the file you'd like to create this asset from",
+      required: true,
+    },
+  ];
+
+  async run() {
+    const { args, flags } = this.parse(AssetsCreate);
+    let assetBodyParams = {
+      input: args.input,
+      playback_policies: flags.private ? ['signed'] : ['public'],
+    };
+
+    const tasks = new Listr([
+      {
+        title: 'Creating Mux Asset',
+        task: async ctx => {
+          const asset = await this.Video.Assets.create(assetBodyParams);
+          ctx.asset = asset;
+        },
+      },
+      {
+        title: 'Waiting for asset to be playable',
+        task: async ctx => {
+          const asset = await this.pollAsset(ctx.asset.id);
+          ctx.asset = asset;
+        },
+      },
+    ]);
+
+    try {
+      const ctx = await tasks.run();
+      const playbackUrl = this.playbackUrl(ctx.asset);
+
+      if (!process.env.WSL_DISTRO_NAME) {
+        await clipboard.write(playbackUrl);
+      }
+
+      this.log(
+        chalk`
+  💫 {bold.blue Asset ready for your enjoyment!}
+
+  {bold.underline Playback URL}
+  ${playbackUrl}
+  `
+      );
+    } catch (err) {
+      console.log(
+        chalk.redBright('Error:') +
+        "\n\n" +
+        err
+      );
+
+      if (err instanceof Error) {
+        this.error(err);
+      } else {
+        throw err;
+      }
+    }
+  }
+}

package/src/commands/assets/upload.ts

@@ -0,0 +1,192 @@
+import { CreateUploadParams, Upload } from '@mux/mux-node';
+import { flags } from '@oclif/command';
+import * as chalk from 'chalk';
+import * as clipboard from 'clipboardy';
+import * as fs from 'fs-extra';
+import * as inquirer from 'inquirer';
+import * as Listr from 'listr';
+import * as path from 'path';
+import * as request from 'request';
+
+import AssetCommandBase, { AssetBaseFlags } from '../../command-bases/asset-base';
+
+export type AssetCreateFlags = AssetBaseFlags & {
+  filter: flags.IOptionFlag<string | undefined>;
+  concurrent: flags.IOptionFlag<number>;
+};
+
+export default class AssetsCreate extends AssetCommandBase {
+  static description = 'Create a new asset in Mux via a local file';
+
+  static args = [
+    {
+      name: 'path',
+      description: "local path for the file (or folder) you'd like to upload",
+      required: true,
+    },
+  ];
+
+  static flags: AssetCreateFlags = {
+    ...AssetCommandBase.flags,
+    filter: flags.string({
+      char: 'f',
+      description:
+        'regex that filters the selected destination if the provided path is a folder',
+    }),
+    concurrent: flags.integer({
+      char: 'c',
+      description: 'max number of files to upload at once',
+      default: 3,
+    }),
+    private: flags.boolean({
+      char: 'p',
+      default: false,
+    })
+  };
+
+  getFilePaths(filePath: string, filter = '') {
+    if (fs.lstatSync(filePath).isDirectory()) {
+      return fs.readdirSync(filePath).filter(file => file.match(filter));
+    }
+
+    return [filePath];
+  }
+
+  uploadFile(filePath: string, url: string) {
+    return new Promise((resolve, reject) => {
+      fs.createReadStream(path.resolve(process.cwd(), filePath)).pipe(
+        request
+          .put(url)
+          .on('response', resolve)
+          .on('error', reject)
+      );
+    });
+  }
+
+  pollUpload(uploadId: string): Promise<Upload> {
+    return new Promise((resolve, reject) => {
+      const poll = () =>
+        setTimeout(async () => {
+          try {
+            const upload = await this.Video.Uploads.get(uploadId);
+            if (upload.status === 'asset_created') {
+              return resolve(upload);
+            } else if (upload.status === 'errored') {
+              return reject(upload);
+            }
+
+            poll();
+          } catch (err) {
+            reject(err);
+          }
+        }, 500);
+
+      poll();
+    });
+  }
+
+  async run() {
+    const { args, flags } = this.parse(AssetsCreate);
+
+    let assetBodyParams: CreateUploadParams = {
+      new_asset_settings: {
+        playback_policy: flags.private ? ['signed'] : ['public'],
+      },
+    };
+
+    const regex = new RegExp(flags.filter || '', 'ig');
+    const files = this.getFilePaths(
+      path.resolve(process.cwd(), args.path)
+    ).filter(file => file.match(regex));
+
+    let prompt = { files };
+    if (files.length === 0) {
+      return this.log(
+        `We were unable to find any files. You might want to double check your path or make sure your filter isn't too strict`
+      );
+    } else if (files.length > 1) {
+      prompt = await inquirer.prompt([
+        {
+          type: 'checkbox',
+          name: 'files',
+          message: 'We found a few files! Do all of these look good?',
+          choices: files,
+          default: files,
+        },
+      ]);
+    }
+
+    const tasks = prompt.files.map((file: string) => ({
+      title: `${file}: getting direct upload URL`,
+      task: async (ctx: any, task: Listr.ListrTaskWrapper) => {
+        const upload = await this.Video.Uploads.create(assetBodyParams);
+
+        task.title = `${file}: uploading`;
+        await this.uploadFile(
+          path.resolve(process.cwd(), args.path, file),
+          upload.url
+        );
+
+        task.title = `${file}: waiting for asset to be playable`;
+        const { asset_id: assetId } = await this.pollUpload(upload.id);
+
+        if (!assetId) {
+          throw new Error(`Asset for upload '${upload.id}' failed to resolve.`);
+        }
+        const asset = await this.pollAsset(assetId);
+
+        const playbackUrl = this.playbackUrl(asset);
+        task.title = `${file}: ${playbackUrl}`;
+        ctx.assets = [
+          ...(ctx.assets || [['Filename', 'Asset ID', 'PlaybackURL']]),
+          [file, asset.id, playbackUrl],
+        ];
+      },
+    }));
+
+    // I hate this `any` here, but I'm running into a weird issue casting
+    // the `tasks` above to an array of `ListrTasks[]`.
+    try {
+      const finalCtx = await new Listr(tasks, {
+        concurrent: flags.concurrent,
+      }).run();
+
+      const tsv = finalCtx.assets
+        .map((row: string[]) => row.join('\t'))
+        .join('\n');
+      if (prompt.files.length > 1 && !process.env.WSL_DISTRO_NAME) {
+        await clipboard.write(tsv);
+
+        return this.log(
+          chalk`
+  📹 {bold.underline Assets ready for your enjoyment:}
+  ${tsv}
+
+  {blue (copied to your clipboard)}`
+        );
+      }
+
+      await clipboard.write(finalCtx.assets[1][2]);
+      return this.log(
+        chalk`
+  📹 {bold.underline Asset ready for your enjoyment:}
+  ${tsv}
+
+  {blue (since you only uploaded one asset, we just added the playback URL to your clipboard.)}`
+      );
+    } catch (err) {
+      // TODO: make this clearer / separate it out per video for more obvious debugging.
+      console.log(
+        chalk.redBright('Error:') +
+        "\n\n" +
+        err
+      );
+
+      if (err instanceof Error) {
+        this.error(err);
+      } else {
+        throw err;
+      }
+    }
+  }
+}