transcribly 1.0.0

package/dist/index.js

@@ -0,0 +1,288 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const dotenv_1 = require("dotenv");
+const transcriber_1 = require("./transcriber");
+const youtube_1 = require("./youtube");
+const utils_1 = require("./utils");
+const dependencies_1 = require("./dependencies");
+const config_1 = require("./config");
+const readline = __importStar(require("readline"));
+const openai_1 = __importDefault(require("openai"));
+const program = new commander_1.Command();
+program
+    .name("transcribly")
+    .description("Transcribe YouTube videos and local audio/video files using OpenAI Whisper API")
+    .version("1.0.0");
+program
+    .command("url <youtube-url>")
+    .description("Transcribe a YouTube video")
+    .option("-o, --output <dir>", "Output directory", "./text")
+    .option("-f, --format <format>", "Output format (txt or json)", "txt")
+    .option("-k, --api-key <key>", "OpenAI API key")
+    .action(async (url, options) => {
+    await handleTranscribeUrl(url, options);
+});
+program
+    .command("file <path>")
+    .description("Transcribe a local audio/video file")
+    .option("-o, --output <dir>", "Output directory", "./text")
+    .option("-f, --format <format>", "Output format (txt or json)", "txt")
+    .option("-k, --api-key <key>", "OpenAI API key")
+    .action(async (filePath, options) => {
+    await handleTranscribeFile(filePath, options);
+});
+// Default command: auto-detect URL vs file path
+program
+    .argument("[input]", "YouTube URL or local file path")
+    .option("-o, --output <dir>", "Output directory", "./text")
+    .option("-f, --format <format>", "Output format (txt or json)", "txt")
+    .option("-k, --api-key <key>", "OpenAI API key")
+    .option("--setup", "Set up OpenAI API key interactively")
+    .option("--doctor", "Check all system dependencies and report status")
+    .action(async (input, options) => {
+    if (options.doctor) {
+        await (0, dependencies_1.runDoctor)();
+        return;
+    }
+    if (options.setup) {
+        await runSetup();
+        return;
+    }
+    if (!input) {
+        program.help();
+        return;
+    }
+    if ((0, youtube_1.isYouTubeUrl)(input)) {
+        await handleTranscribeUrl(input, options);
+    }
+    else {
+        await handleTranscribeFile(input, options);
+    }
+});
+function getApiKey(options) {
+    // 1. --api-key flag
+    if (options.apiKey)
+        return options.apiKey;
+    // 2. Real OPENAI_API_KEY env var (before loading .env)
+    const envKey = process.env.OPENAI_API_KEY;
+    if (envKey)
+        return envKey;
+    // 3. ~/.transcribly/config.json
+    const configKey = (0, config_1.readConfig)().apiKey;
+    if (configKey)
+        return configKey;
+    // 4. .env file in current working directory
+    (0, dotenv_1.config)({ path: path.resolve(process.cwd(), ".env"), override: false });
+    if (process.env.OPENAI_API_KEY)
+        return process.env.OPENAI_API_KEY;
+    // 5. .env in CLI directory
+    (0, dotenv_1.config)({ path: path.resolve(__dirname, "..", ".env"), override: false });
+    if (process.env.OPENAI_API_KEY)
+        return process.env.OPENAI_API_KEY;
+    // No key found — show helpful error
+    console.error(chalk_1.default.red("Error: OpenAI API key required for transcription.\n"));
+    console.error("Set it up in one of these ways:");
+    console.error("  1. Run: transcribly --setup");
+    console.error('  2. Set env var: export OPENAI_API_KEY="sk-..."');
+    console.error("  3. Add to .env file: OPENAI_API_KEY=sk-...");
+    console.error("\nGet your API key at: https://platform.openai.com/api-keys");
+    process.exit(1);
+}
+async function promptApiKey() {
+    return new Promise((resolve) => {
+        process.stdout.write("Enter your OpenAI API key: ");
+        if (process.stdin.isTTY) {
+            // Mask input in interactive terminals
+            const stdin = process.stdin;
+            stdin.setRawMode(true);
+            stdin.resume();
+            stdin.setEncoding("utf8");
+            let input = "";
+            const onData = (char) => {
+                const code = char.charCodeAt(0);
+                if (char === "\r" || char === "\n") {
+                    stdin.setRawMode(false);
+                    stdin.pause();
+                    stdin.removeListener("data", onData);
+                    process.stdout.write("\n");
+                    resolve(input.trim());
+                }
+                else if (code === 3) {
+                    // Ctrl+C
+                    stdin.setRawMode(false);
+                    process.stdout.write("\n");
+                    process.exit(1);
+                }
+                else if (code === 127 || code === 8) {
+                    // Backspace
+                    if (input.length > 0) {
+                        input = input.slice(0, -1);
+                        process.stdout.write("\b \b");
+                    }
+                }
+                else {
+                    input += char;
+                    process.stdout.write("*");
+                }
+            };
+            stdin.on("data", onData);
+        }
+        else {
+            // Non-TTY fallback (piped input)
+            const rl = readline.createInterface({
+                input: process.stdin,
+                output: process.stdout,
+            });
+            rl.question("", (answer) => {
+                rl.close();
+                resolve(answer.trim());
+            });
+        }
+    });
+}
+async function validateApiKey(apiKey) {
+    try {
+        const client = new openai_1.default({ apiKey });
+        await client.models.list();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function runSetup() {
+    console.log(chalk_1.default.bold("\nTranscribly — API Key Setup\n"));
+    const apiKey = await promptApiKey();
+    if (!apiKey) {
+        console.error(chalk_1.default.red("No API key entered. Setup cancelled."));
+        process.exit(1);
+    }
+    const spinner = (0, utils_1.createSpinner)("Validating API key...");
+    spinner.start();
+    const valid = await validateApiKey(apiKey);
+    if (!valid) {
+        spinner.fail("API key validation failed. Please check the key and try again.");
+        process.exit(1);
+    }
+    spinner.succeed("API key validated.");
+    (0, config_1.writeConfig)({ apiKey });
+    console.log(chalk_1.default.green("\nAPI key saved to ~/.transcribly/config.json\n" +
+        "You can now run transcribly without setting OPENAI_API_KEY manually."));
+}
+async function handleTranscribeUrl(url, options) {
+    const apiKey = getApiKey(options);
+    if (!(0, youtube_1.isYouTubeUrl)(url)) {
+        console.error(chalk_1.default.red("Error: Invalid YouTube URL."));
+        process.exit(1);
+    }
+    const hasFfmpeg = await (0, dependencies_1.checkFfmpeg)();
+    if (!hasFfmpeg) {
+        console.error(chalk_1.default.red("Error: FFmpeg is required but not found."));
+        console.error(chalk_1.default.yellow((0, dependencies_1.getFfmpegInstallMessage)()));
+        console.error(chalk_1.default.gray("\nRun 'transcribly --doctor' to check all dependencies."));
+        process.exit(1);
+    }
+    const pythonResult = await (0, dependencies_1.checkPython)();
+    if (!pythonResult.ok) {
+        if (pythonResult.version) {
+            console.error(chalk_1.default.red(`Error: Python ${pythonResult.version} found, but 3.8+ is required.`));
+        }
+        else {
+            console.error(chalk_1.default.red("Error: Python 3.8+ is required but not found."));
+        }
+        console.error(chalk_1.default.yellow((0, dependencies_1.getPythonInstallMessage)()));
+        console.error(chalk_1.default.gray("\nRun 'transcribly --doctor' to check all dependencies."));
+        process.exit(1);
+    }
+    const tempDir = (0, utils_1.createTempDir)();
+    try {
+        const downloadResult = await (0, youtube_1.downloadYouTubeAudio)(url, tempDir);
+        const result = await (0, transcriber_1.transcribe)(downloadResult.filePath, apiKey);
+        console.log("\n" + chalk_1.default.green("--- Transcript ---"));
+        console.log(result.transcript);
+        console.log(chalk_1.default.green("--- End ---\n"));
+        saveOutput(result, downloadResult.videoId, options);
+    }
+    finally {
+        (0, utils_1.cleanupTempDir)(tempDir);
+    }
+}
+async function handleTranscribeFile(filePath, options) {
+    const apiKey = getApiKey(options);
+    const resolvedPath = (0, utils_1.validateFilePath)(filePath);
+    const hasFfmpeg = await (0, dependencies_1.checkFfmpeg)();
+    if (!hasFfmpeg) {
+        console.error(chalk_1.default.red("Error: FFmpeg is required but not found."));
+        console.error(chalk_1.default.yellow((0, dependencies_1.getFfmpegInstallMessage)()));
+        console.error(chalk_1.default.gray("\nRun 'transcribly --doctor' to check all dependencies."));
+        process.exit(1);
+    }
+    const result = await (0, transcriber_1.transcribe)(resolvedPath, apiKey);
+    const baseName = path.basename(resolvedPath, path.extname(resolvedPath));
+    console.log("\n" + chalk_1.default.green("--- Transcript ---"));
+    console.log(result.transcript);
+    console.log(chalk_1.default.green("--- End ---\n"));
+    saveOutput(result, baseName, options);
+}
+function saveOutput(result, baseName, options) {
+    const format = options.format;
+    (0, utils_1.ensureOutputDir)(options.output);
+    const outputPath = (0, utils_1.getOutputFilePath)(options.output, baseName, format);
+    if (format === "json") {
+        const jsonOutput = {
+            audioFile: result.audioFile,
+            transcript: result.transcript,
+        };
+        fs.writeFileSync(outputPath, JSON.stringify(jsonOutput, null, 2));
+    }
+    else {
+        fs.writeFileSync(outputPath, result.transcript);
+    }
+    console.log(chalk_1.default.blue(`Transcript saved to: ${outputPath}`));
+}
+program.parseAsync(process.argv).catch((error) => {
+    console.error(chalk_1.default.red(`Error: ${error.message}`));
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/transcriber.d.ts

@@ -0,0 +1,6 @@
+export interface TranscriptionResult {
+    transcript: string;
+    audioFile: string;
+}
+export declare function transcribe(filePath: string, apiKey: string): Promise<TranscriptionResult>;
+//# sourceMappingURL=transcriber.d.ts.map

package/dist/transcriber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcriber.d.ts","sourceRoot":"","sources":["../src/transcriber.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AA8FD,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,mBAAmB,CAAC,CAoC9B"}

package/dist/transcriber.js

@@ -0,0 +1,147 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.transcribe = transcribe;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const openai_1 = __importDefault(require("openai"));
+const fluent_ffmpeg_1 = __importDefault(require("fluent-ffmpeg"));
+const utils_1 = require("./utils");
+// Whisper API has a 25MB file size limit
+const MAX_CHUNK_SIZE_MB = 24;
+const CHUNK_DURATION_SECONDS = 180; // 3 minutes per chunk
+function getOpenAIClient(apiKey) {
+    return new openai_1.default({ apiKey });
+}
+function getFileSizeMB(filePath) {
+    const stats = fs.statSync(filePath);
+    return stats.size / (1024 * 1024);
+}
+function getAudioDuration(filePath) {
+    return new Promise((resolve, reject) => {
+        fluent_ffmpeg_1.default.ffprobe(filePath, (err, metadata) => {
+            if (err) {
+                reject(new Error(`Failed to probe audio file: ${err.message}`));
+                return;
+            }
+            resolve(metadata.format.duration || 0);
+        });
+    });
+}
+function splitAudioChunk(inputPath, outputPath, startSeconds, durationSeconds) {
+    return new Promise((resolve, reject) => {
+        (0, fluent_ffmpeg_1.default)(inputPath)
+            .setStartTime(startSeconds)
+            .setDuration(durationSeconds)
+            .output(outputPath)
+            .audioCodec("libmp3lame")
+            .on("end", () => resolve())
+            .on("error", (err) => reject(new Error(`Failed to split audio: ${err.message}`)))
+            .run();
+    });
+}
+async function splitAudio(filePath) {
+    const sizeMB = getFileSizeMB(filePath);
+    // If file is small enough, no splitting needed
+    if (sizeMB <= MAX_CHUNK_SIZE_MB) {
+        return [filePath];
+    }
+    const spinner = (0, utils_1.createSpinner)("Splitting audio into chunks...");
+    spinner.start();
+    try {
+        const duration = await getAudioDuration(filePath);
+        const chunkDir = (0, utils_1.createTempDir)();
+        const chunks = [];
+        let start = 0;
+        let index = 0;
+        while (start < duration) {
+            const chunkDuration = Math.min(CHUNK_DURATION_SECONDS, duration - start);
+            const chunkPath = path.join(chunkDir, `chunk_${index}.mp3`);
+            await splitAudioChunk(filePath, chunkPath, start, chunkDuration);
+            chunks.push(chunkPath);
+            start += chunkDuration;
+            index++;
+        }
+        spinner.succeed(`Split into ${chunks.length} chunks`);
+        return chunks;
+    }
+    catch (error) {
+        spinner.fail("Failed to split audio");
+        throw error;
+    }
+}
+async function transcribeFile(client, filePath) {
+    const fileStream = fs.createReadStream(filePath);
+    const response = await client.audio.transcriptions.create({
+        model: "whisper-1",
+        file: fileStream,
+        response_format: "text",
+    });
+    return response;
+}
+async function transcribe(filePath, apiKey) {
+    const client = getOpenAIClient(apiKey);
+    const chunks = await splitAudio(filePath);
+    const spinner = (0, utils_1.createSpinner)(`Transcribing${chunks.length > 1 ? ` ${chunks.length} chunks` : ""}...`);
+    spinner.start();
+    try {
+        const transcripts = [];
+        for (let i = 0; i < chunks.length; i++) {
+            if (chunks.length > 1) {
+                spinner.text = `Transcribing chunk ${i + 1}/${chunks.length}...`;
+            }
+            const text = await transcribeFile(client, chunks[i]);
+            transcripts.push(text.trim());
+        }
+        spinner.succeed("Transcription complete");
+        // Clean up chunk temp directory if we created chunks
+        if (chunks.length > 1 && chunks[0] !== filePath) {
+            const chunkDir = path.dirname(chunks[0]);
+            fs.rmSync(chunkDir, { recursive: true, force: true });
+        }
+        return {
+            transcript: transcripts.join(" "),
+            audioFile: filePath,
+        };
+    }
+    catch (error) {
+        spinner.fail("Transcription failed");
+        throw error;
+    }
+}
+//# sourceMappingURL=transcriber.js.map

package/dist/transcriber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcriber.js","sourceRoot":"","sources":["../src/transcriber.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2GA,gCAuCC;AAlJD,uCAAyB;AACzB,2CAA6B;AAC7B,oDAA4B;AAC5B,kEAAmC;AACnC,mCAAuD;AAEvD,yCAAyC;AACzC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAC7B,MAAM,sBAAsB,GAAG,GAAG,CAAC,CAAC,sBAAsB;AAO1D,SAAS,eAAe,CAAC,MAAc;IACrC,OAAO,IAAI,gBAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,aAAa,CAAC,QAAgB;IACrC,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACpC,OAAO,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAgB;IACxC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,uBAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE;YACzC,IAAI,GAAG,EAAE,CAAC;gBACR,MAAM,CAAC,IAAI,KAAK,CAAC,+BAA+B,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBAChE,OAAO;YACT,CAAC;YACD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CACtB,SAAiB,EACjB,UAAkB,EAClB,YAAoB,EACpB,eAAuB;IAEvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAA,uBAAM,EAAC,SAAS,CAAC;aACd,YAAY,CAAC,YAAY,CAAC;aAC1B,WAAW,CAAC,eAAe,CAAC;aAC5B,MAAM,CAAC,UAAU,CAAC;aAClB,UAAU,CAAC,YAAY,CAAC;aACxB,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;aAC1B,EAAE,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE,CAC1B,MAAM,CAAC,IAAI,KAAK,CAAC,0BAA0B,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAC3D;aACA,GAAG,EAAE,CAAC;IACX,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,QAAgB;IACxC,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAEvC,+CAA+C;IAC/C,IAAI,MAAM,IAAI,iBAAiB,EAAE,CAAC;QAChC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpB,CAAC;IAED,MAAM,OAAO,GAAG,IAAA,qBAAa,EAAC,gCAAgC,CAAC,CAAC;IAChE,OAAO,CAAC,KAAK,EAAE,CAAC;IAEhB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,IAAA,qBAAa,GAAE,CAAC;QACjC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,OAAO,KAAK,GAAG,QAAQ,EAAE,CAAC;YACxB,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAC5B,sBAAsB,EACtB,QAAQ,GAAG,KAAK,CACjB,CAAC;YACF,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,KAAK,MAAM,CAAC,CAAC;YAC5D,MAAM,eAAe,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC;YACjE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACvB,KAAK,IAAI,aAAa,CAAC;YACvB,KAAK,EAAE,CAAC;QACV,CAAC;QAED,OAAO,CAAC,OAAO,CAAC,cAAc,MAAM,CAAC,MAAM,SAAS,CAAC,CAAC;QACtD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACtC,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,cAAc,CAC3B,MAAc,EACd,QAAgB;IAEhB,MAAM,UAAU,GAAG,EAAE,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC;QACxD,KAAK,EAAE,WAAW;QAClB,IAAI,EAAE,UAAU;QAChB,eAAe,EAAE,MAAM;KACxB,CAAC,CAAC;IACH,OAAO,QAA6B,CAAC;AACvC,CAAC;AAEM,KAAK,UAAU,UAAU,CAC9B,QAAgB,EAChB,MAAc;IAEd,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;IAE1C,MAAM,OAAO,GAAG,IAAA,qBAAa,EAC3B,eAAe,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,MAAM,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,CACxE,CAAC;IACF,OAAO,CAAC,KAAK,EAAE,CAAC;IAEhB,IAAI,CAAC;QACH,MAAM,WAAW,GAAa,EAAE,CAAC;QAEjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtB,OAAO,CAAC,IAAI,GAAG,sBAAsB,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YACnE,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACrD,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAChC,CAAC;QAED,OAAO,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;QAE1C,qDAAqD;QACrD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;YAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACzC,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,CAAC;QAED,OAAO;YACL,UAAU,EAAE,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC;YACjC,SAAS,EAAE,QAAQ;SACpB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACrC,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,9 @@
+import { Ora } from "ora";
+export declare function createTempDir(): string;
+export declare function cleanupTempDir(tempDir: string): void;
+export declare function isSupportedAudioFile(filePath: string): boolean;
+export declare function validateFilePath(filePath: string): string;
+export declare function createSpinner(text: string): Ora;
+export declare function ensureOutputDir(outputDir: string): void;
+export declare function getOutputFilePath(outputDir: string, baseName: string, format: "txt" | "json"): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAGA,OAAY,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAc/B,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEpD;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAG9D;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAYzD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAE/C;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAIvD;AAED,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,KAAK,GAAG,MAAM,GACrB,MAAM,CAER"}

package/dist/utils.js

@@ -0,0 +1,93 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTempDir = createTempDir;
+exports.cleanupTempDir = cleanupTempDir;
+exports.isSupportedAudioFile = isSupportedAudioFile;
+exports.validateFilePath = validateFilePath;
+exports.createSpinner = createSpinner;
+exports.ensureOutputDir = ensureOutputDir;
+exports.getOutputFilePath = getOutputFilePath;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const ora_1 = __importDefault(require("ora"));
+const SUPPORTED_EXTENSIONS = new Set([
+    ".mp3",
+    ".mp4",
+    ".wav",
+    ".webm",
+    ".m4a",
+    ".ogg",
+    ".flac",
+    ".mpeg",
+    ".mpga",
+]);
+function createTempDir() {
+    return fs.mkdtempSync(path.join(os.tmpdir(), "transcribly-"));
+}
+function cleanupTempDir(tempDir) {
+    fs.rmSync(tempDir, { recursive: true, force: true });
+}
+function isSupportedAudioFile(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    return SUPPORTED_EXTENSIONS.has(ext);
+}
+function validateFilePath(filePath) {
+    const resolved = path.resolve(filePath);
+    if (!fs.existsSync(resolved)) {
+        throw new Error(`File not found: ${resolved}`);
+    }
+    if (!isSupportedAudioFile(resolved)) {
+        const ext = path.extname(resolved);
+        throw new Error(`Unsupported file type "${ext}". Supported: ${[...SUPPORTED_EXTENSIONS].join(", ")}`);
+    }
+    return resolved;
+}
+function createSpinner(text) {
+    return (0, ora_1.default)({ text, spinner: "dots" });
+}
+function ensureOutputDir(outputDir) {
+    if (!fs.existsSync(outputDir)) {
+        fs.mkdirSync(outputDir, { recursive: true });
+    }
+}
+function getOutputFilePath(outputDir, baseName, format) {
+    return path.join(outputDir, `${baseName}.${format}`);
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiBA,sCAEC;AAED,wCAEC;AAED,oDAGC;AAED,4CAYC;AAED,sCAEC;AAED,0CAIC;AAED,8CAMC;AA5DD,uCAAyB;AACzB,2CAA6B;AAC7B,uCAAyB;AACzB,8CAA+B;AAE/B,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACnC,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;IACP,OAAO;CACR,CAAC,CAAC;AAEH,SAAgB,aAAa;IAC3B,OAAO,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,SAAgB,cAAc,CAAC,OAAe;IAC5C,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACvD,CAAC;AAED,SAAgB,oBAAoB,CAAC,QAAgB;IACnD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACjD,OAAO,oBAAoB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACvC,CAAC;AAED,SAAgB,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,IAAI,KAAK,CACb,0BAA0B,GAAG,iBAAiB,CAAC,GAAG,oBAAoB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACrF,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAgB,aAAa,CAAC,IAAY;IACxC,OAAO,IAAA,aAAG,EAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;AACxC,CAAC;AAED,SAAgB,eAAe,CAAC,SAAiB;IAC/C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC;AAED,SAAgB,iBAAiB,CAC/B,SAAiB,EACjB,QAAgB,EAChB,MAAsB;IAEtB,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,QAAQ,IAAI,MAAM,EAAE,CAAC,CAAC;AACvD,CAAC"}

package/dist/youtube.d.ts

@@ -0,0 +1,8 @@
+export interface YouTubeDownloadResult {
+    filePath: string;
+    videoId: string;
+    title: string;
+}
+export declare function downloadYouTubeAudio(url: string, outputDir: string): Promise<YouTubeDownloadResult>;
+export declare function isYouTubeUrl(url: string): boolean;
+//# sourceMappingURL=youtube.d.ts.map

package/dist/youtube.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"youtube.d.ts","sourceRoot":"","sources":["../src/youtube.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,qBAAqB,CAAC,CAqChC;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEjD"}