@pallasoft/ps-mail 1.5.0 → 1.6.0

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

@@ -0,0 +1,2 @@
+export * from './mail-driver';
+export * from './sandbox-mail-config';

package/dist/sandbox/constants/index.js

@@ -0,0 +1,18 @@
+"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("./mail-driver"), exports);
+__exportStar(require("./sandbox-mail-config"), exports);

package/dist/sandbox/constants/mail-driver.d.ts

@@ -0,0 +1,4 @@
+export declare enum MailDriver {
+    Graph = "graph",
+    Sandbox = "sandbox"
+}

package/dist/sandbox/constants/mail-driver.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MailDriver = void 0;
+var MailDriver;
+(function (MailDriver) {
+    MailDriver["Graph"] = "graph";
+    MailDriver["Sandbox"] = "sandbox";
+})(MailDriver || (exports.MailDriver = MailDriver = {}));

package/dist/sandbox/constants/sandbox-mail-config.d.ts

@@ -0,0 +1,38 @@
+export declare const SandboxMailConfig: {
+    readonly outboxLimit: 200;
+    readonly connection: {
+        readonly tenantId: "sandbox-tenant";
+        readonly clientId: "sandbox-client";
+        readonly clientSecret: "sandbox-secret";
+    };
+    readonly subscription: {
+        readonly idPrefix: "sandbox-subscription";
+        readonly resource: "sandbox/mailFolders/inbox/messages";
+        readonly lifetimeHours: 70;
+    };
+    readonly deltaLinkPrefix: "sandbox-delta";
+    readonly messageIdPrefix: "sandbox-message";
+    readonly internetMessageIdDomain: "sandbox.test";
+    readonly headers: {
+        readonly inReplyTo: "In-Reply-To";
+        readonly references: "References";
+    };
+    readonly millisecondsPerHour: 3600000;
+    readonly productionDriverError: "MAIL_DRIVER=sandbox is not allowed in production, mail must go through the real provider";
+    readonly unknownDriverError: "MAIL_DRIVER must be graph or sandbox";
+    readonly tagPattern: RegExp;
+    readonly breakPattern: RegExp;
+    readonly stylePattern: RegExp;
+    readonly whitespacePattern: RegExp;
+    readonly blankLinesPattern: RegExp;
+    readonly entityPattern: RegExp;
+    readonly lineEdgePattern: RegExp;
+    readonly entities: {
+        readonly ' ': " ";
+        readonly '&': "&";
+        readonly '&lt;': "<";
+        readonly '&gt;': ">";
+        readonly '&quot;': "\"";
+        readonly '&#39;': "'";
+    };
+};

