summaryrefslogtreecommitdiff
path: root/lisp/forgejo-db.el
blob: 22ce1b1b14b44fd4a2899e594f40c1eaf377845a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
;;; forgejo-db.el --- SQLite cache for Forgejo API data  -*- lexical-binding: t; -*-

;; Copyright (C) 2026  Free Software Foundation, Inc.

;; Author: Thanos Apollo <public@thanosapollo.org>
;; Keywords: extensions

;; This program is free software; you can redistribute it and/or modify
;; it under the terms of the GNU General Public License as published by
;; the Free Software Foundation, either version 3 of the License, or
;; (at your option) any later version.

;; This program is distributed in the hope that it will be useful,
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
;; GNU General Public License for more details.

;; You should have received a copy of the GNU General Public License
;; along with this program.  If not, see <https://www.gnu.org/licenses/>.

;;; Commentary:

;; Local SQLite cache for Forgejo API responses.
;;
;; Stores issues, pull requests, timeline events, labels, and
;; milestones.  Tracks sync timestamps per (host, owner, repo,
;; endpoint) for incremental updates via the API's `since' parameter.

;;; Code:

(require 'cl-lib)
(require 'json)

(defvar forgejo-db)
(defvar forgejo-db-dir)

;;; Schema

(defconst forgejo-db--schema
  '("CREATE TABLE IF NOT EXISTS issues (
       id INTEGER NOT NULL,
       host TEXT NOT NULL,
       owner TEXT NOT NULL,
       repo TEXT NOT NULL,
       number INTEGER NOT NULL,
       title TEXT NOT NULL,
       state TEXT NOT NULL,
       body TEXT,
       previous_body TEXT,
       user TEXT,
       labels TEXT,
       milestone TEXT,
       assignees TEXT,
       comments_count INTEGER DEFAULT 0,
       created_at TEXT,
       updated_at TEXT,
       closed_at TEXT,
       is_pull INTEGER DEFAULT 0,
       read INTEGER DEFAULT 0,
       PRIMARY KEY (host, owner, repo, number))"
    "CREATE TABLE IF NOT EXISTS timeline_events (
       id INTEGER NOT NULL,
       host TEXT NOT NULL,
       owner TEXT NOT NULL,
       repo TEXT NOT NULL,
       issue_number INTEGER NOT NULL,
       type TEXT,
       body TEXT,
       user TEXT,
       created_at TEXT,
       data TEXT,
       PRIMARY KEY (host, owner, repo, issue_number, id))"
    "CREATE TABLE IF NOT EXISTS labels (
       id INTEGER NOT NULL,
       host TEXT NOT NULL,
       owner TEXT NOT NULL,
       repo TEXT NOT NULL,
       name TEXT NOT NULL,
       color TEXT,
       description TEXT,
       PRIMARY KEY (host, owner, repo, id))"
    "CREATE TABLE IF NOT EXISTS milestones (
       id INTEGER NOT NULL,
       host TEXT NOT NULL,
       owner TEXT NOT NULL,
       repo TEXT NOT NULL,
       title TEXT NOT NULL,
       state TEXT,
       open_issues INTEGER DEFAULT 0,
       closed_issues INTEGER DEFAULT 0,
       PRIMARY KEY (host, owner, repo, id))"
    "CREATE TABLE IF NOT EXISTS repos (
       host TEXT NOT NULL,
       owner TEXT NOT NULL,
       name TEXT NOT NULL,
       description TEXT,
       is_user_repo INTEGER DEFAULT 0,
       PRIMARY KEY (host, owner, name))"
    "CREATE TABLE IF NOT EXISTS sync_state (
       host TEXT NOT NULL,
       owner TEXT NOT NULL,
       repo TEXT NOT NULL,
       endpoint TEXT NOT NULL,
       last_synced TEXT,
       etag TEXT,
       last_modified TEXT,
       PRIMARY KEY (host, owner, repo, endpoint))"
    )
  "SQL statements to initialize the database schema.")

;;; Connection management

