twentythree-cli 1.0.0

package/dist/commands/audience/search.cjs

@@ -0,0 +1,106 @@
+const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
+const require_lib_term_map = require("../../lib/term-map.cjs");
+const require_lib_base_command = require("../../lib/base-command.cjs");
+const require_lib_output = require("../../lib/output.cjs");
+let _oclif_core = require("@oclif/core");
+let chalk = require("chalk");
+chalk = require_runtime.__toESM(chalk);
+//#region src/commands/audience/search.ts
+/**
+* Audience search command — searches audience members by text (AUD-02).
+*
+* CRITICAL: /audience/search is a GET endpoint (Pitfall 3). Uses GET not POST.
+* The --text flag is required per the OpenAPI spec.
+*/
+var AudienceSearch = class AudienceSearch extends require_lib_base_command.AuthenticatedCommand {
+	static description = "Search audience members";
+	static agentMetadata = {
+		api_endpoint: "GET /audience/search",
+		auth_scope: "read",
+		output_shape: {
+			type: "table",
+			columns: [
+				"UUID",
+				"Name",
+				"Email",
+				"Company",
+				"Score",
+				"Last Seen"
+			]
+		},
+		side_effects: "none"
+	};
+	static examples = [
+		"<%= config.bin %> audience search --text \"john doe\"",
+		"<%= config.bin %> audience search --text \"acme\" --size 20 --json",
+		"<%= config.bin %> audience search --text \"jane\" --orderby score --order desc"
+	];
+	static enableJsonFlag = true;
+	static flags = {
+		...require_lib_base_command.AuthenticatedCommand.baseFlags,
+		text: _oclif_core.Flags.string({
+			description: "Search text (required)",
+			required: true
+		}),
+		size: _oclif_core.Flags.integer({
+			description: "Number of results",
+			required: false
+		}),
+		offset: _oclif_core.Flags.integer({
+			description: "Results offset",
+			required: false
+		}),
+		orderby: _oclif_core.Flags.string({
+			description: "Order by field",
+			required: false
+		}),
+		order: _oclif_core.Flags.string({
+			description: "Sort direction (asc/desc)",
+			required: false
+		})
+	};
+	static args = {};
+	async run() {
+		const { flags } = await this.parse(AudienceSearch);
+		this.printWorkspaceHeader();
+		const { data, error } = await this.apiClient.GET("/audience/search", { params: { query: {
+			text: flags.text,
+			size: flags.size,
+			offset: flags.offset,
+			orderby: flags.orderby,
+			order: flags.order
+		} } });
+		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		const resp = data;
+		const rows = Array.isArray(resp?.data) ? resp.data : resp?.data ? [resp.data] : [];
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data: rows,
+			summary: `${rows.length} result(s)`,
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, { resource: "audience" }]
+		});
+		if (rows.length === 0) {
+			this.log("No audience members found.");
+			return;
+		}
+		const table = require_lib_output.renderTable([
+			"UUID",
+			"Name",
+			"Email",
+			"Company",
+			"Score",
+			"Last Seen"
+		], rows.map((r) => [
+			String(r.uuid ?? ""),
+			String(r.name ?? ""),
+			String(r.email ?? ""),
+			String(r.company ?? ""),
+			String(r.score ?? ""),
+			String(r.last_seen ?? "")
+		]));
+		this.log(table.toString());
+		this.log(chalk.default.dim(`${rows.length} result(s)`));
+	}
+};
+//#endregion
+module.exports = AudienceSearch;

package/dist/commands/audience/timelines.cjs

