twentythree-cli 1.0.0 → 1.0.2

package/dist/commands/webinar/series/metrics.cjs

@@ -32,7 +32,7 @@ var WebinarSeriesMetrics = class WebinarSeriesMetrics extends require_lib_base_c
 		const { args } = await this.parse(WebinarSeriesMetrics);
 		this.printWorkspaceHeader();
 		const { data, error } = await this.apiClient.GET("/live/series/metrics", { params: { query: { live_series_id: Number(args.id) } } });
-		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		if (error) this.error(require_lib_term_map.applyCliTerms(require_lib_output.formatApiError(error)), { exit: 1 });
 		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
 			ok: true,
 			data,

package/dist/commands/webinar/series/recurrences.cjs

@@ -37,7 +37,7 @@ var WebinarSeriesRecurrences = class WebinarSeriesRecurrences extends require_li
 		const { args } = await this.parse(WebinarSeriesRecurrences);
 		this.printWorkspaceHeader();
 		const { data, error } = await this.apiClient.GET("/live/series/recurrences", { params: { query: { live_series_id: Number(args.id) } } });
-		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		if (error) this.error(require_lib_term_map.applyCliTerms(require_lib_output.formatApiError(error)), { exit: 1 });
 		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
 			ok: true,
 			data,

package/dist/commands/webinar/series/set-ondemand.cjs

@@ -50,7 +50,7 @@ var WebinarSeriesSetOndemand = class WebinarSeriesSetOndemand extends require_li
 			body,
 			headers: { "Content-Type": "application/x-www-form-urlencoded" }
 		});
-		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		if (error) this.error(require_lib_term_map.applyCliTerms(require_lib_output.formatApiError(error)), { exit: 1 });
 		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
 			ok: true,
 			data,

package/dist/commands/webinar/series/skip-recurrence.cjs

@@ -62,7 +62,7 @@ var WebinarSeriesSkipRecurrence = class WebinarSeriesSkipRecurrence extends requ
 			recurrence_id: Number(recurrenceId),
 			skipped_p: skipped ? 1 : 0
 		} } });
-		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		if (error) this.error(require_lib_term_map.applyCliTerms(require_lib_output.formatApiError(error)), { exit: 1 });
 		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
 			ok: true,
 			data,

package/dist/commands/webinar/series/update.cjs

@@ -54,7 +54,7 @@ var WebinarSeriesUpdate = class WebinarSeriesUpdate extends require_lib_base_com
 			body,
 			headers: { "Content-Type": "application/x-www-form-urlencoded" }
 		});
-		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		if (error) this.error(require_lib_term_map.applyCliTerms(require_lib_output.formatApiError(error)), { exit: 1 });
 		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
 			ok: true,
 			data,

package/dist/commands/webinar/speaker/add-from-speaker.cjs

@@ -57,7 +57,7 @@ var WebinarSpeakerAddFromSpeaker = class WebinarSpeakerAddFromSpeaker extends re
 			},
 			headers: { "Content-Type": "application/x-www-form-urlencoded" }
 		});
-		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		if (error) this.error(require_lib_term_map.applyCliTerms(require_lib_output.formatApiError(error)), { exit: 1 });
 		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
 			ok: true,
 			data,

package/dist/commands/webinar/speaker/add-from-user.cjs

@@ -57,7 +57,7 @@ var WebinarSpeakerAddFromUser = class WebinarSpeakerAddFromUser extends require_
 			},
 			headers: { "Content-Type": "application/x-www-form-urlencoded" }
 		});
-		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		if (error) this.error(require_lib_term_map.applyCliTerms(require_lib_output.formatApiError(error)), { exit: 1 });
 		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
 			ok: true,
 			data,

package/dist/commands/webinar/speaker/add.cjs

@@ -83,7 +83,7 @@ var WebinarSpeakerAdd = class WebinarSpeakerAdd extends require_lib_base_command
 			body,
 			headers: { "Content-Type": "application/x-www-form-urlencoded" }
 		});
-		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		if (error) this.error(require_lib_term_map.applyCliTerms(require_lib_output.formatApiError(error)), { exit: 1 });
 		const speakerId = data?.data?.live_speaker_id ?? data?.live_speaker_id;
 		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
 			ok: true,

package/dist/commands/webinar/speaker/cancel-guest-request.cjs

@@ -45,7 +45,7 @@ var WebinarSpeakerCancelGuestRequest = class WebinarSpeakerCancelGuestRequest ex
 			},
 			headers: { "Content-Type": "application/x-www-form-urlencoded" }
 		});
