joins parser api improvements