twentythree-cli 1.0.0

package/dist/commands/analytics/usage/locations/totals.cjs

@@ -0,0 +1,83 @@
+const require_runtime = require("../../../../_virtual/_rolldown/runtime.cjs");
+const require_lib_term_map = require("../../../../lib/term-map.cjs");
+const require_lib_analytics_flags = require("../../../../lib/analytics-flags.cjs");
+const require_lib_base_command = require("../../../../lib/base-command.cjs");
+const require_lib_output = require("../../../../lib/output.cjs");
+let chalk = require("chalk");
+chalk = require_runtime.__toESM(chalk);
+//#region src/commands/analytics/usage/locations/totals.ts
+/**
+* Analytics usage locations totals command — returns aggregated usage analytics by location.
+*
+* Uses GET /analytics/data/usage/locations/totals.
+* No pagination — the totals endpoint does not support p/size.
+*/
+var AnalyticsUsageLocationsTotals = class AnalyticsUsageLocationsTotals extends require_lib_base_command.AuthenticatedCommand {
+	static description = "Get aggregated usage analytics by location - totals";
+	static examples = [
+		"<%= config.bin %> analytics usage locations totals --date-expression thismonth",
+		"<%= config.bin %> analytics usage locations totals --date-start 2024-01-01 --date-end 2024-01-31",
+		"<%= config.bin %> analytics usage locations totals --json"
+	];
+	static enableJsonFlag = true;
+	static agentMetadata = {
+		api_endpoint: "GET /analytics/data/usage/locations/totals",
+		auth_scope: "read",
+		output_shape: {
+			type: "table",
+			columns: [
+				"Location",
+				"Plays",
+				"Engagement",
+				"Traffic"
+			]
+		},
+		side_effects: "none"
+	};
+	static flags = {
+		...require_lib_base_command.AuthenticatedCommand.baseFlags,
+		...require_lib_analytics_flags.ANALYTICS_DATE_FLAGS,
+		...require_lib_analytics_flags.ANALYTICS_FILTER_FLAGS
+	};
+	async run() {
+		const { flags } = await this.parse(AnalyticsUsageLocationsTotals);
+		this.printWorkspaceHeader();
+		const { data, error } = await this.apiClient.GET("/analytics/data/usage/locations/totals", { params: { query: {
+			date_start: flags["date-start"],
+			date_end: flags["date-end"],
+			date_expression: flags["date-expression"],
+			selection: flags.selection,
+			groupby: flags.groupby,
+			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} row(s)`,
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, { resource: "analytics" }]
+		});
+		if (rows.length === 0) {
+			this.log("No data found.");
+			return;
+		}
+		const table = require_lib_output.renderTable([
+			"Location",
+			"Plays",
+			"Engagement",
+			"Traffic"
+		], rows.map((row) => [
+			String(row.location ?? ""),
+			String(row.plays ?? ""),
+			String(row.engagement ?? ""),
+			String(row.traffic ?? "")
+		]));
+		this.log(table.toString());
+		this.log(chalk.default.dim(`${rows.length} row(s)`));
+	}
+};
+//#endregion
+module.exports = AnalyticsUsageLocationsTotals;

package/dist/commands/analytics/usage/locations.cjs

@@ -0,0 +1,89 @@
+const require_runtime = require("../../../_virtual/_rolldown/runtime.cjs");
+const require_lib_term_map = require("../../../lib/term-map.cjs");
+const require_lib_analytics_flags = require("../../../lib/analytics-flags.cjs");
+const require_lib_base_command = require("../../../lib/base-command.cjs");
+const require_lib_output = require("../../../lib/output.cjs");
+let chalk = require("chalk");
+chalk = require_runtime.__toESM(chalk);
+//#region src/commands/analytics/usage/locations.ts
+/**
+* Analytics usage locations command — returns usage analytics broken down by location.
+*
+* Uses GET /analytics/data/usage/locations.
+* Supports pagination via p/size query params.
+*/
+var AnalyticsUsageLocations = class AnalyticsUsageLocations extends require_lib_base_command.AuthenticatedCommand {
+	static description = "Get usage analytics by location";
+	static examples = [
+		"<%= config.bin %> analytics usage locations --date-expression thismonth",
+		"<%= config.bin %> analytics usage locations --date-start 2024-01-01 --date-end 2024-01-31 --page 1 --size 20",
+		"<%= config.bin %> analytics usage locations --json"
+	];
+	static enableJsonFlag = true;
+	static agentMetadata = {
+		api_endpoint: "GET /analytics/data/usage/locations",
+		auth_scope: "read",
+		output_shape: {
+			type: "table",
+			columns: [
+				"Location",
+				"Plays",
+				"Engagement",
+				"Traffic",
+				"Impressions"
+			]
+		},
+		side_effects: "none"
+	};
+	static flags = {
+		...require_lib_base_command.AuthenticatedCommand.baseFlags,
+		...require_lib_analytics_flags.ANALYTICS_DATE_FLAGS,
+		...require_lib_analytics_flags.ANALYTICS_PAGINATION_FLAGS,
+		...require_lib_analytics_flags.ANALYTICS_FILTER_FLAGS
+	};
+	async run() {
+		const { flags } = await this.parse(AnalyticsUsageLocations);
+		this.printWorkspaceHeader();
+		const { data, error } = await this.apiClient.GET("/analytics/data/usage/locations", { params: { query: {
+			date_start: flags["date-start"],
+			date_end: flags["date-end"],
+			date_expression: flags["date-expression"],
+			selection: flags.selection,
+			groupby: flags.groupby,
+			orderby: flags.orderby,
+			order: flags.order,
+			p: flags.page,
+			size: flags.size
+		} } });
+		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} row(s)`,
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, { resource: "analytics" }]
+		});
+		if (rows.length === 0) {
+			this.log("No data found.");
+			return;
+		}
+		const table = require_lib_output.renderTable([
+			"Location",
+			"Plays",
+			"Engagement",
+			"Traffic",
+			"Impressions"
+		], rows.map((row) => [
+			String(row.location ?? row.country ?? ""),
+			String(row.plays ?? ""),
+			String(row.engagement ?? ""),
+			String(row.traffic ?? ""),
+			String(row.impressions ?? "")
+		]));
+		this.log(table.toString());
+		this.log(chalk.default.dim(`${rows.length} row(s)`));
+	}
+};
+//#endregion
+module.exports = AnalyticsUsageLocations;

