feat(server) Tagging system (#1046)

.gitattributes

@@ -0,0 +1,13 @@
+mobile/openapi/**/*.md -diff -merge
+mobile/openapi/**/*.md linguist-generated=true
+mobile/openapi/**/*.dart -diff -merge
+mobile/openapi/**/*.dart linguist-generated=true
+
+web/src/api/open-api/**/*.md -diff -merge
+web/src/api/open-api/**/*.md linguist-generated=true
+
+web/src/api/open-api/**/*.ts -diff -merge
+web/src/api/open-api/**/*.ts linguist-generated=true
+
+mobile/openapi/.openapi-generator/FILES -diff -merge
+mobile/openapi/.openapi-generator/FILES linguist-generated=true

Makefile

@@ -27,3 +27,6 @@ prod-scale:
 
 api:
 	cd ./server && npm run api:generate
+
+attach-server:
+	docker exec -it docker_immich-server_1 sh

NOTES.md

@@ -1,9 +0,0 @@
-# TODO
-
-Server scenario with web
-
-[ ] 1 user exist without admin right -> make admin on first check
-
-[ ] 2 users exist without admin right -> ask user to choose which account will be the admin
-
-[ X ] No users exist -> prompt signup form for Admin

mobile/openapi/.openapi-generator/FILES

@@ -14,6 +14,7 @@ doc/AssetApi.md
 doc/AssetCountByTimeBucket.md
 doc/AssetCountByTimeBucketResponseDto.md
 doc/AssetCountByUserIdResponseDto.md
+doc/AssetEntity.md
 doc/AssetFileUploadResponseDto.md
 doc/AssetResponseDto.md
 doc/AssetTypeEnum.md
@@ -25,6 +26,7 @@ doc/CheckExistingAssetsResponseDto.md
 doc/CreateAlbumDto.md
 doc/CreateDeviceInfoDto.md
 doc/CreateProfileImageResponseDto.md
+doc/CreateTagDto.md
 doc/CreateUserDto.md
 doc/CuratedLocationsResponseDto.md
 doc/CuratedObjectsResponseDto.md
@@ -34,6 +36,7 @@ doc/DeleteAssetStatus.md
 doc/DeviceInfoApi.md
 doc/DeviceInfoResponseDto.md
 doc/DeviceTypeEnum.md
+doc/ExifEntity.md
 doc/ExifResponseDto.md
 doc/GetAssetByTimeBucketDto.md
 doc/GetAssetCountByTimeBucketDto.md
@@ -58,20 +61,27 @@ doc/ServerPingResponse.md
 doc/ServerStatsResponseDto.md
 doc/ServerVersionReponseDto.md
 doc/SignUpDto.md
+doc/SmartInfoEntity.md
 doc/SmartInfoResponseDto.md
 doc/SystemConfigApi.md
 doc/SystemConfigKey.md
 doc/SystemConfigResponseDto.md
 doc/SystemConfigResponseItem.md
+doc/TagApi.md
+doc/TagEntity.md
+doc/TagResponseDto.md
+doc/TagTypeEnum.md
 doc/ThumbnailFormat.md
 doc/TimeGroupEnum.md
 doc/UpdateAlbumDto.md
 doc/UpdateAssetDto.md
 doc/UpdateDeviceInfoDto.md
+doc/UpdateTagDto.md
 doc/UpdateUserDto.md
 doc/UsageByUserDto.md
 doc/UserApi.md
 doc/UserCountResponseDto.md
+doc/UserEntity.md
 doc/UserResponseDto.md
 doc/ValidateAccessTokenResponseDto.md
 git_push.sh
@@ -84,6 +94,7 @@ lib/api/job_api.dart
 lib/api/o_auth_api.dart
 lib/api/server_info_api.dart
 lib/api/system_config_api.dart
+lib/api/tag_api.dart
 lib/api/user_api.dart
 lib/api_client.dart
 lib/api_exception.dart
@@ -103,6 +114,7 @@ lib/model/all_job_status_response_dto.dart
 lib/model/asset_count_by_time_bucket.dart
 lib/model/asset_count_by_time_bucket_response_dto.dart
 lib/model/asset_count_by_user_id_response_dto.dart
+lib/model/asset_entity.dart
 lib/model/asset_file_upload_response_dto.dart
 lib/model/asset_response_dto.dart
 lib/model/asset_type_enum.dart
@@ -113,6 +125,7 @@ lib/model/check_existing_assets_response_dto.dart
 lib/model/create_album_dto.dart
 lib/model/create_device_info_dto.dart
 lib/model/create_profile_image_response_dto.dart
+lib/model/create_tag_dto.dart
 lib/model/create_user_dto.dart
 lib/model/curated_locations_response_dto.dart
 lib/model/curated_objects_response_dto.dart
@@ -121,6 +134,7 @@ lib/model/delete_asset_response_dto.dart
 lib/model/delete_asset_status.dart
 lib/model/device_info_response_dto.dart
 lib/model/device_type_enum.dart
+lib/model/exif_entity.dart
 lib/model/exif_response_dto.dart
 lib/model/get_asset_by_time_bucket_dto.dart
 lib/model/get_asset_count_by_time_bucket_dto.dart
@@ -142,18 +156,24 @@ lib/model/server_ping_response.dart
 lib/model/server_stats_response_dto.dart
 lib/model/server_version_reponse_dto.dart
 lib/model/sign_up_dto.dart
+lib/model/smart_info_entity.dart
 lib/model/smart_info_response_dto.dart
 lib/model/system_config_key.dart
 lib/model/system_config_response_dto.dart
 lib/model/system_config_response_item.dart
+lib/model/tag_entity.dart
+lib/model/tag_response_dto.dart
+lib/model/tag_type_enum.dart
 lib/model/thumbnail_format.dart
 lib/model/time_group_enum.dart
 lib/model/update_album_dto.dart
 lib/model/update_asset_dto.dart
 lib/model/update_device_info_dto.dart
+lib/model/update_tag_dto.dart
 lib/model/update_user_dto.dart
 lib/model/usage_by_user_dto.dart
 lib/model/user_count_response_dto.dart
+lib/model/user_entity.dart
 lib/model/user_response_dto.dart
 lib/model/validate_access_token_response_dto.dart
 pubspec.yaml

server/apps/immich/src/api-v1/album/album.module.ts

@@ -1,32 +1,29 @@
-import { Module } from '@nestjs/common';
+import { forwardRef, Module } from '@nestjs/common';
 import { AlbumService } from './album.service';
 import { AlbumController } from './album.controller';
 import { TypeOrmModule } from '@nestjs/typeorm';
-import { AssetEntity } from '@app/database/entities/asset.entity';
-import { UserEntity } from '@app/database/entities/user.entity';
 import { AlbumEntity } from '../../../../../libs/database/src/entities/album.entity';
 import { AssetAlbumEntity } from '@app/database/entities/asset-album.entity';
 import { UserAlbumEntity } from '@app/database/entities/user-album.entity';
 import { AlbumRepository, ALBUM_REPOSITORY } from './album-repository';
-import { AssetRepository, ASSET_REPOSITORY } from '../asset/asset-repository';
 import { DownloadModule } from '../../modules/download/download.module';
+import { AssetModule } from '../asset/asset.module';
+import { UserModule } from '../user/user.module';
+
+const ALBUM_REPOSITORY_PROVIDER = {
+  provide: ALBUM_REPOSITORY,
+  useClass: AlbumRepository,
+};
 
 @Module({
   imports: [
-    TypeOrmModule.forFeature([AssetEntity, UserEntity, AlbumEntity, AssetAlbumEntity, UserAlbumEntity]),
+    TypeOrmModule.forFeature([AlbumEntity, AssetAlbumEntity, UserAlbumEntity]),
     DownloadModule,
+    UserModule,
+    forwardRef(() => AssetModule),
   ],
   controllers: [AlbumController],
-  providers: [
-    AlbumService,
-    {
-      provide: ALBUM_REPOSITORY,
-      useClass: AlbumRepository,
-    },
-    {
-      provide: ASSET_REPOSITORY,
-      useClass: AssetRepository,
-    },
-  ],
+  providers: [AlbumService, ALBUM_REPOSITORY_PROVIDER],
+  exports: [ALBUM_REPOSITORY_PROVIDER],
 })
 export class AlbumModule {}

server/apps/immich/src/api-v1/asset/asset-repository.ts

@@ -1,7 +1,7 @@
 import { SearchPropertiesDto } from './dto/search-properties.dto';
 import { CuratedLocationsResponseDto } from './response-dto/curated-locations-response.dto';
 import { AssetEntity, AssetType } from '@app/database/entities/asset.entity';
-import { BadRequestException, Injectable } from '@nestjs/common';
+import { BadRequestException, Inject, Injectable } from '@nestjs/common';
 import { InjectRepository } from '@nestjs/typeorm';
 import { Repository } from 'typeorm/repository/Repository';
 import { CreateAssetDto } from './dto/create-asset.dto';
@@ -14,6 +14,7 @@ import { CheckExistingAssetsDto } from './dto/check-existing-assets.dto';
 import { CheckExistingAssetsResponseDto } from './response-dto/check-existing-assets-response.dto';
 import { In } from 'typeorm/find-options/operator/In';
 import { UpdateAssetDto } from './dto/update-asset.dto';
+import { ITagRepository, TAG_REPOSITORY } from '../tag/tag.repository';
 
 export interface IAssetRepository {
   create(
@@ -25,7 +26,7 @@ export interface IAssetRepository {
     checksum?: Buffer,
     livePhotoAssetEntity?: AssetEntity,
   ): Promise<AssetEntity>;
-  update(asset: AssetEntity, dto: UpdateAssetDto): Promise<AssetEntity>;
+  update(userId: string, asset: AssetEntity, dto: UpdateAssetDto): Promise<AssetEntity>;
   getAllByUserId(userId: string, skip?: number): Promise<AssetEntity[]>;
   getAllByDeviceId(userId: string, deviceId: string): Promise<string[]>;
   getById(assetId: string): Promise<AssetEntity>;
@@ -53,6 +54,8 @@ export class AssetRepository implements IAssetRepository {
   constructor(
     @InjectRepository(AssetEntity)
     private assetRepository: Repository<AssetEntity>,
+
+    @Inject(TAG_REPOSITORY) private _tagRepository: ITagRepository,
   ) {}
 
   async getAssetWithNoSmartInfo(): Promise<AssetEntity[]> {
@@ -222,7 +225,7 @@ export class AssetRepository implements IAssetRepository {
       where: {
         id: assetId,
       },
-      relations: ['exifInfo'],
+      relations: ['exifInfo', 'tags'],
     });
   }
 
@@ -237,9 +240,9 @@ export class AssetRepository implements IAssetRepository {
       .andWhere('asset.resizePath is not NULL')
       .andWhere('asset.isVisible = true')
       .leftJoinAndSelect('asset.exifInfo', 'exifInfo')
+      .leftJoinAndSelect('asset.tags', 'tags')
       .skip(skip || 0)
       .orderBy('asset.createdAt', 'DESC');
-
     return await query.getMany();
   }
 
@@ -286,9 +289,14 @@ export class AssetRepository implements IAssetRepository {
   /**
    * Update asset
    */
-  async update(asset: AssetEntity, dto: UpdateAssetDto): Promise<AssetEntity> {
+  async update(userId: string, asset: AssetEntity, dto: UpdateAssetDto): Promise<AssetEntity> {
     asset.isFavorite = dto.isFavorite ?? asset.isFavorite;
 
+    if (dto.tagIds) {
+      const tags = await this._tagRepository.getByIds(userId, dto.tagIds);
+      asset.tags = tags;
+    }
+
     return await this.assetRepository.save(asset);
   }
 
@@ -347,10 +355,10 @@ export class AssetRepository implements IAssetRepository {
 
   async countByIdAndUser(assetId: string, userId: string): Promise<number> {
     return await this.assetRepository.count({
-        where: {
-          id: assetId,
-          userId
-      }
+      where: {
+        id: assetId,
+        userId,
+      },
     });
   }
 }

server/apps/immich/src/api-v1/asset/asset.controller.ts

@@ -216,14 +216,14 @@ export class AssetController {
   /**
    * Update an asset
    */
-  @Put('/assetById/:assetId')
-  async updateAssetById(
+  @Put('/:assetId')
+  async updateAsset(
     @GetAuthUser() authUser: AuthUserDto,
     @Param('assetId') assetId: string,
-    @Body() dto: UpdateAssetDto,
+    @Body(ValidationPipe) dto: UpdateAssetDto,
   ): Promise<AssetResponseDto> {
     await this.assetService.checkAssetsAccess(authUser, [assetId], true);
-    return await this.assetService.updateAssetById(assetId, dto);
+    return await this.assetService.updateAsset(authUser, assetId, dto);
   }
 
   @Delete('/')

server/apps/immich/src/api-v1/asset/asset.module.ts

@@ -1,4 +1,4 @@
-import { Module } from '@nestjs/common';
+import { forwardRef, Module } from '@nestjs/common';
 import { AssetService } from './asset.service';
 import { AssetController } from './asset.controller';
 import { TypeOrmModule } from '@nestjs/typeorm';
@@ -10,18 +10,25 @@ import { CommunicationModule } from '../communication/communication.module';
 import { QueueNameEnum } from '@app/job/constants/queue-name.constant';
 import { AssetRepository, ASSET_REPOSITORY } from './asset-repository';
 import { DownloadModule } from '../../modules/download/download.module';
-import { ALBUM_REPOSITORY, AlbumRepository } from '../album/album-repository';
-import { AlbumEntity } from '@app/database/entities/album.entity';
-import { UserAlbumEntity } from '@app/database/entities/user-album.entity';
-import { UserEntity } from '@app/database/entities/user.entity';
-import { AssetAlbumEntity } from '@app/database/entities/asset-album.entity';
+import { TagModule } from '../tag/tag.module';
+import { AlbumModule } from '../album/album.module';
+import { UserModule } from '../user/user.module';
+
+const ASSET_REPOSITORY_PROVIDER = {
+  provide: ASSET_REPOSITORY,
+  useClass: AssetRepository,
+};
 
 @Module({
   imports: [
+    TypeOrmModule.forFeature([AssetEntity]),
     CommunicationModule,
     BackgroundTaskModule,
     DownloadModule,
-    TypeOrmModule.forFeature([AssetEntity, AlbumEntity, UserAlbumEntity, UserEntity, AssetAlbumEntity]),
+    UserModule,
+    AlbumModule,
+    TagModule,
+    forwardRef(() => AlbumModule),
     BullModule.registerQueue({
       name: QueueNameEnum.ASSET_UPLOADED,
       defaultJobOptions: {
@@ -40,18 +47,7 @@ import { AssetAlbumEntity } from '@app/database/entities/asset-album.entity';
     }),
   ],
   controllers: [AssetController],
-  providers: [
-    AssetService,
-    BackgroundTaskService,
-    {
-      provide: ASSET_REPOSITORY,
-      useClass: AssetRepository,
-    },
-    {
-      provide: ALBUM_REPOSITORY,
-      useClass: AlbumRepository,
-    },
-  ],
-  exports: [AssetService],
+  providers: [AssetService, BackgroundTaskService, ASSET_REPOSITORY_PROVIDER],
+  exports: [ASSET_REPOSITORY_PROVIDER],
 })
 export class AssetModule {}

server/apps/immich/src/api-v1/asset/asset.service.ts

@@ -231,13 +231,13 @@ export class AssetService {
     return mapAsset(asset);
   }
 
-  public async updateAssetById(assetId: string, dto: UpdateAssetDto): Promise<AssetResponseDto> {
+  public async updateAsset(authUser: AuthUserDto, assetId: string, dto: UpdateAssetDto): Promise<AssetResponseDto> {
     const asset = await this._assetRepository.getById(assetId);
     if (!asset) {
       throw new BadRequestException('Asset not found');
     }
 
-    const updatedAsset = await this._assetRepository.update(asset, dto);
+    const updatedAsset = await this._assetRepository.update(authUser.id, asset, dto);
 
     return mapAsset(updatedAsset);
   }

server/apps/immich/src/api-v1/asset/dto/update-asset.dto.ts

@@ -1,6 +1,24 @@
-import { IsBoolean } from 'class-validator';
+import { ApiProperty } from '@nestjs/swagger';
+import { IsArray, IsBoolean, IsNotEmpty, IsOptional, IsString } from 'class-validator';
 
 export class UpdateAssetDto {
+  @IsOptional()
   @IsBoolean()
-  isFavorite!: boolean;
+  isFavorite?: boolean;
+
+  @IsOptional()
+  @IsArray()
+  @IsString({ each: true })
+  @IsNotEmpty({ each: true })
+  @ApiProperty({
+    isArray: true,
+    type: String,
+    title: 'Array of tag IDs to add to the asset',
+    example: [
+      'bf973405-3f2a-48d2-a687-2ed4167164be',
+      'dd41870b-5d00-46d2-924e-1d8489a0aa0f',
+      'fad77c3f-deef-4e7e-9608-14c1aa4e559a',
+    ],
+  })
+  tagIds?: string[];
 }

server/apps/immich/src/api-v1/asset/response-dto/asset-response.dto.ts

@@ -1,5 +1,6 @@
 import { AssetEntity, AssetType } from '@app/database/entities/asset.entity';
 import { ApiProperty } from '@nestjs/swagger';
+import { mapTag, TagResponseDto } from '../../tag/response-dto/tag-response.dto';
 import { ExifResponseDto, mapExif } from './exif-response.dto';
 import { SmartInfoResponseDto, mapSmartInfo } from './smart-info-response.dto';
 
@@ -23,6 +24,7 @@ export class AssetResponseDto {
   exifInfo?: ExifResponseDto;
   smartInfo?: SmartInfoResponseDto;
   livePhotoVideoId?: string | null;
+  tags!: TagResponseDto[];
 }
 
 export function mapAsset(entity: AssetEntity): AssetResponseDto {
@@ -44,5 +46,6 @@ export function mapAsset(entity: AssetEntity): AssetResponseDto {
     exifInfo: entity.exifInfo ? mapExif(entity.exifInfo) : undefined,
     smartInfo: entity.smartInfo ? mapSmartInfo(entity.smartInfo) : undefined,
     livePhotoVideoId: entity.livePhotoVideoId,
+    tags: entity.tags?.map(mapTag),
   };
 }

server/apps/immich/src/api-v1/job/job.module.ts

@@ -5,18 +5,21 @@ import { ImmichJwtService } from '../../modules/immich-jwt/immich-jwt.service';
 import { ImmichJwtModule } from '../../modules/immich-jwt/immich-jwt.module';
 import { JwtModule } from '@nestjs/jwt';
 import { jwtConfig } from '../../config/jwt.config';
-import { UserEntity } from '@app/database/entities/user.entity';
 import { TypeOrmModule } from '@nestjs/typeorm';
 import { BullModule } from '@nestjs/bull';
 import { QueueNameEnum } from '@app/job';
-import { AssetEntity } from '@app/database/entities/asset.entity';
 import { ExifEntity } from '@app/database/entities/exif.entity';
-import { AssetRepository, ASSET_REPOSITORY } from '../asset/asset-repository';
+import { TagModule } from '../tag/tag.module';
+import { AssetModule } from '../asset/asset.module';
+import { UserModule } from '../user/user.module';
 
 @Module({
   imports: [
-    TypeOrmModule.forFeature([UserEntity, AssetEntity, ExifEntity]),
+    TypeOrmModule.forFeature([ExifEntity]),
     ImmichJwtModule,
+    TagModule,
+    AssetModule,
+    UserModule,
     JwtModule.register(jwtConfig),
     BullModule.registerQueue(
       {
@@ -70,13 +73,6 @@ import { AssetRepository, ASSET_REPOSITORY } from '../asset/asset-repository';
     ),
   ],
   controllers: [JobController],
-  providers: [
-    JobService,
-    ImmichJwtService,
-    {
-      provide: ASSET_REPOSITORY,
-      useClass: AssetRepository,
-    },
-  ],
+  providers: [JobService, ImmichJwtService],
 })
 export class JobModule {}

server/apps/immich/src/api-v1/tag/dto/create-tag.dto.ts

@@ -0,0 +1,14 @@
+import { TagType } from '@app/database/entities/tag.entity';
+import { ApiProperty } from '@nestjs/swagger';
+import { IsEnum, IsNotEmpty, IsString } from 'class-validator';
+
+export class CreateTagDto {
+  @IsString()
+  @IsNotEmpty()
+  name!: string;
+
+  @IsEnum(TagType)
+  @IsNotEmpty()
+  @ApiProperty({ enumName: 'TagTypeEnum', enum: TagType })
+  type!: TagType;
+}

server/apps/immich/src/api-v1/tag/dto/update-tag.dto.ts

@@ -0,0 +1,11 @@
+import { IsOptional, IsString } from 'class-validator';
+
+export class UpdateTagDto {
+  @IsString()
+  @IsOptional()
+  name?: string;
+
+  @IsString()
+  @IsOptional()
+  renameTagId?: string;
+}

server/apps/immich/src/api-v1/tag/response-dto/tag-response.dto.ts

@@ -0,0 +1,20 @@
+import { TagEntity, TagType } from '@app/database/entities/tag.entity';
+import { ApiProperty } from '@nestjs/swagger';
+
+export class TagResponseDto {
+  @ApiProperty()
+  id!: string;
+
+  @ApiProperty({ enumName: 'TagTypeEnum', enum: TagType })
+  type!: string;
+
+  name!: string;
+}
+
+export function mapTag(entity: TagEntity): TagResponseDto {
+  return {
+    id: entity.id,
+    type: entity.type,
+    name: entity.name,
+  };
+}

server/apps/immich/src/api-v1/tag/tag.controller.ts

@@ -0,0 +1,44 @@
+import { Controller, Get, Post, Body, Patch, Param, Delete, ValidationPipe } from '@nestjs/common';
+import { TagService } from './tag.service';
+import { CreateTagDto } from './dto/create-tag.dto';
+import { UpdateTagDto } from './dto/update-tag.dto';
+import { Authenticated } from '../../decorators/authenticated.decorator';
+import { ApiTags } from '@nestjs/swagger';
+import { AuthUserDto, GetAuthUser } from '../../decorators/auth-user.decorator';
+import { TagEntity } from '@app/database/entities/tag.entity';
+
+@Authenticated()
+@ApiTags('Tag')
+@Controller('tag')
+export class TagController {
+  constructor(private readonly tagService: TagService) {}
+
+  @Post()
+  create(@GetAuthUser() authUser: AuthUserDto, @Body(ValidationPipe) createTagDto: CreateTagDto): Promise<TagEntity> {
+    return this.tagService.create(authUser, createTagDto);
+  }
+
+  @Get()
+  findAll(@GetAuthUser() authUser: AuthUserDto) {
+    return this.tagService.findAll(authUser);
+  }
+
+  @Get(':id')
+  findOne(@GetAuthUser() authUser: AuthUserDto, @Param('id') id: string) {
+    return this.tagService.findOne(authUser, id);
+  }
+
+  @Patch(':id')
+  update(
+    @GetAuthUser() authUser: AuthUserDto,
+    @Param('id') id: string,
+    @Body(ValidationPipe) updateTagDto: UpdateTagDto,
+  ) {
+    return this.tagService.update(authUser, id, updateTagDto);
+  }
+
+  @Delete(':id')
+  delete(@GetAuthUser() authUser: AuthUserDto, @Param('id') id: string) {
+    return this.tagService.remove(authUser, id);
+  }
+}

server/apps/immich/src/api-v1/tag/tag.module.ts

@@ -0,0 +1,18 @@
+import { Module } from '@nestjs/common';
+import { TagService } from './tag.service';
+import { TagController } from './tag.controller';
+import { TagEntity } from '@app/database/entities/tag.entity';
+import { TypeOrmModule } from '@nestjs/typeorm';
+import { TagRepository, TAG_REPOSITORY } from './tag.repository';
+
+const TAG_REPOSITORY_PROVIDER = {
+  provide: TAG_REPOSITORY,
+  useClass: TagRepository,
+};
+@Module({
+  imports: [TypeOrmModule.forFeature([TagEntity])],
+  controllers: [TagController],
+  providers: [TagService, TAG_REPOSITORY_PROVIDER],
+  exports: [TAG_REPOSITORY_PROVIDER],
+})
+export class TagModule {}

server/apps/immich/src/api-v1/tag/tag.repository.ts

@@ -0,0 +1,61 @@
+import { TagEntity, TagType } from '@app/database/entities/tag.entity';
+import { Injectable } from '@nestjs/common';
+import { InjectRepository } from '@nestjs/typeorm';
+import { In, Repository } from 'typeorm';
+import { UpdateTagDto } from './dto/update-tag.dto';
+
+export interface ITagRepository {
+  create(userId: string, tagType: TagType, tagName: string): Promise<TagEntity>;
+  getByIds(userId: string, tagIds: string[]): Promise<TagEntity[]>;
+  getById(tagId: string, userId: string): Promise<TagEntity | null>;
+  getByUserId(userId: string): Promise<TagEntity[]>;
+  update(tag: TagEntity, updateTagDto: UpdateTagDto): Promise<TagEntity | null>;
+  remove(tag: TagEntity): Promise<TagEntity>;
+}
+
+export const TAG_REPOSITORY = 'TAG_REPOSITORY';
+
+@Injectable()
+export class TagRepository implements ITagRepository {
+  constructor(
+    @InjectRepository(TagEntity)
+    private tagRepository: Repository<TagEntity>,
+  ) {}
+
+  async create(userId: string, tagType: TagType, tagName: string): Promise<TagEntity> {
+    const tag = new TagEntity();
+    tag.name = tagName;
+    tag.type = tagType;
+    tag.userId = userId;
+
+    return this.tagRepository.save(tag);
+  }
+
+  async getById(tagId: string, userId: string): Promise<TagEntity | null> {
+    return await this.tagRepository.findOne({ where: { id: tagId, userId }, relations: ['user'] });
+  }
+
+  async getByIds(userId: string, tagIds: string[]): Promise<TagEntity[]> {
+    return await this.tagRepository.find({
+      where: { id: In(tagIds), userId },
+      relations: {
+        user: true,
+      },
+    });
+  }
+
+  async getByUserId(userId: string): Promise<TagEntity[]> {
+    return await this.tagRepository.find({ where: { userId } });
+  }
+
+  async update(tag: TagEntity, updateTagDto: UpdateTagDto): Promise<TagEntity> {
+    tag.name = updateTagDto.name ?? tag.name;
+    tag.renameTagId = updateTagDto.renameTagId ?? tag.renameTagId;
+
+    return this.tagRepository.save(tag);
+  }
+
+  async remove(tag: TagEntity): Promise<TagEntity> {
+    return await this.tagRepository.remove(tag);
+  }
+}

server/apps/immich/src/api-v1/tag/tag.service.spec.ts

@@ -0,0 +1,91 @@
+import { TagEntity, TagType } from '@app/database/entities/tag.entity';
+import { UserEntity } from '@app/database/entities/user.entity';
+import { AuthUserDto } from '../../decorators/auth-user.decorator';
+import { ITagRepository } from './tag.repository';
+import { TagService } from './tag.service';
+
+describe('TagService', () => {
+  let sut: TagService;
+  let tagRepositoryMock: jest.Mocked<ITagRepository>;
+
+  const user1AuthUser: AuthUserDto = Object.freeze({
+    id: '1111',
+    email: 'testuser@email.com',
+  });
+
+  const user1: UserEntity = Object.freeze({
+    id: '1111',
+    firstName: 'Alex',
+    lastName: 'Tran',
+    isAdmin: true,
+    email: 'testuser@email.com',
+    profileImagePath: '',
+    shouldChangePassword: true,
+    createdAt: '2022-12-02T19:29:23.603Z',
+    deletedAt: undefined,
+    tags: [],
+    oauthId: 'oauth-id-1',
+  });
+
+  // const user2: UserEntity = Object.freeze({
+  //   id: '2222',
+  //   firstName: 'Alex',
+  //   lastName: 'Tran',
+  //   isAdmin: true,
+  //   email: 'testuser2@email.com',
+  //   profileImagePath: '',
+  //   shouldChangePassword: true,
+  //   createdAt: '2022-12-02T19:29:23.603Z',
+  //   deletedAt: undefined,
+  //   tags: [],
+  //   oauthId: 'oauth-id-2',
+  // });
+
+  const user1Tag1: TagEntity = Object.freeze({
+    name: 'user 1 tag 1',
+    type: TagType.CUSTOM,
+    userId: user1.id,
+    user: user1,
+    renameTagId: '',
+    id: 'user1-tag-1-id',
+    assets: [],
+  });
+
+  // const user1Tag2: TagEntity = Object.freeze({
+  //   name: 'user 1 tag 2',
+  //   type: TagType.CUSTOM,
+  //   userId: user1.id,
+  //   user: user1,
+  //   renameTagId: '',
+  //   id: 'user1-tag-2-id',
+  //   assets: [],
+  // });
+
+  beforeAll(() => {
+    tagRepositoryMock = {
+      create: jest.fn(),
+      getByIds: jest.fn(),
+      getById: jest.fn(),
+      getByUserId: jest.fn(),
+      remove: jest.fn(),
+      update: jest.fn(),
+    };
+
+    sut = new TagService(tagRepositoryMock);
+  });
+
+  it('creates tag', async () => {
+    const createTagDto = {
+      name: 'user 1 tag 1',
+      type: TagType.CUSTOM,
+    };
+
+    tagRepositoryMock.create.mockResolvedValue(user1Tag1);
+
+    const result = await sut.create(user1AuthUser, createTagDto);
+
+    expect(result.userId).toEqual(user1AuthUser.id);
+    expect(result.name).toEqual(createTagDto.name);
+    expect(result.type).toEqual(createTagDto.type);
+  });
+});

server/apps/immich/src/api-v1/tag/tag.service.ts

@@ -0,0 +1,48 @@
+import { TagEntity } from '@app/database/entities/tag.entity';
+import { BadRequestException, Inject, Injectable, Logger } from '@nestjs/common';
+import { AuthUserDto } from '../../decorators/auth-user.decorator';
+import { CreateTagDto } from './dto/create-tag.dto';
+import { UpdateTagDto } from './dto/update-tag.dto';
+import { ITagRepository, TAG_REPOSITORY } from './tag.repository';
+
+@Injectable()
+export class TagService {
+  readonly logger = new Logger(TagService.name);
+
+  constructor(@Inject(TAG_REPOSITORY) private _tagRepository: ITagRepository) {}
+
+  async create(authUser: AuthUserDto, createTagDto: CreateTagDto) {
+    try {
+      return await this._tagRepository.create(authUser.id, createTagDto.type, createTagDto.name);
+    } catch (e: any) {
+      this.logger.error(e, e.stack);
+      throw new BadRequestException(`Failed to create tag: ${e.detail}`);
+    }
+  }
+
+  async findAll(authUser: AuthUserDto) {
+    return await this._tagRepository.getByUserId(authUser.id);
+  }
+
+  async findOne(authUser: AuthUserDto, id: string): Promise<TagEntity> {
+    const tag = await this._tagRepository.getById(id, authUser.id);
+
+    if (!tag) {
+      throw new BadRequestException('Tag not found');
+    }
+
+    return tag;
+  }
+
+  async update(authUser: AuthUserDto, id: string, updateTagDto: UpdateTagDto) {
+    const tag = await this.findOne(authUser, id);
+
+    return this._tagRepository.update(tag, updateTagDto);
+  }
+
+  async remove(authUser: AuthUserDto, id: string) {
+    const tag = await this.findOne(authUser, id);
+
+    return this._tagRepository.remove(tag);
+  }
+}

server/apps/immich/src/api-v1/user/user.service.spec.ts

@@ -31,6 +31,7 @@ describe('UserService', () => {
     shouldChangePassword: false,
     profileImagePath: '',
     createdAt: '2021-01-01',
+    tags: [],
   });
 
   const immichUser: UserEntity = Object.freeze({
@@ -45,6 +46,7 @@ describe('UserService', () => {
     shouldChangePassword: false,
     profileImagePath: '',
     createdAt: '2021-01-01',
+    tags: [],
   });
 
   const updatedImmichUser: UserEntity = Object.freeze({
@@ -59,6 +61,7 @@ describe('UserService', () => {
     shouldChangePassword: true,
     profileImagePath: '',
     createdAt: '2021-01-01',
+    tags: [],
   });
 
   beforeAll(() => {

server/apps/immich/src/app.module.ts

@@ -18,6 +18,7 @@ import { DatabaseModule } from '@app/database';
 import { JobModule } from './api-v1/job/job.module';
 import { SystemConfigModule } from './api-v1/system-config/system-config.module';
 import { OAuthModule } from './api-v1/oauth/oauth.module';
+import { TagModule } from './api-v1/tag/tag.module';
 
 @Module({
   imports: [
@@ -63,6 +64,8 @@ import { OAuthModule } from './api-v1/oauth/oauth.module';
     JobModule,
 
     SystemConfigModule,
+
+    TagModule,
   ],
   controllers: [AppController],
   providers: [],

server/apps/immich/src/main.ts

@@ -55,7 +55,7 @@ async function bootstrap() {
     if (process.env.NODE_ENV == 'development') {
       // Generate API Documentation only in development mode
       const outputPath = path.resolve(process.cwd(), 'immich-openapi-specs.json');
-      writeFileSync(outputPath, JSON.stringify(apiDocument), { encoding: 'utf8' });
+      writeFileSync(outputPath, JSON.stringify(apiDocument, null, 2), { encoding: 'utf8' });
       Logger.log(
         `Running Immich Server in DEVELOPMENT environment - version ${serverVersion.major}.${serverVersion.minor}.${serverVersion.patch}`,
         'ImmichServer',

server/apps/immich/src/modules/immich-jwt/immich-jwt.service.spec.ts

@@ -56,6 +56,7 @@ describe('ImmichJwtService', () => {
         profileImagePath: '',
         shouldChangePassword: false,
         createdAt: 'today',
+        tags: [],
       };
 
       const dto: LoginResponseDto = {

server/libs/database/src/entities/asset.entity.ts

@@ -1,6 +1,7 @@
-import { Column, Entity, Index, OneToOne, PrimaryGeneratedColumn, Unique } from 'typeorm';
+import { Column, Entity, Index, JoinTable, ManyToMany, OneToOne, PrimaryGeneratedColumn, Unique } from 'typeorm';
 import { ExifEntity } from './exif.entity';
 import { SmartInfoEntity } from './smart-info.entity';
+import { TagEntity } from './tag.entity';
 
 @Entity('assets')
 @Unique('UQ_userid_checksum', ['userId', 'checksum'])
@@ -62,6 +63,11 @@ export class AssetEntity {
 
   @OneToOne(() => SmartInfoEntity, (smartInfoEntity) => smartInfoEntity.asset)
   smartInfo?: SmartInfoEntity;
+
+  // https://github.com/typeorm/typeorm/blob/master/docs/many-to-many-relations.md
+  @ManyToMany(() => TagEntity, (tag) => tag.assets, { cascade: true })
+  @JoinTable({ name: 'tag_asset' })
+  tags!: TagEntity[];
 }
 
 export enum AssetType {

server/libs/database/src/entities/tag.entity.ts

@@ -0,0 +1,45 @@
+import { Column, Entity, ManyToMany, ManyToOne, PrimaryGeneratedColumn, Unique } from 'typeorm';
+import { AssetEntity } from './asset.entity';
+import { UserEntity } from './user.entity';
+
+@Entity('tags')
+@Unique('UQ_tag_name_userId', ['name', 'userId'])
+export class TagEntity {
+  @PrimaryGeneratedColumn('uuid')
+  id!: string;
+
+  @Column()
+  type!: TagType;
+
+  @Column()
+  name!: string;
+
+  @Column()
+  userId!: string;
+
+  @Column({ type: 'uuid', comment: 'The new renamed tagId', nullable: true })
+  renameTagId!: string;
+
+  @ManyToMany(() => AssetEntity, (asset) => asset.tags)
+  assets!: AssetEntity[];
+
+  @ManyToOne(() => UserEntity, (user) => user.tags)
+  user!: UserEntity;
+}
+
+export enum TagType {
+  /**
+   * Tag that is detected by the ML model for object detection will use this type
+   */
+  OBJECT = 'OBJECT',
+
+  /**
+   * Face that is detected by the ML model for facial detection (TBD/NOT YET IMPLEMENTED) will use this type
+   */
+  FACE = 'FACE',
+
+  /**
+   * Tag that is created by the user will use this type
+   */
+  CUSTOM = 'CUSTOM',
+}

server/libs/database/src/entities/user.entity.ts

@@ -1,4 +1,5 @@
-import { Column, CreateDateColumn, DeleteDateColumn, Entity, PrimaryGeneratedColumn } from 'typeorm';
+import { Column, CreateDateColumn, DeleteDateColumn, Entity, OneToMany, PrimaryGeneratedColumn } from 'typeorm';
+import { TagEntity } from './tag.entity';
 
 @Entity('users')
 export class UserEntity {
@@ -37,4 +38,7 @@ export class UserEntity {
 
   @DeleteDateColumn()
   deletedAt?: Date;
+
+  @OneToMany(() => TagEntity, (tag) => tag.user)
+  tags!: TagEntity[];
 }

server/libs/database/src/migrations/1670257571385-CreateTagsTable.ts

@@ -0,0 +1,26 @@
+import { MigrationInterface, QueryRunner } from "typeorm";
+
+export class CreateTagsTable1670257571385 implements MigrationInterface {
+    name = 'CreateTagsTable1670257571385'
+
+    public async up(queryRunner: QueryRunner): Promise<void> {
+        await queryRunner.query(`CREATE TABLE "tags" ("id" uuid NOT NULL DEFAULT uuid_generate_v4(), "type" character varying NOT NULL, "name" character varying NOT NULL, "userId" uuid NOT NULL, "renameTagId" uuid, CONSTRAINT "UQ_tag_name_userId" UNIQUE ("name", "userId"), CONSTRAINT "PK_e7dc17249a1148a1970748eda99" PRIMARY KEY ("id")); COMMENT ON COLUMN "tags"."renameTagId" IS 'The new renamed tagId'`);
+        await queryRunner.query(`CREATE TABLE "tag_asset" ("assetsId" uuid NOT NULL, "tagsId" uuid NOT NULL, CONSTRAINT "PK_ef5346fe522b5fb3bc96454747e" PRIMARY KEY ("assetsId", "tagsId"))`);
+        await queryRunner.query(`CREATE INDEX "IDX_f8e8a9e893cb5c54907f1b798e" ON "tag_asset" ("assetsId") `);
+        await queryRunner.query(`CREATE INDEX "IDX_e99f31ea4cdf3a2c35c7287eb4" ON "tag_asset" ("tagsId") `);
+        await queryRunner.query(`ALTER TABLE "tags" ADD CONSTRAINT "FK_92e67dc508c705dd66c94615576" FOREIGN KEY ("userId") REFERENCES "users"("id") ON DELETE NO ACTION ON UPDATE NO ACTION`);
+        await queryRunner.query(`ALTER TABLE "tag_asset" ADD CONSTRAINT "FK_f8e8a9e893cb5c54907f1b798e9" FOREIGN KEY ("assetsId") REFERENCES "assets"("id") ON DELETE CASCADE ON UPDATE CASCADE`);
+        await queryRunner.query(`ALTER TABLE "tag_asset" ADD CONSTRAINT "FK_e99f31ea4cdf3a2c35c7287eb42" FOREIGN KEY ("tagsId") REFERENCES "tags"("id") ON DELETE NO ACTION ON UPDATE NO ACTION`);
+    }
+
+    public async down(queryRunner: QueryRunner): Promise<void> {
+        await queryRunner.query(`ALTER TABLE "tag_asset" DROP CONSTRAINT "FK_e99f31ea4cdf3a2c35c7287eb42"`);
+        await queryRunner.query(`ALTER TABLE "tag_asset" DROP CONSTRAINT "FK_f8e8a9e893cb5c54907f1b798e9"`);
+        await queryRunner.query(`ALTER TABLE "tags" DROP CONSTRAINT "FK_92e67dc508c705dd66c94615576"`);
+        await queryRunner.query(`DROP INDEX "public"."IDX_e99f31ea4cdf3a2c35c7287eb4"`);
+        await queryRunner.query(`DROP INDEX "public"."IDX_f8e8a9e893cb5c54907f1b798e"`);
+        await queryRunner.query(`DROP TABLE "tag_asset"`);
+        await queryRunner.query(`DROP TABLE "tags"`);
+    }
+
+}

web/src/lib/components/asset-viewer/asset-viewer.svelte

@@ -183,7 +183,7 @@
 	};
 
 	const toggleFavorite = async () => {
-		const { data } = await api.assetApi.updateAssetById(asset.id, {
+		const { data } = await api.assetApi.updateAsset(asset.id, {
 			isFavorite: !asset.isFavorite
 		});
 

web/src/lib/components/shared-components/status-box.svelte

@@ -62,7 +62,9 @@
 						style={`width: ${getStorageUsagePercentage()}%`}
 					/>
 				</div>
-				<p class="text-xs">{asByteUnitString(serverInfo?.diskUseRaw)} of {asByteUnitString(serverInfo?.diskSizeRaw)} used</p>
+				<p class="text-xs">
+					{asByteUnitString(serverInfo?.diskUseRaw)} of {asByteUnitString(serverInfo?.diskSizeRaw)} used
+				</p>
 			{:else}
 				<div class="mt-2">
 					<LoadingSpinner />

web/src/lib/components/shared-components/upload-panel.svelte

@@ -115,9 +115,7 @@
 									<input
 										disabled
 										class="bg-gray-100 border w-full p-1 rounded-md text-[10px] px-2"
-										value={`[${getBytesWithUnit(uploadAsset.file.size)}] ${
-											uploadAsset.file.name
-										}`}
+										value={`[${getBytesWithUnit(uploadAsset.file.size)}] ${uploadAsset.file.name}`}
 									/>
 
 									<div class="w-full bg-gray-300 h-[15px] rounded-md mt-[5px] text-white relative">