Book a Demo!
CoCalc Logo Icon
StoreFeaturesDocsShareSupportNewsAboutPoliciesSign UpSign In
signalapp
GitHub Repository: signalapp/Signal-iOS
Path: blob/main/SignalServiceKit/Backups/Attachments/BackupAttachmentUploadStoreTests.swift
1 views
//
// Copyright 2024 Signal Messenger, LLC
// SPDX-License-Identifier: AGPL-3.0-only
//

import Foundation
import GRDB
import XCTest

@testable import SignalServiceKit

class BackupAttachmentUploadStoreTests: XCTestCase {

    private var db: InMemoryDB!

    private var store: BackupAttachmentUploadStore!

    override func setUp() async throws {
        db = InMemoryDB()
        store = BackupAttachmentUploadStore()
    }

    func testEnqueue() {
        // Create an attachment and reference.
        var attachmentRecord = Attachment.Record.mockStream()

        let (threadRowId, messageRowId) = insertThreadAndInteraction()

        db.write { tx in
            try! attachmentRecord.insert(tx.database)
            let reference = insertMessageAttachmentReferenceRecord(
                attachmentRowId: attachmentRecord.sqliteId!,
                messageRowId: messageRowId,
                threadRowId: threadRowId,
                timestamp: 1234,
                tx: tx,
            )
            store.enqueue(
                try! Attachment(record: attachmentRecord).asStream()!,
                owner: reference.owner.asEligibleUploadOwnerType,
                fullsize: true,
                tx: tx,
            )

            // Ensure the row exists.
            let row = try! QueuedBackupAttachmentUpload.fetchOne(tx.database)
            XCTAssertNotNil(row)
            XCTAssertEqual(row?.attachmentRowId, attachmentRecord.sqliteId)
            switch row!.highestPriorityOwnerType {
            case .threadWallpaper:
                XCTFail("unexpected type")
            case .message(let timestamp):
                XCTAssertEqual(timestamp, 1234)
            }
        }

        // Re enqueue at a higher timestamp.
        db.write { tx in
            let reference = insertMessageAttachmentReferenceRecord(
                attachmentRowId: attachmentRecord.sqliteId!,
                messageRowId: messageRowId,
                threadRowId: threadRowId,
                timestamp: 5678,
                tx: tx,
            )
            store.enqueue(
                try! Attachment(record: attachmentRecord).asStream()!,
                owner: reference.owner.asEligibleUploadOwnerType,
                fullsize: true,
                tx: tx,
            )

            let row = try! QueuedBackupAttachmentUpload.fetchOne(tx.database)
            XCTAssertNotNil(row)
            XCTAssertEqual(row?.attachmentRowId, attachmentRecord.sqliteId)
            switch row!.highestPriorityOwnerType {
            case .threadWallpaper:
                XCTFail("unexpected type")
            case .message(let timestamp):
                XCTAssertEqual(timestamp, 5678)
            }
        }

        // Re enqueue with a nil timestamp
        db.write { tx in
            let referenceRecord = AttachmentReference.ThreadAttachmentReferenceRecord(
                attachmentRowId: attachmentRecord.sqliteId!,
                // Confusingly, this owner _has_ a timestamp; we just don't use it
                // for the backup attachment upload queue.
                threadSource: .globalThreadWallpaperImage(creationTimestamp: 1),
            )
            try! referenceRecord.insert(tx.database)
            store.enqueue(
                try! Attachment(record: attachmentRecord).asStream()!,
                owner: try! AttachmentReference(record: referenceRecord).owner.asEligibleUploadOwnerType,
                fullsize: true,
                tx: tx,
            )

            let row = try! QueuedBackupAttachmentUpload.fetchOne(tx.database)
            XCTAssertNotNil(row)
            XCTAssertEqual(row?.attachmentRowId, attachmentRecord.sqliteId)
            switch row!.highestPriorityOwnerType {
            case .threadWallpaper:
                break
            case .message:
                XCTFail("unexpected type")
            }
        }

        // Re enqueue at an even higher timestamp.
        db.write { tx in
            let reference = insertMessageAttachmentReferenceRecord(
                attachmentRowId: attachmentRecord.sqliteId!,
                messageRowId: messageRowId,
                threadRowId: threadRowId,
                timestamp: 9999,
                tx: tx,
            )
            store.enqueue(
                try! Attachment(record: attachmentRecord).asStream()!,
                owner: reference.owner.asEligibleUploadOwnerType,
                fullsize: true,
                tx: tx,
            )

            let row = try! QueuedBackupAttachmentUpload.fetchOne(tx.database)
            XCTAssertNotNil(row)
            XCTAssertEqual(row?.attachmentRowId, attachmentRecord.sqliteId)
            // should not have overriden the nil timestamp
            switch row!.highestPriorityOwnerType {
            case .threadWallpaper:
                break
            case .message:
                XCTFail("unexpected type")
            }
        }
    }

