Domain Types — Effect Coffee Shop API Reference

type DrinkId =
  | "espresso"
  | "americano"
  | "latte"
  | "cappuccino"
  | "cold-brew"
  | "tea";

type DrinkSize = "small" | "medium" | "large";

type Milk = "whole" | "oat" | "almond" | "none";

type Temperature = "hot" | "iced" | "extra-hot";

type OrderStatus =
  | "pending"
  | "brewing"
  | "ready"
  | "picked-up"
  | "cancelled";

pending ──► brewing ──► ready ──► picked-up
   │            │
   └────────────┴──► cancelled

// Validated against /^order-\d+$/
type OrderId = string; // e.g. "order-1", "order-42"

interface MenuItem {
  id: DrinkId;
  name: string;
  kind: "espresso" | "tea";
  basePriceCents: number;           // integer, US cents
  availableMilks: Milk[];
  availableTemperatures: Temperature[];
  maxShots: number;                 // integer; 0 for tea
}

interface CoffeeOrder {
  id: OrderId;
  customerName: string;
  drinkId: DrinkId;
  drinkName: string;
  size: DrinkSize;
  milk: Milk;
  temperature: Temperature;
  shots: number;            // integer
  notes?: string;
  status: OrderStatus;
  priceCents: number;       // integer, US cents
  createdAt: Date;          // UTC
}

interface PlaceOrderRequest {
  customerName: string;
  drinkId: string;
  size: string;
  milk?: string;
  temperature?: string;
  shots?: number;   // integer
  notes?: string;
}

interface ListOrdersRequest {
  status?: string;
}

class DrinkNotFoundError {
  readonly _tag: "DrinkNotFoundError";
  readonly drinkId: string;
}

class InvalidOrderInputError {
  readonly _tag: "InvalidOrderInputError";
  readonly message: string;
}

class OrderNotFoundError {
  readonly _tag: "OrderNotFoundError";
  readonly orderId: OrderId;
}

class InvalidOrderStatusTransitionError {
  readonly _tag: "InvalidOrderStatusTransitionError";
  readonly orderId: OrderId;
  readonly from: OrderStatus;
  readonly to: OrderStatus;
}

class PersistenceError {
  readonly _tag: "PersistenceError";
  readonly message: string;
  readonly cause?: unknown;
}

class InternalAppError {
  readonly _tag: "InternalAppError";
  readonly message: string;
  readonly cause?: unknown;
}