@alistigo/domain 0.2.2

package/README.md

@@ -0,0 +1,15 @@
+# @alistigo/domain
+
+> TODO: describe this package.
+
+## Install
+
+```sh
+pnpm add @alistigo/domain
+```
+
+## Usage
+
+```ts
+import {} from "@alistigo/domain";
+```

package/dist/__tests__/list-aggregate.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=list-aggregate.test.d.ts.map

package/dist/__tests__/list-aggregate.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-aggregate.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/list-aggregate.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/list-aggregate.test.js

@@ -0,0 +1,213 @@
+import { describe, expect, it } from "bun:test";
+import { List } from "../aggregates/list.js";
+import { ListElementNotFoundError, ListError } from "../errors/list-error.js";
+import { generateActorId } from "../value-objects/actor-id.js";
+import { createListElementContent } from "../value-objects/list-element-content.js";
+import { generateListId } from "../value-objects/list-id.js";
+// Helper: create a minimal actor id for tests
+const actorId = generateActorId();
+describe("List.create", () => {
+    it("creates a List with generated ListId when none provided", () => {
+        const { list, event } = List.create({ actorId });
+        expect(list.id).toBeDefined();
+        expect(list.id.getType()).toBe("lst");
+        expect(event.type).toBe("ListCreated");
+        expect(event.listId).toBe(list.id);
+        expect(event.actorId).toBe(actorId);
+    });
+    it("creates a List with the provided ListId", () => {
+        const listId = generateListId();
+        const { list, event } = List.create({ actorId, listId });
+        expect(list.id).toBe(listId);
+        expect(event.listId).toBe(listId);
+    });
+    it("creates a List with title when provided", () => {
+        const { list, event } = List.create({ actorId, title: "My List" });
+        expect(list.title).toBe("My List");
+        expect(event.title).toBe("My List");
+    });
+    it("creates a List with no title when none provided", () => {
+        const { list } = List.create({ actorId });
+        expect(list.title).toBeUndefined();
+    });
+    it("starts with an empty elements array", () => {
+        const { list } = List.create({ actorId });
+        expect(list.elements).toHaveLength(0);
+    });
+    it("has one uncommitted event after creation", () => {
+        const { list } = List.create({ actorId });
+        const events = list.getUncommittedEvents();
+        expect(events).toHaveLength(1);
+        expect(events[0]?.type).toBe("ListCreated");
+    });
+});
+describe("List.addListElement", () => {
+    it("appends a new element and emits ListElementAdded", () => {
+        const { list } = List.create({ actorId });
+        const content = createListElementContent("Buy milk");
+        const event = list.addListElement({ actorId, listId: list.id, content });
+        expect(event.type).toBe("ListElementAdded");
+        expect(event.content).toBe(content);
+        expect(event.listElementId.getType()).toBe("lse");
+        expect(list.elements).toHaveLength(1);
+    });
+    it("each element gets a unique ListElementId", () => {
+        const { list } = List.create({ actorId });
+        const content = createListElementContent("Item");
+        const e1 = list.addListElement({ actorId, listId: list.id, content });
+        const e2 = list.addListElement({ actorId, listId: list.id, content });
+        expect(e1.listElementId.toString()).not.toBe(e2.listElementId.toString());
+    });
+    it("allows duplicate content (identity is not content-based)", () => {
+        const { list } = List.create({ actorId });
+        const content = createListElementContent("Duplicate");
+        list.addListElement({ actorId, listId: list.id, content });
+        list.addListElement({ actorId, listId: list.id, content });
+        expect(list.elements).toHaveLength(2);
+    });
+    it("preserves insertion order", () => {
+        const { list } = List.create({ actorId });
+        const c1 = createListElementContent("First");
+        const c2 = createListElementContent("Second");
+        const c3 = createListElementContent("Third");
+        list.addListElement({ actorId, listId: list.id, content: c1 });
+        list.addListElement({ actorId, listId: list.id, content: c2 });
+        list.addListElement({ actorId, listId: list.id, content: c3 });
+        const elements = list.elements;
+        expect(elements[0]?.content).toBe("First");
+        expect(elements[1]?.content).toBe("Second");
+        expect(elements[2]?.content).toBe("Third");
+    });
+    it("records addedAt timestamp on the element", () => {
+        const { list } = List.create({ actorId });
+        const content = createListElementContent("Item");
+        const event = list.addListElement({ actorId, listId: list.id, content });
+        const element = list.elements[0];
+        expect(element?.addedAt).toBe(event.timestamp);
+    });
+});
+describe("List.deleteListElement", () => {
+    it("removes an element and emits ListElementDeleted", () => {
+        const { list } = List.create({ actorId });
+        const content = createListElementContent("To delete");
+        const addEvent = list.addListElement({ actorId, listId: list.id, content });
+        const deleteEvent = list.deleteListElement({
+            actorId,
+            listId: list.id,
+            listElementId: addEvent.listElementId,
+        });
+        expect(deleteEvent.type).toBe("ListElementDeleted");
+        expect(deleteEvent.listElementId).toBe(addEvent.listElementId);
+        expect(list.elements).toHaveLength(0);
+    });
+    it("throws ListElementNotFoundError when listElementId does not exist", () => {
+        const { list } = List.create({ actorId });
+        const foreignId = generateListId();
+        // Use a foreign TypeID cast as lse — the element simply won't exist
+        const { list: list2 } = List.create({ actorId });
+        const content = createListElementContent("Other");
+        const addEvent = list2.addListElement({ actorId, listId: list2.id, content });
+        // addEvent.listElementId is valid but belongs to list2, not list
+        expect(() => list.deleteListElement({
+            actorId,
+            listId: list.id,
+            listElementId: addEvent.listElementId,
+        })).toThrow(ListElementNotFoundError);
+        // foreignId is ListId type, suppress lint; test just verifies error type above
+        void foreignId;
+    });
+    it("does not allow reuse of a deleted ListElementId", () => {
+        const { list } = List.create({ actorId });
+        const content = createListElementContent("To delete");
+        const addEvent = list.addListElement({ actorId, listId: list.id, content });
+        list.deleteListElement({
+            actorId,
+            listId: list.id,
+            listElementId: addEvent.listElementId,
+        });
+        // Trying to delete the same element again should throw
+        expect(() => list.deleteListElement({
+            actorId,
+            listId: list.id,
+            listElementId: addEvent.listElementId,
+        })).toThrow(ListElementNotFoundError);
+    });
+});
+describe("List.exportListDocument", () => {
+    it("emits ListExported event with json-ld format", () => {
+        const { list } = List.create({ actorId });
+        const event = list.exportListDocument({ actorId, listId: list.id });
+        expect(event.type).toBe("ListExported");
+        expect(event.format).toBe("json-ld");
+        expect(event.actorId).toBe(actorId);
+    });
+    it("export is always valid even on an empty list", () => {
+        const { list } = List.create({ actorId });
+        expect(() => list.exportListDocument({ actorId, listId: list.id })).not.toThrow();
+    });
+});
+describe("List.getUncommittedEvents", () => {
+    it("tracks all events since creation", () => {
+        const { list } = List.create({ actorId });
+        const content = createListElementContent("Item");
+        const addEvent = list.addListElement({ actorId, listId: list.id, content });
+        list.deleteListElement({ actorId, listId: list.id, listElementId: addEvent.listElementId });
+        const events = list.getUncommittedEvents();
+        expect(events).toHaveLength(3); // ListCreated + ListElementAdded + ListElementDeleted
+        expect(events[0]?.type).toBe("ListCreated");
+        expect(events[1]?.type).toBe("ListElementAdded");
+        expect(events[2]?.type).toBe("ListElementDeleted");
+    });
+    it("clears after markEventsAsCommitted", () => {
+        const { list } = List.create({ actorId });
+        list.markEventsAsCommitted();
+        expect(list.getUncommittedEvents()).toHaveLength(0);
+    });
+});
+describe("List.rehydrate", () => {
+    it("reconstructs state from event log", () => {
+        const { list } = List.create({ actorId });
+        const content1 = createListElementContent("First");
+        const content2 = createListElementContent("Second");
+        const addEvent1 = list.addListElement({ actorId, listId: list.id, content: content1 });
+        list.addListElement({ actorId, listId: list.id, content: content2 });
+        list.deleteListElement({ actorId, listId: list.id, listElementId: addEvent1.listElementId });
+        const events = list.getUncommittedEvents();
+        const rehydrated = List.rehydrate(list.id, [...events]);
+        expect(rehydrated.elements).toHaveLength(1);
+        expect(rehydrated.elements[0]?.content).toBe("Second");
+    });
+    it("rehydrated list has no uncommitted events", () => {
+        const { list } = List.create({ actorId });
+        const events = list.getUncommittedEvents();
+        const rehydrated = List.rehydrate(list.id, [...events]);
+        expect(rehydrated.getUncommittedEvents()).toHaveLength(0);
+    });
+    it("rehydrates title from ListCreated event", () => {
+        const { list } = List.create({ actorId, title: "My List" });
+        const events = list.getUncommittedEvents();
+        const rehydrated = List.rehydrate(list.id, [...events]);
+        expect(rehydrated.title).toBe("My List");
+    });
+    it("ListExported is an audit-only event — no state change on rehydrate", () => {
+        const { list } = List.create({ actorId });
+        list.exportListDocument({ actorId, listId: list.id });
+        const events = list.getUncommittedEvents();
+        const rehydrated = List.rehydrate(list.id, [...events]);
+        expect(rehydrated.elements).toHaveLength(0);
+    });
+});
+describe("Errors", () => {
+    it("ListError is instanceof Error", () => {
+        const err = new ListError("test");
+        expect(err).toBeInstanceOf(Error);
+        expect(err).toBeInstanceOf(ListError);
+        expect(err.message).toBe("test");
+    });
+    it("ListElementNotFoundError is instanceof ListError", () => {
+        const err = new ListElementNotFoundError("lse_abc");
+        expect(err).toBeInstanceOf(ListError);
+        expect(err).toBeInstanceOf(ListElementNotFoundError);
+    });
+});
+//# sourceMappingURL=list-aggregate.test.js.map

