Skip to content

High performance self-hosted photo and video management solution.

3.6 KB
Raw Blame
import 'package:pigeon/pigeon.dart';

@ConfigurePigeon(
  PigeonOptions(
    dartOut: 'lib/platform/native_sync_api.g.dart',
    swiftOut: 'ios/Runner/Sync/Messages.g.swift',
    swiftOptions: SwiftOptions(),
    kotlinOut: 'android/app/src/main/kotlin/app/alextran/immich/sync/Messages.g.kt',
    kotlinOptions: KotlinOptions(package: 'app.alextran.immich.sync'),
    dartOptions: DartOptions(),
    dartPackageName: 'immich_mobile',
  ),
)
const String kUnsupportedOSError = 'UNSUPPORTED_OS';

enum PlatformAssetPlaybackStyle { unknown, image, video, imageAnimated, livePhoto, videoLooping }

class PlatformAsset {
  final String id;
  final String name;

  // Follows AssetType enum from base_asset.model.dart
  final int type;

  // Seconds since epoch
  final int? createdAt;
  final int? updatedAt;
  final int? width;
  final int? height;
  final int durationMs;
  final int orientation;
  final bool isFavorite;

  final int? adjustmentTime;
  final double? latitude;
  final double? longitude;

  final PlatformAssetPlaybackStyle playbackStyle;

  const PlatformAsset({
    required this.id,
    required this.name,
    required this.type,
    this.createdAt,
    this.updatedAt,
    this.width,
    this.height,
    this.durationMs = 0,
    this.orientation = 0,
    this.isFavorite = false,
    this.adjustmentTime,
    this.latitude,
    this.longitude,
    this.playbackStyle = PlatformAssetPlaybackStyle.unknown,
  });
}

class PlatformAlbum {
  final String id;
  final String name;

  // Seconds since epoch
  final int? updatedAt;
  final bool isCloud;
  final int assetCount;

  const PlatformAlbum({
    required this.id,
    required this.name,
    this.updatedAt,
    this.isCloud = false,
    this.assetCount = 0,
  });
}

class SyncDelta {
  final bool hasChanges;
  final List<PlatformAsset> updates;
  final List<String> deletes;

  // Asset -> Album mapping
  final Map<String, List<String>> assetAlbums;

  const SyncDelta({
    this.hasChanges = false,
    this.updates = const [],
    this.deletes = const [],
    this.assetAlbums = const {},
  });
}

class HashResult {
  final String assetId;
  final String? error;
  final String? hash;

  const HashResult({required this.assetId, this.error, this.hash});
}

enum CloudIdErrorKind {
  // PHPhotosErrorIdentifierNotFound
  notFound,
  // PHPhotosErrorMultipleIdentifiersFound
  ambiguous,
  // PhotoKit returned a partially synced identifier ("GUID:ID:" with no trailing hash)
  incomplete,
  unknown,
}

class CloudIdResult {
  final String assetId;
  final String? error;
  final String? cloudId;
  final CloudIdErrorKind? errorKind;

  const CloudIdResult({required this.assetId, this.error, this.cloudId, this.errorKind});
}

@HostApi()
abstract class NativeSyncApi {
  @async
  bool shouldFullSync();

  @async
  SyncDelta getMediaChanges();

  void checkpointSync();

  void clearSyncCheckpoint();

  @async
  List<String> getAssetIdsForAlbum(String albumId);

  @async
  List<PlatformAlbum> getAlbums();

  @TaskQueue(type: TaskQueueType.serialBackgroundThread)
  int getAssetsCountSince(String albumId, int timestamp);

  @async
  List<PlatformAsset> getAssetsForAlbum(String albumId, {int? updatedTimeCond});

  @async
  @TaskQueue(type: TaskQueueType.serialBackgroundThread)
  List<HashResult> hashAssets(List<String> assetIds, {bool allowNetworkAccess = false});

  void cancelHashing();

  void cancelSync();

  @TaskQueue(type: TaskQueueType.serialBackgroundThread)
  Map<String, List<PlatformAsset>> getTrashedAssets();

  @async
  bool restoreFromTrashById(String mediaId, int type);

  @TaskQueue(type: TaskQueueType.serialBackgroundThread)
  List<CloudIdResult> getCloudIdForAssetIds(List<String> assetIds);
}