import { Store, UIEventSource } from "../UIEventSource" import BaseUIElement from "../../UI/BaseUIElement" import { LicenseInfo } from "./LicenseInfo" import { Utils } from "../../Utils" export interface ProvidedImage { url: string url_hd?: string key: string provider: ImageProvider id: string date?: Date } export default abstract class ImageProvider { public abstract readonly defaultKeyPrefixes: string[] public abstract readonly name: string public abstract SourceIcon(id?: string, location?: { lon: number; lat: number }): BaseUIElement /** * Given a properties object, maps it onto _all_ the available pictures for this imageProvider. * This iterates over _all_ tags and matches _anything_ that might be an image */ public GetRelevantUrls( allTags: Store, options?: { prefixes?: string[] } ): UIEventSource { const prefixes = options?.prefixes ?? this.defaultKeyPrefixes if (prefixes === undefined) { throw "No `defaultKeyPrefixes` defined by this image provider" } const relevantUrls = new UIEventSource< { id: string; url: string; key: string; provider: ImageProvider }[] >([]) const seenValues = new Set() allTags.addCallbackAndRunD((tags) => { for (const key in tags) { if (!prefixes.some((prefix) => key.startsWith(prefix))) { continue } const values = Utils.NoEmpty(tags[key]?.split(";")?.map((v) => v.trim()) ?? []) for (const value of values) { if (seenValues.has(value)) { continue } seenValues.add(value) this.ExtractUrls(key, value).then((promises) => { for (const promise of promises ?? []) { if (promise === undefined) { continue } promise.then((providedImage) => { if (providedImage === undefined) { return } relevantUrls.data.push(providedImage) relevantUrls.ping() }) } }) } } }) return relevantUrls } public abstract ExtractUrls(key: string, value: string): Promise[]> public abstract DownloadAttribution(providedImage: { url: string id: string }): Promise public abstract apiUrls(): string[] }