tirtc-devtools-cli 0.0.13 → 0.0.15

package/dist/cli/src/bootstrap_flows.js

@@ -1,249 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BootstrapStepError = void 0;
-exports.validateServerConfig = validateServerConfig;
-exports.validateClientConfig = validateClientConfig;
-exports.applyConfiguredServerBootstrap = applyConfiguredServerBootstrap;
-exports.applyClientStartBootstrap = applyClientStartBootstrap;
-const fs_1 = __importDefault(require("fs"));
-const os_1 = __importDefault(require("os"));
-const path_1 = __importDefault(require("path"));
-const default_paths_1 = require("./default_paths");
-const media_assets_1 = require("./media_assets");
-class BootstrapStepError extends Error {
-    reasonCode;
-    data;
-    constructor(reasonCode, message, data) {
-        super(message);
-        this.name = 'BootstrapStepError';
-        this.reasonCode = reasonCode;
-        this.data = data;
-    }
-}
-exports.BootstrapStepError = BootstrapStepError;
-function resolveProtocolError(error) {
-    if (typeof error === 'object' && error !== null) {
-        const typed = error;
-        if (typed.data?.reasonCode && typed.data.reasonCode.trim().length > 0) {
-            return {
-                reasonCode: typed.data.reasonCode,
-                message: typed.data.message ?? typed.message ?? 'Request failed',
-            };
-        }
-        if (typed.message && typed.message.trim().length > 0) {
-            return {
-                reasonCode: 'internal_error',
-                message: typed.message,
-            };
-        }
-    }
-    if (error instanceof Error) {
-        return {
-            reasonCode: 'internal_error',
-            message: error.message,
-        };
-    }
-    return {
-        reasonCode: 'internal_error',
-        message: 'Request failed',
-    };
-}
-function ensureNonNegativeInteger(value, field) {
-    if (typeof value !== 'number' || !Number.isInteger(value) || value < 0) {
-        throw new Error(field + ' must be a non-negative integer');
-    }
-    return value;
-}
-function ensureNonEmptyString(value, field) {
-    if (typeof value !== 'string' || value.trim().length === 0) {
-        throw new Error(field + ' must be a non-empty string');
-    }
-    return value.trim();
-}
-function extractPreview(result, step) {
-    if (typeof result !== 'object' || result === null) {
-        throw new Error(step + ' did not return an object result');
-    }
-    const previewRaw = result.preview;
-    if (typeof previewRaw !== 'object' || previewRaw === null) {
-        throw new Error(step + ' did not return preview metadata');
-    }
-    const preview = previewRaw;
-    const url = ensureNonEmptyString(preview.url, step + ' preview.url');
-    return {
-        url,
-        token: typeof preview.token === 'string' && preview.token.trim().length > 0 ? preview.token.trim() : undefined,
-        endpoint: typeof preview.endpoint === 'string' && preview.endpoint.trim().length > 0 ? preview.endpoint.trim() : undefined,
-    };
-}
-async function runBootstrapStep(client, method, params, step, completed) {
-    try {
-        return await client.sendRequest(method, params);
-    }
-    catch (error) {
-        const resolved = resolveProtocolError(error);
-        throw new BootstrapStepError(resolved.reasonCode, resolved.message, {
-            failedStep: step,
-            completedSteps: completed,
-        });
-    }
-}
-function validateServerConfig(config) {
-    const server = config.server;
-    const license = server?.license?.trim() ?? '';
-    const mp4Path = server?.mp4_path?.trim() ?? '';
-    const audioStreamId = ensureNonNegativeInteger(server?.audio_stream_id, '[server].audio_stream_id');
-    const videoStreamId = ensureNonNegativeInteger(server?.video_stream_id, '[server].video_stream_id');
-    if (license.length === 0) {
-        throw new Error('server-only config requires [server].license');
-    }
-    if (mp4Path.length === 0) {
-        throw new Error('server-only config requires [server].mp4_path');
-    }
-    if (audioStreamId === videoStreamId) {
-        throw new Error('server-only config requires distinct audio_stream_id and video_stream_id');
-    }
-    const resolvedMp4Path = path_1.default.resolve(mp4Path);
-    let stats;
-    try {
-        stats = fs_1.default.statSync(resolvedMp4Path);
-    }
-    catch {
-        throw new Error('server-only config mp4_path does not exist: ' + resolvedMp4Path);
-    }
-    if (!stats.isFile()) {
-        throw new Error('server-only config mp4_path must be a readable file: ' + resolvedMp4Path);
-    }
-    const serviceEntry = server?.service_entry?.trim();
-    return {
-        serviceEntry: serviceEntry && serviceEntry.length > 0 ? serviceEntry : undefined,
-        license,
-        mp4Path: resolvedMp4Path,
-        audioStreamId,
-        videoStreamId,
-    };
-}
-function validateClientConfig(config) {
-    const client = config.client;
-    if (!client) {
-        throw new Error('client start requires [client] config');
-    }
-    const peerId = ensureNonEmptyString(client.peer_id, '[client].peer_id');
-    const audioStreamId = ensureNonNegativeInteger(client.audio_stream_id, '[client].audio_stream_id');
-    const videoStreamId = ensureNonNegativeInteger(client.video_stream_id, '[client].video_stream_id');
-    if (audioStreamId === videoStreamId) {
-        throw new Error('client config requires distinct audio_stream_id and video_stream_id');
-    }
-    if (client.consumer !== 'web_preview') {
-        throw new Error('client config requires [client].consumer = "web_preview"');
-    }
-    const serviceEntry = client.service_entry?.trim();
-    return {
-        serviceEntry: serviceEntry && serviceEntry.length > 0 ? serviceEntry : undefined,
-        peerId,
-        audioStreamId,
-        videoStreamId,
-        consumer: 'web_preview',
-    };
-}
-async function applyConfiguredServerBootstrap(client, config, progress) {
-    const server = validateServerConfig(config);
-    progress?.start('Preparing MP4 assets');
-    const prepared = await (0, media_assets_1.prepareMediaAssets)({
-        source: server.mp4Path,
-        outputRoot: (0, default_paths_1.resolveCliPreparedAssetsRoot)(),
-    });
-    progress?.update('Prepared MP4 assets');
-    const bootstrapSendStreams = [
-        { streamId: server.audioStreamId, media: 'audio' },
-        { streamId: server.videoStreamId, media: 'video' },
-    ].map(({ streamId, media }) => ({
-        streamId,
-        media,
-        source: {
-            mode: 'local_assets',
-            local_assets: {
-                assets_dir: prepared.assets_dir,
-            },
-        },
-    }));
-    return {
-        preparedAssetsDir: prepared.assets_dir,
-        mediaSendPolicy: 'AUTO_ON_CONNECTED',
-        bootstrapSendStreams,
-    };
-}
-async function applyClientStartBootstrap(client, config, token, progress) {
-    const normalizedToken = ensureNonEmptyString(token, '--token');
-    const clientConfig = validateClientConfig(config);
-    const audioArtifactPath = path_1.default.join(os_1.default.tmpdir(), `tirtc-client-preview-audio-${Date.now()}-${process.pid}.pcm`);
-    const videoArtifactPath = path_1.default.join(os_1.default.tmpdir(), `tirtc-client-preview-video-${Date.now()}-${process.pid}.jpeg`);
-    const completed = {
-        consumer: clientConfig.consumer,
-    };
-    progress?.start('Connecting client session');
-    const connection = await runBootstrapStep(client, 'connection/connect', {
-        serviceEntry: clientConfig.serviceEntry,
-        peerId: clientConfig.peerId,
-        token: normalizedToken,
-        timeoutMs: 5000,
-    }, 'connect', completed);
-    completed.connection = connection;
-    progress?.update('Connected client session');
-    const audioStream = await runBootstrapStep(client, 'stream/receiveStart', {
-        streamId: clientConfig.audioStreamId,
-        media: 'audio',
-    }, 'receive audio', completed);
-    completed.audioStream = audioStream;
-    progress?.update('Attached audio receive stream');
-    const videoStream = await runBootstrapStep(client, 'stream/receiveStart', {
-        streamId: clientConfig.videoStreamId,
-        media: 'video',
-    }, 'receive video', completed);
-    completed.videoStream = videoStream;
-    progress?.update('Attached video receive stream');
-    const audioOutput = await runBootstrapStep(client, 'output/attach', {
-        streamId: clientConfig.audioStreamId,
-        consumer: clientConfig.consumer,
-        mediaView: 'encoded_packet',
-        format: 'pcm',
-        delivery: 'artifact_path',
-        targetPath: audioArtifactPath,
-    }, 'attach audio preview', completed);
-    completed.audioOutput = audioOutput;
-    progress?.update('Attached audio preview output');
-    const videoOutput = await runBootstrapStep(client, 'output/attach', {
-        streamId: clientConfig.videoStreamId,
-        consumer: clientConfig.consumer,
-        mediaView: 'encoded_packet',
-        format: 'jpeg',
-        delivery: 'artifact_path',
-        targetPath: videoArtifactPath,
-    }, 'attach video preview', completed);
-    completed.videoOutput = videoOutput;
-    progress?.succeed('Client preview session is ready');
-    const audioPreview = extractPreview(audioOutput, 'attach audio preview');
-    const videoPreview = extractPreview(videoOutput, 'attach video preview');
-    if (audioPreview.url !== videoPreview.url) {
-        throw new BootstrapStepError('internal_error', 'web_preview outputs returned different preview URLs', {
-            failedStep: 'preview aggregation',
-            completedSteps: completed,
-            audioPreview,
-            videoPreview,
-        });
-    }
-    return {
-        connection,
-        autoApplied: {
-            consumer: clientConfig.consumer,
-            audioStream,
-            videoStream,
-            audioOutput,
-            videoOutput,
-            preview: audioPreview,
-        },
-    };
-}

