← Public packages
@kentcdodds/photo-portfolio
A fast, photo-first portfolio site you update by chatting with your agent: galleries, about, contact, and one-step rollback.
Files
import type { SiteContent } from './types.ts'
/** How many published snapshots to keep. Older ones (and photos only they use) are cleaned up. */
export const maxRetainedVersions = 25
export type VersionEntry = {
version: number
createdAt: string
kind: 'publish' | 'rollback'
note?: string
/** For rollbacks: the version whose content was restored. */
restoredFrom?: number
galleries: number
photos: number
}
/** Newest first. `latest` keeps counting even after old entries are pruned. */
export type VersionIndex = {
latest: number
entries: Array<VersionEntry>
}
export const emptyVersionIndex: VersionIndex = { latest: 0, entries: [] }
export function recordVersion(
index: VersionIndex,
content: SiteContent,
input: {
kind: VersionEntry['kind']
note?: string
restoredFrom?: number
now: string
},
) {
const entry: VersionEntry = {
version: index.latest + 1,
createdAt: input.now,
kind: input.kind,
...(input.note?.trim() ? { note: input.note.trim() } : {}),
...(input.restoredFrom !== undefined
? { restoredFrom: input.restoredFrom }
: {}),
galleries: content.galleries.length,
photos: content.galleries.reduce((sum, g) => sum + g.photos.length, 0),
}
const entries = [entry, ...index.entries]
const kept = entries.slice(0, maxRetainedVersions)
const pruned = entries.slice(maxRetainedVersions).map((e) => e.version)
return { index: { latest: entry.version, entries: kept }, entry, pruned }
}
export function requireVersion(
index: VersionIndex,
version: number,
): VersionEntry {
const entry = index.entries.find((e) => e.version === version)
if (!entry) {
const available =
index.entries.map((e) => e.version).join(', ') || 'none yet'
throw new Error(
`Version ${version} is not available. Available versions: ${available}.`,
)
}
return entry
}