feat!: release v2 (#6545)

Co-authored-by: Artur <145776561+arturict@users.noreply.github.com>
Co-authored-by: arturict <arturict@users.noreply.github.com>
Co-authored-by: Thomas <thomas@ajnart.fr>
Co-authored-by: Afonso Jorge Ramos <afonsojorgeramos@gmail.com>
Co-authored-by: Danura30082 <danura30082+github@gmail.com>
Co-authored-by: Kushie <122986913+kushiemoon-dev@users.noreply.github.com>
Co-authored-by: ajnart <thomas@ajnart.fr>
Co-authored-by: ajnart <thomas@ajnart.dev>
Co-authored-by: chenjun <chenjun@foxmail.com>
Co-authored-by: Wikibear <wikibear@users.noreply.github.com>
Co-authored-by: Bergasha <bergasha@gmail.com>
Co-authored-by: leafyelin <43306196+leafyelin@users.noreply.github.com>
Co-authored-by: Lucas Araujo <lucas.lra@gmail.com>
Co-authored-by: GreenMonito <86085570+GreenMonito@users.noreply.github.com>
Co-authored-by: Nerdy-Technician <roffo@nerdy-technician.social>
Co-authored-by: Jun <34545896+jcstrong@users.noreply.github.com>
Co-authored-by: Edmond Abraham <54119952+gitedmond@users.noreply.github.com>
Co-authored-by: thrawnx <tight.bulb9384@fastmail.com>
Co-authored-by: Chris <58918656+nordada@users.noreply.github.com>
Co-authored-by: yi111 <153097222+Yi-111-a@users.noreply.github.com>
Co-authored-by: Yanis <naamaneyanis@gmail.com>
Co-authored-by: Wikibear <me@sej.de>
Co-authored-by: alessiottavo <93441886+alessiottavo@users.noreply.github.com>

packages/image-proxy/src/index.ts

@@ -1,6 +1,7 @@
-import { createHmac, hkdfSync } from "node:crypto";
+import { createHmac, hkdfSync, randomUUID } from "node:crypto";
+import { setImmediate } from "node:timers/promises";
 
-import { createId } from "@homarr/common";
+import { createId, formatBytes } from "@homarr/common";
 import { env } from "@homarr/common/env";
 import { decryptSecret, encryptSecret } from "@homarr/common/server";
 import { fetchWithTrustedCertificatesAsync } from "@homarr/core/infrastructure/http";
@@ -53,6 +54,35 @@ export class ImageProxy {
     return this.createImageUrl(id);
   }
 
+  public async createImagesAsync(urls: string[], headers?: Record<string, string>): Promise<string[]> {
+    // Album assets share credentials. Hash/encrypt that immutable value once,
+    // and bound each registration batch so it cannot monopolize rendering.
+    const headerValue = JSON.stringify(headers ?? null);
+    const headerHash = this.hashSecret(headerValue);
+    const encryptedHeaders = encryptSecret(headerValue);
+    const links: string[] = [];
+    for (let index = 0; index < urls.length; index += 128) {
+      const batch = await Promise.all(
+        urls.slice(index, index + 128).map(async (url) => {
+          const urlHash = this.hashSecret(url);
+          const hashChannel = createHmacChannel(`${urlHash}.${headerHash}`);
+          const existingId = await hashChannel.getAsync();
+          if (existingId) return this.createImageUrl(existingId);
+          const id = randomUUID();
+          await createUrlByIdChannel(id).setAsync(
+            { url: encryptSecret(url), headers: encryptedHeaders },
+            { ttlSeconds: IMAGE_PROXY_REDIS_TTL_SECONDS },
+          );
+          await hashChannel.setAsync(id, { ttlSeconds: IMAGE_PROXY_REDIS_TTL_SECONDS });
+          return this.createImageUrl(id);
+        }),
+      );
+      links.push(...batch);
+      if (index + 128 < urls.length) await setImmediate();
+    }
+    return links;
+  }
+
   public async forwardImageAsync(id: string): Promise<ForwardImageResult> {
     const urlAndHeaders = await this.getImageUrlAndHeadersAsync(id);
     if (!urlAndHeaders) {
@@ -100,7 +130,7 @@ export class ImageProxy {
       url: this.redactUrl(urlAndHeaders.url),
       headers: this.redactHeaders(urlAndHeaders.headers),
       proxyUrl,
-      size: `${(arrayBuffer.byteLength / 1024).toFixed(1)}KB`,
+      size: formatBytes(arrayBuffer.byteLength),
     });
 
     return { image: arrayBuffer, contentType: response.headers.get("content-type") };