@@ -0,0 +1,115 @@
+const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
+const require_lib_term_map = require("../../lib/term-map.cjs");
+const require_lib_base_command = require("../../lib/base-command.cjs");
+const require_lib_output = require("../../lib/output.cjs");
+let _oclif_core = require("@oclif/core");
+let chalk = require("chalk");
+chalk = require_runtime.__toESM(chalk);
+//#region src/commands/audience/timelines.ts
+/**
+* Audience timelines command — list audience member view timelines (AUD-08).
+*
+* Paginated list of timeline entries (sessions/views per member per object).
+*/
+var AudienceTimelines = class AudienceTimelines extends require_lib_base_command.AuthenticatedCommand {
+	static description = "Get audience member timelines";
+	static agentMetadata = {
+		api_endpoint: "GET /audience/timelines",
+		auth_scope: "read",
+		output_shape: {
+			type: "table",
+			columns: [
+				"UUID",
+				"Object ID",
+				"Type",
+				"Engagement",
+				"Sessions",
+				"Source"
+			]
+		},
+		side_effects: "none"
+	};
+	static examples = [
+		"<%= config.bin %> audience timelines",
+		"<%= config.bin %> audience timelines --uuid \"abc-123\" --size 20",
+		"<%= config.bin %> audience timelines --objects \"456 789\" --json"
+	];
+	static enableJsonFlag = true;
+	static flags = {
+		...require_lib_base_command.AuthenticatedCommand.baseFlags,
+		page: _oclif_core.Flags.integer({
+			description: "Page number",
+			required: false
+		}),
+		size: _oclif_core.Flags.integer({
+			description: "Page size",
+			required: false
+		}),
+		offset: _oclif_core.Flags.integer({
+			description: "Offset for pagination",
+			required: false
+		}),
+		uuid: _oclif_core.Flags.string({
+			description: "Filter by audience member UUID",
+			required: false
+		}),
+		objects: _oclif_core.Flags.string({
+			description: "Filter by object IDs (space-separated)",
+			required: false
+		}),
+		orderby: _oclif_core.Flags.string({
+			description: "Order by field",
+			required: false
+		}),
+		order: _oclif_core.Flags.string({
+			description: "Sort direction (asc/desc)",
+			required: false
+		})
+	};
+	static args = {};
+	async run() {
+		const { flags } = await this.parse(AudienceTimelines);
+		this.printWorkspaceHeader();
+		const { data, error } = await this.apiClient.GET("/audience/timelines", { params: { query: {
+			p: flags.page,
+			size: flags.size,
+			offset: flags.offset,
+			uuid: flags.uuid,
+			objects: flags.objects,
+			orderby: flags.orderby,
+			order: flags.order
+		} } });
+		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		const resp = data;
+		const rows = Array.isArray(resp?.data) ? resp.data : resp?.data ? [resp.data] : [];
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data: rows,
+			summary: `${rows.length} timeline(s)`,
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, { resource: "audience" }]
+		});
+		if (rows.length === 0) {
+			this.log("No timelines found.");
+			return;
+		}
+		const table = require_lib_output.renderTable([
+			"UUID",
+			"Object ID",
+			"Type",
+			"Engagement",
+			"Sessions",
+			"Source"
+		], rows.map((r) => [
+			String(r.uuid ?? ""),
+			String(r.object_id ?? ""),
+			String(r.object_type ?? ""),
+			String(r.engagement ?? ""),
+			String(r.sessions ?? ""),
+			String(r.source ?? "")
+		]));
+		this.log(table.toString());
+		this.log(chalk.default.dim(`${rows.length} timeline(s)`));
+	}
+};
+//#endregion
+module.exports = AudienceTimelines;

package/dist/commands/audience/unregister.cjs