package/dist/commands/analytics/usage/sourceids/totals.cjs

@@ -0,0 +1,83 @@
+const require_runtime = require("../../../../_virtual/_rolldown/runtime.cjs");
+const require_lib_term_map = require("../../../../lib/term-map.cjs");
+const require_lib_analytics_flags = require("../../../../lib/analytics-flags.cjs");
+const require_lib_base_command = require("../../../../lib/base-command.cjs");
+const require_lib_output = require("../../../../lib/output.cjs");
+let chalk = require("chalk");
+chalk = require_runtime.__toESM(chalk);
+//#region src/commands/analytics/usage/sourceids/totals.ts
+/**
+* Analytics usage sourceids totals command — returns aggregated usage analytics by source ID.
+*
+* Uses GET /analytics/data/usage/sourceids/totals.
+* No pagination — the totals endpoint does not support p/size.
+*/
+var AnalyticsUsageSourceidsTotals = class AnalyticsUsageSourceidsTotals extends require_lib_base_command.AuthenticatedCommand {
+	static description = "Get aggregated usage analytics by source ID - totals";
+	static examples = [
+		"<%= config.bin %> analytics usage sourceids totals --date-expression thismonth",
+		"<%= config.bin %> analytics usage sourceids totals --date-start 2024-01-01 --date-end 2024-01-31",
+		"<%= config.bin %> analytics usage sourceids totals --json"
+	];
+	static enableJsonFlag = true;
+	static agentMetadata = {
+		api_endpoint: "GET /analytics/data/usage/sourceids/totals",
+		auth_scope: "read",
+		output_shape: {
+			type: "table",
+			columns: [
+				"Source ID",
+				"Plays",
+				"Engagement",
+				"Traffic"
+			]
+		},
+		side_effects: "none"
+	};
+	static flags = {
+		...require_lib_base_command.AuthenticatedCommand.baseFlags,
+		...require_lib_analytics_flags.ANALYTICS_DATE_FLAGS,
+		...require_lib_analytics_flags.ANALYTICS_FILTER_FLAGS
+	};
+	async run() {
+		const { flags } = await this.parse(AnalyticsUsageSourceidsTotals);
+		this.printWorkspaceHeader();
+		const { data, error } = await this.apiClient.GET("/analytics/data/usage/sourceids/totals", { params: { query: {
+			date_start: flags["date-start"],
+			date_end: flags["date-end"],
+			date_expression: flags["date-expression"],
+			selection: flags.selection,
+			groupby: flags.groupby,
+			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} row(s)`,
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, { resource: "analytics" }]
+		});
+		if (rows.length === 0) {
+			this.log("No data found.");
+			return;
+		}
+		const table = require_lib_output.renderTable([
+			"Source ID",
+			"Plays",
+			"Engagement",
+			"Traffic"
+		], rows.map((row) => [
+			String(row.sourceid ?? ""),
+			String(row.plays ?? ""),
+			String(row.engagement ?? ""),
+			String(row.traffic ?? "")
+		]));
+		this.log(table.toString());
+		this.log(chalk.default.dim(`${rows.length} row(s)`));
+	}
+};
+//#endregion
+module.exports = AnalyticsUsageSourceidsTotals;

package/dist/commands/analytics/usage/sourceids.cjs

@@ -0,0 +1,89 @@
+const require_runtime = require("../../../_virtual/_rolldown/runtime.cjs");
+const require_lib_term_map = require("../../../lib/term-map.cjs");
+const require_lib_analytics_flags = require("../../../lib/analytics-flags.cjs");
+const require_lib_base_command = require("../../../lib/base-command.cjs");
+const require_lib_output = require("../../../lib/output.cjs");
+let chalk = require("chalk");
+chalk = require_runtime.__toESM(chalk);
+//#region src/commands/analytics/usage/sourceids.ts
+/**
+* Analytics usage sourceids command — returns usage analytics broken down by source ID.
+*
+* Uses GET /analytics/data/usage/sourceids.
+* Supports pagination via p/size query params.
+*/
+var AnalyticsUsageSourceids = class AnalyticsUsageSourceids extends require_lib_base_command.AuthenticatedCommand {
+	static description = "Get usage analytics by source ID";
+	static examples = [
+		"<%= config.bin %> analytics usage sourceids --date-expression thismonth",
+		"<%= config.bin %> analytics usage sourceids --date-start 2024-01-01 --date-end 2024-01-31 --page 1 --size 20",
+		"<%= config.bin %> analytics usage sourceids --json"
+	];
+	static enableJsonFlag = true;
+	static agentMetadata = {
+		api_endpoint: "GET /analytics/data/usage/sourceids",
+		auth_scope: "read",
+		output_shape: {
+			type: "table",
+			columns: [
+				"Source ID",
+				"Plays",
+				"Engagement",
+				"Traffic",
+				"Impressions"
+			]
+		},
+		side_effects: "none"
+	};
+	static flags = {
+		...require_lib_base_command.AuthenticatedCommand.baseFlags,
+		...require_lib_analytics_flags.ANALYTICS_DATE_FLAGS,
+		...require_lib_analytics_flags.ANALYTICS_PAGINATION_FLAGS,
+		...require_lib_analytics_flags.ANALYTICS_FILTER_FLAGS
+	};
+	async run() {
+		const { flags } = await this.parse(AnalyticsUsageSourceids);
+		this.printWorkspaceHeader();
+		const { data, error } = await this.apiClient.GET("/analytics/data/usage/sourceids", { params: { query: {
+			date_start: flags["date-start"],
+			date_end: flags["date-end"],
+			date_expression: flags["date-expression"],
+			selection: flags.selection,
+			groupby: flags.groupby,
+			orderby: flags.orderby,
+			order: flags.order,
+			p: flags.page,
+			size: flags.size
+		} } });
+		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} row(s)`,
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, { resource: "analytics" }]
+		});
+		if (rows.length === 0) {
+			this.log("No data found.");
+			return;
+		}
+		const table = require_lib_output.renderTable([
+			"Source ID",
+			"Plays",
+			"Engagement",
+			"Traffic",
+			"Impressions"
+		], rows.map((row) => [
+			String(row.source_id ?? row.sourceid ?? ""),
+			String(row.plays ?? ""),
+			String(row.engagement ?? ""),
+			String(row.traffic ?? ""),
+			String(row.impressions ?? "")
+		]));
+		this.log(table.toString());
+		this.log(chalk.default.dim(`${rows.length} row(s)`));
+	}
+};
+//#endregion
+module.exports = AnalyticsUsageSourceids;

