simple-photo-gallery 2.0.11-rc.1 → 2.0.11-rc.3

package/dist/lib/index.cjs

@@ -0,0 +1,152 @@
+'use strict';
+
+var blurhash = require('blurhash');
+var ExifReader = require('exifreader');
+var sharp = require('sharp');
+var child_process = require('child_process');
+var fs = require('fs');
+var ffprobe = require('node-ffprobe');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var ExifReader__default = /*#__PURE__*/_interopDefault(ExifReader);
+var sharp__default = /*#__PURE__*/_interopDefault(sharp);
+var ffprobe__default = /*#__PURE__*/_interopDefault(ffprobe);
+
+// src/utils/blurhash.ts
+async function loadImage(imagePath) {
+  return sharp__default.default(imagePath).rotate();
+}
+async function loadImageWithMetadata(imagePath) {
+  const image = sharp__default.default(imagePath);
+  const metadata = await image.metadata();
+  image.rotate();
+  const needsDimensionSwap = metadata.orientation && metadata.orientation >= 5 && metadata.orientation <= 8;
+  if (needsDimensionSwap) {
+    const originalWidth = metadata.width;
+    metadata.width = metadata.height;
+    metadata.height = originalWidth;
+  }
+  return { image, metadata };
+}
+async function resizeImage(image, outputPath, width, height, format = "avif") {
+  await image.resize(width, height, { withoutEnlargement: true }).toFormat(format).toFile(outputPath);
+}
+async function cropAndResizeImage(image, outputPath, width, height, format = "avif") {
+  await image.resize(width, height, {
+    fit: "cover",
+    withoutEnlargement: true
+  }).toFormat(format).toFile(outputPath);
+}
+async function getImageDescription(imagePath) {
+  try {
+    const tags = await ExifReader__default.default.load(imagePath);
+    if (tags.description?.description) return tags.description.description;
+    if (tags.ImageDescription?.description) return tags.ImageDescription.description;
+    if (tags.UserComment && typeof tags.UserComment === "object" && tags.UserComment !== null && "description" in tags.UserComment) {
+      return tags.UserComment.description;
+    }
+    if (tags.ExtDescrAccessibility?.description) return tags.ExtDescrAccessibility.description;
+    if (tags["Caption/Abstract"]?.description) return tags["Caption/Abstract"].description;
+    if (tags.XPTitle?.description) return tags.XPTitle.description;
+    if (tags.XPComment?.description) return tags.XPComment.description;
+  } catch {
+    return void 0;
+  }
+}
+async function createImageThumbnails(image, metadata, outputPath, outputPathRetina, size) {
+  const originalWidth = metadata.width || 0;
+  const originalHeight = metadata.height || 0;
+  if (originalWidth === 0 || originalHeight === 0) {
+    throw new Error("Invalid image dimensions");
+  }
+  const aspectRatio = originalWidth / originalHeight;
+  let width;
+  let height;
+  if (originalWidth > originalHeight) {
+    width = size;
+    height = Math.round(size / aspectRatio);
+  } else {
+    width = Math.round(size * aspectRatio);
+    height = size;
+  }
+  await resizeImage(image, outputPath, width, height);
+  await resizeImage(image, outputPathRetina, width * 2, height * 2);
+  return { width, height };
+}
+
+// src/utils/blurhash.ts
+async function generateBlurHash(imagePath, componentX = 4, componentY = 3) {
+  const image = await loadImage(imagePath);
+  const { data, info } = await image.resize(32, 32, { fit: "inside" }).ensureAlpha().raw().toBuffer({ resolveWithObject: true });
+  const pixels = new Uint8ClampedArray(data.buffer);
+  return blurhash.encode(pixels, info.width, info.height, componentX, componentY);
+}
+async function getVideoDimensions(filePath) {
+  const data = await ffprobe__default.default(filePath);
+  const videoStream = data.streams.find((stream) => stream.codec_type === "video");
+  if (!videoStream) {
+    throw new Error("No video stream found");
+  }
+  const dimensions = {
+    width: videoStream.width || 0,
+    height: videoStream.height || 0
+  };
+  if (dimensions.width === 0 || dimensions.height === 0) {
+    throw new Error("Invalid video dimensions");
+  }
+  return dimensions;
+}
+async function createVideoThumbnails(inputPath, videoDimensions, outputPath, outputPathRetina, height, verbose = false) {
+  const aspectRatio = videoDimensions.width / videoDimensions.height;
+  const width = Math.round(height * aspectRatio);
+  const tempFramePath = `${outputPath}.temp.png`;
+  return new Promise((resolve, reject) => {
+    const ffmpeg = child_process.spawn("ffmpeg", [
+      "-i",
+      inputPath,
+      "-vframes",
+      "1",
+      "-y",
+      "-loglevel",
+      verbose ? "error" : "quiet",
+      tempFramePath
+    ]);
+    ffmpeg.stderr.on("data", (data) => {
+      console.log(`ffmpeg: ${data.toString()}`);
+    });
+    ffmpeg.on("close", async (code) => {
+      if (code === 0) {
+        try {
+          const frameImage = sharp__default.default(tempFramePath);
+          await resizeImage(frameImage, outputPath, width, height);
+          await resizeImage(frameImage, outputPathRetina, width * 2, height * 2);
+          try {
+            await fs.promises.unlink(tempFramePath);
+          } catch {
+          }
+          resolve({ width, height });
+        } catch (sharpError) {
+          reject(new Error(`Failed to process extracted frame: ${sharpError}`));
+        }
+      } else {
+        reject(new Error(`ffmpeg exited with code ${code}`));
+      }
+    });
+    ffmpeg.on("error", (error) => {
+      reject(new Error(`Failed to start ffmpeg: ${error.message}`));
+    });
+  });
+}
+
+exports.createImageThumbnails = createImageThumbnails;
+exports.createVideoThumbnails = createVideoThumbnails;
+exports.cropAndResizeImage = cropAndResizeImage;
+exports.generateBlurHash = generateBlurHash;
+exports.getImageDescription = getImageDescription;
+exports.getVideoDimensions = getVideoDimensions;
+exports.loadImage = loadImage;
+exports.loadImageWithMetadata = loadImageWithMetadata;
+exports.resizeImage = resizeImage;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/lib/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/image.ts","../../src/utils/blurhash.ts","../../src/utils/video.ts"],"names":["sharp","ExifReader","encode","ffprobe","spawn","fs"],"mappings":"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","file":"index.cjs","sourcesContent":["import ExifReader from 'exifreader';\nimport sharp from 'sharp';\n\nimport type { Dimensions, ImageWithMetadata } from '../types';\nimport type { FormatEnum, Metadata, Sharp } from 'sharp';\n\n/**\n * Loads an image and auto-rotates it based on EXIF orientation.\n * @param imagePath - Path to the image file\n * @returns Promise resolving to Sharp image instance\n */\nexport async function loadImage(imagePath: string): Promise<Sharp> {\n  return sharp(imagePath).rotate();\n}\n\n/**\n * Loads an image and its metadata, auto-rotating it based on EXIF orientation and swapping dimensions if needed.\n * @param imagePath - Path to the image file\n * @returns Promise resolving to ImageWithMetadata object containing Sharp image instance and metadata\n */\nexport async function loadImageWithMetadata(imagePath: string): Promise<ImageWithMetadata> {\n  const image = sharp(imagePath);\n  const metadata = await image.metadata();\n\n  // Auto-rotate based on EXIF orientation\n  image.rotate();\n\n  // EXIF orientation values 5, 6, 7, 8 require dimension swap after rotation\n  const needsDimensionSwap = metadata.orientation && metadata.orientation >= 5 && metadata.orientation <= 8;\n\n  // Update metadata with swapped dimensions if needed\n  if (needsDimensionSwap) {\n    const originalWidth = metadata.width;\n    metadata.width = metadata.height;\n    metadata.height = originalWidth;\n  }\n\n  return { image, metadata };\n}\n\n/**\n * Utility function to resize and save thumbnail using Sharp. The functions avoids upscaling the image and only reduces the size if necessary.\n * @param image - Sharp image instance\n * @param outputPath - Path where thumbnail should be saved\n * @param width - Target width for thumbnail\n * @param height - Target height for thumbnail\n */\nexport async function resizeImage(\n  image: Sharp,\n  outputPath: string,\n  width: number,\n  height: number,\n  format: keyof FormatEnum = 'avif',\n): Promise<void> {\n  // Resize the image without enlarging it\n  await image.resize(width, height, { withoutEnlargement: true }).toFormat(format).toFile(outputPath);\n}\n\n/**\n * Crops and resizes an image to a target aspect ratio, avoiding upscaling the image.\n * @param image - Sharp image instance\n * @param outputPath - Path where the image should be saved\n * @param width - Target width for the image\n * @param height - Target height for the image\n */\nexport async function cropAndResizeImage(\n  image: Sharp,\n  outputPath: string,\n  width: number,\n  height: number,\n  format: keyof FormatEnum = 'avif',\n): Promise<void> {\n  // Apply resize with cover fit and without enlargement\n  await image\n    .resize(width, height, {\n      fit: 'cover',\n      withoutEnlargement: true,\n    })\n    .toFormat(format)\n    .toFile(outputPath);\n}\n\n/**\n * Extracts description from image EXIF data\n * @param metadata - Sharp metadata object containing EXIF data\n * @returns Promise resolving to image description or undefined if not found\n */\nexport async function getImageDescription(imagePath: string): Promise<string | undefined> {\n  try {\n    const tags = await ExifReader.load(imagePath);\n\n    // Description\n    if (tags.description?.description) return tags.description.description;\n\n    // ImageDescription\n    if (tags.ImageDescription?.description) return tags.ImageDescription.description;\n\n    // UserComment\n    if (\n      tags.UserComment &&\n      typeof tags.UserComment === 'object' &&\n      tags.UserComment !== null &&\n      'description' in tags.UserComment\n    ) {\n      return (tags.UserComment as { description: string }).description;\n    }\n\n    // ExtDescrAccessibility\n    if (tags.ExtDescrAccessibility?.description) return tags.ExtDescrAccessibility.description;\n\n    // Caption/Abstract\n    if (tags['Caption/Abstract']?.description) return tags['Caption/Abstract'].description;\n\n    // XP Title\n    if (tags.XPTitle?.description) return tags.XPTitle.description;\n\n    // XP Comment\n    if (tags.XPComment?.description) return tags.XPComment.description;\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Creates regular and retina thumbnails for an image while maintaining aspect ratio\n * @param image - Sharp image instance\n * @param metadata - Image metadata containing dimensions\n * @param outputPath - Path where thumbnail should be saved\n * @param outputPathRetina - Path where retina thumbnail should be saved\n * @param size - Target size of the longer side of the thumbnail\n * @returns Promise resolving to thumbnail dimensions\n */\nexport async function createImageThumbnails(\n  image: Sharp,\n  metadata: Metadata,\n  outputPath: string,\n  outputPathRetina: string,\n  size: number,\n): Promise<Dimensions> {\n  // Get the original dimensions\n  const originalWidth = metadata.width || 0;\n  const originalHeight = metadata.height || 0;\n\n  if (originalWidth === 0 || originalHeight === 0) {\n    throw new Error('Invalid image dimensions');\n  }\n\n  // Calculate the new size maintaining aspect ratio\n  const aspectRatio = originalWidth / originalHeight;\n\n  let width: number;\n  let height: number;\n\n  if (originalWidth > originalHeight) {\n    width = size;\n    height = Math.round(size / aspectRatio);\n  } else {\n    width = Math.round(size * aspectRatio);\n    height = size;\n  }\n\n  // Resize the image and create the thumbnails\n  await resizeImage(image, outputPath, width, height);\n  await resizeImage(image, outputPathRetina, width * 2, height * 2);\n\n  // Return the dimensions of the thumbnail\n  return { width, height };\n}\n","import { encode } from 'blurhash';\n\nimport { loadImage } from './image';\n\n/**\n * Generates a BlurHash from an image file or Sharp instance\n * @param imagePath - Path to image file or Sharp instance\n * @param componentX - Number of x components (default: 4)\n * @param componentY - Number of y components (default: 3)\n * @returns Promise resolving to BlurHash string\n */\nexport async function generateBlurHash(imagePath: string, componentX: number = 4, componentY: number = 3): Promise<string> {\n  const image = await loadImage(imagePath);\n\n  // Resize to small size for BlurHash computation to improve performance\n  // BlurHash doesn't need high resolution\n  const { data, info } = await image\n    .resize(32, 32, { fit: 'inside' })\n    .ensureAlpha()\n    .raw()\n    .toBuffer({ resolveWithObject: true });\n\n  // Convert to Uint8ClampedArray format expected by blurhash\n  const pixels = new Uint8ClampedArray(data.buffer);\n\n  // Generate BlurHash\n  return encode(pixels, info.width, info.height, componentX, componentY);\n}\n","import { spawn } from 'node:child_process';\nimport { promises as fs } from 'node:fs';\n\nimport ffprobe from 'node-ffprobe';\nimport sharp from 'sharp';\n\nimport { resizeImage } from './image';\n\nimport type { Dimensions } from '../types';\nimport type { Buffer } from 'node:buffer';\n\n/**\n * Gets video dimensions using ffprobe\n * @param filePath - Path to the video file\n * @returns Promise resolving to video dimensions\n * @throws Error if no video stream found or invalid dimensions\n */\nexport async function getVideoDimensions(filePath: string): Promise<Dimensions> {\n  const data = await ffprobe(filePath);\n  const videoStream = data.streams.find((stream) => stream.codec_type === 'video');\n\n  if (!videoStream) {\n    throw new Error('No video stream found');\n  }\n\n  const dimensions = {\n    width: videoStream.width || 0,\n    height: videoStream.height || 0,\n  };\n\n  if (dimensions.width === 0 || dimensions.height === 0) {\n    throw new Error('Invalid video dimensions');\n  }\n\n  return dimensions;\n}\n\n/**\n * Creates regular and retina thumbnails for a video by extracting the first frame\n * @param inputPath - Path to the video file\n * @param videoDimensions - Original video dimensions\n * @param outputPath - Path where thumbnail should be saved\n * @param outputPathRetina - Path where retina thumbnail should be saved\n * @param height - Target height for thumbnail\n * @param verbose - Whether to enable verbose ffmpeg output\n * @returns Promise resolving to thumbnail dimensions\n */\nexport async function createVideoThumbnails(\n  inputPath: string,\n  videoDimensions: Dimensions,\n  outputPath: string,\n  outputPathRetina: string,\n  height: number,\n  verbose: boolean = false,\n): Promise<Dimensions> {\n  // Calculate width maintaining aspect ratio\n  const aspectRatio = videoDimensions.width / videoDimensions.height;\n  const width = Math.round(height * aspectRatio);\n\n  // Use ffmpeg to extract first frame as a temporary file, then process with sharp\n  const tempFramePath = `${outputPath}.temp.png`;\n\n  return new Promise((resolve, reject) => {\n    // Extract first frame using ffmpeg\n    const ffmpeg = spawn('ffmpeg', [\n      '-i',\n      inputPath,\n      '-vframes',\n      '1',\n      '-y',\n      '-loglevel',\n      verbose ? 'error' : 'quiet',\n      tempFramePath,\n    ]);\n\n    ffmpeg.stderr.on('data', (data: Buffer) => {\n      // FFmpeg writes normal output to stderr, so we don't treat this as an error\n      console.log(`ffmpeg: ${data.toString()}`);\n    });\n\n    ffmpeg.on('close', async (code: number) => {\n      if (code === 0) {\n        try {\n          // Process the extracted frame with sharp\n          const frameImage = sharp(tempFramePath);\n          await resizeImage(frameImage, outputPath, width, height);\n          await resizeImage(frameImage, outputPathRetina, width * 2, height * 2);\n\n          // Clean up temporary file\n          try {\n            await fs.unlink(tempFramePath);\n          } catch {\n            // Ignore cleanup errors\n          }\n\n          resolve({ width, height });\n        } catch (sharpError) {\n          reject(new Error(`Failed to process extracted frame: ${sharpError}`));\n        }\n      } else {\n        reject(new Error(`ffmpeg exited with code ${code}`));\n      }\n    });\n\n    ffmpeg.on('error', (error: Error) => {\n      reject(new Error(`Failed to start ffmpeg: ${error.message}`));\n    });\n  });\n}\n"]}

package/dist/lib/index.d.cts

@@ -0,0 +1,92 @@
+export { GalleryData, GalleryMetadata, GallerySection, MediaFile, MediaFileWithPath, SubGallery, Thumbnail } from '@simple-photo-gallery/common/src/gallery';
+import { Sharp, Metadata, FormatEnum } from 'sharp';
+
+/**
+ * Generates a BlurHash from an image file or Sharp instance
+ * @param imagePath - Path to image file or Sharp instance
+ * @param componentX - Number of x components (default: 4)
+ * @param componentY - Number of y components (default: 3)
+ * @returns Promise resolving to BlurHash string
+ */
+declare function generateBlurHash(imagePath: string, componentX?: number, componentY?: number): Promise<string>;
+
+/** Represents width and height dimensions */
+interface Dimensions {
+    /** Width in pixels */
+    width: number;
+    /** Height in pixels */
+    height: number;
+}
+/** Represents an image with metadata */
+interface ImageWithMetadata {
+    /** The image */
+    image: Sharp;
+    /** The metadata */
+    metadata: Metadata;
+}
+
+/**
+ * Loads an image and auto-rotates it based on EXIF orientation.
+ * @param imagePath - Path to the image file
+ * @returns Promise resolving to Sharp image instance
+ */
+declare function loadImage(imagePath: string): Promise<Sharp>;
+/**
+ * Loads an image and its metadata, auto-rotating it based on EXIF orientation and swapping dimensions if needed.
+ * @param imagePath - Path to the image file
+ * @returns Promise resolving to ImageWithMetadata object containing Sharp image instance and metadata
+ */
+declare function loadImageWithMetadata(imagePath: string): Promise<ImageWithMetadata>;
+/**
+ * Utility function to resize and save thumbnail using Sharp. The functions avoids upscaling the image and only reduces the size if necessary.
+ * @param image - Sharp image instance
+ * @param outputPath - Path where thumbnail should be saved
+ * @param width - Target width for thumbnail
+ * @param height - Target height for thumbnail
+ */
+declare function resizeImage(image: Sharp, outputPath: string, width: number, height: number, format?: keyof FormatEnum): Promise<void>;
+/**
+ * Crops and resizes an image to a target aspect ratio, avoiding upscaling the image.
+ * @param image - Sharp image instance
+ * @param outputPath - Path where the image should be saved
+ * @param width - Target width for the image
+ * @param height - Target height for the image
+ */
+declare function cropAndResizeImage(image: Sharp, outputPath: string, width: number, height: number, format?: keyof FormatEnum): Promise<void>;
+/**
+ * Extracts description from image EXIF data
+ * @param metadata - Sharp metadata object containing EXIF data
+ * @returns Promise resolving to image description or undefined if not found
+ */
+declare function getImageDescription(imagePath: string): Promise<string | undefined>;
+/**
+ * Creates regular and retina thumbnails for an image while maintaining aspect ratio
+ * @param image - Sharp image instance
+ * @param metadata - Image metadata containing dimensions
+ * @param outputPath - Path where thumbnail should be saved
+ * @param outputPathRetina - Path where retina thumbnail should be saved
+ * @param size - Target size of the longer side of the thumbnail
+ * @returns Promise resolving to thumbnail dimensions
+ */
+declare function createImageThumbnails(image: Sharp, metadata: Metadata, outputPath: string, outputPathRetina: string, size: number): Promise<Dimensions>;
+
+/**
+ * Gets video dimensions using ffprobe
+ * @param filePath - Path to the video file
+ * @returns Promise resolving to video dimensions
+ * @throws Error if no video stream found or invalid dimensions
+ */
+declare function getVideoDimensions(filePath: string): Promise<Dimensions>;
+/**
+ * Creates regular and retina thumbnails for a video by extracting the first frame
+ * @param inputPath - Path to the video file
+ * @param videoDimensions - Original video dimensions
+ * @param outputPath - Path where thumbnail should be saved
+ * @param outputPathRetina - Path where retina thumbnail should be saved
+ * @param height - Target height for thumbnail
+ * @param verbose - Whether to enable verbose ffmpeg output
+ * @returns Promise resolving to thumbnail dimensions
+ */
+declare function createVideoThumbnails(inputPath: string, videoDimensions: Dimensions, outputPath: string, outputPathRetina: string, height: number, verbose?: boolean): Promise<Dimensions>;
+
+export { type Dimensions, type ImageWithMetadata, createImageThumbnails, createVideoThumbnails, cropAndResizeImage, generateBlurHash, getImageDescription, getVideoDimensions, loadImage, loadImageWithMetadata, resizeImage };

package/dist/lib/index.d.ts

@@ -0,0 +1,92 @@
+export { GalleryData, GalleryMetadata, GallerySection, MediaFile, MediaFileWithPath, SubGallery, Thumbnail } from '@simple-photo-gallery/common/src/gallery';
+import { Sharp, Metadata, FormatEnum } from 'sharp';
+
+/**
+ * Generates a BlurHash from an image file or Sharp instance
+ * @param imagePath - Path to image file or Sharp instance
+ * @param componentX - Number of x components (default: 4)
+ * @param componentY - Number of y components (default: 3)
+ * @returns Promise resolving to BlurHash string
+ */
+declare function generateBlurHash(imagePath: string, componentX?: number, componentY?: number): Promise<string>;
+
+/** Represents width and height dimensions */
+interface Dimensions {
+    /** Width in pixels */
+    width: number;
+    /** Height in pixels */
+    height: number;
+}
+/** Represents an image with metadata */
+interface ImageWithMetadata {
+    /** The image */
+    image: Sharp;
+    /** The metadata */
+    metadata: Metadata;
+}
+
+/**
+ * Loads an image and auto-rotates it based on EXIF orientation.
+ * @param imagePath - Path to the image file
+ * @returns Promise resolving to Sharp image instance
+ */
+declare function loadImage(imagePath: string): Promise<Sharp>;
+/**
+ * Loads an image and its metadata, auto-rotating it based on EXIF orientation and swapping dimensions if needed.
+ * @param imagePath - Path to the image file
+ * @returns Promise resolving to ImageWithMetadata object containing Sharp image instance and metadata
+ */
+declare function loadImageWithMetadata(imagePath: string): Promise<ImageWithMetadata>;
+/**
+ * Utility function to resize and save thumbnail using Sharp. The functions avoids upscaling the image and only reduces the size if necessary.
+ * @param image - Sharp image instance
+ * @param outputPath - Path where thumbnail should be saved
+ * @param width - Target width for thumbnail
+ * @param height - Target height for thumbnail
+ */
+declare function resizeImage(image: Sharp, outputPath: string, width: number, height: number, format?: keyof FormatEnum): Promise<void>;
+/**
+ * Crops and resizes an image to a target aspect ratio, avoiding upscaling the image.
+ * @param image - Sharp image instance
+ * @param outputPath - Path where the image should be saved
+ * @param width - Target width for the image
+ * @param height - Target height for the image
+ */
+declare function cropAndResizeImage(image: Sharp, outputPath: string, width: number, height: number, format?: keyof FormatEnum): Promise<void>;
+/**
+ * Extracts description from image EXIF data
+ * @param metadata - Sharp metadata object containing EXIF data
+ * @returns Promise resolving to image description or undefined if not found
+ */
+declare function getImageDescription(imagePath: string): Promise<string | undefined>;
+/**
+ * Creates regular and retina thumbnails for an image while maintaining aspect ratio
+ * @param image - Sharp image instance
+ * @param metadata - Image metadata containing dimensions
+ * @param outputPath - Path where thumbnail should be saved
+ * @param outputPathRetina - Path where retina thumbnail should be saved
+ * @param size - Target size of the longer side of the thumbnail
+ * @returns Promise resolving to thumbnail dimensions
+ */
+declare function createImageThumbnails(image: Sharp, metadata: Metadata, outputPath: string, outputPathRetina: string, size: number): Promise<Dimensions>;
+
+/**
+ * Gets video dimensions using ffprobe
+ * @param filePath - Path to the video file
+ * @returns Promise resolving to video dimensions
+ * @throws Error if no video stream found or invalid dimensions
+ */
+declare function getVideoDimensions(filePath: string): Promise<Dimensions>;
+/**
+ * Creates regular and retina thumbnails for a video by extracting the first frame
+ * @param inputPath - Path to the video file
+ * @param videoDimensions - Original video dimensions
+ * @param outputPath - Path where thumbnail should be saved
+ * @param outputPathRetina - Path where retina thumbnail should be saved
+ * @param height - Target height for thumbnail
+ * @param verbose - Whether to enable verbose ffmpeg output
+ * @returns Promise resolving to thumbnail dimensions
+ */
+declare function createVideoThumbnails(inputPath: string, videoDimensions: Dimensions, outputPath: string, outputPathRetina: string, height: number, verbose?: boolean): Promise<Dimensions>;
+
+export { type Dimensions, type ImageWithMetadata, createImageThumbnails, createVideoThumbnails, cropAndResizeImage, generateBlurHash, getImageDescription, getVideoDimensions, loadImage, loadImageWithMetadata, resizeImage };

package/dist/lib/index.js

@@ -0,0 +1,136 @@
+import { encode } from 'blurhash';
+import ExifReader from 'exifreader';
+import sharp from 'sharp';
+import { spawn } from 'child_process';
+import { promises } from 'fs';
+import ffprobe from 'node-ffprobe';
+
+// src/utils/blurhash.ts
+async function loadImage(imagePath) {
+  return sharp(imagePath).rotate();
+}
+async function loadImageWithMetadata(imagePath) {
+  const image = sharp(imagePath);
+  const metadata = await image.metadata();
+  image.rotate();
+  const needsDimensionSwap = metadata.orientation && metadata.orientation >= 5 && metadata.orientation <= 8;
+  if (needsDimensionSwap) {
+    const originalWidth = metadata.width;
+    metadata.width = metadata.height;
+    metadata.height = originalWidth;
+  }
+  return { image, metadata };
+}
+async function resizeImage(image, outputPath, width, height, format = "avif") {
+  await image.resize(width, height, { withoutEnlargement: true }).toFormat(format).toFile(outputPath);
+}
+async function cropAndResizeImage(image, outputPath, width, height, format = "avif") {
+  await image.resize(width, height, {
+    fit: "cover",
+    withoutEnlargement: true
+  }).toFormat(format).toFile(outputPath);
+}
+async function getImageDescription(imagePath) {
+  try {
+    const tags = await ExifReader.load(imagePath);
+    if (tags.description?.description) return tags.description.description;
+    if (tags.ImageDescription?.description) return tags.ImageDescription.description;
+    if (tags.UserComment && typeof tags.UserComment === "object" && tags.UserComment !== null && "description" in tags.UserComment) {
+      return tags.UserComment.description;
+    }
+    if (tags.ExtDescrAccessibility?.description) return tags.ExtDescrAccessibility.description;
+    if (tags["Caption/Abstract"]?.description) return tags["Caption/Abstract"].description;
+    if (tags.XPTitle?.description) return tags.XPTitle.description;
+    if (tags.XPComment?.description) return tags.XPComment.description;
+  } catch {
+    return void 0;
+  }
+}
+async function createImageThumbnails(image, metadata, outputPath, outputPathRetina, size) {
+  const originalWidth = metadata.width || 0;
+  const originalHeight = metadata.height || 0;
+  if (originalWidth === 0 || originalHeight === 0) {
+    throw new Error("Invalid image dimensions");
+  }
+  const aspectRatio = originalWidth / originalHeight;
+  let width;
+  let height;
+  if (originalWidth > originalHeight) {
+    width = size;
+    height = Math.round(size / aspectRatio);
+  } else {
+    width = Math.round(size * aspectRatio);
+    height = size;
+  }
+  await resizeImage(image, outputPath, width, height);
+  await resizeImage(image, outputPathRetina, width * 2, height * 2);
+  return { width, height };
+}
+
+// src/utils/blurhash.ts
+async function generateBlurHash(imagePath, componentX = 4, componentY = 3) {
+  const image = await loadImage(imagePath);
+  const { data, info } = await image.resize(32, 32, { fit: "inside" }).ensureAlpha().raw().toBuffer({ resolveWithObject: true });
+  const pixels = new Uint8ClampedArray(data.buffer);
+  return encode(pixels, info.width, info.height, componentX, componentY);
+}
+async function getVideoDimensions(filePath) {
+  const data = await ffprobe(filePath);
+  const videoStream = data.streams.find((stream) => stream.codec_type === "video");
+  if (!videoStream) {
+    throw new Error("No video stream found");
+  }
+  const dimensions = {
+    width: videoStream.width || 0,
+    height: videoStream.height || 0
+  };
+  if (dimensions.width === 0 || dimensions.height === 0) {
+    throw new Error("Invalid video dimensions");
+  }
+  return dimensions;
+}
+async function createVideoThumbnails(inputPath, videoDimensions, outputPath, outputPathRetina, height, verbose = false) {
+  const aspectRatio = videoDimensions.width / videoDimensions.height;
+  const width = Math.round(height * aspectRatio);
+  const tempFramePath = `${outputPath}.temp.png`;
+  return new Promise((resolve, reject) => {
+    const ffmpeg = spawn("ffmpeg", [
+      "-i",
+      inputPath,
+      "-vframes",
+      "1",
+      "-y",
+      "-loglevel",
+      verbose ? "error" : "quiet",
+      tempFramePath
+    ]);
+    ffmpeg.stderr.on("data", (data) => {
+      console.log(`ffmpeg: ${data.toString()}`);
+    });
+    ffmpeg.on("close", async (code) => {
+      if (code === 0) {
+        try {
+          const frameImage = sharp(tempFramePath);
+          await resizeImage(frameImage, outputPath, width, height);
+          await resizeImage(frameImage, outputPathRetina, width * 2, height * 2);
+          try {
+            await promises.unlink(tempFramePath);
+          } catch {
+          }
+          resolve({ width, height });
+        } catch (sharpError) {
+          reject(new Error(`Failed to process extracted frame: ${sharpError}`));
+        }
+      } else {
+        reject(new Error(`ffmpeg exited with code ${code}`));
+      }
+    });
+    ffmpeg.on("error", (error) => {
+      reject(new Error(`Failed to start ffmpeg: ${error.message}`));
+    });
+  });
+}
+
+export { createImageThumbnails, createVideoThumbnails, cropAndResizeImage, generateBlurHash, getImageDescription, getVideoDimensions, loadImage, loadImageWithMetadata, resizeImage };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/image.ts","../../src/utils/blurhash.ts","../../src/utils/video.ts"],"names":["sharp","fs"],"mappings":"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","file":"index.js","sourcesContent":["import ExifReader from 'exifreader';\nimport sharp from 'sharp';\n\nimport type { Dimensions, ImageWithMetadata } from '../types';\nimport type { FormatEnum, Metadata, Sharp } from 'sharp';\n\n/**\n * Loads an image and auto-rotates it based on EXIF orientation.\n * @param imagePath - Path to the image file\n * @returns Promise resolving to Sharp image instance\n */\nexport async function loadImage(imagePath: string): Promise<Sharp> {\n  return sharp(imagePath).rotate();\n}\n\n/**\n * Loads an image and its metadata, auto-rotating it based on EXIF orientation and swapping dimensions if needed.\n * @param imagePath - Path to the image file\n * @returns Promise resolving to ImageWithMetadata object containing Sharp image instance and metadata\n */\nexport async function loadImageWithMetadata(imagePath: string): Promise<ImageWithMetadata> {\n  const image = sharp(imagePath);\n  const metadata = await image.metadata();\n\n  // Auto-rotate based on EXIF orientation\n  image.rotate();\n\n  // EXIF orientation values 5, 6, 7, 8 require dimension swap after rotation\n  const needsDimensionSwap = metadata.orientation && metadata.orientation >= 5 && metadata.orientation <= 8;\n\n  // Update metadata with swapped dimensions if needed\n  if (needsDimensionSwap) {\n    const originalWidth = metadata.width;\n    metadata.width = metadata.height;\n    metadata.height = originalWidth;\n  }\n\n  return { image, metadata };\n}\n\n/**\n * Utility function to resize and save thumbnail using Sharp. The functions avoids upscaling the image and only reduces the size if necessary.\n * @param image - Sharp image instance\n * @param outputPath - Path where thumbnail should be saved\n * @param width - Target width for thumbnail\n * @param height - Target height for thumbnail\n */\nexport async function resizeImage(\n  image: Sharp,\n  outputPath: string,\n  width: number,\n  height: number,\n  format: keyof FormatEnum = 'avif',\n): Promise<void> {\n  // Resize the image without enlarging it\n  await image.resize(width, height, { withoutEnlargement: true }).toFormat(format).toFile(outputPath);\n}\n\n/**\n * Crops and resizes an image to a target aspect ratio, avoiding upscaling the image.\n * @param image - Sharp image instance\n * @param outputPath - Path where the image should be saved\n * @param width - Target width for the image\n * @param height - Target height for the image\n */\nexport async function cropAndResizeImage(\n  image: Sharp,\n  outputPath: string,\n  width: number,\n  height: number,\n  format: keyof FormatEnum = 'avif',\n): Promise<void> {\n  // Apply resize with cover fit and without enlargement\n  await image\n    .resize(width, height, {\n      fit: 'cover',\n      withoutEnlargement: true,\n    })\n    .toFormat(format)\n    .toFile(outputPath);\n}\n\n/**\n * Extracts description from image EXIF data\n * @param metadata - Sharp metadata object containing EXIF data\n * @returns Promise resolving to image description or undefined if not found\n */\nexport async function getImageDescription(imagePath: string): Promise<string | undefined> {\n  try {\n    const tags = await ExifReader.load(imagePath);\n\n    // Description\n    if (tags.description?.description) return tags.description.description;\n\n    // ImageDescription\n    if (tags.ImageDescription?.description) return tags.ImageDescription.description;\n\n    // UserComment\n    if (\n      tags.UserComment &&\n      typeof tags.UserComment === 'object' &&\n      tags.UserComment !== null &&\n      'description' in tags.UserComment\n    ) {\n      return (tags.UserComment as { description: string }).description;\n    }\n\n    // ExtDescrAccessibility\n    if (tags.ExtDescrAccessibility?.description) return tags.ExtDescrAccessibility.description;\n\n    // Caption/Abstract\n    if (tags['Caption/Abstract']?.description) return tags['Caption/Abstract'].description;\n\n    // XP Title\n    if (tags.XPTitle?.description) return tags.XPTitle.description;\n\n    // XP Comment\n    if (tags.XPComment?.description) return tags.XPComment.description;\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Creates regular and retina thumbnails for an image while maintaining aspect ratio\n * @param image - Sharp image instance\n * @param metadata - Image metadata containing dimensions\n * @param outputPath - Path where thumbnail should be saved\n * @param outputPathRetina - Path where retina thumbnail should be saved\n * @param size - Target size of the longer side of the thumbnail\n * @returns Promise resolving to thumbnail dimensions\n */\nexport async function createImageThumbnails(\n  image: Sharp,\n  metadata: Metadata,\n  outputPath: string,\n  outputPathRetina: string,\n  size: number,\n): Promise<Dimensions> {\n  // Get the original dimensions\n  const originalWidth = metadata.width || 0;\n  const originalHeight = metadata.height || 0;\n\n  if (originalWidth === 0 || originalHeight === 0) {\n    throw new Error('Invalid image dimensions');\n  }\n\n  // Calculate the new size maintaining aspect ratio\n  const aspectRatio = originalWidth / originalHeight;\n\n  let width: number;\n  let height: number;\n\n  if (originalWidth > originalHeight) {\n    width = size;\n    height = Math.round(size / aspectRatio);\n  } else {\n    width = Math.round(size * aspectRatio);\n    height = size;\n  }\n\n  // Resize the image and create the thumbnails\n  await resizeImage(image, outputPath, width, height);\n  await resizeImage(image, outputPathRetina, width * 2, height * 2);\n\n  // Return the dimensions of the thumbnail\n  return { width, height };\n}\n","import { encode } from 'blurhash';\n\nimport { loadImage } from './image';\n\n/**\n * Generates a BlurHash from an image file or Sharp instance\n * @param imagePath - Path to image file or Sharp instance\n * @param componentX - Number of x components (default: 4)\n * @param componentY - Number of y components (default: 3)\n * @returns Promise resolving to BlurHash string\n */\nexport async function generateBlurHash(imagePath: string, componentX: number = 4, componentY: number = 3): Promise<string> {\n  const image = await loadImage(imagePath);\n\n  // Resize to small size for BlurHash computation to improve performance\n  // BlurHash doesn't need high resolution\n  const { data, info } = await image\n    .resize(32, 32, { fit: 'inside' })\n    .ensureAlpha()\n    .raw()\n    .toBuffer({ resolveWithObject: true });\n\n  // Convert to Uint8ClampedArray format expected by blurhash\n  const pixels = new Uint8ClampedArray(data.buffer);\n\n  // Generate BlurHash\n  return encode(pixels, info.width, info.height, componentX, componentY);\n}\n","import { spawn } from 'node:child_process';\nimport { promises as fs } from 'node:fs';\n\nimport ffprobe from 'node-ffprobe';\nimport sharp from 'sharp';\n\nimport { resizeImage } from './image';\n\nimport type { Dimensions } from '../types';\nimport type { Buffer } from 'node:buffer';\n\n/**\n * Gets video dimensions using ffprobe\n * @param filePath - Path to the video file\n * @returns Promise resolving to video dimensions\n * @throws Error if no video stream found or invalid dimensions\n */\nexport async function getVideoDimensions(filePath: string): Promise<Dimensions> {\n  const data = await ffprobe(filePath);\n  const videoStream = data.streams.find((stream) => stream.codec_type === 'video');\n\n  if (!videoStream) {\n    throw new Error('No video stream found');\n  }\n\n  const dimensions = {\n    width: videoStream.width || 0,\n    height: videoStream.height || 0,\n  };\n\n  if (dimensions.width === 0 || dimensions.height === 0) {\n    throw new Error('Invalid video dimensions');\n  }\n\n  return dimensions;\n}\n\n/**\n * Creates regular and retina thumbnails for a video by extracting the first frame\n * @param inputPath - Path to the video file\n * @param videoDimensions - Original video dimensions\n * @param outputPath - Path where thumbnail should be saved\n * @param outputPathRetina - Path where retina thumbnail should be saved\n * @param height - Target height for thumbnail\n * @param verbose - Whether to enable verbose ffmpeg output\n * @returns Promise resolving to thumbnail dimensions\n */\nexport async function createVideoThumbnails(\n  inputPath: string,\n  videoDimensions: Dimensions,\n  outputPath: string,\n  outputPathRetina: string,\n  height: number,\n  verbose: boolean = false,\n): Promise<Dimensions> {\n  // Calculate width maintaining aspect ratio\n  const aspectRatio = videoDimensions.width / videoDimensions.height;\n  const width = Math.round(height * aspectRatio);\n\n  // Use ffmpeg to extract first frame as a temporary file, then process with sharp\n  const tempFramePath = `${outputPath}.temp.png`;\n\n  return new Promise((resolve, reject) => {\n    // Extract first frame using ffmpeg\n    const ffmpeg = spawn('ffmpeg', [\n      '-i',\n      inputPath,\n      '-vframes',\n      '1',\n      '-y',\n      '-loglevel',\n      verbose ? 'error' : 'quiet',\n      tempFramePath,\n    ]);\n\n    ffmpeg.stderr.on('data', (data: Buffer) => {\n      // FFmpeg writes normal output to stderr, so we don't treat this as an error\n      console.log(`ffmpeg: ${data.toString()}`);\n    });\n\n    ffmpeg.on('close', async (code: number) => {\n      if (code === 0) {\n        try {\n          // Process the extracted frame with sharp\n          const frameImage = sharp(tempFramePath);\n          await resizeImage(frameImage, outputPath, width, height);\n          await resizeImage(frameImage, outputPathRetina, width * 2, height * 2);\n\n          // Clean up temporary file\n          try {\n            await fs.unlink(tempFramePath);\n          } catch {\n            // Ignore cleanup errors\n          }\n\n          resolve({ width, height });\n        } catch (sharpError) {\n          reject(new Error(`Failed to process extracted frame: ${sharpError}`));\n        }\n      } else {\n        reject(new Error(`ffmpeg exited with code ${code}`));\n      }\n    });\n\n    ffmpeg.on('error', (error: Error) => {\n      reject(new Error(`Failed to start ffmpeg: ${error.message}`));\n    });\n  });\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "simple-photo-gallery",
-  "version": "2.0.11-rc.1",
+  "version": "2.0.11-rc.3",
   "description": "Simple Photo Gallery CLI",
   "license": "MIT",
   "author": "Vladimir Haltakov, Tomasz Rusin",
@@ -16,6 +16,18 @@
     "simple-photo-gallery": "./dist/index.js",
     "spg": "./dist/index.js"
   },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./lib": {
+      "types": "./dist/lib/index.d.ts",
+      "default": "./dist/lib/index.js"
+    }
+  },
   "scripts": {
     "gallery": "SPG_TELEMETRY_PROVIDER=none tsx src/index.ts",
     "clean": "rm -rf dist",
@@ -28,10 +40,11 @@
     "format:fix": "prettier --write .",
     "test": "jest",
     "test:coverage": "jest --coverage",
-    "prepublish": "npm run build"
+    "prepublish": "yarn build"
   },
   "dependencies": {
-    "@simple-photo-gallery/theme-modern": "2.0.11-rc.1",
+    "@simple-photo-gallery/common": "1.0.1",
+    "@simple-photo-gallery/theme-modern": "2.0.11-rc.3",
     "axios": "^1.12.2",
     "blurhash": "^2.0.5",
     "commander": "^12.0.0",
@@ -46,7 +59,6 @@
   "devDependencies": {
     "@eslint/eslintrc": "^3.3.1",
     "@eslint/js": "^9.30.1",
-    "@simple-photo-gallery/common": "1.0.0",
     "@types/fs-extra": "^11.0.4",
     "@types/jest": "^30.0.0",
     "@types/node": "^24.0.10",