@teamflojo/floimg 0.1.0 → 0.3.0

package/QUICK_START.md

@@ -0,0 +1,199 @@
+# Quick Start Guide
+
+Get started with floimg in seconds using `npx` - no installation required.
+
+## Try It Now
+
+```bash
+# Generate a QR code
+npx @teamflojo/floimg qr "https://floimg.com" -o qr.png
+
+# Create a chart
+npx @teamflojo/floimg chart bar --labels "Q1,Q2,Q3" --values "10,20,30" -o chart.png
+
+# Resize an image
+npx @teamflojo/floimg resize photo.jpg 800x600 -o thumbnail.jpg
+
+# Convert format (PNG to WebP)
+npx @teamflojo/floimg convert image.png -o image.webp
+```
+
+## How Plugin Auto-Install Works
+
+floimg is modular. The core package is lightweight, and plugins are installed on-demand.
+
+When you run a command that requires a plugin (like `qr` or `chart`), floimg will:
+
+1. Check if the required plugin is installed
+2. If not, prompt you to install it
+3. Install and run your command
+
+```
+$ npx @teamflojo/floimg qr "https://example.com"
+
+🔍 The 'qr' command requires @teamflojo/floimg-qr
+   QR Code Generator
+
+Install it now? (y/n): y
+📦 Installing @teamflojo/floimg-qr...
+✅ Installed!
+
+✅ QR code saved to: qr.png
+```
+
+**After the first run**, the plugin is cached and subsequent runs are fast.
+
+## Interactive Mode
+
+Run floimg with no arguments to see an interactive menu:
+
+```bash
+npx @teamflojo/floimg
+```
+
+This shows all available commands and examples.
+
+## Command Reference
+
+### QR Code
+
+```bash
+floimg qr <text> [options]
+
+Options:
+  -o, --out <path>           Output file (default: qr.png)
+  -s, --size <pixels>        Size in pixels (default: 300)
+  -f, --format <format>      png or svg (default: png)
+  -e, --error-correction     L, M, Q, or H (default: M)
+  --dark <color>             Dark color hex (default: #000000)
+  --light <color>            Light color hex (default: #ffffff)
+
+Examples:
+  floimg qr "https://floimg.com" -o qr.png
+  floimg qr "Hello World" --size 400 --format svg -o hello.svg
+  floimg qr "https://example.com" --error-correction H --dark "#1a1a2e"
+```
+
+### Chart
+
+```bash
+floimg chart <type> [options]
+
+Types: bar, line, pie, doughnut, radar, polarArea, scatter
+
+Options:
+  -o, --out <path>           Output file (default: chart.png)
+  -l, --labels <items>       Comma-separated labels
+  -v, --values <items>       Comma-separated values
+  -d, --data <file>          JSON file with Chart.js config
+  --title <text>             Chart title
+  -w, --width <pixels>       Width (default: 500)
+  -h, --height <pixels>      Height (default: 300)
+  -f, --format <format>      png, svg, or webp (default: png)
+
+Examples:
+  floimg chart bar --labels "A,B,C" --values "10,20,30" -o chart.png
+  floimg chart pie --labels "Yes,No" --values "70,30" --title "Survey Results"
+  floimg chart line --data sales.json -o sales-chart.png
+```
+
+### Resize
+
+```bash
+floimg resize <input> <size> [options]
+
+Size formats: WIDTHxHEIGHT (e.g., 800x600) or WIDTH (e.g., 800)
+
+Options:
+  -o, --out <path>           Output file (default: input-resized.ext)
+  --fit <mode>               cover, contain, fill, inside, outside
+  --position <pos>           center, top, bottom, left, right, etc.
+  --background <color>       Background color for contain mode
+
+Examples:
+  floimg resize photo.jpg 800x600 -o thumbnail.jpg
+  floimg resize hero.png 1200 -o hero-resized.png
+  floimg resize logo.png 200x200 --fit contain --background "#ffffff"
+```
+
+### Convert
+
+```bash
+floimg convert <input> [options]
+
+Options:
+  -o, --out <path>           Output file (format inferred from extension)
+  -t, --to <format>          Target format: png, jpg, webp, avif, svg
+  -q, --quality <number>     Quality for lossy formats (1-100)
+
+Examples:
+  floimg convert photo.png -o photo.webp
+  floimg convert image.jpg --to avif -o optimized.avif
+  floimg convert screenshot.png -o screenshot.jpg --quality 85
+```
+
+## Performance Tips
+
+### First Run
+
+The first run with npx will:
+- Download the @teamflojo/floimg package
+- Compile native dependencies (sharp, canvas)
+- This takes ~10-15 seconds
+
+### Subsequent Runs
+
+After the first run:
+- npx caches the package in `~/.npm/_npx/`
+- Runs take ~2-3 seconds
+- This is normal and matches tools like prettier, eslint
+
+### For Frequent Use
+
+If you use floimg often, install it globally for faster startup:
+
+```bash
+npm install -g @teamflojo/floimg
+```
+
+Then just run `floimg` directly (no npx needed).
+
+## Troubleshooting
+
+### "Cannot find module" errors
+
+This usually means native dependencies failed to compile. Try:
+
+```bash
+# Clear npx cache and retry
+rm -rf ~/.npm/_npx
+npx @teamflojo/floimg doctor
+```
+
+### Plugin not installing
+
+If auto-install fails in CI/scripts (non-interactive mode):
+
+```bash
+# Pre-install plugins explicitly
+npm install @teamflojo/floimg-qr @teamflojo/floimg-quickchart
+
+# Then run commands
+npx @teamflojo/floimg qr "text" --no-auto-install
+```
+
+### Permission errors
+
+If you get EACCES errors:
+
+```bash
+# Fix npm permissions
+sudo chown -R $(whoami) ~/.npm
+```
+
+## Next Steps
+
+- **[Full CLI Reference](https://floimg.com/docs/cli)** - All commands and options
+- **[Library API](https://floimg.com/docs/api)** - Use floimg in your code
+- **[MCP Integration](https://floimg.com/docs/mcp)** - Use with Claude/AI agents
+- **[Plugin Development](https://floimg.com/docs/plugins)** - Create custom generators

package/dist/cli/commands/chart.d.ts

@@ -0,0 +1,20 @@
+import { Command } from "commander";
+/**
+ * Shorthand command for generating charts
+ *
+ * This command auto-installs @teamflojo/floimg-quickchart if not present.
+ *
+ * @example
+ * ```bash
+ * # Bar chart with inline data
+ * floimg chart bar --labels "Q1,Q2,Q3,Q4" --values "10,20,30,40" -o chart.png
+ *
+ * # Chart from JSON file
+ * floimg chart line --data sales.json -o sales-chart.png
+ *
+ * # Pie chart with title
+ * floimg chart pie --labels "A,B,C" --values "30,50,20" --title "Distribution"
+ * ```
+ */
+export declare const chartCommand: Command;
+//# sourceMappingURL=chart.d.ts.map

package/dist/cli/commands/chart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/chart.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,YAAY,SAqHrB,CAAC"}

package/dist/cli/commands/chart.js

@@ -0,0 +1,126 @@
+import { readFile, writeFile } from "fs/promises";
+import { Command } from "commander";
+import createClient from "../../index.js";
+import { loadConfig } from "../../config/loader.js";
+import { loadPlugin, showNpxTip } from "../utils/plugin-loader.js";
+/**
+ * Shorthand command for generating charts
+ *
+ * This command auto-installs @teamflojo/floimg-quickchart if not present.
+ *
+ * @example
+ * ```bash
+ * # Bar chart with inline data
+ * floimg chart bar --labels "Q1,Q2,Q3,Q4" --values "10,20,30,40" -o chart.png
+ *
+ * # Chart from JSON file
+ * floimg chart line --data sales.json -o sales-chart.png
+ *
+ * # Pie chart with title
+ * floimg chart pie --labels "A,B,C" --values "30,50,20" --title "Distribution"
+ * ```
+ */
+export const chartCommand = new Command("chart")
+    .description("Generate a chart (auto-installs @teamflojo/floimg-quickchart if needed)")
+    .argument("<type>", "Chart type: bar, line, pie, doughnut, radar, polarArea, scatter")
+    .option("-o, --out <path>", "Output file path (default: chart.png)", "chart.png")
+    .option("-d, --data <file>", "JSON file with Chart.js data configuration")
+    .option("-l, --labels <items>", "Comma-separated labels (e.g., 'Q1,Q2,Q3,Q4')")
+    .option("-v, --values <items>", "Comma-separated values (e.g., '10,20,30,40')")
+    .option("--title <text>", "Chart title")
+    .option("-w, --width <pixels>", "Width in pixels", "500")
+    .option("-h, --height <pixels>", "Height in pixels", "300")
+    .option("--background <color>", "Background color", "transparent")
+    .option("-f, --format <format>", "Output format: png, svg, webp", "png")
+    .option("--no-auto-install", "Don't prompt to install missing plugins")
+    .option("--config <path>", "Path to config file")
+    .action(async (type, options) => {
+    try {
+        const config = await loadConfig(options.config);
+        const client = createClient(config);
+        // Load the QuickChart plugin (auto-installs if needed)
+        const quickchartPlugin = await loadPlugin("quickchart", options.autoInstall !== false);
+        if (!quickchartPlugin) {
+            process.exit(1);
+        }
+        client.registerGenerator(quickchartPlugin.default());
+        // Build chart data
+        let chartData;
+        if (options.data) {
+            // Load from JSON file
+            const fileContent = await readFile(options.data, "utf-8");
+            chartData = JSON.parse(fileContent);
+        }
+        else if (options.labels && options.values) {
+            // Build from command line options
+            const labels = options.labels.split(",").map((s) => s.trim());
+            const values = options.values.split(",").map((s) => parseFloat(s.trim()));
+            chartData = {
+                labels,
+                datasets: [
+                    {
+                        label: options.title || "Data",
+                        data: values,
+                    },
+                ],
+            };
+        }
+        else {
+            console.error("Error: Provide --data <file> or both --labels and --values");
+            console.error("");
+            console.error("Examples:");
+            console.error('  floimg chart bar --labels "A,B,C" --values "10,20,30" -o chart.png');
+            console.error("  floimg chart line --data sales.json -o chart.png");
+            process.exit(1);
+        }
+        // Build chart options
+        const chartOptions = {};
+        if (options.title) {
+            chartOptions.plugins = {
+                title: {
+                    display: true,
+                    text: options.title,
+                },
+            };
+        }
+        const blob = await client.generate({
+            generator: "quickchart",
+            params: {
+                type,
+                data: chartData,
+                options: chartOptions,
+                width: parseInt(options.width, 10),
+                height: parseInt(options.height, 10),
+                backgroundColor: options.background,
+                format: options.format,
+            },
+        });
+        // Determine output path with correct extension
+        let outPath = options.out;
+        const extMap = {
+            png: ".png",
+            svg: ".svg",
+            webp: ".webp",
+        };
+        if (outPath === "chart.png" && options.format !== "png") {
+            outPath = `chart${extMap[options.format] || ".png"}`;
+        }
+        if (outPath.includes("://")) {
+            // Cloud storage
+            const result = await client.save(blob, outPath);
+            console.log(`✅ Chart saved to: ${result.location}`);
+        }
+        else {
+            // Local file
+            await writeFile(outPath, blob.bytes);
+            console.log(`✅ Chart saved to: ${outPath}`);
+        }
+        // Show tip for npx users
+        showNpxTip();
+    }
+    catch (error) {
+        console.error("Error generating chart:", error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=chart.js.map

package/dist/cli/commands/chart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart.js","sourceRoot":"","sources":["../../../src/cli/commands/chart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,YAAY,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEnE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;KAC7C,WAAW,CAAC,yEAAyE,CAAC;KACtF,QAAQ,CAAC,QAAQ,EAAE,iEAAiE,CAAC;KACrF,MAAM,CAAC,kBAAkB,EAAE,uCAAuC,EAAE,WAAW,CAAC;KAChF,MAAM,CAAC,mBAAmB,EAAE,4CAA4C,CAAC;KACzE,MAAM,CAAC,sBAAsB,EAAE,8CAA8C,CAAC;KAC9E,MAAM,CAAC,sBAAsB,EAAE,8CAA8C,CAAC;KAC9E,MAAM,CAAC,gBAAgB,EAAE,aAAa,CAAC;KACvC,MAAM,CAAC,sBAAsB,EAAE,iBAAiB,EAAE,KAAK,CAAC;KACxD,MAAM,CAAC,uBAAuB,EAAE,kBAAkB,EAAE,KAAK,CAAC;KAC1D,MAAM,CAAC,sBAAsB,EAAE,kBAAkB,EAAE,aAAa,CAAC;KACjE,MAAM,CAAC,uBAAuB,EAAE,+BAA+B,EAAE,KAAK,CAAC;KACvE,MAAM,CAAC,mBAAmB,EAAE,yCAAyC,CAAC;KACtE,MAAM,CAAC,iBAAiB,EAAE,qBAAqB,CAAC;KAChD,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;IAC9B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;QAEpC,uDAAuD;QACvD,MAAM,gBAAgB,GAAG,MAAM,UAAU,CACvC,YAAY,EACZ,OAAO,CAAC,WAAW,KAAK,KAAK,CAC9B,CAAC;QAEF,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,CAAC,iBAAiB,CACtB,gBAAgB,CAAC,OAAO,EAAoD,CAC7E,CAAC;QAEF,mBAAmB;QACnB,IAAI,SAAkC,CAAC;QAEvC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,sBAAsB;YACtB,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC1D,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACtC,CAAC;aAAM,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YAC5C,kCAAkC;YAClC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACtE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAElF,SAAS,GAAG;gBACV,MAAM;gBACN,QAAQ,EAAE;oBACR;wBACE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,MAAM;wBAC9B,IAAI,EAAE,MAAM;qBACb;iBACF;aACF,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,4DAA4D,CAAC,CAAC;YAC5E,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAClB,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,sEAAsE,CAAC,CAAC;YACtF,OAAO,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;YACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,sBAAsB;QACtB,MAAM,YAAY,GAA4B,EAAE,CAAC;QACjD,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,YAAY,CAAC,OAAO,GAAG;gBACrB,KAAK,EAAE;oBACL,OAAO,EAAE,IAAI;oBACb,IAAI,EAAE,OAAO,CAAC,KAAK;iBACpB;aACF,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC;YACjC,SAAS,EAAE,YAAY;YACvB,MAAM,EAAE;gBACN,IAAI;gBACJ,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,YAAY;gBACrB,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;gBAClC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;gBACpC,eAAe,EAAE,OAAO,CAAC,UAAU;gBACnC,MAAM,EAAE,OAAO,CAAC,MAAM;aACvB;SACF,CAAC,CAAC;QAEH,+CAA+C;QAC/C,IAAI,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC;QAC1B,MAAM,MAAM,GAA2B;YACrC,GAAG,EAAE,MAAM;YACX,GAAG,EAAE,MAAM;YACX,IAAI,EAAE,OAAO;SACd,CAAC;QACF,IAAI,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YACxD,OAAO,GAAG,QAAQ,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvD,CAAC;QAED,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,gBAAgB;YAChB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,qBAAqB,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACtD,CAAC;aAAM,CAAC;YACN,aAAa;YACb,MAAM,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YACrC,OAAO,CAAC,GAAG,CAAC,qBAAqB,OAAO,EAAE,CAAC,CAAC;QAC9C,CAAC;QAED,yBAAyB;QACzB,UAAU,EAAE,CAAC;IACf,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CACX,yBAAyB,EACzB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAC/C,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/cli/commands/config.js

@@ -3,7 +3,7 @@ import { saveGlobalConfig, loadConfig } from "../../config/loader.js";
 import { join } from "path";
 import { homedir } from "os";
 export const configCommand = new Command("config")
-    .description("Manage imgflo configuration")
+    .description("Manage floimg configuration")
     .addCommand(new Command("set")
     .description("Set a configuration value")
     .argument("<key>", "Configuration key (e.g., s3.bucket, s3.region)")
@@ -54,7 +54,7 @@ export const configCommand = new Command("config")
         }
         await saveGlobalConfig(config);
         console.log(`✓ Configuration saved: ${key} = ${value.includes('key') || value.includes('secret') ? '***' : value}`);
-        console.log(`  Location: ${join(homedir(), ".imgflo", "config.json")}`);
+        console.log(`  Location: ${join(homedir(), ".floimg", "config.json")}`);
     }
     catch (error) {
         console.error("Error saving configuration:", error instanceof Error ? error.message : error);
@@ -96,9 +96,9 @@ export const configCommand = new Command("config")
     }
 }))
     .addCommand(new Command("init")
-    .description("Initialize imgflo configuration interactively")
+    .description("Initialize floimg configuration interactively")
     .action(async () => {
-    console.log("imgflo configuration setup");
+    console.log("floimg configuration setup");
     console.log("=========================\n");
     const readline = await import('readline');
     const rl = readline.createInterface({
@@ -140,10 +140,10 @@ export const configCommand = new Command("config")
             return;
         }
         await saveGlobalConfig(config);
-        console.log("\n✓ Configuration saved to:", join(homedir(), ".imgflo", "config.json"));
-        console.log("\nYou can now use imgflo without setting environment variables!");
+        console.log("\n✓ Configuration saved to:", join(homedir(), ".floimg", "config.json"));
+        console.log("\nYou can now use floimg without setting environment variables!");
         console.log("\nTry it:");
-        console.log("  imgflo generate --provider svg --params '{\"type\":\"gradient\"}' --out test.svg");
+        console.log("  floimg generate --provider svg --params '{\"type\":\"gradient\"}' --out test.svg");
         rl.close();
     }
     catch (error) {
@@ -156,10 +156,10 @@ export const configCommand = new Command("config")
     .description("Show configuration file location")
     .action(() => {
     console.log("Configuration file locations (in order of priority):");
-    console.log("  1. ./imgflo.config.ts (current directory)");
-    console.log("  2. ./.imgflorc.json (current directory)");
-    console.log("  3. ~/.imgflo/config.json (global)");
+    console.log("  1. ./floimg.config.ts (current directory)");
+    console.log("  2. ./.floimgrc.json (current directory)");
+    console.log("  3. ~/.floimg/config.json (global)");
     console.log("  4. Environment variables");
-    console.log("\nGlobal config location:", join(homedir(), ".imgflo", "config.json"));
+    console.log("\nGlobal config location:", join(homedir(), ".floimg", "config.json"));
 }));
 //# sourceMappingURL=config.js.map

package/dist/cli/commands/convert.d.ts

@@ -0,0 +1,18 @@
+import { Command } from "commander";
+/**
+ * Shorthand command for converting image formats
+ *
+ * @example
+ * ```bash
+ * # Convert to WebP (format inferred from output extension)
+ * floimg convert input.png -o output.webp
+ *
+ * # Explicit format specification
+ * floimg convert input.png --to webp -o output.webp
+ *
+ * # With quality setting
+ * floimg convert input.png -o output.jpg --quality 85
+ * ```
+ */
+export declare const convertCommand: Command;
+//# sourceMappingURL=convert.d.ts.map

package/dist/cli/commands/convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/convert.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4BpC;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,SA2FvB,CAAC"}

package/dist/cli/commands/convert.js

@@ -0,0 +1,122 @@
+import { readFile, writeFile } from "fs/promises";
+import { Command } from "commander";
+import createClient from "../../index.js";
+import { loadConfig } from "../../config/loader.js";
+/**
+ * Detect MIME type from file extension
+ */
+function detectMime(filepath) {
+    const ext = filepath.split(".").pop()?.toLowerCase();
+    const mimeMap = {
+        png: "image/png",
+        jpg: "image/jpeg",
+        jpeg: "image/jpeg",
+        webp: "image/webp",
+        avif: "image/avif",
+        svg: "image/svg+xml",
+    };
+    return mimeMap[ext || ""] || "image/png";
+}
+/**
+ * Get format from output path extension
+ */
+function getFormatFromPath(filepath) {
+    return detectMime(filepath);
+}
+/**
+ * Shorthand command for converting image formats
+ *
+ * @example
+ * ```bash
+ * # Convert to WebP (format inferred from output extension)
+ * floimg convert input.png -o output.webp
+ *
+ * # Explicit format specification
+ * floimg convert input.png --to webp -o output.webp
+ *
+ * # With quality setting
+ * floimg convert input.png -o output.jpg --quality 85
+ * ```
+ */
+export const convertCommand = new Command("convert")
+    .description("Convert image format (shorthand for transform --op convert)")
+    .argument("<input>", "Input image file")
+    .option("-o, --out <path>", "Output file path (format inferred from extension)")
+    .option("-t, --to <format>", "Target format: png, jpg, jpeg, webp, avif, svg")
+    .option("-q, --quality <number>", "Quality for lossy formats (1-100)", "80")
+    .option("--config <path>", "Path to config file")
+    .action(async (input, options) => {
+    try {
+        const config = await loadConfig(options.config);
+        const client = createClient(config);
+        // Read input file
+        const inputBytes = await readFile(input);
+        const inputMime = detectMime(input);
+        const inputBlob = {
+            bytes: inputBytes,
+            mime: inputMime,
+        };
+        // Determine target format
+        let targetFormat;
+        if (options.to) {
+            // Explicit format specified
+            const formatMap = {
+                png: "image/png",
+                jpg: "image/jpeg",
+                jpeg: "image/jpeg",
+                webp: "image/webp",
+                avif: "image/avif",
+                svg: "image/svg+xml",
+            };
+            targetFormat = formatMap[options.to.toLowerCase()] || "image/png";
+        }
+        else if (options.out) {
+            // Infer from output extension
+            const inferred = getFormatFromPath(options.out);
+            if (!inferred) {
+                console.error("Error: Could not infer format from output path.");
+                console.error("Use --to to specify format explicitly.");
+                process.exit(1);
+            }
+            targetFormat = inferred;
+        }
+        else {
+            console.error("Error: Must specify --out or --to.");
+            process.exit(1);
+        }
+        const result = await client.transform({
+            blob: inputBlob,
+            op: "convert",
+            to: targetFormat,
+            params: {
+                quality: parseInt(options.quality, 10),
+            },
+        });
+        // Determine output path
+        const extMap = {
+            "image/png": "png",
+            "image/jpeg": "jpg",
+            "image/webp": "webp",
+            "image/avif": "avif",
+            "image/svg+xml": "svg",
+        };
+        const newExt = extMap[targetFormat] || "png";
+        const outPath = options.out || input.replace(/\.[^.]+$/, `.${newExt}`);
+        if (outPath.includes("://")) {
+            // Cloud storage
+            const saveResult = await client.save(result, outPath);
+            console.log(`Converted image saved to: ${saveResult.location}`);
+        }
+        else {
+            // Local file
+            await writeFile(outPath, result.bytes);
+            console.log(`Converted image saved to: ${outPath}`);
+        }
+        console.log(`Format: ${inputMime} → ${result.mime}`);
+    }
+    catch (error) {
+        console.error("Error converting image:", error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=convert.js.map

package/dist/cli/commands/convert.js.map

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

package/dist/cli/commands/generate.js

@@ -20,7 +20,7 @@ export const generateCommand = new Command("generate")
         if (options.out) {
             // Check if destination is cloud storage (s3://, r2://, etc.) or local file
             if (options.out.includes('://')) {
-                // Use imgflo's save provider (supports S3, etc.)
+                // Use floimg's save provider (supports S3, etc.)
                 const result = await client.save(blob, options.out);
                 console.log(`Generated image saved to cloud storage!`);
                 console.log(`Provider: ${result.provider}`);

package/dist/cli/commands/mcp.js

@@ -9,21 +9,21 @@ mcpCommand
     .option("--global", "Install to global Claude Code config")
     .option("--output <path>", "Output path for MCP config snippet")
     .action(async (options) => {
-    console.log("imgflo MCP Setup");
+    console.log("floimg MCP Setup");
     console.log("================\n");
     // Get the path to the built MCP server
-    // When imgflo is installed globally, use require.resolve to find it
+    // When floimg is installed globally, use require.resolve to find it
     let serverPath;
     try {
-        serverPath = require.resolve("imgflo/dist/mcp/server.js");
+        serverPath = require.resolve("floimg/dist/mcp/server.js");
     }
     catch {
         // Fallback to local path if not found via require.resolve
-        serverPath = resolve(join(process.cwd(), "node_modules/imgflo/dist/mcp/server.js"));
+        serverPath = resolve(join(process.cwd(), "node_modules/floimg/dist/mcp/server.js"));
     }
     const mcpConfig = {
         mcpServers: {
-            imgflo: {
+            floimg: {
                 command: "node",
                 args: [serverPath],
                 env: {
@@ -58,24 +58,24 @@ mcpCommand
     console.log("   3. Restart Claude Code");
     console.log("   4. Try: 'Create a QR code for https://example.com'");
     console.log("\n📖 Documentation:");
-    console.log("   https://github.com/bcooke/imgflo/blob/main/packages/imgflo/docs/guides/MCP_SERVER.md");
+    console.log("   https://github.com/bcooke/floimg/blob/main/packages/floimg/docs/guides/MCP_SERVER.md");
 });
 mcpCommand
     .command("test")
     .description("Test MCP server with inspector (opens browser)")
     .action(async () => {
     console.log("Starting MCP Inspector...\n");
-    console.log("This will open a web interface to test imgflo's MCP tools.");
+    console.log("This will open a web interface to test floimg's MCP tools.");
     console.log("Press Ctrl+C to stop.\n");
     const { spawn } = await import("child_process");
     // Get the path to the built MCP server
     let serverPath;
     try {
-        serverPath = require.resolve("imgflo/dist/mcp/server.js");
+        serverPath = require.resolve("floimg/dist/mcp/server.js");
     }
     catch {
         // Fallback to local path if not found via require.resolve
-        serverPath = resolve(join(process.cwd(), "node_modules/imgflo/dist/mcp/server.js"));
+        serverPath = resolve(join(process.cwd(), "node_modules/floimg/dist/mcp/server.js"));
     }
     const inspector = spawn("npx", ["@modelcontextprotocol/inspector", "node", serverPath], {
         stdio: "inherit",