Repository Public
1// SP Notes Core2// File: Tests/SPNotesAPITests/RoutesAndMultipartTests.swift3// Description: Every typed endpoint sends the method, path, query and body of the contract (checked on the stub), and4// the multipart body written to disk has the exact expected bytes.5//6// Author: Simon-Pierre Boucher7// Contact: contact@spboucher.ai8import Foundation9import XCTest10@testable import SPNotesAPI1112final class RoutesAndMultipartTests: XCTestCase {13 // MARK: multipart1415 func testMultipartBodyWrittenToFileIsExact() throws {16 let directory = FileManager.default.temporaryDirectory.appendingPathComponent("spn-multipart-\(UUID().uuidString)")17 try FileManager.default.createDirectory(at: directory, withIntermediateDirectories: true)18 defer { try? FileManager.default.removeItem(at: directory) }19 let source = directory.appendingPathComponent("source.bin")20 let payload = Data([0x00, 0xFF, 0x0D, 0x0A, 0x2D, 0x2D]) + Data("binary é payload\r\n--not-a-boundary".utf8)21 try payload.write(to: source)22 let body = directory.appendingPathComponent("body.multipart")2324 let form = MultipartForm(boundary: "spnotes-test-boundary")25 XCTAssertEqual(form.contentType, "multipart/form-data; boundary=spnotes-test-boundary")26 let size = try form.write(27 fields: [.init("id", "0b0b0b0b-0000-4000-8000-000000000001"), .init("pageId", "0b0b0b0b-0000-4000-8000-000000000002")],28 fileField: "file", filename: "Résumé \"final\"\r\nv2.pdf", mimeType: "application/pdf", source: source, to: body29 )3031 var expected = Data()32 expected.append(Data("--spnotes-test-boundary\r\nContent-Disposition: form-data; name=\"id\"\r\n\r\n0b0b0b0b-0000-4000-8000-000000000001\r\n".utf8))33 expected.append(Data("--spnotes-test-boundary\r\nContent-Disposition: form-data; name=\"pageId\"\r\n\r\n0b0b0b0b-0000-4000-8000-000000000002\r\n".utf8))34 expected.append(Data("--spnotes-test-boundary\r\nContent-Disposition: form-data; name=\"file\"; filename=\"Résumé %22final%22%0D%0Av2.pdf\"\r\nContent-Type: application/pdf\r\n\r\n".utf8))35 expected.append(payload)36 expected.append(Data("\r\n--spnotes-test-boundary--\r\n".utf8))37 let written = try Data(contentsOf: body)38 XCTAssertEqual(written, expected)39 XCTAssertEqual(size, Int64(expected.count))40 }4142 func testMultipartWithoutFieldsAndLargeFileIsStreamed() throws {43 let directory = FileManager.default.temporaryDirectory.appendingPathComponent("spn-multipart-\(UUID().uuidString)")44 try FileManager.default.createDirectory(at: directory, withIntermediateDirectories: true)45 defer { try? FileManager.default.removeItem(at: directory) }46 let source = directory.appendingPathComponent("big.bin")47 var payload = Data(count: 3 * (1 << 20) + 123) // more than one copy chunk48 payload.withUnsafeMutableBytes { raw in49 var state: UInt64 = 0x9E37_79B9_7F4A_7C1550 for i in raw.indices { state = state &* 6364136223846793005 &+ 1442695040888963407; raw[i] = UInt8(truncatingIfNeeded: state >> 33) }51 }52 try payload.write(to: source)53 let body = directory.appendingPathComponent("body.multipart")54 let form = MultipartForm(boundary: "b1")55 let size = try form.write(fields: [], filename: "big.bin", mimeType: "", source: source, to: body)56 let written = try Data(contentsOf: body)57 let head = Data("--b1\r\nContent-Disposition: form-data; name=\"file\"; filename=\"big.bin\"\r\nContent-Type: application/octet-stream\r\n\r\n".utf8)58 let tail = Data("\r\n--b1--\r\n".utf8)59 XCTAssertEqual(written.count, head.count + payload.count + tail.count)60 XCTAssertEqual(Int64(written.count), size)61 XCTAssertEqual(written.prefix(head.count), head)62 XCTAssertEqual(written.suffix(tail.count), tail)63 XCTAssertEqual(written.dropFirst(head.count).dropLast(tail.count), payload)64 }6566 func testMultipartHelpers() {67 XCTAssertEqual(MultipartForm.escape("a\"b\rc\nd"), "a%22b%0Dc%0Ad")68 XCTAssertEqual(MultipartForm(boundary: "bad boundary\r\n\"x\"").boundary, "badboundaryx")69 XCTAssertEqual(MultipartForm(boundary: "").boundary, "spnotes-boundary")70 XCTAssertNotEqual(MultipartForm().boundary, MultipartForm().boundary)71 XCTAssertNotNil(MultipartForm().boundary.range(of: "^spnotes-[0-9a-f-]{36}$", options: .regularExpression))72 XCTAssertEqual(MultipartForm.mimeType(forFilename: "Photo.JPG"), "image/jpeg")73 XCTAssertEqual(MultipartForm.mimeType(forFilename: "notes.pdf"), "application/pdf")74 XCTAssertEqual(MultipartForm.mimeType(forFilename: "drawing-1.pkdrawing"), "application/octet-stream")75 XCTAssertEqual(MultipartForm.mimeType(forFilename: "noextension"), "application/octet-stream")76 }7778 func testMultipartMissingSourceIsAFileError() {79 let missing = FileManager.default.temporaryDirectory.appendingPathComponent("spn-missing-\(UUID().uuidString)")80 let body = FileManager.default.temporaryDirectory.appendingPathComponent("spn-body-\(UUID().uuidString)")81 XCTAssertThrowsError(try MultipartForm().write(fields: [], filename: "x", mimeType: "text/plain", source: missing, to: body)) { error in82 guard case APIError.file = error else { return XCTFail("\(error)") }83 }84 XCTAssertFalse(FileManager.default.fileExists(atPath: body.path))85 }8687 func testUploadAttachmentBuildsTheFormAndCleansUp() async throws {88 StubServer.shared.reset { _ in .json(#"{"id":"a1","url":"/api/files/a1","name":"note.txt","size":11,"mime":"text/plain","hasText":true,"pages":null}"#, status: 201) }89 let (api, _, _) = TestEnv.api()90 let file = FileManager.default.temporaryDirectory.appendingPathComponent("spn-note-\(UUID().uuidString).txt")91 try Data("hello world".utf8).write(to: file)92 defer { try? FileManager.default.removeItem(at: file) }93 let before = try temporaryUploadBodies()94 let created = try await api.uploadAttachment(fileURL: file, id: "a1", pageID: "p1", filename: "note.txt")95 XCTAssertFalse(created.existing)96 XCTAssertEqual(created.value, UploadedAttachment(id: "a1", url: "/api/files/a1", name: "note.txt", size: 11, mime: "text/plain", hasText: true, pages: nil))97 let request = try XCTUnwrap(StubServer.shared.last)98 XCTAssertEqual(request.method, "POST")99 XCTAssertEqual(request.path, "/api/attachments")100 let contentType = try XCTUnwrap(request.header("Content-Type"))101 XCTAssertTrue(contentType.hasPrefix("multipart/form-data; boundary=spnotes-"), contentType)102 if !request.body.isEmpty {103 let boundary = String(contentType.dropFirst("multipart/form-data; boundary=".count))104 let expected = "--\(boundary)\r\nContent-Disposition: form-data; name=\"id\"\r\n\r\na1\r\n--\(boundary)\r\nContent-Disposition: form-data; name=\"pageId\"\r\n\r\np1\r\n--\(boundary)\r\nContent-Disposition: form-data; name=\"file\"; filename=\"note.txt\"\r\nContent-Type: text/plain\r\n\r\nhello world\r\n--\(boundary)--\r\n"105 XCTAssertEqual(request.bodyText, expected)106 }107 XCTAssertEqual(try temporaryUploadBodies(), before, "the temporary multipart body is removed")108109 // A cancelled upload is typed and leaves nothing behind.110 let task = Task { try await api.uploadAttachment(fileURL: file) }111 task.cancel()112 do { _ = try await task.value } catch { XCTAssertEqual(error as? APIError, .cancelled) }113 XCTAssertEqual(try temporaryUploadBodies(), before)114 }115116 private func temporaryUploadBodies() throws -> Set<String> {117 Set(try FileManager.default.contentsOfDirectory(atPath: FileManager.default.temporaryDirectory.path).filter { $0.hasPrefix("spnotes-upload-") })118 }119120 // MARK: routes121122 private static let pageJSON = #"{"id":"p1","parentId":null,"databaseId":null,"type":"page","section":"notes","title":"T","icon":null,"cover":null,"content":{"type":"doc","content":[]},"properties":{},"position":1,"pinned":false,"archived":false,"version":1,"wordCount":0,"createdAt":"2026-11-18T19:08:54.894Z","updatedAt":"2026-11-18T19:08:54.894Z","lastOpenedAt":null,"deletedAt":null,"rev":123,"inboxAt":null,"captureKind":null}"#123 private static let taskJSON = #"{"id":"t1","workspaceId":"w","pageId":"p1","title":"x","status":"todo","priority":"high","dueAt":"2026-12-01T10:00:00.000Z","completedAt":null,"project":"p","createdAt":"2026-11-18T19:09:35.524Z","updatedAt":"2026-11-18T19:09:35.524Z","deletedAt":null}"#124125 /// Runs one endpoint against a canned answer and returns the request the server saw.126 private func call<T>(_ answer: String, status: Int = 200, headers: [String: String] = [:], _ body: (NotesAPI) async throws -> T) async throws -> (T, RecordedRequest) {127 StubServer.shared.reset { _ in .json(answer, status: status, headers: headers) }128 let (api, _, _) = TestEnv.api()129 let value = try await body(api)130 return (value, try XCTUnwrap(StubServer.shared.last))131 }132133 private func assertRequest(_ request: RecordedRequest, _ method: String, _ pathAndQuery: String, body: String? = nil, file: StaticString = #filePath, line: UInt = #line) {134 XCTAssertEqual(request.method, method, file: file, line: line)135 XCTAssertEqual(request.path + (request.query.map { "?\($0)" } ?? ""), pathAndQuery, file: file, line: line)136 XCTAssertEqual(request.bodyText, body ?? "", file: file, line: line)137 XCTAssertEqual(request.header("Origin"), method == "GET" ? nil : "https://notes.test", file: file, line: line)138 if body != nil { XCTAssertEqual(request.header("Content-Type"), "application/json", file: file, line: line) }139 }140141 func testPageRoutes() async throws {142 let (created, r1) = try await call(Self.pageJSON, status: 201) { try await $0.createPage(PageDraft(id: "p1", title: "T"), idempotencyKey: "idem-create-1") }143 assertRequest(r1, "POST", "/api/pages", body: #"{"id":"p1","title":"T"}"#)144 XCTAssertEqual(r1.header("Idempotency-Key"), "idem-create-1")145 XCTAssertFalse(created.existing)146 XCTAssertEqual(created.value.id, "p1")147148 let (existing, _) = try await call(Self.pageJSON, headers: ["x-existing": "1"]) { try await $0.createPage(PageDraft(id: "p1", title: "other")) }149 XCTAssertTrue(existing.existing)150 XCTAssertEqual(existing.value.title, "T")151152 let (_, r2) = try await call(Self.pageJSON) { try await $0.createPage() }153 assertRequest(r2, "POST", "/api/pages", body: "{}")154155 let (detail, r3) = try await call(Self.pageJSON) { try await $0.page(id: "p1") }156 assertRequest(r3, "GET", "/api/pages/p1")157 XCTAssertEqual(detail.breadcrumb, [])158 let (_, r4) = try await call(Self.pageJSON) { try await $0.page(id: "p1", open: true) }159 assertRequest(r4, "GET", "/api/pages/p1?open=1")160161 let (head, r5) = try await call(#"{"id":"p1","version":4,"updatedAt":"2026-11-18T19:08:54.894Z","deletedAt":"2026-11-18T19:09:00.000Z"}"#) { try await $0.pageHead(id: "p1") }162 assertRequest(r5, "GET", "/api/pages/p1?head=1")163 XCTAssertEqual(head.version, 4)164 XCTAssertNotNil(head.deletedAt)165166 let (patched, r6) = try await call(#"{"id":"p1","version":2,"updatedAt":"2026-11-18T19:08:55.687Z","title":"New","wordCount":2}"#) {167 try await $0.patchPage(id: "p1", PagePatch(title: "New", parentId: .null, baseVersion: 1), idempotencyKey: "idem-patch-1")168 }169 assertRequest(r6, "PATCH", "/api/pages/p1", body: #"{"baseVersion":1,"parentId":null,"title":"New"}"#)170 XCTAssertEqual(r6.header("Idempotency-Key"), "idem-patch-1")171 XCTAssertEqual(patched, PagePatchResult(id: "p1", version: 2, updatedAt: APIDate.parse("2026-11-18T19:08:55.687Z")!, title: "New", wordCount: 2))172173 let (resolved, r7) = try await call(#"{"id":"p1","version":3,"title":"S","content":{"type":"doc"},"properties":{},"updatedAt":"2026-11-18T19:08:55.687Z","copyId":"c1"}"#) {174 try await $0.resolveConflict(pageID: "p1", choice: .both, serverVersion: 2, mine: ConflictMine(title: "Mine", content: RawJSON(string: #"{"type":"doc","content":[]}"#)))175 }176 assertRequest(r7, "POST", "/api/pages/p1/resolve", body: #"{"choice":"both","mine":{"content":{"content":[],"type":"doc"},"title":"Mine"},"serverVersion":2}"#)177 XCTAssertEqual(resolved.copyId, "c1")178 XCTAssertEqual(resolved.version, 3)179180 let (trashed, r8) = try await call(#"{"ok":true,"trashed":3}"#) { try await $0.trashPage(id: "p1") }181 assertRequest(r8, "DELETE", "/api/pages/p1")182 XCTAssertEqual(trashed.trashed, 3)183 let (_, r9) = try await call(#"{"ok":true}"#) { try await $0.purgePage(id: "p1") }184 assertRequest(r9, "DELETE", "/api/pages/p1?purge=1")185 let (purged, r10) = try await call(#"{"ok":true,"purged":4}"#) { try await $0.emptyTrash() }186 assertRequest(r10, "DELETE", "/api/trash")187 XCTAssertEqual(purged.purged, 4)188 let (_, r11) = try await call(#"{"ok":true,"purged":0}"#) { try await $0.emptyTrash(olderThanDays: 30) }189 assertRequest(r11, "DELETE", "/api/trash?olderThanDays=30")190 let (_, r12) = try await call(#"{"ok":true}"#) { try await $0.restorePage(id: "p1") }191 assertRequest(r12, "POST", "/api/pages/p1?action=restore")192 let (copy, r13) = try await call(Self.pageJSON) { try await $0.duplicatePage(id: "p1") }193 assertRequest(r13, "POST", "/api/pages/p1?action=duplicate")194 XCTAssertEqual(copy.rev, 123)195 }196197 func testReauthRequiredOnPurgeIsTyped() async {198 StubServer.shared.reset { _ in .json(#"{"error":"Verify with your passkey to continue","code":"reauth_required"}"#, status: 403) }199 let (api, client, _) = TestEnv.api()200 let error = await captureAPIError { try await api.purgePage(id: "p1") }201 XCTAssertEqual(error?.needsReauth, true)202 XCTAssertEqual(error?.isRetryable, false)203 let has = await client.hasSession204 XCTAssertTrue(has, "a 403 does not end the session")205 }206207 func testVersionAndTagRoutes() async throws {208 let (versions, r1) = try await call(#"[{"id":"v1","version":1,"title":"T","reason":"autosave","createdAt":"2026-11-18T19:08:55.696Z","wordCount":0}]"#) { try await $0.pageVersions(pageID: "p1") }209 assertRequest(r1, "GET", "/api/pages/p1/versions")210 XCTAssertEqual(versions.first?.reason, "autosave")211 let (snapshot, r2) = try await call(#"{"id":"v1","pageId":"p1","version":1,"title":"T","content":{"type":"doc"},"properties":{},"reason":"autosave","createdAt":"2026-11-18T19:08:55.696Z","wordCount":0}"#) { try await $0.pageVersion(pageID: "p1", version: 1) }212 assertRequest(r2, "GET", "/api/pages/p1/versions?v=1")213 XCTAssertEqual(snapshot.content, RawJSON(string: #"{"type":"doc"}"#))214 let (restored, r3) = try await call(#"{"ok":true,"version":3}"#) { try await $0.restorePageVersion(pageID: "p1", version: 1) }215 assertRequest(r3, "POST", "/api/pages/p1/versions", body: #"{"version":1}"#)216 XCTAssertEqual(restored.version, 3)217218 let (tags, r4) = try await call(#"["alpha","beta"]"#) { try await $0.pageTags(pageID: "p1") }219 assertRequest(r4, "GET", "/api/pages/p1/tags")220 XCTAssertEqual(tags, ["alpha", "beta"])221 let (set, r5) = try await call(#"["alpha","beta"]"#) { try await $0.setPageTags(pageID: "p1", tags: ["#Alpha ", " beta"]) }222 assertRequest(r5, "PUT", "/api/pages/p1/tags", body: ##"{"tags":["#Alpha "," beta"]}"##)223 XCTAssertEqual(set, ["alpha", "beta"])224 let (all, r6) = try await call(#"[{"id":"g1","name":"alpha","color":"gray","pages":2}]"#) { try await $0.tags() }225 assertRequest(r6, "GET", "/api/tags")226 XCTAssertEqual(all, [TagSummary(id: "g1", name: "alpha", color: "gray", pages: 2)])227 }228229 func testAttachmentRoutes() async throws {230 let (list, r1) = try await call(#"[{"id":"a1","filename":"probe.txt","mime":"text/plain","size":48,"pageId":"p1","pageCount":null,"createdAt":"2026-11-18T19:09:15.312Z","hasText":true,"url":"/api/files/a1"}]"#) { try await $0.attachments(pageID: "p1") }231 assertRequest(r1, "GET", "/api/attachments?pageId=p1")232 XCTAssertEqual(list.first?.filename, "probe.txt")233 let (_, r2) = try await call("[]") { try await $0.attachments() }234 assertRequest(r2, "GET", "/api/attachments")235 let (_, r3) = try await call(#"{"ok":true}"#) { try await $0.deleteAttachment(id: "a1") }236 assertRequest(r3, "DELETE", "/api/attachments?id=a1")237238 let payload = Data("downloaded".utf8)239 StubServer.shared.reset { _ in StubReply(status: 200, headers: ["Content-Type": "text/plain", "Content-Length": "\(payload.count)", "Content-Disposition": "inline; filename*=UTF-8''r%C3%A9sum%C3%A9%20v2.txt"], body: payload) }240 let (api, _, _) = TestEnv.api()241 let destination = FileManager.default.temporaryDirectory.appendingPathComponent("spn-file-\(UUID().uuidString).txt")242 defer { try? FileManager.default.removeItem(at: destination) }243 let file = try await api.downloadFile(id: "a1", to: destination)244 XCTAssertEqual(StubServer.shared.last?.path, "/api/files/a1")245 XCTAssertEqual(file, DownloadedFile(fileURL: destination, contentType: "text/plain", expectedSize: 10, suggestedFilename: "résumé v2.txt"))246 XCTAssertEqual(try Data(contentsOf: destination), payload)247248 XCTAssertEqual(NotesAPI.filePath(id: "a1"), "/api/files/a1")249 XCTAssertEqual(NotesAPI.fileID(fromSource: "/api/files/84b299a7-fbcf-4d16-bd2f-34d809e8e467"), "84b299a7-fbcf-4d16-bd2f-34d809e8e467")250 XCTAssertEqual(NotesAPI.fileID(fromSource: "https://note.spboucher.ai/api/files/a1?download=1"), "a1")251 XCTAssertNil(NotesAPI.fileID(fromSource: "https://example.com/image.png"))252 XCTAssertEqual(NotesAPI.filename(fromContentDisposition: "attachment; filename=\"plain.pdf\""), "plain.pdf")253 XCTAssertNil(NotesAPI.filename(fromContentDisposition: "inline"))254 }255256 func testAuthRoutes() async throws {257 let (state, r1) = try await call(#"{"sessionId":"s1","fresh":true,"verifiedAt":"2026-11-18T19:08:41.922Z","freshWindowMs":300000,"idleDays":30,"absoluteDays":90,"rpId":"localhost","origins":["http://localhost:8482"],"legacyEnv":[],"enrollmentOpen":null}"#) { try await $0.authState() }258 assertRequest(r1, "GET", "/api/auth/state")259 XCTAssertTrue(state.fresh)260 XCTAssertEqual(state.freshWindowMs, 300_000)261 XCTAssertEqual(state.origins, ["http://localhost:8482"])262263 let (sessions, r2) = try await call(#"[{"id":"s1","label":"SP Notes · iPhone","ip":"127.0.0.1","createdAt":"2026-11-18T19:08:41.923Z","lastSeenAt":"2026-11-18T19:08:41.923Z","expiresAt":"2026-12-18T19:08:41.922Z","current":true}]"#) { try await $0.sessions() }264 assertRequest(r2, "GET", "/api/auth/sessions")265 XCTAssertEqual(sessions.first?.label, "SP Notes · iPhone")266 XCTAssertEqual(sessions.first?.current, true)267268 let (_, r3) = try await call(#"{"ok":true}"#) { try await $0.revokeSession(id: "s2") }269 assertRequest(r3, "DELETE", "/api/auth/sessions/s2")270 let (revoked, r4) = try await call(#"{"ok":true,"revoked":3}"#) { try await $0.revokeAllSessions() }271 assertRequest(r4, "DELETE", "/api/auth/sessions", body: #"{"includeCurrent":false}"#)272 XCTAssertEqual(revoked.revoked, 3)273 let (_, r5) = try await call(#"{"ok":true,"revoked":4}"#) { try await $0.revokeAllSessions(includeCurrent: true) }274 assertRequest(r5, "DELETE", "/api/auth/sessions", body: #"{"includeCurrent":true}"#)275 let (_, r6) = try await call(#"{"ok":true}"#) { try await $0.logout() }276 assertRequest(r6, "POST", "/api/auth/logout")277278 let (passkeys, r7) = try await call(#"[{"id":"AQID","label":"iPhone","createdAt":"2026-11-18T19:08:41.923Z","lastUsedAt":null,"synced":true,"multiDevice":true,"transports":["internal","hybrid"],"current":true}]"#) { try await $0.passkeys() }279 assertRequest(r7, "GET", "/api/auth/passkeys")280 XCTAssertEqual(passkeys.first?.transports, ["internal", "hybrid"])281 XCTAssertNil(passkeys.first?.lastUsedAt)282 let (_, r8) = try await call(#"{"ok":true}"#) { try await $0.renamePasskey(id: "AQ_-", label: "Mac") }283 assertRequest(r8, "PATCH", "/api/auth/passkeys/AQ_-", body: #"{"label":"Mac"}"#)284 let (_, r9) = try await call(#"{"ok":true}"#) { try await $0.deletePasskey(id: "AQ_-") }285 assertRequest(r9, "DELETE", "/api/auth/passkeys/AQ_-")286287 let (login, r10) = try await call(PasskeyAndAuthTests.requestOptionsJSON) { try await $0.loginOptions() }288 assertRequest(r10, "POST", "/api/auth/login/options")289 XCTAssertEqual(login.rpId, "localhost")290 let (_, r11) = try await call(PasskeyAndAuthTests.requestOptionsJSON) { try await $0.reauthOptions() }291 assertRequest(r11, "POST", "/api/auth/reauth/options")292 let (creation, r12) = try await call(PasskeyAndAuthTests.creationOptionsJSON) { try await $0.passkeyRegistrationOptions() }293 assertRequest(r12, "POST", "/api/auth/passkeys/options")294 XCTAssertEqual(creation.user.name, "simon")295296 StubServer.shared.reset { _ in .json(#"{"options":{"rpId":"x"}}"#) }297 let (api, _, _) = TestEnv.api()298 let error = await captureAPIError { try await api.loginOptions() }299 guard case .decoding = error else { return XCTFail("\(String(describing: error))") }300 }301302 func testSearchTaskInboxCaptureHealthRoutes() async throws {303 let (_, r1) = try await call("[]") { try await $0.search(SearchQuery("budget 2026")) }304 assertRequest(r1, "GET", "/api/search?q=budget%202026&mode=quick")305 let (_, r2) = try await call("[]") { try await $0.search(SearchQuery("x", mode: .hybrid, limit: 5, semantic: false, section: .research, since: "2026-01-01", until: "2026-12-31", includeArchived: true)) }306 assertRequest(r2, "GET", "/api/search?q=x&mode=hybrid&limit=5&semantic=0§ion=research&since=2026-01-01&until=2026-12-31&archived=1")307308 let (tasks, r3) = try await call("[\(Self.taskJSON)]") { try await $0.tasks() }309 assertRequest(r3, "GET", "/api/tasks")310 XCTAssertEqual(tasks.first?.priority, "high")311 XCTAssertEqual(tasks.first?.isDone, false)312 let (_, r4) = try await call("[]") { try await $0.tasks(includeDone: true) }313 assertRequest(r4, "GET", "/api/tasks?done=1")314 let (task, r5) = try await call(Self.taskJSON, status: 201) { try await $0.createTask(TaskDraft(title: "x", priority: .high, pageId: "p1"), idempotencyKey: "idem-task-01") }315 assertRequest(r5, "POST", "/api/tasks", body: #"{"pageId":"p1","priority":"high","title":"x"}"#)316 XCTAssertEqual(task.dueAt, APIDate.parse("2026-12-01T10:00:00Z"))317 let (_, r6) = try await call(Self.taskJSON) { try await $0.updateTask(TaskPatch(id: "t1", dueAt: .null, status: .done)) }318 assertRequest(r6, "PATCH", "/api/tasks", body: #"{"dueAt":null,"id":"t1","status":"done"}"#)319 let (_, r7) = try await call(#"{"ok":true}"#) { try await $0.deleteTask(id: "t1") }320 assertRequest(r7, "DELETE", "/api/tasks?id=t1")321322 let (inbox, r8) = try await call(#"[{"id":"i1","title":"capture","icon":null,"kind":"note","inboxAt":"2026-11-18T19:09:16.458Z","updatedAt":"2026-11-18T19:09:16.460Z","wordCount":0,"excerpt":"","tags":[],"url":null,"image":null,"openTasks":0}]"#) { try await $0.inbox() }323 assertRequest(r8, "GET", "/api/inbox")324 XCTAssertEqual(inbox.first?.kind, "note")325 let (triage, r9) = try await call(#"{"actionId":"x1","summary":"Archived","created":{}}"#) { try await $0.triageInboxItem(id: "i1", .archive) }326 assertRequest(r9, "POST", "/api/inbox/i1", body: #"{"action":"archive"}"#)327 XCTAssertEqual(triage, TriageResult(actionId: "x1", summary: "Archived", created: .emptyObject))328 let (undo, r10) = try await call(#"{"ok":true,"already":false}"#) { try await $0.undoInboxAction(actionID: "x1") }329 assertRequest(r10, "POST", "/api/inbox/undo", body: #"{"actionId":"x1"}"#)330 XCTAssertEqual(undo.already, false)331 let (captured, r11) = try await call(#"{"id":"c1","title":"hello","kind":"note","inboxAt":"2026-11-18T19:09:16.458Z"}"#, status: 201) { try await $0.capture(CaptureRequest(kind: .note, text: "hello"), idempotencyKey: "idem-capture-1") }332 assertRequest(r11, "POST", "/api/capture", body: #"{"kind":"note","text":"hello"}"#)333 XCTAssertEqual(r11.header("Idempotency-Key"), "idem-capture-1")334 XCTAssertEqual(captured.id, "c1")335336 let (health, r12) = try await call(#"{"ok":true,"db":true,"pgvector":true,"worker":false,"passkeys":true,"time":"2026-11-18 14:08:34.315812-05","version":"2.0.0-dev"}"#) { try await $0.health() }337 assertRequest(r12, "GET", "/api/health")338 XCTAssertEqual(health, Health(ok: true, db: true, worker: false, passkeys: true, pgvector: true, version: "2.0.0-dev"))339 }340341 func testIdentifiersArePercentEncodedInPaths() async throws {342 let (_, request) = try await call(#"{"ok":true}"#) { try await $0.restorePage(id: "../x y?z") }343 XCTAssertEqual(request.url.absoluteString, "https://notes.test/api/pages/..%2Fx%20y%3Fz?action=restore")344 XCTAssertNotNil(NotesAPI.newID().range(of: "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$", options: .regularExpression))345 XCTAssertNotNil(NotesAPI.newIdempotencyKey().range(of: "^[A-Za-z0-9_-]{8,100}$", options: .regularExpression))346 }347}348