@anymux/imgur 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,146 @@
+import { IMediaProvider, MediaItem } from "@anymux/ui-kit/media";
+
+//#region src/ImgurClient.d.ts
+/**
+* Low-level Imgur API v3 client.
+*
+* Uses Client-ID authentication for public gallery access.
+* OAuth2 bearer tokens can be used for user-specific operations.
+*/
+/**
+ * Low-level Imgur API v3 client.
+ *
+ * Uses Client-ID authentication for public gallery access.
+ * OAuth2 bearer tokens can be used for user-specific operations.
+ */
+interface ImgurImage {
+  id: string;
+  title: string | null;
+  description: string | null;
+  datetime: number;
+  type: string;
+  animated: boolean;
+  width: number;
+  height: number;
+  size: number;
+  views: number;
+  bandwidth: number;
+  link: string;
+  mp4?: string;
+  gifv?: string;
+  mp4_size?: number;
+  nsfw: boolean | null;
+  section: string | null;
+  account_url: string | null;
+  account_id: number | null;
+  is_ad: boolean;
+  in_most_viral: boolean;
+  has_sound: boolean;
+  tags: Array<{
+    name: string;
+  }>;
+  favorite: boolean;
+}
+interface ImgurAlbum {
+  id: string;
+  title: string | null;
+  description: string | null;
+  datetime: number;
+  cover: string | null;
+  cover_width: number | null;
+  cover_height: number | null;
+  account_url: string | null;
+  account_id: number | null;
+  privacy: string;
+  layout: string;
+  views: number;
+  link: string;
+  images_count: number;
+  images?: ImgurImage[];
+}
+interface ImgurGalleryItem {
+  id: string;
+  title: string | null;
+  description: string | null;
+  datetime: number;
+  type?: string;
+  animated?: boolean;
+  width?: number;
+  height?: number;
+  size?: number;
+  views: number;
+  link: string;
+  is_album: boolean;
+  images_count?: number;
+  images?: ImgurImage[];
+  tags?: Array<{
+    name: string;
+  }>;
+  mp4?: string;
+}
+interface ImgurResponse<T> {
+  data: T;
+  success: boolean;
+  status: number;
+}
+interface ImgurClientConfig {
+  /** Imgur Client-ID for public API access */
+  clientId: string;
+  /** OAuth2 access token for user-specific operations (optional) */
+  accessToken?: string;
+}
+declare class ImgurClient {
+  private clientId;
+  private accessToken;
+  constructor(config: ImgurClientConfig);
+  /** Get image details by ID. */
+  getImage(imageId: string): Promise<ImgurImage>;
+  /** Get album details by ID. */
+  getAlbum(albumId: string): Promise<ImgurAlbum>;
+  /** Get images in an album. */
+  getAlbumImages(albumId: string): Promise<ImgurImage[]>;
+  /** Search the gallery. */
+  searchGallery(options: {
+    query: string;
+    sort?: 'time' | 'viral' | 'top';
+    window?: 'day' | 'week' | 'month' | 'year' | 'all';
+    page?: number;
+  }): Promise<ImgurGalleryItem[]>;
+  /** Get hot/viral gallery items. */
+  getGallery(options?: {
+    section?: 'hot' | 'top' | 'user';
+    sort?: 'viral' | 'top' | 'time' | 'rising';
+    window?: 'day' | 'week' | 'month' | 'year' | 'all';
+    page?: number;
+  }): Promise<ImgurGalleryItem[]>;
+  /** Get user's images (requires OAuth). */
+  getAccountImages(username?: string, page?: number): Promise<ImgurImage[]>;
+  /** Get user's albums (requires OAuth). */
+  getAccountAlbums(username?: string, page?: number): Promise<ImgurAlbum[]>;
+  /** Get user's favorites (requires OAuth). */
+  getAccountFavorites(username?: string, page?: number): Promise<ImgurGalleryItem[]>;
+  private get;
+} //#endregion
+//#region src/ImgurMediaProvider.d.ts
+
+//# sourceMappingURL=ImgurClient.d.ts.map
+declare class ImgurMediaProvider implements IMediaProvider {
+  private client;
+  private albumCache;
+  constructor(config: ImgurClientConfig);
+  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=ImgurMediaProvider.d.ts.map
+
+export { ImgurAlbum, ImgurClient, ImgurClientConfig, ImgurGalleryItem, ImgurImage, ImgurMediaProvider, ImgurResponse };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,199 @@
+//#region src/ImgurClient.ts
+/**
+* Low-level Imgur API v3 client.
+*
+* Uses Client-ID authentication for public gallery access.
+* OAuth2 bearer tokens can be used for user-specific operations.
+*/
+const API_URL = "https://api.imgur.com/3";
+var ImgurClient = class {
+	constructor(config) {
+		this.clientId = config.clientId;
+		this.accessToken = config.accessToken;
+	}
+	/** Get image details by ID. */
+	async getImage(imageId) {
+		const res = await this.get(`/image/${imageId}`);
+		return res.data;
+	}
+	/** Get album details by ID. */
+	async getAlbum(albumId) {
+		const res = await this.get(`/album/${albumId}`);
+		return res.data;
+	}
+	/** Get images in an album. */
+	async getAlbumImages(albumId) {
+		const res = await this.get(`/album/${albumId}/images`);
+		return res.data;
+	}
+	/** Search the gallery. */
+	async searchGallery(options) {
+		const sort = options.sort ?? "time";
+		const window = options.window ?? "all";
+		const page = options.page ?? 0;
+		const res = await this.get(`/gallery/search/${sort}/${window}/${page}?q=${encodeURIComponent(options.query)}`);
+		return res.data;
+	}
+	/** Get hot/viral gallery items. */
+	async getGallery(options = {}) {
+		const section = options.section ?? "hot";
+		const sort = options.sort ?? "viral";
+		const window = options.window ?? "day";
+		const page = options.page ?? 0;
+		const res = await this.get(`/gallery/${section}/${sort}/${window}/${page}`);
+		return res.data;
+	}
+	/** Get user's images (requires OAuth). */
+	async getAccountImages(username = "me", page = 0) {
+		const res = await this.get(`/account/${username}/images/${page}`);
+		return res.data;
+	}
+	/** Get user's albums (requires OAuth). */
+	async getAccountAlbums(username = "me", page = 0) {
+		const res = await this.get(`/account/${username}/albums/${page}`);
+		return res.data;
+	}
+	/** Get user's favorites (requires OAuth). */
+	async getAccountFavorites(username = "me", page = 0) {
+		const res = await this.get(`/account/${username}/favorites/${page}`);
+		return res.data;
+	}
+	async get(path) {
+		const url = `${API_URL}${path}`;
+		const headers = {};
+		if (this.accessToken) headers["Authorization"] = `Bearer ${this.accessToken}`;
+		else headers["Authorization"] = `Client-ID ${this.clientId}`;
+		const res = await fetch(url, { headers });
+		if (!res.ok) {
+			const text = await res.text();
+			throw new Error(`Imgur API error ${res.status}: ${text}`);
+		}
+		return res.json();
+	}
+};
+
+//#endregion
+//#region src/ImgurMediaProvider.ts
+function getMediaType(image) {
+	if (image.animated || image.mp4) return "video";
+	return "photo";
+}
+function getMimeType(image) {
+	if (image.mp4) return "video/mp4";
+	return image.type || "image/jpeg";
+}
+function getUrl(image) {
+	if (image.mp4) return image.mp4;
+	return image.link;
+}
+function getThumbnail(image) {
+	const link = image.link;
+	const lastDot = link.lastIndexOf(".");
+	if (lastDot === -1) return link;
+	return `${link.substring(0, lastDot)}m${link.substring(lastDot)}`;
+}
+function mapImage(image, albumName) {
+	const createdAt = new Date(image.datetime * 1e3);
+	const mediaType = getMediaType(image);
+	const item = {
+		id: image.id,
+		type: "media",
+		title: image.title || `Image ${image.id}`,
+		mediaType,
+		url: getUrl(image),
+		thumbnail: getThumbnail(image),
+		mimeType: getMimeType(image),
+		width: image.width,
+		height: image.height,
+		createdAt,
+		updatedAt: createdAt
+	};
+	if (image.description) item.description = image.description;
+	if (image.tags && image.tags.length > 0) item.tags = image.tags.map((t) => t.name);
+	if (albumName) item.album = albumName;
+	return item;
+}
+function mapGalleryItem(item) {
+	if (item.is_album && item.images) return item.images.map((img) => mapImage(img));
+	const createdAt = new Date(item.datetime * 1e3);
+	const mediaType = item.animated || item.mp4 ? "video" : "photo";
+	return [{
+		id: item.id,
+		type: "media",
+		title: item.title || `Image ${item.id}`,
+		mediaType,
+		url: item.mp4 || item.link,
+		thumbnail: item.link,
+		mimeType: item.mp4 ? "video/mp4" : item.type || "image/jpeg",
+		width: item.width,
+		height: item.height,
+		createdAt,
+		updatedAt: createdAt,
+		description: item.description ?? void 0,
+		tags: item.tags?.map((t) => t.name)
+	}];
+}
+var ImgurMediaProvider = class {
+	constructor(config) {
+		this.albumCache = new Map();
+		this.client = new ImgurClient(config);
+	}
+	async listItems() {
+		const items = await this.client.getGallery({
+			section: "hot",
+			sort: "viral",
+			page: 0
+		});
+		return items.flatMap(mapGalleryItem);
+	}
+	async getItem(id) {
+		try {
+			const image = await this.client.getImage(id);
+			return mapImage(image);
+		} catch {
+			return null;
+		}
+	}
+	async createItem(_item) {
+		throw new Error("Imgur upload requires OAuth2 authentication");
+	}
+	async updateItem(_id, _updates) {
+		throw new Error("Imgur does not support updating images via this API");
+	}
+	async deleteItem(_id) {
+		throw new Error("Imgur delete requires OAuth2 authentication");
+	}
+	async search(query) {
+		const items = await this.client.searchGallery({
+			query,
+			sort: "time"
+		});
+		return items.flatMap(mapGalleryItem);
+	}
+	async getAlbums() {
+		return [];
+	}
+	async getByAlbum(album) {
+		if (this.albumCache.size === 0) return [];
+		let albumId;
+		for (const [id, a] of this.albumCache) if (a.title === album) {
+			albumId = id;
+			break;
+		}
+		if (!albumId) return [];
+		const images = await this.client.getAlbumImages(albumId);
+		return images.map((img) => mapImage(img, album));
+	}
+	async getByDateRange(_start, _end) {
+		const items = await this.client.getGallery({
+			section: "hot",
+			sort: "time",
+			page: 0
+		});
+		return items.flatMap(mapGalleryItem);
+	}
+};
+
+//#endregion
+export { ImgurClient, ImgurMediaProvider };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["config: ImgurClientConfig","imageId: string","albumId: string","options: {\n    query: string;\n    sort?: 'time' | 'viral' | 'top';\n    window?: 'day' | 'week' | 'month' | 'year' | 'all';\n    page?: number;\n  }","options: {\n    section?: 'hot' | 'top' | 'user';\n    sort?: 'viral' | 'top' | 'time' | 'rising';\n    window?: 'day' | 'week' | 'month' | 'year' | 'all';\n    page?: number;\n  }","username: string","page: number","path: string","headers: Record<string, string>","image: ImgurImage","albumName?: string","item: MediaItem","item: ImgurGalleryItem","mediaType: MediaType","config: ImgurClientConfig","id: string","_item: Omit<MediaItem, 'id' | 'createdAt' | 'updatedAt'>","_id: string","_updates: Partial<MediaItem>","query: string","album: string","albumId: string | undefined","_start: Date","_end: Date"],"sources":["../src/ImgurClient.ts","../src/ImgurMediaProvider.ts"],"sourcesContent":["/**\n * Low-level Imgur API v3 client.\n *\n * Uses Client-ID authentication for public gallery access.\n * OAuth2 bearer tokens can be used for user-specific operations.\n */\n\nconst API_URL = 'https://api.imgur.com/3';\n\n// ---------- Response shapes ----------\n\nexport interface ImgurImage {\n  id: string;\n  title: string | null;\n  description: string | null;\n  datetime: number;\n  type: string;\n  animated: boolean;\n  width: number;\n  height: number;\n  size: number;\n  views: number;\n  bandwidth: number;\n  link: string;\n  mp4?: string;\n  gifv?: string;\n  mp4_size?: number;\n  nsfw: boolean | null;\n  section: string | null;\n  account_url: string | null;\n  account_id: number | null;\n  is_ad: boolean;\n  in_most_viral: boolean;\n  has_sound: boolean;\n  tags: Array<{ name: string }>;\n  favorite: boolean;\n}\n\nexport interface ImgurAlbum {\n  id: string;\n  title: string | null;\n  description: string | null;\n  datetime: number;\n  cover: string | null;\n  cover_width: number | null;\n  cover_height: number | null;\n  account_url: string | null;\n  account_id: number | null;\n  privacy: string;\n  layout: string;\n  views: number;\n  link: string;\n  images_count: number;\n  images?: ImgurImage[];\n}\n\nexport interface ImgurGalleryItem {\n  id: string;\n  title: string | null;\n  description: string | null;\n  datetime: number;\n  type?: string;\n  animated?: boolean;\n  width?: number;\n  height?: number;\n  size?: number;\n  views: number;\n  link: string;\n  is_album: boolean;\n  images_count?: number;\n  images?: ImgurImage[];\n  tags?: Array<{ name: string }>;\n  mp4?: string;\n}\n\nexport interface ImgurResponse<T> {\n  data: T;\n  success: boolean;\n  status: number;\n}\n\nexport interface ImgurClientConfig {\n  /** Imgur Client-ID for public API access */\n  clientId: string;\n  /** OAuth2 access token for user-specific operations (optional) */\n  accessToken?: string;\n}\n\nexport class ImgurClient {\n  private clientId: string;\n  private accessToken: string | undefined;\n\n  constructor(config: ImgurClientConfig) {\n    this.clientId = config.clientId;\n    this.accessToken = config.accessToken;\n  }\n\n  /** Get image details by ID. */\n  async getImage(imageId: string): Promise<ImgurImage> {\n    const res = await this.get<ImgurResponse<ImgurImage>>(`/image/${imageId}`);\n    return res.data;\n  }\n\n  /** Get album details by ID. */\n  async getAlbum(albumId: string): Promise<ImgurAlbum> {\n    const res = await this.get<ImgurResponse<ImgurAlbum>>(`/album/${albumId}`);\n    return res.data;\n  }\n\n  /** Get images in an album. */\n  async getAlbumImages(albumId: string): Promise<ImgurImage[]> {\n    const res = await this.get<ImgurResponse<ImgurImage[]>>(`/album/${albumId}/images`);\n    return res.data;\n  }\n\n  /** Search the gallery. */\n  async searchGallery(options: {\n    query: string;\n    sort?: 'time' | 'viral' | 'top';\n    window?: 'day' | 'week' | 'month' | 'year' | 'all';\n    page?: number;\n  }): Promise<ImgurGalleryItem[]> {\n    const sort = options.sort ?? 'time';\n    const window = options.window ?? 'all';\n    const page = options.page ?? 0;\n    const res = await this.get<ImgurResponse<ImgurGalleryItem[]>>(\n      `/gallery/search/${sort}/${window}/${page}?q=${encodeURIComponent(options.query)}`\n    );\n    return res.data;\n  }\n\n  /** Get hot/viral gallery items. */\n  async getGallery(options: {\n    section?: 'hot' | 'top' | 'user';\n    sort?: 'viral' | 'top' | 'time' | 'rising';\n    window?: 'day' | 'week' | 'month' | 'year' | 'all';\n    page?: number;\n  } = {}): Promise<ImgurGalleryItem[]> {\n    const section = options.section ?? 'hot';\n    const sort = options.sort ?? 'viral';\n    const window = options.window ?? 'day';\n    const page = options.page ?? 0;\n    const res = await this.get<ImgurResponse<ImgurGalleryItem[]>>(\n      `/gallery/${section}/${sort}/${window}/${page}`\n    );\n    return res.data;\n  }\n\n  /** Get user's images (requires OAuth). */\n  async getAccountImages(username: string = 'me', page: number = 0): Promise<ImgurImage[]> {\n    const res = await this.get<ImgurResponse<ImgurImage[]>>(`/account/${username}/images/${page}`);\n    return res.data;\n  }\n\n  /** Get user's albums (requires OAuth). */\n  async getAccountAlbums(username: string = 'me', page: number = 0): Promise<ImgurAlbum[]> {\n    const res = await this.get<ImgurResponse<ImgurAlbum[]>>(`/account/${username}/albums/${page}`);\n    return res.data;\n  }\n\n  /** Get user's favorites (requires OAuth). */\n  async getAccountFavorites(username: string = 'me', page: number = 0): Promise<ImgurGalleryItem[]> {\n    const res = await this.get<ImgurResponse<ImgurGalleryItem[]>>(`/account/${username}/favorites/${page}`);\n    return res.data;\n  }\n\n  // ---------- Internal ----------\n\n  private async get<T>(path: string): Promise<T> {\n    const url = `${API_URL}${path}`;\n    const headers: Record<string, string> = {};\n    if (this.accessToken) {\n      headers['Authorization'] = `Bearer ${this.accessToken}`;\n    } else {\n      headers['Authorization'] = `Client-ID ${this.clientId}`;\n    }\n    const res = await fetch(url, { headers });\n    if (!res.ok) {\n      const text = await res.text();\n      throw new Error(`Imgur API error ${res.status}: ${text}`);\n    }\n    return res.json() as Promise<T>;\n  }\n}\n","import type { IMediaProvider, MediaItem, MediaType } from '@anymux/ui-kit/media';\nimport { ImgurClient } from './ImgurClient';\nimport type { ImgurImage, ImgurGalleryItem, ImgurAlbum, ImgurClientConfig } from './ImgurClient';\n\nfunction getMediaType(image: ImgurImage): MediaType {\n  if (image.animated || image.mp4) return 'video';\n  return 'photo';\n}\n\nfunction getMimeType(image: ImgurImage): string {\n  if (image.mp4) return 'video/mp4';\n  return image.type || 'image/jpeg';\n}\n\nfunction getUrl(image: ImgurImage): string {\n  if (image.mp4) return image.mp4;\n  return image.link;\n}\n\nfunction getThumbnail(image: ImgurImage): string {\n  // Imgur thumbnail convention: insert size suffix before extension\n  // l = large thumbnail (640x640), m = medium (320x320), t = small (160x160), s = small square (90x90)\n  const link = image.link;\n  const lastDot = link.lastIndexOf('.');\n  if (lastDot === -1) return link;\n  return `${link.substring(0, lastDot)}m${link.substring(lastDot)}`;\n}\n\nfunction mapImage(image: ImgurImage, albumName?: string): MediaItem {\n  const createdAt = new Date(image.datetime * 1000);\n  const mediaType = getMediaType(image);\n\n  const item: MediaItem = {\n    id: image.id,\n    type: 'media',\n    title: image.title || `Image ${image.id}`,\n    mediaType,\n    url: getUrl(image),\n    thumbnail: getThumbnail(image),\n    mimeType: getMimeType(image),\n    width: image.width,\n    height: image.height,\n    createdAt,\n    updatedAt: createdAt,\n  };\n\n  if (image.description) {\n    item.description = image.description;\n  }\n\n  if (image.tags && image.tags.length > 0) {\n    item.tags = image.tags.map(t => t.name);\n  }\n\n  if (albumName) {\n    item.album = albumName;\n  }\n\n  return item;\n}\n\nfunction mapGalleryItem(item: ImgurGalleryItem): MediaItem[] {\n  // Gallery items can be albums or single images\n  if (item.is_album && item.images) {\n    return item.images.map(img => mapImage(img));\n  }\n  // Single image in gallery\n  const createdAt = new Date(item.datetime * 1000);\n  const mediaType: MediaType = item.animated || item.mp4 ? 'video' : 'photo';\n\n  return [{\n    id: item.id,\n    type: 'media',\n    title: item.title || `Image ${item.id}`,\n    mediaType,\n    url: item.mp4 || item.link,\n    thumbnail: item.link, // Gallery items don't have thumbnail suffix easily\n    mimeType: item.mp4 ? 'video/mp4' : item.type || 'image/jpeg',\n    width: item.width,\n    height: item.height,\n    createdAt,\n    updatedAt: createdAt,\n    description: item.description ?? undefined,\n    tags: item.tags?.map(t => t.name),\n  }];\n}\n\nexport class ImgurMediaProvider implements IMediaProvider {\n  private client: ImgurClient;\n  private albumCache = new Map<string, ImgurAlbum>();\n\n  constructor(config: ImgurClientConfig) {\n    this.client = new ImgurClient(config);\n  }\n\n  // ---------- IObjectProvider<MediaItem> ----------\n\n  async listItems(): Promise<MediaItem[]> {\n    const items = await this.client.getGallery({ section: 'hot', sort: 'viral', page: 0 });\n    return items.flatMap(mapGalleryItem);\n  }\n\n  async getItem(id: string): Promise<MediaItem | null> {\n    try {\n      const image = await this.client.getImage(id);\n      return mapImage(image);\n    } catch {\n      return null;\n    }\n  }\n\n  async createItem(_item: Omit<MediaItem, 'id' | 'createdAt' | 'updatedAt'>): Promise<MediaItem> {\n    throw new Error('Imgur upload requires OAuth2 authentication');\n  }\n\n  async updateItem(_id: string, _updates: Partial<MediaItem>): Promise<MediaItem> {\n    throw new Error('Imgur does not support updating images via this API');\n  }\n\n  async deleteItem(_id: string): Promise<void> {\n    throw new Error('Imgur delete requires OAuth2 authentication');\n  }\n\n  async search(query: string): Promise<MediaItem[]> {\n    const items = await this.client.searchGallery({ query, sort: 'time' });\n    return items.flatMap(mapGalleryItem);\n  }\n\n  // ---------- IMediaProvider ----------\n\n  async getAlbums(): Promise<string[]> {\n    // With Client-ID only, we can't list user albums\n    // Return empty list — user needs OAuth for personal albums\n    return [];\n  }\n\n  async getByAlbum(album: string): Promise<MediaItem[]> {\n    if (this.albumCache.size === 0) return [];\n\n    let albumId: string | undefined;\n    for (const [id, a] of this.albumCache) {\n      if (a.title === album) {\n        albumId = id;\n        break;\n      }\n    }\n    if (!albumId) return [];\n\n    const images = await this.client.getAlbumImages(albumId);\n    return images.map(img => mapImage(img, album));\n  }\n\n  async getByDateRange(_start: Date, _end: Date): Promise<MediaItem[]> {\n    // Imgur doesn't support date range queries — return hot gallery\n    const items = await this.client.getGallery({ section: 'hot', sort: 'time', page: 0 });\n    return items.flatMap(mapGalleryItem);\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@anymux/imgur",
+  "version": "0.1.0",
+  "type": "module",
+  "license": "MIT",
+  "description": "Imgur media provider adapter for AnyMux",
+  "keywords": [
+    "anymux",
+    "imgur",
+    "media",
+    "photos",
+    "image-hosting"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AnyMux/AnyMuxMonorepo.git",
+    "directory": "packages/imgur"
+  },
+  "homepage": "https://github.com/AnyMux/AnyMuxMonorepo/tree/main/packages/imgur#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/ImgurClient.ts

@@ -0,0 +1,184 @@
+/**
+ * Low-level Imgur API v3 client.
+ *
+ * Uses Client-ID authentication for public gallery access.
+ * OAuth2 bearer tokens can be used for user-specific operations.
+ */
+
+const API_URL = 'https://api.imgur.com/3';
+
+// ---------- Response shapes ----------
+
+export interface ImgurImage {
+  id: string;
+  title: string | null;
+  description: string | null;
+  datetime: number;
+  type: string;
+  animated: boolean;
+  width: number;
+  height: number;
+  size: number;
+  views: number;
+  bandwidth: number;
+  link: string;
+  mp4?: string;
+  gifv?: string;
+  mp4_size?: number;
+  nsfw: boolean | null;
+  section: string | null;
+  account_url: string | null;
+  account_id: number | null;
+  is_ad: boolean;
+  in_most_viral: boolean;
+  has_sound: boolean;
+  tags: Array<{ name: string }>;
+  favorite: boolean;
+}
+
+export interface ImgurAlbum {
+  id: string;
+  title: string | null;
+  description: string | null;
+  datetime: number;
+  cover: string | null;
+  cover_width: number | null;
+  cover_height: number | null;
+  account_url: string | null;
+  account_id: number | null;
+  privacy: string;
+  layout: string;
+  views: number;
+  link: string;
+  images_count: number;
+  images?: ImgurImage[];
+}
+
+export interface ImgurGalleryItem {
+  id: string;
+  title: string | null;
+  description: string | null;
+  datetime: number;
+  type?: string;
+  animated?: boolean;
+  width?: number;
+  height?: number;
+  size?: number;
+  views: number;
+  link: string;
+  is_album: boolean;
+  images_count?: number;
+  images?: ImgurImage[];
+  tags?: Array<{ name: string }>;
+  mp4?: string;
+}
+
+export interface ImgurResponse<T> {
+  data: T;
+  success: boolean;
+  status: number;
+}
+
+export interface ImgurClientConfig {
+  /** Imgur Client-ID for public API access */
+  clientId: string;
+  /** OAuth2 access token for user-specific operations (optional) */
+  accessToken?: string;
+}
+
+export class ImgurClient {
+  private clientId: string;
+  private accessToken: string | undefined;
+
+  constructor(config: ImgurClientConfig) {
+    this.clientId = config.clientId;
+    this.accessToken = config.accessToken;
+  }
+
+  /** Get image details by ID. */
+  async getImage(imageId: string): Promise<ImgurImage> {
+    const res = await this.get<ImgurResponse<ImgurImage>>(`/image/${imageId}`);
+    return res.data;
+  }
+
+  /** Get album details by ID. */
+  async getAlbum(albumId: string): Promise<ImgurAlbum> {
+    const res = await this.get<ImgurResponse<ImgurAlbum>>(`/album/${albumId}`);
+    return res.data;
+  }
+
+  /** Get images in an album. */
+  async getAlbumImages(albumId: string): Promise<ImgurImage[]> {
+    const res = await this.get<ImgurResponse<ImgurImage[]>>(`/album/${albumId}/images`);
+    return res.data;
+  }
+
+  /** Search the gallery. */
+  async searchGallery(options: {
+    query: string;
+    sort?: 'time' | 'viral' | 'top';
+    window?: 'day' | 'week' | 'month' | 'year' | 'all';
+    page?: number;
+  }): Promise<ImgurGalleryItem[]> {
+    const sort = options.sort ?? 'time';
+    const window = options.window ?? 'all';
+    const page = options.page ?? 0;
+    const res = await this.get<ImgurResponse<ImgurGalleryItem[]>>(
+      `/gallery/search/${sort}/${window}/${page}?q=${encodeURIComponent(options.query)}`
+    );
+    return res.data;
+  }
+
+  /** Get hot/viral gallery items. */
+  async getGallery(options: {
+    section?: 'hot' | 'top' | 'user';
+    sort?: 'viral' | 'top' | 'time' | 'rising';
+    window?: 'day' | 'week' | 'month' | 'year' | 'all';
+    page?: number;
+  } = {}): Promise<ImgurGalleryItem[]> {
+    const section = options.section ?? 'hot';
+    const sort = options.sort ?? 'viral';
+    const window = options.window ?? 'day';
+    const page = options.page ?? 0;
+    const res = await this.get<ImgurResponse<ImgurGalleryItem[]>>(
+      `/gallery/${section}/${sort}/${window}/${page}`
+    );
+    return res.data;
+  }
+
+  /** Get user's images (requires OAuth). */
+  async getAccountImages(username: string = 'me', page: number = 0): Promise<ImgurImage[]> {
+    const res = await this.get<ImgurResponse<ImgurImage[]>>(`/account/${username}/images/${page}`);
+    return res.data;
+  }
+
+  /** Get user's albums (requires OAuth). */
+  async getAccountAlbums(username: string = 'me', page: number = 0): Promise<ImgurAlbum[]> {
+    const res = await this.get<ImgurResponse<ImgurAlbum[]>>(`/account/${username}/albums/${page}`);
+    return res.data;
+  }
+
+  /** Get user's favorites (requires OAuth). */
+  async getAccountFavorites(username: string = 'me', page: number = 0): Promise<ImgurGalleryItem[]> {
+    const res = await this.get<ImgurResponse<ImgurGalleryItem[]>>(`/account/${username}/favorites/${page}`);
+    return res.data;
+  }
+
+  // ---------- Internal ----------
+
+  private async get<T>(path: string): Promise<T> {
+    const url = `${API_URL}${path}`;
+    const headers: Record<string, string> = {};
+    if (this.accessToken) {
+      headers['Authorization'] = `Bearer ${this.accessToken}`;
+    } else {
+      headers['Authorization'] = `Client-ID ${this.clientId}`;
+    }
+    const res = await fetch(url, { headers });
+    if (!res.ok) {
+      const text = await res.text();
+      throw new Error(`Imgur API error ${res.status}: ${text}`);
+    }
+    return res.json() as Promise<T>;
+  }
+}

package/src/ImgurMediaProvider.ts

@@ -0,0 +1,158 @@
+import type { IMediaProvider, MediaItem, MediaType } from '@anymux/ui-kit/media';
+import { ImgurClient } from './ImgurClient';
+import type { ImgurImage, ImgurGalleryItem, ImgurAlbum, ImgurClientConfig } from './ImgurClient';
+
+function getMediaType(image: ImgurImage): MediaType {
+  if (image.animated || image.mp4) return 'video';
+  return 'photo';
+}
+
+function getMimeType(image: ImgurImage): string {
+  if (image.mp4) return 'video/mp4';
+  return image.type || 'image/jpeg';
+}
+
+function getUrl(image: ImgurImage): string {
+  if (image.mp4) return image.mp4;
+  return image.link;
+}
+
+function getThumbnail(image: ImgurImage): string {
+  // Imgur thumbnail convention: insert size suffix before extension
+  // l = large thumbnail (640x640), m = medium (320x320), t = small (160x160), s = small square (90x90)
+  const link = image.link;
+  const lastDot = link.lastIndexOf('.');
+  if (lastDot === -1) return link;
+  return `${link.substring(0, lastDot)}m${link.substring(lastDot)}`;
+}
+
+function mapImage(image: ImgurImage, albumName?: string): MediaItem {
+  const createdAt = new Date(image.datetime * 1000);
+  const mediaType = getMediaType(image);
+
+  const item: MediaItem = {
+    id: image.id,
+    type: 'media',
+    title: image.title || `Image ${image.id}`,
+    mediaType,
+    url: getUrl(image),
+    thumbnail: getThumbnail(image),
+    mimeType: getMimeType(image),
+    width: image.width,
+    height: image.height,
+    createdAt,
+    updatedAt: createdAt,
+  };
+
+  if (image.description) {
+    item.description = image.description;
+  }
+
+  if (image.tags && image.tags.length > 0) {
+    item.tags = image.tags.map(t => t.name);
+  }
+
+  if (albumName) {
+    item.album = albumName;
+  }
+
+  return item;
+}
+
+function mapGalleryItem(item: ImgurGalleryItem): MediaItem[] {
+  // Gallery items can be albums or single images
+  if (item.is_album && item.images) {
+    return item.images.map(img => mapImage(img));
+  }
+  // Single image in gallery
+  const createdAt = new Date(item.datetime * 1000);
+  const mediaType: MediaType = item.animated || item.mp4 ? 'video' : 'photo';
+
+  return [{
+    id: item.id,
+    type: 'media',
+    title: item.title || `Image ${item.id}`,
+    mediaType,
+    url: item.mp4 || item.link,
+    thumbnail: item.link, // Gallery items don't have thumbnail suffix easily
+    mimeType: item.mp4 ? 'video/mp4' : item.type || 'image/jpeg',
+    width: item.width,
+    height: item.height,
+    createdAt,
+    updatedAt: createdAt,
+    description: item.description ?? undefined,
+    tags: item.tags?.map(t => t.name),
+  }];
+}
+
+export class ImgurMediaProvider implements IMediaProvider {
+  private client: ImgurClient;
+  private albumCache = new Map<string, ImgurAlbum>();
+
+  constructor(config: ImgurClientConfig) {
+    this.client = new ImgurClient(config);
+  }
+
+  // ---------- IObjectProvider<MediaItem> ----------
+
+  async listItems(): Promise<MediaItem[]> {
+    const items = await this.client.getGallery({ section: 'hot', sort: 'viral', page: 0 });
+    return items.flatMap(mapGalleryItem);
+  }
+
+  async getItem(id: string): Promise<MediaItem | null> {
+    try {
+      const image = await this.client.getImage(id);
+      return mapImage(image);
+    } catch {
+      return null;
+    }
+  }
+
+  async createItem(_item: Omit<MediaItem, 'id' | 'createdAt' | 'updatedAt'>): Promise<MediaItem> {
+    throw new Error('Imgur upload requires OAuth2 authentication');
+  }
+
+  async updateItem(_id: string, _updates: Partial<MediaItem>): Promise<MediaItem> {
+    throw new Error('Imgur does not support updating images via this API');
+  }
+
+  async deleteItem(_id: string): Promise<void> {
+    throw new Error('Imgur delete requires OAuth2 authentication');
+  }
+
+  async search(query: string): Promise<MediaItem[]> {
+    const items = await this.client.searchGallery({ query, sort: 'time' });
+    return items.flatMap(mapGalleryItem);
+  }
+
+  // ---------- IMediaProvider ----------
+
+  async getAlbums(): Promise<string[]> {
+    // With Client-ID only, we can't list user albums
+    // Return empty list — user needs OAuth for personal albums
+    return [];
+  }
+
+  async getByAlbum(album: string): Promise<MediaItem[]> {
+    if (this.albumCache.size === 0) return [];
+
+    let albumId: string | undefined;
+    for (const [id, a] of this.albumCache) {
+      if (a.title === album) {
+        albumId = id;
+        break;
+      }
+    }
+    if (!albumId) return [];
+
+    const images = await this.client.getAlbumImages(albumId);
+    return images.map(img => mapImage(img, album));
+  }
+
+  async getByDateRange(_start: Date, _end: Date): Promise<MediaItem[]> {
+    // Imgur doesn't support date range queries — return hot gallery
+    const items = await this.client.getGallery({ section: 'hot', sort: 'time', page: 0 });
+    return items.flatMap(mapGalleryItem);
+  }
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+export { ImgurClient } from './ImgurClient';
+export type { ImgurClientConfig, ImgurImage, ImgurAlbum, ImgurGalleryItem, ImgurResponse } from './ImgurClient';
+export { ImgurMediaProvider } from './ImgurMediaProvider';