immich/server/src/domain/repositories/metadata.repository.ts

import { Tags } from 'exiftool-vendored';
import { InitOptions } from 'local-reverse-geocoder';

export const IMetadataRepository = 'IMetadataRepository';

export interface GeoPoint {
  latitude: number;
  longitude: number;
}

export interface ReverseGeocodeResult {
  country: string | null;
  state: string | null;
  city: string | null;
}

export interface ImmichTags extends Omit<Tags, 'FocalLength'> {
  ContentIdentifier?: string;
  MotionPhoto?: number;
  MotionPhotoVersion?: number;
  MotionPhotoPresentationTimestampUs?: number;
  MediaGroupUUID?: string;
  ImagePixelDepth?: string;
  FocalLength?: number;
}

export interface IMetadataRepository {
  init(options: Partial<InitOptions>): Promise<void>;
  teardown(): Promise<void>;
  reverseGeocode(point: GeoPoint): Promise<ReverseGeocodeResult>;
  deleteCache(): Promise<void>;
  getExifTags(path: string): Promise<ImmichTags | null>;
}