@things-factory/notification 10.1.218 → 10.1.223

package/dist-client/viewparts/notice-channel-setting-let.d.ts

@@ -0,0 +1,32 @@
+import '@material/web/button/outlined-button.js';
+import '@material/web/button/text-button.js';
+import '@material/web/switch/switch.js';
+import '@things-factory/setting-base';
+import { LitElement, nothing } from 'lit';
+type SecretState = {
+    set: boolean;
+    host?: string;
+};
+type NoticeChannelSetting = {
+    email: boolean;
+    teamsChannel: SecretState;
+};
+declare const NoticeChannelSettingLet_base: (new (...args: any[]) => LitElement) & typeof LitElement;
+/**
+ * Where notices go beyond the app and web push in this domain (ADR-0164): mail, and the Teams channel that takes a
+ * notice to everyone. Shown to those who may change the domain's attributes; for anyone else the card stays empty. The
+ * webhook address goes in and never comes back - the card shows only that it is set, and its host.
+ */
+export declare class NoticeChannelSettingLet extends NoticeChannelSettingLet_base {
+    static styles: import("lit").CSSResult[];
+    setting?: NoticeChannelSetting;
+    entries: {
+        teamsChannelWebhook: string;
+    };
+    busy: boolean;
+    render(): import("lit-html").TemplateResult<1> | typeof nothing;
+    private webhookRow;
+    connectedCallback(): Promise<void>;
+    private save;
+}
+export {};

package/dist-client/viewparts/notice-channel-setting-let.js

@@ -0,0 +1,175 @@
+import { __decorate, __metadata } from "tslib";
+import '@material/web/button/outlined-button.js';
+import '@material/web/button/text-button.js';
+import '@material/web/switch/switch.js';
+import '@things-factory/setting-base';
+import gql from 'graphql-tag';
+import { css, html, LitElement, nothing } from 'lit';
+import { customElement, state } from 'lit/decorators.js';
+import { client } from '@operato/graphql';
+import { i18next, localize } from '@operato/i18n';
+import { notify } from '@operato/layout';
+const SETTING = `email teamsChannel { set host }`;
+/**
+ * Where notices go beyond the app and web push in this domain (ADR-0164): mail, and the Teams channel that takes a
+ * notice to everyone. Shown to those who may change the domain's attributes; for anyone else the card stays empty. The
+ * webhook address goes in and never comes back - the card shows only that it is set, and its host.
+ */
+let NoticeChannelSettingLet = class NoticeChannelSettingLet extends localize(i18next)(LitElement) {
+    constructor() {
+        super(...arguments);
+        this.entries = { teamsChannelWebhook: '' };
+        this.busy = false;
+    }
+    static { this.styles = [
+        css `
+      div[row] {
+        display: flex;
+        flex-direction: column;
+        gap: var(--spacing-small, 4px);
+        border-bottom: var(--border-dim-color);
+        margin-bottom: var(--spacing-medium);
+        padding-bottom: var(--spacing-medium);
+      }
+
+      div[row]:last-child {
+        border-bottom: none;
+        margin-bottom: 0;
+      }
+
+      label {
+        display: flex;
+        gap: 10px;
+        align-items: center;
+
+        font: var(--label-font);
+        color: var(--md-sys-color-on-surface);
+        text-transform: var(--label-text-transform);
+      }
+
+      [state] {
+        font: var(--input-font);
+        color: var(--md-sys-color-on-surface-variant);
+        /* a host is data - the card's capitalized labels must not reach it */
+        text-transform: none;
+      }
+
+      div[entry] {
+        display: flex;
+        gap: var(--spacing-small, 4px);
+        align-items: center;
+      }
+
+      input {
+        background-color: var(--input-field-background, var(--md-sys-color-surface-container-highest));
+        color: var(--input-field-color, var(--md-sys-color-on-surface));
+        border: var(--border-dim-color);
+        border-radius: var(--border-radius);
+        margin: var(--input-margin);
+        padding: var(--input-padding);
+        font: var(--input-font);
+
+        flex: 1;
+        min-width: 0;
+      }
+    `
+    ]; }
+    render() {
+        const setting = this.setting;
+        if (!setting)
+            return nothing;
+        return html `
+      <setting-let>
+        <span slot="title">${i18next.t('title.notice channels')}</span>
+
+        <div slot="content" row>
+          <label>
+            <md-switch ?selected=${setting.email} ?disabled=${this.busy} @change=${e => this.save({ email: e.target.selected })}></md-switch>
+            ${i18next.t('label.notice by email')}
+          </label>
+        </div>
+
+        ${this.webhookRow('teamsChannelWebhook', i18next.t('label.teams channel webhook'), setting.teamsChannel)}
+      </setting-let>
+    `;
+    }
+    webhookRow(field, label, secret) {
+        const entry = this.entries[field];
+        return html `
+      <div slot="content" row>
+        <label>${label}</label>
+        <span state>
+          ${secret.set ? i18next.t('text.notice webhook set', { host: secret.host || '-' }) : i18next.t('text.notice webhook not set')}
+        </span>
+        <div entry>
+          <input
+            type="url"
+            placeholder="https://"
+            autocomplete="off"
+            .value=${entry}
+            @input=${e => (this.entries = { ...this.entries, [field]: e.target.value })}
+          />
+          <md-outlined-button ?disabled=${this.busy || !entry.trim()} @click=${() => this.save({ [field]: entry.trim() })}
+            >${i18next.t('button.notice webhook save')}</md-outlined-button
+          >
+          ${secret.set
+            ? html `<md-text-button ?disabled=${this.busy} @click=${() => this.save({ [field]: '' })}
+                >${i18next.t('button.notice webhook clear')}</md-text-button
+              >`
+            : nothing}
+        </div>
+      </div>
+    `;
+    }
+    async connectedCallback() {
+        super.connectedCallback();
+        const response = await client
+            .query({ query: gql `query { noticeChannelSetting { ${SETTING} } }`, fetchPolicy: 'no-cache', errorPolicy: 'all' })
+            .catch(() => undefined);
+        /* refused - this person may not change the domain's attributes, so the card stays empty */
+        this.setting = response?.data?.noticeChannelSetting || undefined;
+    }
+    async save(patch) {
+        this.busy = true;
+        try {
+            const response = await client.mutate({
+                mutation: gql `mutation ($patch: NoticeChannelSettingPatch!) { updateNoticeChannelSetting(patch: $patch) { ${SETTING} } }`,
+                variables: { patch },
+                errorPolicy: 'all'
+            });
+            if (response.errors?.length) {
+                notify({ level: 'error', message: response.errors[0].message });
+                this.requestUpdate();
+                return;
+            }
+            this.setting = response.data.updateNoticeChannelSetting;
+            const cleared = Object.keys(patch).filter(field => field in this.entries);
+            if (cleared.length)
+                this.entries = { ...this.entries, ...Object.fromEntries(cleared.map(field => [field, ''])) };
+            notify({ level: 'info', message: i18next.t('text.notice channels saved') });
+        }
+        catch (error) {
+            notify({ level: 'error', message: String(error?.message || error) });
+        }
+        finally {
+            this.busy = false;
+        }
+    }
+};
+__decorate([
+    state(),
+    __metadata("design:type", Object)
+], NoticeChannelSettingLet.prototype, "setting", void 0);
+__decorate([
+    state(),
+    __metadata("design:type", Object)
+], NoticeChannelSettingLet.prototype, "entries", void 0);
+__decorate([
+    state(),
+    __metadata("design:type", Object)
+], NoticeChannelSettingLet.prototype, "busy", void 0);
+NoticeChannelSettingLet = __decorate([
+    customElement('notice-channel-setting-let')
+], NoticeChannelSettingLet);
+export { NoticeChannelSettingLet };
+//# sourceMappingURL=notice-channel-setting-let.js.map

