@pallasoft/ps-utilities 2.3.0 → 2.5.0

package/dist/common/constants/email-preview-config.d.ts

@@ -0,0 +1,29 @@
+export declare const EmailPreviewConfig: {
+    readonly documentName: "email.html";
+    readonly documentContentType: "text/html";
+    readonly imageName: "email.png";
+    readonly imageContentType: "image/png";
+    readonly fallbackSubject: "Email";
+    readonly page: {
+        readonly width: 860;
+        readonly padding: 48;
+        readonly headerGap: 28;
+        readonly subjectSize: 22;
+        readonly metaSize: 13;
+        readonly bodySize: 15;
+        readonly lineHeight: 24;
+        readonly maxLines: 140;
+        readonly minHeight: 520;
+        readonly charWidth: 7.4;
+        readonly subjectWidthRatio: 1.45;
+        readonly metaWidthRatio: 0.9;
+        readonly fontFamily: "-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Helvetica, Arial, 'DejaVu Sans', 'Liberation Sans', sans-serif";
+        readonly paperColour: "#ffffff";
+        readonly bandColour: "#0f9d58";
+        readonly bandHeight: 6;
+        readonly ruleColour: "#e4e8ee";
+        readonly subjectColour: "#101828";
+        readonly metaColour: "#667085";
+        readonly bodyColour: "#344054";
+    };
+};

package/dist/common/constants/email-preview-config.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailPreviewConfig = void 0;
+exports.EmailPreviewConfig = {
+    documentName: 'email.html',
+    documentContentType: 'text/html',
+    imageName: 'email.png',
+    imageContentType: 'image/png',
+    fallbackSubject: 'Email',
+    page: {
+        width: 860,
+        padding: 48,
+        headerGap: 28,
+        subjectSize: 22,
+        metaSize: 13,
+        bodySize: 15,
+        lineHeight: 24,
+        maxLines: 140,
+        minHeight: 520,
+        charWidth: 7.4,
+        subjectWidthRatio: 1.45,
+        metaWidthRatio: 0.9,
+        fontFamily: "-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Helvetica, Arial, 'DejaVu Sans', 'Liberation Sans', sans-serif",
+        paperColour: '#ffffff',
+        bandColour: '#0f9d58',
+        bandHeight: 6,
+        ruleColour: '#e4e8ee',
+        subjectColour: '#101828',
+        metaColour: '#667085',
+        bodyColour: '#344054',
+    },
+};

package/dist/common/constants/index.d.ts

@@ -0,0 +1 @@
+export * from './email-preview-config';

package/dist/common/constants/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./email-preview-config"), exports);

package/dist/common/email-preview-service.d.ts

@@ -0,0 +1,15 @@
+import type { EmailPreviewInput } from '../models/email-preview-input';
+export declare class EmailPreviewService {
+    static escape(value: string): string;
+    static hasContent(input: EmailPreviewInput): boolean;
+    static subjectOf(input: EmailPreviewInput): string;
+    static toText(input: EmailPreviewInput): string;
+    static toDocument(input: EmailPreviewInput): string;
+    static toImageMarkup(input: EmailPreviewInput): string;
+    private static clip;
+    private static wrap;
+    private static push;
+    private static fromHtml;
+    private static decode;
+    private static body;
+}

