@remit/data-ports 0.0.83 → 0.0.85

package/src/conformance/calendar-suggestion.ts

@@ -1,490 +0,0 @@
-import assert from "node:assert/strict";
-import { after, before, describe, test } from "node:test";
-import {
-	CalendarInviteMethod,
-	CalendarSuggestionSource,
-	CalendarSuggestionState,
-	ZoneCertainty,
-} from "@remit/domain-enums";
-import { deriveCalendarSuggestionId } from "../id.js";
-import type { ICalendarSuggestionRepository } from "../interfaces/calendar-suggestion.js";
-import type { PutCalendarSuggestionInput } from "../types.js";
-import type { RepositoryConformanceHarness } from "./harness.js";
-
-const suggestion = (
-	accountConfigId: string,
-	messageId: string,
-	bodyPartId: string,
-	icalUid: string,
-	overrides: Partial<PutCalendarSuggestionInput> = {},
-): PutCalendarSuggestionInput => ({
-	accountConfigId,
-	messageId,
-	bodyPartId,
-	icalUid,
-	sequence: 0,
-	method: CalendarInviteMethod.Request,
-	source: CalendarSuggestionSource.IcalendarPart,
-	summary: "Design review",
-	dtStart: "2026-09-01T10:00:00+02:00",
-	dtEnd: "2026-09-01T11:00:00+02:00",
-	endsAtUtc: "2026-09-01T09:00:00Z",
-	allDay: false,
-	location: "",
-	organizer: "organizer@example.test",
-	zoneCertainty: ZoneCertainty.Explicit,
-	icalData: "BEGIN:VCALENDAR\r\nEND:VCALENDAR\r\n",
-	...overrides,
-});
-
-const EARLIEST_INSTANT = "1970-01-01T00:00:00.000Z";
-
-export function calendarSuggestionRepositoryConformance(
-	harness: RepositoryConformanceHarness<ICalendarSuggestionRepository>,
-): void {
-	describe("ICalendarSuggestionRepository conformance", () => {
-		let repo: ICalendarSuggestionRepository;
-
-		before(async () => {
-			repo = await harness.createRepository();
-		});
-
-		after(() => harness.teardown());
-
-		test("put writes a Pending suggestion under its derived id", async () => {
-			const accountConfigId = harness.makeId();
-			const messageId = harness.makeId();
-			const bodyPartId = harness.makeId();
-
-			const written = await repo.put(
-				suggestion(accountConfigId, messageId, bodyPartId, "uid-1"),
-			);
-
-			assert.equal(
-				written.suggestionId,
-				deriveCalendarSuggestionId(messageId, bodyPartId, "uid-1"),
-			);
-			assert.equal(written.state, CalendarSuggestionState.Pending);
-			assert.equal(written.acceptedCalendarObjectId, "");
-		});
-
-		test("put re-reading the same message converges on one row", async () => {
-			const accountConfigId = harness.makeId();
-			const messageId = harness.makeId();
-			const bodyPartId = harness.makeId();
-
-			await repo.put(
-				suggestion(accountConfigId, messageId, bodyPartId, "uid-1"),
-			);
-			await repo.put(
-				suggestion(accountConfigId, messageId, bodyPartId, "uid-1", {
-					summary: "Design review, moved",
-				}),
-			);
-
-			const rows = await repo.listByMessage(accountConfigId, messageId);
-			assert.equal(rows.length, 1);
-			assert.equal(rows[0]?.summary, "Design review, moved");
-		});
-
-		test("put leaves an answered suggestion answered", async () => {
-			// A re-sync must never walk a decision back to Pending: the user
-			// already added this event to a calendar, and a producer write is not
-			// allowed to un-decide that.
-			const accountConfigId = harness.makeId();
-			const messageId = harness.makeId();
-			const bodyPartId = harness.makeId();
-
-			const written = await repo.put(
-				suggestion(accountConfigId, messageId, bodyPartId, "uid-1"),
-			);
-			await repo.settle(accountConfigId, written.suggestionId, {
-				state: CalendarSuggestionState.Accepted,
-				acceptedCalendarObjectId: "cal-object-1",
-			});
-			await repo.put(
-				suggestion(accountConfigId, messageId, bodyPartId, "uid-1"),
-			);
-
-			const reread = await repo.get(accountConfigId, written.suggestionId);
-			assert.equal(reread.state, CalendarSuggestionState.Accepted);
-			assert.equal(reread.acceptedCalendarObjectId, "cal-object-1");
-		});
-
-		test("get rejects a suggestion that is not there", async () => {
-			const accountConfigId = harness.makeId();
-			await assert.rejects(
-				() => repo.get(accountConfigId, harness.makeId()),
-				(error: unknown) => harness.isNotFoundError(error),
-			);
-		});
-
-		test("get scopes to the account config", async () => {
-			const accountConfigId = harness.makeId();
-			const written = await repo.put(
-				suggestion(accountConfigId, harness.makeId(), harness.makeId(), "uid"),
-			);
-
-			await assert.rejects(
-				() => repo.get(harness.makeId(), written.suggestionId),
-				(error: unknown) => harness.isNotFoundError(error),
-			);
-		});
-
-		test("listByMessage returns every suggestion one message produced", async () => {
-			const accountConfigId = harness.makeId();
-			const messageId = harness.makeId();
-			const other = harness.makeId();
-
-			await repo.put(
-				suggestion(accountConfigId, messageId, harness.makeId(), "uid-a"),
-			);
-			await repo.put(
-				suggestion(accountConfigId, messageId, harness.makeId(), "uid-b"),
-			);
-			await repo.put(
-				suggestion(accountConfigId, other, harness.makeId(), "uid-c"),
-			);
-
-			const rows = await repo.listByMessage(accountConfigId, messageId);
-			assert.deepEqual(rows.map((row) => row.icalUid).sort(), [
-				"uid-a",
-				"uid-b",
-			]);
-		});
-
-		test("listByState returns only the state asked for", async () => {
-			const accountConfigId = harness.makeId();
-			const pending = await repo.put(
-				suggestion(accountConfigId, harness.makeId(), harness.makeId(), "p"),
-			);
-			const declined = await repo.put(
-				suggestion(accountConfigId, harness.makeId(), harness.makeId(), "d"),
-			);
-			await repo.settle(accountConfigId, declined.suggestionId, {
-				state: CalendarSuggestionState.Declined,
-				acceptedCalendarObjectId: "",
-			});
-
-			const page = await repo.listByState(
-				accountConfigId,
-				CalendarSuggestionState.Pending,
-				{ endsAfter: EARLIEST_INSTANT },
-			);
-			assert.deepEqual(
-				page.items.map((row) => row.suggestionId),
-				[pending.suggestionId],
-			);
-		});
-
-		test("listByState drops a suggestion that ended before endsAfter, comparing instants across offsets", async () => {
-			const accountConfigId = harness.makeId();
-			await repo.put(
-				suggestion(
-					accountConfigId,
-					harness.makeId(),
-					harness.makeId(),
-					"ended",
-					{
-						dtEnd: "2026-10-06T23:00:00+14:00",
-						endsAtUtc: "2026-10-06T09:00:00Z",
-					},
-				),
-			);
-			const running = await repo.put(
-				suggestion(
-					accountConfigId,
-					harness.makeId(),
-					harness.makeId(),
-					"running",
-					{
-						dtEnd: "2026-10-06T01:00:00-12:00",
-						endsAtUtc: "2026-10-06T13:00:00Z",
-					},
-				),
-			);
-
-			const page = await repo.listByState(
-				accountConfigId,
-				CalendarSuggestionState.Pending,
-				{ endsAfter: "2026-10-06T10:00:00Z" },
-			);
-			assert.deepEqual(
-				page.items.map((row) => row.suggestionId),
-				[running.suggestionId],
-			);
-		});
-
-		test("listByState keeps a suggestion ending exactly at endsAfter", async () => {
-			const accountConfigId = harness.makeId();
-			const boundary = await repo.put(
-				suggestion(
-					accountConfigId,
-					harness.makeId(),
-					harness.makeId(),
-					"edge",
-					{
-						endsAtUtc: "2026-10-06T10:00:00Z",
-					},
-				),
-			);
-
-			const page = await repo.listByState(
-				accountConfigId,
-				CalendarSuggestionState.Pending,
-				{ endsAfter: "2026-10-06T10:00:00Z" },
-			);
-			assert.deepEqual(
-				page.items.map((row) => row.suggestionId),
-				[boundary.suggestionId],
-			);
-		});
-
-		test("listByState scopes to the account config", async () => {
-			const accountConfigId = harness.makeId();
-			await repo.put(
-				suggestion(harness.makeId(), harness.makeId(), harness.makeId(), "x"),
-			);
-
-			const page = await repo.listByState(
-				accountConfigId,
-				CalendarSuggestionState.Pending,
-				{ endsAfter: EARLIEST_INSTANT },
-			);
-			assert.equal(page.items.length, 0);
-		});
-
-		test("listByState pages, and the token resumes where the page stopped", async () => {
-			const accountConfigId = harness.makeId();
-			for (const uid of ["a", "b", "c"]) {
-				await repo.put(
-					suggestion(accountConfigId, harness.makeId(), harness.makeId(), uid),
-				);
-			}
-
-			const first = await repo.listByState(
-				accountConfigId,
-				CalendarSuggestionState.Pending,
-				{ endsAfter: EARLIEST_INSTANT, limit: 2 },
-			);
-			assert.equal(first.items.length, 2);
-			assert.ok(first.continuationToken);
-
-			const second = await repo.listByState(
-				accountConfigId,
-				CalendarSuggestionState.Pending,
-				{
-					endsAfter: EARLIEST_INSTANT,
-					limit: 2,
-					continuationToken: first.continuationToken,
-				},
-			);
-			const seen = [...first.items, ...second.items].map(
-				(row) => row.suggestionId,
-			);
-			assert.equal(new Set(seen).size, 3);
-		});
-
-		test("listByAcceptedCalendarObjects returns, in one read, the account's suggestions answered into any of the resources", async () => {
-			const accountConfigId = harness.makeId();
-			const first = await repo.put(
-				suggestion(accountConfigId, harness.makeId(), harness.makeId(), "uid"),
-			);
-			const second = await repo.put(
-				suggestion(accountConfigId, harness.makeId(), harness.makeId(), "uid"),
-			);
-			const elsewhere = await repo.put(
-				suggestion(accountConfigId, harness.makeId(), harness.makeId(), "uid"),
-			);
-			const unasked = await repo.put(
-				suggestion(accountConfigId, harness.makeId(), harness.makeId(), "uid"),
-			);
-			const stranger = harness.makeId();
-			const strangers = await repo.put(
-				suggestion(stranger, harness.makeId(), harness.makeId(), "uid"),
-			);
-			for (const [owner, row, objectId] of [
-				[accountConfigId, first, "cal-object-1"],
-				[accountConfigId, second, "cal-object-1"],
-				[accountConfigId, elsewhere, "cal-object-2"],
-				[accountConfigId, unasked, "cal-object-3"],
-				[stranger, strangers, "cal-object-1"],
-			] as const) {
-				await repo.settle(owner, row.suggestionId, {
-					state: CalendarSuggestionState.Accepted,
-					acceptedCalendarObjectId: objectId,
-				});
-			}
-
-			const rows = await repo.listByAcceptedCalendarObjects(accountConfigId, [
-				"cal-object-1",
-				"cal-object-2",
-			]);
-
-			assert.deepEqual(
-				rows.map((row) => row.suggestionId).sort(),
-				[
-					first.suggestionId,
-					second.suggestionId,
-					elsewhere.suggestionId,
-				].sort(),
-			);
-			assert.deepEqual(
-				await repo.listByAcceptedCalendarObjects(accountConfigId, []),
-				[],
-			);
-		});
-
-		test("settle records the accepted resource", async () => {
-			const accountConfigId = harness.makeId();
-			const written = await repo.put(
-				suggestion(accountConfigId, harness.makeId(), harness.makeId(), "uid"),
-			);
-
-			const settled = await repo.settle(accountConfigId, written.suggestionId, {
-				state: CalendarSuggestionState.Accepted,
-				acceptedCalendarObjectId: "cal-object-9",
-			});
-
-			assert.equal(settled.state, CalendarSuggestionState.Accepted);
-			assert.equal(settled.acceptedCalendarObjectId, "cal-object-9");
-		});
-
-		test("supersedeIfPending retires a card still waiting on the user", async () => {
-			const accountConfigId = harness.makeId();
-			const written = await repo.put(
-				suggestion(accountConfigId, harness.makeId(), harness.makeId(), "uid"),
-			);
-
-			const newerMessageId = harness.makeId();
-			const retired = await repo.supersedeIfPending(
-				accountConfigId,
-				written.suggestionId,
-				newerMessageId,
-			);
-
-			assert.equal(retired?.state, CalendarSuggestionState.Superseded);
-			const reread = await repo.get(accountConfigId, written.suggestionId);
-			assert.equal(reread.supersededByMessageId, newerMessageId);
-		});
-
-		test("a re-read of the retired message keeps the revision that retired it", async () => {
-			const accountConfigId = harness.makeId();
-			const input = suggestion(
-				accountConfigId,
-				harness.makeId(),
-				harness.makeId(),
-				"uid",
-			);
-			const written = await repo.put(input);
-			const newerMessageId = harness.makeId();
-			await repo.supersedeIfPending(
-				accountConfigId,
-				written.suggestionId,
-				newerMessageId,
-			);
-
-			const rewritten = await repo.put(input);
-
-			assert.equal(rewritten.state, CalendarSuggestionState.Superseded);
-			assert.equal(rewritten.supersededByMessageId, newerMessageId);
-		});
-
-		test("supersedeIfPending leaves an answered card alone and says so", async () => {
-			// The producer reads the pending set and writes to it in two steps. A
-			// person accepting in between must keep their acceptance — and the
-			// link to the event it put in their calendar.
-			const accountConfigId = harness.makeId();
-			const written = await repo.put(
-				suggestion(accountConfigId, harness.makeId(), harness.makeId(), "uid"),
-			);
-			await repo.settle(accountConfigId, written.suggestionId, {
-				state: CalendarSuggestionState.Accepted,
-				acceptedCalendarObjectId: "cal-object-7",
-			});
-
-			const retired = await repo.supersedeIfPending(
-				accountConfigId,
-				written.suggestionId,
-				harness.makeId(),
-			);
-
-			assert.equal(retired, null);
-			const reread = await repo.get(accountConfigId, written.suggestionId);
-			assert.equal(reread.state, CalendarSuggestionState.Accepted);
-			assert.equal(reread.supersededByMessageId, "");
-			assert.equal(reread.acceptedCalendarObjectId, "cal-object-7");
-		});
-
-		test("supersedeIfPending scopes to the account config", async () => {
-			const accountConfigId = harness.makeId();
-			const written = await repo.put(
-				suggestion(accountConfigId, harness.makeId(), harness.makeId(), "uid"),
-			);
-
-			assert.equal(
-				await repo.supersedeIfPending(
-					harness.makeId(),
-					written.suggestionId,
-					harness.makeId(),
-				),
-				null,
-			);
-		});
-
-		test("repointSuperseded moves a retired card to a later revision", async () => {
-			const accountConfigId = harness.makeId();
-			const written = await repo.put(
-				suggestion(accountConfigId, harness.makeId(), harness.makeId(), "uid"),
-			);
-			await repo.supersedeIfPending(
-				accountConfigId,
-				written.suggestionId,
-				harness.makeId(),
-			);
-			const newest = harness.makeId();
-
-			const repointed = await repo.repointSuperseded(
-				accountConfigId,
-				written.suggestionId,
-				newest,
-			);
-
-			assert.equal(repointed?.supersededByMessageId, newest);
-			const reread = await repo.get(accountConfigId, written.suggestionId);
-			assert.equal(reread.state, CalendarSuggestionState.Superseded);
-			assert.equal(reread.supersededByMessageId, newest);
-		});
-
-		test("repointSuperseded leaves a card that is not superseded alone", async () => {
-			const accountConfigId = harness.makeId();
-			const written = await repo.put(
-				suggestion(accountConfigId, harness.makeId(), harness.makeId(), "uid"),
-			);
-
-			assert.equal(
-				await repo.repointSuperseded(
-					accountConfigId,
-					written.suggestionId,
-					harness.makeId(),
-				),
-				null,
-			);
-			const reread = await repo.get(accountConfigId, written.suggestionId);
-			assert.equal(reread.state, CalendarSuggestionState.Pending);
-			assert.equal(reread.supersededByMessageId, "");
-		});
-
-		test("settle rejects a suggestion that is not there", async () => {
-			const accountConfigId = harness.makeId();
-			await assert.rejects(
-				() =>
-					repo.settle(accountConfigId, harness.makeId(), {
-						state: CalendarSuggestionState.Declined,
-						acceptedCalendarObjectId: "",
-					}),
-				(error: unknown) => harness.isNotFoundError(error),
-			);
-		});
-	});
-}

