@mantiqh/image-optimizer 1.0.0

package/dist/index.js

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+import fs from "fs/promises";
+import path from "path";
+import JSZip from "jszip";
+import sharp from "sharp";
+import chalk from "chalk";
+import ora from "ora";
+var program = new Command();
+program.name("image-optimizer").description("Optimize images inside a zip file").version("1.0.0").requiredOption("-s, --source <path>", "Path to the input zip file").option("-o, --output <path>", "Path to the output zip file").option("-q, --quality <number>", "Quality of compression (1-100)", "80").option("-w, --width <number>", "Max width to resize images to", "1600").parse(process.argv);
+var options = program.opts();
+async function main() {
+  const spinner = ora("Starting optimization...").start();
+  try {
+    const sourcePath = path.resolve(process.cwd(), options.source);
+    let outputPath;
+    if (options.output) {
+      outputPath = path.resolve(process.cwd(), options.output);
+    } else {
+      const dir = path.dirname(sourcePath);
+      const ext = path.extname(sourcePath);
+      const name = path.basename(sourcePath, ext);
+      outputPath = path.join(dir, `${name}-optimized${ext}`);
+    }
+    if (!await fileExists(sourcePath)) {
+      spinner.fail(`Source file not found: ${sourcePath}`);
+      process.exit(1);
+    }
+    spinner.text = "Reading zip file...";
+    const zipData = await fs.readFile(sourcePath);
+    const zip = await JSZip.loadAsync(zipData);
+    const newZip = new JSZip();
+    const quality = parseInt(options.quality);
+    const maxWidth = parseInt(options.width);
+    const fileNames = Object.keys(zip.files);
+    let processedCount = 0;
+    let savedBytes = 0;
+    spinner.text = `Found ${fileNames.length} files. Processing...`;
+    for (const fileName of fileNames) {
+      const file = zip.files[fileName];
+      if (file.dir) {
+        newZip.folder(fileName);
+        continue;
+      }
+      const content = await file.async("nodebuffer");
+      const ext = path.extname(fileName).toLowerCase();
+      if ([".jpg", ".jpeg", ".png", ".webp"].includes(ext)) {
+        try {
+          spinner.text = `Optimizing: ${fileName}`;
+          let pipeline = sharp(content);
+          const metadata = await pipeline.metadata();
+          if (metadata.width && metadata.width > maxWidth) {
+            pipeline = pipeline.resize({ width: maxWidth });
+          }
+          if (ext === ".png") {
+            pipeline = pipeline.png({ quality, compressionLevel: 9 });
+          } else if (ext === ".webp") {
+            pipeline = pipeline.webp({ quality });
+          } else {
+            pipeline = pipeline.jpeg({ quality, mozjpeg: true });
+          }
+          const optimizedBuffer = await pipeline.toBuffer();
+          const diff = content.length - optimizedBuffer.length;
+          if (diff > 0) {
+            savedBytes += diff;
+            newZip.file(fileName, optimizedBuffer);
+          } else {
+            newZip.file(fileName, content);
+          }
+          processedCount++;
+        } catch (err) {
+          newZip.file(fileName, content);
+        }
+      } else {
+        newZip.file(fileName, content);
+      }
+    }
+    spinner.text = "Generating output zip...";
+    const outputBuffer = await newZip.generateAsync({
+      type: "nodebuffer",
+      compression: "DEFLATE",
+      compressionOptions: { level: 6 }
+    });
+    await fs.writeFile(outputPath, outputBuffer);
+    spinner.succeed(chalk.green("Optimization Complete!"));
+    console.log(`
+\u{1F4C1} Output: ${chalk.cyan(outputPath)}`);
+    console.log(`\u{1F5BC}\uFE0F  Images Processed: ${processedCount}`);
+    console.log(
+      `\u{1F4BE} Space Saved: ${chalk.bold(
+        (savedBytes / 1024 / 1024).toFixed(2)
+      )} MB
+`
+    );
+  } catch (error) {
+    spinner.fail("Error occurred");
+    console.error(chalk.red(error.message));
+    process.exit(1);
+  }
+}
+async function fileExists(path2) {
+  try {
+    await fs.access(path2);
+    return true;
+  } catch {
+    return false;
+  }
+}
+main();

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@mantiqh/image-optimizer",
+  "version": "1.0.0",
+  "description": "CLI to optimize images inside a zip file",
+  "main": "dist/index.js",
+  "bin": {
+    "image-optimizer": "./dist/index.js"
+  },
+  "type": "module",
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --clean",
+    "dev": "tsup src/index.ts --format esm --watch --onSuccess \"node dist/index.js\"",
+    "start": "node dist/index.js",
+    "prepublishOnly": "pnpm build"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "packageManager": "pnpm@10.12.3",
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "commander": "^14.0.2",
+    "jszip": "^3.10.1",
+    "ora": "^9.0.0",
+    "sharp": "^0.34.5"
+  },
+  "devDependencies": {
+    "@types/jszip": "^3.4.1",
+    "@types/node": "^25.0.3",
+    "@types/sharp": "^0.32.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  }
+}

package/src/index.ts