    func testDequeue() {
        let timestamps: [UInt64?] = [1111, nil, 4444, 3333, 2222]
        for timestamp in timestamps {
            var attachmentRecord = Attachment.Record.mockStream()
            let (threadRowId, messageRowId) = insertThreadAndInteraction()

            db.write { tx in
                try! attachmentRecord.insert(tx.database)
                let reference: AttachmentReference = {
                    if let timestamp {
                        return insertMessageAttachmentReferenceRecord(
                            attachmentRowId: attachmentRecord.sqliteId!,
                            messageRowId: messageRowId,
                            threadRowId: threadRowId,
                            timestamp: timestamp,
                            tx: tx,
                        )
                    } else {
                        let referenceRecord = AttachmentReference.ThreadAttachmentReferenceRecord(
                            attachmentRowId: attachmentRecord.sqliteId!,
                            // Confusingly, this owner _has_ a timestamp; we just don't use it
                            // for the backup attachment upload queue.
                            threadSource: .globalThreadWallpaperImage(creationTimestamp: 1),
                        )
                        try! referenceRecord.insert(tx.database)
                        return try! AttachmentReference(record: referenceRecord)
                    }
                }()
                store.enqueue(
                    try! Attachment(record: attachmentRecord).asStream()!,
                    owner: reference.owner.asEligibleUploadOwnerType,
                    fullsize: true,
                    tx: tx,
                )
            }
        }

        var dequeuedRecords = [QueuedBackupAttachmentUpload]()
        db.read { tx in
            XCTAssertEqual(
                timestamps.count,
                try! QueuedBackupAttachmentUpload.fetchCount(tx.database),
            )

            dequeuedRecords = store.fetchNextUploads(
                count: UInt(timestamps.count),
                isFullsize: true,
                tx: tx,
            )
        }

        let dequeuedTimestamps: [UInt64?] = dequeuedRecords.map {
            switch $0.highestPriorityOwnerType {
            case .threadWallpaper: return nil
            case .message(let timestamp): return timestamp
            }
        }
        let sortedTimestamps = timestamps.sorted(by: { lhs, rhs in
            return (lhs ?? .max) > (rhs ?? .max)
        })

        // We should have gotten entries in timestamp order
        XCTAssertEqual(dequeuedTimestamps, Array(sortedTimestamps.prefix(sortedTimestamps.count)))

        db.write { tx in
            // Finish all but one
            dequeuedRecords.prefix(timestamps.count - 1).forEach { record in
                store.markUploadDone(
                    for: record.attachmentRowId,
                    fullsize: true,
                    tx: tx,
                )
            }
        }

        db.read { tx in
            // Since not all rows are done, they should all stick around.
            let records = try! QueuedBackupAttachmentUpload.fetchAll(tx.database)
            XCTAssertEqual(5, records.count)
            XCTAssertEqual(4, records.filter({ $0.state == .done }).count)
            XCTAssertEqual(1, records.filter({ $0.state == .ready }).count)
        }

        db.write { tx in
            // Finish the last one
            _ = store.markUploadDone(
                for: dequeuedRecords.last!.attachmentRowId,
                fullsize: true,
                tx: tx,
            )
        }

        db.read { tx in
            // all rows but one should now be deleted.
            XCTAssertEqual(
                0,
                try! QueuedBackupAttachmentUpload.fetchCount(tx.database),
            )
        }
    }

