polyv-live-cli 1.0.2

package/dist/commands/stream.commands.js

@@ -0,0 +1,272 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerStreamCommands = registerStreamCommands;
+const stream_handler_1 = require("../handlers/stream.handler");
+const stream_service_1 = require("../services/stream.service");
+const manager_1 = require("../config/manager");
+const errors_1 = require("../utils/errors");
+function registerStreamCommands(program) {
+    const streamCmd = program.command('stream');
+    streamCmd.description('Manage live streaming operations');
+    const getKeyCmd = streamCmd
+        .command('get-key')
+        .description('Get RTMP URL and stream key for a live channel')
+        .requiredOption('-c, --channelId <id>', 'channel ID (required, must be a live channel)')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .action(async (options) => {
+        try {
+            const parentOptions = program.opts();
+            const configResult = await manager_1.configManager.load({
+                cliOptions: parentOptions,
+            });
+            const serviceConfig = {
+                baseUrl: configResult.config.baseUrl,
+                timeout: configResult.config.timeout,
+                debug: configResult.config.debug
+            };
+            const streamService = new stream_service_1.StreamService(configResult.config.auth, serviceConfig);
+            const streamHandler = new stream_handler_1.StreamHandler(streamService);
+            const streamOptions = {
+                channelId: options.channelId,
+                output: options.output
+            };
+            await streamHandler.getStreamKey(streamOptions);
+        }
+        catch (error) {
+            (0, errors_1.logError)(error instanceof Error ? error : new Error(String(error)));
+            process.exit(1);
+        }
+    });
+    getKeyCmd.addHelpText('after', `
+Examples:
+  $ polyv-cli stream get-key -c 3151318
+  $ polyv-cli stream get-key -c 3151318 -o json
+  $ polyv-cli stream get-key -c 3151318 -o table
+  
+Alternative (full parameter names):
+  $ polyv-cli stream get-key -c 3151318 -o json
+
+Requirements:
+  • Channel must be in live streaming state
+  • Valid authentication credentials required
+  • Channel ID must exist and be accessible
+
+Output Formats:
+  table       Formatted table output with masked stream key (default)
+  json        JSON format with full credentials (for programmatic use)
+
+Security Notes:
+  • Stream keys are sensitive credentials - keep them secure
+  • Table format masks the stream key for security
+  • JSON format shows full credentials - use carefully
+  • Do not share stream keys in public channels or logs
+
+Usage in OBS/Streaming Software:
+  1. Copy the RTMP URL to your streaming software's server field
+  2. Copy the stream key to your streaming software's key field
+  3. Start streaming to begin live broadcast
+`);
+    const startCmd = streamCmd
+        .command('start')
+        .description('Start live streaming for a channel')
+        .requiredOption('-c, --channelId <id>', 'channel ID (required)')
+        .action(async (options) => {
+        try {
+            const parentOptions = program.opts();
+            const configResult = await manager_1.configManager.load({
+                cliOptions: parentOptions,
+            });
+            const serviceConfig = {
+                baseUrl: configResult.config.baseUrl,
+                timeout: configResult.config.timeout,
+                debug: configResult.config.debug
+            };
+            const streamService = new stream_service_1.StreamService(configResult.config.auth, serviceConfig);
+            const streamHandler = new stream_handler_1.StreamHandler(streamService);
+            const streamOptions = {
+                channelId: options.channelId
+            };
+            await streamHandler.startStream(streamOptions);
+        }
+        catch (error) {
+            (0, errors_1.logError)(error instanceof Error ? error : new Error(String(error)));
+            process.exit(1);
+        }
+    });
+    startCmd.addHelpText('after', `
+Examples:
+  $ polyv-cli stream start -c 3151318
+  $ polyv-cli stream start -c 3151318 --appId <id> --appSecret <secret>
+
+Requirements:
+  • Channel must exist and be accessible
+  • Valid authentication credentials required
+  • User must have permission to start streams for the channel
+
+Usage Notes:
+  • This command sets the channel status to "live"
+  • The actual streaming still requires OBS or other streaming software
+  • Use 'stream get-key' to obtain streaming credentials after starting
+  • Stream status changes do not trigger automatic callbacks
+
+Expected Behavior:
+  • Success: Channel status changes to live, confirmation displayed
+  • Already Started: Command completes with informational message
+  • Channel Not Found: Error message displayed with specific details
+  • Permission Denied: Authentication or authorization error displayed
+`);
+    const stopCmd = streamCmd
+        .command('stop')
+        .description('Stop live streaming for a channel')
+        .requiredOption('-c, --channelId <id>', 'channel ID (required)')
+        .action(async (options) => {
+        try {
+            const parentOptions = program.opts();
+            const configResult = await manager_1.configManager.load({
+                cliOptions: parentOptions,
+            });
+            const serviceConfig = {
+                baseUrl: configResult.config.baseUrl,
+                timeout: configResult.config.timeout,
+                debug: configResult.config.debug
+            };
+            const streamService = new stream_service_1.StreamService(configResult.config.auth, serviceConfig);
+            const streamHandler = new stream_handler_1.StreamHandler(streamService);
+            const streamOptions = {
+                channelId: options.channelId
+            };
+            await streamHandler.stopStream(streamOptions);
+        }
+        catch (error) {
+            (0, errors_1.logError)(error instanceof Error ? error : new Error(String(error)));
+            process.exit(1);
+        }
+    });
+    stopCmd.addHelpText('after', `
+Examples:
+  $ polyv-cli stream stop -c 3151318
+  $ polyv-cli stream stop -c 3151318 --appId <id> --appSecret <secret>
+
+Requirements:
+  • Channel must exist and be accessible
+  • Valid authentication credentials required
+  • User must have permission to stop streams for the channel
+
+Usage Notes:
+  • This command sets the channel status to "stopped"
+  • The streaming session will be terminated immediately
+  • Use this command to end live broadcasts cleanly
+  • Stream status changes do not trigger automatic callbacks
+
+Expected Behavior:
+  • Success: Channel status changes to stopped, confirmation displayed
+  • Already Stopped: Command completes with informational message
+  • Channel Not Found: Error message displayed with specific details
+  • Permission Denied: Authentication or authorization error displayed
+  • Not Live: Error if channel is not currently streaming
+`);
+    const statusCmd = streamCmd
+        .command('status')
+        .description('Get real-time status information for a live channel')
+        .requiredOption('-c, --channelId <id>', 'channel ID (required)')
+        .option('-o, --output <format>', 'output format (table|json)', validateOutputFormat, 'table')
+        .option('-w, --watch', 'enable continuous monitoring (updates every 5 seconds)')
+        .action(async (options) => {
+        try {
+            const parentOptions = program.opts();
+            const configResult = await manager_1.configManager.load({
+                cliOptions: parentOptions,
+            });
+            const serviceConfig = {
+                baseUrl: configResult.config.baseUrl,
+                timeout: configResult.config.timeout,
+                debug: configResult.config.debug
+            };
+            const streamService = new stream_service_1.StreamService(configResult.config.auth, serviceConfig);
+            const streamHandler = new stream_handler_1.StreamHandler(streamService);
+            const streamOptions = {
+                channelId: options.channelId,
+                output: options.output,
+                watch: options.watch
+            };
+            if (options.watch) {
+                console.log('📺 Starting continuous monitoring (Press Ctrl+C to stop)...\n');
+                const updateInterval = setInterval(async () => {
+                    try {
+                        process.stdout.write('\x1Bc');
+                        console.log('📺 Live Stream Monitor - Press Ctrl+C to stop\n');
+                        await streamHandler.getStreamStatus(streamOptions);
+                        console.log(`\n⏱️  Last updated: ${new Date().toLocaleTimeString()}`);
+                        console.log('🔄 Updating in 5 seconds...');
+                    }
+                    catch (error) {
+                        console.error('❌ Error updating status:', error instanceof Error ? error.message : String(error));
+                    }
+                }, 5000);
+                process.on('SIGINT', () => {
+                    clearInterval(updateInterval);
+                    console.log('\n\n👋 Monitoring stopped. Goodbye!');
+                    process.exit(0);
+                });
+                await streamHandler.getStreamStatus(streamOptions);
+                console.log(`\n⏱️  Last updated: ${new Date().toLocaleTimeString()}`);
+                console.log('🔄 Updating in 5 seconds...');
+            }
+            else {
+                await streamHandler.getStreamStatus(streamOptions);
+            }
+        }
+        catch (error) {
+            (0, errors_1.logError)(error instanceof Error ? error : new Error(String(error)));
+            process.exit(1);
+        }
+    });
+    statusCmd.addHelpText('after', `
+Examples:
+  $ polyv-cli stream status -c 3151318
+  $ polyv-cli stream status -c 3151318 -o json
+  $ polyv-cli stream status -c 3151318 -w
+  $ polyv-cli stream status -c 3151318 -w -o table
+  
+Alternative (full parameter names):
+  $ polyv-cli stream status --channelId 3151318 --output json --watch
+
+Requirements:
+  • Channel must exist and be accessible
+  • Valid authentication credentials required
+  • No special permissions needed for status checking
+
+Usage Notes:
+  • Status command works for channels in any state (live, waiting, stopped)
+  • Live channels show detailed performance metrics and network information
+  • Watch mode refreshes status every 5 seconds automatically
+  • Use Ctrl+C to stop watch mode
+  • JSON output provides complete status data for programmatic use
+
+Status Information Displayed:
+  • Current streaming status (Live, Waiting, Stopped, Error)
+  • Stream duration (for live streams)
+  • Performance metrics (FPS, bandwidth, frame loss rate)
+  • Network information (deploy address, input address, stream name)
+  • Error details (if applicable)
+  • Last update timestamp
+
+Output Formats:
+  table       Formatted table output with status icons (default)
+  json        Complete JSON data for programmatic use
+
+Watch Mode:
+  • Continuously monitors stream status
+  • Updates every 5 seconds automatically
+  • Shows live performance metrics
+  • Perfect for monitoring active streams
+  • Press Ctrl+C to exit
+`);
+}
+function validateOutputFormat(value) {
+    if (value !== 'table' && value !== 'json') {
+        throw new Error(`Invalid output format: ${value}. Must be 'table' or 'json'`);
+    }
+    return value;
+}
+//# sourceMappingURL=stream.commands.js.map