package/dist/cli/src/config.d.ts

@@ -1,26 +0,0 @@
-export type CliConfig = {
-    server?: {
-        service_entry?: string;
-        license?: string;
-        mp4_path?: string;
-        video_stream_id?: number;
-        audio_stream_id?: number;
-    };
-    client?: {
-        service_entry?: string;
-        peer_id?: string;
-        audio_stream_id?: number;
-        video_stream_id?: number;
-        consumer?: 'web_preview';
-    };
-    debug?: {
-        connect_bootstrap?: {
-            access_id?: string;
-            secret_key?: string;
-            peer_id?: string;
-            service_entry?: string;
-        };
-    };
-};
-export declare function loadConfig(configPath?: string): CliConfig;
-export declare function writeConfigTemplate(outputPath?: string): string;

package/dist/cli/src/config.js

@@ -1,62 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadConfig = loadConfig;
-exports.writeConfigTemplate = writeConfigTemplate;
-const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
-const toml_1 = __importDefault(require("@iarna/toml"));
-const facade_1 = require("./facade");
-function loadConfig(configPath) {
-    if (!configPath || !fs_1.default.existsSync(configPath)) {
-        return {};
-    }
-    const ext = path_1.default.extname(configPath).toLowerCase();
-    if (ext !== '.toml') {
-        throw new Error('config must be TOML (.toml): ' + configPath);
-    }
-    const content = fs_1.default.readFileSync(configPath, 'utf-8');
-    return facade_1.CliConfigSchema.parse(toml_1.default.parse(content));
-}
-function resolveConfigOutputPath(outputPath) {
-    if (outputPath && outputPath.trim().length > 0) {
-        return path_1.default.resolve(outputPath.trim());
-    }
-    return path_1.default.resolve(process.cwd(), '.tmp/tirtc-devtools-cli/config.toml');
-}
-function renderTomlConfigTemplate() {
-    return [
-        '# TiRTC DevTool CLI 配置模板（TOML）',
-        '# client token 通过命令行 --token 显式提供，不写入配置文件。',
-        '',
-        '[server]',
-        '# 可留空，走 runtime/core/transport 默认 service_entry',
-        'service_entry = ""',
-        '# server-only service start 时必填',
-        'license = ""',
-        'mp4_path = "./source.mp4"',
-        'video_stream_id = 11',
-        'audio_stream_id = 10',
-        '',
-        '[client]',
-        '# client start 正式路径读取这里的最小连接事实',
-        'service_entry = ""',
-        'peer_id = "peer-123"',
-        'audio_stream_id = 10',
-        'video_stream_id = 11',
-        'consumer = "web_preview"',
-        '',
-    ].join('\n');
-}
-function writeConfigTemplate(outputPath) {
-    const targetPath = resolveConfigOutputPath(outputPath);
-    if (path_1.default.extname(targetPath).toLowerCase() !== '.toml') {
-        throw new Error('init output must be TOML (.toml): ' + targetPath);
-    }
-    const dir = path_1.default.dirname(targetPath);
-    fs_1.default.mkdirSync(dir, { recursive: true });
-    fs_1.default.writeFileSync(targetPath, renderTomlConfigTemplate(), 'utf8');
-    return targetPath;
-}