polyv-live-cli 1.2.12 → 1.2.14

package/dist/commands/statistics.commands.export.js

@@ -0,0 +1,232 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateOutputFormat = validateOutputFormat;
+exports.validateDateTimeFormat = validateDateTimeFormat;
+exports.validateWatchType = validateWatchType;
+exports.validateSameMonth = validateSameMonth;
+exports.registerStatisticsExportCommands = registerStatisticsExportCommands;
+const statistics_handler_1 = require("../handlers/statistics.handler");
+const manager_1 = require("../config/manager");
+const auth_adapter_1 = require("../config/auth-adapter");
+const errors_1 = require("../utils/errors");
+async function loadAuthAndServiceConfig(parentOptions) {
+    const authResult = auth_adapter_1.authAdapter.tryGetAuthConfig(parentOptions);
+    if (!authResult) {
+        throw new Error(auth_adapter_1.authAdapter.getStatusMessage(parentOptions));
+    }
+    let configResult;
+    try {
+        configResult = await manager_1.configManager.load({
+            cliOptions: parentOptions,
+        });
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.includes('Auth configuration is incomplete')) {
+            configResult = {
+                config: {
+                    baseUrl: 'https://api.polyv.net',
+                    timeout: 30000,
+                    debug: false
+                }
+            };
+        }
+        else {
+            throw error;
+        }
+    }
+    const serviceConfig = {
+        baseUrl: configResult.config.baseUrl,
+        timeout: configResult.config.timeout,
+        debug: configResult.config.debug
+    };
+    const isVerbose = !!parentOptions.verbose;
+    if (isVerbose) {
+        console.log(`Authentication Source: ${authResult.source}`);
+        if (authResult.accountName) {
+            console.log(`Account: ${authResult.accountName}`);
+        }
+        console.log('');
+    }
+    const result = {
+        authConfig: authResult.config,
+        serviceConfig,
+        isVerbose,
+    };
+    if (authResult.source) {
+        result.authSource = authResult.source;
+    }
+    if (authResult.accountName) {
+        result.accountName = authResult.accountName;
+    }
+    return result;
+}
+function validateOutputFormat(value) {
+    if (!['table', 'json'].includes(value)) {
+        throw new Error('Output format must be either "table" or "json"');
+    }
+    return value;
+}
+function validateDateTimeFormat(value) {
+    const regex = /^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$/;
+    if (!regex.test(value)) {
+        throw new Error('DateTime format must be yyyy-MM-dd HH:mm:ss');
+    }
+    const date = new Date(value);
+    if (isNaN(date.getTime())) {
+        throw new Error(`Invalid datetime: ${value}`);
+    }
+    return value;
+}
+function validateWatchType(value) {
+    if (!['live', 'vod'].includes(value)) {
+        throw new Error('watchType must be either "live" or "vod"');
+    }
+    return value;
+}
+function validateSameMonth(startDate, endDate) {
+    const startMonth = startDate.substring(0, 7);
+    const endMonth = endDate.substring(0, 7);
+    if (startMonth !== endMonth) {
+        throw new Error('startDate and endDate must be in the same month');
+    }
+}
+function registerStatisticsExportCommands(program) {
+    const statisticsCmd = program.commands.find((cmd) => cmd.name() === 'statistics');
+    if (!statisticsCmd) {
+        return;
+    }
+    const exportCmd = statisticsCmd.command('export');
+    exportCmd.description('export statistics data');
+    const viewlogCmd = exportCmd
+        .command('viewlog')
+        .description('Export channel viewlog (观看日志) data')
+        .requiredOption('-c, --channel-id <channelId>', 'Channel ID')
+        .requiredOption('--start-time <datetime>', 'Start time (yyyy-MM-dd HH:mm:ss)', validateDateTimeFormat)
+        .requiredOption('--end-time <datetime>', 'End time (yyyy-MM-dd HH:mm:ss)', validateDateTimeFormat)
+        .option('--watch-type <type>', 'Watch type filter (live or vod)', validateWatchType)
+        .option('-o, --output <format>', 'Output format (table or json)', validateOutputFormat, 'table')
+        .option('--output-file <path>', 'Output CSV file path for export')
+        .action(async (options) => {
+        try {
+            validateSameMonth(options.startTime, options.endTime);
+            const parentOptions = program.opts();
+            const { authConfig, serviceConfig } = await loadAuthAndServiceConfig(parentOptions);
+            const statisticsHandler = new statistics_handler_1.StatisticsHandler(authConfig, serviceConfig);
+            const viewlogOptions = {
+                channelId: options.channelId,
+                startTime: options.startTime,
+                endTime: options.endTime,
+                output: options.output,
+            };
+            if (options.watchType) {
+                viewlogOptions.watchType = options.watchType;
+            }
+            if (options.outputFile) {
+                viewlogOptions.outputFile = options.outputFile;
+            }
+            await statisticsHandler.exportViewlog(viewlogOptions);
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes('Authentication')) {
+                const diagnostics = auth_adapter_1.authAdapter.getDiagnostics(program.opts());
+                console.error('\nAuthentication Diagnostics:');
+                diagnostics.availableSources.forEach(source => {
+                    const status = source.appId && source.appSecret ? 'OK' : 'X';
+                    console.error(`  ${status} ${source.metadata.source}: ${source.type}`);
+                });
+                if (diagnostics.errors.length > 0) {
+                    console.error('\nErrors:');
+                    diagnostics.errors.forEach(err => console.error(`  - ${err}`));
+                }
+            }
+            (0, errors_1.logError)(error instanceof Error ? error : new Error(String(error)));
+            process.exit(1);
+        }
+    });
+    viewlogCmd.addHelpText('after', `
+Examples:
+  # Export viewlog data for a channel
+  $ polyv-live-cli statistics export viewlog -c "3151318" --start-time "2024-01-01 00:00:00" --end-time "2024-01-31 23:59:59"
+
+  # Export with watch type filter
+  $ polyv-live-cli statistics export viewlog -c "3151318" --start-time "2024-01-01 00:00:00" --end-time "2024-01-31 23:59:59" --watch-type live
+
+  # Export to CSV file
+  $ polyv-live-cli statistics export viewlog -c "3151318" --start-time "2024-01-01 00:00:00" --end-time "2024-01-31 23:59:59" --output-file ./viewlog.csv
+
+  # Output in JSON format
+  $ polyv-live-cli statistics export viewlog -c "3151318" --start-time "2024-01-01 00:00:00" --end-time "2024-01-31 23:59:59" --output json
+
+DateTime Format:
+  --start-time    Start time in yyyy-MM-dd HH:mm:ss format (required)
+  --end-time      End time in yyyy-MM-dd HH:mm:ss format (required)
+                 Note: Start and end time must be in the same month
+
+Watch Types:
+  live            Live streaming
+  vod             Video on demand (playback)
+
+Output Formats:
+  table           Formatted table output (default)
+  json            JSON format for programmatic use
+
+Output Options:
+  --output-file   Path to save CSV file with Chinese headers
+`);
+    const sessionCmd = exportCmd
+        .command('session')
+        .description('Export channel session statistics report - 场次报表 (returns download link)')
+        .requiredOption('-c, --channel-id <channelId>', 'Channel ID')
+        .requiredOption('--session-id <sessionId>', 'Session ID')
+        .option('-o, --output <format>', 'Output format (table or json)', validateOutputFormat, 'table')
+        .action(async (options) => {
+        try {
+            const parentOptions = program.opts();
+            const { authConfig, serviceConfig } = await loadAuthAndServiceConfig(parentOptions);
+            const statisticsHandler = new statistics_handler_1.StatisticsHandler(authConfig, serviceConfig);
+            const sessionOptions = {
+                channelId: options.channelId,
+                sessionId: options.sessionId,
+                output: options.output,
+            };
+            await statisticsHandler.exportSessionStats(sessionOptions);
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes('Authentication')) {
+                const diagnostics = auth_adapter_1.authAdapter.getDiagnostics(program.opts());
+                console.error('\nAuthentication Diagnostics:');
+                diagnostics.availableSources.forEach(source => {
+                    const status = source.appId && source.appSecret ? '[OK]' : '[FAIL]';
+                    console.error(`  ${status} ${source.metadata.source}: ${source.type}`);
+                });
+                if (diagnostics.errors.length > 0) {
+                    console.error('\nErrors:');
+                    diagnostics.errors.forEach(err => console.error(`  - ${err}`));
+                }
+            }
+            (0, errors_1.logError)(error instanceof Error ? error : new Error(String(error)));
+            process.exit(1);
+        }
+    });
+    sessionCmd.addHelpText('after', `
+Examples:
+  # Export session statistics report
+  $ polyv-live-cli statistics export session -c "3151318" --session-id "fv3ma84e63"
+
+  # Output in JSON format
+  $ polyv-live-cli statistics export session -c "3151318" --session-id "fv3ma84e63" --output json
+
+Parameters:
+  --channel-id    Channel ID (required)
+  --session-id     Session ID (required)
+
+Output Formats:
+  table            Formatted table output (default)
+  json             JSON format for programmatic use
+
+Notes:
+  - Returns a download URL for the session report
+  - Download link is valid for 60 days
+`);
+}
+//# sourceMappingURL=statistics.commands.export.js.map

