Major v21

package.json

@@ -61,7 +61,7 @@
   "author": "Balena Ltd. <[email protected]>",
   "license": "Apache-2.0",
   "engines": {
-    "node": ">=18.0"
+    "node": "^20.12.0 || >= 22.0.0"
   },
   "devDependencies": {
     "@balena/env-parsing": "^1.2.0",
@@ -119,7 +119,7 @@
   "dependencies": {
     "@balena/es-version": "^1.0.0",
     "@types/json-schema": "^7.0.9",
-    "@types/node": "^18.19.50",
+    "@types/node": "^20.17.8",
     "abortcontroller-polyfill": "^1.7.1",
     "balena-auth": "^6.0.1",
     "balena-errors": "^4.9.0",

src/models/api-key.ts

@@ -38,40 +38,49 @@ const getApiKeysModel = function (
 		 *
 		 * @description This method registers a new api key for the current user with the name given.
 		 *
-		 * @param {String} name - the API key name
-		 * @param {String} [description=null] - the API key description
+		 * @param {Object} createApiKeyParams - an object containing the parameters for the creation of an API key
+		 * @param {String} createApiKeyParams.name - the API key name
+		 * @param {String} createApiKeyParams.expiryDate - the API key expiry date
+		 * @param {String} [createApiKeyParams.description=null] - the API key description
 		 *
 		 * @fulfil {String} - API key
 		 * @returns {Promise}
 		 *
 		 * @example
-		 * balena.models.apiKey.create(apiKeyName).then(function(apiKey) {
+		 * balena.models.apiKey.create({name: apiKeyName, expiryDate: 2030-10-12}).then(function(apiKey) {
 		 * 	console.log(apiKey);
 		 * });
 		 *
 		 * @example
-		 * balena.models.apiKey.create(apiKeyName, apiKeyDescription).then(function(apiKey) {
+		 * balena.models.apiKey.create({name: apiKeyName, expiryDate: 2030-10-12, description: apiKeyDescription}).then(function(apiKey) {
 		 * 	console.log(apiKey);
 		 * });
 		 */
-		async create(
-			name: string,
-			description: string | null = null,
-			expiryDate: string | null = null,
-		): Promise<string> {
+		async create({
+			name,
+			expiryDate,
+			description = null,
+		}: {
+			name: string;
+			expiryDate: string | null;
+			description?: string | null;
+		}): Promise<string> {
+			if (typeof expiryDate === 'undefined') {
+				throw new Error(
+					'An expiry date must be provided as either an ISO string or null',
+				);
+			}
 			const apiKeyBody: {
 				name: string;
+				expiryDate: string | null;
 				description?: string | null;
-				expiryDate?: string | null;
 			} = {
 				name,
+				expiryDate,
 			};
 			if (typeof description === 'string' && !!description) {
 				apiKeyBody.description = description;
 			}
-			if (typeof expiryDate === 'string' && !!expiryDate) {
-				apiKeyBody.expiryDate = expiryDate;
-			}
 			try {
 				const { body } = await request.send({
 					method: 'POST',

src/models/application-membership.ts

@@ -225,7 +225,7 @@ const getApplicationMembershipModel = function (
 		 * @function
 		 * @memberof balena.models.application.membership
 		 *
-		 * @description This method adds a user to an application by their username.
+		 * @description This method adds a user to an application by their username if they are a member of the organization.
 		 *
 		 * @param {Object} options - membership creation parameters
 		 * @param {String|Number} options.application - application handle (string), or id (number)
@@ -248,9 +248,23 @@ const getApplicationMembershipModel = function (
 			PinePostResult<ApplicationMembership>
 		> {
 			const [{ id }, roleId] = await Promise.all([
-				getApplication(application, { $select: 'id' }),
+				getApplication(application, {
+					$select: 'id',
+					$expand: {
+						organization: {
+							$select: 'id',
+							$filter: { organization_membership: { user: { username } } },
+						},
+					},
+				}),
 				roleName ? getRoleId(roleName) : undefined,
 			]);
+			// If the user does not have an organization membership, they cannot be added to an application
+			if (!id) {
+				throw new Error(
+					'It is necessary that each user (Auth) that is member of an application that has an organization, is member of the organization',
+				);
+			}
 			type ApplicationMembershipBase = Omit<ApplicationMembership, 'user'>;
 			type ApplicationMembershipPostBody = ApplicationMembershipBase & {
 				username: string;