vsmeta-to-jpeg 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Charles Aldarondo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,66 @@
+# vsmeta-to-jpeg
+
+Extract embedded JPEG images (poster and backdrop) from Synology Video Station `.vsmeta` metadata files.
+
+Synology has officially deprecated Video Station with DSM 7.2.2. If you are migrating to Jellyfin, Kodi, Plex, or other generic ecosystems, this tool helps you recover the high-quality artwork (posters and backdrops) currently trapped inside your binary `.vsmeta` files and saves them as standard `.jpg` sidecars directly alongside your source media.
+
+Looking to generate `.nfo` metadata files as well? Check out the sibling package [vsmeta-to-nfo](https://github.com/aldarondo/vsmeta-to-nfo).
+
+This package provides both a **command-line tool** for batch extraction and a **programmatic interface**.
+
+## Installation
+
+```bash
+# Global install for CLI use
+npm install -g vsmeta-to-jpeg
+
+# Or install locally
+npm install vsmeta-to-jpeg
+```
+
+## CLI Usage
+
+### Installed Package
+
+```bash
+# Process a single file
+vsmeta-to-jpeg ./path/to/movie.mp4.vsmeta
+
+# Recursively scan a directory and extract images from all discovered .vsmeta files
+vsmeta-to-jpeg ./path/to/library
+```
+
+### Options
+
+*   **`-d, --dry-run`**: Simulate the process without writing any actual `.jpg` files.
+*   **`-f, --overwrite`**: By default, the script skips extraction if the target `.jpg` files already exist. This option overrides that safeguard.
+*   **`-v, --verbose`**: Append a concise list of all skipped or failed files and errors at the end of the console execution run.
+
+### Image Naming Convention
+
+Images are extracted using a prefix based on the `.vsmeta` filename:
+- `poster.jpg`: The main artwork / cover.
+- `fanart.jpg`: The backdrop / background (**Movies/Others**).
+- `thumb.jpg`: The backdrop / background (**TV Episodes**).
+
+If your file is `MyMovie.mp4.vsmeta`, the tool will generate `MyMovie.mp4-poster.jpg` and `MyMovie.mp4-fanart.jpg`.
+If your file is `S01E01.mp4.vsmeta` (and contains episode metadata), it will generate `S01E01.mp4-poster.jpg` and `S01E01.mp4-thumb.jpg`.
+
+## Programmatic API
+
+```javascript
+import { convertVsMetaToJpeg } from 'vsmeta-to-jpeg';
+
+const result = convertVsMetaToJpeg('./libraries/movies/MyMovie (2020).mp4.vsmeta', {
+  dryRun: false,
+  overwrite: true,
+});
+
+if (result.status === 'SUCCESS') {
+    console.log(`Extracted images for: ${result.vsmetaPath}`);
+}
+```
+
+## License
+
+MIT License

package/dist/chunk-2EEHQI7P.js

@@ -0,0 +1,134 @@
+// src/converter.ts
+import fs from "fs";
+import path from "path";
+import { parseVsMeta } from "vsmeta-parser";
+var MEDIA_EXTENSIONS = /* @__PURE__ */ new Set([".mp4", ".mkv", ".avi", ".mov", ".wmv", ".m4v", ".m2ts", ".ts", ".mpg", ".mpeg"]);
+var readdirCache = /* @__PURE__ */ new Map();
+function clearReaddirCache() {
+  readdirCache.clear();
+}
+function hasMatchingMediaFile(vsmetaPath) {
+  const dir = path.dirname(vsmetaPath);
+  const basename = path.basename(vsmetaPath, ".vsmeta");
+  if (fs.existsSync(path.join(dir, basename))) {
+    return true;
+  }
+  let files = readdirCache.get(dir);
+  if (!files) {
+    files = fs.readdirSync(dir);
+    readdirCache.set(dir, files);
+  }
+  for (const file of files) {
+    if (file.startsWith(basename) && file !== path.basename(vsmetaPath)) {
+      const ext = path.extname(file).toLowerCase();
+      if (MEDIA_EXTENSIONS.has(ext)) {
+        return true;
+      }
+    }
+  }
+  return false;
+}
+function convertVsMetaToJpeg(vsmetaPath, options = {}) {
+  try {
+    if (!hasMatchingMediaFile(vsmetaPath)) {
+      return {
+        status: "SKIP",
+        vsmetaPath,
+        message: `No matching media file found for: ${vsmetaPath}`
+      };
+    }
+    const buffer = fs.readFileSync(vsmetaPath);
+    let meta;
+    try {
+      meta = parseVsMeta(buffer);
+    } catch (e) {
+      return {
+        status: "WARN",
+        vsmetaPath,
+        message: `Failed to parse ${vsmetaPath}: ${e.message}`
+      };
+    }
+    const isEpisode = meta.contentType === 2 || meta.season != null && meta.episode != null;
+    const posterPath = vsmetaPath.replace(/\.vsmeta$/i, "-poster.jpg");
+    const fanartPath = vsmetaPath.replace(/\.vsmeta$/i, isEpisode ? "-thumb.jpg" : "-fanart.jpg");
+    const posterExists = fs.existsSync(posterPath);
+    const fanartExists = fs.existsSync(fanartPath);
+    if (!options.overwrite && posterExists && fanartExists) {
+      return {
+        status: "SKIP",
+        vsmetaPath,
+        message: `Images already exist (use --overwrite to replace): ${vsmetaPath}`,
+        posterPath,
+        fanartPath
+      };
+    }
+    const results = [];
+    let anyExtracted = false;
+    if (meta.posterImage) {
+      if (options.overwrite || !posterExists) {
+        if (!options.dryRun) {
+          fs.writeFileSync(posterPath, meta.posterImage);
+        }
+        results.push(`poster: ${posterPath}`);
+        anyExtracted = true;
+      }
+    }
+    if (meta.backdropImage) {
+      if (options.overwrite || !fanartExists) {
+        if (!options.dryRun) {
+          fs.writeFileSync(fanartPath, meta.backdropImage);
+        }
+        results.push(`${isEpisode ? "thumb" : "fanart"}: ${fanartPath}`);
+        anyExtracted = true;
+      }
+    }
+    if (!anyExtracted) {
+      return {
+        status: "WARN",
+        vsmetaPath,
+        message: `No images found in ${vsmetaPath}`
+      };
+    }
+    const prefix = options.dryRun ? "[DRY RUN] " : "";
+    return {
+      status: "SUCCESS",
+      vsmetaPath,
+      message: `${prefix}Extracted ${results.join(", ")}`,
+      posterPath: meta.posterImage ? posterPath : void 0,
+      fanartPath: meta.backdropImage ? fanartPath : void 0
+    };
+  } catch (err) {
+    const e = err;
+    let msg = "";
+    if (e.code === "EACCES" || e.code === "EPERM") {
+      msg = `Permission denied: Cannot read/write files. Please check permissions for ${vsmetaPath}`;
+    } else {
+      msg = `Processing ${vsmetaPath}: ${e.message || err}`;
+    }
+    return { status: "ERROR", vsmetaPath, message: msg };
+  }
+}
+
+// src/logger.ts
+function getResultMessage(result) {
+  return `[${result.status}] ${result.message}`;
+}
+function logConvertResult(result) {
+  const msg = getResultMessage(result);
+  if (result.status === "ERROR") {
+    console.error(msg);
+  } else if (result.status === "WARN") {
+    console.warn(msg);
+  } else {
+    console.log(msg);
+  }
+}
+
+export {
+  clearReaddirCache,
+  hasMatchingMediaFile,
+  convertVsMetaToJpeg,
+  getResultMessage,
+  logConvertResult
+};
+//# sourceMappingURL=chunk-2EEHQI7P.js.map

package/dist/chunk-2EEHQI7P.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/converter.ts","../src/logger.ts"],"sourcesContent":["import fs from 'fs';\r\nimport path from 'path';\r\nimport { parseVsMeta, VsMetaData } from 'vsmeta-parser';\r\nimport { ConvertOptions, ConvertResult } from './types.js';\r\n\r\n// Common video extensions checked when verifying a matching media file exists.\r\nconst MEDIA_EXTENSIONS = new Set(['.mp4', '.mkv', '.avi', '.mov', '.wmv', '.m4v', '.m2ts', '.ts', '.mpg', '.mpeg']);\r\n\r\n// Per-directory cache for readdirSync results — avoids redundant I/O when\r\n// multiple .vsmeta files share the same folder during a batch conversion.\r\nconst readdirCache = new Map<string, string[]>();\r\n\r\n/** Clear the internal directory listing cache. Call after a batch run completes. */\r\nexport function clearReaddirCache(): void {\r\n    readdirCache.clear();\r\n}\r\n\r\nexport function hasMatchingMediaFile(vsmetaPath: string): boolean {\r\n    const dir = path.dirname(vsmetaPath);\r\n    const basename = path.basename(vsmetaPath, '.vsmeta');\r\n\r\n    if (fs.existsSync(path.join(dir, basename))) {\r\n        return true;\r\n    }\r\n\r\n    let files = readdirCache.get(dir);\r\n    if (!files) {\r\n        files = fs.readdirSync(dir) as string[];\r\n        readdirCache.set(dir, files);\r\n    }\r\n\r\n    for (const file of files) {\r\n        if (file.startsWith(basename) && file !== path.basename(vsmetaPath)) {\r\n            const ext = path.extname(file).toLowerCase();\r\n            if (MEDIA_EXTENSIONS.has(ext)) {\r\n                return true;\r\n            }\r\n        }\r\n    }\r\n\r\n    return false;\r\n}\r\n\r\nexport function convertVsMetaToJpeg(vsmetaPath: string, options: ConvertOptions = {}): ConvertResult {\r\n    try {\r\n        if (!hasMatchingMediaFile(vsmetaPath)) {\r\n            return {\r\n                status: 'SKIP',\r\n                vsmetaPath,\r\n                message: `No matching media file found for: ${vsmetaPath}`\r\n            };\r\n        }\r\n\r\n        const buffer = fs.readFileSync(vsmetaPath);\r\n        let meta: VsMetaData;\r\n        try {\r\n            meta = parseVsMeta(buffer);\r\n        } catch (e) {\r\n            return {\r\n                status: 'WARN',\r\n                vsmetaPath,\r\n                message: `Failed to parse ${vsmetaPath}: ${(e as Error).message}`\r\n            };\r\n        }\r\n\r\n        const isEpisode = meta.contentType === 2 || (meta.season != null && meta.episode != null);\r\n        const posterPath = vsmetaPath.replace(/\\.vsmeta$/i, '-poster.jpg');\r\n        const fanartPath = vsmetaPath.replace(/\\.vsmeta$/i, isEpisode ? '-thumb.jpg' : '-fanart.jpg');\r\n\r\n        const posterExists = fs.existsSync(posterPath);\r\n        const fanartExists = fs.existsSync(fanartPath);\r\n\r\n        if (!options.overwrite && posterExists && fanartExists) {\r\n            return {\r\n                status: 'SKIP',\r\n                vsmetaPath,\r\n                message: `Images already exist (use --overwrite to replace): ${vsmetaPath}`,\r\n                posterPath,\r\n                fanartPath\r\n            };\r\n        }\r\n\r\n        const results: string[] = [];\r\n        let anyExtracted = false;\r\n\r\n        if (meta.posterImage) {\r\n            if (options.overwrite || !posterExists) {\r\n                if (!options.dryRun) {\r\n                    fs.writeFileSync(posterPath, meta.posterImage);\r\n                }\r\n                results.push(`poster: ${posterPath}`);\r\n                anyExtracted = true;\r\n            }\r\n        }\r\n\r\n        if (meta.backdropImage) {\r\n            if (options.overwrite || !fanartExists) {\r\n                if (!options.dryRun) {\r\n                    fs.writeFileSync(fanartPath, meta.backdropImage);\r\n                }\r\n                results.push(`${isEpisode ? 'thumb' : 'fanart'}: ${fanartPath}`);\r\n                anyExtracted = true;\r\n            }\r\n        }\r\n\r\n        if (!anyExtracted) {\r\n            return {\r\n                status: 'WARN',\r\n                vsmetaPath,\r\n                message: `No images found in ${vsmetaPath}`\r\n            };\r\n        }\r\n\r\n        const prefix = options.dryRun ? '[DRY RUN] ' : '';\r\n        return {\r\n            status: 'SUCCESS',\r\n            vsmetaPath,\r\n            message: `${prefix}Extracted ${results.join(', ')}`,\r\n            posterPath: meta.posterImage ? posterPath : undefined,\r\n            fanartPath: meta.backdropImage ? fanartPath : undefined\r\n        };\r\n\r\n    } catch (err) {\r\n        const e = err as Error & { code?: string };\r\n        let msg = '';\r\n        if (e.code === 'EACCES' || e.code === 'EPERM') {\r\n            msg = `Permission denied: Cannot read/write files. Please check permissions for ${vsmetaPath}`;\r\n        } else {\r\n            msg = `Processing ${vsmetaPath}: ${e.message || err}`;\r\n        }\r\n        return { status: 'ERROR', vsmetaPath, message: msg };\r\n    }\r\n}\r\n","import { ConvertResult } from './types.js';\r\n\r\nexport function getResultMessage(result: ConvertResult): string {\r\n    return `[${result.status}] ${result.message}`;\r\n}\r\n\r\nexport function logConvertResult(result: ConvertResult) {\r\n    const msg = getResultMessage(result);\r\n    if (result.status === 'ERROR') {\r\n        console.error(msg);\r\n    } else if (result.status === 'WARN') {\r\n        console.warn(msg);\r\n    } else {\r\n        console.log(msg);\r\n    }\r\n}\r\n"],"mappings":"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","names":[]}

package/dist/cli.cjs

@@ -0,0 +1,223 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/cli.ts
+var cli_exports = {};
+__export(cli_exports, {
+  processAction: () => processAction,
+  runCLI: () => runCLI
+});
+module.exports = __toCommonJS(cli_exports);
+var import_commander = require("commander");
+var import_path2 = __toESM(require("path"), 1);
+var import_fs2 = __toESM(require("fs"), 1);
+var import_fast_glob = __toESM(require("fast-glob"), 1);
+
+// src/converter.ts
+var import_fs = __toESM(require("fs"), 1);
+var import_path = __toESM(require("path"), 1);
+var import_vsmeta_parser = require("vsmeta-parser");
+var MEDIA_EXTENSIONS = /* @__PURE__ */ new Set([".mp4", ".mkv", ".avi", ".mov", ".wmv", ".m4v", ".m2ts", ".ts", ".mpg", ".mpeg"]);
+var readdirCache = /* @__PURE__ */ new Map();
+function hasMatchingMediaFile(vsmetaPath) {
+  const dir = import_path.default.dirname(vsmetaPath);
+  const basename = import_path.default.basename(vsmetaPath, ".vsmeta");
+  if (import_fs.default.existsSync(import_path.default.join(dir, basename))) {
+    return true;
+  }
+  let files = readdirCache.get(dir);
+  if (!files) {
+    files = import_fs.default.readdirSync(dir);
+    readdirCache.set(dir, files);
+  }
+  for (const file of files) {
+    if (file.startsWith(basename) && file !== import_path.default.basename(vsmetaPath)) {
+      const ext = import_path.default.extname(file).toLowerCase();
+      if (MEDIA_EXTENSIONS.has(ext)) {
+        return true;
+      }
+    }
+  }
+  return false;
+}
+function convertVsMetaToJpeg(vsmetaPath, options = {}) {
+  try {
+    if (!hasMatchingMediaFile(vsmetaPath)) {
+      return {
+        status: "SKIP",
+        vsmetaPath,
+        message: `No matching media file found for: ${vsmetaPath}`
+      };
+    }
+    const buffer = import_fs.default.readFileSync(vsmetaPath);
+    let meta;
+    try {
+      meta = (0, import_vsmeta_parser.parseVsMeta)(buffer);
+    } catch (e) {
+      return {
+        status: "WARN",
+        vsmetaPath,
+        message: `Failed to parse ${vsmetaPath}: ${e.message}`
+      };
+    }
+    const isEpisode = meta.contentType === 2 || meta.season != null && meta.episode != null;
+    const posterPath = vsmetaPath.replace(/\.vsmeta$/i, "-poster.jpg");
+    const fanartPath = vsmetaPath.replace(/\.vsmeta$/i, isEpisode ? "-thumb.jpg" : "-fanart.jpg");
+    const posterExists = import_fs.default.existsSync(posterPath);
+    const fanartExists = import_fs.default.existsSync(fanartPath);
+    if (!options.overwrite && posterExists && fanartExists) {
+      return {
+        status: "SKIP",
+        vsmetaPath,
+        message: `Images already exist (use --overwrite to replace): ${vsmetaPath}`,
+        posterPath,
+        fanartPath
+      };
+    }
+    const results = [];
+    let anyExtracted = false;
+    if (meta.posterImage) {
+      if (options.overwrite || !posterExists) {
+        if (!options.dryRun) {
+          import_fs.default.writeFileSync(posterPath, meta.posterImage);
+        }
+        results.push(`poster: ${posterPath}`);
+        anyExtracted = true;
+      }
+    }
+    if (meta.backdropImage) {
+      if (options.overwrite || !fanartExists) {
+        if (!options.dryRun) {
+          import_fs.default.writeFileSync(fanartPath, meta.backdropImage);
+        }
+        results.push(`${isEpisode ? "thumb" : "fanart"}: ${fanartPath}`);
+        anyExtracted = true;
+      }
+    }
+    if (!anyExtracted) {
+      return {
+        status: "WARN",
+        vsmetaPath,
+        message: `No images found in ${vsmetaPath}`
+      };
+    }
+    const prefix = options.dryRun ? "[DRY RUN] " : "";
+    return {
+      status: "SUCCESS",
+      vsmetaPath,
+      message: `${prefix}Extracted ${results.join(", ")}`,
+      posterPath: meta.posterImage ? posterPath : void 0,
+      fanartPath: meta.backdropImage ? fanartPath : void 0
+    };
+  } catch (err) {
+    const e = err;
+    let msg = "";
+    if (e.code === "EACCES" || e.code === "EPERM") {
+      msg = `Permission denied: Cannot read/write files. Please check permissions for ${vsmetaPath}`;
+    } else {
+      msg = `Processing ${vsmetaPath}: ${e.message || err}`;
+    }
+    return { status: "ERROR", vsmetaPath, message: msg };
+  }
+}
+
+// src/logger.ts
+function getResultMessage(result) {
+  return `[${result.status}] ${result.message}`;
+}
+function logConvertResult(result) {
+  const msg = getResultMessage(result);
+  if (result.status === "ERROR") {
+    console.error(msg);
+  } else if (result.status === "WARN") {
+    console.warn(msg);
+  } else {
+    console.log(msg);
+  }
+}
+
+// src/cli.ts
+async function processAction(targetPath, options) {
+  const fullPath = import_path2.default.resolve(targetPath);
+  if (!import_fs2.default.existsSync(fullPath)) {
+    console.error(`[ERROR] Path not found: ${fullPath}`);
+    process.exit(1);
+  }
+  const stat = import_fs2.default.statSync(fullPath);
+  if (stat.isFile()) {
+    if (!fullPath.toLowerCase().endsWith(".vsmeta")) {
+      console.error(`[ERROR] File is not a .vsmeta: ${fullPath}`);
+      process.exit(1);
+    }
+    const result = convertVsMetaToJpeg(fullPath, options);
+    logConvertResult(result);
+  } else {
+    console.log(`Scanning directory: ${fullPath}`);
+    const files = await (0, import_fast_glob.default)("**/*.vsmeta", { cwd: fullPath, absolute: true, caseSensitiveMatch: false });
+    if (files.length === 0) {
+      console.log("No .vsmeta files found.");
+      return;
+    }
+    console.log(`Found ${files.length} .vsmeta files.`);
+    const counts = { SUCCESS: 0, ERROR: 0, SKIP: 0, WARN: 0 };
+    const nonSuccesses = [];
+    for (const file of files) {
+      const result = convertVsMetaToJpeg(file, options);
+      logConvertResult(result);
+      counts[result.status]++;
+      if (result.status !== "SUCCESS") {
+        nonSuccesses.push(getResultMessage(result));
+      }
+    }
+    console.log("\n--- Final Summary ---");
+    console.log(`[SUCCESS] : ${counts.SUCCESS}`);
+    console.log(`[SKIP]    : ${counts.SKIP}`);
+    console.log(`[WARN]    : ${counts.WARN}`);
+    console.log(`[ERROR]   : ${counts.ERROR}`);
+    if (options.verbose && nonSuccesses.length > 0) {
+      console.log("\n--- Verbose (Non-Success items) ---");
+      nonSuccesses.forEach((msg) => console.log(msg));
+    }
+  }
+}
+function runCLI(argv) {
+  const program = new import_commander.Command();
+  program.name("vsmeta-to-jpeg").description("Extract embedded JPEG images from Synology .vsmeta files.").argument("<path>", "File or folder path to process. If a folder, it traverses recursively.").option("-d, --dry-run", "Dry run without outputting files.").option("-f, --overwrite", "Overwrite existing JPEG files.").option("-v, --verbose", "Print a summary of all non-successful operations at the end.").action(processAction);
+  program.parse(argv);
+}
+if (process.env.NODE_ENV !== "test") {
+  runCLI(process.argv);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  processAction,
+  runCLI
+});
+//# sourceMappingURL=cli.cjs.map

