[feature] Filters v1

[VyrCossont]

Description

This pull request implements a client-side filter API compatible with the Mastodon filter v1 API.

It does not implement the Mastodon filter v2 API, although it does add the DB and cache plumbing to trivially implement that API later. It also doesn't implement the server-side filtering part of the v1 API: the irreversible filter option will return an error message if set to true.

Fixes #1472

Checklist

• I/we have read the GoToSocial contribution guidelines.
• I/we have discussed the proposed changes already, either in an issue on the repository, or in the Matrix chat.
• I/we have performed a self-review of added code.
• I/we have written code that is legible and maintainable by others.
• I/we have commented the added code, particularly in hard-to-understand areas.
• I/we have made any necessary changes to documentation.
• I/we have added tests that cover new code.
• I/we have run tests and they pass locally with the changes.
• I/we have run go fmt ./... and golangci-lint run.

[VyrCossont]

There are two cache-related TODOs: one is for the multi-invalidate cache method that doesn't exist yet, and one is for cache memory ratios, which I don't understand.

The Swagger tool GtS uses seems to have a lot of bugs and omissions, so I'm not 100% on the Swagger parts.

[VyrCossont]

Using the CI for golangci-lint run because it's 100% broken on my dev box. Sorry!

[VyrCossont]

Oops, that close was entirely accidental.

[VyrCossont]

I take back my "this should work fine on 0.14"; there are some DB changes I need to rebase on top of first.

[VyrCossont]

The unused code warnings are a false positive, possibly due to dominikh/go-tools#1440, and I've fixed the issue with GoLand custom folding region comments in go-critic/go-critic#1408. For now, I've added very specific exclusions to our linter config.

I have no idea why the docs build failed, but I haven't changed anything in the docs.

[tsmethurst]

The unused code warnings are a false positive, possibly due to dominikh/go-tools#1440, and I've fixed the issue with GoLand custom folding region comments in go-critic/go-critic#1408. For now, I've added very specific exclusions to our linter config.

I have no idea why the docs build failed, but I haven't changed anything in the docs.

I'll check it out :)

[tsmethurst]

Not sure why the docs build failed, but I'll kick it :)

[daenney]

As a point of order, can we please keep the "how does this work and does it work with my favourite client" discussion to a minimum going forwards? It causes a bunch of notifications and it's not relevant to the change itself. There's a Matrix room for this kind of discussion.

[tsmethurst]

This is looking almost ready to go 👀 Just a few discussions left to resolve. Thanks for your continued hard work @VyrCossont !

[NyaaaWhatsUpDoc]

should we be expecting this as a string? this feels wrong. or is this mastodon normalized behaviour we're stuck with :p

[VyrCossont]

This is the same set of types accepted by the poll expiration time mechanism, so I assume we've seen that happen at least once 😞