@@ -0,0 +1,65 @@
+const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
+const require_lib_term_map = require("../../lib/term-map.cjs");
+const require_lib_base_command = require("../../lib/base-command.cjs");
+const require_lib_output = require("../../lib/output.cjs");
+let _oclif_core = require("@oclif/core");
+let chalk = require("chalk");
+chalk = require_runtime.__toESM(chalk);
+//#region src/commands/audience/unregister.ts
+/**
+* Audience unregister command — remove a registration for an audience contact (AUD-04).
+*
+* POST form mutation. --object-id is required per the OpenAPI spec.
+*/
+var AudienceUnregister = class AudienceUnregister extends require_lib_base_command.AuthenticatedCommand {
+	static description = "Remove a registration for an audience contact";
+	static agentMetadata = {
+		api_endpoint: "POST /audience/unregister",
+		auth_scope: "write",
+		output_shape: { type: "none" },
+		side_effects: "destructive"
+	};
+	static examples = [
+		"<%= config.bin %> audience unregister --object-id 123 --email \"jane@example.com\"",
+		"<%= config.bin %> audience unregister --object-id 456 --uuid \"abc-def-ghi\"",
+		"<%= config.bin %> audience unregister --object-id 789 --json"
+	];
+	static enableJsonFlag = true;
+	static flags = {
+		...require_lib_base_command.AuthenticatedCommand.baseFlags,
+		"object-id": _oclif_core.Flags.string({
+			description: "Object ID to unregister from",
+			required: true
+		}),
+		email: _oclif_core.Flags.string({
+			description: "Contact email",
+			required: false
+		}),
+		uuid: _oclif_core.Flags.string({
+			description: "Contact UUID",
+			required: false
+		})
+	};
+	static args = {};
+	async run() {
+		const { flags } = await this.parse(AudienceUnregister);
+		this.printWorkspaceHeader();
+		const body = { object_id: Number(flags["object-id"]) };
+		if (flags.email !== void 0) body.email = flags.email;
+		if (flags.uuid !== void 0) body.uuid = flags.uuid;
+		const { data, error } = await this.apiClient.POST("/audience/unregister", {
+			body,
+			headers: { "Content-Type": "application/x-www-form-urlencoded" }
+		});
+		if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+		this.log(chalk.default.green("Contact unregistered"));
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data,
+			summary: "Contact unregistered",
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, { resource: "audience" }]
+		});
+	}
+};
+//#endregion
+module.exports = AudienceUnregister;

package/dist/commands/auth/credentials.cjs

@@ -0,0 +1,89 @@
+const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
+const require_auth_credential_store = require("../../auth/credential-store.cjs");
+const require_auth_workspace_config = require("../../auth/workspace-config.cjs");
+const require_auth_token_refresh = require("../../auth/token-refresh.cjs");
+let _oclif_core = require("@oclif/core");
+let _clack_prompts = require("@clack/prompts");
+_clack_prompts = require_runtime.__toESM(_clack_prompts);
+//#region src/commands/auth/credentials.ts
+var Credentials = class Credentials extends _oclif_core.Command {
+	static description = "Configure domain and bearer token for a TwentyThree workspace";
+	static agentMetadata = {
+		api_endpoint: "interactive",
+		auth_scope: "none",
+		output_shape: { type: "none" },
+		side_effects: "creates"
+	};
+	static examples = ["<%= config.bin %> auth credentials"];
+	async run() {
+		await this.parse(Credentials);
+		_clack_prompts.intro("TwentyThree credentials");
+		const domain = await _clack_prompts.text({
+			message: "Domain (e.g. company.video23.com)",
+			validate: (v) => v.includes(".") ? void 0 : "Enter a valid domain"
+		});
+		if (_clack_prompts.isCancel(domain)) {
+			_clack_prompts.cancel("Cancelled");
+			return;
+		}
+		const token = await _clack_prompts.text({
+			message: "Bearer token (press Enter to skip for anonymous access)",
+			placeholder: "optional"
+		});
+		if (_clack_prompts.isCancel(token)) {
+			_clack_prompts.cancel("Cancelled");
+			return;
+		}
+		const trimmedToken = token.trim();
+		if (trimmedToken) {
+			require_auth_credential_store.setCredential(domain, trimmedToken);
+			require_auth_workspace_config.setCredentialDomain(domain);
+			const s = _clack_prompts.spinner();
+			s.start("Discovering workspaces...");
+			let workspaces;
+			try {
+				workspaces = await require_auth_token_refresh.fetchWorkspaceTokens(domain, trimmedToken);
+				s.stop("Workspaces discovered");
+			} catch (err) {
+				s.stop("Failed to discover workspaces");
+				this.error(`Could not discover workspaces: ${err instanceof Error ? err.message : String(err)}`, { exit: 1 });
+			}
+			let selectedWorkspaces;
+			if (workspaces.length > 1) {
+				const selectedDomain = await _clack_prompts.select({
+					message: "Select default workspace",
+					options: workspaces.map((w) => ({
+						value: w.domain,
+						label: `${w.display_name} (${w.domain})`
+					}))
+				});
+				if (_clack_prompts.isCancel(selectedDomain)) {
+					_clack_prompts.cancel("Cancelled");
+					return;
+				}
+				selectedWorkspaces = workspaces.filter((w) => w.domain === selectedDomain);
+			} else selectedWorkspaces = workspaces;
+			const defaultDomain = selectedWorkspaces.length === 1 ? selectedWorkspaces[0].domain : domain;
+			require_auth_workspace_config.setWorkspaces(workspaces);
+			require_auth_workspace_config.setActiveWorkspace(defaultDomain);
+		} else {
+			const domainStr = domain;
+			require_auth_workspace_config.setWorkspaces([{
+				domain: domainStr,
+				display_name: domainStr,
+				bearer_token: "",
+				expiration_time: "",
+				api_base_url: `https://${domainStr}/`,
+				site_name: domainStr,
+				canonical_user_p: false,
+				starred_p: false
+			}]);
+			require_auth_workspace_config.setActiveWorkspace(domainStr);
+			this.log("Anonymous mode: only endpoints that do not require authentication are accessible.");
+			this.log("Run `twentythree auth credentials` again to add a bearer token.");
+		}
+		_clack_prompts.outro("Credentials saved");
+	}
+};
+//#endregion
+module.exports = Credentials;

