feat: add matrix-auth integration

[amandahla]

Applicable spec:

Overview

Add matrix-auth integration that allows integrate Maubot with Synapse.

Rationale

The first step to install a bot is create a client.

A client requires that the homeserver is configured in the Maubot configuration file.

Once is there, the user will run an action "register-client-account" that will create a user and return an access token and a device id.

See here for the entire flow:
https://docs.mau.fi/maubot/usage/basic.html#creating-clients

Extra:

• If the integrations PostgreSQL and/or matrix-auth relation data are not found, the charm is blocked and if the service is running, is stopped. Thanks @javierdelapuente for spotting this
• Integration test will be added once Synapse provides the matrix-auth endpoint.

Juju Events Changes

_on_matrix_auth_request_processed

Module Changes

Library Changes

Matrix auth library.

Checklist

• The charm style guide was applied
• The contributing guide was applied
• The changes are compliant with ISD054 - Managing Charm Complexity
• The documentation is generated using src-docs
• The documentation for charmhub is updated
• The PR is tagged with appropriate label (urgent, trivial, complex)

No CH available yet.

[cbartz]

Thank you. I have some comments/questions ;-)

[javierdelapuente]

A couple of comments/questions

[jdkandersson]

I haven't finished the review. I have left some comments that may be applicable in the rest of the code. Let's discuss these initially, potentially update the rest of the code and then we can look at the rest

[github-actions]

Test coverage for 52da8a6

Name           Stmts   Miss Branch BrPart  Cover   Missing
----------------------------------------------------------
src/charm.py     130     11     22      6    89%   129-131, 149, 153, 175, 179, 197, 224, 229, 251
----------------------------------------------------------
TOTAL            130     11     22      6    89%

Static code analysis report

Run started:2024-10-11 16:28:22.123919

Test results:
  No issues identified.

Code scanned:
  Total lines of code: 545
  Total lines skipped (#nosec): 0
  Total potential issues skipped due to specifically being disabled (e.g., #nosec BXXX): 0

Run metrics:
  Total issues (by severity):
  	Undefined: 0
  	Low: 0
  	Medium: 0
  	High: 0
  Total issues (by confidence):
  	Undefined: 0
  	Low: 0
  	Medium: 0
  	High: 0
Files skipped (0):

[Thanhphan1147]

LGTM, some minor comments