package/dist/__tests__/list-aggregate.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-aggregate.test.js","sourceRoot":"","sources":["../../src/__tests__/list-aggregate.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/value-objects.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=value-objects.test.d.ts.map

package/dist/__tests__/value-objects.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-objects.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/value-objects.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/value-objects.test.js

@@ -0,0 +1,77 @@
+import { describe, expect, it } from "bun:test";
+import { ListError } from "../errors/list-error.js";
+import { parseActorId } from "../value-objects/actor-id.js";
+import { createListElementContent } from "../value-objects/list-element-content.js";
+import { parseListElementId } from "../value-objects/list-element-id.js";
+import { parseListEventId } from "../value-objects/list-event-id.js";
+import { parseListId } from "../value-objects/list-id.js";
+import { CURRENT_SCHEMA_VERSION, createSchemaVersion } from "../value-objects/schema-version.js";
+import { createTimestamp } from "../value-objects/timestamp.js";
+describe("ListElementContent", () => {
+    it("accepts non-empty trimmed string", () => {
+        const content = createListElementContent("Buy milk");
+        expect(content).toBe("Buy milk");
+    });
+    it("trims surrounding whitespace", () => {
+        const content = createListElementContent("  Buy milk  ");
+        expect(content).toBe("Buy milk");
+    });
+    it("throws ListError on empty string", () => {
+        expect(() => createListElementContent("")).toThrow(ListError);
+    });
+    it("throws ListError on whitespace-only string", () => {
+        expect(() => createListElementContent("   ")).toThrow(ListError);
+    });
+    it("throws ListError when exceeding 2000 characters", () => {
+        const long = "a".repeat(2001);
+        expect(() => createListElementContent(long)).toThrow(ListError);
+    });
+    it("accepts a string of exactly 2000 characters", () => {
+        const exact = "a".repeat(2000);
+        expect(() => createListElementContent(exact)).not.toThrow();
+    });
+});
+describe("Timestamp", () => {
+    it("accepts a valid ISO 8601 UTC string", () => {
+        const ts = createTimestamp("2026-05-14T10:00:00Z");
+        expect(ts).toBe("2026-05-14T10:00:00Z");
+    });
+    it("throws ListError on invalid date string", () => {
+        expect(() => createTimestamp("not-a-date")).toThrow(ListError);
+    });
+});
+describe("SchemaVersion", () => {
+    it("accepts a valid semver string", () => {
+        const v = createSchemaVersion("1.0.0");
+        expect(v).toBe("1.0.0");
+    });
+    it("throws ListError on non-semver string", () => {
+        expect(() => createSchemaVersion("1.0")).toThrow(ListError);
+        expect(() => createSchemaVersion("v1.0.0")).toThrow(ListError);
+    });
+    it("exports the correct M1 version", () => {
+        expect(CURRENT_SCHEMA_VERSION).toBe("1.0.0");
+    });
+});
+describe("TypeID value objects", () => {
+    it("parseListId parses a valid lst TypeID string", () => {
+        const id = parseListId("lst_00000000000000000000000001");
+        expect(id.getType()).toBe("lst");
+    });
+    it("parseListId throws on wrong prefix", () => {
+        expect(() => parseListId("lse_00000000000000000000000001")).toThrow();
+    });
+    it("parseListElementId parses a valid lse TypeID string", () => {
+        const id = parseListElementId("lse_00000000000000000000000001");
+        expect(id.getType()).toBe("lse");
+    });
+    it("parseListEventId parses a valid lev TypeID string", () => {
+        const id = parseListEventId("lev_00000000000000000000000001");
+        expect(id.getType()).toBe("lev");
+    });
+    it("parseActorId parses a valid act TypeID string", () => {
+        const id = parseActorId("act_00000000000000000000000001");
+        expect(id.getType()).toBe("act");
+    });
+});
+//# sourceMappingURL=value-objects.test.js.map