package/dist/cli.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts","../src/converter.ts","../src/logger.ts"],"sourcesContent":["#!/usr/bin/env node\r\nimport { Command } from 'commander';\r\nimport path from 'path';\r\nimport fs from 'fs';\r\nimport glob from 'fast-glob';\r\nimport { convertVsMetaToJpeg } from './converter.js';\r\nimport { logConvertResult, getResultMessage } from './logger.js';\r\nimport { ConvertOptions } from './types.js';\r\n\r\nexport async function processAction(targetPath: string, options: ConvertOptions) {\r\n    const fullPath = path.resolve(targetPath);\r\n\r\n    if (!fs.existsSync(fullPath)) {\r\n        console.error(`[ERROR] Path not found: ${fullPath}`);\r\n        process.exit(1);\r\n    }\r\n\r\n    const stat = fs.statSync(fullPath);\r\n\r\n    if (stat.isFile()) {\r\n        if (!fullPath.toLowerCase().endsWith('.vsmeta')) {\r\n            console.error(`[ERROR] File is not a .vsmeta: ${fullPath}`);\r\n            process.exit(1);\r\n        }\r\n        const result = convertVsMetaToJpeg(fullPath, options);\r\n        logConvertResult(result);\r\n    } else {\r\n        console.log(`Scanning directory: ${fullPath}`);\r\n        const files = await glob('**/*.vsmeta', { cwd: fullPath, absolute: true, caseSensitiveMatch: false });\r\n\r\n        if (files.length === 0) {\r\n            console.log('No .vsmeta files found.');\r\n            return;\r\n        }\r\n        console.log(`Found ${files.length} .vsmeta files.`);\r\n\r\n        const counts = { SUCCESS: 0, ERROR: 0, SKIP: 0, WARN: 0 };\r\n        const nonSuccesses: string[] = [];\r\n        for (const file of files) {\r\n            const result = convertVsMetaToJpeg(file, options);\r\n            logConvertResult(result);\r\n            counts[result.status]++;\r\n            if (result.status !== 'SUCCESS') {\r\n                nonSuccesses.push(getResultMessage(result));\r\n            }\r\n        }\r\n        console.log('\\n--- Final Summary ---');\r\n        console.log(`[SUCCESS] : ${counts.SUCCESS}`);\r\n        console.log(`[SKIP]    : ${counts.SKIP}`);\r\n        console.log(`[WARN]    : ${counts.WARN}`);\r\n        console.log(`[ERROR]   : ${counts.ERROR}`);\r\n\r\n        if (options.verbose && nonSuccesses.length > 0) {\r\n            console.log('\\n--- Verbose (Non-Success items) ---');\r\n            nonSuccesses.forEach(msg => console.log(msg));\r\n        }\r\n    }\r\n}\r\n\r\nexport function runCLI(argv: string[]) {\r\n    const program = new Command();\r\n    program\r\n        .name('vsmeta-to-jpeg')\r\n        .description('Extract embedded JPEG images from Synology .vsmeta files.')\r\n        .argument('<path>', 'File or folder path to process. If a folder, it traverses recursively.')\r\n        .option('-d, --dry-run', 'Dry run without outputting files.')\r\n        .option('-f, --overwrite', 'Overwrite existing JPEG files.')\r\n        .option('-v, --verbose', 'Print a summary of all non-successful operations at the end.')\r\n        .action(processAction);\r\n\r\n    program.parse(argv);\r\n}\r\n\r\n/* v8 ignore start */\r\n/* istanbul ignore next -- bootstrap guard */\r\nif (process.env.NODE_ENV !== 'test') {\r\n    runCLI(process.argv);\r\n}\r\n/* v8 ignore end */\r\n","import fs from 'fs';\r\nimport path from 'path';\r\nimport { parseVsMeta, VsMetaData } from 'vsmeta-parser';\r\nimport { ConvertOptions, ConvertResult } from './types.js';\r\n\r\n// Common video extensions checked when verifying a matching media file exists.\r\nconst MEDIA_EXTENSIONS = new Set(['.mp4', '.mkv', '.avi', '.mov', '.wmv', '.m4v', '.m2ts', '.ts', '.mpg', '.mpeg']);\r\n\r\n// Per-directory cache for readdirSync results — avoids redundant I/O when\r\n// multiple .vsmeta files share the same folder during a batch conversion.\r\nconst readdirCache = new Map<string, string[]>();\r\n\r\n/** Clear the internal directory listing cache. Call after a batch run completes. */\r\nexport function clearReaddirCache(): void {\r\n    readdirCache.clear();\r\n}\r\n\r\nexport function hasMatchingMediaFile(vsmetaPath: string): boolean {\r\n    const dir = path.dirname(vsmetaPath);\r\n    const basename = path.basename(vsmetaPath, '.vsmeta');\r\n\r\n    if (fs.existsSync(path.join(dir, basename))) {\r\n        return true;\r\n    }\r\n\r\n    let files = readdirCache.get(dir);\r\n    if (!files) {\r\n        files = fs.readdirSync(dir) as string[];\r\n        readdirCache.set(dir, files);\r\n    }\r\n\r\n    for (const file of files) {\r\n        if (file.startsWith(basename) && file !== path.basename(vsmetaPath)) {\r\n            const ext = path.extname(file).toLowerCase();\r\n            if (MEDIA_EXTENSIONS.has(ext)) {\r\n                return true;\r\n            }\r\n        }\r\n    }\r\n\r\n    return false;\r\n}\r\n\r\nexport function convertVsMetaToJpeg(vsmetaPath: string, options: ConvertOptions = {}): ConvertResult {\r\n    try {\r\n        if (!hasMatchingMediaFile(vsmetaPath)) {\r\n            return {\r\n                status: 'SKIP',\r\n                vsmetaPath,\r\n                message: `No matching media file found for: ${vsmetaPath}`\r\n            };\r\n        }\r\n\r\n        const buffer = fs.readFileSync(vsmetaPath);\r\n        let meta: VsMetaData;\r\n        try {\r\n            meta = parseVsMeta(buffer);\r\n        } catch (e) {\r\n            return {\r\n                status: 'WARN',\r\n                vsmetaPath,\r\n                message: `Failed to parse ${vsmetaPath}: ${(e as Error).message}`\r\n            };\r\n        }\r\n\r\n        const isEpisode = meta.contentType === 2 || (meta.season != null && meta.episode != null);\r\n        const posterPath = vsmetaPath.replace(/\\.vsmeta$/i, '-poster.jpg');\r\n        const fanartPath = vsmetaPath.replace(/\\.vsmeta$/i, isEpisode ? '-thumb.jpg' : '-fanart.jpg');\r\n\r\n        const posterExists = fs.existsSync(posterPath);\r\n        const fanartExists = fs.existsSync(fanartPath);\r\n\r\n        if (!options.overwrite && posterExists && fanartExists) {\r\n            return {\r\n                status: 'SKIP',\r\n                vsmetaPath,\r\n                message: `Images already exist (use --overwrite to replace): ${vsmetaPath}`,\r\n                posterPath,\r\n                fanartPath\r\n            };\r\n        }\r\n\r\n        const results: string[] = [];\r\n        let anyExtracted = false;\r\n\r\n        if (meta.posterImage) {\r\n            if (options.overwrite || !posterExists) {\r\n                if (!options.dryRun) {\r\n                    fs.writeFileSync(posterPath, meta.posterImage);\r\n                }\r\n                results.push(`poster: ${posterPath}`);\r\n                anyExtracted = true;\r\n            }\r\n        }\r\n\r\n        if (meta.backdropImage) {\r\n            if (options.overwrite || !fanartExists) {\r\n                if (!options.dryRun) {\r\n                    fs.writeFileSync(fanartPath, meta.backdropImage);\r\n                }\r\n                results.push(`${isEpisode ? 'thumb' : 'fanart'}: ${fanartPath}`);\r\n                anyExtracted = true;\r\n            }\r\n        }\r\n\r\n        if (!anyExtracted) {\r\n            return {\r\n                status: 'WARN',\r\n                vsmetaPath,\r\n                message: `No images found in ${vsmetaPath}`\r\n            };\r\n        }\r\n\r\n        const prefix = options.dryRun ? '[DRY RUN] ' : '';\r\n        return {\r\n            status: 'SUCCESS',\r\n            vsmetaPath,\r\n            message: `${prefix}Extracted ${results.join(', ')}`,\r\n            posterPath: meta.posterImage ? posterPath : undefined,\r\n            fanartPath: meta.backdropImage ? fanartPath : undefined\r\n        };\r\n\r\n    } catch (err) {\r\n        const e = err as Error & { code?: string };\r\n        let msg = '';\r\n        if (e.code === 'EACCES' || e.code === 'EPERM') {\r\n            msg = `Permission denied: Cannot read/write files. Please check permissions for ${vsmetaPath}`;\r\n        } else {\r\n            msg = `Processing ${vsmetaPath}: ${e.message || err}`;\r\n        }\r\n        return { status: 'ERROR', vsmetaPath, message: msg };\r\n    }\r\n}\r\n","import { ConvertResult } from './types.js';\r\n\r\nexport function getResultMessage(result: ConvertResult): string {\r\n    return `[${result.status}] ${result.message}`;\r\n}\r\n\r\nexport function logConvertResult(result: ConvertResult) {\r\n    const msg = getResultMessage(result);\r\n    if (result.status === 'ERROR') {\r\n        console.error(msg);\r\n    } else if (result.status === 'WARN') {\r\n        console.warn(msg);\r\n    } else {\r\n        console.log(msg);\r\n    }\r\n}\r\n"],"mappings":"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","names":["import_path","import_fs","path","fs","path","fs","glob"]}

