domma-cms 1.80.0 → 1.81.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 (39) hide show
  1. package/CHANGELOG.md +13 -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 +29 -3
  5. package/admin/js/templates/settings.html +94 -4
  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 +26 -1
  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/server/routes/api/brand-kit.js +55 -0
  34. package/server/routes/api/settings.js +17 -1
  35. package/server/server.js +2 -0
  36. package/server/services/brandKit.js +268 -0
  37. package/server/services/emailBrand.js +31 -13
  38. package/server/services/notify.js +20 -2
  39. package/server/services/plugins.js +3 -0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "domma-cms",
3
- "version": "1.80.0",
3
+ "version": "1.81.0",
4
4
  "description": "File-based CMS powered by Domma and Fastify. Run npx domma-cms my-site to create a new project.",
5
5
  "type": "module",
6
6
  "main": "server/server.js",
@@ -0,0 +1,120 @@
1
+ /**
2
+ * Telegram: the Bot API over fetch (no SDK) - the parts any Tool needs.
3
+ *
4
+ * Lifted from Takeaway's lib/telegram.js (which keeps its own copy and its kitchen and customer wording) for the
5
+ * Telegram and Telegram Pro Tools. A bot is made by the site owner with @BotFather; its token is a secret the Tool
6
+ * keeps on the server and never sends back to the browser. Telegram reaches a Tool through a webhook carrying
7
+ * `X-Telegram-Bot-Api-Secret-Token` (the Tool's own random secret) - check it with `sameSecret`.
8
+ *
9
+ * Nothing here throws at the caller: every call has a timeout, and `call` answers {ok: false, description}.
10
+ * Tests swap the transport with `setTelegram()`, so no test ever reaches Telegram.
11
+ *
12
+ * @module _lib/telegram/bot
13
+ */
14
+ import {randomInt, timingSafeEqual} from 'crypto';
15
+
16
+ const API = 'https://api.telegram.org';
17
+ let transport = null;
18
+
19
+ /** Tests only: `fn(method, body, token)` answers instead of Telegram. Pass null to restore. */
20
+ export function setTelegram(fn) { transport = typeof fn === 'function' ? fn : null; }
21
+
22
+ /**
23
+ * One Bot API call.
24
+ * @param {string} token
25
+ * @param {string} method - 'getMe', 'sendMessage', 'setWebhook', …
26
+ * @param {object} [body]
27
+ * @returns {Promise<{ok: boolean, result?: any, description?: string, error_code?: number, parameters?: object}>}
28
+ */
29
+ export async function call(token, method, body = {}) {
30
+ if (!token) return {ok: false, description: 'No bot token.'};
31
+ try {
32
+ if (transport) return (await transport(method, body, token)) || {ok: false, description: 'No answer.'};
33
+ const res = await fetch(`${API}/bot${token}/${method}`, {method: 'POST', headers: {'Content-Type': 'application/json'},
34
+ body: JSON.stringify(body), signal: AbortSignal.timeout(8000)});
35
+ const json = await res.json().catch(() => ({ok: false, description: `Telegram answered ${res.status}`}));
36
+ return json && typeof json === 'object' ? json : {ok: false, description: 'Telegram sent nothing back.'};
37
+ } catch (err) {
38
+ return {ok: false, description: err?.name === 'TimeoutError' ? 'Telegram did not answer in time.' : (err?.message || String(err))};
39
+ }
40
+ }
41
+
42
+ /** A bot token's shape (123456789:AA…). */
43
+ export const tokenShape = (t) => /^\d{5,15}:[A-Za-z0-9_-]{30,60}$/.test(String(t || '').trim());
44
+
45
+ /** Telegram's HTML is a short whitelist; everything of ours is escaped. Quotes too, for attribute values. */
46
+ export const esc = (s) => String(s ?? '').replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
47
+
48
+ /**
49
+ * Telegram refuses a message over 4096 characters, and refuses the whole message when its HTML does not parse.
50
+ * So text is cut BEFORE it becomes HTML, never after: `escFit` escapes a plain string and stops while the
51
+ * escaped result still fits `max`; `fitLines` joins finished HTML lines whole, dropping the ones that do not fit.
52
+ */
53
+ export const MAX_TEXT = 4000;
54
+
55
+ /** `s` escaped, cut (with "…") so the escaped text is at most `max` characters. Never splits an entity. */
56
+ export function escFit(s, max = MAX_TEXT) {
57
+ const raw = String(s ?? '');
58
+ const whole = esc(raw);
59
+ if (whole.length <= max) return whole;
60
+ let out = '';
61
+ for (const ch of raw) {
62
+ const e = esc(ch);
63
+ if (out.length + e.length > max - 1) break;
64
+ out += e;
65
+ }
66
+ return `${out}…`;
67
+ }
68
+
69
+ /**
70
+ * Finished HTML lines joined with newlines, at most `max` characters. `keep` lines (a link, say) always stay
71
+ * at the end; the others are taken in order while they fit, and a `more` line says something was left out.
72
+ */
73
+ export function fitLines(lines, {max = MAX_TEXT, keep = [], more = '…'} = {}) {
74
+ const tail = keep.filter(Boolean);
75
+ let budget = max - tail.reduce((n, l) => n + l.length + 1, 0);
76
+ const out = [];
77
+ for (let i = 0; i < lines.length; i++) {
78
+ const l = String(lines[i] ?? '');
79
+ const room = budget - (l.length + 1);
80
+ if (room < (i < lines.length - 1 ? more.length + 1 : 0)) { out.push(more); break; }
81
+ out.push(l);
82
+ budget = room;
83
+ }
84
+ return [...out, ...tail].join('\n');
85
+ }
86
+
87
+ /** Plain text cut to `max` characters (for text that is not HTML). */
88
+ export function clip(text, max = MAX_TEXT) {
89
+ const s = String(text ?? '');
90
+ return s.length <= max ? s : `${s.slice(0, max - 1)}…`;
91
+ }
92
+
93
+ export const sendMessage = (token, chatId, text, extra = {}) => call(token, 'sendMessage', {chat_id: chatId, text, parse_mode: 'HTML', disable_web_page_preview: true, ...extra});
94
+
95
+ /**
96
+ * A one-time code: letters and digits only (no look-alikes), as /start payloads and typing allow. From the
97
+ * CSPRNG, never Math.random - a guessed link code would let a stranger's chat receive what the site sends.
98
+ */
99
+ const CODE_CHARS = 'abcdefghjkmnpqrstuvwxyz23456789';
100
+ export const randomCode = (n = 16) => Array.from({length: n}, () => CODE_CHARS[randomInt(CODE_CHARS.length)]).join('');
101
+
102
+ /** "/start o7xk2…" -> {command: 'start', arg: 'o7xk2…'}; also "/link@MyBot code". Not a command -> null. */
103
+ export function parseCommand(text) {
104
+ const m = /^\/([a-z_]+)(?:@\w+)?(?:\s+(\S+))?/i.exec(String(text || '').trim());
105
+ return m ? {command: m[1].toLowerCase(), arg: m[2] || ''} : null;
106
+ }
107
+
108
+ /** Timing-safe: is `given` the non-empty secret `want`? For the webhook header and link codes. */
109
+ export function sameSecret(given, want) {
110
+ const a = Buffer.from(String(given ?? ''));
111
+ const b = Buffer.from(String(want ?? ''));
112
+ return b.length > 0 && a.length === b.length && timingSafeEqual(a, b);
113
+ }
114
+
115
+ /** A chat's name for the admin: the group's title, else the person's name, else @username. */
116
+ export function chatName(chat) {
117
+ if (!chat) return '';
118
+ const s = chat.title || [chat.first_name, chat.last_name].filter(Boolean).join(' ') || (chat.username ? `@${chat.username}` : '') || 'this chat';
119
+ return String(s).slice(0, 80);
120
+ }
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "note": "Written by `make sync-free-tier` in dcms-marketplace. Do not edit these plugins here - edit them there and sync.",
3
- "source": "dcms-marketplace@5d5eabe5",
3
+ "source": "dcms-marketplace@fc42d294",
4
4
  "plugins": {
5
5
  "blog": {
6
6
  "version": "1.11.0",
@@ -347,6 +347,31 @@
347
347
  "tests/shape.test.js": "7866c6c1d140716bf0817449937d6d711d7c3b97be1db1e1eb33bde341e36296"
348
348
  }
349
349
  },
