feat: overhaul public landing page and backup tooling

This commit is contained in:
2025-09-19 16:07:43 +02:00
parent ad9c6d63d3
commit 2a4d38813f
72 changed files with 4332 additions and 1466 deletions
File diff suppressed because it is too large Load Diff
+262
View File
@@ -0,0 +1,262 @@
const crypto = require('crypto');
const sanitizeHtml = require('sanitize-html');
const { db } = require('../database/db');
const logger = require('../utils/logger');
const { sanitizeCss } = require('../utils/cssSanitizer');
const {
DEFAULT_PUBLIC_SITE_TITLE,
DEFAULT_PUBLIC_SITE_HTML,
DEFAULT_PUBLIC_SITE_CSS,
} = require('../constants/publicSiteDefaults');
const CACHE_TTL_MS = Number(process.env.PUBLIC_SITE_CACHE_TTL_MS || 60_000);
let cachedPayload = null;
let cacheExpiresAt = 0;
const ALLOWED_HTML_TAGS = [
'a', 'article', 'aside', 'blockquote', 'br', 'button', 'caption', 'div',
'em', 'figure', 'figcaption', 'footer', 'h1', 'h2', 'h3', 'h4', 'h5', 'h6',
'header', 'hr', 'img', 'li', 'main', 'nav', 'ol', 'p', 'section', 'span',
'strong', 'sup', 'sub', 'table', 'tbody', 'td', 'tfoot', 'th', 'thead', 'tr',
'ul'
];
const COMMON_ATTRIBUTES = ['class', 'id', 'role', 'aria-label', 'aria-hidden'];
function parseSettingValue(value) {
if (value === null || value === undefined) {
return null;
}
try {
return JSON.parse(value);
} catch (error) {
return value;
}
}
async function fetchPublicSiteSettings() {
const rows = await db('app_settings')
.whereIn('setting_key', [
'general_public_site_enabled',
'general_public_site_html',
'general_public_site_custom_css'
]);
const map = {
general_public_site_enabled: false,
general_public_site_html: DEFAULT_PUBLIC_SITE_HTML,
general_public_site_custom_css: ''
};
rows.forEach((row) => {
const parsed = parseSettingValue(row.setting_value);
map[row.setting_key] = parsed == null ? map[row.setting_key] : parsed;
});
return map;
}
function sanitizeBrandUrl(url) {
if (typeof url !== 'string' || !url.trim()) {
return null;
}
const trimmed = url.trim();
if (trimmed.startsWith('javascript:')) {
return null;
}
return trimmed;
}
async function fetchBrandingContext() {
const rows = await db('app_settings')
.whereIn('setting_key', [
'branding_company_name',
'branding_company_tagline',
'branding_support_email',
'branding_logo_url',
'branding_footer_text',
'theme_config'
]);
const context = {
companyName: null,
companyTagline: null,
supportEmail: null,
logoUrl: null,
footerText: null,
colors: {
primary: '#16a34a',
accent: '#0f766e',
background: '#f4fbf6',
text: '#0f172a'
}
};
rows.forEach((row) => {
const parsed = parseSettingValue(row.setting_value);
switch (row.setting_key) {
case 'branding_company_name':
context.companyName = parsed || context.companyName;
break;
case 'branding_company_tagline':
context.companyTagline = parsed || context.companyTagline;
break;
case 'branding_support_email':
context.supportEmail = parsed || context.supportEmail;
break;
case 'branding_logo_url':
context.logoUrl = sanitizeBrandUrl(parsed);
break;
case 'branding_footer_text':
context.footerText = parsed || context.footerText;
break;
case 'theme_config': {
try {
const themeConfig = typeof parsed === 'string' ? JSON.parse(parsed) : parsed;
if (themeConfig && typeof themeConfig === 'object') {
context.colors.primary = themeConfig.primaryColor || context.colors.primary;
context.colors.accent = themeConfig.accentColor || context.colors.accent;
context.colors.background = themeConfig.backgroundColor || context.colors.background;
context.colors.text = themeConfig.textColor || context.colors.text;
}
} catch (error) {
logger.warn('Failed to parse theme configuration for public site', { error: error.message });
}
break;
}
default:
break;
}
});
return context;
}
function sanitizeHtmlPayload(html) {
const sanitized = sanitizeHtml(html || '', {
allowedTags: ALLOWED_HTML_TAGS,
allowedAttributes: {
'*': COMMON_ATTRIBUTES,
a: ['href', 'target', 'rel', ...COMMON_ATTRIBUTES],
img: ['src', 'alt', 'title', 'width', 'height', 'loading', 'decoding', ...COMMON_ATTRIBUTES],
button: ['type', ...COMMON_ATTRIBUTES]
},
allowedSchemes: ['http', 'https', 'mailto', 'tel'],
allowedSchemesByTag: { img: ['http', 'https', 'data'] },
transformTags: {
a: (tagName, attribs) => {
const transformed = { ...attribs };
if (transformed.href && !/^https?:|^mailto:|^tel:/i.test(transformed.href)) {
// sanitize-html will remove disallowed schemes, but we guard as well
delete transformed.href;
}
if (transformed.target === '_blank') {
transformed.rel = transformed.rel ? `${transformed.rel} noopener noreferrer`.trim() : 'noopener noreferrer';
}
return { tagName, attribs: transformed };
}
},
nonBooleanAttributes: ['target'],
parser: {
lowerCaseAttributeNames: true
}
});
return sanitized;
}
function buildCachedPayload(raw) {
const sanitizedHtml = sanitizeHtmlPayload(raw.publicSite.general_public_site_html || DEFAULT_PUBLIC_SITE_HTML);
const sanitizedCss = sanitizeCss(raw.publicSite.general_public_site_custom_css || '');
const enabled = Boolean(raw.publicSite.general_public_site_enabled);
const title = raw.branding.companyName || DEFAULT_PUBLIC_SITE_TITLE;
const baseCss = sanitizeCss(DEFAULT_PUBLIC_SITE_CSS);
const substitutedHtml = applyBrandTokens(sanitizedHtml, raw.branding);
const hash = crypto
.createHash('sha1')
.update(`${enabled}|${substitutedHtml}|${sanitizedCss}|${baseCss}|${JSON.stringify(raw.branding)}`)
.digest('hex');
return {
enabled,
html: substitutedHtml,
css: sanitizedCss,
baseCss,
title,
branding: raw.branding,
etag: `W/"${hash}"`
};
}
async function getPublicSitePayload({ bypassCache = false } = {}) {
if (!bypassCache && cachedPayload && Date.now() < cacheExpiresAt) {
return cachedPayload;
}
const [publicSite, branding] = await Promise.all([
fetchPublicSiteSettings(),
fetchBrandingContext()
]);
const payload = buildCachedPayload({ publicSite, branding });
cachedPayload = payload;
cacheExpiresAt = Date.now() + CACHE_TTL_MS;
return payload;
}
function clearPublicSiteCache() {
cachedPayload = null;
cacheExpiresAt = 0;
}
async function getDefaultPublicSitePayload() {
const branding = await fetchBrandingContext();
return buildCachedPayload({
publicSite: {
general_public_site_enabled: false,
general_public_site_html: DEFAULT_PUBLIC_SITE_HTML,
general_public_site_custom_css: ''
},
branding
});
}
async function getRawPublicSiteSettings() {
return fetchPublicSiteSettings();
}
function applyBrandTokens(html, branding) {
if (!html) {
return html;
}
const tokens = {
company_name: branding.companyName || '',
company_tagline: branding.companyTagline || '',
support_email: branding.supportEmail || '',
brand_logo_url: branding.logoUrl || '/picpeak-logo-transparent.png',
brand_primary_hex: branding.colors?.primary || '#2563eb',
brand_accent_hex: branding.colors?.accent || '#1d4ed8',
brand_background_hex: branding.colors?.background || '#f8fafc',
brand_text_hex: branding.colors?.text || '#0f172a'
};
return html.replace(/\{\{\s*(company_name|company_tagline|support_email|brand_logo_url|brand_primary_hex|brand_accent_hex|brand_background_hex|brand_text_hex)\s*\}\}/gi,
(_, key) => tokens[key] || '');
}
module.exports = {
getPublicSitePayload,
clearPublicSiteCache,
getDefaultPublicSitePayload,
getRawPublicSiteSettings
};
@@ -1,5 +1,5 @@
const S3StorageAdapter = require('../s3Storage');
const { S3Client } = require('@aws-sdk/client-s3');
const { S3Client, HeadBucketCommand, HeadObjectCommand, ListObjectsV2Command } = require('@aws-sdk/client-s3');
const { Upload } = require('@aws-sdk/lib-storage');
const fs = require('fs');
const stream = require('stream');
@@ -24,6 +24,10 @@ describe('S3StorageAdapter', () => {
send: mockSend
};
S3Client.mockImplementation(() => mockS3Client);
HeadBucketCommand.mockImplementation((input) => ({ input }));
HeadObjectCommand.mockImplementation((input) => ({ input }));
ListObjectsV2Command.mockImplementation((input) => ({ input }));
// Create adapter instance
s3Storage = new S3StorageAdapter({
@@ -70,11 +74,7 @@ describe('S3StorageAdapter', () => {
const result = await s3Storage.testConnection();
expect(result).toBe(true);
expect(mockSend).toHaveBeenCalledWith(
expect.objectContaining({
input: { Bucket: 'test-bucket' }
})
);
expect(HeadBucketCommand).toHaveBeenCalledWith({ Bucket: 'test-bucket' });
});
it('should throw error on connection failure', async () => {
@@ -132,24 +132,25 @@ describe('S3StorageAdapter', () => {
it('should track upload progress', async () => {
const onProgress = jest.fn();
let progressCallback;
mockUpload.on.mockImplementation((event, callback) => {
if (event === 'httpUploadProgress') {
progressCallback = callback;
}
return mockUpload;
Upload.mockImplementation(() => {
const uploadInstance = {
on: jest.fn((event, handler) => {
if (event === 'httpUploadProgress') {
handler({ loaded: 512, total: 1024 });
}
return uploadInstance;
}),
done: mockDone
};
return uploadInstance;
});
const uploadPromise = s3Storage.upload('/path/to/file.jpg', 'test-key', {
onProgress
});
// Simulate progress
progressCallback({ loaded: 512, total: 1024 });
await uploadPromise;
expect(onProgress).toHaveBeenCalledWith(512, 1024);
});
@@ -177,11 +178,10 @@ describe('S3StorageAdapter', () => {
const result = await s3Storage.exists('test-key');
expect(result).toBe(true);
expect(mockSend).toHaveBeenCalledWith(
expect.objectContaining({
input: { Bucket: 'test-bucket', Key: 'test-key' }
})
);
expect(HeadObjectCommand).toHaveBeenCalledWith({
Bucket: 'test-bucket',
Key: 'test-key'
});
});
it('should return false if object does not exist', async () => {
@@ -220,58 +220,51 @@ describe('S3StorageAdapter', () => {
it('should retry on retryable errors', async () => {
const retryableError = new Error('Connection reset');
retryableError.code = 'ECONNRESET';
// First attempt fails, second succeeds
mockSend
const operation = jest.fn()
.mockRejectedValueOnce(retryableError)
.mockResolvedValueOnce({});
// Mock setTimeout to speed up test
jest.useFakeTimers();
const promise = s3Storage.exists('test-key');
// Advance timers
jest.runAllTimers();
const result = await promise;
expect(result).toBe(true);
expect(mockSend).toHaveBeenCalledTimes(2);
jest.useRealTimers();
.mockResolvedValueOnce('success');
const originalRandom = Math.random;
const originalDelay = s3Storage.config.retryDelay;
Math.random = jest.fn(() => 0);
s3Storage.config.retryDelay = 0;
const result = await s3Storage._retryOperation(operation);
expect(result).toBe('success');
expect(operation).toHaveBeenCalledTimes(2);
Math.random = originalRandom;
s3Storage.config.retryDelay = originalDelay;
});
it('should not retry on non-retryable errors', async () => {
const nonRetryableError = new Error('Invalid credentials');
nonRetryableError.code = 'InvalidCredentials';
mockSend.mockRejectedValueOnce(nonRetryableError);
await expect(s3Storage.exists('test-key')).rejects.toThrow('Invalid credentials');
expect(mockSend).toHaveBeenCalledTimes(1);
const operation = jest.fn().mockRejectedValueOnce(nonRetryableError);
await expect(s3Storage._retryOperation(operation)).rejects.toThrow('Invalid credentials');
expect(operation).toHaveBeenCalledTimes(1);
});
it('should stop retrying after max attempts', async () => {
const retryableError = new Error('Service unavailable');
retryableError.code = 'ServiceUnavailable';
mockSend.mockRejectedValue(retryableError);
// Mock setTimeout to speed up test
jest.useFakeTimers();
const promise = s3Storage.exists('test-key');
// Advance timers for all retries
for (let i = 0; i < 4; i++) {
jest.runAllTimers();
}
await expect(promise).rejects.toThrow('Service unavailable');
expect(mockSend).toHaveBeenCalledTimes(4); // Initial + 3 retries
jest.useRealTimers();
const operation = jest.fn().mockRejectedValue(retryableError);
const originalRandom = Math.random;
const originalDelay = s3Storage.config.retryDelay;
Math.random = jest.fn(() => 0);
s3Storage.config.retryDelay = 0;
await expect(s3Storage._retryOperation(operation)).rejects.toThrow('Service unavailable');
expect(operation).toHaveBeenCalledTimes(4); // initial + 3 retries
Math.random = originalRandom;
s3Storage.config.retryDelay = originalDelay;
});
});
@@ -308,4 +301,4 @@ describe('S3StorageAdapter', () => {
expect(s3Storage._formatBytes(1536, 1)).toBe('1.5 KB');
});
});
});
});