feat: better error messages around permissions, QOL improvements & better webhook replay options

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mux/cli",
-  "version": "1.0.0",
+  "version": "0.0.0",
   "description": "Official Mux CLI for interacting with Mux APIs",
   "author": "Mux",
   "license": "Apache-2.0",

src/commands/annotations/create.ts

@@ -1,4 +1,5 @@
 import { Command } from '@cliffy/command';
+import { handleCommandError } from '@/lib/errors.ts';
 import { createAuthenticatedMuxClient } from '@/lib/mux.ts';
 
 interface CreateOptions {
@@ -44,14 +45,6 @@ export const createCommand = new Command()
         console.log(`  Note: ${annotation.note}`);
       }
     } catch (error) {
-      const errorMessage =
-        error instanceof Error ? error.message : String(error);
-
-      if (options.json) {
-        console.error(JSON.stringify({ error: errorMessage }, null, 2));
-      } else {
-        console.error(`Error: ${errorMessage}`);
-      }
-      process.exit(1);
+      await handleCommandError(error, 'annotations', 'create', options);
     }
   });

src/commands/annotations/delete.ts

@@ -1,4 +1,5 @@
 import { Command } from '@cliffy/command';
+import { handleCommandError } from '@/lib/errors.ts';
 import { createAuthenticatedMuxClient } from '@/lib/mux.ts';
 import { confirmPrompt } from '@/lib/prompt.ts';
 
@@ -46,14 +47,6 @@ export const deleteCommand = new Command()
         console.log(`Annotation ${annotationId} deleted successfully.`);
       }
     } catch (error) {
-      const errorMessage =
-        error instanceof Error ? error.message : String(error);
-
-      if (options.json) {
-        console.error(JSON.stringify({ error: errorMessage }, null, 2));
-      } else {
-        console.error(`Error: ${errorMessage}`);
-      }
-      process.exit(1);
+      await handleCommandError(error, 'annotations', 'delete', options);
     }
   });

src/commands/annotations/get.ts

@@ -1,4 +1,5 @@
 import { Command } from '@cliffy/command';
+import { handleCommandError } from '@/lib/errors.ts';
 import { createAuthenticatedMuxClient } from '@/lib/mux.ts';
 
 interface GetOptions {
@@ -26,14 +27,6 @@ export const getCommand = new Command()
         }
       }
     } catch (error) {
-      const errorMessage =
-        error instanceof Error ? error.message : String(error);
-
-      if (options.json) {
-        console.error(JSON.stringify({ error: errorMessage }, null, 2));
-      } else {
-        console.error(`Error: ${errorMessage}`);
-      }
-      process.exit(1);
+      await handleCommandError(error, 'annotations', 'get', options);
     }
   });

src/commands/annotations/list.ts

@@ -1,4 +1,5 @@
 import { Command } from '@cliffy/command';
+import { handleCommandError } from '@/lib/errors.ts';
 import { createAuthenticatedMuxClient } from '@/lib/mux.ts';
 
 interface ListOptions {
@@ -82,14 +83,6 @@ export const listCommand = new Command()
         }
       }
     } catch (error) {
-      const errorMessage =
-        error instanceof Error ? error.message : String(error);
-
-      if (options.json) {
-        console.error(JSON.stringify({ error: errorMessage }, null, 2));
-      } else {
-        console.error(`Error: ${errorMessage}`);
-      }
-      process.exit(1);
+      await handleCommandError(error, 'annotations', 'list', options);
     }
   });

src/commands/annotations/update.ts

@@ -1,4 +1,5 @@
 import { Command } from '@cliffy/command';
+import { handleCommandError } from '@/lib/errors.ts';
 import { createAuthenticatedMuxClient } from '@/lib/mux.ts';
 
 interface UpdateOptions {
@@ -49,14 +50,6 @@ export const updateCommand = new Command()
         console.log(`  Note: ${annotation.note}`);
       }
     } catch (error) {
-      const errorMessage =
-        error instanceof Error ? error.message : String(error);
-
-      if (options.json) {
-        console.error(JSON.stringify({ error: errorMessage }, null, 2));
-      } else {
-        console.error(`Error: ${errorMessage}`);
-      }
-      process.exit(1);
+      await handleCommandError(error, 'annotations', 'update', options);
     }
   });

src/commands/assets/create.ts

@@ -1,5 +1,6 @@
 import { Command } from '@cliffy/command';
 import type Mux from '@mux/mux-node';
+import { handleCommandError } from '@/lib/errors.ts';
 import { expandGlobPattern, uploadFile } from '@/lib/file-upload.ts';
 import { parseAssetConfig } from '@/lib/json-config.ts';
 import { createAuthenticatedMuxClient } from '@/lib/mux.ts';
