feat(server): add postgres major version check (#6213)

* feat(server): Throw error when PostgreSQL version is not within the supported versions
The pgvecto.rs extension, though not distributed, can be built for PostgreSQL 12 and 13.
An installation of PostgreSQL 12 with the pgvecto.rs extensions installed will not be caught by immich.
This causes immich to attempt to run the database migrations without having a proper environment.
With assertPostgresql the server will throw an error if the PostgreSQL version is not within the supported range.

* Replaced assertion with lesser than comparison
As requested by @zackpollard

* Changed the comparison to use the minPostgresVersion variable.
If we define one we might as well use it. makes changing the versioning later easier

* Added two new tests, modified two existing tests

`should return if minimum supported PostgreSQL and vectors version are installed`:
Check if init returns properly and that getPostgresVersion is called twice

`should thrown an error if PostgreSQL version is below minimum supported version`:
Checks if the init function correctly returns an error

`should suggest image with postgres ${major} if database is ${major}`:
Modified to set MockResolvedValue instead of MockResolvedValueOnce. With the new check we get the PostgreSQL version twice. So it needs to be set during the entire test.

`should not suggest image if postgres version is not in 14, 15 or 16`:
Modified the bounds to [14, 18]. Because values below 14 now will not get called.
Also Modified to call `getPostgresVersion.MockResolvedValueOnce` for twice, because it gets called twice.

* Fixed two mistakes in the jest functions from previous commit #2abcb60

`should thrown an error if PostgreSQL version is below minimum supported version`:
The regex function I wrote mistakingly used the negate function which check that the error *did not* contain the phrase "PostgreSQL". Which is the opposite

`should not suggest image if postgres version is not in 14, 15 or 16`:
confused bounds for a normal javascript array. Changed the test to only check for values above 16. As values below 14 will get thrown out by test `should return if minimum supported PostgreSQL and vectors version are installed`

I apologise for the mistakes in my previous commit.

* Format fix

---------

Co-authored-by: max <wak@vanling.net>

server/src/domain/database/database.service.spec.ts

@@ -28,6 +28,28 @@ describe(DatabaseService.name, () => {
   });
 
   describe('init', () => {
+    it('should return if minimum supported PostgreSQL and vectors version are installed', async () => {
+      databaseMock.getPostgresVersion.mockResolvedValueOnce(new Version(14, 0, 0));
+      databaseMock.getExtensionVersion.mockResolvedValueOnce(new Version(0, 1, 1));
+
+      await sut.init();
+
+      expect(databaseMock.getPostgresVersion).toHaveBeenCalledTimes(2);
+      expect(databaseMock.createExtension).toHaveBeenCalledWith(DatabaseExtension.VECTORS);
+      expect(databaseMock.createExtension).toHaveBeenCalledTimes(1);
+      expect(databaseMock.getExtensionVersion).toHaveBeenCalledTimes(1);
+      expect(databaseMock.runMigrations).toHaveBeenCalledTimes(1);
+      expect(fatalLog).not.toHaveBeenCalled();
+    });
+
+    it('should thrown an error if PostgreSQL version is below minimum supported version', async () => {
+      databaseMock.getPostgresVersion.mockResolvedValueOnce(new Version(13, 0, 0));
+
+      await expect(sut.init()).rejects.toThrow(/PostgreSQL/s);
+
+      expect(databaseMock.getPostgresVersion).toHaveBeenCalledTimes(1);
+    });
+
     it('should return if minimum supported vectors version is installed', async () => {
       databaseMock.getExtensionVersion.mockResolvedValueOnce(new Version(0, 1, 1));
 
@@ -108,18 +130,17 @@ describe(DatabaseService.name, () => {
     for (const major of [14, 15, 16]) {
       it(`should suggest image with postgres ${major} if database is ${major}`, async () => {
         databaseMock.getExtensionVersion.mockResolvedValue(new Version(0, 0, 1));
-        databaseMock.getPostgresVersion.mockResolvedValueOnce(new Version(major, 0, 0));
+        databaseMock.getPostgresVersion.mockResolvedValue(new Version(major, 0, 0));
 
         await expect(sut.init()).rejects.toThrow(new RegExp(`tensorchord\/pgvecto-rs:pg${major}-v0\\.1\\.11`, 's'));
       });
     }
 
     it('should not suggest image if postgres version is not in 14, 15 or 16', async () => {
-      databaseMock.getExtensionVersion.mockResolvedValue(new Version(0, 0, 1));
-      [13, 17].forEach((major) => databaseMock.getPostgresVersion.mockResolvedValueOnce(new Version(major, 0, 0)));
+      databaseMock.getPostgresVersion.mockResolvedValueOnce(new Version(17, 0, 0));
+      databaseMock.getPostgresVersion.mockResolvedValueOnce(new Version(17, 0, 0));
 
       await expect(sut.init()).rejects.toThrow(/^(?:(?!tensorchord\/pgvecto-rs).)*$/s);
-      await expect(sut.init()).rejects.toThrow(/^(?:(?!tensorchord\/pgvecto-rs).)*$/s);
     });
 
     it('should set the image to the maximum supported version', async () => {

server/src/domain/database/database.service.ts

@@ -7,12 +7,14 @@ import { DatabaseExtension, IDatabaseRepository } from '../repositories';
 @Injectable()
 export class DatabaseService {
   private logger = new ImmichLogger(DatabaseService.name);
+  minPostgresVersion = 14;
   minVectorsVersion = new Version(0, 1, 1);
   maxVectorsVersion = new Version(0, 1, 11);
 
   constructor(@Inject(IDatabaseRepository) private databaseRepository: IDatabaseRepository) {}
 
   async init() {
+    await this.assertPostgresql();
     await this.createVectors();
     await this.assertVectors();
     await this.databaseRepository.runMigrations();
@@ -66,4 +68,13 @@ export class DatabaseService {
     }
     return `tensorchord/pgvecto-rs:pg${major}-v${this.maxVectorsVersion}`;
   }
+
+  private async assertPostgresql() {
+    const { major } = await this.databaseRepository.getPostgresVersion();
+    if (major < this.minPostgresVersion) {
+      throw new Error(`
+        The PostgreSQL version is ${major}, which is older than the minimum supported version ${this.minPostgresVersion}.
+        Please upgrade to this version or later.`);
+    }
+  }
 }