perf: implement Phase 1 homepage diet via Next.js Cache Components

P1-0: V8 heap cap (HOMARR_MAX_OLD_SPACE_SIZE, default 512MB)
P1-1: Module graph cuts
  - Dynamic integration imports (55 static → lazy loaders)
  - Conditional DB driver loading (only configured driver loaded)
  - Replace jsdom with linkedom for SVG sanitization
  - Delete eager widget barrel (55 import * as → 0)
  - Extract createRetryableLoader to @homarr/common
P1-2: Enable cacheComponents + restructure root layout
  - Suspense boundaries around session-dependent providers
  - ColorSchemeScript replaces server-side cookie reads
  - Board/manage/auth layouts wrapped in Suspense
P1-3: Cache read paths
  - Cache tag registry + invalidation helpers
  - Cache invalidation wired into all mutation routers
  - Translation deep-merge memoized per locale
P1-4: Prerendered shells + loading.tsx files
P1-5: Shared integration data cache (60s TTL, stale-while-revalidate)
P1-6: Redis-backed Next.js cache handler (@homarr/next-cache-handler)
P1-7: Redis optional (memory channel fallback), TTL on pubSub:last:*,
      Redis clients consolidated from 6 to 2
This commit is contained in:
Thomas Camlong committed 2026-08-07 18:59:47 +02:00
1 parent 366ec6bdbc
commit 018f98e318
86 files changed
+2219 -1232

No files matched your search

