@acms-subir/core 0.3.54 → 0.3.56

package/src/lib/calendar/request-config.ts

@@ -0,0 +1,8 @@
+import { userConfig } from 'virtual:acms-config';
+
+// acms({ requests }) config (integration.mjs resolves it): off unless a site
+// turns it on, and only with the calendar. `path` is the public form ('/request'
+// by default, '/es/request' in Spanish); `page: false` keeps the app API and
+// Calendar → Requests but drops that form, so a site can build its own.
+export const REQUESTS: { enabled: boolean; path: string; page: boolean } =
+  { enabled: false, path: '/request', page: true, ...userConfig.requests };

package/src/lib/calendar/request-mail.ts

@@ -0,0 +1,158 @@
+import type { ContentRepository } from '../repo/types';
+import type { RequestRecord, Settings } from '../schema';
+import type { Mail } from '../email/types';
+import { siteLang, siteLocale } from '../dates';
+import { I18N, localeName } from '../i18n';
+import { fill } from '../live/words';
+import { parseWall } from './events';
+import { zonedToUtc } from './ics';
+import { requestSettings, type NewEventDetails, type RequestMailPayload } from './request-service';
+import { requestStaffWords, requestStrings } from './request-words';
+
+// The emails about event requests (queued by lib/calendar/request-service.ts
+// as kind 'calendar-request') and the staff push. To the person: in the
+// language they asked in, and never with words they typed (their title or
+// message), so the form can't be used to email someone else a message; only
+// the date, time, kind, rooms and number of people, or the event's own title.
+// Staff get everything, in the site's main language, with Reply-To set to
+// the person. Plain HTML like the other emails, plus a text part.
+
+const esc = (s: string) => s.replace(/[&<>"']/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' }[c]!));
+const oneLine = (s: string) => s.replace(/\s+/g, ' ').trim();
+
+/** the site's main language, and the locale for its dates (keeping the site's region when it's the same language) */
+function language(settings: Settings, lang = '') {
+  const l = lang || (I18N.enabled && I18N.defaultLocale) || siteLang(settings);
+  const base = l.toLowerCase().split('-')[0];
+  return { lang: l, locale: base === siteLang(settings) ? siteLocale(settings) : l };
+}
+
+/** "Sat, Nov 7 · 2:00 – 5:00 PM" for site-local wall times, in a language */
+export function requestWhen(start: string, end: string, settings: Settings, locale: string): string {
+  const tz = settings.timezone || 'UTC';
+  const s = parseWall(start), e = parseWall(end);
+  if (!s || s.dateOnly) return start;
+  const at = (w: NonNullable<typeof s>) => zonedToUtc(w.y, w.m, w.d, w.hh, w.mm, 0, tz);
+  const f = (o: Intl.DateTimeFormatOptions) => {
+    try { return new Intl.DateTimeFormat(locale, { ...o, timeZone: tz }); }
+    catch { return new Intl.DateTimeFormat('en-US', { ...o, timeZone: 'UTC' }); }
+  };
+  const date = f({ weekday: 'short', month: 'short', day: 'numeric' }).format(at(s));
+  const time = f({ hour: 'numeric', minute: '2-digit' });
+  return `${date} · ${e && !e.dateOnly ? time.formatRange(at(s), at(e)) : time.format(at(s))}`;
+}
+
+/** a date (YYYY-MM-DD…) as "Sat, Nov 7" */
+function dayText(key: string, settings: Settings, locale: string) {
+  const w = parseWall(key.slice(0, 10));
+  if (!w) return key;
+  try { return new Intl.DateTimeFormat(locale, { weekday: 'short', month: 'short', day: 'numeric', timeZone: 'UTC' }).format(Date.UTC(w.y, w.m - 1, w.d)); }
+  catch { return key.slice(0, 10); }
+}
+
+interface Summary { what: string; lines: string[] }
+/** the request as the person may see it again: never their own words */
+async function personSummary(repo: ContentRepository, q: RequestRecord, settings: Settings, lang: string, locale: string): Promise<Summary> {
+  const w = requestStrings(lang);
+  if (q.kind === 'change') {
+    const e = q.eventId ? await repo.getEvent(q.eventId) : null;
+    const title = e?.title ?? String(q.data.title ?? '');
+    return { what: fill(w.changeTo, { title }), lines: [q.key ? dayText(q.key, settings, locale) : w.everyDate] };
+  }
+  if (q.kind !== 'new') return { what: '', lines: [] };
+  const d = q.data as unknown as NewEventDetails;
+  const rooms = await repo.listResources();
+  const type = requestSettings(settings).types.find((t) => t.id === d.type);
+  const parts = [
+    requestWhen(d.start, d.end, settings, locale),
+    ...(d.repeat === 'weekly' ? [w.weekly] : []),
+    d.roomIds.map((id) => rooms.find((r) => r.id === id)?.name).filter(Boolean).join(', '),
+    d.people ? fill(w.aboutPeople, { count: String(d.people) }) : '',
+    type ? (lang && type.translations[lang]) || type.label : '',
+  ].filter(Boolean);
+  return { what: '', lines: [parts.join(' · ')] };
+}
+
+function page(site: string, heading: string, paras: string[], quote: string, button?: { label: string; url: string }, foot = '') {
+  const box = quote ? `<p style="background:#efebe4;border-radius:8px;padding:10px 12px;white-space:pre-line">${esc(quote)}</p>` : '';
+  const btn = button ? `<p><a style="display:inline-block;background:#ee5d20;color:#fff;padding:10px 18px;border-radius:8px;text-decoration:none" href="${esc(button.url)}">${esc(button.label)}</a></p>` : '';
+  return `<!doctype html><html><body style="margin:0;background:#f6f5f2;color:#24211c;font:16px/1.6 system-ui,sans-serif"><div style="max-width:520px;margin:auto;padding:32px 24px"><p style="color:#7d776e">${esc(site)}</p><h1 style="font-size:22px">${esc(heading)}</h1>`
+    + paras.map((p) => `<p>${esc(p)}</p>`).join('') + box + btn + (foot ? `<p style="color:#7d776e;font-size:14px">${esc(foot)}</p>` : '') + '</div></body></html>';
+}
+
+/** One queued request email, or null when it no longer applies. */
+export async function requestMail(repo: ContentRepository, recipient: string, p: RequestMailPayload, origin: string): Promise<Mail | null> {
+  const q = await repo.requests.get(p.requestId);
+  if (!q) return null;
+  const settings = await repo.getSettings();
+  const site = settings.siteTitle;
+  if (p.kind === 'staff-new') {
+    // staff hear only about requests still waiting
+    if (q.state !== 'pending') return null;
+    return staffMail(repo, q, recipient, settings, origin);
+  }
+  const { lang, locale } = language(settings, q.requester?.locale);
+  const w = requestStrings(lang).mail;
+  const s = await personSummary(repo, q, settings, lang, locale);
+  const rq = requestSettings(settings);
+  const replyTime = (q.requester?.locale && rq.translations[q.requester.locale]?.replyTime) || rq.replyTime;
+  const change = q.kind === 'change';
+  const [subject, intro, quote] = p.kind === 'received' ? [w.receivedSubject, [w.received, ...(replyTime ? [fill(w.within, { time: replyTime })] : [])], '']
+    : p.kind === 'reply' ? [w.replySubject, [w.reply], p.message ?? '']
+    : p.kind === 'approved' ? [w.approvedSubject, [change ? w.approvedChange : w.approved], p.message ? `${w.fromTeam} ${p.message}` : '']
+    : [w.declinedSubject, [change ? w.declinedChange : w.declined], p.message ? `${w.fromTeam} ${p.message}` : ''];
+  const details = [s.what, ...s.lines].filter(Boolean);
+  const foot = p.kind === 'received' ? w.notYou : '';
+  return {
+    to: recipient, subject: `${subject} · ${site}`,
+    text: [subject, '', ...intro, '', ...details, ...(quote ? ['', quote] : []), ...(foot ? ['', foot] : [])].join('\n'),
+    html: page(site, subject, [...intro, details.join(' — ')], quote, undefined, foot),
+  };
+}
+
+async function staffMail(repo: ContentRepository, q: RequestRecord, to: string, settings: Settings, origin: string): Promise<Mail> {
+  const { lang, locale } = language(settings);
+  const w = requestStaffWords(lang);
+  const site = settings.siteTitle;
+  const user = q.userId ? await repo.getUser(q.userId) : null;
+  const who = q.requester ?? { name: user?.name ?? '', email: user?.email ?? '', phone: '', locale: '' };
+  const rows: [string, string][] = [];
+  let subject: string;
+  if (q.kind === 'new') {
+    const d = q.data as unknown as NewEventDetails;
+    const rooms = await repo.listResources();
+    const type = requestSettings(settings).types.find((t) => t.id === d.type);
+    subject = fill(w.subjectNew, { title: oneLine(d.title) });
+    rows.push([w.when, requestWhen(d.start, d.end, settings, locale)]);
+    if (d.repeat !== 'once') rows.push([w.repeats, d.repeat === 'weekly' ? requestStrings(lang).weekly : d.repeatText]);
+    rows.push([w.rooms, d.roomsUnsure ? w.roomsUnsure : d.roomIds.map((id) => rooms.find((r) => r.id === id)?.name ?? '').filter(Boolean).join(', ') || '—']);
+    if (d.people) rows.push([w.people, String(d.people)]);
+    if (type) rows.push([w.type, type.label]);
+  } else {
+    const e = q.eventId ? await repo.getEvent(q.eventId) : null;
+    const title = e?.title ?? String(q.data.title ?? '');
+    subject = fill(q.kind === 'change' ? w.subjectChange : w.subjectMove, { title: oneLine(title) });
+    rows.push([w.date, q.key ? dayText(q.key, settings, locale) : w.everyDate]);
+    const d = q.data as { start?: string; end?: string };
+    if (q.kind !== 'change' && d.start && d.end) rows.push([w.when, requestWhen(d.start, d.end, settings, locale)]);
+  }
+  rows.push([w.from, [who.name, who.email, who.phone].filter(Boolean).join(' · ')]);
+  if (who.locale) rows.push([w.language, localeName(who.locale, true)]);
+  const quote = q.note ? `${q.kind === 'change' ? w.whatChange : w.message}: “${q.note}”` : '';
+  const url = `${origin}/admin/calendar/requests#r-${q.id}`;
+  const intro = w.intro[q.source];
+  return {
+    to, subject: `${subject} · ${site}`, ...(who.email ? { replyTo: who.email } : {}),
+    text: [subject, '', intro, '', ...rows.map(([k, v]) => `${k}: ${v}`), ...(quote ? ['', quote] : []), '', `${w.open}: ${url}`, '', w.why].join('\n'),
+    html: page(site, subject, [intro, ...rows.map(([k, v]) => `${k}: ${v}`)], quote, { label: w.open, url }, w.why),
+  };
+}
+
+/** The staff push: that a request arrived and for when, nothing the person typed. */
+export async function requestPush(_repo: ContentRepository, q: RequestRecord, settings: Settings): Promise<{ title: string; body: string }> {
+  const { lang, locale } = language(settings);
+  const w = requestStaffWords(lang);
+  const d = q.data as { start?: string; end?: string };
+  const when = d.start && d.end ? requestWhen(d.start, d.end, settings, locale) : q.key ? dayText(q.key, settings, locale) : '';
+  return { title: w.pushTitle, body: when ? fill(w.pushBody, { when }) : '' };
+}

package/src/lib/calendar/request-page.ts

@@ -0,0 +1,52 @@
+import type { ContentRepository } from '../repo/types';
+import type { RequestRecord, Settings } from '../schema';
+import { requestWhen } from './request-mail';
+import { requestSettings, type NewEventDetails, type RequestInput } from './request-service';
+import { requestStrings } from './request-words';
+import { fill } from '../live/words';
+
+// The built-in request form (pages/request/index.astro): what the posted
+// form means as a request, and the "Request sent" summary. A site's own form
+// can use the server API instead.
+
+const str = (data: FormData, name: string) => String(data.get(name) ?? '');
+
+/** The posted form as RequestInput (the date and times come as separate fields). */
+export function formRequest(data: FormData, locale: string): RequestInput {
+  const kind = str(data, 'kind') === 'change' ? 'change' : 'new';
+  const common = { name: str(data, 'name'), email: str(data, 'email'), phone: str(data, 'phone'), locale, website: str(data, 'website') };
+  if (kind === 'change') return { kind, event: str(data, 'event'), date: str(data, 'onDate'), message: str(data, 'whatChange'), ...common };
+  const date = str(data, 'date');
+  const repeat = str(data, 'repeat');
+  const people = Number.parseInt(str(data, 'people'), 10);
+  return {
+    kind, type: str(data, 'type'), title: str(data, 'title'),
+    start: date && str(data, 'start') ? `${date}T${str(data, 'start')}` : date, end: str(data, 'end'),
+    repeat: repeat === 'weekly' || repeat === 'other' ? repeat : 'once', repeatText: str(data, 'repeatText'),
+    rooms: data.getAll('rooms').map(String).slice(0, 10), roomsUnsure: data.get('roomsUnsure') === '1',
+    people: Number.isFinite(people) && people > 0 ? Math.min(people, 1_000_000) : null, message: str(data, 'message'), ...common,
+  };
+}
+
+/** "Request sent": the request as the person sent it, in their language. */
+export async function sentSummary(repo: ContentRepository, q: RequestRecord, settings: Settings, lang: string, locale: string): Promise<{ title: string; line: string }> {
+  const w = requestStrings(lang);
+  if (q.kind === 'change') {
+    const e = await repo.getEvent(q.eventId);
+    const day = q.key ? new Date(`${q.key.slice(0, 10)}T12:00:00Z`) : null;
+    let date = w.everyDate;
+    if (day) { try { date = new Intl.DateTimeFormat(locale, { weekday: 'short', month: 'short', day: 'numeric', timeZone: 'UTC' }).format(day); } catch { date = q.key.slice(0, 10); } }
+    return { title: fill(w.changeTo, { title: e?.title ?? String(q.data.title ?? '') }), line: date };
+  }
+  const d = q.data as unknown as NewEventDetails;
+  const rooms = await repo.listResources();
+  const type = requestSettings(settings).types.find((t) => t.id === d.type);
+  const line = [
+    requestWhen(d.start, d.end, settings, locale),
+    d.repeat === 'weekly' ? w.weekly : d.repeat === 'other' ? d.repeatText : '',
+    d.roomIds.map((id) => rooms.find((r) => r.id === id)?.name).filter(Boolean).join(', '),
+    d.people ? fill(w.aboutPeople, { count: String(d.people) }) : '',
+    type ? (lang && type.translations[lang]) || type.label : '',
+  ].filter(Boolean).join(' · ');
+  return { title: d.title, line };
+}