package/dist/__tests__/value-objects.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-objects.test.js","sourceRoot":"","sources":["../../src/__tests__/value-objects.test.ts"],"names":[],"mappings":"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"}

package/dist/aggregates/list.d.ts

@@ -0,0 +1,59 @@
+import type { AddListElement } from "../commands/add-list-element.js";
+import type { CreateList } from "../commands/create-list.js";
+import type { DeleteListElement } from "../commands/delete-list-element.js";
+import type { ExportListDocument } from "../commands/export-list-document.js";
+import type { ListElement } from "../entities/list-element.js";
+import type { ListCreated } from "../events/list-created.js";
+import type { ListElementAdded } from "../events/list-element-added.js";
+import type { ListElementDeleted } from "../events/list-element-deleted.js";
+import type { ListEvent } from "../events/list-event.js";
+import type { ListExported } from "../events/list-exported.js";
+import type { ListId } from "../value-objects/list-id.js";
+/**
+ * List aggregate root.
+ *
+ * - Private constructor: use List.create() or List.rehydrate().
+ * - All state changes flow through command handlers which emit events.
+ * - applyEvent() is the only method that mutates internal state.
+ */
+export declare class List {
+    #private;
+    private constructor();
+    get id(): ListId;
+    get title(): string | undefined;
+    get elements(): ReadonlyArray<ListElement>;
+    /**
+     * Creates a new List aggregate and emits ListCreated.
+     * Generates a ListId if not provided in the command.
+     */
+    static create(cmd: CreateList): {
+        list: List;
+        event: ListCreated;
+    };
+    /**
+     * Reconstructs a List from its full event log.
+     * The resulting List has no uncommitted events.
+     */
+    static rehydrate(id: ListId, events: ListEvent[]): List;
+    /**
+     * Appends a new ListElement to the List.
+     * Invariant: content must be non-empty after trimming (enforced at ListElementContent creation).
+     */
+    addListElement(cmd: AddListElement): ListElementAdded;
+    /**
+     * Removes a ListElement from the List by its stable identity.
+     * Invariant: the ListElementId must exist in the current elements.
+     * Throws ListElementNotFoundError if not found.
+     */
+    deleteListElement(cmd: DeleteListElement): ListElementDeleted;
+    /**
+     * Emits a ListExported audit event.
+     * Export is always valid — no invariants to check.
+     */
+    exportListDocument(cmd: ExportListDocument): ListExported;
+    /** Returns all events emitted since the last load/save. */
+    getUncommittedEvents(): ReadonlyArray<ListEvent>;
+    /** Clears uncommitted events after they have been persisted. */
+    markEventsAsCommitted(): void;
+}
+//# sourceMappingURL=list.d.ts.map

