@anymux/unsplash 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,137 @@
+import { IMediaProvider, MediaItem } from "@anymux/ui-kit/media";
+
+//#region src/UnsplashClient.d.ts
+/**
+* Low-level Unsplash API client.
+*
+* Uses the public Client-ID authentication for read-only access.
+* All photos are free to use under the Unsplash License.
+*/
+/**
+ * Low-level Unsplash API client.
+ *
+ * Uses the public Client-ID authentication for read-only access.
+ * All photos are free to use under the Unsplash License.
+ */
+interface UnsplashPhoto {
+  id: string;
+  created_at: string;
+  updated_at: string;
+  width: number;
+  height: number;
+  color: string;
+  blur_hash: string | null;
+  description: string | null;
+  alt_description: string | null;
+  urls: {
+    raw: string;
+    full: string;
+    regular: string;
+    small: string;
+    thumb: string;
+  };
+  links: {
+    self: string;
+    html: string;
+    download: string;
+    download_location: string;
+  };
+  user: {
+    id: string;
+    username: string;
+    name: string;
+    portfolio_url: string | null;
+    profile_image: {
+      small: string;
+      medium: string;
+      large: string;
+    };
+    links: {
+      html: string;
+    };
+  };
+  tags?: Array<{
+    title: string;
+  }>;
+}
+interface UnsplashCollection {
+  id: string;
+  title: string;
+  description: string | null;
+  published_at: string;
+  updated_at: string;
+  total_photos: number;
+  cover_photo: UnsplashPhoto | null;
+  user: UnsplashPhoto['user'];
+}
+interface UnsplashSearchResult<T> {
+  total: number;
+  total_pages: number;
+  results: T[];
+}
+interface UnsplashClientConfig {
+  /** Unsplash API access key (Client-ID) */
+  accessKey: string;
+}
+declare class UnsplashClient {
+  private accessKey;
+  constructor(config: UnsplashClientConfig);
+  /** List editorial photos. */
+  listPhotos(options?: {
+    page?: number;
+    perPage?: number;
+    orderBy?: 'latest' | 'oldest' | 'popular';
+  }): Promise<UnsplashPhoto[]>;
+  /** Get a single photo by ID. */
+  getPhoto(id: string): Promise<UnsplashPhoto>;
+  /** Search photos by query. */
+  searchPhotos(options: {
+    query: string;
+    page?: number;
+    perPage?: number;
+    orderBy?: 'relevant' | 'latest';
+    orientation?: 'landscape' | 'portrait' | 'squarish';
+    color?: string;
+  }): Promise<UnsplashSearchResult<UnsplashPhoto>>;
+  /** List collections. */
+  listCollections(options?: {
+    page?: number;
+    perPage?: number;
+  }): Promise<UnsplashCollection[]>;
+  /** Get photos in a collection. */
+  getCollectionPhotos(collectionId: string, options?: {
+    page?: number;
+    perPage?: number;
+  }): Promise<UnsplashPhoto[]>;
+  /** Search collections by query. */
+  searchCollections(options: {
+    query: string;
+    page?: number;
+    perPage?: number;
+  }): Promise<UnsplashSearchResult<UnsplashCollection>>;
+  private get;
+} //#endregion
+//#region src/UnsplashMediaProvider.d.ts
+
+//# sourceMappingURL=UnsplashClient.d.ts.map
+declare class UnsplashMediaProvider implements IMediaProvider {
+  private client;
+  /** Cache of collection ID -> collection for resolving album names. */
+  private collectionCache;
+  constructor(config: UnsplashClientConfig);
+  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=UnsplashMediaProvider.d.ts.map
+
+export { UnsplashClient, UnsplashClientConfig, UnsplashCollection, UnsplashMediaProvider, UnsplashPhoto, UnsplashSearchResult };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/UnsplashClient.ts","../src/UnsplashMediaProvider.ts"],"sourcesContent":null,"mappings":";;;;;;;;;;;;;;;UAWiB,aAAA;;;EAAA,UAAA,EAAA,MAAa;EAkCb,KAAA,EAAA,MAAA;EAAkB,MAAA,EAAA,MAAA;EAAA,KAOpB,EAAA,MAAA;EAAa,SACpB,EAAA,MAAA,GAAA,IAAA;EAAa,WAAA,EAAA,MAAA,GAAA,IAAA;EAGJ,eAAA,EAAA,MAAoB,GAAA,IAAA;EAMpB,IAAA,EAAA;IAKJ,GAAA,EAAA,MAAA;IAAc,IAAA,EAAA,MAAA;IAGL,OAAA,EAAA,MAAA;IASH,KAAA,EAAA,MAAA;IAAR,KAAA,EAAA,MAAA;EAAO,CAAA;EASiC,KAArB,EAAA;IAYK,IAAA,EAAA,MAAA;IAArB,IAAA,EAAA,MAAA;IAAR,QAAA,EAAA,MAAA;IAea,iBAAA,EAAA,MAAA;EAAkB,CAAA;EAAnB,IAWC,EAAA;IAAR,EAAA,EAAA,MAAA;IAYwB,QAAA,EAAA,MAAA;IAArB,IAAA,EAAA,MAAA;IAAR,aAAA,EAAA,MAAA,GAAA,IAAA;IAAO,aAAA,EAAA;;;;ICvGA,CAAA;IAAsB,KAAA,EAAA;MAKb,IAAA,EAAA,MAAA;IAMO,CAAA;EAAS,CAAA;EAAV,IAKS,CAAA,EDT5B,KCS4B,CAAA;IAAR,KAAA,EAAA,MAAA;EAAO,CAAA,CAAA;;AASkD,UDfrE,kBAAA,CCeqE;EAAS,EAAA,EAAjB,MAAA;EAAO,KAInC,EAAA,MAAA;EAAS,WAAjB,EAAA,MAAA,GAAA,IAAA;EAAO,YAAsB,EAAA,MAAA;EAAS,UAAjB,EAAA,MAAA;EAAO,YAIrC,EAAA,MAAA;EAAO,WAID,EDpBxB,aCoBwB,GAAA,IAAA;EAAS,IAAjB,EDnBvB,aCmBuB,CAAA,MAAA,CAAA;;AAgBY,UDhC1B,oBCgC0B,CAAA,CAAA,CAAA,CAAA;EAAS,KAAjB,EAAA,MAAA;EAAO,WAgBZ,EAAA,MAAA;EAAI,OAAO,ED7C9B,CC6C8B,EAAA;;AAAO,UD1C/B,oBAAA,CC0C+B;EAAO;EArEK,SAAA,EAAA,MAAA;;cDgC/C,cAAA;;sBAGS;;;;;;MASX,QAAQ;;wBASW,QAAQ;;;;;;;;;MAYhC,QAAQ,qBAAqB;;;;;MAexB,QAAQ;;;;;MAWR,QAAQ;;;;;;MAYb,QAAQ,qBAAqB;;;;;;cCvGtB,qBAAA,YAAiC;;;;sBAKxB;eAMD,QAAQ;uBAKA,QAAQ;EDxCpB,UAAA,CAAA,KAAa,ECiDJ,IDjDI,CCiDC,SDlBjB,EAAA,IAAA,GAAA,WAAA,GAAA,WAAA,CAAA,CAAA,ECkBgE,ODlBhE,CCkBwE,SDlBxE,CAAA;EAGG,UAAA,CAAA,GAAA,EAAA,MAAkB,EAAA,QAAA,ECmBO,ODnBP,CCmBe,SDnBf,CAAA,CAAA,ECmB4B,ODnB5B,CCmBoC,SDnBpC,CAAA;EAAA,UAAA,CAAA,GAAA,EAAA,MAAA,CAAA,ECuBF,ODvBE,CAAA,IAAA,CAAA;EAAA,MAOpB,CAAA,KAAA,EAAA,MAAA,CAAA,ECoBgB,ODpBhB,CCoBwB,SDpBxB,EAAA,CAAA;EAAa,SACpB,CAAA,CAAA,EC0Ba,OD1Bb,CAAA,MAAA,EAAA,CAAA;EAAa,UAAA,CAAA,KAAA,EAAA,MAAA,CAAA,ECmCc,ODnCd,CCmCsB,SDnCtB,EAAA,CAAA;EAGJ,cAAA,CAAA,KAAA,ECgDa,IDhDO,EAAA,GAAA,ECgDI,ID7C7B,CAAA,EC6CoC,OD7CpC,CC6C4C,SD7C5C,EAAA,CAAA;AAGZ;;;AAKA"}

package/dist/index.js

@@ -0,0 +1,158 @@
+//#region src/UnsplashClient.ts
+/**
+* Low-level Unsplash API client.
+*
+* Uses the public Client-ID authentication for read-only access.
+* All photos are free to use under the Unsplash License.
+*/
+const API_URL = "https://api.unsplash.com";
+var UnsplashClient = class {
+	constructor(config) {
+		this.accessKey = config.accessKey;
+	}
+	/** List editorial photos. */
+	async listPhotos(options = {}) {
+		const params = new URLSearchParams();
+		params.set("page", String(options.page ?? 1));
+		params.set("per_page", String(options.perPage ?? 30));
+		if (options.orderBy) params.set("order_by", options.orderBy);
+		return this.get(`/photos?${params}`);
+	}
+	/** Get a single photo by ID. */
+	async getPhoto(id) {
+		return this.get(`/photos/${id}`);
+	}
+	/** 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.orderBy) params.set("order_by", options.orderBy);
+		if (options.orientation) params.set("orientation", options.orientation);
+		if (options.color) params.set("color", options.color);
+		return this.get(`/search/photos?${params}`);
+	}
+	/** List collections. */
+	async listCollections(options = {}) {
+		const params = new URLSearchParams();
+		params.set("page", String(options.page ?? 1));
+		params.set("per_page", String(options.perPage ?? 30));
+		return this.get(`/collections?${params}`);
+	}
+	/** Get photos in a collection. */
+	async getCollectionPhotos(collectionId, options = {}) {
+		const params = new URLSearchParams();
+		params.set("page", String(options.page ?? 1));
+		params.set("per_page", String(options.perPage ?? 30));
+		return this.get(`/collections/${collectionId}/photos?${params}`);
+	}
+	/** Search collections by query. */
+	async searchCollections(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));
+		return this.get(`/search/collections?${params}`);
+	}
+	async get(path) {
+		const url = `${API_URL}${path}`;
+		const res = await fetch(url, { headers: {
+			Authorization: `Client-ID ${this.accessKey}`,
+			"Accept-Version": "v1"
+		} });
+		if (!res.ok) {
+			const text = await res.text();
+			throw new Error(`Unsplash API error ${res.status}: ${text}`);
+		}
+		return res.json();
+	}
+};
+
+//#endregion
+//#region src/UnsplashMediaProvider.ts
+function mapPhoto(photo, albumName) {
+	const createdAt = new Date(photo.created_at);
+	const item = {
+		id: photo.id,
+		type: "media",
+		title: photo.description || photo.alt_description || `Photo ${photo.id}`,
+		mediaType: "photo",
+		url: photo.urls.regular,
+		thumbnail: photo.urls.small,
+		mimeType: "image/jpeg",
+		width: photo.width,
+		height: photo.height,
+		createdAt,
+		updatedAt: new Date(photo.updated_at)
+	};
+	if (photo.description) item.description = photo.description;
+	if (photo.tags && photo.tags.length > 0) item.tags = photo.tags.map((t) => t.title);
+	if (albumName) item.album = albumName;
+	return item;
+}
+var UnsplashMediaProvider = class {
+	constructor(config) {
+		this.collectionCache = new Map();
+		this.client = new UnsplashClient(config);
+	}
+	async listItems() {
+		const photos = await this.client.listPhotos({ perPage: 30 });
+		return photos.map((p) => mapPhoto(p));
+	}
+	async getItem(id) {
+		try {
+			const photo = await this.client.getPhoto(id);
+			return mapPhoto(photo);
+		} catch {
+			return null;
+		}
+	}
+	async createItem(_item) {
+		throw new Error("Unsplash is a read-only photo library");
+	}
+	async updateItem(_id, _updates) {
+		throw new Error("Unsplash is a read-only photo library");
+	}
+	async deleteItem(_id) {
+		throw new Error("Unsplash is a read-only photo library");
+	}
+	async search(query) {
+		const result = await this.client.searchPhotos({
+			query,
+			perPage: 30
+		});
+		return result.results.map((p) => mapPhoto(p));
+	}
+	async getAlbums() {
+		const collections = await this.client.listCollections({ perPage: 30 });
+		this.collectionCache.clear();
+		for (const c of collections) this.collectionCache.set(c.id, c);
+		return 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 photos = await this.client.getCollectionPhotos(collectionId, { perPage: 30 });
+		return photos.map((p) => mapPhoto(p, album));
+	}
+	async getByDateRange(start, end) {
+		const photos = await this.client.listPhotos({
+			perPage: 30,
+			orderBy: "latest"
+		});
+		return photos.filter((p) => {
+			const d = new Date(p.created_at);
+			return d >= start && d <= end;
+		}).map((p) => mapPhoto(p));
+	}
+};
+
+//#endregion
+export { UnsplashClient, UnsplashMediaProvider };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["config: UnsplashClientConfig","options: {\n    page?: number;\n    perPage?: number;\n    orderBy?: 'latest' | 'oldest' | 'popular';\n  }","id: string","options: {\n    query: string;\n    page?: number;\n    perPage?: number;\n    orderBy?: 'relevant' | 'latest';\n    orientation?: 'landscape' | 'portrait' | 'squarish';\n    color?: string;\n  }","options: {\n    page?: number;\n    perPage?: number;\n  }","collectionId: string","options: {\n    query: string;\n    page?: number;\n    perPage?: number;\n  }","path: string","photo: UnsplashPhoto","albumName?: string","item: MediaItem","config: UnsplashClientConfig","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/UnsplashClient.ts","../src/UnsplashMediaProvider.ts"],"sourcesContent":["/**\n * Low-level Unsplash API client.\n *\n * Uses the public Client-ID authentication for read-only access.\n * All photos are free to use under the Unsplash License.\n */\n\nconst API_URL = 'https://api.unsplash.com';\n\n// ---------- Response shapes ----------\n\nexport interface UnsplashPhoto {\n  id: string;\n  created_at: string;\n  updated_at: string;\n  width: number;\n  height: number;\n  color: string;\n  blur_hash: string | null;\n  description: string | null;\n  alt_description: string | null;\n  urls: {\n    raw: string;\n    full: string;\n    regular: string;\n    small: string;\n    thumb: string;\n  };\n  links: {\n    self: string;\n    html: string;\n    download: string;\n    download_location: string;\n  };\n  user: {\n    id: string;\n    username: string;\n    name: string;\n    portfolio_url: string | null;\n    profile_image: { small: string; medium: string; large: string };\n    links: { html: string };\n  };\n  tags?: Array<{ title: string }>;\n}\n\nexport interface UnsplashCollection {\n  id: string;\n  title: string;\n  description: string | null;\n  published_at: string;\n  updated_at: string;\n  total_photos: number;\n  cover_photo: UnsplashPhoto | null;\n  user: UnsplashPhoto['user'];\n}\n\nexport interface UnsplashSearchResult<T> {\n  total: number;\n  total_pages: number;\n  results: T[];\n}\n\nexport interface UnsplashClientConfig {\n  /** Unsplash API access key (Client-ID) */\n  accessKey: string;\n}\n\nexport class UnsplashClient {\n  private accessKey: string;\n\n  constructor(config: UnsplashClientConfig) {\n    this.accessKey = config.accessKey;\n  }\n\n  /** List editorial photos. */\n  async listPhotos(options: {\n    page?: number;\n    perPage?: number;\n    orderBy?: 'latest' | 'oldest' | 'popular';\n  } = {}): Promise<UnsplashPhoto[]> {\n    const params = new URLSearchParams();\n    params.set('page', String(options.page ?? 1));\n    params.set('per_page', String(options.perPage ?? 30));\n    if (options.orderBy) params.set('order_by', options.orderBy);\n    return this.get<UnsplashPhoto[]>(`/photos?${params}`);\n  }\n\n  /** Get a single photo by ID. */\n  async getPhoto(id: string): Promise<UnsplashPhoto> {\n    return this.get<UnsplashPhoto>(`/photos/${id}`);\n  }\n\n  /** Search photos by query. */\n  async searchPhotos(options: {\n    query: string;\n    page?: number;\n    perPage?: number;\n    orderBy?: 'relevant' | 'latest';\n    orientation?: 'landscape' | 'portrait' | 'squarish';\n    color?: string;\n  }): Promise<UnsplashSearchResult<UnsplashPhoto>> {\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.orderBy) params.set('order_by', options.orderBy);\n    if (options.orientation) params.set('orientation', options.orientation);\n    if (options.color) params.set('color', options.color);\n    return this.get<UnsplashSearchResult<UnsplashPhoto>>(`/search/photos?${params}`);\n  }\n\n  /** List collections. */\n  async listCollections(options: {\n    page?: number;\n    perPage?: number;\n  } = {}): Promise<UnsplashCollection[]> {\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<UnsplashCollection[]>(`/collections?${params}`);\n  }\n\n  /** Get photos in a collection. */\n  async getCollectionPhotos(collectionId: string, options: {\n    page?: number;\n    perPage?: number;\n  } = {}): Promise<UnsplashPhoto[]> {\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<UnsplashPhoto[]>(`/collections/${collectionId}/photos?${params}`);\n  }\n\n  /** Search collections by query. */\n  async searchCollections(options: {\n    query: string;\n    page?: number;\n    perPage?: number;\n  }): Promise<UnsplashSearchResult<UnsplashCollection>> {\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    return this.get<UnsplashSearchResult<UnsplashCollection>>(`/search/collections?${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: {\n        Authorization: `Client-ID ${this.accessKey}`,\n        'Accept-Version': 'v1',\n      },\n    });\n    if (!res.ok) {\n      const text = await res.text();\n      throw new Error(`Unsplash 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 { UnsplashClient } from './UnsplashClient';\nimport type { UnsplashPhoto, UnsplashCollection, UnsplashClientConfig } from './UnsplashClient';\n\nfunction mapPhoto(photo: UnsplashPhoto, albumName?: string): MediaItem {\n  const createdAt = new Date(photo.created_at);\n  const item: MediaItem = {\n    id: photo.id,\n    type: 'media',\n    title: photo.description || photo.alt_description || `Photo ${photo.id}`,\n    mediaType: 'photo',\n    url: photo.urls.regular,\n    thumbnail: photo.urls.small,\n    mimeType: 'image/jpeg',\n    width: photo.width,\n    height: photo.height,\n    createdAt,\n    updatedAt: new Date(photo.updated_at),\n  };\n\n  if (photo.description) {\n    item.description = photo.description;\n  }\n\n  if (photo.tags && photo.tags.length > 0) {\n    item.tags = photo.tags.map(t => t.title);\n  }\n\n  if (albumName) {\n    item.album = albumName;\n  }\n\n  return item;\n}\n\nexport class UnsplashMediaProvider implements IMediaProvider {\n  private client: UnsplashClient;\n  /** Cache of collection ID -> collection for resolving album names. */\n  private collectionCache = new Map<string, UnsplashCollection>();\n\n  constructor(config: UnsplashClientConfig) {\n    this.client = new UnsplashClient(config);\n  }\n\n  // ---------- IObjectProvider<MediaItem> ----------\n\n  async listItems(): Promise<MediaItem[]> {\n    const photos = await this.client.listPhotos({ perPage: 30 });\n    return photos.map(p => mapPhoto(p));\n  }\n\n  async getItem(id: string): Promise<MediaItem | null> {\n    try {\n      const photo = await this.client.getPhoto(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('Unsplash is a read-only photo library');\n  }\n\n  async updateItem(_id: string, _updates: Partial<MediaItem>): Promise<MediaItem> {\n    throw new Error('Unsplash is a read-only photo library');\n  }\n\n  async deleteItem(_id: string): Promise<void> {\n    throw new Error('Unsplash 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.results.map(p => mapPhoto(p));\n  }\n\n  // ---------- IMediaProvider ----------\n\n  async getAlbums(): Promise<string[]> {\n    const collections = await this.client.listCollections({ perPage: 30 });\n    this.collectionCache.clear();\n    for (const c of collections) {\n      this.collectionCache.set(c.id, c);\n    }\n    return 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 photos = await this.client.getCollectionPhotos(collectionId, { perPage: 30 });\n    return photos.map(p => mapPhoto(p, album));\n  }\n\n  async getByDateRange(start: Date, end: Date): Promise<MediaItem[]> {\n    // Unsplash doesn't have date range search, so we fetch recent and filter client-side\n    const photos = await this.client.listPhotos({ perPage: 30, orderBy: 'latest' });\n    return photos\n      .filter(p => {\n        const d = new Date(p.created_at);\n        return d >= start && d <= end;\n      })\n      .map(p => mapPhoto(p));\n  }\n}\n"],"mappings":"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"}

