sendproof-core 0.1.0.alpha.1

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 (229) hide show
  1. checksums.yaml +7 -0
  2. data/LICENSE +21 -0
  3. data/README.md +55 -0
  4. data/lib/sendproof/assets.rb +70 -0
  5. data/lib/sendproof/attribution.rb +98 -0
  6. data/lib/sendproof/capture.rb +66 -0
  7. data/lib/sendproof/clock.rb +54 -0
  8. data/lib/sendproof/configuration.rb +241 -0
  9. data/lib/sendproof/data_store.rb +34 -0
  10. data/lib/sendproof/dynamodb/store.rb +183 -0
  11. data/lib/sendproof/dynamodb.rb +17 -0
  12. data/lib/sendproof/elasticsearch/store.rb +24 -0
  13. data/lib/sendproof/elasticsearch.rb +17 -0
  14. data/lib/sendproof/firestore/interceptor.rb +38 -0
  15. data/lib/sendproof/firestore/store.rb +150 -0
  16. data/lib/sendproof/firestore.rb +99 -0
  17. data/lib/sendproof/handler.rb +23 -0
  18. data/lib/sendproof/identity.rb +37 -0
  19. data/lib/sendproof/limits.rb +113 -0
  20. data/lib/sendproof/middleware.rb +68 -0
  21. data/lib/sendproof/mongo/engine.rb +692 -0
  22. data/lib/sendproof/mongo/guarded.rb +100 -0
  23. data/lib/sendproof/mongo/plain.rb +45 -0
  24. data/lib/sendproof/mongo/store.rb +54 -0
  25. data/lib/sendproof/mongo/subscriber.rb +21 -0
  26. data/lib/sendproof/mongo.rb +41 -0
  27. data/lib/sendproof/mongoid/store.rb +58 -0
  28. data/lib/sendproof/mongoid.rb +65 -0
  29. data/lib/sendproof/observed_request.rb +108 -0
  30. data/lib/sendproof/opensearch/store.rb +21 -0
  31. data/lib/sendproof/opensearch.rb +17 -0
  32. data/lib/sendproof/operation_matcher.rb +28 -0
  33. data/lib/sendproof/pool_hooks.rb +80 -0
  34. data/lib/sendproof/preview_request.rb +44 -0
  35. data/lib/sendproof/preview_transport.rb +331 -0
  36. data/lib/sendproof/protocol.rb +81 -0
  37. data/lib/sendproof/provider.rb +83 -0
  38. data/lib/sendproof/recorder.rb +298 -0
  39. data/lib/sendproof/redaction.rb +98 -0
  40. data/lib/sendproof/redis/commands.rb +76 -0
  41. data/lib/sendproof/redis/store.rb +205 -0
  42. data/lib/sendproof/redis.rb +18 -0
  43. data/lib/sendproof/search/middleware.rb +39 -0
  44. data/lib/sendproof/search/store.rb +213 -0
  45. data/lib/sendproof/search.rb +82 -0
  46. data/lib/sendproof/stores/classify.rb +346 -0
  47. data/lib/sendproof/stores/guard.rb +127 -0
  48. data/lib/sendproof/stores/tables.rb +1328 -0
  49. data/lib/sendproof/stores.rb +12 -0
  50. data/lib/sendproof/trace_store.rb +110 -0
  51. data/lib/sendproof/transaction_control.rb +187 -0
  52. data/lib/sendproof/ui/action-bar.js +91 -0
  53. data/lib/sendproof/ui/api.js +239 -0
  54. data/lib/sendproof/ui/app.css +848 -0
  55. data/lib/sendproof/ui/app.js +742 -0
  56. data/lib/sendproof/ui/autofill.js +137 -0
  57. data/lib/sendproof/ui/code-copy.js +71 -0
  58. data/lib/sendproof/ui/code-picker.js +149 -0
  59. data/lib/sendproof/ui/commands.js +197 -0
  60. data/lib/sendproof/ui/components.js +77 -0
  61. data/lib/sendproof/ui/context-bar.js +82 -0
  62. data/lib/sendproof/ui/copy.js +92 -0
  63. data/lib/sendproof/ui/coverage-popover.js +35 -0
  64. data/lib/sendproof/ui/crumb-fit.js +80 -0
  65. data/lib/sendproof/ui/deprecation.js +164 -0
  66. data/lib/sendproof/ui/display-settings.js +175 -0
  67. data/lib/sendproof/ui/doc-diff.js +209 -0
  68. data/lib/sendproof/ui/docs-view.js +347 -0
  69. data/lib/sendproof/ui/favicon.png +0 -0
  70. data/lib/sendproof/ui/favicon.svg +1 -0
  71. data/lib/sendproof/ui/field-help.js +52 -0
  72. data/lib/sendproof/ui/field-modules.js +23 -0
  73. data/lib/sendproof/ui/fields/controls.js +179 -0
  74. data/lib/sendproof/ui/fields/dom.js +36 -0
  75. data/lib/sendproof/ui/fields/infer.js +71 -0
  76. data/lib/sendproof/ui/fields/lookup-source.js +63 -0
  77. data/lib/sendproof/ui/fields/lookup.js +285 -0
  78. data/lib/sendproof/ui/fields/render.js +496 -0
  79. data/lib/sendproof/ui/fields/select.js +175 -0
  80. data/lib/sendproof/ui/fields/validate.js +363 -0
  81. data/lib/sendproof/ui/fields/validation-formats.js +164 -0
  82. data/lib/sendproof/ui/fields/validation-references.js +68 -0
  83. data/lib/sendproof/ui/fields/validation-values.js +137 -0
  84. data/lib/sendproof/ui/generate-menu.js +44 -0
  85. data/lib/sendproof/ui/generate.js +184 -0
  86. data/lib/sendproof/ui/header-editor.js +777 -0
  87. data/lib/sendproof/ui/headers.js +188 -0
  88. data/lib/sendproof/ui/highlight.js +257 -0
  89. data/lib/sendproof/ui/history-popover.js +24 -0
  90. data/lib/sendproof/ui/i18n.js +253 -0
  91. data/lib/sendproof/ui/icons.js +87 -0
  92. data/lib/sendproof/ui/index.html +70 -0
  93. data/lib/sendproof/ui/issues.js +187 -0
  94. data/lib/sendproof/ui/json-view.js +166 -0
  95. data/lib/sendproof/ui/lang-icons.js +62 -0
  96. data/lib/sendproof/ui/layout.js +262 -0
  97. data/lib/sendproof/ui/listbox.js +334 -0
  98. data/lib/sendproof/ui/locales/ar-capture.js +366 -0
  99. data/lib/sendproof/ui/locales/ar-stores.js +116 -0
  100. data/lib/sendproof/ui/locales/ar.js +561 -0
  101. data/lib/sendproof/ui/locales/cs-capture.js +442 -0
  102. data/lib/sendproof/ui/locales/cs-stores.js +116 -0
  103. data/lib/sendproof/ui/locales/cs.js +689 -0
  104. data/lib/sendproof/ui/locales/da-capture.js +347 -0
  105. data/lib/sendproof/ui/locales/da-stores.js +116 -0
  106. data/lib/sendproof/ui/locales/da.js +522 -0
  107. data/lib/sendproof/ui/locales/de-capture.js +347 -0
  108. data/lib/sendproof/ui/locales/de-stores.js +116 -0
  109. data/lib/sendproof/ui/locales/de.js +519 -0
  110. data/lib/sendproof/ui/locales/el-capture.js +347 -0
  111. data/lib/sendproof/ui/locales/el-stores.js +116 -0
  112. data/lib/sendproof/ui/locales/el.js +520 -0
  113. data/lib/sendproof/ui/locales/en-capture.js +349 -0
  114. data/lib/sendproof/ui/locales/en-stores.js +95 -0
  115. data/lib/sendproof/ui/locales/en.js +522 -0
  116. data/lib/sendproof/ui/locales/es-capture.js +353 -0
  117. data/lib/sendproof/ui/locales/es-stores.js +116 -0
  118. data/lib/sendproof/ui/locales/es.js +525 -0
  119. data/lib/sendproof/ui/locales/fa-capture.js +348 -0
  120. data/lib/sendproof/ui/locales/fa-stores.js +116 -0
  121. data/lib/sendproof/ui/locales/fa.js +521 -0
  122. data/lib/sendproof/ui/locales/fi-capture.js +347 -0
  123. data/lib/sendproof/ui/locales/fi-stores.js +116 -0
  124. data/lib/sendproof/ui/locales/fi.js +523 -0
  125. data/lib/sendproof/ui/locales/fr-capture.js +353 -0
  126. data/lib/sendproof/ui/locales/fr-stores.js +116 -0
  127. data/lib/sendproof/ui/locales/fr.js +525 -0
  128. data/lib/sendproof/ui/locales/he-capture.js +358 -0
  129. data/lib/sendproof/ui/locales/he-stores.js +116 -0
  130. data/lib/sendproof/ui/locales/he.js +529 -0
  131. data/lib/sendproof/ui/locales/hi-capture.js +348 -0
  132. data/lib/sendproof/ui/locales/hi-stores.js +116 -0
  133. data/lib/sendproof/ui/locales/hi.js +523 -0
  134. data/lib/sendproof/ui/locales/id-capture.js +347 -0
  135. data/lib/sendproof/ui/locales/id-stores.js +116 -0
  136. data/lib/sendproof/ui/locales/id.js +521 -0
  137. data/lib/sendproof/ui/locales/it-capture.js +361 -0
  138. data/lib/sendproof/ui/locales/it-stores.js +116 -0
  139. data/lib/sendproof/ui/locales/it.js +523 -0
  140. data/lib/sendproof/ui/locales/ja-capture.js +346 -0
  141. data/lib/sendproof/ui/locales/ja-stores.js +116 -0
  142. data/lib/sendproof/ui/locales/ja.js +521 -0
  143. data/lib/sendproof/ui/locales/ko-capture.js +346 -0
  144. data/lib/sendproof/ui/locales/ko-stores.js +116 -0
  145. data/lib/sendproof/ui/locales/ko.js +522 -0
  146. data/lib/sendproof/ui/locales/nb-capture.js +349 -0
  147. data/lib/sendproof/ui/locales/nb-stores.js +116 -0
  148. data/lib/sendproof/ui/locales/nb.js +521 -0
  149. data/lib/sendproof/ui/locales/nl-capture.js +355 -0
  150. data/lib/sendproof/ui/locales/nl-stores.js +116 -0
  151. data/lib/sendproof/ui/locales/nl.js +520 -0
  152. data/lib/sendproof/ui/locales/pl-capture.js +432 -0
  153. data/lib/sendproof/ui/locales/pl-stores.js +116 -0
  154. data/lib/sendproof/ui/locales/pl.js +528 -0
  155. data/lib/sendproof/ui/locales/pt-BR-capture.js +350 -0
  156. data/lib/sendproof/ui/locales/pt-BR-stores.js +116 -0
  157. data/lib/sendproof/ui/locales/pt-BR.js +523 -0
  158. data/lib/sendproof/ui/locales/pt-PT-capture.js +350 -0
  159. data/lib/sendproof/ui/locales/pt-PT-stores.js +116 -0
  160. data/lib/sendproof/ui/locales/pt-PT.js +523 -0
  161. data/lib/sendproof/ui/locales/ru-capture.js +437 -0
  162. data/lib/sendproof/ui/locales/ru-stores.js +116 -0
  163. data/lib/sendproof/ui/locales/ru.js +624 -0
  164. data/lib/sendproof/ui/locales/sv-capture.js +349 -0
  165. data/lib/sendproof/ui/locales/sv-stores.js +116 -0
  166. data/lib/sendproof/ui/locales/sv.js +518 -0
  167. data/lib/sendproof/ui/locales/th-capture.js +347 -0
  168. data/lib/sendproof/ui/locales/th-stores.js +116 -0
  169. data/lib/sendproof/ui/locales/th.js +521 -0
  170. data/lib/sendproof/ui/locales/tr-capture.js +348 -0
  171. data/lib/sendproof/ui/locales/tr-stores.js +116 -0
  172. data/lib/sendproof/ui/locales/tr.js +521 -0
  173. data/lib/sendproof/ui/locales/uk-capture.js +442 -0
  174. data/lib/sendproof/ui/locales/uk-stores.js +116 -0
  175. data/lib/sendproof/ui/locales/uk.js +630 -0
  176. data/lib/sendproof/ui/locales/vi-capture.js +346 -0
  177. data/lib/sendproof/ui/locales/vi-stores.js +116 -0
  178. data/lib/sendproof/ui/locales/vi.js +523 -0
  179. data/lib/sendproof/ui/locales/zh-Hans-capture.js +347 -0
  180. data/lib/sendproof/ui/locales/zh-Hans-stores.js +116 -0
  181. data/lib/sendproof/ui/locales/zh-Hans.js +523 -0
  182. data/lib/sendproof/ui/locales/zh-Hant-capture.js +346 -0
  183. data/lib/sendproof/ui/locales/zh-Hant-stores.js +116 -0
  184. data/lib/sendproof/ui/locales/zh-Hant.js +522 -0
  185. data/lib/sendproof/ui/manifest.json +866 -0
  186. data/lib/sendproof/ui/markdown.js +39 -0
  187. data/lib/sendproof/ui/model-view.js +182 -0
  188. data/lib/sendproof/ui/navigation.js +233 -0
  189. data/lib/sendproof/ui/operation-header.js +76 -0
  190. data/lib/sendproof/ui/operations.js +7 -0
  191. data/lib/sendproof/ui/overview-view.js +63 -0
  192. data/lib/sendproof/ui/personas.js +59 -0
  193. data/lib/sendproof/ui/popover.js +71 -0
  194. data/lib/sendproof/ui/preview-false.js +108 -0
  195. data/lib/sendproof/ui/request-editor.js +496 -0
  196. data/lib/sendproof/ui/response-metadata.js +354 -0
  197. data/lib/sendproof/ui/response-viewer.js +618 -0
  198. data/lib/sendproof/ui/result-blocked.js +155 -0
  199. data/lib/sendproof/ui/result-capture.js +25 -0
  200. data/lib/sendproof/ui/result-database.js +185 -0
  201. data/lib/sendproof/ui/result-effects.js +176 -0
  202. data/lib/sendproof/ui/result-headers.js +106 -0
  203. data/lib/sendproof/ui/result-logs.js +408 -0
  204. data/lib/sendproof/ui/result-states.js +213 -0
  205. data/lib/sendproof/ui/results.js +371 -0
  206. data/lib/sendproof/ui/router.js +118 -0
  207. data/lib/sendproof/ui/schema-model.js +336 -0
  208. data/lib/sendproof/ui/schema-tree.js +344 -0
  209. data/lib/sendproof/ui/schema.js +397 -0
  210. data/lib/sendproof/ui/security.js +31 -0
  211. data/lib/sendproof/ui/seeded-menu.js +69 -0
  212. data/lib/sendproof/ui/settings.js +93 -0
  213. data/lib/sendproof/ui/shortcuts-sheet.js +73 -0
  214. data/lib/sendproof/ui/shortcuts.js +190 -0
  215. data/lib/sendproof/ui/sidebar.js +289 -0
  216. data/lib/sendproof/ui/signin.js +259 -0
  217. data/lib/sendproof/ui/snippets.js +530 -0
  218. data/lib/sendproof/ui/store-marks.js +47 -0
  219. data/lib/sendproof/ui/stores.js +131 -0
  220. data/lib/sendproof/ui/styles.css +971 -0
  221. data/lib/sendproof/ui/toggletip.js +53 -0
  222. data/lib/sendproof/ui/uuid.js +10 -0
  223. data/lib/sendproof/ui/view.js +122 -0
  224. data/lib/sendproof/ui/views.css +653 -0
  225. data/lib/sendproof/version.rb +9 -0
  226. data/lib/sendproof/workbench.rb +102 -0
  227. data/lib/sendproof-core.rb +3 -0
  228. data/lib/sendproof.rb +121 -0
  229. metadata +292 -0