package/dist/commands/auth/status.cjs

@@ -0,0 +1,34 @@
+const require_auth_workspace_config = require("../../auth/workspace-config.cjs");
+const require_lib_base_command = require("../../lib/base-command.cjs");
+//#region src/commands/auth/status.ts
+var Status = class extends require_lib_base_command.BaseCommand {
+	static description = "Show authentication status and active workspace";
+	static agentMetadata = {
+		api_endpoint: "local",
+		auth_scope: "none",
+		output_shape: { type: "key-value" },
+		side_effects: "none"
+	};
+	static examples = ["<%= config.bin %> auth status"];
+	static enableJsonFlag = true;
+	async run() {
+		this.printWorkspaceHeader();
+		const workspace = this.activeWorkspace;
+		const authMode = workspace.bearer_token ? "authenticated" : "anonymous (domain-only)";
+		const workspaceCount = require_auth_workspace_config.getWorkspaces().length;
+		this.log(`Domain:      ${workspace.domain}`);
+		this.log(`Display:     ${workspace.display_name}`);
+		this.log(`Auth mode:   ${authMode}`);
+		if (workspace.bearer_token) this.log(`Token:       active (auto-refreshes)`);
+		this.log(`Workspaces:  ${workspaceCount} configured`);
+		if (this.jsonEnabled()) return {
+			domain: workspace.domain,
+			display_name: workspace.display_name,
+			authMode,
+			expiration_time: workspace.expiration_time || null,
+			workspaceCount
+		};
+	}
+};
+//#endregion
+module.exports = Status;

package/dist/commands/category/create.cjs

@@ -0,0 +1,80 @@
+const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
+const require_lib_term_map = require("../../lib/term-map.cjs");
+const require_lib_base_command = require("../../lib/base-command.cjs");
+const require_lib_output = require("../../lib/output.cjs");
+let _oclif_core = require("@oclif/core");
+let chalk = require("chalk");
+chalk = require_runtime.__toESM(chalk);
+//#region src/commands/category/create.ts
+/**
+* Category create command — creates a new category in the active workspace.
+*
+* Maps to the /album/create API endpoint.
+* "album" is the API term; "category" is the CLI user-facing term (term-map.ts).
+*
+* Threat mitigations:
+*   T-04-04: extends AuthenticatedCommand — anonymous mode rejected
+*/
+var CategoryCreate = class CategoryCreate extends require_lib_base_command.AuthenticatedCommand {
+	static description = "Create a new category";
+	static agentMetadata = {
+		api_endpoint: "POST /album/create",
+		auth_scope: "write",
+		output_shape: { type: "none" },
+		side_effects: "creates"
+	};
+	static examples = [
+		"<%= config.bin %> category create --title \"My Category\"",
+		"<%= config.bin %> category create --title \"My Category\" --json",
+		"<%= config.bin %> category create --title \"Hidden Category\" --hidden"
+	];
+	static enableJsonFlag = true;
+	static flags = {
+		...require_lib_base_command.AuthenticatedCommand.baseFlags,
+		title: _oclif_core.Flags.string({
+			description: "Title for the new category",
+			required: true
+		}),
+		description: _oclif_core.Flags.string({
+			description: "Description for the new category",
+			required: false
+		}),
+		hidden: _oclif_core.Flags.boolean({
+			description: "Create as hidden category",
+			allowNo: true,
+			required: false
+		}),
+		"hide-p": _oclif_core.Flags.string({
+			hidden: true,
+			required: false
+		})
+	};
+	static args = {};
+	async run() {
+		const { flags } = await this.parse(CategoryCreate);
+		this.printWorkspaceHeader();
+		const body = { title: flags.title };
+		if (flags.description !== void 0) body.description = flags.description;
+		const hiddenVal = parseBoolParam(flags.hidden, flags["hide-p"]);
+		if (hiddenVal !== void 0) body.hide_p = hiddenVal ? 1 : 0;
+		const { data: createData, error: createError } = await this.apiClient.POST("/album/create", {
+			body,
+			headers: { "Content-Type": "application/x-www-form-urlencoded" }
+		});
+		if (createError) this.error(require_lib_term_map.applyCliTerms(formatApiError(createError)), { exit: 1 });
+		const albumId = createData?.data?.album_id;
+		this.log(chalk.default.green("Category created"));
+		this.log(`ID:    ${albumId}`);
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data: createData,
+			summary: "Category created",
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, {
+				resource: "category",
+				id: String(albumId)
+			}]
+		});
+	}
+};
+//#endregion
+module.exports = CategoryCreate;

