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

add-photos.ts

74 lines · 2.2 KB · TypeScript
import { packageStorage } from 'kody:runtime'
import * as s from 'remix/data-schema'
import {
	addPhotos,
	requireGallery,
	summarizeGallery,
} from './domain/content.ts'
import { parseInput, strictObject } from './domain/validation.ts'
import {
	ingestPhotos,
	photoBatchSchema,
	type PhotoInput,
} from './images/ingest.ts'
import { nowIso, siteLinks } from './site-links.ts'
import { discardMedia, readDraft, writeDraft } from './store/site-store.ts'

export type AddPhotosInput = {
	gallery: string
	photos: Array<PhotoInput>
	position?: 'start' | 'end'
}

const addPhotosInput = strictObject({
	gallery: s.string(),
	photos: photoBatchSchema,
	position: s.optional(s.enum_(['start', 'end'] as const)),
})

/**
 * Add 1–6 photos to an existing gallery in the draft (same processing as
 * add-gallery). For a big shoot, call it repeatedly with batches.
 *
 * @param raw - `{ gallery: slug | id, photos: [{ url | base64, alt?, caption? }], position?: 'start' | 'end' (default 'end') }`
 * @returns `{ gallery, added: [photoId…], previewUrl, liveUrl }`
 *
 * @example
 * import addPhotos from 'kody:@kentcdodds/photo-portfolio/add-photos'
 * await addPhotos({
 *   gallery: 'smith-family-fall-2026',
 *   photos: [{ url: 'https://example.com/smith-3.jpg', alt: 'Grandma holding the baby' }],
 * })
 */
export default async function addPhotosExport(raw: AddPhotosInput) {
	const input = parseInput<AddPhotosInput>(addPhotosInput, raw, 'add-photos')
	const storage = packageStorage()
	const now = nowIso()
	const draft = await readDraft(storage)
	const gallery = requireGallery(draft, input.gallery)
	const photos = await ingestPhotos(storage, input.photos, {
		config: draft.config,
		fallbackAlt: `Photo from ${gallery.title}`,
		now,
	})
	let result: ReturnType<typeof addPhotos>
	try {
		result = addPhotos(draft, gallery.id, photos, input.position ?? 'end', now)
	} catch (error) {
		await discardMedia(
			storage,
			photos.map((photo) => photo.id),
		)
		throw error
	}
	await writeDraft(storage, result.content)
	return {
		gallery: summarizeGallery(result.gallery),
		added: photos.map((photo) => photo.id),
		...(await siteLinks(
			storage,
			result.content.config,
			`/galleries/${result.gallery.slug}`,
		)),
	}
}