forgejo/docs/unsure-where-to-put/adr_star_activity.md
2024-02-10 15:09:43 +01:00

1.3 KiB

# edn notation
{@context [
    "as":    "https://www.w3.org/ns/activitystreams#",
    "forge": "https://forgefed.org/ns#",],
  ::as/id "https://repo.prod.meissa.de/api/v1/activitypub/user-id/1/outbox/12345",
  ::as/type "Star",
  ::forge/source "forgejo",
  ::as/actor "https://repo.prod.meissa.de/api/v1/activitypub/user-id/1",
  ::as/object "https://codeberg.org/api/v1/activitypub/repository-id/12"
}

# json notation
{"id": "https://repo.prod.meissa.de/api/v1/activitypub/user-id/1/outbox/12345",
  "type": "Star",
  "source": "forgejo",
  "actor": "https://repo.prod.meissa.de/api/v1/activitypub/user-id/1",
  "object": "https://codeberg.org/api/v1/activitypub/repository-id/1"
}

This way of expressing stars will have the following features:

  1. !ctor & object may be dereferenced by (ap-)api
  2. The activity can be referenced itself (e.g. in order to express a result of the triggered action)
  3. Star is a special case of a Like. Star only happens in ForgeFed context. Different things should be named differnt ...
  4. With the source given it would be more easy to distinguish the uri layout for object and actor id's and make implementation more straight forward

See also:

  1. spec in clojure: https://repo.prod.meissa.de/meissa/activity-pub-poc/src/branch/forgefed_star/src/test/cljc/org/domaindrivenarchitecture/fed_poc/forgefed_test.cljc#L36-L41