tl;dr: Similar to LuaEntity.destroy() (for finite resources), but also raises the on_resource_depleted event for the marked entity.
Use case: Nougat Mining turns ore in the ground to items on the ground marked for pickup. Currently I call raise_event if the ore runs out. With this, I wouldn't have to.