@@ -0,0 +1,155 @@
1
+ // "Preview unavailable", caught mid-request (mocks 124, 125, 129, 131, m30, m31): the write guard
2
+ // refused a command to a store that can't roll back, so the binding answered 409 with a
3
+ // problem+json body (spec/preview-unavailable.schema.json). It is a designed result in amber, not
4
+ // a red error: what was blocked, that nothing was written (store by store), what to do next, and
5
+ // the body itself. Data (commands, store ids, JSON) stays left to right in every language.
6
+ import { copyTextButton, esc, icon, stateBlock } from './components.js';
7
+ import { formatDuration, t, th } from './i18n.js';
8
+ import { shortcutAttrs, shortcutHint } from './shortcuts.js';
9
+ import { copyText } from './copy.js';
10
+ import { authorReason, dataStore, dataStores, sqlSystem, storeMark, storeName } from './stores.js';
11
+ import { PREVIEW_FALSE_LANGUAGES, bindingOf, chooseLanguage, chosenLanguage, languageName, previewFalseSnippet } from './preview-false.js';
12
+
13
+ const databaseName = capabilities => typeof capabilities?.database === 'string' ? capabilities.database : capabilities?.database?.name;
14
+
15
+ /** The head row: Preview, "409 Preview unavailable" in amber, the time, Copy as cURL and Send for real. */
16
+ export function blockedHeader(result) {
17
+ return `<span class="pill pill-accent">${icon('flask', true)}${esc(t('res.preview'))}</span>
18
+ <span class="status-code warn is-blocked">${icon('ban', true)}<bdi class="ltr">409</bdi> <span>${esc(t('blk.code'))}</span></span>
19
+ <span class="metric"><bdi>${esc(formatDuration(result.duration ?? 0))}</bdi></span><span class="spacer"></span>
20
+ <span class="resp-acts">${result.wireRequest ? `<button type="button" class="btn btn-ghost btn-icon btn-sm copy" data-action="copy-curl" aria-label="${esc(t('shortcut.copy-curl'))}" title="${esc(t('shortcut.copy-curl'))}" ${shortcutAttrs('copy-curl')}>${icon('copy', true, 'i-idle')}${icon('check', true, 'i-done')}</button>` : ''}
21
+ <button type="button" class="btn btn-sm" data-action="send" ${shortcutAttrs('send')}>${icon('send', true)}${esc(t('res.sendForReal'))}</button></span>`;
22
+ }
23
+
24
+ /** The problem+json body, highlighted like the response viewer's JSON. */
25
+ function problemJson(body) {
26
+ const literal = value => typeof value === 'string' ? `<span class="tok-s">"${esc(value)}"</span>` : `<span class="tok-n">${esc(JSON.stringify(value))}</span>`;
27
+ return `<span class="tok-p">{</span>\n${Object.entries(body || {}).map(([key, value]) =>
28
+ ` <span class="tok-k">"${esc(key)}"</span><span class="tok-p">: </span>${literal(value)}`).join('<span class="tok-p">,</span>\n')}\n<span class="tok-p">}</span>`;
29
+ }
30
+
31
+ /**
32
+ * The language and framework the snippet is written for: the host's own when capabilities carry
33
+ * `binding`, otherwise the switch's current choice (`switchable` tells the markup to offer it).
34
+ */
35
+ function snippetTarget(capabilities, chosen) {
36
+ const binding = bindingOf(capabilities);
37
+ return binding ? { ...binding, switchable: false } : { language: chosen ?? chosenLanguage(), framework: '', switchable: true };
38
+ }
39
+
40
+ /** The snippet for a blocked Preview: the author's reason, the refused operation's route, the target's idiom. */
41
+ function blockedSnippet(result, context, target) {
42
+ const { op } = context;
43
+ return previewFalseSnippet({ language: target.language, framework: target.framework, reason: result.blocked.detail, method: op?.method, path: op?.path });
44
+ }
45
+
46
+ /**
47
+ * The line above the snippet: the host's framework (or language) when discovery names it, otherwise
48
+ * a native select, so the author can read the mark in their own language. Names stay left to right.
49
+ */
50
+ function snippetLabel(target) {
51
+ if (!target.switchable) return `<span class="blk-lang" data-blk-lang>${esc(target.framework || languageName(target.language))}</span>`;
52
+ const options = PREVIEW_FALSE_LANGUAGES.map(({ id, name }) => `<option value="${id}"${id === target.language ? ' selected' : ''}>${esc(name)}</option>`).join('');
53
+ return `<span class="blk-lang"><select class="blk-lang-select ltr" data-blk-lang-select aria-label="${esc(t('lang.label'))}">${options}</select></span>`;
54
+ }
55
+
56
+ /** Each store's outcome: the refused store, the SQL rollback, aborted transactions, side effects. */
57
+ function safeList(blocked, capabilities) {
58
+ const code = `<code class="ltr">${esc(blocked.operation)}</code>`;
59
+ const label = (system, name) => `<span class="nm">${esc(storeName(system))}${name ? ` <code class="ltr">${esc(name)}</code>` : ''}</span>`;
60
+ const rows = [`<li>${storeMark(blocked.store, 16)}${label(blocked.store, dataStore(capabilities, blocked.store)?.name)}<span class="st is-block">${icon('ban', true)}<span>${th('blk.refused', { op: code })}</span></span></li>`];
61
+ const database = databaseName(capabilities);
62
+ if (database) rows.push(`<li>${storeMark(sqlSystem(capabilities), 16)}${label(sqlSystem(capabilities), database)}<span class="st">${icon('undo', true)}<span>${esc(t('stores.state.rolledBack'))}</span></span></li>`);
63
+ for (const store of dataStores(capabilities).filter(item => item.mode === 'preview' && item.system !== blocked.store)) {
64
+ rows.push(`<li>${storeMark(store.system, 16)}${label(store.system, store.name)}<span class="st">${icon('undo', true)}<span>${esc(t('stores.state.aborted'))}</span></span></li>`);
65
+ }
66
+ rows.push(`<li><span class="mk mk-16 mk-other" aria-hidden="true">${icon('mail', true)}</span><span class="nm">${esc(t('blk.effects'))}</span><span class="st">${icon('undo', true)}<span>${esc(t('blk.discarded'))}</span></span></li>`);
67
+ return rows.join('');
68
+ }
69
+
70
+ /** The Response tab of a blocked Preview. `context` is results.js's context(). */
71
+ export function blockedMarkup(result, context = {}) {
72
+ const { blocked } = result;
73
+ const capabilities = context.capabilities || {};
74
+ const store = storeName(blocked.store);
75
+ const guarded = dataStore(capabilities, blocked.store)?.mode !== 'preview';
76
+ const op = `<code class="ltr">${esc(blocked.operation)}</code>`;
77
+ const target = snippetTarget(capabilities);
78
+ // A guarded store can't roll back; a Preview-mode store refused a command it can't run in a
79
+ // transaction, and the server's detail says which.
80
+ const body = guarded ? th('blk.bodyGuard', { op, store: esc(store) })
81
+ : th('blk.bodyRefused', { op, store: esc(store), detail: `<span lang="en">${esc(authorReason(blocked.detail).replace(/[.。]$/, ""))}</span>` });
82
+ const traceOn = context.traceAvailable && !context.traced
83
+ ? `<button type="button" class="btn btn-ghost btn-sm" data-action="traced-on">${esc(t('res.tracedOn'))}</button>` : '';
84
+ return `<section class="blk" aria-labelledby="blk-title">
85
+ <div class="blk-top">
86
+ <span class="blk-tile">${storeMark(blocked.store, 28)}<span class="blk-badge">${icon('ban', true)}</span></span>
87
+ <div class="blk-lede"><p class="blk-eyebrow">${esc(t('blk.eyebrow'))}</p><h3 id="blk-title">${esc(t('blk.title', { store }))}</h3><p>${body}</p></div>
88
+ </div>
89
+ <div class="blk-safe">
90
+ <p class="blk-safe-h">${icon('shield', true)}<strong>${esc(t('blk.safe'))}</strong></p>
91
+ <ul>${safeList(blocked, capabilities)}</ul>
92
+ <p class="blk-note">${esc(t('blk.safeNote'))}</p>
93
+ </div>
94
+ <div class="blk-next">
95
+ <h4>${esc(t('blk.next'))}</h4>
96
+ <div class="blk-step"><span class="n" aria-hidden="true">1</span><div class="grow">
97
+ <div class="blk-acts"><button type="button" class="btn btn-primary btn-sm" data-action="send" ${shortcutAttrs('send')}>${icon('send', true)}${esc(t('res.sendForReal'))}${shortcutHint('send')}</button>${traceOn}</div>
98
+ <p>${esc(t(context.traceAvailable ? 'blk.sendNoteTraced' : 'blk.sendNote'))}</p></div></div>
99
+ <div class="blk-step"><span class="n" aria-hidden="true">2</span><div class="grow">
100
+ <p class="blk-author"><strong>${esc(t('blk.author'))}</strong> ${th('blk.authorBody', { mark: '<code class="ltr">preview: false</code>' })}</p>
101
+ <div class="blk-code ltr">${snippetLabel(target)}<pre lang="en" data-blk-snippet>${esc(blockedSnippet(result, context, target))}</pre>${copyTextButton(t('blk.copy'), { cls: 'btn-xs', data: 'data-blk-copy="snippet"' })}</div>
102
+ </div></div>
103
+ </div>
104
+ <div class="blk-raw"><div class="blk-raw-bar"><span>${esc(t('blk.raw'))}</span><code class="ltr">application/problem+json</code><span class="spacer"></span>${copyTextButton(t('blk.copy'), { cls: 'btn-xs', data: 'data-blk-copy="body"' })}</div>
105
+ <pre class="code-text ltr" tabindex="0" data-blk-body>${problemJson(result.body)}</pre></div>
106
+ </section>`;
107
+ }
108
+
109
+ /** Database, Side effects and Logs of a blocked Preview: it kept nothing, and why. */
110
+ export function blockedTab(tab, result, context = {}) {
111
+ const glyph = tab === 'Database' ? 'db' : tab === 'Side effects' ? 'mail' : 'list';
112
+ return stateBlock({
113
+ glyph, title: esc(t('blk.tabTitle')), body: esc(t('blk.tabBody', { store: storeName(result.blocked.store) })),
114
+ actions: [`<button type="button" class="btn btn-sm" data-action="send" ${shortcutAttrs('send')}>${icon('send', true)}${esc(t('res.sendForReal'))}</button>`,
115
+ context.traceAvailable && !context.traced ? `<button type="button" class="btn btn-ghost btn-sm" data-action="traced-on">${esc(t('res.tracedOn'))}</button>` : ''].filter(Boolean),
116
+ });
117
+ }
118
+
119
+ /**
120
+ * Copy buttons for the snippet and the body copy exactly what is shown; the language switch (when
121
+ * discovery names no binding) rewrites the snippet and is remembered for the next 409.
122
+ * `context` is results.js's context(), as for blockedMarkup.
123
+ */
124
+ export function bindBlocked(container, result, context = {}) {
125
+ const capabilities = context.capabilities || {};
126
+ let target = snippetTarget(capabilities);
127
+ container.addEventListener('change', event => {
128
+ const select = event.target.closest?.('[data-blk-lang-select]');
129
+ if (!select) return;
130
+ chooseLanguage(select.value);
131
+ target = snippetTarget(capabilities, select.value);
132
+ const pre = container.querySelector('[data-blk-snippet]');
133
+ if (pre) pre.textContent = blockedSnippet(result, context, target);
134
+ });
135
+ container.addEventListener('click', event => {
136
+ const button = event.target.closest('[data-blk-copy]');
137
+ if (!button) return;
138
+ const snippet = button.dataset.blkCopy === 'snippet';
139
+ copyText(snippet ? blockedSnippet(result, context, target) : (result.raw || JSON.stringify(result.body, null, 2)), {
140
+ button, what: t(snippet ? 'copy.what.snippet' : 'copy.what.body'),
141
+ select: container.querySelector(snippet ? '[data-blk-snippet]' : '[data-blk-body]'),
142
+ notice: button.closest('.blk-code, .blk-raw'),
143
+ });
144
+ });
145
+ }
146
+
147
+ /** The loading state of a Preview whose last run was blocked: the same blocks, as skeletons. */
148
+ export function blockedSkeleton() {
149
+ const sk = (width, height = '0.7rem', extra = '') => `<span class="sk" style="display:block;inline-size:${width};block-size:${height};${extra}"></span>`;
150
+ return `<div class="result-body" aria-hidden="true"><div class="blk">
151
+ <div class="blk-top"><span class="blk-tile sk" style="border:0"></span><div class="blk-lede">${sk('9rem')}${sk('min(18rem, 80%)', '1.2rem')}${sk('min(24rem, 95%)')}${sk('min(20rem, 85%)')}</div></div>
152
+ <div class="blk-safe"><p class="blk-safe-h">${sk('8rem')}</p><ul>${[0, 1, 2].map(() => `<li>${sk('1rem', '1rem')}${sk('6rem')}<span class="spacer"></span>${sk('7rem')}</li>`).join('')}</ul></div>
153
+ <div class="blk-next">${sk('7rem', '0.9rem')}<div class="blk-step"><span class="n"></span><div class="grow">${sk('9rem', 'var(--btn-sm-h)', 'border-radius:var(--r)')}${sk('min(22rem, 90%)')}</div></div></div>
154
+ </div></div>`;
155
+ }
@@ -0,0 +1,25 @@
1
+ import { effectsMarkup, bindEffects } from './result-effects.js';
2
+ import { logsMarkup, bindLogs } from './result-logs.js';
3
+ import { headersMarkup, bindHeaders } from './result-headers.js';
4
+ import { copyText } from './copy.js';
5
+
6
+ const panes = new Map([
7
+ ['Side effects', { markup: effectsMarkup, bind: bindEffects }],
8
+ ['Logs', { markup: logsMarkup, bind: bindLogs }],
9
+ ['Headers', { markup: headersMarkup, bind: bindHeaders }],
10
+ ]);
11
+
12
+ /** Render the captured data for the selected result tab. */
13
+ export function captureMarkup(tab, result = {}, context = {}) {
14
+ return panes.get(tab)?.markup(result, context) ?? '';
15
+ }
16
+
17
+ /**
18
+ * Bind a freshly rendered result pane to its capture. Panes receive `copy(text, target)`, where
19
+ * target is { button, what, select, notice } for ui/copy.js: the clicked button, a short noun,
20
+ * the element to select if the clipboard is blocked, and where the inline notice goes.
21
+ */
22
+ export function bindCapturePane(container, tab, result = {}, context = {}) {
23
+ const copy = (text, target) => copyText(text, target);
24
+ panes.get(tab)?.bind(container, result, copy, context);
25
+ }
@@ -0,0 +1,185 @@
1
+ // The Database tab: the rows, documents, items and keys a request changed (mocks 01, 49, 113–118).
2
+ // With only the SQL database involved it is the list of row cards it has always been; once a
3
+ // change names a data store, or discovery lists hooked stores, the changes group by store under
4
+ // its mark, name and database, with a jump strip, the stores that were only read and a note on
5
+ // what Sendproof covers.
6
+ import { esc, icon } from './components.js';
7
+ import { formatList, t, th } from './i18n.js';
8
+ import { bindDocDiffs, docCard } from './doc-diff.js';
9
+ import { SQL, dataStore, dataStores, recordCount, sqlSystem, storeMark, storeName } from './stores.js';
10
+
11
+ const operations = {
12
+ insert: ['ins', '+ INSERT'],
13
+ update: ['upd', '~ UPDATE'],
14
+ delete: ['del', '− DELETE'],
15
+ };
16
+
17
+ const serialize = value => typeof value === 'string' ? value : JSON.stringify(value);
18
+
19
+ function renderRows(change, columns) {
20
+ const { before, after, operation } = change;
21
+ return columns.map(key => {
22
+ const original = serialize(before?.[key]);
23
+ const updated = serialize(after?.[key]);
24
+ const title = operation === 'update' ? `${original} → ${updated}` : operation === 'delete' ? original : updated;
25
+ const value = operation === 'update'
26
+ ? `<span class="old">${esc(original)}</span><span class="arrow" aria-hidden="true">→</span><span class="sr-only">${esc(t('db.changedTo'))}</span>${esc(updated)}`
27
+ : esc(operation === 'delete' ? original : updated);
28
+ const style = operation === 'delete' ? 'old' : operation === 'insert' ? 'new' : '';
29
+ return `<div class="k" title="${esc(key)}">${esc(key)}</div><div class="v ${style}" title="${esc(title)}">${value}</div>`;
30
+ }).join('');
31
+ }
32
+
33
+ /** "Id 7d2e41a0…9f13": a row's primary key, with long values shortened in the middle. */
34
+ function rowKey(key) {
35
+ if (key == null) return '';
36
+ const short = value => { const text = serialize(value); return text.length > 18 ? `${text.slice(0, 8)}…${text.slice(-4)}` : text; };
37
+ const entries = typeof key === 'object' && !Array.isArray(key) ? Object.entries(key) : [[null, key]];
38
+ return entries.map(([name, value]) => `${name ? `<span class="k">${esc(name)}</span> ` : ''}<span class="ltr">${esc(short(value))}</span>`).join(' · ');
39
+ }
40
+
41
+ /**
42
+ * A SQL row change. `grouped` cards (inside a store group) show the row's key in the head, as the
43
+ * group head already counts rows; the classic list keeps "1 row".
44
+ */
45
+ function changeCard(change, grouped = false) {
46
+ const operation = String(change.operation || '').toLowerCase();
47
+ const [style, label] = operations[operation] || ['', operation.toUpperCase()];
48
+ const columns = Object.keys({ ...change.before, ...change.after })
49
+ .filter(key => operation !== 'update' || serialize(change.before?.[key]) !== serialize(change.after?.[key]));
50
+ const leading = columns.slice(0, 5);
51
+ const rest = columns.slice(5);
52
+ return `<article class="table-change" aria-label="${esc(t('db.cardLabel', { table: change.table, operation }))}">
53
+ <div class="tc-head">${label ? `<span class="op-badge op-${style}">${esc(label)}</span>` : ''}
54
+ <span class="name" title="${esc(change.table)}">${esc(change.table)}</span>
55
+ <span class="spacer"></span>${grouped && change.key != null
56
+ ? `<span class="faint tc-key" title="${esc(serialize(change.key))}">${rowKey(change.key)}</span>`
57
+ : `<span class="faint" title="${esc(serialize(change.key))}">${esc(t('db.rows', { n: 1 }))}</span>`}
58
+ </div>
59
+ <div class="kv">${renderRows(change, leading)}</div>
60
+ ${rest.length ? `<details><summary class="more-cols">${icon('chevron-down', true)}${esc(t('db.moreColumns', { n: rest.length }))}</summary>
61
+ <div class="kv">${renderRows(change, rest)}</div></details>` : ''}
62
+ </article>`;
63
+ }
64
+
65
+ /** True once stores other than the SQL database are part of the picture. */
66
+ export const groupsByStore = (result, capabilities = {}) =>
67
+ (result.changes || []).some(change => change?.store) || dataStores(capabilities).length > 0;
68
+
69
+ /** The changes by store, SQL first, then in the order stores first appear. */
70
+ function storeGroups(changes) {
71
+ const groups = new Map();
72
+ changes.forEach((change, index) => {
73
+ const system = change.store ? String(change.store).toLowerCase() : SQL;
74
+ if (!groups.has(system)) groups.set(system, []);
75
+ groups.get(system).push({ change, index });
76
+ });
77
+ return [...groups].sort(([a], [b]) => (a === SQL ? -1 : b === SQL ? 1 : 0));
78
+ }
79
+
80
+ /** The stores this request only read: commands in the logs, no changes. */
81
+ function readOnlyStores(result, systems) {
82
+ const read = new Set();
83
+ for (const log of result.logs || []) {
84
+ if (log?.db?.system) read.add(String(log.db.system).toLowerCase());
85
+ else if (log?.sql?.text || String(log?.level).toLowerCase() === 'sql') read.add(SQL);
86
+ }
87
+ return [...read].filter(system => !systems.includes(system));
88
+ }
89
+
90
+ /** What happened to a store's writes: rolled back, aborted, or committed by Send. */
91
+ function groupState(system, preview, capabilities) {
92
+ if (!preview) return [icon('check', true), t('stores.state.committed')];
93
+ if (system === SQL) return [icon('undo', true), t('stores.state.rolledBack')];
94
+ return [icon('undo', true), t(dataStore(capabilities, system)?.mode === 'guard' ? 'stores.state.blocked' : 'stores.state.aborted')];
95
+ }
96
+
97
+ /** One store's head: mark, name, database, state and count. `mark` is the SQL provider for SQL. */
98
+ function groupHead(system, entries, result, capabilities) {
99
+ const sqlMark = system === SQL ? sqlSystem(capabilities) : system;
100
+ const databaseName = system === SQL
101
+ ? (typeof capabilities.database === 'string' ? capabilities.database : capabilities.database?.name)
102
+ : entries.find(entry => entry.change.namespace)?.change.namespace || dataStore(capabilities, system)?.name;
103
+ const [glyph, state] = groupState(system, result.preview, capabilities);
104
+ return `<header class="sg-head">${storeMark(sqlMark, 20)}<h3 id="store-group-${esc(system)}">${esc(storeName(sqlMark))}</h3>${databaseName ? `<code class="ltr">${esc(databaseName)}</code>` : ''}<span class="sg-state${result.preview ? '' : ' is-ok'}">${glyph}${esc(state)}</span><span class="spacer"></span><span class="sg-count">${esc(recordCount(sqlMark, entries.length))}</span></header>`;
105
+ }
106
+
107
+ /**
108
+ * "Covered in Development: SQLite and MongoDB roll back; Redis and DynamoDB block writes. Stores
109
+ * and clients Sendproof didn't hook aren't covered." Built from discovery, so it never claims more
110
+ * than the binding said.
111
+ */
112
+ export function coverageNote(capabilities = {}) {
113
+ const stores = dataStores(capabilities);
114
+ if (!stores.length) return '';
115
+ const label = store => esc(storeName(store.system)) + (store.name ? ` <code class="ltr">${esc(store.name)}</code>` : '');
116
+ const hasSql = !!(typeof capabilities.database === 'string' ? capabilities.database : capabilities.database?.name);
117
+ const rolled = [...(hasSql ? [esc(storeName(sqlSystem(capabilities)))] : []), ...stores.filter(store => store.mode === 'preview').map(label)];
118
+ const blocked = stores.filter(store => store.mode === 'guard').map(label);
119
+ const parts = [];
120
+ if (rolled.length) parts.push(th('stores.cover.rolled', { stores: formatList(rolled), n: rolled.length }));
121
+ if (blocked.length) parts.push(th('stores.cover.blocked', { stores: formatList(blocked), n: blocked.length }));
122
+ const env = capabilities.environment ? th('stores.cover.in', { env: esc(capabilities.environment) }) + ' ' : '';
123
+ return `<p class="cov">${icon('shield', true)}<span>${env}${parts.join(t('stores.cover.separator'))}. ${esc(t('stores.cover.limit'))}</span></p>`;
124
+ }
125
+
126
+ /** Changes grouped by store: a jump strip when there is more than one, then a section per store. */
127
+ function groupedMarkup(result, capabilities) {
128
+ const groups = storeGroups(result.changes);
129
+ const systems = groups.map(([system]) => system);
130
+ const read = readOnlyStores(result, systems);
131
+ const markFor = system => system === SQL ? sqlSystem(capabilities) : system;
132
+ const strip = groups.length > 1 || read.length ? `<nav class="ss" aria-label="${esc(t('stores.strip'))}">
133
+ ${groups.length > 1 ? groups.map(([system, entries]) => `<button type="button" class="ss-item" data-store-jump="${esc(system)}">${storeMark(markFor(system))}<span>${esc(storeName(markFor(system)))}</span><span class="n">${esc(recordCount(markFor(system), entries.length))}</span></button>`).join('') : ''}
134
+ ${read.length ? `<span class="ss-note">${icon('eye', true)}<span>${esc(t('stores.readOnly'))} ${read.map(system => `<span class="ss-st">${storeMark(markFor(system))}${esc(storeName(markFor(system)))}</span>`).join(' ')}</span></span>` : ''}
135
+ </nav>` : '';
136
+ const sections = groups.map(([system, entries]) => `<section class="sg" aria-labelledby="store-group-${esc(system)}">
137
+ ${groupHead(system, entries, result, capabilities)}
138
+ <div class="sg-list">${entries.map(({ change, index }) => system === SQL ? changeCard(change, true) : docCard(change, index)).join('')}</div>
139
+ </section>`).join('');
140
+ return strip + sections;
141
+ }
142
+
143
+ /** Render actual captured row deltas and a compact summary linking to the effects (mocks 01, 49). */
144
+ export function databaseMarkup(result, capabilities) {
145
+ const count = result.changes.length;
146
+ const databaseName = typeof capabilities.database === 'string' ? capabilities.database : capabilities.database?.name;
147
+ const db = databaseName ? `<code class="ltr">${esc(databaseName)}</code>` : esc(t('db.thisDatabase'));
148
+ const actor = capabilities.identity?.name;
149
+ const vars = { db, name: esc(actor || ''), n: count };
150
+ const grouped = groupsByStore(result, capabilities);
151
+ // Stores in the order their groups appear: the SQL database first.
152
+ const touched = storeGroups(result.changes || []).map(([system]) => system === SQL ? sqlSystem(capabilities) : system);
153
+ const storeVars = { ...vars, stores: esc(formatList(touched.map(storeName))) };
154
+ const banner = result.preview
155
+ ? `<div class="banner">${icon('undo')}<div><strong>${esc(t('db.rolledTitle'))}</strong> ${grouped
156
+ ? th(actor ? 'stores.rolledBodyAs' : 'stores.rolledBody', storeVars)
157
+ : th(actor ? 'db.rolledBodyAs' : 'db.rolledBody', vars)}</div></div>`
158
+ : result.status < 400
159
+ ? `<div class="banner banner-ok">${icon('check')}<div><strong>${esc(t('db.committedTitle'))}</strong> ${th(actor ? 'db.committedBodyAs' : 'db.committedBody', vars)}</div><button type="button" class="btn btn-ghost btn-xs" data-action="traced-off">${esc(t('res.tracedOff'))}</button></div>`
160
+ : `<div class="banner banner-neutral">${icon('info')}<div><strong>${esc(t('db.capturedTitle'))}</strong> ${th('db.capturedBody', vars)}</div></div>`;
161
+ const effect = result.effects?.find(item => item.kind === 'email') || result.effects?.[0];
162
+ const matching = effect ? result.effects.filter(item => item.kind === effect.kind) : [];
163
+ const effectSummary = effect ? `<div class="effect">
164
+ ${icon(effect.kind === 'email' ? 'mail' : 'send')}<div class="grow">
165
+ <div class="t">${esc(t(`db.effect.${effect.kind === 'email' ? 'email' : 'other'}.${result.preview ? 'held' : 'recorded'}`, { n: matching.length, kind: effect.kind }))}</div>
166
+ <div class="s" lang="en">${esc(effect.description)}</div>
167
+ </div><button type="button" class="btn btn-ghost btn-sm" data-result-tab="Side effects">${esc(t('db.view'))}</button>
168
+ </div>` : '';
169
+ return `${banner}
170
+ ${grouped ? groupedMarkup(result, capabilities) : result.changes.map(change => changeCard(change)).join('')}
171
+ ${result.changesTruncated ? `<p class="faint">${esc(t('db.truncated'))}</p>` : ''}
172
+ ${grouped ? coverageNote(capabilities) : ''}
173
+ ${effectSummary}`;
174
+ }
175
+
176
+ /** Wires the store jump strip and the document diffs of a rendered Database tab. */
177
+ export function bindDatabase(container, result) {
178
+ bindDocDiffs(container, result.changes || []);
179
+ container.addEventListener('click', event => {
180
+ const jump = event.target.closest('[data-store-jump]');
181
+ if (!jump) return;
182
+ const head = container.querySelector(`#store-group-${CSS.escape(jump.dataset.storeJump)}`);
183
+ head?.closest('.sg')?.scrollIntoView({ block: 'start', behavior: matchMedia('(prefers-reduced-motion: reduce)').matches ? 'auto' : 'smooth' });
184
+ });
185
+ }
@@ -0,0 +1,176 @@
1
+ import { esc, icon } from './components.js';
2
+ import { t, th } from './i18n.js';
3
+
4
+ // Each kind of side effect: its icon, the message keys for its label and status, and the data
5
+ // fields shown as metadata (anything else is listed under "Data").
6
+ const effectKinds = new Map([
7
+ ['email', { glyph: 'mail', fields: ['from', 'to', 'cc', 'subject', 'text', 'html'] }],
8
+ ['http', { glyph: 'globe', fields: ['method', 'url', 'status', 'body'] }],
9
+ ['job', { glyph: 'clock', fields: ['name', 'queue', 'runAt', 'arguments'] }],
10
+ ['message', { glyph: 'send', fields: ['topic', 'key', 'payload'] }],
11
+ ]);
12
+ const otherKind = { glyph: 'send', fields: [] };
13
+
14
+ const present = value => value != null && value !== '';
15
+ const addresses = value => Array.isArray(value) ? value.join(', ') : value;
16
+ const display = value => typeof value === 'object' ? JSON.stringify(value, null, 2) : String(value);
17
+ const chevron = () => `<span class="capture-chevron">${icon('chevron-right', true, 'faint')}</span>`;
18
+
19
+ /** A definition list of labelled values. Each field is [label id, captured value]; empty values are skipped. */
20
+ function metadata(fields) {
21
+ const entries = fields.filter(([, value]) => present(value));
22
+ return entries.length ? `<dl class="mail-meta">${entries.map(([id, value]) =>
23
+ `<dt>${esc(t('fx.field.' + id))}</dt><dd>${id === 'subject' ? `<strong>${esc(value)}</strong>` : esc(value)}</dd>`).join('')}</dl>` : '';
24
+ }
25
+
26
+ /** A labelled block of captured data, shown as received (objects as indented JSON). */
27
+ function payload(id, body) {
28
+ return body == null ? '' : `<div class="fx-payload"><div class="faint">${esc(t('fx.field.' + id))}</div>
29
+ <pre class="mail-preview">${esc(display(body))}</pre></div>`;
30
+ }
31
+
32
+ function emailMarkup(data, id) {
33
+ const html = typeof data.html === 'string' && data.html.trim();
34
+ const text = typeof data.text === 'string' && data.text.trim();
35
+ return metadata([['from', data.from], ['to', addresses(data.to)], ['cc', addresses(data.cc)], ['subject', data.subject]]) +
36
+ (text ? `<div class="mail-preview" aria-label="${esc(t('fx.emailPreview'))}">${data.text.trim().split(/\r?\n[ \t]*\r?\n+/).map(
37
+ paragraph => `<p>${esc(paragraph)}</p>`).join('')}</div>` : '') +
38
+ (html ? `<div class="fx-acts">
39
+ <button type="button" class="btn btn-sm" data-mail-view="html" aria-controls="${id}-html" aria-expanded="false">${icon('eye', true)}${esc(t('fx.openHtml'))}</button>
40
+ <button type="button" class="btn btn-ghost btn-sm" data-mail-view="source" aria-controls="${id}-source" aria-expanded="false">${icon('code', true)}${esc(t('fx.source'))}</button></div>
41
+ <div id="${id}-html" data-mail-panel hidden></div>
42
+ <pre id="${id}-source" class="mail-preview mail-source" data-mail-panel aria-label="${esc(t('fx.htmlSource'))}" hidden>${esc(data.html)}</pre>` : '');
43
+ }
44
+
45
+ function effectContent(kind, data, description, id) {
46
+ switch (kind) {
47
+ case 'email':
48
+ return {
49
+ title: description || data.subject,
50
+ sub: addresses(data.to) ? t('fx.to', { to: addresses(data.to) }) : '',
51
+ details: emailMarkup(data, id),
52
+ };
53
+ case 'http':
54
+ return {
55
+ title: [data.method, data.url].filter(present).join(' ') || description,
56
+ sub: description,
57
+ details: metadata([['method', data.method], ['url', data.url], ['status', data.status]]) + payload('body', data.body),
58
+ };
59
+ case 'job':
60
+ return {
61
+ title: data.name || description,
62
+ sub: [description === data.name ? '' : description, data.queue ? t('fx.queue', { queue: data.queue }) : ''].filter(present).join(' · '),
63
+ details: metadata([['name', data.name], ['queue', data.queue], ['runAt', data.runAt]]) + payload('arguments', data.arguments),
64
+ };
65
+ case 'message':
66
+ return {
67
+ title: data.topic || description,
68
+ sub: [description === data.topic ? '' : description, data.key].filter(present).join(' · '),
69
+ details: metadata([['topic', data.topic], ['key', data.key]]) + payload('payload', data.payload),
70
+ };
71
+ default:
72
+ return { title: description };
73
+ }
74
+ }
75
+
76
+ function effectCard(effect, preview, index) {
77
+ const id = `capture-effect-${index}`;
78
+ const kind = String(effect.kind ?? '').toLowerCase();
79
+ const config = effectKinds.get(kind) ?? otherKind;
80
+ const group = effectKinds.has(kind) ? kind : 'other';
81
+ const label = effectKinds.has(kind) ? t('fx.kind.' + kind) : effect.kind || t('fx.kind.other');
82
+ const data = effect.data ?? {};
83
+ const { title, sub, details } = effectContent(kind, data, effect.description, id);
84
+ const extra = details && Object.entries(data).filter(([key]) => !config.fields.includes(key));
85
+ const body = details ? details + (extra.length ? payload('data', Object.fromEntries(extra)) : '') : payload('data', effect.data);
86
+ const delivered = !preview && effect.delivered === true;
87
+ const status = preview ? t('fx.held.' + group) : delivered ? t('fx.sent.' + group) : t('fx.captured');
88
+ const badge = delivered && kind === 'http' && present(data.status) ? `${status} · ${data.status}` : status;
89
+ const content = `<span class="fx-ico">${icon(config.glyph, true)}</span>
90
+ <span class="stack"><span class="kind">${esc(label)}</span>
91
+ <span class="title" title="${esc(title)}">${esc(title || label)}</span>
92
+ ${sub && sub !== title ? `<span class="sub" title="${esc(sub)}">${esc(sub)}</span>` : ''}</span>
93
+ <span class="tag${delivered ? ' tag-ok' : ''}">${esc(badge)}</span>`;
94
+
95
+ const open = index === 0 && kind === 'email' && !!details;
96
+ return body ? `<article class="fx${open ? ' is-open' : ''}" data-captured-effect="${index}">
97
+ <button class="fx-head" type="button" aria-expanded="${open}" aria-controls="${id}">${content}${chevron()}</button>
98
+ <div class="fx-body" id="${id}"${open ? '' : ' hidden'}>${body}</div></article>` :
99
+ `<article class="fx"><div class="fx-head fx-static">${content}</div></article>`;
100
+ }
101
+
102
+ function effectsBanner(effects, preview) {
103
+ const delivered = preview ? 0 : effects.filter(effect => effect.delivered === true).length;
104
+ const allDelivered = delivered === effects.length;
105
+ const message = preview
106
+ ? th('fx.heldBanner', { n: effects.length })
107
+ : allDelivered ? `<strong>${th('fx.ran', { n: delivered })}</strong>` :
108
+ `<strong>${th('fx.capturedCount', { n: effects.length })}</strong>${delivered ? ` ${th('fx.ran', { n: delivered })}` : ''}`;
109
+ return `<div class="banner${allDelivered ? ' banner-ok' : ''}">${icon(preview ? 'undo' : allDelivered ? 'check' : 'info')}<div>${message}</div></div>`;
110
+ }
111
+
112
+ /** The side effects pane: a summary banner and one expandable card per captured effect. */
113
+ export function effectsMarkup(result) {
114
+ const effects = (result.effects ?? []).filter(effect => effect && typeof effect === 'object');
115
+ const truncated = result.effectsTruncated ? `<p class="faint capture-note">${esc(t('fx.truncated'))}</p>` : '';
116
+ if (!effects.length) return `<p class="faint capture-note">${esc(t('fx.none'))}</p>` + truncated;
117
+ return effectsBanner(effects, result.preview) + truncated +
118
+ `<div class="fx-list">${effects.map((effect, index) => effectCard(effect, result.preview, index)).join('')}</div>`;
119
+ }
120
+
121
+ const emailElements = new Set('a abbr b blockquote br caption center code col colgroup dd div dl dt em font h1 h2 h3 h4 h5 h6 hr i img li ol p pre s small span strong style sub sup table tbody td th thead tfoot tr u ul'.split(' '));
122
+ const emailAttributes = new Set('alt aria-label align bgcolor border cellpadding cellspacing class colspan dir height id lang role rowspan style title valign width'.split(' '));
123
+
124
+ /** Preserve email formatting in an inert, isolated document without active content or remote assets. */
125
+ function mountEmailPreview(panel, html) {
126
+ const doc = panel.ownerDocument;
127
+ const template = doc.createElement('template');
128
+ template.innerHTML = html;
129
+ for (const el of template.content.querySelectorAll('*')) {
130
+ if (el.namespaceURI !== 'http://www.w3.org/1999/xhtml' || !emailElements.has(el.localName)) {
131
+ el.remove();
132
+ continue;
133
+ }
134
+ for (const attr of [...el.attributes]) {
135
+ const embeddedImage = el.localName === 'img' && attr.name === 'src' &&
136
+ /^data:image\/(?:png|gif|jpeg|webp);base64,/i.test(attr.value);
137
+ if (!emailAttributes.has(attr.name) && !embeddedImage) el.removeAttributeNode(attr);
138
+ }
139
+ }
140
+ const frame = doc.createElement('iframe');
141
+ frame.className = 'mail-frame';
142
+ frame.title = t('fx.htmlFrame');
143
+ frame.setAttribute('sandbox', '');
144
+ frame.referrerPolicy = 'no-referrer';
145
+ const policy = "default-src 'none'; img-src data:; style-src 'unsafe-inline'; base-uri 'none'; form-action 'none'";
146
+ frame.srcdoc = `<!doctype html><meta charset="utf-8"><meta http-equiv="Content-Security-Policy" content="${policy}">${template.innerHTML}`;
147
+ panel.append(frame);
148
+ }
149
+
150
+ /** Wires the effect cards: expand and collapse, and the email's HTML and source panels. */
151
+ export function bindEffects(container, result) {
152
+ const effects = (result.effects ?? []).filter(effect => effect && typeof effect === 'object');
153
+ for (const card of container.querySelectorAll('[data-captured-effect]')) {
154
+ const head = card.querySelector('.fx-head');
155
+ const body = card.querySelector('.fx-body');
156
+ head.addEventListener('click', () => {
157
+ body.hidden = !body.hidden;
158
+ card.classList.toggle('is-open', !body.hidden);
159
+ head.setAttribute('aria-expanded', String(!body.hidden));
160
+ });
161
+
162
+ const buttons = card.querySelectorAll('[data-mail-view]');
163
+ const panels = card.querySelectorAll('[data-mail-panel]');
164
+ for (const [index, button] of buttons.entries()) {
165
+ button.addEventListener('click', () => {
166
+ const panel = panels[index];
167
+ const opening = panel.hidden;
168
+ buttons.forEach(item => item.setAttribute('aria-expanded', String(item === button && opening)));
169
+ panels.forEach(item => { item.hidden = item !== panel || !opening; });
170
+ if (opening && button.dataset.mailView === 'html' && !panel.firstChild) {
171
+ mountEmailPreview(panel, effects[Number(card.dataset.capturedEffect)].data.html);
172
+ }
173
+ });
174
+ }
175
+ }
176
+ }