Repository Public
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