@nghiavuive/random-image 1.0.2 → 1.2.0

package/dist/index.mjs

@@ -117,6 +117,10 @@ var PixabayProvider = class {
 };
 
 // src/image-fetcher.ts
+import * as fs from "fs";
+import * as path from "path";
+import axios4 from "axios";
+import { v7 as uuidv4 } from "uuid";
 var RandomImage = class {
   constructor(provider) {
     this.provider = provider;
@@ -129,6 +133,86 @@ var RandomImage = class {
   async getRandom(options = {}) {
     return this.provider.fetchRandomImage(options);
   }
+  /**
+   * Downloads an image to a specified directory.
+   * @param imageUrl - The URL of the image to download (can be a string or ImageResult object)
+   * @param destinationPath - The directory path where the image will be saved
+   * @param options - Download options (filename, overwrite, etc.)
+   * @returns A promise that resolves to the full path of the downloaded file
+   */
+  async download(imageUrl, destinationPath, options = {}) {
+    const url = typeof imageUrl === "string" ? imageUrl : imageUrl.url;
+    if (!fs.existsSync(destinationPath)) {
+      fs.mkdirSync(destinationPath, { recursive: true });
+    }
+    let finalFilename;
+    if (options.filename) {
+      finalFilename = options.filename;
+    } else if (options.keepOriginalName) {
+      const urlPath = new URL(url).pathname;
+      const urlFilename = path.basename(urlPath);
+      if (urlFilename && urlFilename.length > 0 && urlFilename !== "/") {
+        finalFilename = urlFilename;
+      } else {
+        const ext = this.getExtensionFromUrl(url) || ".jpg";
+        finalFilename = `${uuidv4()}${ext}`;
+      }
+    } else {
+      const ext = this.getExtensionFromUrl(url) || ".jpg";
+      finalFilename = `${uuidv4()}${ext}`;
+    }
+    if (!path.extname(finalFilename)) {
+      finalFilename += ".jpg";
+    }
+    const fullPath = path.join(destinationPath, finalFilename);
+    if (fs.existsSync(fullPath) && !options.overwrite) {
+      throw new Error(`File already exists: ${fullPath}. Set overwrite: true to replace it.`);
+    }
+    try {
+      const response = await axios4.get(url, {
+        responseType: "stream",
+        maxRedirects: 5
+        // Automatically handle redirects
+      });
+      const writer = fs.createWriteStream(fullPath);
+      response.data.pipe(writer);
+      return new Promise((resolve, reject) => {
+        writer.on("finish", () => {
+          resolve(fullPath);
+        });
+        writer.on("error", (err) => {
+          fs.unlink(fullPath, () => {
+          });
+          reject(err);
+        });
+        response.data.on("error", (err) => {
+          writer.close();
+          fs.unlink(fullPath, () => {
+          });
+          reject(err);
+        });
+      });
+    } catch (error) {
+      if (axios4.isAxiosError(error)) {
+        throw new Error(`Failed to download image: ${error.message}`);
+      }
+      throw error;
+    }
+  }
+  /**
+   * Helper method to extract file extension from URL
+   * @param url - The URL to extract extension from
+   * @returns The file extension (e.g., '.jpg', '.png') or null
+   */
+  getExtensionFromUrl(url) {
+    try {
+      const urlPath = new URL(url).pathname;
+      const ext = path.extname(urlPath);
+      return ext || null;
+    } catch {
+      return null;
+    }
+  }
 };
 export {
   PexelsProvider,

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/providers/unsplash.ts","../src/providers/pexels.ts","../src/providers/pixabay.ts","../src/image-fetcher.ts"],"sourcesContent":["import axios from \"axios\";\nimport { ImageProvider, ImageOptions, ImageResult } from \"../types\";\n\nexport class UnsplashProvider implements ImageProvider {\n  private accessKey: string;\n\n  constructor(accessKey: string) {\n    this.accessKey = accessKey;\n  }\n\n  async fetchRandomImage(options: ImageOptions): Promise<ImageResult> {\n    const response = await axios.get(\"https://api.unsplash.com/photos/random\", {\n      headers: {\n        Authorization: `Client-ID ${this.accessKey}`,\n      },\n      params: {\n        query: options.query,\n        orientation: options.orientation,\n      },\n    });\n\n    const data = response.data;\n\n    // Handle single random photo (array if count param used, but here generic assumes one)\n    const photo = Array.isArray(data) ? data[0] : data;\n\n    // Construct resized URL\n    // Unsplash uses Imgix. We can append parameters.\n    const baseUrl = photo.urls.raw;\n    const sizeParams = new URLSearchParams();\n    if (options.height || options.width) {\n      sizeParams.append(\"fit\", \"crop\");\n      sizeParams.append(\"crop\", \"entropy\");\n    }\n    if (options.width) sizeParams.append(\"w\", options.width.toString());\n    if (options.height) sizeParams.append(\"h\", options.height.toString());\n    if (options.quality) sizeParams.append(\"q\", options.quality.toString());\n\n    const finalUrl = `${baseUrl}&${sizeParams.toString()}`;\n\n    return {\n      url: finalUrl,\n      width: options.width || photo.width,\n      height: options.height || photo.height,\n      author: photo.user.name,\n      authorUrl: photo.user.links.html,\n      originalUrl: photo.links.html, // Link to photo page\n    };\n  }\n}\n","import axios from \"axios\";\nimport { ImageProvider, ImageOptions, ImageResult } from \"../types\";\n\nexport class PexelsProvider implements ImageProvider {\n  private apiKey: string;\n\n  constructor(apiKey: string) {\n    this.apiKey = apiKey;\n  }\n\n  async fetchRandomImage(options: ImageOptions): Promise<ImageResult> {\n    const endpoint = options.query\n      ? \"https://api.pexels.com/v1/search\"\n      : \"https://api.pexels.com/v1/curated\";\n\n    // Randomizing page number (1-100) to get a \"random\" image\n    const randomPage = Math.floor(Math.random() * 100) + 1;\n\n    const params: any = {\n      per_page: 1,\n      page: randomPage,\n    };\n    if (options.query) params.query = options.query;\n\n    const response = await axios.get(endpoint, {\n      headers: {\n        Authorization: this.apiKey,\n      },\n      params: params,\n    });\n\n    const data = response.data;\n\n    if (!data.photos || data.photos.length === 0) {\n      throw new Error(\"No images found on Pexels\");\n    }\n\n    const photo = data.photos[0];\n\n    const baseUrl = photo.src.original;\n    const sizeParams = new URLSearchParams();\n    sizeParams.append(\"auto\", \"compress\");\n    sizeParams.append(\"cs\", \"tinysrgb\"); // Default pexels param\n    if (options.width) sizeParams.append(\"w\", options.width.toString());\n    if (options.height) sizeParams.append(\"h\", options.height.toString());\n\n    const finalUrl = `${baseUrl}?${sizeParams.toString()}`;\n\n    return {\n      url: finalUrl,\n      width: options.width || photo.width,\n      height: options.height || photo.height,\n      author: photo.photographer,\n      authorUrl: photo.photographer_url,\n      originalUrl: photo.url,\n    };\n  }\n}\n","import axios from \"axios\";\nimport { ImageProvider, ImageOptions, ImageResult } from \"../types\";\n\nexport class PixabayProvider implements ImageProvider {\n  private apiKey: string;\n\n  constructor(apiKey: string) {\n    this.apiKey = apiKey;\n  }\n\n  async fetchRandomImage(options: ImageOptions): Promise<ImageResult> {\n    const params: any = {\n      key: this.apiKey,\n      q: options.query || \"\",\n      per_page: 20, // Fetch a few to pick randomly\n    };\n\n    if (options.orientation) {\n      params.orientation =\n        options.orientation === \"portrait\" ? \"vertical\" : \"horizontal\";\n    }\n\n    const response = await axios.get(\"https://pixabay.com/api/\", {\n      params,\n    });\n\n    const hits = response.data.hits;\n\n    if (!hits || hits.length === 0) {\n      throw new Error(\"No images found\");\n    }\n\n    // Pick a random hit\n    const randomHit = hits[Math.floor(Math.random() * hits.length)];\n\n    return {\n      url: randomHit.largeImageURL || randomHit.webformatURL,\n      width: randomHit.imageWidth || randomHit.webformatWidth,\n      height: randomHit.imageHeight || randomHit.webformatHeight,\n      author: randomHit.user,\n      authorUrl: `https://pixabay.com/users/${randomHit.user}-${randomHit.user_id}/`,\n      originalUrl: randomHit.pageURL,\n    };\n  }\n}\n","import { ImageProvider, ImageOptions, ImageResult } from './types';\n\nexport class RandomImage {\n  private provider: ImageProvider;\n\n  constructor(provider: ImageProvider) {\n    this.provider = provider;\n  }\n\n  /**\n   * Fetches a random image based on the provided options.\n   * @param options - Configuration options for the image (width, height, query, etc.)\n   * @returns A promise that resolves to an ImageResult object.\n   */\n  async getRandom(options: ImageOptions = {}): Promise<ImageResult> {\n    return this.provider.fetchRandomImage(options);\n  }\n}\n"],"mappings":"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","names":["axios","axios"]}
+{"version":3,"sources":["../src/providers/unsplash.ts","../src/providers/pexels.ts","../src/providers/pixabay.ts","../src/image-fetcher.ts"],"sourcesContent":["import axios from \"axios\";\nimport { ImageProvider, ImageOptions, ImageResult } from \"../types\";\n\nexport class UnsplashProvider implements ImageProvider {\n  private accessKey: string;\n\n  constructor(accessKey: string) {\n    this.accessKey = accessKey;\n  }\n\n  async fetchRandomImage(options: ImageOptions): Promise<ImageResult> {\n    const response = await axios.get(\"https://api.unsplash.com/photos/random\", {\n      headers: {\n        Authorization: `Client-ID ${this.accessKey}`,\n      },\n      params: {\n        query: options.query,\n        orientation: options.orientation,\n      },\n    });\n\n    const data = response.data;\n\n    // Handle single random photo (array if count param used, but here generic assumes one)\n    const photo = Array.isArray(data) ? data[0] : data;\n\n    // Construct resized URL\n    // Unsplash uses Imgix. We can append parameters.\n    const baseUrl = photo.urls.raw;\n    const sizeParams = new URLSearchParams();\n    if (options.height || options.width) {\n      sizeParams.append(\"fit\", \"crop\");\n      sizeParams.append(\"crop\", \"entropy\");\n    }\n    if (options.width) sizeParams.append(\"w\", options.width.toString());\n    if (options.height) sizeParams.append(\"h\", options.height.toString());\n    if (options.quality) sizeParams.append(\"q\", options.quality.toString());\n\n    const finalUrl = `${baseUrl}&${sizeParams.toString()}`;\n\n    return {\n      url: finalUrl,\n      width: options.width || photo.width,\n      height: options.height || photo.height,\n      author: photo.user.name,\n      authorUrl: photo.user.links.html,\n      originalUrl: photo.links.html, // Link to photo page\n    };\n  }\n}\n","import axios from \"axios\";\nimport { ImageProvider, ImageOptions, ImageResult } from \"../types\";\n\nexport class PexelsProvider implements ImageProvider {\n  private apiKey: string;\n\n  constructor(apiKey: string) {\n    this.apiKey = apiKey;\n  }\n\n  async fetchRandomImage(options: ImageOptions): Promise<ImageResult> {\n    const endpoint = options.query\n      ? \"https://api.pexels.com/v1/search\"\n      : \"https://api.pexels.com/v1/curated\";\n\n    // Randomizing page number (1-100) to get a \"random\" image\n    const randomPage = Math.floor(Math.random() * 100) + 1;\n\n    const params: any = {\n      per_page: 1,\n      page: randomPage,\n    };\n    if (options.query) params.query = options.query;\n\n    const response = await axios.get(endpoint, {\n      headers: {\n        Authorization: this.apiKey,\n      },\n      params: params,\n    });\n\n    const data = response.data;\n\n    if (!data.photos || data.photos.length === 0) {\n      throw new Error(\"No images found on Pexels\");\n    }\n\n    const photo = data.photos[0];\n\n    const baseUrl = photo.src.original;\n    const sizeParams = new URLSearchParams();\n    sizeParams.append(\"auto\", \"compress\");\n    sizeParams.append(\"cs\", \"tinysrgb\"); // Default pexels param\n    if (options.width) sizeParams.append(\"w\", options.width.toString());\n    if (options.height) sizeParams.append(\"h\", options.height.toString());\n\n    const finalUrl = `${baseUrl}?${sizeParams.toString()}`;\n\n    return {\n      url: finalUrl,\n      width: options.width || photo.width,\n      height: options.height || photo.height,\n      author: photo.photographer,\n      authorUrl: photo.photographer_url,\n      originalUrl: photo.url,\n    };\n  }\n}\n","import axios from \"axios\";\nimport { ImageProvider, ImageOptions, ImageResult } from \"../types\";\n\nexport class PixabayProvider implements ImageProvider {\n  private apiKey: string;\n\n  constructor(apiKey: string) {\n    this.apiKey = apiKey;\n  }\n\n  async fetchRandomImage(options: ImageOptions): Promise<ImageResult> {\n    const params: any = {\n      key: this.apiKey,\n      q: options.query || \"\",\n      per_page: 20, // Fetch a few to pick randomly\n    };\n\n    if (options.orientation) {\n      params.orientation =\n        options.orientation === \"portrait\" ? \"vertical\" : \"horizontal\";\n    }\n\n    const response = await axios.get(\"https://pixabay.com/api/\", {\n      params,\n    });\n\n    const hits = response.data.hits;\n\n    if (!hits || hits.length === 0) {\n      throw new Error(\"No images found\");\n    }\n\n    // Pick a random hit\n    const randomHit = hits[Math.floor(Math.random() * hits.length)];\n\n    return {\n      url: randomHit.largeImageURL || randomHit.webformatURL,\n      width: randomHit.imageWidth || randomHit.webformatWidth,\n      height: randomHit.imageHeight || randomHit.webformatHeight,\n      author: randomHit.user,\n      authorUrl: `https://pixabay.com/users/${randomHit.user}-${randomHit.user_id}/`,\n      originalUrl: randomHit.pageURL,\n    };\n  }\n}\n","import { ImageProvider, ImageOptions, ImageResult, DownloadOptions } from './types';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport axios from 'axios';\nimport { v7 as uuidv4 } from 'uuid';\n\nexport class RandomImage {\n  private provider: ImageProvider;\n\n  constructor(provider: ImageProvider) {\n    this.provider = provider;\n  }\n\n  /**\n   * Fetches a random image based on the provided options.\n   * @param options - Configuration options for the image (width, height, query, etc.)\n   * @returns A promise that resolves to an ImageResult object.\n   */\n  async getRandom(options: ImageOptions = {}): Promise<ImageResult> {\n    return this.provider.fetchRandomImage(options);\n  }\n\n  /**\n   * Downloads an image to a specified directory.\n   * @param imageUrl - The URL of the image to download (can be a string or ImageResult object)\n   * @param destinationPath - The directory path where the image will be saved\n   * @param options - Download options (filename, overwrite, etc.)\n   * @returns A promise that resolves to the full path of the downloaded file\n   */\n  async download(\n    imageUrl: string | ImageResult,\n    destinationPath: string,\n    options: DownloadOptions = {}\n  ): Promise<string> {\n    const url = typeof imageUrl === 'string' ? imageUrl : imageUrl.url;\n\n    // Create directory if it doesn't exist\n    if (!fs.existsSync(destinationPath)) {\n      fs.mkdirSync(destinationPath, { recursive: true });\n    }\n\n    // Determine filename\n    let finalFilename: string;\n    if (options.filename) {\n      finalFilename = options.filename;\n    } else if (options.keepOriginalName) {\n      // keepOriginalName === true or undefined (default behavior: try to keep original)\n      const urlPath = new URL(url).pathname;\n      const urlFilename = path.basename(urlPath);\n      if (urlFilename && urlFilename.length > 0 && urlFilename !== '/') {\n        finalFilename = urlFilename;\n      } else {\n        // Fallback if no filename in URL\n        const ext = this.getExtensionFromUrl(url) || '.jpg';\n        finalFilename = `${uuidv4()}${ext}`;\n      }\n    } else {\n      // Generate UUID v4 filename\n      const ext = this.getExtensionFromUrl(url) || '.jpg';\n      finalFilename = `${uuidv4()}${ext}`;\n    }\n\n    // Ensure filename has an extension\n    if (!path.extname(finalFilename)) {\n      finalFilename += '.jpg';\n    }\n\n    const fullPath = path.join(destinationPath, finalFilename);\n\n    // Check if file exists and overwrite option\n    if (fs.existsSync(fullPath) && !options.overwrite) {\n      throw new Error(`File already exists: ${fullPath}. Set overwrite: true to replace it.`);\n    }\n\n    try {\n      const response = await axios.get(url, {\n        responseType: 'stream',\n        maxRedirects: 5, // Automatically handle redirects\n      });\n\n      const writer = fs.createWriteStream(fullPath);\n\n      response.data.pipe(writer);\n\n      return new Promise((resolve, reject) => {\n        writer.on('finish', () => {\n          resolve(fullPath);\n        });\n\n        writer.on('error', (err) => {\n          fs.unlink(fullPath, () => { }); // Delete partial file\n          reject(err);\n        });\n\n        response.data.on('error', (err: Error) => {\n          writer.close();\n          fs.unlink(fullPath, () => { }); // Delete partial file\n          reject(err);\n        });\n      });\n    } catch (error) {\n      if (axios.isAxiosError(error)) {\n        throw new Error(`Failed to download image: ${error.message}`);\n      }\n      throw error;\n    }\n  }\n\n  /**\n   * Helper method to extract file extension from URL\n   * @param url - The URL to extract extension from\n   * @returns The file extension (e.g., '.jpg', '.png') or null\n   */\n  private getExtensionFromUrl(url: string): string | null {\n    try {\n      const urlPath = new URL(url).pathname;\n      const ext = path.extname(urlPath);\n      return ext || null;\n    } catch {\n      return null;\n    }\n  }\n}\n"],"mappings":"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","names":["axios","axios","axios"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nghiavuive/random-image",
-  "version": "1.0.2",
-  "description": "",
+  "version": "1.2.0",
+  "description": "Fetch random images from Unsplash, Pexels, and Pixabay with CLI support",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
@@ -31,12 +31,18 @@
   },
   "devDependencies": {
     "@types/node": "^25.2.0",
-    "dotenv": "^17.2.3",
+    "@types/uuid": "^10.0.0",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
     "vitest": "^4.0.18"
   },
   "dependencies": {
-    "axios": "^1.13.4"
+    "axios": "^1.13.4",
+    "commander": "^12.1.0",
+    "dotenv": "^17.2.3",
+    "uuid": "^13.0.0"
+  },
+  "bin": {
+    "random-image": "./dist/cli.js"
   }
 }