@meith/runtime 0.21.2 → 0.22.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meith/runtime",
-  "version": "0.21.2",
+  "version": "0.22.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -19,24 +19,24 @@
     "access": "public"
   },
   "dependencies": {
-    "@meith/accounts": "0.21.2",
-    "@meith/attachments": "0.21.2",
-    "@meith/core": "0.21.2",
-    "@meith/avatars": "0.21.2",
-    "@meith/api": "0.21.2",
-    "@meith/db": "0.21.2",
-    "@meith/drivers": "0.21.2",
-    "@meith/events": "0.21.2",
-    "@meith/mail": "0.21.2",
-    "@meith/markdown": "0.21.2",
-    "@meith/marketplace": "0.21.2",
-    "@meith/i18n": "0.21.2",
-    "@meith/notifications": "0.21.2",
-    "@meith/plugin-kit": "0.21.2",
-    "@meith/settings": "0.21.2",
-    "@meith/moderation": "0.21.2",
-    "@meith/tasks": "0.21.2",
-    "@meith/groups": "0.21.2",
-    "@meith/theme-default": "0.21.2"
+    "@meith/accounts": "0.22.0",
+    "@meith/attachments": "0.22.0",
+    "@meith/api": "0.22.0",
+    "@meith/avatars": "0.22.0",
+    "@meith/core": "0.22.0",
+    "@meith/db": "0.22.0",
+    "@meith/drivers": "0.22.0",
+    "@meith/events": "0.22.0",
+    "@meith/groups": "0.22.0",
+    "@meith/i18n": "0.22.0",
+    "@meith/mail": "0.22.0",
+    "@meith/marketplace": "0.22.0",
+    "@meith/markdown": "0.22.0",
+    "@meith/notifications": "0.22.0",
+    "@meith/plugin-kit": "0.22.0",
+    "@meith/settings": "0.22.0",
+    "@meith/moderation": "0.22.0",
+    "@meith/tasks": "0.22.0",
+    "@meith/theme-default": "0.22.0"
   }
 }

package/src/plugin-context.ts

@@ -18,12 +18,6 @@ import {
 
 export const PLUGIN_STATEMENT_TIMEOUT_MS = 30_000
 
-/**
- * The context every plugin callback is handed: its resolved settings, a logger
- * that says which plugin is talking, and the four runtime capabilities. Built
- * in one place so a task, an install and a purge cannot drift into offering a
- * plugin different powers depending on which door it came through.
- */
 export async function pluginRuntimeContext(input: {
   readonly db: Database
   readonly plugin: PluginDefinition

package/src/plugin-lifecycle.ts

@@ -12,14 +12,6 @@ const CALLBACKS: Readonly<Record<PluginLifecyclePhase, keyof PluginDefinition>>
   uninstall: 'onUninstall',
 }
 
-/**
- * Run one lifecycle callback, or report that the plugin declares none.
- *
- * It throws what the callback throws, deliberately. These do not run inside the
- * host's try/catch, because that isolation exists to keep a page rendering and
- * none of these is on a page: an install that half-worked should stop the
- * deploy rather than be swallowed, and each caller states its own policy.
- */
 export async function runPluginLifecycle(input: {
   readonly db: Database
   readonly plugin: PluginDefinition

package/src/plugin-rendering.ts

@@ -24,11 +24,6 @@ export function pluginMarkdownPipeline(host: PluginHost): MarkdownPipeline {
   }
 }
 
-/**
- * A message on its way out of the worker, past the plugins first. Returning
- * null from `mail.send.before` drops it; nothing tells the recipient, because
- * nobody was waiting on a page for it.
- */
 export async function sendAudited(
   host: PluginHost,
   mail: MailDriver,

package/src/scheduler-bundle.ts

@@ -36,8 +36,8 @@ import {
   recordPluginFailure,
   syncRenderSignature,
 } from '@meith/db'
-import { EN_CATALOG, sourceTranslator } from '@meith/i18n'
-import { renderMail } from '@meith/mail'
+import { EN_CATALOG, sourceTranslator, type Translator } from '@meith/i18n'
+import { absoluteUrl, type MailFooterLine, renderMail } from '@meith/mail'
 import {
   deliverNotificationEmail,
   deliverNotificationPush,
@@ -47,6 +47,7 @@ import {
 } from '@meith/notifications'
 import { type PluginDefinition, PluginHost, renderingSignature } from '@meith/plugin-kit'
 import { resolvePushConfig, SettingsSnapshot } from '@meith/settings'
+import { mintUnsubscribeToken } from '@meith/subscriptions'
 import { builtinTasks, type TaskDefinition, type TaskRepository } from '@meith/tasks'
 
 import { buildEventRegistry } from './event-handlers'
@@ -131,11 +132,6 @@ export function buildSchedulerBundle(deps: {
     'Scheduled task run duration in seconds, labelled by task and outcome.',
   )
 
-  /**
-   * Every task, announced. The host is told before and after each run — a
-   * plugin watching its own task, or the board's, gets the same two events
-   * whichever scheduled it.
-   */
   const announced = (tasks: readonly TaskDefinition[]): TaskDefinition[] =>
     tasks.map((task) => ({
       ...task,
@@ -218,9 +214,11 @@ export function buildSchedulerBundle(deps: {
             },
             ...optional(mail, (mail) => ({
               massMail: {
-                async send({ massMailId, email }) {
-                  const campaign = await new PostgresUserBulkRepository(db).readMassMail(massMailId)
+                async send({ massMailId, userId, email }) {
+                  const bulk = new PostgresUserBulkRepository(db)
+                  const campaign = await bulk.readMassMail(massMailId)
                   if (campaign === null) return
+                  if (!(await bulk.mayReceiveMassMail(userId))) return
 
                   const brand = await resolveMailBrand({ db, ...themeDeps })
                   const t = await (
@@ -240,6 +238,8 @@ export function buildSchedulerBundle(deps: {
                               brand.boardName === '' ? t.t('mail.boardFallback') : brand.boardName,
                           }),
                         },
+                        { text: t.t('mail.footer.announcementsConsent') },
+                        massMailUnsubscribeLine({ boardUrl: brand.boardUrl, userId, t }),
                       ],
                     },
                   })
@@ -371,3 +371,30 @@ function taskFailureNotifier(
       })
   }
 }
+
+const UNSUBSCRIBE_PATH = '/unsubscribe'
+
+const MAIL_PREFERENCES_PATH = '/notifications/preferences'
+
+function massMailUnsubscribeLine(input: {
+  readonly boardUrl: string
+  readonly userId: number
+  readonly t: Translator
+}): MailFooterLine {
+  const secret = env.AUTH_SECRET
+  const token =
+    secret === undefined
+      ? null
+      : mintUnsubscribeToken({ userId: input.userId, scope: 'mass-mail', targetId: 0 }, secret)
+
+  const href = absoluteUrl(
+    input.boardUrl,
+    token === null
+      ? MAIL_PREFERENCES_PATH
+      : `${UNSUBSCRIBE_PATH}?token=${encodeURIComponent(token)}`,
+  )
+
+  return href === null
+    ? { text: input.t.t('mail.footer.announcementsNoLink') }
+    : { text: input.t.t('mail.footer.announcementsStop'), href }
+}