import { env } from '../env'; import { resolveAuthSecret } from '../secret'; import { loadYaml, clearYamlCache, validateUuid } from './parser'; import { resolveTheme, VALID_LAYOUTS } from './theme'; import { slugify, AppConfig, SubpageConfig, SubpageSectionConfig, SubpageObjectValue, GalleryYaml, SettingsYaml, GridConfig, } from './schema'; export * from './schema'; export * from './theme'; /** Invalidate the cached YAML so the next getConfig() call re-parses the files. */ export function invalidateConfigCache(): void { clearYamlCache(); } /** Converts raw YAML grid overrides into a typed partial GridConfig. */ export function buildSubpageGrid(raw?: { columns?: number; gap?: number; aspectRatio?: string; layout?: string; }): { grid: Partial } | Record { if (!raw) return {}; return { grid: { ...(raw.columns != null ? { columns: raw.columns } : {}), ...(raw.gap != null ? { gap: raw.gap } : {}), ...(raw.aspectRatio != null ? { aspectRatio: raw.aspectRatio } : {}), ...(raw.layout != null ? { layout: (VALID_LAYOUTS.includes(raw.layout) ? raw.layout : 'masonry') as GridConfig['layout'], } : {}), }, }; } export function getConfig(): AppConfig { // No in-memory config cache: admin saves can land in a different // worker/process than page rendering, so a per-worker cache goes stale // until restart. Freshness comes from the mtime-checked YAML cache in // loadYaml() — a statSync per file, negligible next to Immich API calls. const apiUrl = env.IMMICH_API_URL; const apiKey = env.IMMICH_API_KEY; const authSecret = resolveAuthSecret(); const gallery = loadYaml('gallery.yaml'); const settings = loadYaml('settings.yaml') || {}; if (!gallery || !apiKey || !apiUrl) { // Return dummy config if gallery.yaml is missing return { immich: { apiUrl: `${apiUrl}/api`, apiKey }, authSecret, albums: [], standaloneAlbums: [], subpages: [], siteTitle: env.SITE_TITLE || 'Immich Folio', siteSubtitle: env.SITE_SUBTITLE || 'Setup Required', lang: 'en', seo: { title: 'Setup Required', description: 'Please configure Immich Folio', noIndex: true, noFollow: true, }, heroImages: [], exifOnHover: true, grid: { columns: 3, gap: 12, aspectRatio: '1', layout: 'masonry' }, theme: resolveTheme('studio'), footer: null, legal: { enabled: false, name: '', address: '', zipCity: '', country: '' }, map: false, transitions: false, albumOverrides: {}, albumDescriptions: {}, albumPasswords: {}, albumHeroImages: {}, cacheTtl: env.CACHE_TTL * 1000, rateLimitRpm: env.RATE_LIMIT_RPM, trustedProxyHops: env.TRUSTED_PROXY_HOPS, needsSetup: true, }; } const theme = resolveTheme(settings.theme); const albumOverrides: Record = {}; const albumDescriptions: Record = {}; const albumPasswords: Record = {}; const albumHeroImages: Record = {}; function processAlbumEntry( entry: | string | Record, context: string, ): string { if (typeof entry === 'string') { return validateUuid(entry, context); } const [uuid, value] = Object.entries(entry)[0]; const validatedUuid = validateUuid(uuid, context); if (typeof value === 'string') { albumOverrides[validatedUuid] = value; } else { if (value.title) albumOverrides[validatedUuid] = value.title; if (value.description) albumDescriptions[validatedUuid] = value.description; if (value.password) albumPasswords[validatedUuid] = value.password; if (value.heroImage) albumHeroImages[validatedUuid] = value.heroImage; } return validatedUuid; } const standaloneAlbumIds = (gallery.albums ?? []).map((entry) => processAlbumEntry(entry, 'gallery.yaml albums'), ); if ( standaloneAlbumIds.length === 0 && (!gallery.subpages || (Array.isArray(gallery.subpages) ? gallery.subpages.length === 0 : Object.keys(gallery.subpages).length === 0)) ) { throw new Error('gallery.yaml must define at least one album or subpage'); } let subpages: SubpageConfig[] = []; if (Array.isArray(gallery.subpages)) { subpages = gallery.subpages.map((sp) => { if (!sp.name) { throw new Error(`Subpage "(unnamed)" must have a name`); } // Parse sections if present let sections: SubpageSectionConfig[] | undefined; let albumIds: string[]; if (sp.sections && sp.sections.length > 0) { sections = sp.sections.map((sec) => ({ title: sec.title, slug: slugify(sec.title), description: sec.description, albumIds: sec.albums.map((entry) => processAlbumEntry(entry, `subpage "${sp.name}" section "${sec.title}"`), ), })); // flat union of all section albums albumIds = sections.flatMap((s) => s.albumIds); // Also include any top-level albums (outside sections) const topLevel = (sp.albums ?? []).map((entry) => processAlbumEntry(entry, `subpage "${sp.name}"`), ); albumIds = [...topLevel, ...albumIds]; } else { const albums = sp.albums ?? []; if (albums.length === 0) { throw new Error(`Subpage "${sp.name}" must have albums or sections`); } albumIds = albums.map((entry) => processAlbumEntry(entry, `subpage "${sp.name}"`)); } return { name: sp.name, slug: slugify(sp.name), title: sp.title, subtitle: sp.subtitle, albumIds, sections, password: sp.password, ...buildSubpageGrid(sp.grid), }; }); } else if (gallery.subpages) { subpages = Object.entries(gallery.subpages).map(([name, value]) => { if (Array.isArray(value)) { return { name, slug: slugify(name), albumIds: value.map((entry) => processAlbumEntry(entry, `subpage "${name}"`)), }; } const sp = value as SubpageObjectValue; const albumEntries = sp.albums || []; return { name, slug: slugify(name), title: sp.title, subtitle: sp.subtitle, albumIds: albumEntries.map((entry) => processAlbumEntry(entry, `subpage "${name}"`)), password: sp.password, ...buildSubpageGrid(sp.grid), }; }); } const subpageAlbumIds = new Set(subpages.flatMap((sp) => sp.albumIds)); const allAlbumIds = [...new Set([...standaloneAlbumIds, ...subpageAlbumIds])]; return { immich: { apiUrl: `${apiUrl}/api`, apiKey }, authSecret, albums: allAlbumIds, standaloneAlbums: standaloneAlbumIds.filter((id) => !subpageAlbumIds.has(id)), subpages, siteTitle: settings.title ?? env.SITE_TITLE, siteSubtitle: settings.subtitle ?? env.SITE_SUBTITLE, lang: settings.lang ?? 'en', seo: { title: settings.seo?.title || settings.title || env.SITE_TITLE || 'Gallery', description: settings.seo?.description || settings.subtitle || env.SITE_SUBTITLE || 'A curated photography portfolio', noIndex: settings.seo?.noIndex === true, noFollow: settings.seo?.noFollow === true, }, heroImages: gallery.hero ? (Array.isArray(gallery.hero) ? gallery.hero : [gallery.hero]).map((id) => validateUuid(id, 'gallery.yaml hero'), ) : [], exifOnHover: settings.exifOnHover !== false, grid: { columns: settings.grid?.columns ?? 3, gap: settings.grid?.gap ?? 12, aspectRatio: settings.grid?.aspectRatio ?? '1', layout: (VALID_LAYOUTS.includes(settings.grid?.layout ?? '') ? settings.grid!.layout : 'masonry') as GridConfig['layout'], }, theme, footer: settings.footer ? { name: settings.footer.name, instagram: settings.footer.instagram, email: settings.footer.email, website: settings.footer.website, } : null, legal: { enabled: settings.legal?.enabled === true, name: settings.legal?.name || '', address: settings.legal?.address || '', zipCity: settings.legal?.zipCity || '', country: settings.legal?.country || '', email: settings.legal?.email, phone: settings.legal?.phone, taxId: settings.legal?.taxId, vatId: settings.legal?.vatId, extraInfo: settings.legal?.extraInfo, }, map: settings.map === true, transitions: settings.transitions !== false, albumOverrides, albumDescriptions, albumPasswords, albumHeroImages, cacheTtl: env.CACHE_TTL * 1000, rateLimitRpm: env.RATE_LIMIT_RPM, trustedProxyHops: env.TRUSTED_PROXY_HOPS, needsSetup: false, }; }