@anymux/pexels 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,177 @@
+import { IMediaProvider, MediaItem } from "@anymux/ui-kit/media";
+
+//#region src/PexelsClient.d.ts
+/**
+* Low-level Pexels API client.
+*
+* Uses API key authentication for read-only access.
+* All content is free to use under the Pexels license.
+*/
+/**
+ * Low-level Pexels API client.
+ *
+ * Uses API key authentication for read-only access.
+ * All content is free to use under the Pexels license.
+ */
+interface PexelsPhoto {
+  id: number;
+  width: number;
+  height: number;
+  url: string;
+  photographer: string;
+  photographer_url: string;
+  photographer_id: number;
+  avg_color: string;
+  src: {
+    original: string;
+    large2x: string;
+    large: string;
+    medium: string;
+    small: string;
+    portrait: string;
+    landscape: string;
+    tiny: string;
+  };
+  liked: boolean;
+  alt: string;
+}
+interface PexelsVideo {
+  id: number;
+  width: number;
+  height: number;
+  url: string;
+  image: string;
+  duration: number;
+  user: {
+    id: number;
+    name: string;
+    url: string;
+  };
+  video_files: Array<{
+    id: number;
+    quality: string;
+    file_type: string;
+    width: number;
+    height: number;
+    link: string;
+  }>;
+  video_pictures: Array<{
+    id: number;
+    picture: string;
+    nr: number;
+  }>;
+}
+interface PexelsCollection {
+  id: string;
+  title: string;
+  description: string | null;
+  private: boolean;
+  media_count: number;
+  photos_count: number;
+  videos_count: number;
+}
+interface PexelsPaginatedPhotos {
+  total_results: number;
+  page: number;
+  per_page: number;
+  photos: PexelsPhoto[];
+  next_page?: string;
+}
+interface PexelsPaginatedVideos {
+  total_results: number;
+  page: number;
+  per_page: number;
+  videos: PexelsVideo[];
+  next_page?: string;
+}
+interface PexelsPaginatedCollections {
+  collections: PexelsCollection[];
+  page: number;
+  per_page: number;
+  total_results: number;
+  next_page?: string;
+}
+interface PexelsCollectionMedia {
+  media: Array<PexelsPhoto & {
+    type: 'Photo';
+  } | PexelsVideo & {
+    type: 'Video';
+  }>;
+  page: number;
+  per_page: number;
+  total_results: number;
+  next_page?: string;
+}
+interface PexelsClientConfig {
+  /** Pexels API key */
+  apiKey: string;
+}
+declare class PexelsClient {
+  private apiKey;
+  constructor(config: PexelsClientConfig);
+  /** Search photos by query. */
+  searchPhotos(options: {
+    query: string;
+    page?: number;
+    perPage?: number;
+    orientation?: 'landscape' | 'portrait' | 'square';
+    size?: 'large' | 'medium' | 'small';
+    color?: string;
+  }): Promise<PexelsPaginatedPhotos>;
+  /** Get curated editorial photos. */
+  getCurated(options?: {
+    page?: number;
+    perPage?: number;
+  }): Promise<PexelsPaginatedPhotos>;
+  /** Get a single photo by ID. */
+  getPhoto(id: number): Promise<PexelsPhoto>;
+  /** Search videos by query. */
+  searchVideos(options: {
+    query: string;
+    page?: number;
+    perPage?: number;
+    orientation?: 'landscape' | 'portrait' | 'square';
+    size?: 'large' | 'medium' | 'small';
+  }): Promise<PexelsPaginatedVideos>;
+  /** Get popular videos. */
+  getPopularVideos(options?: {
+    page?: number;
+    perPage?: number;
+  }): Promise<PexelsPaginatedVideos>;
+  /** List featured collections. */
+  getFeaturedCollections(options?: {
+    page?: number;
+    perPage?: number;
+  }): Promise<PexelsPaginatedCollections>;
+  /** Get media in a collection. */
+  getCollectionMedia(collectionId: string, options?: {
+    type?: 'photos' | 'videos';
+    page?: number;
+    perPage?: number;
+  }): Promise<PexelsCollectionMedia>;
+  private get;
+} //#endregion
+//#region src/PexelsMediaProvider.d.ts
+
+//# sourceMappingURL=PexelsClient.d.ts.map
+declare class PexelsMediaProvider implements IMediaProvider {
+  private client;
+  /** Cache of collection ID -> collection for resolving album names. */
+  private collectionCache;
+  constructor(config: PexelsClientConfig);
+  listItems(): Promise<MediaItem[]>;
+  getItem(id: string): Promise<MediaItem | null>;
+  createItem(_item: Omit<MediaItem, 'id' | 'createdAt' | 'updatedAt'>): Promise<MediaItem>;
+  updateItem(_id: string, _updates: Partial<MediaItem>): Promise<MediaItem>;
+  deleteItem(_id: string): Promise<void>;
+  search(query: string): Promise<MediaItem[]>;
+  getAlbums(): Promise<string[]>;
+  getByAlbum(album: string): Promise<MediaItem[]>;
+  getByDateRange(_start: Date, _end: Date): Promise<MediaItem[]>;
+}
+
+//#endregion
+//# sourceMappingURL=PexelsMediaProvider.d.ts.map
+
+export { PexelsClient, PexelsClientConfig, PexelsCollection, PexelsCollectionMedia, PexelsMediaProvider, PexelsPaginatedCollections, PexelsPaginatedPhotos, PexelsPaginatedVideos, PexelsPhoto, PexelsVideo };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/PexelsClient.ts","../src/PexelsMediaProvider.ts"],"sourcesContent":null,"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,159 @@
+//#region src/PexelsClient.ts
+/**
+* Low-level Pexels API client.
+*
+* Uses API key authentication for read-only access.
+* All content is free to use under the Pexels license.
+*/
+const API_URL = "https://api.pexels.com";
+var PexelsClient = class {
+	constructor(config) {
+		this.apiKey = config.apiKey;
+	}
+	/** Search photos by query. */
+	async searchPhotos(options) {
+		const params = new URLSearchParams();
+		params.set("query", options.query);
+		params.set("page", String(options.page ?? 1));
+		params.set("per_page", String(options.perPage ?? 30));
+		if (options.orientation) params.set("orientation", options.orientation);
+		if (options.size) params.set("size", options.size);
+		if (options.color) params.set("color", options.color);
+		return this.get(`/v1/search?${params}`);
+	}
+	/** Get curated editorial photos. */
+	async getCurated(options = {}) {
+		const params = new URLSearchParams();
+		params.set("page", String(options.page ?? 1));
+		params.set("per_page", String(options.perPage ?? 30));
+		return this.get(`/v1/curated?${params}`);
+	}
+	/** Get a single photo by ID. */
+	async getPhoto(id) {
+		return this.get(`/v1/photos/${id}`);
+	}
+	/** Search videos by query. */
+	async searchVideos(options) {
+		const params = new URLSearchParams();
+		params.set("query", options.query);
+		params.set("page", String(options.page ?? 1));
+		params.set("per_page", String(options.perPage ?? 30));
+		if (options.orientation) params.set("orientation", options.orientation);
+		if (options.size) params.set("size", options.size);
+		return this.get(`/videos/search?${params}`);
+	}
+	/** Get popular videos. */
+	async getPopularVideos(options = {}) {
+		const params = new URLSearchParams();
+		params.set("page", String(options.page ?? 1));
+		params.set("per_page", String(options.perPage ?? 30));
+		return this.get(`/videos/popular?${params}`);
+	}
+	/** List featured collections. */
+	async getFeaturedCollections(options = {}) {
+		const params = new URLSearchParams();
+		params.set("page", String(options.page ?? 1));
+		params.set("per_page", String(options.perPage ?? 30));
+		return this.get(`/v1/collections/featured?${params}`);
+	}
+	/** Get media in a collection. */
+	async getCollectionMedia(collectionId, options = {}) {
+		const params = new URLSearchParams();
+		if (options.type) params.set("type", options.type);
+		params.set("page", String(options.page ?? 1));
+		params.set("per_page", String(options.perPage ?? 30));
+		return this.get(`/v1/collections/${collectionId}?${params}`);
+	}
+	async get(path) {
+		const url = `${API_URL}${path}`;
+		const res = await fetch(url, { headers: { Authorization: this.apiKey } });
+		if (!res.ok) {
+			const text = await res.text();
+			throw new Error(`Pexels API error ${res.status}: ${text}`);
+		}
+		return res.json();
+	}
+};
+
+//#endregion
+//#region src/PexelsMediaProvider.ts
+function mapPhoto(photo, albumName) {
+	const item = {
+		id: String(photo.id),
+		type: "media",
+		title: photo.alt || `Photo by ${photo.photographer}`,
+		mediaType: "photo",
+		url: photo.src.large2x,
+		thumbnail: photo.src.medium,
+		mimeType: "image/jpeg",
+		width: photo.width,
+		height: photo.height,
+		createdAt: new Date(),
+		updatedAt: new Date()
+	};
+	if (photo.alt) item.description = photo.alt;
+	if (albumName) item.album = albumName;
+	return item;
+}
+var PexelsMediaProvider = class {
+	constructor(config) {
+		this.collectionCache = new Map();
+		this.client = new PexelsClient(config);
+	}
+	async listItems() {
+		const result = await this.client.getCurated({ perPage: 30 });
+		return result.photos.map((p) => mapPhoto(p));
+	}
+	async getItem(id) {
+		try {
+			const photo = await this.client.getPhoto(Number(id));
+			return mapPhoto(photo);
+		} catch {
+			return null;
+		}
+	}
+	async createItem(_item) {
+		throw new Error("Pexels is a read-only photo library");
+	}
+	async updateItem(_id, _updates) {
+		throw new Error("Pexels is a read-only photo library");
+	}
+	async deleteItem(_id) {
+		throw new Error("Pexels is a read-only photo library");
+	}
+	async search(query) {
+		const result = await this.client.searchPhotos({
+			query,
+			perPage: 30
+		});
+		return result.photos.map((p) => mapPhoto(p));
+	}
+	async getAlbums() {
+		const result = await this.client.getFeaturedCollections({ perPage: 30 });
+		this.collectionCache.clear();
+		for (const c of result.collections) this.collectionCache.set(c.id, c);
+		return result.collections.map((c) => c.title);
+	}
+	async getByAlbum(album) {
+		if (this.collectionCache.size === 0) await this.getAlbums();
+		let collectionId;
+		for (const [id, c] of this.collectionCache) if (c.title === album) {
+			collectionId = id;
+			break;
+		}
+		if (!collectionId) return [];
+		const result = await this.client.getCollectionMedia(collectionId, {
+			type: "photos",
+			perPage: 30
+		});
+		return result.media.filter((m) => m.type === "Photo").map((p) => mapPhoto(p, album));
+	}
+	async getByDateRange(_start, _end) {
+		const result = await this.client.getCurated({ perPage: 30 });
+		return result.photos.map((p) => mapPhoto(p));
+	}
+};
+
+//#endregion
+export { PexelsClient, PexelsMediaProvider };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["config: PexelsClientConfig","options: {\n    query: string;\n    page?: number;\n    perPage?: number;\n    orientation?: 'landscape' | 'portrait' | 'square';\n    size?: 'large' | 'medium' | 'small';\n    color?: string;\n  }","options: {\n    page?: number;\n    perPage?: number;\n  }","id: number","options: {\n    query: string;\n    page?: number;\n    perPage?: number;\n    orientation?: 'landscape' | 'portrait' | 'square';\n    size?: 'large' | 'medium' | 'small';\n  }","collectionId: string","options: {\n    type?: 'photos' | 'videos';\n    page?: number;\n    perPage?: number;\n  }","path: string","photo: PexelsPhoto","albumName?: string","item: MediaItem","config: PexelsClientConfig","id: string","_item: Omit<MediaItem, 'id' | 'createdAt' | 'updatedAt'>","_id: string","_updates: Partial<MediaItem>","query: string","album: string","collectionId: string | undefined","_start: Date","_end: Date"],"sources":["../src/PexelsClient.ts","../src/PexelsMediaProvider.ts"],"sourcesContent":["/**\n * Low-level Pexels API client.\n *\n * Uses API key authentication for read-only access.\n * All content is free to use under the Pexels license.\n */\n\nconst API_URL = 'https://api.pexels.com';\n\n// ---------- Response shapes ----------\n\nexport interface PexelsPhoto {\n  id: number;\n  width: number;\n  height: number;\n  url: string;\n  photographer: string;\n  photographer_url: string;\n  photographer_id: number;\n  avg_color: string;\n  src: {\n    original: string;\n    large2x: string;\n    large: string;\n    medium: string;\n    small: string;\n    portrait: string;\n    landscape: string;\n    tiny: string;\n  };\n  liked: boolean;\n  alt: string;\n}\n\nexport interface PexelsVideo {\n  id: number;\n  width: number;\n  height: number;\n  url: string;\n  image: string;\n  duration: number;\n  user: { id: number; name: string; url: string };\n  video_files: Array<{\n    id: number;\n    quality: string;\n    file_type: string;\n    width: number;\n    height: number;\n    link: string;\n  }>;\n  video_pictures: Array<{\n    id: number;\n    picture: string;\n    nr: number;\n  }>;\n}\n\nexport interface PexelsCollection {\n  id: string;\n  title: string;\n  description: string | null;\n  private: boolean;\n  media_count: number;\n  photos_count: number;\n  videos_count: number;\n}\n\nexport interface PexelsPaginatedPhotos {\n  total_results: number;\n  page: number;\n  per_page: number;\n  photos: PexelsPhoto[];\n  next_page?: string;\n}\n\nexport interface PexelsPaginatedVideos {\n  total_results: number;\n  page: number;\n  per_page: number;\n  videos: PexelsVideo[];\n  next_page?: string;\n}\n\nexport interface PexelsPaginatedCollections {\n  collections: PexelsCollection[];\n  page: number;\n  per_page: number;\n  total_results: number;\n  next_page?: string;\n}\n\nexport interface PexelsCollectionMedia {\n  media: Array<PexelsPhoto & { type: 'Photo' } | PexelsVideo & { type: 'Video' }>;\n  page: number;\n  per_page: number;\n  total_results: number;\n  next_page?: string;\n}\n\nexport interface PexelsClientConfig {\n  /** Pexels API key */\n  apiKey: string;\n}\n\nexport class PexelsClient {\n  private apiKey: string;\n\n  constructor(config: PexelsClientConfig) {\n    this.apiKey = config.apiKey;\n  }\n\n  /** Search photos by query. */\n  async searchPhotos(options: {\n    query: string;\n    page?: number;\n    perPage?: number;\n    orientation?: 'landscape' | 'portrait' | 'square';\n    size?: 'large' | 'medium' | 'small';\n    color?: string;\n  }): Promise<PexelsPaginatedPhotos> {\n    const params = new URLSearchParams();\n    params.set('query', options.query);\n    params.set('page', String(options.page ?? 1));\n    params.set('per_page', String(options.perPage ?? 30));\n    if (options.orientation) params.set('orientation', options.orientation);\n    if (options.size) params.set('size', options.size);\n    if (options.color) params.set('color', options.color);\n    return this.get<PexelsPaginatedPhotos>(`/v1/search?${params}`);\n  }\n\n  /** Get curated editorial photos. */\n  async getCurated(options: {\n    page?: number;\n    perPage?: number;\n  } = {}): Promise<PexelsPaginatedPhotos> {\n    const params = new URLSearchParams();\n    params.set('page', String(options.page ?? 1));\n    params.set('per_page', String(options.perPage ?? 30));\n    return this.get<PexelsPaginatedPhotos>(`/v1/curated?${params}`);\n  }\n\n  /** Get a single photo by ID. */\n  async getPhoto(id: number): Promise<PexelsPhoto> {\n    return this.get<PexelsPhoto>(`/v1/photos/${id}`);\n  }\n\n  /** Search videos by query. */\n  async searchVideos(options: {\n    query: string;\n    page?: number;\n    perPage?: number;\n    orientation?: 'landscape' | 'portrait' | 'square';\n    size?: 'large' | 'medium' | 'small';\n  }): Promise<PexelsPaginatedVideos> {\n    const params = new URLSearchParams();\n    params.set('query', options.query);\n    params.set('page', String(options.page ?? 1));\n    params.set('per_page', String(options.perPage ?? 30));\n    if (options.orientation) params.set('orientation', options.orientation);\n    if (options.size) params.set('size', options.size);\n    return this.get<PexelsPaginatedVideos>(`/videos/search?${params}`);\n  }\n\n  /** Get popular videos. */\n  async getPopularVideos(options: {\n    page?: number;\n    perPage?: number;\n  } = {}): Promise<PexelsPaginatedVideos> {\n    const params = new URLSearchParams();\n    params.set('page', String(options.page ?? 1));\n    params.set('per_page', String(options.perPage ?? 30));\n    return this.get<PexelsPaginatedVideos>(`/videos/popular?${params}`);\n  }\n\n  /** List featured collections. */\n  async getFeaturedCollections(options: {\n    page?: number;\n    perPage?: number;\n  } = {}): Promise<PexelsPaginatedCollections> {\n    const params = new URLSearchParams();\n    params.set('page', String(options.page ?? 1));\n    params.set('per_page', String(options.perPage ?? 30));\n    return this.get<PexelsPaginatedCollections>(`/v1/collections/featured?${params}`);\n  }\n\n  /** Get media in a collection. */\n  async getCollectionMedia(collectionId: string, options: {\n    type?: 'photos' | 'videos';\n    page?: number;\n    perPage?: number;\n  } = {}): Promise<PexelsCollectionMedia> {\n    const params = new URLSearchParams();\n    if (options.type) params.set('type', options.type);\n    params.set('page', String(options.page ?? 1));\n    params.set('per_page', String(options.perPage ?? 30));\n    return this.get<PexelsCollectionMedia>(`/v1/collections/${collectionId}?${params}`);\n  }\n\n  // ---------- Internal ----------\n\n  private async get<T>(path: string): Promise<T> {\n    const url = `${API_URL}${path}`;\n    const res = await fetch(url, {\n      headers: { Authorization: this.apiKey },\n    });\n    if (!res.ok) {\n      const text = await res.text();\n      throw new Error(`Pexels API error ${res.status}: ${text}`);\n    }\n    return res.json() as Promise<T>;\n  }\n}\n","import type { IMediaProvider, MediaItem } from '@anymux/ui-kit/media';\nimport { PexelsClient } from './PexelsClient';\nimport type { PexelsPhoto, PexelsCollection, PexelsClientConfig } from './PexelsClient';\n\nfunction mapPhoto(photo: PexelsPhoto, albumName?: string): MediaItem {\n  const item: MediaItem = {\n    id: String(photo.id),\n    type: 'media',\n    title: photo.alt || `Photo by ${photo.photographer}`,\n    mediaType: 'photo',\n    url: photo.src.large2x,\n    thumbnail: photo.src.medium,\n    mimeType: 'image/jpeg',\n    width: photo.width,\n    height: photo.height,\n    createdAt: new Date(), // Pexels doesn't expose creation dates\n    updatedAt: new Date(),\n  };\n\n  if (photo.alt) {\n    item.description = photo.alt;\n  }\n\n  if (albumName) {\n    item.album = albumName;\n  }\n\n  return item;\n}\n\nexport class PexelsMediaProvider implements IMediaProvider {\n  private client: PexelsClient;\n  /** Cache of collection ID -> collection for resolving album names. */\n  private collectionCache = new Map<string, PexelsCollection>();\n\n  constructor(config: PexelsClientConfig) {\n    this.client = new PexelsClient(config);\n  }\n\n  // ---------- IObjectProvider<MediaItem> ----------\n\n  async listItems(): Promise<MediaItem[]> {\n    const result = await this.client.getCurated({ perPage: 30 });\n    return result.photos.map(p => mapPhoto(p));\n  }\n\n  async getItem(id: string): Promise<MediaItem | null> {\n    try {\n      const photo = await this.client.getPhoto(Number(id));\n      return mapPhoto(photo);\n    } catch {\n      return null;\n    }\n  }\n\n  async createItem(_item: Omit<MediaItem, 'id' | 'createdAt' | 'updatedAt'>): Promise<MediaItem> {\n    throw new Error('Pexels is a read-only photo library');\n  }\n\n  async updateItem(_id: string, _updates: Partial<MediaItem>): Promise<MediaItem> {\n    throw new Error('Pexels is a read-only photo library');\n  }\n\n  async deleteItem(_id: string): Promise<void> {\n    throw new Error('Pexels is a read-only photo library');\n  }\n\n  async search(query: string): Promise<MediaItem[]> {\n    const result = await this.client.searchPhotos({ query, perPage: 30 });\n    return result.photos.map(p => mapPhoto(p));\n  }\n\n  // ---------- IMediaProvider ----------\n\n  async getAlbums(): Promise<string[]> {\n    const result = await this.client.getFeaturedCollections({ perPage: 30 });\n    this.collectionCache.clear();\n    for (const c of result.collections) {\n      this.collectionCache.set(c.id, c);\n    }\n    return result.collections.map(c => c.title);\n  }\n\n  async getByAlbum(album: string): Promise<MediaItem[]> {\n    if (this.collectionCache.size === 0) await this.getAlbums();\n\n    let collectionId: string | undefined;\n    for (const [id, c] of this.collectionCache) {\n      if (c.title === album) {\n        collectionId = id;\n        break;\n      }\n    }\n    if (!collectionId) return [];\n\n    const result = await this.client.getCollectionMedia(collectionId, { type: 'photos', perPage: 30 });\n    return result.media\n      .filter((m): m is PexelsPhoto & { type: 'Photo' } => m.type === 'Photo')\n      .map(p => mapPhoto(p, album));\n  }\n\n  async getByDateRange(_start: Date, _end: Date): Promise<MediaItem[]> {\n    // Pexels doesn't support date range queries — return curated photos\n    const result = await this.client.getCurated({ perPage: 30 });\n    return result.photos.map(p => mapPhoto(p));\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@anymux/pexels",
+  "version": "0.1.0",
+  "type": "module",
+  "license": "MIT",
+  "description": "Pexels media provider adapter for AnyMux",
+  "keywords": [
+    "anymux",
+    "pexels",
+    "media",
+    "photos",
+    "stock-photos",
+    "videos"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AnyMux/AnyMuxMonorepo.git",
+    "directory": "packages/pexels"
+  },
+  "homepage": "https://github.com/AnyMux/AnyMuxMonorepo/tree/main/packages/pexels#readme",
+  "engines": {
+    "node": ">=20"
+  },
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "dependencies": {
+    "@anymux/ui-kit": "0.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "tsdown": "^0.10.2",
+    "typescript": "^5.7.3",
+    "@anymux/typescript-config": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "check": "tsc -p tsconfig.json --noEmit"
+  }
+}