(defun forgejo-db--ensure ()
  "Open or create the SQLite database, run schema if needed.
Detects stale schema and rebuilds the database if necessary."
  (unless (and forgejo-db (sqlitep forgejo-db))
    (let* ((dir (file-name-as-directory forgejo-db-dir))
           (db-file (expand-file-name "forgejo.db" dir)))
      (unless (file-directory-p dir)
        (make-directory dir t))
      (setq forgejo-db (sqlite-open db-file))
      ;; Detect stale schema and rebuild
      (when (forgejo-db--stale-schema-p)
        (sqlite-close forgejo-db)
        (delete-file db-file)
        (setq forgejo-db (sqlite-open db-file))
        (message "forgejo.el: Rebuilt database (schema changed)"))
      (dolist (stmt forgejo-db--schema)
        (sqlite-execute forgejo-db stmt))))
  forgejo-db)

(defun forgejo-db--stale-schema-p ()
  "Return non-nil if the DB has columns that no longer exist in the schema."
  (condition-case nil
      (let ((cols (mapcar #'cadr
                          (sqlite-select forgejo-db
                                         "PRAGMA table_info(issues)"))))
        (and cols (member "body_html" cols)))
    (error nil)))

(defun forgejo-db--close ()
  "Close the database connection."
  (when (and forgejo-db (sqlitep forgejo-db))
    (sqlite-close forgejo-db)
    (setq forgejo-db nil)))

;;; Low-level wrappers