package/dist/commands/analytics/usage/sources/totals.cjs

@@ -0,0 +1,83 @@
+const require_runtime = require("../../../../_virtual/_rolldown/runtime.cjs");
+const require_lib_term_map = require("../../../../lib/term-map.cjs");
+const require_lib_analytics_flags = require("../../../../lib/analytics-flags.cjs");
+const require_lib_base_command = require("../../../../lib/base-command.cjs");
+const require_lib_output = require("../../../../lib/output.cjs");
+let chalk = require("chalk");
+chalk = require_runtime.__toESM(chalk);
+//#region src/commands/analytics/usage/sources/totals.ts
+/**
+* Analytics usage sources totals command — returns aggregated usage analytics by source.
+*
+* Uses GET /analytics/data/usage/sources/totals.
+* No pagination — the totals endpoint does not support p/size.
+*/
+var AnalyticsUsageSourcesTotals = class AnalyticsUsageSourcesTotals extends require_lib_base_command.AuthenticatedCommand {
+	static description = "Get aggregated usage analytics by source - totals";
+	static examples = [
+		"<%= config.bin %> analytics usage sources totals --date-expression thismonth",
+		"<%= config.bin %> analytics usage sources totals --date-start 2024-01-01 --date-end 2024-01-31",
+		"<%= config.bin %> analytics usage sources totals --json"
+	];
+	static enableJsonFlag = true;
+	static agentMetadata = {
+		api_endpoint: "GET /analytics/data/usage/sources/totals",
+		auth_scope: "read",
+		output_shape: {
+			type: "table",
+			columns: [
+				"Source",
+				"Plays",
+				"Engagement",
+				"Traffic"
+			]
+		},
+		side_effects: "none"
+	};
+	static flags = {
+		...require_lib_base_command.AuthenticatedCommand.baseFlags,
+		...require_lib_analytics_flags.ANALYTICS_DATE_FLAGS,
+		...require_lib_analytics_flags.ANALYTICS_FILTER_FLAGS
+	};
+	async run() {
+		const { flags } = await this.parse(AnalyticsUsageSourcesTotals);
+		this.printWorkspaceHeader();
+		const { data, error } = await this.apiClient.GET("/analytics/data/usage/sources/totals", { params: { query: {
+			date_start: flags["date-start"],
+			date_end: flags["date-end"],
+			date_expression: flags["date-expression"],
+			selection: flags.selection,
+			groupby: flags.groupby,
+			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} row(s)`,
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, { resource: "analytics" }]
+		});
+		if (rows.length === 0) {
+			this.log("No data found.");
+			return;
+		}
+		const table = require_lib_output.renderTable([
+			"Source",
+			"Plays",
+			"Engagement",
+			"Traffic"
+		], rows.map((row) => [
+			String(row.source ?? ""),
+			String(row.plays ?? ""),
+			String(row.engagement ?? ""),
+			String(row.traffic ?? "")
+		]));
+		this.log(table.toString());
+		this.log(chalk.default.dim(`${rows.length} row(s)`));
+	}
+};
+//#endregion
+module.exports = AnalyticsUsageSourcesTotals;

package/dist/commands/analytics/usage/sources.cjs

@@ -0,0 +1,89 @@
+const require_runtime = require("../../../_virtual/_rolldown/runtime.cjs");
+const require_lib_term_map = require("../../../lib/term-map.cjs");
+const require_lib_analytics_flags = require("../../../lib/analytics-flags.cjs");
+const require_lib_base_command = require("../../../lib/base-command.cjs");
+const require_lib_output = require("../../../lib/output.cjs");
+let chalk = require("chalk");
+chalk = require_runtime.__toESM(chalk);
+//#region src/commands/analytics/usage/sources.ts
+/**
+* Analytics usage sources command — returns usage analytics broken down by traffic source.
+*
+* Uses GET /analytics/data/usage/sources.
+* Supports pagination via p/size query params.
+*/
+var AnalyticsUsageSources = class AnalyticsUsageSources extends require_lib_base_command.AuthenticatedCommand {
+	static description = "Get usage analytics by traffic source";
+	static examples = [
+		"<%= config.bin %> analytics usage sources --date-expression thismonth",
+		"<%= config.bin %> analytics usage sources --date-start 2024-01-01 --date-end 2024-01-31 --page 1 --size 20",
+		"<%= config.bin %> analytics usage sources --json"
+	];
+	static enableJsonFlag = true;
+	static agentMetadata = {
+		api_endpoint: "GET /analytics/data/usage/sources",
+		auth_scope: "read",
+		output_shape: {
+			type: "table",
+			columns: [
+				"Source",
+				"Plays",
+				"Engagement",
+				"Traffic",
+				"Impressions"
+			]
+		},
+		side_effects: "none"
+	};
+	static flags = {
+		...require_lib_base_command.AuthenticatedCommand.baseFlags,
+		...require_lib_analytics_flags.ANALYTICS_DATE_FLAGS,
+		...require_lib_analytics_flags.ANALYTICS_PAGINATION_FLAGS,
+		...require_lib_analytics_flags.ANALYTICS_FILTER_FLAGS
+	};
+	async run() {
+		const { flags } = await this.parse(AnalyticsUsageSources);
+		this.printWorkspaceHeader();
+		const { data, error } = await this.apiClient.GET("/analytics/data/usage/sources", { params: { query: {
+			date_start: flags["date-start"],
+			date_end: flags["date-end"],
+			date_expression: flags["date-expression"],
+			selection: flags.selection,
+			groupby: flags.groupby,
+			orderby: flags.orderby,
+			order: flags.order,
+			p: flags.page,
+			size: flags.size
+		} } });
+		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} row(s)`,
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, { resource: "analytics" }]
+		});
+		if (rows.length === 0) {
+			this.log("No data found.");
+			return;
+		}
+		const table = require_lib_output.renderTable([
+			"Source",
+			"Plays",
+			"Engagement",
+			"Traffic",
+			"Impressions"
+		], rows.map((row) => [
+			String(row.source ?? ""),
+			String(row.plays ?? ""),
+			String(row.engagement ?? ""),
+			String(row.traffic ?? ""),
+			String(row.impressions ?? "")
+		]));
+		this.log(table.toString());
+		this.log(chalk.default.dim(`${rows.length} row(s)`));
+	}
+};
+//#endregion
+module.exports = AnalyticsUsageSources;

