@vsaas/loopback 11.0.3 → 11.2.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/lib/model.cjs

@@ -14,6 +14,31 @@ var require_model = /* @__PURE__ */ require_runtime.__commonJSMin(((exports, mod
 	const SharedClass = require("@vsaas/remoting").SharedClass;
 	const utils = require_lib_utils;
 	const deprecated = require("depd")("loopback");
+	function completeSyncRemoteHook(retval, next) {
+		if (retval && typeof retval.then === "function") {
+			retval.then(function() {
+				next();
+				return null;
+			}, next);
+			return;
+		}
+		next();
+	}
+	function invokeSyncRemoteHook(fn, ctx, result, next) {
+		let hasResult = true;
+		if (next === void 0) {
+			next = result;
+			result = void 0;
+			hasResult = false;
+		}
+		let retval;
+		try {
+			retval = hasResult ? fn(ctx, result) : fn(ctx);
+		} catch (err) {
+			return next(err);
+		}
+		completeSyncRemoteHook(retval, next);
+	}
 	module.exports = function(registry) {
 		/**
 		* The base class for **all models**.
@@ -188,6 +213,14 @@ var require_model = /* @__PURE__ */ require_runtime.__commonJSMin(((exports, mod
 					});
 				});
 			};
+			ModelCtor.beforeRemoteSync = function(name, fn) {
+				const className = this.modelName;
+				this._runWhenAttachedToApp(function(app) {
+					app.remotes().before(className + "." + name, function(ctx, next) {
+						invokeSyncRemoteHook(fn, ctx, next);
+					});
+				});
+			};
 			ModelCtor.afterRemote = function(name, fn) {
 				const className = this.modelName;
 				this._runWhenAttachedToApp(function(app) {
@@ -196,12 +229,28 @@ var require_model = /* @__PURE__ */ require_runtime.__commonJSMin(((exports, mod
 					});
 				});
 			};
+			ModelCtor.afterRemoteSync = function(name, fn) {
+				const className = this.modelName;
+				this._runWhenAttachedToApp(function(app) {
+					app.remotes().after(className + "." + name, function(ctx, next) {
+						invokeSyncRemoteHook(fn, ctx, ctx.result, next);
+					});
+				});
+			};
 			ModelCtor.afterRemoteError = function(name, fn) {
 				const className = this.modelName;
 				this._runWhenAttachedToApp(function(app) {
 					app.remotes().afterError(className + "." + name, fn);
 				});
 			};
+			ModelCtor.afterRemoteErrorSync = function(name, fn) {
+				const className = this.modelName;
+				this._runWhenAttachedToApp(function(app) {
+					app.remotes().afterError(className + "." + name, function(ctx, next) {
+						invokeSyncRemoteHook(fn, ctx, next);
+					});
+				});
+			};
 			ModelCtor._runWhenAttachedToApp = function(fn) {
 				if (typeof fn === "function") {
 					if (this.app) return fn(this.app);

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.2.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.2.0",
   "description": "Fork of LoopBack 3 framework for building APIs and microservices in Node.js",
   "keywords": [
     "StrongLoop",
@@ -69,8 +69,8 @@
     "nodemailer": "^8.0.4",
     "serve-favicon": "^2.2.0",
     "@vsaas/loopback-connector-remote": "^11.0.2",
-    "@vsaas/loopback-datasource-juggler": "^11.0.2",
-    "@vsaas/remoting": "^11.0.2"
+    "@vsaas/remoting": "^11.0.2",
+    "@vsaas/loopback-datasource-juggler": "^11.1.0"
   },
   "devDependencies": {
     "@types/node": "25.5.0",
@@ -87,9 +87,9 @@
     "supertest": "7.2.2",
     "tsdown": "0.21.7",
     "typescript": "6.0.2",
-    "vitest": "4.1.1",
-    "@vsaas/loopback-boot": "^11.0.2",
-    "@vsaas/error-handler": "^11.0.3"
+    "vitest": "4.1.2",
+    "@vsaas/error-handler": "^11.0.5",
+    "@vsaas/loopback-boot": "^11.0.2"
   },
   "engines": {
     "node": ">=20"