aboutsummaryrefslogtreecommitdiffstats
path: root/desktop/modules/notes/Notes.js
blob: 76c8f953a17c28b66aa3bf774802f0c4b4950185 (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
.pragma library

// Copyright (C) 2026 Danilo M. <danix@danix.xyz>
//
// This program is free software; you can redistribute it and/or modify
// it under the terms of the GNU General Public License version 2 as
// published by the Free Software Foundation.
//
// 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.

// Pure helpers for the notes module, tested by test_notes.js under node.
// Everything here is a value in and a value out: no file, no process.

function titleOf(note) {
    return (note && typeof note.title === "string") ? note.title : "";
}

function notesOf(db) {
    return (db && Array.isArray(db.notes)) ? db.notes : [];
}

// db.json, whole. Anything that is not an object carrying a notes array reads
// as an empty store, so a truncated or hand-edited file shows "no notes"
// rather than failing to load the page.
function parse(text) {
    let v = null;
    try { v = JSON.parse(text); } catch (e) { v = null; }
    if (!v || typeof v !== "object" || Array.isArray(v) || !Array.isArray(v.notes))
        return { notes: [] };
    return v;
}

// Pretty, 2-space, trailing newline. notes.sh reads db.json through jq, which
// does not care about the layout.
function stringify(db) {
    return JSON.stringify(db, null, 2) + "\n";
}

// Notes newest first. `file` is epoch seconds held as a string; a missing or
// non-numeric one is unusable and goes last, in input order. A copy: the
// caller's array is never reordered.
function sorted(notes) {
    const usable = [], unusable = [];
    for (const n of (notes || [])) {
        const t = Number(n && n.file);
        (isFinite(t) && t > 0 ? usable : unusable).push(n);
    }
    usable.sort((a, b) => Number(b.file) - Number(a.file));
    return usable.concat(unusable);
}

// "dd/mm/yyyy hh:mm" in local time from an epoch-seconds string, "" for
// anything unusable, so a row with no date shows blank rather than NaN.
function formatDate(file) {
    const t = Number(file);
    if (!isFinite(t) || t <= 0) return "";
    const d = new Date(t * 1000);
    const p = n => String(n).padStart(2, "0");
    return p(d.getDate()) + "/" + p(d.getMonth() + 1) + "/" + d.getFullYear()
        + " " + p(d.getHours()) + ":" + p(d.getMinutes());
}

// The next id: the highest numeric id plus one, as a string. notes.sh stores
// ids as strings and looks a note up with `select(.id == $i)`, comparing
// string to string, so a number here would stop the CLI finding a note the
// page wrote.
function nextId(notes) {
    let max = 0;
    for (const n of (notes || [])) {
        const i = parseInt(n && n.id, 10);
        if (isFinite(i) && i > max) max = i;
    }
    return String(max + 1);
}

// Title substring, case-insensitive; an empty query keeps all.
function filter(notes, query) {
    const q = String(query === undefined || query === null ? "" : query).trim().toLowerCase();
    if (q === "") return notes || [];
    return (notes || []).filter(n => titleOf(n).toLowerCase().indexOf(q) >= 0);
}

// A new db with a note appended. title and file are stored as strings; the id
// comes from nextId. Every other key carries through and the input is not
// mutated.
function addNote(db, title, file) {
    const notes = notesOf(db);
    const entry = { id: nextId(notes), title: String(title === undefined ? "" : title),
                    file: String(file === undefined ? "" : file) };
    return Object.assign({}, db, { notes: notes.concat([entry]) });
}

// A new db with one note's title replaced. An id that is not there leaves the
// notes untouched.
function updateNote(db, id, title) {
    const notes = notesOf(db).map(n =>
        n.id === id ? Object.assign({}, n, { title: String(title === undefined ? "" : title) }) : n);
    return Object.assign({}, db, { notes: notes });
}

// A new db without the note this id names.
function removeNote(db, id) {
    return Object.assign({}, db, { notes: notesOf(db).filter(n => n.id !== id) });
}

// A new db with git.lastpull set, as a string, the way notes.sh's gitsync
// writes it. It is what notes.sh -l reads to decide whether to pull again.
function setLastpull(db, now) {
    return Object.assign({}, db, { git: Object.assign({}, db.git, { lastpull: String(now) }) });
}