package/dist/commands/analytics/usage/spots/timeseries.cjs

@@ -0,0 +1,83 @@
+const require_runtime = require("../../../../_virtual/_rolldown/runtime.cjs");
+const require_lib_term_map = require("../../../../lib/term-map.cjs");
+const require_lib_analytics_flags = require("../../../../lib/analytics-flags.cjs");
+const require_lib_base_command = require("../../../../lib/base-command.cjs");
+const require_lib_output = require("../../../../lib/output.cjs");
+let chalk = require("chalk");
+chalk = require_runtime.__toESM(chalk);
+//#region src/commands/analytics/usage/spots/timeseries.ts
+/**
+* Analytics usage spots timeseries command — returns spot usage analytics time series data.
+*
+* Uses GET /analytics/data/usage/spots/timeseries.
+* No pagination — the timeseries endpoint does not support p/size.
+*/
+var AnalyticsUsageSpotsTimeseries = class AnalyticsUsageSpotsTimeseries extends require_lib_base_command.AuthenticatedCommand {
+	static description = "Get spot usage analytics - time series";
+	static examples = [
+		"<%= config.bin %> analytics usage spots timeseries --date-expression thisweek",
+		"<%= config.bin %> analytics usage spots timeseries --date-start 2024-01-01 --date-end 2024-01-31",
+		"<%= config.bin %> analytics usage spots timeseries --json"
+	];
+	static enableJsonFlag = true;
+	static agentMetadata = {
+		api_endpoint: "GET /analytics/data/usage/spots/timeseries",
+		auth_scope: "read",
+		output_shape: {
+			type: "table",
+			columns: [
+				"Date",
+				"Spot",
+				"Plays",
+				"Engagement"
+			]
+		},
+		side_effects: "none"
+	};
+	static flags = {
+		...require_lib_base_command.AuthenticatedCommand.baseFlags,
+		...require_lib_analytics_flags.ANALYTICS_DATE_FLAGS,
+		...require_lib_analytics_flags.ANALYTICS_FILTER_FLAGS
+	};
+	async run() {
+		const { flags } = await this.parse(AnalyticsUsageSpotsTimeseries);
+		this.printWorkspaceHeader();
+		const { data, error } = await this.apiClient.GET("/analytics/data/usage/spots/timeseries", { params: { query: {
+			date_start: flags["date-start"],
+			date_end: flags["date-end"],
+			date_expression: flags["date-expression"],
+			selection: flags.selection,
+			groupby: flags.groupby,
+			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} row(s)`,
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, { resource: "analytics" }]
+		});
+		if (rows.length === 0) {
+			this.log("No data found.");
+			return;
+		}
+		const table = require_lib_output.renderTable([
+			"Date",
+			"Spot",
+			"Plays",
+			"Engagement"
+		], rows.map((row) => [
+			String(row.date ?? ""),
+			String(row.spot ?? ""),
+			String(row.plays ?? ""),
+			String(row.engagement ?? "")
+		]));
+		this.log(table.toString());
+		this.log(chalk.default.dim(`${rows.length} row(s)`));
+	}
+};
+//#endregion
+module.exports = AnalyticsUsageSpotsTimeseries;

package/dist/commands/analytics/usage/spots/totals.cjs

@@ -0,0 +1,83 @@
+const require_runtime = require("../../../../_virtual/_rolldown/runtime.cjs");
+const require_lib_term_map = require("../../../../lib/term-map.cjs");
+const require_lib_analytics_flags = require("../../../../lib/analytics-flags.cjs");
+const require_lib_base_command = require("../../../../lib/base-command.cjs");
+const require_lib_output = require("../../../../lib/output.cjs");
+let chalk = require("chalk");
+chalk = require_runtime.__toESM(chalk);
+//#region src/commands/analytics/usage/spots/totals.ts
+/**
+* Analytics usage spots totals command — returns aggregated spot usage analytics.
+*
+* Uses GET /analytics/data/usage/spots/totals.
+* No pagination — the totals endpoint does not support p/size.
+*/
+var AnalyticsUsageSpotsTotals = class AnalyticsUsageSpotsTotals extends require_lib_base_command.AuthenticatedCommand {
+	static description = "Get aggregated spot usage analytics - totals";
+	static examples = [
+		"<%= config.bin %> analytics usage spots totals --date-expression thismonth",
+		"<%= config.bin %> analytics usage spots totals --date-start 2024-01-01 --date-end 2024-01-31",
+		"<%= config.bin %> analytics usage spots totals --json"
+	];
+	static enableJsonFlag = true;
+	static agentMetadata = {
+		api_endpoint: "GET /analytics/data/usage/spots/totals",
+		auth_scope: "read",
+		output_shape: {
+			type: "table",
+			columns: [
+				"Spot",
+				"Plays",
+				"Engagement",
+				"Traffic"
+			]
+		},
+		side_effects: "none"
+	};
+	static flags = {
+		...require_lib_base_command.AuthenticatedCommand.baseFlags,
+		...require_lib_analytics_flags.ANALYTICS_DATE_FLAGS,
+		...require_lib_analytics_flags.ANALYTICS_FILTER_FLAGS
+	};
+	async run() {
+		const { flags } = await this.parse(AnalyticsUsageSpotsTotals);
+		this.printWorkspaceHeader();
+		const { data, error } = await this.apiClient.GET("/analytics/data/usage/spots/totals", { params: { query: {
+			date_start: flags["date-start"],
+			date_end: flags["date-end"],
+			date_expression: flags["date-expression"],
+			selection: flags.selection,
+			groupby: flags.groupby,
+			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} row(s)`,
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, { resource: "analytics" }]
+		});
+		if (rows.length === 0) {
+			this.log("No data found.");
+			return;
+		}
+		const table = require_lib_output.renderTable([
+			"Spot",
+			"Plays",
+			"Engagement",
+			"Traffic"
+		], rows.map((row) => [
+			String(row.spot ?? ""),
+			String(row.plays ?? ""),
+			String(row.engagement ?? ""),
+			String(row.traffic ?? "")
+		]));
+		this.log(table.toString());
+		this.log(chalk.default.dim(`${rows.length} row(s)`));
+	}
+};
+//#endregion
+module.exports = AnalyticsUsageSpotsTotals;