package/dist-client/viewparts/notice-channel-setting-let.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notice-channel-setting-let.js","sourceRoot":"","sources":["../../client/viewparts/notice-channel-setting-let.ts"],"names":[],"mappings":"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","sourcesContent":["import '@material/web/button/outlined-button.js'\nimport '@material/web/button/text-button.js'\nimport '@material/web/switch/switch.js'\nimport '@things-factory/setting-base'\n\nimport gql from 'graphql-tag'\nimport { css, html, LitElement, nothing } from 'lit'\nimport { customElement, state } from 'lit/decorators.js'\n\nimport { client } from '@operato/graphql'\nimport { i18next, localize } from '@operato/i18n'\nimport { notify } from '@operato/layout'\n\ntype SecretState = { set: boolean; host?: string }\ntype NoticeChannelSetting = { email: boolean; teamsChannel: SecretState }\n\nconst SETTING = `email teamsChannel { set host }`\n\n/**\n * Where notices go beyond the app and web push in this domain (ADR-0164): mail, and the Teams channel that takes a\n * notice to everyone. Shown to those who may change the domain's attributes; for anyone else the card stays empty. The\n * webhook address goes in and never comes back - the card shows only that it is set, and its host.\n */\n@customElement('notice-channel-setting-let')\nexport class NoticeChannelSettingLet extends localize(i18next)(LitElement) {\n  static styles = [\n    css`\n      div[row] {\n        display: flex;\n        flex-direction: column;\n        gap: var(--spacing-small, 4px);\n        border-bottom: var(--border-dim-color);\n        margin-bottom: var(--spacing-medium);\n        padding-bottom: var(--spacing-medium);\n      }\n\n      div[row]:last-child {\n        border-bottom: none;\n        margin-bottom: 0;\n      }\n\n      label {\n        display: flex;\n        gap: 10px;\n        align-items: center;\n\n        font: var(--label-font);\n        color: var(--md-sys-color-on-surface);\n        text-transform: var(--label-text-transform);\n      }\n\n      [state] {\n        font: var(--input-font);\n        color: var(--md-sys-color-on-surface-variant);\n        /* a host is data - the card's capitalized labels must not reach it */\n        text-transform: none;\n      }\n\n      div[entry] {\n        display: flex;\n        gap: var(--spacing-small, 4px);\n        align-items: center;\n      }\n\n      input {\n        background-color: var(--input-field-background, var(--md-sys-color-surface-container-highest));\n        color: var(--input-field-color, var(--md-sys-color-on-surface));\n        border: var(--border-dim-color);\n        border-radius: var(--border-radius);\n        margin: var(--input-margin);\n        padding: var(--input-padding);\n        font: var(--input-font);\n\n        flex: 1;\n        min-width: 0;\n      }\n    `\n  ]\n\n  @state() setting?: NoticeChannelSetting\n  @state() entries: { teamsChannelWebhook: string } = { teamsChannelWebhook: '' }\n  @state() busy = false\n\n  render() {\n    const setting = this.setting\n    if (!setting) return nothing\n\n    return html`\n      <setting-let>\n        <span slot=\"title\">${i18next.t('title.notice channels')}</span>\n\n        <div slot=\"content\" row>\n          <label>\n            <md-switch ?selected=${setting.email} ?disabled=${this.busy} @change=${e => this.save({ email: e.target.selected })}></md-switch>\n            ${i18next.t('label.notice by email')}\n          </label>\n        </div>\n\n        ${this.webhookRow('teamsChannelWebhook', i18next.t('label.teams channel webhook'), setting.teamsChannel)}\n      </setting-let>\n    `\n  }\n\n  private webhookRow(field: 'teamsChannelWebhook', label: string, secret: SecretState) {\n    const entry = this.entries[field]\n\n    return html`\n      <div slot=\"content\" row>\n        <label>${label}</label>\n        <span state>\n          ${secret.set ? i18next.t('text.notice webhook set', { host: secret.host || '-' }) : i18next.t('text.notice webhook not set')}\n        </span>\n        <div entry>\n          <input\n            type=\"url\"\n            placeholder=\"https://\"\n            autocomplete=\"off\"\n            .value=${entry}\n            @input=${e => (this.entries = { ...this.entries, [field]: e.target.value })}\n          />\n          <md-outlined-button ?disabled=${this.busy || !entry.trim()} @click=${() => this.save({ [field]: entry.trim() })}\n            >${i18next.t('button.notice webhook save')}</md-outlined-button\n          >\n          ${secret.set\n            ? html`<md-text-button ?disabled=${this.busy} @click=${() => this.save({ [field]: '' })}\n                >${i18next.t('button.notice webhook clear')}</md-text-button\n              >`\n            : nothing}\n        </div>\n      </div>\n    `\n  }\n\n  async connectedCallback() {\n    super.connectedCallback()\n\n    const response = await client\n      .query({ query: gql`query { noticeChannelSetting { ${SETTING} } }`, fetchPolicy: 'no-cache', errorPolicy: 'all' })\n      .catch(() => undefined)\n\n    /* refused - this person may not change the domain's attributes, so the card stays empty */\n    this.setting = response?.data?.noticeChannelSetting || undefined\n  }\n\n  private async save(patch: Record<string, unknown>) {\n    this.busy = true\n    try {\n      const response = await client.mutate({\n        mutation: gql`mutation ($patch: NoticeChannelSettingPatch!) { updateNoticeChannelSetting(patch: $patch) { ${SETTING} } }`,\n        variables: { patch },\n        errorPolicy: 'all'\n      })\n\n      if (response.errors?.length) {\n        notify({ level: 'error', message: response.errors[0].message })\n        this.requestUpdate()\n        return\n      }\n\n      this.setting = response.data.updateNoticeChannelSetting\n      const cleared = Object.keys(patch).filter(field => field in this.entries)\n      if (cleared.length) this.entries = { ...this.entries, ...Object.fromEntries(cleared.map(field => [field, ''])) }\n      notify({ level: 'info', message: i18next.t('text.notice channels saved') })\n    } catch (error) {\n      notify({ level: 'error', message: String((error as any)?.message || error) })\n    } finally {\n      this.busy = false\n    }\n  }\n}\n"]}