@@ -471,14 +472,6 @@ export const createCommand = new Command()
         }
       }
     } catch (error) {
-      const errorMessage =
-        error instanceof Error ? error.message : String(error);
-
-      if (opts.json) {
-        console.error(JSON.stringify({ error: errorMessage }, null, 2));
-      } else {
-        console.error(`Error: ${errorMessage}`);
-      }
-      process.exit(1);
+      await handleCommandError(error, 'assets', 'create', opts);
     }
   });

src/commands/assets/delete.ts

@@ -1,4 +1,5 @@
 import { Command } from '@cliffy/command';
+import { handleCommandError } from '@/lib/errors.ts';
 import { createAuthenticatedMuxClient } from '@/lib/mux.ts';
 import { confirmPrompt } from '@/lib/prompt.ts';
 
@@ -46,14 +47,6 @@ export const deleteCommand = new Command()
         console.log(`Asset ${assetId} deleted successfully`);
       }
     } catch (error) {
-      const errorMessage =
-        error instanceof Error ? error.message : String(error);
-
-      if (options.json) {
-        console.error(JSON.stringify({ error: errorMessage }, null, 2));
-      } else {
-        console.error(`Error: ${errorMessage}`);
-      }
-      process.exit(1);
+      await handleCommandError(error, 'assets', 'delete', options);
     }
   });

src/commands/assets/get.ts

@@ -1,4 +1,5 @@
 import { Command } from '@cliffy/command';
+import { handleCommandError } from '@/lib/errors.ts';
 import { formatAsset } from '@/lib/formatters.ts';
 import { createAuthenticatedMuxClient } from '@/lib/mux.ts';
 
@@ -24,14 +25,6 @@ export const getCommand = new Command()
         formatAsset(asset);
       }
     } catch (error) {
-      const errorMessage =
-        error instanceof Error ? error.message : String(error);
-
-      if (options.json) {
-        console.error(JSON.stringify({ error: errorMessage }, null, 2));
-      } else {
-        console.error(`Error: ${errorMessage}`);
-      }
-      process.exit(1);
+      await handleCommandError(error, 'assets', 'get', options);
     }
   });

src/commands/assets/input-info.ts

@@ -1,4 +1,5 @@
 import { Command } from '@cliffy/command';
+import { handleCommandError } from '@/lib/errors.ts';
 import { createAuthenticatedMuxClient } from '@/lib/mux.ts';
 
 interface InputInfoOptions {
@@ -69,14 +70,6 @@ export const inputInfoCommand = new Command()
         }
       }
     } catch (error) {
-      const errorMessage =
-        error instanceof Error ? error.message : String(error);
-
-      if (options.json) {
-        console.error(JSON.stringify({ error: errorMessage }, null, 2));
-      } else {
-        console.error(`Error: ${errorMessage}`);
-      }
-      process.exit(1);
+      await handleCommandError(error, 'assets', 'input-info', options);
     }
   });

src/commands/assets/list.ts

@@ -1,5 +1,6 @@
 import { Command } from '@cliffy/command';
 import type { Asset } from '@mux/mux-node/resources/video/assets';
+import { handleCommandError } from '@/lib/errors.ts';
 import {
   formatAssetStatus,
   formatCreatedAt,
@@ -85,15 +86,7 @@ export const listCommand = new Command()
         }
       }
     } catch (error) {
-      const errorMessage =
-        error instanceof Error ? error.message : String(error);
-
-      if (options.json) {
-        console.error(JSON.stringify({ error: errorMessage }, null, 2));
-      } else {
-        console.error(`Error: ${errorMessage}`);
-      }
-      process.exit(1);
+      await handleCommandError(error, 'assets', 'list', options);
     }
   });
 

src/commands/assets/manage/index.ts

@@ -1,4 +1,5 @@
 import { Command } from '@cliffy/command';
+import { handleCommandError } from '@/lib/errors.ts';
 import { createAuthenticatedMuxClient } from '@/lib/mux.ts';
 
 export const manageCommand = new Command()
@@ -52,9 +53,6 @@ export const manageCommand = new Command()
 
       root.render(React.createElement(AssetManageApp, { mux, onPrompt }));
     } catch (error) {
-      const errorMessage =
-        error instanceof Error ? error.message : String(error);
-      console.error(`Error: ${errorMessage}`);
-      process.exit(1);
+      await handleCommandError(error, 'assets', 'list', {});
     }
   });

src/commands/assets/playback-ids/create.ts

@@ -1,4 +1,5 @@
 import { Command } from '@cliffy/command';
+import { handleCommandError } from '@/lib/errors.ts';
 import { createAuthenticatedMuxClient } from '@/lib/mux.ts';
 import { createPlaybackId, type PlaybackIdPolicy } from '@/lib/playback-ids.ts';
 import { getPlayerUrl, getStreamUrl } from '@/lib/urls.ts';