package/src/PexelsClient.ts

@@ -0,0 +1,212 @@
+/**
+ * Low-level Pexels API client.
+ *
+ * Uses API key authentication for read-only access.
+ * All content is free to use under the Pexels license.
+ */
+
+const API_URL = 'https://api.pexels.com';
+
+// ---------- Response shapes ----------
+
+export interface PexelsPhoto {
+  id: number;
+  width: number;
+  height: number;
+  url: string;
+  photographer: string;
+  photographer_url: string;
+  photographer_id: number;
+  avg_color: string;
+  src: {
+    original: string;
+    large2x: string;
+    large: string;
+    medium: string;
+    small: string;
+    portrait: string;
+    landscape: string;
+    tiny: string;
+  };
+  liked: boolean;
+  alt: string;
+}
+
+export interface PexelsVideo {
+  id: number;
+  width: number;
+  height: number;
+  url: string;
+  image: string;
+  duration: number;
+  user: { id: number; name: string; url: string };
+  video_files: Array<{
+    id: number;
+    quality: string;
+    file_type: string;
+    width: number;
+    height: number;
+    link: string;
+  }>;
+  video_pictures: Array<{
+    id: number;
+    picture: string;
+    nr: number;
+  }>;
+}
+
+export interface PexelsCollection {
+  id: string;
+  title: string;
+  description: string | null;
+  private: boolean;
+  media_count: number;
+  photos_count: number;
+  videos_count: number;
+}
+
+export interface PexelsPaginatedPhotos {
+  total_results: number;
+  page: number;
+  per_page: number;
+  photos: PexelsPhoto[];
+  next_page?: string;
+}
+
+export interface PexelsPaginatedVideos {
+  total_results: number;
+  page: number;
+  per_page: number;
+  videos: PexelsVideo[];
+  next_page?: string;
+}
+
+export interface PexelsPaginatedCollections {
+  collections: PexelsCollection[];
+  page: number;
+  per_page: number;
+  total_results: number;
+  next_page?: string;
+}
+
+export interface PexelsCollectionMedia {
+  media: Array<PexelsPhoto & { type: 'Photo' } | PexelsVideo & { type: 'Video' }>;
+  page: number;
+  per_page: number;
+  total_results: number;
+  next_page?: string;
+}
+
+export interface PexelsClientConfig {
+  /** Pexels API key */
+  apiKey: string;
+}
+
+export class PexelsClient {
+  private apiKey: string;
+
+  constructor(config: PexelsClientConfig) {
+    this.apiKey = config.apiKey;
+  }
+
+  /** Search photos by query. */
+  async searchPhotos(options: {
+    query: string;
+    page?: number;
+    perPage?: number;
+    orientation?: 'landscape' | 'portrait' | 'square';
+    size?: 'large' | 'medium' | 'small';
+    color?: string;
+  }): Promise<PexelsPaginatedPhotos> {
+    const params = new URLSearchParams();
+    params.set('query', options.query);
+    params.set('page', String(options.page ?? 1));
+    params.set('per_page', String(options.perPage ?? 30));
+    if (options.orientation) params.set('orientation', options.orientation);
+    if (options.size) params.set('size', options.size);
+    if (options.color) params.set('color', options.color);
+    return this.get<PexelsPaginatedPhotos>(`/v1/search?${params}`);
+  }
+
+  /** Get curated editorial photos. */
+  async getCurated(options: {
+    page?: number;
+    perPage?: number;
+  } = {}): Promise<PexelsPaginatedPhotos> {
+    const params = new URLSearchParams();
+    params.set('page', String(options.page ?? 1));
+    params.set('per_page', String(options.perPage ?? 30));
+    return this.get<PexelsPaginatedPhotos>(`/v1/curated?${params}`);
+  }
+
+  /** Get a single photo by ID. */
+  async getPhoto(id: number): Promise<PexelsPhoto> {
+    return this.get<PexelsPhoto>(`/v1/photos/${id}`);
+  }
+
+  /** Search videos by query. */
+  async searchVideos(options: {
+    query: string;
+    page?: number;
+    perPage?: number;
+    orientation?: 'landscape' | 'portrait' | 'square';
+    size?: 'large' | 'medium' | 'small';
+  }): Promise<PexelsPaginatedVideos> {
+    const params = new URLSearchParams();
+    params.set('query', options.query);
+    params.set('page', String(options.page ?? 1));
+    params.set('per_page', String(options.perPage ?? 30));
+    if (options.orientation) params.set('orientation', options.orientation);
+    if (options.size) params.set('size', options.size);
+    return this.get<PexelsPaginatedVideos>(`/videos/search?${params}`);
+  }
+
+  /** Get popular videos. */
+  async getPopularVideos(options: {
+    page?: number;
+    perPage?: number;
+  } = {}): Promise<PexelsPaginatedVideos> {
+    const params = new URLSearchParams();
+    params.set('page', String(options.page ?? 1));
+    params.set('per_page', String(options.perPage ?? 30));
+    return this.get<PexelsPaginatedVideos>(`/videos/popular?${params}`);
+  }
+
+  /** List featured collections. */
+  async getFeaturedCollections(options: {
+    page?: number;
+    perPage?: number;
+  } = {}): Promise<PexelsPaginatedCollections> {
+    const params = new URLSearchParams();
+    params.set('page', String(options.page ?? 1));
+    params.set('per_page', String(options.perPage ?? 30));
+    return this.get<PexelsPaginatedCollections>(`/v1/collections/featured?${params}`);
+  }
+
+  /** Get media in a collection. */
+  async getCollectionMedia(collectionId: string, options: {
+    type?: 'photos' | 'videos';
+    page?: number;
+    perPage?: number;
+  } = {}): Promise<PexelsCollectionMedia> {
+    const params = new URLSearchParams();
+    if (options.type) params.set('type', options.type);
+    params.set('page', String(options.page ?? 1));
+    params.set('per_page', String(options.perPage ?? 30));
+    return this.get<PexelsCollectionMedia>(`/v1/collections/${collectionId}?${params}`);
+  }
+
+  // ---------- Internal ----------
+
+  private async get<T>(path: string): Promise<T> {
+    const url = `${API_URL}${path}`;
+    const res = await fetch(url, {
+      headers: { Authorization: this.apiKey },
+    });
+    if (!res.ok) {
+      const text = await res.text();
+      throw new Error(`Pexels API error ${res.status}: ${text}`);
+    }
+    return res.json() as Promise<T>;
+  }
+}

