Handle creating bookmarks for the user. Bookmarks are in three tables and should be thought of as a tuple of (model, model-id) rather than a row in a table with an id. The DELETE takes the model and id because DELETE's do not necessarily support request bodies. The POST is therefore shaped in this same manner. Since there are three underlying tables the id on the actual bookmark itself is not unique among "bookmarks" and is not a good identifier for using in the API. | (ns metabase.bookmarks.api (:require [metabase.api.common :as api] [metabase.api.macros :as api.macros] [metabase.bookmarks.models.bookmark :as bookmark] [metabase.util.malli.schema :as ms] [toucan2.core :as t2])) |
Schema enumerating bookmarkable models. | (def Models (into [:enum] ["card" "dashboard" "collection"])) |
Schema for an ordered of boomark orderings | (def BookmarkOrderings
[:sequential [:map
[:type Models]
[:item_id ms/PositiveInt]]]) |
Lookup map from model as a string to [model bookmark-model item-id-key]. | (def ^:private lookup
{"card" [:model/Card :model/CardBookmark :card_id]
"dashboard" [:model/Dashboard :model/DashboardBookmark :dashboard_id]
"collection" [:model/Collection :model/CollectionBookmark :collection_id]}) |
(api.macros/defendpoint :get "/" "Fetch all bookmarks for the user" [] ;; already sorted by created_at in query. Can optionally use user sort preferences here and not in the function ;; below (bookmark/bookmarks-for-user api/*current-user-id*)) | |
(api.macros/defendpoint :post "/:model/:id"
"Create a new bookmark for user."
[{:keys [model id]} :- [:map
[:model Models]
[:id ms/PositiveInt]]]
(let [[item-model bookmark-model item-key] (lookup model)]
(api/read-check item-model id)
(api/check (not (t2/exists? bookmark-model item-key id
:user_id api/*current-user-id*))
[400 "Bookmark already exists"])
(first (t2/insert-returning-instances! bookmark-model {item-key id :user_id api/*current-user-id*})))) | |
(api.macros/defendpoint :delete "/:model/:id"
"Delete a bookmark. Will delete a bookmark assigned to the user making the request by model and id."
[{:keys [model id]} :- [:map
[:model Models]
[:id ms/PositiveInt]]]
;; todo: allow admins to include an optional user id to delete for so they can delete other's bookmarks.
(let [[_ bookmark-model item-key] (lookup model)]
(t2/delete! bookmark-model
:user_id api/*current-user-id*
item-key id)
api/generic-204-no-content)) | |
(api.macros/defendpoint :put "/ordering"
"Sets the order of bookmarks for user."
[_route-params
_query-params
{:keys [orderings]} :- [:map
[:orderings BookmarkOrderings]]]
(bookmark/save-ordering! api/*current-user-id* orderings)
api/generic-204-no-content) | |