package/dist/commands/stream.commands.js.map

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

package/dist/config/auth.d.ts

@@ -0,0 +1,11 @@
+import { AuthOptions, AuthResult, AuthSource } from '../types/auth';
+export declare function loadAuthFromCLI(cliOptions: Record<string, unknown>): AuthOptions;
+export declare function loadAuthFromEnv(): AuthOptions;
+export declare function mergeAuthOptions(cliOptions: AuthOptions, envOptions: AuthOptions): {
+    options: AuthOptions;
+    sources: AuthSource;
+};
+export declare function validateAuthConfig(authOptions: AuthOptions): boolean;
+export declare function createAuthErrorMessage(authOptions: AuthOptions, sources: AuthSource): string;
+export declare function loadAuthConfig(cliOptions?: Record<string, unknown>): AuthResult;
+//# sourceMappingURL=auth.d.ts.map

package/dist/config/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/config/auth.ts"],"names":[],"mappings":"AAIA,OAAO,EAAc,WAAW,EAAE,UAAU,EAAE,UAAU,EAAmC,MAAM,eAAe,CAAC;AAQjH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,CAgBhF;AAMD,wBAAgB,eAAe,IAAI,WAAW,CAmB7C;AAQD,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,GAAG;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,UAAU,CAAA;CAAE,CAgChI;AAOD,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAEpE;AAQD,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,GAAG,MAAM,CAuC5F;AAOD,wBAAgB,cAAc,CAAC,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,UAAU,CA4BnF"}

