@vsaas/loopback 11.0.3 → 11.1.0

package/README.md

@@ -69,6 +69,83 @@ The supported application-facing surface intentionally includes:
 
 Those legacy-looking `.js` subpaths are still supported for compatibility, but they now resolve to compiled files in `dist/` via `package.json` exports.
 
+## Email Transport Configuration
+
+The built-in `email` datasource continues to use Nodemailer under the hood.
+
+Built-in Nodemailer transport types supported directly by this package:
+
+- `smtp`
+- `sendmail`
+- `ses`
+- `stream`
+- `json`
+
+LoopBack compatibility transport types also preserved by this fork:
+
+- `direct`
+- `stub`
+
+Unknown transport types still follow the legacy plugin convention and try to load `nodemailer-<type>-transport`. For example, `type: 'mailgun'` expects `nodemailer-mailgun-transport` to be installed. This means supported built-ins do not require extra transport packages, while typos or unsupported custom types still fail fast with a module resolution error.
+
+### SMTP example
+
+```js
+app.dataSource('email', {
+  connector: loopback.Mail,
+  transport: {
+    type: 'smtp',
+    host: 'smtp.example.com',
+    port: 587,
+    secure: false,
+    auth: {
+      user: process.env.SMTP_USER,
+      pass: process.env.SMTP_PASSWORD,
+    },
+  },
+});
+```
+
+### SES example
+
+`type: 'ses'` uses Nodemailer's built-in SES transport with `@aws-sdk/client-sesv2`. You can either pass a prebuilt `SES` config, provide `sesClient` plus `SendEmailCommand`, or rely on the default AWS credential chain.
+
+```js
+app.dataSource('email', {
+  connector: loopback.Mail,
+  transport: {
+    type: 'ses',
+    region: process.env.AWS_REGION,
+  },
+});
+```
+
+### Stream and JSON examples
+
+These transports are useful for tests, previews, or custom delivery pipelines because they generate the message without sending it.
+
+```js
+app.dataSource('email', {
+  connector: loopback.Mail,
+  transport: {
+    type: 'stream',
+    buffer: true,
+  },
+});
+```
+
+```js
+app.dataSource('email', {
+  connector: loopback.Mail,
+  transport: {
+    type: 'json',
+    skipEncoding: true,
+  },
+});
+```
+
+All other Nodemailer transport-specific options are passed through to `nodemailer.createTransport()` after the LoopBack-specific `type` and `alias` fields are normalized.
+
 ## Notes for Fork Users
 
 - This is a maintained fork, not the upstream package.

package/dist/lib/connectors/mail.cjs

