// How a blob in a value is drawn: its picture, its audio, or its type and // size (JsonTree's), and where a picture of it loads from. import { httpUrl } from './format'; import type { Size, Source } from './types'; export const isObject = (value: unknown): value is Record => typeof value === 'object' && value !== null && !Array.isArray(value); /** A blob as drawn: a picture, audio, or a file of a type and size. */ export type BlobShown = | { kind: 'image'; source: Source; mimeType: string; size: number | null } | { kind: 'audio'; url: string; mimeType: string; size: number | null } | { kind: 'file'; mimeType: string; size: number | null }; /** A blob's picture, drawn at `size`: its `url`, or its `thumb` drawn small, * with its `proxy` to fall back on; null when it has no `url`. */ export function blobSource(blob: Record, size: Size): Source | null { if (typeof blob.url !== 'string') return null; const src = size === 'small' && typeof blob.thumb === 'string' ? blob.thumb : blob.url; return { src, fallback: typeof blob.proxy === 'string' && blob.proxy !== src ? blob.proxy : null }; } /** A blob, new form or legacy: an image (drawn small, beside its type and * size) or audio when it has a URL, else its MIME type and size. Null when * the value is no blob. */ export function blob(value: unknown): BlobShown | null { if (!isObject(value) || typeof value.mimeType !== 'string') return null; if (value.$type !== 'blob' && typeof value.cid !== 'string') return null; const size = typeof value.size === 'number' ? value.size : null; const { mimeType } = value; if (typeof value.url === 'string' && httpUrl(value.url)) { const source = blobSource(value, 'small'); if (mimeType.startsWith('image/') && source) return { kind: 'image', source, mimeType, size }; if (mimeType.startsWith('audio/')) return { kind: 'audio', url: value.url, mimeType, size }; } return { kind: 'file', mimeType, size }; }