@critical-path/core 0.36.0 → 0.37.0

package/src/domain/entities.ts

@@ -1,798 +0,0 @@
-import type {
-  ProjectMember,
-  Task,
-  Project,
-  Workflow,
-  TimeEntry,
-  Priority,
-  TaskStatus,
-  TaskTodoItem,
-  CustomFieldDefinition,
-  CreateTaskInput,
-  CreateProjectInput,
-  Deliverable,
-  DeliverableStatus,
-  CreateDeliverableInput,
-  SemanticStatus
-} from '../types/index.js';
-import type {
-  DomainEvent,
-  TaskCreatedEvent,
-  TaskStatusChangedEvent,
-  TaskUpdatedEvent,
-  TimeLoggedEvent,
-  ProjectCreatedEvent,
-  DeliverableCreatedEvent,
-  DeliverableUpdatedEvent,
-  DeliverableStatusChangedEvent
-} from './events.js';
-import { validateTransition, WorkflowValidationError } from '../utils/workflow.js';
-import { resolveStatusDefinition } from '../utils/status.js';
-import { validateCustomFieldValues } from './custom-fields.js';
-import { generateProjectKey } from '../utils/key.js';
-import { ValidationError } from './errors.js';
-
-export abstract class BaseEntity {
-  public readonly id: string;
-  public createdAt: string;
-  public updatedAt: string;
-  private uncommittedEvents: DomainEvent[] = [];
-
-  constructor(id: string, createdAt?: string, updatedAt?: string) {
-    const now = new Date().toISOString();
-    this.id = id;
-    this.createdAt = createdAt || now;
-    this.updatedAt = updatedAt || now;
-  }
-
-  protected raiseEvent(event: DomainEvent): void {
-    this.uncommittedEvents.push(event);
-  }
-
-  public getUncommittedEvents(): DomainEvent[] {
-    return [...this.uncommittedEvents];
-  }
-
-  public clearEvents(): void {
-    this.uncommittedEvents = [];
-  }
-
-  protected markUpdated(): void {
-    this.updatedAt = new Date().toISOString();
-  }
-}
-
-export class TaskEntity extends BaseEntity {
-  public projectId: string;
-  public key?: string;
-  public title: string;
-  public description?: string;
-  public status: TaskStatus;
-  public semanticStatus?: SemanticStatus;
-  public priority: Priority;
-  public taskType?: string;
-  public assigneeId?: string;
-  public reporterId?: string;
-  public reviewerId?: string;
-  public iterationId?: string;
-  public teamId?: string;
-  public containerId?: string;
-  public deliverableId?: string;
-  public plannedStartDate?: string;
-  public actualStartDate?: string;
-  public actualEndDate?: string;
-  public dueDate?: string;
-  public estimatedHours?: number;
-  public loggedHours?: number;
-  public actualHours?: number;
-  public billableHours?: number;
-  public estimatedDurationMinutes?: number;
-  public actualDurationMinutes?: number;
-  public billableDurationMinutes?: number;
-  public actualDurationSeconds?: number;
-  public inProgressSince?: string | null;
-  public blockedDurationSeconds?: number;
-  public blockedSince?: string | null;
-  public progress?: number;
-  public isBlocked?: boolean;
-  public blockedReason?: string | null;
-  public tags?: string[];
-  public todos?: TaskTodoItem[];
-  public customFields?: Record<string, unknown>;
-  public parentId?: string;
-
-  constructor(data: Task) {
-    super(data.id, data.createdAt, data.updatedAt);
-    this.projectId = data.projectId;
-    this.key = data.key;
-    this.title = data.title;
-    this.description = data.description;
-    this.status = data.status;
-    this.semanticStatus = data.semanticStatus;
-    this.priority = data.priority;
-    this.taskType = data.taskType;
-    this.assigneeId = data.assigneeId;
-    this.reporterId = data.reporterId;
-    this.reviewerId = data.reviewerId;
-    this.iterationId = data.iterationId;
-    this.teamId = data.teamId;
-    this.containerId = data.containerId;
-    this.deliverableId = data.deliverableId;
-    this.plannedStartDate = data.plannedStartDate;
-    this.actualStartDate = data.actualStartDate;
-    this.actualEndDate = data.actualEndDate;
-    this.dueDate = data.dueDate;
-    this.estimatedHours = data.estimatedHours;
-    this.loggedHours = data.loggedHours ?? 0;
-    this.actualHours = data.actualHours;
-    this.billableHours = data.billableHours;
-    this.estimatedDurationMinutes = data.estimatedDurationMinutes;
-    this.actualDurationMinutes = data.actualDurationMinutes;
-    this.billableDurationMinutes = data.billableDurationMinutes;
-    this.actualDurationSeconds = data.actualDurationSeconds;
-    this.inProgressSince = data.inProgressSince;
-    this.blockedDurationSeconds = data.blockedDurationSeconds;
-    this.blockedSince = data.blockedSince;
-    this.progress = data.progress ?? 0;
-    this.isBlocked = data.isBlocked;
-    this.blockedReason = data.blockedReason;
-    this.tags = data.tags ? [...data.tags] : [];
-    this.todos = data.todos ? data.todos.map((t) => ({ ...t })) : [];
-    this.customFields = data.customFields ? { ...data.customFields } : {};
-    this.parentId = data.parentId;
-  }
-
-  public static create(
-    input: CreateTaskInput,
-    options?: { id?: string; workflow?: Workflow; customFieldDefs?: CustomFieldDefinition[] }
-  ): TaskEntity {
-    const id = options?.id || `task_${crypto.randomUUID()}`;
-    const now = new Date().toISOString();
-
-    if (options?.customFieldDefs) {
-      validateCustomFieldValues(options.customFieldDefs, input.customFields);
-    }
-
-    const status = input.status || options?.workflow?.defaultStatusKey || 'todo';
-    const statusDef = resolveStatusDefinition(status, options?.workflow?.statuses);
-    const semanticStatus = input.semanticStatus || statusDef.category;
-    const actualStartDate = input.actualStartDate ?? (semanticStatus === 'in_progress' ? now : undefined);
-    const inProgressSince = input.inProgressSince ?? (semanticStatus === 'in_progress' ? now : undefined);
-    const actualEndDate = input.actualEndDate ?? ((semanticStatus === 'completed' || semanticStatus === 'canceled') ? now : undefined);
-    const isBlocked = input.isBlocked ?? false;
-    const blockedSince = input.blockedSince ?? (isBlocked && semanticStatus === 'in_progress' ? now : undefined);
-
-    const task = new TaskEntity({
-      ...input,
-      id,
-      createdAt: now,
-      updatedAt: now,
-      status,
-      semanticStatus,
-      actualStartDate,
-      inProgressSince,
-      actualEndDate,
-      actualDurationSeconds: input.actualDurationSeconds,
-      blockedDurationSeconds: input.blockedDurationSeconds,
-      blockedSince,
-      isBlocked,
-      blockedReason: input.blockedReason ?? null,
-      priority: input.priority || 'medium',
-      loggedHours: input.loggedHours ?? 0,
-      progress: input.progress ?? 0,
-      tags: input.tags ?? [],
-      todos: input.todos ?? [],
-      customFields: input.customFields ?? {}
-    });
-
-    const createdEvent: TaskCreatedEvent = {
-      id: `evt_${crypto.randomUUID()}`,
-      name: 'task.created',
-      aggregateId: task.id,
-      aggregateType: 'Task',
-      occurredAt: now,
-      payload: { task: task.toPlain() }
-    };
-    task.raiseEvent(createdEvent);
-
-    return task;
-  }
-
-  public transitionTo(
-    newStatus: string,
-    workflow?: Workflow,
-    options?: { statusDefs?: Workflow['statuses']; actorId?: string }
-  ): this {
-    if (this.status === newStatus) return this;
-
-    const isValid = validateTransition(workflow, this.status, newStatus);
-    if (!isValid) {
-      throw new WorkflowValidationError(this.status, newStatus, workflow?.id);
-    }
-
-    const previousStatus = this.status;
-    this.status = newStatus;
-    const now = new Date().toISOString();
-
-    const statusDef = resolveStatusDefinition(newStatus, options?.statusDefs || workflow?.statuses);
-    this.semanticStatus = statusDef.category;
-
-    const prevStatusDef = resolveStatusDefinition(previousStatus, options?.statusDefs || workflow?.statuses);
-
-    // 1. Leaving in_progress: finalize current session duration
-    if (prevStatusDef.category === 'in_progress' && statusDef.category !== 'in_progress') {
-      if (this.inProgressSince) {
-        const startMs = new Date(this.inProgressSince).getTime();
-        const endMs = new Date(now).getTime();
-        if (!isNaN(startMs) && !isNaN(endMs) && endMs >= startMs) {
-          const sessionSeconds = Math.max(0, (endMs - startMs) / 1000);
-          this.actualDurationSeconds = (this.actualDurationSeconds || 0) + sessionSeconds;
-          this.actualHours = Math.round(((this.actualDurationSeconds || 0) / 3600) * 100) / 100;
-          this.actualDurationMinutes = Math.round((this.actualDurationSeconds || 0) / 60);
-        }
-        this.inProgressSince = null;
-      }
-      if (this.blockedSince) {
-        const startMs = new Date(this.blockedSince).getTime();
-        const endMs = new Date(now).getTime();
-        if (!isNaN(startMs) && !isNaN(endMs) && endMs >= startMs) {
-          const blockedSeconds = Math.max(0, (endMs - startMs) / 1000);
-          this.blockedDurationSeconds = (this.blockedDurationSeconds || 0) + blockedSeconds;
-        }
-        this.blockedSince = null;
-      }
-    }
-
-    // 2. Entering in_progress: retain earliest start date & start session timer
-    if (statusDef.category === 'in_progress') {
-      if (!this.actualStartDate) {
-        this.actualStartDate = now;
-      }
-      if (!this.inProgressSince) {
-        this.inProgressSince = now;
-      }
-      if (this.isBlocked && !this.blockedSince) {
-        this.blockedSince = now;
-      }
-      if (prevStatusDef.category === 'completed' || prevStatusDef.category === 'canceled') {
-        this.actualEndDate = undefined;
-      }
-    } else if (
-      (prevStatusDef.category === 'completed' || prevStatusDef.category === 'canceled') &&
-      statusDef.category === 'not_started'
-    ) {
-      this.actualEndDate = undefined;
-    }
-
-    // 3. Entering completed or canceled
-    if (statusDef.category === 'completed' || statusDef.category === 'canceled') {
-      if (!this.actualEndDate) {
-        this.actualEndDate = now;
-      }
-      if (statusDef.category === 'completed' && this.progress !== undefined && this.progress < 100) {
-        this.progress = 100;
-      }
-    }
-
-    this.markUpdated();
-
-    const event: TaskStatusChangedEvent = {
-      id: `evt_${crypto.randomUUID()}`,
-      name: 'task.status_changed',
-      aggregateId: this.id,
-      aggregateType: 'Task',
-      occurredAt: now,
-      payload: {
-        task: this.toPlain(),
-        previousStatus,
-        newStatus
-      }
-    };
-    this.raiseEvent(event);
-
-    return this;
-  }
-
-  public logTime(
-    entry: { hours: number; isBillable?: boolean; userId?: string; description?: string }
-  ): TimeEntry {
-    if (!Number.isFinite(entry.hours) || entry.hours <= 0) {
-      throw new ValidationError('Logged hours must be a positive number.');
-    }
-
-    this.loggedHours = (this.loggedHours || 0) + entry.hours;
-    this.actualHours = (this.actualHours || 0) + entry.hours;
-    if (entry.isBillable !== false) {
-      this.billableHours = (this.billableHours || 0) + entry.hours;
-    }
-
-    const now = new Date().toISOString();
-    this.markUpdated();
-
-    const timeEntry: TimeEntry = {
-      id: `time_${crypto.randomUUID()}`,
-      taskId: this.id,
-      userId: entry.userId || this.assigneeId || 'system',
-      hours: entry.hours,
-      isBillable: entry.isBillable ?? true,
-      description: entry.description,
-      loggedAt: now
-    };
-
-    const event: TimeLoggedEvent = {
-      id: `evt_${crypto.randomUUID()}`,
-      name: 'time.logged',
-      aggregateId: this.id,
-      aggregateType: 'Task',
-      occurredAt: now,
-      payload: {
-        taskId: this.id,
-        timeEntry
-      }
-    };
-    this.raiseEvent(event);
-
-    return timeEntry;
-  }
-
-  public addTodo(title: string, id?: string): TaskTodoItem {
-    const previous = this.toPlain();
-    const item: TaskTodoItem = {
-      id: id || `todo_${crypto.randomUUID()}`,
-      title,
-      completed: false,
-      createdAt: new Date().toISOString()
-    };
-    if (!this.todos) {
-      this.todos = [];
-    }
-    this.todos.push(item);
-    this.markUpdated();
-
-    const event: TaskUpdatedEvent = {
-      id: `evt_${crypto.randomUUID()}`,
-      name: 'task.updated',
-      aggregateId: this.id,
-      aggregateType: 'Task',
-      occurredAt: new Date().toISOString(),
-      payload: {
-        task: this.toPlain(),
-        previous
-      }
-    };
-    this.raiseEvent(event);
-
-    return item;
-  }
-
-  public toggleTodo(todoId: string, completed?: boolean): this {
-    if (!this.todos) return this;
-    const item = this.todos.find((t) => t.id === todoId);
-    if (item) {
-      const previous = this.toPlain();
-      item.completed = completed !== undefined ? completed : !item.completed;
-      item.completedAt = item.completed ? new Date().toISOString() : undefined;
-      this.markUpdated();
-
-      const event: TaskUpdatedEvent = {
-        id: `evt_${crypto.randomUUID()}`,
-        name: 'task.updated',
-        aggregateId: this.id,
-        aggregateType: 'Task',
-        occurredAt: new Date().toISOString(),
-        payload: {
-          task: this.toPlain(),
-          previous
-        }
-      };
-      this.raiseEvent(event);
-    }
-    return this;
-  }
-
-  public removeTodo(todoId: string): this {
-    if (!this.todos) return this;
-    const previous = this.toPlain();
-    this.todos = this.todos.filter((t) => t.id !== todoId);
-    this.markUpdated();
-
-    const event: TaskUpdatedEvent = {
-      id: `evt_${crypto.randomUUID()}`,
-      name: 'task.updated',
-      aggregateId: this.id,
-      aggregateType: 'Task',
-      occurredAt: new Date().toISOString(),
-      payload: {
-        task: this.toPlain(),
-        previous
-      }
-    };
-    this.raiseEvent(event);
-
-    return this;
-  }
-
-  public update(updates: Partial<Task>, customFieldDefs?: CustomFieldDefinition[]): this {
-    const previous = this.toPlain();
-
-    if (updates.customFields && customFieldDefs) {
-      validateCustomFieldValues(customFieldDefs, {
-        ...this.customFields,
-        ...updates.customFields
-      });
-    }
-
-    const wasBlocked = Boolean(this.isBlocked);
-    const isNowBlocked = updates.isBlocked !== undefined ? Boolean(updates.isBlocked) : wasBlocked;
-    const now = new Date().toISOString();
-    const effectiveSemantic = updates.semanticStatus ?? this.semanticStatus;
-
-    if (effectiveSemantic === 'in_progress') {
-      if (!wasBlocked && isNowBlocked) {
-        if (!updates.blockedSince) {
-          updates.blockedSince = now;
-        }
-      } else if (wasBlocked && !isNowBlocked) {
-        if (this.blockedSince) {
-          const startMs = new Date(this.blockedSince).getTime();
-          const endMs = new Date(now).getTime();
-          if (!isNaN(startMs) && !isNaN(endMs) && endMs >= startMs) {
-            const sessionSeconds = Math.max(0, (endMs - startMs) / 1000);
-            updates.blockedDurationSeconds =
-              (updates.blockedDurationSeconds ?? this.blockedDurationSeconds ?? 0) + sessionSeconds;
-          }
-          updates.blockedSince = null;
-        }
-      }
-    } else if (!isNowBlocked && this.blockedSince) {
-      updates.blockedSince = null;
-    }
-
-    Object.assign(this, updates);
-    if (updates.actualDurationSeconds !== undefined && updates.actualHours === undefined) {
-      this.actualHours = Math.round((updates.actualDurationSeconds / 3600) * 100) / 100;
-      this.actualDurationMinutes = updates.actualDurationMinutes ?? Math.round(updates.actualDurationSeconds / 60);
-    } else if (updates.actualHours !== undefined && updates.actualDurationSeconds === undefined) {
-      this.actualDurationSeconds = Math.round(updates.actualHours * 3600);
-      this.actualDurationMinutes = updates.actualDurationMinutes ?? Math.round(updates.actualHours * 60);
-    }
-    this.markUpdated();
-
-    const event: TaskUpdatedEvent = {
-      id: `evt_${crypto.randomUUID()}`,
-      name: 'task.updated',
-      aggregateId: this.id,
-      aggregateType: 'Task',
-      occurredAt: new Date().toISOString(),
-      payload: {
-        task: this.toPlain(),
-        previous
-      }
-    };
-    this.raiseEvent(event);
-
-    return this;
-  }
-
-  public toPlain(): Task {
-    return {
-      id: this.id,
-      projectId: this.projectId,
-      key: this.key,
-      title: this.title,
-      description: this.description,
-      status: this.status,
-      semanticStatus: this.semanticStatus,
-      priority: this.priority,
-      taskType: this.taskType,
-      assigneeId: this.assigneeId,
-      reporterId: this.reporterId,
-      reviewerId: this.reviewerId,
-      iterationId: this.iterationId,
-      teamId: this.teamId,
-      containerId: this.containerId,
-      deliverableId: this.deliverableId,
-      plannedStartDate: this.plannedStartDate,
-      actualStartDate: this.actualStartDate,
-      actualEndDate: this.actualEndDate,
-      dueDate: this.dueDate,
-      estimatedHours: this.estimatedHours,
-      loggedHours: this.loggedHours,
-      actualHours: this.actualHours,
-      billableHours: this.billableHours,
-      estimatedDurationMinutes: this.estimatedDurationMinutes,
-      actualDurationMinutes: this.actualDurationMinutes,
-      billableDurationMinutes: this.billableDurationMinutes,
-      actualDurationSeconds: this.actualDurationSeconds,
-      inProgressSince: this.inProgressSince,
-      blockedDurationSeconds: this.blockedDurationSeconds,
-      blockedSince: this.blockedSince,
-      progress: this.progress,
-      isBlocked: this.isBlocked,
-      blockedReason: this.blockedReason,
-      tags: this.tags ? [...this.tags] : [],
-      todos: this.todos ? this.todos.map((t) => ({ ...t })) : [],
-      customFields: this.customFields ? { ...this.customFields } : {},
-      parentId: this.parentId,
-      createdAt: this.createdAt,
-      updatedAt: this.updatedAt
-    };
-  }
-}
-
-export class ProjectEntity extends BaseEntity {
-  public key: string;
-  public name: string;
-  public description?: string;
-  public ownerId?: string;
-  public members?: ProjectMember[];
-  public teamIds?: string[];
-  public workflowId?: string;
-  public workflow?: Workflow;
-  public taskTypes?: Project['taskTypes'];
-  public statusDefinitions?: Project['statusDefinitions'];
-  public priorityDefinitions?: Project['priorityDefinitions'];
-  public customFieldDefinitions?: CustomFieldDefinition[];
-
-  constructor(data: Project) {
-    super(data.id, data.createdAt, data.updatedAt);
-    this.key = data.key || generateProjectKey(data.name);
-    this.name = data.name;
-    this.description = data.description;
-    this.ownerId = data.ownerId;
-    this.members = data.members ? [...data.members] : [];
-    this.teamIds = data.teamIds ? [...data.teamIds] : [];
-    this.workflowId = data.workflowId;
-    this.workflow = data.workflow;
-    this.taskTypes = data.taskTypes;
-    this.statusDefinitions = data.statusDefinitions;
-    this.priorityDefinitions = data.priorityDefinitions;
-    this.customFieldDefinitions = data.customFieldDefinitions ? [...data.customFieldDefinitions] : [];
-  }
-
-  public static create(
-    input: CreateProjectInput,
-    options?: { id?: string }
-  ): ProjectEntity {
-    const id = options?.id || `proj_${crypto.randomUUID()}`;
-    const now = new Date().toISOString();
-    const key = input.key || generateProjectKey(input.name);
-
-    const project = new ProjectEntity({
-      ...input,
-      id,
-      key,
-      createdAt: now,
-      updatedAt: now
-    });
-
-    const event: ProjectCreatedEvent = {
-      id: `evt_${crypto.randomUUID()}`,
-      name: 'project.created',
-      aggregateId: project.id,
-      aggregateType: 'Project',
-      occurredAt: now,
-      payload: { project: project.toPlain() }
-    };
-    project.raiseEvent(event);
-
-    return project;
-  }
-
-  public validateCustomFields(values?: Record<string, unknown>): void {
-    validateCustomFieldValues(this.customFieldDefinitions, values);
-  }
-
-  public toPlain(): Project {
-    return {
-      id: this.id,
-      key: this.key,
-      name: this.name,
-      description: this.description,
-      ownerId: this.ownerId,
-      members: this.members ? [...this.members] : [],
-      teamIds: this.teamIds ? [...this.teamIds] : [],
-      workflowId: this.workflowId,
-      workflow: this.workflow,
-      taskTypes: this.taskTypes,
-      statusDefinitions: this.statusDefinitions,
-      priorityDefinitions: this.priorityDefinitions,
-      customFieldDefinitions: this.customFieldDefinitions ? [...this.customFieldDefinitions] : [],
-      createdAt: this.createdAt,
-      updatedAt: this.updatedAt
-    };
-  }
-}
-
-export class DeliverableEntity extends BaseEntity {
-  public projectId: string;
-  public title: string;
-  public description?: string;
-  public status: DeliverableStatus;
-  public format?: string;
-  public specs?: Record<string, unknown>;
-  public leadId?: string;
-  public reviewerId?: string;
-  public dueDate?: string;
-  public deliveredAt?: string;
-  public outputUrls?: string[];
-  public customFields?: Record<string, unknown>;
-
-  constructor(data: Deliverable) {
-    super(data.id, data.createdAt, data.updatedAt);
-    this.projectId = data.projectId;
-    this.title = data.title;
-    this.description = data.description;
-    this.status = data.status;
-    this.format = data.format;
-    this.specs = data.specs ? { ...data.specs } : undefined;
-    this.leadId = data.leadId;
-    this.reviewerId = data.reviewerId;
-    this.dueDate = data.dueDate;
-    this.deliveredAt = data.deliveredAt;
-    this.outputUrls = data.outputUrls ? [...data.outputUrls] : [];
-    this.customFields = data.customFields ? { ...data.customFields } : {};
-  }
-
-  public static create(
-    input: CreateDeliverableInput,
-    options?: { id?: string; customFieldDefs?: CustomFieldDefinition[] }
-  ): DeliverableEntity {
-    const id = options?.id || `deliv_${crypto.randomUUID()}`;
-    const now = new Date().toISOString();
-
-    if (options?.customFieldDefs) {
-      validateCustomFieldValues(options.customFieldDefs, input.customFields);
-    }
-
-    const deliverable = new DeliverableEntity({
-      ...input,
-      id,
-      createdAt: now,
-      updatedAt: now,
-      status: input.status || 'planned',
-      outputUrls: input.outputUrls ?? [],
-      customFields: input.customFields ?? {}
-    });
-
-    const createdEvent: DeliverableCreatedEvent = {
-      id: `evt_${crypto.randomUUID()}`,
-      name: 'deliverable.created',
-      aggregateId: deliverable.id,
-      aggregateType: 'Deliverable',
-      occurredAt: now,
-      payload: { deliverable: deliverable.toPlain() }
-    };
-    deliverable.raiseEvent(createdEvent);
-
-    return deliverable;
-  }
-
-  public transitionTo(newStatus: DeliverableStatus): this {
-    if (this.status === newStatus) return this;
-
-    const previousStatus = this.status;
-    this.status = newStatus;
-    const now = new Date().toISOString();
-
-    if (newStatus === 'delivered' && !this.deliveredAt) {
-      this.deliveredAt = now;
-    }
-
-    this.markUpdated();
-
-    const event: DeliverableStatusChangedEvent = {
-      id: `evt_${crypto.randomUUID()}`,
-      name: 'deliverable.status_changed',
-      aggregateId: this.id,
-      aggregateType: 'Deliverable',
-      occurredAt: now,
-      payload: {
-        deliverable: this.toPlain(),
-        previousStatus,
-        newStatus
-      }
-    };
-    this.raiseEvent(event);
-
-    return this;
-  }
-
-  public addOutputUrl(url: string): this {
-    if (!this.outputUrls) {
-      this.outputUrls = [];
-    }
-    if (!this.outputUrls.includes(url)) {
-      const previous = this.toPlain();
-      this.outputUrls.push(url);
-      this.markUpdated();
-
-      const event: DeliverableUpdatedEvent = {
-        id: `evt_${crypto.randomUUID()}`,
-        name: 'deliverable.updated',
-        aggregateId: this.id,
-        aggregateType: 'Deliverable',
-        occurredAt: new Date().toISOString(),
-        payload: {
-          deliverable: this.toPlain(),
-          previous
-        }
-      };
-      this.raiseEvent(event);
-    }
-    return this;
-  }
-
-  public update(updates: Partial<Deliverable>, customFieldDefs?: CustomFieldDefinition[]): this {
-    const previous = this.toPlain();
-
-    if (updates.customFields && customFieldDefs) {
-      validateCustomFieldValues(customFieldDefs, {
-        ...this.customFields,
-        ...updates.customFields
-      });
-    }
-
-    if (updates.status && updates.status !== this.status) {
-      this.transitionTo(updates.status);
-      delete updates.status;
-    }
-
-    Object.assign(this, updates);
-    this.markUpdated();
-
-    const event: DeliverableUpdatedEvent = {
-      id: `evt_${crypto.randomUUID()}`,
-      name: 'deliverable.updated',
-      aggregateId: this.id,
-      aggregateType: 'Deliverable',
-      occurredAt: new Date().toISOString(),
-      payload: {
-        deliverable: this.toPlain(),
-        previous
-      }
-    };
-    this.raiseEvent(event);
-
-    return this;
-  }
-
-  public toPlain(): Deliverable {
-    return {
-      id: this.id,
-      projectId: this.projectId,
-      title: this.title,
-      description: this.description,
-      status: this.status,
-      format: this.format,
-      specs: this.specs ? { ...this.specs } : undefined,
-      leadId: this.leadId,
-      reviewerId: this.reviewerId,
-      dueDate: this.dueDate,
-      deliveredAt: this.deliveredAt,
-      outputUrls: this.outputUrls ? [...this.outputUrls] : [],
-      customFields: this.customFields ? { ...this.customFields } : {},
-      createdAt: this.createdAt,
-      updatedAt: this.updatedAt
-    };
-  }
-}
-
-export class AttachmentValidationError extends Error {
-  constructor(message: string) {
-    super(message);
-    this.name = 'AttachmentValidationError';
-  }
-}
-
-export function validateAttachmentUrl(url?: string): void {
-  if (!url || typeof url !== 'string' || url.trim() === '') {
-    throw new AttachmentValidationError('Attachment URL must be a non-empty string.');
-  }
-  if (url.startsWith('data:') && url.length > 2048) {
-    throw new AttachmentValidationError(
-      'Attachment URL cannot be a large data URI. Please upload the file using a FileStorageAdapter or Cloud Storage and provide the resulting URL.'
-    );
-  }
-}
-