package/dist/sandbox/constants/sandbox-mail-config.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SandboxMailConfig = void 0;
+exports.SandboxMailConfig = {
+    outboxLimit: 200,
+    connection: {
+        tenantId: 'sandbox-tenant',
+        clientId: 'sandbox-client',
+        clientSecret: 'sandbox-secret',
+    },
+    subscription: {
+        idPrefix: 'sandbox-subscription',
+        resource: 'sandbox/mailFolders/inbox/messages',
+        lifetimeHours: 70,
+    },
+    deltaLinkPrefix: 'sandbox-delta',
+    messageIdPrefix: 'sandbox-message',
+    internetMessageIdDomain: 'sandbox.test',
+    headers: {
+        inReplyTo: 'In-Reply-To',
+        references: 'References',
+    },
+    millisecondsPerHour: 3600000,
+    productionDriverError: 'MAIL_DRIVER=sandbox is not allowed in production, mail must go through the real provider',
+    unknownDriverError: 'MAIL_DRIVER must be graph or sandbox',
+    tagPattern: /<[^>]*>/g,
+    breakPattern: /<\s*(br|\/p|\/div|\/tr|\/li|\/h[1-6])\s*\/?>/gi,
+    stylePattern: /<(style|script|head)[\s\S]*?<\/\1>/gi,
+    whitespacePattern: /[ \t]+/g,
+    blankLinesPattern: /\n{3,}/g,
+    entityPattern: /&(nbsp|amp|lt|gt|quot|#39);/g,
+    lineEdgePattern: / ?\n ?/g,
+    entities: { '&nbsp;': ' ', '&amp;': '&', '&lt;': '<', '&gt;': '>', '&quot;': '"', '&#39;': "'" },
+};

package/dist/sandbox/index.d.ts

@@ -0,0 +1,3 @@
+export { MailDriver, SandboxMailConfig } from './constants';
+export type { SandboxCaptureInput, SandboxCapturedMailData, SandboxInboundInput, SandboxOutboxRowData, } from './models';
+export { MailDriverService, SandboxCaptureService, SandboxInboundService, SandboxMailService, } from './services';

package/dist/sandbox/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SandboxMailService = exports.SandboxInboundService = exports.SandboxCaptureService = exports.MailDriverService = exports.SandboxMailConfig = exports.MailDriver = void 0;
+var constants_1 = require("./constants");
+Object.defineProperty(exports, "MailDriver", { enumerable: true, get: function () { return constants_1.MailDriver; } });
+Object.defineProperty(exports, "SandboxMailConfig", { enumerable: true, get: function () { return constants_1.SandboxMailConfig; } });
+var services_1 = require("./services");
+Object.defineProperty(exports, "MailDriverService", { enumerable: true, get: function () { return services_1.MailDriverService; } });
+Object.defineProperty(exports, "SandboxCaptureService", { enumerable: true, get: function () { return services_1.SandboxCaptureService; } });
+Object.defineProperty(exports, "SandboxInboundService", { enumerable: true, get: function () { return services_1.SandboxInboundService; } });
+Object.defineProperty(exports, "SandboxMailService", { enumerable: true, get: function () { return services_1.SandboxMailService; } });

package/dist/sandbox/models/index.d.ts

@@ -0,0 +1,4 @@
+export type { SandboxCaptureInput } from './sandbox-capture-input';
+export type { SandboxCapturedMailData } from './sandbox-captured-mail-data';
+export type { SandboxInboundInput } from './sandbox-inbound-input';
+export type { SandboxOutboxRowData } from './sandbox-outbox-row-data';

package/dist/sandbox/models/index.js

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

package/dist/sandbox/models/sandbox-capture-input.d.ts

@@ -0,0 +1,13 @@
+import type { GraphMailBodyData } from '../../microsoft/models/graph-mail-body-data';
+import type { MailAddressData } from '../../models/mail-address-data';
+export interface SandboxCaptureInput {
+    mailbox: string;
+    fromName?: string;
+    to: MailAddressData[];
+    cc?: MailAddressData[];
+    subject: string;
+    body: GraphMailBodyData;
+    kind?: string;
+    ticketId?: string;
+    createdAt?: Date;
+}

package/dist/sandbox/models/sandbox-capture-input.js

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

package/dist/sandbox/models/sandbox-captured-mail-data.d.ts

@@ -0,0 +1,13 @@
+import type { MailAddressData } from '../../models/mail-address-data';
+export interface SandboxCapturedMailData {
+    mailbox: string;
+    from: MailAddressData;
+    to: MailAddressData[];
+    cc: MailAddressData[];
+    subject: string;
+    html: string | null;
+    text: string;
+    kind: string | null;
+    ticketId: string | null;
+    createdAt: string;
+}

package/dist/sandbox/models/sandbox-captured-mail-data.js

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

package/dist/sandbox/models/sandbox-inbound-input.d.ts

@@ -0,0 +1,10 @@
+export interface SandboxInboundInput {
+    mailbox: string;
+    fromAddress: string;
+    fromName?: string;
+    subject: string;
+    body: string;
+    inReplyToMessageId?: string;
+    receivedAt?: Date;
+    id?: string;
+}

package/dist/sandbox/models/sandbox-inbound-input.js

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

package/dist/sandbox/models/sandbox-outbox-row-data.d.ts

@@ -0,0 +1,4 @@
+export interface SandboxOutboxRowData {
+    id: string;
+    createdAt: Date | string;
+}

package/dist/sandbox/models/sandbox-outbox-row-data.js

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

package/dist/sandbox/services/index.d.ts

@@ -0,0 +1,4 @@
+export * from './mail-driver-service';
+export * from './sandbox-capture-service';
+export * from './sandbox-inbound-service';
+export * from './sandbox-mail-service';

package/dist/sandbox/services/index.js

@@ -0,0 +1,20 @@
+"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("./mail-driver-service"), exports);
+__exportStar(require("./sandbox-capture-service"), exports);
+__exportStar(require("./sandbox-inbound-service"), exports);
+__exportStar(require("./sandbox-mail-service"), exports);

package/dist/sandbox/services/mail-driver-service.d.ts

@@ -0,0 +1,6 @@
+import { MailDriver } from '../constants/mail-driver';
+export declare class MailDriverService {
+    static resolve(value: string | undefined | null): MailDriver;
+    static assertAllowed(driver: MailDriver, isProduction: boolean): MailDriver;
+    static isSandbox(value: string | undefined | null): boolean;
+}

package/dist/sandbox/services/mail-driver-service.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MailDriverService = void 0;
+var mail_driver_1 = require("../constants/mail-driver");
+var sandbox_mail_config_1 = require("../constants/sandbox-mail-config");
+var MailDriverService = /** @class */ (function () {
+    function MailDriverService() {
+    }
+    MailDriverService.resolve = function (value) {
+        var normalized = typeof value === 'string' ? value.trim().toLowerCase() : '';
+        if (normalized === '' || normalized === mail_driver_1.MailDriver.Graph)
+            return mail_driver_1.MailDriver.Graph;
+        if (normalized === mail_driver_1.MailDriver.Sandbox)
+            return mail_driver_1.MailDriver.Sandbox;
+        throw new Error(sandbox_mail_config_1.SandboxMailConfig.unknownDriverError);
+    };
+    MailDriverService.assertAllowed = function (driver, isProduction) {
+        if (isProduction && driver === mail_driver_1.MailDriver.Sandbox)
+            throw new Error(sandbox_mail_config_1.SandboxMailConfig.productionDriverError);
+        return driver;
+    };
+    MailDriverService.isSandbox = function (value) {
+        return this.resolve(value) === mail_driver_1.MailDriver.Sandbox;
+    };
+    return MailDriverService;
+}());
+exports.MailDriverService = MailDriverService;

package/dist/sandbox/services/sandbox-capture-service.d.ts

@@ -0,0 +1,8 @@
+import type { SandboxCaptureInput } from '../models/sandbox-capture-input';
+import type { SandboxCapturedMailData } from '../models/sandbox-captured-mail-data';
+import type { SandboxOutboxRowData } from '../models/sandbox-outbox-row-data';
+export declare class SandboxCaptureService {
+    static capture(input: SandboxCaptureInput): SandboxCapturedMailData;
+    static htmlToText(html: string): string;
+    static overflowIds(rows: SandboxOutboxRowData[], limit?: number): string[];
+}

package/dist/sandbox/services/sandbox-capture-service.js

@@ -0,0 +1,71 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SandboxCaptureService = void 0;
+var graph_mail_body_type_1 = require("../../microsoft/constants/graph-mail-body-type");
+var sandbox_mail_config_1 = require("../constants/sandbox-mail-config");
+var SandboxCaptureService = /** @class */ (function () {
+    function SandboxCaptureService() {
+    }
+    SandboxCaptureService.capture = function (input) {
+        var isHtml = input.body.contentType === graph_mail_body_type_1.GraphMailBodyType.Html;
+        var created = input.createdAt === undefined ? new Date() : input.createdAt;
+        return {
+            mailbox: input.mailbox,
+            from: __assign({ address: input.mailbox }, (input.fromName === undefined ? {} : { name: input.fromName })),
+            to: input.to,
+            cc: input.cc === undefined ? [] : input.cc,
+            subject: input.subject,
+            html: isHtml ? input.body.content : null,
+            text: isHtml ? this.htmlToText(input.body.content) : input.body.content,
+            kind: input.kind === undefined ? null : input.kind,
+            ticketId: input.ticketId === undefined ? null : input.ticketId,
+            createdAt: created.toISOString(),
+        };
+    };
+    SandboxCaptureService.htmlToText = function (html) {
+        var decoded = html
+            .replace(sandbox_mail_config_1.SandboxMailConfig.stylePattern, '')
+            .replace(sandbox_mail_config_1.SandboxMailConfig.breakPattern, '\n')
+            .replace(sandbox_mail_config_1.SandboxMailConfig.tagPattern, '');
+        var entities = sandbox_mail_config_1.SandboxMailConfig.entities;
+        var text = decoded.replace(sandbox_mail_config_1.SandboxMailConfig.entityPattern, function (match) {
+            var replacement = entities[match];
+            return replacement === undefined ? match : replacement;
+        });
+        return text
+            .replace(sandbox_mail_config_1.SandboxMailConfig.whitespacePattern, ' ')
+            .replace(sandbox_mail_config_1.SandboxMailConfig.lineEdgePattern, '\n')
+            .replace(sandbox_mail_config_1.SandboxMailConfig.blankLinesPattern, '\n\n')
+            .trim();
+    };
+    SandboxCaptureService.overflowIds = function (rows, limit) {
+        if (limit === void 0) { limit = sandbox_mail_config_1.SandboxMailConfig.outboxLimit; }
+        if (rows.length <= limit)
+            return [];
+        return __spreadArray([], rows, true).sort(function (a, b) { return new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime(); })
+            .slice(limit)
+            .map(function (row) { return row.id; });
+    };
+    return SandboxCaptureService;
+}());
+exports.SandboxCaptureService = SandboxCaptureService;

package/dist/sandbox/services/sandbox-inbound-service.d.ts

@@ -0,0 +1,6 @@
+import type { GraphMailMessageData } from '../../microsoft/models/graph-mail-message-data';
+import type { SandboxInboundInput } from '../models/sandbox-inbound-input';
+export declare class SandboxInboundService {
+    static build(input: SandboxInboundInput): GraphMailMessageData;
+    private static _id;
+}

package/dist/sandbox/services/sandbox-inbound-service.js

@@ -0,0 +1,58 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SandboxInboundService = void 0;
+var graph_mail_body_type_1 = require("../../microsoft/constants/graph-mail-body-type");
+var sandbox_mail_config_1 = require("../constants/sandbox-mail-config");
+var SandboxInboundService = /** @class */ (function () {
+    function SandboxInboundService() {
+    }
+    SandboxInboundService.build = function (input) {
+        var received = (input.receivedAt === undefined ? new Date() : input.receivedAt).toISOString();
+        var id = input.id === undefined ? this._id(received) : input.id;
+        var sender = {
+            emailAddress: __assign({ address: input.fromAddress }, (input.fromName === undefined ? {} : { name: input.fromName })),
+        };
+        var headers = input.inReplyToMessageId === undefined
+            ? []
+            : [
+                { name: sandbox_mail_config_1.SandboxMailConfig.headers.inReplyTo, value: input.inReplyToMessageId },
+                { name: sandbox_mail_config_1.SandboxMailConfig.headers.references, value: input.inReplyToMessageId },
+            ];
+        return {
+            id: id,
+            conversationId: id,
+            internetMessageId: "<".concat(id, "@").concat(sandbox_mail_config_1.SandboxMailConfig.internetMessageIdDomain, ">"),
+            subject: input.subject,
+            from: sender,
+            sender: sender,
+            toRecipients: [{ emailAddress: { address: input.mailbox } }],
+            ccRecipients: [],
+            replyTo: [],
+            receivedDateTime: received,
+            sentDateTime: received,
+            hasAttachments: false,
+            isDraft: false,
+            categories: [],
+            bodyPreview: input.body.slice(0, 255),
+            body: { contentType: graph_mail_body_type_1.GraphMailBodyType.Text, content: input.body },
+            uniqueBody: { contentType: graph_mail_body_type_1.GraphMailBodyType.Text, content: input.body },
+            internetMessageHeaders: headers,
+        };
+    };
+    SandboxInboundService._id = function (received) {
+        return "".concat(sandbox_mail_config_1.SandboxMailConfig.messageIdPrefix, "-").concat(received, "-").concat(crypto.randomUUID());
+    };
+    return SandboxInboundService;
+}());
+exports.SandboxInboundService = SandboxInboundService;

package/dist/sandbox/services/sandbox-mail-service.d.ts

@@ -0,0 +1,11 @@
+import type { GraphMailConnection } from '../../microsoft/models/graph-mail-connection';
+import type { GraphMailDeltaData } from '../../microsoft/models/graph-mail-delta-data';
+import type { GraphMailDeltaPageData } from '../../microsoft/models/graph-mail-delta-page-data';
+import type { GraphMailSubscriptionData } from '../../microsoft/models/graph-mail-subscription-data';
+export declare class SandboxMailService {
+    static connection(mailbox: string): GraphMailConnection;
+    static deltaLink(mailbox: string): string;
+    static deltaPage(mailbox: string): GraphMailDeltaPageData;
+    static delta(mailbox: string): GraphMailDeltaData;
+    static subscription(mailbox: string, now?: Date): GraphMailSubscriptionData;
+}

package/dist/sandbox/services/sandbox-mail-service.js

@@ -0,0 +1,47 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SandboxMailService = void 0;
+var sandbox_mail_config_1 = require("../constants/sandbox-mail-config");
+var SandboxMailService = /** @class */ (function () {
+    function SandboxMailService() {
+    }
+    SandboxMailService.connection = function (mailbox) {
+        return __assign(__assign({}, sandbox_mail_config_1.SandboxMailConfig.connection), { mailbox: mailbox });
+    };
+    SandboxMailService.deltaLink = function (mailbox) {
+        return "".concat(sandbox_mail_config_1.SandboxMailConfig.deltaLinkPrefix, ":").concat(mailbox);
+    };
+    SandboxMailService.deltaPage = function (mailbox) {
+        return {
+            messages: [],
+            removedIds: [],
+            nextLink: null,
+            deltaLink: this.deltaLink(mailbox),
+        };
+    };
+    SandboxMailService.delta = function (mailbox) {
+        return { messages: [], removedIds: [], deltaLink: this.deltaLink(mailbox) };
+    };
+    SandboxMailService.subscription = function (mailbox, now) {
+        if (now === void 0) { now = new Date(); }
+        var lifetime = sandbox_mail_config_1.SandboxMailConfig.subscription.lifetimeHours * sandbox_mail_config_1.SandboxMailConfig.millisecondsPerHour;
+        return {
+            id: "".concat(sandbox_mail_config_1.SandboxMailConfig.subscription.idPrefix, ":").concat(mailbox),
+            resource: sandbox_mail_config_1.SandboxMailConfig.subscription.resource,
+            expirationDateTime: new Date(now.getTime() + lifetime).toISOString(),
+        };
+    };
+    return SandboxMailService;
+}());
+exports.SandboxMailService = SandboxMailService;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@pallasoft/ps-mail",
-	"version": "1.5.0",
+	"version": "1.6.0",
 	"private": false,
 	"main": "./dist/index.js",
 	"types": "./dist/index.d.ts",
@@ -17,7 +17,11 @@
 			"types": "./dist/resend/index.d.ts",
 			"default": "./dist/resend/index.js"
 		},
-		"./package.json": "./package.json"
+		"./package.json": "./package.json",
+		"./sandbox": {
+			"types": "./dist/sandbox/index.d.ts",
+			"default": "./dist/sandbox/index.js"
+		}
 	},
 	"typesVersions": {
 		"*": {
@@ -26,6 +30,9 @@
 			],
 			"resend": [
 				"./dist/resend/index.d.ts"
+			],
+			"sandbox": [
+				"./dist/sandbox/index.d.ts"
 			]
 		}
 	},