package/dist/cli.d.cts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { C as ConvertOptions } from './types-CSvk8Xx7.cjs';
+
+declare function processAction(targetPath: string, options: ConvertOptions): Promise<void>;
+declare function runCLI(argv: string[]): void;
+
+export { processAction, runCLI };

package/dist/cli.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { C as ConvertOptions } from './types-CSvk8Xx7.js';
+
+declare function processAction(targetPath: string, options: ConvertOptions): Promise<void>;
+declare function runCLI(argv: string[]): void;
+
+export { processAction, runCLI };

package/dist/cli.js

@@ -0,0 +1,68 @@
+#!/usr/bin/env node
+import {
+  convertVsMetaToJpeg,
+  getResultMessage,
+  logConvertResult
+} from "./chunk-2EEHQI7P.js";
+
+// src/cli.ts
+import { Command } from "commander";
+import path from "path";
+import fs from "fs";
+import glob from "fast-glob";
+async function processAction(targetPath, options) {
+  const fullPath = path.resolve(targetPath);
+  if (!fs.existsSync(fullPath)) {
+    console.error(`[ERROR] Path not found: ${fullPath}`);
+    process.exit(1);
+  }
+  const stat = fs.statSync(fullPath);
+  if (stat.isFile()) {
+    if (!fullPath.toLowerCase().endsWith(".vsmeta")) {
+      console.error(`[ERROR] File is not a .vsmeta: ${fullPath}`);
+      process.exit(1);
+    }
+    const result = convertVsMetaToJpeg(fullPath, options);
+    logConvertResult(result);
+  } else {
+    console.log(`Scanning directory: ${fullPath}`);
+    const files = await glob("**/*.vsmeta", { cwd: fullPath, absolute: true, caseSensitiveMatch: false });
+    if (files.length === 0) {
+      console.log("No .vsmeta files found.");
+      return;
+    }
+    console.log(`Found ${files.length} .vsmeta files.`);
+    const counts = { SUCCESS: 0, ERROR: 0, SKIP: 0, WARN: 0 };
+    const nonSuccesses = [];
+    for (const file of files) {
+      const result = convertVsMetaToJpeg(file, options);
+      logConvertResult(result);
+      counts[result.status]++;
+      if (result.status !== "SUCCESS") {
+        nonSuccesses.push(getResultMessage(result));
+      }
+    }
+    console.log("\n--- Final Summary ---");
+    console.log(`[SUCCESS] : ${counts.SUCCESS}`);
+    console.log(`[SKIP]    : ${counts.SKIP}`);
+    console.log(`[WARN]    : ${counts.WARN}`);
+    console.log(`[ERROR]   : ${counts.ERROR}`);
+    if (options.verbose && nonSuccesses.length > 0) {
+      console.log("\n--- Verbose (Non-Success items) ---");
+      nonSuccesses.forEach((msg) => console.log(msg));
+    }
+  }
+}
+function runCLI(argv) {
+  const program = new Command();
+  program.name("vsmeta-to-jpeg").description("Extract embedded JPEG images from Synology .vsmeta files.").argument("<path>", "File or folder path to process. If a folder, it traverses recursively.").option("-d, --dry-run", "Dry run without outputting files.").option("-f, --overwrite", "Overwrite existing JPEG files.").option("-v, --verbose", "Print a summary of all non-successful operations at the end.").action(processAction);
+  program.parse(argv);
+}
+if (process.env.NODE_ENV !== "test") {
+  runCLI(process.argv);
+}
+export {
+  processAction,
+  runCLI
+};
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\r\nimport { Command } from 'commander';\r\nimport path from 'path';\r\nimport fs from 'fs';\r\nimport glob from 'fast-glob';\r\nimport { convertVsMetaToJpeg } from './converter.js';\r\nimport { logConvertResult, getResultMessage } from './logger.js';\r\nimport { ConvertOptions } from './types.js';\r\n\r\nexport async function processAction(targetPath: string, options: ConvertOptions) {\r\n    const fullPath = path.resolve(targetPath);\r\n\r\n    if (!fs.existsSync(fullPath)) {\r\n        console.error(`[ERROR] Path not found: ${fullPath}`);\r\n        process.exit(1);\r\n    }\r\n\r\n    const stat = fs.statSync(fullPath);\r\n\r\n    if (stat.isFile()) {\r\n        if (!fullPath.toLowerCase().endsWith('.vsmeta')) {\r\n            console.error(`[ERROR] File is not a .vsmeta: ${fullPath}`);\r\n            process.exit(1);\r\n        }\r\n        const result = convertVsMetaToJpeg(fullPath, options);\r\n        logConvertResult(result);\r\n    } else {\r\n        console.log(`Scanning directory: ${fullPath}`);\r\n        const files = await glob('**/*.vsmeta', { cwd: fullPath, absolute: true, caseSensitiveMatch: false });\r\n\r\n        if (files.length === 0) {\r\n            console.log('No .vsmeta files found.');\r\n            return;\r\n        }\r\n        console.log(`Found ${files.length} .vsmeta files.`);\r\n\r\n        const counts = { SUCCESS: 0, ERROR: 0, SKIP: 0, WARN: 0 };\r\n        const nonSuccesses: string[] = [];\r\n        for (const file of files) {\r\n            const result = convertVsMetaToJpeg(file, options);\r\n            logConvertResult(result);\r\n            counts[result.status]++;\r\n            if (result.status !== 'SUCCESS') {\r\n                nonSuccesses.push(getResultMessage(result));\r\n            }\r\n        }\r\n        console.log('\\n--- Final Summary ---');\r\n        console.log(`[SUCCESS] : ${counts.SUCCESS}`);\r\n        console.log(`[SKIP]    : ${counts.SKIP}`);\r\n        console.log(`[WARN]    : ${counts.WARN}`);\r\n        console.log(`[ERROR]   : ${counts.ERROR}`);\r\n\r\n        if (options.verbose && nonSuccesses.length > 0) {\r\n            console.log('\\n--- Verbose (Non-Success items) ---');\r\n            nonSuccesses.forEach(msg => console.log(msg));\r\n        }\r\n    }\r\n}\r\n\r\nexport function runCLI(argv: string[]) {\r\n    const program = new Command();\r\n    program\r\n        .name('vsmeta-to-jpeg')\r\n        .description('Extract embedded JPEG images from Synology .vsmeta files.')\r\n        .argument('<path>', 'File or folder path to process. If a folder, it traverses recursively.')\r\n        .option('-d, --dry-run', 'Dry run without outputting files.')\r\n        .option('-f, --overwrite', 'Overwrite existing JPEG files.')\r\n        .option('-v, --verbose', 'Print a summary of all non-successful operations at the end.')\r\n        .action(processAction);\r\n\r\n    program.parse(argv);\r\n}\r\n\r\n/* v8 ignore start */\r\n/* istanbul ignore next -- bootstrap guard */\r\nif (process.env.NODE_ENV !== 'test') {\r\n    runCLI(process.argv);\r\n}\r\n/* v8 ignore end */\r\n"],"mappings":";;;;;;;;AACA,SAAS,eAAe;AACxB,OAAO,UAAU;AACjB,OAAO,QAAQ;AACf,OAAO,UAAU;AAKjB,eAAsB,cAAc,YAAoB,SAAyB;AAC7E,QAAM,WAAW,KAAK,QAAQ,UAAU;AAExC,MAAI,CAAC,GAAG,WAAW,QAAQ,GAAG;AAC1B,YAAQ,MAAM,2BAA2B,QAAQ,EAAE;AACnD,YAAQ,KAAK,CAAC;AAAA,EAClB;AAEA,QAAM,OAAO,GAAG,SAAS,QAAQ;AAEjC,MAAI,KAAK,OAAO,GAAG;AACf,QAAI,CAAC,SAAS,YAAY,EAAE,SAAS,SAAS,GAAG;AAC7C,cAAQ,MAAM,kCAAkC,QAAQ,EAAE;AAC1D,cAAQ,KAAK,CAAC;AAAA,IAClB;AACA,UAAM,SAAS,oBAAoB,UAAU,OAAO;AACpD,qBAAiB,MAAM;AAAA,EAC3B,OAAO;AACH,YAAQ,IAAI,uBAAuB,QAAQ,EAAE;AAC7C,UAAM,QAAQ,MAAM,KAAK,eAAe,EAAE,KAAK,UAAU,UAAU,MAAM,oBAAoB,MAAM,CAAC;AAEpG,QAAI,MAAM,WAAW,GAAG;AACpB,cAAQ,IAAI,yBAAyB;AACrC;AAAA,IACJ;AACA,YAAQ,IAAI,SAAS,MAAM,MAAM,iBAAiB;AAElD,UAAM,SAAS,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,EAAE;AACxD,UAAM,eAAyB,CAAC;AAChC,eAAW,QAAQ,OAAO;AACtB,YAAM,SAAS,oBAAoB,MAAM,OAAO;AAChD,uBAAiB,MAAM;AACvB,aAAO,OAAO,MAAM;AACpB,UAAI,OAAO,WAAW,WAAW;AAC7B,qBAAa,KAAK,iBAAiB,MAAM,CAAC;AAAA,MAC9C;AAAA,IACJ;AACA,YAAQ,IAAI,yBAAyB;AACrC,YAAQ,IAAI,eAAe,OAAO,OAAO,EAAE;AAC3C,YAAQ,IAAI,eAAe,OAAO,IAAI,EAAE;AACxC,YAAQ,IAAI,eAAe,OAAO,IAAI,EAAE;AACxC,YAAQ,IAAI,eAAe,OAAO,KAAK,EAAE;AAEzC,QAAI,QAAQ,WAAW,aAAa,SAAS,GAAG;AAC5C,cAAQ,IAAI,uCAAuC;AACnD,mBAAa,QAAQ,SAAO,QAAQ,IAAI,GAAG,CAAC;AAAA,IAChD;AAAA,EACJ;AACJ;AAEO,SAAS,OAAO,MAAgB;AACnC,QAAM,UAAU,IAAI,QAAQ;AAC5B,UACK,KAAK,gBAAgB,EACrB,YAAY,2DAA2D,EACvE,SAAS,UAAU,wEAAwE,EAC3F,OAAO,iBAAiB,mCAAmC,EAC3D,OAAO,mBAAmB,gCAAgC,EAC1D,OAAO,iBAAiB,8DAA8D,EACtF,OAAO,aAAa;AAEzB,UAAQ,MAAM,IAAI;AACtB;AAIA,IAAI,QAAQ,IAAI,aAAa,QAAQ;AACjC,SAAO,QAAQ,IAAI;AACvB;","names":[]}