package/dist-server/controllers/index.d.ts

@@ -1,2 +1,3 @@
 export * from './fcm';
 export * from './receivers';
+export * from './notice';

package/dist-server/controllers/index.js

@@ -3,4 +3,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./fcm"), exports);
 tslib_1.__exportStar(require("./receivers"), exports);
+tslib_1.__exportStar(require("./notice"), exports);
 //# sourceMappingURL=index.js.map

package/dist-server/controllers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../server/controllers/index.ts"],"names":[],"mappings":";;;AAAA,gDAAqB;AACrB,sDAA2B","sourcesContent":["export * from './fcm'\nexport * from './receivers'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../server/controllers/index.ts"],"names":[],"mappings":";;;AAAA,gDAAqB;AACrB,sDAA2B;AAC3B,mDAAwB","sourcesContent":["export * from './fcm'\nexport * from './receivers'\nexport * from './notice'\n"]}

package/dist-server/controllers/notice/deliver-notice.d.ts

@@ -0,0 +1,78 @@
+import { type NoticeWords } from './notice-channels.js';
+export type NoticeReceiver = {
+    id: string;
+    email?: string | null;
+    locale?: string | null;
+};
+/**
+ * A notice, settled by the module whose event it tells of - who, what and where. The words are asked per language,
+ * so each person reads their own.
+ */
+export type Notice = {
+    /** What kind of thing it tells of - `approval`, `announcement`. The in-app notice carries it. */
+    type: string;
+    level?: 'info' | 'warn';
+    receivers: NoticeReceiver[];
+    words: (lng: string) => NoticeWords;
+    /** The page, relative to the domain - what the in-app notice opens. */
+    address: string;
+    /** The same page as a full address for mail and Teams; absent when no request said where we are. */
+    link?: string;
+    /** The language of a person who has not chosen one. */
+    defaultLanguage?: string;
+    /** Names the notice in the log. */
+    label: string;
+    /** How `words().body` is written. Markdown is rendered in the mail; Teams and push take it as text. */
+    format?: 'text' | 'markdown';
+    /**
+     * The channels this notice may take beyond the app, when its sender chooses per notice (an announcement's
+     * "send by mail too"). Left out, it takes every channel the domain turned on; a channel the domain has not turned on
+     * is never taken.
+     */
+    channels?: {
+        email?: boolean;
+        teams?: boolean;
+    };
+    /**
+     * Said to everyone in the domain (an announcement to the whole domain). The app, push and mail still go to each
+     * person; Teams posts once to the domain's channel webhook, in the default language. Only a broadcast goes to Teams -
+     * a notice to some people never lands where everyone reads.
+     */
+    broadcast?: boolean;
+};
+/** What went out - mail counted per person, the Teams channel post once. A sender that keeps a record stores this. */
+export type NoticeResult = {
+    receivers: number;
+    email: {
+        sent: number;
+        failed: number;
+    };
+    teams: {
+        sent: number;
+        failed: number;
+    };
+};
+export type NoticeChannelFunctions = {
+    /** The domain's attributes (EnvVar) - read when the notice goes. */
+    attributes: () => Promise<Record<string, string | undefined>>;
+    /** notification's `notify` for the domain; absent, nothing goes in the app. */
+    push?: (payload: any) => unknown;
+    /** email-base's `sendEmail` - answers the transport's receipt, nothing when it failed. */
+    mail: (mail: {
+        receiver: string;
+        subject: string;
+        content: string;
+    }) => Promise<unknown>;
+    /** Posts JSON to the Teams webhook and answers whether it took it. */
+    teams: (url: string, body: unknown) => Promise<{
+        ok: boolean;
+        status?: number;
+    }>;
+    report: (message: string, error?: unknown) => void;
+};
+/**
+ * Tells each receiver in the app and by web push always, and by mail when the domain turned it on; a broadcast is
+ * also posted once to the domain's Teams channel. A channel that fails is reported with its name and the others still
+ * go - nothing here throws, because what it tells of has already happened.
+ */
+export declare function deliverNotice(notice: Notice, channels: NoticeChannelFunctions): Promise<NoticeResult>;

