Storage

/** Map a supported image content-type to a file extension, or null. */
export function extForImage(contentType: string): string | null {
  return EXT_BY_TYPE[contentType] ?? null;
}
 
/** A collision-resistant object key under a prefix. */
export function uploadKey(prefix: string, ext: string): string {
  return `${prefix}/${randomUUID()}.${ext}`;
}
 
export async function putObject(key: string, body: Buffer, contentType: string): Promise<void> {
  await store().put(key, body, contentType);
}
 
export async function getObject(
  key: string,
): Promise<{ body: Buffer; contentType: string } | null> {
  try {
    return await store().get(key);
  } catch {
    return null;
  }
}
 
export async function removeObject(key: string): Promise<void> {
  try {
    await store().remove(key);
  } catch {
    // Best-effort cleanup — a failed delete shouldn't break the caller.
  }
}
 
/**
 * The app path that serves a stored object (via the file-proxy route).
 *
 * The key travels as a query param (not a path segment) on purpose: Vite's dev
 * server intercepts request paths ending in an asset extension (`.png`, `.jpg`,
 * …) and 404s them before they reach our server route. Keeping the extension in
 * the query string sidesteps that, and behaves identically in production.
 */
export function fileUrl(key: string): string {
  return `/api/files?key=${encodeURIComponent(key)}`;
}