package/src/PexelsMediaProvider.ts

@@ -0,0 +1,107 @@
+import type { IMediaProvider, MediaItem } from '@anymux/ui-kit/media';
+import { PexelsClient } from './PexelsClient';
+import type { PexelsPhoto, PexelsCollection, PexelsClientConfig } from './PexelsClient';
+
+function mapPhoto(photo: PexelsPhoto, albumName?: string): MediaItem {
+  const item: MediaItem = {
+    id: String(photo.id),
+    type: 'media',
+    title: photo.alt || `Photo by ${photo.photographer}`,
+    mediaType: 'photo',
+    url: photo.src.large2x,
+    thumbnail: photo.src.medium,
+    mimeType: 'image/jpeg',
+    width: photo.width,
+    height: photo.height,
+    createdAt: new Date(), // Pexels doesn't expose creation dates
+    updatedAt: new Date(),
+  };
+
+  if (photo.alt) {
+    item.description = photo.alt;
+  }
+
+  if (albumName) {
+    item.album = albumName;
+  }
+
+  return item;
+}
+
+export class PexelsMediaProvider implements IMediaProvider {
+  private client: PexelsClient;
+  /** Cache of collection ID -> collection for resolving album names. */
+  private collectionCache = new Map<string, PexelsCollection>();
+
+  constructor(config: PexelsClientConfig) {
+    this.client = new PexelsClient(config);
+  }
+
+  // ---------- IObjectProvider<MediaItem> ----------
+
+  async listItems(): Promise<MediaItem[]> {
+    const result = await this.client.getCurated({ perPage: 30 });
+    return result.photos.map(p => mapPhoto(p));
+  }
+
+  async getItem(id: string): Promise<MediaItem | null> {
+    try {
+      const photo = await this.client.getPhoto(Number(id));
+      return mapPhoto(photo);
+    } catch {
+      return null;
+    }
+  }
+
+  async createItem(_item: Omit<MediaItem, 'id' | 'createdAt' | 'updatedAt'>): Promise<MediaItem> {
+    throw new Error('Pexels is a read-only photo library');
+  }
+
+  async updateItem(_id: string, _updates: Partial<MediaItem>): Promise<MediaItem> {
+    throw new Error('Pexels is a read-only photo library');
+  }
+
+  async deleteItem(_id: string): Promise<void> {
+    throw new Error('Pexels is a read-only photo library');
+  }
+
+  async search(query: string): Promise<MediaItem[]> {
+    const result = await this.client.searchPhotos({ query, perPage: 30 });
+    return result.photos.map(p => mapPhoto(p));
+  }
+
+  // ---------- IMediaProvider ----------
+
+  async getAlbums(): Promise<string[]> {
+    const result = await this.client.getFeaturedCollections({ perPage: 30 });
+    this.collectionCache.clear();
+    for (const c of result.collections) {
+      this.collectionCache.set(c.id, c);
+    }
+    return result.collections.map(c => c.title);
+  }
+
+  async getByAlbum(album: string): Promise<MediaItem[]> {
+    if (this.collectionCache.size === 0) await this.getAlbums();
+
+    let collectionId: string | undefined;
+    for (const [id, c] of this.collectionCache) {
+      if (c.title === album) {
+        collectionId = id;
+        break;
+      }
+    }
+    if (!collectionId) return [];
+
+    const result = await this.client.getCollectionMedia(collectionId, { type: 'photos', perPage: 30 });
+    return result.media
+      .filter((m): m is PexelsPhoto & { type: 'Photo' } => m.type === 'Photo')
+      .map(p => mapPhoto(p, album));
+  }
+
+  async getByDateRange(_start: Date, _end: Date): Promise<MediaItem[]> {
+    // Pexels doesn't support date range queries — return curated photos
+    const result = await this.client.getCurated({ perPage: 30 });
+    return result.photos.map(p => mapPhoto(p));
+  }
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+export { PexelsClient } from './PexelsClient';
+export type { PexelsClientConfig, PexelsPhoto, PexelsVideo, PexelsCollection, PexelsPaginatedPhotos, PexelsPaginatedVideos, PexelsPaginatedCollections, PexelsCollectionMedia } from './PexelsClient';
+export { PexelsMediaProvider } from './PexelsMediaProvider';