package/dist/config/auth.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadAuthFromCLI = loadAuthFromCLI;
+exports.loadAuthFromEnv = loadAuthFromEnv;
+exports.mergeAuthOptions = mergeAuthOptions;
+exports.validateAuthConfig = validateAuthConfig;
+exports.createAuthErrorMessage = createAuthErrorMessage;
+exports.loadAuthConfig = loadAuthConfig;
+const auth_1 = require("../types/auth");
+const errors_1 = require("../utils/errors");
+function loadAuthFromCLI(cliOptions) {
+    const authOptions = {};
+    if (typeof cliOptions[auth_1.AUTH_CLI_OPTIONS.APP_ID] === 'string') {
+        authOptions.appId = cliOptions[auth_1.AUTH_CLI_OPTIONS.APP_ID];
+    }
+    if (typeof cliOptions[auth_1.AUTH_CLI_OPTIONS.APP_SECRET] === 'string') {
+        authOptions.appSecret = cliOptions[auth_1.AUTH_CLI_OPTIONS.APP_SECRET];
+    }
+    if (typeof cliOptions[auth_1.AUTH_CLI_OPTIONS.USER_ID] === 'string') {
+        authOptions.userId = cliOptions[auth_1.AUTH_CLI_OPTIONS.USER_ID];
+    }
+    return authOptions;
+}
+function loadAuthFromEnv() {
+    const authOptions = {};
+    const appId = process.env[auth_1.AUTH_ENV_VARS.APP_ID];
+    if (appId && appId.trim()) {
+        authOptions.appId = appId.trim();
+    }
+    const appSecret = process.env[auth_1.AUTH_ENV_VARS.APP_SECRET];
+    if (appSecret && appSecret.trim()) {
+        authOptions.appSecret = appSecret.trim();
+    }
+    const userId = process.env[auth_1.AUTH_ENV_VARS.USER_ID];
+    if (userId && userId.trim()) {
+        authOptions.userId = userId.trim();
+    }
+    return authOptions;
+}
+function mergeAuthOptions(cliOptions, envOptions) {
+    const mergedOptions = {};
+    const sources = {};
+    if (cliOptions.appId) {
+        mergedOptions.appId = cliOptions.appId;
+        sources.appIdSource = 'cli';
+    }
+    else if (envOptions.appId) {
+        mergedOptions.appId = envOptions.appId;
+        sources.appIdSource = 'env';
+    }
+    if (cliOptions.appSecret) {
+        mergedOptions.appSecret = cliOptions.appSecret;
+        sources.appSecretSource = 'cli';
+    }
+    else if (envOptions.appSecret) {
+        mergedOptions.appSecret = envOptions.appSecret;
+        sources.appSecretSource = 'env';
+    }
+    if (cliOptions.userId) {
+        mergedOptions.userId = cliOptions.userId;
+        sources.userIdSource = 'cli';
+    }
+    else if (envOptions.userId) {
+        mergedOptions.userId = envOptions.userId;
+        sources.userIdSource = 'env';
+    }
+    return { options: mergedOptions, sources };
+}
+function validateAuthConfig(authOptions) {
+    return !!(authOptions.appId && authOptions.appSecret);
+}
+function createAuthErrorMessage(authOptions, sources) {
+    const missing = [];
+    if (!authOptions.appId) {
+        missing.push('appId');
+    }
+    if (!authOptions.appSecret) {
+        missing.push('appSecret');
+    }
+    if (missing.length === 0) {
+        return 'Authentication configuration is valid';
+    }
+    const missingStr = missing.join(', ');
+    const hasCliSource = Object.values(sources).some(source => source === 'cli');
+    const hasEnvSource = Object.values(sources).some(source => source === 'env');
+    let message = `Missing required authentication parameters: ${missingStr}\n\n`;
+    message += 'You can provide authentication in two ways:\n';
+    message += '1. Command line: --appId <ID> --appSecret <SECRET> [--userId <USER_ID>]\n';
+    message += '2. Environment variables: POLYV_APP_ID, POLYV_APP_SECRET, POLYV_USER_ID\n\n';
+    if (hasCliSource || hasEnvSource) {
+        message += 'Current configuration sources:\n';
+        if (sources.appIdSource) {
+            message += `  appId: ${sources.appIdSource}\n`;
+        }
+        if (sources.appSecretSource) {
+            message += `  appSecret: ${sources.appSecretSource}\n`;
+        }
+        if (sources.userIdSource) {
+            message += `  userId: ${sources.userIdSource}\n`;
+        }
+    }
+    return message.trim();
+}
+function loadAuthConfig(cliOptions = {}) {
+    const cliAuth = loadAuthFromCLI(cliOptions);
+    const envAuth = loadAuthFromEnv();
+    const { options: mergedOptions, sources } = mergeAuthOptions(cliAuth, envAuth);
+    const isValid = validateAuthConfig(mergedOptions);
+    if (!isValid) {
+        const errorMessage = createAuthErrorMessage(mergedOptions, sources);
+        throw new errors_1.ConfigurationError(errorMessage);
+    }
+    const config = {
+        appId: mergedOptions.appId,
+        appSecret: mergedOptions.appSecret,
+        ...(mergedOptions.userId && { userId: mergedOptions.userId }),
+    };
+    return {
+        config,
+        sources,
+        isValid: true,
+    };
+}
+//# sourceMappingURL=auth.js.map

