fylzap 1.1.0

package/README.md

@@ -0,0 +1,66 @@
+# fylzap
+
+Convert files from your terminal — PDF, DOCX, images and more.
+
+## Install
+```bash
+npm install -g fylzap
+# or run without installing:
+npx fylzap document.pdf
+```
+
+## Setup
+
+Get your API key from [yourapp.com/dashboard](https://yourapp.com/dashboard), then:
+```bash
+fylzap config --key fc_live_your_key_here
+```
+
+## Usage
+```bash
+# Convert PDF to Markdown
+fylzap document.pdf
+
+# Specify output format
+fylzap document.pdf --output txt
+
+# Convert image with OCR
+fylzap scan.png --output txt --language eng
+
+# Save to specific directory
+fylzap document.pdf --out-dir ./output
+
+# Use AI mode for better PDF quality
+fylzap document.pdf --ai
+
+# Multiple files
+fylzap *.pdf --output md --out-dir ./converted
+
+# One-time key (without saving)
+fylzap document.pdf --key fc_live_xxx
+```
+
+## Supported Formats
+
+| Input | Output |
+|-------|--------|
+| PDF | Markdown, Text |
+| Word (DOCX) | Markdown, Text |
+| CSV | JSON |
+| JSON | CSV |
+| Images (JPG, PNG, WEBP, etc.) | Text (OCR) |
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `fylzap <file>` | Convert a file |
+| `fylzap config --key <key>` | Save API key |
+| `fylzap config --show` | Show current config |
+| `fylzap formats` | List supported formats |
+
+## Environment Variables
+```bash
+FYLZAP_API_KEY=fc_live_xxx   # API key
+FYLZAP_API_URL=https://...   # Custom API URL
+```

package/dist/commands/convert.d.ts

@@ -0,0 +1,10 @@
+interface ConvertOptions {
+    output: string;
+    outDir?: string;
+    language: string;
+    ai: boolean;
+    key?: string;
+}
+export declare function convertFile(filePath: string, options: ConvertOptions): Promise<void>;
+export declare function convertMultiple(files: string[], options: ConvertOptions): Promise<void>;
+export {};

package/dist/commands/convert.js

@@ -0,0 +1,155 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertFile = convertFile;
+exports.convertMultiple = convertMultiple;
+const axios_1 = __importDefault(require("axios"));
+const form_data_1 = __importDefault(require("form-data"));
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const progress_1 = require("../utils/progress");
+const formatter_1 = require("../utils/formatter");
+const config_1 = require("../utils/config");
+const SUPPORTED_INPUTS = [
+    "pdf", "docx",
+    "md",
+    "csv", "json",
+    "yaml", "yml",
+    "jpg", "jpeg", "png", "gif", "bmp", "tiff", "webp",
+];
+const SUPPORTED_OUTPUTS = {
+    pdf: ["md", "txt", "json"],
+    docx: ["md", "txt"],
+    md: ["pdf", "epub"],
+    csv: ["json"],
+    json: ["csv"],
+    yaml: ["md"],
+    yml: ["md"],
+    jpg: ["txt"], jpeg: ["txt"], png: ["txt"],
+    gif: ["txt"], bmp: ["txt"], tiff: ["txt"], webp: ["txt"],
+};
+async function convertFile(filePath, options) {
+    const absPath = path_1.default.resolve(filePath);
+    if (!fs_1.default.existsSync(absPath)) {
+        (0, formatter_1.printError)(`File not found: ${filePath}`);
+        process.exit(1);
+    }
+    const ext = path_1.default.extname(absPath).slice(1).toLowerCase();
+    if (!SUPPORTED_INPUTS.includes(ext)) {
+        (0, formatter_1.printError)(`Unsupported file type: .${ext}`);
+        (0, formatter_1.printInfo)(`Supported inputs: ${SUPPORTED_INPUTS.join(", ")}`);
+        process.exit(1);
+    }
+    // Validate output format for input type
+    const validOutputs = SUPPORTED_OUTPUTS[ext] ?? [];
+    if (!validOutputs.includes(options.output)) {
+        (0, formatter_1.printError)(`Cannot convert .${ext} to .${options.output}`);
+        (0, formatter_1.printInfo)(`Valid outputs for .${ext}: ${validOutputs.join(", ")}`);
+        process.exit(1);
+    }
+    const apiKey = options.key ?? (0, config_1.getApiKey)();
+    if (!apiKey) {
+        (0, formatter_1.printError)("No API key found.");
+        (0, formatter_1.printInfo)("Set your key with:  fylzap config --key fc_live_xxx");
+        (0, formatter_1.printInfo)("Or set env var:     FYLZAP_API_KEY=fc_live_xxx");
+        process.exit(1);
+    }
+    const apiUrl = (0, config_1.getApiUrl)();
+    const outputExt = options.output;
+    const filename = path_1.default.basename(absPath);
+    const saveDir = (0, formatter_1.getSaveDir)(options.outDir);
+    const baseName = path_1.default.basename(absPath, path_1.default.extname(absPath));
+    (0, formatter_1.ensureDir)(saveDir);
+    const progress = (0, progress_1.createProgressBar)(filename);
+    progress.start();
+    const startTime = Date.now();
+    try {
+        progress.update(10, `Uploading ${filename}...`);
+        const form = new form_data_1.default();
+        form.append("files", fs_1.default.createReadStream(absPath), filename);
+        form.append("outputType", outputExt);
+        form.append("splitMode", "whole");
+        form.append("useAI", options.ai.toString());
+        const imageExts = ["jpg", "jpeg", "png", "gif", "bmp", "tiff", "webp"];
+        if (imageExts.includes(ext) && outputExt === "txt") {
+            form.append("ocrLanguage", options.language);
+        }
+        progress.update(30, "Converting...");
+        const response = await axios_1.default.post(`${apiUrl}/api/converter`, form, {
+            headers: {
+                ...form.getHeaders(),
+                Authorization: `Bearer ${apiKey}`,
+            },
+            responseType: "arraybuffer",
+            maxContentLength: Infinity,
+            maxBodyLength: Infinity,
+            onUploadProgress: (e) => {
+                if (e.total) {
+                    const pct = Math.round((e.loaded / e.total) * 30) + 10;
+                    progress.update(pct, "Uploading...");
+                }
+            },
+        });
+        progress.update(80, "Saving output...");
+        const contentType = response.headers["content-type"] ?? "";
+        const isZip = contentType.includes("application/zip");
+        const outExt = isZip ? "zip" : outputExt;
+        const outFilename = `${baseName}.${outExt}`;
+        const outPath = path_1.default.join(saveDir, outFilename);
+        fs_1.default.writeFileSync(outPath, Buffer.from(response.data));
+        progress.update(100, "Done!");
+        progress.stop();
+        const elapsed = Date.now() - startTime;
+        (0, formatter_1.printSuccess)(absPath, outPath, elapsed);
+        if (isZip) {
+            (0, formatter_1.printInfo)(`Output is a ZIP (contains markdown + images) → ${outPath}`);
+        }
+    }
+    catch (error) {
+        progress.stop();
+        if (axios_1.default.isAxiosError(error)) {
+            if (error.response?.status === 401) {
+                (0, formatter_1.printError)("Invalid or expired API key.");
+                (0, formatter_1.printInfo)("Get a new key at: https://fylzap.com/dashboard");
+            }
+            else if (error.response?.status === 429) {
+                (0, formatter_1.printError)("Rate limit reached. Upgrade your plan for more conversions.");
+                (0, formatter_1.printInfo)("Upgrade at: https://fylzap.com/pricing");
+            }
+            else if (error.response?.status === 413) {
+                (0, formatter_1.printError)("File too large for your current plan.");
+                (0, formatter_1.printInfo)("Upgrade at: https://fylzap.com/pricing");
+            }
+            else {
+                const msg = error.response?.data
+                    ? Buffer.from(error.response.data).toString()
+                    : error.message;
+                (0, formatter_1.printError)(`Conversion failed: ${msg}`);
+            }
+        }
+        else {
+            (0, formatter_1.printError)(`Unexpected error: ${error.message}`);
+        }
+        process.exit(1);
+    }
+}
+async function convertMultiple(files, options) {
+    const results = { success: 0, failed: 0 };
+    for (const file of files) {
+        try {
+            await convertFile(file, options);
+            results.success++;
+        }
+        catch {
+            results.failed++;
+        }
+    }
+    if (files.length > 1) {
+        console.log(chalk_1.default.gray(`\n  Summary: `) +
+            chalk_1.default.green(`${results.success} converted`) +
+            (results.failed > 0 ? chalk_1.default.red(` · ${results.failed} failed`) : ""));
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,128 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const convert_1 = require("./commands/convert");
+const config_1 = require("./utils/config");
+const formatter_1 = require("./utils/formatter");
+const glob_1 = require("glob");
+const program = new commander_1.Command();
+program
+    .name("fylzap")
+    .description("Convert files from your terminal — PDF, DOCX, Markdown, images and more")
+    .version("1.1.0");
+// ── Convert command (default) ─────────────────────────────────────────────────
+program
+    .command("convert <files...>", { isDefault: true })
+    .description("Convert one or more files")
+    .option("-o, --output <type>", "Output format: md, txt, json, csv, pdf, epub", "md")
+    .option("-d, --out-dir <dir>", "Output directory (default: current directory)")
+    .option("-l, --language <code>", "OCR language code (for image→txt)", "eng")
+    .option("--ai", "Use AI mode for PDF→MD (better quality, slower)")
+    .option("-k, --key <apikey>", "API key (overrides saved key)")
+    .action(async (files, options) => {
+    (0, formatter_1.printBanner)();
+    // Expand globs on Windows (Unix handles this in shell)
+    const expanded = [];
+    for (const pattern of files) {
+        if (pattern.includes("*")) {
+            const matches = (0, glob_1.globSync)(pattern);
+            if (matches.length === 0) {
+                (0, formatter_1.printError)(`No files matched: ${pattern}`);
+                process.exit(1);
+            }
+            expanded.push(...matches);
+        }
+        else {
+            expanded.push(pattern);
+        }
+    }
+    if (expanded.length === 1) {
+        await (0, convert_1.convertFile)(expanded[0], {
+            output: options.output,
+            outDir: options.outDir,
+            language: options.language,
+            ai: !!options.ai,
+            key: options.key,
+        });
+    }
+    else {
+        (0, formatter_1.printInfo)(`Converting ${expanded.length} files...\n`);
+        await (0, convert_1.convertMultiple)(expanded, {
+            output: options.output,
+            outDir: options.outDir,
+            language: options.language,
+            ai: !!options.ai,
+            key: options.key,
+        });
+    }
+});
+// ── Config command ────────────────────────────────────────────────────────────
+program
+    .command("config")
+    .description("Configure fylzap settings")
+    .option("-k, --key <apikey>", "Save your API key")
+    .option("-u, --url <url>", "Set custom API URL (for self-hosted)")
+    .option("--show", "Show current config")
+    .option("--clear", "Clear all saved config")
+    .action((options) => {
+    if (options.key) {
+        if (!options.key.startsWith("fc_live_")) {
+            (0, formatter_1.printError)("Invalid API key format. Keys must start with fc_live_");
+            process.exit(1);
+        }
+        (0, config_1.setApiKey)(options.key);
+        console.log(chalk_1.default.green("  ✓ API key saved"));
+        return;
+    }
+    if (options.url) {
+        (0, config_1.setApiUrl)(options.url);
+        console.log(chalk_1.default.green(`  ✓ API URL set to: ${options.url}`));
+        return;
+    }
+    if (options.clear) {
+        (0, config_1.clearConfig)();
+        console.log(chalk_1.default.green("  ✓ Config cleared"));
+        return;
+    }
+    if (options.show) {
+        const key = (0, config_1.getApiKey)();
+        const url = (0, config_1.getApiUrl)();
+        console.log(chalk_1.default.gray("  API Key: ") + (key ? chalk_1.default.white(key.substring(0, 20) + "...") : chalk_1.default.red("not set")));
+        console.log(chalk_1.default.gray("  API URL: ") + chalk_1.default.white(url));
+        return;
+    }
+    program.commands.find(c => c.name() === "config")?.help();
+});
+// ── Formats command ───────────────────────────────────────────────────────────
+program
+    .command("formats")
+    .description("List supported input and output formats")
+    .action(() => {
+    (0, formatter_1.printBanner)();
+    console.log(chalk_1.default.bold("  Supported conversions:\n"));
+    const formats = [
+        ["PDF (.pdf)", "Markdown (.md), Text (.txt), JSON (.json)"],
+        ["Word (.docx)", "Markdown (.md), Text (.txt)"],
+        ["Markdown (.md)", "PDF (.pdf), EPUB (.epub)"],
+        ["CSV (.csv)", "JSON (.json)"],
+        ["JSON (.json)", "CSV (.csv)"],
+        ["OpenAPI/YAML (.yaml)", "Markdown (.md) — API docs"],
+        ["Image (.jpg, .png, etc)", "Text via OCR (.txt)"],
+    ];
+    formats.forEach(([input, output]) => {
+        console.log(chalk_1.default.cyan(`  ${input.padEnd(35)}`) +
+            chalk_1.default.gray("→  ") +
+            chalk_1.default.white(output));
+    });
+    console.log();
+    console.log(chalk_1.default.gray("  Flags:"));
+    console.log(chalk_1.default.gray("  --ai          ") + chalk_1.default.white("AI-powered PDF→MD (Pro/Enterprise)"));
+    console.log(chalk_1.default.gray("  --language    ") + chalk_1.default.white("OCR language: eng, ara, urd, fra, ger, spa..."));
+    console.log();
+});
+program.parse(process.argv);

package/dist/utils/config.d.ts

@@ -0,0 +1,5 @@
+export declare function getApiKey(): string | undefined;
+export declare function setApiKey(key: string): void;
+export declare function getApiUrl(): string;
+export declare function setApiUrl(url: string): void;
+export declare function clearConfig(): void;

package/dist/utils/config.js

@@ -0,0 +1,32 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getApiKey = getApiKey;
+exports.setApiKey = setApiKey;
+exports.getApiUrl = getApiUrl;
+exports.setApiUrl = setApiUrl;
+exports.clearConfig = clearConfig;
+const conf_1 = __importDefault(require("conf"));
+const config = new conf_1.default({
+    projectName: "fylzap",
+    defaults: {
+        apiUrl: "https://yourapp.com", // ← replace with your actual domain
+    },
+});
+function getApiKey() {
+    return process.env.FYLZAP_API_KEY ?? config.get("apiKey");
+}
+function setApiKey(key) {
+    config.set("apiKey", key);
+}
+function getApiUrl() {
+    return process.env.FYLZAP_API_URL ?? config.get("apiUrl") ?? "https://yourapp.com";
+}
+function setApiUrl(url) {
+    config.set("apiUrl", url);
+}
+function clearConfig() {
+    config.clear();
+}

package/dist/utils/formatter.d.ts

@@ -0,0 +1,6 @@
+export declare function printBanner(): void;
+export declare function printSuccess(inputFile: string, outputFile: string, ms: number): void;
+export declare function printError(message: string): void;
+export declare function printInfo(message: string): void;
+export declare function getSaveDir(outputDir?: string): string;
+export declare function ensureDir(dir: string): void;

package/dist/utils/formatter.js

@@ -0,0 +1,41 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printBanner = printBanner;
+exports.printSuccess = printSuccess;
+exports.printError = printError;
+exports.printInfo = printInfo;
+exports.getSaveDir = getSaveDir;
+exports.ensureDir = ensureDir;
+const chalk_1 = __importDefault(require("chalk"));
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+function printBanner() {
+    console.log(chalk_1.default.bold.blue("\n  fylzap") + chalk_1.default.gray(" — file converter CLI"));
+    console.log(chalk_1.default.gray("  ─────────────────────────────\n"));
+}
+function printSuccess(inputFile, outputFile, ms) {
+    console.log(chalk_1.default.green("  ✓") +
+        chalk_1.default.white(` ${path_1.default.basename(inputFile)}`) +
+        chalk_1.default.gray(` → `) +
+        chalk_1.default.white(path_1.default.basename(outputFile)) +
+        chalk_1.default.gray(` (${(ms / 1000).toFixed(1)}s)`));
+}
+function printError(message) {
+    console.log(chalk_1.default.red("  ✗ ") + chalk_1.default.white(message));
+}
+function printInfo(message) {
+    console.log(chalk_1.default.gray("  ℹ ") + chalk_1.default.white(message));
+}
+function getSaveDir(outputDir) {
+    return outputDir
+        ? path_1.default.resolve(outputDir)
+        : process.cwd();
+}
+function ensureDir(dir) {
+    if (!fs_1.default.existsSync(dir)) {
+        fs_1.default.mkdirSync(dir, { recursive: true });
+    }
+}

package/dist/utils/progress.d.ts

@@ -0,0 +1,5 @@
+export declare function createProgressBar(filename: string): {
+    start: () => void;
+    update: (pct: number, status: string) => void;
+    stop: () => void;
+};

package/dist/utils/progress.js

@@ -0,0 +1,21 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createProgressBar = createProgressBar;
+const cli_progress_1 = __importDefault(require("cli-progress"));
+const chalk_1 = __importDefault(require("chalk"));
+function createProgressBar(filename) {
+    const bar = new cli_progress_1.default.SingleBar({
+        format: chalk_1.default.cyan("{bar}") + " {percentage}% | {status}",
+        barCompleteChar: "█",
+        barIncompleteChar: "░",
+        hideCursor: true,
+    }, cli_progress_1.default.Presets.shades_classic);
+    return {
+        start: () => bar.start(100, 0, { status: `Converting ${filename}...` }),
+        update: (pct, status) => bar.update(pct, { status }),
+        stop: () => bar.stop(),
+    };
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "fylzap",
+  "version": "1.1.0",
+  "description": "Convert files from your terminal — PDF, DOCX, images and more",
+  "keywords": ["converter", "pdf", "markdown", "docx", "ocr", "cli"],
+  "author": "Muhammad Ali Raza",
+  "license": "MIT",
+  "homepage": "https://fylzap.com",
+  "main": "dist/index.js",
+  "bin": {
+    "fylzap": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node src/index.ts",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "axios": "^1.6.0",
+    "chalk": "^4.1.2",
+    "cli-progress": "^3.12.0",
+    "commander": "^11.0.0",
+    "conf": "^10.2.0",
+    "form-data": "^4.0.0",
+    "glob": "^13.0.6",
+    "ora": "^5.4.1"
+  },
+  "devDependencies": {
+    "@types/cli-progress": "^3.11.0",
+    "@types/glob": "^8.1.0",
+    "@types/node": "^20.0.0",
+    "ts-node": "^10.9.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}

package/src/commands/convert.ts

@@ -0,0 +1,184 @@
+import axios       from "axios";
+import FormData    from "form-data";
+import fs          from "fs";
+import path        from "path";
+import chalk       from "chalk";
+import { createProgressBar }           from "../utils/progress";
+import { printSuccess, printError, printInfo, getSaveDir, ensureDir } from "../utils/formatter";
+import { getApiKey, getApiUrl }        from "../utils/config";
+
+const SUPPORTED_INPUTS  = [
+  "pdf", "docx",
+  "md",
+  "csv", "json",
+  "yaml", "yml",
+  "jpg", "jpeg", "png", "gif", "bmp", "tiff", "webp",
+];
+
+const SUPPORTED_OUTPUTS: Record<string, string[]> = {
+  pdf:  ["md", "txt", "json"],
+  docx: ["md", "txt"],
+  md:   ["pdf", "epub"],
+  csv:  ["json"],
+  json: ["csv"],
+  yaml: ["md"],
+  yml:  ["md"],
+  jpg:  ["txt"], jpeg: ["txt"], png: ["txt"],
+  gif:  ["txt"], bmp:  ["txt"], tiff: ["txt"], webp: ["txt"],
+};
+
+interface ConvertOptions {
+  output:   string;
+  outDir?:  string;
+  language: string;
+  ai:       boolean;
+  key?:     string;
+}
+
+export async function convertFile(
+  filePath: string,
+  options:  ConvertOptions
+): Promise<void> {
+  const absPath = path.resolve(filePath);
+  if (!fs.existsSync(absPath)) {
+    printError(`File not found: ${filePath}`);
+    process.exit(1);
+  }
+
+  const ext = path.extname(absPath).slice(1).toLowerCase();
+  if (!SUPPORTED_INPUTS.includes(ext)) {
+    printError(`Unsupported file type: .${ext}`);
+    printInfo(`Supported inputs: ${SUPPORTED_INPUTS.join(", ")}`);
+    process.exit(1);
+  }
+
+  // Validate output format for input type
+  const validOutputs = SUPPORTED_OUTPUTS[ext] ?? [];
+  if (!validOutputs.includes(options.output)) {
+    printError(`Cannot convert .${ext} to .${options.output}`);
+    printInfo(`Valid outputs for .${ext}: ${validOutputs.join(", ")}`);
+    process.exit(1);
+  }
+
+  const apiKey = options.key ?? getApiKey();
+  if (!apiKey) {
+    printError("No API key found.");
+    printInfo("Set your key with:  fylzap config --key fc_live_xxx");
+    printInfo("Or set env var:     FYLZAP_API_KEY=fc_live_xxx");
+    process.exit(1);
+  }
+
+  const apiUrl    = getApiUrl();
+  const outputExt = options.output;
+  const filename  = path.basename(absPath);
+  const saveDir   = getSaveDir(options.outDir);
+  const baseName  = path.basename(absPath, path.extname(absPath));
+
+  ensureDir(saveDir);
+
+  const progress = createProgressBar(filename);
+  progress.start();
+  const startTime = Date.now();
+
+  try {
+    progress.update(10, `Uploading ${filename}...`);
+
+    const form = new FormData();
+    form.append("files",      fs.createReadStream(absPath), filename);
+    form.append("outputType", outputExt);
+    form.append("splitMode",  "whole");
+    form.append("useAI",      options.ai.toString());
+
+    const imageExts = ["jpg","jpeg","png","gif","bmp","tiff","webp"];
+    if (imageExts.includes(ext) && outputExt === "txt") {
+      form.append("ocrLanguage", options.language);
+    }
+
+    progress.update(30, "Converting...");
+
+    const response = await axios.post(`${apiUrl}/api/converter`, form, {
+      headers: {
+        ...form.getHeaders(),
+        Authorization: `Bearer ${apiKey}`,
+      },
+      responseType: "arraybuffer",
+      maxContentLength: Infinity,
+      maxBodyLength:    Infinity,
+      onUploadProgress: (e) => {
+        if (e.total) {
+          const pct = Math.round((e.loaded / e.total) * 30) + 10;
+          progress.update(pct, "Uploading...");
+        }
+      },
+    });
+
+    progress.update(80, "Saving output...");
+
+    const contentType = response.headers["content-type"] ?? "";
+    const isZip       = contentType.includes("application/zip");
+    const outExt      = isZip ? "zip" : outputExt;
+    const outFilename = `${baseName}.${outExt}`;
+    const outPath     = path.join(saveDir, outFilename);
+
+    fs.writeFileSync(outPath, Buffer.from(response.data));
+
+    progress.update(100, "Done!");
+    progress.stop();
+
+    const elapsed = Date.now() - startTime;
+    printSuccess(absPath, outPath, elapsed);
+
+    if (isZip) {
+      printInfo(`Output is a ZIP (contains markdown + images) → ${outPath}`);
+    }
+
+  } catch (error: any) {
+    progress.stop();
+
+    if (axios.isAxiosError(error)) {
+      if (error.response?.status === 401) {
+        printError("Invalid or expired API key.");
+        printInfo("Get a new key at: https://fylzap.com/dashboard");
+      } else if (error.response?.status === 429) {
+        printError("Rate limit reached. Upgrade your plan for more conversions.");
+        printInfo("Upgrade at: https://fylzap.com/pricing");
+      } else if (error.response?.status === 413) {
+        printError("File too large for your current plan.");
+        printInfo("Upgrade at: https://fylzap.com/pricing");
+      } else {
+        const msg = error.response?.data
+          ? Buffer.from(error.response.data).toString()
+          : error.message;
+        printError(`Conversion failed: ${msg}`);
+      }
+    } else {
+      printError(`Unexpected error: ${error.message}`);
+    }
+
+    process.exit(1);
+  }
+}
+
+export async function convertMultiple(
+  files:   string[],
+  options: ConvertOptions
+): Promise<void> {
+  const results = { success: 0, failed: 0 };
+
+  for (const file of files) {
+    try {
+      await convertFile(file, options);
+      results.success++;
+    } catch {
+      results.failed++;
+    }
+  }
+
+  if (files.length > 1) {
+    console.log(
+      chalk.gray(`\n  Summary: `) +
+      chalk.green(`${results.success} converted`) +
+      (results.failed > 0 ? chalk.red(` · ${results.failed} failed`) : "")
+    );
+  }
+}

package/src/index.ts

@@ -0,0 +1,137 @@
+#!/usr/bin/env node
+
+import { Command } from "commander";
+import chalk       from "chalk";
+import { convertFile, convertMultiple } from "./commands/convert";
+import { setApiKey, setApiUrl, getApiKey, getApiUrl, clearConfig } from "./utils/config";
+import { printBanner, printInfo, printError } from "./utils/formatter";
+import { globSync } from "glob";
+import path         from "path";
+
+const program = new Command();
+
+program
+  .name("fylzap")
+  .description("Convert files from your terminal — PDF, DOCX, Markdown, images and more")
+  .version("1.1.0");
+
+// ── Convert command (default) ─────────────────────────────────────────────────
+program
+  .command("convert <files...>", { isDefault: true })
+  .description("Convert one or more files")
+  .option("-o, --output <type>",    "Output format: md, txt, json, csv, pdf, epub", "md")
+  .option("-d, --out-dir <dir>",    "Output directory (default: current directory)")
+  .option("-l, --language <code>",  "OCR language code (for image→txt)", "eng")
+  .option("--ai",                   "Use AI mode for PDF→MD (better quality, slower)")
+  .option("-k, --key <apikey>",     "API key (overrides saved key)")
+  .action(async (files: string[], options) => {
+    printBanner();
+
+    // Expand globs on Windows (Unix handles this in shell)
+    const expanded: string[] = [];
+    for (const pattern of files) {
+      if (pattern.includes("*")) {
+        const matches = globSync(pattern);
+        if (matches.length === 0) {
+          printError(`No files matched: ${pattern}`);
+          process.exit(1);
+        }
+        expanded.push(...matches);
+      } else {
+        expanded.push(pattern);
+      }
+    }
+
+    if (expanded.length === 1) {
+      await convertFile(expanded[0], {
+        output:   options.output,
+        outDir:   options.outDir,
+        language: options.language,
+        ai:       !!options.ai,
+        key:      options.key,
+      });
+    } else {
+      printInfo(`Converting ${expanded.length} files...\n`);
+      await convertMultiple(expanded, {
+        output:   options.output,
+        outDir:   options.outDir,
+        language: options.language,
+        ai:       !!options.ai,
+        key:      options.key,
+      });
+    }
+  });
+
+// ── Config command ────────────────────────────────────────────────────────────
+program
+  .command("config")
+  .description("Configure fylzap settings")
+  .option("-k, --key <apikey>",  "Save your API key")
+  .option("-u, --url <url>",     "Set custom API URL (for self-hosted)")
+  .option("--show",              "Show current config")
+  .option("--clear",             "Clear all saved config")
+  .action((options) => {
+    if (options.key) {
+      if (!options.key.startsWith("fc_live_")) {
+        printError("Invalid API key format. Keys must start with fc_live_");
+        process.exit(1);
+      }
+      setApiKey(options.key);
+      console.log(chalk.green("  ✓ API key saved"));
+      return;
+    }
+
+    if (options.url) {
+      setApiUrl(options.url);
+      console.log(chalk.green(`  ✓ API URL set to: ${options.url}`));
+      return;
+    }
+
+    if (options.clear) {
+      clearConfig();
+      console.log(chalk.green("  ✓ Config cleared"));
+      return;
+    }
+
+    if (options.show) {
+      const key = getApiKey();
+      const url = getApiUrl();
+      console.log(chalk.gray("  API Key: ") + (key ? chalk.white(key.substring(0, 20) + "...") : chalk.red("not set")));
+      console.log(chalk.gray("  API URL: ") + chalk.white(url));
+      return;
+    }
+
+    program.commands.find(c => c.name() === "config")?.help();
+  });
+
+// ── Formats command ───────────────────────────────────────────────────────────
+program
+  .command("formats")
+  .description("List supported input and output formats")
+  .action(() => {
+    printBanner();
+    console.log(chalk.bold("  Supported conversions:\n"));
+    const formats = [
+      ["PDF (.pdf)",              "Markdown (.md), Text (.txt), JSON (.json)"],
+      ["Word (.docx)",            "Markdown (.md), Text (.txt)"],
+      ["Markdown (.md)",          "PDF (.pdf), EPUB (.epub)"],
+      ["CSV (.csv)",              "JSON (.json)"],
+      ["JSON (.json)",            "CSV (.csv)"],
+      ["OpenAPI/YAML (.yaml)",    "Markdown (.md) — API docs"],
+      ["Image (.jpg, .png, etc)", "Text via OCR (.txt)"],
+    ];
+    formats.forEach(([input, output]) => {
+      console.log(
+        chalk.cyan(`  ${input.padEnd(35)}`) +
+        chalk.gray("→  ") +
+        chalk.white(output)
+      );
+    });
+    console.log();
+    console.log(chalk.gray("  Flags:"));
+    console.log(chalk.gray("  --ai          ") + chalk.white("AI-powered PDF→MD (Pro/Enterprise)"));
+    console.log(chalk.gray("  --language    ") + chalk.white("OCR language: eng, ara, urd, fra, ger, spa..."));
+    console.log();
+  });
+
+program.parse(process.argv);

package/src/utils/config.ts

@@ -0,0 +1,33 @@
+import Conf from "conf";
+
+interface FylzapConfig {
+  apiKey?: string;
+  apiUrl?: string;
+}
+
+const config = new Conf<FylzapConfig>({
+  projectName: "fylzap",
+  defaults: {
+    apiUrl: "https://yourapp.com", // ← replace with your actual domain
+  },
+});
+
+export function getApiKey(): string | undefined {
+  return process.env.FYLZAP_API_KEY ?? config.get("apiKey");
+}
+
+export function setApiKey(key: string): void {
+  config.set("apiKey", key);
+}
+
+export function getApiUrl(): string {
+  return process.env.FYLZAP_API_URL ?? config.get("apiUrl") ?? "https://yourapp.com";
+}
+
+export function setApiUrl(url: string): void {
+  config.set("apiUrl", url);
+}
+
+export function clearConfig(): void {
+  config.clear();
+}

package/src/utils/formatter.ts

@@ -0,0 +1,38 @@
+import chalk from "chalk";
+import path  from "path";
+import fs    from "fs";
+
+export function printBanner() {
+  console.log(chalk.bold.blue("\n  fylzap") + chalk.gray(" — file converter CLI"));
+  console.log(chalk.gray("  ─────────────────────────────\n"));
+}
+
+export function printSuccess(inputFile: string, outputFile: string, ms: number) {
+  console.log(
+    chalk.green("  ✓") +
+    chalk.white(` ${path.basename(inputFile)}`) +
+    chalk.gray(` → `) +
+    chalk.white(path.basename(outputFile)) +
+    chalk.gray(` (${(ms / 1000).toFixed(1)}s)`)
+  );
+}
+
+export function printError(message: string) {
+  console.log(chalk.red("  ✗ ") + chalk.white(message));
+}
+
+export function printInfo(message: string) {
+  console.log(chalk.gray("  ℹ ") + chalk.white(message));
+}
+
+export function getSaveDir(outputDir?: string): string {
+  return outputDir
+    ? path.resolve(outputDir)
+    : process.cwd();
+}
+
+export function ensureDir(dir: string): void {
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+}

package/src/utils/progress.ts

@@ -0,0 +1,20 @@
+import cliProgress from "cli-progress";
+import chalk        from "chalk";
+
+export function createProgressBar(filename: string) {
+  const bar = new cliProgress.SingleBar(
+    {
+      format: chalk.cyan("{bar}") + " {percentage}% | {status}",
+      barCompleteChar:   "█",
+      barIncompleteChar: "░",
+      hideCursor:        true,
+    },
+    cliProgress.Presets.shades_classic
+  );
+
+  return {
+    start: () => bar.start(100, 0, { status: `Converting ${filename}...` }),
+    update: (pct: number, status: string) => bar.update(pct, { status }),
+    stop:   () => bar.stop(),
+  };
+}

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target":            "ES2020",
+    "module":            "commonjs",
+    "lib":               ["ES2020"],
+    "outDir":            "./dist",
+    "rootDir":           "./src",
+    "strict":            true,
+    "esModuleInterop":   true,
+    "skipLibCheck":      true,
+    "resolveJsonModule": true,
+    "declaration":       true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}