feat: add safeBrowsingExpiry column to urls table

Author: dcshzj

src/server/db_migrations/20250721_add_urls_safebrowsing_expiry.sql

@@ -0,0 +1,11 @@
+-- This adds the safeBrowsingExpiry column to the urls table, which is
+-- backwards-compatible with the current codebase as it allows NULL values.
+
+BEGIN TRANSACTION;
+
+ALTER TABLE urls ADD "safeBrowsingExpiry" TIMESTAMP WITH TIME ZONE;
+
+COMMIT;
+
+-- Down migration
+-- ALTER TABLE urls DROP COLUMN "safeBrowsingExpiry";

src/server/mappers/UrlMapper.ts

@@ -32,6 +32,7 @@ export class UrlMapper implements Mapper<StorableUrl, UrlType> {
       contactEmail: urlType.contactEmail,
       source: urlType.source,
       tagStrings: urlType.tagStrings,
+      safeBrowsingExpiry: urlType.safeBrowsingExpiry,
     }
   }
 }

src/server/models/url.ts

@@ -24,6 +24,7 @@ export interface UrlBaseType extends IdType {
   readonly description: string
   readonly source: StorableUrlSource
   readonly tagStrings: string
+  readonly safeBrowsingExpiry: string | null
 }
 
 export interface UrlType extends IdType, UrlBaseType, Sequelize.Model {
@@ -229,6 +230,10 @@ export const Url = <UrlTypeStatic>sequelize.define(
       allowNull: false,
       defaultValue: '',
     },
+    safeBrowsingExpiry: {
+      type: Sequelize.DATE,
+      allowNull: true,
+    },
   },
   {
     hooks: {

src/server/repositories/types.ts

@@ -16,6 +16,7 @@ export type StorableUrl = Pick<
   | 'contactEmail'
   | 'source'
   | 'tagStrings'
+  | 'safeBrowsingExpiry'
 > &
   Pick<UrlClicksType, 'clicks'> & { tags?: string[] }
 

test/server/mappers/UrlV1Mapper.test.ts

@@ -21,6 +21,7 @@ describe('url v1 mapper', () => {
       tagStrings: '1;abc;foo-bar',
       contactEmail: '[email protected]',
       description: 'this-is-a-description',
+      safeBrowsingExpiry: null,
     }
     const urlV1DTO = urlV1Mapper.persistenceToDto(storableUrl)
     expect(urlV1DTO).toEqual({

test/server/mocks/repositories/UrlRepository.ts

@@ -84,6 +84,7 @@ export class UrlRepositoryMock implements UrlRepositoryInterface {
           clicks: 0,
           source: StorableUrlSource.Console,
           tagStrings: '',
+          safeBrowsingExpiry: null,
         },
       ],
       count: 0,

test/server/repositories/UrlRepository.test.ts

@@ -24,6 +24,7 @@ import {
 import { DirectoryQueryConditions } from '../../../src/server/modules/directory'
 import TagRepositoryMock from '../mocks/repositories/TagRepository'
 import { TAG_SEPARATOR } from '../../../src/shared/constants'
+import { StorableUrl } from '../../../src/server/repositories/types'
 
 jest.mock('../../../src/server/models/url', () => ({
   Url: urlModelMock,
@@ -75,17 +76,18 @@ describe('UrlRepository', () => {
   const baseUrlClicks = {
     clicks: 2,
   }
-  const baseTemplate = {
+  const baseTemplate: Omit<StorableUrl, 'tagStrings' | 'clicks'> = {
     shortUrl: baseShortUrl,
     longUrl: baseLongUrl,
-    state: 'ACTIVE',
+    state: StorableUrlState.Active,
     isFile: false,
-    createdAt: new Date(),
-    updatedAt: new Date(),
+    createdAt: new Date().toISOString(),
+    updatedAt: new Date().toISOString(),
     description: 'An agency of the Singapore Government',
     contactEmail: '[email protected]',
     source: StorableUrlSource.Console,
     tags: [],
+    safeBrowsingExpiry: null,
   }
   const baseUrl = {
     ...baseTemplate,

test/server/repositories/UserRepository.test.ts

@@ -3,6 +3,11 @@ import { UserRepository } from '../../../src/server/repositories/UserRepository'
 import { UrlMapper } from '../../../src/server/mappers/UrlMapper'
 import { UserMapper } from '../../../src/server/mappers/UserMapper'
 import { NotFoundError } from '../../../src/server/util/error'
+import { StorableUrl } from '../../../src/server/repositories/types'
+import {
+  StorableUrlSource,
+  StorableUrlState,
+} from '../../../src/server/repositories/enums'
 
 jest.mock('../../../src/server/models/user', () => ({
   User: userModelMock,
@@ -17,16 +22,17 @@ const userRepo = new UserRepository(
   new UrlMapper(),
 )
 
-const baseUrlTemplate = {
+const baseUrlTemplate: Omit<StorableUrl, 'tagStrings' | 'clicks'> = {
   shortUrl: 'short-link',
   longUrl: 'https://www.agency.gov.sg',
-  state: 'ACTIVE',
+  state: StorableUrlState.Active,
   isFile: false,
-  createdAt: Date.now(),
-  updatedAt: Date.now(),
+  createdAt: new Date().toISOString(),
+  updatedAt: new Date().toISOString(),
   description: 'An agency of the Singapore Government',
   contactEmail: '[email protected]',
-  source: 'CONSOLE',
+  source: StorableUrlSource.Console,
+  safeBrowsingExpiry: null,
 }
 
 const urlClicks = {