package/dist/config/auth.js.map

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

package/dist/config/loader.d.ts

@@ -0,0 +1,22 @@
+import { Environment, RawConfig } from '../types/config';
+export interface EnvFileResult {
+    path: string;
+    loaded: boolean;
+    error?: string;
+}
+export interface EnvFileOptions {
+    baseDir?: string;
+    override?: boolean;
+    additionalFiles?: string[];
+}
+export declare function getEnvFilePaths(environment: Environment, options?: EnvFileOptions): string[];
+export declare function loadEnvFile(filePath: string, override?: boolean): EnvFileResult;
+export declare function loadEnvFiles(filePaths: string[], override?: boolean): EnvFileResult[];
+export declare function loadEnvironmentConfig(environment: Environment, options?: EnvFileOptions, override?: boolean): EnvFileResult[];
+export declare function extractRawConfig(): RawConfig;
+export declare function validateEnvironment(env: string | undefined): Environment | undefined;
+export declare function parseBoolean(value: string | undefined, defaultValue?: boolean): boolean;
+export declare function parseInteger(value: string | undefined, defaultValue: number, min?: number, max?: number): number;
+export declare function parseUrl(value: string | undefined, defaultValue: string): string;
+export declare function findConfigFile(configPath?: string, baseDir?: string): string | undefined;
+//# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAqB,MAAM,iBAAiB,CAAC;AAK5E,MAAM,WAAW,aAAa;IAE5B,IAAI,EAAE,MAAM,CAAC;IAEb,MAAM,EAAE,OAAO,CAAC;IAEhB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAKD,MAAM,WAAW,cAAc;IAE7B,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAQD,wBAAgB,eAAe,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,GAAE,cAAmB,GAAG,MAAM,EAAE,CAqBhG;AAQD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,OAAe,GAAG,aAAa,CAwBtF;AAQD,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,QAAQ,GAAE,OAAe,GAAG,aAAa,EAAE,CAE5F;AASD,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,GAAE,cAAmB,EAAE,QAAQ,GAAE,OAAe,GAAG,aAAa,EAAE,CAGxI;AAMD,wBAAgB,gBAAgB,IAAI,SAAS,CAY5C;AAOD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAepF;AAQD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,YAAY,GAAE,OAAe,GAAG,OAAO,CAK9F;AAUD,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,YAAY,EAAE,MAAM,EACpB,GAAG,CAAC,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,MAAM,GACX,MAAM,CAUR;AAQD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAYhF;AAQD,wBAAgB,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,MAAsB,GAAG,MAAM,GAAG,SAAS,CAKvG"}