    func testDequeue_thumbnail() throws {
        let timestamps: [UInt64] = [1111, 4444, 3333, 2222]
        for timestamp in timestamps {
            var attachmentRecord = Attachment.Record.mockStream()
            let (threadRowId, messageRowId) = insertThreadAndInteraction()

            db.write { tx in
                try! attachmentRecord.insert(tx.database)
                let reference: AttachmentReference = insertMessageAttachmentReferenceRecord(
                    attachmentRowId: attachmentRecord.sqliteId!,
                    messageRowId: messageRowId,
                    threadRowId: threadRowId,
                    timestamp: timestamp,
                    tx: tx,
                )
                // Enqueue both fullsize and thumbnail
                store.enqueue(
                    try! Attachment(record: attachmentRecord).asStream()!,
                    owner: reference.owner.asEligibleUploadOwnerType,
                    fullsize: true,
                    tx: tx,
                )
                store.enqueue(
                    try! Attachment(record: attachmentRecord).asStream()!,
                    owner: reference.owner.asEligibleUploadOwnerType,
                    fullsize: false,
                    tx: tx,
                )
            }
        }

        var dequeuedRecords = [QueuedBackupAttachmentUpload]()
        db.read { tx in
            XCTAssertEqual(
                timestamps.count * 2,
                try! QueuedBackupAttachmentUpload.fetchCount(tx.database),
            )

            dequeuedRecords = store.fetchNextUploads(
                count: UInt(timestamps.count * 2),
                isFullsize: true,
                tx: tx,
            )
        }

        // We should get results in DESC order with only fullsize results.
        var index = 0
        for timestamp in timestamps.sorted().reversed() {
            XCTAssertEqual(dequeuedRecords[index].isFullsize, true)
            switch dequeuedRecords[index].highestPriorityOwnerType {
            case .threadWallpaper: XCTFail("Unexpected type")
            case .message(let recordTimestamp):
                XCTAssertEqual(timestamp, recordTimestamp)
            }
            index += 1
        }

        db.write { tx in
            dequeuedRecords.forEach { record in
                store.markUploadDone(
                    for: record.attachmentRowId,
                    fullsize: record.isFullsize,
                    tx: tx,
                )
            }
        }

        db.read { tx in
            // All fullsize rows should be done
            let records = try! QueuedBackupAttachmentUpload.fetchAll(tx.database)
            XCTAssertEqual(8, records.count)
            XCTAssertEqual(4, records.filter(\.isFullsize.negated).count)
            XCTAssertEqual(4, records.filter(\.isFullsize).count)
            XCTAssertEqual(4, records.filter({ $0.isFullsize && $0.state == .done }).count)
        }
    }

    // MARK: - Helpers

    private func insertThreadAndInteraction() -> (threadRowId: Int64, interactionRowId: Int64) {
        return db.write { tx in
            let thread = insertThread(tx: tx)
            let interactionRowId = insertInteraction(thread: thread, tx: tx)
            return (thread.sqliteRowId!, interactionRowId)
        }
    }

    private func insertThread(tx: DBWriteTransaction) -> TSThread {
        let thread = TSThread(uniqueId: UUID().uuidString)
        try! thread.insert(tx.database)
        return thread
    }

    private func insertInteraction(thread: TSThread, tx: DBWriteTransaction) -> Int64 {
        let interaction = TSInteraction(timestamp: 0, receivedAtTimestamp: 0, thread: thread)
        try! interaction.asRecord().insert(tx.database)
        return interaction.sqliteRowId!
    }

    private func insertMessageAttachmentReferenceRecord(
        attachmentRowId: Int64,
        messageRowId: Int64,
        threadRowId: Int64,
        timestamp: UInt64,
        tx: DBWriteTransaction,
    ) -> AttachmentReference {
        let record = AttachmentReference.MessageAttachmentReferenceRecord(
            attachmentRowId: attachmentRowId,
            sourceFilename: nil,
            sourceUnencryptedByteCount: nil,
            sourceMediaSizePixels: nil,
            messageSource: .linkPreview(.init(
                messageRowId: messageRowId,
                receivedAtTimestamp: timestamp,
                threadRowId: threadRowId,
                contentType: nil,
                isPastEditRevision: false,
            )),
        )
        try! record.insert(tx.database)
        return try! AttachmentReference(record: record)
    }
}

private extension AttachmentReference.Owner {

    var asEligibleUploadOwnerType: QueuedBackupAttachmentUpload.OwnerType! {
        switch self {
        case .message(let messageSource):
            return .message(timestamp: messageSource.receivedAtTimestamp)
        case .thread(let threadSource):
            switch threadSource {
            case .threadWallpaperImage, .globalThreadWallpaperImage:
                return .threadWallpaper
            }
        case .storyMessage:
            return nil
        }
    }
}