package/dist/commands/statistics.commands.export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statistics.commands.export.js","sourceRoot":"","sources":["../../src/commands/statistics.commands.export.ts"],"names":[],"mappings":"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"}

package/dist/commands/statistics.commands.js

@@ -0,0 +1,401 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateOutputFormat = validateOutputFormat;
+exports.validateDateFormat = validateDateFormat;
+exports.validateDateRange = validateDateRange;
+exports.registerStatisticsCommands = registerStatisticsCommands;
+const statistics_handler_1 = require("../handlers/statistics.handler");
+const manager_1 = require("../config/manager");
+const auth_adapter_1 = require("../config/auth-adapter");
+const errors_1 = require("../utils/errors");
+const date_validation_1 = require("../utils/date-validation");
+async function loadAuthAndServiceConfig(parentOptions) {
+    const authResult = auth_adapter_1.authAdapter.tryGetAuthConfig(parentOptions);
+    if (!authResult) {
+        throw new Error(auth_adapter_1.authAdapter.getStatusMessage(parentOptions));
+    }
+    let configResult;
+    try {
+        configResult = await manager_1.configManager.load({
+            cliOptions: parentOptions,
+        });
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.includes('Auth configuration is incomplete')) {
+            configResult = {
+                config: {
+                    baseUrl: 'https://api.polyv.net',
+                    timeout: 30000,
+                    debug: false
+                }
+            };
+        }
+        else {
+            throw error;
+        }
+    }
+    const serviceConfig = {
+        baseUrl: configResult.config.baseUrl,
+        timeout: configResult.config.timeout,
+        debug: configResult.config.debug
+    };
+    const isVerbose = !!parentOptions.verbose;
+    if (isVerbose) {
+        console.log(`🔐 Authentication Source: ${authResult.source}`);
+        if (authResult.accountName) {
+            console.log(`👤 Account: ${authResult.accountName}`);
+        }
+        console.log('');
+    }
+    const result = {
+        authConfig: authResult.config,
+        serviceConfig,
+        isVerbose,
+    };
+    if (authResult.source) {
+        result.authSource = authResult.source;
+    }
+    if (authResult.accountName) {
+        result.accountName = authResult.accountName;
+    }
+    return result;
+}
+function validateOutputFormat(value) {
+    if (!['table', 'json'].includes(value)) {
+        throw new Error('Output format must be either "table" or "json"');
+    }
+    return value;
+}
+function validateDateFormat(value) {
+    const regex = /^\d{4}-\d{2}-\d{2}$/;
+    if (!regex.test(value)) {
+        throw new Error('Date format must be yyyy-MM-dd');
+    }
+    const date = new Date(value);
+    if (isNaN(date.getTime())) {
+        throw new Error(`Invalid date: ${value}`);
+    }
+    const [year, month, day] = value.split('-').map(Number);
+    if (date.getFullYear() !== year ||
+        date.getMonth() + 1 !== month ||
+        date.getDate() !== day) {
+        throw new Error(`Invalid date: ${value}`);
+    }
+    return value;
+}
+function validateDateRange(startDay, endDay) {
+    const result = (0, date_validation_1.validateDateRange)(startDay, endDay);
+    if (!result.valid) {
+        throw new Error(result.error || 'Invalid date range');
+    }
+}
+function registerStatisticsCommands(program) {
+    const statisticsCmd = program.command('statistics');
+    statisticsCmd.description('View live streaming statistics data');
+    const viewCmd = statisticsCmd
+        .command('view')
+        .description('View daily statistics for a channel')
+        .requiredOption('-c, --channel-id <channelId>', 'channel ID')
+        .requiredOption('--start-day <date>', 'start date (yyyy-MM-dd)', validateDateFormat)
+        .requiredOption('--end-day <date>', 'end date (yyyy-MM-dd)', validateDateFormat)
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action(async (options) => {
+        try {
+            validateDateRange(options.startDay, options.endDay);
+            const parentOptions = program.opts();
+            const { authConfig, serviceConfig } = await loadAuthAndServiceConfig(parentOptions);
+            const statisticsHandler = new statistics_handler_1.StatisticsHandler(authConfig, serviceConfig);
+            const viewOptions = {
+                channelId: options.channelId,
+                startDay: options.startDay,
+                endDay: options.endDay,
+                output: options.output
+            };
+            await statisticsHandler.viewStatistics(viewOptions);
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes('Authentication')) {
+                const diagnostics = auth_adapter_1.authAdapter.getDiagnostics(program.opts());
+                console.error('\n🔍 Authentication Diagnostics:');
+                diagnostics.availableSources.forEach(source => {
+                    const status = source.appId && source.appSecret ? '✅' : '❌';
+                    console.error(`  ${status} ${source.metadata.source}: ${source.type}`);
+                });
+                if (diagnostics.errors.length > 0) {
+                    console.error('\n❌ Errors:');
+                    diagnostics.errors.forEach(err => console.error(`  - ${err}`));
+                }
+            }
+            (0, errors_1.logError)(error instanceof Error ? error : new Error(String(error)));
+            process.exit(1);
+        }
+    });
+    viewCmd.addHelpText('after', `
+Examples:
+  # View daily statistics for a channel
+  $ polyv-live-cli statistics view -c "3151318" --start-day "2024-01-01" --end-day "2024-01-31"
+
+  # Output in JSON format
+  $ polyv-live-cli statistics view -c "3151318" --start-day "2024-01-01" --end-day "2024-01-31" -o json
+
+  # With full parameter names
+  $ polyv-live-cli statistics view --channel-id "3151318" --start-day "2024-01-01" --end-day "2024-01-31" --output table
+
+Date Range:
+  --start-day    Start date in yyyy-MM-dd format (required)
+  --end-day      End date in yyyy-MM-dd format (required)
+                 Note: Date range cannot exceed 60 days
+
+Output Formats:
+  table          Formatted table output (default)
+  json           JSON format for programmatic use
+
+Notes:
+  - Channel ID is required for all statistics queries
+  - Date range cannot exceed 60 days
+  - Statistics include PC and mobile view data
+`);
+    const concurrencyCmd = statisticsCmd
+        .command('concurrency')
+        .description('查看历史并发数据')
+        .requiredOption('-c, --channel-id <channelId>', '频道ID')
+        .requiredOption('--start-date <date>', '开始日期 (yyyy-MM-dd)', validateDateFormat)
+        .requiredOption('--end-date <date>', '结束日期 (yyyy-MM-dd)', validateDateFormat)
+        .option('-o, --output <format>', '输出格式 (table|json)', validateOutputFormat, 'table')
+        .action(async (options) => {
+        try {
+            validateDateRange(options.startDate, options.endDate);
+            const parentOptions = program.opts();
+            const { authConfig, serviceConfig } = await loadAuthAndServiceConfig(parentOptions);
+            const statisticsHandler = new statistics_handler_1.StatisticsHandler(authConfig, serviceConfig);
+            const concurrencyOptions = {
+                channelId: options.channelId,
+                startDate: options.startDate,
+                endDate: options.endDate,
+                output: options.output
+            };
+            await statisticsHandler.viewConcurrency(concurrencyOptions);
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes('Authentication')) {
+                const diagnostics = auth_adapter_1.authAdapter.getDiagnostics(program.opts());
+                console.error('\n🔍 Authentication Diagnostics:');
+                diagnostics.availableSources.forEach(source => {
+                    const status = source.appId && source.appSecret ? '✅' : '❌';
+                    console.error(`  ${status} ${source.metadata.source}: ${source.type}`);
+                });
+                if (diagnostics.errors.length > 0) {
+                    console.error('\n❌ Errors:');
+                    diagnostics.errors.forEach(err => console.error(`  - ${err}`));
+                }
+            }
+            (0, errors_1.logError)(error instanceof Error ? error : new Error(String(error)));
+            process.exit(1);
+        }
+    });
+    concurrencyCmd.addHelpText('after', `
+Examples:
+  # View historical concurrency data
+  $ polyv-live-cli statistics concurrency -c "3151318" --start-date "2024-01-01" --end-date "2024-01-31"
+
+  # Output in JSON format
+  $ polyv-live-cli statistics concurrency -c "3151318" --start-date "2024-01-01" --end-date "2024-01-31" -o json
+
+Date Range:
+  --start-date    Start date in yyyy-MM-dd format (required)
+  --end-date      End date in yyyy-MM-dd format (required)
+                 Note: Date range cannot exceed 60 days
+
+Output Formats:
+  table          Formatted table output (default)
+  json           JSON format for programmatic use
+`);
+    const maxConcurrentCmd = statisticsCmd
+        .command('max-concurrent')
+        .description('查看历史最高并发人数')
+        .requiredOption('-c, --channel-id <channelId>', '频道ID')
+        .requiredOption('--start-time <timestamp>', '开始时间戳 (13位毫秒)', parseInt)
+        .requiredOption('--end-time <timestamp>', '结束时间戳 (13位毫秒)', parseInt)
+        .option('-o, --output <format>', '输出格式 (table|json)', validateOutputFormat, 'table')
+        .action(async (options) => {
+        try {
+            const rangeValidation = (0, date_validation_1.validateTimestampRange)(options.startTime, options.endTime);
+            if (!rangeValidation.valid) {
+                throw new Error(rangeValidation.error || 'Invalid time range');
+            }
+            const parentOptions = program.opts();
+            const { authConfig, serviceConfig } = await loadAuthAndServiceConfig(parentOptions);
+            const statisticsHandler = new statistics_handler_1.StatisticsHandler(authConfig, serviceConfig);
+            const maxConcurrentOptions = {
+                channelId: options.channelId,
+                startTime: options.startTime,
+                endTime: options.endTime,
+                output: options.output
+            };
+            await statisticsHandler.viewMaxConcurrent(maxConcurrentOptions);
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes('Authentication')) {
+                const diagnostics = auth_adapter_1.authAdapter.getDiagnostics(program.opts());
+                console.error('\n🔍 Authentication Diagnostics:');
+                diagnostics.availableSources.forEach(source => {
+                    const status = source.appId && source.appSecret ? '✅' : '❌';
+                    console.error(`  ${status} ${source.metadata.source}: ${source.type}`);
+                });
+                if (diagnostics.errors.length > 0) {
+                    console.error('\n❌ Errors:');
+                    diagnostics.errors.forEach(err => console.error(`  - ${err}`));
+                }
+            }
+            (0, errors_1.logError)(error instanceof Error ? error : new Error(String(error)));
+            process.exit(1);
+        }
+    });
+    maxConcurrentCmd.addHelpText('after', `
+Examples:
+  # View maximum historical concurrent viewers
+  $ polyv-live-cli statistics max-concurrent -c "3151318" --start-time 1704067200000 --end-time 1735689600000
+
+  # Output in JSON format
+  $ polyv-live-cli statistics max-concurrent -c "3151318" --start-time 1704067200000 --end-time 1735689600000 -o json
+
+Timestamp Range:
+  --start-time    Start timestamp in 13-digit milliseconds (required)
+  --end-time      End timestamp in 13-digit milliseconds (required)
+                 Note: Time range cannot exceed 3 months
+
+Output Formats:
+  table          Formatted output (default)
+  json           JSON format for programmatic use
+`);
+    const audienceCmd = statisticsCmd.command('audience');
+    audienceCmd.description('View audience statistics');
+    const regionCmd = audienceCmd
+        .command('region')
+        .description('View audience region distribution')
+        .requiredOption('-c, --channel-id <channelId>', '频道ID')
+        .requiredOption('--start-time <timestamp>', '开始时间戳 (13位毫秒)', parseInt)
+        .requiredOption('--end-time <timestamp>', '结束时间戳 (13位毫秒)', parseInt)
+        .option('-t, --type <type>', '地域类型 (country/province/city)', 'province')
+        .option('-o, --output <format>', '输出格式 (table|json)', validateOutputFormat, 'table')
+        .action(async (options) => {
+        try {
+            const rangeValidation = (0, date_validation_1.validate90DayTimestampRange)(options.startTime, options.endTime);
+            if (!rangeValidation.valid) {
+                throw new Error(rangeValidation.error || 'Invalid time range');
+            }
+            const parentOptions = program.opts();
+            const { authConfig, serviceConfig } = await loadAuthAndServiceConfig(parentOptions);
+            const statisticsHandler = new statistics_handler_1.StatisticsHandler(authConfig, serviceConfig);
+            const regionOptions = {
+                channelId: options.channelId,
+                startTime: options.startTime,
+                endTime: options.endTime,
+                type: options.type,
+                output: options.output
+            };
+            await statisticsHandler.viewRegionDistribution(regionOptions);
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes('Authentication')) {
+                const diagnostics = auth_adapter_1.authAdapter.getDiagnostics(program.opts());
+                console.error('\n🔍 Authentication Diagnostics:');
+                diagnostics.availableSources.forEach(source => {
+                    const status = source.appId && source.appSecret ? '✅' : '❌';
+                    console.error(`  ${status} ${source.metadata.source}: ${source.type}`);
+                });
+                if (diagnostics.errors.length > 0) {
+                    console.error('\n❌ Errors:');
+                    diagnostics.errors.forEach(err => console.error(`  - ${err}`));
+                }
+            }
+            (0, errors_1.logError)(error instanceof Error ? error : new Error(String(error)));
+            process.exit(1);
+        }
+    });
+    regionCmd.addHelpText('after', `
+Examples:
+  # View region distribution
+  $ polyv-live-cli statistics audience region -c "3151318" --start-time 1648742400000 --end-time 1651334399000
+
+  # With city type
+  $ polyv-live-cli statistics audience region -c "3151318" --start-time 1648742400000 --end-time 1651334399000 --type city
+
+  # Output in JSON format
+  $ polyv-live-cli statistics audience region -c "3151318" --start-time 1648742400000 --end-time 1651334399000 -o json
+
+Timestamp Range:
+  --start-time    Start timestamp in 13-digit milliseconds (required)
+  --end-time      End timestamp in 13-digit milliseconds (required)
+                 Note: Time range cannot exceed 90 days
+
+Region Types:
+  --type    Region type (default: province)
+                 country: View by country
+                 province: View by province (default)
+                 city: View by city
+
+Output Formats:
+  table          Formatted table output (default)
+  json           JSON format for programmatic use
+`);
+    const deviceCmd = audienceCmd
+        .command('device')
+        .description('View audience device distribution')
+        .requiredOption('-c, --channel-id <channelId>', '频道ID')
+        .requiredOption('--start-time <timestamp>', '开始时间戳 (13位毫秒)', parseInt)
+        .requiredOption('--end-time <timestamp>', '结束时间戳 (13位毫秒)', parseInt)
+        .option('-o, --output <format>', '输出格式 (table|json)', validateOutputFormat, 'table')
+        .action(async (options) => {
+        try {
+            const rangeValidation = (0, date_validation_1.validate90DayTimestampRange)(options.startTime, options.endTime);
+            if (!rangeValidation.valid) {
+                throw new Error(rangeValidation.error || 'Invalid time range');
+            }
+            const parentOptions = program.opts();
+            const { authConfig, serviceConfig } = await loadAuthAndServiceConfig(parentOptions);
+            const statisticsHandler = new statistics_handler_1.StatisticsHandler(authConfig, serviceConfig);
+            const deviceOptions = {
+                channelId: options.channelId,
+                startTime: options.startTime,
+                endTime: options.endTime,
+                output: options.output
+            };
+            await statisticsHandler.viewDeviceDistribution(deviceOptions);
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes('Authentication')) {
+                const diagnostics = auth_adapter_1.authAdapter.getDiagnostics(program.opts());
+                console.error('\n🔍 Authentication Diagnostics:');
+                diagnostics.availableSources.forEach(source => {
+                    const status = source.appId && source.appSecret ? '✅' : '❌';
+                    console.error(`  ${status} ${source.metadata.source}: ${source.type}`);
+                });
+                if (diagnostics.errors.length > 0) {
+                    console.error('\n❌ Errors:');
+                    diagnostics.errors.forEach(err => console.error(`  - ${err}`));
+                }
+            }
+            (0, errors_1.logError)(error instanceof Error ? error : new Error(String(error)));
+            process.exit(1);
+        }
+    });
+    deviceCmd.addHelpText('after', `
+Examples:
+  # View device distribution
+  $ polyv-live-cli statistics audience device -c "3151318" --start-time 1651386101000 --end-time 1652336501462
+
+  # Output in JSON format
+  $ polyv-live-cli statistics audience device -c "3151318" --start-time 1651386101000 --end-time 1652336501462 -o json
+
+Timestamp Range:
+  --start-time    Start timestamp in 13-digit milliseconds (required)
+  --end-time      End timestamp in 13-digit milliseconds (required)
+                 Note: Time range cannot exceed 90 days
+
+Output Formats:
+  table          Formatted table output (default)
+  json           JSON format for programmatic use
+`);
+}
+//# sourceMappingURL=statistics.commands.js.map