package/dist/config/loader.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEnvFilePaths = getEnvFilePaths;
+exports.loadEnvFile = loadEnvFile;
+exports.loadEnvFiles = loadEnvFiles;
+exports.loadEnvironmentConfig = loadEnvironmentConfig;
+exports.extractRawConfig = extractRawConfig;
+exports.validateEnvironment = validateEnvironment;
+exports.parseBoolean = parseBoolean;
+exports.parseInteger = parseInteger;
+exports.parseUrl = parseUrl;
+exports.findConfigFile = findConfigFile;
+const dotenv_1 = require("dotenv");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const config_1 = require("../types/config");
+function getEnvFilePaths(environment, options = {}) {
+    const baseDir = options.baseDir || process.cwd();
+    const files = [];
+    if (options.override && options.additionalFiles) {
+        return options.additionalFiles.map(file => (0, path_1.resolve)(baseDir, file));
+    }
+    files.push((0, path_1.resolve)(baseDir, config_1.ENV_FILE_PATTERNS.base));
+    files.push((0, path_1.resolve)(baseDir, config_1.ENV_FILE_PATTERNS.environment(environment)));
+    files.push((0, path_1.resolve)(baseDir, config_1.ENV_FILE_PATTERNS.local));
+    files.push((0, path_1.resolve)(baseDir, config_1.ENV_FILE_PATTERNS.environmentLocal(environment)));
+    if (options.additionalFiles) {
+        files.push(...options.additionalFiles.map(file => (0, path_1.resolve)(baseDir, file)));
+    }
+    return files;
+}
+function loadEnvFile(filePath, override = false) {
+    const result = {
+        path: filePath,
+        loaded: false,
+    };
+    try {
+        if (!(0, fs_1.existsSync)(filePath)) {
+            return result;
+        }
+        const dotenvResult = (0, dotenv_1.config)({ path: filePath, override });
+        if (dotenvResult.error) {
+            result.error = dotenvResult.error.message;
+            return result;
+        }
+        result.loaded = true;
+        return result;
+    }
+    catch (error) {
+        result.error = error instanceof Error ? error.message : 'Unknown error occurred';
+        return result;
+    }
+}
+function loadEnvFiles(filePaths, override = false) {
+    return filePaths.map(path => loadEnvFile(path, override));
+}
+function loadEnvironmentConfig(environment, options = {}, override = false) {
+    const filePaths = getEnvFilePaths(environment, options);
+    return loadEnvFiles(filePaths, override);
+}
+function extractRawConfig() {
+    return {
+        POLYV_ENVIRONMENT: process.env['POLYV_ENVIRONMENT'],
+        POLYV_DEBUG: process.env['POLYV_DEBUG'],
+        POLYV_TIMEOUT: process.env['POLYV_TIMEOUT'],
+        POLYV_BASE_URL: process.env['POLYV_BASE_URL'],
+        POLYV_MAX_RETRIES: process.env['POLYV_MAX_RETRIES'],
+        POLYV_CONFIG_PATH: process.env['POLYV_CONFIG_PATH'],
+        POLYV_APP_ID: process.env['POLYV_APP_ID'],
+        POLYV_APP_SECRET: process.env['POLYV_APP_SECRET'],
+        POLYV_USER_ID: process.env['POLYV_USER_ID'],
+    };
+}
+function validateEnvironment(env) {
+    if (!env)
+        return undefined;
+    const normalizedEnv = env.toLowerCase().trim();
+    if (normalizedEnv === 'development' || normalizedEnv === 'dev') {
+        return 'development';
+    }
+    if (normalizedEnv === 'production' || normalizedEnv === 'prod') {
+        return 'production';
+    }
+    if (normalizedEnv === 'test') {
+        return 'test';
+    }
+    return undefined;
+}
+function parseBoolean(value, defaultValue = false) {
+    if (!value)
+        return defaultValue;
+    const normalized = value.toLowerCase().trim();
+    return normalized === 'true' || normalized === '1' || normalized === 'yes' || normalized === 'on';
+}
+function parseInteger(value, defaultValue, min, max) {
+    if (!value)
+        return defaultValue;
+    const parsed = parseInt(value.trim(), 10);
+    if (isNaN(parsed))
+        return defaultValue;
+    if (min !== undefined && parsed < min)
+        return defaultValue;
+    if (max !== undefined && parsed > max)
+        return defaultValue;
+    return parsed;
+}
+function parseUrl(value, defaultValue) {
+    if (!value)
+        return defaultValue;
+    const trimmed = value.trim();
+    if (!trimmed)
+        return defaultValue;
+    try {
+        new URL(trimmed);
+        return trimmed;
+    }
+    catch {
+        return defaultValue;
+    }
+}
+function findConfigFile(configPath, baseDir = process.cwd()) {
+    if (!configPath)
+        return undefined;
+    const resolvedPath = (0, path_1.resolve)(baseDir, configPath);
+    return (0, fs_1.existsSync)(resolvedPath) ? resolvedPath : undefined;
+}
+//# sourceMappingURL=loader.js.map

