domma-cms 1.80.0 → 1.82.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (53) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/admin/css/site-settings.css +1 -1
  3. package/admin/js/lib/site-settings-arrange.js +3 -3
  4. package/admin/js/templates/docs/usage-site-settings.html +47 -3
  5. package/admin/js/templates/settings.html +98 -8
  6. package/admin/js/views/settings.js +3 -3
  7. package/docs/DommaFeatures.md +51 -2
  8. package/docs/plans/2026-11-19-brand-kit-design.md +1 -1
  9. package/docs/plugin-development.md +6 -0
  10. package/package.json +1 -1
  11. package/plugins/_lib/telegram/bot.js +120 -0
  12. package/plugins/free-tier.lock.json +34 -9
  13. package/plugins/telegram/CHANGELOG.md +5 -0
  14. package/plugins/telegram/CLAUDE.md +77 -0
  15. package/plugins/telegram/admin/css/index.css +68 -0
  16. package/plugins/telegram/admin/lib/arrange.js +103 -0
  17. package/plugins/telegram/admin/lib/kit.js +153 -0
  18. package/plugins/telegram/admin/templates/telegram.html +1 -0
  19. package/plugins/telegram/admin/views/chats.js +223 -0
  20. package/plugins/telegram/admin/views/connection.js +90 -0
  21. package/plugins/telegram/admin/views/telegram.js +89 -0
  22. package/plugins/telegram/admin/views/test.js +84 -0
  23. package/plugins/telegram/config.js +21 -0
  24. package/plugins/telegram/docs/guide.md +87 -0
  25. package/plugins/telegram/lib/messages.js +176 -0
  26. package/plugins/telegram/lib/queue.js +72 -0
  27. package/plugins/telegram/plugin.js +490 -0
  28. package/plugins/telegram/plugin.json +71 -0
  29. package/plugins/telegram/tests/api.test.js +381 -0
  30. package/plugins/telegram/tests/arrange.test.js +41 -0
  31. package/plugins/telegram/tests/messages.test.js +110 -0
  32. package/plugins/telegram/tests/queue.test.js +47 -0
  33. package/plugins/theme-roller/CLAUDE.md +9 -0
  34. package/plugins/theme-roller/admin/lib/themes.js +49 -0
  35. package/plugins/theme-roller/admin/templates/theme-roller.html +2 -0
  36. package/plugins/theme-roller/admin/views/theme-roller-view.js +25 -2
  37. package/plugins/theme-roller/docs/guide.md +1 -0
  38. package/plugins/theme-roller/plugin.json +1 -1
  39. package/plugins/theme-roller/tests/themes.test.js +20 -0
  40. package/public/js/site.js +1 -1
  41. package/server/routes/api/brand-kit.js +55 -0
  42. package/server/routes/api/settings.js +17 -1
  43. package/server/routes/favicon.js +10 -6
  44. package/server/server.js +2 -0
  45. package/server/services/adminBrand.js +8 -3
  46. package/server/services/brandKit.js +330 -0
  47. package/server/services/chat/launcher-bridge.js +2 -1
  48. package/server/services/emailBrand.js +31 -13
  49. package/server/services/launchers.js +5 -1
  50. package/server/services/notify.js +20 -2
  51. package/server/services/plugins.js +3 -0
  52. package/server/services/renderer.js +7 -5
  53. package/server/templates/page.html +1 -1