-		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		if (error) this.error(require_lib_term_map.applyCliTerms(require_lib_output.formatApiError(error)), { exit: 1 });
 		this.log(chalk.default.green("Guest request cancelled"));
 		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
 			ok: true,

package/dist/commands/webinar/speaker/connection-types.cjs

@@ -38,7 +38,7 @@ var WebinarSpeakerConnectionTypes = class WebinarSpeakerConnectionTypes extends
 		const { args } = await this.parse(WebinarSpeakerConnectionTypes);
 		this.printWorkspaceHeader();
 		const { data, error } = await this.apiClient.GET("/live/speaker/connection-types", { params: { query: { live_id: Number(args.id) } } });
-		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		if (error) this.error(require_lib_term_map.applyCliTerms(require_lib_output.formatApiError(error)), { exit: 1 });
 		const types = Array.isArray(data?.data) ? data.data : Array.isArray(data) ? data : [];
 		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
 			ok: true,

package/dist/commands/webinar/speaker/library.cjs

@@ -31,7 +31,7 @@ var WebinarSpeakerLibrary = class WebinarSpeakerLibrary extends require_lib_base
 		await this.parse(WebinarSpeakerLibrary);
 		this.printWorkspaceHeader();
 		const { data, error } = await this.apiClient.GET("/live/speaker/library/list", { params: { query: {} } });
-		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		if (error) this.error(require_lib_term_map.applyCliTerms(require_lib_output.formatApiError(error)), { exit: 1 });
 		const speakers = Array.isArray(data?.data) ? data.data : data?.data ? [data.data] : [];
 		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
 			ok: true,

package/dist/commands/webinar/speaker/list.cjs

@@ -51,7 +51,7 @@ var WebinarSpeakerList = class WebinarSpeakerList extends require_lib_base_comma
 			live_id: webinarId,
 			token
 		} } });
-		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		if (error) this.error(require_lib_term_map.applyCliTerms(require_lib_output.formatApiError(error)), { exit: 1 });
 		const speakers = Array.isArray(data?.data) ? data.data : data?.data ? [data.data] : [];
 		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
 			ok: true,

package/dist/commands/webinar/speaker/remove-avatar.cjs

@@ -45,7 +45,7 @@ var WebinarSpeakerRemoveAvatar = class WebinarSpeakerRemoveAvatar extends requir
 			},
 			headers: { "Content-Type": "application/x-www-form-urlencoded" }
 		});
-		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		if (error) this.error(require_lib_term_map.applyCliTerms(require_lib_output.formatApiError(error)), { exit: 1 });
 		this.log(chalk.default.green("Speaker avatar removed"));
 		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
 			ok: true,

package/dist/commands/webinar/speaker/remove.cjs

@@ -52,7 +52,7 @@ var WebinarSpeakerRemove = class WebinarSpeakerRemove extends require_lib_base_c
 			},
 			headers: { "Content-Type": "application/x-www-form-urlencoded" }
 		});
-		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		if (error) this.error(require_lib_term_map.applyCliTerms(require_lib_output.formatApiError(error)), { exit: 1 });
 		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
 			ok: true,
 			data,

package/dist/commands/webinar/speaker/request-guest.cjs

@@ -45,7 +45,7 @@ var WebinarSpeakerRequestGuest = class WebinarSpeakerRequestGuest extends requir
 			},
 			headers: { "Content-Type": "application/x-www-form-urlencoded" }
 		});
-		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		if (error) this.error(require_lib_term_map.applyCliTerms(require_lib_output.formatApiError(error)), { exit: 1 });
 		this.log(chalk.default.green("Guest request sent"));
 		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
 			ok: true,

package/dist/commands/webinar/speaker/send-invitation.cjs

@@ -45,7 +45,7 @@ var WebinarSpeakerSendInvitation = class WebinarSpeakerSendInvitation extends re
 			},
 			headers: { "Content-Type": "application/x-www-form-urlencoded" }
 		});
-		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		if (error) this.error(require_lib_term_map.applyCliTerms(require_lib_output.formatApiError(error)), { exit: 1 });
 		this.log(chalk.default.green("Speaker invitation sent"));
 		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
 			ok: true,

package/dist/commands/webinar/speaker/set-order.cjs

@@ -71,7 +71,7 @@ var WebinarSpeakerSetOrder = class WebinarSpeakerSetOrder extends require_lib_ba
 			},
 			headers: { "Content-Type": "application/x-www-form-urlencoded" }
 		});
-		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		if (error) this.error(require_lib_term_map.applyCliTerms(require_lib_output.formatApiError(error)), { exit: 1 });
 		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
 			ok: true,
 			data,