@@ -0,0 +1,158 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import fs from "fs/promises";
+import path from "path";
+import JSZip from "jszip";
+import sharp from "sharp";
+import chalk from "chalk";
+import ora from "ora";
+
+const program = new Command();
+
+program
+  .name("image-optimizer")
+  .description("Optimize images inside a zip file")
+  .version("1.0.0")
+  .requiredOption("-s, --source <path>", "Path to the input zip file")
+  .option("-o, --output <path>", "Path to the output zip file")
+  .option("-q, --quality <number>", "Quality of compression (1-100)", "80")
+  .option("-w, --width <number>", "Max width to resize images to", "1600")
+  .parse(process.argv);
+
+const options = program.opts();
+
+async function main() {
+  const spinner = ora("Starting optimization...").start();
+
+  try {
+    // 1. Resolve Paths
+    const sourcePath = path.resolve(process.cwd(), options.source);
+
+    // Default output name if not provided: input-optimized.zip
+    let outputPath: string;
+    if (options.output) {
+      outputPath = path.resolve(process.cwd(), options.output);
+    } else {
+      const dir = path.dirname(sourcePath);
+      const ext = path.extname(sourcePath);
+      const name = path.basename(sourcePath, ext);
+      outputPath = path.join(dir, `${name}-optimized${ext}`);
+    }
+
+    if (!(await fileExists(sourcePath))) {
+      spinner.fail(`Source file not found: ${sourcePath}`);
+      process.exit(1);
+    }
+
+    // 2. Read Zip
+    spinner.text = "Reading zip file...";
+    const zipData = await fs.readFile(sourcePath);
+    const zip = await JSZip.loadAsync(zipData);
+
+    const newZip = new JSZip();
+    const quality = parseInt(options.quality);
+    const maxWidth = parseInt(options.width);
+
+    // 3. Process Entries
+    const fileNames = Object.keys(zip.files);
+    let processedCount = 0;
+    let savedBytes = 0;
+
+    spinner.text = `Found ${fileNames.length} files. Processing...`;
+
+    // Process in parallel (batches) or sequence. Sequence is safer for memory.
+    for (const fileName of fileNames) {
+      const file = zip.files[fileName];
+
+      if (file.dir) {
+        newZip.folder(fileName);
+        continue;
+      }
+
+      const content = await file.async("nodebuffer");
+      const ext = path.extname(fileName).toLowerCase();
+
+      // Check if it's an image we can optimize
+      if ([".jpg", ".jpeg", ".png", ".webp"].includes(ext)) {
+        try {
+          spinner.text = `Optimizing: ${fileName}`;
+
+          // Sharp Optimization Pipeline
+          let pipeline = sharp(content);
+          const metadata = await pipeline.metadata();
+
+          // Resize if too big
+          if (metadata.width && metadata.width > maxWidth) {
+            pipeline = pipeline.resize({ width: maxWidth });
+          }
+
+          // Compress based on format
+          if (ext === ".png") {
+            pipeline = pipeline.png({ quality: quality, compressionLevel: 9 });
+          } else if (ext === ".webp") {
+            pipeline = pipeline.webp({ quality: quality });
+          } else {
+            // Default to jpeg/mozjpeg
+            pipeline = pipeline.jpeg({ quality: quality, mozjpeg: true });
+          }
+
+          const optimizedBuffer = await pipeline.toBuffer();
+
+          // Calculate savings
+          const diff = content.length - optimizedBuffer.length;
+          if (diff > 0) {
+            savedBytes += diff;
+            newZip.file(fileName, optimizedBuffer);
+          } else {
+            // If optimization made it bigger (rare), keep original
+            newZip.file(fileName, content);
+          }
+          processedCount++;
+        } catch (err) {
+          // If sharp fails (corrupt image?), keep original
+          newZip.file(fileName, content);
+        }
+      } else {
+        // Non-image files: just copy them
+        newZip.file(fileName, content);
+      }
+    }
+
+    // 4. Write Output Zip
+    spinner.text = "Generating output zip...";
+
+    // Generate zip as nodebuffer (works better for CLI files)
+    const outputBuffer = await newZip.generateAsync({
+      type: "nodebuffer",
+      compression: "DEFLATE",
+      compressionOptions: { level: 6 },
+    });
+
+    await fs.writeFile(outputPath, outputBuffer);
+
+    spinner.succeed(chalk.green("Optimization Complete!"));
+    console.log(`\n📁 Output: ${chalk.cyan(outputPath)}`);
+    console.log(`🖼️  Images Processed: ${processedCount}`);
+    console.log(
+      `💾 Space Saved: ${chalk.bold(
+        (savedBytes / 1024 / 1024).toFixed(2)
+      )} MB\n`
+    );
+  } catch (error: any) {
+    spinner.fail("Error occurred");
+    console.error(chalk.red(error.message));
+    process.exit(1);
+  }
+}
+
+// Helper to check file existence
+async function fileExists(path: string) {
+  try {
+    await fs.access(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+main();

package/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "./dist",
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "skipLibCheck": true
+  },
+  "include": ["src/**/*"]
+}