SPB Git

Repository Public

ErrorAndModelTests.swift 25.4 KB 384 lines swift

1// SP Notes Core2// File: Tests/SPNotesAPITests/ErrorAndModelTests.swift3// Description: Error mapping for every code of the contract, the PATCH conflict payload, null-versus-absent patch4//              encoding, date decoding and the decoding of real server answers.5//6// Author: Simon-Pierre Boucher7// Contact: contact@spboucher.ai8import Foundation9import XCTest10@testable import SPNotesAPI1112final class ErrorAndModelTests: XCTestCase {13    // MARK: errors1415    private struct Expectation {16        var status: Int17        var code: String?18        var conflict = false19        var reauth = false20        var unauthenticated = false21        var retryable = false22        var rateLimited = false23    }2425    func testErrorMappingForEveryContractCode() async {26        let table: [Expectation] = [27            .init(status: 401, code: "unauthenticated", unauthenticated: true),28            .init(status: 403, code: "reauth_required", reauth: true),29            .init(status: 403, code: "csrf"),30            .init(status: 409, code: "conflict", conflict: true),               // without a server copy31            .init(status: 400, code: "bad_document"),32            .init(status: 413, code: "bad_document"),33            .init(status: 429, code: "rate_limited", retryable: true, rateLimited: true),34            .init(status: 409, code: "not_enrolled"),35            .init(status: 409, code: "confirm_expensive"),                      // without a plan36            .init(status: 503, code: "not_configured"),37            .init(status: 503, code: "no_model"),38            .init(status: 409, code: "in_progress", retryable: true),39            .init(status: 400, code: "bad_idempotency_key"),40            .init(status: 422, code: "idempotency_mismatch"),41            .init(status: 400, code: "no_instruction"),42            .init(status: 409, code: "last_passkey"),43            .init(status: 404, code: nil),44            .init(status: 415, code: nil),45            .init(status: 500, code: nil, retryable: true),46            .init(status: 502, code: nil, retryable: true),47            .init(status: 503, code: nil, retryable: true),48            .init(status: 504, code: nil, retryable: true),49        ]50        let (client, _) = TestEnv.client(token: nil)51        for expected in table {52            let codePart = expected.code.map { ",\"code\":\"\($0)\"" } ?? ""53            let body = "{\"error\":\"Message for \(expected.status)\"\(codePart),\"requestId\":\"r\"}"54            StubServer.shared.reset { _ in .json(body, status: expected.status) }55            guard let error = await captureAPIError({ try await client.send(HTTPRequest(method: .post, path: "/api/x")) }) else { continue }56            let label = "\(expected.status) \(expected.code ?? "-")"57            guard case .http(let status, let code, let message, let raw) = error else { XCTFail("\(label): \(error)"); continue }58            XCTAssertEqual(status, expected.status, label)59            XCTAssertEqual(code, expected.code, label)60            XCTAssertEqual(message, "Message for \(expected.status)", label)61            XCTAssertEqual(raw, Data(body.utf8), label)62            XCTAssertEqual(error.status, expected.status, label)63            XCTAssertEqual(error.code, expected.code, label)64            XCTAssertEqual(error.isConflict, expected.conflict, label)65            XCTAssertEqual(error.needsReauth, expected.reauth, label)66            XCTAssertEqual(error.isUnauthenticated, expected.unauthenticated, label)67            XCTAssertEqual(error.isRetryable, expected.retryable, label)68            XCTAssertEqual(error.isRateLimited, expected.rateLimited, label)69            XCTAssertEqual(error.localizedDescription, "Message for \(expected.status)", label)70        }71    }7273    func testErrorWithoutJSONBody() {74        let error = APIError.fromResponse(status: 502, body: Data("<html>Bad gateway</html>".utf8))75        XCTAssertEqual(error, .http(status: 502, code: nil, message: "HTTP 502", body: Data("<html>Bad gateway</html>".utf8)))76        XCTAssertTrue(error.isRetryable)77        XCTAssertEqual(APIError.fromResponse(status: 500, body: Data()).message, "HTTP 500")78    }7980    func testNonHTTPErrorsClassification() {81        XCTAssertTrue(APIError.offline.isRetryable && APIError.offline.isOffline)82        XCTAssertTrue(APIError.timeout.isRetryable)83        XCTAssertTrue(APIError.transport(.networkConnectionLost).isRetryable)84        for error in [APIError.cancelled, .invalidResponse, .decoding("x"), .file("x")] {85            XCTAssertFalse(error.isRetryable)86            XCTAssertNil(error.status)87            XCTAssertFalse(error.isConflict || error.needsReauth || error.isUnauthenticated)88        }89        XCTAssertEqual(APIError.fromTransport(CancellationError()), .cancelled)90        XCTAssertEqual(APIError.fromTransport(URLError(.cancelled)), .cancelled)91        XCTAssertEqual(APIError.fromTransport(URLError(.timedOut)), .timeout)92        XCTAssertEqual(APIError.fromTransport(URLError(.notConnectedToInternet)), .offline)93        XCTAssertEqual(APIError.fromTransport(NSError(domain: "other", code: 1)), .transport(.unknown))94        XCTAssertEqual(APIError.fromTransport(APIError.timeout), .timeout)95    }9697    func testErrorDescriptionNeverContainsTheBody() {98        let error = APIError.http(status: 400, code: "x", message: "msg", body: Data("secret-body".utf8))99        XCTAssertFalse(String(describing: error).contains("secret-body"))100    }101102    // MARK: PATCH conflict103104    /// The exact answer of the test server to a stale `baseVersion` (captured 2026-11-18).105    static let conflictBody = #"{"error":"This note was changed in another session","code":"conflict","server":{"version":2,"title":"spn-api probe 2","content":{"type":"doc","content":[{"type":"paragraph","attrs":{"id":"abcdefghij"},"content":[{"text":"hello world","type":"text"}]}]},"properties":{"favorite":true},"updatedAt":"2026-11-18T19:08:55.687Z"}}"#106107    func testPatchConflictCarriesTheDecodedServerCopy() async throws {108        StubServer.shared.reset { _ in .json(Self.conflictBody, status: 409) }109        let (api, client, _) = TestEnv.api()110        let error = await captureAPIError { try await api.patchPage(id: "p1", PagePatch(title: "stale", baseVersion: 1)) }111        guard case .conflict(let server, let message) = error else { return XCTFail("\(String(describing: error))") }112        XCTAssertEqual(message, "This note was changed in another session")113        XCTAssertEqual(server.version, 2)114        XCTAssertEqual(server.title, "spn-api probe 2")115        XCTAssertEqual(server.updatedAt, APIDate.parse("2026-11-18T19:08:55.687Z"))116        XCTAssertEqual(server.content, RawJSON(string: #"{"type":"doc","content":[{"type":"paragraph","attrs":{"id":"abcdefghij"},"content":[{"type":"text","text":"hello world"}]}]}"#))117        XCTAssertEqual(server.properties, RawJSON(string: #"{"favorite":true}"#))118        XCTAssertNotNil(jsonObject(server.content.data))119        XCTAssertEqual(error?.isConflict, true)120        XCTAssertEqual(error?.status, 409)121        XCTAssertEqual(error?.code, "conflict")122        XCTAssertEqual(error?.serverCopy, server)123        XCTAssertEqual(error?.isRetryable, false)124        let has = await client.hasSession125        XCTAssertTrue(has)126        XCTAssertEqual(StubServer.shared.last?.bodyText, #"{"baseVersion":1,"title":"stale"}"#)127    }128129    func testConfirmExpensiveCarriesThePlan() {130        let body = Data(#"{"error":"This will cost about $0.40","code":"confirm_expensive","plan":{"estCostUsd":0.4,"model":"big","expensive":"This will cost about $0.40"}}"#.utf8)131        let error = APIError.fromResponse(status: 409, body: body)132        guard case .confirmExpensive(let plan, let message) = error else { return XCTFail("\(error)") }133        XCTAssertEqual(message, "This will cost about $0.40")134        XCTAssertEqual(plan, RawJSON(string: #"{"model":"big","estCostUsd":0.4,"expensive":"This will cost about $0.40"}"#))135        XCTAssertEqual(error.code, "confirm_expensive")136        XCTAssertEqual(error.plan, plan)137        XCTAssertFalse(error.isConflict)138        XCTAssertFalse(error.isRetryable)139    }140141    // MARK: PagePatch142143    private func encoded<T: Encodable>(_ value: T) throws -> String {144        String(decoding: try APIJSON.encoder().encode(value), as: UTF8.self)145    }146147    func testPagePatchNullVersusAbsent() throws {148        XCTAssertEqual(try encoded(PagePatch()), "{}")149        XCTAssertTrue(PagePatch().isEmpty)150        XCTAssertTrue(PagePatch(versionReason: "x", baseVersion: 3).isEmpty)151152        XCTAssertEqual(try encoded(PagePatch(parentId: .null)), #"{"parentId":null}"#)153        XCTAssertEqual(try encoded(PagePatch(parentId: .value("0b0b0b0b-0000-4000-8000-000000000001"))), #"{"parentId":"0b0b0b0b-0000-4000-8000-000000000001"}"#)154        XCTAssertEqual(try encoded(PagePatch(icon: .null, cover: .null)), #"{"cover":null,"icon":null}"#)155        XCTAssertEqual(try encoded(PagePatch(icon: .value("📝"), cover: .value("/api/files/c1"))), #"{"cover":"/api/files/c1","icon":"📝"}"#)156        XCTAssertEqual(try encoded(PagePatch(icon: PatchValue(nil))), #"{"icon":null}"#)157        XCTAssertEqual(try encoded(PagePatch(icon: PatchValue("x"))), #"{"icon":"x"}"#)158        XCTAssertFalse(PagePatch(parentId: .null).isEmpty)159        XCTAssertFalse(PagePatch(parentId: .null).touchesVersionedFields)160161        let full = PagePatch(162            title: "T", content: RawJSON(string: #"{ "type" : "doc", "content": [] }"#), icon: .value("i"), cover: .null,163            properties: RawJSON(string: #"{"favorite":true,"n":1.5}"#), parentId: .null, section: .projects, position: 2.5,164            pinned: true, archived: false, versionReason: "manual", baseVersion: 7165        )166        XCTAssertEqual(167            try encoded(full),168            #"{"archived":false,"baseVersion":7,"content":{"content":[],"type":"doc"},"cover":null,"icon":"i","parentId":null,"pinned":true,"position":2.5,"properties":{"favorite":true,"n":1.5},"section":"projects","title":"T","versionReason":"manual"}"#169        )170        XCTAssertTrue(full.touchesVersionedFields)171        XCTAssertEqual(try encoded(PagePatch(position: 3)), #"{"position":3}"#)172    }173174    func testInvalidRawJSONFailsAtEncoding() {175        XCTAssertThrowsError(try APIJSON.encoder().encode(PagePatch(content: RawJSON(string: "{not json"))))176        XCTAssertFalse(RawJSON(string: "{not json").isValid)177        XCTAssertTrue(RawJSON.emptyObject.isValid)178    }179180    func testTaskPatchAndInboxActionEncoding() throws {181        XCTAssertEqual(try encoded(TaskPatch(id: "t1")), #"{"id":"t1"}"#)182        XCTAssertEqual(try encoded(TaskPatch(id: "t1", dueAt: .null, status: .done, project: .null)), #"{"dueAt":null,"id":"t1","project":null,"status":"done"}"#)183        let due = try XCTUnwrap(APIDate.parse("2026-12-01T10:00:00.000Z"))184        XCTAssertEqual(try encoded(TaskPatch(id: "t1", title: "x", dueAt: .value(due), priority: .high, pageId: .value("p1"))), #"{"dueAt":"2026-12-01T10:00:00.000Z","id":"t1","pageId":"p1","priority":"high","title":"x"}"#)185        XCTAssertEqual(try encoded(TaskDraft(title: "x", dueAt: due, priority: .low, project: "p", pageId: "p1")), #"{"dueAt":"2026-12-01T10:00:00.000Z","pageId":"p1","priority":"low","project":"p","title":"x"}"#)186        XCTAssertEqual(try encoded(TaskDraft(title: "x")), #"{"title":"x"}"#)187188        XCTAssertEqual(try encoded(InboxAction.archive), #"{"action":"archive"}"#)189        XCTAssertEqual(try encoded(InboxAction.trash), #"{"action":"trash"}"#)190        XCTAssertEqual(try encoded(InboxAction.reference), #"{"action":"reference"}"#)191        XCTAssertEqual(try encoded(InboxAction.keep()), #"{"action":"keep"}"#)192        XCTAssertEqual(try encoded(InboxAction.keep(section: .projects, parentId: .null)), #"{"action":"keep","parentId":null,"section":"projects"}"#)193        XCTAssertEqual(try encoded(InboxAction.task(dueAt: .value(due), priority: .medium)), #"{"action":"task","dueAt":"2026-12-01T10:00:00.000Z","priority":"medium"}"#)194        XCTAssertEqual(try encoded(InboxAction.database(databaseId: "d1")), #"{"action":"database","databaseId":"d1"}"#)195        XCTAssertEqual(try encoded(CaptureRequest(kind: .link, url: "https://example.com/a?b=1")), #"{"kind":"link","url":"https://example.com/a?b=1"}"#)196        XCTAssertEqual(try encoded(PageDraft(id: "p1", title: "T", section: .notes, type: .page)), #"{"id":"p1","section":"notes","title":"T","type":"page"}"#)197        XCTAssertEqual(try encoded(AIActionRequest(action: .toTasks, text: "x", confirmExpensive: true)), #"{"action":"to_tasks","confirmExpensive":true,"text":"x"}"#)198        XCTAssertEqual(try encoded(AIChatRequest(message: "hi", mode: .summarise, pageId: "p1")), #"{"message":"hi","mode":"summarise","pageId":"p1"}"#)199    }200201    // MARK: dates202203    func testDateDecodingWithAndWithoutFractionalSeconds() throws {204        func date(_ text: String) throws -> Date {205            let json = Data("{\"at\":\"\(text)\"}".utf8)206            return try APIJSON.decoder().decode(DateBox.self, from: json).at207        }208        let reference = Date(timeIntervalSince1970: 1_795_028_824)       // 2026-11-18T19:07:04Z209        XCTAssertEqual(try date("2026-11-18T19:07:04Z"), reference)210        XCTAssertEqual(try date("2026-11-18T19:07:04.000Z"), reference)211        XCTAssertEqual(try date("2026-11-18T19:07:04.808Z").timeIntervalSince1970, 1_795_028_824.808, accuracy: 0.0005)212        XCTAssertEqual(try date("2026-11-18T19:07:04.808123Z").timeIntervalSince1970, 1_795_028_824.808123, accuracy: 0.000_001)213        XCTAssertEqual(try date("2026-11-18T14:07:04-05:00"), reference)214        XCTAssertEqual(try date("2026-11-18T20:07:04.000+01:00"), reference)215        XCTAssertEqual(try date("2026-11-18T19:07:04+0000"), reference)216        // The PostgreSQL text form that /api/search lets through.217        XCTAssertEqual(try date("2026-11-18 14:07:04-05"), reference)218        XCTAssertEqual(try date("2026-11-18 14:07:04.808-05").timeIntervalSince1970, 1_795_028_824.808, accuracy: 0.0005)219        XCTAssertEqual(try date("2026-11-18 14:07:04.808123-05").timeIntervalSince1970, 1_795_028_824.808123, accuracy: 0.000_001)220        XCTAssertEqual(try date("2026-11-18"), Date(timeIntervalSince1970: 1_794_960_000))221        XCTAssertEqual(try date("1970-01-01T00:00:00Z"), Date(timeIntervalSince1970: 0))222        XCTAssertEqual(try date("2024-02-29T23:59:59Z"), Date(timeIntervalSince1970: 1_709_251_199))223        for bad in ["", "yesterday", "2026-13-01T00:00:00Z", "2026-11-18T19:07", "2026-11-18T19:07:04.Z", "2026-11-18T19:07:04Zjunk", "20261118T190704Z"] {224            if bad == "2026-11-18T19:07" { XCTAssertNoThrow(try date(bad)); continue }     // seconds are optional225            XCTAssertThrowsError(try date(bad), bad)226        }227    }228229    func testDateEncodingAndRoundTrip() throws {230        XCTAssertEqual(APIDate.string(from: Date(timeIntervalSince1970: 1_795_028_824.808)), "2026-11-18T19:07:04.808Z")231        XCTAssertEqual(APIDate.string(from: Date(timeIntervalSince1970: 0)), "1970-01-01T00:00:00.000Z")232        XCTAssertEqual(APIDate.string(from: Date(timeIntervalSince1970: -0.5)), "1969-12-31T23:59:59.500Z")233        XCTAssertEqual(APIDate.string(from: Date(timeIntervalSince1970: 951_782_400)), "2000-02-29T00:00:00.000Z")234        let iso = ISO8601DateFormatter()235        iso.formatOptions = [.withInternetDateTime, .withFractionalSeconds]236        var generator = SystemRandomNumberGenerator()237        for _ in 0..<2_000 {238            let ms = Int64.random(in: -2_000_000_000_000...4_000_000_000_000, using: &generator)239            let date = Date(timeIntervalSince1970: Double(ms) / 1000)240            let text = APIDate.string(from: date)241            XCTAssertEqual(text, iso.string(from: date))242            let parsed = try XCTUnwrap(APIDate.parse(text))243            XCTAssertEqual(parsed.timeIntervalSince1970, date.timeIntervalSince1970, accuracy: 0.0005, text)244            XCTAssertEqual(APIDate.string(from: parsed), text)245        }246    }247248    // MARK: decoding real answers249250    /// Captured from the test server on 2026-11-18 (shortened).251    static let syncBody = #"""252    {"cursor":146,"head":146,"more":false,"reset":false,"serverTime":"2026-11-18T19:08:44.969Z","workspace":{"id":"1b3f887c-be2b-43bf-b8a1-327a462fc96b","name":"Note SPBoucher AI"},"user":{"displayName":"Simon-Pierre Boucher"},253     "pages":[{"id":"6eaa802c-1a62-4d68-8292-bc90abd45a78","parentId":null,"databaseId":null,"type":"page","section":"notes","title":"hors ligne","icon":null,"cover":null,"content":{"type":"doc","content":[{"type":"paragraph","attrs":{"id":"X__XZ-YTBL"}}]},"properties":{},"position":1,"pinned":false,"archived":false,"version":1,"wordCount":0,"createdAt":"2026-11-18T19:03:22.501Z","updatedAt":"2026-11-18T19:03:22.501Z","lastOpenedAt":null,"deletedAt":null,"inboxAt":null,"captureKind":null,"rev":122,"tags":["alpha","beta"]}],254     "attachments":[{"id":"84b299a7-fbcf-4d16-bd2f-34d809e8e467","pageId":null,"filename":"probe.txt","mime":"text/plain","size":48,"sha256":"3205df260b0dae9628f93cd25b76c77672c06901f4bf222c9cf49ffab0d1a033","pageCount":null,"createdAt":"2026-11-18T19:09:15.312Z","deletedAt":"2026-11-18T19:09:15.799Z","rev":143}],255     "tombstones":[{"id":"d4d64086-62ae-43db-9b63-e6f5c7396a34","kind":"page","rev":48,"deletedAt":"2026-11-18T19:02:44.747Z"},{"id":"84b299a7-fbcf-4d16-bd2f-34d809e8e467","kind":"attachment","rev":150,"deletedAt":"2026-11-18T19:02:44.747Z"}],256     "tags":[{"name":"alpha","color":"gray"},{"name":"beta","color":"gray"}]}257    """#258259    func testSyncPageDecoding() async throws {260        StubServer.shared.reset { _ in .json(Self.syncBody) }261        let (api, _, _) = TestEnv.api()262        let page = try await api.sync(since: 121, limit: 50)263        XCTAssertEqual(StubServer.shared.last?.url.absoluteString, "https://notes.test/api/sync?since=121&limit=50")264        XCTAssertEqual(page.cursor, 146)265        XCTAssertEqual(page.head, 146)266        XCTAssertFalse(page.more)267        XCTAssertFalse(page.reset)268        XCTAssertEqual(page.serverTime, APIDate.parse("2026-11-18T19:08:44.969Z"))269        XCTAssertEqual(page.workspace.name, "Note SPBoucher AI")270        XCTAssertEqual(page.user.displayName, "Simon-Pierre Boucher")271        let row = try XCTUnwrap(page.pages.first)272        XCTAssertEqual(row.id, "6eaa802c-1a62-4d68-8292-bc90abd45a78")273        XCTAssertNil(row.parentId)274        XCTAssertEqual(row.title, "hors ligne")275        XCTAssertEqual(row.section, "notes")276        XCTAssertEqual(row.content.string, #"{"content":[{"attrs":{"id":"X__XZ-YTBL"},"type":"paragraph"}],"type":"doc"}"#)277        XCTAssertEqual(row.properties.string, "{}")278        XCTAssertEqual(row.position, 1)279        XCTAssertEqual(row.version, 1)280        XCTAssertEqual(row.rev, 122)281        XCTAssertEqual(row.tags, ["alpha", "beta"])282        XCTAssertNil(row.deletedAt)283        let attachment = try XCTUnwrap(page.attachments.first)284        XCTAssertEqual(attachment.size, 48)285        XCTAssertEqual(attachment.sha256?.count, 64)286        XCTAssertNotNil(attachment.deletedAt)287        XCTAssertEqual(attachment.rev, 143)288        XCTAssertEqual(page.tombstones.map(\.kind), [Tombstone.pageKind, Tombstone.attachmentKind])289        XCTAssertEqual(page.tombstones.map(\.rev), [48, 150])290        XCTAssertEqual(page.tags, [TagColor(name: "alpha", color: "gray"), TagColor(name: "beta", color: "gray")])291292        // A feed page survives an encode/decode round trip (local persistence, test fixtures of other modules).293        let again = try APIJSON.decoder().decode(SyncPage.self, from: try APIJSON.encoder().encode(page))294        XCTAssertEqual(again, page)295    }296297    /// The abbreviated answer the server gives when the cursor is ahead of it (captured 2026-11-18): no `user`.298    func testSyncResetAnswerDecoding() throws {299        let body = #"{"reset":true,"cursor":0,"head":178,"more":true,"pages":[],"attachments":[],"tombstones":[],"tags":[],"workspace":{"id":"w1","name":"Note SPBoucher AI"},"serverTime":"2026-11-18T19:35:53.175Z"}"#300        let page = try APIJSON.decoder().decode(SyncPage.self, from: Data(body.utf8))301        XCTAssertTrue(page.reset)302        XCTAssertEqual(page.cursor, 0)303        XCTAssertEqual(page.head, 178)304        XCTAssertTrue(page.more)305        XCTAssertNil(page.user.displayName)306        XCTAssertTrue(page.pages.isEmpty && page.tombstones.isEmpty && page.tags.isEmpty)307    }308309    func testPageDetailDecoding() throws {310        let body = #"{"id":"364a2304-1efe-4237-b2ff-e7f57ce660ad","workspaceId":"1b3f887c-be2b-43bf-b8a1-327a462fc96b","parentId":"0b0b0b0b-0000-4000-8000-000000000001","databaseId":null,"type":"page","section":"notes","title":"spn-api probe","icon":"📝","cover":null,"content":{"type":"doc","content":[{"type":"paragraph","attrs":{"id":"W0tnlZ8g9w"}}]},"plainText":"","tsv":"'api':3A","properties":{"favorite":true},"position":2.5,"pinned":true,"archived":false,"version":3,"wordCount":12,"createdAt":"2026-11-18T19:08:54.894Z","updatedAt":"2026-11-18T19:08:54.894Z","lastOpenedAt":"2026-11-18T19:08:54Z","deletedAt":null,"rev":123,"inboxAt":null,"captureKind":null,"breadcrumb":[{"id":"0b0b0b0b-0000-4000-8000-000000000001","title":"Parent","icon":null},{"id":"364a2304-1efe-4237-b2ff-e7f57ce660ad","title":"spn-api probe","icon":"📝"}],"backlinks":[{"id":"b1","title":"Linking page","icon":null,"section":"notes","updatedAt":"2026-11-18T19:08:54.894Z"}]}"#311        let detail = try APIJSON.decoder().decode(PageDetail.self, from: Data(body.utf8))312        XCTAssertEqual(detail.page.icon, "📝")313        XCTAssertEqual(detail.page.parentId, "0b0b0b0b-0000-4000-8000-000000000001")314        XCTAssertEqual(detail.page.position, 2.5)315        XCTAssertTrue(detail.page.pinned)316        XCTAssertNil(detail.page.tags)317        XCTAssertEqual(detail.page.plainText, "")318        XCTAssertEqual(detail.page.properties, RawJSON(string: #"{"favorite":true}"#))319        XCTAssertEqual(detail.breadcrumb.map(\.title), ["Parent", "spn-api probe"])320        XCTAssertEqual(detail.backlinks.first?.section, "notes")321        let again = try APIJSON.decoder().decode(PageDetail.self, from: try APIJSON.encoder().encode(detail))322        XCTAssertEqual(again, detail)323    }324325    func testRawJSONSemantics() throws {326        XCTAssertEqual(RawJSON(string: #"{"a":1,"b":[true,null,"x"]}"#), RawJSON(string: #"{ "b" : [true, null, "x"], "a" : 1 }"#))327        XCTAssertNotEqual(RawJSON(string: #"{"a":1}"#), RawJSON(string: #"{"a":2}"#))328        XCTAssertNotEqual(RawJSON(string: "{bad"), RawJSON(string: "{worse"))329        struct Flags: Codable, Equatable { var favorite: Bool; var count: Int }330        let raw = try RawJSON(encoding: Flags(favorite: true, count: 3))331        XCTAssertEqual(raw.string, #"{"count":3,"favorite":true}"#)332        XCTAssertEqual(try raw.decode(Flags.self), Flags(favorite: true, count: 3))333        // Numbers, unicode and nesting survive the trip through a larger answer.334        struct Wrapper: Codable { var content: RawJSON }335        let source = #"{"content":{"big":9007199254740993,"neg":-12,"float":0.1,"exp":1e21,"text":"é \" \\ / \n 😀","nested":[[],{},[1,[2,[3]]]],"nil":null,"t":true}}"#336        let decoded = try APIJSON.decoder().decode(Wrapper.self, from: Data(source.utf8))337        XCTAssertEqual(decoded.content.string, #"{"big":9007199254740993,"exp":1e+21,"float":0.1,"neg":-12,"nested":[[],{},[1,[2,[3]]]],"nil":null,"t":true,"text":"é \" \\ / \n 😀"}"#)338        let reencoded = try APIJSON.encoder().encode(decoded)339        XCTAssertEqual(jsonObject(reencoded), jsonObject(Data(source.utf8)))340    }341342    func testSearchHitDecodingBothModes() throws {343        let quick = #"[{"id":"364a2304","title":"spn-api probe","icon":null,"type":"page","section":"notes","updatedAt":"2026-11-18 14:08:56.283-05"}]"#344        let hits = try APIJSON.decoder().decode([SearchHit].self, from: Data(quick.utf8))345        XCTAssertEqual(hits[0].targetPageID, "364a2304")346        XCTAssertEqual(hits[0].updatedAt, APIDate.parse("2026-11-18T19:08:56.283Z"))347        let hybrid = #"[{"chunkId":"c1","pageId":"p1","sourceType":"page","sourceId":"p1","title":"T","icon":null,"heading":"H","blockId":"b1","content":"passage","score":0.42,"semantic":0.5,"keyword":0.1,"kind":"page","snippet":"a \u0001hit\u0002"}]"#348        let passages = try APIJSON.decoder().decode([SearchHit].self, from: Data(hybrid.utf8))349        XCTAssertEqual(passages[0].targetPageID, "p1")350        XCTAssertEqual(passages[0].blockId, "b1")351        XCTAssertEqual(passages[0].score, 0.42)352        XCTAssertEqual(passages[0].snippet, "a \u{1}hit\u{2}")353        XCTAssertTrue(passages[0].raw.string.contains("\"chunkId\":\"c1\""))354    }355356    func testBase64URL() {357        XCTAssertEqual(Base64URL.encode(Data([0xFB, 0xFF, 0xFE])), "-__-")358        XCTAssertEqual(Base64URL.encode(Data([0x01])), "AQ")359        XCTAssertEqual(Base64URL.encode(Data()), "")360        XCTAssertEqual(Base64URL.decode("-__-"), Data([0xFB, 0xFF, 0xFE]))361        XCTAssertEqual(Base64URL.decode("AQ"), Data([0x01]))362        XCTAssertEqual(Base64URL.decode("AQ=="), Data([0x01]))363        XCTAssertEqual(Base64URL.decode("AQI="), Data([0x01, 0x02]))364        XCTAssertEqual(Base64URL.decode("AQI"), Data([0x01, 0x02]))365        XCTAssertEqual(Base64URL.decode("+/+/"), Data([0xFB, 0xFF, 0xBF]))366        XCTAssertEqual(Base64URL.decode(""), Data())367        XCTAssertNil(Base64URL.decode("A"))368        XCTAssertNil(Base64URL.decode("AQ I"))369        XCTAssertNil(Base64URL.decode("AQ*"))370        var generator = SystemRandomNumberGenerator()371        for length in 0..<70 {372            let data = Data((0..<length).map { _ in UInt8.random(in: 0...255, using: &generator) })373            let text = Base64URL.encode(data)374            XCTAssertNil(text.rangeOfCharacter(from: CharacterSet(charactersIn: "+/=")))375            XCTAssertEqual(Base64URL.decode(text), data)376            XCTAssertEqual(Base64URL.decode(data.base64EncodedString()), data)377        }378    }379}380381private struct DateBox: Decodable {382    var at: Date383}384
Files main
Menu

Theme