package/dist/commands/webinar/speaker/update.cjs

@@ -73,7 +73,7 @@ var WebinarSpeakerUpdate = class WebinarSpeakerUpdate extends require_lib_base_c
 			body,
 			headers: { "Content-Type": "application/x-www-form-urlencoded" }
 		});
-		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		if (error) this.error(require_lib_term_map.applyCliTerms(require_lib_output.formatApiError(error)), { exit: 1 });
 		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
 			ok: true,
 			data,

package/dist/commands/webinar/transcription/connect.cjs

@@ -48,7 +48,7 @@ var WebinarTranscriptionConnect = class WebinarTranscriptionConnect extends requ
 			body,
 			headers: { "Content-Type": "application/x-www-form-urlencoded" }
 		});
-		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		if (error) this.error(require_lib_term_map.applyCliTerms(require_lib_output.formatApiError(error)), { exit: 1 });
 		this.log(chalk.default.green("Transcription connected"));
 		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
 			ok: true,

package/dist/commands/webinar/transcription/list.cjs

@@ -53,7 +53,7 @@ var WebinarTranscriptionList = class WebinarTranscriptionList extends require_li
 			live_id: Number(args.id),
 			token
 		} } });
-		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		if (error) this.error(require_lib_term_map.applyCliTerms(require_lib_output.formatApiError(error)), { exit: 1 });
 		const items = Array.isArray(data?.data) ? data.data : data?.data ? [data.data] : [];
 		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
 			ok: true,

package/dist/commands/webinar/transcription/locales.cjs

@@ -49,7 +49,7 @@ var WebinarTranscriptionLocales = class WebinarTranscriptionLocales extends requ
 			live_id: Number(args.id),
 			token
 		} } });
-		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		if (error) this.error(require_lib_term_map.applyCliTerms(require_lib_output.formatApiError(error)), { exit: 1 });
 		const items = Array.isArray(data?.data) ? data.data : data?.data ? [data.data] : Array.isArray(data) ? data : [];
 		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
 			ok: true,

package/dist/commands/webinar/transcription/transcriptionlist.cjs

@@ -37,7 +37,7 @@ var WebinarTranscriptionTranscriptionlist = class WebinarTranscriptionTranscript
 		await this.parse(WebinarTranscriptionTranscriptionlist);
 		this.printWorkspaceHeader();
 		const { data, error } = await this.apiClient.GET("/live/transcriptionlist", { params: { query: {} } });
-		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		if (error) this.error(require_lib_term_map.applyCliTerms(require_lib_output.formatApiError(error)), { exit: 1 });
 		const items = Array.isArray(data?.data) ? data.data : data?.data ? [data.data] : Array.isArray(data) ? data : [];
 		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
 			ok: true,

package/dist/commands/webinar/update.cjs

@@ -95,7 +95,7 @@ var WebinarUpdate = class WebinarUpdate extends require_lib_base_command.Authent
 		const body = { live_id: webinarId };
 		if (!metadataFlagsProvided && !this.jsonEnabled()) {
 			const { data, error } = await this.apiClient.GET("/live/list", { params: { query: { live_id: webinarId } } });
-			if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+			if (error) this.error(require_lib_term_map.applyCliTerms(require_lib_output.formatApiError(error)), { exit: 1 });
 			const resp = data;
 			let current;
 			if (Array.isArray(resp?.data)) current = resp.data[0];
@@ -166,16 +166,16 @@ var WebinarUpdate = class WebinarUpdate extends require_lib_base_command.Authent
 			if (flags.description !== void 0) body.description = flags.description;
 			if (flags.status !== void 0) body.live_status = flags.status;
 			if (flags["live-date"] !== void 0) body.start_time = flags["live-date"];
-			const draftVal = parseBoolParam(flags.draft, flags["draft-p"]);
+			const draftVal = require_lib_output.parseBoolParam(flags.draft, flags["draft-p"]);
 			if (draftVal !== void 0) body.draft_p = draftVal ? 1 : 0;
-			const publishVal = parseBoolParam(flags.publish, flags["published-p"]);
+			const publishVal = require_lib_output.parseBoolParam(flags.publish, flags["published-p"]);
 			if (publishVal !== void 0) body.published_p = publishVal ? 1 : 0;
 		}
 		const { data: updateData, error: updateError } = await this.apiClient.POST("/live/update", {
 			body,
 			headers: { "Content-Type": "application/x-www-form-urlencoded" }
 		});
