Builder

class Pedido {
  constructor(
    readonly itens: string[],
    readonly cupom?: string,
    readonly embrulho = false,
  ) {}
}
// Sem builder: new Pedido(itens, undefined, true)
// — quem lê não sabe o que o "true" significa

class PedidoBuilder {
  private itens: string[] = [];
  private cupom?: string;
  private embrulho = false;

  adicionarItem(item: string): this {
    this.itens.push(item);
    return this;                    // fluent: cada passo devolve o builder
  }
  comCupom(codigo: string): this {
    this.cupom = codigo;
    return this;
  }
  paraPresente(): this {
    this.embrulho = true;
    return this;
  }
  construir(): Pedido {
    if (this.itens.length === 0) throw new Error("Pedido sem itens");
    return new Pedido([...this.itens], this.cupom, this.embrulho);
  }
}

const pedido = new PedidoBuilder()
  .adicionarItem("Camiseta P")
  .comCupom("BEMVINDO10")
  .paraPresente()
  .construir();                     // só aqui o Pedido passa a existir
console.log(pedido.embrulho);       // true — e o nome do passo explica o porquê

class Pedido:
    def __init__(self, itens, cupom=None, embrulho=False):
        self.itens = itens
        self.cupom = cupom
        self.embrulho = embrulho

class PedidoBuilder:
    def __init__(self):
        self._itens = []
        self._cupom = None
        self._embrulho = False

    def adicionar_item(self, item):
        self._itens.append(item)
        return self               # fluent: cada passo devolve o builder

    def com_cupom(self, codigo):
        self._cupom = codigo
        return self

    def para_presente(self):
        self._embrulho = True
        return self

    def construir(self):
        if not self._itens:
            raise ValueError("Pedido sem itens")
        return Pedido(list(self._itens), self._cupom, self._embrulho)

pedido = (
    PedidoBuilder()
    .adicionar_item("Camiseta P")
    .com_cupom("BEMVINDO10")
    .para_presente()
    .construir()                  # só aqui o Pedido passa a existir
)
print(pedido.embrulho)  # True