package/dist/aggregates/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/aggregates/list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAI1D;;;;;;GAMG;AACH,qBAAa,IAAI;;IAMf,OAAO;IAOP,IAAI,EAAE,IAAI,MAAM,CAEf;IAED,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAE9B;IAED,IAAI,QAAQ,IAAI,aAAa,CAAC,WAAW,CAAC,CAEzC;IAID;;;OAGG;IACH,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,KAAK,EAAE,WAAW,CAAA;KAAE;IAoBlE;;;OAGG;IACH,MAAM,CAAC,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI;IAUvD;;;OAGG;IACH,cAAc,CAAC,GAAG,EAAE,cAAc,GAAG,gBAAgB;IAkBrD;;;;OAIG;IACH,iBAAiB,CAAC,GAAG,EAAE,iBAAiB,GAAG,kBAAkB;IAoB7D;;;OAGG;IACH,kBAAkB,CAAC,GAAG,EAAE,kBAAkB,GAAG,YAAY;IAiBzD,2DAA2D;IAC3D,oBAAoB,IAAI,aAAa,CAAC,SAAS,CAAC;IAIhD,gEAAgE;IAChE,qBAAqB,IAAI,IAAI;CA4B9B"}

package/dist/aggregates/list.js

@@ -0,0 +1,157 @@
+import { ListElementNotFoundError } from "../errors/list-error.js";
+import { generateListElementId } from "../value-objects/list-element-id.js";
+import { generateListEventId } from "../value-objects/list-event-id.js";
+import { generateListId } from "../value-objects/list-id.js";
+import { nowTimestamp } from "../value-objects/timestamp.js";
+/**
+ * List aggregate root.
+ *
+ * - Private constructor: use List.create() or List.rehydrate().
+ * - All state changes flow through command handlers which emit events.
+ * - applyEvent() is the only method that mutates internal state.
+ */
+export class List {
+    #id;
+    #title;
+    #elements;
+    #uncommittedEvents;
+    constructor(id) {
+        this.#id = id;
+        this.#title = undefined;
+        this.#elements = new Map();
+        this.#uncommittedEvents = [];
+    }
+    get id() {
+        return this.#id;
+    }
+    get title() {
+        return this.#title;
+    }
+    get elements() {
+        return [...this.#elements.values()];
+    }
+    // ─────────────────────────────────────────────── Factory
+    /**
+     * Creates a new List aggregate and emits ListCreated.
+     * Generates a ListId if not provided in the command.
+     */
+    static create(cmd) {
+        const listId = cmd.listId ?? generateListId();
+        const list = new List(listId);
+        const event = {
+            type: "ListCreated",
+            listEventId: generateListEventId(),
+            listId,
+            actorId: cmd.actorId,
+            timestamp: nowTimestamp(),
+            ...(cmd.title !== undefined ? { title: cmd.title } : {}),
+        };
+        list.#applyEvent(event);
+        list.#uncommittedEvents.push(event);
+        return { list, event };
+    }
+    // ─────────────────────────────────────────────── Rehydration
+    /**
+     * Reconstructs a List from its full event log.
+     * The resulting List has no uncommitted events.
+     */
+    static rehydrate(id, events) {
+        const list = new List(id);
+        for (const event of events) {
+            list.#applyEvent(event);
+        }
+        return list;
+    }
+    // ─────────────────────────────────────────────── Command Handlers
+    /**
+     * Appends a new ListElement to the List.
+     * Invariant: content must be non-empty after trimming (enforced at ListElementContent creation).
+     */
+    addListElement(cmd) {
+        const listElementId = generateListElementId();
+        const event = {
+            type: "ListElementAdded",
+            listEventId: generateListEventId(),
+            listId: this.#id,
+            actorId: cmd.actorId,
+            timestamp: nowTimestamp(),
+            listElementId,
+            content: cmd.content,
+        };
+        this.#applyEvent(event);
+        this.#uncommittedEvents.push(event);
+        return event;
+    }
+    /**
+     * Removes a ListElement from the List by its stable identity.
+     * Invariant: the ListElementId must exist in the current elements.
+     * Throws ListElementNotFoundError if not found.
+     */
+    deleteListElement(cmd) {
+        const idStr = cmd.listElementId.toString();
+        if (!this.#elements.has(idStr)) {
+            throw new ListElementNotFoundError(idStr);
+        }
+        const event = {
+            type: "ListElementDeleted",
+            listEventId: generateListEventId(),
+            listId: this.#id,
+            actorId: cmd.actorId,
+            timestamp: nowTimestamp(),
+            listElementId: cmd.listElementId,
+        };
+        this.#applyEvent(event);
+        this.#uncommittedEvents.push(event);
+        return event;
+    }
+    /**
+     * Emits a ListExported audit event.
+     * Export is always valid — no invariants to check.
+     */
+    exportListDocument(cmd) {
+        const event = {
+            type: "ListExported",
+            listEventId: generateListEventId(),
+            listId: this.#id,
+            actorId: cmd.actorId,
+            timestamp: nowTimestamp(),
+            format: "json-ld",
+        };
+        this.#applyEvent(event);
+        this.#uncommittedEvents.push(event);
+        return event;
+    }
+    // ─────────────────────────────────────────────── Uncommitted Events
+    /** Returns all events emitted since the last load/save. */
+    getUncommittedEvents() {
+        return [...this.#uncommittedEvents];
+    }
+    /** Clears uncommitted events after they have been persisted. */
+    markEventsAsCommitted() {
+        this.#uncommittedEvents.length = 0;
+    }
+    // ─────────────────────────────────────────────── Private State Mutation
+    /** Mutates state from a single event. Used by both command handlers and rehydration. */
+    #applyEvent(event) {
+        const handlers = {
+            ListCreated: (e) => {
+                this.#title = e.title;
+            },
+            ListElementAdded: (e) => {
+                this.#elements.set(e.listElementId.toString(), {
+                    id: e.listElementId,
+                    content: e.content,
+                    addedAt: e.timestamp,
+                });
+            },
+            ListElementDeleted: (e) => {
+                this.#elements.delete(e.listElementId.toString());
+            },
+            // Audit-only event — no state change
+            ListExported: (_e) => { },
+        };
+        // biome-ignore lint/suspicious/noExplicitAny: safe — handler key is narrowed by event.type
+        handlers[event.type](event);
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/aggregates/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/aggregates/list.ts"],"names":[],"mappings":"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"}

package/dist/commands/actor-command.d.ts

@@ -0,0 +1,6 @@
+import type { ActorId } from "../value-objects/actor-id.js";
+/** Abstract base for all commands. Carries actorId — who is issuing the command. */
+export interface ActorCommand {
+    readonly actorId: ActorId;
+}
+//# sourceMappingURL=actor-command.d.ts.map

package/dist/commands/actor-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actor-command.d.ts","sourceRoot":"","sources":["../../src/commands/actor-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAE5D,oFAAoF;AACpF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B"}

package/dist/commands/actor-command.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=actor-command.js.map

package/dist/commands/actor-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actor-command.js","sourceRoot":"","sources":["../../src/commands/actor-command.ts"],"names":[],"mappings":""}

package/dist/commands/actor-list-command.d.ts

@@ -0,0 +1,7 @@
+import type { ListId } from "../value-objects/list-id.js";
+import type { ActorCommand } from "./actor-command.js";
+/** Abstract base for all commands that operate on an existing List. */
+export interface ActorListCommand extends ActorCommand {
+    readonly listId: ListId;
+}
+//# sourceMappingURL=actor-list-command.d.ts.map

package/dist/commands/actor-list-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actor-list-command.d.ts","sourceRoot":"","sources":["../../src/commands/actor-list-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,uEAAuE;AACvE,MAAM,WAAW,gBAAiB,SAAQ,YAAY;IACpD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB"}

package/dist/commands/actor-list-command.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=actor-list-command.js.map

package/dist/commands/actor-list-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actor-list-command.js","sourceRoot":"","sources":["../../src/commands/actor-list-command.ts"],"names":[],"mappings":""}

package/dist/commands/add-list-element.d.ts

@@ -0,0 +1,7 @@
+import type { ListElementContent } from "../value-objects/list-element-content.js";
+import type { ActorListCommand } from "./actor-list-command.js";
+/** Command to append a new ListElement to a List. */
+export interface AddListElement extends ActorListCommand {
+    readonly content: ListElementContent;
+}
+//# sourceMappingURL=add-list-element.d.ts.map

package/dist/commands/add-list-element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-list-element.d.ts","sourceRoot":"","sources":["../../src/commands/add-list-element.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AACnF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,qDAAqD;AACrD,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACtD,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;CACtC"}

package/dist/commands/add-list-element.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=add-list-element.js.map

package/dist/commands/add-list-element.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-list-element.js","sourceRoot":"","sources":["../../src/commands/add-list-element.ts"],"names":[],"mappings":""}