@pallasoft/ps-mail 1.0.0

package/dist/resend/services/resend-webhook-service.js

@@ -0,0 +1,139 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResendWebhookService = void 0;
+var ps_utilities_1 = require("@pallasoft/ps-utilities");
+var resend_webhook_config_1 = require("../constants/resend-webhook-config");
+var ResendWebhookService = /** @class */ (function () {
+    function ResendWebhookService() {
+    }
+    ResendWebhookService.verify = function (secret, body, headers) {
+        return __awaiter(this, void 0, void 0, function () {
+            var id, timestamp, signatures, key, content, checks;
+            var _this = this;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        id = this._header(headers, resend_webhook_config_1.ResendWebhookConfig.idHeaders);
+                        timestamp = this._header(headers, resend_webhook_config_1.ResendWebhookConfig.timestampHeaders);
+                        signatures = this._header(headers, resend_webhook_config_1.ResendWebhookConfig.signatureHeaders);
+                        if (secret === '' || id === null || timestamp === null || signatures === null)
+                            return [2 /*return*/, false];
+                        if (!this._isFresh(timestamp))
+                            return [2 /*return*/, false];
+                        return [4 /*yield*/, this._key(secret)];
+                    case 1:
+                        key = _a.sent();
+                        if (key === null)
+                            return [2 /*return*/, false];
+                        content = this._textEncoder.encode([id, timestamp, body].join(resend_webhook_config_1.ResendWebhookConfig.signedContentSeparator));
+                        checks = signatures
+                            .split(resend_webhook_config_1.ResendWebhookConfig.signatureListSeparator)
+                            .map(function (entry) { return entry.split(resend_webhook_config_1.ResendWebhookConfig.signatureVersionSeparator); })
+                            .filter(function (_a) {
+                            var version = _a[0], signature = _a[1];
+                            return version === resend_webhook_config_1.ResendWebhookConfig.signatureVersion && typeof signature === 'string';
+                        })
+                            .map(function (_a) {
+                            var signature = _a[1];
+                            return _this._matches(key, signature, content);
+                        });
+                        return [4 /*yield*/, Promise.all(checks)];
+                    case 2: return [2 /*return*/, (_a.sent()).some(function (matches) { return matches; })];
+                }
+            });
+        });
+    };
+    ResendWebhookService._isFresh = function (timestamp) {
+        return (resend_webhook_config_1.ResendWebhookConfig.timestampPattern.test(timestamp) &&
+            Math.abs(ps_utilities_1.Common.DateService.nowUnixSeconds() - Number(timestamp)) <=
+                resend_webhook_config_1.ResendWebhookConfig.toleranceSeconds);
+    };
+    ResendWebhookService._key = function (secret) {
+        return __awaiter(this, void 0, void 0, function () {
+            var _a;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        _b.trys.push([0, 2, , 3]);
+                        return [4 /*yield*/, crypto.subtle.importKey(resend_webhook_config_1.ResendWebhookConfig.keyFormat, ps_utilities_1.Common.Base64Service.decode(secret.startsWith(resend_webhook_config_1.ResendWebhookConfig.secretPrefix)
+                                ? secret.slice(resend_webhook_config_1.ResendWebhookConfig.secretPrefix.length)
+                                : secret), { name: resend_webhook_config_1.ResendWebhookConfig.hmacAlgorithm, hash: resend_webhook_config_1.ResendWebhookConfig.hmacHash }, false, [resend_webhook_config_1.ResendWebhookConfig.keyUsage])];
+                    case 1: return [2 /*return*/, _b.sent()];
+                    case 2:
+                        _a = _b.sent();
+                        return [2 /*return*/, null];
+                    case 3: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    ResendWebhookService._matches = function (key, signature, content) {
+        return __awaiter(this, void 0, void 0, function () {
+            var _a;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        _b.trys.push([0, 2, , 3]);
+                        return [4 /*yield*/, crypto.subtle.verify(resend_webhook_config_1.ResendWebhookConfig.hmacAlgorithm, key, ps_utilities_1.Common.Base64Service.decode(signature), content)];
+                    case 1: return [2 /*return*/, _b.sent()];
+                    case 2:
+                        _a = _b.sent();
+                        return [2 /*return*/, false];
+                    case 3: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    ResendWebhookService._header = function (headers, names) {
+        for (var _i = 0, names_1 = names; _i < names_1.length; _i++) {
+            var name_1 = names_1[_i];
+            var value = headers instanceof Headers ? headers.get(name_1) : this._recordHeader(headers, name_1);
+            if (typeof value === 'string' && value.trim() !== '')
+                return value.trim();
+        }
+        return null;
+    };
+    ResendWebhookService._recordHeader = function (headers, name) {
+        var key = Object.keys(headers).find(function (candidate) { return candidate.toLowerCase() === name; });
+        return key === undefined ? null : headers[key];
+    };
+    ResendWebhookService._textEncoder = new TextEncoder();
+    return ResendWebhookService;
+}());
+exports.ResendWebhookService = ResendWebhookService;

package/dist/services/mail-fetch-failure-service.d.ts

@@ -0,0 +1,3 @@
+export declare class MailFetchFailureService {
+    static status(error: unknown): number;
+}

package/dist/services/mail-fetch-failure-service.js

@@ -0,0 +1,49 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MailFetchFailureService = void 0;
+var Attributes = __importStar(require("@pallasoft/ps-attributes"));
+var mail_http_config_1 = require("../constants/mail-http-config");
+var MailFetchFailureService = /** @class */ (function () {
+    function MailFetchFailureService() {
+    }
+    MailFetchFailureService.status = function (error) {
+        return error instanceof Error && error.name === mail_http_config_1.MailHttpConfig.timeoutErrorName
+            ? Attributes.Common.Response.ErrorCodes.GatewayTimeout
+            : Attributes.Common.Response.ErrorCodes.BadGateway;
+    };
+    return MailFetchFailureService;
+}());
+exports.MailFetchFailureService = MailFetchFailureService;

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

@@ -0,0 +1,5 @@
+import type { MailQueryParameter } from '../models/mail-query-parameter';
+export declare class MailUrlService {
+    static path(...segments: string[]): string;
+    static withQuery(path: string, parameters: MailQueryParameter[]): string;
+}

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

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MailUrlService = void 0;
+var mail_http_config_1 = require("../constants/mail-http-config");
+var MailUrlService = /** @class */ (function () {
+    function MailUrlService() {
+    }
+    MailUrlService.path = function () {
+        var segments = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            segments[_i] = arguments[_i];
+        }
+        return segments.join(mail_http_config_1.MailHttpConfig.pathSeparator);
+    };
+    MailUrlService.withQuery = function (path, parameters) {
+        return "".concat(path).concat(mail_http_config_1.MailHttpConfig.queryStart).concat(parameters
+            .map(function (parameter) {
+            return [
+                parameter.key,
+                encodeURIComponent(parameter.value).replace(mail_http_config_1.MailHttpConfig.encodedListSeparator, mail_http_config_1.MailHttpConfig.listSeparator),
+            ].join(mail_http_config_1.MailHttpConfig.queryAssign);
+        })
+            .join(mail_http_config_1.MailHttpConfig.queryJoin));
+    };
+    return MailUrlService;
+}());
+exports.MailUrlService = MailUrlService;

package/package.json

@@ -0,0 +1,88 @@
+{
+	"name": "@pallasoft/ps-mail",
+	"version": "1.0.0",
+	"private": false,
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"default": "./dist/index.js"
+		},
+		"./microsoft": {
+			"types": "./dist/microsoft/index.d.ts",
+			"default": "./dist/microsoft/index.js"
+		},
+		"./resend": {
+			"types": "./dist/resend/index.d.ts",
+			"default": "./dist/resend/index.js"
+		},
+		"./package.json": "./package.json"
+	},
+	"typesVersions": {
+		"*": {
+			"microsoft": [
+				"./dist/microsoft/index.d.ts"
+			],
+			"resend": [
+				"./dist/resend/index.d.ts"
+			]
+		}
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/pallasoft/ps-mail.git"
+	},
+	"files": [
+		"/dist"
+	],
+	"scripts": {
+		"husky:prepare": "npx husky",
+		"build": "tsc",
+		"setup:graphify": "sh scripts/graphify-setup.sh",
+		"update:graphify": "sh scripts/graphify-update.sh",
+		"lint": "npm run lint:eslint",
+		"lint:fix": "npm run lint:eslint:fix",
+		"format:check": "npx prettier --check --ignore-unknown \"src/**/*.{js,ts,json,md}\"",
+		"format:prettier": "npx prettier --write \"**/*.{js,ts,json,md}\"",
+		"lint:eslint": "npx eslint \"**/*.{js,ts}\"",
+		"lint:eslint:fix": "npx eslint --fix \"**/*.{js,ts}\"",
+		"test": "vitest run",
+		"release": "semantic-release"
+	},
+	"devDependencies": {
+		"@commitlint/cli": "^20.1.0",
+		"@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",
+		"husky": "^9.1.7",
+		"lint-staged": "^16.2.7",
+		"prettier": "^3.6.2",
+		"semantic-release": "^24.2.0",
+		"ts-node": "^10.9.2",
+		"typescript": "^5.9.3",
+		"vitest": "^5.0.0"
+	},
+	"dependencies": {
+		"@pallasoft/ps-attributes": "^1.3.0",
+		"@pallasoft/ps-utilities": "^2.16.0"
+	},
+	"publishConfig": {
+		"access": "public",
+		"registry": "https://registry.npmjs.org/"
+	}
+}