@nghiavuive/random-image 1.0.0

package/README.md

@@ -0,0 +1,74 @@
+# random-image
+
+A generic utility library to fetch random images from various providers like Unsplash and Pexels.
+
+## Installation
+
+```bash
+npm install random-image
+```
+
+## Usage
+
+You need to obtain API keys from the respective providers:
+- [Unsplash Developers](https://unsplash.com/developers)
+- [Pexels API](https://www.pexels.com/api/)
+
+```typescript
+import { RandomImage, UnsplashProvider, PexelsProvider } from 'random-image';
+
+// Using Unsplash
+const unsplash = new UnsplashProvider('YOUR_UNSPLASH_ACCESS_KEY');
+const fetcher = new RandomImage(unsplash);
+
+fetcher.getRandom({
+    width: 1920,
+    height: 1080,
+    query: 'nature'
+}).then(image => {
+    console.log(image.url); // URL to the image
+    console.log(image.author); // Photographer's name
+});
+
+// Using Pexels
+const pexels = new PexelsProvider('YOUR_PEXELS_API_KEY');
+const pexelsFetcher = new RandomImage(pexels);
+
+pexelsFetcher.getRandom({
+    width: 800,
+    height: 600,
+    query: 'cats'
+}).then(image => {
+    console.log(image.url);
+});
+```
+
+## API
+
+### `RandomImage`
+The main class to interact with.
+
+```typescript
+class RandomImage {
+    constructor(provider: ImageProvider);
+    getRandom(options: ImageOptions): Promise<ImageResult>;
+}
+```
+
+### `ImageOptions`
+- `width` (number): Desired width of the image.
+- `height` (number): Desired height of the image.
+- `quality` (number): Quality (0-100) if supported.
+- `query` (string): Search query (e.g. "nature", "city").
+
+### `ImageResult`
+- `url` (string): Direct URL to the image.
+- `width` (number): Width of the image.
+- `height` (number): Height of the image.
+- `author` (string): Name of the photographer.
+- `authorUrl` (string): URL to photographer's profile.
+- `originalUrl` (string): URL to the original photo page.
+
+## License
+
+ISC

package/dist/index.d.mts

@@ -0,0 +1,42 @@
+interface ImageOptions {
+    width?: number;
+    height?: number;
+    quality?: number;
+    query?: string;
+}
+interface ImageResult {
+    url: string;
+    width: number;
+    height: number;
+    author: string;
+    authorUrl?: string;
+    originalUrl: string;
+}
+interface ImageProvider {
+    fetchRandomImage(options: ImageOptions): Promise<ImageResult>;
+}
+
+declare class UnsplashProvider implements ImageProvider {
+    private accessKey;
+    constructor(accessKey: string);
+    fetchRandomImage(options: ImageOptions): Promise<ImageResult>;
+}
+
+declare class PexelsProvider implements ImageProvider {
+    private apiKey;
+    constructor(apiKey: string);
+    fetchRandomImage(options: ImageOptions): Promise<ImageResult>;
+}
+
+declare class RandomImage {
+    private provider;
+    constructor(provider: ImageProvider);
+    /**
+     * Fetches a random image based on the provided options.
+     * @param options - Configuration options for the image (width, height, query, etc.)
+     * @returns A promise that resolves to an ImageResult object.
+     */
+    getRandom(options?: ImageOptions): Promise<ImageResult>;
+}
+
+export { type ImageOptions, type ImageProvider, type ImageResult, PexelsProvider, RandomImage, UnsplashProvider };

package/dist/index.d.ts

@@ -0,0 +1,42 @@
+interface ImageOptions {
+    width?: number;
+    height?: number;
+    quality?: number;
+    query?: string;
+}
+interface ImageResult {
+    url: string;
+    width: number;
+    height: number;
+    author: string;
+    authorUrl?: string;
+    originalUrl: string;
+}
+interface ImageProvider {
+    fetchRandomImage(options: ImageOptions): Promise<ImageResult>;
+}
+
+declare class UnsplashProvider implements ImageProvider {
+    private accessKey;
+    constructor(accessKey: string);
+    fetchRandomImage(options: ImageOptions): Promise<ImageResult>;
+}
+
+declare class PexelsProvider implements ImageProvider {
+    private apiKey;
+    constructor(apiKey: string);
+    fetchRandomImage(options: ImageOptions): Promise<ImageResult>;
+}
+
+declare class RandomImage {
+    private provider;
+    constructor(provider: ImageProvider);
+    /**
+     * Fetches a random image based on the provided options.
+     * @param options - Configuration options for the image (width, height, query, etc.)
+     * @returns A promise that resolves to an ImageResult object.
+     */
+    getRandom(options?: ImageOptions): Promise<ImageResult>;
+}
+
+export { type ImageOptions, type ImageProvider, type ImageResult, PexelsProvider, RandomImage, UnsplashProvider };

package/dist/index.js

@@ -0,0 +1,129 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  PexelsProvider: () => PexelsProvider,
+  RandomImage: () => RandomImage,
+  UnsplashProvider: () => UnsplashProvider
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/providers/unsplash.ts
+var UnsplashProvider = class {
+  constructor(accessKey) {
+    this.accessKey = accessKey;
+  }
+  async fetchRandomImage(options) {
+    const params = new URLSearchParams();
+    if (options.query) params.append("query", options.query);
+    const url = `https://api.unsplash.com/photos/random?${params.toString()}`;
+    const response = await fetch(url, {
+      headers: {
+        Authorization: `Client-ID ${this.accessKey}`
+      }
+    });
+    if (!response.ok) {
+      throw new Error(`Unsplash API error: ${response.statusText}`);
+    }
+    const data = await response.json();
+    const photo = Array.isArray(data) ? data[0] : data;
+    const baseUrl = photo.urls.raw;
+    const sizeParams = new URLSearchParams();
+    if (options.width) sizeParams.append("w", options.width.toString());
+    if (options.height) sizeParams.append("h", options.height.toString());
+    if (options.quality) sizeParams.append("q", options.quality.toString());
+    const finalUrl = `${baseUrl}&${sizeParams.toString()}`;
+    return {
+      url: finalUrl,
+      width: options.width || photo.width,
+      height: options.height || photo.height,
+      author: photo.user.name,
+      authorUrl: photo.user.links.html,
+      originalUrl: photo.links.html
+      // Link to photo page
+    };
+  }
+};
+
+// src/providers/pexels.ts
+var PexelsProvider = class {
+  constructor(apiKey) {
+    this.apiKey = apiKey;
+  }
+  async fetchRandomImage(options) {
+    const endpoint = options.query ? "https://api.pexels.com/v1/search" : "https://api.pexels.com/v1/curated";
+    const randomPage = Math.floor(Math.random() * 100) + 1;
+    const params = new URLSearchParams();
+    if (options.query) params.append("query", options.query);
+    params.append("per_page", "1");
+    params.append("page", randomPage.toString());
+    const response = await fetch(`${endpoint}?${params.toString()}`, {
+      headers: {
+        Authorization: this.apiKey
+      }
+    });
+    if (!response.ok) {
+      throw new Error(`Pexels API error: ${response.statusText}`);
+    }
+    const data = await response.json();
+    if (!data.photos || data.photos.length === 0) {
+      throw new Error("No images found on Pexels");
+    }
+    const photo = data.photos[0];
+    const baseUrl = photo.src.original;
+    const sizeParams = new URLSearchParams();
+    sizeParams.append("auto", "compress");
+    sizeParams.append("cs", "tinysrgb");
+    if (options.width) sizeParams.append("w", options.width.toString());
+    if (options.height) sizeParams.append("h", options.height.toString());
+    const finalUrl = `${baseUrl}?${sizeParams.toString()}`;
+    return {
+      url: finalUrl,
+      width: options.width || photo.width,
+      height: options.height || photo.height,
+      author: photo.photographer,
+      authorUrl: photo.photographer_url,
+      originalUrl: photo.url
+    };
+  }
+};
+
+// src/image-fetcher.ts
+var RandomImage = class {
+  constructor(provider) {
+    this.provider = provider;
+  }
+  /**
+   * Fetches a random image based on the provided options.
+   * @param options - Configuration options for the image (width, height, query, etc.)
+   * @returns A promise that resolves to an ImageResult object.
+   */
+  async getRandom(options = {}) {
+    return this.provider.fetchRandomImage(options);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PexelsProvider,
+  RandomImage,
+  UnsplashProvider
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/providers/unsplash.ts","../src/providers/pexels.ts","../src/image-fetcher.ts"],"sourcesContent":["export * from './types';\nexport * from './providers/unsplash';\nexport * from './providers/pexels';\nexport * from './image-fetcher';\n","import { 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 params = new URLSearchParams();\n    if (options.query) params.append('query', options.query);\n    // Unsplash doesn't strictly support width/height for random photo selection in the same way for resizing via API query params on the /random endpoint directly for *fetching* the image content, \n    // but we can request specific dimensions roughly or rely on the returned structure to pick a size.\n    // However, the /photos/random endpoint returns a JSON with urls.raw, urls.full, etc.\n    // We can append parameters to the returned URL for resizing.\n    \n    // Using fetching logic:\n    const url = `https://api.unsplash.com/photos/random?${params.toString()}`;\n    \n    const response = await fetch(url, {\n      headers: {\n        Authorization: `Client-ID ${this.accessKey}`\n      }\n    });\n\n    if (!response.ok) {\n        throw new Error(`Unsplash API error: ${response.statusText}`);\n    }\n\n    const data = await response.json();\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.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 { 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    // Pexels 'curated' or 'search'. \n    // If query is present, use search. If not, use curated.\n    // We need to randomize the result because Pexels search/curated returns a list.\n    // We can use 'page' and 'per_page=1' with a random page number to simulate random? \n    // Or just fetch one page and pick random?\n    // Pexels API doesn't have a direct /random endpoint like Unsplash.\n    // Efficient strategy: Search with 1 result per page, but randomize the page number.\n    // Max page is tricky, maybe limit to top 100 results?\n    \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 = new URLSearchParams();\n    if (options.query) params.append('query', options.query);\n    params.append('per_page', '1');\n    params.append('page', randomPage.toString());\n\n    const response = await fetch(`${endpoint}?${params.toString()}`, {\n      headers: {\n        Authorization: this.apiKey\n      }\n    });\n\n    if (!response.ok) {\n      throw new Error(`Pexels API error: ${response.statusText}`);\n    }\n\n    const data = await response.json();\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    // Pexels supports resizing via query params on the image url?\n    // Pexels returns src object with original, large2x, large, medium, small, portrait, landscape, tiny.\n    // Or we can modify the 'original' url.\n    // Pexels docs say: https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg?auto=compress&cs=tinysrgb&h=350\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    // Note: Quality param is not standard in Pexels URL manipulation documented publicly as 'q', \n    // but 'auto=compress' handles it. We can try adding it if needed or ignore. \n    // I'll skip explicit q param mapping for now as it's not strictly 'quality=X'.\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 { 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":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACEO,IAAM,mBAAN,MAAgD;AAAA,EAGrD,YAAY,WAAmB;AAC7B,SAAK,YAAY;AAAA,EACnB;AAAA,EAEA,MAAM,iBAAiB,SAA6C;AAClE,UAAM,SAAS,IAAI,gBAAgB;AACnC,QAAI,QAAQ,MAAO,QAAO,OAAO,SAAS,QAAQ,KAAK;AAOvD,UAAM,MAAM,0CAA0C,OAAO,SAAS,CAAC;AAEvE,UAAM,WAAW,MAAM,MAAM,KAAK;AAAA,MAChC,SAAS;AAAA,QACP,eAAe,aAAa,KAAK,SAAS;AAAA,MAC5C;AAAA,IACF,CAAC;AAED,QAAI,CAAC,SAAS,IAAI;AACd,YAAM,IAAI,MAAM,uBAAuB,SAAS,UAAU,EAAE;AAAA,IAChE;AAEA,UAAM,OAAO,MAAM,SAAS,KAAK;AAGjC,UAAM,QAAQ,MAAM,QAAQ,IAAI,IAAI,KAAK,CAAC,IAAI;AAI9C,UAAM,UAAU,MAAM,KAAK;AAC3B,UAAM,aAAa,IAAI,gBAAgB;AACvC,QAAI,QAAQ,MAAO,YAAW,OAAO,KAAK,QAAQ,MAAM,SAAS,CAAC;AAClE,QAAI,QAAQ,OAAQ,YAAW,OAAO,KAAK,QAAQ,OAAO,SAAS,CAAC;AACpE,QAAI,QAAQ,QAAS,YAAW,OAAO,KAAK,QAAQ,QAAQ,SAAS,CAAC;AAEtE,UAAM,WAAW,GAAG,OAAO,IAAI,WAAW,SAAS,CAAC;AAEpD,WAAO;AAAA,MACL,KAAK;AAAA,MACL,OAAO,QAAQ,SAAS,MAAM;AAAA,MAC9B,QAAQ,QAAQ,UAAU,MAAM;AAAA,MAChC,QAAQ,MAAM,KAAK;AAAA,MACnB,WAAW,MAAM,KAAK,MAAM;AAAA,MAC5B,aAAa,MAAM,MAAM;AAAA;AAAA,IAC3B;AAAA,EACF;AACF;;;ACpDO,IAAM,iBAAN,MAA8C;AAAA,EAGnD,YAAY,QAAgB;AAC1B,SAAK,SAAS;AAAA,EAChB;AAAA,EAEA,MAAM,iBAAiB,SAA6C;AAUlE,UAAM,WAAW,QAAQ,QACnB,qCACA;AAGN,UAAM,aAAa,KAAK,MAAM,KAAK,OAAO,IAAI,GAAG,IAAI;AAErD,UAAM,SAAS,IAAI,gBAAgB;AACnC,QAAI,QAAQ,MAAO,QAAO,OAAO,SAAS,QAAQ,KAAK;AACvD,WAAO,OAAO,YAAY,GAAG;AAC7B,WAAO,OAAO,QAAQ,WAAW,SAAS,CAAC;AAE3C,UAAM,WAAW,MAAM,MAAM,GAAG,QAAQ,IAAI,OAAO,SAAS,CAAC,IAAI;AAAA,MAC/D,SAAS;AAAA,QACP,eAAe,KAAK;AAAA,MACtB;AAAA,IACF,CAAC;AAED,QAAI,CAAC,SAAS,IAAI;AAChB,YAAM,IAAI,MAAM,qBAAqB,SAAS,UAAU,EAAE;AAAA,IAC5D;AAEA,UAAM,OAAO,MAAM,SAAS,KAAK;AAEjC,QAAI,CAAC,KAAK,UAAU,KAAK,OAAO,WAAW,GAAG;AAC1C,YAAM,IAAI,MAAM,2BAA2B;AAAA,IAC/C;AAEA,UAAM,QAAQ,KAAK,OAAO,CAAC;AAO3B,UAAM,UAAU,MAAM,IAAI;AAC1B,UAAM,aAAa,IAAI,gBAAgB;AACvC,eAAW,OAAO,QAAQ,UAAU;AACpC,eAAW,OAAO,MAAM,UAAU;AAClC,QAAI,QAAQ,MAAO,YAAW,OAAO,KAAK,QAAQ,MAAM,SAAS,CAAC;AAClE,QAAI,QAAQ,OAAQ,YAAW,OAAO,KAAK,QAAQ,OAAO,SAAS,CAAC;AAMpE,UAAM,WAAW,GAAG,OAAO,IAAI,WAAW,SAAS,CAAC;AAEpD,WAAO;AAAA,MACL,KAAK;AAAA,MACL,OAAO,QAAQ,SAAS,MAAM;AAAA,MAC9B,QAAQ,QAAQ,UAAU,MAAM;AAAA,MAChC,QAAQ,MAAM;AAAA,MACd,WAAW,MAAM;AAAA,MACjB,aAAa,MAAM;AAAA,IACrB;AAAA,EACF;AACF;;;AC1EO,IAAM,cAAN,MAAkB;AAAA,EAGvB,YAAY,UAAyB;AACnC,SAAK,WAAW;AAAA,EAClB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,UAAU,UAAwB,CAAC,GAAyB;AAChE,WAAO,KAAK,SAAS,iBAAiB,OAAO;AAAA,EAC/C;AACF;","names":[]}

package/dist/index.mjs

@@ -0,0 +1,100 @@
+// src/providers/unsplash.ts
+var UnsplashProvider = class {
+  constructor(accessKey) {
+    this.accessKey = accessKey;
+  }
+  async fetchRandomImage(options) {
+    const params = new URLSearchParams();
+    if (options.query) params.append("query", options.query);
+    const url = `https://api.unsplash.com/photos/random?${params.toString()}`;
+    const response = await fetch(url, {
+      headers: {
+        Authorization: `Client-ID ${this.accessKey}`
+      }
+    });
+    if (!response.ok) {
+      throw new Error(`Unsplash API error: ${response.statusText}`);
+    }
+    const data = await response.json();
+    const photo = Array.isArray(data) ? data[0] : data;
+    const baseUrl = photo.urls.raw;
+    const sizeParams = new URLSearchParams();
+    if (options.width) sizeParams.append("w", options.width.toString());
+    if (options.height) sizeParams.append("h", options.height.toString());
+    if (options.quality) sizeParams.append("q", options.quality.toString());
+    const finalUrl = `${baseUrl}&${sizeParams.toString()}`;
+    return {
+      url: finalUrl,
+      width: options.width || photo.width,
+      height: options.height || photo.height,
+      author: photo.user.name,
+      authorUrl: photo.user.links.html,
+      originalUrl: photo.links.html
+      // Link to photo page
+    };
+  }
+};
+
+// src/providers/pexels.ts
+var PexelsProvider = class {
+  constructor(apiKey) {
+    this.apiKey = apiKey;
+  }
+  async fetchRandomImage(options) {
+    const endpoint = options.query ? "https://api.pexels.com/v1/search" : "https://api.pexels.com/v1/curated";
+    const randomPage = Math.floor(Math.random() * 100) + 1;
+    const params = new URLSearchParams();
+    if (options.query) params.append("query", options.query);
+    params.append("per_page", "1");
+    params.append("page", randomPage.toString());
+    const response = await fetch(`${endpoint}?${params.toString()}`, {
+      headers: {
+        Authorization: this.apiKey
+      }
+    });
+    if (!response.ok) {
+      throw new Error(`Pexels API error: ${response.statusText}`);
+    }
+    const data = await response.json();
+    if (!data.photos || data.photos.length === 0) {
+      throw new Error("No images found on Pexels");
+    }
+    const photo = data.photos[0];
+    const baseUrl = photo.src.original;
+    const sizeParams = new URLSearchParams();
+    sizeParams.append("auto", "compress");
+    sizeParams.append("cs", "tinysrgb");
+    if (options.width) sizeParams.append("w", options.width.toString());
+    if (options.height) sizeParams.append("h", options.height.toString());
+    const finalUrl = `${baseUrl}?${sizeParams.toString()}`;
+    return {
+      url: finalUrl,
+      width: options.width || photo.width,
+      height: options.height || photo.height,
+      author: photo.photographer,
+      authorUrl: photo.photographer_url,
+      originalUrl: photo.url
+    };
+  }
+};
+
+// src/image-fetcher.ts
+var RandomImage = class {
+  constructor(provider) {
+    this.provider = provider;
+  }
+  /**
+   * Fetches a random image based on the provided options.
+   * @param options - Configuration options for the image (width, height, query, etc.)
+   * @returns A promise that resolves to an ImageResult object.
+   */
+  async getRandom(options = {}) {
+    return this.provider.fetchRandomImage(options);
+  }
+};
+export {
+  PexelsProvider,
+  RandomImage,
+  UnsplashProvider
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/providers/unsplash.ts","../src/providers/pexels.ts","../src/image-fetcher.ts"],"sourcesContent":["import { 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 params = new URLSearchParams();\n    if (options.query) params.append('query', options.query);\n    // Unsplash doesn't strictly support width/height for random photo selection in the same way for resizing via API query params on the /random endpoint directly for *fetching* the image content, \n    // but we can request specific dimensions roughly or rely on the returned structure to pick a size.\n    // However, the /photos/random endpoint returns a JSON with urls.raw, urls.full, etc.\n    // We can append parameters to the returned URL for resizing.\n    \n    // Using fetching logic:\n    const url = `https://api.unsplash.com/photos/random?${params.toString()}`;\n    \n    const response = await fetch(url, {\n      headers: {\n        Authorization: `Client-ID ${this.accessKey}`\n      }\n    });\n\n    if (!response.ok) {\n        throw new Error(`Unsplash API error: ${response.statusText}`);\n    }\n\n    const data = await response.json();\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.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 { 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    // Pexels 'curated' or 'search'. \n    // If query is present, use search. If not, use curated.\n    // We need to randomize the result because Pexels search/curated returns a list.\n    // We can use 'page' and 'per_page=1' with a random page number to simulate random? \n    // Or just fetch one page and pick random?\n    // Pexels API doesn't have a direct /random endpoint like Unsplash.\n    // Efficient strategy: Search with 1 result per page, but randomize the page number.\n    // Max page is tricky, maybe limit to top 100 results?\n    \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 = new URLSearchParams();\n    if (options.query) params.append('query', options.query);\n    params.append('per_page', '1');\n    params.append('page', randomPage.toString());\n\n    const response = await fetch(`${endpoint}?${params.toString()}`, {\n      headers: {\n        Authorization: this.apiKey\n      }\n    });\n\n    if (!response.ok) {\n      throw new Error(`Pexels API error: ${response.statusText}`);\n    }\n\n    const data = await response.json();\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    // Pexels supports resizing via query params on the image url?\n    // Pexels returns src object with original, large2x, large, medium, small, portrait, landscape, tiny.\n    // Or we can modify the 'original' url.\n    // Pexels docs say: https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg?auto=compress&cs=tinysrgb&h=350\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    // Note: Quality param is not standard in Pexels URL manipulation documented publicly as 'q', \n    // but 'auto=compress' handles it. We can try adding it if needed or ignore. \n    // I'll skip explicit q param mapping for now as it's not strictly 'quality=X'.\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 { 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":[]}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@nghiavuive/random-image",
+  "version": "1.0.0",
+  "description": "",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest",
+    "dev": "tsup --watch",
+    "lint": "tsc --noEmit"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "type": "commonjs",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/codengoo/random-image"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  }
+}