Skip to content

A free and open source instant messaging and VoIP chat app built for friends, groups, and communities.

TypeScript fluxerfluxerapp

feat(email): attach the operator pass terms as a pdf

Hampusf7dd2287ef96
diff --git a/fluxer_api/pkgs/email/src/operator_pass_terms/OperatorPassTerms.ts b/fluxer_api/pkgs/email/src/operator_pass_terms/OperatorPassTerms.ts
new file mode 100644
index 000000000..4d3852d44
--- /dev/null
+++ b/fluxer_api/pkgs/email/src/operator_pass_terms/OperatorPassTerms.ts
@@ -0,0 +1,75 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+import {
+ OPERATOR_PASS_TERMS_TEXT,
+ type OperatorPassTermsBlock,
+} from '@pkgs/email/src/operator_pass_terms/OperatorPassTermsText';
+
+export const OPERATOR_PASS_TERMS_VERSION = '2026-10-22';
+
+export type OperatorPassTermsLanguage = keyof typeof OPERATOR_PASS_TERMS_TEXT;
+
+const OPERATOR_PASS_TERMS_PATH = '/operator-pass-terms';
+
+export const OPERATOR_PASS_TRADER_EMAIL = '[email protected]';
+
+const TITLES: Record<OperatorPassTermsLanguage, string> = {
+ 'en-US': 'Fluxer Operator Pass terms',
+ 'sv-SE': 'Villkor för Fluxer Operator Pass',
+};
+
+const VERSION_LABELS: Record<OperatorPassTermsLanguage, string> = {
+ 'en-US': 'Version',
+ 'sv-SE': 'Version',
+};
+
+const TRADER_LINES: Record<OperatorPassTermsLanguage, ReadonlyArray<string>> = {
+ 'en-US': [
+ 'Fluxer Platform AB, organization number 559537-3993',
+ 'c/o Embassy House, Östgötagatan 12, 116 25 Stockholm, Sweden',
+ OPERATOR_PASS_TRADER_EMAIL,
+ ],
+ 'sv-SE': [
+ 'Fluxer Platform AB, organisationsnummer 559537-3993',
+ 'c/o Embassy House, Östgötagatan 12, 116 25 Stockholm, Sverige',
+ OPERATOR_PASS_TRADER_EMAIL,
+ ],
+};
+
+const MARKDOWN_LINK = /\[([^\]]+)\]\(([^)]+)\)/gu;
+const ANGLE_LINK = /<([^>\s]+@[^>\s]+)>/gu;
+
+export function resolveOperatorPassTermsLanguage(locale: string | null | undefined): OperatorPassTermsLanguage {
+ return locale?.toLowerCase().startsWith('sv') ? 'sv-SE' : 'en-US';
+}
+
+export function getOperatorPassTermsTitle(language: OperatorPassTermsLanguage): string {
+ return TITLES[language];
+}
+
+export function getOperatorPassTraderLines(language: OperatorPassTermsLanguage): ReadonlyArray<string> {
+ return TRADER_LINES[language];
+}
+
+export function getOperatorPassTermsUrl(marketingBaseUrl: string): string {
+ return `${marketingBaseUrl.replace(/\/+$/u, '')}${OPERATOR_PASS_TERMS_PATH}`;
+}
+
+export function toPlainTermsText(text: string, marketingBaseUrl: string): string {
+ const base = marketingBaseUrl.replace(/\/+$/u, '');
+ return text
+ .replace(MARKDOWN_LINK, (_match, label: string, href: string) => {
+ const url = href.startsWith('/') ? `${base}${href}` : href;
+ const bareUrl = url.replace(/^https?:\/\//u, '');
+ return label === bareUrl || label === url ? url : `${label} (${url})`;
+ })
+ .replace(ANGLE_LINK, '$1');
+}
+
+export function getOperatorPassTermsBlocks(language: OperatorPassTermsLanguage): ReadonlyArray<OperatorPassTermsBlock> {
+ return OPERATOR_PASS_TERMS_TEXT[language];
+}
+
+export function getOperatorPassTermsVersionLabel(language: OperatorPassTermsLanguage): string {
+ return `${VERSION_LABELS[language]} ${OPERATOR_PASS_TERMS_VERSION}`;
+}
diff --git a/fluxer_api/pkgs/email/src/operator_pass_terms/OperatorPassTermsPdf.ts b/fluxer_api/pkgs/email/src/operator_pass_terms/OperatorPassTermsPdf.ts
new file mode 100644
index 000000000..0a754e78d
--- /dev/null
+++ b/fluxer_api/pkgs/email/src/operator_pass_terms/OperatorPassTermsPdf.ts
@@ -0,0 +1,153 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+import {
+ getOperatorPassTermsBlocks,
+ getOperatorPassTermsTitle,
+ getOperatorPassTermsUrl,
+ getOperatorPassTermsVersionLabel,
+ getOperatorPassTraderLines,
+ OPERATOR_PASS_TERMS_VERSION,
+ type OperatorPassTermsLanguage,
+ toPlainTermsText,
+} from '@pkgs/email/src/operator_pass_terms/OperatorPassTerms';
+import type {OperatorPassTermsBlock} from '@pkgs/email/src/operator_pass_terms/OperatorPassTermsText';
+import {PDFDocument, type PDFFont, type PDFPage, rgb, StandardFonts} from 'pdf-lib';
+
+const PAGE_WIDTH = 595.28;
+const PAGE_HEIGHT = 841.89;
+const MARGIN = 56;
+const CONTENT_WIDTH = PAGE_WIDTH - MARGIN * 2;
+const BODY_SIZE = 10;
+const LINE_GAP = 4;
+const TEXT_COLOR = rgb(0.1, 0.1, 0.12);
+const MUTED_COLOR = rgb(0.35, 0.35, 0.4);
+
+interface TextStyle {
+ font: PDFFont;
+ size: number;
+ color: ReturnType<typeof rgb>;
+ indent: number;
+ spaceBefore: number;
+}
+
+class PdfWriter {
+ private page: PDFPage;
+ private cursor: number;
+
+ constructor(private readonly document: PDFDocument) {
+ this.page = document.addPage([PAGE_WIDTH, PAGE_HEIGHT]);
+ this.cursor = PAGE_HEIGHT - MARGIN;
+ }
+
+ write(text: string, style: TextStyle, firstLinePrefix = ''): void {
+ const lineHeight = style.size + LINE_GAP;
+ const width = CONTENT_WIDTH - style.indent;
+ const lines = wrapText(
+ text,
+ style.font,
+ style.size,
+ width - style.font.widthOfTextAtSize(firstLinePrefix, style.size),
+ );
+ this.cursor -= style.spaceBefore;
+ lines.forEach((line, index) => {
+ if (this.cursor - lineHeight < MARGIN) {
+ this.page = this.document.addPage([PAGE_WIDTH, PAGE_HEIGHT]);
+ this.cursor = PAGE_HEIGHT - MARGIN;
+ }
+ this.cursor -= lineHeight;
+ const prefix = index === 0 ? firstLinePrefix : '';
+ const prefixWidth = firstLinePrefix ? style.font.widthOfTextAtSize(firstLinePrefix, style.size) : 0;
+ const x = MARGIN + style.indent + (index === 0 ? 0 : prefixWidth);
+ this.page.drawText(`${prefix}${line}`, {
+ x,
+ y: this.cursor,
+ size: style.size,
+ font: style.font,
+ color: style.color,
+ });
+ });
+ }
+}
+
+function wrapText(text: string, font: PDFFont, size: number, width: number): Array<string> {
+ const lines: Array<string> = [];
+ let current = '';
+ for (const word of text.split(/\s+/u).filter(Boolean)) {
+ const candidate = current ? `${current} ${word}` : word;
+ if (font.widthOfTextAtSize(candidate, size) <= width || !current) {
+ current = candidate;
+ continue;
+ }
+ lines.push(current);
+ current = word;
+ }
+ if (current) {
+ lines.push(current);
+ }
+ return lines;
+}
+
+function styleFor(block: OperatorPassTermsBlock, fonts: {regular: PDFFont; bold: PDFFont; italic: PDFFont}): TextStyle {
+ switch (block.kind) {
+ case 'heading':
+ return {font: fonts.bold, size: 13, color: TEXT_COLOR, indent: 0, spaceBefore: 14};
+ case 'subheading':
+ return {font: fonts.bold, size: 11, color: TEXT_COLOR, indent: 0, spaceBefore: 10};
+ case 'bullet':
+ return {font: fonts.regular, size: BODY_SIZE, color: TEXT_COLOR, indent: 10, spaceBefore: 4};
+ case 'quote':
+ return {font: fonts.italic, size: BODY_SIZE, color: MUTED_COLOR, indent: 14, spaceBefore: 8};
+ default:
+ return {font: fonts.regular, size: BODY_SIZE, color: TEXT_COLOR, indent: 0, spaceBefore: 8};
+ }
+}
+
+export function getOperatorPassTermsPdfFilename(language: OperatorPassTermsLanguage): string {
+ return `fluxer-operator-pass-terms-${OPERATOR_PASS_TERMS_VERSION}-${language}.pdf`;
+}
+
+export async function renderOperatorPassTermsPdf(
+ language: OperatorPassTermsLanguage,
+ marketingBaseUrl: string,
+): Promise<Uint8Array> {
+ const document = await PDFDocument.create();
+ const title = getOperatorPassTermsTitle(language);
+ const issuedAt = new Date(`${OPERATOR_PASS_TERMS_VERSION}T00:00:00Z`);
+ document.setTitle(`${title} (${OPERATOR_PASS_TERMS_VERSION})`);
+ document.setAuthor('Fluxer Platform AB');
+ document.setLanguage(language);
+ document.setCreator('Fluxer');
+ document.setProducer('Fluxer');
+ document.setCreationDate(issuedAt);
+ document.setModificationDate(issuedAt);
+ const fonts = {
+ regular: await document.embedFont(StandardFonts.Helvetica),
+ bold: await document.embedFont(StandardFonts.HelveticaBold),
+ italic: await document.embedFont(StandardFonts.HelveticaOblique),
+ };
+ const writer = new PdfWriter(document);
+ writer.write(title, {font: fonts.bold, size: 18, color: TEXT_COLOR, indent: 0, spaceBefore: 0});
+ writer.write(getOperatorPassTermsVersionLabel(language), {
+ font: fonts.regular,
+ size: BODY_SIZE,
+ color: MUTED_COLOR,
+ indent: 0,
+ spaceBefore: 6,
+ });
+ writer.write(getOperatorPassTermsUrl(marketingBaseUrl), {
+ font: fonts.regular,
+ size: BODY_SIZE,
+ color: MUTED_COLOR,
+ indent: 0,
+ spaceBefore: 2,
+ });
+ for (const block of getOperatorPassTermsBlocks(language)) {
+ const style = styleFor(block, fonts);
+ writer.write(toPlainTermsText(block.text, marketingBaseUrl), style, block.kind === 'bullet' ? '• ' : '');
+ }
+ const traderStyle = {font: fonts.regular, size: BODY_SIZE, color: MUTED_COLOR, indent: 0, spaceBefore: 2};
+ getOperatorPassTraderLines(language).forEach((line, index) => {
+ writer.write(line, {...traderStyle, spaceBefore: index === 0 ? 18 : 2});
+ });
+ return document.save({useObjectStreams: false});
+}