@7365admin1/core 3.137.0 → 3.139.0

package/dist/index.mjs

@@ -3200,6 +3200,53 @@ function sameAppType(a, b) {
   return !!a && !!b && serviceAppType(a) === serviceAppType(b);
 }
 
+// src/utils/member-lookup.util.ts
+var idOf = (v) => v == null ? "" : String(v?._id ?? v).toLowerCase();
+function isLiveMembership(m) {
+  return m.status !== "deleted" && !m.deletedAt;
+}
+function pickSiteMembership(rows, type, site, org = "") {
+  site = site.toLowerCase();
+  org = org.toLowerCase();
+  if (!site)
+    return null;
+  const live2 = rows.filter(
+    (m) => sameAppType(m.type, type) && isLiveMembership(m) && (!org || idOf(m.org) === org)
+  );
+  const atSite = live2.find((m) => idOf(m.siteId) === site);
+  if (atSite)
+    return atSite;
+  if (!org)
+    return null;
+  return live2.find((m) => !idOf(m.siteId)) ?? live2[0] ?? null;
+}
+function pickLookupMembership(rows, type, site = "", org = "") {
+  const list = Array.isArray(rows) ? rows : [];
+  const atSite = site ? pickSiteMembership(list, type, site, org) : null;
+  if (atSite)
+    return atSite;
+  const inOrg = org ? list.find((m) => sameAppType(m.type, type) && idOf(m.org) === org.toLowerCase()) : void 0;
+  if (inOrg && isLiveMembership(inOrg))
+    return inOrg;
+  return preferWorkingMembership(list.filter((m) => sameAppType(m.type, type)));
+}
+var WORKING = /* @__PURE__ */ new Set(["active", "approved"]);
+function preferWorkingMembership(rows, defaultOrg = "") {
+  const list = Array.isArray(rows) ? rows : [];
+  const working = list.filter((m) => WORKING.has(String(m.status ?? "")) && !m.deletedAt);
+  const home = idOf(defaultOrg);
+  return (home ? working.find((m) => idOf(m.org) === home) : void 0) ?? working[0] ?? list.find(isLiveMembership) ?? list[0] ?? null;
+}
+function memberListSiteScope(memberships, org) {
+  const inOrg = (memberships ?? []).filter((m) => idOf(m.org) === idOf(org));
+  const here = inOrg.filter((m) => m.type !== "resident");
+  if (!inOrg.length)
+    return null;
+  if (here.some((m) => !idOf(m.siteId) || m.orgLevelRole))
+    return null;
+  return [...new Set(here.map((m) => idOf(m.siteId)))];
+}
+
 // src/repositories/member.repo.ts
 import {
   AppError as AppError2,
@@ -3332,10 +3379,10 @@ import { ObjectId as ObjectId13 } from "mongodb";
 function crossSiteRoleMode() {
   return (process.env.CROSS_SITE_ROLE_MODE ?? "").trim().toLowerCase() === "enforce" ? "enforce" : "log";
 }
-var idOf = (value) => value === null || value === void 0 ? "" : String(value?.toString?.() ?? value);
+var idOf2 = (value) => value === null || value === void 0 ? "" : String(value?.toString?.() ?? value);
 function isCrossSiteRole(role, memberSite) {
-  const roleSite = idOf(role?.site);
-  return !!roleSite && roleSite !== idOf(memberSite);
+  const roleSite = idOf2(role?.site);
+  return !!roleSite && roleSite !== idOf2(memberSite);
 }
 var THROTTLE_MS = 10 * 60 * 1e3;
 var lastLogged = /* @__PURE__ */ new Map();
@@ -3344,7 +3391,7 @@ function crossSiteRoleGrants(input) {
     return true;
   const mode = crossSiteRoleMode();
   const granted = mode !== "enforce";
-  const key = [mode, idOf(input.member) || idOf(input.user), idOf(input.role?._id), input.where].join("|");
+  const key = [mode, idOf2(input.member) || idOf2(input.user), idOf2(input.role?._id), input.where].join("|");
   const now = Date.now();
   if ((lastLogged.get(key) ?? 0) + THROTTLE_MS <= now) {
     lastLogged.set(key, now);
@@ -3352,7 +3399,7 @@ function crossSiteRoleGrants(input) {
       lastLogged.clear();
     logger7.log({
       level: "warn",
-      message: `cross-site-role mode=${mode} ${granted ? "granted" : "refused"} where=${input.where} member=${idOf(input.member) || "-"} user=${idOf(input.user) || "-"} site=${idOf(input.memberSite) || "-"} role=${idOf(input.role?._id) || "-"} roleSite=${idOf(input.role?.site)}`
+      message: `cross-site-role mode=${mode} ${granted ? "granted" : "refused"} where=${input.where} member=${idOf2(input.member) || "-"} user=${idOf2(input.user) || "-"} site=${idOf2(input.memberSite) || "-"} role=${idOf2(input.role?._id) || "-"} roleSite=${idOf2(input.role?.site)}`
     });
   }
   return granted;
@@ -3363,7 +3410,7 @@ function crossSiteRoleRefusal(roleName, roleSiteName) {
   return `${role} belongs to ${site}. Choose a role for this site, or an org-wide role.`;
 }
 async function requireRoleFitsSite(roleId, siteId) {
-  const id = idOf(roleId);
+  const id = idOf2(roleId);
   if (!id || !ObjectId13.isValid(id))
     return;
   const db2 = useAtlas7.getDb();
@@ -3372,7 +3419,7 @@ async function requireRoleFitsSite(roleId, siteId) {
   const role = await db2.collection("roles").findOne({ _id: new ObjectId13(id) }, { projection: { name: 1, site: 1 } });
   if (!isCrossSiteRole(role, siteId))
     return;
-  const site = ObjectId13.isValid(idOf(role?.site)) ? await db2.collection("sites").findOne({ _id: new ObjectId13(idOf(role?.site)) }, { projection: { name: 1 } }) : null;
+  const site = ObjectId13.isValid(idOf2(role?.site)) ? await db2.collection("sites").findOne({ _id: new ObjectId13(idOf2(role?.site)) }, { projection: { name: 1 } }) : null;
   throw new BadRequestError13(crossSiteRoleRefusal(role?.name, site?.name));
 }
 async function otherSiteRoleClauses(roles, org) {
@@ -3380,7 +3427,7 @@ async function otherSiteRoleClauses(roles, org) {
     { ...org ? { org } : { org: { $nin: ["", null] } }, site: { $nin: ["", null] }, status: "active" },
     { projection: { site: 1, org: 1 } }
   ).toArray();
-  const both3 = (v) => ObjectId13.isValid(idOf(v)) ? [new ObjectId13(idOf(v)), idOf(v)] : [v];
+  const both3 = (v) => ObjectId13.isValid(idOf2(v)) ? [new ObjectId13(idOf2(v)), idOf2(v)] : [v];
   const clauses = (list ?? []).map((r) => ({
     role: r._id,
     org: { $in: both3(r.org) },
@@ -3563,9 +3610,12 @@ function useMemberRepo() {
     } catch (error) {
       throw new BadRequestError14("Invalid user ID format.");
     }
+    const account = await db2?.collection("users").findOne({ _id: user }, { projection: { defaultOrg: 1 } }).catch(() => null);
+    const defaultOrg = String(account?.defaultOrg ?? "");
     const cacheKey = makeCacheKey5(namespace_collection3, {
       user: user.toString(),
-      type
+      type,
+      defaultOrg
     });
     const cachedData = await getCache(cacheKey);
     if (cachedData) {
@@ -3573,7 +3623,10 @@ function useMemberRepo() {
       return cachedData;
     }
     try {
-      const data = await collection.findOne({ user, type: appTypeQuery(type) });
+      const data = preferWorkingMembership(
+        await collection.find({ user, type: appTypeQuery(type) }).toArray(),
+        defaultOrg
+      );
       if (!data) {
         throw new NotFoundError5("Member not found.");
       }
@@ -4036,7 +4089,12 @@ function useMemberRepo() {
     const query2 = {
       user,
       org: { $nin: [null, ""] },
-      type: appTypeQuery(type)
+      type: appTypeQuery(type),
+      // The organisation switcher. A membership that was taken away (Repair
+      // sets it inactive, removal deletes it) must not keep the organisation
+      // on the person's list: latitude.sec@ still saw JLL Singapore beside its
+      // own company after the repair (owner report 2026-09-30).
+      status: { $nin: ["inactive", "deleted"] }
     };
     const cacheOptions = {
       page: page2,
@@ -10280,7 +10338,7 @@ function robotFaultText(robotName, fault) {
   }
   return {
     title: "Robot fault",
-    body: `${robotName || "A robot"} reports a fault: ${fault.message || fault.code}.`
+    body: `${robotName || "A robot"} reports a fault: ${String(fault.message || fault.code).replace(/\.\s*$/, "")}.`
   };
 }
 function robotConnectionText(robotName, online, minutes) {
@@ -10541,7 +10599,7 @@ function enforcedModuleList(stored, save) {
     return NO_LIST;
   return { list, since: typeof save?.createdAt === "string" ? save.createdAt : "" };
 }
-var idOf2 = (v) => v == null ? "" : String(v?._id ?? v).toLowerCase();
+var idOf3 = (v) => v == null ? "" : String(v?._id ?? v).toLowerCase();
 function deniedForMembership({
   membership,
   org,
@@ -10549,12 +10607,12 @@ function deniedForMembership({
   site,
   siteSave
 }) {
-  const memberOrg = idOf2(membership?.org);
+  const memberOrg = idOf3(membership?.org);
   if (!membership || membership.type === "resident" || !memberOrg) {
     return { denied: [], since: "" };
   }
   const orgTier = enforcedModuleList(org?.modules, orgSave);
-  const siteTier = site && idOf2(site.orgId) === memberOrg ? enforcedModuleList(site.metadata?.modules, siteSave) : NO_LIST;
+  const siteTier = site && idOf3(site.orgId) === memberOrg ? enforcedModuleList(site.metadata?.modules, siteSave) : NO_LIST;
   const denied = deniedModules(orgTier.list, siteTier.list);
   if (!denied.length)
     return { denied: [], since: "" };
@@ -11128,46 +11186,6 @@ function staffMayBypass(actor, grant = CROSS_CLIENT_GRANT) {
   return consoleRoleAllows(actor.staffPermissions, grant.resource, grant.action);
 }
 
-// src/utils/member-lookup.util.ts
-var idOf3 = (v) => v == null ? "" : String(v?._id ?? v).toLowerCase();
-function isLiveMembership(m) {
-  return m.status !== "deleted" && !m.deletedAt;
-}
-function pickSiteMembership(rows, type, site, org = "") {
-  site = site.toLowerCase();
-  org = org.toLowerCase();
-  if (!site)
-    return null;
-  const live2 = rows.filter(
-    (m) => sameAppType(m.type, type) && isLiveMembership(m) && (!org || idOf3(m.org) === org)
-  );
-  const atSite = live2.find((m) => idOf3(m.siteId) === site);
-  if (atSite)
-    return atSite;
-  if (!org)
-    return null;
-  return live2.find((m) => !idOf3(m.siteId)) ?? live2[0] ?? null;
-}
-function pickLookupMembership(rows, type, site = "", org = "") {
-  const list = Array.isArray(rows) ? rows : [];
-  const atSite = site ? pickSiteMembership(list, type, site, org) : null;
-  if (atSite)
-    return atSite;
-  const inOrg = org ? list.find((m) => sameAppType(m.type, type) && idOf3(m.org) === org.toLowerCase()) : void 0;
-  if (inOrg && isLiveMembership(inOrg))
-    return inOrg;
-  return list.find((m) => sameAppType(m.type, type)) ?? null;
-}
-function memberListSiteScope(memberships, org) {
-  const inOrg = (memberships ?? []).filter((m) => idOf3(m.org) === idOf3(org));
-  const here = inOrg.filter((m) => m.type !== "resident");
-  if (!inOrg.length)
-    return null;
-  if (here.some((m) => !idOf3(m.siteId) || m.orgLevelRole))
-    return null;
-  return [...new Set(here.map((m) => idOf3(m.siteId)))];
-}
-
 // src/services/module-gate.service.ts
 var idOf4 = (v) => v == null ? "" : String(v?._id ?? v).toLowerCase();
 var isId = (v) => /^[0-9a-f]{24}$/i.test(v);
@@ -24560,7 +24578,7 @@ function useServiceProviderInviteService() {
       );
     }
     const existing = await getByCreatorAndNature(actor.id, nature).catch(() => null);
-    if (existing) {
+    if (existing && String(existing.invitedFrom ?? "") !== String(invite._id)) {
       throw new BadRequestError47(
         `You already have a ${serviceTypeLabel(nature)} company on iService365 (${existing.name}). Accept the invitation from that company instead.`
       );
@@ -24591,12 +24609,21 @@ function useServiceProviderInviteService() {
     country
   }) {
     const inviteeId = String(user?._id ?? "");
-    const name = sanitizeCompanyName(companyName) || sanitizeCompanyName(invite.metadata?.name) || sanitizeCompanyName(user?.name);
+    let name = sanitizeCompanyName(companyName) || sanitizeCompanyName(invite.metadata?.name) || sanitizeCompanyName(user?.name);
     if (!name)
       throw new BadRequestError47("Enter your company's name.");
     const email = String(invite.email ?? "").trim().toLowerCase();
     const actor = { id: inviteeId };
-    const orgId = String(
+    const db2 = useAtlas38.getDb();
+    const actorIds = [actor.id, ...ObjectId56.isValid(actor.id) ? [new ObjectId56(actor.id)] : []];
+    const made = db2 ? await db2.collection("organizations").findOne({
+      invitedFrom: { $in: [String(invite._id), invite._id] },
+      createdBy: { $in: actorIds },
+      status: { $ne: "deleted" }
+    }) : null;
+    if (made)
+      name = String(made.name ?? name);
+    const orgId = made ? String(made._id) : String(
       await addOrg({
         name,
         type: nature,
@@ -24608,8 +24635,17 @@ function useServiceProviderInviteService() {
         invitedFrom: String(invite._id)
       })
     );
-    const roles = await seedDefaultOrgRoles(useRoleRepo().addRole, orgId, nature);
     const appType = serviceAppType(nature);
+    const owners = made && db2 ? await db2.collection("roles").find({
+      org: { $in: [new ObjectId56(orgId), orgId] },
+      name: "owner",
+      status: { $ne: "deleted" }
+    }).toArray() : [];
+    const ownerRole = (type) => {
+      const r = owners.find((x) => x.type === type);
+      return r ? { id: String(r._id), type, name: "owner" } : null;
+    };
+    const roles = ownerRole("organization") && ownerRole(appType) ? [ownerRole("organization"), ownerRole(appType)] : await seedDefaultOrgRoles(useRoleRepo().addRole, orgId, nature);
     const orgOwner = roles.find((r) => r.type === "organization" && r.name === "owner");
     const appOwner = roles.find((r) => r.type === appType && r.name === "owner");
     if (!orgOwner || !appOwner) {
@@ -24632,8 +24668,18 @@ function useServiceProviderInviteService() {
       siteName: "",
       onboardingRequired: false
     };
-    await addMember({ ...base, role: orgOwner.id, type: "organization" });
-    await addMember({ ...base, role: appOwner.id, type: appType });
+    const hasOwnerRow = async (type) => !!made && !!await db2?.collection("members").findOne({
+      user: { $in: actorIds },
+      org: { $in: [new ObjectId56(orgId), orgId] },
+      type,
+      status: "active"
+    });
+    if (!await hasOwnerRow("organization")) {
+      await addMember({ ...base, role: orgOwner.id, type: "organization" });
+    }
+    if (!await hasOwnerRow(appType)) {
+      await addMember({ ...base, role: appOwner.id, type: appType });
+    }
     await useUserRepo().updateUserFieldById({ _id: actor.id, field: "defaultOrg", value: orgId }).catch(() => void 0);
     logger36.log({
       level: "info",
@@ -24689,10 +24735,60 @@ function useServiceProviderInviteService() {
     const last = [...history].reverse().find((e) => ["wrong-join-repaired", "wrong-join-undone"].includes(e?.action));
     return last?.action === "wrong-join-repaired" ? last : null;
   }
+  async function leftoverRoles(invite, senderOrg, user) {
+    const db2 = useAtlas38.getDb();
+    if (!db2 || !user?._id || !ObjectId56.isValid(senderOrg))
+      return [];
+    const since = new Date(String(invite.createdAt ?? 0)).getTime();
+    const rows = await db2.collection("members").find({
+      user: { $in: [user._id, String(user._id)] },
+      org: { $in: [new ObjectId56(senderOrg), senderOrg] }
+    }).project({ role: 1 }).toArray();
+    const roleIds = [
+      ...new Set(
+        rows.map((m) => m.role?.toString?.() ?? "").filter((r) => ObjectId56.isValid(r))
+      )
+    ].map((r) => new ObjectId56(r));
+    if (!roleIds.length)
+      return [];
+    const roles = await db2.collection("roles").find({
+      _id: { $in: roleIds },
+      org: { $in: [new ObjectId56(senderOrg), senderOrg] },
+      status: { $ne: "deleted" }
+    }).project({ name: 1, permissions: 1, createdAt: 1 }).toArray();
+    const out = [];
+    for (const role of roles) {
+      if (!(Array.isArray(role.permissions) && role.permissions.includes("*")))
+        continue;
+      if (role.createdAt && Number.isFinite(since) && new Date(role.createdAt).getTime() < since)
+        continue;
+      const inUse = await db2.collection("members").countDocuments({
+        role: { $in: [role._id, role._id.toString()] },
+        status: "active"
+      });
+      if (inUse)
+        continue;
+      out.push({ _id: role._id.toString(), name: String(role.name ?? "") });
+    }
+    return out;
+  }
+  async function setRoleStatus(ids2, status) {
+    const db2 = useAtlas38.getDb();
+    const valid = ids2.filter((r) => ObjectId56.isValid(r)).map((r) => new ObjectId56(r));
+    if (!db2 || !valid.length)
+      return;
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    await db2.collection("roles").updateMany(
+      { _id: { $in: valid } },
+      { $set: { status, deletedAt: status === "deleted" ? now : "", updatedAt: now } }
+    );
+    await useCache21("roles").delNamespace().catch(() => void 0);
+  }
   async function wrongJoinPreview({ id, userId }) {
     const { invite, senderOrg, user } = await wrongJoinContext(id, userId);
     const org = await getOrgById(senderOrg).catch(() => null);
     const memberships = await wrongJoinRows(invite, senderOrg, user);
+    const roles = await leftoverRoles(invite, senderOrg, user);
     const repaired = lastRepair(invite);
     return {
       invitationId: id,
@@ -24701,6 +24797,8 @@ function useServiceProviderInviteService() {
       senderOrgId: senderOrg,
       senderOrgName: String(org?.name ?? ""),
       memberships,
+      // Left in the sender's role list by the old sign-up; Repair retires them.
+      leftoverRoles: roles,
       defaultOrgIsSender: String(user?.defaultOrg ?? "") === senderOrg,
       repaired: repaired ? { at: repaired.at, by: repaired.byName, memberIds: repaired.memberIds ?? [] } : null
     };
@@ -24709,15 +24807,17 @@ function useServiceProviderInviteService() {
     const { actor, invite, senderOrg, user } = await wrongJoinContext(id, userId);
     const rows = await wrongJoinRows(invite, senderOrg, user);
     const defaultOrgIsSender = !!user?._id && String(user?.defaultOrg ?? "") === senderOrg;
-    if (!rows.length && !defaultOrgIsSender) {
+    const { updateMemberStatus } = useMemberRepo();
+    for (const row of rows)
+      await updateMemberStatus(row._id, { status: "inactive" });
+    const roles = await leftoverRoles(invite, senderOrg, user);
+    if (!rows.length && !defaultOrgIsSender && !roles.length) {
       return {
         message: "Nothing to repair: this account is not in the sender's organisation.",
         changed: 0
       };
     }
-    const { updateMemberStatus } = useMemberRepo();
-    for (const row of rows)
-      await updateMemberStatus(row._id, { status: "inactive" });
+    await setRoleStatus(roles.map((r) => r._id), "deleted");
     if (defaultOrgIsSender)
       await setDefaultOrg(String(user._id), "");
     await _transition({
@@ -24726,6 +24826,7 @@ function useServiceProviderInviteService() {
       event: {
         ...event("wrong-join-repaired", actor),
         memberIds: rows.map((row) => row._id),
+        roleIds: roles.map((r) => r._id),
         ...defaultOrgIsSender ? { defaultOrgWas: senderOrg } : {}
       }
     });
@@ -24734,8 +24835,8 @@ function useServiceProviderInviteService() {
       message: `[sp-invite] wrong-join repaired invite=${id} memberships=${rows.length} by=${actor.id}`
     });
     return {
-      message: `Repaired: ${rows.length} membership${rows.length === 1 ? "" : "s"} in the sender's organisation set inactive. Undo is available.`,
-      changed: rows.length
+      message: `Repaired: ${rows.length} membership${rows.length === 1 ? "" : "s"} in the sender's organisation set inactive` + (roles.length ? `, ${roles.length} unused full-access role${roles.length === 1 ? "" : "s"} removed from its role list` : "") + ". Undo is available.",
+      changed: rows.length + roles.length
     };
   }
   async function undoWrongJoin({ id, userId }) {
@@ -24747,6 +24848,7 @@ function useServiceProviderInviteService() {
     const ids2 = (repaired.memberIds ?? []).filter((m) => ObjectId56.isValid(m));
     for (const m of ids2)
       await updateMemberStatus(m, { status: "active" }).catch(() => 0);
+    await setRoleStatus(repaired.roleIds ?? [], "active");
     const { user } = await wrongJoinContext(id, userId);
     if (repaired.defaultOrgWas && user?._id && !String(user.defaultOrg ?? "")) {
       await setDefaultOrg(String(user._id), String(repaired.defaultOrgWas));
@@ -64008,7 +64110,7 @@ function robotManifest(brand, reportedModel) {
   const b = robotBrandFor(brand);
   const reported = typeof reportedModel === "string" ? reportedModel.trim().slice(0, 60) : "";
   if (!b)
-    return { capabilities: {}, profile: { model: reported, modelKnown: false, alarms: [], makerApp: "", makerAppOnly: [] } };
+    return { capabilities: {}, profile: { model: reported, modelKnown: false, alarms: [], makerApp: "", makerAppOnly: [], clearFault: [] } };
   const prefix = modelKey(b.brand);
   let key = modelKey(reported);
   if (prefix && key.startsWith(prefix) && key !== prefix)
@@ -64021,7 +64123,8 @@ function robotManifest(brand, reportedModel) {
       modelKnown: Boolean(m),
       alarms: [...m?.alarms ?? b.info?.alarms ?? []],
       makerApp: m?.makerApp ?? b.info?.makerApp ?? "",
-      makerAppOnly: [...m?.makerAppOnly ?? b.info?.makerAppOnly ?? []]
+      makerAppOnly: [...m?.makerAppOnly ?? b.info?.makerAppOnly ?? []],
+      clearFault: [...m?.clearFault ?? b.info?.clearFault ?? []]
     }
   };
 }
@@ -64854,6 +64957,246 @@ function useRobotCloudService(credentials, options = {}) {
 // src/services/ounitech.adapter.ts
 import axios4 from "axios";
 import { BadRequestError as BadRequestError137 } from "@7365admin1/node-server-utils";
+
+// src/utils/ounitech-codes.util.ts
+var CLEAR = "Clear the fault (press and release the emergency stop)";
+var SUPPORT = "If it keeps happening, call Ounitech support";
+var DOCK = "Push it onto its charging dock so it can find its position again";
+var WAIT = "Wait until it is ready, then try again";
+var WHEEL = "Clear anything caught in the wheel and check the floor for holes";
+var NONE = "Normal when the emergency stop is pressed or released - no action needed";
+var T = {
+  "100": ["Charging dock is over-heating", "Unplug the dock and let it cool down"],
+  "101": ["Charging dock's clean-water tank is empty", "Fill the dock's clean-water tank"],
+  "102": ["Charging dock's waste-water tank is full", "Drain the dock (unlock the dock, long-press Drain)"],
+  "103": ["Charging dock valve or pump fault", `Check the pump connections. ${SUPPORT}`],
+  "104": ["Charging dock valve or pump fault", `Check the pump connections. ${SUPPORT}`],
+  "105": ["Charging dock valve or pump fault", `Check the pump connections. ${SUPPORT}`],
+  "106": ["Charging dock valve or pump fault", `Check the pump connections. ${SUPPORT}`],
+  "107": ["Charging dock valve or pump fault", `Check the pump connections. ${SUPPORT}`],
+  "200": ["Battery not responding (flat for a long time)", "Charge it on the dock, or take the battery out and put it back"],
+  "204": ["Wheel driver board offline", `Check the wheel wiring. ${SUPPORT}`],
+  "205": ["Side-brush driver offline (side brush won't turn)", "Check the side-brush motor wire"],
+  "206": ["Button panel offline (handle lights off)", `Check the handle's cable contact. ${SUPPORT}`],
+  "207": ["Vacuum fan stalled", "Clean the vacuum pipe, HEPA filter, dust bag and tray"],
+  "209": ["Vacuum fan fault", `${CLEAR}. ${SUPPORT}`],
+  "210": ["Roller mop motor fault", "Take out the roller and clear anything tangled in it"],
+  "211": ["Roller brush motor fault", "Take out the roller and clear anything tangled in it"],
+  "212": ["Left side-brush motor fault", "Clear anything tangled in the side brush"],
+  "213": ["Right side-brush motor fault", "Clear anything tangled in the side brush"],
+  "214": ["Clean-water pump fault", `Re-plug the pump board. ${SUPPORT}`],
+  "218": ["Waste-water pump fault", `Re-plug the pump board. ${SUPPORT}`],
+  "219": ["Mop lift motor fault", `Restart the robot (power switch at the back). ${SUPPORT}`],
+  "220": ["Brush lift motor fault", `Restart the robot (power switch at the back). ${SUPPORT}`],
+  "221": ["Wheel fault", WHEEL],
+  "222": ["Wheel fault", WHEEL],
+  "223": ["Wheel stalled", WHEEL],
+  "224": ["Wheel stalled", WHEEL],
+  "228": ["Cooling fan fault", "Call Ounitech support"],
+  "233": ["Battery short circuit", "Stop using the robot and call Ounitech support to replace the battery"],
+  "234": ["Battery over-charged", "Take it off charge and call Ounitech support"],
+  "245": ["Water-suction fan stalled", "Unclog the suction pipe and replace the filter"],
+  "248": ["Squeegee motor fault", `Check the squeegee cable and motor. ${SUPPORT}`],
+  "250": ["Battery full"],
+  "251": ["Battery low"],
+  "252": ["Battery too low to charge", "Call Ounitech support"],
+  "255": ["Battery charging current high"],
+  "256": ["Battery over-charged", "Take it off charge and call Ounitech support"],
+  "257": ["Battery over 70 \xB0C", "Stop charging and let it cool down"],
+  "302": ["Robot can't load its map", "Call Ounitech support"],
+  "303": ["The map's area layout is damaged", "Re-edit the areas in the Ounitech app and save"],
+  "304": ["The area layout doesn't match the map", "In the Ounitech app, switch to another floor map and back"],
+  "305": ["Lost contact with its motion controller", "Restart the robot (power switch at the back)"],
+  "306": ["Robot couldn't receive the chosen area", `${CLEAR}, then send the task again`],
+  "307": ["Robot is finding its position again", "If the site has changed, push it onto its charging dock"],
+  "308": ["Robot couldn't find its position", DOCK],
+  "310": ["No signal from the charging dock", `Check the dock is powered. ${SUPPORT}`],
+  "312": ["Couldn't dock", "Check the dock hasn't been moved"],
+  "314": ["Couldn't dock - trying again", "Check the dock hasn't been moved"],
+  "315": ["Couldn't dock - trying again", "Check the dock hasn't been moved"],
+  "316": ["Lost the wireless link to its charging dock", "Check the dock is powered"],
+  "319": ["Robot was moved while charging", "Press the emergency stop and push it back onto the dock"],
+  "401": ["Battery below 10% - going to charge"],
+  "403": ["Robot has left its charging dock"],
+  "404": ["Charging dock reports a fault", "See the dock's other alerts"],
+  "405": ["Couldn't call the lift"],
+  "407": ["Lift is full"],
+  "409": ["Couldn't switch map", "Call Ounitech support"],
+  "410": ["Internal communication problem", SUPPORT],
+  "415": ["Gyro data fault", `Check the cables. ${SUPPORT}`],
+  "416": ["Wheel odometer data fault", `Check the cables. ${SUPPORT}`],
+  "417": ["Laser scanner data fault", `Check the cables. ${SUPPORT}`],
+  "418": ["Couldn't dock - trying again", "Check the dock hasn't been moved"],
+  "419": ["Couldn't dock - trying again", "Check the dock hasn't been moved"],
+  "420": ["Docking failed several times", "Check the dock's position and the robot's position"],
+  "423": ["Dust box blocked", "Empty the dust box and clear the pipe"],
+  "431": ["Robot's waste-water tank is high - returning to empty"],
+  "432": ["Robot's clean water is low - returning to refill"],
+  "433": ["Robot over-heating while charging", "Let it cool down"],
+  "443": ["No charging current", "Seat the battery and clean the charging contacts"],
+  "445": ["Area laser fault", "Call Ounitech support"],
+  "446": ["Area laser board offline", "Call Ounitech support"],
+  "448": ["Wheel drawing too much current", WHEEL],
+  "449": ["Wheel over-current fault", `${WHEEL}, then clear the fault (press and release the emergency stop)`],
+  "450": ["Wheels slipping", "Check the wheels"],
+  "453": ["Robot tried to leave a no-go area", DOCK],
+  "454": ["Robot hasn't moved for a long time", "Clear its path and wipe its sensors"],
+  "457": ["Left bumper hit something", "Tap the bumper if it stays stuck"],
+  "458": ["Right bumper hit something", "Tap the bumper if it stays stuck"],
+  "459": ["Water suction blocked", "Clean the suction pipe and filters"],
+  "460": ["Front camera fault", `Check the camera cable. ${SUPPORT}`],
+  "462": ["Left camera fault", `Check the camera cable. ${SUPPORT}`],
+  "464": ["Right camera fault", `Check the camera cable. ${SUPPORT}`],
+  "469": ["The map's floor doesn't match the floor it senses", "Check it is on the right floor; the air-pressure sensor may need recalibrating"],
+  "470": ["Gyro offline", "Call Ounitech support"],
+  "471": ["Roller motor needs servicing", "Book a service"],
+  "472": ["Fan needs servicing", "Book a service"],
+  "500": ["Scheduled job skipped: floor can't be reached", "Cross-floor jobs need lift control"],
+  "501": ["Scheduled job skipped: robot not ready to clean", "Check battery, water, tanks and dust box"],
+  "502": ["Waited over 20 minutes for the lift - going to charge"],
+  "503": ["Scheduled job done - going to charge"],
+  "504": ["Job done - going to charge"],
+  "505": ["Job cancelled - going to charge"],
+  "506": ["Couldn't leave the charging dock", "Check the wheels"],
+  "507": ["Clean water low - returning to refill, then continuing"],
+  "508": ["Waste water high - returning to empty, then continuing"],
+  "509": ["Dust box missing", "Fit the dust box"],
+  "510": ["Clean-water tank missing", "Fit the clean-water tank"],
+  "511": ["Waste-water tank missing", "Fit the waste-water tank"],
+  "512": ["Tank cover missing", "Fit the tank cover"],
+  "513": ["Top cover open", "Close the top cover"],
+  "514": ["Handle is up (manual mode) - the app can't start a job", "Lower the handle"],
+  "515": ["Battery below 10% - can't clean", "Let it charge"],
+  "517": ["Robot is starting up - not ready yet", WAIT],
+  "518": ["Robot is shutting down"],
+  "519": ["Robot is resuming - not ready yet", WAIT],
+  "520": ["Robot is finding its position - not ready yet", WAIT],
+  "521": ["Robot is downloading its map - not ready yet", WAIT],
+  "522": ["Couldn't resume: clean water below half", "Wait for it to refill"],
+  "523": ["Couldn't resume: waste water too high", "Wait for it to empty"],
+  "524": ["Charging dock doesn't match this robot", "Re-scan the dock's QR code in the Ounitech app"],
+  "525": ["Scheduled time ended before the job finished", "Give the schedule a longer time window"],
+  "527": ["Software updating", "Don't use the robot until it finishes"],
+  "528": ["Software updating", "Don't use the robot until it finishes"],
+  "529": ["Software updating", "Don't use the robot until it finishes"],
+  "530": ["Software updating", "Don't use the robot until it finishes"],
+  "531": ["Manual mode - the app's command was refused", "Lower the handle"],
+  "532": ["Finding its starting position"],
+  "534": ["Finding its starting position after a map switch"],
+  "535": ["Areas updated"],
+  "536": ["Virtual walls updated"],
+  "537": ["Safe zones updated"],
+  "538": ["Map saved"],
+  "539": ["Couldn't save the map", "Save it again"],
+  "540": ["Cliff sensor switched on"],
+  "541": ["Cliff sensor switched off"],
+  "542": ["Stopped at a drop (cliff sensor)", `Pull it back by the handle, ${CLEAR.charAt(0).toLowerCase()}${CLEAR.slice(1)}, and add a virtual wall there`],
+  "543": ["Slowing down near a drop (cliff sensor)", "Add a virtual wall there if it keeps happening"],
+  "544": ["Scheduled shutdown soon - returning to the dock"],
+  "545": ["Edge cleaning started"],
+  "546": ["Edge cleaning finished"],
+  "549": ["Asking to switch map"],
+  "552": ["No floor switch needed"],
+  "553": ["Area can't be reached - job ended", "In the Ounitech app, switch map and back, or re-save an area"],
+  "554": ["Sensor calibration"],
+  "555": ["Sensor calibration - clear obstacles around the robot"],
+  "556": ["Sensor calibration - clear obstacles around the robot"],
+  "557": ["Slow zones updated"],
+  "560": ["Fan stalled - returning to the dock", "Press and release the emergency stop, then check the fan"],
+  "561": ["Couldn't reconnect to the charging dock", "Check the dock"],
+  "562": ["Scheduled shutdown soon - no new jobs"],
+  "563": ["Robot is in a fault state", "Find the cause, clear it (press and release the emergency stop), and check the robot"],
+  "564": ["Fault cleared - robot on standby"],
+  "565": ["Handling waste water"],
+  "566": ["Waste water handled"],
+  "567": ["Fan stalled", "Clear the fan, then resume"],
+  "568": ["No charging dock on this floor", "Set the dock's floor in the Ounitech app"],
+  "570": ["Finding its starting position - can't start yet", WAIT],
+  "571": ["Stopped too long - side brush switched off", "Pause, then resume"],
+  "572": ["Lift ride took too long - job cancelled", "Push it back onto its charging dock"],
+  "573": ["Camera saw a drop", "Add a virtual wall 1 m from the drop"],
+  "574": ["Map updating", WAIT],
+  "575": ["Air-pressure sensor reading invalid", "Recalibrate the air-pressure sensor"],
+  "576": ["Air-pressure sensor calibration"],
+  "577": ["Air-pressure sensor calibration"],
+  "578": ["Air-pressure sensor calibration"],
+  "581": ["Taught route started"],
+  "582": ["Taught route ended"],
+  "583": ["Taught route cleared"],
+  "585": ["An area's positioning mode changed"],
+  "587": ["Battery discharging while on charge", "Seat the battery and clean the charging contacts"],
+  "588": ["Switched off with the power button"],
+  "589": ["Switched off by the timed power schedule"],
+  "590": ["Switched on"],
+  "591": ["Switched on with the power button"],
+  "592": ["Switched on by the timed power schedule"],
+  "593": ["Still finding its position - can't take commands yet", WAIT],
+  "600": ["Left wheel driver offline", NONE],
+  "601": ["Left wheel driver reset", NONE],
+  "603": ["Left wheel drawing too much current", WHEEL],
+  "604": ["Left wheel drawing too much current", WHEEL],
+  "605": ["Left wheel stalled", WHEEL],
+  "620": ["Right wheel driver offline", NONE],
+  "621": ["Right wheel driver reset", NONE],
+  "622": ["Right wheel driver error", "Call Ounitech support"],
+  "623": ["Right wheel drawing too much current", WHEEL],
+  "624": ["Right wheel drawing too much current", WHEEL],
+  "625": ["Right wheel stalled", WHEEL],
+  "640": ["A part is overdue for replacement - won't clean", "Replace the part"],
+  "641": ["A running job is blocking the schedule", "Cancel the job or wait"],
+  "642": ["Can't find its position while charging", "Put it on standby first"],
+  "643": ["Can't reset the dock while charging", "Put it on standby first"],
+  "644": ["Can't set its starting position while charging", "Put it on standby first"],
+  "700": ["Vacuum button pressed"],
+  "701": ["Standard button pressed"],
+  "702": ["Dust-mop button pressed"],
+  "703": ["Cancel button pressed"],
+  "704": ["Strong button pressed"],
+  "705": ["Mop button pressed"],
+  "706": ["Pause button pressed"],
+  "707": ["Recall button pressed"],
+  "708": ["Pause button held"],
+  "709": ["Pause button held"],
+  "710": ["Wheel drawing too much current", WHEEL],
+  "711": ["Wheel over-heating", "Let it cool and check the wheel"],
+  "712": ["Wheel kept drawing too much current", `${WHEEL}, then clear the fault (press and release the emergency stop)`],
+  "713": ["Switching lift - timed power paused"],
+  "731": ["Robot locked by the dealer", "Ask the dealer"],
+  "732": ["Voice file updated"],
+  "733": ["Switched off from the app"],
+  "737": ["Laser scanner motion-sensor fault", "Call Ounitech support"],
+  "738": ["Can't start: clean water low", "Fill the clean-water tank"],
+  "739": ["Can't start: waste water high", "Empty the waste-water tank"],
+  "760": ["Map file missing", "Call Ounitech support"],
+  "761": ["Map file damaged", "Call Ounitech support"],
+  "762": ["Started from the wrong place (it was pushed)", "Push it back onto its charging dock"],
+  "775": ["Moved by a person during a lift ride", "Cancel the job and push it back onto its charging dock"],
+  "776": ["Boxed in", `Clear its path, wipe its sensors. ${DOCK}`],
+  "777": ["Can't reach its target", `Clear its path, wipe its sensors. ${DOCK}`],
+  "778": ["Couldn't dock - recovering by itself", "Check the dock's sensor and that the dock hasn't moved"],
+  "779": ["Robot settings changed"],
+  "780": ["Top cover open", "Close the top cover"],
+  "781": ["Dust box not fitted", "Fit the dust box"],
+  "782": ["Waste-water tank not fitted", "Fit the waste-water tank"],
+  "785": ["Position ready"]
+};
+var _a;
+for (const c of [...range(740, 759), 763, 764, 783, 784])
+  T[_a = String(c)] ?? (T[_a] = ["Sensor or camera calibration", "Recalibrate if it failed"]);
+var _a2;
+for (const c of range(765, 773))
+  T[_a2 = String(c)] ?? (T[_a2] = ["QR code return-point / position scan", "Rescan if it failed"]);
+T["774"] ?? (T["774"] = ["Taught route saved"]);
+function range(a, b) {
+  return Array.from({ length: b - a + 1 }, (_, i) => a + i);
+}
+var OUNITECH_CODES = T;
+function ounitechCodeWords(code) {
+  const c = OUNITECH_CODES[code];
+  return c ? c[1] ? `${c[0]}. ${c[1]}.` : c[0] : null;
+}
+
+// src/services/ounitech.adapter.ts
 var OUNITECH_BRAND = "ounitech";
 var OUNITECH_CAPABILITIES = {
   // Pose in the chapter-6 robot list (metres) and the tracking stream.
@@ -64882,8 +65225,9 @@ var OUNITECH_CAPABILITIES = {
   // taskState carries the job and its %, shown in the status words; there is
   // no command id to follow a job WE started, so completion is not claimed.
   processCompletion: false,
+  // The manual: "Combined cleaning" across floors exists in the Ounitech app and needs its
+  // lift-control module (code 500 = floor unreachable); no API call starts one.
   multiFloor: false,
-  // plans can name floors; no API starts a cross-floor job
   // `start-spot-cleaning` takes a PIXEL polygon while poses are metres, and
   // whether y is flipped between the two is not documented. Hidden until one
   // real robot confirms the frame.
@@ -65039,9 +65383,9 @@ function ounitechFault(list) {
 }
 function faultWords(a) {
   if (!a.code)
-    return { code: "error", message: a.message.slice(0, 200) };
-  const words = a.message.startsWith(`Robot alert ${a.code}:`) ? a.message : `${a.message} (fault ${a.code})`;
-  return { code: a.code.slice(0, 60), message: words.slice(0, 200) };
+    return { code: "error", message: a.message.slice(0, 300) };
+  const words = alertWords(a.code) ?? a.vendorText ?? a.message;
+  return { code: a.code.slice(0, 60), message: `${a.code} \xB7 ${words}`.slice(0, 300) };
 }
 function ounitechMapShare(map, x, y, clamp4 = false) {
   const w = map?.width, h = map?.height, r = map?.resolution;
@@ -65189,22 +65533,8 @@ function ounitechTaskRecord(t, maps = [], tz = 480) {
     floorNo: Number.isInteger(t.floorNo) ? t.floorNo : map?.floorNo ?? null
   };
 }
-var ALERT_WORDS = {
-  "205": "Side brush driver offline",
-  "206": "Button panel offline",
-  // 306 "接收定点指定区域故障": seen live 30 Sep right after start-area-cleaning on an area with no centre point.
-  "306": "Robot couldn't receive the chosen cleaning area",
-  "540": "Floor check: cliff sensor switched on",
-  "563": "Robot is in a fault state",
-  "588": "Switched off with the power button",
-  "589": "Switched off by the timed power schedule",
-  "593": "Still finding its position - try again shortly",
-  "601": "Left wheel driver reset",
-  "620": "Right wheel driver offline",
-  "621": "Right wheel driver reset",
-  "734": "IMU zero offset too large",
-  "785": "Localisation ready"
-};
+var VENDOR_TEXT_EN = { "734": "IMU zero offset too large" };
+var alertWords = (code) => code ? ounitechCodeWords(code) ?? VENDOR_TEXT_EN[code] ?? null : null;
 var ALERT_LEVEL_WORDS = { \u63D0\u793A: "Notice", \u8B66\u544A: "Warning", \u6545\u969C: "Fault", \u9519\u8BEF: "Error", \u4E25\u91CD: "Critical" };
 function ounitechAlertRecord(a, tz = 480) {
   const raw = String(a.errMsg ?? a.errCode ?? "").trim();
@@ -65220,7 +65550,7 @@ function ounitechAlertRecord(a, tz = 480) {
     code,
     level: lv ? ALERT_LEVEL_WORDS[lv[1].trim()] ?? lv[1].trim() : null,
     // An untranslated Chinese text keeps its code up front, so the row is never only Chinese.
-    message: ALERT_WORDS[code] ?? (/[㐀-鿿]/.test(rest || raw) && code ? `Robot alert ${code}: ${rest || raw}` : rest || raw),
+    message: alertWords(code) ?? (/[㐀-鿿]/.test(rest || raw) && code ? `Robot alert ${code}: ${rest || raw}` : rest || raw),
     vendorText: rest || raw,
     resolved,
     at: ounitechTime(a.createTime, tz)
@@ -65598,7 +65928,7 @@ function createOunitechAdapter(credentials, options) {
           const blind = command.areas.filter((n) => centre.has(n) && !centre.get(n));
           if (blind.length) {
             throw new BadRequestError137(
-              `${blind.map((n) => `"${n}"`).join(", ")} has no centre point on the robot's map, so the robot can't be sent there (it stops with fault 306). Use Clean all, or redraw the area in the Ounitech app.`
+              `${blind.map((n) => `"${n}"`).join(", ")} has no centre point on the robot's map, so the robot can't be sent there (it stops with fault 306). ` + (blind.includes("default") ? `"default" is the whole map before it is divided into areas. Use Clean all, or divide the map in the Ounitech app (Control -> Divide areas).` : "Use Clean all, or redraw the area in the Ounitech app.")
             );
           }
           await cloud.startAreaCleaning(robotSn, command.areas, options2);
@@ -65861,7 +66191,17 @@ var OUNITECH_BRAND_DEFINITION = {
     { name: "Q3-G", codes: ["Q3G", "Q3-G"] },
     { name: "Q3-W", codes: ["Q3W", "Q3-W"] }
   ],
-  info: { makerApp: "the Ounitech app", makerAppOnly: ["pausing or stopping a job", "cleaning across floors", "changing maps, areas and schedules"] },
+  info: {
+    makerApp: "the Ounitech app",
+    makerAppOnly: ["pausing or stopping a job", "cleaning across floors", "changing maps, areas and schedules"],
+    // Q3-G User Manual / Troubleshooting Checklist (2026-09-30). The API has no documented way to clear an Error.
+    clearFault: [
+      'Press the red emergency stop on top of the robot, then turn it clockwise to release it. It says "emergency stop button bounced" and the fault clears.',
+      "If it has lost its position: lift the handle, push it onto its charging dock until the metal contacts touch, then press and release the emergency stop. It relocates by itself.",
+      "Still stuck: restart it with the power switch at the back. It is ready when only the child-lock light stays on.",
+      "Handle buttons not responding: press Child lock 3 times to unlock them."
+    ]
+  },
   create: (credentials) => createOunitechAdapter(credentials)
 };
 function registerOunitechBrand() {
@@ -71153,7 +71493,7 @@ function toBuildingYaml(name, rmf) {
   }
   const lifts = {};
   for (const l of rmf.lifts) {
-    const range = liftFloorRange(l, rmf.levels);
+    const range2 = liftFloorRange(l, rmf.levels);
     lifts[l.name] = {
       x: l.x,
       y: l.y,
@@ -71161,9 +71501,9 @@ function toBuildingYaml(name, rmf) {
       width: l.widthM,
       depth: l.depthM,
       reference_floor_name: l.referenceFloor,
-      initial_floor_name: range.initial,
-      lowest_floor: range.lowest,
-      highest_floor: range.highest,
+      initial_floor_name: range2.initial,
+      lowest_floor: range2.lowest,
+      highest_floor: range2.highest,
       doors: Object.fromEntries(
         l.doors.map((d) => [d.name, { door_type: LIFT_DOOR_TYPE_INT[d.type] ?? 2, x: d.x, y: d.y, width: d.widthM, motion_axis_orientation: d.axisYawRad }])
       ),
@@ -71213,13 +71553,13 @@ function toNavGraphs(name, rmf) {
   const out = {};
   const elevation = new Map(rmf.levels.map((l) => [l.name, l.elevationM]));
   const shafts = rmf.lifts.map((l) => {
-    const range = liftFloorRange(l, rmf.levels);
+    const range2 = liftFloorRange(l, rmf.levels);
     return {
       lift: l,
       verts: liftShaft(l),
       // lift.py: no lowest / highest floor = no bound; a lift with no level_doors marks nothing.
-      lo: elevation.get(range.lowest) ?? -Infinity,
-      hi: elevation.get(range.highest) ?? Infinity,
+      lo: elevation.get(range2.lowest) ?? -Infinity,
+      hi: elevation.get(range2.highest) ?? Infinity,
       hasDoors: l.levelDoors.length > 0
     };
   });