Repository Public
1// SP Notes Core2// File: Tests/SPNotesAPITests/NextCoreFixtureTests.swift3// Description: The 3.0 foundation models decode the real answers of the scratch backend (group `core`): meta, entity4// feed, tasks with client ids, canvas and its 409 copy, and the typed errors.5//6// Author: Simon-Pierre Boucher7// Contact: contact@spboucher.ai8import Foundation9import XCTest10@testable import SPNotesAPI1112final class NextCoreFixtureTests: XCTestCase {13 func testMeta() throws {14 let meta = try NextFixture.decode(ServerMeta.self, "core", "meta")15 XCTAssertEqual(meta.api, 3)16 XCTAssertTrue(meta.has(ServerFeature.entities))17 XCTAssertTrue(meta.has(ServerFeature.canvas))18 XCTAssertTrue(meta.has(ServerFeature.tasksV2))19 XCTAssertNotNil(meta.serverTime)20 XCTAssertFalse(ServerMeta.legacy.has(ServerFeature.entities))21 }2223 func testTasks() throws {24 let created = try NextFixture.decode(TaskItem.self, "core", "task-create")25 XCTAssertEqual(created.status, "todo")26 XCTAssertEqual(created.priority, "high")27 XCTAssertNotNil(created.rev)28 XCTAssertNil(created.deletedAt)29 // A bare date is stored at 12:00 UTC of that day.30 XCTAssertEqual(created.dueAt.map(APIDate.string(from:)), "2026-12-01T12:00:00.000Z")31 let retry = try NextFixture.load("core", "task-create-existing")32 XCTAssertEqual(retry.entry.status, 200)33 XCTAssertEqual(retry.entry.headers["x-existing"], "1")34 XCTAssertEqual(try APIJSON.decoder().decode(TaskItem.self, from: retry.data).title, created.title, "a retry never overwrites")35 let patched = try NextFixture.decode(TaskItem.self, "core", "task-patch")36 XCTAssertTrue(patched.isDone)37 XCTAssertNil(patched.dueAt)38 XCTAssertNotNil(patched.completedAt)39 XCTAssertGreaterThan(patched.rev ?? 0, created.rev ?? 0)40 XCTAssertEqual(try NextFixture.decode(TaskItem.self, "core", "task-get").id, created.id)41 let list = try NextFixture.decode([TaskItem].self, "core", "task-list")42 XCTAssertEqual(list.map(\.id), [created.id])43 XCTAssertNotNil(list[0].pageTitle)44 XCTAssertEqual(try NextFixture.decode(TaskDeleteResult.self, "core", "task-delete").deleted, true)45 XCTAssertEqual(try NextFixture.decode(TaskDeleteResult.self, "core", "task-delete-again").deleted, false)46 XCTAssertNotNil(try NextFixture.decode(TaskItem.self, "core", "task-get-deleted").deletedAt)47 }4849 func testTaskErrors() throws {50 let badPage = try NextFixture.error("core", "task-bad-page")51 XCTAssertEqual(badPage.status, 400)52 XCTAssertEqual(badPage.code, APIError.NextCode.badPage)53 let validation = try NextFixture.error("core", "task-validation")54 XCTAssertEqual(validation.status, 400)55 XCTAssertNil(validation.code, "body-schema validation errors carry no code")56 XCTAssertTrue(validation.message.hasPrefix("Validation:"))57 XCTAssertTrue(validation.isBadRequest)58 XCTAssertEqual(try NextFixture.error("core", "task-bad-id").code, APIError.NextCode.badRequest)59 let missing = try NextFixture.error("core", "task-not-found")60 XCTAssertTrue(missing.isNotFound)61 XCTAssertEqual(missing.code, APIError.NextCode.notFound)62 XCTAssertTrue(try NextFixture.error("core", "task-patch-deleted").isNotFound)63 }6465 func testCanvas() throws {66 let empty = try NextFixture.decode(CanvasEnvelope.self, "core", "canvas-get-empty")67 XCTAssertEqual(empty.version, 1)68 let saved = try NextFixture.decode(CanvasSaveResult.self, "core", "canvas-put")69 XCTAssertEqual(saved.version, 2)70 XCTAssertEqual(saved.unchanged, false)71 let again = try NextFixture.decode(CanvasSaveResult.self, "core", "canvas-put-unchanged")72 XCTAssertEqual(again.version, 2)73 XCTAssertEqual(again.unchanged, true)74 let stored = try NextFixture.decode(CanvasEnvelope.self, "core", "canvas-get")75 XCTAssertEqual(stored.version, 2)76 XCTAssertTrue(stored.data.string.contains("spn-canvas-1"))7778 let conflict = try NextFixture.error("core", "canvas-conflict")79 XCTAssertTrue(conflict.isConflict)80 XCTAssertNil(conflict.serverCopy, "a canvas conflict is not a page conflict")81 let copy = try XCTUnwrap(conflict.canvasConflict)82 XCTAssertEqual(copy.version, 2)83 XCTAssertEqual(copy.data, stored.data)84 let bad = try NextFixture.error("core", "canvas-bad")85 XCTAssertEqual(bad.code, APIError.NextCode.badCanvas)86 XCTAssertNil(bad.canvasConflict)87 let notCanvas = try NextFixture.error("core", "canvas-not-canvas")88 XCTAssertEqual(notCanvas.status, 404)89 XCTAssertEqual(notCanvas.code, APIError.NextCode.notCanvas)90 }9192 func testEntityFeed() throws {93 let all = try NextFixture.decode(SyncPage.self, "core", "sync-kinds-all")94 let entities = try XCTUnwrap(all.entities)95 XCTAssertEqual(Set(entities.keys), Set(SyncKind.all), "one list per requested kind, possibly empty")96 let task = try XCTUnwrap(entities[SyncKind.task]?.last)97 XCTAssertGreaterThan(task.rev, 0)98 XCTAssertEqual(try task.decode(TaskItem.self).id, task.id)99 let canvas = try XCTUnwrap(entities[SyncKind.canvas]?.last)100 XCTAssertEqual(try canvas.decode(CanvasEnvelope.self).pageId, canvas.id, "the id of a canvas row is its page id")101 for (_, rows) in entities {102 XCTAssertEqual(rows.map(\.rev), rows.map(\.rev).sorted())103 XCTAssertTrue(rows.allSatisfy { $0.rev <= all.cursor })104 }105 let some = try NextFixture.decode(SyncPage.self, "core", "sync-kinds-task-canvas")106 XCTAssertEqual(some.entities.map { Set($0.keys) }, [SyncKind.task, SyncKind.canvas])107108 // Without `kinds` the answer has no `entities` key at all (2.x shape).109 XCTAssertNil(try NextFixture.decode(SyncPage.self, "core", "sync-no-kinds").entities)110111 let reset = try NextFixture.decode(SyncPage.self, "core", "sync-reset-kinds")112 XCTAssertTrue(reset.reset)113 XCTAssertEqual(reset.cursor, 0)114 XCTAssertTrue(reset.entities?.values.allSatisfy(\.isEmpty) ?? false)115116 let bad = try NextFixture.error("core", "sync-bad-kinds")117 XCTAssertEqual(bad.code, APIError.NextCode.badKinds)118 XCTAssertEqual(try bad.detail("kinds")?.decode([String].self), SyncKind.all)119 }120121 func testTombstonesAndSoftDeletes() throws {122 let page = try NextFixture.decode(SyncPage.self, "core", "sync-tombstones")123 XCTAssertEqual(Set(page.tombstones.map(\.kind)), ["page", "canvas"])124 XCTAssertEqual(Set(page.tombstones.map(\.id)).count, 1, "the canvas tombstone carries the page id")125 let task = try XCTUnwrap(page.entities?[SyncKind.task]?.first)126 XCTAssertNotNil(task.deletedAt, "a soft-deleted task stays in the feed as a row")127 }128}129