feat: Ability to unrelate private documents from actors

[shahzadlone]

Relevant issue(s)

Resolves #2906

Description

Follow-up to #2907, the ability to delete a relationship (in order to revoke access from an identity).

CLI Demo

The following revokes the target actors 'relational' access to the private doc (can't read anymore):

defradb client acp relationship delete \
--collection Users \
--docID bae-ff3ceb1c-b5c0-5e86-a024-dd1b16a4261c \
--relation reader \
--actor did:key:z7r8os2G88XXBNBTLj3kFR5rzUJ4VAesbX7PgsA68ak9B5RYcXF5EZEmjRzzinZndPSSwujXb4XKHG6vmKEFG6ZfsfcQn \
--identity e3b722906ee4e56368f581cd8b18ab0f48af1ea53e635e3f7b8acd076676f6ac

Result:

{
  "RecordFound": true // <-------------- Indicates a relationship was found and deleted
}

How has this been tested?

CI + Integration Tests + Unit Tests

[codecov]

Codecov Report

Attention: Patch coverage is 93.42105% with 20 lines in your changes missing coverage. Please review.

Please upload report for BASE (develop@bc93bff). Learn more about missing BASE report.
Report is 1 commits behind head on develop.

Files with missing lines	Patch %	Lines
acp/acp_source_hub.go	74.19%	4 Missing and 4 partials ⚠️
http/handler_acp.go	89.47%	4 Missing and 2 partials ⚠️
http/client_acp.go	83.33%	2 Missing and 2 partials ⚠️
internal/db/db.go	90.91%	1 Missing and 1 partial ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             develop    #3099   +/-   ##
==========================================
  Coverage           ?   80.08%           
==========================================
  Files              ?      353           
  Lines              ?    28068           
  Branches           ?        0           
==========================================
  Hits               ?    22478           
  Misses             ?     4006           
  Partials           ?     1584           

Flag	Coverage Δ
all-tests	80.08% <93.42%> (?)

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines	Coverage Δ
acp/acp_local.go	97.78% <100.00%> (ø)
acp/errors.go	90.08% <100.00%> (ø)
acp/source_hub_client.go	92.92% <100.00%> (ø)
cli/acp_relationship_add.go	100.00% <100.00%> (ø)
cli/acp_relationship_delete.go	100.00% <100.00%> (ø)
cli/cli.go	100.00% <100.00%> (ø)
client/db.go	91.30% <ø> (ø)
http/openapi.go	98.10% <ø> (ø)
internal/db/db.go	66.46% <90.91%> (ø)
http/client_acp.go	83.87% <83.33%> (ø)
... and 2 more

---

Continue to review full report in Codecov by Sentry.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update bc93bff...9d7e222. Read the comment docs.

[AndrewSisley]

It looks good, but there are a couple of important todos for you before I can approve. My brain is a little foggy atm too, so it might be wise to wait for someone else to review too.

[AndrewSisley]

Looks good to me, but I would prefer you got a second reviewer to look over this one before merge :) (don't wait more than a couple of working days for that though)

[nasdf]

Two minor things to consider before merging. The documentation and tests are awesome as always!