package/src/conformance/label.ts

@@ -1,136 +0,0 @@
-import assert from "node:assert/strict";
-import { after, before, describe, test } from "node:test";
-import { LabelColor } from "@remit/domain-enums";
-import type { ILabelRepository } from "../interfaces/label.js";
-import type { RepositoryConformanceHarness } from "./harness.js";
-
-export function labelRepositoryConformance(
-	harness: RepositoryConformanceHarness<ILabelRepository>,
-): void {
-	describe("ILabelRepository conformance", () => {
-		let repo: ILabelRepository;
-
-		before(async () => {
-			repo = await harness.createRepository();
-		});
-
-		after(() => harness.teardown());
-
-		test("create derives normalizedName and defaults color", async () => {
-			const accountConfigId = harness.makeId();
-
-			const label = await repo.create({
-				accountConfigId,
-				name: "  Receipts  ",
-			});
-
-			assert.equal(label.name, "  Receipts  ");
-			assert.equal(label.normalizedName, "receipts");
-			assert.equal(label.color, LabelColor.Default);
-		});
-
-		test("get throws a not-found error for a missing label", async () => {
-			await assert.rejects(
-				repo.get(harness.makeId(), harness.makeId()),
-				(error) => harness.isNotFoundError(error),
-			);
-		});
-
-		test("update re-derives normalizedName when the name changes", async () => {
-			const accountConfigId = harness.makeId();
-			const label = await repo.create({ accountConfigId, name: "Old Name" });
-
-			const updated = await repo.update(accountConfigId, label.labelId, {
-				name: "New Name",
-			});
-
-			assert.equal(updated.name, "New Name");
-			assert.equal(updated.normalizedName, "new name");
-		});
-
-		test("update throws a not-found error for a missing label", async () => {
-			await assert.rejects(
-				repo.update(harness.makeId(), harness.makeId(), { name: "x" }),
-				(error) => harness.isNotFoundError(error),
-			);
-		});
-
-		test("listByAccountConfig scopes to the account", async () => {
-			const accountConfigId = harness.makeId();
-			const other = harness.makeId();
-
-			const mine = await repo.create({ accountConfigId, name: "Mine" });
-			await repo.create({ accountConfigId: other, name: "Foreign" });
-
-			const labels = await repo.listByAccountConfig(accountConfigId);
-			assert.equal(labels.length, 1);
-			assert.equal(labels[0]?.labelId, mine.labelId);
-		});
-
-		test("findByNormalizedName dedupes case- and whitespace-insensitively", async () => {
-			const accountConfigId = harness.makeId();
-			const label = await repo.create({ accountConfigId, name: "Work" });
-
-			const found = await repo.findByNormalizedName(accountConfigId, "WORK");
-			assert.equal(found?.labelId, label.labelId);
-
-			const missing = await repo.findByNormalizedName(
-				accountConfigId,
-				"nonexistent",
-			);
-			assert.equal(missing, null);
-		});
-
-		test("listPageByAccountConfig pages through an account's labels, scoped to the account", async () => {
-			const accountConfigId = harness.makeId();
-			const other = harness.makeId();
-
-			// Created concurrently so their `createdAt` millisecond can tie (as it
-			// reliably does against the synchronous sqlite driver): the keyset's
-			// `labelId` tiebreak then decides order, so this asserts pagination is
-			// exhaustive and duplicate-free rather than a specific creation order.
-			const created = await Promise.all([
-				repo.create({ accountConfigId, name: "First" }),
-				repo.create({ accountConfigId, name: "Second" }),
-			]);
-			await repo.create({ accountConfigId: other, name: "Foreign" });
-
-			const page1 = await repo.listPageByAccountConfig(accountConfigId, {
-				limit: 1,
-			});
-			assert.equal(page1.items.length, 1);
-			assert.ok(page1.continuationToken);
-
-			const page2 = await repo.listPageByAccountConfig(accountConfigId, {
-				limit: 1,
-				continuationToken: page1.continuationToken,
-			});
-			assert.equal(page2.items.length, 1);
-			assert.equal(page2.continuationToken, undefined);
-
-			const seen = new Set([
-				...page1.items.map((label) => label.labelId),
-				...page2.items.map((label) => label.labelId),
-			]);
-			assert.equal(
-				seen.size,
-				created.length,
-				"every label is paged exactly once",
-			);
-			for (const label of created) {
-				assert.ok(seen.has(label.labelId));
-			}
-		});
-
-		test("delete removes the row", async () => {
-			const accountConfigId = harness.makeId();
-			const label = await repo.create({ accountConfigId, name: "Gone" });
-
-			await repo.delete(accountConfigId, label.labelId);
-
-			await assert.rejects(repo.get(accountConfigId, label.labelId), (error) =>
-				harness.isNotFoundError(error),
-			);
-		});
-	});
-}