package/package.json

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

@@ -0,0 +1,163 @@
+/**
+ * Low-level Unsplash API client.
+ *
+ * Uses the public Client-ID authentication for read-only access.
+ * All photos are free to use under the Unsplash License.
+ */
+
+const API_URL = 'https://api.unsplash.com';
+
+// ---------- Response shapes ----------
+
+export interface UnsplashPhoto {
+  id: string;
+  created_at: string;
+  updated_at: string;
+  width: number;
+  height: number;
+  color: string;
+  blur_hash: string | null;
+  description: string | null;
+  alt_description: string | null;
+  urls: {
+    raw: string;
+    full: string;
+    regular: string;
+    small: string;
+    thumb: string;
+  };
+  links: {
+    self: string;
+    html: string;
+    download: string;
+    download_location: string;
+  };
+  user: {
+    id: string;
+    username: string;
+    name: string;
+    portfolio_url: string | null;
+    profile_image: { small: string; medium: string; large: string };
+    links: { html: string };
+  };
+  tags?: Array<{ title: string }>;
+}
+
+export interface UnsplashCollection {
+  id: string;
+  title: string;
+  description: string | null;
+  published_at: string;
+  updated_at: string;
+  total_photos: number;
+  cover_photo: UnsplashPhoto | null;
+  user: UnsplashPhoto['user'];
+}
+
+export interface UnsplashSearchResult<T> {
+  total: number;
+  total_pages: number;
+  results: T[];
+}
+
+export interface UnsplashClientConfig {
+  /** Unsplash API access key (Client-ID) */
+  accessKey: string;
+}
+
+export class UnsplashClient {
+  private accessKey: string;
+
+  constructor(config: UnsplashClientConfig) {
+    this.accessKey = config.accessKey;
+  }
+
+  /** List editorial photos. */
+  async listPhotos(options: {
+    page?: number;
+    perPage?: number;
+    orderBy?: 'latest' | 'oldest' | 'popular';
+  } = {}): Promise<UnsplashPhoto[]> {
+    const params = new URLSearchParams();
+    params.set('page', String(options.page ?? 1));
+    params.set('per_page', String(options.perPage ?? 30));
+    if (options.orderBy) params.set('order_by', options.orderBy);
+    return this.get<UnsplashPhoto[]>(`/photos?${params}`);
+  }
+
+  /** Get a single photo by ID. */
+  async getPhoto(id: string): Promise<UnsplashPhoto> {
+    return this.get<UnsplashPhoto>(`/photos/${id}`);
+  }
+
+  /** Search photos by query. */
+  async searchPhotos(options: {
+    query: string;
+    page?: number;
+    perPage?: number;
+    orderBy?: 'relevant' | 'latest';
+    orientation?: 'landscape' | 'portrait' | 'squarish';
+    color?: string;
+  }): Promise<UnsplashSearchResult<UnsplashPhoto>> {
+    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.orderBy) params.set('order_by', options.orderBy);
+    if (options.orientation) params.set('orientation', options.orientation);
+    if (options.color) params.set('color', options.color);
+    return this.get<UnsplashSearchResult<UnsplashPhoto>>(`/search/photos?${params}`);
+  }
+
+  /** List collections. */
+  async listCollections(options: {
+    page?: number;
+    perPage?: number;
+  } = {}): Promise<UnsplashCollection[]> {
+    const params = new URLSearchParams();
+    params.set('page', String(options.page ?? 1));
+    params.set('per_page', String(options.perPage ?? 30));
+    return this.get<UnsplashCollection[]>(`/collections?${params}`);
+  }
+
+  /** Get photos in a collection. */
+  async getCollectionPhotos(collectionId: string, options: {
+    page?: number;
+    perPage?: number;
+  } = {}): Promise<UnsplashPhoto[]> {
+    const params = new URLSearchParams();
+    params.set('page', String(options.page ?? 1));
+    params.set('per_page', String(options.perPage ?? 30));
+    return this.get<UnsplashPhoto[]>(`/collections/${collectionId}/photos?${params}`);
+  }
+
+  /** Search collections by query. */
+  async searchCollections(options: {
+    query: string;
+    page?: number;
+    perPage?: number;
+  }): Promise<UnsplashSearchResult<UnsplashCollection>> {
+    const params = new URLSearchParams();
+    params.set('query', options.query);
+    params.set('page', String(options.page ?? 1));
+    params.set('per_page', String(options.perPage ?? 30));
+    return this.get<UnsplashSearchResult<UnsplashCollection>>(`/search/collections?${params}`);
+  }
+
+  // ---------- Internal ----------
+
+  private async get<T>(path: string): Promise<T> {
+    const url = `${API_URL}${path}`;
+    const res = await fetch(url, {
+      headers: {
+        Authorization: `Client-ID ${this.accessKey}`,
+        'Accept-Version': 'v1',
+      },
+    });
+    if (!res.ok) {
+      const text = await res.text();
+      throw new Error(`Unsplash API error ${res.status}: ${text}`);
+    }
+    return res.json() as Promise<T>;
+  }
+}

