OC-1014: New endpoint to fetch user's drafts

[finlay-jisc]

The purpose of this PR was to do some back end set up for allowing octopus users to choose a draft they have access to for linking. It specified a new endpoint but it makes more sense to add an option to the existing "get user publications" endpoint to filter to initial drafts only.

The item didn't stipulate this, but non-initial drafts (version 2+) don't apply to this use case, hence the filtering by version number when the new parameter is provided.

It also needs to be able to exclude certain publications, as the user will not need to see the draft they are trying to link from in the search results.

There was version filtering in place already which is a bit confusing, but that was to return publications with at least one version matching the filter. This new filter returns publications with only 1 version which is a bit different, so I thought it made sense to be its own parameter.

---

Acceptance Criteria:

• A new endpoint fetches all drafts that the user is an author on for use on the “linked publications” section of the draft edit workflow

---

Checklist:

• Local manual testing conducted
• Automated tests added
• Documentation updated

---

Tests:

API

E2E

[karmseveeratjisc]

quite hard to read this (as evidenced by the comments needed..), could each conditional be easily separated out?

[karmseveeratjisc]

I think this flattens out as:

!account owner
{ versions: { some: { isLatestLiveVersion: true } } }

account owner + initial drafts
{ versions: { every: { currentStatus: 'DRAFT', versionNumber: 1 } } }

account owner + !initial drafts + versionStatusArray
{ versions: { some: { currentStatus: in: versionStatusArray } } }

account owner + !initial drafts + !versionStatusArray
{}

[finlay-jisc]

I'm sure they can; something like this?

    let versionStatusFilter: Prisma.PublicationWhereInput;

    if (!isAccountOwner) {
        versionStatusFilter = {
            versions: {
                some: {
                    isLatestLiveVersion: true
                }
            }
        };
    } else {
        if (initialDraftsOnly) {
            versionStatusFilter = {
                versions: {
                    every: {
                        currentStatus: 'DRAFT',
                        versionNumber: 1
                    }
                }
            };
        } else if (versionStatusArray) {
            versionStatusFilter = {
                versions: {
                    some: {
                        currentStatus: {
                            in: versionStatusArray
                        }
                    }
                }
            };
        } else {
            versionStatusFilter = {};
        }
    }

[karmseveeratjisc]

seems unnecessary and confusing to be multi line here now, it is just

{ versions: { some: { currentStatus: in: versionStatusArray } } }