@@ -39,7 +39,10 @@ var require_mail = /* @__PURE__ */ require_runtime$1.__commonJSMin(((exports, mo
 		if (transportType === "smtp") transport = mailer.createTransport(setting);
 		else if (transportType === "direct") transport = mailer.createTransport(createDirectTransport(setting));
 		else if (transportType === "stub") transport = mailer.createTransport(createStubTransport(setting));
-		else if (transportType === "ses" && supportsBuiltinSesTransport(setting)) transport = mailer.createTransport(createBuiltinSesTransportConfig(setting));
+		else if (transportType === "sendmail") transport = mailer.createTransport(createBuiltinTransportConfig(setting, "sendmail"));
+		else if (transportType === "ses") transport = mailer.createTransport(createBuiltinSesTransportConfig(setting));
+		else if (transportType === "stream") transport = mailer.createTransport(createBuiltinTransportConfig(setting, "streamTransport"));
+		else if (transportType === "json") transport = mailer.createTransport(createBuiltinTransportConfig(setting, "jsonTransport"));
 		else {
 			const transportModuleName = "nodemailer-" + transportType + "-transport";
 			const transportModule = require(transportModuleName);
@@ -48,13 +51,15 @@ var require_mail = /* @__PURE__ */ require_runtime$1.__commonJSMin(((exports, mo
 		connector.transportsIndex[setting.alias || setting.type] = transport;
 		connector.transports.push(transport);
 	};
-	function supportsBuiltinSesTransport(setting) {
-		return !!(setting.SES || setting.sesClient && setting.SendEmailCommand || hasLegacySesCredentials(setting));
-	}
-	function createBuiltinSesTransportConfig(setting) {
+	function createBuiltinTransportConfig(setting, transportKey) {
 		const transportConfig = Object.assign({}, setting);
 		delete transportConfig.alias;
 		delete transportConfig.type;
+		if (transportKey) transportConfig[transportKey] = true;
+		return transportConfig;
+	}
+	function createBuiltinSesTransportConfig(setting) {
+		const transportConfig = createBuiltinTransportConfig(setting);
 		if (!transportConfig.SES) transportConfig.SES = createSesTransportOptions(transportConfig);
 		delete transportConfig.sesClient;
 		delete transportConfig.SendEmailCommand;
@@ -64,22 +69,21 @@ var require_mail = /* @__PURE__ */ require_runtime$1.__commonJSMin(((exports, mo
 		delete transportConfig.region;
 		return transportConfig;
 	}
-	function hasLegacySesCredentials(setting) {
-		return !!(setting && setting.accessKeyId && setting.secretAccessKey && setting.region);
-	}
 	function createSesTransportOptions(setting) {
 		if (setting.sesClient && setting.SendEmailCommand) return {
 			sesClient: setting.sesClient,
 			SendEmailCommand: setting.SendEmailCommand
 		};
-		if (!hasLegacySesCredentials(setting)) return setting.SES;
+		if (setting.SES) return setting.SES;
 		const ses = require("@aws-sdk/client-sesv2");
-		const clientConfig = { region: setting.region };
-		clientConfig.credentials = {
-			accessKeyId: setting.accessKeyId,
-			secretAccessKey: setting.secretAccessKey
-		};
-		if (setting.sessionToken) clientConfig.credentials.sessionToken = setting.sessionToken;
+		const clientConfig = {};
+		if (setting.region) clientConfig.region = setting.region;
+		if (setting.accessKeyId || setting.secretAccessKey || setting.sessionToken) {
+			clientConfig.credentials = {};
+			if (setting.accessKeyId) clientConfig.credentials.accessKeyId = setting.accessKeyId;
+			if (setting.secretAccessKey) clientConfig.credentials.secretAccessKey = setting.secretAccessKey;
+			if (setting.sessionToken) clientConfig.credentials.sessionToken = setting.sessionToken;
+		}
 		return {
 			sesClient: new ses.SESv2Client(clientConfig),
 			SendEmailCommand: ses.SendEmailCommand

package/dist/package.cjs

@@ -2,7 +2,7 @@
 var require_package = /* @__PURE__ */ require("./_virtual/_rolldown/runtime.cjs").__commonJSMin(((exports, module) => {
 	module.exports = {
 		"name": "@vsaas/loopback",
-		"version": "11.0.3",
+		"version": "11.1.0",
 		"description": "Fork of LoopBack 3 framework for building APIs and microservices in Node.js",
 		"keywords": [
 			"StrongLoop",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vsaas/loopback",
-  "version": "11.0.3",
+  "version": "11.1.0",
   "description": "Fork of LoopBack 3 framework for building APIs and microservices in Node.js",
   "keywords": [
     "StrongLoop",
@@ -68,9 +68,9 @@
     "loopback-filters": "^1.0.0",
     "nodemailer": "^8.0.4",
     "serve-favicon": "^2.2.0",
-    "@vsaas/loopback-connector-remote": "^11.0.2",
+    "@vsaas/remoting": "^11.0.2",
     "@vsaas/loopback-datasource-juggler": "^11.0.2",
-    "@vsaas/remoting": "^11.0.2"
+    "@vsaas/loopback-connector-remote": "^11.0.2"
   },
   "devDependencies": {
     "@types/node": "25.5.0",
@@ -88,8 +88,8 @@
     "tsdown": "0.21.7",
     "typescript": "6.0.2",
     "vitest": "4.1.1",
-    "@vsaas/loopback-boot": "^11.0.2",
-    "@vsaas/error-handler": "^11.0.3"
+    "@vsaas/error-handler": "^11.0.3",
+    "@vsaas/loopback-boot": "^11.0.2"
   },
   "engines": {
     "node": ">=20"