@@ -0,0 +1,11 @@
import { describe, expect, it } from "vitest";
import { integrationKinds } from "@homarr/definitions";
import { integrationLoaderKinds } from "./creator";
describe("integration creator", () => {
it("should have a loader for every IntegrationKind", () => {
expect(new Set(integrationLoaderKinds)).toEqual(new Set(integrationKinds));
});
});
+85 -128
View File
@@ -1,144 +1,101 @@
import type { IntegrationKind } from "@homarr/definitions";
import { AdGuardHomeIntegration } from "../adguard-home/adguard-home-integration";
import { BeszelIntegration } from "../beszel/beszel-integration";
import { BazarrIntegration } from "../bazarr/bazarr-integration";
import { AnchorIntegration } from "../anchor/anchor-integration";
import { AudiobookshelfIntegration } from "../audiobookshelf/audiobookshelf-integration";
import { CoolifyIntegration } from "../coolify/coolify-integration";
import { DashDotIntegration } from "../dashdot/dashdot-integration";
import { Aria2Integration } from "../download-client/aria2/aria2-integration";
import { DelugeIntegration } from "../download-client/deluge/deluge-integration";
import { NzbGetIntegration } from "../download-client/nzbget/nzbget-integration";
import { QBitTorrentIntegration } from "../download-client/qbittorrent/qbittorrent-integration";
import { SabnzbdIntegration } from "../download-client/sabnzbd/sabnzbd-integration";
import { SlskdIntegration } from "../download-client/slskd/slskd-integration";
import { TransmissionIntegration } from "../download-client/transmission/transmission-integration";
import { EmbyIntegration } from "../emby/emby-integration";
import { GlancesIntegration } from "../glances/glances-integration";
import { ArchiveTeamWarriorIntegration } from "../archive-team-warrior/archive-team-warrior-integration";
import { GluetunIntegration } from "../gluetun/gluetun-integration";
import { HomeAssistantIntegration } from "../homeassistant/homeassistant-integration";
import { ICalIntegration } from "../ical/ical-integration";
import { ImmichIntegration } from "../immich/immich-integration";
import { JellyfinIntegration } from "../jellyfin/jellyfin-integration";
import { JellyseerrIntegration } from "../jellyseerr/jellyseerr-integration";
import { LidarrIntegration } from "../media-organizer/lidarr/lidarr-integration";
import { RadarrIntegration } from "../media-organizer/radarr/radarr-integration";
import { ReadarrIntegration } from "../media-organizer/readarr/readarr-integration";
import { SonarrIntegration } from "../media-organizer/sonarr/sonarr-integration";
import { TdarrIntegration } from "../media-transcoding/tdarr-integration";
import { MockIntegration } from "../mock/mock-integration";
import { NavidromeIntegration } from "../navidrome/navidrome-integration";
import { NextcloudIntegration } from "../nextcloud/nextcloud.integration";
import { GotifyIntegration } from "../gotify/gotify-integration";
import { NTFYIntegration } from "../ntfy/ntfy-integration";
import { OpenMediaVaultIntegration } from "../openmediavault/openmediavault-integration";
import { OPNsenseIntegration } from "../opnsense/opnsense-integration";
import { OverseerrIntegration } from "../overseerr/overseerr-integration";
import { PaperlessNgxIntegration } from "../paperless-ngx/paperless-ngx-integration";
import { PatchMonIntegration } from "../patchmon/patchmon-integration";
import { PeaNutIntegration } from "../peanut/peanut-integration";
import { createPiHoleIntegrationAsync } from "../pi-hole/pi-hole-integration-factory";
import { createTechnitiumDnsIntegrationAsync } from "../technitium/technitium-integration-factory";
import { PlexIntegration } from "../plex/plex-integration";
import { ProwlarrIntegration } from "../prowlarr/prowlarr-integration";
import { ProxmoxIntegration } from "../proxmox/proxmox-integration";
import { SeerrIntegration } from "../seerr/seerr-integration";
import { SpeedtestTrackerIntegration } from "../speedtest-tracker/speedtest-tracker-integration";
import { TracearrIntegration } from "../tracearr/tracearr-integration";
import { TraefikIntegration } from "../traefik/traefik-integration";
import { SynologyIntegration } from "../synology/synology-integration";
import { TrueNasIntegration } from "../truenas/truenas-integration";
import { UmamiIntegration } from "../umami/umami-integration";
import { UptimeKumaIntegration } from "../uptime-kuma/uptime-kuma-integration";
import { UnifiControllerIntegration } from "../unifi-controller/unifi-controller-integration";
import { UnraidIntegration } from "../unraid/unraid-integration";
import type { Integration, IntegrationInput } from "./integration";
import { createRetryableLoader } from "@homarr/common";
export const createIntegrationAsync = async <TKind extends keyof typeof integrationCreators>(
import type { Integration, IntegrationInput } from "./integration";
import type { IntegrationInstanceOfKind } from "./kind-map";
type IntegrationCtor = new (integration: IntegrationInput) => Integration;
type IntegrationFactory = (integration: IntegrationInput) => Promise<Integration>;
type IntegrationLoader = () => Promise<IntegrationCtor | [IntegrationFactory]>;
const integrationLoaders: Record<IntegrationKind, IntegrationLoader> = {
anchor: () => import("../anchor/anchor-integration").then((m) => m.AnchorIntegration),
adGuardHome: () => import("../adguard-home/adguard-home-integration").then((m) => m.AdGuardHomeIntegration),
archiveTeamWarrior: () =>
import("../archive-team-warrior/archive-team-warrior-integration").then((m) => m.ArchiveTeamWarriorIntegration),
aria2: () => import("../download-client/aria2/aria2-integration").then((m) => m.Aria2Integration),
audiobookshelf: () => import("../audiobookshelf/audiobookshelf-integration").then((m) => m.AudiobookshelfIntegration),
bazarr: () => import("../bazarr/bazarr-integration").then((m) => m.BazarrIntegration),
beszel: () => import("../beszel/beszel-integration").then((m) => m.BeszelIntegration),
coolify: () => import("../coolify/coolify-integration").then((m) => m.CoolifyIntegration),
dashDot: () => import("../dashdot/dashdot-integration").then((m) => m.DashDotIntegration),
deluge: () => import("../download-client/deluge/deluge-integration").then((m) => m.DelugeIntegration),
emby: () => import("../emby/emby-integration").then((m) => m.EmbyIntegration),
glances: () => import("../glances/glances-integration").then((m) => m.GlancesIntegration),
gluetun: () => import("../gluetun/gluetun-integration").then((m) => m.GluetunIntegration),
gotify: () => import("../gotify/gotify-integration").then((m) => m.GotifyIntegration),
homeAssistant: () => import("../homeassistant/homeassistant-integration").then((m) => m.HomeAssistantIntegration),
ical: () => import("../ical/ical-integration").then((m) => m.ICalIntegration),
immich: () => import("../immich/immich-integration").then((m) => m.ImmichIntegration),
jellyfin: () => import("../jellyfin/jellyfin-integration").then((m) => m.JellyfinIntegration),
jellyseerr: () => import("../jellyseerr/jellyseerr-integration").then((m) => m.JellyseerrIntegration),
lidarr: () => import("../media-organizer/lidarr/lidarr-integration").then((m) => m.LidarrIntegration),
mock: () => import("../mock/mock-integration").then((m) => m.MockIntegration),
navidrome: () => import("../navidrome/navidrome-integration").then((m) => m.NavidromeIntegration),
nextcloud: () => import("../nextcloud/nextcloud.integration").then((m) => m.NextcloudIntegration),
ntfy: () => import("../ntfy/ntfy-integration").then((m) => m.NTFYIntegration),
nzbGet: () => import("../download-client/nzbget/nzbget-integration").then((m) => m.NzbGetIntegration),
openmediavault: () =>
import("../openmediavault/openmediavault-integration").then((m) => m.OpenMediaVaultIntegration),
opnsense: () => import("../opnsense/opnsense-integration").then((m) => m.OPNsenseIntegration),
overseerr: () => import("../overseerr/overseerr-integration").then((m) => m.OverseerrIntegration),
paperlessNgx: () => import("../paperless-ngx/paperless-ngx-integration").then((m) => m.PaperlessNgxIntegration),
patchmon: () => import("../patchmon/patchmon-integration").then((m) => m.PatchMonIntegration),
peaNut: () => import("../peanut/peanut-integration").then((m) => m.PeaNutIntegration),
piHole: () =>
import("../pi-hole/pi-hole-integration-factory").then((m) => [m.createPiHoleIntegrationAsync] as [IntegrationFactory]),
plex: () => import("../plex/plex-integration").then((m) => m.PlexIntegration),
prowlarr: () => import("../prowlarr/prowlarr-integration").then((m) => m.ProwlarrIntegration),
proxmox: () => import("../proxmox/proxmox-integration").then((m) => m.ProxmoxIntegration),
qBittorrent: () =>
import("../download-client/qbittorrent/qbittorrent-integration").then((m) => m.QBitTorrentIntegration),
radarr: () => import("../media-organizer/radarr/radarr-integration").then((m) => m.RadarrIntegration),
readarr: () => import("../media-organizer/readarr/readarr-integration").then((m) => m.ReadarrIntegration),
sabNzbd: () => import("../download-client/sabnzbd/sabnzbd-integration").then((m) => m.SabnzbdIntegration),
seerr: () => import("../seerr/seerr-integration").then((m) => m.SeerrIntegration),
slskd: () => import("../download-client/slskd/slskd-integration").then((m) => m.SlskdIntegration),
sonarr: () => import("../media-organizer/sonarr/sonarr-integration").then((m) => m.SonarrIntegration),
speedtestTracker: () =>
import("../speedtest-tracker/speedtest-tracker-integration").then((m) => m.SpeedtestTrackerIntegration),
synology: () => import("../synology/synology-integration").then((m) => m.SynologyIntegration),
tdarr: () => import("../media-transcoding/tdarr-integration").then((m) => m.TdarrIntegration),
technitiumDns: () =>
import("../technitium/technitium-integration-factory").then(
(m) => [m.createTechnitiumDnsIntegrationAsync] as [IntegrationFactory],
),
tracearr: () => import("../tracearr/tracearr-integration").then((m) => m.TracearrIntegration),
traefik: () => import("../traefik/traefik-integration").then((m) => m.TraefikIntegration),
transmission: () =>
import("../download-client/transmission/transmission-integration").then((m) => m.TransmissionIntegration),
truenas: () => import("../truenas/truenas-integration").then((m) => m.TrueNasIntegration),
umami: () => import("../umami/umami-integration").then((m) => m.UmamiIntegration),
unifiController: () =>
import("../unifi-controller/unifi-controller-integration").then((m) => m.UnifiControllerIntegration),
unraid: () => import("../unraid/unraid-integration").then((m) => m.UnraidIntegration),
uptimeKuma: () => import("../uptime-kuma/uptime-kuma-integration").then((m) => m.UptimeKumaIntegration),
};
export const integrationLoaderKinds = Object.keys(integrationLoaders) as IntegrationKind[];
const loadIntegrationCreator = createRetryableLoader(
new Map(Object.entries(integrationLoaders) as [IntegrationKind, IntegrationLoader][]),
);
export const createIntegrationAsync = async <TKind extends IntegrationKind>(
integration: IntegrationInput & { kind: TKind },
) => {
if (!(integration.kind in integrationCreators)) {
): Promise<IntegrationInstanceOfKind<TKind>> => {
if (!(integration.kind in integrationLoaders)) {
throw new Error(
`Unknown integration kind ${integration.kind}. Did you forget to add it to the integration creator?`,
);
}
const creator = integrationCreators[integration.kind];
const creator = await loadIntegrationCreator(integration.kind);
// factories are an array, to differentiate in js between class constructors and functions
if (Array.isArray(creator)) {
return (await creator[0](integration)) as IntegrationInstanceOfKind<TKind>;
}
return new creator(integration) as IntegrationInstanceOfKind<TKind>;
};
type IntegrationInstance = new (integration: IntegrationInput) => Integration;
// factories are an array, to differentiate in js between class constructors and functions
export const integrationCreators = {
anchor: AnchorIntegration,
piHole: [createPiHoleIntegrationAsync],
adGuardHome: AdGuardHomeIntegration,
technitiumDns: [createTechnitiumDnsIntegrationAsync],
homeAssistant: HomeAssistantIntegration,
jellyfin: JellyfinIntegration,
plex: PlexIntegration,
sonarr: SonarrIntegration,
radarr: RadarrIntegration,
sabNzbd: SabnzbdIntegration,
nzbGet: NzbGetIntegration,
qBittorrent: QBitTorrentIntegration,
deluge: DelugeIntegration,
transmission: TransmissionIntegration,
slskd: SlskdIntegration,
aria2: Aria2Integration,
jellyseerr: JellyseerrIntegration,
seerr: SeerrIntegration,
overseerr: OverseerrIntegration,
prowlarr: ProwlarrIntegration,
openmediavault: OpenMediaVaultIntegration,
lidarr: LidarrIntegration,
readarr: ReadarrIntegration,
dashDot: DashDotIntegration,
tdarr: TdarrIntegration,
proxmox: ProxmoxIntegration,
emby: EmbyIntegration,
nextcloud: NextcloudIntegration,
unifiController: UnifiControllerIntegration,
opnsense: OPNsenseIntegration,
ical: ICalIntegration,
ntfy: NTFYIntegration,
gotify: GotifyIntegration,
mock: MockIntegration,
truenas: TrueNasIntegration,
synology: SynologyIntegration,
unraid: UnraidIntegration,
coolify: CoolifyIntegration,
tracearr: TracearrIntegration,
glances: GlancesIntegration,
immich: ImmichIntegration,
paperlessNgx: PaperlessNgxIntegration,
patchmon: PatchMonIntegration,
speedtestTracker: SpeedtestTrackerIntegration,
audiobookshelf: AudiobookshelfIntegration,
navidrome: NavidromeIntegration,
umami: UmamiIntegration,
gluetun: GluetunIntegration,
archiveTeamWarrior: ArchiveTeamWarriorIntegration,
uptimeKuma: UptimeKumaIntegration,
peaNut: PeaNutIntegration,
beszel: BeszelIntegration,
bazarr: BazarrIntegration,
traefik: TraefikIntegration,
} satisfies Record<IntegrationKind, IntegrationInstance | [(input: IntegrationInput) => Promise<Integration>]>;
type IntegrationInstanceOfKind<TKind extends keyof typeof integrationCreators> = {
[kind in TKind]: (typeof integrationCreators)[kind] extends [(input: IntegrationInput) => Promise<Integration>]
? Awaited<ReturnType<(typeof integrationCreators)[kind][0]>>
: (typeof integrationCreators)[kind] extends IntegrationInstance
? InstanceType<(typeof integrationCreators)[kind]>
: never;
}[TKind];
+119
View File
@@ -0,0 +1,119 @@
import type { IntegrationKind } from "@homarr/definitions";
// Type-only imports — fully erased at build, zero runtime modules loaded.
import type { AdGuardHomeIntegration } from "../adguard-home/adguard-home-integration";
import type { AnchorIntegration } from "../anchor/anchor-integration";
import type { ArchiveTeamWarriorIntegration } from "../archive-team-warrior/archive-team-warrior-integration";
import type { AudiobookshelfIntegration } from "../audiobookshelf/audiobookshelf-integration";
import type { BazarrIntegration } from "../bazarr/bazarr-integration";
import type { BeszelIntegration } from "../beszel/beszel-integration";
import type { CoolifyIntegration } from "../coolify/coolify-integration";
import type { DashDotIntegration } from "../dashdot/dashdot-integration";
import type { Aria2Integration } from "../download-client/aria2/aria2-integration";
import type { DelugeIntegration } from "../download-client/deluge/deluge-integration";
import type { NzbGetIntegration } from "../download-client/nzbget/nzbget-integration";
import type { QBitTorrentIntegration } from "../download-client/qbittorrent/qbittorrent-integration";
import type { SabnzbdIntegration } from "../download-client/sabnzbd/sabnzbd-integration";
import type { SlskdIntegration } from "../download-client/slskd/slskd-integration";
import type { TransmissionIntegration } from "../download-client/transmission/transmission-integration";
import type { EmbyIntegration } from "../emby/emby-integration";
import type { GlancesIntegration } from "../glances/glances-integration";
import type { GluetunIntegration } from "../gluetun/gluetun-integration";
import type { GotifyIntegration } from "../gotify/gotify-integration";
import type { HomeAssistantIntegration } from "../homeassistant/homeassistant-integration";
import type { ICalIntegration } from "../ical/ical-integration";
import type { ImmichIntegration } from "../immich/immich-integration";
import type { JellyfinIntegration } from "../jellyfin/jellyfin-integration";
import type { JellyseerrIntegration } from "../jellyseerr/jellyseerr-integration";
import type { LidarrIntegration } from "../media-organizer/lidarr/lidarr-integration";
import type { RadarrIntegration } from "../media-organizer/radarr/radarr-integration";
import type { ReadarrIntegration } from "../media-organizer/readarr/readarr-integration";
import type { SonarrIntegration } from "../media-organizer/sonarr/sonarr-integration";
import type { TdarrIntegration } from "../media-transcoding/tdarr-integration";
import type { MockIntegration } from "../mock/mock-integration";
import type { NavidromeIntegration } from "../navidrome/navidrome-integration";
import type { NextcloudIntegration } from "../nextcloud/nextcloud.integration";
import type { NTFYIntegration } from "../ntfy/ntfy-integration";
import type { OpenMediaVaultIntegration } from "../openmediavault/openmediavault-integration";
import type { OPNsenseIntegration } from "../opnsense/opnsense-integration";
import type { OverseerrIntegration } from "../overseerr/overseerr-integration";
import type { PaperlessNgxIntegration } from "../paperless-ngx/paperless-ngx-integration";
import type { PatchMonIntegration } from "../patchmon/patchmon-integration";
import type { PeaNutIntegration } from "../peanut/peanut-integration";
import type { PiHoleIntegrationV5 } from "../pi-hole/v5/pi-hole-integration-v5";
import type { PiHoleIntegrationV6 } from "../pi-hole/v6/pi-hole-integration-v6";
import type { PlexIntegration } from "../plex/plex-integration";
import type { ProwlarrIntegration } from "../prowlarr/prowlarr-integration";
import type { ProxmoxIntegration } from "../proxmox/proxmox-integration";
import type { SeerrIntegration } from "../seerr/seerr-integration";
import type { SpeedtestTrackerIntegration } from "../speedtest-tracker/speedtest-tracker-integration";
import type { SynologyIntegration } from "../synology/synology-integration";
import type { TechnitiumDnsIntegration } from "../technitium/technitium-integration";
import type { TracearrIntegration } from "../tracearr/tracearr-integration";
import type { TraefikIntegration } from "../traefik/traefik-integration";
import type { TrueNasIntegration } from "../truenas/truenas-integration";
import type { UmamiIntegration } from "../umami/umami-integration";
import type { UnifiControllerIntegration } from "../unifi-controller/unifi-controller-integration";
import type { UnraidIntegration } from "../unraid/unraid-integration";
import type { UptimeKumaIntegration } from "../uptime-kuma/uptime-kuma-integration";
export interface IntegrationInstanceMap {
anchor: AnchorIntegration;
adGuardHome: AdGuardHomeIntegration;
archiveTeamWarrior: ArchiveTeamWarriorIntegration;
aria2: Aria2Integration;
audiobookshelf: AudiobookshelfIntegration;
bazarr: BazarrIntegration;
beszel: BeszelIntegration;
coolify: CoolifyIntegration;
dashDot: DashDotIntegration;
deluge: DelugeIntegration;
emby: EmbyIntegration;
glances: GlancesIntegration;
gluetun: GluetunIntegration;
gotify: GotifyIntegration;
homeAssistant: HomeAssistantIntegration;
ical: ICalIntegration;
immich: ImmichIntegration;
jellyfin: JellyfinIntegration;
jellyseerr: JellyseerrIntegration;
lidarr: LidarrIntegration;
mock: MockIntegration;
navidrome: NavidromeIntegration;
nextcloud: NextcloudIntegration;
ntfy: NTFYIntegration;
nzbGet: NzbGetIntegration;
openmediavault: OpenMediaVaultIntegration;
opnsense: OPNsenseIntegration;
overseerr: OverseerrIntegration;
paperlessNgx: PaperlessNgxIntegration;
patchmon: PatchMonIntegration;
peaNut: PeaNutIntegration;
piHole: PiHoleIntegrationV5 | PiHoleIntegrationV6;
plex: PlexIntegration;
prowlarr: ProwlarrIntegration;
proxmox: ProxmoxIntegration;
qBittorrent: QBitTorrentIntegration;
radarr: RadarrIntegration;
readarr: ReadarrIntegration;
sabNzbd: SabnzbdIntegration;
seerr: SeerrIntegration;
slskd: SlskdIntegration;
sonarr: SonarrIntegration;
speedtestTracker: SpeedtestTrackerIntegration;
synology: SynologyIntegration;
tdarr: TdarrIntegration;
technitiumDns: TechnitiumDnsIntegration;
tracearr: TracearrIntegration;
traefik: TraefikIntegration;
transmission: TransmissionIntegration;
truenas: TrueNasIntegration;
umami: UmamiIntegration;
unifiController: UnifiControllerIntegration;
unraid: UnraidIntegration;
uptimeKuma: UptimeKumaIntegration;
}
export type IntegrationInstanceOfKind<TKind extends IntegrationKind> = TKind extends keyof IntegrationInstanceMap
? IntegrationInstanceMap[TKind]
: never;