@@ -59,14 +60,6 @@ export const createCommand = new Command()
         }
       }
     } catch (error) {
-      const errorMessage =
-        error instanceof Error ? error.message : String(error);
-
-      if (options.json) {
-        console.error(JSON.stringify({ error: errorMessage }, null, 2));
-      } else {
-        console.error(`Error: ${errorMessage}`);
-      }
-      process.exit(1);
+      await handleCommandError(error, 'assets', 'create', options);
     }
   });

src/commands/assets/playback-ids/delete.ts

@@ -1,4 +1,5 @@
 import { Command } from '@cliffy/command';
+import { handleCommandError } from '@/lib/errors.ts';
 import { createAuthenticatedMuxClient } from '@/lib/mux.ts';
 import { deletePlaybackId } from '@/lib/playback-ids.ts';
 import { confirmPrompt } from '@/lib/prompt.ts';
@@ -46,15 +47,7 @@ export const deleteCommand = new Command()
           console.log(`Playback ID ${playbackId} deleted successfully`);
         }
       } catch (error) {
-        const errorMessage =
-          error instanceof Error ? error.message : String(error);
-
-        if (options.json) {
-          console.error(JSON.stringify({ error: errorMessage }, null, 2));
-        } else {
-          console.error(`Error: ${errorMessage}`);
-        }
-        process.exit(1);
+        await handleCommandError(error, 'assets', 'delete', options);
       }
     },
   );

src/commands/assets/playback-ids/list.ts

@@ -1,4 +1,5 @@
 import { Command } from '@cliffy/command';
+import { handleCommandError } from '@/lib/errors.ts';
 import { createAuthenticatedMuxClient } from '@/lib/mux.ts';
 import { getPlayerUrl, getStreamUrl } from '@/lib/urls.ts';
 
@@ -52,14 +53,6 @@ export const listCommand = new Command()
         }
       }
     } catch (error) {
-      const errorMessage =
-        error instanceof Error ? error.message : String(error);
-
-      if (options.json) {
-        console.error(JSON.stringify({ error: errorMessage }, null, 2));
-      } else {
-        console.error(`Error: ${errorMessage}`);
-      }
-      process.exit(1);
+      await handleCommandError(error, 'assets', 'list', options);
     }
   });

src/commands/assets/static-renditions/create.ts

@@ -1,5 +1,6 @@
 import { Command } from '@cliffy/command';
 import type Mux from '@mux/mux-node';
+import { handleCommandError } from '@/lib/errors.ts';
 import { createAuthenticatedMuxClient } from '@/lib/mux.ts';
 
 type Resolution = NonNullable<
@@ -85,15 +86,7 @@ export const createCommand = new Command()
         outputRendition(rendition, options.json, !options.wait);
       }
     } catch (error) {
-      const errorMessage =
-        error instanceof Error ? error.message : String(error);
-
-      if (options.json) {
-        console.error(JSON.stringify({ error: errorMessage }, null, 2));
-      } else {
-        console.error(`Error: ${errorMessage}`);
-      }
-      process.exit(1);
+      await handleCommandError(error, 'assets', 'create', options);
     }
   });
 

src/commands/assets/static-renditions/delete.ts

@@ -1,4 +1,5 @@
 import { Command } from '@cliffy/command';
+import { handleCommandError } from '@/lib/errors.ts';
 import { createAuthenticatedMuxClient } from '@/lib/mux.ts';
 import { confirmPrompt } from '@/lib/prompt.ts';
 
@@ -54,15 +55,7 @@ export const deleteCommand = new Command()
           );
         }
       } catch (error) {
-        const errorMessage =
-          error instanceof Error ? error.message : String(error);
-
-        if (options.json) {
-          console.error(JSON.stringify({ error: errorMessage }, null, 2));
-        } else {
-          console.error(`Error: ${errorMessage}`);
-        }
-        process.exit(1);
+        await handleCommandError(error, 'assets', 'delete', options);
       }
     },
   );

src/commands/assets/static-renditions/list.ts

@@ -1,5 +1,6 @@
 import { Command } from '@cliffy/command';
 import type { Asset } from '@mux/mux-node/resources/video/assets';
+import { handleCommandError } from '@/lib/errors.ts';
 import { createAuthenticatedMuxClient } from '@/lib/mux.ts';
 
 type StaticRenditionFile = NonNullable<
@@ -43,15 +44,7 @@ export const listCommand = new Command()
         }
       }
     } catch (error) {
-      const errorMessage =
-        error instanceof Error ? error.message : String(error);
-
-      if (options.json) {
-        console.error(JSON.stringify({ error: errorMessage }, null, 2));
-      } else {
-        console.error(`Error: ${errorMessage}`);
-      }
-      process.exit(1);
+      await handleCommandError(error, 'assets', 'list', options);
     }
   });