@7365admin1/core 3.73.1 → 3.75.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @iservice365/core
 
+## 3.75.0
+
+### Minor Changes
+
+- 75fb139: Real Estate Developer clients use the Property Management application: membership and role types `real_estate_developer` are stored and looked up as `property_management_agency`, so a developer's owner can open the Property Management app and the owner grant caps their roles.
+
+## 3.74.0
+
+### Minor Changes
+
+- a30c5ea: Invite Client for a Property Management or real estate developer client can carry the Service365 resident app modules; onboarding writes them on the organisation
+
 ## 3.73.1
 
 ### Patch Changes

package/dist/index.d.ts

@@ -11262,6 +11262,8 @@ type TVerificationMetadataV2 = {
     modules?: string[];
     /** The new client owner's permissions in that application, chosen with the modules. */
     permissions?: string[];
+    /** A Property Management client's Service365 resident app switches, chosen with the modules. */
+    residentAppModules?: Record<string, boolean>;
 };
 /**
  * The one-time code an invitee types to prove they own the mailbox, held on the

package/dist/index.js

@@ -3974,6 +3974,16 @@ function useUserRepo() {
 var import_node_server_utils17 = require("@7365admin1/node-server-utils");
 var import_uuid = require("uuid");
 
+// src/utils/service-app-type.util.ts
+var APP_TYPE_ALIASES = Object.freeze({
+  real_estate_developer: "property_management_agency"
+});
+function serviceAppType(type) {
+  if (typeof type !== "string")
+    return type;
+  return APP_TYPE_ALIASES[type] ?? type;
+}
+
 // src/repositories/member.repo.ts
 var import_node_server_utils14 = require("@7365admin1/node-server-utils");
 
@@ -4126,7 +4136,7 @@ function useMemberRepo() {
   }
   async function add(value, session) {
     try {
-      value = MMember(value);
+      value = MMember({ ...value, type: serviceAppType(value.type) });
       await collection.insertOne(value, { session });
       delNamespace().then(() => {
         import_node_server_utils14.logger.info(`Cache cleared for namespace: ${namespace_collection3}`);
@@ -4254,6 +4264,7 @@ function useMemberRepo() {
     }
   }
   async function getByUserIdType(user, type) {
+    type = serviceAppType(type);
     try {
       user = new import_mongodb13.ObjectId(user);
     } catch (error) {
@@ -4413,7 +4424,7 @@ function useMemberRepo() {
     search = search || "";
     page = page > 0 ? page - 1 : 0;
     const query2 = {
-      type,
+      type: serviceAppType(type),
       status
     };
     const cacheOptions = {
@@ -4935,6 +4946,7 @@ function useMemberRepo() {
     }
   }
   async function getByUserIdTypeOrg(user, type, org) {
+    type = serviceAppType(type);
     try {
       user = new import_mongodb13.ObjectId(user);
     } catch {
@@ -12442,7 +12454,7 @@ function useRoleRepo() {
   const { delNamespace, setCache, getCache } = (0, import_node_server_utils42.useCache)(namespace_collection3);
   const { delNamespace: _delDashboardNameSpace } = (0, import_node_server_utils42.useCache)("dashboard");
   async function addRole(value, session) {
-    value = new MRole(value);
+    value = new MRole({ ...value, type: serviceAppType(value.type) });
     try {
       const res = await collection.insertOne(value, { session });
       delNamespace().then(() => {
@@ -12545,6 +12557,7 @@ function useRoleRepo() {
     if (!name) {
       throw new import_node_server_utils42.BadRequestError("Role name is required.");
     }
+    type = serviceAppType(type);
     const query2 = type ? { name, type } : { name };
     try {
       const cacheKey = (0, import_node_server_utils42.makeCacheKey)(namespace_collection3, query2);
@@ -12601,8 +12614,8 @@ function useRoleRepo() {
       cacheOptions.search = search;
     }
     if (type) {
-      query2.type = type;
-      cacheOptions.type = type;
+      query2.type = serviceAppType(type);
+      cacheOptions.type = query2.type;
     }
     const cacheKey = (0, import_node_server_utils42.makeCacheKey)(namespace_collection3, cacheOptions);
     const cachedData = await getCache(cacheKey);
@@ -15216,13 +15229,14 @@ function defaultOwnerRoles(org, nature, appOwnerPermissions) {
     { ...owner, type: "organization" },
     { ...administrator, type: "organization" }
   ];
-  if (nature && APP_SERVICE_TYPES.has(nature)) {
+  const appType = serviceAppType(nature);
+  if (appType && APP_SERVICE_TYPES.has(appType)) {
     roles.push({
       ...owner,
-      type: nature,
+      type: appType,
       ...appOwnerPermissions?.length && { permissions: [...appOwnerPermissions] }
     });
-    roles.push({ ...administrator, type: nature });
+    roles.push({ ...administrator, type: appType });
   }
   return roles;
 }
@@ -15307,15 +15321,17 @@ async function moduleCeiling(org, site) {
 }
 async function ownerGrantCeiling(org, type) {
   const orgId = org?.toString() ?? "";
+  type = serviceAppType(type);
   if (!orgId || !type)
     return null;
   try {
     const orgDoc = await useOrgRepo().getById(orgId).catch(() => null);
-    if (!orgDoc?.invitedRole || orgDoc.nature !== type)
+    const appType = serviceAppType(orgDoc?.nature);
+    if (!orgDoc?.invitedRole || appType !== type)
       return null;
     const role = await useRoleRepo().getRoleById(String(orgDoc.invitedRole)).catch(() => null);
     const permissions = role?.permissions;
-    const chosen = role && String(role.org ?? "") === orgId && role.default === true && role.type === orgDoc.nature && Array.isArray(permissions) && permissions.length > 0 && !permissions.includes("*");
+    const chosen = role && String(role.org ?? "") === orgId && role.default === true && role.type === appType && Array.isArray(permissions) && permissions.length > 0 && !permissions.includes("*");
     return chosen ? permissions.map(String) : null;
   } catch {
     return null;
@@ -24198,6 +24214,44 @@ function useMemberController() {
 // src/controllers/verification.controller.ts
 var import_node_server_utils67 = require("@7365admin1/node-server-utils");
 var import_joi28 = __toESM(require("joi"));
+
+// src/utils/resident-app-modules.util.ts
+var RESIDENT_APP_NATURES = Object.freeze([
+  "property_management_agency",
+  "real_estate_developer"
+]);
+function effectiveResidentAppModules(orgModules, siteModules) {
+  const org = asModules(orgModules);
+  const site = asModules(siteModules);
+  const effective = {};
+  for (const key of residentAppModuleKeys) {
+    effective[key] = org[key] !== false && site[key] !== false;
+  }
+  return effective;
+}
+function residentAppModulesAboveCeiling(orgModules, requested, stored) {
+  const org = asModules(orgModules);
+  const wanted = asModules(requested);
+  const had = asModules(stored);
+  return residentAppModuleKeys.filter(
+    (key) => org[key] === false && wanted[key] === true && had[key] === false
+  );
+}
+function residentAppModulesAboveCeilingMessage(rejected) {
+  return `This client has not been given ${rejected.join(", ")} in the resident app, so a site cannot switch it on. Ask Seven365 to add it to the organisation first.`;
+}
+function withoutDerivedSiteMetadata(metadata) {
+  if (!metadata || typeof metadata !== "object" || Array.isArray(metadata)) {
+    return metadata;
+  }
+  const { residentAppModulesEffective: _derived, ...stored } = metadata;
+  return stored;
+}
+function asModules(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+
+// src/controllers/verification.controller.ts
 var withoutEmail = (payload) => JSON.stringify({ ...payload, email: payload?.email ? "[redacted]" : void 0 });
 function callerId2(req) {
   const user = req.user;
@@ -24279,7 +24333,11 @@ function useVerificationController() {
       modules: modulesSchema.optional(),
       // The new client owner's permissions in that application, chosen with
       // the modules (owner, 2026-09-15). Only accepted together with modules.
-      permissions: permissionsSchema.optional()
+      permissions: permissionsSchema.optional(),
+      // The Service365 resident app switches for a Property Management (or
+      // real estate developer) client, same shape the Client details card saves
+      // to `organizations.residentAppModules`. Only accepted with modules.
+      residentAppModules: residentAppModulesSchema.optional()
     });
     const { error, value } = validation.validate(payload);
     if (error) {
@@ -24299,7 +24357,8 @@ function useVerificationController() {
         siteId,
         siteName,
         modules,
-        permissions
+        permissions,
+        residentAppModules
       } = value;
       const newClient = !org && !app.includes(PLATFORM_STAFF_MEMBER_TYPE);
       const role = newClient ? "" : value.role;
@@ -24329,6 +24388,14 @@ function useVerificationController() {
         }
         clientModules.permissions = chosen;
       }
+      if (residentAppModules !== void 0) {
+        if (!clientModules || !RESIDENT_APP_NATURES.includes(app[0])) {
+          throw new import_node_server_utils67.BadRequestError(
+            "Service365 resident app modules can only be chosen with the modules of a new Property Management client."
+          );
+        }
+        clientModules.residentAppModules = residentAppModules;
+      }
       await requireInviteReach(req, org, app, role);
       const verificationIds = await _createSimpleUserInvite({
         email,
@@ -26145,10 +26212,12 @@ function useOrgController() {
           const invitedBy = invite.metadata?.invitedBy;
           if (chosen.length && invitedBy && invite.metadata?.app === body.nature) {
             const permissions = clientInviteOwnerPermissionsOn() ? normalisePermissions(invite.metadata?.permissions) : [];
+            const residentApp = RESIDENT_APP_NATURES.includes(body.nature) ? residentAppModulesSchema.validate(invite.metadata?.residentAppModules) : null;
             invitedModules = {
               modules: chosen,
               invitedBy: String(invitedBy),
-              permissions: permissionsOutsideModules(permissions, chosen).length ? [] : permissions
+              permissions: permissionsOutsideModules(permissions, chosen).length ? [] : permissions,
+              ...residentApp?.value && !residentApp.error ? { residentAppModules: residentApp.value } : {}
             };
           }
         } else {
@@ -26171,7 +26240,10 @@ function useOrgController() {
         createdBy,
         invitedFrom,
         invitedRole,
-        ...invitedModules && { modules: invitedModules.modules }
+        ...invitedModules && { modules: invitedModules.modules },
+        ...invitedModules?.residentAppModules && {
+          residentAppModules: invitedModules.residentAppModules
+        }
       });
       if (invitedModules) {
         await recordConsoleAction({
@@ -26185,7 +26257,10 @@ function useOrgController() {
             moduleCount: invitedModules.modules.length,
             gateListHash: moduleListHash(invitedModules.modules),
             acknowledged: false,
-            impactMemberCount: 0
+            impactMemberCount: 0,
+            ...invitedModules.residentAppModules && {
+              residentAppModulesOff: Object.keys(invitedModules.residentAppModules).filter((key) => invitedModules.residentAppModules[key] === false).join(", ")
+            }
           })
         });
       }
@@ -26208,7 +26283,7 @@ function useOrgController() {
         invitedModules?.permissions
       );
       const appOwnerRole = invitedModules?.permissions.length ? seededRoles.find(
-        (role) => role.type === body.nature && role.name === "owner"
+        (role) => role.type === serviceAppType(body.nature) && role.name === "owner"
       ) : void 0;
       if (appOwnerRole) {
         try {
@@ -34788,40 +34863,6 @@ function useSiteService() {
 
 // src/controllers/site.controller.ts
 var import_node_server_utils109 = require("@7365admin1/node-server-utils");
-
-// src/utils/resident-app-modules.util.ts
-function effectiveResidentAppModules(orgModules, siteModules) {
-  const org = asModules(orgModules);
-  const site = asModules(siteModules);
-  const effective = {};
-  for (const key of residentAppModuleKeys) {
-    effective[key] = org[key] !== false && site[key] !== false;
-  }
-  return effective;
-}
-function residentAppModulesAboveCeiling(orgModules, requested, stored) {
-  const org = asModules(orgModules);
-  const wanted = asModules(requested);
-  const had = asModules(stored);
-  return residentAppModuleKeys.filter(
-    (key) => org[key] === false && wanted[key] === true && had[key] === false
-  );
-}
-function residentAppModulesAboveCeilingMessage(rejected) {
-  return `This client has not been given ${rejected.join(", ")} in the resident app, so a site cannot switch it on. Ask Seven365 to add it to the organisation first.`;
-}
-function withoutDerivedSiteMetadata(metadata) {
-  if (!metadata || typeof metadata !== "object" || Array.isArray(metadata)) {
-    return metadata;
-  }
-  const { residentAppModulesEffective: _derived, ...stored } = metadata;
-  return stored;
-}
-function asModules(value) {
-  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
-}
-
-// src/controllers/site.controller.ts
 var import_joi51 = __toESM(require("joi"));
 var import_mongodb74 = require("mongodb");
 async function requireSiteWrite(req, siteId) {