Skip to content
← 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.

FollowFork

Files

versions.ts

65 lines · 1.8 KB · TypeScript
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
}