package/dist/commands/category/delete.cjs

@@ -0,0 +1,70 @@
+const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
+const require_lib_term_map = require("../../lib/term-map.cjs");
+const require_lib_base_command = require("../../lib/base-command.cjs");
+const require_lib_output = require("../../lib/output.cjs");
+let _oclif_core = require("@oclif/core");
+let chalk = require("chalk");
+chalk = require_runtime.__toESM(chalk);
+let _clack_prompts = require("@clack/prompts");
+//#region src/commands/category/delete.ts
+/**
+* Category delete command — deletes a category after confirmation.
+*
+* Prompts user to confirm deletion showing the workspace domain so they know
+* which workspace they are deleting from (T-04-02 repudiation mitigation).
+*
+* --json flag skips the confirmation prompt (scripting mode — assume confirmed).
+*
+* Maps to the /album/delete API endpoint.
+* "album" is the API term; "category" is the CLI user-facing term (term-map.ts).
+*
+* Exit codes:
+*   0 — success
+*   1 — error (category not found, API error)
+*   2 — cancelled (user declined confirmation)
+*
+* Threat mitigations:
+*   T-04-02: Confirmation prompt includes workspace domain
+*   T-04-04: extends AuthenticatedCommand — anonymous mode rejected
+*/
+var CategoryDelete = class CategoryDelete extends require_lib_base_command.AuthenticatedCommand {
+	static description = "Delete a category from the active workspace";
+	static agentMetadata = {
+		api_endpoint: "POST /album/delete",
+		auth_scope: "write",
+		output_shape: { type: "none" },
+		side_effects: "destructive"
+	};
+	static examples = ["<%= config.bin %> category delete 42", "<%= config.bin %> category delete 42 --json"];
+	static enableJsonFlag = true;
+	static flags = { ...require_lib_base_command.AuthenticatedCommand.baseFlags };
+	static args = { id: _oclif_core.Args.string({
+		description: "Category ID",
+		required: true
+	}) };
+	async run() {
+		const { args } = await this.parse(CategoryDelete);
+		this.printWorkspaceHeader();
+		if (!this.jsonEnabled()) {
+			const confirmed = await (0, _clack_prompts.confirm)({ message: `Delete category ${args.id} from ${this.activeWorkspace.domain}? This cannot be undone.` });
+			if ((0, _clack_prompts.isCancel)(confirmed) || !confirmed) process.exit(2);
+		}
+		const { data: deleteData, error: deleteError } = await this.apiClient.POST("/album/delete", {
+			body: { album_id: Number(args.id) },
+			headers: { "Content-Type": "application/x-www-form-urlencoded" }
+		});
+		if (deleteError) this.error(require_lib_term_map.applyCliTerms(formatApiError(deleteError)), { exit: 1 });
+		this.log(chalk.default.green(`Category ${args.id} deleted`));
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data: deleteData,
+			summary: `Category ${args.id} deleted`,
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, {
+				resource: "category",
+				id: args.id
+			}]
+		});
+	}
+};
+//#endregion
+module.exports = CategoryDelete;