-		if (updateError) this.error(require_lib_term_map.applyCliTerms(formatApiError(updateError)), { exit: 1 });
+		if (updateError) this.error(require_lib_term_map.applyCliTerms(require_lib_output.formatApiError(updateError)), { exit: 1 });
 		this.log(chalk.default.green(`Webinar ${args.id} updated`));
 		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
 			ok: true,

package/dist/lib/base-command.cjs

@@ -128,7 +128,7 @@ var AuthenticatedCommand = class extends BaseCommand {
 	async fetchVideoToken(videoId) {
 		const { data, error } = await this.apiClient.GET("/photo/list", { params: { query: {
 			photo_id: Number(videoId),
-			include_unpublished_p: 1
+			include_unpublished_p: "1"
 		} } });
 		if (error) this.error(`Could not look up video ${videoId}: ${error}`, { exit: 1 });
 		const resp = data;

package/dist/lib/output.cjs

@@ -59,6 +59,37 @@ function formatBytes(bytes) {
 	return `${bytes} B`;
 }
 /**
+* Serialize an openapi-fetch error to a readable string.
+* Handles plain objects (JSON error bodies) that String() would render as "[object Object]".
+*/
+function formatApiError(error) {
+	if (error === null || error === void 0) return "Unknown error";
+	if (typeof error === "string") return error;
+	if (error instanceof Error) return error.message;
+	if (typeof error === "object") {
+		const e = error;
+		const msg = e?.message ?? e?.error ?? e?.error_description ?? e?.detail;
+		if (msg) return String(msg);
+		return JSON.stringify(error);
+	}
+	return String(error);
+}
+/**
+* Resolves a boolean API parameter from:
+*   1. A hidden raw _p-suffixed string alternative (e.g. --published-p 1)
+*   2. A primary CLI boolean flag with allowNo (e.g. --publish / --no-publish)
+*
+* Returns undefined when neither is provided — the param is omitted from the request.
+* Accepts '1'/'0', 'true'/'false', 'yes'/'no' for the string alternative.
+*/
+function parseBoolParam(primary, alt) {
+	if (alt !== void 0) {
+		const v = alt.toLowerCase();
+		return v === "1" || v === "true" || v === "yes";
+	}
+	return primary;
+}
+/**
 * Resolve a potentially relative URL to an absolute URL using the workspace domain.
 *
 * - If url is undefined or empty, return it unchanged.
@@ -76,7 +107,9 @@ function resolveUrl(url, baseUrl) {
 exports.EXIT_CANCELLED = EXIT_CANCELLED;
 exports.EXIT_ERROR = EXIT_ERROR;
 exports.EXIT_SUCCESS = EXIT_SUCCESS;
+exports.formatApiError = formatApiError;
 exports.formatBytes = formatBytes;
 exports.formatJsonOutput = formatJsonOutput;
+exports.parseBoolParam = parseBoolParam;
 exports.renderTable = renderTable;
 exports.resolveUrl = resolveUrl;

package/dist/upload/chunk-pool.cjs

@@ -28,7 +28,10 @@ async function uploadChunkPool(params) {
 				onChunkComplete?.(chunk, response);
 				return;
 			}
-			if (response.status === 500) throw new Error("Unsupported file format — upload aborted");
+			if (response.status === 500) {
+				const detail = response.data?.error ?? response.data?.message ?? JSON.stringify(response.data);
+				throw new Error(`Upload rejected by server (500)${detail ? `: ${detail}` : ""}`);
+			}
 			if (attempt >= maxRetries) throw new Error(`Chunk ${chunk.number} failed after ${maxRetries} retries`);
 			await delayFn(Math.min(1e3 * Math.pow(2, attempt), 3e4));
 			attempt++;

package/docs/guides/getting-started.md

@@ -35,7 +35,21 @@ twentythree workspace list
 twentythree workspace use company.video23.com
 ```
 
-## Step 3: Run your first command
+## Step 3: Enable tab completion (optional)
+
+Run this once to set up `<TAB>` completion for all commands and flags:
+
+```bash
+twentythree autocomplete
+```
+
+The command detects your shell (bash or zsh), builds the completion cache, and shows the eval line to paste into your RC file. After sourcing your RC file or restarting your terminal, try:
+
+```bash
+twentythree video <TAB>
+```
+
+## Step 4: Run your first command
 
 List the videos in your active workspace.
 
@@ -64,3 +78,5 @@ Run `twentythree <topic> --help` for help on any topic. For example:
 twentythree video --help
 twentythree auth --help
 ```
+
+Use `<TAB>` after any command to discover subcommands and flags.