package/dist/common/email-preview-service.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailPreviewService = void 0;
+var email_preview_config_1 = require("./constants/email-preview-config");
+var EmailPreviewService = /** @class */ (function () {
+    function EmailPreviewService() {
+    }
+    EmailPreviewService.escape = function (value) {
+        return value
+            .replace(/&/g, '&')
+            .replace(/</g, '&lt;')
+            .replace(/>/g, '&gt;')
+            .replace(/"/g, '&quot;')
+            .replace(/'/g, '&#39;');
+    };
+    EmailPreviewService.hasContent = function (input) {
+        return ((input.html !== null && input.html.trim() !== '') ||
+            (input.text !== null && input.text.trim() !== ''));
+    };
+    EmailPreviewService.subjectOf = function (input) {
+        return input.subject === null || input.subject.trim() === ''
+            ? email_preview_config_1.EmailPreviewConfig.fallbackSubject
+            : input.subject.trim();
+    };
+    EmailPreviewService.toText = function (input) {
+        if (input.text !== null && input.text.trim() !== '')
+            return input.text.trim();
+        if (input.html === null)
+            return '';
+        return EmailPreviewService.fromHtml(input.html);
+    };
+    EmailPreviewService.toDocument = function (input) {
+        var subject = EmailPreviewService.subjectOf(input);
+        var body = input.html !== null && input.html.trim() !== ''
+            ? EmailPreviewService.body(input.html)
+            : "<pre style=\"white-space:pre-wrap;font-family:inherit;margin:0;\">".concat(EmailPreviewService.escape(input.text === null ? '' : input.text), "</pre>");
+        return "<!doctype html>\n<html lang=\"en\">\n\t<head>\n\t\t<meta charset=\"utf-8\" />\n\t\t<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />\n\t\t<title>".concat(EmailPreviewService.escape(subject), "</title>\n\t</head>\n\t<body style=\"margin:0;padding:24px;background:#f5f7fa;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif;color:#101828;\">\n\t\t<div style=\"max-width:760px;margin:0 auto;background:#ffffff;border:1px solid #e4e8ee;border-radius:12px;overflow:hidden;\">\n\t\t\t<div style=\"padding:16px 20px;border-bottom:1px solid #e4e8ee;background:#f9fafb;\">\n\t\t\t\t<div style=\"font-size:15px;font-weight:700;\">").concat(EmailPreviewService.escape(subject), "</div>\n\t\t\t\t<div style=\"margin-top:4px;font-size:12px;color:#667085;\">From ").concat(EmailPreviewService.escape(input.from), " \u00B7 ").concat(EmailPreviewService.escape(input.receivedAt), "</div>\n\t\t\t</div>\n\t\t\t<div style=\"padding:20px;\">").concat(body, "</div>\n\t\t</div>\n\t</body>\n</html>");
+    };
+    EmailPreviewService.toImageMarkup = function (input) {
+        var page = email_preview_config_1.EmailPreviewConfig.page;
+        var width = page.width - page.padding * 2;
+        var subject = EmailPreviewService.clip(EmailPreviewService.subjectOf(input), Math.floor(width / (page.charWidth * page.subjectWidthRatio)));
+        var meta = EmailPreviewService.clip("From ".concat(input.from, " \u00B7 ").concat(input.receivedAt), Math.floor(width / (page.charWidth * page.metaWidthRatio)));
+        var lines = EmailPreviewService.wrap(EmailPreviewService.toText(input), Math.floor(width / page.charWidth)).slice(0, page.maxLines);
+        var metaBaseline = page.padding + page.subjectSize + 10 + page.metaSize;
+        var bodyTop = metaBaseline + page.headerGap;
+        var height = Math.max(page.minHeight, bodyTop + lines.length * page.lineHeight + page.padding);
+        var body = lines
+            .map(function (line, index) {
+            return "<text x=\"".concat(page.padding, "\" y=\"").concat(bodyTop + index * page.lineHeight, "\" font-size=\"").concat(page.bodySize, "\" fill=\"").concat(page.bodyColour, "\">").concat(EmailPreviewService.escape(line), "</text>");
+        })
+            .join('');
+        return "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"".concat(page.width, "\" height=\"").concat(height, "\" viewBox=\"0 0 ").concat(page.width, " ").concat(height, "\" font-family=\"").concat(page.fontFamily, "\">\n\t<rect width=\"").concat(page.width, "\" height=\"").concat(height, "\" fill=\"").concat(page.paperColour, "\" />\n\t<rect x=\"0\" y=\"0\" width=\"").concat(page.width, "\" height=\"").concat(page.bandHeight, "\" fill=\"").concat(page.bandColour, "\" />\n\t<text x=\"").concat(page.padding, "\" y=\"").concat(page.padding + page.subjectSize, "\" font-size=\"").concat(page.subjectSize, "\" font-weight=\"700\" fill=\"").concat(page.subjectColour, "\">").concat(EmailPreviewService.escape(subject), "</text>\n\t<text x=\"").concat(page.padding, "\" y=\"").concat(metaBaseline, "\" font-size=\"").concat(page.metaSize, "\" fill=\"").concat(page.metaColour, "\">").concat(EmailPreviewService.escape(meta), "</text>\n\t<line x1=\"").concat(page.padding, "\" y1=\"").concat(metaBaseline + 8, "\" x2=\"").concat(page.width - page.padding, "\" y2=\"").concat(metaBaseline + 8, "\" stroke=\"").concat(page.ruleColour, "\" stroke-width=\"1\" />\n\t").concat(body, "\n</svg>");
+    };
+    EmailPreviewService.clip = function (value, limit) {
+        return value.length <= limit ? value : "".concat(value.slice(0, Math.max(limit - 1, 1)), "\u2026");
+    };
+    EmailPreviewService.wrap = function (text, limit) {
+        var lines = [];
+        for (var _i = 0, _a = text.split('\n'); _i < _a.length; _i++) {
+            var paragraph = _a[_i];
+            if (paragraph.trim() === '') {
+                lines.push('');
+                continue;
+            }
+            var current = '';
+            for (var _b = 0, _c = paragraph.trim().split(/\s+/); _b < _c.length; _b++) {
+                var word = _c[_b];
+                var candidate = current === '' ? word : "".concat(current, " ").concat(word);
+                if (candidate.length <= limit) {
+                    current = candidate;
+                    continue;
+                }
+                if (current !== '')
+                    lines.push(current);
+                current = word.length <= limit ? word : EmailPreviewService.push(lines, word, limit);
+            }
+            lines.push(current);
+        }
+        return lines;
+    };
+    EmailPreviewService.push = function (lines, word, limit) {
+        var rest = word;
+        while (rest.length > limit) {
+            lines.push(rest.slice(0, limit));
+            rest = rest.slice(limit);
+        }
+        return rest;
+    };
+    EmailPreviewService.fromHtml = function (html) {
+        return EmailPreviewService.decode(html
+            .replace(/<script\b[^>]*>[\s\S]*?<\/script>/gi, '')
+            .replace(/<style\b[^>]*>[\s\S]*?<\/style>/gi, '')
+            .replace(/<head\b[^>]*>[\s\S]*?<\/head>/gi, '')
+            .replace(/<br\s*\/?>/gi, '\n')
+            .replace(/<\/(p|div|tr|li|h[1-6]|table|section|header|footer)>/gi, '\n')
+            .replace(/<[^>]+>/g, ' '))
+            .replace(/[^\S\n]+/g, ' ')
+            .replace(/ *\n */g, '\n')
+            .replace(/\n{3,}/g, '\n\n')
+            .trim();
+    };
+    EmailPreviewService.decode = function (value) {
+        return value
+            .replace(/&nbsp;/gi, ' ')
+            .replace(/&amp;/gi, '&')
+            .replace(/&lt;/gi, '<')
+            .replace(/&gt;/gi, '>')
+            .replace(/&quot;/gi, '"')
+            .replace(/&#0?39;|&#x27;|&apos;/gi, "'")
+            .replace(/&#8217;|&rsquo;/gi, '’')
+            .replace(/&#8212;|&mdash;/gi, '—')
+            .replace(/&#8211;|&ndash;/gi, '–');
+    };
+    EmailPreviewService.body = function (html) {
+        var withoutScripts = html
+            .replace(/<script\b[^>]*>[\s\S]*?<\/script>/gi, '')
+            .replace(/<iframe\b[^>]*>[\s\S]*?<\/iframe>/gi, '')
+            .replace(/\son[a-z]+\s*=\s*"[^"]*"/gi, '')
+            .replace(/\son[a-z]+\s*=\s*'[^']*'/gi, '');
+        var inner = withoutScripts.match(/<body[^>]*>([\s\S]*?)<\/body>/i);
+        return inner === null ? withoutScripts : inner[1];
+    };
+    return EmailPreviewService;
+}());
+exports.EmailPreviewService = EmailPreviewService;

package/dist/common/index.d.ts

@@ -1,5 +1,7 @@
 export * from './color-service';
+export * from './constants';
 export * from './crypto-service';
+export * from './email-preview-service';
 export * from './encrypted-fields-service';
 export * from './envelope-crypto-service';
 export * from './date-service';

package/dist/common/index.js

@@ -15,7 +15,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./color-service"), exports);
+__exportStar(require("./constants"), exports);
 __exportStar(require("./crypto-service"), exports);
+__exportStar(require("./email-preview-service"), exports);
 __exportStar(require("./encrypted-fields-service"), exports);
 __exportStar(require("./envelope-crypto-service"), exports);
 __exportStar(require("./date-service"), exports);

package/dist/index.d.ts

@@ -2,5 +2,6 @@ import * as ClientNamespace from './client';
 import * as CommonNamespace from './common';
 export declare const Common: typeof CommonNamespace;
 export declare const Client: typeof ClientNamespace;
+export type { EmailPreviewInput } from './models/email-preview-input';
 export type { EncryptedFieldsSpec } from './common/encrypted-fields-service';
 export type { DataKeyPair } from './common/envelope-crypto-service';

package/dist/models/email-preview-input.d.ts

@@ -0,0 +1,7 @@
+export interface EmailPreviewInput {
+    from: string;
+    html: string | null;
+    receivedAt: string;
+    subject: string | null;
+    text: string | null;
+}

package/dist/models/email-preview-input.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@pallasoft/ps-utilities",
-	"version": "2.3.0",
+	"version": "2.5.0",
 	"private": false,
 	"main": "./dist/index.js",
 	"types": "./dist/index.d.ts",
@@ -41,27 +41,27 @@
 		"@commitlint/config-conventional": "^20.0.0",
 		"@eslint/compat": "^2.0.0",
 		"@ianvs/prettier-plugin-sort-imports": "^4.7.0",
+		"@semantic-release/changelog": "^6.0.3",
+		"@semantic-release/commit-analyzer": "^13.0.0",
+		"@semantic-release/git": "^10.0.1",
+		"@semantic-release/github": "^11.0.1",
+		"@semantic-release/npm": "^12.0.0",
+		"@semantic-release/release-notes-generator": "^14.0.1",
 		"@typescript-eslint/eslint-plugin": "^8.48.0",
 		"@typescript-eslint/parser": "^8.48.0",
 		"commitlint": "^20.1.0",
+		"conventional-changelog-conventionalcommits": "^7.0.2",
 		"eslint": "^9.39.1",
 		"eslint-config-prettier": "^10.1.8",
 		"eslint-plugin-import": "^2.32.0",
 		"eslint-plugin-prettier": "^5.5.4",
+		"hono": "^4.12.18",
 		"husky": "^9.1.7",
 		"lint-staged": "^16.2.7",
 		"prettier": "^3.6.2",
-		"hono": "^4.12.18",
+		"semantic-release": "^24.2.0",
 		"ts-node": "^10.9.2",
-		"typescript": "^5.9.3",
-		"@semantic-release/changelog": "^6.0.3",
-		"@semantic-release/commit-analyzer": "^13.0.0",
-		"@semantic-release/git": "^10.0.1",
-		"@semantic-release/github": "^11.0.1",
-		"@semantic-release/npm": "^12.0.0",
-		"@semantic-release/release-notes-generator": "^14.0.1",
-		"conventional-changelog-conventionalcommits": "^7.0.2",
-		"semantic-release": "^24.2.0"
+		"typescript": "^5.9.3"
 	},
 	"peerDependencies": {
 		"hono": "^4.0.0"