(defun forgejo-db--execute (sql &rest args)
  "Execute SQL with ARGS on the forgejo database."
  (apply #'sqlite-execute (forgejo-db--ensure) sql args))

(defun forgejo-db--select (sql &rest args)
  "Execute SQL query with ARGS, return result rows."
  (apply #'sqlite-select (forgejo-db--ensure) sql args))

(defmacro forgejo-db--with-transaction (&rest body)
  "Execute BODY inside a single SQLite transaction."
  (declare (indent 0))
  `(let ((db (forgejo-db--ensure)))
     (sqlite-execute db "BEGIN")
     (condition-case err
         (prog1 (progn ,@body)
           (sqlite-execute db "COMMIT"))
       (error
        (sqlite-execute db "ROLLBACK")
        (signal (car err) (cdr err))))))

;;; JSON helpers

(defun forgejo-db--nullable (value)
  "Convert VALUE to nil if it is :null or :false."
  (if (memq value '(:null :false)) nil value))

(defun forgejo-db--encode-json (value)
  "Encode VALUE as a JSON string for storage."
  (if value (json-encode value) "null"))

(defun forgejo-db--decode-json (text)
  "Decode JSON TEXT from storage.  Returns nil for null/empty."
  (when (and text (not (string= text "null")) (not (string-empty-p text)))
    (json-parse-string text :object-type 'alist :array-type 'list)))

;;; Issues

(defun forgejo-db--track-edit (db host owner repo number new-body)
  "If issue body changed, append old body to previous_body history.
Returns nil if no change or no existing row."
  (setq owner (downcase owner) repo (downcase repo))
  (when-let* ((new-body)
              (existing (car (sqlite-select
                              db
                              "SELECT body, previous_body FROM issues
                               WHERE host = ? AND owner = ? AND repo = ? AND number = ?"
                              (list host owner repo number))))
              (old-body (nth 0 existing))
              ((and old-body (not (string= old-body new-body)))))
    (let* ((history-json (nth 1 existing))
           (history (if history-json
                        (forgejo-db--decode-json history-json)
                      nil))
           (updated (append history (list old-body))))
      (sqlite-execute
       db
       "UPDATE issues SET previous_body = ? WHERE host = ? AND owner = ? AND repo = ? AND number = ?"
       (list (forgejo-db--encode-json updated) host owner repo number)))))

(defun forgejo-db-save-issues (host owner repo issues &optional is-pull)
  "Upsert ISSUES (list of API alists) for HOST/OWNER/REPO.
Tracks body edits in previous_body.
When IS-PULL is non-nil, mark all entries as pull requests regardless of
whether a `pull_request' field is present in the data."
  (setq owner (downcase owner) repo (downcase repo))
  (forgejo-db--with-transaction
   (let ((db (forgejo-db--ensure)))
     (dolist (issue issues)
       (let-alist issue
         (let ((body (forgejo-db--nullable .body))
	       (labels (forgejo-db--nullable .labels))
	       (milestone (forgejo-db--nullable .milestone))
	       (assignees (forgejo-db--nullable .assignees))
	       (closed (forgejo-db--nullable .closed_at))
	       (pr (or is-pull (forgejo-db--nullable .pull_request))))
           ;; Track edits before overwriting
           (when body
             (forgejo-db--track-edit db host owner repo .number body))
           (sqlite-execute
            db
            "INSERT INTO issues
              (id, host, owner, repo, number, title, state, body,
               user, labels, milestone, assignees, comments_count,
               created_at, updated_at, closed_at, is_pull, read)
            VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 0)
            ON CONFLICT(host, owner, repo, number) DO UPDATE SET
              title=excluded.title, state=excluded.state, body=excluded.body,
              user=excluded.user, labels=excluded.labels, milestone=excluded.milestone,
              assignees=excluded.assignees, comments_count=excluded.comments_count,
              updated_at=excluded.updated_at, closed_at=excluded.closed_at,
              is_pull=excluded.is_pull, read=0"
            (list .id host owner repo .number .title .state body
                  (alist-get 'login .user)
                  (forgejo-db--encode-json (when (listp labels) labels))
                  (when (listp milestone) (alist-get 'title milestone))
                  (forgejo-db--encode-json
                   (when (listp assignees)
                     (mapcar (lambda (a) (alist-get 'login a)) assignees)))
                  .comments
                  .created_at .updated_at closed
                  (if pr 1 0)))))))))

(defun forgejo-db--like (s)
  "Wrap S in SQL LIKE wildcards."
  (format "%%%s%%" s))

(defun forgejo-db--read-val (v)
  "Convert read filter V to integer."
  (if (equal v "yes") 1 0))

(defun forgejo-db--type-clause (v)
  "Return bare SQL clause for type filter V."
  (if (equal v "pr") "is_pull = 1" "is_pull = 0"))

(defconst forgejo-db--filter-specs
  '((:state     "state = ?"     identity)
    (:label     "labels LIKE ?" forgejo-db--like)
    (:labels    "labels LIKE ?" forgejo-db--like)
    (:milestone "milestone = ?" identity)
    (:author    "user LIKE ?"   forgejo-db--like)
    (:query     "title LIKE ?"  forgejo-db--like)
    (:read      "read = ?"      forgejo-db--read-val)
    (:type      nil             forgejo-db--type-clause)
    (:is-pull   "is_pull = 1"   nil)
    (:no-pulls  "is_pull = 0"   nil))
  "Filter specs: (KEY SQL-CLAUSE VALUE-TRANSFORM).
When SQL-CLAUSE is nil, TRANSFORM returns the clause itself (bare SQL).
When TRANSFORM is nil, the clause is bare SQL with no bound argument.")

(defun forgejo-db--build-filter-clauses (filters)
  "Build (CLAUSES . ARGS) from FILTERS plist.
CLAUSES is a list of SQL WHERE fragments, ARGS is a list of
bound parameter values."
  (cl-loop for (key clause transform) in forgejo-db--filter-specs
           for val = (plist-get filters key)
           when val
           if (null transform)
           collect clause into clauses
           else if (null clause)
           collect (funcall transform val) into clauses
           else
           collect clause into clauses
           and collect (funcall transform val) into args
           finally return (cons clauses args)))

(defun forgejo-db-get-issues (host owner repo &optional filters)
  "Query cached issues for HOST/OWNER/REPO with optional FILTERS.
FILTERS is a plist with keys:
  :state      \"open\", \"closed\", or nil for all
  :label      label name substring to match
  :labels     alias for :label
  :milestone  milestone title to match
  :author     author/poster login to match
  :query      search string for title
  :read       \"yes\" or \"no\" for read/unread status
  :type       \"pr\" or \"issue\"
  :is-pull    when non-nil, filter to pull requests only
  :no-pulls   when non-nil, exclude pull requests"
  (setq owner (downcase owner) repo (downcase repo))
  (let* ((filter-result (forgejo-db--build-filter-clauses filters))
         (clauses (append (list "host = ?" "owner = ?" "repo = ?")
                          (car filter-result)))
         (args (append (list host owner repo)
                       (cdr filter-result))))
    (forgejo-db--select
     (format "SELECT %s FROM issues WHERE %s ORDER BY updated_at DESC"
             forgejo-db--issue-columns
             (mapconcat #'identity clauses " AND "))
     args)))

;;; Timeline events

(defun forgejo-db-save-timeline (host owner repo number events)
  "Upsert timeline EVENTS for issue NUMBER in HOST/OWNER/REPO."
  (setq owner (downcase owner) repo (downcase repo))
  (when (and events (listp events))
    (forgejo-db--with-transaction
     (let ((db (forgejo-db--ensure)))
       (dolist (event events)
         (let-alist event
           (sqlite-execute
            db
            "INSERT INTO timeline_events
              (id, host, owner, repo, issue_number, type, body,
               user, created_at, data)
            VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
            ON CONFLICT(host, owner, repo, issue_number, id) DO UPDATE SET
              type=excluded.type, body=excluded.body,
              user=excluded.user, created_at=excluded.created_at,
              data=excluded.data"
            (list .id host owner repo number
                  (forgejo-db--nullable .type)
                  (forgejo-db--nullable .body)
                  (alist-get 'login (forgejo-db--nullable .user))
                  (forgejo-db--nullable .created_at)
                  (forgejo-db--encode-json event)))))))))

(defun forgejo-db-get-timeline (host owner repo number)
  "Get cached timeline events for issue NUMBER in HOST/OWNER/REPO."
  (setq owner (downcase owner) repo (downcase repo))
  (forgejo-db--select
   (format "SELECT %s FROM timeline_events
            WHERE host = ? AND owner = ? AND repo = ? AND issue_number = ?
            ORDER BY created_at ASC"
           forgejo-db--timeline-columns)
   (list host owner repo number)))

;;; Labels

(defun forgejo-db-save-labels (host owner repo labels)
  "Upsert LABELS for HOST/OWNER/REPO."
  (setq owner (downcase owner) repo (downcase repo))
  (let ((db (forgejo-db--ensure)))
    (dolist (label labels)
      (let-alist label
        (sqlite-execute
         db
         "INSERT OR REPLACE INTO labels
            (id, host, owner, repo, name, color, description)
          VALUES (?, ?, ?, ?, ?, ?, ?)"
         (list .id host owner repo .name .color .description))))))

(defun forgejo-db-get-labels (host owner repo)
  "Get cached labels for HOST/OWNER/REPO."
  (setq owner (downcase owner) repo (downcase repo))
  (forgejo-db--select
   "SELECT * FROM labels WHERE host = ? AND owner = ? AND repo = ?
    ORDER BY name"
   (list host owner repo)))

(defun forgejo-db-get-label-id (host owner repo name)
  "Return the label ID for NAME in HOST/OWNER/REPO, or nil."
  (setq owner (downcase owner) repo (downcase repo))
  (caar (forgejo-db--select
         "SELECT id FROM labels WHERE host = ? AND owner = ? AND repo = ? AND name = ?"
         (list host owner repo name))))

;;; Milestones

(defun forgejo-db-save-milestones (host owner repo milestones)
  "Upsert MILESTONES for HOST/OWNER/REPO."
  (setq owner (downcase owner) repo (downcase repo))
  (let ((db (forgejo-db--ensure)))
    (dolist (ms milestones)
      (let-alist ms
        (sqlite-execute
         db
         "INSERT OR REPLACE INTO milestones
            (id, host, owner, repo, title, state, open_issues, closed_issues)
          VALUES (?, ?, ?, ?, ?, ?, ?, ?)"
         (list .id host owner repo .title .state
               .open_issues .closed_issues))))))

(defun forgejo-db-get-milestones (host owner repo)
  "Get cached milestones for HOST/OWNER/REPO."
  (setq owner (downcase owner) repo (downcase repo))
  (forgejo-db--select
   "SELECT * FROM milestones WHERE host = ? AND owner = ? AND repo = ?
    ORDER BY title"
   (list host owner repo)))

(defun forgejo-db-get-milestone-id (host owner repo title)
  "Return the milestone ID for TITLE in HOST/OWNER/REPO, or nil."
  (setq owner (downcase owner) repo (downcase repo))
  (caar (forgejo-db--select
         "SELECT id FROM milestones WHERE host = ? AND owner = ? AND repo = ? AND title = ?"
         (list host owner repo title))))

;;; Repos

(defun forgejo-db-save-user-repos (host repos)
  "Save REPOS (list of API alists) as user repos for HOST."
  (let ((db (forgejo-db--ensure)))
    (dolist (repo repos)
      (let-alist repo
        (sqlite-execute
         db
         "INSERT OR REPLACE INTO repos (host, owner, name, description, is_user_repo)
          VALUES (?, ?, ?, ?, 1)"
         (list host
               (downcase (alist-get 'login .owner))
               (downcase .name)
               (forgejo-db--nullable .description)))))))

(defun forgejo-db-get-user-repos (host)
  "Get cached user repo names for HOST as list of \"owner/name\" strings."
  (mapcar (lambda (row) (format "%s/%s" (nth 0 row) (nth 1 row)))
          (forgejo-db--select
           "SELECT owner, name FROM repos WHERE host = ? AND is_user_repo = 1
            ORDER BY name"
           (list host))))

(defun forgejo-db-get-cached-repos (host)
  "Return all \"owner/repo\" strings that have cached issues for HOST."
  (mapcar (lambda (row) (format "%s/%s" (nth 0 row) (nth 1 row)))
          (forgejo-db--select
           "SELECT DISTINCT owner, repo FROM issues WHERE host = ?
            ORDER BY owner, repo"
           (list host))))

;;; Sync state tracking

(defun forgejo-db-get-sync-time (host owner repo endpoint)
  "Get the last sync timestamp for ENDPOINT in HOST/OWNER/REPO."
  (setq owner (downcase owner) repo (downcase repo))
  (caar (forgejo-db--select
         "SELECT last_synced FROM sync_state
          WHERE host = ? AND owner = ? AND repo = ? AND endpoint = ?"
         (list host owner repo endpoint))))

(defun forgejo-db-set-sync-time (host owner repo endpoint time)
  "Set the last sync TIME for ENDPOINT in HOST/OWNER/REPO."
  (setq owner (downcase owner) repo (downcase repo))
  (forgejo-db--execute
   "INSERT INTO sync_state (host, owner, repo, endpoint, last_synced)
    VALUES (?, ?, ?, ?, ?)
    ON CONFLICT (host, owner, repo, endpoint)
    DO UPDATE SET last_synced = excluded.last_synced"
   (list host owner repo endpoint time)))

(defun forgejo-db-get-cache-headers (host owner repo endpoint)
  "Get cached ETag and Last-Modified for ENDPOINT in HOST/OWNER/REPO."
  (setq owner (downcase owner) repo (downcase repo))
  (let ((row (car (forgejo-db--select
                   "SELECT etag, last_modified FROM sync_state
                    WHERE host = ? AND owner = ? AND repo = ? AND endpoint = ?"
                   (list host owner repo endpoint)))))
    (when row
      (list :etag (nth 0 row) :last-modified (nth 1 row)))))

(defun forgejo-db-set-cache-headers (host owner repo endpoint etag last-modified)
  "Update cached ETAG and LAST-MODIFIED for ENDPOINT in HOST/OWNER/REPO."
  (setq owner (downcase owner) repo (downcase repo))
  (forgejo-db--execute
   "INSERT INTO sync_state (host, owner, repo, endpoint, etag, last_modified)
    VALUES (?, ?, ?, ?, ?, ?)
    ON CONFLICT (host, owner, repo, endpoint)
    DO UPDATE SET etag = excluded.etag, last_modified = excluded.last_modified"
   (list host owner repo endpoint etag last-modified)))

;;; Row-to-alist conversion (explicit column queries)

(defconst forgejo-db--issue-columns
  "number, title, state, body, user, labels, milestone,
   assignees, comments_count, created_at, updated_at, closed_at, is_pull,
   previous_body, read"
  "Column list for issue queries (deterministic order).")

(defun forgejo-db--row-to-issue-alist (row)
  "Convert an issue ROW to an API-shaped alist.
ROW must come from a query using `forgejo-db--issue-columns':
  0=number 1=title 2=state 3=body 4=user 5=labels
  6=milestone 7=assignees 8=comments_count 9=created_at
  10=updated_at 11=closed_at 12=is_pull 13=previous_body 14=read"
  (let ((labels (forgejo-db--decode-json (nth 5 row)))
        (assignees-raw (forgejo-db--decode-json (nth 7 row))))
    `((number . ,(nth 0 row))
      (title . ,(nth 1 row))
      (state . ,(nth 2 row))
      (body . ,(nth 3 row))
      (user . ((login . ,(nth 4 row))))
      (labels . ,labels)
      (milestone . ,(when (nth 6 row) `((title . ,(nth 6 row)))))
      (assignees . ,(mapcar (lambda (login) `((login . ,login)))
                            (if (listp assignees-raw) assignees-raw nil)))
      (comments . ,(nth 8 row))
      (created_at . ,(nth 9 row))
      (updated_at . ,(nth 10 row))
      (closed_at . ,(nth 11 row))
      (pull_request . ,(when (= (or (nth 12 row) 0) 1) t))
      (previous_body . ,(nth 13 row))
      (read . ,(or (nth 14 row) 0)))))

(defconst forgejo-db--timeline-columns
  "id, type, body, user, created_at, data"
  "Column list for timeline queries (deterministic order).")

(defun forgejo-db--row-to-timeline-alist (row)
  "Convert a timeline ROW to an alist.
ROW must come from a query using `forgejo-db--timeline-columns':
  0=id 1=type 2=body 3=user 4=created_at 5=data
The `data' JSON blob is merged into the result to provide event-specific
fields like label, assignee, old_title, new_title."
  (let* ((base `((id . ,(nth 0 row))
                 (type . ,(nth 1 row))
                 (body . ,(nth 2 row))
                 (user . ((login . ,(nth 3 row))))
                 (created_at . ,(nth 4 row))))
         (data-json (nth 5 row))
         (data (when data-json (forgejo-db--decode-json data-json))))
    (if data
        (append base data)
      base)))

(defun forgejo-db-get-issue (host owner repo number)
  "Get a single issue alist from the DB, or nil."
  (setq owner (downcase owner) repo (downcase repo))
  (when-let* ((rows (forgejo-db--select
                     (format "SELECT %s FROM issues
                              WHERE host = ? AND owner = ? AND repo = ? AND number = ?"
                             forgejo-db--issue-columns)
                     (list host owner repo number)))
              (row (car rows)))
    (forgejo-db--row-to-issue-alist row)))

(defun forgejo-db-mark-read (host owner repo number)
  "Mark issue/PR NUMBER as read for HOST/OWNER/REPO."
  (setq owner (downcase owner) repo (downcase repo))
  (forgejo-db--execute
   "UPDATE issues SET read = 1
    WHERE host = ? AND owner = ? AND repo = ? AND number = ?"
   (list host owner repo number)))

(defun forgejo-db-close-missing (host owner repo numbers &optional is-pull)
  "Mark issues NOT in NUMBERS as closed for HOST/OWNER/REPO.
When IS-PULL is non-nil, only affect pull requests."
  (setq owner (downcase owner) repo (downcase repo))
  (when numbers
    (let ((placeholders (mapconcat (lambda (_) "?") numbers ","))
          (pull-filter (if is-pull "AND is_pull = 1" "AND is_pull = 0")))
      (forgejo-db--execute
       (format "UPDATE issues SET state = 'closed'
                WHERE host = ? AND owner = ? AND repo = ?
                AND state = 'open' %s
                AND number NOT IN (%s)"
               pull-filter placeholders)
       (append (list host owner repo) numbers)))))

(defun forgejo-db-get-authors (host owner repo)
  "Get distinct author logins for HOST/OWNER/REPO."
  (setq owner (downcase owner) repo (downcase repo))
  (mapcar #'car
          (forgejo-db--select
           "SELECT DISTINCT user FROM issues
            WHERE host = ? AND owner = ? AND repo = ? AND user IS NOT NULL
            ORDER BY user"
           (list host owner repo))))

;;; Issue/PR titles for completion

(defun forgejo-db-get-issue-titles (host owner repo)
  "Return alist of (NUMBER . TITLE) for all issues/PRs in HOST/OWNER/REPO."
  (setq owner (downcase owner) repo (downcase repo))
  (mapcar (lambda (row) (cons (nth 0 row) (nth 1 row)))
          (forgejo-db--select
           "SELECT number, title FROM issues
            WHERE host = ? AND owner = ? AND repo = ?
            ORDER BY number DESC"
           (list host owner repo))))

;;; Host lookup

(defun forgejo-db-get-hosts-for-repo (owner repo)
  "Return distinct host strings that have data for OWNER/REPO."
  (setq owner (downcase owner) repo (downcase repo))
  (mapcar #'car
          (forgejo-db--select
           "SELECT DISTINCT host FROM issues WHERE owner = ? AND repo = ?"
           (list owner repo))))

(provide 'forgejo-db)
;;; forgejo-db.el ends here