Self-hosted personal gallery application with online photo management and albums, supporting Live/Motion Photos, EXIF parsing, geolocation recognition, and an explore map.
TypeScript albumsexif-extractiongeocodinglive-photomotion-photophoto-galleryphoto-sharingwebgl-viewer
import { slugify } from 'transliteration'
import { CoreError } from './errors.ts'
import {
ALBUM_SLUG_MAX_LENGTH,
isNumericAlbumPathSegment,
isValidAlbumSlug,
} from '@chronoframe/contracts/album-slug'
/** Convert a title to a stable, URL-safe base. Persistence owns uniqueness. */
export function generatedAlbumSlug(title: string, fallback = 'album'): string {
const result = slugify(title.normalize('NFKC'), {
separator: '-',
lowercase: true,
})
.replace(/[^a-z0-9]+/g, '-')
.replace(/^-+|-+$/g, '')
.slice(0, ALBUM_SLUG_MAX_LENGTH)
.replace(/-+$/g, '')
if (!result) return fallback
return isNumericAlbumPathSegment(result)
? `album-${result.slice(0, ALBUM_SLUG_MAX_LENGTH - 6)}`
: result
}
/** Keep a manually chosen slug exact after trimming surrounding whitespace. */
export function validateCustomAlbumSlug(input: string): string {
const slug = input.trim()
if (!isValidAlbumSlug(slug))
throw new CoreError(400, 'Invalid album URL slug')
return slug
}
export function suffixedAlbumSlug(base: string, suffix: number): string {
if (suffix === 0) return base
const ending = `-${suffix}`
return `${base.slice(0, ALBUM_SLUG_MAX_LENGTH - ending.length).replace(/-+$/g, '')}${ending}`
}