412 lines
12 KiB
TypeScript
412 lines
12 KiB
TypeScript
import type { ExifData } from 'ts-exif-parser';
|
|
import { DEFAULT_ASPECT_RATIO, Photo, PhotoDbInsert, PhotoExif } from '..';
|
|
import {
|
|
convertTimestampToNaivePostgresString,
|
|
convertTimestampWithOffsetToPostgresString,
|
|
generateLocalNaivePostgresString,
|
|
generateLocalPostgresString,
|
|
validationMessageNaivePostgresDateString,
|
|
validationMessagePostgresDateString,
|
|
} from '@/utility/date';
|
|
import {
|
|
convertApertureValueToFNumber,
|
|
getAspectRatioFromExif,
|
|
getOffsetFromExif,
|
|
} from '@/utility/exif';
|
|
import { roundToNumber } from '@/utility/number';
|
|
import { convertStringToArray, parameterize } from '@/utility/string';
|
|
import { generateNanoid } from '@/utility/nanoid';
|
|
import { FilmSimulation } from '@/film';
|
|
import { GEO_PRIVACY_ENABLED } from '@/app/config';
|
|
import { TAG_FAVS, getValidationMessageForTags } from '@/tag';
|
|
import { MAKE_FUJIFILM } from '@/platforms/fujifilm';
|
|
import { FujifilmRecipe } from '@/platforms/fujifilm/recipe';
|
|
|
|
type VirtualFields =
|
|
'favorite' |
|
|
'applyRecipeTitleGlobally' |
|
|
'shouldStripGpsData';
|
|
|
|
export type FormFields = keyof PhotoDbInsert | VirtualFields;
|
|
|
|
export type PhotoFormData = Record<FormFields, string>
|
|
|
|
export type FieldSetType =
|
|
'text' |
|
|
'email' |
|
|
'password' |
|
|
'checkbox' |
|
|
'textarea' |
|
|
'hidden';
|
|
|
|
export type AnnotatedTag = {
|
|
value: string,
|
|
annotation?: string,
|
|
annotationAria?: string,
|
|
};
|
|
|
|
export type FormMeta = {
|
|
label: string
|
|
note?: string
|
|
noteShort?: string
|
|
required?: boolean
|
|
excludeFromInsert?: boolean
|
|
readOnly?: boolean
|
|
hideModificationStatus?: boolean
|
|
validate?: (value?: string) => string | undefined
|
|
validateStringMaxLength?: number
|
|
spellCheck?: boolean
|
|
capitalize?: boolean
|
|
hideIfEmpty?: boolean
|
|
shouldHide?: (
|
|
formData: Partial<PhotoFormData>,
|
|
changedFormKeys?: (keyof PhotoFormData)[],
|
|
) => boolean
|
|
loadingMessage?: string
|
|
type?: FieldSetType
|
|
selectOptions?: { value: string, label: string }[]
|
|
selectOptionsDefaultLabel?: string
|
|
tagOptions?: AnnotatedTag[]
|
|
tagOptionsLimit?: number
|
|
tagOptionsLimitValidationMessage?: string
|
|
shouldNotOverwriteWithNullDataOnSync?: boolean
|
|
isJson?: boolean
|
|
staticValue?: string
|
|
};
|
|
|
|
const STRING_MAX_LENGTH_SHORT = 255;
|
|
const STRING_MAX_LENGTH_LONG = 1000;
|
|
|
|
const FORM_METADATA = (
|
|
tagOptions?: AnnotatedTag[],
|
|
recipeOptions?: AnnotatedTag[],
|
|
filmOptions?: AnnotatedTag[],
|
|
aiTextGeneration?: boolean,
|
|
shouldStripGpsData?: boolean,
|
|
): Record<keyof PhotoFormData, FormMeta> => ({
|
|
title: {
|
|
label: 'title',
|
|
capitalize: true,
|
|
validateStringMaxLength: STRING_MAX_LENGTH_SHORT,
|
|
},
|
|
caption: {
|
|
label: 'caption',
|
|
capitalize: true,
|
|
validateStringMaxLength: STRING_MAX_LENGTH_LONG,
|
|
shouldHide: ({ title, caption }) =>
|
|
!aiTextGeneration && (!title && !caption),
|
|
},
|
|
tags: {
|
|
label: 'tags',
|
|
tagOptions,
|
|
validate: getValidationMessageForTags,
|
|
},
|
|
semanticDescription: {
|
|
type: 'textarea',
|
|
label: 'semantic description (not visible)',
|
|
capitalize: true,
|
|
validateStringMaxLength: STRING_MAX_LENGTH_LONG,
|
|
shouldHide: () => !aiTextGeneration,
|
|
},
|
|
id: { label: 'id', readOnly: true, hideIfEmpty: true },
|
|
blurData: {
|
|
label: 'blur data',
|
|
readOnly: true,
|
|
},
|
|
url: { label: 'storage url', readOnly: true },
|
|
extension: { label: 'extension', readOnly: true },
|
|
aspectRatio: { label: 'aspect ratio', readOnly: true },
|
|
make: { label: 'camera make' },
|
|
model: { label: 'camera model' },
|
|
film: {
|
|
label: 'film',
|
|
note: 'Intended for Fujifilm simulations and analog scans',
|
|
noteShort: 'Fujifilm simulations / analog scans',
|
|
tagOptions: filmOptions,
|
|
tagOptionsLimitValidationMessage: 'Photos can only have one film',
|
|
tagOptionsLimit: 1,
|
|
shouldNotOverwriteWithNullDataOnSync: true,
|
|
},
|
|
recipeTitle: {
|
|
label: 'recipe title',
|
|
tagOptions: recipeOptions,
|
|
tagOptionsLimit: 1,
|
|
tagOptionsLimitValidationMessage: 'Photos can only have one recipe',
|
|
spellCheck: false,
|
|
capitalize: false,
|
|
shouldHide: ({ make }) => make !== MAKE_FUJIFILM,
|
|
},
|
|
applyRecipeTitleGlobally: {
|
|
label: 'apply recipe title globally',
|
|
type: 'checkbox',
|
|
excludeFromInsert: true,
|
|
hideModificationStatus: true,
|
|
shouldHide: ({ make, recipeTitle, recipeData }, changedFormKeys) =>
|
|
!(
|
|
make === MAKE_FUJIFILM &&
|
|
recipeData &&
|
|
recipeTitle &&
|
|
changedFormKeys?.includes('recipeTitle')
|
|
),
|
|
},
|
|
recipeData: {
|
|
type: 'textarea',
|
|
label: 'recipe data',
|
|
spellCheck: false,
|
|
capitalize: false,
|
|
shouldHide: ({ make }) => make !== MAKE_FUJIFILM,
|
|
shouldNotOverwriteWithNullDataOnSync: true,
|
|
isJson: true,
|
|
validate: value => {
|
|
let validationMessage = undefined;
|
|
if (value) {
|
|
try {
|
|
JSON.parse(value);
|
|
} catch {
|
|
validationMessage = 'Invalid JSON';
|
|
}
|
|
}
|
|
return validationMessage;
|
|
},
|
|
},
|
|
focalLength: { label: 'focal length' },
|
|
focalLengthIn35MmFormat: { label: 'focal length 35mm-equivalent' },
|
|
lensMake: { label: 'lens make' },
|
|
lensModel: { label: 'lens model' },
|
|
fNumber: { label: 'aperture' },
|
|
iso: { label: 'ISO' },
|
|
exposureTime: { label: 'exposure time' },
|
|
exposureCompensation: { label: 'exposure compensation' },
|
|
locationName: { label: 'location name', shouldHide: () => true },
|
|
latitude: { label: 'latitude' },
|
|
longitude: { label: 'longitude' },
|
|
takenAt: {
|
|
label: 'taken at',
|
|
validate: validationMessagePostgresDateString,
|
|
},
|
|
takenAtNaive: {
|
|
label: 'taken at (naive)',
|
|
validate: validationMessageNaivePostgresDateString,
|
|
},
|
|
priorityOrder: { label: 'priority order' },
|
|
favorite: { label: 'favorite', type: 'checkbox', excludeFromInsert: true },
|
|
hidden: { label: 'hidden', type: 'checkbox' },
|
|
shouldStripGpsData: {
|
|
label: 'strip gps data',
|
|
type: 'hidden',
|
|
excludeFromInsert: true,
|
|
staticValue: shouldStripGpsData ? 'true' : 'false',
|
|
},
|
|
});
|
|
|
|
export const FIELDS_WITH_JSON = Object.entries(FORM_METADATA())
|
|
.filter(([_, meta]) => meta.isJson)
|
|
.map(([key]) => key as keyof PhotoFormData);
|
|
|
|
export const FIELDS_TO_NOT_OVERWRITE_WITH_NULL_DATA_ON_SYNC =
|
|
Object.entries(FORM_METADATA())
|
|
.filter(([_, meta]) => meta.shouldNotOverwriteWithNullDataOnSync)
|
|
.map(([key]) => key as keyof PhotoFormData);
|
|
|
|
export const FORM_METADATA_ENTRIES = (
|
|
...args: Parameters<typeof FORM_METADATA>
|
|
) =>
|
|
(Object.entries(FORM_METADATA(...args)) as [keyof PhotoFormData, FormMeta][]);
|
|
|
|
export const convertFormKeysToLabels = (keys: (keyof PhotoFormData)[]) =>
|
|
keys.map(key => FORM_METADATA()[key].label.toUpperCase());
|
|
|
|
export const getFormErrors = (
|
|
formData: Partial<PhotoFormData>,
|
|
): Partial<Record<keyof PhotoFormData, string>> =>
|
|
Object.keys(formData).reduce((acc, key) => ({
|
|
...acc,
|
|
[key]: FORM_METADATA_ENTRIES().find(([k]) => k === key)?.[1]
|
|
.validate?.(formData[key as keyof PhotoFormData]),
|
|
}), {});
|
|
|
|
export const isFormValid = (formData: Partial<PhotoFormData>) =>
|
|
FORM_METADATA_ENTRIES().every(
|
|
([key, { required, validate, validateStringMaxLength }]) =>
|
|
(!required || Boolean(formData[key])) &&
|
|
(!validate?.(formData[key])) &&
|
|
// eslint-disable-next-line max-len
|
|
(!validateStringMaxLength || (formData[key]?.length ?? 0) <= validateStringMaxLength),
|
|
);
|
|
|
|
export const formHasTextContent = ({
|
|
title,
|
|
caption,
|
|
tags,
|
|
semanticDescription,
|
|
}: Partial<PhotoFormData>) =>
|
|
Boolean(title || caption || tags || semanticDescription);
|
|
|
|
// CREATE FORM DATA: FROM PHOTO
|
|
|
|
export const convertPhotoToFormData = (photo: Photo): PhotoFormData => {
|
|
const valueForKey = (key: keyof Photo, value: any) => {
|
|
switch (key) {
|
|
case 'tags':
|
|
return (value ?? [])
|
|
.filter((tag: string) => tag !== TAG_FAVS)
|
|
.join(', ');
|
|
case 'takenAt':
|
|
return value?.toISOString ? value.toISOString() : value;
|
|
case 'hidden':
|
|
return value ? 'true' : 'false';
|
|
case 'recipeData':
|
|
return JSON.stringify(value);
|
|
default:
|
|
return value !== undefined && value !== null
|
|
? value.toString()
|
|
: undefined;
|
|
}
|
|
};
|
|
return Object.entries(photo).reduce((photoForm, [key, value]) => ({
|
|
...photoForm,
|
|
[key]: valueForKey(key as keyof Photo, value),
|
|
}), {
|
|
favorite: photo.tags.includes(TAG_FAVS) ? 'true' : 'false',
|
|
} as PhotoFormData);
|
|
};
|
|
|
|
// CREATE FORM DATA: FROM EXIF
|
|
|
|
export const convertExifToFormData = (
|
|
data: ExifData,
|
|
film?: FilmSimulation,
|
|
recipeData?: FujifilmRecipe,
|
|
): Omit<
|
|
Record<keyof PhotoExif, string | undefined>,
|
|
'takenAt' | 'takenAtNaive'
|
|
> => ({
|
|
aspectRatio: getAspectRatioFromExif(data).toString(),
|
|
make: data.tags?.Make,
|
|
model: data.tags?.Model,
|
|
focalLength: data.tags?.FocalLength?.toString(),
|
|
focalLengthIn35MmFormat: data.tags?.FocalLengthIn35mmFormat?.toString(),
|
|
lensMake: data.tags?.LensMake,
|
|
lensModel: data.tags?.LensModel,
|
|
fNumber: (
|
|
data.tags?.FNumber?.toString() ||
|
|
convertApertureValueToFNumber(data.tags?.ApertureValue)
|
|
),
|
|
iso: data.tags?.ISO?.toString() || data.tags?.ISOSpeed?.toString(),
|
|
exposureTime: data.tags?.ExposureTime?.toString(),
|
|
exposureCompensation: data.tags?.ExposureCompensation?.toString(),
|
|
latitude:
|
|
!GEO_PRIVACY_ENABLED ? data.tags?.GPSLatitude?.toString() : undefined,
|
|
longitude:
|
|
!GEO_PRIVACY_ENABLED ? data.tags?.GPSLongitude?.toString() : undefined,
|
|
film,
|
|
recipeData: JSON.stringify(recipeData),
|
|
...data.tags?.DateTimeOriginal && {
|
|
takenAt: convertTimestampWithOffsetToPostgresString(
|
|
data.tags.DateTimeOriginal,
|
|
getOffsetFromExif(data),
|
|
),
|
|
takenAtNaive:
|
|
convertTimestampToNaivePostgresString(data.tags.DateTimeOriginal),
|
|
},
|
|
});
|
|
|
|
// PREPARE FORM FOR DB INSERT
|
|
|
|
export const convertFormDataToPhotoDbInsert = (
|
|
formData: FormData | Partial<PhotoFormData>,
|
|
): PhotoDbInsert => {
|
|
const photoForm = formData instanceof FormData
|
|
? Object.fromEntries(formData) as PhotoFormData
|
|
: formData;
|
|
|
|
// Capture tags before 'favorite' is excluded from insert
|
|
const tags = convertStringToArray(photoForm.tags) ?? [];
|
|
if (photoForm.favorite === 'true') {
|
|
tags.push(TAG_FAVS);
|
|
}
|
|
|
|
// Parse FormData:
|
|
// - remove server action ID
|
|
// - remove empty strings
|
|
// - remove fields excluded from insert
|
|
// - trim strings
|
|
Object.keys(photoForm).forEach(key => {
|
|
const meta = FORM_METADATA()[key as keyof PhotoFormData];
|
|
if (
|
|
key.startsWith('$ACTION_ID_') ||
|
|
(photoForm as any)[key] === '' ||
|
|
meta?.excludeFromInsert
|
|
) {
|
|
delete (photoForm as any)[key];
|
|
} else if (typeof (photoForm as any)[key] === 'string') {
|
|
(photoForm as any)[key] = (photoForm as any)[key].trim();
|
|
}
|
|
});
|
|
|
|
return {
|
|
...(photoForm as PhotoFormData & {
|
|
film?: FilmSimulation
|
|
recipeData?: FujifilmRecipe
|
|
}),
|
|
...!photoForm.id && { id: generateNanoid() },
|
|
// Delete array field when empty
|
|
tags: tags.length > 0 ? tags : undefined,
|
|
...photoForm.recipeTitle && {
|
|
recipeTitle: parameterize(photoForm.recipeTitle),
|
|
},
|
|
// Convert form strings to numbers
|
|
aspectRatio: photoForm.aspectRatio
|
|
? roundToNumber(parseFloat(photoForm.aspectRatio), 6)
|
|
: DEFAULT_ASPECT_RATIO,
|
|
focalLength: photoForm.focalLength
|
|
? parseInt(photoForm.focalLength)
|
|
: undefined,
|
|
focalLengthIn35MmFormat: photoForm.focalLengthIn35MmFormat
|
|
? parseInt(photoForm.focalLengthIn35MmFormat)
|
|
: undefined,
|
|
fNumber: photoForm.fNumber
|
|
? parseFloat(photoForm.fNumber)
|
|
: undefined,
|
|
latitude: photoForm.latitude
|
|
? parseFloat(photoForm.latitude)
|
|
: undefined,
|
|
longitude: photoForm.longitude
|
|
? parseFloat(photoForm.longitude)
|
|
: undefined,
|
|
iso: photoForm.iso
|
|
? parseInt(photoForm.iso)
|
|
: undefined,
|
|
exposureTime: photoForm.exposureTime
|
|
? parseFloat(photoForm.exposureTime)
|
|
: undefined,
|
|
exposureCompensation: photoForm.exposureCompensation
|
|
? parseFloat(photoForm.exposureCompensation)
|
|
: undefined,
|
|
priorityOrder: photoForm.priorityOrder
|
|
? parseFloat(photoForm.priorityOrder)
|
|
: undefined,
|
|
hidden: photoForm.hidden === 'true',
|
|
...generateTakenAtFields(photoForm),
|
|
};
|
|
};
|
|
|
|
export const getChangedFormFields = (
|
|
original: Partial<PhotoFormData>,
|
|
current: Partial<PhotoFormData>,
|
|
) => {
|
|
return Object
|
|
.keys(current)
|
|
.filter(key =>
|
|
(original[key as keyof PhotoFormData] ?? '') !==
|
|
(current[key as keyof PhotoFormData] ?? ''),
|
|
) as (keyof PhotoFormData)[];
|
|
};
|
|
|
|
export const generateTakenAtFields = (
|
|
form?: Partial<PhotoFormData>,
|
|
): { takenAt: string, takenAtNaive: string } => ({
|
|
takenAt: form?.takenAt || generateLocalPostgresString(),
|
|
takenAtNaive: form?.takenAtNaive || generateLocalNaivePostgresString(),
|
|
});
|