@@ -0,0 +1,153 @@
1
+ /**
2
+ * Telegram admin - what the screens share (Telegram Pro's too): the admin's helpers loaded at run time (a
3
+ * plugin never imports admin/ statically - the updater replaces it), the API, escaping, slideovers with an
4
+ * unsaved-changes guard, keyboard-friendly rows with a context menu, and per-browser drafts.
5
+ *
6
+ * @module telegram/admin/lib/kit
7
+ */
8
+
9
+ export const BASE = '/api/plugins/telegram';
10
+ const seg = (id) => encodeURIComponent(String(id));
11
+
12
+ let kit = null;
13
+
14
+ /** tool-kit, plugin-chrome, help-popover and loading, once, with stand-ins for an older admin. */
15
+ export function loadKit() {
16
+ if (!kit) {
17
+ kit = Promise.all([
18
+ import('/admin/js/lib/tool-kit.js').catch(() => ({})),
19
+ import('/admin/js/lib/plugin-chrome.js').catch(() => ({})),
20
+ import('/admin/js/lib/help-popover.js').catch(() => ({})),
21
+ import('/admin/js/lib/loading.js').catch(() => ({}))
22
+ ]).then(([tk, chrome, help, loading]) => ({
23
+ onceClosed: tk.onceClosed || ((so, fn) => { const c = so.close.bind(so); so.close = (...a) => { const r = c(...a); fn?.(); return r; }; }),
24
+ openMenuAt: tk.openMenuAt || ((el) => {
25
+ const r = el.getBoundingClientRect();
26
+ el.dispatchEvent(new MouseEvent('contextmenu', {bubbles: true, cancelable: true, clientX: r.left, clientY: r.bottom, view: window}));
27
+ }),
28
+ viewLifetime: tk.viewLifetime || (() => ({add() {}, reset() {}, leaving: false})),
29
+ sidebarCount: tk.sidebarCount || ((url) => { try { window.dispatchEvent(new CustomEvent('dm:sidebar-count', {detail: {url}})); } catch { /* none */ } }),
30
+ addBannerAction: chrome.addBannerAction || (() => null),
31
+ helpPopovers: help.helpPopovers || (() => () => {}),
32
+ whileLoading: loading.whileLoading || ((slot, promise) => promise),
33
+ SHAPES: loading.SHAPES || {}
34
+ }));
35
+ }
36
+ return kit;
37
+ }
38
+
39
+ export const api = {
40
+ status: () => H.get(`${BASE}/status`),
41
+ connect: (token, base) => H.post(`${BASE}/connect`, {token, base}),
42
+ disconnect: () => H.delete(`${BASE}/connection`),
43
+ linkCode: () => H.post(`${BASE}/link-code`, {}),
44
+ saveChat: (id, body) => H.put(`${BASE}/chats/${seg(id)}`, body),
45
+ unlink: (id) => H.delete(`${BASE}/chats/${seg(id)}`),
46
+ test: (body) => H.post(`${BASE}/test`, body)
47
+ };
48
+
49
+ /** For E.confirm / E.prompt / panel HTML. Not for E.toast (it sets textContent). */
50
+ export const esc = (s) => String(s ?? '').replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;').replace(/'/g, '&#39;');
51
+
52
+ /** Markup we wrote ourselves into one element (values reach it only through bindings). */
53
+ export function fragment(html) {
54
+ const t = document.createElement('template');
55
+ t.innerHTML = html.trim();
56
+ return t.content.firstElementChild;
57
+ }
58
+
59
+ /** Copy text, and say so. */
60
+ export function copy(text, what = 'Copied') {
61
+ navigator.clipboard?.writeText(text).then(() => E.toast(`${what}.`, {type: 'success'}), () => E.toast(text));
62
+ }
63
+
64
+ /** Run on the next task: a menu item picked with Enter that asks something must not hand it that Enter. */
65
+ const soon = (fn) => (...a) => setTimeout(() => fn(...a), 0);
66
+
67
+ /**
68
+ * A bound slideover. `dirty()` true makes closing ask first ("Discard your changes?"); `busy()` true holds it
69
+ * open while a save runs. `close(true)` closes without asking (after a save, or when the screen goes).
70
+ */
71
+ export async function openPanel({title, size = 'md', html, model = {}, methods = {}, dirty, busy, cleanup = () => {}}) {
72
+ const {onceClosed, helpPopovers} = await loadKit();
73
+ const so = E.slideover({title: esc(title), size, position: 'right'});
74
+ const panel = fragment(html);
75
+ so.element.appendChild(panel);
76
+ // Help markers and icons before the bindings: data-bind-hidden keeps them in place, data-if would not.
77
+ const disposeHelp = helpPopovers(panel, {position: 'bottom'});
78
+ I.scan(panel);
79
+ const handle = M.applyBindings(model, panel, {methods});
80
+ const onUnload = (e) => { if (dirty?.()) { e.preventDefault(); e.returnValue = ''; } };
81
+ window.addEventListener('beforeunload', onUnload);
82
+ onceClosed(so, () => { window.removeEventListener('beforeunload', onUnload); cleanup(); handle.dispose(); disposeHelp(); });
83
+ const close = so.close.bind(so);
84
+ let closed = false;
85
+ let asking = false;
86
+ so.close = async (force) => {
87
+ if (closed) return undefined;
88
+ if (force !== true) {
89
+ if (busy?.() || asking) return undefined;
90
+ if (dirty?.()) {
91
+ asking = true;
92
+ await new Promise(r => setTimeout(r, 0));
93
+ const ok = await E.confirm('Discard your changes?', {title: 'Unsaved changes', confirmText: 'Discard', cancelText: 'Keep editing'});
94
+ asking = false;
95
+ if (!ok || closed) return undefined;
96
+ }
97
+ }
98
+ closed = true;
99
+ return close();
100
+ };
101
+ panel.addEventListener('keydown', (e) => {
102
+ if ((e.ctrlKey || e.metaKey) && (e.key === 'Enter' || e.key === 's') && methods.save) { e.preventDefault(); e.stopPropagation(); methods.save(); }
103
+ });
104
+ so.open();
105
+ return {so, panel, close: (force) => so.close(force)};
106
+ }
107
+
108
+ const FIELDS = 'input, textarea, select';
109
+
110
+ /**
111
+ * Rows: click (or Enter) = the main action; right-click, the kebab or Shift+F10 = the menu; arrow keys move.
112
+ * `items(id)` builds the menu for a row; `scope` receives the teardown.
113
+ */
114
+ export function wireRows(list, {items, main, openMenuAt, scope, match = '.tg-row', kebab = '.tg-kebab'}) {
115
+ const deferred = (xs) => (xs || []).map(x => ({...x, ...(typeof x.action === 'function' ? {action: soon(x.action)} : {})}));
116
+ const menu = E.contextMenu(list, {cursor: 'glyph', match, exclude: FIELDS, inherit: false, density: 'compact', keyboardTrigger: false,
117
+ items: (row) => deferred(items(row.dataset.id))});
118
+ const onClick = (e) => {
119
+ const row = e.target.closest(match);
120
+ if (!row || !list.contains(row) || e.target.closest(FIELDS)) return;
121
+ const k = e.target.closest(kebab);
122
+ if (k) { openMenuAt(k); return; }
123
+ main(row.dataset.id);
124
+ };
125
+ const onKey = (e) => {
126
+ const row = e.target.closest(match);
127
+ if (!row || !list.contains(row)) return;
128
+ if (e.key === 'F10' && e.shiftKey) {
129
+ e.preventDefault();
130
+ e.stopPropagation();
131
+ openMenuAt(row.querySelector(kebab) || row);
132
+ } else if (e.key === 'Enter' && e.target === row) {
133
+ e.preventDefault();
134
+ e.stopPropagation();
135
+ const id = row.dataset.id;
136
+ setTimeout(() => main(id), 0);
137
+ } else if ((e.key === 'ArrowDown' || e.key === 'ArrowUp') && e.target === row) {
138
+ e.preventDefault();
139
+ const rows = [...list.querySelectorAll(match)].filter(r => r.offsetParent);
140
+ rows[rows.indexOf(row) + (e.key === 'ArrowDown' ? 1 : -1)]?.focus();
141
+ }
142
+ };
143
+ list.addEventListener('click', onClick);
144
+ list.addEventListener('keydown', onKey);
145
+ scope(() => { list.removeEventListener('click', onClick); list.removeEventListener('keydown', onKey); menu?.destroy?.(); });
146
+ }
147
+
148
+ /** Per-browser drafts (S): unsaved work kept when the screen is left, offered back on return. Never secrets. */
149
+ export const drafts = {
150
+ get(key) { try { return S.get(key) || null; } catch { return null; } },
151
+ set(key, value) { try { S.set(key, value); } catch { /* a convenience */ } },
152
+ drop(key) { try { S.remove ? S.remove(key) : S.set(key, null); } catch { /* none */ } }
153
+ };
@@ -0,0 +1 @@
1
+ <div class="tg" data-tg-admin></div>
@@ -0,0 +1,223 @@
1
+ /**
2
+ * Telegram › Chats - the linked chats and what each gets.
3
+ *
4
+ * A chat is linked from Telegram itself: the admin makes a one-time code here, someone sends "/link <code>" in
5
+ * the chat (a group with the bot added, or a private chat with the bot), and the chat appears in the list.
6
+ * Click a row (or Enter) for its routing; right-click, the kebab or Shift+F10 for the rest (test, pause, unlink).
7
+ *
8
+ * The routing panel is a bound slideover: closing it with changes asks first, and leaving the screen keeps the
9
+ * changes as a draft (per browser), offered back when that chat is opened again.
10
+ */
11
+ import {api, copy, drafts, esc, openPanel, wireRows} from '../lib/kit.js';
12
+ import {chatRow, linkView, routingBody, routingDraft, routingPrint, severityLabel} from '../lib/arrange.js';
13
+
14
+ const ROW = `
15
+ <div class="tg-row" data-id="{{id}}" tabindex="0" role="button" data-bind-title="title">
16
+ <span class="tg-chip">{{type}}</span>
17
+ <span class="tg-main"><strong>{{name}}</strong><small>{{alerts}} · {{forms}}</small><small>{{owner}}</small><small class="is-bad" data-bind-hidden="!problem">{{problem}}</small></span>
18
+ <span class="tg-chip is-warn" data-bind-hidden="!paused">Paused</span>
19
+ <button type="button" class="tg-kebab" aria-label="Chat actions" title="Actions">⋮</button>
20
+ </div>`;
21
+
22
+ const DRAFT = (id) => `telegram.draft.chat.${id}`;
23
+
24
+ export async function mount(root, ctx) {
25
+ const {kit, scope, here, status} = ctx;
26
+ const rows = M.observable([]);
27
+ const link = M.observable(linkView(status.peek()));
28
+ const s = () => status.peek() || {};
29
+ const manage = Boolean(s().can?.manage);
30
+ const connected = M.observable(Boolean(s().connected));
31
+ const botAt = M.observable('');
32
+ const making = M.observable(false);
33
+ const stop = M.effect(() => {
34
+ const st = status.value || {};
35
+ rows.value = (st.chats || []).map(c => chatRow(c, st));
36
+ link.value = linkView(st);
37
+ connected.value = Boolean(st.connected);
38
+ botAt.value = st.botName ? `@${st.botName}` : '';
39
+ });
40
+
41
+ root.innerHTML = `<div class="tg-stack">
42
+ <p class="tg-note is-warn" data-bind-hidden="connected.value">Connect the bot first, on the <a href="#/plugins/telegram">Connection</a> tab.</p>
43
+ <section class="tg-card" data-bind-hidden="!connected.value">
44
+ <header><h3><span data-icon="users" data-icon-size="16"></span> Linked chats <span data-help-title="Linked chats" data-help="Each chat linked here gets messages from the site: a group (your team's) or a private chat with the bot (one person's). Each has its own choice of alerts and forms - click a chat to change it. Only a chat linked with a code from this screen ever gets anything."></span></h3>
45
+ ${manage ? '<button type="button" class="btn btn-sm btn-primary" data-on-click="code" data-bind-disabled="making.value"><span data-icon="plus" data-icon-size="13"></span> Link a chat</button>' : ''}</header>
46
+
47
+ <div class="tg-note is-warn" data-bind-hidden="!link.value.code">
48
+ <ol class="tg-steps">
49
+ <li>In Telegram, add <b data-bind-text="botAt.value"></b> to the group (or open a private chat with it).</li>
50
+ <li>Send this in that chat: <code class="tg-code" data-bind-text="link.value.line"></code> <button type="button" class="btn btn-xs btn-ghost" data-on-click="copyCode">Copy</button></li>
51
+ <li>Click <b>Check</b>. The code works once, for 15 minutes.</li>
52
+ </ol>
53
+ <div class="tg-bar"><button type="button" class="btn btn-sm btn-primary" data-on-click="check">Check</button>
54
+ <span data-help="Anyone in a chat linked with this code reads what is routed to it, so send it only in a chat your team trusts. A few wrong codes in a row cancel it; make another one here."></span></div>
55
+ </div>
56
+
57
+ <div class="tg-empty" data-bind-hidden="rows.value.length"><h3><span data-icon="message-circle" data-icon-size="18"></span> No chats yet</h3>
58
+ <p>Link your team's Telegram group, or your own chat with the bot, and the site's warnings and form submissions arrive there.</p></div>
59
+ <div class="tg-list" data-bind-hidden="!rows.value.length" data-each="rows.value key=id"></div>
60
+ </section></div>`;
61
+ const view = root.firstElementChild;
62
+ const list = view.querySelector('.tg-list');
63
+ list.innerHTML = ROW;
64
+ scope(kit.helpPopovers(view, {position: 'bottom'}));
65
+ I.scan(view);
66
+
67
+ const panels = new Map();
68
+ scope(() => { for (const p of panels.values()) p.leave(); panels.clear(); });
69
+
70
+ const run = async (fn, said) => {
71
+ try {
72
+ const next = await fn();
73
+ ctx.take(next);
74
+ if (said && here()) E.toast(said, {type: 'success'});
75
+ return next;
76
+ } catch (err) { E.toast(err.message || String(err), {type: 'error'}); return null; }
77
+ };
78
+ const chat = (id) => (s().chats || []).find(c => c.id === id);
79
+
80
+ async function test(id) {
81
+ try { await api.test({chat: id, kind: 'hello'}); E.toast('Sent - look in that chat.', {type: 'success'}); } catch (err) { E.toast(err.message || String(err), {type: 'error'}); }
82
+ }
83
+ async function unlink(id) {
84
+ const c = chat(id);
85
+ if (!c) return;
86
+ const ok = await E.confirm(`Unlink <b>${esc(c.name)}</b>? It stops getting messages from the site, and the chat is told so.`,
87
+ {title: 'Unlink the chat', confirmText: 'Unlink', cancelText: 'Keep it'});
88
+ if (ok && here()) await run(() => api.unlink(id), 'Unlinked.');
89
+ }
90
+ const pause = (id) => { const c = chat(id); if (c) run(() => api.saveChat(id, {paused: !c.paused}), c.paused ? 'Resumed.' : 'Paused - nothing is sent there until you resume it.'); };
91
+
92
+ async function edit(id) {
93
+ const c = chat(id);
94
+ if (!c || panels.has(id)) return;
95
+ if (!manage) { E.toast('Only an administrator can change what a chat gets.', {type: 'info'}); return; }
96
+ const st = s();
97
+ const loaded = routingDraft(c, st);
98
+ let start = loaded;
99
+ const kept = drafts.get(DRAFT(id));
100
+ if (kept?.values && routingPrint(kept.values) !== routingPrint(loaded)) {
101
+ const use = await E.confirm(`You left changes to <b>${esc(c.name)}</b> unsaved. Use them?`, {title: 'Unsaved changes', confirmText: 'Use them', cancelText: 'Throw them away'});
102
+ if (!here()) return;
103
+ if (use) start = {...loaded, ...kept.values};
104
+ }
105
+ drafts.drop(DRAFT(id));
106
+
107
+ const name = M.observable(start.name);
108
+ const alertsOn = M.observable(start.alertsOn);
109
+ const sev = Object.fromEntries(Object.entries(start.severities).map(([k, v]) => [k, M.observable(v)]));
110
+ const allSources = M.observable(start.allSources);
111
+ const sources = (st.sources || []).map(x => ({id: x.id, label: x.label, group: x.ownerLabel, on: M.observable(Boolean(start.sources[x.id]))}));
112
+ const formsOn = M.observable(start.formsOn);
113
+ const allForms = M.observable(start.allForms);
114
+ const forms = (st.forms || []).map(f => ({id: f.slug, label: f.title, on: M.observable(Boolean(start.forms[f.slug]))}));
115
+ const detail = M.observable(start.detail);
116
+ const saving = M.observable(false);
117
+ const values = () => ({
118
+ name: name.peek(), alertsOn: alertsOn.peek(),
119
+ severities: Object.fromEntries(Object.entries(sev).map(([k, o]) => [k, o.peek()])),
120
+ allSources: allSources.peek(), sources: Object.fromEntries(sources.map(x => [x.id, x.on.peek()])),
121
+ formsOn: formsOn.peek(), allForms: allForms.peek(), forms: Object.fromEntries(forms.map(f => [f.id, f.on.peek()])),
122
+ detail: detail.peek()
123
+ });
124
+ const was = routingPrint(loaded);
125
+ const dirty = () => routingPrint(values()) !== was;
126
+
127
+ const html = `<div class="tg-panel">
128
+ <label class="form-label" for="tg-chat-name">Name in this admin <span data-help="Only for you: how this chat is listed here. Telegram does not see it."></span></label>
129
+ <input id="tg-chat-name" class="form-input" maxlength="80" data-model="name.value">
130
+
131
+ <fieldset><legend><label class="tg-check"><input type="checkbox" class="form-checkbox" data-model="alertsOn.value"> Alerts</label>
132
+ <span data-help-title="Alerts" data-help="The notifications the site raises in the bell - a payment failed, the disk is filling, a Tool stopped. Choose how serious they must be, and from which Tools. Notifications meant for one named person (a to-do reminder) are never sent to a chat."></span></legend>
133
+ <div data-bind-hidden="!alertsOn.value" class="tg-stack">
134
+ <div class="tg-bar">${Object.keys(sev).map(k => `<label class="tg-check"><input type="checkbox" class="form-checkbox" data-model="sev.${k}.value"> ${severityLabel(k)}</label>`).join('')}</div>
135
+ <label class="tg-check"><input type="checkbox" class="form-checkbox" data-model="allSources.value"> From every Tool</label>
136
+ <div class="tg-checks" data-bind-hidden="allSources.value" data-each="sourceList.value key=id"><label class="tg-check"><input type="checkbox" class="form-checkbox" data-model="on.value"> <span>{{label}} <small>{{group}}</small></span></label></div>
137
+ </div>
138
+ </fieldset>
139
+
140
+ <fieldset><legend><label class="tg-check"><input type="checkbox" class="form-checkbox" data-model="formsOn.value"> Form submissions</label>
141
+ <span data-help-title="Form submissions" data-help="Each time a visitor sends one of the chosen forms, this chat gets a message with the form's title and a link to its submissions. Passwords, files, images and hidden fields are never sent."></span></legend>
142
+ <div data-bind-hidden="!formsOn.value" class="tg-stack">
143
+ <label class="tg-check"><input type="checkbox" class="form-checkbox" data-model="allForms.value"> Every form, including new ones</label>
144
+ <div class="tg-checks" data-bind-hidden="allForms.value" data-each="formList.value key=id"><label class="tg-check"><input type="checkbox" class="form-checkbox" data-model="on.value"> <span>{{label}}</span></label></div>
145
+ <p class="tg-note" data-bind-hidden="allForms.value || formList.value.length">There are no forms on this site yet.</p>
146
+ <label class="form-label">What the message holds <span data-help="With the answers: each question and what the visitor typed, so the team can act from Telegram. Title and link only: just which form was sent, with a link to read it in the admin - nothing the visitor typed leaves the site."></span></label>
147
+ <label class="tg-check"><input type="radio" name="tg-detail" value="fields" data-model="detail.value"> The form's title, the answers and a link</label>
148
+ <label class="tg-check"><input type="radio" name="tg-detail" value="title" data-model="detail.value"> The form's title and a link only</label>
149
+ </div>
150
+ </fieldset>
151
+
152
+ <div class="tg-actions">
153
+ <span class="tg-spacer"></span>
154
+ <button type="button" class="btn btn-sm btn-ghost" data-on-click="cancel">Cancel</button>
155
+ <button type="button" class="btn btn-sm btn-primary" data-on-click="save" data-bind-disabled="saving.value">Save</button>
156
+ </div>
157
+ </div>`;
158
+ let panel = null;
159
+ const entry = {
160
+ /** The screen has gone: keep the changes as a draft, close without asking. */
161
+ leave() { if (dirty()) drafts.set(DRAFT(id), {values: values(), at: Date.now()}); panel?.close(true); }
162
+ };
163
+ panels.set(id, entry);
164
+ const methods = {
165
+ cancel: () => panel?.close(),
166
+ async save() {
167
+ if (saving.peek()) return;
168
+ saving.value = true;
169
+ try {
170
+ const next = await api.saveChat(id, routingBody(values()));
171
+ ctx.take(next);
172
+ E.toast('Saved.', {type: 'success'});
173
+ panel?.close(true);
174
+ } catch (err) {
175
+ E.toast(`Not saved: ${err.message || err}`, {type: 'error'});
176
+ } finally {
177
+ saving.value = false;
178
+ }
179
+ }
180
+ };
181
+ try {
182
+ panel = await openPanel({title: c.name, size: 'md', html, methods, dirty, busy: () => saving.peek(),
183
+ model: {name, alertsOn, sev, allSources, sourceList: M.observable(sources), formsOn, allForms, formList: M.observable(forms), detail, saving},
184
+ cleanup: () => panels.delete(id)});
185
+ } catch (err) {
186
+ panels.delete(id);
187
+ E.toast(`Not opened: ${err.message || err}`, {type: 'error'});
188
+ }
189
+ }
190
+
191
+ const bindings = M.applyBindings({rows, link, connected, botAt, making}, view, {
192
+ methods: {
193
+ async code() {
194
+ making.value = true;
195
+ await run(() => api.linkCode());
196
+ making.value = false;
197
+ },
198
+ copyCode: () => copy(link.peek().line, 'Copied'),
199
+ async check() {
200
+ const before = (s().chats || []).length;
201
+ const next = await run(() => ctx.reload());
202
+ if (!next) return;
203
+ if ((next.chats || []).length > before) E.toast('Linked.', {type: 'success'});
204
+ else E.toast(next.linkCode ? 'Not linked yet - send the /link line in the chat first.' : 'The code was used or has run out - make a new one.', {type: 'warning'});
205
+ }
206
+ }
207
+ });
208
+ wireRows(list, {
209
+ scope, openMenuAt: kit.openMenuAt, main: edit,
210
+ items: (id) => {
211
+ const c = chat(id);
212
+ if (!c) return [];
213
+ return manage ? [
214
+ {label: 'What it gets…', icon: 'sliders', action: () => edit(id)},
215
+ {label: 'Send a test', icon: 'send', action: () => test(id)},
216
+ {label: c.paused ? 'Resume' : 'Pause', icon: c.paused ? 'play' : 'pause', action: () => pause(id)},
217
+ {type: 'divider'},
218
+ {label: 'Unlink…', icon: 'x', action: () => unlink(id)}
219
+ ] : [{label: 'Only an administrator can change chats', disabled: true}];
220
+ }
221
+ });
222
+ return () => { bindings.dispose(); stop(); };
223
+ }
@@ -0,0 +1,90 @@
1
+ /**
2
+ * Telegram › Connection - the site's own bot, made with @BotFather. The token is typed here once, checked
3
+ * with Telegram, and kept on the server; it is never sent back, and never kept as a draft.
4
+ */
5
+ import {api, esc} from '../lib/kit.js';
6
+ import {connectionView} from '../lib/arrange.js';
7
+
8
+ export async function mount(root, ctx) {
9
+ const {kit, scope, here, status} = ctx;
10
+ const v = M.observable(connectionView(status.peek()));
11
+ const stop = M.effect(() => { v.value = connectionView(status.value); });
12
+ const token = M.observable('');
13
+ const connecting = M.observable(false);
14
+
15
+ root.innerHTML = `<div class="tg-stack">
16
+ <section class="tg-card">
17
+ <header><h3><span data-icon="send" data-icon-size="16"></span> Your bot <span data-help-title="Your own Telegram bot" data-help="The site talks to Telegram through a bot you make yourself with @BotFather, Telegram's own bot for making bots. It is free. The bot sends the team the site's alerts and form submissions, in the chats you link under Chats. Use a bot for this site alone: one bot can only deliver its messages to one place, so a bot already used by Takeaway or another site is refused."></span></h3>
18
+ <span class="tg-chip is-ok" data-bind-hidden="!v.value.connected" data-bind-text="v.value.botAt"></span>
19
+ <span class="tg-chip" data-bind-hidden="v.value.connected">Not connected</span></header>
20
+
21
+ <div class="tg-stack" data-bind-hidden="!v.value.connected">
22
+ <p class="tg-note is-bad" data-bind-hidden="!v.value.hookError" data-bind-text="v.value.hookError"></p>
23
+ <p class="tg-note">Connected as <a target="_blank" rel="noopener" data-bind-href="v.value.botLink" data-bind-text="v.value.botAt"></a>, sending to this site at <b data-bind-text="v.value.base"></b>. <span data-bind-text="v.value.chats"></span>.
24
+ <span data-help="Telegram delivers what people send the bot to this address (its webhook), with a secret only this site knows. If the site moves to a new address, connect the bot again so Telegram follows."></span></p>
25
+ <p class="tg-note" data-bind-hidden="!v.value.pending" data-bind-text="v.value.pending"></p>
26
+ <div class="tg-bar" data-bind-hidden="!v.value.manage">
27
+ <a class="btn btn-sm btn-primary" href="#/plugins/telegram/chats"><span data-icon="users" data-icon-size="13"></span> Link a chat</a>
28
+ <span class="tg-spacer"></span>
29
+ <button type="button" class="btn btn-sm btn-ghost" data-on-click="disconnect">Disconnect the bot</button>
30
+ <span data-help="Disconnecting tells Telegram to stop sending to this site and forgets the token and every linked chat here. The bot itself stays in your Telegram account; delete it with @BotFather if you no longer want it."></span>
31
+ </div>
32
+ </div>
33
+
34
+ <div class="tg-stack" data-bind-hidden="v.value.connected">
35
+ <ol class="tg-steps">
36
+ <li>In Telegram, open <a href="https://t.me/BotFather" target="_blank" rel="noopener">@BotFather</a> and send <code class="tg-code">/newbot</code>.</li>
37
+ <li>Give it a name (like "Acme Alerts") and a username ending in "bot" (like acme_alerts_bot).</li>
38
+ <li>Paste the token it gives you here and click Connect.</li>
39
+ </ol>
40
+ <div class="tg-token" data-bind-hidden="!v.value.manage">
41
+ <input class="form-input" type="password" placeholder="123456789:AAE…" autocomplete="off" aria-label="Bot token" data-model="token.value">
42
+ <button type="button" class="btn btn-sm btn-primary" data-bind-disabled="connecting.value || !token.value" data-on-click="connect" data-bind-text="connecting.value ? 'Connecting…' : 'Connect'"></button>
43
+ <span data-help-title="The bot token" data-help="The long line @BotFather gives you, like 123456789:AAE… It is a password for the bot: anyone with it can send as the bot. It stays on this server and is never shown again, not even to you. If it leaks, send /revoke to @BotFather and connect the new one."></span>
44
+ </div>
45
+ <p class="tg-note" data-bind-hidden="v.value.manage">Ask an administrator to connect the site's bot.</p>
46
+ <p class="tg-note">Telegram can only reach a site on https. The token stays on this server.</p>
47
+ </div>
48
+ </section>
49
+
50
+ <section class="tg-card">
51
+ <header><h3><span data-icon="shield" data-icon-size="16"></span> What is sent to Telegram <span data-help="Telegram keeps messages on its own servers; bot chats are not end-to-end encrypted. Send only what your team may read there."></span></h3></header>
52
+ <ul class="tg-steps">
53
+ <li><b>Alerts</b>: the notification's title, its text, how serious it is, the Tool that raised it and a link to the admin. Notifications meant for one named person (a to-do reminder, say) are never sent.</li>
54
+ <li><b>Form submissions</b>: the form's title and a link to its submissions, and - unless a chat is set to "title and link only" - each answer with its question. Passwords, files, images and hidden fields are never sent.</li>
55
+ <li><b>Nothing else</b> leaves the site, and nothing is sent to a chat that has not been linked with a code from this screen.</li>
56
+ </ul>
57
+ </section></div>`;
58
+ const view = root.firstElementChild;
59
+ scope(kit.helpPopovers(view, {position: 'bottom'}));
60
+ I.scan(view);
61
+
62
+ const bindings = M.applyBindings({v, token, connecting}, view, {
63
+ methods: {
64
+ async connect() {
65
+ if (connecting.peek()) return;
66
+ connecting.value = true;
67
+ try {
68
+ // Refused: the token stays in its box, so a typo is fixed rather than pasted again.
69
+ const next = await api.connect(token.peek().trim(), location.origin);
70
+ if (!here()) return;
71
+ token.value = '';
72
+ ctx.take(next);
73
+ E.toast(`Connected as @${next.botName}.`, {type: 'success'});
74
+ } catch (err) {
75
+ E.toast(err.message || String(err), {type: 'error'});
76
+ } finally {
77
+ connecting.value = false;
78
+ }
79
+ },
80
+ async disconnect() {
81
+ const n = (status.peek()?.chats || []).length;
82
+ const ok = await E.confirm(`Disconnect ${esc(v.peek().botAt)}? Telegram stops sending to this site${n ? ` and the ${n} linked chat${n === 1 ? '' : 's'} stop getting messages` : ''}.`,
83
+ {title: 'Disconnect the bot', confirmText: 'Disconnect', cancelText: 'Keep it'});
84
+ if (!ok || !here()) return;
85
+ try { ctx.take(await api.disconnect()); E.toast('Disconnected.', {type: 'success'}); } catch (err) { E.toast(err.message || String(err), {type: 'error'}); }
86
+ }
87
+ }
88
+ });
89
+ return () => { bindings.dispose(); stop(); };
90
+ }
@@ -0,0 +1,89 @@
1
+ /**
2
+ * Telegram - one Tool, its screens as tabs under the banner:
3
+ *
4
+ * #/plugins/telegram Connection (the bot)
5
+ * #/plugins/telegram/chats Chats (linked chats and what each gets)
6
+ * #/plugins/telegram/test Test (send a sample, or raise a real notification)
7
+ *
8
+ * Path segments, not ?query: the admin router 404s a query on a fresh load. One GET /status feeds every tab;
9
+ * each tab is its own module with mount(root, ctx) -> cleanup, all on domma-reactive bindings.
10
+ */
11
+ import {api, loadKit} from '../lib/kit.js';
12
+
13
+ const ROUTE = /^#\/plugins\/telegram(\/|$)/;
14
+ const TABS = [
15
+ {key: 'connection', label: 'Connection', icon: 'link', module: '/plugins/telegram/admin/views/connection.js'},
16
+ {key: 'chats', label: 'Chats', icon: 'users', module: '/plugins/telegram/admin/views/chats.js'},
17
+ {key: 'test', label: 'Test', icon: 'send', module: '/plugins/telegram/admin/views/test.js', manage: true}
18
+ ];
19
+
20
+ let lifetime = null;
21
+
22
+ const tabFromHash = () => (location.hash.match(/^#\/plugins\/telegram\/([a-z-]+)/)?.[1] || 'connection');
23
+
24
+ export const telegramView = {
25
+ templateUrl: '/plugins/telegram/admin/templates/telegram.html',
26
+
27
+ async onMount($container) {
28
+ const kit = await loadKit();
29
+ lifetime ??= kit.viewLifetime(ROUTE);
30
+ if (!ROUTE.test(location.hash)) return;
31
+ lifetime.reset();
32
+ const scope = (fn) => { lifetime.add(fn); return fn; };
33
+ const container = $container.get(0);
34
+ const root = container.querySelector('[data-tg-admin]') || container;
35
+ const mountedFor = location.hash;
36
+ const here = () => location.hash === mountedFor && root.isConnected;
37
+
38
+ const status = M.observable(null);
39
+ const error = M.observable('');
40
+ const tabs = M.observable([]);
41
+ root.innerHTML = `
42
+ <div class="tg-loading" data-bind-hidden="status.value || error.value">Loading…</div>
43
+ <p class="tg-note is-bad" hidden data-bind-hidden="!error.value" data-bind-text="error.value"></p>
44
+ <nav class="tg-nav" aria-label="Telegram" hidden data-bind-hidden="!status.value" data-each="tabs.value key=key"><a data-bind-href="href" data-bind-class="on ? 'is-on' : ''" data-bind-aria-current="on ? 'page' : false"><span data-bind-text="label"></span></a></nav>
45
+ <div class="tg-body"></div>`;
46
+ const body = root.querySelector('.tg-body');
47
+ const bindings = M.applyBindings({status, error, tabs}, root);
48
+ scope(() => bindings.dispose());
49
+
50
+ let first;
51
+ try {
52
+ first = await api.status();
53
+ } catch (err) {
54
+ if (here()) error.value = `Telegram could not load: ${err.message || err}`;
55
+ return;
56
+ }
57
+ if (!here()) return;
58
+ const shown = TABS.filter(t => !t.manage || first.can?.manage);
59
+ const current = shown.find(t => t.key === tabFromHash()) || shown[0];
60
+ tabs.value = shown.map(t => ({key: t.key, label: t.label, href: t.key === 'connection' ? '#/plugins/telegram' : `#/plugins/telegram/${t.key}`, on: t === current}));
61
+ status.value = first;
62
+
63
+ const ctx = {
64
+ kit, scope, here, container, $container,
65
+ status,
66
+ /** Fetch the status again (after a change) - every tab reads the same observable. */
67
+ async reload() {
68
+ const next = await api.status();
69
+ if (here()) status.value = next;
70
+ kit.sidebarCount('#/plugins/telegram');
71
+ return next;
72
+ },
73
+ /** Take a route's answer (every write answers with the status). */
74
+ take(next) {
75
+ if (next && here()) status.value = next;
76
+ kit.sidebarCount('#/plugins/telegram');
77
+ },
78
+ go(tab) { location.hash = tab === 'connection' ? '#/plugins/telegram' : `#/plugins/telegram/${tab}`; }
79
+ };
80
+ try {
81
+ const mod = await import(current.module);
82
+ if (!here()) return;
83
+ const cleanup = await mod.mount(body, ctx);
84
+ if (typeof cleanup === 'function') scope(cleanup);
85
+ } catch (err) {
86
+ if (here()) error.value = `This screen could not load: ${err.message || err}`;
87
+ }
88
+ }
89
+ };