package/dist/commands/category/index.cjs

@@ -0,0 +1,11 @@
+require("../../_virtual/_rolldown/runtime.cjs");
+let _oclif_core = require("@oclif/core");
+//#region src/commands/category/index.ts
+var CategoryIndex = class extends _oclif_core.Command {
+	static description = "Manage categories — list, create, update, and delete";
+	async run() {
+		this.log("Run \"twentythree category --help\" for available commands");
+	}
+};
+//#endregion
+module.exports = CategoryIndex;

package/dist/commands/category/list.cjs

@@ -0,0 +1,98 @@
+const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
+const require_lib_term_map = require("../../lib/term-map.cjs");
+const require_lib_base_command = require("../../lib/base-command.cjs");
+const require_lib_output = require("../../lib/output.cjs");
+const require_lib_pagination = require("../../lib/pagination.cjs");
+let _oclif_core = require("@oclif/core");
+let chalk = require("chalk");
+chalk = require_runtime.__toESM(chalk);
+//#region src/commands/category/list.ts
+/**
+* Category list command — lists all categories in the active workspace with auto-pagination.
+* Renders a cli-table3 table with columns: ID, Title, Hidden, Created.
+* Supports --json output with { ok, data, summary, breadcrumbs } shape (CLI-01).
+*
+* Maps to the /album/list API endpoint.
+* "album" is the API term; "category" is the CLI user-facing term (term-map.ts).
+*
+* Threat mitigations:
+*   T-04-04: extends AuthenticatedCommand — anonymous mode rejected
+*/
+var CategoryList = class CategoryList extends require_lib_base_command.AuthenticatedCommand {
+	static description = "List categories in the active workspace";
+	static agentMetadata = {
+		api_endpoint: "GET /album/list",
+		auth_scope: "anonymous",
+		output_shape: {
+			type: "table",
+			columns: [
+				"ID",
+				"Title",
+				"Hidden",
+				"Created"
+			]
+		},
+		side_effects: "none"
+	};
+	static examples = [
+		"<%= config.bin %> category list",
+		"<%= config.bin %> category list --json",
+		"<%= config.bin %> category list --include-hidden"
+	];
+	static enableJsonFlag = true;
+	static flags = {
+		...require_lib_base_command.AuthenticatedCommand.baseFlags,
+		"include-hidden": _oclif_core.Flags.boolean({
+			description: "Include hidden categories in the results",
+			allowNo: true,
+			required: false
+		}),
+		"include-hidden-p": _oclif_core.Flags.string({
+			hidden: true,
+			required: false
+		})
+	};
+	static args = {};
+	async run() {
+		const { flags } = await this.parse(CategoryList);
+		this.printWorkspaceHeader();
+		const categories = await require_lib_pagination.fetchAllPages(async (page, size) => {
+			const { data, error } = await this.apiClient.GET("/album/list", { params: { query: {
+				p: page,
+				size,
+				include_hidden_p: parseBoolParam(flags["include-hidden"], flags["include-hidden-p"]) ?? void 0
+			} } });
+			if (error) this.error(require_lib_term_map.applyCliTerms(formatApiError(error)), { exit: 1 });
+			const resp = data;
+			return {
+				data: Array.isArray(resp?.data) ? resp.data : resp?.data ? [resp.data] : [],
+				total_count: resp?.total_count
+			};
+		});
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data: categories,
+			summary: `${categories.length} categor${categories.length === 1 ? "y" : "ies"}`,
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, { resource: "category" }]
+		});
+		if (categories.length === 0) {
+			this.log("No categories found.");
+			return;
+		}
+		const table = require_lib_output.renderTable([
+			"ID",
+			"Title",
+			"Hidden",
+			"Created"
+		], categories.map((c) => [
+			String(c.album_id ?? ""),
+			require_lib_term_map.applyCliTerms(String(c.title ?? "")),
+			c.hide_p ? "yes" : "no",
+			String(c.creation_date_ansi ?? "")
+		]));
+		this.log(table.toString());
+		this.log(chalk.default.dim(`${categories.length} categor${categories.length === 1 ? "y" : "ies"}`));
+	}
+};
+//#endregion
+module.exports = CategoryList;