350
+ "telegram": {
351
+ "version": "0.1.0",
352
+ "files": {
353
+ "CHANGELOG.md": "ea40431f37d2e1fad82169952197ae7a3636c8a0e16334c29af171037e13eaae",
354
+ "CLAUDE.md": "620e8133a023bf861b7f4a4b07dd47876ca0622f75f08313b07fd22d2dbbef0b",
355
+ "admin/css/index.css": "39eba0652bf8aad92296f3916d9870c4c6c682a4a6f6183d85c4045992c661e8",
356
+ "admin/lib/arrange.js": "9479d259020b58c40478e37c771efbf7932396df87829333d8cbb6d42bea5f28",
357
+ "admin/lib/kit.js": "63bb373dbb6dd082432470db9f1df155f5322f89f4586c731639c33e863beacf",
358
+ "admin/templates/telegram.html": "081efacde0d270fe8382f5d0bcfe4cac59e5015e8e2193787d0d684fa499b493",
359
+ "admin/views/chats.js": "b5d533e3a0952dbd88a323f08b7e74130e2f5ce410dac6b10f4ed22232ee8573",
360
+ "admin/views/connection.js": "d39834f2c5e3827b083cc56706cd08c87457937ea6e12706df8cea0be1ee38ba",
361
+ "admin/views/telegram.js": "ff38bddd2ae5908874f400750fab8ba8e4080c308444dce7528f12a1373a37ec",
362
+ "admin/views/test.js": "5417a8b0a7427cc1f874886dddbe56d8625652619835b864f6e968eb95c419a7",
363
+ "config.js": "eb508631684a4bf4fc9dd28f0c7837d04b6e54458d8795d01405908cae51b379",
364
+ "docs/guide.md": "c44a50c844e372bcdec9734198ea68c796048cffb6e4fcfa7f9aa874a5cb8a20",
365
+ "lib/messages.js": "5e4eb97a9e48fc8eb89c8c2ad05360e9b46aa909f9cab94147ee46ccf74bd9c5",
366
+ "lib/queue.js": "be269c6b2c4f3a6dfbe23ffd92170aefb70a1d7e27467ec7493ddb022cdebdcb",
367
+ "plugin.js": "fa1b583984b4afda03e553a5c9096ac30734f60203c48874a3631972d22ec670",
368
+ "plugin.json": "93c32b7a419e704fef4ec8791a23bc5f63e0d1bc7b963a1363126b7a8c40142c",
369
+ "tests/api.test.js": "bf1d9842adb8140f018a5ac9f7323dec01e7ee771cba0c52480e074656f87fe6",
370
+ "tests/arrange.test.js": "d90880c4566bde57f59f3a3385a0e9aabfb5b5725b954a06f94ec687a904b56b",
371
+ "tests/messages.test.js": "77b5cb5b700710766a9512a51f3b0dc2bcdb57962f5a325cdf91f68e9f98bc68",
372
+ "tests/queue.test.js": "119217c78be85739b2f4330b6d4026b7c281d7b7e81d4b1f85e13f79163dad51"
373
+ }
374
+ },
350
375
  "theme-roller": {
351
376
  "version": "1.3.0",
352
377
  "files": {
@@ -0,0 +1,5 @@
1
+ # Changelog
2
+
3
+ ## [0.1.0] - 2026-11-19
4
+
5
+ - **New Tool: Telegram (free).** Connect your own Telegram bot and link any number of chats - your team's group or one person's chat with the bot - with a one-time code. Each chat chooses which alerts it gets (how serious, from which Tools) and which forms; a form submission arrives with its answers, or with the form's title and a link only. Passwords, files, images and hidden fields are never sent, nor notifications meant for one person, and a chat gets only what the person who set it up may see in the admin. Tabs: Connection, Chats, Test.
@@ -0,0 +1,77 @@
1
+ # Telegram - AI Assistant Guide
2
+
3
+ Free Tool. Maintained in `dcms-marketplace/plugins/telegram`; the copy in domma-cms is made by `make sync-free-tier`
4
+ (never edit it there). Telegram Pro (`plugins/telegram-pro`, paid) builds on it through the registry below.
5
+
6
+ ## What it does
7
+
8
+ The site's own bot (made with @BotFather) sends the team alerts (`notification:raised`, CMS core) and form
9
+ submissions (`form:submitted`) to linked chats, each with its own routing. Bot API helpers are the engine's
10
+ `plugins/_lib/telegram/bot.js` (shared with Telegram Pro; Takeaway still has its own copy).
11
+
12
+ ## Files
13
+
14
+ - `plugin.js` - routes, the webhook, the listeners, the registry.
15
+ - `lib/messages.js` - PURE: routing (`cleanRouting`, `chatsForAlert`, `chatsForForm`), message text (`alertText`,
16
+ `formText`) and what is never sent (`NEVER_SENT`, `isPersonal`). Every privacy rule lives here.
17
+ - `lib/queue.js` - per-chat queue, ~1 message/s, 429 waited out once, 50 waiting max, never throws. Each message
18
+ carries the token it was queued under (a bot change never sends old messages with the new bot).
19
+ - Message text is built from whole lines with `escFit`/`fitLines` (bot.js): never cut after escaping.
20
+ - `admin/views/telegram.js` - tab shell (Connection, Chats, Test) over one `status` observable.
21
+ - `admin/views/{connection,chats,test}.js` - each `mount(root, ctx)`, domma-reactive throughout.
22
+ - `admin/lib/kit.js` - run-time admin helpers, API, `openPanel` (dirty guard), `wireRows` (menu, Shift+F10, Enter,
23
+ arrows), drafts. Telegram Pro imports it from `/plugins/telegram/admin/lib/kit.js`.
24
+ - `admin/lib/arrange.js` - PURE display strings and the routing panel's draft/body.
25
+ - `docs/guide.md` - the user guide (Documentation > Plugins). Update with behaviour.
26
+
27
+ ## Storage
28
+
29
+ `config/plugins.json` `telegram.settings` (defaults in `config.js`): `botToken`, `botName`, `secret` (webhook),
30
+ `base` (the https origin given at Connect), `linkSecret`/`linkSecretUntil` (named to match the core's secret mask),
31
+ `linkOwnerId`/`linkOwnerName` (who made the live code: the new chat's owner; a Manager staff session never owns),
32
+ `chats: [{id, chatId, name, type, linkedAt, paused, lastError, lastSentAt, alerts, forms}]`. Written only by this
33
+ Tool's routes. The token, secret and link code are never in a reply; the link code only to `manage`.
34
+
35
+ ## Routes (/api/plugins/telegram; permission `telegram`: read / manage)
36
+
37
+ | Method | Path | Who | Purpose |
38
+ |---|---|---|---|
39
+ | GET | /status | read | bot, webhook health, chats, forms, sources; link code to manage only |
40
+ | GET | /count | read | badge: linked chats (inventory), red on a webhook problem or a failed send |
41
+ | POST | /connect | manage | `{token, base}`: getMe, getWebhookInfo (refuses a bot whose webhook points elsewhere), setWebhook with a secret |
42
+ | DELETE | /connection | manage | deleteWebhook, forget token, secret and chats |
43
+ | POST | /link-code | manage | one-time code: 16 chars, 15 min, burnt after 5 wrong tries |
44
+ | PUT | /chats/:id | manage | `{name, paused, alerts, forms}` through `cleanRouting` |
45
+ | DELETE | /chats/:id | manage | unlink (the chat is told) |
46
+ | POST | /test | manage | `{kind: hello|alert|form|notification, chat, form, severity}` |
47
+ | POST | /webhook | Telegram | `X-Telegram-Bot-Api-Secret-Token` checked timing-safe, else 401 |
48
+
49
+ The webhook answers 200 at once and handles updates one at a time per chat on a promise chain (100 waiting max per chat) (`awaitUpdates: true` in
50
+ tests makes the route wait); `update_id`s are remembered (last 500), so Telegram's resends do nothing.
51
+ Webhook commands: `/link <code>`, `/unlink` (in a linked chat); without Pro also `/start` (private) and `/help`.
52
+ Wrong link codes: 5 per chat (then that chat is ignored for that code), 50 in all burn it.
53
+ `migrate_to_chat_id` moves a linked group to its supergroup id. Everything else goes to the registry handlers.
54
+
55
+ ## Registry (Telegram Pro)
56
+
57
+ `globalThis[Symbol.for('domma.telegram')]` = `{version: 1, handlers, register(name, {onMessage}), unregister(name),
58
+ services}`. `onMessage(msg, {command, linked})` resolves true when it took the update. `services`: `ready()`,
59
+ `botName()`, `base()`, `siteName()`, `chats()` (no token), `send(chatId, html, extra)` (queued, resolves to
60
+ Telegram's answer, never rejects), `esc`.
61
+
62
+ ## Gotchas
63
+
64
+ - The core bus has no `off`: the listeners are added once per process (`listening`) and call the live instance.
65
+ - Owners: a chat has `ownerId`/`ownerName` - who made its link code, then who last changed its alerts or forms.
66
+ Alerts go only if `inAudience(data.audience, owner)` (core notify.js); forms only if the owner holds
67
+ `collections.read` and `canSeeArtefact(owner, form)` (projects). Owners are read fresh (`getUserById`, 60 s cache);
68
+ a deleted or inactive owner stops the chat. `PUT /chats/:id` with forms on needs `collections.read` and keeps only
69
+ slugs the caller can see; `GET /status` lists only those forms.
70
+ - Manager-pushed and sample notifications are written straight to the store, not through `notify()`, so they never
71
+ reach `notification:raised`.
72
+ - A notification with `audience.userIds` is personal and never sent. Form fields: only those the form defines;
73
+ never `password`, `file`, `image`, `hidden`, layout types, or a name like password/secret/token; an object value
74
+ (a file ref) is never sent. A deleted form sends title and link only.
75
+ - `notification:raised` arrives with CMS core's emit (domma-cms PR, notify.js). On an older CMS alerts simply
76
+ do not arrive; forms still do. `_lib/telegram/bot.js` must be in the CMS for the Tool to load at all.
77
+ - Tests: `tests/*.test.js`, Telegram swapped by `setTelegram`; never a real call.
@@ -0,0 +1,68 @@
1
+ /* Telegram (and Telegram Pro) admin. Theme tokens only, so light, dark and Theme Roller themes all read right. */
2
+
3
+ .tg [hidden], .tg-panel [hidden] { display: none !important; }
4
+ .tg { max-width: 64rem; display: flex; flex-direction: column; gap: 1rem; }
5
+ .tg-stack { display: flex; flex-direction: column; gap: 1rem; }
6
+
7
+ /* Tabs under the banner */
8
+ .tg-nav { display: flex; flex-wrap: wrap; gap: .15rem; border-bottom: 1px solid var(--dm-border); }
9
+ .tg-nav a { display: inline-flex; align-items: center; gap: .4rem; padding: .5rem .85rem; color: var(--dm-text-secondary); text-decoration: none;
10
+ font-size: var(--dm-font-size-sm); font-weight: 500; border-bottom: 2px solid transparent; margin-bottom: -1px; }
11
+ .tg-nav a:hover { color: var(--dm-text); background: var(--dm-hover-bg); }
12
+ .tg-nav a.is-on { color: var(--dm-primary); border-bottom-color: var(--dm-primary); font-weight: 600; }
13
+
14
+ /* Cards */
15
+ .tg-card { background: var(--dm-surface); border: 1px solid var(--dm-border); border-radius: var(--dm-radius-lg); padding: 1rem 1.1rem;
16
+ display: flex; flex-direction: column; gap: .7rem; min-width: 0; }
17
+ .tg-card > header { display: flex; align-items: center; justify-content: space-between; gap: .5rem; flex-wrap: wrap; }
18
+ .tg-card h3 { margin: 0; font-size: 1.05rem; display: inline-flex; align-items: center; gap: .45rem; }
19
+ .tg-card h4 { margin: .4rem 0 0; font-size: .95rem; display: inline-flex; align-items: center; gap: .4rem; }
20
+ .tg-bar { display: flex; align-items: center; gap: .5rem; flex-wrap: wrap; }
21
+ .tg-spacer { flex: 1; }
22
+
23
+ .tg-note { margin: 0; color: var(--dm-text-secondary); font-size: var(--dm-font-size-sm); }
24
+ .tg-note.is-bad { color: var(--dm-danger); }
25
+ .tg-note.is-warn { color: var(--dm-text); background: color-mix(in srgb, var(--dm-warning) 14%, transparent); border-radius: var(--dm-radius-md); padding: .45rem .7rem; }
26
+ .tg-loading { color: var(--dm-text-secondary); font-size: var(--dm-font-size-sm); padding: .5rem 0; }
27
+ .tg-steps { margin: 0; padding-left: 1.3rem; display: flex; flex-direction: column; gap: .4rem; }
28
+ .tg-code { font-family: var(--dm-font-mono, monospace); padding: .1rem .4rem; border-radius: var(--dm-radius-md);
29
+ background: color-mix(in srgb, var(--dm-text-secondary) 14%, transparent); user-select: all; }
30
+ .tg-token { display: flex; gap: .5rem; flex-wrap: wrap; }
31
+ .tg-token input { flex: 1; min-width: 16rem; font-family: var(--dm-font-mono, monospace); }
32
+
33
+ .tg-chip { font-size: var(--dm-font-size-xs); font-weight: 600; padding: .12rem .55rem; border-radius: var(--dm-radius-full); white-space: nowrap;
34
+ background: color-mix(in srgb, var(--dm-text-secondary) 14%, transparent); color: var(--dm-text); }
35
+ .tg-chip.is-ok { background: color-mix(in srgb, var(--dm-success) 20%, transparent); }
36
+ .tg-chip.is-warn { background: color-mix(in srgb, var(--dm-warning) 22%, transparent); }
37
+ .tg-chip.is-bad { background: color-mix(in srgb, var(--dm-danger) 20%, transparent); }
38
+
39
+ /* Rows (chats; Pro's conversations) */
40
+ .tg-list { display: flex; flex-direction: column; }
41
+ .tg-row { display: flex; align-items: center; gap: .75rem; padding: .6rem .5rem; border-top: 1px solid var(--dm-border); cursor: pointer; border-radius: var(--dm-radius-md); }
42
+ .tg-row:first-child { border-top: 0; }
43
+ .tg-row:hover, .tg-row:focus-visible { background: var(--dm-hover-bg); outline: none; }
44
+ .tg-row.is-on { background: var(--dm-primary-light); }
45
+ .tg-main { flex: 1; min-width: 0; display: flex; flex-direction: column; gap: .1rem; }
46
+ .tg-main strong { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
47
+ .tg-main small { color: var(--dm-text-secondary); font-size: var(--dm-font-size-xs); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
48
+ .tg-main small.is-bad { color: var(--dm-danger); }
49
+ .tg-kebab { border: 0; background: none; color: var(--dm-text-secondary); cursor: pointer; font-size: 1.1rem; padding: 0 .35rem; border-radius: var(--dm-radius-md); }
50
+ .tg-kebab:hover { background: var(--dm-hover-bg); color: var(--dm-text); }
51
+ .tg-dot { width: .55rem; height: .55rem; border-radius: 50%; background: var(--dm-primary); flex: none; }
52
+ .tg-empty { text-align: center; padding: 2rem 1rem; color: var(--dm-text-secondary); }
53
+ .tg-empty h3 { justify-content: center; margin-bottom: .4rem; color: var(--dm-text); }
54
+
55
+ /* Panels */
56
+ .tg-panel { display: flex; flex-direction: column; gap: .55rem; padding: .25rem 0; }
57
+ .tg-panel fieldset { border: 1px solid var(--dm-border); border-radius: var(--dm-radius-md); padding: .6rem .8rem; margin: 0; display: flex; flex-direction: column; gap: .4rem; }
58
+ .tg-panel legend { font-weight: 600; padding: 0 .3rem; display: inline-flex; align-items: center; gap: .35rem; }
59
+ .tg-check { display: flex; align-items: center; gap: .45rem; font-size: var(--dm-font-size-sm); }
60
+ .tg-checks { display: grid; grid-template-columns: repeat(auto-fill, minmax(12rem, 1fr)); gap: .25rem .8rem; max-height: 14rem; overflow: auto; }
61
+ .tg-checks small { color: var(--dm-text-secondary); }
62
+ .tg-actions { display: flex; gap: .5rem; align-items: center; margin-top: .6rem; }
63
+
64
+ /* Test */
65
+ .tg-test { display: grid; grid-template-columns: minmax(10rem, 16rem) 1fr; gap: .6rem 1rem; align-items: center; }
66
+ @media (max-width: 640px) { .tg-test { grid-template-columns: 1fr; } }
67
+
68
+ .tg .btn { display: inline-flex; align-items: center; gap: .35rem; }
@@ -0,0 +1,103 @@
1
+ /**
2
+ * Telegram admin - display strings and row shapes. PURE (no DOM, no globals), so the views hold observables,
3
+ * bindings and API calls only, and this is tested (tests/arrange.test.js).
4
+ *
5
+ * @module telegram/admin/lib/arrange
6
+ */
7
+
8
+ const SEV_LABEL = {info: 'Info', success: 'Success', warning: 'Warning', critical: 'Critical'};
9
+ const TYPE_LABEL = {private: 'Person', group: 'Group', supergroup: 'Group', channel: 'Channel'};
10
+
11
+ export const severityLabel = (s) => SEV_LABEL[s] || s;
12
+ export const typeLabel = (t) => TYPE_LABEL[t] || 'Chat';
13
+
14
+ const plural = (n, one, many = `${one}s`) => `${n} ${n === 1 ? one : many}`;
15
+
16
+ /** "Warning and critical alerts from every Tool" / "No alerts". */
17
+ export function alertsSummary(alerts, sources = []) {
18
+ if (!alerts?.on || !alerts.severities?.length) return 'No alerts';
19
+ const sev = alerts.severities.map(severityLabel);
20
+ const list = sev.length === 4 ? 'All alerts' : `${sev.length > 1 ? `${sev.slice(0, -1).join(', ')} and ${sev.at(-1).toLowerCase()}` : sev[0]} alerts`;
21
+ if (!alerts.sources?.length) return `${list} from every Tool`;
22
+ const names = alerts.sources.map(id => sources.find(s => s.id === id)?.label || sources.find(s => s.owner === id)?.ownerLabel || id);
23
+ return `${list} from ${names.length <= 2 ? names.join(' and ') : plural(names.length, 'source')}`;
24
+ }
25
+
26
+ /** "Every form, with the answers" / "2 forms, title and link only" / "No forms". */
27
+ export function formsSummary(forms, all = []) {
28
+ if (!forms?.on || (!forms.all && !forms.slugs?.length)) return 'No forms';
29
+ const how = forms.detail === 'title' ? 'title and link only' : 'with the answers';
30
+ if (forms.all) return `Every form, ${how}`;
31
+ const names = forms.slugs.map(s => all.find(f => f.slug === s)?.title || s);
32
+ return `${names.length <= 2 ? names.join(' and ') : plural(names.length, 'form')}, ${how}`;
33
+ }
34
+
35
+ /** One row of the Chats list. */
36
+ export function chatRow(c, {sources = [], forms = []} = {}) {
37
+ return {
38
+ id: c.id,
39
+ name: c.name,
40
+ type: typeLabel(c.type),
41
+ alerts: alertsSummary(c.alerts, sources),
42
+ forms: formsSummary(c.forms, forms),
43
+ paused: Boolean(c.paused),
44
+ problem: c.lastError ? `Last message not sent: ${c.lastError}` : '',
45
+ owner: c.ownerName ? `Gets what ${c.ownerName} may see` : 'No owner - open it and save to choose what it gets',
46
+ title: `${c.name} - ${typeLabel(c.type)}`
47
+ };
48
+ }
49
+
50
+ /** The Connection tab's state, from GET /status. */
51
+ export function connectionView(st = {}) {
52
+ const w = st.webhook || null;
53
+ let hook = '';
54
+ if (st.connected && w) {
55
+ if (w.error) hook = `Telegram did not answer: ${w.error}`;
56
+ else if (!w.ours) hook = w.url ? 'The bot now sends its messages somewhere else - another Tool or site took it over. Connect it again, or use a second bot.' : 'The bot has no webhook - connect it again.';
57
+ else if (w.lastError && w.lastErrorAt && Date.now() - Date.parse(w.lastErrorAt) < 3600_000) hook = `Telegram could not reach this site: ${w.lastError}`;
58
+ }
59
+ return {
60
+ connected: Boolean(st.connected),
61
+ botAt: st.botName ? `@${st.botName}` : '',
62
+ botLink: st.botName ? `https://t.me/${st.botName}` : '',
63
+ base: st.base || '',
64
+ hookError: hook,
65
+ pending: w?.pending ? plural(w.pending, 'update') + ' waiting' : '',
66
+ chats: plural((st.chats || []).length, 'linked chat'),
67
+ manage: Boolean(st.can?.manage)
68
+ };
69
+ }
70
+
71
+ /** The "Link a chat" steps. */
72
+ export function linkView(st = {}) {
73
+ const code = st.linkCode || '';
74
+ return {code, line: code ? `/link ${code}` : '', until: st.linkCodeUntil || ''};
75
+ }
76
+
77
+ /** The routing panel's starting values, as strings and booleans the bindings can hold. */
78
+ export function routingDraft(c, {sources = [], forms = []} = {}) {
79
+ return {
80
+ name: c.name || '',
81
+ alertsOn: Boolean(c.alerts?.on),
82
+ severities: Object.fromEntries(Object.keys(SEV_LABEL).map(s => [s, (c.alerts?.severities || []).includes(s)])),
83
+ allSources: !(c.alerts?.sources || []).length,
84
+ sources: Object.fromEntries(sources.map(s => [s.id, (c.alerts?.sources || []).includes(s.id)])),
85
+ formsOn: Boolean(c.forms?.on),
86
+ allForms: Boolean(c.forms?.all),
87
+ forms: Object.fromEntries(forms.map(f => [f.slug, (c.forms?.slugs || []).includes(f.slug)])),
88
+ detail: c.forms?.detail === 'title' ? 'title' : 'fields'
89
+ };
90
+ }
91
+
92
+ /** The routing panel's values -> the PUT /chats/:id body. */
93
+ export function routingBody(d) {
94
+ const picked = (o) => Object.entries(o || {}).filter(([, v]) => v).map(([k]) => k);
95
+ return {
96
+ name: String(d.name || '').trim(),
97
+ alerts: {on: Boolean(d.alertsOn), severities: picked(d.severities), sources: d.allSources ? [] : picked(d.sources)},
98
+ forms: {on: Boolean(d.formsOn), all: Boolean(d.allForms), slugs: d.allForms ? [] : picked(d.forms), detail: d.detail === 'title' ? 'title' : 'fields'}
99
+ };
100
+ }
101
+
102
+ /** A fingerprint of routing values, to tell a changed panel from an untouched one. */
103
+ export const routingPrint = (d) => JSON.stringify(routingBody(d));
@@ -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>