package/dist/config/loader.js.map

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

package/dist/config/manager.d.ts

@@ -0,0 +1,20 @@
+import { AppConfig, ConfigResult, ConfigOptions, ConfigSources } from '../types/config';
+export declare class ConfigManager {
+    private config;
+    private sources;
+    private loadedEnvFiles;
+    load(options?: ConfigOptions): Promise<ConfigResult>;
+    getConfig(): AppConfig | null;
+    getSources(): ConfigSources | null;
+    getLoadedEnvFiles(): string[];
+    reload(options?: ConfigOptions): Promise<ConfigResult>;
+    private determineEnvironment;
+    private loadCliConfig;
+    private mergeConfigurations;
+    private createAuthConfig;
+}
+export declare const configManager: ConfigManager;
+export declare function loadConfig(options?: ConfigOptions): Promise<ConfigResult>;
+export declare function getConfig(): AppConfig | null;
+export declare function reloadConfig(options?: ConfigOptions): Promise<ConfigResult>;
+//# sourceMappingURL=manager.d.ts.map

package/dist/config/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/config/manager.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAe,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAUrG,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,cAAc,CAAgB;IAOhC,IAAI,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IAsH9D,SAAS,IAAI,SAAS,GAAG,IAAI;IAQ7B,UAAU,IAAI,aAAa,GAAG,IAAI;IAQlC,iBAAiB,IAAI,MAAM,EAAE;IASvB,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IAShE,OAAO,CAAC,oBAAoB;IA+B5B,OAAO,CAAC,aAAa;IAiErB,OAAO,CAAC,mBAAmB;IA4H3B,OAAO,CAAC,gBAAgB;CAWzB;AAKD,eAAO,MAAM,aAAa,eAAsB,CAAC;AAOjD,wBAAsB,UAAU,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAEnF;AAMD,wBAAgB,SAAS,IAAI,SAAS,GAAG,IAAI,CAE5C;AAOD,wBAAsB,YAAY,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAErF"}