package/dist-server/controllers/notice/deliver-notice.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deliverNotice = deliverNotice;
+/*
+ * Sending one notice down each channel (ADR-0164). The channels come in as functions, so a test hands in fakes and
+ * sees what each one was given; send-notice.ts hands in the real ones.
+ */
+const notice_channels_js_1 = require("./notice-channels.js");
+const notice_email_js_1 = require("./notice-email.js");
+/** The domain's own address - the notice's full link without its page. */
+function baseOf(notice) {
+    return notice.link && notice.link.endsWith(notice.address) ? notice.link.slice(0, notice.link.length - notice.address.length) : undefined;
+}
+/**
+ * Tells each receiver in the app and by web push always, and by mail when the domain turned it on; a broadcast is
+ * also posted once to the domain's Teams channel. A channel that fails is reported with its name and the others still
+ * go - nothing here throws, because what it tells of has already happened.
+ */
+async function deliverNotice(notice, channels) {
+    const result = { receivers: notice.receivers.length, email: { sent: 0, failed: 0 }, teams: { sent: 0, failed: 0 } };
+    if (!notice.receivers.length)
+        return result;
+    let turnedOn = { email: false };
+    try {
+        turnedOn = (0, notice_channels_js_1.noticeChannels)(await channels.attributes());
+    }
+    catch (error) {
+        channels.report(`${notice.label}: the domain's notice channels could not be read - in the app only`, error);
+    }
+    const email = turnedOn.email && notice.channels?.email !== false;
+    const teamsChannelWebhook = notice.broadcast && notice.channels?.teams !== false ? turnedOn.teamsChannelWebhook : undefined;
+    for (const receiver of notice.receivers) {
+        const lng = (0, notice_channels_js_1.languageOf)(receiver.locale, notice.defaultLanguage);
+        let words;
+        try {
+            words = notice.words(lng);
+        }
+        catch (error) {
+            channels.report(`${notice.label}: the words for ${receiver.id} could not be made`, error);
+            if (email && receiver.email)
+                result.email.failed++;
+            continue;
+        }
+        if (channels.push) {
+            for (const mode of ['foreground', 'background']) {
+                try {
+                    await channels.push({
+                        receivers: [receiver.id],
+                        type: notice.type,
+                        subject: notice.level || 'info',
+                        title: words.subject,
+                        body: words.summary ?? words.body,
+                        url: notice.address,
+                        mode
+                    });
+                }
+                catch (error) {
+                    channels.report(`${notice.label}: the ${mode} notice to ${receiver.id} failed`, error);
+                }
+            }
+        }
+        if (email && receiver.email) {
+            try {
+                const sent = await channels.mail({
+                    receiver: receiver.email,
+                    subject: words.subject,
+                    content: (0, notice_email_js_1.noticeEmailForm)({ lang: lng, words, link: notice.link, format: notice.format, base: baseOf(notice) })
+                });
+                if (sent) {
+                    result.email.sent++;
+                }
+                else {
+                    result.email.failed++;
+                    channels.report(`${notice.label}: the mail to ${receiver.email} did not go out`);
+                }
+            }
+            catch (error) {
+                result.email.failed++;
+                channels.report(`${notice.label}: the mail to ${receiver.email} failed`, error);
+            }
+        }
+    }
+    if (teamsChannelWebhook) {
+        try {
+            const answer = await channels.teams(teamsChannelWebhook, (0, notice_channels_js_1.teamsMessage)({ words: notice.words((0, notice_channels_js_1.languageOf)(undefined, notice.defaultLanguage)), link: notice.link }));
+            if (answer.ok) {
+                result.teams.sent++;
+            }
+            else {
+                result.teams.failed++;
+                channels.report(`${notice.label}: Teams refused the channel post (${answer.status ?? '-'})`);
+            }
+        }
+        catch (error) {
+            result.teams.failed++;
+            channels.report(`${notice.label}: the Teams channel post failed`, error);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=deliver-notice.js.map

package/dist-server/controllers/notice/deliver-notice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deliver-notice.js","sourceRoot":"","sources":["../../../server/controllers/notice/deliver-notice.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Sending one notice down each channel (ADR-0164). The channels come in as functions, so a test hands in fakes and\n * sees what each one was given; send-notice.ts hands in the real ones.\n */\nimport { languageOf, noticeChannels, teamsMessage, type NoticeWords } from './notice-channels.js'\nimport { noticeEmailForm } from './notice-email.js'\n\nexport type NoticeReceiver = { id: string; email?: string | null; locale?: string | null }\n\n/**\n * A notice, settled by the module whose event it tells of - who, what and where. The words are asked per language,\n * so each person reads their own.\n */\nexport type Notice = {\n  /** What kind of thing it tells of - `approval`, `announcement`. The in-app notice carries it. */\n  type: string\n  level?: 'info' | 'warn'\n  receivers: NoticeReceiver[]\n  words: (lng: string) => NoticeWords\n  /** The page, relative to the domain - what the in-app notice opens. */\n  address: string\n  /** The same page as a full address for mail and Teams; absent when no request said where we are. */\n  link?: string\n  /** The language of a person who has not chosen one. */\n  defaultLanguage?: string\n  /** Names the notice in the log. */\n  label: string\n  /** How `words().body` is written. Markdown is rendered in the mail; Teams and push take it as text. */\n  format?: 'text' | 'markdown'\n  /**\n   * The channels this notice may take beyond the app, when its sender chooses per notice (an announcement's\n   * \"send by mail too\"). Left out, it takes every channel the domain turned on; a channel the domain has not turned on\n   * is never taken.\n   */\n  channels?: { email?: boolean; teams?: boolean }\n  /**\n   * Said to everyone in the domain (an announcement to the whole domain). The app, push and mail still go to each\n   * person; Teams posts once to the domain's channel webhook, in the default language. Only a broadcast goes to Teams -\n   * a notice to some people never lands where everyone reads.\n   */\n  broadcast?: boolean\n}\n\n/** What went out - mail counted per person, the Teams channel post once. A sender that keeps a record stores this. */\nexport type NoticeResult = {\n  receivers: number\n  email: { sent: number; failed: number }\n  teams: { sent: number; failed: number }\n}\n\nexport type NoticeChannelFunctions = {\n  /** The domain's attributes (EnvVar) - read when the notice goes. */\n  attributes: () => Promise<Record<string, string | undefined>>\n  /** notification's `notify` for the domain; absent, nothing goes in the app. */\n  push?: (payload: any) => unknown\n  /** email-base's `sendEmail` - answers the transport's receipt, nothing when it failed. */\n  mail: (mail: { receiver: string; subject: string; content: string }) => Promise<unknown>\n  /** Posts JSON to the Teams webhook and answers whether it took it. */\n  teams: (url: string, body: unknown) => Promise<{ ok: boolean; status?: number }>\n  report: (message: string, error?: unknown) => void\n}\n\n/** The domain's own address - the notice's full link without its page. */\nfunction baseOf(notice: Notice): string | undefined {\n  return notice.link && notice.link.endsWith(notice.address) ? notice.link.slice(0, notice.link.length - notice.address.length) : undefined\n}\n\n/**\n * Tells each receiver in the app and by web push always, and by mail when the domain turned it on; a broadcast is\n * also posted once to the domain's Teams channel. A channel that fails is reported with its name and the others still\n * go - nothing here throws, because what it tells of has already happened.\n */\nexport async function deliverNotice(notice: Notice, channels: NoticeChannelFunctions): Promise<NoticeResult> {\n  const result: NoticeResult = { receivers: notice.receivers.length, email: { sent: 0, failed: 0 }, teams: { sent: 0, failed: 0 } }\n  if (!notice.receivers.length) return result\n\n  let turnedOn: ReturnType<typeof noticeChannels> = { email: false }\n  try {\n    turnedOn = noticeChannels(await channels.attributes())\n  } catch (error) {\n    channels.report(`${notice.label}: the domain's notice channels could not be read - in the app only`, error)\n  }\n\n  const email = turnedOn.email && notice.channels?.email !== false\n  const teamsChannelWebhook = notice.broadcast && notice.channels?.teams !== false ? turnedOn.teamsChannelWebhook : undefined\n\n  for (const receiver of notice.receivers) {\n    const lng = languageOf(receiver.locale, notice.defaultLanguage)\n    let words: NoticeWords\n    try {\n      words = notice.words(lng)\n    } catch (error) {\n      channels.report(`${notice.label}: the words for ${receiver.id} could not be made`, error)\n      if (email && receiver.email) result.email.failed++\n      continue\n    }\n\n    if (channels.push) {\n      for (const mode of ['foreground', 'background'] as const) {\n        try {\n          await channels.push({\n            receivers: [receiver.id],\n            type: notice.type,\n            subject: notice.level || 'info',\n            title: words.subject,\n            body: words.summary ?? words.body,\n            url: notice.address,\n            mode\n          })\n        } catch (error) {\n          channels.report(`${notice.label}: the ${mode} notice to ${receiver.id} failed`, error)\n        }\n      }\n    }\n\n    if (email && receiver.email) {\n      try {\n        const sent = await channels.mail({\n          receiver: receiver.email,\n          subject: words.subject,\n          content: noticeEmailForm({ lang: lng, words, link: notice.link, format: notice.format, base: baseOf(notice) })\n        })\n        if (sent) {\n          result.email.sent++\n        } else {\n          result.email.failed++\n          channels.report(`${notice.label}: the mail to ${receiver.email} did not go out`)\n        }\n      } catch (error) {\n        result.email.failed++\n        channels.report(`${notice.label}: the mail to ${receiver.email} failed`, error)\n      }\n    }\n  }\n\n  if (teamsChannelWebhook) {\n    try {\n      const answer = await channels.teams(teamsChannelWebhook, teamsMessage({ words: notice.words(languageOf(undefined, notice.defaultLanguage)), link: notice.link }))\n      if (answer.ok) {\n        result.teams.sent++\n      } else {\n        result.teams.failed++\n        channels.report(`${notice.label}: Teams refused the channel post (${answer.status ?? '-'})`)\n      }\n    } catch (error) {\n      result.teams.failed++\n      channels.report(`${notice.label}: the Teams channel post failed`, error)\n    }\n  }\n\n  return result\n}\n"]}

package/dist-server/controllers/notice/index.d.ts

@@ -0,0 +1,4 @@
+export * from './notice-channels.js';
+export * from './notice-email.js';
+export * from './deliver-notice.js';
+export * from './send-notice.js';

package/dist-server/controllers/notice/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./notice-channels.js"), exports);
+tslib_1.__exportStar(require("./notice-email.js"), exports);
+tslib_1.__exportStar(require("./deliver-notice.js"), exports);
+tslib_1.__exportStar(require("./send-notice.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist-server/controllers/notice/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/controllers/notice/index.ts"],"names":[],"mappings":";;;AAAA,+DAAoC;AACpC,4DAAiC;AACjC,8DAAmC;AACnC,2DAAgC","sourcesContent":["export * from './notice-channels.js'\nexport * from './notice-email.js'\nexport * from './deliver-notice.js'\nexport * from './send-notice.js'\n"]}

package/dist-server/controllers/notice/notice-channels.d.ts

@@ -0,0 +1,67 @@
+/** The domain attributes (EnvVar) that turn the channels on. Web push needs none. */
+export declare const NOTICE_EMAIL = "Notice::email";
+/** The Workflows webhook that posts to one Teams channel - where a notice to everyone in the domain goes. */
+export declare const NOTICE_TEAMS_CHANNEL = "Notice::teamsChannelWebhook";
+export declare const NOTICE_ATTRIBUTE_PREFIX = "Notice::";
+/**
+ * Which channels a domain has turned on. Mail goes when the domain says `on` - a server carries several domains,
+ * and a development server carries real accounts. Teams goes to one channel when the domain holds the address of the
+ * channel's Workflows webhook; anything but an https address is not one. There is no Teams to each person: its flow
+ * needed expressions typed into the Workflows designer, and the user dropped it (10-26) - a person is told by mail.
+ */
+export declare function noticeChannels(attributes: Record<string, string | undefined> | null | undefined): {
+    email: boolean;
+    teamsChannelWebhook?: string;
+};
+/** `ko-KR` → `ko`: the server's translations are kept by language, not by region. */
+export declare function languageOf(locale: string | null | undefined, fallback: string | null | undefined): string;
+/**
+ * What a notice says to one person, in their language. `note` stands in for the button when there is no link.
+ * `summary` is what the in-app notice and web push show when the body is long (an announcement's whole text goes by
+ * mail); left out, they show the body.
+ */
+export type NoticeWords = {
+    subject: string;
+    body: string;
+    action: string;
+    note: string;
+    summary?: string;
+};
+/**
+ * The body posted to the Teams channel's Workflows webhook: a Teams message with one Adaptive Card, which the channel
+ * template posts as it is given.
+ */
+export declare function teamsMessage({ words, link }: {
+    words: NoticeWords;
+    link?: string;
+}): {
+    type: string;
+    summary: string;
+    attachments: {
+        contentType: string;
+        contentUrl: any;
+        content: {
+            $schema: string;
+            type: string;
+            version: string;
+            body: ({
+                type: string;
+                text: string;
+                weight: string;
+                size: string;
+                wrap: boolean;
+            } | {
+                type: string;
+                text: string;
+                wrap: boolean;
+                weight?: undefined;
+                size?: undefined;
+            })[];
+            actions: {
+                type: string;
+                title: string;
+                url: string;
+            }[];
+        };
+    }[];
+};

package/dist-server/controllers/notice/notice-channels.js

@@ -0,0 +1,62 @@
+"use strict";
+/*
+ * The channels a notice goes down (ADR-0164) - which ones a domain has turned on, the language a person reads, and
+ * the Teams message. Plain functions over plain values, so a test holds them without a database.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NOTICE_ATTRIBUTE_PREFIX = exports.NOTICE_TEAMS_CHANNEL = exports.NOTICE_EMAIL = void 0;
+exports.noticeChannels = noticeChannels;
+exports.languageOf = languageOf;
+exports.teamsMessage = teamsMessage;
+/** The domain attributes (EnvVar) that turn the channels on. Web push needs none. */
+exports.NOTICE_EMAIL = 'Notice::email';
+/** The Workflows webhook that posts to one Teams channel - where a notice to everyone in the domain goes. */
+exports.NOTICE_TEAMS_CHANNEL = 'Notice::teamsChannelWebhook';
+exports.NOTICE_ATTRIBUTE_PREFIX = 'Notice::';
+/**
+ * Which channels a domain has turned on. Mail goes when the domain says `on` - a server carries several domains,
+ * and a development server carries real accounts. Teams goes to one channel when the domain holds the address of the
+ * channel's Workflows webhook; anything but an https address is not one. There is no Teams to each person: its flow
+ * needed expressions typed into the Workflows designer, and the user dropped it (10-26) - a person is told by mail.
+ */
+function noticeChannels(attributes) {
+    const email = String(attributes?.[exports.NOTICE_EMAIL] ?? '').trim().toLowerCase() === 'on';
+    const https = (name) => {
+        const webhook = String(attributes?.[name] ?? '').trim();
+        return /^https:\/\//i.test(webhook) ? webhook : undefined;
+    };
+    return { email, teamsChannelWebhook: https(exports.NOTICE_TEAMS_CHANNEL) };
+}
+/** `ko-KR` → `ko`: the server's translations are kept by language, not by region. */
+function languageOf(locale, fallback) {
+    return String(locale || fallback || 'en')
+        .split(/[-_]/)[0]
+        .toLowerCase();
+}
+/**
+ * The body posted to the Teams channel's Workflows webhook: a Teams message with one Adaptive Card, which the channel
+ * template posts as it is given.
+ */
+function teamsMessage({ words, link }) {
+    return {
+        type: 'message',
+        summary: words.subject,
+        attachments: [
+            {
+                contentType: 'application/vnd.microsoft.card.adaptive',
+                contentUrl: null,
+                content: {
+                    $schema: 'http://adaptivecards.io/schemas/adaptive-card.json',
+                    type: 'AdaptiveCard',
+                    version: '1.4',
+                    body: [
+                        { type: 'TextBlock', text: words.subject, weight: 'Bolder', size: 'Medium', wrap: true },
+                        { type: 'TextBlock', text: link ? words.body : `${words.body}\n\n${words.note}`, wrap: true }
+                    ],
+                    actions: link ? [{ type: 'Action.OpenUrl', title: words.action, url: link }] : []
+                }
+            }
+        ]
+    };
+}
+//# sourceMappingURL=notice-channels.js.map

package/dist-server/controllers/notice/notice-channels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notice-channels.js","sourceRoot":"","sources":["../../../server/controllers/notice/notice-channels.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAcH,wCAWC;AAGD,gCAIC;AAaD,oCAqBC;AAhED,qFAAqF;AACxE,QAAA,YAAY,GAAG,eAAe,CAAA;AAC3C,6GAA6G;AAChG,QAAA,oBAAoB,GAAG,6BAA6B,CAAA;AACpD,QAAA,uBAAuB,GAAG,UAAU,CAAA;AAEjD;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,UAAiE;IAI9F,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC,oBAAY,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,IAAI,CAAA;IACpF,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,EAAE;QAC7B,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;QACvD,OAAO,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAA;IAC3D,CAAC,CAAA;IAED,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,KAAK,CAAC,4BAAoB,CAAC,EAAE,CAAA;AACpE,CAAC;AAED,qFAAqF;AACrF,SAAgB,UAAU,CAAC,MAAiC,EAAE,QAAmC;IAC/F,OAAO,MAAM,CAAC,MAAM,IAAI,QAAQ,IAAI,IAAI,CAAC;SACtC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;SAChB,WAAW,EAAE,CAAA;AAClB,CAAC;AASD;;;GAGG;AACH,SAAgB,YAAY,CAAC,EAAE,KAAK,EAAE,IAAI,EAAyC;IACjF,OAAO;QACL,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,WAAW,EAAE;YACX;gBACE,WAAW,EAAE,yCAAyC;gBACtD,UAAU,EAAE,IAAI;gBAChB,OAAO,EAAE;oBACP,OAAO,EAAE,oDAAoD;oBAC7D,IAAI,EAAE,cAAc;oBACpB,OAAO,EAAE,KAAK;oBACd,IAAI,EAAE;wBACJ,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE;wBACxF,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;qBAC9F;oBACD,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;iBAClF;aACF;SACF;KACF,CAAA;AACH,CAAC","sourcesContent":["/*\n * The channels a notice goes down (ADR-0164) - which ones a domain has turned on, the language a person reads, and\n * the Teams message. Plain functions over plain values, so a test holds them without a database.\n */\n\n/** The domain attributes (EnvVar) that turn the channels on. Web push needs none. */\nexport const NOTICE_EMAIL = 'Notice::email'\n/** The Workflows webhook that posts to one Teams channel - where a notice to everyone in the domain goes. */\nexport const NOTICE_TEAMS_CHANNEL = 'Notice::teamsChannelWebhook'\nexport const NOTICE_ATTRIBUTE_PREFIX = 'Notice::'\n\n/**\n * Which channels a domain has turned on. Mail goes when the domain says `on` - a server carries several domains,\n * and a development server carries real accounts. Teams goes to one channel when the domain holds the address of the\n * channel's Workflows webhook; anything but an https address is not one. There is no Teams to each person: its flow\n * needed expressions typed into the Workflows designer, and the user dropped it (10-26) - a person is told by mail.\n */\nexport function noticeChannels(attributes: Record<string, string | undefined> | null | undefined): {\n  email: boolean\n  teamsChannelWebhook?: string\n} {\n  const email = String(attributes?.[NOTICE_EMAIL] ?? '').trim().toLowerCase() === 'on'\n  const https = (name: string) => {\n    const webhook = String(attributes?.[name] ?? '').trim()\n    return /^https:\\/\\//i.test(webhook) ? webhook : undefined\n  }\n\n  return { email, teamsChannelWebhook: https(NOTICE_TEAMS_CHANNEL) }\n}\n\n/** `ko-KR` → `ko`: the server's translations are kept by language, not by region. */\nexport function languageOf(locale: string | null | undefined, fallback: string | null | undefined): string {\n  return String(locale || fallback || 'en')\n    .split(/[-_]/)[0]\n    .toLowerCase()\n}\n\n/**\n * What a notice says to one person, in their language. `note` stands in for the button when there is no link.\n * `summary` is what the in-app notice and web push show when the body is long (an announcement's whole text goes by\n * mail); left out, they show the body.\n */\nexport type NoticeWords = { subject: string; body: string; action: string; note: string; summary?: string }\n\n/**\n * The body posted to the Teams channel's Workflows webhook: a Teams message with one Adaptive Card, which the channel\n * template posts as it is given.\n */\nexport function teamsMessage({ words, link }: { words: NoticeWords; link?: string }) {\n  return {\n    type: 'message',\n    summary: words.subject,\n    attachments: [\n      {\n        contentType: 'application/vnd.microsoft.card.adaptive',\n        contentUrl: null,\n        content: {\n          $schema: 'http://adaptivecards.io/schemas/adaptive-card.json',\n          type: 'AdaptiveCard',\n          version: '1.4',\n          body: [\n            { type: 'TextBlock', text: words.subject, weight: 'Bolder', size: 'Medium', wrap: true },\n            { type: 'TextBlock', text: link ? words.body : `${words.body}\\n\\n${words.note}`, wrap: true }\n          ],\n          actions: link ? [{ type: 'Action.OpenUrl', title: words.action, url: link }] : []\n        }\n      }\n    ]\n  }\n}\n"]}

package/dist-server/controllers/notice/notice-email.d.ts

@@ -0,0 +1,28 @@
+import type { NoticeWords } from './notice-channels.js';
+/** Every value goes into the HTML through this - a subject like `<b>` or `A&B` stays text. */
+export declare function escapeHtml(value: unknown): string;
+/**
+ * Where a link in a notice may go: http(s) and mailto as written, and an address of the app (no scheme) under `base`,
+ * the domain's own address. With no base an app address has nowhere to go and is dropped, as is every other scheme -
+ * `javascript:` in any spelling the URL parser reads as one.
+ */
+export declare function safeNoticeHref(href: string | null | undefined, base?: string): string | undefined;
+/**
+ * Markdown as mail HTML, rendered here on the server. Raw HTML in the text is shown as text, never as markup; a link or
+ * an image becomes a link only to an address `safeNoticeHref` allows, and an image is not loaded - it is shown as a
+ * link with its alt text, so a mail does not fetch from wherever its writer pointed.
+ */
+export declare function renderNoticeMarkdown(markdown: string, base?: string): string;
+/**
+ * The notice mail (ADR-0164) - the head, band, button and foot of the auth mails, so a person knows the sender.
+ * Without a link (a notice sent with no request to take the address from) the button gives way to the note.
+ */
+export declare function noticeEmailForm({ lang, words, link, format, base }: {
+    lang: string;
+    words: NoticeWords;
+    link?: string;
+    /** How the body is written - an announcement's is Markdown. */
+    format?: 'text' | 'markdown';
+    /** The domain's address, under which an app address in a Markdown body is resolved. */
+    base?: string;
+}): string;