package/dist/index.cjs

@@ -0,0 +1,174 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  clearReaddirCache: () => clearReaddirCache,
+  convertVsMetaToJpeg: () => convertVsMetaToJpeg,
+  getResultMessage: () => getResultMessage,
+  hasMatchingMediaFile: () => hasMatchingMediaFile,
+  logConvertResult: () => logConvertResult
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/converter.ts
+var import_fs = __toESM(require("fs"), 1);
+var import_path = __toESM(require("path"), 1);
+var import_vsmeta_parser = require("vsmeta-parser");
+var MEDIA_EXTENSIONS = /* @__PURE__ */ new Set([".mp4", ".mkv", ".avi", ".mov", ".wmv", ".m4v", ".m2ts", ".ts", ".mpg", ".mpeg"]);
+var readdirCache = /* @__PURE__ */ new Map();
+function clearReaddirCache() {
+  readdirCache.clear();
+}
+function hasMatchingMediaFile(vsmetaPath) {
+  const dir = import_path.default.dirname(vsmetaPath);
+  const basename = import_path.default.basename(vsmetaPath, ".vsmeta");
+  if (import_fs.default.existsSync(import_path.default.join(dir, basename))) {
+    return true;
+  }
+  let files = readdirCache.get(dir);
+  if (!files) {
+    files = import_fs.default.readdirSync(dir);
+    readdirCache.set(dir, files);
+  }
+  for (const file of files) {
+    if (file.startsWith(basename) && file !== import_path.default.basename(vsmetaPath)) {
+      const ext = import_path.default.extname(file).toLowerCase();
+      if (MEDIA_EXTENSIONS.has(ext)) {
+        return true;
+      }
+    }
+  }
+  return false;
+}
+function convertVsMetaToJpeg(vsmetaPath, options = {}) {
+  try {
+    if (!hasMatchingMediaFile(vsmetaPath)) {
+      return {
+        status: "SKIP",
+        vsmetaPath,
+        message: `No matching media file found for: ${vsmetaPath}`
+      };
+    }
+    const buffer = import_fs.default.readFileSync(vsmetaPath);
+    let meta;
+    try {
+      meta = (0, import_vsmeta_parser.parseVsMeta)(buffer);
+    } catch (e) {
+      return {
+        status: "WARN",
+        vsmetaPath,
+        message: `Failed to parse ${vsmetaPath}: ${e.message}`
+      };
+    }
+    const isEpisode = meta.contentType === 2 || meta.season != null && meta.episode != null;
+    const posterPath = vsmetaPath.replace(/\.vsmeta$/i, "-poster.jpg");
+    const fanartPath = vsmetaPath.replace(/\.vsmeta$/i, isEpisode ? "-thumb.jpg" : "-fanart.jpg");
+    const posterExists = import_fs.default.existsSync(posterPath);
+    const fanartExists = import_fs.default.existsSync(fanartPath);
+    if (!options.overwrite && posterExists && fanartExists) {
+      return {
+        status: "SKIP",
+        vsmetaPath,
+        message: `Images already exist (use --overwrite to replace): ${vsmetaPath}`,
+        posterPath,
+        fanartPath
+      };
+    }
+    const results = [];
+    let anyExtracted = false;
+    if (meta.posterImage) {
+      if (options.overwrite || !posterExists) {
+        if (!options.dryRun) {
+          import_fs.default.writeFileSync(posterPath, meta.posterImage);
+        }
+        results.push(`poster: ${posterPath}`);
+        anyExtracted = true;
+      }
+    }
+    if (meta.backdropImage) {
+      if (options.overwrite || !fanartExists) {
+        if (!options.dryRun) {
+          import_fs.default.writeFileSync(fanartPath, meta.backdropImage);
+        }
+        results.push(`${isEpisode ? "thumb" : "fanart"}: ${fanartPath}`);
+        anyExtracted = true;
+      }
+    }
+    if (!anyExtracted) {
+      return {
+        status: "WARN",
+        vsmetaPath,
+        message: `No images found in ${vsmetaPath}`
+      };
+    }
+    const prefix = options.dryRun ? "[DRY RUN] " : "";
+    return {
+      status: "SUCCESS",
+      vsmetaPath,
+      message: `${prefix}Extracted ${results.join(", ")}`,
+      posterPath: meta.posterImage ? posterPath : void 0,
+      fanartPath: meta.backdropImage ? fanartPath : void 0
+    };
+  } catch (err) {
+    const e = err;
+    let msg = "";
+    if (e.code === "EACCES" || e.code === "EPERM") {
+      msg = `Permission denied: Cannot read/write files. Please check permissions for ${vsmetaPath}`;
+    } else {
+      msg = `Processing ${vsmetaPath}: ${e.message || err}`;
+    }
+    return { status: "ERROR", vsmetaPath, message: msg };
+  }
+}
+
+// src/logger.ts
+function getResultMessage(result) {
+  return `[${result.status}] ${result.message}`;
+}
+function logConvertResult(result) {
+  const msg = getResultMessage(result);
+  if (result.status === "ERROR") {
+    console.error(msg);
+  } else if (result.status === "WARN") {
+    console.warn(msg);
+  } else {
+    console.log(msg);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  clearReaddirCache,
+  convertVsMetaToJpeg,
+  getResultMessage,
+  hasMatchingMediaFile,
+  logConvertResult
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/converter.ts","../src/logger.ts"],"sourcesContent":["export * from './converter.js';\r\nexport * from './logger.js';\r\nexport * from './types.js';\r\n","import fs from 'fs';\r\nimport path from 'path';\r\nimport { parseVsMeta, VsMetaData } from 'vsmeta-parser';\r\nimport { ConvertOptions, ConvertResult } from './types.js';\r\n\r\n// Common video extensions checked when verifying a matching media file exists.\r\nconst MEDIA_EXTENSIONS = new Set(['.mp4', '.mkv', '.avi', '.mov', '.wmv', '.m4v', '.m2ts', '.ts', '.mpg', '.mpeg']);\r\n\r\n// Per-directory cache for readdirSync results — avoids redundant I/O when\r\n// multiple .vsmeta files share the same folder during a batch conversion.\r\nconst readdirCache = new Map<string, string[]>();\r\n\r\n/** Clear the internal directory listing cache. Call after a batch run completes. */\r\nexport function clearReaddirCache(): void {\r\n    readdirCache.clear();\r\n}\r\n\r\nexport function hasMatchingMediaFile(vsmetaPath: string): boolean {\r\n    const dir = path.dirname(vsmetaPath);\r\n    const basename = path.basename(vsmetaPath, '.vsmeta');\r\n\r\n    if (fs.existsSync(path.join(dir, basename))) {\r\n        return true;\r\n    }\r\n\r\n    let files = readdirCache.get(dir);\r\n    if (!files) {\r\n        files = fs.readdirSync(dir) as string[];\r\n        readdirCache.set(dir, files);\r\n    }\r\n\r\n    for (const file of files) {\r\n        if (file.startsWith(basename) && file !== path.basename(vsmetaPath)) {\r\n            const ext = path.extname(file).toLowerCase();\r\n            if (MEDIA_EXTENSIONS.has(ext)) {\r\n                return true;\r\n            }\r\n        }\r\n    }\r\n\r\n    return false;\r\n}\r\n\r\nexport function convertVsMetaToJpeg(vsmetaPath: string, options: ConvertOptions = {}): ConvertResult {\r\n    try {\r\n        if (!hasMatchingMediaFile(vsmetaPath)) {\r\n            return {\r\n                status: 'SKIP',\r\n                vsmetaPath,\r\n                message: `No matching media file found for: ${vsmetaPath}`\r\n            };\r\n        }\r\n\r\n        const buffer = fs.readFileSync(vsmetaPath);\r\n        let meta: VsMetaData;\r\n        try {\r\n            meta = parseVsMeta(buffer);\r\n        } catch (e) {\r\n            return {\r\n                status: 'WARN',\r\n                vsmetaPath,\r\n                message: `Failed to parse ${vsmetaPath}: ${(e as Error).message}`\r\n            };\r\n        }\r\n\r\n        const isEpisode = meta.contentType === 2 || (meta.season != null && meta.episode != null);\r\n        const posterPath = vsmetaPath.replace(/\\.vsmeta$/i, '-poster.jpg');\r\n        const fanartPath = vsmetaPath.replace(/\\.vsmeta$/i, isEpisode ? '-thumb.jpg' : '-fanart.jpg');\r\n\r\n        const posterExists = fs.existsSync(posterPath);\r\n        const fanartExists = fs.existsSync(fanartPath);\r\n\r\n        if (!options.overwrite && posterExists && fanartExists) {\r\n            return {\r\n                status: 'SKIP',\r\n                vsmetaPath,\r\n                message: `Images already exist (use --overwrite to replace): ${vsmetaPath}`,\r\n                posterPath,\r\n                fanartPath\r\n            };\r\n        }\r\n\r\n        const results: string[] = [];\r\n        let anyExtracted = false;\r\n\r\n        if (meta.posterImage) {\r\n            if (options.overwrite || !posterExists) {\r\n                if (!options.dryRun) {\r\n                    fs.writeFileSync(posterPath, meta.posterImage);\r\n                }\r\n                results.push(`poster: ${posterPath}`);\r\n                anyExtracted = true;\r\n            }\r\n        }\r\n\r\n        if (meta.backdropImage) {\r\n            if (options.overwrite || !fanartExists) {\r\n                if (!options.dryRun) {\r\n                    fs.writeFileSync(fanartPath, meta.backdropImage);\r\n                }\r\n                results.push(`${isEpisode ? 'thumb' : 'fanart'}: ${fanartPath}`);\r\n                anyExtracted = true;\r\n            }\r\n        }\r\n\r\n        if (!anyExtracted) {\r\n            return {\r\n                status: 'WARN',\r\n                vsmetaPath,\r\n                message: `No images found in ${vsmetaPath}`\r\n            };\r\n        }\r\n\r\n        const prefix = options.dryRun ? '[DRY RUN] ' : '';\r\n        return {\r\n            status: 'SUCCESS',\r\n            vsmetaPath,\r\n            message: `${prefix}Extracted ${results.join(', ')}`,\r\n            posterPath: meta.posterImage ? posterPath : undefined,\r\n            fanartPath: meta.backdropImage ? fanartPath : undefined\r\n        };\r\n\r\n    } catch (err) {\r\n        const e = err as Error & { code?: string };\r\n        let msg = '';\r\n        if (e.code === 'EACCES' || e.code === 'EPERM') {\r\n            msg = `Permission denied: Cannot read/write files. Please check permissions for ${vsmetaPath}`;\r\n        } else {\r\n            msg = `Processing ${vsmetaPath}: ${e.message || err}`;\r\n        }\r\n        return { status: 'ERROR', vsmetaPath, message: msg };\r\n    }\r\n}\r\n","import { ConvertResult } from './types.js';\r\n\r\nexport function getResultMessage(result: ConvertResult): string {\r\n    return `[${result.status}] ${result.message}`;\r\n}\r\n\r\nexport function logConvertResult(result: ConvertResult) {\r\n    const msg = getResultMessage(result);\r\n    if (result.status === 'ERROR') {\r\n        console.error(msg);\r\n    } else if (result.status === 'WARN') {\r\n        console.warn(msg);\r\n    } else {\r\n        console.log(msg);\r\n    }\r\n}\r\n"],"mappings":"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","names":["path","fs"]}

package/dist/index.d.cts

@@ -0,0 +1,11 @@
+import { C as ConvertOptions, a as ConvertResult } from './types-CSvk8Xx7.cjs';
+
+/** Clear the internal directory listing cache. Call after a batch run completes. */
+declare function clearReaddirCache(): void;
+declare function hasMatchingMediaFile(vsmetaPath: string): boolean;
+declare function convertVsMetaToJpeg(vsmetaPath: string, options?: ConvertOptions): ConvertResult;
+
+declare function getResultMessage(result: ConvertResult): string;
+declare function logConvertResult(result: ConvertResult): void;
+
+export { ConvertOptions, ConvertResult, clearReaddirCache, convertVsMetaToJpeg, getResultMessage, hasMatchingMediaFile, logConvertResult };

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import { C as ConvertOptions, a as ConvertResult } from './types-CSvk8Xx7.js';
+
+/** Clear the internal directory listing cache. Call after a batch run completes. */
+declare function clearReaddirCache(): void;
+declare function hasMatchingMediaFile(vsmetaPath: string): boolean;
+declare function convertVsMetaToJpeg(vsmetaPath: string, options?: ConvertOptions): ConvertResult;
+
+declare function getResultMessage(result: ConvertResult): string;
+declare function logConvertResult(result: ConvertResult): void;
+
+export { ConvertOptions, ConvertResult, clearReaddirCache, convertVsMetaToJpeg, getResultMessage, hasMatchingMediaFile, logConvertResult };

package/dist/index.js

@@ -0,0 +1,15 @@
+import {
+  clearReaddirCache,
+  convertVsMetaToJpeg,
+  getResultMessage,
+  hasMatchingMediaFile,
+  logConvertResult
+} from "./chunk-2EEHQI7P.js";
+export {
+  clearReaddirCache,
+  convertVsMetaToJpeg,
+  getResultMessage,
+  hasMatchingMediaFile,
+  logConvertResult
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/types-CSvk8Xx7.d.cts

@@ -0,0 +1,14 @@
+interface ConvertOptions {
+    dryRun?: boolean;
+    overwrite?: boolean;
+    verbose?: boolean;
+}
+interface ConvertResult {
+    status: 'SUCCESS' | 'WARN' | 'SKIP' | 'ERROR';
+    vsmetaPath: string;
+    message: string;
+    posterPath?: string;
+    fanartPath?: string;
+}
+
+export type { ConvertOptions as C, ConvertResult as a };

package/dist/types-CSvk8Xx7.d.ts

@@ -0,0 +1,14 @@
+interface ConvertOptions {
+    dryRun?: boolean;
+    overwrite?: boolean;
+    verbose?: boolean;
+}
+interface ConvertResult {
+    status: 'SUCCESS' | 'WARN' | 'SKIP' | 'ERROR';
+    vsmetaPath: string;
+    message: string;
+    posterPath?: string;
+    fanartPath?: string;
+}
+
+export type { ConvertOptions as C, ConvertResult as a };

package/package.json

@@ -0,0 +1,61 @@
+{
+    "name": "vsmeta-to-jpeg",
+    "version": "1.0.0",
+    "description": "Extract embedded JPEG images from Synology .vsmeta files.",
+    "type": "module",
+    "main": "./dist/index.cjs",
+    "module": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "import": {
+                "types": "./dist/index.d.ts",
+                "default": "./dist/index.js"
+            },
+            "require": {
+                "types": "./dist/index.d.cts",
+                "default": "./dist/index.cjs"
+            }
+        }
+    },
+    "bin": {
+        "vsmeta-to-jpeg": "./dist/cli.js"
+    },
+    "files": [
+        "dist",
+        "README.md"
+    ],
+    "scripts": {
+        "build": "tsup",
+        "test": "vitest run --coverage",
+        "test:watch": "vitest",
+        "lint": "eslint src test",
+        "format": "prettier --write src test",
+        "typecheck": "tsc --noEmit",
+        "prepublishOnly": "npm run typecheck && npm run lint && npm run test && npm run build",
+        "changeset": "changeset",
+        "version-packages": "changeset version",
+        "release": "npm run prepublishOnly && changeset publish"
+    },
+    "author": "Charles Aldarondo <charles.aldarondo@gmail.com>",
+    "license": "MIT",
+    "engines": {
+        "node": ">=18"
+    },
+    "devDependencies": {
+        "@changesets/cli": "^2.29.8",
+        "@types/node": "^25.3.3",
+        "@vitest/coverage-v8": "^4.0.18",
+        "eslint": "^9.39.3",
+        "prettier": "^3.8.1",
+        "tsup": "^8.5.1",
+        "typescript": "^5.9.3",
+        "typescript-eslint": "^8.56.1",
+        "vitest": "^4.0.18"
+    },
+    "dependencies": {
+        "commander": "^14.0.3",
+        "fast-glob": "^3.3.3",
+        "vsmeta-parser": "^1.0.1"
+    }
+}