package/src/UnsplashMediaProvider.ts

@@ -0,0 +1,115 @@
+import type { IMediaProvider, MediaItem } from '@anymux/ui-kit/media';
+import { UnsplashClient } from './UnsplashClient';
+import type { UnsplashPhoto, UnsplashCollection, UnsplashClientConfig } from './UnsplashClient';
+
+function mapPhoto(photo: UnsplashPhoto, albumName?: string): MediaItem {
+  const createdAt = new Date(photo.created_at);
+  const item: MediaItem = {
+    id: photo.id,
+    type: 'media',
+    title: photo.description || photo.alt_description || `Photo ${photo.id}`,
+    mediaType: 'photo',
+    url: photo.urls.regular,
+    thumbnail: photo.urls.small,
+    mimeType: 'image/jpeg',
+    width: photo.width,
+    height: photo.height,
+    createdAt,
+    updatedAt: new Date(photo.updated_at),
+  };
+
+  if (photo.description) {
+    item.description = photo.description;
+  }
+
+  if (photo.tags && photo.tags.length > 0) {
+    item.tags = photo.tags.map(t => t.title);
+  }
+
+  if (albumName) {
+    item.album = albumName;
+  }
+
+  return item;
+}
+
+export class UnsplashMediaProvider implements IMediaProvider {
+  private client: UnsplashClient;
+  /** Cache of collection ID -> collection for resolving album names. */
+  private collectionCache = new Map<string, UnsplashCollection>();
+
+  constructor(config: UnsplashClientConfig) {
+    this.client = new UnsplashClient(config);
+  }
+
+  // ---------- IObjectProvider<MediaItem> ----------
+
+  async listItems(): Promise<MediaItem[]> {
+    const photos = await this.client.listPhotos({ perPage: 30 });
+    return photos.map(p => mapPhoto(p));
+  }
+
+  async getItem(id: string): Promise<MediaItem | null> {
+    try {
+      const photo = await this.client.getPhoto(id);
+      return mapPhoto(photo);
+    } catch {
+      return null;
+    }
+  }
+
+  async createItem(_item: Omit<MediaItem, 'id' | 'createdAt' | 'updatedAt'>): Promise<MediaItem> {
+    throw new Error('Unsplash is a read-only photo library');
+  }
+
+  async updateItem(_id: string, _updates: Partial<MediaItem>): Promise<MediaItem> {
+    throw new Error('Unsplash is a read-only photo library');
+  }
+
+  async deleteItem(_id: string): Promise<void> {
+    throw new Error('Unsplash is a read-only photo library');
+  }
+
+  async search(query: string): Promise<MediaItem[]> {
+    const result = await this.client.searchPhotos({ query, perPage: 30 });
+    return result.results.map(p => mapPhoto(p));
+  }
+
+  // ---------- IMediaProvider ----------
+
+  async getAlbums(): Promise<string[]> {
+    const collections = await this.client.listCollections({ perPage: 30 });
+    this.collectionCache.clear();
+    for (const c of collections) {
+      this.collectionCache.set(c.id, c);
+    }
+    return 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 photos = await this.client.getCollectionPhotos(collectionId, { perPage: 30 });
+    return photos.map(p => mapPhoto(p, album));
+  }
+
+  async getByDateRange(start: Date, end: Date): Promise<MediaItem[]> {
+    // Unsplash doesn't have date range search, so we fetch recent and filter client-side
+    const photos = await this.client.listPhotos({ perPage: 30, orderBy: 'latest' });
+    return photos
+      .filter(p => {
+        const d = new Date(p.created_at);
+        return d >= start && d <= end;
+      })
+      .map(p => mapPhoto(p));
+  }
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+export { UnsplashClient } from './UnsplashClient';
+export type { UnsplashClientConfig, UnsplashPhoto, UnsplashCollection, UnsplashSearchResult } from './UnsplashClient';
+export { UnsplashMediaProvider } from './UnsplashMediaProvider';